From 0004692e75806efb8cc342cf6f0520be24eb4c0d Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Tue, 22 Dec 2015 00:52:40 +0100 Subject: [PATCH] 2.7: merge pot files --- about.po | 24 +- bugs.po | 64 +- c-api.po | 4637 ++--- contents.po | 6 +- copyright.po | 20 +- distributing.po | 251 + distutils.po | 2049 +- extending.po | 1137 +- faq.po | 1994 +- glossary.po | 591 +- howto.po | 4428 ++--- install.po | 501 +- installing.po | 296 + library.po | 48347 ++++++++++++++++++++++++---------------------- license.po | 250 +- reference.po | 2242 ++- sphinx.po | 21 + tutorial.po | 1636 +- using.po | 829 +- whatsnew.po | 5023 +++-- 20 files changed, 39147 insertions(+), 35199 deletions(-) create mode 100644 distributing.po create mode 100644 installing.po create mode 100644 sphinx.po diff --git a/about.po b/about.po index 4f4a5036..de7e3615 100644 --- a/about.po +++ b/about.po @@ -7,21 +7,21 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/about.rst:3 +#: about.rst:3 msgid "About these documents" msgstr "À propos de ces documents" -#: ../src/Doc/about.rst:6 +#: about.rst:6 msgid "" "These documents are generated from `reStructuredText`_ sources by `Sphinx`_, " "a document processor specifically written for the Python documentation." @@ -31,7 +31,7 @@ msgstr "" "documentation Python." # dbe8e0821bcc407986691560c0eddcd9 -#: ../src/Doc/about.rst:15 +#: about.rst:15 msgid "" "Development of the documentation and its toolchain is an entirely volunteer " "effort, just like Python itself. If you want to contribute, please take a " @@ -39,11 +39,11 @@ msgid "" "volunteers are always welcome!" msgstr "" -#: ../src/Doc/about.rst:20 +#: about.rst:20 msgid "Many thanks go to:" msgstr "Merci beaucoup à :" -#: ../src/Doc/about.rst:22 +#: about.rst:22 msgid "" "Fred L. Drake, Jr., the creator of the original Python documentation toolset " "and writer of much of the content;" @@ -51,7 +51,7 @@ msgstr "" "Fred L. Drake, Jr., créateur des outils originaux de la documentation Python " "et rédacteur de la plupart de son contenu ;" -#: ../src/Doc/about.rst:24 +#: about.rst:24 #, fuzzy msgid "" "the `Docutils `_ project for creating " @@ -61,7 +61,7 @@ msgstr "" "reStructuredText et la suite d'outils Docutils ;" # sphix a pris des idées *du* projet `Alternative Python Reference -#: ../src/Doc/about.rst:26 +#: about.rst:26 msgid "" "Fredrik Lundh for his `Alternative Python Reference `_ project from which Sphinx got many good ideas." @@ -69,12 +69,12 @@ msgstr "" "Fredrik Lundh pour son projet `Alternative Python Reference `_, dont Sphinx a pris beaucoup de bonnes idées." -#: ../src/Doc/about.rst:32 +#: about.rst:32 msgid "Contributors to the Python Documentation" msgstr "Contributeurs de la documentation Python" # 7b2b34485a32441f8841d39f8b363468 -#: ../src/Doc/about.rst:34 +#: about.rst:34 msgid "" "Many people have contributed to the Python language, the Python standard " "library, and the Python documentation. See :source:`Misc/ACKS` in the " @@ -85,7 +85,7 @@ msgstr "" "sources de la distribution Python pour avoir une liste partielle des " "contributeurs." -#: ../src/Doc/about.rst:38 +#: about.rst:38 msgid "" "It is only with the input and contributions of the Python community that " "Python has such wonderful documentation -- Thank You!" diff --git a/bugs.po b/bugs.po index 31a0c612..5ceab940 100644 --- a/bugs.po +++ b/bugs.po @@ -7,21 +7,21 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/bugs.rst:5 +#: bugs.rst:5 msgid "Reporting Bugs" msgstr "Rapporter des bogues" -#: ../src/Doc/bugs.rst:7 +#: bugs.rst:7 msgid "" "Python is a mature programming language which has established a reputation " "for stability. In order to maintain this reputation, the developers would " @@ -31,11 +31,11 @@ msgstr "" "de maintenir cette réputation, les développeurs souhaitent connaître toute " "déficience que vous pourriez rencontrer dans Python." -#: ../src/Doc/bugs.rst:13 +#: bugs.rst:13 msgid "Documentation bugs" msgstr "Bogues de documentation" -#: ../src/Doc/bugs.rst:15 +#: bugs.rst:15 #, fuzzy msgid "" "If you find a bug in this documentation or would like to propose an " @@ -47,22 +47,28 @@ msgstr "" "bogue et où vous l'avez trouvé. Si vous avez une suggestion de correction, " "merci de l'inclure également." -#: ../src/Doc/bugs.rst:19 +#: bugs.rst:19 #, fuzzy msgid "" -"If you're short on time, you can also email your bug report to docs@python." -"org. 'docs@' is a mailing list run by volunteers; your request will be " -"noticed, though it may take a while to be processed." +"If you're short on time, you can also email documentation bug reports to " +"docs@python.org (behavioral bugs can be sent to python-list@python.org). " +"'docs@' is a mailing list run by volunteers; your request will be noticed, " +"though it may take a while to be processed." msgstr "" "docs@python.org est une liste de diffusion tenue par des bénévoles ; votre " "demande sera prise en compte, même si sa prise en charge prend du temps." -#: ../src/Doc/bugs.rst:29 +#: bugs.rst:25 +#, fuzzy +msgid "`Documentation bugs`_ on the Python issue tracker" +msgstr "Utilisation du tracker Python" + +#: bugs.rst:30 msgid "Using the Python issue tracker" msgstr "Utilisation du tracker Python" # aconrad: "traqueur de bogues" ? Comment traduire ça ? -#: ../src/Doc/bugs.rst:31 +#: bugs.rst:32 #, fuzzy msgid "" "Bug reports for Python itself should be submitted via the Python Bug Tracker " @@ -74,7 +80,7 @@ msgstr "" "formulaire Web permettant de saisir des informations pertinentes à soumettre " "aux développeurs." -#: ../src/Doc/bugs.rst:35 +#: bugs.rst:36 msgid "" "The first step in filing a report is to determine whether the problem has " "already been reported. The advantage in doing so, aside from saving the " @@ -92,7 +98,7 @@ msgstr "" "contribution est la bienvenue !). Pour ce faire, cherchez dans la base de " "données de bogues grâce à la boîte de recherche en haut de la page." -#: ../src/Doc/bugs.rst:42 +#: bugs.rst:43 msgid "" "If the problem you're reporting is not already in the bug tracker, go back " "to the Python Bug Tracker and log in. If you don't already have a tracker " @@ -116,7 +122,7 @@ msgstr "" # perdus. # # aconrad: j'aurais tendance à remplacer "identifié" par "connecté". -#: ../src/Doc/bugs.rst:47 +#: bugs.rst:48 msgid "" "Being now logged in, you can submit a bug. Select the \"Create New\" link " "in the sidebar to open the bug reporting form." @@ -125,7 +131,7 @@ msgstr "" "\"Create New\" dans la barre latérale pour ouvrir un nouveau formulaire de " "rapport de bogue." -#: ../src/Doc/bugs.rst:50 +#: bugs.rst:51 msgid "" "The submission form has a number of fields. For the \"Title\" field, enter " "a *very* short description of the problem; less than ten words is good. In " @@ -138,7 +144,7 @@ msgstr "" "problème ; sélectionnez aussi \"Composant\" et \"Versions\" en rapport avec " "le bogue." -#: ../src/Doc/bugs.rst:55 +#: bugs.rst:56 msgid "" "In the \"Comment\" field, describe the problem in detail, including what you " "expected to happen and what did happen. Be sure to include whether any " @@ -151,7 +157,7 @@ msgstr "" "plateforme matérielle et logicielle vous utilisiez (en incluant les " "informations de versions)." -#: ../src/Doc/bugs.rst:60 +#: bugs.rst:61 #, fuzzy msgid "" "Each bug report will be assigned to a developer who will determine what " @@ -164,14 +170,11 @@ msgstr "" "org/dev/workflow/ pour une description détaillée du processus de traitement " "des problèmes." -# 69a83a070002401aac0ef159d635dec6 -#: ../src/Doc/bugs.rst:68 -msgid "" -"`How to Report Bugs Effectively `_" +#: bugs.rst:70 +msgid "How to Report Bugs Effectively" msgstr "" -#: ../src/Doc/bugs.rst:68 +#: bugs.rst:69 msgid "" "Article which goes into some detail about how to create a useful bug report. " "This describes what kind of information is useful and why it is useful." @@ -180,14 +183,11 @@ msgstr "" "bogue utile. Il décrit quel genre d'information est utile et pourquoi elle " "est utile." -# aa32446fe7ba4bac95cb44ce54e51ae8 -#: ../src/Doc/bugs.rst:71 -msgid "" -"`Bug Writing Guidelines `_" +#: bugs.rst:73 +msgid "Bug Writing Guidelines" msgstr "" -#: ../src/Doc/bugs.rst:72 +#: bugs.rst:73 msgid "" "Information about writing a good bug report. Some of this is specific to " "the Mozilla project, but describes general good practices." @@ -196,12 +196,12 @@ msgstr "" "projet Mozilla mais présentent des bonnes pratiques générales." # 9c7f8b3b87054431a436607c10a61840 -#: ../src/Doc/bugs.rst:77 +#: bugs.rst:78 msgid "Getting started contributing to Python yourself" msgstr "" # 7b966de34a774a329b09560666a10777 -#: ../src/Doc/bugs.rst:79 +#: bugs.rst:80 msgid "" "Beyond just reporting bugs that you find, you are also welcome to submit " "patches to fix them. You can find more information on how to get started " diff --git a/c-api.po b/c-api.po index 9d229056..6fbc669c 100644 --- a/c-api.po +++ b/c-api.po @@ -7,21 +7,21 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-10-13 09:45\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/c-api/abstract.rst:8 +#: c-api/abstract.rst:8 msgid "Abstract Objects Layer" msgstr "Couche d'Abstraction des Objets" -#: ../src/Doc/c-api/abstract.rst:10 +#: c-api/abstract.rst:10 msgid "" "The functions in this chapter interact with Python objects regardless of " "their type, or with wide classes of object types (e.g. all numerical types, " @@ -34,7 +34,7 @@ msgstr "" "utilisés sur des types d'objets qui ne correspondent pas, ils lèveront une " "exception Python." -#: ../src/Doc/c-api/abstract.rst:15 +#: c-api/abstract.rst:15 #, fuzzy msgid "" "It is not possible to use these functions on objects that are not properly " @@ -47,12 +47,28 @@ msgstr "" "cfunc:`PyList_New` mais dont les éléments n'ont pas encore été mis à une " "valeur non-\\ ``NULL``." -#: ../src/Doc/c-api/allocation.rst:6 +#: c-api/allocation.rst:6 msgid "Allocating Objects on the Heap" msgstr "Allouer des objets dans le tas" +#: c-api/allocation.rst:14 c-api/allocation.rst:36 c-api/allocation.rst:61 +#: c-api/buffer.rst:431 c-api/buffer.rst:441 c-api/buffer.rst:453 +#: c-api/gcsupport.rst:51 c-api/string.rst:288 c-api/string.rst:318 +#: c-api/unicode.rst:218 c-api/unicode.rst:386 c-api/unicode.rst:449 +#: c-api/unicode.rst:462 c-api/unicode.rst:487 c-api/unicode.rst:501 +#: c-api/unicode.rst:511 c-api/unicode.rst:631 c-api/unicode.rst:670 +#: c-api/unicode.rst:725 c-api/unicode.rst:736 c-api/unicode.rst:759 +#: c-api/unicode.rst:770 c-api/unicode.rst:794 c-api/unicode.rst:804 +#: c-api/unicode.rst:828 c-api/unicode.rst:838 c-api/unicode.rst:888 +#: c-api/unicode.rst:899 c-api/unicode.rst:926 c-api/unicode.rst:945 +#: c-api/unicode.rst:965 +msgid "" +"This function used an :c:type:`int` type for *size*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + # b2f8a33570aa40f08e2fe46da3d52a11 -#: ../src/Doc/c-api/allocation.rst:24 +#: c-api/allocation.rst:24 msgid "" "Initialize a newly-allocated object *op* with its type and initial " "reference. Returns the initialized object. If *type* indicates that the " @@ -62,14 +78,14 @@ msgid "" msgstr "" # 8c5f5c89ed5843f8843e43f4f9e35e18 -#: ../src/Doc/c-api/allocation.rst:33 +#: c-api/allocation.rst:33 msgid "" "This does everything :c:func:`PyObject_Init` does, and also initializes the " "length information for a variable-size object." msgstr "" # 1b04f81704f14f45b1bbbc1dda5fbebe -#: ../src/Doc/c-api/allocation.rst:43 +#: c-api/allocation.rst:43 msgid "" "Allocate a new Python object using the C structure type *TYPE* and the " "Python type object *type*. Fields not defined by the Python object header " @@ -79,7 +95,7 @@ msgid "" msgstr "" # fb7d11b064e6492e9cacc2759e2cf73c -#: ../src/Doc/c-api/allocation.rst:52 +#: c-api/allocation.rst:52 msgid "" "Allocate a new Python object using the C structure type *TYPE* and the " "Python type object *type*. Fields not defined by the Python object header " @@ -92,7 +108,7 @@ msgid "" msgstr "" # 203fabdbc207494185117fc38ddf1fa1 -#: ../src/Doc/c-api/allocation.rst:68 +#: c-api/allocation.rst:68 msgid "" "Releases memory allocated to an object using :c:func:`PyObject_New` or :c:" "func:`PyObject_NewVar`. This is normally called from the :c:member:" @@ -102,14 +118,20 @@ msgid "" msgstr "" # cfe90294645e4c309b47f76cd0091ed8 -#: ../src/Doc/c-api/allocation.rst:77 +#: c-api/allocation.rst:77 msgid "" "Create a new module object based on a name and table of functions, returning " "the new module object." msgstr "" +#: c-api/allocation.rst:80 c-api/allocation.rst:91 c-api/allocation.rst:113 +msgid "" +"Older versions of Python did not support *NULL* as the value for the " +"*methods* argument." +msgstr "" + # 930f4cc7ce6a47fb80f72d3cda3a86a5 -#: ../src/Doc/c-api/allocation.rst:87 +#: c-api/allocation.rst:87 msgid "" "Create a new module object based on a name and table of functions, returning " "the new module object. If *doc* is non-*NULL*, it will be used to define " @@ -117,7 +139,7 @@ msgid "" msgstr "" # dd12234ea11a4aa58e062419f23e4c55 -#: ../src/Doc/c-api/allocation.rst:98 +#: c-api/allocation.rst:98 msgid "" "Create a new module object based on a name and table of functions, returning " "the new module object. If *doc* is non-*NULL*, it will be used to define " @@ -129,24 +151,24 @@ msgid "" msgstr "" # 9678d13005344f989ebb4819926b18cd -#: ../src/Doc/c-api/allocation.rst:109 +#: c-api/allocation.rst:109 msgid "" "Most uses of this function should probably be using the :c:func:" "`Py_InitModule3` instead; only use this if you are sure you need it." msgstr "" # 8186ba517b7f4592a6dbb0c75c57e5c4 -#: ../src/Doc/c-api/allocation.rst:120 +#: c-api/allocation.rst:120 msgid "" "Object which is visible in Python as ``None``. This should only be accessed " "using the ``Py_None`` macro, which evaluates to a pointer to this object." msgstr "" -#: ../src/Doc/c-api/arg.rst:6 +#: c-api/arg.rst:6 msgid "Parsing arguments and building values" msgstr "Analyse des arguments et construction des valeurs" -#: ../src/Doc/c-api/arg.rst:8 +#: c-api/arg.rst:8 msgid "" "These functions are useful when creating your own extensions functions and " "methods. Additional information and examples are available in :ref:" @@ -156,7 +178,7 @@ msgstr "" "d'extensions. Des informations supplémentaires et des exemples sont " "disponibles ici: ref:`extending-index`." -#: ../src/Doc/c-api/arg.rst:12 +#: c-api/arg.rst:12 #, fuzzy msgid "" "The first three of these functions described, :c:func:`PyArg_ParseTuple`, :c:" @@ -171,7 +193,7 @@ msgstr "" "pour indiquer à la fonction les arguments attendus. Les chaînes de format " "utilise la même syntaxe pour chacune de ces fonctions." -#: ../src/Doc/c-api/arg.rst:18 +#: c-api/arg.rst:18 msgid "" "A format string consists of zero or more \"format units.\" A format unit " "describes one Python object; it is usually a single character or a " @@ -192,7 +214,7 @@ msgstr "" "qui correspond à l'unité de format, et l'entrée entre crochets est le type " "de la variable C (ou des variables) dont l'adresse doit être donnée." -#: ../src/Doc/c-api/arg.rst:27 +#: c-api/arg.rst:27 #, fuzzy msgid "" "These formats allow to access an object as a contiguous chunk of memory. You " @@ -205,12 +227,11 @@ msgstr "" "libérer la mémoire vous-même, excepté pour les formats ``es``, ``es#``, " "``et`` et ``et#``." -# 3c441cc297cf451986494883f2ff8075 -#: ../src/Doc/c-api/arg.rst:38 -msgid "``s`` (string or Unicode) [const char \\*]" +#: c-api/arg.rst:39 +msgid "s (string or Unicode) [const char *]" msgstr "" -#: ../src/Doc/c-api/arg.rst:33 +#: c-api/arg.rst:33 #, fuzzy msgid "" "Convert a Python string or Unicode object to a C pointer to a character " @@ -229,15 +250,14 @@ msgstr "" "convertis en chaîne de caractères C avec l'encodage ``'utf-8'``. Si la " "conversion échoue, une exception :exc:`UnicodeError` sera levée." -# 587f1d02d49d48c4b9149924026dc83d -#: ../src/Doc/c-api/arg.rst:51 +#: c-api/arg.rst:52 msgid "" -"``s#`` (string, Unicode or any read buffer compatible object) [const char " -"\\*, int (or :c:type:`Py_ssize_t`, see below)]" +"s# (string, Unicode or any read buffer compatible object) [const char *, int " +"(or Py_ssize_t, see below)]" msgstr "" # d1fd62dcb8dd47728cc5abae075ae577 -#: ../src/Doc/c-api/arg.rst:42 +#: c-api/arg.rst:42 msgid "" "This variant on ``s`` stores into two C variables, the first one a pointer " "to a character string, the second one its length. In this case the Python " @@ -247,7 +267,7 @@ msgid "" "the raw internal data representation." msgstr "" -#: ../src/Doc/c-api/arg.rst:49 +#: c-api/arg.rst:49 #, fuzzy msgid "" "Starting with Python 2.5 the type of the length argument can be controlled " @@ -264,12 +284,11 @@ msgstr "" "ctype:`int`. Il est préférable de toujours définir :cmacro:" "`PY_SSIZE_T_CLEAN`." -# 8508018381014f8393b11e8266ade210 -#: ../src/Doc/c-api/arg.rst:60 -msgid "``s*`` (string, Unicode, or any buffer compatible object) [Py_buffer]" +#: c-api/arg.rst:61 +msgid "s* (string, Unicode, or any buffer compatible object) [Py_buffer]" msgstr "" -#: ../src/Doc/c-api/arg.rst:55 +#: c-api/arg.rst:55 #, fuzzy msgid "" "Similar to ``s#``, this code fills a Py_buffer structure provided by the " @@ -287,12 +306,11 @@ msgstr "" "après que vous ayez terminé de traiter les données (ou après une " "interruption prémataturée du traitement de ces données)." -# 86be65869e394d50a4280632ad11b64b -#: ../src/Doc/c-api/arg.rst:64 -msgid "``z`` (string, Unicode or ``None``) [const char \\*]" +#: c-api/arg.rst:65 +msgid "z (string, Unicode or None) [const char *]" msgstr "" -#: ../src/Doc/c-api/arg.rst:64 +#: c-api/arg.rst:64 msgid "" "Like ``s``, but the Python object may also be ``None``, in which case the C " "pointer is set to *NULL*." @@ -300,37 +318,32 @@ msgstr "" "Comme ``s``, mais l'objet Python peut aussi être ``None``, auquel cas le " "pointeur C devient *NULL*." -# 3400547efafe4e629f3999d38cb698ef -#: ../src/Doc/c-api/arg.rst:67 +#: c-api/arg.rst:68 msgid "" -"``z#`` (string, Unicode, ``None`` or any read buffer compatible object) " -"[const char \\*, int]" +"z# (string, Unicode, None or any read buffer compatible object) [const char " +"*, int]" msgstr "" # 8966a3122dc747399eeb87a1d0151bca -#: ../src/Doc/c-api/arg.rst:68 +#: c-api/arg.rst:68 msgid "This is to ``s#`` as ``z`` is to ``s``." msgstr "" -# f2e0f0f929204e0996332834a5f4d52f -#: ../src/Doc/c-api/arg.rst:72 -msgid "" -"``z*`` (string, Unicode, ``None`` or any buffer compatible object) " -"[Py_buffer]" +#: c-api/arg.rst:73 +msgid "z* (string, Unicode, None or any buffer compatible object) [Py_buffer]" msgstr "" # 6e9e2f7190d44e399ced5189a5ad8892 -#: ../src/Doc/c-api/arg.rst:71 +#: c-api/arg.rst:71 msgid "This is to ``s*`` as ``z`` is to ``s``." msgstr "" -# 56fd171f44804c12a6a4f624ba154374 -#: ../src/Doc/c-api/arg.rst:79 -msgid "``u`` (Unicode) [Py_UNICODE \\*]" +#: c-api/arg.rst:80 +msgid "u (Unicode) [Py_UNICODE *]" msgstr "" # 3bdc1ebd59e7463fa9a6a8663990957d -#: ../src/Doc/c-api/arg.rst:76 +#: c-api/arg.rst:76 msgid "" "Convert a Python Unicode object to a C pointer to a NUL-terminated buffer of " "16-bit Unicode (UTF-16) data. As with ``s``, there is no need to provide " @@ -339,12 +352,11 @@ msgid "" "pass." msgstr "" -# 9e8a660e136141f78552bcb5582ef65c -#: ../src/Doc/c-api/arg.rst:85 -msgid "``u#`` (Unicode) [Py_UNICODE \\*, int]" +#: c-api/arg.rst:86 +msgid "u# (Unicode) [Py_UNICODE *, int]" msgstr "" -#: ../src/Doc/c-api/arg.rst:83 +#: c-api/arg.rst:83 #, fuzzy msgid "" "This variant on ``u`` stores into two C variables, the first one a pointer " @@ -356,14 +368,13 @@ msgstr "" "première pointant vers un tampon de données Unicode, la seconde donnant sa " "longueur." -# 71cb0c5cf3b54d62b321892b30605a73 -#: ../src/Doc/c-api/arg.rst:104 +#: c-api/arg.rst:105 msgid "" -"``es`` (string, Unicode or character buffer compatible object) [const char " -"\\*encoding, char \\*\\*buffer]" +"es (string, Unicode or character buffer compatible object) [const char " +"*encoding, char **buffer]" msgstr "" -#: ../src/Doc/c-api/arg.rst:89 +#: c-api/arg.rst:89 #, fuzzy msgid "" "This variant on ``s`` is used for encoding Unicode and objects convertible " @@ -374,7 +385,7 @@ msgstr "" "de caractères. Cela ne fonctionne que pour les données encodées qui ne " "contiennent pas d'octets NUL." -#: ../src/Doc/c-api/arg.rst:93 +#: c-api/arg.rst:93 #, fuzzy msgid "" "This format requires two arguments. The first is only used as input, and " @@ -396,7 +407,7 @@ msgstr "" "l'argument. Le texte sera encodé avec l'encodage spécifié dans le premier " "argument. " -#: ../src/Doc/c-api/arg.rst:102 +#: c-api/arg.rst:102 #, fuzzy msgid "" ":c:func:`PyArg_ParseTuple` will allocate a buffer of the needed size, copy " @@ -409,14 +420,13 @@ msgstr "" "le nouveau tampon alloué. L'appelant est responsable de l'invocation de :" "cfunc:`PyMem_Free` pour libérer le tampon alloué après utilisatiopn" -# cb66e1d51f0149a2af80a5e24b7e5b64 -#: ../src/Doc/c-api/arg.rst:109 +#: c-api/arg.rst:110 msgid "" -"``et`` (string, Unicode or character buffer compatible object) [const char " -"\\*encoding, char \\*\\*buffer]" +"et (string, Unicode or character buffer compatible object) [const char " +"*encoding, char **buffer]" msgstr "" -#: ../src/Doc/c-api/arg.rst:108 +#: c-api/arg.rst:108 #, fuzzy msgid "" "Same as ``es`` except that 8-bit string objects are passed through without " @@ -427,14 +437,13 @@ msgstr "" "sans les ré-encoder. À la place, l'implémentation assume que l'objet chaîne " "de caractères utilise l'encodage passé en tant que paramètre." -# c83e4ce1d4cb4cf380cdbed9d9a4e6d0 -#: ../src/Doc/c-api/arg.rst:141 +#: c-api/arg.rst:142 msgid "" -"``es#`` (string, Unicode or character buffer compatible object) [const char " -"\\*encoding, char \\*\\*buffer, int \\*buffer_length]" +"es# (string, Unicode or character buffer compatible object) [const char " +"*encoding, char **buffer, int *buffer_length]" msgstr "" -#: ../src/Doc/c-api/arg.rst:113 +#: c-api/arg.rst:113 #, fuzzy msgid "" "This variant on ``s#`` is used for encoding Unicode and objects convertible " @@ -445,7 +454,7 @@ msgstr "" "tampon de caractères. Contrairement au format ``es``, cette variante " "autorise les caractères NUL dans les données d'entrée." -#: ../src/Doc/c-api/arg.rst:117 +#: c-api/arg.rst:117 #, fuzzy msgid "" "It requires three arguments. The first is only used as input, and must be " @@ -470,11 +479,11 @@ msgstr "" "l'entier référencé sera positionné avec le nombre d'octets dans le tampon de " "sortie" -#: ../src/Doc/c-api/arg.rst:127 +#: c-api/arg.rst:127 msgid "There are two modes of operation:" msgstr "Il existe deux modes de fonctionnement :" -#: ../src/Doc/c-api/arg.rst:129 +#: c-api/arg.rst:129 #, fuzzy msgid "" "If *\\*buffer* points a *NULL* pointer, the function will allocate a buffer " @@ -489,7 +498,7 @@ msgstr "" "de la libération de la mémoire après utilisation du tampon, par un appel à :" "cfunc:`PyMem_Free`." -#: ../src/Doc/c-api/arg.rst:135 +#: c-api/arg.rst:135 #, fuzzy msgid "" "If *\\*buffer* points to a non-*NULL* pointer (an already allocated " @@ -505,7 +514,7 @@ msgstr "" "dernier par NUL. Si le tampon n'est pas de taille suffisante, une exception :" "exc:`ValueError` sera levée." -#: ../src/Doc/c-api/arg.rst:141 +#: c-api/arg.rst:141 msgid "" "In both cases, *\\*buffer_length* is set to the length of the encoded data " "without the trailing NUL byte." @@ -513,14 +522,13 @@ msgstr "" "Dans les deux cas, *\\*buffer_length* est la longueur des données encodées, " "sans l'octet NUL de fin." -# 94d46542f47b4c97b118b955363ad505 -#: ../src/Doc/c-api/arg.rst:146 +#: c-api/arg.rst:147 msgid "" -"``et#`` (string, Unicode or character buffer compatible object) [const char " -"\\*encoding, char \\*\\*buffer, int \\*buffer_length]" +"et# (string, Unicode or character buffer compatible object) [const char " +"*encoding, char **buffer, int *buffer_length]" msgstr "" -#: ../src/Doc/c-api/arg.rst:145 +#: c-api/arg.rst:145 #, fuzzy msgid "" "Same as ``es#`` except that string objects are passed through without " @@ -531,12 +539,11 @@ msgstr "" "sans recodage. À la place, l'implémentation assume que les objets de type " "chaînes de caractères utilisent l'encodage passé en tant que paramètre." -# 82e915bea5b749619ece8f0916733f1a -#: ../src/Doc/c-api/arg.rst:150 -msgid "``b`` (integer) [unsigned char]" +#: c-api/arg.rst:151 +msgid "b (integer) [unsigned char]" msgstr "" -#: ../src/Doc/c-api/arg.rst:150 +#: c-api/arg.rst:150 #, fuzzy msgid "" "Convert a nonnegative Python integer to an unsigned tiny int, stored in a C :" @@ -545,13 +552,11 @@ msgstr "" "Convertit un entier Python positif ou nul en un unsigned tiny int, stocké " "dans un C :ctype:`unsigned char`." -# 4aec01efcef9401a81c62927e9e4d9ef -# 8751aadfa71542e7872d2196bf86b1fe -#: ../src/Doc/c-api/arg.rst:156 ../src/Doc/c-api/arg.rst:483 -msgid "``B`` (integer) [unsigned char]" +#: c-api/arg.rst:157 c-api/arg.rst:484 +msgid "B (integer) [unsigned char]" msgstr "" -#: ../src/Doc/c-api/arg.rst:154 +#: c-api/arg.rst:154 #, fuzzy msgid "" "Convert a Python integer to a tiny int without overflow checking, stored in " @@ -560,24 +565,20 @@ msgstr "" "Convertit un entier Python en un tiny int sans vérifier le débordement, " "stocké dans un C :ctype:`unsigned char`." -# a69313cbfe1a4df8a5e4ad9b302b5c19 -# 845b0112d35b475687eb57a42dcda5c4 -#: ../src/Doc/c-api/arg.rst:159 ../src/Doc/c-api/arg.rst:477 -msgid "``h`` (integer) [short int]" +#: c-api/arg.rst:160 c-api/arg.rst:478 +msgid "h (integer) [short int]" msgstr "" -#: ../src/Doc/c-api/arg.rst:160 +#: c-api/arg.rst:160 #, fuzzy msgid "Convert a Python integer to a C :c:type:`short int`." msgstr "Convertit un entier Python en un C :ctype:`short int`." -# 31a8ef69d28f4607a5a083bb13a3aaf4 -# 3fce801b2ce944399012cea3e7b45a24 -#: ../src/Doc/c-api/arg.rst:165 ../src/Doc/c-api/arg.rst:486 -msgid "``H`` (integer) [unsigned short int]" +#: c-api/arg.rst:166 c-api/arg.rst:487 +msgid "H (integer) [unsigned short int]" msgstr "" -#: ../src/Doc/c-api/arg.rst:163 +#: c-api/arg.rst:163 #, fuzzy msgid "" "Convert a Python integer to a C :c:type:`unsigned short int`, without " @@ -586,23 +587,20 @@ msgstr "" "Convertit un entier Python en un C :ctype:`unsigned short int`, sans " "contrôle de débordement." -# 44e0cf6a3eea437b9c7958cd6fdac2a4 -# 24cb61e8dbf049c38d1bd1377ba9df86 -#: ../src/Doc/c-api/arg.rst:168 ../src/Doc/c-api/arg.rst:471 -msgid "``i`` (integer) [int]" +#: c-api/arg.rst:169 c-api/arg.rst:472 +msgid "i (integer) [int]" msgstr "" -#: ../src/Doc/c-api/arg.rst:169 +#: c-api/arg.rst:169 #, fuzzy msgid "Convert a Python integer to a plain C :c:type:`int`." msgstr "Convertit un entier Python en un type C :ctype:`int`." -# 6d49329fb94c4c5a802f83b371df4ed2 -#: ../src/Doc/c-api/arg.rst:174 -msgid "``I`` (integer) [unsigned int]" +#: c-api/arg.rst:175 +msgid "I (integer) [unsigned int]" msgstr "" -#: ../src/Doc/c-api/arg.rst:172 +#: c-api/arg.rst:172 #, fuzzy msgid "" "Convert a Python integer to a C :c:type:`unsigned int`, without overflow " @@ -611,23 +609,20 @@ msgstr "" "Convertit un entier Python en un type C :ctype:`unsigned int`, sans contrôle " "de le débordement." -# da656ff0f94a4e4baef2942ee86afcdd -# ba93f116f51f4e5c81273c4af48b6fd7 -#: ../src/Doc/c-api/arg.rst:177 ../src/Doc/c-api/arg.rst:480 -msgid "``l`` (integer) [long int]" +#: c-api/arg.rst:178 c-api/arg.rst:481 +msgid "l (integer) [long int]" msgstr "" -#: ../src/Doc/c-api/arg.rst:178 +#: c-api/arg.rst:178 #, fuzzy msgid "Convert a Python integer to a C :c:type:`long int`." msgstr "Convertit un entier Python en un type :ctype:`long int`." -# eb9c7aea54554aa9a236efaeaea6b64a -#: ../src/Doc/c-api/arg.rst:183 -msgid "``k`` (integer) [unsigned long]" +#: c-api/arg.rst:184 +msgid "k (integer) [unsigned long]" msgstr "" -#: ../src/Doc/c-api/arg.rst:181 +#: c-api/arg.rst:181 #, fuzzy msgid "" "Convert a Python integer or long integer to a C :c:type:`unsigned long` " @@ -636,12 +631,11 @@ msgstr "" "Convertit un entier Python en un type C :ctype:`unsigned long` sans en " "vérifier le débordement." -# e957c8186cfb40d6bca723b244b829f7 -#: ../src/Doc/c-api/arg.rst:188 -msgid "``L`` (integer) [PY_LONG_LONG]" +#: c-api/arg.rst:189 +msgid "L (integer) [PY_LONG_LONG]" msgstr "" -#: ../src/Doc/c-api/arg.rst:187 +#: c-api/arg.rst:187 #, fuzzy msgid "" "Convert a Python integer to a C :c:type:`long long`. This format is only " @@ -652,12 +646,11 @@ msgstr "" "uniquement disponible sur les plates-formes qui prennent en charge :ctype:" "`long long` (ou :ctype:`_int64` sous Windows)." -# 45eec5c3136d491fa74520731b52d9af -#: ../src/Doc/c-api/arg.rst:196 -msgid "``K`` (integer) [unsigned PY_LONG_LONG]" +#: c-api/arg.rst:197 +msgid "K (integer) [unsigned PY_LONG_LONG]" msgstr "" -#: ../src/Doc/c-api/arg.rst:192 +#: c-api/arg.rst:192 #, fuzzy msgid "" "Convert a Python integer or long integer to a C :c:type:`unsigned long long` " @@ -670,23 +663,20 @@ msgstr "" "formes qui prennent en charge :ctype:`unsigned long long` (ou :ctype:" "`unsigned _int64` sous Windows)." -# a163604ac6bd499f992b26ea850fb552 -#: ../src/Doc/c-api/arg.rst:201 -msgid "``n`` (integer) [Py_ssize_t]" +#: c-api/arg.rst:202 +msgid "n (integer) [Py_ssize_t]" msgstr "" -#: ../src/Doc/c-api/arg.rst:200 +#: c-api/arg.rst:200 #, fuzzy msgid "Convert a Python integer or long integer to a C :c:type:`Py_ssize_t`." msgstr "Convertit un entier Python en un type C :ctype:`Py_ssize_t`." -# 91a530e5d5574bd48f0c74b01f63ece1 -# 2bd218db212a48b98d5699837f98022d -#: ../src/Doc/c-api/arg.rst:205 ../src/Doc/c-api/arg.rst:511 -msgid "``c`` (string of length 1) [char]" +#: c-api/arg.rst:206 c-api/arg.rst:512 +msgid "c (string of length 1) [char]" msgstr "" -#: ../src/Doc/c-api/arg.rst:205 +#: c-api/arg.rst:205 #, fuzzy msgid "" "Convert a Python character, represented as a string of length 1, to a C :c:" @@ -695,46 +685,39 @@ msgstr "" "Convertit un caractère Python, représenté comme un objet :class:`str` de " "longueur 1, en un type C :ctype:`int`." -# b67102595bf641d6a624008fa3457392 -# 8c43e071710146d0a06360d42457b0e0 -#: ../src/Doc/c-api/arg.rst:208 ../src/Doc/c-api/arg.rst:517 -msgid "``f`` (float) [float]" +#: c-api/arg.rst:209 c-api/arg.rst:518 +msgid "f (float) [float]" msgstr "" -#: ../src/Doc/c-api/arg.rst:209 +#: c-api/arg.rst:209 #, fuzzy msgid "Convert a Python floating point number to a C :c:type:`float`." msgstr "Convertit un nombre flottant Python vers un type C :ctype:`float`." -# c60164235e1a44fd965e2cc1b7ed111d -# e3b31a6d058b4d4997e598379dd71042 -#: ../src/Doc/c-api/arg.rst:211 ../src/Doc/c-api/arg.rst:514 -msgid "``d`` (float) [double]" +#: c-api/arg.rst:212 c-api/arg.rst:515 +msgid "d (float) [double]" msgstr "" -#: ../src/Doc/c-api/arg.rst:212 +#: c-api/arg.rst:212 #, fuzzy msgid "Convert a Python floating point number to a C :c:type:`double`." msgstr "Convertit un nombre flottant Python vers un type C :ctype:`double`." -# f5b36f51a187437f9c0ba44b18bf61d9 -#: ../src/Doc/c-api/arg.rst:214 -msgid "``D`` (complex) [Py_complex]" +#: c-api/arg.rst:215 +msgid "D (complex) [Py_complex]" msgstr "" -#: ../src/Doc/c-api/arg.rst:215 +#: c-api/arg.rst:215 #, fuzzy msgid "Convert a Python complex number to a C :c:type:`Py_complex` structure." msgstr "" "Convertit un nombre complexe Python vers une structure C :ctype:`Py_complex`." -# 9accdf5b741d44f78cf29151bfc0890c -# b9db1f06d0414eff9a54ba26766cdc71 -#: ../src/Doc/c-api/arg.rst:219 ../src/Doc/c-api/arg.rst:528 -msgid "``O`` (object) [PyObject \\*]" +#: c-api/arg.rst:220 c-api/arg.rst:529 +msgid "O (object) [PyObject *]" msgstr "" -#: ../src/Doc/c-api/arg.rst:218 +#: c-api/arg.rst:218 msgid "" "Store a Python object (without any conversion) in a C object pointer. The C " "program thus receives the actual object that was passed. The object's " @@ -745,12 +728,11 @@ msgstr "" "référence sur l'objet n'est pas incrémenté. Le pointeur stocké n'est pas " "*NULL*." -# 487b75e2702c4e1fa662ccb1716ba71c -#: ../src/Doc/c-api/arg.rst:226 -msgid "``O!`` (object) [*typeobject*, PyObject \\*]" +#: c-api/arg.rst:227 +msgid "O! (object) [typeobject, PyObject *]" msgstr "" -#: ../src/Doc/c-api/arg.rst:223 +#: c-api/arg.rst:223 #, fuzzy msgid "" "Store a Python object in a C object pointer. This is similar to ``O``, but " @@ -766,13 +748,11 @@ msgstr "" "sera stocké. Si l'objet Python n'est pas du type requis, une exception :exc:" "`TypeError` sera levée." -# 086176eb60294f98b32d82721645e1d9 -# a29ee7e00ae74ea3b72f7942e71f485c -#: ../src/Doc/c-api/arg.rst:241 ../src/Doc/c-api/arg.rst:542 -msgid "``O&`` (object) [*converter*, *anything*]" +#: c-api/arg.rst:242 c-api/arg.rst:543 +msgid "O& (object) [converter, anything]" msgstr "" -#: ../src/Doc/c-api/arg.rst:230 +#: c-api/arg.rst:230 #, fuzzy msgid "" "Convert a Python object to a C variable through a *converter* function. This " @@ -786,7 +766,7 @@ msgstr "" "convertie en :ctype:`void \\*`. La fonction de *conversion* est appellée à " "son tour de la manière suivante :" -#: ../src/Doc/c-api/arg.rst:237 +#: c-api/arg.rst:237 #, fuzzy msgid "" "where *object* is the Python object to be converted and *address* is the :c:" @@ -803,12 +783,11 @@ msgstr "" "*conversion* devrait lever une exception et laisser le contenu de *adresse* " "non modifié." -# 5dfe72d7469145f8aea75f323460be04 -#: ../src/Doc/c-api/arg.rst:246 -msgid "``S`` (string) [PyStringObject \\*]" +#: c-api/arg.rst:247 +msgid "S (string) [PyStringObject *]" msgstr "" -#: ../src/Doc/c-api/arg.rst:245 +#: c-api/arg.rst:245 #, fuzzy msgid "" "Like ``O`` but requires that the Python object is a string object. Raises :" @@ -819,12 +798,11 @@ msgstr "" "conversion. Lève une :exc:`TypeError` si l'objet n'est pas un objet Unicode. " "La variable C peut également être déclarée en tant que :ctype:`PyObject\\*`." -# 725e656c3f414128b5a205381f208c80 -#: ../src/Doc/c-api/arg.rst:251 -msgid "``U`` (Unicode string) [PyUnicodeObject \\*]" +#: c-api/arg.rst:252 +msgid "U (Unicode string) [PyUnicodeObject *]" msgstr "" -#: ../src/Doc/c-api/arg.rst:250 +#: c-api/arg.rst:250 #, fuzzy msgid "" "Like ``O`` but requires that the Python object is a Unicode object. Raises :" @@ -835,13 +813,12 @@ msgstr "" "conversion. Lève une :exc:`TypeError` si l'objet n'est pas un objet Unicode. " "La variable C peut également être déclarée en tant que :ctype:`PyObject\\*`." -# 4453ef335bdd4136a64b787aac0947b9 -#: ../src/Doc/c-api/arg.rst:258 -msgid "``t#`` (read-only character buffer) [char \\*, int]" +#: c-api/arg.rst:259 +msgid "t# (read-only character buffer) [char *, int]" msgstr "" # 7869543094d64959b4210496b268663c -#: ../src/Doc/c-api/arg.rst:255 +#: c-api/arg.rst:255 msgid "" "Like ``s#``, but accepts any object which implements the read-only buffer " "interface. The :c:type:`char\\*` variable is set to point to the first byte " @@ -850,13 +827,12 @@ msgid "" "for all others." msgstr "" -# ede31a1727654ee3bb098a88e383176a -#: ../src/Doc/c-api/arg.rst:264 -msgid "``w`` (read-write character buffer) [char \\*]" +#: c-api/arg.rst:265 +msgid "w (read-write character buffer) [char *]" msgstr "" # 9c55c960a2a846a49eaff59a51dbf27d -#: ../src/Doc/c-api/arg.rst:262 +#: c-api/arg.rst:262 msgid "" "Similar to ``s``, but accepts any object which implements the read-write " "buffer interface. The caller must determine the length of the buffer by " @@ -864,13 +840,12 @@ msgid "" "accepted; :exc:`TypeError` is raised for all others." msgstr "" -# 88e4a11619b04cb883b0fc19dfcbde99 -#: ../src/Doc/c-api/arg.rst:271 -msgid "``w#`` (read-write character buffer) [char \\*, Py_ssize_t]" +#: c-api/arg.rst:272 +msgid "w# (read-write character buffer) [char *, Py_ssize_t]" msgstr "" # c13b19b5d6a5422e863413a8b7f462ea -#: ../src/Doc/c-api/arg.rst:268 +#: c-api/arg.rst:268 msgid "" "Like ``s#``, but accepts any object which implements the read-write buffer " "interface. The :c:type:`char \\*` variable is set to point to the first " @@ -879,23 +854,20 @@ msgid "" "is raised for all others." msgstr "" -# b3a389f9b84948daab67cfb185dc54ff -#: ../src/Doc/c-api/arg.rst:276 -msgid "``w*`` (read-write byte-oriented buffer) [Py_buffer]" +#: c-api/arg.rst:277 +msgid "w* (read-write byte-oriented buffer) [Py_buffer]" msgstr "" # da970fe8e2664df19a11934a5514df53 -#: ../src/Doc/c-api/arg.rst:275 +#: c-api/arg.rst:275 msgid "This is to ``w`` what ``s*`` is to ``s``." msgstr "" -# 7f63cfb972fe4bcbafe185a7239de8a5 -# 74d9b630a06d481f89450e8cd8704edd -#: ../src/Doc/c-api/arg.rst:289 ../src/Doc/c-api/arg.rst:546 -msgid "``(items)`` (tuple) [*matching-items*]" +#: c-api/arg.rst:290 c-api/arg.rst:547 +msgid "(items) (tuple) [matching-items]" msgstr "" -#: ../src/Doc/c-api/arg.rst:280 +#: c-api/arg.rst:280 msgid "" "The object must be a Python sequence whose length is the number of format " "units in *items*. The C arguments must correspond to the individual format " @@ -907,7 +879,7 @@ msgstr "" "pour les séquences peuvent être imbriquées. " # 676c4ddaffc44f008cb2bec58423f5fb -#: ../src/Doc/c-api/arg.rst:286 +#: c-api/arg.rst:286 msgid "" "Prior to Python version 1.5.2, this format specifier only accepted a tuple " "containing the individual parameters, not an arbitrary sequence. Code which " @@ -915,7 +887,7 @@ msgid "" "an exception. This is not expected to be a problem for existing code." msgstr "" -#: ../src/Doc/c-api/arg.rst:292 +#: c-api/arg.rst:292 #, fuzzy msgid "" "It is possible to pass Python long integers where integers are requested; " @@ -930,7 +902,7 @@ msgstr "" "tronqués silencieusement quand le champ cible est trop petit (en fait, la " "sémantique est héritée du transtypage en C --- la perte peut varier)." -#: ../src/Doc/c-api/arg.rst:298 +#: c-api/arg.rst:298 msgid "" "A few other characters have a meaning in a format string. These may not " "occur inside nested parentheses. They are:" @@ -938,12 +910,11 @@ msgstr "" "Quelques autres caractères ont un sens dans une chaîne de format. On ne doit " "pas les trouvées dans des parenthèses imbriquées. Ce sont :" -# 36686b36b42c460fb967e98ebc6b5d5a -#: ../src/Doc/c-api/arg.rst:305 -msgid "``|``" +#: c-api/arg.rst:306 +msgid "|" msgstr "" -#: ../src/Doc/c-api/arg.rst:302 +#: c-api/arg.rst:302 #, fuzzy msgid "" "Indicates that the remaining arguments in the Python argument list are " @@ -958,12 +929,11 @@ msgstr "" "optionnel n'est pas spécifié, la fonction :cfunc:`PyArg_ParseTuple` ne " "modifie par le contenu de la ou des variables C correspondantes." -# 7ad8d6689464479ba31201802843bd7d -#: ../src/Doc/c-api/arg.rst:310 -msgid "``:``" +#: c-api/arg.rst:311 +msgid ":" msgstr "" -#: ../src/Doc/c-api/arg.rst:309 +#: c-api/arg.rst:309 #, fuzzy msgid "" "The list of format units ends here; the string after the colon is used as " @@ -974,12 +944,11 @@ msgstr "" "est utilisée comme le nom de la fonction dans les messages d'erreur (la " "\"valeur associée\" de l'exception levée par :cfunc:`PyArg_ParseTuple`)." -# 0be3d018f4944485911eee5620192ae3 -#: ../src/Doc/c-api/arg.rst:315 -msgid "``;``" +#: c-api/arg.rst:316 +msgid ";" msgstr "" -#: ../src/Doc/c-api/arg.rst:314 +#: c-api/arg.rst:314 msgid "" "The list of format units ends here; the string after the semicolon is used " "as the error message *instead* of the default error message. ``:`` and ``;" @@ -989,7 +958,7 @@ msgstr "" "virgule est utilise comme message d'erreur *au lieu* du message d'erreur par " "défaut. ``:`` et ``;`` sont mutuellement exclusifs. " -#: ../src/Doc/c-api/arg.rst:318 +#: c-api/arg.rst:318 msgid "" "Note that any Python object references which are provided to the caller are " "*borrowed* references; do not decrement their reference count!" @@ -998,7 +967,7 @@ msgstr "" "à l'appelant sont des références *empruntées* ; ne décrémentez pas leur " "compteur de références ! " -#: ../src/Doc/c-api/arg.rst:321 +#: c-api/arg.rst:321 msgid "" "Additional arguments passed to these functions must be addresses of " "variables whose type is determined by the format string; these are used to " @@ -1015,7 +984,7 @@ msgstr "" "devraient correspondre à ce qui est spécifié pour l'unité de format " "correspondante." -#: ../src/Doc/c-api/arg.rst:327 +#: c-api/arg.rst:327 #, fuzzy msgid "" "For the conversion to succeed, the *arg* object must match the format and " @@ -1035,7 +1004,7 @@ msgstr "" "formats suivantes sont laissées telles quelles." # 4ec07e3d677f44b5a24bd930af3fbe0a -#: ../src/Doc/c-api/arg.rst:337 +#: c-api/arg.rst:337 msgid "" "Parse the parameters of a function that takes only positional parameters " "into local variables. Returns true on success; on failure, it returns false " @@ -1043,14 +1012,14 @@ msgid "" msgstr "" # 5d23fe7ac0ab452aa2347de7509a03d7 -#: ../src/Doc/c-api/arg.rst:344 +#: c-api/arg.rst:344 msgid "" "Identical to :c:func:`PyArg_ParseTuple`, except that it accepts a va_list " "rather than a variable number of arguments." msgstr "" # 9adeea4fe4f74055bdc014fe2a409b99 -#: ../src/Doc/c-api/arg.rst:350 +#: c-api/arg.rst:350 msgid "" "Parse the parameters of a function that takes both positional and keyword " "parameters into local variables. Returns true on success; on failure, it " @@ -1058,14 +1027,14 @@ msgid "" msgstr "" # 6a76993381ba4fdca0f4c6ac6c4511f2 -#: ../src/Doc/c-api/arg.rst:357 +#: c-api/arg.rst:357 msgid "" "Identical to :c:func:`PyArg_ParseTupleAndKeywords`, except that it accepts a " "va_list rather than a variable number of arguments." msgstr "" # c5e06645c13e4df0bd8ee05e1f666ce3 -#: ../src/Doc/c-api/arg.rst:363 +#: c-api/arg.rst:363 msgid "" "Function used to deconstruct the argument lists of \"old-style\" functions " "--- these are functions which use the :const:`METH_OLDARGS` parameter " @@ -1077,7 +1046,7 @@ msgid "" msgstr "" # 302a4e7528cd451784fde4203aae60f6 -#: ../src/Doc/c-api/arg.rst:374 +#: c-api/arg.rst:374 msgid "" "A simpler form of parameter retrieval which does not use a format string to " "specify the types of the arguments. Functions which use this method to " @@ -1096,21 +1065,27 @@ msgid "" msgstr "" # cb3fca3d06a340a1bf6be151a0da5504 -#: ../src/Doc/c-api/arg.rst:388 +#: c-api/arg.rst:388 msgid "" "This is an example of the use of this function, taken from the sources for " "the :mod:`_weakref` helper module for weak references::" msgstr "" # c471c50f307d4573a95ac8d6e4e8933a -#: ../src/Doc/c-api/arg.rst:404 +#: c-api/arg.rst:404 msgid "" "The call to :c:func:`PyArg_UnpackTuple` in this example is entirely " "equivalent to this call to :c:func:`PyArg_ParseTuple`::" msgstr "" +#: c-api/arg.rst:411 +msgid "" +"This function used an :c:type:`int` type for *min* and *max*. This might " +"require changes in your code for properly supporting 64-bit systems." +msgstr "" + # e222fb111287456b92598542681377bc -#: ../src/Doc/c-api/arg.rst:418 +#: c-api/arg.rst:418 msgid "" "Create a new value based on a format string similar to those accepted by " "the :c:func:`PyArg_Parse\\*` family of functions and a sequence of values. " @@ -1119,7 +1094,7 @@ msgid "" msgstr "" # b53bb204a68c4ca29f23772134dabaea -#: ../src/Doc/c-api/arg.rst:423 +#: c-api/arg.rst:423 msgid "" ":c:func:`Py_BuildValue` does not always build a tuple. It builds a tuple " "only if its format string contains two or more format units. If the format " @@ -1129,7 +1104,7 @@ msgid "" msgstr "" # 6d6c3c2d51b7495c9e99a498ff27214a -#: ../src/Doc/c-api/arg.rst:430 +#: c-api/arg.rst:430 msgid "" "When memory buffers are passed as parameters to supply data to build " "objects, as for the ``s`` and ``s#`` formats, the required data is copied. " @@ -1141,7 +1116,7 @@ msgid "" msgstr "" # d84964bae02e45a2926905fc407b91c7 -#: ../src/Doc/c-api/arg.rst:438 +#: c-api/arg.rst:438 msgid "" "In the following description, the quoted form is the format unit; the entry " "in (round) parentheses is the Python object type that the format unit will " @@ -1150,77 +1125,71 @@ msgid "" msgstr "" # 86e66e9ada6944e6b1f3ba0e731146b5 -#: ../src/Doc/c-api/arg.rst:443 +#: c-api/arg.rst:443 msgid "" "The characters space, tab, colon and comma are ignored in format strings " "(but not within format units such as ``s#``). This can be used to make long " "format strings a tad more readable." msgstr "" -# 3ff1209b196145d9b2e374846f7ef22b -#: ../src/Doc/c-api/arg.rst:448 -msgid "``s`` (string) [char \\*]" +#: c-api/arg.rst:449 +msgid "s (string) [char *]" msgstr "" # 2d70ed1d2bab424aa6a860dbc1ee4681 -#: ../src/Doc/c-api/arg.rst:448 +#: c-api/arg.rst:448 msgid "" "Convert a null-terminated C string to a Python object. If the C string " "pointer is *NULL*, ``None`` is used." msgstr "" -# 6c8b8174197e40bfb6466484ebecf6cb -#: ../src/Doc/c-api/arg.rst:452 -msgid "``s#`` (string) [char \\*, int]" +#: c-api/arg.rst:453 +msgid "s# (string) [char *, int]" msgstr "" # 00fc1fdc236a4696a2c97c0127e85db2 -#: ../src/Doc/c-api/arg.rst:452 +#: c-api/arg.rst:452 msgid "" "Convert a C string and its length to a Python object. If the C string " "pointer is *NULL*, the length is ignored and ``None`` is returned." msgstr "" -# a8362b11d1374d61ae8c247502542da6 -#: ../src/Doc/c-api/arg.rst:455 -msgid "``z`` (string or ``None``) [char \\*]" +#: c-api/arg.rst:456 +msgid "z (string or None) [char *]" msgstr "" # 9fd457e48a5743c0a4310b9d435869ed -#: ../src/Doc/c-api/arg.rst:456 +#: c-api/arg.rst:456 msgid "Same as ``s``." msgstr "" -# 3709eb3820e945f396069dd5194a2225 -#: ../src/Doc/c-api/arg.rst:458 -msgid "``z#`` (string or ``None``) [char \\*, int]" +#: c-api/arg.rst:459 +msgid "z# (string or None) [char *, int]" msgstr "" # 1afa18111a644ae6974962a73a9d8c3c -#: ../src/Doc/c-api/arg.rst:459 +#: c-api/arg.rst:459 msgid "Same as ``s#``." msgstr "" -# ea864c3ea6504f05b4ee13bffea15908 -#: ../src/Doc/c-api/arg.rst:463 -msgid "``u`` (Unicode string) [Py_UNICODE \\*]" +#: c-api/arg.rst:464 +msgid "u (Unicode string) [Py_UNICODE *]" msgstr "" # 37b1f67090f04d18986732a501c487f7 -#: ../src/Doc/c-api/arg.rst:462 +#: c-api/arg.rst:462 msgid "" "Convert a null-terminated buffer of Unicode (UCS-2 or UCS-4) data to a " "Python Unicode object. If the Unicode buffer pointer is *NULL*, ``None`` is " "returned." msgstr "" -# d7c8046b41774216a04d1a30a92cdaaf -#: ../src/Doc/c-api/arg.rst:468 -msgid "``u#`` (Unicode string) [Py_UNICODE \\*, int]" +#: c-api/arg.rst:469 +msgid "u# (Unicode string) [Py_UNICODE *, int]" msgstr "" # 9780c1261d0a484ba91c6b41377fba9c -#: ../src/Doc/c-api/arg.rst:467 +#: c-api/arg.rst:467 msgid "" "Convert a Unicode (UCS-2 or UCS-4) data buffer and its length to a Python " "Unicode object. If the Unicode buffer pointer is *NULL*, the length is " @@ -1228,27 +1197,26 @@ msgid "" msgstr "" # 8ea20cbea40f445489b6c429b44779a9 -#: ../src/Doc/c-api/arg.rst:472 +#: c-api/arg.rst:472 msgid "Convert a plain C :c:type:`int` to a Python integer object." msgstr "" -# a6ddbe672fa44888b4f0a9777e41838f -#: ../src/Doc/c-api/arg.rst:474 -msgid "``b`` (integer) [char]" +#: c-api/arg.rst:475 +msgid "b (integer) [char]" msgstr "" # 1721f80a75d54abe965d8e7c199b3aaa -#: ../src/Doc/c-api/arg.rst:475 +#: c-api/arg.rst:475 msgid "Convert a plain C :c:type:`char` to a Python integer object." msgstr "" # 5e3170a4458a43eb8fac71fc6659be44 -#: ../src/Doc/c-api/arg.rst:478 +#: c-api/arg.rst:478 msgid "Convert a plain C :c:type:`short int` to a Python integer object." msgstr "" # f7926bc1d06d44bb9b9bbdec4e9c615f -#: ../src/Doc/c-api/arg.rst:481 +#: c-api/arg.rst:481 #, fuzzy msgid "Convert a C :c:type:`long int` to a Python integer object." msgstr "" @@ -1256,50 +1224,47 @@ msgstr "" "contrôle de débordement." # 68ff3980c65f4a5aa3ac8f1eb352b65a -#: ../src/Doc/c-api/arg.rst:484 +#: c-api/arg.rst:484 #, fuzzy msgid "Convert a C :c:type:`unsigned char` to a Python integer object." msgstr "" "Convertit un entier Python en un C :ctype:`unsigned short int`, sans " "contrôle de débordement." -#: ../src/Doc/c-api/arg.rst:487 +#: c-api/arg.rst:487 #, fuzzy msgid "Convert a C :c:type:`unsigned short int` to a Python integer object." msgstr "" "Convertit un entier Python en un C :ctype:`unsigned short int`, sans " "contrôle de débordement." -# aac9a6792fda471fae299cf60c1d1fb9 -#: ../src/Doc/c-api/arg.rst:490 -msgid "``I`` (integer/long) [unsigned int]" +#: c-api/arg.rst:491 +msgid "I (integer/long) [unsigned int]" msgstr "" # c2293c3a587349b2b201a77e6fcc56ec -#: ../src/Doc/c-api/arg.rst:490 +#: c-api/arg.rst:490 msgid "" "Convert a C :c:type:`unsigned int` to a Python integer object or a Python " "long integer object, if it is larger than ``sys.maxint``." msgstr "" -# fbfca71dc52c475d89aece7d04f340e0 -#: ../src/Doc/c-api/arg.rst:494 -msgid "``k`` (integer/long) [unsigned long]" +#: c-api/arg.rst:495 +msgid "k (integer/long) [unsigned long]" msgstr "" # f11ae35e1ebc427ab246df4100fd5e43 -#: ../src/Doc/c-api/arg.rst:494 +#: c-api/arg.rst:494 msgid "" "Convert a C :c:type:`unsigned long` to a Python integer object or a Python " "long integer object, if it is larger than ``sys.maxint``." msgstr "" -# b8d615f71a4f46d7aed5b9715a4a1a81 -#: ../src/Doc/c-api/arg.rst:498 -msgid "``L`` (long) [PY_LONG_LONG]" +#: c-api/arg.rst:499 +msgid "L (long) [PY_LONG_LONG]" msgstr "" -#: ../src/Doc/c-api/arg.rst:498 +#: c-api/arg.rst:498 #, fuzzy msgid "" "Convert a C :c:type:`long long` to a Python long integer object. Only " @@ -1309,12 +1274,11 @@ msgstr "" "uniquement disponible sur les plates-formes qui prennent en charge :ctype:" "`long long` (ou :ctype:`_int64` sous Windows)." -# 31a59f43b5d24ce59b60b076423b168f -#: ../src/Doc/c-api/arg.rst:502 -msgid "``K`` (long) [unsigned PY_LONG_LONG]" +#: c-api/arg.rst:503 +msgid "K (long) [unsigned PY_LONG_LONG]" msgstr "" -#: ../src/Doc/c-api/arg.rst:502 +#: c-api/arg.rst:502 #, fuzzy msgid "" "Convert a C :c:type:`unsigned long long` to a Python long integer object. " @@ -1325,46 +1289,44 @@ msgstr "" "formes qui prennent en charge :ctype:`unsigned long long` (ou :ctype:" "`unsigned _int64` sous Windows)." -# 65f498e545d24fb7ba18e87664c7d2df -#: ../src/Doc/c-api/arg.rst:507 -msgid "``n`` (int) [Py_ssize_t]" +#: c-api/arg.rst:508 +msgid "n (int) [Py_ssize_t]" msgstr "" -#: ../src/Doc/c-api/arg.rst:506 +#: c-api/arg.rst:506 #, fuzzy msgid "Convert a C :c:type:`Py_ssize_t` to a Python integer or long integer." msgstr "Convertit un entier Python en un type :ctype:`long int`." # 795712ab0f0a4243b5882acdedf2cbbc -#: ../src/Doc/c-api/arg.rst:511 +#: c-api/arg.rst:511 msgid "" "Convert a C :c:type:`int` representing a character to a Python string of " "length 1." msgstr "" -#: ../src/Doc/c-api/arg.rst:515 +#: c-api/arg.rst:515 #, fuzzy msgid "Convert a C :c:type:`double` to a Python floating point number." msgstr "Convertit un nombre flottant Python vers un type C :ctype:`float`." # 40c39c925dcd43ffa89d1e533cb92aba -#: ../src/Doc/c-api/arg.rst:518 +#: c-api/arg.rst:518 msgid "Same as ``d``." msgstr "" -# e4d71aa6eb8b4d3884c0f5e5ef6315c2 -#: ../src/Doc/c-api/arg.rst:520 -msgid "``D`` (complex) [Py_complex \\*]" +#: c-api/arg.rst:521 +msgid "D (complex) [Py_complex *]" msgstr "" -#: ../src/Doc/c-api/arg.rst:521 +#: c-api/arg.rst:521 #, fuzzy msgid "Convert a C :c:type:`Py_complex` structure to a Python complex number." msgstr "" "Convertit un nombre complexe Python vers une structure C :ctype:`Py_complex`." # e687e49493d349738b5ed07099e55f8f -#: ../src/Doc/c-api/arg.rst:524 +#: c-api/arg.rst:524 msgid "" "Pass a Python object untouched (except for its reference count, which is " "incremented by one). If the object passed in is a *NULL* pointer, it is " @@ -1374,23 +1336,21 @@ msgid "" "yet, :exc:`SystemError` is set." msgstr "" -# 1acdc439fe644c51baa404e11bc588ab -#: ../src/Doc/c-api/arg.rst:531 -msgid "``S`` (object) [PyObject \\*]" +#: c-api/arg.rst:532 +msgid "S (object) [PyObject *]" msgstr "" # 4f2699210d3549ca8f99d85372897683 -#: ../src/Doc/c-api/arg.rst:532 +#: c-api/arg.rst:532 msgid "Same as ``O``." msgstr "" -# 7562e29f5a0a417a8267120100292e11 -#: ../src/Doc/c-api/arg.rst:536 -msgid "``N`` (object) [PyObject \\*]" +#: c-api/arg.rst:537 +msgid "N (object) [PyObject *]" msgstr "" # e71bb1d2e3cf4ab19ee20610b0921d77 -#: ../src/Doc/c-api/arg.rst:535 +#: c-api/arg.rst:535 msgid "" "Same as ``O``, except it doesn't increment the reference count on the " "object. Useful when the object is created by a call to an object " @@ -1398,7 +1358,7 @@ msgid "" msgstr "" # f6f2b3b594044f1aaf2bc99f90841176 -#: ../src/Doc/c-api/arg.rst:540 +#: c-api/arg.rst:540 msgid "" "Convert *anything* to a Python object through a *converter* function. The " "function is called with *anything* (which should be compatible with :c:type:" @@ -1407,31 +1367,29 @@ msgid "" msgstr "" # 7e5428c9ec0b4a9ea50b29299721ec07 -#: ../src/Doc/c-api/arg.rst:546 +#: c-api/arg.rst:546 msgid "" "Convert a sequence of C values to a Python tuple with the same number of " "items." msgstr "" -# 6c405dd99fa24175b5c67ae49c62ad40 -#: ../src/Doc/c-api/arg.rst:550 -msgid "``[items]`` (list) [*matching-items*]" +#: c-api/arg.rst:551 +msgid "[items] (list) [matching-items]" msgstr "" # 12d80ac5c3184fd994f6f711d98934ba -#: ../src/Doc/c-api/arg.rst:550 +#: c-api/arg.rst:550 msgid "" "Convert a sequence of C values to a Python list with the same number of " "items." msgstr "" -# acc3e7d3258b4ca4b801f6550fd94f2b -#: ../src/Doc/c-api/arg.rst:555 -msgid "``{items}`` (dictionary) [*matching-items*]" +#: c-api/arg.rst:556 +msgid "{items} (dictionary) [matching-items]" msgstr "" # f292bfb2366c43afb96553561173a60d -#: ../src/Doc/c-api/arg.rst:554 +#: c-api/arg.rst:554 msgid "" "Convert a sequence of C values to a Python dictionary. Each pair of " "consecutive C values adds one item to the dictionary, serving as key and " @@ -1439,24 +1397,24 @@ msgid "" msgstr "" # 83229eda42e44beb8ef5bc9cd5d01e81 -#: ../src/Doc/c-api/arg.rst:558 +#: c-api/arg.rst:558 msgid "" "If there is an error in the format string, the :exc:`SystemError` exception " "is set and *NULL* returned." msgstr "" # 02e1bbd2381b4e6790b698c3050e18e3 -#: ../src/Doc/c-api/arg.rst:563 +#: c-api/arg.rst:563 msgid "" "Identical to :c:func:`Py_BuildValue`, except that it accepts a va_list " "rather than a variable number of arguments." msgstr "" -#: ../src/Doc/c-api/bool.rst:6 +#: c-api/bool.rst:6 msgid "Boolean Objects" msgstr "Les objets booléens" -#: ../src/Doc/c-api/bool.rst:8 +#: c-api/bool.rst:8 msgid "" "Booleans in Python are implemented as a subclass of integers. There are " "only two booleans, :const:`Py_False` and :const:`Py_True`. As such, the " @@ -1470,51 +1428,51 @@ msgstr "" "disponibles." # 7eecc4139f404bb4ab5dbbd0404f96f3 -#: ../src/Doc/c-api/bool.rst:16 +#: c-api/bool.rst:16 msgid "Return true if *o* is of type :c:data:`PyBool_Type`." msgstr "" # b1392abc005a4ee1b96a038f4766414a -#: ../src/Doc/c-api/bool.rst:23 +#: c-api/bool.rst:23 msgid "" "The Python ``False`` object. This object has no methods. It needs to be " "treated just like any other object with respect to reference counts." msgstr "" # a541254e5fcd420581ae9b736842be75 -#: ../src/Doc/c-api/bool.rst:29 +#: c-api/bool.rst:29 msgid "" "The Python ``True`` object. This object has no methods. It needs to be " "treated just like any other object with respect to reference counts." msgstr "" # 37a8e1538dc34de8987b6868b110e07b -#: ../src/Doc/c-api/bool.rst:35 +#: c-api/bool.rst:35 msgid "" "Return :const:`Py_False` from a function, properly incrementing its " "reference count." msgstr "" # 4220605a144344d28e7434867c49675a -#: ../src/Doc/c-api/bool.rst:43 +#: c-api/bool.rst:43 msgid "" "Return :const:`Py_True` from a function, properly incrementing its reference " "count." msgstr "" # 064a3eb1aa9d495caa5b06d7ba135bac -#: ../src/Doc/c-api/bool.rst:51 +#: c-api/bool.rst:51 msgid "" "Return a new reference to :const:`Py_True` or :const:`Py_False` depending on " "the truth value of *v*." msgstr "" -#: ../src/Doc/c-api/buffer.rst:6 +#: c-api/buffer.rst:6 #, fuzzy msgid "Buffers and Memoryview Objects" msgstr "Objets de type MemoryView" -#: ../src/Doc/c-api/buffer.rst:16 +#: c-api/buffer.rst:16 #, fuzzy msgid "" "Python objects implemented in C can export a group of functions called the " @@ -1529,7 +1487,7 @@ msgstr "" "ces objets peuvent utiliser l'interface sur les tampons pour accéder " "directement aux données de l'objet, sans nécessiter une copie préalable." -#: ../src/Doc/c-api/buffer.rst:22 +#: c-api/buffer.rst:22 #, fuzzy msgid "" "Two examples of objects that support the buffer interface are strings and " @@ -1545,7 +1503,7 @@ msgstr "" "également exposer son contenu, mais il doit être remarqué que les éléments " "du tableau peuvent être des valeurs multi-octets." -#: ../src/Doc/c-api/buffer.rst:29 +#: c-api/buffer.rst:29 #, fuzzy msgid "" "An example user of the buffer interface is the file object's :meth:`write` " @@ -1561,7 +1519,7 @@ msgstr "" "l'interface tampon de l'objet, en retournant les données de l'objet cible." # 0c5afa5680604590aad7866d539629a5 -#: ../src/Doc/c-api/buffer.rst:35 +#: c-api/buffer.rst:35 msgid "" "Starting from version 1.6, Python has been providing Python-level buffer " "objects and a C-level buffer API so that any built-in or used-defined type " @@ -1572,7 +1530,7 @@ msgid "" msgstr "" # e057b41fa5e44c42b136d8af81052eb1 -#: ../src/Doc/c-api/buffer.rst:42 +#: c-api/buffer.rst:42 msgid "" "The new buffer API has been backported to Python 2.6, and the :class:" "`memoryview` object has been backported to Python 2.7. It is strongly " @@ -1581,27 +1539,27 @@ msgid "" msgstr "" # ce80a72b2cfc487f93017794efd310f6 -#: ../src/Doc/c-api/buffer.rst:49 +#: c-api/buffer.rst:49 msgid "The new-style Py_buffer struct" msgstr "" # 83097360e75b435e85ac579f59791469 -#: ../src/Doc/c-api/buffer.rst:56 +#: c-api/buffer.rst:56 msgid "A pointer to the start of the memory for the object." msgstr "" # b54a3cdb08434c8d8a06100b276d8860 -#: ../src/Doc/c-api/buffer.rst:61 +#: c-api/buffer.rst:61 msgid "The total length of the memory in bytes." msgstr "" # 4e924243c7d044c7a00211c2166abb4d -#: ../src/Doc/c-api/buffer.rst:65 +#: c-api/buffer.rst:65 msgid "An indicator of whether the buffer is read only." msgstr "" # 3fbf60c911154e8894b35857766d22e2 -#: ../src/Doc/c-api/buffer.rst:70 +#: c-api/buffer.rst:70 msgid "" "A *NULL* terminated string in :mod:`struct` module style syntax giving the " "contents of the elements available through the buffer. If this is *NULL*, ``" @@ -1609,7 +1567,7 @@ msgid "" msgstr "" # 838187362040442ab4ee0769301ea412 -#: ../src/Doc/c-api/buffer.rst:76 +#: c-api/buffer.rst:76 msgid "" "The number of dimensions the memory represents as a multi-dimensional " "array. If it is 0, :c:data:`strides` and :c:data:`suboffsets` must be " @@ -1617,7 +1575,7 @@ msgid "" msgstr "" # 0cddaa36ffea43628af5a1541cf1d6fc -#: ../src/Doc/c-api/buffer.rst:82 +#: c-api/buffer.rst:82 msgid "" "An array of :c:type:`Py_ssize_t`\\s the length of :c:data:`ndim` giving the " "shape of the memory as a multi-dimensional array. Note that ``((*shape)[0] " @@ -1625,14 +1583,14 @@ msgid "" msgstr "" # cdf90a87c7994b43be4bf5430dd8e324 -#: ../src/Doc/c-api/buffer.rst:89 +#: c-api/buffer.rst:89 msgid "" "An array of :c:type:`Py_ssize_t`\\s the length of :c:data:`ndim` giving the " "number of bytes to skip to get to a new element in each dimension." msgstr "" # 575a94161c1148efaacb767b5e632fcb -#: ../src/Doc/c-api/buffer.rst:94 +#: c-api/buffer.rst:94 msgid "" "An array of :c:type:`Py_ssize_t`\\s the length of :c:data:`ndim`. If these " "suboffset numbers are greater than or equal to 0, then the value stored " @@ -1642,16 +1600,21 @@ msgid "" "a contiguous memory block)." msgstr "" -# 2684c4272930409e99bf488695024eb0 -#: ../src/Doc/c-api/buffer.rst:101 +#: c-api/buffer.rst:101 +msgid "" +"If all suboffsets are negative (i.e. no de-referencing is needed, then this " +"field must be NULL (the default value)." +msgstr "" + +#: c-api/buffer.rst:104 msgid "" "Here is a function that returns a pointer to the element in an N-D array " -"pointed to by an N-dimesional index when there are both non-NULL strides and " -"suboffsets::" +"pointed to by an N-dimensional index when there are both non-NULL strides " +"and suboffsets::" msgstr "" # d63a473e84914810b47c28fe15fc48b6 -#: ../src/Doc/c-api/buffer.rst:121 +#: c-api/buffer.rst:124 msgid "" "This is a storage for the itemsize (in bytes) of each element of the shared " "memory. It is technically un-necessary as it can be obtained using :c:func:" @@ -1662,7 +1625,7 @@ msgid "" msgstr "" # 04681b1ea2124d508e0b16cac84381ae -#: ../src/Doc/c-api/buffer.rst:130 +#: c-api/buffer.rst:133 msgid "" "This is for use internally by the exporting object. For example, this might " "be re-cast as an integer by the exporter and used to store flags about " @@ -1670,17 +1633,17 @@ msgid "" "the buffer is released. The consumer should never alter this value." msgstr "" -#: ../src/Doc/c-api/buffer.rst:138 +#: c-api/buffer.rst:141 msgid "Buffer related functions" msgstr "Fonctions relatives aux tampons" # 1bea0f2f621a401fbc2da256d8664c90 -#: ../src/Doc/c-api/buffer.rst:143 +#: c-api/buffer.rst:146 msgid "Return 1 if *obj* supports the buffer interface otherwise 0." msgstr "" # 2b5281ff37d5413fa58df835c6d75db0 -#: ../src/Doc/c-api/buffer.rst:148 +#: c-api/buffer.rst:151 msgid "" "Export *obj* into a :c:type:`Py_buffer`, *view*. These arguments must never " "be *NULL*. The *flags* argument is a bit field indicating what kind of " @@ -1692,7 +1655,7 @@ msgid "" msgstr "" # eb4076fdeae34400bfa56014427c29a5 -#: ../src/Doc/c-api/buffer.rst:156 +#: c-api/buffer.rst:159 msgid "" "Some exporters may not be able to share memory in every possible way and may " "need to raise errors to signal to some consumers that something is just not " @@ -1704,32 +1667,32 @@ msgid "" msgstr "" # f31e0fe06b3544218bae2a5ccbd66608 -#: ../src/Doc/c-api/buffer.rst:164 +#: c-api/buffer.rst:167 msgid "0 is returned on success and -1 on error." msgstr "" # b73cabc466dd4fc39a6b5cf9737b86da -#: ../src/Doc/c-api/buffer.rst:166 +#: c-api/buffer.rst:169 msgid "The following table gives possible values to the *flags* arguments." msgstr "" # 7d3506eb9b8844acafee7ba99112828f -#: ../src/Doc/c-api/buffer.rst:169 +#: c-api/buffer.rst:172 msgid "Flag" msgstr "" # e5e455e093564332a040ab0e2c24d082 -#: ../src/Doc/c-api/buffer.rst:169 +#: c-api/buffer.rst:172 msgid "Description" msgstr "" # 564c45ab528f44818e85d070ffb82de7 -#: ../src/Doc/c-api/buffer.rst:171 +#: c-api/buffer.rst:174 msgid ":c:macro:`PyBUF_SIMPLE`" msgstr "" # 9eb3717136054e61afb9648c406f4b5c -#: ../src/Doc/c-api/buffer.rst:171 +#: c-api/buffer.rst:174 msgid "" "This is the default flag state. The returned buffer may or may not have " "writable memory. The format of the data will be assumed to be unsigned " @@ -1739,24 +1702,24 @@ msgid "" msgstr "" # c0b3c1f1d6bc4b699dc855ba0682eeb9 -#: ../src/Doc/c-api/buffer.rst:180 +#: c-api/buffer.rst:183 msgid ":c:macro:`PyBUF_WRITABLE`" msgstr "" # 3f9ca17b6bb64113bbe298c75fe72e79 -#: ../src/Doc/c-api/buffer.rst:180 +#: c-api/buffer.rst:183 msgid "" "The returned buffer must be writable. If it is not writable, then raise an " "error." msgstr "" # 6ff1045f7f9541cba44da3a729d87634 -#: ../src/Doc/c-api/buffer.rst:183 +#: c-api/buffer.rst:186 msgid ":c:macro:`PyBUF_STRIDES`" msgstr "" # 859d6ca98521458db13c1b50cd5eada8 -#: ../src/Doc/c-api/buffer.rst:183 +#: c-api/buffer.rst:186 msgid "" "This implies :c:macro:`PyBUF_ND`. The returned buffer must provide strides " "information (i.e. the strides cannot be NULL). This would be used when the " @@ -1767,12 +1730,12 @@ msgid "" msgstr "" # 713e91af240b413895ff45a30035a060 -#: ../src/Doc/c-api/buffer.rst:193 +#: c-api/buffer.rst:196 msgid ":c:macro:`PyBUF_ND`" msgstr "" # 783aa64cdc6342c89113e77a329eb6cb -#: ../src/Doc/c-api/buffer.rst:193 +#: c-api/buffer.rst:196 msgid "" "The returned buffer must provide shape information. The memory will be " "assumed C-style contiguous (last dimension varies the fastest). The exporter " @@ -1781,14 +1744,14 @@ msgid "" msgstr "" # 597623de5ee446a9a9767cea888e75e9 -#: ../src/Doc/c-api/buffer.rst:203 +#: c-api/buffer.rst:206 msgid "" ":c:macro:`PyBUF_C_CONTIGUOUS` :c:macro:`PyBUF_F_CONTIGUOUS` :c:macro:" "`PyBUF_ANY_CONTIGUOUS`" msgstr "" # 657075ebe6d24b869c7a1c28a517f54f -#: ../src/Doc/c-api/buffer.rst:203 +#: c-api/buffer.rst:206 msgid "" "These flags indicate that the contiguity returned buffer must be " "respectively, C-contiguous (last dimension varies the fastest), Fortran " @@ -1798,12 +1761,12 @@ msgid "" msgstr "" # 2a27c0c78917485e974a6934d77da59e -#: ../src/Doc/c-api/buffer.rst:213 +#: c-api/buffer.rst:216 msgid ":c:macro:`PyBUF_INDIRECT`" msgstr "" # 874cd7e54dfc4851aed475319cdfb86d -#: ../src/Doc/c-api/buffer.rst:213 +#: c-api/buffer.rst:216 msgid "" "This flag indicates the returned buffer must have suboffsets information " "(which can be NULL if no suboffsets are needed). This can be used when the " @@ -1812,12 +1775,12 @@ msgid "" msgstr "" # 825a3156759040f28465575167328270 -#: ../src/Doc/c-api/buffer.rst:223 +#: c-api/buffer.rst:226 msgid ":c:macro:`PyBUF_FORMAT`" msgstr "" # 7700024495fc415fbf4c9822929a3788 -#: ../src/Doc/c-api/buffer.rst:223 +#: c-api/buffer.rst:226 msgid "" "The returned buffer must have true format information if this flag is " "provided. This would be used when the consumer is going to be checking for " @@ -1828,103 +1791,103 @@ msgid "" msgstr "" # b38af5a366d84c0886641165e5dff7fe -#: ../src/Doc/c-api/buffer.rst:233 +#: c-api/buffer.rst:236 msgid ":c:macro:`PyBUF_STRIDED`" msgstr "" # 897e2e5edccd4db1a70c98d7df692661 -#: ../src/Doc/c-api/buffer.rst:233 +#: c-api/buffer.rst:236 msgid "This is equivalent to ``(PyBUF_STRIDES | PyBUF_WRITABLE)``." msgstr "" # 87f7ca79b01649108983439d9b5867e2 -#: ../src/Doc/c-api/buffer.rst:236 +#: c-api/buffer.rst:239 msgid ":c:macro:`PyBUF_STRIDED_RO`" msgstr "" # ccaad422dcef4e8190c57f4e2bbb148f -#: ../src/Doc/c-api/buffer.rst:236 +#: c-api/buffer.rst:239 msgid "This is equivalent to ``(PyBUF_STRIDES)``." msgstr "" # 3cd2b3f4e8384baca7e52c52cec603fd -#: ../src/Doc/c-api/buffer.rst:239 +#: c-api/buffer.rst:242 msgid ":c:macro:`PyBUF_RECORDS`" msgstr "" # 624130abadb34453bb7b097b7adffa49 -#: ../src/Doc/c-api/buffer.rst:239 +#: c-api/buffer.rst:242 msgid "" "This is equivalent to ``(PyBUF_STRIDES | PyBUF_FORMAT | PyBUF_WRITABLE)``." msgstr "" # ca8f54fd1da544518bc71d830aa8504f -#: ../src/Doc/c-api/buffer.rst:242 +#: c-api/buffer.rst:245 msgid ":c:macro:`PyBUF_RECORDS_RO`" msgstr "" # ef3a267bff5d4706a9e2a335fc3475e8 -#: ../src/Doc/c-api/buffer.rst:242 +#: c-api/buffer.rst:245 msgid "This is equivalent to ``(PyBUF_STRIDES | PyBUF_FORMAT)``." msgstr "" # 000547c903914e8ca2d871d01acb6887 -#: ../src/Doc/c-api/buffer.rst:245 +#: c-api/buffer.rst:248 msgid ":c:macro:`PyBUF_FULL`" msgstr "" # 79e95a57b06d4e0bb45eb4b58dd8481d -#: ../src/Doc/c-api/buffer.rst:245 +#: c-api/buffer.rst:248 msgid "" "This is equivalent to ``(PyBUF_INDIRECT | PyBUF_FORMAT | PyBUF_WRITABLE)``." msgstr "" # 34acb5bf30d9483fa704af247bcdbd51 -#: ../src/Doc/c-api/buffer.rst:248 +#: c-api/buffer.rst:251 msgid ":c:macro:`PyBUF_FULL_RO`" msgstr "" # 57b4070dee194bde9b87713fcab99cde -#: ../src/Doc/c-api/buffer.rst:248 +#: c-api/buffer.rst:251 msgid "This is equivalent to ``(PyBUF_INDIRECT | PyBUF_FORMAT)``." msgstr "" # 36f4032bc0864a2cb6c7ba139df5784b -#: ../src/Doc/c-api/buffer.rst:251 +#: c-api/buffer.rst:254 msgid ":c:macro:`PyBUF_CONTIG`" msgstr "" # a56c268931f347538baac9194097d042 -#: ../src/Doc/c-api/buffer.rst:251 +#: c-api/buffer.rst:254 msgid "This is equivalent to ``(PyBUF_ND | PyBUF_WRITABLE)``." msgstr "" # 99f4c318fff94af3aa6d25379be38426 -#: ../src/Doc/c-api/buffer.rst:254 +#: c-api/buffer.rst:257 msgid ":c:macro:`PyBUF_CONTIG_RO`" msgstr "" # 18017f9087b148ceb5ed3134d679bc59 -#: ../src/Doc/c-api/buffer.rst:254 +#: c-api/buffer.rst:257 msgid "This is equivalent to ``(PyBUF_ND)``." msgstr "" # 0a6410eb1d4d425aa1b62b1c174770de -#: ../src/Doc/c-api/buffer.rst:261 +#: c-api/buffer.rst:264 msgid "" "Release the buffer *view*. This should be called when the buffer is no " "longer being used as it may free memory from it." msgstr "" # 4267617ed0144f1fb8423b696878e630 -#: ../src/Doc/c-api/buffer.rst:267 +#: c-api/buffer.rst:270 msgid "" "Return the implied :c:data:`~Py_buffer.itemsize` from the struct-stype :c:" "data:`~Py_buffer.format`." msgstr "" # 7060ddace37140b48df4ef3461a239bf -#: ../src/Doc/c-api/buffer.rst:273 +#: c-api/buffer.rst:276 msgid "" "Return 1 if the memory defined by the *view* is C-style (*fortran* is " "``'C'``) or Fortran-style (*fortran* is ``'F'``) contiguous or either one " @@ -1932,7 +1895,7 @@ msgid "" msgstr "" # aba16917b1fd4724a2521a5e0820a067 -#: ../src/Doc/c-api/buffer.rst:280 +#: c-api/buffer.rst:283 msgid "" "Fill the *strides* array with byte-strides of a contiguous (C-style if " "*fortran* is ``'C'`` or Fortran-style if *fortran* is ``'F'``) array of the " @@ -1940,25 +1903,25 @@ msgid "" msgstr "" # 31084c6ff76b47df97270e2e0ed7e187 -#: ../src/Doc/c-api/buffer.rst:287 +#: c-api/buffer.rst:290 msgid "" "Fill in a buffer-info structure, *view*, correctly for an exporter that can " "only share a contiguous chunk of memory of \"unsigned bytes\" of the given " "length. Return 0 on success and -1 (with raising an error) on error." msgstr "" -#: ../src/Doc/c-api/buffer.rst:293 +#: c-api/buffer.rst:296 msgid "MemoryView objects" msgstr "Objets de type MemoryView" -#: ../src/Doc/c-api/buffer.rst:297 +#: c-api/buffer.rst:300 #, fuzzy msgid "" "A :class:`memoryview` object exposes the new C level buffer interface as a " "Python object which can then be passed around like any other object." msgstr "Un objet MemoryView expose l'interface tampon au niveau C à Python." -#: ../src/Doc/c-api/buffer.rst:302 +#: c-api/buffer.rst:305 #, fuzzy msgid "" "Create a memoryview object from an object that defines the new buffer " @@ -1966,7 +1929,7 @@ msgid "" msgstr "Un objet MemoryView expose l'interface tampon au niveau C à Python." # 414c75e9fa67453791ae3911767897df -#: ../src/Doc/c-api/buffer.rst:308 +#: c-api/buffer.rst:311 msgid "" "Create a memoryview object wrapping the given buffer-info structure *view*. " "The memoryview object then owns the buffer, which means you shouldn't try to " @@ -1975,7 +1938,7 @@ msgid "" msgstr "" # dcfeedb8e24e4d528cf048eb20375d8f -#: ../src/Doc/c-api/buffer.rst:316 +#: c-api/buffer.rst:319 msgid "" "Create a memoryview object to a contiguous chunk of memory (in either 'C' or " "'F'ortran *order*) from an object that defines the buffer interface. If " @@ -1984,26 +1947,26 @@ msgid "" msgstr "" # 6e8da4f1066a4023a5f9e5e371590228 -#: ../src/Doc/c-api/buffer.rst:325 +#: c-api/buffer.rst:328 msgid "" "Return true if the object *obj* is a memoryview object. It is not currently " "allowed to create subclasses of :class:`memoryview`." msgstr "" # 6e7df2c26e404a6ea601bf77e643fa50 -#: ../src/Doc/c-api/buffer.rst:331 +#: c-api/buffer.rst:334 msgid "" "Return a pointer to the buffer-info structure wrapped by the given object. " "The object **must** be a memoryview instance; this macro doesn't check its " "type, you must do it yourself or you will risk crashes." msgstr "" -#: ../src/Doc/c-api/buffer.rst:337 +#: c-api/buffer.rst:340 #, fuzzy msgid "Old-style buffer objects" msgstr "Autres objets" -#: ../src/Doc/c-api/buffer.rst:341 +#: c-api/buffer.rst:344 #, fuzzy msgid "" "More information on the old buffer interface is provided in the section :ref:" @@ -2014,7 +1977,7 @@ msgstr "" "`PyBufferProcs`." # c9eefd8cce0745c7ad1c32c0cb581ce4 -#: ../src/Doc/c-api/buffer.rst:344 +#: c-api/buffer.rst:347 msgid "" "A \"buffer object\" is defined in the :file:`bufferobject.h` header " "(included by :file:`Python.h`). These objects look very similar to string " @@ -2024,7 +1987,7 @@ msgid "" "another object which exports the buffer interface." msgstr "" -#: ../src/Doc/c-api/buffer.rst:351 +#: c-api/buffer.rst:354 #, fuzzy msgid "" "Buffer objects are useful as a way to expose the data from another object's " @@ -2047,12 +2010,12 @@ msgstr "" "données structurées dans leur format originel en mémoire." # 28c73b7f1fd543c1bc7229516c6cdaab -#: ../src/Doc/c-api/buffer.rst:363 +#: c-api/buffer.rst:366 msgid "This subtype of :c:type:`PyObject` represents a buffer object." msgstr "" # 1ae50d720b8a42599024b36773b9dafe -#: ../src/Doc/c-api/buffer.rst:370 +#: c-api/buffer.rst:373 msgid "" "The instance of :c:type:`PyTypeObject` which represents the Python buffer " "type; it is the same object as ``buffer`` and ``types.BufferType`` in the " @@ -2060,7 +2023,7 @@ msgid "" msgstr "" # 164fa632c813488c8ba1b240b8b75f6b -#: ../src/Doc/c-api/buffer.rst:377 +#: c-api/buffer.rst:380 msgid "" "This constant may be passed as the *size* parameter to :c:func:" "`PyBuffer_FromObject` or :c:func:`PyBuffer_FromReadWriteObject`. It " @@ -2070,12 +2033,12 @@ msgid "" msgstr "" # 929e9c14e96745ab8b6d879dde6d041e -#: ../src/Doc/c-api/buffer.rst:387 +#: c-api/buffer.rst:390 msgid "Return true if the argument has type :c:data:`PyBuffer_Type`." msgstr "" # 4ac49c7321434709ab08bda3b9d515be -#: ../src/Doc/c-api/buffer.rst:392 +#: c-api/buffer.rst:395 msgid "" "Return a new read-only buffer object. This raises :exc:`TypeError` if " "*base* doesn't support the read-only buffer protocol or doesn't provide " @@ -2087,8 +2050,14 @@ msgid "" "length of the *base* object's exported buffer data." msgstr "" +#: c-api/buffer.rst:404 c-api/buffer.rst:416 +msgid "" +"This function used an :c:type:`int` type for *offset* and *size*. This might " +"require changes in your code for properly supporting 64-bit systems." +msgstr "" + # eede442b0d224e27b7cfb4bdc7e2e19b -#: ../src/Doc/c-api/buffer.rst:409 +#: c-api/buffer.rst:412 msgid "" "Return a new writable buffer object. Parameters and exceptions are similar " "to those for :c:func:`PyBuffer_FromObject`. If the *base* object does not " @@ -2096,7 +2065,7 @@ msgid "" msgstr "" # ad4f2ae694c9426a87ba14f5d6ab37f0 -#: ../src/Doc/c-api/buffer.rst:421 +#: c-api/buffer.rst:424 msgid "" "Return a new read-only buffer object that reads from a specified location in " "memory, with a specified size. The caller is responsible for ensuring that " @@ -2107,14 +2076,14 @@ msgid "" msgstr "" # 92db21d5356f4876b911eeb7050c7a8b -#: ../src/Doc/c-api/buffer.rst:435 +#: c-api/buffer.rst:438 msgid "" "Similar to :c:func:`PyBuffer_FromMemory`, but the returned buffer is " "writable." msgstr "" # 3395092b4f1c42ef8c9fc558e7a17de2 -#: ../src/Doc/c-api/buffer.rst:445 +#: c-api/buffer.rst:448 msgid "" "Return a new writable buffer object that maintains its own memory buffer of " "*size* bytes. :exc:`ValueError` is returned if *size* is not zero or " @@ -2122,107 +2091,107 @@ msgid "" "`PyObject_AsWriteBuffer`) is not specifically aligned." msgstr "" -#: ../src/Doc/c-api/bytearray.rst:6 +#: c-api/bytearray.rst:6 msgid "Byte Array Objects" msgstr "Objets Tableau d'Octets" # cf239beefe7f48de9b3788b3ab350d06 -#: ../src/Doc/c-api/bytearray.rst:15 +#: c-api/bytearray.rst:15 msgid "" "This subtype of :c:type:`PyObject` represents a Python bytearray object." msgstr "" # ae6cdcffa84b4a64b6584c95b4a6ffb9 -#: ../src/Doc/c-api/bytearray.rst:20 +#: c-api/bytearray.rst:20 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python bytearray " "type; it is the same object as ``bytearray`` in the Python layer." msgstr "" -#: ../src/Doc/c-api/bytearray.rst:24 +#: c-api/bytearray.rst:24 msgid "Type check macros" msgstr "Macros de vérification de type" # 658e8b186c2a48be98cf88f02734f60e -#: ../src/Doc/c-api/bytearray.rst:28 +#: c-api/bytearray.rst:28 msgid "" "Return true if the object *o* is a bytearray object or an instance of a " "subtype of the bytearray type." msgstr "" # c1df3fec28374e2fa6aa670f6f15d8cd -#: ../src/Doc/c-api/bytearray.rst:34 +#: c-api/bytearray.rst:34 msgid "" "Return true if the object *o* is a bytearray object, but not an instance of " "a subtype of the bytearray type." msgstr "" -#: ../src/Doc/c-api/bytearray.rst:39 +#: c-api/bytearray.rst:39 msgid "Direct API functions" msgstr "Fonctions directes sur l'API" # ed13b2c68bbf4e0f801fa83f868ae1f2 -#: ../src/Doc/c-api/bytearray.rst:43 +#: c-api/bytearray.rst:43 msgid "" "Return a new bytearray object from any object, *o*, that implements the " "buffer protocol." msgstr "" # 0e6f3d8af033441f93de8621cead3051 -#: ../src/Doc/c-api/bytearray.rst:51 +#: c-api/bytearray.rst:51 msgid "" "Create a new bytearray object from *string* and its length, *len*. On " "failure, *NULL* is returned." msgstr "" # 5cfd041759c24ad3b6efc4733dc1d97c -#: ../src/Doc/c-api/bytearray.rst:57 +#: c-api/bytearray.rst:57 msgid "" "Concat bytearrays *a* and *b* and return a new bytearray with the result." msgstr "" # 26bbc9a54899462a9b59b008cfe5f45a -#: ../src/Doc/c-api/bytearray.rst:62 +#: c-api/bytearray.rst:62 msgid "Return the size of *bytearray* after checking for a *NULL* pointer." msgstr "" # ea95b360692945408e6c1b3951de2022 -#: ../src/Doc/c-api/bytearray.rst:67 +#: c-api/bytearray.rst:67 msgid "" "Return the contents of *bytearray* as a char array after checking for a " "*NULL* pointer." msgstr "" # fdd2ceb18a914a8889147294a6d67c1c -#: ../src/Doc/c-api/bytearray.rst:73 +#: c-api/bytearray.rst:73 msgid "Resize the internal buffer of *bytearray* to *len*." msgstr "" -#: ../src/Doc/c-api/bytearray.rst:76 +#: c-api/bytearray.rst:76 msgid "Macros" msgstr "Macros" -#: ../src/Doc/c-api/bytearray.rst:78 +#: c-api/bytearray.rst:78 msgid "These macros trade safety for speed and they don't check pointers." msgstr "" "Ces macros sont taillées pour la vitesse d'exécution et ne vérifient pas les " "pointeurs." # 96b0484439d742cd86cd5fddc8b74b48 -#: ../src/Doc/c-api/bytearray.rst:82 +#: c-api/bytearray.rst:82 msgid "Macro version of :c:func:`PyByteArray_AsString`." msgstr "" # d91cf3de6b0a4f08a056805c9c78d071 -#: ../src/Doc/c-api/bytearray.rst:87 +#: c-api/bytearray.rst:87 msgid "Macro version of :c:func:`PyByteArray_Size`." msgstr "" -#: ../src/Doc/c-api/capsule.rst:6 +#: c-api/capsule.rst:6 msgid "Capsules" msgstr "Capsules" -#: ../src/Doc/c-api/capsule.rst:10 +#: c-api/capsule.rst:10 msgid "" "Refer to :ref:`using-capsules` for more information on using these objects." msgstr "" @@ -2231,7 +2200,7 @@ msgstr "" # 5a6ed2a79ba74f24a1283d4aa15489a9 # f4962d96603f479e8dc749540edba6b0 -#: ../src/Doc/c-api/capsule.rst:15 ../src/Doc/c-api/cobject.rst:18 +#: c-api/capsule.rst:15 c-api/cobject.rst:18 msgid "" "This subtype of :c:type:`PyObject` represents an opaque value, useful for C " "extension modules who need to pass an opaque value (as a :c:type:`void\\*` " @@ -2242,36 +2211,36 @@ msgid "" msgstr "" # 7f745c6c039d48178614dec24b1e100e -#: ../src/Doc/c-api/capsule.rst:24 +#: c-api/capsule.rst:24 msgid "The type of a destructor callback for a capsule. Defined as::" msgstr "" # 57f37e0c192d49ae811c6774dad24383 -#: ../src/Doc/c-api/capsule.rst:28 +#: c-api/capsule.rst:28 msgid "" "See :c:func:`PyCapsule_New` for the semantics of PyCapsule_Destructor " "callbacks." msgstr "" # 2d44ae55a31f413abbd8a8f30a142728 -#: ../src/Doc/c-api/capsule.rst:34 +#: c-api/capsule.rst:34 msgid "Return true if its argument is a :c:type:`PyCapsule`." msgstr "" # 22d7282ef7bd4229990e582c39b9dbea -#: ../src/Doc/c-api/capsule.rst:39 +#: c-api/capsule.rst:39 msgid "" "Create a :c:type:`PyCapsule` encapsulating the *pointer*. The *pointer* " "argument may not be *NULL*." msgstr "" # 903f9f93755a40fea97eb37e640175d1 -#: ../src/Doc/c-api/capsule.rst:42 +#: c-api/capsule.rst:42 msgid "On failure, set an exception and return *NULL*." msgstr "" # 15b0ed4843f040d9b57e18d354f52e83 -#: ../src/Doc/c-api/capsule.rst:44 +#: c-api/capsule.rst:44 msgid "" "The *name* string may either be *NULL* or a pointer to a valid C string. If " "non-*NULL*, this string must outlive the capsule. (Though it is permitted " @@ -2279,14 +2248,14 @@ msgid "" msgstr "" # 8fbf58ed210b4f6b8524745f428eb255 -#: ../src/Doc/c-api/capsule.rst:48 +#: c-api/capsule.rst:48 msgid "" "If the *destructor* argument is not *NULL*, it will be called with the " "capsule as its argument when it is destroyed." msgstr "" # ea2311e7868947e98de7b51216ef1db2 -#: ../src/Doc/c-api/capsule.rst:51 +#: c-api/capsule.rst:51 msgid "" "If this capsule will be stored as an attribute of a module, the *name* " "should be specified as ``modulename.attributename``. This will enable other " @@ -2294,14 +2263,14 @@ msgid "" msgstr "" # a534a1f9123e49cabfffe57c675ff5eb -#: ../src/Doc/c-api/capsule.rst:58 +#: c-api/capsule.rst:58 msgid "" "Retrieve the *pointer* stored in the capsule. On failure, set an exception " "and return *NULL*." msgstr "" # bc84e55e45a9407e8969a6037b625595 -#: ../src/Doc/c-api/capsule.rst:61 +#: c-api/capsule.rst:61 msgid "" "The *name* parameter must compare exactly to the name stored in the capsule. " "If the name stored in the capsule is *NULL*, the *name* passed in must also " @@ -2310,14 +2279,14 @@ msgid "" msgstr "" # e5118c448ab94d6285a2427614ba186e -#: ../src/Doc/c-api/capsule.rst:69 +#: c-api/capsule.rst:69 msgid "" "Return the current destructor stored in the capsule. On failure, set an " "exception and return *NULL*." msgstr "" # ed34ff245a674db89bf4281723d55d65 -#: ../src/Doc/c-api/capsule.rst:72 +#: c-api/capsule.rst:72 msgid "" "It is legal for a capsule to have a *NULL* destructor. This makes a *NULL* " "return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:" @@ -2325,14 +2294,14 @@ msgid "" msgstr "" # 587b8622d19d4ca19c9dcc5849a10f1d -#: ../src/Doc/c-api/capsule.rst:79 +#: c-api/capsule.rst:79 msgid "" "Return the current context stored in the capsule. On failure, set an " "exception and return *NULL*." msgstr "" # 8073e0627bef4b60b43f1ae6c47ecb56 -#: ../src/Doc/c-api/capsule.rst:82 +#: c-api/capsule.rst:82 msgid "" "It is legal for a capsule to have a *NULL* context. This makes a *NULL* " "return code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:" @@ -2340,14 +2309,14 @@ msgid "" msgstr "" # 4fe112f6c30f4463a95824b664207992 -#: ../src/Doc/c-api/capsule.rst:89 +#: c-api/capsule.rst:89 msgid "" "Return the current name stored in the capsule. On failure, set an exception " "and return *NULL*." msgstr "" # 414007577f28426bb565e0a44e13a0d4 -#: ../src/Doc/c-api/capsule.rst:92 +#: c-api/capsule.rst:92 msgid "" "It is legal for a capsule to have a *NULL* name. This makes a *NULL* return " "code somewhat ambiguous; use :c:func:`PyCapsule_IsValid` or :c:func:" @@ -2355,7 +2324,7 @@ msgid "" msgstr "" # 5ad46a54f7c14a39ba96a48fdefcf0ca -#: ../src/Doc/c-api/capsule.rst:99 +#: c-api/capsule.rst:99 msgid "" "Import a pointer to a C object from a capsule attribute in a module. The " "*name* parameter should specify the full name to the attribute, as in " @@ -2366,7 +2335,7 @@ msgid "" msgstr "" # 2c8e61b85e4b4eed867dd02bf2351b34 -#: ../src/Doc/c-api/capsule.rst:106 +#: c-api/capsule.rst:106 msgid "" "Return the capsule's internal *pointer* on success. On failure, set an " "exception and return *NULL*. However, if :c:func:`PyCapsule_Import` failed " @@ -2374,7 +2343,7 @@ msgid "" msgstr "" # 31bd9ff06fa945d9b4fa013589865f5d -#: ../src/Doc/c-api/capsule.rst:112 +#: c-api/capsule.rst:112 msgid "" "Determines whether or not *capsule* is a valid capsule. A valid capsule is " "non-*NULL*, passes :c:func:`PyCapsule_CheckExact`, has a non-*NULL* pointer " @@ -2384,7 +2353,7 @@ msgid "" msgstr "" # 8f736c6076ff49a09724def81dcdaac0 -#: ../src/Doc/c-api/capsule.rst:118 +#: c-api/capsule.rst:118 msgid "" "In other words, if :c:func:`PyCapsule_IsValid` returns a true value, calls " "to any of the accessors (any function starting with :c:func:`PyCapsule_Get`) " @@ -2392,14 +2361,14 @@ msgid "" msgstr "" # 76370b0d58394cf9a7a01027866e3a83 -#: ../src/Doc/c-api/capsule.rst:122 +#: c-api/capsule.rst:122 msgid "" "Return a nonzero value if the object is valid and matches the name passed " "in. Return 0 otherwise. This function will not fail." msgstr "" # 54e1d944dedf41fea0a40d6e19aaafc2 -#: ../src/Doc/c-api/capsule.rst:127 +#: c-api/capsule.rst:127 msgid "Set the context pointer inside *capsule* to *context*." msgstr "" @@ -2407,18 +2376,18 @@ msgstr "" # 7b5a6d00ead14c38b5c08f91ffaaf348 # 27c949909a8d46c5937cfcd31503c74c # 20e340a98ca3498ca63971955d141506 -#: ../src/Doc/c-api/capsule.rst:129 ../src/Doc/c-api/capsule.rst:135 -#: ../src/Doc/c-api/capsule.rst:143 ../src/Doc/c-api/capsule.rst:150 +#: c-api/capsule.rst:129 c-api/capsule.rst:135 c-api/capsule.rst:143 +#: c-api/capsule.rst:150 msgid "Return 0 on success. Return nonzero and set an exception on failure." msgstr "" # d3586d86c8e843c88b9b09af52852140 -#: ../src/Doc/c-api/capsule.rst:133 +#: c-api/capsule.rst:133 msgid "Set the destructor inside *capsule* to *destructor*." msgstr "" # b1e07fd60d3b499ca1fd6975a3137fec -#: ../src/Doc/c-api/capsule.rst:139 +#: c-api/capsule.rst:139 msgid "" "Set the name inside *capsule* to *name*. If non-*NULL*, the name must " "outlive the capsule. If the previous *name* stored in the capsule was not " @@ -2426,17 +2395,17 @@ msgid "" msgstr "" # 255e6f798d1941f29d2540b03d0c151a -#: ../src/Doc/c-api/capsule.rst:147 +#: c-api/capsule.rst:147 msgid "" "Set the void pointer inside *capsule* to *pointer*. The pointer may not be " "*NULL*." msgstr "" -#: ../src/Doc/c-api/cell.rst:6 +#: c-api/cell.rst:6 msgid "Cell Objects" msgstr "Objets Cellules" -#: ../src/Doc/c-api/cell.rst:8 +#: c-api/cell.rst:8 msgid "" "\"Cell\" objects are used to implement variables referenced by multiple " "scopes. For each such variable, a cell object is created to store the value; " @@ -2459,41 +2428,41 @@ msgstr "" "objets cellules ne soit utilisés ailleurs." # 07ddbeee521a471c902f2d8c88c1039a -#: ../src/Doc/c-api/cell.rst:20 +#: c-api/cell.rst:20 msgid "The C structure used for cell objects." msgstr "" # c72b506402a64a3aa2e9c8ebe4eae08b -#: ../src/Doc/c-api/cell.rst:25 +#: c-api/cell.rst:25 msgid "The type object corresponding to cell objects." msgstr "" # 4e64ab7810bc4498b3a872bfd84f463c -#: ../src/Doc/c-api/cell.rst:30 +#: c-api/cell.rst:30 msgid "Return true if *ob* is a cell object; *ob* must not be *NULL*." msgstr "" # 15c2c44facc94addaf240ba9b066b797 -#: ../src/Doc/c-api/cell.rst:35 +#: c-api/cell.rst:35 msgid "" "Create and return a new cell object containing the value *ob*. The parameter " "may be *NULL*." msgstr "" # 5e2cdd4e80fc4da395b1f200fb5728dd -#: ../src/Doc/c-api/cell.rst:41 +#: c-api/cell.rst:41 msgid "Return the contents of the cell *cell*." msgstr "" # 354010c659fd4c16a92c45f761483fb8 -#: ../src/Doc/c-api/cell.rst:46 +#: c-api/cell.rst:46 msgid "" "Return the contents of the cell *cell*, but without checking that *cell* is " "non-*NULL* and a cell object." msgstr "" # ae7945d8ddfc4581874b8219ad60b256 -#: ../src/Doc/c-api/cell.rst:52 +#: c-api/cell.rst:52 msgid "" "Set the contents of the cell object *cell* to *value*. This releases the " "reference to any current content of the cell. *value* may be *NULL*. *cell* " @@ -2502,7 +2471,7 @@ msgid "" msgstr "" # a347a07614fc4bc8a287c8166fa804bd -#: ../src/Doc/c-api/cell.rst:60 +#: c-api/cell.rst:60 msgid "" "Sets the value of the cell object *cell* to *value*. No reference counts " "are adjusted, and no checks are made for safety; *cell* must be non-*NULL* " @@ -2510,12 +2479,12 @@ msgid "" msgstr "" # 2ecdfd242dc14d35955965ba20b1dd7a -#: ../src/Doc/c-api/class.rst:6 +#: c-api/class.rst:6 msgid "Class and Instance Objects" msgstr "" # 4f3f8bde76b643df9757ad70e6f84235 -#: ../src/Doc/c-api/class.rst:10 +#: c-api/class.rst:10 msgid "" "Note that the class objects described here represent old-style classes, " "which will go away in Python 3. When creating new types for extension " @@ -2524,19 +2493,19 @@ msgid "" msgstr "" # 1380a9f90de24ba1b570505a86fcda7e -#: ../src/Doc/c-api/class.rst:17 +#: c-api/class.rst:17 msgid "The C structure of the objects used to describe built-in classes." msgstr "" # 154f895466a7425ba9efb7051c5cc22c -#: ../src/Doc/c-api/class.rst:24 +#: c-api/class.rst:24 msgid "" "This is the type object for class objects; it is the same object as ``types." "ClassType`` in the Python layer." msgstr "" # 41dfd8ad671842dc8dc4a130f73fcb3a -#: ../src/Doc/c-api/class.rst:30 +#: c-api/class.rst:30 msgid "" "Return true if the object *o* is a class object, including instances of " "types derived from the standard class object. Return false in all other " @@ -2544,29 +2513,29 @@ msgid "" msgstr "" # 9b74721aa78d46208d50bab7387f6989 -#: ../src/Doc/c-api/class.rst:36 +#: c-api/class.rst:36 msgid "" "Return true if *klass* is a subclass of *base*. Return false in all other " "cases." msgstr "" # d0c1a8a6d36b44d981496545e681fe0e -#: ../src/Doc/c-api/class.rst:41 +#: c-api/class.rst:41 msgid "There are very few functions specific to instance objects." msgstr "" # 0dcbaaba00f04676bb2329ca3cec0f05 -#: ../src/Doc/c-api/class.rst:46 +#: c-api/class.rst:46 msgid "Type object for class instances." msgstr "" # f2f362de3aa44eb2902f3d983d85a2fc -#: ../src/Doc/c-api/class.rst:51 +#: c-api/class.rst:51 msgid "Return true if *obj* is an instance." msgstr "" # b402c8ac2cf048e58a37a73ff0826957 -#: ../src/Doc/c-api/class.rst:56 +#: c-api/class.rst:56 msgid "" "Create a new instance of a specific class. The parameters *arg* and *kw* " "are used as the positional and keyword parameters to the object's " @@ -2574,7 +2543,7 @@ msgid "" msgstr "" # 567ee8a96f094d809757abb2f7151e33 -#: ../src/Doc/c-api/class.rst:62 +#: c-api/class.rst:62 msgid "" "Create a new instance of a specific class without calling its constructor. " "*class* is the class of new object. The *dict* parameter will be used as " @@ -2582,32 +2551,32 @@ msgid "" "for the instance." msgstr "" -#: ../src/Doc/c-api/cobject.rst:6 +#: c-api/cobject.rst:6 #, fuzzy msgid "CObjects" msgstr "Objets Cellules" # 37423fd089584c43bf940770ba26ece4 -#: ../src/Doc/c-api/cobject.rst:13 +#: c-api/cobject.rst:13 msgid "" "The CObject API is deprecated as of Python 2.7. Please switch to the new :" "ref:`capsules` API." msgstr "" # 5e82b545083d4b038e17e2246854a332 -#: ../src/Doc/c-api/cobject.rst:28 +#: c-api/cobject.rst:28 msgid "Return true if its argument is a :c:type:`PyCObject`." msgstr "" # 815725bbd1d8400e80927e64ee76e097 -#: ../src/Doc/c-api/cobject.rst:33 +#: c-api/cobject.rst:33 msgid "" "Create a :c:type:`PyCObject` from the ``void *`` *cobj*. The *destr* " "function will be called when the object is reclaimed, unless it is *NULL*." msgstr "" # c2d641cc3a2b4a24a6a0c4ecfc24d92d -#: ../src/Doc/c-api/cobject.rst:39 +#: c-api/cobject.rst:39 msgid "" "Create a :c:type:`PyCObject` from the :c:type:`void \\*` *cobj*. The " "*destr* function will be called when the object is reclaimed. The *desc* " @@ -2615,31 +2584,31 @@ msgid "" msgstr "" # a514fbb3d7ad4c8a8b566bd5b095bb12 -#: ../src/Doc/c-api/cobject.rst:46 +#: c-api/cobject.rst:46 msgid "" "Return the object :c:type:`void \\*` that the :c:type:`PyCObject` *self* was " "created with." msgstr "" # abd1163cd525446fb222be9d4613c6ea -#: ../src/Doc/c-api/cobject.rst:52 +#: c-api/cobject.rst:52 msgid "" "Return the description :c:type:`void \\*` that the :c:type:`PyCObject` " "*self* was created with." msgstr "" # 103d4cc4b5c9431f8ccb2756ef4412f3 -#: ../src/Doc/c-api/cobject.rst:58 +#: c-api/cobject.rst:58 msgid "" "Set the void pointer inside *self* to *cobj*. The :c:type:`PyCObject` must " "not have an associated destructor. Return true on success, false on failure." msgstr "" -#: ../src/Doc/c-api/code.rst:6 +#: c-api/code.rst:6 msgid "Code Objects" msgstr "Objets Code" -#: ../src/Doc/c-api/code.rst:14 +#: c-api/code.rst:14 msgid "" "Code objects are a low-level detail of the CPython implementation. Each one " "represents a chunk of executable code that hasn't yet been bound into a " @@ -2650,31 +2619,32 @@ msgstr "" "été lié dans une fonction." # 2a98249c63414e0b8daeb9c7a8aca236 -#: ../src/Doc/c-api/code.rst:20 +#: c-api/code.rst:20 msgid "" "The C structure of the objects used to describe code objects. The fields of " "this type are subject to change at any time." msgstr "" # d910c828c32a46b79973f1fa6fc79127 -#: ../src/Doc/c-api/code.rst:26 +#: c-api/code.rst:26 msgid "" "This is an instance of :c:type:`PyTypeObject` representing the Python :class:" "`code` type." msgstr "" -# c05fbf2327ce4860aa347d247426faec -#: ../src/Doc/c-api/code.rst:32 -msgid "Return true if *co* is a :class:`code` object" -msgstr "" +# 6393c2028a1e4ac4b538fb7a6b7b208f +#: c-api/code.rst:32 +#, fuzzy +msgid "Return true if *co* is a :class:`code` object." +msgstr "Convertit un nombre flottant Python vers un type C :ctype:`double`." # 34abe8c3afa04bbe9e78b7fd0d4fa167 -#: ../src/Doc/c-api/code.rst:36 +#: c-api/code.rst:36 msgid "Return the number of free variables in *co*." msgstr "" # 4d9eeff0df2c4e3fb3b9e8844d0f268d -#: ../src/Doc/c-api/code.rst:40 +#: c-api/code.rst:40 msgid "" "Return a new code object. If you need a dummy code object to create a " "frame, use :c:func:`PyCode_NewEmpty` instead. Calling :c:func:`PyCode_New` " @@ -2683,7 +2653,7 @@ msgid "" msgstr "" # 75db0ead55444f59bf5c7658ad375f1a -#: ../src/Doc/c-api/code.rst:48 +#: c-api/code.rst:48 msgid "" "Return a new empty code object with the specified filename, function name, " "and first line number. It is illegal to :keyword:`exec` or :func:`eval` the " @@ -2691,36 +2661,36 @@ msgid "" msgstr "" # 8115fef901f84b3b98e41fcd9d79c7bf -#: ../src/Doc/c-api/codec.rst:4 +#: c-api/codec.rst:4 msgid "Codec registry and support functions" msgstr "" # a37469388ad34a6d8f2283ec2e4e9e92 -#: ../src/Doc/c-api/codec.rst:8 +#: c-api/codec.rst:8 msgid "Register a new codec search function." msgstr "" # 9cf47b03e9fb4d6ba0bd1b00db7271cb -#: ../src/Doc/c-api/codec.rst:10 +#: c-api/codec.rst:10 msgid "" "As side effect, this tries to load the :mod:`encodings` package, if not yet " "done, to make sure that it is always first in the list of search functions." msgstr "" # 6138120fd7584d69905a425547027a41 -#: ../src/Doc/c-api/codec.rst:15 +#: c-api/codec.rst:15 msgid "" "Return ``1`` or ``0`` depending on whether there is a registered codec for " "the given *encoding*." msgstr "" # 2fd619ca556342a88416c79ee8a145d3 -#: ../src/Doc/c-api/codec.rst:20 +#: c-api/codec.rst:20 msgid "Generic codec based encoding API." msgstr "" # 5c95af35a0ee4508b59a2aeded63a1b5 -#: ../src/Doc/c-api/codec.rst:22 +#: c-api/codec.rst:22 msgid "" "*object* is passed through the encoder function found for the given " "*encoding* using the error handling method defined by *errors*. *errors* " @@ -2729,12 +2699,12 @@ msgid "" msgstr "" # 850f3b74ca114b0584cdf27c1c2aa983 -#: ../src/Doc/c-api/codec.rst:29 +#: c-api/codec.rst:29 msgid "Generic codec based decoding API." msgstr "" # 8bec93e81e4a4cdd886749cbf1788f2a -#: ../src/Doc/c-api/codec.rst:31 +#: c-api/codec.rst:31 msgid "" "*object* is passed through the decoder function found for the given " "*encoding* using the error handling method defined by *errors*. *errors* " @@ -2743,12 +2713,12 @@ msgid "" msgstr "" # 315c5e3faa13459bbdf50eb7d1123b3d -#: ../src/Doc/c-api/codec.rst:38 +#: c-api/codec.rst:38 msgid "Codec lookup API" msgstr "" # c1fd47f831c24ed489493fc8d3de091b -#: ../src/Doc/c-api/codec.rst:40 +#: c-api/codec.rst:40 msgid "" "In the following functions, the *encoding* string is looked up converted to " "all lower-case characters, which makes encodings looked up through this " @@ -2757,48 +2727,48 @@ msgid "" msgstr "" # 7dc357235e224247b1f8fb2305c8604e -#: ../src/Doc/c-api/codec.rst:47 +#: c-api/codec.rst:47 msgid "Get an encoder function for the given *encoding*." msgstr "" # 81962332e8fb42579a75f3c27526b563 -#: ../src/Doc/c-api/codec.rst:51 +#: c-api/codec.rst:51 msgid "Get a decoder function for the given *encoding*." msgstr "" # 8b4487ca9e10485d9dd501c3769f298d -#: ../src/Doc/c-api/codec.rst:55 +#: c-api/codec.rst:55 msgid "" "Get an :class:`~codecs.IncrementalEncoder` object for the given *encoding*." msgstr "" # ab082947e89a4b42ad13ad21de175d7a -#: ../src/Doc/c-api/codec.rst:59 +#: c-api/codec.rst:59 msgid "" "Get an :class:`~codecs.IncrementalDecoder` object for the given *encoding*." msgstr "" # bd43a746545f4f21978029aafddc1143 -#: ../src/Doc/c-api/codec.rst:63 +#: c-api/codec.rst:63 msgid "" "Get a :class:`~codecs.StreamReader` factory function for the given " "*encoding*." msgstr "" # 526e189189c944e1aec0e60804f58466 -#: ../src/Doc/c-api/codec.rst:67 +#: c-api/codec.rst:67 msgid "" "Get a :class:`~codecs.StreamWriter` factory function for the given " "*encoding*." msgstr "" # f26dcd8310564d6ab16be5a4d1962a52 -#: ../src/Doc/c-api/codec.rst:71 +#: c-api/codec.rst:71 msgid "Registry API for Unicode encoding error handlers" msgstr "" # f31578102f0942018e73d9ee2323cb68 -#: ../src/Doc/c-api/codec.rst:75 +#: c-api/codec.rst:75 msgid "" "Register the error handling callback function *error* under the given " "*name*. This callback function will be called by a codec when it encounters " @@ -2807,7 +2777,7 @@ msgid "" msgstr "" # 7c4bc5b6bc0a47d287808169df6cc410 -#: ../src/Doc/c-api/codec.rst:80 +#: c-api/codec.rst:80 msgid "" "The callback gets a single argument, an instance of :exc:" "`UnicodeEncodeError`, :exc:`UnicodeDecodeError` or :exc:" @@ -2821,12 +2791,12 @@ msgid "" msgstr "" # 85b3bf18566d40ccba89bda51eb932d5 -#: ../src/Doc/c-api/codec.rst:90 +#: c-api/codec.rst:90 msgid "Return ``0`` on success, ``-1`` on error." msgstr "" # c291ba04300d4fbc8deb044b055554b0 -#: ../src/Doc/c-api/codec.rst:94 +#: c-api/codec.rst:94 msgid "" "Lookup the error handling callback function registered under *name*. As a " "special case *NULL* can be passed, in which case the error handling callback " @@ -2834,37 +2804,37 @@ msgid "" msgstr "" # ab45ce7a3e6b43c88efe5923eb2a1728 -#: ../src/Doc/c-api/codec.rst:100 +#: c-api/codec.rst:100 msgid "Raise *exc* as an exception." msgstr "" # 13d774675c1d46feb753ae2bad4ca0c0 -#: ../src/Doc/c-api/codec.rst:104 +#: c-api/codec.rst:104 msgid "Ignore the unicode error, skipping the faulty input." msgstr "" # 96615de066324c0587bf2f8a4716def0 -#: ../src/Doc/c-api/codec.rst:108 +#: c-api/codec.rst:108 msgid "Replace the unicode encode error with ``?`` or ``U+FFFD``." msgstr "" # bf4a7b38c7ba414aa009598b060273ba -#: ../src/Doc/c-api/codec.rst:112 +#: c-api/codec.rst:112 msgid "Replace the unicode encode error with XML character references." msgstr "" # 5e538d3f4fcb47ffb8a81c1bb84a2955 -#: ../src/Doc/c-api/codec.rst:116 +#: c-api/codec.rst:116 msgid "" "Replace the unicode encode error with backslash escapes (``\\x``, ``\\u`` " "and ``\\U``)." msgstr "" -#: ../src/Doc/c-api/complex.rst:6 +#: c-api/complex.rst:6 msgid "Complex Number Objects" msgstr "Objets Nombres Complexes" -#: ../src/Doc/c-api/complex.rst:10 +#: c-api/complex.rst:10 msgid "" "Python's complex number objects are implemented as two distinct types when " "viewed from the C API: one is the Python object exposed to Python programs, " @@ -2877,11 +2847,11 @@ msgstr "" "représente la valeur complexe courante. L'API fournit des fonctions pour " "travailler avec ces deux représentations." -#: ../src/Doc/c-api/complex.rst:17 +#: c-api/complex.rst:17 msgid "Complex Numbers as C Structures" msgstr "Nombres complexes en tant que structures C" -#: ../src/Doc/c-api/complex.rst:19 +#: c-api/complex.rst:19 msgid "" "Note that the functions which accept these structures as parameters and " "return them as results do so *by value* rather than dereferencing them " @@ -2892,7 +2862,7 @@ msgstr "" "référencer en utilisant des pointeurs. Cela est constant dans toute l'API." # 0fd63e0f6f144bdcb85145fe70256dc0 -#: ../src/Doc/c-api/complex.rst:26 +#: c-api/complex.rst:26 msgid "" "The C structure which corresponds to the value portion of a Python complex " "number object. Most of the functions for dealing with complex number " @@ -2900,7 +2870,7 @@ msgid "" "appropriate. It is defined as::" msgstr "" -#: ../src/Doc/c-api/complex.rst:39 +#: c-api/complex.rst:39 #, fuzzy msgid "" "Return the sum of two complex numbers, using the C :c:type:`Py_complex` " @@ -2908,7 +2878,7 @@ msgid "" msgstr "" "Convertit un nombre complexe Python vers une structure C :ctype:`Py_complex`." -#: ../src/Doc/c-api/complex.rst:45 +#: c-api/complex.rst:45 #, fuzzy msgid "" "Return the difference between two complex numbers, using the C :c:type:" @@ -2916,7 +2886,7 @@ msgid "" msgstr "" "Convertit un nombre complexe Python vers une structure C :ctype:`Py_complex`." -#: ../src/Doc/c-api/complex.rst:51 +#: c-api/complex.rst:51 #, fuzzy msgid "" "Return the negation of the complex number *complex*, using the C :c:type:" @@ -2924,7 +2894,7 @@ msgid "" msgstr "" "Convertit un nombre complexe Python vers une structure C :ctype:`Py_complex`." -#: ../src/Doc/c-api/complex.rst:57 +#: c-api/complex.rst:57 #, fuzzy msgid "" "Return the product of two complex numbers, using the C :c:type:`Py_complex` " @@ -2932,7 +2902,7 @@ msgid "" msgstr "" "Convertit un nombre complexe Python vers une structure C :ctype:`Py_complex`." -#: ../src/Doc/c-api/complex.rst:63 +#: c-api/complex.rst:63 #, fuzzy msgid "" "Return the quotient of two complex numbers, using the C :c:type:`Py_complex` " @@ -2941,58 +2911,64 @@ msgstr "" "Convertit un nombre complexe Python vers une structure C :ctype:`Py_complex`." # 791a1ea49cc845379608d4855f98de35 -#: ../src/Doc/c-api/complex.rst:66 +#: c-api/complex.rst:66 msgid "" "If *divisor* is null, this method returns zero and sets :c:data:`errno` to :" "c:data:`EDOM`." msgstr "" # 0871c6f5eb7c4403b173f088b5c46b0b -#: ../src/Doc/c-api/complex.rst:72 +#: c-api/complex.rst:72 msgid "" "Return the exponentiation of *num* by *exp*, using the C :c:type:" "`Py_complex` representation." msgstr "" # 38192b49591f4bfebbaf7ad4e97075f3 -#: ../src/Doc/c-api/complex.rst:75 +#: c-api/complex.rst:75 msgid "" "If *num* is null and *exp* is not a positive real number, this method " "returns zero and sets :c:data:`errno` to :c:data:`EDOM`." msgstr "" -#: ../src/Doc/c-api/complex.rst:80 +#: c-api/complex.rst:80 msgid "Complex Numbers as Python Objects" msgstr "Nombres complexes en tant qu'objets Python" # 8932852f89734a43b7591b37f7cea43a -#: ../src/Doc/c-api/complex.rst:85 +#: c-api/complex.rst:85 msgid "" "This subtype of :c:type:`PyObject` represents a Python complex number object." msgstr "" # 9cc66d4e4cfe438d8bd4c8e6475001e3 -#: ../src/Doc/c-api/complex.rst:90 +#: c-api/complex.rst:90 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python complex number " "type. It is the same object as ``complex`` and ``types.ComplexType``." msgstr "" # dfd4b6c21f2c40d9accafacd0f548331 -#: ../src/Doc/c-api/complex.rst:96 +#: c-api/complex.rst:96 msgid "" "Return true if its argument is a :c:type:`PyComplexObject` or a subtype of :" "c:type:`PyComplexObject`." msgstr "" +#: c-api/complex.rst:99 c-api/dict.rst:32 c-api/file.rst:33 c-api/float.rst:29 +#: c-api/int.rst:29 c-api/list.rst:27 c-api/long.rst:29 c-api/module.rst:25 +#: c-api/string.rst:38 c-api/tuple.rst:29 c-api/unicode.rst:58 +msgid "Allowed subtypes to be accepted." +msgstr "" + # 84aeb7d279b64cd9865564468927c718 -#: ../src/Doc/c-api/complex.rst:105 +#: c-api/complex.rst:105 msgid "" "Return true if its argument is a :c:type:`PyComplexObject`, but not a " "subtype of :c:type:`PyComplexObject`." msgstr "" -#: ../src/Doc/c-api/complex.rst:113 +#: c-api/complex.rst:113 #, fuzzy msgid "" "Create a new Python complex number object from a C :c:type:`Py_complex` " @@ -3001,33 +2977,40 @@ msgstr "" "Convertit un nombre complexe Python vers une structure C :ctype:`Py_complex`." # 4df2e33ea24c473d9fa99382dcfe356b -#: ../src/Doc/c-api/complex.rst:118 +#: c-api/complex.rst:118 msgid "Return a new :c:type:`PyComplexObject` object from *real* and *imag*." msgstr "" # 6393c2028a1e4ac4b538fb7a6b7b208f -#: ../src/Doc/c-api/complex.rst:123 +#: c-api/complex.rst:123 #, fuzzy msgid "Return the real part of *op* as a C :c:type:`double`." msgstr "Convertit un nombre flottant Python vers un type C :ctype:`double`." -#: ../src/Doc/c-api/complex.rst:128 +#: c-api/complex.rst:128 #, fuzzy msgid "Return the imaginary part of *op* as a C :c:type:`double`." msgstr "Convertit un nombre flottant Python vers un type C :ctype:`double`." # 72d2a2b35261408c80182ee55122f9be -#: ../src/Doc/c-api/complex.rst:133 +#: c-api/complex.rst:133 msgid "" "Return the :c:type:`Py_complex` value of the complex number *op*. Upon " "failure, this method returns ``-1.0`` as a real value." msgstr "" -#: ../src/Doc/c-api/concrete.rst:8 +#: c-api/complex.rst:136 +msgid "" +"If *op* is not a Python complex number object but has a :meth:`__complex__` " +"method, this method will first be called to convert *op* to a Python complex " +"number object." +msgstr "" + +#: c-api/concrete.rst:8 msgid "Concrete Objects Layer" msgstr "Couche des Objets Concrets" -#: ../src/Doc/c-api/concrete.rst:10 +#: c-api/concrete.rst:10 #, fuzzy msgid "" "The functions in this chapter are specific to certain Python object types. " @@ -3045,7 +3028,7 @@ msgstr "" "`PyDict_Check`. Ce chapitre est structuré comme un \"arbre des familles\" " "des types d'objets Python." -#: ../src/Doc/c-api/concrete.rst:19 +#: c-api/concrete.rst:19 msgid "" "While the functions described in this chapter carefully check the type of " "the objects which are passed in, many of them do not check for *NULL* being " @@ -3058,25 +3041,25 @@ msgstr "" "passé peut provoquer des violations d'accès à la mémoire et ainsi terminer " "immédiatement l'interpréteur." -#: ../src/Doc/c-api/concrete.rst:28 +#: c-api/concrete.rst:28 msgid "Fundamental Objects" msgstr "Objets fondamentaux" -#: ../src/Doc/c-api/concrete.rst:30 +#: c-api/concrete.rst:30 msgid "" "This section describes Python type objects and the singleton object ``None``." msgstr "" "Cette section décrit les objets de type Python et l'objet singleton ``None``." -#: ../src/Doc/c-api/concrete.rst:41 +#: c-api/concrete.rst:41 msgid "Numeric Objects" msgstr "Objets numériques" -#: ../src/Doc/c-api/concrete.rst:57 +#: c-api/concrete.rst:57 msgid "Sequence Objects" msgstr "Objets séquences" -#: ../src/Doc/c-api/concrete.rst:61 +#: c-api/concrete.rst:61 msgid "" "Generic operations on sequence objects were discussed in the previous " "chapter; this section deals with the specific kinds of sequence objects that " @@ -3086,26 +3069,26 @@ msgstr "" "chapitre précédent. Cette section traite des genres spécifiques d'objets " "séquences qui sont intrinsèques au langage Python." -#: ../src/Doc/c-api/concrete.rst:78 +#: c-api/concrete.rst:78 msgid "Mapping Objects" msgstr "Objets association" -#: ../src/Doc/c-api/concrete.rst:90 +#: c-api/concrete.rst:90 msgid "Other Objects" msgstr "Autres Objets" -#: ../src/Doc/c-api/conversion.rst:6 +#: c-api/conversion.rst:6 msgid "String conversion and formatting" msgstr "Conversion et formatage de chaînes" -#: ../src/Doc/c-api/conversion.rst:8 +#: c-api/conversion.rst:8 msgid "Functions for number conversion and formatted string output." msgstr "" "Fonctions de conversion pour les nombres et pour la sortie des chaînes " "formattées." # 595bd9c0422746d39370be853f9cf5ec -#: ../src/Doc/c-api/conversion.rst:13 +#: c-api/conversion.rst:13 msgid "" "Output not more than *size* bytes to *str* according to the format string " "*format* and the extra arguments. See the Unix man page :manpage:" @@ -3113,7 +3096,7 @@ msgid "" msgstr "" # b016633066cd4ffdbf30b7e52f094224 -#: ../src/Doc/c-api/conversion.rst:19 +#: c-api/conversion.rst:19 msgid "" "Output not more than *size* bytes to *str* according to the format string " "*format* and the variable argument list *va*. Unix man page :manpage:" @@ -3121,7 +3104,7 @@ msgid "" msgstr "" # 2e3f7d1290464cc0918cf4c92fcf8308 -#: ../src/Doc/c-api/conversion.rst:23 +#: c-api/conversion.rst:23 msgid "" ":c:func:`PyOS_snprintf` and :c:func:`PyOS_vsnprintf` wrap the Standard C " "library functions :c:func:`snprintf` and :c:func:`vsnprintf`. Their purpose " @@ -3130,7 +3113,7 @@ msgid "" msgstr "" # 85ce4f93a6944ce4a6c94a8b6ade50c9 -#: ../src/Doc/c-api/conversion.rst:28 +#: c-api/conversion.rst:28 msgid "" "The wrappers ensure that *str*[*size*-1] is always ``'\\0'`` upon return. " "They never write more than *size* bytes (including the trailing ``'\\0'`` " @@ -3139,47 +3122,47 @@ msgid "" msgstr "" # 1ceb1457801344968c51bdbb79c72de6 -#: ../src/Doc/c-api/conversion.rst:33 +#: c-api/conversion.rst:33 msgid "" "If the platform doesn't have :c:func:`vsnprintf` and the buffer size needed " "to avoid truncation exceeds *size* by more than 512 bytes, Python aborts " "with a *Py_FatalError*." msgstr "" -#: ../src/Doc/c-api/conversion.rst:37 +#: c-api/conversion.rst:37 msgid "" "The return value (*rv*) for these functions should be interpreted as follows:" msgstr "" -#: ../src/Doc/c-api/conversion.rst:39 +#: c-api/conversion.rst:39 msgid "" "When ``0 <= rv < size``, the output conversion was successful and *rv* " "characters were written to *str* (excluding the trailing ``'\\0'`` byte at " "*str*[*rv*])." msgstr "" -#: ../src/Doc/c-api/conversion.rst:43 +#: c-api/conversion.rst:43 msgid "" "When ``rv >= size``, the output conversion was truncated and a buffer with " "``rv + 1`` bytes would have been needed to succeed. *str*[*size*-1] is " "``'\\0'`` in this case." msgstr "" -#: ../src/Doc/c-api/conversion.rst:47 +#: c-api/conversion.rst:47 msgid "" "When ``rv < 0``, \"something bad happened.\" *str*[*size*-1] is ``'\\0'`` in " "this case too, but the rest of *str* is undefined. The exact cause of the " "error depends on the underlying platform." msgstr "" -#: ../src/Doc/c-api/conversion.rst:51 +#: c-api/conversion.rst:51 msgid "" "The following functions provide locale-independent string to number " "conversions." msgstr "" # 61e884e049bc43829cd6b331079e768d -#: ../src/Doc/c-api/conversion.rst:56 +#: c-api/conversion.rst:56 msgid "" "Convert a string ``s`` to a :c:type:`double`, raising a Python exception on " "failure. The set of accepted strings corresponds to the set of strings " @@ -3189,7 +3172,7 @@ msgid "" msgstr "" # d9351cc26fe04369a4311d2af5526201 -#: ../src/Doc/c-api/conversion.rst:62 +#: c-api/conversion.rst:62 msgid "" "If ``endptr`` is ``NULL``, convert the whole string. Raise ValueError and " "return ``-1.0`` if the string is not a valid representation of a floating-" @@ -3197,7 +3180,7 @@ msgid "" msgstr "" # 468f4d572e3946aba69b22c85cb761ab -#: ../src/Doc/c-api/conversion.rst:66 +#: c-api/conversion.rst:66 msgid "" "If endptr is not ``NULL``, convert as much of the string as possible and set " "``*endptr`` to point to the first unconverted character. If no initial " @@ -3207,7 +3190,7 @@ msgid "" msgstr "" # 9c64148fefe34800bf85ba61c782c1d0 -#: ../src/Doc/c-api/conversion.rst:73 +#: c-api/conversion.rst:73 msgid "" "If ``s`` represents a value that is too large to store in a float (for " "example, ``\"1e500\"`` is such a string on many platforms) then if " @@ -3219,14 +3202,14 @@ msgid "" msgstr "" # 5f7420afd4a142f59bf783970236a896 -#: ../src/Doc/c-api/conversion.rst:81 +#: c-api/conversion.rst:81 msgid "" "If any other error occurs during the conversion (for example an out-of-" "memory error), set the appropriate Python exception and return ``-1.0``." msgstr "" # 465dac88e44f41729a5144d8e9780015 -#: ../src/Doc/c-api/conversion.rst:90 +#: c-api/conversion.rst:90 msgid "" "Convert a string to a :c:type:`double`. This function behaves like the " "Standard C function :c:func:`strtod` does in the C locale. It does this " @@ -3234,7 +3217,7 @@ msgid "" msgstr "" # 0c2c1969c85f4ca58cff5587314198c6 -#: ../src/Doc/c-api/conversion.rst:94 +#: c-api/conversion.rst:94 msgid "" ":c:func:`PyOS_ascii_strtod` should typically be used for reading " "configuration files or other non-user input that should be locale " @@ -3242,12 +3225,16 @@ msgid "" msgstr "" # 6fdac154777b4ad48a2e81a262ad2cfc -#: ../src/Doc/c-api/conversion.rst:97 +#: c-api/conversion.rst:97 msgid "See the Unix man page :manpage:`strtod(2)` for details." msgstr "" +#: c-api/conversion.rst:101 c-api/conversion.rst:164 +msgid "Use :c:func:`PyOS_string_to_double` instead." +msgstr "" + # 533affc65a7e4c57b0f9d2230070d0ec -#: ../src/Doc/c-api/conversion.rst:108 +#: c-api/conversion.rst:108 msgid "" "Convert a :c:type:`double` to a string using the ``'.'`` as the decimal " "separator. *format* is a :c:func:`printf`\\ -style format string specifying " @@ -3256,21 +3243,27 @@ msgid "" msgstr "" # b81588405a6b477ebb63aec166f55ae7 -#: ../src/Doc/c-api/conversion.rst:113 +#: c-api/conversion.rst:113 msgid "" "The return value is a pointer to *buffer* with the converted string or NULL " "if the conversion failed." msgstr "" +#: c-api/conversion.rst:117 +msgid "" +"This function is removed in Python 2.7 and 3.1. Use :func:" +"`PyOS_double_to_string` instead." +msgstr "" + # 0334402cef2541c19dba4e03552eafb9 -#: ../src/Doc/c-api/conversion.rst:124 +#: c-api/conversion.rst:124 msgid "" "Convert a :c:type:`double` *val* to a string using supplied *format_code*, " "*precision*, and *flags*." msgstr "" # 3ddc8ee1a7fb427c8eea3859cd1c0d78 -#: ../src/Doc/c-api/conversion.rst:127 +#: c-api/conversion.rst:127 msgid "" "*format_code* must be one of ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, " "``'G'`` or ``'r'``. For ``'r'``, the supplied *precision* must be 0 and is " @@ -3278,35 +3271,35 @@ msgid "" msgstr "" # 358eaa5326d3439896cb892f5baa85f1 -#: ../src/Doc/c-api/conversion.rst:132 +#: c-api/conversion.rst:132 msgid "" "*flags* can be zero or more of the values *Py_DTSF_SIGN*, " "*Py_DTSF_ADD_DOT_0*, or *Py_DTSF_ALT*, or-ed together:" msgstr "" # b34e889499e64973abc9df259daf15d7 -#: ../src/Doc/c-api/conversion.rst:135 +#: c-api/conversion.rst:135 msgid "" "*Py_DTSF_SIGN* means to always precede the returned string with a sign " "character, even if *val* is non-negative." msgstr "" # 171936608cf142bea2d8dccc39605938 -#: ../src/Doc/c-api/conversion.rst:138 +#: c-api/conversion.rst:138 msgid "" "*Py_DTSF_ADD_DOT_0* means to ensure that the returned string will not look " "like an integer." msgstr "" # 9f9c515261a34fcaa74258c3d9699095 -#: ../src/Doc/c-api/conversion.rst:141 +#: c-api/conversion.rst:141 msgid "" "*Py_DTSF_ALT* means to apply \"alternate\" formatting rules. See the " "documentation for the :c:func:`PyOS_snprintf` ``'#'`` specifier for details." msgstr "" # 8acf15d034714be98850cc733ce33523 -#: ../src/Doc/c-api/conversion.rst:145 +#: c-api/conversion.rst:145 msgid "" "If *ptype* is non-NULL, then the value it points to will be set to one of " "*Py_DTST_FINITE*, *Py_DTST_INFINITE*, or *Py_DTST_NAN*, signifying that " @@ -3314,7 +3307,7 @@ msgid "" msgstr "" # 30c7a5f6c42246e1b8a40c386752f39a -#: ../src/Doc/c-api/conversion.rst:149 +#: c-api/conversion.rst:149 msgid "" "The return value is a pointer to *buffer* with the converted string or " "*NULL* if the conversion failed. The caller is responsible for freeing the " @@ -3322,35 +3315,35 @@ msgid "" msgstr "" # d82fc68dcb1c474cb6427647267922f1 -#: ../src/Doc/c-api/conversion.rst:158 +#: c-api/conversion.rst:158 msgid "Convert a string to a :c:type:`double` in a locale-independent way." msgstr "" # 402cc069e67d4b0eaa8d346f5af0214d -#: ../src/Doc/c-api/conversion.rst:160 +#: c-api/conversion.rst:160 msgid "See the Unix man page :manpage:`atof(2)` for details." msgstr "" # 43a238e65df44639893be166a307c0db -#: ../src/Doc/c-api/conversion.rst:170 +#: c-api/conversion.rst:170 msgid "" "Case insensitive comparison of strings. The function works almost " "identically to :c:func:`strcmp` except that it ignores the case." msgstr "" # 83c9b281ee0a49898221fe39f8964a3a -#: ../src/Doc/c-api/conversion.rst:178 +#: c-api/conversion.rst:178 msgid "" "Case insensitive comparison of strings. The function works almost " "identically to :c:func:`strncmp` except that it ignores the case." msgstr "" -#: ../src/Doc/c-api/datetime.rst:6 +#: c-api/datetime.rst:6 msgid "DateTime Objects" msgstr "Objets DateTime" # ec62f0e76d7b4262b9ab6c64216677e3 -#: ../src/Doc/c-api/datetime.rst:8 +#: c-api/datetime.rst:8 msgid "" "Various date and time objects are supplied by the :mod:`datetime` module. " "Before using any of these functions, the header file :file:`datetime.h` must " @@ -3361,106 +3354,106 @@ msgid "" "the following macros." msgstr "" -#: ../src/Doc/c-api/datetime.rst:16 +#: c-api/datetime.rst:16 msgid "Type-check macros:" msgstr "" # 4aaa99ecb0e14d35b382cc864f6f53b2 -#: ../src/Doc/c-api/datetime.rst:21 +#: c-api/datetime.rst:21 msgid "" "Return true if *ob* is of type :c:data:`PyDateTime_DateType` or a subtype " "of :c:data:`PyDateTime_DateType`. *ob* must not be *NULL*." msgstr "" # e1f918ab4b83489f8670efdf09d01dcb -#: ../src/Doc/c-api/datetime.rst:29 +#: c-api/datetime.rst:29 msgid "" "Return true if *ob* is of type :c:data:`PyDateTime_DateType`. *ob* must not " "be *NULL*." msgstr "" # 2a62f399f9db4dc1accf3294f4e38a25 -#: ../src/Doc/c-api/datetime.rst:37 +#: c-api/datetime.rst:37 msgid "" "Return true if *ob* is of type :c:data:`PyDateTime_DateTimeType` or a " "subtype of :c:data:`PyDateTime_DateTimeType`. *ob* must not be *NULL*." msgstr "" # 42cd720aa1a34caaa5de0c85ed717428 -#: ../src/Doc/c-api/datetime.rst:45 +#: c-api/datetime.rst:45 msgid "" "Return true if *ob* is of type :c:data:`PyDateTime_DateTimeType`. *ob* must " "not be *NULL*." msgstr "" # 25429a020e8b41259b97e39a0185b4d9 -#: ../src/Doc/c-api/datetime.rst:53 +#: c-api/datetime.rst:53 msgid "" "Return true if *ob* is of type :c:data:`PyDateTime_TimeType` or a subtype " "of :c:data:`PyDateTime_TimeType`. *ob* must not be *NULL*." msgstr "" # bdcbb74b0e6243bb82f9e3b380cb76c7 -#: ../src/Doc/c-api/datetime.rst:61 +#: c-api/datetime.rst:61 msgid "" "Return true if *ob* is of type :c:data:`PyDateTime_TimeType`. *ob* must not " "be *NULL*." msgstr "" # d36dc026d33b483db5e5e567e217a7f1 -#: ../src/Doc/c-api/datetime.rst:69 +#: c-api/datetime.rst:69 msgid "" "Return true if *ob* is of type :c:data:`PyDateTime_DeltaType` or a subtype " "of :c:data:`PyDateTime_DeltaType`. *ob* must not be *NULL*." msgstr "" # dccaccef51234ac0934979917ea78da6 -#: ../src/Doc/c-api/datetime.rst:77 +#: c-api/datetime.rst:77 msgid "" "Return true if *ob* is of type :c:data:`PyDateTime_DeltaType`. *ob* must not " "be *NULL*." msgstr "" # 9cc38cc4cda4418298a3365d519adf7d -#: ../src/Doc/c-api/datetime.rst:85 +#: c-api/datetime.rst:85 msgid "" "Return true if *ob* is of type :c:data:`PyDateTime_TZInfoType` or a subtype " "of :c:data:`PyDateTime_TZInfoType`. *ob* must not be *NULL*." msgstr "" # f4f5fcfe2e494f7fa0b0a21ec764952c -#: ../src/Doc/c-api/datetime.rst:93 +#: c-api/datetime.rst:93 msgid "" "Return true if *ob* is of type :c:data:`PyDateTime_TZInfoType`. *ob* must " "not be *NULL*." msgstr "" -#: ../src/Doc/c-api/datetime.rst:98 +#: c-api/datetime.rst:98 msgid "Macros to create objects:" msgstr "" # be080a84386843d5a339f35c7319bcd8 -#: ../src/Doc/c-api/datetime.rst:103 +#: c-api/datetime.rst:103 msgid "" "Return a ``datetime.date`` object with the specified year, month and day." msgstr "" # dadd495ed53948d7bb792c4560b8b7df -#: ../src/Doc/c-api/datetime.rst:110 +#: c-api/datetime.rst:110 msgid "" "Return a ``datetime.datetime`` object with the specified year, month, day, " "hour, minute, second and microsecond." msgstr "" # 32ae5339f84d453bb3024aa335c4ddbb -#: ../src/Doc/c-api/datetime.rst:118 +#: c-api/datetime.rst:118 msgid "" "Return a ``datetime.time`` object with the specified hour, minute, second " "and microsecond." msgstr "" # 7b784a13a1b84a8e96eb7c10d1be90c1 -#: ../src/Doc/c-api/datetime.rst:126 +#: c-api/datetime.rst:126 msgid "" "Return a ``datetime.timedelta`` object representing the given number of " "days, seconds and microseconds. Normalization is performed so that the " @@ -3469,7 +3462,7 @@ msgid "" msgstr "" # 59b6e8fa63c040ac9f085e4426067f5b -#: ../src/Doc/c-api/datetime.rst:133 +#: c-api/datetime.rst:133 msgid "" "Macros to extract fields from date objects. The argument must be an " "instance of :c:data:`PyDateTime_Date`, including subclasses (such as :c:data:" @@ -3478,22 +3471,22 @@ msgid "" msgstr "" # d88547a849274ff48fd3a9ae125993c6 -#: ../src/Doc/c-api/datetime.rst:141 +#: c-api/datetime.rst:141 msgid "Return the year, as a positive int." msgstr "" # 2b57f3b42e6044d9bf089c4cc73d96fc -#: ../src/Doc/c-api/datetime.rst:148 +#: c-api/datetime.rst:148 msgid "Return the month, as an int from 1 through 12." msgstr "" # b627d8f737af4c13a98b0c0523308c75 -#: ../src/Doc/c-api/datetime.rst:155 +#: c-api/datetime.rst:155 msgid "Return the day, as an int from 1 through 31." msgstr "" # 22d54063816e4c02a8551da7591a6515 -#: ../src/Doc/c-api/datetime.rst:159 +#: c-api/datetime.rst:159 msgid "" "Macros to extract fields from datetime objects. The argument must be an " "instance of :c:data:`PyDateTime_DateTime`, including subclasses. The " @@ -3502,115 +3495,115 @@ msgstr "" # 0ea7af06f9674f8d921222243d61b240 # 8f59091310a943e5a315ad8ef6356e27 -#: ../src/Doc/c-api/datetime.rst:166 ../src/Doc/c-api/datetime.rst:198 +#: c-api/datetime.rst:166 c-api/datetime.rst:198 msgid "Return the hour, as an int from 0 through 23." msgstr "" # bf84ce3623ef4060820d940c47555ea5 # 4a4b84aed0394829817581b117a08282 -#: ../src/Doc/c-api/datetime.rst:173 ../src/Doc/c-api/datetime.rst:205 +#: c-api/datetime.rst:173 c-api/datetime.rst:205 msgid "Return the minute, as an int from 0 through 59." msgstr "" # 557c7196373d49b9be1e4ce870776293 # 646e77103c77462badba7c1aed012be7 -#: ../src/Doc/c-api/datetime.rst:180 ../src/Doc/c-api/datetime.rst:212 +#: c-api/datetime.rst:180 c-api/datetime.rst:212 msgid "Return the second, as an int from 0 through 59." msgstr "" # cf3bafda682444c3a7382058c8109078 # 9956d96662854ce58083b88fb81141c4 -#: ../src/Doc/c-api/datetime.rst:187 ../src/Doc/c-api/datetime.rst:219 +#: c-api/datetime.rst:187 c-api/datetime.rst:219 msgid "Return the microsecond, as an int from 0 through 999999." msgstr "" # 093af03a28b34d75b05a42a798be9d90 -#: ../src/Doc/c-api/datetime.rst:191 +#: c-api/datetime.rst:191 msgid "" "Macros to extract fields from time objects. The argument must be an " "instance of :c:data:`PyDateTime_Time`, including subclasses. The argument " "must not be *NULL*, and the type is not checked:" msgstr "" -#: ../src/Doc/c-api/datetime.rst:223 +#: c-api/datetime.rst:223 msgid "Macros for the convenience of modules implementing the DB API:" msgstr "" # b3bb49260c8142eabd7f648edb10b6ac -#: ../src/Doc/c-api/datetime.rst:228 +#: c-api/datetime.rst:228 msgid "" "Create and return a new ``datetime.datetime`` object given an argument tuple " "suitable for passing to ``datetime.datetime.fromtimestamp()``." msgstr "" # 7cd8683ea01149269a7a308fc6099472 -#: ../src/Doc/c-api/datetime.rst:236 +#: c-api/datetime.rst:236 msgid "" "Create and return a new ``datetime.date`` object given an argument tuple " "suitable for passing to ``datetime.date.fromtimestamp()``." msgstr "" -#: ../src/Doc/c-api/descriptor.rst:6 +#: c-api/descriptor.rst:6 msgid "Descriptor Objects" msgstr "" -#: ../src/Doc/c-api/descriptor.rst:8 +#: c-api/descriptor.rst:8 msgid "" "\"Descriptors\" are objects that describe some attribute of an object. They " "are found in the dictionary of type objects." msgstr "" # 64d2c5e7cd314c798d7a8b59cbd2d372 -#: ../src/Doc/c-api/descriptor.rst:14 +#: c-api/descriptor.rst:14 msgid "The type object for the built-in descriptor types." msgstr "" # ca39b6cbee1449cab1894392c82623a8 -#: ../src/Doc/c-api/descriptor.rst:46 +#: c-api/descriptor.rst:46 msgid "" "Return true if the descriptor objects *descr* describes a data attribute, or " "false if it describes a method. *descr* must be a descriptor object; there " "is no error checking." msgstr "" -#: ../src/Doc/c-api/dict.rst:6 +#: c-api/dict.rst:6 msgid "Dictionary Objects" msgstr "Objets dictionnaires" # 034585a99548412a978b2b0b0bb90c41 -#: ../src/Doc/c-api/dict.rst:13 +#: c-api/dict.rst:13 msgid "" "This subtype of :c:type:`PyObject` represents a Python dictionary object." msgstr "" # f8682300221f4a4491d62c77dd3ff38a -#: ../src/Doc/c-api/dict.rst:22 +#: c-api/dict.rst:22 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python dictionary " "type. This is exposed to Python programs as ``dict`` and ``types.DictType``." msgstr "" # a6c69788b76e435a9a53da2ce70bded4 -#: ../src/Doc/c-api/dict.rst:29 +#: c-api/dict.rst:29 msgid "" "Return true if *p* is a dict object or an instance of a subtype of the dict " "type." msgstr "" # f035565bc4624ab09ecba69455a5248a -#: ../src/Doc/c-api/dict.rst:38 +#: c-api/dict.rst:38 msgid "" "Return true if *p* is a dict object, but not an instance of a subtype of the " "dict type." msgstr "" # 9bee4d328585453d861c082493d1f6f0 -#: ../src/Doc/c-api/dict.rst:46 +#: c-api/dict.rst:46 msgid "Return a new empty dictionary, or *NULL* on failure." msgstr "" # d94ee84fca074e87a05c7f9a06b1e96b -#: ../src/Doc/c-api/dict.rst:51 +#: c-api/dict.rst:51 msgid "" "Return a proxy object for a mapping which enforces read-only behavior. This " "is normally used to create a proxy to prevent modification of the dictionary " @@ -3618,12 +3611,12 @@ msgid "" msgstr "" # ccf52f5908df4b3b8cf03d465098fd27 -#: ../src/Doc/c-api/dict.rst:60 +#: c-api/dict.rst:60 msgid "Empty an existing dictionary of all key-value pairs." msgstr "" # 871e1110758a457787be282ec5f442fd -#: ../src/Doc/c-api/dict.rst:65 +#: c-api/dict.rst:65 msgid "" "Determine if dictionary *p* contains *key*. If an item in *p* is matches " "*key*, return ``1``, otherwise return ``0``. On error, return ``-1``. This " @@ -3631,12 +3624,12 @@ msgid "" msgstr "" # e193409ab56646dfb4433eabc279f445 -#: ../src/Doc/c-api/dict.rst:74 +#: c-api/dict.rst:74 msgid "Return a new dictionary that contains the same key-value pairs as *p*." msgstr "" # e4f7d94e19004553bfb3a4cb2bf5af0e -#: ../src/Doc/c-api/dict.rst:81 +#: c-api/dict.rst:81 msgid "" "Insert *value* into the dictionary *p* with a key of *key*. *key* must be :" "term:`hashable`; if it isn't, :exc:`TypeError` will be raised. Return ``0`` " @@ -3644,7 +3637,7 @@ msgid "" msgstr "" # 81e99bd7d6bc4cbf8261d1363fdcb813 -#: ../src/Doc/c-api/dict.rst:90 +#: c-api/dict.rst:90 msgid "" "Insert *value* into the dictionary *p* using *key* as a key. *key* should be " "a :c:type:`char\\*`. The key object is created using " @@ -3652,7 +3645,7 @@ msgid "" msgstr "" # a410f6b62c3b4e27a33b24a2333136c0 -#: ../src/Doc/c-api/dict.rst:98 +#: c-api/dict.rst:98 msgid "" "Remove the entry in dictionary *p* with key *key*. *key* must be hashable; " "if it isn't, :exc:`TypeError` is raised. Return ``0`` on success or ``-1`` " @@ -3660,56 +3653,62 @@ msgid "" msgstr "" # 1d03a04a52d44945861b4e727bf4da0c -#: ../src/Doc/c-api/dict.rst:105 +#: c-api/dict.rst:105 msgid "" "Remove the entry in dictionary *p* which has a key specified by the string " "*key*. Return ``0`` on success or ``-1`` on failure." msgstr "" # 8932b22687fe4c40b50334b3b2908bd6 -#: ../src/Doc/c-api/dict.rst:111 +#: c-api/dict.rst:111 msgid "" "Return the object from dictionary *p* which has a key *key*. Return *NULL* " "if the key *key* is not present, but *without* setting an exception." msgstr "" # 5ea94ee234824d36962d51932af1d4cf -#: ../src/Doc/c-api/dict.rst:117 +#: c-api/dict.rst:117 msgid "" "This is the same as :c:func:`PyDict_GetItem`, but *key* is specified as a :c:" "type:`char\\*`, rather than a :c:type:`PyObject\\*`." msgstr "" # bb925cccb0964422b827b3225660644c -#: ../src/Doc/c-api/dict.rst:123 +#: c-api/dict.rst:123 msgid "" "Return a :c:type:`PyListObject` containing all the items from the " "dictionary, as in the dictionary method :meth:`dict.items`." msgstr "" # 3f222f40424d4f57b2b3b58f3f6e92db -#: ../src/Doc/c-api/dict.rst:129 +#: c-api/dict.rst:129 msgid "" "Return a :c:type:`PyListObject` containing all the keys from the dictionary, " "as in the dictionary method :meth:`dict.keys`." msgstr "" # 3d57a08825c34fe68b3226e35f8d6644 -#: ../src/Doc/c-api/dict.rst:135 +#: c-api/dict.rst:135 msgid "" "Return a :c:type:`PyListObject` containing all the values from the " "dictionary *p*, as in the dictionary method :meth:`dict.values`." msgstr "" # 2cfe674c9c384f86851a8ea435d8f44f -#: ../src/Doc/c-api/dict.rst:143 +#: c-api/dict.rst:143 msgid "" "Return the number of items in the dictionary. This is equivalent to " "``len(p)`` on a dictionary." msgstr "" +#: c-api/dict.rst:146 +msgid "" +"This function returned an :c:type:`int` type. This might require changes in " +"your code for properly supporting 64-bit systems." +msgstr "" + # 931a6ce4bcc2440581bcbcc6d80ad0f8 -#: ../src/Doc/c-api/dict.rst:153 +#: c-api/dict.rst:153 msgid "" "Iterate over all key-value pairs in the dictionary *p*. The :c:type:" "`Py_ssize_t` referred to by *ppos* must be initialized to ``0`` prior to the " @@ -3724,12 +3723,12 @@ msgid "" msgstr "" # d8c93165b881432ebb4d3cc49f511720 -#: ../src/Doc/c-api/dict.rst:164 +#: c-api/dict.rst:164 msgid "For example::" msgstr "Par exemple ::" # 1913752be42e4cacaca914d1142ab2fa -#: ../src/Doc/c-api/dict.rst:174 +#: c-api/dict.rst:174 msgid "" "The dictionary *p* should not be mutated during iteration. It is safe " "(since Python 2.1) to modify the values of the keys as you iterate over the " @@ -3737,8 +3736,14 @@ msgid "" "example::" msgstr "" +#: c-api/dict.rst:194 +msgid "" +"This function used an :c:type:`int *` type for *ppos*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + # 1d29594c156e4095b994dfd4b36f6355 -#: ../src/Doc/c-api/dict.rst:201 +#: c-api/dict.rst:201 msgid "" "Iterate over mapping object *b* adding key-value pairs to dictionary *a*. " "*b* may be a dictionary, or any object supporting :c:func:`PyMapping_Keys` " @@ -3749,7 +3754,7 @@ msgid "" msgstr "" # 4539c6848bbd4673a06a40e2d0a1be0e -#: ../src/Doc/c-api/dict.rst:213 +#: c-api/dict.rst:213 msgid "" "This is the same as ``PyDict_Merge(a, b, 1)`` in C, and is similar to ``a." "update(b)`` in Python except that :c:func:`PyDict_Update` doesn't fall back " @@ -3759,7 +3764,7 @@ msgid "" msgstr "" # 82157ba989f749cda605945f8ac8906f -#: ../src/Doc/c-api/dict.rst:224 +#: c-api/dict.rst:224 msgid "" "Update or merge into dictionary *a*, from the key-value pairs in *seq2*. " "*seq2* must be an iterable object producing iterable objects of length 2, " @@ -3768,12 +3773,12 @@ msgid "" "if an exception was raised. Equivalent Python (except for the return value)::" msgstr "" -#: ../src/Doc/c-api/exceptions.rst:8 +#: c-api/exceptions.rst:8 msgid "Exception Handling" msgstr "Gestion des exceptions" # 36077af0150b405e8dde043ee190a4d3 -#: ../src/Doc/c-api/exceptions.rst:10 +#: c-api/exceptions.rst:10 msgid "" "The functions described in this chapter will let you handle and raise Python " "exceptions. It is important to understand some of the basics of Python " @@ -3786,7 +3791,7 @@ msgid "" "functions return ``1`` for success and ``0`` for failure)." msgstr "" -#: ../src/Doc/c-api/exceptions.rst:20 +#: c-api/exceptions.rst:20 msgid "" "When a function must fail because some function it called failed, it " "generally doesn't set the error indicator; the function it called already " @@ -3800,7 +3805,7 @@ msgid "" msgstr "" # 0ec5db9c97a14df58426cffb41beaa2c -#: ../src/Doc/c-api/exceptions.rst:35 +#: c-api/exceptions.rst:35 msgid "" "The error indicator consists of three Python objects corresponding to the " "Python variables ``sys.exc_type``, ``sys.exc_value`` and ``sys." @@ -3809,7 +3814,7 @@ msgid "" msgstr "" # 9b4be0fbc2e941068b3537f69fb2c384 -#: ../src/Doc/c-api/exceptions.rst:46 +#: c-api/exceptions.rst:46 msgid "" "Print a standard traceback to ``sys.stderr`` and clear the error indicator. " "Call this function only when the error indicator is set. (Otherwise it will " @@ -3817,7 +3822,7 @@ msgid "" msgstr "" # 623f4719fdab48c396fa38b766518bec -#: ../src/Doc/c-api/exceptions.rst:50 +#: c-api/exceptions.rst:50 msgid "" "If *set_sys_last_vars* is nonzero, the variables :data:`sys.last_type`, :" "data:`sys.last_value` and :data:`sys.last_traceback` will be set to the " @@ -3825,12 +3830,12 @@ msgid "" msgstr "" # 7cf289fd5d924f96a822d3bfa85b9253 -#: ../src/Doc/c-api/exceptions.rst:57 +#: c-api/exceptions.rst:57 msgid "Alias for ``PyErr_PrintEx(1)``." msgstr "" # 5a25516ad9864adc909d7ed11d7610f4 -#: ../src/Doc/c-api/exceptions.rst:62 +#: c-api/exceptions.rst:62 msgid "" "Test whether the error indicator is set. If set, return the exception " "*type* (the first argument to the last call to one of the :c:func:`PyErr_Set" @@ -3839,17 +3844,16 @@ msgid "" "func:`Py_DECREF` it." msgstr "" -# eac4dbd7951345a2b2c21e7a2eacb202 -#: ../src/Doc/c-api/exceptions.rst:70 +#: c-api/exceptions.rst:70 msgid "" "Do not compare the return value to a specific exception; use :c:func:" "`PyErr_ExceptionMatches` instead, shown below. (The comparison could easily " "fail since the exception may be an instance instead of a class, in the case " -"of a class exception, or it may the a subclass of the expected exception.)" +"of a class exception, or it may be a subclass of the expected exception.)" msgstr "" # 58c719fd21fb4d0fa5e618c6b93a0fd8 -#: ../src/Doc/c-api/exceptions.rst:78 +#: c-api/exceptions.rst:78 msgid "" "Equivalent to ``PyErr_GivenExceptionMatches(PyErr_Occurred(), exc)``. This " "should only be called when an exception is actually set; a memory access " @@ -3857,7 +3861,7 @@ msgid "" msgstr "" # 519e4df5412841568109daca6163e9dc -#: ../src/Doc/c-api/exceptions.rst:85 +#: c-api/exceptions.rst:85 msgid "" "Return true if the *given* exception matches the exception in *exc*. If " "*exc* is a class object, this also returns true when *given* is an instance " @@ -3866,7 +3870,7 @@ msgid "" msgstr "" # 79ff7da5db22468580f9bd12652d3481 -#: ../src/Doc/c-api/exceptions.rst:93 +#: c-api/exceptions.rst:93 msgid "" "Under certain circumstances, the values returned by :c:func:`PyErr_Fetch` " "below can be \"unnormalized\", meaning that ``*exc`` is a class object but " @@ -3877,14 +3881,14 @@ msgid "" msgstr "" # f22ccf12c8b0427abef1fe6d9a898344 -#: ../src/Doc/c-api/exceptions.rst:102 +#: c-api/exceptions.rst:102 msgid "" "Clear the error indicator. If the error indicator is not set, there is no " "effect." msgstr "" # 7f154b6d65154faa89c595a44d1efe5d -#: ../src/Doc/c-api/exceptions.rst:108 +#: c-api/exceptions.rst:108 msgid "" "Retrieve the error indicator into three variables whose addresses are " "passed. If the error indicator is not set, set all three variables to " @@ -3894,14 +3898,14 @@ msgid "" msgstr "" # 1f5aef6bb43746a588f486e98ede4341 -#: ../src/Doc/c-api/exceptions.rst:115 +#: c-api/exceptions.rst:115 msgid "" "This function is normally only used by code that needs to handle exceptions " "or by code that needs to save and restore the error indicator temporarily." msgstr "" # 5966026acc7144529ccf95064c42712c -#: ../src/Doc/c-api/exceptions.rst:121 +#: c-api/exceptions.rst:121 msgid "" "Set the error indicator from the three objects. If the error indicator is " "already set, it is cleared first. If the objects are *NULL*, the error " @@ -3915,7 +3919,7 @@ msgid "" msgstr "" # d88d0356f06c490699e86ddc6eba94af -#: ../src/Doc/c-api/exceptions.rst:133 +#: c-api/exceptions.rst:133 msgid "" "This function is normally only used by code that needs to save and restore " "the error indicator temporarily; use :c:func:`PyErr_Fetch` to save the " @@ -3923,7 +3927,7 @@ msgid "" msgstr "" # 5a363b6f1c3447ee8bfa394e09085865 -#: ../src/Doc/c-api/exceptions.rst:140 +#: c-api/exceptions.rst:140 msgid "" "This is the most common way to set the error indicator. The first argument " "specifies the exception type; it is normally one of the standard exceptions, " @@ -3933,14 +3937,14 @@ msgid "" msgstr "" # d29871d950b54ff69875c4b2e7025729 -#: ../src/Doc/c-api/exceptions.rst:148 +#: c-api/exceptions.rst:148 msgid "" "This function is similar to :c:func:`PyErr_SetString` but lets you specify " "an arbitrary Python object for the \"value\" of the exception." msgstr "" # 4d9b35429ead4bf1ade2cbe4cc0553da -#: ../src/Doc/c-api/exceptions.rst:154 +#: c-api/exceptions.rst:154 msgid "" "This function sets the error indicator and returns *NULL*. *exception* " "should be a Python exception class. The *format* and subsequent parameters " @@ -3949,12 +3953,12 @@ msgid "" msgstr "" # d2e24a91af924b8da59cd1bc86f7d9ab -#: ../src/Doc/c-api/exceptions.rst:162 +#: c-api/exceptions.rst:162 msgid "This is a shorthand for ``PyErr_SetObject(type, Py_None)``." msgstr "" # 941db3a999a745859f8ee72d622a7fc5 -#: ../src/Doc/c-api/exceptions.rst:167 +#: c-api/exceptions.rst:167 msgid "" "This is a shorthand for ``PyErr_SetString(PyExc_TypeError, message)``, where " "*message* indicates that a built-in operation was invoked with an illegal " @@ -3962,7 +3966,7 @@ msgid "" msgstr "" # 40f7de91b4be4ba284c47906ab92afde -#: ../src/Doc/c-api/exceptions.rst:174 +#: c-api/exceptions.rst:174 msgid "" "This is a shorthand for ``PyErr_SetNone(PyExc_MemoryError)``; it returns " "*NULL* so an object allocation function can write ``return PyErr_NoMemory();" @@ -3970,7 +3974,7 @@ msgid "" msgstr "" # b3e58c74a11242e9a741a8762a2b7436 -#: ../src/Doc/c-api/exceptions.rst:183 +#: c-api/exceptions.rst:183 msgid "" "This is a convenience function to raise an exception when a C library " "function has returned an error and set the C variable :c:data:`errno`. It " @@ -3985,7 +3989,7 @@ msgid "" msgstr "" # a615985919a449c0bedb44159bd818d9 -#: ../src/Doc/c-api/exceptions.rst:197 +#: c-api/exceptions.rst:197 msgid "" "Similar to :c:func:`PyErr_SetFromErrno`, with the additional behavior that " "if *filenameObject* is not *NULL*, it is passed to the constructor of *type* " @@ -3995,14 +3999,14 @@ msgid "" msgstr "" # f87f1f17e5224d2c955313b522d78e57 -#: ../src/Doc/c-api/exceptions.rst:206 +#: c-api/exceptions.rst:206 msgid "" "Similar to :c:func:`PyErr_SetFromErrnoWithFilenameObject`, but the filename " "is given as a C string." msgstr "" # 42a2831c58374774b920f094090cec24 -#: ../src/Doc/c-api/exceptions.rst:212 +#: c-api/exceptions.rst:212 msgid "" "This is a convenience function to raise :exc:`WindowsError`. If called with " "*ierr* of :c:data:`0`, the error code returned by a call to :c:func:" @@ -4016,14 +4020,14 @@ msgid "" msgstr "" # f87f1f17e5224d2c955313b522d78e57 -#: ../src/Doc/c-api/exceptions.rst:224 +#: c-api/exceptions.rst:224 msgid "" "Similar to :c:func:`PyErr_SetFromWindowsErr`, with an additional parameter " "specifying the exception type to be raised. Availability: Windows." msgstr "" # 0eee7700ce7344189f93cba72a318d16 -#: ../src/Doc/c-api/exceptions.rst:232 +#: c-api/exceptions.rst:232 msgid "" "Similar to :c:func:`PyErr_SetFromWindowsErr`, with the additional behavior " "that if *filenameObject* is not *NULL*, it is passed to the constructor of :" @@ -4031,14 +4035,14 @@ msgid "" msgstr "" # d53114e34e704cc081324a4445de7d8d -#: ../src/Doc/c-api/exceptions.rst:239 +#: c-api/exceptions.rst:239 msgid "" "Similar to :c:func:`PyErr_SetFromWindowsErrWithFilenameObject`, but the " "filename is given as a C string. Availability: Windows." msgstr "" # d53114e34e704cc081324a4445de7d8d -#: ../src/Doc/c-api/exceptions.rst:245 +#: c-api/exceptions.rst:245 msgid "" "Similar to :c:func:`PyErr_SetFromWindowsErrWithFilenameObject`, with an " "additional parameter specifying the exception type to be raised. " @@ -4046,14 +4050,14 @@ msgid "" msgstr "" # d53114e34e704cc081324a4445de7d8d -#: ../src/Doc/c-api/exceptions.rst:254 +#: c-api/exceptions.rst:254 msgid "" "Similar to :c:func:`PyErr_SetFromWindowsErrWithFilename`, with an additional " "parameter specifying the exception type to be raised. Availability: Windows." msgstr "" # 932101b5bca44331a3634de2e69c9f65 -#: ../src/Doc/c-api/exceptions.rst:262 +#: c-api/exceptions.rst:262 msgid "" "This is a shorthand for ``PyErr_SetString(PyExc_SystemError, message)``, " "where *message* indicates that an internal operation (e.g. a Python/C API " @@ -4062,7 +4066,7 @@ msgid "" msgstr "" # bba89428417e4043b837aa9d5986fc1f -#: ../src/Doc/c-api/exceptions.rst:270 +#: c-api/exceptions.rst:270 msgid "" "Issue a warning message. The *category* argument is a warning category (see " "below) or *NULL*; the *message* argument is a message string. *stacklevel* " @@ -4073,7 +4077,7 @@ msgid "" msgstr "" # 25c906a19cff4262ac3a046065595936 -#: ../src/Doc/c-api/exceptions.rst:277 +#: c-api/exceptions.rst:277 msgid "" "This function normally prints a warning message to *sys.stderr*; however, it " "is also possible that the user has specified that warnings are to be turned " @@ -4089,7 +4093,7 @@ msgid "" msgstr "" # 0beb36f0a03547d181d62d42d947a8f5 -#: ../src/Doc/c-api/exceptions.rst:289 +#: c-api/exceptions.rst:289 msgid "" "Warning categories must be subclasses of :c:data:`Warning`; the default " "warning category is :c:data:`RuntimeWarning`. The standard Python warning " @@ -4104,7 +4108,7 @@ msgid "" msgstr "" # 6673aa0b6b004dc9bb109cd2b5eb3930 -#: ../src/Doc/c-api/exceptions.rst:300 +#: c-api/exceptions.rst:300 msgid "" "For information about warning control, see the documentation for the :mod:" "`warnings` module and the :option:`-W` option in the command line " @@ -4112,7 +4116,7 @@ msgid "" msgstr "" # 08b3491884314079a6a16fd2bf280973 -#: ../src/Doc/c-api/exceptions.rst:307 +#: c-api/exceptions.rst:307 msgid "" "Issue a warning message. The *category* argument is a warning category (see " "below) or *NULL*; the *message* argument is a message string. The warning " @@ -4121,12 +4125,12 @@ msgid "" msgstr "" # 82f5df8efe6c4a6f91b1d65609426976 -#: ../src/Doc/c-api/exceptions.rst:312 +#: c-api/exceptions.rst:312 msgid "Deprecated; use :c:func:`PyErr_WarnEx` instead." msgstr "" # f78d79baa0da42f3a62610fd44a8847e -#: ../src/Doc/c-api/exceptions.rst:317 +#: c-api/exceptions.rst:317 msgid "" "Issue a warning message with explicit control over all warning attributes. " "This is a straightforward wrapper around the Python function :func:`warnings." @@ -4135,14 +4139,14 @@ msgid "" msgstr "" # c369a55a5371425a813b663bfe25142c -#: ../src/Doc/c-api/exceptions.rst:326 +#: c-api/exceptions.rst:326 msgid "" "Issue a :exc:`DeprecationWarning` with the given *message* and *stacklevel* " "if the :c:data:`Py_Py3kWarningFlag` flag is enabled." msgstr "" # 4df501d23c8b4e57af263e78e759adb0 -#: ../src/Doc/c-api/exceptions.rst:339 +#: c-api/exceptions.rst:339 msgid "" "This function interacts with Python's signal handling. It checks whether a " "signal has been sent to the processes and if so, invokes the corresponding " @@ -4155,7 +4159,7 @@ msgid "" msgstr "" # de4c1d62fb20434caf1d837d99b4ad00 -#: ../src/Doc/c-api/exceptions.rst:355 +#: c-api/exceptions.rst:355 msgid "" "This function simulates the effect of a :const:`SIGINT` signal arriving --- " "the next time :c:func:`PyErr_CheckSignals` is called, :exc:" @@ -4164,7 +4168,7 @@ msgid "" msgstr "" # 16e0cfc5392443c09c371c228c7907ae -#: ../src/Doc/c-api/exceptions.rst:365 +#: c-api/exceptions.rst:365 msgid "" "This utility function specifies a file descriptor to which a ``'\\0'`` byte " "will be written whenever a signal is received. It returns the previous such " @@ -4175,7 +4179,7 @@ msgid "" msgstr "" # 8ed8c70c1c9046628d0222ec7c3c0352 -#: ../src/Doc/c-api/exceptions.rst:377 +#: c-api/exceptions.rst:377 msgid "" "This utility function creates and returns a new exception class. The *name* " "argument must be the name of the new exception, a C string of the form " @@ -4185,7 +4189,7 @@ msgid "" msgstr "" # f6d518adf9de4a92b9acdb7563a222c2 -#: ../src/Doc/c-api/exceptions.rst:383 +#: c-api/exceptions.rst:383 msgid "" "The :attr:`__module__` attribute of the new class is set to the first part " "(up to the last dot) of the *name* argument, and the class name is set to " @@ -4196,7 +4200,7 @@ msgid "" msgstr "" # 5858a6c32ce64136a7ded55c90f7dc92 -#: ../src/Doc/c-api/exceptions.rst:392 +#: c-api/exceptions.rst:392 msgid "" "Same as :c:func:`PyErr_NewException`, except that the new exception class " "can easily be given a docstring: If *doc* is non-*NULL*, it will be used as " @@ -4204,7 +4208,7 @@ msgid "" msgstr "" # 526743355b98486b9f1ab57e107550fc -#: ../src/Doc/c-api/exceptions.rst:401 +#: c-api/exceptions.rst:401 msgid "" "This utility function prints a warning message to ``sys.stderr`` when an " "exception has been set but it is impossible for the interpreter to actually " @@ -4213,58 +4217,58 @@ msgid "" msgstr "" # 26cf16a4fb454ae9ad33a3d0e70c7eb7 -#: ../src/Doc/c-api/exceptions.rst:406 +#: c-api/exceptions.rst:406 msgid "" "The function is called with a single argument *obj* that identifies the " "context in which the unraisable exception occurred. The repr of *obj* will " "be printed in the warning message." msgstr "" -#: ../src/Doc/c-api/exceptions.rst:414 +#: c-api/exceptions.rst:414 #, fuzzy msgid "Unicode Exception Objects" msgstr "Objets Exception" # 3068c11a474c45af958d3ddcab0cfa1d -#: ../src/Doc/c-api/exceptions.rst:416 +#: c-api/exceptions.rst:416 msgid "" "The following functions are used to create and modify Unicode exceptions " "from C." msgstr "" # 79b350fef7ed442190d2a499ff34c47b -#: ../src/Doc/c-api/exceptions.rst:420 +#: c-api/exceptions.rst:420 msgid "" "Create a :class:`UnicodeDecodeError` object with the attributes *encoding*, " "*object*, *length*, *start*, *end* and *reason*." msgstr "" # fbdb217438d3495a942e29fe091fa7fd -#: ../src/Doc/c-api/exceptions.rst:425 +#: c-api/exceptions.rst:425 msgid "" "Create a :class:`UnicodeEncodeError` object with the attributes *encoding*, " "*object*, *length*, *start*, *end* and *reason*." msgstr "" # 0942689de5784065be6b86db1e56add0 -#: ../src/Doc/c-api/exceptions.rst:430 +#: c-api/exceptions.rst:430 msgid "" "Create a :class:`UnicodeTranslateError` object with the attributes *object*, " "*length*, *start*, *end* and *reason*." msgstr "" # 994cc120c2574b19944cfb3f987e1d3c -#: ../src/Doc/c-api/exceptions.rst:436 +#: c-api/exceptions.rst:436 msgid "Return the *encoding* attribute of the given exception object." msgstr "" # 489c19d9bb4f4028ba28c1e66f94db24 -#: ../src/Doc/c-api/exceptions.rst:442 +#: c-api/exceptions.rst:442 msgid "Return the *object* attribute of the given exception object." msgstr "" # 80df25d746594aaf87bd55ba98a832b9 -#: ../src/Doc/c-api/exceptions.rst:448 +#: c-api/exceptions.rst:448 msgid "" "Get the *start* attribute of the given exception object and place it into *" "\\*start*. *start* must not be *NULL*. Return ``0`` on success, ``-1`` on " @@ -4272,14 +4276,14 @@ msgid "" msgstr "" # 1d5721002fe9429ba126994614cf77e4 -#: ../src/Doc/c-api/exceptions.rst:456 +#: c-api/exceptions.rst:456 msgid "" "Set the *start* attribute of the given exception object to *start*. Return " "``0`` on success, ``-1`` on failure." msgstr "" # e87b977cf27746668bbfd7490a3133c3 -#: ../src/Doc/c-api/exceptions.rst:463 +#: c-api/exceptions.rst:463 msgid "" "Get the *end* attribute of the given exception object and place it into *" "\\*end*. *end* must not be *NULL*. Return ``0`` on success, ``-1`` on " @@ -4287,29 +4291,29 @@ msgid "" msgstr "" # 8baec9193a0e416c951407367a9b91fc -#: ../src/Doc/c-api/exceptions.rst:471 +#: c-api/exceptions.rst:471 msgid "" "Set the *end* attribute of the given exception object to *end*. Return " "``0`` on success, ``-1`` on failure." msgstr "" # 1c66a5d03a414394966ee3b8f17f3e92 -#: ../src/Doc/c-api/exceptions.rst:478 +#: c-api/exceptions.rst:478 msgid "Return the *reason* attribute of the given exception object." msgstr "" # a7b9a95fcf0d4fe0998dede225e3e965 -#: ../src/Doc/c-api/exceptions.rst:484 +#: c-api/exceptions.rst:484 msgid "" "Set the *reason* attribute of the given exception object to *reason*. " "Return ``0`` on success, ``-1`` on failure." msgstr "" -#: ../src/Doc/c-api/exceptions.rst:489 +#: c-api/exceptions.rst:489 msgid "Recursion Control" msgstr "Contrôle de la récursion" -#: ../src/Doc/c-api/exceptions.rst:491 +#: c-api/exceptions.rst:491 msgid "" "These two functions provide a way to perform safe recursive calls at the C " "level, both in the core and in extension modules. They are needed if the " @@ -4318,12 +4322,12 @@ msgid "" msgstr "" # 33ddb5e0606846ed9bb92137558dda5a -#: ../src/Doc/c-api/exceptions.rst:498 +#: c-api/exceptions.rst:498 msgid "Marks a point where a recursive C-level call is about to be performed." msgstr "" # 7403de4bffbf47ffa168daa44fa2998e -#: ../src/Doc/c-api/exceptions.rst:500 +#: c-api/exceptions.rst:500 msgid "" "If :const:`USE_STACKCHECK` is defined, this function checks if the OS stack " "overflowed using :c:func:`PyOS_CheckStack`. In this is the case, it sets a :" @@ -4331,7 +4335,7 @@ msgid "" msgstr "" # e6798739bde447448b9ff135c09b755b -#: ../src/Doc/c-api/exceptions.rst:504 +#: c-api/exceptions.rst:504 msgid "" "The function then checks if the recursion limit is reached. If this is the " "case, a :exc:`RuntimeError` is set and a nonzero value is returned. " @@ -4339,7 +4343,7 @@ msgid "" msgstr "" # 4fa1b81ac88549858e678558c3abe76b -#: ../src/Doc/c-api/exceptions.rst:508 +#: c-api/exceptions.rst:508 msgid "" "*where* should be a string such as ``\" in instance check\"`` to be " "concatenated to the :exc:`RuntimeError` message caused by the recursion " @@ -4347,18 +4351,18 @@ msgid "" msgstr "" # 892d13be55cf469faac6a27912389343 -#: ../src/Doc/c-api/exceptions.rst:514 +#: c-api/exceptions.rst:514 msgid "" "Ends a :c:func:`Py_EnterRecursiveCall`. Must be called once for each " "*successful* invocation of :c:func:`Py_EnterRecursiveCall`." msgstr "" -#: ../src/Doc/c-api/exceptions.rst:521 +#: c-api/exceptions.rst:521 msgid "Standard Exceptions" msgstr "Exceptions standards" # 1fe9a27ef5914f7e80c4b90204cf5865 -#: ../src/Doc/c-api/exceptions.rst:523 +#: c-api/exceptions.rst:523 msgid "" "All standard Python exceptions are available as global variables whose names " "are ``PyExc_`` followed by the Python exception name. These have the type :" @@ -4366,307 +4370,313 @@ msgid "" "are all the variables:" msgstr "" -#: ../src/Doc/c-api/exceptions.rst:529 +#: c-api/exceptions.rst:529 msgid "C Name" msgstr "Nom C" -#: ../src/Doc/c-api/exceptions.rst:529 +#: c-api/exceptions.rst:529 msgid "Python Name" msgstr "Nom Python" -#: ../src/Doc/c-api/exceptions.rst:529 +#: c-api/exceptions.rst:529 msgid "Notes" msgstr "Notes" -#: ../src/Doc/c-api/exceptions.rst:531 +#: c-api/exceptions.rst:531 msgid ":c:data:`PyExc_BaseException`" msgstr ":c:data:`PyExc_BaseException`" -#: ../src/Doc/c-api/exceptions.rst:531 +#: c-api/exceptions.rst:531 msgid ":exc:`BaseException`" msgstr ":exc:`BaseException`" # 31c707bae9f64037a3ab6f08eec71c60 -#: ../src/Doc/c-api/exceptions.rst:531 +#: c-api/exceptions.rst:531 msgid "(1), (4)" msgstr "" -#: ../src/Doc/c-api/exceptions.rst:533 +#: c-api/exceptions.rst:533 msgid ":c:data:`PyExc_Exception`" msgstr ":c:data:`PyExc_Exception`" -#: ../src/Doc/c-api/exceptions.rst:533 +#: c-api/exceptions.rst:533 msgid ":exc:`Exception`" msgstr ":exc:`Exception`" -#: ../src/Doc/c-api/exceptions.rst:533 ../src/Doc/c-api/exceptions.rst:535 -#: ../src/Doc/c-api/exceptions.rst:537 ../src/Doc/c-api/exceptions.rst:539 -#: ../src/Doc/c-api/exceptions.rst:547 +#: c-api/exceptions.rst:533 c-api/exceptions.rst:535 c-api/exceptions.rst:537 +#: c-api/exceptions.rst:539 c-api/exceptions.rst:547 msgid "\\(1)" msgstr "\\(1)" -#: ../src/Doc/c-api/exceptions.rst:535 +#: c-api/exceptions.rst:535 msgid ":c:data:`PyExc_StandardError`" msgstr ":c:data:`PyExc_StandardError`" -#: ../src/Doc/c-api/exceptions.rst:535 +#: c-api/exceptions.rst:535 msgid ":exc:`StandardError`" msgstr ":exc:`StandardError`" -#: ../src/Doc/c-api/exceptions.rst:537 +#: c-api/exceptions.rst:537 msgid ":c:data:`PyExc_ArithmeticError`" msgstr ":c:data:`PyExc_ArithmeticError`" -#: ../src/Doc/c-api/exceptions.rst:537 +#: c-api/exceptions.rst:537 msgid ":exc:`ArithmeticError`" msgstr ":exc:`ArithmeticError`" -#: ../src/Doc/c-api/exceptions.rst:539 +#: c-api/exceptions.rst:539 msgid ":c:data:`PyExc_LookupError`" msgstr ":c:data:`PyExc_LookupError`" -#: ../src/Doc/c-api/exceptions.rst:539 +#: c-api/exceptions.rst:539 msgid ":exc:`LookupError`" msgstr ":exc:`LookupError`" -#: ../src/Doc/c-api/exceptions.rst:541 +#: c-api/exceptions.rst:541 msgid ":c:data:`PyExc_AssertionError`" msgstr ":c:data:`PyExc_AssertionError`" -#: ../src/Doc/c-api/exceptions.rst:541 +#: c-api/exceptions.rst:541 msgid ":exc:`AssertionError`" msgstr ":exc:`AssertionError`" -#: ../src/Doc/c-api/exceptions.rst:543 +#: c-api/exceptions.rst:543 msgid ":c:data:`PyExc_AttributeError`" msgstr ":c:data:`PyExc_AttributeError`" -#: ../src/Doc/c-api/exceptions.rst:543 +#: c-api/exceptions.rst:543 msgid ":exc:`AttributeError`" msgstr ":exc:`AttributeError`" -#: ../src/Doc/c-api/exceptions.rst:545 +#: c-api/exceptions.rst:545 msgid ":c:data:`PyExc_EOFError`" msgstr ":c:data:`PyExc_EOFError`" -#: ../src/Doc/c-api/exceptions.rst:545 +#: c-api/exceptions.rst:545 msgid ":exc:`EOFError`" msgstr ":exc:`EOFError`" -#: ../src/Doc/c-api/exceptions.rst:547 +#: c-api/exceptions.rst:547 msgid ":c:data:`PyExc_EnvironmentError`" msgstr ":c:data:`PyExc_EnvironmentError`" -#: ../src/Doc/c-api/exceptions.rst:547 +#: c-api/exceptions.rst:547 msgid ":exc:`EnvironmentError`" msgstr ":exc:`EnvironmentError`" -#: ../src/Doc/c-api/exceptions.rst:549 +#: c-api/exceptions.rst:549 msgid ":c:data:`PyExc_FloatingPointError`" msgstr ":c:data:`PyExc_FloatingPointError`" -#: ../src/Doc/c-api/exceptions.rst:549 +#: c-api/exceptions.rst:549 msgid ":exc:`FloatingPointError`" msgstr ":exc:`FloatingPointError`" -#: ../src/Doc/c-api/exceptions.rst:551 +#: c-api/exceptions.rst:551 msgid ":c:data:`PyExc_IOError`" msgstr ":c:data:`PyExc_IOError`" -#: ../src/Doc/c-api/exceptions.rst:551 +#: c-api/exceptions.rst:551 msgid ":exc:`IOError`" msgstr ":exc:`IOError`" -#: ../src/Doc/c-api/exceptions.rst:553 +#: c-api/exceptions.rst:553 msgid ":c:data:`PyExc_ImportError`" msgstr ":c:data:`PyExc_ImportError`" -#: ../src/Doc/c-api/exceptions.rst:553 +#: c-api/exceptions.rst:553 msgid ":exc:`ImportError`" msgstr ":exc:`ImportError`" -#: ../src/Doc/c-api/exceptions.rst:555 +#: c-api/exceptions.rst:555 #, fuzzy msgid ":c:data:`PyExc_IndexError`" msgstr ":c:data:`PyExc_IndexError`" -#: ../src/Doc/c-api/exceptions.rst:555 +#: c-api/exceptions.rst:555 msgid ":exc:`IndexError`" msgstr ":exc:`IndexError`" -#: ../src/Doc/c-api/exceptions.rst:557 +#: c-api/exceptions.rst:557 #, fuzzy msgid ":c:data:`PyExc_KeyError`" msgstr ":c:data:`PyExc_KeyError`" -#: ../src/Doc/c-api/exceptions.rst:557 +#: c-api/exceptions.rst:557 msgid ":exc:`KeyError`" msgstr ":exc:`KeyError`" -#: ../src/Doc/c-api/exceptions.rst:559 +#: c-api/exceptions.rst:559 #, fuzzy msgid ":c:data:`PyExc_KeyboardInterrupt`" msgstr ":c:data:`PyExc_KeyboardInterrupt`" -#: ../src/Doc/c-api/exceptions.rst:559 +#: c-api/exceptions.rst:559 msgid ":exc:`KeyboardInterrupt`" msgstr ":exc:`KeyboardInterrupt`" -#: ../src/Doc/c-api/exceptions.rst:561 +#: c-api/exceptions.rst:561 #, fuzzy msgid ":c:data:`PyExc_MemoryError`" msgstr ":c:data:`PyExc_MemoryError`" -#: ../src/Doc/c-api/exceptions.rst:561 +#: c-api/exceptions.rst:561 msgid ":exc:`MemoryError`" msgstr ":exc:`MemoryError`" -#: ../src/Doc/c-api/exceptions.rst:563 +#: c-api/exceptions.rst:563 #, fuzzy msgid ":c:data:`PyExc_NameError`" msgstr ":c:data:`PyExc_NameError`" -#: ../src/Doc/c-api/exceptions.rst:563 +#: c-api/exceptions.rst:563 msgid ":exc:`NameError`" msgstr ":exc:`NameError`" -#: ../src/Doc/c-api/exceptions.rst:565 +#: c-api/exceptions.rst:565 #, fuzzy msgid ":c:data:`PyExc_NotImplementedError`" msgstr ":c:data:`PyExc_NotImplementedError`" -#: ../src/Doc/c-api/exceptions.rst:565 +#: c-api/exceptions.rst:565 msgid ":exc:`NotImplementedError`" msgstr ":exc:`NotImplementedError`" -#: ../src/Doc/c-api/exceptions.rst:567 +#: c-api/exceptions.rst:567 #, fuzzy msgid ":c:data:`PyExc_OSError`" msgstr ":c:data:`PyExc_OSError`" -#: ../src/Doc/c-api/exceptions.rst:567 +#: c-api/exceptions.rst:567 msgid ":exc:`OSError`" msgstr ":exc:`OSError`" -#: ../src/Doc/c-api/exceptions.rst:569 +#: c-api/exceptions.rst:569 #, fuzzy msgid ":c:data:`PyExc_OverflowError`" msgstr ":c:data:`PyExc_OverflowError`" -#: ../src/Doc/c-api/exceptions.rst:569 +#: c-api/exceptions.rst:569 msgid ":exc:`OverflowError`" msgstr ":exc:`OverflowError`" -#: ../src/Doc/c-api/exceptions.rst:571 +#: c-api/exceptions.rst:571 #, fuzzy msgid ":c:data:`PyExc_ReferenceError`" msgstr ":c:data:`PyExc_ReferenceError`" -#: ../src/Doc/c-api/exceptions.rst:571 +#: c-api/exceptions.rst:571 msgid ":exc:`ReferenceError`" msgstr ":exc:`ReferenceError`" -#: ../src/Doc/c-api/exceptions.rst:571 +#: c-api/exceptions.rst:571 msgid "\\(2)" msgstr "\\(2)" -#: ../src/Doc/c-api/exceptions.rst:573 +#: c-api/exceptions.rst:573 msgid ":c:data:`PyExc_RuntimeError`" msgstr ":c:data:`PyExc_RuntimeError`" -#: ../src/Doc/c-api/exceptions.rst:573 +#: c-api/exceptions.rst:573 msgid ":exc:`RuntimeError`" msgstr ":exc:`RuntimeError`" -#: ../src/Doc/c-api/exceptions.rst:575 +#: c-api/exceptions.rst:575 #, fuzzy msgid ":c:data:`PyExc_SyntaxError`" msgstr ":c:data:`PyExc_SyntaxError`" -#: ../src/Doc/c-api/exceptions.rst:575 +#: c-api/exceptions.rst:575 msgid ":exc:`SyntaxError`" msgstr ":exc:`SyntaxError`" -#: ../src/Doc/c-api/exceptions.rst:577 +#: c-api/exceptions.rst:577 msgid ":c:data:`PyExc_SystemError`" msgstr ":c:data:`PyExc_SystemError`" -#: ../src/Doc/c-api/exceptions.rst:577 +#: c-api/exceptions.rst:577 msgid ":exc:`SystemError`" msgstr ":exc:`SystemError`" -#: ../src/Doc/c-api/exceptions.rst:579 +#: c-api/exceptions.rst:579 msgid ":c:data:`PyExc_SystemExit`" msgstr ":c:data:`PyExc_SystemExit`" -#: ../src/Doc/c-api/exceptions.rst:579 +#: c-api/exceptions.rst:579 msgid ":exc:`SystemExit`" msgstr ":exc:`SystemExit`" -#: ../src/Doc/c-api/exceptions.rst:581 +#: c-api/exceptions.rst:581 msgid ":c:data:`PyExc_TypeError`" msgstr ":c:data:`PyExc_TypeError`" -#: ../src/Doc/c-api/exceptions.rst:581 +#: c-api/exceptions.rst:581 msgid ":exc:`TypeError`" msgstr ":exc:`TypeError`" -#: ../src/Doc/c-api/exceptions.rst:583 +#: c-api/exceptions.rst:583 msgid ":c:data:`PyExc_ValueError`" msgstr ":c:data:`PyExc_ValueError`" -#: ../src/Doc/c-api/exceptions.rst:583 +#: c-api/exceptions.rst:583 msgid ":exc:`ValueError`" msgstr ":exc:`ValueError`" -#: ../src/Doc/c-api/exceptions.rst:585 +#: c-api/exceptions.rst:585 msgid ":c:data:`PyExc_WindowsError`" msgstr ":c:data:`PyExc_WindowsError`" -#: ../src/Doc/c-api/exceptions.rst:585 +#: c-api/exceptions.rst:585 msgid ":exc:`WindowsError`" msgstr ":exc:`WindowsError`" -#: ../src/Doc/c-api/exceptions.rst:585 +#: c-api/exceptions.rst:585 msgid "\\(3)" msgstr "\\(3)" -#: ../src/Doc/c-api/exceptions.rst:587 +#: c-api/exceptions.rst:587 msgid ":c:data:`PyExc_ZeroDivisionError`" msgstr ":c:data:`PyExc_ZeroDivisionError`" -#: ../src/Doc/c-api/exceptions.rst:587 +#: c-api/exceptions.rst:587 msgid ":exc:`ZeroDivisionError`" msgstr ":exc:`ZeroDivisionError`" -#: ../src/Doc/c-api/exceptions.rst:621 +#: c-api/exceptions.rst:621 msgid "Notes:" msgstr "Notes : " -#: ../src/Doc/c-api/exceptions.rst:624 +#: c-api/exceptions.rst:624 msgid "This is a base class for other standard exceptions." msgstr "C'est la classe de base pour les autres exceptions standards" -#: ../src/Doc/c-api/exceptions.rst:627 +#: c-api/exceptions.rst:627 msgid "This is the same as :exc:`weakref.ReferenceError`." msgstr "Identique à :exc:`weakref.ReferenceError`." -#: ../src/Doc/c-api/exceptions.rst:630 +#: c-api/exceptions.rst:630 msgid "" "Only defined on Windows; protect code that uses this by testing that the " "preprocessor macro ``MS_WINDOWS`` is defined." msgstr "" -#: ../src/Doc/c-api/exceptions.rst:638 +#: c-api/exceptions.rst:638 msgid "String Exceptions" msgstr "" -#: ../src/Doc/c-api/file.rst:6 +#: c-api/exceptions.rst:640 +msgid "" +"All exceptions to be raised or caught must be derived from :exc:" +"`BaseException`. Trying to raise a string exception now raises :exc:" +"`TypeError`." +msgstr "" + +#: c-api/file.rst:6 msgid "File Objects" msgstr "Objets fichiers" # 855f2f1e54214254990840f446e17fd3 -#: ../src/Doc/c-api/file.rst:10 +#: c-api/file.rst:10 msgid "" "Python's built-in file objects are implemented entirely on the :c:type:`FILE" "\\*` support from the C standard library. This is an implementation detail " @@ -4674,33 +4684,33 @@ msgid "" msgstr "" # 3ebcfbdec8b14fd0aa3f82e3e274b7b1 -#: ../src/Doc/c-api/file.rst:17 +#: c-api/file.rst:17 msgid "This subtype of :c:type:`PyObject` represents a Python file object." msgstr "" # c8bf8e0de5b748e586fe373b40101c0e -#: ../src/Doc/c-api/file.rst:24 +#: c-api/file.rst:24 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python file type. " "This is exposed to Python programs as ``file`` and ``types.FileType``." msgstr "" # c589e65e50cf403a906b10f7683fecff -#: ../src/Doc/c-api/file.rst:30 +#: c-api/file.rst:30 msgid "" "Return true if its argument is a :c:type:`PyFileObject` or a subtype of :c:" "type:`PyFileObject`." msgstr "" # 64dad6d3f5474aa995303ad2f7d5ec7c -#: ../src/Doc/c-api/file.rst:39 +#: c-api/file.rst:39 msgid "" "Return true if its argument is a :c:type:`PyFileObject`, but not a subtype " "of :c:type:`PyFileObject`." msgstr "" # b94d6b32c3004dadbba60954747550aa -#: ../src/Doc/c-api/file.rst:49 +#: c-api/file.rst:49 msgid "" "On success, return a new file object that is opened on the file given by " "*filename*, with a file mode given by *mode*, where *mode* has the same " @@ -4709,7 +4719,7 @@ msgid "" msgstr "" # 68142d8b894148c9bb6f0a7e06c0512e -#: ../src/Doc/c-api/file.rst:56 +#: c-api/file.rst:56 msgid "" "Create a new :c:type:`PyFileObject` from the already-open standard C file " "pointer, *fp*. The function *close* will be called when the file should be " @@ -4718,12 +4728,12 @@ msgid "" msgstr "" # 3ce48a19f980476da9da6d70056ac957 -#: ../src/Doc/c-api/file.rst:64 +#: c-api/file.rst:64 msgid "Return the file object associated with *p* as a :c:type:`FILE\\*`." msgstr "" # 329ce35439ce478a884be0be17e6cf68 -#: ../src/Doc/c-api/file.rst:66 +#: c-api/file.rst:66 msgid "" "If the caller will ever use the returned :c:type:`FILE\\*` object while the :" "term:`GIL` is released it must also call the :c:func:`PyFile_IncUseCount` " @@ -4731,7 +4741,7 @@ msgid "" msgstr "" # b009e85b8e0346bca89cb4e381068f9b -#: ../src/Doc/c-api/file.rst:73 +#: c-api/file.rst:73 msgid "" "Increments the PyFileObject's internal use count to indicate that the " "underlying :c:type:`FILE\\*` is being used. This prevents Python from " @@ -4741,19 +4751,19 @@ msgid "" msgstr "" # 8b88969e03c349d78bcb48bb31ed9198 -#: ../src/Doc/c-api/file.rst:80 +#: c-api/file.rst:80 msgid "The :term:`GIL` must be held while calling this function." msgstr "" # 061fc65b1e23406482c14c4c8dce9963 -#: ../src/Doc/c-api/file.rst:82 +#: c-api/file.rst:82 msgid "" "The suggested use is to call this after :c:func:`PyFile_AsFile` and before " "you release the GIL::" msgstr "" # 0b524854c5fe419c9adbbc7b0223f84a -#: ../src/Doc/c-api/file.rst:99 +#: c-api/file.rst:99 msgid "" "Decrements the PyFileObject's internal unlocked_count member to indicate " "that the caller is done with its own use of the :c:type:`FILE\\*`. This may " @@ -4761,14 +4771,14 @@ msgid "" msgstr "" # c41010a6ca1a443d9439deeedb3119aa -#: ../src/Doc/c-api/file.rst:103 +#: c-api/file.rst:103 msgid "" "The :term:`GIL` must be held while calling this function (see the example " "above)." msgstr "" # 0232558ecba24837b6e7af069589f01a -#: ../src/Doc/c-api/file.rst:113 +#: c-api/file.rst:113 msgid "" "Equivalent to ``p.readline([n])``, this function reads one line from the " "object *p*. *p* may be a file object or any object with a :meth:`~io.IOBase." @@ -4782,33 +4792,33 @@ msgid "" msgstr "" # 1bef0003fae341838f361176039f4bf6 -#: ../src/Doc/c-api/file.rst:126 +#: c-api/file.rst:126 msgid "Return the name of the file specified by *p* as a string object." msgstr "" # f6b57a642018412cb393efb4d85f8c21 -#: ../src/Doc/c-api/file.rst:133 +#: c-api/file.rst:133 msgid "" "Available on systems with :c:func:`setvbuf` only. This should only be " "called immediately after file object creation." msgstr "" # 0810bc095aa44245bf50741420508fb5 -#: ../src/Doc/c-api/file.rst:139 +#: c-api/file.rst:139 msgid "" "Set the file's encoding for Unicode output to *enc*. Return 1 on success and " "0 on failure." msgstr "" # 1d8dd1f31e7a49809c5e9b7aadfed146 -#: ../src/Doc/c-api/file.rst:147 +#: c-api/file.rst:147 msgid "" "Set the file's encoding for Unicode output to *enc*, and its error mode to " "*err*. Return 1 on success and 0 on failure." msgstr "" # df36519e6af84411b18d55d9ed49bc37 -#: ../src/Doc/c-api/file.rst:157 +#: c-api/file.rst:157 msgid "" "This function exists for internal use by the interpreter. Set the :attr:" "`softspace` attribute of *p* to *newflag* and return the previous value. *p* " @@ -4821,7 +4831,7 @@ msgid "" msgstr "" # 69cefba0f77e43ca90410f62056e5580 -#: ../src/Doc/c-api/file.rst:171 +#: c-api/file.rst:171 msgid "" "Write object *obj* to file object *p*. The only supported flag for *flags* " "is :const:`Py_PRINT_RAW`; if given, the :func:`str` of the object is written " @@ -4830,45 +4840,45 @@ msgid "" msgstr "" # 4551ee45b5a04e5c9a65ec5087efe225 -#: ../src/Doc/c-api/file.rst:179 +#: c-api/file.rst:179 msgid "" "Write string *s* to file object *p*. Return ``0`` on success or ``-1`` on " "failure; the appropriate exception will be set." msgstr "" -#: ../src/Doc/c-api/float.rst:6 +#: c-api/float.rst:6 msgid "Floating Point Objects" msgstr "" # d1869e7d55f945d1af5bac4008a8ac10 -#: ../src/Doc/c-api/float.rst:13 +#: c-api/float.rst:13 msgid "" "This subtype of :c:type:`PyObject` represents a Python floating point object." msgstr "" # 8007abbb8b104a5a959918d35e65ff05 -#: ../src/Doc/c-api/float.rst:20 +#: c-api/float.rst:20 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python floating point " "type. This is the same object as ``float`` and ``types.FloatType``." msgstr "" # 95c9e3bd73d04f75b5bb8abf94c497f0 -#: ../src/Doc/c-api/float.rst:26 +#: c-api/float.rst:26 msgid "" "Return true if its argument is a :c:type:`PyFloatObject` or a subtype of :c:" "type:`PyFloatObject`." msgstr "" # 00368846c207433cbb5d80debcbdb5a1 -#: ../src/Doc/c-api/float.rst:35 +#: c-api/float.rst:35 msgid "" "Return true if its argument is a :c:type:`PyFloatObject`, but not a subtype " "of :c:type:`PyFloatObject`." msgstr "" # b437c0361bd54164910027c19b5bc972 -#: ../src/Doc/c-api/float.rst:43 +#: c-api/float.rst:43 msgid "" "Create a :c:type:`PyFloatObject` object based on the string value in *str*, " "or *NULL* on failure. The *pend* argument is ignored. It remains only for " @@ -4876,12 +4886,12 @@ msgid "" msgstr "" # 66f65d13be074e5cb155459b32e7c7e5 -#: ../src/Doc/c-api/float.rst:50 +#: c-api/float.rst:50 msgid "Create a :c:type:`PyFloatObject` object from *v*, or *NULL* on failure." msgstr "" # 7770787e5ff8412b9bcc081501e1d626 -#: ../src/Doc/c-api/float.rst:55 +#: c-api/float.rst:55 msgid "" "Return a C :c:type:`double` representation of the contents of *pyfloat*. If " "*pyfloat* is not a Python floating point object but has a :meth:`__float__` " @@ -4891,14 +4901,14 @@ msgid "" msgstr "" # b3e146c025504fdab11f3672b774c011 -#: ../src/Doc/c-api/float.rst:64 +#: c-api/float.rst:64 msgid "" "Return a C :c:type:`double` representation of the contents of *pyfloat*, but " "without error checking." msgstr "" # 8ab7b10a3e0944e19bb905d2a979c61c -#: ../src/Doc/c-api/float.rst:70 +#: c-api/float.rst:70 msgid "" "Return a structseq instance which contains information about the precision, " "minimum and maximum values of a float. It's a thin wrapper around the header " @@ -4906,27 +4916,27 @@ msgid "" msgstr "" # 9e3449653e2e4a89865ce5e27e146cb6 -#: ../src/Doc/c-api/float.rst:79 +#: c-api/float.rst:79 msgid "" "Return the maximum representable finite float *DBL_MAX* as C :c:type:" "`double`." msgstr "" # 9435c6f59a8543c5a3136baacdb01c8a -#: ../src/Doc/c-api/float.rst:86 +#: c-api/float.rst:86 msgid "" "Return the minimum normalized positive float *DBL_MIN* as C :c:type:`double`." msgstr "" # fc6ff06e23754820ab4cc725edba2e80 -#: ../src/Doc/c-api/float.rst:93 +#: c-api/float.rst:93 msgid "" "Clear the float free list. Return the number of items that could not be " "freed." msgstr "" # fa08dc157b624326b229ddd2705657f5 -#: ../src/Doc/c-api/float.rst:101 +#: c-api/float.rst:101 msgid "" "Convert the argument *v* to a string, using the same rules as :func:`str`. " "The length of *buf* should be at least 100." @@ -4934,34 +4944,42 @@ msgstr "" # 26a7870012b844d08bd283618f547178 # 9de892e27d6c4adcbfee0d243303d598 -#: ../src/Doc/c-api/float.rst:104 ../src/Doc/c-api/float.rst:116 +#: c-api/float.rst:104 c-api/float.rst:116 msgid "" "This function is unsafe to call because it writes to a buffer whose length " "it does not know." msgstr "" +#: c-api/float.rst:107 +msgid "Use :func:`PyObject_Str` or :func:`PyOS_double_to_string` instead." +msgstr "" + # 62eb25960db94643b08e6eaf02ac992c -#: ../src/Doc/c-api/float.rst:113 +#: c-api/float.rst:113 msgid "" "Same as PyFloat_AsString, except uses the same rules as :func:`repr`. The " "length of *buf* should be at least 100." msgstr "" -#: ../src/Doc/c-api/function.rst:6 +#: c-api/float.rst:119 +msgid "Use :func:`PyObject_Repr` or :func:`PyOS_double_to_string` instead." +msgstr "" + +#: c-api/function.rst:6 msgid "Function Objects" msgstr "" -#: ../src/Doc/c-api/function.rst:10 +#: c-api/function.rst:10 msgid "There are a few functions specific to Python functions." msgstr "" # ecd4bc0f2fe44577b3d7065e187ba740 -#: ../src/Doc/c-api/function.rst:15 +#: c-api/function.rst:15 msgid "The C structure used for functions." msgstr "" # 220827c38c404678bc2b136ae80ac97f -#: ../src/Doc/c-api/function.rst:22 +#: c-api/function.rst:22 msgid "" "This is an instance of :c:type:`PyTypeObject` and represents the Python " "function type. It is exposed to Python programmers as ``types." @@ -4969,14 +4987,14 @@ msgid "" msgstr "" # ee842a4ef6f848658be9c650a497e5de -#: ../src/Doc/c-api/function.rst:28 +#: c-api/function.rst:28 msgid "" "Return true if *o* is a function object (has type :c:data:" "`PyFunction_Type`). The parameter must not be *NULL*." msgstr "" # aa80affddd2448cebf034ea571452eed -#: ../src/Doc/c-api/function.rst:34 +#: c-api/function.rst:34 msgid "" "Return a new function object associated with the code object *code*. " "*globals* must be a dictionary with the global variables accessible to the " @@ -4984,24 +5002,24 @@ msgid "" msgstr "" # 1f15320a78f443e28420325974290fed -#: ../src/Doc/c-api/function.rst:37 +#: c-api/function.rst:37 msgid "" "The function's docstring, name and *__module__* are retrieved from the code " "object, the argument defaults and closure are set to *NULL*." msgstr "" # e3520be368034f82981f9a77ed2912be -#: ../src/Doc/c-api/function.rst:43 +#: c-api/function.rst:43 msgid "Return the code object associated with the function object *op*." msgstr "" # 88fb240de7ae4f6dadd18d1745eb4843 -#: ../src/Doc/c-api/function.rst:48 +#: c-api/function.rst:48 msgid "Return the globals dictionary associated with the function object *op*." msgstr "" # dd82490874b84ac583259211eb4854d4 -#: ../src/Doc/c-api/function.rst:53 +#: c-api/function.rst:53 msgid "" "Return the *__module__* attribute of the function object *op*. This is " "normally a string containing the module name, but can be set to any other " @@ -5009,14 +5027,14 @@ msgid "" msgstr "" # 8f853d6f2eb943e3999ca5e730f93fe5 -#: ../src/Doc/c-api/function.rst:60 +#: c-api/function.rst:60 msgid "" "Return the argument default values of the function object *op*. This can be " "a tuple of arguments or *NULL*." msgstr "" # d3a13ca1358e4f49b476a84baa14990a -#: ../src/Doc/c-api/function.rst:66 +#: c-api/function.rst:66 msgid "" "Set the argument default values for the function object *op*. *defaults* " "must be *Py_None* or a tuple." @@ -5024,29 +5042,29 @@ msgstr "" # 8b46c4ae82e740af9e7421bdf4e557a3 # 9c48cabcf44942559156a036d63ffae4 -#: ../src/Doc/c-api/function.rst:69 ../src/Doc/c-api/function.rst:83 +#: c-api/function.rst:69 c-api/function.rst:83 msgid "Raises :exc:`SystemError` and returns ``-1`` on failure." msgstr "" # 2c5240d989af478db4bffe644223d694 -#: ../src/Doc/c-api/function.rst:74 +#: c-api/function.rst:74 msgid "" "Return the closure associated with the function object *op*. This can be " "*NULL* or a tuple of cell objects." msgstr "" # 9bc741be67934c5ab79b7c4c63341099 -#: ../src/Doc/c-api/function.rst:80 +#: c-api/function.rst:80 msgid "" "Set the closure associated with the function object *op*. *closure* must be " "*Py_None* or a tuple of cell objects." msgstr "" -#: ../src/Doc/c-api/gcsupport.rst:6 +#: c-api/gcsupport.rst:6 msgid "Supporting Cyclic Garbage Collection" msgstr "" -#: ../src/Doc/c-api/gcsupport.rst:8 +#: c-api/gcsupport.rst:8 msgid "" "Python's support for detecting and collecting garbage which involves " "circular references requires support from object types which are \"containers" @@ -5057,7 +5075,7 @@ msgid "" msgstr "" # 1edfa2df4afd476c9f491817647d1547 -#: ../src/Doc/c-api/gcsupport.rst:18 +#: c-api/gcsupport.rst:18 msgid "" "To create a container type, the :c:member:`~PyTypeObject.tp_flags` field of " "the type object must include the :const:`Py_TPFLAGS_HAVE_GC` and provide an " @@ -5066,54 +5084,60 @@ msgid "" "implementation must also be provided." msgstr "" -#: ../src/Doc/c-api/gcsupport.rst:27 +#: c-api/gcsupport.rst:27 msgid "" "Objects with a type with this flag set must conform with the rules " "documented here. For convenience these objects will be referred to as " "container objects." msgstr "" -#: ../src/Doc/c-api/gcsupport.rst:31 +#: c-api/gcsupport.rst:31 msgid "Constructors for container types must conform to two rules:" msgstr "" # 280a8250f41548dcbc4e627aaa5ff1b0 -#: ../src/Doc/c-api/gcsupport.rst:33 +#: c-api/gcsupport.rst:33 msgid "" "The memory for the object must be allocated using :c:func:`PyObject_GC_New` " "or :c:func:`PyObject_GC_NewVar`." msgstr "" # d7cf5f0b60f747439095f868ac201d0c -#: ../src/Doc/c-api/gcsupport.rst:36 +#: c-api/gcsupport.rst:36 msgid "" "Once all the fields which may contain references to other containers are " "initialized, it must call :c:func:`PyObject_GC_Track`." msgstr "" # 30336de35da942449315b69e07749a97 -#: ../src/Doc/c-api/gcsupport.rst:42 +#: c-api/gcsupport.rst:42 msgid "" "Analogous to :c:func:`PyObject_New` but for container objects with the :" "const:`Py_TPFLAGS_HAVE_GC` flag set." msgstr "" # 2c7e79c053384ae39c7a31fe09bd9b5a -#: ../src/Doc/c-api/gcsupport.rst:48 +#: c-api/gcsupport.rst:48 msgid "" "Analogous to :c:func:`PyObject_NewVar` but for container objects with the :" "const:`Py_TPFLAGS_HAVE_GC` flag set." msgstr "" # e58632ba85b6469db76080bc72870348 -#: ../src/Doc/c-api/gcsupport.rst:58 +#: c-api/gcsupport.rst:58 msgid "" "Resize an object allocated by :c:func:`PyObject_NewVar`. Returns the " "resized object or *NULL* on failure." msgstr "" +#: c-api/gcsupport.rst:61 c-api/string.rst:237 c-api/tuple.rst:155 +msgid "" +"This function used an :c:type:`int` type for *newsize*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + # 62ac4f27781d4f019708bf1c6dfb1f57 -#: ../src/Doc/c-api/gcsupport.rst:68 +#: c-api/gcsupport.rst:68 msgid "" "Adds the object *op* to the set of container objects tracked by the " "collector. The collector can run at unexpected times so objects must be " @@ -5123,40 +5147,40 @@ msgid "" msgstr "" # 463de6236e2a438f99df9962ea5c29f0 -#: ../src/Doc/c-api/gcsupport.rst:77 +#: c-api/gcsupport.rst:77 msgid "" "A macro version of :c:func:`PyObject_GC_Track`. It should not be used for " "extension modules." msgstr "" -#: ../src/Doc/c-api/gcsupport.rst:80 +#: c-api/gcsupport.rst:80 msgid "" "Similarly, the deallocator for the object must conform to a similar pair of " "rules:" msgstr "" # d1e07004144b4afea4d0c9da2865098f -#: ../src/Doc/c-api/gcsupport.rst:83 +#: c-api/gcsupport.rst:83 msgid "" "Before fields which refer to other containers are invalidated, :c:func:" "`PyObject_GC_UnTrack` must be called." msgstr "" # c2e2423c09fe4243b8d4b00ef6cbdc71 -#: ../src/Doc/c-api/gcsupport.rst:86 +#: c-api/gcsupport.rst:86 msgid "" "The object's memory must be deallocated using :c:func:`PyObject_GC_Del`." msgstr "" # d65ffd8f236c41d59c1a6fa32932320a -#: ../src/Doc/c-api/gcsupport.rst:91 +#: c-api/gcsupport.rst:91 msgid "" "Releases memory allocated to an object using :c:func:`PyObject_GC_New` or :c:" "func:`PyObject_GC_NewVar`." msgstr "" # 308c96b086af4a4fb7382ddecda49dbc -#: ../src/Doc/c-api/gcsupport.rst:97 +#: c-api/gcsupport.rst:97 msgid "" "Remove the object *op* from the set of container objects tracked by the " "collector. Note that :c:func:`PyObject_GC_Track` can be called again on " @@ -5167,21 +5191,21 @@ msgid "" msgstr "" # 9aa66b523fd7496bb2516d90a6faebff -#: ../src/Doc/c-api/gcsupport.rst:106 +#: c-api/gcsupport.rst:106 msgid "" "A macro version of :c:func:`PyObject_GC_UnTrack`. It should not be used for " "extension modules." msgstr "" # 56cc59f0697d4af7ac54d409e6d4589b -#: ../src/Doc/c-api/gcsupport.rst:109 +#: c-api/gcsupport.rst:109 msgid "" "The :c:member:`~PyTypeObject.tp_traverse` handler accepts a function " "parameter of this type:" msgstr "" # ec4e7c76955848c38c822508f655e344 -#: ../src/Doc/c-api/gcsupport.rst:114 +#: c-api/gcsupport.rst:114 msgid "" "Type of the visitor function passed to the :c:member:`~PyTypeObject." "tp_traverse` handler. The function should be called with an object to " @@ -5192,14 +5216,14 @@ msgid "" msgstr "" # 4577b81c7750441695dc6dd92b0330ff -#: ../src/Doc/c-api/gcsupport.rst:121 +#: c-api/gcsupport.rst:121 msgid "" "The :c:member:`~PyTypeObject.tp_traverse` handler must have the following " "type:" msgstr "" # b75ca9dec8064d55bf2c94c76f287770 -#: ../src/Doc/c-api/gcsupport.rst:126 +#: c-api/gcsupport.rst:126 msgid "" "Traversal function for a container object. Implementations must call the " "*visit* function for each object directly contained by *self*, with the " @@ -5210,7 +5234,7 @@ msgid "" msgstr "" # 5f9da0be74594dd2952f02ec24f0c906 -#: ../src/Doc/c-api/gcsupport.rst:133 +#: c-api/gcsupport.rst:133 msgid "" "To simplify writing :c:member:`~PyTypeObject.tp_traverse` handlers, a :c:" "func:`Py_VISIT` macro is provided. In order to use this macro, the :c:" @@ -5219,7 +5243,7 @@ msgid "" msgstr "" # fdbcdbd60fff489fb8ab51ade52ad6c6 -#: ../src/Doc/c-api/gcsupport.rst:140 +#: c-api/gcsupport.rst:140 msgid "" "Call the *visit* callback, with arguments *o* and *arg*. If *visit* returns " "a non-zero value, then return it. Using this macro, :c:member:" @@ -5227,14 +5251,14 @@ msgid "" msgstr "" # 59157513a429409fb210a6097f6bbf04 -#: ../src/Doc/c-api/gcsupport.rst:154 +#: c-api/gcsupport.rst:154 msgid "" "The :c:member:`~PyTypeObject.tp_clear` handler must be of the :c:type:" "`inquiry` type, or *NULL* if the object is immutable." msgstr "" # 48c6e050579f4969897f49d820d28d77 -#: ../src/Doc/c-api/gcsupport.rst:160 +#: c-api/gcsupport.rst:160 msgid "" "Drop references that may have created reference cycles. Immutable objects " "do not have to define this method since they can never directly create " @@ -5244,12 +5268,12 @@ msgid "" "in a reference cycle." msgstr "" -#: ../src/Doc/c-api/gen.rst:6 +#: c-api/gen.rst:6 msgid "Generator Objects" msgstr "" # 319c7c45d96740cab9efbbf4a6a51e00 -#: ../src/Doc/c-api/gen.rst:8 +#: c-api/gen.rst:8 msgid "" "Generator objects are what Python uses to implement generator iterators. " "They are normally created by iterating over a function that yields values, " @@ -5257,41 +5281,40 @@ msgid "" msgstr "" # f17f9d78afef41bf95d493f7adc143e1 -#: ../src/Doc/c-api/gen.rst:15 +#: c-api/gen.rst:15 msgid "The C structure used for generator objects." msgstr "" -# 4af1d852708646c68827d7b99eaff5a3 -#: ../src/Doc/c-api/gen.rst:20 -msgid "The type object corresponding to generator objects" +#: c-api/gen.rst:20 +msgid "The type object corresponding to generator objects." msgstr "" # df4ab5874c3a43ef942d374a3078fc7e -#: ../src/Doc/c-api/gen.rst:25 +#: c-api/gen.rst:25 msgid "Return true if *ob* is a generator object; *ob* must not be *NULL*." msgstr "" # 55345bdeb1e748c398c668203a58c6f9 -#: ../src/Doc/c-api/gen.rst:30 +#: c-api/gen.rst:30 msgid "" "Return true if *ob*'s type is *PyGen_Type* is a generator object; *ob* must " "not be *NULL*." msgstr "" # 699ac2bd14ec4371b9f224ab2e13c5dd -#: ../src/Doc/c-api/gen.rst:36 +#: c-api/gen.rst:36 msgid "" "Create and return a new generator object based on the *frame* object. A " "reference to *frame* is stolen by this function. The parameter must not be " "*NULL*." msgstr "" -#: ../src/Doc/c-api/import.rst:6 +#: c-api/import.rst:6 msgid "Importing Modules" msgstr "" # a01f64d6f7b24d2d92fd6ce79cc1879c -#: ../src/Doc/c-api/import.rst:16 +#: c-api/import.rst:16 msgid "" "This is a simplified interface to :c:func:`PyImport_ImportModuleEx` below, " "leaving the *globals* and *locals* arguments set to *NULL* and *level* set " @@ -5308,8 +5331,16 @@ msgid "" "longer leaves the module in ``sys.modules``." msgstr "" +#: c-api/import.rst:30 c-api/import.rst:64 +msgid "Failing imports remove incomplete module objects." +msgstr "" + +#: c-api/import.rst:33 c-api/import.rst:97 +msgid "Always uses absolute imports." +msgstr "" + # 8ce27447a76d4cd99b30443863a977af -#: ../src/Doc/c-api/import.rst:39 +#: c-api/import.rst:39 msgid "" "This version of :c:func:`PyImport_ImportModule` does not block. It's " "intended to be used in C functions that import other modules to execute a " @@ -5322,7 +5353,7 @@ msgstr "" # 00ae29922fcc47aa8ba55a16501928d9 # 6cac3a35de3b47a2aafd742460aba23a -#: ../src/Doc/c-api/import.rst:54 ../src/Doc/c-api/import.rst:74 +#: c-api/import.rst:54 c-api/import.rst:74 msgid "" "Import a module. This is best described by referring to the built-in Python " "function :func:`__import__`, as the standard :func:`__import__` function " @@ -5330,7 +5361,7 @@ msgid "" msgstr "" # 2bf5377bc2844abb91200cd907c2b305 -#: ../src/Doc/c-api/import.rst:58 +#: c-api/import.rst:58 msgid "" "The return value is a new reference to the imported module or top-level " "package, or *NULL* with an exception set on failure (before Python 2.4, the " @@ -5339,8 +5370,14 @@ msgid "" "level package, unless a non-empty *fromlist* was given." msgstr "" +#: c-api/import.rst:67 +msgid "" +"The function is an alias for :c:func:`PyImport_ImportModuleLevel` with -1 as " +"level, meaning relative import." +msgstr "" + # 08291ccba6d04ee49a48d314d553d830 -#: ../src/Doc/c-api/import.rst:78 +#: c-api/import.rst:78 msgid "" "The return value is a new reference to the imported module or top-level " "package, or *NULL* with an exception set on failure. Like for :func:" @@ -5349,7 +5386,7 @@ msgid "" msgstr "" # 38a6db984f5d4489b274dae3f658dc3c -#: ../src/Doc/c-api/import.rst:92 +#: c-api/import.rst:92 msgid "" "This is a higher-level interface that calls the current \"import hook " "function\". It invokes the :func:`__import__` function from the " @@ -5359,7 +5396,7 @@ msgid "" msgstr "" # 9ba069c9d65b4e2aa5573d23cc8d2aff -#: ../src/Doc/c-api/import.rst:105 +#: c-api/import.rst:105 msgid "" "Reload a module. This is best described by referring to the built-in Python " "function :func:`reload`, as the standard :func:`reload` function calls this " @@ -5368,7 +5405,7 @@ msgid "" msgstr "" # 9b55d21bb44a481c98ee176daf5d72f7 -#: ../src/Doc/c-api/import.rst:113 +#: c-api/import.rst:113 msgid "" "Return the module object corresponding to a module name. The *name* " "argument may be of the form ``package.module``. First check the modules " @@ -5377,7 +5414,7 @@ msgid "" msgstr "" # 35e76454a8874d77a5b0f1be96f908dc -#: ../src/Doc/c-api/import.rst:120 +#: c-api/import.rst:120 msgid "" "This function does not load or import the module; if the module wasn't " "already loaded, you will get an empty module object. Use :c:func:" @@ -5387,7 +5424,7 @@ msgid "" msgstr "" # 5a90bee5616e4497b9b77dfe74a56eae -#: ../src/Doc/c-api/import.rst:130 +#: c-api/import.rst:130 msgid "" "Given a module name (possibly of the form ``package.module``) and a code " "object read from a Python bytecode file or obtained from the built-in " @@ -5403,35 +5440,39 @@ msgid "" msgstr "" # e26e0270a5a7453d9844019560aa3e7a -#: ../src/Doc/c-api/import.rst:141 +#: c-api/import.rst:141 msgid "" "The module's :attr:`__file__` attribute will be set to the code object's :c:" "member:`co_filename`." msgstr "" # 15af7810b6fb439b860b4c106ec676a9 -#: ../src/Doc/c-api/import.rst:144 +#: c-api/import.rst:144 msgid "" "This function will reload the module if it was already imported. See :c:" "func:`PyImport_ReloadModule` for the intended way to reload a module." msgstr "" # fa69f4b211be4d75a211d730734a6629 -#: ../src/Doc/c-api/import.rst:147 +#: c-api/import.rst:147 msgid "" "If *name* points to a dotted name of the form ``package.module``, any " "package structures not already created will still not be created." msgstr "" +#: c-api/import.rst:150 +msgid "*name* is removed from :attr:`sys.modules` in error cases." +msgstr "" + # 70107fbe94ba4fff84f22c7c840154e6 -#: ../src/Doc/c-api/import.rst:156 +#: c-api/import.rst:156 msgid "" "Like :c:func:`PyImport_ExecCodeModule`, but the :attr:`__file__` attribute " "of the module object is set to *pathname* if it is non-``NULL``." msgstr "" # 20fc519c05fc42cd81225e1b04980d2d -#: ../src/Doc/c-api/import.rst:162 +#: c-api/import.rst:162 msgid "" "Return the magic number for Python bytecode files (a.k.a. :file:`.pyc` and :" "file:`.pyo` files). The magic number should be present in the first four " @@ -5439,14 +5480,14 @@ msgid "" msgstr "" # 8b86258be4674e699cfc4ae144ea833a -#: ../src/Doc/c-api/import.rst:169 +#: c-api/import.rst:169 msgid "" "Return the dictionary used for the module administration (a.k.a. ``sys." "modules``). Note that this is a per-interpreter variable." msgstr "" # ccd0bfc24897453ea7e8d6923f2b3e03 -#: ../src/Doc/c-api/import.rst:175 +#: c-api/import.rst:175 msgid "" "Return an importer object for a :data:`sys.path`/:attr:`pkg.__path__` item " "*path*, possibly by fetching it from the :data:`sys.path_importer_cache` " @@ -5458,28 +5499,28 @@ msgid "" msgstr "" # af49c3f41af84c3db64a73ae9b137bd0 -#: ../src/Doc/c-api/import.rst:188 +#: c-api/import.rst:188 msgid "Initialize the import mechanism. For internal use only." msgstr "" # f6da1f9b86b949d8880ab789c6601885 -#: ../src/Doc/c-api/import.rst:193 +#: c-api/import.rst:193 msgid "Empty the module table. For internal use only." msgstr "" # af2ccd091b874d5eb97ce3d84250a0f3 -#: ../src/Doc/c-api/import.rst:198 +#: c-api/import.rst:198 msgid "Finalize the import mechanism. For internal use only." msgstr "" # 6801efcd7b75443a90e5c106e2e74a01 # 81dfdb3341104241882dfe755cb6a5da -#: ../src/Doc/c-api/import.rst:203 ../src/Doc/c-api/import.rst:208 +#: c-api/import.rst:203 c-api/import.rst:208 msgid "For internal use only." msgstr "" # 399b191705e144ca90740079a2bdc4f0 -#: ../src/Doc/c-api/import.rst:213 +#: c-api/import.rst:213 msgid "" "Load a frozen module named *name*. Return ``1`` for success, ``0`` if the " "module is not found, and ``-1`` with an exception set if the initialization " @@ -5489,7 +5530,7 @@ msgid "" msgstr "" # e37ebade9e03455586bbc8ed121d1901 -#: ../src/Doc/c-api/import.rst:224 +#: c-api/import.rst:224 msgid "" "This is the structure type definition for frozen module descriptors, as " "generated by the :program:`freeze` utility (see :file:`Tools/freeze/` in the " @@ -5498,7 +5539,7 @@ msgid "" msgstr "" # 8bf8debaea4241c084ba431c157a92e2 -#: ../src/Doc/c-api/import.rst:238 +#: c-api/import.rst:238 msgid "" "This pointer is initialized to point to an array of :c:type:`struct _frozen` " "records, terminated by one whose members are all *NULL* or zero. When a " @@ -5508,7 +5549,7 @@ msgid "" msgstr "" # 3ec2106d063d497a87faa91334c9a123 -#: ../src/Doc/c-api/import.rst:246 +#: c-api/import.rst:246 msgid "" "Add a single module to the existing table of built-in modules. This is a " "convenience wrapper around :c:func:`PyImport_ExtendInittab`, returning " @@ -5519,7 +5560,7 @@ msgid "" msgstr "" # 432690bea89f463dae506ecb451812e5 -#: ../src/Doc/c-api/import.rst:256 +#: c-api/import.rst:256 msgid "" "Structure describing a single entry in the list of built-in modules. Each " "of these structures gives the name and initialization function for a module " @@ -5530,7 +5571,7 @@ msgid "" msgstr "" # 4f310c256b724dffaa990961463e0dd7 -#: ../src/Doc/c-api/import.rst:271 +#: c-api/import.rst:271 msgid "" "Add a collection of modules to the table of built-in modules. The *newtab* " "array must end with a sentinel entry which contains *NULL* for the :attr:" @@ -5541,11 +5582,11 @@ msgid "" "`Py_Initialize`." msgstr "" -#: ../src/Doc/c-api/index.rst:5 +#: c-api/index.rst:5 msgid "Python/C API Reference Manual" msgstr "" -#: ../src/Doc/c-api/index.rst:7 +#: c-api/index.rst:7 msgid "" "This manual documents the API used by C and C++ programmers who want to " "write extension modules or embed Python. It is a companion to :ref:" @@ -5553,17 +5594,17 @@ msgid "" "writing but does not document the API functions in detail." msgstr "" -#: ../src/Doc/c-api/init.rst:8 +#: c-api/init.rst:8 msgid "Initialization, Finalization, and Threads" msgstr "" # 5942f7ee7e834286b4599effa3a59259 -#: ../src/Doc/c-api/init.rst:12 +#: c-api/init.rst:12 msgid "Initializing and finalizing the interpreter" msgstr "" # 594c0ed7dea741ff8260ecf5319852cf -#: ../src/Doc/c-api/init.rst:32 +#: c-api/init.rst:32 msgid "" "Initialize the Python interpreter. In an application embedding Python, " "this should be called before using any other Python/C API functions; with " @@ -5579,7 +5620,7 @@ msgid "" msgstr "" # 4730806aab62447f959c12e85741fc92 -#: ../src/Doc/c-api/init.rst:46 +#: c-api/init.rst:46 msgid "" "This function works like :c:func:`Py_Initialize` if *initsigs* is 1. If " "*initsigs* is 0, it skips initialization registration of signal handlers, " @@ -5587,7 +5628,7 @@ msgid "" msgstr "" # e78f307055af4f1aacc83fed7502f7a7 -#: ../src/Doc/c-api/init.rst:55 +#: c-api/init.rst:55 msgid "" "Return true (nonzero) when the Python interpreter has been initialized, " "false (zero) if not. After :c:func:`Py_Finalize` is called, this returns " @@ -5595,7 +5636,7 @@ msgid "" msgstr "" # 8f1bef520636490b8927798a6c094afd -#: ../src/Doc/c-api/init.rst:62 +#: c-api/init.rst:62 msgid "" "Undo all initializations made by :c:func:`Py_Initialize` and subsequent use " "of Python/C API functions, and destroy all sub-interpreters (see :c:func:" @@ -5607,7 +5648,7 @@ msgid "" msgstr "" # 51b00b00391d4223aee45aab88c13fcd -#: ../src/Doc/c-api/init.rst:70 +#: c-api/init.rst:70 msgid "" "This function is provided for a number of reasons. An embedding application " "might want to restart Python without having to restart the application " @@ -5619,7 +5660,7 @@ msgid "" msgstr "" # 2460ef472a834555a626fd52af1e15b3 -#: ../src/Doc/c-api/init.rst:78 +#: c-api/init.rst:78 msgid "" "**Bugs and caveats:** The destruction of modules and objects in modules is " "done in random order; this may cause destructors (:meth:`__del__` methods) " @@ -5635,12 +5676,12 @@ msgid "" msgstr "" # 65e9775fd5f64b8fb0c88bcf0da22491 -#: ../src/Doc/c-api/init.rst:91 +#: c-api/init.rst:91 msgid "Process-wide parameters" msgstr "" # 88c46775d77f4437aef6dada8cdec12a -#: ../src/Doc/c-api/init.rst:101 +#: c-api/init.rst:101 msgid "" "This function should be called before :c:func:`Py_Initialize` is called for " "the first time, if it is called at all. It tells the interpreter the value " @@ -5654,7 +5695,7 @@ msgid "" msgstr "" # 0e71308a19f146fabe2e49d732642902 -#: ../src/Doc/c-api/init.rst:116 +#: c-api/init.rst:116 msgid "" "Return the program name set with :c:func:`Py_SetProgramName`, or the " "default. The returned string points into static storage; the caller should " @@ -5662,7 +5703,7 @@ msgid "" msgstr "" # 93441093ea84472899a74adb52ad9a20 -#: ../src/Doc/c-api/init.rst:123 +#: c-api/init.rst:123 msgid "" "Return the *prefix* for installed platform-independent files. This is " "derived through a number of complicated rules from the program name set " @@ -5677,7 +5718,7 @@ msgid "" msgstr "" # 22bb0517ce0a43808b374cb699ac2da8 -#: ../src/Doc/c-api/init.rst:136 +#: c-api/init.rst:136 msgid "" "Return the *exec-prefix* for installed platform-*dependent* files. This is " "derived through a number of complicated rules from the program name set " @@ -5692,7 +5733,7 @@ msgid "" msgstr "" # 924befbd83dd4bb88b70c62814cc3cd2 -#: ../src/Doc/c-api/init.rst:146 +#: c-api/init.rst:146 msgid "" "Background: The exec-prefix differs from the prefix when platform dependent " "files (such as executables and shared libraries) are installed in a " @@ -5702,7 +5743,7 @@ msgid "" msgstr "" # f2d7e1327de14b4097712a7ca7b21a8e -#: ../src/Doc/c-api/init.rst:152 +#: c-api/init.rst:152 msgid "" "Generally speaking, a platform is a combination of hardware and software " "families, e.g. Sparc machines running the Solaris 2.x operating system are " @@ -5717,7 +5758,7 @@ msgid "" msgstr "" # bc79838ee35048b183940900d3eb5ca2 -#: ../src/Doc/c-api/init.rst:163 +#: c-api/init.rst:163 msgid "" "System administrators will know how to configure the :program:`mount` or :" "program:`automount` programs to share :file:`/usr/local` between platforms " @@ -5726,7 +5767,7 @@ msgid "" msgstr "" # bedc2e3771624d57a7c139d42eeea342 -#: ../src/Doc/c-api/init.rst:175 +#: c-api/init.rst:175 msgid "" "Return the full program name of the Python executable; this is computed as " "a side-effect of deriving the default module search path from the program " @@ -5736,7 +5777,7 @@ msgid "" msgstr "" # 0a8b7488687b4ea9ba428c4158a76321 -#: ../src/Doc/c-api/init.rst:188 +#: c-api/init.rst:188 msgid "" "Return the default module search path; this is computed from the program " "name (set by :c:func:`Py_SetProgramName` above) and some environment " @@ -5750,14 +5791,14 @@ msgid "" msgstr "" # 7b6b7986049a4a549d818dbd154c05ea -#: ../src/Doc/c-api/init.rst:203 +#: c-api/init.rst:203 msgid "" "Return the version of this Python interpreter. This is a string that looks " "something like ::" msgstr "" # fbe841314c97438f86fcb507a4966462 -#: ../src/Doc/c-api/init.rst:210 +#: c-api/init.rst:210 msgid "" "The first word (up to the first space character) is the current Python " "version; the first three characters are the major and minor version " @@ -5767,7 +5808,7 @@ msgid "" msgstr "" # 929481f5ca8741e3aa25f9ae90b87566 -#: ../src/Doc/c-api/init.rst:220 +#: c-api/init.rst:220 msgid "" "Return the platform identifier for the current platform. On Unix, this is " "formed from the \"official\" name of the operating system, converted to " @@ -5779,26 +5820,26 @@ msgid "" msgstr "" # 302571bbe39c4f49a4153bd346665b2d -#: ../src/Doc/c-api/init.rst:231 +#: c-api/init.rst:231 msgid "" "Return the official copyright string for the current Python version, for " "example" msgstr "" # 2d665ab4ae7a43ff8bb478b920881099 -#: ../src/Doc/c-api/init.rst:233 +#: c-api/init.rst:233 msgid "``'Copyright 1991-1995 Stichting Mathematisch Centrum, Amsterdam'``" msgstr "" # 0e5573ae80f1493ea7da14d21f8efce4 -#: ../src/Doc/c-api/init.rst:237 +#: c-api/init.rst:237 msgid "" "The returned string points into static storage; the caller should not modify " "its value. The value is available to Python code as ``sys.copyright``." msgstr "" # e63a7f39713f4cf696604b854e56a04a -#: ../src/Doc/c-api/init.rst:243 +#: c-api/init.rst:243 msgid "" "Return an indication of the compiler used to build the current Python " "version, in square brackets, for example::" @@ -5806,7 +5847,7 @@ msgstr "" # b3c2091a97d84fbb952618e12e6fa2d5 # df3f2f57544f447d8bf9e7f1ba3ddcd0 -#: ../src/Doc/c-api/init.rst:250 ../src/Doc/c-api/init.rst:264 +#: c-api/init.rst:250 c-api/init.rst:264 msgid "" "The returned string points into static storage; the caller should not modify " "its value. The value is available to Python code as part of the variable " @@ -5814,14 +5855,14 @@ msgid "" msgstr "" # 0ac70094af0b44cd940dc76363ade22b -#: ../src/Doc/c-api/init.rst:257 +#: c-api/init.rst:257 msgid "" "Return information about the sequence number and build date and time of the " "current Python interpreter instance, for example ::" msgstr "" # 670dff176c4e42ebaf3b51e640f30dab -#: ../src/Doc/c-api/init.rst:276 +#: c-api/init.rst:276 msgid "" "Set :data:`sys.argv` based on *argc* and *argv*. These parameters are " "similar to those passed to the program's :c:func:`main` function with the " @@ -5833,7 +5874,7 @@ msgid "" msgstr "" # d04fc3b3d948451d8f5e72d2052ffe97 -#: ../src/Doc/c-api/init.rst:284 +#: c-api/init.rst:284 msgid "" "If *updatepath* is zero, this is all the function does. If *updatepath* is " "non-zero, the function also modifies :data:`sys.path` according to the " @@ -5841,7 +5882,7 @@ msgid "" msgstr "" # 0247763a26314444b6d3fb3a82474ed3 -#: ../src/Doc/c-api/init.rst:288 +#: c-api/init.rst:288 msgid "" "If the name of an existing script is passed in ``argv[0]``, the absolute " "path of the directory where the script is located is prepended to :data:`sys." @@ -5849,7 +5890,7 @@ msgid "" msgstr "" # 9e773bc5bd184da591ad451777f0d59d -#: ../src/Doc/c-api/init.rst:291 +#: c-api/init.rst:291 msgid "" "Otherwise (that is, if *argc* is 0 or ``argv[0]`` doesn't point to an " "existing file name), an empty string is prepended to :data:`sys.path`, which " @@ -5857,7 +5898,7 @@ msgid "" msgstr "" # 7b13fdd5bec94e0888c9cfedd743a262 -#: ../src/Doc/c-api/init.rst:297 +#: c-api/init.rst:297 msgid "" "It is recommended that applications embedding the Python interpreter for " "purposes other than executing a single script pass 0 as *updatepath*, and " @@ -5866,7 +5907,7 @@ msgid "" msgstr "" # fce5c3f7e370497a9e8f09de0b8ded57 -#: ../src/Doc/c-api/init.rst:302 +#: c-api/init.rst:302 msgid "" "On versions before 2.6.6, you can achieve the same effect by manually " "popping the first :data:`sys.path` element after having called :c:func:" @@ -5874,14 +5915,14 @@ msgid "" msgstr "" # d841765183d443d1bba65e3cb97ec1d5 -#: ../src/Doc/c-api/init.rst:316 +#: c-api/init.rst:316 msgid "" "This function works like :c:func:`PySys_SetArgvEx` with *updatepath* set to " "1." msgstr "" # 68a9a27bbc37482d8c016d277bc8f9fe -#: ../src/Doc/c-api/init.rst:321 +#: c-api/init.rst:321 msgid "" "Set the default \"home\" directory, that is, the location of the standard " "Python libraries. See :envvar:`PYTHONHOME` for the meaning of the argument " @@ -5889,7 +5930,7 @@ msgid "" msgstr "" # 60e0e24c404d460cbec49777677700fc -#: ../src/Doc/c-api/init.rst:325 +#: c-api/init.rst:325 msgid "" "The argument should point to a zero-terminated character string in static " "storage whose contents will not change for the duration of the program's " @@ -5898,19 +5939,19 @@ msgid "" msgstr "" # 01a74568760d43eda26fe780178d6df8 -#: ../src/Doc/c-api/init.rst:333 +#: c-api/init.rst:333 msgid "" "Return the default \"home\", that is, the value set by a previous call to :c:" "func:`Py_SetPythonHome`, or the value of the :envvar:`PYTHONHOME` " "environment variable if it is set." msgstr "" -#: ../src/Doc/c-api/init.rst:341 +#: c-api/init.rst:341 msgid "Thread State and the Global Interpreter Lock" msgstr "" # c32db2cc974746e5ad9c44e7917ee7f9 -#: ../src/Doc/c-api/init.rst:349 +#: c-api/init.rst:349 msgid "" "The Python interpreter is not fully thread-safe. In order to support multi-" "threaded Python programs, there's a global lock, called the :term:`global " @@ -5923,7 +5964,7 @@ msgid "" msgstr "" # 2aa1f41e035b4cac8350a6022aa33b69 -#: ../src/Doc/c-api/init.rst:359 +#: c-api/init.rst:359 msgid "" "Therefore, the rule exists that only the thread that has acquired the :term:" "`GIL` may operate on Python objects or call Python/C API functions. In order " @@ -5934,7 +5975,7 @@ msgid "" msgstr "" # 67586f788b284e96a5a231672661477b -#: ../src/Doc/c-api/init.rst:370 +#: c-api/init.rst:370 msgid "" "The Python interpreter keeps some thread-specific bookkeeping information " "inside a data structure called :c:type:`PyThreadState`. There's also one " @@ -5943,23 +5984,23 @@ msgid "" msgstr "" # dcf3657280da41e4b133eab9086264be -#: ../src/Doc/c-api/init.rst:376 +#: c-api/init.rst:376 msgid "Releasing the GIL from extension code" msgstr "" # b7860765ba8a41bc9585f5bb16d18c22 -#: ../src/Doc/c-api/init.rst:378 +#: c-api/init.rst:378 msgid "" "Most extension code manipulating the :term:`GIL` has the following simple " "structure::" msgstr "" -#: ../src/Doc/c-api/init.rst:387 +#: c-api/init.rst:387 msgid "This is so common that a pair of macros exists to simplify it::" msgstr "" # 68505f7811d649c69ebabbcdb6c3b170 -#: ../src/Doc/c-api/init.rst:397 +#: c-api/init.rst:397 msgid "" "The :c:macro:`Py_BEGIN_ALLOW_THREADS` macro opens a new block and declares a " "hidden local variable; the :c:macro:`Py_END_ALLOW_THREADS` macro closes the " @@ -5967,14 +6008,14 @@ msgid "" "thread support (they simply have an empty expansion)." msgstr "" -#: ../src/Doc/c-api/init.rst:402 +#: c-api/init.rst:402 msgid "" "When thread support is enabled, the block above expands to the following " "code::" msgstr "" # 07ea1dd0892d4389ab654f831da05685 -#: ../src/Doc/c-api/init.rst:414 +#: c-api/init.rst:414 msgid "" "Here is how these functions work: the global interpreter lock is used to " "protect the pointer to the current thread state. When releasing the lock " @@ -5986,7 +6027,7 @@ msgid "" msgstr "" # a435578e55c74addae413aa5bc0833be -#: ../src/Doc/c-api/init.rst:423 +#: c-api/init.rst:423 msgid "" "Calling system I/O functions is the most common use case for releasing the " "GIL, but it can also be useful before calling long-running computations " @@ -5997,12 +6038,12 @@ msgid "" msgstr "" # ee26a6a26e974a69be87de058b1a266a -#: ../src/Doc/c-api/init.rst:434 +#: c-api/init.rst:434 msgid "Non-Python created threads" msgstr "" # 8d5e2398328d426689f275881dab3d37 -#: ../src/Doc/c-api/init.rst:436 +#: c-api/init.rst:436 msgid "" "When threads are created using the dedicated Python APIs (such as the :mod:" "`threading` module), a thread state is automatically associated to them and " @@ -6013,7 +6054,7 @@ msgid "" msgstr "" # b61bc2ecdc7b4a14a4675a291bcdee35 -#: ../src/Doc/c-api/init.rst:443 +#: c-api/init.rst:443 msgid "" "If you need to call Python code from these threads (often this will be part " "of a callback API provided by the aforementioned third-party library), you " @@ -6025,7 +6066,7 @@ msgid "" msgstr "" # 5d4ed33f17924ebba38932bd4549184c -#: ../src/Doc/c-api/init.rst:451 +#: c-api/init.rst:451 msgid "" "The :c:func:`PyGILState_Ensure` and :c:func:`PyGILState_Release` functions " "do all of the above automatically. The typical idiom for calling into " @@ -6033,7 +6074,7 @@ msgid "" msgstr "" # c1093285747945ceb5b449f34d54212a -#: ../src/Doc/c-api/init.rst:465 +#: c-api/init.rst:465 msgid "" "Note that the :c:func:`PyGILState_\\*` functions assume there is only one " "global interpreter (created automatically by :c:func:`Py_Initialize`). " @@ -6043,7 +6084,7 @@ msgid "" msgstr "" # 4e4d2ee051ea42a49b62a1174a857341 -#: ../src/Doc/c-api/init.rst:471 +#: c-api/init.rst:471 msgid "" "Another important thing to note about threads is their behaviour in the face " "of the C :c:func:`fork` call. On most systems with :c:func:`fork`, after a " @@ -6064,19 +6105,19 @@ msgid "" msgstr "" # c9450dadf68140f5bc684504ca7c784a -#: ../src/Doc/c-api/init.rst:490 +#: c-api/init.rst:490 msgid "High-level API" msgstr "" # af37de28f29240908137a7172deabc24 -#: ../src/Doc/c-api/init.rst:492 +#: c-api/init.rst:492 msgid "" "These are the most commonly used types and functions when writing C " "extension code, or when embedding the Python interpreter:" msgstr "" # 880f0d9aa8d74e44a2bd32c84f67d31d -#: ../src/Doc/c-api/init.rst:497 +#: c-api/init.rst:497 msgid "" "This data structure represents the state shared by a number of cooperating " "threads. Threads belonging to the same interpreter share their module " @@ -6085,7 +6126,7 @@ msgid "" msgstr "" # 1bdf78df959545e8974de65f98d67a0c -#: ../src/Doc/c-api/init.rst:502 +#: c-api/init.rst:502 msgid "" "Threads belonging to different interpreters initially share nothing, except " "process state like available memory, open file descriptors and such. The " @@ -6094,7 +6135,7 @@ msgid "" msgstr "" # 269d54471e1a42298127efa423c02d6a -#: ../src/Doc/c-api/init.rst:510 +#: c-api/init.rst:510 msgid "" "This data structure represents the state of a single thread. The only " "public data member is :c:type:`PyInterpreterState \\*`:attr:`interp`, which " @@ -6102,7 +6143,7 @@ msgid "" msgstr "" # 0f4d7266bc0241bd951111bef371a2bc -#: ../src/Doc/c-api/init.rst:523 +#: c-api/init.rst:523 msgid "" "Initialize and acquire the global interpreter lock. It should be called in " "the main thread before creating a second thread or engaging in any other " @@ -6112,14 +6153,14 @@ msgid "" msgstr "" # 8ec87c4e0e40446b98d0ad20c0ed7c40 -#: ../src/Doc/c-api/init.rst:531 +#: c-api/init.rst:531 msgid "" "This is a no-op when called for a second time. It is safe to call this " "function before calling :c:func:`Py_Initialize`." msgstr "" # 5c69e5f971b746bc8e8857e9052538bc -#: ../src/Doc/c-api/init.rst:538 +#: c-api/init.rst:538 msgid "" "When only the main thread exists, no GIL operations are needed. This is a " "common situation (most Python programs do not use threads), and the lock " @@ -6135,21 +6176,21 @@ msgid "" msgstr "" # 565386aad6c04991958f29121bf048bf -#: ../src/Doc/c-api/init.rst:549 +#: c-api/init.rst:549 msgid "" "It is **not** safe to call this function when it is unknown which thread (if " "any) currently has the global interpreter lock." msgstr "" # 74aa20dc287a45609a4914c783a14a5c -#: ../src/Doc/c-api/init.rst:552 +#: c-api/init.rst:552 msgid "" "This function is not available when thread support is disabled at compile " "time." msgstr "" # 96cdca194d1141cfbc0af07bb0778bbd -#: ../src/Doc/c-api/init.rst:557 +#: c-api/init.rst:557 msgid "" "Returns a non-zero value if :c:func:`PyEval_InitThreads` has been called. " "This function can be called without holding the GIL, and therefore can be " @@ -6158,7 +6199,7 @@ msgid "" msgstr "" # 2615b1ddc0da41a7a6150cd28975bd17 -#: ../src/Doc/c-api/init.rst:567 +#: c-api/init.rst:567 msgid "" "Release the global interpreter lock (if it has been created and thread " "support is enabled) and reset the thread state to *NULL*, returning the " @@ -6168,7 +6209,7 @@ msgid "" msgstr "" # 2234ee77938d408b9d228caa8de38393 -#: ../src/Doc/c-api/init.rst:576 +#: c-api/init.rst:576 msgid "" "Acquire the global interpreter lock (if it has been created and thread " "support is enabled) and set the thread state to *tstate*, which must not be " @@ -6178,7 +6219,7 @@ msgid "" msgstr "" # 7a70faeeddd6442589a2e091908f337e -#: ../src/Doc/c-api/init.rst:585 +#: c-api/init.rst:585 msgid "" "Return the current thread state. The global interpreter lock must be held. " "When the current thread state is *NULL*, this issues a fatal error (so that " @@ -6186,7 +6227,7 @@ msgid "" msgstr "" # ba7153e8c0194130973d955de1e70fee -#: ../src/Doc/c-api/init.rst:592 +#: c-api/init.rst:592 msgid "" "Swap the current thread state with the thread state given by the argument " "*tstate*, which may be *NULL*. The global interpreter lock must be held and " @@ -6194,7 +6235,7 @@ msgid "" msgstr "" # d3f1bb211e0842febc28f8d383e5cd9f -#: ../src/Doc/c-api/init.rst:599 +#: c-api/init.rst:599 msgid "" "This function is called from :c:func:`PyOS_AfterFork` to ensure that newly " "created child processes don't hold locks referring to threads which are not " @@ -6202,14 +6243,14 @@ msgid "" msgstr "" # bd92ab18ec0e4b42918fa62cf5ab0aa9 -#: ../src/Doc/c-api/init.rst:604 +#: c-api/init.rst:604 msgid "" "The following functions use thread-local storage, and are not compatible " "with sub-interpreters:" msgstr "" # b38f8f04bb0f40498442be183ef9228a -#: ../src/Doc/c-api/init.rst:609 +#: c-api/init.rst:609 msgid "" "Ensure that the current thread is ready to call the Python C API regardless " "of the current state of Python, or of the global interpreter lock. This may " @@ -6223,7 +6264,7 @@ msgid "" msgstr "" # a12b24cd1078482db8a67b205ccb26c0 -#: ../src/Doc/c-api/init.rst:619 +#: c-api/init.rst:619 msgid "" "The return value is an opaque \"handle\" to the thread state when :c:func:" "`PyGILState_Ensure` was called, and must be passed to :c:func:" @@ -6234,14 +6275,14 @@ msgid "" msgstr "" # 80a91b9d2f8441038b9899c8e03ef02d -#: ../src/Doc/c-api/init.rst:626 +#: c-api/init.rst:626 msgid "" "When the function returns, the current thread will hold the GIL and be able " "to call arbitrary Python code. Failure is a fatal error." msgstr "" # ccf404df89094e76a90776bc24c3ede3 -#: ../src/Doc/c-api/init.rst:634 +#: c-api/init.rst:634 msgid "" "Release any resources previously acquired. After this call, Python's state " "will be the same as it was prior to the corresponding :c:func:" @@ -6250,14 +6291,14 @@ msgid "" msgstr "" # bd5e9e17f59647d790066d86ed6f8a1b -#: ../src/Doc/c-api/init.rst:639 +#: c-api/init.rst:639 msgid "" "Every call to :c:func:`PyGILState_Ensure` must be matched by a call to :c:" "func:`PyGILState_Release` on the same thread." msgstr "" # 45e233db53b64c02a7a1af3ab4b51882 -#: ../src/Doc/c-api/init.rst:647 +#: c-api/init.rst:647 msgid "" "Get the current thread state for this thread. May return ``NULL`` if no " "GILState API has been used on the current thread. Note that the main thread " @@ -6265,14 +6306,14 @@ msgid "" "made on the main thread. This is mainly a helper/diagnostic function." msgstr "" -#: ../src/Doc/c-api/init.rst:655 +#: c-api/init.rst:655 msgid "" "The following macros are normally used without a trailing semicolon; look " "for example usage in the Python source distribution." msgstr "" # 613ec706b32249a5a94792ef6237d5ff -#: ../src/Doc/c-api/init.rst:661 +#: c-api/init.rst:661 msgid "" "This macro expands to ``{ PyThreadState *_save; _save = PyEval_SaveThread();" "``. Note that it contains an opening brace; it must be matched with a " @@ -6282,7 +6323,7 @@ msgid "" msgstr "" # d6ec9e23154e4d21aef238b9560d61fc -#: ../src/Doc/c-api/init.rst:669 +#: c-api/init.rst:669 msgid "" "This macro expands to ``PyEval_RestoreThread(_save); }``. Note that it " "contains a closing brace; it must be matched with an earlier :c:macro:" @@ -6291,7 +6332,7 @@ msgid "" msgstr "" # 778eb74063ca4b69966f71afcca695d7 -#: ../src/Doc/c-api/init.rst:677 +#: c-api/init.rst:677 msgid "" "This macro expands to ``PyEval_RestoreThread(_save);``: it is equivalent to :" "c:macro:`Py_END_ALLOW_THREADS` without the closing brace. It is a no-op " @@ -6299,7 +6340,7 @@ msgid "" msgstr "" # 9b518b5fc79540f0b94110d4a76d726c -#: ../src/Doc/c-api/init.rst:684 +#: c-api/init.rst:684 msgid "" "This macro expands to ``_save = PyEval_SaveThread();``: it is equivalent to :" "c:macro:`Py_BEGIN_ALLOW_THREADS` without the opening brace and variable " @@ -6307,11 +6348,11 @@ msgid "" msgstr "" # bd29bedf2a1f4d48840d0481efd6e17b -#: ../src/Doc/c-api/init.rst:690 +#: c-api/init.rst:690 msgid "Low-level API" msgstr "" -#: ../src/Doc/c-api/init.rst:692 +#: c-api/init.rst:692 msgid "" "All of the following functions are only available when thread support is " "enabled at compile time, and must be called only when the global interpreter " @@ -6319,7 +6360,7 @@ msgid "" msgstr "" # 5f80405f79f64fb8a6da382cc4f6db77 -#: ../src/Doc/c-api/init.rst:699 +#: c-api/init.rst:699 msgid "" "Create a new interpreter state object. The global interpreter lock need not " "be held, but may be held if it is necessary to serialize calls to this " @@ -6327,14 +6368,14 @@ msgid "" msgstr "" # a5acd393241f481e821dda997683a414 -#: ../src/Doc/c-api/init.rst:706 +#: c-api/init.rst:706 msgid "" "Reset all information in an interpreter state object. The global " "interpreter lock must be held." msgstr "" # bf97ead2734b4367afb842aa96a6c0eb -#: ../src/Doc/c-api/init.rst:712 +#: c-api/init.rst:712 msgid "" "Destroy an interpreter state object. The global interpreter lock need not " "be held. The interpreter state must have been reset with a previous call " @@ -6342,7 +6383,7 @@ msgid "" msgstr "" # 6911b6f7590246b292794413cdd065d1 -#: ../src/Doc/c-api/init.rst:719 +#: c-api/init.rst:719 msgid "" "Create a new thread state object belonging to the given interpreter object. " "The global interpreter lock need not be held, but may be held if it is " @@ -6350,14 +6391,14 @@ msgid "" msgstr "" # bd4b9d016a8847d3938702936f127ddc -#: ../src/Doc/c-api/init.rst:726 +#: c-api/init.rst:726 msgid "" "Reset all information in a thread state object. The global interpreter lock " "must be held." msgstr "" # 9f2387703ff040fe9d3873f699d0d44d -#: ../src/Doc/c-api/init.rst:732 +#: c-api/init.rst:732 msgid "" "Destroy a thread state object. The global interpreter lock need not be " "held. The thread state must have been reset with a previous call to :c:func:" @@ -6365,7 +6406,7 @@ msgid "" msgstr "" # 36551c63c6dd495c9c453f625094debf -#: ../src/Doc/c-api/init.rst:739 +#: c-api/init.rst:739 msgid "" "Return a dictionary in which extensions can store thread-specific state " "information. Each extension should use a unique key to use to store state " @@ -6374,8 +6415,14 @@ msgid "" "raised and the caller should assume no current thread state is available." msgstr "" +#: c-api/init.rst:745 +msgid "" +"Previously this could only be called when a current thread is active, and " +"*NULL* meant that an exception was raised." +msgstr "" + # da26dee8d12a4fb8997a895bd2cfc9e2 -#: ../src/Doc/c-api/init.rst:752 +#: c-api/init.rst:752 msgid "" "Asynchronously raise an exception in a thread. The *id* argument is the " "thread id of the target thread; *exc* is the exception object to be raised. " @@ -6388,7 +6435,7 @@ msgid "" msgstr "" # 1b58682bfad947df88a146a641a8a4a5 -#: ../src/Doc/c-api/init.rst:765 +#: c-api/init.rst:765 msgid "" "Acquire the global interpreter lock and set the current thread state to " "*tstate*, which should not be *NULL*. The lock must have been created " @@ -6396,7 +6443,7 @@ msgid "" msgstr "" # 1eccdf59a0744e32b6245f32d4877d04 -#: ../src/Doc/c-api/init.rst:769 +#: c-api/init.rst:769 msgid "" ":c:func:`PyEval_RestoreThread` is a higher-level function which is always " "available (even when thread support isn't enabled or when threads have not " @@ -6404,7 +6451,7 @@ msgid "" msgstr "" # e6db417743a54f5a98c441bbe9a4d007 -#: ../src/Doc/c-api/init.rst:776 +#: c-api/init.rst:776 msgid "" "Reset the current thread state to *NULL* and release the global interpreter " "lock. The lock must have been created earlier and must be held by the " @@ -6414,7 +6461,7 @@ msgid "" msgstr "" # 9a41ccb75d1c4f3db1e9461bc3e247fd -#: ../src/Doc/c-api/init.rst:782 +#: c-api/init.rst:782 msgid "" ":c:func:`PyEval_SaveThread` is a higher-level function which is always " "available (even when thread support isn't enabled or when threads have not " @@ -6422,40 +6469,40 @@ msgid "" msgstr "" # 3fb3853191b8414596f93bc32bae538a -#: ../src/Doc/c-api/init.rst:789 +#: c-api/init.rst:789 msgid "" "Acquire the global interpreter lock. The lock must have been created " "earlier. If this thread already has the lock, a deadlock ensues." msgstr "" # cd8fa3b57ac24778859f0012e9d87406 -#: ../src/Doc/c-api/init.rst:793 +#: c-api/init.rst:793 msgid "" "This function does not change the current thread state. Please use :c:func:" "`PyEval_RestoreThread` or :c:func:`PyEval_AcquireThread` instead." msgstr "" # d354e5d452974de786c49b92d7e9192d -#: ../src/Doc/c-api/init.rst:800 +#: c-api/init.rst:800 msgid "" "Release the global interpreter lock. The lock must have been created " "earlier." msgstr "" # d783765b787341a7970d53055fde32fe -#: ../src/Doc/c-api/init.rst:803 +#: c-api/init.rst:803 msgid "" "This function does not change the current thread state. Please use :c:func:" "`PyEval_SaveThread` or :c:func:`PyEval_ReleaseThread` instead." msgstr "" # 9ad84b62891645f0a3b10eaa3147d52f -#: ../src/Doc/c-api/init.rst:809 +#: c-api/init.rst:809 msgid "Sub-interpreter support" msgstr "" # c90b501452794f62bbdb5ba7808b8c44 -#: ../src/Doc/c-api/init.rst:811 +#: c-api/init.rst:811 msgid "" "While in most uses, you will only embed a single Python interpreter, there " "are cases where you need to create several independent interpreters in the " @@ -6466,7 +6513,7 @@ msgid "" msgstr "" # 4323589b1c424947a44a4090761bc330 -#: ../src/Doc/c-api/init.rst:829 +#: c-api/init.rst:829 msgid "" "Create a new sub-interpreter. This is an (almost) totally separate " "environment for the execution of Python code. In particular, the new " @@ -6480,7 +6527,7 @@ msgid "" msgstr "" # bd599dd83fbf465c8007d36686c38fdd -#: ../src/Doc/c-api/init.rst:839 +#: c-api/init.rst:839 msgid "" "The return value points to the first thread state created in the new sub-" "interpreter. This thread state is made in the current thread state. Note " @@ -6495,7 +6542,7 @@ msgid "" msgstr "" # cff92381c1ba4a1db3cb67cbe9930b8b -#: ../src/Doc/c-api/init.rst:854 +#: c-api/init.rst:854 msgid "" "Extension modules are shared between (sub-)interpreters as follows: the " "first time a particular extension is imported, it is initialized normally, " @@ -6510,7 +6557,7 @@ msgid "" msgstr "" # befc21fcc9ef4a7bba9b107032d8607a -#: ../src/Doc/c-api/init.rst:871 +#: c-api/init.rst:871 msgid "" "Destroy the (sub-)interpreter represented by the given thread state. The " "given thread state must be the current thread state. See the discussion of " @@ -6522,12 +6569,12 @@ msgid "" msgstr "" # d6aa09ba41084f63b83a1140428e2242 -#: ../src/Doc/c-api/init.rst:881 +#: c-api/init.rst:881 msgid "Bugs and caveats" msgstr "" # d11c110b68c14b15ab4a40e2689c8de2 -#: ../src/Doc/c-api/init.rst:883 +#: c-api/init.rst:883 msgid "" "Because sub-interpreters (and the main interpreter) are part of the same " "process, the insulation between them isn't perfect --- for example, using " @@ -6545,7 +6592,7 @@ msgid "" msgstr "" # 5c495b0714bb4a8ca4066259295196db -#: ../src/Doc/c-api/init.rst:897 +#: c-api/init.rst:897 msgid "" "Also note that combining this functionality with :c:func:`PyGILState_\\*` " "APIs is delicate, because these APIs assume a bijection between Python " @@ -6557,12 +6604,12 @@ msgid "" "created threads will probably be broken when using sub-interpreters." msgstr "" -#: ../src/Doc/c-api/init.rst:908 +#: c-api/init.rst:908 msgid "Asynchronous Notifications" msgstr "" # c20a43077d294270947efa860575162f -#: ../src/Doc/c-api/init.rst:910 +#: c-api/init.rst:910 msgid "" "A mechanism is provided to make asynchronous notifications to the main " "interpreter thread. These notifications take the form of a function pointer " @@ -6570,7 +6617,7 @@ msgid "" msgstr "" # 97130ad46ca04f79ae439759fc9d0aa7 -#: ../src/Doc/c-api/init.rst:919 +#: c-api/init.rst:919 msgid "" "Schedule a function to be called from the main interpreter thread. On " "success, 0 is returned and *func* is queued for being called in the main " @@ -6578,7 +6625,7 @@ msgid "" msgstr "" # ce4463be62104f31b81a51f4d6329d3b -#: ../src/Doc/c-api/init.rst:923 +#: c-api/init.rst:923 msgid "" "When successfully queued, *func* will be *eventually* called from the main " "interpreter thread with the argument *arg*. It will be called " @@ -6587,19 +6634,19 @@ msgid "" msgstr "" # 8d62b9e05bbe4fd0b6eed1fe429a6129 -#: ../src/Doc/c-api/init.rst:928 +#: c-api/init.rst:928 msgid "on a :term:`bytecode` boundary;" msgstr "" # cb7c03f1fb2241539ec8758b977b7a11 -#: ../src/Doc/c-api/init.rst:929 +#: c-api/init.rst:929 msgid "" "with the main thread holding the :term:`global interpreter lock` (*func* can " "therefore use the full C API)." msgstr "" # 32f8feb15ec54dd393838f3e1d08705a -#: ../src/Doc/c-api/init.rst:932 +#: c-api/init.rst:932 msgid "" "*func* must return 0 on success, or -1 on failure with an exception set. " "*func* won't be interrupted to perform another asynchronous notification " @@ -6608,14 +6655,14 @@ msgid "" msgstr "" # 65eda37a1fd742d49819eb832fb28bc7 -#: ../src/Doc/c-api/init.rst:937 +#: c-api/init.rst:937 msgid "" "This function doesn't need a current thread state to run, and it doesn't " "need the global interpreter lock." msgstr "" # db61d49e643b4911ace677e9d13759bc -#: ../src/Doc/c-api/init.rst:941 +#: c-api/init.rst:941 msgid "" "This is a low-level function, only useful for very special cases. There is " "no guarantee that *func* will be called as quick as possible. If the main " @@ -6625,11 +6672,11 @@ msgid "" "`PyGILState API`." msgstr "" -#: ../src/Doc/c-api/init.rst:954 +#: c-api/init.rst:954 msgid "Profiling and Tracing" msgstr "" -#: ../src/Doc/c-api/init.rst:959 +#: c-api/init.rst:959 msgid "" "The Python interpreter provides some low-level support for attaching " "profiling and execution tracing facilities. These are used for profiling, " @@ -6637,7 +6684,7 @@ msgid "" msgstr "" # 2911edeccaa145a9a8bb6d3296b71632 -#: ../src/Doc/c-api/init.rst:963 +#: c-api/init.rst:963 msgid "" "Starting with Python 2.2, the implementation of this facility was " "substantially revised, and an interface from C was added. This C interface " @@ -6650,7 +6697,7 @@ msgid "" msgstr "" # 8e4330873edd4b0ba7c53cf691927b33 -#: ../src/Doc/c-api/init.rst:975 +#: c-api/init.rst:975 msgid "" "The type of the trace function registered using :c:func:`PyEval_SetProfile` " "and :c:func:`PyEval_SetTrace`. The first parameter is the object passed to " @@ -6662,77 +6709,76 @@ msgid "" msgstr "" # 55815e224fac48cb9956e3746e7ec46e -#: ../src/Doc/c-api/init.rst:984 +#: c-api/init.rst:984 msgid "Value of *what*" msgstr "" # 26a91ca701b648e882d826bb419d4bbb -#: ../src/Doc/c-api/init.rst:984 +#: c-api/init.rst:984 msgid "Meaning of *arg*" msgstr "" # 807ecd167f7c405baa2c30e4070edbc6 -#: ../src/Doc/c-api/init.rst:986 +#: c-api/init.rst:986 msgid ":const:`PyTrace_CALL`" msgstr "" # 0b28a4b1504f4042a793c4c35f0fcf40 # c82376e35ca84e7980cd7ded649eea26 -#: ../src/Doc/c-api/init.rst:986 ../src/Doc/c-api/init.rst:991 +#: c-api/init.rst:986 c-api/init.rst:991 msgid "Always *NULL*." msgstr "" # 3e6e08eb355240c1ad71cb10dd34e34f -#: ../src/Doc/c-api/init.rst:988 +#: c-api/init.rst:988 msgid ":const:`PyTrace_EXCEPTION`" msgstr "" # ddcd533d6da04ebd8525ddccfe20671c -#: ../src/Doc/c-api/init.rst:988 +#: c-api/init.rst:988 msgid "Exception information as returned by :func:`sys.exc_info`." msgstr "" # 033b1f35b70a440ca5612ed1866609ed -#: ../src/Doc/c-api/init.rst:991 +#: c-api/init.rst:991 msgid ":const:`PyTrace_LINE`" msgstr "" # 50a815bb81b74b2688f729ba55aa572d -#: ../src/Doc/c-api/init.rst:993 +#: c-api/init.rst:993 msgid ":const:`PyTrace_RETURN`" msgstr "" # 7c184ed455e0451dbff9cc277c4c8bdd -#: ../src/Doc/c-api/init.rst:993 +#: c-api/init.rst:993 msgid "" "Value being returned to the caller, or *NULL* if caused by an exception." msgstr "" # 6ab3db3acb5c49618b435869c447a7ef -#: ../src/Doc/c-api/init.rst:996 +#: c-api/init.rst:996 msgid ":const:`PyTrace_C_CALL`" msgstr "" # 6aa8eda40f7447be8335444be344be6c # 395184982b6c481cac3023d3fd0caf05 # bebcefea73fa462b87655a0b0bd9a185 -#: ../src/Doc/c-api/init.rst:996 ../src/Doc/c-api/init.rst:998 -#: ../src/Doc/c-api/init.rst:1000 +#: c-api/init.rst:996 c-api/init.rst:998 c-api/init.rst:1000 msgid "Function object being called." msgstr "" # 793cdd9852814ebe8b96a7dcbec48269 -#: ../src/Doc/c-api/init.rst:998 +#: c-api/init.rst:998 msgid ":const:`PyTrace_C_EXCEPTION`" msgstr "" # 590fd27b960c4419acc2a5d839d1b944 -#: ../src/Doc/c-api/init.rst:1000 +#: c-api/init.rst:1000 msgid ":const:`PyTrace_C_RETURN`" msgstr "" # 0feaa5869426452d9fb8717b06b66b3e -#: ../src/Doc/c-api/init.rst:1006 +#: c-api/init.rst:1006 msgid "" "The value of the *what* parameter to a :c:type:`Py_tracefunc` function when " "a new call to a function or method is being reported, or a new entry into a " @@ -6742,7 +6788,7 @@ msgid "" msgstr "" # b253e6b1675b404f9ab0329857885044 -#: ../src/Doc/c-api/init.rst:1015 +#: c-api/init.rst:1015 msgid "" "The value of the *what* parameter to a :c:type:`Py_tracefunc` function when " "an exception has been raised. The callback function is called with this " @@ -6755,42 +6801,42 @@ msgid "" msgstr "" # fb78287cef404b27aed77b53073bf678 -#: ../src/Doc/c-api/init.rst:1026 +#: c-api/init.rst:1026 msgid "" "The value passed as the *what* parameter to a trace function (but not a " "profiling function) when a line-number event is being reported." msgstr "" # aca1c55b95e541b5a86269f3de23c6ab -#: ../src/Doc/c-api/init.rst:1032 +#: c-api/init.rst:1032 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when " "a call is returning without propagating an exception." msgstr "" # d219d18132d74d7cb66638a721f67500 -#: ../src/Doc/c-api/init.rst:1038 +#: c-api/init.rst:1038 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when " "a C function is about to be called." msgstr "" # f8677b5d6e424eb4aa8548ebdfba20ce -#: ../src/Doc/c-api/init.rst:1044 +#: c-api/init.rst:1044 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when " "a C function has raised an exception." msgstr "" # 2d7f32ebe05a48298205b43b4b8b0ed1 -#: ../src/Doc/c-api/init.rst:1050 +#: c-api/init.rst:1050 msgid "" "The value for the *what* parameter to :c:type:`Py_tracefunc` functions when " "a C function has returned." msgstr "" # e853ff3b168b46549dac4b0e0965afb5 -#: ../src/Doc/c-api/init.rst:1056 +#: c-api/init.rst:1056 msgid "" "Set the profiler function to *func*. The *obj* parameter is passed to the " "function as its first parameter, and may be any Python object, or *NULL*. " @@ -6801,7 +6847,7 @@ msgid "" msgstr "" # 74549e6117f04dada76f81be82be36d5 -#: ../src/Doc/c-api/init.rst:1066 +#: c-api/init.rst:1066 msgid "" "Set the tracing function to *func*. This is similar to :c:func:" "`PyEval_SetProfile`, except the tracing function does receive line-number " @@ -6809,133 +6855,133 @@ msgid "" msgstr "" # 5a089afe7cbb4a8589b620999ce57185 -#: ../src/Doc/c-api/init.rst:1072 +#: c-api/init.rst:1072 msgid "" "Return a tuple of function call counts. There are constants defined for the " "positions within the tuple:" msgstr "" -#: ../src/Doc/c-api/init.rst:1076 +#: c-api/init.rst:1076 msgid "Name" msgstr "Nom" # f67a501e20c647a1988795e4c50bc8e7 -#: ../src/Doc/c-api/init.rst:1076 +#: c-api/init.rst:1076 msgid "Value" msgstr "" # 81f682785def4c778e9a73f866790403 -#: ../src/Doc/c-api/init.rst:1078 +#: c-api/init.rst:1078 msgid ":const:`PCALL_ALL`" msgstr "" # 202b205cf79e4e0e95f9b02c640559b2 -#: ../src/Doc/c-api/init.rst:1078 +#: c-api/init.rst:1078 msgid "0" msgstr "" # fd558f4b4a384b76b1c4184a67dd4f0b -#: ../src/Doc/c-api/init.rst:1080 +#: c-api/init.rst:1080 msgid ":const:`PCALL_FUNCTION`" msgstr "" # 4ae7b66c06e04cb3b2f848d2816de3da -#: ../src/Doc/c-api/init.rst:1080 +#: c-api/init.rst:1080 msgid "1" msgstr "" # a1ac7ebf33504761a3822db034ff2a1a -#: ../src/Doc/c-api/init.rst:1082 +#: c-api/init.rst:1082 msgid ":const:`PCALL_FAST_FUNCTION`" msgstr "" # 276876eb09b64d9cbbd0273c043a3814 -#: ../src/Doc/c-api/init.rst:1082 +#: c-api/init.rst:1082 msgid "2" msgstr "" # 87969597e7904737a2922f0ea5adf95c -#: ../src/Doc/c-api/init.rst:1084 +#: c-api/init.rst:1084 msgid ":const:`PCALL_FASTER_FUNCTION`" msgstr "" # 7b6e392baf3c4370921b97fedaef7ba9 -#: ../src/Doc/c-api/init.rst:1084 +#: c-api/init.rst:1084 msgid "3" msgstr "" # f30057c052ce4af6b3468fcbe3483f4f -#: ../src/Doc/c-api/init.rst:1086 +#: c-api/init.rst:1086 msgid ":const:`PCALL_METHOD`" msgstr "" # 02424ee0ec7b46c2a56d041c17506c80 -#: ../src/Doc/c-api/init.rst:1086 +#: c-api/init.rst:1086 msgid "4" msgstr "" # b6d2bfc9f82f4f78ab1eeedee6a55f2f -#: ../src/Doc/c-api/init.rst:1088 +#: c-api/init.rst:1088 msgid ":const:`PCALL_BOUND_METHOD`" msgstr "" # 566159816458463f992bd7d4fb66ec45 -#: ../src/Doc/c-api/init.rst:1088 +#: c-api/init.rst:1088 msgid "5" msgstr "" # 50635062b7ea4136a980bd5e221faf74 -#: ../src/Doc/c-api/init.rst:1090 +#: c-api/init.rst:1090 msgid ":const:`PCALL_CFUNCTION`" msgstr "" # ce3f526611ef4b88914804b7d3dd9111 -#: ../src/Doc/c-api/init.rst:1090 +#: c-api/init.rst:1090 msgid "6" msgstr "" # c03bb9a2d4b64400bfdb8ad95c7c6b23 -#: ../src/Doc/c-api/init.rst:1092 +#: c-api/init.rst:1092 msgid ":const:`PCALL_TYPE`" msgstr "" # e6a4562e5a804d7aae784ea0a7b7ed95 -#: ../src/Doc/c-api/init.rst:1092 +#: c-api/init.rst:1092 msgid "7" msgstr "" # 5601252dce424f9aa1ff47ba12f3605b -#: ../src/Doc/c-api/init.rst:1094 +#: c-api/init.rst:1094 msgid ":const:`PCALL_GENERATOR`" msgstr "" # a6652045cb004f42bab10ba738459f9d -#: ../src/Doc/c-api/init.rst:1094 +#: c-api/init.rst:1094 msgid "8" msgstr "" # b351bd1835704d0db7b7f3fa7dd4ede6 -#: ../src/Doc/c-api/init.rst:1096 +#: c-api/init.rst:1096 msgid ":const:`PCALL_OTHER`" msgstr "" # 1ca50c24a2ed46d29515ee99c664ed0a -#: ../src/Doc/c-api/init.rst:1096 +#: c-api/init.rst:1096 msgid "9" msgstr "" # 784fb1f35d7546f5bf71fe268a34b332 -#: ../src/Doc/c-api/init.rst:1098 +#: c-api/init.rst:1098 msgid ":const:`PCALL_POP`" msgstr "" # bbf7bb9465b041bd9ad30a1453a3d3e7 -#: ../src/Doc/c-api/init.rst:1098 +#: c-api/init.rst:1098 msgid "10" msgstr "" # c23b75c1e5ee414791defd7787acc761 -#: ../src/Doc/c-api/init.rst:1101 +#: c-api/init.rst:1101 msgid "" ":const:`PCALL_FAST_FUNCTION` means no argument tuple needs to be created. :" "const:`PCALL_FASTER_FUNCTION` means that the fast-path frame setup code is " @@ -6943,89 +6989,88 @@ msgid "" msgstr "" # 678180cada6045d3bb7befadf2122242 -#: ../src/Doc/c-api/init.rst:1104 +#: c-api/init.rst:1104 msgid "" "If there is a method call where the call can be optimized by changing the " "argument tuple and calling the function directly, it gets recorded twice." msgstr "" # 9854aea0b9b54653acd2134ebc4ac9e2 -#: ../src/Doc/c-api/init.rst:1108 +#: c-api/init.rst:1108 msgid "" "This function is only present if Python is compiled with :const:" "`CALL_PROFILE` defined." msgstr "" -#: ../src/Doc/c-api/init.rst:1114 +#: c-api/init.rst:1114 msgid "Advanced Debugger Support" msgstr "Support avancé du debugger" -#: ../src/Doc/c-api/init.rst:1119 +#: c-api/init.rst:1119 msgid "" "These functions are only intended to be used by advanced debugging tools." msgstr "" # 3b9d4318bbe548c4850ecda7921a8968 -#: ../src/Doc/c-api/init.rst:1124 +#: c-api/init.rst:1124 msgid "" "Return the interpreter state object at the head of the list of all such " "objects." msgstr "" # 7eadec718a3f47e2add48e117cd4381d -#: ../src/Doc/c-api/init.rst:1131 +#: c-api/init.rst:1131 msgid "" "Return the next interpreter state object after *interp* from the list of all " "such objects." msgstr "" -# c665d20b26f149b5a8448e686bcf5225 -#: ../src/Doc/c-api/init.rst:1139 +#: c-api/init.rst:1139 msgid "" -"Return the a pointer to the first :c:type:`PyThreadState` object in the list " +"Return the pointer to the first :c:type:`PyThreadState` object in the list " "of threads associated with the interpreter *interp*." msgstr "" # 1d3ce99fa4bd42798e62a1a1cc4eea96 -#: ../src/Doc/c-api/init.rst:1147 +#: c-api/init.rst:1147 msgid "" "Return the next thread state object after *tstate* from the list of all such " "objects belonging to the same :c:type:`PyInterpreterState` object." msgstr "" -#: ../src/Doc/c-api/int.rst:6 +#: c-api/int.rst:6 #, fuzzy msgid "Plain Integer Objects" msgstr "Objets association" # 24351b06555c42099882f9f3886e3192 -#: ../src/Doc/c-api/int.rst:13 +#: c-api/int.rst:13 msgid "This subtype of :c:type:`PyObject` represents a Python integer object." msgstr "" # ea2b3ca284d94f869fb66ce6477fbdef -#: ../src/Doc/c-api/int.rst:20 +#: c-api/int.rst:20 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python plain integer " "type. This is the same object as ``int`` and ``types.IntType``." msgstr "" # 7c773759a98d4709a5134dc9a2b66494 -#: ../src/Doc/c-api/int.rst:26 +#: c-api/int.rst:26 msgid "" "Return true if *o* is of type :c:data:`PyInt_Type` or a subtype of :c:data:" "`PyInt_Type`." msgstr "" # 0244df8b9ac64f298d0f9777780d054b -#: ../src/Doc/c-api/int.rst:35 +#: c-api/int.rst:35 msgid "" "Return true if *o* is of type :c:data:`PyInt_Type`, but not a subtype of :c:" "data:`PyInt_Type`." msgstr "" # 39979e8d79a54efab899b4eae2f8a2fa -#: ../src/Doc/c-api/int.rst:43 +#: c-api/int.rst:43 msgid "" "Return a new :c:type:`PyIntObject` or :c:type:`PyLongObject` based on the " "string value in *str*, which is interpreted according to the radix in " @@ -7044,12 +7089,12 @@ msgid "" msgstr "" # d4d5f5292d494b088e717907304f4cb5 -#: ../src/Doc/c-api/int.rst:60 +#: c-api/int.rst:60 msgid "Create a new integer object with a value of *ival*." msgstr "" # 70d82a4936a741b5bf6fe098e62fdc72 -#: ../src/Doc/c-api/int.rst:62 +#: c-api/int.rst:62 msgid "" "The current implementation keeps an array of integer objects for all " "integers between ``-5`` and ``256``, when you create an int in that range " @@ -7059,7 +7104,7 @@ msgid "" msgstr "" # 7814cf0d388446d4afde232c7d75eda0 -#: ../src/Doc/c-api/int.rst:71 +#: c-api/int.rst:71 msgid "" "Create a new integer object with a value of *ival*. If the value is larger " "than ``LONG_MAX`` or smaller than ``LONG_MIN``, a long integer object is " @@ -7067,14 +7112,14 @@ msgid "" msgstr "" # ad964a6a87e54cf8b4bbf32fdf0e761d -#: ../src/Doc/c-api/int.rst:80 +#: c-api/int.rst:80 msgid "" "Create a new integer object with a value of *ival*. If the value exceeds " "``LONG_MAX``, a long integer object is returned." msgstr "" # df2d57408b7545fdabffb35d344588ab -#: ../src/Doc/c-api/int.rst:88 +#: c-api/int.rst:88 msgid "" "Will first attempt to cast the object to a :c:type:`PyIntObject`, if it is " "not already one, and then return its value. If there is an error, ``-1`` is " @@ -7083,12 +7128,12 @@ msgid "" msgstr "" # 00ab2699ebf94205a811ba1ae8ff5ae8 -#: ../src/Doc/c-api/int.rst:96 +#: c-api/int.rst:96 msgid "Return the value of the object *io*. No error checking is performed." msgstr "" # ad042e6533ac4680b7110e678860d836 -#: ../src/Doc/c-api/int.rst:101 +#: c-api/int.rst:101 msgid "" "Will first attempt to cast the object to a :c:type:`PyIntObject` or :c:type:" "`PyLongObject`, if it is not already one, and then return its value as " @@ -7096,7 +7141,7 @@ msgid "" msgstr "" # e1d34be3a6d94afdb5d8b322dafe7b99 -#: ../src/Doc/c-api/int.rst:110 +#: c-api/int.rst:110 msgid "" "Will first attempt to cast the object to a :c:type:`PyIntObject` or :c:type:" "`PyLongObject`, if it is not already one, and then return its value as " @@ -7104,7 +7149,7 @@ msgid "" msgstr "" # 31f9f18f46814ff49d0c5add7c975b15 -#: ../src/Doc/c-api/int.rst:119 +#: c-api/int.rst:119 msgid "" "Will first attempt to cast the object to a :c:type:`PyIntObject` or :c:type:" "`PyLongObject`, if it is not already one, and then return its value as :c:" @@ -7112,24 +7157,24 @@ msgid "" msgstr "" # dc8c92bf563f4e409d77051c300bd8f5 -#: ../src/Doc/c-api/int.rst:130 +#: c-api/int.rst:130 msgid "" "Return the system's idea of the largest integer it can handle (:const:" "`LONG_MAX`, as defined in the system header files)." msgstr "" # 4edcf2b1ff6a407ca1db28b352c46033 -#: ../src/Doc/c-api/int.rst:136 +#: c-api/int.rst:136 msgid "" "Clear the integer free list. Return the number of items that could not be " "freed." msgstr "" -#: ../src/Doc/c-api/intro.rst:8 +#: c-api/intro.rst:8 msgid "Introduction" msgstr "Introduction" -#: ../src/Doc/c-api/intro.rst:10 +#: c-api/intro.rst:10 msgid "" "The Application Programmer's Interface to Python gives C and C++ programmers " "access to the Python interpreter at a variety of levels. The API is equally " @@ -7142,7 +7187,7 @@ msgid "" "`embedding` Python in an application." msgstr "" -#: ../src/Doc/c-api/intro.rst:20 +#: c-api/intro.rst:20 msgid "" "Writing an extension module is a relatively well-understood process, where " "a \"cookbook\" approach works well. There are several tools that automate " @@ -7151,7 +7196,7 @@ msgid "" "less straightforward than writing an extension." msgstr "" -#: ../src/Doc/c-api/intro.rst:26 +#: c-api/intro.rst:26 msgid "" "Many API functions are useful independent of whether you're embedding or " "extending Python; moreover, most applications that embed Python will need " @@ -7160,32 +7205,32 @@ msgid "" "in a real application." msgstr "" -#: ../src/Doc/c-api/intro.rst:36 +#: c-api/intro.rst:36 msgid "Include Files" msgstr "" -#: ../src/Doc/c-api/intro.rst:38 +#: c-api/intro.rst:38 msgid "" "All function, type and macro definitions needed to use the Python/C API are " "included in your code by the following line::" msgstr "" # c87aadefa2ed4883b14c7e1d90c5c711 -#: ../src/Doc/c-api/intro.rst:43 +#: c-api/intro.rst:43 msgid "" "This implies inclusion of the following standard headers: ````, " "````, ````, ````, ```` and ```` (if available)." msgstr "" -#: ../src/Doc/c-api/intro.rst:49 +#: c-api/intro.rst:49 msgid "" "Since Python may define some pre-processor definitions which affect the " "standard headers on some systems, you *must* include :file:`Python.h` before " "any standard headers are included." msgstr "" -#: ../src/Doc/c-api/intro.rst:53 +#: c-api/intro.rst:53 msgid "" "All user visible names defined by Python.h (except those defined by the " "included standard headers) have one of the prefixes ``Py`` or ``_Py``. " @@ -7194,7 +7239,7 @@ msgid "" "names do not have a reserved prefix." msgstr "" -#: ../src/Doc/c-api/intro.rst:58 +#: c-api/intro.rst:58 msgid "" "**Important:** user code should never define names that begin with ``Py`` or " "``_Py``. This confuses the reader, and jeopardizes the portability of the " @@ -7202,7 +7247,7 @@ msgid "" "beginning with one of these prefixes." msgstr "" -#: ../src/Doc/c-api/intro.rst:63 +#: c-api/intro.rst:63 msgid "" "The header files are typically installed with Python. On Unix, these are " "located in the directories :file:`{prefix}/include/pythonversion/` and :file:" @@ -7213,7 +7258,7 @@ msgid "" "envvar:`prefix` is the installation directory specified to the installer." msgstr "" -#: ../src/Doc/c-api/intro.rst:71 +#: c-api/intro.rst:71 msgid "" "To include the headers, place both directories (if different) on your " "compiler's search path for includes. Do *not* place the parent directories " @@ -7223,19 +7268,19 @@ msgid "" "`exec_prefix`." msgstr "" -#: ../src/Doc/c-api/intro.rst:78 +#: c-api/intro.rst:78 msgid "" "C++ users should note that though the API is defined entirely using C, the " "header files do properly declare the entry points to be ``extern \"C\"``, so " "there is no need to do anything special to use the API from C++." msgstr "" -#: ../src/Doc/c-api/intro.rst:86 +#: c-api/intro.rst:86 msgid "Objects, Types and Reference Counts" msgstr "" # 2b45dce54b934dc3ab18981cf5bd1274 -#: ../src/Doc/c-api/intro.rst:90 +#: c-api/intro.rst:90 msgid "" "Most Python/C API functions have one or more arguments as well as a return " "value of type :c:type:`PyObject\\*`. This type is a pointer to an opaque " @@ -7250,7 +7295,7 @@ msgid "" "objects." msgstr "" -#: ../src/Doc/c-api/intro.rst:101 +#: c-api/intro.rst:101 msgid "" "All Python objects (even Python integers) have a :dfn:`type` and a :dfn:" "`reference count`. An object's type determines what kind of object it is (e." @@ -7261,11 +7306,11 @@ msgid "" "a Python list." msgstr "" -#: ../src/Doc/c-api/intro.rst:112 +#: c-api/intro.rst:112 msgid "Reference Counts" msgstr "" -#: ../src/Doc/c-api/intro.rst:114 +#: c-api/intro.rst:114 msgid "" "The reference count is important because today's computers have a finite " "(and often severely limited) memory size; it counts how many different " @@ -7280,7 +7325,7 @@ msgid "" msgstr "" # 15aaafaa70d34763872358d41bf68781 -#: ../src/Doc/c-api/intro.rst:129 +#: c-api/intro.rst:129 msgid "" "Reference counts are always manipulated explicitly. The normal way is to " "use the macro :c:func:`Py_INCREF` to increment an object's reference count " @@ -7298,7 +7343,7 @@ msgid "" "reference count increment is a simple operation." msgstr "" -#: ../src/Doc/c-api/intro.rst:143 +#: c-api/intro.rst:143 msgid "" "It is not necessary to increment an object's reference count for every " "local variable that contains a pointer to an object. In theory, the " @@ -7316,7 +7361,7 @@ msgid "" msgstr "" # 4afd25961de144e7ab5ca1f6103d3ca5 -#: ../src/Doc/c-api/intro.rst:157 +#: c-api/intro.rst:157 msgid "" "However, a common pitfall is to extract an object from a list and hold on to " "it for a while without incrementing its reference count. Some other " @@ -7328,7 +7373,7 @@ msgid "" msgstr "" # 9461bffa2a674b3fbe360a35e2594afb -#: ../src/Doc/c-api/intro.rst:165 +#: c-api/intro.rst:165 msgid "" "A safe approach is to always use the generic operations (functions whose " "name begins with ``PyObject_``, ``PyNumber_``, ``PySequence_`` or " @@ -7338,12 +7383,12 @@ msgid "" "becomes second nature." msgstr "" -#: ../src/Doc/c-api/intro.rst:175 +#: c-api/intro.rst:175 msgid "Reference Count Details" msgstr "" # 58ef65c1aac64fbd9ee436fee5a08b20 -#: ../src/Doc/c-api/intro.rst:177 +#: c-api/intro.rst:177 msgid "" "The reference count behavior of functions in the Python/C API is best " "explained in terms of *ownership of references*. Ownership pertains to " @@ -7360,7 +7405,7 @@ msgid "" "reference." msgstr "" -#: ../src/Doc/c-api/intro.rst:190 +#: c-api/intro.rst:190 msgid "" "Conversely, when a calling function passes in a reference to an object, " "there are two possibilities: the function *steals* a reference to the " @@ -7370,7 +7415,7 @@ msgid "" msgstr "" # ebc6979c16da46ddadb714f5fa03500d -#: ../src/Doc/c-api/intro.rst:200 +#: c-api/intro.rst:200 msgid "" "Few functions steal references; the two notable exceptions are :c:func:" "`PyList_SetItem` and :c:func:`PyTuple_SetItem`, which steal a reference to " @@ -7383,7 +7428,7 @@ msgid "" msgstr "" # 2b3894608fb84fa296fdb30d8647bbf6 -#: ../src/Doc/c-api/intro.rst:215 +#: c-api/intro.rst:215 msgid "" "Here, :c:func:`PyInt_FromLong` returns a new reference which is immediately " "stolen by :c:func:`PyTuple_SetItem`. When you want to keep using an object " @@ -7392,7 +7437,7 @@ msgid "" msgstr "" # 656e72b8fd224721b108a677c829e9ad -#: ../src/Doc/c-api/intro.rst:220 +#: c-api/intro.rst:220 msgid "" "Incidentally, :c:func:`PyTuple_SetItem` is the *only* way to set tuple " "items; :c:func:`PySequence_SetItem` and :c:func:`PyObject_SetItem` refuse to " @@ -7401,14 +7446,14 @@ msgid "" msgstr "" # 5f25cc241aeb473ea3e4e799bf60f4b3 -#: ../src/Doc/c-api/intro.rst:225 +#: c-api/intro.rst:225 msgid "" "Equivalent code for populating a list can be written using :c:func:" "`PyList_New` and :c:func:`PyList_SetItem`." msgstr "" # 68ad03c814324653977ce83bddfd7243 -#: ../src/Doc/c-api/intro.rst:228 +#: c-api/intro.rst:228 msgid "" "However, in practice, you will rarely use these ways of creating and " "populating a tuple or list. There's a generic function, :c:func:" @@ -7418,7 +7463,7 @@ msgid "" msgstr "" # 5b43d3e4f6bc4a2ab9e4cc85c0e0b167 -#: ../src/Doc/c-api/intro.rst:239 +#: c-api/intro.rst:239 msgid "" "It is much more common to use :c:func:`PyObject_SetItem` and friends with " "items whose references you are only borrowing, like arguments that were " @@ -7430,7 +7475,7 @@ msgid "" msgstr "" # 48d2257bc2c74ec19fb76614885f956d -#: ../src/Doc/c-api/intro.rst:269 +#: c-api/intro.rst:269 msgid "" "The situation is slightly different for function return values. While " "passing a reference to most functions does not change your ownership " @@ -7444,7 +7489,7 @@ msgid "" msgstr "" # 79afa4895db34766bbff82f4d319107d -#: ../src/Doc/c-api/intro.rst:278 +#: c-api/intro.rst:278 msgid "" "It is important to realize that whether you own a reference returned by a " "function depends on which function you call only --- *the plumage* (the type " @@ -7456,19 +7501,19 @@ msgid "" msgstr "" # fdc9af479c6f4a2b940f491b06761f7d -#: ../src/Doc/c-api/intro.rst:290 +#: c-api/intro.rst:290 msgid "" "Here is an example of how you could write a function that computes the sum " "of the items in a list of integers; once using :c:func:`PyList_GetItem`, " "and once using :c:func:`PySequence_GetItem`. ::" msgstr "" -#: ../src/Doc/c-api/intro.rst:342 +#: c-api/intro.rst:342 msgid "Types" msgstr "" # d5bced4796cb4c779dc8a60189c65856 -#: ../src/Doc/c-api/intro.rst:344 +#: c-api/intro.rst:344 msgid "" "There are few other data types that play a significant role in the Python/C " "API; most are simple C types such as :c:type:`int`, :c:type:`long`, :c:type:" @@ -7479,11 +7524,11 @@ msgid "" "that use them." msgstr "" -#: ../src/Doc/c-api/intro.rst:356 +#: c-api/intro.rst:356 msgid "Exceptions" msgstr "Exceptions" -#: ../src/Doc/c-api/intro.rst:358 +#: c-api/intro.rst:358 msgid "" "The Python programmer only needs to deal with exceptions if specific error " "handling is required; unhandled exceptions are automatically propagated to " @@ -7493,7 +7538,7 @@ msgid "" msgstr "" # fe544a2be88c4bd3b51a4af5824fb07c -#: ../src/Doc/c-api/intro.rst:366 +#: c-api/intro.rst:366 msgid "" "For C programmers, however, error checking always has to be explicit. All " "functions in the Python/C API can raise exceptions, unless an explicit claim " @@ -7509,7 +7554,7 @@ msgid "" msgstr "" # 6164d993476b48909ccbc098a8f02056 -#: ../src/Doc/c-api/intro.rst:381 +#: c-api/intro.rst:381 msgid "" "Exception state is maintained in per-thread storage (this is equivalent to " "using global storage in an unthreaded application). A thread can be in one " @@ -7523,7 +7568,7 @@ msgid "" msgstr "" # 268eb884fc2043bc9035ea3e0abb4a0a -#: ../src/Doc/c-api/intro.rst:396 +#: c-api/intro.rst:396 msgid "" "The full exception state consists of three objects (all of which can be " "*NULL*): the exception type, the corresponding exception value, and the " @@ -7536,7 +7581,7 @@ msgid "" "loop, which takes care of transferring it to ``sys.exc_type`` and friends." msgstr "" -#: ../src/Doc/c-api/intro.rst:408 +#: c-api/intro.rst:408 msgid "" "Note that starting with Python 1.5, the preferred, thread-safe way to access " "the exception state from Python code is to call the function :func:`sys." @@ -7550,7 +7595,7 @@ msgid "" "referenced by the stack frames in the traceback." msgstr "" -#: ../src/Doc/c-api/intro.rst:419 +#: c-api/intro.rst:419 msgid "" "As a general principle, a function that calls another function to perform " "some task should check whether the called function raised an exception, and " @@ -7562,7 +7607,7 @@ msgid "" msgstr "" # 7168a1d998ba4d869fbd4531e7452a54 -#: ../src/Doc/c-api/intro.rst:428 +#: c-api/intro.rst:428 msgid "" "A simple example of detecting exceptions and passing them on is shown in " "the :c:func:`sum_sequence` example above. It so happens that this example " @@ -7571,12 +7616,12 @@ msgid "" "why you like Python, we show the equivalent Python code::" msgstr "" -#: ../src/Doc/c-api/intro.rst:443 +#: c-api/intro.rst:443 msgid "Here is the corresponding C code, in all its glory::" msgstr "" # 1f48917a12fd4f779a65dc1619696593 -#: ../src/Doc/c-api/intro.rst:495 +#: c-api/intro.rst:495 msgid "" "This example represents an endorsed use of the ``goto`` statement in C! It " "illustrates the use of :c:func:`PyErr_ExceptionMatches` and :c:func:" @@ -7589,11 +7634,11 @@ msgid "" "success after the final call made is successful." msgstr "" -#: ../src/Doc/c-api/intro.rst:509 +#: c-api/intro.rst:509 msgid "Embedding Python" msgstr "" -#: ../src/Doc/c-api/intro.rst:511 +#: c-api/intro.rst:511 msgid "" "The one important task that only embedders (as opposed to extension writers) " "of the Python interpreter have to worry about is the initialization, and " @@ -7602,7 +7647,7 @@ msgid "" msgstr "" # f09087750dfb40f8bd355e56845878af -#: ../src/Doc/c-api/intro.rst:525 +#: c-api/intro.rst:525 msgid "" "The basic initialization function is :c:func:`Py_Initialize`. This " "initializes the table of loaded modules, and creates the fundamental " @@ -7611,7 +7656,7 @@ msgid "" msgstr "" # 20f3109745ed426aa5aa3a67938b012c -#: ../src/Doc/c-api/intro.rst:532 +#: c-api/intro.rst:532 msgid "" ":c:func:`Py_Initialize` does not set the \"script argument list\" (``sys." "argv``). If this variable is needed by Python code that will be executed " @@ -7620,7 +7665,7 @@ msgid "" msgstr "" # 64c5ef23ed4e4f42b8f3d2ea8a4654c6 -#: ../src/Doc/c-api/intro.rst:537 +#: c-api/intro.rst:537 msgid "" "On most systems (in particular, on Unix and Windows, although the details " "are slightly different), :c:func:`Py_Initialize` calculates the module " @@ -7632,7 +7677,7 @@ msgid "" "on the shell command search path (the environment variable :envvar:`PATH`)." msgstr "" -#: ../src/Doc/c-api/intro.rst:546 +#: c-api/intro.rst:546 msgid "" "For instance, if the Python executable is found in :file:`/usr/local/bin/" "python`, it will assume that the libraries are in :file:`/usr/local/lib/" @@ -7644,7 +7689,7 @@ msgid "" msgstr "" # 6ff2dbf18a0e4545bda75bc276d81a78 -#: ../src/Doc/c-api/intro.rst:561 +#: c-api/intro.rst:561 msgid "" "The embedding application can steer the search by calling " "``Py_SetProgramName(file)`` *before* calling :c:func:`Py_Initialize`. Note " @@ -7656,7 +7701,7 @@ msgid "" msgstr "" # a71717c958634237a91857399a2ad37c -#: ../src/Doc/c-api/intro.rst:571 +#: c-api/intro.rst:571 msgid "" "Sometimes, it is desirable to \"uninitialize\" Python. For instance, the " "application may want to start over (make another call to :c:func:" @@ -7670,18 +7715,18 @@ msgid "" "released." msgstr "" -#: ../src/Doc/c-api/intro.rst:585 +#: c-api/intro.rst:585 msgid "Debugging Builds" msgstr "" -#: ../src/Doc/c-api/intro.rst:587 +#: c-api/intro.rst:587 msgid "" "Python can be built with several macros to enable extra checks of the " "interpreter and extension modules. These checks tend to add a large amount " "of overhead to the runtime so they are not enabled by default." msgstr "" -#: ../src/Doc/c-api/intro.rst:591 +#: c-api/intro.rst:591 msgid "" "A full list of the various types of debugging builds is in the file :file:" "`Misc/SpecialBuilds.txt` in the Python source distribution. Builds are " @@ -7692,7 +7737,7 @@ msgid "" msgstr "" # f703908759754e558b8e009f998cb43a -#: ../src/Doc/c-api/intro.rst:597 +#: c-api/intro.rst:597 msgid "" "Compiling the interpreter with the :c:macro:`Py_DEBUG` macro defined " "produces what is generally meant by \"a debug build\" of Python. :c:macro:" @@ -7702,63 +7747,63 @@ msgid "" "enabled in the Unix build, compiler optimization is disabled." msgstr "" -#: ../src/Doc/c-api/intro.rst:604 +#: c-api/intro.rst:604 msgid "" "In addition to the reference count debugging described below, the following " "extra checks are performed:" msgstr "" -#: ../src/Doc/c-api/intro.rst:607 +#: c-api/intro.rst:607 msgid "Extra checks are added to the object allocator." msgstr "" -#: ../src/Doc/c-api/intro.rst:609 +#: c-api/intro.rst:609 msgid "Extra checks are added to the parser and compiler." msgstr "" -#: ../src/Doc/c-api/intro.rst:611 +#: c-api/intro.rst:611 msgid "" "Downcasts from wide types to narrow types are checked for loss of " "information." msgstr "" -#: ../src/Doc/c-api/intro.rst:613 +#: c-api/intro.rst:613 msgid "" "A number of assertions are added to the dictionary and set implementations. " "In addition, the set object acquires a :meth:`test_c_api` method." msgstr "" -#: ../src/Doc/c-api/intro.rst:616 +#: c-api/intro.rst:616 msgid "Sanity checks of the input arguments are added to frame creation." msgstr "" # 4ecd3ed969454bff8b02e53447248ded -#: ../src/Doc/c-api/intro.rst:618 +#: c-api/intro.rst:618 msgid "" "The storage for long ints is initialized with a known invalid pattern to " "catch reference to uninitialized digits." msgstr "" -#: ../src/Doc/c-api/intro.rst:621 +#: c-api/intro.rst:621 msgid "" "Low-level tracing and extra exception checking are added to the runtime " "virtual machine." msgstr "" -#: ../src/Doc/c-api/intro.rst:624 +#: c-api/intro.rst:624 msgid "Extra checks are added to the memory arena implementation." msgstr "" -#: ../src/Doc/c-api/intro.rst:626 +#: c-api/intro.rst:626 msgid "Extra debugging is added to the thread module." msgstr "" -#: ../src/Doc/c-api/intro.rst:628 +#: c-api/intro.rst:628 msgid "There may be additional checks not mentioned here." msgstr "" # 5aa02e25739d45d5ba6d0882fe4145c1 -#: ../src/Doc/c-api/intro.rst:630 +#: c-api/intro.rst:630 msgid "" "Defining :c:macro:`Py_TRACE_REFS` enables reference tracing. When defined, " "a circular doubly linked list of active objects is maintained by adding two " @@ -7768,28 +7813,35 @@ msgid "" "macro:`Py_DEBUG`." msgstr "" -#: ../src/Doc/c-api/intro.rst:636 +#: c-api/intro.rst:636 msgid "" "Please refer to :file:`Misc/SpecialBuilds.txt` in the Python source " "distribution for more detailed information." msgstr "" -#: ../src/Doc/c-api/iter.rst:6 +#: c-api/iter.rst:6 msgid "Iterator Protocol" msgstr "" # 667bd7505afb4278ac173450b5819a7c -#: ../src/Doc/c-api/iter.rst:10 +#: c-api/iter.rst:10 msgid "There are two functions specifically for working with iterators." msgstr "" # 210df15ee0ff49b495c118b77c082de6 -#: ../src/Doc/c-api/iter.rst:15 +#: c-api/iter.rst:15 msgid "Return true if the object *o* supports the iterator protocol." msgstr "" +#: c-api/iter.rst:17 +msgid "" +"This function can return a false positive in the case of old-style classes " +"because those classes always define a :c:member:`tp_iternext` slot with " +"logic that either invokes a :meth:`next` method or raises a :exc:`TypeError`." +msgstr "" + # 27a4835b46c54981aaf9cda004e7ce68 -#: ../src/Doc/c-api/iter.rst:20 +#: c-api/iter.rst:24 msgid "" "Return the next value from the iteration *o*. The object must be an " "iterator (it is up to the caller to check this). If there are no remaining " @@ -7797,17 +7849,17 @@ msgid "" "retrieving the item, returns *NULL* and passes along the exception." msgstr "" -#: ../src/Doc/c-api/iter.rst:25 +#: c-api/iter.rst:29 msgid "" "To write a loop which iterates over an iterator, the C code should look " "something like this::" msgstr "" -#: ../src/Doc/c-api/iterator.rst:6 +#: c-api/iterator.rst:6 msgid "Iterator Objects" msgstr "" -#: ../src/Doc/c-api/iterator.rst:8 +#: c-api/iterator.rst:8 msgid "" "Python provides two general-purpose iterator objects. The first, a sequence " "iterator, works with an arbitrary sequence supporting the :meth:" @@ -7817,7 +7869,7 @@ msgid "" msgstr "" # 3eb373736e9e433f9f95ebb521887aaa -#: ../src/Doc/c-api/iterator.rst:17 +#: c-api/iterator.rst:17 msgid "" "Type object for iterator objects returned by :c:func:`PySeqIter_New` and the " "one-argument form of the :func:`iter` built-in function for built-in " @@ -7825,12 +7877,12 @@ msgid "" msgstr "" # 717e00b9a5ad459086cf1d5955b8d0a2 -#: ../src/Doc/c-api/iterator.rst:26 +#: c-api/iterator.rst:26 msgid "Return true if the type of *op* is :c:data:`PySeqIter_Type`." msgstr "" # df4018231d214f26abea5f875c47ac4d -#: ../src/Doc/c-api/iterator.rst:33 +#: c-api/iterator.rst:33 msgid "" "Return an iterator that works with a general sequence object, *seq*. The " "iteration ends when the sequence raises :exc:`IndexError` for the " @@ -7838,19 +7890,19 @@ msgid "" msgstr "" # 9b554855e05b4dc1ae3faf963f255ae6 -#: ../src/Doc/c-api/iterator.rst:42 +#: c-api/iterator.rst:42 msgid "" "Type object for iterator objects returned by :c:func:`PyCallIter_New` and " "the two-argument form of the :func:`iter` built-in function." msgstr "" # b077a418908b48ee88f704d198c617af -#: ../src/Doc/c-api/iterator.rst:50 +#: c-api/iterator.rst:50 msgid "Return true if the type of *op* is :c:data:`PyCallIter_Type`." msgstr "" # c800254e59e541878844cbbd4532747b -#: ../src/Doc/c-api/iterator.rst:57 +#: c-api/iterator.rst:57 msgid "" "Return a new iterator. The first parameter, *callable*, can be any Python " "callable object that can be called with no parameters; each call to it " @@ -7858,43 +7910,43 @@ msgid "" "value equal to *sentinel*, the iteration will be terminated." msgstr "" -#: ../src/Doc/c-api/list.rst:6 +#: c-api/list.rst:6 msgid "List Objects" msgstr "" # 87ab89832ea748e29b4ccf59886e70d9 -#: ../src/Doc/c-api/list.rst:13 +#: c-api/list.rst:13 msgid "This subtype of :c:type:`PyObject` represents a Python list object." msgstr "" # 69b79e85e5c04301bbefa1f64f571273 -#: ../src/Doc/c-api/list.rst:18 +#: c-api/list.rst:18 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python list type. " "This is the same object as ``list`` in the Python layer." msgstr "" # 5370cb112617448bbdda10df233681fa -#: ../src/Doc/c-api/list.rst:24 +#: c-api/list.rst:24 msgid "" "Return true if *p* is a list object or an instance of a subtype of the list " "type." msgstr "" # 0683bbbe31bc42dc8dff627e4b6df74c -#: ../src/Doc/c-api/list.rst:33 +#: c-api/list.rst:33 msgid "" "Return true if *p* is a list object, but not an instance of a subtype of the " "list type." msgstr "" # 6fdd70061fdc40629c1dc79147c93c42 -#: ../src/Doc/c-api/list.rst:41 +#: c-api/list.rst:41 msgid "Return a new list of length *len* on success, or *NULL* on failure." msgstr "" # d527e2a32bd34270b6893cb7b7823ed0 -#: ../src/Doc/c-api/list.rst:45 +#: c-api/list.rst:45 msgid "" "If *len* is greater than zero, the returned list object's items are set to " "``NULL``. Thus you cannot use abstract API functions such as :c:func:" @@ -7902,20 +7954,38 @@ msgid "" "items to a real object with :c:func:`PyList_SetItem`." msgstr "" +#: c-api/list.rst:50 +msgid "" +"This function used an :c:type:`int` for *size*. This might require changes " +"in your code for properly supporting 64-bit systems." +msgstr "" + # 0f10a685c298435397ed20f079bf3275 -#: ../src/Doc/c-api/list.rst:59 +#: c-api/list.rst:59 msgid "" "Return the length of the list object in *list*; this is equivalent to " "``len(list)`` on a list object." msgstr "" +#: c-api/list.rst:62 c-api/set.rst:119 +msgid "" +"This function returned an :c:type:`int`. This might require changes in your " +"code for properly supporting 64-bit systems." +msgstr "" + # e4220c15cb2f436fbf6dc4eecb8bd401 -#: ../src/Doc/c-api/list.rst:69 +#: c-api/list.rst:69 msgid "Macro form of :c:func:`PyList_Size` without error checking." msgstr "" +#: c-api/list.rst:71 +msgid "" +"This macro returned an :c:type:`int`. This might require changes in your " +"code for properly supporting 64-bit systems." +msgstr "" + # 77415a364cd044278bd2d50421924b28 -#: ../src/Doc/c-api/list.rst:78 +#: c-api/list.rst:78 msgid "" "Return the object at position *index* in the list pointed to by *list*. The " "position must be positive, indexing from the end of the list is not " @@ -7923,34 +7993,46 @@ msgid "" "`IndexError` exception." msgstr "" +#: c-api/list.rst:83 c-api/list.rst:107 c-api/list.rst:135 +msgid "" +"This function used an :c:type:`int` for *index*. This might require changes " +"in your code for properly supporting 64-bit systems." +msgstr "" + # bb6f42cfbf9f4b388a6f44a2a241bcbf -#: ../src/Doc/c-api/list.rst:90 +#: c-api/list.rst:90 msgid "Macro form of :c:func:`PyList_GetItem` without error checking." msgstr "" +#: c-api/list.rst:92 c-api/list.rst:124 +msgid "" +"This macro used an :c:type:`int` for *i*. This might require changes in your " +"code for properly supporting 64-bit systems." +msgstr "" + # 0cea0c4fa41046e5823cad96f117fa3e -#: ../src/Doc/c-api/list.rst:99 +#: c-api/list.rst:99 msgid "" "Set the item at index *index* in list to *item*. Return ``0`` on success or " "``-1`` on failure." msgstr "" # a911387e91ac474f9418c8c7a3422be3 -#: ../src/Doc/c-api/list.rst:104 +#: c-api/list.rst:104 msgid "" "This function \"steals\" a reference to *item* and discards a reference to " "an item already in the list at the affected position." msgstr "" # e3a4738763a94c4791b3b0997c9cec2f -#: ../src/Doc/c-api/list.rst:114 +#: c-api/list.rst:114 msgid "" "Macro form of :c:func:`PyList_SetItem` without error checking. This is " "normally only used to fill in new lists where there is no previous content." msgstr "" # 356992a393a54bf9a901c7babc38d151 -#: ../src/Doc/c-api/list.rst:119 +#: c-api/list.rst:119 msgid "" "This macro \"steals\" a reference to *item*, and, unlike :c:func:" "`PyList_SetItem`, does *not* discard a reference to any item that it being " @@ -7958,7 +8040,7 @@ msgid "" msgstr "" # e1653b8812f244229f5de8bdb7c1cd99 -#: ../src/Doc/c-api/list.rst:131 +#: c-api/list.rst:131 msgid "" "Insert the item *item* into list *list* in front of index *index*. Return " "``0`` if successful; return ``-1`` and set an exception if unsuccessful. " @@ -7966,7 +8048,7 @@ msgid "" msgstr "" # bc2c8331d180471db577c4879538d38d -#: ../src/Doc/c-api/list.rst:142 +#: c-api/list.rst:142 msgid "" "Append the object *item* at the end of list *list*. Return ``0`` if " "successful; return ``-1`` and set an exception if unsuccessful. Analogous " @@ -7974,7 +8056,7 @@ msgid "" msgstr "" # eec44869c2074de09174e16679f51012 -#: ../src/Doc/c-api/list.rst:149 +#: c-api/list.rst:149 msgid "" "Return a list of the objects in *list* containing the objects *between* " "*low* and *high*. Return *NULL* and set an exception if unsuccessful. " @@ -7982,8 +8064,14 @@ msgid "" "Python, are not supported." msgstr "" +#: c-api/list.rst:154 c-api/list.rst:167 +msgid "" +"This function used an :c:type:`int` for *low* and *high*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + # f48889da097b479593bbd542edd1380a -#: ../src/Doc/c-api/list.rst:161 +#: c-api/list.rst:161 msgid "" "Set the slice of *list* between *low* and *high* to the contents of " "*itemlist*. Analogous to ``list[low:high] = itemlist``. The *itemlist* may " @@ -7993,108 +8081,108 @@ msgid "" msgstr "" # 1ad237a04dfa414ba80a23a45a323b2f -#: ../src/Doc/c-api/list.rst:174 +#: c-api/list.rst:174 msgid "" "Sort the items of *list* in place. Return ``0`` on success, ``-1`` on " "failure. This is equivalent to ``list.sort()``." msgstr "" # 4630a42fe7404ba987ed6eedb995f9e4 -#: ../src/Doc/c-api/list.rst:180 +#: c-api/list.rst:180 msgid "" "Reverse the items of *list* in place. Return ``0`` on success, ``-1`` on " "failure. This is the equivalent of ``list.reverse()``." msgstr "" # f224c856bcfd4668a3665fd57cf5e932 -#: ../src/Doc/c-api/list.rst:188 +#: c-api/list.rst:188 msgid "" "Return a new tuple object containing the contents of *list*; equivalent to " "``tuple(list)``." msgstr "" -#: ../src/Doc/c-api/long.rst:6 +#: c-api/long.rst:6 #, fuzzy msgid "Long Integer Objects" msgstr "Autres Objets" # 6feedc0fa1de4fc9a050505bea357e6d -#: ../src/Doc/c-api/long.rst:13 +#: c-api/long.rst:13 msgid "" "This subtype of :c:type:`PyObject` represents a Python long integer object." msgstr "" # eef383e71a704c1e8c1170ff010d8884 -#: ../src/Doc/c-api/long.rst:20 +#: c-api/long.rst:20 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python long integer " "type. This is the same object as ``long`` and ``types.LongType``." msgstr "" # ac39de376fdf4154917febbdc959da14 -#: ../src/Doc/c-api/long.rst:26 +#: c-api/long.rst:26 msgid "" "Return true if its argument is a :c:type:`PyLongObject` or a subtype of :c:" "type:`PyLongObject`." msgstr "" # 636671c0724a42178da25696eaa1d0d7 -#: ../src/Doc/c-api/long.rst:35 +#: c-api/long.rst:35 msgid "" "Return true if its argument is a :c:type:`PyLongObject`, but not a subtype " "of :c:type:`PyLongObject`." msgstr "" # a66d768a9a4d437eb2ef1081fdcbb2fc -#: ../src/Doc/c-api/long.rst:43 +#: c-api/long.rst:43 msgid "" "Return a new :c:type:`PyLongObject` object from *v*, or *NULL* on failure." msgstr "" # dba82f43a4f94ff89bbe1f3d7d86746b -#: ../src/Doc/c-api/long.rst:48 +#: c-api/long.rst:48 msgid "" "Return a new :c:type:`PyLongObject` object from a C :c:type:`unsigned long`, " "or *NULL* on failure." msgstr "" # e1d447c930f84e418d4019692b69d5ed -#: ../src/Doc/c-api/long.rst:54 +#: c-api/long.rst:54 msgid "" "Return a new :c:type:`PyLongObject` object from a C :c:type:`Py_ssize_t`, or " "*NULL* on failure." msgstr "" # 6ba5e2e02825435383bc19c429140877 -#: ../src/Doc/c-api/long.rst:62 +#: c-api/long.rst:62 msgid "" "Return a new :c:type:`PyLongObject` object from a C :c:type:`size_t`, or " "*NULL* on failure." msgstr "" # bb589fa886f5478f8fff9ed170148b5a -#: ../src/Doc/c-api/long.rst:70 +#: c-api/long.rst:70 msgid "" "Return a new :c:type:`PyLongObject` object from a C :c:type:`long long`, or " "*NULL* on failure." msgstr "" # 98f177674b234a9992c6a218a7826c9f -#: ../src/Doc/c-api/long.rst:76 +#: c-api/long.rst:76 msgid "" "Return a new :c:type:`PyLongObject` object from a C :c:type:`unsigned long " "long`, or *NULL* on failure." msgstr "" # b51d2ac612724361818d685c6b666d45 -#: ../src/Doc/c-api/long.rst:82 +#: c-api/long.rst:82 msgid "" "Return a new :c:type:`PyLongObject` object from the integer part of *v*, or " "*NULL* on failure." msgstr "" # 0dafe331119341ff9891dca394527a85 -#: ../src/Doc/c-api/long.rst:88 +#: c-api/long.rst:88 msgid "" "Return a new :c:type:`PyLongObject` based on the string value in *str*, " "which is interpreted according to the radix in *base*. If *pend* is non-" @@ -8108,7 +8196,7 @@ msgid "" msgstr "" # ad9e2203296e4079bf78cf9aa4ed2dae -#: ../src/Doc/c-api/long.rst:101 +#: c-api/long.rst:101 msgid "" "Convert a sequence of Unicode digits to a Python long integer value. The " "first parameter, *u*, points to the first character of the Unicode string, " @@ -8117,16 +8205,27 @@ msgid "" "exc:`ValueError` will be raised." msgstr "" +#: c-api/long.rst:109 +msgid "" +"This function used an :c:type:`int` for *length*. This might require changes " +"in your code for properly supporting 64-bit systems." +msgstr "" + # 0d7298e3043d4723b5a449b9e7c8b120 -#: ../src/Doc/c-api/long.rst:116 +#: c-api/long.rst:116 msgid "" "Create a Python integer or long integer from the pointer *p*. The pointer " "value can be retrieved from the resulting value using :c:func:" "`PyLong_AsVoidPtr`." msgstr "" +#: c-api/long.rst:121 +msgid "" +"If the integer is larger than LONG_MAX, a positive long integer is returned." +msgstr "" + # af34f3f689234422a526d3b46dd6c323 -#: ../src/Doc/c-api/long.rst:131 +#: c-api/long.rst:131 msgid "" "Return a C :c:type:`long` representation of the contents of *pylong*. If " "*pylong* is greater than :const:`LONG_MAX`, an :exc:`OverflowError` is " @@ -8134,7 +8233,7 @@ msgid "" msgstr "" # adb5330a6dd34ff0bf1a93c2cb6283a8 -#: ../src/Doc/c-api/long.rst:138 +#: c-api/long.rst:138 msgid "" "Return a C :c:type:`long` representation of the contents of *pylong*. If " "*pylong* is greater than :const:`LONG_MAX` or less than :const:`LONG_MIN`, " @@ -8145,7 +8244,7 @@ msgid "" msgstr "" # 8cef90a92bf940cbb689aab81439ab38 -#: ../src/Doc/c-api/long.rst:151 +#: c-api/long.rst:151 msgid "" "Return a C :c:type:`long long` representation of the contents of *pylong*. " "If *pylong* is greater than :const:`PY_LLONG_MAX` or less than :const:" @@ -8156,7 +8255,7 @@ msgid "" msgstr "" # 4a7ae713f5ce48179432175d536c7cfe -#: ../src/Doc/c-api/long.rst:168 +#: c-api/long.rst:168 msgid "" "Return a C :c:type:`Py_ssize_t` representation of the contents of *pylong*. " "If *pylong* is greater than :const:`PY_SSIZE_T_MAX`, an :exc:`OverflowError` " @@ -8164,7 +8263,7 @@ msgid "" msgstr "" # a3844fe9ee284618834a2feca60e9b5e -#: ../src/Doc/c-api/long.rst:181 +#: c-api/long.rst:181 msgid "" "Return a C :c:type:`unsigned long` representation of the contents of " "*pylong*. If *pylong* is greater than :const:`ULONG_MAX`, an :exc:" @@ -8172,7 +8271,7 @@ msgid "" msgstr "" # 585460f9052f43658c46275c47f750a4 -#: ../src/Doc/c-api/long.rst:191 +#: c-api/long.rst:191 msgid "" "Return a C :c:type:`long long` from a Python long integer. If *pylong* " "cannot be represented as a :c:type:`long long`, an :exc:`OverflowError` is " @@ -8180,29 +8279,34 @@ msgid "" msgstr "" # f245c23a0ce54bfc9079dabe23228d93 -#: ../src/Doc/c-api/long.rst:203 +#: c-api/long.rst:203 msgid "" "Return a C :c:type:`unsigned long long` from a Python long integer. If " "*pylong* cannot be represented as an :c:type:`unsigned long long`, an :exc:" "`OverflowError` is raised and ``(unsigned long long)-1`` is returned." msgstr "" +#: c-api/long.rst:210 +msgid "" +"A negative *pylong* now raises :exc:`OverflowError`, not :exc:`TypeError`." +msgstr "" + # af0283245e2f4248b76d3f670656334e -#: ../src/Doc/c-api/long.rst:217 +#: c-api/long.rst:217 msgid "" "Return a C :c:type:`unsigned long` from a Python long integer, without " "checking for overflow." msgstr "" # da0bae17eac840d28eca0418294fb013 -#: ../src/Doc/c-api/long.rst:225 +#: c-api/long.rst:225 msgid "" "Return a C :c:type:`unsigned long long` from a Python long integer, without " "checking for overflow." msgstr "" # e5516ae3d0b1415594878cb43fbdbda3 -#: ../src/Doc/c-api/long.rst:233 +#: c-api/long.rst:233 msgid "" "Return a C :c:type:`double` representation of the contents of *pylong*. If " "*pylong* cannot be approximately represented as a :c:type:`double`, an :exc:" @@ -8210,7 +8314,7 @@ msgid "" msgstr "" # 31566cacbc304c17b2223d0cf8245b9d -#: ../src/Doc/c-api/long.rst:240 +#: c-api/long.rst:240 msgid "" "Convert a Python integer or long integer *pylong* to a C :c:type:`void` " "pointer. If *pylong* cannot be converted, an :exc:`OverflowError` will be " @@ -8218,35 +8322,47 @@ msgid "" "values created with :c:func:`PyLong_FromVoidPtr`." msgstr "" -#: ../src/Doc/c-api/mapping.rst:6 +#: c-api/long.rst:247 +msgid "" +"For values outside 0..LONG_MAX, both signed and unsigned integers are " +"accepted." +msgstr "" + +#: c-api/mapping.rst:6 msgid "Mapping Protocol" msgstr "" # b72696976b504a54ae2a246c383e2192 -#: ../src/Doc/c-api/mapping.rst:11 +#: c-api/mapping.rst:11 msgid "" "Return ``1`` if the object provides mapping protocol, and ``0`` otherwise. " "This function always succeeds." msgstr "" # 6888276fef474b139aede41ca9ce0138 -#: ../src/Doc/c-api/mapping.rst:20 +#: c-api/mapping.rst:20 msgid "" "Returns the number of keys in object *o* on success, and ``-1`` on failure. " "For objects that do not provide mapping protocol, this is equivalent to the " "Python expression ``len(o)``." msgstr "" +#: c-api/mapping.rst:24 c-api/object.rst:357 c-api/sequence.rst:24 +msgid "" +"These functions returned an :c:type:`int` type. This might require changes " +"in your code for properly supporting 64-bit systems." +msgstr "" + # 3518a3972bfa44feb561e0d6724a6eaa # 2ac05a7af15140abae1761b3f69c0af7 -#: ../src/Doc/c-api/mapping.rst:31 ../src/Doc/c-api/mapping.rst:37 +#: c-api/mapping.rst:31 c-api/mapping.rst:37 msgid "" "Remove the mapping for object *key* from the object *o*. Return ``-1`` on " "failure. This is equivalent to the Python statement ``del o[key]``." msgstr "" # 42c3dcff05fc450484e6532a1df6ebb6 -#: ../src/Doc/c-api/mapping.rst:43 +#: c-api/mapping.rst:43 msgid "" "On success, return ``1`` if the mapping object has the key *key* and ``0`` " "otherwise. This is equivalent to ``o[key]``, returning ``True`` on success " @@ -8254,7 +8370,7 @@ msgid "" msgstr "" # c8923b8b0a3b470db3c950d554b4b661 -#: ../src/Doc/c-api/mapping.rst:50 +#: c-api/mapping.rst:50 msgid "" "Return ``1`` if the mapping object has the key *key* and ``0`` otherwise. " "This is equivalent to ``o[key]``, returning ``True`` on success and " @@ -8262,21 +8378,21 @@ msgid "" msgstr "" # 140cd35f585447869e345ec27eb51f94 -#: ../src/Doc/c-api/mapping.rst:57 +#: c-api/mapping.rst:57 msgid "" "On success, return a list of the keys in object *o*. On failure, return " "*NULL*. This is equivalent to the Python expression ``o.keys()``." msgstr "" # 43f8a010f2a5434ba45e9bf0141f8c0d -#: ../src/Doc/c-api/mapping.rst:63 +#: c-api/mapping.rst:63 msgid "" "On success, return a list of the values in object *o*. On failure, return " "*NULL*. This is equivalent to the Python expression ``o.values()``." msgstr "" # ea5e4bd57fc84212bf5c1602a443aa81 -#: ../src/Doc/c-api/mapping.rst:69 +#: c-api/mapping.rst:69 msgid "" "On success, return a list of the items in object *o*, where each item is a " "tuple containing a key-value pair. On failure, return *NULL*. This is " @@ -8285,24 +8401,24 @@ msgstr "" # df5b263214a34c828e61ed3f852c8741 # 1b0219bdd7044d10b5950e1657041554 -#: ../src/Doc/c-api/mapping.rst:76 ../src/Doc/c-api/object.rst:364 +#: c-api/mapping.rst:76 c-api/object.rst:364 msgid "" "Return element of *o* corresponding to the object *key* or *NULL* on " "failure. This is the equivalent of the Python expression ``o[key]``." msgstr "" # 4fe1615dc3344b0f93d36e30d182d3fc -#: ../src/Doc/c-api/mapping.rst:82 +#: c-api/mapping.rst:82 msgid "" "Map the object *key* to the value *v* in object *o*. Returns ``-1`` on " "failure. This is the equivalent of the Python statement ``o[key] = v``." msgstr "" -#: ../src/Doc/c-api/marshal.rst:6 +#: c-api/marshal.rst:6 msgid "Data marshalling support" msgstr "" -#: ../src/Doc/c-api/marshal.rst:8 +#: c-api/marshal.rst:8 msgid "" "These routines allow C code to work with serialized objects using the same " "data format as the :mod:`marshal` module. There are functions to write data " @@ -8311,12 +8427,12 @@ msgid "" "binary mode." msgstr "" -#: ../src/Doc/c-api/marshal.rst:14 +#: c-api/marshal.rst:14 msgid "Numeric values are stored with the least significant byte first." msgstr "" # c13f0fa17af443d085501f80bd70824f -#: ../src/Doc/c-api/marshal.rst:16 +#: c-api/marshal.rst:16 msgid "" "The module supports two versions of the data format: version 0 is the " "historical version, version 1 (new in Python 2.4) shares interned strings in " @@ -8326,29 +8442,33 @@ msgid "" msgstr "" # d730a12b867641d6a0d2913370b912b1 -#: ../src/Doc/c-api/marshal.rst:25 +#: c-api/marshal.rst:25 msgid "" "Marshal a :c:type:`long` integer, *value*, to *file*. This will only write " "the least-significant 32 bits of *value*; regardless of the size of the " "native :c:type:`long` type." msgstr "" +#: c-api/marshal.rst:29 c-api/marshal.rst:37 c-api/marshal.rst:45 +msgid "*version* indicates the file format." +msgstr "" + # 3e414b1b16b74dae932b306dc896c253 -#: ../src/Doc/c-api/marshal.rst:35 +#: c-api/marshal.rst:35 msgid "Marshal a Python object, *value*, to *file*." msgstr "" # 7ef39640e6e0431a817ed3535348d91e -#: ../src/Doc/c-api/marshal.rst:43 +#: c-api/marshal.rst:43 msgid "" "Return a string object containing the marshalled representation of *value*." msgstr "" -#: ../src/Doc/c-api/marshal.rst:49 +#: c-api/marshal.rst:49 msgid "The following functions allow marshalled values to be read back in." msgstr "" -#: ../src/Doc/c-api/marshal.rst:51 +#: c-api/marshal.rst:51 msgid "" "XXX What about error detection? It appears that reading past the end of the " "file will always result in a negative numeric value (where that's relevant), " @@ -8358,7 +8478,7 @@ msgid "" msgstr "" # e459b0735b424b259d0b91329188ef6c -#: ../src/Doc/c-api/marshal.rst:60 +#: c-api/marshal.rst:60 msgid "" "Return a C :c:type:`long` from the data stream in a :c:type:`FILE\\*` opened " "for reading. Only a 32-bit value can be read in using this function, " @@ -8366,7 +8486,7 @@ msgid "" msgstr "" # 7d79e685bb214a9a92cbc33337d7c13b -#: ../src/Doc/c-api/marshal.rst:67 +#: c-api/marshal.rst:67 msgid "" "Return a C :c:type:`short` from the data stream in a :c:type:`FILE\\*` " "opened for reading. Only a 16-bit value can be read in using this function, " @@ -8374,7 +8494,7 @@ msgid "" msgstr "" # 200bcabe55d54f8195f4081547acd1b9 -#: ../src/Doc/c-api/marshal.rst:74 +#: c-api/marshal.rst:74 msgid "" "Return a Python object from the data stream in a :c:type:`FILE\\*` opened " "for reading. On error, sets the appropriate exception (:exc:`EOFError` or :" @@ -8382,7 +8502,7 @@ msgid "" msgstr "" # 28d22af61bdb41c4be4d0334ff751c31 -#: ../src/Doc/c-api/marshal.rst:81 +#: c-api/marshal.rst:81 msgid "" "Return a Python object from the data stream in a :c:type:`FILE\\*` opened " "for reading. Unlike :c:func:`PyMarshal_ReadObjectFromFile`, this function " @@ -8395,22 +8515,28 @@ msgid "" msgstr "" # b9b2923a5009424db0c8b877d613699f -#: ../src/Doc/c-api/marshal.rst:93 +#: c-api/marshal.rst:93 msgid "" "Return a Python object from the data stream in a character buffer containing " "*len* bytes pointed to by *string*. On error, sets the appropriate " "exception (:exc:`EOFError` or :exc:`TypeError`) and returns *NULL*." msgstr "" -#: ../src/Doc/c-api/memory.rst:8 +#: c-api/marshal.rst:98 c-api/string.rst:63 c-api/tuple.rst:45 +msgid "" +"This function used an :c:type:`int` type for *len*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + +#: c-api/memory.rst:8 msgid "Memory Management" msgstr "" -#: ../src/Doc/c-api/memory.rst:17 +#: c-api/memory.rst:17 msgid "Overview" msgstr "" -#: ../src/Doc/c-api/memory.rst:19 +#: c-api/memory.rst:19 msgid "" "Memory management in Python involves a private heap containing all Python " "objects and data structures. The management of this private heap is ensured " @@ -8419,7 +8545,7 @@ msgid "" "aspects, like sharing, segmentation, preallocation or caching." msgstr "" -#: ../src/Doc/c-api/memory.rst:25 +#: c-api/memory.rst:25 msgid "" "At the lowest level, a raw memory allocator ensures that there is enough " "room in the private heap for storing all Python-related data by interacting " @@ -8433,7 +8559,7 @@ msgid "" "but ensures that the latter operate within the bounds of the private heap." msgstr "" -#: ../src/Doc/c-api/memory.rst:36 +#: c-api/memory.rst:36 msgid "" "It is important to understand that the management of the Python heap is " "performed by the interpreter itself and that the user has no control over " @@ -8444,7 +8570,7 @@ msgid "" msgstr "" # 548d2ab0d8274e2ead5ff5960d783d41 -#: ../src/Doc/c-api/memory.rst:49 +#: c-api/memory.rst:49 msgid "" "To avoid memory corruption, extension writers should never try to operate on " "Python objects with the functions exported by the C library: :c:func:" @@ -8456,14 +8582,14 @@ msgid "" "in the following example::" msgstr "" -#: ../src/Doc/c-api/memory.rst:68 +#: c-api/memory.rst:68 msgid "" "In this example, the memory request for the I/O buffer is handled by the C " "library allocator. The Python memory manager is involved only in the " "allocation of the string object returned as a result." msgstr "" -#: ../src/Doc/c-api/memory.rst:72 +#: c-api/memory.rst:72 msgid "" "In most situations, however, it is recommended to allocate memory from the " "Python heap specifically because the latter is under control of the Python " @@ -8481,11 +8607,11 @@ msgid "" "completely the Python memory manager." msgstr "" -#: ../src/Doc/c-api/memory.rst:90 +#: c-api/memory.rst:90 msgid "Memory Interface" msgstr "" -#: ../src/Doc/c-api/memory.rst:92 +#: c-api/memory.rst:92 msgid "" "The following function sets, modeled after the ANSI C standard, but " "specifying behavior when requesting zero bytes, are available for allocating " @@ -8493,7 +8619,7 @@ msgid "" msgstr "" # 97bad29b7a714848913946c03ddd06b7 -#: ../src/Doc/c-api/memory.rst:99 +#: c-api/memory.rst:99 msgid "" "Allocates *n* bytes and returns a pointer of type :c:type:`void\\*` to the " "allocated memory, or *NULL* if the request fails. Requesting zero bytes " @@ -8503,7 +8629,7 @@ msgid "" msgstr "" # 5fdace27c5be454b96fb0754260da595 -#: ../src/Doc/c-api/memory.rst:107 +#: c-api/memory.rst:107 msgid "" "Resizes the memory block pointed to by *p* to *n* bytes. The contents will " "be unchanged to the minimum of the old and the new sizes. If *p* is *NULL*, " @@ -8516,7 +8642,7 @@ msgid "" msgstr "" # 2e11e74b2fb94f3383c59a60efe8bdd9 -#: ../src/Doc/c-api/memory.rst:119 +#: c-api/memory.rst:119 msgid "" "Frees the memory block pointed to by *p*, which must have been returned by a " "previous call to :c:func:`PyMem_Malloc` or :c:func:`PyMem_Realloc`. " @@ -8524,14 +8650,14 @@ msgid "" "behavior occurs. If *p* is *NULL*, no operation is performed." msgstr "" -#: ../src/Doc/c-api/memory.rst:124 +#: c-api/memory.rst:124 msgid "" "The following type-oriented macros are provided for convenience. Note that " "*TYPE* refers to any C type." msgstr "" # 9f10048ad9b443d48637735acf9536ce -#: ../src/Doc/c-api/memory.rst:130 +#: c-api/memory.rst:130 msgid "" "Same as :c:func:`PyMem_Malloc`, but allocates ``(n * sizeof(TYPE))`` bytes " "of memory. Returns a pointer cast to :c:type:`TYPE\\*`. The memory will " @@ -8539,7 +8665,7 @@ msgid "" msgstr "" # 3707de11ae0a4f2e8c33379a9d04c34a -#: ../src/Doc/c-api/memory.rst:137 +#: c-api/memory.rst:137 msgid "" "Same as :c:func:`PyMem_Realloc`, but the memory block is resized to ``(n * " "sizeof(TYPE))`` bytes. Returns a pointer cast to :c:type:`TYPE\\*`. On " @@ -8549,11 +8675,11 @@ msgid "" msgstr "" # 0f7be95b2ad94db49365ea22adfa3b68 -#: ../src/Doc/c-api/memory.rst:146 +#: c-api/memory.rst:146 msgid "Same as :c:func:`PyMem_Free`." msgstr "" -#: ../src/Doc/c-api/memory.rst:148 +#: c-api/memory.rst:148 msgid "" "In addition, the following macro sets are provided for calling the Python " "memory allocator directly, without involving the C API functions listed " @@ -8562,31 +8688,31 @@ msgid "" msgstr "" # b00fd5b73af14b7cb055dc985f1d7ce8 -#: ../src/Doc/c-api/memory.rst:153 +#: c-api/memory.rst:153 msgid ":c:func:`PyMem_MALLOC`, :c:func:`PyMem_REALLOC`, :c:func:`PyMem_FREE`." msgstr "" # 50df6e371c9a40d38abb89674c3b41b8 -#: ../src/Doc/c-api/memory.rst:155 +#: c-api/memory.rst:155 msgid ":c:func:`PyMem_NEW`, :c:func:`PyMem_RESIZE`, :c:func:`PyMem_DEL`." msgstr "" -#: ../src/Doc/c-api/memory.rst:161 +#: c-api/memory.rst:161 msgid "Examples" msgstr "" -#: ../src/Doc/c-api/memory.rst:163 +#: c-api/memory.rst:163 msgid "" "Here is the example from section :ref:`memoryoverview`, rewritten so that " "the I/O buffer is allocated from the Python heap by using the first function " "set::" msgstr "" -#: ../src/Doc/c-api/memory.rst:176 +#: c-api/memory.rst:176 msgid "The same code using the type-oriented function set::" msgstr "" -#: ../src/Doc/c-api/memory.rst:188 +#: c-api/memory.rst:188 msgid "" "Note that in the two examples above, the buffer is always manipulated via " "functions belonging to the same set. Indeed, it is required to use the same " @@ -8597,46 +8723,46 @@ msgid "" msgstr "" # 867858c725a64316ad90b887d69b244b -#: ../src/Doc/c-api/memory.rst:203 +#: c-api/memory.rst:203 msgid "" "In addition to the functions aimed at handling raw memory blocks from the " "Python heap, objects in Python are allocated and released with :c:func:" "`PyObject_New`, :c:func:`PyObject_NewVar` and :c:func:`PyObject_Del`." msgstr "" -#: ../src/Doc/c-api/memory.rst:207 +#: c-api/memory.rst:207 msgid "" "These will be explained in the next chapter on defining and implementing new " "object types in C." msgstr "" -#: ../src/Doc/c-api/method.rst:6 +#: c-api/method.rst:6 msgid "Method Objects" msgstr "Les objets méthode" # 508ea530b60141c0bc07324d03466b38 -#: ../src/Doc/c-api/method.rst:10 +#: c-api/method.rst:10 msgid "" "There are some useful functions that are useful for working with method " "objects." msgstr "" # 37863ef06f5440599137c9df9f8ad268 -#: ../src/Doc/c-api/method.rst:17 +#: c-api/method.rst:17 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python method type. " "This is exposed to Python programs as ``types.MethodType``." msgstr "" # d79c7aaf06dd4b3bb08ca6e879a9dcdb -#: ../src/Doc/c-api/method.rst:23 +#: c-api/method.rst:23 msgid "" "Return true if *o* is a method object (has type :c:data:`PyMethod_Type`). " "The parameter must not be *NULL*." msgstr "" # 59adbc6adc4148d18577e3a9db32188c -#: ../src/Doc/c-api/method.rst:29 +#: c-api/method.rst:29 msgid "" "Return a new method object, with *func* being any callable object; this is " "the function that will be called when the method is called. If this method " @@ -8646,77 +8772,76 @@ msgid "" msgstr "" # 5237e828d04d411d88db837c76b183dc -#: ../src/Doc/c-api/method.rst:38 +#: c-api/method.rst:38 msgid "" "Return the class object from which the method *meth* was created; if this " "was created from an instance, it will be the class of the instance." msgstr "" # 4c75327632f44f248582050eb2015a0c -#: ../src/Doc/c-api/method.rst:44 +#: c-api/method.rst:44 msgid "Macro version of :c:func:`PyMethod_Class` which avoids error checking." msgstr "" # 8dd6c69d0bf1443ab357df8227de26e1 -#: ../src/Doc/c-api/method.rst:49 +#: c-api/method.rst:49 msgid "Return the function object associated with the method *meth*." msgstr "" # 2b66c63e952d4355b12dab82db0e9fc1 -#: ../src/Doc/c-api/method.rst:54 +#: c-api/method.rst:54 msgid "" "Macro version of :c:func:`PyMethod_Function` which avoids error checking." msgstr "" # 8479f9480bf046848f2c3e183e7754f8 -#: ../src/Doc/c-api/method.rst:59 +#: c-api/method.rst:59 msgid "" "Return the instance associated with the method *meth* if it is bound, " "otherwise return *NULL*." msgstr "" # cc3dca38c86344aaa78d08c47d36fe92 -#: ../src/Doc/c-api/method.rst:65 +#: c-api/method.rst:65 msgid "Macro version of :c:func:`PyMethod_Self` which avoids error checking." msgstr "" # a6a72574d6074a6bbf55dadc77e26234 # 8dab4913d1554f07a41cbcfc011d33f7 # ae1920082d5a414ab120183edc3100df -#: ../src/Doc/c-api/method.rst:70 ../src/Doc/c-api/tuple.rst:162 -#: ../src/Doc/c-api/unicode.rst:104 +#: c-api/method.rst:70 c-api/tuple.rst:162 c-api/unicode.rst:104 msgid "Clear the free list. Return the total number of freed items." msgstr "" -#: ../src/Doc/c-api/module.rst:6 +#: c-api/module.rst:6 msgid "Module Objects" msgstr "" -#: ../src/Doc/c-api/module.rst:10 +#: c-api/module.rst:10 msgid "There are only a few functions special to module objects." msgstr "" # 909b62d3074249e690a45db0123b7300 -#: ../src/Doc/c-api/module.rst:17 +#: c-api/module.rst:17 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python module type. " "This is exposed to Python programs as ``types.ModuleType``." msgstr "" # 8b725b91dc6540649161e55562c98fd0 -#: ../src/Doc/c-api/module.rst:23 +#: c-api/module.rst:23 msgid "Return true if *p* is a module object, or a subtype of a module object." msgstr "" # 7b71be9ae5d1407783c18f9f8a366ae8 -#: ../src/Doc/c-api/module.rst:31 +#: c-api/module.rst:31 msgid "" "Return true if *p* is a module object, but not a subtype of :c:data:" "`PyModule_Type`." msgstr "" # ac56275b7a0e4de38e9386d7cb090bca -#: ../src/Doc/c-api/module.rst:44 +#: c-api/module.rst:44 msgid "" "Return a new module object with the :attr:`__name__` attribute set to " "*name*. Only the module's :attr:`__doc__` and :attr:`__name__` attributes " @@ -8725,7 +8850,7 @@ msgid "" msgstr "" # 1fb0546c796d4d5baa2f726fec3f66bb -#: ../src/Doc/c-api/module.rst:53 +#: c-api/module.rst:53 msgid "" "Return the dictionary object that implements *module*'s namespace; this " "object is the same as the :attr:`__dict__` attribute of the module object. " @@ -8735,7 +8860,7 @@ msgid "" msgstr "" # a35ebc6cb5a34f33a944a319383ea7ee -#: ../src/Doc/c-api/module.rst:66 +#: c-api/module.rst:66 msgid "" "Return *module*'s :attr:`__name__` value. If the module does not provide " "one, or if it is not a string, :exc:`SystemError` is raised and *NULL* is " @@ -8743,7 +8868,7 @@ msgid "" msgstr "" # 7f626985ad634cde8bcc346946339bb6 -#: ../src/Doc/c-api/module.rst:76 +#: c-api/module.rst:76 msgid "" "Return the name of the file from which *module* was loaded using *module*'s :" "attr:`__file__` attribute. If this is not defined, or if it is not a " @@ -8751,7 +8876,7 @@ msgid "" msgstr "" # b54060dc6edf44c08063b31fc5ae1931 -#: ../src/Doc/c-api/module.rst:83 +#: c-api/module.rst:83 msgid "" "Add an object to *module* as *name*. This is a convenience function which " "can be used from the module's initialization function. This steals a " @@ -8759,7 +8884,7 @@ msgid "" msgstr "" # 79baca532372407082b6bcadbce67f17 -#: ../src/Doc/c-api/module.rst:92 +#: c-api/module.rst:92 msgid "" "Add an integer constant to *module* as *name*. This convenience function " "can be used from the module's initialization function. Return ``-1`` on " @@ -8767,7 +8892,7 @@ msgid "" msgstr "" # 74088641283c46ea9d23dfcaa9166801 -#: ../src/Doc/c-api/module.rst:101 +#: c-api/module.rst:101 msgid "" "Add a string constant to *module* as *name*. This convenience function can " "be used from the module's initialization function. The string *value* must " @@ -8775,7 +8900,7 @@ msgid "" msgstr "" # bc043dfe244e4a45a8eb9ea7fde0a968 -#: ../src/Doc/c-api/module.rst:109 +#: c-api/module.rst:109 msgid "" "Add an int constant to *module*. The name and the value are taken from " "*macro*. For example ``PyModule_AddIntMacro(module, AF_INET)`` adds the int " @@ -8784,16 +8909,16 @@ msgid "" msgstr "" # 8ad878fe90e044bdab817e769f3f2e6c -#: ../src/Doc/c-api/module.rst:118 +#: c-api/module.rst:118 msgid "Add a string constant to *module*." msgstr "" -#: ../src/Doc/c-api/none.rst:6 +#: c-api/none.rst:6 msgid "The None Object" msgstr "" # d2e3831f832b4922bba271f6f1ca952b -#: ../src/Doc/c-api/none.rst:10 +#: c-api/none.rst:10 msgid "" "Note that the :c:type:`PyTypeObject` for ``None`` is not directly exposed in " "the Python/C API. Since ``None`` is a singleton, testing for object " @@ -8802,7 +8927,7 @@ msgid "" msgstr "" # a656ba27118f4f058b91baae0d508f61 -#: ../src/Doc/c-api/none.rst:18 +#: c-api/none.rst:18 msgid "" "The Python ``None`` object, denoting lack of value. This object has no " "methods. It needs to be treated just like any other object with respect to " @@ -8810,58 +8935,58 @@ msgid "" msgstr "" # bf78233ceb8f4b32a331de54fab92b81 -#: ../src/Doc/c-api/none.rst:25 +#: c-api/none.rst:25 msgid "Properly handle returning :c:data:`Py_None` from within a C function." msgstr "" -#: ../src/Doc/c-api/number.rst:6 +#: c-api/number.rst:6 msgid "Number Protocol" msgstr "" # fb1f4d8ddb894235b006e03bdff724d7 -#: ../src/Doc/c-api/number.rst:11 +#: c-api/number.rst:11 msgid "" "Returns ``1`` if the object *o* provides numeric protocols, and false " "otherwise. This function always succeeds." msgstr "" # e0ac44866532415b8184ec900275441d -#: ../src/Doc/c-api/number.rst:17 +#: c-api/number.rst:17 msgid "" "Returns the result of adding *o1* and *o2*, or *NULL* on failure. This is " "the equivalent of the Python expression ``o1 + o2``." msgstr "" # c52938f3cd924e1d8f3dd016987dea51 -#: ../src/Doc/c-api/number.rst:23 +#: c-api/number.rst:23 msgid "" "Returns the result of subtracting *o2* from *o1*, or *NULL* on failure. " "This is the equivalent of the Python expression ``o1 - o2``." msgstr "" # 1b85d3d188534d0b86c4426515a94699 -#: ../src/Doc/c-api/number.rst:29 +#: c-api/number.rst:29 msgid "" "Returns the result of multiplying *o1* and *o2*, or *NULL* on failure. This " "is the equivalent of the Python expression ``o1 * o2``." msgstr "" # 996db359fe0c4f50bdb432955f0a2be1 -#: ../src/Doc/c-api/number.rst:35 +#: c-api/number.rst:35 msgid "" "Returns the result of dividing *o1* by *o2*, or *NULL* on failure. This is " "the equivalent of the Python expression ``o1 / o2``." msgstr "" # b34c9db9317948ec846d2c5b4b6a486c -#: ../src/Doc/c-api/number.rst:41 +#: c-api/number.rst:41 msgid "" "Return the floor of *o1* divided by *o2*, or *NULL* on failure. This is " "equivalent to the \"classic\" division of integers." msgstr "" # fe931e2b894340e2aced5c959907274f -#: ../src/Doc/c-api/number.rst:49 +#: c-api/number.rst:49 msgid "" "Return a reasonable approximation for the mathematical value of *o1* divided " "by *o2*, or *NULL* on failure. The return value is \"approximate\" because " @@ -8871,21 +8996,21 @@ msgid "" msgstr "" # cd43a87c36a04f8e8d618b239f67f458 -#: ../src/Doc/c-api/number.rst:60 +#: c-api/number.rst:60 msgid "" "Returns the remainder of dividing *o1* by *o2*, or *NULL* on failure. This " "is the equivalent of the Python expression ``o1 % o2``." msgstr "" # 0be272509b6a44da9925200df90c7c3a -#: ../src/Doc/c-api/number.rst:68 +#: c-api/number.rst:68 msgid "" "See the built-in function :func:`divmod`. Returns *NULL* on failure. This " "is the equivalent of the Python expression ``divmod(o1, o2)``." msgstr "" # 866c5d5471be49d7aab2d8dbfb04dd53 -#: ../src/Doc/c-api/number.rst:76 +#: c-api/number.rst:76 msgid "" "See the built-in function :func:`pow`. Returns *NULL* on failure. This is " "the equivalent of the Python expression ``pow(o1, o2, o3)``, where *o3* is " @@ -8894,70 +9019,70 @@ msgid "" msgstr "" # 21f06904665346bb91b1661fbbde95a7 -#: ../src/Doc/c-api/number.rst:84 +#: c-api/number.rst:84 msgid "" "Returns the negation of *o* on success, or *NULL* on failure. This is the " "equivalent of the Python expression ``-o``." msgstr "" # 62777bb8393449df8a4fe16471c5915d -#: ../src/Doc/c-api/number.rst:90 +#: c-api/number.rst:90 msgid "" "Returns *o* on success, or *NULL* on failure. This is the equivalent of the " "Python expression ``+o``." msgstr "" # eace4b5284814de6975a3636432dd37d -#: ../src/Doc/c-api/number.rst:98 +#: c-api/number.rst:98 msgid "" "Returns the absolute value of *o*, or *NULL* on failure. This is the " "equivalent of the Python expression ``abs(o)``." msgstr "" # 0d1825a909f54f75932cb93d289af714 -#: ../src/Doc/c-api/number.rst:104 +#: c-api/number.rst:104 msgid "" "Returns the bitwise negation of *o* on success, or *NULL* on failure. This " "is the equivalent of the Python expression ``~o``." msgstr "" # 464b689f80dd4067ad697fa1ff3aaa75 -#: ../src/Doc/c-api/number.rst:110 +#: c-api/number.rst:110 msgid "" "Returns the result of left shifting *o1* by *o2* on success, or *NULL* on " "failure. This is the equivalent of the Python expression ``o1 << o2``." msgstr "" # c6f308d4edc742eebf2e5dadf33f4419 -#: ../src/Doc/c-api/number.rst:116 +#: c-api/number.rst:116 msgid "" "Returns the result of right shifting *o1* by *o2* on success, or *NULL* on " "failure. This is the equivalent of the Python expression ``o1 >> o2``." msgstr "" # cde5bd66693249e79810a810ec101b50 -#: ../src/Doc/c-api/number.rst:122 +#: c-api/number.rst:122 msgid "" "Returns the \"bitwise and\" of *o1* and *o2* on success and *NULL* on " "failure. This is the equivalent of the Python expression ``o1 & o2``." msgstr "" # 37d5ea0d2c9e48dab0e6d6da886e6f62 -#: ../src/Doc/c-api/number.rst:128 +#: c-api/number.rst:128 msgid "" "Returns the \"bitwise exclusive or\" of *o1* by *o2* on success, or *NULL* " "on failure. This is the equivalent of the Python expression ``o1 ^ o2``." msgstr "" # 20bd9ad563e04519af388503f4c155f3 -#: ../src/Doc/c-api/number.rst:134 +#: c-api/number.rst:134 msgid "" "Returns the \"bitwise or\" of *o1* and *o2* on success, or *NULL* on " "failure. This is the equivalent of the Python expression ``o1 | o2``." msgstr "" # d10ddded107f4e1692239ed63b5f1584 -#: ../src/Doc/c-api/number.rst:140 +#: c-api/number.rst:140 msgid "" "Returns the result of adding *o1* and *o2*, or *NULL* on failure. The " "operation is done *in-place* when *o1* supports it. This is the equivalent " @@ -8965,7 +9090,7 @@ msgid "" msgstr "" # 69e953f4c9874e4eaf5fe078d25c67b2 -#: ../src/Doc/c-api/number.rst:147 +#: c-api/number.rst:147 msgid "" "Returns the result of subtracting *o2* from *o1*, or *NULL* on failure. The " "operation is done *in-place* when *o1* supports it. This is the equivalent " @@ -8973,7 +9098,7 @@ msgid "" msgstr "" # f690d2a616174bd58bcaca8bb4ae9a95 -#: ../src/Doc/c-api/number.rst:154 +#: c-api/number.rst:154 msgid "" "Returns the result of multiplying *o1* and *o2*, or *NULL* on failure. The " "operation is done *in-place* when *o1* supports it. This is the equivalent " @@ -8981,7 +9106,7 @@ msgid "" msgstr "" # 517a8fabade4405d8585af1347233b6b -#: ../src/Doc/c-api/number.rst:161 +#: c-api/number.rst:161 msgid "" "Returns the result of dividing *o1* by *o2*, or *NULL* on failure. The " "operation is done *in-place* when *o1* supports it. This is the equivalent " @@ -8989,7 +9114,7 @@ msgid "" msgstr "" # 7c07e411210a441cbe37c8d54be09968 -#: ../src/Doc/c-api/number.rst:168 +#: c-api/number.rst:168 msgid "" "Returns the mathematical floor of dividing *o1* by *o2*, or *NULL* on " "failure. The operation is done *in-place* when *o1* supports it. This is " @@ -8997,7 +9122,7 @@ msgid "" msgstr "" # 627fa73f606c4d84a152decc37df3f5f -#: ../src/Doc/c-api/number.rst:177 +#: c-api/number.rst:177 msgid "" "Return a reasonable approximation for the mathematical value of *o1* divided " "by *o2*, or *NULL* on failure. The return value is \"approximate\" because " @@ -9008,7 +9133,7 @@ msgid "" msgstr "" # 1cd2ceb7113f4ed69c3dc8a0dfb17e20 -#: ../src/Doc/c-api/number.rst:188 +#: c-api/number.rst:188 msgid "" "Returns the remainder of dividing *o1* by *o2*, or *NULL* on failure. The " "operation is done *in-place* when *o1* supports it. This is the equivalent " @@ -9016,7 +9141,7 @@ msgid "" msgstr "" # 28a88f92889f48089704663e6c4b53cf -#: ../src/Doc/c-api/number.rst:197 +#: c-api/number.rst:197 msgid "" "See the built-in function :func:`pow`. Returns *NULL* on failure. The " "operation is done *in-place* when *o1* supports it. This is the equivalent " @@ -9027,7 +9152,7 @@ msgid "" msgstr "" # 3276523decf3422b8c9887cd35fd0376 -#: ../src/Doc/c-api/number.rst:206 +#: c-api/number.rst:206 msgid "" "Returns the result of left shifting *o1* by *o2* on success, or *NULL* on " "failure. The operation is done *in-place* when *o1* supports it. This is " @@ -9035,7 +9160,7 @@ msgid "" msgstr "" # 8a276abe897a4b339758c652a36d5551 -#: ../src/Doc/c-api/number.rst:213 +#: c-api/number.rst:213 msgid "" "Returns the result of right shifting *o1* by *o2* on success, or *NULL* on " "failure. The operation is done *in-place* when *o1* supports it. This is " @@ -9043,7 +9168,7 @@ msgid "" msgstr "" # 091a8db3522c4ff985ec58122907b282 -#: ../src/Doc/c-api/number.rst:220 +#: c-api/number.rst:220 msgid "" "Returns the \"bitwise and\" of *o1* and *o2* on success and *NULL* on " "failure. The operation is done *in-place* when *o1* supports it. This is " @@ -9051,7 +9176,7 @@ msgid "" msgstr "" # 564da48a894a4a5fa25dd59fc4f7fb48 -#: ../src/Doc/c-api/number.rst:227 +#: c-api/number.rst:227 msgid "" "Returns the \"bitwise exclusive or\" of *o1* by *o2* on success, or *NULL* " "on failure. The operation is done *in-place* when *o1* supports it. This " @@ -9059,7 +9184,7 @@ msgid "" msgstr "" # f472d7a032fb4ea7b4c5d2925bd998a4 -#: ../src/Doc/c-api/number.rst:234 +#: c-api/number.rst:234 msgid "" "Returns the \"bitwise or\" of *o1* and *o2* on success, or *NULL* on " "failure. The operation is done *in-place* when *o1* supports it. This is " @@ -9067,7 +9192,7 @@ msgid "" msgstr "" # 8d43527f093f457aaeb722cecd4dd6d5 -#: ../src/Doc/c-api/number.rst:243 +#: c-api/number.rst:243 msgid "" "This function takes the addresses of two variables of type :c:type:`PyObject" "\\*`. If the objects pointed to by ``*p1`` and ``*p2`` have the same type, " @@ -9081,7 +9206,7 @@ msgid "" msgstr "" # e88cb1576deb4e44bf5054dffc4a9120 -#: ../src/Doc/c-api/number.rst:255 +#: c-api/number.rst:255 msgid "" "This function is similar to :c:func:`PyNumber_Coerce`, except that it " "returns ``1`` when the conversion is not possible and when no error is " @@ -9089,7 +9214,7 @@ msgid "" msgstr "" # 6ac903d5576c4ed0bcf6d6f7f4e2ba5e -#: ../src/Doc/c-api/number.rst:264 +#: c-api/number.rst:264 msgid "" "Returns the *o* converted to an integer object on success, or *NULL* on " "failure. If the argument is outside the integer range a long object will be " @@ -9097,28 +9222,28 @@ msgid "" msgstr "" # 0c73f8becf524055a6755600dd440b60 -#: ../src/Doc/c-api/number.rst:273 +#: c-api/number.rst:273 msgid "" "Returns the *o* converted to a long integer object on success, or *NULL* on " "failure. This is the equivalent of the Python expression ``long(o)``." msgstr "" # 17b8f30bf99d4418a65cf12bfc2e98f7 -#: ../src/Doc/c-api/number.rst:281 +#: c-api/number.rst:281 msgid "" "Returns the *o* converted to a float object on success, or *NULL* on " "failure. This is the equivalent of the Python expression ``float(o)``." msgstr "" # 1c1a861e5ec343f79649577e89c55fc8 -#: ../src/Doc/c-api/number.rst:287 +#: c-api/number.rst:287 msgid "" "Returns the *o* converted to a Python int or long on success or *NULL* with " "a :exc:`TypeError` exception raised on failure." msgstr "" # 9302126570a445deaefc9c2dff9bf84d -#: ../src/Doc/c-api/number.rst:295 +#: c-api/number.rst:295 msgid "" "Returns the integer *n* converted to *base* as a string with a base marker " "of ``'0b'``, ``'0o'``, or ``'0x'`` if applicable. When *base* is not 2, 8, " @@ -9127,7 +9252,7 @@ msgid "" msgstr "" # 15c425dd2b644e098a45f09b4475f208 -#: ../src/Doc/c-api/number.rst:306 +#: c-api/number.rst:306 msgid "" "Returns *o* converted to a Py_ssize_t value if *o* can be interpreted as an " "integer. If *o* can be converted to a Python int or long but the attempt to " @@ -9139,19 +9264,19 @@ msgid "" msgstr "" # 2088bc74892642acadd48d3cbef8519b -#: ../src/Doc/c-api/number.rst:319 +#: c-api/number.rst:319 msgid "" "Returns True if *o* is an index integer (has the nb_index slot of the " "tp_as_number structure filled in)." msgstr "" # e06f49aab963421db4ddcfb848e64838 -#: ../src/Doc/c-api/objbuffer.rst:7 +#: c-api/objbuffer.rst:7 msgid "Old Buffer Protocol" msgstr "" # faf223ce616b4a65bc93c2fb3013271c -#: ../src/Doc/c-api/objbuffer.rst:9 +#: c-api/objbuffer.rst:9 msgid "" "This section describes the legacy buffer protocol, which has been introduced " "in Python 1.6. It is still supported but deprecated in the Python 2.x " @@ -9161,7 +9286,7 @@ msgid "" msgstr "" # d7028cec11c64ab8abe916d8cab45f11 -#: ../src/Doc/c-api/objbuffer.rst:18 +#: c-api/objbuffer.rst:18 msgid "" "Returns a pointer to a read-only memory location usable as character-based " "input. The *obj* argument must support the single-segment character buffer " @@ -9170,8 +9295,14 @@ msgid "" "`TypeError` on error." msgstr "" +#: c-api/objbuffer.rst:26 c-api/objbuffer.rst:41 c-api/objbuffer.rst:63 +msgid "" +"This function used an :c:type:`int *` type for *buffer_len*. This might " +"require changes in your code for properly supporting 64-bit systems." +msgstr "" + # 2e84869b611b4d75b2dd33c992283b81 -#: ../src/Doc/c-api/objbuffer.rst:33 +#: c-api/objbuffer.rst:33 msgid "" "Returns a pointer to a read-only memory location containing arbitrary data. " "The *obj* argument must support the single-segment readable buffer " @@ -9181,14 +9312,14 @@ msgid "" msgstr "" # 318e6acff55049f9b087ca2b76df3f1e -#: ../src/Doc/c-api/objbuffer.rst:48 +#: c-api/objbuffer.rst:48 msgid "" "Returns ``1`` if *o* supports the single-segment readable buffer interface. " "Otherwise returns ``0``." msgstr "" # 45b8a024750542b5beb4cf22f84ed043 -#: ../src/Doc/c-api/objbuffer.rst:56 +#: c-api/objbuffer.rst:56 msgid "" "Returns a pointer to a writeable memory location. The *obj* argument must " "support the single-segment, character buffer interface. On success, returns " @@ -9196,12 +9327,12 @@ msgid "" "length. Returns ``-1`` and sets a :exc:`TypeError` on error." msgstr "" -#: ../src/Doc/c-api/object.rst:6 +#: c-api/object.rst:6 msgid "Object Protocol" msgstr "" # a5a23f91d4ed4a72ad77f9c88e23e52a -#: ../src/Doc/c-api/object.rst:11 +#: c-api/object.rst:11 msgid "" "Print an object *o*, on file *fp*. Returns ``-1`` on error. The flags " "argument is used to enable certain printing options. The only option " @@ -9211,7 +9342,7 @@ msgstr "" # 6af3c89ffc8a467ab53cd9fcdb4b7a13 # b79db3e48f9e4505b3d68ff264c782cf -#: ../src/Doc/c-api/object.rst:19 ../src/Doc/c-api/object.rst:26 +#: c-api/object.rst:19 c-api/object.rst:26 msgid "" "Returns ``1`` if *o* has the attribute *attr_name*, and ``0`` otherwise. " "This is equivalent to the Python expression ``hasattr(o, attr_name)``. This " @@ -9219,7 +9350,7 @@ msgid "" msgstr "" # ce0b695f9da54c5f84b4f9c169156128 -#: ../src/Doc/c-api/object.rst:33 +#: c-api/object.rst:33 msgid "" "Retrieve an attribute named *attr_name* from object *o*. Returns the " "attribute value on success, or *NULL* on failure. This is the equivalent of " @@ -9227,7 +9358,7 @@ msgid "" msgstr "" # 1c2d578cd91a49a098c29296089494d0 -#: ../src/Doc/c-api/object.rst:40 +#: c-api/object.rst:40 msgid "" "Retrieve an attribute named *attr_name* from object *o*. Returns the " "attribute value on success, or *NULL* on failure. This is the equivalent of " @@ -9235,7 +9366,7 @@ msgid "" msgstr "" # e4e41520aefb411486e306c7053c8744 -#: ../src/Doc/c-api/object.rst:47 +#: c-api/object.rst:47 msgid "" "Generic attribute getter function that is meant to be put into a type " "object's ``tp_getattro`` slot. It looks for a descriptor in the dictionary " @@ -9247,7 +9378,7 @@ msgstr "" # 96ddb812334a4cd692b0c6595a9d0f24 # ce671e532c90471da53876eb1f2c76d3 -#: ../src/Doc/c-api/object.rst:57 ../src/Doc/c-api/object.rst:64 +#: c-api/object.rst:57 c-api/object.rst:64 msgid "" "Set the value of the attribute named *attr_name*, for object *o*, to the " "value *v*. Returns ``-1`` on failure. This is the equivalent of the Python " @@ -9255,7 +9386,7 @@ msgid "" msgstr "" # 897fb33508e84b6e88a8bd3258014f2d -#: ../src/Doc/c-api/object.rst:71 +#: c-api/object.rst:71 msgid "" "Generic attribute setter function that is meant to be put into a type " "object's ``tp_setattro`` slot. It looks for a data descriptor in the " @@ -9267,14 +9398,14 @@ msgstr "" # ff9584e04f0044cba077385ba14fa6ea # c79ec4ef776348e0b8db977b8bdc8d78 -#: ../src/Doc/c-api/object.rst:81 ../src/Doc/c-api/object.rst:87 +#: c-api/object.rst:81 c-api/object.rst:87 msgid "" "Delete attribute named *attr_name*, for object *o*. Returns ``-1`` on " "failure. This is the equivalent of the Python statement ``del o.attr_name``." msgstr "" # bb2df8d228de424d8fd8b04ed3e42e13 -#: ../src/Doc/c-api/object.rst:93 +#: c-api/object.rst:93 msgid "" "Compare the values of *o1* and *o2* using the operation specified by *opid*, " "which must be one of :const:`Py_LT`, :const:`Py_LE`, :const:`Py_EQ`, :const:" @@ -9286,7 +9417,7 @@ msgid "" msgstr "" # 9f86c68d815c47fab2953e3ae67c1132 -#: ../src/Doc/c-api/object.rst:103 +#: c-api/object.rst:103 msgid "" "Compare the values of *o1* and *o2* using the operation specified by *opid*, " "which must be one of :const:`Py_LT`, :const:`Py_LE`, :const:`Py_EQ`, :const:" @@ -9298,14 +9429,14 @@ msgid "" msgstr "" # 7e05f13334c1476ba2192f6406db686e -#: ../src/Doc/c-api/object.rst:112 +#: c-api/object.rst:112 msgid "" "If *o1* and *o2* are the same object, :c:func:`PyObject_RichCompareBool` " "will always return ``1`` for :const:`Py_EQ` and ``0`` for :const:`Py_NE`." msgstr "" # 2d5198c254904d84a597a5d68f3c4e1e -#: ../src/Doc/c-api/object.rst:119 +#: c-api/object.rst:119 msgid "" "Compare the values of *o1* and *o2* using a routine provided by *o1*, if one " "exists, otherwise with a routine provided by *o2*. The result of the " @@ -9314,7 +9445,7 @@ msgid "" msgstr "" # d518e592747f436d8ca324695c737480 -#: ../src/Doc/c-api/object.rst:129 +#: c-api/object.rst:129 msgid "" "Compare the values of *o1* and *o2* using a routine provided by *o1*, if one " "exists, otherwise with a routine provided by *o2*. Returns the result of " @@ -9324,7 +9455,7 @@ msgid "" msgstr "" # 2b6273ab5b734122863a4e0bf24f8f6c -#: ../src/Doc/c-api/object.rst:140 +#: c-api/object.rst:140 msgid "" "Compute a string representation of object *o*. Returns the string " "representation on success, *NULL* on failure. This is the equivalent of the " @@ -9333,7 +9464,7 @@ msgid "" msgstr "" # 753cba6821b84529ad0c782fb813f111 -#: ../src/Doc/c-api/object.rst:150 +#: c-api/object.rst:150 msgid "" "Compute a string representation of object *o*. Returns the string " "representation on success, *NULL* on failure. This is the equivalent of the " @@ -9342,14 +9473,14 @@ msgid "" msgstr "" # e3d4770e920e45d09d2f7a06e3a7fa87 -#: ../src/Doc/c-api/object.rst:160 +#: c-api/object.rst:160 msgid "" "Compute a bytes representation of object *o*. In 2.x, this is just a alias " "for :c:func:`PyObject_Str`." msgstr "" # 84bf7c2345014111a6efd376805d5c5b -#: ../src/Doc/c-api/object.rst:168 +#: c-api/object.rst:168 msgid "" "Compute a Unicode string representation of object *o*. Returns the Unicode " "string representation on success, *NULL* on failure. This is the equivalent " @@ -9358,7 +9489,7 @@ msgid "" msgstr "" # 1abb3d3ecca4480cbc7751042f612305 -#: ../src/Doc/c-api/object.rst:176 +#: c-api/object.rst:176 msgid "" "Returns ``1`` if *inst* is an instance of the class *cls* or a subclass of " "*cls*, or ``0`` if not. On error, returns ``-1`` and sets an exception. If " @@ -9372,8 +9503,12 @@ msgid "" "attribute with *cls* will be used to determine the result of this function." msgstr "" +#: c-api/object.rst:189 +msgid "Support for a tuple as the second argument added." +msgstr "" + # 704c94a22a174c19adfc9aa3d6aa2d30 -#: ../src/Doc/c-api/object.rst:192 +#: c-api/object.rst:192 msgid "" "Subclass determination is done in a fairly straightforward way, but includes " "a wrinkle that implementors of extensions to the class system may want to be " @@ -9389,7 +9524,7 @@ msgid "" msgstr "" # 1e765d90e8b94a49919fa15b7d9b513a -#: ../src/Doc/c-api/object.rst:206 +#: c-api/object.rst:206 msgid "" "Returns ``1`` if the class *derived* is identical to or derived from the " "class *cls*, otherwise returns ``0``. In case of an error, returns ``-1``. " @@ -9400,15 +9535,20 @@ msgid "" "above." msgstr "" +#: c-api/object.rst:215 +msgid "" +"Older versions of Python did not support a tuple as the second argument." +msgstr "" + # 29fe41331b6f4f1eb8d24a83abb60a60 -#: ../src/Doc/c-api/object.rst:221 +#: c-api/object.rst:221 msgid "" "Determine if the object *o* is callable. Return ``1`` if the object is " "callable and ``0`` otherwise. This function always succeeds." msgstr "" # 0480cb4629af442298b58730870a3bae -#: ../src/Doc/c-api/object.rst:229 +#: c-api/object.rst:229 msgid "" "Call a callable Python object *callable_object*, with arguments given by the " "tuple *args*, and named arguments given by the dictionary *kw*. If no named " @@ -9420,7 +9560,7 @@ msgid "" msgstr "" # c9923029a46a4a36812f72fc03d8ade2 -#: ../src/Doc/c-api/object.rst:243 +#: c-api/object.rst:243 msgid "" "Call a callable Python object *callable_object*, with arguments given by the " "tuple *args*. If no arguments are needed, then *args* may be *NULL*. " @@ -9430,7 +9570,7 @@ msgid "" msgstr "" # aba484c46a2b457c9a435d659562bcb4 -#: ../src/Doc/c-api/object.rst:254 +#: c-api/object.rst:254 msgid "" "Call a callable Python object *callable*, with a variable number of C " "arguments. The C arguments are described using a :c:func:`Py_BuildValue` " @@ -9442,7 +9582,7 @@ msgid "" msgstr "" # 64cdf230c4374d8095fd7da4af175c7d -#: ../src/Doc/c-api/object.rst:265 +#: c-api/object.rst:265 msgid "" "Call the method named *method* of object *o* with a variable number of C " "arguments. The C arguments are described by a :c:func:`Py_BuildValue` " @@ -9454,7 +9594,7 @@ msgid "" msgstr "" # 444e3fedb3b544f0aa4f0ea0cd736b85 -#: ../src/Doc/c-api/object.rst:276 +#: c-api/object.rst:276 msgid "" "Call a callable Python object *callable*, with a variable number of :c:type:" "`PyObject\\*` arguments. The arguments are provided as a variable number of " @@ -9463,7 +9603,7 @@ msgid "" msgstr "" # d7e76027d3914a46aff16749a394bb1c -#: ../src/Doc/c-api/object.rst:286 +#: c-api/object.rst:286 msgid "" "Calls a method of the object *o*, where the name of the method is given as a " "Python string object in *name*. It is called with a variable number of :c:" @@ -9473,14 +9613,14 @@ msgid "" msgstr "" # 6c65e71476424638b04972c3c7ecb482 -#: ../src/Doc/c-api/object.rst:299 +#: c-api/object.rst:299 msgid "" "Compute and return the hash value of an object *o*. On failure, return " "``-1``. This is the equivalent of the Python expression ``hash(o)``." msgstr "" # 7bf26c71333a4a67b3d0ea794bc06f70 -#: ../src/Doc/c-api/object.rst:305 +#: c-api/object.rst:305 msgid "" "Set a :exc:`TypeError` indicating that ``type(o)`` is not hashable and " "return ``-1``. This function receives special treatment when stored in a " @@ -9489,7 +9629,7 @@ msgid "" msgstr "" # c02d3815286744fc82e1a73d3fa78404 -#: ../src/Doc/c-api/object.rst:315 +#: c-api/object.rst:315 msgid "" "Returns ``1`` if the object *o* is considered to be true, and ``0`` " "otherwise. This is equivalent to the Python expression ``not not o``. On " @@ -9497,7 +9637,7 @@ msgid "" msgstr "" # 3bd110101a254d9d9d74b98efdda1f1d -#: ../src/Doc/c-api/object.rst:322 +#: c-api/object.rst:322 msgid "" "Returns ``0`` if the object *o* is considered to be true, and ``1`` " "otherwise. This is equivalent to the Python expression ``not o``. On " @@ -9505,7 +9645,7 @@ msgid "" msgstr "" # a08123d8430f4433ba6058aa31e604a8 -#: ../src/Doc/c-api/object.rst:331 +#: c-api/object.rst:331 msgid "" "When *o* is non-*NULL*, returns a type object corresponding to the object " "type of object *o*. On failure, raises :exc:`SystemError` and returns " @@ -9517,14 +9657,14 @@ msgid "" msgstr "" # 62abba7120c243ff979d3a635acfd6bf -#: ../src/Doc/c-api/object.rst:342 +#: c-api/object.rst:342 msgid "" "Return true if the object *o* is of type *type* or a subtype of *type*. " "Both parameters must be non-*NULL*." msgstr "" # 418ca28fb24e4c6f9af2eb10686e1af6 -#: ../src/Doc/c-api/object.rst:353 +#: c-api/object.rst:353 msgid "" "Return the length of object *o*. If the object *o* provides either the " "sequence and mapping protocols, the sequence length is returned. On error, " @@ -9533,21 +9673,21 @@ msgid "" msgstr "" # 31d2fa180d714d94a2f277cbe5a0fd22 -#: ../src/Doc/c-api/object.rst:370 +#: c-api/object.rst:370 msgid "" "Map the object *key* to the value *v*. Returns ``-1`` on failure. This is " "the equivalent of the Python statement ``o[key] = v``." msgstr "" # 076a8762e068483990c702c6f7ddad35 -#: ../src/Doc/c-api/object.rst:376 +#: c-api/object.rst:376 msgid "" "Delete the mapping for *key* from *o*. Returns ``-1`` on failure. This is " "the equivalent of the Python statement ``del o[key]``." msgstr "" # 2aacc461ee4248e3a56d471fadb1ff08 -#: ../src/Doc/c-api/object.rst:382 +#: c-api/object.rst:382 msgid "" "Derives a file descriptor from a Python object. If the object is an integer " "or long integer, its value is returned. If not, the object's :meth:`fileno` " @@ -9557,7 +9697,7 @@ msgid "" msgstr "" # 5d92a5e5f6894b82a164b392b034161e -#: ../src/Doc/c-api/object.rst:390 +#: c-api/object.rst:390 msgid "" "This is equivalent to the Python expression ``dir(o)``, returning a " "(possibly empty) list of strings appropriate for the object argument, or " @@ -9568,7 +9708,7 @@ msgid "" msgstr "" # 4899e522193240f79176550f162ed856 -#: ../src/Doc/c-api/object.rst:399 +#: c-api/object.rst:399 msgid "" "This is equivalent to the Python expression ``iter(o)``. It returns a new " "iterator for the object argument, or the object itself if the object is " @@ -9576,42 +9716,42 @@ msgid "" "object cannot be iterated." msgstr "" -#: ../src/Doc/c-api/objimpl.rst:8 +#: c-api/objimpl.rst:8 msgid "Object Implementation Support" msgstr "" -#: ../src/Doc/c-api/objimpl.rst:10 +#: c-api/objimpl.rst:10 msgid "" "This chapter describes the functions, types, and macros used when defining " "new object types." msgstr "" -#: ../src/Doc/c-api/refcounting.rst:8 +#: c-api/refcounting.rst:8 msgid "Reference Counting" msgstr "" -#: ../src/Doc/c-api/refcounting.rst:10 +#: c-api/refcounting.rst:10 msgid "" "The macros in this section are used for managing reference counts of Python " "objects." msgstr "" # 50dc51acf54a400fad257e662cc4b348 -#: ../src/Doc/c-api/refcounting.rst:16 +#: c-api/refcounting.rst:16 msgid "" "Increment the reference count for object *o*. The object must not be " "*NULL*; if you aren't sure that it isn't *NULL*, use :c:func:`Py_XINCREF`." msgstr "" # 9558a868afff4a9bafd8b961a21d16b4 -#: ../src/Doc/c-api/refcounting.rst:22 +#: c-api/refcounting.rst:22 msgid "" "Increment the reference count for object *o*. The object may be *NULL*, in " "which case the macro has no effect." msgstr "" # abfeb6bde2a04e2abe47dd2c6e9a7335 -#: ../src/Doc/c-api/refcounting.rst:28 +#: c-api/refcounting.rst:28 msgid "" "Decrement the reference count for object *o*. The object must not be " "*NULL*; if you aren't sure that it isn't *NULL*, use :c:func:`Py_XDECREF`. " @@ -9620,7 +9760,7 @@ msgid "" msgstr "" # 00ad7cf8247e42c6903ea7fb8a0a1729 -#: ../src/Doc/c-api/refcounting.rst:35 +#: c-api/refcounting.rst:35 msgid "" "The deallocation function can cause arbitrary Python code to be invoked (e." "g. when a class instance with a :meth:`__del__` method is deallocated). " @@ -9634,7 +9774,7 @@ msgid "" msgstr "" # 9bfcb489abce4629bd259b5c4392c42e -#: ../src/Doc/c-api/refcounting.rst:47 +#: c-api/refcounting.rst:47 msgid "" "Decrement the reference count for object *o*. The object may be *NULL*, in " "which case the macro has no effect; otherwise the effect is the same as for :" @@ -9642,7 +9782,7 @@ msgid "" msgstr "" # fb693f34b1da4ea6bef4cd4280db76ac -#: ../src/Doc/c-api/refcounting.rst:54 +#: c-api/refcounting.rst:54 msgid "" "Decrement the reference count for object *o*. The object may be *NULL*, in " "which case the macro has no effect; otherwise the effect is the same as for :" @@ -9653,14 +9793,14 @@ msgid "" msgstr "" # fd6e2953f59a428b88862938fe66d5e8 -#: ../src/Doc/c-api/refcounting.rst:61 +#: c-api/refcounting.rst:61 msgid "" "It is a good idea to use this macro whenever decrementing the value of a " "variable that might be traversed during garbage collection." msgstr "" # 348bdc3d973745798fa27125f2d09cd9 -#: ../src/Doc/c-api/refcounting.rst:66 +#: c-api/refcounting.rst:66 msgid "" "The following functions are for runtime dynamic embedding of Python: " "``Py_IncRef(PyObject *o)``, ``Py_DecRef(PyObject *o)``. They are simply " @@ -9669,66 +9809,66 @@ msgid "" msgstr "" # a44027bad169401ab090ff0739176555 -#: ../src/Doc/c-api/refcounting.rst:71 +#: c-api/refcounting.rst:71 msgid "" "The following functions or macros are only for use within the interpreter " "core: :c:func:`_Py_Dealloc`, :c:func:`_Py_ForgetReference`, :c:func:" "`_Py_NewReference`, as well as the global variable :c:data:`_Py_RefTotal`." msgstr "" -#: ../src/Doc/c-api/reflection.rst:6 +#: c-api/reflection.rst:6 msgid "Reflection" msgstr "" # 632dbd7a2c934994992da1674531f244 -#: ../src/Doc/c-api/reflection.rst:10 +#: c-api/reflection.rst:10 msgid "" "Return a dictionary of the builtins in the current execution frame, or the " "interpreter of the thread state if no frame is currently executing." msgstr "" # 802a024007aa423b900da57babe9f200 -#: ../src/Doc/c-api/reflection.rst:16 +#: c-api/reflection.rst:16 msgid "" "Return a dictionary of the local variables in the current execution frame, " "or *NULL* if no frame is currently executing." msgstr "" # 3b1be9a498044cd6be5a0801c244fad9 -#: ../src/Doc/c-api/reflection.rst:22 +#: c-api/reflection.rst:22 msgid "" "Return a dictionary of the global variables in the current execution frame, " "or *NULL* if no frame is currently executing." msgstr "" # 2a9b058355484ee58d36f30f8dc9ea6e -#: ../src/Doc/c-api/reflection.rst:28 +#: c-api/reflection.rst:28 msgid "" "Return the current thread state's frame, which is *NULL* if no frame is " "currently executing." msgstr "" # bbb513d720e74392a3dbd95d472af479 -#: ../src/Doc/c-api/reflection.rst:34 +#: c-api/reflection.rst:34 msgid "Return the line number that *frame* is currently executing." msgstr "" # 0f87ea65857c410fbe4ca09589c74baf -#: ../src/Doc/c-api/reflection.rst:39 +#: c-api/reflection.rst:39 msgid "" "If there is a current frame and it is executing in restricted mode, return " "true, otherwise false." msgstr "" # fdfec1918f584f498a9784cdbd15a30c -#: ../src/Doc/c-api/reflection.rst:45 +#: c-api/reflection.rst:45 msgid "" "Return the name of *func* if it is a function, class or instance object, " "else the name of *func*\\s type." msgstr "" # 5f225031b77947ae9df55fc4bfc87725 -#: ../src/Doc/c-api/reflection.rst:51 +#: c-api/reflection.rst:51 msgid "" "Return a description string, depending on the type of *func*. Return values " "include \"()\" for functions and methods, \" constructor\", \" instance\", " @@ -9736,19 +9876,19 @@ msgid "" "`PyEval_GetFuncName`, the result will be a description of *func*." msgstr "" -#: ../src/Doc/c-api/sequence.rst:6 +#: c-api/sequence.rst:6 msgid "Sequence Protocol" msgstr "" # 62d02e3fa8964510bb527beafd532b85 -#: ../src/Doc/c-api/sequence.rst:11 +#: c-api/sequence.rst:11 msgid "" "Return ``1`` if the object provides sequence protocol, and ``0`` otherwise. " "This function always succeeds." msgstr "" # 6a437b335a654321962bc1b8d89c384d -#: ../src/Doc/c-api/sequence.rst:20 +#: c-api/sequence.rst:20 msgid "" "Returns the number of objects in sequence *o* on success, and ``-1`` on " "failure. For objects that do not provide sequence protocol, this is " @@ -9756,21 +9896,27 @@ msgid "" msgstr "" # 0253f573182c4feebebe0ecf13c2b146 -#: ../src/Doc/c-api/sequence.rst:31 +#: c-api/sequence.rst:31 msgid "" "Return the concatenation of *o1* and *o2* on success, and *NULL* on failure. " "This is the equivalent of the Python expression ``o1 + o2``." msgstr "" # 301edc48665d426e9a135dd71f187ea0 -#: ../src/Doc/c-api/sequence.rst:37 +#: c-api/sequence.rst:37 msgid "" "Return the result of repeating sequence object *o* *count* times, or *NULL* " "on failure. This is the equivalent of the Python expression ``o * count``." msgstr "" +#: c-api/sequence.rst:40 c-api/sequence.rst:58 +msgid "" +"This function used an :c:type:`int` type for *count*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + # f8f935dd1a4b47e6a7b2b9f1fe459d25 -#: ../src/Doc/c-api/sequence.rst:47 +#: c-api/sequence.rst:47 msgid "" "Return the concatenation of *o1* and *o2* on success, and *NULL* on failure. " "The operation is done *in-place* when *o1* supports it. This is the " @@ -9778,7 +9924,7 @@ msgid "" msgstr "" # 40e270aedf07404d8ffad3cbbcd02088 -#: ../src/Doc/c-api/sequence.rst:54 +#: c-api/sequence.rst:54 msgid "" "Return the result of repeating sequence object *o* *count* times, or *NULL* " "on failure. The operation is done *in-place* when *o* supports it. This is " @@ -9786,21 +9932,34 @@ msgid "" msgstr "" # 6a30eefac5cc4ca6b342e2ee140d2eeb -#: ../src/Doc/c-api/sequence.rst:65 +#: c-api/sequence.rst:65 msgid "" "Return the *i*\\ th element of *o*, or *NULL* on failure. This is the " "equivalent of the Python expression ``o[i]``." msgstr "" +#: c-api/sequence.rst:68 c-api/sequence.rst:89 c-api/sequence.rst:99 +#: c-api/sequence.rst:181 c-api/sequence.rst:207 +msgid "" +"This function used an :c:type:`int` type for *i*. This might require changes " +"in your code for properly supporting 64-bit systems." +msgstr "" + # 47a14bb8517e4801b9e48c13cc89ce80 -#: ../src/Doc/c-api/sequence.rst:75 +#: c-api/sequence.rst:75 msgid "" "Return the slice of sequence object *o* between *i1* and *i2*, or *NULL* on " "failure. This is the equivalent of the Python expression ``o[i1:i2]``." msgstr "" +#: c-api/sequence.rst:78 c-api/sequence.rst:109 c-api/sequence.rst:119 +msgid "" +"This function used an :c:type:`int` type for *i1* and *i2*. This might " +"require changes in your code for properly supporting 64-bit systems." +msgstr "" + # 397ac4227c024af880e586ca0feb0b25 -#: ../src/Doc/c-api/sequence.rst:85 +#: c-api/sequence.rst:85 msgid "" "Assign object *v* to the *i*\\ th element of *o*. Returns ``-1`` on " "failure. This is the equivalent of the Python statement ``o[i] = v``. This " @@ -9808,36 +9967,44 @@ msgid "" msgstr "" # f4a5e182aced47f9bee2e1ec169b4ef6 -#: ../src/Doc/c-api/sequence.rst:96 +#: c-api/sequence.rst:96 msgid "" "Delete the *i*\\ th element of object *o*. Returns ``-1`` on failure. This " "is the equivalent of the Python statement ``del o[i]``." msgstr "" # c4e61006918a4325bfcc6fe36f059b46 -#: ../src/Doc/c-api/sequence.rst:106 +#: c-api/sequence.rst:106 msgid "" "Assign the sequence object *v* to the slice in sequence object *o* from *i1* " "to *i2*. This is the equivalent of the Python statement ``o[i1:i2] = v``." msgstr "" # 12fd2450d6174de7bfed594917923729 -#: ../src/Doc/c-api/sequence.rst:116 +#: c-api/sequence.rst:116 msgid "" "Delete the slice in sequence object *o* from *i1* to *i2*. Returns ``-1`` " "on failure. This is the equivalent of the Python statement ``del o[i1:i2]``." msgstr "" # f73f4c9bba7d4d88b1b4e78072ba5043 -#: ../src/Doc/c-api/sequence.rst:126 +#: c-api/sequence.rst:126 msgid "" "Return the number of occurrences of *value* in *o*, that is, return the " "number of keys for which ``o[key] == value``. On failure, return ``-1``. " "This is equivalent to the Python expression ``o.count(value)``." msgstr "" +#: c-api/sequence.rst:130 c-api/sequence.rst:147 c-api/string.rst:157 +#: c-api/tuple.rst:67 c-api/tuple.rst:77 c-api/unicode.rst:75 +#: c-api/unicode.rst:85 c-api/unicode.rst:343 +msgid "" +"This function returned an :c:type:`int` type. This might require changes in " +"your code for properly supporting 64-bit systems." +msgstr "" + # 862dc107ca934d5ab6e5938fada0f2c2 -#: ../src/Doc/c-api/sequence.rst:137 +#: c-api/sequence.rst:137 msgid "" "Determine if *o* contains *value*. If an item in *o* is equal to *value*, " "return ``1``, otherwise return ``0``. On error, return ``-1``. This is " @@ -9845,21 +10012,21 @@ msgid "" msgstr "" # eae59b5cb08e4a2e85449a2405fd04fb -#: ../src/Doc/c-api/sequence.rst:144 +#: c-api/sequence.rst:144 msgid "" "Return the first index *i* for which ``o[i] == value``. On error, return " "``-1``. This is equivalent to the Python expression ``o.index(value)``." msgstr "" # a126b4651162437fb506baf2fab51fe4 -#: ../src/Doc/c-api/sequence.rst:154 +#: c-api/sequence.rst:154 msgid "" "Return a list object with the same contents as the arbitrary sequence *o*. " "The returned list is guaranteed to be new." msgstr "" # 0bd4e22ec55d4ec0b1bd27e50c20adfb -#: ../src/Doc/c-api/sequence.rst:162 +#: c-api/sequence.rst:162 msgid "" "Return a tuple object with the same contents as the arbitrary sequence *o* " "or *NULL* on failure. If *o* is a tuple, a new reference will be returned, " @@ -9868,7 +10035,7 @@ msgid "" msgstr "" # 2bc02774d1cd4033956870e72edffb13 -#: ../src/Doc/c-api/sequence.rst:170 +#: c-api/sequence.rst:170 msgid "" "Return the sequence *o* as a list, unless it is already a tuple or list, in " "which case *o* is returned. Use :c:func:`PySequence_Fast_GET_ITEM` to " @@ -9877,21 +10044,21 @@ msgid "" msgstr "" # 2faf4e7a29094ff9837462485c45e2f0 -#: ../src/Doc/c-api/sequence.rst:178 +#: c-api/sequence.rst:178 msgid "" "Return the *i*\\ th element of *o*, assuming that *o* was returned by :c:" "func:`PySequence_Fast`, *o* is not *NULL*, and that *i* is within bounds." msgstr "" # b850abc6ada644b9903b0448e0eb445f -#: ../src/Doc/c-api/sequence.rst:188 +#: c-api/sequence.rst:188 msgid "" "Return the underlying array of PyObject pointers. Assumes that *o* was " "returned by :c:func:`PySequence_Fast` and *o* is not *NULL*." msgstr "" # 39ba45cf36f840f7bff0da1d7c741522 -#: ../src/Doc/c-api/sequence.rst:191 +#: c-api/sequence.rst:191 msgid "" "Note, if a list gets resized, the reallocation may relocate the items array. " "So, only use the underlying array pointer in contexts where the sequence " @@ -9899,7 +10066,7 @@ msgid "" msgstr "" # f9d026a671c348dfb3446938272c8100 -#: ../src/Doc/c-api/sequence.rst:200 +#: c-api/sequence.rst:200 msgid "" "Return the *i*\\ th element of *o* or *NULL* on failure. Macro form of :c:" "func:`PySequence_GetItem` but without checking that :c:func:" @@ -9908,7 +10075,7 @@ msgid "" msgstr "" # 005b68bfe5ed4af3957a717213c08969 -#: ../src/Doc/c-api/sequence.rst:214 +#: c-api/sequence.rst:214 msgid "" "Returns the length of *o*, assuming that *o* was returned by :c:func:" "`PySequence_Fast` and that *o* is not *NULL*. The size can also be gotten " @@ -9917,12 +10084,12 @@ msgid "" "tuple." msgstr "" -#: ../src/Doc/c-api/set.rst:6 +#: c-api/set.rst:6 msgid "Set Objects" msgstr "" # 20591268cdfd4d40a1515a8cf2dbe859 -#: ../src/Doc/c-api/set.rst:17 +#: c-api/set.rst:17 msgid "" "This section details the public API for :class:`set` and :class:`frozenset` " "objects. Any functionality not listed below is best accessed using the " @@ -9937,7 +10104,7 @@ msgid "" msgstr "" # cd09f553adbe47d4af5ee85399265c39 -#: ../src/Doc/c-api/set.rst:31 +#: c-api/set.rst:31 msgid "" "This subtype of :c:type:`PyObject` is used to hold the internal data for " "both :class:`set` and :class:`frozenset` objects. It is like a :c:type:" @@ -9950,61 +10117,61 @@ msgid "" msgstr "" # 906518e85026451ba68be39bbacb3ab0 -#: ../src/Doc/c-api/set.rst:42 +#: c-api/set.rst:42 msgid "" "This is an instance of :c:type:`PyTypeObject` representing the Python :class:" "`set` type." msgstr "" # ef4d0e943c9443e68a15c790cefbfff8 -#: ../src/Doc/c-api/set.rst:48 +#: c-api/set.rst:48 msgid "" "This is an instance of :c:type:`PyTypeObject` representing the Python :class:" "`frozenset` type." msgstr "" -#: ../src/Doc/c-api/set.rst:51 +#: c-api/set.rst:51 msgid "" "The following type check macros work on pointers to any Python object. " "Likewise, the constructor functions work with any iterable Python object." msgstr "" # 3352d6050f734b078ee4172b89d7bba5 -#: ../src/Doc/c-api/set.rst:57 +#: c-api/set.rst:57 msgid "" "Return true if *p* is a :class:`set` object or an instance of a subtype." msgstr "" # 77ad96ffb4224875afa482ccbabd13f2 -#: ../src/Doc/c-api/set.rst:63 +#: c-api/set.rst:63 msgid "" "Return true if *p* is a :class:`frozenset` object or an instance of a " "subtype." msgstr "" # e4e75564f2f3470a8aa267bf4dd50407 -#: ../src/Doc/c-api/set.rst:70 +#: c-api/set.rst:70 msgid "" "Return true if *p* is a :class:`set` object, a :class:`frozenset` object, or " "an instance of a subtype." msgstr "" # baf8cd1d12744392b83ab300e19ea652 -#: ../src/Doc/c-api/set.rst:76 +#: c-api/set.rst:76 msgid "" "Return true if *p* is a :class:`set` object or a :class:`frozenset` object " "but not an instance of a subtype." msgstr "" # 9213d8b6558448d4884d561e5a17c42a -#: ../src/Doc/c-api/set.rst:82 +#: c-api/set.rst:82 msgid "" "Return true if *p* is a :class:`frozenset` object but not an instance of a " "subtype." msgstr "" # 1c8e58b758284cd1a6a794963172c1c5 -#: ../src/Doc/c-api/set.rst:88 +#: c-api/set.rst:88 msgid "" "Return a new :class:`set` containing objects returned by the *iterable*. " "The *iterable* may be *NULL* to create a new empty set. Return the new set " @@ -10014,7 +10181,7 @@ msgid "" msgstr "" # 9feae6fd459746d9ab1fba4b500d477a -#: ../src/Doc/c-api/set.rst:97 +#: c-api/set.rst:97 msgid "" "Return a new :class:`frozenset` containing objects returned by the " "*iterable*. The *iterable* may be *NULL* to create a new empty frozenset. " @@ -10022,14 +10189,21 @@ msgid "" "if *iterable* is not actually iterable." msgstr "" -#: ../src/Doc/c-api/set.rst:107 +#: c-api/set.rst:102 +msgid "" +"Now guaranteed to return a brand-new :class:`frozenset`. Formerly, " +"frozensets of zero-length were a singleton. This got in the way of building-" +"up new frozensets with :meth:`PySet_Add`." +msgstr "" + +#: c-api/set.rst:107 msgid "" "The following functions and macros are available for instances of :class:" "`set` or :class:`frozenset` or instances of their subtypes." msgstr "" # 2f177941f8fc43d9aa6541efab0e52bc -#: ../src/Doc/c-api/set.rst:115 +#: c-api/set.rst:115 msgid "" "Return the length of a :class:`set` or :class:`frozenset` object. Equivalent " "to ``len(anyset)``. Raises a :exc:`PyExc_SystemError` if *anyset* is not a :" @@ -10037,12 +10211,12 @@ msgid "" msgstr "" # 78ff957f1ad64b0c9c00bfa70335f27f -#: ../src/Doc/c-api/set.rst:126 +#: c-api/set.rst:126 msgid "Macro form of :c:func:`PySet_Size` without error checking." msgstr "" # 3b3f4b06315747b583de732f3d06ae97 -#: ../src/Doc/c-api/set.rst:131 +#: c-api/set.rst:131 msgid "" "Return 1 if found, 0 if not found, and -1 if an error is encountered. " "Unlike the Python :meth:`__contains__` method, this function does not " @@ -10053,7 +10227,7 @@ msgid "" msgstr "" # 852b0baded61426796629de3376610fb -#: ../src/Doc/c-api/set.rst:140 +#: c-api/set.rst:140 msgid "" "Add *key* to a :class:`set` instance. Does not apply to :class:`frozenset` " "instances. Return 0 on success or -1 on failure. Raise a :exc:`TypeError` " @@ -10062,14 +10236,21 @@ msgid "" "`set` or its subtype." msgstr "" -#: ../src/Doc/c-api/set.rst:151 +#: c-api/set.rst:146 +msgid "" +"Now works with instances of :class:`frozenset` or its subtypes. Like :c:func:" +"`PyTuple_SetItem` in that it can be used to fill-in the values of brand new " +"frozensets before they are exposed to other code." +msgstr "" + +#: c-api/set.rst:151 msgid "" "The following functions are available for instances of :class:`set` or its " "subtypes but not for instances of :class:`frozenset` or its subtypes." msgstr "" # d6b876f028de4ba5bba533943926e3f3 -#: ../src/Doc/c-api/set.rst:157 +#: c-api/set.rst:157 msgid "" "Return 1 if found and removed, 0 if not found (no action taken), and -1 if " "an error is encountered. Does not raise :exc:`KeyError` for missing keys. " @@ -10080,7 +10261,7 @@ msgid "" msgstr "" # a38fd5ac10974a1dbfeb7312f4e17333 -#: ../src/Doc/c-api/set.rst:167 +#: c-api/set.rst:167 msgid "" "Return a new reference to an arbitrary object in the *set*, and removes the " "object from the *set*. Return *NULL* on failure. Raise :exc:`KeyError` if " @@ -10089,28 +10270,28 @@ msgid "" msgstr "" # bfdd73a7c6104b439232f1b50dbcc086 -#: ../src/Doc/c-api/set.rst:175 +#: c-api/set.rst:175 msgid "Empty an existing set of all elements." msgstr "" -#: ../src/Doc/c-api/slice.rst:6 +#: c-api/slice.rst:6 msgid "Slice Objects" msgstr "" # cd31a5e867724b1a9bc423dd35c4f3c3 -#: ../src/Doc/c-api/slice.rst:13 +#: c-api/slice.rst:13 msgid "" "The type object for slice objects. This is the same as ``slice`` and " "``types.SliceType``." msgstr "" # cddc905dc01646a5b47dbad63adcd4cb -#: ../src/Doc/c-api/slice.rst:19 +#: c-api/slice.rst:19 msgid "Return true if *ob* is a slice object; *ob* must not be *NULL*." msgstr "" # 4cb1f12a066a4a6f8e07b3a9fb2422ab -#: ../src/Doc/c-api/slice.rst:24 +#: c-api/slice.rst:24 msgid "" "Return a new slice object with the given values. The *start*, *stop*, and " "*step* parameters are used as the values of the slice object attributes of " @@ -10120,7 +10301,7 @@ msgid "" msgstr "" # eb49e27c66af4dd8ace89b71d786aee7 -#: ../src/Doc/c-api/slice.rst:33 +#: c-api/slice.rst:33 msgid "" "Retrieve the start, stop and step indices from the slice object *slice*, " "assuming a sequence of length *length*. Treats indices greater than *length* " @@ -10128,7 +10309,7 @@ msgid "" msgstr "" # f52567562c4745bf8eaa05f98f9c7b09 -#: ../src/Doc/c-api/slice.rst:37 +#: c-api/slice.rst:37 msgid "" "Returns 0 on success and -1 on error with no exception set (unless one of " "the indices was not :const:`None` and failed to be converted to an integer, " @@ -10136,7 +10317,7 @@ msgid "" msgstr "" # 2ac7a64698d84a77a5b5829e560336a0 -#: ../src/Doc/c-api/slice.rst:41 +#: c-api/slice.rst:41 msgid "" "You probably do not want to use this function. If you want to use slice " "objects in versions of Python prior to 2.3, you would probably do well to " @@ -10144,8 +10325,15 @@ msgid "" "in the source of your extension." msgstr "" +#: c-api/slice.rst:46 +msgid "" +"This function used an :c:type:`int` type for *length* and an :c:type:`int *` " +"type for *start*, *stop*, and *step*. This might require changes in your " +"code for properly supporting 64-bit systems." +msgstr "" + # d6fac51d218d4687b88b364f8fb3f00a -#: ../src/Doc/c-api/slice.rst:54 +#: c-api/slice.rst:54 msgid "" "Usable replacement for :c:func:`PySlice_GetIndices`. Retrieve the start, " "stop, and step indices from the slice object *slice* assuming a sequence of " @@ -10155,16 +10343,23 @@ msgid "" msgstr "" # 68e174a515dd4d9a89940e9844e5bc44 -#: ../src/Doc/c-api/slice.rst:60 +#: c-api/slice.rst:60 msgid "Returns 0 on success and -1 on error with exception set." msgstr "" -#: ../src/Doc/c-api/string.rst:6 +#: c-api/slice.rst:64 +msgid "" +"This function used an :c:type:`int` type for *length* and an :c:type:`int *` " +"type for *start*, *stop*, *step*, and *slicelength*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + +#: c-api/string.rst:6 #, fuzzy msgid "String/Bytes Objects" msgstr "Objets bytes" -#: ../src/Doc/c-api/string.rst:8 +#: c-api/string.rst:8 #, fuzzy msgid "" "These functions raise :exc:`TypeError` when expecting a string parameter and " @@ -10175,7 +10370,7 @@ msgstr "" "octet." # a4e843b9950e40b78204f3fdc0d4df02 -#: ../src/Doc/c-api/string.rst:13 +#: c-api/string.rst:13 msgid "" "These functions have been renamed to PyBytes_* in Python 3.x. Unless " "otherwise noted, the PyBytes functions available in 3.x are aliased to their " @@ -10183,12 +10378,12 @@ msgid "" msgstr "" # c66e44858edd40e8aed393f2ec707e3e -#: ../src/Doc/c-api/string.rst:22 +#: c-api/string.rst:22 msgid "This subtype of :c:type:`PyObject` represents a Python string object." msgstr "" # 0f9a798af5144d8686db348ac99897c9 -#: ../src/Doc/c-api/string.rst:29 +#: c-api/string.rst:29 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python string type; " "it is the same object as ``str`` and ``types.StringType`` in the Python " @@ -10196,21 +10391,21 @@ msgid "" msgstr "" # 7edc71af715e4610a6c7570face16624 -#: ../src/Doc/c-api/string.rst:35 +#: c-api/string.rst:35 msgid "" "Return true if the object *o* is a string object or an instance of a subtype " "of the string type." msgstr "" # 069262a2cf464a7e95e7cf56a052b8f0 -#: ../src/Doc/c-api/string.rst:44 +#: c-api/string.rst:44 msgid "" "Return true if the object *o* is a string object, but not an instance of a " "subtype of the string type." msgstr "" # 5eabbfe0245c4407932f0609f4acbcfd -#: ../src/Doc/c-api/string.rst:52 +#: c-api/string.rst:52 msgid "" "Return a new string object with a copy of the string *v* as value on " "success, and *NULL* on failure. The parameter *v* must not be *NULL*; it " @@ -10218,7 +10413,7 @@ msgid "" msgstr "" # 49551be9fbf44825855b4244aaca42d3 -#: ../src/Doc/c-api/string.rst:59 +#: c-api/string.rst:59 msgid "" "Return a new string object with a copy of the string *v* as value and length " "*len* on success, and *NULL* on failure. If *v* is *NULL*, the contents of " @@ -10226,7 +10421,7 @@ msgid "" msgstr "" # 2f64b065cb2043a4a545d407953b730f -#: ../src/Doc/c-api/string.rst:70 +#: c-api/string.rst:70 msgid "" "Take a C :c:func:`printf`\\ -style *format* string and a variable number of " "arguments, calculate the size of the resulting Python string and return a " @@ -10237,43 +10432,43 @@ msgstr "" # 471e202ebf4e4151a20cb7aa6a7079be # 98fcaf4a5f9e4607b69f3b79f6198a1f -#: ../src/Doc/c-api/string.rst:86 ../src/Doc/c-api/unicode.rst:258 +#: c-api/string.rst:86 c-api/unicode.rst:258 msgid "Format Characters" msgstr "" # 88530ba6d9fd4860b20c93af176a0d15 # 022b15989650456e8d3bc00e236f72b7 -#: ../src/Doc/c-api/string.rst:86 ../src/Doc/c-api/unicode.rst:258 +#: c-api/string.rst:86 c-api/unicode.rst:258 msgid "Type" msgstr "" # a23a4861244740a28b4fe1435883053c # 7c2d1bc75c494bce8956ce6a8c356701 -#: ../src/Doc/c-api/string.rst:86 ../src/Doc/c-api/unicode.rst:258 +#: c-api/string.rst:86 c-api/unicode.rst:258 msgid "Comment" msgstr "" # a0a5e8749e1b4c319c3628e8f64640e7 # 47cd76546ec64fa189a10560d06d64e2 -#: ../src/Doc/c-api/string.rst:88 ../src/Doc/c-api/unicode.rst:260 +#: c-api/string.rst:88 c-api/unicode.rst:260 msgid ":attr:`%%`" msgstr "" # 91146fe62bbe40cc97c01971f8a5c762 # a7d49deb9036495a8c93f01a608afe49 -#: ../src/Doc/c-api/string.rst:88 ../src/Doc/c-api/unicode.rst:260 +#: c-api/string.rst:88 c-api/unicode.rst:260 msgid "*n/a*" msgstr "" # 47ef9d5ed3434a16b3927275b4de3adc # cdb6aaa7c94748bbb7d058933662c5f4 -#: ../src/Doc/c-api/string.rst:88 ../src/Doc/c-api/unicode.rst:260 +#: c-api/string.rst:88 c-api/unicode.rst:260 msgid "The literal % character." msgstr "" # 017d259794f84d45ba2339a3b1226279 # d3b8e9aab44d499194b5daa878971d71 -#: ../src/Doc/c-api/string.rst:90 ../src/Doc/c-api/unicode.rst:262 +#: c-api/string.rst:90 c-api/unicode.rst:262 msgid ":attr:`%c`" msgstr "" @@ -10289,128 +10484,123 @@ msgstr "" # 3cdf1503bc634ad0bc8cf4558b764555 # 34586101c0b44952a39c10da66ecfc20 # afd0be3ddc6c4f5da6a275c1b704c6a3 -#: ../src/Doc/c-api/string.rst:90 ../src/Doc/c-api/string.rst:93 -#: ../src/Doc/c-api/string.rst:117 ../src/Doc/c-api/string.rst:120 -#: ../src/Doc/c-api/structures.rst:114 ../src/Doc/c-api/structures.rst:238 -#: ../src/Doc/c-api/structures.rst:245 ../src/Doc/c-api/structures.rst:261 -#: ../src/Doc/c-api/unicode.rst:262 ../src/Doc/c-api/unicode.rst:265 -#: ../src/Doc/c-api/unicode.rst:283 ../src/Doc/c-api/unicode.rst:286 +#: c-api/string.rst:90 c-api/string.rst:93 c-api/string.rst:117 +#: c-api/string.rst:120 c-api/structures.rst:114 c-api/structures.rst:238 +#: c-api/structures.rst:245 c-api/structures.rst:261 c-api/unicode.rst:262 +#: c-api/unicode.rst:265 c-api/unicode.rst:283 c-api/unicode.rst:286 msgid "int" msgstr "" # 3826ca8f016040c78fae85b6d557a0eb # 30a2a0969c9e4a50ae835882d5cc750f -#: ../src/Doc/c-api/string.rst:90 ../src/Doc/c-api/unicode.rst:262 +#: c-api/string.rst:90 c-api/unicode.rst:262 msgid "A single character, represented as an C int." msgstr "" # b78cf135d99a41de8e53ccff5942fdaa # 20b7945f74934f3583ab72bac3846d53 -#: ../src/Doc/c-api/string.rst:93 ../src/Doc/c-api/unicode.rst:265 +#: c-api/string.rst:93 c-api/unicode.rst:265 msgid ":attr:`%d`" msgstr "" # b507884740224f7e82e4d03748138a28 # 0e914205a97c4dcd83e08b04244e9dea -#: ../src/Doc/c-api/string.rst:93 ../src/Doc/c-api/unicode.rst:265 +#: c-api/string.rst:93 c-api/unicode.rst:265 msgid "Exactly equivalent to ``printf(\"%d\")``." msgstr "" # 1ad870217739468f8ccd67897b7d88d9 # d7296dede88748a5a64adcb39a3f2172 -#: ../src/Doc/c-api/string.rst:96 ../src/Doc/c-api/unicode.rst:268 +#: c-api/string.rst:96 c-api/unicode.rst:268 msgid ":attr:`%u`" msgstr "" # 31e65c04339444689e0b4d064d4d44df # c2450f731840434c9ec30dad892973f3 # bb0d2b0af47c447fa8cdcb2cd1a98e4f -#: ../src/Doc/c-api/string.rst:96 ../src/Doc/c-api/structures.rst:271 -#: ../src/Doc/c-api/unicode.rst:268 +#: c-api/string.rst:96 c-api/structures.rst:271 c-api/unicode.rst:268 msgid "unsigned int" msgstr "" # 66566231bbd24cb1a55fe1676bca8209 # 242775253178477bbefc156f5d2e2bc8 -#: ../src/Doc/c-api/string.rst:96 ../src/Doc/c-api/unicode.rst:268 +#: c-api/string.rst:96 c-api/unicode.rst:268 msgid "Exactly equivalent to ``printf(\"%u\")``." msgstr "" # a26f980c431040e2abc2ca9de9be46c1 # ae3428f7aee043ad972afb45ccd5b8d0 -#: ../src/Doc/c-api/string.rst:99 ../src/Doc/c-api/unicode.rst:271 +#: c-api/string.rst:99 c-api/unicode.rst:271 msgid ":attr:`%ld`" msgstr "" # b7aef22979b143cd8f13a7738c83db80 # d7c8177bb87d43519536724b5681baa0 # 444094a444dd4f2b8c034ae17b088c19 -#: ../src/Doc/c-api/string.rst:99 ../src/Doc/c-api/structures.rst:262 -#: ../src/Doc/c-api/unicode.rst:271 +#: c-api/string.rst:99 c-api/structures.rst:262 c-api/unicode.rst:271 msgid "long" msgstr "" # 402acd79eed84ff2a563f0fd692ba776 # 00016e818e734dfbacd4b69a5f6ec19a -#: ../src/Doc/c-api/string.rst:99 ../src/Doc/c-api/unicode.rst:271 +#: c-api/string.rst:99 c-api/unicode.rst:271 msgid "Exactly equivalent to ``printf(\"%ld\")``." msgstr "" # 9ebedf39276f4817b1f14e46f5c25f5a # 9e2d2d9850f04babb78c4191cbacf205 -#: ../src/Doc/c-api/string.rst:102 ../src/Doc/c-api/unicode.rst:274 +#: c-api/string.rst:102 c-api/unicode.rst:274 msgid ":attr:`%lu`" msgstr "" # 1227eacd602840b3ac60bbe7e29dc5f6 # 75f7304fae314180ac3a80eafd9a1224 # 4f63f2e200254355813f64e889c31d73 -#: ../src/Doc/c-api/string.rst:102 ../src/Doc/c-api/structures.rst:273 -#: ../src/Doc/c-api/unicode.rst:274 +#: c-api/string.rst:102 c-api/structures.rst:273 c-api/unicode.rst:274 msgid "unsigned long" msgstr "" # 8473166c332548f3822a171d93a86440 # 230a9ff3e1084e9189982010ae906772 -#: ../src/Doc/c-api/string.rst:102 ../src/Doc/c-api/unicode.rst:274 +#: c-api/string.rst:102 c-api/unicode.rst:274 msgid "Exactly equivalent to ``printf(\"%lu\")``." msgstr "" # f52ebd06f99747aa9709ffbb240cdd44 -#: ../src/Doc/c-api/string.rst:105 +#: c-api/string.rst:105 msgid ":attr:`%lld`" msgstr "" # 540d9e0334804a089c072653a0df6a7f # 5a718378ebf74bd3b949ea69953a0a7d -#: ../src/Doc/c-api/string.rst:105 ../src/Doc/c-api/structures.rst:275 +#: c-api/string.rst:105 c-api/structures.rst:275 msgid "long long" msgstr "" # 36c430d1d4fa4306969906e17ff1ff00 -#: ../src/Doc/c-api/string.rst:105 +#: c-api/string.rst:105 msgid "Exactly equivalent to ``printf(\"%lld\")``." msgstr "" # 16fea059721a4ca3a1d3c6b46d7e1acc -#: ../src/Doc/c-api/string.rst:108 +#: c-api/string.rst:108 msgid ":attr:`%llu`" msgstr "" # 4c8e9833130643d09f16e64306092a1e # b1926b2785c14a3e994d85da71c6b3dc -#: ../src/Doc/c-api/string.rst:108 ../src/Doc/c-api/structures.rst:276 +#: c-api/string.rst:108 c-api/structures.rst:276 msgid "unsigned long long" msgstr "" # 51b579bb278046f89255ec42244f90db -#: ../src/Doc/c-api/string.rst:108 +#: c-api/string.rst:108 msgid "Exactly equivalent to ``printf(\"%llu\")``." msgstr "" # 44155af1f21d4369a8da63d181d2c33f # db644f205e354dffac85b26b5bef0386 -#: ../src/Doc/c-api/string.rst:111 ../src/Doc/c-api/unicode.rst:277 +#: c-api/string.rst:111 c-api/unicode.rst:277 msgid ":attr:`%zd`" msgstr "" @@ -10418,92 +10608,92 @@ msgstr "" # f4673d0c2f0f4fbfbc56112fc3364d8d # 21d7ce871c05475e816ccb068c3f141a # 5027008a6b0c4ec2ba48128b44c5795d -#: ../src/Doc/c-api/string.rst:111 ../src/Doc/c-api/structures.rst:241 -#: ../src/Doc/c-api/structures.rst:277 ../src/Doc/c-api/unicode.rst:277 +#: c-api/string.rst:111 c-api/structures.rst:241 c-api/structures.rst:277 +#: c-api/unicode.rst:277 msgid "Py_ssize_t" msgstr "" # 498804ab42d44433953086ac70a69fdc # 41e13c97e3704ef78b4e4c254672aad9 -#: ../src/Doc/c-api/string.rst:111 ../src/Doc/c-api/unicode.rst:277 +#: c-api/string.rst:111 c-api/unicode.rst:277 msgid "Exactly equivalent to ``printf(\"%zd\")``." msgstr "" # 29b534e01043404aba9f567ace5edce1 # 3f73bc002d8a46c7b690e4630999f438 -#: ../src/Doc/c-api/string.rst:114 ../src/Doc/c-api/unicode.rst:280 +#: c-api/string.rst:114 c-api/unicode.rst:280 msgid ":attr:`%zu`" msgstr "" # f03f8ad9c2324d88a0205cbb3135b91b # 554a691737d84a0f98b1cf04218305e0 -#: ../src/Doc/c-api/string.rst:114 ../src/Doc/c-api/unicode.rst:280 +#: c-api/string.rst:114 c-api/unicode.rst:280 msgid "size_t" msgstr "" # f77378cb62e34aaca4aaa94ba926fecc # dfbf21f6dad6409e86a80e1a55f0eba8 -#: ../src/Doc/c-api/string.rst:114 ../src/Doc/c-api/unicode.rst:280 +#: c-api/string.rst:114 c-api/unicode.rst:280 msgid "Exactly equivalent to ``printf(\"%zu\")``." msgstr "" # 013c9d18003a40fca1f3f411136f2cef # 8abbec4ca568440ba340018d4d83a499 -#: ../src/Doc/c-api/string.rst:117 ../src/Doc/c-api/unicode.rst:283 +#: c-api/string.rst:117 c-api/unicode.rst:283 msgid ":attr:`%i`" msgstr "" # 8df083ae5bb14d7c91ae80f4050d2064 # 602e1a9100cf4652b35ed8ad52463d15 -#: ../src/Doc/c-api/string.rst:117 ../src/Doc/c-api/unicode.rst:283 +#: c-api/string.rst:117 c-api/unicode.rst:283 msgid "Exactly equivalent to ``printf(\"%i\")``." msgstr "" # 6ef14ae3552f4dcabea627a47fb91e61 # 63256e8b2a7f4910be7a12e4b3d7300d -#: ../src/Doc/c-api/string.rst:120 ../src/Doc/c-api/unicode.rst:286 +#: c-api/string.rst:120 c-api/unicode.rst:286 msgid ":attr:`%x`" msgstr "" # 0fa6698006104615b635b7ca1b435ec2 # 36e333a24d664b2995292c76c7e7eec9 -#: ../src/Doc/c-api/string.rst:120 ../src/Doc/c-api/unicode.rst:286 +#: c-api/string.rst:120 c-api/unicode.rst:286 msgid "Exactly equivalent to ``printf(\"%x\")``." msgstr "" # 798248e977374f048b8fbfc1f671c383 # e0051a7224d04d0c9e79815ca1509d96 -#: ../src/Doc/c-api/string.rst:123 ../src/Doc/c-api/unicode.rst:289 +#: c-api/string.rst:123 c-api/unicode.rst:289 msgid ":attr:`%s`" msgstr "" # 75774afc29c74e568026c9e6ee4cb47f # 86f57649a7574ebbb651a5802af0aff8 -#: ../src/Doc/c-api/string.rst:123 ../src/Doc/c-api/unicode.rst:289 +#: c-api/string.rst:123 c-api/unicode.rst:289 msgid "char\\*" msgstr "" # 22180cf26b344cbca255a1cd9b730a36 # 1b4840c48e224f2aaa0c8c6a36089eb2 -#: ../src/Doc/c-api/string.rst:123 ../src/Doc/c-api/unicode.rst:289 +#: c-api/string.rst:123 c-api/unicode.rst:289 msgid "A null-terminated C character array." msgstr "" # 66c27e32e39d49d8b34b7437b4add38b # 735767b5a0334c2ea3b089fee77b2598 -#: ../src/Doc/c-api/string.rst:126 ../src/Doc/c-api/unicode.rst:292 +#: c-api/string.rst:126 c-api/unicode.rst:292 msgid ":attr:`%p`" msgstr "" # bf1a96747a374814b7d32e6e53e562c1 # 3ceb780b2bfe4b1085f74f257982c723 -#: ../src/Doc/c-api/string.rst:126 ../src/Doc/c-api/unicode.rst:292 +#: c-api/string.rst:126 c-api/unicode.rst:292 msgid "void\\*" msgstr "" # bbcdba15b8ef40118b4f626cd1037234 # 8f7dff10a1014aa1bd1abd8f9a6bc09e -#: ../src/Doc/c-api/string.rst:126 ../src/Doc/c-api/unicode.rst:292 +#: c-api/string.rst:126 c-api/unicode.rst:292 msgid "" "The hex representation of a C pointer. Mostly equivalent to ``printf(\"%p" "\")`` except that it is guaranteed to start with the literal ``0x`` " @@ -10512,38 +10702,48 @@ msgstr "" # 172ca83681c6498baed2e23834b6adaf # c73ecef9d6cf46c8b59934c8a6e56c60 -#: ../src/Doc/c-api/string.rst:135 ../src/Doc/c-api/unicode.rst:316 +#: c-api/string.rst:135 c-api/unicode.rst:316 msgid "" "An unrecognized format character causes all the rest of the format string to " "be copied as-is to the result string, and any extra arguments discarded." msgstr "" # 740d0b5bc0e04942a7d4aea50de13aba -#: ../src/Doc/c-api/string.rst:140 +#: c-api/string.rst:140 msgid "" "The `\"%lld\"` and `\"%llu\"` format specifiers are only available when :" "const:`HAVE_LONG_LONG` is defined." msgstr "" +#: c-api/string.rst:143 +msgid "Support for `\"%lld\"` and `\"%llu\"` added." +msgstr "" + # ffd15bac004040709ad9b78b9149082f -#: ../src/Doc/c-api/string.rst:149 +#: c-api/string.rst:149 msgid "" "Identical to :c:func:`PyString_FromFormat` except that it takes exactly two " "arguments." msgstr "" # 128fa15c2d6c44bcab793a09f2c1ddf1 -#: ../src/Doc/c-api/string.rst:155 +#: c-api/string.rst:155 msgid "Return the length of the string in string object *string*." msgstr "" # 688ba05e28444136b1edca4ff55054fe -#: ../src/Doc/c-api/string.rst:164 +#: c-api/string.rst:164 msgid "Macro form of :c:func:`PyString_Size` but without error checking." msgstr "" +#: c-api/string.rst:166 +msgid "" +"This macro returned an :c:type:`int` type. This might require changes in " +"your code for properly supporting 64-bit systems." +msgstr "" + # c6dc2ddece474981b55227ddc5164027 -#: ../src/Doc/c-api/string.rst:173 +#: c-api/string.rst:173 msgid "" "Return a NUL-terminated representation of the contents of *string*. The " "pointer refers to the internal buffer of *string*, not a copy. The data " @@ -10555,21 +10755,21 @@ msgid "" msgstr "" # 3efc7de42b744975a61ecc5495f13936 -#: ../src/Doc/c-api/string.rst:184 +#: c-api/string.rst:184 msgid "" "Macro form of :c:func:`PyString_AsString` but without error checking. Only " "string objects are supported; no Unicode objects should be passed." msgstr "" # 048c3c4ca85a4ae6ba21b5cdde3feddc -#: ../src/Doc/c-api/string.rst:190 +#: c-api/string.rst:190 msgid "" "Return a NUL-terminated representation of the contents of the object *obj* " "through the output variables *buffer* and *length*." msgstr "" # e4e85954040d4512a508660c44766317 -#: ../src/Doc/c-api/string.rst:193 +#: c-api/string.rst:193 msgid "" "The function accepts both string and Unicode objects as input. For Unicode " "objects it returns the default encoded version of the object. If *length* " @@ -10578,7 +10778,7 @@ msgid "" msgstr "" # 76dda1a5d40742c6988a404442c0ce08 -#: ../src/Doc/c-api/string.rst:198 +#: c-api/string.rst:198 msgid "" "The buffer refers to an internal string buffer of *obj*, not a copy. The " "data must not be modified in any way, unless the string was just created " @@ -10589,8 +10789,14 @@ msgid "" "raises :exc:`TypeError`." msgstr "" +#: c-api/string.rst:205 +msgid "" +"This function used an :c:type:`int *` type for *length*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + # 8b9f0d26c5294381b4dc808bce20b014 -#: ../src/Doc/c-api/string.rst:212 +#: c-api/string.rst:212 msgid "" "Create a new string object in *\\*string* containing the contents of " "*newpart* appended to *string*; the caller will own the new reference. The " @@ -10601,7 +10807,7 @@ msgid "" msgstr "" # 82874c28428541bea371df97053d5bc1 -#: ../src/Doc/c-api/string.rst:221 +#: c-api/string.rst:221 msgid "" "Create a new string object in *\\*string* containing the contents of " "*newpart* appended to *string*. This version decrements the reference count " @@ -10609,7 +10815,7 @@ msgid "" msgstr "" # 4b418e6c35724c73a60d3401282ee744 -#: ../src/Doc/c-api/string.rst:227 +#: c-api/string.rst:227 msgid "" "A way to resize a string object even though it is \"immutable\". Only use " "this to build up a brand new string object; don't use this if the string may " @@ -10624,14 +10830,14 @@ msgid "" msgstr "" # a29dc753d12a4b4c9362368ea546cbb9 -#: ../src/Doc/c-api/string.rst:243 +#: c-api/string.rst:243 msgid "" "Return a new string object from *format* and *args*. Analogous to ``format % " "args``. The *args* argument must be a tuple or dict." msgstr "" # caeb83f35b954bac887a7a8b099ce52c -#: ../src/Doc/c-api/string.rst:249 +#: c-api/string.rst:249 msgid "" "Intern the argument *\\*string* in place. The argument must be the address " "of a pointer variable pointing to a Python string object. If there is an " @@ -10650,15 +10856,14 @@ msgstr "" # 995e77c2868f4a09ae4ef80738cc351c # 42c8cf9030e44f21bb03da9d62b4edfc # 6a982225035944e69ded1636a252d3c0 -#: ../src/Doc/c-api/string.rst:261 ../src/Doc/c-api/string.rst:273 -#: ../src/Doc/c-api/string.rst:286 ../src/Doc/c-api/string.rst:303 -#: ../src/Doc/c-api/string.rst:316 ../src/Doc/c-api/string.rst:333 +#: c-api/string.rst:261 c-api/string.rst:273 c-api/string.rst:286 +#: c-api/string.rst:303 c-api/string.rst:316 c-api/string.rst:333 msgid "" "This function is not available in 3.x and does not have a PyBytes alias." msgstr "" # 79bbff4399f4484389711698f660f83d -#: ../src/Doc/c-api/string.rst:266 +#: c-api/string.rst:266 msgid "" "A combination of :c:func:`PyString_FromString` and :c:func:" "`PyString_InternInPlace`, returning either a new string object that has been " @@ -10667,7 +10872,7 @@ msgid "" msgstr "" # 5c4a996713f94caf8331887afc59b7b9 -#: ../src/Doc/c-api/string.rst:278 +#: c-api/string.rst:278 msgid "" "Create an object by decoding *size* bytes of the encoded buffer *s* using " "the codec registered for *encoding*. *encoding* and *errors* have the same " @@ -10677,7 +10882,7 @@ msgid "" msgstr "" # 7fc186d37b5943268d2f5bc512baaf25 -#: ../src/Doc/c-api/string.rst:295 +#: c-api/string.rst:295 msgid "" "Decode a string object by passing it to the codec registered for *encoding* " "and return the result as Python object. *encoding* and *errors* have the " @@ -10687,7 +10892,7 @@ msgid "" msgstr "" # cab2bc68b35245fcb4b248f1f6bbab9b -#: ../src/Doc/c-api/string.rst:308 +#: c-api/string.rst:308 msgid "" "Encode the :c:type:`char` buffer of the given size by passing it to the " "codec registered for *encoding* and return a Python object. *encoding* and " @@ -10698,7 +10903,7 @@ msgid "" msgstr "" # 124795461f164a3e891727cd34283146 -#: ../src/Doc/c-api/string.rst:325 +#: c-api/string.rst:325 msgid "" "Encode a string object using the codec registered for *encoding* and return " "the result as Python object. *encoding* and *errors* have the same meaning " @@ -10707,11 +10912,11 @@ msgid "" "if an exception was raised by the codec." msgstr "" -#: ../src/Doc/c-api/structures.rst:6 +#: c-api/structures.rst:6 msgid "Common Object Structures" msgstr "" -#: ../src/Doc/c-api/structures.rst:8 +#: c-api/structures.rst:8 msgid "" "There are a large number of structures which are used in the definition of " "object types for Python. This section describes these structures and how " @@ -10719,7 +10924,7 @@ msgid "" msgstr "" # 845a82ba036542f5b8cd98a9163a9084 -#: ../src/Doc/c-api/structures.rst:12 +#: c-api/structures.rst:12 msgid "" "All Python objects ultimately share a small number of fields at the " "beginning of the object's representation in memory. These are represented " @@ -10729,7 +10934,7 @@ msgid "" msgstr "" # 9bd89241c8594c7ebf9248eafe6eaef9 -#: ../src/Doc/c-api/structures.rst:21 +#: c-api/structures.rst:21 msgid "" "All object types are extensions of this type. This is a type which contains " "the information Python needs to treat a pointer to an object as an object. " @@ -10739,7 +10944,7 @@ msgid "" msgstr "" # d7f1d4d2192d49d8890d90089020deb5 -#: ../src/Doc/c-api/structures.rst:31 +#: c-api/structures.rst:31 msgid "" "This is an extension of :c:type:`PyObject` that adds the :attr:`ob_size` " "field. This is only used for objects that have some notion of *length*. " @@ -10748,14 +10953,14 @@ msgid "" msgstr "" # 9590fd1ba7f24479ab23aaad0ba60173 -#: ../src/Doc/c-api/structures.rst:36 +#: c-api/structures.rst:36 msgid "" "These macros are used in the definition of :c:type:`PyObject` and :c:type:" "`PyVarObject`:" msgstr "" # 88f2232a186e4942a85cb64e7b531206 -#: ../src/Doc/c-api/structures.rst:42 +#: c-api/structures.rst:42 msgid "" "This is a macro which expands to the declarations of the fields of the :c:" "type:`PyObject` type; it is used when declaring new types which represent " @@ -10765,12 +10970,12 @@ msgid "" msgstr "" # b9712fa048f24b7b8b803dd2706599b8 -#: ../src/Doc/c-api/structures.rst:51 +#: c-api/structures.rst:51 msgid "When :c:macro:`Py_TRACE_REFS` is defined, it expands to::" msgstr "" # ac4bcf4205064856b2f85c49e210c487 -#: ../src/Doc/c-api/structures.rst:60 +#: c-api/structures.rst:60 msgid "" "This is a macro which expands to the declarations of the fields of the :c:" "type:`PyVarObject` type; it is used when declaring new types which represent " @@ -10779,21 +10984,21 @@ msgid "" msgstr "" # 83e9371c05c1488da388da178f943bcf -#: ../src/Doc/c-api/structures.rst:68 +#: c-api/structures.rst:68 msgid "" "Note that :c:macro:`PyObject_HEAD` is part of the expansion, and that its " "own expansion varies depending on the definition of :c:macro:`Py_TRACE_REFS`." msgstr "" # bb0ccc33d550409190a12ac23d0a178d -#: ../src/Doc/c-api/structures.rst:74 +#: c-api/structures.rst:74 msgid "" "This is a macro which expands to initialization values for a new :c:type:" "`PyObject` type. This macro expands to::" msgstr "" # e40066f845de44b2b1d76200416af0d9 -#: ../src/Doc/c-api/structures.rst:83 +#: c-api/structures.rst:83 msgid "" "This is a macro which expands to initialization values for a new :c:type:" "`PyVarObject` type, including the :attr:`ob_size` field. This macro expands " @@ -10801,7 +11006,7 @@ msgid "" msgstr "" # 5391de214fac44318343145f5a3e3ceb -#: ../src/Doc/c-api/structures.rst:93 +#: c-api/structures.rst:93 msgid "" "Type of the functions used to implement most Python callables in C. " "Functions of this type take two :c:type:`PyObject\\*` parameters and return " @@ -10811,7 +11016,7 @@ msgid "" msgstr "" # 8c94b09ea150435591712b69c9a5bf1f -#: ../src/Doc/c-api/structures.rst:103 +#: c-api/structures.rst:103 msgid "" "Structure used to describe a method of an extension type. This structure " "has four fields:" @@ -10819,24 +11024,24 @@ msgstr "" # c84d9893aa734db7b932f88f477c42f9 # 7d43d8c80da84d1e84f0e846ca738618 -#: ../src/Doc/c-api/structures.rst:107 ../src/Doc/c-api/structures.rst:234 +#: c-api/structures.rst:107 c-api/structures.rst:234 msgid "Field" msgstr "" # e05db405917b4f1ca1559fb2ba69042e # 66cdb5c56a0b42ab8d1366d8001dbf87 -#: ../src/Doc/c-api/structures.rst:107 ../src/Doc/c-api/structures.rst:234 +#: c-api/structures.rst:107 c-api/structures.rst:234 msgid "C Type" msgstr "" # 3ff274f9cc304312be45136155b1492e # ed754c1426244a70a16d9a487bb8bc01 -#: ../src/Doc/c-api/structures.rst:107 ../src/Doc/c-api/structures.rst:234 +#: c-api/structures.rst:107 c-api/structures.rst:234 msgid "Meaning" msgstr "" # 9b16ac7d33324a95b99afe4bd9b92682 -#: ../src/Doc/c-api/structures.rst:109 +#: c-api/structures.rst:109 msgid ":attr:`ml_name`" msgstr "" @@ -10845,65 +11050,63 @@ msgstr "" # 8c33d008c80441cebcf4835031d83a12 # 5a5d5d025cd14696bc96bdfc322c70ce # 7cbf4c7aa1a64cc6b1229af80e46773c -#: ../src/Doc/c-api/structures.rst:109 ../src/Doc/c-api/structures.rst:117 -#: ../src/Doc/c-api/structures.rst:236 ../src/Doc/c-api/structures.rst:249 -#: ../src/Doc/c-api/structures.rst:265 +#: c-api/structures.rst:109 c-api/structures.rst:117 c-api/structures.rst:236 +#: c-api/structures.rst:249 c-api/structures.rst:265 msgid "char \\*" msgstr "" # 609a2b3e0e554c50b801fd83578306af -#: ../src/Doc/c-api/structures.rst:109 +#: c-api/structures.rst:109 msgid "name of the method" msgstr "" # f112f038ec6342299be124a52d6f3548 -#: ../src/Doc/c-api/structures.rst:111 +#: c-api/structures.rst:111 msgid ":attr:`ml_meth`" msgstr "" -#: ../src/Doc/c-api/structures.rst:111 +#: c-api/structures.rst:111 #, fuzzy msgid "PyCFunction" msgstr "Fonction de l'API" # 77f38b75f194492291b8db84597fcee3 -#: ../src/Doc/c-api/structures.rst:111 +#: c-api/structures.rst:111 msgid "pointer to the C implementation" msgstr "" # 0f3c125b995a4afa8700c6562304a480 -#: ../src/Doc/c-api/structures.rst:114 +#: c-api/structures.rst:114 msgid ":attr:`ml_flags`" msgstr "" # 9f2dca299925471689667563946c5627 -#: ../src/Doc/c-api/structures.rst:114 +#: c-api/structures.rst:114 msgid "flag bits indicating how the call should be constructed" msgstr "" # 995be151b9fa4487a60ac41118d69bc1 -#: ../src/Doc/c-api/structures.rst:117 +#: c-api/structures.rst:117 msgid ":attr:`ml_doc`" msgstr "" # 6e56fb65167d4cfbb2795b596cadc0f5 # ebaf5da23eb94109910a6df70f136b75 -#: ../src/Doc/c-api/structures.rst:117 ../src/Doc/c-api/structures.rst:249 +#: c-api/structures.rst:117 c-api/structures.rst:249 msgid "points to the contents of the docstring" msgstr "" -# 52a4cbe3334d4ef080dfa3b0b6b5b5b8 -#: ../src/Doc/c-api/structures.rst:121 +#: c-api/structures.rst:121 msgid "" "The :attr:`ml_meth` is a C function pointer. The functions may be of " "different types, but they always return :c:type:`PyObject\\*`. If the " "function is not of the :c:type:`PyCFunction`, the compiler will require a " "cast in the method table. Even though :c:type:`PyCFunction` defines the " "first parameter as :c:type:`PyObject\\*`, it is common that the method " -"implementation uses a the specific C type of the *self* object." +"implementation uses the specific C type of the *self* object." msgstr "" -#: ../src/Doc/c-api/structures.rst:128 +#: c-api/structures.rst:128 msgid "" "The :attr:`ml_flags` field is a bitfield which can include the following " "flags. The individual flags indicate either a calling convention or a " @@ -10915,7 +11118,7 @@ msgid "" msgstr "" # 4c827964af3142068f8c993e091a0924 -#: ../src/Doc/c-api/structures.rst:138 +#: c-api/structures.rst:138 msgid "" "This is the typical calling convention, where the methods have the type :c:" "type:`PyCFunction`. The function expects two :c:type:`PyObject\\*` values. " @@ -10926,7 +11129,7 @@ msgid "" msgstr "" # 0f4229c03b884f3b9dbe8a8a5d0645da -#: ../src/Doc/c-api/structures.rst:148 +#: c-api/structures.rst:148 msgid "" "Methods with these flags must be of type :c:type:`PyCFunctionWithKeywords`. " "The function expects three parameters: *self*, *args*, and a dictionary of " @@ -10936,7 +11139,7 @@ msgid "" msgstr "" # e7887ce1af6f4680a033dcce7213ab2d -#: ../src/Doc/c-api/structures.rst:157 +#: c-api/structures.rst:157 msgid "" "Methods without parameters don't need to check whether arguments are given " "if they are listed with the :const:`METH_NOARGS` flag. They need to be of " @@ -10946,7 +11149,7 @@ msgid "" msgstr "" # 0eca0b360900450683885ae002957e21 -#: ../src/Doc/c-api/structures.rst:166 +#: c-api/structures.rst:166 msgid "" "Methods with a single object argument can be listed with the :const:`METH_O` " "flag, instead of invoking :c:func:`PyArg_ParseTuple` with a ``\"O\"`` " @@ -10956,7 +11159,7 @@ msgid "" msgstr "" # 06f57996579945fe9e8ee3c070c0a330 -#: ../src/Doc/c-api/structures.rst:174 +#: c-api/structures.rst:174 msgid "" "This calling convention is deprecated. The method must be of type :c:type:" "`PyCFunction`. The second argument is *NULL* if no arguments are given, a " @@ -10966,7 +11169,7 @@ msgid "" "with a tuple as the only argument." msgstr "" -#: ../src/Doc/c-api/structures.rst:181 +#: c-api/structures.rst:181 msgid "" "These two constants are not used to indicate the calling convention but the " "binding when use with methods of classes. These may not be used for " @@ -10974,27 +11177,27 @@ msgid "" "any given method." msgstr "" -#: ../src/Doc/c-api/structures.rst:191 +#: c-api/structures.rst:191 msgid "" "The method will be passed the type object as the first parameter rather than " "an instance of the type. This is used to create *class methods*, similar to " "what is created when using the :func:`classmethod` built-in function." msgstr "" -#: ../src/Doc/c-api/structures.rst:203 +#: c-api/structures.rst:203 msgid "" "The method will be passed *NULL* as the first parameter rather than an " "instance of the type. This is used to create *static methods*, similar to " "what is created when using the :func:`staticmethod` built-in function." msgstr "" -#: ../src/Doc/c-api/structures.rst:209 +#: c-api/structures.rst:209 msgid "" "One other constant controls whether a method is loaded in place of another " "definition with the same method name." msgstr "" -#: ../src/Doc/c-api/structures.rst:215 +#: c-api/structures.rst:215 msgid "" "The method will be loaded in place of existing definitions. Without " "*METH_COEXIST*, the default is to skip repeated definitions. Since slot " @@ -11008,208 +11211,207 @@ msgid "" msgstr "" # 62ed1e6aab114693a771dd280cfbc334 -#: ../src/Doc/c-api/structures.rst:230 +#: c-api/structures.rst:230 msgid "" "Structure which describes an attribute of a type which corresponds to a C " "struct member. Its fields are:" msgstr "" # 123f8ddbaaeb4dfe8b79022317b4d806 -#: ../src/Doc/c-api/structures.rst:236 +#: c-api/structures.rst:236 msgid ":attr:`name`" msgstr "" # f23fea0a306b4eb18076351928c57dc7 -#: ../src/Doc/c-api/structures.rst:236 +#: c-api/structures.rst:236 msgid "name of the member" msgstr "" # 99f19403324e4795b675b6b1a8ac16f2 -#: ../src/Doc/c-api/structures.rst:238 +#: c-api/structures.rst:238 msgid ":attr:`type`" msgstr "" # 6d6783702d03422e83c48772499b637a -#: ../src/Doc/c-api/structures.rst:238 +#: c-api/structures.rst:238 msgid "the type of the member in the C struct" msgstr "" # a14dda4ecec649bfb8410ccc653ed696 -#: ../src/Doc/c-api/structures.rst:241 +#: c-api/structures.rst:241 msgid ":attr:`offset`" msgstr "" # 3f68339a200a473fa8bbf09c1c2403f0 -#: ../src/Doc/c-api/structures.rst:241 +#: c-api/structures.rst:241 msgid "" "the offset in bytes that the member is located on the type's object struct" msgstr "" # 6d23ce9215664f868e98dc9c0a5ed18f -#: ../src/Doc/c-api/structures.rst:245 +#: c-api/structures.rst:245 msgid ":attr:`flags`" msgstr "" # 969d3eb89b0f4f62b7c4811966524f0e -#: ../src/Doc/c-api/structures.rst:245 +#: c-api/structures.rst:245 msgid "flag bits indicating if the field should be read-only or writable" msgstr "" # 4e85048710344335b941cda343cef99c -#: ../src/Doc/c-api/structures.rst:249 +#: c-api/structures.rst:249 msgid ":attr:`doc`" msgstr "" # 3679d3e6172d48bda64be45cf39b43ec -#: ../src/Doc/c-api/structures.rst:253 +#: c-api/structures.rst:253 msgid "" ":attr:`type` can be one of many ``T_`` macros corresponding to various C " "types. When the member is accessed in Python, it will be converted to the " "equivalent Python type." msgstr "" -#: ../src/Doc/c-api/structures.rst:258 +#: c-api/structures.rst:258 #, fuzzy msgid "Macro name" msgstr "Macros" # c503c8f38dea4fa4bdd8dc96b892ed59 -#: ../src/Doc/c-api/structures.rst:258 +#: c-api/structures.rst:258 msgid "C type" msgstr "" # 4d5da794d2a14452b97b13acf685e2c0 -#: ../src/Doc/c-api/structures.rst:260 +#: c-api/structures.rst:260 msgid "T_SHORT" msgstr "" # a08d9d3590424909bca1021a09e124ba -#: ../src/Doc/c-api/structures.rst:260 +#: c-api/structures.rst:260 msgid "short" msgstr "" # ddba46bdbf7e42d9a51b896ec4fe753e -#: ../src/Doc/c-api/structures.rst:261 +#: c-api/structures.rst:261 msgid "T_INT" msgstr "" # e205b490ea87498faeb5050fb027986e -#: ../src/Doc/c-api/structures.rst:262 +#: c-api/structures.rst:262 msgid "T_LONG" msgstr "" # 8215a1da2a804e478437165e4ae75779 -#: ../src/Doc/c-api/structures.rst:263 +#: c-api/structures.rst:263 msgid "T_FLOAT" msgstr "" # 8ba49158422b4d66b451cafc00685189 -#: ../src/Doc/c-api/structures.rst:263 +#: c-api/structures.rst:263 msgid "float" msgstr "" # 99ea33de1264436e8f826114940b4d2b -#: ../src/Doc/c-api/structures.rst:264 +#: c-api/structures.rst:264 msgid "T_DOUBLE" msgstr "" # 0568555c1291492b9aae95d5da5b8af8 -#: ../src/Doc/c-api/structures.rst:264 +#: c-api/structures.rst:264 msgid "double" msgstr "" # 05fafd92bbf843a08c7f73f3b8d957f9 -#: ../src/Doc/c-api/structures.rst:265 +#: c-api/structures.rst:265 msgid "T_STRING" msgstr "" # 9b381b0910774eb88197b3d74a532398 -#: ../src/Doc/c-api/structures.rst:266 +#: c-api/structures.rst:266 msgid "T_OBJECT" msgstr "" # c8f9601cf49a479d8f04e7e05efb7f07 # ff7499c004e94262a34e4fea69758896 -#: ../src/Doc/c-api/structures.rst:266 ../src/Doc/c-api/structures.rst:267 +#: c-api/structures.rst:266 c-api/structures.rst:267 #, fuzzy msgid "PyObject \\*" msgstr "Objets bytes" # 3da3580f9bcf481296d4e6eefa454b35 -#: ../src/Doc/c-api/structures.rst:267 +#: c-api/structures.rst:267 msgid "T_OBJECT_EX" msgstr "" # 86c3567917b94745968287419025d668 -#: ../src/Doc/c-api/structures.rst:268 +#: c-api/structures.rst:268 msgid "T_CHAR" msgstr "" # 081cdc6e199d43418dbcca89007d19c1 # d60b61cc8aed448ebcc8643000ca0140 # d44d8b4e05f245fc9f2563cb48a83d74 -#: ../src/Doc/c-api/structures.rst:268 ../src/Doc/c-api/structures.rst:269 -#: ../src/Doc/c-api/structures.rst:274 +#: c-api/structures.rst:268 c-api/structures.rst:269 c-api/structures.rst:274 msgid "char" msgstr "" # 5117c6cb97334768ba21f245f5340c44 -#: ../src/Doc/c-api/structures.rst:269 +#: c-api/structures.rst:269 msgid "T_BYTE" msgstr "" # a0a962324491466a8b1bfe1c1882761a -#: ../src/Doc/c-api/structures.rst:270 +#: c-api/structures.rst:270 msgid "T_UBYTE" msgstr "" # d3471db97d544d9ab11d01bf8791497d -#: ../src/Doc/c-api/structures.rst:270 +#: c-api/structures.rst:270 msgid "unsigned char" msgstr "" # 585e918b892346f0b44277b59684716b -#: ../src/Doc/c-api/structures.rst:271 +#: c-api/structures.rst:271 msgid "T_UINT" msgstr "" # 413795b1e8394c4494f1e8657b810c7e -#: ../src/Doc/c-api/structures.rst:272 +#: c-api/structures.rst:272 msgid "T_USHORT" msgstr "" # dbe7ad9754ce46cc8aa7704eff60fd50 -#: ../src/Doc/c-api/structures.rst:272 +#: c-api/structures.rst:272 msgid "unsigned short" msgstr "" # 32ed1771331e4aca8760f268014a86d8 -#: ../src/Doc/c-api/structures.rst:273 +#: c-api/structures.rst:273 msgid "T_ULONG" msgstr "" # 879b3c752755447cbf3031dfa21662d3 -#: ../src/Doc/c-api/structures.rst:274 +#: c-api/structures.rst:274 msgid "T_BOOL" msgstr "" # ae914b5557b54dcf9d497661f55ddade -#: ../src/Doc/c-api/structures.rst:275 +#: c-api/structures.rst:275 msgid "T_LONGLONG" msgstr "" # f064da1a69fb4470aeb34ce360110fd2 -#: ../src/Doc/c-api/structures.rst:276 +#: c-api/structures.rst:276 msgid "T_ULONGLONG" msgstr "" # 8719e562ba224575859c9f28d3e7a5ed -#: ../src/Doc/c-api/structures.rst:277 +#: c-api/structures.rst:277 msgid "T_PYSSIZET" msgstr "" # 8b5cfcd16007493fabd0cabd84e0ca99 -#: ../src/Doc/c-api/structures.rst:280 +#: c-api/structures.rst:280 msgid "" ":c:macro:`T_OBJECT` and :c:macro:`T_OBJECT_EX` differ in that :c:macro:" "`T_OBJECT` returns ``None`` if the member is *NULL* and :c:macro:" @@ -11220,7 +11422,7 @@ msgid "" msgstr "" # 30e2b9ecac9e46d9864c672fb1b1e735 -#: ../src/Doc/c-api/structures.rst:287 +#: c-api/structures.rst:287 msgid "" ":attr:`flags` can be 0 for write and read access or :c:macro:`READONLY` for " "read-only access. Using :c:macro:`T_STRING` for :attr:`type` implies :c:" @@ -11229,7 +11431,7 @@ msgid "" msgstr "" # 84737bc7192247de9060964b3e4dd7af -#: ../src/Doc/c-api/structures.rst:295 +#: c-api/structures.rst:295 msgid "" "Return a bound method object for an extension type implemented in C. This " "can be useful in the implementation of a :c:member:`~PyTypeObject." @@ -11237,12 +11439,12 @@ msgid "" "use the :c:func:`PyObject_GenericGetAttr` function." msgstr "" -#: ../src/Doc/c-api/sys.rst:6 +#: c-api/sys.rst:6 msgid "Operating System Utilities" msgstr "" # e70ffc3ba19d4c0ba1d463e69a8b39d0 -#: ../src/Doc/c-api/sys.rst:11 +#: c-api/sys.rst:11 msgid "" "Return true (nonzero) if the standard I/O file *fp* with name *filename* is " "deemed interactive. This is the case for files for which " @@ -11253,7 +11455,7 @@ msgid "" msgstr "" # 073311ebea7c494ab0d76851e1295d29 -#: ../src/Doc/c-api/sys.rst:20 +#: c-api/sys.rst:20 msgid "" "Function to update some internal state after a process fork; this should be " "called in the new process if the Python interpreter will continue to be " @@ -11262,7 +11464,7 @@ msgid "" msgstr "" # 03520cac340f4a968ab8124b31a78bc3 -#: ../src/Doc/c-api/sys.rst:28 +#: c-api/sys.rst:28 msgid "" "Return true when the interpreter runs out of stack space. This is a " "reliable check, but is only available when :const:`USE_STACKCHECK` is " @@ -11272,7 +11474,7 @@ msgid "" msgstr "" # d10f93acaff6473f84284b421a213f32 -#: ../src/Doc/c-api/sys.rst:37 +#: c-api/sys.rst:37 msgid "" "Return the current signal handler for signal *i*. This is a thin wrapper " "around either :c:func:`sigaction` or :c:func:`signal`. Do not call those " @@ -11281,7 +11483,7 @@ msgid "" msgstr "" # 081571cd9a524878bd2f8265ae27c019 -#: ../src/Doc/c-api/sys.rst:45 +#: c-api/sys.rst:45 msgid "" "Set the signal handler for signal *i* to be *h*; return the old signal " "handler. This is a thin wrapper around either :c:func:`sigaction` or :c:func:" @@ -11289,11 +11491,11 @@ msgid "" "`PyOS_sighandler_t` is a typedef alias for :c:type:`void (\\*)(int)`." msgstr "" -#: ../src/Doc/c-api/sys.rst:53 +#: c-api/sys.rst:53 msgid "System Functions" msgstr "" -#: ../src/Doc/c-api/sys.rst:55 +#: c-api/sys.rst:55 msgid "" "These are utility functions that make functionality from the :mod:`sys` " "module accessible to C code. They all work with the current interpreter " @@ -11302,14 +11504,14 @@ msgid "" msgstr "" # b7b82076857c474cbab6f406c9a4a2b0 -#: ../src/Doc/c-api/sys.rst:61 +#: c-api/sys.rst:61 msgid "" "Return the object *name* from the :mod:`sys` module or *NULL* if it does not " "exist, without setting an exception." msgstr "" # 1ed2eea8ca824bc789dcef1b3504ae0c -#: ../src/Doc/c-api/sys.rst:66 +#: c-api/sys.rst:66 msgid "" "Return the :c:type:`FILE*` associated with the object *name* in the :mod:" "`sys` module, or *def* if *name* is not in the module or is not associated " @@ -11317,7 +11519,7 @@ msgid "" msgstr "" # 05298b4ad4644ed793609f3be94ed2b9 -#: ../src/Doc/c-api/sys.rst:72 +#: c-api/sys.rst:72 msgid "" "Set *name* in the :mod:`sys` module to *v* unless *v* is *NULL*, in which " "case *name* is deleted from the sys module. Returns ``0`` on success, ``-1`` " @@ -11325,17 +11527,17 @@ msgid "" msgstr "" # faa4270c892a41ffafe6b8ef4068890f -#: ../src/Doc/c-api/sys.rst:78 +#: c-api/sys.rst:78 msgid "Reset :data:`sys.warnoptions` to an empty list." msgstr "" # 7b632cccd1264a1196a4194a949dadbb -#: ../src/Doc/c-api/sys.rst:82 +#: c-api/sys.rst:82 msgid "Append *s* to :data:`sys.warnoptions`." msgstr "" # da46ab77a6bf40548d052c1fda8daa8a -#: ../src/Doc/c-api/sys.rst:86 +#: c-api/sys.rst:86 msgid "" "Set :data:`sys.path` to a list object of paths found in *path* which should " "be a list of paths separated with the platform's search path delimiter (``:" @@ -11343,14 +11545,14 @@ msgid "" msgstr "" # 8cf1f87eff8246fcb8858b567c184e01 -#: ../src/Doc/c-api/sys.rst:92 +#: c-api/sys.rst:92 msgid "" "Write the output string described by *format* to :data:`sys.stdout`. No " "exceptions are raised, even if truncation occurs (see below)." msgstr "" # 4980162967514a2bac79281d02c244b2 -#: ../src/Doc/c-api/sys.rst:95 +#: c-api/sys.rst:95 msgid "" "*format* should limit the total size of the formatted output string to 1000 " "bytes or less -- after 1000 bytes, the output string is truncated. In " @@ -11362,23 +11564,23 @@ msgid "" msgstr "" # f6c78a81f9944966a628708a96beb996 -#: ../src/Doc/c-api/sys.rst:103 +#: c-api/sys.rst:103 msgid "" "If a problem occurs, or :data:`sys.stdout` is unset, the formatted message " "is written to the real (C level) *stdout*." msgstr "" # 50f6041c08784b899490d511e9f0dcc4 -#: ../src/Doc/c-api/sys.rst:108 +#: c-api/sys.rst:108 msgid "As above, but write to :data:`sys.stderr` or *stderr* instead." msgstr "" -#: ../src/Doc/c-api/sys.rst:114 +#: c-api/sys.rst:114 msgid "Process Control" msgstr "" # f8a827b5a3444e93ba3cd60575a5b34d -#: ../src/Doc/c-api/sys.rst:121 +#: c-api/sys.rst:121 msgid "" "Print a fatal error message and kill the process. No cleanup is performed. " "This function should only be invoked when a condition is detected that would " @@ -11389,14 +11591,14 @@ msgid "" msgstr "" # c859d9afdf15437c9f08793a4d940b57 -#: ../src/Doc/c-api/sys.rst:135 +#: c-api/sys.rst:135 msgid "" "Exit the current process. This calls :c:func:`Py_Finalize` and then calls " "the standard C library function ``exit(status)``." msgstr "" # 277771a3c094481db05ff7dcecde54a7 -#: ../src/Doc/c-api/sys.rst:145 +#: c-api/sys.rst:145 msgid "" "Register a cleanup function to be called by :c:func:`Py_Finalize`. The " "cleanup function will be called with no arguments and should return no " @@ -11408,43 +11610,43 @@ msgid "" "should be called by *func*." msgstr "" -#: ../src/Doc/c-api/tuple.rst:6 +#: c-api/tuple.rst:6 msgid "Tuple Objects" msgstr "" # 967ef849d699435c98d0d198bef72913 -#: ../src/Doc/c-api/tuple.rst:13 +#: c-api/tuple.rst:13 msgid "This subtype of :c:type:`PyObject` represents a Python tuple object." msgstr "" # 1189871d8cb34413b0e205cfc668eefb -#: ../src/Doc/c-api/tuple.rst:20 +#: c-api/tuple.rst:20 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python tuple type; it " "is the same object as ``tuple`` and ``types.TupleType`` in the Python layer.." msgstr "" # 839ff937c8dc4d959cbf4ce2e12474e2 -#: ../src/Doc/c-api/tuple.rst:26 +#: c-api/tuple.rst:26 msgid "" "Return true if *p* is a tuple object or an instance of a subtype of the " "tuple type." msgstr "" # 80c25cdf59d446adb7624727ac406672 -#: ../src/Doc/c-api/tuple.rst:35 +#: c-api/tuple.rst:35 msgid "" "Return true if *p* is a tuple object, but not an instance of a subtype of " "the tuple type." msgstr "" # b1b3ebc493d2464687b94b236c5f3bf1 -#: ../src/Doc/c-api/tuple.rst:43 +#: c-api/tuple.rst:43 msgid "Return a new tuple object of size *len*, or *NULL* on failure." msgstr "" # 3e5a776bd9ee4ffb8d1ee2b8a5b23a49 -#: ../src/Doc/c-api/tuple.rst:52 +#: c-api/tuple.rst:52 msgid "" "Return a new tuple object of size *n*, or *NULL* on failure. The tuple " "values are initialized to the subsequent *n* C arguments pointing to Python " @@ -11452,40 +11654,59 @@ msgid "" "``Py_BuildValue(\"(OO)\", a, b)``." msgstr "" +#: c-api/tuple.rst:58 +msgid "" +"This function used an :c:type:`int` type for *n*. This might require changes " +"in your code for properly supporting 64-bit systems." +msgstr "" + # bfb98296769741b882909718d16871cc -#: ../src/Doc/c-api/tuple.rst:65 +#: c-api/tuple.rst:65 msgid "Take a pointer to a tuple object, and return the size of that tuple." msgstr "" # 01c3092d86e04c3abc73436e1845f4a5 -#: ../src/Doc/c-api/tuple.rst:74 +#: c-api/tuple.rst:74 msgid "" "Return the size of the tuple *p*, which must be non-*NULL* and point to a " "tuple; no error checking is performed." msgstr "" # d68c1d70c85744c7883417760f5a921f -#: ../src/Doc/c-api/tuple.rst:84 +#: c-api/tuple.rst:84 msgid "" "Return the object at position *pos* in the tuple pointed to by *p*. If " "*pos* is out of bounds, return *NULL* and sets an :exc:`IndexError` " "exception." msgstr "" +#: c-api/tuple.rst:87 c-api/tuple.rst:96 c-api/tuple.rst:120 +#: c-api/tuple.rst:134 +msgid "" +"This function used an :c:type:`int` type for *pos*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + # 673a380c06b44298a19d240e5a57ddea -#: ../src/Doc/c-api/tuple.rst:94 +#: c-api/tuple.rst:94 msgid "Like :c:func:`PyTuple_GetItem`, but does no checking of its arguments." msgstr "" # 5ca33fe5f7ed4c3c88f1136239b7d515 -#: ../src/Doc/c-api/tuple.rst:103 +#: c-api/tuple.rst:103 msgid "" "Take a slice of the tuple pointed to by *p* from *low* to *high* and return " "it as a new tuple." msgstr "" +#: c-api/tuple.rst:106 +msgid "" +"This function used an :c:type:`int` type for *low* and *high*. This might " +"require changes in your code for properly supporting 64-bit systems." +msgstr "" + # 2e8a59e43637428e891a722a6b4821ee -#: ../src/Doc/c-api/tuple.rst:113 +#: c-api/tuple.rst:113 msgid "" "Insert a reference to object *o* at position *pos* of the tuple pointed to " "by *p*. Return ``0`` on success." @@ -11493,19 +11714,19 @@ msgstr "" # de131a2db6ee43809d9f581551781c37 # ecf51a54a4b341fc925aac52d7a98428 -#: ../src/Doc/c-api/tuple.rst:118 ../src/Doc/c-api/tuple.rst:132 +#: c-api/tuple.rst:118 c-api/tuple.rst:132 msgid "This function \"steals\" a reference to *o*." msgstr "" # 71c72cc2ebcf4bf5b27755a88130a64a -#: ../src/Doc/c-api/tuple.rst:127 +#: c-api/tuple.rst:127 msgid "" "Like :c:func:`PyTuple_SetItem`, but does no error checking, and should " "*only* be used to fill in brand new tuples." msgstr "" # 05394a0b177f45b1b9043b9e41e8f61e -#: ../src/Doc/c-api/tuple.rst:141 +#: c-api/tuple.rst:141 msgid "" "Can be used to resize a tuple. *newsize* will be the new length of the " "tuple. Because tuples are *supposed* to be immutable, this should only be " @@ -11520,43 +11741,47 @@ msgid "" "`SystemError`." msgstr "" -#: ../src/Doc/c-api/type.rst:6 ../src/Doc/c-api/typeobj.rst:6 +#: c-api/tuple.rst:152 +msgid "Removed unused third parameter, *last_is_sticky*." +msgstr "" + +#: c-api/type.rst:6 c-api/typeobj.rst:6 msgid "Type Objects" msgstr "" # b63c653840a9437982faf629aeaaf338 -#: ../src/Doc/c-api/type.rst:13 +#: c-api/type.rst:13 msgid "The C structure of the objects used to describe built-in types." msgstr "" # bada912aeec64b8e8b2641868ddd52f6 -#: ../src/Doc/c-api/type.rst:20 +#: c-api/type.rst:20 msgid "" "This is the type object for type objects; it is the same object as ``type`` " "and ``types.TypeType`` in the Python layer." msgstr "" # c99a3cb8f3194ffdb6c61158a9bccbda -#: ../src/Doc/c-api/type.rst:26 +#: c-api/type.rst:26 msgid "" "Return true if the object *o* is a type object, including instances of types " "derived from the standard type object. Return false in all other cases." msgstr "" # 872fb0d25b094028acf9ce122f49b0e7 -#: ../src/Doc/c-api/type.rst:32 +#: c-api/type.rst:32 msgid "" "Return true if the object *o* is a type object, but not a subtype of the " "standard type object. Return false in all other cases." msgstr "" # 34f5bfeb7b4649809e6b083c47fcf87d -#: ../src/Doc/c-api/type.rst:40 +#: c-api/type.rst:40 msgid "Clear the internal lookup cache. Return the current version tag." msgstr "" # 78a9262d07034884bf9bbb69cb9b8e81 -#: ../src/Doc/c-api/type.rst:47 +#: c-api/type.rst:47 msgid "" "Invalidate the internal lookup cache for the type and all of its subtypes. " "This function must be called after any manual modification of the attributes " @@ -11564,34 +11789,40 @@ msgid "" msgstr "" # 19fa6658707c431681b9e563811e1009 -#: ../src/Doc/c-api/type.rst:56 +#: c-api/type.rst:56 msgid "" "Return true if the type object *o* sets the feature *feature*. Type " "features are denoted by single bit flags." msgstr "" # 37c5ab5e00cc4bc39c2bd610b65a1090 -#: ../src/Doc/c-api/type.rst:62 +#: c-api/type.rst:62 msgid "" "Return true if the type object includes support for the cycle detector; this " "tests the type flag :const:`Py_TPFLAGS_HAVE_GC`." msgstr "" # faecd1889cda43c8afb79fb86919f42b -#: ../src/Doc/c-api/type.rst:70 +#: c-api/type.rst:70 msgid "Return true if *a* is a subtype of *b*." msgstr "" # e010249857db442d825dd1a9e5865d77 -#: ../src/Doc/c-api/type.rst:74 +#: c-api/type.rst:74 msgid "" "This function only checks for actual subtypes, which means that :meth:" "`~class.__subclasscheck__` is not called on *b*. Call :c:func:" "`PyObject_IsSubclass` to do the same check that :func:`issubclass` would do." msgstr "" +#: c-api/type.rst:84 +msgid "" +"This function used an :c:type:`int` type for *nitems*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + # 4b03ec023c3a45b5ac059a73301167e2 -#: ../src/Doc/c-api/type.rst:96 +#: c-api/type.rst:96 msgid "" "Finalize a type object. This should be called on all type objects to finish " "their initialization. This function is responsible for adding inherited " @@ -11600,7 +11831,7 @@ msgid "" msgstr "" # 8ef6caa9237449438cd208b9287ba987 -#: ../src/Doc/c-api/typeobj.rst:8 +#: c-api/typeobj.rst:8 msgid "" "Perhaps one of the most important structures of the Python object system is " "the structure that defines a new type: the :c:type:`PyTypeObject` " @@ -11611,7 +11842,7 @@ msgid "" "to any extension module that implements new types." msgstr "" -#: ../src/Doc/c-api/typeobj.rst:16 +#: c-api/typeobj.rst:16 msgid "" "Type objects are fairly large compared to most of the standard types. The " "reason for the size is that each type object stores a large number of " @@ -11622,7 +11853,7 @@ msgid "" msgstr "" # 5aadf53c05a74201a5f16b40fdd7c8cb -#: ../src/Doc/c-api/typeobj.rst:23 +#: c-api/typeobj.rst:23 msgid "" "Typedefs: unaryfunc, binaryfunc, ternaryfunc, inquiry, coercion, intargfunc, " "intintargfunc, intobjargproc, intintobjargproc, objobjargproc, destructor, " @@ -11631,7 +11862,7 @@ msgid "" msgstr "" # 2e31551d90034fac8e7d21462941b3bf -#: ../src/Doc/c-api/typeobj.rst:28 +#: c-api/typeobj.rst:28 msgid "" "The structure definition for :c:type:`PyTypeObject` can be found in :file:" "`Include/object.h`. For convenience of reference, this repeats the " @@ -11639,7 +11870,7 @@ msgid "" msgstr "" # 6c913531d93548a4bf1c7dcd8c4dee1a -#: ../src/Doc/c-api/typeobj.rst:35 +#: c-api/typeobj.rst:35 msgid "" "The type object structure extends the :c:type:`PyVarObject` structure. The :" "attr:`ob_size` field is used for dynamic types (created by :func:" @@ -11650,7 +11881,7 @@ msgid "" msgstr "" # 2b91ac0c471a43b09359d34116148383 -#: ../src/Doc/c-api/typeobj.rst:45 +#: c-api/typeobj.rst:45 msgid "" "These fields are only present when the macro ``Py_TRACE_REFS`` is defined. " "Their initialization to *NULL* is taken care of by the " @@ -11663,12 +11894,12 @@ msgid "" msgstr "" # 74834406cdbd446cb7adb0088ce5dab5 -#: ../src/Doc/c-api/typeobj.rst:54 +#: c-api/typeobj.rst:54 msgid "These fields are not inherited by subtypes." msgstr "" # 51ed1cd6c03f4a6ca9cbe22fb16c6d21 -#: ../src/Doc/c-api/typeobj.rst:59 +#: c-api/typeobj.rst:59 msgid "" "This is the type object's reference count, initialized to ``1`` by the " "``PyObject_HEAD_INIT`` macro. Note that for statically allocated type " @@ -11680,13 +11911,18 @@ msgstr "" # 92ff60c53dc548389bd77c33b20ea739 # d1112c855d7b4b39991547cb5f805976 # d34911b0155d44928412116cf3ff5929 -#: ../src/Doc/c-api/typeobj.rst:65 ../src/Doc/c-api/typeobj.rst:100 -#: ../src/Doc/c-api/typeobj.rst:127 +#: c-api/typeobj.rst:65 c-api/typeobj.rst:100 c-api/typeobj.rst:127 msgid "This field is not inherited by subtypes." msgstr "" +#: c-api/typeobj.rst:67 +msgid "" +"This field used to be an :c:type:`int` type. This might require changes in " +"your code for properly supporting 64-bit systems." +msgstr "" + # 843e03d3cc824d0dbc51a489f80c1420 -#: ../src/Doc/c-api/typeobj.rst:74 +#: c-api/typeobj.rst:74 msgid "" "This is the type's type, in other words its metatype. It is initialized by " "the argument to the ``PyObject_HEAD_INIT`` macro, and its value should " @@ -11699,7 +11935,7 @@ msgid "" msgstr "" # 30dd1a4d767c4eb19ea4fa9bd190f8b3 -#: ../src/Doc/c-api/typeobj.rst:85 +#: c-api/typeobj.rst:85 msgid "" "This should be done before any instances of the type are created. :c:func:" "`PyType_Ready` checks if :attr:`ob_type` is *NULL*, and if so, initializes " @@ -11709,14 +11945,14 @@ msgid "" msgstr "" # 3caa97df6788403dbe9a0018d7212cf3 -#: ../src/Doc/c-api/typeobj.rst:91 +#: c-api/typeobj.rst:91 msgid "" "In Python 2.2, this field is not inherited by subtypes. In 2.2.1, and in " "2.3 and beyond, it is inherited by subtypes." msgstr "" # 5b07f6fa73514f26b7a925d620b887f4 -#: ../src/Doc/c-api/typeobj.rst:97 +#: c-api/typeobj.rst:97 msgid "" "For statically allocated type objects, this should be initialized to zero. " "For dynamically allocated type objects, this field has a special internal " @@ -11724,7 +11960,7 @@ msgid "" msgstr "" # 8df9c68390b548afba630c67ff21bd04 -#: ../src/Doc/c-api/typeobj.rst:105 +#: c-api/typeobj.rst:105 msgid "" "Pointer to a NUL-terminated string containing the name of the type. For " "types that are accessible as module globals, the string should be the full " @@ -11737,7 +11973,7 @@ msgid "" msgstr "" # 820e82f7a0e44f3088f63298409ad428 -#: ../src/Doc/c-api/typeobj.rst:113 +#: c-api/typeobj.rst:113 msgid "" "For dynamically allocated type objects, this should just be the type name, " "and the module name explicitly stored in the type dict as the value for key " @@ -11745,7 +11981,7 @@ msgid "" msgstr "" # 83430549a259424e931b14cb54924e10 -#: ../src/Doc/c-api/typeobj.rst:117 +#: c-api/typeobj.rst:117 msgid "" "For statically allocated type objects, the tp_name field should contain a " "dot. Everything before the last dot is made accessible as the :attr:" @@ -11754,7 +11990,7 @@ msgid "" msgstr "" # a3fd6c2d0a814a94b878baa54d3d4706 -#: ../src/Doc/c-api/typeobj.rst:122 +#: c-api/typeobj.rst:122 msgid "" "If no dot is present, the entire :c:member:`~PyTypeObject.tp_name` field is " "made accessible as the :attr:`__name__` attribute, and the :attr:" @@ -11764,13 +12000,13 @@ msgid "" msgstr "" # 885c6c4bd127418ca87fadfb399918dd -#: ../src/Doc/c-api/typeobj.rst:133 +#: c-api/typeobj.rst:133 msgid "" "These fields allow calculating the size in bytes of instances of the type." msgstr "" # 24978f5871884364b4cccb11675953a1 -#: ../src/Doc/c-api/typeobj.rst:135 +#: c-api/typeobj.rst:135 msgid "" "There are two kinds of types: types with fixed-length instances have a zero :" "c:member:`~PyTypeObject.tp_itemsize` field, types with variable-length " @@ -11780,7 +12016,7 @@ msgid "" msgstr "" # 2f90d4a58dbf48259414219a8955945c -#: ../src/Doc/c-api/typeobj.rst:140 +#: c-api/typeobj.rst:140 msgid "" "For a type with variable-length instances, the instances must have an :attr:" "`ob_size` field, and the instance size is :c:member:`~PyTypeObject." @@ -11795,7 +12031,7 @@ msgid "" msgstr "" # 8eb8f0e4d3f14243b360216b7fd746ff -#: ../src/Doc/c-api/typeobj.rst:151 +#: c-api/typeobj.rst:151 msgid "" "The basic size includes the fields in the instance declared by the macro :c:" "macro:`PyObject_HEAD` or :c:macro:`PyObject_VAR_HEAD` (whichever is used to " @@ -11809,7 +12045,7 @@ msgid "" msgstr "" # 0a39390337064d218d4e1dbac476decb -#: ../src/Doc/c-api/typeobj.rst:160 +#: c-api/typeobj.rst:160 msgid "" "These fields are inherited separately by subtypes. If the base type has a " "non-zero :c:member:`~PyTypeObject.tp_itemsize`, it is generally not safe to " @@ -11818,7 +12054,7 @@ msgid "" msgstr "" # 965d91dffe4243dcb7dafbe7b98496e4 -#: ../src/Doc/c-api/typeobj.rst:165 +#: c-api/typeobj.rst:165 msgid "" "A note about alignment: if the variable items require a particular " "alignment, this should be taken care of by the value of :c:member:" @@ -11830,7 +12066,7 @@ msgid "" msgstr "" # 02bbd63629ac43dab5c47d00a8c49ac7 -#: ../src/Doc/c-api/typeobj.rst:175 +#: c-api/typeobj.rst:175 msgid "" "A pointer to the instance destructor function. This function must be " "defined unless the type guarantees that its instances will never be " @@ -11838,7 +12074,7 @@ msgid "" msgstr "" # 0ebbc2ebb3644d489db5689759b6eba9 -#: ../src/Doc/c-api/typeobj.rst:179 +#: c-api/typeobj.rst:179 msgid "" "The destructor function is called by the :c:func:`Py_DECREF` and :c:func:" "`Py_XDECREF` macros when the new reference count is zero. At this point, " @@ -11867,21 +12103,20 @@ msgstr "" # adb1384d62e84692b6136c0947ced41a # 3443b9bd5e704ef2b427de5cc4eddc4b # d08b4895ac0d4767940704c6a37f97af -#: ../src/Doc/c-api/typeobj.rst:194 ../src/Doc/c-api/typeobj.rst:223 -#: ../src/Doc/c-api/typeobj.rst:287 ../src/Doc/c-api/typeobj.rst:355 -#: ../src/Doc/c-api/typeobj.rst:373 ../src/Doc/c-api/typeobj.rst:763 -#: ../src/Doc/c-api/typeobj.rst:781 ../src/Doc/c-api/typeobj.rst:874 -#: ../src/Doc/c-api/typeobj.rst:885 ../src/Doc/c-api/typeobj.rst:970 +#: c-api/typeobj.rst:194 c-api/typeobj.rst:223 c-api/typeobj.rst:287 +#: c-api/typeobj.rst:355 c-api/typeobj.rst:373 c-api/typeobj.rst:763 +#: c-api/typeobj.rst:781 c-api/typeobj.rst:874 c-api/typeobj.rst:885 +#: c-api/typeobj.rst:970 msgid "This field is inherited by subtypes." msgstr "" # a15016a9de3a44cebde1686de01484e7 -#: ../src/Doc/c-api/typeobj.rst:199 +#: c-api/typeobj.rst:199 msgid "An optional pointer to the instance print function." msgstr "" # e99eaecb5cd64e1aa223774e1f602c8b -#: ../src/Doc/c-api/typeobj.rst:201 +#: c-api/typeobj.rst:201 msgid "" "The print function is only called when the instance is printed to a *real* " "file; when it is printed to a pseudo-file (like a :class:`~StringIO." @@ -11894,7 +12129,7 @@ msgid "" msgstr "" # 51962a6e9b87439993381eaca9a1fae3 -#: ../src/Doc/c-api/typeobj.rst:208 +#: c-api/typeobj.rst:208 msgid "" "The print function is called with the same signature as :c:func:" "`PyObject_Print`: ``int tp_print(PyObject *self, FILE *file, int flags)``. " @@ -11910,7 +12145,7 @@ msgid "" msgstr "" # ce7a9d7c08bb4852a41e53828d0777e3 -#: ../src/Doc/c-api/typeobj.rst:219 +#: c-api/typeobj.rst:219 msgid "" "It is possible that the :c:member:`~PyTypeObject.tp_print` field will be " "deprecated. In any case, it is recommended not to define :c:member:" @@ -11919,12 +12154,12 @@ msgid "" msgstr "" # 48a583440e4440fdb17c5d07c6b44804 -#: ../src/Doc/c-api/typeobj.rst:228 +#: c-api/typeobj.rst:228 msgid "An optional pointer to the get-attribute-string function." msgstr "" # 3bfbf0b3606e4cab96eca36065d088e0 -#: ../src/Doc/c-api/typeobj.rst:230 +#: c-api/typeobj.rst:230 msgid "" "This field is deprecated. When it is defined, it should point to a function " "that acts the same as the :c:member:`~PyTypeObject.tp_getattro` function, " @@ -11934,7 +12169,7 @@ msgid "" msgstr "" # 8879c6a98af84535bdb99563b3d7173b -#: ../src/Doc/c-api/typeobj.rst:235 +#: c-api/typeobj.rst:235 msgid "" "This field is inherited by subtypes together with :c:member:`~PyTypeObject." "tp_getattro`: a subtype inherits both :c:member:`~PyTypeObject.tp_getattr` " @@ -11944,12 +12179,12 @@ msgid "" msgstr "" # e71ee36a0ec14f10bf88a0bff25ceccd -#: ../src/Doc/c-api/typeobj.rst:242 +#: c-api/typeobj.rst:242 msgid "An optional pointer to the set-attribute-string function." msgstr "" # 34894a22c42b4bb4b544828a082e0846 -#: ../src/Doc/c-api/typeobj.rst:244 +#: c-api/typeobj.rst:244 msgid "" "This field is deprecated. When it is defined, it should point to a function " "that acts the same as the :c:member:`~PyTypeObject.tp_setattro` function, " @@ -11959,7 +12194,7 @@ msgid "" msgstr "" # 6d818199419a49129c1c7ead3579ac44 -#: ../src/Doc/c-api/typeobj.rst:249 +#: c-api/typeobj.rst:249 msgid "" "This field is inherited by subtypes together with :c:member:`~PyTypeObject." "tp_setattro`: a subtype inherits both :c:member:`~PyTypeObject.tp_setattr` " @@ -11969,12 +12204,12 @@ msgid "" msgstr "" # e047d38962b247c1a42460c1d4611dbd -#: ../src/Doc/c-api/typeobj.rst:256 +#: c-api/typeobj.rst:256 msgid "An optional pointer to the three-way comparison function." msgstr "" # 64726039d9e0406b94d03217f657fb16 -#: ../src/Doc/c-api/typeobj.rst:258 +#: c-api/typeobj.rst:258 msgid "" "The signature is the same as for :c:func:`PyObject_Compare`. The function " "should return ``1`` if *self* greater than *other*, ``0`` if *self* is equal " @@ -11983,7 +12218,7 @@ msgid "" msgstr "" # 3caa9f41d6a44952ae011ecef4070c80 -#: ../src/Doc/c-api/typeobj.rst:263 +#: c-api/typeobj.rst:263 msgid "" "This field is inherited by subtypes together with :c:member:`~PyTypeObject." "tp_richcompare` and :c:member:`~PyTypeObject.tp_hash`: a subtypes inherits " @@ -11994,14 +12229,14 @@ msgid "" msgstr "" # ba37fe5e689d491d9b05d88fd4720268 -#: ../src/Doc/c-api/typeobj.rst:273 +#: c-api/typeobj.rst:273 msgid "" "An optional pointer to a function that implements the built-in function :" "func:`repr`." msgstr "" # 7cf1e76db3794a09990d1b014cbb62f9 -#: ../src/Doc/c-api/typeobj.rst:276 +#: c-api/typeobj.rst:276 msgid "" "The signature is the same as for :c:func:`PyObject_Repr`; it must return a " "string or a Unicode object. Ideally, this function should return a string " @@ -12012,7 +12247,7 @@ msgid "" msgstr "" # e1597c03b31a405e8ec83bf186850d7c -#: ../src/Doc/c-api/typeobj.rst:283 +#: c-api/typeobj.rst:283 msgid "" "When this field is not set, a string of the form ``<%s object at %p>`` is " "returned, where ``%s`` is replaced by the type name, and ``%p`` by the " @@ -12020,7 +12255,7 @@ msgid "" msgstr "" # cfc096023a8a42f9a570794a7b8d3ba6 -#: ../src/Doc/c-api/typeobj.rst:291 +#: c-api/typeobj.rst:291 msgid "" "Pointer to an additional structure that contains fields relevant only to " "objects which implement the number protocol. These fields are documented " @@ -12028,14 +12263,14 @@ msgid "" msgstr "" # be0986b0fa6e4c619e003b9f157888f4 -#: ../src/Doc/c-api/typeobj.rst:295 +#: c-api/typeobj.rst:295 msgid "" "The :c:member:`~PyTypeObject.tp_as_number` field is not inherited, but the " "contained fields are inherited individually." msgstr "" # 8bfe1899a6a446b2b8f4040a2e91fc0e -#: ../src/Doc/c-api/typeobj.rst:301 +#: c-api/typeobj.rst:301 msgid "" "Pointer to an additional structure that contains fields relevant only to " "objects which implement the sequence protocol. These fields are documented " @@ -12043,14 +12278,14 @@ msgid "" msgstr "" # 9768a000e2d042929fa4ab21b5f6fc24 -#: ../src/Doc/c-api/typeobj.rst:305 +#: c-api/typeobj.rst:305 msgid "" "The :c:member:`~PyTypeObject.tp_as_sequence` field is not inherited, but the " "contained fields are inherited individually." msgstr "" # 73edcfc48d8c42a7abb072d8b531bd19 -#: ../src/Doc/c-api/typeobj.rst:311 +#: c-api/typeobj.rst:311 msgid "" "Pointer to an additional structure that contains fields relevant only to " "objects which implement the mapping protocol. These fields are documented " @@ -12058,21 +12293,21 @@ msgid "" msgstr "" # c014e4d524c649e6b6a7e24d4dc1bba5 -#: ../src/Doc/c-api/typeobj.rst:315 +#: c-api/typeobj.rst:315 msgid "" "The :c:member:`~PyTypeObject.tp_as_mapping` field is not inherited, but the " "contained fields are inherited individually." msgstr "" # 0f6e4f5d828a48e0aecbd7a8f78b9770 -#: ../src/Doc/c-api/typeobj.rst:323 +#: c-api/typeobj.rst:323 msgid "" "An optional pointer to a function that implements the built-in function :" "func:`hash`." msgstr "" # cb02cfcf53314215b00e835a4fc59bec -#: ../src/Doc/c-api/typeobj.rst:326 +#: c-api/typeobj.rst:326 msgid "" "The signature is the same as for :c:func:`PyObject_Hash`; it must return a C " "long. The value ``-1`` should not be returned as a normal return value; " @@ -12081,7 +12316,7 @@ msgid "" msgstr "" # c7eefff3bd574e44b90742173c645bb7 -#: ../src/Doc/c-api/typeobj.rst:331 +#: c-api/typeobj.rst:331 msgid "" "This field can be set explicitly to :c:func:`PyObject_HashNotImplemented` to " "block inheritance of the hash method from a parent type. This is interpreted " @@ -12093,7 +12328,7 @@ msgid "" msgstr "" # 24f467d3b8854057afbd313f8e30ad1d -#: ../src/Doc/c-api/typeobj.rst:339 +#: c-api/typeobj.rst:339 msgid "" "When this field is not set, two possibilities exist: if the :c:member:" "`~PyTypeObject.tp_compare` and :c:member:`~PyTypeObject.tp_richcompare` " @@ -12102,7 +12337,7 @@ msgid "" msgstr "" # 1053253ea6434055a7d8e8c7d6dd3b6c -#: ../src/Doc/c-api/typeobj.rst:343 +#: c-api/typeobj.rst:343 msgid "" "This field is inherited by subtypes together with :c:member:`~PyTypeObject." "tp_richcompare` and :c:member:`~PyTypeObject.tp_compare`: a subtypes " @@ -12113,7 +12348,7 @@ msgid "" msgstr "" # 0bb27deb9af04ec28465ebfb2ff7ee1b -#: ../src/Doc/c-api/typeobj.rst:351 +#: c-api/typeobj.rst:351 msgid "" "An optional pointer to a function that implements calling the object. This " "should be *NULL* if the object is not callable. The signature is the same " @@ -12121,7 +12356,7 @@ msgid "" msgstr "" # 0a19df7917b848ff8405135b1114e574 -#: ../src/Doc/c-api/typeobj.rst:360 +#: c-api/typeobj.rst:360 msgid "" "An optional pointer to a function that implements the built-in operation :" "func:`str`. (Note that :class:`str` is a type now, and :func:`str` calls " @@ -12131,7 +12366,7 @@ msgid "" msgstr "" # 7a3307a34d724a4a9494d254ede8f497 -#: ../src/Doc/c-api/typeobj.rst:365 +#: c-api/typeobj.rst:365 msgid "" "The signature is the same as for :c:func:`PyObject_Str`; it must return a " "string or a Unicode object. This function should return a \"friendly\" " @@ -12140,19 +12375,19 @@ msgid "" msgstr "" # 5000052f1e8a45e7bedd18fcab2bf2d8 -#: ../src/Doc/c-api/typeobj.rst:370 +#: c-api/typeobj.rst:370 msgid "" "When this field is not set, :c:func:`PyObject_Repr` is called to return a " "string representation." msgstr "" # 1277e62d1c214347ae1b5cae9c31c1b5 -#: ../src/Doc/c-api/typeobj.rst:378 +#: c-api/typeobj.rst:378 msgid "An optional pointer to the get-attribute function." msgstr "" # 189646e68cc046c8aabcfbcaf88f8a93 -#: ../src/Doc/c-api/typeobj.rst:380 +#: c-api/typeobj.rst:380 msgid "" "The signature is the same as for :c:func:`PyObject_GetAttr`. It is usually " "convenient to set this field to :c:func:`PyObject_GenericGetAttr`, which " @@ -12160,7 +12395,7 @@ msgid "" msgstr "" # 91a8ba9c29b044e980972a1906db1f36 -#: ../src/Doc/c-api/typeobj.rst:384 +#: c-api/typeobj.rst:384 msgid "" "This field is inherited by subtypes together with :c:member:`~PyTypeObject." "tp_getattr`: a subtype inherits both :c:member:`~PyTypeObject.tp_getattr` " @@ -12170,12 +12405,12 @@ msgid "" msgstr "" # 109d3c906b244ebc88e081abc5d2562d -#: ../src/Doc/c-api/typeobj.rst:391 +#: c-api/typeobj.rst:391 msgid "An optional pointer to the set-attribute function." msgstr "" # 00cb094e56b3468692bcf72552529327 -#: ../src/Doc/c-api/typeobj.rst:393 +#: c-api/typeobj.rst:393 msgid "" "The signature is the same as for :c:func:`PyObject_SetAttr`. It is usually " "convenient to set this field to :c:func:`PyObject_GenericSetAttr`, which " @@ -12183,7 +12418,7 @@ msgid "" msgstr "" # 81a1a4605e204d6882d1e0b10a3a78ce -#: ../src/Doc/c-api/typeobj.rst:397 +#: c-api/typeobj.rst:397 msgid "" "This field is inherited by subtypes together with :c:member:`~PyTypeObject." "tp_setattr`: a subtype inherits both :c:member:`~PyTypeObject.tp_setattr` " @@ -12193,7 +12428,7 @@ msgid "" msgstr "" # c0803890d1384ef8a1c1723c6d80d962 -#: ../src/Doc/c-api/typeobj.rst:404 +#: c-api/typeobj.rst:404 msgid "" "Pointer to an additional structure that contains fields relevant only to " "objects which implement the buffer interface. These fields are documented " @@ -12201,14 +12436,14 @@ msgid "" msgstr "" # 83c10dc1c97548bcb5f3a3896101db70 -#: ../src/Doc/c-api/typeobj.rst:408 +#: c-api/typeobj.rst:408 msgid "" "The :c:member:`~PyTypeObject.tp_as_buffer` field is not inherited, but the " "contained fields are inherited individually." msgstr "" # 256ab99cdd1f4bc2a9f18552e34abe73 -#: ../src/Doc/c-api/typeobj.rst:414 +#: c-api/typeobj.rst:414 msgid "" "This field is a bit mask of various flags. Some flags indicate variant " "semantics for certain situations; others are used to indicate that certain " @@ -12221,7 +12456,7 @@ msgid "" msgstr "" # 0d7139de9d5b44a2bdcfc685f74c5ecd -#: ../src/Doc/c-api/typeobj.rst:422 +#: c-api/typeobj.rst:422 msgid "" "Inheritance of this field is complicated. Most flag bits are inherited " "individually, i.e. if the base type has a flag bit set, the subtype inherits " @@ -12238,7 +12473,7 @@ msgid "" msgstr "" # b35a98b2704a4b25a2402b5ed1e8d0f5 -#: ../src/Doc/c-api/typeobj.rst:434 +#: c-api/typeobj.rst:434 msgid "" "The following bit masks are currently defined; these can be ORed together " "using the ``|`` operator to form the value of the :c:member:`~PyTypeObject." @@ -12248,28 +12483,28 @@ msgid "" msgstr "" # c5cfd9bae80c4298a2a2cc4e04f4007c -#: ../src/Doc/c-api/typeobj.rst:442 +#: c-api/typeobj.rst:442 msgid "" "If this bit is set, the :c:type:`PyBufferProcs` struct referenced by :c:" "member:`~PyTypeObject.tp_as_buffer` has the :attr:`bf_getcharbuffer` field." msgstr "" # 99c9a0513052447d9e7768a94f6dc1e7 -#: ../src/Doc/c-api/typeobj.rst:448 +#: c-api/typeobj.rst:448 msgid "" "If this bit is set, the :c:type:`PySequenceMethods` struct referenced by :c:" "member:`~PyTypeObject.tp_as_sequence` has the :attr:`sq_contains` field." msgstr "" # e40cab43776942f88b03c3b981c860aa -#: ../src/Doc/c-api/typeobj.rst:454 +#: c-api/typeobj.rst:454 msgid "" "This bit is obsolete. The bit it used to name is no longer in use. The " "symbol is now defined as zero." msgstr "" # 39b65657f488479987a9050192df9134 -#: ../src/Doc/c-api/typeobj.rst:460 +#: c-api/typeobj.rst:460 msgid "" "If this bit is set, the :c:type:`PySequenceMethods` struct referenced by :c:" "member:`~PyTypeObject.tp_as_sequence` and the :c:type:`PyNumberMethods` " @@ -12285,7 +12520,7 @@ msgid "" msgstr "" # 6251e3e4ca7c4dfab63efe6dc63415c6 -#: ../src/Doc/c-api/typeobj.rst:475 +#: c-api/typeobj.rst:475 msgid "" "If this bit is set, the binary and ternary operations in the :c:type:" "`PyNumberMethods` structure referenced by :c:member:`~PyTypeObject." @@ -12299,7 +12534,7 @@ msgid "" msgstr "" # 07a974351a024241906cf2642ff2dfe5 -#: ../src/Doc/c-api/typeobj.rst:488 +#: c-api/typeobj.rst:488 msgid "" "If this bit is set, the type object has the :c:member:`~PyTypeObject." "tp_richcompare` field, as well as the :c:member:`~PyTypeObject.tp_traverse` " @@ -12307,7 +12542,7 @@ msgid "" msgstr "" # f2eb1011689b488a99895dc6dc9704ae -#: ../src/Doc/c-api/typeobj.rst:494 +#: c-api/typeobj.rst:494 msgid "" "If this bit is set, the :c:member:`~PyTypeObject.tp_weaklistoffset` field is " "defined. Instances of a type are weakly referenceable if the type's :c:" @@ -12315,14 +12550,14 @@ msgid "" msgstr "" # 49793033458d47b7ace86e5f5a87a619 -#: ../src/Doc/c-api/typeobj.rst:501 +#: c-api/typeobj.rst:501 msgid "" "If this bit is set, the type object has the :c:member:`~PyTypeObject." "tp_iter` and :c:member:`~PyTypeObject.tp_iternext` fields." msgstr "" # 689887298e9e4a45ae2e84c45cfe1cf6 -#: ../src/Doc/c-api/typeobj.rst:507 +#: c-api/typeobj.rst:507 msgid "" "If this bit is set, the type object has several new fields defined starting " "in Python 2.2: :c:member:`~PyTypeObject.tp_methods`, :c:member:" @@ -12338,7 +12573,7 @@ msgid "" msgstr "" # 45056ddfd61248e4bbfb0cc7faec4d81 -#: ../src/Doc/c-api/typeobj.rst:517 +#: c-api/typeobj.rst:517 msgid "" "This bit is set when the type object itself is allocated on the heap. In " "this case, the :attr:`ob_type` field of its instances is considered a " @@ -12349,7 +12584,7 @@ msgid "" msgstr "" # 629f7cf9c2404690a323eb4234be9980 -#: ../src/Doc/c-api/typeobj.rst:527 +#: c-api/typeobj.rst:527 msgid "" "This bit is set when the type can be used as the base type of another type. " "If this bit is clear, the type cannot be subtyped (similar to a \"final\" " @@ -12357,21 +12592,21 @@ msgid "" msgstr "" # 1d095d5d681a4ba5b199908eb75aaf8f -#: ../src/Doc/c-api/typeobj.rst:534 +#: c-api/typeobj.rst:534 msgid "" "This bit is set when the type object has been fully initialized by :c:func:" "`PyType_Ready`." msgstr "" # 02fe97cd307f4a77abddaa6cade9134c -#: ../src/Doc/c-api/typeobj.rst:540 +#: c-api/typeobj.rst:540 msgid "" "This bit is set while :c:func:`PyType_Ready` is in the process of " "initializing the type object." msgstr "" # 19ffa0ac231f41cc807995ab1a5311df -#: ../src/Doc/c-api/typeobj.rst:546 +#: c-api/typeobj.rst:546 msgid "" "This bit is set when the object supports garbage collection. If this bit is " "set, instances must be created using :c:func:`PyObject_GC_New` and destroyed " @@ -12384,7 +12619,7 @@ msgid "" msgstr "" # 5321bf6cd5df47b9836e5ceca196cfdf -#: ../src/Doc/c-api/typeobj.rst:558 +#: c-api/typeobj.rst:558 msgid "" "This is a bitmask of all the bits that pertain to the existence of certain " "fields in the type object and its extension structures. Currently, it " @@ -12395,7 +12630,7 @@ msgid "" msgstr "" # cc63d1f2427b41b3b106be434abca90c -#: ../src/Doc/c-api/typeobj.rst:568 +#: c-api/typeobj.rst:568 msgid "" "An optional pointer to a NUL-terminated C string giving the docstring for " "this type object. This is exposed as the :attr:`__doc__` attribute on the " @@ -12403,19 +12638,19 @@ msgid "" msgstr "" # a1bc69d1d3c74bfd96632ed5a2776f16 -#: ../src/Doc/c-api/typeobj.rst:572 +#: c-api/typeobj.rst:572 msgid "This field is *not* inherited by subtypes." msgstr "" # 6bf3e6b6bc2b44fdb348800d6ac44165 -#: ../src/Doc/c-api/typeobj.rst:574 +#: c-api/typeobj.rst:574 msgid "" "The following three fields only exist if the :const:" "`Py_TPFLAGS_HAVE_RICHCOMPARE` flag bit is set." msgstr "" # 5849b4e5ae04493188c5b5f4e7f4afc1 -#: ../src/Doc/c-api/typeobj.rst:580 +#: c-api/typeobj.rst:580 msgid "" "An optional pointer to a traversal function for the garbage collector. This " "is only used if the :const:`Py_TPFLAGS_HAVE_GC` flag bit is set. More " @@ -12424,7 +12659,7 @@ msgid "" msgstr "" # e89539d806da4ccfa3e0f3aa08cd868f -#: ../src/Doc/c-api/typeobj.rst:585 +#: c-api/typeobj.rst:585 msgid "" "The :c:member:`~PyTypeObject.tp_traverse` pointer is used by the garbage " "collector to detect reference cycles. A typical implementation of a :c:" @@ -12435,7 +12670,7 @@ msgid "" msgstr "" # fd9351c5e076415ea47310eb089258d6 -#: ../src/Doc/c-api/typeobj.rst:600 +#: c-api/typeobj.rst:600 msgid "" "Note that :c:func:`Py_VISIT` is called only on those members that can " "participate in reference cycles. Although there is also a ``self->key`` " @@ -12444,7 +12679,7 @@ msgid "" msgstr "" # 9b992b619cfe405f8cb6173952d0e493 -#: ../src/Doc/c-api/typeobj.rst:604 +#: c-api/typeobj.rst:604 msgid "" "On the other hand, even if you know a member can never be part of a cycle, " "as a debugging aid you may want to visit it anyway just so the :mod:`gc` " @@ -12452,7 +12687,7 @@ msgid "" msgstr "" # 561c167210fd4e2f9c5905a36b22033e -#: ../src/Doc/c-api/typeobj.rst:608 +#: c-api/typeobj.rst:608 msgid "" "Note that :c:func:`Py_VISIT` requires the *visit* and *arg* parameters to :c:" "func:`local_traverse` to have these specific names; don't name them just " @@ -12460,7 +12695,7 @@ msgid "" msgstr "" # 0bcd3a3ec3ac4f3bbcb81790581b05d1 -#: ../src/Doc/c-api/typeobj.rst:612 +#: c-api/typeobj.rst:612 msgid "" "This field is inherited by subtypes together with :c:member:`~PyTypeObject." "tp_clear` and the :const:`Py_TPFLAGS_HAVE_GC` flag bit: the flag bit, :c:" @@ -12470,14 +12705,14 @@ msgid "" msgstr "" # 6530210d227344fe8585bb209753cbd0 -#: ../src/Doc/c-api/typeobj.rst:621 +#: c-api/typeobj.rst:621 msgid "" "An optional pointer to a clear function for the garbage collector. This is " "only used if the :const:`Py_TPFLAGS_HAVE_GC` flag bit is set." msgstr "" # b115349d3e94435e8f293bd142e739de -#: ../src/Doc/c-api/typeobj.rst:624 +#: c-api/typeobj.rst:624 msgid "" "The :c:member:`~PyTypeObject.tp_clear` member function is used to break " "reference cycles in cyclic garbage detected by the garbage collector. Taken " @@ -12493,7 +12728,7 @@ msgid "" msgstr "" # f4c7f42cb74540d7b0ca31ee168a2ce4 -#: ../src/Doc/c-api/typeobj.rst:634 +#: c-api/typeobj.rst:634 msgid "" "Implementations of :c:member:`~PyTypeObject.tp_clear` should drop the " "instance's references to those of its members that may be Python objects, " @@ -12502,7 +12737,7 @@ msgid "" msgstr "" # a8370cf855eb4268a9df9860eb796416 -#: ../src/Doc/c-api/typeobj.rst:648 +#: c-api/typeobj.rst:648 msgid "" "The :c:func:`Py_CLEAR` macro should be used, because clearing references is " "delicate: the reference to the contained object must not be decremented " @@ -12518,7 +12753,7 @@ msgid "" msgstr "" # 4fabca3e05cf4d33a37e7b1d2f980de0 -#: ../src/Doc/c-api/typeobj.rst:659 +#: c-api/typeobj.rst:659 msgid "" "Because the goal of :c:member:`~PyTypeObject.tp_clear` functions is to break " "reference cycles, it's not necessary to clear contained objects like Python " @@ -12529,14 +12764,14 @@ msgid "" msgstr "" # 0b3b77ef1b3745298dc0d5968dfdaa8c -#: ../src/Doc/c-api/typeobj.rst:665 +#: c-api/typeobj.rst:665 msgid "" "More information about Python's garbage collection scheme can be found in " "section :ref:`supporting-cycle-detection`." msgstr "" # d3b3a00c07fe47fa82d1e2c84f200837 -#: ../src/Doc/c-api/typeobj.rst:668 +#: c-api/typeobj.rst:668 msgid "" "This field is inherited by subtypes together with :c:member:`~PyTypeObject." "tp_traverse` and the :const:`Py_TPFLAGS_HAVE_GC` flag bit: the flag bit, :c:" @@ -12546,14 +12781,14 @@ msgid "" msgstr "" # 3b3d3245044647beb74ff1b66a8fa3c2 -#: ../src/Doc/c-api/typeobj.rst:677 +#: c-api/typeobj.rst:677 msgid "" "An optional pointer to the rich comparison function, whose signature is " "``PyObject *tp_richcompare(PyObject *a, PyObject *b, int op)``." msgstr "" # 4dd58f84f2904faaa102a13e18bbe7d1 -#: ../src/Doc/c-api/typeobj.rst:680 +#: c-api/typeobj.rst:680 msgid "" "The function should return the result of the comparison (usually ``Py_True`` " "or ``Py_False``). If the comparison is undefined, it must return " @@ -12562,7 +12797,7 @@ msgid "" msgstr "" # 7dccaf6da4724bbcad9b7ab52fc4981a -#: ../src/Doc/c-api/typeobj.rst:687 +#: c-api/typeobj.rst:687 msgid "" "If you want to implement a type for which only a limited set of comparisons " "makes sense (e.g. ``==`` and ``!=``, but not ``<`` and friends), directly " @@ -12570,7 +12805,7 @@ msgid "" msgstr "" # 909c0c70f933444db985f93842c38b80 -#: ../src/Doc/c-api/typeobj.rst:691 +#: c-api/typeobj.rst:691 msgid "" "This field is inherited by subtypes together with :c:member:`~PyTypeObject." "tp_compare` and :c:member:`~PyTypeObject.tp_hash`: a subtype inherits all " @@ -12581,91 +12816,91 @@ msgid "" msgstr "" # 8f3d39dbb67b4c47ae55b89cf2b86786 -#: ../src/Doc/c-api/typeobj.rst:696 +#: c-api/typeobj.rst:696 msgid "" "The following constants are defined to be used as the third argument for :c:" "member:`~PyTypeObject.tp_richcompare` and for :c:func:`PyObject_RichCompare`:" msgstr "" # 57b0a40115b54597b579794bc4db77af -#: ../src/Doc/c-api/typeobj.rst:700 +#: c-api/typeobj.rst:700 msgid "Constant" msgstr "" # 2c0fe65bb94e4166b102fe073c95c0b9 -#: ../src/Doc/c-api/typeobj.rst:700 +#: c-api/typeobj.rst:700 msgid "Comparison" msgstr "" # 4712ea9ba79146faa6ae157775374ea2 -#: ../src/Doc/c-api/typeobj.rst:702 +#: c-api/typeobj.rst:702 msgid ":const:`Py_LT`" msgstr "" # abcc0836829b4540a39f768ee21e518c -#: ../src/Doc/c-api/typeobj.rst:702 +#: c-api/typeobj.rst:702 msgid "``<``" msgstr "" # c350da04d3e24a6a867c5c428fcc9aa1 -#: ../src/Doc/c-api/typeobj.rst:704 +#: c-api/typeobj.rst:704 msgid ":const:`Py_LE`" msgstr "" # e3f06ccce9a2408b8d0b5d2eac0ae21c -#: ../src/Doc/c-api/typeobj.rst:704 +#: c-api/typeobj.rst:704 msgid "``<=``" msgstr "" # c07654aa3c3d4090bf2004468f7c7582 -#: ../src/Doc/c-api/typeobj.rst:706 +#: c-api/typeobj.rst:706 msgid ":const:`Py_EQ`" msgstr "" # f12683b069c04743817cf886ac43fd71 -#: ../src/Doc/c-api/typeobj.rst:706 +#: c-api/typeobj.rst:706 msgid "``==``" msgstr "" # 51233278d64b4653b8a032d7189d58ee -#: ../src/Doc/c-api/typeobj.rst:708 +#: c-api/typeobj.rst:708 msgid ":const:`Py_NE`" msgstr "" # 6ad622f885cb4d928f3a529c03564ef4 -#: ../src/Doc/c-api/typeobj.rst:708 +#: c-api/typeobj.rst:708 msgid "``!=``" msgstr "" # 6aea469b6cff4529ae00f5b89f9d1c61 -#: ../src/Doc/c-api/typeobj.rst:710 +#: c-api/typeobj.rst:710 msgid ":const:`Py_GT`" msgstr "" # 8eb256e476944a16af4121c7b690e75a -#: ../src/Doc/c-api/typeobj.rst:710 +#: c-api/typeobj.rst:710 msgid "``>``" msgstr "" # 3793c1ee41c54446a53994a9f08e2b0f -#: ../src/Doc/c-api/typeobj.rst:712 +#: c-api/typeobj.rst:712 msgid ":const:`Py_GE`" msgstr "" # 74e3b65a92c649aebc1346ed887396a6 -#: ../src/Doc/c-api/typeobj.rst:712 +#: c-api/typeobj.rst:712 msgid "``>=``" msgstr "" # 2bd6e83a75cb4797b868d6cbf3b709f1 -#: ../src/Doc/c-api/typeobj.rst:716 +#: c-api/typeobj.rst:716 msgid "" "The next field only exists if the :const:`Py_TPFLAGS_HAVE_WEAKREFS` flag bit " "is set." msgstr "" # 0481d1b56c1e4206b7ed735567dcf6c9 -#: ../src/Doc/c-api/typeobj.rst:721 +#: c-api/typeobj.rst:721 msgid "" "If the instances of this type are weakly referenceable, this field is " "greater than zero and contains the offset in the instance structure of the " @@ -12676,14 +12911,14 @@ msgid "" msgstr "" # dc33a14bd8e94879a20781199f16f58d -#: ../src/Doc/c-api/typeobj.rst:728 +#: c-api/typeobj.rst:728 msgid "" "Do not confuse this field with :c:member:`~PyTypeObject.tp_weaklist`; that " "is the list head for weak references to the type object itself." msgstr "" # a01f93cb6c0146429335f524f8f5eff0 -#: ../src/Doc/c-api/typeobj.rst:731 +#: c-api/typeobj.rst:731 msgid "" "This field is inherited by subtypes, but see the rules listed below. A " "subtype may override this offset; this means that the subtype uses a " @@ -12693,7 +12928,7 @@ msgid "" msgstr "" # d35b812b6951476e9bdd6730d6ac59b1 -#: ../src/Doc/c-api/typeobj.rst:736 +#: c-api/typeobj.rst:736 msgid "" "When a type defined by a class statement has no :attr:`~object.__slots__` " "declaration, and none of its base types are weakly referenceable, the type " @@ -12703,7 +12938,7 @@ msgid "" msgstr "" # fdfb7aff7bfb4a59b7b2fc9f97b1eec9 -#: ../src/Doc/c-api/typeobj.rst:741 +#: c-api/typeobj.rst:741 msgid "" "When a type's :attr:`__slots__` declaration contains a slot named :attr:" "`__weakref__`, that slot becomes the weak reference list head for instances " @@ -12712,7 +12947,7 @@ msgid "" msgstr "" # be6c48d60af647529b7afd9d5539a696 -#: ../src/Doc/c-api/typeobj.rst:746 +#: c-api/typeobj.rst:746 msgid "" "When a type's :attr:`__slots__` declaration does not contain a slot named :" "attr:`__weakref__`, the type inherits its :c:member:`~PyTypeObject." @@ -12720,14 +12955,14 @@ msgid "" msgstr "" # 2033ed52b2ad462f84091e1f2052e2e9 -#: ../src/Doc/c-api/typeobj.rst:750 +#: c-api/typeobj.rst:750 msgid "" "The next two fields only exist if the :const:`Py_TPFLAGS_HAVE_ITER` flag bit " "is set." msgstr "" # 3a18486036f0407c9dff25e2a8d58087 -#: ../src/Doc/c-api/typeobj.rst:756 +#: c-api/typeobj.rst:756 msgid "" "An optional pointer to a function that returns an iterator for the object. " "Its presence normally signals that the instances of this type are iterable " @@ -12737,12 +12972,12 @@ msgid "" msgstr "" # 2980ed305e514fbd9a4b81bd0db0b36d -#: ../src/Doc/c-api/typeobj.rst:761 +#: c-api/typeobj.rst:761 msgid "This function has the same signature as :c:func:`PyObject_GetIter`." msgstr "" # df2b58da41a04e78918cd77e2e027325 -#: ../src/Doc/c-api/typeobj.rst:768 +#: c-api/typeobj.rst:768 msgid "" "An optional pointer to a function that returns the next item in an iterator. " "When the iterator is exhausted, it must return *NULL*; a :exc:" @@ -12753,7 +12988,7 @@ msgid "" msgstr "" # 3c9264470fdf47bc87e1af23cc727957 -#: ../src/Doc/c-api/typeobj.rst:775 +#: c-api/typeobj.rst:775 msgid "" "Iterator types should also define the :c:member:`~PyTypeObject.tp_iter` " "function, and that function should return the iterator instance itself (not " @@ -12761,40 +12996,40 @@ msgid "" msgstr "" # f07dcfa8c1154cbf9637c205a1cb8239 -#: ../src/Doc/c-api/typeobj.rst:779 +#: c-api/typeobj.rst:779 msgid "This function has the same signature as :c:func:`PyIter_Next`." msgstr "" # e3ce13245ed74f7297b733ed9259043c -#: ../src/Doc/c-api/typeobj.rst:783 +#: c-api/typeobj.rst:783 msgid "" "The next fields, up to and including :c:member:`~PyTypeObject.tp_weaklist`, " "only exist if the :const:`Py_TPFLAGS_HAVE_CLASS` flag bit is set." msgstr "" # 8974ec691d594ff396493c9095b495a9 -#: ../src/Doc/c-api/typeobj.rst:789 +#: c-api/typeobj.rst:789 msgid "" "An optional pointer to a static *NULL*-terminated array of :c:type:" "`PyMethodDef` structures, declaring regular methods of this type." msgstr "" # ea49a1edf1ed4e1c9b33211265eb18c2 -#: ../src/Doc/c-api/typeobj.rst:792 +#: c-api/typeobj.rst:792 msgid "" "For each entry in the array, an entry is added to the type's dictionary " "(see :c:member:`~PyTypeObject.tp_dict` below) containing a method descriptor." msgstr "" # 8f0f0315e8f04a3494d2789d603b9051 -#: ../src/Doc/c-api/typeobj.rst:795 +#: c-api/typeobj.rst:795 msgid "" "This field is not inherited by subtypes (methods are inherited through a " "different mechanism)." msgstr "" # f69ccf279ead4f4cbe80d05d19e51085 -#: ../src/Doc/c-api/typeobj.rst:801 +#: c-api/typeobj.rst:801 msgid "" "An optional pointer to a static *NULL*-terminated array of :c:type:" "`PyMemberDef` structures, declaring regular data members (fields or slots) " @@ -12802,21 +13037,21 @@ msgid "" msgstr "" # 3bcf6bc19eb345f6b60e94885f3b8629 -#: ../src/Doc/c-api/typeobj.rst:805 +#: c-api/typeobj.rst:805 msgid "" "For each entry in the array, an entry is added to the type's dictionary " "(see :c:member:`~PyTypeObject.tp_dict` below) containing a member descriptor." msgstr "" # 9e3e6a0fea094e8ca123bb9ce807e942 -#: ../src/Doc/c-api/typeobj.rst:808 +#: c-api/typeobj.rst:808 msgid "" "This field is not inherited by subtypes (members are inherited through a " "different mechanism)." msgstr "" # fde6e3d629484966a7ed387791fdb6fb -#: ../src/Doc/c-api/typeobj.rst:814 +#: c-api/typeobj.rst:814 msgid "" "An optional pointer to a static *NULL*-terminated array of :c:type:" "`PyGetSetDef` structures, declaring computed attributes of instances of this " @@ -12824,26 +13059,26 @@ msgid "" msgstr "" # 2f6b201782774df1be2ae638861b3692 -#: ../src/Doc/c-api/typeobj.rst:817 +#: c-api/typeobj.rst:817 msgid "" "For each entry in the array, an entry is added to the type's dictionary " "(see :c:member:`~PyTypeObject.tp_dict` below) containing a getset descriptor." msgstr "" # 9c9c9687536f4c77901eea8f2d2a7a5d -#: ../src/Doc/c-api/typeobj.rst:820 +#: c-api/typeobj.rst:820 msgid "" "This field is not inherited by subtypes (computed attributes are inherited " "through a different mechanism)." msgstr "" # 610b7558500a4da4ae2f9f0b92bcb13c -#: ../src/Doc/c-api/typeobj.rst:825 +#: c-api/typeobj.rst:825 msgid "Docs for PyGetSetDef::" msgstr "" # 052445d84b354679964ee781aede56b3 -#: ../src/Doc/c-api/typeobj.rst:841 +#: c-api/typeobj.rst:841 msgid "" "An optional pointer to a base type from which type properties are " "inherited. At this level, only single inheritance is supported; multiple " @@ -12852,7 +13087,7 @@ msgid "" msgstr "" # 5b12f8a1bfe645b3baeeb2dc5b910d1f -#: ../src/Doc/c-api/typeobj.rst:845 +#: c-api/typeobj.rst:845 msgid "" "This field is not inherited by subtypes (obviously), but it defaults to " "``&PyBaseObject_Type`` (which to Python programmers is known as the type :" @@ -12860,12 +13095,12 @@ msgid "" msgstr "" # 8badb0c6e74b4df6810a848daf90f4d4 -#: ../src/Doc/c-api/typeobj.rst:852 +#: c-api/typeobj.rst:852 msgid "The type's dictionary is stored here by :c:func:`PyType_Ready`." msgstr "" # 60a8a19a408043d3ad11432279defc4b -#: ../src/Doc/c-api/typeobj.rst:854 +#: c-api/typeobj.rst:854 msgid "" "This field should normally be initialized to *NULL* before PyType_Ready is " "called; it may also be initialized to a dictionary containing initial " @@ -12875,14 +13110,14 @@ msgid "" msgstr "" # cd6c00ef55ce4ef1922af41c5d2ff32f -#: ../src/Doc/c-api/typeobj.rst:860 +#: c-api/typeobj.rst:860 msgid "" "This field is not inherited by subtypes (though the attributes defined in " "here are inherited through a different mechanism)." msgstr "" # cdc1bc9ea2fc4f3db6254d840e7ac141 -#: ../src/Doc/c-api/typeobj.rst:866 +#: c-api/typeobj.rst:866 msgid "An optional pointer to a \"descriptor get\" function." msgstr "" @@ -12891,19 +13126,18 @@ msgstr "" # 3eec9c124d114788b8038580bbea3371 # 8a77fd89c80348e2a8f5b74f364ace0b # f4d2e341d8714985b4ddc281f00f1c77 -#: ../src/Doc/c-api/typeobj.rst:868 ../src/Doc/c-api/typeobj.rst:881 -#: ../src/Doc/c-api/typeobj.rst:952 ../src/Doc/c-api/typeobj.rst:977 -#: ../src/Doc/c-api/typeobj.rst:1008 +#: c-api/typeobj.rst:868 c-api/typeobj.rst:881 c-api/typeobj.rst:952 +#: c-api/typeobj.rst:977 c-api/typeobj.rst:1008 msgid "The function signature is ::" msgstr "" # 8aacd667ba7149028aea764a2c23ca7b -#: ../src/Doc/c-api/typeobj.rst:879 +#: c-api/typeobj.rst:879 msgid "An optional pointer to a \"descriptor set\" function." msgstr "" # d496181096b0456a9f10e409cc5e7904 -#: ../src/Doc/c-api/typeobj.rst:892 +#: c-api/typeobj.rst:892 msgid "" "If the instances of this type have a dictionary containing instance " "variables, this field is non-zero and contains the offset in the instances " @@ -12912,14 +13146,14 @@ msgid "" msgstr "" # 5dacb3ea301d4732b59fb76377007023 -#: ../src/Doc/c-api/typeobj.rst:897 +#: c-api/typeobj.rst:897 msgid "" "Do not confuse this field with :c:member:`~PyTypeObject.tp_dict`; that is " "the dictionary for attributes of the type object itself." msgstr "" # 006a8d4013504ade8d5cb6bc13490190 -#: ../src/Doc/c-api/typeobj.rst:900 +#: c-api/typeobj.rst:900 msgid "" "If the value of this field is greater than zero, it specifies the offset " "from the start of the instance structure. If the value is less than zero, " @@ -12936,14 +13170,14 @@ msgid "" msgstr "" # 9832d68943774028af1645dcdf86c3a9 -#: ../src/Doc/c-api/typeobj.rst:912 +#: c-api/typeobj.rst:912 msgid "" "The real dictionary offset in an instance can be computed from a negative :c:" "member:`~PyTypeObject.tp_dictoffset` as follows::" msgstr "" # 2c1f7ce025954a6883e126e91c229c67 -#: ../src/Doc/c-api/typeobj.rst:919 +#: c-api/typeobj.rst:919 msgid "" "where :c:member:`~PyTypeObject.tp_basicsize`, :c:member:`~PyTypeObject." "tp_itemsize` and :c:member:`~PyTypeObject.tp_dictoffset` are taken from the " @@ -12954,7 +13188,7 @@ msgid "" msgstr "" # 3b963fce8f9741a6888d1bc117b0dfa1 -#: ../src/Doc/c-api/typeobj.rst:925 +#: c-api/typeobj.rst:925 msgid "" "This field is inherited by subtypes, but see the rules listed below. A " "subtype may override this offset; this means that the subtype instances " @@ -12964,7 +13198,7 @@ msgid "" msgstr "" # c0ec7b04561d4bada30103c391d8750e -#: ../src/Doc/c-api/typeobj.rst:930 +#: c-api/typeobj.rst:930 msgid "" "When a type defined by a class statement has no :attr:`~object.__slots__` " "declaration, and none of its base types has an instance variable dictionary, " @@ -12973,7 +13207,7 @@ msgid "" msgstr "" # c1db668077d648df9c3eddc994c33038 -#: ../src/Doc/c-api/typeobj.rst:935 +#: c-api/typeobj.rst:935 msgid "" "When a type defined by a class statement has a :attr:`__slots__` " "declaration, the type inherits its :c:member:`~PyTypeObject.tp_dictoffset` " @@ -12981,7 +13215,7 @@ msgid "" msgstr "" # 6c084aca2bb14be285599b898dae2d4e -#: ../src/Doc/c-api/typeobj.rst:938 +#: c-api/typeobj.rst:938 msgid "" "(Adding a slot named :attr:`~object.__dict__` to the :attr:`__slots__` " "declaration does not have the expected effect, it just causes confusion. " @@ -12990,12 +13224,12 @@ msgid "" msgstr "" # 2761425bf2af4ac8aeb75c2cbcfa485f -#: ../src/Doc/c-api/typeobj.rst:945 +#: c-api/typeobj.rst:945 msgid "An optional pointer to an instance initialization function." msgstr "" # f4999a9bd24b46ab98e7ec937baa0dad -#: ../src/Doc/c-api/typeobj.rst:947 +#: c-api/typeobj.rst:947 msgid "" "This function corresponds to the :meth:`__init__` method of classes. Like :" "meth:`__init__`, it is possible to create an instance without calling :meth:" @@ -13004,7 +13238,7 @@ msgid "" msgstr "" # a22181d8a056495b908472546baaa749 -#: ../src/Doc/c-api/typeobj.rst:956 +#: c-api/typeobj.rst:956 msgid "" "The self argument is the instance to be initialized; the *args* and *kwds* " "arguments represent positional and keyword arguments of the call to :meth:" @@ -13012,7 +13246,7 @@ msgid "" msgstr "" # 87e8f18be13845d39ab17f9498c80d5c -#: ../src/Doc/c-api/typeobj.rst:960 +#: c-api/typeobj.rst:960 msgid "" "The :c:member:`~PyTypeObject.tp_init` function, if not *NULL*, is called " "when an instance is created normally by calling its type, after the type's :" @@ -13029,12 +13263,12 @@ msgid "" msgstr "" # 4e6510a97335400db10a55608bbbf5a7 -#: ../src/Doc/c-api/typeobj.rst:975 +#: c-api/typeobj.rst:975 msgid "An optional pointer to an instance allocation function." msgstr "" # be924b4baa1e4bad83348b8b809f4d6e -#: ../src/Doc/c-api/typeobj.rst:981 +#: c-api/typeobj.rst:981 msgid "" "The purpose of this function is to separate memory allocation from memory " "initialization. It should return a pointer to a block of memory of adequate " @@ -13049,7 +13283,7 @@ msgid "" msgstr "" # 476b0e93f24549bfa50dc47594b741a1 -#: ../src/Doc/c-api/typeobj.rst:991 +#: c-api/typeobj.rst:991 msgid "" "Do not use this function to do any other instance initialization, not even " "to allocate additional memory; that should be done by :c:member:" @@ -13057,7 +13291,7 @@ msgid "" msgstr "" # f4ad5ddcdd894f87b446e0406c225500 -#: ../src/Doc/c-api/typeobj.rst:994 +#: c-api/typeobj.rst:994 msgid "" "This field is inherited by static subtypes, but not by dynamic subtypes " "(subtypes created by a class statement); in the latter, this field is always " @@ -13066,12 +13300,12 @@ msgid "" msgstr "" # d0fa7232c3f9400fbae5777ab34d3b6f -#: ../src/Doc/c-api/typeobj.rst:1002 +#: c-api/typeobj.rst:1002 msgid "An optional pointer to an instance creation function." msgstr "" # 016b980237794d77b5a983505c3da395 -#: ../src/Doc/c-api/typeobj.rst:1004 +#: c-api/typeobj.rst:1004 msgid "" "If this function is *NULL* for a particular type, that type cannot be called " "to create new instances; presumably there is some other way to create " @@ -13079,7 +13313,7 @@ msgid "" msgstr "" # 78f55096b4ff4ae1a1e720c4feb54441 -#: ../src/Doc/c-api/typeobj.rst:1012 +#: c-api/typeobj.rst:1012 msgid "" "The subtype argument is the type of the object being created; the *args* and " "*kwds* arguments represent positional and keyword arguments of the call to " @@ -13089,7 +13323,7 @@ msgid "" msgstr "" # b8ac377a43b746b3b91972a85496c9fb -#: ../src/Doc/c-api/typeobj.rst:1018 +#: c-api/typeobj.rst:1018 msgid "" "The :c:member:`~PyTypeObject.tp_new` function should call ``subtype-" ">tp_alloc(subtype, nitems)`` to allocate space for the object, and then do " @@ -13102,7 +13336,7 @@ msgid "" msgstr "" # 7b346010c14a4606b5bf1505208af791 -#: ../src/Doc/c-api/typeobj.rst:1026 +#: c-api/typeobj.rst:1026 msgid "" "This field is inherited by subtypes, except it is not inherited by static " "types whose :c:member:`~PyTypeObject.tp_base` is *NULL* or " @@ -13111,31 +13345,31 @@ msgid "" msgstr "" # 0b797f1b56494800bafd7ac1f0c0e4c3 -#: ../src/Doc/c-api/typeobj.rst:1034 +#: c-api/typeobj.rst:1034 msgid "An optional pointer to an instance deallocation function." msgstr "" # fbae1f1370664d8590eb6df96c52e97e -#: ../src/Doc/c-api/typeobj.rst:1036 +#: c-api/typeobj.rst:1036 msgid "" "The signature of this function has changed slightly: in Python 2.2 and " "2.2.1, its signature is :c:type:`destructor`::" msgstr "" # 6b6023bafe4b44bda8763176017dcdba -#: ../src/Doc/c-api/typeobj.rst:1041 +#: c-api/typeobj.rst:1041 msgid "In Python 2.3 and beyond, its signature is :c:type:`freefunc`::" msgstr "" # 08bc459e1e2546d3ad597b9bb240267d -#: ../src/Doc/c-api/typeobj.rst:1045 +#: c-api/typeobj.rst:1045 msgid "" "The only initializer that is compatible with both versions is " "``_PyObject_Del``, whose definition has suitably adapted in Python 2.3." msgstr "" # a61764c02fcd4d66b67f21c222178ebc -#: ../src/Doc/c-api/typeobj.rst:1048 +#: c-api/typeobj.rst:1048 msgid "" "This field is inherited by static subtypes, but not by dynamic subtypes " "(subtypes created by a class statement); in the latter, this field is set to " @@ -13144,12 +13378,12 @@ msgid "" msgstr "" # 4df3fcb3ff0f47609a6c8ac8e8ff443f -#: ../src/Doc/c-api/typeobj.rst:1056 +#: c-api/typeobj.rst:1056 msgid "An optional pointer to a function called by the garbage collector." msgstr "" # 26f5c86e27d042ee9cbd6c80b411dc77 -#: ../src/Doc/c-api/typeobj.rst:1058 +#: c-api/typeobj.rst:1058 msgid "" "The garbage collector needs to know whether a particular object is " "collectible or not. Normally, it is sufficient to look at the object's " @@ -13162,7 +13396,7 @@ msgid "" msgstr "" # 4e39715a59fe4b74a7fe35a94675ad09 -#: ../src/Doc/c-api/typeobj.rst:1068 +#: c-api/typeobj.rst:1068 msgid "" "(The only example of this are types themselves. The metatype, :c:data:" "`PyType_Type`, defines this function to distinguish between statically and " @@ -13170,62 +13404,62 @@ msgid "" msgstr "" # 9ddba28fa10c4ce497cae5a30bf965d3 -#: ../src/Doc/c-api/typeobj.rst:1072 +#: c-api/typeobj.rst:1072 msgid "" "This field is inherited by subtypes. (VERSION NOTE: in Python 2.2, it was " "not inherited. It is inherited in 2.2.1 and later versions.)" msgstr "" # 0cbe45ca61af4beea3bb6f479fd09976 -#: ../src/Doc/c-api/typeobj.rst:1078 +#: c-api/typeobj.rst:1078 msgid "Tuple of base types." msgstr "" # 4ce487206f544b95a7891180f98adf8d -#: ../src/Doc/c-api/typeobj.rst:1080 +#: c-api/typeobj.rst:1080 msgid "" "This is set for types created by a class statement. It should be *NULL* for " "statically defined types." msgstr "" # 59ead1b7bb95445f99c170ea8e932742 -#: ../src/Doc/c-api/typeobj.rst:1083 +#: c-api/typeobj.rst:1083 msgid "This field is not inherited." msgstr "" # 22cf966af90e469bab21f863b53a37e1 -#: ../src/Doc/c-api/typeobj.rst:1088 +#: c-api/typeobj.rst:1088 msgid "" "Tuple containing the expanded set of base types, starting with the type " "itself and ending with :class:`object`, in Method Resolution Order." msgstr "" # b0424ca7088541bda605bafffec75719 -#: ../src/Doc/c-api/typeobj.rst:1091 +#: c-api/typeobj.rst:1091 msgid "" "This field is not inherited; it is calculated fresh by :c:func:" "`PyType_Ready`." msgstr "" # 540fc036c8964825ad92fae18c6d0a42 -#: ../src/Doc/c-api/typeobj.rst:1096 +#: c-api/typeobj.rst:1096 msgid "Unused. Not inherited. Internal use only." msgstr "" # 3f03d391a3934e3e900400661bc9bf7d -#: ../src/Doc/c-api/typeobj.rst:1101 +#: c-api/typeobj.rst:1101 msgid "" "List of weak references to subclasses. Not inherited. Internal use only." msgstr "" # 038461ba14994bc38750d4dc6749ee49 -#: ../src/Doc/c-api/typeobj.rst:1106 +#: c-api/typeobj.rst:1106 msgid "" "Weak reference list head, for weak references to this type object. Not " "inherited. Internal use only." msgstr "" -#: ../src/Doc/c-api/typeobj.rst:1109 +#: c-api/typeobj.rst:1109 msgid "" "The remaining fields are only defined if the feature test macro :const:" "`COUNT_ALLOCS` is defined, and are for internal use only. They are " @@ -13234,28 +13468,28 @@ msgid "" msgstr "" # 49aa0c7db6484bd695e2cf15bdac896a -#: ../src/Doc/c-api/typeobj.rst:1117 +#: c-api/typeobj.rst:1117 msgid "Number of allocations." msgstr "" -#: ../src/Doc/c-api/typeobj.rst:1122 +#: c-api/typeobj.rst:1122 #, fuzzy msgid "Number of frees." msgstr "Nombres" # d0b9ac20c0024b53a85b78ea356e9335 -#: ../src/Doc/c-api/typeobj.rst:1127 +#: c-api/typeobj.rst:1127 msgid "Maximum simultaneously allocated objects." msgstr "" # 2a9e3210e268460f992738dc5cc0dc22 -#: ../src/Doc/c-api/typeobj.rst:1132 +#: c-api/typeobj.rst:1132 msgid "" "Pointer to the next type object with a non-zero :c:member:`~PyTypeObject." "tp_allocs` field." msgstr "" -#: ../src/Doc/c-api/typeobj.rst:1134 +#: c-api/typeobj.rst:1134 msgid "" "Also, note that, in a garbage collected Python, tp_dealloc may be called " "from any Python thread, not just the thread which created the object (if the " @@ -13268,12 +13502,12 @@ msgid "" "will not violate any assumptions of the library." msgstr "" -#: ../src/Doc/c-api/typeobj.rst:1148 +#: c-api/typeobj.rst:1148 msgid "Number Object Structures" msgstr "" # a6abce5638744ab78ec85dc1bcaa0cfc -#: ../src/Doc/c-api/typeobj.rst:1155 +#: c-api/typeobj.rst:1155 msgid "" "This structure holds pointers to the functions which an object uses to " "implement the number protocol. Almost every function below is used by the " @@ -13281,19 +13515,19 @@ msgid "" msgstr "" # b2a0c41b4e574802b764687d59b965a1 -#: ../src/Doc/c-api/typeobj.rst:1159 +#: c-api/typeobj.rst:1159 msgid "Here is the structure definition::" msgstr "" # 77227e8fbd024bef96dd98d8e936c5b5 -#: ../src/Doc/c-api/typeobj.rst:1210 +#: c-api/typeobj.rst:1210 msgid "" "Binary and ternary functions may receive different kinds of arguments, " "depending on the flag bit :const:`Py_TPFLAGS_CHECKTYPES`:" msgstr "" # 32be086c4eaa455ab5fa60c9409f715a -#: ../src/Doc/c-api/typeobj.rst:1213 +#: c-api/typeobj.rst:1213 msgid "" "If :const:`Py_TPFLAGS_CHECKTYPES` is not set, the function arguments are " "guaranteed to be of the object's type; the caller is responsible for calling " @@ -13302,7 +13536,7 @@ msgid "" msgstr "" # 08b2c11a280a40cc82e0a5fa57526ca4 -#: ../src/Doc/c-api/typeobj.rst:1220 +#: c-api/typeobj.rst:1220 msgid "" "This function is used by :c:func:`PyNumber_CoerceEx` and has the same " "signature. The first argument is always a pointer to an object of the " @@ -13313,7 +13547,7 @@ msgid "" msgstr "" # e345d24adbbb456e8c6e3868c3abd43b -#: ../src/Doc/c-api/typeobj.rst:1227 +#: c-api/typeobj.rst:1227 msgid "" "If the :const:`Py_TPFLAGS_CHECKTYPES` flag is set, binary and ternary " "functions must check the type of all their operands, and implement the " @@ -13323,26 +13557,26 @@ msgid "" msgstr "" # 04b7b75fe56748d2a7cac93820e3762a -#: ../src/Doc/c-api/typeobj.rst:1233 +#: c-api/typeobj.rst:1233 msgid "" "If the operation is not defined for the given operands, binary and ternary " "functions must return ``Py_NotImplemented``, if another error occurred they " "must return ``NULL`` and set an exception." msgstr "" -#: ../src/Doc/c-api/typeobj.rst:1241 +#: c-api/typeobj.rst:1241 msgid "Mapping Object Structures" msgstr "" # cd4d2aaecfcb421cb977b132639e97e6 -#: ../src/Doc/c-api/typeobj.rst:1248 +#: c-api/typeobj.rst:1248 msgid "" "This structure holds pointers to the functions which an object uses to " "implement the mapping protocol. It has three members:" msgstr "" # 15a5f7abc844431c8e0d8a7a0ebac4cc -#: ../src/Doc/c-api/typeobj.rst:1253 +#: c-api/typeobj.rst:1253 msgid "" "This function is used by :c:func:`PyMapping_Length` and :c:func:" "`PyObject_Size`, and has the same signature. This slot may be set to *NULL* " @@ -13350,7 +13584,7 @@ msgid "" msgstr "" # d0641356772243afa0748d42d3419b0f -#: ../src/Doc/c-api/typeobj.rst:1259 +#: c-api/typeobj.rst:1259 msgid "" "This function is used by :c:func:`PyObject_GetItem` and has the same " "signature. This slot must be filled for the :c:func:`PyMapping_Check` " @@ -13358,33 +13592,33 @@ msgid "" msgstr "" # 58fe9d72fb0948f39ac7519bead414b3 -#: ../src/Doc/c-api/typeobj.rst:1265 +#: c-api/typeobj.rst:1265 msgid "" "This function is used by :c:func:`PyObject_SetItem` and has the same " "signature. If this slot is *NULL*, the object does not support item " "assignment." msgstr "" -#: ../src/Doc/c-api/typeobj.rst:1273 +#: c-api/typeobj.rst:1273 msgid "Sequence Object Structures" msgstr "" # 82be5849b8464b3e8eeceb51017e4820 -#: ../src/Doc/c-api/typeobj.rst:1280 +#: c-api/typeobj.rst:1280 msgid "" "This structure holds pointers to the functions which an object uses to " "implement the sequence protocol." msgstr "" # 354f9128501b4bf2835ed290f229068d -#: ../src/Doc/c-api/typeobj.rst:1285 +#: c-api/typeobj.rst:1285 msgid "" "This function is used by :c:func:`PySequence_Size` and :c:func:" "`PyObject_Size`, and has the same signature." msgstr "" # 10cdd99f08b240c7ac49852037b492c6 -#: ../src/Doc/c-api/typeobj.rst:1290 +#: c-api/typeobj.rst:1290 msgid "" "This function is used by :c:func:`PySequence_Concat` and has the same " "signature. It is also used by the ``+`` operator, after trying the numeric " @@ -13392,7 +13626,7 @@ msgid "" msgstr "" # fd8b060d5df34c47a4a97acf759c7f6d -#: ../src/Doc/c-api/typeobj.rst:1296 +#: c-api/typeobj.rst:1296 msgid "" "This function is used by :c:func:`PySequence_Repeat` and has the same " "signature. It is also used by the ``*`` operator, after trying numeric " @@ -13401,7 +13635,7 @@ msgid "" msgstr "" # d006104ebadb47b89bb930aca716c43e -#: ../src/Doc/c-api/typeobj.rst:1303 +#: c-api/typeobj.rst:1303 msgid "" "This function is used by :c:func:`PySequence_GetItem` and has the same " "signature. This slot must be filled for the :c:func:`PySequence_Check` " @@ -13409,7 +13643,7 @@ msgid "" msgstr "" # 60a2dd7b2f764e4b98c1a152bd240de8 -#: ../src/Doc/c-api/typeobj.rst:1307 +#: c-api/typeobj.rst:1307 msgid "" "Negative indexes are handled as follows: if the :attr:`sq_length` slot is " "filled, it is called and the sequence length is used to compute a positive " @@ -13418,7 +13652,7 @@ msgid "" msgstr "" # 479b2f978f484c5bac2f1c796a7d07cd -#: ../src/Doc/c-api/typeobj.rst:1314 +#: c-api/typeobj.rst:1314 msgid "" "This function is used by :c:func:`PySequence_SetItem` and has the same " "signature. This slot may be left to *NULL* if the object does not support " @@ -13426,7 +13660,7 @@ msgid "" msgstr "" # b735c44dc3bb4d979788aa8a8b7d8eff -#: ../src/Doc/c-api/typeobj.rst:1320 +#: c-api/typeobj.rst:1320 msgid "" "This function may be used by :c:func:`PySequence_Contains` and has the same " "signature. This slot may be left to *NULL*, in this case :c:func:" @@ -13434,25 +13668,25 @@ msgid "" msgstr "" # e3ae6b1436cf4672a247ea6102d4f052 -#: ../src/Doc/c-api/typeobj.rst:1327 +#: c-api/typeobj.rst:1327 msgid "" "This function is used by :c:func:`PySequence_InPlaceConcat` and has the same " "signature. It should modify its first operand, and return it." msgstr "" # b9263946d151403a98dbc88b3226198d -#: ../src/Doc/c-api/typeobj.rst:1332 +#: c-api/typeobj.rst:1332 msgid "" "This function is used by :c:func:`PySequence_InPlaceRepeat` and has the same " "signature. It should modify its first operand, and return it." msgstr "" -#: ../src/Doc/c-api/typeobj.rst:1342 +#: c-api/typeobj.rst:1342 msgid "Buffer Object Structures" msgstr "" # 018c6a81a0b64e1cacf56dfcb450d764 -#: ../src/Doc/c-api/typeobj.rst:1347 +#: c-api/typeobj.rst:1347 msgid "" "The buffer interface exports a model where an object can expose its internal " "data as a set of chunks of data, where each chunk is specified as a pointer/" @@ -13461,7 +13695,7 @@ msgid "" msgstr "" # d38acbfb91a4439c9afb4d1c429ad6a7 -#: ../src/Doc/c-api/typeobj.rst:1352 +#: c-api/typeobj.rst:1352 msgid "" "If an object does not export the buffer interface, then its :c:member:" "`~PyTypeObject.tp_as_buffer` member in the :c:type:`PyTypeObject` structure " @@ -13470,7 +13704,7 @@ msgid "" msgstr "" # 4a7a955088294682af36fafeaf902457 -#: ../src/Doc/c-api/typeobj.rst:1358 +#: c-api/typeobj.rst:1358 msgid "" "It is very important that your :c:type:`PyTypeObject` structure uses :const:" "`Py_TPFLAGS_DEFAULT` for the value of the :c:member:`~PyTypeObject.tp_flags` " @@ -13482,14 +13716,14 @@ msgid "" msgstr "" # 671ce8453a204c60abe634933c17f1ab -#: ../src/Doc/c-api/typeobj.rst:1368 +#: c-api/typeobj.rst:1368 msgid "" "Structure used to hold the function pointers which define an implementation " "of the buffer protocol." msgstr "" # 6255e02c907e4011bada70cdea40b1c1 -#: ../src/Doc/c-api/typeobj.rst:1371 +#: c-api/typeobj.rst:1371 msgid "" "The first slot is :attr:`bf_getreadbuffer`, of type :c:type:" "`getreadbufferproc`. If this slot is *NULL*, then the object does not " @@ -13499,7 +13733,7 @@ msgid "" msgstr "" # 77ed07828db14e608f59fac4ee8eb180 -#: ../src/Doc/c-api/typeobj.rst:1376 +#: c-api/typeobj.rst:1376 msgid "" "The next slot is :attr:`bf_getwritebuffer` having type :c:type:" "`getwritebufferproc`. This slot may be *NULL* if the object does not allow " @@ -13507,7 +13741,7 @@ msgid "" msgstr "" # 2b1d079f5e024e40b8a8b8a6ab444bcd -#: ../src/Doc/c-api/typeobj.rst:1380 +#: c-api/typeobj.rst:1380 msgid "" "The third slot is :attr:`bf_getsegcount`, with type :c:type:" "`getsegcountproc`. This slot must not be *NULL* and is used to inform the " @@ -13517,7 +13751,7 @@ msgid "" msgstr "" # 8794eca3e0064cf7ae81e22176c471f8 -#: ../src/Doc/c-api/typeobj.rst:1387 +#: c-api/typeobj.rst:1387 msgid "" "The last slot is :attr:`bf_getcharbuffer`, of type :c:type:" "`getcharbufferproc`. This slot will only be present if the :const:" @@ -13537,7 +13771,7 @@ msgid "" msgstr "" # 4907e90a96384b3994474fff78dbc2c9 -#: ../src/Doc/c-api/typeobj.rst:1403 +#: c-api/typeobj.rst:1403 msgid "" "The current policy seems to state that these characters may be multi-byte " "characters. This implies that a buffer size of *N* does not mean there are " @@ -13545,7 +13779,7 @@ msgid "" msgstr "" # 9d058a1e83144869a868f7abd46ec1e6 -#: ../src/Doc/c-api/typeobj.rst:1410 +#: c-api/typeobj.rst:1410 msgid "" "Flag bit set in the type structure to indicate that the :attr:" "`bf_getcharbuffer` slot is known. This being set does not indicate that the " @@ -13554,7 +13788,7 @@ msgid "" msgstr "" # 4d760c4c58184b4e8e44e5292908bc44 -#: ../src/Doc/c-api/typeobj.rst:1417 +#: c-api/typeobj.rst:1417 msgid "" "Return a pointer to a readable segment of the buffer in ``*ptrptr``. This " "function is allowed to raise an exception, in which case it must return " @@ -13565,7 +13799,7 @@ msgid "" msgstr "" # 55402f93a81d4562b692916f49616255 -#: ../src/Doc/c-api/typeobj.rst:1427 +#: c-api/typeobj.rst:1427 msgid "" "Return a pointer to a writable memory buffer in ``*ptrptr``, and the length " "of that segment as the function return value. The memory buffer must " @@ -13576,7 +13810,7 @@ msgid "" msgstr "" # 67e94400d9954cf8af568088001d5f83 -#: ../src/Doc/c-api/typeobj.rst:1441 +#: c-api/typeobj.rst:1441 msgid "" "Return the number of memory segments which comprise the buffer. If *lenp* " "is not *NULL*, the implementation must report the sum of the sizes (in " @@ -13584,32 +13818,32 @@ msgid "" msgstr "" # c5bdd37aeb9d48cc9bee21477d2ae458 -#: ../src/Doc/c-api/typeobj.rst:1448 +#: c-api/typeobj.rst:1448 msgid "" "Return the size of the segment *segment* that *ptrptr* is set to. " "``*ptrptr`` is set to the memory buffer. Returns ``-1`` on error." msgstr "" -#: ../src/Doc/c-api/unicode.rst:6 +#: c-api/unicode.rst:6 msgid "Unicode Objects and Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:11 +#: c-api/unicode.rst:11 msgid "Unicode Objects" msgstr "" -#: ../src/Doc/c-api/unicode.rst:15 +#: c-api/unicode.rst:15 msgid "Unicode Type" msgstr "" -#: ../src/Doc/c-api/unicode.rst:17 +#: c-api/unicode.rst:17 msgid "" "These are the basic Unicode object types used for the Unicode implementation " "in Python:" msgstr "" # 3fca9a5ed85d4d60b535351e1728f058 -#: ../src/Doc/c-api/unicode.rst:23 +#: c-api/unicode.rst:23 msgid "" "This type represents the storage type which is used by Python internally as " "basis for holding Unicode ordinals. Python's default builds use a 16-bit " @@ -13624,77 +13858,77 @@ msgid "" "`unsigned short` (UCS2) or :c:type:`unsigned long` (UCS4)." msgstr "" -#: ../src/Doc/c-api/unicode.rst:35 +#: c-api/unicode.rst:35 msgid "" "Note that UCS2 and UCS4 Python builds are not binary compatible. Please keep " "this in mind when writing extensions or interfaces." msgstr "" # 1f89395cefa34536abc2f2612136a10d -#: ../src/Doc/c-api/unicode.rst:41 +#: c-api/unicode.rst:41 msgid "This subtype of :c:type:`PyObject` represents a Python Unicode object." msgstr "" # d1e72628c7af4373a399fc7918a029a4 -#: ../src/Doc/c-api/unicode.rst:46 +#: c-api/unicode.rst:46 msgid "" "This instance of :c:type:`PyTypeObject` represents the Python Unicode type. " "It is exposed to Python code as ``unicode`` and ``types.UnicodeType``." msgstr "" -#: ../src/Doc/c-api/unicode.rst:49 +#: c-api/unicode.rst:49 msgid "" "The following APIs are really C macros and can be used to do fast checks and " "to access internal read-only data of Unicode objects:" msgstr "" # b6b7663b1ebf470191d37cdec59ae733 -#: ../src/Doc/c-api/unicode.rst:55 +#: c-api/unicode.rst:55 msgid "" "Return true if the object *o* is a Unicode object or an instance of a " "Unicode subtype." msgstr "" # cfd334a67c014f8f8c733f22287e86b6 -#: ../src/Doc/c-api/unicode.rst:64 +#: c-api/unicode.rst:64 msgid "" "Return true if the object *o* is a Unicode object, but not an instance of a " "subtype." msgstr "" # de1b1a1867234cbdbfdd852206282feb -#: ../src/Doc/c-api/unicode.rst:72 +#: c-api/unicode.rst:72 msgid "" "Return the size of the object. *o* has to be a :c:type:`PyUnicodeObject` " "(not checked)." msgstr "" # d83f0c37c78c4b66b3ad298828508169 -#: ../src/Doc/c-api/unicode.rst:82 +#: c-api/unicode.rst:82 msgid "" "Return the size of the object's internal buffer in bytes. *o* has to be a :" "c:type:`PyUnicodeObject` (not checked)." msgstr "" # d1083ef70a564e32ac432404e68c9512 -#: ../src/Doc/c-api/unicode.rst:92 +#: c-api/unicode.rst:92 msgid "" "Return a pointer to the internal :c:type:`Py_UNICODE` buffer of the object. " "*o* has to be a :c:type:`PyUnicodeObject` (not checked)." msgstr "" # be6c198522b248c0ae82933a28fa150d -#: ../src/Doc/c-api/unicode.rst:98 +#: c-api/unicode.rst:98 msgid "" "Return a pointer to the internal buffer of the object. *o* has to be a :c:" "type:`PyUnicodeObject` (not checked)." msgstr "" -#: ../src/Doc/c-api/unicode.rst:110 +#: c-api/unicode.rst:110 msgid "Unicode Character Properties" msgstr "" -#: ../src/Doc/c-api/unicode.rst:112 +#: c-api/unicode.rst:112 msgid "" "Unicode provides many different character properties. The most often needed " "ones are available through these macros which are mapped to C functions " @@ -13702,107 +13936,107 @@ msgid "" msgstr "" # 9fa491147ddb45ec8cfb6fe3827cca21 -#: ../src/Doc/c-api/unicode.rst:119 +#: c-api/unicode.rst:119 msgid "Return 1 or 0 depending on whether *ch* is a whitespace character." msgstr "" # eae642fd03404d17ac118cfeb9eb369f -#: ../src/Doc/c-api/unicode.rst:124 +#: c-api/unicode.rst:124 msgid "Return 1 or 0 depending on whether *ch* is a lowercase character." msgstr "" # f87df29960d7459eb1b47c1cbb40044e -#: ../src/Doc/c-api/unicode.rst:129 +#: c-api/unicode.rst:129 msgid "Return 1 or 0 depending on whether *ch* is an uppercase character." msgstr "" # 050e311c22d244dfbed563a7f0c9fec6 -#: ../src/Doc/c-api/unicode.rst:134 +#: c-api/unicode.rst:134 msgid "Return 1 or 0 depending on whether *ch* is a titlecase character." msgstr "" # d23af76585314407983f80c2d4bcdd08 -#: ../src/Doc/c-api/unicode.rst:139 +#: c-api/unicode.rst:139 msgid "Return 1 or 0 depending on whether *ch* is a linebreak character." msgstr "" # e4eb897aa1be4629b6318cbe3b15ef71 -#: ../src/Doc/c-api/unicode.rst:144 +#: c-api/unicode.rst:144 msgid "Return 1 or 0 depending on whether *ch* is a decimal character." msgstr "" # 35775eeac9e64fd98c72c7c0ad36b0d6 -#: ../src/Doc/c-api/unicode.rst:149 +#: c-api/unicode.rst:149 msgid "Return 1 or 0 depending on whether *ch* is a digit character." msgstr "" # 86cbeb725aee4a5492eada54210b49f5 -#: ../src/Doc/c-api/unicode.rst:154 +#: c-api/unicode.rst:154 msgid "Return 1 or 0 depending on whether *ch* is a numeric character." msgstr "" # f710e599cfc34ba3b1c30134f86a2c4f -#: ../src/Doc/c-api/unicode.rst:159 +#: c-api/unicode.rst:159 msgid "Return 1 or 0 depending on whether *ch* is an alphabetic character." msgstr "" # 3439f86cf17b490390dac4f681e3b628 -#: ../src/Doc/c-api/unicode.rst:164 +#: c-api/unicode.rst:164 msgid "Return 1 or 0 depending on whether *ch* is an alphanumeric character." msgstr "" -#: ../src/Doc/c-api/unicode.rst:166 +#: c-api/unicode.rst:166 msgid "These APIs can be used for fast direct character conversions:" msgstr "" # 9495e04a7fb84a96878f15a9f747289d -#: ../src/Doc/c-api/unicode.rst:171 +#: c-api/unicode.rst:171 msgid "Return the character *ch* converted to lower case." msgstr "" # c43aeefddee44c46a5bf8e14793b3a98 -#: ../src/Doc/c-api/unicode.rst:176 +#: c-api/unicode.rst:176 msgid "Return the character *ch* converted to upper case." msgstr "" # a0350c936649458484e54ed0d4f005ac -#: ../src/Doc/c-api/unicode.rst:181 +#: c-api/unicode.rst:181 msgid "Return the character *ch* converted to title case." msgstr "" # 14fb419ad8ce40eab4b0a8201f0db35c -#: ../src/Doc/c-api/unicode.rst:186 +#: c-api/unicode.rst:186 msgid "" "Return the character *ch* converted to a decimal positive integer. Return " "``-1`` if this is not possible. This macro does not raise exceptions." msgstr "" # 2f88eabae6af4c7cbb6e1d29cf53f16e -#: ../src/Doc/c-api/unicode.rst:192 +#: c-api/unicode.rst:192 msgid "" "Return the character *ch* converted to a single digit integer. Return ``-1`` " "if this is not possible. This macro does not raise exceptions." msgstr "" # ad6b1ccb82714bd790ae060181fd0fef -#: ../src/Doc/c-api/unicode.rst:198 +#: c-api/unicode.rst:198 msgid "" "Return the character *ch* converted to a double. Return ``-1.0`` if this is " "not possible. This macro does not raise exceptions." msgstr "" -#: ../src/Doc/c-api/unicode.rst:203 +#: c-api/unicode.rst:203 msgid "Plain Py_UNICODE" msgstr "" -#: ../src/Doc/c-api/unicode.rst:205 +#: c-api/unicode.rst:205 msgid "" "To create Unicode objects and access their basic sequence properties, use " "these APIs:" msgstr "" # 5eaff14365494c479384c54e75387c63 -#: ../src/Doc/c-api/unicode.rst:211 +#: c-api/unicode.rst:211 msgid "" "Create a Unicode object from the Py_UNICODE buffer *u* of the given size. " "*u* may be *NULL* which causes the contents to be undefined. It is the " @@ -13813,7 +14047,7 @@ msgid "" msgstr "" # 2aca839ffc004e31bc57a4b90ee9f7d2 -#: ../src/Doc/c-api/unicode.rst:225 +#: c-api/unicode.rst:225 msgid "" "Create a Unicode object from the char buffer *u*. The bytes will be " "interpreted as being UTF-8 encoded. *u* may also be *NULL* which causes the " @@ -13824,14 +14058,14 @@ msgid "" msgstr "" # 80ecd6dc859645f59e54aa8b9a472668 -#: ../src/Doc/c-api/unicode.rst:237 +#: c-api/unicode.rst:237 msgid "" "Create a Unicode object from an UTF-8 encoded null-terminated char buffer " "*u*." msgstr "" # b1c2c885183e4bfda35e617a48f34460 -#: ../src/Doc/c-api/unicode.rst:245 +#: c-api/unicode.rst:245 msgid "" "Take a C :c:func:`printf`\\ -style *format* string and a variable number of " "arguments, calculate the size of the resulting Python unicode string and " @@ -13841,33 +14075,32 @@ msgid "" msgstr "" # 50d78f0c978446fe893d5f96828ffd31 -#: ../src/Doc/c-api/unicode.rst:300 +#: c-api/unicode.rst:300 msgid ":attr:`%U`" msgstr "" -#: ../src/Doc/c-api/unicode.rst:300 ../src/Doc/c-api/unicode.rst:309 -#: ../src/Doc/c-api/unicode.rst:312 +#: c-api/unicode.rst:300 c-api/unicode.rst:309 c-api/unicode.rst:312 #, fuzzy msgid "PyObject\\*" msgstr "Objets bytes" -#: ../src/Doc/c-api/unicode.rst:300 +#: c-api/unicode.rst:300 #, fuzzy msgid "A unicode object." msgstr "Objets Code" # ffa02639265b41dea6ccd071c43e539c -#: ../src/Doc/c-api/unicode.rst:302 +#: c-api/unicode.rst:302 msgid ":attr:`%V`" msgstr "" # 028a1fc9f106449d8fa02c4f99806b8c -#: ../src/Doc/c-api/unicode.rst:302 +#: c-api/unicode.rst:302 msgid "PyObject\\*, char \\*" msgstr "" # e6795526b7e443289ad25c03cf0caeef -#: ../src/Doc/c-api/unicode.rst:302 +#: c-api/unicode.rst:302 msgid "" "A unicode object (which may be *NULL*) and a null-terminated C character " "array as a second parameter (which will be used, if the first parameter is " @@ -13875,34 +14108,34 @@ msgid "" msgstr "" # bf8001a6a4cf452b82d5d3ec3b8ffee5 -#: ../src/Doc/c-api/unicode.rst:309 +#: c-api/unicode.rst:309 msgid ":attr:`%S`" msgstr "" # 125ab6f943b0425791624b1fd8a8f4ef -#: ../src/Doc/c-api/unicode.rst:309 +#: c-api/unicode.rst:309 msgid "The result of calling :func:`PyObject_Unicode`." msgstr "" # 6a2fdbba877949b9ad6f5886ecf3fcf7 -#: ../src/Doc/c-api/unicode.rst:312 +#: c-api/unicode.rst:312 msgid ":attr:`%R`" msgstr "" # d643da66f5a64188a5cba92ff2aa4778 -#: ../src/Doc/c-api/unicode.rst:312 +#: c-api/unicode.rst:312 msgid "The result of calling :func:`PyObject_Repr`." msgstr "" # ec0bc51aed8e4872b0934ed422073c91 -#: ../src/Doc/c-api/unicode.rst:324 +#: c-api/unicode.rst:324 msgid "" "Identical to :func:`PyUnicode_FromFormat` except that it takes exactly two " "arguments." msgstr "" # 3c6037d4c68b442ebb685fdfbd3f8b23 -#: ../src/Doc/c-api/unicode.rst:332 +#: c-api/unicode.rst:332 msgid "" "Return a read-only pointer to the Unicode object's internal :c:type:" "`Py_UNICODE` buffer, *NULL* if *unicode* is not a Unicode object. Note that " @@ -13912,19 +14145,19 @@ msgid "" msgstr "" # 22935ae9d25a4eb6bb68c94e42ca29dd -#: ../src/Doc/c-api/unicode.rst:341 +#: c-api/unicode.rst:341 msgid "Return the length of the Unicode object." msgstr "" # 246b9362764d48538b630ac2d7be353f -#: ../src/Doc/c-api/unicode.rst:350 +#: c-api/unicode.rst:350 msgid "" "Coerce an encoded object *obj* to an Unicode object and return a reference " "with incremented refcount." msgstr "" # 4eb07736b2064e1aaebb331eb48d809d -#: ../src/Doc/c-api/unicode.rst:353 +#: c-api/unicode.rst:353 msgid "" "String and other char buffer compatible objects are decoded according to the " "given encoding and using the error handling defined by errors. Both can be " @@ -13933,28 +14166,28 @@ msgid "" msgstr "" # 33063a7107684b11bf156968f6dfa726 -#: ../src/Doc/c-api/unicode.rst:358 +#: c-api/unicode.rst:358 msgid "" "All other objects, including Unicode objects, cause a :exc:`TypeError` to be " "set." msgstr "" # c1c8bac4e2dc4aaeb194f35eec7780de -#: ../src/Doc/c-api/unicode.rst:361 +#: c-api/unicode.rst:361 msgid "" "The API returns *NULL* if there was an error. The caller is responsible for " "decref'ing the returned objects." msgstr "" # 3f4b17c9acaa41e08a154c4069b602e2 -#: ../src/Doc/c-api/unicode.rst:367 +#: c-api/unicode.rst:367 msgid "" "Shortcut for ``PyUnicode_FromEncodedObject(obj, NULL, \"strict\")`` which is " "used throughout the interpreter whenever coercion to Unicode is needed." msgstr "" # ea34aa17d1ec4dffae6e7f215788ce95 -#: ../src/Doc/c-api/unicode.rst:370 +#: c-api/unicode.rst:370 msgid "" "If the platform supports :c:type:`wchar_t` and provides a header file wchar." "h, Python can interface directly to this type using the following functions. " @@ -13962,24 +14195,24 @@ msgid "" "to the system's :c:type:`wchar_t`." msgstr "" -#: ../src/Doc/c-api/unicode.rst:377 +#: c-api/unicode.rst:377 msgid "wchar_t Support" msgstr "" # aee882bafdcb47a498fcd460a924299d -#: ../src/Doc/c-api/unicode.rst:379 +#: c-api/unicode.rst:379 msgid ":c:type:`wchar_t` support for platforms which support it:" msgstr "" # 063fdc2cdf3841a08c4cc1d799666c42 -#: ../src/Doc/c-api/unicode.rst:383 +#: c-api/unicode.rst:383 msgid "" "Create a Unicode object from the :c:type:`wchar_t` buffer *w* of the given " "*size*. Return *NULL* on failure." msgstr "" # 5b777f25979549198602a39e39b4f803 -#: ../src/Doc/c-api/unicode.rst:393 +#: c-api/unicode.rst:393 msgid "" "Copy the Unicode object contents into the :c:type:`wchar_t` buffer *w*. At " "most *size* :c:type:`wchar_t` characters are copied (excluding a possibly " @@ -13992,18 +14225,25 @@ msgid "" "cause the string to be truncated when used with most C functions." msgstr "" -#: ../src/Doc/c-api/unicode.rst:412 +#: c-api/unicode.rst:403 +msgid "" +"This function returned an :c:type:`int` type and used an :c:type:`int` type " +"for *size*. This might require changes in your code for properly supporting " +"64-bit systems." +msgstr "" + +#: c-api/unicode.rst:412 msgid "Built-in Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:414 +#: c-api/unicode.rst:414 msgid "" "Python provides a set of built-in codecs which are written in C for speed. " "All of these codecs are directly usable via the following functions." msgstr "" # 38523877927647d8888699db0fbeb3a1 -#: ../src/Doc/c-api/unicode.rst:417 +#: c-api/unicode.rst:417 msgid "" "Many of the following APIs take two arguments encoding and errors, and they " "have the same semantics as the ones of the built-in :func:`unicode` Unicode " @@ -14011,7 +14251,7 @@ msgid "" msgstr "" # 93cbcd53e957424da36d9aadd9b43596 -#: ../src/Doc/c-api/unicode.rst:421 +#: c-api/unicode.rst:421 msgid "" "Setting encoding to *NULL* causes the default encoding to be used which is " "ASCII. The file system calls should use :c:data:" @@ -14021,29 +14261,29 @@ msgid "" "application invokes setlocale)." msgstr "" -#: ../src/Doc/c-api/unicode.rst:427 +#: c-api/unicode.rst:427 msgid "" "Error handling is set by errors which may also be set to *NULL* meaning to " "use the default handling defined for the codec. Default error handling for " "all built-in codecs is \"strict\" (:exc:`ValueError` is raised)." msgstr "" -#: ../src/Doc/c-api/unicode.rst:431 +#: c-api/unicode.rst:431 msgid "" "The codecs all use a similar interface. Only deviation from the following " "generic ones are documented for simplicity." msgstr "" -#: ../src/Doc/c-api/unicode.rst:436 +#: c-api/unicode.rst:436 msgid "Generic Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:438 +#: c-api/unicode.rst:438 msgid "These are the generic codec APIs:" msgstr "" # f12dc33957df42a6836e840d8ef2cec5 -#: ../src/Doc/c-api/unicode.rst:443 +#: c-api/unicode.rst:443 msgid "" "Create a Unicode object by decoding *size* bytes of the encoded string *s*. " "*encoding* and *errors* have the same meaning as the parameters of the same " @@ -14053,7 +14293,7 @@ msgid "" msgstr "" # c0703b08a9cd4d60a07f1028f4ac3c63 -#: ../src/Doc/c-api/unicode.rst:456 +#: c-api/unicode.rst:456 msgid "" "Encode the :c:type:`Py_UNICODE` buffer *s* of the given *size* and return a " "Python string object. *encoding* and *errors* have the same meaning as the " @@ -14063,7 +14303,7 @@ msgid "" msgstr "" # 9910721668434016bbd6ae863dcae1f1 -#: ../src/Doc/c-api/unicode.rst:469 +#: c-api/unicode.rst:469 msgid "" "Encode a Unicode object and return the result as Python string object. " "*encoding* and *errors* have the same meaning as the parameters of the same " @@ -14072,23 +14312,23 @@ msgid "" "the codec." msgstr "" -#: ../src/Doc/c-api/unicode.rst:477 +#: c-api/unicode.rst:477 msgid "UTF-8 Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:479 +#: c-api/unicode.rst:479 msgid "These are the UTF-8 codec APIs:" msgstr "" # 132bec767fbc40c1b69c82e23e760d2e -#: ../src/Doc/c-api/unicode.rst:484 +#: c-api/unicode.rst:484 msgid "" "Create a Unicode object by decoding *size* bytes of the UTF-8 encoded string " "*s*. Return *NULL* if an exception was raised by the codec." msgstr "" # 12787468d62d45ce9f973240381acb64 -#: ../src/Doc/c-api/unicode.rst:494 +#: c-api/unicode.rst:494 msgid "" "If *consumed* is *NULL*, behave like :c:func:`PyUnicode_DecodeUTF8`. If " "*consumed* is not *NULL*, trailing incomplete UTF-8 byte sequences will not " @@ -14097,7 +14337,7 @@ msgid "" msgstr "" # dbb6662d78cd4290b38d7b3b42ca4082 -#: ../src/Doc/c-api/unicode.rst:508 +#: c-api/unicode.rst:508 msgid "" "Encode the :c:type:`Py_UNICODE` buffer *s* of the given *size* using UTF-8 " "and return a Python string object. Return *NULL* if an exception was raised " @@ -14105,23 +14345,23 @@ msgid "" msgstr "" # e170c0faaeb64c1187163955c7272e40 -#: ../src/Doc/c-api/unicode.rst:518 +#: c-api/unicode.rst:518 msgid "" "Encode a Unicode object using UTF-8 and return the result as Python string " "object. Error handling is \"strict\". Return *NULL* if an exception was " "raised by the codec." msgstr "" -#: ../src/Doc/c-api/unicode.rst:524 +#: c-api/unicode.rst:524 msgid "UTF-32 Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:526 +#: c-api/unicode.rst:526 msgid "These are the UTF-32 codec APIs:" msgstr "" # f5b4763546854e13b08bdf6a589adf7e -#: ../src/Doc/c-api/unicode.rst:531 +#: c-api/unicode.rst:531 msgid "" "Decode *size* bytes from a UTF-32 encoded buffer string and return the " "corresponding Unicode object. *errors* (if non-*NULL*) defines the error " @@ -14130,14 +14370,14 @@ msgstr "" # cdfe6223fb34499085d96e172ff8dcdd # 7fa1ede9533f4351a1c60530f7c62bd0 -#: ../src/Doc/c-api/unicode.rst:535 ../src/Doc/c-api/unicode.rst:611 +#: c-api/unicode.rst:535 c-api/unicode.rst:611 msgid "" "If *byteorder* is non-*NULL*, the decoder starts decoding using the given " "byte order::" msgstr "" # 19b92829ef3c4e57ae23fd0c11c409bc -#: ../src/Doc/c-api/unicode.rst:542 +#: c-api/unicode.rst:542 msgid "" "If ``*byteorder`` is zero, and the first four bytes of the input data are a " "byte order mark (BOM), the decoder switches to this byte order and the BOM " @@ -14147,22 +14387,21 @@ msgstr "" # 78352cfd60324934b525bd7a8699b903 # 0f4ea9a1726c4e499ff783530ccb3953 -#: ../src/Doc/c-api/unicode.rst:547 ../src/Doc/c-api/unicode.rst:624 +#: c-api/unicode.rst:547 c-api/unicode.rst:624 msgid "" "After completion, *\\*byteorder* is set to the current byte order at the end " "of input data." msgstr "" -# 738bad32545342f7b00532dd77ccc834 -#: ../src/Doc/c-api/unicode.rst:550 +#: c-api/unicode.rst:550 msgid "" -"In a narrow build codepoints outside the BMP will be decoded as surrogate " +"In a narrow build code points outside the BMP will be decoded as surrogate " "pairs." msgstr "" # c73d2a5882ff4b50b8151fd43bd06dd0 # 800d224dc1a24eedadef09a55bfa0c28 -#: ../src/Doc/c-api/unicode.rst:552 ../src/Doc/c-api/unicode.rst:627 +#: c-api/unicode.rst:552 c-api/unicode.rst:627 msgid "If *byteorder* is *NULL*, the codec starts in native order mode." msgstr "" @@ -14170,13 +14409,13 @@ msgstr "" # 4143117fc3964ad3b5b9fd3e469bedd7 # 91b0ce47ab724913a9a2c71cb0207db3 # db21e9b031974a289639cd8f97bda8f8 -#: ../src/Doc/c-api/unicode.rst:554 ../src/Doc/c-api/unicode.rst:585 -#: ../src/Doc/c-api/unicode.rst:629 ../src/Doc/c-api/unicode.rst:668 +#: c-api/unicode.rst:554 c-api/unicode.rst:585 c-api/unicode.rst:629 +#: c-api/unicode.rst:668 msgid "Return *NULL* if an exception was raised by the codec." msgstr "" # 361419dc4c5e45b0ae21b1e3f4506dc2 -#: ../src/Doc/c-api/unicode.rst:561 +#: c-api/unicode.rst:561 msgid "" "If *consumed* is *NULL*, behave like :c:func:`PyUnicode_DecodeUTF32`. If " "*consumed* is not *NULL*, :c:func:`PyUnicode_DecodeUTF32Stateful` will not " @@ -14186,7 +14425,7 @@ msgid "" msgstr "" # 39314fbbe20144fc94b43935e64b5839 -#: ../src/Doc/c-api/unicode.rst:572 +#: c-api/unicode.rst:572 msgid "" "Return a Python bytes object holding the UTF-32 encoded value of the Unicode " "data in *s*. Output is written according to the following byte order::" @@ -14194,37 +14433,36 @@ msgstr "" # 5c14f858fb88452cb63a3db19ca0cb90 # 684e708fac694f268cbbe795f51b55d0 -#: ../src/Doc/c-api/unicode.rst:579 ../src/Doc/c-api/unicode.rst:661 +#: c-api/unicode.rst:579 c-api/unicode.rst:661 msgid "" "If byteorder is ``0``, the output string will always start with the Unicode " "BOM mark (U+FEFF). In the other two modes, no BOM mark is prepended." msgstr "" -# a6c651bc02fb4a89b26aaca0ec980142 -#: ../src/Doc/c-api/unicode.rst:582 +#: c-api/unicode.rst:582 msgid "" "If *Py_UNICODE_WIDE* is not defined, surrogate pairs will be output as a " -"single codepoint." +"single code point." msgstr "" # f9f427837dcd42108b93d224fa5aa84f -#: ../src/Doc/c-api/unicode.rst:592 +#: c-api/unicode.rst:592 msgid "" "Return a Python string using the UTF-32 encoding in native byte order. The " "string always starts with a BOM mark. Error handling is \"strict\". Return " "*NULL* if an exception was raised by the codec." msgstr "" -#: ../src/Doc/c-api/unicode.rst:600 +#: c-api/unicode.rst:600 msgid "UTF-16 Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:602 +#: c-api/unicode.rst:602 msgid "These are the UTF-16 codec APIs:" msgstr "" # 1184946599154f0cbeb331a2180c9a13 -#: ../src/Doc/c-api/unicode.rst:607 +#: c-api/unicode.rst:607 msgid "" "Decode *size* bytes from a UTF-16 encoded buffer string and return the " "corresponding Unicode object. *errors* (if non-*NULL*) defines the error " @@ -14232,7 +14470,7 @@ msgid "" msgstr "" # fa28c075b5a94545a131b25f2f859ad0 -#: ../src/Doc/c-api/unicode.rst:618 +#: c-api/unicode.rst:618 msgid "" "If ``*byteorder`` is zero, and the first two bytes of the input data are a " "byte order mark (BOM), the decoder switches to this byte order and the BOM " @@ -14242,7 +14480,7 @@ msgid "" msgstr "" # c0e0112252944b459f03dea01699c3b4 -#: ../src/Doc/c-api/unicode.rst:638 +#: c-api/unicode.rst:638 msgid "" "If *consumed* is *NULL*, behave like :c:func:`PyUnicode_DecodeUTF16`. If " "*consumed* is not *NULL*, :c:func:`PyUnicode_DecodeUTF16Stateful` will not " @@ -14252,8 +14490,15 @@ msgid "" "*consumed*." msgstr "" +#: c-api/unicode.rst:646 +msgid "" +"This function used an :c:type:`int` type for *size* and an :c:type:`int *` " +"type for *consumed*. This might require changes in your code for properly " +"supporting 64-bit systems." +msgstr "" + # 9f000c486ef24791b0b6e104e7bf7b14 -#: ../src/Doc/c-api/unicode.rst:654 +#: c-api/unicode.rst:654 msgid "" "Return a Python string object holding the UTF-16 encoded value of the " "Unicode data in *s*. Output is written according to the following byte " @@ -14261,7 +14506,7 @@ msgid "" msgstr "" # 3badf59bf5ca4a22ab2885ddbfbb2f3c -#: ../src/Doc/c-api/unicode.rst:664 +#: c-api/unicode.rst:664 msgid "" "If *Py_UNICODE_WIDE* is defined, a single :c:type:`Py_UNICODE` value may get " "represented as a surrogate pair. If it is not defined, each :c:type:" @@ -14269,7 +14514,7 @@ msgid "" msgstr "" # 15f368dbcb4843adae6fe7e2198019b7 -#: ../src/Doc/c-api/unicode.rst:677 +#: c-api/unicode.rst:677 msgid "" "Return a Python string using the UTF-16 encoding in native byte order. The " "string always starts with a BOM mark. Error handling is \"strict\". Return " @@ -14277,24 +14522,24 @@ msgid "" msgstr "" # 8a74b65022aa48cabefe8f14f049bad9 -#: ../src/Doc/c-api/unicode.rst:683 +#: c-api/unicode.rst:683 msgid "UTF-7 Codecs" msgstr "" # a91eef1d98dd4856abd8f78830a2f727 -#: ../src/Doc/c-api/unicode.rst:685 +#: c-api/unicode.rst:685 msgid "These are the UTF-7 codec APIs:" msgstr "" # 1167187255414a8986be3ec9eaf993a3 -#: ../src/Doc/c-api/unicode.rst:690 +#: c-api/unicode.rst:690 msgid "" "Create a Unicode object by decoding *size* bytes of the UTF-7 encoded string " "*s*. Return *NULL* if an exception was raised by the codec." msgstr "" # fb385c48cd4e455abe9bc7032528983a -#: ../src/Doc/c-api/unicode.rst:696 +#: c-api/unicode.rst:696 msgid "" "If *consumed* is *NULL*, behave like :c:func:`PyUnicode_DecodeUTF7`. If " "*consumed* is not *NULL*, trailing incomplete UTF-7 base-64 sections will " @@ -14303,7 +14548,7 @@ msgid "" msgstr "" # dc2599a7081e4b5b851978a65e4dc562 -#: ../src/Doc/c-api/unicode.rst:704 +#: c-api/unicode.rst:704 msgid "" "Encode the :c:type:`Py_UNICODE` buffer of the given size using UTF-7 and " "return a Python bytes object. Return *NULL* if an exception was raised by " @@ -14311,7 +14556,7 @@ msgid "" msgstr "" # b9913eebd2f04730ae33aff022ae3cbd -#: ../src/Doc/c-api/unicode.rst:708 +#: c-api/unicode.rst:708 msgid "" "If *base64SetO* is nonzero, \"Set O\" (punctuation that has no otherwise " "special meaning) will be encoded in base-64. If *base64WhiteSpace* is " @@ -14319,23 +14564,23 @@ msgid "" "the Python \"utf-7\" codec." msgstr "" -#: ../src/Doc/c-api/unicode.rst:715 +#: c-api/unicode.rst:715 msgid "Unicode-Escape Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:717 +#: c-api/unicode.rst:717 msgid "These are the \"Unicode Escape\" codec APIs:" msgstr "" # b1160519d6cc4a798cae86ca9e9cb990 -#: ../src/Doc/c-api/unicode.rst:722 +#: c-api/unicode.rst:722 msgid "" "Create a Unicode object by decoding *size* bytes of the Unicode-Escape " "encoded string *s*. Return *NULL* if an exception was raised by the codec." msgstr "" # 8cb23e01557b44fcb153bc487f0f994b -#: ../src/Doc/c-api/unicode.rst:732 +#: c-api/unicode.rst:732 msgid "" "Encode the :c:type:`Py_UNICODE` buffer of the given *size* using Unicode-" "Escape and return a Python string object. Return *NULL* if an exception was " @@ -14343,30 +14588,30 @@ msgid "" msgstr "" # 66b6ead7dd1a463f85d21c4043f1090e -#: ../src/Doc/c-api/unicode.rst:743 +#: c-api/unicode.rst:743 msgid "" "Encode a Unicode object using Unicode-Escape and return the result as Python " "string object. Error handling is \"strict\". Return *NULL* if an exception " "was raised by the codec." msgstr "" -#: ../src/Doc/c-api/unicode.rst:749 +#: c-api/unicode.rst:749 msgid "Raw-Unicode-Escape Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:751 +#: c-api/unicode.rst:751 msgid "These are the \"Raw Unicode Escape\" codec APIs:" msgstr "" # 8d0a28566d4445c1bea4c98a2b55e8a9 -#: ../src/Doc/c-api/unicode.rst:756 +#: c-api/unicode.rst:756 msgid "" "Create a Unicode object by decoding *size* bytes of the Raw-Unicode-Escape " "encoded string *s*. Return *NULL* if an exception was raised by the codec." msgstr "" # 952ca6356d494724b105dfcd7f71eb0e -#: ../src/Doc/c-api/unicode.rst:766 +#: c-api/unicode.rst:766 msgid "" "Encode the :c:type:`Py_UNICODE` buffer of the given *size* using Raw-Unicode-" "Escape and return a Python string object. Return *NULL* if an exception was " @@ -14374,32 +14619,32 @@ msgid "" msgstr "" # 15927bbf659d42efb457a22f330df4cb -#: ../src/Doc/c-api/unicode.rst:777 +#: c-api/unicode.rst:777 msgid "" "Encode a Unicode object using Raw-Unicode-Escape and return the result as " "Python string object. Error handling is \"strict\". Return *NULL* if an " "exception was raised by the codec." msgstr "" -#: ../src/Doc/c-api/unicode.rst:783 +#: c-api/unicode.rst:783 msgid "Latin-1 Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:785 +#: c-api/unicode.rst:785 msgid "" "These are the Latin-1 codec APIs: Latin-1 corresponds to the first 256 " "Unicode ordinals and only these are accepted by the codecs during encoding." msgstr "" # 42d563ad417345349b6963b0bf36a59b -#: ../src/Doc/c-api/unicode.rst:791 +#: c-api/unicode.rst:791 msgid "" "Create a Unicode object by decoding *size* bytes of the Latin-1 encoded " "string *s*. Return *NULL* if an exception was raised by the codec." msgstr "" # 5cd56b293a5c464baa607afe1762e9a5 -#: ../src/Doc/c-api/unicode.rst:801 +#: c-api/unicode.rst:801 msgid "" "Encode the :c:type:`Py_UNICODE` buffer of the given *size* using Latin-1 and " "return a Python string object. Return *NULL* if an exception was raised by " @@ -14407,32 +14652,32 @@ msgid "" msgstr "" # 626427dcaefe441cbba254dc8a09fe9a -#: ../src/Doc/c-api/unicode.rst:811 +#: c-api/unicode.rst:811 msgid "" "Encode a Unicode object using Latin-1 and return the result as Python string " "object. Error handling is \"strict\". Return *NULL* if an exception was " "raised by the codec." msgstr "" -#: ../src/Doc/c-api/unicode.rst:817 +#: c-api/unicode.rst:817 msgid "ASCII Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:819 +#: c-api/unicode.rst:819 msgid "" "These are the ASCII codec APIs. Only 7-bit ASCII data is accepted. All " "other codes generate errors." msgstr "" # 9f9e308517b84073991e0e9b5b336112 -#: ../src/Doc/c-api/unicode.rst:825 +#: c-api/unicode.rst:825 msgid "" "Create a Unicode object by decoding *size* bytes of the ASCII encoded string " "*s*. Return *NULL* if an exception was raised by the codec." msgstr "" # 28e64204387949cb950f2e48233736b7 -#: ../src/Doc/c-api/unicode.rst:835 +#: c-api/unicode.rst:835 msgid "" "Encode the :c:type:`Py_UNICODE` buffer of the given *size* using ASCII and " "return a Python string object. Return *NULL* if an exception was raised by " @@ -14440,18 +14685,18 @@ msgid "" msgstr "" # 919b0c429211435f9def808090e52332 -#: ../src/Doc/c-api/unicode.rst:845 +#: c-api/unicode.rst:845 msgid "" "Encode a Unicode object using ASCII and return the result as Python string " "object. Error handling is \"strict\". Return *NULL* if an exception was " "raised by the codec." msgstr "" -#: ../src/Doc/c-api/unicode.rst:851 +#: c-api/unicode.rst:851 msgid "Character Map Codecs" msgstr "" -#: ../src/Doc/c-api/unicode.rst:853 +#: c-api/unicode.rst:853 msgid "" "This codec is special in that it can be used to implement many different " "codecs (and this is in fact what was done to obtain most of the standard " @@ -14459,27 +14704,27 @@ msgid "" "encode and decode characters." msgstr "" -#: ../src/Doc/c-api/unicode.rst:858 +#: c-api/unicode.rst:858 msgid "" "Decoding mappings must map single string characters to single Unicode " "characters, integers (which are then interpreted as Unicode ordinals) or " "None (meaning \"undefined mapping\" and causing an error)." msgstr "" -#: ../src/Doc/c-api/unicode.rst:862 +#: c-api/unicode.rst:862 msgid "" "Encoding mappings must map single Unicode characters to single string " "characters, integers (which are then interpreted as Latin-1 ordinals) or " "None (meaning \"undefined mapping\" and causing an error)." msgstr "" -#: ../src/Doc/c-api/unicode.rst:866 +#: c-api/unicode.rst:866 msgid "" "The mapping objects provided must only support the __getitem__ mapping " "interface." msgstr "" -#: ../src/Doc/c-api/unicode.rst:869 +#: c-api/unicode.rst:869 msgid "" "If a character lookup fails with a LookupError, the character is copied as-" "is meaning that its ordinal value will be interpreted as Unicode or Latin-1 " @@ -14487,12 +14732,12 @@ msgid "" "which map characters to different code points." msgstr "" -#: ../src/Doc/c-api/unicode.rst:874 +#: c-api/unicode.rst:874 msgid "These are the mapping codec APIs:" msgstr "" # 98ee0450f2f8493f93ee67dd861c50e8 -#: ../src/Doc/c-api/unicode.rst:878 +#: c-api/unicode.rst:878 msgid "" "Create a Unicode object by decoding *size* bytes of the encoded string *s* " "using the given *mapping* object. Return *NULL* if an exception was raised " @@ -14502,8 +14747,12 @@ msgid "" "\"characters\" are treated as \"undefined mapping\"." msgstr "" +#: c-api/unicode.rst:885 +msgid "Allowed unicode string as mapping argument." +msgstr "" + # a5d4bc1e1f0e44d08a7a6ab9e7665037 -#: ../src/Doc/c-api/unicode.rst:895 +#: c-api/unicode.rst:895 msgid "" "Encode the :c:type:`Py_UNICODE` buffer of the given *size* using the given " "*mapping* object and return a Python string object. Return *NULL* if an " @@ -14511,19 +14760,19 @@ msgid "" msgstr "" # cc12977c49da461186d7d0cc029fc300 -#: ../src/Doc/c-api/unicode.rst:906 +#: c-api/unicode.rst:906 msgid "" "Encode a Unicode object using the given *mapping* object and return the " "result as Python string object. Error handling is \"strict\". Return " "*NULL* if an exception was raised by the codec." msgstr "" -#: ../src/Doc/c-api/unicode.rst:910 +#: c-api/unicode.rst:910 msgid "The following codec API is special in that maps Unicode to Unicode." msgstr "" # e2ef0f51bcb246bebc5e379b822b1182 -#: ../src/Doc/c-api/unicode.rst:915 +#: c-api/unicode.rst:915 msgid "" "Translate a :c:type:`Py_UNICODE` buffer of the given *size* by applying a " "character mapping *table* to it and return the resulting Unicode object. " @@ -14531,7 +14780,7 @@ msgid "" msgstr "" # 7b05dc8d162347768864afbf3aca2df5 -#: ../src/Doc/c-api/unicode.rst:919 +#: c-api/unicode.rst:919 msgid "" "The *mapping* table must map Unicode ordinal integers to Unicode ordinal " "integers or None (causing deletion of the character)." @@ -14539,18 +14788,18 @@ msgstr "" # 74c9688abbec44dc881498e4f9614cbd # fed0baa31c384043be1015b42d9c3227 -#: ../src/Doc/c-api/unicode.rst:922 ../src/Doc/c-api/unicode.rst:1024 +#: c-api/unicode.rst:922 c-api/unicode.rst:1024 msgid "" "Mapping tables need only provide the :meth:`__getitem__` interface; " "dictionaries and sequences work well. Unmapped character ordinals (ones " "which cause a :exc:`LookupError`) are left untouched and are copied as-is." msgstr "" -#: ../src/Doc/c-api/unicode.rst:932 +#: c-api/unicode.rst:932 msgid "MBCS codecs for Windows" msgstr "" -#: ../src/Doc/c-api/unicode.rst:934 +#: c-api/unicode.rst:934 msgid "" "These are the MBCS codec APIs. They are currently only available on Windows " "and use the Win32 MBCS converters to implement the conversions. Note that " @@ -14559,14 +14808,14 @@ msgid "" msgstr "" # 4fd0d852222544ef8167eb4b3cda5d39 -#: ../src/Doc/c-api/unicode.rst:942 +#: c-api/unicode.rst:942 msgid "" "Create a Unicode object by decoding *size* bytes of the MBCS encoded string " "*s*. Return *NULL* if an exception was raised by the codec." msgstr "" # de8a0d5971bb4f99a0109503334de476 -#: ../src/Doc/c-api/unicode.rst:952 +#: c-api/unicode.rst:952 msgid "" "If *consumed* is *NULL*, behave like :c:func:`PyUnicode_DecodeMBCS`. If " "*consumed* is not *NULL*, :c:func:`PyUnicode_DecodeMBCSStateful` will not " @@ -14575,7 +14824,7 @@ msgid "" msgstr "" # b43de6be22254ec2a80d07de0d2698af -#: ../src/Doc/c-api/unicode.rst:962 +#: c-api/unicode.rst:962 msgid "" "Encode the :c:type:`Py_UNICODE` buffer of the given *size* using MBCS and " "return a Python string object. Return *NULL* if an exception was raised by " @@ -14583,39 +14832,39 @@ msgid "" msgstr "" # 04380236ed334e7e8e687abd3f40f9a9 -#: ../src/Doc/c-api/unicode.rst:972 +#: c-api/unicode.rst:972 msgid "" "Encode a Unicode object using MBCS and return the result as Python string " "object. Error handling is \"strict\". Return *NULL* if an exception was " "raised by the codec." msgstr "" -#: ../src/Doc/c-api/unicode.rst:978 +#: c-api/unicode.rst:978 msgid "Methods & Slots" msgstr "" -#: ../src/Doc/c-api/unicode.rst:983 +#: c-api/unicode.rst:983 msgid "Methods and Slot Functions" msgstr "" -#: ../src/Doc/c-api/unicode.rst:985 +#: c-api/unicode.rst:985 msgid "" "The following APIs are capable of handling Unicode objects and strings on " "input (we refer to them as strings in the descriptions) and return Unicode " "objects or integers as appropriate." msgstr "" -#: ../src/Doc/c-api/unicode.rst:989 +#: c-api/unicode.rst:989 msgid "They all return *NULL* or ``-1`` if an exception occurs." msgstr "" # 81d8b30195ef49a5a96f993260cb4c50 -#: ../src/Doc/c-api/unicode.rst:994 +#: c-api/unicode.rst:994 msgid "Concat two strings giving a new Unicode string." msgstr "" # 5e4ac6780b1348e29a284bbceaa8c7cd -#: ../src/Doc/c-api/unicode.rst:999 +#: c-api/unicode.rst:999 msgid "" "Split a string giving a list of Unicode strings. If *sep* is *NULL*, " "splitting will be done at all whitespace substrings. Otherwise, splits " @@ -14624,8 +14873,14 @@ msgid "" "list." msgstr "" +#: c-api/unicode.rst:1004 +msgid "" +"This function used an :c:type:`int` type for *maxsplit*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + # 2de90e8489dd40208db975ea764e091f -#: ../src/Doc/c-api/unicode.rst:1011 +#: c-api/unicode.rst:1011 msgid "" "Split a Unicode string at line breaks, returning a list of Unicode strings. " "CRLF is considered to be one line break. If *keepend* is 0, the Line break " @@ -14633,43 +14888,49 @@ msgid "" msgstr "" # dc4fdf20898c470d96d3aeb3937402eb -#: ../src/Doc/c-api/unicode.rst:1018 +#: c-api/unicode.rst:1018 msgid "" "Translate a string by applying a character mapping table to it and return " "the resulting Unicode object." msgstr "" # 7604b170f1924367acac5a1a6225b24d -#: ../src/Doc/c-api/unicode.rst:1021 +#: c-api/unicode.rst:1021 msgid "" "The mapping table must map Unicode ordinal integers to Unicode ordinal " "integers or None (causing deletion of the character)." msgstr "" # 32d4944da57440af8d3d60da4adf89c6 -#: ../src/Doc/c-api/unicode.rst:1028 +#: c-api/unicode.rst:1028 msgid "" "*errors* has the usual meaning for codecs. It may be *NULL* which indicates " "to use the default error handling." msgstr "" # fcb3ffe093184cf29d2d31ef5a1f9327 -#: ../src/Doc/c-api/unicode.rst:1034 +#: c-api/unicode.rst:1034 msgid "" "Join a sequence of strings using the given *separator* and return the " "resulting Unicode string." msgstr "" # d8be425e0aec446ab6cd7a0b99bbb210 -#: ../src/Doc/c-api/unicode.rst:1040 +#: c-api/unicode.rst:1040 msgid "" "Return 1 if *substr* matches ``str[start:end]`` at the given tail end " "(*direction* == -1 means to do a prefix match, *direction* == 1 a suffix " "match), 0 otherwise. Return ``-1`` if an error occurred." msgstr "" +#: c-api/unicode.rst:1044 c-api/unicode.rst:1058 +msgid "" +"This function used an :c:type:`int` type for *start* and *end*. This might " +"require changes in your code for properly supporting 64-bit systems." +msgstr "" + # 4c305988cd484e068de740197132244e -#: ../src/Doc/c-api/unicode.rst:1052 +#: c-api/unicode.rst:1052 msgid "" "Return the first position of *substr* in ``str[start:end]`` using the given " "*direction* (*direction* == 1 means to do a forward search, *direction* == " @@ -14679,49 +14940,62 @@ msgid "" msgstr "" # 94600171cfef41afa4deacb8620e708f -#: ../src/Doc/c-api/unicode.rst:1066 +#: c-api/unicode.rst:1066 msgid "" "Return the number of non-overlapping occurrences of *substr* in ``str[start:" "end]``. Return ``-1`` if an error occurred." msgstr "" +#: c-api/unicode.rst:1069 +msgid "" +"This function returned an :c:type:`int` type and used an :c:type:`int` type " +"for *start* and *end*. This might require changes in your code for properly " +"supporting 64-bit systems." +msgstr "" + # bf0fff34d50f4f1f8864abef3d54870c -#: ../src/Doc/c-api/unicode.rst:1077 +#: c-api/unicode.rst:1077 msgid "" "Replace at most *maxcount* occurrences of *substr* in *str* with *replstr* " "and return the resulting Unicode object. *maxcount* == -1 means replace all " "occurrences." msgstr "" +#: c-api/unicode.rst:1081 +msgid "" +"This function used an :c:type:`int` type for *maxcount*. This might require " +"changes in your code for properly supporting 64-bit systems." +msgstr "" + # c7d1a04585914592b8d33ef0b28c0765 -#: ../src/Doc/c-api/unicode.rst:1088 +#: c-api/unicode.rst:1088 msgid "" "Compare two strings and return -1, 0, 1 for less than, equal, and greater " "than, respectively." msgstr "" # f59384e300fd444687ab06becc2f4fe4 -#: ../src/Doc/c-api/unicode.rst:1094 +#: c-api/unicode.rst:1094 msgid "Rich compare two unicode strings and return one of the following:" msgstr "" # ad89295b20764acd8e4ef0fbf7698a42 -#: ../src/Doc/c-api/unicode.rst:1096 +#: c-api/unicode.rst:1096 msgid "``NULL`` in case an exception was raised" msgstr "" # 4d3bbb66fb8e4fae8a3548d6d752565f -#: ../src/Doc/c-api/unicode.rst:1097 +#: c-api/unicode.rst:1097 msgid ":const:`Py_True` or :const:`Py_False` for successful comparisons" msgstr "" # d83ddccab43f4f1386e6d01bc56a431e -#: ../src/Doc/c-api/unicode.rst:1098 +#: c-api/unicode.rst:1098 msgid ":const:`Py_NotImplemented` in case the type combination is unknown" msgstr "" # f16b39c0c48a452a892b4a9819a52c51 -#: ../src/Doc/c-api/unicode.rst:1100 +#: c-api/unicode.rst:1100 msgid "" "Note that :const:`Py_EQ` and :const:`Py_NE` comparisons can cause a :exc:" "`UnicodeWarning` in case the conversion of the arguments to Unicode fails " @@ -14729,38 +15003,38 @@ msgid "" msgstr "" # 16e4454f67ea42fbb5a79821a753694d -#: ../src/Doc/c-api/unicode.rst:1104 +#: c-api/unicode.rst:1104 msgid "" "Possible values for *op* are :const:`Py_GT`, :const:`Py_GE`, :const:" "`Py_EQ`, :const:`Py_NE`, :const:`Py_LT`, and :const:`Py_LE`." msgstr "" # 094aa1e5ee6b4f2a83414d79abd8e784 -#: ../src/Doc/c-api/unicode.rst:1110 +#: c-api/unicode.rst:1110 msgid "" "Return a new string object from *format* and *args*; this is analogous to " "``format % args``." msgstr "" # c7e7a1fe822f4ef084ff6176c2013a6c -#: ../src/Doc/c-api/unicode.rst:1116 +#: c-api/unicode.rst:1116 msgid "" "Check whether *element* is contained in *container* and return true or false " "accordingly." msgstr "" # b34a860ba6e34544aa27e30072fa541b -#: ../src/Doc/c-api/unicode.rst:1119 +#: c-api/unicode.rst:1119 msgid "" "*element* has to coerce to a one element Unicode string. ``-1`` is returned " "if there was an error." msgstr "" -#: ../src/Doc/c-api/utilities.rst:8 +#: c-api/utilities.rst:8 msgid "Utilities" msgstr "Utilitaires" -#: ../src/Doc/c-api/utilities.rst:10 +#: c-api/utilities.rst:10 msgid "" "The functions in this chapter perform various utility tasks, ranging from " "helping C code be more portable across platforms, using Python modules from " @@ -14768,18 +15042,18 @@ msgid "" "values." msgstr "" -#: ../src/Doc/c-api/veryhigh.rst:8 +#: c-api/veryhigh.rst:8 msgid "The Very High Level Layer" msgstr "" -#: ../src/Doc/c-api/veryhigh.rst:10 +#: c-api/veryhigh.rst:10 msgid "" "The functions in this chapter will let you execute Python source code given " "in a file or a buffer, but they will not let you interact in a more detailed " "way with the interpreter." msgstr "" -#: ../src/Doc/c-api/veryhigh.rst:14 +#: c-api/veryhigh.rst:14 msgid "" "Several of these functions accept a start symbol from the grammar as a " "parameter. The available start symbols are :const:`Py_eval_input`, :const:" @@ -14788,7 +15062,7 @@ msgid "" msgstr "" # e15e7acc8fff49efbe16bbc0b09d8c28 -#: ../src/Doc/c-api/veryhigh.rst:19 +#: c-api/veryhigh.rst:19 msgid "" "Note also that several of these functions take :c:type:`FILE\\*` " "parameters. One particular issue which needs to be handled carefully is " @@ -14801,7 +15075,7 @@ msgid "" msgstr "" # e240a89e283544cb8c6d1f1dfe612824 -#: ../src/Doc/c-api/veryhigh.rst:30 +#: c-api/veryhigh.rst:30 msgid "" "The main program for the standard interpreter. This is made available for " "programs which embed Python. The *argc* and *argv* parameters should be " @@ -14815,7 +15089,7 @@ msgid "" msgstr "" # 209ef556e1f94029a806ab24df8cb198 -#: ../src/Doc/c-api/veryhigh.rst:39 +#: c-api/veryhigh.rst:39 msgid "" "Note that if an otherwise unhandled :exc:`SystemExit` is raised, this " "function will not return ``1``, but exit the process, as long as " @@ -14823,28 +15097,28 @@ msgid "" msgstr "" # ca72a7f5bc004489b99ab3a09774be11 -#: ../src/Doc/c-api/veryhigh.rst:46 +#: c-api/veryhigh.rst:46 msgid "" "This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, " "leaving *closeit* set to ``0`` and *flags* set to *NULL*." msgstr "" # 2251138778864fe68c88f93a05a4d329 -#: ../src/Doc/c-api/veryhigh.rst:52 +#: c-api/veryhigh.rst:52 msgid "" "This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, " "leaving the *closeit* argument set to ``0``." msgstr "" # 210d286cc1bb4ccba7e564f65ff43faf -#: ../src/Doc/c-api/veryhigh.rst:58 +#: c-api/veryhigh.rst:58 msgid "" "This is a simplified interface to :c:func:`PyRun_AnyFileExFlags` below, " "leaving the *flags* argument set to *NULL*." msgstr "" # 342e7f0008b94a15ad46a2af355801d1 -#: ../src/Doc/c-api/veryhigh.rst:64 +#: c-api/veryhigh.rst:64 msgid "" "If *fp* refers to a file associated with an interactive device (console or " "terminal input or Unix pseudo-terminal), return the value of :c:func:" @@ -14854,14 +15128,14 @@ msgid "" msgstr "" # 2f57f6c2e6a648c189f9dde8405ef5b5 -#: ../src/Doc/c-api/veryhigh.rst:73 +#: c-api/veryhigh.rst:73 msgid "" "This is a simplified interface to :c:func:`PyRun_SimpleStringFlags` below, " "leaving the *PyCompilerFlags\\** argument set to NULL." msgstr "" # 0593ca7c9345478885f579828548131b -#: ../src/Doc/c-api/veryhigh.rst:79 +#: c-api/veryhigh.rst:79 msgid "" "Executes the Python source code from *command* in the :mod:`__main__` module " "according to the *flags* argument. If :mod:`__main__` does not already " @@ -14871,7 +15145,7 @@ msgid "" msgstr "" # 3ca57820f7cd49c2b21acc8bb4cf2411 -#: ../src/Doc/c-api/veryhigh.rst:85 +#: c-api/veryhigh.rst:85 msgid "" "Note that if an otherwise unhandled :exc:`SystemExit` is raised, this " "function will not return ``-1``, but exit the process, as long as " @@ -14879,28 +15153,28 @@ msgid "" msgstr "" # 78ba3a020cda4c2289ee437979e80b2a -#: ../src/Doc/c-api/veryhigh.rst:92 +#: c-api/veryhigh.rst:92 msgid "" "This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, " "leaving *closeit* set to ``0`` and *flags* set to *NULL*." msgstr "" # a2201dc70a1946718300a93047a92e53 -#: ../src/Doc/c-api/veryhigh.rst:98 +#: c-api/veryhigh.rst:98 msgid "" "This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, " "leaving *closeit* set to ``0``." msgstr "" # 29a8abbec7f74295bce52fc800d5d37f -#: ../src/Doc/c-api/veryhigh.rst:104 +#: c-api/veryhigh.rst:104 msgid "" "This is a simplified interface to :c:func:`PyRun_SimpleFileExFlags` below, " "leaving *flags* set to *NULL*." msgstr "" # 04bef388e84740d29e40d6ca7001c5b0 -#: ../src/Doc/c-api/veryhigh.rst:110 +#: c-api/veryhigh.rst:110 msgid "" "Similar to :c:func:`PyRun_SimpleStringFlags`, but the Python source code is " "read from *fp* instead of an in-memory string. *filename* should be the name " @@ -14909,14 +15183,14 @@ msgid "" msgstr "" # 065499a7415e44cebeceb33e0aacec76 -#: ../src/Doc/c-api/veryhigh.rst:118 +#: c-api/veryhigh.rst:118 msgid "" "This is a simplified interface to :c:func:`PyRun_InteractiveOneFlags` below, " "leaving *flags* set to *NULL*." msgstr "" # 58cb6419dfe8494ba29098d12a7df399 -#: ../src/Doc/c-api/veryhigh.rst:124 +#: c-api/veryhigh.rst:124 msgid "" "Read and execute a single statement from a file associated with an " "interactive device according to the *flags* argument. The user will be " @@ -14928,14 +15202,14 @@ msgid "" msgstr "" # c431e791678d41b9a4e72541b341454a -#: ../src/Doc/c-api/veryhigh.rst:135 +#: c-api/veryhigh.rst:135 msgid "" "This is a simplified interface to :c:func:`PyRun_InteractiveLoopFlags` " "below, leaving *flags* set to *NULL*." msgstr "" # 19d7aba76bb54dd5aaa0b54e344c800c -#: ../src/Doc/c-api/veryhigh.rst:141 +#: c-api/veryhigh.rst:141 msgid "" "Read and execute statements from a file associated with an interactive " "device until EOF is reached. The user will be prompted using ``sys.ps1`` " @@ -14943,7 +15217,7 @@ msgid "" msgstr "" # 844baff043a94756aa5010be5e6e36d1 -#: ../src/Doc/c-api/veryhigh.rst:148 +#: c-api/veryhigh.rst:148 msgid "" "This is a simplified interface to :c:func:" "`PyParser_SimpleParseStringFlagsFilename` below, leaving *filename* set to " @@ -14951,7 +15225,7 @@ msgid "" msgstr "" # 27125dfe6c76430bb80080585a53f3c7 -#: ../src/Doc/c-api/veryhigh.rst:155 +#: c-api/veryhigh.rst:155 msgid "" "This is a simplified interface to :c:func:" "`PyParser_SimpleParseStringFlagsFilename` below, leaving *filename* set to " @@ -14959,7 +15233,7 @@ msgid "" msgstr "" # ec963554fc694523a2e29eb603772935 -#: ../src/Doc/c-api/veryhigh.rst:162 +#: c-api/veryhigh.rst:162 msgid "" "Parse Python source code from *str* using the start token *start* according " "to the *flags* argument. The result can be used to create a code object " @@ -14967,29 +15241,28 @@ msgid "" "be evaluated many times." msgstr "" -# 0c9f63084afb4b3cae773d0c10a2102d -#: ../src/Doc/c-api/veryhigh.rst:170 +#: c-api/veryhigh.rst:170 msgid "" "This is a simplified interface to :c:func:`PyParser_SimpleParseFileFlags` " -"below, leaving *flags* set to ``0``" +"below, leaving *flags* set to ``0``." msgstr "" # 275ec0a22b5845e7885ce165faed0f98 -#: ../src/Doc/c-api/veryhigh.rst:176 +#: c-api/veryhigh.rst:176 msgid "" "Similar to :c:func:`PyParser_SimpleParseStringFlagsFilename`, but the Python " "source code is read from *fp* instead of an in-memory string." msgstr "" # 6506047d8b8a455f908c91002eb11b7c -#: ../src/Doc/c-api/veryhigh.rst:182 +#: c-api/veryhigh.rst:182 msgid "" "This is a simplified interface to :c:func:`PyRun_StringFlags` below, leaving " "*flags* set to *NULL*." msgstr "" # e475f9d364a94c4e8516cdce14048bae -#: ../src/Doc/c-api/veryhigh.rst:188 +#: c-api/veryhigh.rst:188 msgid "" "Execute Python source code from *str* in the context specified by the " "dictionaries *globals* and *locals* with the compiler flags specified by " @@ -14998,35 +15271,35 @@ msgid "" msgstr "" # c0271e6934614c85913c6268f5943310 -#: ../src/Doc/c-api/veryhigh.rst:193 +#: c-api/veryhigh.rst:193 msgid "" "Returns the result of executing the code as a Python object, or *NULL* if an " "exception was raised." msgstr "" # dcb5d5e8b7c84072aac35be64fd677b4 -#: ../src/Doc/c-api/veryhigh.rst:199 +#: c-api/veryhigh.rst:199 msgid "" "This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving " "*closeit* set to ``0`` and *flags* set to *NULL*." msgstr "" # 2d1be7ec5a3047ab9726cc0cf0ff8cd9 -#: ../src/Doc/c-api/veryhigh.rst:205 +#: c-api/veryhigh.rst:205 msgid "" "This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving " "*flags* set to *NULL*." msgstr "" # 8e280ccf10b34f46ab9884949fe6f447 -#: ../src/Doc/c-api/veryhigh.rst:211 +#: c-api/veryhigh.rst:211 msgid "" "This is a simplified interface to :c:func:`PyRun_FileExFlags` below, leaving " "*closeit* set to ``0``." msgstr "" # a801e363dce44aac9d45e4f0a59ff5cc -#: ../src/Doc/c-api/veryhigh.rst:217 +#: c-api/veryhigh.rst:217 msgid "" "Similar to :c:func:`PyRun_StringFlags`, but the Python source code is read " "from *fp* instead of an in-memory string. *filename* should be the name of " @@ -15035,14 +15308,14 @@ msgid "" msgstr "" # aa61b6200d5d4b088aa516a5e76624b4 -#: ../src/Doc/c-api/veryhigh.rst:225 +#: c-api/veryhigh.rst:225 msgid "" "This is a simplified interface to :c:func:`Py_CompileStringFlags` below, " "leaving *flags* set to *NULL*." msgstr "" # a920a66528284a40937780121c8630f4 -#: ../src/Doc/c-api/veryhigh.rst:231 +#: c-api/veryhigh.rst:231 msgid "" "Parse and compile the Python source code in *str*, returning the resulting " "code object. The start token is given by *start*; this can be used to " @@ -15054,7 +15327,7 @@ msgid "" msgstr "" # cad21fcd56064456a081785921867007 -#: ../src/Doc/c-api/veryhigh.rst:242 +#: c-api/veryhigh.rst:242 msgid "" "This is a simplified interface to :c:func:`PyEval_EvalCodeEx`, with just the " "code object, and the dictionaries of global and local variables. The other " @@ -15062,7 +15335,7 @@ msgid "" msgstr "" # 59e7b09accfe463facba41a451b73c34 -#: ../src/Doc/c-api/veryhigh.rst:249 +#: c-api/veryhigh.rst:249 msgid "" "Evaluate a precompiled code object, given a particular environment for its " "evaluation. This environment consists of dictionaries of global and local " @@ -15071,14 +15344,14 @@ msgid "" msgstr "" # 423e94fb239248038df9e1978cc5df86 -#: ../src/Doc/c-api/veryhigh.rst:257 +#: c-api/veryhigh.rst:257 msgid "" "Evaluate an execution frame. This is a simplified interface to " "PyEval_EvalFrameEx, for backward compatibility." msgstr "" # 165cbb695a0249c5942b8b738abd5348 -#: ../src/Doc/c-api/veryhigh.rst:263 +#: c-api/veryhigh.rst:263 msgid "" "This is the main, unvarnished function of Python interpretation. It is " "literally 2000 lines long. The code object associated with the execution " @@ -15089,21 +15362,21 @@ msgid "" msgstr "" # 80e719939c1045cbb8e923aef2840268 -#: ../src/Doc/c-api/veryhigh.rst:273 +#: c-api/veryhigh.rst:273 msgid "" "This function changes the flags of the current evaluation frame, and returns " "true on success, false on failure." msgstr "" # a745662ec3e0425aab95516ae1f81ec8 -#: ../src/Doc/c-api/veryhigh.rst:281 +#: c-api/veryhigh.rst:281 msgid "" "The start symbol from the Python grammar for isolated expressions; for use " "with :c:func:`Py_CompileString`." msgstr "" # 281b214eceed4af1b1d7a0b5f721648f -#: ../src/Doc/c-api/veryhigh.rst:289 +#: c-api/veryhigh.rst:289 msgid "" "The start symbol from the Python grammar for sequences of statements as read " "from a file or other source; for use with :c:func:`Py_CompileString`. This " @@ -15111,7 +15384,7 @@ msgid "" msgstr "" # 3dda59b384c1440b8c1a94c510daf193 -#: ../src/Doc/c-api/veryhigh.rst:298 +#: c-api/veryhigh.rst:298 msgid "" "The start symbol from the Python grammar for a single statement; for use " "with :c:func:`Py_CompileString`. This is the symbol used for the interactive " @@ -15119,7 +15392,7 @@ msgid "" msgstr "" # e44e68fed03742719d62685e6d474ebe -#: ../src/Doc/c-api/veryhigh.rst:305 +#: c-api/veryhigh.rst:305 msgid "" "This is the structure used to hold compiler flags. In cases where code is " "only being compiled, it is passed as ``int flags``, and in cases where code " @@ -15128,7 +15401,7 @@ msgid "" msgstr "" # cfe97e326d03495e91550b0e5a1eb401 -#: ../src/Doc/c-api/veryhigh.rst:310 +#: c-api/veryhigh.rst:310 msgid "" "Whenever ``PyCompilerFlags *flags`` is *NULL*, :attr:`cf_flags` is treated " "as equal to ``0``, and any modification due to ``from __future__ import`` is " @@ -15136,17 +15409,17 @@ msgid "" msgstr "" # af1d88420d37494faf32c517a60f5df4 -#: ../src/Doc/c-api/veryhigh.rst:321 +#: c-api/veryhigh.rst:321 msgid "" "This bit can be set in *flags* to cause division operator ``/`` to be " "interpreted as \"true division\" according to :pep:`238`." msgstr "" -#: ../src/Doc/c-api/weakref.rst:6 +#: c-api/weakref.rst:6 msgid "Weak Reference Objects" msgstr "" -#: ../src/Doc/c-api/weakref.rst:8 +#: c-api/weakref.rst:8 msgid "" "Python supports *weak references* as first-class objects. There are two " "specific object types which directly implement weak references. The first " @@ -15155,22 +15428,22 @@ msgid "" msgstr "" # 878afd97f0f24874858bb58f649ca987 -#: ../src/Doc/c-api/weakref.rst:16 +#: c-api/weakref.rst:16 msgid "Return true if *ob* is either a reference or proxy object." msgstr "" # b40fb1c223fd476396f8c58a228ff27b -#: ../src/Doc/c-api/weakref.rst:23 +#: c-api/weakref.rst:23 msgid "Return true if *ob* is a reference object." msgstr "" # c1cf65de394240d5975cc9f3dead6d76 -#: ../src/Doc/c-api/weakref.rst:30 +#: c-api/weakref.rst:30 msgid "Return true if *ob* is a proxy object." msgstr "" # 80e6e79af01143a58bb7bc6d1422041a -#: ../src/Doc/c-api/weakref.rst:37 +#: c-api/weakref.rst:37 msgid "" "Return a weak reference object for the object *ob*. This will always return " "a new reference, but is not guaranteed to create a new object; an existing " @@ -15183,7 +15456,7 @@ msgid "" msgstr "" # 1e21a3695098455d912211e846f6fc3b -#: ../src/Doc/c-api/weakref.rst:51 +#: c-api/weakref.rst:51 msgid "" "Return a weak reference proxy object for the object *ob*. This will always " "return a new reference, but is not guaranteed to create a new object; an " @@ -15196,14 +15469,14 @@ msgid "" msgstr "" # a2480df5d77e441cbf0a030defcd9e63 -#: ../src/Doc/c-api/weakref.rst:65 +#: c-api/weakref.rst:65 msgid "" "Return the referenced object from a weak reference, *ref*. If the referent " "is no longer live, returns :const:`Py_None`." msgstr "" # 324f41560b0447f0bd584b7f1bc9a3b0 -#: ../src/Doc/c-api/weakref.rst:72 +#: c-api/weakref.rst:72 msgid "" "This function returns a **borrowed reference** to the referenced object. " "This means that you should always call :c:func:`Py_INCREF` on the object " @@ -15211,7 +15484,7 @@ msgid "" msgstr "" # 2cf0cb358281422080803ea291ee0601 -#: ../src/Doc/c-api/weakref.rst:80 +#: c-api/weakref.rst:80 msgid "" "Similar to :c:func:`PyWeakref_GetObject`, but implemented as a macro that " "does no error checking." diff --git a/contents.po b/contents.po index 56f140d1..bc6511e6 100644 --- a/contents.po +++ b/contents.po @@ -7,16 +7,16 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2012-10-20 04:01\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/contents.rst:3 +#: contents.rst:3 msgid "Python Documentation contents" msgstr "Contenu de la documentation Python" diff --git a/copyright.po b/copyright.po index fbabc886..cf8c5e12 100644 --- a/copyright.po +++ b/copyright.po @@ -7,35 +7,35 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-01-06 04:03\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/copyright.rst:3 +#: copyright.rst:3 msgid "Copyright" msgstr "Copyright" -#: ../src/Doc/copyright.rst:5 +#: copyright.rst:5 msgid "Python and this documentation is:" msgstr "Python et cette documentation sont :" -#: ../src/Doc/copyright.rst:7 +#: copyright.rst:7 #, fuzzy -msgid "Copyright © 2001-2014 Python Software Foundation. All rights reserved." +msgid "Copyright © 2001-2015 Python Software Foundation. All rights reserved." msgstr "" "Copyright © 2001-2010 Python Software Foundation. Tous droits réservés." -#: ../src/Doc/copyright.rst:9 +#: copyright.rst:9 msgid "Copyright © 2000 BeOpen.com. All rights reserved." msgstr "Copyright © 2000 BeOpen.com. Tous droits réservés." -#: ../src/Doc/copyright.rst:11 +#: copyright.rst:11 msgid "" "Copyright © 1995-2000 Corporation for National Research Initiatives. All " "rights reserved." @@ -43,13 +43,13 @@ msgstr "" "Copyright © 1995-2000 Corporation for National Research Initiatives. Tous " "droits réservés." -#: ../src/Doc/copyright.rst:14 +#: copyright.rst:14 msgid "" "Copyright © 1991-1995 Stichting Mathematisch Centrum. All rights reserved." msgstr "" "Copyright © 1991-1995 Stichting Mathematisch Centrum. Tous droits réservés." -#: ../src/Doc/copyright.rst:18 +#: copyright.rst:18 msgid "" "See :ref:`history-and-license` for complete license and permissions " "information." diff --git a/distributing.po b/distributing.po new file mode 100644 index 00000000..1141c799 --- /dev/null +++ b/distributing.po @@ -0,0 +1,251 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 1990-2015, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 2.7\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: distributing/index.rst:5 +msgid "Distributing Python Modules" +msgstr "" + +#: distributing/index.rst:7 +msgid "distutils-sig@python.org" +msgstr "" + +#: distributing/index.rst:10 +msgid "" +"As a popular open source development project, Python has an active " +"supporting community of contributors and users that also make their software " +"available for other Python developers to use under open source license terms." +msgstr "" + +#: distributing/index.rst:14 +msgid "" +"This allows Python users to share and collaborate effectively, benefiting " +"from the solutions others have already created to common (and sometimes even " +"rare!) problems, as well as potentially contributing their own solutions to " +"the common pool." +msgstr "" + +#: distributing/index.rst:19 +msgid "" +"This guide covers the distribution part of the process. For a guide to " +"installing other Python projects, refer to the :ref:`installation guide " +"`." +msgstr "" + +#: distributing/index.rst:25 +msgid "" +"For corporate and other institutional users, be aware that many " +"organisations have their own policies around using and contributing to open " +"source software. Please take such policies into account when making use of " +"the distribution and installation tools provided with Python." +msgstr "" + +#: distributing/index.rst:32 +msgid "Key terms" +msgstr "" + +#: distributing/index.rst:34 +msgid "" +"the `Python Packaging Index `__ is a public " +"repository of open source licensed packages made available for use by other " +"Python users" +msgstr "" + +#: distributing/index.rst:37 +msgid "" +"the `Python Packaging Authority `__ are the group of developers and documentation authors " +"responsible for the maintenance and evolution of the standard packaging " +"tools and the associated metadata and file format standards. They maintain a " +"variety of tools, documentation and issue trackers on both `GitHub `__ and `BitBucket `__." +msgstr "" + +#: distributing/index.rst:44 +msgid "" +":mod:`distutils` is the original build and distribution system first added " +"to the Python standard library in 1998. While direct use of :mod:`distutils` " +"is being phased out, it still laid the foundation for the current packaging " +"and distribution infrastructure, and it not only remains part of the " +"standard library, but its name lives on in other ways (such as the name of " +"the mailing list used to coordinate Python packaging standards development)." +msgstr "" + +#: distributing/index.rst:51 +msgid "" +"`setuptools`_ is a (largely) drop-in replacement for :mod:`distutils` first " +"published in 2004. Its most notable addition over the unmodified :mod:" +"`distutils` tools was the ability to declare dependencies on other packages. " +"It is currently recommended as a more regularly updated alternative to :mod:" +"`distutils` that offers consistent support for more recent packaging " +"standards across a wide range of Python versions." +msgstr "" + +#: distributing/index.rst:57 +msgid "" +"`wheel`_ (in this context) is a project that adds the ``bdist_wheel`` " +"command to :mod:`distutils`/`setuptools`_. This produces a cross platform " +"binary packaging format (called \"wheels\" or \"wheel files\" and defined " +"in :pep:`427`) that allows Python libraries, even those including binary " +"extensions, to be installed on a system without needing to be built locally." +msgstr "" + +#: distributing/index.rst:68 +msgid "Open source licensing and collaboration" +msgstr "" + +#: distributing/index.rst:70 +msgid "" +"In most parts of the world, software is automatically covered by copyright. " +"This means that other developers require explicit permission to copy, use, " +"modify and redistribute the software." +msgstr "" + +#: distributing/index.rst:74 +msgid "" +"Open source licensing is a way of explicitly granting such permission in a " +"relatively consistent way, allowing developers to share and collaborate " +"efficiently by making common solutions to various problems freely available. " +"This leaves many developers free to spend more time focusing on the problems " +"that are relatively unique to their specific situation." +msgstr "" + +#: distributing/index.rst:80 +msgid "" +"The distribution tools provided with Python are designed to make it " +"reasonably straightforward for developers to make their own contributions " +"back to that common pool of software if they choose to do so." +msgstr "" + +#: distributing/index.rst:84 +msgid "" +"The same distribution tools can also be used to distribute software within " +"an organisation, regardless of whether that software is published as open " +"source software or not." +msgstr "" + +#: distributing/index.rst:90 +msgid "Installing the tools" +msgstr "" + +#: distributing/index.rst:92 +msgid "" +"The standard library does not include build tools that support modern Python " +"packaging standards, as the core development team has found that it is " +"important to have standard tools that work consistently, even on older " +"versions of Python." +msgstr "" + +#: distributing/index.rst:97 +msgid "" +"The currently recommended build and distribution tools can be installed by " +"invoking the ``pip`` module at the command line::" +msgstr "" + +#: distributing/index.rst:104 +msgid "" +"For POSIX users (including Mac OS X and Linux users), these instructions " +"assume the use of a :term:`virtual environment`." +msgstr "" + +#: distributing/index.rst:107 +msgid "" +"For Windows users, these instructions assume that the option to adjust the " +"system PATH environment variable was selected when installing Python." +msgstr "" + +#: distributing/index.rst:111 +msgid "" +"The Python Packaging User Guide includes more details on the `currently " +"recommended tools`_." +msgstr "" + +#: distributing/index.rst:117 +msgid "Reading the guide" +msgstr "" + +#: distributing/index.rst:119 +msgid "" +"The Python Packaging User Guide covers the various key steps and elements " +"involved in creating a project:" +msgstr "" + +#: distributing/index.rst:122 +msgid "`Project structure`_" +msgstr "" + +#: distributing/index.rst:123 +msgid "`Building and packaging the project`_" +msgstr "" + +#: distributing/index.rst:124 +msgid "`Uploading the project to the Python Packaging Index`_" +msgstr "" + +#: distributing/index.rst:135 +msgid "How do I...?" +msgstr "" + +#: distributing/index.rst:137 +msgid "These are quick answers or links for some common tasks." +msgstr "" + +#: distributing/index.rst:140 +msgid "... choose a name for my project?" +msgstr "" + +#: distributing/index.rst:142 +msgid "This isn't an easy topic, but here are a few tips:" +msgstr "" + +#: distributing/index.rst:144 +msgid "check the Python Packaging Index to see if the name is already in use" +msgstr "" + +#: distributing/index.rst:145 +msgid "" +"check popular hosting sites like GitHub, BitBucket, etc to see if there is " +"already a project with that name" +msgstr "" + +#: distributing/index.rst:147 +msgid "check what comes up in a web search for the name you're considering" +msgstr "" + +#: distributing/index.rst:148 +msgid "" +"avoid particularly common words, especially ones with multiple meanings, as " +"they can make it difficult for users to find your software when searching " +"for it" +msgstr "" + +#: distributing/index.rst:154 +msgid "... create and distribute binary extensions?" +msgstr "" + +#: distributing/index.rst:156 +msgid "" +"This is actually quite a complex topic, with a variety of alternatives " +"available depending on exactly what you're aiming to achieve. See the Python " +"Packaging User Guide for more information and recommendations." +msgstr "" + +#: distributing/index.rst:162 +msgid "" +"`Python Packaging User Guide: Binary Extensions `__" +msgstr "" diff --git a/distutils.po b/distutils.po index cf51bb9e..cd1ea18d 100644 --- a/distutils.po +++ b/distutils.po @@ -7,25 +7,25 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/distutils/apiref.rst:5 +#: distutils/apiref.rst:5 msgid "API Reference" msgstr "Référence de l'API" -#: ../src/Doc/distutils/apiref.rst:9 +#: distutils/apiref.rst:9 msgid ":mod:`distutils.core` --- Core Distutils functionality" msgstr "" -#: ../src/Doc/distutils/apiref.rst:15 +#: distutils/apiref.rst:15 msgid "" "The :mod:`distutils.core` module is the only module that needs to be " "installed to use the Distutils. It provides the :func:`setup` (which is " @@ -37,7 +37,7 @@ msgstr "" "appelé par le script de setup). Il fournit indirectement les classes :class:" "`distutils.dist.Distribution` et :class:`distutils.cmd.Command`." -#: ../src/Doc/distutils/apiref.rst:23 +#: distutils/apiref.rst:23 #, fuzzy msgid "" "The basic do-everything function that does most everything you could ever " @@ -46,7 +46,7 @@ msgstr "" "La fonction de base à tout faire qui fait presque tout ce dont vous pourriez " "attendre d'une méthode Distutils. Voir XXXXX" -#: ../src/Doc/distutils/apiref.rst:26 +#: distutils/apiref.rst:26 msgid "" "The setup function takes a large number of arguments. These are laid out in " "the following table." @@ -54,173 +54,167 @@ msgstr "" "La fonction setup prend un grand nombre d'arguments. Ils sont présentés dans " "le tableau suivant." -#: ../src/Doc/distutils/apiref.rst:32 ../src/Doc/distutils/apiref.rst:175 +#: distutils/apiref.rst:32 distutils/apiref.rst:175 msgid "argument name" msgstr "nom de l'argument" -#: ../src/Doc/distutils/apiref.rst:32 ../src/Doc/distutils/apiref.rst:133 -#: ../src/Doc/distutils/apiref.rst:175 +#: distutils/apiref.rst:32 distutils/apiref.rst:133 distutils/apiref.rst:175 msgid "value" msgstr "valeur" -#: ../src/Doc/distutils/apiref.rst:32 ../src/Doc/distutils/apiref.rst:175 +#: distutils/apiref.rst:32 distutils/apiref.rst:175 msgid "type" msgstr "type" -#: ../src/Doc/distutils/apiref.rst:34 ../src/Doc/distutils/apiref.rst:177 +#: distutils/apiref.rst:34 distutils/apiref.rst:177 msgid "*name*" msgstr "*name*" # aconrad: package ? paquet ? -#: ../src/Doc/distutils/apiref.rst:34 +#: distutils/apiref.rst:34 msgid "The name of the package" msgstr "Le nom du paquet" -#: ../src/Doc/distutils/apiref.rst:34 ../src/Doc/distutils/apiref.rst:36 -#: ../src/Doc/distutils/apiref.rst:40 ../src/Doc/distutils/apiref.rst:43 -#: ../src/Doc/distutils/apiref.rst:46 ../src/Doc/distutils/apiref.rst:48 -#: ../src/Doc/distutils/apiref.rst:51 ../src/Doc/distutils/apiref.rst:58 -#: ../src/Doc/distutils/apiref.rst:62 ../src/Doc/distutils/apiref.rst:65 -#: ../src/Doc/distutils/apiref.rst:86 ../src/Doc/distutils/apiref.rst:96 -#: ../src/Doc/distutils/apiref.rst:177 ../src/Doc/distutils/apiref.rst:267 +#: distutils/apiref.rst:34 distutils/apiref.rst:36 distutils/apiref.rst:40 +#: distutils/apiref.rst:43 distutils/apiref.rst:46 distutils/apiref.rst:48 +#: distutils/apiref.rst:51 distutils/apiref.rst:58 distutils/apiref.rst:62 +#: distutils/apiref.rst:65 distutils/apiref.rst:86 distutils/apiref.rst:96 +#: distutils/apiref.rst:177 distutils/apiref.rst:267 msgid "a string" msgstr "une chaîne de caractères" -#: ../src/Doc/distutils/apiref.rst:36 +#: distutils/apiref.rst:36 msgid "*version*" msgstr "*version*" -#: ../src/Doc/distutils/apiref.rst:36 +#: distutils/apiref.rst:36 #, fuzzy msgid "The version number of the package; see :mod:`distutils.version`" msgstr "Le numéro de version du paquet" -#: ../src/Doc/distutils/apiref.rst:40 +#: distutils/apiref.rst:40 msgid "*description*" msgstr "*description*" -#: ../src/Doc/distutils/apiref.rst:40 +#: distutils/apiref.rst:40 msgid "A single line describing the package" msgstr "Une ligne unique décrivant le paquet" -#: ../src/Doc/distutils/apiref.rst:43 +#: distutils/apiref.rst:43 msgid "*long_description*" msgstr "*long_description*" -#: ../src/Doc/distutils/apiref.rst:43 +#: distutils/apiref.rst:43 msgid "Longer description of the package" msgstr "Une description plus longue du paquet" -#: ../src/Doc/distutils/apiref.rst:46 +#: distutils/apiref.rst:46 msgid "*author*" msgstr "*author*" -#: ../src/Doc/distutils/apiref.rst:46 +#: distutils/apiref.rst:46 msgid "The name of the package author" msgstr "Le nom de l'auteur du paquet" -#: ../src/Doc/distutils/apiref.rst:48 +#: distutils/apiref.rst:48 msgid "*author_email*" msgstr "*author_email*" -#: ../src/Doc/distutils/apiref.rst:48 +#: distutils/apiref.rst:48 msgid "The email address of the package author" msgstr "L'adresse e-mail de l'auteur du paquet" -#: ../src/Doc/distutils/apiref.rst:51 +#: distutils/apiref.rst:51 msgid "*maintainer*" msgstr "*maintainer*" # b3e38fed79af4e74a38e945f4d64cd02 -#: ../src/Doc/distutils/apiref.rst:51 +#: distutils/apiref.rst:51 msgid "" "The name of the current maintainer, if different from the author. Note that " "if the maintainer is provided, distutils will use it as the author in :file:" "`PKG-INFO`" msgstr "" -#: ../src/Doc/distutils/apiref.rst:58 +#: distutils/apiref.rst:58 msgid "*maintainer_email*" msgstr "*maintainer_email*" -#: ../src/Doc/distutils/apiref.rst:58 +#: distutils/apiref.rst:58 msgid "" "The email address of the current maintainer, if different from the author" msgstr "L'adresse email de l'actuel mainteneur, si différent de l'auteur" -#: ../src/Doc/distutils/apiref.rst:62 +#: distutils/apiref.rst:62 msgid "*url*" msgstr "*url*" -#: ../src/Doc/distutils/apiref.rst:62 +#: distutils/apiref.rst:62 msgid "A URL for the package (homepage)" msgstr "Une URL pour le paquet (page d'accueil)" -#: ../src/Doc/distutils/apiref.rst:65 +#: distutils/apiref.rst:65 msgid "*download_url*" msgstr "*download_url*" -#: ../src/Doc/distutils/apiref.rst:65 +#: distutils/apiref.rst:65 msgid "A URL to download the package" msgstr "Une URL pour télécharger le paquet" -#: ../src/Doc/distutils/apiref.rst:67 +#: distutils/apiref.rst:67 msgid "*packages*" msgstr "*packages*" -#: ../src/Doc/distutils/apiref.rst:67 +#: distutils/apiref.rst:67 msgid "A list of Python packages that distutils will manipulate" msgstr "Une liste des paquets Python que distutils va manipuler" -#: ../src/Doc/distutils/apiref.rst:67 ../src/Doc/distutils/apiref.rst:70 -#: ../src/Doc/distutils/apiref.rst:73 ../src/Doc/distutils/apiref.rst:90 -#: ../src/Doc/distutils/apiref.rst:183 ../src/Doc/distutils/apiref.rst:196 -#: ../src/Doc/distutils/apiref.rst:212 ../src/Doc/distutils/apiref.rst:215 -#: ../src/Doc/distutils/apiref.rst:219 ../src/Doc/distutils/apiref.rst:223 -#: ../src/Doc/distutils/apiref.rst:229 ../src/Doc/distutils/apiref.rst:236 -#: ../src/Doc/distutils/apiref.rst:247 ../src/Doc/distutils/apiref.rst:256 -#: ../src/Doc/distutils/apiref.rst:264 +#: distutils/apiref.rst:67 distutils/apiref.rst:70 distutils/apiref.rst:73 +#: distutils/apiref.rst:90 distutils/apiref.rst:183 distutils/apiref.rst:196 +#: distutils/apiref.rst:212 distutils/apiref.rst:215 distutils/apiref.rst:219 +#: distutils/apiref.rst:223 distutils/apiref.rst:229 distutils/apiref.rst:236 +#: distutils/apiref.rst:247 distutils/apiref.rst:256 distutils/apiref.rst:264 msgid "a list of strings" msgstr "une liste de chaînes" -#: ../src/Doc/distutils/apiref.rst:70 +#: distutils/apiref.rst:70 msgid "*py_modules*" msgstr "*py_modules*" -#: ../src/Doc/distutils/apiref.rst:70 +#: distutils/apiref.rst:70 msgid "A list of Python modules that distutils will manipulate" msgstr "Une liste de modules Python que distutils va manipuler" -#: ../src/Doc/distutils/apiref.rst:73 +#: distutils/apiref.rst:73 msgid "*scripts*" msgstr "*scripts*" -#: ../src/Doc/distutils/apiref.rst:73 +#: distutils/apiref.rst:73 msgid "A list of standalone script files to be built and installed" msgstr "Une liste de scripts autonomes à construire et à installer" -#: ../src/Doc/distutils/apiref.rst:77 +#: distutils/apiref.rst:77 msgid "*ext_modules*" msgstr "*ext_modules*" -#: ../src/Doc/distutils/apiref.rst:77 +#: distutils/apiref.rst:77 msgid "A list of Python extensions to be built" msgstr "Une liste des extensions Python à construire" -#: ../src/Doc/distutils/apiref.rst:77 +#: distutils/apiref.rst:77 #, fuzzy msgid "a list of instances of :class:`distutils.core.Extension`" msgstr "Une liste d'instances de :class:`distutils.core.Extension'" -#: ../src/Doc/distutils/apiref.rst:80 +#: distutils/apiref.rst:80 msgid "*classifiers*" msgstr "*classifiers*" -#: ../src/Doc/distutils/apiref.rst:80 +#: distutils/apiref.rst:80 msgid "A list of categories for the package" msgstr "Une liste de catégories pour le paquet" -#: ../src/Doc/distutils/apiref.rst:80 +#: distutils/apiref.rst:80 #, fuzzy msgid "" "a list of strings; valid classifiers are listed on `PyPI `_." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1010 +#: distutils/apiref.rst:1004 +msgid "NFS files are ignored." +msgstr "" + +#: distutils/apiref.rst:1010 msgid "" "Recursively remove *directory* and all files and directories underneath it. " "Any errors are ignored (apart from being reported to ``sys.stdout`` if " "*verbose* is true)." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1016 +#: distutils/apiref.rst:1016 msgid ":mod:`distutils.file_util` --- Single file operations" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1022 +#: distutils/apiref.rst:1022 msgid "" "This module contains some utility functions for operating on individual " "files." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1027 +#: distutils/apiref.rst:1027 msgid "" "Copy file *src* to *dst*. If *dst* is a directory, then *src* is copied " "there with the same name; otherwise, it must be a filename. (If the file " @@ -1490,7 +1486,7 @@ msgid "" "if *dst* does exist but is older than *src*." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1036 +#: distutils/apiref.rst:1036 msgid "" "*link* allows you to make hard links (using :func:`os.link`) or symbolic " "links (using :func:`os.symlink`) instead of copying: set it to ``'hard'`` or " @@ -1500,43 +1496,43 @@ msgid "" "to copy file contents." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1043 +#: distutils/apiref.rst:1043 msgid "" "Return a tuple ``(dest_name, copied)``: *dest_name* is the actual name of " "the output file, and *copied* is true if the file was copied (or would have " "been copied, if *dry_run* true)." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1057 +#: distutils/apiref.rst:1057 msgid "" "Move file *src* to *dst*. If *dst* is a directory, the file will be moved " "into it with the same name; otherwise, *src* is just renamed to *dst*. " "Returns the new full name of the file." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1063 +#: distutils/apiref.rst:1063 msgid "" "Handles cross-device moves on Unix using :func:`copy_file`. What about " "other systems?" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1069 +#: distutils/apiref.rst:1069 msgid "" "Create a file called *filename* and write *contents* (a sequence of strings " "without line terminators) to it." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1074 +#: distutils/apiref.rst:1074 msgid ":mod:`distutils.util` --- Miscellaneous other utility functions" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1080 +#: distutils/apiref.rst:1080 msgid "" "This module contains other assorted bits and pieces that don't fit into any " "other utility module." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1086 +#: distutils/apiref.rst:1086 msgid "" "Return a string that identifies the current platform. This is used mainly " "to distinguish platform-specific build directories and platform-specific " @@ -1547,42 +1543,42 @@ msgid "" "isn't particularly important." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1094 +#: distutils/apiref.rst:1094 msgid "Examples of returned values:" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1096 +#: distutils/apiref.rst:1096 msgid "``linux-i586``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1097 +#: distutils/apiref.rst:1097 msgid "``linux-alpha``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1098 +#: distutils/apiref.rst:1098 msgid "``solaris-2.6-sun4u``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1099 +#: distutils/apiref.rst:1099 msgid "``irix-5.3``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1100 +#: distutils/apiref.rst:1100 msgid "``irix64-6.2``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1102 +#: distutils/apiref.rst:1102 msgid "For non-POSIX platforms, currently just returns ``sys.platform``." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1104 +#: distutils/apiref.rst:1104 msgid "" "For Mac OS X systems the OS version reflects the minimal version on which " "binaries will run (that is, the value of ``MACOSX_DEPLOYMENT_TARGET`` during " "the build of Python), not the OS version of the current system." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1108 +#: distutils/apiref.rst:1108 msgid "" "For universal binary builds on Mac OS X the architecture value reflects the " "univeral binary status instead of the architecture of the current processor. " @@ -1594,27 +1590,27 @@ msgid "" "and x86_64 architectures" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1117 +#: distutils/apiref.rst:1117 msgid "Examples of returned values on Mac OS X:" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1119 +#: distutils/apiref.rst:1119 msgid "``macosx-10.3-ppc``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1121 +#: distutils/apiref.rst:1121 msgid "``macosx-10.3-fat``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1123 +#: distutils/apiref.rst:1123 msgid "``macosx-10.5-universal``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1125 +#: distutils/apiref.rst:1125 msgid "``macosx-10.6-intel``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1130 +#: distutils/apiref.rst:1130 msgid "" "Return 'pathname' as a name that will work on the native filesystem, i.e. " "split it on '/' and put it back together again using the current directory " @@ -1624,7 +1620,7 @@ msgid "" "Unix-ish systems if *pathname* either starts or ends with a slash." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1140 +#: distutils/apiref.rst:1140 msgid "" "Return *pathname* with *new_root* prepended. If *pathname* is relative, " "this is equivalent to ``os.path.join(new_root,pathname)`` Otherwise, it " @@ -1632,24 +1628,24 @@ msgid "" "tricky on DOS/Windows." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1147 +#: distutils/apiref.rst:1147 msgid "" "Ensure that 'os.environ' has all the environment variables we guarantee that " "users can use in config files, command-line options, etc. Currently this " "includes:" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1151 +#: distutils/apiref.rst:1151 msgid ":envvar:`HOME` - user's home directory (Unix only)" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1152 +#: distutils/apiref.rst:1152 msgid "" ":envvar:`PLAT` - description of the current platform, including hardware and " "OS (see :func:`get_platform`)" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1158 +#: distutils/apiref.rst:1158 msgid "" "Perform shell/Perl-style variable substitution on *s*. Every occurrence of " "``$`` followed by a name is considered a variable, and variable is " @@ -1660,14 +1656,14 @@ msgid "" "either *local_vars* or ``os.environ``." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1165 +#: distutils/apiref.rst:1165 msgid "" "Note that this is not a fully-fledged string interpolation function. A valid " "``$variable`` can consist only of upper and lower case letters, numbers and " "an underscore. No { } or ( ) style quoting is available." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1173 +#: distutils/apiref.rst:1173 msgid "" "Split a string up according to Unix shell-like rules for quotes and " "backslashes. In short: words are delimited by spaces, as long as those " @@ -1678,7 +1674,7 @@ msgid "" "any quoted string. Returns a list of words." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1186 +#: distutils/apiref.rst:1186 msgid "" "Perform some action that affects the outside world (for instance, writing to " "the filesystem). Such actions are special because they are disabled by the " @@ -1688,18 +1684,18 @@ msgid "" "message to print." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1195 +#: distutils/apiref.rst:1195 msgid "Convert a string representation of truth to true (1) or false (0)." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1197 +#: distutils/apiref.rst:1197 msgid "" "True values are ``y``, ``yes``, ``t``, ``true``, ``on`` and ``1``; false " "values are ``n``, ``no``, ``f``, ``false``, ``off`` and ``0``. Raises :exc:" "`ValueError` if *val* is anything else." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1204 +#: distutils/apiref.rst:1204 msgid "" "Byte-compile a collection of Python source files to either :file:`.pyc` or :" "file:`.pyo` files in the same directory. *py_files* is a list of files to " @@ -1707,23 +1703,23 @@ msgid "" "*optimize* must be one of the following:" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1209 +#: distutils/apiref.rst:1209 msgid "``0`` - don't optimize (generate :file:`.pyc`)" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1210 +#: distutils/apiref.rst:1210 msgid "``1`` - normal optimization (like ``python -O``)" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1211 +#: distutils/apiref.rst:1211 msgid "``2`` - extra optimization (like ``python -OO``)" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1213 +#: distutils/apiref.rst:1213 msgid "If *force* is true, all files are recompiled regardless of timestamps." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1215 +#: distutils/apiref.rst:1215 msgid "" "The source filename encoded in each :term:`bytecode` file defaults to the " "filenames listed in *py_files*; you can modify these with *prefix* and " @@ -1733,13 +1729,13 @@ msgid "" "*prefix* and *base_dir*, as you wish." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1222 +#: distutils/apiref.rst:1222 msgid "" "If *dry_run* is true, doesn't actually do anything that would affect the " "filesystem." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1225 +#: distutils/apiref.rst:1225 msgid "" "Byte-compilation is either done directly in this interpreter process with " "the standard :mod:`py_compile` module, or indirectly by writing a temporary " @@ -1749,47 +1745,47 @@ msgid "" "you know what you're doing, leave it set to ``None``." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1235 +#: distutils/apiref.rst:1235 msgid "" "Return a version of *header* escaped for inclusion in an :rfc:`822` header, " "by ensuring there are 8 spaces space after each newline. Note that it does " "no other modification of the string." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1245 +#: distutils/apiref.rst:1245 msgid ":mod:`distutils.dist` --- The Distribution class" msgstr "" # b95f09e99826456bb362f08f97c50894 -#: ../src/Doc/distutils/apiref.rst:1252 +#: distutils/apiref.rst:1252 msgid "" "This module provides the :class:`~distutils.core.Distribution` class, which " "represents the module distribution being built/installed/distributed." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1257 +#: distutils/apiref.rst:1257 msgid ":mod:`distutils.extension` --- The Extension class" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1264 +#: distutils/apiref.rst:1264 msgid "" "This module provides the :class:`Extension` class, used to describe C/C++ " "extension modules in setup scripts." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1272 +#: distutils/apiref.rst:1272 msgid ":mod:`distutils.debug` --- Distutils debug mode" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1278 +#: distutils/apiref.rst:1278 msgid "This module provides the DEBUG flag." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1282 +#: distutils/apiref.rst:1282 msgid ":mod:`distutils.errors` --- Distutils exceptions" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1288 +#: distutils/apiref.rst:1288 msgid "" "Provides exceptions used by the Distutils modules. Note that Distutils " "modules may raise standard exceptions; in particular, SystemExit is usually " @@ -1797,45 +1793,45 @@ msgid "" "line arguments)." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1292 +#: distutils/apiref.rst:1292 msgid "" "This module is safe to use in ``from ... import *`` mode; it only exports " "symbols whose names start with ``Distutils`` and end with ``Error``." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1297 +#: distutils/apiref.rst:1297 msgid "" ":mod:`distutils.fancy_getopt` --- Wrapper around the standard getopt module" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1303 +#: distutils/apiref.rst:1303 msgid "" "This module provides a wrapper around the standard :mod:`getopt` module " "that provides the following additional features:" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1306 +#: distutils/apiref.rst:1306 msgid "short and long options are tied together" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1308 +#: distutils/apiref.rst:1308 msgid "" "options have help strings, so :func:`fancy_getopt` could potentially create " "a complete usage summary" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1311 +#: distutils/apiref.rst:1311 msgid "options set attributes of a passed-in object" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1313 +#: distutils/apiref.rst:1313 msgid "" "boolean options can have \"negative aliases\" --- eg. if :option:`--quiet` " "is the \"negative alias\" of :option:`--verbose`, then :option:`--quiet` on " "the command line sets *verbose* to false." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1320 +#: distutils/apiref.rst:1320 msgid "" "Wrapper function. *options* is a list of ``(long_option, short_option, " "help_string)`` 3-tuples as described in the constructor for :class:" @@ -1846,17 +1842,17 @@ msgid "" "list. Will use ``sys.argv[1:]`` if you pass ``None`` as *args*." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1331 +#: distutils/apiref.rst:1331 msgid "Wraps *text* to less than *width* wide." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1337 +#: distutils/apiref.rst:1337 msgid "" "The option_table is a list of 3-tuples: ``(long_option, short_option, " "help_string)``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1340 +#: distutils/apiref.rst:1340 msgid "" "If an option takes an argument, its *long_option* should have ``'='`` " "appended; *short_option* should just be a single character, no ``':'`` in " @@ -1864,15 +1860,15 @@ msgid "" "a corresponding *short_option*. All option tuples must have long options." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1345 +#: distutils/apiref.rst:1345 msgid "The :class:`FancyGetopt` class provides the following methods:" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1350 +#: distutils/apiref.rst:1350 msgid "Parse command-line options in args. Store as attributes on *object*." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1352 +#: distutils/apiref.rst:1352 msgid "" "If *args* is ``None`` or not supplied, uses ``sys.argv[1:]``. If *object* " "is ``None`` or not supplied, creates a new :class:`OptionDummy` instance, " @@ -1882,42 +1878,42 @@ msgid "" "passed-in *args* list, which is left untouched." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1364 +#: distutils/apiref.rst:1364 msgid "" "Returns the list of ``(option, value)`` tuples processed by the previous run " "of :meth:`getopt` Raises :exc:`RuntimeError` if :meth:`getopt` hasn't been " "called yet." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1371 +#: distutils/apiref.rst:1371 msgid "" "Generate help text (a list of strings, one per suggested line of output) " "from the option table for this :class:`FancyGetopt` object." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1374 +#: distutils/apiref.rst:1374 msgid "If supplied, prints the supplied *header* at the top of the help." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1378 +#: distutils/apiref.rst:1378 msgid ":mod:`distutils.filelist` --- The FileList class" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1385 +#: distutils/apiref.rst:1385 msgid "" "This module provides the :class:`FileList` class, used for poking about the " "filesystem and building lists of files." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1390 +#: distutils/apiref.rst:1390 msgid ":mod:`distutils.log` --- Simple PEP 282-style logging" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1397 +#: distutils/apiref.rst:1397 msgid ":mod:`distutils.spawn` --- Spawn a sub-process" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1403 +#: distutils/apiref.rst:1403 msgid "" "This module provides the :func:`spawn` function, a front-end to various " "platform-specific functions for launching another program in a sub-process. " @@ -1925,11 +1921,11 @@ msgid "" "executable name." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1410 +#: distutils/apiref.rst:1410 msgid ":mod:`distutils.sysconfig` --- System configuration information" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1419 +#: distutils/apiref.rst:1419 msgid "" "The :mod:`distutils.sysconfig` module provides access to Python's low-level " "configuration information. The specific configuration variables available " @@ -1941,27 +1937,27 @@ msgid "" "and :file:`config.h` for earlier versions of Python." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1428 +#: distutils/apiref.rst:1428 msgid "" "Some additional functions are provided which perform some useful " "manipulations for other parts of the :mod:`distutils` package." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1434 +#: distutils/apiref.rst:1434 msgid "The result of ``os.path.normpath(sys.prefix)``." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1439 +#: distutils/apiref.rst:1439 msgid "The result of ``os.path.normpath(sys.exec_prefix)``." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1444 +#: distutils/apiref.rst:1444 msgid "" "Return the value of a single variable. This is equivalent to " "``get_config_vars().get(name)``." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1450 +#: distutils/apiref.rst:1450 msgid "" "Return a set of variable definitions. If there are no arguments, this " "returns a dictionary mapping names of configuration variables to values. If " @@ -1970,7 +1966,7 @@ msgid "" "corresponding value, ``None`` will be included for that variable." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1459 +#: distutils/apiref.rst:1459 msgid "" "Return the full path name of the configuration header. For Unix, this will " "be the header generated by the :program:`configure` script; for other " @@ -1978,7 +1974,7 @@ msgid "" "distribution. The file is a platform-specific text file." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1467 +#: distutils/apiref.rst:1467 msgid "" "Return the full path name of the :file:`Makefile` used to build Python. For " "Unix, this will be a file generated by the :program:`configure` script; the " @@ -1986,7 +1982,7 @@ msgid "" "file, if it exists. This function is only useful on POSIX platforms." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1475 +#: distutils/apiref.rst:1475 msgid "" "Return the directory for either the general or platform-dependent C include " "files. If *plat_specific* is true, the platform-dependent include directory " @@ -1996,7 +1992,7 @@ msgid "" "*plat_specific* is true." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1485 +#: distutils/apiref.rst:1485 msgid "" "Return the directory for either the general or platform-dependent library " "installation. If *plat_specific* is true, the platform-dependent include " @@ -2008,19 +2004,19 @@ msgid "" "the installation of third-party extensions." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1494 +#: distutils/apiref.rst:1494 msgid "" "The following function is only intended for use within the :mod:`distutils` " "package." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1500 +#: distutils/apiref.rst:1500 msgid "" "Do any platform-specific customization of a :class:`distutils.ccompiler." "CCompiler` instance." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1503 +#: distutils/apiref.rst:1503 msgid "" "This function is only needed on Unix at this time, but should be called " "consistently to support forward-compatibility. It inserts the information " @@ -2029,13 +2025,13 @@ msgid "" "options, and the extension used by the linker for shared objects." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1509 +#: distutils/apiref.rst:1509 msgid "" "This function is even more special-purpose, and should only be used from " "Python's own build procedures." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1515 +#: distutils/apiref.rst:1515 msgid "" "Inform the :mod:`distutils.sysconfig` module that it is being used as part " "of the build process for Python. This changes a lot of relative locations " @@ -2043,18 +2039,18 @@ msgid "" "installed Python." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1522 +#: distutils/apiref.rst:1522 msgid ":mod:`distutils.text_file` --- The TextFile class" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1528 +#: distutils/apiref.rst:1528 msgid "" "This module provides the :class:`TextFile` class, which gives an interface " "to text files that (optionally) takes care of stripping comments, ignoring " "blank lines, and joining lines with backslashes." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1535 +#: distutils/apiref.rst:1535 msgid "" "This class provides a file-like object that takes care of all the things " "you commonly want to do when processing a text file that has some line-by-" @@ -2064,7 +2060,7 @@ msgid "" "optional and independently controllable." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1542 +#: distutils/apiref.rst:1542 msgid "" "The class provides a :meth:`warn` method so you can generate warning " "messages that report physical line number, even if the logical line in " @@ -2072,7 +2068,7 @@ msgid "" "for implementing line-at-a-time lookahead." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1547 +#: distutils/apiref.rst:1547 msgid "" ":class:`TextFile` instances are create with either *filename*, *file*, or " "both. :exc:`RuntimeError` is raised if both are ``None``. *filename* should " @@ -2083,63 +2079,63 @@ msgid "" "using the :func:`open` built-in function." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1555 +#: distutils/apiref.rst:1555 msgid "" "The options are all boolean, and affect the values returned by :meth:" "`readline`" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1560 +#: distutils/apiref.rst:1560 msgid "option name" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1560 +#: distutils/apiref.rst:1560 msgid "default" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1562 +#: distutils/apiref.rst:1562 msgid "*strip_comments*" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1562 +#: distutils/apiref.rst:1562 msgid "" "strip from ``'#'`` to end-of- line, as well as any whitespace leading up to " "the ``'#'``\\ ---unless it is escaped by a backslash" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1562 ../src/Doc/distutils/apiref.rst:1571 -#: ../src/Doc/distutils/apiref.rst:1576 +#: distutils/apiref.rst:1562 distutils/apiref.rst:1571 +#: distutils/apiref.rst:1576 msgid "true" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1568 +#: distutils/apiref.rst:1568 msgid "*lstrip_ws*" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1568 +#: distutils/apiref.rst:1568 msgid "strip leading whitespace from each line before returning it" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1568 ../src/Doc/distutils/apiref.rst:1586 -#: ../src/Doc/distutils/apiref.rst:1597 +#: distutils/apiref.rst:1568 distutils/apiref.rst:1586 +#: distutils/apiref.rst:1597 msgid "false" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1571 +#: distutils/apiref.rst:1571 msgid "*rstrip_ws*" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1571 +#: distutils/apiref.rst:1571 msgid "" "strip trailing whitespace (including line terminator!) from each line before " "returning it." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1576 +#: distutils/apiref.rst:1576 msgid "*skip_blanks*" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1576 +#: distutils/apiref.rst:1576 msgid "" "skip lines that are empty \\*after\\* stripping comments and whitespace. " "(If both lstrip_ws and rstrip_ws are false, then some lines may consist of " @@ -2147,11 +2143,11 @@ msgid "" "true.)" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1586 +#: distutils/apiref.rst:1586 msgid "*join_lines*" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1586 +#: distutils/apiref.rst:1586 msgid "" "if a backslash is the last non-newline character on a line after stripping " "comments and whitespace, join the following line to it to form one logical " @@ -2159,17 +2155,17 @@ msgid "" "will be joined to form one logical line." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1597 +#: distutils/apiref.rst:1597 msgid "*collapse_join*" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1597 +#: distutils/apiref.rst:1597 msgid "" "strip leading whitespace from lines that are joined to their predecessor; " "only matters if ``(join_lines and not lstrip_ws)``" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1604 +#: distutils/apiref.rst:1604 msgid "" "Note that since *rstrip_ws* can strip the trailing newline, the semantics " "of :meth:`readline` must differ from those of the built-in file object's :" @@ -2178,19 +2174,19 @@ msgid "" "whitespace line), if *rstrip_ws* is true but *skip_blanks* is not." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1613 +#: distutils/apiref.rst:1613 msgid "" "Open a new file *filename*. This overrides any *file* or *filename* " "constructor arguments." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1619 +#: distutils/apiref.rst:1619 msgid "" "Close the current file and forget everything we know about it (including the " "filename and the current line number)." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1625 +#: distutils/apiref.rst:1625 msgid "" "Print (to stderr) a warning message tied to the current logical line in the " "current file. If the current logical line in the file spans multiple " @@ -2200,7 +2196,7 @@ msgid "" "for a single physical line." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1635 +#: distutils/apiref.rst:1635 msgid "" "Read and return a single logical line from the current file (or from an " "internal buffer if lines have previously been \"unread\" with :meth:" @@ -2212,13 +2208,13 @@ msgid "" "*strip_blanks* is not." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1646 +#: distutils/apiref.rst:1646 msgid "" "Read and return the list of all logical lines remaining in the current file. " "This updates the current line number to the last line of the file." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1652 +#: distutils/apiref.rst:1652 msgid "" "Push *line* (a string) onto an internal buffer that will be checked by " "future :meth:`readline` calls. Handy for implementing a parser with line-at-" @@ -2229,20 +2225,20 @@ msgid "" "returned most in most recent first order." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1661 +#: distutils/apiref.rst:1661 msgid ":mod:`distutils.version` --- Version number classes" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1676 +#: distutils/apiref.rst:1676 msgid ":mod:`distutils.cmd` --- Abstract base class for Distutils commands" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1683 +#: distutils/apiref.rst:1683 msgid "This module supplies the abstract base class :class:`Command`." msgstr "" # a836cab6006e4200b0a815ae1b558a75 -#: ../src/Doc/distutils/apiref.rst:1688 +#: distutils/apiref.rst:1688 msgid "" "Abstract base class for defining command classes, the \"worker bees\" of the " "Distutils. A useful analogy for command classes is to think of them as " @@ -2258,23 +2254,23 @@ msgid "" "command class." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1701 +#: distutils/apiref.rst:1701 #, fuzzy msgid "" "The class constructor takes a single argument *dist*, a :class:`~distutils." "core.Distribution` instance." msgstr "Une sous classe de :class:`distutils.core.Distribution`" -#: ../src/Doc/distutils/apiref.rst:1706 +#: distutils/apiref.rst:1706 msgid "Creating a new Distutils command" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1708 +#: distutils/apiref.rst:1708 msgid "This section outlines the steps to create a new Distutils command." msgstr "" # 56aebd00420f4ba08b4c961e8560019c -#: ../src/Doc/distutils/apiref.rst:1710 +#: distutils/apiref.rst:1710 msgid "" "A new command lives in a module in the :mod:`distutils.command` package. " "There is a sample template in that directory called :file:" @@ -2287,11 +2283,11 @@ msgid "" "class:`peel_banana`, a subclass of :class:`distutils.cmd.Command`." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1720 +#: distutils/apiref.rst:1720 msgid "Subclasses of :class:`Command` must define the following methods." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1724 +#: distutils/apiref.rst:1724 msgid "" "Set default values for all the options that this command supports. Note " "that these defaults may be overridden by other commands, by the setup " @@ -2302,7 +2298,7 @@ msgid "" msgstr "" # 25cda4c256594beab16954960e29ad6b -#: ../src/Doc/distutils/apiref.rst:1733 +#: distutils/apiref.rst:1733 msgid "" "Set final values for all the options that this command supports. This is " "always called as late as possible, ie. after any option assignments from " @@ -2312,7 +2308,7 @@ msgid "" "was assigned in :meth:`initialize_options`." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1743 +#: distutils/apiref.rst:1743 msgid "" "A command's raison d'etre: carry out the action it exists to perform, " "controlled by the options initialized in :meth:`initialize_options`, " @@ -2322,7 +2318,7 @@ msgid "" msgstr "" # e69694bcecd14c478c77eee92006da2e -#: ../src/Doc/distutils/apiref.rst:1752 +#: distutils/apiref.rst:1752 msgid "" "*sub_commands* formalizes the notion of a \"family\" of commands, e.g. " "``install`` as the parent with sub-commands ``install_lib``, " @@ -2337,41 +2333,41 @@ msgid "" msgstr "" # bb576a6a44e34a89b80c4cf87f2a80fe -#: ../src/Doc/distutils/apiref.rst:1763 +#: distutils/apiref.rst:1763 msgid "" "*sub_commands* is usually defined at the *end* of a class, because " "predicates can be methods of the class, so they must already have been " "defined. The canonical example is the :command:`install` command." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1769 +#: distutils/apiref.rst:1769 msgid ":mod:`distutils.command` --- Individual Distutils commands" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1780 +#: distutils/apiref.rst:1780 msgid ":mod:`distutils.command.bdist` --- Build a binary installer" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1790 +#: distutils/apiref.rst:1790 msgid "" ":mod:`distutils.command.bdist_packager` --- Abstract base class for packagers" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1800 +#: distutils/apiref.rst:1800 msgid ":mod:`distutils.command.bdist_dumb` --- Build a \"dumb\" installer" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1810 +#: distutils/apiref.rst:1810 msgid "" ":mod:`distutils.command.bdist_msi` --- Build a Microsoft Installer binary " "package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1817 +#: distutils/apiref.rst:1817 msgid "Builds a `Windows Installer`_ (.msi) binary package." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1821 +#: distutils/apiref.rst:1821 msgid "" "In most cases, the ``bdist_msi`` installer is a better choice than the " "``bdist_wininst`` installer, because it provides better support for Win64 " @@ -2379,50 +2375,50 @@ msgid "" "and allows installation through group policies." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1828 +#: distutils/apiref.rst:1828 msgid "" ":mod:`distutils.command.bdist_rpm` --- Build a binary distribution as a " "Redhat RPM and SRPM" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1838 +#: distutils/apiref.rst:1838 msgid ":mod:`distutils.command.bdist_wininst` --- Build a Windows installer" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1848 +#: distutils/apiref.rst:1848 msgid ":mod:`distutils.command.sdist` --- Build a source distribution" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1858 +#: distutils/apiref.rst:1858 msgid ":mod:`distutils.command.build` --- Build all files of a package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1868 +#: distutils/apiref.rst:1868 msgid "" ":mod:`distutils.command.build_clib` --- Build any C libraries in a package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1878 +#: distutils/apiref.rst:1878 msgid "" ":mod:`distutils.command.build_ext` --- Build any extensions in a package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1888 +#: distutils/apiref.rst:1888 msgid "" ":mod:`distutils.command.build_py` --- Build the .py/.pyc files of a package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1895 +#: distutils/apiref.rst:1895 msgid "" ":mod:`distutils.command.build_scripts` --- Build the scripts of a package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1905 +#: distutils/apiref.rst:1905 msgid ":mod:`distutils.command.clean` --- Clean a package build area" msgstr "" # eef3fa12623745ea9916bb310ca2b530 -#: ../src/Doc/distutils/apiref.rst:1910 +#: distutils/apiref.rst:1910 msgid "" "This command removes the temporary files created by :command:`build` and its " "subcommands, like intermediary compiled object files. With the ``--all`` " @@ -2430,72 +2426,72 @@ msgid "" msgstr "" # b33f97c69c8e4b64817fa64052b3be30 -#: ../src/Doc/distutils/apiref.rst:1914 +#: distutils/apiref.rst:1914 msgid "" "Extension modules built :ref:`in place ` will " "not be cleaned, as they are not in the build directory." msgstr "" -#: ../src/Doc/distutils/apiref.rst:1919 +#: distutils/apiref.rst:1919 msgid ":mod:`distutils.command.config` --- Perform package configuration" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1929 +#: distutils/apiref.rst:1929 msgid ":mod:`distutils.command.install` --- Install a package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1939 +#: distutils/apiref.rst:1939 msgid "" ":mod:`distutils.command.install_data` --- Install data files from a package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1949 +#: distutils/apiref.rst:1949 msgid "" ":mod:`distutils.command.install_headers` --- Install C/C++ header files from " "a package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1959 +#: distutils/apiref.rst:1959 msgid "" ":mod:`distutils.command.install_lib` --- Install library files from a package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1969 +#: distutils/apiref.rst:1969 msgid "" ":mod:`distutils.command.install_scripts` --- Install script files from a " "package" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1979 +#: distutils/apiref.rst:1979 msgid "" ":mod:`distutils.command.register` --- Register a module with the Python " "Package Index" msgstr "" -#: ../src/Doc/distutils/apiref.rst:1985 +#: distutils/apiref.rst:1985 msgid "" "The ``register`` command registers the package with the Python Package " "Index. This is described in more detail in :pep:`301`." msgstr "" # 863294624cdf45099fc9e56d5597240a -#: ../src/Doc/distutils/apiref.rst:1992 +#: distutils/apiref.rst:1992 msgid ":mod:`distutils.command.check` --- Check the meta-data of a package" msgstr "" # 35e66c2ad8ff4914b8aed6d74335e78d -#: ../src/Doc/distutils/apiref.rst:1998 +#: distutils/apiref.rst:1998 msgid "" "The ``check`` command performs some tests on the meta-data of a package. For " "example, it verifies that all required meta-data are provided as the " "arguments passed to the :func:`setup` function." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:5 +#: distutils/builtdist.rst:5 msgid "Creating Built Distributions" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:7 +#: distutils/builtdist.rst:7 msgid "" "A \"built distribution\" is what you're probably used to thinking of either " "as a \"binary package\" or an \"installer\" (depending on your background). " @@ -2505,7 +2501,7 @@ msgid "" "to the world of mainstream desktop systems.)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:14 +#: distutils/builtdist.rst:14 msgid "" "A built distribution is how you make life as easy as possible for installers " "of your module distribution: for users of RPM-based Linux systems, it's a " @@ -2519,7 +2515,7 @@ msgid "" "as there are packagers." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:24 +#: distutils/builtdist.rst:24 msgid "" "Of course, the module developer could be his own packager; or the packager " "could be a volunteer \"out there\" somewhere who has access to a platform " @@ -2530,13 +2526,13 @@ msgid "" "family to generate built distributions." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:32 +#: distutils/builtdist.rst:32 msgid "" "As a simple example, if I run the following command in the Distutils source " "tree::" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:37 +#: distutils/builtdist.rst:37 msgid "" "then the Distutils builds my module distribution (the Distutils itself in " "this case), does a \"fake\" installation (also in the :file:`build` " @@ -2547,7 +2543,7 @@ msgid "" "work.)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:44 +#: distutils/builtdist.rst:44 msgid "" "Thus, the above command on a Unix system creates :file:`Distutils-1.0.{plat}." "tar.gz`; unpacking this tarball from the right place installs the Distutils " @@ -2558,7 +2554,7 @@ msgid "" "distributions relative to :file:`{prefix}`.)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:52 +#: distutils/builtdist.rst:52 msgid "" "Obviously, for pure Python distributions, this isn't any simpler than just " "running ``python setup.py install``\\ ---but for non-pure distributions, " @@ -2569,177 +2565,165 @@ msgid "" "your distribution doesn't include any extensions." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:60 +#: distutils/builtdist.rst:60 msgid "" "The :command:`bdist` command has a :option:`--formats` option, similar to " "the :command:`sdist` command, which you can use to select the types of built " "distribution to generate: for example, ::" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:66 +#: distutils/builtdist.rst:66 msgid "" "would, when run on a Unix system, create :file:`Distutils-1.0.{plat}.zip`\\ " "---again, this archive would be unpacked from the root directory to install " "the Distutils." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:70 +#: distutils/builtdist.rst:70 msgid "The available formats for built distributions are:" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:73 ../src/Doc/distutils/sourcedist.rst:25 +#: distutils/builtdist.rst:73 distutils/sourcedist.rst:25 msgid "Format" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:73 -#: ../src/Doc/distutils/setupscript.rst:559 -#: ../src/Doc/distutils/sourcedist.rst:25 -#: ../src/Doc/distutils/sourcedist.rst:252 +#: distutils/builtdist.rst:73 distutils/setupscript.rst:559 +#: distutils/sourcedist.rst:25 distutils/sourcedist.rst:252 msgid "Description" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:73 -#: ../src/Doc/distutils/setupscript.rst:559 -#: ../src/Doc/distutils/sourcedist.rst:25 +#: distutils/builtdist.rst:73 distutils/setupscript.rst:559 +#: distutils/sourcedist.rst:25 msgid "Notes" msgstr "Notes" -#: ../src/Doc/distutils/builtdist.rst:75 ../src/Doc/distutils/sourcedist.rst:29 +#: distutils/builtdist.rst:75 distutils/sourcedist.rst:29 msgid "``gztar``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:75 +#: distutils/builtdist.rst:75 msgid "gzipped tar file (:file:`.tar.gz`)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:75 ../src/Doc/distutils/sourcedist.rst:27 +#: distutils/builtdist.rst:75 distutils/sourcedist.rst:27 msgid "(1),(3)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:78 ../src/Doc/distutils/sourcedist.rst:35 +#: distutils/builtdist.rst:78 distutils/sourcedist.rst:35 msgid "``ztar``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:78 ../src/Doc/distutils/sourcedist.rst:35 +#: distutils/builtdist.rst:78 distutils/sourcedist.rst:35 msgid "compressed tar file (:file:`.tar.Z`)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:78 ../src/Doc/distutils/builtdist.rst:81 -#: ../src/Doc/distutils/setupscript.rst:565 -#: ../src/Doc/distutils/setupscript.rst:567 -#: ../src/Doc/distutils/setupscript.rst:570 -#: ../src/Doc/distutils/setupscript.rst:572 +#: distutils/builtdist.rst:78 distutils/builtdist.rst:81 +#: distutils/setupscript.rst:565 distutils/setupscript.rst:567 +#: distutils/setupscript.rst:570 distutils/setupscript.rst:572 msgid "\\(3)" msgstr "\\(3)" -#: ../src/Doc/distutils/builtdist.rst:81 ../src/Doc/distutils/sourcedist.rst:38 +#: distutils/builtdist.rst:81 distutils/sourcedist.rst:38 msgid "``tar``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:81 ../src/Doc/distutils/sourcedist.rst:38 +#: distutils/builtdist.rst:81 distutils/sourcedist.rst:38 msgid "tar file (:file:`.tar`)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:83 ../src/Doc/distutils/sourcedist.rst:27 +#: distutils/builtdist.rst:83 distutils/sourcedist.rst:27 msgid "``zip``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:83 ../src/Doc/distutils/sourcedist.rst:27 +#: distutils/builtdist.rst:83 distutils/sourcedist.rst:27 msgid "zip file (:file:`.zip`)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:83 +#: distutils/builtdist.rst:83 msgid "(2),(4)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:85 +#: distutils/builtdist.rst:85 msgid "``rpm``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:85 +#: distutils/builtdist.rst:85 msgid "RPM" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:85 -#: ../src/Doc/distutils/setupscript.rst:581 +#: distutils/builtdist.rst:85 distutils/setupscript.rst:581 msgid "\\(5)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:87 +#: distutils/builtdist.rst:87 msgid "``pkgtool``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:87 +#: distutils/builtdist.rst:87 msgid "Solaris :program:`pkgtool`" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:89 +#: distutils/builtdist.rst:89 msgid "``sdux``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:89 +#: distutils/builtdist.rst:89 msgid "HP-UX :program:`swinstall`" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:91 +#: distutils/builtdist.rst:91 msgid "``wininst``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:91 +#: distutils/builtdist.rst:91 msgid "self-extracting ZIP file for Windows" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:91 -#: ../src/Doc/distutils/setupscript.rst:584 -#: ../src/Doc/distutils/setupscript.rst:587 -#: ../src/Doc/distutils/sourcedist.rst:35 +#: distutils/builtdist.rst:91 distutils/setupscript.rst:584 +#: distutils/setupscript.rst:587 distutils/sourcedist.rst:35 msgid "\\(4)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:94 +#: distutils/builtdist.rst:94 msgid "``msi``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:94 +#: distutils/builtdist.rst:94 msgid "Microsoft Installer." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:98 -#: ../src/Doc/distutils/setupscript.rst:594 -#: ../src/Doc/distutils/sourcedist.rst:41 +#: distutils/builtdist.rst:98 distutils/setupscript.rst:594 +#: distutils/sourcedist.rst:41 msgid "Notes:" msgstr "Notes : " -#: ../src/Doc/distutils/builtdist.rst:101 -#: ../src/Doc/distutils/sourcedist.rst:47 +#: distutils/builtdist.rst:101 distutils/sourcedist.rst:47 msgid "default on Unix" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:104 -#: ../src/Doc/distutils/sourcedist.rst:44 +#: distutils/builtdist.rst:104 distutils/sourcedist.rst:44 msgid "default on Windows" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:107 +#: distutils/builtdist.rst:107 msgid "" "requires external utilities: :program:`tar` and possibly one of :program:" "`gzip`, :program:`bzip2`, or :program:`compress`" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:111 -#: ../src/Doc/distutils/sourcedist.rst:50 +#: distutils/builtdist.rst:111 distutils/sourcedist.rst:50 msgid "" "requires either external :program:`zip` utility or :mod:`zipfile` module " "(part of the standard Python library since Python 1.6)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:115 +#: distutils/builtdist.rst:115 msgid "" "requires external :program:`rpm` utility, version 3.0.4 or better (use ``rpm " "--version`` to find out which version you have)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:118 +#: distutils/builtdist.rst:118 msgid "" "You don't have to use the :command:`bdist` command with the :option:`--" "formats` option; you can also use the command that directly implements the " @@ -2751,62 +2735,61 @@ msgid "" "generated by each, are:" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:127 -#: ../src/Doc/distutils/sourcedist.rst:252 +#: distutils/builtdist.rst:127 distutils/sourcedist.rst:252 msgid "Command" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:127 +#: distutils/builtdist.rst:127 msgid "Formats" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:129 +#: distutils/builtdist.rst:129 msgid ":command:`bdist_dumb`" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:129 +#: distutils/builtdist.rst:129 msgid "tar, ztar, gztar, zip" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:131 +#: distutils/builtdist.rst:131 msgid ":command:`bdist_rpm`" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:131 +#: distutils/builtdist.rst:131 msgid "rpm, srpm" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:133 +#: distutils/builtdist.rst:133 msgid ":command:`bdist_wininst`" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:133 +#: distutils/builtdist.rst:133 msgid "wininst" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:135 +#: distutils/builtdist.rst:135 msgid ":command:`bdist_msi`" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:135 +#: distutils/builtdist.rst:135 msgid "msi" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:138 +#: distutils/builtdist.rst:138 msgid "" "The following sections give details on the individual :command:`bdist_\\*` " "commands." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:145 +#: distutils/builtdist.rst:145 msgid "Creating dumb built distributions" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:154 +#: distutils/builtdist.rst:154 msgid "Creating RPM packages" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:156 +#: distutils/builtdist.rst:156 msgid "" "The RPM format is used by many popular Linux distributions, including Red " "Hat, SuSE, and Mandrake. If one of these (or any of the other RPM-based " @@ -2817,17 +2800,17 @@ msgid "" "RPM-based distributions." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:163 +#: distutils/builtdist.rst:163 msgid "" "The usual way to create an RPM of your module distribution is to run the :" "command:`bdist_rpm` command::" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:168 +#: distutils/builtdist.rst:168 msgid "or the :command:`bdist` command with the :option:`--format` option::" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:172 +#: distutils/builtdist.rst:172 msgid "" "The former allows you to specify RPM-specific options; the latter allows " "you to easily specify multiple formats in one run. If you need to do both, " @@ -2835,7 +2818,7 @@ msgid "" "options::" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:179 +#: distutils/builtdist.rst:179 msgid "" "Creating RPM packages is driven by a :file:`.spec` file, much as using the " "Distutils is driven by the setup script. To make your life easier, the :" @@ -2845,215 +2828,203 @@ msgid "" "file:`.spec` file are derived from options in the setup script as follows:" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:187 -#: ../src/Doc/distutils/builtdist.rst:211 +#: distutils/builtdist.rst:187 distutils/builtdist.rst:211 msgid "RPM :file:`.spec` file option or section" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:187 +#: distutils/builtdist.rst:187 msgid "Distutils setup script option" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:189 +#: distutils/builtdist.rst:189 msgid "Name" msgstr "Nom" -#: ../src/Doc/distutils/builtdist.rst:189 -#: ../src/Doc/distutils/setupscript.rst:561 +#: distutils/builtdist.rst:189 distutils/setupscript.rst:561 msgid "``name``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:191 +#: distutils/builtdist.rst:191 msgid "Summary (in preamble)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:191 -#: ../src/Doc/distutils/setupscript.rst:577 +#: distutils/builtdist.rst:191 distutils/setupscript.rst:577 msgid "``description``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:193 +#: distutils/builtdist.rst:193 msgid "Version" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:193 -#: ../src/Doc/distutils/setupscript.rst:563 +#: distutils/builtdist.rst:193 distutils/setupscript.rst:563 msgid "``version``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:195 -#: ../src/Doc/distutils/builtdist.rst:218 +#: distutils/builtdist.rst:195 distutils/builtdist.rst:218 msgid "Vendor" msgstr "" # 17fd4349a9d844bd9053bd348030b744 -#: ../src/Doc/distutils/builtdist.rst:195 +#: distutils/builtdist.rst:195 msgid "" "``author`` and ``author_email``, or --- & ``maintainer`` and " "``maintainer_email``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:199 +#: distutils/builtdist.rst:199 msgid "Copyright" msgstr "Copyright" -#: ../src/Doc/distutils/builtdist.rst:199 -#: ../src/Doc/distutils/setupscript.rst:591 +#: distutils/builtdist.rst:199 distutils/setupscript.rst:591 msgid "``license``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:201 +#: distutils/builtdist.rst:201 msgid "Url" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:201 -#: ../src/Doc/distutils/setupscript.rst:575 +#: distutils/builtdist.rst:201 distutils/setupscript.rst:575 msgid "``url``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:203 +#: distutils/builtdist.rst:203 msgid "%description (section)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:203 -#: ../src/Doc/distutils/setupscript.rst:581 +#: distutils/builtdist.rst:203 distutils/setupscript.rst:581 msgid "``long_description``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:206 +#: distutils/builtdist.rst:206 msgid "" "Additionally, there are many options in :file:`.spec` files that don't have " "corresponding options in the setup script. Most of these are handled " "through options to the :command:`bdist_rpm` command as follows:" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:211 +#: distutils/builtdist.rst:211 msgid ":command:`bdist_rpm` option" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:211 +#: distutils/builtdist.rst:211 msgid "default value" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:214 +#: distutils/builtdist.rst:214 msgid "Release" msgstr "Publication" # 1dfa57af80f7454485dbd69c3fe1dc1b -#: ../src/Doc/distutils/builtdist.rst:214 +#: distutils/builtdist.rst:214 msgid "``release``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:214 +#: distutils/builtdist.rst:214 msgid "\"1\"" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:216 +#: distutils/builtdist.rst:216 msgid "Group" msgstr "" # 266e4a4475844c2bb3d26b3adfc6ce08 -#: ../src/Doc/distutils/builtdist.rst:216 +#: distutils/builtdist.rst:216 msgid "``group``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:216 +#: distutils/builtdist.rst:216 msgid "\"Development/Libraries\"" msgstr "" # b7d80a4ac27b4dc9949dd2e56251ffd1 -#: ../src/Doc/distutils/builtdist.rst:218 +#: distutils/builtdist.rst:218 msgid "``vendor``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:218 +#: distutils/builtdist.rst:218 msgid "(see above)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:220 +#: distutils/builtdist.rst:220 msgid "Packager" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:220 +#: distutils/builtdist.rst:220 #, fuzzy msgid "``packager``" msgstr "*packages*" -#: ../src/Doc/distutils/builtdist.rst:220 -#: ../src/Doc/distutils/builtdist.rst:222 -#: ../src/Doc/distutils/builtdist.rst:224 -#: ../src/Doc/distutils/builtdist.rst:226 -#: ../src/Doc/distutils/builtdist.rst:228 -#: ../src/Doc/distutils/builtdist.rst:230 -#: ../src/Doc/distutils/builtdist.rst:232 -#: ../src/Doc/distutils/builtdist.rst:234 +#: distutils/builtdist.rst:220 distutils/builtdist.rst:222 +#: distutils/builtdist.rst:224 distutils/builtdist.rst:226 +#: distutils/builtdist.rst:228 distutils/builtdist.rst:230 +#: distutils/builtdist.rst:232 distutils/builtdist.rst:234 msgid "(none)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:222 +#: distutils/builtdist.rst:222 msgid "Provides" msgstr "" # c6f1e772650349dea58ad32696b00aa6 -#: ../src/Doc/distutils/builtdist.rst:222 +#: distutils/builtdist.rst:222 msgid "``provides``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:224 +#: distutils/builtdist.rst:224 msgid "Requires" msgstr "" # 70fe6e062ea74530ac78988cedda4943 -#: ../src/Doc/distutils/builtdist.rst:224 +#: distutils/builtdist.rst:224 msgid "``requires``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:226 +#: distutils/builtdist.rst:226 msgid "Conflicts" msgstr "" # 2d5441e32fda441a8af21a6a56666f70 -#: ../src/Doc/distutils/builtdist.rst:226 +#: distutils/builtdist.rst:226 msgid "``conflicts``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:228 +#: distutils/builtdist.rst:228 msgid "Obsoletes" msgstr "" # fd61587b321b4950ac227ac74713a328 -#: ../src/Doc/distutils/builtdist.rst:228 +#: distutils/builtdist.rst:228 msgid "``obsoletes``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:230 +#: distutils/builtdist.rst:230 msgid "Distribution" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:230 +#: distutils/builtdist.rst:230 #, fuzzy msgid "``distribution_name``" msgstr "description" -#: ../src/Doc/distutils/builtdist.rst:232 +#: distutils/builtdist.rst:232 msgid "BuildRequires" msgstr "" # 54760b105805470abee2e8c72cb25202 -#: ../src/Doc/distutils/builtdist.rst:232 +#: distutils/builtdist.rst:232 msgid "``build_requires``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:234 +#: distutils/builtdist.rst:234 msgid "Icon" msgstr "" # 1c9e1df1aefa4ed9974eabd2ac5b5acf -#: ../src/Doc/distutils/builtdist.rst:234 +#: distutils/builtdist.rst:234 msgid "``icon``" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:237 +#: distutils/builtdist.rst:237 msgid "" "Obviously, supplying even a few of these options on the command-line would " "be tedious and error-prone, so it's usually best to put them in the setup " @@ -3064,36 +3035,36 @@ msgid "" "disable this file, you can pass the --no-user-cfg option to setup.py." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:245 +#: distutils/builtdist.rst:245 msgid "" "There are three steps to building a binary RPM package, all of which are " "handled automatically by the Distutils:" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:248 +#: distutils/builtdist.rst:248 msgid "" "create a :file:`.spec` file, which describes the package (analogous to the " "Distutils setup script; in fact, much of the information in the setup " "script winds up in the :file:`.spec` file)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:252 +#: distutils/builtdist.rst:252 msgid "create the source RPM" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:254 +#: distutils/builtdist.rst:254 msgid "" "create the \"binary\" RPM (which may or may not contain binary code, " "depending on whether your module distribution contains Python extensions)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:257 +#: distutils/builtdist.rst:257 msgid "" "Normally, RPM bundles the last two steps together; when you use the " "Distutils, all three steps are typically bundled together." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:260 +#: distutils/builtdist.rst:260 msgid "" "If you wish, you can separate these three steps. You can use the :option:`--" "spec-only` option to make :command:`bdist_rpm` just create the :file:`.spec` " @@ -3104,11 +3075,11 @@ msgid "" "`bdist_rpm`.)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:288 +#: distutils/builtdist.rst:288 msgid "Creating Windows Installers" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:290 +#: distutils/builtdist.rst:290 msgid "" "Executable installers are the natural format for binary distributions on " "Windows. They display a nice graphical user interface, display some " @@ -3117,17 +3088,17 @@ msgid "" "or cancel the installation." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:296 +#: distutils/builtdist.rst:296 msgid "" "Since the metadata is taken from the setup script, creating Windows " "installers is usually as easy as running::" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:301 +#: distutils/builtdist.rst:301 msgid "or the :command:`bdist` command with the :option:`--formats` option::" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:305 +#: distutils/builtdist.rst:305 msgid "" "If you have a pure module distribution (only containing pure Python modules " "and packages), the resulting installer will be version independent and have " @@ -3135,7 +3106,7 @@ msgid "" "on Unix platforms or Mac OS X." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:310 +#: distutils/builtdist.rst:310 msgid "" "If you have a non-pure distribution, the extensions can only be created on a " "Windows platform, and will be Python version dependent. The installer " @@ -3144,7 +3115,7 @@ msgid "" "want to support." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:316 +#: distutils/builtdist.rst:316 msgid "" "The installer will try to compile pure modules into :term:`bytecode` after " "installation on the target system in normal and optimizing mode. If you " @@ -3153,14 +3124,14 @@ msgid "" "option:`--no-target-optimize` option." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:322 +#: distutils/builtdist.rst:322 msgid "" "By default the installer will display the cool \"Python Powered\" logo when " "it is run, but you can also supply your own 152x261 bitmap which must be a " "Windows :file:`.bmp` file with the :option:`--bitmap` option." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:326 +#: distutils/builtdist.rst:326 msgid "" "The installer will also display a large title on the desktop background " "window when it is run, which is constructed from the name of your " @@ -3168,18 +3139,18 @@ msgid "" "using the :option:`--title` option." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:331 +#: distutils/builtdist.rst:331 msgid "" "The installer file will be written to the \"distribution directory\" --- " "normally :file:`dist/`, but customizable with the :option:`--dist-dir` " "option." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:337 +#: distutils/builtdist.rst:337 msgid "Cross-compiling on Windows" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:339 +#: distutils/builtdist.rst:339 msgid "" "Starting with Python 2.6, distutils is capable of cross-compiling between " "Windows platforms. In practice, this means that with the correct tools " @@ -3187,27 +3158,27 @@ msgid "" "and vice-versa." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:344 +#: distutils/builtdist.rst:344 msgid "" "To build for an alternate platform, specify the :option:`--plat-name` option " "to the build command. Valid values are currently 'win32', 'win-amd64' and " "'win-ia64'. For example, on a 32bit version of Windows, you could execute::" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:350 +#: distutils/builtdist.rst:350 msgid "" "to build a 64bit version of your extension. The Windows Installers also " "support this option, so the command::" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:355 +#: distutils/builtdist.rst:355 msgid "" "would create a 64bit installation executable on your 32bit version of " "Windows." msgstr "" # 5a5f071ee2af4dbd858f2d9e2b10f026 -#: ../src/Doc/distutils/builtdist.rst:357 +#: distutils/builtdist.rst:357 msgid "" "To cross-compile, you must download the Python source code and cross-compile " "Python itself for the platform you are targetting - it is not possible from " @@ -3219,7 +3190,7 @@ msgid "" "is possible." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:366 +#: distutils/builtdist.rst:366 msgid "" "Note that by default, Visual Studio 2008 does not install 64bit compilers or " "tools. You may need to reexecute the Visual Studio setup process and select " @@ -3227,11 +3198,11 @@ msgid "" "to check or modify your existing install.)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:374 +#: distutils/builtdist.rst:374 msgid "The Postinstallation script" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:376 +#: distutils/builtdist.rst:376 msgid "" "Starting with Python 2.3, a postinstallation script can be specified with " "the :option:`--install-script` option. The basename of the script must be " @@ -3239,7 +3210,7 @@ msgid "" "argument to the setup function." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:381 +#: distutils/builtdist.rst:381 msgid "" "This script will be run at installation time on the target system after all " "the files have been copied, with ``argv[1]`` set to :option:`-install`, and " @@ -3247,20 +3218,20 @@ msgid "" "set to :option:`-remove`." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:386 +#: distutils/builtdist.rst:386 msgid "" "The installation script runs embedded in the windows installer, every output " "(``sys.stdout``, ``sys.stderr``) is redirected into a buffer and will be " "displayed in the GUI after the script has finished." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:390 +#: distutils/builtdist.rst:390 msgid "" "Some functions especially useful in this context are available as additional " "built-in functions in the installation script." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:397 +#: distutils/builtdist.rst:397 msgid "" "These functions should be called when a directory or file is created by the " "postinstall script at installation time. It will register *path* with the " @@ -3268,26 +3239,26 @@ msgid "" "uninstalled. To be safe, directories are only removed if they are empty." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:405 +#: distutils/builtdist.rst:405 msgid "" "This function can be used to retrieve special folder locations on Windows " "like the Start Menu or the Desktop. It returns the full path to the folder. " "*csidl_string* must be one of the following strings::" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:425 +#: distutils/builtdist.rst:425 msgid "If the folder cannot be retrieved, :exc:`OSError` is raised." msgstr "" # efa0f3587b2d4f5eb4daf0865dd5c70c -#: ../src/Doc/distutils/builtdist.rst:427 +#: distutils/builtdist.rst:427 msgid "" "Which folders are available depends on the exact Windows version, and " "probably also the configuration. For details refer to Microsoft's " "documentation of the :c:func:`SHGetSpecialFolderPath` function." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:434 +#: distutils/builtdist.rst:434 msgid "" "This function creates a shortcut. *target* is the path to the program to be " "started by the shortcut. *description* is the description of the shortcut. " @@ -3299,11 +3270,11 @@ msgid "" "class:`IShellLink` interface." msgstr "" -#: ../src/Doc/distutils/builtdist.rst:445 +#: distutils/builtdist.rst:445 msgid "Vista User Access Control (UAC)" msgstr "" -#: ../src/Doc/distutils/builtdist.rst:447 +#: distutils/builtdist.rst:447 msgid "" "Starting with Python 2.6, bdist_wininst supports a :option:`--user-access-" "control` option. The default is 'none' (meaning no UAC handling is done), " @@ -3312,42 +3283,42 @@ msgid "" "elevation)." msgstr "" -#: ../src/Doc/distutils/commandref.rst:5 +#: distutils/commandref.rst:5 msgid "Command Reference" msgstr "" -#: ../src/Doc/distutils/commandref.rst:22 +#: distutils/commandref.rst:22 msgid "Installing modules: the :command:`install` command family" msgstr "" -#: ../src/Doc/distutils/commandref.rst:24 +#: distutils/commandref.rst:24 msgid "" "The install command ensures that the build commands have been run and then " "runs the subcommands :command:`install_lib`, :command:`install_data` and :" "command:`install_scripts`." msgstr "" -#: ../src/Doc/distutils/commandref.rst:35 +#: distutils/commandref.rst:35 msgid ":command:`install_data`" msgstr "" -#: ../src/Doc/distutils/commandref.rst:37 +#: distutils/commandref.rst:37 msgid "This command installs all data files provided with the distribution." msgstr "" -#: ../src/Doc/distutils/commandref.rst:43 +#: distutils/commandref.rst:43 msgid ":command:`install_scripts`" msgstr "" -#: ../src/Doc/distutils/commandref.rst:45 +#: distutils/commandref.rst:45 msgid "This command installs all (Python) scripts in the distribution." msgstr "" -#: ../src/Doc/distutils/configfile.rst:5 +#: distutils/configfile.rst:5 msgid "Writing the Setup Configuration File" msgstr "" -#: ../src/Doc/distutils/configfile.rst:7 +#: distutils/configfile.rst:7 msgid "" "Often, it's not possible to write down everything needed to build a " "distribution *a priori*: you may need to get some information from the user, " @@ -3360,7 +3331,7 @@ msgid "" "by editing the config file." msgstr "" -#: ../src/Doc/distutils/configfile.rst:16 +#: distutils/configfile.rst:16 msgid "" "The setup configuration file is a useful middle-ground between the setup " "script ---which, ideally, would be opaque to installers [#]_---and the " @@ -3371,29 +3342,29 @@ msgid "" "has several useful consequences:" msgstr "" -#: ../src/Doc/distutils/configfile.rst:30 +#: distutils/configfile.rst:30 msgid "" "installers can override some of what you put in :file:`setup.py` by editing :" "file:`setup.cfg`" msgstr "" -#: ../src/Doc/distutils/configfile.rst:33 +#: distutils/configfile.rst:33 msgid "" "you can provide non-standard defaults for options that are not easily set " "in :file:`setup.py`" msgstr "" -#: ../src/Doc/distutils/configfile.rst:36 +#: distutils/configfile.rst:36 msgid "" "installers can override anything in :file:`setup.cfg` using the command-line " "options to :file:`setup.py`" msgstr "" -#: ../src/Doc/distutils/configfile.rst:39 +#: distutils/configfile.rst:39 msgid "The basic syntax of the configuration file is simple::" msgstr "" -#: ../src/Doc/distutils/configfile.rst:45 +#: distutils/configfile.rst:45 msgid "" "where *command* is one of the Distutils commands (e.g. :command:`build_py`, :" "command:`install`), and *option* is one of the options that command " @@ -3404,20 +3375,20 @@ msgid "" "by indenting the continuation lines." msgstr "" -#: ../src/Doc/distutils/configfile.rst:53 +#: distutils/configfile.rst:53 msgid "" "You can find out the list of options supported by a particular command with " "the universal :option:`--help` option, e.g. ::" msgstr "" # e0149a95d48e41bb8e58799b3be61dd7 -#: ../src/Doc/distutils/configfile.rst:69 +#: distutils/configfile.rst:69 msgid "" "Note that an option spelled :option:`--foo-bar` on the command-line is " "spelled ``foo_bar`` in configuration files." msgstr "" -#: ../src/Doc/distutils/configfile.rst:74 +#: distutils/configfile.rst:74 msgid "" "For example, say you want your extensions to be built \"in-place\"---that " "is, you have an extension :mod:`pkg.ext`, and you want the compiled " @@ -3427,7 +3398,7 @@ msgid "" "ensure this::" msgstr "" -#: ../src/Doc/distutils/configfile.rst:82 +#: distutils/configfile.rst:82 msgid "" "But this requires that you always specify the :command:`build_ext` command " "explicitly, and remember to provide :option:`--inplace`. An easier way is to " @@ -3435,7 +3406,7 @@ msgid "" "configuration file for this distribution::" msgstr "" -#: ../src/Doc/distutils/configfile.rst:90 +#: distutils/configfile.rst:90 msgid "" "This will affect all builds of this module distribution, whether or not you " "explicitly specify :command:`build_ext`. If you include :file:`setup.cfg` " @@ -3448,7 +3419,7 @@ msgid "" "always a bad idea, though.)" msgstr "" -#: ../src/Doc/distutils/configfile.rst:99 +#: distutils/configfile.rst:99 msgid "" "Another example: certain commands take a lot of options that don't change " "from run to run; for example, :command:`bdist_rpm` needs to know everything " @@ -3461,73 +3432,72 @@ msgid "" msgstr "" # 48238939d1b345f185b509f3203945bc -#: ../src/Doc/distutils/configfile.rst:117 +#: distutils/configfile.rst:117 msgid "" "Note that the ``doc_files`` option is simply a whitespace-separated string " "split across multiple lines for readability." msgstr "" -# 2ca284a78b92452f8d215fd92d40afac -#: ../src/Doc/distutils/configfile.rst:123 -msgid ":ref:`inst-config-syntax` in \"Installing Python Modules\"" -msgstr "" +#: distutils/configfile.rst:124 +#, fuzzy +msgid "inst-config-syntax in \"Installing Python Modules\"" +msgstr "Distribuer des Modules Python [en]" -#: ../src/Doc/distutils/configfile.rst:124 +#: distutils/configfile.rst:124 msgid "" "More information on the configuration files is available in the manual for " "system administrators." msgstr "" -#: ../src/Doc/distutils/configfile.rst:129 +#: distutils/configfile.rst:129 msgid "Footnotes" msgstr "Notes" -#: ../src/Doc/distutils/configfile.rst:130 +#: distutils/configfile.rst:130 msgid "" "This ideal probably won't be achieved until auto-configuration is fully " "supported by the Distutils." msgstr "" -#: ../src/Doc/distutils/examples.rst:5 +#: distutils/examples.rst:5 msgid "Examples" msgstr "" -#: ../src/Doc/distutils/examples.rst:7 +#: distutils/examples.rst:7 msgid "" "This chapter provides a number of basic examples to help get started with " "distutils. Additional information about using distutils can be found in the " "Distutils Cookbook." msgstr "" -# cc804942c5a8454ebbcda212bb887ea7 -#: ../src/Doc/distutils/examples.rst:13 -msgid "`Distutils Cookbook `_" +#: distutils/examples.rst:14 +msgid "Distutils Cookbook" msgstr "" -#: ../src/Doc/distutils/examples.rst:15 +#: distutils/examples.rst:15 msgid "" "Collection of recipes showing how to achieve more control over distutils." msgstr "" -#: ../src/Doc/distutils/examples.rst:21 +#: distutils/examples.rst:21 msgid "Pure Python distribution (by module)" msgstr "" # 7853f124ee9e4c008f5c5999262973e7 -#: ../src/Doc/distutils/examples.rst:23 +#: distutils/examples.rst:23 msgid "" "If you're just distributing a couple of modules, especially if they don't " "live in a particular package, you can specify them individually using the " "``py_modules`` option in the setup script." msgstr "" -#: ../src/Doc/distutils/examples.rst:27 +#: distutils/examples.rst:27 msgid "" "In the simplest case, you'll have two files to worry about: a setup script " "and the single module you're distributing, :file:`foo.py` in this example::" msgstr "" -#: ../src/Doc/distutils/examples.rst:34 +#: distutils/examples.rst:34 msgid "" "(In all diagrams in this section, ** will refer to the distribution " "root directory.) A minimal setup script to describe this situation would " @@ -3535,7 +3505,7 @@ msgid "" msgstr "" # c1ece47233de4dc190f49705bcfe5dbb -#: ../src/Doc/distutils/examples.rst:43 +#: distutils/examples.rst:43 msgid "" "Note that the name of the distribution is specified independently with the " "``name`` option, and there's no rule that says it has to be the same as the " @@ -3545,29 +3515,29 @@ msgid "" msgstr "" # f8fe51f4fb874ccfa0f0e576584d01c0 -#: ../src/Doc/distutils/examples.rst:49 +#: distutils/examples.rst:49 msgid "" "Since ``py_modules`` is a list, you can of course specify multiple modules, " "eg. if you're distributing modules :mod:`foo` and :mod:`bar`, your setup " "might look like this::" msgstr "" -#: ../src/Doc/distutils/examples.rst:58 +#: distutils/examples.rst:58 msgid "and the setup script might be ::" msgstr "" -#: ../src/Doc/distutils/examples.rst:66 +#: distutils/examples.rst:66 msgid "" "You can put module source files into another directory, but if you have " "enough modules to do that, it's probably easier to specify modules by " "package rather than listing them individually." msgstr "" -#: ../src/Doc/distutils/examples.rst:74 +#: distutils/examples.rst:74 msgid "Pure Python distribution (by package)" msgstr "" -#: ../src/Doc/distutils/examples.rst:76 +#: distutils/examples.rst:76 msgid "" "If you have more than a couple of modules to distribute, especially if they " "are in multiple packages, it's probably easier to specify whole packages " @@ -3577,27 +3547,27 @@ msgid "" "have to have an :file:`__init__.py` file)." msgstr "" -#: ../src/Doc/distutils/examples.rst:83 +#: distutils/examples.rst:83 msgid "The setup script from the last example could also be written as ::" msgstr "" -#: ../src/Doc/distutils/examples.rst:91 +#: distutils/examples.rst:91 msgid "(The empty string stands for the root package.)" msgstr "" -#: ../src/Doc/distutils/examples.rst:93 +#: distutils/examples.rst:93 msgid "" "If those two files are moved into a subdirectory, but remain in the root " "package, e.g.::" msgstr "" -#: ../src/Doc/distutils/examples.rst:101 +#: distutils/examples.rst:101 msgid "" "then you would still specify the root package, but you have to tell the " "Distutils where source files in the root package live::" msgstr "" -#: ../src/Doc/distutils/examples.rst:111 +#: distutils/examples.rst:111 msgid "" "More typically, though, you will want to distribute multiple modules in the " "same package (or in sub-packages). For example, if the :mod:`foo` and :mod:" @@ -3605,40 +3575,40 @@ msgid "" "tree is ::" msgstr "" -#: ../src/Doc/distutils/examples.rst:123 +#: distutils/examples.rst:123 msgid "" "This is in fact the default layout expected by the Distutils, and the one " "that requires the least work to describe in your setup script::" msgstr "" # f56cfee72c8147bb99374b4942aa34fe -#: ../src/Doc/distutils/examples.rst:132 +#: distutils/examples.rst:132 msgid "" "If you want to put modules in directories not named for their package, then " "you need to use the ``package_dir`` option again. For example, if the :file:" "`src` directory holds modules in the :mod:`foobar` package::" msgstr "" -#: ../src/Doc/distutils/examples.rst:143 +#: distutils/examples.rst:143 msgid "an appropriate setup script would be ::" msgstr "" -#: ../src/Doc/distutils/examples.rst:152 +#: distutils/examples.rst:152 msgid "" "Or, you might put modules from your main package right in the distribution " "root::" msgstr "" -#: ../src/Doc/distutils/examples.rst:161 +#: distutils/examples.rst:161 msgid "in which case your setup script would be ::" msgstr "" -#: ../src/Doc/distutils/examples.rst:170 +#: distutils/examples.rst:170 msgid "(The empty string also stands for the current directory.)" msgstr "" # 108d2cedeac34591bcc17dcc8086025e -#: ../src/Doc/distutils/examples.rst:172 +#: distutils/examples.rst:172 msgid "" "If you have sub-packages, they must be explicitly listed in ``packages``, " "but any entries in ``package_dir`` automatically extend to sub-packages. (In " @@ -3647,16 +3617,16 @@ msgid "" "file:`__init__.py` files.) Thus, if the default layout grows a sub-package::" msgstr "" -#: ../src/Doc/distutils/examples.rst:188 +#: distutils/examples.rst:188 msgid "then the corresponding setup script would be ::" msgstr "" -#: ../src/Doc/distutils/examples.rst:200 +#: distutils/examples.rst:200 msgid "Single extension module" msgstr "" # 2a03b0c65418415daf316b7785d40cf3 -#: ../src/Doc/distutils/examples.rst:202 +#: distutils/examples.rst:202 msgid "" "Extension modules are specified using the ``ext_modules`` option. " "``package_dir`` has no effect on where extension source files are found; it " @@ -3664,27 +3634,27 @@ msgid "" "single extension module in a single C source file, is::" msgstr "" -#: ../src/Doc/distutils/examples.rst:211 +#: distutils/examples.rst:211 msgid "" "If the :mod:`foo` extension belongs in the root package, the setup script " "for this could be ::" msgstr "" -#: ../src/Doc/distutils/examples.rst:221 +#: distutils/examples.rst:221 msgid "If the extension actually belongs in a package, say :mod:`foopkg`, then" msgstr "" -#: ../src/Doc/distutils/examples.rst:223 +#: distutils/examples.rst:223 msgid "" "With exactly the same source tree layout, this extension can be put in the :" "mod:`foopkg` package simply by changing the name of the extension::" msgstr "" -#: ../src/Doc/distutils/extending.rst:5 +#: distutils/extending.rst:5 msgid "Extending Distutils" msgstr "" -#: ../src/Doc/distutils/extending.rst:7 +#: distutils/extending.rst:7 msgid "" "Distutils can be extended in various ways. Most extensions take the form of " "new commands or replacements for existing commands. New commands may be " @@ -3693,7 +3663,7 @@ msgid "" "how the command operates on a package." msgstr "" -#: ../src/Doc/distutils/extending.rst:13 +#: distutils/extending.rst:13 msgid "" "Most extensions of the distutils are made within :file:`setup.py` scripts " "that want to modify existing commands; many simply add a few file extensions " @@ -3702,7 +3672,7 @@ msgid "" msgstr "" # 6693a8d961034da494e4b48b75679a3b -#: ../src/Doc/distutils/extending.rst:18 +#: distutils/extending.rst:18 msgid "" "Most distutils command implementations are subclasses of the :class:" "`distutils.cmd.Command` class. New commands may directly inherit from :" @@ -3711,11 +3681,11 @@ msgid "" "are required to derive from :class:`Command`." msgstr "" -#: ../src/Doc/distutils/extending.rst:33 +#: distutils/extending.rst:33 msgid "Integrating new commands" msgstr "" -#: ../src/Doc/distutils/extending.rst:35 +#: distutils/extending.rst:35 msgid "" "There are different ways to integrate new command implementations into " "distutils. The most difficult is to lobby for the inclusion of the new " @@ -3723,14 +3693,14 @@ msgid "" "that provides that support. This is really hard for many reasons." msgstr "" -#: ../src/Doc/distutils/extending.rst:40 +#: distutils/extending.rst:40 msgid "" "The most common, and possibly the most reasonable for most needs, is to " "include the new implementations with your :file:`setup.py` script, and cause " "the :func:`distutils.core.setup` function use them::" msgstr "" -#: ../src/Doc/distutils/extending.rst:55 +#: distutils/extending.rst:55 msgid "" "This approach is most valuable if the new implementations must be used to " "use a particular package, as everyone interested in the package will need to " @@ -3738,7 +3708,7 @@ msgid "" msgstr "" # 9c9e4a3a39ce4194a716bb8f431194d0 -#: ../src/Doc/distutils/extending.rst:59 +#: distutils/extending.rst:59 msgid "" "Beginning with Python 2.4, a third option is available, intended to allow " "new commands to be added which can support existing :file:`setup.py` scripts " @@ -3757,7 +3727,7 @@ msgid "" msgstr "" # bd13f354208f4ac3b799a15b4827e17d -#: ../src/Doc/distutils/extending.rst:74 +#: distutils/extending.rst:74 msgid "" "This new option can be used to add any number of packages to the list of " "packages searched for command implementations; multiple package names should " @@ -3772,11 +3742,11 @@ msgid "" "bdist_openpkg` or :class:`buildcmds.bdist_openpkg.bdist_openpkg`." msgstr "" -#: ../src/Doc/distutils/extending.rst:88 +#: distutils/extending.rst:88 msgid "Adding new distribution types" msgstr "" -#: ../src/Doc/distutils/extending.rst:90 +#: distutils/extending.rst:90 msgid "" "Commands that create distributions (files in the :file:`dist/` directory) " "need to add ``(command, filename)`` pairs to ``self.distribution." @@ -3786,19 +3756,19 @@ msgid "" "would have been created." msgstr "" -#: ../src/Doc/distutils/index.rst:5 +#: distutils/index.rst:5 msgid "Distributing Python Modules" msgstr "Distribuer des Modules Python [en]" -#: ../src/Doc/distutils/index.rst:7 +#: distutils/index.rst:7 msgid "Greg Ward, Anthony Baxter" msgstr "" -#: ../src/Doc/distutils/index.rst:8 +#: distutils/index.rst:8 msgid "distutils-sig@python.org" msgstr "" -#: ../src/Doc/distutils/index.rst:10 +#: distutils/index.rst:10 msgid "" "This document describes the Python Distribution Utilities (\"Distutils\") " "from the module developer's point of view, describing how to use the " @@ -3806,22 +3776,20 @@ msgid "" "audience with very little overhead for build/release/install mechanics." msgstr "" -# f3670d5680f04e9397162f64334badbb -#: ../src/Doc/distutils/index.rst:17 +#: distutils/index.rst:17 msgid "" "This guide only covers the basic tools for building and distributing " "extensions that are provided as part of this version of Python. Third party " "tools offer easier to use and more secure alternatives. Refer to the `quick " -"recommendations section `__ in the Python Packaging User Guide for more " -"information." +"recommendations section `__ " +"in the Python Packaging User Guide for more information." msgstr "" -#: ../src/Doc/distutils/introduction.rst:5 +#: distutils/introduction.rst:5 msgid "An Introduction to Distutils" msgstr "" -#: ../src/Doc/distutils/introduction.rst:7 +#: distutils/introduction.rst:7 msgid "" "This document covers using the Distutils to distribute your Python modules, " "concentrating on the role of developer/distributor: if you're looking for " @@ -3829,11 +3797,11 @@ msgid "" "`install-index` chapter." msgstr "" -#: ../src/Doc/distutils/introduction.rst:16 +#: distutils/introduction.rst:16 msgid "Concepts & Terminology" msgstr "" -#: ../src/Doc/distutils/introduction.rst:18 +#: distutils/introduction.rst:18 msgid "" "Using the Distutils is quite simple, both for module developers and for " "users/administrators installing third-party modules. As a developer, your " @@ -3841,27 +3809,27 @@ msgid "" "code, of course!) are:" msgstr "" -#: ../src/Doc/distutils/introduction.rst:23 +#: distutils/introduction.rst:23 msgid "write a setup script (:file:`setup.py` by convention)" msgstr "" -#: ../src/Doc/distutils/introduction.rst:25 +#: distutils/introduction.rst:25 msgid "(optional) write a setup configuration file" msgstr "" -#: ../src/Doc/distutils/introduction.rst:27 +#: distutils/introduction.rst:27 msgid "create a source distribution" msgstr "" -#: ../src/Doc/distutils/introduction.rst:29 +#: distutils/introduction.rst:29 msgid "(optional) create one or more built (binary) distributions" msgstr "" -#: ../src/Doc/distutils/introduction.rst:31 +#: distutils/introduction.rst:31 msgid "Each of these tasks is covered in this document." msgstr "" -#: ../src/Doc/distutils/introduction.rst:33 +#: distutils/introduction.rst:33 msgid "" "Not all module developers have access to a multitude of platforms, so it's " "not always feasible to expect them to create a multitude of built " @@ -3874,11 +3842,11 @@ msgid "" "having to run a single setup script or compile a line of code." msgstr "" -#: ../src/Doc/distutils/introduction.rst:47 +#: distutils/introduction.rst:47 msgid "A Simple Example" msgstr "Un exemple simple" -#: ../src/Doc/distutils/introduction.rst:49 +#: distutils/introduction.rst:49 msgid "" "The setup script is usually quite simple, although since it's written in " "Python, there are no arbitrary limits to what you can do with it, though you " @@ -3888,36 +3856,36 @@ msgid "" "your module distribution." msgstr "" -#: ../src/Doc/distutils/introduction.rst:56 +#: distutils/introduction.rst:56 msgid "" "If all you want to do is distribute a module called :mod:`foo`, contained in " "a file :file:`foo.py`, then your setup script can be as simple as this::" msgstr "" -#: ../src/Doc/distutils/introduction.rst:65 +#: distutils/introduction.rst:65 msgid "Some observations:" msgstr "" -#: ../src/Doc/distutils/introduction.rst:67 +#: distutils/introduction.rst:67 msgid "" "most information that you supply to the Distutils is supplied as keyword " "arguments to the :func:`setup` function" msgstr "" -#: ../src/Doc/distutils/introduction.rst:70 +#: distutils/introduction.rst:70 msgid "" "those keyword arguments fall into two categories: package metadata (name, " "version number) and information about what's in the package (a list of pure " "Python modules, in this case)" msgstr "" -#: ../src/Doc/distutils/introduction.rst:74 +#: distutils/introduction.rst:74 msgid "" "modules are specified by module name, not filename (the same will hold true " "for packages and extensions)" msgstr "" -#: ../src/Doc/distutils/introduction.rst:77 +#: distutils/introduction.rst:77 msgid "" "it's recommended that you supply a little more metadata, in particular your " "name, email address and a URL for the project (see section :ref:`setup-" @@ -3925,7 +3893,7 @@ msgid "" msgstr "" # 29e540eb382b4a20a7b97a0b6179a73c -#: ../src/Doc/distutils/introduction.rst:81 +#: distutils/introduction.rst:81 msgid "" "To create a source distribution for this module, you would create a setup " "script, :file:`setup.py`, containing the above code, and run this command " @@ -3933,14 +3901,14 @@ msgid "" msgstr "" # ab70aec5d1d74197ab1958d992a8ae9c -#: ../src/Doc/distutils/introduction.rst:87 +#: distutils/introduction.rst:87 msgid "" "For Windows, open a command prompt windows (:menuselection:`Start --> " "Accessories`) and change the command to::" msgstr "" # 4d70f2780b444c3ca7d0020cc3ebc3ec -#: ../src/Doc/distutils/introduction.rst:92 +#: distutils/introduction.rst:92 msgid "" ":command:`sdist` will create an archive file (e.g., tarball on Unix, ZIP " "file on Windows) containing your setup script :file:`setup.py`, and your " @@ -3948,20 +3916,20 @@ msgid "" "(or :file:`.zip`), and will unpack into a directory :file:`foo-1.0`." msgstr "" -#: ../src/Doc/distutils/introduction.rst:97 +#: distutils/introduction.rst:97 msgid "" "If an end-user wishes to install your :mod:`foo` module, all she has to do " "is download :file:`foo-1.0.tar.gz` (or :file:`.zip`), unpack it, and---from " "the :file:`foo-1.0` directory---run ::" msgstr "" -#: ../src/Doc/distutils/introduction.rst:103 +#: distutils/introduction.rst:103 msgid "" "which will ultimately copy :file:`foo.py` to the appropriate directory for " "third-party modules in their Python installation." msgstr "" -#: ../src/Doc/distutils/introduction.rst:106 +#: distutils/introduction.rst:106 msgid "" "This simple example demonstrates some fundamental concepts of the Distutils. " "First, both developers and installers have the same basic user interface, i." @@ -3971,7 +3939,7 @@ msgid "" "developers will want to install their own code occasionally)." msgstr "" -#: ../src/Doc/distutils/introduction.rst:113 +#: distutils/introduction.rst:113 msgid "" "If you want to make things really easy for your users, you can create one or " "more built distributions for them. For instance, if you are running on a " @@ -3981,13 +3949,13 @@ msgid "" "For example::" msgstr "" -#: ../src/Doc/distutils/introduction.rst:121 +#: distutils/introduction.rst:121 msgid "" "will create an executable installer, :file:`foo-1.0.win32.exe`, in the " "current directory." msgstr "" -#: ../src/Doc/distutils/introduction.rst:124 +#: distutils/introduction.rst:124 msgid "" "Other useful built distribution formats are RPM, implemented by the :command:" "`bdist_rpm` command, Solaris :program:`pkgtool` (:command:`bdist_pkgtool`), " @@ -3995,24 +3963,24 @@ msgid "" "following command will create an RPM file called :file:`foo-1.0.noarch.rpm`::" msgstr "" -#: ../src/Doc/distutils/introduction.rst:132 +#: distutils/introduction.rst:132 msgid "" "(The :command:`bdist_rpm` command uses the :command:`rpm` executable, " "therefore this has to be run on an RPM-based system such as Red Hat Linux, " "SuSE Linux, or Mandrake Linux.)" msgstr "" -#: ../src/Doc/distutils/introduction.rst:136 +#: distutils/introduction.rst:136 msgid "" "You can find out what distribution formats are available at any time by " "running ::" msgstr "" -#: ../src/Doc/distutils/introduction.rst:145 +#: distutils/introduction.rst:145 msgid "General Python terminology" msgstr "" -#: ../src/Doc/distutils/introduction.rst:147 +#: distutils/introduction.rst:147 msgid "" "If you're reading this document, you probably have a good idea of what " "modules, extensions, and so forth are. Nevertheless, just to be sure that " @@ -4020,12 +3988,12 @@ msgid "" "glossary of common Python terms:" msgstr "" -#: ../src/Doc/distutils/introduction.rst:154 +#: distutils/introduction.rst:155 #, fuzzy msgid "module" msgstr "*py_modules*" -#: ../src/Doc/distutils/introduction.rst:153 +#: distutils/introduction.rst:153 msgid "" "the basic unit of code reusability in Python: a block of code imported by " "some other code. Three types of modules concern us here: pure Python " @@ -4033,23 +4001,23 @@ msgid "" msgstr "" # d9d285c22c5948ad976b061d21affbc1 -#: ../src/Doc/distutils/introduction.rst:159 +#: distutils/introduction.rst:160 msgid "pure Python module" msgstr "" -#: ../src/Doc/distutils/introduction.rst:158 +#: distutils/introduction.rst:158 msgid "" "a module written in Python and contained in a single :file:`.py` file (and " "possibly associated :file:`.pyc` and/or :file:`.pyo` files). Sometimes " "referred to as a \"pure module.\"" msgstr "" -#: ../src/Doc/distutils/introduction.rst:167 +#: distutils/introduction.rst:168 #, fuzzy msgid "extension module" msgstr "*ext_modules*" -#: ../src/Doc/distutils/introduction.rst:163 +#: distutils/introduction.rst:163 msgid "" "a module written in the low-level language of the Python implementation: C/C+" "+ for Python, Java for Jython. Typically contained in a single dynamically " @@ -4060,24 +4028,24 @@ msgid "" "Python.)" msgstr "" -#: ../src/Doc/distutils/introduction.rst:172 +#: distutils/introduction.rst:173 #, fuzzy msgid "package" msgstr "*packages*" -#: ../src/Doc/distutils/introduction.rst:171 +#: distutils/introduction.rst:171 msgid "" "a module that contains other modules; typically contained in a directory in " "the filesystem and distinguished from other directories by the presence of a " "file :file:`__init__.py`." msgstr "" -#: ../src/Doc/distutils/introduction.rst:182 +#: distutils/introduction.rst:183 #, fuzzy msgid "root package" msgstr "*packages*" -#: ../src/Doc/distutils/introduction.rst:176 +#: distutils/introduction.rst:176 msgid "" "the root of the hierarchy of packages. (This isn't really a package, since " "it doesn't have an :file:`__init__.py` file. But we have to call it " @@ -4088,22 +4056,22 @@ msgid "" "``sys.path`` contributes modules to the root package." msgstr "" -#: ../src/Doc/distutils/introduction.rst:188 +#: distutils/introduction.rst:188 msgid "Distutils-specific terminology" msgstr "" -#: ../src/Doc/distutils/introduction.rst:190 +#: distutils/introduction.rst:190 msgid "" "The following terms apply more specifically to the domain of distributing " "Python modules using the Distutils:" msgstr "" -#: ../src/Doc/distutils/introduction.rst:198 +#: distutils/introduction.rst:199 #, fuzzy msgid "module distribution" msgstr "description" -#: ../src/Doc/distutils/introduction.rst:194 +#: distutils/introduction.rst:194 msgid "" "a collection of Python modules distributed together as a single downloadable " "resource and meant to be installed *en masse*. Examples of some well-known " @@ -4114,33 +4082,33 @@ msgid "" msgstr "" # 7267d0b36e23419bb39fe11267f84f40 -#: ../src/Doc/distutils/introduction.rst:202 +#: distutils/introduction.rst:203 msgid "pure module distribution" msgstr "" -#: ../src/Doc/distutils/introduction.rst:202 +#: distutils/introduction.rst:202 msgid "" "a module distribution that contains only pure Python modules and packages. " "Sometimes referred to as a \"pure distribution.\"" msgstr "" # f464f5fe8060490b8e8a9275ddbf7157 -#: ../src/Doc/distutils/introduction.rst:206 +#: distutils/introduction.rst:207 msgid "non-pure module distribution" msgstr "" -#: ../src/Doc/distutils/introduction.rst:206 +#: distutils/introduction.rst:206 msgid "" "a module distribution that contains at least one extension module. " "Sometimes referred to as a \"non-pure distribution.\"" msgstr "" # 4b6971acca6b4943a8bd06190cdf1c5c -#: ../src/Doc/distutils/introduction.rst:212 +#: distutils/introduction.rst:213 msgid "distribution root" msgstr "" -#: ../src/Doc/distutils/introduction.rst:210 +#: distutils/introduction.rst:210 msgid "" "the top-level directory of your source tree (or source distribution); the " "directory where :file:`setup.py` exists. Generally :file:`setup.py` will " @@ -4148,12 +4116,12 @@ msgid "" msgstr "" # 6b99a7bfa8f4420b8db5fd71046fb854 -#: ../src/Doc/distutils/packageindex.rst:9 +#: distutils/packageindex.rst:9 msgid "The Python Package Index (PyPI)" msgstr "" # 914fcf14fd664318bca9542ac3779371 -#: ../src/Doc/distutils/packageindex.rst:11 +#: distutils/packageindex.rst:11 msgid "" "The `Python Package Index (PyPI)`_ stores :ref:`meta-data ` " "describing distributions packaged with distutils, as well as package data " @@ -4161,7 +4129,7 @@ msgid "" msgstr "" # cb6a9a80b9894584848330f6b4121993 -#: ../src/Doc/distutils/packageindex.rst:15 +#: distutils/packageindex.rst:15 msgid "" "Distutils provides the :command:`register` and :command:`upload` commands " "for pushing meta-data and distribution files to PyPI, respectively. See :" @@ -4169,12 +4137,12 @@ msgid "" msgstr "" # 6d67dced94d4441f86ae90272f9558f6 -#: ../src/Doc/distutils/packageindex.rst:21 +#: distutils/packageindex.rst:21 msgid "PyPI overview" msgstr "" # 710266a60c024deaa57625fb47681c4d -#: ../src/Doc/distutils/packageindex.rst:23 +#: distutils/packageindex.rst:23 msgid "" "PyPI lets you submit any number of versions of your distribution to the " "index. If you alter the meta-data for a particular version, you can submit " @@ -4182,7 +4150,7 @@ msgid "" msgstr "" # 6383429bbe4a4aa184e44492e2cec22a -#: ../src/Doc/distutils/packageindex.rst:27 +#: distutils/packageindex.rst:27 msgid "" "PyPI holds a record for each (name, version) combination submitted. The " "first user to submit information for a given name is designated the Owner of " @@ -4193,7 +4161,7 @@ msgid "" msgstr "" # 4e954f4ee11e48688a86ebedf65e1fd1 -#: ../src/Doc/distutils/packageindex.rst:34 +#: distutils/packageindex.rst:34 msgid "" "By default PyPI displays only the newest version of a given package. The " "web interface lets one change this default behavior and manually select " @@ -4201,7 +4169,7 @@ msgid "" msgstr "" # 0e89bd4115a14ac89d021c0b9d5e7d2a -#: ../src/Doc/distutils/packageindex.rst:38 +#: distutils/packageindex.rst:38 msgid "" "For each version, PyPI displays a home page. The home page is created from " "the ``long_description`` which can be submitted via the :command:`register` " @@ -4209,12 +4177,12 @@ msgid "" msgstr "" # c79152d34e924a0e8c1c1496dcd4a891 -#: ../src/Doc/distutils/packageindex.rst:46 +#: distutils/packageindex.rst:46 msgid "Distutils commands" msgstr "" # 2f53fb60fe8b4e5d97e888cda1c2c722 -#: ../src/Doc/distutils/packageindex.rst:48 +#: distutils/packageindex.rst:48 msgid "" "Distutils exposes two commands for submitting package data to PyPI: the :ref:" "`register ` command for submitting meta-data to PyPI and " @@ -4224,30 +4192,30 @@ msgid "" msgstr "" # 948a10ce2c9a4949bfe99338cbe5210d -#: ../src/Doc/distutils/packageindex.rst:58 +#: distutils/packageindex.rst:58 msgid "The ``register`` command" msgstr "" # 914fcf14fd664318bca9542ac3779371 -#: ../src/Doc/distutils/packageindex.rst:60 +#: distutils/packageindex.rst:60 msgid "" "The distutils command :command:`register` is used to submit your " "distribution's meta-data to an index server. It is invoked as follows::" msgstr "" -#: ../src/Doc/distutils/packageindex.rst:65 +#: distutils/packageindex.rst:65 msgid "Distutils will respond with the following prompt::" msgstr "" # e6e0babdbf6e48bab414d30b3f8c7daf -#: ../src/Doc/distutils/packageindex.rst:75 +#: distutils/packageindex.rst:75 msgid "" "Note: if your username and password are saved locally, you will not see this " "menu. Also, refer to :ref:`pypirc` for how to store your credentials in a :" "file:`.pypirc` file." msgstr "" -#: ../src/Doc/distutils/packageindex.rst:79 +#: distutils/packageindex.rst:79 msgid "" "If you have not registered with PyPI, then you will need to do so now. You " "should choose option 2, and enter your details as required. Soon after " @@ -4255,7 +4223,7 @@ msgid "" "confirm your registration." msgstr "" -#: ../src/Doc/distutils/packageindex.rst:84 +#: distutils/packageindex.rst:84 msgid "" "Once you are registered, you may choose option 1 from the menu. You will be " "prompted for your PyPI username and password, and :command:`register` will " @@ -4263,30 +4231,30 @@ msgid "" msgstr "" # b2488b78ac0846459c82e14e2ec0f6b0 -#: ../src/Doc/distutils/packageindex.rst:88 +#: distutils/packageindex.rst:88 msgid "" "See :ref:`package-cmdoptions` for options to the :command:`register` command." msgstr "" # 44ce878edb61445a8535e935be5d0d1e -#: ../src/Doc/distutils/packageindex.rst:94 +#: distutils/packageindex.rst:94 msgid "The ``upload`` command" msgstr "" # 2abc16d12645454ba4c9ed172c50fcce -#: ../src/Doc/distutils/packageindex.rst:98 +#: distutils/packageindex.rst:98 msgid "" "The distutils command :command:`upload` pushes the distribution files to " "PyPI." msgstr "" -#: ../src/Doc/distutils/packageindex.rst:100 +#: distutils/packageindex.rst:100 msgid "" "The command is invoked immediately after building one or more distribution " "files. For example, the command ::" msgstr "" -#: ../src/Doc/distutils/packageindex.rst:105 +#: distutils/packageindex.rst:105 msgid "" "will cause the source distribution and the Windows installer to be uploaded " "to PyPI. Note that these will be uploaded even if they are built using an " @@ -4296,7 +4264,7 @@ msgid "" msgstr "" # 50b5fe1afc3d43a3a16ae17f6a1b7295 -#: ../src/Doc/distutils/packageindex.rst:110 +#: distutils/packageindex.rst:110 msgid "" "If a :command:`register` command was previously called in the same command, " "and if the password was entered in the prompt, :command:`upload` will reuse " @@ -4305,7 +4273,7 @@ msgid "" msgstr "" # 5c3eae18bce84390acdf072458579aba -#: ../src/Doc/distutils/packageindex.rst:115 +#: distutils/packageindex.rst:115 msgid "" "You can use the ``--sign`` option to tell :command:`upload` to sign each " "uploaded file using GPG (GNU Privacy Guard). The :program:`gpg` program " @@ -4314,45 +4282,45 @@ msgid "" msgstr "" # 50df9560a7124e6bac63ee4f476113e4 -#: ../src/Doc/distutils/packageindex.rst:120 +#: distutils/packageindex.rst:120 msgid "" "See :ref:`package-cmdoptions` for additional options to the :command:" "`upload` command." msgstr "" # 2765e408e89e4208b86b5a6787bc22a5 -#: ../src/Doc/distutils/packageindex.rst:127 +#: distutils/packageindex.rst:127 msgid "Additional command options" msgstr "" # 867e93a7ff2c477baa230404c67278b7 -#: ../src/Doc/distutils/packageindex.rst:129 +#: distutils/packageindex.rst:129 msgid "" "This section describes options common to both the :command:`register` and :" "command:`upload` commands." msgstr "" # f5ab518fae8f445dad7a52c0130726d5 -#: ../src/Doc/distutils/packageindex.rst:132 +#: distutils/packageindex.rst:132 msgid "" "The ``--repository`` or ``-r`` option lets you specify a PyPI server " "different from the default. For example::" msgstr "" # 95e27d0a76e64fc6843fa46f40fb04b3 -#: ../src/Doc/distutils/packageindex.rst:137 +#: distutils/packageindex.rst:137 msgid "" "For convenience, a name can be used in place of the URL when the :file:`." "pypirc` file is configured to do so. For example::" msgstr "" # d1b1e495f858425783a182f21e0858af -#: ../src/Doc/distutils/packageindex.rst:142 +#: distutils/packageindex.rst:142 msgid "See :ref:`pypirc` for more information on defining alternate servers." msgstr "" # 43cc5303d3de472bb46e1dcb06ce7597 -#: ../src/Doc/distutils/packageindex.rst:144 +#: distutils/packageindex.rst:144 msgid "" "The ``--show-response`` option displays the full response text from the PyPI " "server, which is useful when debugging problems with registering and " @@ -4360,12 +4328,12 @@ msgid "" msgstr "" # e02df502bb4d4e8c8acc4d918b0870fe -#: ../src/Doc/distutils/packageindex.rst:155 +#: distutils/packageindex.rst:155 msgid "The ``.pypirc`` file" msgstr "" # 5a0d1d7190154685993193e7588649dc -#: ../src/Doc/distutils/packageindex.rst:157 +#: distutils/packageindex.rst:157 msgid "" "The :command:`register` and :command:`upload` commands both check for the " "existence of a :file:`.pypirc` file at the location :file:`$HOME/.pypirc`. " @@ -4374,47 +4342,45 @@ msgid "" "follows::" msgstr "" -#: ../src/Doc/distutils/packageindex.rst:172 +#: distutils/packageindex.rst:172 msgid "" -"The *distutils* section defines a *index-servers* variable that lists the " +"The *distutils* section defines an *index-servers* variable that lists the " "name of all sections describing a repository." msgstr "" -#: ../src/Doc/distutils/packageindex.rst:175 +#: distutils/packageindex.rst:175 msgid "Each section describing a repository defines three variables:" msgstr "" -# fbdb8f39e3794116834764205597ef1e -#: ../src/Doc/distutils/packageindex.rst:176 -msgid "*repository*, that defines the url of the PyPI server. Defaults to" +#: distutils/packageindex.rst:177 +msgid "repository, that defines the url of the PyPI server. Defaults to" msgstr "" # 504c962d77fa45d49d3130c6d973bcaf -#: ../src/Doc/distutils/packageindex.rst:178 +#: distutils/packageindex.rst:178 msgid "``https://www.python.org/pypi``." msgstr "" -#: ../src/Doc/distutils/packageindex.rst:179 +#: distutils/packageindex.rst:179 msgid "*username*, which is the registered username on the PyPI server." msgstr "" -# 5f905574e8ff42d4affadb2135f39b63 -#: ../src/Doc/distutils/packageindex.rst:180 -msgid "*password*, that will be used to authenticate. If omitted the user" +#: distutils/packageindex.rst:181 +msgid "password, that will be used to authenticate. If omitted the user" msgstr "" -#: ../src/Doc/distutils/packageindex.rst:181 +#: distutils/packageindex.rst:181 msgid "will be prompt to type it when needed." msgstr "" -#: ../src/Doc/distutils/packageindex.rst:183 +#: distutils/packageindex.rst:183 msgid "" "If you want to define another server a new section can be created and listed " "in the *index-servers* variable::" msgstr "" # 0774a07dc5b04cab838bfc65b31db8a1 -#: ../src/Doc/distutils/packageindex.rst:201 +#: distutils/packageindex.rst:201 msgid "" "This allows the :command:`register` and :command:`upload` commands to be " "called with the ``--repository`` option as described in :ref:`package-" @@ -4422,43 +4388,43 @@ msgid "" msgstr "" # e8a586227e8247ce872281e0d4729cc9 -#: ../src/Doc/distutils/packageindex.rst:205 +#: distutils/packageindex.rst:205 msgid "" "Specifically, you might want to add the `PyPI Test Repository `_ to your ``.pypirc`` to facilitate testing before " "doing your first upload to ``PyPI`` itself." msgstr "" -#: ../src/Doc/distutils/packageindex.rst:213 +#: distutils/packageindex.rst:213 msgid "PyPI package display" msgstr "" -#: ../src/Doc/distutils/packageindex.rst:215 +#: distutils/packageindex.rst:215 msgid "" "The ``long_description`` field plays a special role at PyPI. It is used by " "the server to display a home page for the registered package." msgstr "" -#: ../src/Doc/distutils/packageindex.rst:218 +#: distutils/packageindex.rst:218 msgid "" "If you use the `reStructuredText `_ syntax for this field, PyPI will parse it and display an HTML output " "for the package home page." msgstr "" -#: ../src/Doc/distutils/packageindex.rst:222 +#: distutils/packageindex.rst:222 msgid "" "The ``long_description`` field can be attached to a text file located in the " "package::" msgstr "" -#: ../src/Doc/distutils/packageindex.rst:233 +#: distutils/packageindex.rst:233 msgid "" "In that case, :file:`README.txt` is a regular reStructuredText text file " "located in the root of the package besides :file:`setup.py`." msgstr "" -#: ../src/Doc/distutils/packageindex.rst:236 +#: distutils/packageindex.rst:236 msgid "" "To prevent registering broken reStructuredText content, you can use the :" "program:`rst2html` program that is provided by the :mod:`docutils` package " @@ -4466,7 +4432,7 @@ msgid "" msgstr "" # e8472c0041af419c8b9c106ce479c9ab -#: ../src/Doc/distutils/packageindex.rst:242 +#: distutils/packageindex.rst:242 msgid "" ":mod:`docutils` will display a warning if there's something wrong with your " "syntax. Because PyPI applies additional checks (e.g. by passing ``--no-" @@ -4475,11 +4441,11 @@ msgid "" "content successfully." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:5 +#: distutils/setupscript.rst:5 msgid "Writing the Setup Script" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:7 +#: distutils/setupscript.rst:7 msgid "" "The setup script is the centre of all activity in building, distributing, " "and installing modules using the Distutils. The main purpose of the setup " @@ -4491,7 +4457,7 @@ msgid "" "`setup`." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:15 +#: distutils/setupscript.rst:15 msgid "" "Here's a slightly more involved example, which we'll follow for the next " "couple of sections: the Distutils' own setup script. (Keep in mind that " @@ -4501,7 +4467,7 @@ msgid "" "here, is used to install the package into Python 1.5.2.) ::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:35 +#: distutils/setupscript.rst:35 msgid "" "There are only two differences between this and the trivial one-file " "distribution presented in section :ref:`distutils-simple-example`: more " @@ -4512,7 +4478,7 @@ msgid "" "information on the additional meta-data, see section :ref:`meta-data`." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:43 +#: distutils/setupscript.rst:43 msgid "" "Note that any pathnames (files or directories) supplied in the setup script " "should be written using the Unix convention, i.e. slash-separated. The " @@ -4523,7 +4489,7 @@ msgid "" "this spirit, all pathnames in this document are slash-separated." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:51 +#: distutils/setupscript.rst:51 msgid "" "This, of course, only applies to pathnames given to Distutils functions. If " "you, for example, use standard Python functions such as :func:`glob.glob` " @@ -4531,12 +4497,12 @@ msgid "" "portable code instead of hardcoding path separators::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:63 +#: distutils/setupscript.rst:63 msgid "Listing whole packages" msgstr "" # 2e3c7e1f9dd24ca1b3e829a1b727570b -#: ../src/Doc/distutils/setupscript.rst:65 +#: distutils/setupscript.rst:65 msgid "" "The ``packages`` option tells the Distutils to process (build, distribute, " "install, etc.) all pure Python modules found in each package mentioned in " @@ -4553,7 +4519,7 @@ msgid "" msgstr "" # 7b316947a6bb43a8bb056e16b2fbe109 -#: ../src/Doc/distutils/setupscript.rst:77 +#: distutils/setupscript.rst:77 msgid "" "If you use a different convention to lay out your source directory, that's " "no problem: you just have to supply the ``package_dir`` option to tell the " @@ -4563,7 +4529,7 @@ msgid "" "are in :file:`lib/foo`, and so forth. Then you would put ::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:86 +#: distutils/setupscript.rst:86 msgid "" "in your setup script. The keys to this dictionary are package names, and an " "empty package name stands for the root package. The values are directory " @@ -4572,7 +4538,7 @@ msgid "" "__init__.py` exists." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:91 +#: distutils/setupscript.rst:91 msgid "" "Another possible convention is to put the :mod:`foo` package right in :file:" "`lib`, the :mod:`foo.bar` package in :file:`lib/bar`, etc. This would be " @@ -4580,7 +4546,7 @@ msgid "" msgstr "" # 5a3aefea60134c19984285bd04d9dade -#: ../src/Doc/distutils/setupscript.rst:97 +#: distutils/setupscript.rst:97 msgid "" "A ``package: dir`` entry in the ``package_dir`` dictionary implicitly " "applies to all packages below *package*, so the :mod:`foo.bar` case is " @@ -4592,11 +4558,11 @@ msgid "" "directory with an :file:`__init__.py` file.)" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:110 +#: distutils/setupscript.rst:110 msgid "Listing individual modules" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:112 +#: distutils/setupscript.rst:112 msgid "" "For a small module distribution, you might prefer to list all modules rather " "than listing packages---especially the case of a single module that goes in " @@ -4606,7 +4572,7 @@ msgid "" msgstr "" # 7ad06e01f3d4406fa33fe77f9ffd3f90 -#: ../src/Doc/distutils/setupscript.rst:119 +#: distutils/setupscript.rst:119 msgid "" "This describes two modules, one of them in the \"root\" package, the other " "in the :mod:`pkg` package. Again, the default package/directory layout " @@ -4616,11 +4582,11 @@ msgid "" "``package_dir`` option." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:129 +#: distutils/setupscript.rst:129 msgid "Describing extension modules" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:131 +#: distutils/setupscript.rst:131 msgid "" "Just as writing Python extension modules is a bit more complicated than " "writing pure Python modules, describing them to the Distutils is a bit more " @@ -4631,7 +4597,7 @@ msgid "" msgstr "" # 374ee5ead55d43f5bbf9347d79103fa1 -#: ../src/Doc/distutils/setupscript.rst:140 +#: distutils/setupscript.rst:140 msgid "" "All of this is done through another keyword argument to :func:`setup`, the " "``ext_modules`` option. ``ext_modules`` is just a list of :class:" @@ -4642,14 +4608,14 @@ msgid "" "quite simple::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:150 +#: distutils/setupscript.rst:150 msgid "" "The :class:`Extension` class can be imported from :mod:`distutils.core` " "along with :func:`setup`. Thus, the setup script for a module distribution " "that contains only this one extension and nothing else might be::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:160 +#: distutils/setupscript.rst:160 msgid "" "The :class:`Extension` class (actually, the underlying extension-building " "machinery implemented by the :command:`build_ext` command) supports a great " @@ -4657,23 +4623,23 @@ msgid "" "the following sections." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:167 +#: distutils/setupscript.rst:167 msgid "Extension names and packages" msgstr "" # 076fe6e5727a4ad38abbfefac643ce72 -#: ../src/Doc/distutils/setupscript.rst:169 +#: distutils/setupscript.rst:169 msgid "" "The first argument to the :class:`~distutils.core.Extension` constructor is " "always the name of the extension, including any package names. For " "example, ::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:174 +#: distutils/setupscript.rst:174 msgid "describes an extension that lives in the root package, while ::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:178 +#: distutils/setupscript.rst:178 msgid "" "describes the same extension in the :mod:`pkg` package. The source files " "and resulting object code are identical in both cases; the only difference " @@ -4682,25 +4648,25 @@ msgid "" msgstr "" # 1915a29b555348b9810a871dcf1add3e -#: ../src/Doc/distutils/setupscript.rst:183 +#: distutils/setupscript.rst:183 msgid "" "If you have a number of extensions all in the same package (or all under the " "same base package), use the ``ext_package`` keyword argument to :func:" "`setup`. For example, ::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:193 +#: distutils/setupscript.rst:193 msgid "" "will compile :file:`foo.c` to the extension :mod:`pkg.foo`, and :file:`bar." "c` to :mod:`pkg.subpkg.bar`." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:198 +#: distutils/setupscript.rst:198 msgid "Extension source files" msgstr "" # 9f690d0ded10461cb24c3eabeeabd830 -#: ../src/Doc/distutils/setupscript.rst:200 +#: distutils/setupscript.rst:200 msgid "" "The second argument to the :class:`~distutils.core.Extension` constructor is " "a list of source files. Since the Distutils currently only support C, C++, " @@ -4710,7 +4676,7 @@ msgid "" "Windows compilers.)" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:207 +#: distutils/setupscript.rst:207 msgid "" "However, you can also include SWIG interface (:file:`.i`) files in the list; " "the :command:`build_ext` command knows how to deal with SWIG extensions: it " @@ -4718,17 +4684,17 @@ msgid "" "into your extension." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:214 +#: distutils/setupscript.rst:214 msgid "" "This warning notwithstanding, options to SWIG can be currently passed like " "this::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:223 +#: distutils/setupscript.rst:223 msgid "Or on the commandline like this::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:227 +#: distutils/setupscript.rst:227 msgid "" "On some platforms, you can include non-source files that are processed by " "the compiler and included in your extension. Currently, this just means " @@ -4737,39 +4703,39 @@ msgid "" "`.res`) files and linked into the executable." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:235 +#: distutils/setupscript.rst:235 msgid "Preprocessor options" msgstr "" # 8b6fafa1607347799056551c6a52e90c -#: ../src/Doc/distutils/setupscript.rst:237 +#: distutils/setupscript.rst:237 msgid "" "Three optional arguments to :class:`~distutils.core.Extension` will help if " "you need to specify include directories to search or preprocessor macros to " "define/undefine: ``include_dirs``, ``define_macros``, and ``undef_macros``." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:241 +#: distutils/setupscript.rst:241 msgid "" "For example, if your extension requires header files in the :file:`include` " "directory under your distribution root, use the ``include_dirs`` option::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:246 +#: distutils/setupscript.rst:246 msgid "" "You can specify absolute directories there; if you know that your extension " "will only be built on Unix systems with X11R6 installed to :file:`/usr`, you " "can get away with ::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:252 +#: distutils/setupscript.rst:252 msgid "" "You should avoid this sort of non-portable usage if you plan to distribute " "your code: it's probably better to write C code like ::" msgstr "" # 1ba3f29fccf34b758c7343d0a53605ff -#: ../src/Doc/distutils/setupscript.rst:257 +#: distutils/setupscript.rst:257 msgid "" "If you need to include header files from some other Python extension, you " "can take advantage of the fact that header files are installed in a " @@ -4782,21 +4748,21 @@ msgid "" "extensions, the best approach is to write C code like ::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:269 +#: distutils/setupscript.rst:269 msgid "" "If you must put the :file:`Numerical` include directory right into your " "header search path, though, you can find that directory using the Distutils :" "mod:`distutils.sysconfig` module::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:279 +#: distutils/setupscript.rst:279 msgid "" "Even though this is quite portable---it will work on any Python " "installation, regardless of platform---it's probably easier to just write " "your C code in the sensible way." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:283 +#: distutils/setupscript.rst:283 msgid "" "You can define and undefine pre-processor macros with the ``define_macros`` " "and ``undef_macros`` options. ``define_macros`` takes a list of ``(name, " @@ -4807,19 +4773,19 @@ msgid "" "``undef_macros`` is just a list of macros to undefine." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:291 +#: distutils/setupscript.rst:291 msgid "For example::" msgstr "Par exemple ::" -#: ../src/Doc/distutils/setupscript.rst:298 +#: distutils/setupscript.rst:298 msgid "is the equivalent of having this at the top of every C source file::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:307 +#: distutils/setupscript.rst:307 msgid "Library options" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:309 +#: distutils/setupscript.rst:309 msgid "" "You can also specify the libraries to link against when building your " "extension, and the directories to search for those libraries. The " @@ -4829,35 +4795,35 @@ msgid "" "shared (dynamically loaded) libraries at run-time." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:315 +#: distutils/setupscript.rst:315 msgid "" "For example, if you need to link against libraries known to be in the " "standard library search path on target systems ::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:321 +#: distutils/setupscript.rst:321 msgid "" "If you need to link with libraries in a non-standard location, you'll have " "to include the location in ``library_dirs``::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:328 +#: distutils/setupscript.rst:328 msgid "" "(Again, this sort of non-portable construct should be avoided if you intend " "to distribute your code.)" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:335 +#: distutils/setupscript.rst:335 msgid "Other options" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:337 +#: distutils/setupscript.rst:337 msgid "" "There are still some other options which can be used to handle special cases." msgstr "" # d395b7a254d54d69a9c91eac23a186a3 -#: ../src/Doc/distutils/setupscript.rst:339 +#: distutils/setupscript.rst:339 msgid "" "The ``extra_objects`` option is a list of object files to be passed to the " "linker. These files must not have extensions, as the default extension for " @@ -4865,7 +4831,7 @@ msgid "" msgstr "" # 6b8ac1b9870e4ffa9e4fe8ea6efc7ff4 -#: ../src/Doc/distutils/setupscript.rst:343 +#: distutils/setupscript.rst:343 msgid "" "``extra_compile_args`` and ``extra_link_args`` can be used to specify " "additional command line options for the respective compiler and linker " @@ -4873,7 +4839,7 @@ msgid "" msgstr "" # 2bd3f559a7384c8699efcf9f112e6d84 -#: ../src/Doc/distutils/setupscript.rst:347 +#: distutils/setupscript.rst:347 msgid "" "``export_symbols`` is only useful on Windows. It can contain a list of " "symbols (functions or variables) to be exported. This option is not needed " @@ -4882,7 +4848,7 @@ msgid "" msgstr "" # 027f690f503c45279d117a3ea4089150 -#: ../src/Doc/distutils/setupscript.rst:352 +#: distutils/setupscript.rst:352 msgid "" "The ``depends`` option is a list of files that the extension depends on (for " "example header files). The build command will call the compiler on the " @@ -4890,33 +4856,33 @@ msgid "" "the previous build." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:358 +#: distutils/setupscript.rst:358 msgid "Relationships between Distributions and Packages" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:360 +#: distutils/setupscript.rst:360 msgid "A distribution may relate to packages in three specific ways:" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:362 +#: distutils/setupscript.rst:362 msgid "It can require packages or modules." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:364 +#: distutils/setupscript.rst:364 msgid "It can provide packages or modules." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:366 +#: distutils/setupscript.rst:366 msgid "It can obsolete packages or modules." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:368 +#: distutils/setupscript.rst:368 msgid "" "These relationships can be specified using keyword arguments to the :func:" "`distutils.core.setup` function." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:371 +#: distutils/setupscript.rst:371 msgid "" "Dependencies on other Python modules and packages can be specified by " "supplying the *requires* keyword argument to :func:`setup`. The value must " @@ -4924,58 +4890,57 @@ msgid "" "optionally what versions are sufficient." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:376 +#: distutils/setupscript.rst:376 msgid "" "To specify that any version of a module or package is required, the string " "should consist entirely of the module or package name. Examples include " "``'mymodule'`` and ``'xml.parsers.expat'``." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:380 +#: distutils/setupscript.rst:380 msgid "" "If specific versions are required, a sequence of qualifiers can be supplied " "in parentheses. Each qualifier may consist of a comparison operator and a " "version number. The accepted comparison operators are::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:387 +#: distutils/setupscript.rst:387 msgid "" "These can be combined by using multiple qualifiers separated by commas (and " "optional whitespace). In this case, all of the qualifiers must be matched; " "a logical AND is used to combine the evaluations." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:391 +#: distutils/setupscript.rst:391 msgid "Let's look at a bunch of examples:" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:394 +#: distutils/setupscript.rst:394 msgid "Requires Expression" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:394 -#: ../src/Doc/distutils/setupscript.rst:412 +#: distutils/setupscript.rst:394 distutils/setupscript.rst:412 msgid "Explanation" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:396 +#: distutils/setupscript.rst:396 msgid "``==1.0``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:396 +#: distutils/setupscript.rst:396 msgid "Only version ``1.0`` is compatible" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:398 +#: distutils/setupscript.rst:398 msgid "``>1.0, !=1.5.1, <2.0``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:398 +#: distutils/setupscript.rst:398 msgid "" "Any version after ``1.0`` and before ``2.0`` is compatible, except ``1.5.1``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:402 +#: distutils/setupscript.rst:402 msgid "" "Now that we can specify dependencies, we also need to be able to specify " "what we provide that other distributions can require. This is done using " @@ -4985,32 +4950,32 @@ msgid "" "assumed to match that of the distribution." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:409 +#: distutils/setupscript.rst:409 #, fuzzy msgid "Some examples:" msgstr "Quelques exemples ::" -#: ../src/Doc/distutils/setupscript.rst:412 +#: distutils/setupscript.rst:412 msgid "Provides Expression" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:414 +#: distutils/setupscript.rst:414 msgid "``mypkg``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:414 +#: distutils/setupscript.rst:414 msgid "Provide ``mypkg``, using the distribution version" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:417 +#: distutils/setupscript.rst:417 msgid "``mypkg (1.1)``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:417 +#: distutils/setupscript.rst:417 msgid "Provide ``mypkg`` version 1.1, regardless of the distribution version" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:421 +#: distutils/setupscript.rst:421 msgid "" "A package can declare that it obsoletes other packages using the *obsoletes* " "keyword argument. The value for this is similar to that of the *requires* " @@ -5020,24 +4985,24 @@ msgid "" "the module or package name." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:428 +#: distutils/setupscript.rst:428 msgid "" "The versions identified by the qualifiers are those that are obsoleted by " "the distribution being described. If no qualifiers are given, all versions " "of the named module or package are understood to be obsoleted." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:435 +#: distutils/setupscript.rst:435 msgid "Installing Scripts" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:437 +#: distutils/setupscript.rst:437 msgid "" "So far we have been dealing with pure and non-pure Python modules, which are " "usually not run by themselves but imported by scripts." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:440 +#: distutils/setupscript.rst:440 msgid "" "Scripts are files containing Python source code, intended to be started from " "the command line. Scripts don't require Distutils to do anything very " @@ -5050,17 +5015,23 @@ msgid "" msgstr "" # 1e561247b75c4264a8ae532608329976 -#: ../src/Doc/distutils/setupscript.rst:448 +#: distutils/setupscript.rst:448 msgid "" "The ``scripts`` option simply is a list of files to be handled in this way. " "From the PyXML setup script::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:462 +#: distutils/setupscript.rst:455 +msgid "" +"All the scripts will also be added to the ``MANIFEST`` file if no template " +"is provided. See :ref:`manifest`." +msgstr "" + +#: distutils/setupscript.rst:462 msgid "Installing Package Data" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:464 +#: distutils/setupscript.rst:464 msgid "" "Often, additional files need to be installed into a package. These files " "are often data that's closely related to the package's implementation, or " @@ -5068,7 +5039,7 @@ msgid "" "using the package. These files are called :dfn:`package data`." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:469 +#: distutils/setupscript.rst:469 msgid "" "Package data can be added to packages using the ``package_data`` keyword " "argument to the :func:`setup` function. The value must be a mapping from " @@ -5079,28 +5050,34 @@ msgid "" "the source directories. They may contain glob patterns as well." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:477 +#: distutils/setupscript.rst:477 msgid "" "The path names may contain directory portions; any necessary directories " "will be created in the installation." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:480 +#: distutils/setupscript.rst:480 msgid "" "For example, if a package should contain a subdirectory with several data " "files, the files can be arranged like this in the source tree::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:493 +#: distutils/setupscript.rst:493 msgid "The corresponding call to :func:`setup` might be::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:511 +#: distutils/setupscript.rst:503 +msgid "" +"All the files that match ``package_data`` will be added to the ``MANIFEST`` " +"file if no template is provided. See :ref:`manifest`." +msgstr "" + +#: distutils/setupscript.rst:511 msgid "Installing Additional Files" msgstr "" # 764ec0c550404f61a5728f6cb0188672 -#: ../src/Doc/distutils/setupscript.rst:513 +#: distutils/setupscript.rst:513 msgid "" "The ``data_files`` option can be used to specify additional files needed by " "the module distribution: configuration files, message catalogs, data files, " @@ -5108,19 +5085,19 @@ msgid "" msgstr "" # d2da5375a93243c5b28f3e51ab2578fd -#: ../src/Doc/distutils/setupscript.rst:517 +#: distutils/setupscript.rst:517 msgid "" "``data_files`` specifies a sequence of (*directory*, *files*) pairs in the " "following way::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:526 +#: distutils/setupscript.rst:526 msgid "" "Note that you can specify the directory names where the data files will be " "installed, but you cannot rename the data files themselves." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:529 +#: distutils/setupscript.rst:529 msgid "" "Each (*directory*, *files*) pair in the sequence specifies the installation " "directory and the files to install there. If *directory* is a relative " @@ -5133,7 +5110,7 @@ msgid "" msgstr "" # 13e797b7d4e44445aba8604b494b03f3 -#: ../src/Doc/distutils/setupscript.rst:538 +#: distutils/setupscript.rst:538 msgid "" "You can specify the ``data_files`` options as a simple sequence of files " "without specifying a target directory, but this is not recommended, and the :" @@ -5142,163 +5119,162 @@ msgid "" "the directory." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:553 +#: distutils/setupscript.rst:544 +msgid "" +"All the files that match ``data_files`` will be added to the ``MANIFEST`` " +"file if no template is provided. See :ref:`manifest`." +msgstr "" + +#: distutils/setupscript.rst:553 msgid "Additional meta-data" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:555 +#: distutils/setupscript.rst:555 msgid "" "The setup script may include additional meta-data beyond the name and " "version. This information includes:" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:559 +#: distutils/setupscript.rst:559 msgid "Meta-Data" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:559 +#: distutils/setupscript.rst:559 msgid "Value" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:561 +#: distutils/setupscript.rst:561 msgid "name of the package" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:561 -#: ../src/Doc/distutils/setupscript.rst:563 -#: ../src/Doc/distutils/setupscript.rst:565 -#: ../src/Doc/distutils/setupscript.rst:570 -#: ../src/Doc/distutils/setupscript.rst:577 -#: ../src/Doc/distutils/setupscript.rst:591 +#: distutils/setupscript.rst:561 distutils/setupscript.rst:563 +#: distutils/setupscript.rst:565 distutils/setupscript.rst:570 +#: distutils/setupscript.rst:577 distutils/setupscript.rst:591 msgid "short string" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:561 -#: ../src/Doc/distutils/setupscript.rst:575 +#: distutils/setupscript.rst:561 distutils/setupscript.rst:575 msgid "\\(1)" msgstr "\\(1)" -#: ../src/Doc/distutils/setupscript.rst:563 +#: distutils/setupscript.rst:563 msgid "version of this release" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:563 +#: distutils/setupscript.rst:563 msgid "(1)(2)" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:565 +#: distutils/setupscript.rst:565 msgid "``author``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:565 +#: distutils/setupscript.rst:565 msgid "package author's name" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:567 +#: distutils/setupscript.rst:567 msgid "``author_email``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:567 +#: distutils/setupscript.rst:567 msgid "email address of the package author" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:567 -#: ../src/Doc/distutils/setupscript.rst:572 +#: distutils/setupscript.rst:567 distutils/setupscript.rst:572 msgid "email address" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:570 +#: distutils/setupscript.rst:570 msgid "``maintainer``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:570 +#: distutils/setupscript.rst:570 msgid "package maintainer's name" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:572 +#: distutils/setupscript.rst:572 msgid "``maintainer_email``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:572 +#: distutils/setupscript.rst:572 msgid "email address of the package maintainer" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:575 +#: distutils/setupscript.rst:575 msgid "home page for the package" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:575 -#: ../src/Doc/distutils/setupscript.rst:584 +#: distutils/setupscript.rst:575 distutils/setupscript.rst:584 msgid "URL" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:577 +#: distutils/setupscript.rst:577 msgid "short, summary description of the package" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:581 +#: distutils/setupscript.rst:581 msgid "longer description of the package" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:581 +#: distutils/setupscript.rst:581 msgid "long string" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:584 +#: distutils/setupscript.rst:584 msgid "``download_url``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:584 +#: distutils/setupscript.rst:584 msgid "location where the package may be downloaded" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:587 +#: distutils/setupscript.rst:587 msgid "``classifiers``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:587 +#: distutils/setupscript.rst:587 msgid "a list of classifiers" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:587 -#: ../src/Doc/distutils/setupscript.rst:589 +#: distutils/setupscript.rst:587 distutils/setupscript.rst:589 msgid "list of strings" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:589 +#: distutils/setupscript.rst:589 msgid "``platforms``" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:589 +#: distutils/setupscript.rst:589 msgid "a list of platforms" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:591 +#: distutils/setupscript.rst:591 msgid "license for the package" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:591 +#: distutils/setupscript.rst:591 msgid "\\(6)" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:597 +#: distutils/setupscript.rst:597 msgid "These fields are required." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:600 +#: distutils/setupscript.rst:600 msgid "" "It is recommended that versions take the form *major.minor[.patch[.sub]]*." msgstr "" # 682e2f7b98b84c05a1a2a7e21d9d4c7d -#: ../src/Doc/distutils/setupscript.rst:603 +#: distutils/setupscript.rst:603 msgid "" "Either the author or the maintainer must be identified. If maintainer is " "provided, distutils lists it as the author in :file:`PKG-INFO`." msgstr "" # f17e0ec23453447698c850a7e3abbbd1 -#: ../src/Doc/distutils/setupscript.rst:607 +#: distutils/setupscript.rst:607 msgid "" "These fields should not be used if your package is to be compatible with " "Python versions prior to 2.2.3 or 2.3. The list is available from the `PyPI " @@ -5306,14 +5282,14 @@ msgid "" msgstr "" # fc9bbbad33fe40e0bae202e4d4a27184 -#: ../src/Doc/distutils/setupscript.rst:612 +#: distutils/setupscript.rst:612 msgid "" "The ``long_description`` field is used by PyPI when you are :ref:" "`registering ` a package, to :ref:`build its home page " "`." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:617 +#: distutils/setupscript.rst:617 msgid "" "The ``license`` field is a text indicating the license covering the package " "where the license is not a selection from the \"License\" Trove classifiers. " @@ -5321,42 +5297,42 @@ msgid "" "option which is deprecated but still acts as an alias for ``license``." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:623 +#: distutils/setupscript.rst:624 #, fuzzy msgid "'short string'" msgstr "une chaîne de caractères" -#: ../src/Doc/distutils/setupscript.rst:624 +#: distutils/setupscript.rst:624 msgid "A single line of text, not more than 200 characters." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:627 +#: distutils/setupscript.rst:628 #, fuzzy msgid "'long string'" msgstr "une chaîne de caractères" # 8861cdcde56848018f368272eb97256c -#: ../src/Doc/distutils/setupscript.rst:627 +#: distutils/setupscript.rst:627 msgid "" "Multiple lines of plain text in reStructuredText format (see http://docutils." "sourceforge.net/)." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:630 +#: distutils/setupscript.rst:631 #, fuzzy msgid "'list of strings'" msgstr "une liste de chaînes" -#: ../src/Doc/distutils/setupscript.rst:631 +#: distutils/setupscript.rst:631 msgid "See below." msgstr "" # 7c1862acdfce4c5d9ef4d14f8ebc9f36 -#: ../src/Doc/distutils/setupscript.rst:633 +#: distutils/setupscript.rst:633 msgid "None of the string values may be Unicode." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:635 +#: distutils/setupscript.rst:635 msgid "" "Encoding the version information is an art in itself. Python packages " "generally adhere to the version format *major.minor[.patch][sub]*. The major " @@ -5372,29 +5348,29 @@ msgid "" msgstr "" # 0de9f3525ca64e98a6edf0bdd347d253 -#: ../src/Doc/distutils/setupscript.rst:646 +#: distutils/setupscript.rst:647 msgid "0.1.0" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:647 +#: distutils/setupscript.rst:647 msgid "the first, experimental release of a package" msgstr "" # fe4ed80664034b97a21415110d9ee93a -#: ../src/Doc/distutils/setupscript.rst:649 +#: distutils/setupscript.rst:650 msgid "1.0.1a2" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:650 +#: distutils/setupscript.rst:650 msgid "the second alpha release of the first patch version of 1.0" msgstr "" # 830c55312a744d02bcbc569c82a7e9e3 -#: ../src/Doc/distutils/setupscript.rst:652 +#: distutils/setupscript.rst:652 msgid "``classifiers`` are specified in a Python list::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:673 +#: distutils/setupscript.rst:673 msgid "" "If you wish to include classifiers in your :file:`setup.py` file and also " "wish to remain backwards-compatible with Python releases prior to 2.2.3, " @@ -5402,17 +5378,17 @@ msgid "" "before the :func:`setup` call. ::" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:690 +#: distutils/setupscript.rst:690 msgid "Debugging the setup script" msgstr "" -#: ../src/Doc/distutils/setupscript.rst:692 +#: distutils/setupscript.rst:692 msgid "" "Sometimes things go wrong, and the setup script doesn't do what the " "developer wants." msgstr "" -#: ../src/Doc/distutils/setupscript.rst:695 +#: distutils/setupscript.rst:695 msgid "" "Distutils catches any exceptions when running the setup script, and print a " "simple error message before the script is terminated. The motivation for " @@ -5424,7 +5400,7 @@ msgid "" msgstr "" # 4908a4fdcf674ca18faa86c9909ab247 -#: ../src/Doc/distutils/setupscript.rst:703 +#: distutils/setupscript.rst:703 msgid "" "On the other hand, this doesn't help the developer to find the cause of the " "failure. For this purpose, the :envvar:`DISTUTILS_DEBUG` environment " @@ -5434,17 +5410,17 @@ msgid "" "external program (like a C compiler) fails." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:5 +#: distutils/sourcedist.rst:5 msgid "Creating a Source Distribution" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:7 +#: distutils/sourcedist.rst:7 msgid "" "As shown in section :ref:`distutils-simple-example`, you use the :command:" "`sdist` command to create a source distribution. In the simplest case, ::" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:12 +#: distutils/sourcedist.rst:12 msgid "" "(assuming you haven't specified any :command:`sdist` options in the setup " "script or config file), :command:`sdist` creates the archive of the default " @@ -5452,53 +5428,53 @@ msgid "" "file:`.tar.gz`) on Unix, and ZIP file on Windows." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:17 +#: distutils/sourcedist.rst:17 msgid "" "You can specify as many formats as you like using the :option:`--formats` " "option, for example::" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:22 +#: distutils/sourcedist.rst:22 msgid "to create a gzipped tarball and a zip file. The available formats are:" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:29 +#: distutils/sourcedist.rst:29 msgid "gzip'ed tar file (:file:`.tar.gz`)" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:29 +#: distutils/sourcedist.rst:29 msgid "\\(2)" msgstr "\\(2)" -#: ../src/Doc/distutils/sourcedist.rst:32 +#: distutils/sourcedist.rst:32 msgid "``bztar``" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:32 +#: distutils/sourcedist.rst:32 msgid "bzip2'ed tar file (:file:`.tar.bz2`)" msgstr "" # 2ec15768e3ce4932aa89d608f4d551ba -#: ../src/Doc/distutils/sourcedist.rst:54 +#: distutils/sourcedist.rst:54 msgid "requires the :program:`compress` program." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:56 +#: distutils/sourcedist.rst:56 msgid "" "When using any ``tar`` format (``gztar``, ``bztar``, ``ztar`` or ``tar``) " "under Unix, you can specify the ``owner`` and ``group`` names that will be " "set for each member of the archive." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:60 +#: distutils/sourcedist.rst:60 msgid "For example, if you want all files of the archive to be owned by root::" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:68 +#: distutils/sourcedist.rst:68 msgid "Specifying the files to distribute" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:70 +#: distutils/sourcedist.rst:70 msgid "" "If you don't supply an explicit list of files (or instructions on how to " "generate one), the :command:`sdist` command puts a minimal default set into " @@ -5506,26 +5482,26 @@ msgid "" msgstr "" # bc453850d2f248aab2fcbe8131cae205 -#: ../src/Doc/distutils/sourcedist.rst:74 +#: distutils/sourcedist.rst:74 msgid "" "all Python source files implied by the ``py_modules`` and ``packages`` " "options" msgstr "" # 67913837efe54a6f99c894bec6302a4e -#: ../src/Doc/distutils/sourcedist.rst:77 +#: distutils/sourcedist.rst:77 msgid "" "all C source files mentioned in the ``ext_modules`` or ``libraries`` options" msgstr "" # 5e9562ff04bd4956a008e6d5a897492f -#: ../src/Doc/distutils/sourcedist.rst:83 +#: distutils/sourcedist.rst:83 msgid "" "scripts identified by the ``scripts`` option See :ref:`distutils-installing-" "scripts`." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:86 +#: distutils/sourcedist.rst:86 msgid "" "anything that looks like a test script: :file:`test/test\\*.py` (currently, " "the Distutils don't do anything with test scripts except include them in " @@ -5533,25 +5509,25 @@ msgid "" "Python module distributions)" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:91 +#: distutils/sourcedist.rst:91 msgid "" ":file:`README.txt` (or :file:`README`), :file:`setup.py` (or whatever you " "called your setup script), and :file:`setup.cfg`" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:94 +#: distutils/sourcedist.rst:94 msgid "" "all files that matches the ``package_data`` metadata. See :ref:`distutils-" "installing-package-data`." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:97 +#: distutils/sourcedist.rst:97 msgid "" "all files that matches the ``data_files`` metadata. See :ref:`distutils-" "additional-files`." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:100 +#: distutils/sourcedist.rst:100 msgid "" "Sometimes this is enough, but usually you will want to specify additional " "files to distribute. The typical way to do this is to write a *manifest " @@ -5563,7 +5539,7 @@ msgid "" "filesystem." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:108 +#: distutils/sourcedist.rst:108 msgid "" "If you prefer to roll your own manifest file, the format is simple: one " "filename per line, regular files (or symlinks to them) only. If you do " @@ -5571,22 +5547,41 @@ msgid "" "set of files described above does not apply in this case." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:126 +#: distutils/sourcedist.rst:113 +msgid "" +"An existing generated :file:`MANIFEST` will be regenerated without :command:" +"`sdist` comparing its modification time to the one of :file:`MANIFEST.in` " +"or :file:`setup.py`." +msgstr "" + +#: distutils/sourcedist.rst:118 +msgid "" +":file:`MANIFEST` files start with a comment indicating they are generated. " +"Files without this comment are not overwritten or removed." +msgstr "" + +#: distutils/sourcedist.rst:122 +msgid "" +":command:`sdist` will read a :file:`MANIFEST` file if no :file:`MANIFEST.in` " +"exists, like it did before 2.7." +msgstr "" + +#: distutils/sourcedist.rst:126 msgid "See :ref:`manifest_template` section for a syntax reference." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:132 +#: distutils/sourcedist.rst:132 msgid "Manifest-related options" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:134 +#: distutils/sourcedist.rst:134 msgid "" "The normal course of operations for the :command:`sdist` command is as " "follows:" msgstr "" # 12f29dbe5a8d446abee4461ae21bbd2d -#: ../src/Doc/distutils/sourcedist.rst:136 +#: distutils/sourcedist.rst:136 msgid "" "if the manifest file (:file:`MANIFEST` by default) exists and the first line " "does not have a comment indicating it is generated from :file:`MANIFEST.in`, " @@ -5594,77 +5589,77 @@ msgid "" msgstr "" # a041313a27f54f1ca513b457c82a3b42 -#: ../src/Doc/distutils/sourcedist.rst:140 +#: distutils/sourcedist.rst:140 msgid "" "if the manifest file doesn't exist or has been previously automatically " "generated, read :file:`MANIFEST.in` and create the manifest" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:143 +#: distutils/sourcedist.rst:143 msgid "" "if neither :file:`MANIFEST` nor :file:`MANIFEST.in` exist, create a manifest " "with just the default file set" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:146 +#: distutils/sourcedist.rst:146 msgid "" "use the list of files now in :file:`MANIFEST` (either just generated or read " "in) to create the source distribution archive(s)" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:149 +#: distutils/sourcedist.rst:149 msgid "" "There are a couple of options that modify this behaviour. First, use the :" "option:`--no-defaults` and :option:`--no-prune` to disable the standard " "\"include\" and \"exclude\" sets." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:153 +#: distutils/sourcedist.rst:153 msgid "" "Second, you might just want to (re)generate the manifest, but not create a " "source distribution::" msgstr "" # f20d6143fe504f6cb2999f7e6530defa -#: ../src/Doc/distutils/sourcedist.rst:158 +#: distutils/sourcedist.rst:158 msgid ":option:`-o` is a shortcut for :option:`--manifest-only`." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:163 +#: distutils/sourcedist.rst:163 msgid "The MANIFEST.in template" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:165 +#: distutils/sourcedist.rst:165 msgid "" "A :file:`MANIFEST.in` file can be added in a project to define the list of " "files to include in the distribution built by the :command:`sdist` command." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:168 +#: distutils/sourcedist.rst:168 msgid "" "When :command:`sdist` is run, it will look for the :file:`MANIFEST.in` file " "and interpret it to generate the :file:`MANIFEST` file that contains the " "list of files that will be included in the package." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:172 +#: distutils/sourcedist.rst:172 msgid "" "This mechanism can be used when the default list of files is not enough. " "(See :ref:`manifest`)." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:176 +#: distutils/sourcedist.rst:176 msgid "Principle" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:178 +#: distutils/sourcedist.rst:178 msgid "" "The manifest template has one command per line, where each command specifies " "a set of files to include or exclude from the source distribution. For an " "example, let's look at the Distutils' own manifest template::" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:186 +#: distutils/sourcedist.rst:186 msgid "" "The meanings should be fairly clear: include all files in the distribution " "root matching :file:`\\*.txt`, all files anywhere under the :file:`examples` " @@ -5675,7 +5670,7 @@ msgid "" "the :option:`--no-defaults` option to disable the standard set entirely.)" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:194 +#: distutils/sourcedist.rst:194 msgid "" "The order of commands in the manifest template matters: initially, we have " "the list of default files as described above, and each command in the " @@ -5684,30 +5679,30 @@ msgid "" "in the source distribution:" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:200 +#: distutils/sourcedist.rst:200 msgid "all files in the Distutils \"build\" tree (default :file:`build/`)" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:202 +#: distutils/sourcedist.rst:202 msgid "" "all files in directories named :file:`RCS`, :file:`CVS`, :file:`.svn`, :file:" "`.hg`, :file:`.git`, :file:`.bzr` or :file:`_darcs`" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:205 +#: distutils/sourcedist.rst:205 msgid "" "Now we have our complete list of files, which is written to the manifest for " "future reference, and then used to build the source distribution archive(s)." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:208 +#: distutils/sourcedist.rst:208 msgid "" "You can disable the default set of included files with the :option:`--no-" "defaults` option, and you can disable the standard exclude set with :option:" "`--no-prune`." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:212 +#: distutils/sourcedist.rst:212 msgid "" "Following the Distutils' own manifest template, let's trace how the :command:" "`sdist` command builds the list of files to include in the Distutils source " @@ -5715,7 +5710,7 @@ msgid "" msgstr "" # b13c39c9d635443b9d3375bfdd9d33cc -#: ../src/Doc/distutils/sourcedist.rst:216 +#: distutils/sourcedist.rst:216 msgid "" "include all Python source files in the :file:`distutils` and :file:" "`distutils/command` subdirectories (because packages corresponding to those " @@ -5723,29 +5718,29 @@ msgid "" "script---see section :ref:`setup-script`)" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:221 +#: distutils/sourcedist.rst:221 msgid "" "include :file:`README.txt`, :file:`setup.py`, and :file:`setup.cfg` " "(standard files)" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:224 +#: distutils/sourcedist.rst:224 msgid "include :file:`test/test\\*.py` (standard files)" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:226 +#: distutils/sourcedist.rst:226 msgid "" "include :file:`\\*.txt` in the distribution root (this will find :file:" "`README.txt` a second time, but such redundancies are weeded out later)" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:229 +#: distutils/sourcedist.rst:229 msgid "" "include anything matching :file:`\\*.txt` or :file:`\\*.py` in the sub-tree " "under :file:`examples`," msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:232 +#: distutils/sourcedist.rst:232 msgid "" "exclude all files in the sub-trees starting at directories matching :file:" "`examples/sample?/build`\\ ---this may exclude files included by the " @@ -5753,14 +5748,14 @@ msgid "" "manifest template comes after the ``recursive-include`` command" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:237 +#: distutils/sourcedist.rst:237 msgid "" "exclude the entire :file:`build` tree, and any :file:`RCS`, :file:`CVS`, :" "file:`.svn`, :file:`.hg`, :file:`.git`, :file:`.bzr` and :file:`_darcs` " "directories" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:241 +#: distutils/sourcedist.rst:241 msgid "" "Just like in the setup script, file and directory names in the manifest " "template should always be slash-separated; the Distutils will take care of " @@ -5768,83 +5763,83 @@ msgid "" "the manifest template is portable across operating systems." msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:247 +#: distutils/sourcedist.rst:247 msgid "Commands" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:249 +#: distutils/sourcedist.rst:249 msgid "The manifest template commands are:" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:254 +#: distutils/sourcedist.rst:254 msgid ":command:`include pat1 pat2 ...`" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:254 +#: distutils/sourcedist.rst:254 msgid "include all files matching any of the listed patterns" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:257 +#: distutils/sourcedist.rst:257 msgid ":command:`exclude pat1 pat2 ...`" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:257 +#: distutils/sourcedist.rst:257 msgid "exclude all files matching any of the listed patterns" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:260 +#: distutils/sourcedist.rst:260 msgid ":command:`recursive-include dir pat1 pat2 ...`" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:260 +#: distutils/sourcedist.rst:260 msgid "include all files under *dir* matching any of the listed patterns" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:263 +#: distutils/sourcedist.rst:263 msgid ":command:`recursive-exclude dir pat1 pat2 ...`" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:263 +#: distutils/sourcedist.rst:263 msgid "exclude all files under *dir* matching any of the listed patterns" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:266 +#: distutils/sourcedist.rst:266 msgid ":command:`global-include pat1 pat2 ...`" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:266 +#: distutils/sourcedist.rst:266 msgid "" "include all files anywhere in the source tree matching --- & any of the " "listed patterns" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:269 +#: distutils/sourcedist.rst:269 msgid ":command:`global-exclude pat1 pat2 ...`" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:269 +#: distutils/sourcedist.rst:269 msgid "" "exclude all files anywhere in the source tree matching --- & any of the " "listed patterns" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:272 +#: distutils/sourcedist.rst:272 msgid ":command:`prune dir`" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:272 +#: distutils/sourcedist.rst:272 msgid "exclude all files under *dir*" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:274 +#: distutils/sourcedist.rst:274 msgid ":command:`graft dir`" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:274 +#: distutils/sourcedist.rst:274 msgid "include all files under *dir*" msgstr "" -#: ../src/Doc/distutils/sourcedist.rst:277 +#: distutils/sourcedist.rst:277 msgid "" "The patterns here are Unix-style \"glob\" patterns: ``*`` matches any " "sequence of regular filename characters, ``?`` matches any single regular " @@ -5854,12 +5849,12 @@ msgid "" "slash; on Windows anything except backslash or colon." msgstr "" -#: ../src/Doc/distutils/uploading.rst:5 +#: distutils/uploading.rst:5 msgid "Uploading Packages to the Package Index" msgstr "" # e6c00eaa31234866b03c24495d9fb3f9 -#: ../src/Doc/distutils/uploading.rst:7 +#: distutils/uploading.rst:7 msgid "" "The contents of this page have moved to the section :ref:`package-index`." msgstr "" diff --git a/extending.po b/extending.po index 58da01d9..1b82f9b8 100644 --- a/extending.po +++ b/extending.po @@ -7,22 +7,22 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/extending/building.rst:8 +#: extending/building.rst:8 #, fuzzy msgid "Building C and C++ Extensions with distutils" msgstr "Construire les extensions C et C + + avec distutils" -#: ../src/Doc/extending/building.rst:13 +#: extending/building.rst:13 msgid "" "Starting in Python 1.4, Python provides, on Unix, a special make file for " "building make files for building dynamically-linked extensions and custom " @@ -32,7 +32,7 @@ msgid "" "distutils." msgstr "" -#: ../src/Doc/extending/building.rst:20 +#: extending/building.rst:20 msgid "" "Building an extension module using distutils requires that distutils is " "installed on the build machine, which is included in Python 2.x and " @@ -41,17 +41,17 @@ msgid "" "install the extension." msgstr "" -#: ../src/Doc/extending/building.rst:26 +#: extending/building.rst:26 msgid "" "A distutils package contains a driver script, :file:`setup.py`. This is a " "plain Python file, which, in the most simple case, could look like this::" msgstr "" -#: ../src/Doc/extending/building.rst:40 +#: extending/building.rst:40 msgid "With this :file:`setup.py`, and a file :file:`demo.c`, running ::" msgstr "" -#: ../src/Doc/extending/building.rst:44 +#: extending/building.rst:44 msgid "" "will compile :file:`demo.c`, and produce an extension module named ``demo`` " "in the :file:`build` directory. Depending on the system, the module file " @@ -59,7 +59,7 @@ msgid "" "like :file:`demo.so` or :file:`demo.pyd`." msgstr "" -#: ../src/Doc/extending/building.rst:49 +#: extending/building.rst:49 msgid "" "In the :file:`setup.py`, all execution is performed by calling the ``setup`` " "function. This takes a variable number of keyword arguments, of which the " @@ -71,25 +71,24 @@ msgid "" "features of distutils; this section explains building extension modules only." msgstr "" -# 342c94075a924cd39ff6f35da35ee836 -#: ../src/Doc/extending/building.rst:58 +#: extending/building.rst:58 msgid "" "It is common to pre-compute arguments to :func:`setup`, to better structure " -"the driver script. In the example above, the\\ ``ext_modules`` argument to :" +"the driver script. In the example above, the ``ext_modules`` argument to :" "func:`setup` is a list of extension modules, each of which is an instance of " "the :class:`~distutils.extension.Extension`. In the example, the instance " "defines an extension named ``demo`` which is build by compiling a single " "source file, :file:`demo.c`." msgstr "" -#: ../src/Doc/extending/building.rst:65 +#: extending/building.rst:65 msgid "" "In many cases, building an extension is more complex, since additional " "preprocessor defines and libraries may be needed. This is demonstrated in " "the example below. ::" msgstr "" -#: ../src/Doc/extending/building.rst:91 +#: extending/building.rst:91 msgid "" "In this example, :func:`setup` is called with additional meta-information, " "which is recommended when distribution packages have to be built. For the " @@ -99,51 +98,51 @@ msgid "" "Unix, this may result in the compilation commands ::" msgstr "" -#: ../src/Doc/extending/building.rst:102 +#: extending/building.rst:102 msgid "" "These lines are for demonstration purposes only; distutils users should " "trust that distutils gets the invocations right." msgstr "" -#: ../src/Doc/extending/building.rst:109 +#: extending/building.rst:109 msgid "Distributing your extension modules" msgstr "" -#: ../src/Doc/extending/building.rst:111 +#: extending/building.rst:111 msgid "" "When an extension has been successfully build, there are three ways to use " "it." msgstr "" -#: ../src/Doc/extending/building.rst:113 +#: extending/building.rst:113 msgid "" "End-users will typically want to install the module, they do so by running ::" msgstr "" -#: ../src/Doc/extending/building.rst:117 +#: extending/building.rst:117 msgid "" "Module maintainers should produce source packages; to do so, they run ::" msgstr "" -#: ../src/Doc/extending/building.rst:121 +#: extending/building.rst:121 msgid "" "In some cases, additional files need to be included in a source " "distribution; this is done through a :file:`MANIFEST.in` file; see the " "distutils documentation for details." msgstr "" -#: ../src/Doc/extending/building.rst:125 +#: extending/building.rst:125 msgid "" "If the source distribution has been build successfully, maintainers can also " "create binary distributions. Depending on the platform, one of the following " "commands can be used to do so. ::" msgstr "" -#: ../src/Doc/extending/embedding.rst:8 +#: extending/embedding.rst:8 msgid "Embedding Python in Another Application" msgstr "" -#: ../src/Doc/extending/embedding.rst:10 +#: extending/embedding.rst:10 msgid "" "The previous chapters discussed how to extend Python, that is, how to extend " "the functionality of Python by attaching a library of C functions to it. It " @@ -156,7 +155,7 @@ msgid "" "functionality can be written in Python more easily." msgstr "" -#: ../src/Doc/extending/embedding.rst:20 +#: extending/embedding.rst:20 msgid "" "Embedding Python is similar to extending it, but not quite. The difference " "is that when you extend Python, the main program of the application is still " @@ -166,7 +165,7 @@ msgid "" msgstr "" # 3349405bb5884228afac17315062a7b3 -#: ../src/Doc/extending/embedding.rst:26 +#: extending/embedding.rst:26 msgid "" "So if you are embedding Python, you are providing your own main program. " "One of the things this main program has to do is initialize the Python " @@ -177,7 +176,7 @@ msgid "" msgstr "" # 2fee2b21444c48fcbc33bf615faa320a -#: ../src/Doc/extending/embedding.rst:32 +#: extending/embedding.rst:32 msgid "" "There are several different ways to call the interpreter: you can pass a " "string containing Python statements to :c:func:`PyRun_SimpleString`, or you " @@ -187,28 +186,27 @@ msgid "" "Python objects." msgstr "" -#: ../src/Doc/extending/embedding.rst:38 +#: extending/embedding.rst:38 msgid "" "A simple demo of embedding Python can be found in the directory :file:`Demo/" "embed/` of the source distribution." msgstr "" -# 3aa0cf1364c54315877c9429264de422 -#: ../src/Doc/extending/embedding.rst:44 -msgid ":ref:`c-api-index`" +#: extending/embedding.rst:45 +msgid "c-api-index" msgstr "" -#: ../src/Doc/extending/embedding.rst:45 +#: extending/embedding.rst:45 msgid "" "The details of Python's C interface are given in this manual. A great deal " "of necessary information can be found here." msgstr "" -#: ../src/Doc/extending/embedding.rst:52 +#: extending/embedding.rst:52 msgid "Very High Level Embedding" msgstr "" -#: ../src/Doc/extending/embedding.rst:54 +#: extending/embedding.rst:54 msgid "" "The simplest form of embedding Python is the use of the very high level " "interface. This interface is intended to execute a Python script without " @@ -217,7 +215,7 @@ msgid "" msgstr "" # a8a877d20c464cfd840409fbdeba8d65 -#: ../src/Doc/extending/embedding.rst:72 +#: extending/embedding.rst:72 msgid "" "The :c:func:`Py_SetProgramName` function should be called before :c:func:" "`Py_Initialize` to inform the interpreter about paths to Python run-time " @@ -232,11 +230,11 @@ msgid "" "contents." msgstr "" -#: ../src/Doc/extending/embedding.rst:87 +#: extending/embedding.rst:87 msgid "Beyond Very High Level Embedding: An overview" msgstr "" -#: ../src/Doc/extending/embedding.rst:89 +#: extending/embedding.rst:89 msgid "" "The high level interface gives you the ability to execute arbitrary pieces " "of Python code from your application, but exchanging data values is quite " @@ -245,7 +243,7 @@ msgid "" "anything." msgstr "" -#: ../src/Doc/extending/embedding.rst:94 +#: extending/embedding.rst:94 msgid "" "It should be noted that extending Python and embedding Python is quite the " "same activity, despite the different intent. Most topics discussed in the " @@ -253,37 +251,37 @@ msgid "" "code from Python to C really does:" msgstr "" -#: ../src/Doc/extending/embedding.rst:99 +#: extending/embedding.rst:99 msgid "Convert data values from Python to C," msgstr "" -#: ../src/Doc/extending/embedding.rst:101 +#: extending/embedding.rst:101 msgid "Perform a function call to a C routine using the converted values, and" msgstr "" -#: ../src/Doc/extending/embedding.rst:103 +#: extending/embedding.rst:103 msgid "Convert the data values from the call from C to Python." msgstr "" -#: ../src/Doc/extending/embedding.rst:105 +#: extending/embedding.rst:105 msgid "When embedding Python, the interface code does:" msgstr "" -#: ../src/Doc/extending/embedding.rst:107 +#: extending/embedding.rst:107 msgid "Convert data values from C to Python," msgstr "" -#: ../src/Doc/extending/embedding.rst:109 +#: extending/embedding.rst:109 msgid "" "Perform a function call to a Python interface routine using the converted " "values, and" msgstr "" -#: ../src/Doc/extending/embedding.rst:112 +#: extending/embedding.rst:112 msgid "Convert the data values from the call from Python to C." msgstr "" -#: ../src/Doc/extending/embedding.rst:114 +#: extending/embedding.rst:114 msgid "" "As you can see, the data conversion steps are simply swapped to accommodate " "the different direction of the cross-language transfer. The only difference " @@ -291,7 +289,7 @@ msgid "" "you call a C routine, when embedding, you call a Python routine." msgstr "" -#: ../src/Doc/extending/embedding.rst:119 +#: extending/embedding.rst:119 msgid "" "This chapter will not discuss how to convert data from Python to C and vice " "versa. Also, proper use of references and dealing with errors is assumed to " @@ -299,11 +297,11 @@ msgid "" "interpreter, you can refer to earlier chapters for the required information." msgstr "" -#: ../src/Doc/extending/embedding.rst:128 +#: extending/embedding.rst:128 msgid "Pure Embedding" msgstr "" -#: ../src/Doc/extending/embedding.rst:130 +#: extending/embedding.rst:130 msgid "" "The first program aims to execute a function in a Python script. Like in the " "section about the very high level interface, the Python interpreter does not " @@ -311,12 +309,12 @@ msgid "" "section)." msgstr "" -#: ../src/Doc/extending/embedding.rst:135 +#: extending/embedding.rst:135 msgid "The code to run a function defined in a Python script is:" msgstr "" # 24a8b07191e34a9490bd8474e32e3d67 -#: ../src/Doc/extending/embedding.rst:140 +#: extending/embedding.rst:140 msgid "" "This code loads a Python script using ``argv[1]``, and calls the function " "named in ``argv[2]``. Its integer arguments are the other values of the " @@ -325,11 +323,11 @@ msgid "" "such as:" msgstr "" -#: ../src/Doc/extending/embedding.rst:154 +#: extending/embedding.rst:154 msgid "then the result should be::" msgstr "" -#: ../src/Doc/extending/embedding.rst:160 +#: extending/embedding.rst:160 msgid "" "Although the program is quite large for its functionality, most of the code " "is for data conversion between Python and C, and for error reporting. The " @@ -337,7 +335,7 @@ msgid "" msgstr "" # dc2a9d1c15044827aafd426bf84b472a -#: ../src/Doc/extending/embedding.rst:169 +#: extending/embedding.rst:169 msgid "" "After initializing the interpreter, the script is loaded using :c:func:" "`PyImport_Import`. This routine needs a Python string as its argument, " @@ -346,7 +344,7 @@ msgid "" msgstr "" # 61325f6f158d4f3e93f341879b3d9276 -#: ../src/Doc/extending/embedding.rst:182 +#: extending/embedding.rst:182 msgid "" "Once the script is loaded, the name we're looking for is retrieved using :c:" "func:`PyObject_GetAttrString`. If the name exists, and the object returned " @@ -355,18 +353,18 @@ msgid "" "Python function is then made with::" msgstr "" -#: ../src/Doc/extending/embedding.rst:190 +#: extending/embedding.rst:190 msgid "" "Upon return of the function, ``pValue`` is either *NULL* or it contains a " "reference to the return value of the function. Be sure to release the " "reference after examining the value." msgstr "" -#: ../src/Doc/extending/embedding.rst:198 +#: extending/embedding.rst:198 msgid "Extending Embedded Python" msgstr "" -#: ../src/Doc/extending/embedding.rst:200 +#: extending/embedding.rst:200 msgid "" "Until now, the embedded Python interpreter had no access to functionality " "from the application itself. The Python API allows this by extending the " @@ -379,31 +377,31 @@ msgid "" msgstr "" # e3a28dc7453b48aaa3152dbb130353ec -#: ../src/Doc/extending/embedding.rst:226 +#: extending/embedding.rst:226 msgid "" "Insert the above code just above the :c:func:`main` function. Also, insert " "the following two statements directly after :c:func:`Py_Initialize`::" msgstr "" # e374af9b79d6490f99a2a9e490eb45d5 -#: ../src/Doc/extending/embedding.rst:232 +#: extending/embedding.rst:232 msgid "" "These two lines initialize the ``numargs`` variable, and make the :func:`emb." "numargs` function accessible to the embedded Python interpreter. With these " "extensions, the Python script can do things like" msgstr "" -#: ../src/Doc/extending/embedding.rst:241 +#: extending/embedding.rst:241 msgid "" "In a real application, the methods will expose an API of the application to " "Python." msgstr "" -#: ../src/Doc/extending/embedding.rst:251 +#: extending/embedding.rst:251 msgid "Embedding Python in C++" msgstr "" -#: ../src/Doc/extending/embedding.rst:253 +#: extending/embedding.rst:253 msgid "" "It is also possible to embed Python in a C++ program; precisely how this is " "done will depend on the details of the C++ system used; in general you will " @@ -413,12 +411,12 @@ msgid "" msgstr "" # 44dca6105a3242e290f38c806b5809c8 -#: ../src/Doc/extending/embedding.rst:262 +#: extending/embedding.rst:262 msgid "Compiling and Linking under Unix-like systems" msgstr "" # 93ed4ba539024e3b8dcb225629991679 -#: ../src/Doc/extending/embedding.rst:264 +#: extending/embedding.rst:264 msgid "" "It is not necessarily trivial to find the right flags to pass to your " "compiler (and linker) in order to embed the Python interpreter into your " @@ -427,7 +425,7 @@ msgid "" msgstr "" # 8b508760472948ada9ab32e38a8344ed -#: ../src/Doc/extending/embedding.rst:270 +#: extending/embedding.rst:270 msgid "" "To find out the required compiler and linker flags, you can execute the :" "file:`python{X.Y}-config` script which is generated as part of the " @@ -437,21 +435,21 @@ msgid "" msgstr "" # 021f45b6ace34a1a94f77d8418efc694 -#: ../src/Doc/extending/embedding.rst:276 +#: extending/embedding.rst:276 msgid "" "``pythonX.Y-config --cflags`` will give you the recommended flags when " "compiling::" msgstr "" # 430001bf3ed8482d91eba2ea79d6599f -#: ../src/Doc/extending/embedding.rst:282 +#: extending/embedding.rst:282 msgid "" "``pythonX.Y-config --ldflags`` will give you the recommended flags when " "linking::" msgstr "" # 2994040c1726440e9a01b2815a263040 -#: ../src/Doc/extending/embedding.rst:289 +#: extending/embedding.rst:289 msgid "" "To avoid confusion between several Python installations (and especially " "between the system Python and your own compiled Python), it is recommended " @@ -460,7 +458,7 @@ msgid "" msgstr "" # 7201c9d013124418a95e2f84ee53db55 -#: ../src/Doc/extending/embedding.rst:294 +#: extending/embedding.rst:294 msgid "" "If this procedure doesn't work for you (it is not guaranteed to work for all " "Unix-like platforms; however, we welcome :ref:`bug reports `_ library rather than " +"writing custom C code. These modules let you write Python code to interface " +"with C code and are more portable between implementations of Python than " +"writing and compiling a C extension module." msgstr "" -#: ../src/Doc/extending/extending.rst:34 +#: extending/extending.rst:39 #, fuzzy msgid "A Simple Example" msgstr "Un exemple simple" # f29189ec471c41cd8fab25f67821795d -#: ../src/Doc/extending/extending.rst:36 +#: extending/extending.rst:41 msgid "" "Let's create an extension module called ``spam`` (the favorite food of Monty " "Python fans...) and let's say we want to create a Python interface to the C " @@ -523,7 +524,7 @@ msgid "" "this function to be callable from Python as follows::" msgstr "" -#: ../src/Doc/extending/extending.rst:45 +#: extending/extending.rst:50 msgid "" "Begin by creating a file :file:`spammodule.c`. (Historically, if a module " "is called ``spam``, the C file containing its implementation is called :file:" @@ -531,18 +532,18 @@ msgid "" "module name can be just :file:`spammify.c`.)" msgstr "" -#: ../src/Doc/extending/extending.rst:50 +#: extending/extending.rst:55 #, fuzzy msgid "The first line of our file can be::" msgstr "La première ligne de notre fichier peut être:" -#: ../src/Doc/extending/extending.rst:54 +#: extending/extending.rst:59 msgid "" "which pulls in the Python API (you can add a comment describing the purpose " "of the module and a copyright notice if you like)." msgstr "" -#: ../src/Doc/extending/extending.rst:59 +#: extending/extending.rst:64 msgid "" "Since Python may define some pre-processor definitions which affect the " "standard headers on some systems, you *must* include :file:`Python.h` before " @@ -550,7 +551,7 @@ msgid "" msgstr "" # fa43971877c844418f03b4566324fed6 -#: ../src/Doc/extending/extending.rst:63 +#: extending/extending.rst:68 msgid "" "All user-visible symbols defined by :file:`Python.h` have a prefix of ``Py`` " "or ``PY``, except those defined in standard header files. For convenience, " @@ -561,14 +562,14 @@ msgid "" "and :c:func:`realloc` directly." msgstr "" -#: ../src/Doc/extending/extending.rst:71 +#: extending/extending.rst:76 msgid "" "The next thing we add to our module file is the C function that will be " "called when the Python expression ``spam.system(string)`` is evaluated " "(we'll see shortly how it ends up being called)::" msgstr "" -#: ../src/Doc/extending/extending.rst:87 +#: extending/extending.rst:92 msgid "" "There is a straightforward translation from the argument list in Python (for " "example, the single expression ``\"ls -l\"``) to the arguments passed to the " @@ -577,7 +578,7 @@ msgid "" msgstr "" # 619c4e5d255b4c3ca1789a2efd59b3ee -#: ../src/Doc/extending/extending.rst:92 +#: extending/extending.rst:97 msgid "" "For module functions, the *self* argument is *NULL* or a pointer selected " "while initializing the module (see :c:func:`Py_InitModule4`). For a method, " @@ -585,7 +586,7 @@ msgid "" msgstr "" # e61902774f844d1b8dce17ac441fa96a -#: ../src/Doc/extending/extending.rst:96 +#: extending/extending.rst:101 msgid "" "The *args* argument will be a pointer to a Python tuple object containing " "the arguments. Each item of the tuple corresponds to an argument in the " @@ -598,7 +599,7 @@ msgid "" msgstr "" # d458a69cd398407e82c060b308578a62 -#: ../src/Doc/extending/extending.rst:105 +#: extending/extending.rst:110 msgid "" ":c:func:`PyArg_ParseTuple` returns true (nonzero) if all arguments have the " "right type and its components have been stored in the variables whose " @@ -608,12 +609,12 @@ msgid "" "example)." msgstr "" -#: ../src/Doc/extending/extending.rst:115 +#: extending/extending.rst:120 msgid "Intermezzo: Errors and Exceptions" msgstr "" # 0ec9cd212ade4dfc8a29b8a10b609289 -#: ../src/Doc/extending/extending.rst:117 +#: extending/extending.rst:122 msgid "" "An important convention throughout the Python interpreter is the following: " "when a function fails, it should set an exception condition and return an " @@ -628,14 +629,14 @@ msgid "" "important to know about them to understand how errors are passed around." msgstr "" -#: ../src/Doc/extending/extending.rst:129 +#: extending/extending.rst:134 msgid "" "The Python API defines a number of functions to set various types of " "exceptions." msgstr "" # 3b52f1f297084e77b5eeaa2944e452e9 -#: ../src/Doc/extending/extending.rst:131 +#: extending/extending.rst:136 msgid "" "The most common one is :c:func:`PyErr_SetString`. Its arguments are an " "exception object and a C string. The exception object is usually a " @@ -645,7 +646,7 @@ msgid "" msgstr "" # 001c9fa90bbe4d1ea1a579fe28bb70c7 -#: ../src/Doc/extending/extending.rst:137 +#: extending/extending.rst:142 msgid "" "Another useful function is :c:func:`PyErr_SetFromErrno`, which only takes an " "exception argument and constructs the associated value by inspection of the " @@ -656,7 +657,7 @@ msgid "" msgstr "" # 83b4af02ae624c988ab82888b1811c18 -#: ../src/Doc/extending/extending.rst:144 +#: extending/extending.rst:149 msgid "" "You can test non-destructively whether an exception has been set with :c:" "func:`PyErr_Occurred`. This returns the current exception object, or *NULL* " @@ -666,7 +667,7 @@ msgid "" msgstr "" # 2db65c5053424043b6d8619f45b62c74 -#: ../src/Doc/extending/extending.rst:150 +#: extending/extending.rst:155 msgid "" "When a function *f* that calls another function *g* detects that the latter " "fails, *f* should itself return an error value (usually *NULL* or ``-1``). " @@ -681,7 +682,7 @@ msgid "" msgstr "" # a60d5722171e461d908fd5c12be5c595 -#: ../src/Doc/extending/extending.rst:160 +#: extending/extending.rst:165 msgid "" "(There are situations where a module can actually give a more detailed error " "message by calling another :c:func:`PyErr_\\*` function, and in such cases " @@ -691,7 +692,7 @@ msgid "" msgstr "" # bc0ae3fdb33642178f4235364ca70345 -#: ../src/Doc/extending/extending.rst:166 +#: extending/extending.rst:171 msgid "" "To ignore an exception set by a function call that failed, the exception " "condition must be cleared explicitly by calling :c:func:`PyErr_Clear`. The " @@ -701,7 +702,7 @@ msgid "" msgstr "" # a3f1e3ed53ff4e9e84717c861c3050dc -#: ../src/Doc/extending/extending.rst:172 +#: extending/extending.rst:177 msgid "" "Every failing :c:func:`malloc` call must be turned into an exception --- the " "direct caller of :c:func:`malloc` (or :c:func:`realloc`) must call :c:func:" @@ -711,7 +712,7 @@ msgid "" msgstr "" # b1880b1a76504ea495d77744d7309b43 -#: ../src/Doc/extending/extending.rst:178 +#: extending/extending.rst:183 msgid "" "Also note that, with the important exception of :c:func:`PyArg_ParseTuple` " "and friends, functions that return an integer status usually return a " @@ -720,7 +721,7 @@ msgid "" msgstr "" # 4033d5b3db594253a10a4a61fdcca46c -#: ../src/Doc/extending/extending.rst:182 +#: extending/extending.rst:187 msgid "" "Finally, be careful to clean up garbage (by making :c:func:`Py_XDECREF` or :" "c:func:`Py_DECREF` calls for objects you have already created) when you " @@ -728,7 +729,7 @@ msgid "" msgstr "" # a4e6513d01294765a4c83895d1cc41d7 -#: ../src/Doc/extending/extending.rst:186 +#: extending/extending.rst:191 msgid "" "The choice of which exception to raise is entirely yours. There are " "predeclared C objects corresponding to all built-in Python exceptions, such " @@ -741,14 +742,14 @@ msgid "" "satisfy other conditions, :c:data:`PyExc_ValueError` is appropriate." msgstr "" -#: ../src/Doc/extending/extending.rst:196 +#: extending/extending.rst:201 msgid "" "You can also define a new exception that is unique to your module. For this, " "you usually declare a static object variable at the beginning of your file::" msgstr "" # 018562d96ab044ee9733e3dc5a66e2d9 -#: ../src/Doc/extending/extending.rst:201 +#: extending/extending.rst:206 msgid "" "and initialize it in your module's initialization function (:c:func:" "`initspam`) with an exception object (leaving out the error checking for " @@ -756,7 +757,7 @@ msgid "" msgstr "" # a542a8a47a2e4145973b937428c8c4ba -#: ../src/Doc/extending/extending.rst:218 +#: extending/extending.rst:223 msgid "" "Note that the Python name for the exception object is :exc:`spam.error`. " "The :c:func:`PyErr_NewException` function may create a class with the base " @@ -765,7 +766,7 @@ msgid "" msgstr "" # e4ea678a9dac41b0a0d697b67004fd86 -#: ../src/Doc/extending/extending.rst:223 +#: extending/extending.rst:228 msgid "" "Note also that the :c:data:`SpamError` variable retains a reference to the " "newly created exception class; this is intentional! Since the exception " @@ -777,31 +778,31 @@ msgid "" msgstr "" # 9bb58cdf6e0248b897ca3339d1e71acf -#: ../src/Doc/extending/extending.rst:230 +#: extending/extending.rst:235 msgid "" "We discuss the use of ``PyMODINIT_FUNC`` as a function return type later in " "this sample." msgstr "" # f2207311e9cd47a09df71e0ee5b09abb -#: ../src/Doc/extending/extending.rst:233 +#: extending/extending.rst:238 msgid "" "The :exc:`spam.error` exception can be raised in your extension module using " "a call to :c:func:`PyErr_SetString` as shown below::" msgstr "" -#: ../src/Doc/extending/extending.rst:256 +#: extending/extending.rst:261 msgid "Back to the Example" msgstr "" -#: ../src/Doc/extending/extending.rst:258 +#: extending/extending.rst:263 msgid "" "Going back to our example function, you should now be able to understand " "this statement::" msgstr "" # b9ce94da94db4682b9df03a7e11a1f90 -#: ../src/Doc/extending/extending.rst:264 +#: extending/extending.rst:269 msgid "" "It returns *NULL* (the error indicator for functions returning object " "pointers) if an error is detected in the argument list, relying on the " @@ -813,14 +814,14 @@ msgid "" msgstr "" # a9a5fa4f6dc14f6cba0a145b3843e4ae -#: ../src/Doc/extending/extending.rst:272 +#: extending/extending.rst:277 msgid "" "The next statement is a call to the Unix function :c:func:`system`, passing " "it the string we just got from :c:func:`PyArg_ParseTuple`::" msgstr "" # 34ecacf047f847ad9e0365f4910c5985 -#: ../src/Doc/extending/extending.rst:277 +#: extending/extending.rst:282 msgid "" "Our :func:`spam.system` function must return the value of :c:data:`sts` as a " "Python object. This is done using the function :c:func:`Py_BuildValue`, " @@ -829,14 +830,14 @@ msgid "" "Python object. More info on :c:func:`Py_BuildValue` is given later. ::" msgstr "" -#: ../src/Doc/extending/extending.rst:285 +#: extending/extending.rst:290 msgid "" "In this case, it will return an integer object. (Yes, even integers are " "objects on the heap in Python!)" msgstr "" # 03157000bd2b4c3b982c21957d552b2f -#: ../src/Doc/extending/extending.rst:288 +#: extending/extending.rst:293 msgid "" "If you have a C function that returns no useful argument (a function " "returning :c:type:`void`), the corresponding Python function must return " @@ -845,26 +846,26 @@ msgid "" msgstr "" # f736f602207c474897a72b25505f4f7c -#: ../src/Doc/extending/extending.rst:296 +#: extending/extending.rst:301 msgid "" ":c:data:`Py_None` is the C name for the special Python object ``None``. It " "is a genuine Python object rather than a *NULL* pointer, which means \"error" "\" in most contexts, as we have seen." msgstr "" -#: ../src/Doc/extending/extending.rst:304 +#: extending/extending.rst:309 msgid "The Module's Method Table and Initialization Function" msgstr "" # c8c2986539094d0eb5c0c8b80478e3b5 -#: ../src/Doc/extending/extending.rst:306 +#: extending/extending.rst:311 msgid "" "I promised to show how :c:func:`spam_system` is called from Python programs. " "First, we need to list its name and address in a \"method table\"::" msgstr "" # 38dd15849ef548d39f059171b23ddec6 -#: ../src/Doc/extending/extending.rst:317 +#: extending/extending.rst:322 msgid "" "Note the third entry (``METH_VARARGS``). This is a flag telling the " "interpreter the calling convention to be used for the C function. It should " @@ -874,7 +875,7 @@ msgid "" msgstr "" # bb032e727939456ca78a5d4e4fdd6065 -#: ../src/Doc/extending/extending.rst:322 +#: extending/extending.rst:327 msgid "" "When using only ``METH_VARARGS``, the function should expect the Python-" "level parameters to be passed in as a tuple acceptable for parsing via :c:" @@ -882,7 +883,7 @@ msgid "" msgstr "" # 511a00001b2d4e028ce779b15d0e3aa4 -#: ../src/Doc/extending/extending.rst:326 +#: extending/extending.rst:331 msgid "" "The :const:`METH_KEYWORDS` bit may be set in the third field if keyword " "arguments should be passed to the function. In this case, the C function " @@ -892,7 +893,7 @@ msgid "" msgstr "" # cc9de65bdce54c0a991ce0a2103f2f55 -#: ../src/Doc/extending/extending.rst:332 +#: extending/extending.rst:337 msgid "" "The method table must be passed to the interpreter in the module's " "initialization function. The initialization function must be named :c:func:" @@ -901,7 +902,7 @@ msgid "" msgstr "" # dff31425e0cf4905831c3fadd6f24b87 -#: ../src/Doc/extending/extending.rst:343 +#: extending/extending.rst:348 msgid "" "Note that PyMODINIT_FUNC declares the function as ``void`` return type, " "declares any special linkage declarations required by the platform, and for " @@ -909,7 +910,7 @@ msgid "" msgstr "" # 725ecbe2a3a641b9bf4b4f047a5bf175 -#: ../src/Doc/extending/extending.rst:347 +#: extending/extending.rst:352 msgid "" "When the Python program imports module :mod:`spam` for the first time, :c:" "func:`initspam` is called. (See below for comments about embedding Python.) " @@ -924,7 +925,7 @@ msgid "" msgstr "" # b689098d952a43d5908f62169cf86f2a -#: ../src/Doc/extending/extending.rst:358 +#: extending/extending.rst:363 msgid "" "When embedding Python, the :c:func:`initspam` function is not called " "automatically unless there's an entry in the :c:data:`_PyImport_Inittab` " @@ -933,14 +934,14 @@ msgid "" "call to :c:func:`Py_Initialize`::" msgstr "" -#: ../src/Doc/extending/extending.rst:378 +#: extending/extending.rst:383 msgid "" "An example may be found in the file :file:`Demo/embed/demo.c` in the Python " "source distribution." msgstr "" # ada00ca2e2c648baa1c2f4ce1724d95c -#: ../src/Doc/extending/extending.rst:383 +#: extending/extending.rst:388 msgid "" "Removing entries from ``sys.modules`` or importing compiled modules into " "multiple interpreters within a process (or following a :c:func:`fork` " @@ -953,18 +954,18 @@ msgid "" "file (:file:`.so` on Unix, :file:`.dll` on Windows)." msgstr "" -#: ../src/Doc/extending/extending.rst:393 +#: extending/extending.rst:398 msgid "" "A more substantial example module is included in the Python source " "distribution as :file:`Modules/xxmodule.c`. This file may be used as a " "template or simply read as an example." msgstr "" -#: ../src/Doc/extending/extending.rst:401 +#: extending/extending.rst:406 msgid "Compilation and Linkage" msgstr "" -#: ../src/Doc/extending/extending.rst:403 +#: extending/extending.rst:408 msgid "" "There are two more things to do before you can use your new extension: " "compiling and linking it with the Python system. If you use dynamic " @@ -974,7 +975,7 @@ msgid "" "Windows (chapter :ref:`building-on-windows`) for more information about this." msgstr "" -#: ../src/Doc/extending/extending.rst:410 +#: extending/extending.rst:415 msgid "" "If you can't use dynamic loading, or if you want to make your module a " "permanent part of the Python interpreter, you will have to change the " @@ -984,7 +985,7 @@ msgid "" "line to the file :file:`Modules/Setup.local` describing your file::" msgstr "" -#: ../src/Doc/extending/extending.rst:419 +#: extending/extending.rst:424 msgid "" "and rebuild the interpreter by running :program:`make` in the toplevel " "directory. You can also run :program:`make` in the :file:`Modules/` " @@ -993,17 +994,17 @@ msgid "" "the :file:`Setup` file.)" msgstr "" -#: ../src/Doc/extending/extending.rst:425 +#: extending/extending.rst:430 msgid "" "If your module requires additional libraries to link with, these can be " "listed on the line in the configuration file as well, for instance::" msgstr "" -#: ../src/Doc/extending/extending.rst:434 +#: extending/extending.rst:439 msgid "Calling Python Functions from C" msgstr "" -#: ../src/Doc/extending/extending.rst:436 +#: extending/extending.rst:441 msgid "" "So far we have concentrated on making C functions callable from Python. The " "reverse is also useful: calling Python functions from C. This is especially " @@ -1014,7 +1015,7 @@ msgid "" "uses are also imaginable." msgstr "" -#: ../src/Doc/extending/extending.rst:444 +#: extending/extending.rst:449 msgid "" "Fortunately, the Python interpreter is easily called recursively, and there " "is a standard interface to call a Python function. (I won't dwell on how to " @@ -1024,7 +1025,7 @@ msgid "" msgstr "" # d84f06a0ed614ecb9d7bde191044c82e -#: ../src/Doc/extending/extending.rst:450 +#: extending/extending.rst:455 msgid "" "Calling a Python function is easy. First, the Python program must somehow " "pass you the Python function object. You should provide a function (or some " @@ -1035,7 +1036,7 @@ msgid "" msgstr "" # 1ab06a081f8446fe81d605883f039440 -#: ../src/Doc/extending/extending.rst:480 +#: extending/extending.rst:485 msgid "" "This function must be registered with the interpreter using the :const:" "`METH_VARARGS` flag; this is described in section :ref:`methodtable`. The :" @@ -1044,7 +1045,7 @@ msgid "" msgstr "" # 4773842aa8d6456e8dc7264ddc43012a -#: ../src/Doc/extending/extending.rst:485 +#: extending/extending.rst:490 msgid "" "The macros :c:func:`Py_XINCREF` and :c:func:`Py_XDECREF` increment/decrement " "the reference count of an object and are safe in the presence of *NULL* " @@ -1053,7 +1054,7 @@ msgid "" msgstr "" # e88a129dc38b4bc9bd312e6318c61645 -#: ../src/Doc/extending/extending.rst:492 +#: extending/extending.rst:497 msgid "" "Later, when it is time to call the function, you call the C function :c:func:" "`PyObject_CallObject`. This function has two arguments, both pointers to " @@ -1066,7 +1067,7 @@ msgid "" msgstr "" # 3936e324f3b7408a815ce2014a7d2b88 -#: ../src/Doc/extending/extending.rst:512 +#: extending/extending.rst:517 msgid "" ":c:func:`PyObject_CallObject` returns a Python object pointer: this is the " "return value of the Python function. :c:func:`PyObject_CallObject` is " @@ -1076,7 +1077,7 @@ msgid "" msgstr "" # e4fbc1a7d0a74b51a2a4925762265622 -#: ../src/Doc/extending/extending.rst:518 +#: extending/extending.rst:523 msgid "" "The return value of :c:func:`PyObject_CallObject` is \"new\": either it is a " "brand new object, or it is an existing object whose reference count has been " @@ -1086,7 +1087,7 @@ msgid "" msgstr "" # 4932fd44516f426da10ba37e850525d9 -#: ../src/Doc/extending/extending.rst:524 +#: extending/extending.rst:529 msgid "" "Before you do this, however, it is important to check that the return value " "isn't *NULL*. If it is, the Python function terminated by raising an " @@ -1098,7 +1099,7 @@ msgid "" msgstr "" # fee1f71d37aa42a49e3cc600b8809455 -#: ../src/Doc/extending/extending.rst:537 +#: extending/extending.rst:542 msgid "" "Depending on the desired interface to the Python callback function, you may " "also have to provide an argument list to :c:func:`PyObject_CallObject`. In " @@ -1111,7 +1112,7 @@ msgid "" msgstr "" # fbe00a824b8e4d93a324f0fbff91e1cf -#: ../src/Doc/extending/extending.rst:556 +#: extending/extending.rst:561 msgid "" "Note the placement of ``Py_DECREF(arglist)`` immediately after the call, " "before the error check! Also note that strictly speaking this code is not " @@ -1120,23 +1121,23 @@ msgid "" msgstr "" # a3e74e4418384c07aea2db87103f0981 -#: ../src/Doc/extending/extending.rst:560 +#: extending/extending.rst:565 msgid "" "You may also call a function with keyword arguments by using :c:func:" "`PyObject_Call`, which supports arguments and keyword arguments. As in the " "above example, we use :c:func:`Py_BuildValue` to construct the dictionary. ::" msgstr "" -#: ../src/Doc/extending/extending.rst:578 +#: extending/extending.rst:583 msgid "Extracting Parameters in Extension Functions" msgstr "" # d1c9a35a93434bd1b8a14f538b94f4df -#: ../src/Doc/extending/extending.rst:582 +#: extending/extending.rst:587 msgid "The :c:func:`PyArg_ParseTuple` function is declared as follows::" msgstr "" -#: ../src/Doc/extending/extending.rst:586 +#: extending/extending.rst:591 msgid "" "The *arg* argument must be a tuple object containing an argument list passed " "from Python to a C function. The *format* argument must be a format string, " @@ -1146,7 +1147,7 @@ msgid "" msgstr "" # c21f2837c53e4f72902bee5a23370d75 -#: ../src/Doc/extending/extending.rst:592 +#: extending/extending.rst:597 msgid "" "Note that while :c:func:`PyArg_ParseTuple` checks that the Python arguments " "have the required types, it cannot check the validity of the addresses of C " @@ -1154,7 +1155,7 @@ msgid "" "probably crash or at least overwrite random bits in memory. So be careful!" msgstr "" -#: ../src/Doc/extending/extending.rst:597 +#: extending/extending.rst:602 msgid "" "Note that any Python object references which are provided to the caller are " "*borrowed* references; do not decrement their reference count!" @@ -1163,22 +1164,22 @@ msgstr "" "à l'appelant sont des références *empruntées* ; ne décrémentez pas leur " "compteur de références ! " -#: ../src/Doc/extending/extending.rst:600 +#: extending/extending.rst:605 msgid "Some example calls::" msgstr "" -#: ../src/Doc/extending/extending.rst:665 +#: extending/extending.rst:670 msgid "Keyword Parameters for Extension Functions" msgstr "" # d89167f747964aa08520b68971e6a727 -#: ../src/Doc/extending/extending.rst:669 +#: extending/extending.rst:674 msgid "" "The :c:func:`PyArg_ParseTupleAndKeywords` function is declared as follows::" msgstr "" # b5902e44fca34fdcb14b1b55884aa142 -#: ../src/Doc/extending/extending.rst:674 +#: extending/extending.rst:679 msgid "" "The *arg* and *format* parameters are identical to those of the :c:func:" "`PyArg_ParseTuple` function. The *kwdict* parameter is the dictionary of " @@ -1189,32 +1190,32 @@ msgid "" "returns true, otherwise it returns false and raises an appropriate exception." msgstr "" -#: ../src/Doc/extending/extending.rst:684 +#: extending/extending.rst:689 msgid "" "Nested tuples cannot be parsed when using keyword arguments! Keyword " "parameters passed in which are not present in the *kwlist* will cause :exc:" "`TypeError` to be raised." msgstr "" -#: ../src/Doc/extending/extending.rst:690 +#: extending/extending.rst:695 msgid "" "Here is an example module which uses keywords, based on an example by Geoff " "Philbrick (philbrick@hks.com)::" msgstr "" -#: ../src/Doc/extending/extending.rst:741 +#: extending/extending.rst:746 msgid "Building Arbitrary Values" msgstr "" # 2ee08b048127479f828b67340e87bdc1 -#: ../src/Doc/extending/extending.rst:743 +#: extending/extending.rst:748 msgid "" "This function is the counterpart to :c:func:`PyArg_ParseTuple`. It is " "declared as follows::" msgstr "" # 3e246e0199f646859e07f3081493e84d -#: ../src/Doc/extending/extending.rst:748 +#: extending/extending.rst:753 msgid "" "It recognizes a set of format units similar to the ones recognized by :c:" "func:`PyArg_ParseTuple`, but the arguments (which are input to the function, " @@ -1223,7 +1224,7 @@ msgid "" msgstr "" # 3ee00798dc6246c995d4192457d61935 -#: ../src/Doc/extending/extending.rst:753 +#: extending/extending.rst:758 msgid "" "One difference with :c:func:`PyArg_ParseTuple`: while the latter requires " "its first argument to be a tuple (since Python argument lists are always " @@ -1235,17 +1236,17 @@ msgid "" "parenthesize the format string." msgstr "" -#: ../src/Doc/extending/extending.rst:761 +#: extending/extending.rst:766 msgid "" "Examples (to the left the call, to the right the resulting Python value)::" msgstr "" -#: ../src/Doc/extending/extending.rst:783 +#: extending/extending.rst:788 msgid "Reference Counts" msgstr "" # 42135682deb5488fb74974cb895a3fad -#: ../src/Doc/extending/extending.rst:785 +#: extending/extending.rst:790 msgid "" "In languages like C or C++, the programmer is responsible for dynamic " "allocation and deallocation of memory on the heap. In C, this is done using " @@ -1255,7 +1256,7 @@ msgid "" msgstr "" # c7282f2648e045b9a1d7c3ae46c9ed9f -#: ../src/Doc/extending/extending.rst:791 +#: extending/extending.rst:796 msgid "" "Every block of memory allocated with :c:func:`malloc` should eventually be " "returned to the pool of available memory by exactly one call to :c:func:" @@ -1270,7 +1271,7 @@ msgid "" "crashes." msgstr "" -#: ../src/Doc/extending/extending.rst:802 +#: extending/extending.rst:807 msgid "" "Common causes of memory leaks are unusual paths through the code. For " "instance, a function may allocate a block of memory, do some calculation, " @@ -1288,7 +1289,7 @@ msgid "" msgstr "" # 6acc7159f6204ae6a3ba57f1db38d90e -#: ../src/Doc/extending/extending.rst:815 +#: extending/extending.rst:820 msgid "" "Since Python makes heavy use of :c:func:`malloc` and :c:func:`free`, it " "needs a strategy to avoid memory leaks as well as the use of freed memory. " @@ -1300,7 +1301,7 @@ msgid "" msgstr "" # d8dc338348db44c7ba7833fb542ffd91 -#: ../src/Doc/extending/extending.rst:823 +#: extending/extending.rst:828 msgid "" "An alternative strategy is called :dfn:`automatic garbage collection`. " "(Sometimes, reference counting is also referred to as a garbage collection " @@ -1316,7 +1317,7 @@ msgid "" "with reference counts." msgstr "" -#: ../src/Doc/extending/extending.rst:835 +#: extending/extending.rst:840 msgid "" "While Python uses the traditional reference counting implementation, it also " "offers a cycle detector that works to detect reference cycles. This allows " @@ -1331,7 +1332,7 @@ msgid "" msgstr "" # 3448ac01407540809b83455bc097eb74 -#: ../src/Doc/extending/extending.rst:846 +#: extending/extending.rst:851 msgid "" "The cycle detector is able to detect garbage cycles and can reclaim them so " "long as there are no finalizers implemented in Python (:meth:`__del__` " @@ -1348,12 +1349,12 @@ msgid "" "the :mod:`gc` module will not be available." msgstr "" -#: ../src/Doc/extending/extending.rst:864 +#: extending/extending.rst:869 msgid "Reference Counting in Python" msgstr "" # 68af22ed0f784d9585e253e010e6335e -#: ../src/Doc/extending/extending.rst:866 +#: extending/extending.rst:871 msgid "" "There are two macros, ``Py_INCREF(x)`` and ``Py_DECREF(x)``, which handle " "the incrementing and decrementing of the reference count. :c:func:" @@ -1365,7 +1366,7 @@ msgid "" msgstr "" # 1ba6d884cdd64d9992090dc37ca5c6dd -#: ../src/Doc/extending/extending.rst:873 +#: extending/extending.rst:878 msgid "" "The big question now remains: when to use ``Py_INCREF(x)`` and " "``Py_DECREF(x)``? Let's first introduce some terms. Nobody \"owns\" an " @@ -1379,7 +1380,7 @@ msgid "" msgstr "" # b7214f2e9a7d44dd814e86bde6d31317 -#: ../src/Doc/extending/extending.rst:882 +#: extending/extending.rst:887 msgid "" "It is also possible to :dfn:`borrow` [#]_ a reference to an object. The " "borrower of a reference should not call :c:func:`Py_DECREF`. The borrower " @@ -1388,7 +1389,7 @@ msgid "" "risks using freed memory and should be avoided completely. [#]_" msgstr "" -#: ../src/Doc/extending/extending.rst:888 +#: extending/extending.rst:893 msgid "" "The advantage of borrowing over owning a reference is that you don't need to " "take care of disposing of the reference on all possible paths through the " @@ -1400,7 +1401,7 @@ msgid "" msgstr "" # cafe80da096043cc845b3fd8f0ad58fb -#: ../src/Doc/extending/extending.rst:896 +#: extending/extending.rst:901 msgid "" "A borrowed reference can be changed into an owned reference by calling :c:" "func:`Py_INCREF`. This does not affect the status of the owner from which " @@ -1409,11 +1410,11 @@ msgid "" "properly, as well as the previous owner)." msgstr "" -#: ../src/Doc/extending/extending.rst:906 +#: extending/extending.rst:911 msgid "Ownership Rules" msgstr "" -#: ../src/Doc/extending/extending.rst:908 +#: extending/extending.rst:913 msgid "" "Whenever an object reference is passed into or out of a function, it is part " "of the function's interface specification whether ownership is transferred " @@ -1421,7 +1422,7 @@ msgid "" msgstr "" # 8b720350a00d40a3a900b50b87afb338 -#: ../src/Doc/extending/extending.rst:912 +#: extending/extending.rst:917 msgid "" "Most functions that return a reference to an object pass on ownership with " "the reference. In particular, all functions whose function it is to create " @@ -1433,7 +1434,7 @@ msgid "" msgstr "" # 677a0bfbc98242a2856101994faa9fe5 -#: ../src/Doc/extending/extending.rst:920 +#: extending/extending.rst:925 msgid "" "Many functions that extract objects from other objects also transfer " "ownership with the reference, for instance :c:func:" @@ -1445,7 +1446,7 @@ msgid "" msgstr "" # 693b43597c5b48348c9a1e2a6a173ad3 -#: ../src/Doc/extending/extending.rst:927 +#: extending/extending.rst:932 msgid "" "The function :c:func:`PyImport_AddModule` also returns a borrowed reference, " "even though it may actually create the object it returns: this is possible " @@ -1453,7 +1454,7 @@ msgid "" msgstr "" # c621af407da24089821bec0fce80e298 -#: ../src/Doc/extending/extending.rst:931 +#: extending/extending.rst:936 msgid "" "When you pass an object reference into another function, in general, the " "function borrows the reference from you --- if it needs to store it, it will " @@ -1465,7 +1466,7 @@ msgid "" msgstr "" # b2c13dd2a346451897220e68569a5250 -#: ../src/Doc/extending/extending.rst:939 +#: extending/extending.rst:944 msgid "" "When a C function is called from Python, it borrows references to its " "arguments from the caller. The caller owns a reference to the object, so " @@ -1474,18 +1475,18 @@ msgid "" "turned into an owned reference by calling :c:func:`Py_INCREF`." msgstr "" -#: ../src/Doc/extending/extending.rst:945 +#: extending/extending.rst:950 msgid "" "The object reference returned from a C function that is called from Python " "must be an owned reference --- ownership is transferred from the function to " "its caller." msgstr "" -#: ../src/Doc/extending/extending.rst:953 +#: extending/extending.rst:958 msgid "Thin Ice" msgstr "" -#: ../src/Doc/extending/extending.rst:955 +#: extending/extending.rst:960 msgid "" "There are a few situations where seemingly harmless use of a borrowed " "reference can lead to problems. These all have to do with implicit " @@ -1494,14 +1495,14 @@ msgid "" msgstr "" # 70007764af0241c986f0f0ab63498221 -#: ../src/Doc/extending/extending.rst:959 +#: extending/extending.rst:964 msgid "" "The first and most important case to know about is using :c:func:`Py_DECREF` " "on an unrelated object while borrowing a reference to a list item. For " "instance::" msgstr "" -#: ../src/Doc/extending/extending.rst:971 +#: extending/extending.rst:976 msgid "" "This function first borrows a reference to ``list[0]``, then replaces " "``list[1]`` with the value ``0``, and finally prints the borrowed reference. " @@ -1509,7 +1510,7 @@ msgid "" msgstr "" # 367552d2efb4438299b4aef87f36311f -#: ../src/Doc/extending/extending.rst:975 +#: extending/extending.rst:980 msgid "" "Let's follow the control flow into :c:func:`PyList_SetItem`. The list owns " "references to all its items, so when item 1 is replaced, it has to dispose " @@ -1520,7 +1521,7 @@ msgid "" msgstr "" # be4685630bf748ceb5bfc65c26adac8c -#: ../src/Doc/extending/extending.rst:982 +#: extending/extending.rst:987 msgid "" "Since it is written in Python, the :meth:`__del__` method can execute " "arbitrary Python code. Could it perhaps do something to invalidate the " @@ -1531,13 +1532,13 @@ msgid "" "associated with it, thereby invalidating ``item``." msgstr "" -#: ../src/Doc/extending/extending.rst:990 +#: extending/extending.rst:995 msgid "" "The solution, once you know the source of the problem, is easy: temporarily " "increment the reference count. The correct version of the function reads::" msgstr "" -#: ../src/Doc/extending/extending.rst:1004 +#: extending/extending.rst:1009 msgid "" "This is a true story. An older version of Python contained variants of this " "bug and someone spent a considerable amount of time in a C debugger to " @@ -1545,7 +1546,7 @@ msgid "" msgstr "" # 29500693ffb94748abf71cca185a35b3 -#: ../src/Doc/extending/extending.rst:1008 +#: extending/extending.rst:1013 msgid "" "The second case of problems with a borrowed reference is a variant involving " "threads. Normally, multiple threads in the Python interpreter can't get in " @@ -1558,11 +1559,11 @@ msgid "" "previous one::" msgstr "" -#: ../src/Doc/extending/extending.rst:1031 +#: extending/extending.rst:1036 msgid "NULL Pointers" msgstr "" -#: ../src/Doc/extending/extending.rst:1033 +#: extending/extending.rst:1038 msgid "" "In general, functions that take object references as arguments do not expect " "you to pass them *NULL* pointers, and will dump core (or cause later core " @@ -1575,7 +1576,7 @@ msgid "" msgstr "" # 91b09be1f881491395bda1b96b4dd385 -#: ../src/Doc/extending/extending.rst:1041 +#: extending/extending.rst:1046 msgid "" "It is better to test for *NULL* only at the \"source:\" when a pointer that " "may be *NULL* is received, for example, from :c:func:`malloc` or from a " @@ -1583,14 +1584,14 @@ msgid "" msgstr "" # bb324c25da81451ea3739fa956bd4a0e -#: ../src/Doc/extending/extending.rst:1045 +#: extending/extending.rst:1050 msgid "" "The macros :c:func:`Py_INCREF` and :c:func:`Py_DECREF` do not check for " "*NULL* pointers --- however, their variants :c:func:`Py_XINCREF` and :c:func:" "`Py_XDECREF` do." msgstr "" -#: ../src/Doc/extending/extending.rst:1049 +#: extending/extending.rst:1054 msgid "" "The macros for checking for a particular object type (``Pytype_Check()``) " "don't check for *NULL* pointers --- again, there is much code that calls " @@ -1599,24 +1600,24 @@ msgid "" "variants with *NULL* checking." msgstr "" -#: ../src/Doc/extending/extending.rst:1055 +#: extending/extending.rst:1060 msgid "" "The C function calling mechanism guarantees that the argument list passed to " "C functions (``args`` in the examples) is never *NULL* --- in fact it " "guarantees that it is always a tuple. [#]_" msgstr "" -#: ../src/Doc/extending/extending.rst:1059 +#: extending/extending.rst:1064 msgid "" "It is a severe error to ever let a *NULL* pointer \"escape\" to the Python " "user." msgstr "" -#: ../src/Doc/extending/extending.rst:1070 +#: extending/extending.rst:1075 msgid "Writing Extensions in C++" msgstr "" -#: ../src/Doc/extending/extending.rst:1072 +#: extending/extending.rst:1077 msgid "" "It is possible to write extension modules in C++. Some restrictions apply. " "If the main program (the Python interpreter) is compiled and linked by the C " @@ -1629,11 +1630,11 @@ msgid "" "(all recent C++ compilers define this symbol)." msgstr "" -#: ../src/Doc/extending/extending.rst:1086 +#: extending/extending.rst:1091 msgid "Providing a C API for an Extension Module" msgstr "" -#: ../src/Doc/extending/extending.rst:1091 +#: extending/extending.rst:1096 msgid "" "Many extension modules just provide new functions and types to be used from " "Python, but sometimes the code in an extension module can be useful for " @@ -1644,7 +1645,7 @@ msgid "" "functions for direct manipulation from other extension modules." msgstr "" -#: ../src/Doc/extending/extending.rst:1099 +#: extending/extending.rst:1104 msgid "" "At first sight this seems easy: just write the functions (without declaring " "them ``static``, of course), provide an appropriate header file, and " @@ -1660,7 +1661,7 @@ msgid "" "call might not have been loaded yet!" msgstr "" -#: ../src/Doc/extending/extending.rst:1111 +#: extending/extending.rst:1116 msgid "" "Portability therefore requires not to make any assumptions about symbol " "visibility. This means that all symbols in extension modules should be " @@ -1671,7 +1672,7 @@ msgid "" msgstr "" # 81fe4deee4884f42b186510b8b3b039c -#: ../src/Doc/extending/extending.rst:1118 +#: extending/extending.rst:1123 msgid "" "Python provides a special mechanism to pass C-level information (pointers) " "from one extension module to another one: Capsules. A Capsule is a Python " @@ -1683,7 +1684,7 @@ msgid "" "the Capsule." msgstr "" -#: ../src/Doc/extending/extending.rst:1126 +#: extending/extending.rst:1131 msgid "" "There are many ways in which Capsules can be used to export the C API of an " "extension module. Each function could get its own Capsule, or all C API " @@ -1694,7 +1695,7 @@ msgid "" msgstr "" # 87caf616ef4b46f8aeb3e88519482dc5 -#: ../src/Doc/extending/extending.rst:1132 +#: extending/extending.rst:1137 msgid "" "Whichever method you choose, it's important to name your Capsules properly. " "The function :c:func:`PyCapsule_New` takes a name parameter (:c:type:`const " @@ -1704,14 +1705,14 @@ msgid "" "from another." msgstr "" -#: ../src/Doc/extending/extending.rst:1139 +#: extending/extending.rst:1144 msgid "" "In particular, Capsules used to expose C APIs should be given a name " "following this convention::" msgstr "" # 916a3f9ae2304f0187feffa2d85d2d57 -#: ../src/Doc/extending/extending.rst:1144 +#: extending/extending.rst:1149 msgid "" "The convenience function :c:func:`PyCapsule_Import` makes it easy to load a " "C API provided via a Capsule, but only if the Capsule's name matches this " @@ -1720,7 +1721,7 @@ msgid "" msgstr "" # fbe61b4d0a1b4eab9d43b1309f2fac12 -#: ../src/Doc/extending/extending.rst:1149 +#: extending/extending.rst:1154 msgid "" "The following example demonstrates an approach that puts most of the burden " "on the writer of the exporting module, which is appropriate for commonly " @@ -1732,7 +1733,7 @@ msgid "" msgstr "" # 79be34d50f564cf5811b0753cb0d5219 -#: ../src/Doc/extending/extending.rst:1157 +#: extending/extending.rst:1162 msgid "" "The exporting module is a modification of the :mod:`spam` module from " "section :ref:`extending-simpleexample`. The function :func:`spam.system` " @@ -1743,26 +1744,26 @@ msgid "" msgstr "" # accc63ad59b247cbb105dde259b23587 -#: ../src/Doc/extending/extending.rst:1164 +#: extending/extending.rst:1169 msgid "" "The function :c:func:`PySpam_System` is a plain C function, declared " "``static`` like everything else::" msgstr "" # 7ce21b481e234201a5f3b6b5e0d127a1 -#: ../src/Doc/extending/extending.rst:1173 +#: extending/extending.rst:1178 msgid "The function :c:func:`spam_system` is modified in a trivial way::" msgstr "" -#: ../src/Doc/extending/extending.rst:1187 +#: extending/extending.rst:1192 msgid "In the beginning of the module, right after the line ::" msgstr "" -#: ../src/Doc/extending/extending.rst:1191 +#: extending/extending.rst:1196 msgid "two more lines must be added::" msgstr "" -#: ../src/Doc/extending/extending.rst:1196 +#: extending/extending.rst:1201 msgid "" "The ``#define`` is used to tell the header file that it is being included in " "the exporting module, not a client module. Finally, the module's " @@ -1771,34 +1772,34 @@ msgid "" msgstr "" # be94a4a2227e43758eb15f598049854a -#: ../src/Doc/extending/extending.rst:1221 +#: extending/extending.rst:1226 msgid "" "Note that ``PySpam_API`` is declared ``static``; otherwise the pointer array " "would disappear when :func:`initspam` terminates!" msgstr "" -#: ../src/Doc/extending/extending.rst:1224 +#: extending/extending.rst:1229 msgid "" "The bulk of the work is in the header file :file:`spammodule.h`, which looks " "like this::" msgstr "" # cd0acf46805e4a61bdbae021ce29d019 -#: ../src/Doc/extending/extending.rst:1275 +#: extending/extending.rst:1280 msgid "" "All that a client module must do in order to have access to the function :c:" "func:`PySpam_System` is to call the function (or rather macro) :c:func:" "`import_spam` in its initialization function::" msgstr "" -#: ../src/Doc/extending/extending.rst:1292 +#: extending/extending.rst:1297 msgid "" "The main disadvantage of this approach is that the file :file:`spammodule.h` " "is rather complicated. However, the basic structure is the same for each " "function that is exported, so it has to be learned only once." msgstr "" -#: ../src/Doc/extending/extending.rst:1296 +#: extending/extending.rst:1301 msgid "" "Finally it should be mentioned that Capsules offer additional functionality, " "which is especially useful for memory allocation and deallocation of the " @@ -1808,42 +1809,41 @@ msgid "" "in the Python source code distribution)." msgstr "" -#: ../src/Doc/extending/extending.rst:1304 -#: ../src/Doc/extending/newtypes.rst:1565 +#: extending/extending.rst:1309 extending/newtypes.rst:1565 msgid "Footnotes" msgstr "Notes" -#: ../src/Doc/extending/extending.rst:1305 +#: extending/extending.rst:1310 msgid "" "An interface for this function already exists in the standard module :mod:" "`os` --- it was chosen as a simple and straightforward example." msgstr "" -#: ../src/Doc/extending/extending.rst:1308 +#: extending/extending.rst:1313 msgid "" "The metaphor of \"borrowing\" a reference is not completely correct: the " "owner still has a copy of the reference." msgstr "" -#: ../src/Doc/extending/extending.rst:1311 +#: extending/extending.rst:1316 msgid "" "Checking that the reference count is at least 1 **does not work** --- the " "reference count itself could be in freed memory and may thus be reused for " "another object!" msgstr "" -#: ../src/Doc/extending/extending.rst:1315 +#: extending/extending.rst:1320 msgid "" "These guarantees don't hold when you use the \"old\" style calling " "convention --- this is still found in much existing code." msgstr "" -#: ../src/Doc/extending/index.rst:5 +#: extending/index.rst:5 msgid "Extending and Embedding the Python Interpreter" msgstr "" # 1573b7c264264ea89483cfce4ac41e50 -#: ../src/Doc/extending/index.rst:7 +#: extending/index.rst:7 msgid "" "This document describes how to write modules in C or C++ to extend the " "Python interpreter with new modules. Those modules can not only define new " @@ -1854,7 +1854,7 @@ msgid "" "the interpreter, if the underlying operating system supports this feature." msgstr "" -#: ../src/Doc/extending/index.rst:15 +#: extending/index.rst:15 msgid "" "This document assumes basic knowledge about Python. For an informal " "introduction to the language, see :ref:`tutorial-index`. :ref:`reference-" @@ -1863,34 +1863,33 @@ msgid "" "and written in Python) that give the language its wide application range." msgstr "" -#: ../src/Doc/extending/index.rst:21 +#: extending/index.rst:21 msgid "" "For a detailed description of the whole Python/C API, see the separate :ref:" "`c-api-index`." msgstr "" -# 06e1f7615d2b454d892f64efca86cef7 -#: ../src/Doc/extending/index.rst:26 +#: extending/index.rst:26 msgid "" "This guide only covers the basic tools for creating extensions provided as " "part of this version of CPython. Third party tools may offer simpler " -"alternatives. Refer to the `binary extensions section `__ in the " -"Python Packaging User Guide for more information." +"alternatives. Refer to the `binary extensions section `__ in the Python Packaging User Guide for " +"more information." msgstr "" -#: ../src/Doc/extending/newtypes.rst:8 +#: extending/newtypes.rst:8 msgid "Defining New Types" msgstr "" -#: ../src/Doc/extending/newtypes.rst:15 +#: extending/newtypes.rst:15 msgid "" "As mentioned in the last chapter, Python allows the writer of an extension " "module to define new types that can be manipulated from Python code, much " "like strings and lists in core Python." msgstr "" -#: ../src/Doc/extending/newtypes.rst:19 +#: extending/newtypes.rst:19 msgid "" "This is not hard; the code for all extension types follows a pattern, but " "there are some details that you need to understand before you can get " @@ -1898,7 +1897,7 @@ msgid "" msgstr "" # 523c611a3a02419583af16677a1e3376 -#: ../src/Doc/extending/newtypes.rst:24 +#: extending/newtypes.rst:24 msgid "" "The way new types are defined changed dramatically (and for the better) in " "Python 2.2. This document documents how to define new types for Python 2.2 " @@ -1907,12 +1906,12 @@ msgid "" "doc/versions/>`_." msgstr "" -#: ../src/Doc/extending/newtypes.rst:34 +#: extending/newtypes.rst:34 msgid "The Basics" msgstr "" # 5bfead6d0d214c1a8f74069637b0a552 -#: ../src/Doc/extending/newtypes.rst:36 +#: extending/newtypes.rst:36 msgid "" "The Python runtime sees all Python objects as variables of type :c:type:" "`PyObject\\*`. A :c:type:`PyObject` is not a very magnificent object - it " @@ -1923,29 +1922,29 @@ msgid "" "methods\"." msgstr "" -#: ../src/Doc/extending/newtypes.rst:43 +#: extending/newtypes.rst:43 msgid "" "So, if you want to define a new object type, you need to create a new type " "object." msgstr "" -#: ../src/Doc/extending/newtypes.rst:46 +#: extending/newtypes.rst:46 msgid "" "This sort of thing can only be explained by example, so here's a minimal, " "but complete, module that defines a new type:" msgstr "" -#: ../src/Doc/extending/newtypes.rst:52 +#: extending/newtypes.rst:52 msgid "" "Now that's quite a bit to take in at once, but hopefully bits will seem " "familiar from the last chapter." msgstr "" -#: ../src/Doc/extending/newtypes.rst:55 +#: extending/newtypes.rst:55 msgid "The first bit that will be new is::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:61 +#: extending/newtypes.rst:61 msgid "" "This is what a Noddy object will contain---in this case, nothing more than " "every Python object contains, namely a refcount and a pointer to a type " @@ -1959,18 +1958,18 @@ msgid "" msgstr "" # fb32a938d4d741f0994828e4508e7602 -#: ../src/Doc/extending/newtypes.rst:71 +#: extending/newtypes.rst:71 msgid "" "For contrast, let's take a look at the corresponding definition for standard " "Python integers::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:79 +#: extending/newtypes.rst:79 msgid "Moving on, we come to the crunch --- the type object. ::" msgstr "" # 33467881d013421cbb0673810f603c9a -#: ../src/Doc/extending/newtypes.rst:106 +#: extending/newtypes.rst:106 msgid "" "Now if you go and look up the definition of :c:type:`PyTypeObject` in :file:" "`object.h` you'll see that it has many more fields that the definition " @@ -1978,18 +1977,18 @@ msgid "" "and it's common practice to not specify them explicitly unless you need them." msgstr "" -#: ../src/Doc/extending/newtypes.rst:111 +#: extending/newtypes.rst:111 msgid "" "This is so important that we're going to pick the top of it apart still " "further::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:116 +#: extending/newtypes.rst:116 msgid "This line is a bit of a wart; what we'd like to write is::" msgstr "" # b1080ad4b0a74008ad802887456494f4 -#: ../src/Doc/extending/newtypes.rst:120 +#: extending/newtypes.rst:120 msgid "" "as the type of a type object is \"type\", but this isn't strictly conforming " "C and some compilers complain. Fortunately, this member will be filled in " @@ -1997,7 +1996,7 @@ msgid "" msgstr "" # 3d9e94192bfb4ff5a785acff075a6171 -#: ../src/Doc/extending/newtypes.rst:126 +#: extending/newtypes.rst:126 msgid "" "The :attr:`ob_size` field of the header is not used; its presence in the " "type structure is a historical artifact that is maintained for binary " @@ -2005,13 +2004,13 @@ msgid "" "Always set this field to zero. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:133 +#: extending/newtypes.rst:133 msgid "" "The name of our type. This will appear in the default textual " "representation of our objects and in some error messages, for example::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:141 +#: extending/newtypes.rst:141 msgid "" "Note that the name is a dotted name that includes both the module name and " "the name of the type within the module. The module in this case is :mod:" @@ -2020,14 +2019,14 @@ msgid "" msgstr "" # 755fa43fe0014955ba719e5185f6b204 -#: ../src/Doc/extending/newtypes.rst:147 +#: extending/newtypes.rst:147 msgid "" "This is so that Python knows how much memory to allocate when you call :c:" "func:`PyObject_New`." msgstr "" # 51cdb00bc1ec467d9428648727ace549 -#: ../src/Doc/extending/newtypes.rst:152 +#: extending/newtypes.rst:152 msgid "" "If you want your type to be subclassable from Python, and your type has the " "same :c:member:`~PyTypeObject.tp_basicsize` as its base type, you may have " @@ -2041,31 +2040,31 @@ msgid "" "your base type, and therefore increasing its size." msgstr "" -#: ../src/Doc/extending/newtypes.rst:166 +#: extending/newtypes.rst:166 msgid "" "This has to do with variable length objects like lists and strings. Ignore " "this for now." msgstr "" -#: ../src/Doc/extending/newtypes.rst:169 +#: extending/newtypes.rst:169 msgid "" "Skipping a number of type methods that we don't provide, we set the class " "flags to :const:`Py_TPFLAGS_DEFAULT`. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:174 +#: extending/newtypes.rst:174 msgid "" "All types should include this constant in their flags. It enables all of " "the members defined by the current version of Python." msgstr "" # f04f8e09debb47cfa09b7163a3d18eb6 -#: ../src/Doc/extending/newtypes.rst:177 +#: extending/newtypes.rst:177 msgid "" "We provide a doc string for the type in :c:member:`~PyTypeObject.tp_doc`. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:181 +#: extending/newtypes.rst:181 msgid "" "Now we get into the type methods, the things that make your objects " "different from the others. We aren't going to implement any of these in " @@ -2074,7 +2073,7 @@ msgid "" msgstr "" # 51eff6a2868841d5b1d60c1a1cfd6b22 -#: ../src/Doc/extending/newtypes.rst:185 +#: extending/newtypes.rst:185 msgid "" "For now, all we want to be able to do is to create new :class:`Noddy` " "objects. To enable object creation, we have to provide a :c:member:" @@ -2088,113 +2087,113 @@ msgid "" "just before calling :c:func:`PyType_Ready`::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:199 +#: extending/newtypes.rst:199 msgid "" "All the other type methods are *NULL*, so we'll go over them later --- " "that's for a later section!" msgstr "" # ece689d46045496291f14470c80d5575 -#: ../src/Doc/extending/newtypes.rst:202 +#: extending/newtypes.rst:202 msgid "" "Everything else in the file should be familiar, except for some code in :c:" "func:`initnoddy`::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:208 +#: extending/newtypes.rst:208 msgid "" "This initializes the :class:`Noddy` type, filing in a number of members, " "including :attr:`ob_type` that we initially set to *NULL*. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:213 +#: extending/newtypes.rst:213 msgid "" "This adds the type to the module dictionary. This allows us to create :" "class:`Noddy` instances by calling the :class:`Noddy` class::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:219 +#: extending/newtypes.rst:219 msgid "" "That's it! All that remains is to build it; put the above code in a file " "called :file:`noddy.c` and ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:226 +#: extending/newtypes.rst:226 msgid "in a file called :file:`setup.py`; then typing ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:230 +#: extending/newtypes.rst:230 msgid "" "at a shell should produce a file :file:`noddy.so` in a subdirectory; move to " "that directory and fire up Python --- you should be able to ``import noddy`` " "and play around with Noddy objects." msgstr "" -#: ../src/Doc/extending/newtypes.rst:234 +#: extending/newtypes.rst:234 msgid "That wasn't so hard, was it?" msgstr "" -#: ../src/Doc/extending/newtypes.rst:236 +#: extending/newtypes.rst:236 msgid "" "Of course, the current Noddy type is pretty uninteresting. It has no data " "and doesn't do anything. It can't even be subclassed." msgstr "" -#: ../src/Doc/extending/newtypes.rst:241 +#: extending/newtypes.rst:241 msgid "Adding data and methods to the Basic example" msgstr "" -#: ../src/Doc/extending/newtypes.rst:243 +#: extending/newtypes.rst:243 msgid "" "Let's expend the basic example to add some data and methods. Let's also " "make the type usable as a base class. We'll create a new module, :mod:" "`noddy2` that adds these capabilities:" msgstr "" -#: ../src/Doc/extending/newtypes.rst:250 +#: extending/newtypes.rst:250 msgid "This version of the module has a number of changes." msgstr "" -#: ../src/Doc/extending/newtypes.rst:252 +#: extending/newtypes.rst:252 msgid "We've added an extra include::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:256 +#: extending/newtypes.rst:256 msgid "" "This include provides declarations that we use to handle attributes, as " "described a bit later." msgstr "" -#: ../src/Doc/extending/newtypes.rst:259 +#: extending/newtypes.rst:259 msgid "" "The name of the :class:`Noddy` object structure has been shortened to :class:" "`Noddy`. The type object name has been shortened to :class:`NoddyType`." msgstr "" -#: ../src/Doc/extending/newtypes.rst:262 +#: extending/newtypes.rst:262 msgid "" "The :class:`Noddy` type now has three data attributes, *first*, *last*, and " "*number*. The *first* and *last* variables are Python strings containing " "first and last names. The *number* attribute is an integer." msgstr "" -#: ../src/Doc/extending/newtypes.rst:266 +#: extending/newtypes.rst:266 msgid "The object structure is updated accordingly::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:275 +#: extending/newtypes.rst:275 msgid "" "Because we now have data to manage, we have to be more careful about object " "allocation and deallocation. At a minimum, we need a deallocation method::" msgstr "" # 03216a8358fe49e697d7116b08af9311 -#: ../src/Doc/extending/newtypes.rst:286 +#: extending/newtypes.rst:286 msgid "which is assigned to the :c:member:`~PyTypeObject.tp_dealloc` member::" msgstr "" # c717347c6d5a4f878db16b46ac0fe9c9 -#: ../src/Doc/extending/newtypes.rst:290 +#: extending/newtypes.rst:290 msgid "" "This method decrements the reference counts of the two Python attributes. We " "use :c:func:`Py_XDECREF` here because the :attr:`first` and :attr:`last` " @@ -2204,19 +2203,19 @@ msgid "" "an instance of a subclass." msgstr "" -#: ../src/Doc/extending/newtypes.rst:296 +#: extending/newtypes.rst:296 msgid "" "We want to make sure that the first and last names are initialized to empty " "strings, so we provide a new method::" msgstr "" # 503b7d7a4eff4ea1a9d995e98f7ca1cd -#: ../src/Doc/extending/newtypes.rst:326 +#: extending/newtypes.rst:326 msgid "and install it in the :c:member:`~PyTypeObject.tp_new` member::" msgstr "" # 4325f9f0f3a442f9ae74020777eb1fee -#: ../src/Doc/extending/newtypes.rst:330 +#: extending/newtypes.rst:330 msgid "" "The new member is responsible for creating (as opposed to initializing) " "objects of the type. It is exposed in Python as the :meth:`__new__` " @@ -2232,7 +2231,7 @@ msgid "" msgstr "" # aaa2ffa1897744b2a452246976de2068 -#: ../src/Doc/extending/newtypes.rst:341 +#: extending/newtypes.rst:341 msgid "" "The new method is a static method that is passed the type being instantiated " "and any arguments passed when the type was called, and that returns the new " @@ -2247,7 +2246,7 @@ msgid "" msgstr "" # d110533231e94e2f93dbf2d8734c8637 -#: ../src/Doc/extending/newtypes.rst:353 +#: extending/newtypes.rst:353 msgid "" "If you are creating a co-operative :c:member:`~PyTypeObject.tp_new` (one " "that calls a base type's :c:member:`~PyTypeObject.tp_new` or :meth:" @@ -2260,17 +2259,17 @@ msgid "" "subclasses without getting a :exc:`TypeError`.)" msgstr "" -#: ../src/Doc/extending/newtypes.rst:362 +#: extending/newtypes.rst:362 msgid "We provide an initialization function::" msgstr "" # 3889bcb9682640ae9f2ec566a2328abb -#: ../src/Doc/extending/newtypes.rst:393 +#: extending/newtypes.rst:393 msgid "by filling the :c:member:`~PyTypeObject.tp_init` slot. ::" msgstr "" # c76ca13abcf74a62a5f31904a2a29872 -#: ../src/Doc/extending/newtypes.rst:397 +#: extending/newtypes.rst:397 msgid "" "The :c:member:`~PyTypeObject.tp_init` slot is exposed in Python as the :meth:" "`__init__` method. It is used to initialize an object after it's created. " @@ -2280,7 +2279,7 @@ msgid "" "our instance. Initializers always accept positional and keyword arguments." msgstr "" -#: ../src/Doc/extending/newtypes.rst:404 +#: extending/newtypes.rst:404 msgid "" "Initializers can be called multiple times. Anyone can call the :meth:" "`__init__` method on our objects. For this reason, we have to be extra " @@ -2288,7 +2287,7 @@ msgid "" "assign the :attr:`first` member like this::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:415 +#: extending/newtypes.rst:415 msgid "" "But this would be risky. Our type doesn't restrict the type of the :attr:" "`first` member, so it could be any kind of object. It could have a " @@ -2298,43 +2297,43 @@ msgid "" "reference counts. When don't we have to do this?" msgstr "" -#: ../src/Doc/extending/newtypes.rst:422 +#: extending/newtypes.rst:422 msgid "when we absolutely know that the reference count is greater than 1" msgstr "" -#: ../src/Doc/extending/newtypes.rst:424 +#: extending/newtypes.rst:424 msgid "" "when we know that deallocation of the object [#]_ will not cause any calls " "back into our type's code" msgstr "" # 77b7bff5ae424264aa5f609ada2dce41 -#: ../src/Doc/extending/newtypes.rst:427 +#: extending/newtypes.rst:427 msgid "" "when decrementing a reference count in a :c:member:`~PyTypeObject." "tp_dealloc` handler when garbage-collections is not supported [#]_" msgstr "" -#: ../src/Doc/extending/newtypes.rst:430 +#: extending/newtypes.rst:430 msgid "" "We want to expose our instance variables as attributes. There are a number " "of ways to do that. The simplest way is to define member definitions::" msgstr "" # 3767f42a1d7f474bb0db81ef5d644194 -#: ../src/Doc/extending/newtypes.rst:443 +#: extending/newtypes.rst:443 msgid "" "and put the definitions in the :c:member:`~PyTypeObject.tp_members` slot::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:447 +#: extending/newtypes.rst:447 msgid "" "Each member definition has a member name, type, offset, access flags and " "documentation string. See the :ref:`Generic-Attribute-Management` section " "below for details." msgstr "" -#: ../src/Doc/extending/newtypes.rst:451 +#: extending/newtypes.rst:451 msgid "" "A disadvantage of this approach is that it doesn't provide a way to restrict " "the types of objects that can be assigned to the Python attributes. We " @@ -2345,13 +2344,13 @@ msgid "" "deleted." msgstr "" -#: ../src/Doc/extending/newtypes.rst:458 +#: extending/newtypes.rst:458 msgid "" "We define a single method, :meth:`name`, that outputs the objects name as " "the concatenation of the first and last names. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:493 +#: extending/newtypes.rst:493 msgid "" "The method is implemented as a C function that takes a :class:`Noddy` (or :" "class:`Noddy` subclass) instance as the first argument. Methods always take " @@ -2361,7 +2360,7 @@ msgid "" "method is equivalent to the Python method::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:503 +#: extending/newtypes.rst:503 msgid "" "Note that we have to check for the possibility that our :attr:`first` and :" "attr:`last` members are *NULL*. This is because they can be deleted, in " @@ -2370,24 +2369,24 @@ msgid "" "We'll see how to do that in the next section." msgstr "" -#: ../src/Doc/extending/newtypes.rst:509 +#: extending/newtypes.rst:509 msgid "" "Now that we've defined the method, we need to create an array of method " "definitions::" msgstr "" # 0aea2c1eec7047a084aa5ca1362a70b4 -#: ../src/Doc/extending/newtypes.rst:519 +#: extending/newtypes.rst:519 msgid "and assign them to the :c:member:`~PyTypeObject.tp_methods` slot::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:523 +#: extending/newtypes.rst:523 msgid "" "Note that we used the :const:`METH_NOARGS` flag to indicate that the method " "is passed no arguments." msgstr "" -#: ../src/Doc/extending/newtypes.rst:526 +#: extending/newtypes.rst:526 msgid "" "Finally, we'll make our type usable as a base class. We've written our " "methods carefully so far so that they don't make any assumptions about the " @@ -2396,21 +2395,21 @@ msgid "" msgstr "" # 2e4b2a74f31e436a98a64533e1b16736 -#: ../src/Doc/extending/newtypes.rst:533 +#: extending/newtypes.rst:533 msgid "" "We rename :c:func:`initnoddy` to :c:func:`initnoddy2` and update the module " "name passed to :c:func:`Py_InitModule3`." msgstr "" -#: ../src/Doc/extending/newtypes.rst:536 +#: extending/newtypes.rst:536 msgid "Finally, we update our :file:`setup.py` file to build the new module::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:547 +#: extending/newtypes.rst:547 msgid "Providing finer control over data attributes" msgstr "" -#: ../src/Doc/extending/newtypes.rst:549 +#: extending/newtypes.rst:549 msgid "" "In this section, we'll provide finer control over how the :attr:`first` and :" "attr:`last` attributes are set in the :class:`Noddy` example. In the " @@ -2419,14 +2418,14 @@ msgid "" "make sure that these attributes always contain strings." msgstr "" -#: ../src/Doc/extending/newtypes.rst:558 +#: extending/newtypes.rst:558 msgid "" "To provide greater control, over the :attr:`first` and :attr:`last` " "attributes, we'll use custom getter and setter functions. Here are the " "functions for getting and setting the :attr:`first` attribute::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:589 +#: extending/newtypes.rst:589 msgid "" "The getter function is passed a :class:`Noddy` object and a \"closure\", " "which is void pointer. In this case, the closure is ignored. (The closure " @@ -2436,7 +2435,7 @@ msgid "" "in the closure.)" msgstr "" -#: ../src/Doc/extending/newtypes.rst:595 +#: extending/newtypes.rst:595 msgid "" "The setter function is passed the :class:`Noddy` object, the new value, and " "the closure. The new value may be *NULL*, in which case the attribute is " @@ -2445,39 +2444,39 @@ msgid "" msgstr "" # dcc82a5e26d04bddb8a747acec5eac47 -#: ../src/Doc/extending/newtypes.rst:600 +#: extending/newtypes.rst:600 msgid "We create an array of :c:type:`PyGetSetDef` structures::" msgstr "" # d112b5a89a9540b4b53c540eff6f7a27 -#: ../src/Doc/extending/newtypes.rst:614 +#: extending/newtypes.rst:614 msgid "and register it in the :c:member:`~PyTypeObject.tp_getset` slot::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:618 +#: extending/newtypes.rst:618 msgid "to register our attribute getters and setters." msgstr "" # 2774eb67e20b4ef98edca407b0c19485 -#: ../src/Doc/extending/newtypes.rst:620 +#: extending/newtypes.rst:620 msgid "" "The last item in a :c:type:`PyGetSetDef` structure is the closure mentioned " "above. In this case, we aren't using the closure, so we just pass *NULL*." msgstr "" -#: ../src/Doc/extending/newtypes.rst:623 +#: extending/newtypes.rst:623 msgid "We also remove the member definitions for these attributes::" msgstr "" # 06520158d3914518b93af7a26f52503f -#: ../src/Doc/extending/newtypes.rst:631 +#: extending/newtypes.rst:631 msgid "" "We also need to update the :c:member:`~PyTypeObject.tp_init` handler to only " "allow strings [#]_ to be passed::" msgstr "" # 4b02044d9a3448b4aa31b62c14379188 -#: ../src/Doc/extending/newtypes.rst:663 +#: extending/newtypes.rst:663 msgid "" "With these changes, we can assure that the :attr:`first` and :attr:`last` " "members are never *NULL* so we can remove checks for *NULL* values in almost " @@ -2487,25 +2486,25 @@ msgid "" "initialization of these members failed in the constructor." msgstr "" -#: ../src/Doc/extending/newtypes.rst:670 +#: extending/newtypes.rst:670 msgid "" "We also rename the module initialization function and module name in the " "initialization function, as we did before, and we add an extra definition to " "the :file:`setup.py` file." msgstr "" -#: ../src/Doc/extending/newtypes.rst:676 +#: extending/newtypes.rst:676 msgid "Supporting cyclic garbage collection" msgstr "" -#: ../src/Doc/extending/newtypes.rst:678 +#: extending/newtypes.rst:678 msgid "" "Python has a cyclic-garbage collector that can identify unneeded objects " "even when their reference counts are not zero. This can happen when objects " "are involved in cycles. For example, consider::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:686 +#: extending/newtypes.rst:686 msgid "" "In this example, we create a list that contains itself. When we delete it, " "it still has a reference from itself. Its reference count doesn't drop to " @@ -2513,14 +2512,14 @@ msgid "" "out that the list is garbage and free it." msgstr "" -#: ../src/Doc/extending/newtypes.rst:691 +#: extending/newtypes.rst:691 msgid "" "In the second version of the :class:`Noddy` example, we allowed any kind of " "object to be stored in the :attr:`first` or :attr:`last` attributes. [#]_ " "This means that :class:`Noddy` objects can participate in cycles::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:700 +#: extending/newtypes.rst:700 msgid "" "This is pretty silly, but it gives us an excuse to add support for the " "cyclic-garbage collector to the :class:`Noddy` example. To support cyclic " @@ -2528,14 +2527,14 @@ msgid "" "enables these slots:" msgstr "" -#: ../src/Doc/extending/newtypes.rst:708 +#: extending/newtypes.rst:708 msgid "" "The traversal method provides access to subobjects that could participate in " "cycles::" msgstr "" # 7524d7496e0d4378828e18652374d941 -#: ../src/Doc/extending/newtypes.rst:730 +#: extending/newtypes.rst:730 msgid "" "For each subobject that can participate in cycles, we need to call the :c:" "func:`visit` function, which is passed to the traversal method. The :c:func:" @@ -2545,7 +2544,7 @@ msgid "" msgstr "" # ba146252a9a448e5bb4f87f798a44b8d -#: ../src/Doc/extending/newtypes.rst:736 +#: extending/newtypes.rst:736 msgid "" "Python 2.4 and higher provide a :c:func:`Py_VISIT` macro that automates " "calling visit functions. With :c:func:`Py_VISIT`, :c:func:`Noddy_traverse` " @@ -2553,14 +2552,14 @@ msgid "" msgstr "" # e365d2c715ce4b2db6335dbeeb9cb277 -#: ../src/Doc/extending/newtypes.rst:750 +#: extending/newtypes.rst:750 msgid "" "Note that the :c:member:`~PyTypeObject.tp_traverse` implementation must name " "its arguments exactly *visit* and *arg* in order to use :c:func:`Py_VISIT`. " "This is to encourage uniformity across these boring implementations." msgstr "" -#: ../src/Doc/extending/newtypes.rst:754 +#: extending/newtypes.rst:754 msgid "" "We also need to provide a method for clearing any subobjects that can " "participate in cycles. We implement the method and reimplement the " @@ -2568,7 +2567,7 @@ msgid "" msgstr "" # bc81362c001e4b1b829c5dd6ec89ab84 -#: ../src/Doc/extending/newtypes.rst:781 +#: extending/newtypes.rst:781 msgid "" "Notice the use of a temporary variable in :c:func:`Noddy_clear`. We use the " "temporary variable so that we can set each member to *NULL* before " @@ -2583,20 +2582,20 @@ msgid "" msgstr "" # 465bbd3cc10a41469c8e5a384e88f55a -#: ../src/Doc/extending/newtypes.rst:791 +#: extending/newtypes.rst:791 msgid "" "Python 2.4 and higher provide a :c:func:`Py_CLEAR` that automates the " "careful decrementing of reference counts. With :c:func:`Py_CLEAR`, the :c:" "func:`Noddy_clear` function can be simplified::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:803 +#: extending/newtypes.rst:803 msgid "" "Finally, we add the :const:`Py_TPFLAGS_HAVE_GC` flag to the class flags::" msgstr "" # aa2bece8959047a2b5a5fe53c918fd04 -#: ../src/Doc/extending/newtypes.rst:807 +#: extending/newtypes.rst:807 msgid "" "That's pretty much it. If we had written custom :c:member:`~PyTypeObject." "tp_alloc` or :c:member:`~PyTypeObject.tp_free` slots, we'd need to modify " @@ -2604,11 +2603,11 @@ msgid "" "automatically provided." msgstr "" -#: ../src/Doc/extending/newtypes.rst:813 +#: extending/newtypes.rst:813 msgid "Subclassing other types" msgstr "" -#: ../src/Doc/extending/newtypes.rst:815 +#: extending/newtypes.rst:815 msgid "" "It is possible to create new extension types that are derived from existing " "types. It is easiest to inherit from the built in types, since an extension " @@ -2616,7 +2615,7 @@ msgid "" "share these :class:`PyTypeObject` structures between extension modules." msgstr "" -#: ../src/Doc/extending/newtypes.rst:820 +#: extending/newtypes.rst:820 msgid "" "In this example we will create a :class:`Shoddy` type that inherits from the " "built-in :class:`list` type. The new type will be completely compatible with " @@ -2624,7 +2623,7 @@ msgid "" "increases an internal counter. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:838 +#: extending/newtypes.rst:838 msgid "" "As you can see, the source code closely resembles the :class:`Noddy` " "examples in previous sections. We will break down the main differences " @@ -2632,27 +2631,27 @@ msgid "" msgstr "" # f013c10ee075443ba5033fd7384c2707 -#: ../src/Doc/extending/newtypes.rst:846 +#: extending/newtypes.rst:846 msgid "" "The primary difference for derived type objects is that the base type's " "object structure must be the first value. The base type will already include " "the :c:func:`PyObject_HEAD` at the beginning of its structure." msgstr "" -#: ../src/Doc/extending/newtypes.rst:850 +#: extending/newtypes.rst:850 msgid "" "When a Python object is a :class:`Shoddy` instance, its *PyObject\\** " "pointer can be safely cast to both *PyListObject\\** and *Shoddy\\**. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:862 +#: extending/newtypes.rst:862 msgid "" "In the :attr:`__init__` method for our type, we can see how to call through " "to the :attr:`__init__` method of the base type." msgstr "" # 0804c06bc2574d22ab1a88e9f7030bb8 -#: ../src/Doc/extending/newtypes.rst:865 +#: extending/newtypes.rst:865 msgid "" "This pattern is important when writing a type with custom :attr:`new` and :" "attr:`dealloc` methods. The :attr:`new` method should not actually create " @@ -2662,7 +2661,7 @@ msgid "" msgstr "" # a6668a8e67b441fca842c5e8c4963754 -#: ../src/Doc/extending/newtypes.rst:870 +#: extending/newtypes.rst:870 msgid "" "When filling out the :c:func:`PyTypeObject` for the :class:`Shoddy` type, " "you see a slot for :c:func:`tp_base`. Due to cross platform compiler issues, " @@ -2671,7 +2670,7 @@ msgid "" msgstr "" # 6afdd2f0324a41b9b8f318da7195c6e2 -#: ../src/Doc/extending/newtypes.rst:892 +#: extending/newtypes.rst:892 msgid "" "Before calling :c:func:`PyType_Ready`, the type structure must have the :c:" "member:`~PyTypeObject.tp_base` slot filled in. When we are deriving a new " @@ -2681,37 +2680,37 @@ msgid "" msgstr "" # f13f0bbe190c45b8b4bb00a9422780a9 -#: ../src/Doc/extending/newtypes.rst:897 +#: extending/newtypes.rst:897 msgid "" "After that, calling :c:func:`PyType_Ready` and adding the type object to the " "module is the same as with the basic :class:`Noddy` examples." msgstr "" -#: ../src/Doc/extending/newtypes.rst:904 +#: extending/newtypes.rst:904 msgid "Type Methods" msgstr "" -#: ../src/Doc/extending/newtypes.rst:906 +#: extending/newtypes.rst:906 msgid "" "This section aims to give a quick fly-by on the various type methods you can " "implement and what they do." msgstr "" # c386aab2c51a410785156697b9298f25 -#: ../src/Doc/extending/newtypes.rst:909 +#: extending/newtypes.rst:909 msgid "" "Here is the definition of :c:type:`PyTypeObject`, with some fields only used " "in debug builds omitted:" msgstr "" -#: ../src/Doc/extending/newtypes.rst:915 +#: extending/newtypes.rst:915 msgid "" "Now that's a *lot* of methods. Don't worry too much though - if you have a " "type you want to define, the chances are very good that you will only " "implement a handful of these." msgstr "" -#: ../src/Doc/extending/newtypes.rst:919 +#: extending/newtypes.rst:919 msgid "" "As you probably expect by now, we're going to go over this and give more " "information about the various handlers. We won't go in the order they are " @@ -2722,7 +2721,7 @@ msgid "" "then change the values to suit your new type. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:929 +#: extending/newtypes.rst:929 msgid "" "The name of the type - as mentioned in the last section, this will appear in " "various places, almost entirely for diagnostic purposes. Try to choose " @@ -2730,7 +2729,7 @@ msgid "" msgstr "" # e62ab9b24b1842ccaf1fe414c0a141ce -#: ../src/Doc/extending/newtypes.rst:935 +#: extending/newtypes.rst:935 msgid "" "These fields tell the runtime how much memory to allocate when new objects " "of this type are created. Python has some built-in support for variable " @@ -2739,23 +2738,23 @@ msgid "" "later. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:942 +#: extending/newtypes.rst:942 msgid "" "Here you can put a string (or its address) that you want returned when the " "Python script references ``obj.__doc__`` to retrieve the doc string." msgstr "" -#: ../src/Doc/extending/newtypes.rst:945 +#: extending/newtypes.rst:945 msgid "" "Now we come to the basic type methods---the ones most extension types will " "implement." msgstr "" -#: ../src/Doc/extending/newtypes.rst:950 +#: extending/newtypes.rst:950 msgid "Finalization and De-allocation" msgstr "" -#: ../src/Doc/extending/newtypes.rst:962 +#: extending/newtypes.rst:962 msgid "" "This function is called when the reference count of the instance of your " "type is reduced to zero and the Python interpreter wants to reclaim it. If " @@ -2765,7 +2764,7 @@ msgid "" msgstr "" # 8dfa9cb2ef1e49f2a34948c39479ccc7 -#: ../src/Doc/extending/newtypes.rst:978 +#: extending/newtypes.rst:978 msgid "" "One important requirement of the deallocator function is that it leaves any " "pending exceptions alone. This is important since deallocators are " @@ -2780,12 +2779,12 @@ msgid "" "c:func:`PyErr_Fetch` and :c:func:`PyErr_Restore` functions::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1019 +#: extending/newtypes.rst:1019 msgid "Object Presentation" msgstr "" # 91c3874334a5418c938f41bdffb4341b -#: ../src/Doc/extending/newtypes.rst:1025 +#: extending/newtypes.rst:1025 msgid "" "In Python, there are three ways to generate a textual representation of an " "object: the :func:`repr` function (or equivalent back-tick syntax), the :" @@ -2798,7 +2797,7 @@ msgid "" msgstr "" # 6102caf6a8d64fab84da74261a357f7f -#: ../src/Doc/extending/newtypes.rst:1034 +#: extending/newtypes.rst:1034 msgid "" "These handlers are all optional, and most types at most need to implement " "the :c:member:`~PyTypeObject.tp_str` and :c:member:`~PyTypeObject.tp_repr` " @@ -2806,7 +2805,7 @@ msgid "" msgstr "" # 83ab448fab8b4b95a48be1a1a06a19f5 -#: ../src/Doc/extending/newtypes.rst:1041 +#: extending/newtypes.rst:1041 msgid "" "The :c:member:`~PyTypeObject.tp_repr` handler should return a string object " "containing a representation of the instance for which it is called. Here is " @@ -2814,7 +2813,7 @@ msgid "" msgstr "" # ebd3cddb83054a9aacaefb397938a573 -#: ../src/Doc/extending/newtypes.rst:1052 +#: extending/newtypes.rst:1052 msgid "" "If no :c:member:`~PyTypeObject.tp_repr` handler is specified, the " "interpreter will supply a representation that uses the type's :c:member:" @@ -2822,7 +2821,7 @@ msgid "" msgstr "" # ab6d504720194dad913b542e65799778 -#: ../src/Doc/extending/newtypes.rst:1056 +#: extending/newtypes.rst:1056 msgid "" "The :c:member:`~PyTypeObject.tp_str` handler is to :func:`str` what the :c:" "member:`~PyTypeObject.tp_repr` handler described above is to :func:`repr`; " @@ -2833,12 +2832,12 @@ msgid "" "the :c:member:`~PyTypeObject.tp_repr` handler is used instead." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1063 +#: extending/newtypes.rst:1063 msgid "Here is a simple example::" msgstr "" # 91ebb828f0b64802a9b0d2b826911004 -#: ../src/Doc/extending/newtypes.rst:1072 +#: extending/newtypes.rst:1072 msgid "" "The print function will be called whenever Python needs to \"print\" an " "instance of the type. For example, if 'node' is an instance of type " @@ -2846,7 +2845,7 @@ msgid "" msgstr "" # 802642aebd8b4646b09707453fee94b2 -#: ../src/Doc/extending/newtypes.rst:1078 +#: extending/newtypes.rst:1078 msgid "" "There is a flags argument and one flag, :const:`Py_PRINT_RAW`, and it " "suggests that you print without string quotes and possibly without " @@ -2854,22 +2853,22 @@ msgid "" msgstr "" # 2704aed8d0774f6c893dc16fb8e17018 -#: ../src/Doc/extending/newtypes.rst:1082 +#: extending/newtypes.rst:1082 msgid "" "The print function receives a file object as an argument. You will likely " "want to write to that file object." msgstr "" # b79b806741da448d993574786c051ebe -#: ../src/Doc/extending/newtypes.rst:1085 +#: extending/newtypes.rst:1085 msgid "Here is a sample print function::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1103 +#: extending/newtypes.rst:1103 msgid "Attribute Management" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1105 +#: extending/newtypes.rst:1105 msgid "" "For every object which can support attributes, the corresponding type must " "provide the functions that control how the attributes are resolved. There " @@ -2880,7 +2879,7 @@ msgid "" msgstr "" # d9b3eb4088d949388554c62d4f22dfc9 -#: ../src/Doc/extending/newtypes.rst:1111 +#: extending/newtypes.rst:1111 msgid "" "Python supports two pairs of attribute handlers; a type that supports " "attributes only needs to implement the functions for one pair. The " @@ -2890,7 +2889,7 @@ msgid "" msgstr "" # e9e88cdb49034409b680a672c75bb819 -#: ../src/Doc/extending/newtypes.rst:1123 +#: extending/newtypes.rst:1123 msgid "" "If accessing attributes of an object is always a simple operation (this will " "be explained shortly), there are generic implementations which can be used " @@ -2901,37 +2900,37 @@ msgid "" "mechanism that is available." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1134 +#: extending/newtypes.rst:1134 msgid "Generic Attribute Management" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1138 +#: extending/newtypes.rst:1138 msgid "" "Most extension types only use *simple* attributes. So, what makes the " "attributes simple? There are only a couple of conditions that must be met:" msgstr "" # 51e507a3d6064c94a817606030211daf -#: ../src/Doc/extending/newtypes.rst:1141 +#: extending/newtypes.rst:1141 msgid "" "The name of the attributes must be known when :c:func:`PyType_Ready` is " "called." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1144 +#: extending/newtypes.rst:1144 msgid "" "No special processing is needed to record that an attribute was looked up or " "set, nor do actions need to be taken based on the value." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1147 +#: extending/newtypes.rst:1147 msgid "" "Note that this list does not place any restrictions on the values of the " "attributes, when the values are computed, or how relevant data is stored." msgstr "" # b647b106d7304de0809fa51cf9c25cba -#: ../src/Doc/extending/newtypes.rst:1150 +#: extending/newtypes.rst:1150 msgid "" "When :c:func:`PyType_Ready` is called, it uses three tables referenced by " "the type object to create :term:`descriptor`\\s which are placed in the " @@ -2943,19 +2942,19 @@ msgid "" "*NULL* as well, allowing the base type to handle attributes." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1158 +#: extending/newtypes.rst:1158 msgid "The tables are declared as three fields of the type object::" msgstr "" # 6e6313857f8d458e89bbe00d5d05e73d -#: ../src/Doc/extending/newtypes.rst:1164 +#: extending/newtypes.rst:1164 msgid "" "If :c:member:`~PyTypeObject.tp_methods` is not *NULL*, it must refer to an " "array of :c:type:`PyMethodDef` structures. Each entry in the table is an " "instance of this structure::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1175 +#: extending/newtypes.rst:1175 msgid "" "One entry should be defined for each method provided by the type; no entries " "are needed for methods inherited from a base type. One additional entry is " @@ -2963,13 +2962,13 @@ msgid "" "attr:`ml_name` field of the sentinel must be *NULL*." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1180 +#: extending/newtypes.rst:1180 msgid "" "XXX Need to refer to some unified discussion of the structure fields, shared " "with the next section." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1183 +#: extending/newtypes.rst:1183 msgid "" "The second table is used to define attributes which map directly to data " "stored in the instance. A variety of primitive C types are supported, and " @@ -2977,7 +2976,7 @@ msgid "" "defined as::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1195 +#: extending/newtypes.rst:1195 msgid "" "For each entry in the table, a :term:`descriptor` will be constructed and " "added to the type which will be able to extract a value from the instance " @@ -2988,68 +2987,68 @@ msgid "" "accessed." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1202 +#: extending/newtypes.rst:1202 msgid "XXX Need to move some of this to a shared section!" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1204 +#: extending/newtypes.rst:1204 msgid "" "The following flag constants are defined in :file:`structmember.h`; they may " "be combined using bitwise-OR." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1208 +#: extending/newtypes.rst:1208 msgid "Constant" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1208 +#: extending/newtypes.rst:1208 msgid "Meaning" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1210 +#: extending/newtypes.rst:1210 msgid ":const:`READONLY`" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1210 +#: extending/newtypes.rst:1210 msgid "Never writable." msgstr "" # d872706e4c3341338a81ab2f43fe0219 -#: ../src/Doc/extending/newtypes.rst:1212 +#: extending/newtypes.rst:1212 msgid ":const:`RO`" msgstr "" # fdf1fe5ac3484ce78a74d02009f940d2 -#: ../src/Doc/extending/newtypes.rst:1212 +#: extending/newtypes.rst:1212 msgid "Shorthand for :const:`READONLY`." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1214 +#: extending/newtypes.rst:1214 msgid ":const:`READ_RESTRICTED`" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1214 +#: extending/newtypes.rst:1214 msgid "Not readable in restricted mode." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1216 +#: extending/newtypes.rst:1216 msgid ":const:`WRITE_RESTRICTED`" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1216 +#: extending/newtypes.rst:1216 msgid "Not writable in restricted mode." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1218 +#: extending/newtypes.rst:1218 msgid ":const:`RESTRICTED`" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1218 +#: extending/newtypes.rst:1218 msgid "Not readable or writable in restricted mode." msgstr "" # d1837cfceff64897b40066bedbddc0c0 -#: ../src/Doc/extending/newtypes.rst:1228 +#: extending/newtypes.rst:1228 msgid "" "An interesting advantage of using the :c:member:`~PyTypeObject.tp_members` " "table to build descriptors that are used at runtime is that any attribute " @@ -3060,18 +3059,18 @@ msgid "" msgstr "" # 4d3a82949f2f4d1bb05793dcb884c845 -#: ../src/Doc/extending/newtypes.rst:1234 +#: extending/newtypes.rst:1234 msgid "" "As with the :c:member:`~PyTypeObject.tp_methods` table, a sentinel entry " "with a :attr:`name` value of *NULL* is required." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1248 +#: extending/newtypes.rst:1248 msgid "Type-specific Attribute Management" msgstr "" # 31b07fd5698c47598736f80b081fd046 -#: ../src/Doc/extending/newtypes.rst:1250 +#: extending/newtypes.rst:1250 msgid "" "For simplicity, only the :c:type:`char\\*` version will be demonstrated " "here; the type of the name parameter is the only difference between the :c:" @@ -3085,7 +3084,7 @@ msgid "" msgstr "" # 4de0792d96fb41eb91b1828724f14afc -#: ../src/Doc/extending/newtypes.rst:1260 +#: extending/newtypes.rst:1260 msgid "" "The :c:member:`~PyTypeObject.tp_getattr` handler is called when the object " "requires an attribute look-up. It is called in the same situations where " @@ -3093,7 +3092,7 @@ msgid "" msgstr "" # 7d1af30d5c754ead97707eb29b0ab6ea -#: ../src/Doc/extending/newtypes.rst:1264 +#: extending/newtypes.rst:1264 msgid "" "A likely way to handle this is (1) to implement a set of functions (such as :" "c:func:`newdatatype_getSize` and :c:func:`newdatatype_setSize` in the " @@ -3103,12 +3102,12 @@ msgid "" "`~PyTypeObject.tp_methods` field of the type object." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1271 +#: extending/newtypes.rst:1271 msgid "Here is an example::" msgstr "" # 52647ff15b1b461ba1913ffdff7247c2 -#: ../src/Doc/extending/newtypes.rst:1287 +#: extending/newtypes.rst:1287 msgid "" "The :c:member:`~PyTypeObject.tp_setattr` handler is called when the :meth:" "`__setattr__` or :meth:`__delattr__` method of a class instance would be " @@ -3118,12 +3117,12 @@ msgid "" "should be set to *NULL*. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1302 +#: extending/newtypes.rst:1302 msgid "Object Comparison" msgstr "" # 04aa8b80a00c4d76aa1debf2fadb0cbb -#: ../src/Doc/extending/newtypes.rst:1308 +#: extending/newtypes.rst:1308 msgid "" "The :c:member:`~PyTypeObject.tp_compare` handler is called when comparisons " "are needed and the object does not implement the specific rich comparison " @@ -3139,7 +3138,7 @@ msgid "" msgstr "" # b47d209cd7be4596a770dbdf41902f4d -#: ../src/Doc/extending/newtypes.rst:1319 +#: extending/newtypes.rst:1319 msgid "" "A :c:member:`~PyTypeObject.tp_compare` handler may raise an exception. In " "this case it should return a negative value. The caller has to test for the " @@ -3147,21 +3146,21 @@ msgid "" msgstr "" # 892c7be86eb34136ab190237e5275426 -#: ../src/Doc/extending/newtypes.rst:1323 +#: extending/newtypes.rst:1323 msgid "Here is a sample implementation::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1346 +#: extending/newtypes.rst:1346 msgid "Abstract Protocol Support" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1348 +#: extending/newtypes.rst:1348 msgid "" "Python supports a variety of *abstract* 'protocols;' the specific interfaces " "provided to use these interfaces are documented in :ref:`abstract`." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1352 +#: extending/newtypes.rst:1352 msgid "" "A number of these abstract interfaces were defined early in the development " "of the Python implementation. In particular, the number, mapping, and " @@ -3177,7 +3176,7 @@ msgid "" msgstr "" # 2898f877349f4ab3811cce78a9661e8c -#: ../src/Doc/extending/newtypes.rst:1367 +#: extending/newtypes.rst:1367 msgid "" "If you wish your object to be able to act like a number, a sequence, or a " "mapping object, then you place the address of a structure that implements " @@ -3188,14 +3187,14 @@ msgid "" "distribution. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1376 +#: extending/newtypes.rst:1376 msgid "" "This function, if you choose to provide it, should return a hash number for " "an instance of your data type. Here is a moderately pointless example::" msgstr "" # e78216a1d7054cedb503d99e1c454d2b -#: ../src/Doc/extending/newtypes.rst:1392 +#: extending/newtypes.rst:1392 msgid "" "This function is called when an instance of your data type is \"called\", " "for example, if ``obj1`` is an instance of your data type and the Python " @@ -3203,25 +3202,25 @@ msgid "" "handler is invoked." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1396 +#: extending/newtypes.rst:1396 msgid "This function takes three arguments:" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1398 +#: extending/newtypes.rst:1398 msgid "" "*arg1* is the instance of the data type which is the subject of the call. If " "the call is ``obj1('hello')``, then *arg1* is ``obj1``." msgstr "" # 4d682322301d470faa0588ab1aa4ee6d -#: ../src/Doc/extending/newtypes.rst:1401 +#: extending/newtypes.rst:1401 msgid "" "*arg2* is a tuple containing the arguments to the call. You can use :c:func:" "`PyArg_ParseTuple` to extract the arguments." msgstr "" # e71b1a71a1f84e2e98737fca13909292 -#: ../src/Doc/extending/newtypes.rst:1404 +#: extending/newtypes.rst:1404 msgid "" "*arg3* is a dictionary of keyword arguments that were passed. If this is non-" "*NULL* and you support keyword arguments, use :c:func:" @@ -3230,16 +3229,16 @@ msgid "" "`TypeError` with a message saying that keyword arguments are not supported." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1410 +#: extending/newtypes.rst:1410 msgid "" "Here is a desultory example of the implementation of the call function. ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1436 +#: extending/newtypes.rst:1436 msgid "XXX some fields need to be added here... ::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1443 +#: extending/newtypes.rst:1443 msgid "" "These functions provide support for the iterator protocol. Any object which " "wishes to support iteration over its contents (which may be generated during " @@ -3250,7 +3249,7 @@ msgid "" "the case of an error, they should set an exception and return *NULL*." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1451 +#: extending/newtypes.rst:1451 msgid "" "For an object which represents an iterable collection, the ``tp_iter`` " "handler must return an iterator object. The iterator object is responsible " @@ -3263,7 +3262,7 @@ msgid "" "objects are an example of such an iterator." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1461 +#: extending/newtypes.rst:1461 msgid "" "Iterator objects should implement both handlers. The ``tp_iter`` handler " "should return a new reference to the iterator (this is the same as the " @@ -3276,11 +3275,11 @@ msgid "" "return *NULL*." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1474 +#: extending/newtypes.rst:1474 msgid "Weak Reference Support" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1476 +#: extending/newtypes.rst:1476 msgid "" "One of the goals of Python's weak-reference implementation is to allow any " "type to participate in the weak reference mechanism without incurring the " @@ -3289,7 +3288,7 @@ msgid "" msgstr "" # 66d44bd7829849ed937246306b92fb31 -#: ../src/Doc/extending/newtypes.rst:1480 +#: extending/newtypes.rst:1480 msgid "" "For an object to be weakly referencable, the extension must include a :c:" "type:`PyObject\\*` field in the instance structure for the use of the weak " @@ -3300,29 +3299,29 @@ msgid "" "structure::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1494 +#: extending/newtypes.rst:1494 msgid "The statically-declared type object for instances is defined this way::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1511 +#: extending/newtypes.rst:1511 msgid "" "The type constructor is responsible for initializing the weak reference list " "to *NULL*::" msgstr "" # 410261a740174cb19fb7ce987c121ca0 -#: ../src/Doc/extending/newtypes.rst:1523 +#: extending/newtypes.rst:1523 msgid "" "The only further addition is that the destructor needs to call the weak " "reference manager to clear any weak references. This is only required if " "the weak reference list is non-*NULL*::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1542 +#: extending/newtypes.rst:1542 msgid "More Suggestions" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1544 +#: extending/newtypes.rst:1544 msgid "" "Remember that you can omit most of these functions, in which case you " "provide ``0`` as a value. There are type definitions for each of the " @@ -3331,7 +3330,7 @@ msgid "" msgstr "" # 982f8feaea1d47929091ea51121b61a4 -#: ../src/Doc/extending/newtypes.rst:1549 +#: extending/newtypes.rst:1549 msgid "" "In order to learn how to implement any specific method for your new data " "type, do the following: Download and unpack the Python source distribution. " @@ -3341,21 +3340,21 @@ msgid "" msgstr "" # 9576add852934d3f8e4605c3beba415c -#: ../src/Doc/extending/newtypes.rst:1555 +#: extending/newtypes.rst:1555 msgid "" "When you need to verify that an object is an instance of the type you are " "implementing, use the :c:func:`PyObject_TypeCheck` function. A sample of its " "use might be something like the following::" msgstr "" -#: ../src/Doc/extending/newtypes.rst:1566 +#: extending/newtypes.rst:1566 msgid "" "This is true when we know that the object is a basic type, like a string or " "a float." msgstr "" # a02772d1db124ab18ffff2e80a5ff04c -#: ../src/Doc/extending/newtypes.rst:1569 +#: extending/newtypes.rst:1569 msgid "" "We relied on this in the :c:member:`~PyTypeObject.tp_dealloc` handler in " "this example, because our type doesn't support garbage collection. Even if a " @@ -3364,7 +3363,7 @@ msgid "" "advanced and not covered here." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1574 +#: extending/newtypes.rst:1574 msgid "" "We now know that the first and last members are strings, so perhaps we could " "be less careful about decrementing their reference counts, however, we " @@ -3374,18 +3373,18 @@ msgid "" "objects." msgstr "" -#: ../src/Doc/extending/newtypes.rst:1580 +#: extending/newtypes.rst:1580 msgid "" "Even in the third version, we aren't guaranteed to avoid cycles. Instances " "of string subclasses are allowed and string subclasses could allow cycles " "even if normal strings don't." msgstr "" -#: ../src/Doc/extending/windows.rst:8 +#: extending/windows.rst:8 msgid "Building C and C++ Extensions on Windows" msgstr "" -#: ../src/Doc/extending/windows.rst:10 +#: extending/windows.rst:10 msgid "" "This chapter briefly explains how to create a Windows extension module for " "Python using Microsoft Visual C++, and follows with more detailed background " @@ -3395,7 +3394,7 @@ msgid "" "on both Unix and Windows." msgstr "" -#: ../src/Doc/extending/windows.rst:17 +#: extending/windows.rst:17 msgid "" "Module authors are encouraged to use the distutils approach for building " "extension modules, instead of the one described in this section. You will " @@ -3403,7 +3402,7 @@ msgid "" "Visual C++." msgstr "" -#: ../src/Doc/extending/windows.rst:24 +#: extending/windows.rst:24 msgid "" "This chapter mentions a number of filenames that include an encoded Python " "version number. These filenames are represented with the version number " @@ -3413,228 +3412,34 @@ msgid "" "actually be ``22``." msgstr "" -#: ../src/Doc/extending/windows.rst:34 +#: extending/windows.rst:34 msgid "A Cookbook Approach" msgstr "" -#: ../src/Doc/extending/windows.rst:36 +#: extending/windows.rst:36 msgid "" "There are two approaches to building extension modules on Windows, just as " "there are on Unix: use the :mod:`distutils` package to control the build " "process, or do things manually. The distutils approach works well for most " "extensions; documentation on using :mod:`distutils` to build and package " -"extension modules is available in :ref:`distutils-index`. This section " -"describes the manual approach to building Python extensions written in C or C" -"++." +"extension modules is available in :ref:`distutils-index`. If you find you " +"really need to do things manually, it may be instructive to study the " +"project file for the :source:`winsound ` standard " +"library module." msgstr "" -#: ../src/Doc/extending/windows.rst:43 -msgid "" -"To build extensions using these instructions, you need to have a copy of the " -"Python sources of the same version as your installed Python. You will need " -"Microsoft Visual C++ \"Developer Studio\"; project files are supplied for VC+" -"+ version 7.1, but you can use older versions of VC++. Notice that you " -"should use the same version of VC++that was used to build Python itself. The " -"example files described here are distributed with the Python sources in the :" -"file:`PC\\\\example_nt\\\\` directory." -msgstr "" - -#: ../src/Doc/extending/windows.rst:51 -msgid "" -"**Copy the example files** --- The :file:`example_nt` directory is a " -"subdirectory of the :file:`PC` directory, in order to keep all the PC-" -"specific files under the same directory in the source distribution. " -"However, the :file:`example_nt` directory can't actually be used from this " -"location. You first need to copy or move it up one level, so that :file:" -"`example_nt` is a sibling of the :file:`PC` and :file:`Include` " -"directories. Do all your work from within this new location." -msgstr "" - -#: ../src/Doc/extending/windows.rst:59 -msgid "" -"**Open the project** --- From VC++, use the :menuselection:`File --> Open " -"Solution` dialog (not :menuselection:`File --> Open`!). Navigate to and " -"select the file :file:`example.sln`, in the *copy* of the :file:`example_nt` " -"directory you made above. Click Open." -msgstr "" - -#: ../src/Doc/extending/windows.rst:64 -msgid "" -"**Build the example DLL** --- In order to check that everything is set up " -"right, try building:" -msgstr "" - -#: ../src/Doc/extending/windows.rst:67 -msgid "" -"Select a configuration. This step is optional. Choose :menuselection:" -"`Build --> Configuration Manager --> Active Solution Configuration` and " -"select either :guilabel:`Release` or :guilabel:`Debug`. If you skip this " -"step, VC++ will use the Debug configuration by default." -msgstr "" - -#: ../src/Doc/extending/windows.rst:72 -msgid "" -"Build the DLL. Choose :menuselection:`Build --> Build Solution`. This " -"creates all intermediate and result files in a subdirectory called either :" -"file:`Debug` or :file:`Release`, depending on which configuration you " -"selected in the preceding step." -msgstr "" - -#: ../src/Doc/extending/windows.rst:77 -msgid "" -"**Testing the debug-mode DLL** --- Once the Debug build has succeeded, " -"bring up a DOS box, and change to the :file:`example_nt\\\\Debug` " -"directory. You should now be able to repeat the following session (``C>`` " -"is the DOS prompt, ``>>>`` is the Python prompt; note that build information " -"and various debug output from Python may not match this screen dump " -"exactly)::" -msgstr "" - -#: ../src/Doc/extending/windows.rst:95 -msgid "" -"Congratulations! You've successfully built your first Python extension " -"module." -msgstr "" - -# 2392e546ace14f5980fcb53837320efa -#: ../src/Doc/extending/windows.rst:97 -msgid "" -"**Creating your own project** --- Choose a name and create a directory for " -"it. Copy your C sources into it. Note that the module source file name " -"does not necessarily have to match the module name, but the name of the " -"initialization function should match the module name --- you can only import " -"a module :mod:`spam` if its initialization function is called :c:func:" -"`initspam`, and it should call :c:func:`Py_InitModule` with the string ``" -"\"spam\"`` as its first argument (use the minimal :file:`example.c` in this " -"directory as a guide). By convention, it lives in a file called :file:`spam." -"c` or :file:`spammodule.c`. The output file should be called :file:`spam." -"pyd` (in Release mode) or :file:`spam_d.pyd` (in Debug mode). The extension :" -"file:`.pyd` was chosen to avoid confusion with a system library :file:`spam." -"dll` to which your module could be a Python interface." -msgstr "" - -#: ../src/Doc/extending/windows.rst:114 -msgid "Now your options are:" -msgstr "" - -# 1eb3c8728f4346a3a093a1c4ce7b25cd -#: ../src/Doc/extending/windows.rst:116 -msgid "" -"Copy :file:`example.sln` and :file:`example.vcproj`, rename them to :file:" -"`spam.\\*`, and edit them by hand, or" -msgstr "" - -#: ../src/Doc/extending/windows.rst:119 -msgid "Create a brand new project; instructions are below." -msgstr "" - -#: ../src/Doc/extending/windows.rst:121 -msgid "" -"In either case, copy :file:`example_nt\\\\example.def` to :file:`spam\\" -"\\spam.def`, and edit the new :file:`spam.def` so its second line contains " -"the string '``initspam``'. If you created a new project yourself, add the " -"file :file:`spam.def` to the project now. (This is an annoying little file " -"with only two lines. An alternative approach is to forget about the :file:`." -"def` file, and add the option :option:`/export:initspam` somewhere to the " -"Link settings, by manually editing the setting in Project Properties dialog)." -msgstr "" - -#: ../src/Doc/extending/windows.rst:129 -msgid "" -"**Creating a brand new project** --- Use the :menuselection:`File --> New --" -"> Project` dialog to create a new Project Workspace. Select :guilabel:" -"`Visual C++ Projects/Win32/ Win32 Project`, enter the name (``spam``), and " -"make sure the Location is set to parent of the :file:`spam` directory you " -"have created (which should be a direct subdirectory of the Python build " -"tree, a sibling of :file:`Include` and :file:`PC`). Select Win32 as the " -"platform (in my version, this is the only choice). Make sure the Create new " -"workspace radio button is selected. Click OK." -msgstr "" - -#: ../src/Doc/extending/windows.rst:138 -msgid "" -"You should now create the file :file:`spam.def` as instructed in the " -"previous section. Add the source files to the project, using :menuselection:" -"`Project --> Add Existing Item`. Set the pattern to ``*.*`` and select both :" -"file:`spam.c` and :file:`spam.def` and click OK. (Inserting them one by one " -"is fine too.)" -msgstr "" - -#: ../src/Doc/extending/windows.rst:143 -msgid "" -"Now open the :menuselection:`Project --> spam properties` dialog. You only " -"need to change a few settings. Make sure :guilabel:`All Configurations` is " -"selected from the :guilabel:`Settings for:` dropdown list. Select the C/C++ " -"tab. Choose the General category in the popup menu at the top. Type the " -"following text in the entry box labeled :guilabel:`Additional Include " -"Directories`::" -msgstr "" - -#: ../src/Doc/extending/windows.rst:151 -msgid "Then, choose the General category in the Linker tab, and enter ::" -msgstr "" - -#: ../src/Doc/extending/windows.rst:155 -msgid "in the text box labelled :guilabel:`Additional library Directories`." -msgstr "" - -#: ../src/Doc/extending/windows.rst:157 -msgid "Now you need to add some mode-specific settings:" -msgstr "" - -#: ../src/Doc/extending/windows.rst:159 -msgid "" -"Select :guilabel:`Release` in the :guilabel:`Configuration` dropdown list. " -"Choose the :guilabel:`Link` tab, choose the :guilabel:`Input` category, and " -"append ``pythonXY.lib`` to the list in the :guilabel:`Additional " -"Dependencies` box." -msgstr "" - -#: ../src/Doc/extending/windows.rst:164 -msgid "" -"Select :guilabel:`Debug` in the :guilabel:`Configuration` dropdown list, and " -"append ``pythonXY_d.lib`` to the list in the :guilabel:`Additional " -"Dependencies` box. Then click the C/C++ tab, select :guilabel:`Code " -"Generation`, and select :guilabel:`Multi-threaded Debug DLL` from the :" -"guilabel:`Runtime library` dropdown list." -msgstr "" - -#: ../src/Doc/extending/windows.rst:170 -msgid "" -"Select :guilabel:`Release` again from the :guilabel:`Configuration` dropdown " -"list. Select :guilabel:`Multi-threaded DLL` from the :guilabel:`Runtime " -"library` dropdown list." -msgstr "" - -#: ../src/Doc/extending/windows.rst:174 -msgid "" -"If your module creates a new type, you may have trouble with this line::" -msgstr "" - -# ed7368577eba4616bdd2da116eb64bbe -#: ../src/Doc/extending/windows.rst:178 -msgid "" -"Static type object initializers in extension modules may cause compiles to " -"fail with an error message like \"initializer not a constant\". This shows " -"up when building DLL under MSVC. Change it to::" -msgstr "" - -#: ../src/Doc/extending/windows.rst:184 -msgid "and add the following to the module initialization function::" -msgstr "" - -#: ../src/Doc/extending/windows.rst:193 +#: extending/windows.rst:48 msgid "Differences Between Unix and Windows" msgstr "" -#: ../src/Doc/extending/windows.rst:198 +#: extending/windows.rst:53 msgid "" "Unix and Windows use completely different paradigms for run-time loading of " "code. Before you try to build a module that can be dynamically loaded, be " "aware of how your system works." msgstr "" -#: ../src/Doc/extending/windows.rst:202 +#: extending/windows.rst:57 msgid "" "In Unix, a shared object (:file:`.so`) file contains code to be used by the " "program, and also the names of functions and data that it expects to find in " @@ -3644,7 +3449,7 @@ msgid "" "memory. This is basically a link operation." msgstr "" -#: ../src/Doc/extending/windows.rst:209 +#: extending/windows.rst:64 msgid "" "In Windows, a dynamic-link library (:file:`.dll`) file has no dangling " "references. Instead, an access to functions or data goes through a lookup " @@ -3654,7 +3459,7 @@ msgid "" "data." msgstr "" -#: ../src/Doc/extending/windows.rst:215 +#: extending/windows.rst:70 msgid "" "In Unix, there is only one type of library file (:file:`.a`) which contains " "code from several object files (:file:`.o`). During the link step to create " @@ -3664,7 +3469,7 @@ msgid "" "that object file." msgstr "" -#: ../src/Doc/extending/windows.rst:221 +#: extending/windows.rst:76 msgid "" "In Windows, there are two types of library, a static library and an import " "library (both called :file:`.lib`). A static library is like a Unix :file:`." @@ -3678,7 +3483,7 @@ msgid "" "application or DLL." msgstr "" -#: ../src/Doc/extending/windows.rst:231 +#: extending/windows.rst:86 msgid "" "Suppose you are building two dynamic-load modules, B and C, which should " "share another block of code A. On Unix, you would *not* pass :file:`A.a` to " @@ -3689,7 +3494,7 @@ msgid "" "just contains information which will be used at runtime to access A's code." msgstr "" -#: ../src/Doc/extending/windows.rst:239 +#: extending/windows.rst:94 msgid "" "In Windows, using an import library is sort of like using ``import spam``; " "it gives you access to spam's names, but does not create a separate copy. " @@ -3697,18 +3502,18 @@ msgid "" "create a separate copy." msgstr "" -#: ../src/Doc/extending/windows.rst:248 +#: extending/windows.rst:103 msgid "Using DLLs in Practice" msgstr "" -#: ../src/Doc/extending/windows.rst:253 +#: extending/windows.rst:108 msgid "" "Windows Python is built in Microsoft Visual C++; using other compilers may " "or may not work (though Borland seems to). The rest of this section is MSVC+" "+ specific." msgstr "" -#: ../src/Doc/extending/windows.rst:257 +#: extending/windows.rst:112 msgid "" "When creating DLLs in Windows, you must pass :file:`pythonXY.lib` to the " "linker. To build two DLLs, spam and ni (which uses C functions found in " @@ -3716,7 +3521,7 @@ msgid "" msgstr "" # 6b85f7fe52bc4ec5a6b35fd14a4e80a1 -#: ../src/Doc/extending/windows.rst:264 +#: extending/windows.rst:119 msgid "" "The first command created three files: :file:`spam.obj`, :file:`spam.dll` " "and :file:`spam.lib`. :file:`Spam.dll` does not contain any Python " @@ -3724,14 +3529,14 @@ msgid "" "the Python code thanks to :file:`pythonXY.lib`." msgstr "" -#: ../src/Doc/extending/windows.rst:269 +#: extending/windows.rst:124 msgid "" "The second command created :file:`ni.dll` (and :file:`.obj` and :file:`." "lib`), which knows how to find the necessary functions from spam, and also " "from the Python executable." msgstr "" -#: ../src/Doc/extending/windows.rst:273 +#: extending/windows.rst:128 msgid "" "Not every identifier is exported to the lookup table. If you want any other " "modules (including Python) to be able to see your identifiers, you have to " @@ -3739,7 +3544,7 @@ msgid "" "initspam(void)`` or ``PyObject _declspec(dllexport) *NiGetSpamData(void)``." msgstr "" -#: ../src/Doc/extending/windows.rst:278 +#: extending/windows.rst:133 msgid "" "Developer Studio will throw in a lot of import libraries that you do not " "really need, adding about 100K to your executable. To get rid of them, use " diff --git a/faq.po b/faq.po index 6627d927..5f838ac4 100644 --- a/faq.po +++ b/faq.po @@ -7,25 +7,25 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/faq/design.rst:3 +#: faq/design.rst:3 msgid "Design and History FAQ" msgstr "FAQ Histoire et Design" -#: ../src/Doc/faq/design.rst:6 +#: faq/design.rst:6 msgid "Why does Python use indentation for grouping of statements?" msgstr "Pourquoi Python utilise l'indentation pour grouper les instructions ?" -#: ../src/Doc/faq/design.rst:8 +#: faq/design.rst:8 msgid "" "Guido van Rossum believes that using indentation for grouping is extremely " "elegant and contributes a lot to the clarity of the average Python program. " @@ -36,7 +36,7 @@ msgstr "" "programme Python. La plupart des gens finissent par aimer cette " "particularité au bout d'un moment." -#: ../src/Doc/faq/design.rst:12 +#: faq/design.rst:12 msgid "" "Since there are no begin/end brackets there cannot be a disagreement between " "grouping perceived by the parser and the human reader. Occasionally C " @@ -47,7 +47,7 @@ msgstr "" "humain. Parfois les programmeurs C pourront trouver un morceau de code comme " "celui-ci::" -#: ../src/Doc/faq/design.rst:21 +#: faq/design.rst:21 msgid "" "Only the ``x++`` statement is executed if the condition is true, but the " "indentation leads you to believe otherwise. Even experienced C programmers " @@ -59,7 +59,7 @@ msgstr "" "développeurs C expérimentés resteront pendant un moment à se demander " "pourquoi ``y`` est décrémenté même si ``x > y``." -#: ../src/Doc/faq/design.rst:26 +#: faq/design.rst:26 msgid "" "Because there are no begin/end brackets, Python is much less prone to coding-" "style conflicts. In C there are many different ways to place the braces. If " @@ -73,7 +73,7 @@ msgstr "" "vous pourriez vous sentir perturbé en lisant (ou en devant écrire) avec un " "autre style." -#: ../src/Doc/faq/design.rst:31 +#: faq/design.rst:31 #, fuzzy msgid "" "Many coding styles place begin/end brackets on a line by themselves. This " @@ -94,25 +94,25 @@ msgstr "" "niveau en sont également responsables -- mais la syntaxe basée sur " "l'indentation y est pour beaucoup." -#: ../src/Doc/faq/design.rst:41 +#: faq/design.rst:41 msgid "Why am I getting strange results with simple arithmetic operations?" msgstr "" "Pourquoi ai-je d'étranges résultats suite à de simples opérations " "arithmétiques ?" -#: ../src/Doc/faq/design.rst:43 +#: faq/design.rst:43 msgid "See the next question." msgstr "Voir la question suivante." -#: ../src/Doc/faq/design.rst:47 +#: faq/design.rst:47 msgid "Why are floating point calculations so inaccurate?" msgstr "Pourquoi les calculs à virgules flottantes sont si imprécis ?" -#: ../src/Doc/faq/design.rst:49 +#: faq/design.rst:49 msgid "People are often very surprised by results like this::" msgstr "Les gens sont très souvent surpris par des résultats comme celui-ci ::" -#: ../src/Doc/faq/design.rst:54 +#: faq/design.rst:54 msgid "" "and think it is a bug in Python. It's not. This has nothing to do with " "Python, but with how the underlying C platform handles floating point " @@ -125,7 +125,7 @@ msgstr "" "lors de l'écriture des nombres en chaînes de caractères d'un nombre fixe de " "chiffres." -#: ../src/Doc/faq/design.rst:59 +#: faq/design.rst:59 msgid "" "The internal representation of floating point numbers uses a fixed number of " "binary digits to represent a decimal number. Some decimal numbers can't be " @@ -136,7 +136,7 @@ msgstr "" "nombres décimaux ne peuvent être représentés exactement en binaire, " "résultant ainsi à de petites erreurs d'arrondi." -#: ../src/Doc/faq/design.rst:63 +#: faq/design.rst:63 msgid "" "In decimal math, there are many numbers that can't be represented with a " "fixed number of decimal digits, e.g. 1/3 = 0.3333333333......." @@ -144,7 +144,7 @@ msgstr "" "En mathématiques, beaucoup de nombre ne peuvent être représentés par un " "nombre fixe de chiffres, par exemple 1/3 = 0.3333333333......." -#: ../src/Doc/faq/design.rst:66 +#: faq/design.rst:66 msgid "" "In base 2, 1/2 = 0.1, 1/4 = 0.01, 1/8 = 0.001, etc. .2 equals 2/10 equals " "1/5, resulting in the binary fractional number 0.001100110011001..." @@ -153,7 +153,7 @@ msgstr "" "est égale à 1/5, ayant pour résultat le nombre fractionnel binaire " "0.001100110011001..." -#: ../src/Doc/faq/design.rst:69 +#: faq/design.rst:69 msgid "" "Floating point numbers only have 32 or 64 bits of precision, so the digits " "are cut off at some point, and the resulting number is 0.199999999999999996 " @@ -163,7 +163,7 @@ msgstr "" "bits, donc les chiffres finissent par être tronqués, et le nombre résultant " "est 0.199999999999999996 en décimal, pas 0.2." -#: ../src/Doc/faq/design.rst:73 +#: faq/design.rst:73 msgid "" "A floating point number's ``repr()`` function prints as many digits are " "necessary to make ``eval(repr(f)) == f`` true for any float f. The " @@ -175,7 +175,7 @@ msgstr "" "nombre décimal f. La fonction ``str()`` affiche moins de chiffres et " "correspond généralement plus au nombre attendu ::" -#: ../src/Doc/faq/design.rst:83 +#: faq/design.rst:83 msgid "" "One of the consequences of this is that it is error-prone to compare the " "result of some computation to a float with ``==``. Tiny inaccuracies may " @@ -188,7 +188,7 @@ msgstr "" "de cela, vous devez vérifier que la différence entre les deux chiffres est " "inférieure à un certain seuil ::" -#: ../src/Doc/faq/design.rst:94 +#: faq/design.rst:94 msgid "" "Please see the chapter on :ref:`floating point arithmetic ` " "in the Python tutorial for more information." @@ -196,15 +196,15 @@ msgstr "" "Veuillez vous référer au chapitre sur :ref:`floating point arithmetic ` du tutoriel python pour de plus amples informations." -#: ../src/Doc/faq/design.rst:99 +#: faq/design.rst:99 msgid "Why are Python strings immutable?" msgstr "Pourquoi les chaînes de caractères Python sont-elles immuable ?" -#: ../src/Doc/faq/design.rst:101 +#: faq/design.rst:101 msgid "There are several advantages." msgstr "Il y a plusieurs avantages." -#: ../src/Doc/faq/design.rst:103 +#: faq/design.rst:103 msgid "" "One is performance: knowing that a string is immutable means we can allocate " "space for it at creation time, and the storage requirements are fixed and " @@ -216,7 +216,7 @@ msgstr "" "cette chaîne est fixe et figé. C'est aussi l'une des raisons pour lesquelles " "on fait la distinction entre les tuples et les listes." -#: ../src/Doc/faq/design.rst:108 +#: faq/design.rst:108 msgid "" "Another advantage is that strings in Python are considered as \"elemental\" " "as numbers. No amount of activity will change the value 8 to anything else, " @@ -228,13 +228,13 @@ msgstr "" "nombre 8 en autre chose, et en Python, aucun processus changera la chaîne de " "caractère \"huit\" en autre chose." -#: ../src/Doc/faq/design.rst:116 +#: faq/design.rst:116 msgid "Why must 'self' be used explicitly in method definitions and calls?" msgstr "" "Pourquoi \"self\" doit-il être explicitement utilisé dans les définitions et " "les appels de méthode ?" -#: ../src/Doc/faq/design.rst:118 +#: faq/design.rst:118 msgid "" "The idea was borrowed from Modula-3. It turns out to be very useful, for a " "variety of reasons." @@ -242,7 +242,7 @@ msgstr "" "L'idée a été empruntée à Modula-3. Il s'avère être très utile, pour diverses " "raisons." -#: ../src/Doc/faq/design.rst:121 +#: faq/design.rst:121 msgid "" "First, it's more obvious that you are using a method or instance attribute " "instead of a local variable. Reading ``self.x`` or ``self.meth()`` makes it " @@ -266,7 +266,7 @@ msgstr "" "codages C++ et Java préfixent les attributs d'instance par ``m_``. Cette " "syntaxe explicite est ainsi utile également pour ces langages." -#: ../src/Doc/faq/design.rst:131 +#: faq/design.rst:131 msgid "" "Second, it means that no special syntax is necessary if you want to " "explicitly reference or call the method from a particular class. In C++, if " @@ -287,7 +287,7 @@ msgstr "" "étendre la méthode du même nom de la classe de base, devant ainsi appeler la " "méthode de la classe de base d'une certaine manière." -#: ../src/Doc/faq/design.rst:140 +#: faq/design.rst:140 msgid "" "Finally, for instance variables it solves a syntactic problem with " "assignment: since local variables in Python are (by definition!) those " @@ -320,22 +320,22 @@ msgstr "" "locales et les variables d'instance vivent dans deux différents espaces de " "noms, et vous devez dire à Python quel espace de noms utiliser." -#: ../src/Doc/faq/design.rst:156 +#: faq/design.rst:156 msgid "Why can't I use an assignment in an expression?" msgstr "Pourquoi ne puis-je pas utiliser d'assignation dans une expression ?" -#: ../src/Doc/faq/design.rst:158 +#: faq/design.rst:158 msgid "" "Many people used to C or Perl complain that they want to use this C idiom:" msgstr "" "De nombreuses personnes habituées à C ou Perl se plaignent de vouloir " "utiliser cet idiome C :" -#: ../src/Doc/faq/design.rst:166 +#: faq/design.rst:166 msgid "where in Python you're forced to write this::" msgstr "où en Python vous êtes forcé à écrire ceci ::" -#: ../src/Doc/faq/design.rst:174 +#: faq/design.rst:174 msgid "" "The reason for not allowing assignment in Python expressions is a common, " "hard-to-find bug in those other languages, caused by this construct:" @@ -344,7 +344,7 @@ msgstr "" "est un bug fréquent, et difficile à trouver dans ces autres langages, causé " "par cette construction :" -#: ../src/Doc/faq/design.rst:186 +#: faq/design.rst:186 msgid "" "The error is a simple typo: ``x = 0``, which assigns 0 to the variable " "``x``, was written while the comparison ``x == 0`` is certainly what was " @@ -354,7 +354,7 @@ msgstr "" "variable ``x``, a été écrit alors que la comparaison ``x == 0`` est " "certainement ce qui était souhaité." -#: ../src/Doc/faq/design.rst:189 +#: faq/design.rst:189 msgid "" "Many alternatives have been proposed. Most are hacks that save some typing " "but use arbitrary or cryptic syntax or keywords, and fail the simple " @@ -368,7 +368,7 @@ msgstr "" "changement du langage : ça doit intuitivement suggérer la bonne " "signification au lecteur qui n'a pas encore été introduit à la construction." -#: ../src/Doc/faq/design.rst:194 +#: faq/design.rst:194 msgid "" "An interesting phenomenon is that most experienced Python programmers " "recognize the ``while True`` idiom and don't seem to be missing the " @@ -380,7 +380,7 @@ msgstr "" "manquer l'assignation dans la construction de l'expression; seuls les " "nouveaux-venus expriment un fort désir d'ajouter ceci au langage." -#: ../src/Doc/faq/design.rst:199 +#: faq/design.rst:199 msgid "" "There's an alternative way of spelling this that seems attractive but is " "generally less robust than the \"while True\" solution::" @@ -388,7 +388,7 @@ msgstr "" "Il y a une manière alternative de faire ça qui semble attrayante mais elle " "est généralement moins robuste que la solution ``while True`` ::" -#: ../src/Doc/faq/design.rst:207 +#: faq/design.rst:207 msgid "" "The problem with this is that if you change your mind about exactly how you " "get the next line (e.g. you want to change it into ``sys.stdin.readline()``) " @@ -401,7 +401,7 @@ msgstr "" "dans votre programme -- la deuxième occurrence est cachée en bas de la " "boucle." -#: ../src/Doc/faq/design.rst:212 +#: faq/design.rst:212 msgid "" "The best approach is to use iterators, making it possible to loop through " "objects using the ``for`` statement. For example, in the current version of " @@ -413,7 +413,7 @@ msgstr "" "exemple, dans la version actuelle de Python, les fichiers objets supportent " "le protocole d'itérateur, vous pouvez alors simplement écrire ::" -#: ../src/Doc/faq/design.rst:222 +#: faq/design.rst:222 msgid "" "Why does Python use methods for some functionality (e.g. list.index()) but " "functions for other (e.g. len(list))?" @@ -421,7 +421,7 @@ msgstr "" "Pourquoi Python utilise des méthodes pour certaines fonctionnalités (ex : " "list.index()) mais des fonctions pour d'autres (ex : len(list)) ?" -#: ../src/Doc/faq/design.rst:224 +#: faq/design.rst:224 #, fuzzy msgid "" "The major reason is history. Functions were used for those operations that " @@ -438,7 +438,7 @@ msgstr "" "bien à une collection amorphe d'objets lorsque vous utiliser les " "fonctionnalités fonctionnelles de Python (``map()``, ``apply()`` et autres)." -#: ../src/Doc/faq/design.rst:230 +#: faq/design.rst:230 msgid "" "In fact, implementing ``len()``, ``max()``, ``min()`` as a built-in function " "is actually less code than implementing them as methods for each type. One " @@ -453,7 +453,7 @@ msgstr "" "fondamentaux maintenant. Ces fonctions doivent rester pour éviter la casse " "massive de code." -#: ../src/Doc/faq/design.rst:240 +#: faq/design.rst:240 msgid "" "For string operations, Python has moved from external functions (the " "``string`` module) to methods. However, ``len()`` is still a function." @@ -462,13 +462,13 @@ msgstr "" "module ``string``) vers des méthodes. Cependant, ``len()`` est toujours une " "fonction." -#: ../src/Doc/faq/design.rst:245 +#: faq/design.rst:245 msgid "Why is join() a string method instead of a list or tuple method?" msgstr "" "Pourquoi join() est une méthode de chaîne plutôt qu'une de liste ou de " "tuple ?" -#: ../src/Doc/faq/design.rst:247 +#: faq/design.rst:247 msgid "" "Strings became much more like other standard types starting in Python 1.6, " "when methods were added which give the same functionality that has always " @@ -483,15 +483,15 @@ msgstr "" "largement acceptées, mais celle qui semble rendre certains programmeurs " "inconfortables est ::" -#: ../src/Doc/faq/design.rst:255 +#: faq/design.rst:255 msgid "which gives the result::" msgstr "qui donne le résultat ::" -#: ../src/Doc/faq/design.rst:259 +#: faq/design.rst:259 msgid "There are two common arguments against this usage." msgstr "Il y a deux arguments fréquents contre cet usage." -#: ../src/Doc/faq/design.rst:261 +#: faq/design.rst:261 msgid "" "The first runs along the lines of: \"It looks really ugly using a method of " "a string literal (string constant)\", to which the answer is that it might, " @@ -505,7 +505,7 @@ msgstr "" "fixe. Si la méthode est autorisée sur des noms liés à des chaînes, il n'y a " "pas de raison logique à les rendre indisponibles sur des chaînes littérales." -#: ../src/Doc/faq/design.rst:267 +#: faq/design.rst:267 msgid "" "The second objection is typically cast as: \"I am really telling a sequence " "to join its members together with a string constant\". Sadly, you aren't. " @@ -518,7 +518,7 @@ msgstr "" "semble être bien moins difficile d'avoir :meth:`~str.split` en tant que " "méthode de chaîne, puisque dans ce cas il est facile de voir que ::" -#: ../src/Doc/faq/design.rst:274 +#: faq/design.rst:274 #, fuzzy msgid "" "is an instruction to a string literal to return the substrings delimited by " @@ -529,7 +529,7 @@ msgstr "" "est une instruction à une chaîne littérale de retourner les sous-chaînes " "délimitées par le séparateur fournit (ou, par défaut, les espaces)." -#: ../src/Doc/faq/design.rst:279 +#: faq/design.rst:279 #, fuzzy msgid "" ":meth:`~str.join` is a string method because in using it you are telling the " @@ -546,7 +546,7 @@ msgstr "" "même. Des méthodes similaires existent pour des objets bytes et bytearray." # bc8c48cf76c84ee28d8f5af935ed1be1 -#: ../src/Doc/faq/design.rst:284 +#: faq/design.rst:284 msgid "" "Because this is a string method it can work for Unicode strings as well as " "plain ASCII strings. If ``join()`` were a method of the sequence types then " @@ -555,43 +555,43 @@ msgid "" msgstr "" # 782a63ed666f4337b589ba793330c154 -#: ../src/Doc/faq/design.rst:291 +#: faq/design.rst:291 msgid "" "If none of these arguments persuade you, then for the moment you can " "continue to use the ``join()`` function from the string module, which allows " "you to write ::" msgstr "" -#: ../src/Doc/faq/design.rst:298 +#: faq/design.rst:298 msgid "How fast are exceptions?" msgstr "" # b6f0277dd5004985a79e89b89ea52fec -#: ../src/Doc/faq/design.rst:300 +#: faq/design.rst:300 msgid "" "A try/except block is extremely efficient if no exceptions are raised. " "Actually catching an exception is expensive. In versions of Python prior to " "2.0 it was common to use this idiom::" msgstr "" -#: ../src/Doc/faq/design.rst:310 +#: faq/design.rst:310 msgid "" "This only made sense when you expected the dict to have the key almost all " "the time. If that wasn't the case, you coded it like this::" msgstr "" # 84b13a622f3547d993c38485fa698d55 -#: ../src/Doc/faq/design.rst:320 +#: faq/design.rst:320 msgid "" "In Python 2.0 and higher, you can code this as ``value = mydict." "setdefault(key, getvalue(key))``." msgstr "" -#: ../src/Doc/faq/design.rst:325 +#: faq/design.rst:325 msgid "Why isn't there a switch or case statement in Python?" msgstr "" -#: ../src/Doc/faq/design.rst:327 +#: faq/design.rst:327 msgid "" "You can do this easily enough with a sequence of ``if... elif... elif... " "else``. There have been some proposals for switch statement syntax, but " @@ -599,20 +599,20 @@ msgid "" "`275` for complete details and the current status." msgstr "" -#: ../src/Doc/faq/design.rst:332 +#: faq/design.rst:332 msgid "" "For cases where you need to choose from a very large number of " "possibilities, you can create a dictionary mapping case values to functions " "to call. For example::" msgstr "" -#: ../src/Doc/faq/design.rst:346 +#: faq/design.rst:346 msgid "" "For calling methods on objects, you can simplify yet further by using the :" "func:`getattr` built-in to retrieve methods with a particular name::" msgstr "" -#: ../src/Doc/faq/design.rst:358 +#: faq/design.rst:358 msgid "" "It's suggested that you use a prefix for the method names, such as " "``visit_`` in this example. Without such a prefix, if values are coming " @@ -620,13 +620,13 @@ msgid "" "your object." msgstr "" -#: ../src/Doc/faq/design.rst:364 +#: faq/design.rst:364 msgid "" "Can't you emulate threads in the interpreter instead of relying on an OS-" "specific thread implementation?" msgstr "" -#: ../src/Doc/faq/design.rst:366 +#: faq/design.rst:366 msgid "" "Answer 1: Unfortunately, the interpreter pushes at least one C stack frame " "for each Python stack frame. Also, extensions can call back into Python at " @@ -635,7 +635,7 @@ msgid "" msgstr "" # 90c31368a54d47e599f0c7a62ff060e5 -#: ../src/Doc/faq/design.rst:371 +#: faq/design.rst:371 msgid "" "Answer 2: Fortunately, there is `Stackless Python `_, which has a completely redesigned interpreter loop that avoids the C " @@ -643,12 +643,12 @@ msgid "" msgstr "" # 9d39032c5cef4182b90f76f54e892445 -#: ../src/Doc/faq/design.rst:376 +#: faq/design.rst:376 msgid "Why can't lambda expressions contain statements?" msgstr "" # 2ad3f5f006c2486191151cca91d654d6 -#: ../src/Doc/faq/design.rst:378 +#: faq/design.rst:378 msgid "" "Python lambda expressions cannot contain statements because Python's " "syntactic framework can't handle statements nested inside expressions. " @@ -658,7 +658,7 @@ msgid "" msgstr "" # 159c73c109504f54bc8287595f3e3650 -#: ../src/Doc/faq/design.rst:384 +#: faq/design.rst:384 msgid "" "Functions are already first class objects in Python, and can be declared in " "a local scope. Therefore the only advantage of using a lambda instead of a " @@ -668,12 +668,12 @@ msgid "" "is assigned!" msgstr "" -#: ../src/Doc/faq/design.rst:392 +#: faq/design.rst:392 msgid "Can Python be compiled to machine code, C or some other language?" msgstr "" # 4de1ffd8c7e74c52acedce7311a5a494 -#: ../src/Doc/faq/design.rst:394 +#: faq/design.rst:394 msgid "" "Not easily. Python's high level data types, dynamic typing of objects and " "run-time invocation of the interpreter (using :func:`eval` or :keyword:" @@ -683,7 +683,7 @@ msgid "" msgstr "" # 6688fdbd52584526b8c5e61dbb5cdc7a -#: ../src/Doc/faq/design.rst:400 +#: faq/design.rst:400 msgid "" "Several projects described in the Python newsgroup or at past `Python " "conferences `_ have shown that " @@ -695,7 +695,7 @@ msgid "" "org/workshops/1997-10/proceedings/>`_ for more information.)" msgstr "" -#: ../src/Doc/faq/design.rst:409 +#: faq/design.rst:409 msgid "" "Internally, Python source code is always translated into a bytecode " "representation, and this bytecode is then executed by the Python virtual " @@ -706,7 +706,7 @@ msgid "" "the .pyc file is rewritten." msgstr "" -#: ../src/Doc/faq/design.rst:416 +#: faq/design.rst:416 msgid "" "There is no performance difference once the .pyc file has been loaded, as " "the bytecode read from the .pyc file is exactly the same as the bytecode " @@ -717,7 +717,7 @@ msgid "" "valid .pyc files for a given set of modules." msgstr "" -#: ../src/Doc/faq/design.rst:424 +#: faq/design.rst:424 msgid "" "Note that the main script executed by Python, even if its filename ends in ." "py, is not compiled to a .pyc file. It is compiled to bytecode, but the " @@ -726,7 +726,7 @@ msgid "" msgstr "" # cad7dbb80cab46a0ac25bd124a5ae308 -#: ../src/Doc/faq/design.rst:431 +#: faq/design.rst:431 msgid "" "There are also several programs which make it easier to intermingle Python " "and C code in various ways to increase performance. See, for example, " @@ -737,11 +737,11 @@ msgid "" "reference/tutorial/weave.html>`_." msgstr "" -#: ../src/Doc/faq/design.rst:441 +#: faq/design.rst:441 msgid "How does Python manage memory?" msgstr "" -#: ../src/Doc/faq/design.rst:443 +#: faq/design.rst:443 msgid "" "The details of Python memory management depend on the implementation. The " "standard C implementation of Python uses reference counting to detect " @@ -752,7 +752,7 @@ msgid "" "statistics, and tune the collector's parameters." msgstr "" -#: ../src/Doc/faq/design.rst:451 +#: faq/design.rst:451 msgid "" "Jython relies on the Java runtime so the JVM's garbage collector is used. " "This difference can cause some subtle porting problems if your Python code " @@ -760,14 +760,14 @@ msgid "" msgstr "" # 10bafb17f7824b78b845e7dbc318d8db -#: ../src/Doc/faq/design.rst:457 +#: faq/design.rst:457 msgid "" "Sometimes objects get stuck in tracebacks temporarily and hence are not " "deallocated when you might expect. Clear the tracebacks with::" msgstr "" # 6f33da00d80d46bebfeb3ef2cf98b43a -#: ../src/Doc/faq/design.rst:464 +#: faq/design.rst:464 msgid "" "Tracebacks are used for reporting errors, implementing debuggers and related " "things. They contain a portion of the program state extracted during the " @@ -775,13 +775,13 @@ msgid "" msgstr "" # 3d80990eb0854adc91be5e05e67a9cc5 -#: ../src/Doc/faq/design.rst:468 +#: faq/design.rst:468 msgid "" "In the absence of circularities and tracebacks, Python programs do not need " "to manage memory explicitly." msgstr "" -#: ../src/Doc/faq/design.rst:471 +#: faq/design.rst:471 msgid "" "Why doesn't Python use a more traditional garbage collection scheme? For " "one thing, this is not a C standard feature and hence it's not portable. " @@ -791,7 +791,7 @@ msgid "" "Python to work with it.)" msgstr "" -#: ../src/Doc/faq/design.rst:478 +#: faq/design.rst:478 msgid "" "Traditional GC also becomes a problem when Python is embedded into other " "applications. While in a standalone Python it's fine to replace the " @@ -801,13 +801,13 @@ msgid "" "with anything that implements malloc() and free() properly." msgstr "" -#: ../src/Doc/faq/design.rst:485 +#: faq/design.rst:485 msgid "" "In Jython, the following code (which is fine in CPython) will probably run " "out of file descriptors long before it runs out of memory::" msgstr "" -#: ../src/Doc/faq/design.rst:492 +#: faq/design.rst:492 msgid "" "Using the current reference counting and destructor scheme, each new " "assignment to f closes the previous file. Using GC, this is not " @@ -816,11 +816,11 @@ msgid "" "`with` statement; this will work regardless of GC::" msgstr "" -#: ../src/Doc/faq/design.rst:504 +#: faq/design.rst:504 msgid "Why isn't all memory freed when Python exits?" msgstr "" -#: ../src/Doc/faq/design.rst:506 +#: faq/design.rst:506 msgid "" "Objects referenced from the global namespaces of Python modules are not " "always deallocated when Python exits. This may happen if there are circular " @@ -830,17 +830,17 @@ msgid "" "exit and does try to destroy every single object." msgstr "" -#: ../src/Doc/faq/design.rst:513 +#: faq/design.rst:513 msgid "" "If you want to force Python to delete certain things on deallocation use " "the :mod:`atexit` module to run a function that will force those deletions." msgstr "" -#: ../src/Doc/faq/design.rst:518 +#: faq/design.rst:518 msgid "Why are there separate tuple and list data types?" msgstr "" -#: ../src/Doc/faq/design.rst:520 +#: faq/design.rst:520 msgid "" "Lists and tuples, while similar in many respects, are generally used in " "fundamentally different ways. Tuples can be thought of as being similar to " @@ -850,7 +850,7 @@ msgid "" "numbers." msgstr "" -#: ../src/Doc/faq/design.rst:527 +#: faq/design.rst:527 msgid "" "Lists, on the other hand, are more like arrays in other languages. They " "tend to hold a varying number of objects all of which have the same type and " @@ -860,7 +860,7 @@ msgid "" "added another file or two to the directory." msgstr "" -#: ../src/Doc/faq/design.rst:534 +#: faq/design.rst:534 msgid "" "Tuples are immutable, meaning that once a tuple has been created, you can't " "replace any of its elements with a new value. Lists are mutable, meaning " @@ -869,11 +869,11 @@ msgid "" "as keys." msgstr "" -#: ../src/Doc/faq/design.rst:541 +#: faq/design.rst:541 msgid "How are lists implemented?" msgstr "" -#: ../src/Doc/faq/design.rst:543 +#: faq/design.rst:543 msgid "" "Python's lists are really variable-length arrays, not Lisp-style linked " "lists. The implementation uses a contiguous array of references to other " @@ -881,13 +881,13 @@ msgid "" "head structure." msgstr "" -#: ../src/Doc/faq/design.rst:547 +#: faq/design.rst:547 msgid "" "This makes indexing a list ``a[i]`` an operation whose cost is independent " "of the size of the list or the value of the index." msgstr "" -#: ../src/Doc/faq/design.rst:550 +#: faq/design.rst:550 msgid "" "When items are appended or inserted, the array of references is resized. " "Some cleverness is applied to improve the performance of appending items " @@ -895,18 +895,18 @@ msgid "" "the next few times don't require an actual resize." msgstr "" -#: ../src/Doc/faq/design.rst:557 +#: faq/design.rst:557 msgid "How are dictionaries implemented?" msgstr "" -#: ../src/Doc/faq/design.rst:559 +#: faq/design.rst:559 msgid "" "Python's dictionaries are implemented as resizable hash tables. Compared to " "B-trees, this gives better performance for lookup (the most common operation " "by far) under most circumstances, and the implementation is simpler." msgstr "" -#: ../src/Doc/faq/design.rst:563 +#: faq/design.rst:563 msgid "" "Dictionaries work by computing a hash code for each key stored in the " "dictionary using the :func:`hash` built-in function. The hash code varies " @@ -921,11 +921,11 @@ msgid "" "dictionary's content in some arbitrary jumbled order." msgstr "" -#: ../src/Doc/faq/design.rst:576 +#: faq/design.rst:576 msgid "Why must dictionary keys be immutable?" msgstr "" -#: ../src/Doc/faq/design.rst:578 +#: faq/design.rst:578 msgid "" "The hash table implementation of dictionaries uses a hash value calculated " "from the key value to find the key. If the key were a mutable object, its " @@ -938,7 +938,7 @@ msgid "" "would be different." msgstr "" -#: ../src/Doc/faq/design.rst:587 +#: faq/design.rst:587 msgid "" "If you want a dictionary indexed with a list, simply convert the list to a " "tuple first; the function ``tuple(L)`` creates a tuple with the same entries " @@ -946,31 +946,31 @@ msgid "" "dictionary keys." msgstr "" -#: ../src/Doc/faq/design.rst:591 +#: faq/design.rst:591 msgid "Some unacceptable solutions that have been proposed:" msgstr "" -#: ../src/Doc/faq/design.rst:593 +#: faq/design.rst:593 msgid "" "Hash lists by their address (object ID). This doesn't work because if you " "construct a new list with the same value it won't be found; e.g.::" msgstr "" -#: ../src/Doc/faq/design.rst:599 +#: faq/design.rst:599 msgid "" "would raise a KeyError exception because the id of the ``[1, 2]`` used in " "the second line differs from that in the first line. In other words, " "dictionary keys should be compared using ``==``, not using :keyword:`is`." msgstr "" -#: ../src/Doc/faq/design.rst:603 +#: faq/design.rst:603 msgid "" "Make a copy when using a list as a key. This doesn't work because the list, " "being a mutable object, could contain a reference to itself, and then the " "copying code would run into an infinite loop." msgstr "" -#: ../src/Doc/faq/design.rst:607 +#: faq/design.rst:607 msgid "" "Allow lists as keys but tell the user not to modify them. This would allow " "a class of hard-to-track bugs in programs when you forgot or modified a list " @@ -978,7 +978,7 @@ msgid "" "every value in ``d.keys()`` is usable as a key of the dictionary." msgstr "" -#: ../src/Doc/faq/design.rst:612 +#: faq/design.rst:612 msgid "" "Mark lists as read-only once they are used as a dictionary key. The problem " "is that it's not just the top-level object that could change its value; you " @@ -988,7 +988,7 @@ msgid "" "loop." msgstr "" -#: ../src/Doc/faq/design.rst:618 +#: faq/design.rst:618 msgid "" "There is a trick to get around this if you need to, but use it at your own " "risk: You can wrap a mutable structure inside a class instance which has " @@ -998,14 +998,14 @@ msgid "" "in the dictionary (or other structure). ::" msgstr "" -#: ../src/Doc/faq/design.rst:640 +#: faq/design.rst:640 msgid "" "Note that the hash computation is complicated by the possibility that some " "members of the list may be unhashable and also by the possibility of " "arithmetic overflow." msgstr "" -#: ../src/Doc/faq/design.rst:644 +#: faq/design.rst:644 msgid "" "Furthermore it must always be the case that if ``o1 == o2`` (ie ``o1." "__eq__(o2) is True``) then ``hash(o1) == hash(o2)`` (ie, ``o1.__hash__() == " @@ -1014,7 +1014,7 @@ msgid "" "based structures will misbehave." msgstr "" -#: ../src/Doc/faq/design.rst:649 +#: faq/design.rst:649 msgid "" "In the case of ListWrapper, whenever the wrapper object is in a dictionary " "the wrapped list must not change to avoid anomalies. Don't do this unless " @@ -1022,11 +1022,11 @@ msgid "" "of not meeting them correctly. Consider yourself warned." msgstr "" -#: ../src/Doc/faq/design.rst:656 +#: faq/design.rst:656 msgid "Why doesn't list.sort() return the sorted list?" msgstr "" -#: ../src/Doc/faq/design.rst:658 +#: faq/design.rst:658 msgid "" "In situations where performance matters, making a copy of the list just to " "sort it would be wasteful. Therefore, :meth:`list.sort` sorts the list in " @@ -1036,7 +1036,7 @@ msgid "" "around." msgstr "" -#: ../src/Doc/faq/design.rst:664 +#: faq/design.rst:664 msgid "" "In Python 2.4 a new built-in function -- :func:`sorted` -- has been added. " "This function creates a new list from a provided iterable, sorts it and " @@ -1044,11 +1044,11 @@ msgid "" "dictionary in sorted order::" msgstr "" -#: ../src/Doc/faq/design.rst:674 +#: faq/design.rst:674 msgid "How do you specify and enforce an interface spec in Python?" msgstr "" -#: ../src/Doc/faq/design.rst:676 +#: faq/design.rst:676 msgid "" "An interface specification for a module as provided by languages such as C++ " "and Java describes the prototypes for the methods and functions of the " @@ -1057,7 +1057,7 @@ msgid "" msgstr "" # d2ba30372839470fb58835ecfbd8cfe3 -#: ../src/Doc/faq/design.rst:681 +#: faq/design.rst:681 msgid "" "Python 2.6 adds an :mod:`abc` module that lets you define Abstract Base " "Classes (ABCs). You can then use :func:`isinstance` and :func:`issubclass` " @@ -1067,14 +1067,14 @@ msgid "" "`~collections.MutableMapping`." msgstr "" -#: ../src/Doc/faq/design.rst:688 +#: faq/design.rst:688 msgid "" "For Python, many of the advantages of interface specifications can be " "obtained by an appropriate test discipline for components. There is also a " "tool, PyChecker, which can be used to find problems due to subclassing." msgstr "" -#: ../src/Doc/faq/design.rst:692 +#: faq/design.rst:692 msgid "" "A good test suite for a module can both provide a regression test and serve " "as a module interface specification and a set of examples. Many Python " @@ -1086,7 +1086,7 @@ msgid "" "in a module." msgstr "" -#: ../src/Doc/faq/design.rst:700 +#: faq/design.rst:700 msgid "" "An appropriate testing discipline can help build large complex applications " "in Python as well as having interface specifications would. In fact, it can " @@ -1097,7 +1097,7 @@ msgid "" "correctly, but it's trivial to check this property in a test suite." msgstr "" -#: ../src/Doc/faq/design.rst:708 +#: faq/design.rst:708 msgid "" "Writing test suites is very helpful, and you might want to design your code " "with an eye to making it easily tested. One increasingly popular technique, " @@ -1106,11 +1106,11 @@ msgid "" "sloppy and not write test cases at all." msgstr "" -#: ../src/Doc/faq/design.rst:716 +#: faq/design.rst:716 msgid "Why is there no goto?" msgstr "" -#: ../src/Doc/faq/design.rst:718 +#: faq/design.rst:718 msgid "" "You can use exceptions to provide a \"structured goto\" that even works " "across function calls. Many feel that exceptions can conveniently emulate " @@ -1118,24 +1118,24 @@ msgid "" "other languages. For example::" msgstr "" -#: ../src/Doc/faq/design.rst:733 +#: faq/design.rst:733 msgid "" "This doesn't allow you to jump into the middle of a loop, but that's usually " "considered an abuse of goto anyway. Use sparingly." msgstr "" -#: ../src/Doc/faq/design.rst:738 +#: faq/design.rst:738 msgid "Why can't raw strings (r-strings) end with a backslash?" msgstr "" -#: ../src/Doc/faq/design.rst:740 +#: faq/design.rst:740 msgid "" "More precisely, they can't end with an odd number of backslashes: the " "unpaired backslash at the end escapes the closing quote character, leaving " "an unterminated string." msgstr "" -#: ../src/Doc/faq/design.rst:744 +#: faq/design.rst:744 msgid "" "Raw strings were designed to ease creating input for processors (chiefly " "regular expression engines) that want to do their own backslash escape " @@ -1145,33 +1145,33 @@ msgid "" "rules work well when r-strings are used for their intended purpose." msgstr "" -#: ../src/Doc/faq/design.rst:751 +#: faq/design.rst:751 msgid "" "If you're trying to build Windows pathnames, note that all Windows system " "calls accept forward slashes too::" msgstr "" -#: ../src/Doc/faq/design.rst:756 +#: faq/design.rst:756 msgid "" "If you're trying to build a pathname for a DOS command, try e.g. one of ::" msgstr "" -#: ../src/Doc/faq/design.rst:764 +#: faq/design.rst:764 msgid "Why doesn't Python have a \"with\" statement for attribute assignments?" msgstr "" -#: ../src/Doc/faq/design.rst:766 +#: faq/design.rst:766 msgid "" "Python has a 'with' statement that wraps the execution of a block, calling " "code on the entrance and exit from the block. Some language have a " "construct that looks like this::" msgstr "" -#: ../src/Doc/faq/design.rst:774 +#: faq/design.rst:774 msgid "In Python, such a construct would be ambiguous." msgstr "" -#: ../src/Doc/faq/design.rst:776 +#: faq/design.rst:776 msgid "" "Other languages, such as Object Pascal, Delphi, and C++, use static types, " "so it's possible to know, in an unambiguous way, what member is being " @@ -1179,7 +1179,7 @@ msgid "" "*always* knows the scope of every variable at compile time." msgstr "" -#: ../src/Doc/faq/design.rst:781 +#: faq/design.rst:781 msgid "" "Python uses dynamic types. It is impossible to know in advance which " "attribute will be referenced at runtime. Member attributes may be added or " @@ -1188,11 +1188,11 @@ msgid "" "one, or a member attribute?" msgstr "" -#: ../src/Doc/faq/design.rst:787 +#: faq/design.rst:787 msgid "For instance, take the following incomplete snippet::" msgstr "" -#: ../src/Doc/faq/design.rst:793 +#: faq/design.rst:793 msgid "" "The snippet assumes that \"a\" must have a member attribute called \"x\". " "However, there is nothing in Python that tells the interpreter this. What " @@ -1201,46 +1201,46 @@ msgid "" "the dynamic nature of Python makes such choices much harder." msgstr "" -#: ../src/Doc/faq/design.rst:799 +#: faq/design.rst:799 msgid "" "The primary benefit of \"with\" and similar language features (reduction of " "code volume) can, however, easily be achieved in Python by assignment. " "Instead of::" msgstr "" -#: ../src/Doc/faq/design.rst:806 +#: faq/design.rst:806 msgid "write this::" msgstr "" -#: ../src/Doc/faq/design.rst:813 +#: faq/design.rst:813 msgid "" "This also has the side-effect of increasing execution speed because name " "bindings are resolved at run-time in Python, and the second version only " "needs to perform the resolution once." msgstr "" -#: ../src/Doc/faq/design.rst:819 +#: faq/design.rst:819 msgid "Why are colons required for the if/while/def/class statements?" msgstr "" -#: ../src/Doc/faq/design.rst:821 +#: faq/design.rst:821 msgid "" "The colon is required primarily to enhance readability (one of the results " "of the experimental ABC language). Consider this::" msgstr "" -#: ../src/Doc/faq/design.rst:827 +#: faq/design.rst:827 msgid "versus ::" msgstr "" -#: ../src/Doc/faq/design.rst:832 +#: faq/design.rst:832 msgid "" "Notice how the second one is slightly easier to read. Notice further how a " "colon sets off the example in this FAQ answer; it's a standard usage in " "English." msgstr "" -#: ../src/Doc/faq/design.rst:835 +#: faq/design.rst:835 msgid "" "Another minor reason is that the colon makes it easier for editors with " "syntax highlighting; they can look for colons to decide when indentation " @@ -1248,22 +1248,22 @@ msgid "" "the program text." msgstr "" -#: ../src/Doc/faq/design.rst:841 +#: faq/design.rst:841 msgid "Why does Python allow commas at the end of lists and tuples?" msgstr "" -#: ../src/Doc/faq/design.rst:843 +#: faq/design.rst:843 msgid "" "Python lets you add a trailing comma at the end of lists, tuples, and " "dictionaries::" msgstr "" -#: ../src/Doc/faq/design.rst:854 +#: faq/design.rst:854 msgid "There are several reasons to allow this." msgstr "" # 298742dc20444d93965e2fca2825408f -#: ../src/Doc/faq/design.rst:856 +#: faq/design.rst:856 msgid "" "When you have a literal value for a list, tuple, or dictionary spread across " "multiple lines, it's easier to add more elements because you don't have to " @@ -1271,49 +1271,49 @@ msgid "" "reordered without creating a syntax error." msgstr "" -#: ../src/Doc/faq/design.rst:861 +#: faq/design.rst:861 msgid "" "Accidentally omitting the comma can lead to errors that are hard to " "diagnose. For example::" msgstr "" -#: ../src/Doc/faq/design.rst:871 +#: faq/design.rst:871 msgid "" "This list looks like it has four elements, but it actually contains three: " "\"fee\", \"fiefoo\" and \"fum\". Always adding the comma avoids this source " "of error." msgstr "" -#: ../src/Doc/faq/design.rst:874 +#: faq/design.rst:874 msgid "" "Allowing the trailing comma may also make programmatic code generation " "easier." msgstr "" -#: ../src/Doc/faq/extending.rst:3 +#: faq/extending.rst:3 msgid "Extending/Embedding FAQ" msgstr "" -#: ../src/Doc/faq/extending.rst:13 +#: faq/extending.rst:13 msgid "Can I create my own functions in C?" msgstr "" -#: ../src/Doc/faq/extending.rst:15 +#: faq/extending.rst:15 msgid "" "Yes, you can create built-in modules containing functions, variables, " "exceptions and even new types in C. This is explained in the document :ref:" "`extending-index`." msgstr "" -#: ../src/Doc/faq/extending.rst:19 +#: faq/extending.rst:19 msgid "Most intermediate or advanced Python books will also cover this topic." msgstr "" -#: ../src/Doc/faq/extending.rst:23 +#: faq/extending.rst:23 msgid "Can I create my own functions in C++?" msgstr "" -#: ../src/Doc/faq/extending.rst:25 +#: faq/extending.rst:25 msgid "" "Yes, using the C compatibility features found in C++. Place ``extern \"C" "\" { ... }`` around the Python include files and put ``extern \"C\"`` before " @@ -1321,17 +1321,17 @@ msgid "" "or static C++ objects with constructors are probably not a good idea." msgstr "" -#: ../src/Doc/faq/extending.rst:34 +#: faq/extending.rst:34 msgid "Writing C is hard; are there any alternatives?" msgstr "" -#: ../src/Doc/faq/extending.rst:36 +#: faq/extending.rst:36 msgid "" "There are a number of alternatives to writing your own C extensions, " "depending on what you're trying to do." msgstr "" -#: ../src/Doc/faq/extending.rst:41 +#: faq/extending.rst:41 msgid "" "If you need more speed, `Psyco `_ generates " "x86 assembly code from Python bytecode. You can use Psyco to compile the " @@ -1341,7 +1341,7 @@ msgid "" msgstr "" # c2b7327575d34876a1809d21e31d12cb -#: ../src/Doc/faq/extending.rst:47 +#: faq/extending.rst:47 msgid "" "`Cython `_ and its relative `Pyrex `_ are compilers that accept a " @@ -1351,7 +1351,7 @@ msgid "" msgstr "" # f8a33d9aaba344ff97b0da6af3125b8f -#: ../src/Doc/faq/extending.rst:53 +#: faq/extending.rst:53 msgid "" "If you need to interface to some C or C++ library for which no Python " "extension currently exists, you can try wrapping the library's data types " @@ -1362,12 +1362,12 @@ msgid "" "weave.html>`_ are also alternatives for wrapping C++ libraries." msgstr "" -#: ../src/Doc/faq/extending.rst:64 +#: faq/extending.rst:64 msgid "How can I execute arbitrary Python statements from C?" msgstr "" # 18b0e3c64e884142b76368d196969d3d -#: ../src/Doc/faq/extending.rst:66 +#: faq/extending.rst:66 msgid "" "The highest-level function to do this is :c:func:`PyRun_SimpleString` which " "takes a single string argument to be executed in the context of the module " @@ -1377,24 +1377,24 @@ msgid "" "pythonrun.c``." msgstr "" -#: ../src/Doc/faq/extending.rst:75 +#: faq/extending.rst:75 msgid "How can I evaluate an arbitrary Python expression from C?" msgstr "" # 4da2349aa63d4260a91f85be17bc553d -#: ../src/Doc/faq/extending.rst:77 +#: faq/extending.rst:77 msgid "" "Call the function :c:func:`PyRun_String` from the previous question with the " "start symbol :c:data:`Py_eval_input`; it parses an expression, evaluates it " "and returns its value." msgstr "" -#: ../src/Doc/faq/extending.rst:83 +#: faq/extending.rst:83 msgid "How do I extract C values from a Python object?" msgstr "" # bf6d1f0de5d5498cb6d9c72ec2c0f291 -#: ../src/Doc/faq/extending.rst:85 +#: faq/extending.rst:85 msgid "" "That depends on the object's type. If it's a tuple, :c:func:`PyTuple_Size` " "returns its length and :c:func:`PyTuple_GetItem` returns the item at a " @@ -1403,7 +1403,7 @@ msgid "" msgstr "" # 6111c83f34a944b299dc2b7f938f8f58 -#: ../src/Doc/faq/extending.rst:90 +#: faq/extending.rst:90 msgid "" "For strings, :c:func:`PyString_Size` returns its length and :c:func:" "`PyString_AsString` a pointer to its value. Note that Python strings may " @@ -1411,7 +1411,7 @@ msgid "" msgstr "" # efea875e83da494da9c6994eb907bd06 -#: ../src/Doc/faq/extending.rst:94 +#: faq/extending.rst:94 msgid "" "To test the type of an object, first make sure it isn't *NULL*, and then " "use :c:func:`PyString_Check`, :c:func:`PyTuple_Check`, :c:func:" @@ -1419,7 +1419,7 @@ msgid "" msgstr "" # d68f7b2e96c84902a81aca0e5e3c0623 -#: ../src/Doc/faq/extending.rst:97 +#: faq/extending.rst:97 msgid "" "There is also a high-level API to Python objects which is provided by the so-" "called 'abstract' interface -- read ``Include/abstract.h`` for further " @@ -1428,12 +1428,12 @@ msgid "" "well as many other useful protocols." msgstr "" -#: ../src/Doc/faq/extending.rst:105 +#: faq/extending.rst:105 msgid "How do I use Py_BuildValue() to create a tuple of arbitrary length?" msgstr "" # 65e3b87a7f9244f69b0940a5c95ed4c9 -#: ../src/Doc/faq/extending.rst:107 +#: faq/extending.rst:107 msgid "" "You can't. Use ``t = PyTuple_New(n)`` instead, and fill it with objects " "using ``PyTuple_SetItem(t, i, o)`` -- note that this \"eats\" a reference " @@ -1444,12 +1444,12 @@ msgid "" "valid Python value." msgstr "" -#: ../src/Doc/faq/extending.rst:116 +#: faq/extending.rst:116 msgid "How do I call an object's method from C?" msgstr "" # df0a0e00b90e4282a8bea227ff1b10ca -#: ../src/Doc/faq/extending.rst:118 +#: faq/extending.rst:118 msgid "" "The :c:func:`PyObject_CallMethod` function can be used to call an arbitrary " "method of an object. The parameters are the object, the name of the method " @@ -1458,21 +1458,21 @@ msgid "" msgstr "" # b219b7268bfc44069c09cf32040d168d -#: ../src/Doc/faq/extending.rst:127 +#: faq/extending.rst:127 msgid "" "This works for any object that has methods -- whether built-in or user-" "defined. You are responsible for eventually :c:func:`Py_DECREF`\\ 'ing the " "return value." msgstr "" -#: ../src/Doc/faq/extending.rst:130 +#: faq/extending.rst:130 msgid "" "To call, e.g., a file object's \"seek\" method with arguments 10, 0 " "(assuming the file object pointer is \"f\")::" msgstr "" # 45739a85a41845659ac0d8e44d22aab8 -#: ../src/Doc/faq/extending.rst:141 +#: faq/extending.rst:141 msgid "" "Note that since :c:func:`PyObject_CallObject` *always* wants a tuple for the " "argument list, to call a function without arguments, pass \"()\" for the " @@ -1480,13 +1480,13 @@ msgid "" "parentheses, e.g. \"(i)\"." msgstr "" -#: ../src/Doc/faq/extending.rst:148 +#: faq/extending.rst:148 msgid "" "How do I catch the output from PyErr_Print() (or anything that prints to " "stdout/stderr)?" msgstr "" -#: ../src/Doc/faq/extending.rst:150 +#: faq/extending.rst:150 msgid "" "In Python code, define an object that supports the ``write()`` method. " "Assign this object to :data:`sys.stdout` and :data:`sys.stderr`. Call " @@ -1494,25 +1494,25 @@ msgid "" "the output will go wherever your ``write()`` method sends it." msgstr "" -#: ../src/Doc/faq/extending.rst:155 +#: faq/extending.rst:155 msgid "" "The easiest way to do this is to use the StringIO class in the standard " "library." msgstr "" -#: ../src/Doc/faq/extending.rst:157 +#: faq/extending.rst:157 msgid "Sample code and use for catching stdout:" msgstr "" -#: ../src/Doc/faq/extending.rst:175 +#: faq/extending.rst:175 msgid "How do I access a module written in Python from C?" msgstr "" -#: ../src/Doc/faq/extending.rst:177 +#: faq/extending.rst:177 msgid "You can get a pointer to the module object as follows::" msgstr "" -#: ../src/Doc/faq/extending.rst:181 +#: faq/extending.rst:181 msgid "" "If the module hasn't been imported yet (i.e. it is not yet present in :data:" "`sys.modules`), this initializes the module; otherwise it simply returns the " @@ -1521,24 +1521,24 @@ msgid "" "stored in :data:`sys.modules`." msgstr "" -#: ../src/Doc/faq/extending.rst:187 +#: faq/extending.rst:187 msgid "" "You can then access the module's attributes (i.e. any name defined in the " "module) as follows::" msgstr "" # 646b1887089947edac480d122919c21a -#: ../src/Doc/faq/extending.rst:192 +#: faq/extending.rst:192 msgid "" "Calling :c:func:`PyObject_SetAttrString` to assign to variables in the " "module also works." msgstr "" -#: ../src/Doc/faq/extending.rst:197 +#: faq/extending.rst:197 msgid "How do I interface to C++ objects from Python?" msgstr "" -#: ../src/Doc/faq/extending.rst:199 +#: faq/extending.rst:199 msgid "" "Depending on your requirements, there are many approaches. To do this " "manually, begin by reading :ref:`the \"Extending and Embedding\" document " @@ -1549,87 +1549,87 @@ msgid "" msgstr "" # 79545e2b1466479284f3c186af5c4e7a -#: ../src/Doc/faq/extending.rst:205 +#: faq/extending.rst:205 msgid "For C++ libraries, see :ref:`c-wrapper-software`." msgstr "" -#: ../src/Doc/faq/extending.rst:209 +#: faq/extending.rst:209 msgid "I added a module using the Setup file and the make fails; why?" msgstr "" -#: ../src/Doc/faq/extending.rst:211 +#: faq/extending.rst:211 msgid "" "Setup must end in a newline, if there is no newline there, the build process " "fails. (Fixing this requires some ugly shell script hackery, and this bug " "is so minor that it doesn't seem worth the effort.)" msgstr "" -#: ../src/Doc/faq/extending.rst:217 +#: faq/extending.rst:217 msgid "How do I debug an extension?" msgstr "" -#: ../src/Doc/faq/extending.rst:219 +#: faq/extending.rst:219 msgid "" "When using GDB with dynamically loaded extensions, you can't set a " "breakpoint in your extension until your extension is loaded." msgstr "" -#: ../src/Doc/faq/extending.rst:222 +#: faq/extending.rst:222 msgid "In your ``.gdbinit`` file (or interactively), add the command::" msgstr "" -#: ../src/Doc/faq/extending.rst:226 +#: faq/extending.rst:226 msgid "Then, when you run GDB::" msgstr "" -#: ../src/Doc/faq/extending.rst:236 +#: faq/extending.rst:236 msgid "" "I want to compile a Python module on my Linux system, but some files are " "missing. Why?" msgstr "" -#: ../src/Doc/faq/extending.rst:238 +#: faq/extending.rst:238 msgid "" "Most packaged versions of Python don't include the :file:`/usr/lib/python2." "{x}/config/` directory, which contains various files required for compiling " "Python extensions." msgstr "" -#: ../src/Doc/faq/extending.rst:242 +#: faq/extending.rst:242 msgid "For Red Hat, install the python-devel RPM to get the necessary files." msgstr "" -#: ../src/Doc/faq/extending.rst:244 +#: faq/extending.rst:244 msgid "For Debian, run ``apt-get install python-dev``." msgstr "" -#: ../src/Doc/faq/extending.rst:248 +#: faq/extending.rst:248 msgid "" "What does \"SystemError: _PyImport_FixupExtension: module yourmodule not " "loaded\" mean?" msgstr "" -#: ../src/Doc/faq/extending.rst:250 +#: faq/extending.rst:250 msgid "" "This means that you have created an extension module named \"yourmodule\", " "but your module init function does not initialize with that name." msgstr "" -#: ../src/Doc/faq/extending.rst:253 +#: faq/extending.rst:253 msgid "Every module init function will have a line similar to::" msgstr "" -#: ../src/Doc/faq/extending.rst:257 +#: faq/extending.rst:257 msgid "" "If the string passed to this function is not the same name as your extension " "module, the :exc:`SystemError` exception will be raised." msgstr "" -#: ../src/Doc/faq/extending.rst:262 +#: faq/extending.rst:262 msgid "How do I tell \"incomplete input\" from \"invalid input\"?" msgstr "" -#: ../src/Doc/faq/extending.rst:264 +#: faq/extending.rst:264 msgid "" "Sometimes you want to emulate the Python interactive interpreter's behavior, " "where it gives you a continuation prompt when the input is incomplete (e.g. " @@ -1638,14 +1638,14 @@ msgid "" "message immediately when the input is invalid." msgstr "" -#: ../src/Doc/faq/extending.rst:270 +#: faq/extending.rst:270 msgid "" "In Python you can use the :mod:`codeop` module, which approximates the " "parser's behavior sufficiently. IDLE uses this, for example." msgstr "" # 19a4a0d28eec4133a082ff7797453944 -#: ../src/Doc/faq/extending.rst:273 +#: faq/extending.rst:273 msgid "" "The easiest way to do it in C is to call :c:func:`PyRun_InteractiveLoop` " "(perhaps in a separate thread) and let the Python interpreter handle the " @@ -1655,7 +1655,7 @@ msgid "" msgstr "" # 77f9464418f243e29c3907a9a12ab26a -#: ../src/Doc/faq/extending.rst:279 +#: faq/extending.rst:279 msgid "" "However sometimes you have to run the embedded Python interpreter in the " "same thread as your rest application and you can't allow the :c:func:" @@ -1666,7 +1666,7 @@ msgid "" msgstr "" # 2c15d7c7e14a406d9987caf0f7289897 -#: ../src/Doc/faq/extending.rst:312 +#: faq/extending.rst:312 msgid "" "Another solution is trying to compile the received string with :c:func:" "`Py_CompileString`. If it compiles without errors, try to execute the " @@ -1678,42 +1678,42 @@ msgid "" "to ignore **SIGINT** while calling readline())::" msgstr "" -#: ../src/Doc/faq/extending.rst:433 +#: faq/extending.rst:433 msgid "How do I find undefined g++ symbols __builtin_new or __pure_virtual?" msgstr "" -#: ../src/Doc/faq/extending.rst:435 +#: faq/extending.rst:435 msgid "" "To dynamically load g++ extension modules, you must recompile Python, relink " "it using g++ (change LINKCC in the Python Modules Makefile), and link your " "extension module using g++ (e.g., ``g++ -shared -o mymodule.so mymodule.o``)." msgstr "" -#: ../src/Doc/faq/extending.rst:441 +#: faq/extending.rst:441 msgid "" "Can I create an object class with some methods implemented in C and others " "in Python (e.g. through inheritance)?" msgstr "" -#: ../src/Doc/faq/extending.rst:443 +#: faq/extending.rst:443 msgid "" -"In Python 2.2, you can inherit from built-in classes such as :class:`int`, :" -"class:`list`, :class:`dict`, etc." +"Yes, you can inherit from built-in classes such as :class:`int`, :class:" +"`list`, :class:`dict`, etc." msgstr "" -#: ../src/Doc/faq/extending.rst:446 +#: faq/extending.rst:446 msgid "" "The Boost Python Library (BPL, http://www.boost.org/libs/python/doc/index." "html) provides a way of doing this from C++ (i.e. you can inherit from an " "extension class written in C++ using the BPL)." msgstr "" -#: ../src/Doc/faq/extending.rst:452 +#: faq/extending.rst:452 msgid "" "When importing module X, why do I get \"undefined symbol: PyUnicodeUCS2*\"?" msgstr "" -#: ../src/Doc/faq/extending.rst:454 +#: faq/extending.rst:454 msgid "" "You are using a version of Python that uses a 4-byte representation for " "Unicode characters, but some C extension module you are importing was " @@ -1721,7 +1721,7 @@ msgid "" "characters (the default)." msgstr "" -#: ../src/Doc/faq/extending.rst:458 +#: faq/extending.rst:458 msgid "" "If instead the name of the undefined symbol starts with ``PyUnicodeUCS4``, " "the problem is the reverse: Python was built using 2-byte Unicode " @@ -1730,7 +1730,7 @@ msgid "" msgstr "" # 886cf89f005a426da807866a9f4743bd -#: ../src/Doc/faq/extending.rst:462 +#: faq/extending.rst:462 msgid "" "This can easily occur when using pre-built extension packages. RedHat Linux " "7.x, in particular, provided a \"python2\" binary that is compiled with 4-" @@ -1741,31 +1741,31 @@ msgid "" "`PyArg_ParseTuple`." msgstr "" -#: ../src/Doc/faq/extending.rst:469 +#: faq/extending.rst:469 msgid "" "You can check the size of the Unicode character a Python interpreter is " "using by checking the value of sys.maxunicode:" msgstr "" -#: ../src/Doc/faq/extending.rst:478 +#: faq/extending.rst:478 msgid "" "The only way to solve this problem is to use extension modules compiled with " "a Python binary built using the same size for Unicode characters." msgstr "" -#: ../src/Doc/faq/general.rst:5 +#: faq/general.rst:5 msgid "General Python FAQ" msgstr "" -#: ../src/Doc/faq/general.rst:13 +#: faq/general.rst:13 msgid "General Information" msgstr "" -#: ../src/Doc/faq/general.rst:16 ../src/Doc/faq/installed.rst:6 +#: faq/general.rst:16 faq/installed.rst:6 msgid "What is Python?" msgstr "" -#: ../src/Doc/faq/general.rst:18 +#: faq/general.rst:18 msgid "" "Python is an interpreted, interactive, object-oriented programming " "language. It incorporates modules, exceptions, dynamic typing, very high " @@ -1778,19 +1778,19 @@ msgid "" msgstr "" # 63e8e9a6b18f4b9db21bd43a83364a82 -#: ../src/Doc/faq/general.rst:27 +#: faq/general.rst:27 msgid "" "To find out more, start with :ref:`tutorial-index`. The `Beginner's Guide " "to Python `_ links to other " "introductory tutorials and resources for learning Python." msgstr "" -#: ../src/Doc/faq/general.rst:33 +#: faq/general.rst:33 msgid "What is the Python Software Foundation?" msgstr "" # ec2ca6254b3946ba877cf79f65551b32 -#: ../src/Doc/faq/general.rst:35 +#: faq/general.rst:35 msgid "" "The Python Software Foundation is an independent non-profit organization " "that holds the copyright on Python versions 2.1 and newer. The PSF's " @@ -1800,18 +1800,18 @@ msgid "" msgstr "" # 18003a9ceee54963bce2fbdbdebf0117 -#: ../src/Doc/faq/general.rst:41 +#: faq/general.rst:41 msgid "" "Donations to the PSF are tax-exempt in the US. If you use Python and find " "it helpful, please contribute via `the PSF donation page `_." msgstr "" -#: ../src/Doc/faq/general.rst:47 +#: faq/general.rst:47 msgid "Are there copyright restrictions on the use of Python?" msgstr "" -#: ../src/Doc/faq/general.rst:49 +#: faq/general.rst:49 msgid "" "You can do anything you want with the source, as long as you leave the " "copyrights in and display those copyrights in any documentation about Python " @@ -1822,32 +1822,31 @@ msgid "" "of course." msgstr "" -# ab79876ebb054c1987be6f2e64c52aa1 -#: ../src/Doc/faq/general.rst:56 +#: faq/general.rst:56 msgid "" -"See `the PSF license page `_ to find " +"See `the PSF license page `_ to find " "further explanations and a link to the full text of the license." msgstr "" # 4ef579790a7041738f2cb822de158058 -#: ../src/Doc/faq/general.rst:59 +#: faq/general.rst:59 msgid "" "The Python logo is trademarked, and in certain cases permission is required " "to use it. Consult `the Trademark Usage Policy `__ for more information." msgstr "" -#: ../src/Doc/faq/general.rst:65 +#: faq/general.rst:65 msgid "Why was Python created in the first place?" msgstr "" -#: ../src/Doc/faq/general.rst:67 +#: faq/general.rst:67 msgid "" "Here's a *very* brief summary of what started it all, written by Guido van " "Rossum:" msgstr "" -#: ../src/Doc/faq/general.rst:70 +#: faq/general.rst:70 msgid "" "I had extensive experience with implementing an interpreted language in the " "ABC group at CWI, and from working with this group I had learned a lot about " @@ -1856,7 +1855,7 @@ msgid "" "level data types (although the details are all different in Python)." msgstr "" -#: ../src/Doc/faq/general.rst:77 +#: faq/general.rst:77 msgid "" "I had a number of gripes about the ABC language, but also liked many of its " "features. It was impossible to extend the ABC language (or its " @@ -1867,7 +1866,7 @@ msgid "" "some other Python features." msgstr "" -#: ../src/Doc/faq/general.rst:85 +#: faq/general.rst:85 msgid "" "I was working in the Amoeba distributed operating system group at CWI. We " "needed a better way to do system administration than by writing either C " @@ -1877,7 +1876,7 @@ msgid "" "importance of exceptions as a programming language feature." msgstr "" -#: ../src/Doc/faq/general.rst:92 +#: faq/general.rst:92 msgid "" "It occurred to me that a scripting language with a syntax like ABC but with " "access to the Amoeba system calls would fill the need. I realized that it " @@ -1885,7 +1884,7 @@ msgid "" "needed a language that was generally extensible." msgstr "" -#: ../src/Doc/faq/general.rst:97 +#: faq/general.rst:97 msgid "" "During the 1989 Christmas holidays, I had a lot of time on my hand, so I " "decided to give it a try. During the next year, while still mostly working " @@ -1894,24 +1893,24 @@ msgid "" "improvements." msgstr "" -#: ../src/Doc/faq/general.rst:103 +#: faq/general.rst:103 msgid "" "In February 1991, after just over a year of development, I decided to post " "to USENET. The rest is in the ``Misc/HISTORY`` file." msgstr "" -#: ../src/Doc/faq/general.rst:108 +#: faq/general.rst:108 msgid "What is Python good for?" msgstr "" -#: ../src/Doc/faq/general.rst:110 +#: faq/general.rst:110 msgid "" "Python is a high-level general-purpose programming language that can be " "applied to many different classes of problems." msgstr "" # 32939d2b72fc4bb4a6b00b85cb83e68a -#: ../src/Doc/faq/general.rst:113 +#: faq/general.rst:113 msgid "" "The language comes with a large standard library that covers areas such as " "string processing (regular expressions, Unicode, calculating differences " @@ -1924,11 +1923,11 @@ msgid "" "`_ to find packages of interest to you." msgstr "" -#: ../src/Doc/faq/general.rst:125 +#: faq/general.rst:125 msgid "How does the Python version numbering scheme work?" msgstr "" -#: ../src/Doc/faq/general.rst:127 +#: faq/general.rst:127 msgid "" "Python versions are numbered A.B.C or A.B. A is the major version number -- " "it is only incremented for really major changes in the language. B is the " @@ -1937,7 +1936,7 @@ msgid "" "for more information about bugfix releases." msgstr "" -#: ../src/Doc/faq/general.rst:133 +#: faq/general.rst:133 msgid "" "Not all releases are bugfix releases. In the run-up to a new major release, " "a series of development releases are made, denoted as alpha, beta, or " @@ -1948,7 +1947,7 @@ msgid "" "except as needed to fix critical bugs." msgstr "" -#: ../src/Doc/faq/general.rst:141 +#: faq/general.rst:141 msgid "" "Alpha, beta and release candidate versions have an additional suffix. The " "suffix for an alpha version is \"aN\" for some small number N, the suffix " @@ -1958,7 +1957,7 @@ msgid "" "precede versions labeled 2.0cN, and *those* precede 2.0." msgstr "" -#: ../src/Doc/faq/general.rst:148 +#: faq/general.rst:148 msgid "" "You may also find version numbers with a \"+\" suffix, e.g. \"2.2+\". These " "are unreleased versions, built directly from the Subversion trunk. In " @@ -1967,25 +1966,25 @@ msgid "" "g. \"2.4a0\"." msgstr "" -#: ../src/Doc/faq/general.rst:154 +#: faq/general.rst:154 msgid "" -"See also the documentation for ``sys.version``, ``sys.hexversion``, and " -"``sys.version_info``." +"See also the documentation for :data:`sys.version`, :data:`sys.hexversion`, " +"and :data:`sys.version_info`." msgstr "" -#: ../src/Doc/faq/general.rst:159 +#: faq/general.rst:159 msgid "How do I obtain a copy of the Python source?" msgstr "" # 8244dbe42fc049a0ab12d53e5d9c254c -#: ../src/Doc/faq/general.rst:161 +#: faq/general.rst:161 msgid "" "The latest Python source distribution is always available from python.org, " "at https://www.python.org/download/. The latest development sources can be " "obtained via anonymous Mercurial access at https://hg.python.org/cpython." msgstr "" -#: ../src/Doc/faq/general.rst:165 +#: faq/general.rst:165 msgid "" "The source distribution is a gzipped tar file containing the complete C " "source, Sphinx-formatted documentation, Python library modules, example " @@ -1994,19 +1993,19 @@ msgid "" msgstr "" # 20df971777764e7b86d2945158f49983 -#: ../src/Doc/faq/general.rst:170 +#: faq/general.rst:170 msgid "" "Consult the `Getting Started section of the Python Developer's Guide " "`__ for more information on " "getting the source code and compiling it." msgstr "" -#: ../src/Doc/faq/general.rst:176 +#: faq/general.rst:176 msgid "How do I get documentation on Python?" msgstr "" # aabba0b407c94dbfbdee69fe5d724e98 -#: ../src/Doc/faq/general.rst:180 +#: faq/general.rst:180 msgid "" "The standard documentation for the current stable version of Python is " "available at https://docs.python.org/3/. PDF, plain text, and downloadable " @@ -2014,37 +2013,37 @@ msgid "" msgstr "" # 7ad68c3fd07643b89f4ddc9e8b2f19da -#: ../src/Doc/faq/general.rst:184 +#: faq/general.rst:184 msgid "" "The documentation is written in reStructuredText and processed by `the " "Sphinx documentation tool `__. The reStructuredText " "source for the documentation is part of the Python source distribution." msgstr "" -#: ../src/Doc/faq/general.rst:190 +#: faq/general.rst:190 msgid "I've never programmed before. Is there a Python tutorial?" msgstr "" -#: ../src/Doc/faq/general.rst:192 +#: faq/general.rst:192 msgid "" "There are numerous tutorials and books available. The standard " "documentation includes :ref:`tutorial-index`." msgstr "" # 9d362d25da7849299fb790b4cbada6ea -#: ../src/Doc/faq/general.rst:195 +#: faq/general.rst:195 msgid "" "Consult `the Beginner's Guide `_ to find information for beginning Python programmers, " "including lists of tutorials." msgstr "" -#: ../src/Doc/faq/general.rst:200 +#: faq/general.rst:200 msgid "Is there a newsgroup or mailing list devoted to Python?" msgstr "" # 69aa419ee8944e968f24d49782564a4c -#: ../src/Doc/faq/general.rst:202 +#: faq/general.rst:202 msgid "" "There is a newsgroup, :newsgroup:`comp.lang.python`, and a mailing list, " "`python-list `_. The " @@ -2055,7 +2054,7 @@ msgid "" msgstr "" # bd61630ca8134e02b7b48084e3bb82ef -#: ../src/Doc/faq/general.rst:209 +#: faq/general.rst:209 msgid "" "Announcements of new software releases and events can be found in comp.lang." "python.announce, a low-traffic moderated list that receives about five " @@ -2064,18 +2063,18 @@ msgid "" msgstr "" # efd356343245403bbf90a2e75a311b9d -#: ../src/Doc/faq/general.rst:214 +#: faq/general.rst:214 msgid "" "More info about other mailing lists and newsgroups can be found at https://" "www.python.org/community/lists/." msgstr "" -#: ../src/Doc/faq/general.rst:219 +#: faq/general.rst:219 msgid "How do I get a beta test version of Python?" msgstr "" # 88e49a54a28b4d23b72785e0822d2d5c -#: ../src/Doc/faq/general.rst:221 +#: faq/general.rst:221 msgid "" "Alpha and beta releases are available from https://www.python.org/" "download/. All releases are announced on the comp.lang.python and comp.lang." @@ -2084,25 +2083,25 @@ msgid "" msgstr "" # 3cb6d776ab10410695dcadb9175bd162 -#: ../src/Doc/faq/general.rst:226 +#: faq/general.rst:226 msgid "" "You can also access the development version of Python through Mercurial. " "See https://docs.python.org/devguide/faq.html for details." msgstr "" -#: ../src/Doc/faq/general.rst:231 +#: faq/general.rst:231 msgid "How do I submit bug reports and patches for Python?" msgstr "" # ed60ae55f0674edb86d3e460cd36c7c0 -#: ../src/Doc/faq/general.rst:233 +#: faq/general.rst:233 msgid "" "To report a bug or submit a patch, please use the Roundup installation at " "https://bugs.python.org/." msgstr "" # 5c0e33af23cd453eb13c61e0024c5ccf -#: ../src/Doc/faq/general.rst:236 +#: faq/general.rst:236 msgid "" "You must have a Roundup account to report bugs; this makes it possible for " "us to contact you if we have follow-up questions. It will also enable " @@ -2113,56 +2112,56 @@ msgid "" msgstr "" # e087c76f6e88484bae2328bbb47d563f -#: ../src/Doc/faq/general.rst:242 +#: faq/general.rst:242 msgid "" "For more information on how Python is developed, consult `the Python " "Developer's Guide `_." msgstr "" -#: ../src/Doc/faq/general.rst:247 +#: faq/general.rst:247 msgid "Are there any published articles about Python that I can reference?" msgstr "" -#: ../src/Doc/faq/general.rst:249 +#: faq/general.rst:249 msgid "It's probably best to cite your favorite book about Python." msgstr "" -#: ../src/Doc/faq/general.rst:251 +#: faq/general.rst:251 msgid "" "The very first article about Python was written in 1991 and is now quite " "outdated." msgstr "" -#: ../src/Doc/faq/general.rst:254 +#: faq/general.rst:254 msgid "" "Guido van Rossum and Jelke de Boer, \"Interactively Testing Remote Servers " "Using the Python Programming Language\", CWI Quarterly, Volume 4, Issue 4 " "(December 1991), Amsterdam, pp 283-303." msgstr "" -#: ../src/Doc/faq/general.rst:260 +#: faq/general.rst:260 msgid "Are there any books on Python?" msgstr "" # d98bb043ee1a430e86dd7fbf76516b2b -#: ../src/Doc/faq/general.rst:262 +#: faq/general.rst:262 msgid "" "Yes, there are many, and more are being published. See the python.org wiki " "at https://wiki.python.org/moin/PythonBooks for a list." msgstr "" -#: ../src/Doc/faq/general.rst:265 +#: faq/general.rst:265 msgid "" "You can also search online bookstores for \"Python\" and filter out the " "Monty Python references; or perhaps search for \"Python\" and \"language\"." msgstr "" -#: ../src/Doc/faq/general.rst:270 +#: faq/general.rst:270 msgid "Where in the world is www.python.org located?" msgstr "" # e7e802e7ba9340c5be665ea44fb2c1db -#: ../src/Doc/faq/general.rst:272 +#: faq/general.rst:272 msgid "" "The Python project's infrastructure is located all over the world. `www." "python.org `_ is graciously hosted by `Rackspace " @@ -2173,12 +2172,12 @@ msgid "" "State University Open Source Lab `_." msgstr "" -#: ../src/Doc/faq/general.rst:283 +#: faq/general.rst:283 msgid "Why is it called Python?" msgstr "" # 48f7399a35da4567b45a33f0aa99e468 -#: ../src/Doc/faq/general.rst:285 +#: faq/general.rst:285 msgid "" "When he began implementing Python, Guido van Rossum was also reading the " "published scripts from `\"Monty Python's Flying Circus\" `_. There are two recommended production-" @@ -2232,35 +2231,35 @@ msgid "" "in Python 3." msgstr "" -#: ../src/Doc/faq/general.rst:324 +#: faq/general.rst:324 msgid "How many people are using Python?" msgstr "" -#: ../src/Doc/faq/general.rst:326 +#: faq/general.rst:326 msgid "" "There are probably tens of thousands of users, though it's difficult to " "obtain an exact count." msgstr "" -#: ../src/Doc/faq/general.rst:329 +#: faq/general.rst:329 msgid "" "Python is available for free download, so there are no sales figures, and " "it's available from many different sites and packaged with many Linux " "distributions, so download statistics don't tell the whole story either." msgstr "" -#: ../src/Doc/faq/general.rst:333 +#: faq/general.rst:333 msgid "" "The comp.lang.python newsgroup is very active, but not all Python users post " "to the group or even read it." msgstr "" -#: ../src/Doc/faq/general.rst:338 +#: faq/general.rst:338 msgid "Have any significant projects been done in Python?" msgstr "" # 01bba32172234741a35c9e66d0a2d7a7 -#: ../src/Doc/faq/general.rst:340 +#: faq/general.rst:340 msgid "" "See https://www.python.org/about/success for a list of projects that use " "Python. Consulting the proceedings for `past Python conferences `_ and `the Zope application server `_." msgstr "" -#: ../src/Doc/faq/general.rst:367 +#: faq/general.rst:367 msgid "Is it reasonable to propose incompatible changes to Python?" msgstr "" -#: ../src/Doc/faq/general.rst:369 +#: faq/general.rst:369 msgid "" "In general, no. There are already millions of lines of Python code around " "the world, so any change in the language that invalidates more than a very " @@ -2313,23 +2312,23 @@ msgid "" "to invalidate them all at a single stroke." msgstr "" -#: ../src/Doc/faq/general.rst:376 +#: faq/general.rst:376 msgid "" "Providing a gradual upgrade path is necessary if a feature has to be " "changed. :pep:`5` describes the procedure followed for introducing backward-" "incompatible changes while minimizing disruption for users." msgstr "" -#: ../src/Doc/faq/general.rst:382 +#: faq/general.rst:382 msgid "Is Python a good language for beginning programmers?" msgstr "" -#: ../src/Doc/faq/general.rst:384 ../src/Doc/faq/library.rst:764 -#: ../src/Doc/faq/programming.rst:17 ../src/Doc/faq/programming.rst:60 +#: faq/general.rst:384 faq/library.rst:764 faq/programming.rst:17 +#: faq/programming.rst:60 msgid "Yes." msgstr "" -#: ../src/Doc/faq/general.rst:386 +#: faq/general.rst:386 msgid "" "It is still common to start students with a procedural and statically typed " "language such as Pascal, C, or a subset of C++ or Java. Students may be " @@ -2342,7 +2341,7 @@ msgid "" "with user-defined objects in their very first course." msgstr "" -#: ../src/Doc/faq/general.rst:396 +#: faq/general.rst:396 msgid "" "For a student who has never programmed before, using a statically typed " "language seems unnatural. It presents additional complexity that the " @@ -2354,7 +2353,7 @@ msgid "" "course." msgstr "" -#: ../src/Doc/faq/general.rst:404 +#: faq/general.rst:404 msgid "" "Many other aspects of Python make it a good first language. Like Java, " "Python has a large standard library so that students can be assigned " @@ -2367,7 +2366,7 @@ msgid "" "helpful in extending the students' reach." msgstr "" -#: ../src/Doc/faq/general.rst:413 +#: faq/general.rst:413 msgid "" "Python's interactive interpreter enables students to test language features " "while they're programming. They can keep a window with the interpreter " @@ -2375,14 +2374,14 @@ msgid "" "can't remember the methods for a list, they can do something like this::" msgstr "" -#: ../src/Doc/faq/general.rst:439 +#: faq/general.rst:439 msgid "" "With the interpreter, documentation is never far from the student as he's " "programming." msgstr "" # f94af7923ed745f58ebf8abde3518df3 -#: ../src/Doc/faq/general.rst:442 +#: faq/general.rst:442 msgid "" "There are also good IDEs for Python. IDLE is a cross-platform IDE for " "Python that is written in Python using Tkinter. PythonWin is a Windows-" @@ -2394,22 +2393,22 @@ msgid "" msgstr "" # 15764eb4a94e46bfa76e857e01d5e9e5 -#: ../src/Doc/faq/general.rst:450 +#: faq/general.rst:450 msgid "" "If you want to discuss Python's use in education, you may be interested in " "joining `the edu-sig mailing list `_." msgstr "" -#: ../src/Doc/faq/general.rst:456 +#: faq/general.rst:456 msgid "Upgrading Python" msgstr "" -#: ../src/Doc/faq/general.rst:459 +#: faq/general.rst:459 msgid "What is this bsddb185 module my application keeps complaining about?" msgstr "" -#: ../src/Doc/faq/general.rst:463 +#: faq/general.rst:463 msgid "" "Starting with Python2.3, the distribution includes the `PyBSDDB package " "` as a replacement for the old bsddb module. It " @@ -2419,7 +2418,7 @@ msgid "" "be opened directly using the new module." msgstr "" -#: ../src/Doc/faq/general.rst:470 +#: faq/general.rst:470 msgid "" "Using your old version of Python and a pair of scripts which are part of " "Python 2.3 (db2pickle.py and pickle2db.py, in the Tools/scripts directory) " @@ -2427,39 +2426,39 @@ msgid "" "Python version, run the db2pickle.py script to convert it to a pickle, e.g.::" msgstr "" -#: ../src/Doc/faq/general.rst:477 +#: faq/general.rst:477 msgid "Rename your database file::" msgstr "" -#: ../src/Doc/faq/general.rst:481 +#: faq/general.rst:481 msgid "Now convert the pickle file to a new format database::" msgstr "" -#: ../src/Doc/faq/general.rst:485 +#: faq/general.rst:485 msgid "" "The precise commands you use will vary depending on the particulars of your " "installation. For full details about operation of these two scripts check " "the doc string at the start of each one." msgstr "" -#: ../src/Doc/faq/gui.rst:5 +#: faq/gui.rst:5 msgid "Graphic User Interface FAQ" msgstr "" -#: ../src/Doc/faq/gui.rst:12 +#: faq/gui.rst:12 msgid "What platform-independent GUI toolkits exist for Python?" msgstr "" -#: ../src/Doc/faq/gui.rst:14 +#: faq/gui.rst:14 msgid "Depending on what platform(s) you are aiming at, there are several." msgstr "" -#: ../src/Doc/faq/gui.rst:19 +#: faq/gui.rst:19 msgid "Tkinter" msgstr "" # 69a9b8750ffc4acfb580f6a4a9dd3038 -#: ../src/Doc/faq/gui.rst:21 +#: faq/gui.rst:21 msgid "" "Standard builds of Python include an object-oriented interface to the Tcl/Tk " "widget set, called Tkinter. This is probably the easiest to install and " @@ -2468,12 +2467,12 @@ msgid "" "X, Windows, and Unix platforms." msgstr "" -#: ../src/Doc/faq/gui.rst:28 +#: faq/gui.rst:28 msgid "wxWidgets" msgstr "" # 954a564ac8da44b99a250d54e9dc373f -#: ../src/Doc/faq/gui.rst:30 +#: faq/gui.rst:30 msgid "" "wxWidgets (http://www.wxwidgets.org) is a free, portable GUI class library " "written in C++ that provides a native look and feel on a number of " @@ -2482,7 +2481,7 @@ msgid "" "including Python, Perl, Ruby, etc." msgstr "" -#: ../src/Doc/faq/gui.rst:36 +#: faq/gui.rst:36 msgid "" "wxPython (http://www.wxpython.org) is the Python binding for wxwidgets. " "While it often lags slightly behind the official wxWidgets releases, it also " @@ -2491,19 +2490,19 @@ msgid "" "developer community." msgstr "" -#: ../src/Doc/faq/gui.rst:42 +#: faq/gui.rst:42 msgid "" "Both wxWidgets and wxPython are free, open source, software with permissive " "licences that allow their use in commercial products as well as in freeware " "or shareware." msgstr "" -#: ../src/Doc/faq/gui.rst:48 +#: faq/gui.rst:48 msgid "Qt" msgstr "" # 2e5cdcfa960a4522b7ce1e4d3b0d2d6f -#: ../src/Doc/faq/gui.rst:50 +#: faq/gui.rst:50 msgid "" "There are bindings available for the Qt toolkit (using either `PyQt `_ or `PySide `_." msgstr "" -#: ../src/Doc/faq/gui.rst:61 +#: faq/gui.rst:61 msgid "Gtk+" msgstr "" -#: ../src/Doc/faq/gui.rst:63 +#: faq/gui.rst:63 msgid "" "PyGtk bindings for the `Gtk+ toolkit `_ have been " "implemented by James Henstridge; see ." msgstr "" -#: ../src/Doc/faq/gui.rst:67 +#: faq/gui.rst:67 msgid "FLTK" msgstr "" -#: ../src/Doc/faq/gui.rst:69 +#: faq/gui.rst:69 msgid "" "Python bindings for `the FLTK toolkit `_, a simple yet " "powerful and mature cross-platform windowing system, are available from `the " "PyFLTK project `_." msgstr "" -#: ../src/Doc/faq/gui.rst:75 +#: faq/gui.rst:75 msgid "FOX" msgstr "" -#: ../src/Doc/faq/gui.rst:77 +#: faq/gui.rst:77 msgid "" "A wrapper for `the FOX toolkit `_ called `FXpy " "`_ is available. FOX supports both Unix " "variants and Windows." msgstr "" -#: ../src/Doc/faq/gui.rst:83 +#: faq/gui.rst:83 msgid "OpenGL" msgstr "" -#: ../src/Doc/faq/gui.rst:85 +#: faq/gui.rst:85 msgid "For OpenGL bindings, see `PyOpenGL `_." msgstr "" -#: ../src/Doc/faq/gui.rst:89 +#: faq/gui.rst:89 msgid "What platform-specific GUI toolkits exist for Python?" msgstr "" # 7690fb7f0f05419fb4ae7082c765219c -#: ../src/Doc/faq/gui.rst:91 +#: faq/gui.rst:91 msgid "" "By installing the `PyObjc Objective-C bridge `_, Python programs can use Mac OS X's Cocoa libraries." msgstr "" -#: ../src/Doc/faq/gui.rst:95 +#: faq/gui.rst:95 msgid "" ":ref:`Pythonwin ` by Mark Hammond includes an interface to the " "Microsoft Foundation Classes and a Python programming environment that's " "written mostly in Python using the MFC classes." msgstr "" -#: ../src/Doc/faq/gui.rst:101 +#: faq/gui.rst:101 msgid "Tkinter questions" msgstr "" -#: ../src/Doc/faq/gui.rst:104 +#: faq/gui.rst:104 msgid "How do I freeze Tkinter applications?" msgstr "" -#: ../src/Doc/faq/gui.rst:106 +#: faq/gui.rst:106 msgid "" "Freeze is a tool to create stand-alone applications. When freezing Tkinter " "applications, the applications will not be truly stand-alone, as the " "application will still need the Tcl and Tk libraries." msgstr "" -#: ../src/Doc/faq/gui.rst:110 +#: faq/gui.rst:110 msgid "" "One solution is to ship the application with the Tcl and Tk libraries, and " "point to them at run-time using the :envvar:`TCL_LIBRARY` and :envvar:" "`TK_LIBRARY` environment variables." msgstr "" -#: ../src/Doc/faq/gui.rst:114 +#: faq/gui.rst:114 msgid "" "To get truly stand-alone applications, the Tcl scripts that form the library " "have to be integrated into the application as well. One tool supporting that " @@ -2610,60 +2609,38 @@ msgid "" msgstr "" # 305a161b8df040a5977ca7cfe21f949b -#: ../src/Doc/faq/gui.rst:119 +#: faq/gui.rst:119 msgid "" "Build Tix with SAM enabled, perform the appropriate call to :c:func:" "`Tclsam_init`, etc. inside Python's :file:`Modules/tkappinit.c`, and link " "with libtclsam and libtksam (you might include the Tix libraries as well)." msgstr "" -#: ../src/Doc/faq/gui.rst:126 +#: faq/gui.rst:126 msgid "Can I have Tk events handled while waiting for I/O?" msgstr "" -# 29d3a0c48fc8439492bc34338ead5dbd -#: ../src/Doc/faq/gui.rst:128 +#: faq/gui.rst:128 msgid "" -"Yes, and you don't even need threads! But you'll have to restructure your I/" -"O code a bit. Tk has the equivalent of Xt's :c:func:`XtAddInput()` call, " -"which allows you to register a callback function which will be called from " -"the Tk mainloop when I/O is possible on a file descriptor. Here's what you " -"need::" +"On platforms other than Windows, yes, and you don't even need threads! But " +"you'll have to restructure your I/O code a bit. Tk has the equivalent of " +"Xt's :c:func:`XtAddInput()` call, which allows you to register a callback " +"function which will be called from the Tk mainloop when I/O is possible on a " +"file descriptor. See :ref:`tkinter-file-handlers`." msgstr "" -#: ../src/Doc/faq/gui.rst:136 -msgid "" -"The file may be a Python file or socket object (actually, anything with a " -"fileno() method), or an integer file descriptor. The mask is one of the " -"constants tkinter.READABLE or tkinter.WRITABLE. The callback is called as " -"follows::" -msgstr "" - -#: ../src/Doc/faq/gui.rst:143 -msgid "You must unregister the callback when you're done, using ::" -msgstr "" - -#: ../src/Doc/faq/gui.rst:147 -msgid "" -"Note: since you don't know *how many bytes* are available for reading, you " -"can't use the Python file object's read or readline methods, since these " -"will insist on reading a predefined number of bytes. For sockets, the :meth:" -"`recv` or :meth:`recvfrom` methods will work fine; for other files, use ``os." -"read(file.fileno(), maxbytecount)``." -msgstr "" - -#: ../src/Doc/faq/gui.rst:155 +#: faq/gui.rst:136 msgid "I can't get key bindings to work in Tkinter: why?" msgstr "" -#: ../src/Doc/faq/gui.rst:157 +#: faq/gui.rst:138 msgid "" "An often-heard complaint is that event handlers bound to events with the :" "meth:`bind` method don't get handled even when the appropriate key is " "pressed." msgstr "" -#: ../src/Doc/faq/gui.rst:160 +#: faq/gui.rst:141 msgid "" "The most common cause is that the widget to which the binding applies " "doesn't have \"keyboard focus\". Check out the Tk documentation for the " @@ -2671,15 +2648,15 @@ msgid "" "it (but not for labels; see the takefocus option)." msgstr "" -#: ../src/Doc/faq/index.rst:5 +#: faq/index.rst:5 msgid "Python Frequently Asked Questions" msgstr "" -#: ../src/Doc/faq/installed.rst:3 +#: faq/installed.rst:3 msgid "\"Why is Python Installed on my Computer?\" FAQ" msgstr "" -#: ../src/Doc/faq/installed.rst:8 +#: faq/installed.rst:8 msgid "" "Python is a programming language. It's used for many different " "applications. It's used in some high schools and colleges as an introductory " @@ -2689,30 +2666,30 @@ msgid "" msgstr "" # 8402e288ce5b4bfcbc76e19a194c0919 -#: ../src/Doc/faq/installed.rst:13 +#: faq/installed.rst:13 msgid "" "If you wish to learn more about Python, start with the `Beginner's Guide to " "Python `_." msgstr "" -#: ../src/Doc/faq/installed.rst:18 +#: faq/installed.rst:18 msgid "Why is Python installed on my machine?" msgstr "" -#: ../src/Doc/faq/installed.rst:20 +#: faq/installed.rst:20 msgid "" "If you find Python installed on your system but don't remember installing " "it, there are several possible ways it could have gotten there." msgstr "" -#: ../src/Doc/faq/installed.rst:23 +#: faq/installed.rst:23 msgid "" "Perhaps another user on the computer wanted to learn programming and " "installed it; you'll have to figure out who's been using the machine and " "might have installed it." msgstr "" -#: ../src/Doc/faq/installed.rst:26 +#: faq/installed.rst:26 msgid "" "A third-party application installed on the machine might have been written " "in Python and included a Python installation. For a home computer, the most " @@ -2720,41 +2697,41 @@ msgid "" "solitaire game that includes over 1000 different games and variations." msgstr "" -#: ../src/Doc/faq/installed.rst:30 +#: faq/installed.rst:30 msgid "" "Some Windows machines also have Python installed. At this writing we're " "aware of computers from Hewlett-Packard and Compaq that include Python. " "Apparently some of HP/Compaq's administrative tools are written in Python." msgstr "" -#: ../src/Doc/faq/installed.rst:33 +#: faq/installed.rst:33 msgid "" "All Apple computers running Mac OS X have Python installed; it's included in " "the base installation." msgstr "" -#: ../src/Doc/faq/installed.rst:38 +#: faq/installed.rst:38 msgid "Can I delete Python?" msgstr "" -#: ../src/Doc/faq/installed.rst:40 +#: faq/installed.rst:40 msgid "That depends on where Python came from." msgstr "" -#: ../src/Doc/faq/installed.rst:42 +#: faq/installed.rst:42 msgid "" "If someone installed it deliberately, you can remove it without hurting " "anything. On Windows, use the Add/Remove Programs icon in the Control Panel." msgstr "" -#: ../src/Doc/faq/installed.rst:45 +#: faq/installed.rst:45 msgid "" "If Python was installed by a third-party application, you can also remove " "it, but that application will no longer work. You should use that " "application's uninstaller rather than removing Python directly." msgstr "" -#: ../src/Doc/faq/installed.rst:49 +#: faq/installed.rst:49 msgid "" "If Python came with your operating system, removing it is not recommended. " "If you remove it, whatever tools were written in Python will no longer run, " @@ -2762,20 +2739,20 @@ msgid "" "would then be required to fix things again." msgstr "" -#: ../src/Doc/faq/library.rst:5 +#: faq/library.rst:5 msgid "Library and Extension FAQ" msgstr "" -#: ../src/Doc/faq/library.rst:12 +#: faq/library.rst:12 msgid "General Library Questions" msgstr "" -#: ../src/Doc/faq/library.rst:15 +#: faq/library.rst:15 msgid "How do I find a module or application to perform task X?" msgstr "" # bc3737a59e9446b1aa99fa07fc18d033 -#: ../src/Doc/faq/library.rst:17 +#: faq/library.rst:17 msgid "" "Check :ref:`the Library Reference ` to see if there's a " "relevant standard library module. (Eventually you'll learn what's in the " @@ -2783,7 +2760,7 @@ msgid "" msgstr "" # 05aa2fcc1b844bd49c6b388e40f08923 -#: ../src/Doc/faq/library.rst:21 +#: faq/library.rst:21 msgid "" "For third-party packages, search the `Python Package Index `_ or try `Google `_ or another Web " @@ -2791,12 +2768,12 @@ msgid "" "topic of interest will usually find something helpful." msgstr "" -#: ../src/Doc/faq/library.rst:28 +#: faq/library.rst:28 msgid "Where is the math.py (socket.py, regex.py, etc.) source file?" msgstr "" # a85fce27be314446b1f02cbc9f6d5a3a -#: ../src/Doc/faq/library.rst:30 +#: faq/library.rst:30 msgid "" "If you can't find a source file for a module it may be a built-in or " "dynamically loaded module implemented in C, C++ or other compiled language. " @@ -2805,56 +2782,56 @@ msgid "" "Path)." msgstr "" -#: ../src/Doc/faq/library.rst:35 +#: faq/library.rst:35 msgid "There are (at least) three kinds of modules in Python:" msgstr "" -#: ../src/Doc/faq/library.rst:37 +#: faq/library.rst:37 msgid "modules written in Python (.py);" msgstr "" -#: ../src/Doc/faq/library.rst:38 +#: faq/library.rst:38 msgid "" "modules written in C and dynamically loaded (.dll, .pyd, .so, .sl, etc);" msgstr "" -#: ../src/Doc/faq/library.rst:39 +#: faq/library.rst:39 msgid "" "modules written in C and linked with the interpreter; to get a list of " "these, type::" msgstr "" -#: ../src/Doc/faq/library.rst:47 +#: faq/library.rst:47 msgid "How do I make a Python script executable on Unix?" msgstr "" -#: ../src/Doc/faq/library.rst:49 +#: faq/library.rst:49 msgid "" "You need to do two things: the script file's mode must be executable and the " "first line must begin with ``#!`` followed by the path of the Python " "interpreter." msgstr "" -#: ../src/Doc/faq/library.rst:53 +#: faq/library.rst:53 msgid "" "The first is done by executing ``chmod +x scriptfile`` or perhaps ``chmod " "755 scriptfile``." msgstr "" -#: ../src/Doc/faq/library.rst:56 +#: faq/library.rst:56 msgid "" "The second can be done in a number of ways. The most straightforward way is " "to write ::" msgstr "" -#: ../src/Doc/faq/library.rst:61 +#: faq/library.rst:61 msgid "" "as the very first line of your file, using the pathname for where the Python " "interpreter is installed on your platform." msgstr "" # 0a01ff692448441bb8c810e2376a53ec -#: ../src/Doc/faq/library.rst:64 +#: faq/library.rst:64 msgid "" "If you would like the script to be independent of where the Python " "interpreter lives, you can use the :program:`env` program. Almost all Unix " @@ -2863,7 +2840,7 @@ msgid "" msgstr "" # 5bb64238d1004d68afe1fc24428456e1 -#: ../src/Doc/faq/library.rst:71 +#: faq/library.rst:71 msgid "" "*Don't* do this for CGI scripts. The :envvar:`PATH` variable for CGI " "scripts is often very minimal, so you need to use the actual absolute " @@ -2871,25 +2848,25 @@ msgid "" msgstr "" # 11c70aaee9f04c3ab6268f31f16ca1a9 -#: ../src/Doc/faq/library.rst:75 +#: faq/library.rst:75 msgid "" "Occasionally, a user's environment is so full that the :program:`/usr/bin/" "env` program fails; or there's no env program at all. In that case, you can " "try the following hack (due to Alex Rezinsky)::" msgstr "" -#: ../src/Doc/faq/library.rst:84 +#: faq/library.rst:84 msgid "" "The minor disadvantage is that this defines the script's __doc__ string. " "However, you can fix that by adding ::" msgstr "" -#: ../src/Doc/faq/library.rst:92 +#: faq/library.rst:92 msgid "Is there a curses/termcap package for Python?" msgstr "" # f3b0852cce544578bf376fed21906a0b -#: ../src/Doc/faq/library.rst:96 +#: faq/library.rst:96 msgid "" "For Unix variants the standard Python source distribution comes with a " "curses module in the :source:`Modules` subdirectory, though it's not " @@ -2898,7 +2875,7 @@ msgid "" msgstr "" # aa5a87f13faa48da950fd7339da90add -#: ../src/Doc/faq/library.rst:101 +#: faq/library.rst:101 msgid "" "The :mod:`curses` module supports basic curses features as well as many " "additional functions from ncurses and SYSV curses such as colour, " @@ -2908,60 +2885,60 @@ msgid "" "category." msgstr "" -#: ../src/Doc/faq/library.rst:107 +#: faq/library.rst:107 msgid "" "For Windows: use `the consolelib module `_." msgstr "" -#: ../src/Doc/faq/library.rst:112 +#: faq/library.rst:112 msgid "Is there an equivalent to C's onexit() in Python?" msgstr "" # 5e5d2c69ded348f5a7e91e468c340bea -#: ../src/Doc/faq/library.rst:114 +#: faq/library.rst:114 msgid "" "The :mod:`atexit` module provides a register function that is similar to " "C's :c:func:`onexit`." msgstr "" -#: ../src/Doc/faq/library.rst:119 +#: faq/library.rst:119 msgid "Why don't my signal handlers work?" msgstr "" -#: ../src/Doc/faq/library.rst:121 +#: faq/library.rst:121 msgid "" "The most common problem is that the signal handler is declared with the " "wrong argument list. It is called as ::" msgstr "" -#: ../src/Doc/faq/library.rst:126 +#: faq/library.rst:126 msgid "so it should be declared with two arguments::" msgstr "" -#: ../src/Doc/faq/library.rst:133 +#: faq/library.rst:133 msgid "Common tasks" msgstr "" -#: ../src/Doc/faq/library.rst:136 +#: faq/library.rst:136 msgid "How do I test a Python program or component?" msgstr "" -#: ../src/Doc/faq/library.rst:138 +#: faq/library.rst:138 msgid "" "Python comes with two testing frameworks. The :mod:`doctest` module finds " "examples in the docstrings for a module and runs them, comparing the output " "with the expected output given in the docstring." msgstr "" -#: ../src/Doc/faq/library.rst:142 +#: faq/library.rst:142 msgid "" "The :mod:`unittest` module is a fancier testing framework modelled on Java " "and Smalltalk testing frameworks." msgstr "" # 4657b944660745599833f9be205984ef -#: ../src/Doc/faq/library.rst:145 +#: faq/library.rst:145 msgid "" "To make testing easier, you should use good modular design in your program. " "Your program should have almost all functionality encapsulated in either " @@ -2972,16 +2949,16 @@ msgid "" "more difficult to do." msgstr "" -#: ../src/Doc/faq/library.rst:153 +#: faq/library.rst:153 msgid "The \"global main logic\" of your program may be as simple as ::" msgstr "" -#: ../src/Doc/faq/library.rst:158 +#: faq/library.rst:158 msgid "at the bottom of the main module of your program." msgstr "" # 90221ca6b4024e4cbc6d229d3bc555d1 -#: ../src/Doc/faq/library.rst:160 +#: faq/library.rst:160 msgid "" "Once your program is organized as a tractable collection of functions and " "class behaviours you should write test functions that exercise the " @@ -2993,25 +2970,25 @@ msgid "" "design flaws earlier." msgstr "" -#: ../src/Doc/faq/library.rst:168 +#: faq/library.rst:168 msgid "" "\"Support modules\" that are not intended to be the main module of a program " "may include a self-test of the module. ::" msgstr "" -#: ../src/Doc/faq/library.rst:174 +#: faq/library.rst:174 msgid "" "Even programs that interact with complex external interfaces may be tested " "when the external interfaces are unavailable by using \"fake\" interfaces " "implemented in Python." msgstr "" -#: ../src/Doc/faq/library.rst:180 +#: faq/library.rst:180 msgid "How do I create documentation from doc strings?" msgstr "" # fad7f59855764b6b95785f1396abb188 -#: ../src/Doc/faq/library.rst:182 +#: faq/library.rst:182 msgid "" "The :mod:`pydoc` module can create HTML from the doc strings in your Python " "source code. An alternative for creating API documentation purely from " @@ -3019,12 +2996,12 @@ msgid "" "sphinx-doc.org>`_ can also include docstring content." msgstr "" -#: ../src/Doc/faq/library.rst:189 +#: faq/library.rst:189 msgid "How do I get a single keypress at a time?" msgstr "" # 5c0167168bc34f919136b9f5cb1a1189 -#: ../src/Doc/faq/library.rst:191 +#: faq/library.rst:191 msgid "" "For Unix variants there are several solutions. It's straightforward to do " "this using curses, but curses is a fairly large module to learn. Here's a " @@ -3032,7 +3009,7 @@ msgid "" msgstr "" # a715987744e34d5fbc5dfaa22bb4515e -#: ../src/Doc/faq/library.rst:216 +#: faq/library.rst:216 msgid "" "You need the :mod:`termios` and the :mod:`fcntl` module for any of this to " "work, and I've only tried it on Linux, though it should work elsewhere. In " @@ -3040,7 +3017,7 @@ msgid "" msgstr "" # 813f540d56334fb4b066a8fb18b481a3 -#: ../src/Doc/faq/library.rst:220 +#: faq/library.rst:220 msgid "" ":func:`termios.tcsetattr` turns off stdin's echoing and disables canonical " "mode. :func:`fcntl.fnctl` is used to obtain stdin's file descriptor flags " @@ -3048,57 +3025,57 @@ msgid "" "results in an :exc:`IOError`, this error is caught and ignored." msgstr "" -#: ../src/Doc/faq/library.rst:227 +#: faq/library.rst:227 msgid "Threads" msgstr "" -#: ../src/Doc/faq/library.rst:230 +#: faq/library.rst:230 msgid "How do I program using threads?" msgstr "" # aade5bd432964f7f8e4a17d3e91ad817 -#: ../src/Doc/faq/library.rst:234 +#: faq/library.rst:234 msgid "" "Be sure to use the :mod:`threading` module and not the :mod:`thread` module. " "The :mod:`threading` module builds convenient abstractions on top of the low-" "level primitives provided by the :mod:`thread` module." msgstr "" -#: ../src/Doc/faq/library.rst:238 +#: faq/library.rst:238 msgid "" "Aahz has a set of slides from his threading tutorial that are helpful; see " "http://www.pythoncraft.com/OSCON2001/." msgstr "" -#: ../src/Doc/faq/library.rst:243 +#: faq/library.rst:243 msgid "None of my threads seem to run: why?" msgstr "" -#: ../src/Doc/faq/library.rst:245 +#: faq/library.rst:245 msgid "" "As soon as the main thread exits, all threads are killed. Your main thread " "is running too quickly, giving the threads no time to do any work." msgstr "" -#: ../src/Doc/faq/library.rst:248 +#: faq/library.rst:248 msgid "" "A simple fix is to add a sleep to the end of the program that's long enough " "for all the threads to finish::" msgstr "" -#: ../src/Doc/faq/library.rst:262 +#: faq/library.rst:262 msgid "" "But now (on many platforms) the threads don't run in parallel, but appear to " "run sequentially, one at a time! The reason is that the OS thread scheduler " "doesn't start a new thread until the previous thread is blocked." msgstr "" -#: ../src/Doc/faq/library.rst:266 +#: faq/library.rst:266 msgid "A simple fix is to add a tiny sleep to the start of the run function::" msgstr "" # aea21e6b09a041ff957fecb4b0a89c0f -#: ../src/Doc/faq/library.rst:278 +#: faq/library.rst:278 msgid "" "Instead of trying to guess a good delay value for :func:`time.sleep`, it's " "better to use some kind of semaphore mechanism. One idea is to use the :mod:" @@ -3107,12 +3084,12 @@ msgid "" "the queue as there are threads." msgstr "" -#: ../src/Doc/faq/library.rst:286 +#: faq/library.rst:286 msgid "How do I parcel out work among a bunch of worker threads?" msgstr "" # 5030478637c142e3a6cd9440f3d27b9e -#: ../src/Doc/faq/library.rst:288 +#: faq/library.rst:288 msgid "" "Use the :mod:`Queue` module to create a queue containing a list of jobs. " "The :class:`~Queue.Queue` class maintains a list of objects and has a ``." @@ -3121,28 +3098,28 @@ msgid "" "that each job is handed out exactly once." msgstr "" -#: ../src/Doc/faq/library.rst:294 +#: faq/library.rst:294 msgid "Here's a trivial example::" msgstr "" # 9388dec82b3f4056a524814851ce0228 -#: ../src/Doc/faq/library.rst:332 +#: faq/library.rst:332 msgid "When run, this will produce the following output:" msgstr "" # 873b457452d44ef0a185bbfc7967ca31 -#: ../src/Doc/faq/library.rst:350 +#: faq/library.rst:350 msgid "" "Consult the module's documentation for more details; the :class:`~Queue." "Queue` class provides a featureful interface." msgstr "" -#: ../src/Doc/faq/library.rst:355 +#: faq/library.rst:355 msgid "What kinds of global value mutation are thread-safe?" msgstr "" # 98825d7125a74191bf625b903e0fa199 -#: ../src/Doc/faq/library.rst:357 +#: faq/library.rst:357 msgid "" "A :term:`global interpreter lock` (GIL) is used internally to ensure that " "only one thread runs in the Python VM at a time. In general, Python offers " @@ -3152,7 +3129,7 @@ msgid "" "instruction is therefore atomic from the point of view of a Python program." msgstr "" -#: ../src/Doc/faq/library.rst:364 +#: faq/library.rst:364 msgid "" "In theory, this means an exact accounting requires an exact understanding of " "the PVM bytecode implementation. In practice, it means that operations on " @@ -3160,17 +3137,17 @@ msgid "" "\"look atomic\" really are." msgstr "" -#: ../src/Doc/faq/library.rst:369 +#: faq/library.rst:369 msgid "" "For example, the following operations are all atomic (L, L1, L2 are lists, " "D, D1, D2 are dicts, x, y are objects, i, j are ints)::" msgstr "" -#: ../src/Doc/faq/library.rst:384 +#: faq/library.rst:384 msgid "These aren't::" msgstr "" -#: ../src/Doc/faq/library.rst:391 +#: faq/library.rst:391 msgid "" "Operations that replace other objects may invoke those other objects' :meth:" "`__del__` method when their reference count reaches zero, and that can " @@ -3178,12 +3155,12 @@ msgid "" "and lists. When in doubt, use a mutex!" msgstr "" -#: ../src/Doc/faq/library.rst:398 +#: faq/library.rst:398 msgid "Can't we get rid of the Global Interpreter Lock?" msgstr "" # 4645f49916d74429b99ac83c664c66b2 -#: ../src/Doc/faq/library.rst:403 +#: faq/library.rst:403 msgid "" "The :term:`global interpreter lock` (GIL) is often seen as a hindrance to " "Python's deployment on high-end multiprocessor server machines, because a " @@ -3191,7 +3168,7 @@ msgid "" "insistence that (almost) all Python code can only run while the GIL is held." msgstr "" -#: ../src/Doc/faq/library.rst:408 +#: faq/library.rst:408 msgid "" "Back in the days of Python 1.5, Greg Stein actually implemented a " "comprehensive patch set (the \"free threading\" patches) that removed the " @@ -3202,7 +3179,7 @@ msgid "" msgstr "" # 0d1b3cb5fbc646a996f627baf27c1b2d -#: ../src/Doc/faq/library.rst:415 +#: faq/library.rst:415 msgid "" "Since then, the idea of getting rid of the GIL has occasionally come up but " "nobody has found a way to deal with the expected slowdown, and users who " @@ -3211,7 +3188,7 @@ msgid "" "Python versions." msgstr "" -#: ../src/Doc/faq/library.rst:420 +#: faq/library.rst:420 msgid "" "This doesn't mean that you can't make good use of Python on multi-CPU " "machines! You just have to be creative with dividing the work up between " @@ -3221,7 +3198,7 @@ msgid "" "execution is in the C code and allow other threads to get some work done." msgstr "" -#: ../src/Doc/faq/library.rst:427 +#: faq/library.rst:427 msgid "" "It has been suggested that the GIL should be a per-interpreter-state lock " "rather than truly global; interpreters then wouldn't be able to share " @@ -3233,7 +3210,7 @@ msgid "" "the interpreter state. And so on." msgstr "" -#: ../src/Doc/faq/library.rst:436 +#: faq/library.rst:436 msgid "" "And I doubt that it can even be done in finite time, because the same " "problem exists for 3rd party extensions. It is likely that 3rd party " @@ -3241,29 +3218,29 @@ msgid "" "store all their global state in the interpreter state." msgstr "" -#: ../src/Doc/faq/library.rst:441 +#: faq/library.rst:441 msgid "" "And finally, once you have multiple interpreters not sharing any state, what " "have you gained over running each interpreter in a separate process?" msgstr "" -#: ../src/Doc/faq/library.rst:446 +#: faq/library.rst:446 msgid "Input and Output" msgstr "Les entrées/sorties" -#: ../src/Doc/faq/library.rst:449 +#: faq/library.rst:449 msgid "How do I delete a file? (And other file questions...)" msgstr "" # 71640ee4d2224271bacdc47863e5b350 -#: ../src/Doc/faq/library.rst:451 +#: faq/library.rst:451 msgid "" "Use ``os.remove(filename)`` or ``os.unlink(filename)``; for documentation, " "see the :mod:`os` module. The two functions are identical; :func:`unlink` " "is simply the name of the Unix system call for this function." msgstr "" -#: ../src/Doc/faq/library.rst:455 +#: faq/library.rst:455 msgid "" "To remove a directory, use :func:`os.rmdir`; use :func:`os.mkdir` to create " "one. ``os.makedirs(path)`` will create any intermediate directories in " @@ -3272,12 +3249,12 @@ msgid "" "directory tree and its contents, use :func:`shutil.rmtree`." msgstr "" -#: ../src/Doc/faq/library.rst:461 +#: faq/library.rst:461 msgid "To rename a file, use ``os.rename(old_path, new_path)``." msgstr "" # 0dbfd8ffe6b347cbb8606e4b428e007c -#: ../src/Doc/faq/library.rst:463 +#: faq/library.rst:463 msgid "" "To truncate a file, open it using ``f = open(filename, \"r+\")``, and use " "``f.truncate(offset)``; offset defaults to the current seek position. " @@ -3285,41 +3262,41 @@ msgid "" "open`, where *fd* is the file descriptor (a small integer)." msgstr "" -#: ../src/Doc/faq/library.rst:468 +#: faq/library.rst:468 msgid "" "The :mod:`shutil` module also contains a number of functions to work on " "files including :func:`~shutil.copyfile`, :func:`~shutil.copytree`, and :" "func:`~shutil.rmtree`." msgstr "" -#: ../src/Doc/faq/library.rst:474 +#: faq/library.rst:474 msgid "How do I copy a file?" msgstr "" -#: ../src/Doc/faq/library.rst:476 +#: faq/library.rst:476 msgid "" "The :mod:`shutil` module contains a :func:`~shutil.copyfile` function. Note " "that on MacOS 9 it doesn't copy the resource fork and Finder info." msgstr "" -#: ../src/Doc/faq/library.rst:481 +#: faq/library.rst:481 msgid "How do I read (or write) binary data?" msgstr "" -#: ../src/Doc/faq/library.rst:483 +#: faq/library.rst:483 msgid "" "To read or write complex binary data formats, it's best to use the :mod:" "`struct` module. It allows you to take a string containing binary data " "(usually numbers) and convert it to Python objects; and vice versa." msgstr "" -#: ../src/Doc/faq/library.rst:487 +#: faq/library.rst:487 msgid "" "For example, the following code reads two 2-byte integers and one 4-byte " "integer in big-endian format from a file::" msgstr "" -#: ../src/Doc/faq/library.rst:496 +#: faq/library.rst:496 msgid "" "The '>' in the format string forces big-endian data; the letter 'h' reads " "one \"short integer\" (2 bytes), and 'l' reads one \"long integer\" (4 " @@ -3327,18 +3304,18 @@ msgid "" msgstr "" # fef9fd4c406745759a75aad37e902d24 -#: ../src/Doc/faq/library.rst:500 +#: faq/library.rst:500 msgid "" "For data that is more regular (e.g. a homogeneous list of ints or floats), " "you can also use the :mod:`array` module." msgstr "" -#: ../src/Doc/faq/library.rst:505 +#: faq/library.rst:505 msgid "I can't seem to use os.read() on a pipe created with os.popen(); why?" msgstr "" # d22d10e0ad1c44028fd64db3211e81d7 -#: ../src/Doc/faq/library.rst:507 +#: faq/library.rst:507 msgid "" ":func:`os.read` is a low-level function which takes a file descriptor, a " "small integer representing the opened file. :func:`os.popen` creates a high-" @@ -3348,18 +3325,18 @@ msgid "" msgstr "" # f819db3658c14897b532123365257ba3 -#: ../src/Doc/faq/library.rst:515 +#: faq/library.rst:515 msgid "" "How do I run a subprocess with pipes connected to both input and output?" msgstr "" # 7e374660290c446781cc624c56dbfd07 -#: ../src/Doc/faq/library.rst:519 +#: faq/library.rst:519 msgid "Use the :mod:`popen2` module. For example::" msgstr "" # dec6101a723d48708d571b72ded2b902 -#: ../src/Doc/faq/library.rst:527 +#: faq/library.rst:527 msgid "" "Warning: in general it is unwise to do this because you can easily cause a " "deadlock where your process is blocked waiting for output from the child " @@ -3373,7 +3350,7 @@ msgid "" msgstr "" # 1197cc04e58e49a1b97b882883642028 -#: ../src/Doc/faq/library.rst:537 +#: faq/library.rst:537 msgid "" "Note that a deadlock is also possible if you use :func:`popen3` to read " "stdout and stderr. If one of the two is too large for the internal buffer " @@ -3382,7 +3359,7 @@ msgid "" msgstr "" # c8b4db825b5648e680aa36cccf590464 -#: ../src/Doc/faq/library.rst:542 +#: faq/library.rst:542 msgid "" "Note on a bug in popen2: unless your program calls ``wait()`` or " "``waitpid()``, finished child processes are never removed, and eventually " @@ -3393,7 +3370,7 @@ msgid "" msgstr "" # 10fb3be321ea4761a378d835626903d9 -#: ../src/Doc/faq/library.rst:548 +#: faq/library.rst:548 msgid "" "In many cases, all you really need is to run some data through a command and " "get the result back. Unless the amount of data is very large, the easiest " @@ -3404,7 +3381,7 @@ msgid "" msgstr "" # 8b956d91d40445478ec5c8d886d5b7ed -#: ../src/Doc/faq/library.rst:583 +#: faq/library.rst:583 msgid "" "Note that many interactive programs (e.g. vi) don't work well with pipes " "substituted for standard input and output. You will have to use pseudo ttys " @@ -3415,31 +3392,31 @@ msgid "" "pexpect/>`_." msgstr "" -#: ../src/Doc/faq/library.rst:592 +#: faq/library.rst:592 msgid "How do I access the serial (RS232) port?" msgstr "" -#: ../src/Doc/faq/library.rst:594 +#: faq/library.rst:594 msgid "For Win32, POSIX (Linux, BSD, etc.), Jython:" msgstr "" -#: ../src/Doc/faq/library.rst:596 +#: faq/library.rst:596 msgid "http://pyserial.sourceforge.net" msgstr "" -#: ../src/Doc/faq/library.rst:598 +#: faq/library.rst:598 msgid "For Unix, see a Usenet post by Mitch Chapman:" msgstr "" -#: ../src/Doc/faq/library.rst:600 +#: faq/library.rst:600 msgid "http://groups.google.com/groups?selm=34A04430.CF9@ohioee.com" msgstr "" -#: ../src/Doc/faq/library.rst:604 +#: faq/library.rst:604 msgid "Why doesn't closing sys.stdout (stdin, stderr) really close it?" msgstr "" -#: ../src/Doc/faq/library.rst:606 +#: faq/library.rst:606 msgid "" "Python file objects are a high-level layer of abstraction on top of C " "streams, which in turn are a medium-level layer of abstraction on top of " @@ -3447,7 +3424,7 @@ msgid "" msgstr "" # 40a02022a26b432aa559de8f54a1b286 -#: ../src/Doc/faq/library.rst:610 +#: faq/library.rst:610 msgid "" "For most file objects you create in Python via the built-in ``file`` " "constructor, ``f.close()`` marks the Python file object as being closed from " @@ -3456,7 +3433,7 @@ msgid "" "garbage." msgstr "" -#: ../src/Doc/faq/library.rst:616 +#: faq/library.rst:616 msgid "" "But stdin, stdout and stderr are treated specially by Python, because of the " "special status also given to them by C. Running ``sys.stdout.close()`` " @@ -3464,22 +3441,22 @@ msgid "" "associated C stream." msgstr "" -#: ../src/Doc/faq/library.rst:621 +#: faq/library.rst:621 msgid "" "To close the underlying C stream for one of these three, you should first be " "sure that's what you really want to do (e.g., you may confuse extension " "modules trying to do I/O). If it is, use os.close::" msgstr "" -#: ../src/Doc/faq/library.rst:631 +#: faq/library.rst:631 msgid "Network/Internet Programming" msgstr "" -#: ../src/Doc/faq/library.rst:634 +#: faq/library.rst:634 msgid "What WWW tools are there for Python?" msgstr "" -#: ../src/Doc/faq/library.rst:636 +#: faq/library.rst:636 msgid "" "See the chapters titled :ref:`internet` and :ref:`netdata` in the Library " "Reference Manual. Python has many modules that will help you build server-" @@ -3487,68 +3464,68 @@ msgid "" msgstr "" # faca0f8973914815a8d319155ae0de0c -#: ../src/Doc/faq/library.rst:642 +#: faq/library.rst:642 msgid "" "A summary of available frameworks is maintained by Paul Boddie at https://" "wiki.python.org/moin/WebProgramming\\ ." msgstr "" -#: ../src/Doc/faq/library.rst:645 +#: faq/library.rst:645 msgid "" "Cameron Laird maintains a useful set of pages about Python web technologies " "at http://phaseit.net/claird/comp.lang.python/web_python." msgstr "" -#: ../src/Doc/faq/library.rst:650 +#: faq/library.rst:650 msgid "How can I mimic CGI form submission (METHOD=POST)?" msgstr "" -#: ../src/Doc/faq/library.rst:652 +#: faq/library.rst:652 msgid "" "I would like to retrieve web pages that are the result of POSTing a form. Is " "there existing code that would let me do this easily?" msgstr "" # cc7f47f414e945268f949aea1bb54a43 -#: ../src/Doc/faq/library.rst:655 +#: faq/library.rst:655 msgid "Yes. Here's a simple example that uses httplib::" msgstr "" # 6bbd0565911e4b01849546530b20af6c -#: ../src/Doc/faq/library.rst:679 +#: faq/library.rst:679 msgid "" "Note that in general for percent-encoded POST operations, query strings must " "be quoted using :func:`urllib.urlencode`. For example, to send ``name=Guy " "Steele, Jr.``::" msgstr "" -#: ../src/Doc/faq/library.rst:689 +#: faq/library.rst:689 msgid "What module should I use to help with generating HTML?" msgstr "" # 6562031f44bd408d99eae3425867950a -#: ../src/Doc/faq/library.rst:693 +#: faq/library.rst:693 msgid "" "You can find a collection of useful links on the `Web Programming wiki page " "`_." msgstr "" -#: ../src/Doc/faq/library.rst:698 +#: faq/library.rst:698 msgid "How do I send mail from a Python script?" msgstr "" -#: ../src/Doc/faq/library.rst:700 +#: faq/library.rst:700 msgid "Use the standard library module :mod:`smtplib`." msgstr "" -#: ../src/Doc/faq/library.rst:702 +#: faq/library.rst:702 msgid "" "Here's a very simple interactive mail sender that uses it. This method will " "work on any host that supports an SMTP listener. ::" msgstr "" # f96b24bc2e6348e99069db16a21c5822 -#: ../src/Doc/faq/library.rst:722 +#: faq/library.rst:722 msgid "" "A Unix-only alternative uses sendmail. The location of the sendmail program " "varies between systems; sometimes it is ``/usr/lib/sendmail``, sometimes ``/" @@ -3556,16 +3533,16 @@ msgid "" "some sample code::" msgstr "" -#: ../src/Doc/faq/library.rst:741 +#: faq/library.rst:741 msgid "How do I avoid blocking in the connect() method of a socket?" msgstr "" -#: ../src/Doc/faq/library.rst:743 +#: faq/library.rst:743 msgid "" "The select module is commonly used to help with asynchronous I/O on sockets." msgstr "" -#: ../src/Doc/faq/library.rst:745 +#: faq/library.rst:745 msgid "" "To prevent the TCP connect from blocking, you can set the socket to non-" "blocking mode. Then when you do the ``connect()``, you will either connect " @@ -3576,7 +3553,7 @@ msgid "" msgstr "" # 9d51bbc18a6147c1b3d0996e626eb7b6 -#: ../src/Doc/faq/library.rst:752 +#: faq/library.rst:752 msgid "" "You can use the ``connect_ex()`` method to avoid creating an exception. It " "will just return the errno value. To poll, you can call ``connect_ex()`` " @@ -3584,16 +3561,16 @@ msgid "" "you can pass this socket to select to check if it's writable." msgstr "" -#: ../src/Doc/faq/library.rst:759 +#: faq/library.rst:759 msgid "Databases" msgstr "" -#: ../src/Doc/faq/library.rst:762 +#: faq/library.rst:762 msgid "Are there any interfaces to database packages in Python?" msgstr "" # 7f73d57d944b41bb8ca122e5e500dda0 -#: ../src/Doc/faq/library.rst:768 +#: faq/library.rst:768 msgid "" "Python 2.3 includes the :mod:`bsddb` package which provides an interface to " "the BerkeleyDB library. Interfaces to disk-based hashes such as :mod:`DBM " @@ -3601,19 +3578,19 @@ msgid "" msgstr "" # e17212ec224c47fb9a41d13b606db95b -#: ../src/Doc/faq/library.rst:772 +#: faq/library.rst:772 msgid "" "Support for most relational databases is available. See the " "`DatabaseProgramming wiki page `_ for details." msgstr "" -#: ../src/Doc/faq/library.rst:778 +#: faq/library.rst:778 msgid "How do you implement persistent objects in Python?" msgstr "" # e19720fb14704b7caf1c8eb52984e685 -#: ../src/Doc/faq/library.rst:780 +#: faq/library.rst:780 msgid "" "The :mod:`pickle` library module solves this in a very general way (though " "you still can't store things like open files, sockets or windows), and the :" @@ -3623,7 +3600,7 @@ msgid "" msgstr "" # 1a7bb612acd8457c96fc689263595d3e -#: ../src/Doc/faq/library.rst:786 +#: faq/library.rst:786 msgid "" "A more awkward way of doing things is to use pickle's little sister, " "marshal. The :mod:`marshal` module provides very fast ways to store " @@ -3636,25 +3613,25 @@ msgid "" msgstr "" # 3840155eab2c46f38734d3b48f7fe0d9 -#: ../src/Doc/faq/library.rst:796 +#: faq/library.rst:796 msgid "Why is cPickle so slow?" msgstr "" # 7687ae13889e44908f88e5522dd28712 -#: ../src/Doc/faq/library.rst:800 +#: faq/library.rst:800 msgid "" "By default :mod:`pickle` uses a relatively old and slow format for backward " "compatibility. You can however specify other protocol versions that are " "faster::" msgstr "" -#: ../src/Doc/faq/library.rst:809 +#: faq/library.rst:809 msgid "" "If my program crashes with a bsddb (or anydbm) database open, it gets " "corrupted. How come?" msgstr "" -#: ../src/Doc/faq/library.rst:811 +#: faq/library.rst:811 msgid "" "Databases opened for write access with the bsddb module (and often by the " "anydbm module, since it will preferentially use bsddb) must explicitly be " @@ -3663,27 +3640,27 @@ msgid "" "and written." msgstr "" -#: ../src/Doc/faq/library.rst:816 +#: faq/library.rst:816 msgid "" "If you have initialized a new bsddb database but not written anything to it " "before the program crashes, you will often wind up with a zero-length file " "and encounter an exception the next time the file is opened." msgstr "" -#: ../src/Doc/faq/library.rst:822 +#: faq/library.rst:822 msgid "" "I tried to open Berkeley DB file, but bsddb produces bsddb.error: (22, " "'Invalid argument'). Help! How can I restore my data?" msgstr "" -#: ../src/Doc/faq/library.rst:824 +#: faq/library.rst:824 msgid "" "Don't panic! Your data is probably intact. The most frequent cause for the " "error is that you tried to open an earlier Berkeley DB file with a later " "version of the Berkeley DB library." msgstr "" -#: ../src/Doc/faq/library.rst:828 +#: faq/library.rst:828 msgid "" "Many Linux systems now have all three versions of Berkeley DB available. If " "you are migrating from version 1 to a newer version use db_dump185 to dump a " @@ -3695,81 +3672,81 @@ msgid "" "database." msgstr "" -#: ../src/Doc/faq/library.rst:836 +#: faq/library.rst:836 msgid "" "You should move away from Berkeley DB version 1 files because the hash file " "code contains known bugs that can corrupt your data." msgstr "" -#: ../src/Doc/faq/library.rst:841 +#: faq/library.rst:841 msgid "Mathematics and Numerics" msgstr "" -#: ../src/Doc/faq/library.rst:844 +#: faq/library.rst:844 msgid "How do I generate random numbers in Python?" msgstr "" -#: ../src/Doc/faq/library.rst:846 +#: faq/library.rst:846 msgid "" "The standard module :mod:`random` implements a random number generator. " "Usage is simple::" msgstr "" -#: ../src/Doc/faq/library.rst:852 +#: faq/library.rst:852 msgid "This returns a random floating point number in the range [0, 1)." msgstr "" -#: ../src/Doc/faq/library.rst:854 +#: faq/library.rst:854 msgid "" "There are also many other specialized generators in this module, such as:" msgstr "" -#: ../src/Doc/faq/library.rst:856 +#: faq/library.rst:856 msgid "``randrange(a, b)`` chooses an integer in the range [a, b)." msgstr "" -#: ../src/Doc/faq/library.rst:857 +#: faq/library.rst:857 msgid "``uniform(a, b)`` chooses a floating point number in the range [a, b)." msgstr "" -#: ../src/Doc/faq/library.rst:858 +#: faq/library.rst:858 msgid "" "``normalvariate(mean, sdev)`` samples the normal (Gaussian) distribution." msgstr "" -#: ../src/Doc/faq/library.rst:860 +#: faq/library.rst:860 msgid "Some higher-level functions operate on sequences directly, such as:" msgstr "" -#: ../src/Doc/faq/library.rst:862 +#: faq/library.rst:862 msgid "``choice(S)`` chooses random element from a given sequence" msgstr "" -#: ../src/Doc/faq/library.rst:863 +#: faq/library.rst:863 msgid "``shuffle(L)`` shuffles a list in-place, i.e. permutes it randomly" msgstr "" -#: ../src/Doc/faq/library.rst:865 +#: faq/library.rst:865 msgid "" "There's also a ``Random`` class you can instantiate to create independent " "multiple random number generators." msgstr "" -#: ../src/Doc/faq/programming.rst:5 +#: faq/programming.rst:5 msgid "Programming FAQ" msgstr "" -#: ../src/Doc/faq/programming.rst:12 +#: faq/programming.rst:12 msgid "General Questions" msgstr "" -#: ../src/Doc/faq/programming.rst:15 +#: faq/programming.rst:15 msgid "" "Is there a source code level debugger with breakpoints, single-stepping, " "etc.?" msgstr "" -#: ../src/Doc/faq/programming.rst:19 +#: faq/programming.rst:19 msgid "" "The pdb module is a simple but adequate console-mode debugger for Python. It " "is part of the standard Python library, and is :mod:`documented in the " @@ -3778,7 +3755,7 @@ msgid "" msgstr "" # bad998877641449e848192d8c2f7b7ca -#: ../src/Doc/faq/programming.rst:24 +#: faq/programming.rst:24 msgid "" "The IDLE interactive development environment, which is part of the standard " "Python distribution (normally available as Tools/scripts/idle), includes a " @@ -3786,7 +3763,7 @@ msgid "" msgstr "" # fa25926b9fbe41cca3239569051efc64 -#: ../src/Doc/faq/programming.rst:28 +#: faq/programming.rst:28 msgid "" "PythonWin is a Python IDE that includes a GUI debugger based on pdb. The " "Pythonwin debugger colors breakpoints and has quite a few cool features such " @@ -3796,7 +3773,7 @@ msgid "" "activestate.com/activepython\\ )." msgstr "" -#: ../src/Doc/faq/programming.rst:35 +#: faq/programming.rst:35 msgid "" "`Boa Constructor `_ is an IDE and " "GUI builder that uses wxWidgets. It offers visual frame creation and " @@ -3806,13 +3783,13 @@ msgid "" msgstr "" # bfc1271a533e428490bbef17f369d211 -#: ../src/Doc/faq/programming.rst:41 +#: faq/programming.rst:41 msgid "" "`Eric `_ is an IDE built on PyQt and " "the Scintilla editing component." msgstr "" -#: ../src/Doc/faq/programming.rst:44 +#: faq/programming.rst:44 msgid "" "Pydb is a version of the standard Python debugger pdb, modified for use with " "DDD (Data Display Debugger), a popular graphical debugger front end. Pydb " @@ -3820,32 +3797,32 @@ msgid "" "http://www.gnu.org/software/ddd." msgstr "" -#: ../src/Doc/faq/programming.rst:49 +#: faq/programming.rst:49 msgid "" "There are a number of commercial Python IDEs that include graphical " "debuggers. They include:" msgstr "" -#: ../src/Doc/faq/programming.rst:52 +#: faq/programming.rst:52 msgid "Wing IDE (http://wingware.com/)" msgstr "" # cd51e87efa494b02a79da6f88505405a -#: ../src/Doc/faq/programming.rst:53 +#: faq/programming.rst:53 msgid "Komodo IDE (http://komodoide.com/)" msgstr "" # ea0fa502768142ea8d51289781c801c5 -#: ../src/Doc/faq/programming.rst:54 +#: faq/programming.rst:54 msgid "PyCharm (https://www.jetbrains.com/pycharm/)" msgstr "" -#: ../src/Doc/faq/programming.rst:58 +#: faq/programming.rst:58 msgid "Is there a tool to help find bugs or perform static analysis?" msgstr "" # cf24545073b64b608121d95b7227749a -#: ../src/Doc/faq/programming.rst:62 +#: faq/programming.rst:62 msgid "" "PyChecker is a static analysis tool that finds bugs in Python source code " "and warns about code complexity and style. You can get PyChecker from " @@ -3853,7 +3830,7 @@ msgid "" msgstr "" # c3d75402116446f08d24651b60587ab5 -#: ../src/Doc/faq/programming.rst:66 +#: faq/programming.rst:66 msgid "" "`Pylint `_ is another tool that " "checks if a module satisfies a coding standard, and also makes it possible " @@ -3864,11 +3841,11 @@ msgid "" "more. http://docs.pylint.org/ provides a full list of Pylint's features." msgstr "" -#: ../src/Doc/faq/programming.rst:76 +#: faq/programming.rst:76 msgid "How can I create a stand-alone binary from a Python script?" msgstr "" -#: ../src/Doc/faq/programming.rst:78 +#: faq/programming.rst:78 msgid "" "You don't need the ability to compile Python to C code if all you want is a " "stand-alone program that users can download and run without having to " @@ -3877,7 +3854,7 @@ msgid "" "together with a Python binary to produce a single executable." msgstr "" -#: ../src/Doc/faq/programming.rst:84 +#: faq/programming.rst:84 msgid "" "One is to use the freeze tool, which is included in the Python source tree " "as ``Tools/freeze``. It converts Python byte code to C arrays; a C compiler " @@ -3885,7 +3862,7 @@ msgid "" "the standard Python modules." msgstr "" -#: ../src/Doc/faq/programming.rst:89 +#: faq/programming.rst:89 msgid "" "It works by scanning your source recursively for import statements (in both " "forms) and looking for the modules in the standard Python path as well as in " @@ -3898,65 +3875,65 @@ msgid "" "exactly like your script." msgstr "" -#: ../src/Doc/faq/programming.rst:98 +#: faq/programming.rst:98 msgid "" "Obviously, freeze requires a C compiler. There are several other utilities " "which don't. One is Thomas Heller's py2exe (Windows only) at" msgstr "" -#: ../src/Doc/faq/programming.rst:101 +#: faq/programming.rst:101 msgid "http://www.py2exe.org/" msgstr "" # ab1effd97d9a4db6b9e2c200578fbfdf -#: ../src/Doc/faq/programming.rst:103 +#: faq/programming.rst:103 msgid "" "Another tool is Anthony Tuininga's `cx_Freeze `_." msgstr "" -#: ../src/Doc/faq/programming.rst:107 +#: faq/programming.rst:107 msgid "Are there coding standards or a style guide for Python programs?" msgstr "" -#: ../src/Doc/faq/programming.rst:109 +#: faq/programming.rst:109 msgid "" "Yes. The coding style required for standard library modules is documented " "as :pep:`8`." msgstr "" -#: ../src/Doc/faq/programming.rst:114 +#: faq/programming.rst:114 msgid "My program is too slow. How do I speed it up?" msgstr "" -#: ../src/Doc/faq/programming.rst:116 +#: faq/programming.rst:116 msgid "" "That's a tough one, in general. There are many tricks to speed up Python " "code; consider rewriting parts in C as a last resort." msgstr "" -#: ../src/Doc/faq/programming.rst:119 +#: faq/programming.rst:119 msgid "" "In some cases it's possible to automatically translate Python to C or x86 " "assembly language, meaning that you don't have to modify your code to gain " "increased speed." msgstr "" -#: ../src/Doc/faq/programming.rst:125 +#: faq/programming.rst:125 msgid "" "`Pyrex `_ can compile " "a slightly modified version of Python code into a C extension, and can be " "used on many different platforms." msgstr "" -#: ../src/Doc/faq/programming.rst:129 +#: faq/programming.rst:129 msgid "" "`Psyco `_ is a just-in-time compiler that " "translates Python code into x86 assembly language. If you can use it, Psyco " "can provide dramatic speedups for critical functions." msgstr "" -#: ../src/Doc/faq/programming.rst:133 +#: faq/programming.rst:133 msgid "" "The rest of this answer will discuss various tricks for squeezing a bit more " "speed out of Python code. *Never* apply any optimization tricks unless you " @@ -3968,20 +3945,20 @@ msgid "" msgstr "" # 55812fb1974b4d35b3629077fdfbf6df -#: ../src/Doc/faq/programming.rst:141 +#: faq/programming.rst:141 msgid "" "There is a page on the wiki devoted to `performance tips `_." msgstr "" # 13d2e0a3cc5b49d3afa3db3b84eeeece -#: ../src/Doc/faq/programming.rst:144 +#: faq/programming.rst:144 msgid "" "Guido van Rossum has written up an anecdote related to optimization at " "https://www.python.org/doc/essays/list2str." msgstr "" -#: ../src/Doc/faq/programming.rst:147 +#: faq/programming.rst:147 msgid "" "One thing to notice is that function and (especially) method calls are " "rather expensive; if you have designed a purely OO interface with lots of " @@ -3993,7 +3970,7 @@ msgid "" "your program down by an order of magnitude)." msgstr "" -#: ../src/Doc/faq/programming.rst:156 +#: faq/programming.rst:156 msgid "" "Remember that many standard optimization heuristics you may know from other " "programming experience may well apply to Python. For example it may be " @@ -4003,7 +3980,7 @@ msgid "" "that write lots of small pieces of output." msgstr "" -#: ../src/Doc/faq/programming.rst:163 +#: faq/programming.rst:163 msgid "" "Also, be sure to use Python's core features where appropriate. For example, " "slicing allows programs to chop up lists and other sequence objects in a " @@ -4011,11 +3988,11 @@ msgid "" "implementations. Thus to get the same effect as::" msgstr "" -#: ../src/Doc/faq/programming.rst:172 +#: faq/programming.rst:172 msgid "it is much shorter and far faster to use ::" msgstr "" -#: ../src/Doc/faq/programming.rst:176 +#: faq/programming.rst:176 msgid "" "Note that the functionally-oriented built-in functions such as :func:`map`, :" "func:`zip`, and friends can be a convenient accelerator for loops that " @@ -4023,16 +4000,16 @@ msgid "" "together::" msgstr "" -#: ../src/Doc/faq/programming.rst:184 +#: faq/programming.rst:184 msgid "or to compute a number of sines::" msgstr "" -#: ../src/Doc/faq/programming.rst:189 +#: faq/programming.rst:189 msgid "The operation completes very quickly in such cases." msgstr "" # 54d42c305aed46aea0e1dac5e7d0e9ec -#: ../src/Doc/faq/programming.rst:191 +#: faq/programming.rst:191 msgid "" "Other examples include the ``join()`` and ``split()`` :ref:`methods of " "string objects `. For example if s1..s7 are large (10K+) " @@ -4047,7 +4024,7 @@ msgid "" msgstr "" # d15916e437c84e658a3a86d114462937 -#: ../src/Doc/faq/programming.rst:202 +#: faq/programming.rst:202 msgid "" "Be sure to use the :meth:`list.sort` built-in method to do sorting, and see " "the `sorting mini-HOWTO `_ for " @@ -4055,7 +4032,7 @@ msgid "" "techniques for sorting in all but the most extreme circumstances." msgstr "" -#: ../src/Doc/faq/programming.rst:207 +#: faq/programming.rst:207 msgid "" "Another common trick is to \"push loops into functions or methods.\" For " "example suppose you have a program that runs slowly and you use the profiler " @@ -4063,90 +4040,90 @@ msgid "" "If you notice that ``ff()``::" msgstr "" -#: ../src/Doc/faq/programming.rst:216 +#: faq/programming.rst:216 msgid "tends to be called in loops like::" msgstr "" -#: ../src/Doc/faq/programming.rst:220 ../src/Doc/faq/windows.rst:107 +#: faq/programming.rst:220 faq/windows.rst:107 msgid "or::" msgstr "" -#: ../src/Doc/faq/programming.rst:226 +#: faq/programming.rst:226 msgid "" "then you can often eliminate function call overhead by rewriting ``ff()`` " "to::" msgstr "" -#: ../src/Doc/faq/programming.rst:235 +#: faq/programming.rst:235 msgid "and rewrite the two examples to ``list = ffseq(oldlist)`` and to::" msgstr "" -#: ../src/Doc/faq/programming.rst:240 +#: faq/programming.rst:240 msgid "" "Single calls to ``ff(x)`` translate to ``ffseq([x])[0]`` with little " "penalty. Of course this technique is not always appropriate and there are " "other variants which you can figure out." msgstr "" -#: ../src/Doc/faq/programming.rst:244 +#: faq/programming.rst:244 msgid "" "You can gain some performance by explicitly storing the results of a " "function or method lookup into a local variable. A loop like::" msgstr "" -#: ../src/Doc/faq/programming.rst:250 +#: faq/programming.rst:250 msgid "" "resolves ``dict.get`` every iteration. If the method isn't going to change, " "a slightly faster implementation is::" msgstr "" -#: ../src/Doc/faq/programming.rst:257 +#: faq/programming.rst:257 msgid "" "Default arguments can be used to determine values once, at compile time " "instead of at run time. This can only be done for functions or objects " "which will not be changed during program execution, such as replacing ::" msgstr "" -#: ../src/Doc/faq/programming.rst:264 +#: faq/programming.rst:264 msgid "with ::" msgstr "" -#: ../src/Doc/faq/programming.rst:269 +#: faq/programming.rst:269 msgid "" "Because this trick uses default arguments for terms which should not be " "changed, it should only be used when you are not concerned with presenting a " "possibly confusing API to your users." msgstr "" -#: ../src/Doc/faq/programming.rst:275 +#: faq/programming.rst:275 msgid "Core Language" msgstr "" -#: ../src/Doc/faq/programming.rst:278 +#: faq/programming.rst:278 msgid "Why am I getting an UnboundLocalError when the variable has a value?" msgstr "" -#: ../src/Doc/faq/programming.rst:280 +#: faq/programming.rst:280 msgid "" "It can be a surprise to get the UnboundLocalError in previously working code " "when it is modified by adding an assignment statement somewhere in the body " "of a function." msgstr "" -#: ../src/Doc/faq/programming.rst:284 +#: faq/programming.rst:284 msgid "This code:" msgstr "" -#: ../src/Doc/faq/programming.rst:292 +#: faq/programming.rst:292 msgid "works, but this code:" msgstr "" -#: ../src/Doc/faq/programming.rst:299 +#: faq/programming.rst:299 msgid "results in an UnboundLocalError:" msgstr "" # 7d745afdbd874d62b29bbedfc0099907 -#: ../src/Doc/faq/programming.rst:306 +#: faq/programming.rst:306 msgid "" "This is because when you make an assignment to a variable in a scope, that " "variable becomes local to that scope and shadows any similarly named " @@ -4156,33 +4133,32 @@ msgid "" "uninitialized local variable and an error results." msgstr "" -#: ../src/Doc/faq/programming.rst:313 +#: faq/programming.rst:313 msgid "" "In the example above you can access the outer scope variable by declaring it " "global:" msgstr "" -#: ../src/Doc/faq/programming.rst:324 +#: faq/programming.rst:324 msgid "" "This explicit declaration is required in order to remind you that (unlike " "the superficially analogous situation with class and instance variables) you " "are actually modifying the value of the variable in the outer scope:" msgstr "" -#: ../src/Doc/faq/programming.rst:333 +#: faq/programming.rst:333 msgid "What are the rules for local and global variables in Python?" msgstr "" -#: ../src/Doc/faq/programming.rst:335 +#: faq/programming.rst:335 msgid "" "In Python, variables that are only referenced inside a function are " -"implicitly global. If a variable is assigned a new value anywhere within " -"the function's body, it's assumed to be a local. If a variable is ever " -"assigned a new value inside the function, the variable is implicitly local, " -"and you need to explicitly declare it as 'global'." +"implicitly global. If a variable is assigned a value anywhere within the " +"function's body, it's assumed to be a local unless explicitly declared as " +"global." msgstr "" -#: ../src/Doc/faq/programming.rst:341 +#: faq/programming.rst:339 msgid "" "Though a bit surprising at first, a moment's consideration explains this. " "On one hand, requiring :keyword:`global` for assigned variables provides a " @@ -4194,21 +4170,21 @@ msgid "" msgstr "" # 924a0fb4c52d4d508ae61ede7c3f8fdf -#: ../src/Doc/faq/programming.rst:351 +#: faq/programming.rst:349 msgid "" "Why do lambdas defined in a loop with different values all return the same " "result?" msgstr "" # 6e3ea9d4df2642eb9d3e92eaa6a9968c -#: ../src/Doc/faq/programming.rst:353 +#: faq/programming.rst:351 msgid "" "Assume you use a for loop to define a few different lambdas (or even plain " "functions), e.g.::" msgstr "" # 13aa3d4bd1ba489385475d37babef0c0 -#: ../src/Doc/faq/programming.rst:360 +#: faq/programming.rst:358 msgid "" "This gives you a list that contains 5 lambdas that calculate ``x**2``. You " "might expect that, when called, they would return, respectively, ``0``, " @@ -4217,7 +4193,7 @@ msgid "" msgstr "" # 05dae30e0a144c0297629c1951263f65 -#: ../src/Doc/faq/programming.rst:370 +#: faq/programming.rst:368 msgid "" "This happens because ``x`` is not local to the lambdas, but is defined in " "the outer scope, and it is accessed when the lambda is called --- not when " @@ -4227,14 +4203,14 @@ msgid "" msgstr "" # bdbfb8d8dc1247e98b41e0aff5680c34 -#: ../src/Doc/faq/programming.rst:380 +#: faq/programming.rst:378 msgid "" "In order to avoid this, you need to save the values in variables local to " "the lambdas, so that they don't rely on the value of the global ``x``::" msgstr "" # 0d3f70faade14c55b8ed25080bd41a4e -#: ../src/Doc/faq/programming.rst:387 +#: faq/programming.rst:385 msgid "" "Here, ``n=x`` creates a new variable ``n`` local to the lambda and computed " "when the lambda is defined so that it has the same value that ``x`` had at " @@ -4244,17 +4220,17 @@ msgid "" msgstr "" # b620a634f93a46fca3caa69d6a8410d2 -#: ../src/Doc/faq/programming.rst:398 +#: faq/programming.rst:396 msgid "" "Note that this behaviour is not peculiar to lambdas, but applies to regular " "functions too." msgstr "" -#: ../src/Doc/faq/programming.rst:403 +#: faq/programming.rst:401 msgid "How do I share global variables across modules?" msgstr "" -#: ../src/Doc/faq/programming.rst:405 +#: faq/programming.rst:403 msgid "" "The canonical way to share information across modules within a single " "program is to create a special module (often called config or cfg). Just " @@ -4264,37 +4240,37 @@ msgid "" "everywhere. For example:" msgstr "" -#: ../src/Doc/faq/programming.rst:411 +#: faq/programming.rst:409 msgid "config.py::" msgstr "" -#: ../src/Doc/faq/programming.rst:415 +#: faq/programming.rst:413 msgid "mod.py::" msgstr "" -#: ../src/Doc/faq/programming.rst:420 +#: faq/programming.rst:418 msgid "main.py::" msgstr "" -#: ../src/Doc/faq/programming.rst:426 +#: faq/programming.rst:424 msgid "" "Note that using a module is also the basis for implementing the Singleton " "design pattern, for the same reason." msgstr "" -#: ../src/Doc/faq/programming.rst:431 +#: faq/programming.rst:429 msgid "What are the \"best practices\" for using import in a module?" msgstr "" # fe8501e866514060acb58f1c1a7bbd23 -#: ../src/Doc/faq/programming.rst:433 +#: faq/programming.rst:431 msgid "" "In general, don't use ``from modulename import *``. Doing so clutters the " "importer's namespace, and makes it much harder for linters to detect " "undefined names." msgstr "" -#: ../src/Doc/faq/programming.rst:437 +#: faq/programming.rst:435 msgid "" "Import modules at the top of a file. Doing so makes it clear what other " "modules your code requires and avoids questions of whether the module name " @@ -4302,26 +4278,26 @@ msgid "" "module imports, but using multiple imports per line uses less screen space." msgstr "" -#: ../src/Doc/faq/programming.rst:442 +#: faq/programming.rst:440 msgid "It's good practice if you import modules in the following order:" msgstr "" -#: ../src/Doc/faq/programming.rst:444 +#: faq/programming.rst:442 msgid "standard library modules -- e.g. ``sys``, ``os``, ``getopt``, ``re``" msgstr "" -#: ../src/Doc/faq/programming.rst:445 +#: faq/programming.rst:443 msgid "" "third-party library modules (anything installed in Python's site-packages " "directory) -- e.g. mx.DateTime, ZODB, PIL.Image, etc." msgstr "" -#: ../src/Doc/faq/programming.rst:447 +#: faq/programming.rst:445 msgid "locally-developed modules" msgstr "" # 9f4cb04c4862498b986f121672a5251b -#: ../src/Doc/faq/programming.rst:449 +#: faq/programming.rst:447 msgid "" "Only use explicit relative package imports. If you're writing code that's " "in the ``package.sub.m1`` module and want to import ``package.sub.m2``, do " @@ -4329,13 +4305,13 @@ msgid "" "sub import m2`` or ``from . import m2`` instead." msgstr "" -#: ../src/Doc/faq/programming.rst:454 +#: faq/programming.rst:452 msgid "" "It is sometimes necessary to move imports to a function or class to avoid " "problems with circular imports. Gordon McMillan says:" msgstr "" -#: ../src/Doc/faq/programming.rst:457 +#: faq/programming.rst:455 msgid "" "Circular imports are fine where both modules use the \"import \" " "form of import. They fail when the 2nd module wants to grab a name out of " @@ -4344,7 +4320,7 @@ msgid "" "module is busy importing the 2nd." msgstr "" -#: ../src/Doc/faq/programming.rst:463 +#: faq/programming.rst:461 msgid "" "In this case, if the second module is only used in one function, then the " "import can easily be moved into that function. By the time the import is " @@ -4352,7 +4328,7 @@ msgid "" "module can do its import." msgstr "" -#: ../src/Doc/faq/programming.rst:468 +#: faq/programming.rst:466 msgid "" "It may also be necessary to move imports out of the top level of code if " "some of the modules are platform-specific. In that case, it may not even be " @@ -4361,7 +4337,7 @@ msgid "" "a good option." msgstr "" -#: ../src/Doc/faq/programming.rst:473 +#: faq/programming.rst:471 msgid "" "Only move imports into a local scope, such as inside a function definition, " "if it's necessary to solve a problem such as avoiding a circular import or " @@ -4375,24 +4351,24 @@ msgid "" "of scope, the module is probably available in :data:`sys.modules`." msgstr "" -#: ../src/Doc/faq/programming.rst:486 +#: faq/programming.rst:484 msgid "Why are default values shared between objects?" msgstr "" -#: ../src/Doc/faq/programming.rst:488 +#: faq/programming.rst:486 msgid "" "This type of bug commonly bites neophyte programmers. Consider this " "function::" msgstr "" -#: ../src/Doc/faq/programming.rst:495 +#: faq/programming.rst:493 msgid "" "The first time you call this function, ``mydict`` contains a single item. " "The second time, ``mydict`` contains two items because when ``foo()`` begins " "executing, ``mydict`` starts out with an item already in it." msgstr "" -#: ../src/Doc/faq/programming.rst:499 +#: faq/programming.rst:497 msgid "" "It is often expected that a function call creates new objects for default " "values. This is not what happens. Default values are created exactly once, " @@ -4401,14 +4377,14 @@ msgid "" "this changed object." msgstr "" -#: ../src/Doc/faq/programming.rst:504 +#: faq/programming.rst:502 msgid "" "By definition, immutable objects such as numbers, strings, tuples, and " "``None``, are safe from change. Changes to mutable objects such as " "dictionaries, lists, and class instances can lead to confusion." msgstr "" -#: ../src/Doc/faq/programming.rst:508 +#: faq/programming.rst:506 msgid "" "Because of this feature, it is good programming practice to not use mutable " "objects as default values. Instead, use ``None`` as the default value and " @@ -4416,11 +4392,11 @@ msgid "" "list/dictionary/whatever if it is. For example, don't write::" msgstr "" -#: ../src/Doc/faq/programming.rst:516 +#: faq/programming.rst:514 msgid "but::" msgstr "" -#: ../src/Doc/faq/programming.rst:522 +#: faq/programming.rst:520 msgid "" "This feature can be useful. When you have a function that's time-consuming " "to compute, a common technique is to cache the parameters and the resulting " @@ -4429,18 +4405,18 @@ msgid "" "implemented like this::" msgstr "" -#: ../src/Doc/faq/programming.rst:537 +#: faq/programming.rst:535 msgid "" "You could use a global variable containing a dictionary instead of the " "default value; it's a matter of taste." msgstr "" -#: ../src/Doc/faq/programming.rst:542 +#: faq/programming.rst:540 msgid "" "How can I pass optional or keyword parameters from one function to another?" msgstr "" -#: ../src/Doc/faq/programming.rst:544 +#: faq/programming.rst:542 msgid "" "Collect the arguments using the ``*`` and ``**`` specifiers in the " "function's parameter list; this gives you the positional arguments as a " @@ -4448,19 +4424,19 @@ msgid "" "arguments when calling another function by using ``*`` and ``**``::" msgstr "" -#: ../src/Doc/faq/programming.rst:555 +#: faq/programming.rst:553 msgid "" "In the unlikely case that you care about Python versions older than 2.0, " "use :func:`apply`::" msgstr "" # 96b5be5f561c4e388030863e5bbacca1 -#: ../src/Doc/faq/programming.rst:572 +#: faq/programming.rst:570 msgid "What is the difference between arguments and parameters?" msgstr "" # a4cafc0bd37a4682bb11a96bcc193305 -#: ../src/Doc/faq/programming.rst:574 +#: faq/programming.rst:572 msgid "" ":term:`Parameters ` are defined by the names that appear in a " "function definition, whereas :term:`arguments ` are the values " @@ -4470,40 +4446,40 @@ msgid "" msgstr "" # aebb59148b8f4b369dcddd620bda8acc -#: ../src/Doc/faq/programming.rst:582 +#: faq/programming.rst:580 msgid "" "*foo*, *bar* and *kwargs* are parameters of ``func``. However, when calling " "``func``, for example::" msgstr "" # 786ad2fc6ac74da49f7655b754d46766 -#: ../src/Doc/faq/programming.rst:587 +#: faq/programming.rst:585 msgid "the values ``42``, ``314``, and ``somevar`` are arguments." msgstr "" # 0bd1025c430c46fca744f1ab71d0c6f9 -#: ../src/Doc/faq/programming.rst:591 +#: faq/programming.rst:589 msgid "Why did changing list 'y' also change list 'x'?" msgstr "" -#: ../src/Doc/faq/programming.rst:593 +#: faq/programming.rst:591 #, fuzzy msgid "If you wrote code like::" msgstr "In C++ you'd write" # dcf823fe26834b4298e3ab0729b2fa4c -#: ../src/Doc/faq/programming.rst:603 +#: faq/programming.rst:601 msgid "" "you might be wondering why appending an element to ``y`` changed ``x`` too." msgstr "" # 49fc350d28fb420ca92faac571737b2d -#: ../src/Doc/faq/programming.rst:605 +#: faq/programming.rst:603 msgid "There are two factors that produce this result:" msgstr "" # 413d98a41e7b4e67aed138c28d7ba12f -#: ../src/Doc/faq/programming.rst:607 +#: faq/programming.rst:605 msgid "" "Variables are simply names that refer to objects. Doing ``y = x`` doesn't " "create a copy of the list -- it creates a new variable ``y`` that refers to " @@ -4512,13 +4488,13 @@ msgid "" msgstr "" # e44847fa07dd4dc4af11a625d09fda63 -#: ../src/Doc/faq/programming.rst:611 +#: faq/programming.rst:609 msgid "" "Lists are :term:`mutable`, which means that you can change their content." msgstr "" # a8ee185e5f0240fd850b3c16b68088da -#: ../src/Doc/faq/programming.rst:613 +#: faq/programming.rst:611 msgid "" "After the call to :meth:`~list.append`, the content of the mutable object " "has changed from ``[]`` to ``[10]``. Since both the variables refer to the " @@ -4526,12 +4502,12 @@ msgid "" msgstr "" # 9f8319228d964bfda3bab873ba568653 -#: ../src/Doc/faq/programming.rst:617 +#: faq/programming.rst:615 msgid "If we instead assign an immutable object to ``x``::" msgstr "" # 2a525148729d47d8b88281de2d3d4f0c -#: ../src/Doc/faq/programming.rst:627 +#: faq/programming.rst:625 msgid "" "we can see that in this case ``x`` and ``y`` are not equal anymore. This is " "because integers are :term:`immutable`, and when we do ``x = x + 1`` we are " @@ -4543,7 +4519,7 @@ msgid "" msgstr "" # 46a5fa2e975f4e98b02b22431e76776e -#: ../src/Doc/faq/programming.rst:635 +#: faq/programming.rst:633 msgid "" "Some operations (for example ``y.append(10)`` and ``y.sort()``) mutate the " "object, whereas superficially similar operations (for example ``y = y + " @@ -4556,7 +4532,7 @@ msgid "" msgstr "" # b71ccf689a1e48a7ae3dc9f6cd9a3322 -#: ../src/Doc/faq/programming.rst:644 +#: faq/programming.rst:642 msgid "" "However, there is one class of operations where the same operation sometimes " "has different behaviors with different types: the augmented assignment " @@ -4567,12 +4543,12 @@ msgid "" msgstr "" # 2a5ffb67bd9448e8ade209869f3c7f75 -#: ../src/Doc/faq/programming.rst:651 +#: faq/programming.rst:649 msgid "In other words:" msgstr "" # dc6bcce15dcf4b898d9e766c2b41e03e -#: ../src/Doc/faq/programming.rst:653 +#: faq/programming.rst:651 msgid "" "If we have a mutable object (:class:`list`, :class:`dict`, :class:`set`, " "etc.), we can use some specific operations to mutate it and all the " @@ -4580,7 +4556,7 @@ msgid "" msgstr "" # 4d5f00e6b8d34e29bf200694d85fd9e4 -#: ../src/Doc/faq/programming.rst:656 +#: faq/programming.rst:654 msgid "" "If we have an immutable object (:class:`str`, :class:`int`, :class:`tuple`, " "etc.), all the variables that refer to it will always see the same value, " @@ -4589,17 +4565,17 @@ msgid "" msgstr "" # ac62a0f8bdb148b28efffd5e47189104 -#: ../src/Doc/faq/programming.rst:661 +#: faq/programming.rst:659 msgid "" "If you want to know if two variables refer to the same object or not, you " "can use the :keyword:`is` operator, or the built-in function :func:`id`." msgstr "" -#: ../src/Doc/faq/programming.rst:666 +#: faq/programming.rst:664 msgid "How do I write a function with output parameters (call by reference)?" msgstr "" -#: ../src/Doc/faq/programming.rst:668 +#: faq/programming.rst:666 msgid "" "Remember that arguments are passed by assignment in Python. Since " "assignment just creates references to objects, there's no alias between an " @@ -4607,51 +4583,51 @@ msgid "" "You can achieve the desired effect in a number of ways." msgstr "" -#: ../src/Doc/faq/programming.rst:673 +#: faq/programming.rst:671 msgid "By returning a tuple of the results::" msgstr "" -#: ../src/Doc/faq/programming.rst:684 +#: faq/programming.rst:682 msgid "This is almost always the clearest solution." msgstr "" -#: ../src/Doc/faq/programming.rst:686 +#: faq/programming.rst:684 msgid "" "By using global variables. This isn't thread-safe, and is not recommended." msgstr "" "En utilisant des variables globales. Ce qui n'est pas thread-safe, et n'est " "donc pas recommandé." -#: ../src/Doc/faq/programming.rst:688 +#: faq/programming.rst:686 msgid "By passing a mutable (changeable in-place) object::" msgstr "En passant un objet mutable (modifiable par remplacement)::" -#: ../src/Doc/faq/programming.rst:698 +#: faq/programming.rst:696 msgid "By passing in a dictionary that gets mutated::" msgstr "En utilisant un dictionnaire, qui est modifié (en place)." -#: ../src/Doc/faq/programming.rst:708 +#: faq/programming.rst:706 #, fuzzy msgid "Or bundle up values in a class instance::" msgstr "Ou regrouper les valeurs dans une instance de classe::" -#: ../src/Doc/faq/programming.rst:724 +#: faq/programming.rst:722 msgid "There's almost never a good reason to get this complicated." msgstr "" "Il n'y a pratiquement jamais de bonne raison de faire quelque chose d'aussi " "compliqué." -#: ../src/Doc/faq/programming.rst:726 +#: faq/programming.rst:724 msgid "Your best choice is to return a tuple containing the multiple results." msgstr "" "Votre meilleure option est de renvoyer un tuple contenant les résultats " "multiples." -#: ../src/Doc/faq/programming.rst:730 +#: faq/programming.rst:728 msgid "How do you make a higher order function in Python?" msgstr "Comment construire une fonction de grand ordre en Python?" -#: ../src/Doc/faq/programming.rst:732 +#: faq/programming.rst:730 msgid "" "You have two choices: you can use nested scopes or you can use callable " "objects. For example, suppose you wanted to define ``linear(a,b)`` which " @@ -4663,19 +4639,19 @@ msgstr "" "vouliez définir ``lineare (a, b)`` qui retourne une fonction ``f (x)`` qui " "calcule la valeur ``a * x + b``. En utilisant les portées imbriquées::" -#: ../src/Doc/faq/programming.rst:741 +#: faq/programming.rst:739 msgid "Or using a callable object::" msgstr "Ou en utilisant un objet appelable." -#: ../src/Doc/faq/programming.rst:751 +#: faq/programming.rst:749 msgid "In both cases, ::" msgstr "dans les deux cas, ::" -#: ../src/Doc/faq/programming.rst:755 +#: faq/programming.rst:753 msgid "gives a callable object where ``taxes(10e6) == 0.3 * 10e6 + 2``." msgstr "retourne un objet appelable tel que ``taxes(10e6) == 0.3 * 10e6 + 2``." -#: ../src/Doc/faq/programming.rst:757 +#: faq/programming.rst:755 msgid "" "The callable object approach has the disadvantage that it is a bit slower " "and results in slightly longer code. However, note that a collection of " @@ -4686,12 +4662,12 @@ msgstr "" "qu'une collection d'objet appelables peuvent partager leur signatures par " "héritage::" -#: ../src/Doc/faq/programming.rst:766 +#: faq/programming.rst:764 #, fuzzy msgid "Object can encapsulate state for several methods::" msgstr "Les objets peuvent encapsuler un état pour plusieurs méthodes::" -#: ../src/Doc/faq/programming.rst:784 +#: faq/programming.rst:782 msgid "" "Here ``inc()``, ``dec()`` and ``reset()`` act like functions which share the " "same counting variable." @@ -4699,11 +4675,11 @@ msgstr "" "Ici ``inc()``, ``dec()`` et ``reset`` agissent comme des fonctions " "partageant une même variable compteur." -#: ../src/Doc/faq/programming.rst:789 +#: faq/programming.rst:787 msgid "How do I copy an object in Python?" msgstr "Comment copier un objet en Python?" -#: ../src/Doc/faq/programming.rst:791 +#: faq/programming.rst:789 msgid "" "In general, try :func:`copy.copy` or :func:`copy.deepcopy` for the general " "case. Not all objects can be copied, but most can." @@ -4711,7 +4687,7 @@ msgstr "" "En général, essayez :funct:`copy.copy` ou :func:`copy.deepcopy` pour le cas " "général. Tout les objets ne peuvent pas être copiés, mais la plupart peuvent." -#: ../src/Doc/faq/programming.rst:794 +#: faq/programming.rst:792 msgid "" "Some objects can be copied more easily. Dictionaries have a :meth:`~dict." "copy` method::" @@ -4719,15 +4695,15 @@ msgstr "" "Certains objects peuvent être copiés plus facilement. Les Dictionnaires ont " "une méthode :meth:`~dict.copy` ::" -#: ../src/Doc/faq/programming.rst:799 +#: faq/programming.rst:797 msgid "Sequences can be copied by slicing::" msgstr "Les séquences peuvent être copiées par tranches::" -#: ../src/Doc/faq/programming.rst:805 +#: faq/programming.rst:803 msgid "How can I find the methods or attributes of an object?" msgstr "Comment puis-je trouver les méthodes ou les attribues d'un objet?" -#: ../src/Doc/faq/programming.rst:807 +#: faq/programming.rst:805 msgid "" "For an instance x of a user-defined class, ``dir(x)`` returns an " "alphabetized list of the names containing the instance attributes and " @@ -4737,11 +4713,11 @@ msgstr "" "renvoie une liste alphabétique des noms contenants les attributs de " "l'instance, et les attributs et méthodes définies par sa classe." -#: ../src/Doc/faq/programming.rst:813 +#: faq/programming.rst:811 msgid "How can my code discover the name of an object?" msgstr "Comment mon code peut il découvrir le nom d'un objet?" -#: ../src/Doc/faq/programming.rst:815 +#: faq/programming.rst:813 msgid "" "Generally speaking, it can't, because objects don't really have names. " "Essentially, assignment always binds a name to a value; The same is true of " @@ -4753,7 +4729,7 @@ msgstr "" "valeur; C'est vrai aussi pour les mots clés ``def`` et ``class``, à la " "différence que la valeur est un objet appelable." -#: ../src/Doc/faq/programming.rst:832 +#: faq/programming.rst:830 msgid "" "Arguably the class has a name: even though it is bound to two names and " "invoked through the name B the created instance is still reported as an " @@ -4765,7 +4741,7 @@ msgstr "" "une instance de la classe A. De même Il est impossible de dire si le nom de " "l'instance est a ou b, les deux noms sont attachés à la même valeur." -#: ../src/Doc/faq/programming.rst:837 +#: faq/programming.rst:835 msgid "" "Generally speaking it should not be necessary for your code to \"know the " "names\" of particular values. Unless you are deliberately writing " @@ -4777,7 +4753,7 @@ msgstr "" "délibérément en train d'écrire un programme introspectif, c'est souvent une " "indication qu'un changement d'approche pourrait être bénéfique." -#: ../src/Doc/faq/programming.rst:842 +#: faq/programming.rst:840 msgid "" "In comp.lang.python, Fredrik Lundh once gave an excellent analogy in answer " "to this question:" @@ -4785,7 +4761,7 @@ msgstr "" "Sur comp.lang.python, Fredrik Lundh a donné un jour une excellente analogie " "pour répondre à cette question:" -#: ../src/Doc/faq/programming.rst:845 +#: faq/programming.rst:843 msgid "" "The same way as you get the name of that cat you found on your porch: the " "cat (object) itself cannot tell you its name, and it doesn't really care -- " @@ -4797,7 +4773,7 @@ msgstr "" "moque un peu -- alors le meilleur moyen de savoir comment il est appelé est " "de demander à tous vos voisins (namespaces) si c'est leur chat (object)…" -#: ../src/Doc/faq/programming.rst:850 +#: faq/programming.rst:848 msgid "" "....and don't be surprised if you'll find that it's known by many names, or " "no name at all!" @@ -4805,16 +4781,16 @@ msgstr "" "…et ne soyez pas surpris si vous découvrez qu'il est connus sous plusieurs " "noms différents, ou pas de nom du tout!" -#: ../src/Doc/faq/programming.rst:855 +#: faq/programming.rst:853 msgid "What's up with the comma operator's precedence?" msgstr "Quel est le souci avec la précédente de l'opérateur virgule?" -#: ../src/Doc/faq/programming.rst:857 +#: faq/programming.rst:855 msgid "Comma is not an operator in Python. Consider this session::" msgstr "" "Virgule n'est pas un opérateur en Python. Observez la session suivante::" -#: ../src/Doc/faq/programming.rst:862 +#: faq/programming.rst:860 msgid "" "Since the comma is not an operator, but a separator between expressions the " "above is evaluated as if you had entered::" @@ -4823,11 +4799,11 @@ msgstr "" "expression, l'expression ci dessus, est évaluée de la même façon que si vous " "aviez écrit::" -#: ../src/Doc/faq/programming.rst:867 +#: faq/programming.rst:865 msgid "not::" msgstr "et non::" -#: ../src/Doc/faq/programming.rst:871 +#: faq/programming.rst:869 msgid "" "The same is true of the various assignment operators (``=``, ``+=`` etc). " "They are not truly operators but syntactic delimiters in assignment " @@ -4837,28 +4813,28 @@ msgstr "" "ne sont pas vraiment des opérateurs mais des délimiteurs syntaxiques dans " "les instructions d'assignation." -#: ../src/Doc/faq/programming.rst:876 +#: faq/programming.rst:874 msgid "Is there an equivalent of C's \"?:\" ternary operator?" msgstr "Existe-t'il un équivalent à l'opérateur \"?:\" ternaire du C?" -#: ../src/Doc/faq/programming.rst:878 +#: faq/programming.rst:876 msgid "" "Yes, this feature was added in Python 2.5. The syntax would be as follows::" msgstr "" "Oui, cette fonctionnalité à été ajouté à partir de Python 2.5. La syntaxe " "est la suivante::" -#: ../src/Doc/faq/programming.rst:886 +#: faq/programming.rst:884 msgid "For versions previous to 2.5 the answer would be 'No'." msgstr "Pour les versions précédentes de python la réponse serait \"Non\"." -#: ../src/Doc/faq/programming.rst:890 +#: faq/programming.rst:888 msgid "Is it possible to write obfuscated one-liners in Python?" msgstr "" "Est-il possible d'écrire des programmes volontairement difficile à " "comprendre sur une seule ligne en Python?" -#: ../src/Doc/faq/programming.rst:892 +#: faq/programming.rst:890 msgid "" "Yes. Usually this is done by nesting :keyword:`lambda` within :keyword:" "`lambda`. See the following three examples, due to Ulf Bartelt::" @@ -4867,19 +4843,19 @@ msgstr "" "uns dans les autres. Observez les trois exemples suivants, contribués par " "Ulf Bartelt::" -#: ../src/Doc/faq/programming.rst:917 +#: faq/programming.rst:915 msgid "Don't try this at home, kids!" msgstr "Les enfants, ne faîtes pas ça chez vous!" -#: ../src/Doc/faq/programming.rst:921 +#: faq/programming.rst:919 msgid "Numbers and strings" msgstr "Nombres et chaines de caractères" -#: ../src/Doc/faq/programming.rst:924 +#: faq/programming.rst:922 msgid "How do I specify hexadecimal and octal integers?" msgstr "Comment puis-je spécifier des entiers hexadécimaux ou octaux?" -#: ../src/Doc/faq/programming.rst:926 +#: faq/programming.rst:924 msgid "" "To specify an octal digit, precede the octal value with a zero, and then a " "lower or uppercase \"o\". For example, to set the variable \"a\" to the " @@ -4889,7 +4865,7 @@ msgstr "" "zéro, puis un \"o\" majuscule ou minuscule. Par exemple assigner la valeur " "octale \"10\" (8 en décimal) à \"a\", tapez::" -#: ../src/Doc/faq/programming.rst:934 +#: faq/programming.rst:932 msgid "" "Hexadecimal is just as easy. Simply precede the hexadecimal number with a " "zero, and then a lower or uppercase \"x\". Hexadecimal digits can be " @@ -4900,11 +4876,11 @@ msgstr "" "peuvent être écrit en majuscules ou en minuscules. Par exemple, dans " "l'interpréteur Python::" -#: ../src/Doc/faq/programming.rst:947 +#: faq/programming.rst:945 msgid "Why does -22 // 10 return -3?" msgstr "Pourquoi -22//10 retourne-t'il -3?" -#: ../src/Doc/faq/programming.rst:949 +#: faq/programming.rst:947 msgid "" "It's primarily driven by the desire that ``i % j`` have the same sign as " "``j``. If you want that, and also want::" @@ -4912,7 +4888,7 @@ msgstr "" "Cela est principalement due à la volonté que ``i % j`` ait le même signe que " "j. Si vous voulez cela, vous voulez aussi::" -#: ../src/Doc/faq/programming.rst:954 +#: faq/programming.rst:952 msgid "" "then integer division has to return the floor. C also requires that " "identity to hold, and then compilers that truncate ``i // j`` need to make " @@ -4922,7 +4898,7 @@ msgstr "" "aussi à ce que cette égalité soit vérifiée, et donc les compilateur qui " "tronquent ``i//j`` ont besoin que ``i % j`` ait le même signe que ``i``." -#: ../src/Doc/faq/programming.rst:958 +#: faq/programming.rst:956 msgid "" "There are few real use cases for ``i % j`` when ``j`` is negative. When " "``j`` is positive, there are many, and in virtually all of them it's more " @@ -4937,17 +4913,17 @@ msgstr "" "== -10`` est un bug qui attends pour mordre." # 947cdc04b21e4a4b946644f003e25388 -#: ../src/Doc/faq/programming.rst:966 +#: faq/programming.rst:964 msgid "" "On Python 2, ``a / b`` returns the same as ``a // b`` if ``__future__." "division`` is not in effect. This is also known as \"classic\" division." msgstr "" -#: ../src/Doc/faq/programming.rst:972 +#: faq/programming.rst:970 msgid "How do I convert a string to a number?" msgstr "Comment puis-je convertir une chaine de caractère en nombre?" -#: ../src/Doc/faq/programming.rst:974 +#: faq/programming.rst:972 msgid "" "For integers, use the built-in :func:`int` type constructor, e.g. " "``int('144') == 144``. Similarly, :func:`float` converts to floating-point, " @@ -4958,7 +4934,7 @@ msgstr "" "`float` convertit en valeur flottante, par exemple ``float('144')`` == " "144.0``." -#: ../src/Doc/faq/programming.rst:978 +#: faq/programming.rst:976 msgid "" "By default, these interpret the number as decimal, so that ``int('0144') == " "144`` and ``int('0x144')`` raises :exc:`ValueError`. ``int(string, base)`` " @@ -4974,7 +4950,7 @@ msgstr "" "324``. Si la base donnée est 0, le nombre est interprété selon les règles " "Python: un '0' en tête indique octal, et '0x' indique un hexadécimal." -#: ../src/Doc/faq/programming.rst:984 +#: faq/programming.rst:982 msgid "" "Do not use the built-in function :func:`eval` if all you need is to convert " "strings to numbers. :func:`eval` will be significantly slower and it " @@ -4991,7 +4967,7 @@ msgstr "" "system(\"rm -rf $HOME\")`` ce qui aurait pour effet d'effacer votre " "répertoire personnel." -#: ../src/Doc/faq/programming.rst:991 +#: faq/programming.rst:989 #, fuzzy msgid "" ":func:`eval` also has the effect of interpreting numbers as Python " @@ -5003,12 +4979,12 @@ msgstr "" "que Python ne permet pas les '0' en tête d'un nombre décimal (à l'exception " "du nombre '0')." -#: ../src/Doc/faq/programming.rst:997 +#: faq/programming.rst:995 msgid "How do I convert a number to a string?" msgstr "Comment convertir un nombre en chaine de caractère?" # faut il traduire la référence? -#: ../src/Doc/faq/programming.rst:999 +#: faq/programming.rst:997 #, fuzzy msgid "" "To convert, e.g., the number 144 to the string '144', use the built-in type " @@ -5026,11 +5002,11 @@ msgstr "" "`string-formatting`, par exemple, ``\"{:04d) \".format (144)`` renvoit " "``'0144'`` et ``\"{:.3f)\".format (1 / 3) donne ``'0,333' ``." -#: ../src/Doc/faq/programming.rst:1009 +#: faq/programming.rst:1007 msgid "How do I modify a string in place?" msgstr "Comment modifier une chaine de caractère \"en place\"?" -#: ../src/Doc/faq/programming.rst:1011 +#: faq/programming.rst:1009 msgid "" "You can't, because strings are immutable. If you need an object with this " "ability, try converting the string to a list or use the array module::" @@ -5039,17 +5015,17 @@ msgstr "" "vous avez besoin d'un objet ayant une telle capacité, essayez de convertir " "la chaine en liste, ou utilisez le module array::" -#: ../src/Doc/faq/programming.rst:1034 +#: faq/programming.rst:1032 msgid "How do I use strings to call functions/methods?" msgstr "" "Comment utiliser des chaines de caractères pour appeler des fonctions/" "méthodes?" -#: ../src/Doc/faq/programming.rst:1036 +#: faq/programming.rst:1034 msgid "There are various techniques." msgstr "Il y a différentes techniques." -#: ../src/Doc/faq/programming.rst:1038 +#: faq/programming.rst:1036 msgid "" "The best is to use a dictionary that maps strings to functions. The primary " "advantage of this technique is that the strings do not need to match the " @@ -5062,11 +5038,11 @@ msgstr "" "fonctions. C'est aussi la principale façon d'imiter la construction \"case" "\"::" -#: ../src/Doc/faq/programming.rst:1053 +#: faq/programming.rst:1051 msgid "Use the built-in function :func:`getattr`::" msgstr "Utiliser la fonction :func:`getattr`::" -#: ../src/Doc/faq/programming.rst:1058 +#: faq/programming.rst:1056 msgid "" "Note that :func:`getattr` works on any object, including classes, class " "instances, modules, and so on." @@ -5074,18 +5050,18 @@ msgstr "" "Notez que :func:`getattr` marche sur n'importe quel objet, ceci inclue les " "classes, les instances de classes, les modules et ainsi de suite." -#: ../src/Doc/faq/programming.rst:1061 +#: faq/programming.rst:1059 msgid "This is used in several places in the standard library, like this::" msgstr "" "Ceci est utilisé dans plusieurs endroit de la bibliothèque standard, de " "cette façon::" -#: ../src/Doc/faq/programming.rst:1074 +#: faq/programming.rst:1072 msgid "Use :func:`locals` or :func:`eval` to resolve the function name::" msgstr "" "Utilisez :func:`locals` ou :func:`eval` pour résoudre le nom de fonction::" -#: ../src/Doc/faq/programming.rst:1087 +#: faq/programming.rst:1085 msgid "" "Note: Using :func:`eval` is slow and dangerous. If you don't have absolute " "control over the contents of the string, someone could pass a string that " @@ -5096,7 +5072,7 @@ msgstr "" "passer une chaine de caractère pouvant résulter en l'exécution de code " "arbitraire." -#: ../src/Doc/faq/programming.rst:1092 +#: faq/programming.rst:1090 msgid "" "Is there an equivalent to Perl's chomp() for removing trailing newlines from " "strings?" @@ -5104,7 +5080,7 @@ msgstr "" "Existe-t'il un équivalent à la fonction chomp() de Perl, pour retirer les " "caractères de fin de ligne d'une chaine de caractère?" -#: ../src/Doc/faq/programming.rst:1094 +#: faq/programming.rst:1092 #, fuzzy msgid "" "Starting with Python 2.2, you can use ``S.rstrip(\"\\r\\n\")`` to remove all " @@ -5119,7 +5095,7 @@ msgstr "" "ligne. Si la chaine ``S`` représente plus d'une ligne, avec plusieurs lignes " "vides, les terminateurs de lignes de toutes les lignes vides seront retirés::" -#: ../src/Doc/faq/programming.rst:1106 +#: faq/programming.rst:1104 msgid "" "Since this is typically only desired when reading text one line at a time, " "using ``S.rstrip()`` this way works well." @@ -5127,13 +5103,13 @@ msgstr "" "Du fait que ce soit principalement utile en lisant un texte ligne à ligne, " "utiliser ``S.rstrip()`` devrait marcher correctement." -#: ../src/Doc/faq/programming.rst:1109 +#: faq/programming.rst:1107 msgid "For older versions of Python, there are two partial substitutes:" msgstr "" "Pour les versions plus anciennes de python, il y a deux substituts partiels " "disponibles." -#: ../src/Doc/faq/programming.rst:1111 +#: faq/programming.rst:1109 msgid "" "If you want to remove all trailing whitespace, use the ``rstrip()`` method " "of string objects. This removes all trailing whitespace, not just a single " @@ -5143,7 +5119,7 @@ msgstr "" "``rstrip()`` des chaines de caractères. Cela retire tous les espaces de fin " "de ligne, pas seulement le caractère de fin de ligne." -#: ../src/Doc/faq/programming.rst:1115 +#: faq/programming.rst:1113 msgid "" "Otherwise, if there is only one line in the string ``S``, use ``S." "splitlines()[0]``." @@ -5151,15 +5127,15 @@ msgstr "" "Sinon, s'il y a seulement une ligne dans la chaine ``S``, utilisez ``S." "splitlines()``[0]." -#: ../src/Doc/faq/programming.rst:1120 +#: faq/programming.rst:1118 msgid "Is there a scanf() or sscanf() equivalent?" msgstr "Existe-t'il un équivalent à scanf() ou sscanf()?" -#: ../src/Doc/faq/programming.rst:1122 +#: faq/programming.rst:1120 msgid "Not as such." msgstr "Pas exactement." -#: ../src/Doc/faq/programming.rst:1124 +#: faq/programming.rst:1122 msgid "" "For simple input parsing, the easiest approach is usually to split the line " "into whitespace-delimited words using the :meth:`~str.split` method of " @@ -5176,7 +5152,7 @@ msgstr "" "paramètre optionnel \"sep\" qui est utile si la ligne utilise autre chose " "que des espaces comme séparateur." -#: ../src/Doc/faq/programming.rst:1130 +#: faq/programming.rst:1128 #, fuzzy msgid "" "For more complicated input parsing, regular expressions are more powerful " @@ -5185,7 +5161,7 @@ msgstr "" "Pour les analyses plus compliquées, les expressions rationnelles sont plus " "puissantes que la fonction `sscanf` de C et mieux adaptées à la tâche." -#: ../src/Doc/faq/programming.rst:1135 +#: faq/programming.rst:1133 #, fuzzy msgid "" "What does 'UnicodeError: ASCII [decoding,encoding] error: ordinal not in " @@ -5194,14 +5170,14 @@ msgstr "" "Que signifient les erreurs 'UnicodeDecodeError' ou 'UnicodeEncodeError'?" # d32100f5f3e241519f579f93e95f5a43 -#: ../src/Doc/faq/programming.rst:1137 +#: faq/programming.rst:1135 msgid "" "This error indicates that your Python installation can handle only 7-bit " "ASCII strings. There are a couple ways to fix or work around the problem." msgstr "" # 1c12ed114b5d49e19257a764fd59e9ef -#: ../src/Doc/faq/programming.rst:1140 +#: faq/programming.rst:1138 msgid "" "If your programs must handle data in arbitrary character set encodings, the " "environment the application runs in will generally identify the encoding of " @@ -5213,14 +5189,14 @@ msgid "" msgstr "" # 0a0a8bd0d96c44e98289983f8156d4cc -#: ../src/Doc/faq/programming.rst:1150 +#: faq/programming.rst:1148 msgid "" "will return a Unicode object. If the data is not correctly encoded as " "UTF-8, the above call will raise a :exc:`UnicodeError` exception." msgstr "" # c23fedd940ec4113a5408e1bd9df81a8 -#: ../src/Doc/faq/programming.rst:1153 +#: faq/programming.rst:1151 msgid "" "If you only want strings converted to Unicode which have non-ASCII data, you " "can try converting them first assuming an ASCII encoding, and then generate " @@ -5228,7 +5204,7 @@ msgid "" msgstr "" # 44c53b389d894ef996a351e4c5469ce3 -#: ../src/Doc/faq/programming.rst:1165 +#: faq/programming.rst:1163 msgid "" "It's possible to set a default encoding in a file called ``sitecustomize." "py`` that's part of the Python library. However, this isn't recommended " @@ -5237,22 +5213,22 @@ msgid "" msgstr "" # b60213029b4c4e27a28d9f82396f65dc -#: ../src/Doc/faq/programming.rst:1170 +#: faq/programming.rst:1168 msgid "" "Note that on Windows, there is an encoding known as \"mbcs\", which uses an " "encoding specific to your current locale. In many cases, and particularly " "when working with COM, this may be an appropriate default encoding to use." msgstr "" -#: ../src/Doc/faq/programming.rst:1176 +#: faq/programming.rst:1174 msgid "Sequences (Tuples/Lists)" msgstr "Sequences (Tuples/Lists)" -#: ../src/Doc/faq/programming.rst:1179 +#: faq/programming.rst:1177 msgid "How do I convert between tuples and lists?" msgstr "Comment convertir les listes en tuples et inversement?" -#: ../src/Doc/faq/programming.rst:1181 +#: faq/programming.rst:1179 msgid "" "The type constructor ``tuple(seq)`` converts any sequence (actually, any " "iterable) into a tuple with the same items in the same order." @@ -5260,7 +5236,7 @@ msgstr "" "Le constructeur de type ``tuple(seq)`` convertit toute séquence (en fait " "tout itérable) en un tuple avec les mêmes éléments dans le même ordre…" -#: ../src/Doc/faq/programming.rst:1184 +#: faq/programming.rst:1182 msgid "" "For example, ``tuple([1, 2, 3])`` yields ``(1, 2, 3)`` and ``tuple('abc')`` " "yields ``('a', 'b', 'c')``. If the argument is a tuple, it does not make a " @@ -5272,7 +5248,7 @@ msgstr "" "copie, mais renvoi le même objet, ce qui en fait un fonction économique à " "appeler quand vous ne savez pas si votre objet est déjà un tulpe." -#: ../src/Doc/faq/programming.rst:1189 +#: faq/programming.rst:1187 msgid "" "The type constructor ``list(seq)`` converts any sequence or iterable into a " "list with the same items in the same order. For example, ``list((1, 2, " @@ -5285,11 +5261,11 @@ msgstr "" "``['a','b','c']``. Si l'argument est une liste, il retourne une copie, de la " "même façon que ``seq[:]``." -#: ../src/Doc/faq/programming.rst:1196 +#: faq/programming.rst:1194 msgid "What's a negative index?" msgstr "Qu'est-ce qu'un indexe négatif?" -#: ../src/Doc/faq/programming.rst:1198 +#: faq/programming.rst:1196 msgid "" "Python sequences are indexed with positive numbers and negative numbers. " "For positive numbers 0 is the first index 1 is the second index and so " @@ -5303,7 +5279,7 @@ msgstr "" "index, -2 est le pénultième (avant dernier), et ainsi de suite. On peut " "aussi dire que ``seq[-n]`` est équivalent à ``seq[len(seq)-n]``." -#: ../src/Doc/faq/programming.rst:1203 +#: faq/programming.rst:1201 msgid "" "Using negative indices can be very convenient. For example ``S[:-1]`` is " "all of the string except for its last character, which is useful for " @@ -5314,18 +5290,18 @@ msgstr "" "qui est pratique pour retirer un caractère de fin de ligne en fin d'une " "chaine." -#: ../src/Doc/faq/programming.rst:1209 +#: faq/programming.rst:1207 msgid "How do I iterate over a sequence in reverse order?" msgstr "Comment itérer à rebours sur une séquence?" -#: ../src/Doc/faq/programming.rst:1211 +#: faq/programming.rst:1209 msgid "" "Use the :func:`reversed` built-in function, which is new in Python 2.4::" msgstr "" "Utilisez la fonction embarquée :func:`reversed`, qui est apparue en Python " "2.4::" -#: ../src/Doc/faq/programming.rst:1216 +#: faq/programming.rst:1214 msgid "" "This won't touch your original sequence, but build a new copy with reversed " "order to iterate over." @@ -5333,26 +5309,26 @@ msgstr "" "Cela ne modifiera pas votre séquence initiale, mais construira à la place " "une copie en ordre inverse pour itérer dessus." -#: ../src/Doc/faq/programming.rst:1219 +#: faq/programming.rst:1217 msgid "With Python 2.3, you can use an extended slice syntax::" msgstr "Avec Python 2.3 vous pouvez utiliser la syntaxe étendue de tranches::" -#: ../src/Doc/faq/programming.rst:1226 +#: faq/programming.rst:1224 msgid "How do you remove duplicates from a list?" msgstr "Comment retirer les doublons d'une liste?" -#: ../src/Doc/faq/programming.rst:1228 +#: faq/programming.rst:1226 msgid "See the Python Cookbook for a long discussion of many ways to do this:" msgstr "" "Lisez le Python Cookbook pour trouver une longue discussion sur les " "nombreuses façons de faire cela:" -#: ../src/Doc/faq/programming.rst:1230 +#: faq/programming.rst:1228 #, fuzzy msgid "http://code.activestate.com/recipes/52560/" msgstr "http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/52560" -#: ../src/Doc/faq/programming.rst:1232 +#: faq/programming.rst:1230 msgid "" "If you don't mind reordering the list, sort it and then scan from the end of " "the list, deleting duplicates as you go::" @@ -5361,7 +5337,7 @@ msgstr "" "celle ci, puis parcourez la d'un bout à l'autre, en supprimant les doublons " "trouvés en chemin::" -#: ../src/Doc/faq/programming.rst:1244 +#: faq/programming.rst:1242 msgid "" "If all elements of the list may be used as dictionary keys (i.e. they are " "all hashable) this is often faster ::" @@ -5370,11 +5346,11 @@ msgstr "" "dictionnaire (cad, elles sont toutes hashables) ceci est souvent plus " "rapide::" -#: ../src/Doc/faq/programming.rst:1252 +#: faq/programming.rst:1250 msgid "In Python 2.5 and later, the following is possible instead::" msgstr "En Python 2.5 et suivant, la forme suivante est possible à la place::" -#: ../src/Doc/faq/programming.rst:1256 +#: faq/programming.rst:1254 msgid "" "This converts the list into a set, thereby removing duplicates, and then " "back into a list." @@ -5382,15 +5358,15 @@ msgstr "" "Ceci convertis la liste en un ensemble, ce qui supprime automatiquement les " "doublons, puis la transforme à nouveau en liste." -#: ../src/Doc/faq/programming.rst:1261 +#: faq/programming.rst:1259 msgid "How do you make an array in Python?" msgstr "Comment construire un tableau en Python?" -#: ../src/Doc/faq/programming.rst:1263 +#: faq/programming.rst:1261 msgid "Use a list::" msgstr "Utilisez une liste::" -#: ../src/Doc/faq/programming.rst:1267 +#: faq/programming.rst:1265 msgid "" "Lists are equivalent to C or Pascal arrays in their time complexity; the " "primary difference is that a Python list can contain objects of many " @@ -5400,7 +5376,7 @@ msgstr "" "principale différence est qu'une liste Python peut contenir des objets de " "différents types." -#: ../src/Doc/faq/programming.rst:1270 +#: faq/programming.rst:1268 msgid "" "The ``array`` module also provides methods for creating arrays of fixed " "types with compact representations, but they are slower to index than " @@ -5413,14 +5389,14 @@ msgstr "" "fournissent différentes structures de types tableaux, avec des " "caractéristiques différentes." -#: ../src/Doc/faq/programming.rst:1275 +#: faq/programming.rst:1273 msgid "" "To get Lisp-style linked lists, you can emulate cons cells using tuples::" msgstr "" "Pour obtenir des listes chainées de type Lisp, vous pouvez émuler les \"cons " "cells\" en utilisant des tuples::" -#: ../src/Doc/faq/programming.rst:1279 +#: faq/programming.rst:1277 msgid "" "If mutability is desired, you could use lists instead of tuples. Here the " "analogue of lisp car is ``lisp_list[0]`` and the analogue of cdr is " @@ -5433,26 +5409,26 @@ msgstr "" "ceci que si vous êtes réellement sûr d'en avoir besoin, cette méthode est en " "générale bien plus lente que les listes Python." -#: ../src/Doc/faq/programming.rst:1286 +#: faq/programming.rst:1286 msgid "How do I create a multidimensional list?" msgstr "Comment puis-je créer une liste à plusieurs dimensions?" -#: ../src/Doc/faq/programming.rst:1288 +#: faq/programming.rst:1288 msgid "You probably tried to make a multidimensional array like this::" msgstr "" "Vous avez probablement essayé de créer une liste à plusieurs dimensions de " "cette façon::" -#: ../src/Doc/faq/programming.rst:1292 +#: faq/programming.rst:1292 msgid "This looks correct if you print it::" msgstr "Cela semble correct quand vous essayer de l'afficher::" -#: ../src/Doc/faq/programming.rst:1297 +#: faq/programming.rst:1297 msgid "But when you assign a value, it shows up in multiple places:" msgstr "" "Mais quand vous assignez une valeur, elle apparait en de multiples endroits::" -#: ../src/Doc/faq/programming.rst:1303 +#: faq/programming.rst:1303 msgid "" "The reason is that replicating a list with ``*`` doesn't create copies, it " "only creates references to the existing objects. The ``*3`` creates a list " @@ -5465,7 +5441,7 @@ msgstr "" "Un changement dans une colonne apparaîtra donc dans toutes les colonnes. Ce " "qui n'est de façon quasi certaine, pas ce que vous souhaitez." -#: ../src/Doc/faq/programming.rst:1308 +#: faq/programming.rst:1308 msgid "" "The suggested approach is to create a list of the desired length first and " "then fill in each element with a newly created list::" @@ -5473,7 +5449,7 @@ msgstr "" "L'approche suggérée est de créer une liste de la longueur désiré d'abords, " "puis de remplir tous les éléments avec une chaîne nouvellement créée." -#: ../src/Doc/faq/programming.rst:1315 +#: faq/programming.rst:1315 msgid "" "This generates a list containing 3 different lists of length two. You can " "also use a list comprehension::" @@ -5481,7 +5457,7 @@ msgstr "" "Cette liste générée contient trois listes différentes de longueur deux. Vous " "pouvez aussi utilisez la notation de compréhension de listes." -#: ../src/Doc/faq/programming.rst:1321 +#: faq/programming.rst:1321 #, fuzzy msgid "" "Or, you can use an extension that provides a matrix datatype; `Numeric " @@ -5490,27 +5466,27 @@ msgstr "" "Ou, vous pouvez utiliser une extension qui fournis un type de donnée de type " "matrice; `Numeric Python `_ étant le plus connu." -#: ../src/Doc/faq/programming.rst:1326 +#: faq/programming.rst:1326 msgid "How do I apply a method to a sequence of objects?" msgstr "Comment appliquer une méthode à une séquence d'objets?" -#: ../src/Doc/faq/programming.rst:1328 +#: faq/programming.rst:1328 msgid "Use a list comprehension::" msgstr "Utilisez une compréhension de liste::" # b9679b4f562b436b813e6240782d1e63 -#: ../src/Doc/faq/programming.rst:1332 +#: faq/programming.rst:1332 msgid "More generically, you can try the following function::" msgstr "" # 5a0eb6dede2647bdac746cbc48c5eba5 -#: ../src/Doc/faq/programming.rst:1342 +#: faq/programming.rst:1342 msgid "" "Why does a_tuple[i] += ['item'] raise an exception when the addition works?" msgstr "" # 8e31dcde6e1f4ce3b7c3c4effef19a96 -#: ../src/Doc/faq/programming.rst:1344 +#: faq/programming.rst:1344 msgid "" "This is because of a combination of the fact that augmented assignment " "operators are *assignment* operators, and the difference between mutable and " @@ -5518,20 +5494,20 @@ msgid "" msgstr "" # 18c8244bc189403c8895afe6d77cc812 -#: ../src/Doc/faq/programming.rst:1348 +#: faq/programming.rst:1348 msgid "" "This discussion applies in general when augmented assignment operators are " "applied to elements of a tuple that point to mutable objects, but we'll use " "a ``list`` and ``+=`` as our exemplar." msgstr "" -#: ../src/Doc/faq/programming.rst:1352 +#: faq/programming.rst:1352 #, fuzzy msgid "If you wrote::" msgstr "In C++ you'd write" # cffe9637e54d476794eb875231ac036a -#: ../src/Doc/faq/programming.rst:1360 +#: faq/programming.rst:1360 msgid "" "The reason for the exception should be immediately clear: ``1`` is added to " "the object ``a_tuple[0]`` points to (``1``), producing the result object, " @@ -5541,33 +5517,33 @@ msgid "" msgstr "" # 8dcb87ef61454fadbf4fc78f068e58c7 -#: ../src/Doc/faq/programming.rst:1366 +#: faq/programming.rst:1366 msgid "" "Under the covers, what this augmented assignment statement is doing is " "approximately this::" msgstr "" # 04515ebb67074e5193bcbe4a00b2bd91 -#: ../src/Doc/faq/programming.rst:1375 +#: faq/programming.rst:1375 msgid "" "It is the assignment part of the operation that produces the error, since a " "tuple is immutable." msgstr "" # 22ab6008a94a4d6495c88e57365e7312 -#: ../src/Doc/faq/programming.rst:1378 +#: faq/programming.rst:1378 msgid "When you write something like::" msgstr "" # 9b46cde118ca40508fedaacc63714819 -#: ../src/Doc/faq/programming.rst:1386 +#: faq/programming.rst:1386 msgid "" "The exception is a bit more surprising, and even more surprising is the fact " "that even though there was an error, the append worked::" msgstr "" # c28e7f2a9c4c4302955de0232c836eda -#: ../src/Doc/faq/programming.rst:1392 +#: faq/programming.rst:1392 msgid "" "To see why this happens, you need to know that (a) if an object implements " "an ``__iadd__`` magic method, it gets called when the ``+=`` augmented " @@ -5578,12 +5554,12 @@ msgid "" msgstr "" # ced4b3cf4f0946c1a201c57c5e321cf3 -#: ../src/Doc/faq/programming.rst:1404 +#: faq/programming.rst:1404 msgid "This is equivalent to::" msgstr "" # 785acb48819d476eb6b4f321f4c38644 -#: ../src/Doc/faq/programming.rst:1409 +#: faq/programming.rst:1409 msgid "" "The object pointed to by a_list has been mutated, and the pointer to the " "mutated object is assigned back to ``a_list``. The end result of the " @@ -5592,12 +5568,12 @@ msgid "" msgstr "" # 57b86ec3f01146199872ad5223ff75ac -#: ../src/Doc/faq/programming.rst:1414 +#: faq/programming.rst:1414 msgid "Thus, in our tuple example what is happening is equivalent to::" msgstr "" # 9885a85fc7e943cebf75939e62e69ff6 -#: ../src/Doc/faq/programming.rst:1422 +#: faq/programming.rst:1422 msgid "" "The ``__iadd__`` succeeds, and thus the list is extended, but even though " "``result`` points to the same object that ``a_tuple[0]`` already points to, " @@ -5605,17 +5581,17 @@ msgid "" "immutable." msgstr "" -#: ../src/Doc/faq/programming.rst:1428 +#: faq/programming.rst:1428 msgid "Dictionaries" msgstr "Dictionnaires" -#: ../src/Doc/faq/programming.rst:1431 +#: faq/programming.rst:1431 msgid "How can I get a dictionary to display its keys in a consistent order?" msgstr "" "Comment puis-je faire afficher les éléments d'un dictionnaire dans un ordre " "consistant?" -#: ../src/Doc/faq/programming.rst:1433 +#: faq/programming.rst:1433 msgid "" "You can't. Dictionaries store their keys in an unpredictable order, so the " "display order of a dictionary's elements will be similarly unpredictable." @@ -5624,7 +5600,7 @@ msgstr "" "non prévisible, l'ordre d'affichage des éléments d'un dictionnaire sera donc " "de la même façon imprévisible." -#: ../src/Doc/faq/programming.rst:1436 +#: faq/programming.rst:1436 msgid "" "This can be frustrating if you want to save a printable version to a file, " "make some changes and then compare it with some other printed dictionary. " @@ -5637,7 +5613,7 @@ msgstr "" "afficher joliement le dictionnaire; les éléments seront présentés triés par " "clés." -#: ../src/Doc/faq/programming.rst:1441 +#: faq/programming.rst:1441 msgid "" "A more complicated solution is to subclass ``dict`` to create a " "``SortedDict`` class that prints itself in a predictable order. Here's one " @@ -5647,7 +5623,7 @@ msgstr "" "classe``SorterDict`` qui s'affiche de façon prévisible. Voici une " "implémentation simple d'une telle classe::" -#: ../src/Doc/faq/programming.rst:1453 +#: faq/programming.rst:1453 msgid "" "This will work for many common situations you might encounter, though it's " "far from a perfect solution. The largest flaw is that if some values in the " @@ -5660,7 +5636,7 @@ msgstr "" "des dictionnaire, alors elles ne seront pas présentées dans un ordre " "particulier." -#: ../src/Doc/faq/programming.rst:1460 +#: faq/programming.rst:1460 msgid "" "I want to do a complicated sort: can you do a Schwartzian Transform in " "Python?" @@ -5668,7 +5644,7 @@ msgstr "" "Je souhaite faire un tri compliqué: peut on faire une transformation de " "Schwartz en Python?" -#: ../src/Doc/faq/programming.rst:1462 +#: faq/programming.rst:1462 msgid "" "The technique, attributed to Randal Schwartz of the Perl community, sorts " "the elements of a list by a metric which maps each element to its \"sort " @@ -5679,7 +5655,7 @@ msgstr "" "une \"valeur de tri\". En Python, utilisez simplement l'argument ``key`` de " "la méthode ``sort``::" -#: ../src/Doc/faq/programming.rst:1469 +#: faq/programming.rst:1469 msgid "" "The ``key`` argument is new in Python 2.4, for older versions this kind of " "sorting is quite simple to do with list comprehensions. To sort a list of " @@ -5690,7 +5666,7 @@ msgstr "" "compréhensions de liste. Pour trier une liste de chaines par leur valeur en " "majuscule on peut faire::" -#: ../src/Doc/faq/programming.rst:1477 +#: faq/programming.rst:1477 msgid "" "To sort by the integer value of a subfield extending from positions 10-15 in " "each string::" @@ -5698,13 +5674,13 @@ msgstr "" "Pour trier par la valeur d'un sous-champ allant des index 10 à 15 dans " "chaque chaine chaine::" -#: ../src/Doc/faq/programming.rst:1484 +#: faq/programming.rst:1484 #, fuzzy msgid "Note that Isorted may also be computed by ::" msgstr "" "Pour les versions antérieures à 3.0, Isorted peut également être calculé par:" -#: ../src/Doc/faq/programming.rst:1495 +#: faq/programming.rst:1495 msgid "" "but since this method calls ``intfield()`` many times for each element of L, " "it is slower than the Schwartzian Transform." @@ -5712,12 +5688,12 @@ msgstr "" "mais du fait que cette méthode appelle `` intfield () `` plusieurs fois pour " "chaque élément de L, elle est plus lente que la transformée de Schwartz." -#: ../src/Doc/faq/programming.rst:1500 +#: faq/programming.rst:1500 msgid "How can I sort one list by values from another list?" msgstr "" "Comment puis-je trier une liste en fonction des valeurs d'une autre liste?" -#: ../src/Doc/faq/programming.rst:1502 +#: faq/programming.rst:1502 #, fuzzy msgid "" "Merge them into a single list of tuples, sort the resulting list, and then " @@ -5726,12 +5702,12 @@ msgstr "" "Fusionnez les dans un itérateur de tuples, trier la liste obtenue, puis " "choisissez l'élément que vous voulez. ::" -#: ../src/Doc/faq/programming.rst:1515 +#: faq/programming.rst:1515 #, fuzzy msgid "An alternative for the last step is::" msgstr "Une alternative pour la dernière étape est la suivante::" -#: ../src/Doc/faq/programming.rst:1520 +#: faq/programming.rst:1520 msgid "" "If you find this more legible, you might prefer to use this instead of the " "final list comprehension. However, it is almost twice as slow for long " @@ -5750,15 +5726,15 @@ msgstr "" "exige une recherche d'attribut supplémentaire, et enfin, tous ces appels de " "fonction impactent la vitesse d'exécution." -#: ../src/Doc/faq/programming.rst:1530 +#: faq/programming.rst:1530 msgid "Objects" msgstr "Objets" -#: ../src/Doc/faq/programming.rst:1533 +#: faq/programming.rst:1533 msgid "What is a class?" msgstr "Qu'est-ce qu'une classe?" -#: ../src/Doc/faq/programming.rst:1535 +#: faq/programming.rst:1535 msgid "" "A class is the particular object type created by executing a class " "statement. Class objects are used as templates to create instance objects, " @@ -5770,7 +5746,7 @@ msgstr "" "créer des objets, qui incarnent à la fois les données (attributs) et le code " "(méthodes) spécifiques à un type de données." -#: ../src/Doc/faq/programming.rst:1539 +#: faq/programming.rst:1539 msgid "" "A class can be based on one or more other classes, called its base " "class(es). It then inherits the attributes and methods of its base classes. " @@ -5787,11 +5763,11 @@ msgstr "" "classes telles que ``MboxMailbox``, ``MaildirMailbox``, ``OutlookMailbox`` " "qui gèrent les différents formats de boîtes aux lettres spécifiques." -#: ../src/Doc/faq/programming.rst:1548 +#: faq/programming.rst:1548 msgid "What is a method?" msgstr "Qu'est-ce qu'une méthode?" -#: ../src/Doc/faq/programming.rst:1550 +#: faq/programming.rst:1550 msgid "" "A method is a function on some object ``x`` that you normally call as ``x." "name(arguments...)``. Methods are defined as functions inside the class " @@ -5801,11 +5777,11 @@ msgstr "" "``x.name(arguments…)``. Les méthodes sont définies comme des fonctions à " "l'intérieur de la définition de classe::" -#: ../src/Doc/faq/programming.rst:1560 +#: faq/programming.rst:1560 msgid "What is self?" msgstr "Qu'est-ce que self?" -#: ../src/Doc/faq/programming.rst:1562 +#: faq/programming.rst:1562 msgid "" "Self is merely a conventional name for the first argument of a method. A " "method defined as ``meth(self, a, b, c)`` should be called as ``x.meth(a, b, " @@ -5818,11 +5794,11 @@ msgstr "" "laquelle elle est définie, la méthode appelée considérera qu'elle est " "appelée ``meth(x, a, b, c)``." -#: ../src/Doc/faq/programming.rst:1567 +#: faq/programming.rst:1567 msgid "See also :ref:`why-self`." msgstr "Voir aussi: ref:`why-self`." -#: ../src/Doc/faq/programming.rst:1571 +#: faq/programming.rst:1571 msgid "" "How do I check if an object is an instance of a given class or of a subclass " "of it?" @@ -5830,7 +5806,7 @@ msgstr "" "Comment puis-je vérifier si un objet est une instance d'une classe donnée ou " "d'une sous-classe de celui-ci?" -#: ../src/Doc/faq/programming.rst:1573 +#: faq/programming.rst:1573 #, fuzzy msgid "" "Use the built-in function ``isinstance(obj, cls)``. You can check if an " @@ -5846,7 +5822,7 @@ msgstr "" "un objet est l'un des types intégrés à Python, par exemple, ``IsInstance " "(obj, str) isInstance`` ou ``(obj, (int, float, complexes ))``." -#: ../src/Doc/faq/programming.rst:1579 +#: faq/programming.rst:1579 msgid "" "Note that most programs do not use :func:`isinstance` on user-defined " "classes very often. If you are developing the classes yourself, a more " @@ -5863,7 +5839,7 @@ msgstr "" "chose de différent en fonction de sa classe. Par exemple, si vous avez une " "fonction qui fait quelque chose::" -#: ../src/Doc/faq/programming.rst:1593 +#: faq/programming.rst:1593 msgid "" "A better approach is to define a ``search()`` method on all the classes and " "just call it::" @@ -5871,11 +5847,11 @@ msgstr "" "Une meilleure approche est de définir une méthode ``search()`` sur toutes " "les classes et qu'il suffit d'appeler::" -#: ../src/Doc/faq/programming.rst:1608 +#: faq/programming.rst:1608 msgid "What is delegation?" msgstr "Qu'est-ce que la délégation?" -#: ../src/Doc/faq/programming.rst:1610 +#: faq/programming.rst:1610 msgid "" "Delegation is an object oriented technique (also called a design pattern). " "Let's say you have an object ``x`` and want to change the behaviour of just " @@ -5890,7 +5866,7 @@ msgstr "" "vous intéresse dans l'évolution et les délégués de toutes les autres " "méthodes la méthode correspondante de ``x``." -#: ../src/Doc/faq/programming.rst:1616 +#: faq/programming.rst:1616 msgid "" "Python programmers can easily implement delegation. For example, the " "following class implements a class that behaves like a file but converts all " @@ -5900,7 +5876,7 @@ msgstr "" "Par exemple, la classe suivante implémente une classe qui se comporte comme " "un fichier, mais convertit toutes les données écrites en majuscules:" -#: ../src/Doc/faq/programming.rst:1631 +#: faq/programming.rst:1631 msgid "" "Here the ``UpperOut`` class redefines the ``write()`` method to convert the " "argument string to uppercase before calling the underlying ``self.__outfile." @@ -5916,7 +5892,7 @@ msgstr "" "``__getattr__``, consulter: ref:`the language reference ` " "pour plus d'informations sur le contrôle d'accès d'attribut." -#: ../src/Doc/faq/programming.rst:1638 +#: faq/programming.rst:1638 msgid "" "Note that for more general cases delegation can get trickier. When " "attributes must be set as well as retrieved, the class must define a :meth:" @@ -5930,7 +5906,7 @@ msgstr "" "aussi, et il doit le faire avec soin. La mise en œuvre basique de la " "méthode :meth:``__setattr__`` est à peu près équivalent à ce qui suit:" -#: ../src/Doc/faq/programming.rst:1649 +#: faq/programming.rst:1649 msgid "" "Most :meth:`__setattr__` implementations must modify ``self.__dict__`` to " "store local state for self without causing an infinite recursion." @@ -5939,7 +5915,7 @@ msgstr "" "``self.__dict__`` pour stocker l'état locale de self sans provoquer une " "récursion infinie." -#: ../src/Doc/faq/programming.rst:1654 +#: faq/programming.rst:1654 msgid "" "How do I call a method defined in a base class from a derived class that " "overrides it?" @@ -5947,13 +5923,13 @@ msgstr "" "Comment appeler une méthode définie dans une classe de base depuis une " "classe dérivée qui la surcharge?" -#: ../src/Doc/faq/programming.rst:1656 +#: faq/programming.rst:1656 #, fuzzy msgid "" "If you're using new-style classes, use the built-in :func:`super` function::" msgstr "Utilisez la fonction built-in :func:``super``::" -#: ../src/Doc/faq/programming.rst:1662 +#: faq/programming.rst:1662 #, fuzzy msgid "" "If you're using classic classes: For a class definition such as ``class " @@ -5969,13 +5945,13 @@ msgstr "" "Ici, ``Base.meth`` est une méthode non liée, vous devez donc fournir " "l'argument ``self``." -#: ../src/Doc/faq/programming.rst:1670 +#: faq/programming.rst:1670 msgid "How can I organize my code to make it easier to change the base class?" msgstr "" "Comment puis-je organiser mon code pour permettre de changer la classe de " "base plus facilement?" -#: ../src/Doc/faq/programming.rst:1672 +#: faq/programming.rst:1672 msgid "" "You could define an alias for the base class, assign the real base class to " "it before your class definition, and use the alias throughout your class. " @@ -5991,13 +5967,13 @@ msgstr "" "voulez décider dynamiquement (par exemple en fonction de la disponibilité " "des ressources) la classe de base à utiliser. Exemple::" -#: ../src/Doc/faq/programming.rst:1687 +#: faq/programming.rst:1687 msgid "How do I create static class data and static class methods?" msgstr "" "Comment puis-je créer des données statiques de classe et des méthodes " "statiques de classe?" -#: ../src/Doc/faq/programming.rst:1689 +#: faq/programming.rst:1689 msgid "" "Both static data and static methods (in the sense of C++ or Java) are " "supported in Python." @@ -6005,7 +5981,7 @@ msgstr "" "Tant les données statiques que les méthodes statiques (dans le sens de C + + " "ou Java) sont pris en charge en Python." -#: ../src/Doc/faq/programming.rst:1692 +#: faq/programming.rst:1692 msgid "" "For static data, simply define a class attribute. To assign a new value to " "the attribute, you have to explicitly use the class name in the assignment::" @@ -6014,7 +5990,7 @@ msgstr "" "attribuer une nouvelle valeur à l'attribut, vous devez explicitement " "utiliser le nom de classe dans l'affectation:" -#: ../src/Doc/faq/programming.rst:1704 +#: faq/programming.rst:1704 msgid "" "``c.count`` also refers to ``C.count`` for any ``c`` such that " "``isinstance(c, C)`` holds, unless overridden by ``c`` itself or by some " @@ -6025,7 +6001,7 @@ msgstr "" "une classe sur le chemin de recherche de classe de base de ``c.__class__`` " "jusqu'à ``C``." -#: ../src/Doc/faq/programming.rst:1708 +#: faq/programming.rst:1708 msgid "" "Caution: within a method of C, an assignment like ``self.count = 42`` " "creates a new and unrelated instance named \"count\" in ``self``'s own " @@ -6038,15 +6014,15 @@ msgstr "" "statique de classe doit toujours spécifier la classe que l'on soit à " "l'intérieur d'une méthode ou non:" -#: ../src/Doc/faq/programming.rst:1715 +#: faq/programming.rst:1715 msgid "Static methods are possible since Python 2.2::" msgstr "Les méthodes statiques sont possibles depuis Python 2.2::" -#: ../src/Doc/faq/programming.rst:1723 +#: faq/programming.rst:1723 msgid "With Python 2.4's decorators, this can also be written as ::" msgstr "Avec les décorateurs de Python 2.4, cela peut aussi s'écrire:" -#: ../src/Doc/faq/programming.rst:1731 +#: faq/programming.rst:1731 msgid "" "However, a far more straightforward way to get the effect of a static method " "is via a simple module-level function::" @@ -6054,7 +6030,7 @@ msgstr "" "Cependant, d'une manière beaucoup plus simple pour obtenir l'effet d'une " "méthode statique se fait par une simple fonction au niveau du module::" -#: ../src/Doc/faq/programming.rst:1737 +#: faq/programming.rst:1737 msgid "" "If your code is structured so as to define one class (or tightly related " "class hierarchy) per module, this supplies the desired encapsulation." @@ -6063,11 +6039,11 @@ msgstr "" "hiérarchie des classes connexes) par module, ceci fournira l'encapsulation " "souhaitée." -#: ../src/Doc/faq/programming.rst:1742 +#: faq/programming.rst:1742 msgid "How can I overload constructors (or methods) in Python?" msgstr "Comment puis-je surcharger les constructeurs (ou méthodes) en Python?" -#: ../src/Doc/faq/programming.rst:1744 +#: faq/programming.rst:1744 msgid "" "This answer actually applies to all methods, but the question usually comes " "up first in the context of constructors." @@ -6075,11 +6051,11 @@ msgstr "" "Cette réponse s'applique en fait à toutes les méthodes, mais la question " "vient généralement en premier dans le contexte des constructeurs." -#: ../src/Doc/faq/programming.rst:1747 +#: faq/programming.rst:1747 msgid "In C++ you'd write" msgstr "In C++ you'd write" -#: ../src/Doc/faq/programming.rst:1756 +#: faq/programming.rst:1756 msgid "" "In Python you have to write a single constructor that catches all cases " "using default arguments. For example::" @@ -6087,29 +6063,29 @@ msgstr "" "En Python, vous devez écrire un constructeur unique qui considère tous les " "cas en utilisant des arguments par défaut. Par exemple::" -#: ../src/Doc/faq/programming.rst:1766 +#: faq/programming.rst:1766 msgid "This is not entirely equivalent, but close enough in practice." msgstr "" "Ce n'est pas tout à fait équivalent, mais suffisamment proche dans la " "pratique." -#: ../src/Doc/faq/programming.rst:1768 +#: faq/programming.rst:1768 msgid "You could also try a variable-length argument list, e.g. ::" msgstr "" "Vous pouvez aussi utiliser une liste d'arguments de longueur variable, par " "exemple ::" -#: ../src/Doc/faq/programming.rst:1773 +#: faq/programming.rst:1773 msgid "The same approach works for all method definitions." msgstr "La même approche fonctionne pour toutes les définitions de méthode." -#: ../src/Doc/faq/programming.rst:1777 +#: faq/programming.rst:1777 msgid "I try to use __spam and I get an error about _SomeClassName__spam." msgstr "" "J'essaie d'utiliser __spam et j'obtiens une erreur à propos de " "_SomeClassName__spam." -#: ../src/Doc/faq/programming.rst:1779 +#: faq/programming.rst:1779 msgid "" "Variable names with double leading underscores are \"mangled\" to provide a " "simple but effective way to define class private variables. Any identifier " @@ -6125,7 +6101,7 @@ msgstr "" "remplacé par ``_classname__spam``, où ``classname`` est le nom de la classe " "en cours avec les traits de soulignement dépouillés." -#: ../src/Doc/faq/programming.rst:1785 +#: faq/programming.rst:1785 msgid "" "This doesn't guarantee privacy: an outside user can still deliberately " "access the \"_classname__spam\" attribute, and private values are visible in " @@ -6138,17 +6114,17 @@ msgstr "" "programmeurs Python ne prennent jamais la peine d'utiliser des noms de " "variable privée." -#: ../src/Doc/faq/programming.rst:1792 +#: faq/programming.rst:1792 msgid "My class defines __del__ but it is not called when I delete the object." msgstr "" "Ma classe définit __del__ mais il n'est pas appelé lorsque je supprime " "l'objet." -#: ../src/Doc/faq/programming.rst:1794 +#: faq/programming.rst:1794 msgid "There are several possible reasons for this." msgstr "Il y a plusieurs raisons possibles pour cela." -#: ../src/Doc/faq/programming.rst:1796 +#: faq/programming.rst:1796 msgid "" "The del statement does not necessarily call :meth:`__del__` -- it simply " "decrements the object's reference count, and if this reaches zero :meth:" @@ -6158,7 +6134,7 @@ msgstr "" "simplement le compteur de références de l'objet, et si celui ci arrive à " "zéro: meth: `__del__` est appelée." -#: ../src/Doc/faq/programming.rst:1800 +#: faq/programming.rst:1800 msgid "" "If your data structures contain circular links (e.g. a tree where each child " "has a parent reference and each parent has a list of children) the reference " @@ -6172,7 +6148,7 @@ msgid "" "cases where objects will never be collected." msgstr "" -#: ../src/Doc/faq/programming.rst:1811 +#: faq/programming.rst:1811 msgid "" "Despite the cycle collector, it's still a good idea to define an explicit " "``close()`` method on objects to be called whenever you're done with them. " @@ -6182,7 +6158,7 @@ msgid "" "once for the same object." msgstr "" -#: ../src/Doc/faq/programming.rst:1818 +#: faq/programming.rst:1818 msgid "" "Another way to avoid cyclical references is to use the :mod:`weakref` " "module, which allows you to point to objects without incrementing their " @@ -6191,7 +6167,7 @@ msgid "" msgstr "" # b4b0759b65604b06bde8e32f69de4d3b -#: ../src/Doc/faq/programming.rst:1823 +#: faq/programming.rst:1823 msgid "" "If the object has ever been a local variable in a function that caught an " "expression in an except clause, chances are that a reference to the object " @@ -6200,17 +6176,17 @@ msgid "" "the last recorded exception." msgstr "" -#: ../src/Doc/faq/programming.rst:1829 +#: faq/programming.rst:1829 msgid "" "Finally, if your :meth:`__del__` method raises an exception, a warning " "message is printed to :data:`sys.stderr`." msgstr "" -#: ../src/Doc/faq/programming.rst:1834 +#: faq/programming.rst:1834 msgid "How do I get a list of all instances of a given class?" msgstr "" -#: ../src/Doc/faq/programming.rst:1836 +#: faq/programming.rst:1836 msgid "" "Python does not keep track of all instances of a class (or of a built-in " "type). You can program the class's constructor to keep track of all " @@ -6218,12 +6194,12 @@ msgid "" msgstr "" # cf90e9f3b4064c549dfbec4909638712 -#: ../src/Doc/faq/programming.rst:1842 +#: faq/programming.rst:1842 msgid "Why does the result of ``id()`` appear to be not unique?" msgstr "" # f61b99b4126f49fe955ab0fa86ba17b4 -#: ../src/Doc/faq/programming.rst:1844 +#: faq/programming.rst:1844 msgid "" "The :func:`id` builtin returns an integer that is guaranteed to be unique " "during the lifetime of the object. Since in CPython, this is the object's " @@ -6233,7 +6209,7 @@ msgid "" msgstr "" # b3a195c4502f46088e88298fe469109c -#: ../src/Doc/faq/programming.rst:1855 +#: faq/programming.rst:1855 msgid "" "The two ids belong to different integer objects that are created before, and " "deleted immediately after execution of the ``id()`` call. To be sure that " @@ -6241,22 +6217,22 @@ msgid "" "reference to the object:" msgstr "" -#: ../src/Doc/faq/programming.rst:1868 +#: faq/programming.rst:1868 msgid "Modules" msgstr "Modules" -#: ../src/Doc/faq/programming.rst:1871 +#: faq/programming.rst:1871 msgid "How do I create a .pyc file?" msgstr "" -#: ../src/Doc/faq/programming.rst:1873 +#: faq/programming.rst:1873 msgid "" "When a module is imported for the first time (or when the source is more " "recent than the current compiled file) a ``.pyc`` file containing the " "compiled code should be created in the same directory as the ``.py`` file." msgstr "" -#: ../src/Doc/faq/programming.rst:1877 +#: faq/programming.rst:1877 msgid "" "One reason that a ``.pyc`` file may not be created is permissions problems " "with the directory. This can happen, for example, if you develop as one user " @@ -6267,7 +6243,7 @@ msgid "" msgstr "" # 03d92f68c7e349ccabb520f05c0d88d4 -#: ../src/Doc/faq/programming.rst:1884 +#: faq/programming.rst:1884 msgid "" "Running Python on a top level script is not considered an import and no ``." "pyc`` will be created. For example, if you have a top-level module ``foo." @@ -6277,27 +6253,27 @@ msgid "" msgstr "" # 8b7c0689fc08464b8f5080f3fc41c75b -#: ../src/Doc/faq/programming.rst:1890 +#: faq/programming.rst:1890 msgid "" "If you need to create ``foo.pyc`` -- that is, to create a ``.pyc`` file for " "a module that is not imported -- you can, using the :mod:`py_compile` and :" "mod:`compileall` modules." msgstr "" -#: ../src/Doc/faq/programming.rst:1894 +#: faq/programming.rst:1894 msgid "" "The :mod:`py_compile` module can manually compile any module. One way is to " "use the ``compile()`` function in that module interactively::" msgstr "" # 6d7165204d3741dfa3edb6045c2e4ab9 -#: ../src/Doc/faq/programming.rst:1900 +#: faq/programming.rst:1900 msgid "" "This will write the ``.pyc`` to the same location as ``foo.py`` (or you can " "override that with the optional parameter ``cfile``)." msgstr "" -#: ../src/Doc/faq/programming.rst:1903 +#: faq/programming.rst:1903 msgid "" "You can also automatically compile all files in a directory or directories " "using the :mod:`compileall` module. You can do it from the shell prompt by " @@ -6305,11 +6281,11 @@ msgid "" "Python files to compile::" msgstr "" -#: ../src/Doc/faq/programming.rst:1912 +#: faq/programming.rst:1912 msgid "How do I find the current module name?" msgstr "" -#: ../src/Doc/faq/programming.rst:1914 +#: faq/programming.rst:1914 msgid "" "A module can find out its own module name by looking at the predefined " "global variable ``__name__``. If this has the value ``'__main__'``, the " @@ -6318,76 +6294,76 @@ msgid "" "only execute this code after checking ``__name__``::" msgstr "" -#: ../src/Doc/faq/programming.rst:1929 +#: faq/programming.rst:1929 msgid "How can I have modules that mutually import each other?" msgstr "" -#: ../src/Doc/faq/programming.rst:1931 +#: faq/programming.rst:1931 msgid "Suppose you have the following modules:" msgstr "" -#: ../src/Doc/faq/programming.rst:1933 +#: faq/programming.rst:1933 msgid "foo.py::" msgstr "" -#: ../src/Doc/faq/programming.rst:1938 +#: faq/programming.rst:1938 msgid "bar.py::" msgstr "" -#: ../src/Doc/faq/programming.rst:1943 +#: faq/programming.rst:1943 msgid "The problem is that the interpreter will perform the following steps:" msgstr "" -#: ../src/Doc/faq/programming.rst:1945 +#: faq/programming.rst:1945 msgid "main imports foo" msgstr "" -#: ../src/Doc/faq/programming.rst:1946 +#: faq/programming.rst:1946 msgid "Empty globals for foo are created" msgstr "" -#: ../src/Doc/faq/programming.rst:1947 +#: faq/programming.rst:1947 msgid "foo is compiled and starts executing" msgstr "" -#: ../src/Doc/faq/programming.rst:1948 +#: faq/programming.rst:1948 msgid "foo imports bar" msgstr "" -#: ../src/Doc/faq/programming.rst:1949 +#: faq/programming.rst:1949 msgid "Empty globals for bar are created" msgstr "" -#: ../src/Doc/faq/programming.rst:1950 +#: faq/programming.rst:1950 msgid "bar is compiled and starts executing" msgstr "" -#: ../src/Doc/faq/programming.rst:1951 +#: faq/programming.rst:1951 msgid "" "bar imports foo (which is a no-op since there already is a module named foo)" msgstr "" -#: ../src/Doc/faq/programming.rst:1952 +#: faq/programming.rst:1952 msgid "bar.foo_var = foo.foo_var" msgstr "" -#: ../src/Doc/faq/programming.rst:1954 +#: faq/programming.rst:1954 msgid "" "The last step fails, because Python isn't done with interpreting ``foo`` yet " "and the global symbol dictionary for ``foo`` is still empty." msgstr "" -#: ../src/Doc/faq/programming.rst:1957 +#: faq/programming.rst:1957 msgid "" "The same thing happens when you use ``import foo``, and then try to access " "``foo.foo_var`` in global code." msgstr "" -#: ../src/Doc/faq/programming.rst:1960 +#: faq/programming.rst:1960 msgid "There are (at least) three possible workarounds for this problem." msgstr "" -#: ../src/Doc/faq/programming.rst:1962 +#: faq/programming.rst:1962 msgid "" "Guido van Rossum recommends avoiding all uses of ``from import ..." "``, and placing all code inside functions. Initializations of global " @@ -6396,60 +6372,60 @@ msgid "" "``.``." msgstr "" -#: ../src/Doc/faq/programming.rst:1967 +#: faq/programming.rst:1967 msgid "" "Jim Roskind suggests performing steps in the following order in each module:" msgstr "" -#: ../src/Doc/faq/programming.rst:1969 +#: faq/programming.rst:1969 msgid "" "exports (globals, functions, and classes that don't need imported base " "classes)" msgstr "" -#: ../src/Doc/faq/programming.rst:1971 +#: faq/programming.rst:1971 msgid "``import`` statements" msgstr "" -#: ../src/Doc/faq/programming.rst:1972 +#: faq/programming.rst:1972 msgid "" "active code (including globals that are initialized from imported values)." msgstr "" -#: ../src/Doc/faq/programming.rst:1974 +#: faq/programming.rst:1974 msgid "" "van Rossum doesn't like this approach much because the imports appear in a " "strange place, but it does work." msgstr "" -#: ../src/Doc/faq/programming.rst:1977 +#: faq/programming.rst:1977 msgid "" "Matthias Urlichs recommends restructuring your code so that the recursive " "import is not necessary in the first place." msgstr "" -#: ../src/Doc/faq/programming.rst:1980 +#: faq/programming.rst:1980 msgid "These solutions are not mutually exclusive." msgstr "" -#: ../src/Doc/faq/programming.rst:1984 +#: faq/programming.rst:1984 msgid "__import__('x.y.z') returns ; how do I get z?" msgstr "" # e48fce842ecb4de4838850cae5fbd306 -#: ../src/Doc/faq/programming.rst:1986 +#: faq/programming.rst:1986 msgid "" "Consider using the convenience function :func:`~importlib.import_module` " "from :mod:`importlib` instead::" msgstr "" -#: ../src/Doc/faq/programming.rst:1993 +#: faq/programming.rst:1993 msgid "" "When I edit an imported module and reimport it, the changes don't show up. " "Why does this happen?" msgstr "" -#: ../src/Doc/faq/programming.rst:1995 +#: faq/programming.rst:1995 msgid "" "For reasons of efficiency as well as consistency, Python only reads the " "module file on the first time a module is imported. If it didn't, in a " @@ -6458,13 +6434,13 @@ msgid "" "rereading of a changed module, do this::" msgstr "" -#: ../src/Doc/faq/programming.rst:2004 +#: faq/programming.rst:2004 msgid "" "Warning: this technique is not 100% fool-proof. In particular, modules " "containing statements like ::" msgstr "" -#: ../src/Doc/faq/programming.rst:2009 +#: faq/programming.rst:2009 msgid "" "will continue to work with the old version of the imported objects. If the " "module contains class definitions, existing class instances will *not* be " @@ -6473,28 +6449,32 @@ msgid "" msgstr "" # 702dbe1732aa493f8a0b6bb56cb2522c -#: ../src/Doc/faq/programming.rst:2021 +#: faq/programming.rst:2021 msgid "" "The nature of the problem is made clear if you print out the class objects:" msgstr "" -#: ../src/Doc/faq/windows.rst:7 +#: faq/windows.rst:7 msgid "Python on Windows FAQ" msgstr "" -#: ../src/Doc/faq/windows.rst:14 +#: faq/windows.rst:14 msgid "How do I run a Python program under Windows?" msgstr "" # 53ef8c8cd2b8484c88c64aab2a4e1a36 -#: ../src/Doc/faq/windows.rst:16 +#: faq/windows.rst:16 msgid "" "This is not necessarily a straightforward question. If you are already " "familiar with running programs from the Windows command line then everything " "will seem obvious; otherwise, you might need a little more guidance." msgstr "" -#: ../src/Doc/faq/windows.rst:23 +#: faq/windows.rst:0 +msgid "|Python Development on XP|_" +msgstr "" + +#: faq/windows.rst:23 msgid "" "This series of screencasts aims to get you up and running with Python on " "Windows XP. The knowledge is distilled into 1.5 hours and will get you up " @@ -6503,7 +6483,7 @@ msgid "" msgstr "" # 9d7948e6038a4a51a4bad91ca4fc7931 -#: ../src/Doc/faq/windows.rst:32 +#: faq/windows.rst:32 msgid "" "Unless you use some sort of integrated development environment, you will end " "up *typing* Windows commands into what is variously referred to as a \"DOS " @@ -6514,13 +6494,13 @@ msgid "" "Windows \"command prompt\", which usually looks like this::" msgstr "" -#: ../src/Doc/faq/windows.rst:42 +#: faq/windows.rst:42 msgid "" "The letter may be different, and there might be other things after it, so " "you might just as easily see something like::" msgstr "" -#: ../src/Doc/faq/windows.rst:47 +#: faq/windows.rst:47 msgid "" "depending on how your computer has been set up and what else you have " "recently done with it. Once you have started such a window, you are well on " @@ -6528,7 +6508,7 @@ msgid "" msgstr "" # 6c03998a0a844db1971bea8cd63765fa -#: ../src/Doc/faq/windows.rst:51 +#: faq/windows.rst:51 msgid "" "You need to realize that your Python scripts have to be processed by another " "program called the Python *interpreter*. The interpreter reads your script, " @@ -6537,7 +6517,7 @@ msgid "" msgstr "" # 4eb0edada5ae45ad99a255b0db73a830 -#: ../src/Doc/faq/windows.rst:56 +#: faq/windows.rst:56 msgid "" "First, you need to make sure that your command window recognises the word " "\"python\" as an instruction to start the interpreter. If you have opened a " @@ -6546,11 +6526,11 @@ msgid "" msgstr "" # 4f609a87bff2442ca7cd1ff9bd7cdaf8 -#: ../src/Doc/faq/windows.rst:63 +#: faq/windows.rst:63 msgid "You should then see something like::" msgstr "" -#: ../src/Doc/faq/windows.rst:69 +#: faq/windows.rst:69 msgid "" "You have started the interpreter in \"interactive mode\". That means you can " "enter Python statements or expressions interactively and have them executed " @@ -6559,46 +6539,49 @@ msgid "" "results::" msgstr "" -#: ../src/Doc/faq/windows.rst:79 +#: faq/windows.rst:79 msgid "" "Many people use the interactive mode as a convenient yet highly programmable " -"calculator. When you want to end your interactive Python session, hold the " -"Ctrl key down while you enter a Z, then hit the \"Enter\" key to get back to " -"your Windows command prompt." +"calculator. When you want to end your interactive Python session, hold the :" +"kbd:`Ctrl` key down while you enter a :kbd:`Z`, then hit the \":kbd:`Enter`" +"\" key to get back to your Windows command prompt." msgstr "" -# 7bd42cac219b40848c7921867591430f -#: ../src/Doc/faq/windows.rst:84 +#: faq/windows.rst:84 msgid "" "You may also find that you have a Start-menu entry such as :menuselection:" "`Start --> Programs --> Python 2.7 --> Python (command line)` that results " "in you seeing the ``>>>`` prompt in a new window. If so, the window will " -"disappear after you enter the Ctrl-Z character; Windows is running a single " -"\"python\" command in the window, and closes it when you terminate the " -"interpreter." +"disappear after you enter the :kbd:`Ctrl-Z` character; Windows is running a " +"single \"python\" command in the window, and closes it when you terminate " +"the interpreter." msgstr "" -#: ../src/Doc/faq/windows.rst:90 +#: faq/windows.rst:90 msgid "" "If the ``python`` command, instead of displaying the interpreter prompt " "``>>>``, gives you a message like::" msgstr "" -#: ../src/Doc/faq/windows.rst:98 +#: faq/windows.rst:0 +msgid "|Adding Python to DOS Path|_" +msgstr "" + +#: faq/windows.rst:98 msgid "" "Python is not added to the DOS path by default. This screencast will walk " "you through the steps to add the correct entry to the `System Path`, " "allowing Python to be executed from the command-line by all users." msgstr "" -#: ../src/Doc/faq/windows.rst:111 +#: faq/windows.rst:111 msgid "" "then you need to make sure that your computer knows where to find the Python " "interpreter. To do this you will have to modify a setting called PATH, " "which is a list of directories where Windows will look for programs." msgstr "" -#: ../src/Doc/faq/windows.rst:115 +#: faq/windows.rst:115 msgid "" "You should arrange for Python's installation directory to be added to the " "PATH of every command window as it starts. If you installed Python fairly " @@ -6606,7 +6589,7 @@ msgid "" msgstr "" # f46c3c06a6614fd7a3f399a789a6f00f -#: ../src/Doc/faq/windows.rst:121 +#: faq/windows.rst:121 msgid "" "will probably tell you where it is installed; the usual location is " "something like ``C:\\Python27``. Otherwise you will be reduced to a search " @@ -6617,29 +6600,28 @@ msgid "" "command ::" msgstr "" -# a999141b52e441e189824b2293f0481e -#: ../src/Doc/faq/windows.rst:130 +#: faq/windows.rst:130 msgid "" -"starts up the interpreter as above (and don't forget you'll need a \"CTRL-Z" -"\" and an \"Enter\" to get out of it). Once you have verified the directory, " -"you can add it to the system path to make it easier to start Python by just " -"running the ``python`` command. This is currently an option in the installer " -"as of CPython 2.7." +"starts up the interpreter as above (and don't forget you'll need a \":kbd:" +"`Ctrl-Z`\" and an \":kbd:`Enter`\" to get out of it). Once you have verified " +"the directory, you can add it to the system path to make it easier to start " +"Python by just running the ``python`` command. This is currently an option " +"in the installer as of CPython 2.7." msgstr "" # ed7403dd874946cdbc3f3918c7d74c16 -#: ../src/Doc/faq/windows.rst:136 +#: faq/windows.rst:136 msgid "" "More information about environment variables can be found on the :ref:`Using " "Python on Windows ` page." msgstr "" -#: ../src/Doc/faq/windows.rst:140 +#: faq/windows.rst:140 msgid "How do I make Python scripts executable?" msgstr "" # 507a227f35bb44819a7430bc0380a3fa -#: ../src/Doc/faq/windows.rst:142 +#: faq/windows.rst:142 msgid "" "On Windows, the standard Python installer already associates the .py " "extension with a file type (Python.File) and gives that file type an open " @@ -6650,11 +6632,11 @@ msgid "" "environment variable." msgstr "" -#: ../src/Doc/faq/windows.rst:150 +#: faq/windows.rst:150 msgid "Why does Python sometimes take so long to start?" msgstr "" -#: ../src/Doc/faq/windows.rst:152 +#: faq/windows.rst:152 msgid "" "Usually Python starts very quickly on Windows, but occasionally there are " "bug reports that Python suddenly begins to take a long time to start up. " @@ -6662,7 +6644,7 @@ msgid "" "Windows systems which appear to be configured identically." msgstr "" -#: ../src/Doc/faq/windows.rst:157 +#: faq/windows.rst:157 msgid "" "The problem may be caused by a misconfiguration of virus checking software " "on the problem machine. Some virus scanners have been known to introduce " @@ -6673,23 +6655,23 @@ msgid "" "activity, is a particular offender." msgstr "" -#: ../src/Doc/faq/windows.rst:167 +#: faq/windows.rst:167 #, fuzzy msgid "How do I make an executable from a Python script?" msgstr "Comment construire un tableau en Python?" # a187634c79d7479a9b909794ef6cfe9f -#: ../src/Doc/faq/windows.rst:169 +#: faq/windows.rst:169 msgid "" "See http://www.py2exe.org/ for a distutils extension that allows you to " "create console and GUI executables from Python code." msgstr "" -#: ../src/Doc/faq/windows.rst:173 +#: faq/windows.rst:173 msgid "Is a ``*.pyd`` file the same as a DLL?" msgstr "" -#: ../src/Doc/faq/windows.rst:177 +#: faq/windows.rst:177 msgid "" "Yes, .pyd files are dll's, but there are a few differences. If you have a " "DLL named ``foo.pyd``, then it must have a function ``initfoo()``. You can " @@ -6699,7 +6681,7 @@ msgid "" "that would cause Windows to require the DLL to be present." msgstr "" -#: ../src/Doc/faq/windows.rst:184 +#: faq/windows.rst:184 msgid "" "Note that the search path for foo.pyd is PYTHONPATH, not the same as the " "path that Windows uses to search for foo.dll. Also, foo.pyd need not be " @@ -6710,18 +6692,18 @@ msgid "" "available functions." msgstr "" -#: ../src/Doc/faq/windows.rst:193 +#: faq/windows.rst:193 msgid "How can I embed Python into a Windows application?" msgstr "" -#: ../src/Doc/faq/windows.rst:195 +#: faq/windows.rst:195 msgid "" "Embedding the Python interpreter in a Windows app can be summarized as " "follows:" msgstr "" # ffbbe3340bc0406bb54039da3a8b1fac -#: ../src/Doc/faq/windows.rst:197 +#: faq/windows.rst:197 msgid "" "Do _not_ build Python into your .exe file directly. On Windows, Python must " "be a DLL to handle importing modules that are themselves DLL's. (This is " @@ -6731,7 +6713,7 @@ msgid "" msgstr "" # ccc0def2b7d84a97a01196cbd172917b -#: ../src/Doc/faq/windows.rst:203 +#: faq/windows.rst:203 msgid "" "You can link to Python in two different ways. Load-time linking means " "linking against :file:`python{NN}.lib`, while run-time linking means linking " @@ -6741,7 +6723,7 @@ msgid "" msgstr "" # b83fc8f27fe84320990b94a26419a932 -#: ../src/Doc/faq/windows.rst:209 +#: faq/windows.rst:209 msgid "" "Run-time linking greatly simplifies link options; everything happens at run " "time. Your code must load :file:`python{NN}.dll` using the Windows " @@ -6752,13 +6734,13 @@ msgid "" "API." msgstr "" -#: ../src/Doc/faq/windows.rst:216 +#: faq/windows.rst:216 msgid "" "Borland note: convert :file:`python{NN}.lib` to OMF format using Coff2Omf." "exe first." msgstr "" -#: ../src/Doc/faq/windows.rst:221 +#: faq/windows.rst:221 msgid "" "If you use SWIG, it is easy to create a Python \"extension module\" that " "will make the app's data and methods available to Python. SWIG will handle " @@ -6767,7 +6749,7 @@ msgid "" "this also simplifies linking." msgstr "" -#: ../src/Doc/faq/windows.rst:227 +#: faq/windows.rst:227 msgid "" "SWIG will create an init function (a C function) whose name depends on the " "name of the extension module. For example, if the name of the module is " @@ -6776,26 +6758,26 @@ msgid "" "initializes a mostly hidden helper class used by the shadow class." msgstr "" -#: ../src/Doc/faq/windows.rst:233 +#: faq/windows.rst:233 msgid "" "The reason you can link the C code in step 2 into your .exe file is that " "calling the initialization function is equivalent to importing the module " "into Python! (This is the second key undocumented fact.)" msgstr "" -#: ../src/Doc/faq/windows.rst:237 +#: faq/windows.rst:237 msgid "" "In short, you can use the following code to initialize the Python " "interpreter with your extension module." msgstr "" -#: ../src/Doc/faq/windows.rst:248 +#: faq/windows.rst:248 msgid "" "There are two problems with Python's C API which will become apparent if you " "use a compiler other than MSVC, the compiler used to build pythonNN.dll." msgstr "" -#: ../src/Doc/faq/windows.rst:251 +#: faq/windows.rst:251 msgid "" "Problem 1: The so-called \"Very High Level\" functions that take FILE * " "arguments will not work in a multi-compiler environment because each " @@ -6803,27 +6785,27 @@ msgid "" "implementation standpoint these are very _low_ level functions." msgstr "" -#: ../src/Doc/faq/windows.rst:256 +#: faq/windows.rst:256 msgid "" "Problem 2: SWIG generates the following code when generating wrappers to " "void functions:" msgstr "" -#: ../src/Doc/faq/windows.rst:265 +#: faq/windows.rst:265 msgid "" "Alas, Py_None is a macro that expands to a reference to a complex data " "structure called _Py_NoneStruct inside pythonNN.dll. Again, this code will " "fail in a mult-compiler environment. Replace such code by:" msgstr "" -#: ../src/Doc/faq/windows.rst:273 +#: faq/windows.rst:273 msgid "" "It may be possible to use SWIG's ``%typemap`` command to make the change " "automatically, though I have not been able to get this to work (I'm a " "complete SWIG newbie)." msgstr "" -#: ../src/Doc/faq/windows.rst:277 +#: faq/windows.rst:277 msgid "" "Using a Python shell script to put up a Python interpreter window from " "inside your Windows app is not a good idea; the resulting window will be " @@ -6835,18 +6817,18 @@ msgid "" "and write() methods." msgstr "" -#: ../src/Doc/faq/windows.rst:286 +#: faq/windows.rst:286 msgid "How do I keep editors from inserting tabs into my Python source?" msgstr "" -#: ../src/Doc/faq/windows.rst:288 +#: faq/windows.rst:288 msgid "" "The FAQ does not recommend using tabs, and the Python style guide, :pep:`8`, " "recommends 4 spaces for distributed Python code; this is also the Emacs " "python-mode default." msgstr "" -#: ../src/Doc/faq/windows.rst:292 +#: faq/windows.rst:292 msgid "" "Under any editor, mixing tabs and spaces is a bad idea. MSVC is no " "different in this respect, and is easily configured to use spaces: Take :" @@ -6855,54 +6837,54 @@ msgid "" "radio button." msgstr "" -#: ../src/Doc/faq/windows.rst:297 +#: faq/windows.rst:297 msgid "" "If you suspect mixed tabs and spaces are causing problems in leading " "whitespace, run Python with the :option:`-t` switch or run ``Tools/Scripts/" "tabnanny.py`` to check a directory tree in batch mode." msgstr "" -#: ../src/Doc/faq/windows.rst:303 +#: faq/windows.rst:303 msgid "How do I check for a keypress without blocking?" msgstr "" -#: ../src/Doc/faq/windows.rst:305 +#: faq/windows.rst:305 msgid "" "Use the msvcrt module. This is a standard Windows-specific extension " "module. It defines a function ``kbhit()`` which checks whether a keyboard " "hit is present, and ``getch()`` which gets one character without echoing it." msgstr "" -#: ../src/Doc/faq/windows.rst:311 +#: faq/windows.rst:311 msgid "How do I emulate os.kill() in Windows?" msgstr "" -#: ../src/Doc/faq/windows.rst:313 +#: faq/windows.rst:313 msgid "" "Prior to Python 2.7 and 3.2, to terminate a process, you can use :mod:" "`ctypes`::" msgstr "" -#: ../src/Doc/faq/windows.rst:323 +#: faq/windows.rst:323 msgid "" "In 2.7 and 3.2, :func:`os.kill` is implemented similar to the above " -"function, with the additional feature of being able to send CTRL+C and CTRL" -"+BREAK to console subprocesses which are designed to handle those signals. " -"See :func:`os.kill` for further details." +"function, with the additional feature of being able to send :kbd:`Ctrl+C` " +"and :kbd:`Ctrl+Break` to console subprocesses which are designed to handle " +"those signals. See :func:`os.kill` for further details." msgstr "" -#: ../src/Doc/faq/windows.rst:329 +#: faq/windows.rst:329 msgid "How do I extract the downloaded documentation on Windows?" msgstr "" -#: ../src/Doc/faq/windows.rst:331 +#: faq/windows.rst:331 msgid "" "Sometimes, when you download the documentation package to a Windows machine " "using a web browser, the file extension of the saved file ends up being ." "EXE. This is a mistake; the extension should be .TGZ." msgstr "" -#: ../src/Doc/faq/windows.rst:335 +#: faq/windows.rst:335 msgid "" "Simply rename the downloaded file to have the .TGZ extension, and WinZip " "will be able to handle it. (If your copy of WinZip doesn't, get a newer one " diff --git a/glossary.po b/glossary.po index 14fea14c..76834b11 100644 --- a/glossary.po +++ b/glossary.po @@ -7,21 +7,25 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/glossary.rst:5 +#: glossary.rst:5 msgid "Glossary" msgstr "Glossaire" -#: ../src/Doc/glossary.rst:12 +#: glossary.rst:10 +msgid ">>>" +msgstr "" + +#: glossary.rst:12 msgid "" "The default Python prompt of the interactive shell. Often seen for code " "examples which can be executed interactively in the interpreter." @@ -30,7 +34,11 @@ msgstr "" "la voit souvent dans des exemples de code qui peuvent être exécutés " "interactivement dans l'interpréteur." -#: ../src/Doc/glossary.rst:16 +#: glossary.rst:14 +msgid "..." +msgstr "" + +#: glossary.rst:16 msgid "" "The default Python prompt of the interactive shell when entering code for an " "indented code block or within a pair of matching left and right delimiters " @@ -40,8 +48,12 @@ msgstr "" "lorsqu'on entre un bloc de code indenté ou entre deux délimiteurs " "(parenthèses, crochets ou accolades)." +#: glossary.rst:19 +msgid "2to3" +msgstr "" + # I don’t know the accepted translation for “parse tree” -#: ../src/Doc/glossary.rst:21 +#: glossary.rst:21 #, fuzzy msgid "" "A tool that tries to convert Python 2.x code to Python 3.x code by handling " @@ -54,7 +66,7 @@ msgstr "" # The strange space escaping are here to handle non-breaking spaces required # by French typographic rules. -#: ../src/Doc/glossary.rst:25 +#: glossary.rst:25 msgid "" "2to3 is available in the standard library as :mod:`lib2to3`; a standalone " "entry point is provided as :file:`Tools/scripts/2to3`. See :ref:`2to3-" @@ -64,7 +76,11 @@ msgstr "" "`lib2to3`\\ ; un point d’entrée indépendant est fourni via :file:`Tools/" "scripts/2to3`. Cf. \\ :ref:`2to3-reference`." -#: ../src/Doc/glossary.rst:30 +#: glossary.rst:28 +msgid "abstract base class" +msgstr "" + +#: glossary.rst:30 #, fuzzy msgid "" "Abstract base classes complement :term:`duck-typing` by providing a way to " @@ -85,8 +101,12 @@ msgstr "" "mod:`numbers`), et les flux (dans le module :mod:`io`). Vous pouvez créer " "vos propres ABC avec le module :mod:`abc`." +#: glossary.rst:40 +msgid "argument" +msgstr "" + # 7a3a0ba67d87486099ffa61582c31163 -#: ../src/Doc/glossary.rst:42 +#: glossary.rst:42 #, fuzzy msgid "" "A value passed to a :term:`function` (or :term:`method`) when calling the " @@ -96,7 +116,7 @@ msgstr "" "son appel. Il existe deux types d'arguments :" # 50131cefa8d2410aa354a6b32e8435ed -#: ../src/Doc/glossary.rst:45 +#: glossary.rst:45 msgid "" ":dfn:`keyword argument`: an argument preceded by an identifier (e.g. " "``name=``) in a function call or passed as a value in a dictionary preceded " @@ -109,7 +129,7 @@ msgstr "" "nommés dans l'appel à :func:`complex` ici ::" # 8bbecb8af15441428909ba7722983955 -#: ../src/Doc/glossary.rst:53 +#: glossary.rst:53 msgid "" ":dfn:`positional argument`: an argument that is not a keyword argument. " "Positional arguments can appear at the beginning of an argument list and/or " @@ -122,7 +142,7 @@ msgstr "" "sont tous les deux des arguments positionnels dans les appels suivants ::" # 4c19af4f404b49fabb0ae8c34ac614ae -#: ../src/Doc/glossary.rst:62 +#: glossary.rst:62 msgid "" "Arguments are assigned to the named local variables in a function body. See " "the :ref:`calls` section for the rules governing this assignment. " @@ -136,7 +156,7 @@ msgstr "" "la variable locale." # 883a70f3d6ac4ef5af6203f130ff22f9 -#: ../src/Doc/glossary.rst:67 +#: glossary.rst:67 #, fuzzy msgid "" "See also the :term:`parameter` glossary entry and the FAQ question on :ref:" @@ -147,7 +167,11 @@ msgstr "" "à propos de `la différence entre argument et paramètre ` et la :pep:`362`." -#: ../src/Doc/glossary.rst:72 +#: glossary.rst:70 +msgid "attribute" +msgstr "" + +#: glossary.rst:72 msgid "" "A value associated with an object which is referenced by name using dotted " "expressions. For example, if an object *o* has an attribute *a* it would be " @@ -157,7 +181,11 @@ msgstr "" "utilisant des points. Par exemple, si un objet *o* a un attribut *a*, il " "sera référencé par *o.a*." -#: ../src/Doc/glossary.rst:77 +#: glossary.rst:75 +msgid "BDFL" +msgstr "" + +#: glossary.rst:77 #, fuzzy msgid "" "Benevolent Dictator For Life, a.k.a. `Guido van Rossum `_, le créateur de Python." +#: glossary.rst:79 +msgid "bytes-like object" +msgstr "" + # 6ed4ea9bfffd4183bdaf0a4e38245452 -#: ../src/Doc/glossary.rst:81 +#: glossary.rst:81 #, fuzzy msgid "" "An object that supports the :ref:`buffer protocol `, like :" @@ -184,8 +216,12 @@ msgstr "" "actions nécessitent que la donnée soit modifiable, ce qui n'est pas possible " "avec tous les objets byte-compatibles." +#: glossary.rst:87 +msgid "bytecode" +msgstr "" + # 4784a51d6fea4eaf8eb8cc73ae492c9c -#: ../src/Doc/glossary.rst:89 +#: glossary.rst:89 msgid "" "Python source code is compiled into bytecode, the internal representation of " "a Python program in the CPython interpreter. The bytecode is also cached in " @@ -207,7 +243,7 @@ msgstr "" "machines virtuelle Python, encore moins entre différentes version de Python." # 693ad59d4aec412cbf25431a52fb6593 -#: ../src/Doc/glossary.rst:99 +#: glossary.rst:99 msgid "" "A list of bytecode instructions can be found in the documentation for :ref:" "`the dis module `." @@ -215,7 +251,11 @@ msgstr "" "Une liste des instructions du bytecode se trouve dans la documentation du :" "ref:`module dis `." -#: ../src/Doc/glossary.rst:103 +#: glossary.rst:101 +msgid "class" +msgstr "" + +#: glossary.rst:103 msgid "" "A template for creating user-defined objects. Class definitions normally " "contain method definitions which operate on instances of the class." @@ -224,15 +264,23 @@ msgstr "" "de classes contiennent normalement des définitions de méthodes qui agissent " "sur les instances de classe." +#: glossary.rst:106 +msgid "classic class" +msgstr "" + # 928bddece69547be8d24a486652fd651 -#: ../src/Doc/glossary.rst:108 +#: glossary.rst:108 msgid "" "Any class which does not inherit from :class:`object`. See :term:`new-style " "class`. Classic classes have been removed in Python 3." msgstr "" +#: glossary.rst:110 +msgid "coercion" +msgstr "" + # 80b9baf13e62410c9e2897e0c4be23cd -#: ../src/Doc/glossary.rst:112 +#: glossary.rst:112 msgid "" "The implicit conversion of an instance of one type to another during an " "operation which involves two arguments of the same type. For example, " @@ -247,7 +295,11 @@ msgid "" "rather than just ``3+4.5``." msgstr "" -#: ../src/Doc/glossary.rst:125 +#: glossary.rst:123 +msgid "complex number" +msgstr "" + +#: glossary.rst:125 msgid "" "An extension of the familiar real number system in which all numbers are " "expressed as a sum of a real part and an imaginary part. Imaginary numbers " @@ -271,7 +323,11 @@ msgstr "" "Si vous n'en avez pas l'utilité, vous pouvez les ignorer en toute " "tranquilité." -#: ../src/Doc/glossary.rst:137 +#: glossary.rst:135 +msgid "context manager" +msgstr "" + +#: glossary.rst:137 msgid "" "An object which controls the environment seen in a :keyword:`with` statement " "by defining :meth:`__enter__` and :meth:`__exit__` methods. See :pep:`343`." @@ -280,7 +336,11 @@ msgstr "" "`with` en définissant les méthodes :meth:`__enter__` et :meth:`__exit__`. " "Consultez la :pep:`343`." -#: ../src/Doc/glossary.rst:142 +#: glossary.rst:140 +msgid "CPython" +msgstr "" + +#: glossary.rst:142 #, fuzzy msgid "" "The canonical implementation of the Python programming language, as " @@ -292,7 +352,11 @@ msgstr "" "\"CPython\" est utilisé dans certains contextes lorsqu'il est nécessaire de " "distingué cette implémentation des autres comme Jython ou IronPython" -#: ../src/Doc/glossary.rst:148 +#: glossary.rst:146 +msgid "decorator" +msgstr "" + +#: glossary.rst:148 msgid "" "A function returning another function, usually applied as a function " "transformation using the ``@wrapper`` syntax. Common examples for " @@ -303,7 +367,7 @@ msgstr "" "habituels pour les décorateurs sont :func:`classmethod` et :func:" "`staticmethod`." -#: ../src/Doc/glossary.rst:152 +#: glossary.rst:152 msgid "" "The decorator syntax is merely syntactic sugar, the following two function " "definitions are semantically equivalent::" @@ -311,7 +375,7 @@ msgstr "" "La syntaxe decorator est simplement du sucre syntaxique, les définitions des " "deux fonctions suivantes sont sémantiquement équivalentes :" -#: ../src/Doc/glossary.rst:163 +#: glossary.rst:163 msgid "" "The same concept exists for classes, but is less commonly used there. See " "the documentation for :ref:`function definitions ` and :ref:`class " @@ -321,7 +385,11 @@ msgstr "" "Consultez la documentation :ref:`définitions de fonctions ` et :" "ref:`définitions de classes ` pour en savoir plus sur les decorators." -#: ../src/Doc/glossary.rst:168 +#: glossary.rst:166 +msgid "descriptor" +msgstr "" + +#: glossary.rst:168 #, fuzzy msgid "" "Any *new-style* object which defines the methods :meth:`__get__`, :meth:" @@ -345,15 +413,19 @@ msgstr "" "notamment les fonctions, méthodes, propriétés, méthodes de classe, méthodes " "statiques, et les références aux classes mères. " -#: ../src/Doc/glossary.rst:178 +#: glossary.rst:178 msgid "" "For more information about descriptors' methods, see :ref:`descriptors`." msgstr "" "Pour plus d'informations sur les méthodes des descripteurs, consultez :ref:" "`descriptors`." +#: glossary.rst:179 +msgid "dictionary" +msgstr "" + # f754f581b3d74b79bbd8141ea901dbaf -#: ../src/Doc/glossary.rst:181 +#: glossary.rst:181 #, fuzzy msgid "" "An associative array, where arbitrary keys are mapped to values. The keys " @@ -364,7 +436,24 @@ msgstr "" "peuvent être n'importe quel objet comportant les méthodes :meth:`__hash__` " "et :meth:`__eq__``. Elle s'appelle \"hash\" en Perl." -#: ../src/Doc/glossary.rst:186 +#: glossary.rst:184 +msgid "dictionary view" +msgstr "" + +#: glossary.rst:186 +msgid "" +"The objects returned from :meth:`dict.viewkeys`, :meth:`dict.viewvalues`, " +"and :meth:`dict.viewitems` are called dictionary views. They provide a " +"dynamic view on the dictionary’s entries, which means that when the " +"dictionary changes, the view reflects these changes. To force the dictionary " +"view to become a full list use ``list(dictview)``. See :ref:`dict-views`." +msgstr "" + +#: glossary.rst:192 +msgid "docstring" +msgstr "" + +#: glossary.rst:194 msgid "" "A string literal which appears as the first expression in a class, function " "or module. While ignored when the suite is executed, it is recognized by " @@ -378,8 +467,12 @@ msgstr "" "fonction, ou module respectif. Puisque cette chaîne est disponible par " "introspection, c'est l'endroit idéal pour documenter l'objet." +#: glossary.rst:200 +msgid "duck-typing" +msgstr "" + # 042c1d93e5ca4d8a96eab89d07ddb0df -#: ../src/Doc/glossary.rst:194 +#: glossary.rst:202 msgid "" "A programming style which does not look at an object's type to determine if " "it has the right interface; instead, the method or attribute is simply " @@ -402,7 +495,11 @@ msgstr "" "base abstraite>`.) À la place, le duck-typique utilise plutôt :func:" "`hasattr` ou la programmation :term:`EAFP`." -#: ../src/Doc/glossary.rst:205 +#: glossary.rst:211 +msgid "EAFP" +msgstr "" + +#: glossary.rst:213 msgid "" "Easier to ask for forgiveness than permission. This common Python coding " "style assumes the existence of valid keys or attributes and catches " @@ -418,7 +515,11 @@ msgstr "" "keyword:`except`. Cette technique de programmation contraste avec le style :" "term:`LBYL` présent courament dans des langages tel que C." -#: ../src/Doc/glossary.rst:213 +#: glossary.rst:219 +msgid "expression" +msgstr "" + +#: glossary.rst:221 #, fuzzy msgid "" "A piece of syntax which can be evaluated to some value. In other words, an " @@ -439,7 +540,11 @@ msgstr "" "keyword:`if`. Les affectations sont également des :term:`statements` et non " "des expressions." -#: ../src/Doc/glossary.rst:222 +#: glossary.rst:228 +msgid "extension module" +msgstr "" + +#: glossary.rst:230 msgid "" "A module written in C or C++, using Python's C API to interact with the core " "and with user code." @@ -447,8 +552,12 @@ msgstr "" "Un module écrit en C ou C++, utilisant l'API C de Python pour interagir avec " "Python et le code de l'utilisateur." +#: glossary.rst:232 +msgid "file object" +msgstr "" + # 76951cc850f44973adbb2272e984c10d -#: ../src/Doc/glossary.rst:226 +#: glossary.rst:234 msgid "" "An object exposing a file-oriented API (with methods such as :meth:`read()` " "or :meth:`write()`) to an underlying resource. Depending on the way it was " @@ -466,7 +575,7 @@ msgstr "" "objects` ou :dfn:`streams`." # 1fdf5a4475fa45a7a2c273be3699ac65 -#: ../src/Doc/glossary.rst:234 +#: glossary.rst:242 msgid "" "There are actually three categories of file objects: raw binary files, " "buffered binary files and text files. Their interfaces are defined in the :" @@ -474,20 +583,32 @@ msgid "" "func:`open` function." msgstr "" +#: glossary.rst:246 +msgid "file-like object" +msgstr "" + # b948ad82982548409e3c905be43aa371 -#: ../src/Doc/glossary.rst:240 +#: glossary.rst:248 msgid "A synonym for :term:`file object`." msgstr "Un synonyme de :term:`objet fichier `." +#: glossary.rst:249 +msgid "finder" +msgstr "" + # 5725b635d290447cb6d0d89ad194b113 -#: ../src/Doc/glossary.rst:243 +#: glossary.rst:251 msgid "" "An object that tries to find the :term:`loader` for a module. It must " "implement a method named :meth:`find_module`. See :pep:`302` for details." msgstr "" +#: glossary.rst:254 +msgid "floor division" +msgstr "" + # 8325f98bd93d4e0887c926dca290641c -#: ../src/Doc/glossary.rst:248 +#: glossary.rst:256 msgid "" "Mathematical division that rounds down to nearest integer. The floor " "division operator is ``//``. For example, the expression ``11 // 4`` " @@ -500,8 +621,12 @@ msgstr "" "``2``, contrairement à ``11 / 4`` qui vaut ``2.75``. Notez que ``(-11) // " "4`` vaut ``-3`` car l'arrondi se fait par le bas. Voir la :pep:`328`." +#: glossary.rst:261 +msgid "function" +msgstr "" + # 33a8dbfd67ea4e0fb4dac5f9481c8568 -#: ../src/Doc/glossary.rst:255 +#: glossary.rst:263 msgid "" "A series of statements which returns some value to a caller. It can also be " "passed zero or more :term:`arguments ` which may be used in the " @@ -513,8 +638,12 @@ msgstr "" "utilisés dans le corps de la fonction. Voir aussi :term:`paramètre`, :term:" "`méthode`, et :ref:`function`." +#: glossary.rst:267 +msgid "__future__" +msgstr "" + # e7a99770e34a43bd96520fc22dcfb18e -#: ../src/Doc/glossary.rst:261 +#: glossary.rst:269 msgid "" "A pseudo-module which programmers can use to enable new language features " "which are not compatible with the current interpreter. For example, the " @@ -523,14 +652,18 @@ msgid "" msgstr "" # 6ee85b1aab4c47e385f403ce68ed1cb3 -#: ../src/Doc/glossary.rst:268 +#: glossary.rst:276 msgid "" "the expression ``11/4`` would evaluate to ``2.75``. By importing the :mod:" "`__future__` module and evaluating its variables, you can see when a new " "feature was first added to the language and when it will become the default::" msgstr "" -#: ../src/Doc/glossary.rst:278 +#: glossary.rst:284 +msgid "garbage collection" +msgstr "" + +#: glossary.rst:286 msgid "" "The process of freeing memory when it is not used anymore. Python performs " "garbage collection via reference counting and a cyclic garbage collector " @@ -540,17 +673,22 @@ msgstr "" "Python utilise un ramasse-miettes par comptage de référence, et un ramasse " "miette cyclique capable de détecter et casser les références circulaires." +#: glossary.rst:291 +msgid "generator" +msgstr "" + # bd6889e8844949f3a02cd584e41ac906 -#: ../src/Doc/glossary.rst:285 +#: glossary.rst:293 #, fuzzy msgid "" "A function which returns an iterator. It looks like a normal function " -"except that it contains :keyword:`yield` statements for producing a series a " -"values usable in a for-loop or that can be retrieved one at a time with the :" -"func:`next` function. Each :keyword:`yield` temporarily suspends processing, " -"remembering the location execution state (including local variables and " -"pending try-statements). When the generator resumes, it picks-up where it " -"left-off (in contrast to functions which start fresh on every invocation)." +"except that it contains :keyword:`yield` statements for producing a series " +"of values usable in a for-loop or that can be retrieved one at a time with " +"the :func:`next` function. Each :keyword:`yield` temporarily suspends " +"processing, remembering the location execution state (including local " +"variables and pending try-statements). When the generator resumes, it picks-" +"up where it left-off (in contrast to functions which start fresh on every " +"invocation)." msgstr "" "Une fonction qui renvoie un itérateur. Ça ressemble à une fonction normale, " "en dehors du fait qu'il contient une ou plusieurs instruction :keyword:" @@ -562,7 +700,11 @@ msgstr "" "là où il en était (contrairement à une fonction classique qui reprendrait du " "départ à chaque appel)." -#: ../src/Doc/glossary.rst:297 +#: glossary.rst:303 +msgid "generator expression" +msgstr "" + +#: glossary.rst:305 msgid "" "An expression that returns an iterator. It looks like a normal expression " "followed by a :keyword:`for` expression defining a loop variable, range, and " @@ -574,12 +716,21 @@ msgstr "" "boucle, d'un range, et d'une expression, optionnelle, :keyword:`if`. Cette " "expression combinée génère des valeurs pour la fonction qui l'entoure ::" -#: ../src/Doc/glossary.rst:306 +#: glossary.rst:312 +msgid "GIL" +msgstr "" + +#: glossary.rst:314 msgid "See :term:`global interpreter lock`." msgstr "Voir :term:`verrou global de l'interpréteur `." +#: glossary.rst:315 +#, fuzzy +msgid "global interpreter lock" +msgstr "Voir :term:`verrou global de l'interpréteur `." + # eae06790f2a14420857358b733306615 -#: ../src/Doc/glossary.rst:309 +#: glossary.rst:317 msgid "" "The mechanism used by the :term:`CPython` interpreter to assure that only " "one thread executes Python :term:`bytecode` at a time. This simplifies the " @@ -598,7 +749,7 @@ msgstr "" "machines ayant plusieurs processeurs." # 8cc9fbea059141b080140a49ecba1e16 -#: ../src/Doc/glossary.rst:318 +#: glossary.rst:326 msgid "" "However, some extension modules, either standard or third-party, are " "designed so as to release the GIL when doing computationally-intensive tasks " @@ -611,7 +762,7 @@ msgstr "" "lectures et écritures." # e78ce472d1e848ada067fdd3068fb708 -#: ../src/Doc/glossary.rst:323 +#: glossary.rst:331 msgid "" "Past efforts to create a \"free-threaded\" interpreter (one which locks " "shared data at a much finer granularity) have not been successful because " @@ -625,8 +776,12 @@ msgstr "" "problèmes de performance induits mènerai vers une implémentation compliquée " "et donc plus coûteuse à maintenir." +#: glossary.rst:336 +msgid "hashable" +msgstr "" + # 9913e09d19804a99aee1d8811c888425 -#: ../src/Doc/glossary.rst:330 +#: glossary.rst:338 #, fuzzy msgid "" "An object is *hashable* if it has a hash value which never changes during " @@ -639,7 +794,7 @@ msgstr "" "d'autres objets (avec la méthode :meth:`__eq__`). Les objets hachables dont " "``_eq__`` dit être équivalents, ont aussi la même empreinte." -#: ../src/Doc/glossary.rst:335 +#: glossary.rst:343 msgid "" "Hashability makes an object usable as a dictionary key and a set member, " "because these data structures use the hash value internally." @@ -649,7 +804,7 @@ msgstr "" "ce *hash*." # 3408ad472f4c42688e32ca8388ab2dba -#: ../src/Doc/glossary.rst:338 +#: glossary.rst:346 #, fuzzy msgid "" "All of Python's immutable built-in objects are hashable, while no mutable " @@ -664,8 +819,12 @@ msgstr "" "elles mêmes, et leur empreinte (*hash*) est calculée à partir de leur :func:" "`id`." +#: glossary.rst:351 +msgid "IDLE" +msgstr "" + # 8f1c753bef6f49ef9292eff2e5e4369e -#: ../src/Doc/glossary.rst:345 +#: glossary.rst:353 msgid "" "An Integrated Development Environment for Python. IDLE is a basic editor " "and interpreter environment which ships with the standard distribution of " @@ -674,7 +833,11 @@ msgstr "" "Un environnement de développement intégré pour Python. IDLE est un éditeur " "et interpréteur basique livré avec la distribution standard de Python." -#: ../src/Doc/glossary.rst:350 +#: glossary.rst:356 +msgid "immutable" +msgstr "" + +#: glossary.rst:358 msgid "" "An object with a fixed value. Immutable objects include numbers, strings " "and tuples. Such an object cannot be altered. A new object has to be " @@ -688,8 +851,12 @@ msgstr "" "important aux endroits où une valeur de hash constante est requise, " "typiquement en clef de dictionnaire." +#: glossary.rst:363 +msgid "integer division" +msgstr "" + # 3a87150a8f954602982fd37339efd903 -#: ../src/Doc/glossary.rst:357 +#: glossary.rst:365 msgid "" "Mathematical division discarding any remainder. For example, the expression " "``11/4`` currently evaluates to ``2`` in contrast to the ``2.75`` returned " @@ -703,14 +870,22 @@ msgid "" "operator. See also :term:`__future__`." msgstr "" +#: glossary.rst:375 +msgid "importing" +msgstr "" + # cd4670bfe278475e82214853bcf255cc -#: ../src/Doc/glossary.rst:369 +#: glossary.rst:377 msgid "" "The process by which Python code in one module is made available to Python " "code in another module." msgstr "Le processus rendant le code d'un module disponible dans un autre." -#: ../src/Doc/glossary.rst:373 +#: glossary.rst:379 +msgid "importer" +msgstr "" + +#: glossary.rst:381 msgid "" "An object that both finds and loads a module; both a :term:`finder` and :" "term:`loader` object." @@ -718,7 +893,11 @@ msgstr "" "Un objet qui trouve et charge un module, en même temps un :term:`finder` et " "un :term:`loader`." -#: ../src/Doc/glossary.rst:377 +#: glossary.rst:383 +msgid "interactive" +msgstr "" + +#: glossary.rst:385 msgid "" "Python has an interactive interpreter which means you can enter statements " "and expressions at the interpreter prompt, immediately execute them and see " @@ -733,7 +912,11 @@ msgstr "" "puissant pour tester de nouvelles idées ou étudier de nouveaux modules " "(souvenez vous de ``help(x)``)." -#: ../src/Doc/glossary.rst:385 +#: glossary.rst:391 +msgid "interpreted" +msgstr "" + +#: glossary.rst:393 msgid "" "Python is an interpreted language, as opposed to a compiled one, though the " "distinction can be blurry because of the presence of the bytecode compiler. " @@ -750,8 +933,12 @@ msgstr "" "et ils s'exécutent généralement plus lentement. Voir aussi :term:" "`interactif`." +#: glossary.rst:400 +msgid "iterable" +msgstr "" + # 1766e991d3794bfcbd0f64236d91bdcd -#: ../src/Doc/glossary.rst:394 +#: glossary.rst:402 msgid "" "An object capable of returning its members one at a time. Examples of " "iterables include all sequence types (such as :class:`list`, :class:`str`, " @@ -769,8 +956,12 @@ msgid "" "`generator`." msgstr "" +#: glossary.rst:416 +msgid "iterator" +msgstr "" + # f2537fc05b464913b2c4dbc25adaf0bc -#: ../src/Doc/glossary.rst:410 +#: glossary.rst:418 msgid "" "An object representing a stream of data. Repeated calls to the iterator's :" "meth:`~generator.next` method return successive items in the stream. When " @@ -788,12 +979,16 @@ msgid "" "an empty container." msgstr "" -#: ../src/Doc/glossary.rst:424 +#: glossary.rst:432 msgid "More information can be found in :ref:`typeiter`." msgstr "Plus d'informations ici : :ref:`typeiter`." +#: glossary.rst:433 +msgid "key function" +msgstr "" + # 4407f4d5ddab4943aa8b95ea3e95d087 -#: ../src/Doc/glossary.rst:427 +#: glossary.rst:435 msgid "" "A key function or collation function is a callable that returns a value used " "for sorting or ordering. For example, :func:`locale.strxfrm` is used to " @@ -805,7 +1000,7 @@ msgstr "" "tri spécifiques aux paramètres régionaux courants." # b687dec848ca4394a8c48b2990d87905 -#: ../src/Doc/glossary.rst:432 +#: glossary.rst:440 msgid "" "A number of tools in Python accept key functions to control how elements are " "ordered or grouped. They include :func:`min`, :func:`max`, :func:`sorted`, :" @@ -818,7 +1013,7 @@ msgstr "" "nsmallest`, :func:`heapq.nlargest`, et :func:`itertools.groupby`." # 41316a1c618c4d59ba353c58c75e89fe -#: ../src/Doc/glossary.rst:437 +#: glossary.rst:445 msgid "" "There are several ways to create a key function. For example. the :meth:" "`str.lower` method can serve as a key function for case insensitive sorts. " @@ -838,13 +1033,21 @@ msgstr "" "`Comment Trier ` pour avoir des exemple de création et " "d'utilisation de fonctions clés." +#: glossary.rst:453 +msgid "keyword argument" +msgstr "" + # 65d6c99a0f6941f6ac90cc3867107f42 # 0f29d18d80d44155bda6e138e96bd1ce -#: ../src/Doc/glossary.rst:447 ../src/Doc/glossary.rst:620 +#: glossary.rst:455 glossary.rst:628 msgid "See :term:`argument`." msgstr "Voir :term:`argument`." -#: ../src/Doc/glossary.rst:450 +#: glossary.rst:456 +msgid "lambda" +msgstr "" + +#: glossary.rst:458 msgid "" "An anonymous inline function consisting of a single :term:`expression` which " "is evaluated when the function is called. The syntax to create a lambda " @@ -854,7 +1057,11 @@ msgstr "" "expression, exécutée lorsqu'elle est appelée. La syntaxe pour créer des " "fonctions lambda est: ``lambda [arguments]: expression``" -#: ../src/Doc/glossary.rst:455 +#: glossary.rst:461 +msgid "LBYL" +msgstr "" + +#: glossary.rst:463 msgid "" "Look before you leap. This coding style explicitly tests for pre-conditions " "before making calls or lookups. This style contrasts with the :term:`EAFP` " @@ -867,7 +1074,7 @@ msgstr "" "caractérise par la présence de beaucoup d'instructions :keyword : `if`." # 0dc5595fdc784d8f9afbc265a54ccb9e -#: ../src/Doc/glossary.rst:460 +#: glossary.rst:468 msgid "" "In a multi-threaded environment, the LBYL approach can risk introducing a " "race condition between \"the looking\" and \"the leaping\". For example, " @@ -882,7 +1089,11 @@ msgstr "" "l'accès. Ce problème peut être résolu avec des verrous (*locks*) ou avec " "l'approche EAFP." -#: ../src/Doc/glossary.rst:467 +#: glossary.rst:473 +msgid "list" +msgstr "" + +#: glossary.rst:475 msgid "" "A built-in Python :term:`sequence`. Despite its name it is more akin to an " "array in other languages than to a linked list since access to elements are " @@ -892,8 +1103,12 @@ msgstr "" "``list`` ressemble plus à un *array* qu'à une liste chaînée puisque les " "accès se font en O(1)." +#: glossary.rst:478 +msgid "list comprehension" +msgstr "" + # 0a233eff49d24efe9903158ed9a8fc7a -#: ../src/Doc/glossary.rst:472 +#: glossary.rst:480 #, fuzzy msgid "" "A compact way to process all or part of the elements in a sequence and " @@ -909,16 +1124,24 @@ msgstr "" "clause :keyword : `if` est optionnelle. Si elle est omise, tous les éléments " "du ``range(256)`` seront utilisés." +#: glossary.rst:486 +msgid "loader" +msgstr "" + # f1f8f4cd6f1a4ae8850b0676e879f413 -#: ../src/Doc/glossary.rst:480 +#: glossary.rst:488 msgid "" "An object that loads a module. It must define a method named :meth:" "`load_module`. A loader is typically returned by a :term:`finder`. See :pep:" "`302` for details." msgstr "" +#: glossary.rst:491 +msgid "mapping" +msgstr "" + # dd0ae5035bfa49fc9bd134314d09bfcd -#: ../src/Doc/glossary.rst:485 +#: glossary.rst:493 #, fuzzy msgid "" "A container object that supports arbitrary key lookups and implements the " @@ -935,7 +1158,11 @@ msgstr "" "`dict`, :class:`collections.defaultdict`, :class:`collections.OrderedDict`, " "et :class:`collections.Counter`." -#: ../src/Doc/glossary.rst:493 +#: glossary.rst:499 +msgid "metaclass" +msgstr "" + +#: glossary.rst:501 msgid "" "The class of a class. Class definitions create a class name, a class " "dictionary, and a list of base classes. The metaclass is responsible for " @@ -951,11 +1178,15 @@ msgstr "" "classe, un dictionnaire et une liste de classes patentes. La métaclasse a " "pour rôle de réunir ces trois paramètres pour construire la classe." -#: ../src/Doc/glossary.rst:503 +#: glossary.rst:511 msgid "More information can be found in :ref:`metaclasses`." msgstr "Plus d'informations à ce sujet : :ref:`metaclasses`." -#: ../src/Doc/glossary.rst:506 +#: glossary.rst:512 +msgid "method" +msgstr "" + +#: glossary.rst:514 msgid "" "A function which is defined inside a class body. If called as an attribute " "of an instance of that class, the method will get the instance object as its " @@ -967,8 +1198,14 @@ msgstr "" "`argument` (qui par convention est nommé ``self``). Voir :term:`function` " "et :term:`nested scope`." +# c6741e9b5b1d47d7b0cf92e63d7437b1 +#: glossary.rst:518 +#, fuzzy +msgid "method resolution order" +msgstr "Voir :term:`ordre de résolution des méthodes `." + # d91abe76105e44df9313330cad54ad2d -#: ../src/Doc/glossary.rst:512 +#: glossary.rst:520 msgid "" "Method Resolution Order is the order in which base classes are searched for " "a member during lookup. See `The Python 2.3 Method Resolution Order `_." +#: glossary.rst:523 +msgid "module" +msgstr "" + # ad7a03faeea844749c0307592277e63f -#: ../src/Doc/glossary.rst:517 +#: glossary.rst:525 msgid "" "An object that serves as an organizational unit of Python code. Modules " "have a namespace containing arbitrary Python objects. Modules are loaded " @@ -991,16 +1232,24 @@ msgstr "" "modules est appelé :term:`importer`." # 65d6c99a0f6941f6ac90cc3867107f42 -#: ../src/Doc/glossary.rst:521 +#: glossary.rst:529 msgid "See also :term:`package`." msgstr "Voir aussi :term:`paquet`." +#: glossary.rst:530 +msgid "MRO" +msgstr "" + # c6741e9b5b1d47d7b0cf92e63d7437b1 -#: ../src/Doc/glossary.rst:524 +#: glossary.rst:532 msgid "See :term:`method resolution order`." msgstr "Voir :term:`ordre de résolution des méthodes `." -#: ../src/Doc/glossary.rst:527 +#: glossary.rst:533 +msgid "mutable" +msgstr "" + +#: glossary.rst:535 msgid "" "Mutable objects can change their value but keep their :func:`id`. See also :" "term:`immutable`." @@ -1008,7 +1257,11 @@ msgstr "" "Un objet variable (*mutable*) peut changer de valeur tout en gardant le " "même :func:`id`. Voir aussi :term:`immuable`." -#: ../src/Doc/glossary.rst:531 +#: glossary.rst:537 +msgid "named tuple" +msgstr "" + +#: glossary.rst:539 msgid "" "Any tuple-like class whose indexable elements are also accessible using " "named attributes (for example, :func:`time.localtime` returns a tuple-like " @@ -1020,7 +1273,7 @@ msgstr "" "`time.localtime` donne un objet ressemblant à un tuple, dont *year* est " "accessible par son indice : ``t[0]`` ou par son nom : ``t.tm_year``)." -#: ../src/Doc/glossary.rst:536 +#: glossary.rst:544 msgid "" "A named tuple can be a built-in type such as :class:`time.struct_time`, or " "it can be created with a regular class definition. A full featured named " @@ -1036,8 +1289,12 @@ msgstr "" "supplémentaires, tel qu'une représentation lisible comme " "``Employee(name='jones', title='programmer')``." +#: glossary.rst:550 +msgid "namespace" +msgstr "" + # 34a3f673792842659e93f26a12de05e7 -#: ../src/Doc/glossary.rst:544 +#: glossary.rst:552 msgid "" "The place where a variable is stored. Namespaces are implemented as " "dictionaries. There are the local, global and built-in namespaces as well " @@ -1051,8 +1308,12 @@ msgid "" "respectively." msgstr "" +#: glossary.rst:562 +msgid "nested scope" +msgstr "" + # 02211faabe3a4da0a7c887c874c296b1 -#: ../src/Doc/glossary.rst:556 +#: glossary.rst:564 msgid "" "The ability to refer to a variable in an enclosing definition. For " "instance, a function defined inside another function can refer to variables " @@ -1062,8 +1323,12 @@ msgid "" "Likewise, global variables read and write to the global namespace." msgstr "" +#: glossary.rst:570 +msgid "new-style class" +msgstr "" + # c773104e69fe4899b0b7464f24f6b490 -#: ../src/Doc/glossary.rst:564 +#: glossary.rst:572 msgid "" "Any class which inherits from :class:`object`. This includes all built-in " "types like :class:`list` and :class:`dict`. Only new-style classes can use " @@ -1072,11 +1337,15 @@ msgid "" msgstr "" # df747d6666004ea28dff736f8724ebfd -#: ../src/Doc/glossary.rst:569 +#: glossary.rst:577 msgid "More information can be found in :ref:`newstyle`." msgstr "" -#: ../src/Doc/glossary.rst:572 +#: glossary.rst:578 +msgid "object" +msgstr "" + +#: glossary.rst:580 msgid "" "Any data with state (attributes or value) and defined behavior (methods). " "Also the ultimate base class of any :term:`new-style class`." @@ -1086,8 +1355,12 @@ msgstr "" "(``object``) l'ancêtre commun à absolument toutes les :term:`nouvelles " "classes `." +#: glossary.rst:583 +msgid "package" +msgstr "" + # f0589e9db9374de0a7c664556ace1d7b -#: ../src/Doc/glossary.rst:577 +#: glossary.rst:585 msgid "" "A Python :term:`module` which can contain submodules or recursively, " "subpackages. Technically, a package is a Python module with an ``__path__`` " @@ -1096,8 +1369,12 @@ msgstr "" "Un :term:`module` qui peut contenir des sous modules ou des sous paquets. " "Techniquement, un paquet est un module qui a un attribut ``__path__``." +#: glossary.rst:588 +msgid "parameter" +msgstr "" + # 3a948869abbf40c68bcddf7bc9e01238 -#: ../src/Doc/glossary.rst:582 +#: glossary.rst:590 #, fuzzy msgid "" "A named entity in a :term:`function` (or method) definition that specifies " @@ -1109,7 +1386,7 @@ msgstr "" "arguments) que la fonction accepte. Il existe cinque sorte de paramètres :" # 88cbbf8a9c094e96972c9a4bae674b54 -#: ../src/Doc/glossary.rst:586 +#: glossary.rst:594 msgid "" ":dfn:`positional-or-keyword`: specifies an argument that can be passed " "either :term:`positionally ` or as a :term:`keyword argument " @@ -1118,7 +1395,7 @@ msgid "" msgstr "" # 5d344aa1c2c14f41bdde1b3c739e316b -#: ../src/Doc/glossary.rst:593 +#: glossary.rst:601 msgid "" ":dfn:`positional-only`: specifies an argument that can be supplied only by " "position. Python has no syntax for defining positional-only parameters. " @@ -1130,7 +1407,7 @@ msgstr "" "cependant des fonctions natives, comme :func:`abs` en utilisent." # df1910817a5e46739941e5d42e94a364 -#: ../src/Doc/glossary.rst:598 +#: glossary.rst:606 msgid "" ":dfn:`var-positional`: specifies that an arbitrary sequence of positional " "arguments can be provided (in addition to any positional arguments already " @@ -1140,7 +1417,7 @@ msgid "" msgstr "" # 8dd7e79a1566402e9e9ad95b604afeb4 -#: ../src/Doc/glossary.rst:606 +#: glossary.rst:614 msgid "" ":dfn:`var-keyword`: specifies that arbitrarily many keyword arguments can be " "provided (in addition to any keyword arguments already accepted by other " @@ -1149,7 +1426,7 @@ msgid "" msgstr "" # bf3e82954a6648efbe51ffdf2066bd51 -#: ../src/Doc/glossary.rst:612 +#: glossary.rst:620 msgid "" "Parameters can specify both optional and required arguments, as well as " "default values for some optional arguments." @@ -1159,7 +1436,7 @@ msgstr "" "optionnels." # 323d0e983e70456d9d14856846fe4e3b -#: ../src/Doc/glossary.rst:615 +#: glossary.rst:623 #, fuzzy msgid "" "See also the :term:`argument` glossary entry, the FAQ question on :ref:`the " @@ -1170,7 +1447,15 @@ msgstr "" "à propos de `la différence entre argument et paramètre ` et la :pep:`362`." -#: ../src/Doc/glossary.rst:623 +#: glossary.rst:626 +msgid "positional argument" +msgstr "" + +#: glossary.rst:629 +msgid "Python 3000" +msgstr "" + +#: glossary.rst:631 msgid "" "Nickname for the Python 3.x release line (coined long ago when the release " "of version 3 was something in the distant future.) This is also abbreviated " @@ -1179,7 +1464,11 @@ msgstr "" "Surnom de la série des Python 3.x (très vieux surnom donné à l'époque pour " "Python 3 n'était qu'un futur lointain). Aussi abrégé \"Py3k\"." -#: ../src/Doc/glossary.rst:628 +#: glossary.rst:634 +msgid "Pythonic" +msgstr "" + +#: glossary.rst:636 msgid "" "An idea or piece of code which closely follows the most common idioms of the " "Python language, rather than implementing code using concepts common to " @@ -1195,12 +1484,16 @@ msgstr "" "possibilité, donc les gens qui ne sont pas habitués à Python pourraient " "parfois utiliser un compteur à la place ::" -#: ../src/Doc/glossary.rst:638 +#: glossary.rst:646 msgid "As opposed to the cleaner, Pythonic method::" msgstr "" "Plutôt qu'utiliser la méthode, plus propre et élégante, donc Pythonique ::" -#: ../src/Doc/glossary.rst:644 +#: glossary.rst:650 +msgid "reference count" +msgstr "" + +#: glossary.rst:652 msgid "" "The number of references to an object. When the reference count of an " "object drops to zero, it is deallocated. Reference counting is generally " @@ -1210,8 +1503,12 @@ msgid "" "particular object." msgstr "" +#: glossary.rst:658 +msgid "__slots__" +msgstr "" + # 945a9d86a5f1422c9b37edd8e6f4f9cf -#: ../src/Doc/glossary.rst:652 +#: glossary.rst:660 msgid "" "A declaration inside a :term:`new-style class` that saves memory by pre-" "declaring space for instance attributes and eliminating instance " @@ -1220,8 +1517,12 @@ msgid "" "instances in a memory-critical application." msgstr "" +#: glossary.rst:665 +msgid "sequence" +msgstr "" + # e226f945a29143b097289a7b551d25ec -#: ../src/Doc/glossary.rst:659 +#: glossary.rst:667 msgid "" "An :term:`iterable` which supports efficient element access using integer " "indices via the :meth:`__getitem__` special method and defines a :meth:`len` " @@ -1232,8 +1533,12 @@ msgid "" "arbitrary :term:`immutable` keys rather than integers." msgstr "" +#: glossary.rst:675 +msgid "slice" +msgstr "" + # 4785e95d3a154c2da121c0542a04ee79 -#: ../src/Doc/glossary.rst:669 +#: glossary.rst:677 msgid "" "An object usually containing a portion of a :term:`sequence`. A slice is " "created using the subscript notation, ``[]`` with colons between numbers " @@ -1242,7 +1547,11 @@ msgid "" "versions, :meth:`__getslice__` and :meth:`__setslice__`)." msgstr "" -#: ../src/Doc/glossary.rst:676 +#: glossary.rst:682 +msgid "special method" +msgstr "" + +#: glossary.rst:684 msgid "" "A method that is called implicitly by Python to execute a certain operation " "on a type, such as addition. Such methods have names starting and ending " @@ -1250,16 +1559,24 @@ msgid "" "`specialnames`." msgstr "" +#: glossary.rst:688 +msgid "statement" +msgstr "" + # ed4604b8fb634111bdfe9c8e6f2f5387 -#: ../src/Doc/glossary.rst:682 +#: glossary.rst:690 msgid "" "A statement is part of a suite (a \"block\" of code). A statement is either " "an :term:`expression` or one of several constructs with a keyword, such as :" "keyword:`if`, :keyword:`while` or :keyword:`for`." msgstr "" +#: glossary.rst:693 +msgid "struct sequence" +msgstr "" + # 0c18843752e242b5bd5eaf59c9d9e380 -#: ../src/Doc/glossary.rst:687 +#: glossary.rst:695 msgid "" "A tuple with named elements. Struct sequences expose an interface similiar " "to :term:`named tuple` in that elements can either be accessed either by " @@ -1269,7 +1586,11 @@ msgid "" "data:`sys.float_info` and the return value of :func:`os.stat`." msgstr "" -#: ../src/Doc/glossary.rst:695 +#: glossary.rst:701 +msgid "triple-quoted string" +msgstr "" + +#: glossary.rst:703 msgid "" "A string which is bound by three instances of either a quotation mark (\") " "or an apostrophe ('). While they don't provide any functionality not " @@ -1280,16 +1601,24 @@ msgid "" "docstrings." msgstr "" +#: glossary.rst:710 +msgid "type" +msgstr "" + # 4ceb47bcd8704e648862b6bc1b5311fe -#: ../src/Doc/glossary.rst:704 +#: glossary.rst:712 msgid "" "The type of a Python object determines what kind of object it is; every " "object has a type. An object's type is accessible as its :attr:`~instance." "__class__` attribute or can be retrieved with ``type(obj)``." msgstr "" +#: glossary.rst:716 +msgid "universal newlines" +msgstr "" + # 45af0b22127142d898e66ebfd0567b9b -#: ../src/Doc/glossary.rst:710 +#: glossary.rst:718 msgid "" "A manner of interpreting text streams in which all of the following are " "recognized as ending a line: the Unix end-of-line convention ``'\\n'``, the " @@ -1298,23 +1627,33 @@ msgid "" "splitlines` for an additional use." msgstr "" -# a32b4dd14aa647d8ad51034682f0c23b -#: ../src/Doc/glossary.rst:717 -msgid "" -"The objects returned from :meth:`dict.viewkeys`, :meth:`dict.viewvalues`, " -"and :meth:`dict.viewitems` are called dictionary views. They are lazy " -"sequences that will see changes in the underlying dictionary. To force the " -"dictionary view to become a full list use ``list(dictview)``. See :ref:" -"`dict-views`." +#: glossary.rst:723 +msgid "virtual environment" msgstr "" -#: ../src/Doc/glossary.rst:724 +#: glossary.rst:725 +msgid "" +"A cooperatively isolated runtime environment that allows Python users and " +"applications to install and upgrade Python distribution packages without " +"interfering with the behaviour of other Python applications running on the " +"same system." +msgstr "" + +#: glossary.rst:729 +msgid "virtual machine" +msgstr "" + +#: glossary.rst:731 msgid "" "A computer defined entirely in software. Python's virtual machine executes " "the :term:`bytecode` emitted by the bytecode compiler." msgstr "" -#: ../src/Doc/glossary.rst:728 +#: glossary.rst:733 +msgid "Zen of Python" +msgstr "" + +#: glossary.rst:735 msgid "" "Listing of Python design principles and philosophies that are helpful in " "understanding and using the language. The listing can be found by typing " diff --git a/howto.po b/howto.po index 657b4ee1..0b9f61fd 100644 --- a/howto.po +++ b/howto.po @@ -7,28 +7,28 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" # ed2c1e75cda74c6bacd8233a92e11e2b -#: ../src/Doc/howto/argparse.rst:3 +#: howto/argparse.rst:3 msgid "Argparse Tutorial" msgstr "" # 200f6fc6f7394271a6276fcfe3273a09 -#: ../src/Doc/howto/argparse.rst:5 +#: howto/argparse.rst:5 msgid "Tshepang Lekhonkhobe" msgstr "" # ba2cf8e6c4b74afb8275761f1289aadd -#: ../src/Doc/howto/argparse.rst:9 +#: howto/argparse.rst:9 msgid "" "This tutorial is intended to be a gentle introduction to :mod:`argparse`, " "the recommended command-line parsing module in the Python standard library. " @@ -37,7 +37,7 @@ msgid "" msgstr "" # f2d820d7fe834fab909de32872122abb -#: ../src/Doc/howto/argparse.rst:16 +#: howto/argparse.rst:16 msgid "" "There are two other modules that fulfill the same task, namely :mod:`getopt` " "(an equivalent for :c:func:`getopt` from the C language) and the deprecated :" @@ -46,31 +46,31 @@ msgid "" msgstr "" # cdd8e2525f924b3c83d4fc2d745f8899 -#: ../src/Doc/howto/argparse.rst:24 +#: howto/argparse.rst:24 msgid "Concepts" msgstr "" # cc9e2f360c8340a886f8cd1db172ee5f -#: ../src/Doc/howto/argparse.rst:26 +#: howto/argparse.rst:26 msgid "" "Let's show the sort of functionality that we are going to explore in this " "introductory tutorial by making use of the :command:`ls` command:" msgstr "" # eb49ba3d308a43faaa0347a709943ba2 -#: ../src/Doc/howto/argparse.rst:48 +#: howto/argparse.rst:48 msgid "A few concepts we can learn from the four commands:" msgstr "" # 6b94ff97d73d4563ac5123ad6c91023c -#: ../src/Doc/howto/argparse.rst:50 +#: howto/argparse.rst:50 msgid "" "The :command:`ls` command is useful when run without any options at all. It " "defaults to displaying the contents of the current directory." msgstr "" # 1f144116a2784cf28d243ca6b6b14428 -#: ../src/Doc/howto/argparse.rst:53 +#: howto/argparse.rst:53 msgid "" "If we want beyond what it provides by default, we tell it a bit more. In " "this case, we want it to display a different directory, ``pypy``. What we " @@ -83,7 +83,7 @@ msgid "" msgstr "" # 36848d976f3d4b99a3abb07b95fbbe1c -#: ../src/Doc/howto/argparse.rst:62 +#: howto/argparse.rst:62 msgid "" "Now, say we want to change behaviour of the program. In our example, we " "display more info for each file instead of just showing the file names. The " @@ -91,7 +91,7 @@ msgid "" msgstr "" # abd627ea53d84e85b84e52561db2def4 -#: ../src/Doc/howto/argparse.rst:66 +#: howto/argparse.rst:66 msgid "" "That's a snippet of the help text. It's very useful in that you can come " "across a program you have never used before, and can figure out how it works " @@ -99,47 +99,45 @@ msgid "" msgstr "" # 901705678aaf47479af169a18c5488fb -#: ../src/Doc/howto/argparse.rst:72 +#: howto/argparse.rst:72 msgid "The basics" msgstr "" # 3acacfd395f949fba581ad8df478272d -#: ../src/Doc/howto/argparse.rst:74 +#: howto/argparse.rst:74 msgid "Let us start with a very simple example which does (almost) nothing::" msgstr "" # 19ce897f3a4a40e98a8ec81d8261611d # cd314c6b22c5443082c3216a5acde0d7 # 20795628a4c2456aaf50b95a8155628f -#: ../src/Doc/howto/argparse.rst:80 ../src/Doc/howto/argparse.rst:188 -#: ../src/Doc/howto/argparse.rst:209 +#: howto/argparse.rst:80 howto/argparse.rst:188 howto/argparse.rst:209 msgid "Following is a result of running the code:" msgstr "" # a69cbfdeb027402b8dae8442c9e32543 # d080102a0371487b8e7a9df31cb291e2 # d8adb9677e8c4bcaabb70a21f6706841 -#: ../src/Doc/howto/argparse.rst:97 ../src/Doc/howto/argparse.rst:254 -#: ../src/Doc/howto/argparse.rst:298 +#: howto/argparse.rst:97 howto/argparse.rst:254 howto/argparse.rst:298 msgid "Here is what is happening:" msgstr "" # 809de0b225f34682b32b0924855549f4 -#: ../src/Doc/howto/argparse.rst:99 +#: howto/argparse.rst:99 msgid "" "Running the script without any options results in nothing displayed to " "stdout. Not so useful." msgstr "" # 88a835298220492886c8c6b03ba14291 -#: ../src/Doc/howto/argparse.rst:102 +#: howto/argparse.rst:102 msgid "" "The second one starts to display the usefulness of the :mod:`argparse` " "module. We have done almost nothing, but already we get a nice help message." msgstr "" # a83aa58673aa4ffd844d4f8710e0f5b8 -#: ../src/Doc/howto/argparse.rst:105 +#: howto/argparse.rst:105 msgid "" "The ``--help`` option, which can also be shortened to ``-h``, is the only " "option we get for free (i.e. no need to specify it). Specifying anything " @@ -148,27 +146,27 @@ msgid "" msgstr "" # 36c8a64da160473f83961e770fd19e86 -#: ../src/Doc/howto/argparse.rst:112 +#: howto/argparse.rst:112 msgid "Introducing Positional arguments" msgstr "" # 89702f55bf604b84ba7bf50eaa18381c -#: ../src/Doc/howto/argparse.rst:114 +#: howto/argparse.rst:114 msgid "An example::" msgstr "" # 2152c6282c354a45ae084c6484959db0 -#: ../src/Doc/howto/argparse.rst:122 +#: howto/argparse.rst:122 msgid "And running the code:" msgstr "" # 8ac679fe46d74f6686f40d8b373e62cd -#: ../src/Doc/howto/argparse.rst:140 +#: howto/argparse.rst:140 msgid "Here is what's happening:" msgstr "" # e90c4bc43e8d4916928a09c382e57b8f -#: ../src/Doc/howto/argparse.rst:142 +#: howto/argparse.rst:142 msgid "" "We've added the :meth:`add_argument` method, which is what we use to specify " "which command-line options the program is willing to accept. In this case, " @@ -176,19 +174,19 @@ msgid "" msgstr "" # 20f8cd7161e04fbf8a3ef30fa9a0fd43 -#: ../src/Doc/howto/argparse.rst:146 +#: howto/argparse.rst:146 msgid "Calling our program now requires us to specify an option." msgstr "" # b31954419bb2477ba18be150cc9a904b -#: ../src/Doc/howto/argparse.rst:148 +#: howto/argparse.rst:148 msgid "" "The :meth:`parse_args` method actually returns some data from the options " "specified, in this case, ``echo``." msgstr "" # 94be1fc6c9a64555bf332d4b5273a8c8 -#: ../src/Doc/howto/argparse.rst:151 +#: howto/argparse.rst:151 msgid "" "The variable is some form of 'magic' that :mod:`argparse` performs for free " "(i.e. no need to specify which variable that value is stored in). You will " @@ -197,7 +195,7 @@ msgid "" msgstr "" # e737368bf84b4f14a1078f6b4d0834ce -#: ../src/Doc/howto/argparse.rst:156 +#: howto/argparse.rst:156 msgid "" "Note however that, although the help display looks nice and all, it " "currently is not as helpful as it can be. For example we see that we got " @@ -207,17 +205,17 @@ msgid "" msgstr "" # 5ca6e3a3b28541a49f5313e2ca7540f3 -#: ../src/Doc/howto/argparse.rst:167 +#: howto/argparse.rst:167 msgid "And we get:" msgstr "" # b4d1a84b95ec4463bf094ab4f5dc7e3e -#: ../src/Doc/howto/argparse.rst:180 +#: howto/argparse.rst:180 msgid "Now, how about doing something even more useful::" msgstr "" # eb4a5fbc93d74af6b741ea5ba889eac1 -#: ../src/Doc/howto/argparse.rst:198 +#: howto/argparse.rst:198 msgid "" "That didn't go so well. That's because :mod:`argparse` treats the options we " "give it as strings, unless we tell it otherwise. So, let's tell :mod:" @@ -225,19 +223,19 @@ msgid "" msgstr "" # 5fa0dae59b9441928901fc1d2309d5f3 -#: ../src/Doc/howto/argparse.rst:219 +#: howto/argparse.rst:219 msgid "" "That went well. The program now even helpfully quits on bad illegal input " "before proceeding." msgstr "" # 9fe6344ec9a64053b877930edda99baa -#: ../src/Doc/howto/argparse.rst:224 +#: howto/argparse.rst:224 msgid "Introducing Optional arguments" msgstr "" # cf9e5e7cce1a427e9bada5bf3316df89 -#: ../src/Doc/howto/argparse.rst:226 +#: howto/argparse.rst:226 msgid "" "So far we, have been playing with positional arguments. Let us have a look " "on how to add optional ones::" @@ -247,20 +245,20 @@ msgstr "" # 4d444bec24e448f7bd620043cb4b2a02 # 0465703176a9478ea74459722925cd49 # 0d4b42c07c1441edbf6eb1aa357bfb97 -#: ../src/Doc/howto/argparse.rst:236 ../src/Doc/howto/argparse.rst:282 -#: ../src/Doc/howto/argparse.rst:398 ../src/Doc/howto/argparse.rst:432 +#: howto/argparse.rst:236 howto/argparse.rst:282 howto/argparse.rst:398 +#: howto/argparse.rst:432 msgid "And the output:" msgstr "" # a2d6900fd2ef4799a4956eaf46ad548f -#: ../src/Doc/howto/argparse.rst:256 +#: howto/argparse.rst:256 msgid "" "The program is written so as to display something when ``--verbosity`` is " "specified and display nothing when not." msgstr "" # 48bf3a47c73d4df685831895d45cd3bc -#: ../src/Doc/howto/argparse.rst:259 +#: howto/argparse.rst:259 msgid "" "To show that the option is actually optional, there is no error when running " "the program without it. Note that by default, if an optional argument isn't " @@ -270,19 +268,19 @@ msgid "" msgstr "" # ea474839c84441e5b4fed6a6985d0fc0 -#: ../src/Doc/howto/argparse.rst:265 +#: howto/argparse.rst:265 msgid "The help message is a bit different." msgstr "" # 3f1265e224bb4577a68debe9c23c6c06 -#: ../src/Doc/howto/argparse.rst:267 +#: howto/argparse.rst:267 msgid "" "When using the ``--verbosity`` option, one must also specify some value, any " "value." msgstr "" # 88ce273a61e742b8b58e5c944a371e5d -#: ../src/Doc/howto/argparse.rst:270 +#: howto/argparse.rst:270 msgid "" "The above example accepts arbitrary integer values for ``--verbosity``, but " "for our simple program, only two values are actually useful, ``True`` or " @@ -290,7 +288,7 @@ msgid "" msgstr "" # c452465e05644cab83d1960866f0b729 -#: ../src/Doc/howto/argparse.rst:300 +#: howto/argparse.rst:300 msgid "" "The option is now more of a flag than something that requires a value. We " "even changed the name of the option to match that idea. Note that we now " @@ -300,24 +298,24 @@ msgid "" msgstr "" # bc5a61890db841fc9e59a1330a9ea38c -#: ../src/Doc/howto/argparse.rst:307 +#: howto/argparse.rst:307 msgid "" "It complains when you specify a value, in true spirit of what flags actually " "are." msgstr "" # d17e2b1f198348c0b15f28b624143b03 -#: ../src/Doc/howto/argparse.rst:310 +#: howto/argparse.rst:310 msgid "Notice the different help text." msgstr "" # 749d899bef604512a359ff88a7e64be6 -#: ../src/Doc/howto/argparse.rst:314 +#: howto/argparse.rst:314 msgid "Short options" msgstr "" # bdaf1ceb126644a09bb3ead44969c30e -#: ../src/Doc/howto/argparse.rst:316 +#: howto/argparse.rst:316 msgid "" "If you are familiar with command line usage, you will notice that I haven't " "yet touched on the topic of short versions of the options. It's quite " @@ -325,49 +323,49 @@ msgid "" msgstr "" # 0e5ba7c902f843a0a7a204d3a67fdf6d -#: ../src/Doc/howto/argparse.rst:328 +#: howto/argparse.rst:328 msgid "And here goes:" msgstr "" # 6ab46d6fde2c417b8fd1b41c4588634d -#: ../src/Doc/howto/argparse.rst:341 +#: howto/argparse.rst:341 msgid "Note that the new ability is also reflected in the help text." msgstr "" # 9cd03436de014d769ef7c75a564576d6 -#: ../src/Doc/howto/argparse.rst:345 +#: howto/argparse.rst:345 msgid "Combining Positional and Optional arguments" msgstr "" # af0aa9f8016a49e0a56448f2368714d8 -#: ../src/Doc/howto/argparse.rst:347 +#: howto/argparse.rst:347 msgid "Our program keeps growing in complexity::" msgstr "" # 7a2171285e0d4947af63b2e13836bf88 -#: ../src/Doc/howto/argparse.rst:362 +#: howto/argparse.rst:362 msgid "And now the output:" msgstr "" # 95f3c6e1f6ff407295cd42881bc8b685 -#: ../src/Doc/howto/argparse.rst:376 +#: howto/argparse.rst:376 msgid "We've brought back a positional argument, hence the complaint." msgstr "" # 14c74304cae3408bbee542d20599aa77 -#: ../src/Doc/howto/argparse.rst:378 +#: howto/argparse.rst:378 msgid "Note that the order does not matter." msgstr "" # b1997585bd4e4bdfa81eb2674454962e -#: ../src/Doc/howto/argparse.rst:380 +#: howto/argparse.rst:380 msgid "" "How about we give this program of ours back the ability to have multiple " "verbosity values, and actually get to use them::" msgstr "" # a3e67eade5ea48aa971ac7fdbfadba1d -#: ../src/Doc/howto/argparse.rst:414 +#: howto/argparse.rst:414 msgid "" "These all look good except the last one, which exposes a bug in our program. " "Let's fix it by restricting the values the ``--verbosity`` option can " @@ -375,14 +373,14 @@ msgid "" msgstr "" # ff50803d09054f7fb826f0207b9870b0 -#: ../src/Doc/howto/argparse.rst:450 +#: howto/argparse.rst:450 msgid "" "Note that the change also reflects both in the error message as well as the " "help string." msgstr "" # 36dc67e241e1421c81469dd3c1215ebd -#: ../src/Doc/howto/argparse.rst:453 +#: howto/argparse.rst:453 msgid "" "Now, let's use a different approach of playing with verbosity, which is " "pretty common. It also matches the way the CPython executable handles its " @@ -390,47 +388,47 @@ msgid "" msgstr "" # 8546c388b9ba46e4a33e106bf56b4c46 -#: ../src/Doc/howto/argparse.rst:472 +#: howto/argparse.rst:472 msgid "" "We have introduced another action, \"count\", to count the number of " "occurrences of a specific optional arguments:" msgstr "" # da62432192934a6cbd3ce0fdc3fd852c -#: ../src/Doc/howto/argparse.rst:500 +#: howto/argparse.rst:500 msgid "" "Yes, it's now more of a flag (similar to ``action=\"store_true\"``) in the " "previous version of our script. That should explain the complaint." msgstr "" # 238e2227b86048c78eebfa3a92615746 -#: ../src/Doc/howto/argparse.rst:503 +#: howto/argparse.rst:503 msgid "It also behaves similar to \"store_true\" action." msgstr "" # 96349d6535594b17a600ad840e547332 -#: ../src/Doc/howto/argparse.rst:505 +#: howto/argparse.rst:505 msgid "" "Now here's a demonstration of what the \"count\" action gives. You've " "probably seen this sort of usage before." msgstr "" # 3df4bafd899e4101baa9cf065eb8d1cb -#: ../src/Doc/howto/argparse.rst:508 +#: howto/argparse.rst:508 msgid "" "And, just like the \"store_true\" action, if you don't specify the ``-v`` " "flag, that flag is considered to have ``None`` value." msgstr "" # a15ad8b69c5c4d0f8ade8df1655f564c -#: ../src/Doc/howto/argparse.rst:511 +#: howto/argparse.rst:511 msgid "" "As should be expected, specifying the long form of the flag, we should get " "the same output." msgstr "" # bba2cb9134de4a1ba8266001ce32e227 -#: ../src/Doc/howto/argparse.rst:514 +#: howto/argparse.rst:514 msgid "" "Sadly, our help output isn't very informative on the new ability our script " "has acquired, but that can always be fixed by improving the documentation " @@ -438,39 +436,39 @@ msgid "" msgstr "" # 7c3baa4d38a04921bbb34db75f40191f -#: ../src/Doc/howto/argparse.rst:518 +#: howto/argparse.rst:518 msgid "That last output exposes a bug in our program." msgstr "" # ede443f12b194bf08b8af2cc84de72c7 -#: ../src/Doc/howto/argparse.rst:521 +#: howto/argparse.rst:521 msgid "Let's fix::" msgstr "" # 42d9f54500cb4fe7a3f7f04764af02a7 -#: ../src/Doc/howto/argparse.rst:540 +#: howto/argparse.rst:540 msgid "And this is what it gives:" msgstr "" # e06d6df0f277456c898c83b64e6e07fd -#: ../src/Doc/howto/argparse.rst:554 +#: howto/argparse.rst:554 msgid "" "First output went well, and fixes the bug we had before. That is, we want " "any value >= 2 to be as verbose as possible." msgstr "" # a83746c6d4f84a3ab4f17a816ad8d27e -#: ../src/Doc/howto/argparse.rst:557 +#: howto/argparse.rst:557 msgid "Third output not so good." msgstr "" # fc17fe3866c44c2c865e2ade4f0cf235 -#: ../src/Doc/howto/argparse.rst:559 +#: howto/argparse.rst:559 msgid "Let's fix that bug::" msgstr "" # fc49dd9b000d4a2e9bd86f5c87ae7611 -#: ../src/Doc/howto/argparse.rst:576 +#: howto/argparse.rst:576 msgid "" "We've just introduced yet another keyword, ``default``. We've set it to " "``0`` in order to make it comparable to the other int values. Remember that " @@ -480,12 +478,12 @@ msgid "" msgstr "" # f7b5161d927440aa913b318a3cb63e3a -#: ../src/Doc/howto/argparse.rst:583 +#: howto/argparse.rst:583 msgid "And:" msgstr "" # 48d847a95afe4972a90685bb5dfa27e7 -#: ../src/Doc/howto/argparse.rst:590 +#: howto/argparse.rst:590 msgid "" "You can go quite far just with what we've learned so far, and we have only " "scratched the surface. The :mod:`argparse` module is very powerful, and " @@ -493,12 +491,12 @@ msgid "" msgstr "" # 9ef1eb9b41ba423a92ddd13d4b708fce -#: ../src/Doc/howto/argparse.rst:597 +#: howto/argparse.rst:597 msgid "Getting a little more advanced" msgstr "" # 2dadf9c3eab740f4b7570152a47b84c9 -#: ../src/Doc/howto/argparse.rst:599 +#: howto/argparse.rst:599 msgid "" "What if we wanted to expand our tiny program to perform other powers, not " "just squares::" @@ -506,12 +504,12 @@ msgstr "" # f3bf44877bc64c0aa86abae6e2f0acc6 # e4e884a3fc7347999e313d0b14998905 -#: ../src/Doc/howto/argparse.rst:616 ../src/Doc/howto/argparse.rst:654 +#: howto/argparse.rst:616 howto/argparse.rst:654 msgid "Output:" msgstr "" # ec32d3f0faf6456687bc1073526ec4bb -#: ../src/Doc/howto/argparse.rst:637 +#: howto/argparse.rst:637 msgid "" "Notice that so far we've been using verbosity level to *change* the text " "that gets displayed. The following example instead uses verbosity level to " @@ -519,12 +517,12 @@ msgid "" msgstr "" # f8ffc56259fe4a6ca816aaae8589db93 -#: ../src/Doc/howto/argparse.rst:668 +#: howto/argparse.rst:668 msgid "Conflicting options" msgstr "" # 676c05799d414eddb22479972d2b480e -#: ../src/Doc/howto/argparse.rst:670 +#: howto/argparse.rst:670 msgid "" "So far, we have been working with two methods of an :class:`argparse." "ArgumentParser` instance. Let's introduce a third one, :meth:" @@ -535,14 +533,14 @@ msgid "" msgstr "" # 713077aa2c824297950aa968d2444dcd -#: ../src/Doc/howto/argparse.rst:696 +#: howto/argparse.rst:696 msgid "" "Our program is now simpler, and we've lost some functionality for the sake " "of demonstration. Anyways, here's the output:" msgstr "" # 45d600c444b441928858bfedbb823c46 -#: ../src/Doc/howto/argparse.rst:714 +#: howto/argparse.rst:714 msgid "" "That should be easy to follow. I've added that last output so you can see " "the sort of flexibility you get, i.e. mixing long form options with short " @@ -550,14 +548,14 @@ msgid "" msgstr "" # 73f555c6fd084854a2d62f34e6ef4553 -#: ../src/Doc/howto/argparse.rst:718 +#: howto/argparse.rst:718 msgid "" "Before we conclude, you probably want to tell your users the main purpose of " "your program, just in case they don't know::" msgstr "" # 927f5f87a382492ab7a3926dda0d4bbc -#: ../src/Doc/howto/argparse.rst:739 +#: howto/argparse.rst:739 msgid "" "Note that slight difference in the usage text. Note the ``[-v | -q]``, which " "tells us that we can either use ``-v`` or ``-q``, but not both at the same " @@ -565,12 +563,12 @@ msgid "" msgstr "" # 1b05b0b91b544885bf48160c113f9998 -#: ../src/Doc/howto/argparse.rst:761 +#: howto/argparse.rst:761 msgid "Conclusion" msgstr "" # f791bef919cf4cf5bdeaa83a63b11948 -#: ../src/Doc/howto/argparse.rst:763 +#: howto/argparse.rst:763 msgid "" "The :mod:`argparse` module offers a lot more than shown here. Its docs are " "quite detailed and thorough, and full of examples. Having gone through this " @@ -578,16 +576,22 @@ msgid "" msgstr "" # 1fa71cf6d04f43c2b12e7c684dc07815 -#: ../src/Doc/howto/cporting.rst:7 +#: howto/cporting.rst:7 msgid "Porting Extension Modules to Python 3" msgstr "" -#: ../src/Doc/howto/cporting.rst:9 +#: howto/cporting.rst:9 msgid "Benjamin Peterson" msgstr "Benjamin Peterson" +#: howto/cporting.rst:0 howto/curses.rst:0 howto/descriptor.rst:11 +#: howto/doanddont.rst:0 howto/pyporting.rst:0 howto/regex.rst:0 +#: howto/sockets.rst:0 howto/webservers.rst:0 +msgid "Abstract" +msgstr "Résumé" + # 61237b37ee8a439ebd64184b40f78ea1 -#: ../src/Doc/howto/cporting.rst:14 +#: howto/cporting.rst:14 msgid "" "Although changing the C-API was not one of Python 3's objectives, the many " "Python-level changes made leaving Python 2's API intact impossible. In " @@ -596,40 +600,40 @@ msgid "" "incompatibilities and how they can be worked around." msgstr "" -#: ../src/Doc/howto/cporting.rst:23 +#: howto/cporting.rst:23 msgid "Conditional compilation" msgstr "" # 6c17774a852c4a8ebff5ef99673811e3 -#: ../src/Doc/howto/cporting.rst:25 +#: howto/cporting.rst:25 msgid "" "The easiest way to compile only some code for Python 3 is to check if :c:" "macro:`PY_MAJOR_VERSION` is greater than or equal to 3. ::" msgstr "" -#: ../src/Doc/howto/cporting.rst:32 +#: howto/cporting.rst:32 msgid "" "API functions that are not present can be aliased to their equivalents " "within conditional blocks." msgstr "" -#: ../src/Doc/howto/cporting.rst:37 +#: howto/cporting.rst:37 msgid "Changes to Object APIs" msgstr "" # 8f247eff42394718972ca8f2f161e758 -#: ../src/Doc/howto/cporting.rst:39 +#: howto/cporting.rst:39 msgid "" "Python 3 merged together some types with similar functions while cleanly " "separating others." msgstr "" -#: ../src/Doc/howto/cporting.rst:44 +#: howto/cporting.rst:44 msgid "str/unicode Unification" msgstr "" # a9f354480a3642a9a9e475e80b310aee -#: ../src/Doc/howto/cporting.rst:46 +#: howto/cporting.rst:46 msgid "" "Python 3's :func:`str` type is equivalent to Python 2's :func:`unicode`; the " "C functions are called ``PyUnicode_*`` for both. The old 8-bit string type " @@ -644,12 +648,12 @@ msgid "" "`PyString`, and :c:type:`PyBytes`. ::" msgstr "" -#: ../src/Doc/howto/cporting.rst:95 +#: howto/cporting.rst:95 msgid "long/int Unification" msgstr "" # 3767f985b0b640ab86b6e4fcac418764 -#: ../src/Doc/howto/cporting.rst:97 +#: howto/cporting.rst:97 msgid "" "Python 3 has only one integer type, :func:`int`. But it actually " "corresponds to Python 2's :func:`long` type--the :func:`int` type used in " @@ -657,12 +661,12 @@ msgid "" "their ``PyLong_*`` equivalents." msgstr "" -#: ../src/Doc/howto/cporting.rst:104 +#: howto/cporting.rst:104 msgid "Module initialization and state" msgstr "" # 0926a05def714bc6be7470c21a597de2 -#: ../src/Doc/howto/cporting.rst:106 +#: howto/cporting.rst:106 msgid "" "Python 3 has a revamped extension module initialization system. (See :pep:" "`3121`.) Instead of storing module state in globals, they should be stored " @@ -672,12 +676,12 @@ msgid "" msgstr "" # 2b2b820305204eb98416dbc169903c6a -#: ../src/Doc/howto/cporting.rst:197 +#: howto/cporting.rst:197 msgid "CObject replaced with Capsule" msgstr "" # e40a24473fd74f3183273bf061bd0ae1 -#: ../src/Doc/howto/cporting.rst:199 +#: howto/cporting.rst:199 msgid "" "The :c:type:`Capsule` object was introduced in Python 3.1 and 2.7 to " "replace :c:type:`CObject`. CObjects were useful, but the :c:type:`CObject` " @@ -688,7 +692,7 @@ msgid "" msgstr "" # 74ae9cf398894df4b60b8564bb3748df -#: ../src/Doc/howto/cporting.rst:206 +#: howto/cporting.rst:206 msgid "" "If you're currently using CObjects, and you want to migrate to 3.1 or newer, " "you'll need to switch to Capsules. :c:type:`CObject` was deprecated in 3.1 " @@ -700,7 +704,7 @@ msgid "" msgstr "" # 2b7e3a305e1f464991a47c4c4d58c9e0 -#: ../src/Doc/howto/cporting.rst:216 +#: howto/cporting.rst:216 msgid "" "The following example header file :file:`capsulethunk.h` may solve the " "problem for you. Simply write your code against the :c:type:`Capsule` API " @@ -710,7 +714,7 @@ msgid "" msgstr "" # 8b1240e394814c219739b84896bc630a -#: ../src/Doc/howto/cporting.rst:223 +#: howto/cporting.rst:223 msgid "" ":file:`capsulethunk.h` simulates Capsules using CObjects. However, :c:type:" "`CObject` provides no place to store the capsule's \"name\". As a result " @@ -719,12 +723,12 @@ msgid "" msgstr "" # 691c2900ef5e425cbe070f2624ae02a5 -#: ../src/Doc/howto/cporting.rst:228 +#: howto/cporting.rst:228 msgid "The name parameter passed in to :c:func:`PyCapsule_New` is ignored." msgstr "" # a6ed5310b58f4270b84746b90266e4c5 -#: ../src/Doc/howto/cporting.rst:230 +#: howto/cporting.rst:230 msgid "" "The name parameter passed in to :c:func:`PyCapsule_IsValid` and :c:func:" "`PyCapsule_GetPointer` is ignored, and no error checking of the name is " @@ -732,12 +736,12 @@ msgid "" msgstr "" # 223109969e9a4a6c943bd1f206d9ff8c -#: ../src/Doc/howto/cporting.rst:234 +#: howto/cporting.rst:234 msgid ":c:func:`PyCapsule_GetName` always returns NULL." msgstr "" # 94468e8bbf364d05820aeca035f9f767 -#: ../src/Doc/howto/cporting.rst:236 +#: howto/cporting.rst:236 msgid "" ":c:func:`PyCapsule_SetName` always raises an exception and returns failure. " "(Since there's no way to store a name in a CObject, noisy failure of :c:func:" @@ -746,48 +750,48 @@ msgid "" msgstr "" # 7d9b3aa9994a47948fb61ddc42eaa6be -#: ../src/Doc/howto/cporting.rst:243 +#: howto/cporting.rst:243 msgid "" "You can find :file:`capsulethunk.h` in the Python source distribution as :" "source:`Doc/includes/capsulethunk.h`. We also include it here for your " "convenience:" msgstr "" -#: ../src/Doc/howto/cporting.rst:252 +#: howto/cporting.rst:252 msgid "Other options" msgstr "" # efe92c9f2c7f4d2ba14c533d6d0d159d -#: ../src/Doc/howto/cporting.rst:254 +#: howto/cporting.rst:254 msgid "" "If you are writing a new extension module, you might consider `Cython " "`_. It translates a Python-like language to C. The " "extension modules it creates are compatible with Python 3 and Python 2." msgstr "" -#: ../src/Doc/howto/curses.rst:5 +#: howto/curses.rst:5 msgid "Curses Programming with Python" msgstr "" -#: ../src/Doc/howto/curses.rst:7 +#: howto/curses.rst:7 msgid "A.M. Kuchling, Eric S. Raymond" msgstr "" -#: ../src/Doc/howto/curses.rst:8 +#: howto/curses.rst:8 msgid "2.03" msgstr "" -#: ../src/Doc/howto/curses.rst:13 +#: howto/curses.rst:13 msgid "" "This document describes how to write text-mode programs with Python 2.x, " "using the :mod:`curses` extension module to control the display." msgstr "" -#: ../src/Doc/howto/curses.rst:18 +#: howto/curses.rst:18 msgid "What is curses?" msgstr "" -#: ../src/Doc/howto/curses.rst:20 +#: howto/curses.rst:20 msgid "" "The curses library supplies a terminal-independent screen-painting and " "keyboard-handling facility for text-based terminals; such terminals include " @@ -798,7 +802,7 @@ msgid "" "and often have their own minor quirks." msgstr "" -#: ../src/Doc/howto/curses.rst:28 +#: howto/curses.rst:28 msgid "" "In a world of X displays, one might ask \"why bother\"? It's true that " "character-cell display terminals are an obsolete technology, but there are " @@ -808,7 +812,7 @@ msgid "" "have to run before X is available." msgstr "" -#: ../src/Doc/howto/curses.rst:35 +#: howto/curses.rst:35 msgid "" "The curses library hides all the details of different terminals, and " "provides the programmer with an abstraction of a display, containing " @@ -818,7 +822,7 @@ msgid "" "sent to the terminal to produce the right output." msgstr "" -#: ../src/Doc/howto/curses.rst:42 +#: howto/curses.rst:42 msgid "" "The curses library was originally written for BSD Unix; the later System V " "versions of Unix from AT&T added many enhancements and new functions. BSD " @@ -831,7 +835,7 @@ msgid "" "everything, though." msgstr "" -#: ../src/Doc/howto/curses.rst:52 +#: howto/curses.rst:52 msgid "" "No one has made a Windows port of the curses module. On a Windows platform, " "try the Console module written by Fredrik Lundh. The Console module " @@ -840,11 +844,11 @@ msgid "" "htm." msgstr "" -#: ../src/Doc/howto/curses.rst:59 +#: howto/curses.rst:59 msgid "The Python curses module" msgstr "" -#: ../src/Doc/howto/curses.rst:61 +#: howto/curses.rst:61 msgid "" "Thy Python module is a fairly simple wrapper over the C functions provided " "by curses; if you're already familiar with curses programming in C, it's " @@ -855,7 +859,7 @@ msgid "" "later." msgstr "" -#: ../src/Doc/howto/curses.rst:68 +#: howto/curses.rst:68 msgid "" "This HOWTO is simply an introduction to writing text-mode programs with " "curses and Python. It doesn't attempt to be a complete guide to the curses " @@ -863,11 +867,11 @@ msgid "" "manual pages for ncurses. It will, however, give you the basic ideas." msgstr "" -#: ../src/Doc/howto/curses.rst:75 +#: howto/curses.rst:75 msgid "Starting and ending a curses application" msgstr "" -#: ../src/Doc/howto/curses.rst:77 +#: howto/curses.rst:77 msgid "" "Before doing anything, curses must be initialized. This is done by calling " "the :func:`initscr` function, which will determine the terminal type, send " @@ -877,21 +881,21 @@ msgid "" "name of the corresponding C variable. ::" msgstr "" -#: ../src/Doc/howto/curses.rst:87 +#: howto/curses.rst:87 msgid "" "Usually curses applications turn off automatic echoing of keys to the " "screen, in order to be able to read keys and only display them under certain " "circumstances. This requires calling the :func:`noecho` function. ::" msgstr "" -#: ../src/Doc/howto/curses.rst:93 +#: howto/curses.rst:93 msgid "" "Applications will also commonly need to react to keys instantly, without " "requiring the Enter key to be pressed; this is called cbreak mode, as " "opposed to the usual buffered input mode. ::" msgstr "" -#: ../src/Doc/howto/curses.rst:99 +#: howto/curses.rst:99 msgid "" "Terminals usually return special keys, such as the cursor keys or navigation " "keys such as Page Up and Home, as a multibyte escape sequence. While you " @@ -901,20 +905,20 @@ msgid "" "keypad mode. ::" msgstr "" -#: ../src/Doc/howto/curses.rst:108 +#: howto/curses.rst:108 msgid "" "Terminating a curses application is much easier than starting one. You'll " "need to call ::" msgstr "" -#: ../src/Doc/howto/curses.rst:113 +#: howto/curses.rst:113 msgid "" "to reverse the curses-friendly terminal settings. Then call the :func:" "`endwin` function to restore the terminal to its original operating mode. ::" msgstr "" # 58b48c143b1144d09096bcf48a52b5ea -#: ../src/Doc/howto/curses.rst:118 +#: howto/curses.rst:118 msgid "" "A common problem when debugging a curses application is to get your terminal " "messed up when the application dies without restoring the terminal to its " @@ -923,7 +927,7 @@ msgid "" "you type them, for example, which makes using the shell difficult." msgstr "" -#: ../src/Doc/howto/curses.rst:124 +#: howto/curses.rst:124 msgid "" "In Python you can avoid these complications and make debugging much easier " "by importing the module :mod:`curses.wrapper`. It supplies a :func:" @@ -936,18 +940,18 @@ msgid "" "exception." msgstr "" -#: ../src/Doc/howto/curses.rst:135 +#: howto/curses.rst:135 msgid "Windows and Pads" msgstr "" -#: ../src/Doc/howto/curses.rst:137 +#: howto/curses.rst:137 msgid "" "Windows are the basic abstraction in curses. A window object represents a " "rectangular area of the screen, and supports various methods to display " "text, erase it, allow the user to input strings, and so forth." msgstr "" -#: ../src/Doc/howto/curses.rst:141 +#: howto/curses.rst:141 msgid "" "The ``stdscr`` object returned by the :func:`initscr` function is a window " "object that covers the entire screen. Many programs may need only this " @@ -956,7 +960,7 @@ msgid "" "creates a new window of a given size, returning the new window object. ::" msgstr "" -#: ../src/Doc/howto/curses.rst:151 +#: howto/curses.rst:151 msgid "" "A word about the coordinate system used in curses: coordinates are always " "passed in the order *y,x*, and the top-left corner of a window is coordinate " @@ -966,7 +970,7 @@ msgid "" "first written, and it's too late to change things now." msgstr "" -#: ../src/Doc/howto/curses.rst:158 +#: howto/curses.rst:158 msgid "" "When you call a method to display or erase text, the effect doesn't " "immediately show up on the display. This is because curses was originally " @@ -978,7 +982,7 @@ msgid "" "send the original characters because they'd never be visible." msgstr "" -#: ../src/Doc/howto/curses.rst:167 +#: howto/curses.rst:167 msgid "" "Accordingly, curses requires that you explicitly tell it to redraw windows, " "using the :func:`refresh` method of window objects. In practice, this " @@ -990,7 +994,7 @@ msgid "" "relevant window." msgstr "" -#: ../src/Doc/howto/curses.rst:176 +#: howto/curses.rst:176 msgid "" "A pad is a special case of a window; it can be larger than the actual " "display screen, and only a portion of it displayed at a time. Creating a pad " @@ -999,7 +1003,7 @@ msgid "" "will be displayed. ::" msgstr "" -#: ../src/Doc/howto/curses.rst:195 +#: howto/curses.rst:195 msgid "" "The :func:`refresh` call displays a section of the pad in the rectangle " "extending from coordinate (5,5) to coordinate (20,75) on the screen; the " @@ -1008,7 +1012,7 @@ msgid "" "the same methods." msgstr "" -#: ../src/Doc/howto/curses.rst:201 +#: howto/curses.rst:201 msgid "" "If you have multiple windows and pads on screen there is a more efficient " "way to go, which will prevent annoying screen flicker at refresh time. Use " @@ -1019,11 +1023,11 @@ msgid "" "last act." msgstr "" -#: ../src/Doc/howto/curses.rst:210 +#: howto/curses.rst:210 msgid "Displaying Text" msgstr "" -#: ../src/Doc/howto/curses.rst:212 +#: howto/curses.rst:212 msgid "" "From a C programmer's point of view, curses may sometimes look like a twisty " "maze of functions, all subtly different. For example, :func:`addstr` " @@ -1034,65 +1038,65 @@ msgid "" "func:`mvwaddstr` follows similarly." msgstr "" -#: ../src/Doc/howto/curses.rst:220 +#: howto/curses.rst:220 msgid "" "Fortunately the Python interface hides all these details; ``stdscr`` is a " "window object like any other, and methods like :func:`addstr` accept " "multiple argument forms. Usually there are four different forms." msgstr "" -#: ../src/Doc/howto/curses.rst:225 +#: howto/curses.rst:225 msgid "Form" msgstr "" -#: ../src/Doc/howto/curses.rst:225 ../src/Doc/howto/curses.rst:283 +#: howto/curses.rst:225 howto/curses.rst:283 msgid "Description" msgstr "" -#: ../src/Doc/howto/curses.rst:227 +#: howto/curses.rst:227 msgid "*str* or *ch*" msgstr "" -#: ../src/Doc/howto/curses.rst:227 +#: howto/curses.rst:227 msgid "Display the string *str* or character *ch* at the current position" msgstr "" -#: ../src/Doc/howto/curses.rst:230 +#: howto/curses.rst:230 msgid "*str* or *ch*, *attr*" msgstr "" -#: ../src/Doc/howto/curses.rst:230 +#: howto/curses.rst:230 msgid "" "Display the string *str* or character *ch*, using attribute *attr* at the " "current position" msgstr "" -#: ../src/Doc/howto/curses.rst:234 +#: howto/curses.rst:234 msgid "*y*, *x*, *str* or *ch*" msgstr "" -#: ../src/Doc/howto/curses.rst:234 +#: howto/curses.rst:234 msgid "Move to position *y,x* within the window, and display *str* or *ch*" msgstr "" -#: ../src/Doc/howto/curses.rst:237 +#: howto/curses.rst:237 msgid "*y*, *x*, *str* or *ch*, *attr*" msgstr "" -#: ../src/Doc/howto/curses.rst:237 +#: howto/curses.rst:237 msgid "" "Move to position *y,x* within the window, and display *str* or *ch*, using " "attribute *attr*" msgstr "" -#: ../src/Doc/howto/curses.rst:241 +#: howto/curses.rst:241 msgid "" "Attributes allow displaying text in highlighted forms, such as in boldface, " "underline, reverse code, or in color. They'll be explained in more detail " "in the next subsection." msgstr "" -#: ../src/Doc/howto/curses.rst:245 +#: howto/curses.rst:245 msgid "" "The :func:`addstr` function takes a Python string as the value to be " "displayed, while the :func:`addch` functions take a character, which can be " @@ -1103,7 +1107,7 @@ msgid "" "`ACS_ULCORNER` is the upper left corner of a box (handy for drawing borders)." msgstr "" -#: ../src/Doc/howto/curses.rst:253 +#: howto/curses.rst:253 msgid "" "Windows remember where the cursor was left after the last operation, so if " "you leave out the *y,x* coordinates, the string or character will be " @@ -1114,7 +1118,7 @@ msgid "" "cursor blinking at some apparently random location." msgstr "" -#: ../src/Doc/howto/curses.rst:261 +#: howto/curses.rst:261 msgid "" "If your application doesn't need a blinking cursor at all, you can call " "``curs_set(0)`` to make it invisible. Equivalently, and for compatibility " @@ -1123,11 +1127,11 @@ msgid "" "cursor, and you won't need to worry about leaving it in odd locations." msgstr "" -#: ../src/Doc/howto/curses.rst:269 +#: howto/curses.rst:269 msgid "Attributes and Color" msgstr "" -#: ../src/Doc/howto/curses.rst:271 +#: howto/curses.rst:271 msgid "" "Characters can be displayed in different ways. Status lines in a text-based " "application are commonly shown in reverse video; a text viewer may need to " @@ -1136,7 +1140,7 @@ msgid "" msgstr "" # d4ee7abe0a9845bab9d70653090828fa -#: ../src/Doc/howto/curses.rst:276 +#: howto/curses.rst:276 msgid "" "An attribute is an integer, each bit representing a different attribute. " "You can try to display text with multiple attribute bits set, but curses " @@ -1146,73 +1150,73 @@ msgid "" "attributes, listed here." msgstr "" -#: ../src/Doc/howto/curses.rst:283 +#: howto/curses.rst:283 msgid "Attribute" msgstr "" -#: ../src/Doc/howto/curses.rst:285 +#: howto/curses.rst:285 msgid ":const:`A_BLINK`" msgstr "" -#: ../src/Doc/howto/curses.rst:285 +#: howto/curses.rst:285 msgid "Blinking text" msgstr "" -#: ../src/Doc/howto/curses.rst:287 +#: howto/curses.rst:287 msgid ":const:`A_BOLD`" msgstr "" -#: ../src/Doc/howto/curses.rst:287 +#: howto/curses.rst:287 msgid "Extra bright or bold text" msgstr "" -#: ../src/Doc/howto/curses.rst:289 +#: howto/curses.rst:289 msgid ":const:`A_DIM`" msgstr "" -#: ../src/Doc/howto/curses.rst:289 +#: howto/curses.rst:289 msgid "Half bright text" msgstr "" -#: ../src/Doc/howto/curses.rst:291 +#: howto/curses.rst:291 msgid ":const:`A_REVERSE`" msgstr "" -#: ../src/Doc/howto/curses.rst:291 +#: howto/curses.rst:291 msgid "Reverse-video text" msgstr "" -#: ../src/Doc/howto/curses.rst:293 +#: howto/curses.rst:293 msgid ":const:`A_STANDOUT`" msgstr "" -#: ../src/Doc/howto/curses.rst:293 +#: howto/curses.rst:293 msgid "The best highlighting mode available" msgstr "" -#: ../src/Doc/howto/curses.rst:295 +#: howto/curses.rst:295 msgid ":const:`A_UNDERLINE`" msgstr "" -#: ../src/Doc/howto/curses.rst:295 +#: howto/curses.rst:295 msgid "Underlined text" msgstr "" -#: ../src/Doc/howto/curses.rst:298 +#: howto/curses.rst:298 msgid "" "So, to display a reverse-video status line on the top line of the screen, " "you could code::" msgstr "" # 410250bff4f14d3188d601724053c1f6 -#: ../src/Doc/howto/curses.rst:305 +#: howto/curses.rst:305 msgid "" "The curses library also supports color on those terminals that provide it. " "The most common such terminal is probably the Linux console, followed by " "color xterms." msgstr "" -#: ../src/Doc/howto/curses.rst:309 +#: howto/curses.rst:309 msgid "" "To use color, you must call the :func:`start_color` function soon after " "calling :func:`initscr`, to initialize the default color set (the :func:" @@ -1224,7 +1228,7 @@ msgid "" "for the sake of these functions.)" msgstr "" -#: ../src/Doc/howto/curses.rst:318 +#: howto/curses.rst:318 msgid "" "The curses library maintains a finite number of color pairs, containing a " "foreground (or text) color and a background color. You can get the " @@ -1234,11 +1238,11 @@ msgid "" "terminals." msgstr "" -#: ../src/Doc/howto/curses.rst:324 +#: howto/curses.rst:324 msgid "An example, which displays a line of text using color pair 1::" msgstr "" -#: ../src/Doc/howto/curses.rst:329 +#: howto/curses.rst:329 msgid "" "As I said before, a color pair consists of a foreground and background " "color. :func:`start_color` initializes 8 basic colors when it activates " @@ -1248,27 +1252,27 @@ msgid "" "forth." msgstr "" -#: ../src/Doc/howto/curses.rst:335 +#: howto/curses.rst:335 msgid "" "The ``init_pair(n, f, b)`` function changes the definition of color pair " "*n*, to foreground color f and background color b. Color pair 0 is hard-" "wired to white on black, and cannot be changed." msgstr "" -#: ../src/Doc/howto/curses.rst:339 +#: howto/curses.rst:339 msgid "" "Let's put all this together. To change color 1 to red text on a white " "background, you would call::" msgstr "" -#: ../src/Doc/howto/curses.rst:344 +#: howto/curses.rst:344 msgid "" "When you change a color pair, any text already displayed using that color " "pair will change to the new colors. You can also display new text in this " "color with::" msgstr "" -#: ../src/Doc/howto/curses.rst:350 +#: howto/curses.rst:350 msgid "" "Very fancy terminals can change the definitions of the actual colors to a " "given RGB value. This lets you change color 1, which is usually red, to " @@ -1280,17 +1284,17 @@ msgid "" "man pages for more information." msgstr "" -#: ../src/Doc/howto/curses.rst:360 +#: howto/curses.rst:360 msgid "User Input" msgstr "" -#: ../src/Doc/howto/curses.rst:362 +#: howto/curses.rst:362 msgid "" "The curses library itself offers only very simple input mechanisms. Python's " "support adds a text-input widget that makes up some of the lack." msgstr "" -#: ../src/Doc/howto/curses.rst:365 +#: howto/curses.rst:365 msgid "" "The most common way to get input to a window is to use its :meth:`getch` " "method. :meth:`getch` pauses and waits for the user to hit a key, displaying " @@ -1298,7 +1302,7 @@ msgid "" "coordinate to which the cursor should be moved before pausing." msgstr "" -#: ../src/Doc/howto/curses.rst:370 +#: howto/curses.rst:370 msgid "" "It's possible to change this behavior with the method :meth:`nodelay`. After " "``nodelay(1)``, :meth:`getch` for the window becomes non-blocking and " @@ -1308,7 +1312,7 @@ msgid "" "delay (measured in tenths of a second), curses raises an exception." msgstr "" -#: ../src/Doc/howto/curses.rst:377 +#: howto/curses.rst:377 msgid "" "The :meth:`getch` method returns an integer; if it's between 0 and 255, it " "represents the ASCII code of the key pressed. Values greater than 255 are " @@ -1318,7 +1322,7 @@ msgid "" "your program will look something like this::" msgstr "" -#: ../src/Doc/howto/curses.rst:393 +#: howto/curses.rst:393 msgid "" "The :mod:`curses.ascii` module supplies ASCII class membership functions " "that take either integer or 1-character-string arguments; these may be " @@ -1328,7 +1332,7 @@ msgid "" "ctrl` returns the control character corresponding to its argument." msgstr "" -#: ../src/Doc/howto/curses.rst:400 +#: howto/curses.rst:400 msgid "" "There's also a method to retrieve an entire string, :const:`getstr()`. It " "isn't used very often, because its functionality is quite limited; the only " @@ -1337,7 +1341,7 @@ msgid "" "characters. ::" msgstr "" -#: ../src/Doc/howto/curses.rst:410 +#: howto/curses.rst:410 msgid "" "The Python :mod:`curses.textpad` module supplies something better. With it, " "you can turn a window into a text box that supports an Emacs-like set of " @@ -1347,18 +1351,18 @@ msgid "" "for the details." msgstr "" -#: ../src/Doc/howto/curses.rst:419 +#: howto/curses.rst:419 msgid "For More Information" msgstr "" -#: ../src/Doc/howto/curses.rst:421 +#: howto/curses.rst:421 msgid "" "This HOWTO didn't cover some advanced topics, such as screen-scraping or " "capturing mouse events from an xterm instance. But the Python library page " "for the curses modules is now pretty complete. You should browse it next." msgstr "" -#: ../src/Doc/howto/curses.rst:425 +#: howto/curses.rst:425 msgid "" "If you're in doubt about the detailed behavior of any of the ncurses entry " "points, consult the manual pages for your curses implementation, whether " @@ -1367,7 +1371,7 @@ msgid "" "and :const:`ACS_\\*` characters available to you." msgstr "" -#: ../src/Doc/howto/curses.rst:431 +#: howto/curses.rst:431 msgid "" "Because the curses API is so large, some functions aren't supported in the " "Python interface, not because they're difficult to implement, but because no " @@ -1376,33 +1380,33 @@ msgid "" "ncurses; feel free to add that." msgstr "" -#: ../src/Doc/howto/curses.rst:437 +#: howto/curses.rst:437 msgid "" "If you write an interesting little program, feel free to contribute it as " "another demo. We can always use more of them!" msgstr "" -#: ../src/Doc/howto/curses.rst:440 +#: howto/curses.rst:440 msgid "The ncurses FAQ: http://invisible-island.net/ncurses/ncurses.faq.html" msgstr "" -#: ../src/Doc/howto/descriptor.rst:3 +#: howto/descriptor.rst:3 msgid "Descriptor HowTo Guide" msgstr "" -#: ../src/Doc/howto/descriptor.rst:5 +#: howto/descriptor.rst:5 msgid "Raymond Hettinger" msgstr "" -#: ../src/Doc/howto/descriptor.rst:6 +#: howto/descriptor.rst:6 msgid "" msgstr "" -#: ../src/Doc/howto/descriptor.rst:11 -msgid "Abstract" -msgstr "Résumé" +#: howto/descriptor.rst:0 +msgid "Contents" +msgstr "" -#: ../src/Doc/howto/descriptor.rst:13 +#: howto/descriptor.rst:13 msgid "" "Defines descriptors, summarizes the protocol, and shows how descriptors are " "called. Examines a custom descriptor and several built-in python " @@ -1411,18 +1415,18 @@ msgid "" "sample application." msgstr "" -#: ../src/Doc/howto/descriptor.rst:18 +#: howto/descriptor.rst:18 msgid "" "Learning about descriptors not only provides access to a larger toolset, it " "creates a deeper understanding of how Python works and an appreciation for " "the elegance of its design." msgstr "" -#: ../src/Doc/howto/descriptor.rst:24 +#: howto/descriptor.rst:24 msgid "Definition and Introduction" msgstr "" -#: ../src/Doc/howto/descriptor.rst:26 +#: howto/descriptor.rst:26 msgid "" "In general, a descriptor is an object attribute with \"binding behavior\", " "one whose attribute access has been overridden by methods in the descriptor " @@ -1431,7 +1435,7 @@ msgid "" "to be a descriptor." msgstr "" -#: ../src/Doc/howto/descriptor.rst:32 +#: howto/descriptor.rst:32 msgid "" "The default behavior for attribute access is to get, set, or delete the " "attribute from an object's dictionary. For instance, ``a.x`` has a lookup " @@ -1446,7 +1450,7 @@ msgid "" msgstr "" # 94ad4b1b102944dcba5a7169e0d492b4 -#: ../src/Doc/howto/descriptor.rst:43 +#: howto/descriptor.rst:43 msgid "" "Descriptors are a powerful, general purpose protocol. They are the " "mechanism behind properties, methods, static methods, class methods, and :" @@ -1456,30 +1460,30 @@ msgid "" "programs." msgstr "" -#: ../src/Doc/howto/descriptor.rst:51 +#: howto/descriptor.rst:51 msgid "Descriptor Protocol" msgstr "" -#: ../src/Doc/howto/descriptor.rst:53 +#: howto/descriptor.rst:53 msgid "``descr.__get__(self, obj, type=None) --> value``" msgstr "" -#: ../src/Doc/howto/descriptor.rst:55 +#: howto/descriptor.rst:55 msgid "``descr.__set__(self, obj, value) --> None``" msgstr "" -#: ../src/Doc/howto/descriptor.rst:57 +#: howto/descriptor.rst:57 msgid "``descr.__delete__(self, obj) --> None``" msgstr "" -#: ../src/Doc/howto/descriptor.rst:59 +#: howto/descriptor.rst:59 msgid "" "That is all there is to it. Define any of these methods and an object is " "considered a descriptor and can override default behavior upon being looked " "up as an attribute." msgstr "" -#: ../src/Doc/howto/descriptor.rst:63 +#: howto/descriptor.rst:63 msgid "" "If an object defines both :meth:`__get__` and :meth:`__set__`, it is " "considered a data descriptor. Descriptors that only define :meth:`__get__` " @@ -1487,7 +1491,7 @@ msgid "" "other uses are possible)." msgstr "" -#: ../src/Doc/howto/descriptor.rst:68 +#: howto/descriptor.rst:68 msgid "" "Data and non-data descriptors differ in how overrides are calculated with " "respect to entries in an instance's dictionary. If an instance's dictionary " @@ -1496,7 +1500,7 @@ msgid "" "name as a non-data descriptor, the dictionary entry takes precedence." msgstr "" -#: ../src/Doc/howto/descriptor.rst:74 +#: howto/descriptor.rst:74 msgid "" "To make a read-only data descriptor, define both :meth:`__get__` and :meth:" "`__set__` with the :meth:`__set__` raising an :exc:`AttributeError` when " @@ -1504,17 +1508,17 @@ msgid "" "placeholder is enough to make it a data descriptor." msgstr "" -#: ../src/Doc/howto/descriptor.rst:81 +#: howto/descriptor.rst:81 msgid "Invoking Descriptors" msgstr "" -#: ../src/Doc/howto/descriptor.rst:83 +#: howto/descriptor.rst:83 msgid "" "A descriptor can be called directly by its method name. For example, ``d." "__get__(obj)``." msgstr "" -#: ../src/Doc/howto/descriptor.rst:86 +#: howto/descriptor.rst:86 msgid "" "Alternatively, it is more common for a descriptor to be invoked " "automatically upon attribute access. For example, ``obj.d`` looks up ``d`` " @@ -1523,7 +1527,7 @@ msgid "" "below." msgstr "" -#: ../src/Doc/howto/descriptor.rst:91 +#: howto/descriptor.rst:91 msgid "" "The details of invocation depend on whether ``obj`` is an object or a class. " "Either way, descriptors only work for new style objects and classes. A " @@ -1531,7 +1535,7 @@ msgid "" msgstr "" # 32c6b54eec0943caa7922e7e27e65fa3 -#: ../src/Doc/howto/descriptor.rst:95 +#: howto/descriptor.rst:95 msgid "" "For objects, the machinery is in :meth:`object.__getattribute__` which " "transforms ``b.x`` into ``type(b).__dict__['x'].__get__(b, type(b))``. The " @@ -1542,46 +1546,46 @@ msgid "" "`PyObject_GenericGetAttr()` in :source:`Objects/object.c`." msgstr "" -#: ../src/Doc/howto/descriptor.rst:103 +#: howto/descriptor.rst:103 msgid "" "For classes, the machinery is in :meth:`type.__getattribute__` which " "transforms ``B.x`` into ``B.__dict__['x'].__get__(None, B)``. In pure " "Python, it looks like::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:114 +#: howto/descriptor.rst:114 msgid "The important points to remember are:" msgstr "" -#: ../src/Doc/howto/descriptor.rst:116 +#: howto/descriptor.rst:116 msgid "descriptors are invoked by the :meth:`__getattribute__` method" msgstr "" -#: ../src/Doc/howto/descriptor.rst:117 +#: howto/descriptor.rst:117 msgid "overriding :meth:`__getattribute__` prevents automatic descriptor calls" msgstr "" -#: ../src/Doc/howto/descriptor.rst:118 +#: howto/descriptor.rst:118 msgid "" ":meth:`__getattribute__` is only available with new style classes and objects" msgstr "" -#: ../src/Doc/howto/descriptor.rst:119 +#: howto/descriptor.rst:119 msgid "" ":meth:`object.__getattribute__` and :meth:`type.__getattribute__` make " "different calls to :meth:`__get__`." msgstr "" -#: ../src/Doc/howto/descriptor.rst:121 +#: howto/descriptor.rst:121 msgid "data descriptors always override instance dictionaries." msgstr "" -#: ../src/Doc/howto/descriptor.rst:122 +#: howto/descriptor.rst:122 msgid "non-data descriptors may be overridden by instance dictionaries." msgstr "" # 3175df0c7cc241b69f0ac69f941f4bbc -#: ../src/Doc/howto/descriptor.rst:124 +#: howto/descriptor.rst:124 msgid "" "The object returned by ``super()`` also has a custom :meth:" "`__getattribute__` method for invoking descriptors. The call ``super(B, " @@ -1592,7 +1596,7 @@ msgid "" msgstr "" # 08d87a377d0443f78b2dcfc064c9595a -#: ../src/Doc/howto/descriptor.rst:131 +#: howto/descriptor.rst:131 msgid "" "Note, in Python 2.2, ``super(B, obj).m()`` would only invoke :meth:`__get__` " "if ``m`` was a data descriptor. In Python 2.3, non-data descriptors also " @@ -1600,7 +1604,7 @@ msgid "" "details are in :c:func:`super_getattro()` in :source:`Objects/typeobject.c`." msgstr "" -#: ../src/Doc/howto/descriptor.rst:138 +#: howto/descriptor.rst:138 msgid "" "The details above show that the mechanism for descriptors is embedded in " "the :meth:`__getattribute__()` methods for :class:`object`, :class:`type`, " @@ -1610,11 +1614,11 @@ msgid "" "`__getattribute__()`." msgstr "" -#: ../src/Doc/howto/descriptor.rst:147 +#: howto/descriptor.rst:147 msgid "Descriptor Example" msgstr "" -#: ../src/Doc/howto/descriptor.rst:149 +#: howto/descriptor.rst:149 msgid "" "The following code creates a class whose objects are data descriptors which " "print a message for each get or set. Overriding :meth:`__getattribute__` is " @@ -1622,7 +1626,7 @@ msgid "" "descriptor is useful for monitoring just a few chosen attributes::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:187 +#: howto/descriptor.rst:187 msgid "" "The protocol is simple and offers exciting possibilities. Several use cases " "are so common that they have been packaged into individual function calls. " @@ -1630,35 +1634,35 @@ msgid "" "all based on the descriptor protocol." msgstr "" -#: ../src/Doc/howto/descriptor.rst:194 +#: howto/descriptor.rst:194 msgid "Properties" msgstr "" -#: ../src/Doc/howto/descriptor.rst:196 +#: howto/descriptor.rst:196 msgid "" "Calling :func:`property` is a succinct way of building a data descriptor " "that triggers function calls upon access to an attribute. Its signature is::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:201 +#: howto/descriptor.rst:201 msgid "" "The documentation shows a typical use to define a managed attribute ``x``::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:209 +#: howto/descriptor.rst:209 msgid "" "To see how :func:`property` is implemented in terms of the descriptor " "protocol, here is a pure Python equivalent::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:249 +#: howto/descriptor.rst:249 msgid "" "The :func:`property` builtin helps whenever a user interface has granted " "attribute access and then subsequent changes require the intervention of a " "method." msgstr "" -#: ../src/Doc/howto/descriptor.rst:253 +#: howto/descriptor.rst:253 msgid "" "For instance, a spreadsheet class may grant access to a cell value through " "``Cell('b10').value``. Subsequent improvements to the program require the " @@ -1668,17 +1672,17 @@ msgid "" "descriptor::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:269 +#: howto/descriptor.rst:269 msgid "Functions and Methods" msgstr "" -#: ../src/Doc/howto/descriptor.rst:271 +#: howto/descriptor.rst:271 msgid "" "Python's object oriented features are built upon a function based " "environment. Using non-data descriptors, the two are merged seamlessly." msgstr "" -#: ../src/Doc/howto/descriptor.rst:274 +#: howto/descriptor.rst:274 msgid "" "Class dictionaries store methods as functions. In a class definition, " "methods are written using :keyword:`def` and :keyword:`lambda`, the usual " @@ -1688,7 +1692,7 @@ msgid "" "or any other variable name." msgstr "" -#: ../src/Doc/howto/descriptor.rst:281 +#: howto/descriptor.rst:281 msgid "" "To support method calls, functions include the :meth:`__get__` method for " "binding methods during attribute access. This means that all functions are " @@ -1697,13 +1701,13 @@ msgid "" "this::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:293 +#: howto/descriptor.rst:293 msgid "" "Running the interpreter shows how the function descriptor works in practice::" msgstr "" # e4e859d3b5db442a8691474caa6bfcd8 -#: ../src/Doc/howto/descriptor.rst:307 +#: howto/descriptor.rst:307 msgid "" "The output suggests that bound and unbound methods are two different types. " "While they could have been implemented that way, the actual C implementation " @@ -1712,7 +1716,7 @@ msgid "" "`im_self` field is set or is *NULL* (the C equivalent of *None*)." msgstr "" -#: ../src/Doc/howto/descriptor.rst:313 +#: howto/descriptor.rst:313 msgid "" "Likewise, the effects of calling a method object depend on the :attr:" "`im_self` field. If set (meaning bound), the original function (stored in " @@ -1723,69 +1727,69 @@ msgid "" "some type checking." msgstr "" -#: ../src/Doc/howto/descriptor.rst:322 +#: howto/descriptor.rst:322 msgid "Static Methods and Class Methods" msgstr "" -#: ../src/Doc/howto/descriptor.rst:324 +#: howto/descriptor.rst:324 msgid "" "Non-data descriptors provide a simple mechanism for variations on the usual " "patterns of binding functions into methods." msgstr "" -#: ../src/Doc/howto/descriptor.rst:327 +#: howto/descriptor.rst:327 msgid "" "To recap, functions have a :meth:`__get__` method so that they can be " "converted to a method when accessed as attributes. The non-data descriptor " -"transforms a ``obj.f(*args)`` call into ``f(obj, *args)``. Calling ``klass." +"transforms an ``obj.f(*args)`` call into ``f(obj, *args)``. Calling ``klass." "f(*args)`` becomes ``f(*args)``." msgstr "" -#: ../src/Doc/howto/descriptor.rst:332 +#: howto/descriptor.rst:332 msgid "This chart summarizes the binding and its two most useful variants:" msgstr "" -#: ../src/Doc/howto/descriptor.rst:335 +#: howto/descriptor.rst:335 msgid "Transformation" msgstr "" -#: ../src/Doc/howto/descriptor.rst:335 +#: howto/descriptor.rst:335 msgid "Called from an Object" msgstr "" -#: ../src/Doc/howto/descriptor.rst:335 +#: howto/descriptor.rst:335 msgid "Called from a Class" msgstr "" -#: ../src/Doc/howto/descriptor.rst:338 +#: howto/descriptor.rst:338 msgid "function" msgstr "fonction" -#: ../src/Doc/howto/descriptor.rst:338 +#: howto/descriptor.rst:338 msgid "f(obj, \\*args)" msgstr "" -#: ../src/Doc/howto/descriptor.rst:338 ../src/Doc/howto/descriptor.rst:340 +#: howto/descriptor.rst:338 howto/descriptor.rst:340 msgid "f(\\*args)" msgstr "" -#: ../src/Doc/howto/descriptor.rst:340 +#: howto/descriptor.rst:340 msgid "staticmethod" msgstr "" -#: ../src/Doc/howto/descriptor.rst:342 +#: howto/descriptor.rst:342 msgid "classmethod" msgstr "" -#: ../src/Doc/howto/descriptor.rst:342 +#: howto/descriptor.rst:342 msgid "f(type(obj), \\*args)" msgstr "" -#: ../src/Doc/howto/descriptor.rst:342 +#: howto/descriptor.rst:342 msgid "f(klass, \\*args)" msgstr "" -#: ../src/Doc/howto/descriptor.rst:345 +#: howto/descriptor.rst:345 msgid "" "Static methods return the underlying function without changes. Calling " "either ``c.f`` or ``C.f`` is the equivalent of a direct lookup into ``object." @@ -1794,13 +1798,13 @@ msgid "" "a class." msgstr "" -#: ../src/Doc/howto/descriptor.rst:351 +#: howto/descriptor.rst:351 msgid "" "Good candidates for static methods are methods that do not reference the " "``self`` variable." msgstr "" -#: ../src/Doc/howto/descriptor.rst:354 +#: howto/descriptor.rst:354 msgid "" "For instance, a statistics package may include a container class for " "experimental data. The class provides normal methods for computing the " @@ -1812,26 +1816,26 @@ msgid "" "``s.erf(1.5) --> .9332`` or ``Sample.erf(1.5) --> .9332``." msgstr "" -#: ../src/Doc/howto/descriptor.rst:363 +#: howto/descriptor.rst:363 msgid "" "Since staticmethods return the underlying function with no changes, the " "example calls are unexciting::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:376 +#: howto/descriptor.rst:376 msgid "" "Using the non-data descriptor protocol, a pure Python version of :func:" "`staticmethod` would look like this::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:388 +#: howto/descriptor.rst:388 msgid "" "Unlike static methods, class methods prepend the class reference to the " "argument list before calling the function. This format is the same for " "whether the caller is an object or a class::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:403 +#: howto/descriptor.rst:403 msgid "" "This behavior is useful whenever the function only needs to have a class " "reference and does not care about any underlying data. One use for " @@ -1840,55 +1844,55 @@ msgid "" "keys. The pure Python equivalent is::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:419 +#: howto/descriptor.rst:419 msgid "Now a new dictionary of unique keys can be constructed like this::" msgstr "" -#: ../src/Doc/howto/descriptor.rst:424 +#: howto/descriptor.rst:424 msgid "" "Using the non-data descriptor protocol, a pure Python version of :func:" "`classmethod` would look like this::" msgstr "" -#: ../src/Doc/howto/doanddont.rst:3 +#: howto/doanddont.rst:3 msgid "Idioms and Anti-Idioms in Python" msgstr "" -#: ../src/Doc/howto/doanddont.rst:5 +#: howto/doanddont.rst:5 msgid "Moshe Zadka" msgstr "Moshe Zadka" -#: ../src/Doc/howto/doanddont.rst:7 +#: howto/doanddont.rst:7 msgid "This document is placed in the public domain." msgstr "" -#: ../src/Doc/howto/doanddont.rst:12 +#: howto/doanddont.rst:12 msgid "" "This document can be considered a companion to the tutorial. It shows how to " "use Python, and even more importantly, how *not* to use Python." msgstr "" -#: ../src/Doc/howto/doanddont.rst:17 +#: howto/doanddont.rst:17 msgid "Language Constructs You Should Not Use" msgstr "" -#: ../src/Doc/howto/doanddont.rst:19 +#: howto/doanddont.rst:19 msgid "" "While Python has relatively few gotchas compared to other languages, it " "still has some constructs which are only useful in corner cases, or are " "plain dangerous." msgstr "" -#: ../src/Doc/howto/doanddont.rst:25 +#: howto/doanddont.rst:25 msgid "from module import \\*" msgstr "" -#: ../src/Doc/howto/doanddont.rst:29 +#: howto/doanddont.rst:29 msgid "Inside Function Definitions" msgstr "" # 3b070374ab9c46db86141abca1cf9676 -#: ../src/Doc/howto/doanddont.rst:31 +#: howto/doanddont.rst:31 msgid "" "``from module import *`` is *invalid* inside function definitions. While " "many versions of Python do not check for the invalidity, it does not make it " @@ -1899,11 +1903,11 @@ msgid "" "warnings, and sometimes even errors." msgstr "" -#: ../src/Doc/howto/doanddont.rst:41 +#: howto/doanddont.rst:41 msgid "At Module Level" msgstr "" -#: ../src/Doc/howto/doanddont.rst:43 +#: howto/doanddont.rst:43 msgid "" "While it is valid to use ``from module import *`` at module level it is " "usually a bad idea. For one, this loses an important property Python " @@ -1914,12 +1918,12 @@ msgid "" msgstr "" # 8fcf2c18c08643d3ac37592887d0af07 -#: ../src/Doc/howto/doanddont.rst:49 +#: howto/doanddont.rst:49 msgid "" "One of the most awful questions asked on the newsgroup is why this code::" msgstr "" -#: ../src/Doc/howto/doanddont.rst:54 +#: howto/doanddont.rst:54 msgid "" "does not work. Of course, it works just fine (assuming you have a file " "called \"www\".) But it does not work if somewhere in the module, the " @@ -1929,7 +1933,7 @@ msgid "" msgstr "" # 0b24b7ab69d8496a94dbfaf694f4c904 -#: ../src/Doc/howto/doanddont.rst:60 +#: howto/doanddont.rst:60 msgid "" "Remember, you can never know for sure what names a module exports, so either " "take what you need --- ``from module import name1, name2``, or keep them in " @@ -1937,35 +1941,35 @@ msgid "" "name``." msgstr "" -#: ../src/Doc/howto/doanddont.rst:66 +#: howto/doanddont.rst:66 msgid "When It Is Just Fine" msgstr "" -#: ../src/Doc/howto/doanddont.rst:68 +#: howto/doanddont.rst:68 msgid "There are situations in which ``from module import *`` is just fine:" msgstr "" -#: ../src/Doc/howto/doanddont.rst:70 +#: howto/doanddont.rst:70 msgid "" "The interactive prompt. For example, ``from math import *`` makes Python an " "amazing scientific calculator." msgstr "" -#: ../src/Doc/howto/doanddont.rst:73 +#: howto/doanddont.rst:73 msgid "When extending a module in C with a module in Python." msgstr "" -#: ../src/Doc/howto/doanddont.rst:75 +#: howto/doanddont.rst:75 msgid "When the module advertises itself as ``from import *`` safe." msgstr "" # a8963819590c4e009a8034925e487be7 -#: ../src/Doc/howto/doanddont.rst:79 +#: howto/doanddont.rst:79 msgid "Unadorned :keyword:`exec`, :func:`execfile` and friends" msgstr "" # 6a2d4f68a14e4ad094bb2a91644ccc2f -#: ../src/Doc/howto/doanddont.rst:81 +#: howto/doanddont.rst:81 msgid "" "The word \"unadorned\" refers to the use without an explicit dictionary, in " "which case those constructs evaluate code in the *current* environment. This " @@ -1975,21 +1979,21 @@ msgid "" msgstr "" # 0c70c8e0c8ff4ffc94c2b6e1c9a61a99 -#: ../src/Doc/howto/doanddont.rst:87 +#: howto/doanddont.rst:87 msgid "Bad examples::" msgstr "" # d9f2b77e03bb473db871b2e8d4a745e7 -#: ../src/Doc/howto/doanddont.rst:97 +#: howto/doanddont.rst:97 msgid "Good examples::" msgstr "" -#: ../src/Doc/howto/doanddont.rst:112 +#: howto/doanddont.rst:112 msgid "from module import name1, name2" msgstr "" # deaddf57af464bbdb55a96b83622f6a0 -#: ../src/Doc/howto/doanddont.rst:114 +#: howto/doanddont.rst:114 msgid "" "This is a \"don't\" which is much weaker than the previous \"don't\"s but is " "still something you should not do if you don't have good reasons to do that. " @@ -2000,20 +2004,20 @@ msgid "" "changes the definition of a function at runtime." msgstr "" -#: ../src/Doc/howto/doanddont.rst:122 +#: howto/doanddont.rst:122 msgid "Bad example::" msgstr "" -#: ../src/Doc/howto/doanddont.rst:132 +#: howto/doanddont.rst:132 msgid "Good example::" msgstr "" -#: ../src/Doc/howto/doanddont.rst:144 +#: howto/doanddont.rst:144 msgid "except:" msgstr "" # db17e9662afe43ae89e4b42c1a0fb9aa -#: ../src/Doc/howto/doanddont.rst:146 +#: howto/doanddont.rst:146 msgid "" "Python has the ``except:`` clause, which catches all exceptions. Since " "*every* error in Python raises an exception, using ``except:`` can make many " @@ -2022,12 +2026,12 @@ msgid "" msgstr "" # 1cbe89098ac342f09741e7e90261bc33 -#: ../src/Doc/howto/doanddont.rst:151 +#: howto/doanddont.rst:151 msgid "The following code shows a great example of why this is bad::" msgstr "" # 94ddb2c34dea40a981d88196a9b00864 -#: ../src/Doc/howto/doanddont.rst:158 +#: howto/doanddont.rst:158 msgid "" "The second line triggers a :exc:`NameError`, which is caught by the except " "clause. The program will exit, and the error message the program prints will " @@ -2036,19 +2040,19 @@ msgid "" msgstr "" # 7ecf196aef1145f8a507557e4e7016b2 -#: ../src/Doc/howto/doanddont.rst:163 +#: howto/doanddont.rst:163 msgid "A better way to write the above is ::" msgstr "" # 797e00c6b49246bf8979c7cca3623937 -#: ../src/Doc/howto/doanddont.rst:170 +#: howto/doanddont.rst:170 msgid "" "When this is run, Python will produce a traceback showing the :exc:" "`NameError`, and it will be immediately apparent what needs to be fixed." msgstr "" # fc0f356ef48c4fa4b2dbbe3609a9e957 -#: ../src/Doc/howto/doanddont.rst:175 +#: howto/doanddont.rst:175 msgid "" "Because ``except:`` catches *all* exceptions, including :exc:`SystemExit`, :" "exc:`KeyboardInterrupt`, and :exc:`GeneratorExit` (which is not an error and " @@ -2062,23 +2066,23 @@ msgid "" "exceptions you don't want to catch." msgstr "" -#: ../src/Doc/howto/doanddont.rst:188 +#: howto/doanddont.rst:188 msgid "Exceptions" msgstr "Exceptions" -#: ../src/Doc/howto/doanddont.rst:190 +#: howto/doanddont.rst:190 msgid "" "Exceptions are a useful feature of Python. You should learn to raise them " "whenever something unexpected occurs, and catch them only where you can do " "something about them." msgstr "" -#: ../src/Doc/howto/doanddont.rst:194 +#: howto/doanddont.rst:194 msgid "The following is a very popular anti-idiom ::" msgstr "" # 0ad6de21dc6643bd850c8f0c58c01ebc -#: ../src/Doc/howto/doanddont.rst:202 +#: howto/doanddont.rst:202 msgid "" "Consider the case where the file gets deleted between the time the call to :" "func:`os.path.exists` is made and the time :func:`open` is called. In that " @@ -2091,12 +2095,12 @@ msgid "" msgstr "" # c8eab7af0acd48008890c503f21d2ccd -#: ../src/Doc/howto/doanddont.rst:211 +#: howto/doanddont.rst:211 msgid "Here is a somewhat better way to do it. ::" msgstr "" # 2ba23783cc7d48319a3bc36b8df9951d -#: ../src/Doc/howto/doanddont.rst:220 +#: howto/doanddont.rst:220 msgid "" "In this version, *either* the file gets opened and the line is read (so it " "works even on flaky NFS or SMB connections), or an error message is printed " @@ -2105,7 +2109,7 @@ msgid "" msgstr "" # af3b6105fb7e4b31a835dc790835749f -#: ../src/Doc/howto/doanddont.rst:225 +#: howto/doanddont.rst:225 msgid "" "However, even this version of :func:`get_status` makes too many assumptions " "--- that it will only be used in a short running script, and not, say, in a " @@ -2113,7 +2117,7 @@ msgid "" msgstr "" # 9e71123b51df43f7ad1e8b1eff75a716 -#: ../src/Doc/howto/doanddont.rst:234 +#: howto/doanddont.rst:234 msgid "" "But there is a better way. You should try to use as few ``except`` clauses " "in your code as you can --- the ones you do use will usually be inside calls " @@ -2121,12 +2125,12 @@ msgid "" msgstr "" # 6f65e970712d46fab77f1f3081ef512a -#: ../src/Doc/howto/doanddont.rst:238 +#: howto/doanddont.rst:238 msgid "So, an even better version of :func:`get_status()` is probably ::" msgstr "" # 0b812ac3a9744e2fab79e636f82a76e6 -#: ../src/Doc/howto/doanddont.rst:243 +#: howto/doanddont.rst:243 msgid "" "The caller can deal with the exception if it wants (for example, if it tries " "several files in a loop), or just let the exception filter upwards to *its* " @@ -2134,7 +2138,7 @@ msgid "" msgstr "" # 7a82e50381a347cda1f1463bb8728797 -#: ../src/Doc/howto/doanddont.rst:247 +#: howto/doanddont.rst:247 msgid "" "But the last version still has a serious problem --- due to implementation " "details in CPython, the file would not be closed when an exception is raised " @@ -2144,18 +2148,18 @@ msgid "" msgstr "" # 68f0bff64070451587bc0b260a486cf5 -#: ../src/Doc/howto/doanddont.rst:253 +#: howto/doanddont.rst:253 msgid "" "The best version of this function uses the ``open()`` call as a context " "manager, which will ensure that the file gets closed as soon as the function " "returns::" msgstr "" -#: ../src/Doc/howto/doanddont.rst:263 +#: howto/doanddont.rst:263 msgid "Using the Batteries" msgstr "" -#: ../src/Doc/howto/doanddont.rst:265 +#: howto/doanddont.rst:265 msgid "" "Every so often, people seem to be writing stuff in the Python library again, " "usually poorly. While the occasional module has a poor interface, it is " @@ -2163,25 +2167,25 @@ msgid "" "come with Python than inventing your own." msgstr "" -#: ../src/Doc/howto/doanddont.rst:270 +#: howto/doanddont.rst:270 msgid "" "A useful module very few people know about is :mod:`os.path`. It always has " "the correct path arithmetic for your operating system, and will usually be " "much better than whatever you come up with yourself." msgstr "" -#: ../src/Doc/howto/doanddont.rst:274 +#: howto/doanddont.rst:274 msgid "Compare::" msgstr "" -#: ../src/Doc/howto/doanddont.rst:281 +#: howto/doanddont.rst:281 msgid "" "More useful functions in :mod:`os.path`: :func:`basename`, :func:`dirname` " "and :func:`splitext`." msgstr "" # bd47e3bd1e094e6796b843e2c662d783 -#: ../src/Doc/howto/doanddont.rst:284 +#: howto/doanddont.rst:284 msgid "" "There are also many useful built-in functions people seem not to be aware of " "for some reason: :func:`min` and :func:`max` can find the minimum/maximum of " @@ -2193,25 +2197,25 @@ msgid "" msgstr "" # 59605a0b22674180978040f9513b9392 -#: ../src/Doc/howto/doanddont.rst:297 +#: howto/doanddont.rst:297 msgid "" "When it comes to parsing numbers, note that :func:`float`, :func:`int` and :" "func:`long` all accept string arguments and will reject ill-formed strings " "by raising an :exc:`ValueError`." msgstr "" -#: ../src/Doc/howto/doanddont.rst:303 +#: howto/doanddont.rst:303 msgid "Using Backslash to Continue Statements" msgstr "" -#: ../src/Doc/howto/doanddont.rst:305 +#: howto/doanddont.rst:305 msgid "" "Since Python treats a newline as a statement terminator, and since " "statements are often more than is comfortable to put in one line, many " "people do::" msgstr "" -#: ../src/Doc/howto/doanddont.rst:312 +#: howto/doanddont.rst:312 msgid "" "You should realize that this is dangerous: a stray space after the ``\\`` " "would make this line wrong, and stray spaces are notoriously hard to see in " @@ -2219,33 +2223,33 @@ msgid "" "was::" msgstr "" -#: ../src/Doc/howto/doanddont.rst:319 +#: howto/doanddont.rst:319 msgid "then it would just be subtly wrong." msgstr "" -#: ../src/Doc/howto/doanddont.rst:321 +#: howto/doanddont.rst:321 msgid "" "It is usually much better to use the implicit continuation inside " "parenthesis:" msgstr "" -#: ../src/Doc/howto/doanddont.rst:323 +#: howto/doanddont.rst:323 msgid "This version is bulletproof::" msgstr "" -#: ../src/Doc/howto/functional.rst:3 +#: howto/functional.rst:3 msgid "Functional Programming HOWTO" msgstr "" -#: ../src/Doc/howto/functional.rst:5 +#: howto/functional.rst:5 msgid "A. M. Kuchling" msgstr "" -#: ../src/Doc/howto/functional.rst:6 +#: howto/functional.rst:6 msgid "0.31" msgstr "" -#: ../src/Doc/howto/functional.rst:8 +#: howto/functional.rst:8 msgid "" "In this document, we'll take a tour of Python's features suitable for " "implementing programs in a functional style. After an introduction to the " @@ -2254,31 +2258,30 @@ msgid "" "such as :mod:`itertools` and :mod:`functools`." msgstr "" -#: ../src/Doc/howto/functional.rst:16 ../src/Doc/howto/regex.rst:24 -#: ../src/Doc/howto/urllib2.rst:16 +#: howto/functional.rst:16 howto/regex.rst:24 howto/urllib2.rst:16 msgid "Introduction" msgstr "Introduction" -#: ../src/Doc/howto/functional.rst:18 +#: howto/functional.rst:18 msgid "" "This section explains the basic concept of functional programming; if you're " "just interested in learning about Python language features, skip to the next " "section." msgstr "" -#: ../src/Doc/howto/functional.rst:22 +#: howto/functional.rst:22 msgid "" "Programming languages support decomposing problems in several different ways:" msgstr "" -#: ../src/Doc/howto/functional.rst:24 +#: howto/functional.rst:24 msgid "" "Most programming languages are **procedural**: programs are lists of " "instructions that tell the computer what to do with the program's input. C, " "Pascal, and even Unix shells are procedural languages." msgstr "" -#: ../src/Doc/howto/functional.rst:28 +#: howto/functional.rst:28 msgid "" "In **declarative** languages, you write a specification that describes the " "problem to be solved, and the language implementation figures out how to " @@ -2288,7 +2291,7 @@ msgid "" "indexes, which subclauses should be performed first, etc." msgstr "" -#: ../src/Doc/howto/functional.rst:35 +#: howto/functional.rst:35 msgid "" "**Object-oriented** programs manipulate collections of objects. Objects " "have internal state and support methods that query or modify this internal " @@ -2297,7 +2300,7 @@ msgid "" "force the use of object-oriented features." msgstr "" -#: ../src/Doc/howto/functional.rst:41 +#: howto/functional.rst:41 msgid "" "**Functional** programming decomposes a problem into a set of functions. " "Ideally, functions only take inputs and produce outputs, and don't have any " @@ -2307,7 +2310,7 @@ msgid "" msgstr "" # f43392e813194be1b5b91376136aa56f -#: ../src/Doc/howto/functional.rst:47 +#: howto/functional.rst:47 msgid "" "The designers of some computer languages choose to emphasize one particular " "approach to programming. This often makes it difficult to write programs " @@ -2320,7 +2323,7 @@ msgid "" "functional, for example." msgstr "" -#: ../src/Doc/howto/functional.rst:57 +#: howto/functional.rst:57 msgid "" "In a functional program, input flows through a set of functions. Each " "function operates on its input and produces some output. Functional style " @@ -2332,7 +2335,7 @@ msgid "" msgstr "" # 5d8fb7519dda449396718895458147a8 -#: ../src/Doc/howto/functional.rst:65 +#: howto/functional.rst:65 msgid "" "Some languages are very strict about purity and don't even have assignment " "statements such as ``a=3`` or ``c = a + b``, but it's difficult to avoid all " @@ -2343,7 +2346,7 @@ msgid "" "second." msgstr "" -#: ../src/Doc/howto/functional.rst:73 +#: howto/functional.rst:73 msgid "" "Python programs written in functional style usually won't go to the extreme " "of avoiding all I/O or all assignments; instead, they'll provide a " @@ -2353,7 +2356,7 @@ msgid "" "other side effects." msgstr "" -#: ../src/Doc/howto/functional.rst:79 +#: howto/functional.rst:79 msgid "" "Functional programming can be considered the opposite of object-oriented " "programming. Objects are little capsules containing some internal state " @@ -2365,40 +2368,40 @@ msgid "" "objects in your application (e-mail messages, transactions, etc.)." msgstr "" -#: ../src/Doc/howto/functional.rst:88 +#: howto/functional.rst:88 msgid "" "Functional design may seem like an odd constraint to work under. Why should " "you avoid objects and side effects? There are theoretical and practical " "advantages to the functional style:" msgstr "" -#: ../src/Doc/howto/functional.rst:92 +#: howto/functional.rst:92 msgid "Formal provability." msgstr "" -#: ../src/Doc/howto/functional.rst:93 +#: howto/functional.rst:93 msgid "Modularity." msgstr "" -#: ../src/Doc/howto/functional.rst:94 +#: howto/functional.rst:94 msgid "Composability." msgstr "" -#: ../src/Doc/howto/functional.rst:95 +#: howto/functional.rst:95 msgid "Ease of debugging and testing." msgstr "" -#: ../src/Doc/howto/functional.rst:99 +#: howto/functional.rst:99 msgid "Formal provability" msgstr "" -#: ../src/Doc/howto/functional.rst:101 +#: howto/functional.rst:101 msgid "" "A theoretical benefit is that it's easier to construct a mathematical proof " "that a functional program is correct." msgstr "" -#: ../src/Doc/howto/functional.rst:104 +#: howto/functional.rst:104 msgid "" "For a long time researchers have been interested in finding ways to " "mathematically prove programs correct. This is different from testing a " @@ -2408,7 +2411,7 @@ msgid "" "the right result for all possible inputs." msgstr "" -#: ../src/Doc/howto/functional.rst:111 +#: howto/functional.rst:111 msgid "" "The technique used to prove programs correct is to write down " "**invariants**, properties of the input data and of the program's variables " @@ -2419,7 +2422,7 @@ msgid "" "invariants should match the desired conditions on the program's output." msgstr "" -#: ../src/Doc/howto/functional.rst:119 +#: howto/functional.rst:119 msgid "" "Functional programming's avoidance of assignments arose because assignments " "are difficult to handle with this technique; assignments can break " @@ -2427,7 +2430,7 @@ msgid "" "invariants that can be propagated onward." msgstr "" -#: ../src/Doc/howto/functional.rst:124 +#: howto/functional.rst:124 msgid "" "Unfortunately, proving programs correct is largely impractical and not " "relevant to Python software. Even trivial programs require proofs that are " @@ -2439,11 +2442,11 @@ msgid "" "wrongly believe you've proved the program correct." msgstr "" -#: ../src/Doc/howto/functional.rst:135 +#: howto/functional.rst:135 msgid "Modularity" msgstr "" -#: ../src/Doc/howto/functional.rst:137 +#: howto/functional.rst:137 msgid "" "A more practical benefit of functional programming is that it forces you to " "break apart your problem into small pieces. Programs are more modular as a " @@ -2452,15 +2455,15 @@ msgid "" "Small functions are also easier to read and to check for errors." msgstr "" -#: ../src/Doc/howto/functional.rst:145 +#: howto/functional.rst:145 msgid "Ease of debugging and testing" msgstr "" -#: ../src/Doc/howto/functional.rst:147 +#: howto/functional.rst:147 msgid "Testing and debugging a functional-style program is easier." msgstr "" -#: ../src/Doc/howto/functional.rst:149 +#: howto/functional.rst:149 msgid "" "Debugging is simplified because functions are generally small and clearly " "specified. When a program doesn't work, each function is an interface point " @@ -2469,7 +2472,7 @@ msgid "" "responsible for a bug." msgstr "" -#: ../src/Doc/howto/functional.rst:154 +#: howto/functional.rst:154 msgid "" "Testing is easier because each function is a potential subject for a unit " "test. Functions don't depend on system state that needs to be replicated " @@ -2477,11 +2480,11 @@ msgid "" "and then check that the output matches expectations." msgstr "" -#: ../src/Doc/howto/functional.rst:161 +#: howto/functional.rst:161 msgid "Composability" msgstr "" -#: ../src/Doc/howto/functional.rst:163 +#: howto/functional.rst:163 msgid "" "As you work on a functional-style program, you'll write a number of " "functions with varying inputs and outputs. Some of these functions will be " @@ -2492,25 +2495,25 @@ msgid "" "different situations." msgstr "" -#: ../src/Doc/howto/functional.rst:170 +#: howto/functional.rst:170 msgid "" "Over time you'll form a personal library of utilities. Often you'll " "assemble new programs by arranging existing functions in a new configuration " "and writing a few functions specialized for the current task." msgstr "" -#: ../src/Doc/howto/functional.rst:176 +#: howto/functional.rst:176 msgid "Iterators" msgstr "Itérateurs" -#: ../src/Doc/howto/functional.rst:178 +#: howto/functional.rst:178 msgid "" "I'll start by looking at a Python language feature that's an important " "foundation for writing functional-style programs: iterators." msgstr "" # 8965b08b62e44a9c9a04dc6bdb9fd4fb -#: ../src/Doc/howto/functional.rst:181 +#: howto/functional.rst:181 msgid "" "An iterator is an object representing a stream of data; this object returns " "the data one element at a time. A Python iterator must support a method " @@ -2521,7 +2524,7 @@ msgid "" "produces an infinite stream of data." msgstr "" -#: ../src/Doc/howto/functional.rst:189 +#: howto/functional.rst:189 msgid "" "The built-in :func:`iter` function takes an arbitrary object and tries to " "return an iterator that will return the object's contents or elements, " @@ -2531,11 +2534,11 @@ msgid "" "can get an iterator for it." msgstr "" -#: ../src/Doc/howto/functional.rst:196 +#: howto/functional.rst:196 msgid "You can experiment with the iteration interface manually:" msgstr "" -#: ../src/Doc/howto/functional.rst:214 +#: howto/functional.rst:214 msgid "" "Python expects iterable objects in several different contexts, the most " "important being the ``for`` statement. In the statement ``for X in Y``, Y " @@ -2543,20 +2546,20 @@ msgid "" "iterator. These two statements are equivalent::" msgstr "" -#: ../src/Doc/howto/functional.rst:225 +#: howto/functional.rst:225 msgid "" "Iterators can be materialized as lists or tuples by using the :func:`list` " "or :func:`tuple` constructor functions:" msgstr "" -#: ../src/Doc/howto/functional.rst:234 +#: howto/functional.rst:234 msgid "" "Sequence unpacking also supports iterators: if you know an iterator will " "return N elements, you can unpack them into an N-tuple:" msgstr "" # 022f038034b94aa8878123cce12a6832 -#: ../src/Doc/howto/functional.rst:243 +#: howto/functional.rst:243 msgid "" "Built-in functions such as :func:`max` and :func:`min` can take a single " "iterator argument and will return the largest or smallest element. The ``" @@ -2567,7 +2570,7 @@ msgid "" "stream, the ``\"in\"`` and ``\"not in\"`` operators won't return either." msgstr "" -#: ../src/Doc/howto/functional.rst:251 +#: howto/functional.rst:251 msgid "" "Note that you can only go forward in an iterator; there's no way to get the " "previous element, reset the iterator, or make a copy of it. Iterator " @@ -2578,31 +2581,31 @@ msgid "" "iterator." msgstr "" -#: ../src/Doc/howto/functional.rst:261 +#: howto/functional.rst:261 msgid "Data Types That Support Iterators" msgstr "" -#: ../src/Doc/howto/functional.rst:263 +#: howto/functional.rst:263 msgid "" "We've already seen how lists and tuples support iterators. In fact, any " "Python sequence type, such as strings, will automatically support creation " "of an iterator." msgstr "" -#: ../src/Doc/howto/functional.rst:267 +#: howto/functional.rst:267 msgid "" "Calling :func:`iter` on a dictionary returns an iterator that will loop over " "the dictionary's keys:" msgstr "" -#: ../src/Doc/howto/functional.rst:291 +#: howto/functional.rst:291 msgid "" "Note that the order is essentially random, because it's based on the hash " "ordering of the objects in the dictionary." msgstr "" # 4ef7e00921324cf49d2f2566fd8aae12 -#: ../src/Doc/howto/functional.rst:294 +#: howto/functional.rst:294 msgid "" "Applying ``iter()`` to a dictionary always loops over the keys, but " "dictionaries have methods that return other iterators. If you want to " @@ -2611,30 +2614,30 @@ msgid "" "appropriate iterator." msgstr "" -#: ../src/Doc/howto/functional.rst:299 +#: howto/functional.rst:299 msgid "" "The :func:`dict` constructor can accept an iterator that returns a finite " "stream of ``(key, value)`` tuples:" msgstr "" -#: ../src/Doc/howto/functional.rst:306 +#: howto/functional.rst:306 msgid "" "Files also support iteration by calling the ``readline()`` method until " "there are no more lines in the file. This means you can read each line of a " "file like this::" msgstr "" -#: ../src/Doc/howto/functional.rst:314 +#: howto/functional.rst:314 msgid "" "Sets can take their contents from an iterable and let you iterate over the " "set's elements::" msgstr "" -#: ../src/Doc/howto/functional.rst:324 +#: howto/functional.rst:324 msgid "Generator expressions and list comprehensions" msgstr "" -#: ../src/Doc/howto/functional.rst:326 +#: howto/functional.rst:326 msgid "" "Two common operations on an iterator's output are 1) performing some " "operation for every element, 2) selecting a subset of elements that meet " @@ -2643,7 +2646,7 @@ msgid "" "containing a given substring." msgstr "" -#: ../src/Doc/howto/functional.rst:332 +#: howto/functional.rst:332 msgid "" "List comprehensions and generator expressions (short form: \"listcomps\" and " "\"genexps\") are a concise notation for such operations, borrowed from the " @@ -2651,12 +2654,12 @@ msgid "" "strip all the whitespace from a stream of strings with the following code::" msgstr "" -#: ../src/Doc/howto/functional.rst:345 +#: howto/functional.rst:345 msgid "" "You can select only certain elements by adding an ``\"if\"`` condition::" msgstr "" -#: ../src/Doc/howto/functional.rst:350 +#: howto/functional.rst:350 msgid "" "With a list comprehension, you get back a Python list; ``stripped_list`` is " "a list containing the resulting lines, not an iterator. Generator " @@ -2667,20 +2670,20 @@ msgid "" "preferable in these situations." msgstr "" -#: ../src/Doc/howto/functional.rst:357 +#: howto/functional.rst:357 msgid "" "Generator expressions are surrounded by parentheses (\"()\") and list " "comprehensions are surrounded by square brackets (\"[]\"). Generator " "expressions have the form::" msgstr "" -#: ../src/Doc/howto/functional.rst:370 +#: howto/functional.rst:370 msgid "" "Again, for a list comprehension only the outside brackets are different " "(square brackets instead of parentheses)." msgstr "" -#: ../src/Doc/howto/functional.rst:373 +#: howto/functional.rst:373 msgid "" "The elements of the generated output will be the successive values of " "``expression``. The ``if`` clauses are all optional; if present, " @@ -2688,14 +2691,14 @@ msgid "" "is true." msgstr "" -#: ../src/Doc/howto/functional.rst:377 +#: howto/functional.rst:377 msgid "" "Generator expressions always have to be written inside parentheses, but the " "parentheses signalling a function call also count. If you want to create an " "iterator that will be immediately passed to a function you can write::" msgstr "" -#: ../src/Doc/howto/functional.rst:383 +#: howto/functional.rst:383 msgid "" "The ``for...in`` clauses contain the sequences to be iterated over. The " "sequences do not have to be the same length, because they are iterated over " @@ -2705,13 +2708,13 @@ msgid "" "``sequence2``." msgstr "" -#: ../src/Doc/howto/functional.rst:389 +#: howto/functional.rst:389 msgid "" "To put it another way, a list comprehension or generator expression is " "equivalent to the following Python code::" msgstr "" -#: ../src/Doc/howto/functional.rst:406 +#: howto/functional.rst:406 msgid "" "This means that when there are multiple ``for...in`` clauses but no ``if`` " "clauses, the length of the resulting output will be equal to the product of " @@ -2719,25 +2722,25 @@ msgid "" "output list is 9 elements long:" msgstr "" -#: ../src/Doc/howto/functional.rst:421 +#: howto/functional.rst:421 msgid "" "To avoid introducing an ambiguity into Python's grammar, if ``expression`` " "is creating a tuple, it must be surrounded with parentheses. The first list " "comprehension below is a syntax error, while the second one is correct::" msgstr "" -#: ../src/Doc/howto/functional.rst:432 +#: howto/functional.rst:432 msgid "Generators" msgstr "Générateurs" -#: ../src/Doc/howto/functional.rst:434 +#: howto/functional.rst:434 msgid "" "Generators are a special class of functions that simplify the task of " "writing iterators. Regular functions compute a value and return it, but " "generators return an iterator that returns a stream of values." msgstr "" -#: ../src/Doc/howto/functional.rst:438 +#: howto/functional.rst:438 msgid "" "You're doubtless familiar with how regular function calls work in Python or " "C. When you call a function, it gets a private namespace where its local " @@ -2750,11 +2753,11 @@ msgid "" "thought of as resumable functions." msgstr "" -#: ../src/Doc/howto/functional.rst:447 +#: howto/functional.rst:447 msgid "Here's the simplest example of a generator function:" msgstr "" -#: ../src/Doc/howto/functional.rst:455 +#: howto/functional.rst:455 msgid "" "Any function containing a ``yield`` keyword is a generator function; this is " "detected by Python's :term:`bytecode` compiler which compiles the function " @@ -2762,7 +2765,7 @@ msgid "" msgstr "" # 2a76967001804636ad2fcfa6bbed0045 -#: ../src/Doc/howto/functional.rst:459 +#: howto/functional.rst:459 msgid "" "When you call a generator function, it doesn't return a single value; " "instead it returns a generator object that supports the iterator protocol. " @@ -2774,17 +2777,17 @@ msgid "" "function will resume executing." msgstr "" -#: ../src/Doc/howto/functional.rst:467 +#: howto/functional.rst:467 msgid "Here's a sample usage of the ``generate_ints()`` generator:" msgstr "" -#: ../src/Doc/howto/functional.rst:484 +#: howto/functional.rst:484 msgid "" "You could equally write ``for i in generate_ints(5)``, or ``a,b,c = " "generate_ints(3)``." msgstr "" -#: ../src/Doc/howto/functional.rst:487 +#: howto/functional.rst:487 msgid "" "Inside a generator function, the ``return`` statement can only be used " "without a value, and signals the end of the procession of values; after " @@ -2796,7 +2799,7 @@ msgid "" msgstr "" # d2309684b2ca48d492c27e55375610b2 -#: ../src/Doc/howto/functional.rst:495 +#: howto/functional.rst:495 msgid "" "You could achieve the effect of generators manually by writing your own " "class and storing all the local variables of the generator as instance " @@ -2806,14 +2809,14 @@ msgid "" "generator, writing a corresponding class can be much messier." msgstr "" -#: ../src/Doc/howto/functional.rst:502 +#: howto/functional.rst:502 msgid "" "The test suite included with Python's library, ``test_generators.py``, " "contains a number of more interesting examples. Here's one generator that " "implements an in-order traversal of a tree using generators recursively. ::" msgstr "" -#: ../src/Doc/howto/functional.rst:517 +#: howto/functional.rst:517 msgid "" "Two other examples in ``test_generators.py`` produce solutions for the N-" "Queens problem (placing N queens on an NxN chess board so that no queen " @@ -2822,11 +2825,11 @@ msgid "" "twice)." msgstr "" -#: ../src/Doc/howto/functional.rst:525 +#: howto/functional.rst:525 msgid "Passing values into a generator" msgstr "" -#: ../src/Doc/howto/functional.rst:527 +#: howto/functional.rst:527 msgid "" "In Python 2.4 and earlier, generators only produced output. Once a " "generator's code was invoked to create an iterator, there was no way to pass " @@ -2836,14 +2839,14 @@ msgid "" "these approaches are messy." msgstr "" -#: ../src/Doc/howto/functional.rst:534 +#: howto/functional.rst:534 msgid "" "In Python 2.5 there's a simple way to pass values into a generator. :keyword:" "`yield` became an expression, returning a value that can be assigned to a " "variable or otherwise operated on::" msgstr "" -#: ../src/Doc/howto/functional.rst:540 +#: howto/functional.rst:540 msgid "" "I recommend that you **always** put parentheses around a ``yield`` " "expression when you're doing something with the returned value, as in the " @@ -2851,7 +2854,7 @@ msgid "" "always add them instead of having to remember when they're needed." msgstr "" -#: ../src/Doc/howto/functional.rst:545 +#: howto/functional.rst:545 msgid "" "(PEP 342 explains the exact rules, which are that a ``yield``-expression " "must always be parenthesized except when it occurs at the top-level " @@ -2861,7 +2864,7 @@ msgid "" msgstr "" # 1f679b3767324cfead3c677ba8360bd6 -#: ../src/Doc/howto/functional.rst:551 +#: howto/functional.rst:551 msgid "" "Values are sent into a generator by calling its ``send(value)`` method. " "This method resumes the generator's code and the ``yield`` expression " @@ -2869,18 +2872,18 @@ msgid "" "the ``yield`` returns ``None``." msgstr "" -#: ../src/Doc/howto/functional.rst:556 +#: howto/functional.rst:556 msgid "" "Here's a simple counter that increments by 1 and allows changing the value " "of the internal counter." msgstr "" -#: ../src/Doc/howto/functional.rst:571 +#: howto/functional.rst:571 msgid "And here's an example of changing the counter:" msgstr "" # 0f566a83104f47b5b21fe1564a340bcc -#: ../src/Doc/howto/functional.rst:588 +#: howto/functional.rst:588 msgid "" "Because ``yield`` will often be returning ``None``, you should always check " "for this case. Don't just use its value in expressions unless you're sure " @@ -2888,19 +2891,19 @@ msgid "" "generator function." msgstr "" -#: ../src/Doc/howto/functional.rst:593 +#: howto/functional.rst:593 msgid "" "In addition to ``send()``, there are two other new methods on generators:" msgstr "" -#: ../src/Doc/howto/functional.rst:595 +#: howto/functional.rst:595 msgid "" "``throw(type, value=None, traceback=None)`` is used to raise an exception " "inside the generator; the exception is raised by the ``yield`` expression " "where the generator's execution is paused." msgstr "" -#: ../src/Doc/howto/functional.rst:599 +#: howto/functional.rst:599 msgid "" "``close()`` raises a :exc:`GeneratorExit` exception inside the generator to " "terminate the iteration. On receiving this exception, the generator's code " @@ -2910,20 +2913,20 @@ msgid "" "collector when the generator is garbage-collected." msgstr "" -#: ../src/Doc/howto/functional.rst:606 +#: howto/functional.rst:606 msgid "" "If you need to run cleanup code when a :exc:`GeneratorExit` occurs, I " "suggest using a ``try: ... finally:`` suite instead of catching :exc:" "`GeneratorExit`." msgstr "" -#: ../src/Doc/howto/functional.rst:609 +#: howto/functional.rst:609 msgid "" "The cumulative effect of these changes is to turn generators from one-way " "producers of information into both producers and consumers." msgstr "" -#: ../src/Doc/howto/functional.rst:612 +#: howto/functional.rst:612 msgid "" "Generators also become **coroutines**, a more generalized form of " "subroutines. Subroutines are entered at one point and exited at another " @@ -2932,17 +2935,17 @@ msgid "" "statements)." msgstr "" -#: ../src/Doc/howto/functional.rst:619 +#: howto/functional.rst:619 msgid "Built-in functions" msgstr "" -#: ../src/Doc/howto/functional.rst:621 +#: howto/functional.rst:621 msgid "" "Let's look in more detail at built-in functions often used with iterators." msgstr "" # db9c4b853dca458791d1b8dc23b975f7 -#: ../src/Doc/howto/functional.rst:623 +#: howto/functional.rst:623 msgid "" "Two of Python's built-in functions, :func:`map` and :func:`filter`, are " "somewhat obsolete; they duplicate the features of list comprehensions but " @@ -2950,14 +2953,14 @@ msgid "" msgstr "" # ccd98d828be7454b9d7c8680999c584e -#: ../src/Doc/howto/functional.rst:627 +#: howto/functional.rst:627 msgid "" "``map(f, iterA, iterB, ...)`` returns a list containing ``f(iterA[0], " "iterB[0]), f(iterA[1], iterB[1]), f(iterA[2], iterB[2]), ...``." msgstr "" # a50c24b2bf454f8fb65d97ad4832ad0c -#: ../src/Doc/howto/functional.rst:639 +#: howto/functional.rst:639 msgid "" "As shown above, you can achieve the same effect with a list comprehension. " "The :func:`itertools.imap` function does the same thing but can handle " @@ -2966,7 +2969,7 @@ msgid "" msgstr "" # c95bd811a5f94c6ebf1518eea49e0e03 -#: ../src/Doc/howto/functional.rst:643 +#: howto/functional.rst:643 msgid "" "``filter(predicate, iter)`` returns a list that contains all the sequence " "elements that meet a certain condition, and is similarly duplicated by list " @@ -2975,12 +2978,12 @@ msgid "" "single value." msgstr "" -#: ../src/Doc/howto/functional.rst:655 +#: howto/functional.rst:655 msgid "This can also be written as a list comprehension:" msgstr "" # 58422958eb7d4136824dd1d1a38d4079 -#: ../src/Doc/howto/functional.rst:660 +#: howto/functional.rst:660 msgid "" ":func:`filter` also has a counterpart in the :mod:`itertools` module, :func:" "`itertools.ifilter`, that returns an iterator and can therefore handle " @@ -2988,7 +2991,7 @@ msgid "" msgstr "" # d764b6408cf9446ab21bd2e0490a23ff -#: ../src/Doc/howto/functional.rst:664 +#: howto/functional.rst:664 msgid "" "``reduce(func, iter, [initial_value])`` doesn't have a counterpart in the :" "mod:`itertools` module because it cumulatively performs an operation on all " @@ -3004,7 +3007,7 @@ msgid "" msgstr "" # bb2dcf92629848a9a8a82414382b3c0c -#: ../src/Doc/howto/functional.rst:688 +#: howto/functional.rst:688 msgid "" "If you use :func:`operator.add` with :func:`reduce`, you'll add up all the " "elements of the iterable. This case is so common that there's a special " @@ -3012,27 +3015,27 @@ msgid "" msgstr "" # 443c8c29d8c742339a48bdd4f27f655d -#: ../src/Doc/howto/functional.rst:699 +#: howto/functional.rst:699 msgid "" "For many uses of :func:`reduce`, though, it can be clearer to just write the " "obvious :keyword:`for` loop::" msgstr "" # 1a6b37109b904b81a1359d6563ec8572 -#: ../src/Doc/howto/functional.rst:711 +#: howto/functional.rst:711 msgid "" "``enumerate(iter)`` counts off the elements in the iterable, returning 2-" "tuples containing the count and each element." msgstr "" -#: ../src/Doc/howto/functional.rst:720 +#: howto/functional.rst:720 msgid "" ":func:`enumerate` is often used when looping through a list and recording " "the indexes at which certain conditions are met::" msgstr "" # 4a860e3a6a1447838f78526da75dea72 -#: ../src/Doc/howto/functional.rst:728 +#: howto/functional.rst:728 msgid "" "``sorted(iterable, [cmp=None], [key=None], [reverse=False])`` collects all " "the elements of the iterable into a list, sorts the list, and returns the " @@ -3041,14 +3044,14 @@ msgid "" msgstr "" # 40b61bab800c418d9af70280f48db5e5 -#: ../src/Doc/howto/functional.rst:743 +#: howto/functional.rst:743 msgid "" "(For a more detailed discussion of sorting, see the Sorting mini-HOWTO in " "the Python wiki at https://wiki.python.org/moin/HowTo/Sorting.)" msgstr "" # c4d9ef84666c4a6a89abb857a22d2658 -#: ../src/Doc/howto/functional.rst:746 +#: howto/functional.rst:746 msgid "" "The ``any(iter)`` and ``all(iter)`` built-ins look at the truth values of an " "iterable's contents. :func:`any` returns ``True`` if any element in the " @@ -3056,23 +3059,23 @@ msgid "" "elements are true values:" msgstr "" -#: ../src/Doc/howto/functional.rst:766 +#: howto/functional.rst:766 msgid "Small functions and the lambda expression" msgstr "" -#: ../src/Doc/howto/functional.rst:768 +#: howto/functional.rst:768 msgid "" "When writing functional-style programs, you'll often need little functions " "that act as predicates or that combine elements in some way." msgstr "" -#: ../src/Doc/howto/functional.rst:771 +#: howto/functional.rst:771 msgid "" "If there's a Python built-in or a module function that's suitable, you don't " "need to define a new function at all::" msgstr "" -#: ../src/Doc/howto/functional.rst:777 +#: howto/functional.rst:777 msgid "" "If the function you need doesn't exist, you need to write it. One way to " "write small functions is to use the ``lambda`` statement. ``lambda`` takes " @@ -3080,19 +3083,19 @@ msgid "" "creates a small function that returns the value of the expression::" msgstr "" -#: ../src/Doc/howto/functional.rst:788 +#: howto/functional.rst:788 msgid "" "An alternative is to just use the ``def`` statement and define a function in " "the usual way::" msgstr "" -#: ../src/Doc/howto/functional.rst:800 +#: howto/functional.rst:800 msgid "" "Which alternative is preferable? That's a style question; my usual course " "is to avoid using ``lambda``." msgstr "" -#: ../src/Doc/howto/functional.rst:803 +#: howto/functional.rst:803 msgid "" "One reason for my preference is that ``lambda`` is quite limited in the " "functions it can define. The result has to be computable as a single " @@ -3102,116 +3105,116 @@ msgid "" "that's hard to read. Quick, what's the following code doing?" msgstr "" -#: ../src/Doc/howto/functional.rst:814 +#: howto/functional.rst:814 msgid "" "You can figure it out, but it takes time to disentangle the expression to " "figure out what's going on. Using a short nested ``def`` statements makes " "things a little bit better::" msgstr "" -#: ../src/Doc/howto/functional.rst:823 +#: howto/functional.rst:823 msgid "But it would be best of all if I had simply used a ``for`` loop::" msgstr "" -#: ../src/Doc/howto/functional.rst:829 +#: howto/functional.rst:829 msgid "Or the :func:`sum` built-in and a generator expression::" msgstr "" # b24d1d1e5f5d472e89a5dbe9e6a31b54 -#: ../src/Doc/howto/functional.rst:833 +#: howto/functional.rst:833 msgid "Many uses of :func:`reduce` are clearer when written as ``for`` loops." msgstr "" -#: ../src/Doc/howto/functional.rst:835 +#: howto/functional.rst:835 msgid "" "Fredrik Lundh once suggested the following set of rules for refactoring uses " "of ``lambda``:" msgstr "" -#: ../src/Doc/howto/functional.rst:838 +#: howto/functional.rst:838 msgid "Write a lambda function." msgstr "" -#: ../src/Doc/howto/functional.rst:839 +#: howto/functional.rst:839 msgid "Write a comment explaining what the heck that lambda does." msgstr "" -#: ../src/Doc/howto/functional.rst:840 +#: howto/functional.rst:840 msgid "" "Study the comment for a while, and think of a name that captures the essence " "of the comment." msgstr "" -#: ../src/Doc/howto/functional.rst:842 +#: howto/functional.rst:842 msgid "Convert the lambda to a def statement, using that name." msgstr "" -#: ../src/Doc/howto/functional.rst:843 +#: howto/functional.rst:843 msgid "Remove the comment." msgstr "" -#: ../src/Doc/howto/functional.rst:845 +#: howto/functional.rst:845 msgid "" "I really like these rules, but you're free to disagree about whether this " "lambda-free style is better." msgstr "" -#: ../src/Doc/howto/functional.rst:850 +#: howto/functional.rst:850 msgid "The itertools module" msgstr "" -#: ../src/Doc/howto/functional.rst:852 +#: howto/functional.rst:852 msgid "" "The :mod:`itertools` module contains a number of commonly-used iterators as " "well as functions for combining several iterators. This section will " "introduce the module's contents by showing small examples." msgstr "" -#: ../src/Doc/howto/functional.rst:856 +#: howto/functional.rst:856 msgid "The module's functions fall into a few broad classes:" msgstr "" -#: ../src/Doc/howto/functional.rst:858 +#: howto/functional.rst:858 msgid "Functions that create a new iterator based on an existing iterator." msgstr "" -#: ../src/Doc/howto/functional.rst:859 +#: howto/functional.rst:859 msgid "Functions for treating an iterator's elements as function arguments." msgstr "" -#: ../src/Doc/howto/functional.rst:860 +#: howto/functional.rst:860 msgid "Functions for selecting portions of an iterator's output." msgstr "" -#: ../src/Doc/howto/functional.rst:861 +#: howto/functional.rst:861 msgid "A function for grouping an iterator's output." msgstr "" -#: ../src/Doc/howto/functional.rst:864 +#: howto/functional.rst:864 msgid "Creating new iterators" msgstr "" -#: ../src/Doc/howto/functional.rst:866 +#: howto/functional.rst:866 msgid "" "``itertools.count(n)`` returns an infinite stream of integers, increasing by " "1 each time. You can optionally supply the starting number, which defaults " "to 0::" msgstr "" -#: ../src/Doc/howto/functional.rst:874 +#: howto/functional.rst:874 msgid "" "``itertools.cycle(iter)`` saves a copy of the contents of a provided " "iterable and returns a new iterator that returns its elements from first to " "last. The new iterator will repeat these elements infinitely. ::" msgstr "" -#: ../src/Doc/howto/functional.rst:881 +#: howto/functional.rst:881 msgid "" "``itertools.repeat(elem, [n])`` returns the provided element ``n`` times, or " "returns the element endlessly if ``n`` is not provided. ::" msgstr "" -#: ../src/Doc/howto/functional.rst:889 +#: howto/functional.rst:889 msgid "" "``itertools.chain(iterA, iterB, ...)`` takes an arbitrary number of " "iterables as input, and returns all the elements of the first iterator, then " @@ -3220,14 +3223,14 @@ msgid "" msgstr "" # 775bb2fb158242ec8e0c8c8a6114b633 -#: ../src/Doc/howto/functional.rst:896 +#: howto/functional.rst:896 msgid "" "``itertools.izip(iterA, iterB, ...)`` takes one element from each iterable " "and returns them in a tuple::" msgstr "" # 4dfde9f89b0d4743a23d94b6633a1f72 -#: ../src/Doc/howto/functional.rst:902 +#: howto/functional.rst:902 msgid "" "It's similar to the built-in :func:`zip` function, but doesn't construct an " "in-memory list and exhaust all the input iterators before returning; instead " @@ -3236,21 +3239,21 @@ msgid "" "org/wiki/Lazy_evaluation>`__.)" msgstr "" -#: ../src/Doc/howto/functional.rst:908 +#: howto/functional.rst:908 msgid "" "This iterator is intended to be used with iterables that are all of the same " "length. If the iterables are of different lengths, the resulting stream " "will be the same length as the shortest iterable. ::" msgstr "" -#: ../src/Doc/howto/functional.rst:915 +#: howto/functional.rst:915 msgid "" "You should avoid doing this, though, because an element may be taken from " "the longer iterators and discarded. This means you can't go on to use the " "iterators further because you risk skipping a discarded element." msgstr "" -#: ../src/Doc/howto/functional.rst:919 +#: howto/functional.rst:919 msgid "" "``itertools.islice(iter, [start], stop, [step])`` returns a stream that's a " "slice of the iterator. With a single ``stop`` argument, it will return the " @@ -3260,7 +3263,7 @@ msgid "" "negative values for ``start``, ``stop``, or ``step``. ::" msgstr "" -#: ../src/Doc/howto/functional.rst:933 +#: howto/functional.rst:933 msgid "" "``itertools.tee(iter, [n])`` replicates an iterator; it returns ``n`` " "independent iterators that will all return the contents of the source " @@ -3270,26 +3273,26 @@ msgid "" "and one of the new iterators is consumed more than the others. ::" msgstr "" -#: ../src/Doc/howto/functional.rst:951 +#: howto/functional.rst:951 msgid "Calling functions on elements" msgstr "" # 9c19f240e894413c879f743d48a97030 -#: ../src/Doc/howto/functional.rst:953 +#: howto/functional.rst:953 msgid "" "Two functions are used for calling other functions on the contents of an " "iterable." msgstr "" # 0759bbd996f7403fb911682ff3ec88bb -#: ../src/Doc/howto/functional.rst:956 +#: howto/functional.rst:956 msgid "" "``itertools.imap(f, iterA, iterB, ...)`` returns a stream containing " "``f(iterA[0], iterB[0]), f(iterA[1], iterB[1]), f(iterA[2], iterB[2]), ..." "``::" msgstr "" -#: ../src/Doc/howto/functional.rst:962 +#: howto/functional.rst:962 msgid "" "The ``operator`` module contains a set of functions corresponding to " "Python's operators. Some examples are ``operator.add(a, b)`` (adds two " @@ -3298,54 +3301,54 @@ msgid "" "attribute)." msgstr "" -#: ../src/Doc/howto/functional.rst:967 +#: howto/functional.rst:967 msgid "" "``itertools.starmap(func, iter)`` assumes that the iterable will return a " "stream of tuples, and calls ``f()`` using these tuples as the arguments::" msgstr "" -#: ../src/Doc/howto/functional.rst:978 +#: howto/functional.rst:978 msgid "Selecting elements" msgstr "" -#: ../src/Doc/howto/functional.rst:980 +#: howto/functional.rst:980 msgid "" "Another group of functions chooses a subset of an iterator's elements based " "on a predicate." msgstr "" # eb4b0d8c72964a87ba6c0b8652d5ae90 -#: ../src/Doc/howto/functional.rst:983 +#: howto/functional.rst:983 msgid "" "``itertools.ifilter(predicate, iter)`` returns all the elements for which " "the predicate returns true::" msgstr "" # 7955827bd4b14ebc85b8a282478d275d -#: ../src/Doc/howto/functional.rst:992 +#: howto/functional.rst:992 msgid "" "``itertools.ifilterfalse(predicate, iter)`` is the opposite, returning all " "elements for which the predicate returns false::" msgstr "" -#: ../src/Doc/howto/functional.rst:998 +#: howto/functional.rst:998 msgid "" "``itertools.takewhile(predicate, iter)`` returns elements for as long as the " "predicate returns true. Once the predicate returns false, the iterator will " "signal the end of its results." msgstr "" -#: ../src/Doc/howto/functional.rst:1013 +#: howto/functional.rst:1013 msgid "" "``itertools.dropwhile(predicate, iter)`` discards elements while the " "predicate returns true, and then returns the rest of the iterable's results." msgstr "" -#: ../src/Doc/howto/functional.rst:1026 +#: howto/functional.rst:1026 msgid "Grouping elements" msgstr "" -#: ../src/Doc/howto/functional.rst:1028 +#: howto/functional.rst:1028 msgid "" "The last function I'll discuss, ``itertools.groupby(iter, key_func=None)``, " "is the most complicated. ``key_func(elem)`` is a function that can compute " @@ -3353,14 +3356,14 @@ msgid "" "a key function, the key is simply each element itself." msgstr "" -#: ../src/Doc/howto/functional.rst:1033 +#: howto/functional.rst:1033 msgid "" "``groupby()`` collects all the consecutive elements from the underlying " "iterable that have the same key value, and returns a stream of 2-tuples " "containing a key value and an iterator for the elements with that key." msgstr "" -#: ../src/Doc/howto/functional.rst:1061 +#: howto/functional.rst:1061 msgid "" "``groupby()`` assumes that the underlying iterable's contents will already " "be sorted based on the key. Note that the returned iterators also use the " @@ -3368,11 +3371,11 @@ msgid "" "requesting iterator-2 and its corresponding key." msgstr "" -#: ../src/Doc/howto/functional.rst:1068 +#: howto/functional.rst:1068 msgid "The functools module" msgstr "" -#: ../src/Doc/howto/functional.rst:1070 +#: howto/functional.rst:1070 msgid "" "The :mod:`functools` module in Python 2.5 contains some higher-order " "functions. A **higher-order function** takes one or more functions as input " @@ -3380,7 +3383,7 @@ msgid "" "func:`functools.partial` function." msgstr "" -#: ../src/Doc/howto/functional.rst:1075 +#: howto/functional.rst:1075 msgid "" "For programs written in a functional style, you'll sometimes want to " "construct variants of existing functions that have some of the parameters " @@ -3390,7 +3393,7 @@ msgid "" "\"partial function application\"." msgstr "" -#: ../src/Doc/howto/functional.rst:1081 +#: howto/functional.rst:1081 msgid "" "The constructor for ``partial`` takes the arguments ``(function, arg1, " "arg2, ... kwarg1=value1, kwarg2=value2)``. The resulting object is " @@ -3398,15 +3401,15 @@ msgid "" "arguments." msgstr "" -#: ../src/Doc/howto/functional.rst:1085 +#: howto/functional.rst:1085 msgid "Here's a small but realistic example::" msgstr "" -#: ../src/Doc/howto/functional.rst:1099 +#: howto/functional.rst:1099 msgid "The operator module" msgstr "" -#: ../src/Doc/howto/functional.rst:1101 +#: howto/functional.rst:1101 msgid "" "The :mod:`operator` module was mentioned earlier. It contains a set of " "functions corresponding to Python's operators. These functions are often " @@ -3414,43 +3417,43 @@ msgid "" "functions that perform a single operation." msgstr "" -#: ../src/Doc/howto/functional.rst:1106 +#: howto/functional.rst:1106 msgid "Some of the functions in this module are:" msgstr "" # e45e8f8244a247e2ac07d059683e532e -#: ../src/Doc/howto/functional.rst:1108 +#: howto/functional.rst:1108 msgid "" "Math operations: ``add()``, ``sub()``, ``mul()``, ``div()``, ``floordiv()``, " "``abs()``, ..." msgstr "" -#: ../src/Doc/howto/functional.rst:1110 +#: howto/functional.rst:1110 msgid "Logical operations: ``not_()``, ``truth()``." msgstr "" -#: ../src/Doc/howto/functional.rst:1111 +#: howto/functional.rst:1111 msgid "Bitwise operations: ``and_()``, ``or_()``, ``invert()``." msgstr "" -#: ../src/Doc/howto/functional.rst:1112 +#: howto/functional.rst:1112 msgid "" "Comparisons: ``eq()``, ``ne()``, ``lt()``, ``le()``, ``gt()``, and ``ge()``." msgstr "" -#: ../src/Doc/howto/functional.rst:1113 +#: howto/functional.rst:1113 msgid "Object identity: ``is_()``, ``is_not()``." msgstr "" -#: ../src/Doc/howto/functional.rst:1115 +#: howto/functional.rst:1115 msgid "Consult the operator module's documentation for a complete list." msgstr "" -#: ../src/Doc/howto/functional.rst:1119 ../src/Doc/howto/unicode.rst:696 +#: howto/functional.rst:1119 howto/unicode.rst:696 msgid "Revision History and Acknowledgements" msgstr "" -#: ../src/Doc/howto/functional.rst:1121 +#: howto/functional.rst:1121 msgid "" "The author would like to thank the following people for offering " "suggestions, corrections and assistance with various drafts of this article: " @@ -3458,41 +3461,41 @@ msgid "" "Krell, Leandro Lameiro, Jussi Salmela, Collin Winter, Blake Winton." msgstr "" -#: ../src/Doc/howto/functional.rst:1126 +#: howto/functional.rst:1126 msgid "Version 0.1: posted June 30 2006." msgstr "" -#: ../src/Doc/howto/functional.rst:1128 +#: howto/functional.rst:1128 msgid "Version 0.11: posted July 1 2006. Typo fixes." msgstr "" -#: ../src/Doc/howto/functional.rst:1130 +#: howto/functional.rst:1130 msgid "" "Version 0.2: posted July 10 2006. Merged genexp and listcomp sections into " "one. Typo fixes." msgstr "" -#: ../src/Doc/howto/functional.rst:1133 +#: howto/functional.rst:1133 msgid "" "Version 0.21: Added more references suggested on the tutor mailing list." msgstr "" -#: ../src/Doc/howto/functional.rst:1135 +#: howto/functional.rst:1135 msgid "" "Version 0.30: Adds a section on the ``functional`` module written by Collin " "Winter; adds short section on the operator module; a few other edits." msgstr "" -#: ../src/Doc/howto/functional.rst:1140 ../src/Doc/howto/unicode.rst:205 -#: ../src/Doc/howto/unicode.rst:492 ../src/Doc/howto/unicode.rst:686 +#: howto/functional.rst:1140 howto/unicode.rst:205 howto/unicode.rst:492 +#: howto/unicode.rst:686 msgid "References" msgstr "" -#: ../src/Doc/howto/functional.rst:1143 +#: howto/functional.rst:1143 msgid "General" msgstr "" -#: ../src/Doc/howto/functional.rst:1145 +#: howto/functional.rst:1145 msgid "" "**Structure and Interpretation of Computer Programs**, by Harold Abelson and " "Gerald Jay Sussman with Julie Sussman. Full text at http://mitpress.mit.edu/" @@ -3503,33 +3506,33 @@ msgid "" "Python code." msgstr "" -#: ../src/Doc/howto/functional.rst:1153 +#: howto/functional.rst:1153 msgid "" "http://www.defmacro.org/ramblings/fp.html: A general introduction to " "functional programming that uses Java examples and has a lengthy historical " "introduction." msgstr "" -#: ../src/Doc/howto/functional.rst:1156 +#: howto/functional.rst:1156 msgid "" "http://en.wikipedia.org/wiki/Functional_programming: General Wikipedia entry " "describing functional programming." msgstr "" -#: ../src/Doc/howto/functional.rst:1159 +#: howto/functional.rst:1159 msgid "http://en.wikipedia.org/wiki/Coroutine: Entry for coroutines." msgstr "" -#: ../src/Doc/howto/functional.rst:1161 +#: howto/functional.rst:1161 msgid "" "http://en.wikipedia.org/wiki/Currying: Entry for the concept of currying." msgstr "" -#: ../src/Doc/howto/functional.rst:1164 +#: howto/functional.rst:1164 msgid "Python-specific" msgstr "" -#: ../src/Doc/howto/functional.rst:1166 +#: howto/functional.rst:1166 msgid "" "http://gnosis.cx/TPiP/: The first chapter of David Mertz's book :title-" "reference:`Text Processing in Python` discusses functional programming for " @@ -3538,14 +3541,14 @@ msgid "" msgstr "" # 0433fa1150da4ff7b3cd48a20c08fbf0 -#: ../src/Doc/howto/functional.rst:1171 +#: howto/functional.rst:1171 msgid "" "Mertz also wrote a 3-part series of articles on functional programming for " "IBM's DeveloperWorks site; see" msgstr "" # 79a43c0711b445a5a544cba9fb2691ca -#: ../src/Doc/howto/functional.rst:1174 +#: howto/functional.rst:1174 msgid "" "`part 1 `__, `part 2 `__," msgstr "" -#: ../src/Doc/howto/functional.rst:1180 +#: howto/functional.rst:1180 msgid "Python documentation" msgstr "" -#: ../src/Doc/howto/functional.rst:1182 +#: howto/functional.rst:1182 msgid "Documentation for the :mod:`itertools` module." msgstr "" -#: ../src/Doc/howto/functional.rst:1184 +#: howto/functional.rst:1184 msgid "Documentation for the :mod:`operator` module." msgstr "" -#: ../src/Doc/howto/functional.rst:1186 +#: howto/functional.rst:1186 msgid ":pep:`289`: \"Generator Expressions\"" msgstr "" -#: ../src/Doc/howto/functional.rst:1188 +#: howto/functional.rst:1188 msgid "" ":pep:`342`: \"Coroutines via Enhanced Generators\" describes the new " "generator features in Python 2.5." msgstr "" -#: ../src/Doc/howto/index.rst:3 +#: howto/index.rst:3 msgid "Python HOWTOs" msgstr "Les HOWTOs de Python [en]" -#: ../src/Doc/howto/index.rst:5 +#: howto/index.rst:5 msgid "" "Python HOWTOs are documents that cover a single, specific topic, and attempt " "to cover it fairly completely. Modelled on the Linux Documentation Project's " @@ -3587,28 +3590,28 @@ msgid "" "that's more detailed than the Python Library Reference." msgstr "" -#: ../src/Doc/howto/index.rst:11 +#: howto/index.rst:11 msgid "Currently, the HOWTOs are:" msgstr "" # 4f1f57103f294dc395ce3431cc9330b7 -#: ../src/Doc/howto/logging.rst:3 +#: howto/logging.rst:3 msgid "Logging HOWTO" msgstr "" # 65b3c45dd137494ca1e0b60718d3c9ce # d0a2d0e9480d4a35aff3eb44698fe1e0 -#: ../src/Doc/howto/logging.rst:5 ../src/Doc/howto/logging-cookbook.rst:7 +#: howto/logging.rst:5 howto/logging-cookbook.rst:7 msgid "Vinay Sajip " msgstr "" # 0b7f9af1ca8843e9b75234d3b30aa959 -#: ../src/Doc/howto/logging.rst:12 +#: howto/logging.rst:12 msgid "Basic Logging Tutorial" msgstr "" # d90d7449c5184f929731f84f6de11a8c -#: ../src/Doc/howto/logging.rst:14 +#: howto/logging.rst:14 msgid "" "Logging is a means of tracking events that happen when some software runs. " "The software's developer adds logging calls to their code to indicate that " @@ -3620,12 +3623,12 @@ msgid "" msgstr "" # ec25d27883004e0ab8f4f702de97a67d -#: ../src/Doc/howto/logging.rst:23 +#: howto/logging.rst:23 msgid "When to use logging" msgstr "" # 7295593185584a3e94b198069fe3c0ad -#: ../src/Doc/howto/logging.rst:25 +#: howto/logging.rst:25 msgid "" "Logging provides a set of convenience functions for simple logging usage. " "These are :func:`debug`, :func:`info`, :func:`warning`, :func:`error` and :" @@ -3634,85 +3637,85 @@ msgid "" msgstr "" # 329f086d2fbf4654b1804b138c1b7795 -#: ../src/Doc/howto/logging.rst:31 +#: howto/logging.rst:31 msgid "Task you want to perform" msgstr "" # 828741848e7346ba8a9b21c8a4594c0c -#: ../src/Doc/howto/logging.rst:31 +#: howto/logging.rst:31 msgid "The best tool for the task" msgstr "" # 681079f4c80147ffa674884ffd16ea9e -#: ../src/Doc/howto/logging.rst:33 +#: howto/logging.rst:33 msgid "" "Display console output for ordinary usage of a command line script or program" msgstr "" # c51e568135e54cbe84ba9f6fe6420db0 -#: ../src/Doc/howto/logging.rst:33 +#: howto/logging.rst:33 msgid ":func:`print`" msgstr "" # 2111f1f3ccfd4fd18bae421d9f9aab67 -#: ../src/Doc/howto/logging.rst:37 +#: howto/logging.rst:37 msgid "" "Report events that occur during normal operation of a program (e.g. for " "status monitoring or fault investigation)" msgstr "" # 753d3b3814c645bd8379ebd08deaa87d -#: ../src/Doc/howto/logging.rst:37 +#: howto/logging.rst:37 msgid "" ":func:`logging.info` (or :func:`logging.debug` for very detailed output for " "diagnostic purposes)" msgstr "" # 2b06f4b58a8e455d94cdfdb4cc92be5c -#: ../src/Doc/howto/logging.rst:42 +#: howto/logging.rst:42 msgid "Issue a warning regarding a particular runtime event" msgstr "" # 70df136b6bf747e893d85821ebbddfb6 -#: ../src/Doc/howto/logging.rst:42 +#: howto/logging.rst:42 msgid "" ":func:`warnings.warn` in library code if the issue is avoidable and the " "client application should be modified to eliminate the warning" msgstr "" # 5446c4f930804bb8a4c2b602c43eb120 -#: ../src/Doc/howto/logging.rst:47 +#: howto/logging.rst:47 msgid "" ":func:`logging.warning` if there is nothing the client application can do " "about the situation, but the event should still be noted" msgstr "" # 1f67c85b2bb74bf7ab47f0a5e8569b8e -#: ../src/Doc/howto/logging.rst:52 +#: howto/logging.rst:52 msgid "Report an error regarding a particular runtime event" msgstr "" # cb0b1bb84fe94f84ac6bdff939d322e4 -#: ../src/Doc/howto/logging.rst:52 +#: howto/logging.rst:52 msgid "Raise an exception" msgstr "" # 6960b3b4cd75488c99924ccb262ae6f9 -#: ../src/Doc/howto/logging.rst:55 +#: howto/logging.rst:55 msgid "" "Report suppression of an error without raising an exception (e.g. error " "handler in a long-running server process)" msgstr "" # 36b8d971916a4de08e2f5cff7e88cf2d -#: ../src/Doc/howto/logging.rst:55 +#: howto/logging.rst:55 msgid "" ":func:`logging.error`, :func:`logging.exception` or :func:`logging.critical` " "as appropriate for the specific error and application domain" msgstr "" # 15133143a6cb48f4af0c7ab49b88ddfb -#: ../src/Doc/howto/logging.rst:62 +#: howto/logging.rst:62 msgid "" "The logging functions are named after the level or severity of the events " "they are used to track. The standard levels and their applicability are " @@ -3721,46 +3724,46 @@ msgstr "" # f3c8e2c9cdee4d1bb3f0b16138b5a226 # dd3d23b35360438b92570155d5210b61 -#: ../src/Doc/howto/logging.rst:69 ../src/Doc/howto/logging.rst:794 +#: howto/logging.rst:69 howto/logging.rst:794 msgid "Level" msgstr "" # a6bbc26de8da43c5826878e44528294f -#: ../src/Doc/howto/logging.rst:69 +#: howto/logging.rst:69 msgid "When it's used" msgstr "" # 8ae4dcb4fe2b43708fad71d7bca1343a # 6268a642e9b241f988db1fb0ff24ed97 -#: ../src/Doc/howto/logging.rst:71 ../src/Doc/howto/logging.rst:804 +#: howto/logging.rst:71 howto/logging.rst:804 msgid "``DEBUG``" msgstr "" # 846a7464bd4942a7b48bb9de8a2f3ff6 -#: ../src/Doc/howto/logging.rst:71 +#: howto/logging.rst:71 msgid "" "Detailed information, typically of interest only when diagnosing problems." msgstr "" # a665da04a6854416b5d2767cb2eb0468 # 9beadc188b264b65b9bc85843f5e8770 -#: ../src/Doc/howto/logging.rst:74 ../src/Doc/howto/logging.rst:802 +#: howto/logging.rst:74 howto/logging.rst:802 msgid "``INFO``" msgstr "" # e738e61ffa4246478690d124c09a7eeb -#: ../src/Doc/howto/logging.rst:74 +#: howto/logging.rst:74 msgid "Confirmation that things are working as expected." msgstr "" # c9d7d51ce00d4705964bac5f01e3ca25 # 63a390ce620d4a40a04707824b431428 -#: ../src/Doc/howto/logging.rst:77 ../src/Doc/howto/logging.rst:800 +#: howto/logging.rst:77 howto/logging.rst:800 msgid "``WARNING``" msgstr "" # bb34bcc063cd4c63ab07f916fdedb702 -#: ../src/Doc/howto/logging.rst:77 +#: howto/logging.rst:77 msgid "" "An indication that something unexpected happened, or indicative of some " "problem in the near future (e.g. 'disk space low'). The software is still " @@ -3769,12 +3772,12 @@ msgstr "" # 8d4ef2d1497d4eb5a5781ea52bfa897a # 825ee3b82e454c7584172f05f3e01f04 -#: ../src/Doc/howto/logging.rst:82 ../src/Doc/howto/logging.rst:798 +#: howto/logging.rst:82 howto/logging.rst:798 msgid "``ERROR``" msgstr "" # fb15fb76bd4d4d8e8a531cc754dbb4a5 -#: ../src/Doc/howto/logging.rst:82 +#: howto/logging.rst:82 msgid "" "Due to a more serious problem, the software has not been able to perform " "some function." @@ -3782,19 +3785,19 @@ msgstr "" # 930288483e494a9f9fc69c30e8842795 # 489e9c9dc08b4f37bbde0ad825687f8c -#: ../src/Doc/howto/logging.rst:85 ../src/Doc/howto/logging.rst:796 +#: howto/logging.rst:85 howto/logging.rst:796 msgid "``CRITICAL``" msgstr "" # 4ea27f275fbc4613b0cbc54d3c02373e -#: ../src/Doc/howto/logging.rst:85 +#: howto/logging.rst:85 msgid "" "A serious error, indicating that the program itself may be unable to " "continue running." msgstr "" # 3536e0219683480fa795ac4d51852804 -#: ../src/Doc/howto/logging.rst:89 +#: howto/logging.rst:89 msgid "" "The default level is ``WARNING``, which means that only events of this level " "and above will be tracked, unless the logging package is configured to do " @@ -3802,7 +3805,7 @@ msgid "" msgstr "" # 75dfca248365401b8da1163d115fc97b -#: ../src/Doc/howto/logging.rst:93 +#: howto/logging.rst:93 msgid "" "Events that are tracked can be handled in different ways. The simplest way " "of handling tracked events is to print them to the console. Another common " @@ -3810,22 +3813,22 @@ msgid "" msgstr "" # 1b09a37cec504c9e8af14f6c27046fd4 -#: ../src/Doc/howto/logging.rst:101 +#: howto/logging.rst:101 msgid "A simple example" msgstr "" # d907bcdc8f5140ecb674785e71d5d613 -#: ../src/Doc/howto/logging.rst:103 +#: howto/logging.rst:103 msgid "A very simple example is::" msgstr "" # 8974cebbb9ef41618a43fbff4673264c -#: ../src/Doc/howto/logging.rst:109 +#: howto/logging.rst:109 msgid "If you type these lines into a script and run it, you'll see::" msgstr "" # 2b9ce51dc05e4a23a08e77ec74c416cc -#: ../src/Doc/howto/logging.rst:113 +#: howto/logging.rst:113 msgid "" "printed out on the console. The ``INFO`` message doesn't appear because the " "default level is ``WARNING``. The printed message includes the indication of " @@ -3836,12 +3839,12 @@ msgid "" msgstr "" # 5c606f6ff5a24156b06d302b318c71d8 -#: ../src/Doc/howto/logging.rst:122 +#: howto/logging.rst:122 msgid "Logging to a file" msgstr "" # 1b73497e0f5b4302bf169656e99821eb -#: ../src/Doc/howto/logging.rst:124 +#: howto/logging.rst:124 msgid "" "A very common situation is that of recording logging events in a file, so " "let's look at that next. Be sure to try the following in a newly-started " @@ -3850,14 +3853,14 @@ msgid "" msgstr "" # 9e30a537bcc8491e91083272e5016c07 -#: ../src/Doc/howto/logging.rst:134 +#: howto/logging.rst:134 msgid "" "And now if we open the file and look at what we have, we should find the log " "messages::" msgstr "" # bc10937a53cb4d06915d192c7cc1ac20 -#: ../src/Doc/howto/logging.rst:141 +#: howto/logging.rst:141 msgid "" "This example also shows how you can set the logging level which acts as the " "threshold for tracking. In this case, because we set the threshold to " @@ -3865,20 +3868,20 @@ msgid "" msgstr "" # 03972b897f20416e8af61cab8e1b945c -#: ../src/Doc/howto/logging.rst:145 +#: howto/logging.rst:145 msgid "" "If you want to set the logging level from a command-line option such as::" msgstr "" # 7e0a734744f44166a0bc99eb5de37cf3 -#: ../src/Doc/howto/logging.rst:149 +#: howto/logging.rst:149 msgid "" "and you have the value of the parameter passed for ``--log`` in some " "variable *loglevel*, you can use::" msgstr "" # f21f97965a3046178fb1a2d35ad1d51e -#: ../src/Doc/howto/logging.rst:154 +#: howto/logging.rst:154 msgid "" "to get the value which you'll pass to :func:`basicConfig` via the *level* " "argument. You may want to error check any user input value, perhaps as in " @@ -3886,7 +3889,7 @@ msgid "" msgstr "" # da33353ac2a14d2eb53023ba3bdad78e -#: ../src/Doc/howto/logging.rst:166 +#: howto/logging.rst:166 msgid "" "The call to :func:`basicConfig` should come *before* any calls to :func:" "`debug`, :func:`info` etc. As it's intended as a one-off simple " @@ -3895,7 +3898,7 @@ msgid "" msgstr "" # 25238040105c44e7a58558b863736a9c -#: ../src/Doc/howto/logging.rst:171 +#: howto/logging.rst:171 msgid "" "If you run the above script several times, the messages from successive runs " "are appended to the file *example.log*. If you want each run to start " @@ -3904,31 +3907,31 @@ msgid "" msgstr "" # 236a87897bc4409f966d9fe8569692e1 -#: ../src/Doc/howto/logging.rst:178 +#: howto/logging.rst:178 msgid "" "The output will be the same as before, but the log file is no longer " "appended to, so the messages from earlier runs are lost." msgstr "" # 8f030ab2906c4cd98d23fff0bd997c32 -#: ../src/Doc/howto/logging.rst:183 +#: howto/logging.rst:183 msgid "Logging from multiple modules" msgstr "" # 656e4a7d8dcd47a6a450d926084528e1 -#: ../src/Doc/howto/logging.rst:185 +#: howto/logging.rst:185 msgid "" "If your program consists of multiple modules, here's an example of how you " "could organize logging in it::" msgstr "" # 00cbfee41d64491ba4163525e01c4088 -#: ../src/Doc/howto/logging.rst:209 +#: howto/logging.rst:209 msgid "If you run *myapp.py*, you should see this in *myapp.log*::" msgstr "" # 288706eb43124e1da5328e8271fad100 -#: ../src/Doc/howto/logging.rst:215 +#: howto/logging.rst:215 msgid "" "which is hopefully what you were expecting to see. You can generalize this " "to multiple modules, using the pattern in *mylib.py*. Note that for this " @@ -3940,24 +3943,24 @@ msgid "" msgstr "" # 2aaf29e0126640099f1f0cc3025bf5b5 -#: ../src/Doc/howto/logging.rst:225 +#: howto/logging.rst:225 msgid "Logging variable data" msgstr "" # 96aca89d50d048dbb10751d74763ab3c -#: ../src/Doc/howto/logging.rst:227 +#: howto/logging.rst:227 msgid "" "To log variable data, use a format string for the event description message " "and append the variable data as arguments. For example::" msgstr "" # 4707deac65324e7290606ffc63f0f03c -#: ../src/Doc/howto/logging.rst:233 +#: howto/logging.rst:233 msgid "will display::" msgstr "" # 4bd36860470e4c649b6565a8fb7015f8 -#: ../src/Doc/howto/logging.rst:237 +#: howto/logging.rst:237 msgid "" "As you can see, merging of variable data into the event description message " "uses the old, %-style of string formatting. This is for backwards " @@ -3968,24 +3971,24 @@ msgid "" msgstr "" # 19d878f01793404788e41d271463f9d6 -#: ../src/Doc/howto/logging.rst:246 +#: howto/logging.rst:246 msgid "Changing the format of displayed messages" msgstr "" # 64d09c4ca1e146629016fe66cf7c84b8 -#: ../src/Doc/howto/logging.rst:248 +#: howto/logging.rst:248 msgid "" "To change the format which is used to display messages, you need to specify " "the format you want to use::" msgstr "" # 19722281939544b1bb3f399a1767f58a -#: ../src/Doc/howto/logging.rst:257 +#: howto/logging.rst:257 msgid "which would print::" msgstr "" # a910e22d2f5c4500b87f62643359b222 -#: ../src/Doc/howto/logging.rst:263 +#: howto/logging.rst:263 msgid "" "Notice that the 'root' which appeared in earlier examples has disappeared. " "For a full set of things that can appear in format strings, you can refer to " @@ -3996,24 +3999,24 @@ msgid "" msgstr "" # 92ae82b02a9f4b09b9ca1a842efd6e59 -#: ../src/Doc/howto/logging.rst:272 +#: howto/logging.rst:272 msgid "Displaying the date/time in messages" msgstr "" # 47aedfa597a7434d98cafeef08cc7a59 -#: ../src/Doc/howto/logging.rst:274 +#: howto/logging.rst:274 msgid "" "To display the date and time of an event, you would place '%(asctime)s' in " "your format string::" msgstr "" # b1785110acd04394aaab3a9d3958f2ae -#: ../src/Doc/howto/logging.rst:281 +#: howto/logging.rst:281 msgid "which should print something like this::" msgstr "" # 203d1c0dd3b54db8b32a7cf07bb68411 -#: ../src/Doc/howto/logging.rst:285 +#: howto/logging.rst:285 msgid "" "The default format for date/time display (shown above) is ISO8601. If you " "need more control over the formatting of the date/time, provide a *datefmt* " @@ -4021,24 +4024,24 @@ msgid "" msgstr "" # c057f2e907a640b0b2e68d9737ac1351 -#: ../src/Doc/howto/logging.rst:293 +#: howto/logging.rst:293 msgid "which would display something like this::" msgstr "" # bd1e3da11d684da6a74add8d295545ec -#: ../src/Doc/howto/logging.rst:297 +#: howto/logging.rst:297 msgid "" "The format of the *datefmt* argument is the same as supported by :func:`time." "strftime`." msgstr "" # 7d33d1c0f6eb4d9588d21c03b8792ec6 -#: ../src/Doc/howto/logging.rst:302 +#: howto/logging.rst:302 msgid "Next Steps" msgstr "" # f2a0ba57517e4648a1b06c1f281af298 -#: ../src/Doc/howto/logging.rst:304 +#: howto/logging.rst:304 msgid "" "That concludes the basic tutorial. It should be enough to get you up and " "running with logging. There's a lot more that the logging package offers, " @@ -4048,7 +4051,7 @@ msgid "" msgstr "" # b24fa96d7f364877bdc04650b55ba2b3 -#: ../src/Doc/howto/logging.rst:310 +#: howto/logging.rst:310 msgid "" "If your logging needs are simple, then use the above examples to incorporate " "logging into your own scripts, and if you run into problems or don't " @@ -4058,7 +4061,7 @@ msgid "" msgstr "" # fc47ef89d4fb415aa6d898db658b282f -#: ../src/Doc/howto/logging.rst:316 +#: howto/logging.rst:316 msgid "" "Still here? You can carry on reading the next few sections, which provide a " "slightly more advanced/in-depth tutorial than the basic one above. After " @@ -4066,50 +4069,50 @@ msgid "" msgstr "" # e2a5881504de4c2b83a9a08843ae993c -#: ../src/Doc/howto/logging.rst:324 +#: howto/logging.rst:324 msgid "Advanced Logging Tutorial" msgstr "" # 2b0fceccdc6b4cc6bb8bbf047c017eca -#: ../src/Doc/howto/logging.rst:326 +#: howto/logging.rst:326 msgid "" "The logging library takes a modular approach and offers several categories " "of components: loggers, handlers, filters, and formatters." msgstr "" # dd2717f66d2247fabd7d3303a522da40 -#: ../src/Doc/howto/logging.rst:329 +#: howto/logging.rst:329 msgid "Loggers expose the interface that application code directly uses." msgstr "" # 5e50eb77d0d54c38a57cc30f9df00069 -#: ../src/Doc/howto/logging.rst:330 +#: howto/logging.rst:330 msgid "" "Handlers send the log records (created by loggers) to the appropriate " "destination." msgstr "" # 95436fe2027345d7be08b4595424332b -#: ../src/Doc/howto/logging.rst:332 +#: howto/logging.rst:332 msgid "" "Filters provide a finer grained facility for determining which log records " "to output." msgstr "" # 8e34945dc8284df5939af78a70d528af -#: ../src/Doc/howto/logging.rst:334 +#: howto/logging.rst:334 msgid "Formatters specify the layout of log records in the final output." msgstr "" # cb7b9eadf4ab4a6187eb8b210ea79d23 -#: ../src/Doc/howto/logging.rst:336 +#: howto/logging.rst:336 msgid "" "Log event information is passed between loggers, handlers, filters and " "formatters in a :class:`LogRecord` instance." msgstr "" # 23fbe588545248dd990be5a45d3af9bf -#: ../src/Doc/howto/logging.rst:339 +#: howto/logging.rst:339 msgid "" "Logging is performed by calling methods on instances of the :class:`Logger` " "class (hereafter called :dfn:`loggers`). Each instance has a name, and they " @@ -4121,21 +4124,21 @@ msgid "" msgstr "" # 7c87284caf9a432eb73d93f79afbc2fe -#: ../src/Doc/howto/logging.rst:346 +#: howto/logging.rst:346 msgid "" "A good convention to use when naming loggers is to use a module-level " "logger, in each module which uses logging, named as follows::" msgstr "" # 72ae200ea40d4cc4b06b1afa4c40792b -#: ../src/Doc/howto/logging.rst:351 +#: howto/logging.rst:351 msgid "" "This means that logger names track the package/module hierarchy, and it's " "intuitively obvious where events are logged just from the logger name." msgstr "" # a8f867cfdf00463892a9aba951039162 -#: ../src/Doc/howto/logging.rst:354 +#: howto/logging.rst:354 msgid "" "The root of the hierarchy of loggers is called the root logger. That's the " "logger used by the functions :func:`debug`, :func:`info`, :func:`warning`, :" @@ -4145,7 +4148,7 @@ msgid "" msgstr "" # a3746460e5a24eaab8c6c9e8bd50f2fb -#: ../src/Doc/howto/logging.rst:360 +#: howto/logging.rst:360 msgid "" "It is, of course, possible to log messages to different destinations. " "Support is included in the package for writing log messages to files, HTTP " @@ -4157,7 +4160,7 @@ msgid "" msgstr "" # 54a9491bcc94436c8c06baf8fe4ba935 -#: ../src/Doc/howto/logging.rst:367 +#: howto/logging.rst:367 msgid "" "By default, no destination is set for any logging messages. You can specify " "a destination (such as console or file) by using :func:`basicConfig` as in " @@ -4170,12 +4173,12 @@ msgid "" msgstr "" # 2008620fdbac44f993c22668c28c545c -#: ../src/Doc/howto/logging.rst:375 +#: howto/logging.rst:375 msgid "The default format set by :func:`basicConfig` for messages is::" msgstr "" # 47b9dd70ec994284ba0c868e0b2ef7aa -#: ../src/Doc/howto/logging.rst:379 +#: howto/logging.rst:379 msgid "" "You can change this by passing a format string to :func:`basicConfig` with " "the *format* keyword argument. For all options regarding how a format string " @@ -4183,24 +4186,24 @@ msgid "" msgstr "" # b8adf0835beb484aba0b9c2da2a82f2e -#: ../src/Doc/howto/logging.rst:384 +#: howto/logging.rst:384 msgid "Logging Flow" msgstr "" # 14b2ed380bd24a2d8f2dd53a48686618 -#: ../src/Doc/howto/logging.rst:386 +#: howto/logging.rst:386 msgid "" "The flow of log event information in loggers and handlers is illustrated in " "the following diagram." msgstr "" # b353f5a682a24c9292719fe3eabb0c31 -#: ../src/Doc/howto/logging.rst:392 +#: howto/logging.rst:392 msgid "Loggers" msgstr "" # 6339e3b5d4c847c3b837df492421c640 -#: ../src/Doc/howto/logging.rst:394 +#: howto/logging.rst:394 msgid "" ":class:`Logger` objects have a threefold job. First, they expose several " "methods to application code so that applications can log messages at " @@ -4211,19 +4214,19 @@ msgid "" msgstr "" # 7c6d8e2a5a224de0a86da47dab617825 -#: ../src/Doc/howto/logging.rst:400 +#: howto/logging.rst:400 msgid "" "The most widely used methods on logger objects fall into two categories: " "configuration and message sending." msgstr "" # 4984d6d837a64642a1a6c8074e7b3038 -#: ../src/Doc/howto/logging.rst:403 +#: howto/logging.rst:403 msgid "These are the most common configuration methods:" msgstr "" # b97521a6662f462db0ad913ed4f297db -#: ../src/Doc/howto/logging.rst:405 +#: howto/logging.rst:405 msgid "" ":meth:`Logger.setLevel` specifies the lowest-severity log message a logger " "will handle, where debug is the lowest built-in severity level and critical " @@ -4233,7 +4236,7 @@ msgid "" msgstr "" # 9442f93a860f4d428999121a34d0be17 -#: ../src/Doc/howto/logging.rst:411 +#: howto/logging.rst:411 msgid "" ":meth:`Logger.addHandler` and :meth:`Logger.removeHandler` add and remove " "handler objects from the logger object. Handlers are covered in more detail " @@ -4241,7 +4244,7 @@ msgid "" msgstr "" # bda414615c4d40c28d89e720e95b0b1a -#: ../src/Doc/howto/logging.rst:415 +#: howto/logging.rst:415 msgid "" ":meth:`Logger.addFilter` and :meth:`Logger.removeFilter` add and remove " "filter objects from the logger object. Filters are covered in more detail " @@ -4249,20 +4252,20 @@ msgid "" msgstr "" # 9a32209a8c4941f6a955de2f83ef4012 -#: ../src/Doc/howto/logging.rst:419 +#: howto/logging.rst:419 msgid "" "You don't need to always call these methods on every logger you create. See " "the last two paragraphs in this section." msgstr "" # 138f5e30b0bb4506aa2e5cc5316be2cd -#: ../src/Doc/howto/logging.rst:422 +#: howto/logging.rst:422 msgid "" "With the logger object configured, the following methods create log messages:" msgstr "" # a0e77824a45e45a5be737a71ae52d4dc -#: ../src/Doc/howto/logging.rst:424 +#: howto/logging.rst:424 msgid "" ":meth:`Logger.debug`, :meth:`Logger.info`, :meth:`Logger.warning`, :meth:" "`Logger.error`, and :meth:`Logger.critical` all create log records with a " @@ -4276,7 +4279,7 @@ msgid "" msgstr "" # bed88bfc13d9481bb98f3b4d5be605c0 -#: ../src/Doc/howto/logging.rst:434 +#: howto/logging.rst:434 msgid "" ":meth:`Logger.exception` creates a log message similar to :meth:`Logger." "error`. The difference is that :meth:`Logger.exception` dumps a stack trace " @@ -4284,7 +4287,7 @@ msgid "" msgstr "" # 632d699272834fe6a73732ecf128761e -#: ../src/Doc/howto/logging.rst:438 +#: howto/logging.rst:438 msgid "" ":meth:`Logger.log` takes a log level as an explicit argument. This is a " "little more verbose for logging messages than using the log level " @@ -4293,7 +4296,7 @@ msgid "" msgstr "" # 7c1227c2d53a4fe6997cc6e9ddb3a47a -#: ../src/Doc/howto/logging.rst:442 +#: howto/logging.rst:442 msgid "" ":func:`getLogger` returns a reference to a logger instance with the " "specified name if it is provided, or ``root`` if not. The names are period-" @@ -4306,7 +4309,7 @@ msgid "" msgstr "" # 96215912457545fd9c35320f4417cc26 -#: ../src/Doc/howto/logging.rst:450 +#: howto/logging.rst:450 msgid "" "Loggers have a concept of *effective level*. If a level is not explicitly " "set on a logger, the level of its parent is used instead as its effective " @@ -4319,7 +4322,7 @@ msgid "" msgstr "" # 71f38ce9036d4a4e9da7c8fb61e90d35 -#: ../src/Doc/howto/logging.rst:458 +#: howto/logging.rst:458 msgid "" "Child loggers propagate messages up to the handlers associated with their " "ancestor loggers. Because of this, it is unnecessary to define and configure " @@ -4330,12 +4333,12 @@ msgid "" msgstr "" # 04d1211bca61498c897f614f63f53735 -#: ../src/Doc/howto/logging.rst:469 +#: howto/logging.rst:469 msgid "Handlers" msgstr "" # 6f681a4e98654c32a888ad51258e64d0 -#: ../src/Doc/howto/logging.rst:471 +#: howto/logging.rst:471 msgid "" ":class:`~logging.Handler` objects are responsible for dispatching the " "appropriate log messages (based on the log messages' severity) to the " @@ -4349,7 +4352,7 @@ msgid "" msgstr "" # beadeeb8c003417bbd66fa66c7d7cf47 -#: ../src/Doc/howto/logging.rst:481 +#: howto/logging.rst:481 msgid "" "The standard library includes quite a few handler types (see :ref:`useful-" "handlers`); the tutorials use mainly :class:`StreamHandler` and :class:" @@ -4357,7 +4360,7 @@ msgid "" msgstr "" # 417032447e714133ab5d15bd8bc01139 -#: ../src/Doc/howto/logging.rst:485 +#: howto/logging.rst:485 msgid "" "There are very few methods in a handler for application developers to " "concern themselves with. The only handler methods that seem relevant for " @@ -4366,7 +4369,7 @@ msgid "" msgstr "" # a4cc7add80f747cbb0b328faeb6a2faa -#: ../src/Doc/howto/logging.rst:490 +#: howto/logging.rst:490 msgid "" "The :meth:`~Handler.setLevel` method, just as in logger objects, specifies " "the lowest severity that will be dispatched to the appropriate destination. " @@ -4377,21 +4380,21 @@ msgid "" msgstr "" # f1a5188ca6b0405ba011f57b33e0da3b -#: ../src/Doc/howto/logging.rst:496 +#: howto/logging.rst:496 msgid "" ":meth:`~Handler.setFormatter` selects a Formatter object for this handler to " "use." msgstr "" # f5812dbd070540fb82efcbaf7c988ccd -#: ../src/Doc/howto/logging.rst:499 +#: howto/logging.rst:499 msgid "" ":meth:`~Handler.addFilter` and :meth:`~Handler.removeFilter` respectively " "configure and deconfigure filter objects on handlers." msgstr "" # d7ebe8f4cc534e77878aaa467a54c0f7 -#: ../src/Doc/howto/logging.rst:502 +#: howto/logging.rst:502 msgid "" "Application code should not directly instantiate and use instances of :class:" "`Handler`. Instead, the :class:`Handler` class is a base class that defines " @@ -4400,12 +4403,12 @@ msgid "" msgstr "" # 68e5e8f13d2546a6839d11180a915044 -#: ../src/Doc/howto/logging.rst:509 +#: howto/logging.rst:509 msgid "Formatters" msgstr "" # ca68e914ef9a4e8e9af968d993e6f8ea -#: ../src/Doc/howto/logging.rst:511 +#: howto/logging.rst:511 msgid "" "Formatter objects configure the final order, structure, and contents of the " "log message. Unlike the base :class:`logging.Handler` class, application " @@ -4416,19 +4419,19 @@ msgid "" msgstr "" # e22b9dbedd574d4d9fc2d18591b5b1d2 -#: ../src/Doc/howto/logging.rst:519 +#: howto/logging.rst:519 msgid "" "If there is no message format string, the default is to use the raw " "message. If there is no date format string, the default date format is::" msgstr "" # 05ba9e4f4d684ac6a432500b44a42a2a -#: ../src/Doc/howto/logging.rst:524 +#: howto/logging.rst:524 msgid "with the milliseconds tacked on at the end." msgstr "" # 595451cc7a32465b8036658f16569914 -#: ../src/Doc/howto/logging.rst:526 +#: howto/logging.rst:526 msgid "" "The message format string uses ``%()s`` styled string " "substitution; the possible keys are documented in :ref:`logrecord-" @@ -4436,7 +4439,7 @@ msgid "" msgstr "" # fcfa086632304d85b9fda552b79e19c9 -#: ../src/Doc/howto/logging.rst:529 +#: howto/logging.rst:529 msgid "" "The following message format string will log the time in a human-readable " "format, the severity of the message, and the contents of the message, in " @@ -4444,7 +4447,7 @@ msgid "" msgstr "" # f801d948dc5f4239855788479d748a5d -#: ../src/Doc/howto/logging.rst:535 +#: howto/logging.rst:535 msgid "" "Formatters use a user-configurable function to convert the creation time of " "a record to a tuple. By default, :func:`time.localtime` is used; to change " @@ -4456,38 +4459,38 @@ msgid "" msgstr "" # 01bb0a8c8d274e569ece1f7110ccd1dc -#: ../src/Doc/howto/logging.rst:545 +#: howto/logging.rst:545 msgid "Configuring Logging" msgstr "" # d17331fddb69471b9ed96e15ee5e9a32 -#: ../src/Doc/howto/logging.rst:549 +#: howto/logging.rst:549 msgid "Programmers can configure logging in three ways:" msgstr "" # 65a9a34640ee4290a9ba79d48d8d4481 -#: ../src/Doc/howto/logging.rst:551 +#: howto/logging.rst:551 msgid "" "Creating loggers, handlers, and formatters explicitly using Python code that " "calls the configuration methods listed above." msgstr "" # d4d780f19ea14d1b9a34a2cb071163be -#: ../src/Doc/howto/logging.rst:553 +#: howto/logging.rst:553 msgid "" "Creating a logging config file and reading it using the :func:`fileConfig` " "function." msgstr "" # ebcd354b464d40d784cbcdadef28df6c -#: ../src/Doc/howto/logging.rst:555 +#: howto/logging.rst:555 msgid "" "Creating a dictionary of configuration information and passing it to the :" "func:`dictConfig` function." msgstr "" # 3d203274869b4bfb868209681006940f -#: ../src/Doc/howto/logging.rst:558 +#: howto/logging.rst:558 msgid "" "For the reference documentation on the last two options, see :ref:`logging-" "config-api`. The following example configures a very simple logger, a " @@ -4495,13 +4498,13 @@ msgid "" msgstr "" # aa7aa865612d4d99bd3e53629c42b300 -#: ../src/Doc/howto/logging.rst:588 +#: howto/logging.rst:588 msgid "" "Running this module from the command line produces the following output::" msgstr "" # 1ad0db31d640485a9eb16f5a4c66926b -#: ../src/Doc/howto/logging.rst:597 +#: howto/logging.rst:597 msgid "" "The following Python module creates a logger, handler, and formatter nearly " "identical to those in the example listed above, with the only difference " @@ -4509,18 +4512,18 @@ msgid "" msgstr "" # 5a25cd5854a64a7d94f8fe1f2b29a936 -#: ../src/Doc/howto/logging.rst:616 +#: howto/logging.rst:616 msgid "Here is the logging.conf file::" msgstr "" # 8c60a062160d45109bfef70ffeb7ef87 -#: ../src/Doc/howto/logging.rst:647 +#: howto/logging.rst:647 msgid "" "The output is nearly identical to that of the non-config-file-based example::" msgstr "" # da2ed4ced3784612a7715d90da7f69c6 -#: ../src/Doc/howto/logging.rst:656 +#: howto/logging.rst:656 msgid "" "You can see that the config file approach has a few advantages over the " "Python code approach, mainly separation of configuration and code and the " @@ -4528,7 +4531,7 @@ msgid "" msgstr "" # 2a5947a51ff5489ab33a5f5d4ab85e55 -#: ../src/Doc/howto/logging.rst:660 +#: howto/logging.rst:660 msgid "" "The :func:`fileConfig` function takes a default parameter, " "``disable_existing_loggers``, which defaults to ``True`` for reasons of " @@ -4540,7 +4543,7 @@ msgid "" msgstr "" # 632f34cf6eb64963bc5193711482c45a -#: ../src/Doc/howto/logging.rst:668 +#: howto/logging.rst:668 msgid "" "The dictionary passed to :func:`dictConfig` can also specify a Boolean value " "with key ``disable_existing_loggers``, which if not specified explicitly in " @@ -4550,7 +4553,7 @@ msgid "" msgstr "" # d231c449986242808916b5b0bfc2706e -#: ../src/Doc/howto/logging.rst:677 +#: howto/logging.rst:677 msgid "" "Note that the class names referenced in config files need to be either " "relative to the logging module, or absolute values which can be resolved " @@ -4562,7 +4565,7 @@ msgid "" msgstr "" # 0de18de43e6c4292a5e0e75971f202cc -#: ../src/Doc/howto/logging.rst:685 +#: howto/logging.rst:685 msgid "" "In Python 2.7, a new means of configuring logging has been introduced, using " "dictionaries to hold configuration information. This provides a superset of " @@ -4578,26 +4581,26 @@ msgid "" msgstr "" # 611a1fc047d84d41a9eba48f0692337b -#: ../src/Doc/howto/logging.rst:697 +#: howto/logging.rst:697 msgid "" "Here's an example of the same configuration as above, in YAML format for the " "new dictionary-based approach::" msgstr "" # f80e52a5059f4c1cb300cc0455ce3a8d -#: ../src/Doc/howto/logging.rst:719 +#: howto/logging.rst:719 msgid "" "For more information about logging using a dictionary, see :ref:`logging-" "config-api`." msgstr "" # 0b65c9e4dd744699968a09936f52dd8f -#: ../src/Doc/howto/logging.rst:723 +#: howto/logging.rst:723 msgid "What happens if no configuration is provided" msgstr "" # ef691d17244549bbb7faa4e116bb044a -#: ../src/Doc/howto/logging.rst:725 +#: howto/logging.rst:725 msgid "" "If no logging configuration is provided, it is possible to have a situation " "where a logging event needs to be output, but no handlers can be found to " @@ -4606,31 +4609,31 @@ msgid "" msgstr "" # 90643e9147bd40749feae5415b38691b -#: ../src/Doc/howto/logging.rst:730 +#: howto/logging.rst:730 msgid "For Python 2.x, the behaviour is as follows:" msgstr "" # d478b740cadd45e98bea736455936be1 -#: ../src/Doc/howto/logging.rst:732 +#: howto/logging.rst:732 msgid "" "If *logging.raiseExceptions* is *False* (production mode), the event is " "silently dropped." msgstr "" # 6447007e63ee4bff9b70357ce2092fa9 -#: ../src/Doc/howto/logging.rst:735 +#: howto/logging.rst:735 msgid "" "If *logging.raiseExceptions* is *True* (development mode), a message 'No " "handlers could be found for logger X.Y.Z' is printed once." msgstr "" # 276825f5926a40e2959cb6eabaf974cd -#: ../src/Doc/howto/logging.rst:741 +#: howto/logging.rst:741 msgid "Configuring Logging for a Library" msgstr "" # d9986a2b242b491ba1827a8858da67b6 -#: ../src/Doc/howto/logging.rst:743 +#: howto/logging.rst:743 msgid "" "When developing a library which uses logging, you should take care to " "document how the library uses logging - for example, the names of loggers " @@ -4641,7 +4644,7 @@ msgid "" msgstr "" # e476d82bbafe488a9ebbd197f95cdb5f -#: ../src/Doc/howto/logging.rst:750 +#: howto/logging.rst:750 msgid "" "If for some reason you *don't* want this message printed in the absence of " "any logging configuration, you can attach a do-nothing handler to the top-" @@ -4654,7 +4657,7 @@ msgid "" msgstr "" # c0ab6555c911477798674b1c6f6155f4 -#: ../src/Doc/howto/logging.rst:759 +#: howto/logging.rst:759 msgid "" "A do-nothing handler is included in the logging package: :class:`~logging." "NullHandler` (since Python 2.7). An instance of this handler could be added " @@ -4665,7 +4668,7 @@ msgid "" msgstr "" # b61833135b6b45548f10d8d75ea61796 -#: ../src/Doc/howto/logging.rst:770 +#: howto/logging.rst:770 msgid "" "should have the desired effect. If an organisation produces a number of " "libraries, then the logger name specified can be 'orgname.foo' rather than " @@ -4673,7 +4676,7 @@ msgid "" msgstr "" # b529d53e602645c48908513a4f81acbe -#: ../src/Doc/howto/logging.rst:774 +#: howto/logging.rst:774 msgid "" "It is strongly advised that you *do not add any handlers other than* :class:" "`~logging.NullHandler` *to your library's loggers*. This is because the " @@ -4685,12 +4688,12 @@ msgid "" msgstr "" # b8adf0835beb484aba0b9c2da2a82f2e -#: ../src/Doc/howto/logging.rst:785 +#: howto/logging.rst:785 msgid "Logging Levels" msgstr "" # 5eb39eb60e0243469f227c6ec95f87f7 -#: ../src/Doc/howto/logging.rst:787 +#: howto/logging.rst:787 msgid "" "The numeric values of logging levels are given in the following table. These " "are primarily of interest if you want to define your own levels, and need " @@ -4700,47 +4703,47 @@ msgid "" msgstr "" # 834fbc8785c5464c838fd17ed4d0b81a -#: ../src/Doc/howto/logging.rst:794 +#: howto/logging.rst:794 msgid "Numeric value" msgstr "" # dcb6b28fe8d94c1dab83c0edbd5499be -#: ../src/Doc/howto/logging.rst:796 +#: howto/logging.rst:796 msgid "50" msgstr "" # 0f41caccf66145658c1de947166b75fc -#: ../src/Doc/howto/logging.rst:798 +#: howto/logging.rst:798 msgid "40" msgstr "" # c6cd1e2b60ff454b99bef1482ce9e795 -#: ../src/Doc/howto/logging.rst:800 +#: howto/logging.rst:800 msgid "30" msgstr "" # 9917c837650f4f4e916edf762c564cfd -#: ../src/Doc/howto/logging.rst:802 +#: howto/logging.rst:802 msgid "20" msgstr "" # c84fff79e6d04a518bc33786fefec845 -#: ../src/Doc/howto/logging.rst:804 +#: howto/logging.rst:804 msgid "10" msgstr "" # 0b2fa9c4feb74c92a2deee5583527d15 -#: ../src/Doc/howto/logging.rst:806 +#: howto/logging.rst:806 msgid "``NOTSET``" msgstr "" # eeb56da8d74c422582ee50f90cb9d538 -#: ../src/Doc/howto/logging.rst:806 +#: howto/logging.rst:806 msgid "0" msgstr "" # 964423eac13943698a2bf905d02fe654 -#: ../src/Doc/howto/logging.rst:809 +#: howto/logging.rst:809 msgid "" "Levels can also be associated with loggers, being set either by the " "developer or through loading a saved logging configuration. When a logging " @@ -4751,7 +4754,7 @@ msgid "" msgstr "" # 0cbc321734bb43808c50e72407bfb0ea -#: ../src/Doc/howto/logging.rst:816 +#: howto/logging.rst:816 msgid "" "Logging messages are encoded as instances of the :class:`~logging.LogRecord` " "class. When a logger decides to actually log an event, a :class:`~logging." @@ -4759,7 +4762,7 @@ msgid "" msgstr "" # 2d2e60bc2e07463cb2cb3e89f4ac106b -#: ../src/Doc/howto/logging.rst:820 +#: howto/logging.rst:820 msgid "" "Logging messages are subjected to a dispatch mechanism through the use of :" "dfn:`handlers`, which are instances of subclasses of the :class:`Handler` " @@ -4777,7 +4780,7 @@ msgid "" msgstr "" # af9b56f127a14d5492a0fdb672725c60 -#: ../src/Doc/howto/logging.rst:834 +#: howto/logging.rst:834 msgid "" "Just as for loggers, handlers can have levels associated with them. A " "handler's level acts as a filter in the same way as a logger's level does. " @@ -4788,12 +4791,12 @@ msgid "" msgstr "" # f723492ad04941f2a6f069afd02c32ca -#: ../src/Doc/howto/logging.rst:843 +#: howto/logging.rst:843 msgid "Custom Levels" msgstr "" # b7cd42e472df4fb892fedfa9a2a83ae5 -#: ../src/Doc/howto/logging.rst:845 +#: howto/logging.rst:845 msgid "" "Defining your own levels is possible, but should not be necessary, as the " "existing levels have been chosen on the basis of practical experience. " @@ -4807,31 +4810,31 @@ msgid "" msgstr "" # 69d69c10ec4e445baf2aea6bc503fc7e -#: ../src/Doc/howto/logging.rst:858 +#: howto/logging.rst:858 msgid "Useful Handlers" msgstr "" # 2fd00f12710b466e81af49cbc9c4515d -#: ../src/Doc/howto/logging.rst:860 +#: howto/logging.rst:860 msgid "" "In addition to the base :class:`Handler` class, many useful subclasses are " "provided:" msgstr "" # a228b422f5154a1499398d1896f80198 -#: ../src/Doc/howto/logging.rst:863 +#: howto/logging.rst:863 msgid "" ":class:`StreamHandler` instances send messages to streams (file-like " "objects)." msgstr "" # 532f9dd537654e2f9c4f657a71953787 -#: ../src/Doc/howto/logging.rst:866 +#: howto/logging.rst:866 msgid ":class:`FileHandler` instances send messages to disk files." msgstr "" # 8d728fda551849c3b406669e42f3b9af -#: ../src/Doc/howto/logging.rst:868 +#: howto/logging.rst:868 msgid "" ":class:`~handlers.BaseRotatingHandler` is the base class for handlers that " "rotate log files at a certain point. It is not meant to be instantiated " @@ -4840,68 +4843,68 @@ msgid "" msgstr "" # 938eeba90f504caba5d5cfeb23069370 -#: ../src/Doc/howto/logging.rst:873 +#: howto/logging.rst:873 msgid "" ":class:`~handlers.RotatingFileHandler` instances send messages to disk " "files, with support for maximum log file sizes and log file rotation." msgstr "" # 94d03d7628d3450f965bd18b20bee489 -#: ../src/Doc/howto/logging.rst:876 +#: howto/logging.rst:876 msgid "" ":class:`~handlers.TimedRotatingFileHandler` instances send messages to disk " "files, rotating the log file at certain timed intervals." msgstr "" # 06aff85bf6b446d78fcfff67d28ab84b -#: ../src/Doc/howto/logging.rst:879 +#: howto/logging.rst:879 msgid "" ":class:`~handlers.SocketHandler` instances send messages to TCP/IP sockets." msgstr "" # b9c789d471764eee9c9d388a188d1795 -#: ../src/Doc/howto/logging.rst:882 +#: howto/logging.rst:882 msgid "" ":class:`~handlers.DatagramHandler` instances send messages to UDP sockets." msgstr "" # 1d02f34b43ff43eeaea86bf5eff2456b -#: ../src/Doc/howto/logging.rst:885 +#: howto/logging.rst:885 msgid "" ":class:`~handlers.SMTPHandler` instances send messages to a designated email " "address." msgstr "" # 19b0df4142434452819618b44832cf47 -#: ../src/Doc/howto/logging.rst:888 +#: howto/logging.rst:888 msgid "" ":class:`~handlers.SysLogHandler` instances send messages to a Unix syslog " "daemon, possibly on a remote machine." msgstr "" # f6b69717f7d14ebc815bcb96def03cf6 -#: ../src/Doc/howto/logging.rst:891 +#: howto/logging.rst:891 msgid "" ":class:`~handlers.NTEventLogHandler` instances send messages to a Windows " "NT/2000/XP event log." msgstr "" # 7b86de6284574674b0d14bb239988582 -#: ../src/Doc/howto/logging.rst:894 +#: howto/logging.rst:894 msgid "" ":class:`~handlers.MemoryHandler` instances send messages to a buffer in " "memory, which is flushed whenever specific criteria are met." msgstr "" # 404e0b6b8c95495d8909f2eecfc13f84 -#: ../src/Doc/howto/logging.rst:897 +#: howto/logging.rst:897 msgid "" ":class:`~handlers.HTTPHandler` instances send messages to an HTTP server " "using either ``GET`` or ``POST`` semantics." msgstr "" # 488be080510b4761a23e0460199a794a -#: ../src/Doc/howto/logging.rst:900 +#: howto/logging.rst:900 msgid "" ":class:`~handlers.WatchedFileHandler` instances watch the file they are " "logging to. If the file changes, it is closed and reopened using the file " @@ -4910,7 +4913,7 @@ msgid "" msgstr "" # 698dbe7569db49dab44898fd3c0a001c -#: ../src/Doc/howto/logging.rst:905 +#: howto/logging.rst:905 msgid "" ":class:`NullHandler` instances do nothing with error messages. They are used " "by library developers who want to use logging, but want to avoid the 'No " @@ -4919,8 +4922,12 @@ msgid "" "more information." msgstr "" +#: howto/logging.rst:911 +msgid "The :class:`NullHandler` class." +msgstr "" + # 31223c19657c48c6aa032b232e0e4e12 -#: ../src/Doc/howto/logging.rst:914 +#: howto/logging.rst:914 msgid "" "The :class:`NullHandler`, :class:`StreamHandler` and :class:`FileHandler` " "classes are defined in the core logging package. The other handlers are " @@ -4929,7 +4936,7 @@ msgid "" msgstr "" # 0dc46f8f9e8341de8dd0718d1c86c6a2 -#: ../src/Doc/howto/logging.rst:919 +#: howto/logging.rst:919 msgid "" "Logged messages are formatted for presentation through instances of the :" "class:`Formatter` class. They are initialized with a format string suitable " @@ -4937,7 +4944,7 @@ msgid "" msgstr "" # bfa11ebc83904d19ac649f128391f80a -#: ../src/Doc/howto/logging.rst:923 +#: howto/logging.rst:923 msgid "" "For formatting multiple messages in a batch, instances of :class:`~handlers." "BufferingFormatter` can be used. In addition to the format string (which is " @@ -4946,7 +4953,7 @@ msgid "" msgstr "" # 1bdebeebd5384715847dcc87e40b06b3 -#: ../src/Doc/howto/logging.rst:928 +#: howto/logging.rst:928 msgid "" "When filtering based on logger level and/or handler level is not enough, " "instances of :class:`Filter` can be added to both :class:`Logger` and :class:" @@ -4957,7 +4964,7 @@ msgid "" msgstr "" # b0ec99179aad43e79f5aa34fa7a978d3 -#: ../src/Doc/howto/logging.rst:935 +#: howto/logging.rst:935 msgid "" "The basic :class:`Filter` functionality allows filtering by specific logger " "name. If this feature is used, messages sent to the named logger and its " @@ -4965,12 +4972,12 @@ msgid "" msgstr "" # 2a2d09c53a134db8af4f6d72ee8d28b7 -#: ../src/Doc/howto/logging.rst:943 +#: howto/logging.rst:943 msgid "Exceptions raised during logging" msgstr "" # a35b95c61d7143b6bdbd578259deb261 -#: ../src/Doc/howto/logging.rst:945 +#: howto/logging.rst:945 msgid "" "The logging package is designed to swallow exceptions which occur while " "logging in production. This is so that errors which occur while handling " @@ -4979,7 +4986,7 @@ msgid "" msgstr "" # 0ca364320d534ad88313b9c198ce71b0 -#: ../src/Doc/howto/logging.rst:950 +#: howto/logging.rst:950 msgid "" ":class:`SystemExit` and :class:`KeyboardInterrupt` exceptions are never " "swallowed. Other exceptions which occur during the :meth:`~Handler.emit` " @@ -4988,7 +4995,7 @@ msgid "" msgstr "" # b680fbe9a6b54b2e88886debc97638af -#: ../src/Doc/howto/logging.rst:955 +#: howto/logging.rst:955 msgid "" "The default implementation of :meth:`~Handler.handleError` in :class:" "`Handler` checks to see if a module-level variable, :data:`raiseExceptions`, " @@ -4997,7 +5004,7 @@ msgid "" msgstr "" # 82fb811028564341ac673e0ee9cbb55c -#: ../src/Doc/howto/logging.rst:960 +#: howto/logging.rst:960 msgid "" "The default value of :data:`raiseExceptions` is ``True``. This is because " "during development, you typically want to be notified of any exceptions that " @@ -5006,12 +5013,12 @@ msgid "" msgstr "" # 6224921983d34cf6b85470aa38d9e650 -#: ../src/Doc/howto/logging.rst:969 +#: howto/logging.rst:969 msgid "Using arbitrary objects as messages" msgstr "" # 0b6faff4c6524c19a9b2684e088d8396 -#: ../src/Doc/howto/logging.rst:971 +#: howto/logging.rst:971 msgid "" "In the preceding sections and examples, it has been assumed that the message " "passed when logging the event is a string. However, this is not the only " @@ -5024,12 +5031,12 @@ msgid "" msgstr "" # d0a7780ff5e449d5a2800545b0f26245 -#: ../src/Doc/howto/logging.rst:982 +#: howto/logging.rst:982 msgid "Optimization" msgstr "" # de53b3d3c3944ed0b75fda9a512ae253 -#: ../src/Doc/howto/logging.rst:984 +#: howto/logging.rst:984 msgid "" "Formatting of message arguments is deferred until it cannot be avoided. " "However, computing the arguments passed to the logging method can also be " @@ -5041,14 +5048,14 @@ msgid "" msgstr "" # a1b9f95340994142b159d89a7cab4161 -#: ../src/Doc/howto/logging.rst:996 +#: howto/logging.rst:996 msgid "" "so that if the logger's threshold is set above ``DEBUG``, the calls to :func:" "`expensive_func1` and :func:`expensive_func2` are never made." msgstr "" # a2728227de8e47dfa96337245382d9cc -#: ../src/Doc/howto/logging.rst:999 +#: howto/logging.rst:999 msgid "" "In some cases, :meth:`~Logger.isEnabledFor` can itself be more expensive " "than you'd like (e.g. for deeply nested loggers where an explicit level is " @@ -5061,7 +5068,7 @@ msgid "" msgstr "" # 3257dacf4c96460da8c0925e42a393fa -#: ../src/Doc/howto/logging.rst:1008 +#: howto/logging.rst:1008 msgid "" "There are other optimizations which can be made for specific applications " "which need more precise control over what logging information is collected. " @@ -5070,22 +5077,22 @@ msgid "" msgstr "" # 6927c1ffb0bd42a9af7069601d10d897 -#: ../src/Doc/howto/logging.rst:1014 +#: howto/logging.rst:1014 msgid "What you don't want to collect" msgstr "" # feb4503a01104538b685a43d6af1549c -#: ../src/Doc/howto/logging.rst:1014 +#: howto/logging.rst:1014 msgid "How to avoid collecting it" msgstr "" # 212afa8e03c14f918f496827a5b7fa41 -#: ../src/Doc/howto/logging.rst:1016 +#: howto/logging.rst:1016 msgid "Information about where calls were made from." msgstr "" # 11539a1b2315485da96c7f77ce7708bf -#: ../src/Doc/howto/logging.rst:1016 +#: howto/logging.rst:1016 msgid "" "Set ``logging._srcfile`` to ``None``. This avoids calling :func:`sys." "_getframe`, which may help to speed up your code in environments like PyPy " @@ -5093,87 +5100,84 @@ msgid "" msgstr "" # 2bf0b3f20078478484040c88fb5e0c9f -#: ../src/Doc/howto/logging.rst:1023 +#: howto/logging.rst:1023 msgid "Threading information." msgstr "" # 38df13e6f6904874b224a52c41106e44 -#: ../src/Doc/howto/logging.rst:1023 +#: howto/logging.rst:1023 msgid "Set ``logging.logThreads`` to ``0``." msgstr "" # 15383c565c3f4acf82a5bfcf68f6f05d -#: ../src/Doc/howto/logging.rst:1025 +#: howto/logging.rst:1025 msgid "Process information." msgstr "" # d35805b7261b4ca0a6b55f46f6786b9a -#: ../src/Doc/howto/logging.rst:1025 +#: howto/logging.rst:1025 msgid "Set ``logging.logProcesses`` to ``0``." msgstr "" # 9ade541d83cc4d3d9a90b84faefe671c -#: ../src/Doc/howto/logging.rst:1028 +#: howto/logging.rst:1028 msgid "" "Also note that the core logging module only includes the basic handlers. If " "you don't import :mod:`logging.handlers` and :mod:`logging.config`, they " "won't take up any memory." msgstr "" -# 8628ef1542db410698329976abb52ef5 -#: ../src/Doc/howto/logging.rst:1034 -msgid "Module :mod:`logging`" +#: howto/logging.rst:1035 +msgid "Module logging" msgstr "" # 4d9db3afbb294a39a785a00688797682 -#: ../src/Doc/howto/logging.rst:1035 +#: howto/logging.rst:1035 msgid "API reference for the logging module." msgstr "" -# fd51fd03eddd44749cf3bc8d5f114a72 -#: ../src/Doc/howto/logging.rst:1037 -msgid "Module :mod:`logging.config`" +#: howto/logging.rst:1038 +msgid "Module logging.config" msgstr "" # 306c129ce0424b7b971f4a2100cb3501 -#: ../src/Doc/howto/logging.rst:1038 +#: howto/logging.rst:1038 msgid "Configuration API for the logging module." msgstr "" -# f3590e6a19494f6d96ab1a5c60cebab7 -#: ../src/Doc/howto/logging.rst:1040 -msgid "Module :mod:`logging.handlers`" +#: howto/logging.rst:1041 +msgid "Module logging.handlers" msgstr "" # 5553cb8d8a3e4597ad14c7fcbb14c6e4 -#: ../src/Doc/howto/logging.rst:1041 +#: howto/logging.rst:1041 msgid "Useful handlers included with the logging module." msgstr "" # b89c4135f79c4a45b7542b2c6387c19c -#: ../src/Doc/howto/logging.rst:1043 +#: howto/logging.rst:1043 msgid ":ref:`A logging cookbook `" msgstr "" # 4ab08e9dadb84d4abf609ac44e482eff -#: ../src/Doc/howto/logging-cookbook.rst:5 +#: howto/logging-cookbook.rst:5 msgid "Logging Cookbook" msgstr "" # c0ce754d04814546b28147373668a703 -#: ../src/Doc/howto/logging-cookbook.rst:9 +#: howto/logging-cookbook.rst:9 msgid "" "This page contains a number of recipes related to logging, which have been " "found useful in the past." msgstr "" # 715f427313b042e0973bfe1214fbcf86 -#: ../src/Doc/howto/logging-cookbook.rst:15 +#: howto/logging-cookbook.rst:15 msgid "Using logging in multiple modules" msgstr "" # 07be080861aa4966910120070a2bcae7 -#: ../src/Doc/howto/logging-cookbook.rst:17 +#: howto/logging-cookbook.rst:17 msgid "" "Multiple calls to ``logging.getLogger('someLogger')`` return a reference to " "the same logger object. This is true not only within the same module, but " @@ -5186,22 +5190,22 @@ msgid "" msgstr "" # ac89a0b43f9942ac8ffa73767a870b97 -#: ../src/Doc/howto/logging-cookbook.rst:55 +#: howto/logging-cookbook.rst:55 msgid "Here is the auxiliary module::" msgstr "" # 202c88ccc813452493d51d18228f4b94 -#: ../src/Doc/howto/logging-cookbook.rst:74 +#: howto/logging-cookbook.rst:74 msgid "The output looks like this::" msgstr "" # c5b3c475ae3a4e4ebfd5ccfb13dc6394 -#: ../src/Doc/howto/logging-cookbook.rst:98 +#: howto/logging-cookbook.rst:98 msgid "Multiple handlers and formatters" msgstr "" # 8e98f60b1c3c4a9f9f76545901e21e67 -#: ../src/Doc/howto/logging-cookbook.rst:100 +#: howto/logging-cookbook.rst:100 msgid "" "Loggers are plain Python objects. The :meth:`~Logger.addHandler` method has " "no minimum or maximum quota for the number of handlers you may add. " @@ -5214,7 +5218,7 @@ msgid "" msgstr "" # fea5f8250df845329bae0f1b1cc578dc -#: ../src/Doc/howto/logging-cookbook.rst:133 +#: howto/logging-cookbook.rst:133 msgid "" "Notice that the 'application' code does not care about multiple handlers. " "All that changed was the addition and configuration of a new handler named " @@ -5222,7 +5226,7 @@ msgid "" msgstr "" # cca0deb0ae6a4aa0b72abbdfbb0006eb -#: ../src/Doc/howto/logging-cookbook.rst:136 +#: howto/logging-cookbook.rst:136 msgid "" "The ability to create new handlers with higher- or lower-severity filters " "can be very helpful when writing and testing an application. Instead of " @@ -5235,12 +5239,12 @@ msgid "" msgstr "" # a5419a5385a049a48bab2d3934872bc5 -#: ../src/Doc/howto/logging-cookbook.rst:147 +#: howto/logging-cookbook.rst:147 msgid "Logging to multiple destinations" msgstr "" # 8df1e3cf14d241e5aeaaac3c052524a1 -#: ../src/Doc/howto/logging-cookbook.rst:149 +#: howto/logging-cookbook.rst:149 msgid "" "Let's say you want to log to console and file with different message formats " "and in differing circumstances. Say you want to log messages with levels of " @@ -5250,41 +5254,41 @@ msgid "" msgstr "" # 50f17ab298464b739ee8d1d4b80434de -#: ../src/Doc/howto/logging-cookbook.rst:187 +#: howto/logging-cookbook.rst:187 msgid "When you run this, on the console you will see ::" msgstr "" # 945781983dbb4309af5541d89d519d76 -#: ../src/Doc/howto/logging-cookbook.rst:194 +#: howto/logging-cookbook.rst:194 msgid "and in the file you will see something like ::" msgstr "" # c32d8934c8ec4284abb86048ee635f7c -#: ../src/Doc/howto/logging-cookbook.rst:202 +#: howto/logging-cookbook.rst:202 msgid "" "As you can see, the DEBUG message only shows up in the file. The other " "messages are sent to both destinations." msgstr "" # d13005faab0941dda60b029db228910f -#: ../src/Doc/howto/logging-cookbook.rst:205 +#: howto/logging-cookbook.rst:205 msgid "" "This example uses console and file handlers, but you can use any number and " "combination of handlers you choose." msgstr "" # 7796e09f6c204c78bc9a013ffc8401ce -#: ../src/Doc/howto/logging-cookbook.rst:210 +#: howto/logging-cookbook.rst:210 msgid "Configuration server example" msgstr "" # e845858550f041539106e414eb74d011 -#: ../src/Doc/howto/logging-cookbook.rst:212 +#: howto/logging-cookbook.rst:212 msgid "Here is an example of a module using the logging configuration server::" msgstr "" # 35eed5830c2743fcbf044db01c467208 -#: ../src/Doc/howto/logging-cookbook.rst:243 +#: howto/logging-cookbook.rst:243 msgid "" "And here is a script that takes a filename and sends that file to the " "server, properly preceded with the binary-encoded length, as the new logging " @@ -5292,12 +5296,12 @@ msgid "" msgstr "" # 681f1859e45c4bcc9affa678497dbaf6 -#: ../src/Doc/howto/logging-cookbook.rst:268 +#: howto/logging-cookbook.rst:268 msgid "Sending and receiving logging events across a network" msgstr "" # d83d778603ab4800a9d3e60ac154a2f6 -#: ../src/Doc/howto/logging-cookbook.rst:270 +#: howto/logging-cookbook.rst:270 msgid "" "Let's say you want to send logging events across a network, and handle them " "at the receiving end. A simple way of doing this is attaching a :class:" @@ -5305,21 +5309,21 @@ msgid "" msgstr "" # 5ef48760ffa94efe92ac5de482694d4f -#: ../src/Doc/howto/logging-cookbook.rst:298 +#: howto/logging-cookbook.rst:298 msgid "" "At the receiving end, you can set up a receiver using the :mod:" "`SocketServer` module. Here is a basic working example::" msgstr "" # 9208c8835d4445df8a4e87cd92dcaed1 -#: ../src/Doc/howto/logging-cookbook.rst:386 +#: howto/logging-cookbook.rst:386 msgid "" "First run the server, and then the client. On the client side, nothing is " "printed on the console; on the server side, you should see something like::" msgstr "" # e0cf06bdde8c4e5b8d4b85195b1f9145 -#: ../src/Doc/howto/logging-cookbook.rst:396 +#: howto/logging-cookbook.rst:396 msgid "" "Note that there are some security issues with pickle in some scenarios. If " "these affect you, you can use an alternative serialization scheme by " @@ -5329,12 +5333,12 @@ msgid "" msgstr "" # 0689a8aeb6c6492388316da1cf903b3c -#: ../src/Doc/howto/logging-cookbook.rst:406 +#: howto/logging-cookbook.rst:406 msgid "Adding contextual information to your logging output" msgstr "" # c64019d055454a31a89a2b0614d09f71 -#: ../src/Doc/howto/logging-cookbook.rst:410 +#: howto/logging-cookbook.rst:410 msgid "" "Sometimes you want logging output to contain contextual information in " "addition to the parameters passed to the logging call. For example, in a " @@ -5351,12 +5355,12 @@ msgid "" msgstr "" # d0c48a121ad7479eb9f0cb55e0bf66e4 -#: ../src/Doc/howto/logging-cookbook.rst:425 +#: howto/logging-cookbook.rst:425 msgid "Using LoggerAdapters to impart contextual information" msgstr "" # 113373d919594bd09aac8b4ec00abe8d -#: ../src/Doc/howto/logging-cookbook.rst:427 +#: howto/logging-cookbook.rst:427 msgid "" "An easy way in which you can pass contextual information to be output along " "with logging event information is to use the :class:`LoggerAdapter` class. " @@ -5368,7 +5372,7 @@ msgid "" msgstr "" # e2bedc4b1f784a439d61fcff704a768b -#: ../src/Doc/howto/logging-cookbook.rst:435 +#: howto/logging-cookbook.rst:435 msgid "" "When you create an instance of :class:`LoggerAdapter`, you pass it a :class:" "`Logger` instance and a dict-like object which contains your contextual " @@ -5380,7 +5384,7 @@ msgid "" msgstr "" # 89ba6e4de18a48cd904d42f92b745531 -#: ../src/Doc/howto/logging-cookbook.rst:451 +#: howto/logging-cookbook.rst:451 msgid "" "The :meth:`~LoggerAdapter.process` method of :class:`LoggerAdapter` is where " "the contextual information is added to the logging output. It's passed the " @@ -5394,7 +5398,7 @@ msgid "" msgstr "" # 5a612b2bcaf6472890b84ebaef1bc93a -#: ../src/Doc/howto/logging-cookbook.rst:460 +#: howto/logging-cookbook.rst:460 msgid "" "The advantage of using 'extra' is that the values in the dict-like object " "are merged into the :class:`LogRecord` instance's __dict__, allowing you to " @@ -5406,24 +5410,24 @@ msgid "" msgstr "" # 9316b95afbff4553bb1455ac8a2b4c01 -#: ../src/Doc/howto/logging-cookbook.rst:476 +#: howto/logging-cookbook.rst:476 msgid "which you can use like this::" msgstr "" # 23bc71e9663347a6988ee8708f96350d -#: ../src/Doc/howto/logging-cookbook.rst:481 +#: howto/logging-cookbook.rst:481 msgid "" "Then any events that you log to the adapter will have the value of " "``some_conn_id`` prepended to the log messages." msgstr "" # b7ab13928f994f7fb1e00f2e1ac655b6 -#: ../src/Doc/howto/logging-cookbook.rst:485 +#: howto/logging-cookbook.rst:485 msgid "Using objects other than dicts to pass contextual information" msgstr "" # e81d1bef160145c2a5a1af939bc62037 -#: ../src/Doc/howto/logging-cookbook.rst:487 +#: howto/logging-cookbook.rst:487 msgid "" "You don't need to pass an actual dict to a :class:`LoggerAdapter` - you " "could pass an instance of a class which implements ``__getitem__`` and " @@ -5433,12 +5437,12 @@ msgid "" msgstr "" # b7ab13928f994f7fb1e00f2e1ac655b6 -#: ../src/Doc/howto/logging-cookbook.rst:496 +#: howto/logging-cookbook.rst:496 msgid "Using Filters to impart contextual information" msgstr "" # d2afe8ebb2704ca39c5993e9b9aa8ce8 -#: ../src/Doc/howto/logging-cookbook.rst:498 +#: howto/logging-cookbook.rst:498 msgid "" "You can also add contextual information to log output using a user-defined :" "class:`Filter`. ``Filter`` instances are allowed to modify the " @@ -5448,7 +5452,7 @@ msgid "" msgstr "" # a5967f54c5a6401e8a0a73f3da93d47e -#: ../src/Doc/howto/logging-cookbook.rst:503 +#: howto/logging-cookbook.rst:503 msgid "" "For example in a web application, the request being processed (or at least, " "the interesting parts of it) can be stored in a threadlocal (:class:" @@ -5461,17 +5465,17 @@ msgid "" msgstr "" # 9316b95afbff4553bb1455ac8a2b4c01 -#: ../src/Doc/howto/logging-cookbook.rst:549 +#: howto/logging-cookbook.rst:549 msgid "which, when run, produces something like::" msgstr "" # 4dba03e90f9e4ef1835d31b361d4947a -#: ../src/Doc/howto/logging-cookbook.rst:568 +#: howto/logging-cookbook.rst:568 msgid "Logging to a single file from multiple processes" msgstr "" # 37465a7d39014454b6a67ffb1ddf9d93 -#: ../src/Doc/howto/logging-cookbook.rst:570 +#: howto/logging-cookbook.rst:570 msgid "" "Although logging is thread-safe, and logging to a single file from multiple " "threads in a single process *is* supported, logging to a single file from " @@ -5488,7 +5492,7 @@ msgid "" msgstr "" # 6c93640a937f4825b71d902736677003 -#: ../src/Doc/howto/logging-cookbook.rst:583 +#: howto/logging-cookbook.rst:583 msgid "" "If you are using a recent version of Python which includes the :mod:" "`multiprocessing` module, you could write your own handler which uses the :" @@ -5501,12 +5505,12 @@ msgid "" msgstr "" # 148f7bd8dfc74335a2ba74848ddbf233 -#: ../src/Doc/howto/logging-cookbook.rst:594 +#: howto/logging-cookbook.rst:594 msgid "Using file rotation" msgstr "" # 735c7d997b6441e189640ed352f6e9c7 -#: ../src/Doc/howto/logging-cookbook.rst:599 +#: howto/logging-cookbook.rst:599 msgid "" "Sometimes you want to let a log file grow to a certain size, then open a new " "file and log to that. You may want to keep a certain number of these files, " @@ -5517,14 +5521,14 @@ msgid "" msgstr "" # 3f25aaca339c4b03b5e93093dfd51cd7 -#: ../src/Doc/howto/logging-cookbook.rst:631 +#: howto/logging-cookbook.rst:631 msgid "" "The result should be 6 separate files, each with part of the log history for " "the application::" msgstr "" # dcde1ba2e5a84247819f964678e9948c -#: ../src/Doc/howto/logging-cookbook.rst:641 +#: howto/logging-cookbook.rst:641 msgid "" "The most current file is always :file:`logging_rotatingfile_example.out`, " "and each time it reaches the size limit it is renamed with the suffix " @@ -5533,19 +5537,19 @@ msgid "" msgstr "" # 7233ec1669a44294a05ce2061985a22a -#: ../src/Doc/howto/logging-cookbook.rst:646 +#: howto/logging-cookbook.rst:646 msgid "" "Obviously this example sets the log length much too small as an extreme " "example. You would want to set *maxBytes* to an appropriate value." msgstr "" # 0a6c71c9fbdc42c6b076ace75960a935 -#: ../src/Doc/howto/logging-cookbook.rst:650 +#: howto/logging-cookbook.rst:650 msgid "An example dictionary-based configuration" msgstr "" # 98716e710eee4013b7f910bdcc805a2f -#: ../src/Doc/howto/logging-cookbook.rst:652 +#: howto/logging-cookbook.rst:652 msgid "" "Below is an example of a logging configuration dictionary - it's taken from " "the `documentation on the Django project `_ requires that a Unicode " "message be sent to a syslog daemon as a set of bytes which have the " @@ -5578,7 +5582,7 @@ msgid "" msgstr "" # bc7217561a084ee2be1f776e926b809b -#: ../src/Doc/howto/logging-cookbook.rst:721 +#: howto/logging-cookbook.rst:721 msgid "" "In Python 2.6 and 2.7, code was added to :class:`~logging.handlers." "SysLogHandler` to insert a BOM into the message, but unfortunately, it was " @@ -5587,7 +5591,7 @@ msgid "" msgstr "" # 45afc2aaa85d4baaab52e127881f5de2 -#: ../src/Doc/howto/logging-cookbook.rst:727 +#: howto/logging-cookbook.rst:727 msgid "" "As this behaviour is broken, the incorrect BOM insertion code is being " "removed from Python 2.7.4 and later. However, it is not being replaced, and " @@ -5597,21 +5601,21 @@ msgid "" msgstr "" # 01bc166a6b9e4f9dafd3630988f930f4 -#: ../src/Doc/howto/logging-cookbook.rst:733 +#: howto/logging-cookbook.rst:733 msgid "" "Attach a :class:`~logging.Formatter` instance to your :class:`~logging." "handlers.SysLogHandler` instance, with a format string such as::" msgstr "" # 0b13247194d7497096e313fa273bb8f9 -#: ../src/Doc/howto/logging-cookbook.rst:739 +#: howto/logging-cookbook.rst:739 msgid "" "The Unicode code point ``u'\\ufeff'``, when encoded using UTF-8, will be " "encoded as a UTF-8 BOM -- the byte-string ``'\\xef\\xbb\\xbf'``." msgstr "" # 1baa721b6f894e18924bb49539aece78 -#: ../src/Doc/howto/logging-cookbook.rst:742 +#: howto/logging-cookbook.rst:742 msgid "" "Replace the ASCII section with whatever placeholders you like, but make sure " "that the data that appears in there after substitution is always ASCII (that " @@ -5619,7 +5623,7 @@ msgid "" msgstr "" # 39da5b688cb34daa8d2724e58a163924 -#: ../src/Doc/howto/logging-cookbook.rst:746 +#: howto/logging-cookbook.rst:746 msgid "" "Replace the Unicode section with whatever placeholders you like; if the data " "which appears there after substitution contains characters outside the ASCII " @@ -5627,7 +5631,7 @@ msgid "" msgstr "" # 563aa68eaa3844419e017beec419601c -#: ../src/Doc/howto/logging-cookbook.rst:750 +#: howto/logging-cookbook.rst:750 msgid "" "If the formatted message is Unicode, it *will* be encoded using UTF-8 " "encoding by ``SysLogHandler``. If you follow the above rules, you should be " @@ -5637,12 +5641,12 @@ msgid "" msgstr "" # 0d8560d1498f4c6ca61453cad525e91b -#: ../src/Doc/howto/logging-cookbook.rst:758 +#: howto/logging-cookbook.rst:758 msgid "Implementing structured logging" msgstr "" # 62bce27fb80a44d484ad24911feda140 -#: ../src/Doc/howto/logging-cookbook.rst:760 +#: howto/logging-cookbook.rst:760 msgid "" "Although most logging messages are intended for reading by humans, and thus " "not readily machine-parseable, there might be cirumstances where you want to " @@ -5655,38 +5659,37 @@ msgid "" msgstr "" # d8e16a2c93764297b5221734eb03d6ea -#: ../src/Doc/howto/logging-cookbook.rst:784 +#: howto/logging-cookbook.rst:784 msgid "If the above script is run, it prints::" msgstr "" # f20b3a7bba7c4657972e45a86bbc4b45 # 9e6574c13a474001a7b68b02043c52d5 -#: ../src/Doc/howto/logging-cookbook.rst:788 -#: ../src/Doc/howto/logging-cookbook.rst:835 +#: howto/logging-cookbook.rst:788 howto/logging-cookbook.rst:835 msgid "" "Note that the order of items might be different according to the version of " "Python used." msgstr "" # 4dff3c2a5e2044c6ac210738690ac934 -#: ../src/Doc/howto/logging-cookbook.rst:791 +#: howto/logging-cookbook.rst:791 msgid "" "If you need more specialised processing, you can use a custom JSON encoder, " "as in the following complete example::" msgstr "" # 1a7bdf84caba47cebdbefa1ffa3c403f -#: ../src/Doc/howto/logging-cookbook.rst:831 +#: howto/logging-cookbook.rst:831 msgid "When the above script is run, it prints::" msgstr "" # 6e3fdd33d9a34c10940b48131ca922f1 -#: ../src/Doc/howto/logging-cookbook.rst:844 +#: howto/logging-cookbook.rst:844 msgid "Customizing handlers with :func:`dictConfig`" msgstr "" # 609142a705684ef887b9188935200181 -#: ../src/Doc/howto/logging-cookbook.rst:846 +#: howto/logging-cookbook.rst:846 msgid "" "There are times when you want to customize logging handlers in particular " "ways, and if you use :func:`dictConfig` you may be able to do this without " @@ -5697,14 +5700,14 @@ msgid "" msgstr "" # 4d47d67f619645d1950fc10b4f1dc91f -#: ../src/Doc/howto/logging-cookbook.rst:865 +#: howto/logging-cookbook.rst:865 msgid "" "You can then specify, in a logging configuration passed to :func:" "`dictConfig`, that a logging handler be created by calling this function::" msgstr "" # 8c06e5cb9a48412fb00d1f1317f0077d -#: ../src/Doc/howto/logging-cookbook.rst:898 +#: howto/logging-cookbook.rst:898 msgid "" "In this example I am setting the ownership using the ``pulse`` user and " "group, just for the purposes of illustration. Putting it together into a " @@ -5712,12 +5715,12 @@ msgid "" msgstr "" # 8e3572b8a76c4f63891e3c656ade99f9 -#: ../src/Doc/howto/logging-cookbook.rst:945 +#: howto/logging-cookbook.rst:945 msgid "To run this, you will probably need to run as ``root``::" msgstr "" # 2ba20e9beb6d43e0a98da6e04a5fe42b -#: ../src/Doc/howto/logging-cookbook.rst:953 +#: howto/logging-cookbook.rst:953 msgid "" "Note that this example uses Python 3.3 because that's where :func:`shutil." "chown` makes an appearance. This approach should work with any Python " @@ -5727,19 +5730,19 @@ msgid "" msgstr "" # 873509a8c6204c27a0af43b25beecfe2 -#: ../src/Doc/howto/logging-cookbook.rst:959 +#: howto/logging-cookbook.rst:959 msgid "" "In practice, the handler-creating function may be in a utility module " "somewhere in your project. Instead of the line in the configuration::" msgstr "" # 4e48ec9d6a6840c697af9e9831a64aa0 -#: ../src/Doc/howto/logging-cookbook.rst:964 +#: howto/logging-cookbook.rst:964 msgid "you could use e.g.::" msgstr "" # 3a82194747ae4b23b1ad1aa66af528a0 -#: ../src/Doc/howto/logging-cookbook.rst:968 +#: howto/logging-cookbook.rst:968 msgid "" "where ``project.util`` can be replaced with the actual name of the package " "where the function resides. In the above working script, using ``'ext://" @@ -5748,7 +5751,7 @@ msgid "" msgstr "" # 4b2d94be597545978078af2b12d62c14 -#: ../src/Doc/howto/logging-cookbook.rst:973 +#: howto/logging-cookbook.rst:973 msgid "" "This example hopefully also points the way to how you could implement other " "types of file change - e.g. setting specific POSIX permission bits - in the " @@ -5756,7 +5759,7 @@ msgid "" msgstr "" # 08e469fef83a4330926f828d88e9ebe6 -#: ../src/Doc/howto/logging-cookbook.rst:977 +#: howto/logging-cookbook.rst:977 msgid "" "Of course, the approach could also be extended to types of handler other " "than a :class:`~logging.FileHandler` - for example, one of the rotating file " @@ -5764,12 +5767,12 @@ msgid "" msgstr "" # 02c540aa3e87419d8a2437011c57f47b -#: ../src/Doc/howto/logging-cookbook.rst:985 +#: howto/logging-cookbook.rst:985 msgid "Configuring filters with :func:`dictConfig`" msgstr "" # a83e5f5b18094a7d9ce8f4cf4254b949 -#: ../src/Doc/howto/logging-cookbook.rst:987 +#: howto/logging-cookbook.rst:987 msgid "" "You *can* configure filters using :func:`~logging.config.dictConfig`, though " "it might not be obvious at first glance how to do it (hence this recipe). " @@ -5785,7 +5788,7 @@ msgid "" msgstr "" # 5d668e33f96f4efb95e8de2334a7e93d -#: ../src/Doc/howto/logging-cookbook.rst:1040 +#: howto/logging-cookbook.rst:1040 msgid "" "This example shows how you can pass configuration data to the callable which " "constructs the instance, in the form of keyword parameters. When run, the " @@ -5793,17 +5796,17 @@ msgid "" msgstr "" # fbcf9986f4da445ab27f946a5bf59dcf -#: ../src/Doc/howto/logging-cookbook.rst:1046 +#: howto/logging-cookbook.rst:1046 msgid "which shows that the filter is working as configured." msgstr "" # ca7822bd3451451eb53c76bb8ef104cd -#: ../src/Doc/howto/logging-cookbook.rst:1048 +#: howto/logging-cookbook.rst:1048 msgid "A couple of extra points to note:" msgstr "" # 16fa4de733634057985a4b3495555a47 -#: ../src/Doc/howto/logging-cookbook.rst:1050 +#: howto/logging-cookbook.rst:1050 msgid "" "If you can't refer to the callable directly in the configuration (e.g. if it " "lives in a different module, and you can't import it directly where the " @@ -5814,7 +5817,7 @@ msgid "" msgstr "" # 9438e5f8a9ea4fa199092485ad386ee4 -#: ../src/Doc/howto/logging-cookbook.rst:1057 +#: howto/logging-cookbook.rst:1057 msgid "" "As well as for filters, this technique can also be used to configure custom " "handlers and formatters. See :ref:`logging-config-dict-userdef` for more " @@ -5823,18 +5826,169 @@ msgid "" "above." msgstr "" +#: howto/logging-cookbook.rst:1066 +msgid "Customized exception formatting" +msgstr "" + +#: howto/logging-cookbook.rst:1068 +msgid "" +"There might be times when you want to do customized exception formatting - " +"for argument's sake, let's say you want exactly one line per logged event, " +"even when exception information is present. You can do this with a custom " +"formatter class, as shown in the following example::" +msgstr "" + +#: howto/logging-cookbook.rst:1109 +msgid "When run, this produces a file with exactly two lines::" +msgstr "" + +#: howto/logging-cookbook.rst:1114 +msgid "" +"While the above treatment is simplistic, it points the way to how exception " +"information can be formatted to your liking. The :mod:`traceback` module may " +"be helpful for more specialized needs." +msgstr "" + +#: howto/logging-cookbook.rst:1121 +msgid "Speaking logging messages" +msgstr "" + +#: howto/logging-cookbook.rst:1123 +msgid "" +"There might be situations when it is desirable to have logging messages " +"rendered in an audible rather than a visible format. This is easy to do if " +"you have text- to-speech (TTS) functionality available in your system, even " +"if it doesn't have a Python binding. Most TTS systems have a command line " +"program you can run, and this can be invoked from a handler using :mod:" +"`subprocess`. It's assumed here that TTS command line programs won't expect " +"to interact with users or take a long time to complete, and that the " +"frequency of logged messages will be not so high as to swamp the user with " +"messages, and that it's acceptable to have the messages spoken one at a time " +"rather than concurrently, The example implementation below waits for one " +"message to be spoken before the next is processed, and this might cause " +"other handlers to be kept waiting. Here is a short example showing the " +"approach, which assumes that the ``espeak`` TTS package is available::" +msgstr "" + +#: howto/logging-cookbook.rst:1165 +msgid "" +"When run, this script should say \"Hello\" and then \"Goodbye\" in a female " +"voice." +msgstr "" + +#: howto/logging-cookbook.rst:1167 +msgid "" +"The above approach can, of course, be adapted to other TTS systems and even " +"other systems altogether which can process messages via external programs " +"run from a command line." +msgstr "" + +#: howto/logging-cookbook.rst:1174 +msgid "Buffering logging messages and outputting them conditionally" +msgstr "" + +#: howto/logging-cookbook.rst:1176 +msgid "" +"There might be situations where you want to log messages in a temporary area " +"and only output them if a certain condition occurs. For example, you may " +"want to start logging debug events in a function, and if the function " +"completes without errors, you don't want to clutter the log with the " +"collected debug information, but if there is an error, you want all the " +"debug information to be output as well as the error." +msgstr "" + +#: howto/logging-cookbook.rst:1183 +msgid "" +"Here is an example which shows how you could do this using a decorator for " +"your functions where you want logging to behave this way. It makes use of " +"the :class:`logging.handlers.MemoryHandler`, which allows buffering of " +"logged events until some condition occurs, at which point the buffered " +"events are ``flushed`` - passed to another handler (the ``target`` handler) " +"for processing. By default, the ``MemoryHandler`` flushed when its buffer " +"gets filled up or an event whose level is greater than or equal to a " +"specified threshold is seen. You can use this recipe with a more specialised " +"subclass of ``MemoryHandler`` if you want custom flushing behavior." +msgstr "" + +#: howto/logging-cookbook.rst:1193 +msgid "" +"The example script has a simple function, ``foo``, which just cycles through " +"all the logging levels, writing to ``sys.stderr`` to say what level it's " +"about to log at, and then actually logging a message that that level. You " +"can pass a parameter to ``foo`` which, if true, will log at ERROR and " +"CRITICAL levels - otherwise, it only logs at DEBUG, INFO and WARNING levels." +msgstr "" + +#: howto/logging-cookbook.rst:1199 +msgid "" +"The script just arranges to decorate ``foo`` with a decorator which will do " +"the conditional logging that's required. The decorator takes a logger as a " +"parameter and attaches a memory handler for the duration of the call to the " +"decorated function. The decorator can be additionally parameterised using a " +"target handler, a level at which flushing should occur, and a capacity for " +"the buffer. These default to a :class:`~logging.StreamHandler` which writes " +"to ``sys.stderr``, ``logging.ERROR`` and ``100`` respectively." +msgstr "" + +#: howto/logging-cookbook.rst:1207 +msgid "Here's the script::" +msgstr "" + +#: howto/logging-cookbook.rst:1270 +msgid "When this script is run, the following output should be observed::" +msgstr "" + +#: howto/logging-cookbook.rst:1298 +msgid "" +"As you can see, actual logging output only occurs when an event is logged " +"whose severity is ERROR or greater, but in that case, any previous events at " +"lower severities are also logged." +msgstr "" + +#: howto/logging-cookbook.rst:1302 +msgid "You can of course use the conventional means of decoration::" +msgstr "" + +#: howto/logging-cookbook.rst:1312 +msgid "Formatting times using UTC (GMT) via configuration" +msgstr "" + +#: howto/logging-cookbook.rst:1314 +msgid "" +"Sometimes you want to format times using UTC, which can be done using a " +"class such as `UTCFormatter`, shown below::" +msgstr "" + +#: howto/logging-cookbook.rst:1323 +msgid "" +"and you can then use the ``UTCFormatter`` in your code instead of :class:" +"`~logging.Formatter`. If you want to do that via configuration, you can use " +"the :func:`~logging.config.dictConfig` API with an approach illustrated by " +"the following complete example::" +msgstr "" + +#: howto/logging-cookbook.rst:1366 +msgid "When this script is run, it should print something like::" +msgstr "" + +#: howto/logging-cookbook.rst:1371 +msgid "" +"showing how the time is formatted both as local time and UTC, one for each " +"handler." +msgstr "" + # e836dbe15866465da83f3801b4809e39 -#: ../src/Doc/howto/pyporting.rst:5 +#: howto/pyporting.rst:5 msgid "Porting Python 2 Code to Python 3" msgstr "" # fc7eaf7cb2144f37af8eeeaaecccbec0 -#: ../src/Doc/howto/pyporting.rst:7 +#: howto/pyporting.rst:7 msgid "Brett Cannon" msgstr "" # 514eabc408a54e8196ff75ca1ef5faf1 -#: ../src/Doc/howto/pyporting.rst:11 +#: howto/pyporting.rst:11 msgid "" "With Python 3 being the future of Python while Python 2 is still in active " "use, it is good to have your project available for both major releases of " @@ -5843,913 +5997,587 @@ msgid "" msgstr "" # ae071a7dbe9c4bd2a9276020dffb59e5 -#: ../src/Doc/howto/pyporting.rst:16 +#: howto/pyporting.rst:16 msgid "" "If you are looking to port an extension module instead of pure Python code, " "please see :ref:`cporting-howto`." msgstr "" # 73cb2b9e2b534b9ea89579783b6a07a7 -#: ../src/Doc/howto/pyporting.rst:19 +#: howto/pyporting.rst:19 msgid "" "If you would like to read one core Python developer's take on why Python 3 " "came into existence, you can read Nick Coghlan's `Python 3 Q & A`_." msgstr "" -# d2e8d2742a014dda97511dde79ee49d9 -#: ../src/Doc/howto/pyporting.rst:22 -msgid "" -"If you prefer to read a (free) book on porting a project to Python 3, " -"consider reading `Porting to Python 3`_ by Lennart Regebro which should " -"cover much of what is discussed in this HOWTO." -msgstr "" - # 5f37e14e84c14dbbafd338935c691f7a -#: ../src/Doc/howto/pyporting.rst:26 +#: howto/pyporting.rst:22 msgid "" "For help with porting, you can email the python-porting_ mailing list with " "questions." msgstr "" -# 9a20b89edd7943e1a8602563008f8378 -#: ../src/Doc/howto/pyporting.rst:30 -msgid "The Short Version" +#: howto/pyporting.rst:26 +msgid "The Short Explanation" msgstr "" -# 285da7ae4c3b48148cddf61741ea59c4 -#: ../src/Doc/howto/pyporting.rst:32 +#: howto/pyporting.rst:28 msgid "" -"Decide what's the oldest version of Python 2 you want to support (if at all)" +"To make your project be single-source Python 2/3 compatible, the basic steps " +"are:" msgstr "" -# b4846c5532134f50815fa7f947894f5d -#: ../src/Doc/howto/pyporting.rst:33 +#: howto/pyporting.rst:31 msgid "" -"Make sure you have a thorough test suite and use continuous integration " -"testing to make sure you stay compatible with the versions of Python you " -"care about" +"Update your code to drop support for Python 2.5 or older (supporting only " +"Python 2.7 is ideal)" msgstr "" -# e4fe3362859047d0895051e3e52a22a2 -#: ../src/Doc/howto/pyporting.rst:36 +#: howto/pyporting.rst:33 msgid "" -"If you have dependencies, check their Python 3 status using caniusepython3 " -"(`command-line tool `__, `web " -"app `__)" +"Make sure you have good test coverage (coverage.py_ can help; ``pip install " +"coverage``)" msgstr "" -# 5407e7f6dd0e42978c07989ca030075b -#: ../src/Doc/howto/pyporting.rst:40 -msgid "With that done, your options are:" +#: howto/pyporting.rst:35 howto/pyporting.rst:114 howto/pyporting.rst:369 +msgid "Learn the differences between Python 2 & 3" msgstr "" -# 51f5e59aa2194c7597a6e3da783612e4 -#: ../src/Doc/howto/pyporting.rst:42 +#: howto/pyporting.rst:36 msgid "" -"If you are dropping Python 2 support, use :ref:`2to3 <2to3-reference>` to " -"port to Python 3" +"Use Modernize_ or Futurize_ to update your code (``pip install modernize`` " +"or ``pip install future``, respectively)" msgstr "" -# b9d3e51f64894b4db110d5d5f378b11c -#: ../src/Doc/howto/pyporting.rst:45 +#: howto/pyporting.rst:38 msgid "" -"If you are keeping Python 2 support, then start writing Python 2/3-" -"compatible code starting **TODAY**" +"Use Pylint_ to help make sure you don't regress on your Python 3 support (if " +"only supporting Python 2.7/3.4 or newer; ``pip install pylint``)" msgstr "" -# 319d8d9a69a646abbde7e125f6f32d70 -#: ../src/Doc/howto/pyporting.rst:48 +#: howto/pyporting.rst:40 msgid "" -"If you have dependencies that have not been ported, reach out to them to " -"port their project while working to make your code compatible with Python 3 " -"so you're ready when your dependencies are all ported" +"Use caniusepython3_ to find out which of your dependencies are blocking your " +"use of Python 3 (``pip install caniusepython3``)" msgstr "" -# 6b6330340c974bab9420bc7286499a0b -#: ../src/Doc/howto/pyporting.rst:51 +#: howto/pyporting.rst:42 msgid "" -"If all your dependencies have been ported (or you have none), go ahead and " -"port to Python 3" +"Once your dependencies are no longer blocking you, use continuous " +"integration to make sure you stay compatible with Python 2 & 3 (tox_ can " +"help test against multiple versions of Python; ``pip install tox``)" msgstr "" -# 59e8f9f7a3934f71a6a6e38aa7e0818d -#: ../src/Doc/howto/pyporting.rst:54 +#: howto/pyporting.rst:46 msgid "" -"If you are creating a new project that wants to have 2/3 compatibility, code " -"in Python 3 and then backport to Python 2" +"If you are dropping support for Python 2 entirely, then after you learn the " +"differences between Python 2 & 3 you can run 2to3_ over your code and skip " +"the rest of the steps outlined above." msgstr "" -# cf359e67f99f47c98ffd55f73df3b547 -#: ../src/Doc/howto/pyporting.rst:59 -msgid "Before You Begin" +#: howto/pyporting.rst:52 +msgid "Details" msgstr "" -# b585dc57f9ad48cca1da8d40562eab72 -#: ../src/Doc/howto/pyporting.rst:61 +#: howto/pyporting.rst:54 msgid "" -"If your project is on the Cheeseshop_/PyPI_, make sure it has the proper " -"`trove classifiers`_ to signify what versions of Python it **currently** " -"supports. At minimum you should specify the major version(s), e.g. " -"``Programming Language :: Python :: 2`` if your project currently only " -"supports Python 2. It is preferrable that you be as specific as possible by " -"listing every major/minor version of Python that you support, e.g. if your " -"project supports Python 2.6 and 2.7, then you want the classifiers of::" +"A key point about supporting Python 2 & 3 simultaneously is that you can " +"start **today**! Even if your dependencies are not supporting Python 3 yet " +"that does not mean you can't modernize your code **now** to support Python " +"3. Most changes required to support Python 3 lead to cleaner code using " +"newer practices even in Python 2." msgstr "" -# 38f0ff77e0174dfbb1a443e115ebd7d0 -#: ../src/Doc/howto/pyporting.rst:73 +#: howto/pyporting.rst:60 msgid "" -"Once your project supports Python 3 you will want to go back and add the " -"appropriate classifiers for Python 3 as well. This is important as setting " -"the ``Programming Language :: Python :: 3`` classifier will lead to your " -"project being listed under the `Python 3 Packages`_ section of PyPI." +"Another key point is that modernizing your Python 2 code to also support " +"Python 3 is largely automated for you. While you might have to make some API " +"decisions thanks to Python 3 clarifying text data versus binary data, the " +"lower-level work is now mostly done for you and thus can at least benefit " +"from the automated changes immediately." msgstr "" -# affaf1a2cc0f471abc51dbe3030b80a3 -#: ../src/Doc/howto/pyporting.rst:78 +#: howto/pyporting.rst:66 msgid "" -"Make sure you have a robust test suite. You need to make sure everything " -"continues to work, just like when you support a new minor/feature release of " -"Python. This means making sure your test suite is thorough and is ported " -"properly between Python 2 & 3 (consider using coverage_ to measure that you " -"have effective test coverage). You will also most likely want to use " -"something like tox_ to automate testing between all of your supported " -"versions of Python. You will also want to **port your tests first** so that " -"you can make sure that you detect breakage during the transition. Tests also " -"tend to be simpler than the code they are testing so it gives you an idea of " -"how easy it can be to port code." +"Keep those key points in mind while you read on about the details of porting " +"your code to support Python 2 & 3 simultaneously." msgstr "" -# 5effd53c2aef4e0aab8b9d929505073f -#: ../src/Doc/howto/pyporting.rst:89 +#: howto/pyporting.rst:71 +msgid "Drop support for Python 2.5 and older (at least)" +msgstr "" + +#: howto/pyporting.rst:73 msgid "" -"Drop support for older Python versions if possible. Python 2.5 introduced a " -"lot of useful syntax and libraries which have become idiomatic in Python 3. " -"Python 2.6 introduced future statements which makes compatibility much " -"easier if you are going from Python 2 to 3. Python 2.7 continues the trend " -"in the stdlib. Choose the newest version of Python which you believe can be " -"your minimum support version and work from there." +"While you can make Python 2.5 work with Python 3, it is **much** easier if " +"you only have to work with Python 2.6 or newer (and easier still if you only " +"have to work with Python 2.7). If dropping Python 2.5 is not an option then " +"the six_ project can help you support Python 2.5 & 3 simultaneously (``pip " +"install six``). Do realize, though, that nearly all the projects listed in " +"this HOWTO will not be available to you." msgstr "" -# 0a81a69232c744c8bddfdb39e9dee724 -#: ../src/Doc/howto/pyporting.rst:97 +#: howto/pyporting.rst:80 msgid "" -"Target the newest version of Python 3 that you can. Beyond just the usual " -"bugfixes, compatibility has continued to improve between Python 2 and 3 as " -"time has passed. E.g. Python 3.3 added back the ``u`` prefix for strings, " -"making source-compatible Python code easier to write." +"If you are able to only support Python 2.6 or newer, then the required " +"changes to your code should continue to look and feel like idiomatic Python " +"code. At worst you will have to use a function instead of a method in some " +"instances or have to import a function instead of using a built-in one, but " +"otherwise the overall transformation should not feel foreign to you." msgstr "" -# 5df91ba38d274da78f22e256b624e640 -#: ../src/Doc/howto/pyporting.rst:104 -msgid "Writing Source-Compatible Python 2/3 Code" -msgstr "" - -# b384fa25c3e345f8b0ca45ee37745924 -#: ../src/Doc/howto/pyporting.rst:106 +#: howto/pyporting.rst:86 msgid "" -"Over the years the Python community has discovered that the easiest way to " -"support both Python 2 and 3 in parallel is to write Python code that works " -"in either version. While this might sound counter-intuitive at first, it " -"actually is not difficult and typically only requires following some select " -"(non-idiomatic) practices and using some key projects to help make bridging " -"between Python 2 and 3 easier." +"But please aim for Python 2.7. Bugfixes for that version of Python will " +"continue until 2020 while Python 2.6 is no longer supported. There are also " +"some tools mentioned in this HOWTO which do not support Python 2.6 (e.g., " +"Pylint_), and this will become more commonplace as time goes on." msgstr "" -# e37ea88df3114b16bbbd343df032925a -#: ../src/Doc/howto/pyporting.rst:114 -msgid "Projects to Consider" -msgstr "" - -# d786edc5e71649b4a381fc625b01e595 -#: ../src/Doc/howto/pyporting.rst:116 +#: howto/pyporting.rst:92 msgid "" -"The lowest level library for supporting Python 2 & 3 simultaneously is six_. " -"Reading through its documentation will give you an idea of where exactly the " -"Python language changed between versions 2 & 3 and thus what you will want " -"the library to help you continue to support." +"Make sure you specify the proper version support in your ``setup.py`` file" msgstr "" -# 0cb34f83b81346bd8e2945291e23f36d -#: ../src/Doc/howto/pyporting.rst:121 +#: howto/pyporting.rst:94 msgid "" -"To help automate porting your code over to using six, you can use " -"modernize_. This project will attempt to rewrite your code to be as modern " -"as possible while using six to smooth out any differences between Python 2 & " -"3." +"In your ``setup.py`` file you should have the proper `trove classifier`_ " +"specifying what versions of Python you support. As your project does not " +"support Python 3 yet you should at least have ``Programming Language :: " +"Python :: 2 :: Only`` specified. Ideally you should also specify each major/" +"minor version of Python that you do support, e.g. ``Programming Language :: " +"Python :: 2.7``." msgstr "" -# d77300995d5546c891a7d7b9f0dfd4fe -#: ../src/Doc/howto/pyporting.rst:125 +#: howto/pyporting.rst:102 +msgid "Have good test coverage" +msgstr "" + +#: howto/pyporting.rst:104 msgid "" -"If you want to write your compatible code to feel more like Python 3 there " -"is the future_ project. It tries to provide backports of objects from Python " -"3 so that you can use them from Python 2-compatible code, e.g. replacing the " -"``bytes`` type from Python 2 with the one from Python 3. It also provides a " -"translation script like modernize (its translation code is actually " -"partially based on it) to help start working with a pre-existing code base. " -"It is also unique in that its translation script will also port Python 3 " -"code backwards as well as Python 2 code forwards." +"Once you have your code supporting the oldest version of Python 2 you want " +"it to, you will want to make sure your test suite has good coverage. A good " +"rule of thumb is that if you want to be confident enough in your test suite " +"that any failures that appear after having tools rewrite your code are " +"actual bugs in the tools and not in your code. If you want a number to aim " +"for, try to get over 80% coverage (and don't feel bad if you can't easily " +"get past 90%). If you don't already have a tool to measure test coverage " +"then coverage.py_ is recommended." msgstr "" -# 7978c3bcde614790b21ec2f6b3d1a13f -#: ../src/Doc/howto/pyporting.rst:136 -msgid "Tips & Tricks" -msgstr "" - -# f36bf80c4a9c4e3c806fbc8f4fc8f1a9 -#: ../src/Doc/howto/pyporting.rst:138 +#: howto/pyporting.rst:116 msgid "" -"To help with writing source-compatible code using one of the projects " -"mentioned in `Projects to Consider`_, consider following the below " -"suggestions. Some of them are handled by the suggested projects, so if you " -"do use one of them then read their documentation first to see which " -"suggestions below will taken care of for you." +"Once you have your code well-tested you are ready to begin porting your code " +"to Python 3! But to fully understand how your code is going to change and " +"what you want to look out for while you code, you will want to learn what " +"changes Python 3 makes in terms of Python 2. Typically the two best ways of " +"doing that is reading the `\"What's New\"`_ doc for each release of Python 3 " +"and the `Porting to Python 3`_ book (which is free online). There is also a " +"handy `cheat sheet`_ from the Python-Future project." msgstr "" -# 0052bcd6b2e2478c814287f60a3ae01a -#: ../src/Doc/howto/pyporting.rst:145 -msgid "Support Python 2.7" +#: howto/pyporting.rst:126 +msgid "Update your code" msgstr "" -# 985a47117ed94be5bb5fa2a533228a63 -#: ../src/Doc/howto/pyporting.rst:147 +#: howto/pyporting.rst:128 msgid "" -"As a first step, make sure that your project is compatible with Python 2.7. " -"This is just good to do as Python 2.7 is the last release of Python 2 and " -"thus will be used for a rather long time. It also allows for use of the " -"``-3`` flag to Python to help discover places in your code where " -"compatibility might be an issue (the ``-3`` flag is in Python 2.6 but Python " -"2.7 adds more warnings)." +"Once you feel like you know what is different in Python 3 compared to Python " +"2, it's time to update your code! You have a choice between two tools in " +"porting your code automatically: Modernize_ and Futurize_. Which tool you " +"choose will depend on how much like Python 3 you want your code to be. " +"Futurize_ does its best to make Python 3 idioms and practices exist in " +"Python 2, e.g. backporting the ``bytes`` type from Python 3 so that you have " +"semantic parity between the major versions of Python. Modernize_, on the " +"other hand, is more conservative and targets a Python 2/3 subset of Python, " +"relying on six_ to help provide compatibility." msgstr "" -# c325727b35694b8abd54f7a8e47a57d5 -#: ../src/Doc/howto/pyporting.rst:154 -msgid "Try to Support Python 2.6 and Newer Only" -msgstr "" - -# b74674991a424c7c8bf5da770d9ff79c -#: ../src/Doc/howto/pyporting.rst:156 +#: howto/pyporting.rst:138 msgid "" -"While not possible for all projects, if you can support Python 2.6 and newer " -"**only**, your life will be much easier. Various future statements, stdlib " -"additions, etc. exist only in Python 2.6 and later which greatly assist in " -"supporting Python 3. But if you project must keep support for Python 2.5 " -"then it is still possible to simultaneously support Python 3." +"Regardless of which tool you choose, they will update your code to run under " +"Python 3 while staying compatible with the version of Python 2 you started " +"with. Depending on how conservative you want to be, you may want to run the " +"tool over your test suite first and visually inspect the diff to make sure " +"the transformation is accurate. After you have transformed your test suite " +"and verified that all the tests still pass as expected, then you can " +"transform your application code knowing that any tests which fail is a " +"translation failure." msgstr "" -# 612c0ab302284a8f816f83128df1c249 -#: ../src/Doc/howto/pyporting.rst:162 +#: howto/pyporting.rst:146 msgid "" -"Below are the benefits you gain if you only have to support Python 2.6 and " -"newer. Some of these options are personal choice while others are " -"**strongly** recommended (the ones that are more for personal choice are " -"labeled as such). If you continue to support older versions of Python then " -"you at least need to watch out for situations that these solutions fix and " -"handle them appropriately (which is where library help from e.g. six_ comes " -"in handy)." +"Unfortunately the tools can't automate everything to make your code work " +"under Python 3 and so there are a handful of things you will need to update " +"manually to get full Python 3 support (which of these steps are necessary " +"vary between the tools). Read the documentation for the tool you choose to " +"use to see what it fixes by default and what it can do optionally to know " +"what will (not) be fixed for you and what you may have to fix on your own (e." +"g. using ``io.open()`` over the built-in ``open()`` function is off by " +"default in Modernize). Luckily, though, there are only a couple of things to " +"watch out for which can be considered large issues that may be hard to debug " +"if not watched for." msgstr "" -# 9c73d37a434e4173a419bcc1c03ff471 -#: ../src/Doc/howto/pyporting.rst:171 -msgid "``from __future__ import print_function``" +#: howto/pyporting.rst:157 +msgid "Division" msgstr "" -# 1b9862a9864c42d497839c3ae6365fe2 -#: ../src/Doc/howto/pyporting.rst:173 +#: howto/pyporting.rst:159 msgid "" -"It will not only get you used to typing ``print()`` as a function instead of " -"a statement, but it will also give you the various benefits the function has " -"over the Python 2 statement (six_ provides a function if you support Python " -"2.5 or older)." +"In Python 3, ``5 / 2 == 2.5`` and not ``2``; all division between ``int`` " +"values result in a ``float``. This change has actually been planned since " +"Python 2.2 which was released in 2002. Since then users have been encouraged " +"to add ``from __future__ import division`` to any and all files which use " +"the ``/`` and ``//`` operators or to be running the interpreter with the ``-" +"Q`` flag. If you have not been doing this then you will need to go through " +"your code and do two things:" msgstr "" -# 655bfeeac62a4176bc66faf79a729b4c -#: ../src/Doc/howto/pyporting.rst:180 -msgid "``from __future__ import unicode_literals``" +#: howto/pyporting.rst:167 +msgid "Add ``from __future__ import division`` to your files" msgstr "" -# e75ceeece51240beb2111386c53d52a0 -#: ../src/Doc/howto/pyporting.rst:182 +#: howto/pyporting.rst:168 msgid "" -"If you choose to use this future statement then all string literals in " -"Python 2 will be assumed to be Unicode (as is already the case in Python 3). " -"If you choose not to use this future statement then you should mark all of " -"your text strings with a ``u`` prefix and only support Python 3.3 or newer. " -"But you are **strongly** advised to do one or the other (six_ provides a " -"function in case you don't want to use the future statement **and** you want " -"to support Python 3.2 or older)." +"Update any division operator as necessary to either use ``//`` to use floor " +"division or continue using ``/`` and expect a float" msgstr "" -# 74a892ff88f3483bbcf3f580e9038c29 -#: ../src/Doc/howto/pyporting.rst:192 -msgid "Bytes/string literals" -msgstr "" - -# c58a4daad8c4424f942f4131e351c034 -#: ../src/Doc/howto/pyporting.rst:194 +#: howto/pyporting.rst:171 msgid "" -"This is a **very** important one. Prefix Python 2 strings that are meant to " -"contain bytes with a ``b`` prefix to very clearly delineate what is and is " -"not a Python 3 text string (six_ provides a function to use for Python 2.5 " -"compatibility)." +"The reason that ``/`` isn't simply translated to ``//`` automatically is " +"that if an object defines its own ``__div__`` method but not " +"``__floordiv__`` then your code would begin to fail." msgstr "" -# f5b8ec2c0c11493ea67b1ccc2991d340 -#: ../src/Doc/howto/pyporting.rst:199 +#: howto/pyporting.rst:176 +msgid "Text versus binary data" +msgstr "" + +#: howto/pyporting.rst:178 msgid "" -"This point cannot be stressed enough: make sure you know what all of your " -"string literals in Python 2 are meant to be in Python 3. Any string literal " -"that should be treated as bytes should have the ``b`` prefix. Any string " -"literal that should be Unicode/text in Python 2 should either have the ``u`` " -"literal (supported, but ignored, in Python 3.3 and later) or you should have " -"``from __future__ import unicode_literals`` at the top of the file. But the " -"key point is you should know how Python 3 will treat every one one of your " -"string literals and you should mark them as appropriate." +"In Python 2 you could use the ``str`` type for both text and binary data. " +"Unfortunately this confluence of two different concepts could lead to " +"brittle code which sometimes worked for either kind of data, sometimes not. " +"It also could lead to confusing APIs if people didn't explicitly state that " +"something that accepted ``str`` accepted either text or binary data instead " +"of one specific type. This complicated the situation especially for anyone " +"supporting multiple languages as APIs wouldn't bother explicitly supporting " +"``unicode`` when they claimed text data support." msgstr "" -# 94bbf631e2e7423bbad1b31e7b45b1d9 -#: ../src/Doc/howto/pyporting.rst:208 +#: howto/pyporting.rst:187 msgid "" -"There are some differences between byte literals in Python 2 and those in " -"Python 3 thanks to the bytes type just being an alias to ``str`` in Python " -"2. See the `Handle Common \"Gotchas\"`_ section for what to watch out for." +"To make the distinction between text and binary data clearer and more " +"pronounced, Python 3 did what most languages created in the age of the " +"internet have done and made text and binary data distinct types that cannot " +"blindly be mixed together (Python predates widespread access to the " +"internet). For any code that only deals with text or only binary data, this " +"separation doesn't pose an issue. But for code that has to deal with both, " +"it does mean you might have to now care about when you are using text " +"compared to binary data, which is why this cannot be entirely automated." msgstr "" -# 0ced37ed743b44f5817b10e2f7d93168 -#: ../src/Doc/howto/pyporting.rst:213 ../src/Doc/howto/pyporting.rst:226 -msgid "``from __future__ import absolute_import``" -msgstr "" - -# d796146776074d7e98730beb73fd4ba0 -#: ../src/Doc/howto/pyporting.rst:214 +#: howto/pyporting.rst:196 msgid "" -"Discussed in more detail below, but you should use this future statement to " -"prevent yourself from accidentally using implicit relative imports." +"To start, you will need to decide which APIs take text and which take binary " +"(it is **highly** recommended you don't design APIs that can take both due " +"to the difficulty of keeping the code working; as stated earlier it is " +"difficult to do well). In Python 2 this means making sure the APIs that take " +"text can work with ``unicode`` in Python 2 and those that work with binary " +"data work with the ``bytes`` type from Python 3 and thus a subset of ``str`` " +"in Python 2 (which the ``bytes`` type in Python 2 is an alias for). Usually " +"the biggest issue is realizing which methods exist for which types in Python " +"2 & 3 simultaneously (for text that's ``unicode`` in Python 2 and ``str`` in " +"Python 3, for binary that's ``str``/``bytes`` in Python 2 and ``bytes`` in " +"Python 3). The following table lists the **unique** methods of each data " +"type across Python 2 & 3 (e.g., the ``decode()`` method is usable on the " +"equivalent binary data type in either Python 2 or 3, but it can't be used by " +"the text data type consistently between Python 2 and 3 because ``str`` in " +"Python 3 doesn't have the method)." msgstr "" -# 79593443c762481eb192d92e23f3fdfd -#: ../src/Doc/howto/pyporting.rst:219 -msgid "Supporting Python 2.5 and Newer Only" +#: howto/pyporting.rst:212 +msgid "**Text data**" msgstr "" -# 51f5e59aa2194c7597a6e3da783612e4 -#: ../src/Doc/howto/pyporting.rst:221 +#: howto/pyporting.rst:212 +msgid "**Binary data**" +msgstr "" + +#: howto/pyporting.rst:214 +msgid "__mod__ (``%`` operator)" +msgstr "" + +#: howto/pyporting.rst:216 +msgid "\\" +msgstr "" + +#: howto/pyporting.rst:216 +msgid "decode" +msgstr "" + +#: howto/pyporting.rst:218 +msgid "encode" +msgstr "" + +#: howto/pyporting.rst:220 +msgid "format" +msgstr "" + +#: howto/pyporting.rst:222 +msgid "isdecimal" +msgstr "" + +#: howto/pyporting.rst:224 +msgid "isnumeric" +msgstr "" + +#: howto/pyporting.rst:227 msgid "" -"If you are supporting Python 2.5 and newer there are still some features of " -"Python that you can utilize." +"Making the distinction easier to handle can be accomplished by encoding and " +"decoding between binary data and text at the edge of your code. This means " +"that when you receive text in binary data, you should immediately decode it. " +"And if your code needs to send text as binary data then encode it as late as " +"possible. This allows your code to work with only text internally and thus " +"eliminates having to keep track of what type of data you are working with." msgstr "" -# 0dc36d774cc5479490e53c76800eb360 -#: ../src/Doc/howto/pyporting.rst:228 +#: howto/pyporting.rst:234 msgid "" -"Implicit relative imports (e.g., importing ``spam.bacon`` from within ``spam." -"eggs`` with the statement ``import bacon``) do not work in Python 3. This " -"future statement moves away from that and allows the use of explicit " -"relative imports (e.g., ``from . import bacon``)." +"The next issue is making sure you know whether the string literals in your " +"code represent text or binary data. At minimum you should add a ``b`` prefix " +"to any literal that presents binary data. For text you should either use the " +"``from __future__ import unicode_literals`` statement or add a ``u`` prefix " +"to the text literal." msgstr "" -# b3304c22b27b4d119b67447aedc3f60c -#: ../src/Doc/howto/pyporting.rst:233 -msgid "" -"In Python 2.5 you must use the __future__ statement to get to use explicit " -"relative imports and prevent implicit ones. In Python 2.6 explicit relative " -"imports are available without the statement, but you still want the " -"__future__ statement to prevent implicit relative imports. In Python 2.7 the " -"__future__ statement is not needed. In other words, unless you are only " -"supporting Python 2.7 or a version earlier than Python 2.5, use this " -"__future__ statement." -msgstr "" - -# 8974b6ce3fad41d2ab1b6b57db2feb86 -#: ../src/Doc/howto/pyporting.rst:243 -msgid "Mark all Unicode strings with a ``u`` prefix" -msgstr "" - -# 05431ce1a29d4c67b174c103cecca755 -#: ../src/Doc/howto/pyporting.rst:245 -msgid "" -"While Python 2.6 has a ``__future__`` statement to automatically cause " -"Python 2 to treat all string literals as Unicode, Python 2.5 does not have " -"that shortcut. This means you should go through and mark all string literals " -"with a ``u`` prefix to turn them explicitly into text strings where " -"appropriate and only support Python 3.3 or newer. Otherwise use a project " -"like six_ which provides a function to pass all text string literals through." -msgstr "" - -# 32a99b7cbf164be4ad3367e48a71cd4b -#: ../src/Doc/howto/pyporting.rst:254 -msgid "Capturing the Currently Raised Exception" -msgstr "" - -# 6ffae18c38384a09ab36f80f1be22f37 -#: ../src/Doc/howto/pyporting.rst:256 -msgid "" -"In Python 2.5 and earlier the syntax to access the current exception is::" -msgstr "" - -# 4ea5928ecf4b48fd9a76a7518a445cb3 -#: ../src/Doc/howto/pyporting.rst:264 -msgid "" -"This syntax changed in Python 3 (and backported to Python 2.6 and later) to::" -msgstr "" - -# 6ffae18c38384a09ab36f80f1be22f37 -#: ../src/Doc/howto/pyporting.rst:274 -msgid "" -"Because of this syntax change you must change how you capture the current " -"exception in Python 2.5 and earlier to::" -msgstr "" - -# 9135a918d99846b6b2f07acb4481dfe2 -#: ../src/Doc/howto/pyporting.rst:285 -msgid "" -"You can get more information about the raised exception from :func:`sys." -"exc_info` than simply the current exception instance, but you most likely " -"don't need it." -msgstr "" - -# 8808a5e91dc24b4e941fb94ce386d32a -#: ../src/Doc/howto/pyporting.rst:290 -msgid "" -"In Python 3, the traceback is attached to the exception instance through the " -"``__traceback__`` attribute. If the instance is saved in a local variable " -"that persists outside of the ``except`` block, the traceback will create a " -"reference cycle with the current frame and its dictionary of local " -"variables. This will delay reclaiming dead resources until the next cyclic :" -"term:`garbage collection` pass." -msgstr "" - -# d4505a6c83924f2989209021f7aaa4fe -#: ../src/Doc/howto/pyporting.rst:297 -msgid "" -"In Python 2, this problem only occurs if you save the traceback itself (e.g. " -"the third element of the tuple returned by :func:`sys.exc_info`) in a " -"variable." -msgstr "" - -# 4cd3379c765e492f8d8250e3e9f903a3 -#: ../src/Doc/howto/pyporting.rst:303 -msgid "Handle Common \"Gotchas\"" -msgstr "" - -# f53c6990a50b4eebb1d40264e83fe9c7 -#: ../src/Doc/howto/pyporting.rst:305 -msgid "" -"These are things to watch out for no matter what version of Python 2 you are " -"supporting which are not syntactic considerations." -msgstr "" - -# ab3034ec5e5e4661aa6de68ce95d5078 -#: ../src/Doc/howto/pyporting.rst:310 -msgid "``from __future__ import division``" -msgstr "" - -# df60a68b4f7f40b6b7f104d17e5580c7 -#: ../src/Doc/howto/pyporting.rst:312 -msgid "" -"While the exact same outcome can be had by using the ``-Qnew`` argument to " -"Python, using this future statement lifts the requirement that your users " -"use the flag to get the expected behavior of division in Python 3 (e.g., " -"``1/2 == 0.5; 1//2 == 0``)." -msgstr "" - -# e46aa5d4215a4df48231102107237eca -#: ../src/Doc/howto/pyporting.rst:320 -msgid "Specify when opening a file as binary" -msgstr "" - -# 4f4aa2633f3f4b6aad2be8d04871966e -#: ../src/Doc/howto/pyporting.rst:322 +#: howto/pyporting.rst:240 msgid "" +"As part of this dichotomy you also need to be careful about opening files. " "Unless you have been working on Windows, there is a chance you have not " "always bothered to add the ``b`` mode when opening a binary file (e.g., " "``rb`` for binary reading). Under Python 3, binary files and text files are " "clearly distinct and mutually incompatible; see the :mod:`io` module for " "details. Therefore, you **must** make a decision of whether a file will be " -"used for binary access (allowing to read and/or write bytes data) or text " -"access (allowing to read and/or write unicode data)." +"used for binary access (allowing to read and/or write binary data) or text " +"access (allowing to read and/or write text data). You should also use :func:" +"`io.open` for opening files instead of the built-in :func:`open` function as " +"the :mod:`io` module is consistent from Python 2 to 3 while the built-in :" +"func:`open` function is not (in Python 3 it's actually :func:`io.open`)." msgstr "" -# b9a34cc2e1e046f6b406152ab3d19b72 -#: ../src/Doc/howto/pyporting.rst:331 -msgid "Text files" -msgstr "" - -# e6361ba1d9af424e8db34faac2b9d9c9 -#: ../src/Doc/howto/pyporting.rst:333 +#: howto/pyporting.rst:252 msgid "" -"Text files created using ``open()`` under Python 2 return byte strings, " -"while under Python 3 they return unicode strings. Depending on your porting " -"strategy, this can be an issue." +"The constructors of both ``str`` and ``bytes`` have different semantics for " +"the same arguments between Python 2 & 3. Passing an integer to ``bytes`` in " +"Python 2 will give you the string representation of the integer: ``bytes(3) " +"== '3'``. But in Python 3, an integer argument to ``bytes`` will give you a " +"bytes object as long as the integer specified, filled with null bytes: " +"``bytes(3) == b'\\x00\\x00\\x00'``. A similar worry is necessary when " +"passing a bytes object to ``str``. In Python 2 you just get the bytes object " +"back: ``str(b'3') == b'3'``. But in Python 3 you get the string " +"representation of the bytes object: ``str(b'3') == \"b'3'\"``." msgstr "" -# b34c508e7d0442749c5e4a8b88d1fb75 -#: ../src/Doc/howto/pyporting.rst:337 +#: howto/pyporting.rst:262 msgid "" -"If you want text files to return unicode strings in Python 2, you have two " -"possibilities:" +"Finally, the indexing of binary data requires careful handling (slicing does " +"**not** require any special handling). In Python 2, ``b'123'[1] == b'2'`` " +"while in Python 3 ``b'123'[1] == 50``. Because binary data is simply a " +"collection of binary numbers, Python 3 returns the integer value for the " +"byte you index on. But in Python 2 because ``bytes == str``, indexing " +"returns a one-item slice of bytes. The six_ project has a function named " +"``six.indexbytes()`` which will return an integer like in Python 3: ``six." +"indexbytes(b'123', 1)``." msgstr "" -# fcf0d560b43f481daa22ceda2edd9d35 -#: ../src/Doc/howto/pyporting.rst:340 +#: howto/pyporting.rst:271 +msgid "To summarize:" +msgstr "" + +#: howto/pyporting.rst:273 +msgid "Decide which of your APIs take text and which take binary data" +msgstr "" + +#: howto/pyporting.rst:274 msgid "" -"Under Python 2.6 and higher, use :func:`io.open`. Since :func:`io.open` is " -"essentially the same function in both Python 2 and Python 3, it will help " -"iron out any issues that might arise." +"Make sure that your code that works with text also works with ``unicode`` " +"and code for binary data works with ``bytes`` in Python 2 (see the table " +"above for what methods you cannot use for each type)" msgstr "" -# 97c9151f55c44cc581dec6e8f5f66307 -#: ../src/Doc/howto/pyporting.rst:344 +#: howto/pyporting.rst:277 msgid "" -"If pre-2.6 compatibility is needed, then you should use :func:`codecs.open` " -"instead. This will make sure that you get back unicode strings in Python 2." +"Mark all binary literals with a ``b`` prefix, use a ``u`` prefix or :mod:" +"`__future__` import statement for text literals" msgstr "" -# 67ef437384224cfd950b9e37f12550f9 -#: ../src/Doc/howto/pyporting.rst:348 -msgid "Subclass ``object``" -msgstr "" - -# fb4d1cff09334961b99df7bfb1560b12 -#: ../src/Doc/howto/pyporting.rst:350 +#: howto/pyporting.rst:279 msgid "" -"New-style classes have been around since Python 2.2. You need to make sure " -"you are subclassing from ``object`` to avoid odd edge cases involving method " -"resolution order, etc. This continues to be totally valid in Python 3 " -"(although unneeded as all classes implicitly inherit from ``object``)." +"Decode binary data to text as soon as possible, encode text as binary data " +"as late as possible" msgstr "" -# 13de8b799eb24005bd09daddfa10bbc9 -#: ../src/Doc/howto/pyporting.rst:357 -msgid "Deal With the Bytes/String Dichotomy" -msgstr "" - -# 191015c1e13e4492b79d44cfb05f2ea9 -#: ../src/Doc/howto/pyporting.rst:359 +#: howto/pyporting.rst:281 msgid "" -"One of the biggest issues people have when porting code to Python 3 is " -"handling the bytes/string dichotomy. Because Python 2 allowed the ``str`` " -"type to hold textual data, people have over the years been rather loose in " -"their delineation of what ``str`` instances held text compared to bytes. In " -"Python 3 you cannot be so care-free anymore and need to properly handle the " -"difference. The key to handling this issue is to make sure that **every** " -"string literal in your Python 2 code is either syntactically or functionally " -"marked as either bytes or text data. After this is done you then need to " -"make sure your APIs are designed to either handle a specific type or made to " -"be properly polymorphic." +"Open files using :func:`io.open` and make sure to specify the ``b`` mode " +"when appropriate" msgstr "" -# 33a55a2846b649d0a5d4ba31885156c1 -#: ../src/Doc/howto/pyporting.rst:371 -msgid "Mark Up Python 2 String Literals" +#: howto/pyporting.rst:283 +msgid "Be careful when indexing binary data" msgstr "" -# 99d1b07e9b704affb160beb8889d7536 -#: ../src/Doc/howto/pyporting.rst:373 +#: howto/pyporting.rst:286 +msgid "Prevent compatibility regressions" +msgstr "" + +#: howto/pyporting.rst:288 msgid "" -"First thing you must do is designate every single string literal in Python 2 " -"as either textual or bytes data. If you are only supporting Python 2.6 or " -"newer, this can be accomplished by marking bytes literals with a ``b`` " -"prefix and then designating textual data with a ``u`` prefix or using the " -"``unicode_literals`` future statement." +"Once you have fully translated your code to be compatible with Python 3, you " +"will want to make sure your code doesn't regress and stop working under " +"Python 3. This is especially true if you have a dependency which is blocking " +"you from actually running under Python 3 at the moment." msgstr "" -# 942e68067a7248a197ebb9316b94751c -#: ../src/Doc/howto/pyporting.rst:379 +#: howto/pyporting.rst:293 msgid "" -"If your project supports versions of Python predating 2.6, then you should " -"use the six_ project and its ``b()`` function to denote bytes literals. For " -"text literals you can either use six's ``u()`` function or use a ``u`` " -"prefix." +"To help with staying compatible, any new modules you create should have at " +"least the following block of code at the top of it::" msgstr "" -# 210012be5cb54681b011ae64027b2287 -#: ../src/Doc/howto/pyporting.rst:385 -msgid "Decide what APIs Will Accept" -msgstr "" - -# 994241dfdfcf40848a5e9da2800ca105 -#: ../src/Doc/howto/pyporting.rst:387 +#: howto/pyporting.rst:301 msgid "" -"In Python 2 it was very easy to accidentally create an API that accepted " -"both bytes and textual data. But in Python 3, thanks to the more strict " -"handling of disparate types, this loose usage of bytes and text together " -"tends to fail." +"You can also run Python 2 with the ``-3`` flag to be warned about various " +"compatibility issues your code triggers during execution. If you turn " +"warnings into errors with ``-Werror`` then you can make sure that you don't " +"accidentally miss a warning." msgstr "" -# 7f4384ba7a6d4c618c062ec6194867fd -#: ../src/Doc/howto/pyporting.rst:391 +#: howto/pyporting.rst:307 msgid "" -"Take the dict ``{b'a': 'bytes', u'a': 'text'}`` in Python 2.6. It creates " -"the dict ``{u'a': 'text'}`` since ``b'a' == u'a'``. But in Python 3 the " -"equivalent dict creates ``{b'a': 'bytes', 'a': 'text'}``, i.e., no lost " -"data. Similar issues can crop up when transitioning Python 2 code to Python " -"3." +"You can also use the Pylint_ project and its ``--py3k`` flag to lint your " +"code to receive warnings when your code begins to deviate from Python 3 " +"compatibility. This also prevents you from having to run Modernize_ or " +"Futurize_ over your code regularly to catch compatibility regressions. This " +"does require you only support Python 2.7 and Python 3.4 or newer as that is " +"Pylint's minimum Python version support." msgstr "" -# af331f899ccf451db1b01b2a83b5b6f1 -#: ../src/Doc/howto/pyporting.rst:396 +#: howto/pyporting.rst:316 +msgid "Check which dependencies block your transition" +msgstr "" + +#: howto/pyporting.rst:318 msgid "" -"This means you need to choose what an API is going to accept and create and " -"consistently stick to that API in both Python 2 and 3." +"**After** you have made your code compatible with Python 3 you should begin " +"to care about whether your dependencies have also been ported. The " +"caniusepython3_ project was created to help you determine which projects -- " +"directly or indirectly -- are blocking you from supporting Python 3. There " +"is both a command-line tool as well as a web interface at https://" +"caniusepython3.com ." msgstr "" -# 0d339def3215422fa9f8c0ff8e20da62 -#: ../src/Doc/howto/pyporting.rst:401 -msgid "Bytes / Unicode Comparison" -msgstr "" - -# af8b53a10767414ea892732f5d7e394f -#: ../src/Doc/howto/pyporting.rst:403 +#: howto/pyporting.rst:325 msgid "" -"In Python 3, mixing bytes and unicode is forbidden in most situations; it " -"will raise a :class:`TypeError` where Python 2 would have attempted an " -"implicit coercion between types. However, there is one case where it " -"doesn't and it can be very misleading::" +"The project also provides code which you can integrate into your test suite " +"so that you will have a failing test when you no longer have dependencies " +"blocking you from using Python 3. This allows you to avoid having to " +"manually check your dependencies and to be notified quickly when you can " +"start running on Python 3." msgstr "" -# f4117ff439c74fd4805675c5f516e1ae -#: ../src/Doc/howto/pyporting.rst:411 +#: howto/pyporting.rst:331 +msgid "Update your ``setup.py`` file to denote Python 3 compatibility" +msgstr "" + +#: howto/pyporting.rst:333 msgid "" -"This is because an equality comparison is required by the language to always " -"succeed (and return ``False`` for incompatible types). However, this also " -"means that code incorrectly ported to Python 3 can display buggy behaviour " -"if such comparisons are silently executed. To detect such situations, " -"Python 3 has a ``-b`` flag that will display a warning::" +"Once your code works under Python 3, you should update the classifiers in " +"your ``setup.py`` to contain ``Programming Language :: Python :: 3`` and to " +"not specify sole Python 2 support. This will tell anyone using your code " +"that you support Python 2 **and** 3. Ideally you will also want to add " +"classifiers for each major/minor version of Python you now support." msgstr "" -# 7dd10ede04f64754ac4bc90ca6e1e864 -#: ../src/Doc/howto/pyporting.rst:422 -msgid "To turn the warning into an exception, use the ``-bb`` flag instead::" +#: howto/pyporting.rst:341 +msgid "Use continuous integration to stay compatible" msgstr "" -# cbfbb174ee164217935dc50ca49a64d5 -#: ../src/Doc/howto/pyporting.rst:432 -msgid "Indexing bytes objects" -msgstr "" - -# 073990d932f441d4ad77df12577cff82 -#: ../src/Doc/howto/pyporting.rst:434 +#: howto/pyporting.rst:343 msgid "" -"Another potentially surprising change is the indexing behaviour of bytes " -"objects in Python 3::" +"Once you are able to fully run under Python 3 you will want to make sure " +"your code always works under both Python 2 & 3. Probably the best tool for " +"running your tests under multiple Python interpreters is tox_. You can then " +"integrate tox with your continuous integration system so that you never " +"accidentally break Python 2 or 3 support." msgstr "" -# ab390883aefd413e87f5a68abfbbbe38 -#: ../src/Doc/howto/pyporting.rst:440 +#: howto/pyporting.rst:349 msgid "" -"Indeed, Python 3 bytes objects (as well as :class:`bytearray` objects) are " -"sequences of integers. But code converted from Python 2 will often assume " -"that indexing a bytestring produces another bytestring, not an integer. To " -"reconcile both behaviours, use slicing::" +"You may also want to use use the ``-bb`` flag with the Python 3 interpreter " +"to trigger an exception when you are comparing bytes to strings. Usually " +"it's simply ``False``, but if you made a mistake in your separation of text/" +"binary data handling you may be accidentally comparing text and binary data. " +"This flag will raise an exception when that occurs to help track down such " +"cases." msgstr "" -# 44b2eb374c5a4a82a8ba4bbf3cbe4d9a -#: ../src/Doc/howto/pyporting.rst:451 +#: howto/pyporting.rst:355 msgid "" -"The only remaining gotcha is that an out-of-bounds slice returns an empty " -"bytes object instead of raising ``IndexError``:" +"And that's mostly it! At this point your code base is compatible with both " +"Python 2 and 3 simultaneously. Your testing will also be set up so that you " +"don't accidentally break Python 2 or 3 compatibility regardless of which " +"version you typically run your tests under while developing." msgstr "" -# aaa226ca491249469d358a77d231d0ae -#: ../src/Doc/howto/pyporting.rst:463 -msgid "``__str__()``/``__unicode__()``" +#: howto/pyporting.rst:362 +msgid "Dropping Python 2 support completely" msgstr "" -# c9111443666d4689975684fdc8cdd9e4 -#: ../src/Doc/howto/pyporting.rst:465 +#: howto/pyporting.rst:364 msgid "" -"In Python 2, objects can specify both a string and unicode representation of " -"themselves. In Python 3, though, there is only a string representation. This " -"becomes an issue as people can inadvertently do things in their " -"``__str__()`` methods which have unpredictable results (e.g., infinite " -"recursion if you happen to use the ``unicode(self).encode('utf8')`` idiom as " -"the body of your ``__str__()`` method)." +"If you are able to fully drop support for Python 2, then the steps required " +"to transition to Python 3 simplify greatly." msgstr "" -# d16d61b49c8841f4934c8ece3fc7b2c6 -#: ../src/Doc/howto/pyporting.rst:472 +#: howto/pyporting.rst:367 +msgid "Update your code to only support Python 2.7" +msgstr "" + +#: howto/pyporting.rst:368 +msgid "Make sure you have good test coverage (coverage.py_ can help)" +msgstr "" + +#: howto/pyporting.rst:370 +msgid "Use 2to3_ to rewrite your code to run only under Python 3" +msgstr "" + +#: howto/pyporting.rst:372 msgid "" -"You can use a mixin class to work around this. This allows you to only " -"define a ``__unicode__()`` method for your class and let the mixin derive " -"``__str__()`` for you (code from http://lucumr.pocoo.org/2011/1/22/forwards-" -"compatible-python/)::" +"After this your code will be fully Python 3 compliant but in a way that is " +"not supported by Python 2. You should also update the classifiers in your " +"``setup.py`` to contain ``Programming Language :: Python :: 3 :: Only``." msgstr "" -# c3ac65b738b748fe8c0e5213bda611e8 -#: ../src/Doc/howto/pyporting.rst:499 -msgid "Don't Index on Exceptions" -msgstr "" - -# 2c607128d18c42958bf810f4e4a5c972 -#: ../src/Doc/howto/pyporting.rst:501 -msgid "In Python 2, the following worked::" -msgstr "" - -# faa974825eb34be3bb9b4ed2d0bd2bef -#: ../src/Doc/howto/pyporting.rst:509 -msgid "" -"But in Python 3, indexing directly on an exception is an error. You need to " -"make sure to only index on the :attr:`BaseException.args` attribute which is " -"a sequence containing all arguments passed to the :meth:`__init__` method." -msgstr "" - -# 9adee86971bc42bbb34c2f8e72ed6648 -#: ../src/Doc/howto/pyporting.rst:513 -msgid "Even better is to use the documented attributes the exception provides." -msgstr "" - -# 5702d4995aa743f2a385918b5e8e4272 -#: ../src/Doc/howto/pyporting.rst:517 -msgid "Don't use ``__getslice__`` & Friends" -msgstr "" - -# 627edb2d8eea4c0bac4d069d06a4e91b -#: ../src/Doc/howto/pyporting.rst:519 -msgid "" -"Been deprecated for a while, but Python 3 finally drops support for " -"``__getslice__()``, etc. Move completely over to :meth:`__getitem__` and " -"friends." -msgstr "" - -# 450a06164a3444c9bf70aabcbd3e858b -#: ../src/Doc/howto/pyporting.rst:525 -msgid "Updating doctests" -msgstr "" - -# 615328515a964a6cb279596b93b8f86d -#: ../src/Doc/howto/pyporting.rst:527 -msgid "" -"Don't forget to make them Python 2/3 compatible as well. If you wrote a " -"monolithic set of doctests (e.g., a single docstring containing all of your " -"doctests), you should at least consider breaking the doctests up into " -"smaller pieces to make it more manageable to fix. Otherwise it might very " -"well be worth your time and effort to port your tests to :mod:`unittest`." -msgstr "" - -# 9499659a065a4586a941a8e82d2bd6e6 -#: ../src/Doc/howto/pyporting.rst:535 -msgid "Update ``map`` for imbalanced input sequences" -msgstr "" - -# 3bd8bf9c76a04ac9a52a38e3d4ccf522 -#: ../src/Doc/howto/pyporting.rst:537 -msgid "" -"With Python 2, when ``map`` was given more than one input sequence it would " -"pad the shorter sequences with ``None`` values, returning a sequence as long " -"as the longest input sequence." -msgstr "" - -# 670b1756521f4df18011f44916cb36fb -#: ../src/Doc/howto/pyporting.rst:541 -msgid "" -"With Python 3, if the input sequences to ``map`` are of unequal length, " -"``map`` will stop at the termination of the shortest of the sequences. For " -"full compatibility with ``map`` from Python 2.x, wrap the sequence arguments " -"in :func:`itertools.zip_longest`, e.g. ``map(func, *sequences)`` becomes " -"``list(map(func, itertools.zip_longest(*sequences)))``." -msgstr "" - -# b7ad2dfc09b946febf0368a4396b6e9e -#: ../src/Doc/howto/pyporting.rst:548 -msgid "Eliminate ``-3`` Warnings" -msgstr "" - -# e582ca87c66549e9b12b2ddd4c770c3d -#: ../src/Doc/howto/pyporting.rst:550 -msgid "" -"When you run your application's test suite, run it using the ``-3`` flag " -"passed to Python. This will cause various warnings to be raised during " -"execution about things that are semantic changes between Python 2 and 3. Try " -"to eliminate those warnings to make your code even more portable to Python 3." -msgstr "" - -# d09b14bd9c8b44958479a0bb9f05edca -#: ../src/Doc/howto/pyporting.rst:557 -msgid "Alternative Approaches" -msgstr "" - -# dc892403cd044103ae82edb543c6a460 -#: ../src/Doc/howto/pyporting.rst:559 -msgid "" -"While supporting Python 2 & 3 simultaneously is typically the preferred " -"choice by people so that they can continue to improve code and have it work " -"for the most number of users, your life may be easier if you only have to " -"support one major version of Python going forward." -msgstr "" - -# 0d0556a0631c48be938d2d8c2c9cc1df -#: ../src/Doc/howto/pyporting.rst:565 -msgid "Supporting Only Python 3 Going Forward From Python 2 Code" -msgstr "" - -# 6d6fec7e753d4057b96c5a3d6d4178a9 -#: ../src/Doc/howto/pyporting.rst:567 -msgid "" -"If you have Python 2 code but going forward only want to improve it as " -"Python 3 code, then you can use 2to3_ to translate your Python 2 code to " -"Python 3 code. This is only recommended, though, if your current version of " -"your project is going into maintenance mode and you want all new features to " -"be exclusive to Python 3." -msgstr "" - -# a1a6ce0d6c02428eb912de02e38671d2 -#: ../src/Doc/howto/pyporting.rst:575 -msgid "Backporting Python 3 code to Python 2" -msgstr "" - -# 53d0bbf2f18e405093b1768fe6759141 -#: ../src/Doc/howto/pyporting.rst:577 -msgid "" -"If you have Python 3 code and have little interest in supporting Python 2 " -"you can use 3to2_ to translate from Python 3 code to Python 2 code. This is " -"only recommended if you don't plan to heavily support Python 2 users. " -"Otherwise write your code for Python 3 and then backport as far back as you " -"want. This is typically easier than going from Python 2 to 3 as you will " -"have worked out any difficulties with e.g. bytes/strings, etc." -msgstr "" - -# 4cceebf107a046e2850ba987f30e3b95 -#: ../src/Doc/howto/pyporting.rst:586 -#, fuzzy -msgid "Other Resources" -msgstr "Autres ressources" - -# 6655928ffc2e4042a658bb55194bf3a0 -#: ../src/Doc/howto/pyporting.rst:588 -msgid "" -"The authors of the following blog posts, wiki pages, and books deserve " -"special thanks for making public their tips for porting Python 2 code to " -"Python 3 (and thus helping provide information for this document and its " -"various revisions over the years):" -msgstr "" - -# 9db73da4a9584ab2981fa6d70077380b -#: ../src/Doc/howto/pyporting.rst:593 -msgid "https://wiki.python.org/moin/PortingPythonToPy3k" -msgstr "" - -# 2ac7fa2afb1243a8b7cb24b692af8bbf -#: ../src/Doc/howto/pyporting.rst:594 -msgid "http://python3porting.com/" -msgstr "" - -# fa3f5ab95f6340099a39df758243df01 -#: ../src/Doc/howto/pyporting.rst:595 -msgid "http://docs.pythonsprints.com/python3_porting/py-porting.html" -msgstr "" - -# 7398b09a284d4dd983d7b2114154be6a -#: ../src/Doc/howto/pyporting.rst:596 -msgid "" -"http://techspot.zzzeek.org/2011/01/24/zzzeek-s-guide-to-python-3-porting/" -msgstr "" - -# ea7e371504e541e2b1514f85d1cb0fa1 -#: ../src/Doc/howto/pyporting.rst:597 -msgid "" -"http://dabeaz.blogspot.com/2011/01/porting-py65-and-my-superboard-to.html" -msgstr "" - -# 3e267d8b581943ada40d1a90d620285a -#: ../src/Doc/howto/pyporting.rst:598 -msgid "http://lucumr.pocoo.org/2011/1/22/forwards-compatible-python/" -msgstr "" - -# 15e7c37ed1ae499b9ccdc23e45de02d3 -#: ../src/Doc/howto/pyporting.rst:599 -msgid "http://lucumr.pocoo.org/2010/2/11/porting-to-python-3-a-guide/" -msgstr "" - -# 16f120124a3f4b0db197cf510f10c05b -#: ../src/Doc/howto/pyporting.rst:600 -msgid "https://wiki.ubuntu.com/Python/3" -msgstr "" - -# 7cbcdce375074e9f8895d6fb39c1dbbf -#: ../src/Doc/howto/pyporting.rst:602 -msgid "" -"If you feel there is something missing from this document that should be " -"added, please email the python-porting_ mailing list." -msgstr "" - -#: ../src/Doc/howto/regex.rst:5 +#: howto/regex.rst:5 msgid "Regular Expression HOWTO" msgstr "" -#: ../src/Doc/howto/regex.rst:7 +#: howto/regex.rst:7 msgid "A.M. Kuchling " msgstr "" -#: ../src/Doc/howto/regex.rst:18 +#: howto/regex.rst:18 msgid "" "This document is an introductory tutorial to using regular expressions in " "Python with the :mod:`re` module. It provides a gentler introduction than " "the corresponding section in the Library Reference." msgstr "" -#: ../src/Doc/howto/regex.rst:26 +#: howto/regex.rst:26 msgid "" "The :mod:`re` module was added in Python 1.5, and provides Perl-style " "regular expression patterns. Earlier versions of Python came with the :mod:" @@ -6757,7 +6585,7 @@ msgid "" "module was removed completely in Python 2.5." msgstr "" -#: ../src/Doc/howto/regex.rst:31 +#: howto/regex.rst:31 msgid "" "Regular expressions (called REs, or regexes, or regex patterns) are " "essentially a tiny, highly specialized programming language embedded inside " @@ -6770,7 +6598,7 @@ msgid "" "modify a string or to split it apart in various ways." msgstr "" -#: ../src/Doc/howto/regex.rst:40 +#: howto/regex.rst:40 msgid "" "Regular expression patterns are compiled into a series of bytecodes which " "are then executed by a matching engine written in C. For advanced use, it " @@ -6781,7 +6609,7 @@ msgid "" "internals." msgstr "" -#: ../src/Doc/howto/regex.rst:47 +#: howto/regex.rst:47 msgid "" "The regular expression language is relatively small and restricted, so not " "all possible string processing tasks can be done using regular expressions. " @@ -6792,29 +6620,29 @@ msgid "" "more understandable." msgstr "" -#: ../src/Doc/howto/regex.rst:56 +#: howto/regex.rst:56 msgid "Simple Patterns" msgstr "" -#: ../src/Doc/howto/regex.rst:58 +#: howto/regex.rst:58 msgid "" "We'll start by learning about the simplest possible regular expressions. " "Since regular expressions are used to operate on strings, we'll begin with " "the most common task: matching characters." msgstr "" -#: ../src/Doc/howto/regex.rst:62 +#: howto/regex.rst:62 msgid "" "For a detailed explanation of the computer science underlying regular " "expressions (deterministic and non-deterministic finite automata), you can " "refer to almost any textbook on writing compilers." msgstr "" -#: ../src/Doc/howto/regex.rst:68 +#: howto/regex.rst:68 msgid "Matching Characters" msgstr "" -#: ../src/Doc/howto/regex.rst:70 +#: howto/regex.rst:70 msgid "" "Most letters and characters will simply match themselves. For example, the " "regular expression ``test`` will match the string ``test`` exactly. (You " @@ -6822,7 +6650,7 @@ msgid "" "``TEST`` as well; more about this later.)" msgstr "" -#: ../src/Doc/howto/regex.rst:75 +#: howto/regex.rst:75 msgid "" "There are exceptions to this rule; some characters are special :dfn:" "`metacharacters`, and don't match themselves. Instead, they signal that " @@ -6832,13 +6660,13 @@ msgid "" "do." msgstr "" -#: ../src/Doc/howto/regex.rst:81 +#: howto/regex.rst:81 msgid "" "Here's a complete list of the metacharacters; their meanings will be " "discussed in the rest of this HOWTO. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:86 +#: howto/regex.rst:86 msgid "" "The first metacharacters we'll look at are ``[`` and ``]``. They're used for " "specifying a character class, which is a set of characters that you wish to " @@ -6850,7 +6678,7 @@ msgid "" "``[a-z]``." msgstr "" -#: ../src/Doc/howto/regex.rst:95 +#: howto/regex.rst:95 msgid "" "Metacharacters are not active inside classes. For example, ``[akm$]`` will " "match any of the characters ``'a'``, ``'k'``, ``'m'``, or ``'$'``; ``'$'`` " @@ -6858,7 +6686,7 @@ msgid "" "its special nature." msgstr "" -#: ../src/Doc/howto/regex.rst:100 +#: howto/regex.rst:100 msgid "" "You can match the characters not listed within the class by :dfn:" "`complementing` the set. This is indicated by including a ``'^'`` as the " @@ -6867,7 +6695,7 @@ msgid "" "except ``'5'``." msgstr "" -#: ../src/Doc/howto/regex.rst:105 +#: howto/regex.rst:105 msgid "" "Perhaps the most important metacharacter is the backslash, ``\\``. As in " "Python string literals, the backslash can be followed by various characters " @@ -6878,7 +6706,7 @@ msgid "" msgstr "" # f2e1f4c7319f45fa975e980cf3295fa7 -#: ../src/Doc/howto/regex.rst:112 +#: howto/regex.rst:112 msgid "" "Some of the special sequences beginning with ``'\\'`` represent predefined " "sets of characters that are often useful, such as the set of digits, the set " @@ -6889,77 +6717,71 @@ msgid "" "of :ref:`Regular Expression Syntax `." msgstr "" -# 5c1e2667294f4772aad7eca567461998 -#: ../src/Doc/howto/regex.rst:120 -msgid "``\\d``" +#: howto/regex.rst:121 +msgid "\\d" msgstr "" -#: ../src/Doc/howto/regex.rst:121 +#: howto/regex.rst:121 msgid "Matches any decimal digit; this is equivalent to the class ``[0-9]``." msgstr "" -# 3279bdfdd76d45dcbf3f0cb72dfd2559 -#: ../src/Doc/howto/regex.rst:123 -msgid "``\\D``" +#: howto/regex.rst:124 +msgid "\\D" msgstr "" -#: ../src/Doc/howto/regex.rst:124 +#: howto/regex.rst:124 msgid "" "Matches any non-digit character; this is equivalent to the class ``[^0-9]``." msgstr "" -# 452c0eb3f4624ff5a54602cf5d843274 -#: ../src/Doc/howto/regex.rst:127 -msgid "``\\s``" +#: howto/regex.rst:128 +msgid "\\s" msgstr "" -#: ../src/Doc/howto/regex.rst:127 +#: howto/regex.rst:127 msgid "" "Matches any whitespace character; this is equivalent to the class ``[ \\t\\n" "\\r\\f\\v]``." msgstr "" -# fa8217a70bdd491f895d3415da38c6b0 -#: ../src/Doc/howto/regex.rst:131 -msgid "``\\S``" +#: howto/regex.rst:132 +msgid "\\S" msgstr "" -#: ../src/Doc/howto/regex.rst:131 +#: howto/regex.rst:131 msgid "" "Matches any non-whitespace character; this is equivalent to the class ``[^ " "\\t\\n\\r\\f\\v]``." msgstr "" -# 7e91aa755b5842cc816e4183fcdd929e -#: ../src/Doc/howto/regex.rst:135 -msgid "``\\w``" +#: howto/regex.rst:136 +msgid "\\w" msgstr "" -#: ../src/Doc/howto/regex.rst:135 +#: howto/regex.rst:135 msgid "" "Matches any alphanumeric character; this is equivalent to the class ``[a-zA-" "Z0-9_]``." msgstr "" -# c7c443df2084432f9938aaaf39f93f88 -#: ../src/Doc/howto/regex.rst:139 -msgid "``\\W``" +#: howto/regex.rst:140 +msgid "\\W" msgstr "" -#: ../src/Doc/howto/regex.rst:139 +#: howto/regex.rst:139 msgid "" "Matches any non-alphanumeric character; this is equivalent to the class " "``[^a-zA-Z0-9_]``." msgstr "" -#: ../src/Doc/howto/regex.rst:142 +#: howto/regex.rst:142 msgid "" "These sequences can be included inside a character class. For example, " "``[\\s,.]`` is a character class that will match any whitespace character, " "or ``','`` or ``'.'``." msgstr "" -#: ../src/Doc/howto/regex.rst:146 +#: howto/regex.rst:146 msgid "" "The final metacharacter in this section is ``.``. It matches anything " "except a newline character, and there's an alternate mode (``re.DOTALL``) " @@ -6967,11 +6789,11 @@ msgid "" "match \"any character\"." msgstr "" -#: ../src/Doc/howto/regex.rst:153 +#: howto/regex.rst:153 msgid "Repeating Things" msgstr "" -#: ../src/Doc/howto/regex.rst:155 +#: howto/regex.rst:155 msgid "" "Being able to match varying sets of characters is the first thing regular " "expressions can do that isn't already possible with the methods available on " @@ -6980,7 +6802,7 @@ msgid "" "specify that portions of the RE must be repeated a certain number of times." msgstr "" -#: ../src/Doc/howto/regex.rst:161 +#: howto/regex.rst:161 msgid "" "The first metacharacter for repeating things that we'll look at is ``*``. " "``*`` doesn't match the literal character ``*``; instead, it specifies that " @@ -6988,7 +6810,7 @@ msgid "" "once." msgstr "" -#: ../src/Doc/howto/regex.rst:165 +#: howto/regex.rst:165 msgid "" "For example, ``ca*t`` will match ``ct`` (0 ``a`` characters), ``cat`` (1 " "``a``), ``caaat`` (3 ``a`` characters), and so forth. The RE engine has " @@ -6998,7 +6820,7 @@ msgid "" "run into that limit." msgstr "" -#: ../src/Doc/howto/regex.rst:172 +#: howto/regex.rst:172 msgid "" "Repetitions such as ``*`` are :dfn:`greedy`; when repeating a RE, the " "matching engine will try to repeat it as many times as possible. If later " @@ -7006,7 +6828,7 @@ msgid "" "and try again with few repetitions." msgstr "" -#: ../src/Doc/howto/regex.rst:177 +#: howto/regex.rst:177 msgid "" "A step-by-step example will make this more obvious. Let's consider the " "expression ``a[bcd]*b``. This matches the letter ``'a'``, zero or more " @@ -7014,99 +6836,99 @@ msgid "" "imagine matching this RE against the string ``abcbd``." msgstr "" -#: ../src/Doc/howto/regex.rst:183 +#: howto/regex.rst:183 msgid "Step" msgstr "" -#: ../src/Doc/howto/regex.rst:183 +#: howto/regex.rst:183 msgid "Matched" msgstr "" -#: ../src/Doc/howto/regex.rst:183 +#: howto/regex.rst:183 msgid "Explanation" msgstr "" -#: ../src/Doc/howto/regex.rst:185 +#: howto/regex.rst:185 msgid "1" msgstr "" -#: ../src/Doc/howto/regex.rst:185 +#: howto/regex.rst:185 msgid "``a``" msgstr "" -#: ../src/Doc/howto/regex.rst:185 +#: howto/regex.rst:185 msgid "The ``a`` in the RE matches." msgstr "" -#: ../src/Doc/howto/regex.rst:187 +#: howto/regex.rst:187 msgid "2" msgstr "" -#: ../src/Doc/howto/regex.rst:187 +#: howto/regex.rst:187 msgid "``abcbd``" msgstr "" -#: ../src/Doc/howto/regex.rst:187 +#: howto/regex.rst:187 msgid "" "The engine matches ``[bcd]*``, going as far as it can, which is to the end " "of the string." msgstr "" -#: ../src/Doc/howto/regex.rst:191 +#: howto/regex.rst:191 msgid "3" msgstr "" -#: ../src/Doc/howto/regex.rst:191 ../src/Doc/howto/regex.rst:199 +#: howto/regex.rst:191 howto/regex.rst:199 msgid "*Failure*" msgstr "" -#: ../src/Doc/howto/regex.rst:191 +#: howto/regex.rst:191 msgid "" "The engine tries to match ``b``, but the current position is at the end of " "the string, so it fails." msgstr "" -#: ../src/Doc/howto/regex.rst:196 +#: howto/regex.rst:196 msgid "4" msgstr "" -#: ../src/Doc/howto/regex.rst:196 ../src/Doc/howto/regex.rst:207 +#: howto/regex.rst:196 howto/regex.rst:207 msgid "``abcb``" msgstr "" -#: ../src/Doc/howto/regex.rst:196 +#: howto/regex.rst:196 msgid "Back up, so that ``[bcd]*`` matches one less character." msgstr "" -#: ../src/Doc/howto/regex.rst:199 +#: howto/regex.rst:199 msgid "5" msgstr "" -#: ../src/Doc/howto/regex.rst:199 +#: howto/regex.rst:199 msgid "" "Try ``b`` again, but the current position is at the last character, which is " "a ``'d'``." msgstr "" -#: ../src/Doc/howto/regex.rst:203 ../src/Doc/howto/regex.rst:207 +#: howto/regex.rst:203 howto/regex.rst:207 msgid "6" msgstr "" -#: ../src/Doc/howto/regex.rst:203 +#: howto/regex.rst:203 msgid "``abc``" msgstr "" -#: ../src/Doc/howto/regex.rst:203 +#: howto/regex.rst:203 msgid "Back up again, so that ``[bcd]*`` is only matching ``bc``." msgstr "" -#: ../src/Doc/howto/regex.rst:207 +#: howto/regex.rst:207 msgid "" "Try ``b`` again. This time the character at the current position is " "``'b'``, so it succeeds." msgstr "" -#: ../src/Doc/howto/regex.rst:213 +#: howto/regex.rst:213 msgid "" "The end of the RE has now been reached, and it has matched ``abcb``. This " "demonstrates how the matching engine goes as far as it can at first, and if " @@ -7116,7 +6938,7 @@ msgid "" "the string doesn't match the RE at all." msgstr "" -#: ../src/Doc/howto/regex.rst:220 +#: howto/regex.rst:220 msgid "" "Another repeating metacharacter is ``+``, which matches one or more times. " "Pay careful attention to the difference between ``*`` and ``+``; ``*`` " @@ -7126,7 +6948,7 @@ msgid "" "``a``'s), but won't match ``ct``." msgstr "" -#: ../src/Doc/howto/regex.rst:227 +#: howto/regex.rst:227 msgid "" "There are two more repeating qualifiers. The question mark character, ``?" "``, matches either once or zero times; you can think of it as marking " @@ -7134,7 +6956,7 @@ msgid "" "``homebrew`` or ``home-brew``." msgstr "" -#: ../src/Doc/howto/regex.rst:232 +#: howto/regex.rst:232 msgid "" "The most complicated repeated qualifier is ``{m,n}``, where *m* and *n* are " "decimal integers. This qualifier means there must be at least *m* " @@ -7143,7 +6965,7 @@ msgid "" "``a////b``, which has four." msgstr "" -#: ../src/Doc/howto/regex.rst:238 +#: howto/regex.rst:238 msgid "" "You can omit either *m* or *n*; in that case, a reasonable value is assumed " "for the missing value. Omitting *m* is interpreted as a lower limit of 0, " @@ -7152,7 +6974,7 @@ msgid "" "be infinity." msgstr "" -#: ../src/Doc/howto/regex.rst:243 +#: howto/regex.rst:243 msgid "" "Readers of a reductionist bent may notice that the three other qualifiers " "can all be expressed using this notation. ``{0,}`` is the same as ``*``, " @@ -7161,11 +6983,11 @@ msgid "" "shorter and easier to read." msgstr "" -#: ../src/Doc/howto/regex.rst:251 +#: howto/regex.rst:251 msgid "Using Regular Expressions" msgstr "" -#: ../src/Doc/howto/regex.rst:253 +#: howto/regex.rst:253 msgid "" "Now that we've looked at some simple regular expressions, how do we actually " "use them in Python? The :mod:`re` module provides an interface to the " @@ -7173,25 +6995,25 @@ msgid "" "perform matches with them." msgstr "" -#: ../src/Doc/howto/regex.rst:260 +#: howto/regex.rst:260 msgid "Compiling Regular Expressions" msgstr "" -#: ../src/Doc/howto/regex.rst:262 +#: howto/regex.rst:262 msgid "" "Regular expressions are compiled into pattern objects, which have methods " "for various operations such as searching for pattern matches or performing " "string substitutions. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:271 +#: howto/regex.rst:271 msgid "" ":func:`re.compile` also accepts an optional *flags* argument, used to enable " "various special features and syntax variations. We'll go over the available " "settings later, but for now a single example will do::" msgstr "" -#: ../src/Doc/howto/regex.rst:277 +#: howto/regex.rst:277 msgid "" "The RE is passed to :func:`re.compile` as a string. REs are handled as " "strings because regular expressions aren't part of the core Python language, " @@ -7202,17 +7024,17 @@ msgid "" "`socket` or :mod:`zlib` modules." msgstr "" -#: ../src/Doc/howto/regex.rst:284 +#: howto/regex.rst:284 msgid "" "Putting REs in strings keeps the Python language simpler, but has one " "disadvantage which is the topic of the next section." msgstr "" -#: ../src/Doc/howto/regex.rst:289 +#: howto/regex.rst:289 msgid "The Backslash Plague" msgstr "" -#: ../src/Doc/howto/regex.rst:291 +#: howto/regex.rst:291 msgid "" "As stated earlier, regular expressions use the backslash character " "(``'\\'``) to indicate special forms or to allow special characters to be " @@ -7220,7 +7042,7 @@ msgid "" "usage of the same character for the same purpose in string literals." msgstr "" -#: ../src/Doc/howto/regex.rst:296 +#: howto/regex.rst:296 msgid "" "Let's say you want to write a RE that matches the string ``\\section``, " "which might be found in a LaTeX file. To figure out what to write in the " @@ -7232,39 +7054,39 @@ msgid "" "*again*." msgstr "" -#: ../src/Doc/howto/regex.rst:305 +#: howto/regex.rst:305 msgid "Characters" msgstr "" -#: ../src/Doc/howto/regex.rst:305 +#: howto/regex.rst:305 msgid "Stage" msgstr "" -#: ../src/Doc/howto/regex.rst:307 +#: howto/regex.rst:307 msgid "``\\section``" msgstr "" -#: ../src/Doc/howto/regex.rst:307 +#: howto/regex.rst:307 msgid "Text string to be matched" msgstr "" -#: ../src/Doc/howto/regex.rst:309 +#: howto/regex.rst:309 msgid "``\\\\section``" msgstr "" -#: ../src/Doc/howto/regex.rst:309 +#: howto/regex.rst:309 msgid "Escaped backslash for :func:`re.compile`" msgstr "" -#: ../src/Doc/howto/regex.rst:311 ../src/Doc/howto/regex.rst:331 +#: howto/regex.rst:311 howto/regex.rst:331 msgid "``\"\\\\\\\\section\"``" msgstr "" -#: ../src/Doc/howto/regex.rst:311 +#: howto/regex.rst:311 msgid "Escaped backslashes for a string literal" msgstr "" -#: ../src/Doc/howto/regex.rst:314 +#: howto/regex.rst:314 msgid "" "In short, to match a literal backslash, one has to write ``'\\\\\\\\'`` as " "the RE string, because the regular expression must be ``\\\\``, and each " @@ -7273,7 +7095,7 @@ msgid "" "repeated backslashes and makes the resulting strings difficult to understand." msgstr "" -#: ../src/Doc/howto/regex.rst:320 +#: howto/regex.rst:320 msgid "" "The solution is to use Python's raw string notation for regular expressions; " "backslashes are not handled in any special way in a string literal prefixed " @@ -7283,39 +7105,39 @@ msgid "" "raw string notation." msgstr "" -#: ../src/Doc/howto/regex.rst:327 +#: howto/regex.rst:327 msgid "Regular String" msgstr "" -#: ../src/Doc/howto/regex.rst:327 +#: howto/regex.rst:327 msgid "Raw string" msgstr "" -#: ../src/Doc/howto/regex.rst:329 +#: howto/regex.rst:329 msgid "``\"ab*\"``" msgstr "" -#: ../src/Doc/howto/regex.rst:329 +#: howto/regex.rst:329 msgid "``r\"ab*\"``" msgstr "" -#: ../src/Doc/howto/regex.rst:331 +#: howto/regex.rst:331 msgid "``r\"\\\\section\"``" msgstr "" -#: ../src/Doc/howto/regex.rst:333 +#: howto/regex.rst:333 msgid "``\"\\\\w+\\\\s+\\\\1\"``" msgstr "" -#: ../src/Doc/howto/regex.rst:333 +#: howto/regex.rst:333 msgid "``r\"\\w+\\s+\\1\"``" msgstr "" -#: ../src/Doc/howto/regex.rst:338 +#: howto/regex.rst:338 msgid "Performing Matches" msgstr "" -#: ../src/Doc/howto/regex.rst:340 +#: howto/regex.rst:340 msgid "" "Once you have an object representing a compiled regular expression, what do " "you do with it? Pattern objects have several methods and attributes. Only " @@ -7323,52 +7145,50 @@ msgid "" "for a complete listing." msgstr "" -#: ../src/Doc/howto/regex.rst:346 ../src/Doc/howto/regex.rst:407 -#: ../src/Doc/howto/regex.rst:1039 +#: howto/regex.rst:346 howto/regex.rst:407 howto/regex.rst:1039 msgid "Method/Attribute" msgstr "" -#: ../src/Doc/howto/regex.rst:346 ../src/Doc/howto/regex.rst:407 -#: ../src/Doc/howto/regex.rst:1039 +#: howto/regex.rst:346 howto/regex.rst:407 howto/regex.rst:1039 msgid "Purpose" msgstr "" -#: ../src/Doc/howto/regex.rst:348 +#: howto/regex.rst:348 msgid "``match()``" msgstr "" -#: ../src/Doc/howto/regex.rst:348 +#: howto/regex.rst:348 msgid "Determine if the RE matches at the beginning of the string." msgstr "" -#: ../src/Doc/howto/regex.rst:351 +#: howto/regex.rst:351 msgid "``search()``" msgstr "" -#: ../src/Doc/howto/regex.rst:351 +#: howto/regex.rst:351 msgid "Scan through a string, looking for any location where this RE matches." msgstr "" -#: ../src/Doc/howto/regex.rst:354 +#: howto/regex.rst:354 msgid "``findall()``" msgstr "" -#: ../src/Doc/howto/regex.rst:354 +#: howto/regex.rst:354 msgid "Find all substrings where the RE matches, and returns them as a list." msgstr "" -#: ../src/Doc/howto/regex.rst:357 +#: howto/regex.rst:357 msgid "``finditer()``" msgstr "" -#: ../src/Doc/howto/regex.rst:357 +#: howto/regex.rst:357 msgid "" "Find all substrings where the RE matches, and returns them as an :term:" "`iterator`." msgstr "" # 0d281a82f3404c6bb56bbd844f743e7b -#: ../src/Doc/howto/regex.rst:361 +#: howto/regex.rst:361 msgid "" ":meth:`match` and :meth:`search` return ``None`` if no match can be found. " "If they're successful, a :ref:`match object ` instance is " @@ -7377,7 +7197,7 @@ msgid "" msgstr "" # 74da702c244b4300899078eb444a0158 -#: ../src/Doc/howto/regex.rst:366 +#: howto/regex.rst:366 msgid "" "You can learn about this by interactively experimenting with the :mod:`re` " "module. If you have Tkinter available, you may also want to look at :source:" @@ -7388,13 +7208,13 @@ msgid "" "net/>`_ is also an interactive tool for developing and testing RE patterns." msgstr "" -#: ../src/Doc/howto/regex.rst:375 +#: howto/regex.rst:375 msgid "" "This HOWTO uses the standard Python interpreter for its examples. First, run " "the Python interpreter, import the :mod:`re` module, and compile a RE::" msgstr "" -#: ../src/Doc/howto/regex.rst:384 +#: howto/regex.rst:384 msgid "" "Now, you can try matching various strings against the RE ``[a-z]+``. An " "empty string shouldn't match at all, since ``+`` means 'one or more " @@ -7404,7 +7224,7 @@ msgid "" msgstr "" # a906fbd0f61444e6a0ec93146755384f -#: ../src/Doc/howto/regex.rst:394 +#: howto/regex.rst:394 msgid "" "Now, let's try it on a string that it should match, such as ``tempo``. In " "this case, :meth:`match` will return a :ref:`match object `, " @@ -7412,50 +7232,50 @@ msgid "" msgstr "" # 24750054c21e41ea81d85bee3f24e50b -#: ../src/Doc/howto/regex.rst:402 +#: howto/regex.rst:402 msgid "" "Now you can query the :ref:`match object ` for information " "about the matching string. :ref:`match object ` instances " "also have several methods and attributes; the most important ones are:" msgstr "" -#: ../src/Doc/howto/regex.rst:409 +#: howto/regex.rst:409 msgid "``group()``" msgstr "" -#: ../src/Doc/howto/regex.rst:409 +#: howto/regex.rst:409 msgid "Return the string matched by the RE" msgstr "" -#: ../src/Doc/howto/regex.rst:411 +#: howto/regex.rst:411 msgid "``start()``" msgstr "" -#: ../src/Doc/howto/regex.rst:411 +#: howto/regex.rst:411 msgid "Return the starting position of the match" msgstr "" -#: ../src/Doc/howto/regex.rst:413 +#: howto/regex.rst:413 msgid "``end()``" msgstr "" -#: ../src/Doc/howto/regex.rst:413 +#: howto/regex.rst:413 msgid "Return the ending position of the match" msgstr "" -#: ../src/Doc/howto/regex.rst:415 +#: howto/regex.rst:415 msgid "``span()``" msgstr "" -#: ../src/Doc/howto/regex.rst:415 +#: howto/regex.rst:415 msgid "Return a tuple containing the (start, end) positions of the match" msgstr "" -#: ../src/Doc/howto/regex.rst:419 +#: howto/regex.rst:419 msgid "Trying these methods will soon clarify their meaning::" msgstr "" -#: ../src/Doc/howto/regex.rst:428 +#: howto/regex.rst:428 msgid "" ":meth:`group` returns the substring that was matched by the RE. :meth:" "`start` and :meth:`end` return the starting and ending index of the match. :" @@ -7467,33 +7287,33 @@ msgid "" msgstr "" # f8573c9beacf4f32b2a8fa80a1df355f -#: ../src/Doc/howto/regex.rst:445 +#: howto/regex.rst:445 msgid "" "In actual programs, the most common style is to store the :ref:`match object " "` in a variable, and then check if it was ``None``. This " "usually looks like::" msgstr "" -#: ../src/Doc/howto/regex.rst:456 +#: howto/regex.rst:456 msgid "" "Two pattern methods return all of the matches for a pattern. :meth:`findall` " "returns a list of matching strings::" msgstr "" # 7eee9e17bebb4be998acab26a6fcfcbf -#: ../src/Doc/howto/regex.rst:463 +#: howto/regex.rst:463 msgid "" ":meth:`findall` has to create the entire list before it can be returned as " "the result. The :meth:`finditer` method returns a sequence of :ref:`match " "object ` instances as an :term:`iterator`. [#]_ ::" msgstr "" -#: ../src/Doc/howto/regex.rst:479 +#: howto/regex.rst:479 msgid "Module-Level Functions" msgstr "" # 22f4aed7d8f049308dbb7ff4a8694a3c -#: ../src/Doc/howto/regex.rst:481 +#: howto/regex.rst:481 msgid "" "You don't have to create a pattern object and call its methods; the :mod:" "`re` module also provides top-level functions called :func:`match`, :func:" @@ -7503,7 +7323,7 @@ msgid "" "`match object ` instance. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:493 +#: howto/regex.rst:493 msgid "" "Under the hood, these functions simply create a pattern object for you and " "call the appropriate method on it. They also store the compiled object in a " @@ -7511,7 +7331,7 @@ msgid "" msgstr "" # 0a8b1c5cbbe04e9f86397b02d7e20de5 -#: ../src/Doc/howto/regex.rst:497 +#: howto/regex.rst:497 msgid "" "Should you use these module-level functions, or should you get the pattern " "and call its methods yourself? That choice depends on how frequently the RE " @@ -7524,17 +7344,17 @@ msgid "" "extract from the deprecated :mod:`xmllib` module::" msgstr "" -#: ../src/Doc/howto/regex.rst:512 +#: howto/regex.rst:512 msgid "" "I generally prefer to work with the compiled object, even for one-time uses, " "but few people will be as much of a purist about this as I am." msgstr "" -#: ../src/Doc/howto/regex.rst:517 +#: howto/regex.rst:517 msgid "Compilation Flags" msgstr "" -#: ../src/Doc/howto/regex.rst:519 +#: howto/regex.rst:519 msgid "" "Compilation flags let you modify some aspects of how regular expressions " "work. Flags are available in the :mod:`re` module under two names, a long " @@ -7546,74 +7366,74 @@ msgid "" "example." msgstr "" -#: ../src/Doc/howto/regex.rst:527 +#: howto/regex.rst:527 msgid "" "Here's a table of the available flags, followed by a more detailed " "explanation of each one." msgstr "" -#: ../src/Doc/howto/regex.rst:531 +#: howto/regex.rst:531 msgid "Flag" msgstr "" -#: ../src/Doc/howto/regex.rst:531 +#: howto/regex.rst:531 msgid "Meaning" msgstr "" -#: ../src/Doc/howto/regex.rst:533 +#: howto/regex.rst:533 msgid ":const:`DOTALL`, :const:`S`" msgstr "" -#: ../src/Doc/howto/regex.rst:533 +#: howto/regex.rst:533 msgid "Make ``.`` match any character, including newlines" msgstr "" -#: ../src/Doc/howto/regex.rst:536 +#: howto/regex.rst:536 msgid ":const:`IGNORECASE`, :const:`I`" msgstr "" -#: ../src/Doc/howto/regex.rst:536 +#: howto/regex.rst:536 msgid "Do case-insensitive matches" msgstr "" -#: ../src/Doc/howto/regex.rst:538 +#: howto/regex.rst:538 msgid ":const:`LOCALE`, :const:`L`" msgstr "" -#: ../src/Doc/howto/regex.rst:538 +#: howto/regex.rst:538 msgid "Do a locale-aware match" msgstr "" -#: ../src/Doc/howto/regex.rst:540 +#: howto/regex.rst:540 msgid ":const:`MULTILINE`, :const:`M`" msgstr "" -#: ../src/Doc/howto/regex.rst:540 +#: howto/regex.rst:540 msgid "Multi-line matching, affecting ``^`` and ``$``" msgstr "" -#: ../src/Doc/howto/regex.rst:543 +#: howto/regex.rst:543 msgid ":const:`VERBOSE`, :const:`X`" msgstr "" -#: ../src/Doc/howto/regex.rst:543 +#: howto/regex.rst:543 msgid "" "Enable verbose REs, which can be organized more cleanly and understandably." msgstr "" # a9036e47c09740f1931da0c0449c79db -#: ../src/Doc/howto/regex.rst:546 +#: howto/regex.rst:546 msgid ":const:`UNICODE`, :const:`U`" msgstr "" # df4dea7623334be188ee5357b0905f15 -#: ../src/Doc/howto/regex.rst:546 +#: howto/regex.rst:546 msgid "" "Makes several escapes like ``\\w``, ``\\b``, ``\\s`` and ``\\d`` dependent " "on the Unicode character database." msgstr "" -#: ../src/Doc/howto/regex.rst:556 +#: howto/regex.rst:556 msgid "" "Perform case-insensitive matching; character class and literal strings will " "match letters by ignoring case. For example, ``[A-Z]`` will match lowercase " @@ -7622,12 +7442,12 @@ msgid "" "also set the :const:`LOCALE` flag." msgstr "" -#: ../src/Doc/howto/regex.rst:567 +#: howto/regex.rst:567 msgid "" "Make ``\\w``, ``\\W``, ``\\b``, and ``\\B``, dependent on the current locale." msgstr "" -#: ../src/Doc/howto/regex.rst:569 +#: howto/regex.rst:569 msgid "" "Locales are a feature of the C library intended to help in writing programs " "that take account of language differences. For example, if you're " @@ -7641,13 +7461,13 @@ msgid "" "+`` to match French words as you'd expect." msgstr "" -#: ../src/Doc/howto/regex.rst:584 +#: howto/regex.rst:584 msgid "" "(``^`` and ``$`` haven't been explained yet; they'll be introduced in " "section :ref:`more-metacharacters`.)" msgstr "" -#: ../src/Doc/howto/regex.rst:587 +#: howto/regex.rst:587 msgid "" "Usually ``^`` matches only at the beginning of the string, and ``$`` matches " "only at the end of the string and immediately before the newline (if any) at " @@ -7658,20 +7478,20 @@ msgid "" "(immediately preceding each newline)." msgstr "" -#: ../src/Doc/howto/regex.rst:600 +#: howto/regex.rst:600 msgid "" "Makes the ``'.'`` special character match any character at all, including a " "newline; without this flag, ``'.'`` will match anything *except* a newline." msgstr "" # 409a3eff81934d09ad4bc56af2b1fd64 -#: ../src/Doc/howto/regex.rst:608 +#: howto/regex.rst:608 msgid "" "Make ``\\w``, ``\\W``, ``\\b``, ``\\B``, ``\\d``, ``\\D``, ``\\s`` and ``" "\\S`` dependent on the Unicode character properties database." msgstr "" -#: ../src/Doc/howto/regex.rst:616 +#: howto/regex.rst:616 msgid "" "This flag allows you to write regular expressions that are more readable by " "granting you more flexibility in how you can format them. When this flag " @@ -7683,45 +7503,45 @@ msgid "" "preceded by an unescaped backslash." msgstr "" -#: ../src/Doc/howto/regex.rst:625 +#: howto/regex.rst:625 msgid "" "For example, here's a RE that uses :const:`re.VERBOSE`; see how much easier " "it is to read? ::" msgstr "" -#: ../src/Doc/howto/regex.rst:638 +#: howto/regex.rst:638 msgid "Without the verbose setting, the RE would look like this::" msgstr "" -#: ../src/Doc/howto/regex.rst:644 +#: howto/regex.rst:644 msgid "" "In the above example, Python's automatic concatenation of string literals " "has been used to break up the RE into smaller pieces, but it's still more " "difficult to understand than the version using :const:`re.VERBOSE`." msgstr "" -#: ../src/Doc/howto/regex.rst:650 +#: howto/regex.rst:650 msgid "More Pattern Power" msgstr "" -#: ../src/Doc/howto/regex.rst:652 +#: howto/regex.rst:652 msgid "" "So far we've only covered a part of the features of regular expressions. In " "this section, we'll cover some new metacharacters, and how to use groups to " "retrieve portions of the text that was matched." msgstr "" -#: ../src/Doc/howto/regex.rst:660 +#: howto/regex.rst:660 msgid "More Metacharacters" msgstr "" -#: ../src/Doc/howto/regex.rst:662 +#: howto/regex.rst:662 msgid "" "There are some metacharacters that we haven't covered yet. Most of them " "will be covered in this section." msgstr "" -#: ../src/Doc/howto/regex.rst:665 +#: howto/regex.rst:665 msgid "" "Some of the remaining metacharacters to be discussed are :dfn:`zero-width " "assertions`. They don't cause the engine to advance through the string; " @@ -7733,12 +7553,11 @@ msgid "" "of times." msgstr "" -# 5ec08fab486b4b859b146ac043f515a9 -#: ../src/Doc/howto/regex.rst:680 -msgid "``|``" +#: howto/regex.rst:681 +msgid "|" msgstr "" -#: ../src/Doc/howto/regex.rst:674 +#: howto/regex.rst:674 msgid "" "Alternation, or the \"or\" operator. If A and B are regular expressions, " "``A|B`` will match any string that matches either ``A`` or ``B``. ``|`` has " @@ -7747,18 +7566,17 @@ msgid "" "``Crow`` or ``Servo``, not ``Cro``, a ``'w'`` or an ``'S'``, and ``ervo``." msgstr "" -#: ../src/Doc/howto/regex.rst:680 +#: howto/regex.rst:680 msgid "" "To match a literal ``'|'``, use ``\\|``, or enclose it inside a character " "class, as in ``[|]``." msgstr "" -# 7c7f6b7877b8411c8f2e906d99ea9663 -#: ../src/Doc/howto/regex.rst:696 -msgid "``^``" +#: howto/regex.rst:697 +msgid "^" msgstr "" -#: ../src/Doc/howto/regex.rst:684 +#: howto/regex.rst:684 msgid "" "Matches at the beginning of lines. Unless the :const:`MULTILINE` flag has " "been set, this will only match at the beginning of the string. In :const:" @@ -7766,35 +7584,33 @@ msgid "" "the string." msgstr "" -#: ../src/Doc/howto/regex.rst:688 +#: howto/regex.rst:688 msgid "" "For example, if you wish to match the word ``From`` only at the beginning of " "a line, the RE to use is ``^From``. ::" msgstr "" -# 6dd13735dce1481db2415e7305f152ac -#: ../src/Doc/howto/regex.rst:710 -msgid "``$``" +#: howto/regex.rst:711 +msgid "$" msgstr "" -#: ../src/Doc/howto/regex.rst:700 +#: howto/regex.rst:700 msgid "" "Matches at the end of a line, which is defined as either the end of the " "string, or any location followed by a newline character. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:710 +#: howto/regex.rst:710 msgid "" "To match a literal ``'$'``, use ``\\$`` or enclose it inside a character " "class, as in ``[$]``." msgstr "" -# 8355a4f6a25b405694a24af43ef0dfa1 -#: ../src/Doc/howto/regex.rst:716 -msgid "``\\A``" +#: howto/regex.rst:717 +msgid "\\A" msgstr "" -#: ../src/Doc/howto/regex.rst:714 +#: howto/regex.rst:714 msgid "" "Matches only at the start of the string. When not in :const:`MULTILINE` " "mode, ``\\A`` and ``^`` are effectively the same. In :const:`MULTILINE` " @@ -7803,21 +7619,19 @@ msgid "" "newline character." msgstr "" -# 702918f54b794e869e82de9b667c1ce9 -#: ../src/Doc/howto/regex.rst:719 -msgid "``\\Z``" +#: howto/regex.rst:720 +msgid "\\Z" msgstr "" -#: ../src/Doc/howto/regex.rst:720 +#: howto/regex.rst:720 msgid "Matches only at the end of the string." msgstr "" -# c8602ee0ca0b40e486f4490d57f31980 -#: ../src/Doc/howto/regex.rst:754 -msgid "``\\b``" +#: howto/regex.rst:755 +msgid "\\b" msgstr "" -#: ../src/Doc/howto/regex.rst:723 +#: howto/regex.rst:723 msgid "" "Word boundary. This is a zero-width assertion that matches only at the " "beginning or end of a word. A word is defined as a sequence of alphanumeric " @@ -7825,13 +7639,13 @@ msgid "" "alphanumeric character." msgstr "" -#: ../src/Doc/howto/regex.rst:728 +#: howto/regex.rst:728 msgid "" "The following example matches ``class`` only when it's a complete word; it " "won't match when it's contained inside another word. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:739 +#: howto/regex.rst:739 msgid "" "There are two subtleties you should remember when using this special " "sequence. First, this is the worst collision between Python's string " @@ -7842,29 +7656,28 @@ msgid "" "previous RE, but omits the ``'r'`` in front of the RE string. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:753 +#: howto/regex.rst:753 msgid "" "Second, inside a character class, where there's no use for this assertion, ``" "\\b`` represents the backspace character, for compatibility with Python's " "string literals." msgstr "" -# fbcb300e4fe542b1b2069f1bb4352898 -#: ../src/Doc/howto/regex.rst:759 -msgid "``\\B``" +#: howto/regex.rst:760 +msgid "\\B" msgstr "" -#: ../src/Doc/howto/regex.rst:758 +#: howto/regex.rst:758 msgid "" "Another zero-width assertion, this is the opposite of ``\\b``, only matching " "when the current position is not at a word boundary." msgstr "" -#: ../src/Doc/howto/regex.rst:763 +#: howto/regex.rst:763 msgid "Grouping" msgstr "" -#: ../src/Doc/howto/regex.rst:765 +#: howto/regex.rst:765 msgid "" "Frequently you need to obtain more information than just whether the RE " "matched or not. Regular expressions are often used to dissect strings by " @@ -7873,14 +7686,14 @@ msgid "" "name and a value, separated by a ``':'``, like this::" msgstr "" -#: ../src/Doc/howto/regex.rst:776 +#: howto/regex.rst:776 msgid "" "This can be handled by writing a regular expression which matches an entire " "header line, and has one group which matches the header name, and another " "group which matches the header's value." msgstr "" -#: ../src/Doc/howto/regex.rst:780 +#: howto/regex.rst:780 msgid "" "Groups are marked by the ``'('``, ``')'`` metacharacters. ``'('`` and " "``')'`` have much the same meaning as they do in mathematical expressions; " @@ -7891,7 +7704,7 @@ msgid "" msgstr "" # 16373d7bac57435c9c5b96f28ed6a800 -#: ../src/Doc/howto/regex.rst:791 +#: howto/regex.rst:791 msgid "" "Groups indicated with ``'('``, ``')'`` also capture the starting and ending " "index of the text that they match; this can be retrieved by passing an " @@ -7902,27 +7715,27 @@ msgid "" "capture the span of text that they match. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:806 +#: howto/regex.rst:806 msgid "" "Subgroups are numbered from left to right, from 1 upward. Groups can be " "nested; to determine the number, just count the opening parenthesis " "characters, going from left to right. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:819 +#: howto/regex.rst:819 msgid "" ":meth:`group` can be passed multiple group numbers at a time, in which case " "it will return a tuple containing the corresponding values for those " "groups. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:825 +#: howto/regex.rst:825 msgid "" "The :meth:`groups` method returns a tuple containing the strings for all the " "subgroups, from 1 up to however many there are. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:831 +#: howto/regex.rst:831 msgid "" "Backreferences in a pattern allow you to specify that the contents of an " "earlier capturing group must also be found at the current location in the " @@ -7933,11 +7746,11 @@ msgid "" "when incorporating backreferences in a RE." msgstr "" -#: ../src/Doc/howto/regex.rst:839 +#: howto/regex.rst:839 msgid "For example, the following RE detects doubled words in a string. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:845 +#: howto/regex.rst:845 msgid "" "Backreferences like this aren't often useful for just searching through a " "string --- there are few text formats which repeat data in this way --- but " @@ -7945,11 +7758,11 @@ msgid "" "substitutions." msgstr "" -#: ../src/Doc/howto/regex.rst:851 +#: howto/regex.rst:851 msgid "Non-capturing and Named Groups" msgstr "" -#: ../src/Doc/howto/regex.rst:853 +#: howto/regex.rst:853 msgid "" "Elaborate REs may use many groups, both to capture substrings of interest, " "and to group and structure the RE itself. In complex REs, it becomes " @@ -7958,7 +7771,7 @@ msgid "" "expression extensions, so we'll look at that first." msgstr "" -#: ../src/Doc/howto/regex.rst:859 +#: howto/regex.rst:859 msgid "" "Perl 5 added several additional features to standard regular expressions, " "and the Python :mod:`re` module supports most of them. It would have been " @@ -7970,7 +7783,7 @@ msgid "" "writing ``\\&`` or ``[&]``." msgstr "" -#: ../src/Doc/howto/regex.rst:867 +#: howto/regex.rst:867 msgid "" "The solution chosen by the Perl developers was to use ``(?...)`` as the " "extension syntax. ``?`` immediately after a parenthesis was a syntax error " @@ -7981,7 +7794,7 @@ msgid "" "capturing group containing the subexpression ``foo``)." msgstr "" -#: ../src/Doc/howto/regex.rst:875 +#: howto/regex.rst:875 msgid "" "Python adds an extension syntax to Perl's extension syntax. If the first " "character after the question mark is a ``P``, you know that it's an " @@ -7993,7 +7806,7 @@ msgid "" "compatibility's sake." msgstr "" -#: ../src/Doc/howto/regex.rst:883 +#: howto/regex.rst:883 msgid "" "Now that we've looked at the general extension syntax, we can return to the " "features that simplify working with groups in complex REs. Since groups are " @@ -8003,7 +7816,7 @@ msgid "" "change the numbers of everything that follows it." msgstr "" -#: ../src/Doc/howto/regex.rst:890 +#: howto/regex.rst:890 msgid "" "Sometimes you'll want to use a group to collect a part of a regular " "expression, but aren't interested in retrieving the group's contents. You " @@ -8011,7 +7824,7 @@ msgid "" "where you can replace the ``...`` with any other regular expression. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:902 +#: howto/regex.rst:902 msgid "" "Except for the fact that you can't retrieve the contents of what the group " "matched, a non-capturing group behaves exactly the same as a capturing " @@ -8024,14 +7837,14 @@ msgid "" "groups; neither form is any faster than the other." msgstr "" -#: ../src/Doc/howto/regex.rst:911 +#: howto/regex.rst:911 msgid "" "A more significant feature is named groups: instead of referring to them by " "numbers, groups can be referenced by a name." msgstr "" # cb2e6d565ea44b56a717ace23863bba8 -#: ../src/Doc/howto/regex.rst:914 +#: howto/regex.rst:914 msgid "" "The syntax for a named group is one of the Python-specific extensions: ``(?" "P...)``. *name* is, obviously, the name of the group. Named groups " @@ -8043,20 +7856,20 @@ msgid "" "ways::" msgstr "" -#: ../src/Doc/howto/regex.rst:929 +#: howto/regex.rst:929 msgid "" "Named groups are handy because they let you use easily-remembered names, " "instead of having to remember numbers. Here's an example RE from the :mod:" "`imaplib` module::" msgstr "" -#: ../src/Doc/howto/regex.rst:940 +#: howto/regex.rst:940 msgid "" "It's obviously much easier to retrieve ``m.group('zonem')``, instead of " "having to remember to retrieve group 9." msgstr "" -#: ../src/Doc/howto/regex.rst:943 +#: howto/regex.rst:943 msgid "" "The syntax for backreferences in an expression such as ``(...)\\1`` refers " "to the number of the group. There's naturally a variant that uses the group " @@ -8067,23 +7880,22 @@ msgid "" "P=word)``::" msgstr "" -#: ../src/Doc/howto/regex.rst:956 +#: howto/regex.rst:956 msgid "Lookahead Assertions" msgstr "" -#: ../src/Doc/howto/regex.rst:958 +#: howto/regex.rst:958 msgid "" "Another zero-width assertion is the lookahead assertion. Lookahead " "assertions are available in both positive and negative form, and look like " "this:" msgstr "" -# d9b3399647fd442d9bbf898c7385bc34 -#: ../src/Doc/howto/regex.rst:965 -msgid "``(?=...)``" +#: howto/regex.rst:966 +msgid "(?=...)" msgstr "" -#: ../src/Doc/howto/regex.rst:962 +#: howto/regex.rst:962 msgid "" "Positive lookahead assertion. This succeeds if the contained regular " "expression, represented here by ``...``, successfully matches at the current " @@ -8092,19 +7904,18 @@ msgid "" "is tried right where the assertion started." msgstr "" -# 2933d119182340a49ce28e51fac5d737 -#: ../src/Doc/howto/regex.rst:970 -msgid "``(?!...)``" +#: howto/regex.rst:971 +msgid "(?!...)" msgstr "" -#: ../src/Doc/howto/regex.rst:969 +#: howto/regex.rst:969 msgid "" "Negative lookahead assertion. This is the opposite of the positive " "assertion; it succeeds if the contained expression *doesn't* match at the " "current position in the string." msgstr "" -#: ../src/Doc/howto/regex.rst:973 +#: howto/regex.rst:973 msgid "" "To make this concrete, let's look at a case where a lookahead is useful. " "Consider a simple pattern to match a filename and split it apart into a base " @@ -8112,15 +7923,15 @@ msgid "" "``news`` is the base name, and ``rc`` is the filename's extension." msgstr "" -#: ../src/Doc/howto/regex.rst:978 +#: howto/regex.rst:978 msgid "The pattern to match this is quite simple:" msgstr "" -#: ../src/Doc/howto/regex.rst:980 +#: howto/regex.rst:980 msgid "``.*[.].*$``" msgstr "" -#: ../src/Doc/howto/regex.rst:982 +#: howto/regex.rst:982 msgid "" "Notice that the ``.`` needs to be treated specially because it's a " "metacharacter; I've put it inside a character class. Also notice the " @@ -8129,24 +7940,24 @@ msgid "" "and ``autoexec.bat`` and ``sendmail.cf`` and ``printers.conf``." msgstr "" -#: ../src/Doc/howto/regex.rst:988 +#: howto/regex.rst:988 msgid "" "Now, consider complicating the problem a bit; what if you want to match " "filenames where the extension is not ``bat``? Some incorrect attempts:" msgstr "" -#: ../src/Doc/howto/regex.rst:991 +#: howto/regex.rst:991 msgid "" "``.*[.][^b].*$`` The first attempt above tries to exclude ``bat`` by " "requiring that the first character of the extension is not a ``b``. This is " "wrong, because the pattern also doesn't match ``foo.bar``." msgstr "" -#: ../src/Doc/howto/regex.rst:995 +#: howto/regex.rst:995 msgid "``.*[.]([^b]..|.[^a].|..[^t])$``" msgstr "" -#: ../src/Doc/howto/regex.rst:997 +#: howto/regex.rst:997 msgid "" "The expression gets messier when you try to patch up the first solution by " "requiring one of the following cases to match: the first character of the " @@ -8157,18 +7968,18 @@ msgid "" "pattern again in an effort to fix it." msgstr "" -#: ../src/Doc/howto/regex.rst:1005 +#: howto/regex.rst:1005 msgid "``.*[.]([^b].?.?|.[^a]?.?|..?[^t]?)$``" msgstr "" -#: ../src/Doc/howto/regex.rst:1007 +#: howto/regex.rst:1007 msgid "" "In the third attempt, the second and third letters are all made optional in " "order to allow matching extensions shorter than three characters, such as " "``sendmail.cf``." msgstr "" -#: ../src/Doc/howto/regex.rst:1011 +#: howto/regex.rst:1011 msgid "" "The pattern's getting really complicated now, which makes it hard to read " "and understand. Worse, if the problem changes and you want to exclude both " @@ -8176,11 +7987,11 @@ msgid "" "complicated and confusing." msgstr "" -#: ../src/Doc/howto/regex.rst:1016 +#: howto/regex.rst:1016 msgid "A negative lookahead cuts through all this confusion:" msgstr "" -#: ../src/Doc/howto/regex.rst:1018 +#: howto/regex.rst:1018 msgid "" "``.*[.](?!bat$).*$`` The negative lookahead means: if the expression " "``bat`` doesn't match at this point, try the rest of the pattern; if ``bat" @@ -8189,61 +8000,61 @@ msgid "" "starts with ``bat``, will be allowed." msgstr "" -#: ../src/Doc/howto/regex.rst:1024 +#: howto/regex.rst:1024 msgid "" "Excluding another filename extension is now easy; simply add it as an " "alternative inside the assertion. The following pattern excludes filenames " "that end in either ``bat`` or ``exe``:" msgstr "" -#: ../src/Doc/howto/regex.rst:1028 +#: howto/regex.rst:1028 msgid "``.*[.](?!bat$|exe$).*$``" msgstr "" -#: ../src/Doc/howto/regex.rst:1032 +#: howto/regex.rst:1032 msgid "Modifying Strings" msgstr "" -#: ../src/Doc/howto/regex.rst:1034 +#: howto/regex.rst:1034 msgid "" "Up to this point, we've simply performed searches against a static string. " "Regular expressions are also commonly used to modify strings in various " "ways, using the following pattern methods:" msgstr "" -#: ../src/Doc/howto/regex.rst:1041 +#: howto/regex.rst:1041 msgid "``split()``" msgstr "" -#: ../src/Doc/howto/regex.rst:1041 +#: howto/regex.rst:1041 msgid "Split the string into a list, splitting it wherever the RE matches" msgstr "" -#: ../src/Doc/howto/regex.rst:1044 +#: howto/regex.rst:1044 msgid "``sub()``" msgstr "" -#: ../src/Doc/howto/regex.rst:1044 +#: howto/regex.rst:1044 msgid "" "Find all substrings where the RE matches, and replace them with a different " "string" msgstr "" -#: ../src/Doc/howto/regex.rst:1047 +#: howto/regex.rst:1047 msgid "``subn()``" msgstr "" -#: ../src/Doc/howto/regex.rst:1047 +#: howto/regex.rst:1047 msgid "" "Does the same thing as :meth:`sub`, but returns the new string and the " "number of replacements" msgstr "" -#: ../src/Doc/howto/regex.rst:1054 +#: howto/regex.rst:1054 msgid "Splitting Strings" msgstr "" -#: ../src/Doc/howto/regex.rst:1056 +#: howto/regex.rst:1056 msgid "" "The :meth:`split` method of a pattern splits a string apart wherever the RE " "matches, returning a list of the pieces. It's similar to the :meth:`split` " @@ -8253,7 +8064,7 @@ msgid "" "function, too." msgstr "" -#: ../src/Doc/howto/regex.rst:1067 +#: howto/regex.rst:1067 msgid "" "Split *string* by the matches of the regular expression. If capturing " "parentheses are used in the RE, then their contents will also be returned as " @@ -8261,7 +8072,7 @@ msgid "" "splits are performed." msgstr "" -#: ../src/Doc/howto/regex.rst:1072 +#: howto/regex.rst:1072 msgid "" "You can limit the number of splits made, by passing a value for *maxsplit*. " "When *maxsplit* is nonzero, at most *maxsplit* splits will be made, and the " @@ -8270,7 +8081,7 @@ msgid "" "characters. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:1084 +#: howto/regex.rst:1084 msgid "" "Sometimes you're not only interested in what the text between delimiters is, " "but also need to know what the delimiter was. If capturing parentheses are " @@ -8278,17 +8089,17 @@ msgid "" "Compare the following calls::" msgstr "" -#: ../src/Doc/howto/regex.rst:1096 +#: howto/regex.rst:1096 msgid "" "The module-level function :func:`re.split` adds the RE to be used as the " "first argument, but is otherwise the same. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:1108 +#: howto/regex.rst:1108 msgid "Search and Replace" msgstr "" -#: ../src/Doc/howto/regex.rst:1110 +#: howto/regex.rst:1110 msgid "" "Another common task is to find all the matches for a pattern, and replace " "them with a different string. The :meth:`sub` method takes a replacement " @@ -8296,39 +8107,39 @@ msgid "" "processed." msgstr "" -#: ../src/Doc/howto/regex.rst:1118 +#: howto/regex.rst:1118 msgid "" "Returns the string obtained by replacing the leftmost non-overlapping " "occurrences of the RE in *string* by the replacement *replacement*. If the " "pattern isn't found, *string* is returned unchanged." msgstr "" -#: ../src/Doc/howto/regex.rst:1122 +#: howto/regex.rst:1122 msgid "" "The optional argument *count* is the maximum number of pattern occurrences " "to be replaced; *count* must be a non-negative integer. The default value " "of 0 means to replace all occurrences." msgstr "" -#: ../src/Doc/howto/regex.rst:1126 +#: howto/regex.rst:1126 msgid "" "Here's a simple example of using the :meth:`sub` method. It replaces colour " "names with the word ``colour``::" msgstr "" -#: ../src/Doc/howto/regex.rst:1135 +#: howto/regex.rst:1135 msgid "" "The :meth:`subn` method does the same work, but returns a 2-tuple containing " "the new string value and the number of replacements that were performed::" msgstr "" -#: ../src/Doc/howto/regex.rst:1144 +#: howto/regex.rst:1144 msgid "" "Empty matches are replaced only when they're not adjacent to a previous " "match. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:1151 +#: howto/regex.rst:1151 msgid "" "If *replacement* is a string, any backslash escapes in it are processed. " "That is, ``\\n`` is converted to a single newline character, ``\\r`` is " @@ -8339,13 +8150,13 @@ msgid "" "string." msgstr "" -#: ../src/Doc/howto/regex.rst:1158 +#: howto/regex.rst:1158 msgid "" "This example matches the word ``section`` followed by a string enclosed in " "``{``, ``}``, and changes ``section`` to ``subsection``::" msgstr "" -#: ../src/Doc/howto/regex.rst:1165 +#: howto/regex.rst:1165 msgid "" "There's also a syntax for referring to named groups as defined by the ``(?" "P...)`` syntax. ``\\g`` will use the substring matched by the " @@ -8358,7 +8169,7 @@ msgid "" msgstr "" # 55f2296ddf34434fbcf9979ba3564d52 -#: ../src/Doc/howto/regex.rst:1182 +#: howto/regex.rst:1182 msgid "" "*replacement* can also be a function, which gives you even more control. If " "*replacement* is a function, the function is called for every non-" @@ -8368,13 +8179,13 @@ msgid "" msgstr "" # 4b4a08bd8694459ba512d24b01e29b4c -#: ../src/Doc/howto/regex.rst:1188 +#: howto/regex.rst:1188 msgid "" "In the following example, the replacement function translates decimals into " "hexadecimal::" msgstr "" -#: ../src/Doc/howto/regex.rst:1200 +#: howto/regex.rst:1200 msgid "" "When using the module-level :func:`re.sub` function, the pattern is passed " "as the first argument. The pattern may be provided as an object or as a " @@ -8384,11 +8195,11 @@ msgid "" "x'``." msgstr "" -#: ../src/Doc/howto/regex.rst:1208 +#: howto/regex.rst:1208 msgid "Common Problems" msgstr "" -#: ../src/Doc/howto/regex.rst:1210 +#: howto/regex.rst:1210 msgid "" "Regular expressions are a powerful tool for some applications, but in some " "ways their behaviour isn't intuitive and at times they don't behave the way " @@ -8396,11 +8207,11 @@ msgid "" "pitfalls." msgstr "" -#: ../src/Doc/howto/regex.rst:1216 +#: howto/regex.rst:1216 msgid "Use String Methods" msgstr "" -#: ../src/Doc/howto/regex.rst:1218 +#: howto/regex.rst:1218 msgid "" "Sometimes using the :mod:`re` module is a mistake. If you're matching a " "fixed string, or a single character class, and you're not using any :mod:" @@ -8412,7 +8223,7 @@ msgid "" "engine." msgstr "" -#: ../src/Doc/howto/regex.rst:1226 +#: howto/regex.rst:1226 msgid "" "One example might be replacing a single fixed string with another one; for " "example, you might replace ``word`` with ``deed``. ``re.sub()`` seems like " @@ -8425,7 +8236,7 @@ msgid "" "`replace`'s abilities.)" msgstr "" -#: ../src/Doc/howto/regex.rst:1235 +#: howto/regex.rst:1235 msgid "" "Another common task is deleting every occurrence of a single character from " "a string or replacing it with another single character. You might do this " @@ -8434,17 +8245,17 @@ msgid "" "operation can be." msgstr "" -#: ../src/Doc/howto/regex.rst:1241 +#: howto/regex.rst:1241 msgid "" "In short, before turning to the :mod:`re` module, consider whether your " "problem can be solved with a faster and simpler string method." msgstr "" -#: ../src/Doc/howto/regex.rst:1246 +#: howto/regex.rst:1246 msgid "match() versus search()" msgstr "" -#: ../src/Doc/howto/regex.rst:1248 +#: howto/regex.rst:1248 msgid "" "The :func:`match` function only checks if the RE matches at the beginning of " "the string while :func:`search` will scan forward through the string for a " @@ -8453,13 +8264,13 @@ msgid "" "match wouldn't start at zero, :func:`match` will *not* report it. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:1259 +#: howto/regex.rst:1259 msgid "" "On the other hand, :func:`search` will scan forward through the string, " "reporting the first match it finds. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:1267 +#: howto/regex.rst:1267 msgid "" "Sometimes you'll be tempted to keep using :func:`re.match`, and just add ``." "*`` to the front of your RE. Resist this temptation and use :func:`re." @@ -8471,18 +8282,18 @@ msgid "" "starting character, only trying the full match if a ``'C'`` is found." msgstr "" -#: ../src/Doc/howto/regex.rst:1276 +#: howto/regex.rst:1276 msgid "" "Adding ``.*`` defeats this optimization, requiring scanning to the end of " "the string and then backtracking to find a match for the rest of the RE. " "Use :func:`re.search` instead." msgstr "" -#: ../src/Doc/howto/regex.rst:1282 +#: howto/regex.rst:1282 msgid "Greedy versus Non-Greedy" msgstr "" -#: ../src/Doc/howto/regex.rst:1284 +#: howto/regex.rst:1284 msgid "" "When repeating a regular expression, as in ``a*``, the resulting action is " "to consume as much of the pattern as possible. This fact often bites you " @@ -8491,7 +8302,7 @@ msgid "" "HTML tag doesn't work because of the greedy nature of ``.*``. ::" msgstr "" -#: ../src/Doc/howto/regex.rst:1298 +#: howto/regex.rst:1298 msgid "" "The RE matches the ``'<'`` in ````, and the ``.*`` consumes the rest " "of the string. There's still more left in the RE, though, and the ``>`` " @@ -8501,7 +8312,7 @@ msgid "" "title>``, which isn't what you want." msgstr "" -#: ../src/Doc/howto/regex.rst:1305 +#: howto/regex.rst:1305 msgid "" "In this case, the solution is to use the non-greedy qualifiers ``*?``, ``+?" "``, ``??``, or ``{m,n}?``, which match as *little* text as possible. In the " @@ -8510,7 +8321,7 @@ msgid "" "retrying the ``'>'`` at every step. This produces just the right result::" msgstr "" -#: ../src/Doc/howto/regex.rst:1314 +#: howto/regex.rst:1314 msgid "" "(Note that parsing HTML or XML with regular expressions is painful. Quick-" "and-dirty patterns will handle common cases, but HTML and XML have special " @@ -8521,11 +8332,11 @@ msgid "" msgstr "" # 5df698055ad74e8f835cf198efdb2043 -#: ../src/Doc/howto/regex.rst:1322 +#: howto/regex.rst:1322 msgid "Using re.VERBOSE" msgstr "" -#: ../src/Doc/howto/regex.rst:1324 +#: howto/regex.rst:1324 msgid "" "By now you've probably noticed that regular expressions are a very compact " "notation, but they're not terribly readable. REs of moderate complexity can " @@ -8533,14 +8344,14 @@ msgid "" "making them difficult to read and understand." msgstr "" -#: ../src/Doc/howto/regex.rst:1329 +#: howto/regex.rst:1329 msgid "" "For such REs, specifying the ``re.VERBOSE`` flag when compiling the regular " "expression can be helpful, because it allows you to format the regular " "expression more clearly." msgstr "" -#: ../src/Doc/howto/regex.rst:1333 +#: howto/regex.rst:1333 msgid "" "The ``re.VERBOSE`` flag has several effects. Whitespace in the regular " "expression that *isn't* inside a character class is ignored. This means " @@ -8551,15 +8362,15 @@ msgid "" "quoted strings, this enables REs to be formatted more neatly::" msgstr "" -#: ../src/Doc/howto/regex.rst:1350 +#: howto/regex.rst:1350 msgid "This is far more readable than::" msgstr "" -#: ../src/Doc/howto/regex.rst:1356 +#: howto/regex.rst:1356 msgid "Feedback" msgstr "" -#: ../src/Doc/howto/regex.rst:1358 +#: howto/regex.rst:1358 msgid "" "Regular expressions are a complicated topic. Did this document help you " "understand them? Were there parts that were unclear, or Problems you " @@ -8567,7 +8378,7 @@ msgid "" "improvements to the author." msgstr "" -#: ../src/Doc/howto/regex.rst:1363 +#: howto/regex.rst:1363 msgid "" "The most complete book on regular expressions is almost certainly Jeffrey " "Friedl's Mastering Regular Expressions, published by O'Reilly. " @@ -8578,23 +8389,23 @@ msgid "" "you much.) Consider checking it out from your library." msgstr "" -#: ../src/Doc/howto/regex.rst:1373 ../src/Doc/howto/urllib2.rst:556 +#: howto/regex.rst:1373 howto/urllib2.rst:556 msgid "Footnotes" msgstr "Notes" -#: ../src/Doc/howto/regex.rst:1374 +#: howto/regex.rst:1374 msgid "Introduced in Python 2.2.2." msgstr "" -#: ../src/Doc/howto/sockets.rst:5 +#: howto/sockets.rst:5 msgid "Socket Programming HOWTO" msgstr "" -#: ../src/Doc/howto/sockets.rst:7 +#: howto/sockets.rst:7 msgid "Gordon McMillan" msgstr "" -#: ../src/Doc/howto/sockets.rst:12 +#: howto/sockets.rst:12 msgid "" "Sockets are used nearly everywhere, but are one of the most severely " "misunderstood technologies around. This is a 10,000 foot overview of " @@ -8604,11 +8415,11 @@ msgid "" "them decently." msgstr "" -#: ../src/Doc/howto/sockets.rst:20 +#: howto/sockets.rst:20 msgid "Sockets" msgstr "" -#: ../src/Doc/howto/sockets.rst:22 +#: howto/sockets.rst:22 msgid "" "I'm only going to talk about INET sockets, but they account for at least 99% " "of the sockets in use. And I'll only talk about STREAM sockets - unless you " @@ -8620,7 +8431,7 @@ msgid "" "they work before dealing with non-blocking sockets." msgstr "" -#: ../src/Doc/howto/sockets.rst:31 +#: howto/sockets.rst:31 msgid "" "Part of the trouble with understanding these things is that \"socket\" can " "mean a number of subtly different things, depending on context. So first, " @@ -8631,12 +8442,12 @@ msgid "" "sockets and \"client\" sockets." msgstr "" -#: ../src/Doc/howto/sockets.rst:40 +#: howto/sockets.rst:40 msgid "History" msgstr "" # e7871668004045188ed6c94e54d4efbe -#: ../src/Doc/howto/sockets.rst:42 +#: howto/sockets.rst:42 msgid "" "Of the various forms of :abbr:`IPC (Inter Process Communication)`, sockets " "are by far the most popular. On any given platform, there are likely to be " @@ -8644,7 +8455,7 @@ msgid "" "sockets are about the only game in town." msgstr "" -#: ../src/Doc/howto/sockets.rst:47 +#: howto/sockets.rst:47 msgid "" "They were invented in Berkeley as part of the BSD flavor of Unix. They " "spread like wildfire with the Internet. With good reason --- the combination " @@ -8652,18 +8463,18 @@ msgid "" "unbelievably easy (at least compared to other schemes)." msgstr "" -#: ../src/Doc/howto/sockets.rst:54 +#: howto/sockets.rst:54 msgid "Creating a Socket" msgstr "" -#: ../src/Doc/howto/sockets.rst:56 +#: howto/sockets.rst:56 msgid "" "Roughly speaking, when you clicked on the link that brought you to this " "page, your browser did something like the following::" msgstr "" # 3905ece01e6441f8afc1e6c38e889cb8 -#: ../src/Doc/howto/sockets.rst:66 +#: howto/sockets.rst:66 msgid "" "When the ``connect`` completes, the socket ``s`` can be used to send in a " "request for the text of the page. The same socket will read the reply, and " @@ -8672,14 +8483,14 @@ msgid "" msgstr "" # ecb0daa4451d445a931574c5b45b359a -#: ../src/Doc/howto/sockets.rst:72 +#: howto/sockets.rst:72 msgid "" "What happens in the web server is a bit more complex. First, the web server " "creates a \"server socket\"::" msgstr "" # db84be2f300245108ba171f533a0cff2 -#: ../src/Doc/howto/sockets.rst:84 +#: howto/sockets.rst:84 msgid "" "A couple things to notice: we used ``socket.gethostname()`` so that the " "socket would be visible to the outside world. If we had used ``s." @@ -8689,14 +8500,14 @@ msgid "" "address the machine happens to have." msgstr "" -#: ../src/Doc/howto/sockets.rst:91 +#: howto/sockets.rst:91 msgid "" "A second thing to note: low number ports are usually reserved for \"well " "known\" services (HTTP, SNMP etc). If you're playing around, use a nice high " "number (4 digits)." msgstr "" -#: ../src/Doc/howto/sockets.rst:95 +#: howto/sockets.rst:95 msgid "" "Finally, the argument to ``listen`` tells the socket library that we want it " "to queue up as many as 5 connect requests (the normal max) before refusing " @@ -8705,13 +8516,13 @@ msgid "" msgstr "" # e55626a58ce64ac2ac88801517904a73 -#: ../src/Doc/howto/sockets.rst:99 +#: howto/sockets.rst:99 msgid "" "Now that we have a \"server\" socket, listening on port 80, we can enter the " "mainloop of the web server::" msgstr "" -#: ../src/Doc/howto/sockets.rst:110 +#: howto/sockets.rst:110 msgid "" "There's actually 3 general ways in which this loop could work - dispatching " "a thread to handle ``clientsocket``, create a new process to handle " @@ -8727,11 +8538,11 @@ msgid "" "allocated port which will be recycled when the conversation ends." msgstr "" -#: ../src/Doc/howto/sockets.rst:125 +#: howto/sockets.rst:125 msgid "IPC" msgstr "" -#: ../src/Doc/howto/sockets.rst:127 +#: howto/sockets.rst:127 msgid "" "If you need fast IPC between two processes on one machine, you should look " "into whatever form of shared memory the platform offers. A simple protocol " @@ -8739,18 +8550,18 @@ msgid "" "technique." msgstr "" -#: ../src/Doc/howto/sockets.rst:131 +#: howto/sockets.rst:131 msgid "" "If you do decide to use sockets, bind the \"server\" socket to " "``'localhost'``. On most platforms, this will take a shortcut around a " "couple of layers of network code and be quite a bit faster." msgstr "" -#: ../src/Doc/howto/sockets.rst:137 +#: howto/sockets.rst:137 msgid "Using a Socket" msgstr "" -#: ../src/Doc/howto/sockets.rst:139 +#: howto/sockets.rst:139 msgid "" "The first thing to note, is that the web browser's \"client\" socket and the " "web server's \"client\" socket are identical beasts. That is, this is a " @@ -8762,7 +8573,7 @@ msgid "" msgstr "" # 729d651ca80e4c2d8717cbcad950867e -#: ../src/Doc/howto/sockets.rst:146 +#: howto/sockets.rst:146 msgid "" "Now there are two sets of verbs to use for communication. You can use " "``send`` and ``recv``, or you can transform your client socket into a file-" @@ -8775,7 +8586,7 @@ msgid "" msgstr "" # dae25367caed44448f8e02023b0bbd6e -#: ../src/Doc/howto/sockets.rst:155 +#: howto/sockets.rst:155 msgid "" "Now we come to the major stumbling block of sockets - ``send`` and ``recv`` " "operate on the network buffers. They do not necessarily handle all the bytes " @@ -8787,7 +8598,7 @@ msgid "" msgstr "" # dfdbac43752945419feccf97f87cc592 -#: ../src/Doc/howto/sockets.rst:163 +#: howto/sockets.rst:163 msgid "" "When a ``recv`` returns 0 bytes, it means the other side has closed (or is " "in the process of closing) the connection. You will not receive any more " @@ -8796,7 +8607,7 @@ msgid "" msgstr "" # 3c37b186079d4ecd88dfc56883717ae4 -#: ../src/Doc/howto/sockets.rst:168 +#: howto/sockets.rst:168 msgid "" "A protocol like HTTP uses a socket for only one transfer. The client sends a " "request, then reads a reply. That's it. The socket is discarded. This means " @@ -8804,7 +8615,7 @@ msgid "" msgstr "" # 47de6a40b8db48a0a0cf1df2e33902a3 -#: ../src/Doc/howto/sockets.rst:172 +#: howto/sockets.rst:172 msgid "" "But if you plan to reuse your socket for further transfers, you need to " "realize that *there is no* :abbr:`EOT (End of Transfer)` *on a socket.* I " @@ -8818,13 +8629,13 @@ msgid "" "choice is entirely yours, (but some ways are righter than others)." msgstr "" -#: ../src/Doc/howto/sockets.rst:183 +#: howto/sockets.rst:183 msgid "" "Assuming you don't want to end the connection, the simplest solution is a " "fixed length message::" msgstr "" -#: ../src/Doc/howto/sockets.rst:220 +#: howto/sockets.rst:220 msgid "" "The sending code here is usable for almost any messaging scheme - in Python " "you send strings, and you can use ``len()`` to determine its length (even if " @@ -8833,7 +8644,7 @@ msgid "" "``strlen`` if the message has embedded ``\\0``\\ s.)" msgstr "" -#: ../src/Doc/howto/sockets.rst:226 +#: howto/sockets.rst:226 msgid "" "The easiest enhancement is to make the first character of the message an " "indicator of message type, and have the type determine the length. Now you " @@ -8844,7 +8655,7 @@ msgid "" "sizes), and scanning what you've received for a delimiter." msgstr "" -#: ../src/Doc/howto/sockets.rst:234 +#: howto/sockets.rst:234 msgid "" "One complication to be aware of: if your conversational protocol allows " "multiple messages to be sent back to back (without some kind of reply), and " @@ -8853,7 +8664,7 @@ msgid "" "until it's needed." msgstr "" -#: ../src/Doc/howto/sockets.rst:240 +#: howto/sockets.rst:240 msgid "" "Prefixing the message with it's length (say, as 5 numeric characters) gets " "more complex, because (believe it or not), you may not get all 5 characters " @@ -8865,18 +8676,18 @@ msgid "" "read this, you will eventually get bit by it!" msgstr "" -#: ../src/Doc/howto/sockets.rst:249 +#: howto/sockets.rst:249 msgid "" "In the interests of space, building your character, (and preserving my " "competitive position), these enhancements are left as an exercise for the " "reader. Lets move on to cleaning up." msgstr "" -#: ../src/Doc/howto/sockets.rst:255 +#: howto/sockets.rst:255 msgid "Binary Data" msgstr "" -#: ../src/Doc/howto/sockets.rst:257 +#: howto/sockets.rst:257 msgid "" "It is perfectly possible to send binary data over a socket. The major " "problem is that not all machines use the same formats for binary data. For " @@ -8889,7 +8700,7 @@ msgid "" "reversed, these swap the bytes around appropriately." msgstr "" -#: ../src/Doc/howto/sockets.rst:267 +#: howto/sockets.rst:267 msgid "" "In these days of 32 bit machines, the ascii representation of binary data is " "frequently smaller than the binary representation. That's because a " @@ -8898,11 +8709,11 @@ msgid "" "doesn't fit well with fixed-length messages. Decisions, decisions." msgstr "" -#: ../src/Doc/howto/sockets.rst:275 +#: howto/sockets.rst:275 msgid "Disconnecting" msgstr "" -#: ../src/Doc/howto/sockets.rst:277 +#: howto/sockets.rst:277 msgid "" "Strictly speaking, you're supposed to use ``shutdown`` on a socket before " "you ``close`` it. The ``shutdown`` is an advisory to the socket at the " @@ -8914,7 +8725,7 @@ msgid "" "``shutdown`` is not needed." msgstr "" -#: ../src/Doc/howto/sockets.rst:285 +#: howto/sockets.rst:285 msgid "" "One way to use ``shutdown`` effectively is in an HTTP-like exchange. The " "client sends a request and then does a ``shutdown(1)``. This tells the " @@ -8924,7 +8735,7 @@ msgid "" "successfully then, indeed, the client was still receiving." msgstr "" -#: ../src/Doc/howto/sockets.rst:292 +#: howto/sockets.rst:292 msgid "" "Python takes the automatic shutdown a step further, and says that when a " "socket is garbage collected, it will automatically do a ``close`` if it's " @@ -8934,11 +8745,11 @@ msgid "" "sockets when you're done." msgstr "" -#: ../src/Doc/howto/sockets.rst:300 +#: howto/sockets.rst:300 msgid "When Sockets Die" msgstr "" -#: ../src/Doc/howto/sockets.rst:302 +#: howto/sockets.rst:302 msgid "" "Probably the worst thing about using blocking sockets is what happens when " "the other side comes down hard (without doing a ``close``). Your socket is " @@ -8953,12 +8764,12 @@ msgid "" "to kill the thread, your whole process is likely to be screwed up." msgstr "" -#: ../src/Doc/howto/sockets.rst:316 +#: howto/sockets.rst:316 msgid "Non-blocking Sockets" msgstr "" # 9eef3c101097417da3a048634c989364 -#: ../src/Doc/howto/sockets.rst:318 +#: howto/sockets.rst:318 msgid "" "If you've understood the preceding, you already know most of what you need " "to know about the mechanics of using sockets. You'll still use the same " @@ -8966,7 +8777,7 @@ msgid "" "will be almost inside-out." msgstr "" -#: ../src/Doc/howto/sockets.rst:323 +#: howto/sockets.rst:323 msgid "" "In Python, you use ``socket.setblocking(0)`` to make it non-blocking. In C, " "it's more complex, (for one thing, you'll need to choose between the BSD " @@ -8976,7 +8787,7 @@ msgid "" "it. (Actually, if you're nuts, you can switch back and forth.)" msgstr "" -#: ../src/Doc/howto/sockets.rst:330 +#: howto/sockets.rst:330 msgid "" "The major mechanical difference is that ``send``, ``recv``, ``connect`` and " "``accept`` can return without having done anything. You have (of course) a " @@ -8986,19 +8797,19 @@ msgid "" "and do it right." msgstr "" -#: ../src/Doc/howto/sockets.rst:337 +#: howto/sockets.rst:337 msgid "Use ``select``." msgstr "" # 7793785b92b841b587d2381b06c5d5d8 -#: ../src/Doc/howto/sockets.rst:339 +#: howto/sockets.rst:339 msgid "" "In C, coding ``select`` is fairly complex. In Python, it's a piece of cake, " "but it's close enough to the C version that if you understand ``select`` in " "Python, you'll have little trouble with it in C::" msgstr "" -#: ../src/Doc/howto/sockets.rst:350 +#: howto/sockets.rst:350 msgid "" "You pass ``select`` three lists: the first contains all sockets that you " "might want to try reading; the second all the sockets you might want to try " @@ -9010,14 +8821,14 @@ msgid "" msgstr "" # a343bae8dd47414082af0aefab04f924 -#: ../src/Doc/howto/sockets.rst:358 +#: howto/sockets.rst:358 msgid "" "In return, you will get three lists. They contain the sockets that are " "actually readable, writable and in error. Each of these lists is a subset " "(possibly empty) of the corresponding list you passed in." msgstr "" -#: ../src/Doc/howto/sockets.rst:362 +#: howto/sockets.rst:362 msgid "" "If a socket is in the output readable list, you can be as-close-to-certain-" "as-we-ever-get-in-this-business that a ``recv`` on that socket will return " @@ -9027,7 +8838,7 @@ msgid "" "it just means outbound network buffer space is available.)" msgstr "" -#: ../src/Doc/howto/sockets.rst:369 +#: howto/sockets.rst:369 msgid "" "If you have a \"server\" socket, put it in the potential_readers list. If it " "comes out in the readable list, your ``accept`` will (almost certainly) " @@ -9036,7 +8847,7 @@ msgid "" "have a decent chance that it has connected." msgstr "" -#: ../src/Doc/howto/sockets.rst:375 +#: howto/sockets.rst:375 msgid "" "One very nasty problem with ``select``: if somewhere in those input lists of " "sockets is one which has died a nasty death, the ``select`` will fail. You " @@ -9045,7 +8856,7 @@ msgid "" "means it won't take long, but it's ugly." msgstr "" -#: ../src/Doc/howto/sockets.rst:381 +#: howto/sockets.rst:381 msgid "" "Actually, ``select`` can be handy even with blocking sockets. It's one way " "of determining whether you will block - the socket returns as readable when " @@ -9054,7 +8865,7 @@ msgid "" "something else." msgstr "" -#: ../src/Doc/howto/sockets.rst:386 +#: howto/sockets.rst:386 msgid "" "**Portability alert**: On Unix, ``select`` works both with the sockets and " "files. Don't try this on Windows. On Windows, ``select`` works with sockets " @@ -9064,11 +8875,11 @@ msgid "" "performance, your code will look very different on Windows than on Unix." msgstr "" -#: ../src/Doc/howto/sockets.rst:395 +#: howto/sockets.rst:395 msgid "Performance" msgstr "" -#: ../src/Doc/howto/sockets.rst:397 +#: howto/sockets.rst:397 msgid "" "There's no question that the fastest sockets code uses non-blocking sockets " "and select to multiplex them. You can put together something that will " @@ -9077,7 +8888,7 @@ msgid "" "be ready to shuffle bytes around at all times." msgstr "" -#: ../src/Doc/howto/sockets.rst:403 +#: howto/sockets.rst:403 msgid "" "Assuming that your app is actually supposed to do something more than that, " "threading is the optimal solution, (and using non-blocking sockets will be " @@ -9090,7 +8901,7 @@ msgid "" "memory and semaphores, to communicate between the parent and child processes." msgstr "" -#: ../src/Doc/howto/sockets.rst:413 +#: howto/sockets.rst:413 msgid "" "Finally, remember that even though blocking sockets are somewhat slower than " "non-blocking, in many cases they are the \"right\" solution. After all, if " @@ -9100,22 +8911,22 @@ msgid "" msgstr "" # 4284717d31514f3889f6b03c1e52a49c -#: ../src/Doc/howto/sorting.rst:4 +#: howto/sorting.rst:4 msgid "Sorting HOW TO" msgstr "" # d7a5018307884c6780bd3920bae9cdd8 -#: ../src/Doc/howto/sorting.rst:6 +#: howto/sorting.rst:6 msgid "Andrew Dalke and Raymond Hettinger" msgstr "" # 670fa45cbaa04a8ba63df9b070da9fc0 -#: ../src/Doc/howto/sorting.rst:7 +#: howto/sorting.rst:7 msgid "0.1" msgstr "" # 367e757cb278492cb65d416195d0b115 -#: ../src/Doc/howto/sorting.rst:10 +#: howto/sorting.rst:10 msgid "" "Python lists have a built-in :meth:`list.sort` method that modifies the list " "in-place. There is also a :func:`sorted` built-in function that builds a " @@ -9123,26 +8934,26 @@ msgid "" msgstr "" # 27622c84f7c947c3988d70b27d5a3feb -#: ../src/Doc/howto/sorting.rst:14 +#: howto/sorting.rst:14 msgid "" "In this document, we explore the various techniques for sorting data using " "Python." msgstr "" # cb1892243c144b9c96dff3a79b08b2ac -#: ../src/Doc/howto/sorting.rst:18 +#: howto/sorting.rst:18 msgid "Sorting Basics" msgstr "" # db6a4b548050492787ab88d2f5291c80 -#: ../src/Doc/howto/sorting.rst:20 +#: howto/sorting.rst:20 msgid "" "A simple ascending sort is very easy: just call the :func:`sorted` function. " "It returns a new sorted list::" msgstr "" # 896c6bad8a05402fa5e80ab54cd98ffc -#: ../src/Doc/howto/sorting.rst:26 +#: howto/sorting.rst:26 msgid "" "You can also use the :meth:`list.sort` method of a list. It modifies the " "list in-place (and returns *None* to avoid confusion). Usually it's less " @@ -9151,19 +8962,19 @@ msgid "" msgstr "" # ca7cb8b097ae42dd9e89c0438e4a5ad0 -#: ../src/Doc/howto/sorting.rst:36 +#: howto/sorting.rst:36 msgid "" "Another difference is that the :meth:`list.sort` method is only defined for " "lists. In contrast, the :func:`sorted` function accepts any iterable." msgstr "" # f4c199239f1b456cb3ca8a330df760ad -#: ../src/Doc/howto/sorting.rst:43 +#: howto/sorting.rst:43 msgid "Key Functions" msgstr "" # 983ae1c53cd548f9a7cfe908066dc496 -#: ../src/Doc/howto/sorting.rst:45 +#: howto/sorting.rst:45 msgid "" "Starting with Python 2.4, both :meth:`list.sort` and :func:`sorted` added a " "*key* parameter to specify a function to be called on each list element " @@ -9171,12 +8982,12 @@ msgid "" msgstr "" # e415d3fdc29449d2ad18d1359c692660 -#: ../src/Doc/howto/sorting.rst:49 +#: howto/sorting.rst:49 msgid "For example, here's a case-insensitive string comparison:" msgstr "" # 0b790213124d4408951802a40f9c89a8 -#: ../src/Doc/howto/sorting.rst:54 +#: howto/sorting.rst:54 msgid "" "The value of the *key* parameter should be a function that takes a single " "argument and returns a key to use for sorting purposes. This technique is " @@ -9184,25 +8995,25 @@ msgid "" msgstr "" # 6cf7c0f828894071b143d85f8747d87a -#: ../src/Doc/howto/sorting.rst:58 +#: howto/sorting.rst:58 msgid "" "A common pattern is to sort complex objects using some of the object's " "indices as keys. For example:" msgstr "" # 777ea18bfefc4093bd2de8dd7aaf5d92 -#: ../src/Doc/howto/sorting.rst:69 +#: howto/sorting.rst:69 msgid "" "The same technique works for objects with named attributes. For example:" msgstr "" # f7131f5aa9794cf485a9702c641f03ad -#: ../src/Doc/howto/sorting.rst:88 +#: howto/sorting.rst:88 msgid "Operator Module Functions" msgstr "" # a7f612173a9844769d26c10f3347aaee -#: ../src/Doc/howto/sorting.rst:90 +#: howto/sorting.rst:90 msgid "" "The key-function patterns shown above are very common, so Python provides " "convenience functions to make accessor functions easier and faster. The " @@ -9212,19 +9023,19 @@ msgid "" msgstr "" # 47c19b22ea784fce8c3b7b706fab7a38 -#: ../src/Doc/howto/sorting.rst:95 +#: howto/sorting.rst:95 msgid "Using those functions, the above examples become simpler and faster:" msgstr "" # 24bcc0055dc14ba692205dda1e48b60b -#: ../src/Doc/howto/sorting.rst:105 +#: howto/sorting.rst:105 msgid "" "The operator module functions allow multiple levels of sorting. For example, " "to sort by *grade* then by *age*:" msgstr "" # c6846cf8541d4dc2b494349d9df5f9ab -#: ../src/Doc/howto/sorting.rst:114 +#: howto/sorting.rst:114 msgid "" "The :func:`operator.methodcaller` function makes method calls with fixed " "parameters for each object being sorted. For example, the :meth:`str.count` " @@ -9233,12 +9044,12 @@ msgid "" msgstr "" # 616d6ee3d69243bda2d0667bfe01e0ae -#: ../src/Doc/howto/sorting.rst:124 +#: howto/sorting.rst:124 msgid "Ascending and Descending" msgstr "" # 60b013093eaf448ea404c21687b85268 -#: ../src/Doc/howto/sorting.rst:126 +#: howto/sorting.rst:126 msgid "" "Both :meth:`list.sort` and :func:`sorted` accept a *reverse* parameter with " "a boolean value. This is used to flag descending sorts. For example, to get " @@ -9246,12 +9057,12 @@ msgid "" msgstr "" # 097321de0759493d82c34c97df177fcb -#: ../src/Doc/howto/sorting.rst:137 +#: howto/sorting.rst:137 msgid "Sort Stability and Complex Sorts" msgstr "" # 15b52a2a732d4ad69bb50cfb4d4f6716 -#: ../src/Doc/howto/sorting.rst:139 +#: howto/sorting.rst:139 msgid "" "Starting with Python 2.2, sorts are guaranteed to be `stable `_\\. That means that when " @@ -9259,14 +9070,14 @@ msgid "" msgstr "" # 4ebcb6dd76e24f8ba237c6ff71194b8f -#: ../src/Doc/howto/sorting.rst:147 +#: howto/sorting.rst:147 msgid "" "Notice how the two records for *blue* retain their original order so that " "``('blue', 1)`` is guaranteed to precede ``('blue', 2)``." msgstr "" # b1b08e6444b944a6b1025f9dff000ee7 -#: ../src/Doc/howto/sorting.rst:150 +#: howto/sorting.rst:150 msgid "" "This wonderful property lets you build complex sorts in a series of sorting " "steps. For example, to sort the student data by descending *grade* and then " @@ -9274,7 +9085,7 @@ msgid "" msgstr "" # 3bdbcc8410704821b6ed557401a2ccc0 -#: ../src/Doc/howto/sorting.rst:158 +#: howto/sorting.rst:158 msgid "" "The `Timsort `_ algorithm used in " "Python does multiple sorts efficiently because it can take advantage of any " @@ -9282,42 +9093,42 @@ msgid "" msgstr "" # 79b92d0704844d5d9bc1b529840924a4 -#: ../src/Doc/howto/sorting.rst:163 +#: howto/sorting.rst:163 msgid "The Old Way Using Decorate-Sort-Undecorate" msgstr "" # 508062ce23484a88ae37b9f2660b2e43 -#: ../src/Doc/howto/sorting.rst:165 +#: howto/sorting.rst:165 msgid "This idiom is called Decorate-Sort-Undecorate after its three steps:" msgstr "" # b371b99cb45e4aee8e39184993763bfb -#: ../src/Doc/howto/sorting.rst:167 +#: howto/sorting.rst:167 msgid "" "First, the initial list is decorated with new values that control the sort " "order." msgstr "" # 3f6c58521d1e48579433b365ac911442 -#: ../src/Doc/howto/sorting.rst:169 +#: howto/sorting.rst:169 msgid "Second, the decorated list is sorted." msgstr "" # af5b5d5f652f499585381f8953b62e83 -#: ../src/Doc/howto/sorting.rst:171 +#: howto/sorting.rst:171 msgid "" "Finally, the decorations are removed, creating a list that contains only the " "initial values in the new order." msgstr "" # ad2458b3badc4fb4bb166e21e6281a12 -#: ../src/Doc/howto/sorting.rst:174 +#: howto/sorting.rst:174 msgid "" "For example, to sort the student data by *grade* using the DSU approach:" msgstr "" # fec9a3f8caa649e19c958a0c14fe8a8a -#: ../src/Doc/howto/sorting.rst:181 +#: howto/sorting.rst:181 msgid "" "This idiom works because tuples are compared lexicographically; the first " "items are compared; if they are the same then the second items are compared, " @@ -9325,21 +9136,21 @@ msgid "" msgstr "" # 3081edc4364142d998f74d2c756591b8 -#: ../src/Doc/howto/sorting.rst:185 +#: howto/sorting.rst:185 msgid "" "It is not strictly necessary in all cases to include the index *i* in the " "decorated list, but including it gives two benefits:" msgstr "" # 8f67149c545a425da7da7362f80412d9 -#: ../src/Doc/howto/sorting.rst:188 +#: howto/sorting.rst:188 msgid "" "The sort is stable -- if two items have the same key, their order will be " "preserved in the sorted list." msgstr "" # b6a667eda2e44cd385bd19085d92ddeb -#: ../src/Doc/howto/sorting.rst:191 +#: howto/sorting.rst:191 msgid "" "The original items do not have to be comparable because the ordering of the " "decorated tuples will be determined by at most the first two items. So for " @@ -9348,7 +9159,7 @@ msgid "" msgstr "" # 7435aabd2ba645dabe1b33148df25ca4 -#: ../src/Doc/howto/sorting.rst:196 +#: howto/sorting.rst:196 msgid "" "Another name for this idiom is `Schwartzian transform `_\\, after Randal L. Schwartz, who " @@ -9356,7 +9167,7 @@ msgid "" msgstr "" # 3560fa1e26cd40768bfb61056dda6e88 -#: ../src/Doc/howto/sorting.rst:200 +#: howto/sorting.rst:200 msgid "" "For large lists and lists where the comparison information is expensive to " "calculate, and Python versions before 2.4, DSU is likely to be the fastest " @@ -9365,12 +9176,12 @@ msgid "" msgstr "" # d3eef37605644be38cdc4fb08128ca57 -#: ../src/Doc/howto/sorting.rst:206 +#: howto/sorting.rst:206 msgid "The Old Way Using the *cmp* Parameter" msgstr "" # 0f0403618175490d931ef2673ff1d97b -#: ../src/Doc/howto/sorting.rst:208 +#: howto/sorting.rst:208 msgid "" "Many constructs given in this HOWTO assume Python 2.4 or later. Before that, " "there was no :func:`sorted` builtin and :meth:`list.sort` took no keyword " @@ -9379,7 +9190,7 @@ msgid "" msgstr "" # dd1854578a0c435f945f478e37b2f76e -#: ../src/Doc/howto/sorting.rst:213 +#: howto/sorting.rst:213 msgid "" "In Python 3, the *cmp* parameter was removed entirely (as part of a larger " "effort to simplify and unify the language, eliminating the conflict between " @@ -9387,7 +9198,7 @@ msgid "" msgstr "" # 78700606a4a94cb18a213c98f9fe6811 -#: ../src/Doc/howto/sorting.rst:217 +#: howto/sorting.rst:217 msgid "" "In Python 2, :meth:`~list.sort` allowed an optional function which can be " "called for doing the comparisons. That function should take two arguments to " @@ -9397,12 +9208,12 @@ msgid "" msgstr "" # 6d23858789884320a68794195c010650 -#: ../src/Doc/howto/sorting.rst:227 +#: howto/sorting.rst:227 msgid "Or you can reverse the order of comparison with:" msgstr "" # b7d66c05f7f14f74a75eb87338458b25 -#: ../src/Doc/howto/sorting.rst:234 +#: howto/sorting.rst:234 msgid "" "When porting code from Python 2.x to 3.x, the situation can arise when you " "have the user supplying a comparison function and you need to convert that " @@ -9410,31 +9221,31 @@ msgid "" msgstr "" # 7a1ee2ce88d543a8ba1bdf4505989e18 -#: ../src/Doc/howto/sorting.rst:257 +#: howto/sorting.rst:257 msgid "To convert to a key function, just wrap the old comparison function:" msgstr "" # 3a7085471278443391dc3572228c7045 -#: ../src/Doc/howto/sorting.rst:262 +#: howto/sorting.rst:262 msgid "" "In Python 2.7, the :func:`functools.cmp_to_key` function was added to the " "functools module." msgstr "" # 5235e46413674c06acca5d257b8a29a3 -#: ../src/Doc/howto/sorting.rst:266 +#: howto/sorting.rst:266 msgid "Odd and Ends" msgstr "" # 92d06d7cbcb843a282ff05b5c38c98c8 -#: ../src/Doc/howto/sorting.rst:268 +#: howto/sorting.rst:268 msgid "" "For locale aware sorting, use :func:`locale.strxfrm` for a key function or :" "func:`locale.strcoll` for a comparison function." msgstr "" # 1f3174fed1cb4f2982f6592227116214 -#: ../src/Doc/howto/sorting.rst:271 +#: howto/sorting.rst:271 msgid "" "The *reverse* parameter still maintains sort stability (so that records with " "equal keys retain their original order). Interestingly, that effect can be " @@ -9443,14 +9254,14 @@ msgid "" msgstr "" # 9dad66f689e04eb8aedf696b5ec6c18f -#: ../src/Doc/howto/sorting.rst:279 +#: howto/sorting.rst:279 msgid "" "To create a standard sort order for a class, just add the appropriate rich " "comparison methods:" msgstr "" # 68ffd8547fec4928a04d3b37ce93650b -#: ../src/Doc/howto/sorting.rst:291 +#: howto/sorting.rst:291 msgid "" "For general purpose comparisons, the recommended approach is to define all " "six rich comparison operators. The :func:`functools.total_ordering` class " @@ -9458,7 +9269,7 @@ msgid "" msgstr "" # e0f7bfa23aaf4771bda22854ff475bf9 -#: ../src/Doc/howto/sorting.rst:295 +#: howto/sorting.rst:295 msgid "" "Key functions need not depend directly on the objects being sorted. A key " "function can also access external resources. For instance, if the student " @@ -9466,32 +9277,32 @@ msgid "" "of student names:" msgstr "" -#: ../src/Doc/howto/unicode.rst:3 +#: howto/unicode.rst:3 msgid "Unicode HOWTO" msgstr "" # f0603228071d4d5b97ad98f6989a055b -#: ../src/Doc/howto/unicode.rst:5 +#: howto/unicode.rst:5 msgid "1.03" msgstr "" # 6031f6ca8abd4bada350990c6475ba09 -#: ../src/Doc/howto/unicode.rst:7 +#: howto/unicode.rst:7 msgid "" "This HOWTO discusses Python 2.x's support for Unicode, and explains various " "problems that people commonly encounter when trying to work with Unicode. " "For the Python 3 version, see ." msgstr "" -#: ../src/Doc/howto/unicode.rst:13 +#: howto/unicode.rst:13 msgid "Introduction to Unicode" msgstr "" -#: ../src/Doc/howto/unicode.rst:16 +#: howto/unicode.rst:16 msgid "History of Character Codes" msgstr "" -#: ../src/Doc/howto/unicode.rst:18 +#: howto/unicode.rst:18 msgid "" "In 1968, the American Standard Code for Information Interchange, better " "known by its acronym ASCII, was standardized. ASCII defined numeric codes " @@ -9499,7 +9310,7 @@ msgid "" "example, the lowercase letter 'a' is assigned 97 as its code value." msgstr "" -#: ../src/Doc/howto/unicode.rst:24 +#: howto/unicode.rst:24 msgid "" "ASCII was an American-developed standard, so it only defined unaccented " "characters. There was an 'e', but no 'é' or 'Í'. This meant that languages " @@ -9509,20 +9320,20 @@ msgid "" "which require spellings such as 'coöperate'.)" msgstr "" -#: ../src/Doc/howto/unicode.rst:31 +#: howto/unicode.rst:31 msgid "" "For a while people just wrote programs that didn't display accents. I " "remember looking at Apple ][ BASIC programs, published in French-language " "publications in the mid-1980s, that had lines like these::" msgstr "" -#: ../src/Doc/howto/unicode.rst:38 +#: howto/unicode.rst:38 msgid "" "Those messages should contain accents, and they just look wrong to someone " "who can read French." msgstr "" -#: ../src/Doc/howto/unicode.rst:41 +#: howto/unicode.rst:41 msgid "" "In the 1980s, almost all personal computers were 8-bit, meaning that bytes " "could hold values ranging from 0 to 255. ASCII codes only went up to 127, " @@ -9535,7 +9346,7 @@ msgid "" msgstr "" # 0ea94b9291bd4774b3398829a5b7384a -#: ../src/Doc/howto/unicode.rst:50 +#: howto/unicode.rst:50 msgid "" "255 characters aren't very many. For example, you can't fit both the " "accented characters used in Western Europe and the Cyrillic alphabet used " @@ -9543,7 +9354,7 @@ msgid "" "characters." msgstr "" -#: ../src/Doc/howto/unicode.rst:54 +#: howto/unicode.rst:54 msgid "" "You could write files using different codes (all your Russian files in a " "coding system called KOI8, all your French files in a different coding " @@ -9552,7 +9363,7 @@ msgid "" "this problem, and the Unicode standardization effort began." msgstr "" -#: ../src/Doc/howto/unicode.rst:60 +#: howto/unicode.rst:60 msgid "" "Unicode started out using 16-bit characters instead of 8-bit characters. 16 " "bits means you have 2^16 = 65,536 distinct values available, making it " @@ -9563,14 +9374,14 @@ msgid "" "codes, 0-1,114,111 (0x10ffff in base-16)." msgstr "" -#: ../src/Doc/howto/unicode.rst:68 +#: howto/unicode.rst:68 msgid "" "There's a related ISO standard, ISO 10646. Unicode and ISO 10646 were " "originally separate efforts, but the specifications were merged with the 1.1 " "revision of Unicode." msgstr "" -#: ../src/Doc/howto/unicode.rst:72 +#: howto/unicode.rst:72 msgid "" "(This discussion of Unicode's history is highly simplified. I don't think " "the average Python programmer needs to worry about the historical details; " @@ -9578,11 +9389,11 @@ msgid "" "information.)" msgstr "" -#: ../src/Doc/howto/unicode.rst:78 +#: howto/unicode.rst:78 msgid "Definitions" msgstr "" -#: ../src/Doc/howto/unicode.rst:80 +#: howto/unicode.rst:80 msgid "" "A **character** is the smallest possible component of a text. 'A', 'B', " "'C', etc., are all different characters. So are 'È' and 'Í'. Characters " @@ -9593,7 +9404,7 @@ msgid "" "different meanings." msgstr "" -#: ../src/Doc/howto/unicode.rst:88 +#: howto/unicode.rst:88 msgid "" "The Unicode standard describes how characters are represented by **code " "points**. A code point is an integer value, usually denoted in base 16. In " @@ -9602,7 +9413,7 @@ msgid "" "lot of tables listing characters and their corresponding code points::" msgstr "" -#: ../src/Doc/howto/unicode.rst:100 +#: howto/unicode.rst:100 msgid "" "Strictly, these definitions imply that it's meaningless to say 'this is " "character U+12ca'. U+12ca is a code point, which represents some particular " @@ -9611,7 +9422,7 @@ msgid "" "characters will sometimes be forgotten." msgstr "" -#: ../src/Doc/howto/unicode.rst:106 +#: howto/unicode.rst:106 msgid "" "A character is represented on a screen or on paper by a set of graphical " "elements that's called a **glyph**. The glyph for an uppercase A, for " @@ -9621,11 +9432,11 @@ msgid "" "generally the job of a GUI toolkit or a terminal's font renderer." msgstr "" -#: ../src/Doc/howto/unicode.rst:115 +#: howto/unicode.rst:115 msgid "Encodings" msgstr "" -#: ../src/Doc/howto/unicode.rst:117 +#: howto/unicode.rst:117 msgid "" "To summarize the previous section: a Unicode string is a sequence of code " "points, which are numbers from 0 to 0x10ffff. This sequence needs to be " @@ -9634,23 +9445,23 @@ msgid "" "an **encoding**." msgstr "" -#: ../src/Doc/howto/unicode.rst:123 +#: howto/unicode.rst:123 msgid "" "The first encoding you might think of is an array of 32-bit integers. In " "this representation, the string \"Python\" would look like this::" msgstr "" -#: ../src/Doc/howto/unicode.rst:130 +#: howto/unicode.rst:130 msgid "" "This representation is straightforward but using it presents a number of " "problems." msgstr "" -#: ../src/Doc/howto/unicode.rst:133 +#: howto/unicode.rst:133 msgid "It's not portable; different processors order the bytes differently." msgstr "" -#: ../src/Doc/howto/unicode.rst:135 +#: howto/unicode.rst:135 msgid "" "It's very wasteful of space. In most texts, the majority of the code points " "are less than 127, or less than 255, so a lot of space is occupied by zero " @@ -9661,19 +9472,19 @@ msgid "" "4 is intolerable." msgstr "" -#: ../src/Doc/howto/unicode.rst:143 +#: howto/unicode.rst:143 msgid "" "It's not compatible with existing C functions such as ``strlen()``, so a new " "family of wide string functions would need to be used." msgstr "" -#: ../src/Doc/howto/unicode.rst:146 +#: howto/unicode.rst:146 msgid "" "Many Internet standards are defined in terms of textual data, and can't " "handle content with embedded zero bytes." msgstr "" -#: ../src/Doc/howto/unicode.rst:149 +#: howto/unicode.rst:149 msgid "" "Generally people don't use this encoding, instead choosing other encodings " "that are more efficient and convenient. UTF-8 is probably the most commonly " @@ -9681,7 +9492,7 @@ msgid "" msgstr "" # cc1dab2c0009444e990243444649463a -#: ../src/Doc/howto/unicode.rst:153 +#: howto/unicode.rst:153 msgid "" "Encodings don't have to handle every possible Unicode character, and most " "encodings don't. For example, Python's default encoding is the 'ascii' " @@ -9689,20 +9500,20 @@ msgid "" "are simple; for each code point:" msgstr "" -#: ../src/Doc/howto/unicode.rst:158 +#: howto/unicode.rst:158 msgid "" "If the code point is < 128, each byte is the same as the value of the code " "point." msgstr "" -#: ../src/Doc/howto/unicode.rst:161 +#: howto/unicode.rst:161 msgid "" "If the code point is 128 or greater, the Unicode string can't be represented " "in this encoding. (Python raises a :exc:`UnicodeEncodeError` exception in " "this case.)" msgstr "" -#: ../src/Doc/howto/unicode.rst:165 +#: howto/unicode.rst:165 msgid "" "Latin-1, also known as ISO-8859-1, is a similar encoding. Unicode code " "points 0-255 are identical to the Latin-1 values, so converting to this " @@ -9711,7 +9522,7 @@ msgid "" "Latin-1." msgstr "" -#: ../src/Doc/howto/unicode.rst:170 +#: howto/unicode.rst:170 msgid "" "Encodings don't have to be simple one-to-one mappings like Latin-1. " "Consider IBM's EBCDIC, which was used on IBM mainframes. Letter values " @@ -9721,7 +9532,7 @@ msgid "" "conversion, but this is largely an internal detail." msgstr "" -#: ../src/Doc/howto/unicode.rst:177 +#: howto/unicode.rst:177 msgid "" "UTF-8 is one of the most commonly used encodings. UTF stands for \"Unicode " "Transformation Format\", and the '8' means that 8-bit numbers are used in " @@ -9729,32 +9540,32 @@ msgid "" "used than UTF-8.) UTF-8 uses the following rules:" msgstr "" -#: ../src/Doc/howto/unicode.rst:182 +#: howto/unicode.rst:182 msgid "" "If the code point is <128, it's represented by the corresponding byte value." msgstr "" -#: ../src/Doc/howto/unicode.rst:183 +#: howto/unicode.rst:183 msgid "" "If the code point is between 128 and 0x7ff, it's turned into two byte values " "between 128 and 255." msgstr "" -#: ../src/Doc/howto/unicode.rst:185 +#: howto/unicode.rst:185 msgid "" "Code points >0x7ff are turned into three- or four-byte sequences, where each " "byte of the sequence is between 128 and 255." msgstr "" -#: ../src/Doc/howto/unicode.rst:188 +#: howto/unicode.rst:188 msgid "UTF-8 has several convenient properties:" msgstr "" -#: ../src/Doc/howto/unicode.rst:190 +#: howto/unicode.rst:190 msgid "It can handle any Unicode code point." msgstr "" -#: ../src/Doc/howto/unicode.rst:191 +#: howto/unicode.rst:191 msgid "" "A Unicode string is turned into a string of bytes containing no embedded " "zero bytes. This avoids byte-ordering issues, and means UTF-8 strings can " @@ -9762,24 +9573,24 @@ msgid "" "that can't handle zero bytes." msgstr "" -#: ../src/Doc/howto/unicode.rst:195 +#: howto/unicode.rst:195 msgid "A string of ASCII text is also valid UTF-8 text." msgstr "" -#: ../src/Doc/howto/unicode.rst:196 +#: howto/unicode.rst:196 msgid "" "UTF-8 is fairly compact; the majority of code points are turned into two " "bytes, and values less than 128 occupy only a single byte." msgstr "" -#: ../src/Doc/howto/unicode.rst:198 +#: howto/unicode.rst:198 msgid "" "If bytes are corrupted or lost, it's possible to determine the start of the " "next UTF-8-encoded code point and resynchronize. It's also unlikely that " "random 8-bit data will look like valid UTF-8." msgstr "" -#: ../src/Doc/howto/unicode.rst:207 +#: howto/unicode.rst:207 msgid "" "The Unicode Consortium site at has character " "charts, a glossary, and PDF versions of the Unicode specification. Be " @@ -9787,14 +9598,14 @@ msgid "" "chronology of the origin and development of Unicode." msgstr "" -#: ../src/Doc/howto/unicode.rst:212 +#: howto/unicode.rst:212 msgid "" "To help understand the standard, Jukka Korpela has written an introductory " "guide to reading the Unicode character tables, available at ." msgstr "" -#: ../src/Doc/howto/unicode.rst:216 +#: howto/unicode.rst:216 msgid "" "Another good introductory article was written by Joel Spolsky . If this introduction didn't make " @@ -9802,30 +9613,30 @@ msgid "" "continuing." msgstr "" -#: ../src/Doc/howto/unicode.rst:223 +#: howto/unicode.rst:223 msgid "" "Wikipedia entries are often helpful; see the entries for \"character encoding" "\" and UTF-8 , for example." msgstr "" -#: ../src/Doc/howto/unicode.rst:229 +#: howto/unicode.rst:229 msgid "Python 2.x's Unicode Support" msgstr "" -#: ../src/Doc/howto/unicode.rst:231 +#: howto/unicode.rst:231 msgid "" "Now that you've learned the rudiments of Unicode, we can look at Python's " "Unicode features." msgstr "" # 95575318bd2e4649acf89c0a0c106253 -#: ../src/Doc/howto/unicode.rst:236 +#: howto/unicode.rst:236 msgid "The Unicode Type" msgstr "" # bc0af3d4b7124b2089f24fa1af29d6f7 -#: ../src/Doc/howto/unicode.rst:238 +#: howto/unicode.rst:238 msgid "" "Unicode strings are expressed as instances of the :class:`unicode` type, one " "of Python's repertoire of built-in types. It derives from an abstract type " @@ -9837,7 +9648,7 @@ msgid "" msgstr "" # 06830998a1d645369f452933d329fe7b -#: ../src/Doc/howto/unicode.rst:245 +#: howto/unicode.rst:245 msgid "" "The :func:`unicode` constructor has the signature ``unicode(string[, " "encoding, errors])``. All of its arguments should be 8-bit strings. The " @@ -9847,7 +9658,7 @@ msgid "" msgstr "" # 973b548a3a514d67a576ce9f755f76a2 -#: ../src/Doc/howto/unicode.rst:262 +#: howto/unicode.rst:262 msgid "" "The ``errors`` argument specifies the response when the input string can't " "be converted according to the encoding's rules. Legal values for this " @@ -9858,7 +9669,7 @@ msgid "" msgstr "" # 75eddfe198e84048b080ba7ebf56dc89 -#: ../src/Doc/howto/unicode.rst:278 +#: howto/unicode.rst:278 msgid "" "Encodings are specified as strings containing the encoding's name. Python " "2.7 comes with roughly 100 different encodings; see the Python Library " @@ -9868,7 +9679,7 @@ msgid "" msgstr "" # 3ba978cc66d64b6fa4037baa1804e478 -#: ../src/Doc/howto/unicode.rst:284 +#: howto/unicode.rst:284 msgid "" "One-character Unicode strings can also be created with the :func:`unichr` " "built-in function, which takes integers and returns a Unicode string of " @@ -9878,14 +9689,14 @@ msgid "" msgstr "" # c9bf561bc2b44496a8ddac22e192fd73 -#: ../src/Doc/howto/unicode.rst:295 +#: howto/unicode.rst:295 msgid "" "Instances of the :class:`unicode` type have many of the same methods as the " "8-bit string type for operations such as searching and formatting::" msgstr "" # 0dbbed0604464c668161c390fce70bf1 -#: ../src/Doc/howto/unicode.rst:310 +#: howto/unicode.rst:310 msgid "" "Note that the arguments to these methods can be Unicode strings or 8-bit " "strings. 8-bit strings will be converted to Unicode before carrying out the " @@ -9894,7 +9705,7 @@ msgid "" msgstr "" # 9469a4c5d759425693d496fd2ad0ca43 -#: ../src/Doc/howto/unicode.rst:323 +#: howto/unicode.rst:323 msgid "" "Much Python code that operates on strings will therefore work with Unicode " "strings without requiring any changes to the code. (Input and output code " @@ -9902,7 +9713,7 @@ msgid "" msgstr "" # 78df166292b2405ea61b49d3267ab19e -#: ../src/Doc/howto/unicode.rst:327 +#: howto/unicode.rst:327 msgid "" "Another important method is ``.encode([encoding], [errors='strict'])``, " "which returns an 8-bit string version of the Unicode string, encoded in the " @@ -9914,13 +9725,13 @@ msgid "" msgstr "" # 8b4c285a06cc404a9452289a42772537 -#: ../src/Doc/howto/unicode.rst:349 +#: howto/unicode.rst:349 msgid "" "Python's 8-bit strings have a ``.decode([encoding], [errors])`` method that " "interprets the string using the given encoding::" msgstr "" -#: ../src/Doc/howto/unicode.rst:360 +#: howto/unicode.rst:360 msgid "" "The low-level routines for registering and accessing the available encodings " "are found in the :mod:`codecs` module. However, the encoding and decoding " @@ -9933,18 +9744,18 @@ msgid "" msgstr "" # 6c38b4db0a664cc686b387b1bf7c54a2 -#: ../src/Doc/howto/unicode.rst:368 +#: howto/unicode.rst:368 msgid "" "The most commonly used part of the :mod:`codecs` module is the :func:`codecs." "open` function which will be discussed in the section on input and output." msgstr "" -#: ../src/Doc/howto/unicode.rst:374 +#: howto/unicode.rst:374 msgid "Unicode Literals in Python Source Code" msgstr "" # d0d2d155594c4d89ae17867aa5455b1b -#: ../src/Doc/howto/unicode.rst:376 +#: howto/unicode.rst:376 msgid "" "In Python source code, Unicode literals are written as strings prefixed with " "the 'u' or 'U' character: ``u'abcdefghijk'``. Specific code points can be " @@ -9954,7 +9765,7 @@ msgid "" msgstr "" # 89cdfead9b054e709b24341f6d5e1b82 -#: ../src/Doc/howto/unicode.rst:382 +#: howto/unicode.rst:382 msgid "" "Unicode literals can also use the same escape sequences as 8-bit strings, " "including ``\\x``, but ``\\x`` only takes two hex digits so it can't express " @@ -9963,7 +9774,7 @@ msgid "" msgstr "" # 109ec1dceb734e6c8ef02ea4cf155a8d -#: ../src/Doc/howto/unicode.rst:396 +#: howto/unicode.rst:396 msgid "" "Using escape sequences for code points greater than 127 is fine in small " "doses, but becomes an annoyance if you're using many accented characters, as " @@ -9972,7 +9783,7 @@ msgid "" "function, but this is even more tedious." msgstr "" -#: ../src/Doc/howto/unicode.rst:402 +#: howto/unicode.rst:402 msgid "" "Ideally, you'd want to be able to write literals in your language's natural " "encoding. You could then edit Python source code with your favorite editor " @@ -9981,14 +9792,14 @@ msgid "" msgstr "" # 44e69958fa7a40c294a02b4da16484f3 -#: ../src/Doc/howto/unicode.rst:407 +#: howto/unicode.rst:407 msgid "" "Python supports writing Unicode literals in any encoding, but you have to " "declare the encoding being used. This is done by including a special " "comment as either the first or second line of the source file::" msgstr "" -#: ../src/Doc/howto/unicode.rst:417 +#: howto/unicode.rst:417 msgid "" "The syntax is inspired by Emacs's notation for specifying variables local to " "a file. Emacs supports many different variables, but Python only supports " @@ -9998,7 +9809,7 @@ msgid "" msgstr "" # d947639e88ad4416b1710e017ab69960 -#: ../src/Doc/howto/unicode.rst:423 +#: howto/unicode.rst:423 msgid "" "If you don't include such a comment, the default encoding used will be " "ASCII. Versions of Python before 2.4 were Euro-centric and assumed Latin-1 " @@ -10008,20 +9819,20 @@ msgid "" msgstr "" # 723712f415c441e384800fc48cfef3bf -#: ../src/Doc/howto/unicode.rst:433 +#: howto/unicode.rst:433 msgid "When you run it with Python 2.4, it will output the following warning::" msgstr "" # b2a10168b08b46e2a4401359f5a3e9f5 -#: ../src/Doc/howto/unicode.rst:440 +#: howto/unicode.rst:440 msgid "Python 2.5 and higher are stricter and will produce a syntax error::" msgstr "" -#: ../src/Doc/howto/unicode.rst:450 +#: howto/unicode.rst:450 msgid "Unicode Properties" msgstr "" -#: ../src/Doc/howto/unicode.rst:452 +#: howto/unicode.rst:452 msgid "" "The Unicode specification includes a database of information about code " "points. For each code point that's defined, the information includes the " @@ -10031,17 +9842,17 @@ msgid "" "in bidirectional text and other display-related properties." msgstr "" -#: ../src/Doc/howto/unicode.rst:459 +#: howto/unicode.rst:459 msgid "" "The following program displays some information about several characters, " "and prints the numeric value of one particular character::" msgstr "" -#: ../src/Doc/howto/unicode.rst:473 +#: howto/unicode.rst:473 msgid "When run, this prints::" msgstr "" -#: ../src/Doc/howto/unicode.rst:482 +#: howto/unicode.rst:482 msgid "" "The category codes are abbreviations describing the nature of the character. " "These are grouped into categories such as \"Letter\", \"Number\", " @@ -10053,22 +9864,22 @@ msgid "" msgstr "" # 8c87d97a3fc04021837431c59183b511 -#: ../src/Doc/howto/unicode.rst:494 +#: howto/unicode.rst:494 msgid "" "The Unicode and 8-bit string types are described in the Python library " "reference at :ref:`typesseq`." msgstr "" -#: ../src/Doc/howto/unicode.rst:497 +#: howto/unicode.rst:497 msgid "The documentation for the :mod:`unicodedata` module." msgstr "" -#: ../src/Doc/howto/unicode.rst:499 +#: howto/unicode.rst:499 msgid "The documentation for the :mod:`codecs` module." msgstr "" # dce90c14394a4c8787c1696da2757602 -#: ../src/Doc/howto/unicode.rst:501 +#: howto/unicode.rst:501 msgid "" "Marc-André Lemburg gave a presentation at EuroPython 2002 titled \"Python " "and Unicode\". A PDF version of his slides is available at 127. A second tip, therefore, is:" msgstr "" -#: ../src/Doc/howto/unicode.rst:656 +#: howto/unicode.rst:656 msgid "" "Include characters > 127 and, even better, characters > 255 in your test " "data." msgstr "" -#: ../src/Doc/howto/unicode.rst:659 +#: howto/unicode.rst:659 msgid "" "When using data coming from a web browser or some other untrusted source, a " "common technique is to check for illegal characters in a string before using " @@ -10283,14 +10094,14 @@ msgid "" "single character." msgstr "" -#: ../src/Doc/howto/unicode.rst:668 +#: howto/unicode.rst:668 msgid "" "For example, let's say you have a content management system that takes a " "Unicode filename, and you want to disallow paths with a '/' character. You " "might write this code::" msgstr "" -#: ../src/Doc/howto/unicode.rst:679 +#: howto/unicode.rst:679 msgid "" "However, if an attacker could specify the ``'base64'`` encoding, they could " "pass ``'L2V0Yy9wYXNzd2Q='``, which is the base-64 encoded form of the string " @@ -10300,7 +10111,7 @@ msgid "" msgstr "" # ab5c90b2c2974f19b4e2a6b7c26ebb61 -#: ../src/Doc/howto/unicode.rst:688 +#: howto/unicode.rst:688 msgid "" "The PDF slides for Marc-André Lemburg's presentation \"Writing Unicode-aware " "Applications in Python\" are available at `_" msgstr "" # 53960c1e8aec49f2bffda275f14d2a84 -#: ../src/Doc/howto/urllib2.rst:9 +#: howto/urllib2.rst:9 msgid "" "There is an French translation of an earlier revision of this HOWTO, " "available at `urllib2 - Le Manuel manquant `_." msgstr "" +#: howto/urllib2.rst:0 +msgid "Related Articles" +msgstr "" + # 37ffef111acd4e24b36c46b02dd190c8 -#: ../src/Doc/howto/urllib2.rst:20 +#: howto/urllib2.rst:20 msgid "" "You may also find useful the following article on fetching web resources " "with Python:" msgstr "" -#: ../src/Doc/howto/urllib2.rst:23 +#: howto/urllib2.rst:23 msgid "" "`Basic Authentication `_" msgstr "" -#: ../src/Doc/howto/urllib2.rst:25 +#: howto/urllib2.rst:25 msgid "A tutorial on *Basic Authentication*, with examples in Python." msgstr "" # f32bd4d9d7b347e9b240b3060e6ed1d6 -#: ../src/Doc/howto/urllib2.rst:27 +#: howto/urllib2.rst:27 msgid "" "**urllib2** is a Python module for fetching URLs (Uniform Resource " "Locators). It offers a very simple interface, in the form of the *urlopen* " @@ -10383,7 +10198,7 @@ msgid "" msgstr "" # 18f5db69f47a400a84f93efb6f771cf9 -#: ../src/Doc/howto/urllib2.rst:34 +#: howto/urllib2.rst:34 msgid "" "urllib2 supports fetching URLs for many \"URL schemes\" (identified by the " "string before the \":\" in URL - for example \"ftp\" is the URL scheme of " @@ -10392,7 +10207,7 @@ msgid "" msgstr "" # a2461a4aaf8241beaae755dd9678ff93 -#: ../src/Doc/howto/urllib2.rst:39 +#: howto/urllib2.rst:39 msgid "" "For straightforward situations *urlopen* is very easy to use. But as soon as " "you encounter errors or non-trivial cases when opening HTTP URLs, you will " @@ -10404,17 +10219,17 @@ msgid "" "supplementary to them." msgstr "" -#: ../src/Doc/howto/urllib2.rst:49 +#: howto/urllib2.rst:49 msgid "Fetching URLs" msgstr "" # 824d055376664e5799516dfaf81e53dc -#: ../src/Doc/howto/urllib2.rst:51 +#: howto/urllib2.rst:51 msgid "The simplest way to use urllib2 is as follows::" msgstr "" # 0a6c7e6f4cd14a368ec9f7f1e5868ad6 -#: ../src/Doc/howto/urllib2.rst:57 +#: howto/urllib2.rst:57 msgid "" "Many uses of urllib2 will be that simple (note that instead of an 'http:' " "URL we could have used an URL starting with 'ftp:', 'file:', etc.). " @@ -10423,7 +10238,7 @@ msgid "" msgstr "" # 2c4d8714f18b49a6b7955a6a930c2d7e -#: ../src/Doc/howto/urllib2.rst:62 +#: howto/urllib2.rst:62 msgid "" "HTTP is based on requests and responses - the client makes requests and " "servers send responses. urllib2 mirrors this with a ``Request`` object which " @@ -10435,13 +10250,13 @@ msgid "" msgstr "" # df9c25fa0174438db81b2f330e060ef4 -#: ../src/Doc/howto/urllib2.rst:76 +#: howto/urllib2.rst:76 msgid "" "Note that urllib2 makes use of the same Request interface to handle all URL " "schemes. For example, you can make an FTP request like so::" msgstr "" -#: ../src/Doc/howto/urllib2.rst:81 +#: howto/urllib2.rst:81 msgid "" "In the case of HTTP, there are two extra things that Request objects allow " "you to do: First, you can pass data to be sent to the server. Second, you " @@ -10450,12 +10265,12 @@ msgid "" "\". Let's look at each of these in turn." msgstr "" -#: ../src/Doc/howto/urllib2.rst:88 +#: howto/urllib2.rst:88 msgid "Data" msgstr "" # bc401d47aca24bae9d59fadfeafc3e3a -#: ../src/Doc/howto/urllib2.rst:90 +#: howto/urllib2.rst:90 msgid "" "Sometimes you want to send data to a URL (often the URL will refer to a CGI " "(Common Gateway Interface) script [#]_ or other web application). With HTTP, " @@ -10468,7 +10283,7 @@ msgid "" "function from the ``urllib`` library *not* from ``urllib2``. ::" msgstr "" -#: ../src/Doc/howto/urllib2.rst:113 +#: howto/urllib2.rst:113 msgid "" "Note that other encodings are sometimes required (e.g. for file upload from " "HTML forms - see `HTML Specification, Form Submission `_." msgstr "" -# 885c869c7df740f8b915b13fba3ce070 -#: ../src/Doc/howto/urllib2.rst:562 -msgid "" -"Like Google for example. The *proper* way to use google from a program is to " -"use `PyGoogle `_ of course." +#: howto/urllib2.rst:562 +msgid "Google for example." msgstr "" -#: ../src/Doc/howto/urllib2.rst:564 +#: howto/urllib2.rst:563 msgid "" "Browser sniffing is a very bad practise for website design - building sites " "using web standards is much more sensible. Unfortunately a lot of sites " "still send different versions to different browsers." msgstr "" -#: ../src/Doc/howto/urllib2.rst:567 +#: howto/urllib2.rst:566 msgid "" "The user agent for MSIE 6 is *'Mozilla/4.0 (compatible; MSIE 6.0; Windows NT " "5.1; SV1; .NET CLR 1.1.4322)'*" msgstr "" -#: ../src/Doc/howto/urllib2.rst:569 +#: howto/urllib2.rst:568 msgid "" "For details of more HTTP request headers, see `Quick Reference to HTTP " "Headers`_." msgstr "" # 5d228402a5104663b6c4dc5842307541 -#: ../src/Doc/howto/urllib2.rst:571 +#: howto/urllib2.rst:570 msgid "" "In my case I have to use a proxy to access the internet at work. If you " "attempt to fetch *localhost* URLs through this proxy it blocks them. IE is " @@ -10897,28 +10709,28 @@ msgid "" msgstr "" # b1baf60a72034136bf1db086e6a9a99e -#: ../src/Doc/howto/urllib2.rst:576 +#: howto/urllib2.rst:575 msgid "" "urllib2 opener for SSL proxy (CONNECT method): `ASPN Cookbook Recipe `_." msgstr "" -#: ../src/Doc/howto/webservers.rst:3 +#: howto/webservers.rst:3 msgid "HOWTO Use Python in the web" msgstr "" -#: ../src/Doc/howto/webservers.rst:5 +#: howto/webservers.rst:5 msgid "Marek Kubica" msgstr "" -#: ../src/Doc/howto/webservers.rst:9 +#: howto/webservers.rst:9 msgid "" "This document shows how Python fits into the web. It presents some ways to " "integrate Python with a web server, and general practices useful for " "developing web sites." msgstr "" -#: ../src/Doc/howto/webservers.rst:14 +#: howto/webservers.rst:14 msgid "" "Programming for the Web has become a hot topic since the rise of \"Web " "2.0\", which focuses on user-generated content on web sites. It has always " @@ -10932,7 +10744,7 @@ msgid "" msgstr "" # 9b6eb4bd2e8b41919d5a554c0663036a -#: ../src/Doc/howto/webservers.rst:26 +#: howto/webservers.rst:26 msgid "" "While this HOWTO tries to give an overview of Python in the web, it cannot " "always be as up to date as desired. Web development in Python is rapidly " @@ -10940,11 +10752,11 @@ msgid "" "org/moin/WebProgramming>`_ may be more in sync with recent development." msgstr "" -#: ../src/Doc/howto/webservers.rst:34 +#: howto/webservers.rst:34 msgid "The Low-Level View" msgstr "" -#: ../src/Doc/howto/webservers.rst:36 +#: howto/webservers.rst:36 msgid "" "When a user enters a web site, their browser makes a connection to the " "site's web server (this is called the *request*). The server looks up the " @@ -10953,7 +10765,7 @@ msgid "" "protocol, HTTP, works." msgstr "" -#: ../src/Doc/howto/webservers.rst:41 +#: howto/webservers.rst:41 msgid "" "Dynamic web sites are not based on files in the file system, but rather on " "programs which are run by the web server when a request comes in, and which " @@ -10964,7 +10776,7 @@ msgid "" "servers support Python, it is easy to use Python to create dynamic web sites." msgstr "" -#: ../src/Doc/howto/webservers.rst:49 +#: howto/webservers.rst:49 msgid "" "Most HTTP servers are written in C or C++, so they cannot execute Python " "code directly -- a bridge is needed between the server and the program. " @@ -10973,18 +10785,18 @@ msgid "" "interface, but there are only a few worth mentioning." msgstr "" -#: ../src/Doc/howto/webservers.rst:55 +#: howto/webservers.rst:55 msgid "" "Not every web server supports every interface. Many web servers only " "support old, now-obsolete interfaces; however, they can often be extended " "using third-party modules to support newer ones." msgstr "" -#: ../src/Doc/howto/webservers.rst:61 +#: howto/webservers.rst:61 msgid "Common Gateway Interface" msgstr "" -#: ../src/Doc/howto/webservers.rst:63 +#: howto/webservers.rst:63 msgid "" "This interface, most commonly referred to as \"CGI\", is the oldest, and is " "supported by nearly every web server out of the box. Programs using CGI to " @@ -10994,14 +10806,14 @@ msgid "" "load situations." msgstr "" -#: ../src/Doc/howto/webservers.rst:70 +#: howto/webservers.rst:70 msgid "" "The upside of CGI is that it is simple -- writing a Python program which " "uses CGI is a matter of about three lines of code. This simplicity comes at " "a price: it does very few things to help the developer." msgstr "" -#: ../src/Doc/howto/webservers.rst:74 +#: howto/webservers.rst:74 msgid "" "Writing CGI programs, while still possible, is no longer recommended. With :" "ref:`WSGI `, a topic covered later in this document, it is possible to " @@ -11009,47 +10821,47 @@ msgid "" "option is available." msgstr "" -#: ../src/Doc/howto/webservers.rst:81 +#: howto/webservers.rst:81 msgid "" "The Python standard library includes some modules that are helpful for " "creating plain CGI programs:" msgstr "" -#: ../src/Doc/howto/webservers.rst:84 +#: howto/webservers.rst:84 msgid ":mod:`cgi` -- Handling of user input in CGI scripts" msgstr "" -#: ../src/Doc/howto/webservers.rst:85 +#: howto/webservers.rst:85 msgid "" ":mod:`cgitb` -- Displays nice tracebacks when errors happen in CGI " "applications, instead of presenting a \"500 Internal Server Error\" message" msgstr "" # 24a5193d701f40b58c257244970fee65 -#: ../src/Doc/howto/webservers.rst:88 +#: howto/webservers.rst:88 msgid "" "The Python wiki features a page on `CGI scripts `_ with some additional information about CGI in Python." msgstr "" -#: ../src/Doc/howto/webservers.rst:94 +#: howto/webservers.rst:94 msgid "Simple script for testing CGI" msgstr "" -#: ../src/Doc/howto/webservers.rst:96 +#: howto/webservers.rst:96 msgid "" "To test whether your web server works with CGI, you can use this short and " "simple CGI program::" msgstr "" -#: ../src/Doc/howto/webservers.rst:111 +#: howto/webservers.rst:111 msgid "" "Depending on your web server configuration, you may need to save this code " "with a ``.py`` or ``.cgi`` extension. Additionally, this file may also need " "to be in a ``cgi-bin`` folder, for security reasons." msgstr "" -#: ../src/Doc/howto/webservers.rst:115 +#: howto/webservers.rst:115 msgid "" "You might wonder what the ``cgitb`` line is about. This line makes it " "possible to display a nice traceback instead of just crashing and displaying " @@ -11060,11 +10872,11 @@ msgid "" "like to see nondescript \"Internal Server Errors\" in their browsers." msgstr "" -#: ../src/Doc/howto/webservers.rst:125 +#: howto/webservers.rst:125 msgid "Setting up CGI on your own server" msgstr "" -#: ../src/Doc/howto/webservers.rst:127 +#: howto/webservers.rst:127 msgid "" "If you don't have your own web server, this does not apply to you. You can " "check whether it works as-is, and if not you will need to talk to the " @@ -11072,7 +10884,7 @@ msgid "" "ticket asking for Python support." msgstr "" -#: ../src/Doc/howto/webservers.rst:132 +#: howto/webservers.rst:132 msgid "" "If you are your own administrator or want to set up CGI for testing purposes " "on your own computers, you have to configure it by yourself. There is no " @@ -11086,7 +10898,7 @@ msgid "" "compiling the web server may not be needed." msgstr "" -#: ../src/Doc/howto/webservers.rst:143 +#: howto/webservers.rst:143 msgid "" "On Apache you can take a look at the `Dynamic Content with CGI `_ tutorial, where everything is " @@ -11095,29 +10907,29 @@ msgid "" msgstr "" # 60997289570c43509daf0ed08881da82 -#: ../src/Doc/howto/webservers.rst:148 +#: howto/webservers.rst:148 msgid "" "On lighttpd you need to use the `CGI module `_\\ , which can be configured in a " "straightforward way. It boils down to setting ``cgi.assign`` properly." msgstr "" -#: ../src/Doc/howto/webservers.rst:154 +#: howto/webservers.rst:154 msgid "Common problems with CGI scripts" msgstr "" -#: ../src/Doc/howto/webservers.rst:156 +#: howto/webservers.rst:156 msgid "" "Using CGI sometimes leads to small annoyances while trying to get these " "scripts to run. Sometimes a seemingly correct script does not work as " "expected, the cause being some small hidden problem that's difficult to spot." msgstr "" -#: ../src/Doc/howto/webservers.rst:160 +#: howto/webservers.rst:160 msgid "Some of these potential problems are:" msgstr "" -#: ../src/Doc/howto/webservers.rst:162 +#: howto/webservers.rst:162 msgid "" "The Python script is not marked as executable. When CGI scripts are not " "executable most web servers will let the user download it, instead of " @@ -11126,7 +10938,7 @@ msgid "" "Using ``chmod a+x your_script.py`` may solve this problem." msgstr "" -#: ../src/Doc/howto/webservers.rst:168 +#: howto/webservers.rst:168 msgid "" "On a Unix-like system, The line endings in the program file must be Unix " "style line endings. This is important because the web server checks the " @@ -11139,7 +10951,7 @@ msgid "" "endings. Most editors support this." msgstr "" -#: ../src/Doc/howto/webservers.rst:178 +#: howto/webservers.rst:178 msgid "" "Your web server must be able to read the file, and you need to make sure the " "permissions are correct. On unix-like systems, the server often runs as " @@ -11148,14 +10960,14 @@ msgid "" "your_script.py``." msgstr "" -#: ../src/Doc/howto/webservers.rst:184 +#: howto/webservers.rst:184 msgid "" "The web server must know that the file you're trying to access is a CGI " "script. Check the configuration of your web server, as it may be configured " "to expect a specific file extension for CGI scripts." msgstr "" -#: ../src/Doc/howto/webservers.rst:188 +#: howto/webservers.rst:188 msgid "" "On Unix-like systems, the path to the interpreter in the shebang (``#!/usr/" "bin/env python``) must be correct. This line calls ``/usr/bin/env`` to find " @@ -11166,7 +10978,7 @@ msgid "" "path, you can change the shebang accordingly: ``#!/usr/bin/python``." msgstr "" -#: ../src/Doc/howto/webservers.rst:197 +#: howto/webservers.rst:197 msgid "" "The file must not contain a BOM (Byte Order Mark). The BOM is meant for " "determining the byte order of UTF-16 and UTF-32 encodings, but some editors " @@ -11174,19 +10986,19 @@ msgid "" "so be sure to tell your editor not to write the BOM." msgstr "" -#: ../src/Doc/howto/webservers.rst:202 +#: howto/webservers.rst:202 msgid "" "If the web server is using :ref:`mod-python`, ``mod_python`` may be having " "problems. ``mod_python`` is able to handle CGI scripts by itself, but it " "can also be a source of issues." msgstr "" -#: ../src/Doc/howto/webservers.rst:210 +#: howto/webservers.rst:210 msgid "mod_python" msgstr "mod_python" # 5e8b17673bd84a4887bbc10218a01eeb -#: ../src/Doc/howto/webservers.rst:212 +#: howto/webservers.rst:212 msgid "" "People coming from PHP often find it hard to grasp how to use Python in the " "web. Their first thought is mostly `mod_python `_\\ , " @@ -11203,7 +11015,7 @@ msgid "" "what to do with them." msgstr "" -#: ../src/Doc/howto/webservers.rst:225 +#: howto/webservers.rst:225 msgid "" "``mod_python`` does have some problems. Unlike the PHP interpreter, the " "Python interpreter uses caching when executing files, so changes to a file " @@ -11218,7 +11030,7 @@ msgid "" "for ``mod_python`` cannot easily run on other web servers." msgstr "" -#: ../src/Doc/howto/webservers.rst:237 +#: howto/webservers.rst:237 msgid "" "These are the reasons why ``mod_python`` should be avoided when writing new " "programs. In some circumstances it still might be a good idea to use " @@ -11226,11 +11038,11 @@ msgid "" "programs under ``mod_python`` as well." msgstr "" -#: ../src/Doc/howto/webservers.rst:244 +#: howto/webservers.rst:244 msgid "FastCGI and SCGI" msgstr "" -#: ../src/Doc/howto/webservers.rst:246 +#: howto/webservers.rst:246 msgid "" "FastCGI and SCGI try to solve the performance problem of CGI in another way. " "Instead of embedding the interpreter into the web server, they create long-" @@ -11241,7 +11053,7 @@ msgid "" "a library which handles the communication with the webserver." msgstr "" -#: ../src/Doc/howto/webservers.rst:254 +#: howto/webservers.rst:254 msgid "" "The difference between FastCGI and SCGI is very small, as SCGI is " "essentially just a \"simpler FastCGI\". As the web server support for SCGI " @@ -11250,22 +11062,22 @@ msgid "" "we'll only cover the latter." msgstr "" -#: ../src/Doc/howto/webservers.rst:260 +#: howto/webservers.rst:260 msgid "" "These days, FastCGI is never used directly. Just like ``mod_python``, it is " "only used for the deployment of WSGI applications." msgstr "" -#: ../src/Doc/howto/webservers.rst:265 +#: howto/webservers.rst:265 msgid "Setting up FastCGI" msgstr "" -#: ../src/Doc/howto/webservers.rst:267 +#: howto/webservers.rst:267 msgid "Each web server requires a specific module." msgstr "" # 31d3a58613b2473ab67ec0c40162146b -#: ../src/Doc/howto/webservers.rst:269 +#: howto/webservers.rst:269 msgid "" "Apache has both `mod_fastcgi `_ and " "`mod_fcgid `_. ``mod_fastcgi`` is the " @@ -11275,27 +11087,27 @@ msgid "" msgstr "" # 5d114d0b485c4eeb93c1488203ba552c -#: ../src/Doc/howto/webservers.rst:275 +#: howto/webservers.rst:275 msgid "" "lighttpd ships its own `FastCGI module `_ as well as an `SCGI module `_." msgstr "" -#: ../src/Doc/howto/webservers.rst:279 +#: howto/webservers.rst:279 msgid "" "`nginx `_ also supports `FastCGI `_." msgstr "" -#: ../src/Doc/howto/webservers.rst:282 +#: howto/webservers.rst:282 msgid "" "Once you have installed and configured the module, you can test it with the " "following WSGI-application::" msgstr "" # a57cb42d937140709d0a05581462253a -#: ../src/Doc/howto/webservers.rst:303 +#: howto/webservers.rst:303 msgid "" "This is a simple WSGI application, but you need to install `flup `_ first, as flup handles the low level " @@ -11303,7 +11115,7 @@ msgid "" msgstr "" # 281193186bff42e893d6465dafb25cb7 -#: ../src/Doc/howto/webservers.rst:309 +#: howto/webservers.rst:309 msgid "" "There is some documentation on `setting up Django with FastCGI `_, most of which can be " @@ -11312,11 +11124,11 @@ msgid "" "Django does more or less the exact same thing." msgstr "" -#: ../src/Doc/howto/webservers.rst:317 +#: howto/webservers.rst:317 msgid "mod_wsgi" msgstr "" -#: ../src/Doc/howto/webservers.rst:319 +#: howto/webservers.rst:319 msgid "" "`mod_wsgi `_ is an attempt to get rid of " "the low level gateways. Given that FastCGI, SCGI, and mod_python are mostly " @@ -11329,7 +11141,7 @@ msgid "" "mod_wsgi." msgstr "" -#: ../src/Doc/howto/webservers.rst:328 +#: howto/webservers.rst:328 msgid "" "mod_wsgi supports two modes: embedded mode, in which it integrates with the " "Apache process, and daemon mode, which is more FastCGI-like. Unlike " @@ -11337,17 +11149,17 @@ msgid "" "administration easier." msgstr "" -#: ../src/Doc/howto/webservers.rst:337 +#: howto/webservers.rst:337 msgid "Step back: WSGI" msgstr "" -#: ../src/Doc/howto/webservers.rst:339 +#: howto/webservers.rst:339 msgid "" "WSGI has already been mentioned several times, so it has to be something " "important. In fact it really is, and now it is time to explain it." msgstr "" -#: ../src/Doc/howto/webservers.rst:342 +#: howto/webservers.rst:342 msgid "" "The *Web Server Gateway Interface*, or WSGI for short, is defined in :pep:" "`333` and is currently the best way to do Python web programming. While it " @@ -11356,7 +11168,7 @@ msgid "" "development it is a good idea to choose one which supports WSGI." msgstr "" -#: ../src/Doc/howto/webservers.rst:348 +#: howto/webservers.rst:348 msgid "" "The big benefit of WSGI is the unification of the application programming " "interface. When your program is compatible with WSGI -- which at the outer " @@ -11370,7 +11182,7 @@ msgid "" msgstr "" # 7cc3b099af6345369e4e70cf8ab96afb -#: ../src/Doc/howto/webservers.rst:358 +#: howto/webservers.rst:358 msgid "" "A really great WSGI feature is middleware. Middleware is a layer around " "your program which can add various functionality to it. There is quite a " @@ -11385,18 +11197,18 @@ msgid "" "another a problem easily solved using existing middleware." msgstr "" -#: ../src/Doc/howto/webservers.rst:370 +#: howto/webservers.rst:370 msgid "" "Although WSGI may seem complex, the initial phase of learning can be very " "rewarding because WSGI and the associated middleware already have solutions " "to many problems that might arise while developing web sites." msgstr "" -#: ../src/Doc/howto/webservers.rst:376 +#: howto/webservers.rst:376 msgid "WSGI Servers" msgstr "" -#: ../src/Doc/howto/webservers.rst:378 +#: howto/webservers.rst:378 msgid "" "The code that is used to connect to various low level gateways like CGI or " "mod_python is called a *WSGI server*. One of these servers is ``flup``, " @@ -11406,7 +11218,7 @@ msgid "" "be used as drop-in replacements." msgstr "" -#: ../src/Doc/howto/webservers.rst:385 +#: howto/webservers.rst:385 msgid "" "There are many servers already available, so a Python web application can be " "deployed nearly anywhere. This is one big advantage that Python has " @@ -11414,7 +11226,7 @@ msgid "" msgstr "" # 3bae285171d94873a63ee8c88ce45f7f -#: ../src/Doc/howto/webservers.rst:391 +#: howto/webservers.rst:391 msgid "" "A good overview of WSGI-related code can be found in the `WSGI homepage " "`_, which contains an extensive " @@ -11422,28 +11234,28 @@ msgid "" "can be used by *any* application supporting WSGI." msgstr "" -#: ../src/Doc/howto/webservers.rst:396 +#: howto/webservers.rst:396 msgid "" "You might be interested in some WSGI-supporting modules already contained in " "the standard library, namely:" msgstr "" -#: ../src/Doc/howto/webservers.rst:399 +#: howto/webservers.rst:399 msgid ":mod:`wsgiref` -- some tiny utilities and servers for WSGI" msgstr "" -#: ../src/Doc/howto/webservers.rst:403 +#: howto/webservers.rst:403 msgid "Case study: MoinMoin" msgstr "" -#: ../src/Doc/howto/webservers.rst:405 +#: howto/webservers.rst:405 msgid "" "What does WSGI give the web application developer? Let's take a look at an " "application that's been around for a while, which was written in Python " "without using WSGI." msgstr "" -#: ../src/Doc/howto/webservers.rst:409 +#: howto/webservers.rst:409 msgid "" "One of the most widely used wiki software packages is `MoinMoin `_. It was created in 2000, so it predates WSGI by about three " @@ -11451,7 +11263,7 @@ msgid "" "FastCGI and standalone." msgstr "" -#: ../src/Doc/howto/webservers.rst:414 +#: howto/webservers.rst:414 msgid "" "It now includes support for WSGI. Using WSGI, it is possible to deploy " "MoinMoin on any WSGI compliant server, with no additional glue code. Unlike " @@ -11459,11 +11271,11 @@ msgid "" "MoinMoin know nothing about." msgstr "" -#: ../src/Doc/howto/webservers.rst:421 +#: howto/webservers.rst:421 msgid "Model-View-Controller" msgstr "" -#: ../src/Doc/howto/webservers.rst:423 +#: howto/webservers.rst:423 msgid "" "The term *MVC* is often encountered in statements such as \"framework *foo* " "supports MVC\". MVC is more about the overall organization of code, rather " @@ -11475,24 +11287,24 @@ msgid "" "given that they are already familiar with the MVC structure." msgstr "" -#: ../src/Doc/howto/webservers.rst:432 +#: howto/webservers.rst:432 msgid "MVC stands for three components:" msgstr "" -#: ../src/Doc/howto/webservers.rst:434 +#: howto/webservers.rst:434 msgid "" "The *model*. This is the data that will be displayed and modified. In " "Python frameworks, this component is often represented by the classes used " "by an object-relational mapper." msgstr "" -#: ../src/Doc/howto/webservers.rst:438 +#: howto/webservers.rst:438 msgid "" "The *view*. This component's job is to display the data of the model to the " "user. Typically this component is implemented via templates." msgstr "" -#: ../src/Doc/howto/webservers.rst:441 +#: howto/webservers.rst:441 msgid "" "The *controller*. This is the layer between the user and the model. The " "controller reacts to user actions (like opening some specific URL), tells " @@ -11500,14 +11312,14 @@ msgid "" "display," msgstr "" -#: ../src/Doc/howto/webservers.rst:446 +#: howto/webservers.rst:446 msgid "" "While one might think that MVC is a complex design pattern, in fact it is " "not. It is used in Python because it has turned out to be useful for " "creating clean, maintainable web sites." msgstr "" -#: ../src/Doc/howto/webservers.rst:452 +#: howto/webservers.rst:452 msgid "" "While not all Python frameworks explicitly support MVC, it is often trivial " "to create a web site which uses the MVC pattern by separating the data logic " @@ -11517,18 +11329,18 @@ msgid "" "chaos in the code base, making it harder to understand and modify." msgstr "" -#: ../src/Doc/howto/webservers.rst:461 +#: howto/webservers.rst:461 msgid "" "The English Wikipedia has an article about the `Model-View-Controller " "pattern `_. It includes " "a long list of web frameworks for various programming languages." msgstr "" -#: ../src/Doc/howto/webservers.rst:467 +#: howto/webservers.rst:467 msgid "Ingredients for Websites" msgstr "" -#: ../src/Doc/howto/webservers.rst:469 +#: howto/webservers.rst:469 msgid "" "Websites are complex constructs, so tools have been created to help web " "developers make their code easier to write and more maintainable. Tools " @@ -11539,18 +11351,18 @@ msgid "" msgstr "" # 0b70426b273842c7aeb0d13d84d59533 -#: ../src/Doc/howto/webservers.rst:479 +#: howto/webservers.rst:479 msgid "" "There are far more components than can be presented here. The Python wiki " "has a page about these components, called `Web Components `_." msgstr "" -#: ../src/Doc/howto/webservers.rst:485 +#: howto/webservers.rst:485 msgid "Templates" msgstr "" -#: ../src/Doc/howto/webservers.rst:487 +#: howto/webservers.rst:487 msgid "" "Mixing of HTML and Python code is made possible by a few libraries. While " "convenient at first, it leads to horribly unmaintainable code. That's why " @@ -11560,18 +11372,18 @@ msgid "" msgstr "" # f28155ec1cbe47cc88eb8d6a2d1af868 -#: ../src/Doc/howto/webservers.rst:493 +#: howto/webservers.rst:493 msgid "Python already includes two ways to build simple templates::" msgstr "" -#: ../src/Doc/howto/webservers.rst:504 +#: howto/webservers.rst:504 msgid "" "To generate complex HTML based on non-trivial model data, conditional and " "looping constructs like Python's *for* and *if* are generally needed. " "*Template engines* support templates of this complexity." msgstr "" -#: ../src/Doc/howto/webservers.rst:508 +#: howto/webservers.rst:508 msgid "" "There are a lot of template engines available for Python which can be used " "with or without a `framework`_. Some of these define a plain-text " @@ -11580,32 +11392,32 @@ msgid "" "valid XML. There are many other variations." msgstr "" -#: ../src/Doc/howto/webservers.rst:514 +#: howto/webservers.rst:514 msgid "" "Some `frameworks`_ ship their own template engine or recommend one in " "particular. In the absence of a reason to use a different template engine, " "using the one provided by or recommended by the framework is a good idea." msgstr "" -#: ../src/Doc/howto/webservers.rst:518 +#: howto/webservers.rst:518 msgid "Popular template engines include:" msgstr "" -#: ../src/Doc/howto/webservers.rst:520 +#: howto/webservers.rst:520 msgid "`Mako `_" msgstr "`Mako `_" -#: ../src/Doc/howto/webservers.rst:521 +#: howto/webservers.rst:521 msgid "`Genshi `_" msgstr "`Genshi `_" -#: ../src/Doc/howto/webservers.rst:522 +#: howto/webservers.rst:522 #, fuzzy msgid "`Jinja `_" msgstr "`Jinja `_" # 6645ceeebd304a038727a8fdc0649eda -#: ../src/Doc/howto/webservers.rst:526 +#: howto/webservers.rst:526 msgid "" "There are many template engines competing for attention, because it is " "pretty easy to create them in Python. The page `Templating `_ or " "`PostgreSQL `_ are used because of their good " @@ -11637,7 +11449,7 @@ msgid "" "sites SQLite is just enough." msgstr "" -#: ../src/Doc/howto/webservers.rst:549 +#: howto/webservers.rst:549 msgid "" "Relational databases are *queried* using a language called `SQL `_. Python programmers in general do not like SQL " @@ -11649,7 +11461,7 @@ msgid "" "use ORMs, and it works quite well." msgstr "" -#: ../src/Doc/howto/webservers.rst:558 +#: howto/webservers.rst:558 msgid "" "A second possibility is storing data in normal, plain text files (some times " "called \"flat files\"). This is very easy for simple sites, but can be " @@ -11657,7 +11469,7 @@ msgid "" "stored data." msgstr "" -#: ../src/Doc/howto/webservers.rst:563 +#: howto/webservers.rst:563 msgid "" "A third possibility are object oriented databases (also called \"object " "databases\"). These databases store the object data in a form that closely " @@ -11668,7 +11480,7 @@ msgid "" "unlike in relational databases where some objects are very hard to represent." msgstr "" -#: ../src/Doc/howto/webservers.rst:571 +#: howto/webservers.rst:571 msgid "" "`Frameworks`_ often give hints on which data storage method to choose. It " "is usually a good idea to stick to the data store recommended by the " @@ -11677,7 +11489,7 @@ msgid "" msgstr "" # b32960c4248544d4989eb91da5dd2faf -#: ../src/Doc/howto/webservers.rst:578 +#: howto/webservers.rst:578 msgid "" "`Persistence Tools `_ lists " "possibilities on how to save data in the file system. Some of these modules " @@ -11685,34 +11497,34 @@ msgid "" msgstr "" # b9b6ac249fc14aa9997f3ba4bab579ce -#: ../src/Doc/howto/webservers.rst:582 +#: howto/webservers.rst:582 msgid "" "`Database Programming `_ " "helps with choosing a method for saving data" msgstr "" -#: ../src/Doc/howto/webservers.rst:585 +#: howto/webservers.rst:585 msgid "" "`SQLAlchemy `_, the most powerful OR-Mapper for " "Python, and `Elixir `_, which makes SQLAlchemy " "easier to use" msgstr "" -#: ../src/Doc/howto/webservers.rst:589 +#: howto/webservers.rst:589 msgid "`SQLObject `_, another popular OR-Mapper" msgstr "" -#: ../src/Doc/howto/webservers.rst:591 +#: howto/webservers.rst:591 msgid "" "`ZODB `_ and `Durus `_, two object oriented databases" msgstr "" -#: ../src/Doc/howto/webservers.rst:599 +#: howto/webservers.rst:599 msgid "Frameworks" msgstr "" -#: ../src/Doc/howto/webservers.rst:601 +#: howto/webservers.rst:601 msgid "" "The process of creating code to run web sites involves writing code to " "provide various services. The code to provide a particular service often " @@ -11724,7 +11536,7 @@ msgid "" "from Rails, but many existed a long time before Rails." msgstr "" -#: ../src/Doc/howto/webservers.rst:610 +#: howto/webservers.rst:610 msgid "" "Originally Python web frameworks tended to incorporate all of the services " "needed to develop web sites as a giant, integrated set of tools. No two web " @@ -11738,7 +11550,7 @@ msgid "" "used interchangeably." msgstr "" -#: ../src/Doc/howto/webservers.rst:621 +#: howto/webservers.rst:621 msgid "" "Since the advent of WSGI, the Python web framework world has been evolving " "toward interoperability based on the WSGI standard. Now many web " @@ -11748,7 +11560,7 @@ msgid "" "than one framework." msgstr "" -#: ../src/Doc/howto/webservers.rst:628 +#: howto/webservers.rst:628 msgid "" "The majority of users will probably want to select a \"full stack\" " "framework that has an active community. These frameworks tend to be well " @@ -11756,22 +11568,22 @@ msgid "" "site in minimal time." msgstr "" -#: ../src/Doc/howto/webservers.rst:635 +#: howto/webservers.rst:635 msgid "Some notable frameworks" msgstr "" -#: ../src/Doc/howto/webservers.rst:637 +#: howto/webservers.rst:637 msgid "" "There are an incredible number of frameworks, so they cannot all be covered " "here. Instead we will briefly touch on some of the most popular." msgstr "" -#: ../src/Doc/howto/webservers.rst:642 +#: howto/webservers.rst:642 msgid "Django" msgstr "Django" # f21816ade0d647668a38054f6f2aa0f3 -#: ../src/Doc/howto/webservers.rst:644 +#: howto/webservers.rst:644 msgid "" "`Django `_ is a framework consisting of " "several tightly coupled elements which were written from scratch and work " @@ -11786,7 +11598,7 @@ msgid "" msgstr "" # 51774238daa345ccb0572ecd7ba5129a -#: ../src/Doc/howto/webservers.rst:654 +#: howto/webservers.rst:654 msgid "" "It has a big, international community, the members of which have created " "many web sites. There are also a lot of add-on projects which extend " @@ -11796,7 +11608,7 @@ msgid "" msgstr "" # 4808cbb303f34a088363b19e6180eded -#: ../src/Doc/howto/webservers.rst:663 +#: howto/webservers.rst:663 msgid "" "Although Django is an MVC-style framework, it names the elements " "differently, which is described in the `Django FAQ `_." msgstr "" -#: ../src/Doc/howto/webservers.rst:669 +#: howto/webservers.rst:669 msgid "TurboGears" msgstr "TurboGears" -#: ../src/Doc/howto/webservers.rst:671 +#: howto/webservers.rst:671 msgid "" "Another popular web framework for Python is `TurboGears `_. TurboGears takes the approach of using already existing " @@ -11819,7 +11631,7 @@ msgid "" "different from those used by default." msgstr "" -#: ../src/Doc/howto/webservers.rst:678 +#: howto/webservers.rst:678 msgid "" "The documentation can be found in the `TurboGears wiki `_, where links to screencasts can be found. TurboGears has " @@ -11829,7 +11641,7 @@ msgid "" msgstr "" # af4bd541aec84ab8be1a19f8b414c72a -#: ../src/Doc/howto/webservers.rst:684 +#: howto/webservers.rst:684 msgid "" "The newest version of TurboGears, version 2.0, moves even further in " "direction of WSGI support and a component-based architecture. TurboGears 2 " @@ -11837,11 +11649,11 @@ msgid "" "`Pylons `_." msgstr "" -#: ../src/Doc/howto/webservers.rst:691 +#: howto/webservers.rst:691 msgid "Zope" msgstr "Zope" -#: ../src/Doc/howto/webservers.rst:693 +#: howto/webservers.rst:693 msgid "" "The Zope framework is one of the \"old original\" frameworks. Its current " "incarnation in Zope2 is a tightly integrated full-stack framework. One of " @@ -11860,24 +11672,24 @@ msgid "" msgstr "" # 3d48b3d82e154f6ab37bb1041e751122 -#: ../src/Doc/howto/webservers.rst:708 +#: howto/webservers.rst:708 msgid "" "Zope is also the infrastructure used by the `Plone `_ " "content management system, one of the most powerful and popular content " "management systems available." msgstr "" -#: ../src/Doc/howto/webservers.rst:714 +#: howto/webservers.rst:714 msgid "Other notable frameworks" msgstr "" -#: ../src/Doc/howto/webservers.rst:716 +#: howto/webservers.rst:716 msgid "" "Of course these are not the only frameworks that are available. There are " "many other frameworks worth mentioning." msgstr "" -#: ../src/Doc/howto/webservers.rst:719 +#: howto/webservers.rst:719 msgid "" "Another framework that's already been mentioned is `Pylons`_. Pylons is " "much like TurboGears, but with an even stronger emphasis on flexibility, " @@ -11888,28 +11700,30 @@ msgid "" "which are handy for WSGI." msgstr "" -#: ../src/Doc/howto/webservers.rst:726 +#: howto/webservers.rst:726 msgid "" "And that's still not everything. The most up-to-date information can always " "be found in the Python wiki." msgstr "" # 842b2f2a42f941a3974843f2dbe6bf31 -#: ../src/Doc/howto/webservers.rst:731 +#: howto/webservers.rst:731 msgid "" "The Python wiki contains an extensive list of `web frameworks `_." msgstr "" -# fd0de91d1f44499cad218f757a4e274f -#: ../src/Doc/howto/webservers.rst:734 +#: howto/webservers.rst:734 msgid "" "Most frameworks also have their own mailing lists and IRC channels, look out " -"for these on the projects' web sites. There is also a general \"Python in " -"the Web\" IRC channel on freenode called `#python.web `_." +"for these on the projects' web sites." msgstr "" +# 4cceebf107a046e2850ba987f30e3b95 +#, fuzzy +#~ msgid "Other Resources" +#~ msgstr "Autres ressources" + #~ msgid "A.M. Kuchling" #~ msgstr "A.M. Kuchling" diff --git a/install.po b/install.po index aa9b325d..93240ed8 100644 --- a/install.po +++ b/install.po @@ -7,25 +7,25 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/install/index.rst:7 +#: install/index.rst:7 msgid "Installing Python Modules" msgstr "installation des modules python" -#: ../src/Doc/install/index.rst:9 +#: install/index.rst:9 msgid "Greg Ward" msgstr "Greg Ward" -#: ../src/Doc/install/index.rst:23 +#: install/index.rst:23 msgid "" "This document describes the Python Distribution Utilities (\"Distutils\") " "from the end-user's point-of-view, describing how to extend the capabilities " @@ -37,21 +37,20 @@ msgstr "" "capacités d'une installation standard de python en construisant et " "installant des modules python tiers et des extensions." -# 1b07c2cc35cc46e0a8af0e0bbbd3b796 -#: ../src/Doc/install/index.rst:31 +#: install/index.rst:31 msgid "" -"This guide only covers the basic tools for installing extensions that are " -"provided as part of this version of Python. Third party tools offer easier " -"to use and more secure alternatives. Refer to the `quick recommendations " -"section `__ in the Python Packaging User Guide for more information." +"This guide only covers the basic tools for building and distributing " +"extensions that are provided as part of this version of Python. Third party " +"tools offer easier to use and more secure alternatives. Refer to the `quick " +"recommendations section `__ " +"in the Python Packaging User Guide for more information." msgstr "" -#: ../src/Doc/install/index.rst:42 +#: install/index.rst:42 msgid "Introduction" msgstr "introduction" -#: ../src/Doc/install/index.rst:44 +#: install/index.rst:44 msgid "" "Although Python's extensive standard library covers many programming needs, " "there often comes a time when you need to add some new functionality to your " @@ -66,7 +65,7 @@ msgstr "" "pour prendre en charge une application écrite en Python que vous souhaitez " "utiliser." -#: ../src/Doc/install/index.rst:50 +#: install/index.rst:50 msgid "" "In the past, there has been little support for adding third-party modules to " "an existing Python installation. With the introduction of the Python " @@ -77,7 +76,7 @@ msgstr "" "distribution de Python (Distutils pour faire plus court) dans Python 2.0, " "ceci a changé." -#: ../src/Doc/install/index.rst:54 +#: install/index.rst:54 #, fuzzy msgid "" "This document is aimed primarily at the people who need to install third-" @@ -101,11 +100,11 @@ msgstr "" "distribuer vos propres modules Python afin que d'autres puissent les " "utiliser, allez voir le manuel de :ref:`distutils-index`." -#: ../src/Doc/install/index.rst:69 +#: install/index.rst:69 msgid "Best case: trivial installation" msgstr "Le meilleur des cas : l'installation simple" -#: ../src/Doc/install/index.rst:71 +#: install/index.rst:71 msgid "" "In the best case, someone will have prepared a special version of the module " "distribution you want to install that is targeted specifically at your " @@ -127,7 +126,7 @@ msgstr "" # j'ai un doute sur le "les choses qui vous semble évidentes"...on conjuge # comment "semble" ? -#: ../src/Doc/install/index.rst:79 +#: install/index.rst:79 #, fuzzy msgid "" "In that case, you would download the installer appropriate to your platform " @@ -144,7 +143,7 @@ msgstr "" "devriez même pas avoir besoin de lire toutes les instructions (même si c'est " "toujours une bonne idée de le faire)." -#: ../src/Doc/install/index.rst:85 +#: install/index.rst:85 msgid "" "Of course, things will not always be that easy. You might be interested in " "a module distribution that doesn't have an easy-to-use installer for your " @@ -163,11 +162,11 @@ msgstr "" "standard. Le cœur de ce document explique comment configurer et installer " "des modules à partir des sources." -#: ../src/Doc/install/index.rst:97 +#: install/index.rst:97 msgid "The new standard: Distutils" msgstr "Le nouveau standard: Distutils" -#: ../src/Doc/install/index.rst:99 +#: install/index.rst:99 #, fuzzy msgid "" "If you download a module source distribution, you can tell pretty quickly if " @@ -194,13 +193,13 @@ msgstr "" "simplement en exécutant ceci ::" # a54192a94c9c415da00ba9e040255920 -#: ../src/Doc/install/index.rst:112 +#: install/index.rst:112 msgid "" "For Windows, this command should be run from a command prompt window (:" "menuselection:`Start --> Accessories`)::" msgstr "" -#: ../src/Doc/install/index.rst:117 +#: install/index.rst:117 msgid "" "If all these things are true, then you already know how to build and install " "the modules you've just downloaded: Run the command above. Unless you need " @@ -215,11 +214,11 @@ msgstr "" "construction, vous n'avez pas vraiment besoin de ce manuel. Ou plutôt, la " "commande ci-dessus est tout ce dont vous avez besoin de sortir de ce manuel." -#: ../src/Doc/install/index.rst:127 +#: install/index.rst:127 msgid "Standard Build and Install" msgstr "Construction standard et installation" -#: ../src/Doc/install/index.rst:129 +#: install/index.rst:129 #, fuzzy msgid "" "As described in section :ref:`inst-new-standard`, building and installing a " @@ -230,11 +229,11 @@ msgstr "" "l'installation d'une distribution d'un module en utilisant Distutils est " "habituellement fait avec la commande ::" -#: ../src/Doc/install/index.rst:139 +#: install/index.rst:139 msgid "Platform variations" msgstr "Différences selon les plateformes" -#: ../src/Doc/install/index.rst:141 +#: install/index.rst:141 msgid "" "You should always run the setup command from the distribution root " "directory, i.e. the top-level subdirectory that the module source " @@ -249,12 +248,12 @@ msgstr "" "module :file:`foo-1.0.tar.gz` sous un système Unix, la méthode normale " "consiste à faire ::" -#: ../src/Doc/install/index.rst:150 +#: install/index.rst:150 #, fuzzy msgid "" "On Windows, you'd probably download :file:`foo-1.0.zip`. If you downloaded " "the archive file to :file:`C:\\\\Temp`, then it would unpack into :file:`C:\\" -"\\Temp\\\\foo-1.0`; you can use either a archive manipulator with a " +"\\Temp\\\\foo-1.0`; you can use either an archive manipulator with a " "graphical user interface (such as WinZip) or a command-line tool (such as :" "program:`unzip` or :program:`pkunzip`) to unpack the archive. Then, open a " "command prompt window and run::" @@ -267,11 +266,11 @@ msgstr "" "`pkunzip`) pour décompresser l'archive. Ensuite, ouvrez une fenêtre d'invite " "de commandes (\"fenêtre DOS\") et exécutez ::" -#: ../src/Doc/install/index.rst:164 +#: install/index.rst:164 msgid "Splitting the job up" msgstr "Fractionnement du travail" -#: ../src/Doc/install/index.rst:166 +#: install/index.rst:166 msgid "" "Running ``setup.py install`` builds and installs all modules in one run. If " "you prefer to work incrementally---especially useful if you want to " @@ -293,7 +292,7 @@ msgstr "" "l'installation (ou le faire vous-même, avec les privilèges de super-" "utilisateur)." -#: ../src/Doc/install/index.rst:174 +#: install/index.rst:174 msgid "" "For example, you can build everything in one step, and then install " "everything in a second step, by invoking the setup script twice::" @@ -302,7 +301,7 @@ msgstr "" "installer le tout dans une deuxième étape, en invoquant le script " "d'installation deux fois ::" -#: ../src/Doc/install/index.rst:180 +#: install/index.rst:180 msgid "" "If you do this, you will notice that running the :command:`install` command " "first runs the :command:`build` command, which---in this case---quickly " @@ -314,7 +313,7 @@ msgstr "" "cas, s'aperçoit vite qu'il n'a rien à faire, puisque tout dans le dossier :" "file:`build` est à jour." -#: ../src/Doc/install/index.rst:185 +#: install/index.rst:185 msgid "" "You may not need this ability to break things down often if all you do is " "install modules downloaded off the 'net, but it's very handy for more " @@ -328,11 +327,11 @@ msgstr "" "exécuter beaucoup de commandes individuelles de Distutils, indépendamment " "les unes des autres." -#: ../src/Doc/install/index.rst:194 +#: install/index.rst:194 msgid "How building works" msgstr "Comment fonctionne une construction" -#: ../src/Doc/install/index.rst:196 +#: install/index.rst:196 msgid "" "As implied above, the :command:`build` command is responsible for putting " "the files to install into a *build directory*. By default, this is :file:" @@ -347,7 +346,7 @@ msgstr "" "sources d'origine, vous pouvez changer le répertoire de construction avec " "l'option :option:`--build-base`. Par exemple ::" -#: ../src/Doc/install/index.rst:204 +#: install/index.rst:204 msgid "" "(Or you could do this permanently with a directive in your system or " "personal Distutils configuration file; see section :ref:`inst-config-" @@ -357,13 +356,13 @@ msgstr "" "système ou dans le fichier de configuration personnelle de Distutils ; voir " "la section :ref:`inst-config-files`.) Normalement, ce n'est pas nécessaire." -#: ../src/Doc/install/index.rst:208 +#: install/index.rst:208 msgid "The default layout for the build tree is as follows::" msgstr "" "La mise en page par défaut pour l'arbre de compilation se présente comme " "suit ::" -#: ../src/Doc/install/index.rst:215 +#: install/index.rst:215 msgid "" "where ```` expands to a brief description of the current OS/hardware " "platform and Python version. The first form, with just a :file:`lib` " @@ -388,7 +387,7 @@ msgstr "" "deux cas, le dossier :file:`lib` (ou :file:`lib.{plat}`) contient tous les " "modules Python (Python pur et extensions) qui seront installés." -#: ../src/Doc/install/index.rst:225 +#: install/index.rst:225 msgid "" "In the future, more directories will be added to handle Python scripts, " "documentation, binary executables, and whatever else is needed to handle the " @@ -399,11 +398,11 @@ msgstr "" "nécessaire pour gérer le travail de l'installation de modules et " "d'applications Python." -#: ../src/Doc/install/index.rst:233 +#: install/index.rst:233 msgid "How installation works" msgstr "Comment fonctionne l'installation" -#: ../src/Doc/install/index.rst:235 +#: install/index.rst:235 msgid "" "After the :command:`build` command runs (whether you run it explicitly, or " "the :command:`install` command does it for you), the work of the :command:" @@ -418,7 +417,7 @@ msgstr "" "file:`build/lib.{plat}`) dans le répertoire que vous avez choisi pour " "l'installation." -#: ../src/Doc/install/index.rst:241 +#: install/index.rst:241 msgid "" "If you don't choose an installation directory---i.e., if you just run " "``setup.py install``\\ ---then the :command:`install` command installs to " @@ -437,71 +436,69 @@ msgstr "" "la distribution en cours d'installation est en pur Python ou contient des " "extensions (\"non-pur\"):" -#: ../src/Doc/install/index.rst:251 +#: install/index.rst:251 msgid "Platform" msgstr "Plateforme" -#: ../src/Doc/install/index.rst:251 +#: install/index.rst:251 msgid "Standard installation location" msgstr "Emplacement standard de l'installation" -#: ../src/Doc/install/index.rst:251 +#: install/index.rst:251 msgid "Default value" msgstr "Valeur par défaut" -#: ../src/Doc/install/index.rst:251 ../src/Doc/install/index.rst:765 -#: ../src/Doc/install/index.rst:777 +#: install/index.rst:251 install/index.rst:765 install/index.rst:777 msgid "Notes" msgstr "Notes" -#: ../src/Doc/install/index.rst:253 +#: install/index.rst:253 msgid "Unix (pure)" msgstr "Unix (pur)" -#: ../src/Doc/install/index.rst:253 ../src/Doc/install/index.rst:465 +#: install/index.rst:253 install/index.rst:465 msgid ":file:`{prefix}/lib/python{X.Y}/site-packages`" msgstr ":file:`{prefix}/lib/python{X.Y}/site-packages`" -#: ../src/Doc/install/index.rst:253 ../src/Doc/install/index.rst:255 +#: install/index.rst:253 install/index.rst:255 msgid ":file:`/usr/local/lib/python{X.Y}/site-packages`" msgstr ":file:`/usr/local/lib/python{X.Y}/site-packages`" -#: ../src/Doc/install/index.rst:253 ../src/Doc/install/index.rst:255 -#: ../src/Doc/install/index.rst:767 +#: install/index.rst:253 install/index.rst:255 install/index.rst:767 msgid "\\(1)" msgstr "\\(1)" -#: ../src/Doc/install/index.rst:255 +#: install/index.rst:255 msgid "Unix (non-pure)" msgstr "Unix (non-pur)" -#: ../src/Doc/install/index.rst:255 ../src/Doc/install/index.rst:466 +#: install/index.rst:255 install/index.rst:466 msgid ":file:`{exec-prefix}/lib/python{X.Y}/site-packages`" msgstr ":file:`{exec-prefix}/lib/python{X.Y}/site-packages`" -#: ../src/Doc/install/index.rst:257 +#: install/index.rst:257 msgid "Windows" msgstr "Windows" -#: ../src/Doc/install/index.rst:257 ../src/Doc/install/index.rst:517 +#: install/index.rst:257 install/index.rst:517 #, fuzzy msgid ":file:`{prefix}\\\\Lib\\\\site-packages`" msgstr ":file:`{prefix}/lib/python{X.Y}/site-packages`" -#: ../src/Doc/install/index.rst:257 +#: install/index.rst:257 #, fuzzy msgid ":file:`C:\\\\Python{XY}\\\\Lib\\\\site-packages`" msgstr ":file:`{prefix}/lib/python{X.Y}/site-packages`" -#: ../src/Doc/install/index.rst:257 ../src/Doc/install/index.rst:769 +#: install/index.rst:257 install/index.rst:769 msgid "\\(2)" msgstr "\\(2)" -#: ../src/Doc/install/index.rst:260 ../src/Doc/install/index.rst:789 +#: install/index.rst:260 install/index.rst:789 msgid "Notes:" msgstr "Notes:" -#: ../src/Doc/install/index.rst:263 +#: install/index.rst:263 msgid "" "Most Linux distributions include Python as a standard part of the system, " "so :file:`{prefix}` and :file:`{exec-prefix}` are usually both :file:`/usr` " @@ -516,7 +513,7 @@ msgstr "" "valeurs par défaut de : file: `{prefix}` et: ​​file: `{exec-prefix}` sont " "souvent : file: `/ usr /` locales." -#: ../src/Doc/install/index.rst:269 +#: install/index.rst:269 msgid "" "The default installation directory on Windows was :file:`C:\\\\Program Files" "\\\\Python` under Python 1.6a1, 1.5.2, and earlier." @@ -524,7 +521,7 @@ msgstr "" "Sous Windows, le dossier d'installation par défaut était : :file:`C:" "\\Program Files\\Python` sous Python 1.6a1, 1.5.2 et avant." -#: ../src/Doc/install/index.rst:272 +#: install/index.rst:272 msgid "" ":file:`{prefix}` and :file:`{exec-prefix}` stand for the directories that " "Python is installed to, and where it finds its libraries at run-time. They " @@ -552,7 +549,7 @@ msgstr "" "pour trouver mes :file:`{prefix}` et :file:`{exec-prefix}`::" # 5b6f132f2a2c44eabe95113d1db0aff9 -#: ../src/Doc/install/index.rst:292 +#: install/index.rst:292 msgid "" "A few other placeholders are used in this document: :file:`{X.Y}` stands for " "the version of Python, for example ``2.7``; :file:`{distname}` will be " @@ -561,7 +558,7 @@ msgid "" "``python2.7`` on UNIX will typically use ``Python27`` on Windows." msgstr "" -#: ../src/Doc/install/index.rst:298 +#: install/index.rst:298 msgid "" "If you don't want to install modules to the standard location, or if you " "don't have permission to write there, then you need to read about alternate " @@ -576,11 +573,11 @@ msgstr "" "d'installation plus fortement, allez voir la section ref: `inst-sur-install` " "sur les installations personnalisées." -#: ../src/Doc/install/index.rst:308 +#: install/index.rst:308 msgid "Alternate Installation" msgstr "" -#: ../src/Doc/install/index.rst:310 +#: install/index.rst:310 msgid "" "Often, it is necessary or desirable to install modules to a location other " "than the standard location for third-party Python modules. For example, on " @@ -592,7 +589,7 @@ msgid "" "actually upgrading." msgstr "" -#: ../src/Doc/install/index.rst:318 +#: install/index.rst:318 msgid "" "The Distutils :command:`install` command is designed to make installing " "module distributions to an alternate location simple and painless. The " @@ -604,7 +601,7 @@ msgid "" msgstr "" # 7506292a2ce64a38a0ea9f6c26fa8b5c -#: ../src/Doc/install/index.rst:326 +#: install/index.rst:326 msgid "" "Note that the various alternate installation schemes are mutually exclusive: " "you can pass ``--user``, or ``--home``, or ``--prefix`` and ``--exec-" @@ -613,12 +610,12 @@ msgid "" msgstr "" # 40e5567d8fdc411c91fc7d89c0e99931 -#: ../src/Doc/install/index.rst:335 +#: install/index.rst:335 msgid "Alternate installation: the user scheme" msgstr "" # ac94877f69944e94b0888cf2845c6d07 -#: ../src/Doc/install/index.rst:337 +#: install/index.rst:337 msgid "" "This scheme is designed to be the most convenient solution for users that " "don't have write permission to the global site-packages directory or don't " @@ -626,7 +623,7 @@ msgid "" msgstr "" # da5867d4d6cb47f6bcccbea71f7ef5d4 -#: ../src/Doc/install/index.rst:343 +#: install/index.rst:343 msgid "" "Files will be installed into subdirectories of :data:`site.USER_BASE` " "(written as :file:`{userbase}` hereafter). This scheme installs pure Python " @@ -634,16 +631,14 @@ msgid "" "`site.USER_SITE`). Here are the values for UNIX, including Mac OS X:" msgstr "" -#: ../src/Doc/install/index.rst:349 ../src/Doc/install/index.rst:360 -#: ../src/Doc/install/index.rst:411 ../src/Doc/install/index.rst:463 -#: ../src/Doc/install/index.rst:515 ../src/Doc/install/index.rst:540 -#: ../src/Doc/install/index.rst:765 ../src/Doc/install/index.rst:777 +#: install/index.rst:349 install/index.rst:360 install/index.rst:411 +#: install/index.rst:463 install/index.rst:515 install/index.rst:540 +#: install/index.rst:765 install/index.rst:777 msgid "Type of file" msgstr "" -#: ../src/Doc/install/index.rst:349 ../src/Doc/install/index.rst:360 -#: ../src/Doc/install/index.rst:411 ../src/Doc/install/index.rst:463 -#: ../src/Doc/install/index.rst:515 +#: install/index.rst:349 install/index.rst:360 install/index.rst:411 +#: install/index.rst:463 install/index.rst:515 #, fuzzy msgid "Installation directory" msgstr "Comment fonctionne l'installation" @@ -652,35 +647,33 @@ msgstr "Comment fonctionne l'installation" # f5ee1578a76542ef876e524df4460b79 # 260ab33dcfc24f7b9686d09491c9cb55 # f3b03d4aecd9484887d1f7be4a212a84 -#: ../src/Doc/install/index.rst:351 ../src/Doc/install/index.rst:362 -#: ../src/Doc/install/index.rst:413 ../src/Doc/install/index.rst:517 +#: install/index.rst:351 install/index.rst:362 install/index.rst:413 +#: install/index.rst:517 #, fuzzy msgid "modules" msgstr "module" -#: ../src/Doc/install/index.rst:351 +#: install/index.rst:351 #, fuzzy msgid ":file:`{userbase}/lib/python{X.Y}/site-packages`" msgstr ":file:`{prefix}/lib/python{X.Y}/site-packages`" -#: ../src/Doc/install/index.rst:352 ../src/Doc/install/index.rst:363 -#: ../src/Doc/install/index.rst:414 ../src/Doc/install/index.rst:467 -#: ../src/Doc/install/index.rst:518 ../src/Doc/install/index.rst:545 +#: install/index.rst:352 install/index.rst:363 install/index.rst:414 +#: install/index.rst:467 install/index.rst:518 install/index.rst:545 msgid "scripts" msgstr "" -#: ../src/Doc/install/index.rst:352 +#: install/index.rst:352 #, fuzzy msgid ":file:`{userbase}/bin`" msgstr ":file:`{prefix}`" -#: ../src/Doc/install/index.rst:353 ../src/Doc/install/index.rst:364 -#: ../src/Doc/install/index.rst:415 ../src/Doc/install/index.rst:468 -#: ../src/Doc/install/index.rst:519 ../src/Doc/install/index.rst:546 +#: install/index.rst:353 install/index.rst:364 install/index.rst:415 +#: install/index.rst:468 install/index.rst:519 install/index.rst:546 msgid "data" msgstr "" -#: ../src/Doc/install/index.rst:353 ../src/Doc/install/index.rst:364 +#: install/index.rst:353 install/index.rst:364 #, fuzzy msgid ":file:`{userbase}`" msgstr ":file:`{prefix}`" @@ -691,39 +684,38 @@ msgstr ":file:`{prefix}`" # d9dd3ac0b3e241f0830a29eb9e7af2cf # 94b2b1c3891c4037965770d7989e02c9 # 8542173e915c4120a50fb6d99b8934eb -#: ../src/Doc/install/index.rst:354 ../src/Doc/install/index.rst:365 -#: ../src/Doc/install/index.rst:416 ../src/Doc/install/index.rst:469 -#: ../src/Doc/install/index.rst:520 ../src/Doc/install/index.rst:547 +#: install/index.rst:354 install/index.rst:365 install/index.rst:416 +#: install/index.rst:469 install/index.rst:520 install/index.rst:547 msgid "C headers" msgstr "" -#: ../src/Doc/install/index.rst:354 +#: install/index.rst:354 #, fuzzy msgid ":file:`{userbase}/include/python{X.Y}/{distname}`" msgstr ":file:`{prefix}/lib/python{X.Y}/site-packages`" # 7420241ef1a746b09f23620a6d34a87b -#: ../src/Doc/install/index.rst:357 +#: install/index.rst:357 msgid "And here are the values used on Windows:" msgstr "" -#: ../src/Doc/install/index.rst:362 +#: install/index.rst:362 #, fuzzy msgid ":file:`{userbase}\\\\Python{XY}\\\\site-packages`" msgstr ":file:`{prefix}/lib/python{X.Y}/site-packages`" # 2051c21f883c42d88eb083a62f4088ae -#: ../src/Doc/install/index.rst:363 +#: install/index.rst:363 msgid ":file:`{userbase}\\\\Scripts`" msgstr "" # 0d0695c67f894b4c9f4d08db0f94c4bd -#: ../src/Doc/install/index.rst:365 +#: install/index.rst:365 msgid ":file:`{userbase}\\\\Python{XY}\\\\Include\\\\{distname}`" msgstr "" # 58fe3f2dfe20476f9a9f1dd49f7bd8c2 -#: ../src/Doc/install/index.rst:368 +#: install/index.rst:368 msgid "" "The advantage of using this scheme compared to the other ones described " "below is that the user site-packages directory is under normal conditions " @@ -733,7 +725,7 @@ msgid "" msgstr "" # 96c46f760b34452fb3e386c39abd6987 -#: ../src/Doc/install/index.rst:374 +#: install/index.rst:374 msgid "" "The :command:`build_ext` command also has a ``--user`` option to add :file:" "`{userbase}/include` to the compiler search path for header files and :file:" @@ -741,12 +733,12 @@ msgid "" "runtime search path for shared C libraries (rpath)." msgstr "" -#: ../src/Doc/install/index.rst:383 +#: install/index.rst:383 msgid "Alternate installation: the home scheme" msgstr "" # 654db38d5e864e0f86ad63308f69f9b8 -#: ../src/Doc/install/index.rst:385 +#: install/index.rst:385 msgid "" "The idea behind the \"home scheme\" is that you build and maintain a " "personal stash of Python modules. This scheme's name is derived from the " @@ -756,11 +748,11 @@ msgid "" "operating system they are installing for." msgstr "" -#: ../src/Doc/install/index.rst:392 +#: install/index.rst:392 msgid "Installing a new module distribution is as simple as ::" msgstr "" -#: ../src/Doc/install/index.rst:396 +#: install/index.rst:396 msgid "" "where you can supply any directory you like for the :option:`--home` " "option. On Unix, lazy typists can just type a tilde (``~``); the :command:" @@ -768,7 +760,7 @@ msgid "" msgstr "" # bcdc4d6e75ba4b3599b9473b7026410d -#: ../src/Doc/install/index.rst:402 +#: install/index.rst:402 msgid "" "To make Python find the distributions installed with this scheme, you may " "have to :ref:`modify Python's search path ` or edit :mod:" @@ -776,42 +768,46 @@ msgid "" "data:`sys.path`." msgstr "" -#: ../src/Doc/install/index.rst:407 +#: install/index.rst:407 msgid "" "The :option:`--home` option defines the installation base directory. Files " "are installed to the following directories under the installation base as " "follows:" msgstr "" -#: ../src/Doc/install/index.rst:413 +#: install/index.rst:413 msgid ":file:`{home}/lib/python`" msgstr "" -#: ../src/Doc/install/index.rst:414 +#: install/index.rst:414 msgid ":file:`{home}/bin`" msgstr "" -#: ../src/Doc/install/index.rst:415 +#: install/index.rst:415 #, fuzzy msgid ":file:`{home}`" msgstr ":file:`{prefix}`" # c48418482c954f169cff9de2e515efe9 -#: ../src/Doc/install/index.rst:416 +#: install/index.rst:416 msgid ":file:`{home}/include/python/{distname}`" msgstr "" # 6c5459b252a04253ad7335e076dcefb6 -#: ../src/Doc/install/index.rst:419 +#: install/index.rst:419 msgid "(Mentally replace slashes with backslashes if you're on Windows.)" msgstr "" -#: ../src/Doc/install/index.rst:428 +#: install/index.rst:421 +msgid "The :option:`--home` option used to be supported only on Unix." +msgstr "" + +#: install/index.rst:428 msgid "Alternate installation: Unix (the prefix scheme)" msgstr "" # aebde3b1ca494bbe9d4f5859a9e97b9e -#: ../src/Doc/install/index.rst:430 +#: install/index.rst:430 msgid "" "The \"prefix scheme\" is useful when you wish to use one Python installation " "to perform the build/install (i.e., to run the setup script), but install " @@ -822,7 +818,7 @@ msgid "" "where the prefix scheme will be useful." msgstr "" -#: ../src/Doc/install/index.rst:437 +#: install/index.rst:437 msgid "" "First, consider that many Linux distributions put Python in :file:`/usr`, " "rather than the more traditional :file:`/usr/local`. This is entirely " @@ -832,7 +828,7 @@ msgid "" "rather than :file:`/usr/lib/python2.{X}`. This can be done with ::" msgstr "" -#: ../src/Doc/install/index.rst:446 +#: install/index.rst:446 msgid "" "Another possibility is a network filesystem where the name used to write to " "a remote directory is different from the name used to read it: for example, " @@ -842,7 +838,7 @@ msgid "" "{X}`. This could be done with ::" msgstr "" -#: ../src/Doc/install/index.rst:455 +#: install/index.rst:455 msgid "" "In either case, the :option:`--prefix` option defines the installation base, " "and the :option:`--exec-prefix` option defines the platform-specific " @@ -852,39 +848,39 @@ msgid "" "supplied, it defaults to :option:`--prefix`. Files are installed as follows:" msgstr "" -#: ../src/Doc/install/index.rst:465 ../src/Doc/install/index.rst:542 +#: install/index.rst:465 install/index.rst:542 #, fuzzy msgid "Python modules" msgstr "installation des modules python" # 7c44bafb1d504e418278dcb7a7789d23 # 9b4df557d25146c59b96f0c480baf7cd -#: ../src/Doc/install/index.rst:466 ../src/Doc/install/index.rst:543 +#: install/index.rst:466 install/index.rst:543 #, fuzzy msgid "extension modules" msgstr "module d'extension" -#: ../src/Doc/install/index.rst:467 +#: install/index.rst:467 msgid ":file:`{prefix}/bin`" msgstr "" -#: ../src/Doc/install/index.rst:468 ../src/Doc/install/index.rst:519 +#: install/index.rst:468 install/index.rst:519 msgid ":file:`{prefix}`" msgstr ":file:`{prefix}`" -#: ../src/Doc/install/index.rst:469 +#: install/index.rst:469 #, fuzzy msgid ":file:`{prefix}/include/python{X.Y}/{distname}`" msgstr ":file:`{prefix}/lib/python{X.Y}/site-packages`" -#: ../src/Doc/install/index.rst:472 +#: install/index.rst:472 msgid "" "There is no requirement that :option:`--prefix` or :option:`--exec-prefix` " "actually point to an alternate Python installation; if the directories " "listed above do not already exist, they are created at installation time." msgstr "" -#: ../src/Doc/install/index.rst:476 +#: install/index.rst:476 msgid "" "Incidentally, the real reason the prefix scheme is important is simply that " "a standard Unix installation uses the prefix scheme, but with :option:`--" @@ -894,7 +890,7 @@ msgid "" "without any other options, you're using it." msgstr "" -#: ../src/Doc/install/index.rst:483 +#: install/index.rst:483 msgid "" "Note that installing extensions to an alternate Python installation has no " "effect on how those extensions are built: in particular, the Python header " @@ -909,11 +905,11 @@ msgid "" "immaterial.)" msgstr "" -#: ../src/Doc/install/index.rst:498 +#: install/index.rst:498 msgid "Alternate installation: Windows (the prefix scheme)" msgstr "" -#: ../src/Doc/install/index.rst:500 +#: install/index.rst:500 msgid "" "Windows has no concept of a user's home directory, and since the standard " "Python installation under Windows is simpler than under Unix, the :option:`--" @@ -921,14 +917,14 @@ msgid "" "separate locations on Windows. ::" msgstr "" -#: ../src/Doc/install/index.rst:507 +#: install/index.rst:507 msgid "" "to install modules to the :file:`\\\\Temp\\\\Python` directory on the " "current drive." msgstr "" # 5c7df528cb674ed0bbb3551ea1ece924 -#: ../src/Doc/install/index.rst:509 +#: install/index.rst:509 msgid "" "The installation base is defined by the :option:`--prefix` option; the :" "option:`--exec-prefix` option is not supported under Windows, which means " @@ -936,20 +932,20 @@ msgid "" "location. Files are installed as follows:" msgstr "" -#: ../src/Doc/install/index.rst:518 +#: install/index.rst:518 msgid ":file:`{prefix}\\\\Scripts`" msgstr "" -#: ../src/Doc/install/index.rst:520 +#: install/index.rst:520 #, fuzzy msgid ":file:`{prefix}\\\\Include\\\\{distname}`" msgstr ":file:`{prefix}`" -#: ../src/Doc/install/index.rst:527 +#: install/index.rst:527 msgid "Custom Installation" msgstr "" -#: ../src/Doc/install/index.rst:529 +#: install/index.rst:529 msgid "" "Sometimes, the alternate installation schemes described in section :ref:" "`inst-alt-install` just don't do what you want. You might want to tweak " @@ -959,54 +955,54 @@ msgid "" msgstr "" # 003c4ceac9c748ca8cc55c0555a82b51 -#: ../src/Doc/install/index.rst:535 +#: install/index.rst:535 msgid "" "To create a custom installation scheme, you start with one of the alternate " "schemes and override some of the installation directories used for the " "various types of files, using these options:" msgstr "" -#: ../src/Doc/install/index.rst:540 +#: install/index.rst:540 msgid "Override option" msgstr "" # e02e457232eb4502b4970ff77be64449 -#: ../src/Doc/install/index.rst:542 +#: install/index.rst:542 msgid "``--install-purelib``" msgstr "" # d1b86d5cb7c84977be95b51cc118600a -#: ../src/Doc/install/index.rst:543 +#: install/index.rst:543 msgid "``--install-platlib``" msgstr "" # 11e3c926d2fe4e6ea633548f1b03f45c -#: ../src/Doc/install/index.rst:544 +#: install/index.rst:544 msgid "all modules" msgstr "" # 409ce2885b1d467ca8114553d28f1078 -#: ../src/Doc/install/index.rst:544 +#: install/index.rst:544 msgid "``--install-lib``" msgstr "" # a984f6e1ade94ce1a754e72a66a461b9 -#: ../src/Doc/install/index.rst:545 +#: install/index.rst:545 msgid "``--install-scripts``" msgstr "" # b2937443347b465ea601a23deb64771a -#: ../src/Doc/install/index.rst:546 +#: install/index.rst:546 msgid "``--install-data``" msgstr "" # cabca33a0e0d4f0d8a94e0ac01a704ee -#: ../src/Doc/install/index.rst:547 +#: install/index.rst:547 msgid "``--install-headers``" msgstr "" # 148694f30ca24f8396b5c98795333fbf -#: ../src/Doc/install/index.rst:550 +#: install/index.rst:550 msgid "" "These override options can be relative, absolute, or explicitly defined in " "terms of one of the installation base directories. (There are two " @@ -1018,7 +1014,7 @@ msgid "" "between Python and extension modules.)" msgstr "" -#: ../src/Doc/install/index.rst:559 +#: install/index.rst:559 msgid "" "For example, say you're installing a module distribution to your home " "directory under Unix---but you want scripts to go in :file:`~/scripts` " @@ -1029,7 +1025,7 @@ msgid "" "case)::" msgstr "" -#: ../src/Doc/install/index.rst:568 +#: install/index.rst:568 msgid "" "Another Unix example: suppose your Python installation was built and " "installed with a prefix of :file:`/usr/local/python`, so under a standard " @@ -1038,7 +1034,7 @@ msgid "" "directory for the :option:`--install-scripts` option::" msgstr "" -#: ../src/Doc/install/index.rst:576 +#: install/index.rst:576 msgid "" "(This performs an installation using the \"prefix scheme,\" where the prefix " "is whatever your Python interpreter was installed with--- :file:`/usr/local/" @@ -1046,7 +1042,7 @@ msgid "" msgstr "" # ae9d2a4cb0af4505afc433c5949ae3a3 -#: ../src/Doc/install/index.rst:580 +#: install/index.rst:580 msgid "" "If you maintain Python on Windows, you might want third-party modules to " "live in a subdirectory of :file:`{prefix}`, rather than right in :file:" @@ -1057,7 +1053,7 @@ msgid "" msgstr "" # bff0458bdeaa4b8fa8a89d6a8048aeb8 -#: ../src/Doc/install/index.rst:589 +#: install/index.rst:589 msgid "" "The specified installation directory is relative to :file:`{prefix}`. Of " "course, you also have to ensure that this directory is in Python's module " @@ -1066,7 +1062,7 @@ msgid "" "modify Python's search path." msgstr "" -#: ../src/Doc/install/index.rst:595 +#: install/index.rst:595 msgid "" "If you want to define an entire installation scheme, you just have to supply " "all of the installation directory options. The recommended way to do this " @@ -1076,19 +1072,19 @@ msgid "" "from, you might define the following installation scheme::" msgstr "" -#: ../src/Doc/install/index.rst:608 ../src/Doc/install/index.rst:631 +#: install/index.rst:608 install/index.rst:631 #, fuzzy msgid "or, equivalently, ::" msgstr "ou ::" -#: ../src/Doc/install/index.rst:616 +#: install/index.rst:616 msgid "" "``$PLAT`` is not (necessarily) an environment variable---it will be expanded " "by the Distutils as it parses your command line options, just as it does " "when parsing your configuration file(s)." msgstr "" -#: ../src/Doc/install/index.rst:620 +#: install/index.rst:620 msgid "" "Obviously, specifying the entire installation scheme every time you install " "a new module distribution would be very tedious. Thus, you can put these " @@ -1096,21 +1092,21 @@ msgid "" "files`)::" msgstr "" -#: ../src/Doc/install/index.rst:640 +#: install/index.rst:640 msgid "" "Note that these two are *not* equivalent if you supply a different " "installation base directory when you run the setup script. For example, ::" msgstr "" # 4c8fc07f345f4a0e9bcdfcd32f69390e -#: ../src/Doc/install/index.rst:645 +#: install/index.rst:645 msgid "" "would install pure modules to :file:`/tmp/python/lib` in the first case, and " "to :file:`/tmp/lib` in the second case. (For the second case, you probably " "want to supply an installation base of :file:`/tmp/python`.)" msgstr "" -#: ../src/Doc/install/index.rst:649 +#: install/index.rst:649 msgid "" "You probably noticed the use of ``$HOME`` and ``$PLAT`` in the sample " "configuration file input. These are Distutils configuration variables, " @@ -1123,11 +1119,11 @@ msgid "" "section :ref:`inst-config-files` for details." msgstr "" -#: ../src/Doc/install/index.rst:668 +#: install/index.rst:668 msgid "Modifying Python's Search Path" msgstr "" -#: ../src/Doc/install/index.rst:670 +#: install/index.rst:670 msgid "" "When the Python interpreter executes an :keyword:`import` statement, it " "searches for both Python code and extension modules along a search path. A " @@ -1136,12 +1132,12 @@ msgid "" "module and printing the value of ``sys.path``. ::" msgstr "" -#: ../src/Doc/install/index.rst:687 +#: install/index.rst:687 msgid "" "The null string in ``sys.path`` represents the current working directory." msgstr "" -#: ../src/Doc/install/index.rst:689 +#: install/index.rst:689 msgid "" "The expected convention for locally installed packages is to put them in " "the :file:`{...}/site-packages/` directory, but you may want to install " @@ -1152,7 +1148,7 @@ msgid "" "There are several different ways to add the directory." msgstr "" -#: ../src/Doc/install/index.rst:697 +#: install/index.rst:697 msgid "" "The most convenient way is to add a path configuration file to a directory " "that's already on Python's path, usually to the :file:`.../site-packages/` " @@ -1163,14 +1159,14 @@ msgid "" "this mechanism for installing fixed versions of standard modules.)" msgstr "" -#: ../src/Doc/install/index.rst:705 +#: install/index.rst:705 msgid "" "Paths can be absolute or relative, in which case they're relative to the " "directory containing the :file:`.pth` file. See the documentation of the :" "mod:`site` module for more information." msgstr "" -#: ../src/Doc/install/index.rst:709 +#: install/index.rst:709 msgid "" "A slightly less convenient way is to edit the :file:`site.py` file in " "Python's standard library, and modify ``sys.path``. :file:`site.py` is " @@ -1179,7 +1175,7 @@ msgid "" "simply edit :file:`site.py` and add two lines to it::" msgstr "" -#: ../src/Doc/install/index.rst:718 +#: install/index.rst:718 msgid "" "However, if you reinstall the same major version of Python (perhaps when " "upgrading from 2.2 to 2.2.2, for example) :file:`site.py` will be " @@ -1187,7 +1183,7 @@ msgid "" "modified and save a copy before doing the installation." msgstr "" -#: ../src/Doc/install/index.rst:723 +#: install/index.rst:723 msgid "" "There are two environment variables that can modify ``sys.path``. :envvar:" "`PYTHONHOME` sets an alternate value for the prefix of the Python " @@ -1196,7 +1192,7 @@ msgid "" "Y/', '/www/python/lib/pythonX.Y/plat-linux2', ...]``." msgstr "" -#: ../src/Doc/install/index.rst:729 +#: install/index.rst:729 msgid "" "The :envvar:`PYTHONPATH` variable can be set to a list of paths that will be " "added to the beginning of ``sys.path``. For example, if :envvar:" @@ -1206,17 +1202,17 @@ msgid "" "don't exist.)" msgstr "" -#: ../src/Doc/install/index.rst:736 +#: install/index.rst:736 msgid "" "Finally, ``sys.path`` is just a regular Python list, so any Python " "application can modify it by adding or removing entries." msgstr "" -#: ../src/Doc/install/index.rst:743 +#: install/index.rst:743 msgid "Distutils Configuration Files" msgstr "" -#: ../src/Doc/install/index.rst:745 +#: install/index.rst:745 msgid "" "As mentioned above, you can use Distutils configuration files to record " "personal or site preferences for any Distutils options. That is, any option " @@ -1228,76 +1224,76 @@ msgid "" "files are overridden by \"later\" files." msgstr "" -#: ../src/Doc/install/index.rst:758 +#: install/index.rst:758 msgid "Location and names of config files" msgstr "" -#: ../src/Doc/install/index.rst:760 +#: install/index.rst:760 msgid "" "The names and locations of the configuration files vary slightly across " "platforms. On Unix and Mac OS X, the three configuration files (in the " "order they are processed) are:" msgstr "" -#: ../src/Doc/install/index.rst:765 ../src/Doc/install/index.rst:777 +#: install/index.rst:765 install/index.rst:777 msgid "Location and filename" msgstr "" -#: ../src/Doc/install/index.rst:767 ../src/Doc/install/index.rst:779 +#: install/index.rst:767 install/index.rst:779 msgid "system" msgstr "" -#: ../src/Doc/install/index.rst:767 +#: install/index.rst:767 msgid ":file:`{prefix}/lib/python{ver}/distutils/distutils.cfg`" msgstr "" -#: ../src/Doc/install/index.rst:769 ../src/Doc/install/index.rst:781 +#: install/index.rst:769 install/index.rst:781 msgid "personal" msgstr "" -#: ../src/Doc/install/index.rst:769 +#: install/index.rst:769 msgid ":file:`$HOME/.pydistutils.cfg`" msgstr "" -#: ../src/Doc/install/index.rst:771 ../src/Doc/install/index.rst:783 +#: install/index.rst:771 install/index.rst:783 msgid "local" msgstr "" -#: ../src/Doc/install/index.rst:771 ../src/Doc/install/index.rst:783 +#: install/index.rst:771 install/index.rst:783 msgid ":file:`setup.cfg`" msgstr "" -#: ../src/Doc/install/index.rst:771 ../src/Doc/install/index.rst:783 +#: install/index.rst:771 install/index.rst:783 msgid "\\(3)" msgstr "\\(3)" -#: ../src/Doc/install/index.rst:774 +#: install/index.rst:774 msgid "And on Windows, the configuration files are:" msgstr "" -#: ../src/Doc/install/index.rst:779 +#: install/index.rst:779 msgid ":file:`{prefix}\\\\Lib\\\\distutils\\\\distutils.cfg`" msgstr "" -#: ../src/Doc/install/index.rst:779 +#: install/index.rst:779 msgid "\\(4)" msgstr "" -#: ../src/Doc/install/index.rst:781 +#: install/index.rst:781 msgid ":file:`%HOME%\\\\pydistutils.cfg`" msgstr "" -#: ../src/Doc/install/index.rst:781 +#: install/index.rst:781 msgid "\\(5)" msgstr "" -#: ../src/Doc/install/index.rst:786 +#: install/index.rst:786 msgid "" "On all platforms, the \"personal\" file can be temporarily disabled by " "passing the `--no-user-cfg` option." msgstr "" -#: ../src/Doc/install/index.rst:792 +#: install/index.rst:792 msgid "" "Strictly speaking, the system-wide configuration file lives in the directory " "where the Distutils are installed; under Python 1.6 and later on Unix, this " @@ -1306,7 +1302,7 @@ msgid "" "configuration file should be put there under Python 1.5.2." msgstr "" -#: ../src/Doc/install/index.rst:799 +#: install/index.rst:799 msgid "" "On Unix, if the :envvar:`HOME` environment variable is not defined, the " "user's home directory will be determined with the :func:`getpwuid` function " @@ -1314,12 +1310,12 @@ msgid "" "expanduser` function used by Distutils." msgstr "" -#: ../src/Doc/install/index.rst:805 +#: install/index.rst:805 msgid "" "I.e., in the current directory (usually the location of the setup script)." msgstr "" -#: ../src/Doc/install/index.rst:808 +#: install/index.rst:808 msgid "" "(See also note (1).) Under Python 1.6 and later, Python's default " "\"installation prefix\" is :file:`C:\\\\Python`, so the system configuration " @@ -1331,7 +1327,7 @@ msgid "" "Windows." msgstr "" -#: ../src/Doc/install/index.rst:817 +#: install/index.rst:817 msgid "" "On Windows, if the :envvar:`HOME` environment variable is not defined, :" "envvar:`USERPROFILE` then :envvar:`HOMEDRIVE` and :envvar:`HOMEPATH` will be " @@ -1339,11 +1335,11 @@ msgid "" "Distutils." msgstr "" -#: ../src/Doc/install/index.rst:826 +#: install/index.rst:826 msgid "Syntax of config files" msgstr "" -#: ../src/Doc/install/index.rst:828 +#: install/index.rst:828 msgid "" "The Distutils configuration files all have the same syntax. The config " "files are grouped into sections. There is one section for each Distutils " @@ -1352,13 +1348,13 @@ msgid "" "``option=value``." msgstr "" -#: ../src/Doc/install/index.rst:833 +#: install/index.rst:833 msgid "" "For example, the following is a complete config file that just forces all " "commands to run quietly by default::" msgstr "" -#: ../src/Doc/install/index.rst:839 +#: install/index.rst:839 msgid "" "If this is installed as the system config file, it will affect all " "processing of any Python module distribution by any user on the current " @@ -1368,18 +1364,18 @@ msgid "" "distribution, it affects only that distribution." msgstr "" -#: ../src/Doc/install/index.rst:846 +#: install/index.rst:846 msgid "" "You could override the default \"build base\" directory and make the :" "command:`build\\*` commands always forcibly rebuild all files with the " "following::" msgstr "" -#: ../src/Doc/install/index.rst:854 +#: install/index.rst:854 msgid "which corresponds to the command-line arguments ::" msgstr "" -#: ../src/Doc/install/index.rst:858 +#: install/index.rst:858 msgid "" "except that including the :command:`build` command on the command-line means " "that command will be run. Including a particular command in config files " @@ -1388,29 +1384,29 @@ msgid "" "values from it are run, they will use the values in the config file.)" msgstr "" -#: ../src/Doc/install/index.rst:864 +#: install/index.rst:864 msgid "" "You can find out the complete list of options for any command using the :" "option:`--help` option, e.g.::" msgstr "" -#: ../src/Doc/install/index.rst:869 +#: install/index.rst:869 msgid "" "and you can find out the complete list of global options by using :option:`--" "help` without a command::" msgstr "" -#: ../src/Doc/install/index.rst:874 +#: install/index.rst:874 msgid "" "See also the \"Reference\" section of the \"Distributing Python Modules\" " "manual." msgstr "" -#: ../src/Doc/install/index.rst:880 +#: install/index.rst:880 msgid "Building Extensions: Tips and Tricks" msgstr "" -#: ../src/Doc/install/index.rst:882 +#: install/index.rst:882 msgid "" "Whenever possible, the Distutils try to use the configuration information " "made available by the Python interpreter used to run the :file:`setup.py` " @@ -1420,11 +1416,11 @@ msgid "" "section discusses how to override the usual Distutils behaviour." msgstr "" -#: ../src/Doc/install/index.rst:893 +#: install/index.rst:893 msgid "Tweaking compiler/linker flags" msgstr "" -#: ../src/Doc/install/index.rst:895 +#: install/index.rst:895 msgid "" "Compiling a Python extension written in C or C++ will sometimes require " "specifying custom flags for the compiler and linker in order to use a " @@ -1433,7 +1429,7 @@ msgid "" "you're trying to cross-compile Python." msgstr "" -#: ../src/Doc/install/index.rst:901 +#: install/index.rst:901 msgid "" "In the most general case, the extension author might have foreseen that " "compiling the extensions would be complicated, and provided a :file:`Setup` " @@ -1442,18 +1438,18 @@ msgid "" "require elaborate sets of compiler flags in order to work." msgstr "" -#: ../src/Doc/install/index.rst:907 +#: install/index.rst:907 msgid "" "A :file:`Setup` file, if present, is parsed in order to get a list of " "extensions to build. Each line in a :file:`Setup` describes a single " "module. Lines have the following structure::" msgstr "" -#: ../src/Doc/install/index.rst:914 +#: install/index.rst:914 msgid "Let's examine each of the fields in turn." msgstr "" -#: ../src/Doc/install/index.rst:916 +#: install/index.rst:916 msgid "" "*module* is the name of the extension module to be built, and should be a " "valid Python identifier. You can't just change this in order to rename a " @@ -1461,7 +1457,7 @@ msgid "" "left alone." msgstr "" -#: ../src/Doc/install/index.rst:920 +#: install/index.rst:920 msgid "" "*sourcefile* is anything that's likely to be a source code file, at least " "judging by the filename. Filenames ending in :file:`.c` are assumed to be " @@ -1470,38 +1466,38 @@ msgid "" "assumed to be in Objective C." msgstr "" -#: ../src/Doc/install/index.rst:926 +#: install/index.rst:926 msgid "" "*cpparg* is an argument for the C preprocessor, and is anything starting " "with :option:`-I`, :option:`-D`, :option:`-U` or :option:`-C`." msgstr "" -#: ../src/Doc/install/index.rst:929 +#: install/index.rst:929 msgid "" "*library* is anything ending in :file:`.a` or beginning with :option:`-l` " "or :option:`-L`." msgstr "" -#: ../src/Doc/install/index.rst:932 +#: install/index.rst:932 msgid "" "If a particular platform requires a special library on your platform, you " "can add it by editing the :file:`Setup` file and running ``python setup.py " "build``. For example, if the module defined by the line ::" msgstr "" -#: ../src/Doc/install/index.rst:938 +#: install/index.rst:938 msgid "" "must be linked with the math library :file:`libm.a` on your platform, simply " "add :option:`-lm` to the line::" msgstr "" -#: ../src/Doc/install/index.rst:943 +#: install/index.rst:943 msgid "" "Arbitrary switches intended for the compiler or the linker can be supplied " "with the :option:`-Xcompiler` *arg* and :option:`-Xlinker` *arg* options::" msgstr "" -#: ../src/Doc/install/index.rst:948 +#: install/index.rst:948 msgid "" "The next option after :option:`-Xcompiler` and :option:`-Xlinker` will be " "appended to the proper command line, so in the above example the compiler " @@ -1512,22 +1508,22 @@ msgid "" "++``." msgstr "" -#: ../src/Doc/install/index.rst:955 +#: install/index.rst:955 msgid "" "Compiler flags can also be supplied through setting the :envvar:`CFLAGS` " "environment variable. If set, the contents of :envvar:`CFLAGS` will be " "added to the compiler flags specified in the :file:`Setup` file." msgstr "" -#: ../src/Doc/install/index.rst:963 +#: install/index.rst:963 msgid "Using non-Microsoft compilers on Windows" msgstr "" -#: ../src/Doc/install/index.rst:970 +#: install/index.rst:970 msgid "Borland/CodeGear C++" msgstr "" -#: ../src/Doc/install/index.rst:972 +#: install/index.rst:972 msgid "" "This subsection describes the necessary steps to use Distutils with the " "Borland C++ compiler version 5.5. First you have to know that Borland's " @@ -1538,7 +1534,7 @@ msgid "" "`python25.lib` into the Borland format. You can do this as follows:" msgstr "" -#: ../src/Doc/install/index.rst:987 +#: install/index.rst:987 msgid "" "The :file:`coff2omf` program comes with the Borland compiler. The file :" "file:`python25.lib` is in the :file:`Libs` directory of your Python " @@ -1546,13 +1542,13 @@ msgid "" "to convert them too." msgstr "" -#: ../src/Doc/install/index.rst:992 +#: install/index.rst:992 msgid "" "The converted files have to reside in the same directories as the normal " "libraries." msgstr "" -#: ../src/Doc/install/index.rst:995 +#: install/index.rst:995 msgid "" "How does Distutils manage to use these libraries with their changed names? " "If the extension needs a library (eg. :file:`foo`) Distutils checks first if " @@ -1561,48 +1557,44 @@ msgid "" "it uses the default name (:file:`foo.lib`.) [#]_" msgstr "" -#: ../src/Doc/install/index.rst:1001 +#: install/index.rst:1001 msgid "" "To let Distutils compile your extension with Borland C++ you now have to " "type::" msgstr "" -#: ../src/Doc/install/index.rst:1005 +#: install/index.rst:1005 msgid "" "If you want to use the Borland C++ compiler as the default, you could " "specify this in your personal or system-wide configuration file for " "Distutils (see section :ref:`inst-config-files`.)" msgstr "" -# 59a30694c572445eac53fc45d60dd7a9 -#: ../src/Doc/install/index.rst:1013 -msgid "`C++Builder Compiler `_" +#: install/index.rst:1014 +msgid "C++Builder Compiler" msgstr "" -#: ../src/Doc/install/index.rst:1013 +#: install/index.rst:1013 msgid "" "Information about the free C++ compiler from Borland, including links to the " "download pages." msgstr "" -# 0d82710261f94ebe8bd82a8a381ddec6 -#: ../src/Doc/install/index.rst:1016 -msgid "" -"`Creating Python Extensions Using Borland's Free Compiler `_" +#: install/index.rst:1017 +msgid "Creating Python Extensions Using Borland's Free Compiler" msgstr "" -#: ../src/Doc/install/index.rst:1017 +#: install/index.rst:1017 msgid "" "Document describing how to use Borland's free command-line C++ compiler to " "build Python." msgstr "" -#: ../src/Doc/install/index.rst:1022 +#: install/index.rst:1022 msgid "GNU C / Cygwin / MinGW" msgstr "" -#: ../src/Doc/install/index.rst:1024 +#: install/index.rst:1024 msgid "" "This section describes the necessary steps to use Distutils with the GNU C/C+" "+ compilers in their Cygwin and MinGW distributions. [#]_ For a Python " @@ -1611,7 +1603,7 @@ msgid "" msgstr "" # 490b1d959cfd49489752fa9f434c777a -#: ../src/Doc/install/index.rst:1029 +#: install/index.rst:1029 msgid "" "Not all extensions can be built with MinGW or Cygwin, but many can. " "Extensions most likely to not work are those that use C++ or depend on " @@ -1619,16 +1611,16 @@ msgid "" msgstr "" # 5f12c61d263e41eb8aec627175bafbe6 -#: ../src/Doc/install/index.rst:1033 +#: install/index.rst:1033 msgid "To let Distutils compile your extension with Cygwin you have to type::" msgstr "" -#: ../src/Doc/install/index.rst:1037 +#: install/index.rst:1037 msgid "and for Cygwin in no-cygwin mode [#]_ or for MinGW type::" msgstr "" # 3ca06e91732b4192850f3fbc184243e8 -#: ../src/Doc/install/index.rst:1041 +#: install/index.rst:1041 msgid "" "If you want to use any of these options/compilers as default, you should " "consider writing it in your personal or system-wide configuration file for " @@ -1636,12 +1628,12 @@ msgid "" msgstr "" # 874b1377e9db4edf9c789695f5fc0068 -#: ../src/Doc/install/index.rst:1046 +#: install/index.rst:1046 msgid "Older Versions of Python and MinGW" msgstr "" # 2a9a8106da2e4218a0d342fdb226bdd1 -#: ../src/Doc/install/index.rst:1047 +#: install/index.rst:1047 msgid "" "The following instructions only apply if you're using a version of Python " "inferior to 2.4.1 with a MinGW inferior to 3.0.0 (with " @@ -1649,7 +1641,7 @@ msgid "" msgstr "" # 6ff303073be8449fa1ff889432a626ca -#: ../src/Doc/install/index.rst:1051 +#: install/index.rst:1051 msgid "" "These compilers require some special libraries. This task is more complex " "than for Borland's C++, because there is no program to convert the library. " @@ -1658,7 +1650,7 @@ msgid "" "projects/mingw/files/MinGW/Extension/pexports/)." msgstr "" -#: ../src/Doc/install/index.rst:1064 +#: install/index.rst:1064 msgid "" "The location of an installed :file:`python25.dll` will depend on the " "installation options and the version and language of Windows. In a \"just " @@ -1667,55 +1659,52 @@ msgid "" "directory." msgstr "" -#: ../src/Doc/install/index.rst:1069 +#: install/index.rst:1069 msgid "" "Then you can create from these information an import library for gcc. ::" msgstr "" -#: ../src/Doc/install/index.rst:1073 +#: install/index.rst:1073 msgid "" "The resulting library has to be placed in the same directory as :file:" "`python25.lib`. (Should be the :file:`libs` directory under your Python " "installation directory.)" msgstr "" -#: ../src/Doc/install/index.rst:1077 +#: install/index.rst:1077 msgid "" "If your extension uses other libraries (zlib,...) you might have to convert " "them too. The converted files have to reside in the same directories as the " "normal libraries do." msgstr "" -# c4a1647f246a41e0b75d7b7f7d8b094c -#: ../src/Doc/install/index.rst:1083 -msgid "" -"`Building Python modules on MS Windows platform with MinGW `_" +#: install/index.rst:1084 +msgid "Building Python modules on MS Windows platform with MinGW" msgstr "" -#: ../src/Doc/install/index.rst:1085 +#: install/index.rst:1085 msgid "" "Information about building the required libraries for the MinGW environment." msgstr "" -#: ../src/Doc/install/index.rst:1089 +#: install/index.rst:1089 msgid "Footnotes" msgstr "Notes" -#: ../src/Doc/install/index.rst:1090 +#: install/index.rst:1090 msgid "" "This also means you could replace all existing COFF-libraries with OMF-" "libraries of the same name." msgstr "" # 0400267d88c04bf394dfdc349b915af3 -#: ../src/Doc/install/index.rst:1093 +#: install/index.rst:1093 msgid "" "Check http://www.sourceware.org/cygwin/ and http://www.mingw.org/ for more " "information" msgstr "" -#: ../src/Doc/install/index.rst:1096 +#: install/index.rst:1096 msgid "" "Then you have no POSIX emulation available, but you also don't need :file:" "`cygwin1.dll`." diff --git a/installing.po b/installing.po new file mode 100644 index 00000000..6cc139c9 --- /dev/null +++ b/installing.po @@ -0,0 +1,296 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 1990-2015, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR , YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 2.7\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME \n" +"Language-Team: LANGUAGE \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: installing/index.rst:7 +msgid "Installing Python Modules" +msgstr "" + +#: installing/index.rst:9 +msgid "distutils-sig@python.org" +msgstr "" + +#: installing/index.rst:11 +msgid "" +"As a popular open source development project, Python has an active " +"supporting community of contributors and users that also make their software " +"available for other Python developers to use under open source license terms." +msgstr "" + +#: installing/index.rst:15 +msgid "" +"This allows Python users to share and collaborate effectively, benefiting " +"from the solutions others have already created to common (and sometimes even " +"rare!) problems, as well as potentially contributing their own solutions to " +"the common pool." +msgstr "" + +#: installing/index.rst:20 +msgid "" +"This guide covers the installation part of the process. For a guide to " +"creating and sharing your own Python projects, refer to the :ref:" +"`distribution guide `." +msgstr "" + +#: installing/index.rst:26 +msgid "" +"For corporate and other institutional users, be aware that many " +"organisations have their own policies around using and contributing to open " +"source software. Please take such policies into account when making use of " +"the distribution and installation tools provided with Python." +msgstr "" + +#: installing/index.rst:33 +msgid "Key terms" +msgstr "" + +#: installing/index.rst:35 +msgid "" +"``pip`` is the preferred installer program. Starting with Python 2.7.9, it " +"is included by default with the Python binary installers." +msgstr "" + +#: installing/index.rst:37 +msgid "" +"a virtual environment is a semi-isolated Python environment that allows " +"packages to be installed for use by a particular application, rather than " +"being installed system wide" +msgstr "" + +#: installing/index.rst:40 +msgid "" +"``virtualenv`` is a third party tools for creating virtual environments, it " +"is defaults to installing ``pip`` into all created virtual environments." +msgstr "" + +#: installing/index.rst:42 +msgid "" +"the `Python Packaging Index `__ is a public " +"repository of open source licensed packages made available for use by other " +"Python users" +msgstr "" + +#: installing/index.rst:45 +msgid "" +"the `Python Packaging Authority `__ are the group of developers and documentation authors " +"responsible for the maintenance and evolution of the standard packaging " +"tools and the associated metadata and file format standards. They maintain a " +"variety of tools, documentation and issue trackers on both `GitHub `__ and `BitBucket `__." +msgstr "" + +#: installing/index.rst:52 +msgid "" +"``distutils`` is the original build and distribution system first added to " +"the Python standard library in 1998. While direct use of ``distutils`` is " +"being phased out, it still laid the foundation for the current packaging and " +"distribution infrastructure, and it not only remains part of the standard " +"library, but its name lives on in other ways (such as the name of the " +"mailing list used to coordinate Python packaging standards development)." +msgstr "" + +#: installing/index.rst:62 +msgid "Basic usage" +msgstr "" + +#: installing/index.rst:64 +msgid "" +"The standard packaging tools are all designed to be used from the command " +"line." +msgstr "" + +#: installing/index.rst:67 +msgid "" +"The following command will install the latest version of a module and its " +"dependencies from the Python Packaging Index::" +msgstr "" + +#: installing/index.rst:74 +msgid "" +"For POSIX users (including Mac OS X and Linux users), the examples in this " +"guide assume the use of a :term:`virtual environment`. You may install " +"``virtualenv`` to provide such environments using either pip (``pip install " +"virtualenv``) or through your system package manager (commonly called " +"``virtualenv`` or ``python-virtualenv``)." +msgstr "" + +#: installing/index.rst:80 +msgid "" +"For Windows users, the examples in this guide assume that the option to " +"adjust the system PATH environment variable was selected when installing " +"Python." +msgstr "" + +#: installing/index.rst:84 +msgid "" +"It's also possible to specify an exact or minimum version directly on the " +"command line::" +msgstr "" + +#: installing/index.rst:90 +msgid "" +"Normally, if a suitable module is already installed, attempting to install " +"it again will have no effect. Upgrading existing modules must be requested " +"explicitly::" +msgstr "" + +#: installing/index.rst:96 +msgid "" +"More information and resources regarding ``pip`` and its capabilities can be " +"found in the `Python Packaging User Guide `__." +msgstr "" + +#: installing/index.rst:101 +msgid "" +"`Python Packaging User Guide: Installing Python Distribution Packages " +"`__" +msgstr "" + +#: installing/index.rst:106 +msgid "How do I ...?" +msgstr "" + +#: installing/index.rst:108 +msgid "These are quick answers or links for some common tasks." +msgstr "" + +#: installing/index.rst:111 +msgid "... install ``pip`` in versions of Python prior to Python 2.7.9?" +msgstr "" + +#: installing/index.rst:113 +msgid "" +"Python only started bundling ``pip`` with Python 2.7.9. For earlier " +"versions, ``pip`` needs to be \"bootstrapped\" as described in the Python " +"Packaging User Guide." +msgstr "" + +#: installing/index.rst:119 +msgid "" +"`Python Packaging User Guide: Setup for Installing Distribution Packages " +"`__" +msgstr "" + +#: installing/index.rst:126 +msgid "... install packages just for the current user?" +msgstr "" + +#: installing/index.rst:128 +msgid "" +"Passing the ``--user`` option to ``python -m pip install`` will install a " +"package just for the current user, rather than for all users of the system." +msgstr "" + +#: installing/index.rst:133 +msgid "... install scientific Python packages?" +msgstr "" + +#: installing/index.rst:135 +msgid "" +"A number of scientific Python packages have complex binary dependencies, and " +"aren't currently easy to install using ``pip`` directly. At this point in " +"time, it will often be easier for users to install these packages by `other " +"means `__ rather than " +"attempting to install them with ``pip``." +msgstr "" + +#: installing/index.rst:144 +msgid "" +"`Python Packaging User Guide: Installing Scientific Packages `__" +msgstr "" + +#: installing/index.rst:149 +msgid "... work with multiple versions of Python installed in parallel?" +msgstr "" + +#: installing/index.rst:151 +msgid "" +"On Linux, Mac OS X and other POSIX systems, use the versioned Python " +"commands in combination with the ``-m`` switch to run the appropriate copy " +"of ``pip``::" +msgstr "" + +#: installing/index.rst:160 +msgid "(appropriately versioned ``pip`` commands may also be available)" +msgstr "" + +#: installing/index.rst:162 +msgid "" +"On Windows, use the ``py`` Python launcher in combination with the ``-m`` " +"switch::" +msgstr "" + +#: installing/index.rst:179 +msgid "Common installation issues" +msgstr "" + +#: installing/index.rst:182 +msgid "Installing into the system Python on Linux" +msgstr "" + +#: installing/index.rst:184 +msgid "" +"On Linux systems, a Python installation will typically be included as part " +"of the distribution. Installing into this Python installation requires root " +"access to the system, and may interfere with the operation of the system " +"package manager and other components of the system if a component is " +"unexpectedly upgraded using ``pip``." +msgstr "" + +#: installing/index.rst:190 +msgid "" +"On such systems, it is often better to use a virtual environment or a per-" +"user installation when installing packages with ``pip``." +msgstr "" + +#: installing/index.rst:195 +msgid "Installing binary extensions" +msgstr "" + +#: installing/index.rst:197 +msgid "" +"Python has typically relied heavily on source based distribution, with end " +"users being expected to compile extension modules from source as part of the " +"installation process." +msgstr "" + +#: installing/index.rst:201 +msgid "" +"With the introduction of support for the binary ``wheel`` format, and the " +"ability to publish wheels for at least Windows and Mac OS X through the " +"Python Packaging Index, this problem is expected to diminish over time, as " +"users are more regularly able to install pre-built extensions rather than " +"needing to build them themselves." +msgstr "" + +#: installing/index.rst:207 +msgid "" +"Some of the solutions for installing `scientific software `__ that is not yet available as pre-built " +"``wheel`` files may also help with obtaining other binary extensions without " +"needing to build them locally." +msgstr "" + +#: installing/index.rst:214 +msgid "" +"`Python Packaging User Guide: Binary Extensions `__" +msgstr "" diff --git a/library.po b/library.po index 9c259285..09a3fbd2 100644 --- a/library.po +++ b/library.po @@ -7,21 +7,21 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-17 04:01\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/library/2to3.rst:4 +#: library/2to3.rst:4 msgid "2to3 - Automated Python 2 to 3 code translation" msgstr "2to3 - Automatise la traduction du code de Python 2 vers Python 3" -#: ../src/Doc/library/2to3.rst:8 +#: library/2to3.rst:8 msgid "" "2to3 is a Python program that reads Python 2.x source code and applies a " "series of *fixers* to transform it into valid Python 3.x code. The standard " @@ -32,11 +32,11 @@ msgid "" "needs to be edited automatically." msgstr "" -#: ../src/Doc/library/2to3.rst:20 +#: library/2to3.rst:20 msgid "Using 2to3" msgstr "Utilisation de 2to3" -#: ../src/Doc/library/2to3.rst:22 +#: library/2to3.rst:22 msgid "" "2to3 will usually be installed with the Python interpreter as a script. It " "is also located in the :file:`Tools/scripts` directory of the Python root." @@ -46,21 +46,21 @@ msgstr "" "racine de Python." # d8025665018b47d3a20c2069cdeb4714 -#: ../src/Doc/library/2to3.rst:25 +#: library/2to3.rst:25 msgid "" "2to3's basic arguments are a list of files or directories to transform. The " "directories are recursively traversed for Python sources." msgstr "" -#: ../src/Doc/library/2to3.rst:28 +#: library/2to3.rst:28 msgid "Here is a sample Python 2.x source file, :file:`example.py`::" msgstr "Voici un exemple de fichier source Python 2.x, :file:`example.py`::" -#: ../src/Doc/library/2to3.rst:36 +#: library/2to3.rst:36 msgid "It can be converted to Python 3.x code via 2to3 on the command line::" msgstr "Il peut être converti en Python 3.x via la commande 2to3::" -#: ../src/Doc/library/2to3.rst:40 +#: library/2to3.rst:40 msgid "" "A diff against the original source file is printed. 2to3 can also write the " "needed modifications right back to the source file. (A backup of the " @@ -68,12 +68,12 @@ msgid "" "changes back is enabled with the :option:`-w` flag::" msgstr "" -#: ../src/Doc/library/2to3.rst:47 +#: library/2to3.rst:47 #, fuzzy msgid "After transformation, :file:`example.py` looks like this::" msgstr "Après transformation,: file:`exemple.py` ressemble à ceci::" -#: ../src/Doc/library/2to3.rst:55 +#: library/2to3.rst:55 #, fuzzy msgid "" "Comments and exact indentation are preserved throughout the translation " @@ -82,7 +82,7 @@ msgstr "" "Les commentaires et l'indentation exacte sont préservés tout au long du " "processus de traduction." -#: ../src/Doc/library/2to3.rst:57 +#: library/2to3.rst:57 msgid "" "By default, 2to3 runs a set of :ref:`predefined fixers <2to3-fixers>`. The :" "option:`-l` flag lists all available fixers. An explicit set of fixers to " @@ -91,22 +91,22 @@ msgid "" "``has_key`` fixers::" msgstr "" -#: ../src/Doc/library/2to3.rst:64 +#: library/2to3.rst:64 msgid "This command runs every fixer except the ``apply`` fixer::" msgstr "" -#: ../src/Doc/library/2to3.rst:68 +#: library/2to3.rst:68 msgid "" "Some fixers are *explicit*, meaning they aren't run by default and must be " "listed on the command line to be run. Here, in addition to the default " "fixers, the ``idioms`` fixer is run::" msgstr "" -#: ../src/Doc/library/2to3.rst:74 +#: library/2to3.rst:74 msgid "Notice how passing ``all`` enables all default fixers." msgstr "" -#: ../src/Doc/library/2to3.rst:76 +#: library/2to3.rst:76 msgid "" "Sometimes 2to3 will find a place in your source code that needs to be " "changed, but 2to3 cannot fix automatically. In this case, 2to3 will print a " @@ -114,7 +114,7 @@ msgid "" "order to have compliant 3.x code." msgstr "" -#: ../src/Doc/library/2to3.rst:81 +#: library/2to3.rst:81 msgid "" "2to3 can also refactor doctests. To enable this mode, use the :option:`-d` " "flag. Note that *only* doctests will be refactored. This also doesn't " @@ -122,14 +122,14 @@ msgid "" "in a reST document could also be refactored with this option." msgstr "" -#: ../src/Doc/library/2to3.rst:86 +#: library/2to3.rst:86 msgid "" "The :option:`-v` option enables output of more information on the " "translation process." msgstr "" # 06f5945b23f944859d1d92c61d49777c -#: ../src/Doc/library/2to3.rst:89 +#: library/2to3.rst:89 msgid "" "Since some print statements can be parsed as function calls or statements, " "2to3 cannot always read files containing the print function. When 2to3 " @@ -141,7 +141,7 @@ msgid "" msgstr "" # 2e044cc5e805477cbd515b0d2a1fdda0 -#: ../src/Doc/library/2to3.rst:97 +#: library/2to3.rst:97 msgid "" "The :option:`-o` or :option:`--output-dir` option allows specification of an " "alternate directory for processed output files to be written to. The :" @@ -153,8 +153,12 @@ msgstr "" "est requis quand on les utilise comme fichiers de sauvegarde qui n'ont pas " "de sens si les fichiers d'entrée ne sont pas écrasés." +#: library/2to3.rst:102 +msgid "The :option:`-o` option was added." +msgstr "" + # 9333b6cd68b640d19fea814caa1c9ce3 -#: ../src/Doc/library/2to3.rst:105 +#: library/2to3.rst:105 msgid "" "The :option:`-W` or :option:`--write-unchanged-files` flag tells 2to3 to " "always write output files even if no changes were required to the file. " @@ -163,8 +167,12 @@ msgid "" "implies the :option:`-w` flag as it would not make sense otherwise." msgstr "" +#: library/2to3.rst:111 +msgid "The :option:`-W` flag was added." +msgstr "" + # 6585b2dd48674cbb8c6653ba8cb2e578 -#: ../src/Doc/library/2to3.rst:114 +#: library/2to3.rst:114 msgid "" "The :option:`--add-suffix` option specifies a string to append to all output " "filenames. The :option:`-n` flag is required when specifying this as " @@ -176,153 +184,157 @@ msgstr "" "l'écriture de noms de fichiers différents. Exemple ::" # 644163ad41764e979ada8433688d63e5 -#: ../src/Doc/library/2to3.rst:120 +#: library/2to3.rst:120 msgid "Will cause a converted file named ``example.py3`` to be written." msgstr "" +#: library/2to3.rst:122 +msgid "The :option:`--add-suffix` option was added." +msgstr "" + # e317f931a6574ba49f7ccd31f2f1defb -#: ../src/Doc/library/2to3.rst:125 +#: library/2to3.rst:125 msgid "To translate an entire project from one directory tree to another use::" msgstr "" -#: ../src/Doc/library/2to3.rst:133 +#: library/2to3.rst:133 msgid "Fixers" msgstr " Correcteurs" -#: ../src/Doc/library/2to3.rst:135 +#: library/2to3.rst:135 msgid "" "Each step of transforming code is encapsulated in a fixer. The command " "``2to3 -l`` lists them. As :ref:`documented above <2to3-using>`, each can " "be turned on and off individually. They are described here in more detail." msgstr "" -#: ../src/Doc/library/2to3.rst:142 +#: library/2to3.rst:142 msgid "" "Removes usage of :func:`apply`. For example ``apply(function, *args, " "**kwargs)`` is converted to ``function(*args, **kwargs)``." msgstr "" # 30d3d21211b349368b8106a2b85c72c4 -#: ../src/Doc/library/2to3.rst:147 +#: library/2to3.rst:147 msgid "Replaces deprecated :mod:`unittest` method names with the correct ones." msgstr "" "Remplace les noms de méthodes obsolètes du module :mod:`unittest` par les " "bons." -#: ../src/Doc/library/2to3.rst:150 ../src/Doc/library/time.rst:96 +#: library/2to3.rst:150 library/time.rst:94 msgid "From" msgstr "" -#: ../src/Doc/library/2to3.rst:150 ../src/Doc/library/time.rst:96 +#: library/2to3.rst:150 library/time.rst:94 msgid "To" msgstr "" # 45ae5c8ffdc7482eadcecb98f0114ede -#: ../src/Doc/library/2to3.rst:152 +#: library/2to3.rst:152 msgid "``failUnlessEqual(a, b)``" msgstr "" # c03960ecab784b56aee4cb80bc6b8470 # 9b6b51e7c3f24990bbde6e323d700ab6 -#: ../src/Doc/library/2to3.rst:152 ../src/Doc/library/2to3.rst:154 +#: library/2to3.rst:152 library/2to3.rst:154 msgid ":meth:`assertEqual(a, b) `" msgstr "" # d89241f58edb43a0b192e6b3c152bb03 -#: ../src/Doc/library/2to3.rst:154 +#: library/2to3.rst:154 msgid "``assertEquals(a, b)``" msgstr "" # fcdda3461ac14c9ab6233d15753c3924 -#: ../src/Doc/library/2to3.rst:156 +#: library/2to3.rst:156 msgid "``failIfEqual(a, b)``" msgstr "" # 1cb0bf183f9e4df2a473f5ae7b3fadc0 # bb3fcccfd53844d29da90cf92623ee92 -#: ../src/Doc/library/2to3.rst:156 ../src/Doc/library/2to3.rst:158 +#: library/2to3.rst:156 library/2to3.rst:158 msgid ":meth:`assertNotEqual(a, b) `" msgstr "" # d89241f58edb43a0b192e6b3c152bb03 -#: ../src/Doc/library/2to3.rst:158 +#: library/2to3.rst:158 msgid "``assertNotEquals(a, b)``" msgstr "" # c63856aac6e342ee90de5de8eb953d99 -#: ../src/Doc/library/2to3.rst:160 +#: library/2to3.rst:160 msgid "``failUnless(a)``" msgstr "" # aa6a196b1bee482fb292bc5a7ad380fd # 73850dfd296b48dc8067589ac9fe1b60 -#: ../src/Doc/library/2to3.rst:160 ../src/Doc/library/2to3.rst:162 +#: library/2to3.rst:160 library/2to3.rst:162 msgid ":meth:`assertTrue(a) `" msgstr "" # 1799e42ae494405797a6e9de21f8999e -#: ../src/Doc/library/2to3.rst:162 +#: library/2to3.rst:162 msgid "``assert_(a)``" msgstr "" # 1799e42ae494405797a6e9de21f8999e -#: ../src/Doc/library/2to3.rst:164 +#: library/2to3.rst:164 msgid "``failIf(a)``" msgstr "``failIf(a)``" # c34a633a352c46eab5af572135928df5 -#: ../src/Doc/library/2to3.rst:164 +#: library/2to3.rst:164 msgid ":meth:`assertFalse(a) `" msgstr ":meth:`assertFalse(a) `" # 8ea965f3397b4a89b96dde7ed59a56f8 -#: ../src/Doc/library/2to3.rst:166 +#: library/2to3.rst:166 msgid "``failUnlessRaises(exc, cal)``" msgstr "" # 0e461d1375cc49ea93affebf9a47056c -#: ../src/Doc/library/2to3.rst:166 +#: library/2to3.rst:166 msgid ":meth:`assertRaises(exc, cal) `" msgstr "" # 377455ce1bfa4f42856c0d780c153b6e -#: ../src/Doc/library/2to3.rst:168 +#: library/2to3.rst:168 msgid "``failUnlessAlmostEqual(a, b)``" msgstr "" # d395c4d788034f6999bece16a3b962bf # e0eb3a3ad8a24e76a82e45d5b21d06bf -#: ../src/Doc/library/2to3.rst:168 ../src/Doc/library/2to3.rst:170 +#: library/2to3.rst:168 library/2to3.rst:170 msgid ":meth:`assertAlmostEqual(a, b) `" msgstr "" # eba35504d2d941d89cf5edb18dc449ab -#: ../src/Doc/library/2to3.rst:170 +#: library/2to3.rst:170 msgid "``assertAlmostEquals(a, b)``" msgstr "" # 63cd9a8a2cea495591f3ed3999fc23dd -#: ../src/Doc/library/2to3.rst:172 +#: library/2to3.rst:172 msgid "``failIfAlmostEqual(a, b)``" msgstr "" # 46963f36a52944218c2e07e81054dc38 # 19c9130504d84d1ea39f687c51ccea4c -#: ../src/Doc/library/2to3.rst:172 ../src/Doc/library/2to3.rst:174 +#: library/2to3.rst:172 library/2to3.rst:174 msgid "" ":meth:`assertNotAlmostEqual(a, b) `" msgstr "" # 54f64dbb8a4e4227b979e24545e54fe3 -#: ../src/Doc/library/2to3.rst:174 +#: library/2to3.rst:174 msgid "``assertNotAlmostEquals(a, b)``" msgstr "" -#: ../src/Doc/library/2to3.rst:180 +#: library/2to3.rst:180 msgid "Converts :class:`basestring` to :class:`str`." msgstr "" -#: ../src/Doc/library/2to3.rst:184 +#: library/2to3.rst:184 msgid "" "Converts :class:`buffer` to :class:`memoryview`. This fixer is optional " "because the :class:`memoryview` API is similar but not exactly the same as " @@ -330,7 +342,7 @@ msgid "" msgstr "" # 227984399a1f47fcac06f8603a84c0c8 -#: ../src/Doc/library/2to3.rst:190 +#: library/2to3.rst:190 msgid "" "Converts ``callable(x)`` to ``isinstance(x, collections.Callable)``, adding " "an import to :mod:`collections` if needed. Note ``callable(x)`` has returned " @@ -338,7 +350,7 @@ msgid "" "disable this fixer." msgstr "" -#: ../src/Doc/library/2to3.rst:197 +#: library/2to3.rst:197 msgid "" "Fixes dictionary iteration methods. :meth:`dict.iteritems` is converted to :" "meth:`dict.items`, :meth:`dict.iterkeys` to :meth:`dict.keys`, and :meth:" @@ -349,21 +361,21 @@ msgid "" "keys`, and :meth:`dict.values` in a call to :class:`list`." msgstr "" -#: ../src/Doc/library/2to3.rst:207 +#: library/2to3.rst:207 msgid "Converts ``except X, T`` to ``except X as T``." msgstr "" -#: ../src/Doc/library/2to3.rst:211 +#: library/2to3.rst:211 msgid "Converts the :keyword:`exec` statement to the :func:`exec` function." msgstr "" -#: ../src/Doc/library/2to3.rst:215 +#: library/2to3.rst:215 msgid "" "Removes usage of :func:`execfile`. The argument to :func:`execfile` is " "wrapped in calls to :func:`open`, :func:`compile`, and :func:`exec`." msgstr "" -#: ../src/Doc/library/2to3.rst:220 +#: library/2to3.rst:220 msgid "" "Changes assignment of :attr:`sys.exitfunc` to use of the :mod:`atexit` " "module." @@ -371,29 +383,29 @@ msgstr "" "change l'affectation de :attr:`sys.exitfunc` pour utiliser le module :mod:" "`atexit`." -#: ../src/Doc/library/2to3.rst:225 +#: library/2to3.rst:225 msgid "Wraps :func:`filter` usage in a :class:`list` call." msgstr "" -#: ../src/Doc/library/2to3.rst:229 +#: library/2to3.rst:229 msgid "" "Fixes function attributes that have been renamed. For example, " "``my_function.func_closure`` is converted to ``my_function.__closure__``." msgstr "" -#: ../src/Doc/library/2to3.rst:234 +#: library/2to3.rst:234 msgid "Removes ``from __future__ import new_feature`` statements." msgstr "" -#: ../src/Doc/library/2to3.rst:238 +#: library/2to3.rst:238 msgid "Renames :func:`os.getcwdu` to :func:`os.getcwd`." msgstr "" -#: ../src/Doc/library/2to3.rst:242 +#: library/2to3.rst:242 msgid "Changes ``dict.has_key(key)`` to ``key in dict``." msgstr "Change ``dict.has_key(key)`` en ``key in dict``." -#: ../src/Doc/library/2to3.rst:246 +#: library/2to3.rst:246 msgid "" "This optional fixer performs several transformations that make Python code " "more idiomatic. Type comparisons like ``type(x) is SomeClass`` and " @@ -402,19 +414,19 @@ msgid "" "func:`sorted` in appropriate places. For example, this block ::" msgstr "" -#: ../src/Doc/library/2to3.rst:255 +#: library/2to3.rst:255 msgid "is changed to ::" msgstr "" -#: ../src/Doc/library/2to3.rst:261 +#: library/2to3.rst:261 msgid "Detects sibling imports and converts them to relative imports." msgstr "" -#: ../src/Doc/library/2to3.rst:265 +#: library/2to3.rst:265 msgid "Handles module renames in the standard library." msgstr "" -#: ../src/Doc/library/2to3.rst:269 +#: library/2to3.rst:269 msgid "" "Handles other modules renames in the standard library. It is separate from " "the :2to3fixer:`imports` fixer only because of technical limitations." @@ -423,30 +435,30 @@ msgstr "" "distinct de :2to3fixer:`imports` seulement en raison de limitations " "techniques." -#: ../src/Doc/library/2to3.rst:274 +#: library/2to3.rst:274 #, fuzzy -msgid "Converts ``input(prompt)`` to ``eval(input(prompt))``" +msgid "Converts ``input(prompt)`` to ``eval(input(prompt))``." msgstr "Convertit ``input(prompt)`` en ``eval(input(prompt))``." -#: ../src/Doc/library/2to3.rst:278 +#: library/2to3.rst:278 msgid "Converts :func:`intern` to :func:`sys.intern`." msgstr "Convertit :func:`intern` en :func:`sys.intern`." -#: ../src/Doc/library/2to3.rst:282 +#: library/2to3.rst:282 msgid "" "Fixes duplicate types in the second argument of :func:`isinstance`. For " "example, ``isinstance(x, (int, int))`` is converted to ``isinstance(x, " "(int))``." msgstr "" -#: ../src/Doc/library/2to3.rst:288 +#: library/2to3.rst:288 msgid "" "Removes imports of :func:`itertools.ifilter`, :func:`itertools.izip`, and :" "func:`itertools.imap`. Imports of :func:`itertools.ifilterfalse` are also " "changed to :func:`itertools.filterfalse`." msgstr "" -#: ../src/Doc/library/2to3.rst:294 +#: library/2to3.rst:294 msgid "" "Changes usage of :func:`itertools.ifilter`, :func:`itertools.izip`, and :" "func:`itertools.imap` to their built-in equivalents. :func:`itertools." @@ -454,18 +466,18 @@ msgid "" msgstr "" # b25499fd26294f1a8cb5b5bdd8b4e62e -#: ../src/Doc/library/2to3.rst:300 +#: library/2to3.rst:300 msgid "Renames :class:`long` to :class:`int`." msgstr "" -#: ../src/Doc/library/2to3.rst:304 +#: library/2to3.rst:304 msgid "" "Wraps :func:`map` in a :class:`list` call. It also changes ``map(None, x)`` " "to ``list(x)``. Using ``from future_builtins import map`` disables this " "fixer." msgstr "" -#: ../src/Doc/library/2to3.rst:310 +#: library/2to3.rst:310 msgid "" "Converts the old metaclass syntax (``__metaclass__ = Meta`` in the class " "body) to the new (``class X(metaclass=Meta)``)." @@ -473,18 +485,18 @@ msgstr "" "Convertit l'ancienne syntaxe de métaclasse (``__metaclass__ = Meta`` dans le " "corps de la classe) à la nouvelle (``class X(metaclasse = Meta) ``)." -#: ../src/Doc/library/2to3.rst:315 +#: library/2to3.rst:315 msgid "" "Fixes old method attribute names. For example, ``meth.im_func`` is " "converted to ``meth.__func__``." msgstr "" -#: ../src/Doc/library/2to3.rst:320 +#: library/2to3.rst:320 msgid "Converts the old not-equal syntax, ``<>``, to ``!=``." msgstr "" # 1df3424a5a324ba1844bf22aa3d2f3c2 -#: ../src/Doc/library/2to3.rst:324 +#: library/2to3.rst:324 msgid "" "Converts the use of iterator's :meth:`~iterator.next` methods to the :func:" "`next` function. It also renames :meth:`~iterator.next` methods to :meth:" @@ -492,27 +504,27 @@ msgid "" msgstr "" # 8e58e264894448029a4bea64035506c5 -#: ../src/Doc/library/2to3.rst:330 +#: library/2to3.rst:330 msgid "Renames :meth:`__nonzero__` to :meth:`~object.__bool__`." msgstr "Renomme :meth:`__nonzero__` en :meth:`~object.__bool__`." -#: ../src/Doc/library/2to3.rst:334 +#: library/2to3.rst:334 msgid "Converts octal literals into the new syntax." msgstr "" -#: ../src/Doc/library/2to3.rst:338 +#: library/2to3.rst:338 msgid "" "Add extra parenthesis where they are required in list comprehensions. For " "example, ``[x for x in 1, 2]`` becomes ``[x for x in (1, 2)]``." msgstr "" -#: ../src/Doc/library/2to3.rst:343 +#: library/2to3.rst:343 #, fuzzy msgid "Converts the :keyword:`print` statement to the :func:`print` function." msgstr "Convertit l'instruction ``print`` fonction :func:`print`." # 6a9430ffcc43426f9349420242fe43ef -#: ../src/Doc/library/2to3.rst:347 +#: library/2to3.rst:347 msgid "" "Converts ``raise E, V`` to ``raise E(V)``, and ``raise E, V, T`` to ``raise " "E(V).with_traceback(T)``. If ``E`` is a tuple, the translation will be " @@ -520,61 +532,61 @@ msgid "" "Python 3." msgstr "" -#: ../src/Doc/library/2to3.rst:353 +#: library/2to3.rst:353 msgid "Converts :func:`raw_input` to :func:`input`." msgstr "Convertit :func:`raw_input` en :func:`input`." -#: ../src/Doc/library/2to3.rst:357 +#: library/2to3.rst:357 msgid "Handles the move of :func:`reduce` to :func:`functools.reduce`." msgstr "" -#: ../src/Doc/library/2to3.rst:361 +#: library/2to3.rst:361 msgid "Changes :data:`sys.maxint` to :data:`sys.maxsize`." msgstr "" -#: ../src/Doc/library/2to3.rst:365 +#: library/2to3.rst:365 msgid "Replaces backtick repr with the :func:`repr` function." msgstr "" "Remplace les accents graves utilisés comme ``repr`` par des appels à :func:" "`repr`." -#: ../src/Doc/library/2to3.rst:369 +#: library/2to3.rst:369 msgid "" "Replaces use of the :class:`set` constructor with set literals. This fixer " "is optional." msgstr "" -#: ../src/Doc/library/2to3.rst:374 +#: library/2to3.rst:374 msgid "Renames :exc:`StandardError` to :exc:`Exception`." msgstr "" -#: ../src/Doc/library/2to3.rst:378 +#: library/2to3.rst:378 msgid "" "Changes the deprecated :data:`sys.exc_value`, :data:`sys.exc_type`, :data:" "`sys.exc_traceback` to use :func:`sys.exc_info`." msgstr "" -#: ../src/Doc/library/2to3.rst:383 +#: library/2to3.rst:383 msgid "Fixes the API change in generator's :meth:`throw` method." msgstr "" -#: ../src/Doc/library/2to3.rst:387 +#: library/2to3.rst:387 msgid "" "Removes implicit tuple parameter unpacking. This fixer inserts temporary " "variables." msgstr "" -#: ../src/Doc/library/2to3.rst:392 +#: library/2to3.rst:392 msgid "" "Fixes code broken from the removal of some members in the :mod:`types` " "module." msgstr "" -#: ../src/Doc/library/2to3.rst:397 +#: library/2to3.rst:397 msgid "Renames :class:`unicode` to :class:`str`." msgstr "Renomme :class:`unicode`en :class:`str`." -#: ../src/Doc/library/2to3.rst:401 +#: library/2to3.rst:401 msgid "" "Handles the rename of :mod:`urllib` and :mod:`urllib2` to the :mod:`urllib` " "package." @@ -582,13 +594,13 @@ msgstr "" "Gère le renommage des paquets :mod:`urllib` et :mod:`urllib2` en :mod:" "`urllib`" -#: ../src/Doc/library/2to3.rst:406 +#: library/2to3.rst:406 msgid "" "Removes excess whitespace from comma separated items. This fixer is " "optional." msgstr "" -#: ../src/Doc/library/2to3.rst:411 +#: library/2to3.rst:411 msgid "" "Renames :func:`xrange` to :func:`range` and wraps existing :func:`range` " "calls with :class:`list`." @@ -596,33 +608,33 @@ msgstr "" "Renomme la fonction :func:`xrange` en :func:`range` et encapsule les appels " "à la fonction :func:`range` avec des appels à :class:`list`." -#: ../src/Doc/library/2to3.rst:416 +#: library/2to3.rst:416 msgid "Changes ``for x in file.xreadlines()`` to ``for x in file``." msgstr "" -#: ../src/Doc/library/2to3.rst:420 +#: library/2to3.rst:420 msgid "" "Wraps :func:`zip` usage in a :class:`list` call. This is disabled when " "``from future_builtins import zip`` appears." msgstr "" -#: ../src/Doc/library/2to3.rst:425 +#: library/2to3.rst:425 msgid ":mod:`lib2to3` - 2to3's library" msgstr "" -#: ../src/Doc/library/2to3.rst:436 +#: library/2to3.rst:436 msgid "" "The :mod:`lib2to3` API should be considered unstable and may change " "drastically in the future." msgstr "" # eb97f6b25a6245dc827cb5d0416b8b25 -#: ../src/Doc/library/__builtin__.rst:3 +#: library/__builtin__.rst:3 msgid ":mod:`__builtin__` --- Built-in objects" msgstr "" # a2f271276e7f4fa496a4af820c276258 -#: ../src/Doc/library/__builtin__.rst:9 +#: library/__builtin__.rst:9 msgid "" "This module provides direct access to all 'built-in' identifiers of Python; " "for example, ``__builtin__.open`` is the full name for the built-in " @@ -630,7 +642,7 @@ msgid "" "for documentation." msgstr "" -#: ../src/Doc/library/__builtin__.rst:15 +#: library/__builtin__.rst:15 msgid "" "This module is not normally accessed explicitly by most applications, but " "can be useful in modules that provide objects with the same name as a built-" @@ -640,7 +652,7 @@ msgid "" msgstr "" # fc42cfbf648b4378a6e2af4ad1b28c70 -#: ../src/Doc/library/__builtin__.rst:40 +#: library/__builtin__.rst:40 msgid "" "Most modules have the name ``__builtins__`` (note the ``'s'``) made " "available as part of their globals. The value of ``__builtins__`` is " @@ -649,33 +661,33 @@ msgid "" "alternate implementations of Python." msgstr "" -#: ../src/Doc/library/__future__.rst:2 +#: library/__future__.rst:2 msgid ":mod:`__future__` --- Future statement definitions" msgstr "" # 6ecb062f6cab4568bdf0c4e166ead18f -#: ../src/Doc/library/__future__.rst:7 +#: library/__future__.rst:7 msgid "**Source code:** :source:`Lib/__future__.py`" msgstr "**Source code:** :source:`Lib/_future_.py`" -#: ../src/Doc/library/__future__.rst:11 +#: library/__future__.rst:11 msgid ":mod:`__future__` is a real module, and serves three purposes:" msgstr "" -#: ../src/Doc/library/__future__.rst:13 +#: library/__future__.rst:13 msgid "" "To avoid confusing existing tools that analyze import statements and expect " "to find the modules they're importing." msgstr "" -#: ../src/Doc/library/__future__.rst:16 +#: library/__future__.rst:16 msgid "" "To ensure that :ref:`future statements ` run under releases prior to " "2.1 at least yield runtime exceptions (the import of :mod:`__future__` will " "fail, because there was no module of that name prior to 2.1)." msgstr "" -#: ../src/Doc/library/__future__.rst:20 +#: library/__future__.rst:20 msgid "" "To document when incompatible changes were introduced, and when they will be " "--- or were --- made mandatory. This is a form of executable documentation, " @@ -683,30 +695,30 @@ msgid "" "examining its contents." msgstr "" -#: ../src/Doc/library/__future__.rst:25 +#: library/__future__.rst:25 msgid "Each statement in :file:`__future__.py` is of the form::" msgstr "" -#: ../src/Doc/library/__future__.rst:31 +#: library/__future__.rst:31 msgid "" "where, normally, *OptionalRelease* is less than *MandatoryRelease*, and both " "are 5-tuples of the same form as ``sys.version_info``::" msgstr "" -#: ../src/Doc/library/__future__.rst:41 +#: library/__future__.rst:41 msgid "" "*OptionalRelease* records the first release in which the feature was " "accepted." msgstr "" -#: ../src/Doc/library/__future__.rst:43 +#: library/__future__.rst:43 msgid "" "In the case of a *MandatoryRelease* that has not yet occurred, " "*MandatoryRelease* predicts the release in which the feature will become " "part of the language." msgstr "" -#: ../src/Doc/library/__future__.rst:47 +#: library/__future__.rst:47 msgid "" "Else *MandatoryRelease* records when the feature became part of the " "language; in releases at or after that, modules no longer need a future " @@ -714,19 +726,19 @@ msgid "" "imports." msgstr "" -#: ../src/Doc/library/__future__.rst:51 +#: library/__future__.rst:51 msgid "" "*MandatoryRelease* may also be ``None``, meaning that a planned feature got " "dropped." msgstr "" -#: ../src/Doc/library/__future__.rst:54 +#: library/__future__.rst:54 msgid "" "Instances of class :class:`_Feature` have two corresponding methods, :meth:" "`getOptionalRelease` and :meth:`getMandatoryRelease`." msgstr "" -#: ../src/Doc/library/__future__.rst:57 +#: library/__future__.rst:57 msgid "" "*CompilerFlag* is the (bitfield) flag that should be passed in the fourth " "argument to the built-in function :func:`compile` to enable the feature in " @@ -734,7 +746,7 @@ msgid "" "attribute on :class:`_Feature` instances." msgstr "" -#: ../src/Doc/library/__future__.rst:62 +#: library/__future__.rst:62 msgid "" "No feature description will ever be deleted from :mod:`__future__`. Since " "its introduction in Python 2.1 the following features have found their way " @@ -744,129 +756,129 @@ msgstr "" "son introduction dans Python 2.1, les fonctionnalités suivantes ont trouvé " "leur places dans le langage utilisant ce mécanisme :" -#: ../src/Doc/library/__future__.rst:67 +#: library/__future__.rst:67 msgid "feature" msgstr "fonctionnalité" -#: ../src/Doc/library/__future__.rst:67 +#: library/__future__.rst:67 msgid "optional in" msgstr "" -#: ../src/Doc/library/__future__.rst:67 +#: library/__future__.rst:67 msgid "mandatory in" msgstr "" -#: ../src/Doc/library/__future__.rst:67 +#: library/__future__.rst:67 msgid "effect" msgstr "effet" -#: ../src/Doc/library/__future__.rst:69 +#: library/__future__.rst:69 msgid "nested_scopes" msgstr "nested_scopes" -#: ../src/Doc/library/__future__.rst:69 +#: library/__future__.rst:69 msgid "2.1.0b1" msgstr "2.1.0b1" -#: ../src/Doc/library/__future__.rst:69 +#: library/__future__.rst:69 msgid "2.2" msgstr "2.2" -#: ../src/Doc/library/__future__.rst:69 +#: library/__future__.rst:69 msgid ":pep:`227`: *Statically Nested Scopes*" msgstr ":pep:`227`: *Statically Nested Scopes*" -#: ../src/Doc/library/__future__.rst:72 +#: library/__future__.rst:72 msgid "generators" msgstr "générateurs" -#: ../src/Doc/library/__future__.rst:72 +#: library/__future__.rst:72 msgid "2.2.0a1" msgstr "" -#: ../src/Doc/library/__future__.rst:72 +#: library/__future__.rst:72 msgid "2.3" msgstr "2.3" -#: ../src/Doc/library/__future__.rst:72 +#: library/__future__.rst:72 msgid ":pep:`255`: *Simple Generators*" msgstr "" -#: ../src/Doc/library/__future__.rst:75 +#: library/__future__.rst:75 msgid "division" msgstr "division" -#: ../src/Doc/library/__future__.rst:75 +#: library/__future__.rst:75 msgid "2.2.0a2" msgstr "2.2.0a2" -#: ../src/Doc/library/__future__.rst:75 ../src/Doc/library/__future__.rst:78 -#: ../src/Doc/library/__future__.rst:84 ../src/Doc/library/__future__.rst:87 +#: library/__future__.rst:75 library/__future__.rst:78 +#: library/__future__.rst:84 library/__future__.rst:87 msgid "3.0" msgstr "3.0" -#: ../src/Doc/library/__future__.rst:75 +#: library/__future__.rst:75 msgid ":pep:`238`: *Changing the Division Operator*" msgstr "" -#: ../src/Doc/library/__future__.rst:78 +#: library/__future__.rst:78 msgid "absolute_import" msgstr "" -#: ../src/Doc/library/__future__.rst:78 ../src/Doc/library/__future__.rst:81 +#: library/__future__.rst:78 library/__future__.rst:81 msgid "2.5.0a1" msgstr "2.5.0a1" -#: ../src/Doc/library/__future__.rst:78 +#: library/__future__.rst:78 msgid ":pep:`328`: *Imports: Multi-Line and Absolute/Relative*" msgstr "" -#: ../src/Doc/library/__future__.rst:81 +#: library/__future__.rst:81 msgid "with_statement" msgstr "" -#: ../src/Doc/library/__future__.rst:81 +#: library/__future__.rst:81 msgid "2.6" msgstr "2.6" -#: ../src/Doc/library/__future__.rst:81 +#: library/__future__.rst:81 msgid ":pep:`343`: *The \"with\" Statement*" msgstr "" -#: ../src/Doc/library/__future__.rst:84 +#: library/__future__.rst:84 msgid "print_function" msgstr "" -#: ../src/Doc/library/__future__.rst:84 ../src/Doc/library/__future__.rst:87 +#: library/__future__.rst:84 library/__future__.rst:87 msgid "2.6.0a2" msgstr "2.6.0a2" -#: ../src/Doc/library/__future__.rst:84 +#: library/__future__.rst:84 msgid ":pep:`3105`: *Make print a function*" msgstr ":pep:`3105`: *Make print a function*" -#: ../src/Doc/library/__future__.rst:87 +#: library/__future__.rst:87 msgid "unicode_literals" msgstr "unicode_literals" -#: ../src/Doc/library/__future__.rst:87 +#: library/__future__.rst:87 msgid ":pep:`3112`: *Bytes literals in Python 3000*" msgstr "" -# 230494e4ef504c668bea635837eca734 -#: ../src/Doc/library/__future__.rst:92 -msgid ":ref:`future`" -msgstr "" +#: library/__future__.rst:93 +#, fuzzy +msgid "future" +msgstr "fonctionnalité" -#: ../src/Doc/library/__future__.rst:94 +#: library/__future__.rst:94 msgid "How the compiler treats future imports." msgstr "" -#: ../src/Doc/library/__main__.rst:3 +#: library/__main__.rst:3 msgid ":mod:`__main__` --- Top-level script environment" msgstr "" -#: ../src/Doc/library/__main__.rst:9 +#: library/__main__.rst:9 msgid "" "This module represents the (otherwise anonymous) scope in which the " "interpreter's main program executes --- commands read either from standard " @@ -876,19 +888,19 @@ msgid "" msgstr "" # da76b9a42c6e440e9fefb46be76ce233 -#: ../src/Doc/library/_winreg.rst:2 +#: library/_winreg.rst:2 msgid ":mod:`_winreg` -- Windows registry access" msgstr "" # 5db0c8b67dd14a249af70dbb85fb6ff2 -#: ../src/Doc/library/_winreg.rst:10 +#: library/_winreg.rst:10 msgid "" "The :mod:`_winreg` module has been renamed to :mod:`winreg` in Python 3. " "The :term:`2to3` tool will automatically adapt imports when converting your " "sources to Python 3." msgstr "" -#: ../src/Doc/library/_winreg.rst:17 +#: library/_winreg.rst:17 msgid "" "These functions expose the Windows registry API to Python. Instead of using " "an integer as the registry handle, a :ref:`handle object ` is " @@ -896,89 +908,86 @@ msgid "" "neglects to explicitly close them." msgstr "" -#: ../src/Doc/library/_winreg.rst:22 +#: library/_winreg.rst:22 msgid "This module offers the following functions:" msgstr "" -#: ../src/Doc/library/_winreg.rst:27 +#: library/_winreg.rst:27 msgid "" "Closes a previously opened registry key. The *hkey* argument specifies a " "previously opened key." msgstr "" -#: ../src/Doc/library/_winreg.rst:31 +#: library/_winreg.rst:31 msgid "" "If *hkey* is not closed using this method (or via :meth:`hkey.Close() " "`), it is closed when the *hkey* object is destroyed by Python." msgstr "" -#: ../src/Doc/library/_winreg.rst:37 +#: library/_winreg.rst:37 msgid "" "Establishes a connection to a predefined registry handle on another " "computer, and returns a :ref:`handle object `." msgstr "" -#: ../src/Doc/library/_winreg.rst:40 +#: library/_winreg.rst:40 msgid "" "*computer_name* is the name of the remote computer, of the form ``r\"\\" "\\computername\"``. If ``None``, the local computer is used." msgstr "" -#: ../src/Doc/library/_winreg.rst:43 +#: library/_winreg.rst:43 msgid "*key* is the predefined handle to connect to." msgstr "" -#: ../src/Doc/library/_winreg.rst:45 ../src/Doc/library/_winreg.rst:64 -#: ../src/Doc/library/_winreg.rst:90 +#: library/_winreg.rst:45 library/_winreg.rst:64 library/_winreg.rst:90 msgid "" "The return value is the handle of the opened key. If the function fails, a :" "exc:`WindowsError` exception is raised." msgstr "" -#: ../src/Doc/library/_winreg.rst:51 ../src/Doc/library/_winreg.rst:70 +#: library/_winreg.rst:51 library/_winreg.rst:70 msgid "" "Creates or opens the specified key, returning a :ref:`handle object `." msgstr "" -#: ../src/Doc/library/_winreg.rst:54 ../src/Doc/library/_winreg.rst:73 -#: ../src/Doc/library/_winreg.rst:150 ../src/Doc/library/_winreg.rst:215 -#: ../src/Doc/library/_winreg.rst:285 ../src/Doc/library/_winreg.rst:309 -#: ../src/Doc/library/_winreg.rst:327 ../src/Doc/library/_winreg.rst:349 -#: ../src/Doc/library/_winreg.rst:372 ../src/Doc/library/_winreg.rst:398 -#: ../src/Doc/library/_winreg.rst:427 ../src/Doc/library/_winreg.rst:442 -#: ../src/Doc/library/_winreg.rst:455 +#: library/_winreg.rst:54 library/_winreg.rst:73 library/_winreg.rst:150 +#: library/_winreg.rst:215 library/_winreg.rst:285 library/_winreg.rst:309 +#: library/_winreg.rst:327 library/_winreg.rst:349 library/_winreg.rst:372 +#: library/_winreg.rst:398 library/_winreg.rst:427 library/_winreg.rst:442 +#: library/_winreg.rst:455 msgid "" "*key* is an already open key, or one of the predefined :ref:`HKEY_* " "constants `." msgstr "" -#: ../src/Doc/library/_winreg.rst:57 ../src/Doc/library/_winreg.rst:76 +#: library/_winreg.rst:57 library/_winreg.rst:76 msgid "*sub_key* is a string that names the key this method opens or creates." msgstr "" -#: ../src/Doc/library/_winreg.rst:59 ../src/Doc/library/_winreg.rst:85 +#: library/_winreg.rst:59 library/_winreg.rst:85 msgid "" "If *key* is one of the predefined keys, *sub_key* may be ``None``. In that " "case, the handle returned is the same key handle passed in to the function." msgstr "" -#: ../src/Doc/library/_winreg.rst:62 ../src/Doc/library/_winreg.rst:88 +#: library/_winreg.rst:62 library/_winreg.rst:88 msgid "If the key already exists, this function opens the existing key." msgstr "" -#: ../src/Doc/library/_winreg.rst:78 ../src/Doc/library/_winreg.rst:129 +#: library/_winreg.rst:78 library/_winreg.rst:129 msgid "*res* is a reserved integer, and must be zero. The default is zero." msgstr "" -#: ../src/Doc/library/_winreg.rst:80 +#: library/_winreg.rst:80 msgid "" "*sam* is an integer that specifies an access mask that describes the desired " "security access for the key. Default is :const:`KEY_ALL_ACCESS`. See :ref:" "`Access Rights ` for other allowed values." msgstr "" -#: ../src/Doc/library/_winreg.rst:98 ../src/Doc/library/_winreg.rst:114 +#: library/_winreg.rst:98 library/_winreg.rst:114 msgid "Deletes the specified key." msgstr "" @@ -987,32 +996,31 @@ msgstr "" # 09d2eda5070847eeae31556e2298eff4 # 0548671a59e04d84b8693c177ce88de4 # d27f5c927571450085c607e5ef9bb1f7 -#: ../src/Doc/library/_winreg.rst:100 ../src/Doc/library/_winreg.rst:122 -#: ../src/Doc/library/_winreg.rst:160 ../src/Doc/library/_winreg.rst:174 -#: ../src/Doc/library/_winreg.rst:259 +#: library/_winreg.rst:100 library/_winreg.rst:122 library/_winreg.rst:160 +#: library/_winreg.rst:174 library/_winreg.rst:259 msgid "" "*key* is an already open key, or any one of the predefined :ref:`HKEY_* " "constants `." msgstr "" -#: ../src/Doc/library/_winreg.rst:103 +#: library/_winreg.rst:103 msgid "" "*sub_key* is a string that must be a subkey of the key identified by the " "*key* parameter. This value must not be ``None``, and the key may not have " "subkeys." msgstr "" -#: ../src/Doc/library/_winreg.rst:106 ../src/Doc/library/_winreg.rst:136 +#: library/_winreg.rst:106 library/_winreg.rst:136 msgid "*This method can not delete keys with subkeys.*" msgstr "" -#: ../src/Doc/library/_winreg.rst:108 ../src/Doc/library/_winreg.rst:138 +#: library/_winreg.rst:108 library/_winreg.rst:138 msgid "" "If the method succeeds, the entire key, including all of its values, is " "removed. If the method fails, a :exc:`WindowsError` exception is raised." msgstr "" -#: ../src/Doc/library/_winreg.rst:117 +#: library/_winreg.rst:117 msgid "" "The :func:`DeleteKeyEx` function is implemented with the RegDeleteKeyEx " "Windows API function, which is specific to 64-bit versions of Windows. See " @@ -1020,7 +1028,7 @@ msgid "" "ms724847%28VS.85%29.aspx>`__." msgstr "" -#: ../src/Doc/library/_winreg.rst:125 +#: library/_winreg.rst:125 msgid "" "*sub_key* is a string that must be a subkey of the key identified by the " "*key* parameter. This value must not be ``None``, and the key may not have " @@ -1028,147 +1036,132 @@ msgid "" msgstr "" # d74c13126a4649a488f0d082dd223d49 -#: ../src/Doc/library/_winreg.rst:131 +#: library/_winreg.rst:131 msgid "" "*sam* is an integer that specifies an access mask that describes the desired " "security access for the key. Default is :const:`KEY_WOW64_64KEY`. See :ref:" "`Access Rights ` for other allowed values." msgstr "" -#: ../src/Doc/library/_winreg.rst:141 +#: library/_winreg.rst:141 msgid "On unsupported Windows versions, :exc:`NotImplementedError` is raised." msgstr "" -#: ../src/Doc/library/_winreg.rst:148 +#: library/_winreg.rst:148 msgid "Removes a named value from a registry key." msgstr "" -#: ../src/Doc/library/_winreg.rst:153 +#: library/_winreg.rst:153 msgid "*value* is a string that identifies the value to remove." msgstr "" -#: ../src/Doc/library/_winreg.rst:158 +#: library/_winreg.rst:158 msgid "Enumerates subkeys of an open registry key, returning a string." msgstr "" -#: ../src/Doc/library/_winreg.rst:163 +#: library/_winreg.rst:163 msgid "*index* is an integer that identifies the index of the key to retrieve." msgstr "" -#: ../src/Doc/library/_winreg.rst:165 +#: library/_winreg.rst:165 msgid "" "The function retrieves the name of one subkey each time it is called. It is " "typically called repeatedly until a :exc:`WindowsError` exception is raised, " "indicating, no more values are available." msgstr "" -#: ../src/Doc/library/_winreg.rst:172 +#: library/_winreg.rst:172 msgid "Enumerates values of an open registry key, returning a tuple." msgstr "" -#: ../src/Doc/library/_winreg.rst:177 +#: library/_winreg.rst:177 msgid "" "*index* is an integer that identifies the index of the value to retrieve." msgstr "" -#: ../src/Doc/library/_winreg.rst:179 +#: library/_winreg.rst:179 msgid "" "The function retrieves the name of one subkey each time it is called. It is " "typically called repeatedly, until a :exc:`WindowsError` exception is " "raised, indicating no more values." msgstr "" -#: ../src/Doc/library/_winreg.rst:183 ../src/Doc/library/_winreg.rst:288 +#: library/_winreg.rst:183 library/_winreg.rst:288 msgid "The result is a tuple of 3 items:" msgstr "" -#: ../src/Doc/library/_winreg.rst:186 ../src/Doc/library/_winreg.rst:291 -#: ../src/Doc/library/_winreg.rst:335 ../src/Doc/library/grp.rst:18 -#: ../src/Doc/library/pwd.rst:18 ../src/Doc/library/resource.rst:181 -#: ../src/Doc/library/spwd.rst:23 ../src/Doc/library/time.rst:405 -#: ../src/Doc/library/tkinter.rst:438 ../src/Doc/library/urlparse.rst:94 -#: ../src/Doc/library/urlparse.rst:198 ../src/Doc/library/zipfile.rst:404 +#: library/_winreg.rst:186 library/_winreg.rst:291 library/_winreg.rst:335 +#: library/grp.rst:18 library/pwd.rst:18 library/resource.rst:181 +#: library/spwd.rst:23 library/time.rst:404 library/tkinter.rst:438 +#: library/urlparse.rst:94 library/urlparse.rst:198 library/zipfile.rst:406 msgid "Index" msgstr "" -#: ../src/Doc/library/_winreg.rst:186 ../src/Doc/library/_winreg.rst:291 -#: ../src/Doc/library/_winreg.rst:335 ../src/Doc/library/anydbm.rst:37 -#: ../src/Doc/library/carbon.rst:504 ../src/Doc/library/codecs.rst:351 -#: ../src/Doc/library/curses.rst:1240 ../src/Doc/library/curses.rst:1492 -#: ../src/Doc/library/curses.ascii.rst:18 ../src/Doc/library/datetime.rst:1618 -#: ../src/Doc/library/dbhash.rst:35 ../src/Doc/library/dbm.rst:48 -#: ../src/Doc/library/difflib.rst:61 ../src/Doc/library/difflib.rst:467 -#: ../src/Doc/library/fl.rst:352 ../src/Doc/library/fl.rst:430 -#: ../src/Doc/library/fnmatch.rst:21 ../src/Doc/library/gdbm.rst:42 -#: ../src/Doc/library/gdbm.rst:61 ../src/Doc/library/grp.rst:18 -#: ../src/Doc/library/io.rst:87 ../src/Doc/library/locale.rst:65 -#: ../src/Doc/library/mailbox.rst:798 ../src/Doc/library/mailbox.rst:965 -#: ../src/Doc/library/mailbox.rst:1335 ../src/Doc/library/posixfile.rst:110 -#: ../src/Doc/library/posixfile.rst:123 ../src/Doc/library/posixfile.rst:144 -#: ../src/Doc/library/posixfile.rst:158 ../src/Doc/library/profile.rst:397 -#: ../src/Doc/library/pwd.rst:18 ../src/Doc/library/select.rst:123 -#: ../src/Doc/library/select.rst:221 ../src/Doc/library/select.rst:322 -#: ../src/Doc/library/select.rst:351 ../src/Doc/library/select.rst:382 -#: ../src/Doc/library/select.rst:390 ../src/Doc/library/select.rst:410 -#: ../src/Doc/library/select.rst:433 ../src/Doc/library/spwd.rst:23 -#: ../src/Doc/library/stdtypes.rst:153 ../src/Doc/library/stdtypes.rst:1419 -#: ../src/Doc/library/stdtypes.rst:1442 ../src/Doc/library/string.rst:342 -#: ../src/Doc/library/string.rst:367 ../src/Doc/library/string.rst:409 -#: ../src/Doc/library/string.rst:420 ../src/Doc/library/string.rst:452 -#: ../src/Doc/library/sys.rst:530 ../src/Doc/library/sys.rst:575 -#: ../src/Doc/library/time.rst:258 ../src/Doc/library/tkinter.rst:438 -#: ../src/Doc/library/uuid.rst:69 -#: ../src/Doc/library/xml.etree.elementtree.rst:318 -#: ../src/Doc/library/xmlrpclib.rst:79 +#: library/_winreg.rst:186 library/_winreg.rst:291 library/_winreg.rst:335 +#: library/anydbm.rst:37 library/carbon.rst:504 library/codecs.rst:351 +#: library/curses.rst:1240 library/curses.rst:1492 library/curses.ascii.rst:18 +#: library/datetime.rst:1618 library/dbhash.rst:35 library/dbm.rst:48 +#: library/difflib.rst:61 library/difflib.rst:467 library/fl.rst:352 +#: library/fl.rst:430 library/fnmatch.rst:21 library/gdbm.rst:42 +#: library/gdbm.rst:61 library/grp.rst:18 library/io.rst:87 +#: library/locale.rst:65 library/mailbox.rst:798 library/mailbox.rst:965 +#: library/mailbox.rst:1335 library/posixfile.rst:110 library/posixfile.rst:123 +#: library/posixfile.rst:144 library/posixfile.rst:158 library/profile.rst:397 +#: library/pwd.rst:18 library/select.rst:123 library/select.rst:221 +#: library/select.rst:322 library/select.rst:351 library/select.rst:382 +#: library/select.rst:390 library/select.rst:410 library/select.rst:433 +#: library/spwd.rst:23 library/stdtypes.rst:153 library/stdtypes.rst:1422 +#: library/stdtypes.rst:1445 library/string.rst:342 library/string.rst:367 +#: library/string.rst:409 library/string.rst:420 library/string.rst:452 +#: library/sys.rst:530 library/sys.rst:575 library/time.rst:257 +#: library/tkinter.rst:438 library/uuid.rst:69 +#: library/xml.etree.elementtree.rst:385 library/xmlrpclib.rst:80 msgid "Meaning" msgstr "" -#: ../src/Doc/library/_winreg.rst:188 ../src/Doc/library/_winreg.rst:293 -#: ../src/Doc/library/_winreg.rst:337 ../src/Doc/library/locale.rst:132 -#: ../src/Doc/library/resource.rst:183 ../src/Doc/library/zipfile.rst:406 +#: library/_winreg.rst:188 library/_winreg.rst:293 library/_winreg.rst:337 +#: library/locale.rst:132 library/resource.rst:183 library/zipfile.rst:408 msgid "``0``" msgstr "" -#: ../src/Doc/library/_winreg.rst:188 +#: library/_winreg.rst:188 msgid "A string that identifies the value name" msgstr "" -#: ../src/Doc/library/_winreg.rst:190 ../src/Doc/library/_winreg.rst:296 -#: ../src/Doc/library/_winreg.rst:339 ../src/Doc/library/locale.rst:135 -#: ../src/Doc/library/resource.rst:185 ../src/Doc/library/zipfile.rst:408 +#: library/_winreg.rst:190 library/_winreg.rst:296 library/_winreg.rst:339 +#: library/locale.rst:135 library/resource.rst:185 library/zipfile.rst:410 msgid "``1``" msgstr "" -#: ../src/Doc/library/_winreg.rst:190 +#: library/_winreg.rst:190 msgid "" "An object that holds the value data, and whose type depends on the " "underlying registry type" msgstr "" -#: ../src/Doc/library/_winreg.rst:194 ../src/Doc/library/_winreg.rst:299 -#: ../src/Doc/library/locale.rst:138 ../src/Doc/library/resource.rst:187 -#: ../src/Doc/library/zipfile.rst:410 +#: library/_winreg.rst:194 library/_winreg.rst:299 library/locale.rst:138 +#: library/resource.rst:187 library/zipfile.rst:412 msgid "``2``" msgstr "" -#: ../src/Doc/library/_winreg.rst:194 +#: library/_winreg.rst:194 msgid "" "An integer that identifies the type of the value data (see table in docs " "for :meth:`SetValueEx`)" msgstr "" # 34606c5ff9dc41d78217bf5fb9d820b0 -#: ../src/Doc/library/_winreg.rst:202 +#: library/_winreg.rst:202 msgid "" "Expands environment variable placeholders ``%NAME%`` in unicode strings " "like :const:`REG_EXPAND_SZ`::" msgstr "" -#: ../src/Doc/library/_winreg.rst:213 +#: library/_winreg.rst:213 msgid "Writes all the attributes of a key to the registry." msgstr "" -#: ../src/Doc/library/_winreg.rst:218 +#: library/_winreg.rst:218 msgid "" "It is not necessary to call :func:`FlushKey` to change a key. Registry " "changes are flushed to disk by the registry using its lazy flusher. " @@ -1179,36 +1172,36 @@ msgid "" "disk." msgstr "" -#: ../src/Doc/library/_winreg.rst:227 +#: library/_winreg.rst:227 msgid "" "If you don't know whether a :func:`FlushKey` call is required, it probably " "isn't." msgstr "" -#: ../src/Doc/library/_winreg.rst:233 +#: library/_winreg.rst:233 msgid "" "Creates a subkey under the specified key and stores registration information " "from a specified file into that subkey." msgstr "" -#: ../src/Doc/library/_winreg.rst:236 +#: library/_winreg.rst:236 msgid "" "*key* is a handle returned by :func:`ConnectRegistry` or one of the " "constants :const:`HKEY_USERS` or :const:`HKEY_LOCAL_MACHINE`." msgstr "" -#: ../src/Doc/library/_winreg.rst:239 +#: library/_winreg.rst:239 msgid "*sub_key* is a string that identifies the subkey to load." msgstr "" -#: ../src/Doc/library/_winreg.rst:241 +#: library/_winreg.rst:241 msgid "" "*file_name* is the name of the file to load registry data from. This file " "must have been created with the :func:`SaveKey` function. Under the file " "allocation table (FAT) file system, the filename may not have an extension." msgstr "" -#: ../src/Doc/library/_winreg.rst:245 +#: library/_winreg.rst:245 msgid "" "A call to :func:`LoadKey` fails if the calling process does not have the :" "const:`SE_RESTORE_PRIVILEGE` privilege. Note that privileges are different " @@ -1216,70 +1209,70 @@ msgid "" "com/en-us/library/ms724889%28v=VS.85%29.aspx>`__ for more details." msgstr "" -#: ../src/Doc/library/_winreg.rst:251 +#: library/_winreg.rst:251 msgid "" "If *key* is a handle returned by :func:`ConnectRegistry`, then the path " "specified in *file_name* is relative to the remote computer." msgstr "" -#: ../src/Doc/library/_winreg.rst:257 +#: library/_winreg.rst:257 msgid "" "Opens the specified key, returning a :ref:`handle object `." msgstr "" -#: ../src/Doc/library/_winreg.rst:262 +#: library/_winreg.rst:262 msgid "*sub_key* is a string that identifies the sub_key to open." msgstr "" -#: ../src/Doc/library/_winreg.rst:264 +#: library/_winreg.rst:264 msgid "*res* is a reserved integer, and must be zero. The default is zero." msgstr "" -#: ../src/Doc/library/_winreg.rst:266 +#: library/_winreg.rst:266 msgid "" "*sam* is an integer that specifies an access mask that describes the desired " "security access for the key. Default is :const:`KEY_READ`. See :ref:" "`Access Rights ` for other allowed values." msgstr "" -#: ../src/Doc/library/_winreg.rst:270 +#: library/_winreg.rst:270 msgid "The result is a new handle to the specified key." msgstr "" -#: ../src/Doc/library/_winreg.rst:272 +#: library/_winreg.rst:272 msgid "If the function fails, :exc:`WindowsError` is raised." msgstr "" -#: ../src/Doc/library/_winreg.rst:277 +#: library/_winreg.rst:277 msgid "" "The functionality of :func:`OpenKeyEx` is provided via :func:`OpenKey`, by " "the use of default arguments." msgstr "" -#: ../src/Doc/library/_winreg.rst:283 +#: library/_winreg.rst:283 msgid "Returns information about a key, as a tuple." msgstr "" -#: ../src/Doc/library/_winreg.rst:293 +#: library/_winreg.rst:293 msgid "An integer giving the number of sub keys this key has." msgstr "" -#: ../src/Doc/library/_winreg.rst:296 +#: library/_winreg.rst:296 msgid "An integer giving the number of values this key has." msgstr "" # 75889f86d44a48399edd2256b9006903 -#: ../src/Doc/library/_winreg.rst:299 +#: library/_winreg.rst:299 msgid "" "A long integer giving when the key was last modified (if available) as 100's " "of nanoseconds since Jan 1, 1601." msgstr "" -#: ../src/Doc/library/_winreg.rst:307 +#: library/_winreg.rst:307 msgid "Retrieves the unnamed value for a key, as a string." msgstr "" -#: ../src/Doc/library/_winreg.rst:312 +#: library/_winreg.rst:312 msgid "" "*sub_key* is a string that holds the name of the subkey with which the value " "is associated. If this parameter is ``None`` or empty, the function " @@ -1287,7 +1280,7 @@ msgid "" "identified by *key*." msgstr "" -#: ../src/Doc/library/_winreg.rst:316 +#: library/_winreg.rst:316 msgid "" "Values in the registry have name, type, and data components. This method " "retrieves the data for a key's first value that has a NULL name. But the " @@ -1295,35 +1288,35 @@ msgid "" "`QueryValueEx` if possible." msgstr "" -#: ../src/Doc/library/_winreg.rst:324 +#: library/_winreg.rst:324 msgid "" "Retrieves the type and data for a specified value name associated with an " "open registry key." msgstr "" -#: ../src/Doc/library/_winreg.rst:330 +#: library/_winreg.rst:330 msgid "*value_name* is a string indicating the value to query." msgstr "" -#: ../src/Doc/library/_winreg.rst:332 +#: library/_winreg.rst:332 msgid "The result is a tuple of 2 items:" msgstr "" -#: ../src/Doc/library/_winreg.rst:337 +#: library/_winreg.rst:337 msgid "The value of the registry item." msgstr "" -#: ../src/Doc/library/_winreg.rst:339 +#: library/_winreg.rst:339 msgid "" "An integer giving the registry type for this value (see table in docs for :" "meth:`SetValueEx`)" msgstr "" -#: ../src/Doc/library/_winreg.rst:347 +#: library/_winreg.rst:347 msgid "Saves the specified key, and all its subkeys to the specified file." msgstr "" -#: ../src/Doc/library/_winreg.rst:352 +#: library/_winreg.rst:352 msgid "" "*file_name* is the name of the file to save registry data to. This file " "cannot already exist. If this filename includes an extension, it cannot be " @@ -1331,7 +1324,7 @@ msgid "" "method." msgstr "" -#: ../src/Doc/library/_winreg.rst:357 +#: library/_winreg.rst:357 msgid "" "If *key* represents a key on a remote computer, the path described by " "*file_name* is relative to the remote computer. The caller of this method " @@ -1341,142 +1334,140 @@ msgid "" "library/ms724878%28v=VS.85%29.aspx>`__ for more details." msgstr "" -#: ../src/Doc/library/_winreg.rst:365 +#: library/_winreg.rst:365 msgid "This function passes NULL for *security_attributes* to the API." msgstr "" -#: ../src/Doc/library/_winreg.rst:370 +#: library/_winreg.rst:370 msgid "Associates a value with a specified key." msgstr "" -#: ../src/Doc/library/_winreg.rst:375 +#: library/_winreg.rst:375 msgid "" "*sub_key* is a string that names the subkey with which the value is " "associated." msgstr "" -#: ../src/Doc/library/_winreg.rst:377 +#: library/_winreg.rst:377 msgid "" "*type* is an integer that specifies the type of the data. Currently this " "must be :const:`REG_SZ`, meaning only strings are supported. Use the :func:" "`SetValueEx` function for support for other data types." msgstr "" -#: ../src/Doc/library/_winreg.rst:381 ../src/Doc/library/_winreg.rst:409 +#: library/_winreg.rst:381 library/_winreg.rst:409 msgid "*value* is a string that specifies the new value." msgstr "" -#: ../src/Doc/library/_winreg.rst:383 +#: library/_winreg.rst:383 msgid "" "If the key specified by the *sub_key* parameter does not exist, the SetValue " "function creates it." msgstr "" -#: ../src/Doc/library/_winreg.rst:386 ../src/Doc/library/_winreg.rst:417 +#: library/_winreg.rst:386 library/_winreg.rst:417 msgid "" "Value lengths are limited by available memory. Long values (more than 2048 " "bytes) should be stored as files with the filenames stored in the " "configuration registry. This helps the registry perform efficiently." msgstr "" -#: ../src/Doc/library/_winreg.rst:390 +#: library/_winreg.rst:390 msgid "" "The key identified by the *key* parameter must have been opened with :const:" "`KEY_SET_VALUE` access." msgstr "" -#: ../src/Doc/library/_winreg.rst:396 +#: library/_winreg.rst:396 msgid "Stores data in the value field of an open registry key." msgstr "" -#: ../src/Doc/library/_winreg.rst:401 +#: library/_winreg.rst:401 msgid "" "*value_name* is a string that names the subkey with which the value is " "associated." msgstr "" -#: ../src/Doc/library/_winreg.rst:404 +#: library/_winreg.rst:404 msgid "" "*type* is an integer that specifies the type of the data. See :ref:`Value " "Types ` for the available types." msgstr "" -#: ../src/Doc/library/_winreg.rst:407 +#: library/_winreg.rst:407 msgid "*reserved* can be anything -- zero is always passed to the API." msgstr "" -#: ../src/Doc/library/_winreg.rst:411 +#: library/_winreg.rst:411 msgid "" "This method can also set additional value and type information for the " "specified key. The key identified by the key parameter must have been " "opened with :const:`KEY_SET_VALUE` access." msgstr "" -#: ../src/Doc/library/_winreg.rst:415 +#: library/_winreg.rst:415 msgid "To open the key, use the :func:`CreateKey` or :func:`OpenKey` methods." msgstr "" -#: ../src/Doc/library/_winreg.rst:424 +#: library/_winreg.rst:424 msgid "" "Disables registry reflection for 32-bit processes running on a 64-bit " "operating system." msgstr "" -#: ../src/Doc/library/_winreg.rst:430 ../src/Doc/library/_winreg.rst:445 -#: ../src/Doc/library/_winreg.rst:460 +#: library/_winreg.rst:430 library/_winreg.rst:445 library/_winreg.rst:460 msgid "" "Will generally raise :exc:`NotImplemented` if executed on a 32-bit operating " "system." msgstr "" # 020bd977870c4e5a95e25f00ca107e48 -#: ../src/Doc/library/_winreg.rst:433 +#: library/_winreg.rst:433 msgid "" "If the key is not on the reflection list, the function succeeds but has no " "effect. Disabling reflection for a key does not affect reflection of any " "subkeys." msgstr "" -#: ../src/Doc/library/_winreg.rst:440 +#: library/_winreg.rst:440 msgid "Restores registry reflection for the specified disabled key." msgstr "" -#: ../src/Doc/library/_winreg.rst:448 +#: library/_winreg.rst:448 msgid "" "Restoring reflection for a key does not affect reflection of any subkeys." msgstr "" -#: ../src/Doc/library/_winreg.rst:453 +#: library/_winreg.rst:453 msgid "Determines the reflection state for the specified key." msgstr "" -#: ../src/Doc/library/_winreg.rst:458 +#: library/_winreg.rst:458 msgid "Returns ``True`` if reflection is disabled." msgstr "" -#: ../src/Doc/library/_winreg.rst:467 ../src/Doc/library/cmath.rst:224 -#: ../src/Doc/library/curses.rst:1215 ../src/Doc/library/math.rst:363 -#: ../src/Doc/library/ssl.rst:447 ../src/Doc/library/subprocess.rst:634 +#: library/_winreg.rst:467 library/cmath.rst:224 library/curses.rst:1215 +#: library/math.rst:363 library/ssl.rst:451 library/subprocess.rst:634 msgid "Constants" msgstr "" -#: ../src/Doc/library/_winreg.rst:469 +#: library/_winreg.rst:469 msgid "" "The following constants are defined for use in many :mod:`_winreg` functions." msgstr "" -#: ../src/Doc/library/_winreg.rst:474 +#: library/_winreg.rst:474 msgid "HKEY_* Constants" msgstr "" -#: ../src/Doc/library/_winreg.rst:478 +#: library/_winreg.rst:478 msgid "" "Registry entries subordinate to this key define types (or classes) of " "documents and the properties associated with those types. Shell and COM " "applications use the information stored under this key." msgstr "" -#: ../src/Doc/library/_winreg.rst:485 +#: library/_winreg.rst:485 msgid "" "Registry entries subordinate to this key define the preferences of the " "current user. These preferences include the settings of environment " @@ -1484,48 +1475,48 @@ msgid "" "and application preferences." msgstr "" -#: ../src/Doc/library/_winreg.rst:492 +#: library/_winreg.rst:492 msgid "" "Registry entries subordinate to this key define the physical state of the " "computer, including data about the bus type, system memory, and installed " "hardware and software." msgstr "" -#: ../src/Doc/library/_winreg.rst:498 +#: library/_winreg.rst:498 msgid "" "Registry entries subordinate to this key define the default user " "configuration for new users on the local computer and the user configuration " "for the current user." msgstr "" -#: ../src/Doc/library/_winreg.rst:504 +#: library/_winreg.rst:504 msgid "" "Registry entries subordinate to this key allow you to access performance " "data. The data is not actually stored in the registry; the registry " "functions cause the system to collect the data from its source." msgstr "" -#: ../src/Doc/library/_winreg.rst:512 +#: library/_winreg.rst:512 msgid "" "Contains information about the current hardware profile of the local " "computer system." msgstr "" -#: ../src/Doc/library/_winreg.rst:517 +#: library/_winreg.rst:517 msgid "This key is not used in versions of Windows after 98." msgstr "" -#: ../src/Doc/library/_winreg.rst:523 +#: library/_winreg.rst:523 msgid "Access Rights" msgstr "" -#: ../src/Doc/library/_winreg.rst:525 +#: library/_winreg.rst:525 msgid "" "For more information, see `Registry Key Security and Access `__." msgstr "" -#: ../src/Doc/library/_winreg.rst:530 +#: library/_winreg.rst:530 msgid "" "Combines the STANDARD_RIGHTS_REQUIRED, :const:`KEY_QUERY_VALUE`, :const:" "`KEY_SET_VALUE`, :const:`KEY_CREATE_SUB_KEY`, :const:" @@ -1533,171 +1524,171 @@ msgid "" "access rights." msgstr "" -#: ../src/Doc/library/_winreg.rst:537 +#: library/_winreg.rst:537 msgid "" "Combines the STANDARD_RIGHTS_WRITE, :const:`KEY_SET_VALUE`, and :const:" "`KEY_CREATE_SUB_KEY` access rights." msgstr "" -#: ../src/Doc/library/_winreg.rst:542 +#: library/_winreg.rst:542 msgid "" "Combines the STANDARD_RIGHTS_READ, :const:`KEY_QUERY_VALUE`, :const:" "`KEY_ENUMERATE_SUB_KEYS`, and :const:`KEY_NOTIFY` values." msgstr "" -#: ../src/Doc/library/_winreg.rst:547 +#: library/_winreg.rst:547 msgid "Equivalent to :const:`KEY_READ`." msgstr "" -#: ../src/Doc/library/_winreg.rst:551 +#: library/_winreg.rst:551 msgid "Required to query the values of a registry key." msgstr "" -#: ../src/Doc/library/_winreg.rst:555 +#: library/_winreg.rst:555 msgid "Required to create, delete, or set a registry value." msgstr "" -#: ../src/Doc/library/_winreg.rst:559 +#: library/_winreg.rst:559 msgid "Required to create a subkey of a registry key." msgstr "" -#: ../src/Doc/library/_winreg.rst:563 +#: library/_winreg.rst:563 msgid "Required to enumerate the subkeys of a registry key." msgstr "" -#: ../src/Doc/library/_winreg.rst:567 +#: library/_winreg.rst:567 msgid "" "Required to request change notifications for a registry key or for subkeys " "of a registry key." msgstr "" -#: ../src/Doc/library/_winreg.rst:572 +#: library/_winreg.rst:572 msgid "Reserved for system use." msgstr "" -#: ../src/Doc/library/_winreg.rst:578 +#: library/_winreg.rst:578 msgid "64-bit Specific" msgstr "" -#: ../src/Doc/library/_winreg.rst:580 +#: library/_winreg.rst:580 msgid "" "For more information, see `Accesing an Alternate Registry View `__." msgstr "" -#: ../src/Doc/library/_winreg.rst:585 +#: library/_winreg.rst:585 msgid "" "Indicates that an application on 64-bit Windows should operate on the 64-bit " "registry view." msgstr "" -#: ../src/Doc/library/_winreg.rst:590 +#: library/_winreg.rst:590 msgid "" "Indicates that an application on 64-bit Windows should operate on the 32-bit " "registry view." msgstr "" -#: ../src/Doc/library/_winreg.rst:597 +#: library/_winreg.rst:597 msgid "Value Types" msgstr "" -#: ../src/Doc/library/_winreg.rst:599 +#: library/_winreg.rst:599 msgid "" "For more information, see `Registry Value Types `__." msgstr "" -#: ../src/Doc/library/_winreg.rst:604 +#: library/_winreg.rst:604 msgid "Binary data in any form." msgstr "" -#: ../src/Doc/library/_winreg.rst:608 +#: library/_winreg.rst:608 msgid "32-bit number." msgstr "" -#: ../src/Doc/library/_winreg.rst:612 +#: library/_winreg.rst:612 msgid "A 32-bit number in little-endian format." msgstr "" -#: ../src/Doc/library/_winreg.rst:616 +#: library/_winreg.rst:616 msgid "A 32-bit number in big-endian format." msgstr "" -#: ../src/Doc/library/_winreg.rst:620 +#: library/_winreg.rst:620 msgid "" "Null-terminated string containing references to environment variables (``" "%PATH%``)." msgstr "" -#: ../src/Doc/library/_winreg.rst:625 +#: library/_winreg.rst:625 msgid "A Unicode symbolic link." msgstr "" -#: ../src/Doc/library/_winreg.rst:629 +#: library/_winreg.rst:629 msgid "" "A sequence of null-terminated strings, terminated by two null characters. " "(Python handles this termination automatically.)" msgstr "" -#: ../src/Doc/library/_winreg.rst:634 +#: library/_winreg.rst:634 msgid "No defined value type." msgstr "" -#: ../src/Doc/library/_winreg.rst:638 +#: library/_winreg.rst:638 msgid "A device-driver resource list." msgstr "" -#: ../src/Doc/library/_winreg.rst:642 +#: library/_winreg.rst:642 msgid "A hardware setting." msgstr "" -#: ../src/Doc/library/_winreg.rst:646 +#: library/_winreg.rst:646 msgid "A hardware resource list." msgstr "" -#: ../src/Doc/library/_winreg.rst:650 +#: library/_winreg.rst:650 msgid "A null-terminated string." msgstr "" -#: ../src/Doc/library/_winreg.rst:656 +#: library/_winreg.rst:656 msgid "Registry Handle Objects" msgstr "" -#: ../src/Doc/library/_winreg.rst:658 +#: library/_winreg.rst:658 msgid "" "This object wraps a Windows HKEY object, automatically closing it when the " "object is destroyed. To guarantee cleanup, you can call either the :meth:" "`~PyHKEY.Close` method on the object, or the :func:`CloseKey` function." msgstr "" -#: ../src/Doc/library/_winreg.rst:662 +#: library/_winreg.rst:662 msgid "All registry functions in this module return one of these objects." msgstr "" -#: ../src/Doc/library/_winreg.rst:664 +#: library/_winreg.rst:664 msgid "" "All registry functions in this module which accept a handle object also " "accept an integer, however, use of the handle object is encouraged." msgstr "" # 8c77178b8c6541fea249cdc7948f36b3 -#: ../src/Doc/library/_winreg.rst:667 +#: library/_winreg.rst:667 msgid "Handle objects provide semantics for :meth:`__nonzero__` -- thus::" msgstr "" -#: ../src/Doc/library/_winreg.rst:672 +#: library/_winreg.rst:672 msgid "" "will print ``Yes`` if the handle is currently valid (has not been closed or " "detached)." msgstr "" -#: ../src/Doc/library/_winreg.rst:675 +#: library/_winreg.rst:675 msgid "" "The object also support comparison semantics, so handle objects will compare " "true if they both reference the same underlying Windows handle value." msgstr "" -#: ../src/Doc/library/_winreg.rst:678 +#: library/_winreg.rst:678 msgid "" "Handle objects can be converted to an integer (e.g., using the built-in :" "func:`int` function), in which case the underlying Windows handle value is " @@ -1706,56 +1697,56 @@ msgid "" "object." msgstr "" -#: ../src/Doc/library/_winreg.rst:686 +#: library/_winreg.rst:686 msgid "Closes the underlying Windows handle." msgstr "" -#: ../src/Doc/library/_winreg.rst:688 +#: library/_winreg.rst:688 msgid "If the handle is already closed, no error is raised." msgstr "" -#: ../src/Doc/library/_winreg.rst:693 +#: library/_winreg.rst:693 msgid "Detaches the Windows handle from the handle object." msgstr "" # 1ed59fc406eb4a629ab032aaebb9fa87 -#: ../src/Doc/library/_winreg.rst:695 +#: library/_winreg.rst:695 msgid "" "The result is an integer (or long on 64 bit Windows) that holds the value of " "the handle before it is detached. If the handle is already detached or " "closed, this will return zero." msgstr "" -#: ../src/Doc/library/_winreg.rst:699 +#: library/_winreg.rst:699 msgid "" "After calling this function, the handle is effectively invalidated, but the " "handle is not closed. You would call this function when you need the " "underlying Win32 handle to exist beyond the lifetime of the handle object." msgstr "" -#: ../src/Doc/library/_winreg.rst:706 +#: library/_winreg.rst:706 msgid "" "The HKEY object implements :meth:`~object.__enter__` and :meth:`~object." "__exit__` and thus supports the context protocol for the :keyword:`with` " "statement::" msgstr "" -#: ../src/Doc/library/_winreg.rst:713 +#: library/_winreg.rst:713 msgid "" "will automatically close *key* when control leaves the :keyword:`with` block." msgstr "" -#: ../src/Doc/library/abc.rst:2 +#: library/abc.rst:2 msgid ":mod:`abc` --- Abstract Base Classes" msgstr "" # 8974c13965a345e3b6abe6c98e2ef71c -#: ../src/Doc/library/abc.rst:12 +#: library/abc.rst:12 msgid "**Source code:** :source:`Lib/abc.py`" msgstr "" # ee2ad39f943c4b17af8ad3b9c7558f22 -#: ../src/Doc/library/abc.rst:16 +#: library/abc.rst:16 msgid "" "This module provides the infrastructure for defining :term:`abstract base " "classes ` (ABCs) in Python, as outlined in :pep:`3119`; " @@ -1763,7 +1754,7 @@ msgid "" "mod:`numbers` module regarding a type hierarchy for numbers based on ABCs.)" msgstr "" -#: ../src/Doc/library/abc.rst:21 +#: library/abc.rst:21 msgid "" "The :mod:`collections` module has some concrete classes that derive from " "ABCs; these can, of course, be further derived. In addition the :mod:" @@ -1772,15 +1763,15 @@ msgid "" "a mapping." msgstr "" -#: ../src/Doc/library/abc.rst:28 +#: library/abc.rst:28 msgid "This module provides the following class:" msgstr "" -#: ../src/Doc/library/abc.rst:32 +#: library/abc.rst:32 msgid "Metaclass for defining Abstract Base Classes (ABCs)." msgstr "" -#: ../src/Doc/library/abc.rst:34 +#: library/abc.rst:34 msgid "" "Use this metaclass to create an ABC. An ABC can be subclassed directly, and " "then acts as a mix-in class. You can also register unrelated concrete " @@ -1792,26 +1783,26 @@ msgid "" "even via :func:`super`). [#]_" msgstr "" -#: ../src/Doc/library/abc.rst:43 +#: library/abc.rst:43 msgid "" "Classes created with a metaclass of :class:`ABCMeta` have the following " "method:" msgstr "" -#: ../src/Doc/library/abc.rst:47 +#: library/abc.rst:47 msgid "" "Register *subclass* as a \"virtual subclass\" of this ABC. For example::" msgstr "" -#: ../src/Doc/library/abc.rst:60 +#: library/abc.rst:60 msgid "You can also override this method in an abstract base class:" msgstr "" -#: ../src/Doc/library/abc.rst:64 +#: library/abc.rst:64 msgid "(Must be defined as a class method.)" msgstr "" -#: ../src/Doc/library/abc.rst:66 +#: library/abc.rst:66 msgid "" "Check whether *subclass* is considered a subclass of this ABC. This means " "that you can customize the behavior of ``issubclass`` further without the " @@ -1820,7 +1811,7 @@ msgid "" "method of the ABC.)" msgstr "" -#: ../src/Doc/library/abc.rst:72 +#: library/abc.rst:72 msgid "" "This method should return ``True``, ``False`` or ``NotImplemented``. If it " "returns ``True``, the *subclass* is considered a subclass of this ABC. If it " @@ -1829,13 +1820,13 @@ msgid "" "subclass check is continued with the usual mechanism." msgstr "" -#: ../src/Doc/library/abc.rst:82 +#: library/abc.rst:82 msgid "" "For a demonstration of these concepts, look at this example ABC definition::" msgstr "" # dd23bdf76d824abea408b3c94bb26082 -#: ../src/Doc/library/abc.rst:112 +#: library/abc.rst:112 msgid "" "The ABC ``MyIterable`` defines the standard iterable method, :meth:" "`~iterator.__iter__`, as an abstract method. The implementation given here " @@ -1845,7 +1836,7 @@ msgid "" msgstr "" # 334e75ffe6aa4d97be0708209fbc0756 -#: ../src/Doc/library/abc.rst:118 +#: library/abc.rst:118 msgid "" "The :meth:`__subclasshook__` class method defined here says that any class " "that has an :meth:`~iterator.__iter__` method in its :attr:`~object." @@ -1854,7 +1845,7 @@ msgid "" msgstr "" # f3ee4e0da92647a4828b8b6b525c1edb -#: ../src/Doc/library/abc.rst:123 +#: library/abc.rst:123 msgid "" "Finally, the last line makes ``Foo`` a virtual subclass of ``MyIterable``, " "even though it does not define an :meth:`~iterator.__iter__` method (it uses " @@ -1863,15 +1854,15 @@ msgid "" "available as a method of ``Foo``, so it is provided separately." msgstr "" -#: ../src/Doc/library/abc.rst:130 +#: library/abc.rst:130 msgid "It also provides the following decorators:" msgstr "" -#: ../src/Doc/library/abc.rst:134 +#: library/abc.rst:134 msgid "A decorator indicating abstract methods." msgstr "" -#: ../src/Doc/library/abc.rst:136 +#: library/abc.rst:136 msgid "" "Using this decorator requires that the class's metaclass is :class:`ABCMeta` " "or is derived from it. A class that has a metaclass derived from :class:" @@ -1880,7 +1871,7 @@ msgid "" "the normal 'super' call mechanisms." msgstr "" -#: ../src/Doc/library/abc.rst:144 +#: library/abc.rst:144 msgid "" "Dynamically adding abstract methods to a class, or attempting to modify the " "abstraction status of a method or class once it is created, are not " @@ -1889,11 +1880,11 @@ msgid "" "`register` method are not affected." msgstr "" -#: ../src/Doc/library/abc.rst:150 ../src/Doc/library/abc.rst:179 +#: library/abc.rst:150 library/abc.rst:179 msgid "Usage::" msgstr "" -#: ../src/Doc/library/abc.rst:160 +#: library/abc.rst:160 msgid "" "Unlike Java abstract methods, these abstract methods may have an " "implementation. This implementation can be called via the :func:`super` " @@ -1902,12 +1893,12 @@ msgid "" "inheritance." msgstr "" -#: ../src/Doc/library/abc.rst:170 +#: library/abc.rst:170 msgid "" "A subclass of the built-in :func:`property`, indicating an abstract property." msgstr "" -#: ../src/Doc/library/abc.rst:172 +#: library/abc.rst:172 msgid "" "Using this function requires that the class's metaclass is :class:`ABCMeta` " "or is derived from it. A class that has a metaclass derived from :class:" @@ -1916,48 +1907,41 @@ msgid "" "of the normal 'super' call mechanisms." msgstr "" -#: ../src/Doc/library/abc.rst:187 +#: library/abc.rst:187 msgid "" "This defines a read-only property; you can also define a read-write abstract " "property using the 'long' form of property declaration::" msgstr "" -#: ../src/Doc/library/abc.rst:198 ../src/Doc/library/cgi.rst:540 -#: ../src/Doc/library/chunk.rst:130 ../src/Doc/library/datetime.rst:1768 -#: ../src/Doc/library/doctest.rst:1903 ../src/Doc/library/email.rst:345 -#: ../src/Doc/library/email-examples.rst:44 -#: ../src/Doc/library/email.encoders.rst:58 -#: ../src/Doc/library/email.generator.rst:130 -#: ../src/Doc/library/email.parser.rst:225 -#: ../src/Doc/library/email.util.rst:161 ../src/Doc/library/functions.rst:1753 -#: ../src/Doc/library/gc.rst:239 ../src/Doc/library/gettext.rst:748 -#: ../src/Doc/library/heapq.rst:298 ../src/Doc/library/marshal.rst:128 -#: ../src/Doc/library/pdb.rst:400 ../src/Doc/library/pickle.rst:847 -#: ../src/Doc/library/profile.rst:673 ../src/Doc/library/pyexpat.rst:911 -#: ../src/Doc/library/rfc822.rst:350 ../src/Doc/library/sqlite3.rst:924 -#: ../src/Doc/library/stdtypes.rst:3102 ../src/Doc/library/time.rst:562 -#: ../src/Doc/library/webbrowser.rst:206 -#: ../src/Doc/library/xml.dom.minidom.rst:275 -#: ../src/Doc/library/xml.etree.elementtree.rst:953 -#: ../src/Doc/library/xmlrpclib.rst:597 +#: library/abc.rst:198 library/cgi.rst:540 library/chunk.rst:130 +#: library/datetime.rst:1768 library/doctest.rst:1920 library/email.rst:345 +#: library/email-examples.rst:44 library/email.encoders.rst:58 +#: library/email.generator.rst:130 library/email.parser.rst:225 +#: library/email.util.rst:161 library/functions.rst:1753 library/gc.rst:239 +#: library/gettext.rst:748 library/heapq.rst:300 library/json.rst:614 +#: library/marshal.rst:128 library/pdb.rst:400 library/pickle.rst:847 +#: library/profile.rst:673 library/pyexpat.rst:911 library/rfc822.rst:350 +#: library/sqlite3.rst:924 library/stdtypes.rst:3133 library/time.rst:561 +#: library/webbrowser.rst:206 library/xml.dom.minidom.rst:275 +#: library/xml.etree.elementtree.rst:1032 library/xmlrpclib.rst:601 msgid "Footnotes" msgstr "Notes" -#: ../src/Doc/library/abc.rst:199 +#: library/abc.rst:199 msgid "" "C++ programmers should note that Python's virtual base class concept is not " "the same as C++'s." msgstr "" # dc4fe1110b124c4796e0d0daabc41d92 -#: ../src/Doc/library/aepack.rst:3 +#: library/aepack.rst:3 msgid "" ":mod:`aepack` --- Conversion between Python variables and AppleEvent data " "containers" msgstr "" # 26d831aeb7094750b7647a5873632dcb -#: ../src/Doc/library/aepack.rst:12 +#: library/aepack.rst:12 msgid "" "The :mod:`aepack` module defines functions for converting (packing) Python " "variables to AppleEvent descriptors and back (unpacking). Within Python the " @@ -1974,21 +1958,19 @@ msgstr "" # fef0909e811d4b16bc38e5c8f42b5b96 # d2e6911cd02c4d139aa99685c1c3a189 # 62d3b620f8254368ac0c3dc543986223 -#: ../src/Doc/library/aepack.rst:19 ../src/Doc/library/aetools.rst:27 -#: ../src/Doc/library/aetypes.rst:36 ../src/Doc/library/autogil.rst:18 -#: ../src/Doc/library/colorpicker.rst:18 ../src/Doc/library/easydialogs.rst:21 -#: ../src/Doc/library/framework.rst:21 ../src/Doc/library/ic.rst:15 -#: ../src/Doc/library/macos.rst:16 +#: library/aepack.rst:19 library/aetools.rst:27 library/aetypes.rst:36 +#: library/autogil.rst:18 library/colorpicker.rst:18 library/easydialogs.rst:21 +#: library/framework.rst:21 library/ic.rst:15 library/macos.rst:16 msgid "This module has been removed in Python 3.x." msgstr "" # 250a41c50e204c8db8aa02d3a1ba1030 -#: ../src/Doc/library/aepack.rst:22 +#: library/aepack.rst:22 msgid "The :mod:`aepack` module defines the following functions:" msgstr "" # dc481c49becf44e4ae53ac5dc31fd88e -#: ../src/Doc/library/aepack.rst:27 +#: library/aepack.rst:27 msgid "" "Returns an :class:`AEDesc` object containing a conversion of Python value " "x. If *forcetype* is provided it specifies the descriptor type of the " @@ -1996,138 +1978,131 @@ msgid "" "descriptor types is used, as follows:" msgstr "" -#: ../src/Doc/library/aepack.rst:33 ../src/Doc/library/ctypes.rst:221 -#: ../src/Doc/library/sqlite3.rst:681 ../src/Doc/library/sqlite3.rst:701 -#: ../src/Doc/library/struct.rst:166 +#: library/aepack.rst:33 library/ctypes.rst:221 library/sqlite3.rst:681 +#: library/sqlite3.rst:701 library/struct.rst:166 msgid "Python type" msgstr "" # 0720c31b44374d0191ea404195e0413e -#: ../src/Doc/library/aepack.rst:33 +#: library/aepack.rst:33 msgid "descriptor type" msgstr "" # d140294ede304ac5b19a94b7eeee45c1 -#: ../src/Doc/library/aepack.rst:35 +#: library/aepack.rst:35 msgid ":class:`FSSpec`" msgstr "" # ba450243ba31401fa7753abf52f10423 -#: ../src/Doc/library/aepack.rst:35 +#: library/aepack.rst:35 msgid "typeFSS" msgstr "" # a7eadfd4e130459fa0efa0d17aa35cdf -#: ../src/Doc/library/aepack.rst:37 +#: library/aepack.rst:37 msgid ":class:`FSRef`" msgstr "" # 59f8f5fb4272418aba2d152b133aea3a -#: ../src/Doc/library/aepack.rst:37 +#: library/aepack.rst:37 msgid "typeFSRef" msgstr "" # 9d43222fbb53471cb8494e3273951241 -#: ../src/Doc/library/aepack.rst:39 +#: library/aepack.rst:39 msgid ":class:`Alias`" msgstr "" # f10af736f9bb4cd1b1596deafa7e282f -#: ../src/Doc/library/aepack.rst:39 +#: library/aepack.rst:39 msgid "typeAlias" msgstr "" -#: ../src/Doc/library/aepack.rst:41 ../src/Doc/library/struct.rst:172 -#: ../src/Doc/library/struct.rst:174 ../src/Doc/library/struct.rst:178 -#: ../src/Doc/library/struct.rst:180 ../src/Doc/library/struct.rst:182 -#: ../src/Doc/library/struct.rst:184 ../src/Doc/library/struct.rst:186 -#: ../src/Doc/library/struct.rst:188 ../src/Doc/library/struct.rst:190 -#: ../src/Doc/library/struct.rst:192 ../src/Doc/library/struct.rst:203 +#: library/aepack.rst:41 library/struct.rst:172 library/struct.rst:174 +#: library/struct.rst:178 library/struct.rst:180 library/struct.rst:182 +#: library/struct.rst:184 library/struct.rst:186 library/struct.rst:188 +#: library/struct.rst:190 library/struct.rst:192 library/struct.rst:203 msgid "integer" msgstr "" # 5e37813c98d548d090aa832f1d19b973 -#: ../src/Doc/library/aepack.rst:41 +#: library/aepack.rst:41 msgid "typeLong (32 bit integer)" msgstr "" -#: ../src/Doc/library/aepack.rst:43 ../src/Doc/library/array.rst:41 -#: ../src/Doc/library/array.rst:43 ../src/Doc/library/ctypes.rst:250 -#: ../src/Doc/library/ctypes.rst:252 ../src/Doc/library/ctypes.rst:254 -#: ../src/Doc/library/fl.rst:356 ../src/Doc/library/fl.rst:358 -#: ../src/Doc/library/fl.rst:360 ../src/Doc/library/fl.rst:362 -#: ../src/Doc/library/fl.rst:438 ../src/Doc/library/fl.rst:440 -#: ../src/Doc/library/fl.rst:442 ../src/Doc/library/fl.rst:444 -#: ../src/Doc/library/fl.rst:454 ../src/Doc/library/json.rst:296 -#: ../src/Doc/library/struct.rst:195 ../src/Doc/library/struct.rst:197 +#: library/aepack.rst:43 library/array.rst:41 library/array.rst:43 +#: library/ctypes.rst:250 library/ctypes.rst:252 library/ctypes.rst:254 +#: library/fl.rst:356 library/fl.rst:358 library/fl.rst:360 library/fl.rst:362 +#: library/fl.rst:438 library/fl.rst:440 library/fl.rst:442 library/fl.rst:444 +#: library/fl.rst:454 library/json.rst:298 library/struct.rst:195 +#: library/struct.rst:197 msgid "float" msgstr "" # 3996de3a017c43e68030a32f176fc29b -#: ../src/Doc/library/aepack.rst:43 +#: library/aepack.rst:43 msgid "typeFloat (64 bit floating point)" msgstr "" -#: ../src/Doc/library/aepack.rst:45 ../src/Doc/library/fl.rst:456 -#: ../src/Doc/library/json.rst:292 ../src/Doc/library/json.rst:384 -#: ../src/Doc/library/struct.rst:199 ../src/Doc/library/struct.rst:201 +#: library/aepack.rst:45 library/fl.rst:456 library/json.rst:294 +#: library/json.rst:386 library/struct.rst:199 library/struct.rst:201 msgid "string" msgstr "" # f803597d0e2f4db6bf385592d05f6ecd -#: ../src/Doc/library/aepack.rst:45 +#: library/aepack.rst:45 msgid "typeText" msgstr "" # 3fa2ae3c3d974c96a7c3714400d33ef8 # bcbbb0dc51c64c079bbc44cbd8da14a9 -#: ../src/Doc/library/aepack.rst:47 ../src/Doc/library/json.rst:292 +#: library/aepack.rst:47 library/json.rst:294 msgid "unicode" msgstr "" # 8721c7a49b114ccaa8b8b6912af2682a -#: ../src/Doc/library/aepack.rst:47 +#: library/aepack.rst:47 msgid "typeUnicodeText" msgstr "" -#: ../src/Doc/library/aepack.rst:49 ../src/Doc/library/json.rst:290 +#: library/aepack.rst:49 library/json.rst:292 msgid "list" msgstr "list" # 570a323ca35c49f48972d9413134d8f2 -#: ../src/Doc/library/aepack.rst:49 +#: library/aepack.rst:49 msgid "typeAEList" msgstr "" # 4952610a88cf478d9c5d24d2a8983294 -#: ../src/Doc/library/aepack.rst:51 +#: library/aepack.rst:51 msgid "dictionary" msgstr "dictionnaire" # afc32fdf6cfd4bb782aecfa40cacad25 -#: ../src/Doc/library/aepack.rst:51 +#: library/aepack.rst:51 msgid "typeAERecord" msgstr "" # e5ef91fb2e91433882c9bf91fc046774 -#: ../src/Doc/library/aepack.rst:53 +#: library/aepack.rst:53 msgid "instance" msgstr "" # a5584dcbe5a34ff4a520ca74a9beb42a -#: ../src/Doc/library/aepack.rst:53 +#: library/aepack.rst:53 msgid "*see below*" msgstr "" # f7d6722bd14c4c76aef8a2537517c3d3 -#: ../src/Doc/library/aepack.rst:56 +#: library/aepack.rst:56 msgid "" "If *x* is a Python instance then this function attempts to call an :meth:" "`__aepack__` method. This method should return an :class:`AEDesc` object." msgstr "" # 51d1ad9d7d0f4a2591045c46e955e920 -#: ../src/Doc/library/aepack.rst:59 +#: library/aepack.rst:59 msgid "" "If the conversion *x* is not defined above, this function returns the Python " "string representation of a value (the repr() function) encoded as a text " @@ -2135,7 +2110,7 @@ msgid "" msgstr "" # 93ddc8600e044afc8d9fe9fccf6df07d -#: ../src/Doc/library/aepack.rst:66 +#: library/aepack.rst:66 msgid "" "*x* must be an object of type :class:`AEDesc`. This function returns a " "Python object representation of the data in the Apple Event descriptor *x*. " @@ -2150,7 +2125,7 @@ msgid "" msgstr "" # a88aef263eae44229f8c0f8db1a4d385 -#: ../src/Doc/library/aepack.rst:77 +#: library/aepack.rst:77 msgid "" "The optional ``formodulename`` argument is used by the stub packages " "generated by :mod:`gensuitemodule`, and ensures that the OSA classes for " @@ -2161,33 +2136,32 @@ msgid "" "latter knows no such things." msgstr "" -# 40673b0b240b4fbcb6a2b7554da2dcd4 -#: ../src/Doc/library/aepack.rst:88 -msgid "Module :mod:`Carbon.AE`" +#: library/aepack.rst:89 +msgid "Module Carbon.AE" msgstr "" # 5e180495069246519b1d87eb79f326a2 -#: ../src/Doc/library/aepack.rst:89 +#: library/aepack.rst:89 msgid "Built-in access to Apple Event Manager routines." msgstr "" -# 63188f27165449da856a1660a582e16d -#: ../src/Doc/library/aepack.rst:90 -msgid "Module :mod:`aetypes`" -msgstr "" +#: library/aepack.rst:91 +#, fuzzy +msgid "Module aetypes" +msgstr "Modules" # 4c9fe1800e4e4b11a63c20a3f3a5b912 -#: ../src/Doc/library/aepack.rst:92 +#: library/aepack.rst:92 msgid "Python definitions of codes for Apple Event descriptor types." msgstr "" # 0a76a49fb0f640d5a7918336f821091a -#: ../src/Doc/library/aetools.rst:3 +#: library/aetools.rst:3 msgid ":mod:`aetools` --- OSA client support" msgstr "" # 1b9c725051f64f38a90f8632c0d20d4d -#: ../src/Doc/library/aetools.rst:12 +#: library/aetools.rst:12 msgid "" "The :mod:`aetools` module contains the basic functionality on which Python " "AppleScript client support is built. It also imports and re-exports the core " @@ -2199,7 +2173,7 @@ msgid "" msgstr "" # 2cbd762ea62c41668ada880f5f0e54e0 -#: ../src/Doc/library/aetools.rst:20 +#: library/aetools.rst:20 msgid "" "The :mod:`aetools` module itself uses the AppleEvent support provided by " "the :mod:`Carbon.AE` module. This has one drawback: you need access to the " @@ -2208,12 +2182,12 @@ msgid "" msgstr "" # 1624834ea5ba4f46b0e16f3d0b959e2e -#: ../src/Doc/library/aetools.rst:30 +#: library/aetools.rst:30 msgid "The :mod:`aetools` module defines the following functions:" msgstr "" # 4d3e05e15fa14a4d988027476fd20a97 -#: ../src/Doc/library/aetools.rst:35 +#: library/aetools.rst:35 msgid "" "Stores parameters and attributes in a pre-created ``Carbon.AE.AEDesc`` " "object. ``parameters`` and ``attributes`` are dictionaries mapping 4-" @@ -2222,7 +2196,7 @@ msgid "" msgstr "" # 7f40ec7f01c049349db66648f55542b7 -#: ../src/Doc/library/aetools.rst:43 +#: library/aetools.rst:43 msgid "" "Recursively unpacks a ``Carbon.AE.AEDesc`` event to Python objects. The " "function returns the parameter dictionary and the attribute dictionary. The " @@ -2231,7 +2205,7 @@ msgid "" msgstr "" # a0877a0b08b349d2b6f03282ff623901 -#: ../src/Doc/library/aetools.rst:51 +#: library/aetools.rst:51 msgid "" "Converts a Python keyword argument dictionary ``arguments`` to the format " "required by ``packevent`` by replacing the keys, which are Python " @@ -2240,7 +2214,7 @@ msgid "" msgstr "" # a7493a1b26b1444ca4e281344f61add0 -#: ../src/Doc/library/aetools.rst:59 +#: library/aetools.rst:59 msgid "" "If the ``arguments`` dictionary contains an entry for ``key`` convert the " "value for that entry according to dictionary ``edict``. This converts human-" @@ -2249,12 +2223,12 @@ msgid "" msgstr "" # 4ae712ba702847d4bc98115c99d31cad -#: ../src/Doc/library/aetools.rst:64 +#: library/aetools.rst:64 msgid "The :mod:`aetools` module defines the following class:" msgstr "" # 37ef1a168f74435781bf9a298d7ab1a6 -#: ../src/Doc/library/aetools.rst:69 +#: library/aetools.rst:69 msgid "" "Base class for the proxy used to talk to an application. ``signature`` " "overrides the class attribute ``_signature`` (which is usually set by " @@ -2265,13 +2239,13 @@ msgid "" msgstr "" # 31010b2120dc4eafb063e6c294bf0952 -#: ../src/Doc/library/aetools.rst:79 +#: library/aetools.rst:79 msgid "" "Test whether the application is running, and attempt to start it if not." msgstr "" # 2900508c72d74befb93f16c4810dea60 -#: ../src/Doc/library/aetools.rst:84 +#: library/aetools.rst:84 msgid "" "Create the AppleEvent ``Carbon.AE.AEDesc`` for the verb with the OSA " "designation ``code, subcode`` (which are the usual 4-character strings), " @@ -2282,19 +2256,19 @@ msgid "" msgstr "" # 1e76be62404143c493163819b44b3500 -#: ../src/Doc/library/aetypes.rst:3 +#: library/aetypes.rst:3 msgid ":mod:`aetypes` --- AppleEvent objects" msgstr "" # 01d9a374394149ebbb9f0da71786c06c -#: ../src/Doc/library/aetypes.rst:12 +#: library/aetypes.rst:12 msgid "" "The :mod:`aetypes` defines classes used to represent Apple Event data " "descriptors and Apple Event object specifiers." msgstr "" # e7bf7aeab7df47ccbf0e95aa4bdb220d -#: ../src/Doc/library/aetypes.rst:15 +#: library/aetypes.rst:15 msgid "" "Apple Event data is contained in descriptors, and these descriptors are " "typed. For many descriptors the Python representation is simply the " @@ -2305,7 +2279,7 @@ msgid "" msgstr "" # d4b69c2b6457415b86c45cba56af21ee -#: ../src/Doc/library/aetypes.rst:22 +#: library/aetypes.rst:22 msgid "" "An object specifier is essentially an address of an object implemented in a " "Apple Event server. An Apple Event specifier is used as the direct object " @@ -2316,7 +2290,7 @@ msgid "" msgstr "" # 3e5189ae2a4f4f388365bb0ec0fddc6a -#: ../src/Doc/library/aetypes.rst:29 +#: library/aetypes.rst:29 msgid "" "For reasons of backward compatibility, and for cases where you need to " "script an application for which you have not generated the stub package this " @@ -2325,14 +2299,14 @@ msgid "" msgstr "" # c549db14ed4c4056b9effb93f59f939a -#: ../src/Doc/library/aetypes.rst:40 +#: library/aetypes.rst:40 msgid "" "The :mod:`AEObjects` module defines the following classes to represent Apple " "Event descriptor data:" msgstr "" # 1cfc5179661f48c99240197c71889e9b -#: ../src/Doc/library/aetypes.rst:46 +#: library/aetypes.rst:46 msgid "" "The representation of OSA descriptor data for which the :mod:`aepack` and :" "mod:`aetypes` modules have no support, i.e. anything that is not represented " @@ -2341,96 +2315,96 @@ msgid "" msgstr "" # 07980b6a7f384c91b3224864d1528e19 -#: ../src/Doc/library/aetypes.rst:53 +#: library/aetypes.rst:53 msgid "An enumeration value with the given 4-character string value." msgstr "" # 2404875ec8754e1aaabdedba07f27cb6 -#: ../src/Doc/library/aetypes.rst:58 +#: library/aetypes.rst:58 msgid "Position ``pos`` in object ``of``." msgstr "" # 15256e15923347e2bbff00c34e2e6815 -#: ../src/Doc/library/aetypes.rst:63 +#: library/aetypes.rst:63 msgid "A boolean." msgstr "" # cf8041da08d24ff4bb0521d6f41d4543 -#: ../src/Doc/library/aetypes.rst:68 +#: library/aetypes.rst:68 msgid "Text with style information (font, face, etc) included." msgstr "" # 8bea160ec89348cea15d76c667367971 -#: ../src/Doc/library/aetypes.rst:73 +#: library/aetypes.rst:73 msgid "Text with script system and style information included." msgstr "" # 0780f30e92904afbb0e3bac9b01dcf2c -#: ../src/Doc/library/aetypes.rst:78 +#: library/aetypes.rst:78 msgid "Text with script system and language information included." msgstr "" # 4d1405b2532e454898d70485f24f5b41 -#: ../src/Doc/library/aetypes.rst:83 +#: library/aetypes.rst:83 msgid "Script system and language information." msgstr "" # 224f31e635db480e8b4b483dcf57f283 -#: ../src/Doc/library/aetypes.rst:88 +#: library/aetypes.rst:88 msgid "A quickdraw point." msgstr "" # 9459cc3f8261418cb083daae4e5349b0 -#: ../src/Doc/library/aetypes.rst:93 +#: library/aetypes.rst:93 msgid "A quickdraw rectangle." msgstr "" # b3bf308405b845c6bdfb2206df7002c4 -#: ../src/Doc/library/aetypes.rst:98 +#: library/aetypes.rst:98 msgid "A color." msgstr "" # 680ed59278674609b731c67c26e9c31f -#: ../src/Doc/library/aetypes.rst:103 +#: library/aetypes.rst:103 msgid "An OSA type value with the given 4-character name." msgstr "" # 259f996498234898af0372688b461618 -#: ../src/Doc/library/aetypes.rst:108 +#: library/aetypes.rst:108 msgid "An OSA keyword with the given 4-character name." msgstr "" # 23964f826ca1445b87c7a710b42901d9 -#: ../src/Doc/library/aetypes.rst:113 +#: library/aetypes.rst:113 msgid "A range." msgstr "" # 8da7e631c05640d998b9e258952f4c4b -#: ../src/Doc/library/aetypes.rst:118 +#: library/aetypes.rst:118 msgid "" "Non-numeric absolute positions, such as ``\"firs\"``, first, or ``\"midd" "\"``, middle." msgstr "" # 6cede6f37fea4a5d8818d80af1a3d023 -#: ../src/Doc/library/aetypes.rst:124 +#: library/aetypes.rst:124 msgid "The logical expression of applying operator ``logc`` to ``term``." msgstr "" # 917683536f4d48e4a4d630a9d751ecb6 -#: ../src/Doc/library/aetypes.rst:129 +#: library/aetypes.rst:129 msgid "The comparison ``relo`` of ``obj1`` to ``obj2``." msgstr "" # eecb4eb27f13440d999178223d23b103 -#: ../src/Doc/library/aetypes.rst:131 +#: library/aetypes.rst:131 msgid "" "The following classes are used as base classes by the generated stub " "packages to represent AppleScript classes and properties in Python:" msgstr "" # 9a22d6f6e3324686b154d5b7dc5407e8 -#: ../src/Doc/library/aetypes.rst:137 +#: library/aetypes.rst:137 msgid "" "Abstract baseclass for an OSA class. The subclass should set the class " "attribute ``want`` to the 4-character OSA class code. Instances of " @@ -2440,7 +2414,7 @@ msgid "" msgstr "" # e096cf4cb88a44778503b34e1d664caf -#: ../src/Doc/library/aetypes.rst:145 +#: library/aetypes.rst:145 msgid "" "Abstract baseclass for an OSA property. The subclass should set the class " "attributes ``want`` and ``which`` to designate which property we are talking " @@ -2448,23 +2422,23 @@ msgid "" msgstr "" # 1b41ead3945f44f48d4c721a1349c4e2 -#: ../src/Doc/library/aetypes.rst:152 +#: library/aetypes.rst:152 msgid "" "Base class of ``ComponentItem`` and ``NProperty``, a general OSA Object " "Specifier. See the Apple Open Scripting Architecture documentation for the " "parameters. Note that this class is not abstract." msgstr "" -#: ../src/Doc/library/aifc.rst:2 +#: library/aifc.rst:2 msgid ":mod:`aifc` --- Read and write AIFF and AIFC files" msgstr "" # fe88912abf3942f8ab1f3c3badf94b62 -#: ../src/Doc/library/aifc.rst:13 +#: library/aifc.rst:13 msgid "**Source code:** :source:`Lib/aifc.py`" msgstr "" -#: ../src/Doc/library/aifc.rst:17 +#: library/aifc.rst:17 msgid "" "This module provides support for reading and writing AIFF and AIFF-C files. " "AIFF is Audio Interchange File Format, a format for storing digital audio " @@ -2472,7 +2446,7 @@ msgid "" "the ability to compress the audio data." msgstr "" -#: ../src/Doc/library/aifc.rst:24 +#: library/aifc.rst:24 msgid "" "Some operations may only work under IRIX; these will raise :exc:" "`ImportError` when attempting to import the :mod:`cl` module, which is only " @@ -2480,7 +2454,7 @@ msgid "" msgstr "" # cf2a268055f144ce825ee098e317cce9 -#: ../src/Doc/library/aifc.rst:28 +#: library/aifc.rst:28 msgid "" "Audio files have a number of parameters that describe the audio data. The " "sampling rate or frame rate is the number of times per second the sound is " @@ -2491,7 +2465,7 @@ msgid "" "\\ *samplesize*\\*\\ *framerate* bytes." msgstr "" -#: ../src/Doc/library/aifc.rst:36 +#: library/aifc.rst:36 msgid "" "For example, CD quality audio has a sample size of two bytes (16 bits), uses " "two channels (stereo) and has a frame rate of 44,100 frames/second. This " @@ -2499,11 +2473,11 @@ msgid "" "2\\*2\\*44100 bytes (176,400 bytes)." msgstr "" -#: ../src/Doc/library/aifc.rst:41 +#: library/aifc.rst:41 msgid "Module :mod:`aifc` defines the following function:" msgstr "" -#: ../src/Doc/library/aifc.rst:46 +#: library/aifc.rst:46 msgid "" "Open an AIFF or AIFF-C file and return an object instance with methods that " "are described below. The argument *file* is either a string naming a file " @@ -2515,48 +2489,48 @@ msgid "" "use :meth:`writeframesraw` and :meth:`setnframes`." msgstr "" -#: ../src/Doc/library/aifc.rst:55 +#: library/aifc.rst:55 msgid "" "Objects returned by :func:`.open` when a file is opened for reading have the " "following methods:" msgstr "" -#: ../src/Doc/library/aifc.rst:61 +#: library/aifc.rst:61 msgid "Return the number of audio channels (1 for mono, 2 for stereo)." msgstr "" -#: ../src/Doc/library/aifc.rst:66 +#: library/aifc.rst:66 msgid "Return the size in bytes of individual samples." msgstr "" -#: ../src/Doc/library/aifc.rst:71 +#: library/aifc.rst:71 msgid "Return the sampling rate (number of audio frames per second)." msgstr "" -#: ../src/Doc/library/aifc.rst:76 +#: library/aifc.rst:76 msgid "Return the number of audio frames in the file." msgstr "" # 394b2160df6b435683c4cdb0bdb9af7e -#: ../src/Doc/library/aifc.rst:81 +#: library/aifc.rst:81 msgid "" "Return a four-character string describing the type of compression used in " "the audio file. For AIFF files, the returned value is ``'NONE'``." msgstr "" # b748c64f963145b798cd3fc05f545956 -#: ../src/Doc/library/aifc.rst:87 +#: library/aifc.rst:87 msgid "" "Return a human-readable description of the type of compression used in the " "audio file. For AIFF files, the returned value is ``'not compressed'``." msgstr "" -#: ../src/Doc/library/aifc.rst:93 +#: library/aifc.rst:93 msgid "" "Return a tuple consisting of all of the above values in the above order." msgstr "" -#: ../src/Doc/library/aifc.rst:98 +#: library/aifc.rst:98 msgid "" "Return a list of markers in the audio file. A marker consists of a tuple of " "three elements. The first is the mark ID (an integer), the second is the " @@ -2564,40 +2538,40 @@ msgid "" "third is the name of the mark (a string)." msgstr "" -#: ../src/Doc/library/aifc.rst:106 +#: library/aifc.rst:106 msgid "" "Return the tuple as described in :meth:`getmarkers` for the mark with the " "given *id*." msgstr "" -#: ../src/Doc/library/aifc.rst:112 +#: library/aifc.rst:112 msgid "" "Read and return the next *nframes* frames from the audio file. The returned " "data is a string containing for each frame the uncompressed samples of all " "channels." msgstr "" -#: ../src/Doc/library/aifc.rst:119 +#: library/aifc.rst:119 msgid "" "Rewind the read pointer. The next :meth:`readframes` will start from the " "beginning." msgstr "" -#: ../src/Doc/library/aifc.rst:125 +#: library/aifc.rst:125 msgid "Seek to the specified frame number." msgstr "" -#: ../src/Doc/library/aifc.rst:130 +#: library/aifc.rst:130 msgid "Return the current frame number." msgstr "" -#: ../src/Doc/library/aifc.rst:135 +#: library/aifc.rst:135 msgid "" "Close the AIFF file. After calling this method, the object can no longer be " "used." msgstr "" -#: ../src/Doc/library/aifc.rst:138 +#: library/aifc.rst:138 msgid "" "Objects returned by :func:`.open` when a file is opened for writing have all " "the above methods, except for :meth:`readframes` and :meth:`setpos`. In " @@ -2607,33 +2581,33 @@ msgid "" "parameters except for the number of frames must be filled in." msgstr "" -#: ../src/Doc/library/aifc.rst:148 +#: library/aifc.rst:148 msgid "" "Create an AIFF file. The default is that an AIFF-C file is created, unless " "the name of the file ends in ``'.aiff'`` in which case the default is an " "AIFF file." msgstr "" -#: ../src/Doc/library/aifc.rst:154 +#: library/aifc.rst:154 msgid "" "Create an AIFF-C file. The default is that an AIFF-C file is created, " "unless the name of the file ends in ``'.aiff'`` in which case the default is " "an AIFF file." msgstr "" -#: ../src/Doc/library/aifc.rst:161 +#: library/aifc.rst:161 msgid "Specify the number of channels in the audio file." msgstr "" -#: ../src/Doc/library/aifc.rst:166 +#: library/aifc.rst:166 msgid "Specify the size in bytes of audio samples." msgstr "" -#: ../src/Doc/library/aifc.rst:171 +#: library/aifc.rst:171 msgid "Specify the sampling frequency in frames per second." msgstr "" -#: ../src/Doc/library/aifc.rst:176 +#: library/aifc.rst:176 msgid "" "Specify the number of frames that are to be written to the audio file. If " "this parameter is not set, or not set correctly, the file needs to support " @@ -2641,7 +2615,7 @@ msgid "" msgstr "" # ddbe7fdc09cd4ba9a536730149052769 -#: ../src/Doc/library/aifc.rst:187 +#: library/aifc.rst:187 msgid "" "Specify the compression type. If not specified, the audio data will not be " "compressed. In AIFF files, compression is not possible. The name parameter " @@ -2650,38 +2624,38 @@ msgid "" "compression types are supported: NONE, ULAW, ALAW, G722." msgstr "" -#: ../src/Doc/library/aifc.rst:196 +#: library/aifc.rst:196 msgid "" "Set all the above parameters at once. The argument is a tuple consisting of " "the various parameters. This means that it is possible to use the result of " "a :meth:`getparams` call as argument to :meth:`setparams`." msgstr "" -#: ../src/Doc/library/aifc.rst:203 +#: library/aifc.rst:203 msgid "" "Add a mark with the given id (larger than 0), and the given name at the " "given position. This method can be called at any time before :meth:`close`." msgstr "" -#: ../src/Doc/library/aifc.rst:209 +#: library/aifc.rst:209 msgid "" "Return the current write position in the output file. Useful in combination " "with :meth:`setmark`." msgstr "" -#: ../src/Doc/library/aifc.rst:215 +#: library/aifc.rst:215 msgid "" "Write data to the output file. This method can only be called after the " "audio file parameters have been set." msgstr "" -#: ../src/Doc/library/aifc.rst:221 +#: library/aifc.rst:221 msgid "" "Like :meth:`writeframes`, except that the header of the audio file is not " "updated." msgstr "" -#: ../src/Doc/library/aifc.rst:227 +#: library/aifc.rst:227 msgid "" "Close the AIFF file. The header of the file is updated to reflect the " "actual size of the audio data. After calling this method, the object can no " @@ -2689,12 +2663,16 @@ msgid "" msgstr "" # de922522bff04203936722679b41ce7a -#: ../src/Doc/library/al.rst:3 +#: library/al.rst:3 msgid ":mod:`al` --- Audio functions on the SGI" msgstr "" +#: library/al.rst:10 +msgid "The :mod:`al` module has been removed in Python 3." +msgstr "" + # 5c3676363a77402bb5a411b0576c3613 -#: ../src/Doc/library/al.rst:14 +#: library/al.rst:14 msgid "" "This module provides access to the audio facilities of the SGI Indy and " "Indigo workstations. See section 3A of the IRIX man pages for details. " @@ -2705,21 +2683,21 @@ msgid "" msgstr "" # b49ead0a78af4ab496ddef0e26d30693 -#: ../src/Doc/library/al.rst:20 +#: library/al.rst:20 msgid "" "All functions and methods defined in this module are equivalent to the C " "functions with ``AL`` prefixed to their name." msgstr "" # a524026730754b3983e974d714b7de1b -#: ../src/Doc/library/al.rst:25 +#: library/al.rst:25 msgid "" "Symbolic constants from the C header file ```` are defined in the " "standard module :mod:`AL`, see below." msgstr "" # a7fc12868d4b4ab8b391bc464aec1f2d -#: ../src/Doc/library/al.rst:30 +#: library/al.rst:30 msgid "" "The current version of the audio library may dump core when bad argument " "values are passed rather than returning an error status. Unfortunately, " @@ -2729,14 +2707,13 @@ msgid "" "--- there is no documented upper limit.)" msgstr "" -#: ../src/Doc/library/al.rst:37 ../src/Doc/library/fcntl.rst:22 -#: ../src/Doc/library/syslog.rst:17 ../src/Doc/library/termios.rst:28 -#: ../src/Doc/library/traceback.rst:20 +#: library/al.rst:37 library/fcntl.rst:22 library/syslog.rst:17 +#: library/termios.rst:28 library/traceback.rst:20 msgid "The module defines the following functions:" msgstr "" # 70c1db1acb364a9db6eff593703edc7d -#: ../src/Doc/library/al.rst:42 +#: library/al.rst:42 msgid "" "The name and direction arguments are strings. The optional *config* " "argument is a configuration object as returned by :func:`newconfig`. The " @@ -2745,128 +2722,128 @@ msgid "" msgstr "" # 299ab43233d54a2f9dda62eb1d5ce25c -#: ../src/Doc/library/al.rst:49 +#: library/al.rst:49 msgid "" "The return value is a new :dfn:`audio configuration object`; methods of " "audio configuration objects are described below." msgstr "" # 893743fe8f6c45f093e24feb851849cc -#: ../src/Doc/library/al.rst:55 +#: library/al.rst:55 msgid "" "The device argument is an integer. The return value is a list of integers " "containing the data returned by :c:func:`ALqueryparams`." msgstr "" # a6a538775434473b8e0baea6988ec734 -#: ../src/Doc/library/al.rst:61 +#: library/al.rst:61 msgid "" "The *device* argument is an integer. The list argument is a list such as " "returned by :func:`queryparams`; it is modified in place (!)." msgstr "" # 0af89ed6ed1a40ce82d6c241aba9b09a -#: ../src/Doc/library/al.rst:67 +#: library/al.rst:67 msgid "" "The *device* argument is an integer. The *list* argument is a list such as " "returned by :func:`queryparams`." msgstr "" # 66ba60f328954cc7bdf32549afe1d434 -#: ../src/Doc/library/al.rst:74 +#: library/al.rst:74 msgid "Configuration Objects" msgstr "" # 8724b081b8d4455c96d9c0c66f3755db -#: ../src/Doc/library/al.rst:76 +#: library/al.rst:76 msgid "" "Configuration objects returned by :func:`newconfig` have the following " "methods:" msgstr "" # 0cfe305344d8405f8a8e717466d5e0cf -#: ../src/Doc/library/al.rst:81 +#: library/al.rst:81 msgid "Return the queue size." msgstr "" # 30b245c77fd74568af1b06b3eb248b9d -#: ../src/Doc/library/al.rst:86 +#: library/al.rst:86 msgid "Set the queue size." msgstr "" # 6e97e7b1c40b4cc08bd585bee7714ef6 -#: ../src/Doc/library/al.rst:91 +#: library/al.rst:91 msgid "Get the sample width." msgstr "" # 426511aec4a643258877a916aaff4cfa -#: ../src/Doc/library/al.rst:96 +#: library/al.rst:96 msgid "Set the sample width." msgstr "" # b1f159cc8c934ee4951af86393586d31 -#: ../src/Doc/library/al.rst:101 +#: library/al.rst:101 msgid "Get the channel count." msgstr "" # f075c3a7027e4a7b85fd3b428d7bb82e -#: ../src/Doc/library/al.rst:106 +#: library/al.rst:106 msgid "Set the channel count." msgstr "" # 5f2bc66e56fe4c93b600ab848b0f50b7 -#: ../src/Doc/library/al.rst:111 +#: library/al.rst:111 msgid "Get the sample format." msgstr "" # 50639f1a35a64c7184b75e0526f1e4c4 -#: ../src/Doc/library/al.rst:116 +#: library/al.rst:116 msgid "Set the sample format." msgstr "" # 5f28165a437f48bb8f376e87d5fa09bf -#: ../src/Doc/library/al.rst:121 +#: library/al.rst:121 msgid "Get the maximum value for floating sample formats." msgstr "" # d0eec08a22df4ea8b5ca607b99228582 -#: ../src/Doc/library/al.rst:126 +#: library/al.rst:126 msgid "Set the maximum value for floating sample formats." msgstr "" # 6fb9b4f8a16d4f4aafa927efaf1f02b1 -#: ../src/Doc/library/al.rst:132 +#: library/al.rst:132 msgid "Port Objects" msgstr "" # 06d8dbcb69cd473fa818afebabc5aacd -#: ../src/Doc/library/al.rst:134 +#: library/al.rst:134 msgid "" "Port objects, as returned by :func:`openport`, have the following methods:" msgstr "" # fb8e3f6468884f599e5a1989bc6d3911 -#: ../src/Doc/library/al.rst:139 +#: library/al.rst:139 msgid "Close the port." msgstr "" # ce3408f64e804441895e6dbfadc3faf4 -#: ../src/Doc/library/al.rst:144 +#: library/al.rst:144 msgid "Return the file descriptor as an int." msgstr "" # 832b256668c54eb589d4df400672e984 -#: ../src/Doc/library/al.rst:149 +#: library/al.rst:149 msgid "Return the number of filled samples." msgstr "" # 92da33f8693e46a28f9698750b06157b -#: ../src/Doc/library/al.rst:154 +#: library/al.rst:154 msgid "Return the number of fillable samples." msgstr "" # 1d2f9e2c5b2844de97b8e990dcf528e8 -#: ../src/Doc/library/al.rst:159 +#: library/al.rst:159 msgid "" "Read a number of samples from the queue, blocking if necessary. Return the " "data as a string containing the raw data, (e.g., 2 bytes per sample in big-" @@ -2875,46 +2852,50 @@ msgid "" msgstr "" # a2e6019e40b549d6abb1756c84cbc6a0 -#: ../src/Doc/library/al.rst:166 +#: library/al.rst:166 msgid "" "Write samples into the queue, blocking if necessary. The samples are " "encoded as described for the :meth:`readsamps` return value." msgstr "" # 053c123e95d04f1f90c2620204314425 -#: ../src/Doc/library/al.rst:172 +#: library/al.rst:172 msgid "Return the 'fill point'." msgstr "" # de91cfb6f40f4bd3953fdb3a514738de -#: ../src/Doc/library/al.rst:177 +#: library/al.rst:177 msgid "Set the 'fill point'." msgstr "" # 22e032bafd1a43b1b912f306b9959121 -#: ../src/Doc/library/al.rst:182 +#: library/al.rst:182 msgid "" "Return a configuration object containing the current configuration of the " "port." msgstr "" # 9c3dcb1ea7e2408fa43ee9d3183711f9 -#: ../src/Doc/library/al.rst:187 +#: library/al.rst:187 msgid "Set the configuration from the argument, a configuration object." msgstr "" # 42e05c65eaee46b4a3a0b8cd19b65b87 -#: ../src/Doc/library/al.rst:192 +#: library/al.rst:192 msgid "Get status information on last error." msgstr "" # 32c6f9f81360426cb9e2da8ed6526762 -#: ../src/Doc/library/al.rst:196 +#: library/al.rst:196 msgid ":mod:`AL` --- Constants used with the :mod:`al` module" msgstr "" +#: library/al.rst:203 +msgid "The :mod:`AL` module has been removed in Python 3." +msgstr "" + # b5adbd5fb3ea47b2a277656bb5183fdb -#: ../src/Doc/library/al.rst:207 +#: library/al.rst:207 msgid "" "This module defines symbolic constants needed to use the built-in module :" "mod:`al` (see above); they are equivalent to those defined in the C header " @@ -2922,11 +2903,11 @@ msgid "" "module source for a complete list of the defined names. Suggested use::" msgstr "" -#: ../src/Doc/library/allos.rst:6 +#: library/allos.rst:6 msgid "Generic Operating System Services" msgstr "" -#: ../src/Doc/library/allos.rst:8 +#: library/allos.rst:8 msgid "" "The modules described in this chapter provide interfaces to operating system " "features that are available on (almost) all operating systems, such as files " @@ -2936,12 +2917,12 @@ msgid "" msgstr "" # cf8075d3e7e14f00a65f421f17b771b5 -#: ../src/Doc/library/anydbm.rst:2 +#: library/anydbm.rst:2 msgid ":mod:`anydbm` --- Generic access to DBM-style databases" msgstr "" # ddbe5fe53a4243a68a4bd0372c44d32b -#: ../src/Doc/library/anydbm.rst:9 +#: library/anydbm.rst:9 msgid "" "The :mod:`anydbm` module has been renamed to :mod:`dbm` in Python 3. The :" "term:`2to3` tool will automatically adapt imports when converting your " @@ -2949,7 +2930,7 @@ msgid "" msgstr "" # 24ab39087a024d02b3b214a050596832 -#: ../src/Doc/library/anydbm.rst:20 +#: library/anydbm.rst:20 msgid "" ":mod:`anydbm` is a generic interface to variants of the DBM database --- :" "mod:`dbhash` (requires :mod:`bsddb`), :mod:`gdbm`, or :mod:`dbm`. If none " @@ -2957,91 +2938,82 @@ msgid "" "mod:`dumbdbm` will be used." msgstr "" -#: ../src/Doc/library/anydbm.rst:28 +#: library/anydbm.rst:28 msgid "Open the database file *filename* and return a corresponding object." msgstr "" # 0b6205aa180b424daa39706ff12412f5 -#: ../src/Doc/library/anydbm.rst:30 +#: library/anydbm.rst:30 msgid "" "If the database file already exists, the :mod:`whichdb` module is used to " "determine its type and the appropriate module is used; if it does not exist, " "the first module listed above that can be imported is used." msgstr "" -#: ../src/Doc/library/anydbm.rst:34 ../src/Doc/library/dbm.rst:45 +#: library/anydbm.rst:34 library/dbm.rst:45 msgid "The optional *flag* argument must be one of these values:" msgstr "" -#: ../src/Doc/library/anydbm.rst:37 ../src/Doc/library/cd.rst:284 -#: ../src/Doc/library/codecs.rst:351 ../src/Doc/library/compiler.rst:218 -#: ../src/Doc/library/datetime.rst:205 ../src/Doc/library/dbhash.rst:35 -#: ../src/Doc/library/dbm.rst:48 ../src/Doc/library/difflib.rst:467 -#: ../src/Doc/library/gdbm.rst:42 ../src/Doc/library/gdbm.rst:61 -#: ../src/Doc/library/httplib.rst:211 ../src/Doc/library/imghdr.rst:27 -#: ../src/Doc/library/locale.rst:130 -#: ../src/Doc/library/logging.handlers.rst:233 -#: ../src/Doc/library/urlparse.rst:94 ../src/Doc/library/urlparse.rst:198 -#: ../src/Doc/library/warnings.rst:123 ../src/Doc/library/zipfile.rst:404 +#: library/anydbm.rst:37 library/cd.rst:284 library/codecs.rst:351 +#: library/compiler.rst:218 library/datetime.rst:205 library/dbhash.rst:35 +#: library/dbm.rst:48 library/difflib.rst:467 library/gdbm.rst:42 +#: library/gdbm.rst:61 library/httplib.rst:227 library/imghdr.rst:27 +#: library/locale.rst:130 library/logging.handlers.rst:234 +#: library/urlparse.rst:94 library/urlparse.rst:198 library/warnings.rst:123 +#: library/zipfile.rst:406 msgid "Value" msgstr "" -#: ../src/Doc/library/anydbm.rst:39 ../src/Doc/library/dbhash.rst:37 -#: ../src/Doc/library/dbm.rst:50 ../src/Doc/library/gdbm.rst:44 -#: ../src/Doc/library/io.rst:89 ../src/Doc/library/stdtypes.rst:1475 -#: ../src/Doc/library/sunau.rst:49 +#: library/anydbm.rst:39 library/dbhash.rst:37 library/dbm.rst:50 +#: library/gdbm.rst:44 library/io.rst:89 library/stdtypes.rst:1478 msgid "``'r'``" msgstr "" -#: ../src/Doc/library/anydbm.rst:39 ../src/Doc/library/dbhash.rst:37 -#: ../src/Doc/library/dbm.rst:50 ../src/Doc/library/gdbm.rst:44 +#: library/anydbm.rst:39 library/dbhash.rst:37 library/dbm.rst:50 +#: library/gdbm.rst:44 msgid "Open existing database for reading only (default)" msgstr "" -#: ../src/Doc/library/anydbm.rst:42 ../src/Doc/library/dbhash.rst:40 -#: ../src/Doc/library/dbm.rst:53 ../src/Doc/library/gdbm.rst:47 -#: ../src/Doc/library/io.rst:90 ../src/Doc/library/sunau.rst:52 +#: library/anydbm.rst:42 library/dbhash.rst:40 library/dbm.rst:53 +#: library/gdbm.rst:47 library/io.rst:90 msgid "``'w'``" msgstr "" -#: ../src/Doc/library/anydbm.rst:42 ../src/Doc/library/dbhash.rst:40 -#: ../src/Doc/library/dbm.rst:53 ../src/Doc/library/gdbm.rst:47 +#: library/anydbm.rst:42 library/dbhash.rst:40 library/dbm.rst:53 +#: library/gdbm.rst:47 msgid "Open existing database for reading and writing" msgstr "" -#: ../src/Doc/library/anydbm.rst:45 ../src/Doc/library/array.rst:21 -#: ../src/Doc/library/dbhash.rst:43 ../src/Doc/library/dbm.rst:56 -#: ../src/Doc/library/gdbm.rst:50 ../src/Doc/library/stdtypes.rst:1472 -#: ../src/Doc/library/string.rst:424 +#: library/anydbm.rst:45 library/array.rst:21 library/dbhash.rst:43 +#: library/dbm.rst:56 library/gdbm.rst:50 library/stdtypes.rst:1475 +#: library/string.rst:424 msgid "``'c'``" msgstr "" -#: ../src/Doc/library/anydbm.rst:45 ../src/Doc/library/dbhash.rst:43 -#: ../src/Doc/library/dbm.rst:56 ../src/Doc/library/gdbm.rst:50 +#: library/anydbm.rst:45 library/dbhash.rst:43 library/dbm.rst:56 +#: library/gdbm.rst:50 msgid "Open database for reading and writing, creating it if it doesn't exist" msgstr "" -#: ../src/Doc/library/anydbm.rst:48 ../src/Doc/library/dbhash.rst:46 -#: ../src/Doc/library/dbm.rst:59 ../src/Doc/library/gdbm.rst:53 -#: ../src/Doc/library/string.rst:437 ../src/Doc/library/string.rst:494 +#: library/anydbm.rst:48 library/dbhash.rst:46 library/dbm.rst:59 +#: library/gdbm.rst:53 library/string.rst:437 library/string.rst:494 msgid "``'n'``" msgstr "" -#: ../src/Doc/library/anydbm.rst:48 ../src/Doc/library/dbhash.rst:46 -#: ../src/Doc/library/dbm.rst:59 ../src/Doc/library/gdbm.rst:53 +#: library/anydbm.rst:48 library/dbhash.rst:46 library/dbm.rst:59 +#: library/gdbm.rst:53 msgid "Always create a new, empty database, open for reading and writing" msgstr "" # bf583296b223437fb3cb5bd9d74dd85f -#: ../src/Doc/library/anydbm.rst:52 +#: library/anydbm.rst:52 msgid "If not specified, the default value is ``'r'``." msgstr "" # bcaa1bfa73c146fab16fac86afe703c8 # a2b9c5913de74141948439a34605cf6c # ea4a0f0842d84933a5729df904417615 -#: ../src/Doc/library/anydbm.rst:54 ../src/Doc/library/dbm.rst:63 -#: ../src/Doc/library/dumbdbm.rst:45 +#: library/anydbm.rst:54 library/dbm.rst:63 library/dumbdbm.rst:45 msgid "" "The optional *mode* argument is the Unix mode of the file, used only when " "the database has to be created. It defaults to octal ``0666`` (and will be " @@ -3049,7 +3021,7 @@ msgid "" msgstr "" # 4281efdbfe11425d87b84ad1d7b3ef89 -#: ../src/Doc/library/anydbm.rst:61 +#: library/anydbm.rst:61 msgid "" "A tuple containing the exceptions that can be raised by each of the " "supported modules, with a unique exception also named :exc:`anydbm.error` as " @@ -3057,7 +3029,7 @@ msgid "" msgstr "" # cbfbef40938640bf9050de1ab76d0a13 -#: ../src/Doc/library/anydbm.rst:65 +#: library/anydbm.rst:65 msgid "" "The object returned by :func:`.open` supports most of the same functionality " "as dictionaries; keys and their corresponding values can be stored, " @@ -3065,102 +3037,82 @@ msgid "" "available. Keys and values must always be strings." msgstr "" -#: ../src/Doc/library/anydbm.rst:70 +#: library/anydbm.rst:70 msgid "" "The following example records some hostnames and a corresponding title, and " "then prints out the contents of the database::" msgstr "" # d20c4d005201454d99ec21ee3784f7eb -#: ../src/Doc/library/anydbm.rst:95 +#: library/anydbm.rst:95 msgid "" "In addition to the dictionary-like methods, ``anydbm`` objects provide the " "following method:" msgstr "" # 60dcf8b814a7425982668bbb834cfbb6 -#: ../src/Doc/library/anydbm.rst:100 +#: library/anydbm.rst:100 msgid "Close the ``anydbm`` database." msgstr "" -# 12451a48fa284b64804f1ff66b69563d -# c447a66403044b86872debfafd92f011 -# 8917aa56daf44217946aa4baff2b72bb -#: ../src/Doc/library/anydbm.rst:105 ../src/Doc/library/bsddb.rst:93 -#: ../src/Doc/library/shelve.rst:191 -msgid "Module :mod:`dbhash`" -msgstr "" +#: library/anydbm.rst:106 library/bsddb.rst:94 library/shelve.rst:192 +#, fuzzy +msgid "Module dbhash" +msgstr "Modules" # 15916ff708a94b2e8df5a98d7295bd3b # 3c6d07cc5493457f8537d4c2a2dc79e5 -#: ../src/Doc/library/anydbm.rst:106 ../src/Doc/library/shelve.rst:188 +#: library/anydbm.rst:106 library/shelve.rst:188 msgid "BSD ``db`` database interface." msgstr "" -# f2e56e251ca64b92a08b0fef79ec736b -# 765d1c2c4b3a4691aaf616f1782b026b -# 8034bb946e62493fb00c7d020d6ed9a7 -#: ../src/Doc/library/anydbm.rst:108 ../src/Doc/library/dumbdbm.rst:66 -#: ../src/Doc/library/shelve.rst:194 -msgid "Module :mod:`dbm`" -msgstr "" +#: library/anydbm.rst:109 library/dumbdbm.rst:67 library/shelve.rst:195 +#, fuzzy +msgid "Module dbm" +msgstr "Modules" # ccd61fedd25b4d7a9481cd2aefd323b9 # 68de2922536d44a39b44cbe7c83a2479 -#: ../src/Doc/library/anydbm.rst:109 ../src/Doc/library/shelve.rst:195 +#: library/anydbm.rst:109 library/shelve.rst:195 msgid "Standard Unix database interface." msgstr "" -# 56666d3f454541dc84379523cc48b640 -# f500f01d00174bac97bc092307b273c3 -#: ../src/Doc/library/anydbm.rst:111 ../src/Doc/library/shelve.rst:197 -msgid "Module :mod:`dumbdbm`" +#: library/anydbm.rst:112 library/shelve.rst:198 +msgid "Module dumbdbm" msgstr "" # 18d79497b92640648b6d2ce3dd12d1b2 # 24a950f947ec4a7babef0678da87d33b -#: ../src/Doc/library/anydbm.rst:112 ../src/Doc/library/shelve.rst:198 +#: library/anydbm.rst:112 library/shelve.rst:198 msgid "Portable implementation of the ``dbm`` interface." msgstr "" -# 0dc765910985486cb47c974516bda67e -# 06f4a116c9d5457a95f7c04a2ac03ba5 -# 05cf0143bf76476bb4da98e9386be156 -# f39033f7d57a4d7d84bd7e385ed2b719 -#: ../src/Doc/library/anydbm.rst:114 ../src/Doc/library/dbm.rst:81 -#: ../src/Doc/library/dumbdbm.rst:69 ../src/Doc/library/shelve.rst:200 -msgid "Module :mod:`gdbm`" -msgstr "" +#: library/anydbm.rst:115 library/dbm.rst:82 library/dumbdbm.rst:70 +#: library/shelve.rst:201 +#, fuzzy +msgid "Module gdbm" +msgstr "Modules" # 2834c65f796d4d648e1ca38296e52eab # bb4b5e58ca4b46bab752e747d88c32fa -#: ../src/Doc/library/anydbm.rst:115 ../src/Doc/library/shelve.rst:201 +#: library/anydbm.rst:115 library/shelve.rst:201 msgid "GNU database interface, based on the ``dbm`` interface." msgstr "" -# 7abda108b59341e9a8c481d5a2f9e8d8 -# 0139af5a38a74595abffe485eda3913c -# 23d34fdccec0409b9f05759b2b5371b9 -#: ../src/Doc/library/anydbm.rst:117 ../src/Doc/library/dumbdbm.rst:72 -#: ../src/Doc/library/pickle.rst:804 -msgid "Module :mod:`shelve`" -msgstr "" +#: library/anydbm.rst:118 library/dumbdbm.rst:73 library/pickle.rst:805 +#, fuzzy +msgid "Module shelve" +msgstr "Modules" # 33556ca163b048ff8648bff21a0f9fe7 -#: ../src/Doc/library/anydbm.rst:118 +#: library/anydbm.rst:118 msgid "" "General object persistence built on top of the Python ``dbm`` interface." msgstr "" -# 2989a02ca33a4eea96cb13c42c172020 -# 63565d6e58bc4808b608d58829ab880e -# 85fa311284354285878753601586c2a6 -# 97c9ebaa9d044b129a67ce249d628680 -# fcaeefa2a18d41048388f4706f6af9d5 -#: ../src/Doc/library/anydbm.rst:119 ../src/Doc/library/dbhash.rst:65 -#: ../src/Doc/library/dbm.rst:83 ../src/Doc/library/dumbdbm.rst:74 -#: ../src/Doc/library/gdbm.rst:128 -msgid "Module :mod:`whichdb`" +#: library/anydbm.rst:120 library/dbhash.rst:66 library/dbm.rst:84 +#: library/dumbdbm.rst:75 library/gdbm.rst:129 +msgid "Module whichdb" msgstr "" # c36ad71cab1e4030966f64039c3094bb @@ -3168,18 +3120,17 @@ msgstr "" # 122cd58770684517b03362fdd039bee2 # 31fa804b3d9f4fe3a3247bd705f6b95c # a734549a530741ba8c76005171d262c5 -#: ../src/Doc/library/anydbm.rst:121 ../src/Doc/library/dbhash.rst:67 -#: ../src/Doc/library/dbm.rst:85 ../src/Doc/library/dumbdbm.rst:76 -#: ../src/Doc/library/gdbm.rst:130 +#: library/anydbm.rst:121 library/dbhash.rst:67 library/dbm.rst:85 +#: library/dumbdbm.rst:76 library/gdbm.rst:130 msgid "Utility module used to determine the type of an existing database." msgstr "" -#: ../src/Doc/library/archiving.rst:6 +#: library/archiving.rst:6 msgid "Data Compression and Archiving" msgstr "" # 365ae31539ee448cbe43b3fc9a10b725 -#: ../src/Doc/library/archiving.rst:8 +#: library/archiving.rst:8 msgid "" "The modules described in this chapter support data compression with the " "zlib, gzip, and bzip2 algorithms, and the creation of ZIP- and tar-format " @@ -3188,19 +3139,24 @@ msgid "" msgstr "" # 62abe44f26674621af6274aa7ba6317b -#: ../src/Doc/library/argparse.rst:2 +#: library/argparse.rst:2 msgid "" ":mod:`argparse` --- Parser for command-line options, arguments and sub-" "commands" msgstr "" # 35a445d62e35495686be3190dfee8a0f -#: ../src/Doc/library/argparse.rst:11 +#: library/argparse.rst:11 msgid "**Source code:** :source:`Lib/argparse.py`" msgstr "" +#: library/argparse.rst:0 library/optparse.rst:247 +#: library/xml.etree.elementtree.rst:58 +msgid "Tutorial" +msgstr "Tutoriel [fr]" + # 999ef6e3446b4715ba8970d34f1ac3f3 -#: ../src/Doc/library/argparse.rst:17 +#: library/argparse.rst:17 msgid "" "This page contains the API reference information. For a more gentle " "introduction to Python command-line parsing, have a look at the :ref:" @@ -3208,7 +3164,7 @@ msgid "" msgstr "" # a366450aa69f4e7587be555de21329e7 -#: ../src/Doc/library/argparse.rst:21 +#: library/argparse.rst:21 msgid "" "The :mod:`argparse` module makes it easy to write user-friendly command-line " "interfaces. The program defines what arguments it requires, and :mod:" @@ -3217,67 +3173,64 @@ msgid "" "and issues errors when users give the program invalid arguments." msgstr "" -#: ../src/Doc/library/argparse.rst:29 ../src/Doc/library/cookie.rst:238 -#: ../src/Doc/library/copy_reg.rst:47 ../src/Doc/library/datetime.rst:1618 -#: ../src/Doc/library/fpectl.rst:73 ../src/Doc/library/itertools.rst:39 -#: ../src/Doc/library/itertools.rst:49 ../src/Doc/library/pickle.rst:696 -#: ../src/Doc/library/pyexpat.rst:550 ../src/Doc/library/readline.rst:204 -#: ../src/Doc/library/sets.rst:193 ../src/Doc/library/shelve.rst:147 -#: ../src/Doc/library/signal.rst:249 ../src/Doc/library/socket.rst:863 -#: ../src/Doc/library/termios.rst:84 ../src/Doc/library/tkinter.rst:438 -#: ../src/Doc/library/uuid.rst:222 ../src/Doc/library/weakref.rst:329 -#: ../src/Doc/library/xml.etree.elementtree.rst:286 +#: library/argparse.rst:29 library/cookie.rst:238 library/copy_reg.rst:47 +#: library/datetime.rst:1618 library/fpectl.rst:73 library/itertools.rst:39 +#: library/itertools.rst:49 library/pickle.rst:696 library/pyexpat.rst:550 +#: library/readline.rst:204 library/sets.rst:193 library/shelve.rst:147 +#: library/signal.rst:249 library/socket.rst:863 library/termios.rst:84 +#: library/tkinter.rst:438 library/uuid.rst:222 library/weakref.rst:329 +#: library/xml.etree.elementtree.rst:353 msgid "Example" msgstr "" -#: ../src/Doc/library/argparse.rst:31 +#: library/argparse.rst:31 msgid "" "The following code is a Python program that takes a list of integers and " "produces either the sum or the max::" msgstr "" -#: ../src/Doc/library/argparse.rst:46 +#: library/argparse.rst:46 msgid "" "Assuming the Python code above is saved into a file called ``prog.py``, it " "can be run at the command line and provides useful help messages::" msgstr "" -#: ../src/Doc/library/argparse.rst:61 +#: library/argparse.rst:61 msgid "" "When run with the appropriate arguments, it prints either the sum or the max " "of the command-line integers::" msgstr "" -#: ../src/Doc/library/argparse.rst:70 +#: library/argparse.rst:70 msgid "If invalid arguments are passed in, it will issue an error::" msgstr "" -#: ../src/Doc/library/argparse.rst:76 +#: library/argparse.rst:76 msgid "The following sections walk you through this example." msgstr "" -#: ../src/Doc/library/argparse.rst:80 +#: library/argparse.rst:80 msgid "Creating a parser" msgstr "" -#: ../src/Doc/library/argparse.rst:82 +#: library/argparse.rst:82 msgid "" "The first step in using the :mod:`argparse` is creating an :class:" "`ArgumentParser` object::" msgstr "" # f25d9a613b2f414bac837f1f2c19f713 -#: ../src/Doc/library/argparse.rst:87 +#: library/argparse.rst:87 msgid "" "The :class:`ArgumentParser` object will hold all the information necessary " "to parse the command line into Python data types." msgstr "" -#: ../src/Doc/library/argparse.rst:92 +#: library/argparse.rst:92 msgid "Adding arguments" msgstr "" -#: ../src/Doc/library/argparse.rst:94 +#: library/argparse.rst:94 msgid "" "Filling an :class:`ArgumentParser` with information about program arguments " "is done by making calls to the :meth:`~ArgumentParser.add_argument` method. " @@ -3288,7 +3241,7 @@ msgid "" msgstr "" # bed5e51283e14c8cbc32ddc1e8a28684 -#: ../src/Doc/library/argparse.rst:106 +#: library/argparse.rst:106 msgid "" "Later, calling :meth:`~ArgumentParser.parse_args` will return an object with " "two attributes, ``integers`` and ``accumulate``. The ``integers`` attribute " @@ -3297,12 +3250,12 @@ msgid "" "line, or the :func:`max` function if it was not." msgstr "" -#: ../src/Doc/library/argparse.rst:114 ../src/Doc/library/optparse.rst:1317 +#: library/argparse.rst:114 library/optparse.rst:1317 msgid "Parsing arguments" msgstr "Analyse des arguments" # e20c7b36d0f449168e00cd47b5f19309 -#: ../src/Doc/library/argparse.rst:116 +#: library/argparse.rst:116 msgid "" ":class:`ArgumentParser` parses arguments through the :meth:`~ArgumentParser." "parse_args` method. This will inspect the command line, convert each " @@ -3312,19 +3265,19 @@ msgid "" msgstr "" # 5baeb47907154f1c815135d0af42d793 -#: ../src/Doc/library/argparse.rst:125 +#: library/argparse.rst:125 msgid "" "In a script, :meth:`~ArgumentParser.parse_args` will typically be called " "with no arguments, and the :class:`ArgumentParser` will automatically " "determine the command-line arguments from :data:`sys.argv`." msgstr "" -#: ../src/Doc/library/argparse.rst:131 +#: library/argparse.rst:131 msgid "ArgumentParser objects" msgstr "" # 1181a3480e0d4606878d3b517ba46de9 -#: ../src/Doc/library/argparse.rst:140 +#: library/argparse.rst:140 msgid "" "Create a new :class:`ArgumentParser` object. All parameters should be passed " "as keyword arguments. Each parameter has its own more detailed description " @@ -3332,81 +3285,81 @@ msgid "" msgstr "" # 08cfa445663747f99667c07379739fe9 -#: ../src/Doc/library/argparse.rst:144 +#: library/argparse.rst:144 msgid "prog_ - The name of the program (default: ``sys.argv[0]``)" msgstr "" # 93f8ebf93aee485fbc105d1f98c07e38 -#: ../src/Doc/library/argparse.rst:146 +#: library/argparse.rst:146 msgid "" "usage_ - The string describing the program usage (default: generated from " "arguments added to parser)" msgstr "" # b21324be5edb4ffba8bb140b5eca943b -#: ../src/Doc/library/argparse.rst:149 +#: library/argparse.rst:149 msgid "description_ - Text to display before the argument help (default: none)" msgstr "" # 2047ea9da351435e922fbbcce7a6a93b -#: ../src/Doc/library/argparse.rst:151 +#: library/argparse.rst:151 msgid "epilog_ - Text to display after the argument help (default: none)" msgstr "" # 2fe4a15095184bc981f94bbee2ec1cfb -#: ../src/Doc/library/argparse.rst:153 +#: library/argparse.rst:153 msgid "" "parents_ - A list of :class:`ArgumentParser` objects whose arguments should " "also be included" msgstr "" # ae3300f31c684f909ab14e8f6922af40 -#: ../src/Doc/library/argparse.rst:156 +#: library/argparse.rst:156 msgid "formatter_class_ - A class for customizing the help output" msgstr "" # ed26c6a30e2f42579cfe3f6d6bc6b7bf -#: ../src/Doc/library/argparse.rst:158 +#: library/argparse.rst:158 msgid "" "prefix_chars_ - The set of characters that prefix optional arguments " "(default: '-')" msgstr "" # e6bcb80f00a947c9a28d934012da35a6 -#: ../src/Doc/library/argparse.rst:161 +#: library/argparse.rst:161 msgid "" "fromfile_prefix_chars_ - The set of characters that prefix files from which " "additional arguments should be read (default: ``None``)" msgstr "" # 3065f64f749a443786d9a6b94963ad3d -#: ../src/Doc/library/argparse.rst:164 +#: library/argparse.rst:164 msgid "" "argument_default_ - The global default value for arguments (default: " "``None``)" msgstr "" # db91cb0e64864466820596e7e0abfa40 -#: ../src/Doc/library/argparse.rst:167 +#: library/argparse.rst:167 msgid "" "conflict_handler_ - The strategy for resolving conflicting optionals " "(usually unnecessary)" msgstr "" # ee6f468cfc704776bdb7f85952dd6a00 -#: ../src/Doc/library/argparse.rst:170 +#: library/argparse.rst:170 msgid "add_help_ - Add a -h/--help option to the parser (default: ``True``)" msgstr "" -#: ../src/Doc/library/argparse.rst:172 ../src/Doc/library/argparse.rst:625 +#: library/argparse.rst:172 library/argparse.rst:625 msgid "The following sections describe how each of these are used." msgstr "" -#: ../src/Doc/library/argparse.rst:176 +#: library/argparse.rst:176 library/optparse.rst:850 msgid "prog" msgstr "" -#: ../src/Doc/library/argparse.rst:178 +#: library/argparse.rst:178 msgid "" "By default, :class:`ArgumentParser` objects uses ``sys.argv[0]`` to " "determine how to display the name of the program in help messages. This " @@ -3415,57 +3368,55 @@ msgid "" "consider a file named ``myprogram.py`` with the following code::" msgstr "" -#: ../src/Doc/library/argparse.rst:189 +#: library/argparse.rst:189 msgid "" "The help for this program will display ``myprogram.py`` as the program name " "(regardless of where the program was invoked from)::" msgstr "" -#: ../src/Doc/library/argparse.rst:206 +#: library/argparse.rst:206 msgid "" "To change this default behavior, another value can be supplied using the " "``prog=`` argument to :class:`ArgumentParser`::" msgstr "" -#: ../src/Doc/library/argparse.rst:216 +#: library/argparse.rst:216 msgid "" "Note that the program name, whether determined from ``sys.argv[0]`` or from " "the ``prog=`` argument, is available to help messages using the ``%(prog)s`` " "format specifier." msgstr "" -#: ../src/Doc/library/argparse.rst:233 +#: library/argparse.rst:233 msgid "usage" msgstr "" -#: ../src/Doc/library/argparse.rst:235 +#: library/argparse.rst:235 msgid "" "By default, :class:`ArgumentParser` calculates the usage message from the " "arguments it contains::" msgstr "" -#: ../src/Doc/library/argparse.rst:251 +#: library/argparse.rst:251 msgid "" "The default message can be overridden with the ``usage=`` keyword argument::" msgstr "" -#: ../src/Doc/library/argparse.rst:266 +#: library/argparse.rst:266 msgid "" "The ``%(prog)s`` format specifier is available to fill in the program name " "in your usage messages." msgstr "" -#: ../src/Doc/library/argparse.rst:271 ../src/Doc/library/ttk.rst:139 -#: ../src/Doc/library/ttk.rst:167 ../src/Doc/library/ttk.rst:208 -#: ../src/Doc/library/ttk.rst:222 ../src/Doc/library/ttk.rst:307 -#: ../src/Doc/library/ttk.rst:387 ../src/Doc/library/ttk.rst:411 -#: ../src/Doc/library/ttk.rst:573 ../src/Doc/library/ttk.rst:642 -#: ../src/Doc/library/ttk.rst:711 ../src/Doc/library/ttk.rst:760 -#: ../src/Doc/library/ttk.rst:786 ../src/Doc/library/ttk.rst:829 +#: library/argparse.rst:271 library/ttk.rst:139 library/ttk.rst:167 +#: library/ttk.rst:208 library/ttk.rst:222 library/ttk.rst:307 +#: library/ttk.rst:387 library/ttk.rst:411 library/ttk.rst:573 +#: library/ttk.rst:642 library/ttk.rst:711 library/ttk.rst:760 +#: library/ttk.rst:786 library/ttk.rst:829 msgid "description" msgstr "description" -#: ../src/Doc/library/argparse.rst:273 +#: library/argparse.rst:273 msgid "" "Most calls to the :class:`ArgumentParser` constructor will use the " "``description=`` keyword argument. This argument gives a brief description " @@ -3474,35 +3425,35 @@ msgid "" "messages for the various arguments::" msgstr "" -#: ../src/Doc/library/argparse.rst:288 +#: library/argparse.rst:288 msgid "" "By default, the description will be line-wrapped so that it fits within the " "given space. To change this behavior, see the formatter_class_ argument." msgstr "" -#: ../src/Doc/library/argparse.rst:293 +#: library/argparse.rst:293 msgid "epilog" msgstr "" -#: ../src/Doc/library/argparse.rst:295 +#: library/argparse.rst:295 msgid "" "Some programs like to display additional description of the program after " "the description of the arguments. Such text can be specified using the " "``epilog=`` argument to :class:`ArgumentParser`::" msgstr "" -#: ../src/Doc/library/argparse.rst:312 +#: library/argparse.rst:312 msgid "" "As with the description_ argument, the ``epilog=`` text is by default line-" "wrapped, but this behavior can be adjusted with the formatter_class_ " "argument to :class:`ArgumentParser`." msgstr "" -#: ../src/Doc/library/argparse.rst:318 +#: library/argparse.rst:318 msgid "parents" msgstr "" -#: ../src/Doc/library/argparse.rst:320 +#: library/argparse.rst:320 msgid "" "Sometimes, several parsers share a common set of arguments. Rather than " "repeating the definitions of these arguments, a single parser with all the " @@ -3513,7 +3464,7 @@ msgid "" "object being constructed::" msgstr "" -#: ../src/Doc/library/argparse.rst:340 +#: library/argparse.rst:340 msgid "" "Note that most parent parsers will specify ``add_help=False``. Otherwise, " "the :class:`ArgumentParser` will see two ``-h/--help`` options (one in the " @@ -3521,19 +3472,19 @@ msgid "" msgstr "" # 815b4b1dec114330b64f659370978f6b -#: ../src/Doc/library/argparse.rst:345 +#: library/argparse.rst:345 msgid "" "You must fully initialize the parsers before passing them via ``parents=``. " "If you change the parent parsers after the child parser, those changes will " "not be reflected in the child." msgstr "" -#: ../src/Doc/library/argparse.rst:351 +#: library/argparse.rst:351 msgid "formatter_class" msgstr "" # 2e02c6eba9d743fb86cafc331bce6242 -#: ../src/Doc/library/argparse.rst:353 +#: library/argparse.rst:353 msgid "" ":class:`ArgumentParser` objects allow the help formatting to be customized " "by specifying an alternate formatting class. Currently, there are three " @@ -3541,21 +3492,21 @@ msgid "" msgstr "" # a7c65dc821ba4cf0a7d02caf2bca0394 -#: ../src/Doc/library/argparse.rst:361 +#: library/argparse.rst:361 msgid "" "The first two allow more control over how textual descriptions are " "displayed, while the last automatically adds information about argument " "default values." msgstr "" -#: ../src/Doc/library/argparse.rst:364 +#: library/argparse.rst:364 msgid "" "By default, :class:`ArgumentParser` objects line-wrap the description_ and " "epilog_ texts in command-line help messages::" msgstr "" # 7ce3d3d023b649aea2ac6a9baea77d7e -#: ../src/Doc/library/argparse.rst:387 +#: library/argparse.rst:387 msgid "" "Passing :class:`RawDescriptionHelpFormatter` as ``formatter_class=`` " "indicates that description_ and epilog_ are already correctly formatted and " @@ -3563,24 +3514,24 @@ msgid "" msgstr "" # 747df4e48572491db699b8b0a4f6afcf -#: ../src/Doc/library/argparse.rst:413 +#: library/argparse.rst:413 msgid "" ":class:`RawTextHelpFormatter` maintains whitespace for all sorts of help " "text, including argument descriptions." msgstr "" -#: ../src/Doc/library/argparse.rst:416 +#: library/argparse.rst:416 msgid "" "The other formatter class available, :class:`ArgumentDefaultsHelpFormatter`, " "will add information about the default value of each of the arguments::" msgstr "" -#: ../src/Doc/library/argparse.rst:436 +#: library/argparse.rst:436 msgid "prefix_chars" msgstr "" # a4feffc6ced64f6aa7ad043054a1a552 -#: ../src/Doc/library/argparse.rst:438 +#: library/argparse.rst:438 msgid "" "Most command-line options will use ``-`` as the prefix, e.g. ``-f/--foo``. " "Parsers that need to support different or additional prefix characters, e.g. " @@ -3589,18 +3540,18 @@ msgid "" msgstr "" # 332364d2194945788f07784041be855d -#: ../src/Doc/library/argparse.rst:450 +#: library/argparse.rst:450 msgid "" "The ``prefix_chars=`` argument defaults to ``'-'``. Supplying a set of " "characters that does not include ``-`` will cause ``-f/--foo`` options to be " "disallowed." msgstr "" -#: ../src/Doc/library/argparse.rst:456 +#: library/argparse.rst:456 msgid "fromfile_prefix_chars" msgstr "" -#: ../src/Doc/library/argparse.rst:458 +#: library/argparse.rst:458 msgid "" "Sometimes, for example when dealing with a particularly long argument lists, " "it may make sense to keep the list of arguments in a file rather than typing " @@ -3611,7 +3562,7 @@ msgid "" msgstr "" # 22464b9f88bd44f79bbd2d2f35211d2d -#: ../src/Doc/library/argparse.rst:472 +#: library/argparse.rst:472 msgid "" "Arguments read from a file must by default be one per line (but see also :" "meth:`~ArgumentParser.convert_arg_line_to_args`) and are treated as if they " @@ -3621,18 +3572,18 @@ msgid "" "f', 'bar']``." msgstr "" -#: ../src/Doc/library/argparse.rst:478 +#: library/argparse.rst:478 msgid "" "The ``fromfile_prefix_chars=`` argument defaults to ``None``, meaning that " "arguments will never be treated as file references." msgstr "" -#: ../src/Doc/library/argparse.rst:483 +#: library/argparse.rst:483 msgid "argument_default" msgstr "" # 226993bdce2a4286b0b2e0e873e9cc2e -#: ../src/Doc/library/argparse.rst:485 +#: library/argparse.rst:485 msgid "" "Generally, argument defaults are specified either by passing a default to :" "meth:`~ArgumentParser.add_argument` or by calling the :meth:`~ArgumentParser." @@ -3644,11 +3595,11 @@ msgid "" "supply ``argument_default=SUPPRESS``::" msgstr "" -#: ../src/Doc/library/argparse.rst:504 +#: library/argparse.rst:504 msgid "conflict_handler" msgstr "" -#: ../src/Doc/library/argparse.rst:506 +#: library/argparse.rst:506 msgid "" ":class:`ArgumentParser` objects do not allow two actions with the same " "option string. By default, :class:`ArgumentParser` objects raises an " @@ -3656,7 +3607,7 @@ msgid "" "that is already in use::" msgstr "" -#: ../src/Doc/library/argparse.rst:518 +#: library/argparse.rst:518 msgid "" "Sometimes (e.g. when using parents_) it may be useful to simply override any " "older arguments with the same option string. To get this behavior, the " @@ -3664,7 +3615,7 @@ msgid "" "of :class:`ArgumentParser`::" msgstr "" -#: ../src/Doc/library/argparse.rst:534 +#: library/argparse.rst:534 msgid "" "Note that :class:`ArgumentParser` objects only remove an action if all of " "its option strings are overridden. So, in the example above, the old ``-f/--" @@ -3672,12 +3623,12 @@ msgid "" "option string was overridden." msgstr "" -#: ../src/Doc/library/argparse.rst:541 +#: library/argparse.rst:541 msgid "add_help" msgstr "" # ab703712b0c9447cb0ff2db179008338 -#: ../src/Doc/library/argparse.rst:543 +#: library/argparse.rst:543 msgid "" "By default, ArgumentParser objects add an option which simply displays the " "parser's help message. For example, consider a file named ``myprogram.py`` " @@ -3685,13 +3636,13 @@ msgid "" msgstr "" # afc3bc107a654bcd9215ad6a1e864f9a -#: ../src/Doc/library/argparse.rst:552 +#: library/argparse.rst:552 msgid "" "If ``-h`` or ``--help`` is supplied at the command line, the ArgumentParser " "help will be printed::" msgstr "" -#: ../src/Doc/library/argparse.rst:562 +#: library/argparse.rst:562 msgid "" "Occasionally, it may be useful to disable the addition of this help option. " "This can be achieved by passing ``False`` as the ``add_help=`` argument to :" @@ -3699,7 +3650,7 @@ msgid "" msgstr "" # c1f24d6f815c4e78bbf1a6052c67e6c2 -#: ../src/Doc/library/argparse.rst:574 +#: library/argparse.rst:574 msgid "" "The help option is typically ``-h/--help``. The exception to this is if the " "``prefix_chars=`` is specified and does not include ``-``, in which case ``-" @@ -3707,83 +3658,83 @@ msgid "" "in ``prefix_chars`` is used to prefix the help options::" msgstr "" -#: ../src/Doc/library/argparse.rst:589 +#: library/argparse.rst:589 msgid "The add_argument() method" msgstr "" # 0ffad72b0da74613858d995f5c245a5b -#: ../src/Doc/library/argparse.rst:595 +#: library/argparse.rst:595 msgid "" "Define how a single command-line argument should be parsed. Each parameter " "has its own more detailed description below, but in short they are:" msgstr "" # 0e6d063e31904a8894239835effc5bd7 -#: ../src/Doc/library/argparse.rst:598 +#: library/argparse.rst:598 msgid "" "`name or flags`_ - Either a name or a list of option strings, e.g. ``foo`` " "or ``-f, --foo``." msgstr "" # b9d9af2bd6624c2f9e4ca43918b09fa6 -#: ../src/Doc/library/argparse.rst:601 +#: library/argparse.rst:601 msgid "" "action_ - The basic type of action to be taken when this argument is " "encountered at the command line." msgstr "" -#: ../src/Doc/library/argparse.rst:604 +#: library/argparse.rst:604 msgid "nargs_ - The number of command-line arguments that should be consumed." msgstr "" -#: ../src/Doc/library/argparse.rst:606 +#: library/argparse.rst:606 msgid "" "const_ - A constant value required by some action_ and nargs_ selections." msgstr "" # 1ce5f078345743599fbb9a67e28402ed -#: ../src/Doc/library/argparse.rst:608 +#: library/argparse.rst:608 msgid "" "default_ - The value produced if the argument is absent from the command " "line." msgstr "" # 6d800f5683224fb4b4b9d2db0562f32a -#: ../src/Doc/library/argparse.rst:611 +#: library/argparse.rst:611 msgid "" "type_ - The type to which the command-line argument should be converted." msgstr "" -#: ../src/Doc/library/argparse.rst:613 +#: library/argparse.rst:613 msgid "choices_ - A container of the allowable values for the argument." msgstr "" -#: ../src/Doc/library/argparse.rst:615 +#: library/argparse.rst:615 msgid "" "required_ - Whether or not the command-line option may be omitted (optionals " "only)." msgstr "" -#: ../src/Doc/library/argparse.rst:618 +#: library/argparse.rst:618 msgid "help_ - A brief description of what the argument does." msgstr "" -#: ../src/Doc/library/argparse.rst:620 +#: library/argparse.rst:620 msgid "metavar_ - A name for the argument in usage messages." msgstr "" -#: ../src/Doc/library/argparse.rst:622 +#: library/argparse.rst:622 msgid "" "dest_ - The name of the attribute to be added to the object returned by :" "meth:`parse_args`." msgstr "" -#: ../src/Doc/library/argparse.rst:629 +#: library/argparse.rst:629 msgid "name or flags" msgstr "" # 5965978e3479409eb1a04e2c565a452b -#: ../src/Doc/library/argparse.rst:631 +#: library/argparse.rst:631 msgid "" "The :meth:`~ArgumentParser.add_argument` method must know whether an " "optional argument, like ``-f`` or ``--foo``, or a positional argument, like " @@ -3793,24 +3744,24 @@ msgid "" "created like::" msgstr "" -#: ../src/Doc/library/argparse.rst:640 +#: library/argparse.rst:640 msgid "while a positional argument could be created like::" msgstr "" # 71eb2383d81e4c058f1e2a3391722c22 -#: ../src/Doc/library/argparse.rst:644 +#: library/argparse.rst:644 msgid "" "When :meth:`~ArgumentParser.parse_args` is called, optional arguments will " "be identified by the ``-`` prefix, and the remaining arguments will be " "assumed to be positional::" msgstr "" -#: ../src/Doc/library/argparse.rst:661 ../src/Doc/library/tarfile.rst:51 +#: library/argparse.rst:661 library/tarfile.rst:51 msgid "action" msgstr "" # 6eadf4f9925c4ed4880ca58a44937e39 -#: ../src/Doc/library/argparse.rst:663 +#: library/argparse.rst:663 msgid "" ":class:`ArgumentParser` objects associate command-line arguments with " "actions. These actions can do just about anything with the command-line " @@ -3821,14 +3772,14 @@ msgid "" msgstr "" # d2c4f7e7fbff4baab18b8ccc77270b07 -#: ../src/Doc/library/argparse.rst:669 +#: library/argparse.rst:669 msgid "" "``'store'`` - This just stores the argument's value. This is the default " "action. For example::" msgstr "" # 9a8081dea7094e94b8cf4fa2a6c61995 -#: ../src/Doc/library/argparse.rst:677 +#: library/argparse.rst:677 msgid "" "``'store_const'`` - This stores the value specified by the const_ keyword " "argument. (Note that the const_ keyword argument defaults to the rather " @@ -3837,7 +3788,7 @@ msgid "" msgstr "" # 84ca8ebe12f647d78ae3b334015e331f -#: ../src/Doc/library/argparse.rst:687 +#: library/argparse.rst:687 msgid "" "``'store_true'`` and ``'store_false'`` - These are special cases of " "``'store_const'`` using for storing the values ``True`` and ``False`` " @@ -3845,14 +3796,14 @@ msgid "" "respectively. For example::" msgstr "" -#: ../src/Doc/library/argparse.rst:699 +#: library/argparse.rst:699 msgid "" "``'append'`` - This stores a list, and appends each argument value to the " "list. This is useful to allow an option to be specified multiple times. " "Example usage::" msgstr "" -#: ../src/Doc/library/argparse.rst:708 +#: library/argparse.rst:708 msgid "" "``'append_const'`` - This stores a list, and appends the value specified by " "the const_ keyword argument to the list. (Note that the const_ keyword " @@ -3862,14 +3813,14 @@ msgid "" msgstr "" # bd60c23bcd7c4340abcf812dcbd13d03 -#: ../src/Doc/library/argparse.rst:720 +#: library/argparse.rst:720 msgid "" "``'count'`` - This counts the number of times a keyword argument occurs. For " "example, this is useful for increasing verbosity levels::" msgstr "" # 2fb6f6beeaef41f9957dd7c8ad6daba9 -#: ../src/Doc/library/argparse.rst:728 +#: library/argparse.rst:728 msgid "" "``'help'`` - This prints a complete help message for all the options in the " "current parser and then exits. By default a help action is automatically " @@ -3878,7 +3829,7 @@ msgid "" msgstr "" # 533ea9c63e1e45d083b9563e0ee8f008 -#: ../src/Doc/library/argparse.rst:733 +#: library/argparse.rst:733 msgid "" "``'version'`` - This expects a ``version=`` keyword argument in the :meth:" "`~ArgumentParser.add_argument` call, and prints version information and " @@ -3886,7 +3837,7 @@ msgid "" msgstr "" # c9dcf05f3c184b29bedc67057371832d -#: ../src/Doc/library/argparse.rst:743 +#: library/argparse.rst:743 msgid "" "You may also specify an arbitrary action by passing an Action subclass or " "other object that implements the same interface. The recommended way to do " @@ -3894,21 +3845,21 @@ msgid "" "optionally the ``__init__`` method." msgstr "" -#: ../src/Doc/library/argparse.rst:748 +#: library/argparse.rst:748 msgid "An example of a custom action::" msgstr "" # e4f4ed06bf6d438fa5a407508d23dfd4 -#: ../src/Doc/library/argparse.rst:768 +#: library/argparse.rst:768 msgid "For more details, see :class:`Action`." msgstr "" -#: ../src/Doc/library/argparse.rst:771 +#: library/argparse.rst:771 library/optparse.rst:1598 msgid "nargs" msgstr "" # 09f2ae068424421495619b376ab31e42 -#: ../src/Doc/library/argparse.rst:773 +#: library/argparse.rst:773 msgid "" "ArgumentParser objects usually associate a single command-line argument with " "a single action to be taken. The ``nargs`` keyword argument associates a " @@ -3917,21 +3868,21 @@ msgid "" msgstr "" # cd2734aceb764a3ab918c8f9f9986166 -#: ../src/Doc/library/argparse.rst:778 +#: library/argparse.rst:778 msgid "" "``N`` (an integer). ``N`` arguments from the command line will be gathered " "together into a list. For example::" msgstr "" # f99334ef0dc94a2e9cd2c1720a1ff8a8 -#: ../src/Doc/library/argparse.rst:787 +#: library/argparse.rst:787 msgid "" "Note that ``nargs=1`` produces a list of one item. This is different from " "the default, in which the item is produced by itself." msgstr "" # c2ba77e0738c40bc94a6203973fcc576 -#: ../src/Doc/library/argparse.rst:790 +#: library/argparse.rst:790 msgid "" "``'?'``. One argument will be consumed from the command line if possible, " "and produced as a single item. If no command-line argument is present, the " @@ -3941,14 +3892,14 @@ msgid "" "produced. Some examples to illustrate this::" msgstr "" -#: ../src/Doc/library/argparse.rst:807 +#: library/argparse.rst:807 msgid "" "One of the more common uses of ``nargs='?'`` is to allow optional input and " "output files::" msgstr "" # 28ac89d72948474d8317ca1888dcd001 -#: ../src/Doc/library/argparse.rst:822 +#: library/argparse.rst:822 msgid "" "``'*'``. All command-line arguments present are gathered into a list. Note " "that it generally doesn't make much sense to have more than one positional " @@ -3957,7 +3908,7 @@ msgid "" msgstr "" # 4457a312fa364e31ab49d4d75f7eb75a -#: ../src/Doc/library/argparse.rst:834 +#: library/argparse.rst:834 msgid "" "``'+'``. Just like ``'*'``, all command-line args present are gathered into " "a list. Additionally, an error message will be generated if there wasn't at " @@ -3965,7 +3916,7 @@ msgid "" msgstr "" # 265b869305d6415c9253d4c1ed056c43 -#: ../src/Doc/library/argparse.rst:846 +#: library/argparse.rst:846 msgid "" "``argparse.REMAINDER``. All the remaining command-line arguments are " "gathered into a list. This is commonly useful for command line utilities " @@ -3973,7 +3924,7 @@ msgid "" msgstr "" # 0be3e3a30d2f4048aea81a2b640c1b05 -#: ../src/Doc/library/argparse.rst:857 +#: library/argparse.rst:857 msgid "" "If the ``nargs`` keyword argument is not provided, the number of arguments " "consumed is determined by the action_. Generally this means a single " @@ -3981,12 +3932,12 @@ msgid "" "be produced." msgstr "" -#: ../src/Doc/library/argparse.rst:863 +#: library/argparse.rst:863 msgid "const" msgstr "" # 61e36c1acc62441999f44b804679ae57 -#: ../src/Doc/library/argparse.rst:865 +#: library/argparse.rst:865 msgid "" "The ``const`` argument of :meth:`~ArgumentParser.add_argument` is used to " "hold constant values that are not read from the command line but are " @@ -3995,7 +3946,7 @@ msgid "" msgstr "" # 9c212a08935849cfbe30e9e81cf0d5e7 -#: ../src/Doc/library/argparse.rst:869 +#: library/argparse.rst:869 msgid "" "When :meth:`~ArgumentParser.add_argument` is called with " "``action='store_const'`` or ``action='append_const'``. These actions add " @@ -4004,7 +3955,7 @@ msgid "" msgstr "" # 6477fa8e948342429148585463151413 -#: ../src/Doc/library/argparse.rst:874 +#: library/argparse.rst:874 msgid "" "When :meth:`~ArgumentParser.add_argument` is called with option strings " "(like ``-f`` or ``--foo``) and ``nargs='?'``. This creates an optional " @@ -4014,16 +3965,16 @@ msgid "" "instead. See the nargs_ description for examples." msgstr "" -#: ../src/Doc/library/argparse.rst:881 +#: library/argparse.rst:881 msgid "The ``const`` keyword argument defaults to ``None``." msgstr "" -#: ../src/Doc/library/argparse.rst:885 +#: library/argparse.rst:885 msgid "default" msgstr "" # 67bf6bec77d04b35bcce1c51a03daa51 -#: ../src/Doc/library/argparse.rst:887 +#: library/argparse.rst:887 msgid "" "All optional arguments and some positional arguments may be omitted at the " "command line. The ``default`` keyword argument of :meth:`~ArgumentParser." @@ -4034,7 +3985,7 @@ msgid "" msgstr "" # 10b4ed0652cc4032aaada21c31208e29 -#: ../src/Doc/library/argparse.rst:901 +#: library/argparse.rst:901 msgid "" "If the ``default`` value is a string, the parser parses the value as if it " "were a command-line argument. In particular, the parser applies any type_ " @@ -4043,24 +3994,24 @@ msgid "" msgstr "" # b7ff760002b841f2935ea74eaf39387a -#: ../src/Doc/library/argparse.rst:912 +#: library/argparse.rst:912 msgid "" "For positional arguments with nargs_ equal to ``?`` or ``*``, the " "``default`` value is used when no command-line argument was present::" msgstr "" -#: ../src/Doc/library/argparse.rst:923 +#: library/argparse.rst:923 msgid "" "Providing ``default=argparse.SUPPRESS`` causes no attribute to be added if " "the command-line argument was not present.::" msgstr "" -#: ../src/Doc/library/argparse.rst:935 +#: library/argparse.rst:935 library/optparse.rst:1592 msgid "type" msgstr "type" # 029bdcda18d84c63bb7821b605810eb3 -#: ../src/Doc/library/argparse.rst:937 +#: library/argparse.rst:937 msgid "" "By default, :class:`ArgumentParser` objects read command-line arguments in " "as simple strings. However, quite often the command-line string should " @@ -4072,13 +4023,13 @@ msgid "" msgstr "" # 9a1317db4cac47569ef5aa77c3efabe1 -#: ../src/Doc/library/argparse.rst:950 +#: library/argparse.rst:950 msgid "" "See the section on the default_ keyword argument for information on when the " "``type`` argument is applied to default arguments." msgstr "" -#: ../src/Doc/library/argparse.rst:953 +#: library/argparse.rst:953 msgid "" "To ease the use of various types of files, the argparse module provides the " "factory FileType which takes the ``mode=`` and ``bufsize=`` arguments of the " @@ -4087,28 +4038,28 @@ msgid "" msgstr "" # 0d04f119cabf4461a0bb36328f8de755 -#: ../src/Doc/library/argparse.rst:963 +#: library/argparse.rst:963 msgid "" "``type=`` can take any callable that takes a single string argument and " "returns the converted value::" msgstr "" -#: ../src/Doc/library/argparse.rst:982 +#: library/argparse.rst:982 msgid "" "The choices_ keyword argument may be more convenient for type checkers that " "simply check against a range of values::" msgstr "" -#: ../src/Doc/library/argparse.rst:993 +#: library/argparse.rst:993 msgid "See the choices_ section for more details." msgstr "" -#: ../src/Doc/library/argparse.rst:997 +#: library/argparse.rst:997 msgid "choices" msgstr "" # abd8170ad0bb4282ab0965618c3d417c -#: ../src/Doc/library/argparse.rst:999 +#: library/argparse.rst:999 msgid "" "Some command-line arguments should be selected from a restricted set of " "values. These can be handled by passing a container object as the *choices* " @@ -4118,7 +4069,7 @@ msgid "" msgstr "" # a563608ee1a94cfc93dbdcde7bf1dcc1 -#: ../src/Doc/library/argparse.rst:1014 +#: library/argparse.rst:1014 msgid "" "Note that inclusion in the *choices* container is checked after any type_ " "conversions have been performed, so the type of the objects in the *choices* " @@ -4126,19 +4077,19 @@ msgid "" msgstr "" # 3e5fba2c9dac46aaba3e996c61750339 -#: ../src/Doc/library/argparse.rst:1026 +#: library/argparse.rst:1026 msgid "" "Any object that supports the ``in`` operator can be passed as the *choices* " "value, so :class:`dict` objects, :class:`set` objects, custom containers, " "etc. are all supported." msgstr "" -#: ../src/Doc/library/argparse.rst:1032 +#: library/argparse.rst:1032 msgid "required" msgstr "" # ba45529bb8574042a6f31037e7a5ad76 -#: ../src/Doc/library/argparse.rst:1034 +#: library/argparse.rst:1034 msgid "" "In general, the :mod:`argparse` module assumes that flags like ``-f`` and " "``--bar`` indicate *optional* arguments, which can always be omitted at the " @@ -4147,25 +4098,25 @@ msgid "" msgstr "" # f126938ed2b94f20840cf6fa6ffd4bc1 -#: ../src/Doc/library/argparse.rst:1047 +#: library/argparse.rst:1047 msgid "" "As the example shows, if an option is marked as ``required``, :meth:" "`~ArgumentParser.parse_args` will report an error if that option is not " "present at the command line." msgstr "" -#: ../src/Doc/library/argparse.rst:1053 +#: library/argparse.rst:1053 msgid "" "Required options are generally considered bad form because users expect " "*options* to be *optional*, and thus they should be avoided when possible." msgstr "" -#: ../src/Doc/library/argparse.rst:1058 +#: library/argparse.rst:1058 msgid "help" msgstr "" # e7e44d25af79450191dcb46c5ffa5e16 -#: ../src/Doc/library/argparse.rst:1060 +#: library/argparse.rst:1060 msgid "" "The ``help`` value is a string containing a brief description of the " "argument. When a user requests help (usually by using ``-h`` or ``--help`` " @@ -4174,7 +4125,7 @@ msgid "" msgstr "" # ed543512a82b4f26b29ac3b6b0b78423 -#: ../src/Doc/library/argparse.rst:1080 +#: library/argparse.rst:1080 msgid "" "The ``help`` strings can include various format specifiers to avoid " "repetition of things like the program name or the argument default_. The " @@ -4184,18 +4135,18 @@ msgid "" msgstr "" # 62490878303844be8303ba5fa6ac6225 -#: ../src/Doc/library/argparse.rst:1097 +#: library/argparse.rst:1097 msgid "" ":mod:`argparse` supports silencing the help entry for certain options, by " "setting the ``help`` value to ``argparse.SUPPRESS``::" msgstr "" -#: ../src/Doc/library/argparse.rst:1110 +#: library/argparse.rst:1110 msgid "metavar" msgstr "" # 68760bc587da47b1bb278c876fed15bc -#: ../src/Doc/library/argparse.rst:1112 +#: library/argparse.rst:1112 msgid "" "When :class:`ArgumentParser` generates help messages, it needs some way to " "refer to each expected argument. By default, ArgumentParser objects use the " @@ -4207,31 +4158,31 @@ msgid "" "argument will be referred to as ``FOO``. An example::" msgstr "" -#: ../src/Doc/library/argparse.rst:1136 +#: library/argparse.rst:1136 msgid "An alternative name can be specified with ``metavar``::" msgstr "" # 3914afdc3ae24edb976de06fbcffea27 -#: ../src/Doc/library/argparse.rst:1153 +#: library/argparse.rst:1153 msgid "" "Note that ``metavar`` only changes the *displayed* name - the name of the " "attribute on the :meth:`~ArgumentParser.parse_args` object is still " "determined by the dest_ value." msgstr "" -#: ../src/Doc/library/argparse.rst:1157 +#: library/argparse.rst:1157 msgid "" "Different values of ``nargs`` may cause the metavar to be used multiple " "times. Providing a tuple to ``metavar`` specifies a different display for " "each of the arguments::" msgstr "" -#: ../src/Doc/library/argparse.rst:1174 +#: library/argparse.rst:1174 msgid "dest" msgstr "" # 0e0348b14b2b4f3cb3e9f42bd0a6330f -#: ../src/Doc/library/argparse.rst:1176 +#: library/argparse.rst:1176 msgid "" "Most :class:`ArgumentParser` actions add some value as an attribute of the " "object returned by :meth:`~ArgumentParser.parse_args`. The name of this " @@ -4242,7 +4193,7 @@ msgid "" msgstr "" # 3c73980fda394dbb98338e30e4899de4 -#: ../src/Doc/library/argparse.rst:1188 +#: library/argparse.rst:1188 msgid "" "For optional argument actions, the value of ``dest`` is normally inferred " "from the option strings. :class:`ArgumentParser` generates the value of " @@ -4254,17 +4205,17 @@ msgid "" "below illustrate this behavior::" msgstr "" -#: ../src/Doc/library/argparse.rst:1205 +#: library/argparse.rst:1205 msgid "``dest`` allows a custom attribute name to be provided::" msgstr "" # ff391f71be6349febe368a120d58c06f -#: ../src/Doc/library/argparse.rst:1213 +#: library/argparse.rst:1213 msgid "Action classes" msgstr "" # 73a84fe7d8b54871b6e60a483280748c -#: ../src/Doc/library/argparse.rst:1215 +#: library/argparse.rst:1215 msgid "" "Action classes implement the Action API, a callable which returns a callable " "which processes arguments from the command-line. Any object which follows " @@ -4272,7 +4223,7 @@ msgid "" msgstr "" # 78f54be367e440f3bafe195266ba47b6 -#: ../src/Doc/library/argparse.rst:1223 +#: library/argparse.rst:1223 msgid "" "Action objects are used by an ArgumentParser to represent the information " "needed to parse a single argument from one or more strings from the command " @@ -4282,7 +4233,7 @@ msgid "" msgstr "" # 24f04570ed6b4f2681c2189f7600a10d -#: ../src/Doc/library/argparse.rst:1228 +#: library/argparse.rst:1228 msgid "" "Instances of Action (or return value of any callable to the ``action`` " "parameter) should have attributes \"dest\", \"option_strings\", \"default\", " @@ -4291,18 +4242,18 @@ msgid "" msgstr "" # bf0eaee2cc4b41ceb01cebd7f1170781 -#: ../src/Doc/library/argparse.rst:1233 +#: library/argparse.rst:1233 msgid "" "Action instances should be callable, so subclasses must override the " "``__call__`` method, which should accept four parameters:" msgstr "" -#: ../src/Doc/library/argparse.rst:1236 +#: library/argparse.rst:1236 msgid "``parser`` - The ArgumentParser object which contains this action." msgstr "" # 15df53f08c3d4b7ab4ac66f374d55aa2 -#: ../src/Doc/library/argparse.rst:1238 +#: library/argparse.rst:1238 msgid "" "``namespace`` - The :class:`Namespace` object that will be returned by :meth:" "`~ArgumentParser.parse_args`. Most actions add an attribute to this object " @@ -4310,14 +4261,14 @@ msgid "" msgstr "" # e06e3197a8ea4bd582ca5ceb58024114 -#: ../src/Doc/library/argparse.rst:1242 +#: library/argparse.rst:1242 msgid "" "``values`` - The associated command-line arguments, with any type " "conversions applied. Type conversions are specified with the type_ keyword " "argument to :meth:`~ArgumentParser.add_argument`." msgstr "" -#: ../src/Doc/library/argparse.rst:1246 +#: library/argparse.rst:1246 msgid "" "``option_string`` - The option string that was used to invoke this action. " "The ``option_string`` argument is optional, and will be absent if the action " @@ -4325,23 +4276,23 @@ msgid "" msgstr "" # fdc98bae58ac45d9852e6af0cb93e92c -#: ../src/Doc/library/argparse.rst:1250 +#: library/argparse.rst:1250 msgid "" "The ``__call__`` method may perform arbitrary actions, but will typically " "set attributes on the ``namespace`` based on ``dest`` and ``values``." msgstr "" -#: ../src/Doc/library/argparse.rst:1255 +#: library/argparse.rst:1255 msgid "The parse_args() method" msgstr "" -#: ../src/Doc/library/argparse.rst:1259 +#: library/argparse.rst:1259 msgid "" "Convert argument strings to objects and assign them as attributes of the " "namespace. Return the populated namespace." msgstr "" -#: ../src/Doc/library/argparse.rst:1262 +#: library/argparse.rst:1262 msgid "" "Previous calls to :meth:`add_argument` determine exactly what objects are " "created and how they are assigned. See the documentation for :meth:" @@ -4349,18 +4300,18 @@ msgid "" msgstr "" # a16e8c4a87394cd082e7aef15065c2e1 -#: ../src/Doc/library/argparse.rst:1266 +#: library/argparse.rst:1266 msgid "" "By default, the argument strings are taken from :data:`sys.argv`, and a new " "empty :class:`Namespace` object is created for the attributes." msgstr "" -#: ../src/Doc/library/argparse.rst:1271 +#: library/argparse.rst:1271 msgid "Option value syntax" msgstr "" # 5b661b8ac7ab4e7c90000f4fb37b2e33 -#: ../src/Doc/library/argparse.rst:1273 +#: library/argparse.rst:1273 msgid "" "The :meth:`~ArgumentParser.parse_args` method supports several ways of " "specifying the value of an option (if it takes one). In the simplest case, " @@ -4368,31 +4319,31 @@ msgid "" msgstr "" # 2654787102ae4777b4543409ea5df415 -#: ../src/Doc/library/argparse.rst:1285 +#: library/argparse.rst:1285 msgid "" "For long options (options with names longer than a single character), the " "option and value can also be passed as a single command-line argument, using " "``=`` to separate them::" msgstr "" -#: ../src/Doc/library/argparse.rst:1292 +#: library/argparse.rst:1292 msgid "" "For short options (options only one character long), the option and its " "value can be concatenated::" msgstr "" -#: ../src/Doc/library/argparse.rst:1298 +#: library/argparse.rst:1298 msgid "" "Several short options can be joined together, using only a single ``-`` " "prefix, as long as only the last option (or none of them) requires a value::" msgstr "" -#: ../src/Doc/library/argparse.rst:1310 +#: library/argparse.rst:1310 msgid "Invalid arguments" msgstr "" # d649b5f8f1f64c55b9d19d7776269f2e -#: ../src/Doc/library/argparse.rst:1312 +#: library/argparse.rst:1312 msgid "" "While parsing the command line, :meth:`~ArgumentParser.parse_args` checks " "for a variety of errors, including ambiguous options, invalid types, invalid " @@ -4401,12 +4352,12 @@ msgid "" msgstr "" # 27bb9b4e8e3846bbbf1e5a013a800820 -#: ../src/Doc/library/argparse.rst:1338 +#: library/argparse.rst:1338 msgid "Arguments containing ``-``" msgstr "" # 75f7eaf572204a0fb80b50e252ee264a -#: ../src/Doc/library/argparse.rst:1340 +#: library/argparse.rst:1340 msgid "" "The :meth:`~ArgumentParser.parse_args` method attempts to give errors " "whenever the user has clearly made a mistake, but some situations are " @@ -4419,7 +4370,7 @@ msgid "" msgstr "" # 3498ae967f9e4d8eb2b65bc8fda17f28 -#: ../src/Doc/library/argparse.rst:1378 +#: library/argparse.rst:1378 msgid "" "If you have positional arguments that must begin with ``-`` and don't look " "like negative numbers, you can insert the pseudo-argument ``'--'`` which " @@ -4428,29 +4379,29 @@ msgid "" msgstr "" # 8967bc1432ea43c8ac1bcb98598f330b -#: ../src/Doc/library/argparse.rst:1389 +#: library/argparse.rst:1389 msgid "Argument abbreviations (prefix matching)" msgstr "" # 1e1a3bb69fd4443fbaf7cff443ea9c0d -#: ../src/Doc/library/argparse.rst:1391 +#: library/argparse.rst:1391 msgid "" "The :meth:`~ArgumentParser.parse_args` method allows long options to be " "abbreviated to a prefix, if the abbreviation is unambiguous (the prefix " "matches a unique option)::" msgstr "" -#: ../src/Doc/library/argparse.rst:1406 +#: library/argparse.rst:1406 msgid "" "An error is produced for arguments that could produce more than one options." msgstr "" -#: ../src/Doc/library/argparse.rst:1410 +#: library/argparse.rst:1410 msgid "Beyond ``sys.argv``" msgstr "" # 3d197b46c5a7466488696b5e6199795e -#: ../src/Doc/library/argparse.rst:1412 +#: library/argparse.rst:1412 msgid "" "Sometimes it may be useful to have an ArgumentParser parse arguments other " "than those of :data:`sys.argv`. This can be accomplished by passing a list " @@ -4459,19 +4410,19 @@ msgid "" msgstr "" # c1046fea35b94d4e88173588ccca4358 -#: ../src/Doc/library/argparse.rst:1431 +#: library/argparse.rst:1431 msgid "The Namespace object" msgstr "" # fb23021deb324feaa0df126c2bd00346 -#: ../src/Doc/library/argparse.rst:1435 +#: library/argparse.rst:1435 msgid "" "Simple class used by default by :meth:`~ArgumentParser.parse_args` to create " "an object holding attributes and return it." msgstr "" # f4480dd2e09b49c4a491af893790f73b -#: ../src/Doc/library/argparse.rst:1438 +#: library/argparse.rst:1438 msgid "" "This class is deliberately simple, just an :class:`object` subclass with a " "readable string representation. If you prefer to have dict-like view of the " @@ -4479,23 +4430,23 @@ msgid "" msgstr "" # 6c828b6d4bd946b1bdceb04c27bdc641 -#: ../src/Doc/library/argparse.rst:1448 +#: library/argparse.rst:1448 msgid "" "It may also be useful to have an :class:`ArgumentParser` assign attributes " "to an already existing object, rather than a new :class:`Namespace` object. " "This can be achieved by specifying the ``namespace=`` keyword argument::" msgstr "" -#: ../src/Doc/library/argparse.rst:1464 +#: library/argparse.rst:1464 msgid "Other utilities" msgstr "" -#: ../src/Doc/library/argparse.rst:1467 +#: library/argparse.rst:1467 msgid "Sub-commands" msgstr "" # 01ce365923f445c2a01f719fcc6c8953 -#: ../src/Doc/library/argparse.rst:1474 +#: library/argparse.rst:1474 msgid "" "Many programs split up their functionality into a number of sub-commands, " "for example, the ``svn`` program can invoke sub-commands like ``svn " @@ -4512,12 +4463,12 @@ msgid "" msgstr "" # 861bcc3248844915b030f48341d7ca72 -#: ../src/Doc/library/argparse.rst:1486 +#: library/argparse.rst:1486 msgid "Description of parameters:" msgstr "" # 40bb70a4a3404303a6ecf5162c69799b -#: ../src/Doc/library/argparse.rst:1488 +#: library/argparse.rst:1488 msgid "" "title - title for the sub-parser group in help output; by default " "\"subcommands\" if description is provided, otherwise uses title for " @@ -4525,14 +4476,14 @@ msgid "" msgstr "" # 387728ac2cf045029ba3260dd71ffbe6 -#: ../src/Doc/library/argparse.rst:1492 +#: library/argparse.rst:1492 msgid "" "description - description for the sub-parser group in help output, by " "default None" msgstr "" # 59c07c2b8f5943b8a5b38ab3425455a4 -#: ../src/Doc/library/argparse.rst:1495 +#: library/argparse.rst:1495 msgid "" "prog - usage information that will be displayed with sub-command help, by " "default the name of the program and any positional arguments before the " @@ -4540,37 +4491,40 @@ msgid "" msgstr "" # 2908921d88174c72a44af4901f033ebe -#: ../src/Doc/library/argparse.rst:1499 +#: library/argparse.rst:1499 msgid "" "parser_class - class which will be used to create sub-parser instances, by " "default the class of the current parser (e.g. ArgumentParser)" msgstr "" -# b031fbba9c044d22a52ce292529f35a2 -#: ../src/Doc/library/argparse.rst:1502 +#: library/argparse.rst:1502 msgid "" -"dest - name of the attribute under which sub-command name will be stored; by " -"default None and no value is stored" +"action_ - the basic type of action to be taken when this argument is " +"encountered at the command line" msgstr "" -# 56a1d7603e6e4a51bcee5a4fc255698b -#: ../src/Doc/library/argparse.rst:1505 -msgid "help - help for sub-parser group in help output, by default None" -msgstr "" - -# 7b2c850c074846d697b20b61553cffbd -#: ../src/Doc/library/argparse.rst:1507 +#: library/argparse.rst:1505 msgid "" -"metavar - string presenting available sub-commands in help; by default it is " -"None and presents sub-commands in form {cmd1, cmd2, ..}" +"dest_ - name of the attribute under which sub-command name will be stored; " +"by default None and no value is stored" msgstr "" -#: ../src/Doc/library/argparse.rst:1510 +#: library/argparse.rst:1508 +msgid "help_ - help for sub-parser group in help output, by default None" +msgstr "" + +#: library/argparse.rst:1510 +msgid "" +"metavar_ - string presenting available sub-commands in help; by default it " +"is None and presents sub-commands in form {cmd1, cmd2, ..}" +msgstr "" + +#: library/argparse.rst:1513 msgid "Some example usage::" msgstr "" # af4702848ffb49d1b7514cb410e75415 -#: ../src/Doc/library/argparse.rst:1531 +#: library/argparse.rst:1534 msgid "" "Note that the object returned by :meth:`parse_args` will only contain " "attributes for the main parser and the subparser that was selected by the " @@ -4581,7 +4535,7 @@ msgid "" msgstr "" # 480e326fe3e74c2a814e2d6677c928a8 -#: ../src/Doc/library/argparse.rst:1538 +#: library/argparse.rst:1541 msgid "" "Similarly, when a help message is requested from a subparser, only the help " "for that particular parser will be printed. The help message will not " @@ -4590,14 +4544,14 @@ msgid "" "to :meth:`add_parser` as above.)" msgstr "" -#: ../src/Doc/library/argparse.rst:1574 +#: library/argparse.rst:1577 msgid "" "The :meth:`add_subparsers` method also supports ``title`` and " "``description`` keyword arguments. When either is present, the subparser's " "commands will appear in their own group in the help output. For example::" msgstr "" -#: ../src/Doc/library/argparse.rst:1596 +#: library/argparse.rst:1599 msgid "" "One particularly effective way of handling sub-commands is to combine the " "use of the :meth:`add_subparsers` method with calls to :meth:`set_defaults` " @@ -4606,7 +4560,7 @@ msgid "" msgstr "" # d5dc91a76dfa4295ac1f5a183c9218f9 -#: ../src/Doc/library/argparse.rst:1633 +#: library/argparse.rst:1636 msgid "" "This way, you can let :meth:`parse_args` do the job of calling the " "appropriate function after argument parsing is complete. Associating " @@ -4616,12 +4570,12 @@ msgid "" "argument to the :meth:`add_subparsers` call will work::" msgstr "" -#: ../src/Doc/library/argparse.rst:1651 +#: library/argparse.rst:1654 msgid "FileType objects" msgstr "" # 55996a4a7912420aa070762fd892fabf -#: ../src/Doc/library/argparse.rst:1655 +#: library/argparse.rst:1658 msgid "" "The :class:`FileType` factory creates objects that can be passed to the type " "argument of :meth:`ArgumentParser.add_argument`. Arguments that have :class:" @@ -4630,18 +4584,18 @@ msgid "" msgstr "" # 25e8ed12b8f14d928e3d13faddd1596f -#: ../src/Doc/library/argparse.rst:1665 +#: library/argparse.rst:1668 msgid "" "FileType objects understand the pseudo-argument ``'-'`` and automatically " "convert this into ``sys.stdin`` for readable :class:`FileType` objects and " "``sys.stdout`` for writable :class:`FileType` objects::" msgstr "" -#: ../src/Doc/library/argparse.rst:1676 +#: library/argparse.rst:1679 msgid "Argument groups" msgstr "" -#: ../src/Doc/library/argparse.rst:1680 +#: library/argparse.rst:1683 msgid "" "By default, :class:`ArgumentParser` groups command-line arguments into " "\"positional arguments\" and \"optional arguments\" when displaying help " @@ -4651,7 +4605,7 @@ msgid "" msgstr "" # cfd5889287c844c0af6dc79c0b60eb91 -#: ../src/Doc/library/argparse.rst:1697 +#: library/argparse.rst:1700 msgid "" "The :meth:`add_argument_group` method returns an argument group object which " "has an :meth:`~ArgumentParser.add_argument` method just like a regular :" @@ -4663,18 +4617,18 @@ msgid "" msgstr "" # 38e890afd02d41dda30efa924b4fba02 -#: ../src/Doc/library/argparse.rst:1723 +#: library/argparse.rst:1726 msgid "" "Note that any arguments not in your user-defined groups will end up back in " "the usual \"positional arguments\" and \"optional arguments\" sections." msgstr "" -#: ../src/Doc/library/argparse.rst:1728 +#: library/argparse.rst:1731 msgid "Mutual exclusion" msgstr "" # d4c8c1c4038245a8be74e78dde656d79 -#: ../src/Doc/library/argparse.rst:1732 +#: library/argparse.rst:1735 msgid "" "Create a mutually exclusive group. :mod:`argparse` will make sure that only " "one of the arguments in the mutually exclusive group was present on the " @@ -4682,7 +4636,7 @@ msgid "" msgstr "" # 7cf13914b6504c97a5f9179bfb9f4307 -#: ../src/Doc/library/argparse.rst:1748 +#: library/argparse.rst:1751 msgid "" "The :meth:`add_mutually_exclusive_group` method also accepts a *required* " "argument, to indicate that at least one of the mutually exclusive arguments " @@ -4690,19 +4644,19 @@ msgid "" msgstr "" # 1fe91ba6b26f4c3db24c5dfeb631c05e -#: ../src/Doc/library/argparse.rst:1760 +#: library/argparse.rst:1763 msgid "" "Note that currently mutually exclusive argument groups do not support the " "*title* and *description* arguments of :meth:`~ArgumentParser." "add_argument_group`." msgstr "" -#: ../src/Doc/library/argparse.rst:1766 +#: library/argparse.rst:1769 msgid "Parser defaults" msgstr "" # b9e4123f8b134ea988fd62c3ea633c03 -#: ../src/Doc/library/argparse.rst:1770 +#: library/argparse.rst:1773 msgid "" "Most of the time, the attributes of the object returned by :meth:" "`parse_args` will be fully determined by inspecting the command-line " @@ -4711,30 +4665,30 @@ msgid "" "command line to be added::" msgstr "" -#: ../src/Doc/library/argparse.rst:1782 +#: library/argparse.rst:1785 msgid "" "Note that parser-level defaults always override argument-level defaults::" msgstr "" -#: ../src/Doc/library/argparse.rst:1790 +#: library/argparse.rst:1793 msgid "" "Parser-level defaults can be particularly useful when working with multiple " "parsers. See the :meth:`~ArgumentParser.add_subparsers` method for an " "example of this type." msgstr "" -#: ../src/Doc/library/argparse.rst:1796 +#: library/argparse.rst:1799 msgid "" "Get the default value for a namespace attribute, as set by either :meth:" "`~ArgumentParser.add_argument` or by :meth:`~ArgumentParser.set_defaults`::" msgstr "" -#: ../src/Doc/library/argparse.rst:1807 +#: library/argparse.rst:1810 msgid "Printing help" msgstr "" # 34aa350fe24447399c786b67a2ab3dc6 -#: ../src/Doc/library/argparse.rst:1809 +#: library/argparse.rst:1812 msgid "" "In most typical applications, :meth:`~ArgumentParser.parse_args` will take " "care of formatting and printing any usage or error messages. However, " @@ -4742,7 +4696,7 @@ msgid "" msgstr "" # 591954fc600440e0a0aa564cf1d47e97 -#: ../src/Doc/library/argparse.rst:1815 +#: library/argparse.rst:1818 msgid "" "Print a brief description of how the :class:`ArgumentParser` should be " "invoked on the command line. If *file* is ``None``, :data:`sys.stdout` is " @@ -4750,37 +4704,37 @@ msgid "" msgstr "" # 09e8036d21cc465eae0b577bdf2fcb98 -#: ../src/Doc/library/argparse.rst:1821 +#: library/argparse.rst:1824 msgid "" "Print a help message, including the program usage and information about the " "arguments registered with the :class:`ArgumentParser`. If *file* is " "``None``, :data:`sys.stdout` is assumed." msgstr "" -#: ../src/Doc/library/argparse.rst:1825 +#: library/argparse.rst:1828 msgid "" "There are also variants of these methods that simply return a string instead " "of printing it:" msgstr "" -#: ../src/Doc/library/argparse.rst:1830 +#: library/argparse.rst:1833 msgid "" "Return a string containing a brief description of how the :class:" "`ArgumentParser` should be invoked on the command line." msgstr "" -#: ../src/Doc/library/argparse.rst:1835 +#: library/argparse.rst:1838 msgid "" "Return a string containing a help message, including the program usage and " "information about the arguments registered with the :class:`ArgumentParser`." msgstr "" -#: ../src/Doc/library/argparse.rst:1840 +#: library/argparse.rst:1843 msgid "Partial parsing" msgstr "" # 6808290f86c84c4da48a388f19dcefb0 -#: ../src/Doc/library/argparse.rst:1844 +#: library/argparse.rst:1847 msgid "" "Sometimes a script may only parse a few of the command-line arguments, " "passing the remaining arguments on to another script or program. In these " @@ -4792,7 +4746,7 @@ msgid "" msgstr "" # ec3ff359ba63401384658a0d74937240 -#: ../src/Doc/library/argparse.rst:1860 +#: library/argparse.rst:1863 msgid "" ":ref:`Prefix matching ` rules apply to :meth:" "`parse_known_args`. The parser may consume an option even if it's just a " @@ -4800,12 +4754,12 @@ msgid "" "arguments list." msgstr "" -#: ../src/Doc/library/argparse.rst:1867 +#: library/argparse.rst:1870 msgid "Customizing file parsing" msgstr "" # ff017bb3474d448f86819dbf5c6d5d22 -#: ../src/Doc/library/argparse.rst:1871 +#: library/argparse.rst:1874 msgid "" "Arguments that are read from a file (see the *fromfile_prefix_chars* keyword " "argument to the :class:`ArgumentParser` constructor) are read one argument " @@ -4814,44 +4768,44 @@ msgid "" msgstr "" # 9aea03b598474310ba7ba8dcb815e8fb -#: ../src/Doc/library/argparse.rst:1876 +#: library/argparse.rst:1879 msgid "" "This method takes a single argument *arg_line* which is a string read from " "the argument file. It returns a list of arguments parsed from this string. " "The method is called once per line read from the argument file, in order." msgstr "" -#: ../src/Doc/library/argparse.rst:1880 +#: library/argparse.rst:1883 msgid "" "A useful override of this method is one that treats each space-separated " "word as an argument::" msgstr "" # b66f7580b8184bb3b33755a434e6a573 -#: ../src/Doc/library/argparse.rst:1891 +#: library/argparse.rst:1891 msgid "Exiting methods" msgstr "" # ae319d38705e49d68275c0ce242a374c -#: ../src/Doc/library/argparse.rst:1895 +#: library/argparse.rst:1895 msgid "" "This method terminates the program, exiting with the specified *status* and, " "if given, it prints a *message* before that." msgstr "" # 89ebc14e60084f1f878274c5606892e3 -#: ../src/Doc/library/argparse.rst:1900 +#: library/argparse.rst:1900 msgid "" "This method prints a usage message including the *message* to the standard " "error and terminates the program with a status code of 2." msgstr "" -#: ../src/Doc/library/argparse.rst:1907 +#: library/argparse.rst:1907 msgid "Upgrading optparse code" msgstr "" # afba75b76d184afe946311c716a6c1b6 -#: ../src/Doc/library/argparse.rst:1909 +#: library/argparse.rst:1909 msgid "" "Originally, the :mod:`argparse` module had attempted to maintain " "compatibility with :mod:`optparse`. However, :mod:`optparse` was difficult " @@ -4863,56 +4817,56 @@ msgid "" msgstr "" # cfba9f83ecb441a59b48c18d3514d23e -#: ../src/Doc/library/argparse.rst:1916 +#: library/argparse.rst:1916 msgid "" "The :mod:`argparse` module improves on the standard library :mod:`optparse` " "module in a number of ways including:" msgstr "" # 23b59d49aeb44f42a4515e18e858340a -#: ../src/Doc/library/argparse.rst:1919 +#: library/argparse.rst:1919 msgid "Handling positional arguments." msgstr "" # 02858346ebe44a3eb37e7ff9b5dac777 -#: ../src/Doc/library/argparse.rst:1920 +#: library/argparse.rst:1920 msgid "Supporting sub-commands." msgstr "" # 3ef6eee7ed544bc8b9309d87e27ef404 -#: ../src/Doc/library/argparse.rst:1921 +#: library/argparse.rst:1921 msgid "Allowing alternative option prefixes like ``+`` and ``/``." msgstr "" # 8c84827d9b244712aacb027275eb95c0 -#: ../src/Doc/library/argparse.rst:1922 +#: library/argparse.rst:1922 msgid "Handling zero-or-more and one-or-more style arguments." msgstr "" # e2550818170e4bdead230b7ac06b4de0 -#: ../src/Doc/library/argparse.rst:1923 +#: library/argparse.rst:1923 msgid "Producing more informative usage messages." msgstr "" # a7c2a08a289c43998382ac4de01133db -#: ../src/Doc/library/argparse.rst:1924 +#: library/argparse.rst:1924 msgid "Providing a much simpler interface for custom ``type`` and ``action``." msgstr "" # c66acd83dea34ed69b1c43840d576df7 -#: ../src/Doc/library/argparse.rst:1926 +#: library/argparse.rst:1926 msgid "A partial upgrade path from :mod:`optparse` to :mod:`argparse`:" msgstr "" # 6326fceb64a54cc4bb3434f62bc4bded -#: ../src/Doc/library/argparse.rst:1928 +#: library/argparse.rst:1928 msgid "" "Replace all :meth:`optparse.OptionParser.add_option` calls with :meth:" "`ArgumentParser.add_argument` calls." msgstr "" # 2445257e0e3c4ed5afc2b24cd413cc7d -#: ../src/Doc/library/argparse.rst:1931 +#: library/argparse.rst:1931 msgid "" "Replace ``(options, args) = parser.parse_args()`` with ``args = parser." "parse_args()`` and add additional :meth:`ArgumentParser.add_argument` calls " @@ -4920,44 +4874,44 @@ msgid "" "``options``, now in :mod:`argparse` context is called ``args``." msgstr "" -#: ../src/Doc/library/argparse.rst:1936 +#: library/argparse.rst:1936 msgid "" "Replace callback actions and the ``callback_*`` keyword arguments with " "``type`` or ``action`` arguments." msgstr "" -#: ../src/Doc/library/argparse.rst:1939 +#: library/argparse.rst:1939 msgid "" "Replace string names for ``type`` keyword arguments with the corresponding " "type objects (e.g. int, float, complex, etc)." msgstr "" -#: ../src/Doc/library/argparse.rst:1942 +#: library/argparse.rst:1942 msgid "" "Replace :class:`optparse.Values` with :class:`Namespace` and :exc:`optparse." "OptionError` and :exc:`optparse.OptionValueError` with :exc:`ArgumentError`." msgstr "" # bcda90c3b5c0483e8248fe678578ae25 -#: ../src/Doc/library/argparse.rst:1946 +#: library/argparse.rst:1946 msgid "" "Replace strings with implicit arguments such as ``%default`` or ``%prog`` " "with the standard Python syntax to use dictionaries to format strings, that " "is, ``%(default)s`` and ``%(prog)s``." msgstr "" -#: ../src/Doc/library/argparse.rst:1950 +#: library/argparse.rst:1950 msgid "" "Replace the OptionParser constructor ``version`` argument with a call to " "``parser.add_argument('--version', action='version', version='')``" +"version>')``." msgstr "" -#: ../src/Doc/library/array.rst:3 +#: library/array.rst:3 msgid ":mod:`array` --- Efficient arrays of numeric values" msgstr "" -#: ../src/Doc/library/array.rst:11 +#: library/array.rst:11 msgid "" "This module defines an object type which can compactly represent an array of " "basic values: characters, integers, floating point numbers. Arrays are " @@ -4967,193 +4921,178 @@ msgid "" "following type codes are defined:" msgstr "" -#: ../src/Doc/library/array.rst:19 +#: library/array.rst:19 msgid "Type code" msgstr "" -#: ../src/Doc/library/array.rst:19 ../src/Doc/library/fl.rst:352 -#: ../src/Doc/library/fl.rst:430 ../src/Doc/library/struct.rst:166 +#: library/array.rst:19 library/fl.rst:352 library/fl.rst:430 +#: library/struct.rst:166 msgid "C Type" msgstr "" -#: ../src/Doc/library/array.rst:19 ../src/Doc/library/xml.dom.rst:998 +#: library/array.rst:19 library/xml.dom.rst:998 msgid "Python Type" msgstr "" -#: ../src/Doc/library/array.rst:19 +#: library/array.rst:19 msgid "Minimum size in bytes" msgstr "" -#: ../src/Doc/library/array.rst:21 +#: library/array.rst:21 msgid "char" msgstr "" # 0085d4fceab64a2b840ccd419bb70b66 -#: ../src/Doc/library/array.rst:21 +#: library/array.rst:21 msgid "character" msgstr "" -#: ../src/Doc/library/array.rst:21 ../src/Doc/library/array.rst:23 -#: ../src/Doc/library/array.rst:25 ../src/Doc/library/ctypes.rst:1708 -#: ../src/Doc/library/grp.rst:22 ../src/Doc/library/pwd.rst:22 -#: ../src/Doc/library/spwd.rst:27 ../src/Doc/library/struct.rst:170 -#: ../src/Doc/library/struct.rst:172 ../src/Doc/library/struct.rst:174 -#: ../src/Doc/library/struct.rst:176 ../src/Doc/library/time.rst:409 -#: ../src/Doc/library/tkinter.rst:442 ../src/Doc/library/urlparse.rst:98 -#: ../src/Doc/library/urlparse.rst:202 +#: library/array.rst:21 library/array.rst:23 library/array.rst:25 +#: library/ctypes.rst:1709 library/grp.rst:22 library/pwd.rst:22 +#: library/spwd.rst:27 library/struct.rst:170 library/struct.rst:172 +#: library/struct.rst:174 library/struct.rst:176 library/time.rst:408 +#: library/tkinter.rst:442 library/urlparse.rst:98 library/urlparse.rst:202 msgid "1" msgstr "" -#: ../src/Doc/library/array.rst:23 ../src/Doc/library/io.rst:92 -#: ../src/Doc/library/string.rst:422 +#: library/array.rst:23 library/io.rst:92 library/string.rst:422 msgid "``'b'``" msgstr "" -#: ../src/Doc/library/array.rst:23 +#: library/array.rst:23 msgid "signed char" msgstr "" -#: ../src/Doc/library/array.rst:23 ../src/Doc/library/array.rst:25 -#: ../src/Doc/library/array.rst:29 ../src/Doc/library/array.rst:31 -#: ../src/Doc/library/array.rst:33 ../src/Doc/library/array.rst:37 -#: ../src/Doc/library/fl.rst:364 ../src/Doc/library/fl.rst:366 -#: ../src/Doc/library/fl.rst:368 ../src/Doc/library/fl.rst:370 -#: ../src/Doc/library/fl.rst:436 ../src/Doc/library/fl.rst:446 -#: ../src/Doc/library/fl.rst:448 ../src/Doc/library/fl.rst:450 -#: ../src/Doc/library/fl.rst:452 ../src/Doc/library/fl.rst:458 +#: library/array.rst:23 library/array.rst:25 library/array.rst:29 +#: library/array.rst:31 library/array.rst:33 library/array.rst:37 +#: library/fl.rst:364 library/fl.rst:366 library/fl.rst:368 library/fl.rst:370 +#: library/fl.rst:436 library/fl.rst:446 library/fl.rst:448 library/fl.rst:450 +#: library/fl.rst:452 library/fl.rst:458 msgid "int" msgstr "" -#: ../src/Doc/library/array.rst:25 +#: library/array.rst:25 msgid "``'B'``" msgstr "" -#: ../src/Doc/library/array.rst:25 +#: library/array.rst:25 msgid "unsigned char" msgstr "" -#: ../src/Doc/library/array.rst:27 ../src/Doc/library/gdbm.rst:70 -#: ../src/Doc/library/stdtypes.rst:1450 +#: library/array.rst:27 library/gdbm.rst:70 library/stdtypes.rst:1453 msgid "``'u'``" msgstr "" -#: ../src/Doc/library/array.rst:27 +#: library/array.rst:27 msgid "Py_UNICODE" msgstr "" -#: ../src/Doc/library/array.rst:27 +#: library/array.rst:27 msgid "Unicode character" msgstr "" -#: ../src/Doc/library/array.rst:27 +#: library/array.rst:27 msgid "2 (see note)" msgstr "" -#: ../src/Doc/library/array.rst:29 +#: library/array.rst:29 msgid "``'h'``" msgstr "" -#: ../src/Doc/library/array.rst:29 +#: library/array.rst:29 msgid "signed short" msgstr "" -#: ../src/Doc/library/array.rst:29 ../src/Doc/library/array.rst:31 -#: ../src/Doc/library/array.rst:33 ../src/Doc/library/array.rst:35 -#: ../src/Doc/library/ctypes.rst:1711 ../src/Doc/library/grp.rst:25 -#: ../src/Doc/library/pwd.rst:24 ../src/Doc/library/spwd.rst:29 -#: ../src/Doc/library/struct.rst:178 ../src/Doc/library/struct.rst:180 -#: ../src/Doc/library/time.rst:411 ../src/Doc/library/tkinter.rst:444 -#: ../src/Doc/library/urlparse.rst:100 ../src/Doc/library/urlparse.rst:204 +#: library/array.rst:29 library/array.rst:31 library/array.rst:33 +#: library/array.rst:35 library/ctypes.rst:1712 library/grp.rst:25 +#: library/pwd.rst:24 library/spwd.rst:29 library/struct.rst:178 +#: library/struct.rst:180 library/time.rst:410 library/tkinter.rst:444 +#: library/urlparse.rst:100 library/urlparse.rst:204 msgid "2" msgstr "" -#: ../src/Doc/library/array.rst:31 ../src/Doc/library/logging.handlers.rst:239 +#: library/array.rst:31 library/logging.handlers.rst:240 msgid "``'H'``" msgstr "" -#: ../src/Doc/library/array.rst:31 +#: library/array.rst:31 msgid "unsigned short" msgstr "" -#: ../src/Doc/library/array.rst:33 ../src/Doc/library/stdtypes.rst:1446 +#: library/array.rst:33 library/stdtypes.rst:1449 msgid "``'i'``" msgstr "" -#: ../src/Doc/library/array.rst:33 +#: library/array.rst:33 msgid "signed int" msgstr "" -#: ../src/Doc/library/array.rst:35 +#: library/array.rst:35 msgid "``'I'``" msgstr "" -#: ../src/Doc/library/array.rst:35 +#: library/array.rst:35 msgid "unsigned int" msgstr "" # a4b8b50946ed4212b6739df2420529d2 # 06c99bcba2ee4327a8d365b434f066be -#: ../src/Doc/library/array.rst:35 ../src/Doc/library/array.rst:39 +#: library/array.rst:35 library/array.rst:39 msgid "long" msgstr "" -#: ../src/Doc/library/array.rst:37 +#: library/array.rst:37 msgid "``'l'``" msgstr "" -#: ../src/Doc/library/array.rst:37 +#: library/array.rst:37 msgid "signed long" msgstr "" -#: ../src/Doc/library/array.rst:37 ../src/Doc/library/array.rst:39 -#: ../src/Doc/library/array.rst:41 ../src/Doc/library/chunk.rst:28 -#: ../src/Doc/library/chunk.rst:30 ../src/Doc/library/ctypes.rst:1714 -#: ../src/Doc/library/pwd.rst:28 ../src/Doc/library/spwd.rst:34 -#: ../src/Doc/library/struct.rst:182 ../src/Doc/library/struct.rst:184 -#: ../src/Doc/library/struct.rst:186 ../src/Doc/library/struct.rst:188 -#: ../src/Doc/library/struct.rst:195 ../src/Doc/library/time.rst:415 -#: ../src/Doc/library/tkinter.rst:449 ../src/Doc/library/urlparse.rst:105 -#: ../src/Doc/library/urlparse.rst:208 +#: library/array.rst:37 library/array.rst:39 library/array.rst:41 +#: library/chunk.rst:28 library/chunk.rst:30 library/ctypes.rst:1715 +#: library/pwd.rst:28 library/spwd.rst:34 library/struct.rst:182 +#: library/struct.rst:184 library/struct.rst:186 library/struct.rst:188 +#: library/struct.rst:195 library/time.rst:414 library/tkinter.rst:449 +#: library/urlparse.rst:105 library/urlparse.rst:208 msgid "4" msgstr "" -#: ../src/Doc/library/array.rst:39 +#: library/array.rst:39 msgid "``'L'``" msgstr "" -#: ../src/Doc/library/array.rst:39 +#: library/array.rst:39 msgid "unsigned long" msgstr "" -#: ../src/Doc/library/array.rst:41 ../src/Doc/library/gdbm.rst:63 -#: ../src/Doc/library/stdtypes.rst:1460 ../src/Doc/library/string.rst:461 +#: library/array.rst:41 library/gdbm.rst:63 library/stdtypes.rst:1463 +#: library/string.rst:461 msgid "``'f'``" msgstr "" -#: ../src/Doc/library/array.rst:43 ../src/Doc/library/stdtypes.rst:1444 -#: ../src/Doc/library/string.rst:427 +#: library/array.rst:43 library/stdtypes.rst:1447 library/string.rst:427 msgid "``'d'``" msgstr "" -#: ../src/Doc/library/array.rst:43 +#: library/array.rst:43 msgid "double" msgstr "" -#: ../src/Doc/library/array.rst:43 ../src/Doc/library/chunk.rst:34 -#: ../src/Doc/library/spwd.rst:47 ../src/Doc/library/struct.rst:190 -#: ../src/Doc/library/struct.rst:192 ../src/Doc/library/struct.rst:197 -#: ../src/Doc/library/time.rst:424 +#: library/array.rst:43 library/chunk.rst:34 library/spwd.rst:47 +#: library/struct.rst:190 library/struct.rst:192 library/struct.rst:197 +#: library/time.rst:423 msgid "8" msgstr "" -#: ../src/Doc/library/array.rst:48 +#: library/array.rst:48 msgid "" "The ``'u'`` typecode corresponds to Python's unicode character. On narrow " "Unicode builds this is 2-bytes, on wide builds this is 4-bytes." msgstr "" # 3e25a1f37c524616ba23e2760afabaa0 -#: ../src/Doc/library/array.rst:51 +#: library/array.rst:51 msgid "" "The actual representation of values is determined by the machine " "architecture (strictly speaking, by the C implementation). The actual size " @@ -5163,19 +5102,23 @@ msgid "" "full range of C's unsigned (long) integers." msgstr "" -#: ../src/Doc/library/array.rst:58 +#: library/array.rst:58 msgid "The module defines the following type:" msgstr "" # bdac29fdea6447c797003c38c1d1a871 -#: ../src/Doc/library/array.rst:63 +#: library/array.rst:63 msgid "" "A new array whose items are restricted by *typecode*, and initialized from " "the optional *initializer* value, which must be a list, string, or iterable " "over elements of the appropriate type." msgstr "" -#: ../src/Doc/library/array.rst:70 +#: library/array.rst:67 +msgid "Formerly, only lists or strings were accepted." +msgstr "" + +#: library/array.rst:70 msgid "" "If given a list or string, the initializer is passed to the new array's :" "meth:`fromlist`, :meth:`fromstring`, or :meth:`fromunicode` method (see " @@ -5183,11 +5126,11 @@ msgid "" "initializer is passed to the :meth:`extend` method." msgstr "" -#: ../src/Doc/library/array.rst:78 +#: library/array.rst:78 msgid "Obsolete alias for :class:`array`." msgstr "" -#: ../src/Doc/library/array.rst:80 +#: library/array.rst:80 msgid "" "Array objects support the ordinary sequence operations of indexing, slicing, " "concatenation, and multiplication. When using slice assignment, the " @@ -5196,24 +5139,24 @@ msgid "" "interface, and may be used wherever buffer objects are supported." msgstr "" -#: ../src/Doc/library/array.rst:86 +#: library/array.rst:86 msgid "The following data items and methods are also supported:" msgstr "" -#: ../src/Doc/library/array.rst:90 +#: library/array.rst:90 msgid "The typecode character used to create the array." msgstr "" -#: ../src/Doc/library/array.rst:95 +#: library/array.rst:95 msgid "The length in bytes of one array item in the internal representation." msgstr "" -#: ../src/Doc/library/array.rst:100 +#: library/array.rst:100 msgid "Append a new item with value *x* to the end of the array." msgstr "" # b00168c3d42849408b2b4432920e1382 -#: ../src/Doc/library/array.rst:105 +#: library/array.rst:105 msgid "" "Return a tuple ``(address, length)`` giving the current memory address and " "the length in elements of the buffer used to hold array's contents. The " @@ -5225,7 +5168,7 @@ msgid "" "it." msgstr "" -#: ../src/Doc/library/array.rst:115 +#: library/array.rst:115 msgid "" "When using array objects from code written in C or C++ (the only way to " "effectively make use of this information), it makes more sense to use the " @@ -5234,7 +5177,7 @@ msgid "" "interface is documented in :ref:`bufferobjects`." msgstr "" -#: ../src/Doc/library/array.rst:124 +#: library/array.rst:124 msgid "" "\"Byteswap\" all items of the array. This is only supported for values " "which are 1, 2, 4, or 8 bytes in size; for other types of values, :exc:" @@ -5242,11 +5185,11 @@ msgid "" "written on a machine with a different byte order." msgstr "" -#: ../src/Doc/library/array.rst:132 +#: library/array.rst:132 msgid "Return the number of occurrences of *x* in the array." msgstr "" -#: ../src/Doc/library/array.rst:137 +#: library/array.rst:137 msgid "" "Append items from *iterable* to the end of the array. If *iterable* is " "another array, it must have *exactly* the same type code; if not, :exc:" @@ -5254,7 +5197,11 @@ msgid "" "iterable and its elements must be the right type to be appended to the array." msgstr "" -#: ../src/Doc/library/array.rst:148 ../src/Doc/library/array.rst:199 +#: library/array.rst:142 +msgid "Formerly, the argument could only be another array." +msgstr "" + +#: library/array.rst:148 library/array.rst:199 msgid "" "Read *n* items (as machine values) from the file object *f* and append them " "to the end of the array. If less than *n* items are available, :exc:" @@ -5263,20 +5210,20 @@ msgid "" "a :meth:`read` method won't do." msgstr "" -#: ../src/Doc/library/array.rst:157 +#: library/array.rst:157 msgid "" "Append items from the list. This is equivalent to ``for x in list: a." "append(x)`` except that if there is a type error, the array is unchanged." msgstr "" -#: ../src/Doc/library/array.rst:163 +#: library/array.rst:163 msgid "" "Appends items from the string, interpreting the string as an array of " "machine values (as if it had been read from a file using the :meth:" "`fromfile` method)." msgstr "" -#: ../src/Doc/library/array.rst:169 +#: library/array.rst:169 msgid "" "Extends this array with data from the given unicode string. The array must " "be a type ``'u'`` array; otherwise a :exc:`ValueError` is raised. Use " @@ -5284,57 +5231,65 @@ msgid "" "array of some other type." msgstr "" -#: ../src/Doc/library/array.rst:177 +#: library/array.rst:177 msgid "" "Return the smallest *i* such that *i* is the index of the first occurrence " "of *x* in the array." msgstr "" -#: ../src/Doc/library/array.rst:183 +#: library/array.rst:183 msgid "" "Insert a new item with value *x* in the array before position *i*. Negative " "values are treated as being relative to the end of the array." msgstr "" -#: ../src/Doc/library/array.rst:189 +#: library/array.rst:189 msgid "" "Removes the item with the index *i* from the array and returns it. The " "optional argument defaults to ``-1``, so that by default the last item is " "removed and returned." msgstr "" -#: ../src/Doc/library/array.rst:208 +#: library/array.rst:196 +msgid "Use the :meth:`fromfile` method." +msgstr "" + +#: library/array.rst:208 msgid "Remove the first occurrence of *x* from the array." msgstr "" -#: ../src/Doc/library/array.rst:213 +#: library/array.rst:213 msgid "Reverse the order of the items in the array." msgstr "" -#: ../src/Doc/library/array.rst:218 ../src/Doc/library/array.rst:245 +#: library/array.rst:218 library/array.rst:245 msgid "Write all items (as machine values) to the file object *f*." msgstr "" -#: ../src/Doc/library/array.rst:223 +#: library/array.rst:223 msgid "Convert the array to an ordinary list with the same items." msgstr "" -#: ../src/Doc/library/array.rst:228 +#: library/array.rst:228 msgid "" "Convert the array to an array of machine values and return the string " "representation (the same sequence of bytes that would be written to a file " "by the :meth:`tofile` method.)" msgstr "" -#: ../src/Doc/library/array.rst:235 +#: library/array.rst:235 msgid "" "Convert the array to a unicode string. The array must be a type ``'u'`` " "array; otherwise a :exc:`ValueError` is raised. Use ``array.tostring()." "decode(enc)`` to obtain a unicode string from an array of some other type." msgstr "" +#: library/array.rst:242 +msgid "Use the :meth:`tofile` method." +msgstr "" + # 05b9b29c676c4d1a8b1731c832dc7674 -#: ../src/Doc/library/array.rst:247 +#: library/array.rst:247 msgid "" "When an array object is printed or converted to a string, it is represented " "as ``array(typecode, initializer)``. The *initializer* is omitted if the " @@ -5345,50 +5300,56 @@ msgid "" "array import array``. Examples::" msgstr "" -# 59e6fadcf2704f6a96c90db4e670f299 -#: ../src/Doc/library/array.rst:264 -msgid "Module :mod:`struct`" -msgstr "" +#: library/array.rst:265 +#, fuzzy +msgid "Module struct" +msgstr "Modules" -#: ../src/Doc/library/array.rst:265 +#: library/array.rst:265 msgid "Packing and unpacking of heterogeneous binary data." msgstr "" -# 2a2cc2b7d9a34ee492a6ec60d760920a -# 52035e9b11054212be086e47ee2905e6 -#: ../src/Doc/library/array.rst:268 ../src/Doc/library/struct.rst:347 -msgid "Module :mod:`xdrlib`" -msgstr "" +#: library/array.rst:269 library/struct.rst:348 +#, fuzzy +msgid "Module xdrlib" +msgstr "Modules" -#: ../src/Doc/library/array.rst:268 +#: library/array.rst:268 msgid "" "Packing and unpacking of External Data Representation (XDR) data as used in " "some remote procedure call systems." msgstr "" -# 95018f5521f047e9ae2dc90c3f4e746b -#: ../src/Doc/library/array.rst:271 -msgid "`The Numerical Python Documentation `_" +#: library/array.rst:272 +msgid "The Numerical Python Documentation" msgstr "" # 65274f7f9007494a89b980c7b62b1026 -#: ../src/Doc/library/array.rst:272 +#: library/array.rst:272 msgid "" "The Numeric Python extension (NumPy) defines another array type; see http://" "www.numpy.org/ for further information about Numerical Python." msgstr "" # 1098d2ac23994735bce7066e2ab7a042 -#: ../src/Doc/library/ast.rst:2 +#: library/ast.rst:2 msgid ":mod:`ast` --- Abstract Syntax Trees" msgstr "" +#: library/ast.rst:10 +msgid "The low-level ``_ast`` module containing only the node classes." +msgstr "" + +#: library/ast.rst:13 +msgid "The high-level ``ast`` module containing all helpers." +msgstr "" + # 5f6531bbb33041a89bc205563b3049e0 -#: ../src/Doc/library/ast.rst:16 +#: library/ast.rst:16 msgid "**Source code:** :source:`Lib/ast.py`" msgstr "" -#: ../src/Doc/library/ast.rst:20 +#: library/ast.rst:20 msgid "" "The :mod:`ast` module helps Python applications to process trees of the " "Python abstract syntax grammar. The abstract syntax itself might change " @@ -5396,7 +5357,7 @@ msgid "" "what the current grammar looks like." msgstr "" -#: ../src/Doc/library/ast.rst:25 +#: library/ast.rst:25 msgid "" "An abstract syntax tree can be generated by passing :data:`ast." "PyCF_ONLY_AST` as a flag to the :func:`compile` built-in function, or using " @@ -5406,11 +5367,11 @@ msgid "" "func:`compile` function." msgstr "" -#: ../src/Doc/library/ast.rst:33 +#: library/ast.rst:33 msgid "Node classes" msgstr "" -#: ../src/Doc/library/ast.rst:37 +#: library/ast.rst:37 msgid "" "This is the base of all AST node classes. The actual node classes are " "derived from the :file:`Parser/Python.asdl` file, which is reproduced :ref:" @@ -5418,7 +5379,7 @@ msgid "" "and re-exported in :mod:`ast`." msgstr "" -#: ../src/Doc/library/ast.rst:42 +#: library/ast.rst:42 msgid "" "There is one class defined for each left-hand side symbol in the abstract " "grammar (for example, :class:`ast.stmt` or :class:`ast.expr`). In addition, " @@ -5429,20 +5390,20 @@ msgid "" "abstract: only instances of specific constructor nodes are ever created." msgstr "" -#: ../src/Doc/library/ast.rst:52 +#: library/ast.rst:52 msgid "" "Each concrete class has an attribute :attr:`_fields` which gives the names " "of all child nodes." msgstr "" -#: ../src/Doc/library/ast.rst:55 +#: library/ast.rst:55 msgid "" "Each instance of a concrete class has one attribute for each child node, of " "the type as defined in the grammar. For example, :class:`ast.BinOp` " "instances have an attribute :attr:`left` of type :class:`ast.expr`." msgstr "" -#: ../src/Doc/library/ast.rst:59 +#: library/ast.rst:59 msgid "" "If these attributes are marked as optional in the grammar (using a question " "mark), the value might be ``None``. If the attributes can have zero-or-more " @@ -5451,7 +5412,7 @@ msgid "" "compiling an AST with :func:`compile`." msgstr "" -#: ../src/Doc/library/ast.rst:68 +#: library/ast.rst:68 msgid "" "Instances of :class:`ast.expr` and :class:`ast.stmt` subclasses have :attr:" "`lineno` and :attr:`col_offset` attributes. The :attr:`lineno` is the line " @@ -5460,66 +5421,73 @@ msgid "" "node. The UTF-8 offset is recorded because the parser uses UTF-8 internally." msgstr "" -#: ../src/Doc/library/ast.rst:75 +#: library/ast.rst:75 msgid "" "The constructor of a class :class:`ast.T` parses its arguments as follows:" msgstr "" -#: ../src/Doc/library/ast.rst:77 +#: library/ast.rst:77 msgid "" "If there are positional arguments, there must be as many as there are items " "in :attr:`T._fields`; they will be assigned as attributes of these names." msgstr "" -#: ../src/Doc/library/ast.rst:79 +#: library/ast.rst:79 msgid "" "If there are keyword arguments, they will set the attributes of the same " "names to the given values." msgstr "" -#: ../src/Doc/library/ast.rst:82 +#: library/ast.rst:82 msgid "" "For example, to create and populate an :class:`ast.UnaryOp` node, you could " "use ::" msgstr "" -#: ../src/Doc/library/ast.rst:94 +#: library/ast.rst:94 msgid "or the more compact ::" msgstr "" -#: ../src/Doc/library/ast.rst:108 +#: library/ast.rst:99 +msgid "" +"The constructor as explained above was added. In Python 2.5 nodes had to be " +"created by calling the class constructor without arguments and setting the " +"attributes afterwards." +msgstr "" + +#: library/ast.rst:108 msgid "Abstract Grammar" msgstr "" -#: ../src/Doc/library/ast.rst:110 +#: library/ast.rst:110 msgid "" "The module defines a string constant ``__version__`` which is the decimal " "Subversion revision number of the file shown below." msgstr "" -#: ../src/Doc/library/ast.rst:113 +#: library/ast.rst:113 msgid "The abstract grammar is currently defined as follows:" msgstr "" -#: ../src/Doc/library/ast.rst:119 +#: library/ast.rst:119 msgid ":mod:`ast` Helpers" msgstr "" -#: ../src/Doc/library/ast.rst:123 +#: library/ast.rst:123 msgid "" "Apart from the node classes, :mod:`ast` module defines these utility " "functions and classes for traversing abstract syntax trees:" msgstr "" # 08013003d2db4326b4c301d8ae1a1340 -#: ../src/Doc/library/ast.rst:128 +#: library/ast.rst:128 msgid "" "Parse the source into an AST node. Equivalent to ``compile(source, " "filename, mode, ast.PyCF_ONLY_AST)``." msgstr "" # 49c533dca4a5451aa18e88abf1722d7c -#: ../src/Doc/library/ast.rst:134 +#: library/ast.rst:134 msgid "" "Safely evaluate an expression node or a Unicode or *Latin-1* encoded string " "containing a Python literal or container display. The string or node " @@ -5528,7 +5496,7 @@ msgid "" msgstr "" # d61dfbbaac774c1aa1d5caf75031a46a -#: ../src/Doc/library/ast.rst:139 +#: library/ast.rst:139 msgid "" "This can be used for safely evaluating strings containing Python values from " "untrusted sources without the need to parse the values oneself. It is not " @@ -5536,7 +5504,7 @@ msgid "" "operators or indexing." msgstr "" -#: ../src/Doc/library/ast.rst:147 +#: library/ast.rst:147 msgid "" "Return the docstring of the given *node* (which must be a :class:" "`FunctionDef`, :class:`ClassDef` or :class:`Module` node), or ``None`` if it " @@ -5544,7 +5512,7 @@ msgid "" "with :func:`inspect.cleandoc`." msgstr "" -#: ../src/Doc/library/ast.rst:155 +#: library/ast.rst:155 msgid "" "When you compile a node tree with :func:`compile`, the compiler expects :" "attr:`lineno` and :attr:`col_offset` attributes for every node that supports " @@ -5553,82 +5521,82 @@ msgid "" "the values of the parent node. It works recursively starting at *node*." msgstr "" -#: ../src/Doc/library/ast.rst:164 +#: library/ast.rst:164 msgid "" "Increment the line number of each node in the tree starting at *node* by " "*n*. This is useful to \"move code\" to a different location in a file." msgstr "" -#: ../src/Doc/library/ast.rst:170 +#: library/ast.rst:170 msgid "" "Copy source location (:attr:`lineno` and :attr:`col_offset`) from *old_node* " "to *new_node* if possible, and return *new_node*." msgstr "" -#: ../src/Doc/library/ast.rst:176 +#: library/ast.rst:176 msgid "" "Yield a tuple of ``(fieldname, value)`` for each field in ``node._fields`` " "that is present on *node*." msgstr "" -#: ../src/Doc/library/ast.rst:182 +#: library/ast.rst:182 msgid "" "Yield all direct child nodes of *node*, that is, all fields that are nodes " "and all items of fields that are lists of nodes." msgstr "" # fb5a6b487b7843aea84a89b4a88df87a -#: ../src/Doc/library/ast.rst:188 +#: library/ast.rst:188 msgid "" "Recursively yield all descendant nodes in the tree starting at *node* " "(including *node* itself), in no specified order. This is useful if you " "only want to modify nodes in place and don't care about the context." msgstr "" -#: ../src/Doc/library/ast.rst:195 +#: library/ast.rst:195 msgid "" "A node visitor base class that walks the abstract syntax tree and calls a " "visitor function for every node found. This function may return a value " "which is forwarded by the :meth:`visit` method." msgstr "" -#: ../src/Doc/library/ast.rst:199 +#: library/ast.rst:199 msgid "" "This class is meant to be subclassed, with the subclass adding visitor " "methods." msgstr "" -#: ../src/Doc/library/ast.rst:204 +#: library/ast.rst:204 msgid "" "Visit a node. The default implementation calls the method called :samp:" "`self.visit_{classname}` where *classname* is the name of the node class, " "or :meth:`generic_visit` if that method doesn't exist." msgstr "" -#: ../src/Doc/library/ast.rst:210 +#: library/ast.rst:210 msgid "This visitor calls :meth:`visit` on all children of the node." msgstr "" -#: ../src/Doc/library/ast.rst:212 +#: library/ast.rst:212 msgid "" "Note that child nodes of nodes that have a custom visitor method won't be " "visited unless the visitor calls :meth:`generic_visit` or visits them itself." msgstr "" -#: ../src/Doc/library/ast.rst:216 +#: library/ast.rst:216 msgid "" "Don't use the :class:`NodeVisitor` if you want to apply changes to nodes " "during traversal. For this a special visitor exists (:class:" "`NodeTransformer`) that allows modifications." msgstr "" -#: ../src/Doc/library/ast.rst:223 +#: library/ast.rst:223 msgid "" "A :class:`NodeVisitor` subclass that walks the abstract syntax tree and " "allows modification of nodes." msgstr "" -#: ../src/Doc/library/ast.rst:226 +#: library/ast.rst:226 msgid "" "The :class:`NodeTransformer` will walk the AST and use the return value of " "the visitor methods to replace or remove the old node. If the return value " @@ -5637,32 +5605,32 @@ msgid "" "may be the original node in which case no replacement takes place." msgstr "" -#: ../src/Doc/library/ast.rst:232 +#: library/ast.rst:232 msgid "" "Here is an example transformer that rewrites all occurrences of name lookups " "(``foo``) to ``data['foo']``::" msgstr "" -#: ../src/Doc/library/ast.rst:244 +#: library/ast.rst:244 msgid "" "Keep in mind that if the node you're operating on has child nodes you must " "either transform the child nodes yourself or call the :meth:`generic_visit` " "method for the node first." msgstr "" -#: ../src/Doc/library/ast.rst:248 +#: library/ast.rst:248 msgid "" "For nodes that were part of a collection of statements (that applies to all " "statement nodes), the visitor may also return a list of nodes rather than " "just a single node." msgstr "" -#: ../src/Doc/library/ast.rst:252 +#: library/ast.rst:252 msgid "Usually you use the transformer like this::" msgstr "" # 1d27953004264eb6bd1326512d929827 -#: ../src/Doc/library/ast.rst:259 +#: library/ast.rst:259 msgid "" "Return a formatted dump of the tree in *node*. This is mainly useful for " "debugging purposes. The returned string will show the names and the values " @@ -5672,16 +5640,16 @@ msgid "" "*include_attributes* can be set to ``True``." msgstr "" -#: ../src/Doc/library/asynchat.rst:2 +#: library/asynchat.rst:2 msgid ":mod:`asynchat` --- Asynchronous socket command/response handler" msgstr "" # c916c16b13f042b08a7377585e6975eb -#: ../src/Doc/library/asynchat.rst:9 +#: library/asynchat.rst:9 msgid "**Source code:** :source:`Lib/asynchat.py`" msgstr "" -#: ../src/Doc/library/asynchat.rst:13 +#: library/asynchat.rst:13 msgid "" "This module builds on the :mod:`asyncore` infrastructure, simplifying " "asynchronous clients and servers and making it easier to handle protocols " @@ -5696,7 +5664,7 @@ msgid "" "connection requests." msgstr "" -#: ../src/Doc/library/asynchat.rst:28 +#: library/asynchat.rst:28 msgid "" "This class is an abstract subclass of :class:`asyncore.dispatcher`. To make " "practical use of the code you must subclass :class:`async_chat`, providing " @@ -5706,7 +5674,7 @@ msgid "" msgstr "" # 50c7b8dfe9464d03ac750021ee3ba1fe -#: ../src/Doc/library/asynchat.rst:35 +#: library/asynchat.rst:35 msgid "" "Like :class:`asyncore.dispatcher`, :class:`async_chat` defines a set of " "events that are generated by an analysis of socket conditions after a :c:" @@ -5715,21 +5683,21 @@ msgid "" "with no action on the part of the programmer." msgstr "" -#: ../src/Doc/library/asynchat.rst:41 +#: library/asynchat.rst:41 msgid "" "Two class attributes can be modified, to improve performance, or possibly " "even to conserve memory." msgstr "" -#: ../src/Doc/library/asynchat.rst:47 +#: library/asynchat.rst:47 msgid "The asynchronous input buffer size (default ``4096``)." msgstr "" -#: ../src/Doc/library/asynchat.rst:52 +#: library/asynchat.rst:52 msgid "The asynchronous output buffer size (default ``4096``)." msgstr "" -#: ../src/Doc/library/asynchat.rst:54 +#: library/asynchat.rst:54 msgid "" "Unlike :class:`asyncore.dispatcher`, :class:`async_chat` allows you to " "define a first-in-first-out queue (fifo) of *producers*. A producer need " @@ -5744,7 +5712,7 @@ msgid "" "remote endpoint." msgstr "" -#: ../src/Doc/library/asynchat.rst:67 +#: library/asynchat.rst:67 msgid "" "To build a functioning :class:`async_chat` subclass your input methods :" "meth:`collect_incoming_data` and :meth:`found_terminator` must handle the " @@ -5752,26 +5720,26 @@ msgid "" "below." msgstr "" -#: ../src/Doc/library/asynchat.rst:75 +#: library/asynchat.rst:75 msgid "" "Pushes a ``None`` on to the producer fifo. When this producer is popped off " "the fifo it causes the channel to be closed." msgstr "" -#: ../src/Doc/library/asynchat.rst:81 +#: library/asynchat.rst:81 msgid "" "Called with *data* holding an arbitrary amount of received data. The " "default method, which must be overridden, raises a :exc:" "`NotImplementedError` exception." msgstr "" -#: ../src/Doc/library/asynchat.rst:88 +#: library/asynchat.rst:88 msgid "" "In emergencies this method will discard any data held in the input and/or " "output buffers and the producer fifo." msgstr "" -#: ../src/Doc/library/asynchat.rst:94 +#: library/asynchat.rst:94 msgid "" "Called when the incoming data stream matches the termination condition set " "by :meth:`set_terminator`. The default method, which must be overridden, " @@ -5779,11 +5747,11 @@ msgid "" "should be available via an instance attribute." msgstr "" -#: ../src/Doc/library/asynchat.rst:102 +#: library/asynchat.rst:102 msgid "Returns the current terminator for the channel." msgstr "" -#: ../src/Doc/library/asynchat.rst:107 +#: library/asynchat.rst:107 msgid "" "Pushes data on to the channel's fifo to ensure its transmission. This is all " "you need to do to have the channel write the data out to the network, " @@ -5791,7 +5759,7 @@ msgid "" "implement encryption and chunking, for example." msgstr "" -#: ../src/Doc/library/asynchat.rst:115 +#: library/asynchat.rst:115 msgid "" "Takes a producer object and adds it to the producer fifo associated with the " "channel. When all currently-pushed producers have been exhausted the " @@ -5799,65 +5767,63 @@ msgid "" "and send the data to the remote endpoint." msgstr "" -#: ../src/Doc/library/asynchat.rst:123 +#: library/asynchat.rst:123 msgid "" "Sets the terminating condition to be recognized on the channel. ``term`` " "may be any of three types of value, corresponding to three different ways to " "handle incoming protocol data." msgstr "" -#: ../src/Doc/library/asynchat.rst:128 +#: library/asynchat.rst:128 msgid "term" msgstr "" -#: ../src/Doc/library/asynchat.rst:128 ../src/Doc/library/asyncore.rst:84 -#: ../src/Doc/library/curses.rst:736 ../src/Doc/library/inspect.rst:40 -#: ../src/Doc/library/logging.rst:619 ../src/Doc/library/logging.rst:944 -#: ../src/Doc/library/ossaudiodev.rst:185 -#: ../src/Doc/library/ossaudiodev.rst:239 ../src/Doc/library/ttk.rst:107 -#: ../src/Doc/library/turtle.rst:2179 ../src/Doc/library/warnings.rst:63 +#: library/asynchat.rst:128 library/asyncore.rst:84 library/curses.rst:736 +#: library/inspect.rst:40 library/logging.rst:622 library/logging.rst:950 +#: library/ossaudiodev.rst:185 library/ossaudiodev.rst:239 library/ttk.rst:107 +#: library/turtle.rst:2179 library/warnings.rst:63 msgid "Description" msgstr "" -#: ../src/Doc/library/asynchat.rst:130 +#: library/asynchat.rst:130 msgid "*string*" msgstr "" -#: ../src/Doc/library/asynchat.rst:130 +#: library/asynchat.rst:130 msgid "" "Will call :meth:`found_terminator` when the string is found in the input " "stream" msgstr "" -#: ../src/Doc/library/asynchat.rst:133 +#: library/asynchat.rst:133 msgid "*integer*" msgstr "" -#: ../src/Doc/library/asynchat.rst:133 +#: library/asynchat.rst:133 msgid "" "Will call :meth:`found_terminator` when the indicated number of characters " "have been received" msgstr "" -#: ../src/Doc/library/asynchat.rst:137 ../src/Doc/library/stdtypes.rst:52 +#: library/asynchat.rst:137 library/stdtypes.rst:52 msgid "``None``" msgstr "" -#: ../src/Doc/library/asynchat.rst:137 +#: library/asynchat.rst:137 msgid "The channel continues to collect data forever" msgstr "" -#: ../src/Doc/library/asynchat.rst:141 +#: library/asynchat.rst:141 msgid "" "Note that any data following the terminator will be available for reading by " "the channel after :meth:`found_terminator` is called." msgstr "" -#: ../src/Doc/library/asynchat.rst:146 +#: library/asynchat.rst:146 msgid "asynchat - Auxiliary Classes" msgstr "" -#: ../src/Doc/library/asynchat.rst:150 +#: library/asynchat.rst:150 msgid "" "A :class:`fifo` holding data which has been pushed by the application but " "not yet popped for writing to the channel. A :class:`fifo` is a list used " @@ -5866,31 +5832,31 @@ msgid "" "written to the channel." msgstr "" -#: ../src/Doc/library/asynchat.rst:159 +#: library/asynchat.rst:159 msgid "Returns ``True`` if and only if the fifo is empty." msgstr "" -#: ../src/Doc/library/asynchat.rst:164 +#: library/asynchat.rst:164 msgid "Returns the least-recently :meth:`push`\\ ed item from the fifo." msgstr "" -#: ../src/Doc/library/asynchat.rst:169 +#: library/asynchat.rst:169 msgid "" "Adds the given data (which may be a string or a producer object) to the " "producer fifo." msgstr "" -#: ../src/Doc/library/asynchat.rst:175 +#: library/asynchat.rst:175 msgid "" "If the fifo is not empty, returns ``True, first()``, deleting the popped " "item. Returns ``False, None`` for an empty fifo." msgstr "" -#: ../src/Doc/library/asynchat.rst:182 +#: library/asynchat.rst:182 msgid "asynchat Example" msgstr "" -#: ../src/Doc/library/asynchat.rst:184 +#: library/asynchat.rst:184 msgid "" "The following partial example shows how HTTP requests can be read with :" "class:`async_chat`. A web server might create an :class:" @@ -5900,7 +5866,7 @@ msgid "" "read." msgstr "" -#: ../src/Doc/library/asynchat.rst:191 +#: library/asynchat.rst:191 msgid "" "Once the headers have been read, if the request is of type POST (indicating " "that further data are present in the input stream) then the ``Content-Length:" @@ -5908,29 +5874,29 @@ msgid "" "data from the channel." msgstr "" -#: ../src/Doc/library/asynchat.rst:196 +#: library/asynchat.rst:196 msgid "" "The :meth:`handle_request` method is called once all relevant input has been " "marshalled, after setting the channel terminator to ``None`` to ensure that " "any extraneous data sent by the web client are ignored. ::" msgstr "" -#: ../src/Doc/library/asyncore.rst:2 +#: library/asyncore.rst:2 msgid ":mod:`asyncore` --- Asynchronous socket handler" msgstr "" # e826fd3b12f046bba41e271c983e0d31 -#: ../src/Doc/library/asyncore.rst:12 +#: library/asyncore.rst:12 msgid "**Source code:** :source:`Lib/asyncore.py`" msgstr "" -#: ../src/Doc/library/asyncore.rst:16 +#: library/asyncore.rst:16 msgid "" "This module provides the basic infrastructure for writing asynchronous " "socket service clients and servers." msgstr "" -#: ../src/Doc/library/asyncore.rst:19 +#: library/asyncore.rst:19 msgid "" "There are only two ways to have a program on a single processor do \"more " "than one thing at a time.\" Multi-threaded programming is the simplest and " @@ -5943,7 +5909,7 @@ msgid "" msgstr "" # e523d5bd55b4449ebff32b31085fa373 -#: ../src/Doc/library/asyncore.rst:28 +#: library/asyncore.rst:28 msgid "" "If your operating system supports the :c:func:`select` system call in its I/" "O library (and nearly all do), then you can use it to juggle multiple " @@ -5957,7 +5923,7 @@ msgid "" "module is invaluable." msgstr "" -#: ../src/Doc/library/asyncore.rst:39 +#: library/asyncore.rst:39 msgid "" "The basic idea behind both modules is to create one or more network " "*channels*, instances of class :class:`asyncore.dispatcher` and :class:" @@ -5966,7 +5932,7 @@ msgid "" "*map*." msgstr "" -#: ../src/Doc/library/asyncore.rst:45 +#: library/asyncore.rst:45 msgid "" "Once the initial channel(s) is(are) created, calling the :func:`loop` " "function activates channel service, which continues until the last channel " @@ -5975,7 +5941,7 @@ msgid "" msgstr "" # 10e0871c70cd40e6a5901ec77f086575 -#: ../src/Doc/library/asyncore.rst:52 +#: library/asyncore.rst:52 msgid "" "Enter a polling loop that terminates after count passes or all open channels " "have been closed. All arguments are optional. The *count* parameter " @@ -5987,7 +5953,7 @@ msgid "" "`~select.select` (the default is ``False``)." msgstr "" -#: ../src/Doc/library/asyncore.rst:61 +#: library/asyncore.rst:61 msgid "" "The *map* parameter is a dictionary whose items are the channels to watch. " "As channels are closed they are deleted from their map. If *map* is " @@ -5996,7 +5962,7 @@ msgid "" "be mixed in the map." msgstr "" -#: ../src/Doc/library/asyncore.rst:70 +#: library/asyncore.rst:70 msgid "" "The :class:`dispatcher` class is a thin wrapper around a low-level socket " "object. To make it more useful, it has a few methods for event-handling " @@ -6004,7 +5970,7 @@ msgid "" "as a normal non-blocking socket object." msgstr "" -#: ../src/Doc/library/asyncore.rst:75 +#: library/asyncore.rst:75 msgid "" "The firing of low-level events at certain times or in certain connection " "states tells the asynchronous loop that certain higher-level events have " @@ -6015,36 +5981,36 @@ msgid "" "events are:" msgstr "" -#: ../src/Doc/library/asyncore.rst:84 +#: library/asyncore.rst:84 msgid "Event" msgstr "" -#: ../src/Doc/library/asyncore.rst:86 +#: library/asyncore.rst:86 msgid "``handle_connect()``" msgstr "" -#: ../src/Doc/library/asyncore.rst:86 +#: library/asyncore.rst:86 msgid "Implied by the first read or write event" msgstr "" -#: ../src/Doc/library/asyncore.rst:89 +#: library/asyncore.rst:89 msgid "``handle_close()``" msgstr "" -#: ../src/Doc/library/asyncore.rst:89 +#: library/asyncore.rst:89 msgid "Implied by a read event with no data available" msgstr "" -#: ../src/Doc/library/asyncore.rst:92 +#: library/asyncore.rst:92 msgid "``handle_accept()``" msgstr "" -#: ../src/Doc/library/asyncore.rst:92 +#: library/asyncore.rst:92 msgid "Implied by a read event on a listening socket" msgstr "" # 07bfc23251e64ac987aa0e59652b1a27 -#: ../src/Doc/library/asyncore.rst:96 +#: library/asyncore.rst:96 msgid "" "During asynchronous processing, each mapped channel's :meth:`readable` and :" "meth:`writable` methods are used to determine whether the channel's socket " @@ -6052,56 +6018,56 @@ msgid "" "`poll`\\ ed for read and write events." msgstr "" -#: ../src/Doc/library/asyncore.rst:101 +#: library/asyncore.rst:101 msgid "" "Thus, the set of channel events is larger than the basic socket events. The " "full set of methods that can be overridden in your subclass follows:" msgstr "" -#: ../src/Doc/library/asyncore.rst:107 +#: library/asyncore.rst:107 msgid "" "Called when the asynchronous loop detects that a :meth:`read` call on the " "channel's socket will succeed." msgstr "" -#: ../src/Doc/library/asyncore.rst:113 +#: library/asyncore.rst:113 msgid "" "Called when the asynchronous loop detects that a writable socket can be " "written. Often this method will implement the necessary buffering for " "performance. For example::" msgstr "" -#: ../src/Doc/library/asyncore.rst:124 +#: library/asyncore.rst:124 msgid "" "Called when there is out of band (OOB) data for a socket connection. This " "will almost never happen, as OOB is tenuously supported and rarely used." msgstr "" -#: ../src/Doc/library/asyncore.rst:130 +#: library/asyncore.rst:130 msgid "" "Called when the active opener's socket actually makes a connection. Might " "send a \"welcome\" banner, or initiate a protocol negotiation with the " "remote endpoint, for example." msgstr "" -#: ../src/Doc/library/asyncore.rst:137 +#: library/asyncore.rst:137 msgid "Called when the socket is closed." msgstr "" -#: ../src/Doc/library/asyncore.rst:142 +#: library/asyncore.rst:142 msgid "" "Called when an exception is raised and not otherwise handled. The default " "version prints a condensed traceback." msgstr "" -#: ../src/Doc/library/asyncore.rst:148 +#: library/asyncore.rst:148 msgid "" "Called on listening channels (passive openers) when a connection can be " "established with a new remote endpoint that has issued a :meth:`connect` " "call for the local endpoint." msgstr "" -#: ../src/Doc/library/asyncore.rst:155 +#: library/asyncore.rst:155 msgid "" "Called each time around the asynchronous loop to determine whether a " "channel's socket should be added to the list on which read events can " @@ -6109,7 +6075,7 @@ msgid "" "default, all channels will be interested in read events." msgstr "" -#: ../src/Doc/library/asyncore.rst:163 +#: library/asyncore.rst:163 msgid "" "Called each time around the asynchronous loop to determine whether a " "channel's socket should be added to the list on which write events can " @@ -6117,51 +6083,51 @@ msgid "" "default, all channels will be interested in write events." msgstr "" -#: ../src/Doc/library/asyncore.rst:169 +#: library/asyncore.rst:169 msgid "" "In addition, each channel delegates or extends many of the socket methods. " "Most of these are nearly identical to their socket partners." msgstr "" -#: ../src/Doc/library/asyncore.rst:175 +#: library/asyncore.rst:175 msgid "" "This is identical to the creation of a normal socket, and will use the same " "options for creation. Refer to the :mod:`socket` documentation for " "information on creating sockets." msgstr "" -#: ../src/Doc/library/asyncore.rst:182 +#: library/asyncore.rst:182 msgid "" "As with the normal socket object, *address* is a tuple with the first " "element the host to connect to, and the second the port number." msgstr "" -#: ../src/Doc/library/asyncore.rst:188 +#: library/asyncore.rst:188 msgid "Send *data* to the remote end-point of the socket." msgstr "" -#: ../src/Doc/library/asyncore.rst:193 +#: library/asyncore.rst:193 msgid "" "Read at most *buffer_size* bytes from the socket's remote end-point. An " "empty string implies that the channel has been closed from the other end." msgstr "" # b6b7adb85d274359af32a652ed38f734 -#: ../src/Doc/library/asyncore.rst:196 +#: library/asyncore.rst:196 msgid "" "Note that :meth:`recv` may raise :exc:`socket.error` with :data:`~errno." "EAGAIN` or :data:`~errno.EWOULDBLOCK`, even though :func:`select.select` or :" "func:`select.poll` has reported the socket ready for reading." msgstr "" -#: ../src/Doc/library/asyncore.rst:204 +#: library/asyncore.rst:204 msgid "" "Listen for connections made to the socket. The *backlog* argument specifies " "the maximum number of queued connections and should be at least 1; the " "maximum value is system-dependent (usually 5)." msgstr "" -#: ../src/Doc/library/asyncore.rst:211 +#: library/asyncore.rst:211 msgid "" "Bind the socket to *address*. The socket must not already be bound. (The " "format of *address* depends on the address family --- refer to the :mod:" @@ -6171,7 +6137,7 @@ msgid "" msgstr "" # 7c3f734d82df4160b1c157d580a4f6f0 -#: ../src/Doc/library/asyncore.rst:220 +#: library/asyncore.rst:220 msgid "" "Accept a connection. The socket must be bound to an address and listening " "for connections. The return value can be either ``None`` or a pair ``(conn, " @@ -6182,7 +6148,7 @@ msgid "" "this event and keep listening for further incoming connections." msgstr "" -#: ../src/Doc/library/asyncore.rst:232 +#: library/asyncore.rst:232 msgid "" "Close the socket. All future operations on the socket object will fail. The " "remote end-point will receive no more data (after queued data is flushed). " @@ -6190,7 +6156,7 @@ msgid "" msgstr "" # 4dfaeaaaab18417f9955dde54c845e87 -#: ../src/Doc/library/asyncore.rst:239 +#: library/asyncore.rst:239 msgid "" "A :class:`dispatcher` subclass which adds simple buffered output capability, " "useful for simple clients. For more sophisticated usage use :class:`asynchat." @@ -6198,7 +6164,7 @@ msgid "" msgstr "" # 51fb82287bd442f8935c9d5a376bfb05 -#: ../src/Doc/library/asyncore.rst:245 +#: library/asyncore.rst:245 msgid "" "A file_dispatcher takes a file descriptor or file object along with an " "optional map argument and wraps it for use with the :c:func:`poll` or :c:" @@ -6207,7 +6173,7 @@ msgid "" "`file_wrapper` constructor. Availability: UNIX." msgstr "" -#: ../src/Doc/library/asyncore.rst:253 +#: library/asyncore.rst:253 msgid "" "A file_wrapper takes an integer file descriptor and calls :func:`os.dup` to " "duplicate the handle so that the original handle may be closed independently " @@ -6215,39 +6181,39 @@ msgid "" "socket for use by the :class:`file_dispatcher` class. Availability: UNIX." msgstr "" -#: ../src/Doc/library/asyncore.rst:262 +#: library/asyncore.rst:262 msgid "asyncore Example basic HTTP client" msgstr "" -#: ../src/Doc/library/asyncore.rst:264 +#: library/asyncore.rst:264 msgid "" "Here is a very basic HTTP client that uses the :class:`dispatcher` class to " "implement its socket handling::" msgstr "" # 61230d45585c4b1cbec5ab96df1f9145 -#: ../src/Doc/library/asyncore.rst:300 +#: library/asyncore.rst:300 msgid "asyncore Example basic echo server" msgstr "" # 42862180362640c089f5c5378f314359 -#: ../src/Doc/library/asyncore.rst:302 +#: library/asyncore.rst:302 msgid "" "Here is a basic echo server that uses the :class:`dispatcher` class to " "accept connections and dispatches the incoming connections to a handler::" msgstr "" -#: ../src/Doc/library/atexit.rst:2 +#: library/atexit.rst:2 msgid ":mod:`atexit` --- Exit handlers" msgstr "" # 98e474d8d102441886bcfdee7d114520 -#: ../src/Doc/library/atexit.rst:12 +#: library/atexit.rst:12 msgid "**Source code:** :source:`Lib/atexit.py`" msgstr "" # 3eedecbfcc6c4c9e85c2e2d69c267e87 -#: ../src/Doc/library/atexit.rst:16 +#: library/atexit.rst:16 msgid "" "The :mod:`atexit` module defines a single function to register cleanup " "functions. Functions thus registered are automatically executed upon normal " @@ -6258,7 +6224,7 @@ msgid "" msgstr "" # a223adafba934f8984323bb8937ff145 -#: ../src/Doc/library/atexit.rst:23 +#: library/atexit.rst:23 msgid "" "**Note:** The functions registered via this module are not called when the " "program is killed by a signal not handled by Python, when a Python fatal " @@ -6266,14 +6232,14 @@ msgid "" msgstr "" # da364f37178741a785cd194702beaf32 -#: ../src/Doc/library/atexit.rst:29 +#: library/atexit.rst:29 msgid "" "This is an alternate interface to the functionality provided by the :func:" "`sys.exitfunc` variable." msgstr "" # 0a5ab4cd43c54049ac95e3b9393a047b -#: ../src/Doc/library/atexit.rst:32 +#: library/atexit.rst:32 msgid "" "Note: This module is unlikely to work correctly when used with other code " "that sets ``sys.exitfunc``. In particular, other core Python modules are " @@ -6285,7 +6251,7 @@ msgid "" msgstr "" # dd69d32d2adb4f2dbe84baa35f9e93d3 -#: ../src/Doc/library/atexit.rst:42 +#: library/atexit.rst:42 msgid "" "Register *func* as a function to be executed at termination. Any optional " "arguments that are to be passed to *func* must be passed as arguments to :" @@ -6293,7 +6259,7 @@ msgid "" "more than once." msgstr "" -#: ../src/Doc/library/atexit.rst:47 +#: library/atexit.rst:47 msgid "" "At normal program termination (for instance, if :func:`sys.exit` is called " "or the main module's execution completes), all functions registered are " @@ -6302,7 +6268,7 @@ msgid "" "be cleaned up later." msgstr "" -#: ../src/Doc/library/atexit.rst:53 +#: library/atexit.rst:53 msgid "" "If an exception is raised during execution of the exit handlers, a traceback " "is printed (unless :exc:`SystemExit` is raised) and the exception " @@ -6310,22 +6276,29 @@ msgid "" "last exception to be raised is re-raised." msgstr "" -# 52b20436bbb74f4d8ec0742491e621e2 -#: ../src/Doc/library/atexit.rst:64 -msgid "Module :mod:`readline`" +#: library/atexit.rst:58 +msgid "" +"This function now returns *func*, which makes it possible to use it as a " +"decorator." msgstr "" -#: ../src/Doc/library/atexit.rst:66 +# b52b28e1e7004a19a892c486d9c8d479 +#: library/atexit.rst:65 +#, fuzzy +msgid "Module readline" +msgstr "Threads" + +#: library/atexit.rst:66 msgid "" "Useful example of :mod:`atexit` to read and write :mod:`readline` history " "files." msgstr "" -#: ../src/Doc/library/atexit.rst:72 +#: library/atexit.rst:72 msgid ":mod:`atexit` Example" msgstr "" -#: ../src/Doc/library/atexit.rst:74 +#: library/atexit.rst:74 msgid "" "The following simple example demonstrates how a module can initialize a " "counter from a file when it is imported and save the counter's updated value " @@ -6333,27 +6306,27 @@ msgid "" "making an explicit call into this module at termination. ::" msgstr "" -#: ../src/Doc/library/atexit.rst:94 +#: library/atexit.rst:94 msgid "" "Positional and keyword arguments may also be passed to :func:`register` to " "be passed along to the registered function when it is called::" msgstr "" -#: ../src/Doc/library/atexit.rst:106 +#: library/atexit.rst:106 msgid "Usage as a :term:`decorator`::" msgstr "" # 244b55d2fb754c94924ca4a71e9e6b12 -#: ../src/Doc/library/atexit.rst:114 +#: library/atexit.rst:114 msgid "This only works with functions that can be called without arguments." msgstr "" -#: ../src/Doc/library/audioop.rst:3 +#: library/audioop.rst:3 msgid ":mod:`audioop` --- Manipulate raw audio data" msgstr "" # cd8c2025e4ff4d2fa073867b9250eb28 -#: ../src/Doc/library/audioop.rst:9 +#: library/audioop.rst:9 msgid "" "The :mod:`audioop` module contains some useful operations on sound " "fragments. It operates on sound fragments consisting of signed integer " @@ -6362,30 +6335,29 @@ msgid "" "items are integers, unless specified otherwise." msgstr "" -#: ../src/Doc/library/audioop.rst:21 +#: library/audioop.rst:21 msgid "" "This module provides support for a-LAW, u-LAW and Intel/DVI ADPCM encodings." msgstr "" -#: ../src/Doc/library/audioop.rst:25 +#: library/audioop.rst:25 msgid "" "A few of the more complicated operations only take 16-bit samples, otherwise " "the sample size (in bytes) is always a parameter of the operation." msgstr "" -#: ../src/Doc/library/audioop.rst:28 ../src/Doc/library/imageop.rst:16 -#: ../src/Doc/library/imgfile.rst:20 +#: library/audioop.rst:28 library/imageop.rst:16 library/imgfile.rst:20 msgid "The module defines the following variables and functions:" msgstr "" -#: ../src/Doc/library/audioop.rst:33 +#: library/audioop.rst:33 msgid "" "This exception is raised on all errors, such as unknown number of bytes per " "sample, etc." msgstr "" # 5ad29e08702e467fbad92ca24e7d174a -#: ../src/Doc/library/audioop.rst:39 +#: library/audioop.rst:39 msgid "" "Return a fragment which is the addition of the two samples passed as " "parameters. *width* is the sample width in bytes, either ``1``, ``2`` or " @@ -6393,43 +6365,43 @@ msgid "" "in case of overflow." msgstr "" -#: ../src/Doc/library/audioop.rst:46 +#: library/audioop.rst:46 msgid "" "Decode an Intel/DVI ADPCM coded fragment to a linear fragment. See the " "description of :func:`lin2adpcm` for details on ADPCM coding. Return a tuple " "``(sample, newstate)`` where the sample has the width specified in *width*." msgstr "" -#: ../src/Doc/library/audioop.rst:53 +#: library/audioop.rst:53 msgid "" "Convert sound fragments in a-LAW encoding to linearly encoded sound " "fragments. a-LAW encoding always uses 8 bits samples, so *width* refers only " "to the sample width of the output fragment here." msgstr "" -#: ../src/Doc/library/audioop.rst:62 +#: library/audioop.rst:62 msgid "Return the average over all samples in the fragment." msgstr "" -#: ../src/Doc/library/audioop.rst:67 +#: library/audioop.rst:67 msgid "" "Return the average peak-peak value over all samples in the fragment. No " "filtering is done, so the usefulness of this routine is questionable." msgstr "" # d900f195dec043ddafa27711adcf7197 -#: ../src/Doc/library/audioop.rst:73 +#: library/audioop.rst:73 msgid "" "Return a fragment that is the original fragment with a bias added to each " "sample. Samples wrap around in case of overflow." msgstr "" -#: ../src/Doc/library/audioop.rst:79 +#: library/audioop.rst:79 msgid "" "Return the number of zero crossings in the fragment passed as an argument." msgstr "" -#: ../src/Doc/library/audioop.rst:84 +#: library/audioop.rst:84 msgid "" "Return a factor *F* such that ``rms(add(fragment, mul(reference, -F)))`` is " "minimal, i.e., return the factor with which you should multiply *reference* " @@ -6437,11 +6409,11 @@ msgid "" "both contain 2-byte samples." msgstr "" -#: ../src/Doc/library/audioop.rst:89 +#: library/audioop.rst:89 msgid "The time taken by this routine is proportional to ``len(fragment)``." msgstr "" -#: ../src/Doc/library/audioop.rst:94 +#: library/audioop.rst:94 msgid "" "Try to match *reference* as well as possible to a portion of *fragment* " "(which should be the longer fragment). This is (conceptually) done by " @@ -6452,22 +6424,22 @@ msgid "" "*factor* is the (floating-point) factor as per :func:`findfactor`." msgstr "" -#: ../src/Doc/library/audioop.rst:105 +#: library/audioop.rst:105 msgid "" "Search *fragment* for a slice of length *length* samples (not bytes!) with " "maximum energy, i.e., return *i* for which ``rms(fragment[i*2:(i" "+length)*2])`` is maximal. The fragments should both contain 2-byte samples." msgstr "" -#: ../src/Doc/library/audioop.rst:109 +#: library/audioop.rst:109 msgid "The routine takes time proportional to ``len(fragment)``." msgstr "" -#: ../src/Doc/library/audioop.rst:114 +#: library/audioop.rst:114 msgid "Return the value of sample *index* from the fragment." msgstr "" -#: ../src/Doc/library/audioop.rst:119 +#: library/audioop.rst:119 msgid "" "Convert samples to 4 bit Intel/DVI ADPCM encoding. ADPCM coding is an " "adaptive coding scheme, whereby each 4 bit number is the difference between " @@ -6476,7 +6448,7 @@ msgid "" "standard." msgstr "" -#: ../src/Doc/library/audioop.rst:124 +#: library/audioop.rst:124 msgid "" "*state* is a tuple containing the state of the coder. The coder returns a " "tuple ``(adpcmfrag, newstate)``, and the *newstate* should be passed to the " @@ -6485,7 +6457,7 @@ msgid "" "per byte." msgstr "" -#: ../src/Doc/library/audioop.rst:132 +#: library/audioop.rst:132 msgid "" "Convert samples in the audio fragment to a-LAW encoding and return this as a " "Python string. a-LAW is an audio encoding format whereby you get a dynamic " @@ -6493,24 +6465,24 @@ msgid "" "audio hardware, among others." msgstr "" -#: ../src/Doc/library/audioop.rst:142 +#: library/audioop.rst:142 msgid "Convert samples between 1-, 2- and 4-byte formats." msgstr "" -#: ../src/Doc/library/audioop.rst:146 +#: library/audioop.rst:146 msgid "" "In some audio formats, such as .WAV files, 16 and 32 bit samples are signed, " "but 8 bit samples are unsigned. So when converting to 8 bit wide samples " "for these formats, you need to also add 128 to the result::" msgstr "" -#: ../src/Doc/library/audioop.rst:153 +#: library/audioop.rst:153 msgid "" "The same, in reverse, has to be applied when converting from 8 to 16 or 32 " "bit width samples." msgstr "" -#: ../src/Doc/library/audioop.rst:159 +#: library/audioop.rst:159 msgid "" "Convert samples in the audio fragment to u-LAW encoding and return this as a " "Python string. u-LAW is an audio encoding format whereby you get a dynamic " @@ -6518,34 +6490,34 @@ msgid "" "audio hardware, among others." msgstr "" -#: ../src/Doc/library/audioop.rst:167 +#: library/audioop.rst:167 msgid "" "Return the maximum of the *absolute value* of all samples in a fragment." msgstr "" -#: ../src/Doc/library/audioop.rst:172 +#: library/audioop.rst:172 msgid "Return the maximum peak-peak value in the sound fragment." msgstr "" -#: ../src/Doc/library/audioop.rst:177 +#: library/audioop.rst:177 msgid "" "Return a tuple consisting of the minimum and maximum values of all samples " "in the sound fragment." msgstr "" # 5b9ab4673a464c1d975880e2c67a9003 -#: ../src/Doc/library/audioop.rst:183 +#: library/audioop.rst:183 msgid "" "Return a fragment that has all samples in the original fragment multiplied " "by the floating-point value *factor*. Samples are truncated in case of " "overflow." msgstr "" -#: ../src/Doc/library/audioop.rst:189 +#: library/audioop.rst:189 msgid "Convert the frame rate of the input fragment." msgstr "" -#: ../src/Doc/library/audioop.rst:191 +#: library/audioop.rst:191 msgid "" "*state* is a tuple containing the state of the converter. The converter " "returns a tuple ``(newfragment, newstate)``, and *newstate* should be passed " @@ -6553,47 +6525,47 @@ msgid "" "as the state." msgstr "" -#: ../src/Doc/library/audioop.rst:195 +#: library/audioop.rst:195 msgid "" "The *weightA* and *weightB* arguments are parameters for a simple digital " "filter and default to ``1`` and ``0`` respectively." msgstr "" -#: ../src/Doc/library/audioop.rst:201 +#: library/audioop.rst:201 msgid "Reverse the samples in a fragment and returns the modified fragment." msgstr "" -#: ../src/Doc/library/audioop.rst:206 +#: library/audioop.rst:206 msgid "" "Return the root-mean-square of the fragment, i.e. ``sqrt(sum(S_i^2)/n)``." msgstr "" -#: ../src/Doc/library/audioop.rst:208 +#: library/audioop.rst:208 msgid "This is a measure of the power in an audio signal." msgstr "" -#: ../src/Doc/library/audioop.rst:213 +#: library/audioop.rst:213 msgid "" "Convert a stereo fragment to a mono fragment. The left channel is " "multiplied by *lfactor* and the right channel by *rfactor* before adding the " "two channels to give a mono signal." msgstr "" -#: ../src/Doc/library/audioop.rst:220 +#: library/audioop.rst:220 msgid "" "Generate a stereo fragment from a mono fragment. Each pair of samples in " "the stereo fragment are computed from the mono sample, whereby left channel " "samples are multiplied by *lfactor* and right channel samples by *rfactor*." msgstr "" -#: ../src/Doc/library/audioop.rst:227 +#: library/audioop.rst:227 msgid "" "Convert sound fragments in u-LAW encoding to linearly encoded sound " "fragments. u-LAW encoding always uses 8 bits samples, so *width* refers only " "to the sample width of the output fragment here." msgstr "" -#: ../src/Doc/library/audioop.rst:231 +#: library/audioop.rst:231 msgid "" "Note that operations such as :func:`.mul` or :func:`.max` make no " "distinction between mono and stereo fragments, i.e. all samples are treated " @@ -6603,7 +6575,7 @@ msgid "" msgstr "" # 5be56dbf354249fbb7bf85495560da24 -#: ../src/Doc/library/audioop.rst:245 +#: library/audioop.rst:245 msgid "" "If you use the ADPCM coder to build network packets and you want your " "protocol to be stateless (i.e. to be able to tolerate packet loss) you " @@ -6615,14 +6587,14 @@ msgid "" "index) in 8." msgstr "" -#: ../src/Doc/library/audioop.rst:253 +#: library/audioop.rst:253 msgid "" "The ADPCM coders have never been tried against other ADPCM coders, only " "against themselves. It could well be that I misinterpreted the standards in " "which case they will not be interoperable with the respective standards." msgstr "" -#: ../src/Doc/library/audioop.rst:257 +#: library/audioop.rst:257 msgid "" "The :func:`find\\*` routines might look a bit funny at first sight. They are " "primarily meant to do echo cancellation. A reasonably fast way to do this " @@ -6631,12 +6603,12 @@ msgid "" msgstr "" # 2a06600532814419974fd8201de83da7 -#: ../src/Doc/library/autogil.rst:3 +#: library/autogil.rst:3 msgid ":mod:`autoGIL` --- Global Interpreter Lock handling in event loops" msgstr "" # dcca4fabc6d84b0387801d85c5a252d7 -#: ../src/Doc/library/autogil.rst:12 +#: library/autogil.rst:12 msgid "" "The :mod:`autoGIL` module provides a function :func:`installAutoGIL` that " "automatically locks and unlocks Python's :term:`Global Interpreter Lock` " @@ -6644,14 +6616,14 @@ msgid "" msgstr "" # 19f5fa50d26044eda990e74b12459161 -#: ../src/Doc/library/autogil.rst:23 +#: library/autogil.rst:23 msgid "" "Raised if the observer callback cannot be installed, for example because the " "current thread does not have a run loop." msgstr "" # 8749e92608834515906f9fe3211f050e -#: ../src/Doc/library/autogil.rst:29 +#: library/autogil.rst:29 msgid "" "Install an observer callback in the event loop (CFRunLoop) for the current " "thread, that will lock and unlock the Global Interpreter Lock (GIL) at " @@ -6660,15 +6632,15 @@ msgid "" msgstr "" # 41476dfdbe0441c4bafcf03ef293b810 -#: ../src/Doc/library/autogil.rst:34 +#: library/autogil.rst:34 msgid "Availability: OSX 10.1 or later." msgstr "" -#: ../src/Doc/library/base64.rst:2 +#: library/base64.rst:2 msgid ":mod:`base64` --- RFC 3548: Base16, Base32, Base64 Data Encodings" msgstr "" -#: ../src/Doc/library/base64.rst:12 +#: library/base64.rst:12 msgid "" "This module provides data encoding and decoding as specified in :rfc:`3548`. " "This standard defines the Base16, Base32, and Base64 algorithms for encoding " @@ -6678,24 +6650,25 @@ msgid "" "program." msgstr "" -#: ../src/Doc/library/base64.rst:18 +#: library/base64.rst:18 msgid "" "There are two interfaces provided by this module. The modern interface " -"supports encoding and decoding string objects using all three alphabets. " -"The legacy interface provides for encoding and decoding to and from file-" -"like objects as well as strings, but only using the Base64 standard alphabet." +"supports encoding and decoding string objects using all three :rfc:`3548` " +"defined alphabets (normal, URL-safe, and filesystem-safe). The legacy " +"interface provides for encoding and decoding to and from file-like objects " +"as well as strings, but only using the Base64 standard alphabet." msgstr "" # d502c3c513d14b06938cadcb77da765f -#: ../src/Doc/library/base64.rst:23 +#: library/base64.rst:24 msgid "The modern interface, which was introduced in Python 2.4, provides:" msgstr "" -#: ../src/Doc/library/base64.rst:28 +#: library/base64.rst:29 msgid "Encode a string use Base64." msgstr "" -#: ../src/Doc/library/base64.rst:30 +#: library/base64.rst:31 msgid "" "*s* is the string to encode. Optional *altchars* must be a string of at " "least length 2 (additional characters are ignored) which specifies an " @@ -6704,67 +6677,67 @@ msgid "" "default is ``None``, for which the standard Base64 alphabet is used." msgstr "" -#: ../src/Doc/library/base64.rst:36 +#: library/base64.rst:37 msgid "The encoded string is returned." msgstr "" -#: ../src/Doc/library/base64.rst:41 +#: library/base64.rst:42 msgid "Decode a Base64 encoded string." msgstr "" -#: ../src/Doc/library/base64.rst:43 +#: library/base64.rst:44 msgid "" "*s* is the string to decode. Optional *altchars* must be a string of at " "least length 2 (additional characters are ignored) which specifies the " "alternative alphabet used instead of the ``+`` and ``/`` characters." msgstr "" -#: ../src/Doc/library/base64.rst:47 ../src/Doc/library/base64.rst:116 +#: library/base64.rst:48 msgid "" -"The decoded string is returned. A :exc:`TypeError` is raised if *s* were " -"incorrectly padded or if there are non-alphabet characters present in the " -"string." +"The decoded string is returned. A :exc:`TypeError` is raised if *s* is " +"incorrectly padded. Non-base64-alphabet characters are discarded prior to " +"the padding check." msgstr "" -#: ../src/Doc/library/base64.rst:54 +#: library/base64.rst:55 msgid "Encode string *s* using the standard Base64 alphabet." msgstr "" -#: ../src/Doc/library/base64.rst:59 +#: library/base64.rst:60 msgid "Decode string *s* using the standard Base64 alphabet." msgstr "" -#: ../src/Doc/library/base64.rst:64 +#: library/base64.rst:65 msgid "" "Encode string *s* using a URL-safe alphabet, which substitutes ``-`` instead " "of ``+`` and ``_`` instead of ``/`` in the standard Base64 alphabet. The " "result can still contain ``=``." msgstr "" -#: ../src/Doc/library/base64.rst:71 +#: library/base64.rst:72 msgid "" "Decode string *s* using a URL-safe alphabet, which substitutes ``-`` instead " "of ``+`` and ``_`` instead of ``/`` in the standard Base64 alphabet." msgstr "" -#: ../src/Doc/library/base64.rst:77 +#: library/base64.rst:78 msgid "" "Encode a string using Base32. *s* is the string to encode. The encoded " "string is returned." msgstr "" -#: ../src/Doc/library/base64.rst:83 +#: library/base64.rst:84 msgid "Decode a Base32 encoded string." msgstr "" -#: ../src/Doc/library/base64.rst:85 ../src/Doc/library/base64.rst:112 +#: library/base64.rst:86 library/base64.rst:113 msgid "" "*s* is the string to decode. Optional *casefold* is a flag specifying " "whether a lowercase alphabet is acceptable as input. For security purposes, " "the default is ``False``." msgstr "" -#: ../src/Doc/library/base64.rst:89 +#: library/base64.rst:90 msgid "" ":rfc:`3548` allows for optional mapping of the digit 0 (zero) to the letter " "O (oh), and for optional mapping of the digit 1 (one) to either the letter I " @@ -6776,31 +6749,38 @@ msgid "" msgstr "" # 498afefce28e4e77b701403bc355b19b -#: ../src/Doc/library/base64.rst:96 +#: library/base64.rst:97 msgid "" "The decoded string is returned. A :exc:`TypeError` is raised if *s* is " "incorrectly padded or if there are non-alphabet characters present in the " "string." msgstr "" -#: ../src/Doc/library/base64.rst:103 +#: library/base64.rst:104 msgid "Encode a string using Base16." msgstr "" -#: ../src/Doc/library/base64.rst:105 +#: library/base64.rst:106 msgid "*s* is the string to encode. The encoded string is returned." msgstr "" -#: ../src/Doc/library/base64.rst:110 +#: library/base64.rst:111 msgid "Decode a Base16 encoded string." msgstr "" -#: ../src/Doc/library/base64.rst:120 +#: library/base64.rst:117 +msgid "" +"The decoded string is returned. A :exc:`TypeError` is raised if *s* were " +"incorrectly padded or if there are non-alphabet characters present in the " +"string." +msgstr "" + +#: library/base64.rst:121 msgid "The legacy interface:" msgstr "" # 0472ce53a49c45169a0beebc9fee717e -#: ../src/Doc/library/base64.rst:125 +#: library/base64.rst:126 msgid "" "Decode the contents of the *input* file and write the resulting binary data " "to the *output* file. *input* and *output* must either be file objects or " @@ -6809,14 +6789,14 @@ msgid "" msgstr "" # 1c1c1582d6ab497ebfc3d06ee45e855c -#: ../src/Doc/library/base64.rst:133 +#: library/base64.rst:134 msgid "" "Decode the string *s*, which must contain one or more lines of base64 " "encoded data, and return a string containing the resulting binary data." msgstr "" # c4addd41ad864c07a64a9724d21cad9d -#: ../src/Doc/library/base64.rst:139 +#: library/base64.rst:140 msgid "" "Encode the contents of the *input* file and write the resulting base64 " "encoded data to the *output* file. *input* and *output* must either be file " @@ -6826,7 +6806,7 @@ msgid "" msgstr "" # 71d730f7037443c8987cceb5254543e6 -#: ../src/Doc/library/base64.rst:148 +#: library/base64.rst:149 msgid "" "Encode the string *s*, which can contain arbitrary binary data, and return a " "string containing one or more lines of base64-encoded data. :func:" @@ -6834,45 +6814,39 @@ msgid "" "encoded data always including an extra trailing newline (``'\\n'``)." msgstr "" -#: ../src/Doc/library/base64.rst:153 +#: library/base64.rst:154 msgid "An example usage of the module:" msgstr "" -# b1cbf3bb884944b48d3c172ffde1a7f8 -# f045f58619a94c05886085ac7bf00019 -# d7a619ddddb24e8f96a7d9ce75ca41c6 -#: ../src/Doc/library/base64.rst:166 ../src/Doc/library/binhex.rst:46 -#: ../src/Doc/library/uu.rst:59 -msgid "Module :mod:`binascii`" -msgstr "" +#: library/base64.rst:168 library/binhex.rst:47 library/uu.rst:60 +#, fuzzy +msgid "Module binascii" +msgstr "Modules" -#: ../src/Doc/library/base64.rst:167 ../src/Doc/library/binhex.rst:48 -#: ../src/Doc/library/uu.rst:61 +#: library/base64.rst:168 library/binhex.rst:48 library/uu.rst:61 msgid "" "Support module containing ASCII-to-binary and binary-to-ASCII conversions." msgstr "" -# 0abc59c0a1d64172a18c4eb0c3ae8113 -#: ../src/Doc/library/base64.rst:169 +#: library/base64.rst:171 msgid "" -":rfc:`1521` - MIME (Multipurpose Internet Mail Extensions) Part One: " -"Mechanisms for Specifying and Describing the Format of Internet Message " -"Bodies" +"RFC 1521 - MIME (Multipurpose Internet Mail Extensions) Part One: Mechanisms " +"for Specifying and Describing the Format of Internet Message Bodies" msgstr "" -#: ../src/Doc/library/base64.rst:170 +#: library/base64.rst:171 msgid "" "Section 5.2, \"Base64 Content-Transfer-Encoding,\" provides the definition " "of the base64 encoding." msgstr "" # e3f9c603463f4d72aefb0679e568a150 -#: ../src/Doc/library/basehttpserver.rst:2 +#: library/basehttpserver.rst:2 msgid ":mod:`BaseHTTPServer` --- Basic HTTP server" msgstr "" # ed726506723645a692f78356b73c49ca -#: ../src/Doc/library/basehttpserver.rst:8 +#: library/basehttpserver.rst:8 msgid "" "The :mod:`BaseHTTPServer` module has been merged into :mod:`http.server` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -6880,12 +6854,12 @@ msgid "" msgstr "" # f5a89d70dd044fe5bfd909776fc96f12 -#: ../src/Doc/library/basehttpserver.rst:21 +#: library/basehttpserver.rst:21 msgid "**Source code:** :source:`Lib/BaseHTTPServer.py`" msgstr "" # ddf171e0d95f4da28b26b7053543012e -#: ../src/Doc/library/basehttpserver.rst:25 +#: library/basehttpserver.rst:25 msgid "" "This module defines two classes for implementing HTTP servers (Web servers). " "Usually, this module isn't used directly, but is used as a basis for " @@ -6894,7 +6868,7 @@ msgid "" msgstr "" # 56446abe72c4481a93c3881598affa06 -#: ../src/Doc/library/basehttpserver.rst:30 +#: library/basehttpserver.rst:30 msgid "" "The first class, :class:`HTTPServer`, is a :class:`SocketServer.TCPServer` " "subclass, and therefore implements the :class:`SocketServer.BaseServer` " @@ -6902,7 +6876,7 @@ msgid "" "requests to a handler. Code to create and run the server looks like this::" msgstr "" -#: ../src/Doc/library/basehttpserver.rst:44 +#: library/basehttpserver.rst:44 msgid "" "This class builds on the :class:`TCPServer` class by storing the server " "address as instance variables named :attr:`server_name` and :attr:" @@ -6911,7 +6885,7 @@ msgid "" msgstr "" # 6b1711a6e578422d8dcf48e8c437e1ac -#: ../src/Doc/library/basehttpserver.rst:52 +#: library/basehttpserver.rst:52 msgid "" "This class is used to handle the HTTP requests that arrive at the server. By " "itself, it cannot respond to any actual HTTP requests; it must be subclassed " @@ -6920,7 +6894,7 @@ msgid "" "and methods for use by subclasses." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:58 +#: library/basehttpserver.rst:58 msgid "" "The handler will parse the request and the headers, then call a method " "specific to the request type. The method name is constructed from the " @@ -6930,69 +6904,69 @@ msgid "" "override or extend the :meth:`__init__` method." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:65 +#: library/basehttpserver.rst:65 msgid ":class:`BaseHTTPRequestHandler` has the following instance variables:" msgstr "" -#: ../src/Doc/library/basehttpserver.rst:70 +#: library/basehttpserver.rst:70 msgid "" "Contains a tuple of the form ``(host, port)`` referring to the client's " "address." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:76 +#: library/basehttpserver.rst:76 msgid "Contains the server instance." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:81 +#: library/basehttpserver.rst:81 msgid "Contains the command (request type). For example, ``'GET'``." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:86 +#: library/basehttpserver.rst:86 msgid "Contains the request path." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:91 +#: library/basehttpserver.rst:91 msgid "" "Contains the version string from the request. For example, ``'HTTP/1.0'``." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:96 +#: library/basehttpserver.rst:96 msgid "" "Holds an instance of the class specified by the :attr:`MessageClass` class " "variable. This instance parses and manages the headers in the HTTP request." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:103 +#: library/basehttpserver.rst:103 msgid "" "Contains an input stream, positioned at the start of the optional input data." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:109 +#: library/basehttpserver.rst:109 msgid "" "Contains the output stream for writing a response back to the client. Proper " "adherence to the HTTP protocol must be used when writing to this stream." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:114 +#: library/basehttpserver.rst:114 msgid ":class:`BaseHTTPRequestHandler` has the following class variables:" msgstr "" -#: ../src/Doc/library/basehttpserver.rst:119 +#: library/basehttpserver.rst:119 msgid "" "Specifies the server software version. You may want to override this. The " "format is multiple whitespace-separated strings, where each string is of the " "form name[/version]. For example, ``'BaseHTTP/0.2'``." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:126 +#: library/basehttpserver.rst:126 msgid "" "Contains the Python system version, in a form usable by the :attr:" "`version_string` method and the :attr:`server_version` class variable. For " "example, ``'Python/1.4'``." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:133 +#: library/basehttpserver.rst:133 msgid "" "Specifies a format string for building an error response to the client. It " "uses parenthesized, keyed format specifiers, so the format operand must be a " @@ -7003,13 +6977,17 @@ msgid "" "*responses* class variable." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:144 +#: library/basehttpserver.rst:144 msgid "" "Specifies the Content-Type HTTP header of error responses sent to the " "client. The default value is ``'text/html'``." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:153 +#: library/basehttpserver.rst:147 +msgid "Previously, the content type was always ``'text/html'``." +msgstr "" + +#: library/basehttpserver.rst:153 msgid "" "This specifies the HTTP protocol version used in responses. If set to " "``'HTTP/1.1'``, the server will permit HTTP persistent connections; however, " @@ -7019,14 +6997,14 @@ msgid "" msgstr "" # cd1446a9eaaf455ca28dd532520f7f41 -#: ../src/Doc/library/basehttpserver.rst:164 +#: library/basehttpserver.rst:164 msgid "" "Specifies a :class:`rfc822.Message`\\ -like class to parse HTTP headers. " "Typically, this is not overridden, and it defaults to :class:`mimetools." "Message`." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:171 +#: library/basehttpserver.rst:171 msgid "" "This variable contains a mapping of error code integers to two-element " "tuples containing a short and long message. For example, ``{code: " @@ -7035,24 +7013,24 @@ msgid "" "(see the :attr:`error_message_format` class variable)." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:178 +#: library/basehttpserver.rst:178 msgid "A :class:`BaseHTTPRequestHandler` instance has the following methods:" msgstr "" -#: ../src/Doc/library/basehttpserver.rst:183 +#: library/basehttpserver.rst:183 msgid "" "Calls :meth:`handle_one_request` once (or, if persistent connections are " "enabled, multiple times) to handle incoming HTTP requests. You should never " "need to override it; instead, implement appropriate :meth:`do_\\*` methods." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:191 +#: library/basehttpserver.rst:191 msgid "" "This method will parse and dispatch the request to the appropriate :meth:`do_" "\\*` method. You should never need to override it." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:197 +#: library/basehttpserver.rst:197 msgid "" "Sends and logs a complete error reply to the client. The numeric *code* " "specifies the HTTP error code, with *message* as optional, more specific " @@ -7060,7 +7038,7 @@ msgid "" "the :attr:`error_message_format` class variable." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:205 +#: library/basehttpserver.rst:205 msgid "" "Sends a response header and logs the accepted request. The HTTP response " "line is sent, followed by *Server* and *Date* headers. The values for these " @@ -7068,25 +7046,25 @@ msgid "" "`date_time_string` methods, respectively." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:213 +#: library/basehttpserver.rst:213 msgid "" "Writes a specific HTTP header to the output stream. *keyword* should specify " "the header keyword, with *value* specifying its value." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:219 +#: library/basehttpserver.rst:219 msgid "" "Sends a blank line, indicating the end of the HTTP headers in the response." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:225 +#: library/basehttpserver.rst:225 msgid "" "Logs an accepted (successful) request. *code* should specify the numeric " "HTTP code associated with the response. If a size of the response is " "available, then it should be passed as the *size* parameter." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:232 +#: library/basehttpserver.rst:232 msgid "" "Logs an error when a request cannot be fulfilled. By default, it passes the " "message to :meth:`log_message`, so it takes the same arguments (*format* and " @@ -7094,7 +7072,7 @@ msgid "" msgstr "" # cad3fdd384184abab8a937c17190ff29 -#: ../src/Doc/library/basehttpserver.rst:239 +#: library/basehttpserver.rst:239 msgid "" "Logs an arbitrary message to ``sys.stderr``. This is typically overridden to " "create custom error logging mechanisms. The *format* argument is a standard " @@ -7103,82 +7081,92 @@ msgid "" "and current date and time are prefixed to every message logged." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:248 +#: library/basehttpserver.rst:248 msgid "" "Returns the server software's version string. This is a combination of the :" "attr:`server_version` and :attr:`sys_version` class variables." msgstr "" # 4da7a47a164e446fbbe22673055ba5fa -#: ../src/Doc/library/basehttpserver.rst:254 +#: library/basehttpserver.rst:254 msgid "" "Returns the date and time given by *timestamp* (which must be in the format " "returned by :func:`time.time`), formatted for a message header. If " "*timestamp* is omitted, it uses the current date and time." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:258 +#: library/basehttpserver.rst:258 msgid "The result looks like ``'Sun, 06 Nov 1994 08:49:37 GMT'``." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:266 +#: library/basehttpserver.rst:260 +msgid "The *timestamp* parameter." +msgstr "" + +#: library/basehttpserver.rst:266 msgid "Returns the current date and time, formatted for logging." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:271 +#: library/basehttpserver.rst:271 msgid "" "Returns the client address, formatted for logging. A name lookup is " "performed on the client's IP address." msgstr "" -#: ../src/Doc/library/basehttpserver.rst:276 +#: library/basehttpserver.rst:276 msgid "More examples" msgstr "" # f03d23d727944d97a0b65de71ec0c427 -#: ../src/Doc/library/basehttpserver.rst:278 +#: library/basehttpserver.rst:278 msgid "" "To create a server that doesn't run forever, but until some condition is " "fulfilled::" msgstr "" -# 25cb16cc1208466fa4313627631c487e -#: ../src/Doc/library/basehttpserver.rst:296 -msgid "Module :mod:`CGIHTTPServer`" +#: library/basehttpserver.rst:297 +msgid "Module CGIHTTPServer" msgstr "" # d46fb190145b489e8643cf5cf35940ba -#: ../src/Doc/library/basehttpserver.rst:297 +#: library/basehttpserver.rst:297 msgid "Extended request handler that supports CGI scripts." msgstr "" -# 923fbd8ca632411daa3bc393a359ea63 -#: ../src/Doc/library/basehttpserver.rst:299 -msgid "Module :mod:`SimpleHTTPServer`" +#: library/basehttpserver.rst:300 +msgid "Module SimpleHTTPServer" msgstr "" # 32a82dc3fad147e8844c06ba439b2cac -#: ../src/Doc/library/basehttpserver.rst:300 +#: library/basehttpserver.rst:300 msgid "" "Basic request handler that limits response to files actually under the " "document root." msgstr "" # b9059cdacff3480e90553f4611debbf7 -#: ../src/Doc/library/bastion.rst:3 +#: library/bastion.rst:3 msgid ":mod:`Bastion` --- Restricting access to objects" msgstr "" +#: library/bastion.rst:9 +msgid "The :mod:`Bastion` module has been removed in Python 3." +msgstr "" + +#: library/bastion.rst:15 library/rexec.rst:11 +msgid "Disabled module." +msgstr "" + # 8f6a5e5861ae49b19609afb695d18b90 # ec5d138ea3374f8c91ec46758b0a8468 -#: ../src/Doc/library/bastion.rst:20 ../src/Doc/library/rexec.rst:16 +#: library/bastion.rst:20 library/rexec.rst:16 msgid "" "The documentation has been left in place to help in reading old code that " "uses the module." msgstr "" # f9bec350524f48e3bf64e97baedf7dcf -#: ../src/Doc/library/bastion.rst:23 +#: library/bastion.rst:23 msgid "" "According to the dictionary, a bastion is \"a fortified area or position\", " "or \"something that is considered a stronghold.\" It's a suitable name for " @@ -7189,7 +7177,7 @@ msgid "" msgstr "" # efde441dd732420789a13e92f7836077 -#: ../src/Doc/library/bastion.rst:39 +#: library/bastion.rst:39 msgid "" "Protect the object *object*, returning a bastion for the object. Any " "attempt to access one of the object's attributes will have to be approved by " @@ -7198,7 +7186,7 @@ msgid "" msgstr "" # 5a5fb89c96664f0687492d2e034e29ad -#: ../src/Doc/library/bastion.rst:44 +#: library/bastion.rst:44 msgid "" "If present, *filter* must be a function that accepts a string containing an " "attribute name, and returns true if access to that attribute will be " @@ -7210,7 +7198,7 @@ msgid "" msgstr "" # 1ad3ed5b77c4483abbc5ab6c066893b6 -#: ../src/Doc/library/bastion.rst:51 +#: library/bastion.rst:51 msgid "" "*class*, if present, should be a subclass of :class:`BastionClass`; see the " "code in :file:`bastion.py` for the details. Overriding the default :class:" @@ -7218,7 +7206,7 @@ msgid "" msgstr "" # c72d446ab05b43b5a98a233bfae3d842 -#: ../src/Doc/library/bastion.rst:58 +#: library/bastion.rst:58 msgid "" "Class which actually implements bastion objects. This is the default class " "used by :func:`Bastion`. The *getfunc* parameter is a function which " @@ -7228,40 +7216,40 @@ msgid "" "`BastionClass` instance." msgstr "" -#: ../src/Doc/library/bdb.rst:2 +#: library/bdb.rst:2 msgid ":mod:`bdb` --- Debugger framework" msgstr "" # 0c5e76743983447b82b5e7599c179088 -#: ../src/Doc/library/bdb.rst:7 +#: library/bdb.rst:7 msgid "**Source code:** :source:`Lib/bdb.py`" msgstr "" -#: ../src/Doc/library/bdb.rst:11 +#: library/bdb.rst:11 msgid "" "The :mod:`bdb` module handles basic debugger functions, like setting " "breakpoints or managing execution via the debugger." msgstr "" -#: ../src/Doc/library/bdb.rst:14 ../src/Doc/library/webbrowser.rst:43 +#: library/bdb.rst:14 library/webbrowser.rst:43 msgid "The following exception is defined:" msgstr "" -#: ../src/Doc/library/bdb.rst:18 +#: library/bdb.rst:18 msgid "Exception raised by the :class:`Bdb` class for quitting the debugger." msgstr "" -#: ../src/Doc/library/bdb.rst:21 +#: library/bdb.rst:21 msgid "The :mod:`bdb` module also defines two classes:" msgstr "" -#: ../src/Doc/library/bdb.rst:25 +#: library/bdb.rst:25 msgid "" "This class implements temporary breakpoints, ignore counts, disabling and " "(re-)enabling, and conditionals." msgstr "" -#: ../src/Doc/library/bdb.rst:28 +#: library/bdb.rst:28 msgid "" "Breakpoints are indexed by number through a list called :attr:`bpbynumber` " "and by ``(file, line)`` pairs through :attr:`bplist`. The former points to " @@ -7269,7 +7257,7 @@ msgid "" "of such instances since there may be more than one breakpoint per line." msgstr "" -#: ../src/Doc/library/bdb.rst:33 +#: library/bdb.rst:33 msgid "" "When creating a breakpoint, its associated filename should be in canonical " "form. If a *funcname* is defined, a breakpoint hit will be counted when the " @@ -7277,65 +7265,65 @@ msgid "" "counts a hit." msgstr "" -#: ../src/Doc/library/bdb.rst:38 +#: library/bdb.rst:38 msgid ":class:`Breakpoint` instances have the following methods:" msgstr "" -#: ../src/Doc/library/bdb.rst:42 +#: library/bdb.rst:42 msgid "" "Delete the breakpoint from the list associated to a file/line. If it is the " "last breakpoint in that position, it also deletes the entry for the file/" "line." msgstr "" -#: ../src/Doc/library/bdb.rst:49 +#: library/bdb.rst:49 msgid "Mark the breakpoint as enabled." msgstr "" -#: ../src/Doc/library/bdb.rst:54 +#: library/bdb.rst:54 msgid "Mark the breakpoint as disabled." msgstr "" -#: ../src/Doc/library/bdb.rst:59 +#: library/bdb.rst:59 msgid "Print all the information about the breakpoint:" msgstr "" -#: ../src/Doc/library/bdb.rst:61 +#: library/bdb.rst:61 msgid "The breakpoint number." msgstr "" -#: ../src/Doc/library/bdb.rst:62 +#: library/bdb.rst:62 msgid "If it is temporary or not." msgstr "" -#: ../src/Doc/library/bdb.rst:63 +#: library/bdb.rst:63 msgid "Its file,line position." msgstr "" -#: ../src/Doc/library/bdb.rst:64 +#: library/bdb.rst:64 msgid "The condition that causes a break." msgstr "" -#: ../src/Doc/library/bdb.rst:65 +#: library/bdb.rst:65 msgid "If it must be ignored the next N times." msgstr "" -#: ../src/Doc/library/bdb.rst:66 +#: library/bdb.rst:66 msgid "The breakpoint hit count." msgstr "" -#: ../src/Doc/library/bdb.rst:71 +#: library/bdb.rst:71 msgid "The :class:`Bdb` class acts as a generic Python debugger base class." msgstr "" -#: ../src/Doc/library/bdb.rst:73 +#: library/bdb.rst:73 msgid "" "This class takes care of the details of the trace facility; a derived class " "should implement user interaction. The standard debugger class (:class:`pdb." "Pdb`) is an example." msgstr "" -#: ../src/Doc/library/bdb.rst:77 +#: library/bdb.rst:77 msgid "" "The *skip* argument, if given, must be an iterable of glob-style module name " "patterns. The debugger will not step into frames that originate in a module " @@ -7344,86 +7332,90 @@ msgid "" "globals." msgstr "" -#: ../src/Doc/library/bdb.rst:86 +#: library/bdb.rst:83 library/pdb.rst:154 +msgid "The *skip* argument." +msgstr "" + +#: library/bdb.rst:86 msgid "" "The following methods of :class:`Bdb` normally don't need to be overridden." msgstr "" -#: ../src/Doc/library/bdb.rst:90 +#: library/bdb.rst:90 msgid "" "Auxiliary method for getting a filename in a canonical form, that is, as a " "case-normalized (on case-insensitive filesystems) absolute path, stripped of " "surrounding angle brackets." msgstr "" -#: ../src/Doc/library/bdb.rst:96 +#: library/bdb.rst:96 msgid "" "Set the :attr:`botframe`, :attr:`stopframe`, :attr:`returnframe` and :attr:" "`quitting` attributes with values ready to start debugging." msgstr "" -#: ../src/Doc/library/bdb.rst:101 +#: library/bdb.rst:101 msgid "" "This function is installed as the trace function of debugged frames. Its " "return value is the new trace function (in most cases, that is, itself)." msgstr "" -#: ../src/Doc/library/bdb.rst:104 +#: library/bdb.rst:104 msgid "" "The default implementation decides how to dispatch a frame, depending on the " "type of event (passed as a string) that is about to be executed. *event* can " "be one of the following:" msgstr "" -#: ../src/Doc/library/bdb.rst:108 +#: library/bdb.rst:108 msgid "``\"line\"``: A new line of code is going to be executed." msgstr "" -#: ../src/Doc/library/bdb.rst:109 +#: library/bdb.rst:109 msgid "" "``\"call\"``: A function is about to be called, or another code block " "entered." msgstr "" -#: ../src/Doc/library/bdb.rst:111 +#: library/bdb.rst:111 msgid "``\"return\"``: A function or other code block is about to return." msgstr "" -#: ../src/Doc/library/bdb.rst:112 +#: library/bdb.rst:112 msgid "``\"exception\"``: An exception has occurred." msgstr "" -#: ../src/Doc/library/bdb.rst:113 +#: library/bdb.rst:113 msgid "``\"c_call\"``: A C function is about to be called." msgstr "" -#: ../src/Doc/library/bdb.rst:114 +#: library/bdb.rst:114 msgid "``\"c_return\"``: A C function has returned." msgstr "" # 9df98327236e4ac29ecdd6acf2317dfc -#: ../src/Doc/library/bdb.rst:115 +#: library/bdb.rst:115 msgid "``\"c_exception\"``: A C function has raised an exception." msgstr "" -#: ../src/Doc/library/bdb.rst:117 +#: library/bdb.rst:117 msgid "" "For the Python events, specialized functions (see below) are called. For " "the C events, no action is taken." msgstr "" -#: ../src/Doc/library/bdb.rst:120 +#: library/bdb.rst:120 msgid "The *arg* parameter depends on the previous event." msgstr "" -#: ../src/Doc/library/bdb.rst:122 +#: library/bdb.rst:122 msgid "" "See the documentation for :func:`sys.settrace` for more information on the " "trace function. For more information on code and frame objects, refer to :" "ref:`types`." msgstr "" -#: ../src/Doc/library/bdb.rst:128 +#: library/bdb.rst:128 msgid "" "If the debugger should stop on the current line, invoke the :meth:" "`user_line` method (which should be overridden in subclasses). Raise a :exc:" @@ -7432,7 +7424,7 @@ msgid "" "`trace_dispatch` method for further tracing in that scope." msgstr "" -#: ../src/Doc/library/bdb.rst:136 +#: library/bdb.rst:136 msgid "" "If the debugger should stop on this function call, invoke the :meth:" "`user_call` method (which should be overridden in subclasses). Raise a :exc:" @@ -7441,7 +7433,7 @@ msgid "" "`trace_dispatch` method for further tracing in that scope." msgstr "" -#: ../src/Doc/library/bdb.rst:144 +#: library/bdb.rst:144 msgid "" "If the debugger should stop on this function return, invoke the :meth:" "`user_return` method (which should be overridden in subclasses). Raise a :" @@ -7450,7 +7442,7 @@ msgid "" "`trace_dispatch` method for further tracing in that scope." msgstr "" -#: ../src/Doc/library/bdb.rst:152 +#: library/bdb.rst:152 msgid "" "If the debugger should stop at this exception, invokes the :meth:" "`user_exception` method (which should be overridden in subclasses). Raise a :" @@ -7459,38 +7451,38 @@ msgid "" "`trace_dispatch` method for further tracing in that scope." msgstr "" -#: ../src/Doc/library/bdb.rst:158 +#: library/bdb.rst:158 msgid "" "Normally derived classes don't override the following methods, but they may " "if they want to redefine the definition of stopping and breakpoints." msgstr "" -#: ../src/Doc/library/bdb.rst:163 +#: library/bdb.rst:163 msgid "" "This method checks if the *frame* is somewhere below :attr:`botframe` in the " "call stack. :attr:`botframe` is the frame in which debugging started." msgstr "" -#: ../src/Doc/library/bdb.rst:168 +#: library/bdb.rst:168 msgid "" "This method checks if there is a breakpoint in the filename and line " "belonging to *frame* or, at least, in the current function. If the " "breakpoint is a temporary one, this method deletes it." msgstr "" -#: ../src/Doc/library/bdb.rst:174 +#: library/bdb.rst:174 msgid "" "This method checks if there is a breakpoint in the filename of the current " "frame." msgstr "" -#: ../src/Doc/library/bdb.rst:177 +#: library/bdb.rst:177 msgid "" "Derived classes should override these methods to gain control over debugger " "operation." msgstr "" -#: ../src/Doc/library/bdb.rst:182 +#: library/bdb.rst:182 msgid "" "This method is called from :meth:`dispatch_call` when there is the " "possibility that a break might be necessary anywhere inside the called " @@ -7498,208 +7490,208 @@ msgid "" msgstr "" # b0c4f4de98c243799e85a844374b3740 -#: ../src/Doc/library/bdb.rst:188 +#: library/bdb.rst:188 msgid "" "This method is called from :meth:`dispatch_line` when either :meth:" "`stop_here` or :meth:`break_here` yields ``True``." msgstr "" # 141739b1465442d0a5d5516404443a7e -#: ../src/Doc/library/bdb.rst:193 +#: library/bdb.rst:193 msgid "" "This method is called from :meth:`dispatch_return` when :meth:`stop_here` " "yields ``True``." msgstr "" # fd8380a34727489f8e9d991dc5c46dbd -#: ../src/Doc/library/bdb.rst:198 +#: library/bdb.rst:198 msgid "" "This method is called from :meth:`dispatch_exception` when :meth:`stop_here` " "yields ``True``." msgstr "" -#: ../src/Doc/library/bdb.rst:203 +#: library/bdb.rst:203 msgid "Handle how a breakpoint must be removed when it is a temporary one." msgstr "" -#: ../src/Doc/library/bdb.rst:205 +#: library/bdb.rst:205 msgid "This method must be implemented by derived classes." msgstr "" -#: ../src/Doc/library/bdb.rst:208 +#: library/bdb.rst:208 msgid "" "Derived classes and clients can call the following methods to affect the " "stepping state." msgstr "" -#: ../src/Doc/library/bdb.rst:213 +#: library/bdb.rst:213 msgid "Stop after one line of code." msgstr "" -#: ../src/Doc/library/bdb.rst:217 +#: library/bdb.rst:217 msgid "Stop on the next line in or below the given frame." msgstr "" -#: ../src/Doc/library/bdb.rst:221 +#: library/bdb.rst:221 msgid "Stop when returning from the given frame." msgstr "" -#: ../src/Doc/library/bdb.rst:225 +#: library/bdb.rst:225 msgid "" "Stop when the line with the line no greater than the current one is reached " -"or when returning from current frame" +"or when returning from current frame." msgstr "" -#: ../src/Doc/library/bdb.rst:230 +#: library/bdb.rst:230 msgid "" "Start debugging from *frame*. If *frame* is not specified, debugging starts " "from caller's frame." msgstr "" -#: ../src/Doc/library/bdb.rst:235 +#: library/bdb.rst:235 msgid "" "Stop only at breakpoints or when finished. If there are no breakpoints, set " "the system trace function to None." msgstr "" # 1edb27968d0444159c9cdb16bd171049 -#: ../src/Doc/library/bdb.rst:240 +#: library/bdb.rst:240 msgid "" "Set the :attr:`quitting` attribute to ``True``. This raises :exc:`BdbQuit` " "in the next call to one of the :meth:`dispatch_\\*` methods." msgstr "" -#: ../src/Doc/library/bdb.rst:244 +#: library/bdb.rst:244 msgid "" "Derived classes and clients can call the following methods to manipulate " "breakpoints. These methods return a string containing an error message if " "something went wrong, or ``None`` if all is well." msgstr "" -#: ../src/Doc/library/bdb.rst:250 +#: library/bdb.rst:250 msgid "" "Set a new breakpoint. If the *lineno* line doesn't exist for the *filename* " "passed as argument, return an error message. The *filename* should be in " "canonical form, as described in the :meth:`canonic` method." msgstr "" -#: ../src/Doc/library/bdb.rst:256 +#: library/bdb.rst:256 msgid "" "Delete the breakpoints in *filename* and *lineno*. If none were set, an " "error message is returned." msgstr "" -#: ../src/Doc/library/bdb.rst:261 +#: library/bdb.rst:261 msgid "" "Delete the breakpoint which has the index *arg* in the :attr:`Breakpoint." "bpbynumber`. If *arg* is not numeric or out of range, return an error " "message." msgstr "" -#: ../src/Doc/library/bdb.rst:267 +#: library/bdb.rst:267 msgid "" "Delete all breakpoints in *filename*. If none were set, an error message is " "returned." msgstr "" -#: ../src/Doc/library/bdb.rst:272 +#: library/bdb.rst:272 msgid "Delete all existing breakpoints." msgstr "" -#: ../src/Doc/library/bdb.rst:276 +#: library/bdb.rst:276 msgid "Check if there is a breakpoint for *lineno* of *filename*." msgstr "" -#: ../src/Doc/library/bdb.rst:280 +#: library/bdb.rst:280 msgid "" "Return all breakpoints for *lineno* in *filename*, or an empty list if none " "are set." msgstr "" -#: ../src/Doc/library/bdb.rst:285 +#: library/bdb.rst:285 msgid "Return all breakpoints in *filename*, or an empty list if none are set." msgstr "" -#: ../src/Doc/library/bdb.rst:289 +#: library/bdb.rst:289 msgid "Return all breakpoints that are set." msgstr "" -#: ../src/Doc/library/bdb.rst:292 +#: library/bdb.rst:292 msgid "" "Derived classes and clients can call the following methods to get a data " "structure representing a stack trace." msgstr "" -#: ../src/Doc/library/bdb.rst:297 +#: library/bdb.rst:297 msgid "" "Get a list of records for a frame and all higher (calling) and lower frames, " "and the size of the higher part." msgstr "" -#: ../src/Doc/library/bdb.rst:302 +#: library/bdb.rst:302 msgid "" "Return a string with information about a stack entry, identified by a " "``(frame, lineno)`` tuple:" msgstr "" -#: ../src/Doc/library/bdb.rst:305 +#: library/bdb.rst:305 msgid "The canonical form of the filename which contains the frame." msgstr "" -#: ../src/Doc/library/bdb.rst:306 +#: library/bdb.rst:306 msgid "The function name, or ``\"\"``." msgstr "" -#: ../src/Doc/library/bdb.rst:307 +#: library/bdb.rst:307 msgid "The input arguments." msgstr "" -#: ../src/Doc/library/bdb.rst:308 +#: library/bdb.rst:308 msgid "The return value." msgstr "" -#: ../src/Doc/library/bdb.rst:309 +#: library/bdb.rst:309 msgid "The line of code (if it exists)." msgstr "" -#: ../src/Doc/library/bdb.rst:312 +#: library/bdb.rst:312 msgid "" "The following two methods can be called by clients to use a debugger to " "debug a :term:`statement`, given as a string." msgstr "" # d98e5a0ff1c94969a4e3d2eec806fed2 -#: ../src/Doc/library/bdb.rst:317 +#: library/bdb.rst:317 msgid "" "Debug a statement executed via the :keyword:`exec` statement. *globals* " "defaults to :attr:`__main__.__dict__`, *locals* defaults to *globals*." msgstr "" -#: ../src/Doc/library/bdb.rst:322 +#: library/bdb.rst:322 msgid "" "Debug an expression executed via the :func:`eval` function. *globals* and " "*locals* have the same meaning as in :meth:`run`." msgstr "" -#: ../src/Doc/library/bdb.rst:327 +#: library/bdb.rst:327 msgid "For backwards compatibility. Calls the :meth:`run` method." msgstr "" -#: ../src/Doc/library/bdb.rst:331 +#: library/bdb.rst:331 msgid "Debug a single function call, and return its result." msgstr "" -#: ../src/Doc/library/bdb.rst:334 +#: library/bdb.rst:334 msgid "Finally, the module defines the following functions:" msgstr "" -#: ../src/Doc/library/bdb.rst:338 +#: library/bdb.rst:338 msgid "" "Check whether we should break here, depending on the way the breakpoint *b* " "was set." msgstr "" -#: ../src/Doc/library/bdb.rst:341 +#: library/bdb.rst:341 msgid "" "If it was set via line number, it checks if ``b.line`` is the same as the " "one in the frame also passed as argument. If the breakpoint was set via " @@ -7708,7 +7700,7 @@ msgid "" msgstr "" # 063e765a776c4ee985407b411ad30f38 -#: ../src/Doc/library/bdb.rst:348 +#: library/bdb.rst:348 msgid "" "Determine if there is an effective (active) breakpoint at this line of code. " "Return a tuple of the breakpoint and a boolean that indicates if it is ok to " @@ -7717,15 +7709,15 @@ msgid "" msgstr "" # 66539dc8ae2d48519504a017639aa514 -#: ../src/Doc/library/bdb.rst:355 +#: library/bdb.rst:355 msgid "Start debugging with a :class:`Bdb` instance from caller's frame." msgstr "" -#: ../src/Doc/library/binascii.rst:3 +#: library/binascii.rst:3 msgid ":mod:`binascii` --- Convert between binary and ASCII" msgstr "" -#: ../src/Doc/library/binascii.rst:15 +#: library/binascii.rst:15 msgid "" "The :mod:`binascii` module contains a number of methods to convert between " "binary and various ASCII-encoded binary representations. Normally, you will " @@ -7735,45 +7727,47 @@ msgid "" "higher-level modules." msgstr "" -#: ../src/Doc/library/binascii.rst:22 +#: library/binascii.rst:22 msgid "The :mod:`binascii` module defines the following functions:" msgstr "" -#: ../src/Doc/library/binascii.rst:27 +#: library/binascii.rst:27 msgid "" "Convert a single line of uuencoded data back to binary and return the binary " "data. Lines normally contain 45 (binary) bytes, except for the last line. " "Line data may be followed by whitespace." msgstr "" -#: ../src/Doc/library/binascii.rst:34 +#: library/binascii.rst:34 msgid "" "Convert binary data to a line of ASCII characters, the return value is the " "converted line, including a newline char. The length of *data* should be at " "most 45." msgstr "" -#: ../src/Doc/library/binascii.rst:41 +#: library/binascii.rst:41 msgid "" "Convert a block of base64 data back to binary and return the binary data. " "More than one line may be passed at a time." msgstr "" -#: ../src/Doc/library/binascii.rst:47 +#: library/binascii.rst:47 msgid "" "Convert binary data to a line of ASCII characters in base64 coding. The " -"return value is the converted line, including a newline char. The length of " -"*data* should be at most 57 to adhere to the base64 standard." +"return value is the converted line, including a newline char. The newline " +"is added because the original use case for this function was to feed it a " +"series of 57 byte input lines to get output lines that conform to the MIME-" +"base64 standard. Otherwise the output conforms to :rfc:`3548`." msgstr "" -#: ../src/Doc/library/binascii.rst:54 +#: library/binascii.rst:56 msgid "" "Convert a block of quoted-printable data back to binary and return the " "binary data. More than one line may be passed at a time. If the optional " "argument *header* is present and true, underscores will be decoded as spaces." msgstr "" -#: ../src/Doc/library/binascii.rst:61 +#: library/binascii.rst:63 msgid "" "Convert binary data to a line(s) of ASCII characters in quoted-printable " "encoding. The return value is the converted line(s). If the optional " @@ -7786,7 +7780,7 @@ msgid "" "corrupt the binary data stream." msgstr "" -#: ../src/Doc/library/binascii.rst:74 +#: library/binascii.rst:76 msgid "" "Convert binhex4 formatted ASCII data to binary, without doing RLE-" "decompression. The string should contain a complete number of binary bytes, " @@ -7794,7 +7788,7 @@ msgid "" "zero." msgstr "" -#: ../src/Doc/library/binascii.rst:81 +#: library/binascii.rst:83 msgid "" "Perform RLE-decompression on the data, as per the binhex4 standard. The " "algorithm uses ``0x90`` after a byte as a repeat indicator, followed by a " @@ -7803,24 +7797,24 @@ msgid "" "repeat indicator, in which case the :exc:`Incomplete` exception is raised." msgstr "" -#: ../src/Doc/library/binascii.rst:90 +#: library/binascii.rst:92 msgid "Perform binhex4 style RLE-compression on *data* and return the result." msgstr "" -#: ../src/Doc/library/binascii.rst:95 +#: library/binascii.rst:97 msgid "" "Perform hexbin4 binary-to-ASCII translation and return the resulting string. " "The argument should already be RLE-coded, and have a length divisible by 3 " "(except possibly the last fragment)." msgstr "" -#: ../src/Doc/library/binascii.rst:102 +#: library/binascii.rst:104 msgid "" "Compute the binhex4 crc value of *data*, starting with an initial *crc* and " "returning the result." msgstr "" -#: ../src/Doc/library/binascii.rst:108 +#: library/binascii.rst:110 msgid "" "Compute CRC-32, the 32-bit checksum of data, starting with an initial crc. " "This is consistent with the ZIP file checksum. Since the algorithm is " @@ -7828,7 +7822,7 @@ msgid "" "general hash algorithm. Use as follows::" msgstr "" -#: ../src/Doc/library/binascii.rst:120 ../src/Doc/library/zlib.rst:112 +#: library/binascii.rst:122 library/zlib.rst:112 msgid "" "To generate the same numeric value across all Python versions and platforms " "use crc32(data) & 0xffffffff. If you are only using the checksum in packed " @@ -7836,14 +7830,28 @@ msgid "" "binary representation regardless of sign." msgstr "" -#: ../src/Doc/library/binascii.rst:140 +#: library/binascii.rst:128 +msgid "" +"The return value is in the range [-2**31, 2**31-1] regardless of platform. " +"In the past the value would be signed on some platforms and unsigned on " +"others. Use & 0xffffffff on the value if you want it to match Python 3 " +"behavior." +msgstr "" + +#: library/binascii.rst:134 library/zlib.rst:57 library/zlib.rst:123 +msgid "" +"The return value is unsigned and in the range [0, 2**32-1] regardless of " +"platform." +msgstr "" + +#: library/binascii.rst:142 msgid "" "Return the hexadecimal representation of the binary *data*. Every byte of " "*data* is converted into the corresponding 2-digit hex representation. The " "resulting string is therefore twice as long as the length of *data*." msgstr "" -#: ../src/Doc/library/binascii.rst:148 +#: library/binascii.rst:150 msgid "" "Return the binary data represented by the hexadecimal string *hexstr*. This " "function is the inverse of :func:`b2a_hex`. *hexstr* must contain an even " @@ -7851,62 +7859,58 @@ msgid "" "a :exc:`TypeError` is raised." msgstr "" -#: ../src/Doc/library/binascii.rst:156 +#: library/binascii.rst:158 msgid "Exception raised on errors. These are usually programming errors." msgstr "" -#: ../src/Doc/library/binascii.rst:161 +#: library/binascii.rst:163 msgid "" "Exception raised on incomplete data. These are usually not programming " "errors, but may be handled by reading a little more data and trying again." msgstr "" -# f669d0c5aa40409ebdd4b786e86354f5 -# 4be46e2fa0f845588ac2683a3a10b058 -# c75d6652fd1146d0b1292f74ed001d23 -#: ../src/Doc/library/binascii.rst:167 ../src/Doc/library/hashlib.rst:201 -#: ../src/Doc/library/quopri.rst:63 -msgid "Module :mod:`base64`" +#: library/binascii.rst:170 library/hashlib.rst:202 library/quopri.rst:64 +#, fuzzy +msgid "Module base64" +msgstr "Modules" + +#: library/binascii.rst:170 +msgid "Support for RFC compliant base64-style encoding in base 16, 32, and 64." msgstr "" -#: ../src/Doc/library/binascii.rst:168 -msgid "Support for base64 encoding used in MIME email messages." -msgstr "" +#: library/binascii.rst:173 +#, fuzzy +msgid "Module binhex" +msgstr "Modules" -# 410fecf5df7a4217918e70d7e9f75a79 -#: ../src/Doc/library/binascii.rst:170 -msgid "Module :mod:`binhex`" -msgstr "" - -#: ../src/Doc/library/binascii.rst:171 +#: library/binascii.rst:173 msgid "Support for the binhex format used on the Macintosh." msgstr "" -# bf1555bea6974125a966fe56d70de318 -#: ../src/Doc/library/binascii.rst:173 -msgid "Module :mod:`uu`" -msgstr "" +#: library/binascii.rst:176 +#, fuzzy +msgid "Module uu" +msgstr "Modules" -#: ../src/Doc/library/binascii.rst:174 +#: library/binascii.rst:176 msgid "Support for UU encoding used on Unix." msgstr "" -# cc38abdae69b4f90b15bdc5470c4c141 -# 11971a4fdab04517a60e7d6417f69dae -#: ../src/Doc/library/binascii.rst:175 ../src/Doc/library/mimify.rst:93 -msgid "Module :mod:`quopri`" -msgstr "" +#: library/binascii.rst:178 library/mimify.rst:94 +#, fuzzy +msgid "Module quopri" +msgstr "Modules" -#: ../src/Doc/library/binascii.rst:177 +#: library/binascii.rst:179 msgid "Support for quoted-printable encoding used in MIME email messages." msgstr "" -#: ../src/Doc/library/binhex.rst:2 +#: library/binhex.rst:2 msgid ":mod:`binhex` --- Encode and decode binhex4 files" msgstr "" # 2ff3387790c94dfcb18aafbbfce7bb44 -#: ../src/Doc/library/binhex.rst:8 +#: library/binhex.rst:8 msgid "" "This module encodes and decodes files in binhex4 format, a format allowing " "representation of Macintosh files in ASCII. On the Macintosh, both forks of " @@ -7915,15 +7919,15 @@ msgid "" msgstr "" # acc0cc5289354058b86d814fa5300467 -#: ../src/Doc/library/binhex.rst:15 +#: library/binhex.rst:15 msgid "In Python 3.x, special Macintosh support has been removed." msgstr "" -#: ../src/Doc/library/binhex.rst:18 +#: library/binhex.rst:18 msgid "The :mod:`binhex` module defines the following functions:" msgstr "" -#: ../src/Doc/library/binhex.rst:23 +#: library/binhex.rst:23 msgid "" "Convert a binary file with filename *input* to binhex file *output*. The " "*output* parameter can either be a filename or a file-like object (any " @@ -7931,7 +7935,7 @@ msgid "" msgstr "" # 0181ce8c8baa4a18ba9bf9019b7355ab -#: ../src/Doc/library/binhex.rst:30 +#: library/binhex.rst:30 msgid "" "Decode a binhex file *input*. *input* may be a filename or a file-like " "object supporting :meth:`read` and :meth:`close` methods. The resulting file " @@ -7939,55 +7943,52 @@ msgid "" "case the output filename is read from the binhex file." msgstr "" -#: ../src/Doc/library/binhex.rst:35 +#: library/binhex.rst:35 msgid "The following exception is also defined:" msgstr "" -#: ../src/Doc/library/binhex.rst:40 +#: library/binhex.rst:40 msgid "" "Exception raised when something can't be encoded using the binhex format " "(for example, a filename is too long to fit in the filename field), or when " "input is not properly encoded binhex data." msgstr "" -#: ../src/Doc/library/binhex.rst:54 ../src/Doc/library/datetime.rst:1618 -#: ../src/Doc/library/inspect.rst:40 ../src/Doc/library/posixfile.rst:123 -#: ../src/Doc/library/posixfile.rst:158 ../src/Doc/library/stdtypes.rst:95 -#: ../src/Doc/library/stdtypes.rst:153 ../src/Doc/library/stdtypes.rst:299 -#: ../src/Doc/library/stdtypes.rst:397 ../src/Doc/library/stdtypes.rst:439 -#: ../src/Doc/library/stdtypes.rst:728 ../src/Doc/library/stdtypes.rst:1442 -#: ../src/Doc/library/stdtypes.rst:1593 ../src/Doc/library/struct.rst:166 -#: ../src/Doc/library/subprocess.rst:898 ../src/Doc/library/time.rst:258 -#: ../src/Doc/library/webbrowser.rst:107 +#: library/binhex.rst:54 library/datetime.rst:1618 library/inspect.rst:40 +#: library/posixfile.rst:123 library/posixfile.rst:158 library/stdtypes.rst:95 +#: library/stdtypes.rst:153 library/stdtypes.rst:299 library/stdtypes.rst:397 +#: library/stdtypes.rst:439 library/stdtypes.rst:728 library/stdtypes.rst:1445 +#: library/stdtypes.rst:1596 library/struct.rst:166 library/subprocess.rst:898 +#: library/time.rst:257 library/webbrowser.rst:107 msgid "Notes" msgstr "Notes" -#: ../src/Doc/library/binhex.rst:56 +#: library/binhex.rst:56 msgid "" "There is an alternative, more powerful interface to the coder and decoder, " "see the source for details." msgstr "" -#: ../src/Doc/library/binhex.rst:59 +#: library/binhex.rst:59 msgid "" "If you code or decode textfiles on non-Macintosh platforms they will still " "use the old Macintosh newline convention (carriage-return as end of line)." msgstr "" -#: ../src/Doc/library/binhex.rst:62 +#: library/binhex.rst:62 msgid "As of this writing, :func:`hexbin` appears to not work in all cases." msgstr "" -#: ../src/Doc/library/bisect.rst:2 +#: library/bisect.rst:2 msgid ":mod:`bisect` --- Array bisection algorithm" msgstr "" # accd2d63dd96460ebdfe9f1ba4643b41 -#: ../src/Doc/library/bisect.rst:12 +#: library/bisect.rst:12 msgid "**Source code:** :source:`Lib/bisect.py`" msgstr "" -#: ../src/Doc/library/bisect.rst:16 +#: library/bisect.rst:16 msgid "" "This module provides support for maintaining a list in sorted order without " "having to sort the list after each insertion. For long lists of items with " @@ -7998,12 +7999,12 @@ msgid "" "right!)." msgstr "" -#: ../src/Doc/library/bisect.rst:23 ../src/Doc/library/heapq.rst:41 +#: library/bisect.rst:23 library/heapq.rst:41 msgid "The following functions are provided:" msgstr "" # 365b1e959a3148b8b3c0c2154984c99a -#: ../src/Doc/library/bisect.rst:28 +#: library/bisect.rst:28 msgid "" "Locate the insertion point for *x* in *a* to maintain sorted order. The " "parameters *lo* and *hi* may be used to specify a subset of the list which " @@ -8014,21 +8015,21 @@ msgid "" msgstr "" # 89f5973e814d49c98d31a8eef6e8b7ae -#: ../src/Doc/library/bisect.rst:35 +#: library/bisect.rst:35 msgid "" "The returned insertion point *i* partitions the array *a* into two halves so " "that ``all(val < x for val in a[lo:i])`` for the left side and ``all(val >= " "x for val in a[i:hi])`` for the right side." msgstr "" -#: ../src/Doc/library/bisect.rst:42 +#: library/bisect.rst:42 msgid "" "Similar to :func:`bisect_left`, but returns an insertion point which comes " "after (to the right of) any existing entries of *x* in *a*." msgstr "" # 80b3a68f26444e0c826df24a7dc43574 -#: ../src/Doc/library/bisect.rst:45 +#: library/bisect.rst:45 msgid "" "The returned insertion point *i* partitions the array *a* into two halves so " "that ``all(val <= x for val in a[lo:i])`` for the left side and ``all(val > " @@ -8036,7 +8037,7 @@ msgid "" msgstr "" # 545bcf3725464c309b6039f649c7b9b0 -#: ../src/Doc/library/bisect.rst:51 +#: library/bisect.rst:51 msgid "" "Insert *x* in *a* in sorted order. This is equivalent to ``a.insert(bisect." "bisect_left(a, x, lo, hi), x)`` assuming that *a* is already sorted. Keep " @@ -8044,14 +8045,14 @@ msgid "" "step." msgstr "" -#: ../src/Doc/library/bisect.rst:59 +#: library/bisect.rst:59 msgid "" "Similar to :func:`insort_left`, but inserting *x* in *a* after any existing " "entries of *x*." msgstr "" # e6f1aa2afb2c40499da4cd981f4f24f8 -#: ../src/Doc/library/bisect.rst:64 +#: library/bisect.rst:64 msgid "" "`SortedCollection recipe `_ that uses bisect to build a full-featured collection " @@ -8061,12 +8062,12 @@ msgid "" msgstr "" # f849efe7ec76487d9fb0e7a238c0da5d -#: ../src/Doc/library/bisect.rst:72 +#: library/bisect.rst:72 msgid "Searching Sorted Lists" msgstr "" # a317a2c1bf31472c94ab16cdf7161ed5 -#: ../src/Doc/library/bisect.rst:74 +#: library/bisect.rst:74 msgid "" "The above :func:`bisect` functions are useful for finding insertion points " "but can be tricky or awkward to use for common searching tasks. The " @@ -8075,12 +8076,12 @@ msgid "" msgstr "" # 66991d2a33834a14bb8371946f154efc -#: ../src/Doc/library/bisect.rst:116 +#: library/bisect.rst:116 msgid "Other Examples" msgstr "" # b9ae2af66546483696036e9d2ebab180 -#: ../src/Doc/library/bisect.rst:120 +#: library/bisect.rst:120 msgid "" "The :func:`bisect` function can be useful for numeric table lookups. This " "example uses :func:`bisect` to look up a letter grade for an exam score " @@ -8089,7 +8090,7 @@ msgid "" msgstr "" # 0c7197be924644d389862616d66775a9 -#: ../src/Doc/library/bisect.rst:132 +#: library/bisect.rst:132 msgid "" "Unlike the :func:`sorted` function, it does not make sense for the :func:" "`bisect` functions to have *key* or *reversed* arguments because that would " @@ -8097,19 +8098,23 @@ msgid "" "not \"remember\" all of the previous key lookups)." msgstr "" -#: ../src/Doc/library/bisect.rst:137 +#: library/bisect.rst:137 msgid "" "Instead, it is better to search a list of precomputed keys to find the index " "of the record in question::" msgstr "" # d6cd7d9fbcc64fe1b63fcaaba131b762 -#: ../src/Doc/library/bsddb.rst:3 +#: library/bsddb.rst:3 msgid ":mod:`bsddb` --- Interface to Berkeley DB library" msgstr "" +#: library/bsddb.rst:9 +msgid "The :mod:`bsddb` module has been removed in Python 3." +msgstr "" + # 53e712558fae4985b4b6072817f4e592 -#: ../src/Doc/library/bsddb.rst:13 +#: library/bsddb.rst:13 msgid "" "The :mod:`bsddb` module provides an interface to the Berkeley DB library. " "Users can create hash, btree or record based library files using the " @@ -8120,19 +8125,19 @@ msgid "" msgstr "" # 1687b705a4f248bb8d6bd39c221e011b -#: ../src/Doc/library/bsddb.rst:20 +#: library/bsddb.rst:20 msgid "" "The :mod:`bsddb` module requires a Berkeley DB library version from 4.0 thru " "4.7." msgstr "" # 2b4d40e83a584a6d9f6c73d396b1f640 -#: ../src/Doc/library/bsddb.rst:28 +#: library/bsddb.rst:29 msgid "http://www.jcea.es/programacion/pybsddb.htm" msgstr "" # f0f20ac8e0d14fc595479e0a70d869d2 -#: ../src/Doc/library/bsddb.rst:27 +#: library/bsddb.rst:27 msgid "" "The website with documentation for the :mod:`bsddb.db` Python Berkeley DB " "interface that closely mirrors the object oriented interface provided in " @@ -8140,17 +8145,17 @@ msgid "" msgstr "" # a10a63e74bac4e91b58ef6b7c611fc9a -#: ../src/Doc/library/bsddb.rst:30 +#: library/bsddb.rst:31 msgid "http://www.oracle.com/database/berkeley-db/" msgstr "" # 9e57d2955393424fa0d873506e3c2c5d -#: ../src/Doc/library/bsddb.rst:32 +#: library/bsddb.rst:32 msgid "The Berkeley DB library." msgstr "" # 7799a68058a84725a9910e16330d45b5 -#: ../src/Doc/library/bsddb.rst:34 +#: library/bsddb.rst:34 msgid "" "A more modern DB, DBEnv and DBSequence object interface is available in the :" "mod:`bsddb.db` module which closely matches the Berkeley DB C API documented " @@ -8160,7 +8165,7 @@ msgid "" msgstr "" # 68c952ece86f4595bf3bb26189f433aa -#: ../src/Doc/library/bsddb.rst:39 +#: library/bsddb.rst:39 msgid "" "The following is a description of the legacy :mod:`bsddb` interface " "compatible with the old Python bsddb module. Starting in Python 2.5 this " @@ -8169,7 +8174,7 @@ msgid "" msgstr "" # a44f50d7a6914241b47205b75f20ea29 -#: ../src/Doc/library/bsddb.rst:44 +#: library/bsddb.rst:44 msgid "" "The :mod:`bsddb` module defines the following functions that create objects " "that access the appropriate type of Berkeley DB file. The first two " @@ -8178,7 +8183,7 @@ msgid "" msgstr "" # 12439cf9355e4801a0f784d5bfd463c6 -#: ../src/Doc/library/bsddb.rst:52 +#: library/bsddb.rst:52 msgid "" "Open the hash format file named *filename*. Files never intended to be " "preserved on disk may be created by passing ``None`` as the *filename*. " @@ -8191,7 +8196,7 @@ msgid "" msgstr "" # 546af81efab349bc88dabf637be6845f -#: ../src/Doc/library/bsddb.rst:64 +#: library/bsddb.rst:64 msgid "" "Open the btree format file named *filename*. Files never intended to be " "preserved on disk may be created by passing ``None`` as the *filename*. " @@ -8204,7 +8209,7 @@ msgid "" msgstr "" # f231d5394b3b49deb8df4948df8bdb57 -#: ../src/Doc/library/bsddb.rst:75 +#: library/bsddb.rst:75 msgid "" "Open a DB record format file named *filename*. Files never intended to be " "preserved on disk may be created by passing ``None`` as the *filename*. " @@ -8217,7 +8222,7 @@ msgid "" msgstr "" # a58d9f505e1d42659a911f5710df7193 -#: ../src/Doc/library/bsddb.rst:85 +#: library/bsddb.rst:85 msgid "" "Beginning in 2.3 some Unix versions of Python may have a :mod:`bsddb185` " "module. This is present *only* to allow backwards compatibility with systems " @@ -8227,24 +8232,28 @@ msgid "" msgstr "" # 167fb3e2b30e495cb4c7e40073e999b1 -#: ../src/Doc/library/bsddb.rst:95 +#: library/bsddb.rst:95 msgid "DBM-style interface to the :mod:`bsddb`" msgstr "" # c28966a71baa4bb6923135ded0419a70 -#: ../src/Doc/library/bsddb.rst:101 +#: library/bsddb.rst:101 msgid "Hash, BTree and Record Objects" msgstr "" # c939bdc8b55440a5b476e4a13661fba8 -#: ../src/Doc/library/bsddb.rst:103 +#: library/bsddb.rst:103 msgid "" "Once instantiated, hash, btree and record objects support the same methods " "as dictionaries. In addition, they support the methods listed below." msgstr "" +#: library/bsddb.rst:106 +msgid "Added dictionary methods." +msgstr "" + # 20262ae891724dae8212209c75f12c6f -#: ../src/Doc/library/bsddb.rst:112 +#: library/bsddb.rst:112 msgid "" "Close the underlying file. The object can no longer be accessed. Since " "there is no open :meth:`open` method for these objects, to open the file " @@ -8252,7 +8261,7 @@ msgid "" msgstr "" # 7a37370f7e3a41a3b61cdceaaebdfe60 -#: ../src/Doc/library/bsddb.rst:119 +#: library/bsddb.rst:119 msgid "" "Return the list of keys contained in the DB file. The order of the list is " "unspecified and should not be relied on. In particular, the order of the " @@ -8260,12 +8269,12 @@ msgid "" msgstr "" # 0634867c95754fd58960366b8cf8dddb -#: ../src/Doc/library/bsddb.rst:126 +#: library/bsddb.rst:126 msgid "Return ``1`` if the DB file contains the argument as a key." msgstr "" # 7605f95c0ee646b4bae75b699454f1fb -#: ../src/Doc/library/bsddb.rst:131 +#: library/bsddb.rst:131 msgid "" "Set the cursor to the item indicated by *key* and return a tuple containing " "the key and its value. For binary tree databases (opened using :func:" @@ -8276,7 +8285,7 @@ msgid "" msgstr "" # e80b05950b79451fa7d7842eebe98546 -#: ../src/Doc/library/bsddb.rst:140 +#: library/bsddb.rst:140 msgid "" "Set the cursor to the first item in the DB file and return it. The order of " "keys in the file is unspecified, except in the case of B-Tree databases. " @@ -8284,14 +8293,14 @@ msgid "" msgstr "" # 78010b956a6a4f41b811283df5cf64fa -#: ../src/Doc/library/bsddb.rst:147 +#: library/bsddb.rst:147 msgid "" "Set the cursor to the next item in the DB file and return it. The order of " "keys in the file is unspecified, except in the case of B-Tree databases." msgstr "" # f3dbd5b4675a4d02b43bed122c209995 -#: ../src/Doc/library/bsddb.rst:153 +#: library/bsddb.rst:153 msgid "" "Set the cursor to the previous item in the DB file and return it. The order " "of keys in the file is unspecified, except in the case of B-Tree databases. " @@ -8300,7 +8309,7 @@ msgid "" msgstr "" # e596071f58384a4d962a5d52d8c967c5 -#: ../src/Doc/library/bsddb.rst:160 +#: library/bsddb.rst:160 msgid "" "Set the cursor to the last item in the DB file and return it. The order of " "keys in the file is unspecified. This is not supported on hashtable " @@ -8309,92 +8318,88 @@ msgid "" msgstr "" # a9fa684f84a5419399aca007bfd66b7e -#: ../src/Doc/library/bsddb.rst:168 +#: library/bsddb.rst:168 msgid "Synchronize the database on disk." msgstr "" -#: ../src/Doc/library/bsddb.rst:170 ../src/Doc/library/colorsys.rst:58 -#: ../src/Doc/library/commands.rst:61 ../src/Doc/library/dl.rst:65 -#: ../src/Doc/library/filecmp.rst:54 ../src/Doc/library/fpformat.rst:56 -#: ../src/Doc/library/functools.rst:37 ../src/Doc/library/imaplib.rst:369 -#: ../src/Doc/library/imghdr.rst:68 ../src/Doc/library/linecache.rst:50 -#: ../src/Doc/library/locale.rst:481 ../src/Doc/library/optparse.rst:1099 -#: ../src/Doc/library/optparse.rst:1119 ../src/Doc/library/optparse.rst:1141 -#: ../src/Doc/library/optparse.rst:1159 ../src/Doc/library/optparse.rst:1198 -#: ../src/Doc/library/optparse.rst:1236 ../src/Doc/library/os.rst:1430 -#: ../src/Doc/library/pipes.rst:24 ../src/Doc/library/rlcompleter.rst:19 -#: ../src/Doc/library/sched.rst:28 ../src/Doc/library/sched.rst:53 -#: ../src/Doc/library/simplexmlrpcserver.rst:279 -#: ../src/Doc/library/sqlite3.rst:473 ../src/Doc/library/ssl.rst:420 -#: ../src/Doc/library/ssl.rst:1175 ../src/Doc/library/stat.rst:78 -#: ../src/Doc/library/tkinter.rst:452 +#: library/bsddb.rst:170 library/colorsys.rst:58 library/commands.rst:61 +#: library/dl.rst:65 library/filecmp.rst:54 library/fpformat.rst:56 +#: library/functools.rst:37 library/imaplib.rst:369 library/imghdr.rst:68 +#: library/linecache.rst:50 library/locale.rst:481 library/optparse.rst:1099 +#: library/optparse.rst:1119 library/optparse.rst:1141 +#: library/optparse.rst:1159 library/optparse.rst:1198 +#: library/optparse.rst:1236 library/os.rst:1430 library/pipes.rst:24 +#: library/rlcompleter.rst:19 library/sched.rst:28 library/sched.rst:53 +#: library/simplexmlrpcserver.rst:279 library/sqlite3.rst:473 +#: library/ssl.rst:424 library/ssl.rst:1221 library/stat.rst:78 +#: library/tkinter.rst:452 #, fuzzy msgid "Example::" msgstr "Exemples ::" -#: ../src/Doc/library/bz2.rst:3 +#: library/bz2.rst:3 msgid ":mod:`bz2` --- Compression compatible with :program:`bzip2`" msgstr "" -#: ../src/Doc/library/bz2.rst:13 +#: library/bz2.rst:13 msgid "" "This module provides a comprehensive interface for the bz2 compression " "library. It implements a complete file interface, one-shot (de)compression " "functions, and types for sequential (de)compression." msgstr "" -#: ../src/Doc/library/bz2.rst:17 +#: library/bz2.rst:17 msgid "Here is a summary of the features offered by the bz2 module:" msgstr "" -#: ../src/Doc/library/bz2.rst:19 +#: library/bz2.rst:19 msgid "" ":class:`BZ2File` class implements a complete file interface, including :meth:" "`~BZ2File.readline`, :meth:`~BZ2File.readlines`, :meth:`~BZ2File." "writelines`, :meth:`~BZ2File.seek`, etc;" msgstr "" -#: ../src/Doc/library/bz2.rst:23 +#: library/bz2.rst:23 msgid "" ":class:`BZ2File` class implements emulated :meth:`~BZ2File.seek` support;" msgstr "" -#: ../src/Doc/library/bz2.rst:25 +#: library/bz2.rst:25 msgid ":class:`BZ2File` class implements universal newline support;" msgstr "" -#: ../src/Doc/library/bz2.rst:27 +#: library/bz2.rst:27 msgid "" ":class:`BZ2File` class offers an optimized line iteration using the " "readahead algorithm borrowed from file objects;" msgstr "" -#: ../src/Doc/library/bz2.rst:30 +#: library/bz2.rst:30 msgid "" "Sequential (de)compression supported by :class:`BZ2Compressor` and :class:" "`BZ2Decompressor` classes;" msgstr "" -#: ../src/Doc/library/bz2.rst:33 +#: library/bz2.rst:33 msgid "" "One-shot (de)compression supported by :func:`compress` and :func:" "`decompress` functions;" msgstr "" -#: ../src/Doc/library/bz2.rst:36 +#: library/bz2.rst:36 msgid "Thread safety uses individual locking mechanism." msgstr "" -#: ../src/Doc/library/bz2.rst:40 +#: library/bz2.rst:40 msgid "(De)compression of files" msgstr "" -#: ../src/Doc/library/bz2.rst:42 +#: library/bz2.rst:42 msgid "Handling of compressed files is offered by the :class:`BZ2File` class." msgstr "" # 66e0d849451242c3a1f7485eeabf7078 -#: ../src/Doc/library/bz2.rst:50 +#: library/bz2.rst:50 msgid "" "Open a bz2 file. Mode can be either ``'r'`` or ``'w'``, for reading " "(default) or writing. When opened for writing, the file will be created if " @@ -8411,12 +8416,16 @@ msgid "" "`file` instances." msgstr "" -#: ../src/Doc/library/bz2.rst:64 +#: library/bz2.rst:64 msgid ":class:`BZ2File` supports the :keyword:`with` statement." msgstr "" +#: library/bz2.rst:66 library/gzip.rst:74 +msgid "Support for the :keyword:`with` statement was added." +msgstr "" + # 7da391c217334d3cbe53234f0d6a0670 -#: ../src/Doc/library/bz2.rst:72 +#: library/bz2.rst:72 msgid "" "This class does not support input files containing multiple streams (such as " "those produced by the :program:`pbzip2` tool). When reading such an input " @@ -8427,7 +8436,7 @@ msgid "" "support multi-stream files." msgstr "" -#: ../src/Doc/library/bz2.rst:84 +#: library/bz2.rst:84 msgid "" "Close the file. Sets data attribute :attr:`closed` to true. A closed file " "cannot be used for further I/O operations. :meth:`close` may be called more " @@ -8435,35 +8444,41 @@ msgid "" msgstr "" # ac1731fe7ffd481d91b506085afcd693 -#: ../src/Doc/library/bz2.rst:91 +#: library/bz2.rst:91 msgid "" "Read at most *size* uncompressed bytes, returned as a string. If the *size* " "argument is negative or omitted, read until EOF is reached." msgstr "" # 7cb37f5506754ae8b4000c6ab27a81be -#: ../src/Doc/library/bz2.rst:97 +#: library/bz2.rst:97 msgid "" "Return the next line from the file, as a string, retaining newline. A non-" "negative *size* argument limits the maximum number of bytes to return (an " "incomplete line may be returned then). Return an empty string at EOF." msgstr "" -#: ../src/Doc/library/bz2.rst:104 +#: library/bz2.rst:104 msgid "" "Return a list of lines read. The optional *size* argument, if given, is an " "approximate bound on the total number of bytes in the lines returned." msgstr "" # 754d121761be4c858a71909d11c58ce5 -#: ../src/Doc/library/bz2.rst:110 +#: library/bz2.rst:110 msgid "" "For backward compatibility. :class:`BZ2File` objects now include the " "performance optimizations previously implemented in the :mod:`xreadlines` " "module." msgstr "" -#: ../src/Doc/library/bz2.rst:122 +#: library/bz2.rst:114 +msgid "" +"This exists only for compatibility with the method by this name on :class:" +"`file` objects, which is deprecated. Use ``for line in file`` instead." +msgstr "" + +#: library/bz2.rst:122 msgid "" "Move to new file position. Argument *offset* is a byte count. Optional " "argument *whence* defaults to ``os.SEEK_SET`` or ``0`` (offset from start of " @@ -8473,43 +8488,43 @@ msgid "" "negative, although many platforms allow seeking beyond the end of a file)." msgstr "" -#: ../src/Doc/library/bz2.rst:130 +#: library/bz2.rst:130 msgid "" "Note that seeking of bz2 files is emulated, and depending on the parameters " "the operation may be extremely slow." msgstr "" # b696cd130740449eaa78360cfea067fa -#: ../src/Doc/library/bz2.rst:136 +#: library/bz2.rst:136 msgid "Return the current file position, an integer (may be a long integer)." msgstr "" # 50e76788066c4591ae4e49f59221e80a -#: ../src/Doc/library/bz2.rst:141 +#: library/bz2.rst:141 msgid "" "Write string *data* to file. Note that due to buffering, :meth:`close` may " "be needed before the file on disk reflects the data written." msgstr "" # cd605dc789e544dcb1805a4346a093f4 -#: ../src/Doc/library/bz2.rst:147 +#: library/bz2.rst:147 msgid "" "Write the sequence of strings to the file. Note that newlines are not added. " "The sequence can be any iterable object producing strings. This is " "equivalent to calling write() for each string." msgstr "" -#: ../src/Doc/library/bz2.rst:153 +#: library/bz2.rst:153 msgid "Sequential (de)compression" msgstr "" -#: ../src/Doc/library/bz2.rst:155 +#: library/bz2.rst:155 msgid "" "Sequential compression and decompression is done using the classes :class:" "`BZ2Compressor` and :class:`BZ2Decompressor`." msgstr "" -#: ../src/Doc/library/bz2.rst:161 +#: library/bz2.rst:161 msgid "" "Create a new compressor object. This object may be used to compress data " "sequentially. If you want to compress data in one shot, use the :func:" @@ -8517,7 +8532,7 @@ msgid "" "be a number between ``1`` and ``9``; the default is ``9``." msgstr "" -#: ../src/Doc/library/bz2.rst:169 +#: library/bz2.rst:169 msgid "" "Provide more data to the compressor object. It will return chunks of " "compressed data whenever possible. When you've finished providing data to " @@ -8525,20 +8540,20 @@ msgid "" "and return what is left in internal buffers." msgstr "" -#: ../src/Doc/library/bz2.rst:177 +#: library/bz2.rst:177 msgid "" "Finish the compression process and return what is left in internal buffers. " "You must not use the compressor object after calling this method." msgstr "" -#: ../src/Doc/library/bz2.rst:183 +#: library/bz2.rst:183 msgid "" "Create a new decompressor object. This object may be used to decompress data " "sequentially. If you want to decompress data in one shot, use the :func:" "`decompress` function instead." msgstr "" -#: ../src/Doc/library/bz2.rst:190 +#: library/bz2.rst:190 msgid "" "Provide more data to the decompressor object. It will return chunks of " "decompressed data whenever possible. If you try to decompress data after the " @@ -8547,17 +8562,17 @@ msgid "" "`unused_data` attribute." msgstr "" -#: ../src/Doc/library/bz2.rst:198 +#: library/bz2.rst:198 msgid "One-shot (de)compression" msgstr "" -#: ../src/Doc/library/bz2.rst:200 +#: library/bz2.rst:200 msgid "" "One-shot compression and decompression is provided through the :func:" "`compress` and :func:`decompress` functions." msgstr "" -#: ../src/Doc/library/bz2.rst:206 +#: library/bz2.rst:206 msgid "" "Compress *data* in one shot. If you want to compress data sequentially, use " "an instance of :class:`BZ2Compressor` instead. The *compresslevel* " @@ -8565,22 +8580,22 @@ msgid "" "is ``9``." msgstr "" -#: ../src/Doc/library/bz2.rst:213 +#: library/bz2.rst:213 msgid "" "Decompress *data* in one shot. If you want to decompress data sequentially, " "use an instance of :class:`BZ2Decompressor` instead." msgstr "" -#: ../src/Doc/library/calendar.rst:2 +#: library/calendar.rst:2 msgid ":mod:`calendar` --- General calendar-related functions" msgstr "" # 24cd69c331b04ce9ab7dcf614cfb782a -#: ../src/Doc/library/calendar.rst:9 +#: library/calendar.rst:9 msgid "**Source code:** :source:`Lib/calendar.py`" msgstr "" -#: ../src/Doc/library/calendar.rst:13 +#: library/calendar.rst:13 msgid "" "This module allows you to output calendars like the Unix :program:`cal` " "program, and provides additional useful functions related to the calendar. " @@ -8591,7 +8606,7 @@ msgid "" "functionality, see also the :mod:`datetime` and :mod:`time` modules." msgstr "" -#: ../src/Doc/library/calendar.rst:21 +#: library/calendar.rst:21 msgid "" "Most of these functions and classes rely on the :mod:`datetime` module which " "uses an idealized calendar, the current Gregorian calendar indefinitely " @@ -8600,31 +8615,31 @@ msgid "" "Calculations\", where it's the base calendar for all computations." msgstr "" -#: ../src/Doc/library/calendar.rst:30 +#: library/calendar.rst:30 msgid "" "Creates a :class:`Calendar` object. *firstweekday* is an integer specifying " "the first day of the week. ``0`` is Monday (the default), ``6`` is Sunday." msgstr "" -#: ../src/Doc/library/calendar.rst:33 +#: library/calendar.rst:33 msgid "" "A :class:`Calendar` object provides several methods that can be used for " "preparing the calendar data for formatting. This class doesn't do any " "formatting itself. This is the job of subclasses." msgstr "" -#: ../src/Doc/library/calendar.rst:39 +#: library/calendar.rst:39 msgid ":class:`Calendar` instances have the following methods:" msgstr "" -#: ../src/Doc/library/calendar.rst:44 +#: library/calendar.rst:44 msgid "" "Return an iterator for the week day numbers that will be used for one week. " "The first value from the iterator will be the same as the value of the :attr:" "`firstweekday` property." msgstr "" -#: ../src/Doc/library/calendar.rst:51 +#: library/calendar.rst:51 msgid "" "Return an iterator for the month *month* (1-12) in the year *year*. This " "iterator will return all days (as :class:`datetime.date` objects) for the " @@ -8632,38 +8647,38 @@ msgid "" "month that are required to get a complete week." msgstr "" -#: ../src/Doc/library/calendar.rst:59 +#: library/calendar.rst:59 msgid "" "Return an iterator for the month *month* in the year *year* similar to :meth:" "`itermonthdates`. Days returned will be tuples consisting of a day number " "and a week day number." msgstr "" -#: ../src/Doc/library/calendar.rst:66 +#: library/calendar.rst:66 msgid "" "Return an iterator for the month *month* in the year *year* similar to :meth:" "`itermonthdates`. Days returned will simply be day numbers." msgstr "" -#: ../src/Doc/library/calendar.rst:72 +#: library/calendar.rst:72 msgid "" "Return a list of the weeks in the month *month* of the *year* as full " "weeks. Weeks are lists of seven :class:`datetime.date` objects." msgstr "" -#: ../src/Doc/library/calendar.rst:78 +#: library/calendar.rst:78 msgid "" "Return a list of the weeks in the month *month* of the *year* as full " "weeks. Weeks are lists of seven tuples of day numbers and weekday numbers." msgstr "" -#: ../src/Doc/library/calendar.rst:85 +#: library/calendar.rst:85 msgid "" "Return a list of the weeks in the month *month* of the *year* as full " "weeks. Weeks are lists of seven day numbers." msgstr "" -#: ../src/Doc/library/calendar.rst:91 +#: library/calendar.rst:91 msgid "" "Return the data for the specified year ready for formatting. The return " "value is a list of month rows. Each month row contains up to *width* months " @@ -8671,29 +8686,29 @@ msgid "" "contains 1--7 days. Days are :class:`datetime.date` objects." msgstr "" -#: ../src/Doc/library/calendar.rst:99 +#: library/calendar.rst:99 msgid "" "Return the data for the specified year ready for formatting (similar to :" "meth:`yeardatescalendar`). Entries in the week lists are tuples of day " "numbers and weekday numbers. Day numbers outside this month are zero." msgstr "" -#: ../src/Doc/library/calendar.rst:106 +#: library/calendar.rst:106 msgid "" "Return the data for the specified year ready for formatting (similar to :" "meth:`yeardatescalendar`). Entries in the week lists are day numbers. Day " "numbers outside this month are zero." msgstr "" -#: ../src/Doc/library/calendar.rst:113 +#: library/calendar.rst:113 msgid "This class can be used to generate plain text calendars." msgstr "" -#: ../src/Doc/library/calendar.rst:117 +#: library/calendar.rst:117 msgid ":class:`TextCalendar` instances have the following methods:" msgstr "" -#: ../src/Doc/library/calendar.rst:122 +#: library/calendar.rst:122 msgid "" "Return a month's calendar in a multi-line string. If *w* is provided, it " "specifies the width of the date columns, which are centered. If *l* is " @@ -8702,11 +8717,11 @@ msgid "" "`setfirstweekday` method." msgstr "" -#: ../src/Doc/library/calendar.rst:131 +#: library/calendar.rst:131 msgid "Print a month's calendar as returned by :meth:`formatmonth`." msgstr "" -#: ../src/Doc/library/calendar.rst:136 +#: library/calendar.rst:136 msgid "" "Return a *m*-column calendar for an entire year as a multi-line string. " "Optional parameters *w*, *l*, and *c* are for date column width, lines per " @@ -8716,32 +8731,32 @@ msgid "" "generated is platform-dependent." msgstr "" -#: ../src/Doc/library/calendar.rst:146 +#: library/calendar.rst:146 msgid "" "Print the calendar for an entire year as returned by :meth:`formatyear`." msgstr "" -#: ../src/Doc/library/calendar.rst:151 +#: library/calendar.rst:151 msgid "This class can be used to generate HTML calendars." msgstr "" -#: ../src/Doc/library/calendar.rst:155 +#: library/calendar.rst:155 msgid ":class:`HTMLCalendar` instances have the following methods:" msgstr "" -#: ../src/Doc/library/calendar.rst:160 +#: library/calendar.rst:160 msgid "" "Return a month's calendar as an HTML table. If *withyear* is true the year " "will be included in the header, otherwise just the month name will be used." msgstr "" -#: ../src/Doc/library/calendar.rst:167 +#: library/calendar.rst:167 msgid "" "Return a year's calendar as an HTML table. *width* (defaulting to 3) " "specifies the number of months per row." msgstr "" -#: ../src/Doc/library/calendar.rst:173 +#: library/calendar.rst:173 msgid "" "Return a year's calendar as a complete HTML page. *width* (defaulting to 3) " "specifies the number of months per row. *css* is the name for the cascading " @@ -8750,7 +8765,7 @@ msgid "" "(defaulting to the system default encoding)." msgstr "" -#: ../src/Doc/library/calendar.rst:182 +#: library/calendar.rst:182 msgid "" "This subclass of :class:`TextCalendar` can be passed a locale name in the " "constructor and will return month and weekday names in the specified locale. " @@ -8758,7 +8773,7 @@ msgid "" "names will be returned as unicode." msgstr "" -#: ../src/Doc/library/calendar.rst:192 +#: library/calendar.rst:192 msgid "" "This subclass of :class:`HTMLCalendar` can be passed a locale name in the " "constructor and will return month and weekday names in the specified locale. " @@ -8767,7 +8782,7 @@ msgid "" msgstr "" # decc42697769443192eb8a6728d9b530 -#: ../src/Doc/library/calendar.rst:201 +#: library/calendar.rst:201 msgid "" "The :meth:`formatweekday` and :meth:`formatmonthname` methods of these two " "classes temporarily change the current locale to the given *locale*. " @@ -8775,11 +8790,11 @@ msgid "" "safe." msgstr "" -#: ../src/Doc/library/calendar.rst:206 +#: library/calendar.rst:206 msgid "For simple text calendars this module provides the following functions." msgstr "" -#: ../src/Doc/library/calendar.rst:211 +#: library/calendar.rst:211 msgid "" "Sets the weekday (``0`` is Monday, ``6`` is Sunday) to start each week. The " "values :const:`MONDAY`, :const:`TUESDAY`, :const:`WEDNESDAY`, :const:" @@ -8787,69 +8802,75 @@ msgid "" "provided for convenience. For example, to set the first weekday to Sunday::" msgstr "" -#: ../src/Doc/library/calendar.rst:224 +#: library/calendar.rst:224 msgid "Returns the current setting for the weekday to start each week." msgstr "" -#: ../src/Doc/library/calendar.rst:231 +#: library/calendar.rst:231 msgid "" "Returns :const:`True` if *year* is a leap year, otherwise :const:`False`." msgstr "" -#: ../src/Doc/library/calendar.rst:236 +#: library/calendar.rst:236 msgid "" "Returns the number of leap years in the range from *y1* to *y2* (exclusive), " "where *y1* and *y2* are years." msgstr "" -#: ../src/Doc/library/calendar.rst:246 +#: library/calendar.rst:239 +msgid "" +"This function didn't work for ranges spanning a century change in Python " +"1.5.2." +msgstr "" + +#: library/calendar.rst:246 msgid "" "Returns the day of the week (``0`` is Monday) for *year* (``1970``--...), " "*month* (``1``--``12``), *day* (``1``--``31``)." msgstr "" -#: ../src/Doc/library/calendar.rst:252 +#: library/calendar.rst:252 msgid "" "Return a header containing abbreviated weekday names. *n* specifies the " "width in characters for one weekday." msgstr "" -#: ../src/Doc/library/calendar.rst:258 +#: library/calendar.rst:258 msgid "" "Returns weekday of first day of the month and number of days in month, for " "the specified *year* and *month*." msgstr "" -#: ../src/Doc/library/calendar.rst:264 +#: library/calendar.rst:264 msgid "" "Returns a matrix representing a month's calendar. Each row represents a " "week; days outside of the month a represented by zeros. Each week begins " "with Monday unless set by :func:`setfirstweekday`." msgstr "" -#: ../src/Doc/library/calendar.rst:271 +#: library/calendar.rst:271 msgid "Prints a month's calendar as returned by :func:`month`." msgstr "" -#: ../src/Doc/library/calendar.rst:276 +#: library/calendar.rst:276 msgid "" "Returns a month's calendar in a multi-line string using the :meth:" "`formatmonth` of the :class:`TextCalendar` class." msgstr "" -#: ../src/Doc/library/calendar.rst:284 +#: library/calendar.rst:284 msgid "" "Prints the calendar for an entire year as returned by :func:`calendar`." msgstr "" -#: ../src/Doc/library/calendar.rst:289 +#: library/calendar.rst:289 msgid "" "Returns a 3-column calendar for an entire year as a multi-line string using " "the :meth:`formatyear` of the :class:`TextCalendar` class." msgstr "" # 2bef06cee3184b0688043a5ac76c100b -#: ../src/Doc/library/calendar.rst:297 +#: library/calendar.rst:297 msgid "" "An unrelated but handy function that takes a time tuple such as returned by " "the :func:`~time.gmtime` function in the :mod:`time` module, and returns the " @@ -8858,63 +8879,60 @@ msgid "" "inverse." msgstr "" -#: ../src/Doc/library/calendar.rst:305 +#: library/calendar.rst:305 msgid "The :mod:`calendar` module exports the following data attributes:" msgstr "" -#: ../src/Doc/library/calendar.rst:310 +#: library/calendar.rst:310 msgid "An array that represents the days of the week in the current locale." msgstr "" -#: ../src/Doc/library/calendar.rst:315 +#: library/calendar.rst:315 msgid "" "An array that represents the abbreviated days of the week in the current " "locale." msgstr "" -#: ../src/Doc/library/calendar.rst:320 +#: library/calendar.rst:320 msgid "" "An array that represents the months of the year in the current locale. This " "follows normal convention of January being month number 1, so it has a " "length of 13 and ``month_name[0]`` is the empty string." msgstr "" -#: ../src/Doc/library/calendar.rst:327 +#: library/calendar.rst:327 msgid "" "An array that represents the abbreviated months of the year in the current " "locale. This follows normal convention of January being month number 1, so " "it has a length of 13 and ``month_abbr[0]`` is the empty string." msgstr "" -# e7d03010084c47bd97b9d07dc4f8726a -# 0225966ceafa469f98cb2acac72fe1a0 -#: ../src/Doc/library/calendar.rst:335 ../src/Doc/library/time.rst:550 -msgid "Module :mod:`datetime`" +#: library/calendar.rst:336 library/time.rst:550 +msgid "Module datetime" msgstr "" -#: ../src/Doc/library/calendar.rst:335 +#: library/calendar.rst:335 msgid "" "Object-oriented interface to dates and times with similar functionality to " "the :mod:`time` module." msgstr "" -# 12d9a70797b449468de6815d90bc049d -# 139b517f27f24355a2e36d2192e1bc7b -#: ../src/Doc/library/calendar.rst:337 ../src/Doc/library/datetime.rst:64 -msgid "Module :mod:`time`" -msgstr "" +#: library/calendar.rst:338 library/datetime.rst:65 +#, fuzzy +msgid "Module time" +msgstr "Modules" -#: ../src/Doc/library/calendar.rst:339 +#: library/calendar.rst:339 msgid "Low-level time related functions." msgstr "" # d0c4040278fa42ada62b39d2cc7d5d3a -#: ../src/Doc/library/carbon.rst:6 +#: library/carbon.rst:6 msgid "Mac OS Toolbox Modules" msgstr "" # c5c0163acdd041fe804bdaeaaf746cd6 -#: ../src/Doc/library/carbon.rst:8 +#: library/carbon.rst:8 msgid "" "These are a set of modules that provide interfaces to various legacy Mac OS " "toolboxes. If applicable the module will define a number of Python objects " @@ -8930,7 +8948,7 @@ msgid "" msgstr "" # 7d9b5bf050394a558c3102a051d4bee0 -#: ../src/Doc/library/carbon.rst:19 +#: library/carbon.rst:19 msgid "" "These modules all live in a package called :mod:`Carbon`. Despite that name " "they are not all part of the Carbon framework: CF is really in the " @@ -8939,7 +8957,7 @@ msgid "" msgstr "" # 84750412798042f3b0aee913e53e0963 -#: ../src/Doc/library/carbon.rst:27 +#: library/carbon.rst:27 msgid "" "Most of the OS X APIs that these modules use are deprecated or removed in " "recent versions of OS X. Many are not available when Python is executing in " @@ -8948,276 +8966,276 @@ msgid "" msgstr "" # 6b695d6f85d34b53bf678b6109ee868e -#: ../src/Doc/library/carbon.rst:34 +#: library/carbon.rst:34 msgid ":mod:`Carbon.AE` --- Apple Events" msgstr "" # 40c927efb9f34fdb8c561b884c1a2118 -#: ../src/Doc/library/carbon.rst:44 +#: library/carbon.rst:44 msgid ":mod:`Carbon.AH` --- Apple Help" msgstr "" # a3e5098e99d1450889aceb843dbb010d -#: ../src/Doc/library/carbon.rst:54 +#: library/carbon.rst:54 msgid ":mod:`Carbon.App` --- Appearance Manager" msgstr "" # e8c05c506bc2499984d1da6578a27ce1 -#: ../src/Doc/library/carbon.rst:62 +#: library/carbon.rst:62 msgid ":mod:`Carbon.Appearance` --- Appearance Manager constants" msgstr "" # 91df231425ee4f9ebfd2f42ebd9440ba -#: ../src/Doc/library/carbon.rst:72 +#: library/carbon.rst:72 msgid ":mod:`Carbon.CF` --- Core Foundation" msgstr "" # ddbfc0328f7640b9a92ca859f1d6f350 -#: ../src/Doc/library/carbon.rst:80 +#: library/carbon.rst:80 msgid "" "The ``CFBase``, ``CFArray``, ``CFData``, ``CFDictionary``, ``CFString`` and " "``CFURL`` objects are supported, some only partially." msgstr "" # 618b059dfbe64bf589768a9ebe422555 -#: ../src/Doc/library/carbon.rst:85 +#: library/carbon.rst:85 msgid ":mod:`Carbon.CG` --- Core Graphics" msgstr "" # cb92b0440b3442ca90fb713b27f28c90 -#: ../src/Doc/library/carbon.rst:95 +#: library/carbon.rst:95 msgid ":mod:`Carbon.CarbonEvt` --- Carbon Event Manager" msgstr "" # 90cc5b27983b4f1abe955a0e0c00996a -#: ../src/Doc/library/carbon.rst:103 +#: library/carbon.rst:103 msgid ":mod:`Carbon.CarbonEvents` --- Carbon Event Manager constants" msgstr "" # dd69e2e66989485a86775830ab510499 -#: ../src/Doc/library/carbon.rst:113 +#: library/carbon.rst:113 msgid ":mod:`Carbon.Cm` --- Component Manager" msgstr "" # 12a3c13f9edb46599b540c800de25d3d -#: ../src/Doc/library/carbon.rst:121 +#: library/carbon.rst:121 msgid ":mod:`Carbon.Components` --- Component Manager constants" msgstr "" # 529940b957f043adadac44426e655c3e -#: ../src/Doc/library/carbon.rst:130 +#: library/carbon.rst:130 msgid ":mod:`Carbon.ControlAccessor` --- Control Manager accssors" msgstr "" # 66a9801007184ef78eb39c7cd24fede0 -#: ../src/Doc/library/carbon.rst:138 +#: library/carbon.rst:138 msgid ":mod:`Carbon.Controls` --- Control Manager constants" msgstr "" # fedba208df3145938da0a5789c0848d1 -#: ../src/Doc/library/carbon.rst:146 +#: library/carbon.rst:146 msgid ":mod:`Carbon.CoreFounation` --- CoreFounation constants" msgstr "" # fc0d104fa6884a1d9b162a95b9294917 -#: ../src/Doc/library/carbon.rst:154 +#: library/carbon.rst:154 msgid ":mod:`Carbon.CoreGraphics` --- CoreGraphics constants" msgstr "" # bfb83a06cfc2496391aea55c0fdecc63 -#: ../src/Doc/library/carbon.rst:162 +#: library/carbon.rst:162 msgid ":mod:`Carbon.Ctl` --- Control Manager" msgstr "" # 0c08caea04424071923fae7a883bc09c -#: ../src/Doc/library/carbon.rst:170 +#: library/carbon.rst:170 msgid ":mod:`Carbon.Dialogs` --- Dialog Manager constants" msgstr "" # 7e883191bdc54f6089d6555179fb5041 -#: ../src/Doc/library/carbon.rst:178 +#: library/carbon.rst:178 msgid ":mod:`Carbon.Dlg` --- Dialog Manager" msgstr "" # 6dbfab15a113418f80bf74f03dad0cec -#: ../src/Doc/library/carbon.rst:186 +#: library/carbon.rst:186 msgid ":mod:`Carbon.Drag` --- Drag and Drop Manager" msgstr "" # 35b97f0c5fc946eb825766e8432cc577 -#: ../src/Doc/library/carbon.rst:194 +#: library/carbon.rst:194 msgid ":mod:`Carbon.Dragconst` --- Drag and Drop Manager constants" msgstr "" # 12908e0016b74ac2b92182ea924ff1bf -#: ../src/Doc/library/carbon.rst:202 +#: library/carbon.rst:202 msgid ":mod:`Carbon.Events` --- Event Manager constants" msgstr "" # 3b1f53b355294111a0e69c5970e79993 -#: ../src/Doc/library/carbon.rst:210 +#: library/carbon.rst:210 msgid ":mod:`Carbon.Evt` --- Event Manager" msgstr "" # f87ed6d9c1c04832b38688473ac69829 -#: ../src/Doc/library/carbon.rst:218 +#: library/carbon.rst:218 msgid ":mod:`Carbon.File` --- File Manager" msgstr "" # 5ecb8cc4ed1a4487aac56079351ef04b -#: ../src/Doc/library/carbon.rst:226 +#: library/carbon.rst:226 msgid ":mod:`Carbon.Files` --- File Manager constants" msgstr "" # 7e5b6ec10b454667ba8ab6c5f8b13873 -#: ../src/Doc/library/carbon.rst:235 +#: library/carbon.rst:235 msgid ":mod:`Carbon.Fm` --- Font Manager" msgstr "" # 13f4254f98a5447d820b1c1bbce036e3 -#: ../src/Doc/library/carbon.rst:245 +#: library/carbon.rst:245 msgid ":mod:`Carbon.Folder` --- Folder Manager" msgstr "" # 1a65378e8e41495daca5dce771960089 -#: ../src/Doc/library/carbon.rst:253 +#: library/carbon.rst:253 msgid ":mod:`Carbon.Folders` --- Folder Manager constants" msgstr "" # 0a8a289b2f364269a4a916fe00debe47 -#: ../src/Doc/library/carbon.rst:262 +#: library/carbon.rst:262 msgid ":mod:`Carbon.Fonts` --- Font Manager constants" msgstr "" # e3a10495083846868fb95e250a9c702d -#: ../src/Doc/library/carbon.rst:272 +#: library/carbon.rst:272 msgid ":mod:`Carbon.Help` --- Help Manager" msgstr "" # 4eab889c2b3f46b8b8d87d08a2f4821c -#: ../src/Doc/library/carbon.rst:280 +#: library/carbon.rst:280 msgid ":mod:`Carbon.IBCarbon` --- Carbon InterfaceBuilder" msgstr "" # f99bdea63a944540bd34d89341882799 -#: ../src/Doc/library/carbon.rst:288 +#: library/carbon.rst:288 msgid ":mod:`Carbon.IBCarbonRuntime` --- Carbon InterfaceBuilder constants" msgstr "" # 57d78035aab3419b9ce02125a35920a7 -#: ../src/Doc/library/carbon.rst:296 +#: library/carbon.rst:296 msgid ":mod:`Carbon.Icn` --- Carbon Icon Manager" msgstr "" # b7c5a5bcb3c84c958eb3ab3f65f8cb25 -#: ../src/Doc/library/carbon.rst:304 +#: library/carbon.rst:304 msgid ":mod:`Carbon.Icons` --- Carbon Icon Manager constants" msgstr "" # cc53cb0aaeff4ba8993f1259156caf1a -#: ../src/Doc/library/carbon.rst:312 +#: library/carbon.rst:312 msgid ":mod:`Carbon.Launch` --- Carbon Launch Services" msgstr "" # 9d6445a6d44a4407806cc1207f6e9450 -#: ../src/Doc/library/carbon.rst:320 +#: library/carbon.rst:320 msgid ":mod:`Carbon.LaunchServices` --- Carbon Launch Services constants" msgstr "" # 4fbbe6ca102f4acfa18a1ba211a370c7 -#: ../src/Doc/library/carbon.rst:329 +#: library/carbon.rst:329 msgid ":mod:`Carbon.List` --- List Manager" msgstr "" # 3d845687679f43e98348975756a57da7 -#: ../src/Doc/library/carbon.rst:339 +#: library/carbon.rst:339 msgid ":mod:`Carbon.Lists` --- List Manager constants" msgstr "" # 4efc7c9edfa241d88526db921b0515fc -#: ../src/Doc/library/carbon.rst:347 +#: library/carbon.rst:347 msgid ":mod:`Carbon.MacHelp` --- Help Manager constants" msgstr "" # 9dca8ce49fe8463f9700b14687d9cf17 -#: ../src/Doc/library/carbon.rst:355 +#: library/carbon.rst:355 msgid "" ":mod:`Carbon.MediaDescr` --- Parsers and generators for Quicktime Media " "descriptors" msgstr "" # 2ef5e2afda9445d784ab5e33b4aab5ca -#: ../src/Doc/library/carbon.rst:364 +#: library/carbon.rst:364 msgid ":mod:`Carbon.Menu` --- Menu Manager" msgstr "" # 2a2d0416a2714ea2bd4be0c88e00053a -#: ../src/Doc/library/carbon.rst:372 +#: library/carbon.rst:372 msgid ":mod:`Carbon.Menus` --- Menu Manager constants" msgstr "" # f5da1ecbfa894af9aaae9e1297f45dba -#: ../src/Doc/library/carbon.rst:381 +#: library/carbon.rst:381 msgid ":mod:`Carbon.Mlte` --- MultiLingual Text Editor" msgstr "" # b60b9ea5da9e47e29e4cdc5cbe3ae42a -#: ../src/Doc/library/carbon.rst:389 +#: library/carbon.rst:389 msgid ":mod:`Carbon.OSA` --- Carbon OSA Interface" msgstr "" # 4b2fea6c60a64a92b6c9297d5551eebd -#: ../src/Doc/library/carbon.rst:397 +#: library/carbon.rst:397 msgid ":mod:`Carbon.OSAconst` --- Carbon OSA Interface constants" msgstr "" # 946222d64b41452d800c6dbebcf856fa -#: ../src/Doc/library/carbon.rst:405 +#: library/carbon.rst:405 msgid ":mod:`Carbon.QDOffscreen` --- QuickDraw Offscreen constants" msgstr "" # 2f1a42d12d734e5f9f5a8cb8afc32d36 -#: ../src/Doc/library/carbon.rst:414 +#: library/carbon.rst:414 msgid ":mod:`Carbon.Qd` --- QuickDraw" msgstr "" # 11d02fef37504243bc5028dd7e197846 -#: ../src/Doc/library/carbon.rst:424 +#: library/carbon.rst:424 msgid ":mod:`Carbon.Qdoffs` --- QuickDraw Offscreen" msgstr "" # 5cc0dd1f8cb043f5a3ccd20371a1b5a2 -#: ../src/Doc/library/carbon.rst:434 +#: library/carbon.rst:434 msgid ":mod:`Carbon.Qt` --- QuickTime" msgstr "" # b055b6bc9b5243228d5d596bf9c5895a -#: ../src/Doc/library/carbon.rst:442 +#: library/carbon.rst:442 msgid ":mod:`Carbon.QuickDraw` --- QuickDraw constants" msgstr "" # 8e5fbc486d0842289e07419b1121f5a6 -#: ../src/Doc/library/carbon.rst:450 +#: library/carbon.rst:450 msgid ":mod:`Carbon.QuickTime` --- QuickTime constants" msgstr "" # a4865b1ababf4572a6f110141cc21c16 -#: ../src/Doc/library/carbon.rst:459 +#: library/carbon.rst:459 msgid ":mod:`Carbon.Res` --- Resource Manager and Handles" msgstr "" # fa5aff13c6c4416f987c6a02148f24be -#: ../src/Doc/library/carbon.rst:467 +#: library/carbon.rst:467 msgid ":mod:`Carbon.Resources` --- Resource Manager and Handles constants" msgstr "" # 3aceb538499a447ebaaf9503bdc55e59 -#: ../src/Doc/library/carbon.rst:476 +#: library/carbon.rst:476 msgid ":mod:`Carbon.Scrap` --- Scrap Manager" msgstr "" # a37f531b45ba44c9834b7a9b6acdfd2f -#: ../src/Doc/library/carbon.rst:485 +#: library/carbon.rst:485 msgid "" "This module is only fully available on Mac OS 9 and earlier under classic " "PPC MacPython. Very limited functionality is available under Carbon " @@ -9225,7 +9243,7 @@ msgid "" msgstr "" # b034f1b3e58d4ece877383c4ee717057 -#: ../src/Doc/library/carbon.rst:490 +#: library/carbon.rst:490 msgid "" "The Scrap Manager supports the simplest form of cut & paste operations on " "the Macintosh. It can be use for both inter- and intra-application " @@ -9233,133 +9251,134 @@ msgid "" msgstr "" # 2a1df9fc869949f4aab49ba6d25fab0f -#: ../src/Doc/library/carbon.rst:494 +#: library/carbon.rst:494 msgid "" "The :mod:`Scrap` module provides low-level access to the functions of the " "Scrap Manager. It contains the following functions:" msgstr "" # 7ea1c8a553184ddaa44ed73dc547d680 -#: ../src/Doc/library/carbon.rst:500 +#: library/carbon.rst:500 msgid "" "Return current information about the scrap. The information is encoded as a " "tuple containing the fields ``(size, handle, count, state, path)``." msgstr "" -#: ../src/Doc/library/carbon.rst:504 ../src/Doc/library/resource.rst:181 -#: ../src/Doc/library/sunau.rst:20 ../src/Doc/library/uuid.rst:69 +#: library/carbon.rst:504 library/resource.rst:181 library/sunau.rst:20 +#: library/uuid.rst:69 msgid "Field" msgstr "" # 6a07ce0dfd6e4646ae8fcd4ccde79cab -#: ../src/Doc/library/carbon.rst:506 +#: library/carbon.rst:506 msgid "*size*" msgstr "" # 12ef6cd29dee47e0bb7ea002fea9aac8 -#: ../src/Doc/library/carbon.rst:506 +#: library/carbon.rst:506 msgid "Size of the scrap in bytes." msgstr "" # 87ddb41a9d78482ea7a021ca9fcc9275 -#: ../src/Doc/library/carbon.rst:508 +#: library/carbon.rst:508 msgid "*handle*" msgstr "" # e5d334f4817f4f2eb0bd65714584938f -#: ../src/Doc/library/carbon.rst:508 +#: library/carbon.rst:508 msgid "Resource object representing the scrap." msgstr "" # 72a4f46de1f44400ab64b8fd9951fa7e -#: ../src/Doc/library/carbon.rst:510 +#: library/carbon.rst:510 msgid "*count*" msgstr "" # 454cbddf972f44c6ad89d56558ff7706 -#: ../src/Doc/library/carbon.rst:510 +#: library/carbon.rst:510 msgid "Serial number of the scrap contents." msgstr "" # 9b4813096b444ce5b2cfb40c4ad32d0c -#: ../src/Doc/library/carbon.rst:512 +#: library/carbon.rst:512 msgid "*state*" msgstr "" # 46d44dac6328406291c74dd94c4e6e16 -#: ../src/Doc/library/carbon.rst:512 +#: library/carbon.rst:512 msgid "" "Integer; positive if in memory, ``0`` if on disk, negative if uninitialized." msgstr "" # 190bd18f51f149bab71c391798e0d641 -#: ../src/Doc/library/carbon.rst:515 +#: library/carbon.rst:515 msgid "*path*" msgstr "" # 88965c7b2625470abe66cabb3b21d21f -#: ../src/Doc/library/carbon.rst:515 +#: library/carbon.rst:515 msgid "Filename of the scrap when stored on disk." msgstr "" -# 6e331717ea5c406a93983b236887e5b0 -#: ../src/Doc/library/carbon.rst:521 -msgid "" -"`Scrap Manager `_" +#: library/carbon.rst:522 +msgid "Scrap Manager" msgstr "" # feb7ce22a7e8429fbe712d7c0d2b8466 -#: ../src/Doc/library/carbon.rst:522 +#: library/carbon.rst:522 msgid "" "Apple's documentation for the Scrap Manager gives a lot of useful " "information about using the Scrap Manager in applications." msgstr "" # a0ae86af9d0448788e219235f6a24eea -#: ../src/Doc/library/carbon.rst:528 +#: library/carbon.rst:528 msgid ":mod:`Carbon.Snd` --- Sound Manager" msgstr "" # 2d51cbf67f394b24813eaf2462da8415 -#: ../src/Doc/library/carbon.rst:536 +#: library/carbon.rst:536 msgid ":mod:`Carbon.Sound` --- Sound Manager constants" msgstr "" # aea86c0fe9b048ec907655914426dd4e -#: ../src/Doc/library/carbon.rst:545 +#: library/carbon.rst:545 msgid ":mod:`Carbon.TE` --- TextEdit" msgstr "" # c6ac32f7b28a48329386003741eeb766 -#: ../src/Doc/library/carbon.rst:553 +#: library/carbon.rst:553 msgid ":mod:`Carbon.TextEdit` --- TextEdit constants" msgstr "" # 5f565835a5da4ad688ab79509af396cc -#: ../src/Doc/library/carbon.rst:563 +#: library/carbon.rst:563 msgid ":mod:`Carbon.Win` --- Window Manager" msgstr "" # 2c75a8a917d54085921663d5c3da0085 -#: ../src/Doc/library/carbon.rst:571 +#: library/carbon.rst:571 msgid ":mod:`Carbon.Windows` --- Window Manager constants" msgstr "" # 81de9d3420ed4884884bc37f1ccd0487 -#: ../src/Doc/library/cd.rst:3 +#: library/cd.rst:3 msgid ":mod:`cd` --- CD-ROM access on SGI systems" msgstr "" +#: library/cd.rst:11 +msgid "The :mod:`cd` module has been removed in Python 3." +msgstr "" + # ffd15a5af292470681075fac91b0ed64 -#: ../src/Doc/library/cd.rst:15 +#: library/cd.rst:15 msgid "" "This module provides an interface to the Silicon Graphics CD library. It is " "available only on Silicon Graphics systems." msgstr "" # 297b390ecd3048b88b4c4a9f54655197 -#: ../src/Doc/library/cd.rst:18 +#: library/cd.rst:18 msgid "" "The way the library works is as follows. A program opens the CD-ROM device " "with :func:`.open` and creates a parser to parse the data from the CD with :" @@ -9371,7 +9390,7 @@ msgid "" msgstr "" # f6dfc73f4674499995b9e23921eb4a57 -#: ../src/Doc/library/cd.rst:26 +#: library/cd.rst:26 msgid "" "An audio CD is divided into :dfn:`tracks` or :dfn:`programs` (the terms are " "used interchangeably). Tracks can be subdivided into :dfn:`indices`. An " @@ -9382,7 +9401,7 @@ msgid "" msgstr "" # 9c7cd429b2884a668423fb9cd675e93b -#: ../src/Doc/library/cd.rst:32 +#: library/cd.rst:32 msgid "" "Positions on a CD can be represented in two ways. Either a frame number or " "a tuple of three values, minutes, seconds and frames. Most functions use " @@ -9391,26 +9410,26 @@ msgid "" msgstr "" # b869e6541a0941a482e5e693dd29d692 -#: ../src/Doc/library/cd.rst:37 +#: library/cd.rst:37 msgid "Module :mod:`cd` defines the following functions and constants:" msgstr "" # 127010fac4e74e079ce8a8625ba1c06e -#: ../src/Doc/library/cd.rst:42 +#: library/cd.rst:42 msgid "" "Create and return an opaque parser object. The methods of the parser object " "are described below." msgstr "" # 41c1e2d168ec4ab683c53a40477ff6a2 -#: ../src/Doc/library/cd.rst:48 +#: library/cd.rst:48 msgid "" "Converts a ``(minutes, seconds, frames)`` triple representing time in " "absolute time code into the corresponding CD frame number." msgstr "" # 7a0205f80efe4bf7993a78fc8140fbe4 -#: ../src/Doc/library/cd.rst:54 +#: library/cd.rst:54 msgid "" "Open the CD-ROM device. The return value is an opaque player object; " "methods of the player object are described below. The device is the name of " @@ -9420,99 +9439,99 @@ msgid "" msgstr "" # 2399e1271dbf4a3b95258820c380f7d8 -#: ../src/Doc/library/cd.rst:60 +#: library/cd.rst:60 msgid "The module defines the following variables:" msgstr "" # 38185698b2b14a81a65f04393dc72a68 -#: ../src/Doc/library/cd.rst:65 +#: library/cd.rst:65 msgid "Exception raised on various errors." msgstr "" # 409db7fa947f4753b674db8bdb50bca7 -#: ../src/Doc/library/cd.rst:70 +#: library/cd.rst:70 msgid "" "The size of one frame's worth of audio data. This is the size of the audio " "data as passed to the callback of type ``audio``." msgstr "" # 59fd48a315e6401a8821bc8498608569 -#: ../src/Doc/library/cd.rst:76 +#: library/cd.rst:76 msgid "The size of one uninterpreted frame of audio data." msgstr "" # a90f6800cd4b444fa8abe5f3bfaf9e6e -#: ../src/Doc/library/cd.rst:78 +#: library/cd.rst:78 msgid "The following variables are states as returned by :func:`getstatus`:" msgstr "" # 5a571ec91a7d43cf96929e28f4d38802 -#: ../src/Doc/library/cd.rst:83 +#: library/cd.rst:83 msgid "The drive is ready for operation loaded with an audio CD." msgstr "" # 57f51058187d444fbf8a7c305ae17c3e -#: ../src/Doc/library/cd.rst:88 +#: library/cd.rst:88 msgid "The drive does not have a CD loaded." msgstr "" # c4f93bb69ab4469fba5e90416ece49a5 -#: ../src/Doc/library/cd.rst:93 +#: library/cd.rst:93 msgid "" "The drive is loaded with a CD-ROM. Subsequent play or read operations will " "return I/O errors." msgstr "" # b1df4468413b495f978653c39cde323e -#: ../src/Doc/library/cd.rst:99 +#: library/cd.rst:99 msgid "" "An error occurred while trying to read the disc or its table of contents." msgstr "" # 1ee6a0aa39894968ad8ec11ce50b80db -#: ../src/Doc/library/cd.rst:104 +#: library/cd.rst:104 msgid "" "The drive is in CD player mode playing an audio CD through its audio jacks." msgstr "" # d4d00273ed44499fb03f7eec6302dbfc -#: ../src/Doc/library/cd.rst:109 +#: library/cd.rst:109 msgid "The drive is in CD layer mode with play paused." msgstr "" # 5bc5ab5380e849f4ab90beb089f11ba7 -#: ../src/Doc/library/cd.rst:114 +#: library/cd.rst:114 msgid "" "The equivalent of :const:`PAUSED` on older (non 3301) model Toshiba CD-ROM " "drives. Such drives have never been shipped by SGI." msgstr "" # 3cf647c1985f45f3bf724d1bcc73cea5 -#: ../src/Doc/library/cd.rst:127 +#: library/cd.rst:127 msgid "" "Integer constants describing the various types of parser callbacks that can " "be set by the :meth:`addcallback` method of CD parser objects (see below)." msgstr "" # 1025cebcf3f44a64b6f9c2781b3eb66d -#: ../src/Doc/library/cd.rst:134 +#: library/cd.rst:134 msgid "Player Objects" msgstr "" # 0f20cadb800e41718700016be39d78c7 -#: ../src/Doc/library/cd.rst:136 +#: library/cd.rst:136 msgid "Player objects (returned by :func:`.open`) have the following methods:" msgstr "" # 34a7a404271f4dc4bbd4285f6a929c92 -#: ../src/Doc/library/cd.rst:141 +#: library/cd.rst:141 msgid "" "Unlocks the eject button on the CD-ROM drive permitting the user to eject " "the caddy if desired." msgstr "" # 5c9599c441a24bbb925be70ae189e9b0 -#: ../src/Doc/library/cd.rst:147 +#: library/cd.rst:147 msgid "" "Returns the best value to use for the *num_frames* parameter of the :meth:" "`readda` method. Best is defined as the value that permits a continuous " @@ -9520,19 +9539,19 @@ msgid "" msgstr "" # 38b0abab48c8409286e512bc3ab2ac62 -#: ../src/Doc/library/cd.rst:154 +#: library/cd.rst:154 msgid "" "Frees the resources associated with the player object. After calling :meth:" "`close`, the methods of the object should no longer be used." msgstr "" # 2638559c71cf4d3a8029bfccbb7f3acd -#: ../src/Doc/library/cd.rst:160 +#: library/cd.rst:160 msgid "Ejects the caddy from the CD-ROM drive." msgstr "" # 8ba95703ac60493b9daa7ea9fe7415ed -#: ../src/Doc/library/cd.rst:165 +#: library/cd.rst:165 msgid "" "Returns information pertaining to the current state of the CD-ROM drive. " "The returned information is a tuple with the following values: *state*, " @@ -9546,7 +9565,7 @@ msgid "" msgstr "" # 9c0e36880807433b9f5e00db5aac240e -#: ../src/Doc/library/cd.rst:178 +#: library/cd.rst:178 msgid "" "Returns information about the specified track. The returned information is " "a tuple consisting of two elements, the start time of the track and the " @@ -9554,7 +9573,7 @@ msgid "" msgstr "" # ebabebf546fc4b4481b9c8414737a03a -#: ../src/Doc/library/cd.rst:185 +#: library/cd.rst:185 msgid "" "Converts a minutes, seconds, frames triple representing a time in absolute " "time code into the corresponding logical block number for the given CD-ROM " @@ -9564,7 +9583,7 @@ msgid "" msgstr "" # 340eca31f4f84d2e98559520d312ddfb -#: ../src/Doc/library/cd.rst:194 +#: library/cd.rst:194 msgid "" "Starts playback of an audio CD in the CD-ROM drive at the specified track. " "The audio output appears on the CD-ROM drive's headphone and audio jacks (if " @@ -9575,33 +9594,33 @@ msgid "" msgstr "" # 0ada199c6c8541fd859eca7f7031a41e -#: ../src/Doc/library/cd.rst:204 +#: library/cd.rst:204 msgid "" "Like :meth:`play`, except that the start is given in minutes, seconds, and " "frames instead of a track number." msgstr "" # af65555313f34aefb1bf7623b964894a -#: ../src/Doc/library/cd.rst:210 +#: library/cd.rst:210 msgid "Like :meth:`play`, except that playing stops at the end of the track." msgstr "" # d1fc005ae970407eb1554289331b30a0 -#: ../src/Doc/library/cd.rst:215 +#: library/cd.rst:215 msgid "" "Like :meth:`play`, except that playing begins at the specified absolute time " "and ends at the end of the specified track." msgstr "" # 1affb80028374e80aed133b500620579 -#: ../src/Doc/library/cd.rst:221 +#: library/cd.rst:221 msgid "" "Locks the eject button on the CD-ROM drive thus preventing the user from " "arbitrarily ejecting the caddy." msgstr "" # 80fbf4bfe9cc41d5a0b292d62f358b20 -#: ../src/Doc/library/cd.rst:227 +#: library/cd.rst:227 msgid "" "Reads the specified number of frames from an audio CD mounted in the CD-ROM " "drive. The return value is a string representing the audio frames. This " @@ -9610,7 +9629,7 @@ msgid "" msgstr "" # f77dc8d581d7461a83b72ed9c52837b6 -#: ../src/Doc/library/cd.rst:234 +#: library/cd.rst:234 msgid "" "Sets the pointer that indicates the starting point of the next read of " "digital audio data from a CD-ROM. The pointer is set to an absolute time " @@ -9619,7 +9638,7 @@ msgid "" msgstr "" # adfba0dfade64775b2f78dc05cae21c3 -#: ../src/Doc/library/cd.rst:242 +#: library/cd.rst:242 msgid "" "Sets the pointer that indicates the starting point of the next read of " "digital audio data from a CD-ROM. The pointer is set to the specified " @@ -9628,7 +9647,7 @@ msgid "" msgstr "" # 0c93c12b623e454a8c394aac25be4b4a -#: ../src/Doc/library/cd.rst:250 +#: library/cd.rst:250 msgid "" "Sets the pointer that indicates the starting point of the next read of " "digital audio data from a CD-ROM. The pointer is set to the specified " @@ -9637,28 +9656,28 @@ msgid "" msgstr "" # 35e784d1b32245e3a603bd286f95d8b1 -#: ../src/Doc/library/cd.rst:257 +#: library/cd.rst:257 msgid "Stops the current playing operation." msgstr "" # 851c71eaba414e17a97a0038bc793c0e -#: ../src/Doc/library/cd.rst:262 +#: library/cd.rst:262 msgid "Pauses the CD if it is playing, and makes it play if it is paused." msgstr "" # f02edeb2658340bdb1b25270dfa1bfde -#: ../src/Doc/library/cd.rst:268 +#: library/cd.rst:268 msgid "Parser Objects" msgstr "" # d284d7205b944a0ab2c910347444f509 -#: ../src/Doc/library/cd.rst:270 +#: library/cd.rst:270 msgid "" "Parser objects (returned by :func:`createparser`) have the following methods:" msgstr "" # bec3c2efc923498fa9558e99597e8852 -#: ../src/Doc/library/cd.rst:275 +#: library/cd.rst:275 msgid "" "Adds a callback for the parser. The parser has callbacks for eight " "different types of data in the digital audio data stream. Constants for " @@ -9669,79 +9688,78 @@ msgid "" "data depends on the *type* of callback as follows:" msgstr "" -#: ../src/Doc/library/cd.rst:284 ../src/Doc/library/inspect.rst:40 -#: ../src/Doc/library/string.rst:409 ../src/Doc/library/string.rst:420 -#: ../src/Doc/library/string.rst:452 +#: library/cd.rst:284 library/inspect.rst:40 library/string.rst:409 +#: library/string.rst:420 library/string.rst:452 msgid "Type" msgstr "" # cd01837d81594f7eb9c5c696ac5da6fe -#: ../src/Doc/library/cd.rst:286 +#: library/cd.rst:286 msgid "``audio``" msgstr "" # beba45182c684e98a815ff59862ef6bf -#: ../src/Doc/library/cd.rst:286 +#: library/cd.rst:286 msgid "String which can be passed unmodified to :func:`al.writesamps`." msgstr "" # be8ece6512164efb8b1935e72715d71d -#: ../src/Doc/library/cd.rst:289 +#: library/cd.rst:289 msgid "``pnum``" msgstr "" # 28010fc2e189410098bb27883a0aae55 -#: ../src/Doc/library/cd.rst:289 +#: library/cd.rst:289 msgid "Integer giving the program (track) number." msgstr "" # 5ce039554f9b4dbea1178216ca3b79ad -#: ../src/Doc/library/cd.rst:291 +#: library/cd.rst:291 msgid "``index``" msgstr "" # 18bf4a75a25540eba6008f2347da73eb -#: ../src/Doc/library/cd.rst:291 +#: library/cd.rst:291 msgid "Integer giving the index number." msgstr "" # 157a45fabb3940ef8b83b6b97ecf7e58 -#: ../src/Doc/library/cd.rst:293 +#: library/cd.rst:293 msgid "``ptime``" msgstr "" # b9c0082c8e004d8cab66a9a1e3cb4af2 -#: ../src/Doc/library/cd.rst:293 +#: library/cd.rst:293 msgid "Tuple consisting of the program time in minutes, seconds, and frames." msgstr "" # 4d8ddec9c2684816a5ae8c570edb5bfd -#: ../src/Doc/library/cd.rst:296 +#: library/cd.rst:296 msgid "``atime``" msgstr "" # 93510a35d32041b09c44f02c1b8116a6 -#: ../src/Doc/library/cd.rst:296 +#: library/cd.rst:296 msgid "Tuple consisting of the absolute time in minutes, seconds, and frames." msgstr "" # 68c840da51c8435283643aad545aa80a -#: ../src/Doc/library/cd.rst:299 +#: library/cd.rst:299 msgid "``catalog``" msgstr "" # 163da889e8ff43709b810a6a53b028cf -#: ../src/Doc/library/cd.rst:299 +#: library/cd.rst:299 msgid "String of 13 characters, giving the catalog number of the CD." msgstr "" # bd94630881da4855aa5cd52bcc0de8bb -#: ../src/Doc/library/cd.rst:302 +#: library/cd.rst:302 msgid "``ident``" msgstr "" # 62e81e8a62a64dd184ac9afcc3a89aa1 -#: ../src/Doc/library/cd.rst:302 +#: library/cd.rst:302 msgid "" "String of 12 characters, giving the ISRC identification number of the " "recording. The string consists of two characters country code, three " @@ -9750,17 +9768,17 @@ msgid "" msgstr "" # 2c42a3341b894501991cb26a21097d0e -#: ../src/Doc/library/cd.rst:309 +#: library/cd.rst:309 msgid "``control``" msgstr "" # 28a4600c0f9a459c81b1d6b63fd556e6 -#: ../src/Doc/library/cd.rst:309 +#: library/cd.rst:309 msgid "Integer giving the control bits from the CD subcode data" msgstr "" # 856cf1c794bf45c9bef158778b974ea7 -#: ../src/Doc/library/cd.rst:316 +#: library/cd.rst:316 msgid "" "Deletes the parser and frees the memory it was using. The object should not " "be used after this call. This call is done automatically when the last " @@ -9768,7 +9786,7 @@ msgid "" msgstr "" # f67d52def94144c5a5aa4e31803c0aeb -#: ../src/Doc/library/cd.rst:323 +#: library/cd.rst:323 msgid "" "Parses one or more frames of digital audio data from a CD such as returned " "by :meth:`readda`. It determines which subcodes are present in the data. " @@ -9779,49 +9797,48 @@ msgid "" msgstr "" # 156a3b82d189458ebfa50d2ac8dd073c -#: ../src/Doc/library/cd.rst:333 +#: library/cd.rst:333 msgid "Removes the callback for the given *type*." msgstr "" # 8e3c5c54eb314512b76902c1f7f15b74 -#: ../src/Doc/library/cd.rst:338 +#: library/cd.rst:338 msgid "" "Resets the fields of the parser used for tracking subcodes to an initial " "state. :meth:`resetparser` should be called after the disc has been changed." msgstr "" -#: ../src/Doc/library/cgi.rst:2 +#: library/cgi.rst:2 msgid ":mod:`cgi` --- Common Gateway Interface support" msgstr "" # 81616c4cd522437a9649a40022a1d030 -#: ../src/Doc/library/cgi.rst:16 +#: library/cgi.rst:16 msgid "**Source code:** :source:`Lib/cgi.py`" msgstr "" -#: ../src/Doc/library/cgi.rst:20 +#: library/cgi.rst:20 msgid "Support module for Common Gateway Interface (CGI) scripts." msgstr "" -#: ../src/Doc/library/cgi.rst:22 +#: library/cgi.rst:22 msgid "" "This module defines a number of utilities for use by CGI scripts written in " "Python." msgstr "" -#: ../src/Doc/library/cgi.rst:27 ../src/Doc/library/intro.rst:6 -#: ../src/Doc/library/multiprocessing.rst:11 ../src/Doc/library/sqlite3.rst:673 -#: ../src/Doc/library/turtle.rst:15 +#: library/cgi.rst:27 library/intro.rst:6 library/multiprocessing.rst:11 +#: library/sqlite3.rst:673 library/turtle.rst:15 msgid "Introduction" msgstr "Introduction" -#: ../src/Doc/library/cgi.rst:31 +#: library/cgi.rst:31 msgid "" "A CGI script is invoked by an HTTP server, usually to process user input " "submitted through an HTML ``
`` or ```` element." msgstr "" -#: ../src/Doc/library/cgi.rst:34 +#: library/cgi.rst:34 msgid "" "Most often, CGI scripts live in the server's special :file:`cgi-bin` " "directory. The HTTP server places all sorts of information about the request " @@ -9830,7 +9847,7 @@ msgid "" "script, and sends the script's output back to the client." msgstr "" -#: ../src/Doc/library/cgi.rst:40 +#: library/cgi.rst:40 msgid "" "The script's input is connected to the client too, and sometimes the form " "data is read this way; at other times the form data is passed via the " @@ -9841,7 +9858,7 @@ msgid "" "supports it)." msgstr "" -#: ../src/Doc/library/cgi.rst:47 +#: library/cgi.rst:47 msgid "" "The output of a CGI script should consist of two sections, separated by a " "blank line. The first section contains a number of headers, telling the " @@ -9849,30 +9866,30 @@ msgid "" "header section looks like this::" msgstr "" -#: ../src/Doc/library/cgi.rst:55 +#: library/cgi.rst:55 msgid "" "The second section is usually HTML, which allows the client software to " "display nicely formatted text with header, in-line images, etc. Here's " "Python code that prints a simple piece of HTML::" msgstr "" -#: ../src/Doc/library/cgi.rst:67 +#: library/cgi.rst:67 msgid "Using the cgi module" msgstr "" # 7d8d6104495149e28cde49aab860d599 -#: ../src/Doc/library/cgi.rst:69 +#: library/cgi.rst:69 msgid "" "Begin by writing ``import cgi``. Do not use ``from cgi import *`` --- the " "module defines all sorts of names for its own use or for backward " "compatibility that you don't want in your namespace." msgstr "" -#: ../src/Doc/library/cgi.rst:73 +#: library/cgi.rst:73 msgid "When you write a new script, consider adding these lines::" msgstr "" -#: ../src/Doc/library/cgi.rst:78 +#: library/cgi.rst:78 msgid "" "This activates a special exception handler that will display detailed " "reports in the Web browser if any errors occur. If you'd rather not show " @@ -9880,7 +9897,7 @@ msgid "" "saved to files instead, with code like this::" msgstr "" -#: ../src/Doc/library/cgi.rst:86 +#: library/cgi.rst:86 msgid "" "It's very helpful to use this feature during script development. The reports " "produced by :mod:`cgitb` provide information that can save you a lot of time " @@ -9889,7 +9906,7 @@ msgid "" msgstr "" # 33e38e39b2094d9f856427fafe696e65 -#: ../src/Doc/library/cgi.rst:91 +#: library/cgi.rst:91 msgid "" "To get at submitted form data, it's best to use the :class:`FieldStorage` " "class. The other classes defined in this module are provided mostly for " @@ -9901,7 +9918,7 @@ msgid "" msgstr "" # 3c41531cd21d4fdb846c88f853158ed2 -#: ../src/Doc/library/cgi.rst:98 +#: library/cgi.rst:98 msgid "" "The :class:`FieldStorage` instance can be indexed like a Python dictionary. " "It allows membership testing with the :keyword:`in` operator, and also " @@ -9912,7 +9929,7 @@ msgid "" "class:`FieldStorage` instance." msgstr "" -#: ../src/Doc/library/cgi.rst:106 +#: library/cgi.rst:106 msgid "" "For instance, the following code (which assumes that the :mailheader:" "`Content-Type` header and blank line have already been printed) checks that " @@ -9920,7 +9937,7 @@ msgid "" msgstr "" # ed1b43aed5474387b1e799169ce3dfad -#: ../src/Doc/library/cgi.rst:120 +#: library/cgi.rst:120 msgid "" "Here the fields, accessed through ``form[key]``, are themselves instances " "of :class:`FieldStorage` (or :class:`MiniFieldStorage`, depending on the " @@ -9931,7 +9948,7 @@ msgid "" msgstr "" # 453103561f0147ae9521ce9bc5b42bd4 -#: ../src/Doc/library/cgi.rst:127 +#: library/cgi.rst:127 msgid "" "If the submitted form data contains more than one field with the same name, " "the object retrieved by ``form[key]`` is not a :class:`FieldStorage` or :" @@ -9945,7 +9962,7 @@ msgid "" msgstr "" # 819bfa2a33fe4752bdd1f9e67b1363f1 -#: ../src/Doc/library/cgi.rst:140 +#: library/cgi.rst:140 msgid "" "If a field represents an uploaded file, accessing the value via the :attr:" "`~FieldStorage.value` attribute or the :func:`~FieldStorage.getvalue` method " @@ -9956,7 +9973,7 @@ msgid "" msgstr "" # 2e679121691845a0b6cb68784350182e -#: ../src/Doc/library/cgi.rst:157 +#: library/cgi.rst:157 msgid "" "If an error is encountered when obtaining the contents of an uploaded file " "(for example, when the user interrupts the form submission by clicking on a " @@ -9964,7 +9981,7 @@ msgid "" "object for the field will be set to the value -1." msgstr "" -#: ../src/Doc/library/cgi.rst:162 +#: library/cgi.rst:162 msgid "" "The file upload draft standard entertains the possibility of uploading " "multiple files from one field (using a recursive :mimetype:`multipart/\\*` " @@ -9975,7 +9992,7 @@ msgid "" "be iterated over recursively just like the top-level form object." msgstr "" -#: ../src/Doc/library/cgi.rst:170 +#: library/cgi.rst:170 msgid "" "When a form is submitted in the \"old\" format (as the query string or as a " "single data part of type :mimetype:`application/x-www-form-urlencoded`), the " @@ -9984,17 +10001,17 @@ msgid "" "are always ``None``." msgstr "" -#: ../src/Doc/library/cgi.rst:175 +#: library/cgi.rst:175 msgid "" "A form submitted via POST that also has a query string will contain both :" "class:`FieldStorage` and :class:`MiniFieldStorage` items." msgstr "" -#: ../src/Doc/library/cgi.rst:179 +#: library/cgi.rst:179 msgid "Higher Level Interface" msgstr "" -#: ../src/Doc/library/cgi.rst:183 +#: library/cgi.rst:183 msgid "" "The previous section explains how to read CGI form data using the :class:" "`FieldStorage` class. This section describes a higher level interface which " @@ -10004,33 +10021,33 @@ msgid "" "efficiently, for example." msgstr "" -#: ../src/Doc/library/cgi.rst:192 +#: library/cgi.rst:192 msgid "" "The interface consists of two simple methods. Using the methods you can " "process form data in a generic way, without the need to worry whether only " "one or more values were posted under one name." msgstr "" -#: ../src/Doc/library/cgi.rst:196 +#: library/cgi.rst:196 msgid "" "In the previous section, you learned to write following code anytime you " "expected a user to post more than one value under one name::" msgstr "" -#: ../src/Doc/library/cgi.rst:205 +#: library/cgi.rst:205 msgid "" "This situation is common for example when a form contains a group of " "multiple checkboxes with the same name::" msgstr "" -#: ../src/Doc/library/cgi.rst:211 +#: library/cgi.rst:211 msgid "" "In most situations, however, there's only one form control with a particular " "name in a form and then you expect and need only one value associated with " "this name. So you write a script containing for example this code::" msgstr "" -#: ../src/Doc/library/cgi.rst:217 +#: library/cgi.rst:217 msgid "" "The problem with the code is that you should never expect that a client will " "provide valid input to your scripts. For example, if a curious user appends " @@ -10041,7 +10058,7 @@ msgid "" "an :exc:`AttributeError` exception." msgstr "" -#: ../src/Doc/library/cgi.rst:225 +#: library/cgi.rst:225 msgid "" "Therefore, the appropriate way to read form data values was to always use " "the code which checks whether the obtained value is a single value or a list " @@ -10049,14 +10066,14 @@ msgid "" msgstr "" # f30106407431403badfdc6cc098fde11 -#: ../src/Doc/library/cgi.rst:229 +#: library/cgi.rst:229 msgid "" "A more convenient approach is to use the methods :meth:`~FieldStorage." "getfirst` and :meth:`~FieldStorage.getlist` provided by this higher level " "interface." msgstr "" -#: ../src/Doc/library/cgi.rst:235 +#: library/cgi.rst:235 msgid "" "This method always returns only one value associated with form field *name*. " "The method returns only the first value in case that more values were posted " @@ -10067,7 +10084,7 @@ msgid "" "defaults to ``None`` if not specified." msgstr "" -#: ../src/Doc/library/cgi.rst:246 +#: library/cgi.rst:246 msgid "" "This method always returns a list of values associated with form field " "*name*. The method returns an empty list if no such form field or value " @@ -10075,24 +10092,31 @@ msgid "" "such value exists." msgstr "" -#: ../src/Doc/library/cgi.rst:250 +#: library/cgi.rst:250 msgid "Using these methods you can write nice compact code::" msgstr "" # 5778ce206faa4fb6b86bed3661454bc3 -#: ../src/Doc/library/cgi.rst:260 +#: library/cgi.rst:260 msgid "Old classes" msgstr "" +#: library/cgi.rst:264 +msgid "" +"These classes, present in earlier versions of the :mod:`cgi` module, are " +"still supported for backward compatibility. New applications should use " +"the :class:`FieldStorage` class." +msgstr "" + # 03f67441ddc14bf4b4f13b5ce576df50 -#: ../src/Doc/library/cgi.rst:268 +#: library/cgi.rst:268 msgid "" ":class:`SvFormContentDict` stores single value form content as dictionary; " "it assumes each field name occurs in the form only once." msgstr "" # 9006ba66072c4f54b810e4d6ca3c6dc7 -#: ../src/Doc/library/cgi.rst:271 +#: library/cgi.rst:271 msgid "" ":class:`FormContentDict` stores multiple value form content as a dictionary " "(the form items are lists of values). Useful if your form contains multiple " @@ -10100,26 +10124,25 @@ msgid "" msgstr "" # 9274ea6940204e5f89420bd5c4533905 -#: ../src/Doc/library/cgi.rst:275 +#: library/cgi.rst:275 msgid "" "Other classes (:class:`FormContent`, :class:`InterpFormContentDict`) are " "present for backwards compatibility with really old applications only." msgstr "" -#: ../src/Doc/library/cgi.rst:282 ../src/Doc/library/curses.rst:58 -#: ../src/Doc/library/curses.panel.rst:17 ../src/Doc/library/stdtypes.rst:2862 -#: ../src/Doc/library/xml.etree.elementtree.rst:365 +#: library/cgi.rst:282 library/curses.rst:58 library/curses.panel.rst:17 +#: library/stdtypes.rst:2893 library/xml.etree.elementtree.rst:436 msgid "Functions" msgstr "" -#: ../src/Doc/library/cgi.rst:284 +#: library/cgi.rst:284 msgid "" "These are useful if you want more control, or if you want to employ some of " "the algorithms implemented in this module in other circumstances." msgstr "" # 1c8f817762484b07999a483a1fcf352e -#: ../src/Doc/library/cgi.rst:290 +#: library/cgi.rst:290 msgid "" "Parse a query in the environment or from a file (the file defaults to ``sys." "stdin`` and environment defaults to ``os.environ``). The " @@ -10128,20 +10151,20 @@ msgid "" msgstr "" # 37554519f7fd4b1f8cc2d78a6aff56fc -#: ../src/Doc/library/cgi.rst:297 +#: library/cgi.rst:297 msgid "" "This function is deprecated in this module. Use :func:`urlparse.parse_qs` " "instead. It is maintained here only for backward compatiblity." msgstr "" # 63e3226953e541d68f78a6c72358cbf1 -#: ../src/Doc/library/cgi.rst:302 +#: library/cgi.rst:302 msgid "" "This function is deprecated in this module. Use :func:`urlparse.parse_qsl` " "instead. It is maintained here only for backward compatiblity." msgstr "" -#: ../src/Doc/library/cgi.rst:307 +#: library/cgi.rst:307 msgid "" "Parse input of type :mimetype:`multipart/form-data` (for file uploads). " "Arguments are *fp* for the input file and *pdict* for a dictionary " @@ -10149,7 +10172,7 @@ msgid "" msgstr "" # 9b06233a5e044b44be5bf3a6f9f731d4 -#: ../src/Doc/library/cgi.rst:311 +#: library/cgi.rst:311 msgid "" "Returns a dictionary just like :func:`urlparse.parse_qs` keys are the field " "names, each value is a list of values for that field. This is easy to use " @@ -10158,42 +10181,42 @@ msgid "" "flexible." msgstr "" -#: ../src/Doc/library/cgi.rst:316 +#: library/cgi.rst:316 msgid "" "Note that this does not parse nested multipart parts --- use :class:" "`FieldStorage` for that." msgstr "" -#: ../src/Doc/library/cgi.rst:322 +#: library/cgi.rst:322 msgid "" "Parse a MIME header (such as :mailheader:`Content-Type`) into a main value " "and a dictionary of parameters." msgstr "" -#: ../src/Doc/library/cgi.rst:328 +#: library/cgi.rst:328 msgid "" "Robust test CGI script, usable as main program. Writes minimal HTTP headers " "and formats all information provided to the script in HTML form." msgstr "" -#: ../src/Doc/library/cgi.rst:334 +#: library/cgi.rst:334 msgid "Format the shell environment in HTML." msgstr "" -#: ../src/Doc/library/cgi.rst:339 +#: library/cgi.rst:339 msgid "Format a form in HTML." msgstr "" -#: ../src/Doc/library/cgi.rst:344 +#: library/cgi.rst:344 msgid "Format the current directory in HTML." msgstr "" -#: ../src/Doc/library/cgi.rst:349 +#: library/cgi.rst:349 msgid "Print a list of useful (used by CGI) environment variables in HTML." msgstr "" # f9c1aae0feeb46ae88ada222296bf9b5 -#: ../src/Doc/library/cgi.rst:354 +#: library/cgi.rst:354 msgid "" "Convert the characters ``'&'``, ``'<'`` and ``'>'`` in string *s* to HTML-" "safe sequences. Use this if you need to display text that might contain " @@ -10204,18 +10227,18 @@ msgid "" msgstr "" # a0a5a684460c459598c6572ee896edf4 -#: ../src/Doc/library/cgi.rst:361 +#: library/cgi.rst:361 msgid "" "If the value to be quoted might include single- or double-quote characters, " "or both, consider using the :func:`~xml.sax.saxutils.quoteattr` function in " "the :mod:`xml.sax.saxutils` module instead." msgstr "" -#: ../src/Doc/library/cgi.rst:369 +#: library/cgi.rst:369 msgid "Caring about security" msgstr "" -#: ../src/Doc/library/cgi.rst:373 +#: library/cgi.rst:373 msgid "" "There's one important rule: if you invoke an external program (via the :func:" "`os.system` or :func:`os.popen` functions. or others with similar " @@ -10226,18 +10249,18 @@ msgid "" "cannot be trusted, since the request doesn't have to come from your form!" msgstr "" -#: ../src/Doc/library/cgi.rst:381 +#: library/cgi.rst:381 msgid "" "To be on the safe side, if you must pass a string gotten from a form to a " "shell command, you should make sure the string contains only alphanumeric " "characters, dashes, underscores, and periods." msgstr "" -#: ../src/Doc/library/cgi.rst:387 +#: library/cgi.rst:387 msgid "Installing your CGI script on a Unix system" msgstr "" -#: ../src/Doc/library/cgi.rst:389 +#: library/cgi.rst:389 msgid "" "Read the documentation for your HTTP server and check with your local system " "administrator to find the directory where CGI scripts should be installed; " @@ -10245,7 +10268,7 @@ msgid "" msgstr "" # c5795746e82849ae850f4f9ba76ec548 -#: ../src/Doc/library/cgi.rst:393 +#: library/cgi.rst:393 msgid "" "Make sure that your script is readable and executable by \"others\"; the " "Unix file mode should be ``0755`` octal (use ``chmod 0755 filename``). Make " @@ -10253,13 +10276,13 @@ msgid "" "followed by the pathname of the Python interpreter, for instance::" msgstr "" -#: ../src/Doc/library/cgi.rst:400 +#: library/cgi.rst:400 msgid "" "Make sure the Python interpreter exists and is executable by \"others\"." msgstr "" # 94e442fd16f94fa581dc216481d431c2 -#: ../src/Doc/library/cgi.rst:402 +#: library/cgi.rst:402 msgid "" "Make sure that any files your script needs to read or write are readable or " "writable, respectively, by \"others\" --- their mode should be ``0644`` for " @@ -10274,28 +10297,28 @@ msgid "" "anything interesting." msgstr "" -#: ../src/Doc/library/cgi.rst:413 +#: library/cgi.rst:413 msgid "" "If you need to load modules from a directory which is not on Python's " "default module search path, you can change the path in your script, before " "importing other modules. For example::" msgstr "" -#: ../src/Doc/library/cgi.rst:421 +#: library/cgi.rst:421 msgid "(This way, the directory inserted last will be searched first!)" msgstr "" -#: ../src/Doc/library/cgi.rst:423 +#: library/cgi.rst:423 msgid "" "Instructions for non-Unix systems will vary; check your HTTP server's " "documentation (it will usually have a section on CGI scripts)." msgstr "" -#: ../src/Doc/library/cgi.rst:428 +#: library/cgi.rst:428 msgid "Testing your CGI script" msgstr "" -#: ../src/Doc/library/cgi.rst:430 +#: library/cgi.rst:430 msgid "" "Unfortunately, a CGI script will generally not run when you try it from the " "command line, and a script that works perfectly from the command line may " @@ -10305,17 +10328,17 @@ msgid "" "will most likely send a cryptic error to the client." msgstr "" -#: ../src/Doc/library/cgi.rst:437 +#: library/cgi.rst:437 msgid "" "Assuming your script has no syntax errors, yet it does not work, you have no " "choice but to read the next section." msgstr "" -#: ../src/Doc/library/cgi.rst:442 +#: library/cgi.rst:442 msgid "Debugging CGI scripts" msgstr "" -#: ../src/Doc/library/cgi.rst:446 +#: library/cgi.rst:446 msgid "" "First of all, check for trivial installation errors --- reading the section " "above on installing your CGI script carefully can save you a lot of time. " @@ -10328,7 +10351,7 @@ msgid "" "your browser of the form::" msgstr "" -#: ../src/Doc/library/cgi.rst:457 +#: library/cgi.rst:457 msgid "" "If this gives an error of type 404, the server cannot find the script -- " "perhaps you need to install it in a different directory. If it gives " @@ -10340,19 +10363,19 @@ msgid "" "same procedure for your own script, you should now be able to debug it." msgstr "" -#: ../src/Doc/library/cgi.rst:466 +#: library/cgi.rst:466 msgid "" "The next step could be to call the :mod:`cgi` module's :func:`test` function " "from your script: replace its main code with the single statement ::" msgstr "" -#: ../src/Doc/library/cgi.rst:471 +#: library/cgi.rst:471 msgid "" "This should produce the same results as those gotten from installing the :" "file:`cgi.py` file itself." msgstr "" -#: ../src/Doc/library/cgi.rst:474 +#: library/cgi.rst:474 msgid "" "When an ordinary Python script raises an unhandled exception (for whatever " "reason: of a typo in a module name, a file that can't be opened, etc.), the " @@ -10362,28 +10385,28 @@ msgid "" "or be discarded altogether." msgstr "" -#: ../src/Doc/library/cgi.rst:481 +#: library/cgi.rst:481 msgid "" "Fortunately, once you have managed to get your script to execute *some* " "code, you can easily send tracebacks to the Web browser using the :mod:" "`cgitb` module. If you haven't done so already, just add the lines::" msgstr "" -#: ../src/Doc/library/cgi.rst:488 +#: library/cgi.rst:488 msgid "" "to the top of your script. Then try running it again; when a problem " "occurs, you should see a detailed report that will likely make apparent the " "cause of the crash." msgstr "" -#: ../src/Doc/library/cgi.rst:492 +#: library/cgi.rst:492 msgid "" "If you suspect that there may be a problem in importing the :mod:`cgitb` " "module, you can use an even more robust approach (which only uses built-in " "modules)::" msgstr "" -#: ../src/Doc/library/cgi.rst:501 +#: library/cgi.rst:501 msgid "" "This relies on the Python interpreter to print the traceback. The content " "type of the output is set to plain text, which disables all HTML " @@ -10393,47 +10416,47 @@ msgid "" "interpretation is going on, the traceback will be readable." msgstr "" -#: ../src/Doc/library/cgi.rst:510 +#: library/cgi.rst:510 msgid "Common problems and solutions" msgstr "" -#: ../src/Doc/library/cgi.rst:512 +#: library/cgi.rst:512 msgid "" "Most HTTP servers buffer the output from CGI scripts until the script is " "completed. This means that it is not possible to display a progress report " "on the client's display while the script is running." msgstr "" -#: ../src/Doc/library/cgi.rst:516 +#: library/cgi.rst:516 msgid "Check the installation instructions above." msgstr "" -#: ../src/Doc/library/cgi.rst:518 +#: library/cgi.rst:518 msgid "" "Check the HTTP server's log files. (``tail -f logfile`` in a separate " "window may be useful!)" msgstr "" -#: ../src/Doc/library/cgi.rst:521 +#: library/cgi.rst:521 msgid "" "Always check a script for syntax errors first, by doing something like " "``python script.py``." msgstr "" -#: ../src/Doc/library/cgi.rst:524 +#: library/cgi.rst:524 msgid "" "If your script does not have any syntax errors, try adding ``import cgitb; " "cgitb.enable()`` to the top of the script." msgstr "" -#: ../src/Doc/library/cgi.rst:527 +#: library/cgi.rst:527 msgid "" "When invoking external programs, make sure they can be found. Usually, this " "means using absolute path names --- :envvar:`PATH` is usually not set to a " "very useful value in a CGI script." msgstr "" -#: ../src/Doc/library/cgi.rst:531 +#: library/cgi.rst:531 msgid "" "When reading or writing external files, make sure they can be read or " "written by the userid under which your CGI script will be running: this is " @@ -10441,13 +10464,13 @@ msgid "" "explicitly specified userid for a web server's ``suexec`` feature." msgstr "" -#: ../src/Doc/library/cgi.rst:536 +#: library/cgi.rst:536 msgid "" "Don't try to give a CGI script a set-uid mode. This doesn't work on most " "systems, and is a security liability as well." msgstr "" -#: ../src/Doc/library/cgi.rst:541 +#: library/cgi.rst:541 msgid "" "Note that some recent versions of the HTML specification do state what order " "the field values should be supplied in, but knowing whether a request was " @@ -10456,12 +10479,12 @@ msgid "" msgstr "" # 7175617bb1c2471fb2db756bb2eca983 -#: ../src/Doc/library/cgihttpserver.rst:2 +#: library/cgihttpserver.rst:2 msgid ":mod:`CGIHTTPServer` --- CGI-capable HTTP request handler" msgstr "" # cd2fc818e9e248aeb6bdca07b77a39f4 -#: ../src/Doc/library/cgihttpserver.rst:10 +#: library/cgihttpserver.rst:10 msgid "" "The :mod:`CGIHTTPServer` module has been merged into :mod:`http.server` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -10469,7 +10492,7 @@ msgid "" msgstr "" # 13f78ced3fb44111a93f6d9c2cf895eb -#: ../src/Doc/library/cgihttpserver.rst:15 +#: library/cgihttpserver.rst:15 msgid "" "The :mod:`CGIHTTPServer` module defines a request-handler class, interface " "compatible with :class:`BaseHTTPServer.BaseHTTPRequestHandler` and inherits " @@ -10478,11 +10501,11 @@ msgid "" msgstr "" # d9bda97a148544daa2e374f74b091a53 -#: ../src/Doc/library/cgihttpserver.rst:22 +#: library/cgihttpserver.rst:22 msgid "This module can run CGI scripts on Unix and Windows systems." msgstr "" -#: ../src/Doc/library/cgihttpserver.rst:26 +#: library/cgihttpserver.rst:26 msgid "" "CGI scripts run by the :class:`CGIHTTPRequestHandler` class cannot execute " "redirects (HTTP code 302), because code 200 (script output follows) is sent " @@ -10490,12 +10513,12 @@ msgid "" msgstr "" # 3eb62b20df0a43f7986c135b063c8db5 -#: ../src/Doc/library/cgihttpserver.rst:30 +#: library/cgihttpserver.rst:30 msgid "The :mod:`CGIHTTPServer` module defines the following class:" msgstr "" # cd0377daae914e5cb373e5b5b54532c2 -#: ../src/Doc/library/cgihttpserver.rst:35 +#: library/cgihttpserver.rst:35 msgid "" "This class is used to serve either files or output of CGI scripts from the " "current directory and below. Note that mapping HTTP hierarchic structure to " @@ -10504,7 +10527,7 @@ msgid "" msgstr "" # 094905ecb1834411a43f35b9399dadc8 -#: ../src/Doc/library/cgihttpserver.rst:40 +#: library/cgihttpserver.rst:40 msgid "" "The class will however, run the CGI script, instead of serving it as a file, " "if it guesses it to be a CGI script. Only directory-based CGI are used --- " @@ -10512,29 +10535,29 @@ msgid "" "denoting CGI scripts." msgstr "" -#: ../src/Doc/library/cgihttpserver.rst:45 +#: library/cgihttpserver.rst:45 msgid "" "The :func:`do_GET` and :func:`do_HEAD` functions are modified to run CGI " "scripts and serve the output, instead of serving files, if the request leads " "to somewhere below the ``cgi_directories`` path." msgstr "" -#: ../src/Doc/library/cgihttpserver.rst:49 +#: library/cgihttpserver.rst:49 msgid "The :class:`CGIHTTPRequestHandler` defines the following data member:" msgstr "" -#: ../src/Doc/library/cgihttpserver.rst:54 +#: library/cgihttpserver.rst:54 msgid "" "This defaults to ``['/cgi-bin', '/htbin']`` and describes directories to " "treat as containing CGI scripts." msgstr "" # 641b7f48ec9346b48871e0a28ca2ec42 -#: ../src/Doc/library/cgihttpserver.rst:57 +#: library/cgihttpserver.rst:57 msgid "The :class:`CGIHTTPRequestHandler` defines the following methods:" msgstr "" -#: ../src/Doc/library/cgihttpserver.rst:62 +#: library/cgihttpserver.rst:62 msgid "" "This method serves the ``'POST'`` request type, only allowed for CGI " "scripts. Error 501, \"Can only POST to CGI scripts\", is output when trying " @@ -10542,36 +10565,32 @@ msgid "" msgstr "" # 69012998f91746db8cb68650d345b6f7 -#: ../src/Doc/library/cgihttpserver.rst:66 +#: library/cgihttpserver.rst:66 msgid "" "Note that CGI scripts will be run with UID of user nobody, for security " "reasons. Problems with the CGI script will be translated to error 403." msgstr "" # 9dde5968fba14a5d9a4af869789c5a8c -#: ../src/Doc/library/cgihttpserver.rst:69 +#: library/cgihttpserver.rst:69 msgid "For example usage, see the implementation of the :func:`test` function." msgstr "" -# 44f3375fa3494f2b9f323bb4a1f2dfd7 -# c4f3a5ed560846a697aa5b42efd56e37 -#: ../src/Doc/library/cgihttpserver.rst:73 -#: ../src/Doc/library/simplehttpserver.rst:116 -msgid "Module :mod:`BaseHTTPServer`" +#: library/cgihttpserver.rst:74 library/simplehttpserver.rst:117 +msgid "Module BaseHTTPServer" msgstr "" # 33782ed685154cbd9f8834b0670e0efa # 0556138e79e6455f80eb5e01eedead61 -#: ../src/Doc/library/cgihttpserver.rst:75 -#: ../src/Doc/library/simplehttpserver.rst:118 +#: library/cgihttpserver.rst:75 library/simplehttpserver.rst:118 msgid "Base class implementation for Web server and request handler." msgstr "" -#: ../src/Doc/library/cgitb.rst:3 +#: library/cgitb.rst:3 msgid ":mod:`cgitb` --- Traceback manager for CGI scripts" msgstr "" -#: ../src/Doc/library/cgitb.rst:19 +#: library/cgitb.rst:19 msgid "" "The :mod:`cgitb` module provides a special exception handler for Python " "scripts. (Its name is a bit misleading. It was originally designed to " @@ -10585,25 +10604,25 @@ msgid "" "instead of sending it to the browser." msgstr "" -#: ../src/Doc/library/cgitb.rst:29 +#: library/cgitb.rst:29 msgid "To enable this feature, simply add this to the top of your CGI script::" msgstr "" -#: ../src/Doc/library/cgitb.rst:34 +#: library/cgitb.rst:34 msgid "" "The options to the :func:`enable` function control whether the report is " "displayed in the browser and whether the report is logged to a file for " "later analysis." msgstr "" -#: ../src/Doc/library/cgitb.rst:43 +#: library/cgitb.rst:43 msgid "" "This function causes the :mod:`cgitb` module to take over the interpreter's " "default handling for exceptions by setting the value of :attr:`sys." "excepthook`." msgstr "" -#: ../src/Doc/library/cgitb.rst:46 +#: library/cgitb.rst:46 msgid "" "The optional argument *display* defaults to ``1`` and can be set to ``0`` to " "suppress sending the traceback to the browser. If the argument *logdir* is " @@ -10616,7 +10635,7 @@ msgid "" "\"html\"``." msgstr "" -#: ../src/Doc/library/cgitb.rst:58 +#: library/cgitb.rst:58 msgid "" "This function handles an exception using the default settings (that is, show " "a report in the browser, but don't log to a file). This can be used when " @@ -10627,11 +10646,11 @@ msgid "" "exception is obtained from :func:`sys.exc_info`." msgstr "" -#: ../src/Doc/library/chunk.rst:3 +#: library/chunk.rst:3 msgid ":mod:`chunk` --- Read IFF chunked data" msgstr "" -#: ../src/Doc/library/chunk.rst:18 +#: library/chunk.rst:18 msgid "" "This module provides an interface for reading files that use EA IFF 85 " "chunks. [#]_ This format is used in at least the Audio Interchange File " @@ -10639,69 +10658,67 @@ msgid "" "file format is closely related and can also be read using this module." msgstr "" -#: ../src/Doc/library/chunk.rst:23 +#: library/chunk.rst:23 msgid "A chunk has the following structure:" msgstr "" -#: ../src/Doc/library/chunk.rst:26 +#: library/chunk.rst:26 msgid "Offset" msgstr "" -#: ../src/Doc/library/chunk.rst:26 +#: library/chunk.rst:26 msgid "Length" msgstr "" -#: ../src/Doc/library/chunk.rst:26 ../src/Doc/library/sunau.rst:20 +#: library/chunk.rst:26 library/sunau.rst:20 msgid "Contents" msgstr "" -#: ../src/Doc/library/chunk.rst:28 ../src/Doc/library/grp.rst:20 -#: ../src/Doc/library/logging.rst:313 ../src/Doc/library/pwd.rst:20 -#: ../src/Doc/library/spwd.rst:25 ../src/Doc/library/time.rst:407 -#: ../src/Doc/library/tkinter.rst:440 ../src/Doc/library/urlparse.rst:96 -#: ../src/Doc/library/urlparse.rst:200 +#: library/chunk.rst:28 library/grp.rst:20 library/logging.rst:314 +#: library/pwd.rst:20 library/spwd.rst:25 library/time.rst:406 +#: library/tkinter.rst:440 library/urlparse.rst:96 library/urlparse.rst:200 msgid "0" msgstr "" -#: ../src/Doc/library/chunk.rst:28 +#: library/chunk.rst:28 msgid "Chunk ID" msgstr "" -#: ../src/Doc/library/chunk.rst:30 +#: library/chunk.rst:30 msgid "Size of chunk in big-endian byte order, not including the header" msgstr "" -#: ../src/Doc/library/chunk.rst:34 +#: library/chunk.rst:34 msgid "*n*" msgstr "" -#: ../src/Doc/library/chunk.rst:34 +#: library/chunk.rst:34 msgid "Data bytes, where *n* is the size given in the preceding field" msgstr "" -#: ../src/Doc/library/chunk.rst:38 +#: library/chunk.rst:38 msgid "8 + *n*" msgstr "" -#: ../src/Doc/library/chunk.rst:38 +#: library/chunk.rst:38 msgid "0 or 1" msgstr "" -#: ../src/Doc/library/chunk.rst:38 +#: library/chunk.rst:38 msgid "Pad byte needed if *n* is odd and chunk alignment is used" msgstr "" -#: ../src/Doc/library/chunk.rst:42 +#: library/chunk.rst:42 msgid "The ID is a 4-byte string which identifies the type of chunk." msgstr "" -#: ../src/Doc/library/chunk.rst:44 +#: library/chunk.rst:44 msgid "" "The size field (a 32-bit value, encoded using big-endian byte order) gives " "the size of the chunk data, not including the 8-byte header." msgstr "" -#: ../src/Doc/library/chunk.rst:47 +#: library/chunk.rst:47 msgid "" "Usually an IFF-type file consists of one or more chunks. The proposed usage " "of the :class:`Chunk` class defined here is to instantiate an instance at " @@ -10711,7 +10728,7 @@ msgid "" msgstr "" # 01597f5f72f34dbe8ec4544342bee46f -#: ../src/Doc/library/chunk.rst:56 +#: library/chunk.rst:56 msgid "" "Class which represents a chunk. The *file* argument is expected to be a " "file-like object. An instance of this class is specifically allowed. The " @@ -10728,36 +10745,36 @@ msgid "" "The default value is false." msgstr "" -#: ../src/Doc/library/chunk.rst:70 +#: library/chunk.rst:70 msgid "A :class:`Chunk` object supports the following methods:" msgstr "" -#: ../src/Doc/library/chunk.rst:75 +#: library/chunk.rst:75 msgid "" "Returns the name (ID) of the chunk. This is the first 4 bytes of the chunk." msgstr "" -#: ../src/Doc/library/chunk.rst:81 +#: library/chunk.rst:81 msgid "Returns the size of the chunk." msgstr "" -#: ../src/Doc/library/chunk.rst:86 +#: library/chunk.rst:86 msgid "" "Close and skip to the end of the chunk. This does not close the underlying " "file." msgstr "" -#: ../src/Doc/library/chunk.rst:89 +#: library/chunk.rst:89 msgid "" "The remaining methods will raise :exc:`IOError` if called after the :meth:" "`close` method has been called." msgstr "" -#: ../src/Doc/library/chunk.rst:95 +#: library/chunk.rst:95 msgid "Returns ``False``." msgstr "" -#: ../src/Doc/library/chunk.rst:100 +#: library/chunk.rst:100 msgid "" "Set the chunk's current position. The *whence* argument is optional and " "defaults to ``0`` (absolute file positioning); other values are ``1`` (seek " @@ -10766,11 +10783,11 @@ msgid "" "only forward seeks are allowed." msgstr "" -#: ../src/Doc/library/chunk.rst:109 +#: library/chunk.rst:109 msgid "Return the current position into the chunk." msgstr "" -#: ../src/Doc/library/chunk.rst:114 +#: library/chunk.rst:114 msgid "" "Read at most *size* bytes from the chunk (less if the read hits the end of " "the chunk before obtaining *size* bytes). If the *size* argument is " @@ -10779,7 +10796,7 @@ msgid "" "of the chunk is encountered immediately." msgstr "" -#: ../src/Doc/library/chunk.rst:123 +#: library/chunk.rst:123 msgid "" "Skip to the end of the chunk. All further calls to :meth:`read` for the " "chunk will return ``''``. If you are not interested in the contents of the " @@ -10787,17 +10804,17 @@ msgid "" "the next chunk." msgstr "" -#: ../src/Doc/library/chunk.rst:131 +#: library/chunk.rst:131 msgid "" "\"EA IFF 85\" Standard for Interchange Format Files, Jerry Morrison, " "Electronic Arts, January 1985." msgstr "" -#: ../src/Doc/library/cmath.rst:2 +#: library/cmath.rst:2 msgid ":mod:`cmath` --- Mathematical functions for complex numbers" msgstr "" -#: ../src/Doc/library/cmath.rst:8 +#: library/cmath.rst:8 msgid "" "This module is always available. It provides access to mathematical " "functions for complex numbers. The functions in this module accept " @@ -10808,7 +10825,7 @@ msgid "" "applied to the result of the conversion." msgstr "" -#: ../src/Doc/library/cmath.rst:18 +#: library/cmath.rst:18 msgid "" "On platforms with hardware and system-level support for signed zeros, " "functions involving branch cuts are continuous on *both* sides of the branch " @@ -10817,18 +10834,18 @@ msgid "" "specified below." msgstr "" -#: ../src/Doc/library/cmath.rst:26 +#: library/cmath.rst:26 msgid "Conversions to and from polar coordinates" msgstr "" -#: ../src/Doc/library/cmath.rst:28 +#: library/cmath.rst:28 msgid "" "A Python complex number ``z`` is stored internally using *rectangular* or " "*Cartesian* coordinates. It is completely determined by its *real part* ``z." "real`` and its *imaginary part* ``z.imag``. In other words::" msgstr "" -#: ../src/Doc/library/cmath.rst:35 +#: library/cmath.rst:35 msgid "" "*Polar coordinates* give an alternative way to represent a complex number. " "In polar coordinates, a complex number *z* is defined by the modulus *r* and " @@ -10838,13 +10855,13 @@ msgid "" "to *z*." msgstr "" -#: ../src/Doc/library/cmath.rst:42 +#: library/cmath.rst:42 msgid "" "The following functions can be used to convert from the native rectangular " "coordinates to polar coordinates and back." msgstr "" -#: ../src/Doc/library/cmath.rst:47 +#: library/cmath.rst:47 msgid "" "Return the phase of *x* (also known as the *argument* of *x*), as a float. " "``phase(x)`` is equivalent to ``math.atan2(x.imag, x.real)``. The result " @@ -10855,69 +10872,73 @@ msgid "" "imag`` is zero::" msgstr "" -#: ../src/Doc/library/cmath.rst:66 +#: library/cmath.rst:66 msgid "" "The modulus (absolute value) of a complex number *x* can be computed using " "the built-in :func:`abs` function. There is no separate :mod:`cmath` module " "function for this operation." msgstr "" -#: ../src/Doc/library/cmath.rst:73 +#: library/cmath.rst:73 msgid "" "Return the representation of *x* in polar coordinates. Returns a pair ``(r, " "phi)`` where *r* is the modulus of *x* and phi is the phase of *x*. " "``polar(x)`` is equivalent to ``(abs(x), phase(x))``." msgstr "" -#: ../src/Doc/library/cmath.rst:83 +#: library/cmath.rst:83 msgid "" "Return the complex number *x* with polar coordinates *r* and *phi*. " "Equivalent to ``r * (math.cos(phi) + math.sin(phi)*1j)``." msgstr "" -#: ../src/Doc/library/cmath.rst:90 ../src/Doc/library/math.rst:159 +#: library/cmath.rst:90 library/math.rst:159 msgid "Power and logarithmic functions" msgstr "" -#: ../src/Doc/library/cmath.rst:94 +#: library/cmath.rst:94 msgid "Return the exponential value ``e**x``." msgstr "" -#: ../src/Doc/library/cmath.rst:99 +#: library/cmath.rst:99 msgid "" "Returns the logarithm of *x* to the given *base*. If the *base* is not " "specified, returns the natural logarithm of *x*. There is one branch cut, " "from 0 along the negative real axis to -∞, continuous from above." msgstr "" -#: ../src/Doc/library/cmath.rst:109 +#: library/cmath.rst:103 library/math.rst:189 +msgid "*base* argument added." +msgstr "" + +#: library/cmath.rst:109 msgid "" "Return the base-10 logarithm of *x*. This has the same branch cut as :func:" "`log`." msgstr "" -#: ../src/Doc/library/cmath.rst:115 +#: library/cmath.rst:115 msgid "" "Return the square root of *x*. This has the same branch cut as :func:`log`." msgstr "" -#: ../src/Doc/library/cmath.rst:119 ../src/Doc/library/math.rst:230 +#: library/cmath.rst:119 library/math.rst:230 msgid "Trigonometric functions" msgstr "" -#: ../src/Doc/library/cmath.rst:123 +#: library/cmath.rst:123 msgid "" "Return the arc cosine of *x*. There are two branch cuts: One extends right " "from 1 along the real axis to ∞, continuous from below. The other extends " "left from -1 along the real axis to -∞, continuous from above." msgstr "" -#: ../src/Doc/library/cmath.rst:130 +#: library/cmath.rst:130 msgid "" "Return the arc sine of *x*. This has the same branch cuts as :func:`acos`." msgstr "" -#: ../src/Doc/library/cmath.rst:135 +#: library/cmath.rst:135 msgid "" "Return the arc tangent of *x*. There are two branch cuts: One extends from " "``1j`` along the imaginary axis to ``∞j``, continuous from the right. The " @@ -10925,79 +10946,91 @@ msgid "" "from the left." msgstr "" -#: ../src/Doc/library/cmath.rst:146 +#: library/cmath.rst:140 +msgid "direction of continuity of upper cut reversed" +msgstr "" + +#: library/cmath.rst:146 msgid "Return the cosine of *x*." msgstr "" -#: ../src/Doc/library/cmath.rst:151 +#: library/cmath.rst:151 msgid "Return the sine of *x*." msgstr "" -#: ../src/Doc/library/cmath.rst:156 +#: library/cmath.rst:156 msgid "Return the tangent of *x*." msgstr "" -#: ../src/Doc/library/cmath.rst:160 ../src/Doc/library/math.rst:292 +#: library/cmath.rst:160 library/math.rst:292 msgid "Hyperbolic functions" msgstr "" -#: ../src/Doc/library/cmath.rst:164 +#: library/cmath.rst:164 msgid "" -"Return the hyperbolic arc cosine of *x*. There is one branch cut, extending " -"left from 1 along the real axis to -∞, continuous from above." +"Return the inverse hyperbolic cosine of *x*. There is one branch cut, " +"extending left from 1 along the real axis to -∞, continuous from above." msgstr "" -#: ../src/Doc/library/cmath.rst:170 +#: library/cmath.rst:170 msgid "" -"Return the hyperbolic arc sine of *x*. There are two branch cuts: One " +"Return the inverse hyperbolic sine of *x*. There are two branch cuts: One " "extends from ``1j`` along the imaginary axis to ``∞j``, continuous from the " "right. The other extends from ``-1j`` along the imaginary axis to ``-∞j``, " "continuous from the left." msgstr "" -#: ../src/Doc/library/cmath.rst:181 +#: library/cmath.rst:175 +msgid "branch cuts moved to match those recommended by the C99 standard" +msgstr "" + +#: library/cmath.rst:181 msgid "" -"Return the hyperbolic arc tangent of *x*. There are two branch cuts: One " +"Return the inverse hyperbolic tangent of *x*. There are two branch cuts: One " "extends from ``1`` along the real axis to ``∞``, continuous from below. The " "other extends from ``-1`` along the real axis to ``-∞``, continuous from " "above." msgstr "" -#: ../src/Doc/library/cmath.rst:192 ../src/Doc/library/math.rst:317 +#: library/cmath.rst:186 +msgid "direction of continuity of right cut reversed" +msgstr "" + +#: library/cmath.rst:192 library/math.rst:317 msgid "Return the hyperbolic cosine of *x*." msgstr "" -#: ../src/Doc/library/cmath.rst:197 ../src/Doc/library/math.rst:322 +#: library/cmath.rst:197 library/math.rst:322 msgid "Return the hyperbolic sine of *x*." msgstr "" -#: ../src/Doc/library/cmath.rst:202 ../src/Doc/library/math.rst:327 +#: library/cmath.rst:202 library/math.rst:327 msgid "Return the hyperbolic tangent of *x*." msgstr "" -#: ../src/Doc/library/cmath.rst:206 +#: library/cmath.rst:206 msgid "Classification functions" msgstr "" -#: ../src/Doc/library/cmath.rst:210 +#: library/cmath.rst:210 msgid "" "Return *True* if the real or the imaginary part of x is positive or negative " "infinity." msgstr "" -#: ../src/Doc/library/cmath.rst:218 +#: library/cmath.rst:218 msgid "Return *True* if the real or imaginary part of x is not a number (NaN)." msgstr "" -#: ../src/Doc/library/cmath.rst:229 +#: library/cmath.rst:229 msgid "The mathematical constant *π*, as a float." msgstr "" -#: ../src/Doc/library/cmath.rst:234 +#: library/cmath.rst:234 msgid "The mathematical constant *e*, as a float." msgstr "" -#: ../src/Doc/library/cmath.rst:238 +#: library/cmath.rst:238 msgid "" "Note that the selection of functions is similar, but not identical, to that " "in module :mod:`math`. The reason for having two modules is that some users " @@ -11009,7 +11042,7 @@ msgid "" "zero)." msgstr "" -#: ../src/Doc/library/cmath.rst:246 +#: library/cmath.rst:246 msgid "" "A note on branch cuts: They are curves along which the given function fails " "to be continuous. They are a necessary feature of many complex functions. " @@ -11020,23 +11053,23 @@ msgid "" "following:" msgstr "" -#: ../src/Doc/library/cmath.rst:256 +#: library/cmath.rst:256 msgid "" "Kahan, W: Branch cuts for complex elementary functions; or, Much ado about " "nothing's sign bit. In Iserles, A., and Powell, M. (eds.), The state of the " "art in numerical analysis. Clarendon Press (1987) pp165-211." msgstr "" -#: ../src/Doc/library/cmd.rst:2 +#: library/cmd.rst:2 msgid ":mod:`cmd` --- Support for line-oriented command interpreters" msgstr "" # 6fb5b5857bbb42ce83105255bcb012e3 -#: ../src/Doc/library/cmd.rst:8 +#: library/cmd.rst:8 msgid "**Source code:** :source:`Lib/cmd.py`" msgstr "" -#: ../src/Doc/library/cmd.rst:12 +#: library/cmd.rst:12 msgid "" "The :class:`Cmd` class provides a simple framework for writing line-oriented " "command interpreters. These are often useful for test harnesses, " @@ -11044,7 +11077,7 @@ msgid "" "sophisticated interface." msgstr "" -#: ../src/Doc/library/cmd.rst:19 +#: library/cmd.rst:19 msgid "" "A :class:`Cmd` instance or subclass instance is a line-oriented interpreter " "framework. There is no good reason to instantiate :class:`Cmd` itself; " @@ -11053,7 +11086,7 @@ msgid "" "methods." msgstr "" -#: ../src/Doc/library/cmd.rst:24 +#: library/cmd.rst:24 msgid "" "The optional argument *completekey* is the :mod:`readline` name of a " "completion key; it defaults to :kbd:`Tab`. If *completekey* is not :const:" @@ -11061,7 +11094,7 @@ msgid "" "automatically." msgstr "" -#: ../src/Doc/library/cmd.rst:28 +#: library/cmd.rst:28 msgid "" "The optional arguments *stdin* and *stdout* specify the input and output " "file objects that the Cmd instance or subclass instance will use for input " @@ -11069,22 +11102,26 @@ msgid "" "data:`sys.stdout`." msgstr "" -#: ../src/Doc/library/cmd.rst:33 +#: library/cmd.rst:33 msgid "" "If you want a given *stdin* to be used, make sure to set the instance's :" "attr:`use_rawinput` attribute to ``False``, otherwise *stdin* will be " "ignored." msgstr "" -#: ../src/Doc/library/cmd.rst:44 +#: library/cmd.rst:37 +msgid "The *stdin* and *stdout* parameters were added." +msgstr "" + +#: library/cmd.rst:44 msgid "Cmd Objects" msgstr "" -#: ../src/Doc/library/cmd.rst:46 +#: library/cmd.rst:46 msgid "A :class:`Cmd` instance has the following methods:" msgstr "" -#: ../src/Doc/library/cmd.rst:51 +#: library/cmd.rst:51 msgid "" "Repeatedly issue a prompt, accept input, parse an initial prefix off the " "received input, and dispatch to action methods, passing them the remainder " @@ -11092,13 +11129,13 @@ msgid "" msgstr "" # edd2ff3b3235483dbd18e3ae35a56ae1 -#: ../src/Doc/library/cmd.rst:55 +#: library/cmd.rst:55 msgid "" "The optional argument is a banner or intro string to be issued before the " "first prompt (this overrides the :attr:`intro` class attribute)." msgstr "" -#: ../src/Doc/library/cmd.rst:58 +#: library/cmd.rst:58 msgid "" "If the :mod:`readline` module is loaded, input will automatically inherit :" "program:`bash`\\ -like history-list editing (e.g. :kbd:`Control-P` scrolls " @@ -11107,11 +11144,11 @@ msgid "" "B` moves the cursor to the left non-destructively, etc.)." msgstr "" -#: ../src/Doc/library/cmd.rst:64 +#: library/cmd.rst:64 msgid "An end-of-file on input is passed back as the string ``'EOF'``." msgstr "" -#: ../src/Doc/library/cmd.rst:66 +#: library/cmd.rst:66 msgid "" "An interpreter instance will recognize a command name ``foo`` if and only if " "it has a method :meth:`do_foo`. As a special case, a line beginning with " @@ -11120,14 +11157,14 @@ msgid "" "dispatched to the method :meth:`do_shell` (if such a method is defined)." msgstr "" -#: ../src/Doc/library/cmd.rst:72 +#: library/cmd.rst:72 msgid "" "This method will return when the :meth:`postcmd` method returns a true " "value. The *stop* argument to :meth:`postcmd` is the return value from the " "command's corresponding :meth:`do_\\*` method." msgstr "" -#: ../src/Doc/library/cmd.rst:76 +#: library/cmd.rst:76 msgid "" "If completion is enabled, completing commands will be done automatically, " "and completing of commands args is done by calling :meth:`complete_foo` with " @@ -11140,7 +11177,7 @@ msgid "" msgstr "" # c19627f8b26745538ad508fd542a57cd -#: ../src/Doc/library/cmd.rst:84 +#: library/cmd.rst:84 msgid "" "All subclasses of :class:`Cmd` inherit a predefined :meth:`do_help`. This " "method, called with an argument ``'bar'``, invokes the corresponding method :" @@ -11151,7 +11188,7 @@ msgid "" "undocumented commands." msgstr "" -#: ../src/Doc/library/cmd.rst:95 +#: library/cmd.rst:95 msgid "" "Interpret the argument as though it had been typed in response to the " "prompt. This may be overridden, but should not normally need to be; see the :" @@ -11162,25 +11199,25 @@ msgid "" "return value from the :meth:`default` method is returned." msgstr "" -#: ../src/Doc/library/cmd.rst:106 +#: library/cmd.rst:106 msgid "" "Method called when an empty line is entered in response to the prompt. If " "this method is not overridden, it repeats the last nonempty command entered." msgstr "" -#: ../src/Doc/library/cmd.rst:112 +#: library/cmd.rst:112 msgid "" "Method called on an input line when the command prefix is not recognized. If " "this method is not overridden, it prints an error message and returns." msgstr "" -#: ../src/Doc/library/cmd.rst:118 +#: library/cmd.rst:118 msgid "" "Method called to complete an input line when no command-specific :meth:" "`complete_\\*` method is available. By default, it returns an empty list." msgstr "" -#: ../src/Doc/library/cmd.rst:124 +#: library/cmd.rst:124 msgid "" "Hook method executed just before the command line *line* is interpreted, but " "after the input prompt is generated and issued. This method is a stub in :" @@ -11190,7 +11227,7 @@ msgid "" "*line* unchanged." msgstr "" -#: ../src/Doc/library/cmd.rst:134 +#: library/cmd.rst:134 msgid "" "Hook method executed just after a command dispatch is finished. This method " "is a stub in :class:`Cmd`; it exists to be overridden by subclasses. *line* " @@ -11201,76 +11238,76 @@ msgid "" "corresponds to *stop*; returning false will cause interpretation to continue." msgstr "" -#: ../src/Doc/library/cmd.rst:145 +#: library/cmd.rst:145 msgid "" "Hook method executed once when :meth:`cmdloop` is called. This method is a " "stub in :class:`Cmd`; it exists to be overridden by subclasses." msgstr "" -#: ../src/Doc/library/cmd.rst:151 +#: library/cmd.rst:151 msgid "" "Hook method executed once when :meth:`cmdloop` is about to return. This " "method is a stub in :class:`Cmd`; it exists to be overridden by subclasses." msgstr "" -#: ../src/Doc/library/cmd.rst:155 +#: library/cmd.rst:155 msgid "" "Instances of :class:`Cmd` subclasses have some public instance variables:" msgstr "" -#: ../src/Doc/library/cmd.rst:159 +#: library/cmd.rst:159 msgid "The prompt issued to solicit input." msgstr "" -#: ../src/Doc/library/cmd.rst:164 +#: library/cmd.rst:164 msgid "The string of characters accepted for the command prefix." msgstr "" -#: ../src/Doc/library/cmd.rst:169 +#: library/cmd.rst:169 msgid "The last nonempty command prefix seen." msgstr "" # b84451189f3b4d0eb5d8e7508923f9ec -#: ../src/Doc/library/cmd.rst:174 +#: library/cmd.rst:174 msgid "" "A list of queued input lines. The cmdqueue list is checked in :meth:" "`cmdloop` when new input is needed; if it is nonempty, its elements will be " "processed in order, as if entered at the prompt." msgstr "" -#: ../src/Doc/library/cmd.rst:181 +#: library/cmd.rst:181 msgid "" "A string to issue as an intro or banner. May be overridden by giving the :" "meth:`cmdloop` method an argument." msgstr "" -#: ../src/Doc/library/cmd.rst:187 +#: library/cmd.rst:187 msgid "" "The header to issue if the help output has a section for documented commands." msgstr "" -#: ../src/Doc/library/cmd.rst:192 +#: library/cmd.rst:192 msgid "" "The header to issue if the help output has a section for miscellaneous help " "topics (that is, there are :meth:`help_\\*` methods without corresponding :" "meth:`do_\\*` methods)." msgstr "" -#: ../src/Doc/library/cmd.rst:199 +#: library/cmd.rst:199 msgid "" "The header to issue if the help output has a section for undocumented " "commands (that is, there are :meth:`do_\\*` methods without corresponding :" "meth:`help_\\*` methods)." msgstr "" -#: ../src/Doc/library/cmd.rst:206 +#: library/cmd.rst:206 msgid "" "The character used to draw separator lines under the help-message headers. " "If empty, no ruler line is drawn. It defaults to ``'='``." msgstr "" # 0dca1b5d678f48719010d8482db4de95 -#: ../src/Doc/library/cmd.rst:212 +#: library/cmd.rst:212 msgid "" "A flag, defaulting to true. If true, :meth:`cmdloop` uses :func:`raw_input` " "to display a prompt and read the next command; if false, :meth:`sys.stdout." @@ -11280,18 +11317,18 @@ msgid "" "history keystrokes.)" msgstr "" -#: ../src/Doc/library/code.rst:3 +#: library/code.rst:3 msgid ":mod:`code` --- Interpreter base classes" msgstr "" -#: ../src/Doc/library/code.rst:10 +#: library/code.rst:10 msgid "" "The ``code`` module provides facilities to implement read-eval-print loops " "in Python. Two classes and convenience functions are included which can be " "used to build applications which provide an interactive interpreter prompt." msgstr "" -#: ../src/Doc/library/code.rst:17 +#: library/code.rst:17 msgid "" "This class deals with parsing and interpreter state (the user's namespace); " "it does not deal with input buffering or prompting or input file naming (the " @@ -11301,7 +11338,7 @@ msgid "" "and key ``'__doc__'`` set to ``None``." msgstr "" -#: ../src/Doc/library/code.rst:27 +#: library/code.rst:27 msgid "" "Closely emulate the behavior of the interactive Python interpreter. This " "class builds on :class:`InteractiveInterpreter` and adds prompting using the " @@ -11309,7 +11346,7 @@ msgid "" msgstr "" # 9ea52204a5484efb9295cc6875490c88 -#: ../src/Doc/library/code.rst:34 +#: library/code.rst:34 msgid "" "Convenience function to run a read-eval-print loop. This creates a new " "instance of :class:`InteractiveConsole` and sets *readfunc* to be used as " @@ -11320,7 +11357,7 @@ msgid "" "use, if provided. The console object is discarded after use." msgstr "" -#: ../src/Doc/library/code.rst:45 +#: library/code.rst:45 msgid "" "This function is useful for programs that want to emulate Python's " "interpreter main loop (a.k.a. the read-eval-print loop). The tricky part is " @@ -11330,7 +11367,7 @@ msgid "" "real interpreter main loop." msgstr "" -#: ../src/Doc/library/code.rst:52 +#: library/code.rst:52 msgid "" "*source* is the source string; *filename* is the optional filename from " "which source was read, defaulting to ``''``; and *symbol* is the " @@ -11338,7 +11375,7 @@ msgid "" "default) or ``'eval'``." msgstr "" -#: ../src/Doc/library/code.rst:57 +#: library/code.rst:57 msgid "" "Returns a code object (the same as ``compile(source, filename, symbol)``) if " "the command is complete and valid; ``None`` if the command is incomplete; " @@ -11347,18 +11384,18 @@ msgid "" "contains an invalid literal." msgstr "" -#: ../src/Doc/library/code.rst:67 +#: library/code.rst:67 msgid "Interactive Interpreter Objects" msgstr "" -#: ../src/Doc/library/code.rst:72 +#: library/code.rst:72 msgid "" "Compile and run some source in the interpreter. Arguments are the same as " "for :func:`compile_command`; the default for *filename* is ``''``, " "and for *symbol* is ``'single'``. One several things can happen:" msgstr "" -#: ../src/Doc/library/code.rst:76 +#: library/code.rst:76 msgid "" "The input is incorrect; :func:`compile_command` raised an exception (:exc:" "`SyntaxError` or :exc:`OverflowError`). A syntax traceback will be printed " @@ -11366,13 +11403,13 @@ msgid "" "``False``." msgstr "" -#: ../src/Doc/library/code.rst:81 +#: library/code.rst:81 msgid "" "The input is incomplete, and more input is required; :func:`compile_command` " "returned ``None``. :meth:`runsource` returns ``True``." msgstr "" -#: ../src/Doc/library/code.rst:84 +#: library/code.rst:84 msgid "" "The input is complete; :func:`compile_command` returned a code object. The " "code is executed by calling the :meth:`runcode` (which also handles run-time " @@ -11380,27 +11417,27 @@ msgid "" "``False``." msgstr "" -#: ../src/Doc/library/code.rst:88 +#: library/code.rst:88 msgid "" "The return value can be used to decide whether to use ``sys.ps1`` or ``sys." "ps2`` to prompt the next line." msgstr "" -#: ../src/Doc/library/code.rst:94 +#: library/code.rst:94 msgid "" "Execute a code object. When an exception occurs, :meth:`showtraceback` is " "called to display a traceback. All exceptions are caught except :exc:" "`SystemExit`, which is allowed to propagate." msgstr "" -#: ../src/Doc/library/code.rst:98 +#: library/code.rst:98 msgid "" "A note about :exc:`KeyboardInterrupt`: this exception may occur elsewhere in " "this code, and may not always be caught. The caller should be prepared to " "deal with it." msgstr "" -#: ../src/Doc/library/code.rst:105 +#: library/code.rst:105 msgid "" "Display the syntax error that just occurred. This does not display a stack " "trace because there isn't one for syntax errors. If *filename* is given, it " @@ -11409,32 +11446,32 @@ msgid "" "string. The output is written by the :meth:`write` method." msgstr "" -#: ../src/Doc/library/code.rst:114 +#: library/code.rst:114 msgid "" "Display the exception that just occurred. We remove the first stack item " "because it is within the interpreter object implementation. The output is " "written by the :meth:`write` method." msgstr "" -#: ../src/Doc/library/code.rst:121 +#: library/code.rst:121 msgid "" "Write a string to the standard error stream (``sys.stderr``). Derived " "classes should override this to provide the appropriate output handling as " "needed." msgstr "" -#: ../src/Doc/library/code.rst:128 +#: library/code.rst:128 msgid "Interactive Console Objects" msgstr "" -#: ../src/Doc/library/code.rst:130 +#: library/code.rst:130 msgid "" "The :class:`InteractiveConsole` class is a subclass of :class:" "`InteractiveInterpreter`, and so offers all the methods of the interpreter " "objects as well as the following additions." msgstr "" -#: ../src/Doc/library/code.rst:137 +#: library/code.rst:137 msgid "" "Closely emulate the interactive Python console. The optional banner argument " "specify the banner to print before the first interaction; by default it " @@ -11444,7 +11481,7 @@ msgid "" "close!)." msgstr "" -#: ../src/Doc/library/code.rst:146 +#: library/code.rst:146 msgid "" "Push a line of source text to the interpreter. The line should not have a " "trailing newline; it may have internal newlines. The line is appended to a " @@ -11457,12 +11494,12 @@ msgid "" "`runsource`)." msgstr "" -#: ../src/Doc/library/code.rst:158 +#: library/code.rst:158 msgid "Remove any unhandled source text from the input buffer." msgstr "" # 6b13bc94ad6343a19906663e9a88a45f -#: ../src/Doc/library/code.rst:163 +#: library/code.rst:163 msgid "" "Write a prompt and read a line. The returned line does not include the " "trailing newline. When the user enters the EOF key sequence, :exc:" @@ -11471,30 +11508,30 @@ msgid "" "implementation." msgstr "" -#: ../src/Doc/library/codecs.rst:3 +#: library/codecs.rst:3 msgid ":mod:`codecs` --- Codec registry and base classes" msgstr "" -#: ../src/Doc/library/codecs.rst:20 +#: library/codecs.rst:20 msgid "" "This module defines base classes for standard Python codecs (encoders and " "decoders) and provides access to the internal Python codec registry which " "manages the codec and error handling lookup process." msgstr "" -#: ../src/Doc/library/codecs.rst:24 +#: library/codecs.rst:24 msgid "It defines the following functions:" msgstr "" # 57a2c6e9b062433b93ff4323689988b6 -#: ../src/Doc/library/codecs.rst:28 +#: library/codecs.rst:28 msgid "" "Encodes *obj* using the codec registered for *encoding*. The default " "encoding is ``'ascii'``." msgstr "" # 9b5cb092a04a48bba686e628d9ad41c9 -#: ../src/Doc/library/codecs.rst:31 +#: library/codecs.rst:31 msgid "" "*Errors* may be given to set the desired error handling scheme. The default " "error handler is ``'strict'`` meaning that encoding errors raise :exc:" @@ -11504,14 +11541,14 @@ msgid "" msgstr "" # aeb13d88ce67428d98a43c25d7026599 -#: ../src/Doc/library/codecs.rst:41 +#: library/codecs.rst:41 msgid "" "Decodes *obj* using the codec registered for *encoding*. The default " "encoding is ``'ascii'``." msgstr "" # 874623c5d1654b2bb640fc6f82f73ba6 -#: ../src/Doc/library/codecs.rst:44 +#: library/codecs.rst:44 msgid "" "*Errors* may be given to set the desired error handling scheme. The default " "error handler is ``'strict'`` meaning that decoding errors raise :exc:" @@ -11520,49 +11557,49 @@ msgid "" "information on codec error handling." msgstr "" -#: ../src/Doc/library/codecs.rst:54 +#: library/codecs.rst:54 msgid "" "Register a codec search function. Search functions are expected to take one " "argument, the encoding name in all lower case letters, and return a :class:" "`CodecInfo` object having the following attributes:" msgstr "" -#: ../src/Doc/library/codecs.rst:58 +#: library/codecs.rst:58 msgid "``name`` The name of the encoding;" msgstr "" -#: ../src/Doc/library/codecs.rst:60 +#: library/codecs.rst:60 msgid "``encode`` The stateless encoding function;" msgstr "" -#: ../src/Doc/library/codecs.rst:62 +#: library/codecs.rst:62 msgid "``decode`` The stateless decoding function;" msgstr "" -#: ../src/Doc/library/codecs.rst:64 +#: library/codecs.rst:64 msgid "" "``incrementalencoder`` An incremental encoder class or factory function;" msgstr "" -#: ../src/Doc/library/codecs.rst:66 +#: library/codecs.rst:66 msgid "" "``incrementaldecoder`` An incremental decoder class or factory function;" msgstr "" -#: ../src/Doc/library/codecs.rst:68 +#: library/codecs.rst:68 msgid "``streamwriter`` A stream writer class or factory function;" msgstr "" -#: ../src/Doc/library/codecs.rst:70 +#: library/codecs.rst:70 msgid "``streamreader`` A stream reader class or factory function." msgstr "" -#: ../src/Doc/library/codecs.rst:72 +#: library/codecs.rst:72 msgid "The various functions or classes take the following arguments:" msgstr "" # 31152fa3ec244af7bd08ded241f582f1 -#: ../src/Doc/library/codecs.rst:74 +#: library/codecs.rst:74 msgid "" "*encode* and *decode*: These must be functions or methods which have the " "same interface as the :meth:`~Codec.encode`/:meth:`~Codec.decode` methods of " @@ -11570,89 +11607,89 @@ msgid "" "methods are expected to work in a stateless mode." msgstr "" -#: ../src/Doc/library/codecs.rst:79 +#: library/codecs.rst:79 msgid "" "*incrementalencoder* and *incrementaldecoder*: These have to be factory " "functions providing the following interface:" msgstr "" -#: ../src/Doc/library/codecs.rst:82 +#: library/codecs.rst:82 msgid "``factory(errors='strict')``" msgstr "" -#: ../src/Doc/library/codecs.rst:84 +#: library/codecs.rst:84 msgid "" "The factory functions must return objects providing the interfaces defined " "by the base classes :class:`IncrementalEncoder` and :class:" "`IncrementalDecoder`, respectively. Incremental codecs can maintain state." msgstr "" -#: ../src/Doc/library/codecs.rst:88 +#: library/codecs.rst:88 msgid "" "*streamreader* and *streamwriter*: These have to be factory functions " "providing the following interface:" msgstr "" -#: ../src/Doc/library/codecs.rst:91 +#: library/codecs.rst:91 msgid "``factory(stream, errors='strict')``" msgstr "" # 2a57c00109a24eddb23dd96380170d30 -#: ../src/Doc/library/codecs.rst:93 +#: library/codecs.rst:93 msgid "" "The factory functions must return objects providing the interfaces defined " "by the base classes :class:`StreamReader` and :class:`StreamWriter`, " "respectively. Stream codecs can maintain state." msgstr "" -#: ../src/Doc/library/codecs.rst:97 +#: library/codecs.rst:97 msgid "Possible values for errors are" msgstr "" -#: ../src/Doc/library/codecs.rst:99 +#: library/codecs.rst:99 msgid "``'strict'``: raise an exception in case of an encoding error" msgstr "" -#: ../src/Doc/library/codecs.rst:100 +#: library/codecs.rst:100 msgid "" "``'replace'``: replace malformed data with a suitable replacement marker, " "such as ``'?'`` or ``'\\ufffd'``" msgstr "" -#: ../src/Doc/library/codecs.rst:102 +#: library/codecs.rst:102 msgid "``'ignore'``: ignore malformed data and continue without further notice" msgstr "" -#: ../src/Doc/library/codecs.rst:103 +#: library/codecs.rst:103 msgid "" "``'xmlcharrefreplace'``: replace with the appropriate XML character " "reference (for encoding only)" msgstr "" -#: ../src/Doc/library/codecs.rst:105 +#: library/codecs.rst:105 msgid "" "``'backslashreplace'``: replace with backslashed escape sequences (for " "encoding only)" msgstr "" -#: ../src/Doc/library/codecs.rst:108 +#: library/codecs.rst:108 msgid "" "as well as any other error handling name defined via :func:`register_error`." msgstr "" -#: ../src/Doc/library/codecs.rst:110 +#: library/codecs.rst:110 msgid "" "In case a search function cannot find a given encoding, it should return " "``None``." msgstr "" -#: ../src/Doc/library/codecs.rst:116 +#: library/codecs.rst:116 msgid "" "Looks up the codec info in the Python codec registry and returns a :class:" "`CodecInfo` object as defined above." msgstr "" -#: ../src/Doc/library/codecs.rst:119 +#: library/codecs.rst:119 msgid "" "Encodings are first looked up in the registry's cache. If not found, the " "list of registered search functions is scanned. If no :class:`CodecInfo` " @@ -11660,71 +11697,71 @@ msgid "" "`CodecInfo` object is stored in the cache and returned to the caller." msgstr "" -#: ../src/Doc/library/codecs.rst:124 +#: library/codecs.rst:124 msgid "" "To simplify access to the various codecs, the module provides these " "additional functions which use :func:`lookup` for the codec lookup:" msgstr "" -#: ../src/Doc/library/codecs.rst:130 +#: library/codecs.rst:130 msgid "" "Look up the codec for the given encoding and return its encoder function." msgstr "" -#: ../src/Doc/library/codecs.rst:132 ../src/Doc/library/codecs.rst:139 -#: ../src/Doc/library/codecs.rst:169 ../src/Doc/library/codecs.rst:177 +#: library/codecs.rst:132 library/codecs.rst:139 library/codecs.rst:169 +#: library/codecs.rst:177 msgid "Raises a :exc:`LookupError` in case the encoding cannot be found." msgstr "" -#: ../src/Doc/library/codecs.rst:137 +#: library/codecs.rst:137 msgid "" "Look up the codec for the given encoding and return its decoder function." msgstr "" -#: ../src/Doc/library/codecs.rst:144 +#: library/codecs.rst:144 msgid "" "Look up the codec for the given encoding and return its incremental encoder " "class or factory function." msgstr "" -#: ../src/Doc/library/codecs.rst:147 +#: library/codecs.rst:147 msgid "" "Raises a :exc:`LookupError` in case the encoding cannot be found or the " "codec doesn't support an incremental encoder." msgstr "" -#: ../src/Doc/library/codecs.rst:155 +#: library/codecs.rst:155 msgid "" "Look up the codec for the given encoding and return its incremental decoder " "class or factory function." msgstr "" -#: ../src/Doc/library/codecs.rst:158 +#: library/codecs.rst:158 msgid "" "Raises a :exc:`LookupError` in case the encoding cannot be found or the " "codec doesn't support an incremental decoder." msgstr "" -#: ../src/Doc/library/codecs.rst:166 +#: library/codecs.rst:166 msgid "" "Look up the codec for the given encoding and return its StreamReader class " "or factory function." msgstr "" -#: ../src/Doc/library/codecs.rst:174 +#: library/codecs.rst:174 msgid "" "Look up the codec for the given encoding and return its StreamWriter class " "or factory function." msgstr "" -#: ../src/Doc/library/codecs.rst:182 +#: library/codecs.rst:182 msgid "" "Register the error handling function *error_handler* under the name *name*. " "*error_handler* will be called during encoding and decoding in case of an " "error, when *name* is specified as the errors parameter." msgstr "" -#: ../src/Doc/library/codecs.rst:186 +#: library/codecs.rst:186 msgid "" "For encoding *error_handler* will be called with a :exc:`UnicodeEncodeError` " "instance, which contains information about the location of the error. The " @@ -11737,59 +11774,59 @@ msgid "" "`IndexError` will be raised." msgstr "" -#: ../src/Doc/library/codecs.rst:195 +#: library/codecs.rst:195 msgid "" "Decoding and translating works similar, except :exc:`UnicodeDecodeError` or :" "exc:`UnicodeTranslateError` will be passed to the handler and that the " "replacement from the error handler will be put into the output directly." msgstr "" -#: ../src/Doc/library/codecs.rst:202 +#: library/codecs.rst:202 msgid "Return the error handler previously registered under the name *name*." msgstr "" -#: ../src/Doc/library/codecs.rst:204 +#: library/codecs.rst:204 msgid "Raises a :exc:`LookupError` in case the handler cannot be found." msgstr "" -#: ../src/Doc/library/codecs.rst:209 +#: library/codecs.rst:209 msgid "" "Implements the ``strict`` error handling: each encoding or decoding error " "raises a :exc:`UnicodeError`." msgstr "" -#: ../src/Doc/library/codecs.rst:215 +#: library/codecs.rst:215 msgid "" "Implements the ``replace`` error handling: malformed data is replaced with a " "suitable replacement character such as ``'?'`` in bytestrings and " "``'\\ufffd'`` in Unicode strings." msgstr "" -#: ../src/Doc/library/codecs.rst:222 +#: library/codecs.rst:222 msgid "" "Implements the ``ignore`` error handling: malformed data is ignored and " "encoding or decoding is continued without further notice." msgstr "" -#: ../src/Doc/library/codecs.rst:228 +#: library/codecs.rst:228 msgid "" "Implements the ``xmlcharrefreplace`` error handling (for encoding only): the " "unencodable character is replaced by an appropriate XML character reference." msgstr "" -#: ../src/Doc/library/codecs.rst:234 +#: library/codecs.rst:234 msgid "" "Implements the ``backslashreplace`` error handling (for encoding only): the " "unencodable character is replaced by a backslashed escape sequence." msgstr "" -#: ../src/Doc/library/codecs.rst:237 +#: library/codecs.rst:237 msgid "" "To simplify working with encoded files or stream, the module also defines " "these utility functions:" msgstr "" -#: ../src/Doc/library/codecs.rst:243 +#: library/codecs.rst:243 msgid "" "Open an encoded file using the given *mode* and return a wrapped version " "providing transparent encoding/decoding. The default file mode is ``'r'`` " @@ -11797,7 +11834,7 @@ msgid "" msgstr "" # 7b4cb66542c047feafa63d90bae76d54 -#: ../src/Doc/library/codecs.rst:249 +#: library/codecs.rst:249 msgid "" "The wrapped version will only accept the object format defined by the " "codecs, i.e. Unicode objects for most built-in codecs. Output is also codec-" @@ -11805,7 +11842,7 @@ msgid "" msgstr "" # 7c3a01fc0de4482a8affa46e3406ceda -#: ../src/Doc/library/codecs.rst:255 +#: library/codecs.rst:255 msgid "" "Files are always opened in binary mode, even if no binary mode was " "specified. This is done to avoid data loss due to encodings using 8-bit " @@ -11813,31 +11850,31 @@ msgid "" "reading and writing." msgstr "" -#: ../src/Doc/library/codecs.rst:260 +#: library/codecs.rst:260 msgid "*encoding* specifies the encoding which is to be used for the file." msgstr "" -#: ../src/Doc/library/codecs.rst:262 +#: library/codecs.rst:262 msgid "" "*errors* may be given to define the error handling. It defaults to " "``'strict'`` which causes a :exc:`ValueError` to be raised in case an " "encoding error occurs." msgstr "" -#: ../src/Doc/library/codecs.rst:265 +#: library/codecs.rst:265 msgid "" "*buffering* has the same meaning as for the built-in :func:`open` function. " "It defaults to line buffered." msgstr "" -#: ../src/Doc/library/codecs.rst:271 +#: library/codecs.rst:271 msgid "" "Return a wrapped version of file which provides transparent encoding " "translation." msgstr "" # ca3e0ebac3514189a80c59549dd67c89 -#: ../src/Doc/library/codecs.rst:274 +#: library/codecs.rst:274 msgid "" "Strings written to the wrapped file are interpreted according to the given " "*input* encoding and then written to the original file as strings using the " @@ -11846,11 +11883,11 @@ msgid "" msgstr "" # 09cc0858ff174ca8a044dfbd1ce7a31a -#: ../src/Doc/library/codecs.rst:279 +#: library/codecs.rst:279 msgid "If *output* is not given, it defaults to *input*." msgstr "" -#: ../src/Doc/library/codecs.rst:281 +#: library/codecs.rst:281 msgid "" "*errors* may be given to define the error handling. It defaults to " "``'strict'``, which causes :exc:`ValueError` to be raised in case an " @@ -11858,7 +11895,7 @@ msgid "" msgstr "" # 13a82bb9e99e466e9dcca359646d05b5 -#: ../src/Doc/library/codecs.rst:287 +#: library/codecs.rst:287 msgid "" "Uses an incremental encoder to iteratively encode the input provided by " "*iterable*. This function is a :term:`generator`. *errors* (as well as any " @@ -11866,20 +11903,20 @@ msgid "" msgstr "" # b55deb3812244d1fa0fe3467507e1aff -#: ../src/Doc/library/codecs.rst:296 +#: library/codecs.rst:296 msgid "" "Uses an incremental decoder to iteratively decode the input provided by " "*iterable*. This function is a :term:`generator`. *errors* (as well as any " "other keyword argument) is passed through to the incremental decoder." msgstr "" -#: ../src/Doc/library/codecs.rst:302 +#: library/codecs.rst:302 msgid "" "The module also provides the following constants which are useful for " "reading and writing to platform dependent files:" msgstr "" -#: ../src/Doc/library/codecs.rst:317 +#: library/codecs.rst:317 msgid "" "These constants define various encodings of the Unicode byte order mark " "(BOM) used in UTF-16 and UTF-32 data streams to indicate the byte order used " @@ -11891,18 +11928,18 @@ msgid "" "and UTF-32 encodings." msgstr "" -#: ../src/Doc/library/codecs.rst:330 +#: library/codecs.rst:330 msgid "Codec Base Classes" msgstr "" -#: ../src/Doc/library/codecs.rst:332 +#: library/codecs.rst:332 msgid "" "The :mod:`codecs` module defines a set of base classes which define the " "interface and can also be used to easily write your own codecs for use in " "Python." msgstr "" -#: ../src/Doc/library/codecs.rst:336 +#: library/codecs.rst:336 msgid "" "Each codec has to define four interfaces to make it usable as codec in " "Python: stateless encoder, stateless decoder, stream reader and stream " @@ -11910,14 +11947,14 @@ msgid "" "decoder to implement the file protocols." msgstr "" -#: ../src/Doc/library/codecs.rst:341 +#: library/codecs.rst:341 msgid "" "The :class:`Codec` class defines the interface for stateless encoders/" "decoders." msgstr "" # 45aa8ec9a1cb4a509a71f2e52e095d78 -#: ../src/Doc/library/codecs.rst:343 +#: library/codecs.rst:343 msgid "" "To simplify and standardize error handling, the :meth:`~Codec.encode` and :" "meth:`~Codec.decode` methods may implement different error handling schemes " @@ -11925,66 +11962,66 @@ msgid "" "defined and implemented by all standard Python codecs:" msgstr "" -#: ../src/Doc/library/codecs.rst:353 +#: library/codecs.rst:353 msgid "``'strict'``" msgstr "" -#: ../src/Doc/library/codecs.rst:353 +#: library/codecs.rst:353 msgid "Raise :exc:`UnicodeError` (or a subclass); this is the default." msgstr "" -#: ../src/Doc/library/codecs.rst:356 +#: library/codecs.rst:356 msgid "``'ignore'``" msgstr "" -#: ../src/Doc/library/codecs.rst:356 +#: library/codecs.rst:356 msgid "Ignore the character and continue with the next." msgstr "" -#: ../src/Doc/library/codecs.rst:359 ../src/Doc/library/difflib.rst:469 +#: library/codecs.rst:359 library/difflib.rst:469 msgid "``'replace'``" msgstr "" -#: ../src/Doc/library/codecs.rst:359 +#: library/codecs.rst:359 msgid "" "Replace with a suitable replacement character; Python will use the official U" "+FFFD REPLACEMENT CHARACTER for the built-in Unicode codecs on decoding and " "'?' on encoding." msgstr "" -#: ../src/Doc/library/codecs.rst:365 +#: library/codecs.rst:365 msgid "``'xmlcharrefreplace'``" msgstr "" -#: ../src/Doc/library/codecs.rst:365 +#: library/codecs.rst:365 msgid "" "Replace with the appropriate XML character reference (only for encoding)." msgstr "" -#: ../src/Doc/library/codecs.rst:368 +#: library/codecs.rst:368 msgid "``'backslashreplace'``" msgstr "" -#: ../src/Doc/library/codecs.rst:368 +#: library/codecs.rst:368 msgid "Replace with backslashed escape sequences (only for encoding)." msgstr "" -#: ../src/Doc/library/codecs.rst:372 +#: library/codecs.rst:372 msgid "The set of allowed values can be extended via :meth:`register_error`." msgstr "" -#: ../src/Doc/library/codecs.rst:378 +#: library/codecs.rst:378 msgid "Codec Objects" msgstr "" -#: ../src/Doc/library/codecs.rst:380 +#: library/codecs.rst:380 msgid "" "The :class:`Codec` class defines these methods which also define the " "function interfaces of the stateless encoder and decoder:" msgstr "" # 57fcbad4c84e4668bc5a19bfc834e103 -#: ../src/Doc/library/codecs.rst:386 +#: library/codecs.rst:386 msgid "" "Encodes the object *input* and returns a tuple (output object, length " "consumed). While codecs are not restricted to use with Unicode, in a Unicode " @@ -11992,27 +12029,27 @@ msgid "" "particular character set encoding (e.g., ``cp1252`` or ``iso-8859-1``)." msgstr "" -#: ../src/Doc/library/codecs.rst:391 ../src/Doc/library/codecs.rst:412 +#: library/codecs.rst:391 library/codecs.rst:412 msgid "" "*errors* defines the error handling to apply. It defaults to ``'strict'`` " "handling." msgstr "" -#: ../src/Doc/library/codecs.rst:394 ../src/Doc/library/codecs.rst:415 +#: library/codecs.rst:394 msgid "" "The method may not store state in the :class:`Codec` instance. Use :class:" -"`StreamCodec` for codecs which have to keep state in order to make encoding/" -"decoding efficient." +"`StreamWriter` for codecs which have to keep state in order to make encoding " +"efficient." msgstr "" -#: ../src/Doc/library/codecs.rst:398 +#: library/codecs.rst:398 msgid "" "The encoder must be able to handle zero length input and return an empty " "object of the output object type in this situation." msgstr "" # f7e449a151a24b6d9e62ef791b735c34 -#: ../src/Doc/library/codecs.rst:404 +#: library/codecs.rst:404 msgid "" "Decodes the object *input* and returns a tuple (output object, length " "consumed). In a Unicode context, decoding converts a plain string encoded " @@ -12020,21 +12057,28 @@ msgid "" msgstr "" # dd20a08b4a0d4b57a0841d93cf24657c -#: ../src/Doc/library/codecs.rst:408 +#: library/codecs.rst:408 msgid "" "*input* must be an object which provides the ``bf_getreadbuf`` buffer slot. " "Python strings, buffer objects and memory mapped files are examples of " "objects providing this slot." msgstr "" -#: ../src/Doc/library/codecs.rst:419 +#: library/codecs.rst:415 +msgid "" +"The method may not store state in the :class:`Codec` instance. Use :class:" +"`StreamReader` for codecs which have to keep state in order to make decoding " +"efficient." +msgstr "" + +#: library/codecs.rst:419 msgid "" "The decoder must be able to handle zero length input and return an empty " "object of the output object type in this situation." msgstr "" # 1a202da55a564e94b6bb9b076176b956 -#: ../src/Doc/library/codecs.rst:422 +#: library/codecs.rst:422 msgid "" "The :class:`IncrementalEncoder` and :class:`IncrementalDecoder` classes " "provide the basic interface for incremental encoding and decoding. Encoding/" @@ -12046,7 +12090,7 @@ msgid "" msgstr "" # 00fef0cae39847e8a5fca3109e8563cd -#: ../src/Doc/library/codecs.rst:430 +#: library/codecs.rst:430 msgid "" "The joined output of calls to the :meth:`~IncrementalEncoder.encode`/:meth:" "`~IncrementalDecoder.decode` method is the same as if all the single inputs " @@ -12054,60 +12098,60 @@ msgid "" "encoder/decoder." msgstr "" -#: ../src/Doc/library/codecs.rst:439 +#: library/codecs.rst:439 msgid "IncrementalEncoder Objects" msgstr "" -#: ../src/Doc/library/codecs.rst:443 +#: library/codecs.rst:443 msgid "" "The :class:`IncrementalEncoder` class is used for encoding an input in " "multiple steps. It defines the following methods which every incremental " "encoder must define in order to be compatible with the Python codec registry." msgstr "" -#: ../src/Doc/library/codecs.rst:450 +#: library/codecs.rst:450 msgid "Constructor for an :class:`IncrementalEncoder` instance." msgstr "" -#: ../src/Doc/library/codecs.rst:452 +#: library/codecs.rst:452 msgid "" "All incremental encoders must provide this constructor interface. They are " "free to add additional keyword arguments, but only the ones defined here are " "used by the Python codec registry." msgstr "" -#: ../src/Doc/library/codecs.rst:456 +#: library/codecs.rst:456 msgid "" "The :class:`IncrementalEncoder` may implement different error handling " "schemes by providing the *errors* keyword argument. These parameters are " "predefined:" msgstr "" -#: ../src/Doc/library/codecs.rst:459 ../src/Doc/library/codecs.rst:511 -#: ../src/Doc/library/codecs.rst:570 ../src/Doc/library/codecs.rst:635 +#: library/codecs.rst:459 library/codecs.rst:511 library/codecs.rst:570 +#: library/codecs.rst:635 msgid "" "``'strict'`` Raise :exc:`ValueError` (or a subclass); this is the default." msgstr "" -#: ../src/Doc/library/codecs.rst:461 ../src/Doc/library/codecs.rst:513 -#: ../src/Doc/library/codecs.rst:572 ../src/Doc/library/codecs.rst:637 +#: library/codecs.rst:461 library/codecs.rst:513 library/codecs.rst:572 +#: library/codecs.rst:637 msgid "``'ignore'`` Ignore the character and continue with the next." msgstr "" -#: ../src/Doc/library/codecs.rst:463 ../src/Doc/library/codecs.rst:574 +#: library/codecs.rst:463 library/codecs.rst:574 msgid "``'replace'`` Replace with a suitable replacement character" msgstr "" -#: ../src/Doc/library/codecs.rst:465 ../src/Doc/library/codecs.rst:576 +#: library/codecs.rst:465 library/codecs.rst:576 msgid "" "``'xmlcharrefreplace'`` Replace with the appropriate XML character reference" msgstr "" -#: ../src/Doc/library/codecs.rst:467 ../src/Doc/library/codecs.rst:578 +#: library/codecs.rst:467 library/codecs.rst:578 msgid "``'backslashreplace'`` Replace with backslashed escape sequences." msgstr "" -#: ../src/Doc/library/codecs.rst:469 +#: library/codecs.rst:469 msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " @@ -12115,58 +12159,58 @@ msgid "" "`IncrementalEncoder` object." msgstr "" -#: ../src/Doc/library/codecs.rst:474 ../src/Doc/library/codecs.rst:522 -#: ../src/Doc/library/codecs.rst:584 ../src/Doc/library/codecs.rst:645 +#: library/codecs.rst:474 library/codecs.rst:522 library/codecs.rst:584 +#: library/codecs.rst:645 msgid "" "The set of allowed values for the *errors* argument can be extended with :" "func:`register_error`." msgstr "" -#: ../src/Doc/library/codecs.rst:480 +#: library/codecs.rst:480 msgid "" "Encodes *object* (taking the current state of the encoder into account) and " "returns the resulting encoded object. If this is the last call to :meth:" "`encode` *final* must be true (the default is false)." msgstr "" -#: ../src/Doc/library/codecs.rst:487 +#: library/codecs.rst:487 msgid "Reset the encoder to the initial state." msgstr "" -#: ../src/Doc/library/codecs.rst:493 +#: library/codecs.rst:493 msgid "IncrementalDecoder Objects" msgstr "" -#: ../src/Doc/library/codecs.rst:495 +#: library/codecs.rst:495 msgid "" "The :class:`IncrementalDecoder` class is used for decoding an input in " "multiple steps. It defines the following methods which every incremental " "decoder must define in order to be compatible with the Python codec registry." msgstr "" -#: ../src/Doc/library/codecs.rst:502 +#: library/codecs.rst:502 msgid "Constructor for an :class:`IncrementalDecoder` instance." msgstr "" -#: ../src/Doc/library/codecs.rst:504 +#: library/codecs.rst:504 msgid "" "All incremental decoders must provide this constructor interface. They are " "free to add additional keyword arguments, but only the ones defined here are " "used by the Python codec registry." msgstr "" -#: ../src/Doc/library/codecs.rst:508 +#: library/codecs.rst:508 msgid "" "The :class:`IncrementalDecoder` may implement different error handling " "schemes by providing the *errors* keyword argument. These parameters are " "predefined:" msgstr "" -#: ../src/Doc/library/codecs.rst:515 ../src/Doc/library/codecs.rst:639 +#: library/codecs.rst:515 library/codecs.rst:639 msgid "``'replace'`` Replace with a suitable replacement character." msgstr "" -#: ../src/Doc/library/codecs.rst:517 +#: library/codecs.rst:517 msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " @@ -12174,7 +12218,7 @@ msgid "" "`IncrementalDecoder` object." msgstr "" -#: ../src/Doc/library/codecs.rst:528 +#: library/codecs.rst:528 msgid "" "Decodes *object* (taking the current state of the decoder into account) and " "returns the resulting decoded object. If this is the last call to :meth:" @@ -12185,50 +12229,50 @@ msgid "" "(which might raise an exception)." msgstr "" -#: ../src/Doc/library/codecs.rst:539 +#: library/codecs.rst:539 msgid "Reset the decoder to the initial state." msgstr "" -#: ../src/Doc/library/codecs.rst:542 +#: library/codecs.rst:542 msgid "" "The :class:`StreamWriter` and :class:`StreamReader` classes provide generic " "working interfaces which can be used to implement new encoding submodules " "very easily. See :mod:`encodings.utf_8` for an example of how this is done." msgstr "" -#: ../src/Doc/library/codecs.rst:550 +#: library/codecs.rst:550 msgid "StreamWriter Objects" msgstr "" -#: ../src/Doc/library/codecs.rst:552 +#: library/codecs.rst:552 msgid "" "The :class:`StreamWriter` class is a subclass of :class:`Codec` and defines " "the following methods which every stream writer must define in order to be " "compatible with the Python codec registry." msgstr "" -#: ../src/Doc/library/codecs.rst:559 +#: library/codecs.rst:559 msgid "Constructor for a :class:`StreamWriter` instance." msgstr "" -#: ../src/Doc/library/codecs.rst:561 +#: library/codecs.rst:561 msgid "" "All stream writers must provide this constructor interface. They are free to " "add additional keyword arguments, but only the ones defined here are used by " "the Python codec registry." msgstr "" -#: ../src/Doc/library/codecs.rst:565 +#: library/codecs.rst:565 msgid "*stream* must be a file-like object open for writing binary data." msgstr "" -#: ../src/Doc/library/codecs.rst:567 +#: library/codecs.rst:567 msgid "" "The :class:`StreamWriter` may implement different error handling schemes by " "providing the *errors* keyword argument. These parameters are predefined:" msgstr "" -#: ../src/Doc/library/codecs.rst:580 +#: library/codecs.rst:580 msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " @@ -12236,66 +12280,66 @@ msgid "" "object." msgstr "" -#: ../src/Doc/library/codecs.rst:590 +#: library/codecs.rst:590 msgid "Writes the object's contents encoded to the stream." msgstr "" -#: ../src/Doc/library/codecs.rst:595 +#: library/codecs.rst:595 msgid "" "Writes the concatenated list of strings to the stream (possibly by reusing " "the :meth:`write` method)." msgstr "" -#: ../src/Doc/library/codecs.rst:601 +#: library/codecs.rst:601 msgid "Flushes and resets the codec buffers used for keeping state." msgstr "" -#: ../src/Doc/library/codecs.rst:603 +#: library/codecs.rst:603 msgid "" "Calling this method should ensure that the data on the output is put into a " "clean state that allows appending of new fresh data without having to rescan " "the whole stream to recover state." msgstr "" -#: ../src/Doc/library/codecs.rst:608 +#: library/codecs.rst:608 msgid "" "In addition to the above methods, the :class:`StreamWriter` must also " "inherit all other methods and attributes from the underlying stream." msgstr "" -#: ../src/Doc/library/codecs.rst:615 +#: library/codecs.rst:615 msgid "StreamReader Objects" msgstr "" -#: ../src/Doc/library/codecs.rst:617 +#: library/codecs.rst:617 msgid "" "The :class:`StreamReader` class is a subclass of :class:`Codec` and defines " "the following methods which every stream reader must define in order to be " "compatible with the Python codec registry." msgstr "" -#: ../src/Doc/library/codecs.rst:624 +#: library/codecs.rst:624 msgid "Constructor for a :class:`StreamReader` instance." msgstr "" -#: ../src/Doc/library/codecs.rst:626 +#: library/codecs.rst:626 msgid "" "All stream readers must provide this constructor interface. They are free to " "add additional keyword arguments, but only the ones defined here are used by " "the Python codec registry." msgstr "" -#: ../src/Doc/library/codecs.rst:630 +#: library/codecs.rst:630 msgid "*stream* must be a file-like object open for reading (binary) data." msgstr "" -#: ../src/Doc/library/codecs.rst:632 +#: library/codecs.rst:632 msgid "" "The :class:`StreamReader` may implement different error handling schemes by " "providing the *errors* keyword argument. These parameters are defined:" msgstr "" -#: ../src/Doc/library/codecs.rst:641 +#: library/codecs.rst:641 msgid "" "The *errors* argument will be assigned to an attribute of the same name. " "Assigning to this attribute makes it possible to switch between different " @@ -12303,18 +12347,18 @@ msgid "" "object." msgstr "" -#: ../src/Doc/library/codecs.rst:651 +#: library/codecs.rst:651 msgid "Decodes data from the stream and returns the resulting object." msgstr "" -#: ../src/Doc/library/codecs.rst:653 +#: library/codecs.rst:653 msgid "" "*chars* indicates the number of characters to read from the stream. :func:" "`read` will never return more than *chars* characters, but it might return " "less, if there are not enough characters available." msgstr "" -#: ../src/Doc/library/codecs.rst:657 +#: library/codecs.rst:657 msgid "" "*size* indicates the approximate maximum number of bytes to read from the " "stream for decoding purposes. The decoder can modify this setting as " @@ -12323,13 +12367,13 @@ msgid "" "step." msgstr "" -#: ../src/Doc/library/codecs.rst:663 +#: library/codecs.rst:663 msgid "" "*firstline* indicates that it would be sufficient to only return the first " "line, if there are decoding errors on later lines." msgstr "" -#: ../src/Doc/library/codecs.rst:666 +#: library/codecs.rst:666 msgid "" "The method should use a greedy read strategy meaning that it should read as " "much data as is allowed within the definition of the encoding and the given " @@ -12337,79 +12381,92 @@ msgid "" "the stream, these should be read too." msgstr "" -#: ../src/Doc/library/codecs.rst:680 +#: library/codecs.rst:671 +#, fuzzy +msgid "*chars* argument added." +msgstr "Analyse des arguments" + +#: library/codecs.rst:674 +msgid "*firstline* argument added." +msgstr "" + +#: library/codecs.rst:680 msgid "Read one line from the input stream and return the decoded data." msgstr "" # df9a3e4e3aef42ab88e5071f480813fa -#: ../src/Doc/library/codecs.rst:682 +#: library/codecs.rst:682 msgid "" "*size*, if given, is passed as size argument to the stream's :meth:`read` " "method." msgstr "" -#: ../src/Doc/library/codecs.rst:685 +#: library/codecs.rst:685 msgid "" "If *keepends* is false line-endings will be stripped from the lines returned." msgstr "" -#: ../src/Doc/library/codecs.rst:694 +#: library/codecs.rst:688 +msgid "*keepends* argument added." +msgstr "" + +#: library/codecs.rst:694 msgid "" "Read all lines available on the input stream and return them as a list of " "lines." msgstr "" -#: ../src/Doc/library/codecs.rst:697 +#: library/codecs.rst:697 msgid "" "Line-endings are implemented using the codec's decoder method and are " "included in the list entries if *keepends* is true." msgstr "" -#: ../src/Doc/library/codecs.rst:700 +#: library/codecs.rst:700 msgid "" "*sizehint*, if given, is passed as the *size* argument to the stream's :meth:" "`read` method." msgstr "" -#: ../src/Doc/library/codecs.rst:706 +#: library/codecs.rst:706 msgid "Resets the codec buffers used for keeping state." msgstr "" -#: ../src/Doc/library/codecs.rst:708 +#: library/codecs.rst:708 msgid "" "Note that no stream repositioning should take place. This method is " "primarily intended to be able to recover from decoding errors." msgstr "" -#: ../src/Doc/library/codecs.rst:712 +#: library/codecs.rst:712 msgid "" "In addition to the above methods, the :class:`StreamReader` must also " "inherit all other methods and attributes from the underlying stream." msgstr "" -#: ../src/Doc/library/codecs.rst:715 +#: library/codecs.rst:715 msgid "" "The next two base classes are included for convenience. They are not needed " "by the codec registry, but may provide useful in practice." msgstr "" -#: ../src/Doc/library/codecs.rst:722 +#: library/codecs.rst:722 msgid "StreamReaderWriter Objects" msgstr "" -#: ../src/Doc/library/codecs.rst:724 +#: library/codecs.rst:724 msgid "" "The :class:`StreamReaderWriter` allows wrapping streams which work in both " "read and write modes." msgstr "" -#: ../src/Doc/library/codecs.rst:727 ../src/Doc/library/codecs.rst:751 +#: library/codecs.rst:727 library/codecs.rst:751 msgid "" "The design is such that one can use the factory functions returned by the :" "func:`lookup` function to construct the instance." msgstr "" -#: ../src/Doc/library/codecs.rst:733 +#: library/codecs.rst:733 msgid "" "Creates a :class:`StreamReaderWriter` instance. *stream* must be a file-like " "object. *Reader* and *Writer* must be factory functions or classes providing " @@ -12418,25 +12475,25 @@ msgid "" "writers." msgstr "" -#: ../src/Doc/library/codecs.rst:738 +#: library/codecs.rst:738 msgid "" ":class:`StreamReaderWriter` instances define the combined interfaces of :" "class:`StreamReader` and :class:`StreamWriter` classes. They inherit all " "other methods and attributes from the underlying stream." msgstr "" -#: ../src/Doc/library/codecs.rst:746 +#: library/codecs.rst:746 msgid "StreamRecoder Objects" msgstr "" -#: ../src/Doc/library/codecs.rst:748 +#: library/codecs.rst:748 msgid "" "The :class:`StreamRecoder` provide a frontend - backend view of encoding " "data which is sometimes useful when dealing with different encoding " "environments." msgstr "" -#: ../src/Doc/library/codecs.rst:757 +#: library/codecs.rst:757 msgid "" "Creates a :class:`StreamRecoder` instance which implements a two-way " "conversion: *encode* and *decode* work on the frontend (the input to :meth:" @@ -12444,17 +12501,17 @@ msgid "" "backend (reading and writing to the stream)." msgstr "" -#: ../src/Doc/library/codecs.rst:762 +#: library/codecs.rst:762 msgid "" "You can use these objects to do transparent direct recodings from e.g. " "Latin-1 to UTF-8 and back." msgstr "" -#: ../src/Doc/library/codecs.rst:765 +#: library/codecs.rst:765 msgid "*stream* must be a file-like object." msgstr "" -#: ../src/Doc/library/codecs.rst:767 +#: library/codecs.rst:767 msgid "" "*encode*, *decode* must adhere to the :class:`Codec` interface. *Reader*, " "*Writer* must be factory functions or classes providing objects of the :" @@ -12462,7 +12519,7 @@ msgid "" msgstr "" # 4f4c046e93b84c48b780a029cdc7f21b -#: ../src/Doc/library/codecs.rst:771 +#: library/codecs.rst:771 msgid "" "*encode* and *decode* are needed for the frontend translation, *Reader* and " "*Writer* for the backend translation. The intermediate format used is " @@ -12470,27 +12527,26 @@ msgid "" "Unicode as the intermediate encoding." msgstr "" -#: ../src/Doc/library/codecs.rst:776 +#: library/codecs.rst:776 msgid "" "Error handling is done in the same way as defined for the stream readers and " "writers." msgstr "" -#: ../src/Doc/library/codecs.rst:780 +#: library/codecs.rst:780 msgid "" ":class:`StreamRecoder` instances define the combined interfaces of :class:" "`StreamReader` and :class:`StreamWriter` classes. They inherit all other " "methods and attributes from the underlying stream." msgstr "" -#: ../src/Doc/library/codecs.rst:788 +#: library/codecs.rst:788 msgid "Encodings and Unicode" msgstr "" -# cc208c110ef64d4f90d84e0fe8e6d366 -#: ../src/Doc/library/codecs.rst:790 +#: library/codecs.rst:790 msgid "" -"Unicode strings are stored internally as sequences of codepoints (to be " +"Unicode strings are stored internally as sequences of code points (to be " "precise as :c:type:`Py_UNICODE` arrays). Depending on the way Python is " "compiled (either via ``--enable-unicode=ucs2`` or ``--enable-unicode=ucs4``, " "with the former being the default) :c:type:`Py_UNICODE` is either a 16-bit " @@ -12500,40 +12556,38 @@ msgid "" "encoding and recreating the unicode object from the sequence of bytes is " "known as decoding. There are many different methods for how this " "transformation can be done (these methods are also called encodings). The " -"simplest method is to map the codepoints 0-255 to the bytes ``0x0``-" -"``0xff``. This means that a unicode object that contains codepoints above ``U" -"+00FF`` can't be encoded with this method (which is called ``'latin-1'`` or " -"``'iso-8859-1'``). :func:`unicode.encode` will raise a :exc:" +"simplest method is to map the code points 0-255 to the bytes ``0x0``-" +"``0xff``. This means that a unicode object that contains code points above " +"``U+00FF`` can't be encoded with this method (which is called ``'latin-1'`` " +"or ``'iso-8859-1'``). :func:`unicode.encode` will raise a :exc:" "`UnicodeEncodeError` that looks like this: ``UnicodeEncodeError: 'latin-1' " "codec can't encode character u'\\u1234' in position 3: ordinal not in " "range(256)``." msgstr "" -# 1eb899b1097c43fbab13f3549587d578 -#: ../src/Doc/library/codecs.rst:807 +#: library/codecs.rst:807 msgid "" "There's another group of encodings (the so called charmap encodings) that " -"choose a different subset of all unicode code points and how these " -"codepoints are mapped to the bytes ``0x0``-``0xff``. To see how this is done " +"choose a different subset of all unicode code points and how these code " +"points are mapped to the bytes ``0x0``-``0xff``. To see how this is done " "simply open e.g. :file:`encodings/cp1252.py` (which is an encoding that is " "used primarily on Windows). There's a string constant with 256 characters " "that shows you which character is mapped to which byte value." msgstr "" -# 8e8ef3dd7e4d48dc9f33ff992abd11ae -#: ../src/Doc/library/codecs.rst:814 +#: library/codecs.rst:814 msgid "" -"All of these encodings can only encode 256 of the 1114112 codepoints defined " -"in unicode. A simple and straightforward way that can store each Unicode " -"code point, is to store each codepoint as four consecutive bytes. There are " -"two possibilities: store the bytes in big endian or in little endian order. " -"These two encodings are called ``UTF-32-BE`` and ``UTF-32-LE`` respectively. " -"Their disadvantage is that if e.g. you use ``UTF-32-BE`` on a little endian " -"machine you will always have to swap bytes on encoding and decoding. " -"``UTF-32`` avoids this problem: bytes will always be in natural endianness. " -"When these bytes are read by a CPU with a different endianness, then bytes " -"have to be swapped though. To be able to detect the endianness of a " -"``UTF-16`` or ``UTF-32`` byte sequence, there's the so called BOM (\"Byte " +"All of these encodings can only encode 256 of the 1114112 code points " +"defined in unicode. A simple and straightforward way that can store each " +"Unicode code point, is to store each code point as four consecutive bytes. " +"There are two possibilities: store the bytes in big endian or in little " +"endian order. These two encodings are called ``UTF-32-BE`` and ``UTF-32-LE`` " +"respectively. Their disadvantage is that if e.g. you use ``UTF-32-BE`` on a " +"little endian machine you will always have to swap bytes on encoding and " +"decoding. ``UTF-32`` avoids this problem: bytes will always be in natural " +"endianness. When these bytes are read by a CPU with a different endianness, " +"then bytes have to be swapped though. To be able to detect the endianness of " +"a ``UTF-16`` or ``UTF-32`` byte sequence, there's the so called BOM (\"Byte " "Order Mark\"). This is the Unicode character ``U+FEFF``. This character can " "be prepended to every ``UTF-16`` or ``UTF-32`` byte sequence. The byte " "swapped version of this character (``0xFFFE``) is an illegal character that " @@ -12552,7 +12606,7 @@ msgid "" msgstr "" # a3e170c02e7f48e0af7d9f9e99a031c3 -#: ../src/Doc/library/codecs.rst:840 +#: library/codecs.rst:840 msgid "" "There's another encoding that is able to encoding the full range of Unicode " "characters: UTF-8. UTF-8 is an 8-bit encoding, which means there are no " @@ -12563,54 +12617,54 @@ msgid "" "which when concatenated give the Unicode character):" msgstr "" -#: ../src/Doc/library/codecs.rst:849 +#: library/codecs.rst:849 msgid "Range" msgstr "" -#: ../src/Doc/library/codecs.rst:849 +#: library/codecs.rst:849 msgid "Encoding" msgstr "" -#: ../src/Doc/library/codecs.rst:851 +#: library/codecs.rst:851 msgid "``U-00000000`` ... ``U-0000007F``" msgstr "" -#: ../src/Doc/library/codecs.rst:851 +#: library/codecs.rst:851 msgid "0xxxxxxx" msgstr "" -#: ../src/Doc/library/codecs.rst:853 +#: library/codecs.rst:853 msgid "``U-00000080`` ... ``U-000007FF``" msgstr "" -#: ../src/Doc/library/codecs.rst:853 +#: library/codecs.rst:853 msgid "110xxxxx 10xxxxxx" msgstr "" -#: ../src/Doc/library/codecs.rst:855 +#: library/codecs.rst:855 msgid "``U-00000800`` ... ``U-0000FFFF``" msgstr "" -#: ../src/Doc/library/codecs.rst:855 +#: library/codecs.rst:855 msgid "1110xxxx 10xxxxxx 10xxxxxx" msgstr "" # 0c4cbf77af9e4655aafb1190bd0b7795 -#: ../src/Doc/library/codecs.rst:857 +#: library/codecs.rst:857 msgid "``U-00010000`` ... ``U-0010FFFF``" msgstr "" -#: ../src/Doc/library/codecs.rst:857 +#: library/codecs.rst:857 msgid "11110xxx 10xxxxxx 10xxxxxx 10xxxxxx" msgstr "" -#: ../src/Doc/library/codecs.rst:860 +#: library/codecs.rst:860 msgid "" "The least significant bit of the Unicode character is the rightmost x bit." msgstr "" # c847cc81fedf4366a1e45f87b616892b -#: ../src/Doc/library/codecs.rst:862 +#: library/codecs.rst:862 msgid "" "As UTF-8 is an 8-bit encoding no BOM is required and any ``U+FEFF`` " "character in the decoded Unicode string (even if it's the first character) " @@ -12618,7 +12672,7 @@ msgid "" msgstr "" # aff7fbb305754dedaa35729d95126e76 -#: ../src/Doc/library/codecs.rst:866 +#: library/codecs.rst:866 msgid "" "Without external information it's impossible to reliably determine which " "encoding was used for encoding a Unicode string. Each charmap encoding can " @@ -12633,8 +12687,20 @@ msgid "" "values (which would e.g. map to" msgstr "" +#: library/codecs.rst:0 +msgid "LATIN SMALL LETTER I WITH DIAERESIS" +msgstr "" + +#: library/codecs.rst:0 +msgid "RIGHT-POINTING DOUBLE ANGLE QUOTATION MARK" +msgstr "" + +#: library/codecs.rst:0 +msgid "INVERTED QUESTION MARK" +msgstr "" + # b69f24039dd44b9586bbb538a89ee9bf -#: ../src/Doc/library/codecs.rst:882 +#: library/codecs.rst:882 msgid "" "in iso-8859-1), this increases the probability that a ``utf-8-sig`` encoding " "can be correctly guessed from the byte sequence. So here the BOM is not used " @@ -12646,11 +12712,11 @@ msgid "" "the use of the BOM is discouraged and should generally be avoided." msgstr "" -#: ../src/Doc/library/codecs.rst:895 +#: library/codecs.rst:895 msgid "Standard Encodings" msgstr "" -#: ../src/Doc/library/codecs.rst:897 +#: library/codecs.rst:897 msgid "" "Python comes with a number of codecs built-in, either implemented as C " "functions or with dictionaries as mapping tables. The following table lists " @@ -12662,7 +12728,7 @@ msgid "" "alias for the ``'utf_8'`` codec." msgstr "" -#: ../src/Doc/library/codecs.rst:905 +#: library/codecs.rst:905 msgid "" "Many of the character sets support the same languages. They vary in " "individual characters (e.g. whether the EURO SIGN is supported or not), and " @@ -12670,899 +12736,900 @@ msgid "" "languages in particular, the following variants typically exist:" msgstr "" -#: ../src/Doc/library/codecs.rst:910 +#: library/codecs.rst:910 msgid "an ISO 8859 codeset" msgstr "" -#: ../src/Doc/library/codecs.rst:912 +#: library/codecs.rst:912 msgid "" "a Microsoft Windows code page, which is typically derived from a 8859 " "codeset, but replaces control characters with additional graphic characters" msgstr "" -#: ../src/Doc/library/codecs.rst:915 +#: library/codecs.rst:915 msgid "an IBM EBCDIC code page" msgstr "" -#: ../src/Doc/library/codecs.rst:917 +#: library/codecs.rst:917 msgid "an IBM PC code page, which is ASCII compatible" msgstr "" -#: ../src/Doc/library/codecs.rst:922 ../src/Doc/library/codecs.rst:1145 -#: ../src/Doc/library/codecs.rst:1194 +#: library/codecs.rst:922 library/codecs.rst:1147 library/codecs.rst:1196 msgid "Codec" msgstr "" -#: ../src/Doc/library/codecs.rst:922 ../src/Doc/library/codecs.rst:1145 -#: ../src/Doc/library/codecs.rst:1194 +#: library/codecs.rst:922 library/codecs.rst:1147 library/codecs.rst:1196 msgid "Aliases" msgstr "" -#: ../src/Doc/library/codecs.rst:922 +#: library/codecs.rst:922 msgid "Languages" msgstr "" -#: ../src/Doc/library/codecs.rst:924 +#: library/codecs.rst:924 msgid "ascii" msgstr "" -#: ../src/Doc/library/codecs.rst:924 +#: library/codecs.rst:924 msgid "646, us-ascii" msgstr "" -#: ../src/Doc/library/codecs.rst:924 ../src/Doc/library/codecs.rst:930 -#: ../src/Doc/library/codecs.rst:934 +#: library/codecs.rst:924 library/codecs.rst:930 library/codecs.rst:934 msgid "English" msgstr "" -#: ../src/Doc/library/codecs.rst:926 +#: library/codecs.rst:926 msgid "big5" msgstr "" -#: ../src/Doc/library/codecs.rst:926 +#: library/codecs.rst:926 msgid "big5-tw, csbig5" msgstr "" -#: ../src/Doc/library/codecs.rst:926 ../src/Doc/library/codecs.rst:928 -#: ../src/Doc/library/codecs.rst:982 +#: library/codecs.rst:926 library/codecs.rst:928 library/codecs.rst:982 msgid "Traditional Chinese" msgstr "" -#: ../src/Doc/library/codecs.rst:928 +#: library/codecs.rst:928 msgid "big5hkscs" msgstr "" -#: ../src/Doc/library/codecs.rst:928 +#: library/codecs.rst:928 msgid "big5-hkscs, hkscs" msgstr "" -#: ../src/Doc/library/codecs.rst:930 +#: library/codecs.rst:930 msgid "cp037" msgstr "" -#: ../src/Doc/library/codecs.rst:930 +#: library/codecs.rst:930 msgid "IBM037, IBM039" msgstr "" -#: ../src/Doc/library/codecs.rst:932 +#: library/codecs.rst:932 msgid "cp424" msgstr "" -#: ../src/Doc/library/codecs.rst:932 +#: library/codecs.rst:932 msgid "EBCDIC-CP-HE, IBM424" msgstr "" -#: ../src/Doc/library/codecs.rst:932 ../src/Doc/library/codecs.rst:952 -#: ../src/Doc/library/codecs.rst:962 ../src/Doc/library/codecs.rst:1001 -#: ../src/Doc/library/codecs.rst:1064 +#: library/codecs.rst:932 library/codecs.rst:952 library/codecs.rst:962 +#: library/codecs.rst:1001 library/codecs.rst:1064 msgid "Hebrew" msgstr "" -#: ../src/Doc/library/codecs.rst:934 +#: library/codecs.rst:934 msgid "cp437" msgstr "" -#: ../src/Doc/library/codecs.rst:934 +#: library/codecs.rst:934 msgid "437, IBM437" msgstr "" -#: ../src/Doc/library/codecs.rst:936 +#: library/codecs.rst:936 msgid "cp500" msgstr "" -#: ../src/Doc/library/codecs.rst:936 +#: library/codecs.rst:936 msgid "EBCDIC-CP-BE, EBCDIC-CP-CH, IBM500" msgstr "" -#: ../src/Doc/library/codecs.rst:936 ../src/Doc/library/codecs.rst:945 -#: ../src/Doc/library/codecs.rst:956 ../src/Doc/library/codecs.rst:988 -#: ../src/Doc/library/codecs.rst:995 ../src/Doc/library/codecs.rst:1074 -#: ../src/Doc/library/codecs.rst:1093 +#: library/codecs.rst:936 library/codecs.rst:945 library/codecs.rst:956 +#: library/codecs.rst:988 library/codecs.rst:995 library/codecs.rst:1076 +#: library/codecs.rst:1095 msgid "Western Europe" msgstr "" -#: ../src/Doc/library/codecs.rst:939 +#: library/codecs.rst:939 msgid "cp720" msgstr "" -#: ../src/Doc/library/codecs.rst:939 ../src/Doc/library/codecs.rst:966 -#: ../src/Doc/library/codecs.rst:1003 ../src/Doc/library/codecs.rst:1060 +#: library/codecs.rst:939 library/codecs.rst:966 library/codecs.rst:1003 +#: library/codecs.rst:1060 msgid "Arabic" msgstr "" -#: ../src/Doc/library/codecs.rst:941 +#: library/codecs.rst:941 msgid "cp737" msgstr "" -#: ../src/Doc/library/codecs.rst:941 ../src/Doc/library/codecs.rst:972 -#: ../src/Doc/library/codecs.rst:976 ../src/Doc/library/codecs.rst:997 -#: ../src/Doc/library/codecs.rst:1062 ../src/Doc/library/codecs.rst:1087 +#: library/codecs.rst:941 library/codecs.rst:972 library/codecs.rst:976 +#: library/codecs.rst:997 library/codecs.rst:1062 library/codecs.rst:1089 msgid "Greek" msgstr "" -#: ../src/Doc/library/codecs.rst:943 +#: library/codecs.rst:943 msgid "cp775" msgstr "" -#: ../src/Doc/library/codecs.rst:943 +#: library/codecs.rst:943 msgid "IBM775" msgstr "" -#: ../src/Doc/library/codecs.rst:943 ../src/Doc/library/codecs.rst:1005 -#: ../src/Doc/library/codecs.rst:1055 ../src/Doc/library/codecs.rst:1070 +#: library/codecs.rst:943 library/codecs.rst:1005 library/codecs.rst:1055 +#: library/codecs.rst:1072 msgid "Baltic languages" msgstr "" -#: ../src/Doc/library/codecs.rst:945 +#: library/codecs.rst:945 msgid "cp850" msgstr "" -#: ../src/Doc/library/codecs.rst:945 +#: library/codecs.rst:945 msgid "850, IBM850" msgstr "" -#: ../src/Doc/library/codecs.rst:947 +#: library/codecs.rst:947 msgid "cp852" msgstr "" -#: ../src/Doc/library/codecs.rst:947 +#: library/codecs.rst:947 msgid "852, IBM852" msgstr "" -#: ../src/Doc/library/codecs.rst:947 ../src/Doc/library/codecs.rst:990 -#: ../src/Doc/library/codecs.rst:1051 ../src/Doc/library/codecs.rst:1091 +#: library/codecs.rst:947 library/codecs.rst:990 library/codecs.rst:1051 +#: library/codecs.rst:1093 msgid "Central and Eastern Europe" msgstr "" -#: ../src/Doc/library/codecs.rst:949 +#: library/codecs.rst:949 msgid "cp855" msgstr "" -#: ../src/Doc/library/codecs.rst:949 +#: library/codecs.rst:949 msgid "855, IBM855" msgstr "" -#: ../src/Doc/library/codecs.rst:949 ../src/Doc/library/codecs.rst:992 -#: ../src/Doc/library/codecs.rst:1057 ../src/Doc/library/codecs.rst:1084 +#: library/codecs.rst:949 library/codecs.rst:992 library/codecs.rst:1057 +#: library/codecs.rst:1086 msgid "Bulgarian, Byelorussian, Macedonian, Russian, Serbian" msgstr "" -#: ../src/Doc/library/codecs.rst:952 +#: library/codecs.rst:952 msgid "cp856" msgstr "" -#: ../src/Doc/library/codecs.rst:954 +#: library/codecs.rst:954 msgid "cp857" msgstr "" -#: ../src/Doc/library/codecs.rst:954 +#: library/codecs.rst:954 msgid "857, IBM857" msgstr "" -#: ../src/Doc/library/codecs.rst:954 ../src/Doc/library/codecs.rst:986 -#: ../src/Doc/library/codecs.rst:999 ../src/Doc/library/codecs.rst:1066 -#: ../src/Doc/library/codecs.rst:1095 +#: library/codecs.rst:954 library/codecs.rst:986 library/codecs.rst:999 +#: library/codecs.rst:1066 library/codecs.rst:1097 msgid "Turkish" msgstr "" -#: ../src/Doc/library/codecs.rst:956 +#: library/codecs.rst:956 msgid "cp858" msgstr "" -#: ../src/Doc/library/codecs.rst:956 +#: library/codecs.rst:956 msgid "858, IBM858" msgstr "" -#: ../src/Doc/library/codecs.rst:958 +#: library/codecs.rst:958 msgid "cp860" msgstr "" -#: ../src/Doc/library/codecs.rst:958 +#: library/codecs.rst:958 msgid "860, IBM860" msgstr "" -#: ../src/Doc/library/codecs.rst:958 +#: library/codecs.rst:958 msgid "Portuguese" msgstr "" -#: ../src/Doc/library/codecs.rst:960 +#: library/codecs.rst:960 msgid "cp861" msgstr "" -#: ../src/Doc/library/codecs.rst:960 +#: library/codecs.rst:960 msgid "861, CP-IS, IBM861" msgstr "" -#: ../src/Doc/library/codecs.rst:960 ../src/Doc/library/codecs.rst:1089 +#: library/codecs.rst:960 library/codecs.rst:1091 msgid "Icelandic" msgstr "" -#: ../src/Doc/library/codecs.rst:962 +#: library/codecs.rst:962 msgid "cp862" msgstr "" -#: ../src/Doc/library/codecs.rst:962 +#: library/codecs.rst:962 msgid "862, IBM862" msgstr "" -#: ../src/Doc/library/codecs.rst:964 +#: library/codecs.rst:964 msgid "cp863" msgstr "" -#: ../src/Doc/library/codecs.rst:964 +#: library/codecs.rst:964 msgid "863, IBM863" msgstr "" -#: ../src/Doc/library/codecs.rst:964 +#: library/codecs.rst:964 msgid "Canadian" msgstr "" -#: ../src/Doc/library/codecs.rst:966 +#: library/codecs.rst:966 msgid "cp864" msgstr "" -#: ../src/Doc/library/codecs.rst:966 +#: library/codecs.rst:966 msgid "IBM864" msgstr "" -#: ../src/Doc/library/codecs.rst:968 +#: library/codecs.rst:968 msgid "cp865" msgstr "" -#: ../src/Doc/library/codecs.rst:968 +#: library/codecs.rst:968 msgid "865, IBM865" msgstr "" -#: ../src/Doc/library/codecs.rst:968 +#: library/codecs.rst:968 msgid "Danish, Norwegian" msgstr "" -#: ../src/Doc/library/codecs.rst:970 +#: library/codecs.rst:970 msgid "cp866" msgstr "" -#: ../src/Doc/library/codecs.rst:970 +#: library/codecs.rst:970 msgid "866, IBM866" msgstr "" -#: ../src/Doc/library/codecs.rst:970 ../src/Doc/library/codecs.rst:1080 +#: library/codecs.rst:970 library/codecs.rst:1082 msgid "Russian" msgstr "" -#: ../src/Doc/library/codecs.rst:972 +#: library/codecs.rst:972 msgid "cp869" msgstr "" -#: ../src/Doc/library/codecs.rst:972 +#: library/codecs.rst:972 msgid "869, CP-GR, IBM869" msgstr "" -#: ../src/Doc/library/codecs.rst:974 +#: library/codecs.rst:974 msgid "cp874" msgstr "" -#: ../src/Doc/library/codecs.rst:974 +#: library/codecs.rst:974 msgid "Thai" msgstr "" -#: ../src/Doc/library/codecs.rst:976 +#: library/codecs.rst:976 msgid "cp875" msgstr "" -#: ../src/Doc/library/codecs.rst:978 +#: library/codecs.rst:978 msgid "cp932" msgstr "" -#: ../src/Doc/library/codecs.rst:978 +#: library/codecs.rst:978 msgid "932, ms932, mskanji, ms-kanji" msgstr "" -#: ../src/Doc/library/codecs.rst:978 ../src/Doc/library/codecs.rst:1009 -#: ../src/Doc/library/codecs.rst:1011 ../src/Doc/library/codecs.rst:1013 -#: ../src/Doc/library/codecs.rst:1030 ../src/Doc/library/codecs.rst:1033 -#: ../src/Doc/library/codecs.rst:1038 ../src/Doc/library/codecs.rst:1041 -#: ../src/Doc/library/codecs.rst:1043 ../src/Doc/library/codecs.rst:1100 -#: ../src/Doc/library/codecs.rst:1103 ../src/Doc/library/codecs.rst:1106 +#: library/codecs.rst:978 library/codecs.rst:1009 library/codecs.rst:1011 +#: library/codecs.rst:1013 library/codecs.rst:1030 library/codecs.rst:1033 +#: library/codecs.rst:1038 library/codecs.rst:1041 library/codecs.rst:1043 +#: library/codecs.rst:1102 library/codecs.rst:1105 library/codecs.rst:1108 msgid "Japanese" msgstr "" -#: ../src/Doc/library/codecs.rst:980 +#: library/codecs.rst:980 msgid "cp949" msgstr "" -#: ../src/Doc/library/codecs.rst:980 +#: library/codecs.rst:980 msgid "949, ms949, uhc" msgstr "" -#: ../src/Doc/library/codecs.rst:980 ../src/Doc/library/codecs.rst:1015 -#: ../src/Doc/library/codecs.rst:1045 ../src/Doc/library/codecs.rst:1078 +#: library/codecs.rst:980 library/codecs.rst:1015 library/codecs.rst:1045 +#: library/codecs.rst:1080 msgid "Korean" msgstr "" -#: ../src/Doc/library/codecs.rst:982 +#: library/codecs.rst:982 msgid "cp950" msgstr "" -#: ../src/Doc/library/codecs.rst:982 +#: library/codecs.rst:982 msgid "950, ms950" msgstr "" -#: ../src/Doc/library/codecs.rst:984 +#: library/codecs.rst:984 msgid "cp1006" msgstr "" -#: ../src/Doc/library/codecs.rst:984 +#: library/codecs.rst:984 msgid "Urdu" msgstr "" -#: ../src/Doc/library/codecs.rst:986 +#: library/codecs.rst:986 msgid "cp1026" msgstr "" -#: ../src/Doc/library/codecs.rst:986 +#: library/codecs.rst:986 msgid "ibm1026" msgstr "" -#: ../src/Doc/library/codecs.rst:988 +#: library/codecs.rst:988 msgid "cp1140" msgstr "" -#: ../src/Doc/library/codecs.rst:988 +#: library/codecs.rst:988 msgid "ibm1140" msgstr "" -#: ../src/Doc/library/codecs.rst:990 +#: library/codecs.rst:990 msgid "cp1250" msgstr "" -#: ../src/Doc/library/codecs.rst:990 +#: library/codecs.rst:990 msgid "windows-1250" msgstr "" -#: ../src/Doc/library/codecs.rst:992 +#: library/codecs.rst:992 msgid "cp1251" msgstr "" -#: ../src/Doc/library/codecs.rst:992 +#: library/codecs.rst:992 msgid "windows-1251" msgstr "" -#: ../src/Doc/library/codecs.rst:995 +#: library/codecs.rst:995 msgid "cp1252" msgstr "" -#: ../src/Doc/library/codecs.rst:995 +#: library/codecs.rst:995 msgid "windows-1252" msgstr "" -#: ../src/Doc/library/codecs.rst:997 +#: library/codecs.rst:997 msgid "cp1253" msgstr "" -#: ../src/Doc/library/codecs.rst:997 +#: library/codecs.rst:997 msgid "windows-1253" msgstr "" -#: ../src/Doc/library/codecs.rst:999 +#: library/codecs.rst:999 msgid "cp1254" msgstr "" -#: ../src/Doc/library/codecs.rst:999 +#: library/codecs.rst:999 msgid "windows-1254" msgstr "" -#: ../src/Doc/library/codecs.rst:1001 +#: library/codecs.rst:1001 msgid "cp1255" msgstr "" -#: ../src/Doc/library/codecs.rst:1001 +#: library/codecs.rst:1001 msgid "windows-1255" msgstr "" -#: ../src/Doc/library/codecs.rst:1003 +#: library/codecs.rst:1003 msgid "cp1256" msgstr "" -#: ../src/Doc/library/codecs.rst:1003 +#: library/codecs.rst:1003 msgid "windows-1256" msgstr "" -#: ../src/Doc/library/codecs.rst:1005 +#: library/codecs.rst:1005 msgid "cp1257" msgstr "" -#: ../src/Doc/library/codecs.rst:1005 +#: library/codecs.rst:1005 msgid "windows-1257" msgstr "" -#: ../src/Doc/library/codecs.rst:1007 +#: library/codecs.rst:1007 msgid "cp1258" msgstr "" -#: ../src/Doc/library/codecs.rst:1007 +#: library/codecs.rst:1007 msgid "windows-1258" msgstr "" -#: ../src/Doc/library/codecs.rst:1007 +#: library/codecs.rst:1007 msgid "Vietnamese" msgstr "" -#: ../src/Doc/library/codecs.rst:1009 +#: library/codecs.rst:1009 msgid "euc_jp" msgstr "" -#: ../src/Doc/library/codecs.rst:1009 +#: library/codecs.rst:1009 msgid "eucjp, ujis, u-jis" msgstr "" -#: ../src/Doc/library/codecs.rst:1011 +#: library/codecs.rst:1011 msgid "euc_jis_2004" msgstr "" -#: ../src/Doc/library/codecs.rst:1011 +#: library/codecs.rst:1011 msgid "jisx0213, eucjis2004" msgstr "" -#: ../src/Doc/library/codecs.rst:1013 +#: library/codecs.rst:1013 msgid "euc_jisx0213" msgstr "" -#: ../src/Doc/library/codecs.rst:1013 +#: library/codecs.rst:1013 msgid "eucjisx0213" msgstr "" -#: ../src/Doc/library/codecs.rst:1015 +#: library/codecs.rst:1015 msgid "euc_kr" msgstr "" -#: ../src/Doc/library/codecs.rst:1015 +#: library/codecs.rst:1015 msgid "euckr, korean, ksc5601, ks_c-5601, ks_c-5601-1987, ksx1001, ks_x-1001" msgstr "" -#: ../src/Doc/library/codecs.rst:1019 +#: library/codecs.rst:1019 msgid "gb2312" msgstr "" -#: ../src/Doc/library/codecs.rst:1019 +#: library/codecs.rst:1019 msgid "" "chinese, csiso58gb231280, euc- cn, euccn, eucgb2312-cn, gb2312-1980, " "gb2312-80, iso- ir-58" msgstr "" -#: ../src/Doc/library/codecs.rst:1019 ../src/Doc/library/codecs.rst:1028 +#: library/codecs.rst:1019 library/codecs.rst:1028 msgid "Simplified Chinese" msgstr "" -#: ../src/Doc/library/codecs.rst:1024 +#: library/codecs.rst:1024 msgid "gbk" msgstr "" -#: ../src/Doc/library/codecs.rst:1024 +#: library/codecs.rst:1024 msgid "936, cp936, ms936" msgstr "" -#: ../src/Doc/library/codecs.rst:1024 ../src/Doc/library/codecs.rst:1026 +#: library/codecs.rst:1024 library/codecs.rst:1026 msgid "Unified Chinese" msgstr "" -#: ../src/Doc/library/codecs.rst:1026 +#: library/codecs.rst:1026 msgid "gb18030" msgstr "" -#: ../src/Doc/library/codecs.rst:1026 +#: library/codecs.rst:1026 msgid "gb18030-2000" msgstr "" -#: ../src/Doc/library/codecs.rst:1028 +#: library/codecs.rst:1028 msgid "hz" msgstr "" -#: ../src/Doc/library/codecs.rst:1028 +#: library/codecs.rst:1028 msgid "hzgb, hz-gb, hz-gb-2312" msgstr "" -#: ../src/Doc/library/codecs.rst:1030 +#: library/codecs.rst:1030 msgid "iso2022_jp" msgstr "" -#: ../src/Doc/library/codecs.rst:1030 +#: library/codecs.rst:1030 msgid "csiso2022jp, iso2022jp, iso-2022-jp" msgstr "" -#: ../src/Doc/library/codecs.rst:1033 +#: library/codecs.rst:1033 msgid "iso2022_jp_1" msgstr "" -#: ../src/Doc/library/codecs.rst:1033 +#: library/codecs.rst:1033 msgid "iso2022jp-1, iso-2022-jp-1" msgstr "" -#: ../src/Doc/library/codecs.rst:1035 +#: library/codecs.rst:1035 msgid "iso2022_jp_2" msgstr "" -#: ../src/Doc/library/codecs.rst:1035 +#: library/codecs.rst:1035 msgid "iso2022jp-2, iso-2022-jp-2" msgstr "" -#: ../src/Doc/library/codecs.rst:1035 +#: library/codecs.rst:1035 msgid "Japanese, Korean, Simplified Chinese, Western Europe, Greek" msgstr "" -#: ../src/Doc/library/codecs.rst:1038 +#: library/codecs.rst:1038 msgid "iso2022_jp_2004" msgstr "" -#: ../src/Doc/library/codecs.rst:1038 +#: library/codecs.rst:1038 msgid "iso2022jp-2004, iso-2022-jp-2004" msgstr "" -#: ../src/Doc/library/codecs.rst:1041 +#: library/codecs.rst:1041 msgid "iso2022_jp_3" msgstr "" -#: ../src/Doc/library/codecs.rst:1041 +#: library/codecs.rst:1041 msgid "iso2022jp-3, iso-2022-jp-3" msgstr "" -#: ../src/Doc/library/codecs.rst:1043 +#: library/codecs.rst:1043 msgid "iso2022_jp_ext" msgstr "" -#: ../src/Doc/library/codecs.rst:1043 +#: library/codecs.rst:1043 msgid "iso2022jp-ext, iso-2022-jp-ext" msgstr "" -#: ../src/Doc/library/codecs.rst:1045 +#: library/codecs.rst:1045 msgid "iso2022_kr" msgstr "" -#: ../src/Doc/library/codecs.rst:1045 +#: library/codecs.rst:1045 msgid "csiso2022kr, iso2022kr, iso-2022-kr" msgstr "" -#: ../src/Doc/library/codecs.rst:1048 +#: library/codecs.rst:1048 msgid "latin_1" msgstr "" -#: ../src/Doc/library/codecs.rst:1048 +#: library/codecs.rst:1048 msgid "iso-8859-1, iso8859-1, 8859, cp819, latin, latin1, L1" msgstr "" -#: ../src/Doc/library/codecs.rst:1048 +#: library/codecs.rst:1048 msgid "West Europe" msgstr "" -#: ../src/Doc/library/codecs.rst:1051 +#: library/codecs.rst:1051 msgid "iso8859_2" msgstr "" -#: ../src/Doc/library/codecs.rst:1051 +#: library/codecs.rst:1051 msgid "iso-8859-2, latin2, L2" msgstr "" -#: ../src/Doc/library/codecs.rst:1053 +#: library/codecs.rst:1053 msgid "iso8859_3" msgstr "" -#: ../src/Doc/library/codecs.rst:1053 +#: library/codecs.rst:1053 msgid "iso-8859-3, latin3, L3" msgstr "" -#: ../src/Doc/library/codecs.rst:1053 +#: library/codecs.rst:1053 msgid "Esperanto, Maltese" msgstr "" -#: ../src/Doc/library/codecs.rst:1055 +#: library/codecs.rst:1055 msgid "iso8859_4" msgstr "" -#: ../src/Doc/library/codecs.rst:1055 +#: library/codecs.rst:1055 msgid "iso-8859-4, latin4, L4" msgstr "" -#: ../src/Doc/library/codecs.rst:1057 +#: library/codecs.rst:1057 msgid "iso8859_5" msgstr "" -#: ../src/Doc/library/codecs.rst:1057 +#: library/codecs.rst:1057 msgid "iso-8859-5, cyrillic" msgstr "" -#: ../src/Doc/library/codecs.rst:1060 +#: library/codecs.rst:1060 msgid "iso8859_6" msgstr "" -#: ../src/Doc/library/codecs.rst:1060 +#: library/codecs.rst:1060 msgid "iso-8859-6, arabic" msgstr "" -#: ../src/Doc/library/codecs.rst:1062 +#: library/codecs.rst:1062 msgid "iso8859_7" msgstr "" -#: ../src/Doc/library/codecs.rst:1062 +#: library/codecs.rst:1062 msgid "iso-8859-7, greek, greek8" msgstr "" -#: ../src/Doc/library/codecs.rst:1064 +#: library/codecs.rst:1064 msgid "iso8859_8" msgstr "" -#: ../src/Doc/library/codecs.rst:1064 +#: library/codecs.rst:1064 msgid "iso-8859-8, hebrew" msgstr "" -#: ../src/Doc/library/codecs.rst:1066 +#: library/codecs.rst:1066 msgid "iso8859_9" msgstr "" -#: ../src/Doc/library/codecs.rst:1066 +#: library/codecs.rst:1066 msgid "iso-8859-9, latin5, L5" msgstr "" -#: ../src/Doc/library/codecs.rst:1068 +#: library/codecs.rst:1068 msgid "iso8859_10" msgstr "" -#: ../src/Doc/library/codecs.rst:1068 +#: library/codecs.rst:1068 msgid "iso-8859-10, latin6, L6" msgstr "" -#: ../src/Doc/library/codecs.rst:1068 +#: library/codecs.rst:1068 msgid "Nordic languages" msgstr "" -#: ../src/Doc/library/codecs.rst:1070 +#: library/codecs.rst:1070 +msgid "iso8859_11" +msgstr "" + +#: library/codecs.rst:1070 +msgid "iso-8859-11, thai" +msgstr "" + +#: library/codecs.rst:1070 +msgid "Thai languages" +msgstr "" + +#: library/codecs.rst:1072 msgid "iso8859_13" msgstr "" -#: ../src/Doc/library/codecs.rst:1070 +#: library/codecs.rst:1072 msgid "iso-8859-13, latin7, L7" msgstr "" -#: ../src/Doc/library/codecs.rst:1072 +#: library/codecs.rst:1074 msgid "iso8859_14" msgstr "" -#: ../src/Doc/library/codecs.rst:1072 +#: library/codecs.rst:1074 msgid "iso-8859-14, latin8, L8" msgstr "" -#: ../src/Doc/library/codecs.rst:1072 +#: library/codecs.rst:1074 msgid "Celtic languages" msgstr "" -#: ../src/Doc/library/codecs.rst:1074 +#: library/codecs.rst:1076 msgid "iso8859_15" msgstr "" -#: ../src/Doc/library/codecs.rst:1074 +#: library/codecs.rst:1076 msgid "iso-8859-15, latin9, L9" msgstr "" -#: ../src/Doc/library/codecs.rst:1076 +#: library/codecs.rst:1078 msgid "iso8859_16" msgstr "" -#: ../src/Doc/library/codecs.rst:1076 +#: library/codecs.rst:1078 msgid "iso-8859-16, latin10, L10" msgstr "" -#: ../src/Doc/library/codecs.rst:1076 +#: library/codecs.rst:1078 msgid "South-Eastern Europe" msgstr "" -#: ../src/Doc/library/codecs.rst:1078 +#: library/codecs.rst:1080 msgid "johab" msgstr "" -#: ../src/Doc/library/codecs.rst:1078 +#: library/codecs.rst:1080 msgid "cp1361, ms1361" msgstr "" -#: ../src/Doc/library/codecs.rst:1080 +#: library/codecs.rst:1082 msgid "koi8_r" msgstr "" -#: ../src/Doc/library/codecs.rst:1082 +#: library/codecs.rst:1084 msgid "koi8_u" msgstr "" -#: ../src/Doc/library/codecs.rst:1082 +#: library/codecs.rst:1084 msgid "Ukrainian" msgstr "" -#: ../src/Doc/library/codecs.rst:1084 +#: library/codecs.rst:1086 msgid "mac_cyrillic" msgstr "" -#: ../src/Doc/library/codecs.rst:1084 +#: library/codecs.rst:1086 msgid "maccyrillic" msgstr "" -#: ../src/Doc/library/codecs.rst:1087 +#: library/codecs.rst:1089 msgid "mac_greek" msgstr "" -#: ../src/Doc/library/codecs.rst:1087 +#: library/codecs.rst:1089 msgid "macgreek" msgstr "" -#: ../src/Doc/library/codecs.rst:1089 +#: library/codecs.rst:1091 msgid "mac_iceland" msgstr "" -#: ../src/Doc/library/codecs.rst:1089 +#: library/codecs.rst:1091 msgid "maciceland" msgstr "" -#: ../src/Doc/library/codecs.rst:1091 +#: library/codecs.rst:1093 msgid "mac_latin2" msgstr "" -#: ../src/Doc/library/codecs.rst:1091 +#: library/codecs.rst:1093 msgid "maclatin2, maccentraleurope" msgstr "" -#: ../src/Doc/library/codecs.rst:1093 +#: library/codecs.rst:1095 msgid "mac_roman" msgstr "" -#: ../src/Doc/library/codecs.rst:1093 +#: library/codecs.rst:1095 msgid "macroman" msgstr "" -#: ../src/Doc/library/codecs.rst:1095 +#: library/codecs.rst:1097 msgid "mac_turkish" msgstr "" -#: ../src/Doc/library/codecs.rst:1095 +#: library/codecs.rst:1097 msgid "macturkish" msgstr "" -#: ../src/Doc/library/codecs.rst:1097 +#: library/codecs.rst:1099 msgid "ptcp154" msgstr "" -#: ../src/Doc/library/codecs.rst:1097 +#: library/codecs.rst:1099 msgid "csptcp154, pt154, cp154, cyrillic-asian" msgstr "" -#: ../src/Doc/library/codecs.rst:1097 +#: library/codecs.rst:1099 msgid "Kazakh" msgstr "" -#: ../src/Doc/library/codecs.rst:1100 +#: library/codecs.rst:1102 msgid "shift_jis" msgstr "" -#: ../src/Doc/library/codecs.rst:1100 +#: library/codecs.rst:1102 msgid "csshiftjis, shiftjis, sjis, s_jis" msgstr "" -#: ../src/Doc/library/codecs.rst:1103 +#: library/codecs.rst:1105 msgid "shift_jis_2004" msgstr "" -#: ../src/Doc/library/codecs.rst:1103 +#: library/codecs.rst:1105 msgid "shiftjis2004, sjis_2004, sjis2004" msgstr "" -#: ../src/Doc/library/codecs.rst:1106 +#: library/codecs.rst:1108 msgid "shift_jisx0213" msgstr "" -#: ../src/Doc/library/codecs.rst:1106 +#: library/codecs.rst:1108 msgid "shiftjisx0213, sjisx0213, s_jisx0213" msgstr "" -#: ../src/Doc/library/codecs.rst:1109 +#: library/codecs.rst:1111 msgid "utf_32" msgstr "" -#: ../src/Doc/library/codecs.rst:1109 +#: library/codecs.rst:1111 msgid "U32, utf32" msgstr "" -#: ../src/Doc/library/codecs.rst:1109 ../src/Doc/library/codecs.rst:1111 -#: ../src/Doc/library/codecs.rst:1113 ../src/Doc/library/codecs.rst:1115 -#: ../src/Doc/library/codecs.rst:1121 ../src/Doc/library/codecs.rst:1123 -#: ../src/Doc/library/codecs.rst:1125 +#: library/codecs.rst:1111 library/codecs.rst:1113 library/codecs.rst:1115 +#: library/codecs.rst:1117 library/codecs.rst:1123 library/codecs.rst:1125 +#: library/codecs.rst:1127 msgid "all languages" msgstr "" -#: ../src/Doc/library/codecs.rst:1111 +#: library/codecs.rst:1113 msgid "utf_32_be" msgstr "" -#: ../src/Doc/library/codecs.rst:1111 +#: library/codecs.rst:1113 msgid "UTF-32BE" msgstr "" -#: ../src/Doc/library/codecs.rst:1113 +#: library/codecs.rst:1115 msgid "utf_32_le" msgstr "" -#: ../src/Doc/library/codecs.rst:1113 +#: library/codecs.rst:1115 msgid "UTF-32LE" msgstr "" -#: ../src/Doc/library/codecs.rst:1115 +#: library/codecs.rst:1117 msgid "utf_16" msgstr "" -#: ../src/Doc/library/codecs.rst:1115 +#: library/codecs.rst:1117 msgid "U16, utf16" msgstr "" -#: ../src/Doc/library/codecs.rst:1117 +#: library/codecs.rst:1119 msgid "utf_16_be" msgstr "" -#: ../src/Doc/library/codecs.rst:1117 +#: library/codecs.rst:1119 msgid "UTF-16BE" msgstr "" -#: ../src/Doc/library/codecs.rst:1117 ../src/Doc/library/codecs.rst:1119 +#: library/codecs.rst:1119 library/codecs.rst:1121 msgid "all languages (BMP only)" msgstr "" -#: ../src/Doc/library/codecs.rst:1119 +#: library/codecs.rst:1121 msgid "utf_16_le" msgstr "" -#: ../src/Doc/library/codecs.rst:1119 +#: library/codecs.rst:1121 msgid "UTF-16LE" msgstr "" -#: ../src/Doc/library/codecs.rst:1121 +#: library/codecs.rst:1123 msgid "utf_7" msgstr "" -#: ../src/Doc/library/codecs.rst:1121 +#: library/codecs.rst:1123 msgid "U7, unicode-1-1-utf-7" msgstr "" -#: ../src/Doc/library/codecs.rst:1123 +#: library/codecs.rst:1125 msgid "utf_8" msgstr "" -#: ../src/Doc/library/codecs.rst:1123 +#: library/codecs.rst:1125 msgid "U8, UTF, utf8" msgstr "" -#: ../src/Doc/library/codecs.rst:1125 +#: library/codecs.rst:1127 msgid "utf_8_sig" msgstr "" # 3bbb634594be4c578a098a44f8805f78 -#: ../src/Doc/library/codecs.rst:1129 +#: library/codecs.rst:1131 msgid "Python Specific Encodings" msgstr "" # 0e17837ab05e4f549694b11bc40fc383 -#: ../src/Doc/library/codecs.rst:1131 +#: library/codecs.rst:1133 msgid "" "A number of predefined codecs are specific to Python, so their codec names " "have no meaning outside Python. These are listed in the tables below based " @@ -13573,254 +13640,253 @@ msgid "" msgstr "" # 2855114db7c242df89dbbfb3adce094a -#: ../src/Doc/library/codecs.rst:1138 +#: library/codecs.rst:1140 msgid "" "The following codecs provide unicode-to-str encoding [#encoding-note]_ and " "str-to-unicode decoding [#decoding-note]_, similar to the Unicode text " "encodings." msgstr "" -#: ../src/Doc/library/codecs.rst:1145 ../src/Doc/library/codecs.rst:1194 -#: ../src/Doc/library/xml.dom.rst:175 +#: library/codecs.rst:1147 library/codecs.rst:1196 library/xml.dom.rst:175 msgid "Purpose" msgstr "" -#: ../src/Doc/library/codecs.rst:1147 +#: library/codecs.rst:1149 msgid "idna" msgstr "" -#: ../src/Doc/library/codecs.rst:1147 +#: library/codecs.rst:1149 msgid "Implements :rfc:`3490`, see also :mod:`encodings.idna`" msgstr "" -#: ../src/Doc/library/codecs.rst:1151 +#: library/codecs.rst:1153 msgid "mbcs" msgstr "" -#: ../src/Doc/library/codecs.rst:1151 +#: library/codecs.rst:1153 msgid "dbcs" msgstr "" -#: ../src/Doc/library/codecs.rst:1151 +#: library/codecs.rst:1153 msgid "Windows only: Encode operand according to the ANSI codepage (CP_ACP)" msgstr "" -#: ../src/Doc/library/codecs.rst:1155 +#: library/codecs.rst:1157 msgid "palmos" msgstr "" -#: ../src/Doc/library/codecs.rst:1155 +#: library/codecs.rst:1157 msgid "Encoding of PalmOS 3.5" msgstr "" -#: ../src/Doc/library/codecs.rst:1157 +#: library/codecs.rst:1159 msgid "punycode" msgstr "" -#: ../src/Doc/library/codecs.rst:1157 +#: library/codecs.rst:1159 msgid "Implements :rfc:`3492`" msgstr "" -#: ../src/Doc/library/codecs.rst:1159 +#: library/codecs.rst:1161 msgid "raw_unicode_escape" msgstr "" -#: ../src/Doc/library/codecs.rst:1159 +#: library/codecs.rst:1161 msgid "" "Produce a string that is suitable as raw Unicode literal in Python source " "code" msgstr "" # 4741ce7b279d4d83a05c1e2838c3b654 -#: ../src/Doc/library/codecs.rst:1164 +#: library/codecs.rst:1166 msgid "rot_13" msgstr "" # ce9cbf1c0b9f4d8589ccca1316dab2b6 -#: ../src/Doc/library/codecs.rst:1164 +#: library/codecs.rst:1166 msgid "rot13" msgstr "" # 5b1c019d036443d79ebcc78554015bb4 -#: ../src/Doc/library/codecs.rst:1164 +#: library/codecs.rst:1166 msgid "Returns the Caesar-cypher encryption of the operand" msgstr "" -#: ../src/Doc/library/codecs.rst:1167 +#: library/codecs.rst:1169 msgid "undefined" msgstr "" # d523694e02cc47a6bfec7f83c34522f3 -#: ../src/Doc/library/codecs.rst:1167 +#: library/codecs.rst:1169 msgid "" "Raise an exception for all conversions. Can be used as the system encoding " "if no automatic :term:`coercion` between byte and Unicode strings is desired." msgstr "" -#: ../src/Doc/library/codecs.rst:1175 +#: library/codecs.rst:1177 msgid "unicode_escape" msgstr "" -#: ../src/Doc/library/codecs.rst:1175 +#: library/codecs.rst:1177 msgid "" "Produce a string that is suitable as Unicode literal in Python source code" msgstr "" -#: ../src/Doc/library/codecs.rst:1180 +#: library/codecs.rst:1182 msgid "unicode_internal" msgstr "" -#: ../src/Doc/library/codecs.rst:1180 +#: library/codecs.rst:1182 msgid "Return the internal representation of the operand" msgstr "" +#: library/codecs.rst:1187 +msgid "The ``idna`` and ``punycode`` encodings." +msgstr "" + # 8f093e2c0c81450991e1f0429bd446c4 -#: ../src/Doc/library/codecs.rst:1188 +#: library/codecs.rst:1190 msgid "" "The following codecs provide str-to-str encoding and decoding [#decoding-" "note]_." msgstr "" # 5f837e2b7b2d4e29858c031e3abd717d -#: ../src/Doc/library/codecs.rst:1194 +#: library/codecs.rst:1196 msgid "Encoder/decoder" msgstr "" # 7f22617d04004b83bab687cefa579eb9 -#: ../src/Doc/library/codecs.rst:1196 +#: library/codecs.rst:1198 msgid "base64_codec" msgstr "" # f236a32df185456e9730aac546aa718a -#: ../src/Doc/library/codecs.rst:1196 +#: library/codecs.rst:1198 msgid "base64, base-64" msgstr "" -# 3688860d28c6456a817a1c21285fd5db -#: ../src/Doc/library/codecs.rst:1196 +#: library/codecs.rst:1198 msgid "" -"Convert operand to MIME base64 (the result always includes a trailing " -"``'\\n'``)" +"Convert operand to multiline MIME base64 (the result always includes a " +"trailing ``'\\n'``)" msgstr "" -# 6b58d8798b03463581d766972b087f70 -#: ../src/Doc/library/codecs.rst:1196 -msgid ":meth:`base64.b64encode`, :meth:`base64.b64decode`" +#: library/codecs.rst:1198 +msgid ":meth:`base64.encodestring`, :meth:`base64.decodestring`" msgstr "" # f9f516a74f1d43159129c5cdae4a82b8 -#: ../src/Doc/library/codecs.rst:1201 +#: library/codecs.rst:1203 msgid "bz2_codec" msgstr "" # 197ae3fdda3e4b8da1ec3f6bccb9a28a -#: ../src/Doc/library/codecs.rst:1201 +#: library/codecs.rst:1203 msgid "bz2" msgstr "" # c00140a6962246569c2cdb12b9bde1eb -#: ../src/Doc/library/codecs.rst:1201 +#: library/codecs.rst:1203 msgid "Compress the operand using bz2" msgstr "" # 7456a0969bc34da394cb9a01e0461b75 -#: ../src/Doc/library/codecs.rst:1201 +#: library/codecs.rst:1203 msgid ":meth:`bz2.compress`, :meth:`bz2.decompress`" msgstr "" # 62c606f6dc6840e5b323dbfe3ab301df -#: ../src/Doc/library/codecs.rst:1204 +#: library/codecs.rst:1206 msgid "hex_codec" msgstr "" # 9a83f35b354f49ec9af700ccc80f79a5 -#: ../src/Doc/library/codecs.rst:1204 +#: library/codecs.rst:1206 msgid "hex" msgstr "" # 7650aeb831794f2f8cda870b5c83d0fc -#: ../src/Doc/library/codecs.rst:1204 +#: library/codecs.rst:1206 msgid "Convert operand to hexadecimal representation, with two digits per byte" msgstr "" -# a60291c8b8dc43b2b4816d069535b57e -#: ../src/Doc/library/codecs.rst:1204 -msgid ":meth:`base64.b16encode`, :meth:`base64.b16decode`" +#: library/codecs.rst:1206 +msgid ":meth:`binascii.b2a_hex`, :meth:`binascii.a2b_hex`" msgstr "" # 9ef638f81dde4056b56c41175c558b28 -#: ../src/Doc/library/codecs.rst:1209 +#: library/codecs.rst:1211 msgid "quopri_codec" msgstr "" # 4ed957fdd0644f55b1590a8f92c9aa12 -#: ../src/Doc/library/codecs.rst:1209 +#: library/codecs.rst:1211 msgid "quopri, quoted-printable, quotedprintable" msgstr "" # 2c420051e71846378ca72848b4ca196f -#: ../src/Doc/library/codecs.rst:1209 +#: library/codecs.rst:1211 msgid "Convert operand to MIME quoted printable" msgstr "" -# 901a9a522b0d483394ca44bf65666852 -#: ../src/Doc/library/codecs.rst:1209 -msgid ":meth:`quopri.encodestring`, :meth:`quopri.decodestring`" +#: library/codecs.rst:1211 +msgid ":meth:`quopri.encode` with ``quotetabs=True``, :meth:`quopri.decode`" msgstr "" # c1e9dc8f17234f6882ab8693dc79c391 -#: ../src/Doc/library/codecs.rst:1212 +#: library/codecs.rst:1215 msgid "string_escape" msgstr "" # faa21d1d9069495b9a68988515fa5a41 -#: ../src/Doc/library/codecs.rst:1212 +#: library/codecs.rst:1215 msgid "" "Produce a string that is suitable as string literal in Python source code" msgstr "" # cbbcbdf08def4c9291815be4d25cb0ce -#: ../src/Doc/library/codecs.rst:1217 +#: library/codecs.rst:1220 msgid "uu_codec" msgstr "" # a6d25e23e0c24dc18d68f00230828998 -#: ../src/Doc/library/codecs.rst:1217 +#: library/codecs.rst:1220 msgid "uu" msgstr "" # 9197735ab432464b9fd6c20a025dc03f -#: ../src/Doc/library/codecs.rst:1217 +#: library/codecs.rst:1220 msgid "Convert the operand using uuencode" msgstr "" # 78bf895f217449ca9782d7d788e464cb -#: ../src/Doc/library/codecs.rst:1217 +#: library/codecs.rst:1220 msgid ":meth:`uu.encode`, :meth:`uu.decode`" msgstr "" # d004e9648be942bc8345aafcb4567d38 -#: ../src/Doc/library/codecs.rst:1220 +#: library/codecs.rst:1223 msgid "zlib_codec" msgstr "" # 234ba3f2a2c24e2d933f166687b8688c -#: ../src/Doc/library/codecs.rst:1220 +#: library/codecs.rst:1223 msgid "zip, zlib" msgstr "" # ca679236c3364023bec0ce98e33f2b55 -#: ../src/Doc/library/codecs.rst:1220 +#: library/codecs.rst:1223 msgid "Compress the operand using gzip" msgstr "" # 90c943693bea4f989bf47b2a2e64c766 -#: ../src/Doc/library/codecs.rst:1220 +#: library/codecs.rst:1223 msgid ":meth:`zlib.compress`, :meth:`zlib.decompress`" msgstr "" # 30fe8968b80149f88385034d4ce8f009 -#: ../src/Doc/library/codecs.rst:1224 +#: library/codecs.rst:1227 msgid "" "str objects are also accepted as input in place of unicode objects. They " "are implicitly converted to unicode by decoding them using the default " @@ -13829,7 +13895,7 @@ msgid "" msgstr "" # 3f4b35e9eae6465f9373d377df31898b -#: ../src/Doc/library/codecs.rst:1229 +#: library/codecs.rst:1232 msgid "" "unicode objects are also accepted as input in place of str objects. They " "are implicitly converted to str by encoding them using the default " @@ -13837,12 +13903,12 @@ msgid "" "raising :exc:`UnicodeEncodeError`." msgstr "" -#: ../src/Doc/library/codecs.rst:1236 +#: library/codecs.rst:1239 msgid "" ":mod:`encodings.idna` --- Internationalized Domain Names in Applications" msgstr "" -#: ../src/Doc/library/codecs.rst:1244 +#: library/codecs.rst:1247 msgid "" "This module implements :rfc:`3490` (Internationalized Domain Names in " "Applications) and :rfc:`3492` (Nameprep: A Stringprep Profile for " @@ -13850,7 +13916,7 @@ msgid "" "encoding and :mod:`stringprep`." msgstr "" -#: ../src/Doc/library/codecs.rst:1249 +#: library/codecs.rst:1252 msgid "" "These RFCs together define a protocol to support non-ASCII characters in " "domain names. A domain name containing non-ASCII characters (such as ``www." @@ -13865,7 +13931,7 @@ msgid "" msgstr "" # 5d9faa5f623f41c9840aaa7c6b164e8f -#: ../src/Doc/library/codecs.rst:1260 +#: library/codecs.rst:1263 msgid "" "Python supports this conversion in several ways: the ``idna`` codec " "performs conversion between Unicode and ACE, separating an input string into " @@ -13881,14 +13947,14 @@ msgid "" "IDNA hostname in the :mailheader:`Host` field if it sends that field at all)." msgstr "" -#: ../src/Doc/library/codecs.rst:1275 +#: library/codecs.rst:1278 msgid "" "When receiving host names from the wire (such as in reverse name lookup), no " "automatic conversion to Unicode is performed: Applications wishing to " "present such host names to the user should decode them to Unicode." msgstr "" -#: ../src/Doc/library/codecs.rst:1279 +#: library/codecs.rst:1282 msgid "" "The module :mod:`encodings.idna` also implements the nameprep procedure, " "which performs certain normalizations on host names, to achieve case-" @@ -13896,27 +13962,27 @@ msgid "" "characters. The nameprep functions can be used directly if desired." msgstr "" -#: ../src/Doc/library/codecs.rst:1287 +#: library/codecs.rst:1290 msgid "" "Return the nameprepped version of *label*. The implementation currently " "assumes query strings, so ``AllowUnassigned`` is true." msgstr "" -#: ../src/Doc/library/codecs.rst:1293 +#: library/codecs.rst:1296 msgid "" "Convert a label to ASCII, as specified in :rfc:`3490`. ``UseSTD3ASCIIRules`` " "is assumed to be false." msgstr "" -#: ../src/Doc/library/codecs.rst:1299 +#: library/codecs.rst:1302 msgid "Convert a label to Unicode, as specified in :rfc:`3490`." msgstr "" -#: ../src/Doc/library/codecs.rst:1303 +#: library/codecs.rst:1306 msgid ":mod:`encodings.utf_8_sig` --- UTF-8 codec with BOM signature" msgstr "" -#: ../src/Doc/library/codecs.rst:1311 +#: library/codecs.rst:1314 msgid "" "This module implements a variant of the UTF-8 codec: On encoding a UTF-8 " "encoded BOM will be prepended to the UTF-8 encoded bytes. For the stateful " @@ -13925,11 +13991,11 @@ msgid "" "skipped." msgstr "" -#: ../src/Doc/library/codeop.rst:3 +#: library/codeop.rst:3 msgid ":mod:`codeop` --- Compile Python code" msgstr "" -#: ../src/Doc/library/codeop.rst:10 +#: library/codeop.rst:10 msgid "" "The :mod:`codeop` module provides utilities upon which the Python read-eval-" "print loop can be emulated, as is done in the :mod:`code` module. As a " @@ -13938,33 +14004,33 @@ msgid "" "module instead." msgstr "" -#: ../src/Doc/library/codeop.rst:16 +#: library/codeop.rst:16 msgid "There are two parts to this job:" msgstr "" -#: ../src/Doc/library/codeop.rst:18 +#: library/codeop.rst:18 msgid "" "Being able to tell if a line of input completes a Python statement: in " "short, telling whether to print '``>>>``' or '``...``' next." msgstr "" -#: ../src/Doc/library/codeop.rst:21 +#: library/codeop.rst:21 msgid "" "Remembering which future statements the user has entered, so subsequent " "input can be compiled with these in effect." msgstr "" -#: ../src/Doc/library/codeop.rst:24 +#: library/codeop.rst:24 msgid "" "The :mod:`codeop` module provides a way of doing each of these things, and a " "way of doing them both." msgstr "" -#: ../src/Doc/library/codeop.rst:27 +#: library/codeop.rst:27 msgid "To do just the former:" msgstr "" -#: ../src/Doc/library/codeop.rst:31 +#: library/codeop.rst:31 msgid "" "Tries to compile *source*, which should be a string of Python code and " "return a code object if *source* is valid Python code. In that case, the " @@ -13973,21 +14039,21 @@ msgid "" "is a prefix of valid Python code." msgstr "" -#: ../src/Doc/library/codeop.rst:37 +#: library/codeop.rst:37 msgid "" "If there is a problem with *source*, an exception will be raised. :exc:" "`SyntaxError` is raised if there is invalid Python syntax, and :exc:" "`OverflowError` or :exc:`ValueError` if there is an invalid literal." msgstr "" -#: ../src/Doc/library/codeop.rst:41 +#: library/codeop.rst:41 msgid "" "The *symbol* argument determines whether *source* is compiled as a statement " "(``'single'``, the default) or as an :term:`expression` (``'eval'``). Any " "other value will cause :exc:`ValueError` to be raised." msgstr "" -#: ../src/Doc/library/codeop.rst:47 +#: library/codeop.rst:47 msgid "" "It is possible (but not likely) that the parser stops parsing with a " "successful outcome before reaching the end of the source; in this case, " @@ -13996,7 +14062,7 @@ msgid "" "This will be fixed once the API for the parser is better." msgstr "" -#: ../src/Doc/library/codeop.rst:56 +#: library/codeop.rst:56 msgid "" "Instances of this class have :meth:`__call__` methods identical in signature " "to the built-in function :func:`compile`, but with the difference that if " @@ -14005,7 +14071,7 @@ msgid "" "statement in force." msgstr "" -#: ../src/Doc/library/codeop.rst:65 +#: library/codeop.rst:65 msgid "" "Instances of this class have :meth:`__call__` methods identical in signature " "to :func:`compile_command`; the difference is that if the instance compiles " @@ -14014,7 +14080,7 @@ msgid "" msgstr "" # e937b50ab1ba4c558693c39d3f60e961 -#: ../src/Doc/library/codeop.rst:70 +#: library/codeop.rst:70 msgid "" "A note on version compatibility: the :class:`Compile` and :class:" "`CommandCompiler` are new in Python 2.2. If you want to enable the future-" @@ -14023,32 +14089,32 @@ msgid "" msgstr "" # a07895e6591a49a1ae4e130e3013c59d -#: ../src/Doc/library/codeop.rst:82 +#: library/codeop.rst:82 msgid "" "which is a low-impact change, but introduces possibly unwanted global state " "into your program, or you can write::" msgstr "" # 067de7e5918a4ed88713e7d26a6f63cb -#: ../src/Doc/library/codeop.rst:92 +#: library/codeop.rst:92 msgid "" "and then call ``CommandCompiler`` every time you need a fresh compiler " "object." msgstr "" # 09e7653c7fcc40bdb183affbefa8c90d -#: ../src/Doc/library/collections.rst:2 +#: library/collections.rst:2 msgid ":mod:`collections` --- High-performance container datatypes" msgstr "" # a4a0ab33682b496a80fd6ce4f53279a5 -#: ../src/Doc/library/collections.rst:17 +#: library/collections.rst:17 msgid "" "**Source code:** :source:`Lib/collections.py` and :source:`Lib/_abcoll.py`" msgstr "" # 6923884bdea7413d9485cbec5cbfe32c -#: ../src/Doc/library/collections.rst:21 +#: library/collections.rst:21 msgid "" "This module implements specialized container datatypes providing " "alternatives to Python's general purpose built-in containers, :class:" @@ -14056,57 +14122,57 @@ msgid "" msgstr "" # 130be9a4cceb4718bed7911545cf41b6 -#: ../src/Doc/library/collections.rst:26 +#: library/collections.rst:26 msgid ":func:`namedtuple`" msgstr "" # 019f33e54289480fa15354cd954e8c70 -#: ../src/Doc/library/collections.rst:26 +#: library/collections.rst:26 msgid "factory function for creating tuple subclasses with named fields" msgstr "" # 97a246c26036438fb7616e6fe099fc4b -#: ../src/Doc/library/collections.rst:27 +#: library/collections.rst:27 msgid ":class:`deque`" msgstr "" # 70033d0321cd4cfabeb4370eb5263325 -#: ../src/Doc/library/collections.rst:27 +#: library/collections.rst:27 msgid "list-like container with fast appends and pops on either end" msgstr "" # 1fc2c44d94444b5287ebf30d8f63a385 -#: ../src/Doc/library/collections.rst:28 +#: library/collections.rst:28 msgid ":class:`Counter`" msgstr "" # 4cad4d565cdf497eb47eefd2efc04f0f -#: ../src/Doc/library/collections.rst:28 +#: library/collections.rst:28 msgid "dict subclass for counting hashable objects" msgstr "" # e01f840bc8884f2199ded6e2996f5c7f -#: ../src/Doc/library/collections.rst:29 +#: library/collections.rst:29 msgid ":class:`OrderedDict`" msgstr "" # da7ab05861404e28835c686b2b41ae9f -#: ../src/Doc/library/collections.rst:29 +#: library/collections.rst:29 msgid "dict subclass that remembers the order entries were added" msgstr "" # b92b1a92b46a4c838e54e806a61c5d8c -#: ../src/Doc/library/collections.rst:30 +#: library/collections.rst:30 msgid ":class:`defaultdict`" msgstr "" # 7670a8646de34f04a10fe211c8897f45 -#: ../src/Doc/library/collections.rst:30 +#: library/collections.rst:30 msgid "dict subclass that calls a factory function to supply missing values" msgstr "" # f11ad9a055bc4b228b8fe3ca8bdc928c -#: ../src/Doc/library/collections.rst:33 +#: library/collections.rst:33 msgid "" "In addition to the concrete container classes, the collections module " "provides :ref:`abstract base classes ` " @@ -14114,17 +14180,17 @@ msgid "" "for example, whether it is hashable or a mapping." msgstr "" -#: ../src/Doc/library/collections.rst:40 +#: library/collections.rst:40 msgid ":class:`Counter` objects" msgstr "" -#: ../src/Doc/library/collections.rst:42 +#: library/collections.rst:42 msgid "" "A counter tool is provided to support convenient and rapid tallies. For " "example::" msgstr "" -#: ../src/Doc/library/collections.rst:61 +#: library/collections.rst:61 msgid "" "A :class:`Counter` is a :class:`dict` subclass for counting hashable " "objects. It is an unordered collection where elements are stored as " @@ -14133,63 +14199,63 @@ msgid "" "class:`Counter` class is similar to bags or multisets in other languages." msgstr "" -#: ../src/Doc/library/collections.rst:67 +#: library/collections.rst:67 msgid "" "Elements are counted from an *iterable* or initialized from another " "*mapping* (or counter):" msgstr "" -#: ../src/Doc/library/collections.rst:75 +#: library/collections.rst:75 msgid "" "Counter objects have a dictionary interface except that they return a zero " "count for missing items instead of raising a :exc:`KeyError`:" msgstr "" -#: ../src/Doc/library/collections.rst:82 +#: library/collections.rst:82 msgid "" "Setting a count to zero does not remove an element from a counter. Use " "``del`` to remove it entirely:" msgstr "" -#: ../src/Doc/library/collections.rst:91 +#: library/collections.rst:91 msgid "" "Counter objects support three methods beyond those available for all " "dictionaries:" msgstr "" -#: ../src/Doc/library/collections.rst:96 +#: library/collections.rst:96 msgid "" "Return an iterator over elements repeating each as many times as its count. " "Elements are returned in arbitrary order. If an element's count is less " "than one, :meth:`elements` will ignore it." msgstr "" -#: ../src/Doc/library/collections.rst:106 +#: library/collections.rst:106 msgid "" "Return a list of the *n* most common elements and their counts from the most " -"common to the least. If *n* is not specified, :func:`most_common` returns " -"*all* elements in the counter. Elements with equal counts are ordered " -"arbitrarily:" +"common to the least. If *n* is omitted or ``None``, :func:`most_common` " +"returns *all* elements in the counter. Elements with equal counts are " +"ordered arbitrarily:" msgstr "" -#: ../src/Doc/library/collections.rst:116 +#: library/collections.rst:116 msgid "" "Elements are subtracted from an *iterable* or from another *mapping* (or " "counter). Like :meth:`dict.update` but subtracts counts instead of " "replacing them. Both inputs and outputs may be zero or negative." msgstr "" -#: ../src/Doc/library/collections.rst:126 +#: library/collections.rst:126 msgid "" "The usual dictionary methods are available for :class:`Counter` objects " "except for two which work differently for counters." msgstr "" -#: ../src/Doc/library/collections.rst:131 +#: library/collections.rst:131 msgid "This class method is not implemented for :class:`Counter` objects." msgstr "" -#: ../src/Doc/library/collections.rst:135 +#: library/collections.rst:135 msgid "" "Elements are counted from an *iterable* or added-in from another *mapping* " "(or counter). Like :meth:`dict.update` but adds counts instead of replacing " @@ -14197,11 +14263,11 @@ msgid "" "sequence of ``(key, value)`` pairs." msgstr "" -#: ../src/Doc/library/collections.rst:140 +#: library/collections.rst:140 msgid "Common patterns for working with :class:`Counter` objects::" msgstr "" -#: ../src/Doc/library/collections.rst:152 +#: library/collections.rst:152 msgid "" "Several mathematical operations are provided for combining :class:`Counter` " "objects to produce multisets (counters that have counts greater than zero). " @@ -14212,7 +14278,7 @@ msgid "" "less." msgstr "" -#: ../src/Doc/library/collections.rst:172 +#: library/collections.rst:172 msgid "" "Counters were primarily designed to work with positive integers to represent " "running counts; however, care was taken to not unnecessarily preclude use " @@ -14220,19 +14286,19 @@ msgid "" "this section documents the minimum range and type restrictions." msgstr "" -#: ../src/Doc/library/collections.rst:177 +#: library/collections.rst:177 msgid "" "The :class:`Counter` class itself is a dictionary subclass with no " "restrictions on its keys and values. The values are intended to be numbers " "representing counts, but you *could* store anything in the value field." msgstr "" -#: ../src/Doc/library/collections.rst:181 +#: library/collections.rst:181 msgid "" "The :meth:`most_common` method requires only that the values be orderable." msgstr "" -#: ../src/Doc/library/collections.rst:183 +#: library/collections.rst:183 msgid "" "For in-place operations such as ``c[key] += 1``, the value type need only " "support addition and subtraction. So fractions, floats, and decimals would " @@ -14242,7 +14308,7 @@ msgid "" msgstr "" # 52a2f69dca8e4a53bffbef346d17d6d9 -#: ../src/Doc/library/collections.rst:189 +#: library/collections.rst:189 msgid "" "The multiset methods are designed only for use cases with positive values. " "The inputs may be negative or zero, but only outputs with positive values " @@ -14250,68 +14316,68 @@ msgid "" "support addition, subtraction, and comparison." msgstr "" -#: ../src/Doc/library/collections.rst:194 +#: library/collections.rst:194 msgid "" "The :meth:`elements` method requires integer counts. It ignores zero and " "negative counts." msgstr "" -#: ../src/Doc/library/collections.rst:199 +#: library/collections.rst:199 msgid "" "`Counter class `_ adapted for " "Python 2.5 and an early `Bag recipe `_ for Python 2.4." msgstr "" -#: ../src/Doc/library/collections.rst:203 +#: library/collections.rst:203 msgid "" "`Bag class `_ in Smalltalk." msgstr "" # 1a17202a79b74a3587c6f516043288e4 -#: ../src/Doc/library/collections.rst:206 +#: library/collections.rst:206 msgid "" "Wikipedia entry for `Multisets `_." msgstr "" -#: ../src/Doc/library/collections.rst:208 +#: library/collections.rst:208 msgid "" "`C++ multisets `_ tutorial with examples." msgstr "" # 3cc00f512cc64f8d8e70dd06ea76ef96 -#: ../src/Doc/library/collections.rst:211 +#: library/collections.rst:211 msgid "" "For mathematical operations on multisets and their use cases, see *Knuth, " "Donald. The Art of Computer Programming Volume II, Section 4.6.3, Exercise " "19*." msgstr "" -#: ../src/Doc/library/collections.rst:215 +#: library/collections.rst:215 msgid "" "To enumerate all distinct multisets of a given size over a given set of " "elements, see :func:`itertools.combinations_with_replacement`." msgstr "" -#: ../src/Doc/library/collections.rst:218 +#: library/collections.rst:218 msgid "" "map(Counter, combinations_with_replacement('ABC', 2)) --> AA AB AC BB BC CC" msgstr "" -#: ../src/Doc/library/collections.rst:222 +#: library/collections.rst:222 msgid ":class:`deque` objects" msgstr "" -#: ../src/Doc/library/collections.rst:226 +#: library/collections.rst:226 msgid "" "Returns a new deque object initialized left-to-right (using :meth:`append`) " "with data from *iterable*. If *iterable* is not specified, the new deque is " "empty." msgstr "" -#: ../src/Doc/library/collections.rst:229 +#: library/collections.rst:229 msgid "" "Deques are a generalization of stacks and queues (the name is pronounced " "\"deck\" and is short for \"double-ended queue\"). Deques support thread-" @@ -14319,7 +14385,7 @@ msgid "" "approximately the same O(1) performance in either direction." msgstr "" -#: ../src/Doc/library/collections.rst:234 +#: library/collections.rst:234 msgid "" "Though :class:`list` objects support similar operations, they are optimized " "for fast fixed-length operations and incur O(n) memory movement costs for " @@ -14327,7 +14393,7 @@ msgid "" "position of the underlying data representation." msgstr "" -#: ../src/Doc/library/collections.rst:241 +#: library/collections.rst:241 msgid "" "If *maxlen* is not specified or is *None*, deques may grow to an arbitrary " "length. Otherwise, the deque is bounded to the specified maximum length. " @@ -14338,77 +14404,81 @@ msgid "" "only the most recent activity is of interest." msgstr "" -#: ../src/Doc/library/collections.rst:252 +#: library/collections.rst:249 +msgid "Added *maxlen* parameter." +msgstr "" + +#: library/collections.rst:252 msgid "Deque objects support the following methods:" msgstr "" -#: ../src/Doc/library/collections.rst:257 +#: library/collections.rst:257 msgid "Add *x* to the right side of the deque." msgstr "" -#: ../src/Doc/library/collections.rst:262 +#: library/collections.rst:262 msgid "Add *x* to the left side of the deque." msgstr "" -#: ../src/Doc/library/collections.rst:267 +#: library/collections.rst:267 msgid "Remove all elements from the deque leaving it with length 0." msgstr "" -#: ../src/Doc/library/collections.rst:272 +#: library/collections.rst:272 msgid "Count the number of deque elements equal to *x*." msgstr "" -#: ../src/Doc/library/collections.rst:278 +#: library/collections.rst:278 msgid "" "Extend the right side of the deque by appending elements from the iterable " "argument." msgstr "" -#: ../src/Doc/library/collections.rst:284 +#: library/collections.rst:284 msgid "" "Extend the left side of the deque by appending elements from *iterable*. " "Note, the series of left appends results in reversing the order of elements " "in the iterable argument." msgstr "" -#: ../src/Doc/library/collections.rst:291 +#: library/collections.rst:291 msgid "" "Remove and return an element from the right side of the deque. If no " "elements are present, raises an :exc:`IndexError`." msgstr "" -#: ../src/Doc/library/collections.rst:297 +#: library/collections.rst:297 msgid "" "Remove and return an element from the left side of the deque. If no elements " "are present, raises an :exc:`IndexError`." msgstr "" -#: ../src/Doc/library/collections.rst:303 +#: library/collections.rst:303 msgid "" "Removed the first occurrence of *value*. If not found, raises a :exc:" "`ValueError`." msgstr "" -#: ../src/Doc/library/collections.rst:310 +#: library/collections.rst:310 msgid "Reverse the elements of the deque in-place and then return ``None``." msgstr "" -#: ../src/Doc/library/collections.rst:316 +#: library/collections.rst:316 msgid "" "Rotate the deque *n* steps to the right. If *n* is negative, rotate to the " "left. Rotating one step to the right is equivalent to: ``d.appendleft(d." "pop())``." msgstr "" -#: ../src/Doc/library/collections.rst:321 +#: library/collections.rst:321 msgid "Deque objects also provide one read-only attribute:" msgstr "" -#: ../src/Doc/library/collections.rst:325 +#: library/collections.rst:325 msgid "Maximum size of a deque or *None* if unbounded." msgstr "" -#: ../src/Doc/library/collections.rst:330 +#: library/collections.rst:330 msgid "" "In addition to the above, deques support iteration, pickling, ``len(d)``, " "``reversed(d)``, ``copy.copy(d)``, ``copy.deepcopy(d)``, membership testing " @@ -14417,43 +14487,41 @@ msgid "" "middle. For fast random access, use lists instead." msgstr "" -#: ../src/Doc/library/collections.rst:336 -#: ../src/Doc/library/collections.rst:598 ../src/Doc/library/datetime.rst:1323 -#: ../src/Doc/library/difflib.rst:258 ../src/Doc/library/fnmatch.rst:82 -#: ../src/Doc/library/sqlite3.rst:313 ../src/Doc/library/sqlite3.rst:329 -#: ../src/Doc/library/sqlite3.rst:425 ../src/Doc/library/sqlite3.rst:531 -#: ../src/Doc/library/turtle.rst:1949 +#: library/collections.rst:336 library/collections.rst:598 +#: library/datetime.rst:1323 library/difflib.rst:258 library/fnmatch.rst:82 +#: library/sqlite3.rst:313 library/sqlite3.rst:329 library/sqlite3.rst:425 +#: library/sqlite3.rst:531 library/turtle.rst:1949 msgid "Example:" msgstr "" -#: ../src/Doc/library/collections.rst:393 +#: library/collections.rst:393 msgid ":class:`deque` Recipes" msgstr "" -#: ../src/Doc/library/collections.rst:395 +#: library/collections.rst:395 msgid "This section shows various approaches to working with deques." msgstr "" -#: ../src/Doc/library/collections.rst:397 +#: library/collections.rst:397 msgid "" "Bounded length deques provide functionality similar to the ``tail`` filter " "in Unix::" msgstr "" -#: ../src/Doc/library/collections.rst:404 +#: library/collections.rst:404 msgid "" "Another approach to using deques is to maintain a sequence of recently added " "elements by appending to the right and popping to the left::" msgstr "" -#: ../src/Doc/library/collections.rst:419 +#: library/collections.rst:419 msgid "" "The :meth:`rotate` method provides a way to implement :class:`deque` slicing " "and deletion. For example, a pure Python implementation of ``del d[n]`` " "relies on the :meth:`rotate` method to position elements to be popped::" msgstr "" -#: ../src/Doc/library/collections.rst:428 +#: library/collections.rst:428 msgid "" "To implement :class:`deque` slicing, use a similar approach applying :meth:" "`rotate` to bring a target element to the left side of the deque. Remove old " @@ -14463,11 +14531,11 @@ msgid "" "``swap``, ``over``, ``pick``, ``rot``, and ``roll``." msgstr "" -#: ../src/Doc/library/collections.rst:438 +#: library/collections.rst:438 msgid ":class:`defaultdict` objects" msgstr "" -#: ../src/Doc/library/collections.rst:442 +#: library/collections.rst:442 msgid "" "Returns a new dictionary-like object. :class:`defaultdict` is a subclass of " "the built-in :class:`dict` class. It overrides one method and adds one " @@ -14475,7 +14543,7 @@ msgid "" "the :class:`dict` class and is not documented here." msgstr "" -#: ../src/Doc/library/collections.rst:447 +#: library/collections.rst:447 msgid "" "The first argument provides the initial value for the :attr:" "`default_factory` attribute; it defaults to ``None``. All remaining " @@ -14483,32 +14551,32 @@ msgid "" "constructor, including keyword arguments." msgstr "" -#: ../src/Doc/library/collections.rst:454 +#: library/collections.rst:454 msgid "" ":class:`defaultdict` objects support the following method in addition to the " "standard :class:`dict` operations:" msgstr "" -#: ../src/Doc/library/collections.rst:459 +#: library/collections.rst:459 msgid "" "If the :attr:`default_factory` attribute is ``None``, this raises a :exc:" "`KeyError` exception with the *key* as argument." msgstr "" -#: ../src/Doc/library/collections.rst:462 +#: library/collections.rst:462 msgid "" "If :attr:`default_factory` is not ``None``, it is called without arguments " "to provide a default value for the given *key*, this value is inserted in " "the dictionary for the *key*, and returned." msgstr "" -#: ../src/Doc/library/collections.rst:466 +#: library/collections.rst:466 msgid "" "If calling :attr:`default_factory` raises an exception this exception is " "propagated unchanged." msgstr "" -#: ../src/Doc/library/collections.rst:469 +#: library/collections.rst:469 msgid "" "This method is called by the :meth:`__getitem__` method of the :class:`dict` " "class when the requested key is not found; whatever it returns or raises is " @@ -14516,7 +14584,7 @@ msgid "" msgstr "" # e1328c5225da427696ddb61fce96c527 -#: ../src/Doc/library/collections.rst:473 +#: library/collections.rst:473 msgid "" "Note that :meth:`__missing__` is *not* called for any operations besides :" "meth:`__getitem__`. This means that :meth:`get` will, like normal " @@ -14524,28 +14592,28 @@ msgid "" "`default_factory`." msgstr "" -#: ../src/Doc/library/collections.rst:479 +#: library/collections.rst:479 msgid ":class:`defaultdict` objects support the following instance variable:" msgstr "" -#: ../src/Doc/library/collections.rst:484 +#: library/collections.rst:484 msgid "" "This attribute is used by the :meth:`__missing__` method; it is initialized " "from the first argument to the constructor, if present, or to ``None``, if " "absent." msgstr "" -#: ../src/Doc/library/collections.rst:490 +#: library/collections.rst:490 msgid ":class:`defaultdict` Examples" msgstr "" -#: ../src/Doc/library/collections.rst:492 +#: library/collections.rst:492 msgid "" "Using :class:`list` as the :attr:`default_factory`, it is easy to group a " "sequence of key-value pairs into a dictionary of lists:" msgstr "" -#: ../src/Doc/library/collections.rst:503 +#: library/collections.rst:503 msgid "" "When each key is encountered for the first time, it is not already in the " "mapping; so an entry is automatically created using the :attr:" @@ -14557,14 +14625,14 @@ msgid "" "using :meth:`dict.setdefault`:" msgstr "" -#: ../src/Doc/library/collections.rst:518 +#: library/collections.rst:518 msgid "" "Setting the :attr:`default_factory` to :class:`int` makes the :class:" "`defaultdict` useful for counting (like a bag or multiset in other " "languages):" msgstr "" -#: ../src/Doc/library/collections.rst:530 +#: library/collections.rst:530 msgid "" "When a letter is first encountered, it is missing from the mapping, so the :" "attr:`default_factory` function calls :func:`int` to supply a default count " @@ -14572,7 +14640,7 @@ msgid "" msgstr "" # a90ef1ff029b49e2a2fd7be61702ab3e -#: ../src/Doc/library/collections.rst:534 +#: library/collections.rst:534 msgid "" "The function :func:`int` which always returns zero is just a special case of " "constant functions. A faster and more flexible way to create constant " @@ -14580,17 +14648,17 @@ msgid "" "value (not just zero):" msgstr "" -#: ../src/Doc/library/collections.rst:546 +#: library/collections.rst:546 msgid "" "Setting the :attr:`default_factory` to :class:`set` makes the :class:" "`defaultdict` useful for building a dictionary of sets:" msgstr "" -#: ../src/Doc/library/collections.rst:559 +#: library/collections.rst:559 msgid ":func:`namedtuple` Factory Function for Tuples with Named Fields" msgstr "" -#: ../src/Doc/library/collections.rst:561 +#: library/collections.rst:561 msgid "" "Named tuples assign meaning to each position in a tuple and allow for more " "readable, self-documenting code. They can be used wherever regular tuples " @@ -14598,7 +14666,7 @@ msgid "" "position index." msgstr "" -#: ../src/Doc/library/collections.rst:567 +#: library/collections.rst:567 msgid "" "Returns a new tuple subclass named *typename*. The new subclass is used to " "create tuple-like objects that have fields accessible by attribute lookup as " @@ -14608,7 +14676,7 @@ msgid "" msgstr "" # c942e4a4b57f4c37a1d5e54b17b8d59a -#: ../src/Doc/library/collections.rst:573 +#: library/collections.rst:573 msgid "" "The *field_names* are a sequence of strings such as ``['x', 'y']``. " "Alternatively, *field_names* can be a single string with each fieldname " @@ -14616,7 +14684,7 @@ msgid "" msgstr "" # 2fe70666ea484e0d9002579d7a78c2ae -#: ../src/Doc/library/collections.rst:577 +#: library/collections.rst:577 msgid "" "Any valid Python identifier may be used for a fieldname except for names " "starting with an underscore. Valid identifiers consist of letters, digits, " @@ -14625,7 +14693,7 @@ msgid "" "or *raise*." msgstr "" -#: ../src/Doc/library/collections.rst:583 +#: library/collections.rst:583 msgid "" "If *rename* is true, invalid fieldnames are automatically replaced with " "positional names. For example, ``['abc', 'def', 'ghi', 'abc']`` is " @@ -14633,117 +14701,125 @@ msgid "" "and the duplicate fieldname ``abc``." msgstr "" -#: ../src/Doc/library/collections.rst:588 +#: library/collections.rst:588 msgid "" "If *verbose* is true, the class definition is printed just before being " "built." msgstr "" -#: ../src/Doc/library/collections.rst:590 +#: library/collections.rst:590 msgid "" "Named tuple instances do not have per-instance dictionaries, so they are " "lightweight and require no more memory than regular tuples." msgstr "" -#: ../src/Doc/library/collections.rst:664 +#: library/collections.rst:595 +msgid "added support for *rename*." +msgstr "" + +#: library/collections.rst:664 msgid "" "Named tuples are especially useful for assigning field names to result " "tuples returned by the :mod:`csv` or :mod:`sqlite3` modules::" msgstr "" -#: ../src/Doc/library/collections.rst:680 +#: library/collections.rst:680 msgid "" "In addition to the methods inherited from tuples, named tuples support three " "additional methods and one attribute. To prevent conflicts with field " "names, the method and attribute names start with an underscore." msgstr "" -#: ../src/Doc/library/collections.rst:686 +#: library/collections.rst:686 msgid "" "Class method that makes a new instance from an existing sequence or iterable." msgstr "" -#: ../src/Doc/library/collections.rst:696 +#: library/collections.rst:696 msgid "" "Return a new :class:`OrderedDict` which maps field names to their " "corresponding values::" msgstr "" +#: library/collections.rst:703 +msgid "Returns an :class:`OrderedDict` instead of a regular :class:`dict`." +msgstr "" + # 4d79d07b74b4479c971d9fae6fcd44e6 -#: ../src/Doc/library/collections.rst:707 +#: library/collections.rst:708 msgid "" "Return a new instance of the named tuple replacing specified fields with new " "values::" msgstr "" -#: ../src/Doc/library/collections.rst:719 +#: library/collections.rst:720 msgid "" "Tuple of strings listing the field names. Useful for introspection and for " "creating new named tuple types from existing named tuples." msgstr "" -#: ../src/Doc/library/collections.rst:732 +#: library/collections.rst:733 msgid "" "To retrieve a field whose name is stored in a string, use the :func:" "`getattr` function:" msgstr "" -#: ../src/Doc/library/collections.rst:738 +#: library/collections.rst:739 msgid "" "To convert a dictionary to a named tuple, use the double-star-operator (as " "described in :ref:`tut-unpacking-arguments`):" msgstr "" -#: ../src/Doc/library/collections.rst:745 +#: library/collections.rst:746 msgid "" "Since a named tuple is a regular Python class, it is easy to add or change " "functionality with a subclass. Here is how to add a calculated field and a " "fixed-width print format:" msgstr "" -#: ../src/Doc/library/collections.rst:762 +#: library/collections.rst:763 msgid "" "The subclass shown above sets ``__slots__`` to an empty tuple. This helps " "keep memory requirements low by preventing the creation of instance " "dictionaries." msgstr "" -#: ../src/Doc/library/collections.rst:765 +#: library/collections.rst:766 msgid "" "Subclassing is not useful for adding new, stored fields. Instead, simply " "create a new named tuple type from the :attr:`_fields` attribute:" msgstr "" -#: ../src/Doc/library/collections.rst:770 +#: library/collections.rst:771 msgid "" "Default values can be implemented by using :meth:`_replace` to customize a " "prototype instance:" msgstr "" -#: ../src/Doc/library/collections.rst:777 +#: library/collections.rst:778 msgid "" "Enumerated constants can be implemented with named tuples, but it is simpler " "and more efficient to use a simple class declaration:" msgstr "" -#: ../src/Doc/library/collections.rst:788 +#: library/collections.rst:789 msgid "" "`Named tuple recipe `_ adapted " "for Python 2.4." msgstr "" -#: ../src/Doc/library/collections.rst:793 +#: library/collections.rst:794 msgid ":class:`OrderedDict` objects" msgstr "" -#: ../src/Doc/library/collections.rst:795 +#: library/collections.rst:796 msgid "" "Ordered dictionaries are just like regular dictionaries but they remember " "the order that items were inserted. When iterating over an ordered " "dictionary, the items are returned in the order their keys were first added." msgstr "" -#: ../src/Doc/library/collections.rst:801 +#: library/collections.rst:802 msgid "" "Return an instance of a dict subclass, supporting the usual :class:`dict` " "methods. An *OrderedDict* is a dict that remembers the order that keys were " @@ -14752,21 +14828,21 @@ msgid "" "will move it to the end." msgstr "" -#: ../src/Doc/library/collections.rst:811 +#: library/collections.rst:812 msgid "" "The :meth:`popitem` method for ordered dictionaries returns and removes a " "(key, value) pair. The pairs are returned in LIFO order if *last* is true " "or FIFO order if false." msgstr "" -#: ../src/Doc/library/collections.rst:815 +#: library/collections.rst:816 msgid "" "In addition to the usual mapping methods, ordered dictionaries also support " "reverse iteration using :func:`reversed`." msgstr "" # 5547b633053d4827a337c7d000760f72 -#: ../src/Doc/library/collections.rst:818 +#: library/collections.rst:819 msgid "" "Equality tests between :class:`OrderedDict` objects are order-sensitive and " "are implemented as ``list(od1.items())==list(od2.items())``. Equality tests " @@ -14776,31 +14852,31 @@ msgid "" "used." msgstr "" -#: ../src/Doc/library/collections.rst:825 +#: library/collections.rst:826 msgid "" "The :class:`OrderedDict` constructor and :meth:`update` method both accept " "keyword arguments, but their order is lost because Python's function call " "semantics pass-in keyword arguments using a regular unordered dictionary." msgstr "" -#: ../src/Doc/library/collections.rst:831 +#: library/collections.rst:832 msgid "" "`Equivalent OrderedDict recipe `_ that runs on Python 2.4 or later." msgstr "" # 549604aa456541008fec192adc2b1eb2 -#: ../src/Doc/library/collections.rst:835 +#: library/collections.rst:836 msgid ":class:`OrderedDict` Examples and Recipes" msgstr "" -#: ../src/Doc/library/collections.rst:837 +#: library/collections.rst:838 msgid "" "Since an ordered dictionary remembers its insertion order, it can be used in " "conjuction with sorting to make a sorted dictionary::" msgstr "" -#: ../src/Doc/library/collections.rst:855 +#: library/collections.rst:856 msgid "" "The new sorted dictionaries maintain their sort order when entries are " "deleted. But when new keys are added, the keys are appended to the end and " @@ -14808,7 +14884,7 @@ msgid "" msgstr "" # 6f962193ab174266b4ed7e6f09173f10 -#: ../src/Doc/library/collections.rst:859 +#: library/collections.rst:860 msgid "" "It is also straight-forward to create an ordered dictionary variant that " "remembers the order the keys were *last* inserted. If a new entry overwrites " @@ -14817,275 +14893,264 @@ msgid "" msgstr "" # 803e95ae071c4383b15d0f9c24c4d594 -#: ../src/Doc/library/collections.rst:872 +#: library/collections.rst:873 msgid "" "An ordered dictionary can be combined with the :class:`Counter` class so " "that the counter remembers the order elements are first encountered::" msgstr "" # 8ea705aabf5542bdb513edbc73780afe -#: ../src/Doc/library/collections.rst:888 +#: library/collections.rst:889 msgid "Collections Abstract Base Classes" msgstr "" # 1dc47c2bdd354f63b739829613c34520 -#: ../src/Doc/library/collections.rst:890 +#: library/collections.rst:891 msgid "" "The collections module offers the following :term:`ABCs `:" msgstr "" -#: ../src/Doc/library/collections.rst:893 +#: library/collections.rst:894 msgid "ABC" msgstr "" # 8d8db49385d6408b9ee584ebf8c73bd6 -#: ../src/Doc/library/collections.rst:893 +#: library/collections.rst:894 msgid "Inherits from" msgstr "" -#: ../src/Doc/library/collections.rst:893 +#: library/collections.rst:894 msgid "Abstract Methods" msgstr "" -#: ../src/Doc/library/collections.rst:893 +#: library/collections.rst:894 msgid "Mixin Methods" msgstr "" -#: ../src/Doc/library/collections.rst:895 +#: library/collections.rst:896 msgid ":class:`Container`" msgstr "" -#: ../src/Doc/library/collections.rst:895 +#: library/collections.rst:896 msgid "``__contains__``" msgstr "" -#: ../src/Doc/library/collections.rst:896 +#: library/collections.rst:897 msgid ":class:`Hashable`" msgstr "" -#: ../src/Doc/library/collections.rst:896 +#: library/collections.rst:897 msgid "``__hash__``" msgstr "" -#: ../src/Doc/library/collections.rst:897 -#: ../src/Doc/library/collections.rst:898 +#: library/collections.rst:898 library/collections.rst:899 msgid ":class:`Iterable`" msgstr "" -#: ../src/Doc/library/collections.rst:897 -#: ../src/Doc/library/collections.rst:898 +#: library/collections.rst:898 library/collections.rst:899 msgid "``__iter__``" msgstr "" -#: ../src/Doc/library/collections.rst:898 +#: library/collections.rst:899 msgid ":class:`Iterator`" msgstr "" # b3bb58df9a564f42847c08622d26292f -#: ../src/Doc/library/collections.rst:898 +#: library/collections.rst:899 msgid "``next``" msgstr "" -#: ../src/Doc/library/collections.rst:899 -#: ../src/Doc/library/collections.rst:933 +#: library/collections.rst:900 library/collections.rst:934 msgid ":class:`Sized`" msgstr "" -#: ../src/Doc/library/collections.rst:899 -#: ../src/Doc/library/collections.rst:933 +#: library/collections.rst:900 library/collections.rst:934 msgid "``__len__``" msgstr "" -#: ../src/Doc/library/collections.rst:900 +#: library/collections.rst:901 msgid ":class:`Callable`" msgstr "" -#: ../src/Doc/library/collections.rst:900 +#: library/collections.rst:901 msgid "``__call__``" msgstr "" -#: ../src/Doc/library/collections.rst:902 -#: ../src/Doc/library/collections.rst:906 +#: library/collections.rst:903 library/collections.rst:907 msgid ":class:`Sequence`" msgstr "" -#: ../src/Doc/library/collections.rst:902 -#: ../src/Doc/library/collections.rst:912 -#: ../src/Doc/library/collections.rst:922 +#: library/collections.rst:903 library/collections.rst:913 +#: library/collections.rst:923 msgid ":class:`Sized`, :class:`Iterable`, :class:`Container`" msgstr "" # 7ec6395758914118add5adeda388963b -#: ../src/Doc/library/collections.rst:902 +#: library/collections.rst:903 msgid "``__getitem__``, ``__len__``" msgstr "" # 21d8245d7c514c6db5c0670c840347b5 -#: ../src/Doc/library/collections.rst:902 +#: library/collections.rst:903 msgid "" "``__contains__``, ``__iter__``, ``__reversed__``, ``index``, and ``count``" msgstr "" -#: ../src/Doc/library/collections.rst:906 +#: library/collections.rst:907 msgid ":class:`MutableSequence`" msgstr "" # 21d8245d7c514c6db5c0670c840347b5 -#: ../src/Doc/library/collections.rst:906 +#: library/collections.rst:907 msgid "" "``__getitem__``, ``__setitem__``, ``__delitem__``, ``__len__``, ``insert``" msgstr "" # 143f1ae1196d455ca24769fb76223e6b -#: ../src/Doc/library/collections.rst:906 +#: library/collections.rst:907 msgid "" "Inherited :class:`Sequence` methods and ``append``, ``reverse``, ``extend``, " "``pop``, ``remove``, and ``__iadd__``" msgstr "" -#: ../src/Doc/library/collections.rst:912 -#: ../src/Doc/library/collections.rst:916 +#: library/collections.rst:913 library/collections.rst:917 msgid ":class:`Set`" msgstr "" # b231b57c804042d497a4d5d58d49bad0 -#: ../src/Doc/library/collections.rst:912 +#: library/collections.rst:913 msgid "``__contains__``, ``__iter__``, ``__len__``" msgstr "" # 72ff2b13084747b4b0b582b6c773d8c5 -#: ../src/Doc/library/collections.rst:912 +#: library/collections.rst:913 msgid "" "``__le__``, ``__lt__``, ``__eq__``, ``__ne__``, ``__gt__``, ``__ge__``, " "``__and__``, ``__or__``, ``__sub__``, ``__xor__``, and ``isdisjoint``" msgstr "" -#: ../src/Doc/library/collections.rst:916 +#: library/collections.rst:917 msgid ":class:`MutableSet`" msgstr "" # 21d8245d7c514c6db5c0670c840347b5 -#: ../src/Doc/library/collections.rst:916 +#: library/collections.rst:917 msgid "``__contains__``, ``__iter__``, ``__len__``, ``add``, ``discard``" msgstr "" # d9a34fb97da24b83ae7a4e7364e09ddd -#: ../src/Doc/library/collections.rst:916 +#: library/collections.rst:917 msgid "" "Inherited :class:`Set` methods and ``clear``, ``pop``, ``remove``, " "``__ior__``, ``__iand__``, ``__ixor__``, and ``__isub__``" msgstr "" -#: ../src/Doc/library/collections.rst:922 -#: ../src/Doc/library/collections.rst:926 +#: library/collections.rst:923 library/collections.rst:927 msgid ":class:`Mapping`" msgstr "" # b231b57c804042d497a4d5d58d49bad0 -#: ../src/Doc/library/collections.rst:922 +#: library/collections.rst:923 msgid "``__getitem__``, ``__iter__``, ``__len__``" msgstr "" -#: ../src/Doc/library/collections.rst:922 +#: library/collections.rst:923 msgid "" "``__contains__``, ``keys``, ``items``, ``values``, ``get``, ``__eq__``, and " "``__ne__``" msgstr "" -#: ../src/Doc/library/collections.rst:926 +#: library/collections.rst:927 msgid ":class:`MutableMapping`" msgstr "" # 21d8245d7c514c6db5c0670c840347b5 -#: ../src/Doc/library/collections.rst:926 +#: library/collections.rst:927 msgid "" "``__getitem__``, ``__setitem__``, ``__delitem__``, ``__iter__``, ``__len__``" msgstr "" # 4fa6f110327e44f6a9c3d75d00b863d4 -#: ../src/Doc/library/collections.rst:926 +#: library/collections.rst:927 msgid "" "Inherited :class:`Mapping` methods and ``pop``, ``popitem``, ``clear``, " "``update``, and ``setdefault``" msgstr "" -#: ../src/Doc/library/collections.rst:933 -#: ../src/Doc/library/collections.rst:938 +#: library/collections.rst:934 library/collections.rst:939 msgid ":class:`MappingView`" msgstr "" -#: ../src/Doc/library/collections.rst:934 +#: library/collections.rst:935 msgid ":class:`ItemsView`" msgstr "" -#: ../src/Doc/library/collections.rst:934 -#: ../src/Doc/library/collections.rst:936 +#: library/collections.rst:935 library/collections.rst:937 msgid ":class:`MappingView`, :class:`Set`" msgstr "" -#: ../src/Doc/library/collections.rst:934 -#: ../src/Doc/library/collections.rst:936 -#: ../src/Doc/library/collections.rst:938 +#: library/collections.rst:935 library/collections.rst:937 +#: library/collections.rst:939 msgid "``__contains__``, ``__iter__``" msgstr "" -#: ../src/Doc/library/collections.rst:936 +#: library/collections.rst:937 msgid ":class:`KeysView`" msgstr "" -#: ../src/Doc/library/collections.rst:938 +#: library/collections.rst:939 msgid ":class:`ValuesView`" msgstr "" # 4339e8fb04604926bef4f193bd72fe30 -#: ../src/Doc/library/collections.rst:947 +#: library/collections.rst:948 msgid "" "ABCs for classes that provide respectively the methods :meth:" "`__contains__`, :meth:`__hash__`, :meth:`__len__`, and :meth:`__call__`." msgstr "" # b67ee073fc93412782f7cc816fd7d4ef -#: ../src/Doc/library/collections.rst:952 +#: library/collections.rst:953 msgid "" "ABC for classes that provide the :meth:`__iter__` method. See also the " "definition of :term:`iterable`." msgstr "" # 8998155429654711a155d159a46017cf -#: ../src/Doc/library/collections.rst:957 +#: library/collections.rst:958 msgid "" "ABC for classes that provide the :meth:`~iterator.__iter__` and :meth:" "`~iterator.next` methods. See also the definition of :term:`iterator`." msgstr "" # c366c484c6604db7a683127a6344c69c -#: ../src/Doc/library/collections.rst:963 +#: library/collections.rst:964 msgid "ABCs for read-only and mutable :term:`sequences `." msgstr "" # 0a7d7aff30784ca48dbed8be7dc2d149 -#: ../src/Doc/library/collections.rst:968 +#: library/collections.rst:969 msgid "ABCs for read-only and mutable sets." msgstr "" # 722e54dba03e437bb0692427689d48d8 -#: ../src/Doc/library/collections.rst:973 +#: library/collections.rst:974 msgid "ABCs for read-only and mutable :term:`mappings `." msgstr "" -# 7c9c5fd1db3d4ac28c6645c07229387d -#: ../src/Doc/library/collections.rst:980 -msgid "ABCs for mapping, items, keys, and values :term:`views `." +#: library/collections.rst:981 +msgid "" +"ABCs for mapping, items, keys, and values :term:`views `." msgstr "" -#: ../src/Doc/library/collections.rst:983 +#: library/collections.rst:984 msgid "" "These ABCs allow us to ask classes or instances if they provide particular " "functionality, for example::" msgstr "" -#: ../src/Doc/library/collections.rst:990 +#: library/collections.rst:991 msgid "" "Several of the ABCs are also useful as mixins that make it easier to develop " "classes supporting container APIs. For example, to write a class supporting " @@ -15095,12 +15160,12 @@ msgid "" "and :meth:`isdisjoint` ::" msgstr "" -#: ../src/Doc/library/collections.rst:1016 +#: library/collections.rst:1017 msgid "Notes on using :class:`Set` and :class:`MutableSet` as a mixin:" msgstr "" # 0712884ff1c64587aff2b93e2a76d4d2 -#: ../src/Doc/library/collections.rst:1019 +#: library/collections.rst:1020 msgid "" "Since some set operations create new sets, the default mixin methods need a " "way to create new instances from an iterable. The class constructor is " @@ -15113,14 +15178,14 @@ msgid "" msgstr "" # fdc25fd5b1da4927bd52f5519084e4f9 -#: ../src/Doc/library/collections.rst:1030 +#: library/collections.rst:1031 msgid "" "To override the comparisons (presumably for speed, as the semantics are " "fixed), redefine :meth:`__le__` and :meth:`__ge__`, then the other " "operations will automatically follow suit." msgstr "" -#: ../src/Doc/library/collections.rst:1035 +#: library/collections.rst:1036 msgid "" "The :class:`Set` mixin provides a :meth:`_hash` method to compute a hash " "value for the set; however, :meth:`__hash__` is not defined because not all " @@ -15129,30 +15194,30 @@ msgid "" "_hash``." msgstr "" -#: ../src/Doc/library/collections.rst:1043 +#: library/collections.rst:1044 msgid "" "`OrderedSet recipe `_ for an " "example built on :class:`MutableSet`." msgstr "" -#: ../src/Doc/library/collections.rst:1046 +#: library/collections.rst:1047 msgid "For more about ABCs, see the :mod:`abc` module and :pep:`3119`." msgstr "" # d3a21e815d6a42f291d12ad5ab9162bc -#: ../src/Doc/library/colorpicker.rst:3 +#: library/colorpicker.rst:3 msgid ":mod:`ColorPicker` --- Color selection dialog" msgstr "" # 884beb69b125425e82714ca95c6a1f86 -#: ../src/Doc/library/colorpicker.rst:13 +#: library/colorpicker.rst:13 msgid "" "The :mod:`ColorPicker` module provides access to the standard color picker " "dialog." msgstr "" # 8db50723822846ca8a672b56bcc60813 -#: ../src/Doc/library/colorpicker.rst:23 +#: library/colorpicker.rst:23 msgid "" "Show a standard color selection dialog and allow the user to select a color. " "The user is given instruction by the *prompt* string, and the default color " @@ -15162,16 +15227,16 @@ msgid "" "cancelled." msgstr "" -#: ../src/Doc/library/colorsys.rst:2 +#: library/colorsys.rst:2 msgid ":mod:`colorsys` --- Conversions between color systems" msgstr "" # f7f1e58915194c508cdb63b14a8ba7aa -#: ../src/Doc/library/colorsys.rst:8 +#: library/colorsys.rst:8 msgid "**Source code:** :source:`Lib/colorsys.py`" msgstr "" -#: ../src/Doc/library/colorsys.rst:12 +#: library/colorsys.rst:12 msgid "" "The :mod:`colorsys` module defines bidirectional conversions of color values " "between colors expressed in the RGB (Red Green Blue) color space used in " @@ -15182,48 +15247,54 @@ msgid "" "or negative. In all other spaces, the coordinates are all between 0 and 1." msgstr "" -#: ../src/Doc/library/colorsys.rst:22 +#: library/colorsys.rst:22 msgid "" "More information about color spaces can be found at http://www.poynton.com/" "ColorFAQ.html and http://www.cambridgeincolour.com/tutorials/color-spaces." "htm." msgstr "" -#: ../src/Doc/library/colorsys.rst:26 +#: library/colorsys.rst:26 msgid "The :mod:`colorsys` module defines the following functions:" msgstr "" -#: ../src/Doc/library/colorsys.rst:31 +#: library/colorsys.rst:31 msgid "Convert the color from RGB coordinates to YIQ coordinates." msgstr "" -#: ../src/Doc/library/colorsys.rst:36 +#: library/colorsys.rst:36 msgid "Convert the color from YIQ coordinates to RGB coordinates." msgstr "" -#: ../src/Doc/library/colorsys.rst:41 +#: library/colorsys.rst:41 msgid "Convert the color from RGB coordinates to HLS coordinates." msgstr "" -#: ../src/Doc/library/colorsys.rst:46 +#: library/colorsys.rst:46 msgid "Convert the color from HLS coordinates to RGB coordinates." msgstr "" -#: ../src/Doc/library/colorsys.rst:51 +#: library/colorsys.rst:51 msgid "Convert the color from RGB coordinates to HSV coordinates." msgstr "" -#: ../src/Doc/library/colorsys.rst:56 +#: library/colorsys.rst:56 msgid "Convert the color from HSV coordinates to RGB coordinates." msgstr "" # 19bdb26518f3476cb182fbcfc21d8a25 -#: ../src/Doc/library/commands.rst:3 +#: library/commands.rst:3 msgid ":mod:`commands` --- Utilities for running commands" msgstr "" +#: library/commands.rst:10 +msgid "" +"The :mod:`commands` module has been removed in Python 3. Use the :mod:" +"`subprocess` module instead." +msgstr "" + # d207bea53caf45fc9995ad4ffba93ec0 -#: ../src/Doc/library/commands.rst:17 +#: library/commands.rst:17 msgid "" "The :mod:`commands` module contains wrapper functions for :func:`os.popen` " "which take a system command as a string and return any output generated by " @@ -15231,7 +15302,7 @@ msgid "" msgstr "" # 92d70c6af03a469d9ed3018cddff328b -#: ../src/Doc/library/commands.rst:21 +#: library/commands.rst:21 msgid "" "The :mod:`subprocess` module provides more powerful facilities for spawning " "new processes and retrieving their results. Using the :mod:`subprocess` " @@ -15239,7 +15310,7 @@ msgid "" msgstr "" # d4a3b0ee720f4788be003afe646f8818 -#: ../src/Doc/library/commands.rst:27 +#: library/commands.rst:27 msgid "" "In Python 3.x, :func:`getstatus` and two undocumented functions (:func:" "`mk2arg` and :func:`mkarg`) have been removed. Also, :func:" @@ -15248,12 +15319,12 @@ msgid "" msgstr "" # 16e992af595d49bb820e491f7d1b64ca -#: ../src/Doc/library/commands.rst:32 +#: library/commands.rst:32 msgid "The :mod:`commands` module defines the following functions:" msgstr "" # 2685f2b3460244c3a3120faaab66c7be -#: ../src/Doc/library/commands.rst:37 +#: library/commands.rst:37 msgid "" "Execute the string *cmd* in a shell with :func:`os.popen` and return a 2-" "tuple ``(status, output)``. *cmd* is actually run as ``{ cmd ; } 2>&1``, so " @@ -15263,43 +15334,47 @@ msgid "" msgstr "" # 8de85fbb6f204b2e8dc1bf9cf3d0f4f1 -#: ../src/Doc/library/commands.rst:46 +#: library/commands.rst:46 msgid "" "Like :func:`getstatusoutput`, except the exit status is ignored and the " "return value is a string containing the command's output." msgstr "" # 3259d5afbb594c0c910e7a18452e7c06 -#: ../src/Doc/library/commands.rst:52 +#: library/commands.rst:52 msgid "" "Return the output of ``ls -ld file`` as a string. This function uses the :" "func:`getoutput` function, and properly escapes backslashes and dollar signs " "in the argument." msgstr "" -# 26dd5f2f8f40422187b8ed62d57d17b8 -# e4a87c9ea5b348219c6e380a98357b9b -#: ../src/Doc/library/commands.rst:77 ../src/Doc/library/popen2.rst:196 -msgid "Module :mod:`subprocess`" +#: library/commands.rst:56 +msgid "" +"This function is nonobvious and useless. The name is also misleading in the " +"presence of :func:`getstatusoutput`." +msgstr "" + +#: library/commands.rst:78 library/popen2.rst:197 +msgid "Module subprocess" msgstr "" # ec08b9eb511c4ec19ec01405e9c3bcce # 62fda2ff547543ff994efcd0d0a07b52 -#: ../src/Doc/library/commands.rst:79 ../src/Doc/library/popen2.rst:198 +#: library/commands.rst:79 library/popen2.rst:198 msgid "Module for spawning and managing subprocesses." msgstr "" -#: ../src/Doc/library/compileall.rst:2 +#: library/compileall.rst:2 msgid ":mod:`compileall` --- Byte-compile Python libraries" msgstr "" # 3411bc4be36f4dc0acd57181b9b30519 -#: ../src/Doc/library/compileall.rst:7 +#: library/compileall.rst:7 msgid "**Source code:** :source:`Lib/compileall.py`" msgstr "" # 27bf6932ad04470ea4ed2721e5ddf392 -#: ../src/Doc/library/compileall.rst:12 +#: library/compileall.rst:12 msgid "" "This module provides some utility functions to support installing Python " "libraries. These functions compile Python source files in a directory tree. " @@ -15309,19 +15384,19 @@ msgid "" msgstr "" # 83412456e9fe45718a7db28933de940f -#: ../src/Doc/library/compileall.rst:20 +#: library/compileall.rst:20 msgid "Command-line use" msgstr "" # d7cc3736801346f2a2d696ed7bd32800 -#: ../src/Doc/library/compileall.rst:22 +#: library/compileall.rst:22 msgid "" "This module can work as a script (using :program:`python -m compileall`) to " "compile Python sources." msgstr "" # b82963fd97c540f28353612c9b78ff5f -#: ../src/Doc/library/compileall.rst:30 +#: library/compileall.rst:30 msgid "" "Positional arguments are files to compile or directories that contain source " "files, traversed recursively. If no argument is given, behave as if the " @@ -15329,24 +15404,24 @@ msgid "" msgstr "" # 161f44460945400c838c11bf2140f0eb -#: ../src/Doc/library/compileall.rst:36 +#: library/compileall.rst:36 msgid "" "Do not recurse into subdirectories, only compile source code files directly " "contained in the named or implied directories." msgstr "" # 4a627ce96b004f1d92143d1d6d7836c9 -#: ../src/Doc/library/compileall.rst:41 +#: library/compileall.rst:41 msgid "Force rebuild even if timestamps are up-to-date." msgstr "" # eebe2293adf04adfb4f50108822c60c8 -#: ../src/Doc/library/compileall.rst:45 +#: library/compileall.rst:45 msgid "Do not print the list of files compiled, print only error messages." msgstr "" # efcef08f0fb5472e95bf9c64790d3b06 -#: ../src/Doc/library/compileall.rst:49 +#: library/compileall.rst:49 msgid "" "Directory prepended to the path to each file being compiled. This will " "appear in compilation time tracebacks, and is also compiled in to the byte-" @@ -15356,41 +15431,45 @@ msgid "" msgstr "" # bb12ec47eeb14b299dba2e9863b6b447 -#: ../src/Doc/library/compileall.rst:57 +#: library/compileall.rst:57 msgid "" "regex is used to search the full path to each file considered for " "compilation, and if the regex produces a match, the file is skipped." msgstr "" # 4259a97b6b524ab0af576c6fe02209a2 -#: ../src/Doc/library/compileall.rst:62 +#: library/compileall.rst:62 msgid "" "Read the file ``list`` and add each line that it contains to the list of " "files and directories to compile. If ``list`` is ``-``, read lines from " "``stdin``." msgstr "" +#: library/compileall.rst:66 +msgid "Added the ``-i`` option." +msgstr "" + # 7db86a9556a540a6b877475c8837e119 -#: ../src/Doc/library/compileall.rst:71 +#: library/compileall.rst:71 msgid "Public functions" msgstr "" # a4bf0181f0cc4304a52402ba1fef82a4 -#: ../src/Doc/library/compileall.rst:75 +#: library/compileall.rst:75 msgid "" "Recursively descend the directory tree named by *dir*, compiling all :file:`." "py` files along the way." msgstr "" # e89c604e89f244aa868f87e2379e7831 -#: ../src/Doc/library/compileall.rst:78 +#: library/compileall.rst:78 msgid "" "The *maxlevels* parameter is used to limit the depth of the recursion; it " "defaults to ``10``." msgstr "" # aae72265ace44e8080f01f0fa4351cbd -#: ../src/Doc/library/compileall.rst:81 +#: library/compileall.rst:81 msgid "" "If *ddir* is given, it is prepended to the path to each file being compiled " "for use in compilation time tracebacks, and is also compiled in to the byte-" @@ -15400,14 +15479,14 @@ msgid "" msgstr "" # 5486b7de1cf44e3eb02911ebf16d39e1 -#: ../src/Doc/library/compileall.rst:87 +#: library/compileall.rst:87 msgid "" "If *force* is true, modules are re-compiled even if the timestamps are up to " "date." msgstr "" # 2e4df8292ca949dc91a54058730c0dc0 -#: ../src/Doc/library/compileall.rst:90 +#: library/compileall.rst:90 msgid "" "If *rx* is given, its search method is called on the complete path to each " "file considered for compilation, and if it returns a true value, the file is " @@ -15416,19 +15495,19 @@ msgstr "" # 0026414b71a2469294ec3395ebb30e2f # a97db58421f04cf3a9cd8a5fba06cff4 -#: ../src/Doc/library/compileall.rst:94 ../src/Doc/library/compileall.rst:112 +#: library/compileall.rst:94 library/compileall.rst:112 msgid "" "If *quiet* is true, nothing is printed to the standard output unless errors " "occur." msgstr "" # 31cacd92bbaf41319cd83696180d3dc7 -#: ../src/Doc/library/compileall.rst:100 +#: library/compileall.rst:100 msgid "Compile the file with path *fullname*." msgstr "" # 3ea931520e344590b33d85fad3d0e492 -#: ../src/Doc/library/compileall.rst:102 +#: library/compileall.rst:102 msgid "" "If *ddir* is given, it is prepended to the path to the file being compiled " "for use in compilation time tracebacks, and is also compiled in to the byte-" @@ -15438,7 +15517,7 @@ msgid "" msgstr "" # 767c066f0f7b4e29a4418e06579bdf8d -#: ../src/Doc/library/compileall.rst:108 +#: library/compileall.rst:108 msgid "" "If *rx* is given, its search method is passed the full path name to the file " "being compiled, and if it returns a true value, the file is not compiled and " @@ -15446,7 +15525,7 @@ msgid "" msgstr "" # 197847c3a359423da300372ce61d9081 -#: ../src/Doc/library/compileall.rst:120 +#: library/compileall.rst:120 msgid "" "Byte-compile all the :file:`.py` files found along ``sys.path``. If " "*skip_curdir* is true (the default), the current directory is not included " @@ -15455,28 +15534,31 @@ msgid "" "defaults to ``0``." msgstr "" -#: ../src/Doc/library/compileall.rst:126 +#: library/compileall.rst:126 msgid "" "To force a recompile of all the :file:`.py` files in the :file:`Lib/` " "subdirectory and all its subdirectories::" msgstr "" -# f159c1b876754f3885ab836b67b80a56 -#: ../src/Doc/library/compileall.rst:139 -msgid "Module :mod:`py_compile`" +#: library/compileall.rst:140 +msgid "Module py_compile" msgstr "" -#: ../src/Doc/library/compileall.rst:141 +#: library/compileall.rst:141 msgid "Byte-compile a single source file." msgstr "" # 9b26472b7da34a03b7e27e5598ffff61 -#: ../src/Doc/library/compiler.rst:6 +#: library/compiler.rst:6 msgid "Python compiler package" msgstr "" +#: library/compiler.rst:8 +msgid "The :mod:`compiler` package has been removed in Python 3." +msgstr "" + # b95657c502ce412387593bc0f90bf8f1 -#: ../src/Doc/library/compiler.rst:14 +#: library/compiler.rst:14 msgid "" "The Python compiler package is a tool for analyzing Python source code and " "generating Python bytecode. The compiler contains libraries to generate an " @@ -15485,7 +15567,7 @@ msgid "" msgstr "" # 63ebb8c3a4c146c5be69607f16d975a5 -#: ../src/Doc/library/compiler.rst:19 +#: library/compiler.rst:19 msgid "" "The :mod:`compiler` package is a Python source to bytecode translator " "written in Python. It uses the built-in parser and standard :mod:`parser` " @@ -15494,7 +15576,7 @@ msgid "" msgstr "" # b2267d86b74d40c49e8b01dfa125f068 -#: ../src/Doc/library/compiler.rst:24 +#: library/compiler.rst:24 msgid "" "The full functionality of the package duplicates the built-in compiler " "provided with the Python interpreter. It is intended to match its behavior " @@ -15505,19 +15587,19 @@ msgid "" msgstr "" # afaaacfd93cd478c95f2a136d9d23066 -#: ../src/Doc/library/compiler.rst:31 +#: library/compiler.rst:31 msgid "" "This chapter explains how the various components of the :mod:`compiler` " "package work. It blends reference material with a tutorial." msgstr "" # d31c5aa449fa44c8875bd9dbdc5315af -#: ../src/Doc/library/compiler.rst:36 +#: library/compiler.rst:36 msgid "The basic interface" msgstr "" # 5e6611de2f604609ab76f3dd38207881 -#: ../src/Doc/library/compiler.rst:43 +#: library/compiler.rst:43 msgid "" "The top-level of the package defines four functions. If you import :mod:" "`compiler`, you will get these functions and a collection of modules " @@ -15525,7 +15607,7 @@ msgid "" msgstr "" # 21e68f2af9504f35ac3dd4da3dba57a1 -#: ../src/Doc/library/compiler.rst:50 +#: library/compiler.rst:50 msgid "" "Returns an abstract syntax tree for the Python source code in *buf*. The " "function raises :exc:`SyntaxError` if there is an error in the source code. " @@ -15534,21 +15616,21 @@ msgid "" msgstr "" # b4d0c22f1a8f48f19ca75290ff01d652 -#: ../src/Doc/library/compiler.rst:57 +#: library/compiler.rst:57 msgid "" "Return an abstract syntax tree for the Python source code in the file " "specified by *path*. It is equivalent to ``parse(open(path).read())``." msgstr "" # bda4062c1298435da678c800d2884d35 -#: ../src/Doc/library/compiler.rst:63 +#: library/compiler.rst:63 msgid "" "Do a pre-order walk over the abstract syntax tree *ast*. Call the " "appropriate method on the *visitor* instance for each node encountered." msgstr "" # ad29c1f6e69742069f2fac6998740e97 -#: ../src/Doc/library/compiler.rst:69 +#: library/compiler.rst:69 msgid "" "Compile the string *source*, a Python module, statement or expression, into " "a code object that can be executed by the exec statement or :func:`eval`. " @@ -15556,43 +15638,43 @@ msgid "" msgstr "" # 214886ab1e3b422ba4cf51787be51046 -#: ../src/Doc/library/compiler.rst:73 +#: library/compiler.rst:73 msgid "The *filename* will be used for run-time error messages." msgstr "" # 5abec165586447e2b09752699409654c -#: ../src/Doc/library/compiler.rst:75 +#: library/compiler.rst:75 msgid "" "The *mode* must be 'exec' to compile a module, 'single' to compile a single " "(interactive) statement, or 'eval' to compile an expression." msgstr "" # f1dd690667024e9a9925c38cee5adf68 -#: ../src/Doc/library/compiler.rst:78 +#: library/compiler.rst:78 msgid "" "The *flags* and *dont_inherit* arguments affect future-related statements, " "but are not supported yet." msgstr "" # 46ea7f1b126d4340bf0ccfd5723baca2 -#: ../src/Doc/library/compiler.rst:84 +#: library/compiler.rst:84 msgid "Compiles the file *source* and generates a .pyc file." msgstr "" # a39fca7992ab422aa21b520871af78bd -#: ../src/Doc/library/compiler.rst:86 +#: library/compiler.rst:86 msgid "" "The :mod:`compiler` package contains the following modules: :mod:`ast`, :mod:" "`consts`, :mod:`future`, :mod:`misc`, :mod:`pyassem`, :mod:`pycodegen`, :mod:" "`symbols`, :mod:`transformer`, and :mod:`visitor`." msgstr "" -#: ../src/Doc/library/compiler.rst:92 ../src/Doc/library/profile.rst:552 +#: library/compiler.rst:92 library/profile.rst:552 msgid "Limitations" msgstr "" # c56ea5aeb19e45ae8dfb02ca9fb808e5 -#: ../src/Doc/library/compiler.rst:94 +#: library/compiler.rst:94 msgid "" "There are some problems with the error checking of the compiler package. " "The interpreter detects syntax errors in two distinct phases. One set of " @@ -15605,17 +15687,17 @@ msgid "" msgstr "" # fdb7a1179d9243b692edf0f103862d23 -#: ../src/Doc/library/compiler.rst:103 +#: library/compiler.rst:103 msgid "A future version of the compiler should fix these problems." msgstr "" # 1114ef611854426aaafc1e199aaef4f0 -#: ../src/Doc/library/compiler.rst:107 +#: library/compiler.rst:107 msgid "Python Abstract Syntax" msgstr "" # 4a0026b0b71042e7add8ac07b2d681f0 -#: ../src/Doc/library/compiler.rst:109 +#: library/compiler.rst:109 msgid "" "The :mod:`compiler.ast` module defines an abstract syntax for Python. In " "the abstract syntax tree, each node represents a syntactic construct. The " @@ -15623,7 +15705,7 @@ msgid "" msgstr "" # 8490d9c459e64ee6992f1a58c2973584 -#: ../src/Doc/library/compiler.rst:113 +#: library/compiler.rst:113 msgid "" "The abstract syntax offers a higher level interface to parsed Python source " "code. The :mod:`parser` module and the compiler written in C for the Python " @@ -15634,7 +15716,7 @@ msgid "" msgstr "" # 02f2364f5bc04fd0979ba0ac9d64de88 -#: ../src/Doc/library/compiler.rst:120 +#: library/compiler.rst:120 msgid "" "The abstract syntax tree is created by the :mod:`compiler.transformer` " "module. The transformer relies on the built-in Python parser to generate a " @@ -15643,7 +15725,7 @@ msgid "" msgstr "" # b3a49facc622486d8a92e101e435e2e4 -#: ../src/Doc/library/compiler.rst:128 +#: library/compiler.rst:128 msgid "" "The :mod:`transformer` module was created by Greg Stein and Bill Tutt for an " "experimental Python-to-C compiler. The current version contains a number of " @@ -15652,12 +15734,12 @@ msgid "" msgstr "" # d1a8fed41ebb491f83ef88d107a3a20c -#: ../src/Doc/library/compiler.rst:135 +#: library/compiler.rst:135 msgid "AST Nodes" msgstr "" # 4c28b617286d496b891e719610175736 -#: ../src/Doc/library/compiler.rst:140 +#: library/compiler.rst:140 msgid "" "The :mod:`compiler.ast` module is generated from a text file that describes " "each node type and its elements. Each node type is represented as a class " @@ -15666,7 +15748,7 @@ msgid "" msgstr "" # 9e75c7c597384c4783812d9f5f321890 -#: ../src/Doc/library/compiler.rst:148 +#: library/compiler.rst:148 msgid "" "The :class:`Node` instances are created automatically by the parser " "generator. The recommended interface for specific :class:`Node` instances is " @@ -15678,7 +15760,7 @@ msgid "" msgstr "" # 8a7fb9d936b240acbd230b70de7d5c3d -#: ../src/Doc/library/compiler.rst:156 +#: library/compiler.rst:156 msgid "" "Each :class:`Node` instance has a :attr:`lineno` attribute which may be " "``None``. XXX Not sure what the rules are for which nodes will have a " @@ -15686,12 +15768,12 @@ msgid "" msgstr "" # 9c90876f32e54085854cf1d9a9469deb -#: ../src/Doc/library/compiler.rst:160 +#: library/compiler.rst:160 msgid "All :class:`Node` objects offer the following methods:" msgstr "" # 100621fbe70c45b7be99ac4e2afab787 -#: ../src/Doc/library/compiler.rst:165 +#: library/compiler.rst:165 msgid "" "Returns a flattened list of the child nodes and objects in the order they " "occur. Specifically, the order of the nodes is the order in which they " @@ -15701,7 +15783,7 @@ msgid "" msgstr "" # 8b85f8a8a43042db8988a502f37337eb -#: ../src/Doc/library/compiler.rst:174 +#: library/compiler.rst:174 msgid "" "Returns a flattened list of the child nodes in the order they occur. This " "method is like :meth:`getChildren`, except that it only returns those " @@ -15709,7 +15791,7 @@ msgid "" msgstr "" # aea876cf3ede44588fbb2ba70ec14957 -#: ../src/Doc/library/compiler.rst:179 +#: library/compiler.rst:179 msgid "" "Two examples illustrate the general structure of :class:`Node` classes. " "The :keyword:`while` statement is defined by the following grammar " @@ -15717,7 +15799,7 @@ msgid "" msgstr "" # 451eca15a0484234a0d64b4a519c3caa -#: ../src/Doc/library/compiler.rst:185 +#: library/compiler.rst:185 msgid "" "The :class:`While` node has three attributes: :attr:`test`, :attr:`body`, " "and :attr:`else_`. (If the natural name for an attribute is also a Python " @@ -15727,14 +15809,14 @@ msgid "" msgstr "" # e60b324a0e0c46abad2ab33e5651478b -#: ../src/Doc/library/compiler.rst:191 +#: library/compiler.rst:191 msgid "" "The :keyword:`if` statement is more complicated because it can include " "several tests. ::" msgstr "" # 3849e810e473450493c4b800435b9c35 -#: ../src/Doc/library/compiler.rst:196 +#: library/compiler.rst:196 msgid "" "The :class:`If` node only defines two attributes: :attr:`tests` and :attr:" "`else_`. The :attr:`tests` attribute is a sequence of test expression, " @@ -15745,7 +15827,7 @@ msgid "" msgstr "" # 1b224c66d5f040f098d90c55b1cc6942 -#: ../src/Doc/library/compiler.rst:203 +#: library/compiler.rst:203 msgid "" "The :meth:`getChildren` method of :class:`If` returns a flat list of child " "nodes. If there are three :keyword:`if`/:keyword:`elif` clauses and no :" @@ -15755,7 +15837,7 @@ msgid "" msgstr "" # be7855c030c047b3ac2d334693786ef8 -#: ../src/Doc/library/compiler.rst:209 +#: library/compiler.rst:209 msgid "" "The following table lists each of the :class:`Node` subclasses defined in :" "mod:`compiler.ast` and each of the public attributes available on their " @@ -15767,21 +15849,19 @@ msgid "" msgstr "" # d517827f0f734739b5ef5d3c53f96908 -#: ../src/Doc/library/compiler.rst:218 +#: library/compiler.rst:218 msgid "Node type" msgstr "" -#: ../src/Doc/library/compiler.rst:218 ../src/Doc/library/curses.rst:1240 -#: ../src/Doc/library/datetime.rst:205 ../src/Doc/library/grp.rst:18 -#: ../src/Doc/library/inspect.rst:40 ../src/Doc/library/pwd.rst:18 -#: ../src/Doc/library/spwd.rst:23 ../src/Doc/library/sys.rst:607 -#: ../src/Doc/library/time.rst:405 ../src/Doc/library/urlparse.rst:94 -#: ../src/Doc/library/urlparse.rst:198 +#: library/compiler.rst:218 library/curses.rst:1240 library/datetime.rst:205 +#: library/grp.rst:18 library/inspect.rst:40 library/pwd.rst:18 +#: library/spwd.rst:23 library/sys.rst:607 library/time.rst:404 +#: library/urlparse.rst:94 library/urlparse.rst:198 msgid "Attribute" msgstr "" # 963fd716c88643359791fc427c9b5654 -#: ../src/Doc/library/compiler.rst:220 +#: library/compiler.rst:220 msgid ":class:`Add`" msgstr "" @@ -15794,16 +15874,14 @@ msgstr "" # 26fb4656a5e4445ba16fc3bf3d4d86c9 # 6e496806317d4f3a89401c0d7cf3f893 # 0c8c401e831745dab948ec77917b56c6 -#: ../src/Doc/library/compiler.rst:220 ../src/Doc/library/compiler.rst:304 -#: ../src/Doc/library/compiler.rst:318 ../src/Doc/library/compiler.rst:390 -#: ../src/Doc/library/compiler.rst:408 ../src/Doc/library/compiler.rst:418 -#: ../src/Doc/library/compiler.rst:430 ../src/Doc/library/compiler.rst:450 -#: ../src/Doc/library/compiler.rst:466 +#: library/compiler.rst:220 library/compiler.rst:304 library/compiler.rst:318 +#: library/compiler.rst:390 library/compiler.rst:408 library/compiler.rst:418 +#: library/compiler.rst:430 library/compiler.rst:450 library/compiler.rst:466 msgid ":attr:`left`" msgstr "" # 637033ec5e3843d6b8c60217ae814306 -#: ../src/Doc/library/compiler.rst:220 +#: library/compiler.rst:220 msgid "left operand" msgstr "" @@ -15816,21 +15894,19 @@ msgstr "" # d85dc951b66d4a199bb59e324c7bd3de # 3258f5bea81842f3abab645cff825433 # f76de6c0d4104f23b45acbda46c732ec -#: ../src/Doc/library/compiler.rst:222 ../src/Doc/library/compiler.rst:306 -#: ../src/Doc/library/compiler.rst:320 ../src/Doc/library/compiler.rst:392 -#: ../src/Doc/library/compiler.rst:410 ../src/Doc/library/compiler.rst:420 -#: ../src/Doc/library/compiler.rst:432 ../src/Doc/library/compiler.rst:452 -#: ../src/Doc/library/compiler.rst:468 +#: library/compiler.rst:222 library/compiler.rst:306 library/compiler.rst:320 +#: library/compiler.rst:392 library/compiler.rst:410 library/compiler.rst:420 +#: library/compiler.rst:432 library/compiler.rst:452 library/compiler.rst:468 msgid ":attr:`right`" msgstr "" # e0e3741db6324273b870b44b7fae3262 -#: ../src/Doc/library/compiler.rst:222 +#: library/compiler.rst:222 msgid "right operand" msgstr "" # d400d8ef737841d9b991abb4f6749144 -#: ../src/Doc/library/compiler.rst:224 +#: library/compiler.rst:224 msgid ":class:`And`" msgstr "" @@ -15849,29 +15925,26 @@ msgstr "" # c8c9828e4bb946c089b669be0ed61683 # d41d1feff986453baac058ea1eaf9f5f # 51f08cc1299348ac8f542fa9cc1acb39 -#: ../src/Doc/library/compiler.rst:224 ../src/Doc/library/compiler.rst:236 -#: ../src/Doc/library/compiler.rst:243 ../src/Doc/library/compiler.rst:251 -#: ../src/Doc/library/compiler.rst:264 ../src/Doc/library/compiler.rst:266 -#: ../src/Doc/library/compiler.rst:268 ../src/Doc/library/compiler.rst:297 -#: ../src/Doc/library/compiler.rst:394 ../src/Doc/library/compiler.rst:426 -#: ../src/Doc/library/compiler.rst:434 ../src/Doc/library/compiler.rst:438 -#: ../src/Doc/library/compiler.rst:462 ../src/Doc/library/compiler.rst:464 -#: ../src/Doc/library/compiler.rst:486 +#: library/compiler.rst:224 library/compiler.rst:236 library/compiler.rst:243 +#: library/compiler.rst:251 library/compiler.rst:264 library/compiler.rst:266 +#: library/compiler.rst:268 library/compiler.rst:297 library/compiler.rst:394 +#: library/compiler.rst:426 library/compiler.rst:434 library/compiler.rst:438 +#: library/compiler.rst:462 library/compiler.rst:464 library/compiler.rst:486 msgid ":attr:`nodes`" msgstr "" # e18bec4ff86746c0a534c0be66b5cc3e -#: ../src/Doc/library/compiler.rst:224 +#: library/compiler.rst:224 msgid "list of operands" msgstr "" # 6afd6292700e417a87287cb6cded825e -#: ../src/Doc/library/compiler.rst:226 +#: library/compiler.rst:226 msgid ":class:`AssAttr`" msgstr "" # b6724be2a05745beb6329afcf0710326 -#: ../src/Doc/library/compiler.rst:226 +#: library/compiler.rst:226 msgid "*attribute as target of assignment*" msgstr "" @@ -15893,31 +15966,28 @@ msgstr "" # a5341f3d57514da6b2a6f5257afc96d9 # 336afeb1963c436785234b54b0cb18b4 # bad35ed167354eec8e9c1e6bad2f7a1d -#: ../src/Doc/library/compiler.rst:229 ../src/Doc/library/compiler.rst:254 -#: ../src/Doc/library/compiler.rst:260 ../src/Doc/library/compiler.rst:262 -#: ../src/Doc/library/compiler.rst:289 ../src/Doc/library/compiler.rst:302 -#: ../src/Doc/library/compiler.rst:312 ../src/Doc/library/compiler.rst:360 -#: ../src/Doc/library/compiler.rst:364 ../src/Doc/library/compiler.rst:376 -#: ../src/Doc/library/compiler.rst:380 ../src/Doc/library/compiler.rst:396 -#: ../src/Doc/library/compiler.rst:424 ../src/Doc/library/compiler.rst:454 -#: ../src/Doc/library/compiler.rst:470 ../src/Doc/library/compiler.rst:488 -#: ../src/Doc/library/compiler.rst:490 ../src/Doc/library/compiler.rst:498 +#: library/compiler.rst:229 library/compiler.rst:254 library/compiler.rst:260 +#: library/compiler.rst:262 library/compiler.rst:289 library/compiler.rst:302 +#: library/compiler.rst:312 library/compiler.rst:360 library/compiler.rst:364 +#: library/compiler.rst:376 library/compiler.rst:380 library/compiler.rst:396 +#: library/compiler.rst:424 library/compiler.rst:454 library/compiler.rst:470 +#: library/compiler.rst:488 library/compiler.rst:490 library/compiler.rst:498 msgid ":attr:`expr`" msgstr "" # fb143e4d8af940a293202b90c5d11e03 -#: ../src/Doc/library/compiler.rst:229 +#: library/compiler.rst:229 msgid "expression on the left-hand side of the dot" msgstr "" # 4db7b1ad53614a94ab7c70e88a0cdf27 # 5814ecba840146fd9109529980ccd6d4 -#: ../src/Doc/library/compiler.rst:232 ../src/Doc/library/compiler.rst:366 +#: library/compiler.rst:232 library/compiler.rst:366 msgid ":attr:`attrname`" msgstr "" # d50baa9100d74aa49cb79da949d533ee -#: ../src/Doc/library/compiler.rst:232 +#: library/compiler.rst:232 msgid "the attribute name, a string" msgstr "" @@ -15927,30 +15997,29 @@ msgstr "" # 754e5ef4a2a24433a688ab7b987b0ec8 # ec54cd339e3149f3a6517dfcd11522af # 2544d2169e2d4729835d99e756f374bb -#: ../src/Doc/library/compiler.rst:234 ../src/Doc/library/compiler.rst:241 -#: ../src/Doc/library/compiler.rst:343 ../src/Doc/library/compiler.rst:386 -#: ../src/Doc/library/compiler.rst:456 ../src/Doc/library/compiler.rst:472 +#: library/compiler.rst:234 library/compiler.rst:241 library/compiler.rst:343 +#: library/compiler.rst:386 library/compiler.rst:456 library/compiler.rst:472 msgid ":attr:`flags`" msgstr "" # dfc6b9e6837b4c8a966e2addec04a78d # 19a4cd931a8e495f9ea3a3f59c17337f -#: ../src/Doc/library/compiler.rst:234 ../src/Doc/library/compiler.rst:241 +#: library/compiler.rst:234 library/compiler.rst:241 msgid "XXX" msgstr "" # 37f50a2123424b6397418e9c35997dbd -#: ../src/Doc/library/compiler.rst:236 +#: library/compiler.rst:236 msgid ":class:`AssList`" msgstr "" # 30da3c9d1aeb49588f3181a1a9b17162 -#: ../src/Doc/library/compiler.rst:236 +#: library/compiler.rst:236 msgid "list of list elements being assigned to" msgstr "" # 3937e576b15644d698521b0eed1ecb05 -#: ../src/Doc/library/compiler.rst:239 +#: library/compiler.rst:239 msgid ":class:`AssName`" msgstr "" @@ -15959,29 +16028,28 @@ msgstr "" # c5a72ae2c45640c39889e563230c2e64 # b5d07f9a194547d0bba6060356c0decf # 69437476b4d74c8c8bbf7e51dd61178f -#: ../src/Doc/library/compiler.rst:239 ../src/Doc/library/compiler.rst:280 -#: ../src/Doc/library/compiler.rst:336 ../src/Doc/library/compiler.rst:378 -#: ../src/Doc/library/compiler.rst:422 +#: library/compiler.rst:239 library/compiler.rst:280 library/compiler.rst:336 +#: library/compiler.rst:378 library/compiler.rst:422 msgid ":attr:`name`" msgstr "" # 512c1d3c0e17461c9f53608c2475517f -#: ../src/Doc/library/compiler.rst:239 +#: library/compiler.rst:239 msgid "name being assigned to" msgstr "" # 9da0902169044a249b914f307e6cdc1d -#: ../src/Doc/library/compiler.rst:243 +#: library/compiler.rst:243 msgid ":class:`AssTuple`" msgstr "" # ac9785bdbdfb42a7887cc139e1c851ed -#: ../src/Doc/library/compiler.rst:243 +#: library/compiler.rst:243 msgid "list of tuple elements being assigned to" msgstr "" # ef9d8407713344dcbbdced1f3bcd7222 -#: ../src/Doc/library/compiler.rst:246 +#: library/compiler.rst:246 msgid ":class:`Assert`" msgstr "" @@ -15989,155 +16057,152 @@ msgstr "" # 9f6e7d24c7494c558e6c569d0453a745 # 7f053ef5e845421d98d08cc55803681d # 2a98500da82d423d83b87e8f21a04a57 -#: ../src/Doc/library/compiler.rst:246 ../src/Doc/library/compiler.rst:358 -#: ../src/Doc/library/compiler.rst:406 ../src/Doc/library/compiler.rst:492 +#: library/compiler.rst:246 library/compiler.rst:358 library/compiler.rst:406 +#: library/compiler.rst:492 msgid ":attr:`test`" msgstr "" # b15ff66914284d66adccf20be5051275 -#: ../src/Doc/library/compiler.rst:246 +#: library/compiler.rst:246 msgid "the expression to be tested" msgstr "" # 341020318b64489ca738bd484efb6a1e -#: ../src/Doc/library/compiler.rst:248 +#: library/compiler.rst:248 msgid ":attr:`fail`" msgstr "" # d9671835c576465ba9d4ed8b9252927d -#: ../src/Doc/library/compiler.rst:248 +#: library/compiler.rst:248 msgid "the value of the :exc:`AssertionError`" msgstr "" # 954cc1486bcb4b7f82bb1b75135b865a -#: ../src/Doc/library/compiler.rst:251 +#: library/compiler.rst:251 msgid ":class:`Assign`" msgstr "" # 246a4d0183254d92819bf721bfe4ce1d -#: ../src/Doc/library/compiler.rst:251 +#: library/compiler.rst:251 msgid "a list of assignment targets, one per equal sign" msgstr "" # 94f813d1cf534932a8879bd3ee410d57 -#: ../src/Doc/library/compiler.rst:254 +#: library/compiler.rst:254 msgid "the value being assigned" msgstr "" # 98d2d7effbf24f98a35cf364f69df5aa -#: ../src/Doc/library/compiler.rst:256 +#: library/compiler.rst:256 msgid ":class:`AugAssign`" msgstr "" -#: ../src/Doc/library/compiler.rst:256 ../src/Doc/library/compiler.rst:272 -#: ../src/Doc/library/compiler.rst:310 ../src/Doc/library/compiler.rst:415 -#: ../src/Doc/library/uuid.rst:81 +#: library/compiler.rst:256 library/compiler.rst:272 library/compiler.rst:310 +#: library/compiler.rst:415 library/uuid.rst:81 msgid ":attr:`node`" msgstr "" # baab543a1ce54aef8f0bf6634e87090d -#: ../src/Doc/library/compiler.rst:258 +#: library/compiler.rst:258 msgid ":attr:`op`" msgstr "" # 7cb2611ef2744ffbb8177559d8218d49 -#: ../src/Doc/library/compiler.rst:262 +#: library/compiler.rst:262 msgid ":class:`Backquote`" msgstr "" # b68cdfdf1bfc454290a2da14fd9c8bfc -#: ../src/Doc/library/compiler.rst:264 +#: library/compiler.rst:264 msgid ":class:`Bitand`" msgstr "" # 11f7c2e4c8cf4271bb668b510b9da828 -#: ../src/Doc/library/compiler.rst:266 +#: library/compiler.rst:266 msgid ":class:`Bitor`" msgstr "" # 92ead54773d144a3b1c8f30e6a516917 -#: ../src/Doc/library/compiler.rst:268 +#: library/compiler.rst:268 msgid ":class:`Bitxor`" msgstr "" # 9f671c6ce67f41cbb90fdd0e05f27666 -#: ../src/Doc/library/compiler.rst:270 +#: library/compiler.rst:270 msgid ":class:`Break`" msgstr "" # 0dd9eaaede4f48949fc44ac97e0ccd11 -#: ../src/Doc/library/compiler.rst:272 +#: library/compiler.rst:272 msgid ":class:`CallFunc`" msgstr "" # 942c3672dff64e2b954998c60679bf1a -#: ../src/Doc/library/compiler.rst:272 +#: library/compiler.rst:272 msgid "expression for the callee" msgstr "" # 9e60e1ac5089486495b4892981de33b2 -#: ../src/Doc/library/compiler.rst:274 +#: library/compiler.rst:274 msgid ":attr:`args`" msgstr "" # 7d46c3cc1dd44ff9bc5e5c3f0987ea00 -#: ../src/Doc/library/compiler.rst:274 +#: library/compiler.rst:274 msgid "a list of arguments" msgstr "" # 37f197e7c7884ddeb917b11f93c3c686 -#: ../src/Doc/library/compiler.rst:276 +#: library/compiler.rst:276 msgid ":attr:`star_args`" msgstr "" # 4196590a41f84b6bb296e046de0b3d6b -#: ../src/Doc/library/compiler.rst:276 +#: library/compiler.rst:276 msgid "the extended \\*-arg value" msgstr "" # 8811fb3c14134e9989b987af147afbd2 -#: ../src/Doc/library/compiler.rst:278 +#: library/compiler.rst:278 msgid ":attr:`dstar_args`" msgstr "" # b5310c39537c4a15afb798e8197c1203 -#: ../src/Doc/library/compiler.rst:278 +#: library/compiler.rst:278 msgid "the extended \\*\\*-arg value" msgstr "" # 50b7d08d9bf741fbb5634fbcc6e01357 -#: ../src/Doc/library/compiler.rst:280 +#: library/compiler.rst:280 msgid ":class:`Class`" msgstr "" # ecf5c9352f8f4c6ea1ad56ad33180fec -#: ../src/Doc/library/compiler.rst:280 +#: library/compiler.rst:280 msgid "the name of the class, a string" msgstr "" # 0ddd13f738bd47edb8cdd06ed4edecb9 -#: ../src/Doc/library/compiler.rst:282 +#: library/compiler.rst:282 msgid ":attr:`bases`" msgstr "" # 84ac5f37626d4c71a0c746dc4e58bab1 -#: ../src/Doc/library/compiler.rst:282 +#: library/compiler.rst:282 msgid "a list of base classes" msgstr "" # abac638091734edab822f47c38742531 # 60d31adad1104cd293c43487fc45205f # 5c4facf1d55e40b7b3051e2b05e4d9c5 -#: ../src/Doc/library/compiler.rst:284 ../src/Doc/library/compiler.rst:345 -#: ../src/Doc/library/compiler.rst:412 +#: library/compiler.rst:284 library/compiler.rst:345 library/compiler.rst:412 msgid ":attr:`doc`" msgstr "" # dfb01a4eab0c44c4bd0bd3f13c243eb5 # 1ca051f9a8c14b88b8b08daec1115f4d # 27f193d6cdbc42e5979120a41862faca -#: ../src/Doc/library/compiler.rst:284 ../src/Doc/library/compiler.rst:345 -#: ../src/Doc/library/compiler.rst:412 +#: library/compiler.rst:284 library/compiler.rst:345 library/compiler.rst:412 msgid "doc string, a string or ``None``" msgstr "" @@ -16145,120 +16210,118 @@ msgstr "" # 581455a5e48741329c7a95297be4f7e5 # a4eed730ac964e1b91f14bd9681a52c4 # 9c17f1850ad94719bd5e1272c9105fb1 -#: ../src/Doc/library/compiler.rst:287 ../src/Doc/library/compiler.rst:348 -#: ../src/Doc/library/compiler.rst:350 ../src/Doc/library/compiler.rst:388 +#: library/compiler.rst:287 library/compiler.rst:348 library/compiler.rst:350 +#: library/compiler.rst:388 msgid ":attr:`code`" msgstr "" # 18ff2f1fceea473bbf3c410e2bd801d3 -#: ../src/Doc/library/compiler.rst:287 +#: library/compiler.rst:287 msgid "the body of the class statement" msgstr "" # abedd16e57ce476db95764c18a2431d0 -#: ../src/Doc/library/compiler.rst:289 +#: library/compiler.rst:289 msgid ":class:`Compare`" msgstr "" # df2af2185cc34a448e032f4bb77de5e4 -#: ../src/Doc/library/compiler.rst:291 +#: library/compiler.rst:291 msgid ":attr:`ops`" msgstr "" # 005974022fa24fa58bf286d633c8cfd6 -#: ../src/Doc/library/compiler.rst:293 +#: library/compiler.rst:293 msgid ":class:`Const`" msgstr "" # 7a4c3966153d4e5b80e29931643d77c4 # cdb061cb216f4880b6d53abfee5448da # b24ce06f0a7c4baaa1ba6eb94478d9ec -#: ../src/Doc/library/compiler.rst:293 ../src/Doc/library/compiler.rst:448 -#: ../src/Doc/library/compiler.rst:504 +#: library/compiler.rst:293 library/compiler.rst:448 library/compiler.rst:504 msgid ":attr:`value`" msgstr "" # 555c70c11b1947a1828f5b1a2f4d46bc -#: ../src/Doc/library/compiler.rst:295 +#: library/compiler.rst:295 msgid ":class:`Continue`" msgstr "" # 0d8af4ad369b4408aedae0bcfa076bef -#: ../src/Doc/library/compiler.rst:297 +#: library/compiler.rst:297 msgid ":class:`Decorators`" msgstr "" # 0cec2b6cb8eb4a2fa0e633a0b2061738 -#: ../src/Doc/library/compiler.rst:297 +#: library/compiler.rst:297 msgid "List of function decorator expressions" msgstr "" # 479726f5ea2548b9a61645ffa549a5dc -#: ../src/Doc/library/compiler.rst:300 +#: library/compiler.rst:300 msgid ":class:`Dict`" msgstr "" # 4b24fda6879d45809eca2cf2a8c43eb5 -#: ../src/Doc/library/compiler.rst:300 +#: library/compiler.rst:300 msgid ":attr:`items`" msgstr "" # 467be1b8d4024b889f078a181890d3c0 -#: ../src/Doc/library/compiler.rst:302 +#: library/compiler.rst:302 msgid ":class:`Discard`" msgstr "" # 7f1ae8ee15c3417291d4926902ec9c5c -#: ../src/Doc/library/compiler.rst:304 +#: library/compiler.rst:304 msgid ":class:`Div`" msgstr "" # cdf756eae266492ea377dceb232687ae -#: ../src/Doc/library/compiler.rst:308 +#: library/compiler.rst:308 msgid ":class:`Ellipsis`" msgstr "" # ecad3f904d7049d7bdfd44d4457e3fbf -#: ../src/Doc/library/compiler.rst:310 +#: library/compiler.rst:310 msgid ":class:`Expression`" msgstr "" # eb5c951cf89048899651283211648c92 -#: ../src/Doc/library/compiler.rst:312 +#: library/compiler.rst:312 msgid ":class:`Exec`" msgstr "" # 62f59b2246e7410bb82ec7c0d1ebd71d -#: ../src/Doc/library/compiler.rst:314 +#: library/compiler.rst:314 msgid ":attr:`locals`" msgstr "" # 80e8c8d1e9ee40119ea1421ad28822eb -#: ../src/Doc/library/compiler.rst:316 +#: library/compiler.rst:316 msgid ":attr:`globals`" msgstr "" # 5d942f7bae764ce0b79976ba3d929e19 -#: ../src/Doc/library/compiler.rst:318 +#: library/compiler.rst:318 msgid ":class:`FloorDiv`" msgstr "" # c864d7997060489bb2cc92279a441749 -#: ../src/Doc/library/compiler.rst:322 +#: library/compiler.rst:322 msgid ":class:`For`" msgstr "" # f2369237d4a041d4b60b106b253d31df # db0f64ec3414408dad532fd6be01d406 # 2a27c7a40a1e422e9d490171d178f0e4 -#: ../src/Doc/library/compiler.rst:322 ../src/Doc/library/compiler.rst:352 -#: ../src/Doc/library/compiler.rst:400 +#: library/compiler.rst:322 library/compiler.rst:352 library/compiler.rst:400 msgid ":attr:`assign`" msgstr "" # 9dd1ea5b5cef4beb8de8efbcacaa4bd5 # f20a918e0c8e406b8e75539dc7771fc7 -#: ../src/Doc/library/compiler.rst:324 ../src/Doc/library/compiler.rst:402 +#: library/compiler.rst:324 library/compiler.rst:402 msgid ":attr:`list`" msgstr "" @@ -16267,9 +16330,8 @@ msgstr "" # 000ee5f88c4648308e8b2dd639b7202f # 384395e54219463a8aa4ecb6c85296e1 # e428bbf1b7e14b6cb8ad4c1c97dc0a40 -#: ../src/Doc/library/compiler.rst:326 ../src/Doc/library/compiler.rst:476 -#: ../src/Doc/library/compiler.rst:482 ../src/Doc/library/compiler.rst:494 -#: ../src/Doc/library/compiler.rst:502 +#: library/compiler.rst:326 library/compiler.rst:476 library/compiler.rst:482 +#: library/compiler.rst:494 library/compiler.rst:502 msgid ":attr:`body`" msgstr "" @@ -16277,381 +16339,380 @@ msgstr "" # da5c21c180694e5a94c66a2d234b2f10 # a0f1a66ff1ec4346a8d1315d4914b57c # 7a9c298dadce48e98f3f0bccdb61df6a -#: ../src/Doc/library/compiler.rst:328 ../src/Doc/library/compiler.rst:372 -#: ../src/Doc/library/compiler.rst:480 ../src/Doc/library/compiler.rst:496 +#: library/compiler.rst:328 library/compiler.rst:372 library/compiler.rst:480 +#: library/compiler.rst:496 msgid ":attr:`else_`" msgstr "" # 83ca5f38796c4e51834187c9dd1a7e09 -#: ../src/Doc/library/compiler.rst:330 +#: library/compiler.rst:330 msgid ":class:`From`" msgstr "" # 7fdce0d720d945fc8cab309565a328b0 -#: ../src/Doc/library/compiler.rst:330 +#: library/compiler.rst:330 msgid ":attr:`modname`" msgstr "" # d825094010ec4b7f9bca790c640f8eab # 160dd2b970d9456aac6b674323b36874 # 0ddd2ce7bc9647c5b03cd30af6c87eb9 -#: ../src/Doc/library/compiler.rst:332 ../src/Doc/library/compiler.rst:368 -#: ../src/Doc/library/compiler.rst:374 +#: library/compiler.rst:332 library/compiler.rst:368 library/compiler.rst:374 msgid ":attr:`names`" msgstr "" # fdd390da37e9487aa060f0a3261a7d6c -#: ../src/Doc/library/compiler.rst:334 +#: library/compiler.rst:334 msgid ":class:`Function`" msgstr "" # c731cbe4739a4787a57559d53b48d092 -#: ../src/Doc/library/compiler.rst:334 +#: library/compiler.rst:334 msgid ":attr:`decorators`" msgstr "" # 8a8b45c23fc14fdaa9f2975c5c5d86da -#: ../src/Doc/library/compiler.rst:334 +#: library/compiler.rst:334 msgid ":class:`Decorators` or ``None``" msgstr "" # 41ed3753243443ce8836ed89b608c249 -#: ../src/Doc/library/compiler.rst:336 +#: library/compiler.rst:336 msgid "name used in def, a string" msgstr "" # 6f01b00b0cdc44818a6f5bc911620c0c # 0055d67d3b154a68b954a6d31d1bfccd -#: ../src/Doc/library/compiler.rst:338 ../src/Doc/library/compiler.rst:382 +#: library/compiler.rst:338 library/compiler.rst:382 msgid ":attr:`argnames`" msgstr "" # fa3dfeb1329e4d4791f18bb4de967992 -#: ../src/Doc/library/compiler.rst:338 +#: library/compiler.rst:338 msgid "list of argument names, as strings" msgstr "" # b46350e6f08743d8ba87a8c8d430320d # 4dbd394a2c414cd7a1a0be2daf74e94f -#: ../src/Doc/library/compiler.rst:341 ../src/Doc/library/compiler.rst:384 +#: library/compiler.rst:341 library/compiler.rst:384 msgid ":attr:`defaults`" msgstr "" # 1cb1ea90dc984fc496f7699ade5f21a3 -#: ../src/Doc/library/compiler.rst:341 +#: library/compiler.rst:341 msgid "list of default values" msgstr "" # fec5aefc4c584ea884b567b9392d23bd -#: ../src/Doc/library/compiler.rst:343 +#: library/compiler.rst:343 msgid "xxx" msgstr "" # dfe19db72c494f1384df9091d7a6ae38 -#: ../src/Doc/library/compiler.rst:348 +#: library/compiler.rst:348 msgid "the body of the function" msgstr "" # 807c6e803bb842cbaa6e9f8e5610241a -#: ../src/Doc/library/compiler.rst:350 +#: library/compiler.rst:350 msgid ":class:`GenExpr`" msgstr "" # bde5800c4e514d39ba45b8ed9b44ed35 -#: ../src/Doc/library/compiler.rst:352 +#: library/compiler.rst:352 msgid ":class:`GenExprFor`" msgstr "" # 0be413848f5448009ec9c0310a0185f3 -#: ../src/Doc/library/compiler.rst:354 +#: library/compiler.rst:354 msgid ":attr:`iter`" msgstr "" # cd48f0daf8a848188f12faea92d16556 # acbf83d8785f420d9901e53c860b7828 -#: ../src/Doc/library/compiler.rst:356 ../src/Doc/library/compiler.rst:404 +#: library/compiler.rst:356 library/compiler.rst:404 msgid ":attr:`ifs`" msgstr "" # 807e1dfdca0946deabb267f17b13659b -#: ../src/Doc/library/compiler.rst:358 +#: library/compiler.rst:358 msgid ":class:`GenExprIf`" msgstr "" # ec4218b2662247bfa60fcbb5141c2de8 -#: ../src/Doc/library/compiler.rst:360 +#: library/compiler.rst:360 msgid ":class:`GenExprInner`" msgstr "" # 958d57bf46ea446581393440f3a1a7df # 4389ba705dce44dbb39970fb7b504307 -#: ../src/Doc/library/compiler.rst:362 ../src/Doc/library/compiler.rst:398 +#: library/compiler.rst:362 library/compiler.rst:398 msgid ":attr:`quals`" msgstr "" # e2336fd689f043cb951318f2e650b5ff -#: ../src/Doc/library/compiler.rst:364 +#: library/compiler.rst:364 msgid ":class:`Getattr`" msgstr "" # 35756803ee994473b95d06c149a408d8 -#: ../src/Doc/library/compiler.rst:368 +#: library/compiler.rst:368 msgid ":class:`Global`" msgstr "" # cfd9b77676924c90a9b8becd2833d131 -#: ../src/Doc/library/compiler.rst:370 +#: library/compiler.rst:370 msgid ":class:`If`" msgstr "" # 57f1927bb642407bb345620fe7470402 -#: ../src/Doc/library/compiler.rst:370 +#: library/compiler.rst:370 msgid ":attr:`tests`" msgstr "" # b834f45ab6574ff0ab7eb011c018e1e3 -#: ../src/Doc/library/compiler.rst:374 +#: library/compiler.rst:374 msgid ":class:`Import`" msgstr "" # 7e662bc908004d47aff6e2e7cb266a08 -#: ../src/Doc/library/compiler.rst:376 +#: library/compiler.rst:376 msgid ":class:`Invert`" msgstr "" # ffd2edf9de7b478b95b707c6703304be -#: ../src/Doc/library/compiler.rst:378 +#: library/compiler.rst:378 msgid ":class:`Keyword`" msgstr "" # 1a654fa104714686898ba221d337f0b3 -#: ../src/Doc/library/compiler.rst:382 +#: library/compiler.rst:382 msgid ":class:`Lambda`" msgstr "" # f15ba54459fd499391c1fbc787ba3e04 -#: ../src/Doc/library/compiler.rst:390 +#: library/compiler.rst:390 msgid ":class:`LeftShift`" msgstr "" # b7b7a83fb2fe49c6b45ae2aac030c736 -#: ../src/Doc/library/compiler.rst:394 +#: library/compiler.rst:394 msgid ":class:`List`" msgstr "" # c897d03a4a4543e497bd0fca48ce0cd5 -#: ../src/Doc/library/compiler.rst:396 +#: library/compiler.rst:396 msgid ":class:`ListComp`" msgstr "" # 3f360e88a4314f2ba555ec48e4dd50d6 -#: ../src/Doc/library/compiler.rst:400 +#: library/compiler.rst:400 msgid ":class:`ListCompFor`" msgstr "" # 336ffd651a2e4d1fb9887f0a83c40ada -#: ../src/Doc/library/compiler.rst:406 +#: library/compiler.rst:406 msgid ":class:`ListCompIf`" msgstr "" # ab2c68da9e7d423cb5b9f7354188ea0d -#: ../src/Doc/library/compiler.rst:408 +#: library/compiler.rst:408 msgid ":class:`Mod`" msgstr "" # 17fd9a52e1b24cbbade4e9747e2257a4 -#: ../src/Doc/library/compiler.rst:412 +#: library/compiler.rst:412 msgid ":class:`Module`" msgstr "" # 05ba5d58e85a449da89c47f17058c444 -#: ../src/Doc/library/compiler.rst:415 +#: library/compiler.rst:415 msgid "body of the module, a :class:`Stmt`" msgstr "" # 94993f7bd7444b0e8b9d953f842e0454 -#: ../src/Doc/library/compiler.rst:418 +#: library/compiler.rst:418 msgid ":class:`Mul`" msgstr "" # 3768fd39718e4226a23c2a4e3a1b1ede -#: ../src/Doc/library/compiler.rst:422 +#: library/compiler.rst:422 msgid ":class:`Name`" msgstr "" # aae037fbe5864cc4ade777c1966766eb -#: ../src/Doc/library/compiler.rst:424 +#: library/compiler.rst:424 msgid ":class:`Not`" msgstr "" # 5f84d8a1585f4c34b2e101c270e31ba3 -#: ../src/Doc/library/compiler.rst:426 +#: library/compiler.rst:426 msgid ":class:`Or`" msgstr "" # bd4afbaffe254aaba2e846032aae0586 -#: ../src/Doc/library/compiler.rst:428 +#: library/compiler.rst:428 msgid ":class:`Pass`" msgstr "" # 4e058f851134427e83a01f644570a381 -#: ../src/Doc/library/compiler.rst:430 +#: library/compiler.rst:430 msgid ":class:`Power`" msgstr "" # f15fe076fced42d2b6271cd7388df9b2 -#: ../src/Doc/library/compiler.rst:434 +#: library/compiler.rst:434 msgid ":class:`Print`" msgstr "" # 5250337bb4784bc29d8f81cc29d61cba # e344d201bcc34ca78d7a23e315a5e6f7 -#: ../src/Doc/library/compiler.rst:436 ../src/Doc/library/compiler.rst:440 +#: library/compiler.rst:436 library/compiler.rst:440 msgid ":attr:`dest`" msgstr "" # 805416fd33b3460eadc097d7f4bc1c47 -#: ../src/Doc/library/compiler.rst:438 +#: library/compiler.rst:438 msgid ":class:`Printnl`" msgstr "" # 74c39f8ff2a541fe922091f4ca467ece -#: ../src/Doc/library/compiler.rst:442 +#: library/compiler.rst:442 msgid ":class:`Raise`" msgstr "" # 38cf3f680c9e4fa0a03c4adda4262dd0 -#: ../src/Doc/library/compiler.rst:442 +#: library/compiler.rst:442 msgid ":attr:`expr1`" msgstr "" # c8e86857e739496eb27eb95805db6cc2 -#: ../src/Doc/library/compiler.rst:444 +#: library/compiler.rst:444 msgid ":attr:`expr2`" msgstr "" # 4b11a477dfa44527835073f6c9ae60c5 -#: ../src/Doc/library/compiler.rst:446 +#: library/compiler.rst:446 msgid ":attr:`expr3`" msgstr "" # 1a009ab26f824a9a977e71e12497c234 -#: ../src/Doc/library/compiler.rst:448 +#: library/compiler.rst:448 msgid ":class:`Return`" msgstr "" # 5598d64d149b4d019296ede76dcbfd17 -#: ../src/Doc/library/compiler.rst:450 +#: library/compiler.rst:450 msgid ":class:`RightShift`" msgstr "" # 4b101cf399fe4234a30ad0700c15865c -#: ../src/Doc/library/compiler.rst:454 +#: library/compiler.rst:454 msgid ":class:`Slice`" msgstr "" # 7230a1c25cf74225b5f093b67fac865b -#: ../src/Doc/library/compiler.rst:458 +#: library/compiler.rst:458 msgid ":attr:`lower`" msgstr "" # cbadc5a72d87480bb337e0a162f4bee2 -#: ../src/Doc/library/compiler.rst:460 +#: library/compiler.rst:460 msgid ":attr:`upper`" msgstr "" # 4c8e7755af964b4886b28fb420bbb90e -#: ../src/Doc/library/compiler.rst:462 +#: library/compiler.rst:462 msgid ":class:`Sliceobj`" msgstr "" # fe3eea3ac5c647b59c44e0a6d61ff260 -#: ../src/Doc/library/compiler.rst:462 +#: library/compiler.rst:462 msgid "list of statements" msgstr "" # 47917b0e93984466b8e3377fa059c8c6 -#: ../src/Doc/library/compiler.rst:464 +#: library/compiler.rst:464 msgid ":class:`Stmt`" msgstr "" # e4e5907173dc4aafb6f33bcddf5571a5 -#: ../src/Doc/library/compiler.rst:466 +#: library/compiler.rst:466 msgid ":class:`Sub`" msgstr "" # 15c935dcf27c4b01ab45225635abe771 -#: ../src/Doc/library/compiler.rst:470 +#: library/compiler.rst:470 msgid ":class:`Subscript`" msgstr "" # 455aac37f24645d3b6c1e7f5eb376462 -#: ../src/Doc/library/compiler.rst:474 +#: library/compiler.rst:474 msgid ":attr:`subs`" msgstr "" # ceada4702a0c4392a515edc61af1a461 -#: ../src/Doc/library/compiler.rst:476 +#: library/compiler.rst:476 msgid ":class:`TryExcept`" msgstr "" # 187824d9eab246cc9b68dc04534677ff -#: ../src/Doc/library/compiler.rst:478 +#: library/compiler.rst:478 msgid ":attr:`handlers`" msgstr "" # 79d9bd90bc2b4c5b830e7cce0fe4b483 -#: ../src/Doc/library/compiler.rst:482 +#: library/compiler.rst:482 msgid ":class:`TryFinally`" msgstr "" # 9071ae75432a47f3bb2eaee36c676237 -#: ../src/Doc/library/compiler.rst:484 +#: library/compiler.rst:484 msgid ":attr:`final`" msgstr "" # 26464c8340994755a6ff4f5d79d736eb -#: ../src/Doc/library/compiler.rst:486 +#: library/compiler.rst:486 msgid ":class:`Tuple`" msgstr "" # 210db8b36cb14d72a55164a5ad630144 -#: ../src/Doc/library/compiler.rst:488 +#: library/compiler.rst:488 msgid ":class:`UnaryAdd`" msgstr "" # 9a8eed3380c44be0a3ef70049b4971e5 -#: ../src/Doc/library/compiler.rst:490 +#: library/compiler.rst:490 msgid ":class:`UnarySub`" msgstr "" # b1d615ba30414bbbb8438b73c79e4018 -#: ../src/Doc/library/compiler.rst:492 +#: library/compiler.rst:492 msgid ":class:`While`" msgstr "" # b4323a2c464043459def004e21461565 -#: ../src/Doc/library/compiler.rst:498 +#: library/compiler.rst:498 msgid ":class:`With`" msgstr "" # af890eb28c094d42b7a0db8c575f54b9 -#: ../src/Doc/library/compiler.rst:500 +#: library/compiler.rst:500 msgid ":attr:`vars`" msgstr "" # a9a734918d2842d687d5df86e840edce -#: ../src/Doc/library/compiler.rst:504 +#: library/compiler.rst:504 msgid ":class:`Yield`" msgstr "" # adf08e8c6dd2462a83fc97969865ca9f -#: ../src/Doc/library/compiler.rst:509 +#: library/compiler.rst:509 msgid "Assignment nodes" msgstr "" # cc3d1fc53a3a40418ccaa68a131acc4f -#: ../src/Doc/library/compiler.rst:511 +#: library/compiler.rst:511 msgid "" "There is a collection of nodes used to represent assignments. Each " "assignment statement in the source code becomes a single :class:`Assign` " @@ -16663,7 +16724,7 @@ msgid "" msgstr "" # 41207357adb74b6c8799084d1db281b3 -#: ../src/Doc/library/compiler.rst:518 +#: library/compiler.rst:518 msgid "" "Each target assignment node will describe the kind of object being assigned " "to: :class:`AssName` for a simple name, e.g. ``a = 1``. :class:`AssAttr` for " @@ -16673,7 +16734,7 @@ msgid "" msgstr "" # 6e11be6bf7ad41628c7c999d83216378 -#: ../src/Doc/library/compiler.rst:523 +#: library/compiler.rst:523 msgid "" "The target assignment nodes also have a :attr:`flags` attribute that " "indicates whether the node is being used for assignment or in a delete " @@ -16682,7 +16743,7 @@ msgid "" msgstr "" # a42a561d43ae405082f80cdedc4f5fae -#: ../src/Doc/library/compiler.rst:528 +#: library/compiler.rst:528 msgid "" "When an expression contains several attribute references, an assignment or " "delete statement will contain only one :class:`AssAttr` node -- for the " @@ -16691,23 +16752,19 @@ msgid "" "class:`AssAttr` instance." msgstr "" -#: ../src/Doc/library/compiler.rst:536 ../src/Doc/library/configparser.rst:438 -#: ../src/Doc/library/cookielib.rst:740 ../src/Doc/library/csv.rst:454 -#: ../src/Doc/library/htmlparser.rst:242 ../src/Doc/library/httplib.rst:566 -#: ../src/Doc/library/imp.rst:287 ../src/Doc/library/imputil.rst:104 -#: ../src/Doc/library/mailbox.rst:1639 -#: ../src/Doc/library/multiprocessing.rst:2302 -#: ../src/Doc/library/plistlib.rst:111 ../src/Doc/library/re.rst:997 -#: ../src/Doc/library/socketserver.rst:339 ../src/Doc/library/ssl.rst:1358 -#: ../src/Doc/library/struct.rst:294 ../src/Doc/library/syslog.rst:86 -#: ../src/Doc/library/tarfile.rst:641 ../src/Doc/library/timeit.rst:242 -#: ../src/Doc/library/urllib.rst:479 ../src/Doc/library/urllib2.rst:930 -#: ../src/Doc/library/wsgiref.rst:704 ../src/Doc/library/zipimport.rst:149 +#: library/compiler.rst:536 library/configparser.rst:438 +#: library/cookielib.rst:740 library/csv.rst:479 library/htmlparser.rst:242 +#: library/httplib.rst:589 library/imp.rst:287 library/imputil.rst:104 +#: library/mailbox.rst:1639 library/multiprocessing.rst:2445 +#: library/plistlib.rst:111 library/re.rst:1002 library/socketserver.rst:347 +#: library/ssl.rst:1404 library/struct.rst:294 library/syslog.rst:86 +#: library/tarfile.rst:641 library/timeit.rst:242 library/urllib.rst:494 +#: library/urllib2.rst:951 library/wsgiref.rst:704 library/zipimport.rst:149 msgid "Examples" msgstr "" # 291bb51f244c4ae3a15d814c5491fc4d -#: ../src/Doc/library/compiler.rst:538 +#: library/compiler.rst:538 msgid "" "This section shows several simple examples of ASTs for Python source code. " "The examples demonstrate how to use the :func:`parse` function, what the " @@ -16715,14 +16772,14 @@ msgid "" msgstr "" # 30ee5f7f91c34c349e5877e22394957c -#: ../src/Doc/library/compiler.rst:542 +#: library/compiler.rst:542 msgid "" "The first module defines a single function. Assume it is stored in :file:" "`doublelib.py`. ::" msgstr "" # 7e7bb2ef029842ce809d89b2fffa5275 -#: ../src/Doc/library/compiler.rst:554 +#: library/compiler.rst:554 msgid "" "In the interactive interpreter session below, I have reformatted the long " "AST reprs for readability. The AST reprs use unqualified class names. If " @@ -16731,12 +16788,12 @@ msgid "" msgstr "" # 6bc1ea7ea59d4287a7f93b80483d76a9 -#: ../src/Doc/library/compiler.rst:588 +#: library/compiler.rst:588 msgid "Using Visitors to Walk ASTs" msgstr "" # 66fc4436b87a4daa980b04c5b3207313 -#: ../src/Doc/library/compiler.rst:593 +#: library/compiler.rst:593 msgid "" "The visitor pattern is ... The :mod:`compiler` package uses a variant on " "the visitor pattern that takes advantage of Python's introspection features " @@ -16744,7 +16801,7 @@ msgid "" msgstr "" # 68b2728a82294805bd9fda26d6b18814 -#: ../src/Doc/library/compiler.rst:597 +#: library/compiler.rst:597 msgid "" "The classes being visited do not need to be programmed to accept visitors. " "The visitor need only define visit methods for classes it is specifically " @@ -16752,12 +16809,12 @@ msgid "" msgstr "" # 4edbb0f75271443d988e034d560f333b -#: ../src/Doc/library/compiler.rst:601 +#: library/compiler.rst:601 msgid "XXX The magic :meth:`visit` method for visitors." msgstr "" # 8316dcd59e97470cbc8c4eb264eae458 -#: ../src/Doc/library/compiler.rst:609 +#: library/compiler.rst:609 msgid "" "The :class:`ASTVisitor` is responsible for walking over the tree in the " "correct order. A walk begins with a call to :meth:`preorder`. For each " @@ -16768,7 +16825,7 @@ msgid "" msgstr "" # 6206ad5e1a174b15b7810c4b514253d0 -#: ../src/Doc/library/compiler.rst:616 +#: library/compiler.rst:616 msgid "" "The visitor method for a particular node type can control how child nodes " "are visited during the walk. The :class:`ASTVisitor` modifies the visitor " @@ -16778,22 +16835,22 @@ msgid "" msgstr "" # 0cf263904af342b6bf18fc1e9aa34167 -#: ../src/Doc/library/compiler.rst:622 +#: library/compiler.rst:622 msgid ":class:`ASTVisitor` objects have the following methods:" msgstr "" # b3d380299e214e0e946cd6680aa0ba83 -#: ../src/Doc/library/compiler.rst:624 +#: library/compiler.rst:624 msgid "XXX describe extra arguments" msgstr "" # 993633ec263741d38ee9cd200b4dd982 -#: ../src/Doc/library/compiler.rst:637 +#: library/compiler.rst:637 msgid "Bytecode Generation" msgstr "" # 098eff5017474a098309bff6c56ae900 -#: ../src/Doc/library/compiler.rst:639 +#: library/compiler.rst:639 msgid "" "The code generator is a visitor that emits bytecodes. Each visit method can " "call the :meth:`emit` method to emit a new bytecode. The basic code " @@ -16804,19 +16861,19 @@ msgid "" msgstr "" # 747ed6be3ee44c4081b7b236185093f2 -#: ../src/Doc/library/configparser.rst:2 +#: library/configparser.rst:2 msgid ":mod:`ConfigParser` --- Configuration file parser" msgstr "" # 017c1a22b445432094aced33034054da -#: ../src/Doc/library/configparser.rst:14 +#: library/configparser.rst:14 msgid "" "The :mod:`ConfigParser` module has been renamed to :mod:`configparser` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " "converting your sources to Python 3." msgstr "" -#: ../src/Doc/library/configparser.rst:24 +#: library/configparser.rst:24 msgid "" "This module defines the class :class:`ConfigParser`. The :class:" "`ConfigParser` class implements a basic configuration file parser language " @@ -16825,39 +16882,36 @@ msgid "" "customized by end users easily." msgstr "" -#: ../src/Doc/library/configparser.rst:32 +#: library/configparser.rst:32 msgid "" "This library does *not* interpret or write the value-type prefixes used in " "the Windows Registry extended version of INI syntax." msgstr "" -# 9df26b6ad29048f59b2804ca6b2f8936 -# 17bd01ffc326415fab51546021764e43 -#: ../src/Doc/library/configparser.rst:38 -#: ../src/Doc/library/configparser.rst:223 -msgid "Module :mod:`shlex`" -msgstr "" +#: library/configparser.rst:39 library/configparser.rst:224 +#, fuzzy +msgid "Module shlex" +msgstr "Modules" -#: ../src/Doc/library/configparser.rst:38 -#: ../src/Doc/library/configparser.rst:224 +#: library/configparser.rst:38 library/configparser.rst:224 msgid "" "Support for a creating Unix shell-like mini-languages which can be used as " "an alternate format for application configuration files." msgstr "" -# 37fb3553364b4148b23d00db05dffc3f -#: ../src/Doc/library/configparser.rst:41 -msgid "Module :mod:`json`" -msgstr "" +#: library/configparser.rst:42 +#, fuzzy +msgid "Module json" +msgstr "Modules" # 2f9fd02c2551409bb487ddeb783a6698 -#: ../src/Doc/library/configparser.rst:42 +#: library/configparser.rst:42 msgid "" "The json module implements a subset of JavaScript syntax which can also be " "used for this purpose." msgstr "" -#: ../src/Doc/library/configparser.rst:45 +#: library/configparser.rst:45 msgid "" "The configuration file consists of sections, led by a ``[section]`` header " "and followed by ``name: value`` entries, with continuations in the style of :" @@ -16870,7 +16924,7 @@ msgid "" msgstr "" # 3d415bb4125148839160b710eded2be2 -#: ../src/Doc/library/configparser.rst:54 +#: library/configparser.rst:54 msgid "" "Configuration files may include comments, prefixed by specific characters " "(``#`` and ``;``). Comments may appear on their own in an otherwise empty " @@ -16881,7 +16935,7 @@ msgid "" msgstr "" # 7709a5c02b9b490091dd71fa3e299ceb -#: ../src/Doc/library/configparser.rst:61 +#: library/configparser.rst:61 msgid "" "On top of the core functionality, :class:`SafeConfigParser` supports " "interpolation. This means values can contain format strings which refer to " @@ -16889,30 +16943,28 @@ msgid "" "section. Additional defaults can be provided on initialization." msgstr "" -#: ../src/Doc/library/configparser.rst:66 ../src/Doc/library/functools.rst:56 -#: ../src/Doc/library/multiprocessing.rst:277 -#: ../src/Doc/library/optparse.rst:331 ../src/Doc/library/re.rst:1116 -#: ../src/Doc/library/symtable.rst:175 ../src/Doc/library/textwrap.rst:69 -#: ../src/Doc/library/threading.rst:774 ../src/Doc/library/tkinter.rst:282 -#: ../src/Doc/library/tkinter.rst:543 ../src/Doc/library/tkinter.rst:719 -#: ../src/Doc/library/winsound.rst:80 +#: library/configparser.rst:66 library/functools.rst:56 +#: library/multiprocessing.rst:262 library/optparse.rst:331 library/re.rst:1121 +#: library/symtable.rst:175 library/textwrap.rst:69 library/threading.rst:775 +#: library/tkinter.rst:282 library/tkinter.rst:543 library/tkinter.rst:719 +#: library/winsound.rst:80 msgid "For example::" msgstr "Par exemple ::" -#: ../src/Doc/library/configparser.rst:74 +#: library/configparser.rst:74 msgid "" "would resolve the ``%(dir)s`` to the value of ``dir`` (``frob`` in this " "case). All reference expansions are done on demand." msgstr "" -#: ../src/Doc/library/configparser.rst:77 +#: library/configparser.rst:77 msgid "" "Default values can be specified by passing them into the :class:" "`ConfigParser` constructor as a dictionary. Additional defaults may be " "passed into the :meth:`get` method which will override all others." msgstr "" -#: ../src/Doc/library/configparser.rst:81 +#: library/configparser.rst:81 msgid "" "Sections are normally stored in a built-in dictionary. An alternative " "dictionary type can be passed to the :class:`ConfigParser` constructor. For " @@ -16920,7 +16972,7 @@ msgid "" "will be sorted on write-back, as will be the keys within each section." msgstr "" -#: ../src/Doc/library/configparser.rst:89 +#: library/configparser.rst:89 msgid "" "The basic configuration object. When *defaults* is given, it is initialized " "into the dictionary of intrinsic defaults. When *dict_type* is given, it " @@ -16930,18 +16982,30 @@ msgid "" "accepted; the value presented for these is ``None``." msgstr "" -#: ../src/Doc/library/configparser.rst:96 +#: library/configparser.rst:96 msgid "This class does not support the magical interpolation behavior." msgstr "" # a1269852b5724b399083f4c12abb6427 -#: ../src/Doc/library/configparser.rst:99 +#: library/configparser.rst:99 msgid "" "All option names are passed through the :meth:`optionxform` method. Its " "default implementation converts option names to lower case." msgstr "" -#: ../src/Doc/library/configparser.rst:114 +#: library/configparser.rst:104 library/configparser.rst:128 +#: library/configparser.rst:147 +msgid "*dict_type* was added." +msgstr "" + +#: library/configparser.rst:107 library/configparser.rst:131 +#: library/configparser.rst:150 +msgid "" +"The default *dict_type* is :class:`collections.OrderedDict`. " +"*allow_no_value* was added." +msgstr "" + +#: library/configparser.rst:114 msgid "" "Derived class of :class:`RawConfigParser` that implements the magical " "interpolation feature and adds optional arguments to the :meth:`get` and :" @@ -16952,7 +17016,7 @@ msgid "" msgstr "" # 045b72f28ce4478780be334137667c23 -#: ../src/Doc/library/configparser.rst:121 +#: library/configparser.rst:121 msgid "" "All option names used in interpolation will be passed through the :meth:" "`optionxform` method just like any other option name reference. Using the " @@ -16960,7 +17024,7 @@ msgid "" "and ``foo %(BAR)s`` are equivalent." msgstr "" -#: ../src/Doc/library/configparser.rst:138 +#: library/configparser.rst:138 msgid "" "Derived class of :class:`ConfigParser` that implements a more-sane variant " "of the magical interpolation feature. This implementation is more " @@ -16969,87 +17033,87 @@ msgid "" msgstr "" # d513c8aff574405fb3c7d69ae51704c2 -#: ../src/Doc/library/configparser.rst:157 +#: library/configparser.rst:157 msgid "Base class for all other configparser exceptions." msgstr "" -#: ../src/Doc/library/configparser.rst:162 +#: library/configparser.rst:162 msgid "Exception raised when a specified section is not found." msgstr "" -#: ../src/Doc/library/configparser.rst:167 +#: library/configparser.rst:167 msgid "" "Exception raised if :meth:`add_section` is called with the name of a section " "that is already present." msgstr "" -#: ../src/Doc/library/configparser.rst:173 +#: library/configparser.rst:173 msgid "" "Exception raised when a specified option is not found in the specified " "section." msgstr "" -#: ../src/Doc/library/configparser.rst:178 +#: library/configparser.rst:178 msgid "" "Base class for exceptions raised when problems occur performing string " "interpolation." msgstr "" -#: ../src/Doc/library/configparser.rst:184 +#: library/configparser.rst:184 msgid "" "Exception raised when string interpolation cannot be completed because the " "number of iterations exceeds :const:`MAX_INTERPOLATION_DEPTH`. Subclass of :" "exc:`InterpolationError`." msgstr "" -#: ../src/Doc/library/configparser.rst:191 +#: library/configparser.rst:191 msgid "" "Exception raised when an option referenced from a value does not exist. " "Subclass of :exc:`InterpolationError`." msgstr "" -#: ../src/Doc/library/configparser.rst:199 +#: library/configparser.rst:199 msgid "" "Exception raised when the source text into which substitutions are made does " "not conform to the required syntax. Subclass of :exc:`InterpolationError`." msgstr "" -#: ../src/Doc/library/configparser.rst:207 +#: library/configparser.rst:207 msgid "" "Exception raised when attempting to parse a file which has no section " "headers." msgstr "" -#: ../src/Doc/library/configparser.rst:212 +#: library/configparser.rst:212 msgid "Exception raised when errors occur attempting to parse a file." msgstr "" -#: ../src/Doc/library/configparser.rst:217 +#: library/configparser.rst:217 msgid "" "The maximum depth for recursive interpolation for :meth:`get` when the *raw* " "parameter is false. This is relevant only for the :class:`ConfigParser` " "class." msgstr "" -#: ../src/Doc/library/configparser.rst:231 +#: library/configparser.rst:231 msgid "RawConfigParser Objects" msgstr "" -#: ../src/Doc/library/configparser.rst:233 +#: library/configparser.rst:233 msgid ":class:`RawConfigParser` instances have the following methods:" msgstr "" -#: ../src/Doc/library/configparser.rst:238 +#: library/configparser.rst:238 msgid "Return a dictionary containing the instance-wide defaults." msgstr "" -#: ../src/Doc/library/configparser.rst:243 +#: library/configparser.rst:243 msgid "" "Return a list of the sections available; ``DEFAULT`` is not included in the " "list." msgstr "" -#: ../src/Doc/library/configparser.rst:249 +#: library/configparser.rst:249 msgid "" "Add a section named *section* to the instance. If a section by the given " "name already exists, :exc:`DuplicateSectionError` is raised. If the name " @@ -17057,24 +17121,24 @@ msgid "" "`ValueError` is raised." msgstr "" -#: ../src/Doc/library/configparser.rst:256 +#: library/configparser.rst:256 msgid "" "Indicates whether the named section is present in the configuration. The " "``DEFAULT`` section is not acknowledged." msgstr "" -#: ../src/Doc/library/configparser.rst:262 +#: library/configparser.rst:262 msgid "Returns a list of options available in the specified *section*." msgstr "" -#: ../src/Doc/library/configparser.rst:267 +#: library/configparser.rst:267 msgid "" "If the given section exists, and contains the given option, return :const:" "`True`; otherwise return :const:`False`." msgstr "" # a285f98917f2495aaec3d1eb0a4ce95a -#: ../src/Doc/library/configparser.rst:275 +#: library/configparser.rst:275 msgid "" "Attempt to read and parse a list of filenames, returning a list of filenames " "which were successfully parsed. If *filenames* is a string or Unicode " @@ -17089,8 +17153,12 @@ msgid "" "`readfp` before calling :meth:`read` for any optional files::" msgstr "" +#: library/configparser.rst:293 +msgid "Returns list of successfully parsed filenames." +msgstr "" + # f10c10376a814ec4b52e32a706e44c6d -#: ../src/Doc/library/configparser.rst:299 +#: library/configparser.rst:299 msgid "" "Read and parse configuration data from the file or file-like object in *fp* " "(only the :meth:`readline` method is used). If *filename* is omitted and " @@ -17098,23 +17166,23 @@ msgid "" "is ````." msgstr "" -#: ../src/Doc/library/configparser.rst:307 +#: library/configparser.rst:307 msgid "Get an *option* value for the named *section*." msgstr "" -#: ../src/Doc/library/configparser.rst:312 +#: library/configparser.rst:312 msgid "" "A convenience method which coerces the *option* in the specified *section* " "to an integer." msgstr "" -#: ../src/Doc/library/configparser.rst:318 +#: library/configparser.rst:318 msgid "" "A convenience method which coerces the *option* in the specified *section* " "to a floating point number." msgstr "" -#: ../src/Doc/library/configparser.rst:324 +#: library/configparser.rst:324 msgid "" "A convenience method which coerces the *option* in the specified *section* " "to a Boolean value. Note that the accepted values for the option are ``" @@ -17125,13 +17193,13 @@ msgid "" "`ValueError`." msgstr "" -#: ../src/Doc/library/configparser.rst:334 +#: library/configparser.rst:334 msgid "" "Return a list of ``(name, value)`` pairs for each option in the given " "*section*." msgstr "" -#: ../src/Doc/library/configparser.rst:339 +#: library/configparser.rst:339 msgid "" "If the given section exists, set the given option to the specified value; " "otherwise raise :exc:`NoSectionError`. While it is possible to use :class:" @@ -17142,26 +17210,26 @@ msgid "" msgstr "" # 24d7ed9c1e0e412c80c03c10b32119f0 -#: ../src/Doc/library/configparser.rst:350 +#: library/configparser.rst:350 msgid "" "Write a representation of the configuration to the specified file object. " "This representation can be parsed by a future :meth:`read` call." msgstr "" -#: ../src/Doc/library/configparser.rst:358 +#: library/configparser.rst:358 msgid "" "Remove the specified *option* from the specified *section*. If the section " "does not exist, raise :exc:`NoSectionError`. If the option existed to be " "removed, return :const:`True`; otherwise return :const:`False`." msgstr "" -#: ../src/Doc/library/configparser.rst:367 +#: library/configparser.rst:367 msgid "" "Remove the specified *section* from the configuration. If the section in " "fact existed, return ``True``. Otherwise return ``False``." msgstr "" -#: ../src/Doc/library/configparser.rst:373 +#: library/configparser.rst:373 msgid "" "Transforms the option name *option* as found in an input file or as passed " "in by client code to the form that should be used in the internal " @@ -17170,7 +17238,7 @@ msgid "" "of this name on instances to affect this behavior." msgstr "" -#: ../src/Doc/library/configparser.rst:379 +#: library/configparser.rst:379 msgid "" "You don't necessarily need to subclass a ConfigParser to use this method, " "you can also re-set it on an instance, to a function that takes a string " @@ -17178,24 +17246,24 @@ msgid "" "sensitive::" msgstr "" -#: ../src/Doc/library/configparser.rst:388 +#: library/configparser.rst:388 msgid "" "Note that when reading configuration files, whitespace around the option " "names are stripped before :meth:`optionxform` is called." msgstr "" -#: ../src/Doc/library/configparser.rst:395 +#: library/configparser.rst:395 msgid "ConfigParser Objects" msgstr "" -#: ../src/Doc/library/configparser.rst:397 +#: library/configparser.rst:397 msgid "" "The :class:`ConfigParser` class extends some methods of the :class:" "`RawConfigParser` interface, adding some optional arguments." msgstr "" # 71ed1bb157444513b84702aa40a9cfe3 -#: ../src/Doc/library/configparser.rst:403 +#: library/configparser.rst:403 msgid "" "Get an *option* value for the named *section*. If *vars* is provided, it " "must be a dictionary. The *option* is looked up in *vars* (if provided), " @@ -17203,66 +17271,66 @@ msgid "" msgstr "" # ec1526d328e4469faecf37621fab9834 -#: ../src/Doc/library/configparser.rst:407 +#: library/configparser.rst:407 msgid "" "All the ``'%'`` interpolations are expanded in the return values, unless the " "*raw* argument is true. Values for interpolation keys are looked up in the " "same manner as the option." msgstr "" -#: ../src/Doc/library/configparser.rst:413 +#: library/configparser.rst:413 msgid "" "Return a list of ``(name, value)`` pairs for each option in the given " "*section*. Optional arguments have the same meaning as for the :meth:`get` " "method." msgstr "" -#: ../src/Doc/library/configparser.rst:422 +#: library/configparser.rst:422 msgid "SafeConfigParser Objects" msgstr "" -#: ../src/Doc/library/configparser.rst:424 +#: library/configparser.rst:424 msgid "" "The :class:`SafeConfigParser` class implements the same extended interface " "as :class:`ConfigParser`, with the following addition:" msgstr "" # 5b70c857663644b8b94da363e62304fa -#: ../src/Doc/library/configparser.rst:430 +#: library/configparser.rst:430 msgid "" "If the given section exists, set the given option to the specified value; " "otherwise raise :exc:`NoSectionError`. *value* must be a string (:class:" "`str` or :class:`unicode`); if not, :exc:`TypeError` is raised." msgstr "" -#: ../src/Doc/library/configparser.rst:440 +#: library/configparser.rst:440 msgid "An example of writing to a configuration file::" msgstr "" -#: ../src/Doc/library/configparser.rst:465 +#: library/configparser.rst:465 msgid "An example of reading the configuration file again::" msgstr "" -#: ../src/Doc/library/configparser.rst:483 +#: library/configparser.rst:483 msgid "" "To get interpolation, you will need to use a :class:`ConfigParser` or :class:" "`SafeConfigParser`::" msgstr "" -#: ../src/Doc/library/configparser.rst:500 +#: library/configparser.rst:500 msgid "" "Defaults are available in all three types of ConfigParsers. They are used in " "interpolation if an option used is not defined elsewhere. ::" msgstr "" -#: ../src/Doc/library/configparser.rst:514 +#: library/configparser.rst:514 msgid "" "The function ``opt_move`` below can be used to move options between " "sections::" msgstr "" # b2c44de53b104478b7a486f4c2682406 -#: ../src/Doc/library/configparser.rst:526 +#: library/configparser.rst:526 msgid "" "Some configuration files are known to include settings without values, but " "which otherwise conform to the syntax supported by :mod:`ConfigParser`. The " @@ -17270,33 +17338,37 @@ msgid "" "such values should be accepted:" msgstr "" -#: ../src/Doc/library/constants.rst:4 +#: library/constants.rst:4 msgid "Built-in Constants" msgstr "" -#: ../src/Doc/library/constants.rst:6 +#: library/constants.rst:6 msgid "A small number of constants live in the built-in namespace. They are:" msgstr "" # 2cb7463f73474babaa6a809f1afbd439 -#: ../src/Doc/library/constants.rst:10 +#: library/constants.rst:10 msgid "The false value of the :class:`bool` type." msgstr "" # 7c7e032a232941de8dfb62b037cb25e9 -#: ../src/Doc/library/constants.rst:17 +#: library/constants.rst:17 msgid "The true value of the :class:`bool` type." msgstr "" # f58aac73a7d14064a5f0bd6e664b5381 -#: ../src/Doc/library/constants.rst:24 +#: library/constants.rst:24 msgid "" "The sole value of :attr:`types.NoneType`. ``None`` is frequently used to " "represent the absence of a value, as when default arguments are not passed " "to a function." msgstr "" -#: ../src/Doc/library/constants.rst:34 +#: library/constants.rst:28 +msgid "Assignments to ``None`` are illegal and raise a :exc:`SyntaxError`." +msgstr "" + +#: library/constants.rst:34 msgid "" "Special value which can be returned by the \"rich comparison\" special " "methods (:meth:`__eq__`, :meth:`__lt__`, and friends), to indicate that the " @@ -17304,30 +17376,34 @@ msgid "" msgstr "" # db0f5d42a8d54e9098abf1d87a3111c2 -#: ../src/Doc/library/constants.rst:41 +#: library/constants.rst:41 msgid "Special value used in conjunction with extended slicing syntax." msgstr "" # 396009c83d6d41918e60806e07460f28 -#: ../src/Doc/library/constants.rst:46 +#: library/constants.rst:46 msgid "" "This constant is true if Python was not started with an :option:`-O` option. " "See also the :keyword:`assert` statement." msgstr "" # 23843a4140a24e65af639aead95c3f13 -#: ../src/Doc/library/constants.rst:52 +#: library/constants.rst:52 msgid "" "The names :data:`None` and :data:`__debug__` cannot be reassigned " "(assignments to them, even as an attribute name, raise :exc:`SyntaxError`), " "so they can be considered \"true\" constants." msgstr "" -#: ../src/Doc/library/constants.rst:61 +#: library/constants.rst:56 +msgid "Assignments to ``__debug__`` as an attribute became illegal." +msgstr "" + +#: library/constants.rst:61 msgid "Constants added by the :mod:`site` module" msgstr "" -#: ../src/Doc/library/constants.rst:63 +#: library/constants.rst:63 msgid "" "The :mod:`site` module (which is imported automatically during startup, " "except if the :option:`-S` command-line option is given) adds several " @@ -17335,62 +17411,62 @@ msgid "" "interpreter shell and should not be used in programs." msgstr "" -#: ../src/Doc/library/constants.rst:71 +#: library/constants.rst:71 msgid "" "Objects that when printed, print a message like \"Use quit() or Ctrl-D (i.e. " "EOF) to exit\", and when called, raise :exc:`SystemExit` with the specified " "exit code." msgstr "" -#: ../src/Doc/library/constants.rst:79 +#: library/constants.rst:79 msgid "" "Objects that when printed, print a message like \"Type license() to see the " "full license text\", and when called, display the corresponding text in a " "pager-like fashion (one screen at a time)." msgstr "" -#: ../src/Doc/library/contextlib.rst:2 +#: library/contextlib.rst:2 msgid "" ":mod:`contextlib` --- Utilities for :keyword:`with`\\ -statement contexts" msgstr "" # 71cc63ba65a145d4973b2eb65eb7abd2 -#: ../src/Doc/library/contextlib.rst:10 +#: library/contextlib.rst:10 msgid "**Source code:** :source:`Lib/contextlib.py`" msgstr "" -#: ../src/Doc/library/contextlib.rst:14 +#: library/contextlib.rst:14 msgid "" "This module provides utilities for common tasks involving the :keyword:" "`with` statement. For more information see also :ref:`typecontextmanager` " "and :ref:`context-managers`." msgstr "" -#: ../src/Doc/library/contextlib.rst:18 +#: library/contextlib.rst:18 msgid "Functions provided:" msgstr "" -#: ../src/Doc/library/contextlib.rst:23 +#: library/contextlib.rst:23 msgid "" "This function is a :term:`decorator` that can be used to define a factory " "function for :keyword:`with` statement context managers, without needing to " "create a class or separate :meth:`__enter__` and :meth:`__exit__` methods." msgstr "" -#: ../src/Doc/library/contextlib.rst:27 +#: library/contextlib.rst:27 msgid "" "A simple example (this is not recommended as a real way of generating " "HTML!)::" msgstr "" -#: ../src/Doc/library/contextlib.rst:44 +#: library/contextlib.rst:44 msgid "" "The function being decorated must return a :term:`generator`-iterator when " "called. This iterator must yield exactly one value, which will be bound to " "the targets in the :keyword:`with` statement's :keyword:`as` clause, if any." msgstr "" -#: ../src/Doc/library/contextlib.rst:48 +#: library/contextlib.rst:48 msgid "" "At the point where the generator yields, the block nested in the :keyword:" "`with` statement is executed. The generator is then resumed after the block " @@ -17407,19 +17483,19 @@ msgid "" msgstr "" # 51128cd925704b54a2a870d3f6256b2a -#: ../src/Doc/library/contextlib.rst:63 +#: library/contextlib.rst:63 msgid "Combine multiple context managers into a single nested context manager." msgstr "" # ed7fc5130c5d4ec59d5b16c3f9d5d38d -#: ../src/Doc/library/contextlib.rst:65 +#: library/contextlib.rst:65 msgid "" "This function has been deprecated in favour of the multiple manager form of " "the :keyword:`with` statement." msgstr "" # 2d34a6c1e5114b41a2860d7962d1845d -#: ../src/Doc/library/contextlib.rst:68 +#: library/contextlib.rst:68 msgid "" "The one advantage of this function over the multiple manager form of the :" "keyword:`with` statement is that argument unpacking allows it to be used " @@ -17427,7 +17503,7 @@ msgid "" msgstr "" # 6ecef858ce244aceb148accf1da45af7 -#: ../src/Doc/library/contextlib.rst:77 +#: library/contextlib.rst:77 msgid "" "Note that if the :meth:`__exit__` method of one of the nested context " "managers indicates an exception should be suppressed, no exception " @@ -17441,7 +17517,7 @@ msgid "" msgstr "" # 0adaaad29cc3419391363ade84b9f773 -#: ../src/Doc/library/contextlib.rst:86 +#: library/contextlib.rst:86 msgid "" "This function has two major quirks that have led to it being deprecated. " "Firstly, as the context managers are all constructed before the function is " @@ -17453,7 +17529,7 @@ msgid "" msgstr "" # e1f87fdeaf5f4f8a93a14dc0a69d201e -#: ../src/Doc/library/contextlib.rst:94 +#: library/contextlib.rst:94 msgid "" "Secondly, if the :meth:`__enter__` method of one of the inner context " "managers raises an exception that is caught and suppressed by the :meth:" @@ -17463,7 +17539,7 @@ msgid "" msgstr "" # b71c76d78044401ba2425aa3e996cd93 -#: ../src/Doc/library/contextlib.rst:100 +#: library/contextlib.rst:100 msgid "" "Developers that need to support nesting of a variable number of context " "managers can either use the :mod:`warnings` module to suppress the " @@ -17471,40 +17547,45 @@ msgid "" "model for an application specific implementation." msgstr "" -#: ../src/Doc/library/contextlib.rst:111 +#: library/contextlib.rst:105 +msgid "" +"The with-statement now supports this functionality directly (without the " +"confusing error prone quirks)." +msgstr "" + +#: library/contextlib.rst:111 msgid "" "Return a context manager that closes *thing* upon completion of the block. " "This is basically equivalent to::" msgstr "" -#: ../src/Doc/library/contextlib.rst:123 +#: library/contextlib.rst:123 msgid "And lets you write code like this::" msgstr "" -#: ../src/Doc/library/contextlib.rst:132 +#: library/contextlib.rst:132 msgid "" "without needing to explicitly close ``page``. Even if an error occurs, " "``page.close()`` will be called when the :keyword:`with` block is exited." msgstr "" -# 591a2298379a4210b2a83ea1b0b2599e -#: ../src/Doc/library/contextlib.rst:138 -msgid ":pep:`0343` - The \"with\" statement" +#: library/contextlib.rst:139 +msgid "PEP 0343 - The \"with\" statement" msgstr "" -#: ../src/Doc/library/contextlib.rst:139 +#: library/contextlib.rst:139 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" # a4f9a39406a3463b9f386f16670a70af -#: ../src/Doc/library/cookie.rst:2 +#: library/cookie.rst:2 msgid ":mod:`Cookie` --- HTTP state management" msgstr "" # 601d27d4e0174e169afd8be4f2113615 -#: ../src/Doc/library/cookie.rst:10 +#: library/cookie.rst:10 msgid "" "The :mod:`Cookie` module has been renamed to :mod:`http.cookies` in Python " "3. The :term:`2to3` tool will automatically adapt imports when converting " @@ -17512,12 +17593,12 @@ msgid "" msgstr "" # 943867613391435cb42e61e85a289363 -#: ../src/Doc/library/cookie.rst:14 +#: library/cookie.rst:14 msgid "**Source code:** :source:`Lib/Cookie.py`" msgstr "" # 51bc939b838849e2b969238b9c335869 -#: ../src/Doc/library/cookie.rst:18 +#: library/cookie.rst:18 msgid "" "The :mod:`Cookie` module defines classes for abstracting the concept of " "cookies, an HTTP state management mechanism. It supports both simple string-" @@ -17526,7 +17607,7 @@ msgid "" msgstr "" # bb6422ecca2b4f909dbb95e09c4cb3c0 -#: ../src/Doc/library/cookie.rst:23 +#: library/cookie.rst:23 msgid "" "The module formerly strictly applied the parsing rules described in the :rfc:" "`2109` and :rfc:`2068` specifications. It has since been discovered that " @@ -17537,27 +17618,27 @@ msgid "" msgstr "" # fb4a24b3a3f942f2ae541d5f5ec5e149 -#: ../src/Doc/library/cookie.rst:29 +#: library/cookie.rst:29 msgid "" "The character set, :data:`string.ascii_letters`, :data:`string.digits` and " "``!#$%&'*+-.^_`|~`` denote the set of valid characters allowed by this " "module in Cookie name (as :attr:`~Morsel.key`)." msgstr "" -#: ../src/Doc/library/cookie.rst:36 +#: library/cookie.rst:36 msgid "" "On encountering an invalid cookie, :exc:`CookieError` is raised, so if your " "cookie data comes from a browser you should always prepare for invalid data " "and catch :exc:`CookieError` on parsing." msgstr "" -#: ../src/Doc/library/cookie.rst:43 +#: library/cookie.rst:43 msgid "" "Exception failing because of :rfc:`2109` invalidity: incorrect attributes, " "incorrect :mailheader:`Set-Cookie` header, etc." msgstr "" -#: ../src/Doc/library/cookie.rst:49 +#: library/cookie.rst:49 msgid "" "This class is a dictionary-like object whose keys are strings and whose " "values are :class:`Morsel` instances. Note that upon setting a key to a " @@ -17565,11 +17646,11 @@ msgid "" "and the value." msgstr "" -#: ../src/Doc/library/cookie.rst:53 +#: library/cookie.rst:53 msgid "If *input* is given, it is passed to the :meth:`load` method." msgstr "" -#: ../src/Doc/library/cookie.rst:58 +#: library/cookie.rst:58 msgid "" "This class derives from :class:`BaseCookie` and overrides :meth:" "`value_decode` and :meth:`value_encode` to be the identity and :func:`str` " @@ -17577,15 +17658,23 @@ msgid "" msgstr "" # 5a51903a8b2449e4839089cd5343ee14 -#: ../src/Doc/library/cookie.rst:64 +#: library/cookie.rst:64 msgid "" "This class derives from :class:`BaseCookie` and overrides :meth:" "`value_decode` and :meth:`value_encode` to be the :func:`pickle.loads` and :" "func:`pickle.dumps`." msgstr "" +#: library/cookie.rst:68 +msgid "" +"Reading pickled values from untrusted cookie data is a huge security hole, " +"as pickle strings can be crafted to cause arbitrary code to execute on your " +"server. It is supported for backwards compatibility only, and may eventually " +"go away." +msgstr "" + # 2d14d54278ba46a582cd28db731fb6e7 -#: ../src/Doc/library/cookie.rst:76 +#: library/cookie.rst:76 msgid "" "This class derives from :class:`BaseCookie`. It overrides :meth:" "`value_decode` to be :func:`pickle.loads` if it is a valid pickle, and " @@ -17594,8 +17683,12 @@ msgid "" "itself." msgstr "" +#: library/cookie.rst:81 +msgid "The same security warning from :class:`SerialCookie` applies here." +msgstr "" + # 974d3e43774d43a0bec1fdc7e8f1f10c -#: ../src/Doc/library/cookie.rst:84 +#: library/cookie.rst:84 msgid "" "A further security note is warranted. For backwards compatibility, the :mod:" "`Cookie` module exports a class named :class:`Cookie` which is just an alias " @@ -17605,53 +17698,50 @@ msgid "" "`SerialCookie` class." msgstr "" -# e7bc279a6d754df584cd6be3c88eeb8b -#: ../src/Doc/library/cookie.rst:95 -msgid "Module :mod:`cookielib`" +#: library/cookie.rst:96 +msgid "Module cookielib" msgstr "" # 3366042c230843b4840a50b39de82c47 -#: ../src/Doc/library/cookie.rst:95 +#: library/cookie.rst:95 msgid "" "HTTP cookie handling for web *clients*. The :mod:`cookielib` and :mod:" "`Cookie` modules do not depend on each other." msgstr "" -# a7b219bee4b4492db614aba8a0ffe739 -# b41438928dce4f29a6da23fcad7d872d -#: ../src/Doc/library/cookie.rst:97 ../src/Doc/library/cookielib.rst:131 -msgid ":rfc:`2109` - HTTP State Management Mechanism" +#: library/cookie.rst:98 library/cookielib.rst:132 +msgid "RFC 2109 - HTTP State Management Mechanism" msgstr "" -#: ../src/Doc/library/cookie.rst:99 +#: library/cookie.rst:99 msgid "This is the state management specification implemented by this module." msgstr "" -#: ../src/Doc/library/cookie.rst:105 ../src/Doc/library/cookielib.rst:609 +#: library/cookie.rst:105 library/cookielib.rst:609 msgid "Cookie Objects" msgstr "" -#: ../src/Doc/library/cookie.rst:110 +#: library/cookie.rst:110 msgid "" "Return a decoded value from a string representation. Return value can be any " "type. This method does nothing in :class:`BaseCookie` --- it exists so it " "can be overridden." msgstr "" -#: ../src/Doc/library/cookie.rst:117 +#: library/cookie.rst:117 msgid "" "Return an encoded value. *val* can be any type, but return value must be a " "string. This method does nothing in :class:`BaseCookie` --- it exists so it " -"can be overridden" +"can be overridden." msgstr "" -#: ../src/Doc/library/cookie.rst:121 +#: library/cookie.rst:121 msgid "" "In general, it should be the case that :meth:`value_encode` and :meth:" "`value_decode` are inverses on the range of *value_decode*." msgstr "" -#: ../src/Doc/library/cookie.rst:127 +#: library/cookie.rst:127 msgid "" "Return a string representation suitable to be sent as HTTP headers. *attrs* " "and *header* are sent to each :class:`Morsel`'s :meth:`output` method. *sep* " @@ -17659,103 +17749,112 @@ msgid "" "``'\\r\\n'`` (CRLF)." msgstr "" -#: ../src/Doc/library/cookie.rst:139 +#: library/cookie.rst:132 +msgid "" +"The default separator has been changed from ``'\\n'`` to match the cookie " +"specification." +msgstr "" + +#: library/cookie.rst:139 msgid "" "Return an embeddable JavaScript snippet, which, if run on a browser which " "supports JavaScript, will act the same as if the HTTP headers was sent." msgstr "" -#: ../src/Doc/library/cookie.rst:142 ../src/Doc/library/cookie.rst:224 -#: ../src/Doc/library/cookie.rst:232 +#: library/cookie.rst:142 library/cookie.rst:224 library/cookie.rst:232 msgid "The meaning for *attrs* is the same as in :meth:`output`." msgstr "" -#: ../src/Doc/library/cookie.rst:147 +#: library/cookie.rst:147 msgid "" "If *rawdata* is a string, parse it as an ``HTTP_COOKIE`` and add the values " "found there as :class:`Morsel`\\ s. If it is a dictionary, it is equivalent " "to::" msgstr "" -#: ../src/Doc/library/cookie.rst:157 +#: library/cookie.rst:157 msgid "Morsel Objects" msgstr "" -#: ../src/Doc/library/cookie.rst:162 +#: library/cookie.rst:162 msgid "Abstract a key/value pair, which has some :rfc:`2109` attributes." msgstr "" -#: ../src/Doc/library/cookie.rst:164 +#: library/cookie.rst:164 msgid "" "Morsels are dictionary-like objects, whose set of keys is constant --- the " "valid :rfc:`2109` attributes, which are" msgstr "" -#: ../src/Doc/library/cookie.rst:167 +#: library/cookie.rst:167 msgid "``expires``" msgstr "" -#: ../src/Doc/library/cookie.rst:168 +#: library/cookie.rst:168 msgid "``path``" msgstr "" -#: ../src/Doc/library/cookie.rst:169 +#: library/cookie.rst:169 msgid "``comment``" msgstr "" -#: ../src/Doc/library/cookie.rst:170 +#: library/cookie.rst:170 msgid "``domain``" msgstr "" -#: ../src/Doc/library/cookie.rst:171 +#: library/cookie.rst:171 msgid "``max-age``" msgstr "" -#: ../src/Doc/library/cookie.rst:172 +#: library/cookie.rst:172 msgid "``secure``" msgstr "" -#: ../src/Doc/library/cookie.rst:173 +#: library/cookie.rst:173 msgid "``version``" msgstr "" -#: ../src/Doc/library/cookie.rst:174 +#: library/cookie.rst:174 msgid "``httponly``" msgstr "" -#: ../src/Doc/library/cookie.rst:176 +#: library/cookie.rst:176 msgid "" "The attribute :attr:`httponly` specifies that the cookie is only transfered " "in HTTP requests, and is not accessible through JavaScript. This is intended " "to mitigate some forms of cross-site scripting." msgstr "" -#: ../src/Doc/library/cookie.rst:180 +#: library/cookie.rst:180 msgid "The keys are case-insensitive." msgstr "" -#: ../src/Doc/library/cookie.rst:188 +#: library/cookie.rst:182 +msgid "The :attr:`httponly` attribute was added." +msgstr "" + +#: library/cookie.rst:188 msgid "The value of the cookie." msgstr "" -#: ../src/Doc/library/cookie.rst:193 +#: library/cookie.rst:193 msgid "The encoded value of the cookie --- this is what should be sent." msgstr "" -#: ../src/Doc/library/cookie.rst:198 +#: library/cookie.rst:198 msgid "The name of the cookie." msgstr "" # ab172afcd1984721b01292c684ddf2d1 -#: ../src/Doc/library/cookie.rst:203 +#: library/cookie.rst:203 msgid "Set the *key*, *value* and *coded_value* attributes." msgstr "" -#: ../src/Doc/library/cookie.rst:208 +#: library/cookie.rst:208 msgid "Whether *K* is a member of the set of keys of a :class:`Morsel`." msgstr "" -#: ../src/Doc/library/cookie.rst:213 +#: library/cookie.rst:213 msgid "" "Return a string representation of the Morsel, suitable to be sent as an HTTP " "header. By default, all the attributes are included, unless *attrs* is " @@ -17763,30 +17862,30 @@ msgid "" "by default ``\"Set-Cookie:\"``." msgstr "" -#: ../src/Doc/library/cookie.rst:221 +#: library/cookie.rst:221 msgid "" "Return an embeddable JavaScript snippet, which, if run on a browser which " "supports JavaScript, will act the same as if the HTTP header was sent." msgstr "" -#: ../src/Doc/library/cookie.rst:229 +#: library/cookie.rst:229 msgid "" "Return a string representing the Morsel, without any surrounding HTTP or " "JavaScript." msgstr "" # 7ef4e4ca868a477191330ef212c9c1c7 -#: ../src/Doc/library/cookie.rst:240 +#: library/cookie.rst:240 msgid "The following example demonstrates how to use the :mod:`Cookie` module." msgstr "" # 7ac5171088b34b83865d74ec6e94e271 -#: ../src/Doc/library/cookielib.rst:2 +#: library/cookielib.rst:2 msgid ":mod:`cookielib` --- Cookie handling for HTTP clients" msgstr "" # 2ebc10829d324dd59f0b7cd1e4d6d5d3 -#: ../src/Doc/library/cookielib.rst:10 +#: library/cookielib.rst:10 msgid "" "The :mod:`cookielib` module has been renamed to :mod:`http.cookiejar` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -17794,12 +17893,12 @@ msgid "" msgstr "" # 1c1431af2833418cb8eca02ec2fac980 -#: ../src/Doc/library/cookielib.rst:16 +#: library/cookielib.rst:16 msgid "**Source code:** :source:`Lib/cookielib.py`" msgstr "" # 80db78625a53406a9a53670709e15a22 -#: ../src/Doc/library/cookielib.rst:20 +#: library/cookielib.rst:20 msgid "" "The :mod:`cookielib` module defines classes for automatic handling of HTTP " "cookies. It is useful for accessing web sites that require small pieces of " @@ -17809,7 +17908,7 @@ msgid "" msgstr "" # 6a3330d1babb40dda1a8b90ad3163769 -#: ../src/Doc/library/cookielib.rst:25 +#: library/cookielib.rst:25 msgid "" "Both the regular Netscape cookie protocol and the protocol defined by :rfc:" "`2965` are handled. RFC 2965 handling is switched off by default. :rfc:" @@ -17822,7 +17921,7 @@ msgid "" "``port`` cookie-attributes introduced with RFC 2965." msgstr "" -#: ../src/Doc/library/cookielib.rst:37 +#: library/cookielib.rst:37 msgid "" "The various named parameters found in :mailheader:`Set-Cookie` and :" "mailheader:`Set-Cookie2` headers (eg. ``domain`` and ``expires``) are " @@ -17831,12 +17930,12 @@ msgid "" "`cookie-attribute` instead." msgstr "" -#: ../src/Doc/library/cookielib.rst:44 +#: library/cookielib.rst:44 msgid "The module defines the following exception:" msgstr "" # 0d751dc29c204a8293a4c9dd9bfe2e23 -#: ../src/Doc/library/cookielib.rst:49 +#: library/cookielib.rst:49 msgid "" "Instances of :class:`FileCookieJar` raise this exception on failure to load " "cookies from a file." @@ -17844,21 +17943,21 @@ msgstr "" # 4c622e2a3b0940e390924206b5a8a95c # 0e8fc480bf314bd19601c96efe57da49 -#: ../src/Doc/library/cookielib.rst:54 ../src/Doc/library/cookielib.rst:276 +#: library/cookielib.rst:54 library/cookielib.rst:276 msgid "" "For backwards-compatibility with Python 2.4 (which raised an :exc:" "`IOError`), :exc:`LoadError` is a subclass of :exc:`IOError`." msgstr "" -#: ../src/Doc/library/cookielib.rst:58 ../src/Doc/library/urllib2.rst:134 +#: library/cookielib.rst:58 library/urllib2.rst:151 msgid "The following classes are provided:" msgstr "" -#: ../src/Doc/library/cookielib.rst:63 +#: library/cookielib.rst:63 msgid "*policy* is an object implementing the :class:`CookiePolicy` interface." msgstr "" -#: ../src/Doc/library/cookielib.rst:65 +#: library/cookielib.rst:65 msgid "" "The :class:`CookieJar` class stores HTTP cookies. It extracts cookies from " "HTTP requests, and returns them in HTTP responses. :class:`CookieJar` " @@ -17867,13 +17966,13 @@ msgid "" "database." msgstr "" -#: ../src/Doc/library/cookielib.rst:73 +#: library/cookielib.rst:73 msgid "" "*policy* is an object implementing the :class:`CookiePolicy` interface. For " "the other arguments, see the documentation for the corresponding attributes." msgstr "" -#: ../src/Doc/library/cookielib.rst:76 +#: library/cookielib.rst:76 msgid "" "A :class:`CookieJar` which can load cookies from, and perhaps save cookies " "to, a file on disk. Cookies are **NOT** loaded from the named file until " @@ -17881,13 +17980,13 @@ msgid "" "this class are documented in section :ref:`file-cookie-jar-classes`." msgstr "" -#: ../src/Doc/library/cookielib.rst:84 +#: library/cookielib.rst:84 msgid "" "This class is responsible for deciding whether each cookie should be " "accepted from / returned to the server." msgstr "" -#: ../src/Doc/library/cookielib.rst:90 +#: library/cookielib.rst:90 msgid "" "Constructor arguments should be passed as keyword arguments only. " "*blocked_domains* is a sequence of domain names that we never accept cookies " @@ -17898,7 +17997,7 @@ msgid "" msgstr "" # cb988062eb014866bec893e66380bf5a -#: ../src/Doc/library/cookielib.rst:97 +#: library/cookielib.rst:97 msgid "" ":class:`DefaultCookiePolicy` implements the standard accept / reject rules " "for Netscape and RFC 2965 cookies. By default, RFC 2109 cookies (ie. " @@ -17912,7 +18011,7 @@ msgid "" msgstr "" # a1d3f2ad01af463f8375747382120270 -#: ../src/Doc/library/cookielib.rst:110 +#: library/cookielib.rst:110 msgid "" "This class represents Netscape, RFC 2109 and RFC 2965 cookies. It is not " "expected that users of :mod:`cookielib` construct their own :class:`Cookie` " @@ -17920,34 +18019,33 @@ msgid "" "`CookieJar` instance." msgstr "" -# a8d845873ada4d36ac401638633f76c2 -#: ../src/Doc/library/cookielib.rst:118 -msgid "Module :mod:`urllib2`" +#: library/cookielib.rst:119 +msgid "Module urllib2" msgstr "" -#: ../src/Doc/library/cookielib.rst:119 +#: library/cookielib.rst:119 msgid "URL opening with automatic cookie handling." msgstr "" -# 9638cda2b7664ff3ba0dfe43d474a24a -#: ../src/Doc/library/cookielib.rst:122 -msgid "Module :mod:`Cookie`" -msgstr "" +#: library/cookielib.rst:123 +#, fuzzy +msgid "Module Cookie" +msgstr "Modules" # 38a5787d180c4b2baee5a03053d0e7a5 -#: ../src/Doc/library/cookielib.rst:122 +#: library/cookielib.rst:122 msgid "" "HTTP cookie classes, principally useful for server-side code. The :mod:" "`cookielib` and :mod:`Cookie` modules do not depend on each other." msgstr "" # 7023426738964b18aab3f84dd07ffc70 -#: ../src/Doc/library/cookielib.rst:128 +#: library/cookielib.rst:129 msgid "http://curl.haxx.se/rfc/cookie_spec.html" msgstr "" # 46be209e8f5a481e81320a2890721795 -#: ../src/Doc/library/cookielib.rst:126 +#: library/cookielib.rst:126 msgid "" "The specification of the original Netscape cookie protocol. Though this is " "still the dominant protocol, the 'Netscape cookie protocol' implemented by " @@ -17955,53 +18053,52 @@ msgid "" "resemblance to the one sketched out in ``cookie_spec.html``." msgstr "" -#: ../src/Doc/library/cookielib.rst:132 +#: library/cookielib.rst:132 msgid "Obsoleted by RFC 2965. Uses :mailheader:`Set-Cookie` with version=1." msgstr "" -# f3f001951a664393998606caa163c426 -#: ../src/Doc/library/cookielib.rst:135 -msgid ":rfc:`2965` - HTTP State Management Mechanism" +#: library/cookielib.rst:136 +msgid "RFC 2965 - HTTP State Management Mechanism" msgstr "" -#: ../src/Doc/library/cookielib.rst:135 +#: library/cookielib.rst:135 msgid "" "The Netscape protocol with the bugs fixed. Uses :mailheader:`Set-Cookie2` " "in place of :mailheader:`Set-Cookie`. Not widely used." msgstr "" # ca028b3f1a744d6c998e7f4f24caf151 -#: ../src/Doc/library/cookielib.rst:138 +#: library/cookielib.rst:139 msgid "http://kristol.org/cookie/errata.html" msgstr "" -#: ../src/Doc/library/cookielib.rst:139 +#: library/cookielib.rst:139 msgid "Unfinished errata to RFC 2965." msgstr "" -#: ../src/Doc/library/cookielib.rst:141 +#: library/cookielib.rst:141 msgid ":rfc:`2964` - Use of HTTP State Management" msgstr "" -#: ../src/Doc/library/cookielib.rst:146 +#: library/cookielib.rst:146 msgid "CookieJar and FileCookieJar Objects" msgstr "" -#: ../src/Doc/library/cookielib.rst:148 +#: library/cookielib.rst:148 msgid "" ":class:`CookieJar` objects support the :term:`iterator` protocol for " "iterating over contained :class:`Cookie` objects." msgstr "" -#: ../src/Doc/library/cookielib.rst:151 +#: library/cookielib.rst:151 msgid ":class:`CookieJar` has the following methods:" msgstr "" -#: ../src/Doc/library/cookielib.rst:156 +#: library/cookielib.rst:156 msgid "Add correct :mailheader:`Cookie` header to *request*." msgstr "" -#: ../src/Doc/library/cookielib.rst:158 +#: library/cookielib.rst:158 msgid "" "If policy allows (ie. the :attr:`rfc2965` and :attr:`hide_cookie2` " "attributes of the :class:`CookieJar`'s :class:`CookiePolicy` instance are " @@ -18010,7 +18107,7 @@ msgid "" msgstr "" # b59c23baef094e53a156e2c2c080c367 -#: ../src/Doc/library/cookielib.rst:162 +#: library/cookielib.rst:162 msgid "" "The *request* object (usually a :class:`urllib2.Request` instance) must " "support the methods :meth:`get_full_url`, :meth:`get_host`, :meth:" @@ -18019,13 +18116,13 @@ msgid "" "`add_unredirected_header`,as documented by :mod:`urllib2`." msgstr "" -#: ../src/Doc/library/cookielib.rst:171 +#: library/cookielib.rst:171 msgid "" "Extract cookies from HTTP *response* and store them in the :class:" "`CookieJar`, where allowed by policy." msgstr "" -#: ../src/Doc/library/cookielib.rst:174 +#: library/cookielib.rst:174 msgid "" "The :class:`CookieJar` will look for allowable :mailheader:`Set-Cookie` and :" "mailheader:`Set-Cookie2` headers in the *response* argument, and store " @@ -18034,7 +18131,7 @@ msgid "" msgstr "" # 219a1970e1214de28400b58ea3b3a160 -#: ../src/Doc/library/cookielib.rst:178 +#: library/cookielib.rst:178 msgid "" "The *response* object (usually the result of a call to :meth:`urllib2." "urlopen`, or similar) should support an :meth:`info` method, which returns " @@ -18043,7 +18140,7 @@ msgid "" msgstr "" # c578c727cae54b908b5a1cabde9ab552 -#: ../src/Doc/library/cookielib.rst:183 +#: library/cookielib.rst:183 msgid "" "The *request* object (usually a :class:`urllib2.Request` instance) must " "support the methods :meth:`get_full_url`, :meth:`get_host`, :meth:" @@ -18052,36 +18149,36 @@ msgid "" "as well as for checking that the cookie is allowed to be set." msgstr "" -#: ../src/Doc/library/cookielib.rst:192 +#: library/cookielib.rst:192 msgid "Set the :class:`CookiePolicy` instance to be used." msgstr "" -#: ../src/Doc/library/cookielib.rst:197 +#: library/cookielib.rst:197 msgid "" "Return sequence of :class:`Cookie` objects extracted from *response* object." msgstr "" -#: ../src/Doc/library/cookielib.rst:199 +#: library/cookielib.rst:199 msgid "" "See the documentation for :meth:`extract_cookies` for the interfaces " "required of the *response* and *request* arguments." msgstr "" -#: ../src/Doc/library/cookielib.rst:205 +#: library/cookielib.rst:205 msgid "Set a :class:`Cookie` if policy says it's OK to do so." msgstr "" -#: ../src/Doc/library/cookielib.rst:210 +#: library/cookielib.rst:210 msgid "" "Set a :class:`Cookie`, without checking with policy to see whether or not it " "should be set." msgstr "" -#: ../src/Doc/library/cookielib.rst:216 +#: library/cookielib.rst:216 msgid "Clear some cookies." msgstr "" -#: ../src/Doc/library/cookielib.rst:218 +#: library/cookielib.rst:218 msgid "" "If invoked without arguments, clear all cookies. If given a single " "argument, only cookies belonging to that *domain* will be removed. If given " @@ -18090,15 +18187,15 @@ msgid "" "*domain*, *path* and *name* is removed." msgstr "" -#: ../src/Doc/library/cookielib.rst:224 +#: library/cookielib.rst:224 msgid "Raises :exc:`KeyError` if no matching cookie exists." msgstr "" -#: ../src/Doc/library/cookielib.rst:229 +#: library/cookielib.rst:229 msgid "Discard all session cookies." msgstr "" -#: ../src/Doc/library/cookielib.rst:231 +#: library/cookielib.rst:231 msgid "" "Discards all contained cookies that have a true :attr:`discard` attribute " "(usually because they had either no ``max-age`` or ``expires`` cookie-" @@ -18107,27 +18204,27 @@ msgid "" "window." msgstr "" -#: ../src/Doc/library/cookielib.rst:236 +#: library/cookielib.rst:236 msgid "" "Note that the :meth:`save` method won't save session cookies anyway, unless " "you ask otherwise by passing a true *ignore_discard* argument." msgstr "" -#: ../src/Doc/library/cookielib.rst:239 +#: library/cookielib.rst:239 msgid ":class:`FileCookieJar` implements the following additional methods:" msgstr "" -#: ../src/Doc/library/cookielib.rst:244 +#: library/cookielib.rst:244 msgid "Save cookies to a file." msgstr "" -#: ../src/Doc/library/cookielib.rst:246 +#: library/cookielib.rst:246 msgid "" "This base class raises :exc:`NotImplementedError`. Subclasses may leave " "this method unimplemented." msgstr "" -#: ../src/Doc/library/cookielib.rst:249 +#: library/cookielib.rst:249 msgid "" "*filename* is the name of file in which to save cookies. If *filename* is " "not specified, :attr:`self.filename` is used (whose default is the value " @@ -18135,59 +18232,59 @@ msgid "" "`None`, :exc:`ValueError` is raised." msgstr "" -#: ../src/Doc/library/cookielib.rst:254 +#: library/cookielib.rst:254 msgid "" "*ignore_discard*: save even cookies set to be discarded. *ignore_expires*: " "save even cookies that have expired" msgstr "" -#: ../src/Doc/library/cookielib.rst:257 +#: library/cookielib.rst:257 msgid "" "The file is overwritten if it already exists, thus wiping all the cookies it " "contains. Saved cookies can be restored later using the :meth:`load` or :" "meth:`revert` methods." msgstr "" -#: ../src/Doc/library/cookielib.rst:264 +#: library/cookielib.rst:264 msgid "Load cookies from a file." msgstr "" -#: ../src/Doc/library/cookielib.rst:266 +#: library/cookielib.rst:266 msgid "Old cookies are kept unless overwritten by newly loaded ones." msgstr "" -#: ../src/Doc/library/cookielib.rst:268 +#: library/cookielib.rst:268 msgid "Arguments are as for :meth:`save`." msgstr "" -#: ../src/Doc/library/cookielib.rst:270 +#: library/cookielib.rst:270 msgid "" "The named file must be in the format understood by the class, or :exc:" "`LoadError` will be raised. Also, :exc:`IOError` may be raised, for example " "if the file does not exist." msgstr "" -#: ../src/Doc/library/cookielib.rst:282 +#: library/cookielib.rst:282 msgid "Clear all cookies and reload cookies from a saved file." msgstr "" -#: ../src/Doc/library/cookielib.rst:284 +#: library/cookielib.rst:284 msgid "" ":meth:`revert` can raise the same exceptions as :meth:`load`. If there is a " "failure, the object's state will not be altered." msgstr "" -#: ../src/Doc/library/cookielib.rst:287 +#: library/cookielib.rst:287 msgid ":class:`FileCookieJar` instances have the following public attributes:" msgstr "" -#: ../src/Doc/library/cookielib.rst:292 +#: library/cookielib.rst:292 msgid "" "Filename of default file in which to keep cookies. This attribute may be " "assigned to." msgstr "" -#: ../src/Doc/library/cookielib.rst:298 +#: library/cookielib.rst:298 msgid "" "If true, load cookies lazily from disk. This attribute should not be " "assigned to. This is only a hint, since this only affects performance, not " @@ -18196,18 +18293,18 @@ msgid "" "in the standard library lazily loads cookies." msgstr "" -#: ../src/Doc/library/cookielib.rst:308 +#: library/cookielib.rst:308 msgid "FileCookieJar subclasses and co-operation with web browsers" msgstr "" # 5fb1763a1de64ecaa8cacfdf4fe4c5ea -#: ../src/Doc/library/cookielib.rst:310 +#: library/cookielib.rst:310 msgid "" "The following :class:`CookieJar` subclasses are provided for reading and " "writing." msgstr "" -#: ../src/Doc/library/cookielib.rst:315 +#: library/cookielib.rst:315 msgid "" "A :class:`FileCookieJar` that can load from and save cookies to disk in the " "Mozilla ``cookies.txt`` file format (which is also used by the Lynx and " @@ -18215,32 +18312,32 @@ msgid "" msgstr "" # 240cf92fab654020a806fd52707a8285 -#: ../src/Doc/library/cookielib.rst:321 +#: library/cookielib.rst:321 msgid "" "Version 3 of the Firefox web browser no longer writes cookies in the " "``cookies.txt`` file format." msgstr "" -#: ../src/Doc/library/cookielib.rst:326 +#: library/cookielib.rst:326 msgid "" "This loses information about RFC 2965 cookies, and also about newer or non-" "standard cookie-attributes such as ``port``." msgstr "" -#: ../src/Doc/library/cookielib.rst:331 +#: library/cookielib.rst:331 msgid "" "Back up your cookies before saving if you have cookies whose loss / " "corruption would be inconvenient (there are some subtleties which may lead " "to slight changes in the file over a load / save round-trip)." msgstr "" -#: ../src/Doc/library/cookielib.rst:335 +#: library/cookielib.rst:335 msgid "" "Also note that cookies saved while Mozilla is running will get clobbered by " "Mozilla." msgstr "" -#: ../src/Doc/library/cookielib.rst:341 +#: library/cookielib.rst:341 msgid "" "A :class:`FileCookieJar` that can load from and save cookies to disk in " "format compatible with the libwww-perl library's ``Set-Cookie3`` file " @@ -18248,48 +18345,48 @@ msgid "" "file." msgstr "" -#: ../src/Doc/library/cookielib.rst:349 +#: library/cookielib.rst:349 msgid "CookiePolicy Objects" msgstr "" -#: ../src/Doc/library/cookielib.rst:351 +#: library/cookielib.rst:351 msgid "" "Objects implementing the :class:`CookiePolicy` interface have the following " "methods:" msgstr "" -#: ../src/Doc/library/cookielib.rst:357 +#: library/cookielib.rst:357 msgid "" "Return boolean value indicating whether cookie should be accepted from " "server." msgstr "" # 205fdf8768cb410d8e13a9e405020bfb -#: ../src/Doc/library/cookielib.rst:359 +#: library/cookielib.rst:359 msgid "" "*cookie* is a :class:`cookielib.Cookie` instance. *request* is an object " "implementing the interface defined by the documentation for :meth:`CookieJar." "extract_cookies`." msgstr "" -#: ../src/Doc/library/cookielib.rst:366 +#: library/cookielib.rst:366 msgid "" "Return boolean value indicating whether cookie should be returned to server." msgstr "" # 64e97ff3b0ea4a47b45223c4e509a0c4 -#: ../src/Doc/library/cookielib.rst:368 +#: library/cookielib.rst:368 msgid "" "*cookie* is a :class:`cookielib.Cookie` instance. *request* is an object " "implementing the interface defined by the documentation for :meth:`CookieJar." "add_cookie_header`." msgstr "" -#: ../src/Doc/library/cookielib.rst:375 +#: library/cookielib.rst:375 msgid "Return false if cookies should not be returned, given cookie domain." msgstr "" -#: ../src/Doc/library/cookielib.rst:377 +#: library/cookielib.rst:377 msgid "" "This method is an optimization. It removes the need for checking every " "cookie with a particular domain (which might involve reading many files). " @@ -18297,7 +18394,7 @@ msgid "" "leaves all the work to :meth:`return_ok`." msgstr "" -#: ../src/Doc/library/cookielib.rst:382 +#: library/cookielib.rst:382 msgid "" "If :meth:`domain_return_ok` returns true for the cookie domain, :meth:" "`path_return_ok` is called for the cookie path. Otherwise, :meth:" @@ -18307,7 +18404,7 @@ msgid "" "`return_ok` is never called for that cookie path." msgstr "" -#: ../src/Doc/library/cookielib.rst:389 +#: library/cookielib.rst:389 msgid "" "Note that :meth:`domain_return_ok` is called for every *cookie* domain, not " "just for the *request* domain. For example, the function might be called " @@ -18315,19 +18412,19 @@ msgid "" "domain is ``\"www.example.com\"``. The same goes for :meth:`path_return_ok`." msgstr "" -#: ../src/Doc/library/cookielib.rst:394 +#: library/cookielib.rst:394 msgid "The *request* argument is as documented for :meth:`return_ok`." msgstr "" -#: ../src/Doc/library/cookielib.rst:399 +#: library/cookielib.rst:399 msgid "Return false if cookies should not be returned, given cookie path." msgstr "" -#: ../src/Doc/library/cookielib.rst:401 +#: library/cookielib.rst:401 msgid "See the documentation for :meth:`domain_return_ok`." msgstr "" -#: ../src/Doc/library/cookielib.rst:403 +#: library/cookielib.rst:403 msgid "" "In addition to implementing the methods above, implementations of the :class:" "`CookiePolicy` interface must also supply the following attributes, " @@ -18335,21 +18432,21 @@ msgid "" "may be assigned to." msgstr "" -#: ../src/Doc/library/cookielib.rst:411 +#: library/cookielib.rst:411 msgid "Implement Netscape protocol." msgstr "" -#: ../src/Doc/library/cookielib.rst:416 +#: library/cookielib.rst:416 msgid "Implement RFC 2965 protocol." msgstr "" -#: ../src/Doc/library/cookielib.rst:421 +#: library/cookielib.rst:421 msgid "" "Don't add :mailheader:`Cookie2` header to requests (the presence of this " "header indicates to the server that we understand RFC 2965 cookies)." msgstr "" -#: ../src/Doc/library/cookielib.rst:424 +#: library/cookielib.rst:424 msgid "" "The most useful way to define a :class:`CookiePolicy` class is by " "subclassing from :class:`DefaultCookiePolicy` and overriding some or all of " @@ -18358,28 +18455,28 @@ msgid "" "to be useful)." msgstr "" -#: ../src/Doc/library/cookielib.rst:433 +#: library/cookielib.rst:433 msgid "DefaultCookiePolicy Objects" msgstr "" -#: ../src/Doc/library/cookielib.rst:435 +#: library/cookielib.rst:435 msgid "Implements the standard rules for accepting and returning cookies." msgstr "" -#: ../src/Doc/library/cookielib.rst:437 +#: library/cookielib.rst:437 msgid "" "Both RFC 2965 and Netscape cookies are covered. RFC 2965 handling is " "switched off by default." msgstr "" -#: ../src/Doc/library/cookielib.rst:440 +#: library/cookielib.rst:440 msgid "" "The easiest way to provide your own policy is to override this class and " "call its methods in your overridden implementations before adding your own " "additional checks::" msgstr "" -#: ../src/Doc/library/cookielib.rst:453 +#: library/cookielib.rst:453 msgid "" "In addition to the features required to implement the :class:`CookiePolicy` " "interface, this class allows you to block and allow domains from setting and " @@ -18388,7 +18485,7 @@ msgid "" "cost of blocking some benign cookies)." msgstr "" -#: ../src/Doc/library/cookielib.rst:459 +#: library/cookielib.rst:459 msgid "" "A domain blacklist and whitelist is provided (both off by default). Only " "domains not in the blacklist and present in the whitelist (if the whitelist " @@ -18399,7 +18496,7 @@ msgid "" "again by setting it to :const:`None`." msgstr "" -#: ../src/Doc/library/cookielib.rst:467 +#: library/cookielib.rst:467 msgid "" "Domains in block or allow lists that do not start with a dot must equal the " "cookie domain to be matched. For example, ``\"example.com\"`` matches a " @@ -18412,46 +18509,46 @@ msgid "" "192.168.1.2 is blocked, but 193.168.1.2 is not." msgstr "" -#: ../src/Doc/library/cookielib.rst:476 +#: library/cookielib.rst:476 msgid "" ":class:`DefaultCookiePolicy` implements the following additional methods:" msgstr "" -#: ../src/Doc/library/cookielib.rst:481 +#: library/cookielib.rst:481 msgid "Return the sequence of blocked domains (as a tuple)." msgstr "" -#: ../src/Doc/library/cookielib.rst:486 +#: library/cookielib.rst:486 msgid "Set the sequence of blocked domains." msgstr "" -#: ../src/Doc/library/cookielib.rst:491 +#: library/cookielib.rst:491 msgid "" "Return whether *domain* is on the blacklist for setting or receiving cookies." msgstr "" -#: ../src/Doc/library/cookielib.rst:496 +#: library/cookielib.rst:496 msgid "Return :const:`None`, or the sequence of allowed domains (as a tuple)." msgstr "" -#: ../src/Doc/library/cookielib.rst:501 +#: library/cookielib.rst:501 msgid "Set the sequence of allowed domains, or :const:`None`." msgstr "" -#: ../src/Doc/library/cookielib.rst:506 +#: library/cookielib.rst:506 msgid "" "Return whether *domain* is not on the whitelist for setting or receiving " "cookies." msgstr "" -#: ../src/Doc/library/cookielib.rst:509 +#: library/cookielib.rst:509 msgid "" ":class:`DefaultCookiePolicy` instances have the following attributes, which " "are all initialised from the constructor arguments of the same name, and " "which may all be assigned to." msgstr "" -#: ../src/Doc/library/cookielib.rst:516 +#: library/cookielib.rst:516 msgid "" "If true, request that the :class:`CookieJar` instance downgrade RFC 2109 " "cookies (ie. cookies received in a :mailheader:`Set-Cookie` header with a " @@ -18462,22 +18559,22 @@ msgid "" "default." msgstr "" -#: ../src/Doc/library/cookielib.rst:525 +#: library/cookielib.rst:525 msgid "General strictness switches:" msgstr "" -#: ../src/Doc/library/cookielib.rst:530 +#: library/cookielib.rst:530 msgid "" "Don't allow sites to set two-component domains with country-code top-level " "domains like ``.co.uk``, ``.gov.uk``, ``.co.nz``.etc. This is far from " "perfect and isn't guaranteed to work!" msgstr "" -#: ../src/Doc/library/cookielib.rst:534 +#: library/cookielib.rst:534 msgid "RFC 2965 protocol strictness switches:" msgstr "" -#: ../src/Doc/library/cookielib.rst:539 +#: library/cookielib.rst:539 msgid "" "Follow RFC 2965 rules on unverifiable transactions (usually, an unverifiable " "transaction is one resulting from a redirect or a request for an image " @@ -18485,45 +18582,45 @@ msgid "" "the basis of verifiability" msgstr "" -#: ../src/Doc/library/cookielib.rst:544 +#: library/cookielib.rst:544 msgid "Netscape protocol strictness switches:" msgstr "" -#: ../src/Doc/library/cookielib.rst:549 +#: library/cookielib.rst:549 msgid "" -"apply RFC 2965 rules on unverifiable transactions even to Netscape cookies" +"Apply RFC 2965 rules on unverifiable transactions even to Netscape cookies." msgstr "" -#: ../src/Doc/library/cookielib.rst:554 +#: library/cookielib.rst:554 msgid "" "Flags indicating how strict to be with domain-matching rules for Netscape " "cookies. See below for acceptable values." msgstr "" -#: ../src/Doc/library/cookielib.rst:560 +#: library/cookielib.rst:560 msgid "" "Ignore cookies in Set-Cookie: headers that have names starting with ``'$'``." msgstr "" -#: ../src/Doc/library/cookielib.rst:565 +#: library/cookielib.rst:565 msgid "Don't allow setting cookies whose path doesn't path-match request URI." msgstr "" -#: ../src/Doc/library/cookielib.rst:567 +#: library/cookielib.rst:567 msgid "" ":attr:`strict_ns_domain` is a collection of flags. Its value is constructed " "by or-ing together (for example, ``DomainStrictNoDots|" "DomainStrictNonDomain`` means both flags are set)." msgstr "" -#: ../src/Doc/library/cookielib.rst:574 +#: library/cookielib.rst:574 msgid "" "When setting cookies, the 'host prefix' must not contain a dot (eg. ``www." "foo.bar.com`` can't set a cookie for ``.bar.com``, because ``www.foo`` " "contains a dot)." msgstr "" -#: ../src/Doc/library/cookielib.rst:581 +#: library/cookielib.rst:581 msgid "" "Cookies that did not explicitly specify a ``domain`` cookie-attribute can " "only be returned to a domain equal to the domain that set the cookie (eg. " @@ -18531,28 +18628,28 @@ msgid "" "no ``domain`` cookie-attribute)." msgstr "" -#: ../src/Doc/library/cookielib.rst:589 +#: library/cookielib.rst:589 msgid "When setting cookies, require a full RFC 2965 domain-match." msgstr "" -#: ../src/Doc/library/cookielib.rst:591 +#: library/cookielib.rst:591 msgid "" "The following attributes are provided for convenience, and are the most " "useful combinations of the above flags:" msgstr "" -#: ../src/Doc/library/cookielib.rst:597 +#: library/cookielib.rst:597 msgid "" "Equivalent to 0 (ie. all of the above Netscape domain strictness flags " "switched off)." msgstr "" -#: ../src/Doc/library/cookielib.rst:603 +#: library/cookielib.rst:603 msgid "Equivalent to ``DomainStrictNoDots|DomainStrictNonDomain``." msgstr "" # 67bff869c80e4c6f86fda598ffa0d31a -#: ../src/Doc/library/cookielib.rst:611 +#: library/cookielib.rst:611 msgid "" ":class:`Cookie` instances have Python attributes roughly corresponding to " "the standard cookie-attributes specified in the various cookie standards. " @@ -18563,7 +18660,7 @@ msgid "" "cookies." msgstr "" -#: ../src/Doc/library/cookielib.rst:619 +#: library/cookielib.rst:619 msgid "" "Assignment to these attributes should not be necessary other than in rare " "circumstances in a :class:`CookiePolicy` method. The class does not enforce " @@ -18571,7 +18668,7 @@ msgid "" msgstr "" # 66b7f7996c2e441e9795a6bb34723693 -#: ../src/Doc/library/cookielib.rst:626 +#: library/cookielib.rst:626 msgid "" "Integer or :const:`None`. Netscape cookies have :attr:`version` 0. RFC 2965 " "and RFC 2109 cookies have a ``version`` cookie-attribute of 1. However, " @@ -18579,54 +18676,54 @@ msgid "" "cookies, in which case :attr:`version` is 0." msgstr "" -#: ../src/Doc/library/cookielib.rst:634 +#: library/cookielib.rst:634 msgid "Cookie name (a string)." msgstr "" -#: ../src/Doc/library/cookielib.rst:639 +#: library/cookielib.rst:639 msgid "Cookie value (a string), or :const:`None`." msgstr "" -#: ../src/Doc/library/cookielib.rst:644 +#: library/cookielib.rst:644 msgid "" "String representing a port or a set of ports (eg. '80', or '80,8080'), or :" "const:`None`." msgstr "" -#: ../src/Doc/library/cookielib.rst:650 +#: library/cookielib.rst:650 msgid "Cookie path (a string, eg. ``'/acme/rocket_launchers'``)." msgstr "" # eca7c85a4a4d46c8984b363b5c3c6632 -#: ../src/Doc/library/cookielib.rst:655 +#: library/cookielib.rst:655 msgid "``True`` if cookie should only be returned over a secure connection." msgstr "" -#: ../src/Doc/library/cookielib.rst:660 +#: library/cookielib.rst:660 msgid "" "Integer expiry date in seconds since epoch, or :const:`None`. See also the :" "meth:`is_expired` method." msgstr "" # d9333dd432d44672b2725ec91374a7fb -#: ../src/Doc/library/cookielib.rst:666 +#: library/cookielib.rst:666 msgid "``True`` if this is a session cookie." msgstr "" -#: ../src/Doc/library/cookielib.rst:671 +#: library/cookielib.rst:671 msgid "" "String comment from the server explaining the function of this cookie, or :" "const:`None`." msgstr "" -#: ../src/Doc/library/cookielib.rst:677 +#: library/cookielib.rst:677 msgid "" "URL linking to a comment from the server explaining the function of this " "cookie, or :const:`None`." msgstr "" # 45a5ef8341aa443da5a7bd5de663da09 -#: ../src/Doc/library/cookielib.rst:683 +#: library/cookielib.rst:683 msgid "" "``True`` if this cookie was received as an RFC 2109 cookie (ie. the cookie " "arrived in a :mailheader:`Set-Cookie` header, and the value of the Version " @@ -18636,50 +18733,50 @@ msgid "" msgstr "" # dc39d65d185340bf8c9bdb7fde6e79e7 -#: ../src/Doc/library/cookielib.rst:694 +#: library/cookielib.rst:694 msgid "" "``True`` if a port or set of ports was explicitly specified by the server " "(in the :mailheader:`Set-Cookie` / :mailheader:`Set-Cookie2` header)." msgstr "" # 47a5107f1b2a42d8ac9215b8e0839702 -#: ../src/Doc/library/cookielib.rst:700 +#: library/cookielib.rst:700 msgid "``True`` if a domain was explicitly specified by the server." msgstr "" # 056ec2ed868a4e49898db7728fc9ab11 -#: ../src/Doc/library/cookielib.rst:705 +#: library/cookielib.rst:705 msgid "" "``True`` if the domain explicitly specified by the server began with a dot " "(``'.'``)." msgstr "" -#: ../src/Doc/library/cookielib.rst:708 +#: library/cookielib.rst:708 msgid "" "Cookies may have additional non-standard cookie-attributes. These may be " "accessed using the following methods:" msgstr "" -#: ../src/Doc/library/cookielib.rst:714 +#: library/cookielib.rst:714 msgid "Return true if cookie has the named cookie-attribute." msgstr "" -#: ../src/Doc/library/cookielib.rst:719 +#: library/cookielib.rst:719 msgid "" "If cookie has the named cookie-attribute, return its value. Otherwise, " "return *default*." msgstr "" -#: ../src/Doc/library/cookielib.rst:725 +#: library/cookielib.rst:725 msgid "Set the value of the named cookie-attribute." msgstr "" -#: ../src/Doc/library/cookielib.rst:727 +#: library/cookielib.rst:727 msgid "The :class:`Cookie` class also defines the following method:" msgstr "" # 50a63effb3d849e9bcfc5dbbff982a26 -#: ../src/Doc/library/cookielib.rst:732 +#: library/cookielib.rst:732 msgid "" "``True`` if cookie has passed the time at which the server requested it " "should expire. If *now* is given (in seconds since the epoch), return " @@ -18687,18 +18784,18 @@ msgid "" msgstr "" # d654c8dd4e054c83889af74e730ae325 -#: ../src/Doc/library/cookielib.rst:742 +#: library/cookielib.rst:742 msgid "The first example shows the most common usage of :mod:`cookielib`::" msgstr "" -#: ../src/Doc/library/cookielib.rst:749 +#: library/cookielib.rst:749 msgid "" "This example illustrates how to open a URL using your Netscape, Mozilla, or " "Lynx cookies (assumes Unix/Netscape convention for location of the cookies " "file)::" msgstr "" -#: ../src/Doc/library/cookielib.rst:758 +#: library/cookielib.rst:758 msgid "" "The next example illustrates the use of :class:`DefaultCookiePolicy`. Turn " "on RFC 2965 cookies, be more strict about domains when setting and returning " @@ -18706,12 +18803,12 @@ msgid "" "returned::" msgstr "" -#: ../src/Doc/library/copy.rst:2 +#: library/copy.rst:2 msgid ":mod:`copy` --- Shallow and deep copy operations" msgstr "" # a591713078c040cea092915e6550cb76 -#: ../src/Doc/library/copy.rst:7 +#: library/copy.rst:7 msgid "" "Assignment statements in Python do not copy objects, they create bindings " "between a target and an object. For collections that are mutable or contain " @@ -18720,76 +18817,76 @@ msgid "" "operations (explained below)." msgstr "" -#: ../src/Doc/library/copy.rst:14 +#: library/copy.rst:14 msgid "Interface summary:" msgstr "" -#: ../src/Doc/library/copy.rst:18 +#: library/copy.rst:18 msgid "Return a shallow copy of *x*." msgstr "" -#: ../src/Doc/library/copy.rst:23 +#: library/copy.rst:23 msgid "Return a deep copy of *x*." msgstr "" -#: ../src/Doc/library/copy.rst:28 +#: library/copy.rst:28 msgid "Raised for module specific errors." msgstr "" -#: ../src/Doc/library/copy.rst:31 +#: library/copy.rst:31 msgid "" "The difference between shallow and deep copying is only relevant for " "compound objects (objects that contain other objects, like lists or class " "instances):" msgstr "" -#: ../src/Doc/library/copy.rst:34 +#: library/copy.rst:34 msgid "" "A *shallow copy* constructs a new compound object and then (to the extent " "possible) inserts *references* into it to the objects found in the original." msgstr "" -#: ../src/Doc/library/copy.rst:37 +#: library/copy.rst:37 msgid "" "A *deep copy* constructs a new compound object and then, recursively, " "inserts *copies* into it of the objects found in the original." msgstr "" -#: ../src/Doc/library/copy.rst:40 +#: library/copy.rst:40 msgid "" "Two problems often exist with deep copy operations that don't exist with " "shallow copy operations:" msgstr "" -#: ../src/Doc/library/copy.rst:43 +#: library/copy.rst:43 msgid "" "Recursive objects (compound objects that, directly or indirectly, contain a " "reference to themselves) may cause a recursive loop." msgstr "" -#: ../src/Doc/library/copy.rst:46 +#: library/copy.rst:46 msgid "" "Because deep copy copies *everything* it may copy too much, e.g., " "administrative data structures that should be shared even between copies." msgstr "" -#: ../src/Doc/library/copy.rst:49 +#: library/copy.rst:49 msgid "The :func:`deepcopy` function avoids these problems by:" msgstr "" -#: ../src/Doc/library/copy.rst:51 +#: library/copy.rst:51 msgid "" "keeping a \"memo\" dictionary of objects already copied during the current " "copying pass; and" msgstr "" -#: ../src/Doc/library/copy.rst:54 +#: library/copy.rst:54 msgid "" "letting user-defined classes override the copying operation or the set of " "components copied." msgstr "" -#: ../src/Doc/library/copy.rst:57 +#: library/copy.rst:57 msgid "" "This module does not copy types like module, method, stack trace, stack " "frame, file, socket, window, array, or any similar types. It does \"copy\" " @@ -18798,15 +18895,19 @@ msgid "" "`pickle` module." msgstr "" -#: ../src/Doc/library/copy.rst:62 +#: library/copy.rst:62 msgid "" "Shallow copies of dictionaries can be made using :meth:`dict.copy`, and of " "lists by assigning a slice of the entire list, for example, ``copied_list = " "original_list[:]``." msgstr "" +#: library/copy.rst:66 +msgid "Added copying functions." +msgstr "" + # 93fff305460547b0a7bc3e22fbb63aee -#: ../src/Doc/library/copy.rst:71 +#: library/copy.rst:71 msgid "" "Classes can use the same interfaces to control copying that they use to " "control pickling. See the description of module :mod:`pickle` for " @@ -18814,7 +18915,7 @@ msgid "" "`copy_reg` registration module." msgstr "" -#: ../src/Doc/library/copy.rst:80 +#: library/copy.rst:80 msgid "" "In order for a class to define its own copy implementation, it can define " "special methods :meth:`__copy__` and :meth:`__deepcopy__`. The former is " @@ -18826,35 +18927,33 @@ msgid "" "dictionary as second argument." msgstr "" -# e90f6108c9f842f9affc388fdfdf9bb2 -# 181459b56a2e4b73b70991583d172ba4 -#: ../src/Doc/library/copy.rst:91 ../src/Doc/library/shelve.rst:203 -msgid "Module :mod:`pickle`" -msgstr "" +#: library/copy.rst:92 library/shelve.rst:204 +#, fuzzy +msgid "Module pickle" +msgstr "Modules" -#: ../src/Doc/library/copy.rst:92 +#: library/copy.rst:92 msgid "" "Discussion of the special methods used to support object state retrieval and " "restoration." msgstr "" # 2244e8de5bad491abdc9b211acdf07cd -#: ../src/Doc/library/copy_reg.rst:2 +#: library/copy_reg.rst:2 msgid ":mod:`copy_reg` --- Register :mod:`pickle` support functions" msgstr "" # 91d92c75a1bf4d94938465df7eff9bab -#: ../src/Doc/library/copy_reg.rst:8 +#: library/copy_reg.rst:8 msgid "" "The :mod:`copy_reg` module has been renamed to :mod:`copyreg` in Python 3. " "The :term:`2to3` tool will automatically adapt imports when converting your " "sources to Python 3." msgstr "" -# 34cfbeb96b1347aa8a58a6062774c1c2 -#: ../src/Doc/library/copy_reg.rst:17 +#: library/copy_reg.rst:17 msgid "" -"The :mod:`copy_reg` module offers a way to define fuctions used while " +"The :mod:`copy_reg` module offers a way to define functions used while " "pickling specific objects. The :mod:`pickle`, :mod:`cPickle`, and :mod:" "`copy` modules use those functions when pickling/copying those objects. The " "module provides configuration information about object constructors which " @@ -18862,14 +18961,14 @@ msgid "" "instances." msgstr "" -#: ../src/Doc/library/copy_reg.rst:26 +#: library/copy_reg.rst:26 msgid "" "Declares *object* to be a valid constructor. If *object* is not callable " "(and hence not valid as a constructor), raises :exc:`TypeError`." msgstr "" # 8bf883a104624f19a4d43c0c2c300d63 -#: ../src/Doc/library/copy_reg.rst:32 +#: library/copy_reg.rst:32 msgid "" "Declares that *function* should be used as a \"reduction\" function for " "objects of type *type*; *type* must not be a \"classic\" class object. " @@ -18878,7 +18977,7 @@ msgid "" "tuple containing two or three elements." msgstr "" -#: ../src/Doc/library/copy_reg.rst:38 +#: library/copy_reg.rst:38 msgid "" "The optional *constructor* parameter, if provided, is a callable object " "which can be used to reconstruct the object when called with the tuple of " @@ -18886,24 +18985,24 @@ msgid "" "raised if *object* is a class or *constructor* is not callable." msgstr "" -#: ../src/Doc/library/copy_reg.rst:43 +#: library/copy_reg.rst:43 msgid "" "See the :mod:`pickle` module for more details on the interface expected of " "*function* and *constructor*." msgstr "" # a3d804f09be24465af0db7310f7fa09f -#: ../src/Doc/library/copy_reg.rst:49 +#: library/copy_reg.rst:49 msgid "" "The example below would like to show how to register a pickle function and " "how it will be used:" msgstr "" -#: ../src/Doc/library/crypt.rst:3 +#: library/crypt.rst:3 msgid ":mod:`crypt` --- Function to check Unix passwords" msgstr "" -#: ../src/Doc/library/crypt.rst:17 +#: library/crypt.rst:17 msgid "" "This module implements an interface to the :manpage:`crypt(3)` routine, " "which is a one-way hash function based upon a modified DES algorithm; see " @@ -18912,7 +19011,7 @@ msgid "" "crack Unix passwords with a dictionary." msgstr "" -#: ../src/Doc/library/crypt.rst:25 +#: library/crypt.rst:25 msgid "" "Notice that the behavior of this module depends on the actual " "implementation of the :manpage:`crypt(3)` routine in the running system. " @@ -18920,7 +19019,7 @@ msgid "" "be available on this module." msgstr "" -#: ../src/Doc/library/crypt.rst:33 +#: library/crypt.rst:33 msgid "" "*word* will usually be a user's password as typed at a prompt or in a " "graphical interface. *salt* is usually a random two-character string which " @@ -18931,22 +19030,22 @@ msgid "" "itself)." msgstr "" -#: ../src/Doc/library/crypt.rst:42 +#: library/crypt.rst:42 msgid "" "Since a few :manpage:`crypt(3)` extensions allow different values, with " "different sizes in the *salt*, it is recommended to use the full crypted " "password as salt when checking for a password." msgstr "" -#: ../src/Doc/library/crypt.rst:46 ../src/Doc/library/telnetlib.rst:223 +#: library/crypt.rst:46 library/telnetlib.rst:223 msgid "A simple example illustrating typical use::" msgstr "" -#: ../src/Doc/library/crypto.rst:6 +#: library/crypto.rst:6 msgid "Cryptographic Services" msgstr "" -#: ../src/Doc/library/crypto.rst:10 +#: library/crypto.rst:10 msgid "" "The modules described in this chapter implement various algorithms of a " "cryptographic nature. They are available at the discretion of the " @@ -18954,7 +19053,7 @@ msgid "" msgstr "" # e48e1ab7304644e8a8f2127e111db241 -#: ../src/Doc/library/crypto.rst:26 +#: library/crypto.rst:26 msgid "" "Hardcore cypherpunks will probably find the cryptographic modules written by " "A.M. Kuchling of further interest; the package contains modules for various " @@ -18963,11 +19062,11 @@ msgid "" "for more information." msgstr "" -#: ../src/Doc/library/csv.rst:3 +#: library/csv.rst:3 msgid ":mod:`csv` --- CSV File Reading and Writing" msgstr "" -#: ../src/Doc/library/csv.rst:16 +#: library/csv.rst:16 msgid "" "The so-called CSV (Comma Separated Values) format is the most common import " "and export format for spreadsheets and databases. There is no \"CSV standard" @@ -18981,7 +19080,7 @@ msgid "" "reading and writing the data from the programmer." msgstr "" -#: ../src/Doc/library/csv.rst:27 +#: library/csv.rst:27 msgid "" "The :mod:`csv` module implements classes to read and write tabular data in " "CSV format. It allows programmers to say, \"write this data in the format " @@ -18991,7 +19090,7 @@ msgid "" "applications or define their own special-purpose CSV formats." msgstr "" -#: ../src/Doc/library/csv.rst:34 +#: library/csv.rst:34 msgid "" "The :mod:`csv` module's :class:`reader` and :class:`writer` objects read and " "write sequences. Programmers can also read and write data in dictionary " @@ -18999,7 +19098,7 @@ msgid "" msgstr "" # 78bab3b40b0042e797e3a77210e654de -#: ../src/Doc/library/csv.rst:40 +#: library/csv.rst:40 msgid "" "This version of the :mod:`csv` module doesn't support Unicode input. Also, " "there are currently some issues regarding ASCII NUL characters. " @@ -19007,26 +19106,24 @@ msgid "" "the examples in section :ref:`csv-examples`." msgstr "" -# 5243454b22164707b098b1d94c625ed1 -#: ../src/Doc/library/csv.rst:47 -msgid ":pep:`305` - CSV File API" +#: library/csv.rst:48 +msgid "PEP 305 - CSV File API" msgstr "" -#: ../src/Doc/library/csv.rst:49 +#: library/csv.rst:49 msgid "The Python Enhancement Proposal which proposed this addition to Python." msgstr "" -#: ../src/Doc/library/csv.rst:55 ../src/Doc/library/re.rst:426 -#: ../src/Doc/library/xml.dom.rst:87 +#: library/csv.rst:55 library/re.rst:429 library/xml.dom.rst:87 msgid "Module Contents" msgstr "" -#: ../src/Doc/library/csv.rst:57 +#: library/csv.rst:57 msgid "The :mod:`csv` module defines the following functions:" msgstr "" # 608f3f2678ea4545a7bf71fd1bcaa966 -#: ../src/Doc/library/csv.rst:62 +#: library/csv.rst:62 msgid "" "Return a reader object which will iterate over lines in the given *csvfile*. " "*csvfile* can be any object which supports the :term:`iterator` protocol and " @@ -19043,18 +19140,31 @@ msgid "" msgstr "" # 8f0e315cb1ee482e8bea893c68525151 -#: ../src/Doc/library/csv.rst:75 +#: library/csv.rst:75 msgid "" "Each row read from the csv file is returned as a list of strings. No " "automatic data type conversion is performed." msgstr "" -#: ../src/Doc/library/csv.rst:78 ../src/Doc/library/csv.rst:117 +#: library/csv.rst:78 library/csv.rst:117 library/csv.rst:183 +#: library/csv.rst:217 msgid "A short usage example::" msgstr "" +#: library/csv.rst:88 +msgid "" +"The parser is now stricter with respect to multi-line quoted fields. " +"Previously, if a line ended within a quoted field without a terminating " +"newline character, a newline would be inserted into the returned field. This " +"behavior caused problems when reading files which contained carriage return " +"characters within fields. The behavior was changed to return the field " +"without inserting newlines. As a consequence, if newlines embedded within " +"fields are important, the input should be split into lines in a manner which " +"preserves the newline characters." +msgstr "" + # dfc8744c75e74c57a0b68aad4a988842 -#: ../src/Doc/library/csv.rst:100 +#: library/csv.rst:100 msgid "" "Return a writer object responsible for converting the user's data into " "delimited strings on the given file-like object. *csvfile* can be any " @@ -19075,7 +19185,7 @@ msgid "" msgstr "" # 5af36c473b634948a31aa3e5df234d11 -#: ../src/Doc/library/csv.rst:129 +#: library/csv.rst:129 msgid "" "Associate *dialect* with *name*. *name* must be a string or Unicode object. " "The dialect can be specified either by passing a sub-class of :class:" @@ -19084,35 +19194,42 @@ msgid "" "dialect and formatting parameters, see section :ref:`csv-fmt-params`." msgstr "" -#: ../src/Doc/library/csv.rst:138 +#: library/csv.rst:138 msgid "" "Delete the dialect associated with *name* from the dialect registry. An :" "exc:`Error` is raised if *name* is not a registered dialect name." msgstr "" # 5b07dafa2b204658916f5612b79b17b4 -#: ../src/Doc/library/csv.rst:144 +#: library/csv.rst:144 msgid "" "Return the dialect associated with *name*. An :exc:`Error` is raised if " "*name* is not a registered dialect name." msgstr "" -#: ../src/Doc/library/csv.rst:154 +#: library/csv.rst:147 +msgid "" +"This function now returns an immutable :class:`Dialect`. Previously an " +"instance of the requested dialect was returned. Users could modify the " +"underlying class, changing the behavior of active readers and writers." +msgstr "" + +#: library/csv.rst:154 msgid "Return the names of all registered dialects." msgstr "" -#: ../src/Doc/library/csv.rst:159 +#: library/csv.rst:159 msgid "" "Returns the current maximum field size allowed by the parser. If *new_limit* " "is given, this becomes the new limit." msgstr "" -#: ../src/Doc/library/csv.rst:164 +#: library/csv.rst:164 msgid "The :mod:`csv` module defines the following classes:" msgstr "" # 42bec5deb93f4eb6a3b5e604732eec15 -#: ../src/Doc/library/csv.rst:170 +#: library/csv.rst:170 msgid "" "Create an object which operates like a regular reader but maps the " "information read into a dict whose keys are given by the optional " @@ -19129,7 +19246,7 @@ msgid "" msgstr "" # 471db8f6a15445bfb150cc29a86ef549 -#: ../src/Doc/library/csv.rst:187 +#: library/csv.rst:199 msgid "" "Create an object which operates like a regular writer but maps dictionaries " "onto output rows. The *fieldnames* parameter is a :ref:`sequence " @@ -19145,7 +19262,7 @@ msgid "" "`writer` instance." msgstr "" -#: ../src/Doc/library/csv.rst:200 +#: library/csv.rst:212 msgid "" "Note that unlike the :class:`DictReader` class, the *fieldnames* parameter " "of the :class:`DictWriter` is not optional. Since Python's :class:`dict` " @@ -19153,75 +19270,75 @@ msgid "" "the order in which the row should be written to the *csvfile*." msgstr "" -#: ../src/Doc/library/csv.rst:208 +#: library/csv.rst:233 msgid "" "The :class:`Dialect` class is a container class relied on primarily for its " "attributes, which are used to define the parameters for a specific :class:" "`reader` or :class:`writer` instance." msgstr "" -#: ../src/Doc/library/csv.rst:215 +#: library/csv.rst:240 msgid "" "The :class:`excel` class defines the usual properties of an Excel-generated " "CSV file. It is registered with the dialect name ``'excel'``." msgstr "" -#: ../src/Doc/library/csv.rst:221 +#: library/csv.rst:246 msgid "" "The :class:`excel_tab` class defines the usual properties of an Excel-" "generated TAB-delimited file. It is registered with the dialect name " "``'excel-tab'``." msgstr "" -#: ../src/Doc/library/csv.rst:227 +#: library/csv.rst:252 msgid "The :class:`Sniffer` class is used to deduce the format of a CSV file." msgstr "" -#: ../src/Doc/library/csv.rst:229 +#: library/csv.rst:254 msgid "The :class:`Sniffer` class provides two methods:" msgstr "" -#: ../src/Doc/library/csv.rst:233 +#: library/csv.rst:258 msgid "" "Analyze the given *sample* and return a :class:`Dialect` subclass reflecting " "the parameters found. If the optional *delimiters* parameter is given, it " "is interpreted as a string containing possible valid delimiter characters." msgstr "" -#: ../src/Doc/library/csv.rst:241 +#: library/csv.rst:266 msgid "" "Analyze the sample text (presumed to be in CSV format) and return :const:" "`True` if the first row appears to be a series of column headers." msgstr "" -#: ../src/Doc/library/csv.rst:244 +#: library/csv.rst:269 msgid "An example for :class:`Sniffer` use::" msgstr "" -#: ../src/Doc/library/csv.rst:253 +#: library/csv.rst:278 msgid "The :mod:`csv` module defines the following constants:" msgstr "" -#: ../src/Doc/library/csv.rst:257 +#: library/csv.rst:282 msgid "Instructs :class:`writer` objects to quote all fields." msgstr "" -#: ../src/Doc/library/csv.rst:262 +#: library/csv.rst:287 msgid "" "Instructs :class:`writer` objects to only quote those fields which contain " "special characters such as *delimiter*, *quotechar* or any of the characters " "in *lineterminator*." msgstr "" -#: ../src/Doc/library/csv.rst:269 +#: library/csv.rst:294 msgid "Instructs :class:`writer` objects to quote all non-numeric fields." msgstr "" -#: ../src/Doc/library/csv.rst:271 +#: library/csv.rst:296 msgid "Instructs the reader to convert all non-quoted fields to type *float*." msgstr "" -#: ../src/Doc/library/csv.rst:276 +#: library/csv.rst:301 msgid "" "Instructs :class:`writer` objects to never quote fields. When the current " "*delimiter* occurs in output data it is preceded by the current *escapechar* " @@ -19229,25 +19346,25 @@ msgid "" "if any characters that require escaping are encountered." msgstr "" -#: ../src/Doc/library/csv.rst:281 +#: library/csv.rst:306 msgid "" "Instructs :class:`reader` to perform no special processing of quote " "characters." msgstr "" -#: ../src/Doc/library/csv.rst:283 +#: library/csv.rst:308 msgid "The :mod:`csv` module defines the following exception:" msgstr "" -#: ../src/Doc/library/csv.rst:288 +#: library/csv.rst:313 msgid "Raised by any of the functions when an error is detected." msgstr "" -#: ../src/Doc/library/csv.rst:294 +#: library/csv.rst:319 msgid "Dialects and Formatting Parameters" msgstr "" -#: ../src/Doc/library/csv.rst:296 +#: library/csv.rst:321 msgid "" "To make it easier to specify the format of input and output records, " "specific formatting parameters are grouped together into dialects. A " @@ -19260,30 +19377,30 @@ msgid "" "attributes defined below for the :class:`Dialect` class." msgstr "" -#: ../src/Doc/library/csv.rst:306 +#: library/csv.rst:331 msgid "Dialects support the following attributes:" msgstr "" -#: ../src/Doc/library/csv.rst:311 +#: library/csv.rst:336 msgid "" "A one-character string used to separate fields. It defaults to ``','``." msgstr "" -#: ../src/Doc/library/csv.rst:316 +#: library/csv.rst:341 msgid "" -"Controls how instances of *quotechar* appearing inside a field should be " +"Controls how instances of *quotechar* appearing inside a field should " "themselves be quoted. When :const:`True`, the character is doubled. When :" "const:`False`, the *escapechar* is used as a prefix to the *quotechar*. It " "defaults to :const:`True`." msgstr "" -#: ../src/Doc/library/csv.rst:321 +#: library/csv.rst:346 msgid "" "On output, if *doublequote* is :const:`False` and no *escapechar* is set, :" "exc:`Error` is raised if a *quotechar* is found in a field." msgstr "" -#: ../src/Doc/library/csv.rst:327 +#: library/csv.rst:352 msgid "" "A one-character string used by the writer to escape the *delimiter* if " "*quoting* is set to :const:`QUOTE_NONE` and the *quotechar* if *doublequote* " @@ -19292,92 +19409,92 @@ msgid "" "escaping." msgstr "" -#: ../src/Doc/library/csv.rst:335 +#: library/csv.rst:360 msgid "" "The string used to terminate lines produced by the :class:`writer`. It " "defaults to ``'\\r\\n'``." msgstr "" -#: ../src/Doc/library/csv.rst:340 +#: library/csv.rst:365 msgid "" "The :class:`reader` is hard-coded to recognise either ``'\\r'`` or ``'\\n'`` " "as end-of-line, and ignores *lineterminator*. This behavior may change in " "the future." msgstr "" -#: ../src/Doc/library/csv.rst:347 +#: library/csv.rst:372 msgid "" "A one-character string used to quote fields containing special characters, " "such as the *delimiter* or *quotechar*, or which contain new-line " "characters. It defaults to ``'\"'``." msgstr "" -#: ../src/Doc/library/csv.rst:354 +#: library/csv.rst:379 msgid "" "Controls when quotes should be generated by the writer and recognised by the " "reader. It can take on any of the :const:`QUOTE_\\*` constants (see " "section :ref:`csv-contents`) and defaults to :const:`QUOTE_MINIMAL`." msgstr "" -#: ../src/Doc/library/csv.rst:361 +#: library/csv.rst:386 msgid "" "When :const:`True`, whitespace immediately following the *delimiter* is " "ignored. The default is :const:`False`." msgstr "" # 50563a870c924628af73bc4392b9cc3e -#: ../src/Doc/library/csv.rst:367 +#: library/csv.rst:392 msgid "" "When ``True``, raise exception :exc:`Error` on bad CSV input. The default is " "``False``." msgstr "" -#: ../src/Doc/library/csv.rst:371 +#: library/csv.rst:396 msgid "Reader Objects" msgstr "" -#: ../src/Doc/library/csv.rst:373 +#: library/csv.rst:398 msgid "" "Reader objects (:class:`DictReader` instances and objects returned by the :" "func:`reader` function) have the following public methods:" msgstr "" # 898b8644b8e1494680f9979f457f236a -#: ../src/Doc/library/csv.rst:379 +#: library/csv.rst:404 msgid "" "Return the next row of the reader's iterable object as a list, parsed " "according to the current dialect." msgstr "" -#: ../src/Doc/library/csv.rst:382 +#: library/csv.rst:407 msgid "Reader objects have the following public attributes:" msgstr "" -#: ../src/Doc/library/csv.rst:387 +#: library/csv.rst:412 msgid "A read-only description of the dialect in use by the parser." msgstr "" -#: ../src/Doc/library/csv.rst:392 +#: library/csv.rst:417 msgid "" "The number of lines read from the source iterator. This is not the same as " "the number of records returned, as records can span multiple lines." msgstr "" -#: ../src/Doc/library/csv.rst:398 +#: library/csv.rst:423 msgid "DictReader objects have the following public attribute:" msgstr "" -#: ../src/Doc/library/csv.rst:403 +#: library/csv.rst:428 msgid "" "If not passed as a parameter when creating the object, this attribute is " "initialized upon first access or when the first record is read from the file." msgstr "" -#: ../src/Doc/library/csv.rst:411 +#: library/csv.rst:436 msgid "Writer Objects" msgstr "" -#: ../src/Doc/library/csv.rst:413 +#: library/csv.rst:438 msgid "" ":class:`Writer` objects (:class:`DictWriter` instances and objects returned " "by the :func:`writer` function) have the following public methods. A *row* " @@ -19389,64 +19506,64 @@ msgid "" "complex numbers at all)." msgstr "" -#: ../src/Doc/library/csv.rst:424 +#: library/csv.rst:449 msgid "" "Write the *row* parameter to the writer's file object, formatted according " "to the current dialect." msgstr "" -#: ../src/Doc/library/csv.rst:430 +#: library/csv.rst:455 msgid "" "Write all the *rows* parameters (a list of *row* objects as described above) " "to the writer's file object, formatted according to the current dialect." msgstr "" -#: ../src/Doc/library/csv.rst:433 +#: library/csv.rst:458 msgid "Writer objects have the following public attribute:" msgstr "" -#: ../src/Doc/library/csv.rst:438 +#: library/csv.rst:463 msgid "A read-only description of the dialect in use by the writer." msgstr "" -#: ../src/Doc/library/csv.rst:441 +#: library/csv.rst:466 msgid "DictWriter objects have the following public method:" msgstr "" -#: ../src/Doc/library/csv.rst:446 +#: library/csv.rst:471 msgid "Write a row with the field names (as specified in the constructor)." msgstr "" -#: ../src/Doc/library/csv.rst:456 +#: library/csv.rst:481 msgid "The simplest example of reading a CSV file::" msgstr "" -#: ../src/Doc/library/csv.rst:464 +#: library/csv.rst:489 msgid "Reading a file with an alternate format::" msgstr "" -#: ../src/Doc/library/csv.rst:472 +#: library/csv.rst:497 msgid "The corresponding simplest possible writing example is::" msgstr "" -#: ../src/Doc/library/csv.rst:479 +#: library/csv.rst:504 msgid "Registering a new dialect::" msgstr "" -#: ../src/Doc/library/csv.rst:486 +#: library/csv.rst:511 msgid "" "A slightly more advanced use of the reader --- catching and reporting " "errors::" msgstr "" -#: ../src/Doc/library/csv.rst:498 +#: library/csv.rst:523 msgid "" "And while the module doesn't directly support parsing strings, it can easily " "be done::" msgstr "" # 720276592f15423a9871de87216695c5 -#: ../src/Doc/library/csv.rst:505 +#: library/csv.rst:530 msgid "" "The :mod:`csv` module doesn't directly support reading and writing Unicode, " "but it is 8-bit-clean save for some problems with ASCII NUL characters. So " @@ -19456,7 +19573,7 @@ msgid "" msgstr "" # 4b56dd8f1e1744eda7b0f3f6e0cff30b -#: ../src/Doc/library/csv.rst:510 +#: library/csv.rst:535 msgid "" ":func:`unicode_csv_reader` below is a :term:`generator` that wraps :class:" "`csv.reader` to handle Unicode CSV data (a list of Unicode strings). :func:" @@ -19467,7 +19584,7 @@ msgid "" msgstr "" # 4a6d13777de5490bab3352f51f6e5072 -#: ../src/Doc/library/csv.rst:530 +#: library/csv.rst:555 msgid "" "For all other encodings the following :class:`UnicodeReader` and :class:" "`UnicodeWriter` classes can be used. They take an additional *encoding* " @@ -19475,29 +19592,29 @@ msgid "" "reader or writer encoded as UTF-8::" msgstr "" -#: ../src/Doc/library/ctypes.rst:2 +#: library/ctypes.rst:2 msgid ":mod:`ctypes` --- A foreign function library for Python" msgstr "" -#: ../src/Doc/library/ctypes.rst:11 +#: library/ctypes.rst:11 msgid "" ":mod:`ctypes` is a foreign function library for Python. It provides C " "compatible data types, and allows calling functions in DLLs or shared " "libraries. It can be used to wrap these libraries in pure Python." msgstr "" -#: ../src/Doc/library/ctypes.rst:19 +#: library/ctypes.rst:19 msgid "ctypes tutorial" msgstr "" -#: ../src/Doc/library/ctypes.rst:21 +#: library/ctypes.rst:21 msgid "" "Note: The code samples in this tutorial use :mod:`doctest` to make sure that " "they actually work. Since some code samples behave differently under Linux, " "Windows, or Mac OS X, they contain doctest directives in comments." msgstr "" -#: ../src/Doc/library/ctypes.rst:25 +#: library/ctypes.rst:25 msgid "" "Note: Some code samples reference the ctypes :class:`c_int` type. This type " "is an alias for the :class:`c_long` type on 32-bit systems. So, you should " @@ -19505,18 +19622,18 @@ msgid "" "`c_int` --- they are actually the same type." msgstr "" -#: ../src/Doc/library/ctypes.rst:34 +#: library/ctypes.rst:34 msgid "Loading dynamic link libraries" msgstr "" -#: ../src/Doc/library/ctypes.rst:36 +#: library/ctypes.rst:36 msgid "" ":mod:`ctypes` exports the *cdll*, and on Windows *windll* and *oledll* " "objects, for loading dynamic link libraries." msgstr "" # 0fe5f70ddb4948b2a5c36fdc236c93d2 -#: ../src/Doc/library/ctypes.rst:39 +#: library/ctypes.rst:39 msgid "" "You load libraries by accessing them as attributes of these objects. *cdll* " "loads libraries which export functions using the standard ``cdecl`` calling " @@ -19527,18 +19644,18 @@ msgid "" "when the function call fails." msgstr "" -#: ../src/Doc/library/ctypes.rst:47 +#: library/ctypes.rst:47 msgid "" "Here are some examples for Windows. Note that ``msvcrt`` is the MS standard " "C library containing most standard C functions, and uses the cdecl calling " "convention::" msgstr "" -#: ../src/Doc/library/ctypes.rst:59 +#: library/ctypes.rst:59 msgid "Windows appends the usual ``.dll`` file suffix automatically." msgstr "" -#: ../src/Doc/library/ctypes.rst:61 +#: library/ctypes.rst:61 msgid "" "On Linux, it is required to specify the filename *including* the extension " "to load a library, so attribute access can not be used to load libraries. " @@ -19547,15 +19664,15 @@ msgid "" "constructor::" msgstr "" -#: ../src/Doc/library/ctypes.rst:79 +#: library/ctypes.rst:79 msgid "Accessing functions from loaded dlls" msgstr "" -#: ../src/Doc/library/ctypes.rst:81 +#: library/ctypes.rst:81 msgid "Functions are accessed as attributes of dll objects::" msgstr "" -#: ../src/Doc/library/ctypes.rst:96 +#: library/ctypes.rst:96 msgid "" "Note that win32 system dlls like ``kernel32`` and ``user32`` often export " "ANSI as well as UNICODE versions of a function. The UNICODE version is " @@ -19567,32 +19684,32 @@ msgid "" msgstr "" # 027c77fe06604faba9f676979020d5c5 -#: ../src/Doc/library/ctypes.rst:109 +#: library/ctypes.rst:109 msgid "" "*windll* does not try to select one of them by magic, you must access the " "version you need by specifying ``GetModuleHandleA`` or ``GetModuleHandleW`` " "explicitly, and then call it with strings or unicode strings respectively." msgstr "" -#: ../src/Doc/library/ctypes.rst:114 +#: library/ctypes.rst:114 msgid "" "Sometimes, dlls export functions with names which aren't valid Python " "identifiers, like ``\"??2@YAPAXI@Z\"``. In this case you have to use :func:" "`getattr` to retrieve the function::" msgstr "" -#: ../src/Doc/library/ctypes.rst:122 +#: library/ctypes.rst:122 msgid "" "On Windows, some dlls export functions not by name but by ordinal. These " "functions can be accessed by indexing the dll object with the ordinal " "number::" msgstr "" -#: ../src/Doc/library/ctypes.rst:139 +#: library/ctypes.rst:139 msgid "Calling functions" msgstr "" -#: ../src/Doc/library/ctypes.rst:141 +#: library/ctypes.rst:141 msgid "" "You can call these functions like any other Python callable. This example " "uses the ``time()`` function, which returns system time in seconds since the " @@ -19600,13 +19717,13 @@ msgid "" "module handle." msgstr "" -#: ../src/Doc/library/ctypes.rst:146 +#: library/ctypes.rst:146 msgid "" "This example calls both functions with a NULL pointer (``None`` should be " "used as the NULL pointer)::" msgstr "" -#: ../src/Doc/library/ctypes.rst:155 +#: library/ctypes.rst:155 msgid "" ":mod:`ctypes` tries to protect you from calling functions with the wrong " "number of arguments or the wrong calling convention. Unfortunately this " @@ -19615,33 +19732,33 @@ msgid "" "called::" msgstr "" -#: ../src/Doc/library/ctypes.rst:170 +#: library/ctypes.rst:170 msgid "" "The same exception is raised when you call an ``stdcall`` function with the " "``cdecl`` calling convention, or vice versa::" msgstr "" -#: ../src/Doc/library/ctypes.rst:185 +#: library/ctypes.rst:185 msgid "" "To find out the correct calling convention you have to look into the C " "header file or the documentation for the function you want to call." msgstr "" -#: ../src/Doc/library/ctypes.rst:188 +#: library/ctypes.rst:188 msgid "" "On Windows, :mod:`ctypes` uses win32 structured exception handling to " "prevent crashes from general protection faults when functions are called " "with invalid argument values::" msgstr "" -#: ../src/Doc/library/ctypes.rst:198 +#: library/ctypes.rst:198 msgid "" "There are, however, enough ways to crash Python with :mod:`ctypes`, so you " "should be careful anyway." msgstr "" # 7601fefbf2ee40e0aed43fde21af7bab -#: ../src/Doc/library/ctypes.rst:201 +#: library/ctypes.rst:201 msgid "" "``None``, integers, longs, byte strings and unicode strings are the only " "native Python objects that can directly be used as parameters in these " @@ -19652,76 +19769,75 @@ msgid "" "value is masked to fit into the C type." msgstr "" -#: ../src/Doc/library/ctypes.rst:209 +#: library/ctypes.rst:209 msgid "" "Before we move on calling functions with other parameter types, we have to " "learn more about :mod:`ctypes` data types." msgstr "" -#: ../src/Doc/library/ctypes.rst:216 ../src/Doc/library/ctypes.rst:2141 +#: library/ctypes.rst:216 library/ctypes.rst:2141 msgid "Fundamental data types" msgstr "" # ed6eaa9e894348688e5e9b17b4c961a6 -#: ../src/Doc/library/ctypes.rst:218 +#: library/ctypes.rst:218 msgid ":mod:`ctypes` defines a number of primitive C compatible data types:" msgstr "" -#: ../src/Doc/library/ctypes.rst:221 +#: library/ctypes.rst:221 msgid "ctypes type" msgstr "" -#: ../src/Doc/library/ctypes.rst:221 +#: library/ctypes.rst:221 msgid "C type" msgstr "" # 1c8cde543d9b4818ad286e0730be281f -#: ../src/Doc/library/ctypes.rst:223 +#: library/ctypes.rst:223 msgid ":class:`c_bool`" msgstr "" # 0de1cd38371a4ebd9eee56d3d0e84583 # d52d3ab8fbd64156b8a70a325861c931 -#: ../src/Doc/library/ctypes.rst:223 ../src/Doc/library/struct.rst:176 +#: library/ctypes.rst:223 library/struct.rst:176 msgid ":c:type:`_Bool`" msgstr "" # 12cdf811ffab44689a950b7b8b18da37 -#: ../src/Doc/library/ctypes.rst:223 +#: library/ctypes.rst:223 msgid "bool (1)" msgstr "" -#: ../src/Doc/library/ctypes.rst:225 +#: library/ctypes.rst:225 msgid ":class:`c_char`" msgstr "" # 2eeea1236dfa42e2a90170d1161fc956 # adec75ee984345058064c06404a878cb # 6bb3a7ae675f40bcb61c32472b2cbcb3 -#: ../src/Doc/library/ctypes.rst:225 ../src/Doc/library/ctypes.rst:229 -#: ../src/Doc/library/struct.rst:170 +#: library/ctypes.rst:225 library/ctypes.rst:229 library/struct.rst:170 msgid ":c:type:`char`" msgstr "" -#: ../src/Doc/library/ctypes.rst:225 +#: library/ctypes.rst:225 msgid "1-character string" msgstr "" -#: ../src/Doc/library/ctypes.rst:227 +#: library/ctypes.rst:227 msgid ":class:`c_wchar`" msgstr "" # bf7f19f5048c4e2884adf2d482d2f2a3 -#: ../src/Doc/library/ctypes.rst:227 +#: library/ctypes.rst:227 msgid ":c:type:`wchar_t`" msgstr "" # d75757c23f664ee69e2162cadc639023 -#: ../src/Doc/library/ctypes.rst:227 +#: library/ctypes.rst:227 msgid "1-character unicode string" msgstr "" -#: ../src/Doc/library/ctypes.rst:229 +#: library/ctypes.rst:229 msgid ":class:`c_byte`" msgstr "" @@ -19735,190 +19851,189 @@ msgstr "" # 7992d4f0214b4fe6a2037d9672dd1fb4 # d5e4c5fa62944eab9853c7d19e5f824a # 30c4f541f66e47e19b7c91aa91ddd29e -#: ../src/Doc/library/ctypes.rst:229 ../src/Doc/library/ctypes.rst:231 -#: ../src/Doc/library/ctypes.rst:233 ../src/Doc/library/ctypes.rst:235 -#: ../src/Doc/library/ctypes.rst:237 ../src/Doc/library/ctypes.rst:239 -#: ../src/Doc/library/ctypes.rst:241 ../src/Doc/library/ctypes.rst:243 -#: ../src/Doc/library/ctypes.rst:245 ../src/Doc/library/ctypes.rst:247 +#: library/ctypes.rst:229 library/ctypes.rst:231 library/ctypes.rst:233 +#: library/ctypes.rst:235 library/ctypes.rst:237 library/ctypes.rst:239 +#: library/ctypes.rst:241 library/ctypes.rst:243 library/ctypes.rst:245 +#: library/ctypes.rst:247 msgid "int/long" msgstr "" -#: ../src/Doc/library/ctypes.rst:231 +#: library/ctypes.rst:231 msgid ":class:`c_ubyte`" msgstr "" # 5e31d7ad06814a1d950ebfe787a21960 # ed060c758bc0407ea9904dd208658194 -#: ../src/Doc/library/ctypes.rst:231 ../src/Doc/library/struct.rst:174 +#: library/ctypes.rst:231 library/struct.rst:174 msgid ":c:type:`unsigned char`" msgstr "" -#: ../src/Doc/library/ctypes.rst:233 +#: library/ctypes.rst:233 msgid ":class:`c_short`" msgstr "" # 0c505a49520d428b8e33aaa552f47e66 # 41ba61166f92460cb130c8b80f62ea54 -#: ../src/Doc/library/ctypes.rst:233 ../src/Doc/library/struct.rst:178 +#: library/ctypes.rst:233 library/struct.rst:178 msgid ":c:type:`short`" msgstr "" -#: ../src/Doc/library/ctypes.rst:235 +#: library/ctypes.rst:235 msgid ":class:`c_ushort`" msgstr "" # 07c31bb0180c40cbb9565f4b390d0240 # ad35c60f116b43f0bda893c190011cc3 -#: ../src/Doc/library/ctypes.rst:235 ../src/Doc/library/struct.rst:180 +#: library/ctypes.rst:235 library/struct.rst:180 msgid ":c:type:`unsigned short`" msgstr "" -#: ../src/Doc/library/ctypes.rst:237 +#: library/ctypes.rst:237 msgid ":class:`c_int`" msgstr "" # 5d54a78b59524c1c91572654743f127f # 61e1ce5bc7b74f0ca768ca2060ce4027 -#: ../src/Doc/library/ctypes.rst:237 ../src/Doc/library/struct.rst:182 +#: library/ctypes.rst:237 library/struct.rst:182 msgid ":c:type:`int`" msgstr "" -#: ../src/Doc/library/ctypes.rst:239 +#: library/ctypes.rst:239 msgid ":class:`c_uint`" msgstr "" # 24e52a6066a94a01a7f6bed0af0c1a89 # 7f90e5e89fb641c5ab14b3959c738d61 -#: ../src/Doc/library/ctypes.rst:239 ../src/Doc/library/struct.rst:184 +#: library/ctypes.rst:239 library/struct.rst:184 msgid ":c:type:`unsigned int`" msgstr "" -#: ../src/Doc/library/ctypes.rst:241 +#: library/ctypes.rst:241 msgid ":class:`c_long`" msgstr "" # 7e10ffc93bf041f4babb0e90d33c353c # 14bdf06e0d0c48b3a2efbd34fcf0f8fa -#: ../src/Doc/library/ctypes.rst:241 ../src/Doc/library/struct.rst:186 +#: library/ctypes.rst:241 library/struct.rst:186 msgid ":c:type:`long`" msgstr "" -#: ../src/Doc/library/ctypes.rst:243 +#: library/ctypes.rst:243 msgid ":class:`c_ulong`" msgstr "" # 42f1e01b61ec4f2a8dc3eb4fd1fb7a25 # 328aaa56bfb446f980f3df79dc63f773 -#: ../src/Doc/library/ctypes.rst:243 ../src/Doc/library/struct.rst:188 +#: library/ctypes.rst:243 library/struct.rst:188 msgid ":c:type:`unsigned long`" msgstr "" -#: ../src/Doc/library/ctypes.rst:245 +#: library/ctypes.rst:245 msgid ":class:`c_longlong`" msgstr "" # 7bf430ae3b6c46fa8d959e2bf928c377 -#: ../src/Doc/library/ctypes.rst:245 +#: library/ctypes.rst:245 msgid ":c:type:`__int64` or :c:type:`long long`" msgstr "" -#: ../src/Doc/library/ctypes.rst:247 +#: library/ctypes.rst:247 msgid ":class:`c_ulonglong`" msgstr "" # 2a2190a9e9114ece97a6cb6b7c08f844 -#: ../src/Doc/library/ctypes.rst:247 +#: library/ctypes.rst:247 msgid ":c:type:`unsigned __int64` or :c:type:`unsigned long long`" msgstr "" -#: ../src/Doc/library/ctypes.rst:250 +#: library/ctypes.rst:250 msgid ":class:`c_float`" msgstr "" # a4ad572096df4f9dbd2253a7d13f95fe # 2ce62227c10f429d9546dd2a33d42f89 -#: ../src/Doc/library/ctypes.rst:250 ../src/Doc/library/struct.rst:195 +#: library/ctypes.rst:250 library/struct.rst:195 msgid ":c:type:`float`" msgstr "" -#: ../src/Doc/library/ctypes.rst:252 +#: library/ctypes.rst:252 msgid ":class:`c_double`" msgstr "" # 6b5e9612bb564139b6a09c9e3af479e9 # 36927ea698cb4dfcaa76a69a7f9aaa16 -#: ../src/Doc/library/ctypes.rst:252 ../src/Doc/library/struct.rst:197 +#: library/ctypes.rst:252 library/struct.rst:197 msgid ":c:type:`double`" msgstr "" -#: ../src/Doc/library/ctypes.rst:254 +#: library/ctypes.rst:254 msgid ":class:`c_longdouble`" msgstr "" # b0b2cde71be34ff59e38f54563459b31 -#: ../src/Doc/library/ctypes.rst:254 +#: library/ctypes.rst:254 msgid ":c:type:`long double`" msgstr "" -#: ../src/Doc/library/ctypes.rst:256 +#: library/ctypes.rst:256 msgid ":class:`c_char_p`" msgstr "" # daef7cc9f2ff4e09896cb7c8e33804f2 -#: ../src/Doc/library/ctypes.rst:256 +#: library/ctypes.rst:256 msgid ":c:type:`char *` (NUL terminated)" msgstr "" -#: ../src/Doc/library/ctypes.rst:256 +#: library/ctypes.rst:256 msgid "string or ``None``" msgstr "" -#: ../src/Doc/library/ctypes.rst:258 +#: library/ctypes.rst:258 msgid ":class:`c_wchar_p`" msgstr "" # 9deb3c322ae341258cd072f8b0c00d64 -#: ../src/Doc/library/ctypes.rst:258 +#: library/ctypes.rst:258 msgid ":c:type:`wchar_t *` (NUL terminated)" msgstr "" # cbfc17eb3039453f9374882ba342780a -#: ../src/Doc/library/ctypes.rst:258 +#: library/ctypes.rst:258 msgid "unicode or ``None``" msgstr "" -#: ../src/Doc/library/ctypes.rst:260 +#: library/ctypes.rst:260 msgid ":class:`c_void_p`" msgstr "" # d352ad6a6ceb42669d80fdfb6a472234 -#: ../src/Doc/library/ctypes.rst:260 +#: library/ctypes.rst:260 msgid ":c:type:`void *`" msgstr "" # d96837473e274c63a8988f977fe92076 -#: ../src/Doc/library/ctypes.rst:260 +#: library/ctypes.rst:260 msgid "int/long or ``None``" msgstr "" # 4f09c7849b9748d7aecdfe68d5c08e13 -#: ../src/Doc/library/ctypes.rst:264 +#: library/ctypes.rst:264 msgid "The constructor accepts any object with a truth value." msgstr "" -#: ../src/Doc/library/ctypes.rst:266 +#: library/ctypes.rst:266 msgid "" "All these types can be created by calling them with an optional initializer " "of the correct type and value::" msgstr "" -#: ../src/Doc/library/ctypes.rst:277 +#: library/ctypes.rst:277 msgid "" "Since these types are mutable, their value can also be changed afterwards::" msgstr "" # d556ad488ad94aa2a0d28a485b93092f -#: ../src/Doc/library/ctypes.rst:289 +#: library/ctypes.rst:289 msgid "" "Assigning a new value to instances of the pointer types :class:`c_char_p`, :" "class:`c_wchar_p`, and :class:`c_void_p` changes the *memory location* they " @@ -19926,7 +20041,7 @@ msgid "" "Python strings are immutable)::" msgstr "" -#: ../src/Doc/library/ctypes.rst:305 +#: library/ctypes.rst:305 msgid "" "You should be careful, however, not to pass them to functions expecting " "pointers to mutable memory. If you need mutable memory blocks, ctypes has a :" @@ -19937,7 +20052,7 @@ msgid "" msgstr "" # 4e569a7b52944a83bcc648244d0b9861 -#: ../src/Doc/library/ctypes.rst:329 +#: library/ctypes.rst:329 msgid "" "The :func:`create_string_buffer` function replaces the :func:`c_buffer` " "function (which is still available as an alias), as well as the :func:" @@ -19946,11 +20061,11 @@ msgid "" "use the :func:`create_unicode_buffer` function." msgstr "" -#: ../src/Doc/library/ctypes.rst:339 +#: library/ctypes.rst:339 msgid "Calling functions, continued" msgstr "" -#: ../src/Doc/library/ctypes.rst:341 +#: library/ctypes.rst:341 msgid "" "Note that printf prints to the real standard output channel, *not* to :data:" "`sys.stdout`, so these examples will only work at the console prompt, not " @@ -19958,19 +20073,19 @@ msgid "" msgstr "" # 8fa538491f744f2d96f448463ace51fc -#: ../src/Doc/library/ctypes.rst:361 +#: library/ctypes.rst:361 msgid "" "As has been mentioned before, all Python types except integers, strings, and " "unicode strings have to be wrapped in their corresponding :mod:`ctypes` " "type, so that they can be converted to the required C data type::" msgstr "" -#: ../src/Doc/library/ctypes.rst:374 +#: library/ctypes.rst:374 msgid "Calling functions with your own custom data types" msgstr "" # 9e197eeeaa1d49478606e89d3426d265 -#: ../src/Doc/library/ctypes.rst:376 +#: library/ctypes.rst:376 msgid "" "You can also customize :mod:`ctypes` argument conversion to allow instances " "of your own classes be used as function arguments. :mod:`ctypes` looks for " @@ -19979,24 +20094,24 @@ msgid "" msgstr "" # 19e6aac7eea3407e9c1a05ec08c30d5d -#: ../src/Doc/library/ctypes.rst:391 +#: library/ctypes.rst:391 msgid "" "If you don't want to store the instance's data in the :attr:`_as_parameter_` " "instance variable, you could define a :func:`property` which makes the data " "available." msgstr "" -#: ../src/Doc/library/ctypes.rst:399 +#: library/ctypes.rst:399 msgid "Specifying the required argument types (function prototypes)" msgstr "" -#: ../src/Doc/library/ctypes.rst:401 +#: library/ctypes.rst:401 msgid "" "It is possible to specify the required argument types of functions exported " "from DLLs by setting the :attr:`argtypes` attribute." msgstr "" -#: ../src/Doc/library/ctypes.rst:404 +#: library/ctypes.rst:404 msgid "" ":attr:`argtypes` must be a sequence of C data types (the ``printf`` function " "is probably not a good example here, because it takes a variable number and " @@ -20004,7 +20119,7 @@ msgid "" "hand this is quite handy to experiment with this feature)::" msgstr "" -#: ../src/Doc/library/ctypes.rst:415 +#: library/ctypes.rst:415 msgid "" "Specifying a format protects against incompatible argument types (just as a " "prototype for a C function), and tries to convert the arguments to valid " @@ -20012,7 +20127,7 @@ msgid "" msgstr "" # 26fd138b40e04ccb91207bd4f58bde76 -#: ../src/Doc/library/ctypes.rst:427 +#: library/ctypes.rst:427 msgid "" "If you have defined your own classes which you pass to function calls, you " "have to implement a :meth:`from_param` class method for them to be able to " @@ -20025,33 +20140,33 @@ msgid "" "or an object with an :attr:`_as_parameter_` attribute." msgstr "" -#: ../src/Doc/library/ctypes.rst:441 +#: library/ctypes.rst:441 msgid "Return types" msgstr "" # 2d2d4c0550d047109ae98af0a222d136 -#: ../src/Doc/library/ctypes.rst:443 +#: library/ctypes.rst:443 msgid "" "By default functions are assumed to return the C :c:type:`int` type. Other " "return types can be specified by setting the :attr:`restype` attribute of " "the function object." msgstr "" -#: ../src/Doc/library/ctypes.rst:447 +#: library/ctypes.rst:447 msgid "" "Here is a more advanced example, it uses the ``strchr`` function, which " "expects a string pointer and a char, and returns a pointer to a string::" msgstr "" # 9e299ff994334e18ac34eb4f5430b860 -#: ../src/Doc/library/ctypes.rst:460 +#: library/ctypes.rst:460 msgid "" "If you want to avoid the ``ord(\"x\")`` calls above, you can set the :attr:" "`argtypes` attribute, and the second argument will be converted from a " "single character Python string into a C char::" msgstr "" -#: ../src/Doc/library/ctypes.rst:478 +#: library/ctypes.rst:478 msgid "" "You can also use a callable Python object (a function or a class for " "example) as the :attr:`restype` attribute, if the foreign function returns " @@ -20061,7 +20176,7 @@ msgid "" "automatically raise an exception::" msgstr "" -#: ../src/Doc/library/ctypes.rst:501 +#: library/ctypes.rst:501 msgid "" "``WinError`` is a function which will call Windows ``FormatMessage()`` api " "to get the string representation of an error code, and *returns* an " @@ -20069,17 +20184,17 @@ msgid "" "used, it calls :func:`GetLastError` to retrieve it." msgstr "" -#: ../src/Doc/library/ctypes.rst:506 +#: library/ctypes.rst:506 msgid "" "Please note that a much more powerful error checking mechanism is available " "through the :attr:`errcheck` attribute; see the reference manual for details." msgstr "" -#: ../src/Doc/library/ctypes.rst:513 +#: library/ctypes.rst:513 msgid "Passing pointers (or: passing parameters by reference)" msgstr "" -#: ../src/Doc/library/ctypes.rst:515 +#: library/ctypes.rst:515 msgid "" "Sometimes a C api function expects a *pointer* to a data type as parameter, " "probably to write into the corresponding location, or if the data is too " @@ -20087,7 +20202,7 @@ msgid "" "reference*." msgstr "" -#: ../src/Doc/library/ctypes.rst:519 +#: library/ctypes.rst:519 msgid "" ":mod:`ctypes` exports the :func:`byref` function which is used to pass " "parameters by reference. The same effect can be achieved with the :func:" @@ -20096,11 +20211,11 @@ msgid "" "you don't need the pointer object in Python itself::" msgstr "" -#: ../src/Doc/library/ctypes.rst:541 +#: library/ctypes.rst:541 msgid "Structures and unions" msgstr "" -#: ../src/Doc/library/ctypes.rst:543 +#: library/ctypes.rst:543 msgid "" "Structures and unions must derive from the :class:`Structure` and :class:" "`Union` base classes which are defined in the :mod:`ctypes` module. Each " @@ -20108,13 +20223,13 @@ msgid "" "a list of *2-tuples*, containing a *field name* and a *field type*." msgstr "" -#: ../src/Doc/library/ctypes.rst:548 +#: library/ctypes.rst:548 msgid "" "The field type must be a :mod:`ctypes` type like :class:`c_int`, or any " "other derived :mod:`ctypes` type: structure, union, array, pointer." msgstr "" -#: ../src/Doc/library/ctypes.rst:551 +#: library/ctypes.rst:551 msgid "" "Here is a simple example of a POINT structure, which contains two integers " "named *x* and *y*, and also shows how to initialize a structure in the " @@ -20122,32 +20237,32 @@ msgid "" msgstr "" # da07506459804c9d92bf6f64deada77f -#: ../src/Doc/library/ctypes.rst:571 +#: library/ctypes.rst:571 msgid "" "You can, however, build much more complicated structures. A structure can " "itself contain other structures by using a structure as a field type." msgstr "" -#: ../src/Doc/library/ctypes.rst:574 +#: library/ctypes.rst:574 msgid "" "Here is a RECT structure which contains two POINTs named *upperleft* and " "*lowerright*::" msgstr "" -#: ../src/Doc/library/ctypes.rst:588 +#: library/ctypes.rst:588 msgid "" "Nested structures can also be initialized in the constructor in several " "ways::" msgstr "" -#: ../src/Doc/library/ctypes.rst:593 +#: library/ctypes.rst:593 msgid "" "Field :term:`descriptor`\\s can be retrieved from the *class*, they are " "useful for debugging because they can provide useful information::" msgstr "" # 22b2c13d9ba649be81457397b070ba4c -#: ../src/Doc/library/ctypes.rst:607 +#: library/ctypes.rst:607 msgid "" ":mod:`ctypes` does not support passing unions or structures with bit-fields " "to functions by value. While this may work on 32-bit x86, it's not " @@ -20155,11 +20270,11 @@ msgid "" "structures with bit-fields should always be passed to functions by pointer." msgstr "" -#: ../src/Doc/library/ctypes.rst:613 +#: library/ctypes.rst:613 msgid "Structure/union alignment and byte order" msgstr "" -#: ../src/Doc/library/ctypes.rst:615 +#: library/ctypes.rst:615 msgid "" "By default, Structure and Union fields are aligned in the same way the C " "compiler does it. It is possible to override this behavior be specifying a :" @@ -20168,7 +20283,7 @@ msgid "" "This is what ``#pragma pack(n)`` also does in MSVC." msgstr "" -#: ../src/Doc/library/ctypes.rst:621 +#: library/ctypes.rst:621 msgid "" ":mod:`ctypes` uses the native byte order for Structures and Unions. To " "build structures with non-native byte order, you can use one of the :class:" @@ -20177,91 +20292,91 @@ msgid "" "classes cannot contain pointer fields." msgstr "" -#: ../src/Doc/library/ctypes.rst:631 +#: library/ctypes.rst:631 msgid "Bit fields in structures and unions" msgstr "" -#: ../src/Doc/library/ctypes.rst:633 +#: library/ctypes.rst:633 msgid "" "It is possible to create structures and unions containing bit fields. Bit " "fields are only possible for integer fields, the bit width is specified as " "the third item in the :attr:`_fields_` tuples::" msgstr "" -#: ../src/Doc/library/ctypes.rst:651 +#: library/ctypes.rst:651 msgid "Arrays" msgstr "" -#: ../src/Doc/library/ctypes.rst:653 +#: library/ctypes.rst:653 msgid "" "Arrays are sequences, containing a fixed number of instances of the same " "type." msgstr "" -#: ../src/Doc/library/ctypes.rst:655 +#: library/ctypes.rst:655 msgid "" "The recommended way to create array types is by multiplying a data type with " "a positive integer::" msgstr "" -#: ../src/Doc/library/ctypes.rst:660 +#: library/ctypes.rst:660 msgid "" "Here is an example of an somewhat artificial data type, a structure " "containing 4 POINTs among other stuff::" msgstr "" -#: ../src/Doc/library/ctypes.rst:676 +#: library/ctypes.rst:676 msgid "Instances are created in the usual way, by calling the class::" msgstr "" -#: ../src/Doc/library/ctypes.rst:682 +#: library/ctypes.rst:682 msgid "" "The above code print a series of ``0 0`` lines, because the array contents " "is initialized to zeros." msgstr "" -#: ../src/Doc/library/ctypes.rst:685 +#: library/ctypes.rst:685 msgid "Initializers of the correct type can also be specified::" msgstr "" -#: ../src/Doc/library/ctypes.rst:701 +#: library/ctypes.rst:701 msgid "Pointers" msgstr "" -#: ../src/Doc/library/ctypes.rst:703 +#: library/ctypes.rst:703 msgid "" "Pointer instances are created by calling the :func:`pointer` function on a :" "mod:`ctypes` type::" msgstr "" -#: ../src/Doc/library/ctypes.rst:711 +#: library/ctypes.rst:711 msgid "" "Pointer instances have a :attr:`contents` attribute which returns the object " "to which the pointer points, the ``i`` object above::" msgstr "" -#: ../src/Doc/library/ctypes.rst:718 +#: library/ctypes.rst:718 msgid "" "Note that :mod:`ctypes` does not have OOR (original object return), it " "constructs a new, equivalent object each time you retrieve an attribute::" msgstr "" -#: ../src/Doc/library/ctypes.rst:727 +#: library/ctypes.rst:727 msgid "" "Assigning another :class:`c_int` instance to the pointer's contents " "attribute would cause the pointer to point to the memory location where this " "is stored::" msgstr "" -#: ../src/Doc/library/ctypes.rst:739 +#: library/ctypes.rst:739 msgid "Pointer instances can also be indexed with integers::" msgstr "" -#: ../src/Doc/library/ctypes.rst:745 +#: library/ctypes.rst:745 msgid "Assigning to an integer index changes the pointed to value::" msgstr "" -#: ../src/Doc/library/ctypes.rst:754 +#: library/ctypes.rst:754 msgid "" "It is also possible to use indexes different from 0, but you must know what " "you're doing, just as in C: You can access or change arbitrary memory " @@ -20271,7 +20386,7 @@ msgid "" msgstr "" # 0f58bf2c0ee1417fb47f7590008a3a7b -#: ../src/Doc/library/ctypes.rst:760 +#: library/ctypes.rst:760 msgid "" "Behind the scenes, the :func:`pointer` function does more than simply create " "pointer instances, it has to create pointer *types* first. This is done " @@ -20279,23 +20394,23 @@ msgid "" "returns a new type::" msgstr "" -#: ../src/Doc/library/ctypes.rst:776 +#: library/ctypes.rst:776 msgid "" "Calling the pointer type without an argument creates a ``NULL`` pointer. " "``NULL`` pointers have a ``False`` boolean value::" msgstr "" -#: ../src/Doc/library/ctypes.rst:784 +#: library/ctypes.rst:784 msgid "" ":mod:`ctypes` checks for ``NULL`` when dereferencing pointers (but " "dereferencing invalid non-\\ ``NULL`` pointers would crash Python)::" msgstr "" -#: ../src/Doc/library/ctypes.rst:803 +#: library/ctypes.rst:803 msgid "Type conversions" msgstr "" -#: ../src/Doc/library/ctypes.rst:805 +#: library/ctypes.rst:805 msgid "" "Usually, ctypes does strict type checking. This means, if you have " "``POINTER(c_int)`` in the :attr:`argtypes` list of a function or as the type " @@ -20307,7 +20422,7 @@ msgid "" msgstr "" # 17fa973d8997455db32f5c7ac5ca24bc -#: ../src/Doc/library/ctypes.rst:826 +#: library/ctypes.rst:826 msgid "" "In addition, if a function argument is explicitly declared to be a pointer " "type (such as ``POINTER(c_int)``) in :attr:`argtypes`, an object of the " @@ -20315,11 +20430,11 @@ msgid "" "will apply the required :func:`byref` conversion in this case automatically." msgstr "" -#: ../src/Doc/library/ctypes.rst:831 +#: library/ctypes.rst:831 msgid "To set a POINTER type field to ``NULL``, you can assign ``None``::" msgstr "" -#: ../src/Doc/library/ctypes.rst:838 +#: library/ctypes.rst:838 msgid "" "Sometimes you have instances of incompatible types. In C, you can cast one " "type into another type. :mod:`ctypes` provides a :func:`cast` function " @@ -20328,11 +20443,11 @@ msgid "" "``values`` field, but not instances of other types::" msgstr "" -#: ../src/Doc/library/ctypes.rst:850 +#: library/ctypes.rst:850 msgid "For these cases, the :func:`cast` function is handy." msgstr "" -#: ../src/Doc/library/ctypes.rst:852 +#: library/ctypes.rst:852 msgid "" "The :func:`cast` function can be used to cast a ctypes instance into a " "pointer to a different ctypes data type. :func:`cast` takes two parameters, " @@ -20341,60 +20456,60 @@ msgid "" "references the same memory block as the first argument::" msgstr "" -#: ../src/Doc/library/ctypes.rst:863 +#: library/ctypes.rst:863 msgid "" "So, :func:`cast` can be used to assign to the ``values`` field of ``Bar`` " "the structure::" msgstr "" -#: ../src/Doc/library/ctypes.rst:876 +#: library/ctypes.rst:876 msgid "Incomplete Types" msgstr "" -#: ../src/Doc/library/ctypes.rst:878 +#: library/ctypes.rst:878 msgid "" "*Incomplete Types* are structures, unions or arrays whose members are not " "yet specified. In C, they are specified by forward declarations, which are " "defined later::" msgstr "" -#: ../src/Doc/library/ctypes.rst:889 +#: library/ctypes.rst:889 msgid "" "The straightforward translation into ctypes code would be this, but it does " "not work::" msgstr "" -#: ../src/Doc/library/ctypes.rst:902 +#: library/ctypes.rst:902 msgid "" "because the new ``class cell`` is not available in the class statement " "itself. In :mod:`ctypes`, we can define the ``cell`` class and set the :attr:" "`_fields_` attribute later, after the class statement::" msgstr "" -#: ../src/Doc/library/ctypes.rst:914 +#: library/ctypes.rst:914 msgid "" "Lets try it. We create two instances of ``cell``, and let them point to each " "other, and finally follow the pointer chain a few times::" msgstr "" -#: ../src/Doc/library/ctypes.rst:935 +#: library/ctypes.rst:935 msgid "Callback functions" msgstr "" -#: ../src/Doc/library/ctypes.rst:937 +#: library/ctypes.rst:937 msgid "" ":mod:`ctypes` allows to create C callable function pointers from Python " "callables. These are sometimes called *callback functions*." msgstr "" -#: ../src/Doc/library/ctypes.rst:940 +#: library/ctypes.rst:940 msgid "" "First, you must create a class for the callback function, the class knows " "the calling convention, the return type, and the number and types of " "arguments this function will receive." msgstr "" -#: ../src/Doc/library/ctypes.rst:944 +#: library/ctypes.rst:944 msgid "" "The CFUNCTYPE factory function creates types for callback functions using " "the normal cdecl calling convention, and, on Windows, the WINFUNCTYPE " @@ -20402,7 +20517,7 @@ msgid "" "calling convention." msgstr "" -#: ../src/Doc/library/ctypes.rst:949 +#: library/ctypes.rst:949 msgid "" "Both of these factory functions are called with the result type as first " "argument, and the callback functions expected argument types as the " @@ -20410,14 +20525,14 @@ msgid "" msgstr "" # 19489ef06d1c4a1d8c6f08cbe28f472b -#: ../src/Doc/library/ctypes.rst:953 +#: library/ctypes.rst:953 msgid "" "I will present an example here which uses the standard C library's :func:" "`qsort` function, this is used to sort items with the help of a callback " "function. :func:`qsort` will be used to sort an array of integers::" msgstr "" -#: ../src/Doc/library/ctypes.rst:963 +#: library/ctypes.rst:963 msgid "" ":func:`qsort` must be called with a pointer to the data to sort, the number " "of items in the data array, the size of one item, and a pointer to the " @@ -20427,68 +20542,68 @@ msgid "" "else." msgstr "" -#: ../src/Doc/library/ctypes.rst:969 +#: library/ctypes.rst:969 msgid "" "So our callback function receives pointers to integers, and must return an " "integer. First we create the ``type`` for the callback function::" msgstr "" -#: ../src/Doc/library/ctypes.rst:975 +#: library/ctypes.rst:975 msgid "" "For the first implementation of the callback function, we simply print the " "arguments we get, and return 0 (incremental development ;-)::" msgstr "" -#: ../src/Doc/library/ctypes.rst:984 +#: library/ctypes.rst:984 msgid "Create the C callable callback::" msgstr "" -#: ../src/Doc/library/ctypes.rst:989 +#: library/ctypes.rst:989 msgid "And we're ready to go::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1004 +#: library/ctypes.rst:1004 msgid "" "We know how to access the contents of a pointer, so lets redefine our " "callback::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1013 +#: library/ctypes.rst:1013 msgid "Here is what we get on Windows::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1028 +#: library/ctypes.rst:1028 msgid "" "It is funny to see that on linux the sort function seems to work much more " "efficiently, it is doing less comparisons::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1039 +#: library/ctypes.rst:1039 msgid "" "Ah, we're nearly done! The last step is to actually compare the two items " "and return a useful result::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1048 +#: library/ctypes.rst:1048 msgid "Final run on Windows::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1063 +#: library/ctypes.rst:1063 msgid "and on Linux::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1073 +#: library/ctypes.rst:1073 msgid "" "It is quite interesting to see that the Windows :func:`qsort` function needs " "more comparisons than the linux version!" msgstr "" -#: ../src/Doc/library/ctypes.rst:1076 +#: library/ctypes.rst:1076 msgid "As we can easily check, our array is sorted now::" msgstr "" # a1ec108db75d4a7f834f915fe8c8fa5e -#: ../src/Doc/library/ctypes.rst:1085 +#: library/ctypes.rst:1085 msgid "" "Make sure you keep references to :func:`CFUNCTYPE` objects as long as they " "are used from C code. :mod:`ctypes` doesn't, and if you don't, they may be " @@ -20496,7 +20611,7 @@ msgid "" msgstr "" # d9531ecf116f49208f98dd4b4fc898ae -#: ../src/Doc/library/ctypes.rst:1089 +#: library/ctypes.rst:1089 msgid "" "Also, note that if the callback function is called in a thread created " "outside of Python's control (e.g. by the foreign code that calls the " @@ -20506,12 +20621,12 @@ msgid "" "even when those calls are made from the same C thread." msgstr "" -#: ../src/Doc/library/ctypes.rst:1099 +#: library/ctypes.rst:1099 msgid "Accessing values exported from dlls" msgstr "" # 8c282dc6613444fab1d3fbf57cc86c0e -#: ../src/Doc/library/ctypes.rst:1101 +#: library/ctypes.rst:1101 msgid "" "Some shared libraries not only export functions, they also export variables. " "An example in the Python library itself is the ``Py_OptimizeFlag``, an " @@ -20519,14 +20634,14 @@ msgid "" "flag given on startup." msgstr "" -#: ../src/Doc/library/ctypes.rst:1106 +#: library/ctypes.rst:1106 msgid "" ":mod:`ctypes` can access values like this with the :meth:`in_dll` class " "methods of the type. *pythonapi* is a predefined symbol giving access to " "the Python C api::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1115 +#: library/ctypes.rst:1115 msgid "" "If the interpreter would have been started with :option:`-O`, the sample " "would have printed ``c_long(1)``, or ``c_long(2)`` if :option:`-OO` would " @@ -20534,14 +20649,14 @@ msgid "" msgstr "" # e074e8a1ea4040e896417808816ca0c3 -#: ../src/Doc/library/ctypes.rst:1119 +#: library/ctypes.rst:1119 msgid "" "An extended example which also demonstrates the use of pointers accesses the " "``PyImport_FrozenModules`` pointer exported by Python." msgstr "" # bc03ddfc4181473ba8c96587f61086b7 -#: ../src/Doc/library/ctypes.rst:1122 +#: library/ctypes.rst:1122 msgid "" "Quoting the Python docs: *This pointer is initialized to point to an array " "of \"struct _frozen\" records, terminated by one whose members are all NULL " @@ -20550,20 +20665,20 @@ msgid "" "created collection of frozen modules.*" msgstr "" -#: ../src/Doc/library/ctypes.rst:1128 +#: library/ctypes.rst:1128 msgid "" "So manipulating this pointer could even prove useful. To restrict the " "example size, we show only how this table can be read with :mod:`ctypes`::" msgstr "" # 59a331800aae4c778f08ace69fa05d96 -#: ../src/Doc/library/ctypes.rst:1140 +#: library/ctypes.rst:1140 msgid "" "We have defined the ``struct _frozen`` data type, so we can get the pointer " "to the table::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1147 +#: library/ctypes.rst:1147 msgid "" "Since ``table`` is a ``pointer`` to the array of ``struct_frozen`` records, " "we can iterate over it, but we just have to make sure that our loop " @@ -20572,35 +20687,35 @@ msgid "" "the loop when we hit the NULL entry::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1164 +#: library/ctypes.rst:1164 msgid "" "The fact that standard Python has a frozen module and a frozen package " "(indicated by the negative size member) is not well known, it is only used " "for testing. Try it out with ``import __hello__`` for example." msgstr "" -#: ../src/Doc/library/ctypes.rst:1172 +#: library/ctypes.rst:1172 msgid "Surprises" msgstr "" # ebd28c8c161748af8a00aaa6b795c396 -#: ../src/Doc/library/ctypes.rst:1174 +#: library/ctypes.rst:1174 msgid "" "There are some edge cases in :mod:`ctypes` where you might expect something " "other than what actually happens." msgstr "" -#: ../src/Doc/library/ctypes.rst:1177 +#: library/ctypes.rst:1177 msgid "Consider the following example::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1197 +#: library/ctypes.rst:1197 msgid "" "Hm. We certainly expected the last statement to print ``3 4 1 2``. What " "happened? Here are the steps of the ``rc.a, rc.b = rc.b, rc.a`` line above::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1205 +#: library/ctypes.rst:1205 msgid "" "Note that ``temp0`` and ``temp1`` are objects still using the internal " "buffer of the ``rc`` object above. So executing ``rc.a = temp0`` copies the " @@ -20609,20 +20724,20 @@ msgid "" "have the expected effect." msgstr "" -#: ../src/Doc/library/ctypes.rst:1211 +#: library/ctypes.rst:1211 msgid "" "Keep in mind that retrieving sub-objects from Structure, Unions, and Arrays " "doesn't *copy* the sub-object, instead it retrieves a wrapper object " "accessing the root-object's underlying buffer." msgstr "" -#: ../src/Doc/library/ctypes.rst:1215 +#: library/ctypes.rst:1215 msgid "" "Another example that may behave different from what one would expect is " "this::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1225 +#: library/ctypes.rst:1225 msgid "" "Why is it printing ``False``? ctypes instances are objects containing a " "memory block plus some :term:`descriptor`\\s accessing the contents of the " @@ -20631,16 +20746,16 @@ msgid "" "the contents again constructs a new Python object each time!" msgstr "" -#: ../src/Doc/library/ctypes.rst:1235 +#: library/ctypes.rst:1235 msgid "Variable-sized data types" msgstr "" -#: ../src/Doc/library/ctypes.rst:1237 +#: library/ctypes.rst:1237 msgid "" ":mod:`ctypes` provides some support for variable-sized arrays and structures." msgstr "" -#: ../src/Doc/library/ctypes.rst:1239 +#: library/ctypes.rst:1239 msgid "" "The :func:`resize` function can be used to resize the memory buffer of an " "existing ctypes object. The function takes the object as first argument, " @@ -20649,35 +20764,35 @@ msgid "" "objects type, a :exc:`ValueError` is raised if this is tried::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1259 +#: library/ctypes.rst:1259 msgid "" "This is nice and fine, but how would one access the additional elements " "contained in this array? Since the type still only knows about 4 elements, " "we get errors accessing other elements::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1271 +#: library/ctypes.rst:1271 msgid "" "Another way to use variable-sized data types with :mod:`ctypes` is to use " "the dynamic nature of Python, and (re-)define the data type after the " "required size is already known, on a case by case basis." msgstr "" -#: ../src/Doc/library/ctypes.rst:1279 +#: library/ctypes.rst:1279 msgid "ctypes reference" msgstr "" -#: ../src/Doc/library/ctypes.rst:1285 +#: library/ctypes.rst:1285 msgid "Finding shared libraries" msgstr "" -#: ../src/Doc/library/ctypes.rst:1287 +#: library/ctypes.rst:1287 msgid "" "When programming in a compiled language, shared libraries are accessed when " "compiling/linking a program, and when the program is run." msgstr "" -#: ../src/Doc/library/ctypes.rst:1290 +#: library/ctypes.rst:1290 msgid "" "The purpose of the :func:`find_library` function is to locate a library in a " "way similar to what the compiler does (on platforms with several versions of " @@ -20685,13 +20800,13 @@ msgid "" "loaders act like when a program is run, and call the runtime loader directly." msgstr "" -#: ../src/Doc/library/ctypes.rst:1295 +#: library/ctypes.rst:1295 msgid "" "The :mod:`ctypes.util` module provides a function which can help to " "determine the library to load." msgstr "" -#: ../src/Doc/library/ctypes.rst:1303 +#: library/ctypes.rst:1303 msgid "" "Try to find a library and return a pathname. *name* is the library name " "without any prefix like *lib*, suffix like ``.so``, ``.dylib`` or version " @@ -20699,24 +20814,24 @@ msgid "" "no library can be found, returns ``None``." msgstr "" -#: ../src/Doc/library/ctypes.rst:1308 ../src/Doc/library/ctypes.rst:1902 +#: library/ctypes.rst:1308 library/ctypes.rst:1902 msgid "The exact functionality is system dependent." msgstr "" -#: ../src/Doc/library/ctypes.rst:1310 +#: library/ctypes.rst:1310 msgid "" "On Linux, :func:`find_library` tries to run external programs (``/sbin/" "ldconfig``, ``gcc``, and ``objdump``) to find the library file. It returns " "the filename of the library file. Here are some examples::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1323 +#: library/ctypes.rst:1323 msgid "" "On OS X, :func:`find_library` tries several predefined naming schemes and " "paths to locate the library, and returns a full pathname if successful::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1337 +#: library/ctypes.rst:1337 msgid "" "On Windows, :func:`find_library` searches along the system search path, and " "returns the full pathname, but since there is no predefined naming scheme a " @@ -20724,7 +20839,7 @@ msgid "" msgstr "" # a364ca5087b440d2bcb7910c5a870eb7 -#: ../src/Doc/library/ctypes.rst:1341 +#: library/ctypes.rst:1341 msgid "" "If wrapping a shared library with :mod:`ctypes`, it *may* be better to " "determine the shared library name at development time, and hardcode that " @@ -20732,25 +20847,25 @@ msgid "" "library at runtime." msgstr "" -#: ../src/Doc/library/ctypes.rst:1349 +#: library/ctypes.rst:1349 msgid "Loading shared libraries" msgstr "" -#: ../src/Doc/library/ctypes.rst:1351 +#: library/ctypes.rst:1351 msgid "" "There are several ways to loaded shared libraries into the Python process. " "One way is to instantiate one of the following classes:" msgstr "" # 10946094ccc848cb883a65e0c5fb3f5c -#: ../src/Doc/library/ctypes.rst:1357 +#: library/ctypes.rst:1357 msgid "" "Instances of this class represent loaded shared libraries. Functions in " "these libraries use the standard C calling convention, and are assumed to " "return :c:type:`int`." msgstr "" -#: ../src/Doc/library/ctypes.rst:1364 +#: library/ctypes.rst:1364 msgid "" "Windows only: Instances of this class represent loaded shared libraries, " "functions in these libraries use the ``stdcall`` calling convention, and are " @@ -20761,27 +20876,27 @@ msgid "" msgstr "" # 709a2208ff584a798701dec4f98f294a -#: ../src/Doc/library/ctypes.rst:1374 +#: library/ctypes.rst:1374 msgid "" "Windows only: Instances of this class represent loaded shared libraries, " "functions in these libraries use the ``stdcall`` calling convention, and are " "assumed to return :c:type:`int` by default." msgstr "" -#: ../src/Doc/library/ctypes.rst:1378 +#: library/ctypes.rst:1378 msgid "" "On Windows CE only the standard calling convention is used, for convenience " "the :class:`WinDLL` and :class:`OleDLL` use the standard calling convention " "on this platform." msgstr "" -#: ../src/Doc/library/ctypes.rst:1382 +#: library/ctypes.rst:1382 msgid "" "The Python :term:`global interpreter lock` is released before calling any " "function exported by these libraries, and reacquired afterwards." msgstr "" -#: ../src/Doc/library/ctypes.rst:1388 +#: library/ctypes.rst:1388 msgid "" "Instances of this class behave like :class:`CDLL` instances, except that the " "Python GIL is *not* released during the function call, and after the " @@ -20789,11 +20904,11 @@ msgid "" "set, a Python exception is raised." msgstr "" -#: ../src/Doc/library/ctypes.rst:1393 +#: library/ctypes.rst:1393 msgid "Thus, this is only useful to call Python C api functions directly." msgstr "" -#: ../src/Doc/library/ctypes.rst:1395 +#: library/ctypes.rst:1395 msgid "" "All these classes can be instantiated by calling them with at least one " "argument, the pathname of the shared library. If you have an existing " @@ -20803,14 +20918,14 @@ msgid "" "to get a handle to it." msgstr "" -#: ../src/Doc/library/ctypes.rst:1402 +#: library/ctypes.rst:1402 msgid "" "The *mode* parameter can be used to specify how the library is loaded. For " "details, consult the :manpage:`dlopen(3)` manpage, on Windows, *mode* is " "ignored." msgstr "" -#: ../src/Doc/library/ctypes.rst:1406 +#: library/ctypes.rst:1406 msgid "" "The *use_errno* parameter, when set to True, enables a ctypes mechanism that " "allows to access the system :data:`errno` error number in a safe way. :mod:" @@ -20820,14 +20935,14 @@ msgid "" "private copy, the same happens immediately after the function call." msgstr "" -#: ../src/Doc/library/ctypes.rst:1413 +#: library/ctypes.rst:1413 msgid "" "The function :func:`ctypes.get_errno` returns the value of the ctypes " "private copy, and the function :func:`ctypes.set_errno` changes the ctypes " "private copy to a new value and returns the former value." msgstr "" -#: ../src/Doc/library/ctypes.rst:1417 +#: library/ctypes.rst:1417 msgid "" "The *use_last_error* parameter, when set to True, enables the same mechanism " "for the Windows error code which is managed by the :func:`GetLastError` and :" @@ -20836,26 +20951,30 @@ msgid "" "private copy of the windows error code." msgstr "" -#: ../src/Doc/library/ctypes.rst:1429 +#: library/ctypes.rst:1423 +msgid "The *use_last_error* and *use_errno* optional parameters were added." +msgstr "" + +#: library/ctypes.rst:1429 msgid "" "Flag to use as *mode* parameter. On platforms where this flag is not " "available, it is defined as the integer zero." msgstr "" -#: ../src/Doc/library/ctypes.rst:1436 +#: library/ctypes.rst:1436 msgid "" "Flag to use as *mode* parameter. On platforms where this is not available, " "it is the same as *RTLD_GLOBAL*." msgstr "" -#: ../src/Doc/library/ctypes.rst:1443 +#: library/ctypes.rst:1443 msgid "" "The default mode which is used to load shared libraries. On OSX 10.3, this " "is *RTLD_GLOBAL*, otherwise it is the same as *RTLD_LOCAL*." msgstr "" # c0e150077d594417a4c5a9d0ea1b0fef -#: ../src/Doc/library/ctypes.rst:1446 +#: library/ctypes.rst:1446 msgid "" "Instances of these classes have no public methods. Functions exported by " "the shared library can be accessed as attributes or by index. Please note " @@ -20864,21 +20983,21 @@ msgid "" "other hand, accessing it through an index returns a new object each time:" msgstr "" -#: ../src/Doc/library/ctypes.rst:1457 +#: library/ctypes.rst:1457 msgid "" "The following public attributes are available, their name starts with an " "underscore to not clash with exported function names:" msgstr "" -#: ../src/Doc/library/ctypes.rst:1463 +#: library/ctypes.rst:1463 msgid "The system handle used to access the library." msgstr "" -#: ../src/Doc/library/ctypes.rst:1468 +#: library/ctypes.rst:1468 msgid "The name of the library passed in the constructor." msgstr "" -#: ../src/Doc/library/ctypes.rst:1470 +#: library/ctypes.rst:1470 msgid "" "Shared libraries can also be loaded by using one of the prefabricated " "objects, which are instances of the :class:`LibraryLoader` class, either by " @@ -20886,53 +21005,53 @@ msgid "" "attribute of the loader instance." msgstr "" -#: ../src/Doc/library/ctypes.rst:1478 +#: library/ctypes.rst:1478 msgid "" "Class which loads shared libraries. *dlltype* should be one of the :class:" "`CDLL`, :class:`PyDLL`, :class:`WinDLL`, or :class:`OleDLL` types." msgstr "" -#: ../src/Doc/library/ctypes.rst:1481 +#: library/ctypes.rst:1481 msgid "" ":meth:`__getattr__` has special behavior: It allows to load a shared library " "by accessing it as attribute of a library loader instance. The result is " "cached, so repeated attribute accesses return the same library each time." msgstr "" -#: ../src/Doc/library/ctypes.rst:1488 +#: library/ctypes.rst:1488 msgid "" "Load a shared library into the process and return it. This method always " "returns a new instance of the library." msgstr "" -#: ../src/Doc/library/ctypes.rst:1491 +#: library/ctypes.rst:1491 msgid "These prefabricated library loaders are available:" msgstr "" -#: ../src/Doc/library/ctypes.rst:1497 +#: library/ctypes.rst:1497 msgid "Creates :class:`CDLL` instances." msgstr "" -#: ../src/Doc/library/ctypes.rst:1503 +#: library/ctypes.rst:1503 msgid "Windows only: Creates :class:`WinDLL` instances." msgstr "" -#: ../src/Doc/library/ctypes.rst:1509 +#: library/ctypes.rst:1509 msgid "Windows only: Creates :class:`OleDLL` instances." msgstr "" -#: ../src/Doc/library/ctypes.rst:1515 +#: library/ctypes.rst:1515 msgid "Creates :class:`PyDLL` instances." msgstr "" -#: ../src/Doc/library/ctypes.rst:1517 +#: library/ctypes.rst:1517 msgid "" "For accessing the C Python api directly, a ready-to-use Python shared " "library object is available:" msgstr "" # 2b429ae7df07461883b3f2cc6707de7e -#: ../src/Doc/library/ctypes.rst:1524 +#: library/ctypes.rst:1524 msgid "" "An instance of :class:`PyDLL` that exposes Python C API functions as " "attributes. Note that all these functions are assumed to return C :c:type:" @@ -20940,11 +21059,11 @@ msgid "" "correct :attr:`restype` attribute to use these functions." msgstr "" -#: ../src/Doc/library/ctypes.rst:1533 +#: library/ctypes.rst:1533 msgid "Foreign functions" msgstr "" -#: ../src/Doc/library/ctypes.rst:1535 +#: library/ctypes.rst:1535 msgid "" "As explained in the previous section, foreign functions can be accessed as " "attributes of loaded shared libraries. The function objects created in this " @@ -20953,31 +21072,31 @@ msgid "" "library loader. They are instances of a private class:" msgstr "" -#: ../src/Doc/library/ctypes.rst:1544 +#: library/ctypes.rst:1544 msgid "Base class for C callable foreign functions." msgstr "" -#: ../src/Doc/library/ctypes.rst:1546 +#: library/ctypes.rst:1546 msgid "" "Instances of foreign functions are also C compatible data types; they " "represent C function pointers." msgstr "" -#: ../src/Doc/library/ctypes.rst:1549 +#: library/ctypes.rst:1549 msgid "" "This behavior can be customized by assigning to special attributes of the " "foreign function object." msgstr "" # 3cce6560026644dbafeb443fdfc44c68 -#: ../src/Doc/library/ctypes.rst:1555 +#: library/ctypes.rst:1555 msgid "" "Assign a ctypes type to specify the result type of the foreign function. Use " "``None`` for :c:type:`void`, a function not returning anything." msgstr "" # ed8377ba62d34195ada27eab963b5a6a -#: ../src/Doc/library/ctypes.rst:1558 +#: library/ctypes.rst:1558 msgid "" "It is possible to assign a callable Python object that is not a ctypes type, " "in this case the function is assumed to return a C :c:type:`int`, and the " @@ -20987,7 +21106,7 @@ msgid "" "assign a callable to the :attr:`errcheck` attribute." msgstr "" -#: ../src/Doc/library/ctypes.rst:1568 +#: library/ctypes.rst:1568 msgid "" "Assign a tuple of ctypes types to specify the argument types that the " "function accepts. Functions using the ``stdcall`` calling convention can " @@ -20997,7 +21116,7 @@ msgid "" msgstr "" # 8ff2fd48363847c7b5d570f2cd471bc9 -#: ../src/Doc/library/ctypes.rst:1574 +#: library/ctypes.rst:1574 msgid "" "When a foreign function is called, each actual argument is passed to the :" "meth:`from_param` class method of the items in the :attr:`argtypes` tuple, " @@ -21007,7 +21126,7 @@ msgid "" "an byte string using ctypes conversion rules." msgstr "" -#: ../src/Doc/library/ctypes.rst:1581 +#: library/ctypes.rst:1581 msgid "" "New: It is now possible to put items in argtypes which are not ctypes types, " "but each item must have a :meth:`from_param` method which returns a value " @@ -21015,48 +21134,48 @@ msgid "" "define adapters that can adapt custom objects as function parameters." msgstr "" -#: ../src/Doc/library/ctypes.rst:1589 +#: library/ctypes.rst:1589 msgid "" "Assign a Python function or another callable to this attribute. The callable " "will be called with three or more arguments:" msgstr "" -#: ../src/Doc/library/ctypes.rst:1595 +#: library/ctypes.rst:1595 msgid "" "*result* is what the foreign function returns, as specified by the :attr:" "`restype` attribute." msgstr "" -#: ../src/Doc/library/ctypes.rst:1598 +#: library/ctypes.rst:1598 msgid "" "*func* is the foreign function object itself, this allows to reuse the same " "callable object to check or post process the results of several functions." msgstr "" -#: ../src/Doc/library/ctypes.rst:1602 +#: library/ctypes.rst:1602 msgid "" "*arguments* is a tuple containing the parameters originally passed to the " "function call, this allows to specialize the behavior on the arguments used." msgstr "" -#: ../src/Doc/library/ctypes.rst:1606 +#: library/ctypes.rst:1606 msgid "" "The object that this function returns will be returned from the foreign " "function call, but it can also check the result value and raise an exception " "if the foreign function call failed." msgstr "" -#: ../src/Doc/library/ctypes.rst:1613 +#: library/ctypes.rst:1613 msgid "" "This exception is raised when a foreign function call cannot convert one of " "the passed arguments." msgstr "" -#: ../src/Doc/library/ctypes.rst:1620 +#: library/ctypes.rst:1620 msgid "Function prototypes" msgstr "" -#: ../src/Doc/library/ctypes.rst:1622 +#: library/ctypes.rst:1622 msgid "" "Foreign functions can also be created by instantiating function prototypes. " "Function prototypes are similar to function prototypes in C; they describe a " @@ -21065,7 +21184,7 @@ msgid "" "result type and the argument types of the function." msgstr "" -#: ../src/Doc/library/ctypes.rst:1631 +#: library/ctypes.rst:1631 msgid "" "The returned function prototype creates functions that use the standard C " "calling convention. The function will release the GIL during the call. If " @@ -21074,7 +21193,11 @@ msgid "" "after the call; *use_last_error* does the same for the Windows error code." msgstr "" -#: ../src/Doc/library/ctypes.rst:1644 +#: library/ctypes.rst:1638 +msgid "The optional *use_errno* and *use_last_error* parameters were added." +msgstr "" + +#: library/ctypes.rst:1644 msgid "" "Windows only: The returned function prototype creates functions that use the " "``stdcall`` calling convention, except on Windows CE where :func:" @@ -21083,30 +21206,30 @@ msgid "" "meaning as above." msgstr "" -#: ../src/Doc/library/ctypes.rst:1653 +#: library/ctypes.rst:1653 msgid "" "The returned function prototype creates functions that use the Python " "calling convention. The function will *not* release the GIL during the call." msgstr "" -#: ../src/Doc/library/ctypes.rst:1656 +#: library/ctypes.rst:1656 msgid "" "Function prototypes created by these factory functions can be instantiated " "in different ways, depending on the type and number of the parameters in the " "call:" msgstr "" -#: ../src/Doc/library/ctypes.rst:1664 +#: library/ctypes.rst:1664 msgid "" "Returns a foreign function at the specified address which must be an integer." msgstr "" -#: ../src/Doc/library/ctypes.rst:1671 +#: library/ctypes.rst:1671 msgid "" "Create a C callable function (a callback function) from a Python *callable*." msgstr "" -#: ../src/Doc/library/ctypes.rst:1678 +#: library/ctypes.rst:1678 msgid "" "Returns a foreign function exported by a shared library. *func_spec* must be " "a 2-tuple ``(name_or_ordinal, library)``. The first item is the name of the " @@ -21114,7 +21237,7 @@ msgid "" "small integer. The second item is the shared library instance." msgstr "" -#: ../src/Doc/library/ctypes.rst:1688 +#: library/ctypes.rst:1688 msgid "" "Returns a foreign function that will call a COM method. *vtbl_index* is the " "index into the virtual function table, a small non-negative integer. *name* " @@ -21122,73 +21245,73 @@ msgid "" "identifier which is used in extended error reporting." msgstr "" -#: ../src/Doc/library/ctypes.rst:1693 +#: library/ctypes.rst:1693 msgid "" "COM methods use a special calling convention: They require a pointer to the " "COM interface as first argument, in addition to those parameters that are " "specified in the :attr:`argtypes` tuple." msgstr "" -#: ../src/Doc/library/ctypes.rst:1697 +#: library/ctypes.rst:1697 msgid "" "The optional *paramflags* parameter creates foreign function wrappers with " "much more functionality than the features described above." msgstr "" -#: ../src/Doc/library/ctypes.rst:1700 +#: library/ctypes.rst:1700 msgid "*paramflags* must be a tuple of the same length as :attr:`argtypes`." msgstr "" -#: ../src/Doc/library/ctypes.rst:1702 +#: library/ctypes.rst:1702 msgid "" "Each item in this tuple contains further information about a parameter, it " "must be a tuple containing one, two, or three items." msgstr "" -#: ../src/Doc/library/ctypes.rst:1705 +#: library/ctypes.rst:1705 msgid "" "The first item is an integer containing a combination of direction flags for " "the parameter:" msgstr "" -#: ../src/Doc/library/ctypes.rst:1709 +#: library/ctypes.rst:1709 msgid "Specifies an input parameter to the function." msgstr "" -#: ../src/Doc/library/ctypes.rst:1712 +#: library/ctypes.rst:1712 msgid "Output parameter. The foreign function fills in a value." msgstr "" -#: ../src/Doc/library/ctypes.rst:1715 +#: library/ctypes.rst:1715 msgid "Input parameter which defaults to the integer zero." msgstr "" -#: ../src/Doc/library/ctypes.rst:1717 +#: library/ctypes.rst:1717 msgid "" "The optional second item is the parameter name as string. If this is " "specified, the foreign function can be called with named parameters." msgstr "" -#: ../src/Doc/library/ctypes.rst:1720 +#: library/ctypes.rst:1720 msgid "The optional third item is the default value for this parameter." msgstr "" -#: ../src/Doc/library/ctypes.rst:1722 +#: library/ctypes.rst:1722 msgid "" "This example demonstrates how to wrap the Windows ``MessageBoxA`` function " "so that it supports default parameters and named arguments. The C " "declaration from the windows header file is this::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1733 ../src/Doc/library/ctypes.rst:1758 +#: library/ctypes.rst:1733 library/ctypes.rst:1758 msgid "Here is the wrapping with :mod:`ctypes`::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1742 +#: library/ctypes.rst:1742 msgid "The MessageBox foreign function can now be called in these ways::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1749 +#: library/ctypes.rst:1749 msgid "" "A second example demonstrates output parameters. The win32 " "``GetWindowRect`` function retrieves the dimensions of a specified window by " @@ -21196,7 +21319,7 @@ msgid "" "the C declaration::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1767 +#: library/ctypes.rst:1767 msgid "" "Functions with output parameters will automatically return the output " "parameter value if there is a single one, or a tuple containing the output " @@ -21204,7 +21327,7 @@ msgid "" "now returns a RECT instance, when called." msgstr "" -#: ../src/Doc/library/ctypes.rst:1772 +#: library/ctypes.rst:1772 msgid "" "Output parameters can be combined with the :attr:`errcheck` protocol to do " "further output processing and error checking. The win32 ``GetWindowRect`` " @@ -21213,7 +21336,7 @@ msgid "" "call failed::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1785 +#: library/ctypes.rst:1785 msgid "" "If the :attr:`errcheck` function returns the argument tuple it receives " "unchanged, :mod:`ctypes` continues the normal processing it does on the " @@ -21222,42 +21345,46 @@ msgid "" "and return them instead, the normal processing will no longer take place::" msgstr "" -#: ../src/Doc/library/ctypes.rst:1804 ../src/Doc/library/urllib.rst:209 +#: library/ctypes.rst:1804 library/urllib.rst:221 msgid "Utility functions" msgstr "" -#: ../src/Doc/library/ctypes.rst:1809 +#: library/ctypes.rst:1809 msgid "" "Returns the address of the memory buffer as integer. *obj* must be an " "instance of a ctypes type." msgstr "" -#: ../src/Doc/library/ctypes.rst:1815 +#: library/ctypes.rst:1815 msgid "" "Returns the alignment requirements of a ctypes type. *obj_or_type* must be a " "ctypes type or instance." msgstr "" -#: ../src/Doc/library/ctypes.rst:1821 +#: library/ctypes.rst:1821 msgid "" "Returns a light-weight pointer to *obj*, which must be an instance of a " "ctypes type. *offset* defaults to zero, and must be an integer that will be " "added to the internal pointer value." msgstr "" -#: ../src/Doc/library/ctypes.rst:1825 +#: library/ctypes.rst:1825 msgid "``byref(obj, offset)`` corresponds to this C code::" msgstr "" # ec826071e9894c0992642428b3505e46 -#: ../src/Doc/library/ctypes.rst:1829 +#: library/ctypes.rst:1829 msgid "" "The returned object can only be used as a foreign function call parameter. " "It behaves similar to ``pointer(obj)``, but the construction is a lot faster." msgstr "" +#: library/ctypes.rst:1833 +msgid "The *offset* optional argument was added." +msgstr "" + # 76642bf21db843a3b38bfde8c19990e6 -#: ../src/Doc/library/ctypes.rst:1839 +#: library/ctypes.rst:1839 msgid "" "This function is similar to the cast operator in C. It returns a new " "instance of *type* which points to the same memory block as *obj*. *type* " @@ -21265,19 +21392,19 @@ msgid "" "as a pointer." msgstr "" -#: ../src/Doc/library/ctypes.rst:1847 +#: library/ctypes.rst:1847 msgid "" "This function creates a mutable character buffer. The returned object is a " "ctypes array of :class:`c_char`." msgstr "" -#: ../src/Doc/library/ctypes.rst:1850 +#: library/ctypes.rst:1850 msgid "" "*init_or_size* must be an integer which specifies the size of the array, or " "a string which will be used to initialize the array items." msgstr "" -#: ../src/Doc/library/ctypes.rst:1853 +#: library/ctypes.rst:1853 msgid "" "If a string is specified as first argument, the buffer is made one item " "larger than the length of the string so that the last element in the array " @@ -21287,27 +21414,27 @@ msgid "" msgstr "" # 456433e7ffd1425899d1ef07a6b4da23 -#: ../src/Doc/library/ctypes.rst:1858 +#: library/ctypes.rst:1858 msgid "" "If the first parameter is a unicode string, it is converted into an 8-bit " "string according to ctypes conversion rules." msgstr "" -#: ../src/Doc/library/ctypes.rst:1864 +#: library/ctypes.rst:1864 msgid "" "This function creates a mutable unicode character buffer. The returned " "object is a ctypes array of :class:`c_wchar`." msgstr "" # 263c5823095942ea89d6921ad833ea19 -#: ../src/Doc/library/ctypes.rst:1867 +#: library/ctypes.rst:1867 msgid "" "*init_or_size* must be an integer which specifies the size of the array, or " "a unicode string which will be used to initialize the array items." msgstr "" # cccc952a098f476c8a8062d3c035312e -#: ../src/Doc/library/ctypes.rst:1870 +#: library/ctypes.rst:1870 msgid "" "If a unicode string is specified as first argument, the buffer is made one " "item larger than the length of the string so that the last element in the " @@ -21317,27 +21444,27 @@ msgid "" msgstr "" # 4a38e0d733ed44bab7af082c9c7b7533 -#: ../src/Doc/library/ctypes.rst:1876 +#: library/ctypes.rst:1876 msgid "" "If the first parameter is a 8-bit string, it is converted into an unicode " "string according to ctypes conversion rules." msgstr "" -#: ../src/Doc/library/ctypes.rst:1882 +#: library/ctypes.rst:1882 msgid "" "Windows only: This function is a hook which allows to implement in-process " "COM servers with ctypes. It is called from the DllCanUnloadNow function " "that the _ctypes extension dll exports." msgstr "" -#: ../src/Doc/library/ctypes.rst:1889 +#: library/ctypes.rst:1889 msgid "" "Windows only: This function is a hook which allows to implement in-process " "COM servers with ctypes. It is called from the DllGetClassObject function " "that the ``_ctypes`` extension dll exports." msgstr "" -#: ../src/Doc/library/ctypes.rst:1897 +#: library/ctypes.rst:1897 msgid "" "Try to find a library and return a pathname. *name* is the library name " "without any prefix like ``lib``, suffix like ``.so``, ``.dylib`` or version " @@ -21345,81 +21472,87 @@ msgid "" "no library can be found, returns ``None``." msgstr "" +#: library/ctypes.rst:1904 +msgid "" +"Windows only: ``find_library(\"m\")`` or ``find_library(\"c\")`` return the " +"result of a call to ``find_msvcrt()``." +msgstr "" + # ec480e354ffd4a7bad9b5ec9c3525dfd -#: ../src/Doc/library/ctypes.rst:1912 +#: library/ctypes.rst:1912 msgid "" "Windows only: return the filename of the VC runtime library used by Python, " "and by the extension modules. If the name of the library cannot be " "determined, ``None`` is returned." msgstr "" -#: ../src/Doc/library/ctypes.rst:1916 +#: library/ctypes.rst:1916 msgid "" "If you need to free memory, for example, allocated by an extension module " "with a call to the ``free(void *)``, it is important that you use the " "function in the same library that allocated the memory." msgstr "" -#: ../src/Doc/library/ctypes.rst:1925 +#: library/ctypes.rst:1925 msgid "" "Windows only: Returns a textual description of the error code *code*. If no " "error code is specified, the last error code is used by calling the Windows " "api function GetLastError." msgstr "" -#: ../src/Doc/library/ctypes.rst:1932 +#: library/ctypes.rst:1932 msgid "" "Windows only: Returns the last error code set by Windows in the calling " "thread. This function calls the Windows `GetLastError()` function directly, " "it does not return the ctypes-private copy of the error code." msgstr "" -#: ../src/Doc/library/ctypes.rst:1938 +#: library/ctypes.rst:1938 msgid "" "Returns the current value of the ctypes-private copy of the system :data:" "`errno` variable in the calling thread." msgstr "" -#: ../src/Doc/library/ctypes.rst:1945 +#: library/ctypes.rst:1945 msgid "" "Windows only: returns the current value of the ctypes-private copy of the " "system :data:`LastError` variable in the calling thread." msgstr "" -#: ../src/Doc/library/ctypes.rst:1952 +#: library/ctypes.rst:1952 msgid "" "Same as the standard C memmove library function: copies *count* bytes from " "*src* to *dst*. *dst* and *src* must be integers or ctypes instances that " "can be converted to pointers." msgstr "" -#: ../src/Doc/library/ctypes.rst:1959 +#: library/ctypes.rst:1959 msgid "" "Same as the standard C memset library function: fills the memory block at " "address *dst* with *count* bytes of value *c*. *dst* must be an integer " "specifying an address, or a ctypes instance." msgstr "" -#: ../src/Doc/library/ctypes.rst:1966 +#: library/ctypes.rst:1966 msgid "" "This factory function creates and returns a new ctypes pointer type. Pointer " "types are cached an reused internally, so calling this function repeatedly " "is cheap. *type* must be a ctypes type." msgstr "" -#: ../src/Doc/library/ctypes.rst:1973 +#: library/ctypes.rst:1973 msgid "" "This function creates a new pointer instance, pointing to *obj*. The " "returned object is of the type ``POINTER(type(obj))``." msgstr "" -#: ../src/Doc/library/ctypes.rst:1976 +#: library/ctypes.rst:1976 msgid "" "Note: If you just want to pass a pointer to an object to a foreign function " "call, you should use ``byref(obj)`` which is much faster." msgstr "" -#: ../src/Doc/library/ctypes.rst:1982 +#: library/ctypes.rst:1982 msgid "" "This function resizes the internal memory buffer of *obj*, which must be an " "instance of a ctypes type. It is not possible to make the buffer smaller " @@ -21428,7 +21561,7 @@ msgid "" msgstr "" # 489625976730494a8632b2f0a483b00f -#: ../src/Doc/library/ctypes.rst:1990 +#: library/ctypes.rst:1990 msgid "" "This function sets the rules that ctypes objects use when converting between " "8-bit strings and unicode strings. *encoding* must be a string specifying " @@ -21438,20 +21571,20 @@ msgid "" msgstr "" # 7f39e9d5cee54e4e89f16ed1179082d4 -#: ../src/Doc/library/ctypes.rst:1996 +#: library/ctypes.rst:1996 msgid "" ":func:`set_conversion_mode` returns a 2-tuple containing the previous " "conversion rules. On windows, the initial conversion rules are ``('mbcs', " "'ignore')``, on other systems ``('ascii', 'strict')``." msgstr "" -#: ../src/Doc/library/ctypes.rst:2003 +#: library/ctypes.rst:2003 msgid "" "Set the current value of the ctypes-private copy of the system :data:`errno` " "variable in the calling thread to *value* and return the previous value." msgstr "" -#: ../src/Doc/library/ctypes.rst:2011 +#: library/ctypes.rst:2011 msgid "" "Windows only: set the current value of the ctypes-private copy of the " "system :data:`LastError` variable in the calling thread to *value* and " @@ -21459,14 +21592,14 @@ msgid "" msgstr "" # c340141ac5e34f43b81051c77edbe02a -#: ../src/Doc/library/ctypes.rst:2020 +#: library/ctypes.rst:2020 msgid "" "Returns the size in bytes of a ctypes type or instance memory buffer. Does " "the same as the C ``sizeof`` operator." msgstr "" # b89b34d34a814597b12134f62ebbdad5 -#: ../src/Doc/library/ctypes.rst:2026 +#: library/ctypes.rst:2026 msgid "" "This function returns the string starting at memory address *address*. If " "size is specified, it is used as size, otherwise the string is assumed to be " @@ -21474,7 +21607,7 @@ msgid "" msgstr "" # 433b98c1d6a64e3bb9df2f7d5ec396f7 -#: ../src/Doc/library/ctypes.rst:2033 +#: library/ctypes.rst:2033 msgid "" "Windows only: this function is probably the worst-named thing in ctypes. It " "creates an instance of WindowsError. If *code* is not specified, " @@ -21484,7 +21617,7 @@ msgid "" msgstr "" # 4e5574b0621143a2b7773dc7e7e74194 -#: ../src/Doc/library/ctypes.rst:2042 +#: library/ctypes.rst:2042 msgid "" "This function returns the wide character string starting at memory address " "*address* as unicode string. If *size* is specified, it is used as the " @@ -21492,12 +21625,12 @@ msgid "" "zero-terminated." msgstr "" -#: ../src/Doc/library/ctypes.rst:2051 +#: library/ctypes.rst:2051 msgid "Data types" msgstr "" # 089a43ea2bda46b2ae55b13cca13fdae -#: ../src/Doc/library/ctypes.rst:2056 +#: library/ctypes.rst:2056 msgid "" "This non-public class is the common base class of all ctypes data types. " "Among other things, all ctypes type instances contain a memory block that " @@ -21507,13 +21640,13 @@ msgid "" "alive in case the memory block contains pointers." msgstr "" -#: ../src/Doc/library/ctypes.rst:2063 +#: library/ctypes.rst:2063 msgid "" "Common methods of ctypes data types, these are all class methods (to be " "exact, they are methods of the :term:`metaclass`):" msgstr "" -#: ../src/Doc/library/ctypes.rst:2069 +#: library/ctypes.rst:2069 msgid "" "This method returns a ctypes instance that shares the buffer of the *source* " "object. The *source* object must support the writeable buffer interface. " @@ -21522,7 +21655,7 @@ msgid "" "exc:`ValueError` is raised." msgstr "" -#: ../src/Doc/library/ctypes.rst:2080 +#: library/ctypes.rst:2080 msgid "" "This method creates a ctypes instance, copying the buffer from the *source* " "object buffer which must be readable. The optional *offset* parameter " @@ -21530,13 +21663,13 @@ msgid "" "If the source buffer is not large enough a :exc:`ValueError` is raised." msgstr "" -#: ../src/Doc/library/ctypes.rst:2091 +#: library/ctypes.rst:2091 msgid "" "This method returns a ctypes type instance using the memory specified by " "*address* which must be an integer." msgstr "" -#: ../src/Doc/library/ctypes.rst:2097 +#: library/ctypes.rst:2097 msgid "" "This method adapts *obj* to a ctypes type. It is called with the actual " "object used in a foreign function call when the type is present in the " @@ -21544,25 +21677,25 @@ msgid "" "be used as a function call parameter." msgstr "" -#: ../src/Doc/library/ctypes.rst:2102 +#: library/ctypes.rst:2102 msgid "" "All ctypes data types have a default implementation of this classmethod that " "normally returns *obj* if that is an instance of the type. Some types " "accept other objects as well." msgstr "" -#: ../src/Doc/library/ctypes.rst:2109 +#: library/ctypes.rst:2109 msgid "" "This method returns a ctypes type instance exported by a shared library. " "*name* is the name of the symbol that exports the data, *library* is the " "loaded shared library." msgstr "" -#: ../src/Doc/library/ctypes.rst:2114 +#: library/ctypes.rst:2114 msgid "Common instance variables of ctypes data types:" msgstr "" -#: ../src/Doc/library/ctypes.rst:2118 +#: library/ctypes.rst:2118 msgid "" "Sometimes ctypes data instances do not own the memory block they contain, " "instead they share part of the memory block of a base object. The :attr:" @@ -21570,13 +21703,13 @@ msgid "" "block." msgstr "" -#: ../src/Doc/library/ctypes.rst:2126 +#: library/ctypes.rst:2126 msgid "" "This read-only variable is true when the ctypes data instance has allocated " "the memory block itself, false otherwise." msgstr "" -#: ../src/Doc/library/ctypes.rst:2132 +#: library/ctypes.rst:2132 msgid "" "This member is either ``None`` or a dictionary containing Python objects " "that need to be kept alive so that the memory block contents is kept valid. " @@ -21585,7 +21718,7 @@ msgid "" msgstr "" # f842199c599d4ed4a435aa152b81f9a7 -#: ../src/Doc/library/ctypes.rst:2146 +#: library/ctypes.rst:2146 msgid "" "This non-public class is the base class of all fundamental ctypes data " "types. It is mentioned here because it contains the common attributes of the " @@ -21593,12 +21726,18 @@ msgid "" "class:`_CData`, so it inherits their methods and attributes." msgstr "" -#: ../src/Doc/library/ctypes.rst:2155 +#: library/ctypes.rst:2151 +msgid "" +"ctypes data types that are not and do not contain pointers can now be " +"pickled." +msgstr "" + +#: library/ctypes.rst:2155 msgid "Instances have a single attribute:" msgstr "" # bd1f02f89f76492c88d3a5a18d2f4f58 -#: ../src/Doc/library/ctypes.rst:2159 +#: library/ctypes.rst:2159 msgid "" "This attribute contains the actual value of the instance. For integer and " "pointer types, it is an integer, for character types, it is a single " @@ -21606,7 +21745,7 @@ msgid "" "unicode string." msgstr "" -#: ../src/Doc/library/ctypes.rst:2164 +#: library/ctypes.rst:2164 msgid "" "When the ``value`` attribute is retrieved from a ctypes instance, usually a " "new object is returned each time. :mod:`ctypes` does *not* implement " @@ -21615,7 +21754,7 @@ msgid "" msgstr "" # 5b5265fa092b417f998a4e80b7119fb4 -#: ../src/Doc/library/ctypes.rst:2170 +#: library/ctypes.rst:2170 msgid "" "Fundamental data types, when returned as foreign function call results, or, " "for example, by retrieving structure field members or array items, are " @@ -21624,7 +21763,7 @@ msgid "" "receive a Python string, *not* a :class:`c_char_p` instance." msgstr "" -#: ../src/Doc/library/ctypes.rst:2176 +#: library/ctypes.rst:2176 msgid "" "Subclasses of fundamental data types do *not* inherit this behavior. So, if " "a foreign functions :attr:`restype` is a subclass of :class:`c_void_p`, you " @@ -21632,12 +21771,12 @@ msgid "" "you can get the value of the pointer by accessing the ``value`` attribute." msgstr "" -#: ../src/Doc/library/ctypes.rst:2181 +#: library/ctypes.rst:2181 msgid "These are the fundamental ctypes data types:" msgstr "" # 8ae1a771a6be41999c598033f7305a4b -#: ../src/Doc/library/ctypes.rst:2185 +#: library/ctypes.rst:2185 msgid "" "Represents the C :c:type:`signed char` datatype, and interprets the value as " "small integer. The constructor accepts an optional integer initializer; no " @@ -21645,7 +21784,7 @@ msgid "" msgstr "" # 291f48ee14274198adc2fba5a5e6d290 -#: ../src/Doc/library/ctypes.rst:2192 +#: library/ctypes.rst:2192 msgid "" "Represents the C :c:type:`char` datatype, and interprets the value as a " "single character. The constructor accepts an optional string initializer, " @@ -21653,7 +21792,7 @@ msgid "" msgstr "" # 68caa20a96d14adf82d48d2796d294ee -#: ../src/Doc/library/ctypes.rst:2199 +#: library/ctypes.rst:2199 msgid "" "Represents the C :c:type:`char *` datatype when it points to a zero-" "terminated string. For a general character pointer that may also point to " @@ -21662,14 +21801,14 @@ msgid "" msgstr "" # 7f206e9ea8204cc99728f7bdc1fb278c -#: ../src/Doc/library/ctypes.rst:2207 +#: library/ctypes.rst:2207 msgid "" "Represents the C :c:type:`double` datatype. The constructor accepts an " "optional float initializer." msgstr "" # ebe427ca52e64c51b77a2903090aceac -#: ../src/Doc/library/ctypes.rst:2213 +#: library/ctypes.rst:2213 msgid "" "Represents the C :c:type:`long double` datatype. The constructor accepts an " "optional float initializer. On platforms where ``sizeof(long double) == " @@ -21677,14 +21816,14 @@ msgid "" msgstr "" # 02daac8c9ab84c628480f1c837aa80dd -#: ../src/Doc/library/ctypes.rst:2221 +#: library/ctypes.rst:2221 msgid "" "Represents the C :c:type:`float` datatype. The constructor accepts an " "optional float initializer." msgstr "" # d8ecbdee226c4ce38b1109d08aead4d1 -#: ../src/Doc/library/ctypes.rst:2227 +#: library/ctypes.rst:2227 msgid "" "Represents the C :c:type:`signed int` datatype. The constructor accepts an " "optional integer initializer; no overflow checking is done. On platforms " @@ -21692,66 +21831,66 @@ msgid "" msgstr "" # e488100d2be8450f9243c388980f6296 -#: ../src/Doc/library/ctypes.rst:2234 +#: library/ctypes.rst:2234 msgid "" "Represents the C 8-bit :c:type:`signed int` datatype. Usually an alias for :" "class:`c_byte`." msgstr "" # f0a23fa466544dc391d64ba64dacce5a -#: ../src/Doc/library/ctypes.rst:2240 +#: library/ctypes.rst:2240 msgid "" "Represents the C 16-bit :c:type:`signed int` datatype. Usually an alias " "for :class:`c_short`." msgstr "" # 82866216803f4255b767b8fbd58b4d09 -#: ../src/Doc/library/ctypes.rst:2246 +#: library/ctypes.rst:2246 msgid "" "Represents the C 32-bit :c:type:`signed int` datatype. Usually an alias " "for :class:`c_int`." msgstr "" # 0e31f9968d6548fe9b85fde0cdbd8fd7 -#: ../src/Doc/library/ctypes.rst:2252 +#: library/ctypes.rst:2252 msgid "" "Represents the C 64-bit :c:type:`signed int` datatype. Usually an alias " "for :class:`c_longlong`." msgstr "" # 2889c951efd9400cb567da49753abbd1 -#: ../src/Doc/library/ctypes.rst:2258 +#: library/ctypes.rst:2258 msgid "" "Represents the C :c:type:`signed long` datatype. The constructor accepts an " "optional integer initializer; no overflow checking is done." msgstr "" # 68084956097c4bf288f305696cd165bc -#: ../src/Doc/library/ctypes.rst:2264 +#: library/ctypes.rst:2264 msgid "" "Represents the C :c:type:`signed long long` datatype. The constructor " "accepts an optional integer initializer; no overflow checking is done." msgstr "" # 29a4e8cb1698452c81be834999d61c02 -#: ../src/Doc/library/ctypes.rst:2270 +#: library/ctypes.rst:2270 msgid "" "Represents the C :c:type:`signed short` datatype. The constructor accepts " "an optional integer initializer; no overflow checking is done." msgstr "" # f975d6266ce64e82962b13850f918829 -#: ../src/Doc/library/ctypes.rst:2276 +#: library/ctypes.rst:2276 msgid "Represents the C :c:type:`size_t` datatype." msgstr "" # 45ae23c0139d43c3ba15079b34d9b6d4 -#: ../src/Doc/library/ctypes.rst:2281 +#: library/ctypes.rst:2281 msgid "Represents the C :c:type:`ssize_t` datatype." msgstr "" # 8ae5efa35f5a45018dd2d1d59859cdbf -#: ../src/Doc/library/ctypes.rst:2288 +#: library/ctypes.rst:2288 msgid "" "Represents the C :c:type:`unsigned char` datatype, it interprets the value " "as small integer. The constructor accepts an optional integer initializer; " @@ -21759,7 +21898,7 @@ msgid "" msgstr "" # ec410c97bc6c4fce9362a8dfc662e8ee -#: ../src/Doc/library/ctypes.rst:2295 +#: library/ctypes.rst:2295 msgid "" "Represents the C :c:type:`unsigned int` datatype. The constructor accepts " "an optional integer initializer; no overflow checking is done. On platforms " @@ -21767,63 +21906,63 @@ msgid "" msgstr "" # bae54dccffa3467eb01e52a81c5187f5 -#: ../src/Doc/library/ctypes.rst:2302 +#: library/ctypes.rst:2302 msgid "" "Represents the C 8-bit :c:type:`unsigned int` datatype. Usually an alias " "for :class:`c_ubyte`." msgstr "" # 04a6cc4ce8c240cda52e6c59f5d99c36 -#: ../src/Doc/library/ctypes.rst:2308 +#: library/ctypes.rst:2308 msgid "" "Represents the C 16-bit :c:type:`unsigned int` datatype. Usually an alias " "for :class:`c_ushort`." msgstr "" # 68c86e219a94475695c1b930ab08a3b0 -#: ../src/Doc/library/ctypes.rst:2314 +#: library/ctypes.rst:2314 msgid "" "Represents the C 32-bit :c:type:`unsigned int` datatype. Usually an alias " "for :class:`c_uint`." msgstr "" # b18f98dcb9f54f22b9258113a3069663 -#: ../src/Doc/library/ctypes.rst:2320 +#: library/ctypes.rst:2320 msgid "" "Represents the C 64-bit :c:type:`unsigned int` datatype. Usually an alias " "for :class:`c_ulonglong`." msgstr "" # 33aa36d65f0c4200b2929015e7aa6496 -#: ../src/Doc/library/ctypes.rst:2326 +#: library/ctypes.rst:2326 msgid "" "Represents the C :c:type:`unsigned long` datatype. The constructor accepts " "an optional integer initializer; no overflow checking is done." msgstr "" # 3cbf0ce114394299a4b4a371b81966bd -#: ../src/Doc/library/ctypes.rst:2332 +#: library/ctypes.rst:2332 msgid "" "Represents the C :c:type:`unsigned long long` datatype. The constructor " "accepts an optional integer initializer; no overflow checking is done." msgstr "" # 5030e8b6ee044befa505e49467b548d2 -#: ../src/Doc/library/ctypes.rst:2338 +#: library/ctypes.rst:2338 msgid "" "Represents the C :c:type:`unsigned short` datatype. The constructor accepts " "an optional integer initializer; no overflow checking is done." msgstr "" # 7893ba5992ff426cba6c3bc2977423f7 -#: ../src/Doc/library/ctypes.rst:2344 +#: library/ctypes.rst:2344 msgid "" "Represents the C :c:type:`void *` type. The value is represented as " "integer. The constructor accepts an optional integer initializer." msgstr "" # 13a76985def24ed9b285e53dfb834893 -#: ../src/Doc/library/ctypes.rst:2350 +#: library/ctypes.rst:2350 msgid "" "Represents the C :c:type:`wchar_t` datatype, and interprets the value as a " "single character unicode string. The constructor accepts an optional string " @@ -21831,7 +21970,7 @@ msgid "" msgstr "" # d011b87f8f78428ba666ddc235dc4046 -#: ../src/Doc/library/ctypes.rst:2357 +#: library/ctypes.rst:2357 msgid "" "Represents the C :c:type:`wchar_t *` datatype, which must be a pointer to a " "zero-terminated wide character string. The constructor accepts an integer " @@ -21839,7 +21978,7 @@ msgid "" msgstr "" # 000be3f74c0b420daf65d56429c8a159 -#: ../src/Doc/library/ctypes.rst:2364 +#: library/ctypes.rst:2364 msgid "" "Represent the C :c:type:`bool` datatype (more accurately, :c:type:`_Bool` " "from C99). Its value can be ``True`` or ``False``, and the constructor " @@ -21847,21 +21986,21 @@ msgid "" msgstr "" # faeb8895cc614c189c69e04edf2aeeaf -#: ../src/Doc/library/ctypes.rst:2373 +#: library/ctypes.rst:2373 msgid "" "Windows only: Represents a :c:type:`HRESULT` value, which contains success " "or error information for a function or method call." msgstr "" # d6acc250efb04d4b945662e2cb3fe606 -#: ../src/Doc/library/ctypes.rst:2379 +#: library/ctypes.rst:2379 msgid "" "Represents the C :c:type:`PyObject *` datatype. Calling this without an " "argument creates a ``NULL`` :c:type:`PyObject *` pointer." msgstr "" # c8732eb503f74d01b30614661e14aedd -#: ../src/Doc/library/ctypes.rst:2382 +#: library/ctypes.rst:2382 msgid "" "The :mod:`ctypes.wintypes` module provides quite some other Windows specific " "data types, for example :c:type:`HWND`, :c:type:`WPARAM`, or :c:type:" @@ -21869,33 +22008,33 @@ msgid "" "also defined." msgstr "" -#: ../src/Doc/library/ctypes.rst:2390 +#: library/ctypes.rst:2390 msgid "Structured data types" msgstr "" -#: ../src/Doc/library/ctypes.rst:2395 +#: library/ctypes.rst:2395 msgid "Abstract base class for unions in native byte order." msgstr "" -#: ../src/Doc/library/ctypes.rst:2400 +#: library/ctypes.rst:2400 msgid "Abstract base class for structures in *big endian* byte order." msgstr "" -#: ../src/Doc/library/ctypes.rst:2405 +#: library/ctypes.rst:2405 msgid "Abstract base class for structures in *little endian* byte order." msgstr "" -#: ../src/Doc/library/ctypes.rst:2407 +#: library/ctypes.rst:2407 msgid "" "Structures with non-native byte order cannot contain pointer type fields, or " "any other data types containing pointer type fields." msgstr "" -#: ../src/Doc/library/ctypes.rst:2413 +#: library/ctypes.rst:2413 msgid "Abstract base class for structures in *native* byte order." msgstr "" -#: ../src/Doc/library/ctypes.rst:2415 +#: library/ctypes.rst:2415 msgid "" "Concrete structure and union types must be created by subclassing one of " "these types, and at least define a :attr:`_fields_` class variable. :mod:" @@ -21903,27 +22042,27 @@ msgid "" "the fields by direct attribute accesses. These are the" msgstr "" -#: ../src/Doc/library/ctypes.rst:2423 +#: library/ctypes.rst:2423 msgid "" "A sequence defining the structure fields. The items must be 2-tuples or 3-" "tuples. The first item is the name of the field, the second item specifies " "the type of the field; it can be any ctypes data type." msgstr "" -#: ../src/Doc/library/ctypes.rst:2427 +#: library/ctypes.rst:2427 msgid "" "For integer type fields like :class:`c_int`, a third optional item can be " "given. It must be a small positive integer defining the bit width of the " "field." msgstr "" -#: ../src/Doc/library/ctypes.rst:2431 +#: library/ctypes.rst:2431 msgid "" "Field names must be unique within one structure or union. This is not " "checked, only one field can be accessed when names are repeated." msgstr "" -#: ../src/Doc/library/ctypes.rst:2434 +#: library/ctypes.rst:2434 msgid "" "It is possible to define the :attr:`_fields_` class variable *after* the " "class statement that defines the Structure subclass, this allows to create " @@ -21931,7 +22070,7 @@ msgid "" msgstr "" # ac78754ff76f455294bf39a8308d0fd1 -#: ../src/Doc/library/ctypes.rst:2444 +#: library/ctypes.rst:2444 msgid "" "The :attr:`_fields_` class variable must, however, be defined before the " "type is first used (an instance is created, ``sizeof()`` is called on it, " @@ -21939,28 +22078,28 @@ msgid "" "raise an AttributeError." msgstr "" -#: ../src/Doc/library/ctypes.rst:2449 +#: library/ctypes.rst:2449 msgid "" "It is possible to defined sub-subclasses of structure types, they inherit " "the fields of the base class plus the :attr:`_fields_` defined in the sub-" "subclass, if any." msgstr "" -#: ../src/Doc/library/ctypes.rst:2456 +#: library/ctypes.rst:2456 msgid "" "An optional small integer that allows to override the alignment of structure " "fields in the instance. :attr:`_pack_` must already be defined when :attr:" "`_fields_` is assigned, otherwise it will have no effect." msgstr "" -#: ../src/Doc/library/ctypes.rst:2463 +#: library/ctypes.rst:2463 msgid "" "An optional sequence that lists the names of unnamed (anonymous) fields. :" "attr:`_anonymous_` must be already defined when :attr:`_fields_` is " "assigned, otherwise it will have no effect." msgstr "" -#: ../src/Doc/library/ctypes.rst:2467 +#: library/ctypes.rst:2467 msgid "" "The fields listed in this variable must be structure or union type fields. :" "mod:`ctypes` will create descriptors in the structure type that allows to " @@ -21968,11 +22107,11 @@ msgid "" "or union field." msgstr "" -#: ../src/Doc/library/ctypes.rst:2472 +#: library/ctypes.rst:2472 msgid "Here is an example type (Windows)::" msgstr "" -#: ../src/Doc/library/ctypes.rst:2485 +#: library/ctypes.rst:2485 msgid "" "The ``TYPEDESC`` structure describes a COM data type, the ``vt`` field " "specifies which one of the union fields is valid. Since the ``u`` field is " @@ -21982,7 +22121,7 @@ msgid "" "temporary union instance::" msgstr "" -#: ../src/Doc/library/ctypes.rst:2497 +#: library/ctypes.rst:2497 msgid "" "It is possible to defined sub-subclasses of structures, they inherit the " "fields of the base class. If the subclass definition has a separate :attr:" @@ -21990,7 +22129,7 @@ msgid "" "of the base class." msgstr "" -#: ../src/Doc/library/ctypes.rst:2502 +#: library/ctypes.rst:2502 msgid "" "Structure and union constructors accept both positional and keyword " "arguments. Positional arguments are used to initialize member fields in the " @@ -22000,27 +22139,31 @@ msgid "" "names not present in :attr:`_fields_`." msgstr "" -#: ../src/Doc/library/ctypes.rst:2513 +#: library/ctypes.rst:2513 msgid "Arrays and pointers" msgstr "" -#: ../src/Doc/library/ctypes.rst:2515 +#: library/ctypes.rst:2515 msgid "" "Not yet written - please see the sections :ref:`ctypes-pointers` and " "section :ref:`ctypes-arrays` in the tutorial." msgstr "" -#: ../src/Doc/library/curses.rst:2 +#: library/curses.rst:2 msgid ":mod:`curses` --- Terminal handling for character-cell displays" msgstr "" -#: ../src/Doc/library/curses.rst:14 +#: library/curses.rst:11 +msgid "Added support for the ``ncurses`` library and converted to a package." +msgstr "" + +#: library/curses.rst:14 msgid "" "The :mod:`curses` module provides an interface to the curses library, the de-" "facto standard for portable advanced terminal handling." msgstr "" -#: ../src/Doc/library/curses.rst:17 +#: library/curses.rst:17 msgid "" "While curses is most widely used in the Unix environment, versions are " "available for DOS, OS/2, and possibly other systems as well. This extension " @@ -22028,7 +22171,7 @@ msgid "" "library hosted on Linux and the BSD variants of Unix." msgstr "" -#: ../src/Doc/library/curses.rst:24 +#: library/curses.rst:24 msgid "" "Since version 5.4, the ncurses library decides how to interpret non-ASCII " "data using the ``nl_langinfo`` function. That means that you have to call :" @@ -22037,81 +22180,77 @@ msgid "" "default encoding::" msgstr "" -#: ../src/Doc/library/curses.rst:34 +#: library/curses.rst:34 msgid "Then use *code* as the encoding for :meth:`str.encode` calls." msgstr "" -# b601f7543ed74950a3a58e09ecd21df1 -#: ../src/Doc/library/curses.rst:38 -msgid "Module :mod:`curses.ascii`" +#: library/curses.rst:39 +msgid "Module curses.ascii" msgstr "" -#: ../src/Doc/library/curses.rst:39 +#: library/curses.rst:39 msgid "" "Utilities for working with ASCII characters, regardless of your locale " "settings." msgstr "" -# 123fc8d7598f42ebb571e3706b2beb2d -#: ../src/Doc/library/curses.rst:41 -msgid "Module :mod:`curses.panel`" +#: library/curses.rst:42 +msgid "Module curses.panel" msgstr "" -#: ../src/Doc/library/curses.rst:42 +#: library/curses.rst:42 msgid "A panel stack extension that adds depth to curses windows." msgstr "" -# b5a338de60ad47a9ba9d32776546601b -#: ../src/Doc/library/curses.rst:44 -msgid "Module :mod:`curses.textpad`" +#: library/curses.rst:45 +msgid "Module curses.textpad" msgstr "" -#: ../src/Doc/library/curses.rst:45 +#: library/curses.rst:45 msgid "" "Editable text widget for curses supporting :program:`Emacs`\\ -like " "bindings." msgstr "" -# b52992b8e3ae479db3be7707e2574b9f -#: ../src/Doc/library/curses.rst:48 -msgid ":ref:`curses-howto`" +#: library/curses.rst:49 +msgid "curses-howto" msgstr "" -#: ../src/Doc/library/curses.rst:48 +#: library/curses.rst:48 msgid "" "Tutorial material on using curses with Python, by Andrew Kuchling and Eric " "Raymond." msgstr "" # 63dc553710fa45d595ef89e7f6ac4aa7 -#: ../src/Doc/library/curses.rst:51 +#: library/curses.rst:51 msgid "" "The :source:`Demo/curses/` directory in the Python source distribution " "contains some example programs using the curses bindings provided by this " "module." msgstr "" -#: ../src/Doc/library/curses.rst:60 +#: library/curses.rst:60 msgid "The module :mod:`curses` defines the following exception:" msgstr "" -#: ../src/Doc/library/curses.rst:65 +#: library/curses.rst:65 msgid "Exception raised when a curses library function returns an error." msgstr "" -#: ../src/Doc/library/curses.rst:69 +#: library/curses.rst:69 msgid "" "Whenever *x* or *y* arguments to a function or a method are optional, they " "default to the current cursor location. Whenever *attr* is optional, it " "defaults to :const:`A_NORMAL`." msgstr "" -#: ../src/Doc/library/curses.rst:73 +#: library/curses.rst:73 msgid "The module :mod:`curses` defines the following functions:" msgstr "" # 41a3910c363947738f78956c395f93be -#: ../src/Doc/library/curses.rst:78 +#: library/curses.rst:78 msgid "" "Return the output speed of the terminal in bits per second. On software " "terminal emulators it will have a fixed high value. Included for historical " @@ -22119,18 +22258,18 @@ msgid "" "and occasionally to change interfaces depending on the line speed." msgstr "" -#: ../src/Doc/library/curses.rst:86 +#: library/curses.rst:86 msgid "Emit a short attention sound." msgstr "" # 01427d674ee845aeab99f2058097850d -#: ../src/Doc/library/curses.rst:91 +#: library/curses.rst:91 msgid "" "Return ``True`` or ``False``, depending on whether the programmer can change " "the colors displayed by the terminal." msgstr "" -#: ../src/Doc/library/curses.rst:97 +#: library/curses.rst:97 msgid "" "Enter cbreak mode. In cbreak mode (sometimes called \"rare\" mode) normal " "tty line buffering is turned off and characters are available to be read one " @@ -22141,7 +22280,7 @@ msgid "" msgstr "" # a7357433a12a4efb83973d86f44b0fb0 -#: ../src/Doc/library/curses.rst:106 +#: library/curses.rst:106 msgid "" "Return the intensity of the red, green, and blue (RGB) components in the " "color *color_number*, which must be between ``0`` and :const:`COLORS`. A 3-" @@ -22151,7 +22290,7 @@ msgid "" msgstr "" # 63b535a16b62403db69e77f0de9890a8 -#: ../src/Doc/library/curses.rst:114 +#: library/curses.rst:114 msgid "" "Return the attribute value for displaying text in the specified color. This " "attribute value can be combined with :const:`A_STANDOUT`, :const:" @@ -22160,7 +22299,7 @@ msgid "" msgstr "" # 8410098149974c7e819eaf9e866868f4 -#: ../src/Doc/library/curses.rst:122 +#: library/curses.rst:122 msgid "" "Set the cursor state. *visibility* can be set to 0, 1, or 2, for invisible, " "normal, or very visible. If the terminal supports the visibility requested, " @@ -22170,7 +22309,7 @@ msgid "" msgstr "" # b0fd651735924a06971730a246ccfd7a -#: ../src/Doc/library/curses.rst:131 +#: library/curses.rst:131 msgid "" "Save the current terminal mode as the \"program\" mode, the mode when the " "running program is using curses. (Its counterpart is the \"shell\" mode, " @@ -22179,7 +22318,7 @@ msgid "" msgstr "" # 853cff1d6b83466495e52449f6e018c2 -#: ../src/Doc/library/curses.rst:139 +#: library/curses.rst:139 msgid "" "Save the current terminal mode as the \"shell\" mode, the mode when the " "running program is not using curses. (Its counterpart is the \"program\" " @@ -22188,11 +22327,11 @@ msgid "" msgstr "" # 80d98c2baef048ce8801fd0f1122d23d -#: ../src/Doc/library/curses.rst:147 +#: library/curses.rst:147 msgid "Insert an *ms* millisecond pause in output." msgstr "" -#: ../src/Doc/library/curses.rst:152 +#: library/curses.rst:152 msgid "" "Update the physical screen. The curses library keeps two data structures, " "one representing the current physical screen contents and a virtual screen " @@ -22200,7 +22339,7 @@ msgid "" "the physical screen to match the virtual screen." msgstr "" -#: ../src/Doc/library/curses.rst:157 +#: library/curses.rst:157 msgid "" "The virtual screen may be updated by a :meth:`noutrefresh` call after write " "operations such as :meth:`addstr` have been performed on a window. The " @@ -22210,18 +22349,18 @@ msgid "" "calls on all windows, followed by a single :func:`doupdate`." msgstr "" -#: ../src/Doc/library/curses.rst:167 +#: library/curses.rst:167 msgid "" "Enter echo mode. In echo mode, each character input is echoed to the screen " "as it is entered." msgstr "" -#: ../src/Doc/library/curses.rst:173 +#: library/curses.rst:173 msgid "De-initialize the library, and return terminal to normal status." msgstr "" # 944fa4b161d340e6a6fc270f0fb8439a -#: ../src/Doc/library/curses.rst:178 +#: library/curses.rst:178 msgid "" "Return the user's current erase character. Under Unix operating systems " "this is a property of the controlling tty of the curses program, and is not " @@ -22229,7 +22368,7 @@ msgid "" msgstr "" # fdba43186fb74a34abc090cc08017f5a -#: ../src/Doc/library/curses.rst:185 +#: library/curses.rst:185 msgid "" "The :func:`.filter` routine, if used, must be called before :func:`initscr` " "is called. The effect is that, during those calls, :envvar:`LINES` is set " @@ -22240,21 +22379,21 @@ msgid "" "rest of the screen." msgstr "" -#: ../src/Doc/library/curses.rst:195 +#: library/curses.rst:195 msgid "" "Flash the screen. That is, change it to reverse-video and then change it " "back in a short interval. Some people prefer such as 'visible bell' to the " "audible attention signal produced by :func:`beep`." msgstr "" -#: ../src/Doc/library/curses.rst:202 +#: library/curses.rst:202 msgid "" "Flush all input buffers. This throws away any typeahead that has been " "typed by the user and has not yet been processed by the program." msgstr "" # 6039eefb89cf4533a7308527b898cc43 -#: ../src/Doc/library/curses.rst:208 +#: library/curses.rst:208 msgid "" "After :meth:`getch` returns :const:`KEY_MOUSE` to signal a mouse event, this " "method should be call to retrieve the queued mouse event, represented as a 5-" @@ -22269,14 +22408,14 @@ msgid "" msgstr "" # 83751e8fd4de4a12bf94b1cbba1d5a9d -#: ../src/Doc/library/curses.rst:222 +#: library/curses.rst:222 msgid "" "Return the current coordinates of the virtual screen cursor in y and x. If " "leaveok is currently true, then -1,-1 is returned." msgstr "" # 5a6475cce4324fc4b1dad566a5bd9e82 -#: ../src/Doc/library/curses.rst:228 +#: library/curses.rst:228 msgid "" "Read window related data stored in the file by an earlier :func:`putwin` " "call. The routine then creates and initializes a new window using that data, " @@ -22284,14 +22423,14 @@ msgid "" msgstr "" # 82debcc5528d45d7844173109c6964db -#: ../src/Doc/library/curses.rst:235 +#: library/curses.rst:235 msgid "" "Return ``True`` if the terminal can display colors; otherwise, return " "``False``." msgstr "" # 357e421386aa4a2ea1d095f8d5172d6f -#: ../src/Doc/library/curses.rst:240 +#: library/curses.rst:240 msgid "" "Return ``True`` if the terminal has insert- and delete-character " "capabilities. This function is included for historical reasons only, as all " @@ -22299,7 +22438,7 @@ msgid "" msgstr "" # 1acd7f3df63f48c8b2221d30bde2ab57 -#: ../src/Doc/library/curses.rst:247 +#: library/curses.rst:247 msgid "" "Return ``True`` if the terminal has insert- and delete-line capabilities, or " "can simulate them using scrolling regions. This function is included for " @@ -22308,14 +22447,14 @@ msgid "" msgstr "" # 5ae6c998d572423db543e956d9b634d6 -#: ../src/Doc/library/curses.rst:255 +#: library/curses.rst:255 msgid "" "Take a key value *ch*, and return ``True`` if the current terminal type " "recognizes a key with that value." msgstr "" # e192bb5e0009430aa4808b7aa291dbc2 -#: ../src/Doc/library/curses.rst:261 +#: library/curses.rst:261 msgid "" "Used for half-delay mode, which is similar to cbreak mode in that characters " "typed by the user are immediately available to the program. However, after " @@ -22325,7 +22464,7 @@ msgid "" msgstr "" # ca2972a3cae34eaeb6b7f1828a05ac08 -#: ../src/Doc/library/curses.rst:270 +#: library/curses.rst:270 msgid "" "Change the definition of a color, taking the number of the color to be " "changed followed by three RGB values (for the amounts of red, green, and " @@ -22338,7 +22477,7 @@ msgid "" msgstr "" # f88e5a27d65848c092a64fc053b8cfdf -#: ../src/Doc/library/curses.rst:281 +#: library/curses.rst:281 msgid "" "Change the definition of a color-pair. It takes three arguments: the number " "of the color-pair to be changed, the foreground color number, and the " @@ -22351,33 +22490,33 @@ msgid "" msgstr "" # 36d965f38f99474486979d0aca356737 -#: ../src/Doc/library/curses.rst:293 +#: library/curses.rst:293 msgid "" "Initialize the library. Return a :class:`WindowObject` which represents the " "whole screen." msgstr "" -#: ../src/Doc/library/curses.rst:298 +#: library/curses.rst:298 msgid "" "If there is an error opening the terminal, the underlying curses library may " "cause the interpreter to exit." msgstr "" # bb157b237fdb4598b14415fc28d07d94 -#: ../src/Doc/library/curses.rst:304 +#: library/curses.rst:304 msgid "" "Return ``True`` if :func:`resize_term` would modify the window structure, " "``False`` otherwise." msgstr "" # 55d5ca40d7d446af8ceaa3902d2842d8 -#: ../src/Doc/library/curses.rst:310 +#: library/curses.rst:310 msgid "" "Return ``True`` if :func:`endwin` has been called (that is, the curses " "library has been deinitialized)." msgstr "" -#: ../src/Doc/library/curses.rst:316 +#: library/curses.rst:316 msgid "" "Return the name of the key numbered *k*. The name of a key generating " "printable ASCII character is the key's character. The name of a control-key " @@ -22388,7 +22527,7 @@ msgid "" msgstr "" # b73fbe16781f48cb82015af118d66290 -#: ../src/Doc/library/curses.rst:326 +#: library/curses.rst:326 msgid "" "Return the user's current line kill character. Under Unix operating systems " "this is a property of the controlling tty of the curses program, and is not " @@ -22396,21 +22535,21 @@ msgid "" msgstr "" # 6fde6dc03dd74900b2c2f54a4d527ee1 -#: ../src/Doc/library/curses.rst:333 +#: library/curses.rst:333 msgid "" "Return a string containing the terminfo long name field describing the " "current terminal. The maximum length of a verbose description is 128 " "characters. It is defined only after the call to :func:`initscr`." msgstr "" -#: ../src/Doc/library/curses.rst:340 +#: library/curses.rst:340 msgid "" "If *yes* is 1, allow 8-bit characters to be input. If *yes* is 0, allow " "only 7-bit chars." msgstr "" # 8ef1a779e47340b09b4139705db94e61 -#: ../src/Doc/library/curses.rst:346 +#: library/curses.rst:346 msgid "" "Set the maximum time in milliseconds that can elapse between press and " "release events in order for them to be recognized as a click, and return the " @@ -22419,7 +22558,7 @@ msgid "" msgstr "" # 0e942a968b2243168c3a650c546d7d33 -#: ../src/Doc/library/curses.rst:353 +#: library/curses.rst:353 msgid "" "Set the mouse events to be reported, and return a tuple ``(availmask, " "oldmask)``. *availmask* indicates which of the specified mouse events can " @@ -22428,19 +22567,19 @@ msgid "" "called, no mouse events are ever reported." msgstr "" -#: ../src/Doc/library/curses.rst:362 +#: library/curses.rst:362 msgid "Sleep for *ms* milliseconds." msgstr "" # 837a4baee51a4e279efef44e101473cf -#: ../src/Doc/library/curses.rst:367 +#: library/curses.rst:367 msgid "" "Create and return a pointer to a new pad data structure with the given " "number of lines and columns. A pad is returned as a window object." msgstr "" # a9b5d2dbe05c4eba8f26b978218ec0ac -#: ../src/Doc/library/curses.rst:370 +#: library/curses.rst:370 msgid "" "A pad is like a window, except that it is not restricted by the screen size, " "and is not necessarily associated with a particular part of the screen. " @@ -22455,35 +22594,35 @@ msgid "" "clipping box on the screen within which the pad region is to be displayed." msgstr "" -#: ../src/Doc/library/curses.rst:386 +#: library/curses.rst:386 msgid "" "Return a new window, whose left-upper corner is at ``(begin_y, begin_x)``, " "and whose height/width is *nlines*/*ncols*." msgstr "" -#: ../src/Doc/library/curses.rst:389 +#: library/curses.rst:389 msgid "" "By default, the window will extend from the specified position to the lower " "right corner of the screen." msgstr "" -#: ../src/Doc/library/curses.rst:395 +#: library/curses.rst:395 msgid "" "Enter newline mode. This mode translates the return key into newline on " "input, and translates newline into return and line-feed on output. Newline " "mode is initially on." msgstr "" -#: ../src/Doc/library/curses.rst:402 +#: library/curses.rst:402 msgid "" "Leave cbreak mode. Return to normal \"cooked\" mode with line buffering." msgstr "" -#: ../src/Doc/library/curses.rst:407 +#: library/curses.rst:407 msgid "Leave echo mode. Echoing of input characters is turned off." msgstr "" -#: ../src/Doc/library/curses.rst:412 +#: library/curses.rst:412 msgid "" "Leave newline mode. Disable translation of return into newline on input, " "and disable low-level translation of newline into newline/return on output " @@ -22494,7 +22633,7 @@ msgid "" msgstr "" # d4b54d6b3969464db0b848e441a011b7 -#: ../src/Doc/library/curses.rst:422 +#: library/curses.rst:422 msgid "" "When the :func:`noqiflush` routine is used, normal flush of input and output " "queues associated with the INTR, QUIT and SUSP characters will not be done. " @@ -22503,12 +22642,12 @@ msgid "" "handler exits." msgstr "" -#: ../src/Doc/library/curses.rst:430 +#: library/curses.rst:430 msgid "Leave raw mode. Return to normal \"cooked\" mode with line buffering." msgstr "" # c18c97b175c84d9598d5a0668bfb1478 -#: ../src/Doc/library/curses.rst:435 +#: library/curses.rst:435 msgid "" "Return a tuple ``(fg, bg)`` containing the colors for the requested color " "pair. The value of *pair_number* must be between ``1`` and ``COLOR_PAIRS - " @@ -22516,14 +22655,14 @@ msgid "" msgstr "" # 39e40423beaa4fe4963b359cdb2f4e55 -#: ../src/Doc/library/curses.rst:441 +#: library/curses.rst:441 msgid "" "Return the number of the color-pair set by the attribute value *attr*. :func:" "`color_pair` is the counterpart to this function." msgstr "" # aaa45d8705454eb480514adb76a73ab1 -#: ../src/Doc/library/curses.rst:447 +#: library/curses.rst:447 msgid "" "Equivalent to ``tputs(str, 1, putchar)``; emit the value of a specified " "terminfo capability for the current terminal. Note that the output of :func:" @@ -22531,14 +22670,14 @@ msgid "" msgstr "" # 0c1a84b2f5bc4a3fa6b42c519426718a -#: ../src/Doc/library/curses.rst:454 +#: library/curses.rst:454 msgid "" "If *flag* is ``False``, the effect is the same as calling :func:`noqiflush`. " "If *flag* is ``True``, or no argument is provided, the queues will be " "flushed when these control characters are read." msgstr "" -#: ../src/Doc/library/curses.rst:461 +#: library/curses.rst:461 msgid "" "Enter raw mode. In raw mode, normal line buffering and processing of " "interrupt, quit, suspend, and flow control keys are turned off; characters " @@ -22546,28 +22685,28 @@ msgid "" msgstr "" # 05be56ee8899441ea782f2836338ea06 -#: ../src/Doc/library/curses.rst:468 +#: library/curses.rst:468 msgid "" "Restore the terminal to \"program\" mode, as previously saved by :func:" "`def_prog_mode`." msgstr "" # ce8064cb521c4081af3c9b0cbffff129 -#: ../src/Doc/library/curses.rst:474 +#: library/curses.rst:474 msgid "" "Restore the terminal to \"shell\" mode, as previously saved by :func:" "`def_shell_mode`." msgstr "" # ba466081e5124b81b4f2bdeb2948da83 -#: ../src/Doc/library/curses.rst:480 +#: library/curses.rst:480 msgid "" "Restore the state of the terminal modes to what it was at the last call to :" "func:`savetty`." msgstr "" # c4594ca5b6ac4b1e8f4105693b4a4896 -#: ../src/Doc/library/curses.rst:486 +#: library/curses.rst:486 msgid "" "Backend function used by :func:`resizeterm`, performing most of the work; " "when resizing the windows, :func:`resize_term` blank-fills the areas that " @@ -22578,7 +22717,7 @@ msgid "" msgstr "" # 9d459480ca214df48935f33c285cd799 -#: ../src/Doc/library/curses.rst:496 +#: library/curses.rst:496 msgid "" "Resize the standard and current windows to the specified dimensions, and " "adjusts other bookkeeping data used by the curses library that record the " @@ -22586,21 +22725,21 @@ msgid "" msgstr "" # 313236339bfb49cdbe343ab13a4935bd -#: ../src/Doc/library/curses.rst:503 +#: library/curses.rst:503 msgid "" "Save the current state of the terminal modes in a buffer, usable by :func:" "`resetty`." msgstr "" # cd83bfaca9a64486aa8f89c92d9777d6 -#: ../src/Doc/library/curses.rst:509 +#: library/curses.rst:509 msgid "" "Set the virtual screen cursor to *y*, *x*. If *y* and *x* are both -1, then " "leaveok is set." msgstr "" # 4b50574b98c14ed39947829a5fcd768b -#: ../src/Doc/library/curses.rst:515 +#: library/curses.rst:515 msgid "" "Initialize the terminal. *termstr* is a string giving the terminal name; if " "omitted, the value of the :envvar:`TERM` environment variable will be used. " @@ -22608,14 +22747,14 @@ msgid "" "sent; if not supplied, the file descriptor for ``sys.stdout`` will be used." msgstr "" -#: ../src/Doc/library/curses.rst:523 +#: library/curses.rst:523 msgid "" "Must be called if the programmer wants to use colors, and before any other " "color manipulation routine is called. It is good practice to call this " "routine right after :func:`initscr`." msgstr "" -#: ../src/Doc/library/curses.rst:527 +#: library/curses.rst:527 msgid "" ":func:`start_color` initializes eight basic colors (black, red, green, " "yellow, blue, magenta, cyan, and white), and two global variables in the :" @@ -22626,7 +22765,7 @@ msgid "" msgstr "" # 4855d7d0299143b991685a663b4bcdef -#: ../src/Doc/library/curses.rst:536 +#: library/curses.rst:536 msgid "" "Return a logical OR of all video attributes supported by the terminal. This " "information is useful when a curses program needs complete control over the " @@ -22634,14 +22773,14 @@ msgid "" msgstr "" # 6302b10bd1054d409ba696ac8cc6d191 -#: ../src/Doc/library/curses.rst:543 +#: library/curses.rst:543 msgid "" "Return the value of the environment variable :envvar:`TERM`, truncated to 14 " "characters." msgstr "" # 3e43bcbf3fd54e7d915aee3ab32fd77c -#: ../src/Doc/library/curses.rst:548 +#: library/curses.rst:548 msgid "" "Return the value of the Boolean capability corresponding to the terminfo " "capability name *capname*. The value ``-1`` is returned if *capname* is not " @@ -22650,7 +22789,7 @@ msgid "" msgstr "" # b80bf8c959cf46fb85797cf293575d33 -#: ../src/Doc/library/curses.rst:556 +#: library/curses.rst:556 msgid "" "Return the value of the numeric capability corresponding to the terminfo " "capability name *capname*. The value ``-2`` is returned if *capname* is not " @@ -22659,7 +22798,7 @@ msgid "" msgstr "" # 860f4c7a4f184cbb8ea06ec7a1489f83 -#: ../src/Doc/library/curses.rst:564 +#: library/curses.rst:564 msgid "" "Return the value of the string capability corresponding to the terminfo " "capability name *capname*. ``None`` is returned if *capname* is not a " @@ -22667,7 +22806,7 @@ msgid "" msgstr "" # 6786cb97236e49d48a13c05c74ddfb99 -#: ../src/Doc/library/curses.rst:571 +#: library/curses.rst:571 msgid "" "Instantiate the string *str* with the supplied parameters, where *str* " "should be a parameterized string obtained from the terminfo database. E.g. " @@ -22676,13 +22815,13 @@ msgid "" msgstr "" # a459847d34ac489487b65610264a429a -#: ../src/Doc/library/curses.rst:579 +#: library/curses.rst:579 msgid "" "Specify that the file descriptor *fd* be used for typeahead checking. If " "*fd* is ``-1``, then no typeahead checking is done." msgstr "" -#: ../src/Doc/library/curses.rst:582 +#: library/curses.rst:582 msgid "" "The curses library does \"line-breakout optimization\" by looking for " "typeahead periodically while updating the screen. If input is found, and it " @@ -22693,29 +22832,29 @@ msgid "" msgstr "" # df358966127d4570ab8e67e8358e3a18 -#: ../src/Doc/library/curses.rst:591 +#: library/curses.rst:591 msgid "" "Return a string which is a printable representation of the character *ch*. " "Control characters are displayed as a caret followed by the character, for " "example as ``^C``. Printing characters are left as they are." msgstr "" -#: ../src/Doc/library/curses.rst:598 +#: library/curses.rst:598 msgid "Push *ch* so the next :meth:`getch` will return it." msgstr "" -#: ../src/Doc/library/curses.rst:602 +#: library/curses.rst:602 msgid "Only one *ch* can be pushed before :meth:`getch` is called." msgstr "" -#: ../src/Doc/library/curses.rst:607 +#: library/curses.rst:607 msgid "" "Push a :const:`KEY_MOUSE` event onto the input queue, associating the given " "state data with it." msgstr "" # 4244a011d7d040eea8a2231225e81332 -#: ../src/Doc/library/curses.rst:613 +#: library/curses.rst:613 msgid "" "If used, this function should be called before :func:`initscr` or newterm " "are called. When *flag* is ``False``, the values of lines and columns " @@ -22725,7 +22864,7 @@ msgid "" "to use the window size if :envvar:`LINES` and :envvar:`COLUMNS` are not set)." msgstr "" -#: ../src/Doc/library/curses.rst:623 +#: library/curses.rst:623 msgid "" "Allow use of default values for colors on terminals supporting this feature. " "Use this to support transparency in your application. The default color is " @@ -22735,7 +22874,7 @@ msgid "" msgstr "" # 7795648712e14562bba63922afd878b0 -#: ../src/Doc/library/curses.rst:632 +#: library/curses.rst:632 msgid "" "Initialize curses and call another callable object, *func*, which should be " "the rest of your curses-using application. If the application raises an " @@ -22749,18 +22888,18 @@ msgid "" "echo, and disables the terminal keypad." msgstr "" -#: ../src/Doc/library/curses.rst:646 ../src/Doc/library/framework.rst:202 +#: library/curses.rst:646 library/framework.rst:202 msgid "Window Objects" msgstr "" -#: ../src/Doc/library/curses.rst:648 +#: library/curses.rst:648 msgid "" "Window objects, as returned by :func:`initscr` and :func:`newwin` above, " "have the following methods:" msgstr "" # 41e432c3764c4a45aa4a3e97cdfbbbf3 -#: ../src/Doc/library/curses.rst:657 +#: library/curses.rst:657 msgid "" "A *character* means a C character (an ASCII code), rather than a Python " "character (a string of length 1). (This note is true whenever the " @@ -22768,65 +22907,65 @@ msgid "" "conveying strings to codes." msgstr "" -#: ../src/Doc/library/curses.rst:662 +#: library/curses.rst:662 msgid "" "Paint character *ch* at ``(y, x)`` with attributes *attr*, overwriting any " "character previously painter at that location. By default, the character " "position and attributes are the current settings for the window object." msgstr "" -#: ../src/Doc/library/curses.rst:670 +#: library/curses.rst:670 msgid "" "Paint at most *n* characters of the string *str* at ``(y, x)`` with " "attributes *attr*, overwriting anything previously on the display." msgstr "" -#: ../src/Doc/library/curses.rst:677 +#: library/curses.rst:677 msgid "" "Paint the string *str* at ``(y, x)`` with attributes *attr*, overwriting " "anything previously on the display." msgstr "" -#: ../src/Doc/library/curses.rst:683 +#: library/curses.rst:683 msgid "" "Remove attribute *attr* from the \"background\" set applied to all writes to " "the current window." msgstr "" -#: ../src/Doc/library/curses.rst:689 +#: library/curses.rst:689 msgid "" "Add attribute *attr* from the \"background\" set applied to all writes to " "the current window." msgstr "" -#: ../src/Doc/library/curses.rst:695 +#: library/curses.rst:695 msgid "" "Set the \"background\" set of attributes to *attr*. This set is initially 0 " "(no attributes)." msgstr "" # 49645c8f0c254dc5b251766ad641078c -#: ../src/Doc/library/curses.rst:701 +#: library/curses.rst:701 msgid "" "Set the background property of the window to the character *ch*, with " "attributes *attr*. The change is then applied to every character position " "in that window:" msgstr "" -#: ../src/Doc/library/curses.rst:705 +#: library/curses.rst:705 msgid "" "The attribute of every character in the window is changed to the new " "background attribute." msgstr "" -#: ../src/Doc/library/curses.rst:708 +#: library/curses.rst:708 msgid "" "Wherever the former background character appears, it is changed to the new " "background character." msgstr "" # 29bd500c35314b738959558c281ccdff -#: ../src/Doc/library/curses.rst:714 +#: library/curses.rst:714 msgid "" "Set the window's background. A window's background consists of a character " "and any combination of attributes. The attribute part of the background is " @@ -22837,7 +22976,7 @@ msgid "" "delete line/character operations." msgstr "" -#: ../src/Doc/library/curses.rst:724 +#: library/curses.rst:724 msgid "" "Draw a border around the edges of the window. Each parameter specifies the " "character to use for a specific part of the border; see the table below for " @@ -22845,111 +22984,111 @@ msgid "" "character strings." msgstr "" -#: ../src/Doc/library/curses.rst:731 +#: library/curses.rst:731 msgid "" "A ``0`` value for any parameter will cause the default character to be used " "for that parameter. Keyword parameters can *not* be used. The defaults are " "listed in this table:" msgstr "" -#: ../src/Doc/library/curses.rst:736 +#: library/curses.rst:736 msgid "Parameter" msgstr "" -#: ../src/Doc/library/curses.rst:736 +#: library/curses.rst:736 msgid "Default value" msgstr "Valeur par défaut" -#: ../src/Doc/library/curses.rst:738 +#: library/curses.rst:738 msgid "*ls*" msgstr "" -#: ../src/Doc/library/curses.rst:738 +#: library/curses.rst:738 msgid "Left side" msgstr "" -#: ../src/Doc/library/curses.rst:738 ../src/Doc/library/curses.rst:740 +#: library/curses.rst:738 library/curses.rst:740 msgid ":const:`ACS_VLINE`" msgstr "" -#: ../src/Doc/library/curses.rst:740 +#: library/curses.rst:740 msgid "*rs*" msgstr "" -#: ../src/Doc/library/curses.rst:740 +#: library/curses.rst:740 msgid "Right side" msgstr "" -#: ../src/Doc/library/curses.rst:742 +#: library/curses.rst:742 msgid "*ts*" msgstr "" -#: ../src/Doc/library/curses.rst:742 +#: library/curses.rst:742 msgid "Top" msgstr "" -#: ../src/Doc/library/curses.rst:742 ../src/Doc/library/curses.rst:744 +#: library/curses.rst:742 library/curses.rst:744 msgid ":const:`ACS_HLINE`" msgstr "" -#: ../src/Doc/library/curses.rst:744 +#: library/curses.rst:744 msgid "*bs*" msgstr "" -#: ../src/Doc/library/curses.rst:744 +#: library/curses.rst:744 msgid "Bottom" msgstr "" -#: ../src/Doc/library/curses.rst:746 +#: library/curses.rst:746 msgid "*tl*" msgstr "" -#: ../src/Doc/library/curses.rst:746 +#: library/curses.rst:746 msgid "Upper-left corner" msgstr "" -#: ../src/Doc/library/curses.rst:746 +#: library/curses.rst:746 msgid ":const:`ACS_ULCORNER`" msgstr "" -#: ../src/Doc/library/curses.rst:748 +#: library/curses.rst:748 msgid "*tr*" msgstr "" -#: ../src/Doc/library/curses.rst:748 +#: library/curses.rst:748 msgid "Upper-right corner" msgstr "" -#: ../src/Doc/library/curses.rst:748 +#: library/curses.rst:748 msgid ":const:`ACS_URCORNER`" msgstr "" -#: ../src/Doc/library/curses.rst:750 +#: library/curses.rst:750 msgid "*bl*" msgstr "" -#: ../src/Doc/library/curses.rst:750 +#: library/curses.rst:750 msgid "Bottom-left corner" msgstr "" -#: ../src/Doc/library/curses.rst:750 +#: library/curses.rst:750 msgid ":const:`ACS_LLCORNER`" msgstr "" -#: ../src/Doc/library/curses.rst:752 +#: library/curses.rst:752 msgid "*br*" msgstr "" -#: ../src/Doc/library/curses.rst:752 +#: library/curses.rst:752 msgid "Bottom-right corner" msgstr "" -#: ../src/Doc/library/curses.rst:752 +#: library/curses.rst:752 msgid ":const:`ACS_LRCORNER`" msgstr "" # 2f6c53f8b4e349d69b4e02c948d095a4 -#: ../src/Doc/library/curses.rst:758 +#: library/curses.rst:758 msgid "" "Similar to :meth:`border`, but both *ls* and *rs* are *vertch* and both *ts* " "and *bs* are *horch*. The default corner characters are always used by this " @@ -22957,7 +23096,7 @@ msgid "" msgstr "" # 5d120fdb20bd4b9598d1b768bcb45250 -#: ../src/Doc/library/curses.rst:767 +#: library/curses.rst:767 msgid "" "Set the attributes of *num* characters at the current cursor position, or at " "position ``(y, x)`` if supplied. If no value of *num* is given or *num* = " @@ -22968,48 +23107,48 @@ msgid "" msgstr "" # 48d95aeef0c4494cbf9821a596e89586 -#: ../src/Doc/library/curses.rst:777 +#: library/curses.rst:777 msgid "" "Like :meth:`erase`, but also cause the whole window to be repainted upon " "next call to :meth:`refresh`." msgstr "" -#: ../src/Doc/library/curses.rst:783 +#: library/curses.rst:783 msgid "" "If *yes* is 1, the next call to :meth:`refresh` will clear the window " "completely." msgstr "" -#: ../src/Doc/library/curses.rst:789 +#: library/curses.rst:789 msgid "" "Erase from cursor to the end of the window: all lines below the cursor are " "deleted, and then the equivalent of :meth:`clrtoeol` is performed." msgstr "" -#: ../src/Doc/library/curses.rst:795 +#: library/curses.rst:795 msgid "Erase from cursor to the end of the line." msgstr "" # 95babb1d60774a8fb3bdc36ffb41a976 -#: ../src/Doc/library/curses.rst:800 +#: library/curses.rst:800 msgid "" "Update the current cursor position of all the ancestors of the window to " "reflect the current cursor position of the window." msgstr "" -#: ../src/Doc/library/curses.rst:806 +#: library/curses.rst:806 msgid "Delete any character at ``(y, x)``." msgstr "" # 6f1725bcd74a44939b1f727539aaaebe -#: ../src/Doc/library/curses.rst:811 +#: library/curses.rst:811 msgid "" "Delete the line under the cursor. All following lines are moved up by one " "line." msgstr "" # 6f6e3f97a6ef43208adea59deee4e3e0 -#: ../src/Doc/library/curses.rst:817 +#: library/curses.rst:817 msgid "" "An abbreviation for \"derive window\", :meth:`derwin` is the same as " "calling :meth:`subwin`, except that *begin_y* and *begin_x* are relative to " @@ -23017,14 +23156,14 @@ msgid "" "a window object for the derived window." msgstr "" -#: ../src/Doc/library/curses.rst:825 +#: library/curses.rst:825 msgid "" "Add character *ch* with attribute *attr*, and immediately call :meth:" "`refresh` on the window." msgstr "" # ec2586ed43f249d3957f7d31d87e2cf6 -#: ../src/Doc/library/curses.rst:831 +#: library/curses.rst:831 msgid "" "Test whether the given pair of screen-relative character-cell coordinates " "are enclosed by the given window, returning ``True`` or ``False``. It is " @@ -23032,20 +23171,20 @@ msgid "" "location of a mouse event." msgstr "" -#: ../src/Doc/library/curses.rst:839 +#: library/curses.rst:839 msgid "Clear the window." msgstr "" -#: ../src/Doc/library/curses.rst:844 +#: library/curses.rst:844 msgid "Return a tuple ``(y, x)`` of co-ordinates of upper-left corner." msgstr "" # bdcb63a3f9a34380aeab0e1861bfe016 -#: ../src/Doc/library/curses.rst:849 +#: library/curses.rst:849 msgid "Return the given window's current background character/attribute pair." msgstr "" -#: ../src/Doc/library/curses.rst:854 +#: library/curses.rst:854 msgid "" "Get a character. Note that the integer returned does *not* have to be in " "ASCII range: function keys, keypad keys and so on return numbers higher than " @@ -23053,7 +23192,7 @@ msgid "" "`getch` waits until a key is pressed." msgstr "" -#: ../src/Doc/library/curses.rst:862 +#: library/curses.rst:862 msgid "" "Get a character, returning a string instead of an integer, as :meth:`getch` " "does. Function keys, keypad keys and so on return a multibyte string " @@ -23061,36 +23200,36 @@ msgid "" "is no input." msgstr "" -#: ../src/Doc/library/curses.rst:869 +#: library/curses.rst:869 msgid "Return a tuple ``(y, x)`` of the height and width of the window." msgstr "" # 67cdc9e653814911b3d6fa4381de62e1 -#: ../src/Doc/library/curses.rst:874 +#: library/curses.rst:874 msgid "" "Return the beginning coordinates of this window relative to its parent " "window into two integer variables y and x. Return ``-1, -1`` if this window " "has no parent." msgstr "" -#: ../src/Doc/library/curses.rst:881 +#: library/curses.rst:881 msgid "Read a string from the user, with primitive line editing capacity." msgstr "" -#: ../src/Doc/library/curses.rst:886 +#: library/curses.rst:886 msgid "" "Return a tuple ``(y, x)`` of current cursor position relative to the " "window's upper-left corner." msgstr "" -#: ../src/Doc/library/curses.rst:893 +#: library/curses.rst:893 msgid "" "Display a horizontal line starting at ``(y, x)`` with length *n* consisting " "of the character *ch*." msgstr "" # 81283c7a500641308dbd47008938516c -#: ../src/Doc/library/curses.rst:899 +#: library/curses.rst:899 msgid "" "If *flag* is ``False``, curses no longer considers using the hardware insert/" "delete character feature of the terminal; if *flag* is ``True``, use of " @@ -23098,14 +23237,14 @@ msgid "" "initialized, use of character insert/delete is enabled by default." msgstr "" -#: ../src/Doc/library/curses.rst:907 +#: library/curses.rst:907 msgid "" "If called with *yes* equal to 1, :mod:`curses` will try and use hardware " "line editing facilities. Otherwise, line insertion/deletion are disabled." msgstr "" # c3a0813174a54fdab0cf70301c96269c -#: ../src/Doc/library/curses.rst:913 +#: library/curses.rst:913 msgid "" "If *flag* is ``True``, any change in the window image automatically causes " "the window to be refreshed; you no longer have to call :meth:`refresh` " @@ -23113,20 +23252,20 @@ msgid "" "calls to wrefresh. This option is disabled by default." msgstr "" -#: ../src/Doc/library/curses.rst:921 +#: library/curses.rst:921 msgid "" "Return the character at the given position in the window. The bottom 8 bits " "are the character proper, and upper bits are the attributes." msgstr "" -#: ../src/Doc/library/curses.rst:928 +#: library/curses.rst:928 msgid "" "Paint character *ch* at ``(y, x)`` with attributes *attr*, moving the line " "from position *x* right by one character." msgstr "" # e8fb7ff19c7744feae0a7a8fda1648df -#: ../src/Doc/library/curses.rst:934 +#: library/curses.rst:934 msgid "" "Insert *nlines* lines into the specified window above the current line. The " "*nlines* bottom lines are lost. For negative *nlines*, delete *nlines* " @@ -23136,13 +23275,13 @@ msgid "" msgstr "" # d662addfb9f74c0abcef5e12a336d50c -#: ../src/Doc/library/curses.rst:943 +#: library/curses.rst:943 msgid "" "Insert a blank line under the cursor. All following lines are moved down by " "one line." msgstr "" -#: ../src/Doc/library/curses.rst:950 +#: library/curses.rst:950 msgid "" "Insert a character string (as many characters as will fit on the line) " "before the character under the cursor, up to *n* characters. If *n* is " @@ -23152,7 +23291,7 @@ msgid "" "if specified)." msgstr "" -#: ../src/Doc/library/curses.rst:960 +#: library/curses.rst:960 msgid "" "Insert a character string (as many characters as will fit on the line) " "before the character under the cursor. All characters to the right of the " @@ -23162,7 +23301,7 @@ msgid "" msgstr "" # 7542858af3e447a68ac11b1b7c48bef2 -#: ../src/Doc/library/curses.rst:969 +#: library/curses.rst:969 msgid "" "Return a string of characters, extracted from the window starting at the " "current cursor position, or at *y*, *x* if specified. Attributes are " @@ -23171,7 +23310,7 @@ msgid "" msgstr "" # cfbd97fa12e24fbc876a4e6ced1908af -#: ../src/Doc/library/curses.rst:977 +#: library/curses.rst:977 msgid "" "Return ``True`` if the specified line was modified since the last call to :" "meth:`refresh`; otherwise return ``False``. Raise a :exc:`curses.error` " @@ -23179,69 +23318,69 @@ msgid "" msgstr "" # 94db10d193af42b6a279fb57826438be -#: ../src/Doc/library/curses.rst:984 +#: library/curses.rst:984 msgid "" "Return ``True`` if the specified window was modified since the last call to :" "meth:`refresh`; otherwise return ``False``." msgstr "" -#: ../src/Doc/library/curses.rst:990 +#: library/curses.rst:990 msgid "" "If *yes* is 1, escape sequences generated by some keys (keypad, function " "keys) will be interpreted by :mod:`curses`. If *yes* is 0, escape sequences " "will be left as is in the input stream." msgstr "" -#: ../src/Doc/library/curses.rst:997 +#: library/curses.rst:997 msgid "" "If *yes* is 1, cursor is left where it is on update, instead of being at " "\"cursor position.\" This reduces cursor movement where possible. If " "possible the cursor will be made invisible." msgstr "" -#: ../src/Doc/library/curses.rst:1001 +#: library/curses.rst:1001 msgid "" "If *yes* is 0, cursor will always be at \"cursor position\" after an update." msgstr "" -#: ../src/Doc/library/curses.rst:1006 +#: library/curses.rst:1006 msgid "Move cursor to ``(new_y, new_x)``." msgstr "" # 9f8488a7468b449cb68bda256be35325 -#: ../src/Doc/library/curses.rst:1011 +#: library/curses.rst:1011 msgid "" "Move the window inside its parent window. The screen-relative parameters of " "the window are not changed. This routine is used to display different parts " "of the parent window at the same physical position on the screen." msgstr "" -#: ../src/Doc/library/curses.rst:1018 +#: library/curses.rst:1018 msgid "Move the window so its upper-left corner is at ``(new_y, new_x)``." msgstr "" -#: ../src/Doc/library/curses.rst:1023 +#: library/curses.rst:1023 msgid "If *yes* is ``1``, :meth:`getch` will be non-blocking." msgstr "" -#: ../src/Doc/library/curses.rst:1028 +#: library/curses.rst:1028 msgid "If *yes* is ``1``, escape sequences will not be timed out." msgstr "" -#: ../src/Doc/library/curses.rst:1030 +#: library/curses.rst:1030 msgid "" "If *yes* is ``0``, after a few milliseconds, an escape sequence will not be " "interpreted, and will be left in the input stream as is." msgstr "" -#: ../src/Doc/library/curses.rst:1036 +#: library/curses.rst:1036 msgid "" "Mark for refresh but wait. This function updates the data structure " "representing the desired state of the window, but does not force an update " "of the physical screen. To accomplish that, call :func:`doupdate`." msgstr "" -#: ../src/Doc/library/curses.rst:1043 +#: library/curses.rst:1043 msgid "" "Overlay the window on top of *destwin*. The windows need not be the same " "size, only the overlapping region is copied. This copy is non-destructive, " @@ -23249,7 +23388,7 @@ msgid "" "contents of *destwin*." msgstr "" -#: ../src/Doc/library/curses.rst:1048 +#: library/curses.rst:1048 msgid "" "To get fine-grained control over the copied region, the second form of :meth:" "`overlay` can be used. *sminrow* and *smincol* are the upper-left " @@ -23257,7 +23396,7 @@ msgid "" "in the destination window." msgstr "" -#: ../src/Doc/library/curses.rst:1056 +#: library/curses.rst:1056 msgid "" "Overwrite the window on top of *destwin*. The windows need not be the same " "size, in which case only the overlapping region is copied. This copy is " @@ -23265,7 +23404,7 @@ msgid "" "the old contents of *destwin*." msgstr "" -#: ../src/Doc/library/curses.rst:1061 +#: library/curses.rst:1061 msgid "" "To get fine-grained control over the copied region, the second form of :meth:" "`overwrite` can be used. *sminrow* and *smincol* are the upper-left " @@ -23274,33 +23413,33 @@ msgid "" msgstr "" # b95f0f99362e433fbeb6aed187d2a2e7 -#: ../src/Doc/library/curses.rst:1069 +#: library/curses.rst:1069 msgid "" "Write all data associated with the window into the provided file object. " "This information can be later retrieved using the :func:`getwin` function." msgstr "" # ab61612c74ab4cc1bac936fe48fb88d2 -#: ../src/Doc/library/curses.rst:1075 +#: library/curses.rst:1075 msgid "" "Indicate that the *num* screen lines, starting at line *beg*, are corrupted " "and should be completely redrawn on the next :meth:`refresh` call." msgstr "" # 56853062f00d44c99606cf41e8ef8419 -#: ../src/Doc/library/curses.rst:1081 +#: library/curses.rst:1081 msgid "" "Touch the entire window, causing it to be completely redrawn on the next :" "meth:`refresh` call." msgstr "" -#: ../src/Doc/library/curses.rst:1087 +#: library/curses.rst:1087 msgid "" "Update the display immediately (sync actual screen with previous drawing/" "deleting methods)." msgstr "" -#: ../src/Doc/library/curses.rst:1090 +#: library/curses.rst:1090 msgid "" "The 6 optional arguments can only be specified when the window is a pad " "created with :func:`newpad`. The additional parameters are needed to " @@ -23316,7 +23455,7 @@ msgid "" msgstr "" # d926921d4d784840bb72c56e8dcae927 -#: ../src/Doc/library/curses.rst:1104 +#: library/curses.rst:1104 msgid "" "Reallocate storage for a curses window to adjust its dimensions to the " "specified values. If either dimension is larger than the current values, " @@ -23324,12 +23463,12 @@ msgid "" "rendition (as set by :meth:`bkgdset`) merged into them." msgstr "" -#: ../src/Doc/library/curses.rst:1112 +#: library/curses.rst:1112 msgid "Scroll the screen or scrolling region upward by *lines* lines." msgstr "" # 1ea0fa87faa54495abc7d31c3d4cb7e0 -#: ../src/Doc/library/curses.rst:1117 +#: library/curses.rst:1117 msgid "" "Control what happens when the cursor of a window is moved off the edge of " "the window or scrolling region, either as a result of a newline action on " @@ -23339,36 +23478,36 @@ msgid "" "scrolling effect on the terminal, it is also necessary to call :meth:`idlok`." msgstr "" -#: ../src/Doc/library/curses.rst:1127 +#: library/curses.rst:1127 msgid "" "Set the scrolling region from line *top* to line *bottom*. All scrolling " "actions will take place in this region." msgstr "" -#: ../src/Doc/library/curses.rst:1133 +#: library/curses.rst:1133 msgid "" "Turn off the standout attribute. On some terminals this has the side effect " "of turning off all attributes." msgstr "" -#: ../src/Doc/library/curses.rst:1139 +#: library/curses.rst:1139 msgid "Turn on attribute *A_STANDOUT*." msgstr "" -#: ../src/Doc/library/curses.rst:1145 ../src/Doc/library/curses.rst:1152 +#: library/curses.rst:1145 library/curses.rst:1152 msgid "" "Return a sub-window, whose upper-left corner is at ``(begin_y, begin_x)``, " "and whose width/height is *ncols*/*nlines*." msgstr "" -#: ../src/Doc/library/curses.rst:1155 +#: library/curses.rst:1155 msgid "" "By default, the sub-window will extend from the specified position to the " "lower right corner of the window." msgstr "" # e5a39b59ec974f64892bdd727b2ac3bd -#: ../src/Doc/library/curses.rst:1161 +#: library/curses.rst:1161 msgid "" "Touch each location in the window that has been touched in any of its " "ancestor windows. This routine is called by :meth:`refresh`, so it should " @@ -23376,21 +23515,21 @@ msgid "" msgstr "" # be4b85f7dd804a06891d73880ce6dee2 -#: ../src/Doc/library/curses.rst:1168 +#: library/curses.rst:1168 msgid "" "If called with *flag* set to ``True``, then :meth:`syncup` is called " "automatically whenever there is a change in the window." msgstr "" # c1d5c780b648474299ddcb1e209440de -#: ../src/Doc/library/curses.rst:1174 +#: library/curses.rst:1174 msgid "" "Touch all locations in ancestors of the window that have been changed in " "the window." msgstr "" # 107a623dc7fc476dab725faa94a9c691 -#: ../src/Doc/library/curses.rst:1180 +#: library/curses.rst:1180 msgid "" "Set blocking or non-blocking read behavior for the window. If *delay* is " "negative, blocking read is used (which will wait indefinitely for input). " @@ -23400,894 +23539,892 @@ msgid "" "no input at the end of that time." msgstr "" -#: ../src/Doc/library/curses.rst:1190 +#: library/curses.rst:1190 msgid "" "Pretend *count* lines have been changed, starting with line *start*. If " "*changed* is supplied, it specifies whether the affected lines are marked as " "having been changed (*changed*\\ =1) or unchanged (*changed*\\ =0)." msgstr "" -#: ../src/Doc/library/curses.rst:1197 +#: library/curses.rst:1197 msgid "" "Pretend the whole window has been changed, for purposes of drawing " "optimizations." msgstr "" # e5de0cae449c4c98a2c3342e25e68a00 -#: ../src/Doc/library/curses.rst:1203 +#: library/curses.rst:1203 msgid "" "Mark all lines in the window as unchanged since the last call to :meth:" "`refresh`." msgstr "" -#: ../src/Doc/library/curses.rst:1210 +#: library/curses.rst:1210 msgid "" "Display a vertical line starting at ``(y, x)`` with length *n* consisting of " "the character *ch*." msgstr "" -#: ../src/Doc/library/curses.rst:1217 +#: library/curses.rst:1217 msgid "The :mod:`curses` module defines the following data members:" msgstr "" -#: ../src/Doc/library/curses.rst:1222 +#: library/curses.rst:1222 msgid "" "Some curses routines that return an integer, such as :func:`getch`, " "return :const:`ERR` upon failure." msgstr "" -#: ../src/Doc/library/curses.rst:1228 +#: library/curses.rst:1228 msgid "" "Some curses routines that return an integer, such as :func:`napms`, " "return :const:`OK` upon success." msgstr "" -#: ../src/Doc/library/curses.rst:1234 +#: library/curses.rst:1234 msgid "" "A string representing the current version of the module. Also available as :" "const:`__version__`." msgstr "" -#: ../src/Doc/library/curses.rst:1237 +#: library/curses.rst:1237 msgid "Several constants are available to specify character cell attributes:" msgstr "" -#: ../src/Doc/library/curses.rst:1242 +#: library/curses.rst:1242 msgid "``A_ALTCHARSET``" msgstr "" -#: ../src/Doc/library/curses.rst:1242 +#: library/curses.rst:1242 msgid "Alternate character set mode." msgstr "" -#: ../src/Doc/library/curses.rst:1244 +#: library/curses.rst:1244 msgid "``A_BLINK``" msgstr "" -#: ../src/Doc/library/curses.rst:1244 +#: library/curses.rst:1244 msgid "Blink mode." msgstr "" -#: ../src/Doc/library/curses.rst:1246 +#: library/curses.rst:1246 msgid "``A_BOLD``" msgstr "" -#: ../src/Doc/library/curses.rst:1246 +#: library/curses.rst:1246 msgid "Bold mode." msgstr "" -#: ../src/Doc/library/curses.rst:1248 +#: library/curses.rst:1248 msgid "``A_DIM``" msgstr "" -#: ../src/Doc/library/curses.rst:1248 +#: library/curses.rst:1248 msgid "Dim mode." msgstr "" -#: ../src/Doc/library/curses.rst:1250 +#: library/curses.rst:1250 msgid "``A_NORMAL``" msgstr "" -#: ../src/Doc/library/curses.rst:1250 +#: library/curses.rst:1250 msgid "Normal attribute." msgstr "" # a5b659628a124c5c937781e5e2ec4cda -#: ../src/Doc/library/curses.rst:1252 +#: library/curses.rst:1252 msgid "``A_REVERSE``" msgstr "" # 3ed2f3e9a0f94a61820647d372972c5a -#: ../src/Doc/library/curses.rst:1252 +#: library/curses.rst:1252 msgid "Reverse background and foreground colors." msgstr "" -#: ../src/Doc/library/curses.rst:1255 +#: library/curses.rst:1255 msgid "``A_STANDOUT``" msgstr "" -#: ../src/Doc/library/curses.rst:1255 +#: library/curses.rst:1255 msgid "Standout mode." msgstr "" -#: ../src/Doc/library/curses.rst:1257 +#: library/curses.rst:1257 msgid "``A_UNDERLINE``" msgstr "" -#: ../src/Doc/library/curses.rst:1257 +#: library/curses.rst:1257 msgid "Underline mode." msgstr "" -#: ../src/Doc/library/curses.rst:1260 +#: library/curses.rst:1260 msgid "" "Keys are referred to by integer constants with names starting with " "``KEY_``. The exact keycaps available are system dependent." msgstr "" -#: ../src/Doc/library/curses.rst:1266 +#: library/curses.rst:1266 msgid "Key constant" msgstr "" -#: ../src/Doc/library/curses.rst:1266 ../src/Doc/library/locale.rst:65 +#: library/curses.rst:1266 library/locale.rst:65 msgid "Key" msgstr "" -#: ../src/Doc/library/curses.rst:1268 +#: library/curses.rst:1268 msgid "``KEY_MIN``" msgstr "" -#: ../src/Doc/library/curses.rst:1268 +#: library/curses.rst:1268 msgid "Minimum key value" msgstr "" -#: ../src/Doc/library/curses.rst:1270 +#: library/curses.rst:1270 msgid "``KEY_BREAK``" msgstr "" -#: ../src/Doc/library/curses.rst:1270 +#: library/curses.rst:1270 msgid "Break key (unreliable)" msgstr "" -#: ../src/Doc/library/curses.rst:1272 +#: library/curses.rst:1272 msgid "``KEY_DOWN``" msgstr "" -#: ../src/Doc/library/curses.rst:1272 +#: library/curses.rst:1272 msgid "Down-arrow" msgstr "" -#: ../src/Doc/library/curses.rst:1274 +#: library/curses.rst:1274 msgid "``KEY_UP``" msgstr "" -#: ../src/Doc/library/curses.rst:1274 +#: library/curses.rst:1274 msgid "Up-arrow" msgstr "" -#: ../src/Doc/library/curses.rst:1276 +#: library/curses.rst:1276 msgid "``KEY_LEFT``" msgstr "" -#: ../src/Doc/library/curses.rst:1276 +#: library/curses.rst:1276 msgid "Left-arrow" msgstr "" -#: ../src/Doc/library/curses.rst:1278 +#: library/curses.rst:1278 msgid "``KEY_RIGHT``" msgstr "" -#: ../src/Doc/library/curses.rst:1278 +#: library/curses.rst:1278 msgid "Right-arrow" msgstr "" -#: ../src/Doc/library/curses.rst:1280 +#: library/curses.rst:1280 msgid "``KEY_HOME``" msgstr "" -#: ../src/Doc/library/curses.rst:1280 +#: library/curses.rst:1280 msgid "Home key (upward+left arrow)" msgstr "" -#: ../src/Doc/library/curses.rst:1282 +#: library/curses.rst:1282 msgid "``KEY_BACKSPACE``" msgstr "" -#: ../src/Doc/library/curses.rst:1282 +#: library/curses.rst:1282 msgid "Backspace (unreliable)" msgstr "" -#: ../src/Doc/library/curses.rst:1284 +#: library/curses.rst:1284 msgid "``KEY_F0``" msgstr "" -#: ../src/Doc/library/curses.rst:1284 +#: library/curses.rst:1284 msgid "Function keys. Up to 64 function keys are supported." msgstr "" -#: ../src/Doc/library/curses.rst:1287 +#: library/curses.rst:1287 msgid "``KEY_Fn``" msgstr "" -#: ../src/Doc/library/curses.rst:1287 +#: library/curses.rst:1287 msgid "Value of function key *n*" msgstr "" -#: ../src/Doc/library/curses.rst:1289 +#: library/curses.rst:1289 msgid "``KEY_DL``" msgstr "" -#: ../src/Doc/library/curses.rst:1289 +#: library/curses.rst:1289 msgid "Delete line" msgstr "" -#: ../src/Doc/library/curses.rst:1291 +#: library/curses.rst:1291 msgid "``KEY_IL``" msgstr "" -#: ../src/Doc/library/curses.rst:1291 +#: library/curses.rst:1291 msgid "Insert line" msgstr "" -#: ../src/Doc/library/curses.rst:1293 +#: library/curses.rst:1293 msgid "``KEY_DC``" msgstr "" -#: ../src/Doc/library/curses.rst:1293 +#: library/curses.rst:1293 msgid "Delete character" msgstr "" -#: ../src/Doc/library/curses.rst:1295 +#: library/curses.rst:1295 msgid "``KEY_IC``" msgstr "" -#: ../src/Doc/library/curses.rst:1295 +#: library/curses.rst:1295 msgid "Insert char or enter insert mode" msgstr "" -#: ../src/Doc/library/curses.rst:1297 +#: library/curses.rst:1297 msgid "``KEY_EIC``" msgstr "" -#: ../src/Doc/library/curses.rst:1297 +#: library/curses.rst:1297 msgid "Exit insert char mode" msgstr "" -#: ../src/Doc/library/curses.rst:1299 +#: library/curses.rst:1299 msgid "``KEY_CLEAR``" msgstr "" -#: ../src/Doc/library/curses.rst:1299 +#: library/curses.rst:1299 msgid "Clear screen" msgstr "" -#: ../src/Doc/library/curses.rst:1301 +#: library/curses.rst:1301 msgid "``KEY_EOS``" msgstr "" -#: ../src/Doc/library/curses.rst:1301 +#: library/curses.rst:1301 msgid "Clear to end of screen" msgstr "" -#: ../src/Doc/library/curses.rst:1303 +#: library/curses.rst:1303 msgid "``KEY_EOL``" msgstr "" -#: ../src/Doc/library/curses.rst:1303 +#: library/curses.rst:1303 msgid "Clear to end of line" msgstr "" -#: ../src/Doc/library/curses.rst:1305 +#: library/curses.rst:1305 msgid "``KEY_SF``" msgstr "" -#: ../src/Doc/library/curses.rst:1305 +#: library/curses.rst:1305 msgid "Scroll 1 line forward" msgstr "" -#: ../src/Doc/library/curses.rst:1307 +#: library/curses.rst:1307 msgid "``KEY_SR``" msgstr "" -#: ../src/Doc/library/curses.rst:1307 +#: library/curses.rst:1307 msgid "Scroll 1 line backward (reverse)" msgstr "" -#: ../src/Doc/library/curses.rst:1309 +#: library/curses.rst:1309 msgid "``KEY_NPAGE``" msgstr "" -#: ../src/Doc/library/curses.rst:1309 +#: library/curses.rst:1309 msgid "Next page" msgstr "" -#: ../src/Doc/library/curses.rst:1311 +#: library/curses.rst:1311 msgid "``KEY_PPAGE``" msgstr "" -#: ../src/Doc/library/curses.rst:1311 +#: library/curses.rst:1311 msgid "Previous page" msgstr "" -#: ../src/Doc/library/curses.rst:1313 +#: library/curses.rst:1313 msgid "``KEY_STAB``" msgstr "" -#: ../src/Doc/library/curses.rst:1313 +#: library/curses.rst:1313 msgid "Set tab" msgstr "" -#: ../src/Doc/library/curses.rst:1315 +#: library/curses.rst:1315 msgid "``KEY_CTAB``" msgstr "" -#: ../src/Doc/library/curses.rst:1315 +#: library/curses.rst:1315 msgid "Clear tab" msgstr "" -#: ../src/Doc/library/curses.rst:1317 +#: library/curses.rst:1317 msgid "``KEY_CATAB``" msgstr "" -#: ../src/Doc/library/curses.rst:1317 +#: library/curses.rst:1317 msgid "Clear all tabs" msgstr "" -#: ../src/Doc/library/curses.rst:1319 +#: library/curses.rst:1319 msgid "``KEY_ENTER``" msgstr "" -#: ../src/Doc/library/curses.rst:1319 +#: library/curses.rst:1319 msgid "Enter or send (unreliable)" msgstr "" -#: ../src/Doc/library/curses.rst:1321 +#: library/curses.rst:1321 msgid "``KEY_SRESET``" msgstr "" -#: ../src/Doc/library/curses.rst:1321 +#: library/curses.rst:1321 msgid "Soft (partial) reset (unreliable)" msgstr "" -#: ../src/Doc/library/curses.rst:1323 +#: library/curses.rst:1323 msgid "``KEY_RESET``" msgstr "" -#: ../src/Doc/library/curses.rst:1323 +#: library/curses.rst:1323 msgid "Reset or hard reset (unreliable)" msgstr "" -#: ../src/Doc/library/curses.rst:1325 +#: library/curses.rst:1325 msgid "``KEY_PRINT``" msgstr "" -#: ../src/Doc/library/curses.rst:1325 +#: library/curses.rst:1325 msgid "Print" msgstr "" -#: ../src/Doc/library/curses.rst:1327 +#: library/curses.rst:1327 msgid "``KEY_LL``" msgstr "" -#: ../src/Doc/library/curses.rst:1327 +#: library/curses.rst:1327 msgid "Home down or bottom (lower left)" msgstr "" -#: ../src/Doc/library/curses.rst:1329 +#: library/curses.rst:1329 msgid "``KEY_A1``" msgstr "" -#: ../src/Doc/library/curses.rst:1329 +#: library/curses.rst:1329 msgid "Upper left of keypad" msgstr "" -#: ../src/Doc/library/curses.rst:1331 +#: library/curses.rst:1331 msgid "``KEY_A3``" msgstr "" -#: ../src/Doc/library/curses.rst:1331 +#: library/curses.rst:1331 msgid "Upper right of keypad" msgstr "" -#: ../src/Doc/library/curses.rst:1333 +#: library/curses.rst:1333 msgid "``KEY_B2``" msgstr "" -#: ../src/Doc/library/curses.rst:1333 +#: library/curses.rst:1333 msgid "Center of keypad" msgstr "" -#: ../src/Doc/library/curses.rst:1335 +#: library/curses.rst:1335 msgid "``KEY_C1``" msgstr "" -#: ../src/Doc/library/curses.rst:1335 +#: library/curses.rst:1335 msgid "Lower left of keypad" msgstr "" -#: ../src/Doc/library/curses.rst:1337 +#: library/curses.rst:1337 msgid "``KEY_C3``" msgstr "" -#: ../src/Doc/library/curses.rst:1337 +#: library/curses.rst:1337 msgid "Lower right of keypad" msgstr "" -#: ../src/Doc/library/curses.rst:1339 +#: library/curses.rst:1339 msgid "``KEY_BTAB``" msgstr "" -#: ../src/Doc/library/curses.rst:1339 +#: library/curses.rst:1339 msgid "Back tab" msgstr "" -#: ../src/Doc/library/curses.rst:1341 +#: library/curses.rst:1341 msgid "``KEY_BEG``" msgstr "" -#: ../src/Doc/library/curses.rst:1341 +#: library/curses.rst:1341 msgid "Beg (beginning)" msgstr "" -#: ../src/Doc/library/curses.rst:1343 +#: library/curses.rst:1343 msgid "``KEY_CANCEL``" msgstr "" -#: ../src/Doc/library/curses.rst:1343 ../src/Doc/library/curses.ascii.rst:72 +#: library/curses.rst:1343 library/curses.ascii.rst:72 msgid "Cancel" msgstr "" -#: ../src/Doc/library/curses.rst:1345 +#: library/curses.rst:1345 msgid "``KEY_CLOSE``" msgstr "" -#: ../src/Doc/library/curses.rst:1345 ../src/Doc/library/idle.rst:65 +#: library/curses.rst:1345 library/idle.rst:92 msgid "Close" msgstr "" -#: ../src/Doc/library/curses.rst:1347 +#: library/curses.rst:1347 msgid "``KEY_COMMAND``" msgstr "" -#: ../src/Doc/library/curses.rst:1347 +#: library/curses.rst:1347 msgid "Cmd (command)" msgstr "" -#: ../src/Doc/library/curses.rst:1349 +#: library/curses.rst:1349 msgid "``KEY_COPY``" msgstr "" -#: ../src/Doc/library/curses.rst:1349 ../src/Doc/library/idle.rst:84 -#: ../src/Doc/library/idle.rst:189 ../src/Doc/library/idle.rst:218 +#: library/curses.rst:1349 library/idle.rst:111 library/idle.rst:319 msgid "Copy" msgstr "" -#: ../src/Doc/library/curses.rst:1351 +#: library/curses.rst:1351 msgid "``KEY_CREATE``" msgstr "" -#: ../src/Doc/library/curses.rst:1351 +#: library/curses.rst:1351 msgid "Create" msgstr "" -#: ../src/Doc/library/curses.rst:1353 +#: library/curses.rst:1353 msgid "``KEY_END``" msgstr "" -#: ../src/Doc/library/curses.rst:1353 +#: library/curses.rst:1353 msgid "End" msgstr "" -#: ../src/Doc/library/curses.rst:1355 +#: library/curses.rst:1355 msgid "``KEY_EXIT``" msgstr "" -#: ../src/Doc/library/curses.rst:1355 ../src/Doc/library/idle.rst:69 +#: library/curses.rst:1355 library/idle.rst:95 msgid "Exit" msgstr "" -#: ../src/Doc/library/curses.rst:1357 +#: library/curses.rst:1357 msgid "``KEY_FIND``" msgstr "" -#: ../src/Doc/library/curses.rst:1357 +#: library/curses.rst:1357 msgid "Find" msgstr "" -#: ../src/Doc/library/curses.rst:1359 +#: library/curses.rst:1359 msgid "``KEY_HELP``" msgstr "" -#: ../src/Doc/library/curses.rst:1359 +#: library/curses.rst:1359 msgid "Help" msgstr "" -#: ../src/Doc/library/curses.rst:1361 +#: library/curses.rst:1361 msgid "``KEY_MARK``" msgstr "" -#: ../src/Doc/library/curses.rst:1361 +#: library/curses.rst:1361 msgid "Mark" msgstr "" -#: ../src/Doc/library/curses.rst:1363 +#: library/curses.rst:1363 msgid "``KEY_MESSAGE``" msgstr "" -#: ../src/Doc/library/curses.rst:1363 +#: library/curses.rst:1363 msgid "Message" msgstr "" -#: ../src/Doc/library/curses.rst:1365 +#: library/curses.rst:1365 msgid "``KEY_MOVE``" msgstr "" -#: ../src/Doc/library/curses.rst:1365 +#: library/curses.rst:1365 msgid "Move" msgstr "" -#: ../src/Doc/library/curses.rst:1367 +#: library/curses.rst:1367 msgid "``KEY_NEXT``" msgstr "" -#: ../src/Doc/library/curses.rst:1367 +#: library/curses.rst:1367 msgid "Next" msgstr "" -#: ../src/Doc/library/curses.rst:1369 +#: library/curses.rst:1369 msgid "``KEY_OPEN``" msgstr "" -#: ../src/Doc/library/curses.rst:1369 +#: library/curses.rst:1369 msgid "Open" msgstr "" -#: ../src/Doc/library/curses.rst:1371 +#: library/curses.rst:1371 msgid "``KEY_OPTIONS``" msgstr "" -#: ../src/Doc/library/curses.rst:1371 ../src/Doc/library/ttk.rst:302 -#: ../src/Doc/library/ttk.rst:382 ../src/Doc/library/ttk.rst:568 -#: ../src/Doc/library/ttk.rst:637 ../src/Doc/library/ttk.rst:703 +#: library/curses.rst:1371 library/ttk.rst:302 library/ttk.rst:382 +#: library/ttk.rst:568 library/ttk.rst:637 library/ttk.rst:703 msgid "Options" msgstr "" -#: ../src/Doc/library/curses.rst:1373 +#: library/curses.rst:1373 msgid "``KEY_PREVIOUS``" msgstr "" -#: ../src/Doc/library/curses.rst:1373 +#: library/curses.rst:1373 msgid "Prev (previous)" msgstr "" -#: ../src/Doc/library/curses.rst:1375 +#: library/curses.rst:1375 msgid "``KEY_REDO``" msgstr "" -#: ../src/Doc/library/curses.rst:1375 ../src/Doc/library/idle.rst:78 +#: library/curses.rst:1375 library/idle.rst:105 msgid "Redo" msgstr "" -#: ../src/Doc/library/curses.rst:1377 +#: library/curses.rst:1377 msgid "``KEY_REFERENCE``" msgstr "" -#: ../src/Doc/library/curses.rst:1377 +#: library/curses.rst:1377 msgid "Ref (reference)" msgstr "" -#: ../src/Doc/library/curses.rst:1379 +#: library/curses.rst:1379 msgid "``KEY_REFRESH``" msgstr "" -#: ../src/Doc/library/curses.rst:1379 +#: library/curses.rst:1379 msgid "Refresh" msgstr "" -#: ../src/Doc/library/curses.rst:1381 +#: library/curses.rst:1381 msgid "``KEY_REPLACE``" msgstr "" -#: ../src/Doc/library/curses.rst:1381 +#: library/curses.rst:1381 msgid "Replace" msgstr "" -#: ../src/Doc/library/curses.rst:1383 +#: library/curses.rst:1383 msgid "``KEY_RESTART``" msgstr "" -#: ../src/Doc/library/curses.rst:1383 +#: library/curses.rst:1383 msgid "Restart" msgstr "" -#: ../src/Doc/library/curses.rst:1385 +#: library/curses.rst:1385 msgid "``KEY_RESUME``" msgstr "" -#: ../src/Doc/library/curses.rst:1385 +#: library/curses.rst:1385 msgid "Resume" msgstr "" -#: ../src/Doc/library/curses.rst:1387 +#: library/curses.rst:1387 msgid "``KEY_SAVE``" msgstr "" -#: ../src/Doc/library/curses.rst:1387 ../src/Doc/library/idle.rst:56 +#: library/curses.rst:1387 library/idle.rst:78 msgid "Save" msgstr "" -#: ../src/Doc/library/curses.rst:1389 +#: library/curses.rst:1389 msgid "``KEY_SBEG``" msgstr "" -#: ../src/Doc/library/curses.rst:1389 +#: library/curses.rst:1389 msgid "Shifted Beg (beginning)" msgstr "" -#: ../src/Doc/library/curses.rst:1391 +#: library/curses.rst:1391 msgid "``KEY_SCANCEL``" msgstr "" -#: ../src/Doc/library/curses.rst:1391 +#: library/curses.rst:1391 msgid "Shifted Cancel" msgstr "" -#: ../src/Doc/library/curses.rst:1393 +#: library/curses.rst:1393 msgid "``KEY_SCOMMAND``" msgstr "" -#: ../src/Doc/library/curses.rst:1393 +#: library/curses.rst:1393 msgid "Shifted Command" msgstr "" -#: ../src/Doc/library/curses.rst:1395 +#: library/curses.rst:1395 msgid "``KEY_SCOPY``" msgstr "" -#: ../src/Doc/library/curses.rst:1395 +#: library/curses.rst:1395 msgid "Shifted Copy" msgstr "" -#: ../src/Doc/library/curses.rst:1397 +#: library/curses.rst:1397 msgid "``KEY_SCREATE``" msgstr "" -#: ../src/Doc/library/curses.rst:1397 +#: library/curses.rst:1397 msgid "Shifted Create" msgstr "" -#: ../src/Doc/library/curses.rst:1399 +#: library/curses.rst:1399 msgid "``KEY_SDC``" msgstr "" -#: ../src/Doc/library/curses.rst:1399 +#: library/curses.rst:1399 msgid "Shifted Delete char" msgstr "" -#: ../src/Doc/library/curses.rst:1401 +#: library/curses.rst:1401 msgid "``KEY_SDL``" msgstr "" -#: ../src/Doc/library/curses.rst:1401 +#: library/curses.rst:1401 msgid "Shifted Delete line" msgstr "" -#: ../src/Doc/library/curses.rst:1403 +#: library/curses.rst:1403 msgid "``KEY_SELECT``" msgstr "" -#: ../src/Doc/library/curses.rst:1403 +#: library/curses.rst:1403 msgid "Select" msgstr "" -#: ../src/Doc/library/curses.rst:1405 +#: library/curses.rst:1405 msgid "``KEY_SEND``" msgstr "" -#: ../src/Doc/library/curses.rst:1405 +#: library/curses.rst:1405 msgid "Shifted End" msgstr "" -#: ../src/Doc/library/curses.rst:1407 +#: library/curses.rst:1407 msgid "``KEY_SEOL``" msgstr "" -#: ../src/Doc/library/curses.rst:1407 +#: library/curses.rst:1407 msgid "Shifted Clear line" msgstr "" -#: ../src/Doc/library/curses.rst:1409 +#: library/curses.rst:1409 msgid "``KEY_SEXIT``" msgstr "" -#: ../src/Doc/library/curses.rst:1409 +#: library/curses.rst:1409 msgid "Shifted Dxit" msgstr "" -#: ../src/Doc/library/curses.rst:1411 +#: library/curses.rst:1411 msgid "``KEY_SFIND``" msgstr "" -#: ../src/Doc/library/curses.rst:1411 +#: library/curses.rst:1411 msgid "Shifted Find" msgstr "" -#: ../src/Doc/library/curses.rst:1413 +#: library/curses.rst:1413 msgid "``KEY_SHELP``" msgstr "" -#: ../src/Doc/library/curses.rst:1413 +#: library/curses.rst:1413 msgid "Shifted Help" msgstr "" -#: ../src/Doc/library/curses.rst:1415 +#: library/curses.rst:1415 msgid "``KEY_SHOME``" msgstr "" -#: ../src/Doc/library/curses.rst:1415 +#: library/curses.rst:1415 msgid "Shifted Home" msgstr "" -#: ../src/Doc/library/curses.rst:1417 +#: library/curses.rst:1417 msgid "``KEY_SIC``" msgstr "" -#: ../src/Doc/library/curses.rst:1417 +#: library/curses.rst:1417 msgid "Shifted Input" msgstr "" -#: ../src/Doc/library/curses.rst:1419 +#: library/curses.rst:1419 msgid "``KEY_SLEFT``" msgstr "" -#: ../src/Doc/library/curses.rst:1419 +#: library/curses.rst:1419 msgid "Shifted Left arrow" msgstr "" -#: ../src/Doc/library/curses.rst:1421 +#: library/curses.rst:1421 msgid "``KEY_SMESSAGE``" msgstr "" -#: ../src/Doc/library/curses.rst:1421 +#: library/curses.rst:1421 msgid "Shifted Message" msgstr "" -#: ../src/Doc/library/curses.rst:1423 +#: library/curses.rst:1423 msgid "``KEY_SMOVE``" msgstr "" -#: ../src/Doc/library/curses.rst:1423 +#: library/curses.rst:1423 msgid "Shifted Move" msgstr "" -#: ../src/Doc/library/curses.rst:1425 +#: library/curses.rst:1425 msgid "``KEY_SNEXT``" msgstr "" -#: ../src/Doc/library/curses.rst:1425 +#: library/curses.rst:1425 msgid "Shifted Next" msgstr "" -#: ../src/Doc/library/curses.rst:1427 +#: library/curses.rst:1427 msgid "``KEY_SOPTIONS``" msgstr "" -#: ../src/Doc/library/curses.rst:1427 +#: library/curses.rst:1427 msgid "Shifted Options" msgstr "" -#: ../src/Doc/library/curses.rst:1429 +#: library/curses.rst:1429 msgid "``KEY_SPREVIOUS``" msgstr "" -#: ../src/Doc/library/curses.rst:1429 +#: library/curses.rst:1429 msgid "Shifted Prev" msgstr "" -#: ../src/Doc/library/curses.rst:1431 +#: library/curses.rst:1431 msgid "``KEY_SPRINT``" msgstr "" -#: ../src/Doc/library/curses.rst:1431 +#: library/curses.rst:1431 msgid "Shifted Print" msgstr "" -#: ../src/Doc/library/curses.rst:1433 +#: library/curses.rst:1433 msgid "``KEY_SREDO``" msgstr "" -#: ../src/Doc/library/curses.rst:1433 +#: library/curses.rst:1433 msgid "Shifted Redo" msgstr "" -#: ../src/Doc/library/curses.rst:1435 +#: library/curses.rst:1435 msgid "``KEY_SREPLACE``" msgstr "" -#: ../src/Doc/library/curses.rst:1435 +#: library/curses.rst:1435 msgid "Shifted Replace" msgstr "" -#: ../src/Doc/library/curses.rst:1437 +#: library/curses.rst:1437 msgid "``KEY_SRIGHT``" msgstr "" -#: ../src/Doc/library/curses.rst:1437 +#: library/curses.rst:1437 msgid "Shifted Right arrow" msgstr "" -#: ../src/Doc/library/curses.rst:1439 +#: library/curses.rst:1439 msgid "``KEY_SRSUME``" msgstr "" -#: ../src/Doc/library/curses.rst:1439 +#: library/curses.rst:1439 msgid "Shifted Resume" msgstr "" -#: ../src/Doc/library/curses.rst:1441 +#: library/curses.rst:1441 msgid "``KEY_SSAVE``" msgstr "" -#: ../src/Doc/library/curses.rst:1441 +#: library/curses.rst:1441 msgid "Shifted Save" msgstr "" -#: ../src/Doc/library/curses.rst:1443 +#: library/curses.rst:1443 msgid "``KEY_SSUSPEND``" msgstr "" -#: ../src/Doc/library/curses.rst:1443 +#: library/curses.rst:1443 msgid "Shifted Suspend" msgstr "" -#: ../src/Doc/library/curses.rst:1445 +#: library/curses.rst:1445 msgid "``KEY_SUNDO``" msgstr "" -#: ../src/Doc/library/curses.rst:1445 +#: library/curses.rst:1445 msgid "Shifted Undo" msgstr "" -#: ../src/Doc/library/curses.rst:1447 +#: library/curses.rst:1447 msgid "``KEY_SUSPEND``" msgstr "" -#: ../src/Doc/library/curses.rst:1447 +#: library/curses.rst:1447 msgid "Suspend" msgstr "" -#: ../src/Doc/library/curses.rst:1449 +#: library/curses.rst:1449 msgid "``KEY_UNDO``" msgstr "" -#: ../src/Doc/library/curses.rst:1449 ../src/Doc/library/idle.rst:75 +#: library/curses.rst:1449 library/idle.rst:102 msgid "Undo" msgstr "" -#: ../src/Doc/library/curses.rst:1451 +#: library/curses.rst:1451 msgid "``KEY_MOUSE``" msgstr "" -#: ../src/Doc/library/curses.rst:1451 +#: library/curses.rst:1451 msgid "Mouse event has occurred" msgstr "" -#: ../src/Doc/library/curses.rst:1453 +#: library/curses.rst:1453 msgid "``KEY_RESIZE``" msgstr "" -#: ../src/Doc/library/curses.rst:1453 +#: library/curses.rst:1453 msgid "Terminal resize event" msgstr "" -#: ../src/Doc/library/curses.rst:1455 +#: library/curses.rst:1455 msgid "``KEY_MAX``" msgstr "" -#: ../src/Doc/library/curses.rst:1455 +#: library/curses.rst:1455 msgid "Maximum key value" msgstr "" -#: ../src/Doc/library/curses.rst:1458 +#: library/curses.rst:1458 msgid "" "On VT100s and their software emulations, such as X terminal emulators, there " "are normally at least four function keys (:const:`KEY_F1`, :const:`KEY_F2`, :" @@ -24298,70 +24435,67 @@ msgid "" "function keys); also, the following keypad mappings are standard:" msgstr "" -#: ../src/Doc/library/curses.rst:1467 +#: library/curses.rst:1467 msgid "Keycap" msgstr "" -#: ../src/Doc/library/curses.rst:1467 ../src/Doc/library/curses.rst:1584 -#: ../src/Doc/library/curses.rst:1710 ../src/Doc/library/httplib.rst:211 -#: ../src/Doc/library/select.rst:123 ../src/Doc/library/select.rst:221 -#: ../src/Doc/library/select.rst:322 ../src/Doc/library/select.rst:351 -#: ../src/Doc/library/select.rst:382 ../src/Doc/library/select.rst:390 -#: ../src/Doc/library/select.rst:410 ../src/Doc/library/select.rst:433 -#: ../src/Doc/library/sys.rst:516 ../src/Doc/library/sys.rst:530 -#: ../src/Doc/library/xml.dom.rst:945 +#: library/curses.rst:1467 library/curses.rst:1584 library/curses.rst:1710 +#: library/httplib.rst:227 library/select.rst:123 library/select.rst:221 +#: library/select.rst:322 library/select.rst:351 library/select.rst:382 +#: library/select.rst:390 library/select.rst:410 library/select.rst:433 +#: library/sys.rst:516 library/sys.rst:530 library/xml.dom.rst:945 msgid "Constant" msgstr "" -#: ../src/Doc/library/curses.rst:1469 +#: library/curses.rst:1469 msgid ":kbd:`Insert`" msgstr "" -#: ../src/Doc/library/curses.rst:1469 +#: library/curses.rst:1469 msgid "KEY_IC" msgstr "" -#: ../src/Doc/library/curses.rst:1471 +#: library/curses.rst:1471 msgid ":kbd:`Delete`" msgstr "" -#: ../src/Doc/library/curses.rst:1471 +#: library/curses.rst:1471 msgid "KEY_DC" msgstr "" -#: ../src/Doc/library/curses.rst:1473 +#: library/curses.rst:1473 msgid ":kbd:`Home`" msgstr "" -#: ../src/Doc/library/curses.rst:1473 +#: library/curses.rst:1473 msgid "KEY_HOME" msgstr "" -#: ../src/Doc/library/curses.rst:1475 +#: library/curses.rst:1475 msgid ":kbd:`End`" msgstr "" -#: ../src/Doc/library/curses.rst:1475 +#: library/curses.rst:1475 msgid "KEY_END" msgstr "" -#: ../src/Doc/library/curses.rst:1477 +#: library/curses.rst:1477 msgid ":kbd:`Page Up`" msgstr "" -#: ../src/Doc/library/curses.rst:1477 +#: library/curses.rst:1477 msgid "KEY_NPAGE" msgstr "" -#: ../src/Doc/library/curses.rst:1479 +#: library/curses.rst:1479 msgid ":kbd:`Page Down`" msgstr "" -#: ../src/Doc/library/curses.rst:1479 +#: library/curses.rst:1479 msgid "KEY_PPAGE" msgstr "" -#: ../src/Doc/library/curses.rst:1482 +#: library/curses.rst:1482 msgid "" "The following table lists characters from the alternate character set. These " "are inherited from the VT100 terminal, and will generally be available on " @@ -24369,435 +24503,435 @@ msgid "" "available, curses falls back on a crude printable ASCII approximation." msgstr "" -#: ../src/Doc/library/curses.rst:1489 +#: library/curses.rst:1489 msgid "These are available only after :func:`initscr` has been called." msgstr "" -#: ../src/Doc/library/curses.rst:1492 +#: library/curses.rst:1492 msgid "ACS code" msgstr "" -#: ../src/Doc/library/curses.rst:1494 +#: library/curses.rst:1494 msgid "``ACS_BBSS``" msgstr "" -#: ../src/Doc/library/curses.rst:1494 +#: library/curses.rst:1494 msgid "alternate name for upper right corner" msgstr "" -#: ../src/Doc/library/curses.rst:1496 +#: library/curses.rst:1496 msgid "``ACS_BLOCK``" msgstr "" -#: ../src/Doc/library/curses.rst:1496 +#: library/curses.rst:1496 msgid "solid square block" msgstr "" -#: ../src/Doc/library/curses.rst:1498 +#: library/curses.rst:1498 msgid "``ACS_BOARD``" msgstr "" -#: ../src/Doc/library/curses.rst:1498 +#: library/curses.rst:1498 msgid "board of squares" msgstr "" -#: ../src/Doc/library/curses.rst:1500 +#: library/curses.rst:1500 msgid "``ACS_BSBS``" msgstr "" -#: ../src/Doc/library/curses.rst:1500 +#: library/curses.rst:1500 msgid "alternate name for horizontal line" msgstr "" -#: ../src/Doc/library/curses.rst:1502 +#: library/curses.rst:1502 msgid "``ACS_BSSB``" msgstr "" -#: ../src/Doc/library/curses.rst:1502 +#: library/curses.rst:1502 msgid "alternate name for upper left corner" msgstr "" -#: ../src/Doc/library/curses.rst:1504 +#: library/curses.rst:1504 msgid "``ACS_BSSS``" msgstr "" -#: ../src/Doc/library/curses.rst:1504 +#: library/curses.rst:1504 msgid "alternate name for top tee" msgstr "" -#: ../src/Doc/library/curses.rst:1506 +#: library/curses.rst:1506 msgid "``ACS_BTEE``" msgstr "" -#: ../src/Doc/library/curses.rst:1506 +#: library/curses.rst:1506 msgid "bottom tee" msgstr "" -#: ../src/Doc/library/curses.rst:1508 +#: library/curses.rst:1508 msgid "``ACS_BULLET``" msgstr "" -#: ../src/Doc/library/curses.rst:1508 +#: library/curses.rst:1508 msgid "bullet" msgstr "" -#: ../src/Doc/library/curses.rst:1510 +#: library/curses.rst:1510 msgid "``ACS_CKBOARD``" msgstr "" -#: ../src/Doc/library/curses.rst:1510 +#: library/curses.rst:1510 msgid "checker board (stipple)" msgstr "" -#: ../src/Doc/library/curses.rst:1512 +#: library/curses.rst:1512 msgid "``ACS_DARROW``" msgstr "" -#: ../src/Doc/library/curses.rst:1512 +#: library/curses.rst:1512 msgid "arrow pointing down" msgstr "" -#: ../src/Doc/library/curses.rst:1514 +#: library/curses.rst:1514 msgid "``ACS_DEGREE``" msgstr "" -#: ../src/Doc/library/curses.rst:1514 +#: library/curses.rst:1514 msgid "degree symbol" msgstr "" -#: ../src/Doc/library/curses.rst:1516 +#: library/curses.rst:1516 msgid "``ACS_DIAMOND``" msgstr "" -#: ../src/Doc/library/curses.rst:1516 +#: library/curses.rst:1516 msgid "diamond" msgstr "" -#: ../src/Doc/library/curses.rst:1518 +#: library/curses.rst:1518 msgid "``ACS_GEQUAL``" msgstr "" -#: ../src/Doc/library/curses.rst:1518 +#: library/curses.rst:1518 msgid "greater-than-or-equal-to" msgstr "" -#: ../src/Doc/library/curses.rst:1520 +#: library/curses.rst:1520 msgid "``ACS_HLINE``" msgstr "" -#: ../src/Doc/library/curses.rst:1520 +#: library/curses.rst:1520 msgid "horizontal line" msgstr "" -#: ../src/Doc/library/curses.rst:1522 +#: library/curses.rst:1522 msgid "``ACS_LANTERN``" msgstr "" -#: ../src/Doc/library/curses.rst:1522 +#: library/curses.rst:1522 msgid "lantern symbol" msgstr "" -#: ../src/Doc/library/curses.rst:1524 +#: library/curses.rst:1524 msgid "``ACS_LARROW``" msgstr "" -#: ../src/Doc/library/curses.rst:1524 +#: library/curses.rst:1524 msgid "left arrow" msgstr "" -#: ../src/Doc/library/curses.rst:1526 +#: library/curses.rst:1526 msgid "``ACS_LEQUAL``" msgstr "" -#: ../src/Doc/library/curses.rst:1526 +#: library/curses.rst:1526 msgid "less-than-or-equal-to" msgstr "" -#: ../src/Doc/library/curses.rst:1528 +#: library/curses.rst:1528 msgid "``ACS_LLCORNER``" msgstr "" -#: ../src/Doc/library/curses.rst:1528 +#: library/curses.rst:1528 msgid "lower left-hand corner" msgstr "" -#: ../src/Doc/library/curses.rst:1530 +#: library/curses.rst:1530 msgid "``ACS_LRCORNER``" msgstr "" -#: ../src/Doc/library/curses.rst:1530 +#: library/curses.rst:1530 msgid "lower right-hand corner" msgstr "" -#: ../src/Doc/library/curses.rst:1532 +#: library/curses.rst:1532 msgid "``ACS_LTEE``" msgstr "" -#: ../src/Doc/library/curses.rst:1532 +#: library/curses.rst:1532 msgid "left tee" msgstr "" -#: ../src/Doc/library/curses.rst:1534 +#: library/curses.rst:1534 msgid "``ACS_NEQUAL``" msgstr "" -#: ../src/Doc/library/curses.rst:1534 +#: library/curses.rst:1534 msgid "not-equal sign" msgstr "" -#: ../src/Doc/library/curses.rst:1536 +#: library/curses.rst:1536 msgid "``ACS_PI``" msgstr "" -#: ../src/Doc/library/curses.rst:1536 +#: library/curses.rst:1536 msgid "letter pi" msgstr "" -#: ../src/Doc/library/curses.rst:1538 +#: library/curses.rst:1538 msgid "``ACS_PLMINUS``" msgstr "" -#: ../src/Doc/library/curses.rst:1538 +#: library/curses.rst:1538 msgid "plus-or-minus sign" msgstr "" -#: ../src/Doc/library/curses.rst:1540 +#: library/curses.rst:1540 msgid "``ACS_PLUS``" msgstr "" -#: ../src/Doc/library/curses.rst:1540 +#: library/curses.rst:1540 msgid "big plus sign" msgstr "" -#: ../src/Doc/library/curses.rst:1542 +#: library/curses.rst:1542 msgid "``ACS_RARROW``" msgstr "" -#: ../src/Doc/library/curses.rst:1542 +#: library/curses.rst:1542 msgid "right arrow" msgstr "" -#: ../src/Doc/library/curses.rst:1544 +#: library/curses.rst:1544 msgid "``ACS_RTEE``" msgstr "" -#: ../src/Doc/library/curses.rst:1544 +#: library/curses.rst:1544 msgid "right tee" msgstr "" -#: ../src/Doc/library/curses.rst:1546 +#: library/curses.rst:1546 msgid "``ACS_S1``" msgstr "" -#: ../src/Doc/library/curses.rst:1546 +#: library/curses.rst:1546 msgid "scan line 1" msgstr "" -#: ../src/Doc/library/curses.rst:1548 +#: library/curses.rst:1548 msgid "``ACS_S3``" msgstr "" -#: ../src/Doc/library/curses.rst:1548 +#: library/curses.rst:1548 msgid "scan line 3" msgstr "" -#: ../src/Doc/library/curses.rst:1550 +#: library/curses.rst:1550 msgid "``ACS_S7``" msgstr "" -#: ../src/Doc/library/curses.rst:1550 +#: library/curses.rst:1550 msgid "scan line 7" msgstr "" -#: ../src/Doc/library/curses.rst:1552 +#: library/curses.rst:1552 msgid "``ACS_S9``" msgstr "" -#: ../src/Doc/library/curses.rst:1552 +#: library/curses.rst:1552 msgid "scan line 9" msgstr "" -#: ../src/Doc/library/curses.rst:1554 +#: library/curses.rst:1554 msgid "``ACS_SBBS``" msgstr "" -#: ../src/Doc/library/curses.rst:1554 +#: library/curses.rst:1554 msgid "alternate name for lower right corner" msgstr "" -#: ../src/Doc/library/curses.rst:1556 +#: library/curses.rst:1556 msgid "``ACS_SBSB``" msgstr "" -#: ../src/Doc/library/curses.rst:1556 +#: library/curses.rst:1556 msgid "alternate name for vertical line" msgstr "" -#: ../src/Doc/library/curses.rst:1558 +#: library/curses.rst:1558 msgid "``ACS_SBSS``" msgstr "" -#: ../src/Doc/library/curses.rst:1558 +#: library/curses.rst:1558 msgid "alternate name for right tee" msgstr "" -#: ../src/Doc/library/curses.rst:1560 +#: library/curses.rst:1560 msgid "``ACS_SSBB``" msgstr "" -#: ../src/Doc/library/curses.rst:1560 +#: library/curses.rst:1560 msgid "alternate name for lower left corner" msgstr "" -#: ../src/Doc/library/curses.rst:1562 +#: library/curses.rst:1562 msgid "``ACS_SSBS``" msgstr "" -#: ../src/Doc/library/curses.rst:1562 +#: library/curses.rst:1562 msgid "alternate name for bottom tee" msgstr "" -#: ../src/Doc/library/curses.rst:1564 +#: library/curses.rst:1564 msgid "``ACS_SSSB``" msgstr "" -#: ../src/Doc/library/curses.rst:1564 +#: library/curses.rst:1564 msgid "alternate name for left tee" msgstr "" -#: ../src/Doc/library/curses.rst:1566 +#: library/curses.rst:1566 msgid "``ACS_SSSS``" msgstr "" -#: ../src/Doc/library/curses.rst:1566 +#: library/curses.rst:1566 msgid "alternate name for crossover or big plus" msgstr "" -#: ../src/Doc/library/curses.rst:1568 +#: library/curses.rst:1568 msgid "``ACS_STERLING``" msgstr "" -#: ../src/Doc/library/curses.rst:1568 +#: library/curses.rst:1568 msgid "pound sterling" msgstr "" -#: ../src/Doc/library/curses.rst:1570 +#: library/curses.rst:1570 msgid "``ACS_TTEE``" msgstr "" -#: ../src/Doc/library/curses.rst:1570 +#: library/curses.rst:1570 msgid "top tee" msgstr "" -#: ../src/Doc/library/curses.rst:1572 +#: library/curses.rst:1572 msgid "``ACS_UARROW``" msgstr "" -#: ../src/Doc/library/curses.rst:1572 +#: library/curses.rst:1572 msgid "up arrow" msgstr "" -#: ../src/Doc/library/curses.rst:1574 +#: library/curses.rst:1574 msgid "``ACS_ULCORNER``" msgstr "" -#: ../src/Doc/library/curses.rst:1574 +#: library/curses.rst:1574 msgid "upper left corner" msgstr "" -#: ../src/Doc/library/curses.rst:1576 +#: library/curses.rst:1576 msgid "``ACS_URCORNER``" msgstr "" -#: ../src/Doc/library/curses.rst:1576 +#: library/curses.rst:1576 msgid "upper right corner" msgstr "" -#: ../src/Doc/library/curses.rst:1578 +#: library/curses.rst:1578 msgid "``ACS_VLINE``" msgstr "" -#: ../src/Doc/library/curses.rst:1578 +#: library/curses.rst:1578 msgid "vertical line" msgstr "" -#: ../src/Doc/library/curses.rst:1581 +#: library/curses.rst:1581 msgid "The following table lists the predefined colors:" msgstr "" -#: ../src/Doc/library/curses.rst:1584 +#: library/curses.rst:1584 msgid "Color" msgstr "" -#: ../src/Doc/library/curses.rst:1586 +#: library/curses.rst:1586 msgid "``COLOR_BLACK``" msgstr "" -#: ../src/Doc/library/curses.rst:1586 +#: library/curses.rst:1586 msgid "Black" msgstr "" -#: ../src/Doc/library/curses.rst:1588 +#: library/curses.rst:1588 msgid "``COLOR_BLUE``" msgstr "" -#: ../src/Doc/library/curses.rst:1588 +#: library/curses.rst:1588 msgid "Blue" msgstr "" -#: ../src/Doc/library/curses.rst:1590 +#: library/curses.rst:1590 msgid "``COLOR_CYAN``" msgstr "" -#: ../src/Doc/library/curses.rst:1590 +#: library/curses.rst:1590 msgid "Cyan (light greenish blue)" msgstr "" -#: ../src/Doc/library/curses.rst:1592 +#: library/curses.rst:1592 msgid "``COLOR_GREEN``" msgstr "" -#: ../src/Doc/library/curses.rst:1592 +#: library/curses.rst:1592 msgid "Green" msgstr "" -#: ../src/Doc/library/curses.rst:1594 +#: library/curses.rst:1594 msgid "``COLOR_MAGENTA``" msgstr "" -#: ../src/Doc/library/curses.rst:1594 +#: library/curses.rst:1594 msgid "Magenta (purplish red)" msgstr "" -#: ../src/Doc/library/curses.rst:1596 +#: library/curses.rst:1596 msgid "``COLOR_RED``" msgstr "" -#: ../src/Doc/library/curses.rst:1596 +#: library/curses.rst:1596 msgid "Red" msgstr "" -#: ../src/Doc/library/curses.rst:1598 +#: library/curses.rst:1598 msgid "``COLOR_WHITE``" msgstr "" -#: ../src/Doc/library/curses.rst:1598 +#: library/curses.rst:1598 msgid "White" msgstr "" -#: ../src/Doc/library/curses.rst:1600 +#: library/curses.rst:1600 msgid "``COLOR_YELLOW``" msgstr "" -#: ../src/Doc/library/curses.rst:1600 +#: library/curses.rst:1600 msgid "Yellow" msgstr "" -#: ../src/Doc/library/curses.rst:1605 +#: library/curses.rst:1605 msgid ":mod:`curses.textpad` --- Text input widget for curses programs" msgstr "" -#: ../src/Doc/library/curses.rst:1615 +#: library/curses.rst:1615 msgid "" "The :mod:`curses.textpad` module provides a :class:`Textbox` class that " "handles elementary text editing in a curses window, supporting a set of " @@ -24807,11 +24941,11 @@ msgid "" "purposes." msgstr "" -#: ../src/Doc/library/curses.rst:1621 +#: library/curses.rst:1621 msgid "The module :mod:`curses.textpad` defines the following function:" msgstr "" -#: ../src/Doc/library/curses.rst:1626 +#: library/curses.rst:1626 msgid "" "Draw a rectangle. The first argument must be a window object; the remaining " "arguments are coordinates relative to that window. The second and third " @@ -24823,15 +24957,15 @@ msgid "" "will be drawn with ASCII dashes, vertical bars, and plus signs." msgstr "" -#: ../src/Doc/library/curses.rst:1639 +#: library/curses.rst:1639 msgid "Textbox objects" msgstr "" -#: ../src/Doc/library/curses.rst:1641 +#: library/curses.rst:1641 msgid "You can instantiate a :class:`Textbox` object as follows:" msgstr "" -#: ../src/Doc/library/curses.rst:1646 +#: library/curses.rst:1646 msgid "" "Return a textbox widget object. The *win* argument should be a curses :" "class:`WindowObject` in which the textbox is to be contained. The edit " @@ -24840,12 +24974,12 @@ msgid "" "`stripspaces` flag is initially on." msgstr "" -#: ../src/Doc/library/curses.rst:1652 +#: library/curses.rst:1652 msgid ":class:`Textbox` objects have the following methods:" msgstr "" # a55d508e10f245bfae70c9c641324f41 -#: ../src/Doc/library/curses.rst:1657 +#: library/curses.rst:1657 msgid "" "This is the entry point you will normally use. It accepts editing " "keystrokes until one of the termination keystrokes is entered. If " @@ -24856,169 +24990,169 @@ msgid "" "`stripspaces` attribute." msgstr "" -#: ../src/Doc/library/curses.rst:1668 +#: library/curses.rst:1668 msgid "" "Process a single command keystroke. Here are the supported special " "keystrokes:" msgstr "" -#: ../src/Doc/library/curses.rst:1672 ../src/Doc/library/curses.rst:1710 +#: library/curses.rst:1672 library/curses.rst:1710 msgid "Keystroke" msgstr "" -#: ../src/Doc/library/curses.rst:1672 ../src/Doc/library/tarfile.rst:97 +#: library/curses.rst:1672 library/tarfile.rst:97 msgid "Action" msgstr "" -#: ../src/Doc/library/curses.rst:1674 +#: library/curses.rst:1674 msgid ":kbd:`Control-A`" msgstr "" -#: ../src/Doc/library/curses.rst:1674 +#: library/curses.rst:1674 msgid "Go to left edge of window." msgstr "" -#: ../src/Doc/library/curses.rst:1676 ../src/Doc/library/curses.rst:1712 +#: library/curses.rst:1676 library/curses.rst:1712 msgid ":kbd:`Control-B`" msgstr "" -#: ../src/Doc/library/curses.rst:1676 +#: library/curses.rst:1676 msgid "Cursor left, wrapping to previous line if appropriate." msgstr "" -#: ../src/Doc/library/curses.rst:1679 +#: library/curses.rst:1679 msgid ":kbd:`Control-D`" msgstr "" -#: ../src/Doc/library/curses.rst:1679 +#: library/curses.rst:1679 msgid "Delete character under cursor." msgstr "" -#: ../src/Doc/library/curses.rst:1681 +#: library/curses.rst:1681 msgid ":kbd:`Control-E`" msgstr "" -#: ../src/Doc/library/curses.rst:1681 +#: library/curses.rst:1681 msgid "Go to right edge (stripspaces off) or end of line (stripspaces on)." msgstr "" -#: ../src/Doc/library/curses.rst:1684 ../src/Doc/library/curses.rst:1714 +#: library/curses.rst:1684 library/curses.rst:1714 msgid ":kbd:`Control-F`" msgstr "" -#: ../src/Doc/library/curses.rst:1684 +#: library/curses.rst:1684 msgid "Cursor right, wrapping to next line when appropriate." msgstr "" -#: ../src/Doc/library/curses.rst:1687 +#: library/curses.rst:1687 msgid ":kbd:`Control-G`" msgstr "" -#: ../src/Doc/library/curses.rst:1687 +#: library/curses.rst:1687 msgid "Terminate, returning the window contents." msgstr "" -#: ../src/Doc/library/curses.rst:1689 +#: library/curses.rst:1689 msgid ":kbd:`Control-H`" msgstr "" -#: ../src/Doc/library/curses.rst:1689 +#: library/curses.rst:1689 msgid "Delete character backward." msgstr "" -#: ../src/Doc/library/curses.rst:1691 +#: library/curses.rst:1691 msgid ":kbd:`Control-J`" msgstr "" -#: ../src/Doc/library/curses.rst:1691 +#: library/curses.rst:1691 msgid "Terminate if the window is 1 line, otherwise insert newline." msgstr "" -#: ../src/Doc/library/curses.rst:1694 +#: library/curses.rst:1694 msgid ":kbd:`Control-K`" msgstr "" -#: ../src/Doc/library/curses.rst:1694 +#: library/curses.rst:1694 msgid "If line is blank, delete it, otherwise clear to end of line." msgstr "" -#: ../src/Doc/library/curses.rst:1697 +#: library/curses.rst:1697 msgid ":kbd:`Control-L`" msgstr "" -#: ../src/Doc/library/curses.rst:1697 +#: library/curses.rst:1697 msgid "Refresh screen." msgstr "" -#: ../src/Doc/library/curses.rst:1699 ../src/Doc/library/curses.rst:1718 +#: library/curses.rst:1699 library/curses.rst:1718 msgid ":kbd:`Control-N`" msgstr "" -#: ../src/Doc/library/curses.rst:1699 +#: library/curses.rst:1699 msgid "Cursor down; move down one line." msgstr "" -#: ../src/Doc/library/curses.rst:1701 +#: library/curses.rst:1701 msgid ":kbd:`Control-O`" msgstr "" -#: ../src/Doc/library/curses.rst:1701 +#: library/curses.rst:1701 msgid "Insert a blank line at cursor location." msgstr "" -#: ../src/Doc/library/curses.rst:1703 ../src/Doc/library/curses.rst:1716 +#: library/curses.rst:1703 library/curses.rst:1716 msgid ":kbd:`Control-P`" msgstr "" -#: ../src/Doc/library/curses.rst:1703 +#: library/curses.rst:1703 msgid "Cursor up; move up one line." msgstr "" -#: ../src/Doc/library/curses.rst:1706 +#: library/curses.rst:1706 msgid "" "Move operations do nothing if the cursor is at an edge where the movement is " "not possible. The following synonyms are supported where possible:" msgstr "" -#: ../src/Doc/library/curses.rst:1712 +#: library/curses.rst:1712 msgid ":const:`KEY_LEFT`" msgstr "" -#: ../src/Doc/library/curses.rst:1714 +#: library/curses.rst:1714 msgid ":const:`KEY_RIGHT`" msgstr "" -#: ../src/Doc/library/curses.rst:1716 +#: library/curses.rst:1716 msgid ":const:`KEY_UP`" msgstr "" -#: ../src/Doc/library/curses.rst:1718 +#: library/curses.rst:1718 msgid ":const:`KEY_DOWN`" msgstr "" -#: ../src/Doc/library/curses.rst:1720 +#: library/curses.rst:1720 msgid ":const:`KEY_BACKSPACE`" msgstr "" -#: ../src/Doc/library/curses.rst:1720 +#: library/curses.rst:1720 msgid ":kbd:`Control-h`" msgstr "" -#: ../src/Doc/library/curses.rst:1723 +#: library/curses.rst:1723 msgid "" "All other keystrokes are treated as a command to insert the given character " "and move right (with line wrapping)." msgstr "" # 3810c7e54ca84826a4327d76de07d896 -#: ../src/Doc/library/curses.rst:1729 +#: library/curses.rst:1729 msgid "" "Return the window contents as a string; whether blanks in the window are " "included is affected by the :attr:`stripspaces` member." msgstr "" # ab9640d03c6241dd84595096189ed017 -#: ../src/Doc/library/curses.rst:1735 +#: library/curses.rst:1735 msgid "" "This attribute is a flag which controls the interpretation of blanks in the " "window. When it is on, trailing blanks on each line are ignored; any cursor " @@ -25027,395 +25161,394 @@ msgid "" "are gathered." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:3 +#: library/curses.ascii.rst:3 msgid ":mod:`curses.ascii` --- Utilities for ASCII characters" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:13 +#: library/curses.ascii.rst:13 msgid "" "The :mod:`curses.ascii` module supplies name constants for ASCII characters " "and functions to test membership in various ASCII character classes. The " "constants supplied are names for control characters as follows:" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:18 ../src/Doc/library/fl.rst:352 -#: ../src/Doc/library/fl.rst:430 ../src/Doc/library/turtle.rst:2179 -#: ../src/Doc/library/xmlrpclib.rst:79 +#: library/curses.ascii.rst:18 library/fl.rst:352 library/fl.rst:430 +#: library/turtle.rst:2179 library/xmlrpclib.rst:80 msgid "Name" msgstr "Nom" -#: ../src/Doc/library/curses.ascii.rst:20 +#: library/curses.ascii.rst:20 msgid ":const:`NUL`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:22 +#: library/curses.ascii.rst:22 msgid ":const:`SOH`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:22 +#: library/curses.ascii.rst:22 msgid "Start of heading, console interrupt" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:24 +#: library/curses.ascii.rst:24 msgid ":const:`STX`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:24 +#: library/curses.ascii.rst:24 msgid "Start of text" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:26 +#: library/curses.ascii.rst:26 msgid ":const:`ETX`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:26 +#: library/curses.ascii.rst:26 msgid "End of text" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:28 +#: library/curses.ascii.rst:28 msgid ":const:`EOT`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:28 +#: library/curses.ascii.rst:28 msgid "End of transmission" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:30 +#: library/curses.ascii.rst:30 msgid ":const:`ENQ`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:30 +#: library/curses.ascii.rst:30 msgid "Enquiry, goes with :const:`ACK` flow control" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:32 +#: library/curses.ascii.rst:32 msgid ":const:`ACK`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:32 +#: library/curses.ascii.rst:32 msgid "Acknowledgement" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:34 +#: library/curses.ascii.rst:34 msgid ":const:`BEL`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:34 +#: library/curses.ascii.rst:34 msgid "Bell" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:36 +#: library/curses.ascii.rst:36 msgid ":const:`BS`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:36 +#: library/curses.ascii.rst:36 msgid "Backspace" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:38 +#: library/curses.ascii.rst:38 msgid ":const:`TAB`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:38 +#: library/curses.ascii.rst:38 msgid "Tab" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:40 +#: library/curses.ascii.rst:40 msgid ":const:`HT`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:40 +#: library/curses.ascii.rst:40 msgid "Alias for :const:`TAB`: \"Horizontal tab\"" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:42 +#: library/curses.ascii.rst:42 msgid ":const:`LF`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:42 +#: library/curses.ascii.rst:42 msgid "Line feed" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:44 +#: library/curses.ascii.rst:44 msgid ":const:`NL`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:44 +#: library/curses.ascii.rst:44 msgid "Alias for :const:`LF`: \"New line\"" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:46 +#: library/curses.ascii.rst:46 msgid ":const:`VT`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:46 +#: library/curses.ascii.rst:46 msgid "Vertical tab" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:48 +#: library/curses.ascii.rst:48 msgid ":const:`FF`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:48 +#: library/curses.ascii.rst:48 msgid "Form feed" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:50 +#: library/curses.ascii.rst:50 msgid ":const:`CR`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:50 +#: library/curses.ascii.rst:50 msgid "Carriage return" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:52 +#: library/curses.ascii.rst:52 msgid ":const:`SO`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:52 +#: library/curses.ascii.rst:52 msgid "Shift-out, begin alternate character set" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:54 +#: library/curses.ascii.rst:54 msgid ":const:`SI`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:54 +#: library/curses.ascii.rst:54 msgid "Shift-in, resume default character set" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:56 +#: library/curses.ascii.rst:56 msgid ":const:`DLE`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:56 +#: library/curses.ascii.rst:56 msgid "Data-link escape" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:58 +#: library/curses.ascii.rst:58 msgid ":const:`DC1`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:58 +#: library/curses.ascii.rst:58 msgid "XON, for flow control" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:60 +#: library/curses.ascii.rst:60 msgid ":const:`DC2`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:60 +#: library/curses.ascii.rst:60 msgid "Device control 2, block-mode flow control" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:62 +#: library/curses.ascii.rst:62 msgid ":const:`DC3`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:62 +#: library/curses.ascii.rst:62 msgid "XOFF, for flow control" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:64 +#: library/curses.ascii.rst:64 msgid ":const:`DC4`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:64 +#: library/curses.ascii.rst:64 msgid "Device control 4" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:66 +#: library/curses.ascii.rst:66 msgid ":const:`NAK`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:66 +#: library/curses.ascii.rst:66 msgid "Negative acknowledgement" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:68 +#: library/curses.ascii.rst:68 msgid ":const:`SYN`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:68 +#: library/curses.ascii.rst:68 msgid "Synchronous idle" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:70 +#: library/curses.ascii.rst:70 msgid ":const:`ETB`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:70 +#: library/curses.ascii.rst:70 msgid "End transmission block" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:72 +#: library/curses.ascii.rst:72 msgid ":const:`CAN`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:74 +#: library/curses.ascii.rst:74 msgid ":const:`EM`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:74 +#: library/curses.ascii.rst:74 msgid "End of medium" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:76 +#: library/curses.ascii.rst:76 msgid ":const:`SUB`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:76 +#: library/curses.ascii.rst:76 msgid "Substitute" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:78 +#: library/curses.ascii.rst:78 msgid ":const:`ESC`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:78 +#: library/curses.ascii.rst:78 msgid "Escape" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:80 +#: library/curses.ascii.rst:80 msgid ":const:`FS`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:80 +#: library/curses.ascii.rst:80 msgid "File separator" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:82 +#: library/curses.ascii.rst:82 msgid ":const:`GS`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:82 +#: library/curses.ascii.rst:82 msgid "Group separator" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:84 +#: library/curses.ascii.rst:84 msgid ":const:`RS`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:84 +#: library/curses.ascii.rst:84 msgid "Record separator, block-mode terminator" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:86 +#: library/curses.ascii.rst:86 msgid ":const:`US`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:86 +#: library/curses.ascii.rst:86 msgid "Unit separator" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:88 +#: library/curses.ascii.rst:88 msgid ":const:`SP`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:88 +#: library/curses.ascii.rst:88 msgid "Space" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:90 +#: library/curses.ascii.rst:90 msgid ":const:`DEL`" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:90 +#: library/curses.ascii.rst:90 msgid "Delete" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:93 +#: library/curses.ascii.rst:93 msgid "" "Note that many of these have little practical significance in modern usage. " "The mnemonics derive from teleprinter conventions that predate digital " "computers." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:96 +#: library/curses.ascii.rst:96 msgid "" "The module supplies the following functions, patterned on those in the " "standard C library:" msgstr "" -#: ../src/Doc/library/curses.ascii.rst:102 +#: library/curses.ascii.rst:102 msgid "" "Checks for an ASCII alphanumeric character; it is equivalent to ``isalpha(c) " "or isdigit(c)``." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:108 +#: library/curses.ascii.rst:108 msgid "" "Checks for an ASCII alphabetic character; it is equivalent to ``isupper(c) " "or islower(c)``." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:114 +#: library/curses.ascii.rst:114 msgid "Checks for a character value that fits in the 7-bit ASCII set." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:119 +#: library/curses.ascii.rst:119 msgid "Checks for an ASCII whitespace character." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:124 +#: library/curses.ascii.rst:124 msgid "Checks for an ASCII control character (in the range 0x00 to 0x1f)." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:129 +#: library/curses.ascii.rst:129 msgid "" "Checks for an ASCII decimal digit, ``'0'`` through ``'9'``. This is " "equivalent to ``c in string.digits``." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:135 +#: library/curses.ascii.rst:135 msgid "Checks for ASCII any printable character except space." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:140 +#: library/curses.ascii.rst:140 msgid "Checks for an ASCII lower-case character." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:145 +#: library/curses.ascii.rst:145 msgid "Checks for any ASCII printable character including space." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:150 +#: library/curses.ascii.rst:150 msgid "" "Checks for any printable ASCII character which is not a space or an " "alphanumeric character." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:156 +#: library/curses.ascii.rst:156 msgid "" "Checks for ASCII white-space characters; space, line feed, carriage return, " "form feed, horizontal tab, vertical tab." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:162 +#: library/curses.ascii.rst:162 msgid "Checks for an ASCII uppercase letter." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:167 +#: library/curses.ascii.rst:167 msgid "" "Checks for an ASCII hexadecimal digit. This is equivalent to ``c in string." "hexdigits``." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:173 +#: library/curses.ascii.rst:173 msgid "Checks for an ASCII control character (ordinal values 0 to 31)." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:178 +#: library/curses.ascii.rst:178 msgid "Checks for a non-ASCII character (ordinal values 0x80 and above)." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:180 +#: library/curses.ascii.rst:180 msgid "" "These functions accept either integers or strings; when the argument is a " "string, it is first converted using the built-in function :func:`ord`." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:183 +#: library/curses.ascii.rst:183 msgid "" "Note that all these functions check ordinal bit values derived from the " "first character of the string you pass in; they do not actually know " @@ -25424,35 +25557,35 @@ msgid "" "see the :mod:`string` module." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:189 +#: library/curses.ascii.rst:189 msgid "" "The following two functions take either a single-character string or integer " "byte value; they return a value of the same type." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:195 +#: library/curses.ascii.rst:195 msgid "Return the ASCII value corresponding to the low 7 bits of *c*." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:200 +#: library/curses.ascii.rst:200 msgid "" "Return the control character corresponding to the given character (the " "character bit value is bitwise-anded with 0x1f)." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:206 +#: library/curses.ascii.rst:206 msgid "" "Return the 8-bit character corresponding to the given ASCII character (the " "character bit value is bitwise-ored with 0x80)." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:209 +#: library/curses.ascii.rst:209 msgid "" "The following function takes either a single-character string or integer " "value; it returns a string." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:215 +#: library/curses.ascii.rst:215 msgid "" "Return a string representation of the ASCII character *c*. If *c* is " "printable, this string is the character itself. If the character is a " @@ -25463,33 +25596,33 @@ msgid "" "``'!'`` prepended to the result." msgstr "" -#: ../src/Doc/library/curses.ascii.rst:225 +#: library/curses.ascii.rst:225 msgid "" "A 33-element string array that contains the ASCII mnemonics for the thirty-" "two ASCII control characters from 0 (NUL) to 0x1f (US), in order, plus the " "mnemonic ``SP`` for the space character." msgstr "" -#: ../src/Doc/library/curses.panel.rst:2 +#: library/curses.panel.rst:2 msgid ":mod:`curses.panel` --- A panel stack extension for curses" msgstr "" -#: ../src/Doc/library/curses.panel.rst:9 +#: library/curses.panel.rst:9 msgid "" "Panels are windows with the added feature of depth, so they can be stacked " "on top of each other, and only the visible portions of each window will be " "displayed. Panels can be added, moved up or down in the stack, and removed." msgstr "" -#: ../src/Doc/library/curses.panel.rst:19 +#: library/curses.panel.rst:19 msgid "The module :mod:`curses.panel` defines the following functions:" msgstr "" -#: ../src/Doc/library/curses.panel.rst:24 +#: library/curses.panel.rst:24 msgid "Returns the bottom panel in the panel stack." msgstr "" -#: ../src/Doc/library/curses.panel.rst:29 +#: library/curses.panel.rst:29 msgid "" "Returns a panel object, associating it with the given window *win*. Be aware " "that you need to keep the returned panel object referenced explicitly. If " @@ -25497,21 +25630,21 @@ msgid "" "stack." msgstr "" -#: ../src/Doc/library/curses.panel.rst:36 +#: library/curses.panel.rst:36 msgid "Returns the top panel in the panel stack." msgstr "" -#: ../src/Doc/library/curses.panel.rst:41 +#: library/curses.panel.rst:41 msgid "" "Updates the virtual screen after changes in the panel stack. This does not " "call :func:`curses.doupdate`, so you'll have to do this yourself." msgstr "" -#: ../src/Doc/library/curses.panel.rst:48 +#: library/curses.panel.rst:48 msgid "Panel Objects" msgstr "" -#: ../src/Doc/library/curses.panel.rst:50 +#: library/curses.panel.rst:50 msgid "" "Panel objects, as returned by :func:`new_panel` above, are windows with a " "stacking order. There's always a window associated with a panel which " @@ -25519,68 +25652,68 @@ msgid "" "window's depth in the panel stack." msgstr "" -#: ../src/Doc/library/curses.panel.rst:55 +#: library/curses.panel.rst:55 msgid "Panel objects have the following methods:" msgstr "" -#: ../src/Doc/library/curses.panel.rst:60 +#: library/curses.panel.rst:60 msgid "Returns the panel above the current panel." msgstr "" -#: ../src/Doc/library/curses.panel.rst:65 +#: library/curses.panel.rst:65 msgid "Returns the panel below the current panel." msgstr "" -#: ../src/Doc/library/curses.panel.rst:70 +#: library/curses.panel.rst:70 msgid "Push the panel to the bottom of the stack." msgstr "" -#: ../src/Doc/library/curses.panel.rst:75 +#: library/curses.panel.rst:75 msgid "Returns true if the panel is hidden (not visible), false otherwise." msgstr "" -#: ../src/Doc/library/curses.panel.rst:80 +#: library/curses.panel.rst:80 msgid "" "Hide the panel. This does not delete the object, it just makes the window on " "screen invisible." msgstr "" -#: ../src/Doc/library/curses.panel.rst:86 +#: library/curses.panel.rst:86 msgid "Move the panel to the screen coordinates ``(y, x)``." msgstr "" -#: ../src/Doc/library/curses.panel.rst:91 +#: library/curses.panel.rst:91 msgid "Change the window associated with the panel to the window *win*." msgstr "" -#: ../src/Doc/library/curses.panel.rst:96 +#: library/curses.panel.rst:96 msgid "" "Set the panel's user pointer to *obj*. This is used to associate an " "arbitrary piece of data with the panel, and can be any Python object." msgstr "" -#: ../src/Doc/library/curses.panel.rst:102 +#: library/curses.panel.rst:102 msgid "Display the panel (which might have been hidden)." msgstr "" -#: ../src/Doc/library/curses.panel.rst:107 +#: library/curses.panel.rst:107 msgid "Push panel to the top of the stack." msgstr "" -#: ../src/Doc/library/curses.panel.rst:112 +#: library/curses.panel.rst:112 msgid "" "Returns the user pointer for the panel. This might be any Python object." msgstr "" -#: ../src/Doc/library/curses.panel.rst:117 +#: library/curses.panel.rst:117 msgid "Returns the window object associated with the panel." msgstr "" -#: ../src/Doc/library/custominterp.rst:6 +#: library/custominterp.rst:6 msgid "Custom Python Interpreters" msgstr "" -#: ../src/Doc/library/custominterp.rst:8 +#: library/custominterp.rst:8 msgid "" "The modules described in this chapter allow writing interfaces similar to " "Python's interactive interpreter. If you want a Python interpreter that " @@ -25589,16 +25722,15 @@ msgid "" "used to support compiling a possibly-incomplete chunk of Python code.)" msgstr "" -#: ../src/Doc/library/custominterp.rst:14 ../src/Doc/library/frameworks.rst:12 -#: ../src/Doc/library/modules.rst:11 +#: library/custominterp.rst:14 library/frameworks.rst:12 library/modules.rst:11 msgid "The full list of modules described in this chapter is:" msgstr "" -#: ../src/Doc/library/datatypes.rst:6 +#: library/datatypes.rst:6 msgid "Data Types" msgstr "" -#: ../src/Doc/library/datatypes.rst:8 +#: library/datatypes.rst:8 msgid "" "The modules described in this chapter provide a variety of specialized data " "types such as dates and times, fixed-type arrays, heap queues, synchronized " @@ -25606,7 +25738,7 @@ msgid "" msgstr "" # 637e2528597e4e3491abbd2418ea7aa4 -#: ../src/Doc/library/datatypes.rst:12 +#: library/datatypes.rst:12 msgid "" "Python also provides some built-in data types, in particular, :class:" "`dict`, :class:`list`, :class:`set` (which along with :class:`frozenset`, " @@ -25615,16 +25747,16 @@ msgid "" "`unicode` class to handle Unicode text." msgstr "" -#: ../src/Doc/library/datatypes.rst:18 ../src/Doc/library/numeric.rst:15 +#: library/datatypes.rst:18 library/numeric.rst:15 msgid "The following modules are documented in this chapter:" msgstr "" -#: ../src/Doc/library/datetime.rst:2 +#: library/datetime.rst:2 msgid ":mod:`datetime` --- Basic date and time types" msgstr "" # 413f77a13d9f49df904069876f990626 -#: ../src/Doc/library/datetime.rst:14 +#: library/datetime.rst:14 msgid "" "The :mod:`datetime` module supplies classes for manipulating dates and times " "in both simple and complex ways. While date and time arithmetic is " @@ -25634,12 +25766,12 @@ msgid "" msgstr "" # 1700e0ee3b904b2183fca256bc460be5 -#: ../src/Doc/library/datetime.rst:20 +#: library/datetime.rst:20 msgid "There are two kinds of date and time objects: \"naive\" and \"aware\"." msgstr "" # adfcc177c647496f90eaa936510248e8 -#: ../src/Doc/library/datetime.rst:22 +#: library/datetime.rst:22 msgid "" "An aware object has sufficient knowledge of applicable algorithmic and " "political time adjustments, such as time zone and daylight saving time " @@ -25649,7 +25781,7 @@ msgid "" msgstr "" # c28b40bfe52645968928b9b9cf85305b -#: ../src/Doc/library/datetime.rst:28 +#: library/datetime.rst:28 msgid "" "A naive object does not contain enough information to unambiguously locate " "itself relative to other date/time objects. Whether a naive object " @@ -25661,7 +25793,7 @@ msgid "" msgstr "" # 964c77968eec405f95f584a99af2f8d1 -#: ../src/Doc/library/datetime.rst:35 +#: library/datetime.rst:35 msgid "" "For applications requiring aware objects, :class:`.datetime` and :class:`." "time` objects have an optional time zone information attribute, :attr:" @@ -25675,50 +25807,48 @@ msgid "" "no standard suitable for every application." msgstr "" -#: ../src/Doc/library/datetime.rst:46 +#: library/datetime.rst:46 msgid "The :mod:`datetime` module exports the following constants:" msgstr "" # c6c6c1728e1f40ba99cb73b133f528f8 -#: ../src/Doc/library/datetime.rst:50 +#: library/datetime.rst:50 msgid "" "The smallest year number allowed in a :class:`date` or :class:`.datetime` " "object. :const:`MINYEAR` is ``1``." msgstr "" # 2dd23e976c3042cd8d54c8861a66c204 -#: ../src/Doc/library/datetime.rst:56 +#: library/datetime.rst:56 msgid "" "The largest year number allowed in a :class:`date` or :class:`.datetime` " "object. :const:`MAXYEAR` is ``9999``." msgstr "" -# e4003aa21cbf4c0f8f956115108b6e70 -# da2c3e83147f4ed3b047d4f6fa0ccf07 -#: ../src/Doc/library/datetime.rst:62 ../src/Doc/library/time.rst:557 -msgid "Module :mod:`calendar`" +#: library/datetime.rst:63 library/time.rst:557 +msgid "Module calendar" msgstr "" -#: ../src/Doc/library/datetime.rst:63 +#: library/datetime.rst:63 msgid "General calendar related functions." msgstr "" -#: ../src/Doc/library/datetime.rst:66 +#: library/datetime.rst:66 msgid "Time access and conversions." msgstr "" -#: ../src/Doc/library/datetime.rst:70 +#: library/datetime.rst:70 msgid "Available Types" msgstr "" -#: ../src/Doc/library/datetime.rst:75 +#: library/datetime.rst:75 msgid "" "An idealized naive date, assuming the current Gregorian calendar always was, " "and always will be, in effect. Attributes: :attr:`year`, :attr:`month`, and :" "attr:`day`." msgstr "" -#: ../src/Doc/library/datetime.rst:83 +#: library/datetime.rst:83 msgid "" "An idealized time, independent of any particular day, assuming that every " "day has exactly 24\\*60\\*60 seconds (there is no notion of \"leap seconds\" " @@ -25726,7 +25856,7 @@ msgid "" "`microsecond`, and :attr:`tzinfo`." msgstr "" -#: ../src/Doc/library/datetime.rst:92 +#: library/datetime.rst:92 msgid "" "A combination of a date and a time. Attributes: :attr:`year`, :attr:" "`month`, :attr:`day`, :attr:`hour`, :attr:`minute`, :attr:`second`, :attr:" @@ -25734,14 +25864,14 @@ msgid "" msgstr "" # 96ee2776a90c4fd182710fd4205d654d -#: ../src/Doc/library/datetime.rst:100 +#: library/datetime.rst:100 msgid "" "A duration expressing the difference between two :class:`date`, :class:`." "time`, or :class:`.datetime` instances to microsecond resolution." msgstr "" # 649e0fd77a4d4d2494fa584493ac2ed0 -#: ../src/Doc/library/datetime.rst:106 +#: library/datetime.rst:106 msgid "" "An abstract base class for time zone information objects. These are used by " "the :class:`.datetime` and :class:`.time` classes to provide a customizable " @@ -25749,16 +25879,16 @@ msgid "" "daylight saving time)." msgstr "" -#: ../src/Doc/library/datetime.rst:111 +#: library/datetime.rst:111 msgid "Objects of these types are immutable." msgstr "" -#: ../src/Doc/library/datetime.rst:113 +#: library/datetime.rst:113 msgid "Objects of the :class:`date` type are always naive." msgstr "" # f909e918d9a8491f8d8cbb525beaba28 -#: ../src/Doc/library/datetime.rst:115 +#: library/datetime.rst:115 msgid "" "An object of type :class:`.time` or :class:`.datetime` may be naive or " "aware. A :class:`.datetime` object *d* is aware if ``d.tzinfo`` is not " @@ -25769,74 +25899,74 @@ msgid "" "does not return ``None``. Otherwise, *t* is naive." msgstr "" -#: ../src/Doc/library/datetime.rst:123 +#: library/datetime.rst:123 msgid "" "The distinction between naive and aware doesn't apply to :class:`timedelta` " "objects." msgstr "" -#: ../src/Doc/library/datetime.rst:126 +#: library/datetime.rst:126 msgid "Subclass relationships::" msgstr "" -#: ../src/Doc/library/datetime.rst:139 +#: library/datetime.rst:139 msgid ":class:`timedelta` Objects" msgstr "" -#: ../src/Doc/library/datetime.rst:141 +#: library/datetime.rst:141 msgid "" "A :class:`timedelta` object represents a duration, the difference between " "two dates or times." msgstr "" # 6d1f6b68d1e54e5db8089e5dae7fe82a -#: ../src/Doc/library/datetime.rst:146 +#: library/datetime.rst:146 msgid "" "All arguments are optional and default to ``0``. Arguments may be ints, " "longs, or floats, and may be positive or negative." msgstr "" -#: ../src/Doc/library/datetime.rst:149 +#: library/datetime.rst:149 msgid "" "Only *days*, *seconds* and *microseconds* are stored internally. Arguments " "are converted to those units:" msgstr "" -#: ../src/Doc/library/datetime.rst:152 +#: library/datetime.rst:152 msgid "A millisecond is converted to 1000 microseconds." msgstr "" -#: ../src/Doc/library/datetime.rst:153 +#: library/datetime.rst:153 msgid "A minute is converted to 60 seconds." msgstr "" -#: ../src/Doc/library/datetime.rst:154 +#: library/datetime.rst:154 msgid "An hour is converted to 3600 seconds." msgstr "" -#: ../src/Doc/library/datetime.rst:155 +#: library/datetime.rst:155 msgid "A week is converted to 7 days." msgstr "" -#: ../src/Doc/library/datetime.rst:157 +#: library/datetime.rst:157 msgid "" "and days, seconds and microseconds are then normalized so that the " "representation is unique, with" msgstr "" -#: ../src/Doc/library/datetime.rst:160 +#: library/datetime.rst:160 msgid "``0 <= microseconds < 1000000``" msgstr "" -#: ../src/Doc/library/datetime.rst:161 +#: library/datetime.rst:161 msgid "``0 <= seconds < 3600*24`` (the number of seconds in one day)" msgstr "" -#: ../src/Doc/library/datetime.rst:162 +#: library/datetime.rst:162 msgid "``-999999999 <= days <= 999999999``" msgstr "" -#: ../src/Doc/library/datetime.rst:164 +#: library/datetime.rst:164 msgid "" "If any argument is a float and there are fractional microseconds, the " "fractional microseconds left over from all arguments are combined and their " @@ -25844,224 +25974,217 @@ msgid "" "conversion and normalization processes are exact (no information is lost)." msgstr "" -#: ../src/Doc/library/datetime.rst:169 +#: library/datetime.rst:169 msgid "" "If the normalized value of days lies outside the indicated range, :exc:" "`OverflowError` is raised." msgstr "" -#: ../src/Doc/library/datetime.rst:172 +#: library/datetime.rst:172 msgid "" "Note that normalization of negative values may be surprising at first. For " "example," msgstr "" -#: ../src/Doc/library/datetime.rst:181 +#: library/datetime.rst:181 msgid "Class attributes are:" msgstr "" -#: ../src/Doc/library/datetime.rst:185 +#: library/datetime.rst:185 msgid "The most negative :class:`timedelta` object, ``timedelta(-999999999)``." msgstr "" -#: ../src/Doc/library/datetime.rst:190 +#: library/datetime.rst:190 msgid "" "The most positive :class:`timedelta` object, ``timedelta(days=999999999, " "hours=23, minutes=59, seconds=59, microseconds=999999)``." msgstr "" -#: ../src/Doc/library/datetime.rst:196 +#: library/datetime.rst:196 msgid "" "The smallest possible difference between non-equal :class:`timedelta` " "objects, ``timedelta(microseconds=1)``." msgstr "" -#: ../src/Doc/library/datetime.rst:199 +#: library/datetime.rst:199 msgid "" "Note that, because of normalization, ``timedelta.max`` > ``-timedelta.min``. " "``-timedelta.max`` is not representable as a :class:`timedelta` object." msgstr "" -#: ../src/Doc/library/datetime.rst:202 ../src/Doc/library/datetime.rst:405 -#: ../src/Doc/library/datetime.rst:760 ../src/Doc/library/datetime.rst:1212 +#: library/datetime.rst:202 library/datetime.rst:405 library/datetime.rst:760 +#: library/datetime.rst:1212 msgid "Instance attributes (read-only):" msgstr "" -#: ../src/Doc/library/datetime.rst:207 +#: library/datetime.rst:207 msgid "``days``" msgstr "" -#: ../src/Doc/library/datetime.rst:207 +#: library/datetime.rst:207 msgid "Between -999999999 and 999999999 inclusive" msgstr "" -#: ../src/Doc/library/datetime.rst:209 +#: library/datetime.rst:209 msgid "``seconds``" msgstr "" -#: ../src/Doc/library/datetime.rst:209 +#: library/datetime.rst:209 msgid "Between 0 and 86399 inclusive" msgstr "" -#: ../src/Doc/library/datetime.rst:211 +#: library/datetime.rst:211 msgid "``microseconds``" msgstr "" -#: ../src/Doc/library/datetime.rst:211 +#: library/datetime.rst:211 msgid "Between 0 and 999999 inclusive" msgstr "" -#: ../src/Doc/library/datetime.rst:214 ../src/Doc/library/datetime.rst:422 -#: ../src/Doc/library/datetime.rst:803 ../src/Doc/library/datetime.rst:1240 +#: library/datetime.rst:214 library/datetime.rst:422 library/datetime.rst:803 +#: library/datetime.rst:1240 msgid "Supported operations:" msgstr "" -#: ../src/Doc/library/datetime.rst:219 ../src/Doc/library/datetime.rst:425 -#: ../src/Doc/library/datetime.rst:806 ../src/Doc/library/operator.rst:616 -#: ../src/Doc/library/sets.rst:77 ../src/Doc/library/sets.rst:138 -#: ../src/Doc/library/sets.rst:147 ../src/Doc/library/stdtypes.rst:95 -#: ../src/Doc/library/stdtypes.rst:153 ../src/Doc/library/stdtypes.rst:299 -#: ../src/Doc/library/stdtypes.rst:397 ../src/Doc/library/stdtypes.rst:439 -#: ../src/Doc/library/stdtypes.rst:728 ../src/Doc/library/stdtypes.rst:1593 +#: library/datetime.rst:219 library/datetime.rst:425 library/datetime.rst:806 +#: library/operator.rst:616 library/sets.rst:77 library/sets.rst:138 +#: library/sets.rst:147 library/stdtypes.rst:95 library/stdtypes.rst:153 +#: library/stdtypes.rst:299 library/stdtypes.rst:397 library/stdtypes.rst:439 +#: library/stdtypes.rst:728 library/stdtypes.rst:1596 msgid "Operation" msgstr "" -#: ../src/Doc/library/datetime.rst:219 ../src/Doc/library/datetime.rst:425 -#: ../src/Doc/library/datetime.rst:806 ../src/Doc/library/sets.rst:77 -#: ../src/Doc/library/sets.rst:138 ../src/Doc/library/sets.rst:147 -#: ../src/Doc/library/stdtypes.rst:95 ../src/Doc/library/stdtypes.rst:299 -#: ../src/Doc/library/stdtypes.rst:397 ../src/Doc/library/stdtypes.rst:439 -#: ../src/Doc/library/stdtypes.rst:728 ../src/Doc/library/stdtypes.rst:1593 +#: library/datetime.rst:219 library/datetime.rst:425 library/datetime.rst:806 +#: library/sets.rst:77 library/sets.rst:138 library/sets.rst:147 +#: library/stdtypes.rst:95 library/stdtypes.rst:299 library/stdtypes.rst:397 +#: library/stdtypes.rst:439 library/stdtypes.rst:728 library/stdtypes.rst:1596 msgid "Result" msgstr "" -#: ../src/Doc/library/datetime.rst:221 +#: library/datetime.rst:221 msgid "``t1 = t2 + t3``" msgstr "" -#: ../src/Doc/library/datetime.rst:221 +#: library/datetime.rst:221 msgid "" "Sum of *t2* and *t3*. Afterwards *t1*-*t2* == *t3* and *t1*-*t3* == *t2* are " "true. (1)" msgstr "" -#: ../src/Doc/library/datetime.rst:224 +#: library/datetime.rst:224 msgid "``t1 = t2 - t3``" msgstr "" -#: ../src/Doc/library/datetime.rst:224 +#: library/datetime.rst:224 msgid "" "Difference of *t2* and *t3*. Afterwards *t1* == *t2* - *t3* and *t2* == *t1* " "+ *t3* are true. (1)" msgstr "" -#: ../src/Doc/library/datetime.rst:228 +#: library/datetime.rst:228 msgid "``t1 = t2 * i or t1 = i * t2``" msgstr "" # 6d0d4e75585b491492d030876af11168 -#: ../src/Doc/library/datetime.rst:228 +#: library/datetime.rst:228 msgid "" "Delta multiplied by an integer or long. Afterwards *t1* // i == *t2* is " "true, provided ``i != 0``." msgstr "" -#: ../src/Doc/library/datetime.rst:232 +#: library/datetime.rst:232 msgid "In general, *t1* \\* i == *t1* \\* (i-1) + *t1* is true. (1)" msgstr "" # dfeaf6688f2f4aebad16f58ad2f5c7a9 -#: ../src/Doc/library/datetime.rst:235 +#: library/datetime.rst:235 msgid "``t1 = t2 // i``" msgstr "" # 008306c39a3844f5bf51216413b7675c -#: ../src/Doc/library/datetime.rst:235 +#: library/datetime.rst:235 msgid "The floor is computed and the remainder (if any) is thrown away. (3)" msgstr "" -#: ../src/Doc/library/datetime.rst:238 +#: library/datetime.rst:238 msgid "``+t1``" msgstr "" -#: ../src/Doc/library/datetime.rst:238 +#: library/datetime.rst:238 msgid "Returns a :class:`timedelta` object with the same value. (2)" msgstr "" -#: ../src/Doc/library/datetime.rst:241 +#: library/datetime.rst:241 msgid "``-t1``" msgstr "" -#: ../src/Doc/library/datetime.rst:241 +#: library/datetime.rst:241 msgid "" "equivalent to :class:`timedelta`\\ (-*t1.days*, -*t1.seconds*, -*t1." "microseconds*), and to *t1*\\* -1. (1)(4)" msgstr "" -#: ../src/Doc/library/datetime.rst:245 +#: library/datetime.rst:245 msgid "``abs(t)``" msgstr "" -#: ../src/Doc/library/datetime.rst:245 +#: library/datetime.rst:245 msgid "" "equivalent to +\\ *t* when ``t.days >= 0``, and to -*t* when ``t.days < 0``. " "(2)" msgstr "" # 56c958bc975247e6b3c7da825740579f -#: ../src/Doc/library/datetime.rst:248 +#: library/datetime.rst:248 msgid "``str(t)``" msgstr "" # 1a046c3da5de4c53ba08af9b74a17253 -#: ../src/Doc/library/datetime.rst:248 +#: library/datetime.rst:248 msgid "" "Returns a string in the form ``[D day[s], ][H]H:MM:SS[.UUUUUU]``, where D is " "negative for negative ``t``. (5)" msgstr "" # 2fa84babf68c45c585ed6806fe2e75c2 -#: ../src/Doc/library/datetime.rst:252 +#: library/datetime.rst:252 msgid "``repr(t)``" msgstr "" # ee1c9604b1094c86a9727e61ce837574 -#: ../src/Doc/library/datetime.rst:252 +#: library/datetime.rst:252 msgid "" "Returns a string in the form ``datetime.timedelta(D[, S[, U]])``, where D is " "negative for negative ``t``. (5)" msgstr "" -#: ../src/Doc/library/datetime.rst:257 ../src/Doc/library/datetime.rst:439 -#: ../src/Doc/library/datetime.rst:1716 ../src/Doc/library/posixfile.rst:171 -#: ../src/Doc/library/stdtypes.rst:112 ../src/Doc/library/stdtypes.rst:172 -#: ../src/Doc/library/stdtypes.rst:345 ../src/Doc/library/stdtypes.rst:457 -#: ../src/Doc/library/stdtypes.rst:782 ../src/Doc/library/stdtypes.rst:1485 -#: ../src/Doc/library/stdtypes.rst:1637 ../src/Doc/library/struct.rst:140 -#: ../src/Doc/library/struct.rst:206 ../src/Doc/library/subprocess.rst:748 -#: ../src/Doc/library/time.rst:334 ../src/Doc/library/tkinter.rst:240 -#: ../src/Doc/library/ttk.rst:809 ../src/Doc/library/webbrowser.rst:148 +#: library/datetime.rst:257 library/datetime.rst:439 library/datetime.rst:1716 +#: library/posixfile.rst:171 library/stdtypes.rst:112 library/stdtypes.rst:172 +#: library/stdtypes.rst:345 library/stdtypes.rst:457 library/stdtypes.rst:782 +#: library/stdtypes.rst:1488 library/stdtypes.rst:1643 library/struct.rst:140 +#: library/struct.rst:206 library/subprocess.rst:748 library/time.rst:333 +#: library/tkinter.rst:240 library/ttk.rst:809 library/webbrowser.rst:148 msgid "Notes:" msgstr "Notes : " -#: ../src/Doc/library/datetime.rst:260 +#: library/datetime.rst:260 msgid "This is exact, but may overflow." msgstr "" -#: ../src/Doc/library/datetime.rst:263 +#: library/datetime.rst:263 msgid "This is exact, and cannot overflow." msgstr "" -#: ../src/Doc/library/datetime.rst:266 +#: library/datetime.rst:266 msgid "Division by 0 raises :exc:`ZeroDivisionError`." msgstr "" -#: ../src/Doc/library/datetime.rst:269 +#: library/datetime.rst:269 msgid "-*timedelta.max* is not representable as a :class:`timedelta` object." msgstr "" # e94e2eb2fc084088902e9edb54aea1ff -#: ../src/Doc/library/datetime.rst:272 +#: library/datetime.rst:272 msgid "" "String representations of :class:`timedelta` objects are normalized " "similarly to their internal representation. This leads to somewhat unusual " @@ -26069,14 +26192,14 @@ msgid "" msgstr "" # 1e33775dc30b4657b31f533eec47d497 -#: ../src/Doc/library/datetime.rst:281 +#: library/datetime.rst:281 msgid "" "In addition to the operations listed above :class:`timedelta` objects " "support certain additions and subtractions with :class:`date` and :class:`." "datetime` objects (see below)." msgstr "" -#: ../src/Doc/library/datetime.rst:285 +#: library/datetime.rst:285 msgid "" "Comparisons of :class:`timedelta` objects are supported with the :class:" "`timedelta` object representing the smaller duration considered to be the " @@ -26087,7 +26210,7 @@ msgid "" "const:`False` or :const:`True`, respectively." msgstr "" -#: ../src/Doc/library/datetime.rst:293 +#: library/datetime.rst:293 msgid "" ":class:`timedelta` objects are :term:`hashable` (usable as dictionary keys), " "support efficient pickling, and in Boolean contexts, a :class:`timedelta` " @@ -26095,34 +26218,34 @@ msgid "" "``timedelta(0)``." msgstr "" -#: ../src/Doc/library/datetime.rst:297 ../src/Doc/library/datetime.rst:472 -#: ../src/Doc/library/datetime.rst:875 ../src/Doc/library/datetime.rst:1263 +#: library/datetime.rst:297 library/datetime.rst:472 library/datetime.rst:875 +#: library/datetime.rst:1263 msgid "Instance methods:" msgstr "" # 90e0d8c9d8454567bc1007193d0fefdc -#: ../src/Doc/library/datetime.rst:301 +#: library/datetime.rst:301 msgid "" "Return the total number of seconds contained in the duration. Equivalent to " "``(td.microseconds + (td.seconds + td.days * 24 * 3600) * 10**6) / 10**6`` " "computed with true division enabled." msgstr "" -#: ../src/Doc/library/datetime.rst:305 +#: library/datetime.rst:305 msgid "" "Note that for very large time intervals (greater than 270 years on most " "platforms) this method will lose microsecond accuracy." msgstr "" -#: ../src/Doc/library/datetime.rst:311 +#: library/datetime.rst:311 msgid "Example usage:" msgstr "" -#: ../src/Doc/library/datetime.rst:337 +#: library/datetime.rst:337 msgid ":class:`date` Objects" msgstr "" -#: ../src/Doc/library/datetime.rst:339 +#: library/datetime.rst:339 msgid "" "A :class:`date` object represents a date (year, month and day) in an " "idealized calendar, the current Gregorian calendar indefinitely extended in " @@ -26135,41 +26258,41 @@ msgid "" msgstr "" # 8e6cd335791a4d7ea61f13d75576255b -#: ../src/Doc/library/datetime.rst:351 +#: library/datetime.rst:351 msgid "" "All arguments are required. Arguments may be ints or longs, in the " "following ranges:" msgstr "" -#: ../src/Doc/library/datetime.rst:354 ../src/Doc/library/datetime.rst:639 +#: library/datetime.rst:354 library/datetime.rst:639 msgid "``MINYEAR <= year <= MAXYEAR``" msgstr "" -#: ../src/Doc/library/datetime.rst:355 ../src/Doc/library/datetime.rst:640 +#: library/datetime.rst:355 library/datetime.rst:640 msgid "``1 <= month <= 12``" msgstr "" -#: ../src/Doc/library/datetime.rst:356 ../src/Doc/library/datetime.rst:641 +#: library/datetime.rst:356 library/datetime.rst:641 msgid "``1 <= day <= number of days in the given month and year``" msgstr "" -#: ../src/Doc/library/datetime.rst:358 ../src/Doc/library/datetime.rst:647 +#: library/datetime.rst:358 library/datetime.rst:647 msgid "" "If an argument outside those ranges is given, :exc:`ValueError` is raised." msgstr "" -#: ../src/Doc/library/datetime.rst:361 ../src/Doc/library/datetime.rst:649 +#: library/datetime.rst:361 library/datetime.rst:649 msgid "Other constructors, all class methods:" msgstr "" -#: ../src/Doc/library/datetime.rst:365 +#: library/datetime.rst:365 msgid "" "Return the current local date. This is equivalent to ``date." "fromtimestamp(time.time())``." msgstr "" # 6a30f7d5c9b9420cb7046c098f943151 -#: ../src/Doc/library/datetime.rst:371 +#: library/datetime.rst:371 msgid "" "Return the local date corresponding to the POSIX timestamp, such as is " "returned by :func:`time.time`. This may raise :exc:`ValueError`, if the " @@ -26180,7 +26303,7 @@ msgid "" "`fromtimestamp`." msgstr "" -#: ../src/Doc/library/datetime.rst:381 +#: library/datetime.rst:381 msgid "" "Return the date corresponding to the proleptic Gregorian ordinal, where " "January 1 of year 1 has ordinal 1. :exc:`ValueError` is raised unless ``1 " @@ -26188,83 +26311,79 @@ msgid "" "toordinal()) == d``." msgstr "" -#: ../src/Doc/library/datetime.rst:387 ../src/Doc/library/datetime.rst:740 -#: ../src/Doc/library/datetime.rst:1192 +#: library/datetime.rst:387 library/datetime.rst:740 library/datetime.rst:1192 msgid "Class attributes:" msgstr "" -#: ../src/Doc/library/datetime.rst:391 +#: library/datetime.rst:391 msgid "The earliest representable date, ``date(MINYEAR, 1, 1)``." msgstr "" -#: ../src/Doc/library/datetime.rst:396 +#: library/datetime.rst:396 msgid "The latest representable date, ``date(MAXYEAR, 12, 31)``." msgstr "" -#: ../src/Doc/library/datetime.rst:401 +#: library/datetime.rst:401 msgid "" "The smallest possible difference between non-equal date objects, " "``timedelta(days=1)``." msgstr "" -#: ../src/Doc/library/datetime.rst:409 ../src/Doc/library/datetime.rst:764 +#: library/datetime.rst:409 library/datetime.rst:764 msgid "Between :const:`MINYEAR` and :const:`MAXYEAR` inclusive." msgstr "" -#: ../src/Doc/library/datetime.rst:414 ../src/Doc/library/datetime.rst:769 +#: library/datetime.rst:414 library/datetime.rst:769 msgid "Between 1 and 12 inclusive." msgstr "" -#: ../src/Doc/library/datetime.rst:419 ../src/Doc/library/datetime.rst:774 +#: library/datetime.rst:419 library/datetime.rst:774 msgid "Between 1 and the number of days in the given month of the given year." msgstr "" -#: ../src/Doc/library/datetime.rst:427 +#: library/datetime.rst:427 msgid "``date2 = date1 + timedelta``" msgstr "" -#: ../src/Doc/library/datetime.rst:427 +#: library/datetime.rst:427 msgid "*date2* is ``timedelta.days`` days removed from *date1*. (1)" msgstr "" -#: ../src/Doc/library/datetime.rst:430 +#: library/datetime.rst:430 msgid "``date2 = date1 - timedelta``" msgstr "" -#: ../src/Doc/library/datetime.rst:430 +#: library/datetime.rst:430 msgid "Computes *date2* such that ``date2 + timedelta == date1``. (2)" msgstr "" -#: ../src/Doc/library/datetime.rst:433 +#: library/datetime.rst:433 msgid "``timedelta = date1 - date2``" msgstr "" -#: ../src/Doc/library/datetime.rst:433 ../src/Doc/library/datetime.rst:812 -#: ../src/Doc/library/datetime.rst:1668 ../src/Doc/library/stdtypes.rst:103 -#: ../src/Doc/library/stdtypes.rst:318 ../src/Doc/library/stdtypes.rst:742 -#: ../src/Doc/library/stdtypes.rst:1456 ../src/Doc/library/stdtypes.rst:1458 -#: ../src/Doc/library/stdtypes.rst:1460 ../src/Doc/library/stdtypes.rst:1462 -#: ../src/Doc/library/stdtypes.rst:1613 ../src/Doc/library/struct.rst:172 -#: ../src/Doc/library/struct.rst:174 ../src/Doc/library/struct.rst:178 -#: ../src/Doc/library/struct.rst:180 ../src/Doc/library/struct.rst:182 -#: ../src/Doc/library/struct.rst:184 ../src/Doc/library/struct.rst:186 -#: ../src/Doc/library/struct.rst:188 ../src/Doc/library/time.rst:297 -#: ../src/Doc/library/time.rst:308 ../src/Doc/library/webbrowser.rst:143 -#: ../src/Doc/library/webbrowser.rst:145 +#: library/datetime.rst:433 library/datetime.rst:812 library/datetime.rst:1668 +#: library/stdtypes.rst:103 library/stdtypes.rst:318 library/stdtypes.rst:742 +#: library/stdtypes.rst:1459 library/stdtypes.rst:1461 +#: library/stdtypes.rst:1463 library/stdtypes.rst:1465 +#: library/stdtypes.rst:1616 library/struct.rst:172 library/struct.rst:174 +#: library/struct.rst:178 library/struct.rst:180 library/struct.rst:182 +#: library/struct.rst:184 library/struct.rst:186 library/struct.rst:188 +#: library/time.rst:296 library/time.rst:307 library/webbrowser.rst:143 +#: library/webbrowser.rst:145 msgid "\\(3)" msgstr "\\(3)" -#: ../src/Doc/library/datetime.rst:435 +#: library/datetime.rst:435 msgid "``date1 < date2``" msgstr "" -#: ../src/Doc/library/datetime.rst:435 +#: library/datetime.rst:435 msgid "" "*date1* is considered less than *date2* when *date1* precedes *date2* in " "time. (4)" msgstr "" -#: ../src/Doc/library/datetime.rst:442 +#: library/datetime.rst:442 msgid "" "*date2* is moved forward in time if ``timedelta.days > 0``, or backward if " "``timedelta.days < 0``. Afterward ``date2 - date1 == timedelta.days``. " @@ -26273,20 +26392,20 @@ msgid "" "`MINYEAR` or larger than :const:`MAXYEAR`." msgstr "" -#: ../src/Doc/library/datetime.rst:449 +#: library/datetime.rst:449 msgid "" "This isn't quite equivalent to date1 + (-timedelta), because -timedelta in " "isolation can overflow in cases where date1 - timedelta does not. " "``timedelta.seconds`` and ``timedelta.microseconds`` are ignored." msgstr "" -#: ../src/Doc/library/datetime.rst:454 +#: library/datetime.rst:454 msgid "" "This is exact, and cannot overflow. timedelta.seconds and timedelta." "microseconds are 0, and date2 + timedelta == date1 after." msgstr "" -#: ../src/Doc/library/datetime.rst:458 +#: library/datetime.rst:458 msgid "" "In other words, ``date1 < date2`` if and only if ``date1.toordinal() < date2." "toordinal()``. In order to stop comparison from falling back to the default " @@ -26300,21 +26419,21 @@ msgid "" "const:`False` or :const:`True`, respectively." msgstr "" -#: ../src/Doc/library/datetime.rst:469 +#: library/datetime.rst:469 msgid "" "Dates can be used as dictionary keys. In Boolean contexts, all :class:`date` " "objects are considered to be true." msgstr "" # 880044f786c746aaaba665d1b01a57bf -#: ../src/Doc/library/datetime.rst:476 +#: library/datetime.rst:476 msgid "" "Return a date with the same value, except for those parameters given new " "values by whichever keyword arguments are specified. For example, if ``d == " "date(2002, 12, 31)``, then ``d.replace(day=26) == date(2002, 12, 26)``." msgstr "" -#: ../src/Doc/library/datetime.rst:483 +#: library/datetime.rst:483 msgid "" "Return a :class:`time.struct_time` such as returned by :func:`time." "localtime`. The hours, minutes and seconds are 0, and the DST flag is -1. " @@ -26324,40 +26443,40 @@ msgid "" "year starting with ``1`` for January 1st." msgstr "" -#: ../src/Doc/library/datetime.rst:493 +#: library/datetime.rst:493 msgid "" "Return the proleptic Gregorian ordinal of the date, where January 1 of year " "1 has ordinal 1. For any :class:`date` object *d*, ``date.fromordinal(d." "toordinal()) == d``." msgstr "" -#: ../src/Doc/library/datetime.rst:500 +#: library/datetime.rst:500 msgid "" "Return the day of the week as an integer, where Monday is 0 and Sunday is 6. " "For example, ``date(2002, 12, 4).weekday() == 2``, a Wednesday. See also :" "meth:`isoweekday`." msgstr "" -#: ../src/Doc/library/datetime.rst:507 +#: library/datetime.rst:507 msgid "" "Return the day of the week as an integer, where Monday is 1 and Sunday is 7. " "For example, ``date(2002, 12, 4).isoweekday() == 3``, a Wednesday. See also :" "meth:`weekday`, :meth:`isocalendar`." msgstr "" -#: ../src/Doc/library/datetime.rst:514 +#: library/datetime.rst:514 msgid "Return a 3-tuple, (ISO year, ISO week number, ISO weekday)." msgstr "" # 8da631a2bc894ca9b1b9ecb3f341ae14 -#: ../src/Doc/library/datetime.rst:516 +#: library/datetime.rst:516 msgid "" "The ISO calendar is a widely used variant of the Gregorian calendar. See " "http://www.staff.science.uu.nl/~gent0113/calendar/isocalendar.htm for a good " "explanation." msgstr "" -#: ../src/Doc/library/datetime.rst:520 +#: library/datetime.rst:520 msgid "" "The ISO year consists of 52 or 53 full weeks, and where a week starts on a " "Monday and ends on a Sunday. The first week of an ISO year is the first " @@ -26366,7 +26485,7 @@ msgid "" "Gregorian year." msgstr "" -#: ../src/Doc/library/datetime.rst:525 +#: library/datetime.rst:525 msgid "" "For example, 2004 begins on a Thursday, so the first week of ISO year 2004 " "begins on Monday, 29 Dec 2003 and ends on Sunday, 4 Jan 2004, so that " @@ -26374,18 +26493,18 @@ msgid "" "isocalendar() == (2004, 1, 7)``." msgstr "" -#: ../src/Doc/library/datetime.rst:533 +#: library/datetime.rst:533 msgid "" "Return a string representing the date in ISO 8601 format, 'YYYY-MM-DD'. For " "example, ``date(2002, 12, 4).isoformat() == '2002-12-04'``." msgstr "" -#: ../src/Doc/library/datetime.rst:539 +#: library/datetime.rst:539 msgid "For a date *d*, ``str(d)`` is equivalent to ``d.isoformat()``." msgstr "" # aff0a852efcd42e39b1e8b3069a8d14b -#: ../src/Doc/library/datetime.rst:544 +#: library/datetime.rst:544 msgid "" "Return a string representing the date, for example ``date(2002, 12, 4)." "ctime() == 'Wed Dec 4 00:00:00 2002'``. ``d.ctime()`` is equivalent to " @@ -26395,7 +26514,7 @@ msgid "" msgstr "" # 94ad86da97a246dc8948d53787c429a9 -#: ../src/Doc/library/datetime.rst:553 +#: library/datetime.rst:553 msgid "" "Return a string representing the date, controlled by an explicit format " "string. Format codes referring to hours, minutes or seconds will see 0 " @@ -26404,27 +26523,28 @@ msgid "" msgstr "" # cc4744aa4ae0465f908a7fba8766c390 -#: ../src/Doc/library/datetime.rst:561 +#: library/datetime.rst:561 msgid "" "Same as :meth:`.date.strftime`. This makes it possible to specify format " "string for a :class:`.date` object when using :meth:`str.format`. See " "section :ref:`strftime-strptime-behavior`." msgstr "" -#: ../src/Doc/library/datetime.rst:566 +#: library/datetime.rst:566 msgid "Example of counting days to an event::" msgstr "" -#: ../src/Doc/library/datetime.rst:584 +#: library/datetime.rst:584 msgid "Example of working with :class:`date`:" msgstr "" -#: ../src/Doc/library/datetime.rst:623 -msgid ":class:`datetime` Objects" -msgstr "" +#: library/datetime.rst:623 +#, fuzzy +msgid ":class:`.datetime` Objects" +msgstr "Objets DateTime" # 3ca37fc7a7c046a6a6c1bcda51bdbb69 -#: ../src/Doc/library/datetime.rst:625 +#: library/datetime.rst:625 msgid "" "A :class:`.datetime` object is a single object containing all the " "information from a :class:`date` object and a :class:`.time` object. Like " @@ -26433,35 +26553,35 @@ msgid "" "assumes there are exactly 3600\\*24 seconds in every day." msgstr "" -#: ../src/Doc/library/datetime.rst:631 +#: library/datetime.rst:631 msgid "Constructor:" msgstr "" # b258d8b2feb642549870f912237fcd86 -#: ../src/Doc/library/datetime.rst:635 +#: library/datetime.rst:635 msgid "" "The year, month and day arguments are required. *tzinfo* may be ``None``, " "or an instance of a :class:`tzinfo` subclass. The remaining arguments may " "be ints or longs, in the following ranges:" msgstr "" -#: ../src/Doc/library/datetime.rst:642 ../src/Doc/library/datetime.rst:1184 +#: library/datetime.rst:642 library/datetime.rst:1184 msgid "``0 <= hour < 24``" msgstr "" -#: ../src/Doc/library/datetime.rst:643 ../src/Doc/library/datetime.rst:1185 +#: library/datetime.rst:643 library/datetime.rst:1185 msgid "``0 <= minute < 60``" msgstr "" -#: ../src/Doc/library/datetime.rst:644 ../src/Doc/library/datetime.rst:1186 +#: library/datetime.rst:644 library/datetime.rst:1186 msgid "``0 <= second < 60``" msgstr "" -#: ../src/Doc/library/datetime.rst:645 +#: library/datetime.rst:645 msgid "``0 <= microsecond < 1000000``" msgstr "" -#: ../src/Doc/library/datetime.rst:653 +#: library/datetime.rst:653 msgid "" "Return the current local datetime, with :attr:`tzinfo` ``None``. This is " "equivalent to ``datetime.fromtimestamp(time.time())``. See also :meth:" @@ -26469,7 +26589,7 @@ msgid "" msgstr "" # e0f2e5f8763347faaaeee3b42325582c -#: ../src/Doc/library/datetime.rst:660 +#: library/datetime.rst:660 msgid "" "Return the current local date and time. If optional argument *tz* is " "``None`` or not specified, this is like :meth:`today`, but, if possible, " @@ -26478,7 +26598,7 @@ msgid "" "the C :c:func:`gettimeofday` function)." msgstr "" -#: ../src/Doc/library/datetime.rst:666 +#: library/datetime.rst:666 msgid "" "Else *tz* must be an instance of a class :class:`tzinfo` subclass, and the " "current date and time are converted to *tz*'s time zone. In this case the " @@ -26487,7 +26607,7 @@ msgid "" msgstr "" # eb0d3799f51a4bed9811018b717e8ce2 -#: ../src/Doc/library/datetime.rst:674 +#: library/datetime.rst:674 msgid "" "Return the current UTC date and time, with :attr:`tzinfo` ``None``. This is " "like :meth:`now`, but returns the current UTC date and time, as a naive :" @@ -26495,7 +26615,7 @@ msgid "" msgstr "" # ce179bec801d4e0aaa2141179c72757f -#: ../src/Doc/library/datetime.rst:681 +#: library/datetime.rst:681 msgid "" "Return the local date and time corresponding to the POSIX timestamp, such as " "is returned by :func:`time.time`. If optional argument *tz* is ``None`` or " @@ -26503,7 +26623,7 @@ msgid "" "time, and the returned :class:`.datetime` object is naive." msgstr "" -#: ../src/Doc/library/datetime.rst:686 +#: library/datetime.rst:686 msgid "" "Else *tz* must be an instance of a class :class:`tzinfo` subclass, and the " "timestamp is converted to *tz*'s time zone. In this case the result is " @@ -26512,7 +26632,7 @@ msgid "" msgstr "" # b722c91d7cde438eb3b0de3f741affdf -#: ../src/Doc/library/datetime.rst:691 +#: library/datetime.rst:691 msgid "" ":meth:`fromtimestamp` may raise :exc:`ValueError`, if the timestamp is out " "of the range of values supported by the platform C :c:func:`localtime` or :c:" @@ -26525,7 +26645,7 @@ msgid "" msgstr "" # f52f8c78dc25461582d880f9667c465f -#: ../src/Doc/library/datetime.rst:702 +#: library/datetime.rst:702 msgid "" "Return the UTC :class:`.datetime` corresponding to the POSIX timestamp, " "with :attr:`tzinfo` ``None``. This may raise :exc:`ValueError`, if the " @@ -26535,7 +26655,7 @@ msgid "" msgstr "" # 55ea4148c2fe42da8d4f899b8a8f966c -#: ../src/Doc/library/datetime.rst:711 +#: library/datetime.rst:711 msgid "" "Return the :class:`.datetime` corresponding to the proleptic Gregorian " "ordinal, where January 1 of year 1 has ordinal 1. :exc:`ValueError` is " @@ -26545,7 +26665,7 @@ msgid "" msgstr "" # 23114c79cb1f4bb68a1758bb17f5835d -#: ../src/Doc/library/datetime.rst:719 +#: library/datetime.rst:719 msgid "" "Return a new :class:`.datetime` object whose date components are equal to " "the given :class:`date` object's, and whose time components and :attr:" @@ -26556,7 +26676,7 @@ msgid "" msgstr "" # a97b164b18d84fc5922e4d854e18eab4 -#: ../src/Doc/library/datetime.rst:730 +#: library/datetime.rst:730 msgid "" "Return a :class:`.datetime` corresponding to *date_string*, parsed according " "to *format*. This is equivalent to ``datetime(*(time.strptime(date_string, " @@ -26567,93 +26687,88 @@ msgid "" msgstr "" # 86759a291cb045599c55961784b3ee27 -#: ../src/Doc/library/datetime.rst:744 +#: library/datetime.rst:744 msgid "" "The earliest representable :class:`.datetime`, ``datetime(MINYEAR, 1, 1, " "tzinfo=None)``." msgstr "" # 32e1c00037d648b7abe3711483b84ef4 -#: ../src/Doc/library/datetime.rst:750 +#: library/datetime.rst:750 msgid "" "The latest representable :class:`.datetime`, ``datetime(MAXYEAR, 12, 31, 23, " "59, 59, 999999, tzinfo=None)``." msgstr "" # 6fef1a1d0fa1450e8ec0a6f8d633a515 -#: ../src/Doc/library/datetime.rst:756 +#: library/datetime.rst:756 msgid "" "The smallest possible difference between non-equal :class:`.datetime` " "objects, ``timedelta(microseconds=1)``." msgstr "" -#: ../src/Doc/library/datetime.rst:779 ../src/Doc/library/datetime.rst:1216 +#: library/datetime.rst:779 library/datetime.rst:1216 msgid "In ``range(24)``." msgstr "" -#: ../src/Doc/library/datetime.rst:784 ../src/Doc/library/datetime.rst:789 -#: ../src/Doc/library/datetime.rst:1221 ../src/Doc/library/datetime.rst:1226 +#: library/datetime.rst:784 library/datetime.rst:789 library/datetime.rst:1221 +#: library/datetime.rst:1226 msgid "In ``range(60)``." msgstr "" -#: ../src/Doc/library/datetime.rst:794 ../src/Doc/library/datetime.rst:1231 +#: library/datetime.rst:794 library/datetime.rst:1231 msgid "In ``range(1000000)``." msgstr "" # 78cabc11430c43e3b908ebad949c00ab -#: ../src/Doc/library/datetime.rst:799 +#: library/datetime.rst:799 msgid "" "The object passed as the *tzinfo* argument to the :class:`.datetime` " "constructor, or ``None`` if none was passed." msgstr "" -#: ../src/Doc/library/datetime.rst:808 +#: library/datetime.rst:808 msgid "``datetime2 = datetime1 + timedelta``" msgstr "" -#: ../src/Doc/library/datetime.rst:808 ../src/Doc/library/datetime.rst:1620 -#: ../src/Doc/library/datetime.rst:1625 ../src/Doc/library/datetime.rst:1637 -#: ../src/Doc/library/datetime.rst:1642 ../src/Doc/library/datetime.rst:1701 -#: ../src/Doc/library/datetime.rst:1706 ../src/Doc/library/datetime.rst:1710 -#: ../src/Doc/library/inspect.rst:57 ../src/Doc/library/posixfile.rst:128 -#: ../src/Doc/library/posixfile.rst:160 ../src/Doc/library/posixfile.rst:163 -#: ../src/Doc/library/stdtypes.rst:97 ../src/Doc/library/stdtypes.rst:165 -#: ../src/Doc/library/stdtypes.rst:307 ../src/Doc/library/stdtypes.rst:730 -#: ../src/Doc/library/stdtypes.rst:733 ../src/Doc/library/stdtypes.rst:1448 -#: ../src/Doc/library/stdtypes.rst:1604 ../src/Doc/library/struct.rst:176 -#: ../src/Doc/library/time.rst:291 ../src/Doc/library/webbrowser.rst:121 -#: ../src/Doc/library/webbrowser.rst:123 ../src/Doc/library/webbrowser.rst:125 +#: library/datetime.rst:808 library/datetime.rst:1620 library/datetime.rst:1625 +#: library/datetime.rst:1637 library/datetime.rst:1642 +#: library/datetime.rst:1701 library/datetime.rst:1706 +#: library/datetime.rst:1710 library/inspect.rst:57 library/posixfile.rst:128 +#: library/posixfile.rst:160 library/posixfile.rst:163 library/stdtypes.rst:97 +#: library/stdtypes.rst:165 library/stdtypes.rst:307 library/stdtypes.rst:730 +#: library/stdtypes.rst:733 library/stdtypes.rst:1451 library/stdtypes.rst:1607 +#: library/struct.rst:176 library/time.rst:290 library/webbrowser.rst:121 +#: library/webbrowser.rst:123 library/webbrowser.rst:125 msgid "\\(1)" msgstr "\\(1)" -#: ../src/Doc/library/datetime.rst:810 +#: library/datetime.rst:810 msgid "``datetime2 = datetime1 - timedelta``" msgstr "" -#: ../src/Doc/library/datetime.rst:810 ../src/Doc/library/posixfile.rst:166 -#: ../src/Doc/library/stdtypes.rst:100 ../src/Doc/library/stdtypes.rst:321 -#: ../src/Doc/library/stdtypes.rst:323 ../src/Doc/library/stdtypes.rst:739 -#: ../src/Doc/library/stdtypes.rst:1452 ../src/Doc/library/stdtypes.rst:1454 -#: ../src/Doc/library/stdtypes.rst:1610 ../src/Doc/library/time.rst:294 -#: ../src/Doc/library/webbrowser.rst:141 +#: library/datetime.rst:810 library/posixfile.rst:166 library/stdtypes.rst:100 +#: library/stdtypes.rst:321 library/stdtypes.rst:323 library/stdtypes.rst:739 +#: library/stdtypes.rst:1455 library/stdtypes.rst:1457 +#: library/stdtypes.rst:1613 library/time.rst:293 library/webbrowser.rst:141 msgid "\\(2)" msgstr "\\(2)" -#: ../src/Doc/library/datetime.rst:812 +#: library/datetime.rst:812 msgid "``timedelta = datetime1 - datetime2``" msgstr "" -#: ../src/Doc/library/datetime.rst:814 +#: library/datetime.rst:814 msgid "``datetime1 < datetime2``" msgstr "" # 2c7b25e8be2647ec9a7a23b727632d0a -#: ../src/Doc/library/datetime.rst:814 +#: library/datetime.rst:814 msgid "Compares :class:`.datetime` to :class:`.datetime`. (4)" msgstr "" # 032b78d396c4401781a6cd4acd56908c -#: ../src/Doc/library/datetime.rst:819 +#: library/datetime.rst:819 msgid "" "datetime2 is a duration of timedelta removed from datetime1, moving forward " "in time if ``timedelta.days`` > 0, or backward if ``timedelta.days`` < 0. " @@ -26665,7 +26780,7 @@ msgid "" msgstr "" # 59c904f21ee347b2a606e634c383b869 -#: ../src/Doc/library/datetime.rst:828 +#: library/datetime.rst:828 msgid "" "Computes the datetime2 such that datetime2 + timedelta == datetime1. As for " "addition, the result has the same :attr:`tzinfo` attribute as the input " @@ -26675,7 +26790,7 @@ msgid "" msgstr "" # 5ea081186fc343f9b89e1bcc834d8966 -#: ../src/Doc/library/datetime.rst:835 +#: library/datetime.rst:835 msgid "" "Subtraction of a :class:`.datetime` from a :class:`.datetime` is defined " "only if both operands are naive, or if both are aware. If one is aware and " @@ -26683,7 +26798,7 @@ msgid "" msgstr "" # 0370d333155241f3be4b3c4c1ed7b4a2 -#: ../src/Doc/library/datetime.rst:839 +#: library/datetime.rst:839 msgid "" "If both are naive, or both are aware and have the same :attr:`tzinfo` " "attribute, the :attr:`tzinfo` attributes are ignored, and the result is a :" @@ -26692,7 +26807,7 @@ msgid "" msgstr "" # 39239ce92e4e4ae582ea91899cf95af9 -#: ../src/Doc/library/datetime.rst:844 +#: library/datetime.rst:844 msgid "" "If both are aware and have different :attr:`tzinfo` attributes, ``a-b`` acts " "as if *a* and *b* were first converted to naive UTC datetimes first. The " @@ -26701,14 +26816,14 @@ msgid "" "overflows." msgstr "" -#: ../src/Doc/library/datetime.rst:850 +#: library/datetime.rst:850 msgid "" "*datetime1* is considered less than *datetime2* when *datetime1* precedes " "*datetime2* in time." msgstr "" # 68330aef8133461aa183f90865615685 -#: ../src/Doc/library/datetime.rst:853 +#: library/datetime.rst:853 msgid "" "If one comparand is naive and the other is aware, :exc:`TypeError` is " "raised. If both comparands are aware, and have the same :attr:`tzinfo` " @@ -26719,7 +26834,7 @@ msgid "" msgstr "" # 06011f11274d4631af189fdc1970815a -#: ../src/Doc/library/datetime.rst:862 +#: library/datetime.rst:862 msgid "" "In order to stop comparison from falling back to the default scheme of " "comparing object addresses, datetime comparison normally raises :exc:" @@ -26733,32 +26848,32 @@ msgid "" msgstr "" # 44855f6a4b0049149daa487eb9817755 -#: ../src/Doc/library/datetime.rst:872 +#: library/datetime.rst:872 msgid "" ":class:`.datetime` objects can be used as dictionary keys. In Boolean " "contexts, all :class:`.datetime` objects are considered to be true." msgstr "" -#: ../src/Doc/library/datetime.rst:879 +#: library/datetime.rst:879 msgid "Return :class:`date` object with same year, month and day." msgstr "" # a8f5ad3dcf644502a6fe7eb3129e90a6 -#: ../src/Doc/library/datetime.rst:884 +#: library/datetime.rst:884 msgid "" "Return :class:`.time` object with same hour, minute, second and " "microsecond. :attr:`tzinfo` is ``None``. See also method :meth:`timetz`." msgstr "" # c2ecfd0725de44f8a6c879e183c813e9 -#: ../src/Doc/library/datetime.rst:890 +#: library/datetime.rst:890 msgid "" "Return :class:`.time` object with same hour, minute, second, microsecond, " "and tzinfo attributes. See also method :meth:`time`." msgstr "" # f20c7d0196664959ae0e05c7f8747681 -#: ../src/Doc/library/datetime.rst:896 +#: library/datetime.rst:896 msgid "" "Return a datetime with the same attributes, except for those attributes " "given new values by whichever keyword arguments are specified. Note that " @@ -26767,14 +26882,14 @@ msgid "" msgstr "" # abc025f9103841ec96bb5f046d4279b0 -#: ../src/Doc/library/datetime.rst:904 +#: library/datetime.rst:904 msgid "" "Return a :class:`.datetime` object with new :attr:`tzinfo` attribute *tz*, " "adjusting the date and time data so the result is the same UTC time as " "*self*, but in *tz*'s local time." msgstr "" -#: ../src/Doc/library/datetime.rst:908 +#: library/datetime.rst:908 msgid "" "*tz* must be an instance of a :class:`tzinfo` subclass, and its :meth:" "`utcoffset` and :meth:`dst` methods must not return ``None``. *self* must " @@ -26783,7 +26898,7 @@ msgid "" msgstr "" # c327f64094524500bf0429bed4c1d6d5 -#: ../src/Doc/library/datetime.rst:913 +#: library/datetime.rst:913 msgid "" "If ``self.tzinfo`` is *tz*, ``self.astimezone(tz)`` is equal to *self*: no " "adjustment of date or time data is performed. Else the result is local time " @@ -26796,7 +26911,7 @@ msgid "" msgstr "" # 181eeaa9534a4858878e4fedd59e1573 -#: ../src/Doc/library/datetime.rst:922 +#: library/datetime.rst:922 msgid "" "If you merely want to attach a time zone object *tz* to a datetime *dt* " "without adjustment of date and time data, use ``dt.replace(tzinfo=tz)``. If " @@ -26804,14 +26919,14 @@ msgid "" "without conversion of date and time data, use ``dt.replace(tzinfo=None)``." msgstr "" -#: ../src/Doc/library/datetime.rst:927 +#: library/datetime.rst:927 msgid "" "Note that the default :meth:`tzinfo.fromutc` method can be overridden in a :" "class:`tzinfo` subclass to affect the result returned by :meth:`astimezone`. " "Ignoring error cases, :meth:`astimezone` acts like::" msgstr "" -#: ../src/Doc/library/datetime.rst:942 +#: library/datetime.rst:942 msgid "" "If :attr:`tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "utcoffset(self)``, and raises an exception if the latter doesn't return " @@ -26819,7 +26934,7 @@ msgid "" "minutes with magnitude less than one day." msgstr "" -#: ../src/Doc/library/datetime.rst:950 +#: library/datetime.rst:950 msgid "" "If :attr:`tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "dst(self)``, and raises an exception if the latter doesn't return ``None``, " @@ -26827,7 +26942,7 @@ msgid "" "magnitude less than one day." msgstr "" -#: ../src/Doc/library/datetime.rst:958 +#: library/datetime.rst:958 msgid "" "If :attr:`tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "tzname(self)``, raises an exception if the latter doesn't return ``None`` or " @@ -26835,7 +26950,7 @@ msgid "" msgstr "" # 73e1a35d3a0f4d04b3bed6fe1b870e04 -#: ../src/Doc/library/datetime.rst:965 +#: library/datetime.rst:965 msgid "" "Return a :class:`time.struct_time` such as returned by :func:`time." "localtime`. ``d.timetuple()`` is equivalent to ``time.struct_time((d.year, d." @@ -26849,7 +26964,7 @@ msgid "" msgstr "" # 4238a485338b4318ada405d1a406934e -#: ../src/Doc/library/datetime.rst:978 +#: library/datetime.rst:978 msgid "" "If :class:`.datetime` instance *d* is naive, this is the same as ``d." "timetuple()`` except that :attr:`tm_isdst` is forced to 0 regardless of what " @@ -26857,7 +26972,7 @@ msgid "" msgstr "" # 7d1b1717feda4eac89853690f69d4ecf -#: ../src/Doc/library/datetime.rst:982 +#: library/datetime.rst:982 msgid "" "If *d* is aware, *d* is normalized to UTC time, by subtracting ``d." "utcoffset()``, and a :class:`time.struct_time` for the normalized time is " @@ -26867,59 +26982,59 @@ msgid "" "year boundary." msgstr "" -#: ../src/Doc/library/datetime.rst:992 +#: library/datetime.rst:992 msgid "" "Return the proleptic Gregorian ordinal of the date. The same as ``self." "date().toordinal()``." msgstr "" -#: ../src/Doc/library/datetime.rst:998 +#: library/datetime.rst:998 msgid "" "Return the day of the week as an integer, where Monday is 0 and Sunday is 6. " "The same as ``self.date().weekday()``. See also :meth:`isoweekday`." msgstr "" -#: ../src/Doc/library/datetime.rst:1004 +#: library/datetime.rst:1004 msgid "" "Return the day of the week as an integer, where Monday is 1 and Sunday is 7. " "The same as ``self.date().isoweekday()``. See also :meth:`weekday`, :meth:" "`isocalendar`." msgstr "" -#: ../src/Doc/library/datetime.rst:1011 +#: library/datetime.rst:1011 msgid "" "Return a 3-tuple, (ISO year, ISO week number, ISO weekday). The same as " "``self.date().isocalendar()``." msgstr "" -#: ../src/Doc/library/datetime.rst:1017 +#: library/datetime.rst:1017 msgid "" "Return a string representing the date and time in ISO 8601 format, YYYY-MM-" "DDTHH:MM:SS.mmmmmm or, if :attr:`microsecond` is 0, YYYY-MM-DDTHH:MM:SS" msgstr "" -#: ../src/Doc/library/datetime.rst:1021 +#: library/datetime.rst:1021 msgid "" "If :meth:`utcoffset` does not return ``None``, a 6-character string is " "appended, giving the UTC offset in (signed) hours and minutes: YYYY-MM-DDTHH:" "MM:SS.mmmmmm+HH:MM or, if :attr:`microsecond` is 0 YYYY-MM-DDTHH:MM:SS+HH:MM" msgstr "" -#: ../src/Doc/library/datetime.rst:1026 +#: library/datetime.rst:1026 msgid "" "The optional argument *sep* (default ``'T'``) is a one-character separator, " "placed between the date and time portions of the result. For example," msgstr "" # 8c698bb2f1514bd3b35697c6d4c7e84c -#: ../src/Doc/library/datetime.rst:1039 +#: library/datetime.rst:1039 msgid "" "For a :class:`.datetime` instance *d*, ``str(d)`` is equivalent to ``d." "isoformat(' ')``." msgstr "" # 744707194eba46428ab1c8a92d9f95d1 -#: ../src/Doc/library/datetime.rst:1045 +#: library/datetime.rst:1045 msgid "" "Return a string representing the date and time, for example ``datetime(2002, " "12, 4, 20, 30, 40).ctime() == 'Wed Dec 4 20:30:40 2002'``. ``d.ctime()`` is " @@ -26929,7 +27044,7 @@ msgid "" msgstr "" # 94ad86da97a246dc8948d53787c429a9 -#: ../src/Doc/library/datetime.rst:1054 +#: library/datetime.rst:1054 msgid "" "Return a string representing the date and time, controlled by an explicit " "format string. For a complete list of formatting directives, see section :" @@ -26937,61 +27052,61 @@ msgid "" msgstr "" # 4764559a228c490bb938fe836fbc1e95 -#: ../src/Doc/library/datetime.rst:1061 +#: library/datetime.rst:1061 msgid "" "Same as :meth:`.datetime.strftime`. This makes it possible to specify " "format string for a :class:`.datetime` object when using :meth:`str.format`. " "See section :ref:`strftime-strptime-behavior`." msgstr "" -#: ../src/Doc/library/datetime.rst:1066 +#: library/datetime.rst:1066 msgid "Examples of working with datetime objects:" msgstr "" -#: ../src/Doc/library/datetime.rst:1113 +#: library/datetime.rst:1113 msgid "Using datetime with tzinfo:" msgstr "" -#: ../src/Doc/library/datetime.rst:1173 +#: library/datetime.rst:1173 msgid ":class:`time` Objects" msgstr "" -#: ../src/Doc/library/datetime.rst:1175 +#: library/datetime.rst:1175 msgid "" "A time object represents a (local) time of day, independent of any " "particular day, and subject to adjustment via a :class:`tzinfo` object." msgstr "" # 8c087a8475eb4d119a53b43b02f1dbbe -#: ../src/Doc/library/datetime.rst:1180 +#: library/datetime.rst:1180 msgid "" "All arguments are optional. *tzinfo* may be ``None``, or an instance of a :" "class:`tzinfo` subclass. The remaining arguments may be ints or longs, in " "the following ranges:" msgstr "" -#: ../src/Doc/library/datetime.rst:1187 +#: library/datetime.rst:1187 msgid "``0 <= microsecond < 1000000``." msgstr "" -#: ../src/Doc/library/datetime.rst:1189 +#: library/datetime.rst:1189 msgid "" "If an argument outside those ranges is given, :exc:`ValueError` is raised. " "All default to ``0`` except *tzinfo*, which defaults to :const:`None`." msgstr "" # 3f9bbaabe4d145068a98ec9020ac5dd7 -#: ../src/Doc/library/datetime.rst:1197 +#: library/datetime.rst:1197 msgid "The earliest representable :class:`.time`, ``time(0, 0, 0, 0)``." msgstr "" # 0cbc76ae868843958fca13a52c1804a1 -#: ../src/Doc/library/datetime.rst:1202 +#: library/datetime.rst:1202 msgid "The latest representable :class:`.time`, ``time(23, 59, 59, 999999)``." msgstr "" # d4001270fd6647df80b7af2926bf3865 -#: ../src/Doc/library/datetime.rst:1207 +#: library/datetime.rst:1207 msgid "" "The smallest possible difference between non-equal :class:`.time` objects, " "``timedelta(microseconds=1)``, although note that arithmetic on :class:`." @@ -26999,14 +27114,14 @@ msgid "" msgstr "" # 3e578f68b3d7440ca7bdba3393067d1c -#: ../src/Doc/library/datetime.rst:1236 +#: library/datetime.rst:1236 msgid "" "The object passed as the tzinfo argument to the :class:`.time` constructor, " "or ``None`` if none was passed." msgstr "" # 5fe11cb7000c401ea5d40e6efc3b3b3c -#: ../src/Doc/library/datetime.rst:1242 +#: library/datetime.rst:1242 msgid "" "comparison of :class:`.time` to :class:`.time`, where *a* is considered less " "than *b* when *a* precedes *b* in time. If one comparand is naive and the " @@ -27022,16 +27137,16 @@ msgid "" "or :const:`True`, respectively." msgstr "" -#: ../src/Doc/library/datetime.rst:1254 +#: library/datetime.rst:1254 msgid "hash, use as dict key" msgstr "" -#: ../src/Doc/library/datetime.rst:1256 +#: library/datetime.rst:1256 msgid "efficient pickling" msgstr "" # b0326eee55a443eb9efbd446b204bceb -#: ../src/Doc/library/datetime.rst:1258 +#: library/datetime.rst:1258 msgid "" "in Boolean contexts, a :class:`.time` object is considered to be true if and " "only if, after converting it to minutes and subtracting :meth:`utcoffset` " @@ -27039,7 +27154,7 @@ msgid "" msgstr "" # 79a1d0eab7ea4fd884f927cd73b67f0c -#: ../src/Doc/library/datetime.rst:1267 +#: library/datetime.rst:1267 msgid "" "Return a :class:`.time` with the same value, except for those attributes " "given new values by whichever keyword arguments are specified. Note that " @@ -27047,7 +27162,7 @@ msgid "" "aware :class:`.time`, without conversion of the time data." msgstr "" -#: ../src/Doc/library/datetime.rst:1275 +#: library/datetime.rst:1275 msgid "" "Return a string representing the time in ISO 8601 format, HH:MM:SS.mmmmmm " "or, if self.microsecond is 0, HH:MM:SS If :meth:`utcoffset` does not return " @@ -27056,12 +27171,12 @@ msgid "" "0, HH:MM:SS+HH:MM" msgstr "" -#: ../src/Doc/library/datetime.rst:1283 +#: library/datetime.rst:1283 msgid "For a time *t*, ``str(t)`` is equivalent to ``t.isoformat()``." msgstr "" # 94ad86da97a246dc8948d53787c429a9 -#: ../src/Doc/library/datetime.rst:1288 +#: library/datetime.rst:1288 msgid "" "Return a string representing the time, controlled by an explicit format " "string. For a complete list of formatting directives, see section :ref:" @@ -27069,14 +27184,14 @@ msgid "" msgstr "" # d4e239fd01a94b6bb71090a012b163b2 -#: ../src/Doc/library/datetime.rst:1295 +#: library/datetime.rst:1295 msgid "" "Same as :meth:`.time.strftime`. This makes it possible to specify format " "string for a :class:`.time` object when using :meth:`str.format`. See " "section :ref:`strftime-strptime-behavior`." msgstr "" -#: ../src/Doc/library/datetime.rst:1302 +#: library/datetime.rst:1302 msgid "" "If :attr:`tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "utcoffset(None)``, and raises an exception if the latter doesn't return " @@ -27084,7 +27199,7 @@ msgid "" "minutes with magnitude less than one day." msgstr "" -#: ../src/Doc/library/datetime.rst:1310 +#: library/datetime.rst:1310 msgid "" "If :attr:`tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "dst(None)``, and raises an exception if the latter doesn't return ``None``, " @@ -27092,19 +27207,19 @@ msgid "" "magnitude less than one day." msgstr "" -#: ../src/Doc/library/datetime.rst:1318 +#: library/datetime.rst:1318 msgid "" "If :attr:`tzinfo` is ``None``, returns ``None``, else returns ``self.tzinfo." "tzname(None)``, or raises an exception if the latter doesn't return ``None`` " "or a string object." msgstr "" -#: ../src/Doc/library/datetime.rst:1353 +#: library/datetime.rst:1353 msgid ":class:`tzinfo` Objects" msgstr "" # 0cbb4876513046639e709a203dfec035 -#: ../src/Doc/library/datetime.rst:1355 +#: library/datetime.rst:1355 msgid "" ":class:`tzinfo` is an abstract base class, meaning that this class should " "not be instantiated directly. You need to derive a concrete subclass, and " @@ -27114,7 +27229,7 @@ msgid "" msgstr "" # 093dd19a12c6450b8e34692a93cde11f -#: ../src/Doc/library/datetime.rst:1361 +#: library/datetime.rst:1361 msgid "" "An instance of (a concrete subclass of) :class:`tzinfo` can be passed to the " "constructors for :class:`.datetime` and :class:`.time` objects. The latter " @@ -27124,7 +27239,7 @@ msgid "" "object passed to them." msgstr "" -#: ../src/Doc/library/datetime.rst:1367 +#: library/datetime.rst:1367 msgid "" "Special requirement for pickling: A :class:`tzinfo` subclass must have an :" "meth:`__init__` method that can be called with no arguments, else it can be " @@ -27132,14 +27247,14 @@ msgid "" "that may be relaxed in the future." msgstr "" -#: ../src/Doc/library/datetime.rst:1372 +#: library/datetime.rst:1372 msgid "" "A concrete subclass of :class:`tzinfo` may need to implement the following " "methods. Exactly which methods are needed depends on the uses made of " "aware :mod:`datetime` objects. If in doubt, simply implement all of them." msgstr "" -#: ../src/Doc/library/datetime.rst:1379 +#: library/datetime.rst:1379 msgid "" "Return offset of local time from UTC, in minutes east of UTC. If local time " "is west of UTC, this should be negative. Note that this is intended to be " @@ -27152,20 +27267,20 @@ msgid "" "of :meth:`utcoffset` will probably look like one of these two::" msgstr "" -#: ../src/Doc/library/datetime.rst:1392 +#: library/datetime.rst:1392 msgid "" "If :meth:`utcoffset` does not return ``None``, :meth:`dst` should not return " "``None`` either." msgstr "" -#: ../src/Doc/library/datetime.rst:1395 +#: library/datetime.rst:1395 msgid "" "The default implementation of :meth:`utcoffset` raises :exc:" "`NotImplementedError`." msgstr "" # 93b2f001c80947aa94a7113cb590a433 -#: ../src/Doc/library/datetime.rst:1401 +#: library/datetime.rst:1401 msgid "" "Return the daylight saving time (DST) adjustment, in minutes east of UTC, or " "``None`` if DST information isn't known. Return ``timedelta(0)`` if DST is " @@ -27180,18 +27295,18 @@ msgid "" "zones." msgstr "" -#: ../src/Doc/library/datetime.rst:1412 +#: library/datetime.rst:1412 msgid "" "An instance *tz* of a :class:`tzinfo` subclass that models both standard and " "daylight times must be consistent in this sense:" msgstr "" -#: ../src/Doc/library/datetime.rst:1415 +#: library/datetime.rst:1415 msgid "``tz.utcoffset(dt) - tz.dst(dt)``" msgstr "" # 52eb41bf3076419aa46f584ac979d076 -#: ../src/Doc/library/datetime.rst:1417 +#: library/datetime.rst:1417 msgid "" "must return the same result for every :class:`.datetime` *dt* with ``dt." "tzinfo == tz`` For sane :class:`tzinfo` subclasses, this expression yields " @@ -27204,23 +27319,23 @@ msgid "" "regardless." msgstr "" -#: ../src/Doc/library/datetime.rst:1426 +#: library/datetime.rst:1426 msgid "" "Most implementations of :meth:`dst` will probably look like one of these " "two::" msgstr "" -#: ../src/Doc/library/datetime.rst:1432 +#: library/datetime.rst:1432 msgid "or ::" msgstr "ou ::" -#: ../src/Doc/library/datetime.rst:1444 +#: library/datetime.rst:1444 msgid "" "The default implementation of :meth:`dst` raises :exc:`NotImplementedError`." msgstr "" # d7751299e58a443aba3b40cb60573b96 -#: ../src/Doc/library/datetime.rst:1449 +#: library/datetime.rst:1449 msgid "" "Return the time zone name corresponding to the :class:`.datetime` object " "*dt*, as a string. Nothing about string names is defined by the :mod:" @@ -27233,14 +27348,14 @@ msgid "" "especially if the :class:`tzinfo` class is accounting for daylight time." msgstr "" -#: ../src/Doc/library/datetime.rst:1459 +#: library/datetime.rst:1459 msgid "" "The default implementation of :meth:`tzname` raises :exc:" "`NotImplementedError`." msgstr "" # b04e6b4150bc4adf9401eeb21758dca4 -#: ../src/Doc/library/datetime.rst:1462 +#: library/datetime.rst:1462 msgid "" "These methods are called by a :class:`.datetime` or :class:`.time` object, " "in response to their methods of the same names. A :class:`.datetime` object " @@ -27250,7 +27365,7 @@ msgid "" "datetime`." msgstr "" -#: ../src/Doc/library/datetime.rst:1468 +#: library/datetime.rst:1468 msgid "" "When ``None`` is passed, it's up to the class designer to decide the best " "response. For example, returning ``None`` is appropriate if the class " @@ -27261,7 +27376,7 @@ msgid "" msgstr "" # aa21dec39b794a1089f8bcac92c3e4ff -#: ../src/Doc/library/datetime.rst:1474 +#: library/datetime.rst:1474 msgid "" "When a :class:`.datetime` object is passed in response to a :class:`." "datetime` method, ``dt.tzinfo`` is the same object as *self*. :class:" @@ -27271,14 +27386,14 @@ msgid "" "timezones." msgstr "" -#: ../src/Doc/library/datetime.rst:1480 +#: library/datetime.rst:1480 msgid "" "There is one more :class:`tzinfo` method that a subclass may wish to " "override:" msgstr "" # 1cc9a758ca29491db7501d32436eab58 -#: ../src/Doc/library/datetime.rst:1485 +#: library/datetime.rst:1485 msgid "" "This is called from the default :class:`datetime.astimezone()` " "implementation. When called from that, ``dt.tzinfo`` is *self*, and *dt*'s " @@ -27287,7 +27402,7 @@ msgid "" "equivalent datetime in *self*'s local time." msgstr "" -#: ../src/Doc/library/datetime.rst:1491 +#: library/datetime.rst:1491 msgid "" "Most :class:`tzinfo` subclasses should be able to inherit the default :meth:" "`fromutc` implementation without problems. It's strong enough to handle " @@ -27301,17 +27416,17 @@ msgid "" "result is one of the hours straddling the moment the standard offset changes." msgstr "" -#: ../src/Doc/library/datetime.rst:1502 +#: library/datetime.rst:1502 msgid "" "Skipping code for error cases, the default :meth:`fromutc` implementation " "acts like::" msgstr "" -#: ../src/Doc/library/datetime.rst:1520 +#: library/datetime.rst:1520 msgid "Example :class:`tzinfo` classes:" msgstr "" -#: ../src/Doc/library/datetime.rst:1525 +#: library/datetime.rst:1525 msgid "" "Note that there are unavoidable subtleties twice per year in a :class:" "`tzinfo` subclass accounting for both standard and daylight time, at the DST " @@ -27320,7 +27435,7 @@ msgid "" "ends the minute after 1:59 (EDT) on the first Sunday in November::" msgstr "" -#: ../src/Doc/library/datetime.rst:1539 +#: library/datetime.rst:1539 msgid "" "When DST starts (the \"start\" line), the local wall clock leaps from 1:59 " "to 3:00. A wall time of the form 2:MM doesn't really make sense on that " @@ -27330,7 +27445,7 @@ msgid "" "MM for Eastern) to be in daylight time." msgstr "" -#: ../src/Doc/library/datetime.rst:1546 +#: library/datetime.rst:1546 msgid "" "When DST ends (the \"end\" line), there's a potentially worse problem: " "there's an hour that can't be spelled unambiguously in local wall time: the " @@ -27348,7 +27463,7 @@ msgid "" msgstr "" # ca3283792c79474b989c29d2ab9510b5 -#: ../src/Doc/library/datetime.rst:1559 +#: library/datetime.rst:1559 msgid "" "Applications that can't bear such ambiguities should avoid using hybrid :" "class:`tzinfo` subclasses; there are no ambiguities when using UTC, or any " @@ -27356,13 +27471,12 @@ msgid "" "only EST (fixed offset -5 hours), or only EDT (fixed offset -4 hours))." msgstr "" -# da3297c636b4461ab8120b1059803c23 -#: ../src/Doc/library/datetime.rst:1570 -msgid "`pytz `_" +#: library/datetime.rst:1571 +msgid "pytz" msgstr "" # 7af763e60e0d41c089813510079da524 -#: ../src/Doc/library/datetime.rst:1567 +#: library/datetime.rst:1567 msgid "" "The standard library has no :class:`tzinfo` instances, but there exists a " "third-party library which brings the *IANA timezone database* (also known as " @@ -27370,17 +27484,16 @@ msgid "" msgstr "" # da1075ef0d7c4dc8ab72e5e098983c9a -#: ../src/Doc/library/datetime.rst:1571 +#: library/datetime.rst:1571 msgid "*pytz* contains up-to-date information and its usage is recommended." msgstr "" -# 6b6f0d6241494d9083bf8b2fca4e1aef -#: ../src/Doc/library/datetime.rst:1576 -msgid "`IANA timezone database `_" +#: library/datetime.rst:1577 +msgid "IANA timezone database" msgstr "" # 56535a71921c4eb7920f01a80e14ea9f -#: ../src/Doc/library/datetime.rst:1574 +#: library/datetime.rst:1574 msgid "" "The Time Zone Database (often called tz or zoneinfo) contains code and data " "that represent the history of local time for many representative locations " @@ -27389,12 +27502,12 @@ msgid "" "rules." msgstr "" -#: ../src/Doc/library/datetime.rst:1583 +#: library/datetime.rst:1583 msgid ":meth:`strftime` and :meth:`strptime` Behavior" msgstr "" # dad0ad6a5e754a148b59bad15d735418 -#: ../src/Doc/library/datetime.rst:1585 +#: library/datetime.rst:1585 msgid "" ":class:`date`, :class:`.datetime`, and :class:`.time` objects all support a " "``strftime(format)`` method, to create a string representing the time under " @@ -27404,7 +27517,7 @@ msgid "" msgstr "" # 4764559a228c490bb938fe836fbc1e95 -#: ../src/Doc/library/datetime.rst:1591 +#: library/datetime.rst:1591 msgid "" "Conversely, the :meth:`datetime.strptime` class method creates a :class:`." "datetime` object from a string representing a date and time and a " @@ -27413,14 +27526,14 @@ msgid "" msgstr "" # 80159bba03cf4ee5974677c28319d13e -#: ../src/Doc/library/datetime.rst:1596 +#: library/datetime.rst:1596 msgid "" "For :class:`.time` objects, the format codes for year, month, and day should " "not be used, as time objects have no such values. If they're used anyway, " "``1900`` is substituted for the year, and ``1`` for the month and day." msgstr "" -#: ../src/Doc/library/datetime.rst:1600 +#: library/datetime.rst:1600 msgid "" "For :class:`date` objects, the format codes for hours, minutes, seconds, and " "microseconds should not be used, as :class:`date` objects have no such " @@ -27428,7 +27541,7 @@ msgid "" msgstr "" # 8e06bb047343466ca60c95f0c93aaabb -#: ../src/Doc/library/datetime.rst:1604 +#: library/datetime.rst:1604 msgid "" "The full set of format codes supported varies across platforms, because " "Python calls the platform C library's :func:`strftime` function, and " @@ -27436,7 +27549,7 @@ msgid "" "supported on your platform, consult the :manpage:`strftime(3)` documentation." msgstr "" -#: ../src/Doc/library/datetime.rst:1609 +#: library/datetime.rst:1609 msgid "" "The following is a list of all the format codes that the C standard (1989 " "version) requires, and these work on all platforms with a standard C " @@ -27444,258 +27557,295 @@ msgid "" "additional format codes." msgstr "" -#: ../src/Doc/library/datetime.rst:1614 +#: library/datetime.rst:1614 msgid "" "The exact range of years for which :meth:`strftime` works also varies across " "platforms. Regardless of platform, years before 1900 cannot be used." msgstr "" -#: ../src/Doc/library/datetime.rst:1618 ../src/Doc/library/time.rst:258 +#: library/datetime.rst:1618 library/time.rst:257 msgid "Directive" msgstr "" -#: ../src/Doc/library/datetime.rst:1620 ../src/Doc/library/time.rst:260 +#: library/datetime.rst:1620 library/time.rst:259 msgid "``%a``" msgstr "" # 473c118e562246a29170b6f1d257e2a1 -#: ../src/Doc/library/datetime.rst:1620 +#: library/datetime.rst:1620 msgid "Weekday as locale's abbreviated name." msgstr "" -#: ../src/Doc/library/datetime.rst:1625 ../src/Doc/library/time.rst:263 +#: library/datetime.rst:0 +msgid "Sun, Mon, ..., Sat (en_US);" +msgstr "" + +#: library/datetime.rst:0 +msgid "So, Mo, ..., Sa (de_DE)" +msgstr "" + +#: library/datetime.rst:1625 library/time.rst:262 msgid "``%A``" msgstr "" # 6e3e69572e704dd99ffe40af69a83be6 -#: ../src/Doc/library/datetime.rst:1625 +#: library/datetime.rst:1625 msgid "Weekday as locale's full name." msgstr "" -#: ../src/Doc/library/datetime.rst:1630 ../src/Doc/library/time.rst:305 +#: library/datetime.rst:0 +msgid "Sunday, Monday, ..., Saturday (en_US);" +msgstr "" + +#: library/datetime.rst:0 +msgid "Sonntag, Montag, ..., Samstag (de_DE)" +msgstr "" + +#: library/datetime.rst:1630 library/time.rst:304 msgid "``%w``" msgstr "" # b4b5a6b3aabc46178185003fc6578bf4 -#: ../src/Doc/library/datetime.rst:1630 +#: library/datetime.rst:1630 msgid "Weekday as a decimal number, where 0 is Sunday and 6 is Saturday." msgstr "" # c8a952029ea24b839f50db223e7fcf8d -#: ../src/Doc/library/datetime.rst:1630 +#: library/datetime.rst:1630 msgid "0, 1, ..., 6" msgstr "" -#: ../src/Doc/library/datetime.rst:1634 ../src/Doc/library/re.rst:1076 -#: ../src/Doc/library/time.rst:273 +#: library/datetime.rst:1634 library/re.rst:1081 library/time.rst:272 msgid "``%d``" msgstr "" # 03a0199fc04740f7afa59d3a504cc7fa -#: ../src/Doc/library/datetime.rst:1634 +#: library/datetime.rst:1634 msgid "Day of the month as a zero-padded decimal number." msgstr "" # b406cc59739240a98d2c8c37403a72a1 -#: ../src/Doc/library/datetime.rst:1634 +#: library/datetime.rst:1634 msgid "01, 02, ..., 31" msgstr "" -#: ../src/Doc/library/datetime.rst:1637 ../src/Doc/library/time.rst:265 +#: library/datetime.rst:1637 library/time.rst:264 msgid "``%b``" msgstr "" # 473c118e562246a29170b6f1d257e2a1 -#: ../src/Doc/library/datetime.rst:1637 +#: library/datetime.rst:1637 msgid "Month as locale's abbreviated name." msgstr "" -#: ../src/Doc/library/datetime.rst:1642 ../src/Doc/library/time.rst:268 +#: library/datetime.rst:0 +msgid "Jan, Feb, ..., Dec (en_US);" +msgstr "" + +#: library/datetime.rst:0 +msgid "Jan, Feb, ..., Dez (de_DE)" +msgstr "" + +#: library/datetime.rst:1642 library/time.rst:267 msgid "``%B``" msgstr "" # ae1a11409401492dba7aa32a63add223 -#: ../src/Doc/library/datetime.rst:1642 +#: library/datetime.rst:1642 msgid "Month as locale's full name." msgstr "" -#: ../src/Doc/library/datetime.rst:1647 ../src/Doc/library/time.rst:285 +#: library/datetime.rst:0 +msgid "January, February, ..., December (en_US);" +msgstr "" + +#: library/datetime.rst:0 +msgid "Januar, Februar, ..., Dezember (de_DE)" +msgstr "" + +#: library/datetime.rst:1647 library/time.rst:284 msgid "``%m``" msgstr "" # fa9617dfb8ba40cf8e4322a347060662 -#: ../src/Doc/library/datetime.rst:1647 +#: library/datetime.rst:1647 msgid "Month as a zero-padded decimal number." msgstr "" # a0bf0eac6b2d4f3eb94de210010c4b7d # 8f9ae7f728454a74a0fe9892a90019a9 -#: ../src/Doc/library/datetime.rst:1647 ../src/Doc/library/datetime.rst:1659 +#: library/datetime.rst:1647 library/datetime.rst:1659 msgid "01, 02, ..., 12" msgstr "" -#: ../src/Doc/library/datetime.rst:1650 ../src/Doc/library/time.rst:322 +#: library/datetime.rst:1650 library/time.rst:321 msgid "``%y``" msgstr "" # 64a90715e98a4bdc820c1af7f47d9451 -#: ../src/Doc/library/datetime.rst:1650 +#: library/datetime.rst:1650 msgid "Year without century as a zero-padded decimal number." msgstr "" # fccd675753734387a2535b61502d5a94 -#: ../src/Doc/library/datetime.rst:1650 +#: library/datetime.rst:1650 msgid "00, 01, ..., 99" msgstr "" -#: ../src/Doc/library/datetime.rst:1653 ../src/Doc/library/time.rst:325 +#: library/datetime.rst:1653 library/time.rst:324 msgid "``%Y``" msgstr "" -#: ../src/Doc/library/datetime.rst:1653 ../src/Doc/library/time.rst:325 +#: library/datetime.rst:1653 library/time.rst:324 msgid "Year with century as a decimal number." msgstr "" # b05662a447d74a95b44a6c88d6144db0 -#: ../src/Doc/library/datetime.rst:1653 +#: library/datetime.rst:1653 msgid "1970, 1988, 2001, 2013" msgstr "" -#: ../src/Doc/library/datetime.rst:1656 ../src/Doc/library/time.rst:276 +#: library/datetime.rst:1656 library/time.rst:275 msgid "``%H``" msgstr "" # 48913102170b4d8abc65d4cab2ee3370 -#: ../src/Doc/library/datetime.rst:1656 +#: library/datetime.rst:1656 msgid "Hour (24-hour clock) as a zero-padded decimal number." msgstr "" # a9ffbe69b6324df78519c2191bc5f717 -#: ../src/Doc/library/datetime.rst:1656 +#: library/datetime.rst:1656 msgid "00, 01, ..., 23" msgstr "" -#: ../src/Doc/library/datetime.rst:1659 ../src/Doc/library/time.rst:279 +#: library/datetime.rst:1659 library/time.rst:278 msgid "``%I``" msgstr "" # 3b4dec2f86d34be2a6dd6acb2f536973 -#: ../src/Doc/library/datetime.rst:1659 +#: library/datetime.rst:1659 msgid "Hour (12-hour clock) as a zero-padded decimal number." msgstr "" -#: ../src/Doc/library/datetime.rst:1662 ../src/Doc/library/time.rst:291 +#: library/datetime.rst:1662 library/time.rst:290 msgid "``%p``" msgstr "" -#: ../src/Doc/library/datetime.rst:1662 ../src/Doc/library/time.rst:291 +#: library/datetime.rst:1662 library/time.rst:290 msgid "Locale's equivalent of either AM or PM." msgstr "" +#: library/datetime.rst:0 +msgid "AM, PM (en_US);" +msgstr "" + +#: library/datetime.rst:0 +msgid "am, pm (de_DE)" +msgstr "" + # efa044fe0b0c41f9ac3e8194729a3b66 -#: ../src/Doc/library/datetime.rst:1662 +#: library/datetime.rst:1662 msgid "\\(1), \\(2)" msgstr "" -#: ../src/Doc/library/datetime.rst:1665 ../src/Doc/library/time.rst:288 +#: library/datetime.rst:1665 library/time.rst:287 msgid "``%M``" msgstr "" # f25667ef948d4f57b0554ac176c163b1 -#: ../src/Doc/library/datetime.rst:1665 +#: library/datetime.rst:1665 msgid "Minute as a zero-padded decimal number." msgstr "" # 8e7e8272bc134509b036155ca0351267 # 104ae3ced2d6452c9782ac9e67f614e4 -#: ../src/Doc/library/datetime.rst:1665 ../src/Doc/library/datetime.rst:1668 +#: library/datetime.rst:1665 library/datetime.rst:1668 msgid "00, 01, ..., 59" msgstr "" -#: ../src/Doc/library/datetime.rst:1668 ../src/Doc/library/time.rst:294 +#: library/datetime.rst:1668 library/time.rst:293 msgid "``%S``" msgstr "" # 4a5f368b79d64145b8406eab2deb9d3e -#: ../src/Doc/library/datetime.rst:1668 +#: library/datetime.rst:1668 msgid "Second as a zero-padded decimal number." msgstr "" -#: ../src/Doc/library/datetime.rst:1671 +#: library/datetime.rst:1671 msgid "``%f``" msgstr "" # 8c349bca15754e5e8f2a91e1cab85703 -#: ../src/Doc/library/datetime.rst:1671 +#: library/datetime.rst:1671 msgid "Microsecond as a decimal number, zero-padded on the left." msgstr "" # b0dfbebc2bd543178fa997d2e71be7f1 -#: ../src/Doc/library/datetime.rst:1671 +#: library/datetime.rst:1671 msgid "000000, 000001, ..., 999999" msgstr "" -#: ../src/Doc/library/datetime.rst:1671 ../src/Doc/library/stdtypes.rst:312 -#: ../src/Doc/library/stdtypes.rst:1464 ../src/Doc/library/stdtypes.rst:1468 -#: ../src/Doc/library/stdtypes.rst:1619 ../src/Doc/library/stdtypes.rst:1628 -#: ../src/Doc/library/struct.rst:195 ../src/Doc/library/struct.rst:197 +#: library/datetime.rst:1671 library/stdtypes.rst:312 library/stdtypes.rst:1467 +#: library/stdtypes.rst:1471 library/stdtypes.rst:1625 +#: library/stdtypes.rst:1634 library/struct.rst:195 library/struct.rst:197 msgid "\\(4)" msgstr "" -#: ../src/Doc/library/datetime.rst:1675 ../src/Doc/library/datetime.rst:1754 +#: library/datetime.rst:1675 msgid "``%z``" msgstr "" -#: ../src/Doc/library/datetime.rst:1675 +#: library/datetime.rst:1675 msgid "" "UTC offset in the form +HHMM or -HHMM (empty string if the the object is " "naive)." msgstr "" # 52adcdcc90bd44e18b269b2e07e73ef9 -#: ../src/Doc/library/datetime.rst:1675 +#: library/datetime.rst:1675 msgid "(empty), +0000, -0400, +1030" msgstr "" -#: ../src/Doc/library/datetime.rst:1675 ../src/Doc/library/stdtypes.rst:1475 -#: ../src/Doc/library/stdtypes.rst:1623 +#: library/datetime.rst:1675 library/stdtypes.rst:1478 +#: library/stdtypes.rst:1629 msgid "\\(5)" msgstr "" -#: ../src/Doc/library/datetime.rst:1679 ../src/Doc/library/datetime.rst:1759 -#: ../src/Doc/library/time.rst:328 +#: library/datetime.rst:1679 library/time.rst:327 msgid "``%Z``" msgstr "" -#: ../src/Doc/library/datetime.rst:1679 +#: library/datetime.rst:1679 msgid "Time zone name (empty string if the object is naive)." msgstr "" # 7c15f5c5be4044b9a981891d008ccba0 -#: ../src/Doc/library/datetime.rst:1679 +#: library/datetime.rst:1679 msgid "(empty), UTC, EST, CST" msgstr "" -#: ../src/Doc/library/datetime.rst:1682 ../src/Doc/library/time.rst:282 +#: library/datetime.rst:1682 library/time.rst:281 msgid "``%j``" msgstr "" # 26d3968c8d9940faaeb5001d60d87b77 -#: ../src/Doc/library/datetime.rst:1682 +#: library/datetime.rst:1682 msgid "Day of the year as a zero-padded decimal number." msgstr "" # 03908901295f4f73838cb54ffa381694 -#: ../src/Doc/library/datetime.rst:1682 +#: library/datetime.rst:1682 msgid "001, 002, ..., 366" msgstr "" -#: ../src/Doc/library/datetime.rst:1685 ../src/Doc/library/time.rst:297 +#: library/datetime.rst:1685 library/time.rst:296 msgid "``%U``" msgstr "" # b53a63f1400d4c3081d9b5d2fa6f86f7 -#: ../src/Doc/library/datetime.rst:1685 +#: library/datetime.rst:1685 msgid "" "Week number of the year (Sunday as the first day of the week) as a zero " "padded decimal number. All days in a new year preceding the first Sunday are " @@ -27704,68 +27854,94 @@ msgstr "" # 073d0f01834543169ac26c64dafb2c61 # 84a681ceb42b4304b7851ae553c977f8 -#: ../src/Doc/library/datetime.rst:1685 ../src/Doc/library/datetime.rst:1693 +#: library/datetime.rst:1685 library/datetime.rst:1693 msgid "00, 01, ..., 53" msgstr "" -#: ../src/Doc/library/datetime.rst:1685 ../src/Doc/library/datetime.rst:1693 -#: ../src/Doc/library/stdtypes.rst:325 ../src/Doc/library/stdtypes.rst:736 -#: ../src/Doc/library/stdtypes.rst:1478 ../src/Doc/library/stdtypes.rst:1625 +#: library/datetime.rst:1685 library/datetime.rst:1693 library/stdtypes.rst:325 +#: library/stdtypes.rst:736 library/stdtypes.rst:1481 library/stdtypes.rst:1631 msgid "\\(6)" msgstr "" -#: ../src/Doc/library/datetime.rst:1693 ../src/Doc/library/time.rst:308 +#: library/datetime.rst:1693 library/time.rst:307 msgid "``%W``" msgstr "" # f5d29b345a274ed2a243ca028aad9ae2 -#: ../src/Doc/library/datetime.rst:1693 +#: library/datetime.rst:1693 msgid "" "Week number of the year (Monday as the first day of the week) as a decimal " "number. All days in a new year preceding the first Monday are considered to " "be in week 0." msgstr "" -#: ../src/Doc/library/datetime.rst:1701 ../src/Doc/library/re.rst:1072 -#: ../src/Doc/library/time.rst:270 +#: library/datetime.rst:1701 library/re.rst:1077 library/time.rst:269 msgid "``%c``" msgstr "" -#: ../src/Doc/library/datetime.rst:1701 ../src/Doc/library/time.rst:270 +#: library/datetime.rst:1701 library/time.rst:269 msgid "Locale's appropriate date and time representation." msgstr "" -#: ../src/Doc/library/datetime.rst:1706 ../src/Doc/library/time.rst:316 +#: library/datetime.rst:0 +msgid "Tue Aug 16 21:30:00 1988 (en_US);" +msgstr "" + +#: library/datetime.rst:0 +msgid "Di 16 Aug 21:30:00 1988 (de_DE)" +msgstr "" + +#: library/datetime.rst:1706 library/time.rst:315 msgid "``%x``" msgstr "" -#: ../src/Doc/library/datetime.rst:1706 ../src/Doc/library/time.rst:316 +#: library/datetime.rst:1706 library/time.rst:315 msgid "Locale's appropriate date representation." msgstr "" -#: ../src/Doc/library/datetime.rst:1710 ../src/Doc/library/time.rst:319 +#: library/datetime.rst:0 +msgid "08/16/88 (None);" +msgstr "" + +#: library/datetime.rst:0 +msgid "08/16/1988 (en_US);" +msgstr "" + +#: library/datetime.rst:0 +msgid "16.08.1988 (de_DE)" +msgstr "" + +#: library/datetime.rst:1710 library/time.rst:318 msgid "``%X``" msgstr "" -#: ../src/Doc/library/datetime.rst:1710 ../src/Doc/library/time.rst:319 +#: library/datetime.rst:1710 library/time.rst:318 msgid "Locale's appropriate time representation." msgstr "" -#: ../src/Doc/library/datetime.rst:1713 ../src/Doc/library/time.rst:331 +#: library/datetime.rst:0 +msgid "21:30:00 (en_US);" +msgstr "" + +#: library/datetime.rst:0 +msgid "21:30:00 (de_DE)" +msgstr "" + +#: library/datetime.rst:1713 library/time.rst:330 msgid "``%%``" msgstr "" -#: ../src/Doc/library/datetime.rst:1713 ../src/Doc/library/time.rst:331 +#: library/datetime.rst:1713 library/time.rst:330 msgid "A literal ``'%'`` character." msgstr "" # e0bb2a816dba481b8149bd5fb19082b8 -#: ../src/Doc/library/datetime.rst:1713 +#: library/datetime.rst:1713 msgid "%" msgstr "" # 374c07a629174b13a20408f6c29aef0f -#: ../src/Doc/library/datetime.rst:1719 +#: library/datetime.rst:1719 msgid "" "Because the format depends on the current locale, care should be taken when " "making assumptions about the output value. Field orderings will vary (for " @@ -27776,7 +27952,7 @@ msgid "" "to determine the current locale's encoding)." msgstr "" -#: ../src/Doc/library/datetime.rst:1728 +#: library/datetime.rst:1728 msgid "" "When used with the :meth:`strptime` method, the ``%p`` directive only " "affects the output hour field if the ``%I`` directive is used to parse the " @@ -27784,14 +27960,14 @@ msgid "" msgstr "" # 768e4566aaa544daa021392cff3f5708 -#: ../src/Doc/library/datetime.rst:1732 +#: library/datetime.rst:1732 msgid "" "Unlike the :mod:`time` module, the :mod:`datetime` module does not support " "leap seconds." msgstr "" # 5f6e1972ea9444ef847fe336198edee7 -#: ../src/Doc/library/datetime.rst:1736 +#: library/datetime.rst:1736 msgid "" "``%f`` is an extension to the set of format characters in the C standard " "(but implemented separately in datetime objects, and therefore always " @@ -27799,17 +27975,21 @@ msgid "" "directive accepts from one to six digits and zero pads on the right." msgstr "" -#: ../src/Doc/library/datetime.rst:1744 +#: library/datetime.rst:1744 msgid "" "For a naive object, the ``%z`` and ``%Z`` format codes are replaced by empty " "strings." msgstr "" -#: ../src/Doc/library/datetime.rst:1747 +#: library/datetime.rst:1747 msgid "For an aware object:" msgstr "" -#: ../src/Doc/library/datetime.rst:1750 +#: library/datetime.rst:1755 +msgid "%z" +msgstr "" + +#: library/datetime.rst:1750 msgid "" ":meth:`utcoffset` is transformed into a 5-character string of the form +HHMM " "or -HHMM, where HH is a 2-digit string giving the number of UTC offset " @@ -27818,31 +27998,39 @@ msgid "" "minutes=-30)``, ``%z`` is replaced with the string ``'-0330'``." msgstr "" +#: library/datetime.rst:1760 +msgid "%Z" +msgstr "" + # 2f46e59c709340a3888a3d8d7b8de3f6 -#: ../src/Doc/library/datetime.rst:1758 +#: library/datetime.rst:1758 msgid "" "If :meth:`tzname` returns ``None``, ``%Z`` is replaced by an empty string. " "Otherwise ``%Z`` is replaced by the returned value, which must be a string." msgstr "" -#: ../src/Doc/library/datetime.rst:1763 +#: library/datetime.rst:1763 msgid "" "When used with the :meth:`strptime` method, ``%U`` and ``%W`` are only used " "in calculations when the day of the week and the year are specified." msgstr "" # b2d1d18cac164ec68218b33e95b79bcd -#: ../src/Doc/library/datetime.rst:1769 +#: library/datetime.rst:1769 msgid "If, that is, we ignore the effects of Relativity" msgstr "" # 85d46ac13c7b4db2a7f6c28d27a6cbf5 -#: ../src/Doc/library/dbhash.rst:2 +#: library/dbhash.rst:2 msgid ":mod:`dbhash` --- DBM-style interface to the BSD database library" msgstr "" +#: library/dbhash.rst:8 +msgid "The :mod:`dbhash` module has been removed in Python 3." +msgstr "" + # 1f33e24bec7f4654a2fa6b586031f464 -#: ../src/Doc/library/dbhash.rst:13 +#: library/dbhash.rst:13 msgid "" "The :mod:`dbhash` module provides a function to open databases using the BSD " "``db`` library. This module mirrors the interface of the other Python " @@ -27851,83 +28039,76 @@ msgid "" msgstr "" # af3ac0a6d4404b87b9d8e3154ba6b724 -#: ../src/Doc/library/dbhash.rst:18 +#: library/dbhash.rst:18 msgid "This module provides an exception and a function:" msgstr "" # c7763a7d32de43a496c7e9f2c0a23437 -#: ../src/Doc/library/dbhash.rst:23 +#: library/dbhash.rst:23 msgid "" "Exception raised on database errors other than :exc:`KeyError`. It is a " "synonym for :exc:`bsddb.error`." msgstr "" # 3b693158eea7467d899a1e1af1435509 -#: ../src/Doc/library/dbhash.rst:29 +#: library/dbhash.rst:29 msgid "" "Open a ``db`` database and return the database object. The *path* argument " "is the name of the database file." msgstr "" # 10c4353136cc427498a4ef98f9164fc9 -#: ../src/Doc/library/dbhash.rst:32 +#: library/dbhash.rst:32 msgid "The *flag* argument can be:" msgstr "" # 0742295d15ba49f69c317b35f001165e -#: ../src/Doc/library/dbhash.rst:50 +#: library/dbhash.rst:50 msgid "" "For platforms on which the BSD ``db`` library supports locking, an ``'l'`` " "can be appended to indicate that locking should be used." msgstr "" # 94df26c438a44cb9ab5640ba636abae9 -#: ../src/Doc/library/dbhash.rst:53 +#: library/dbhash.rst:53 msgid "" "The optional *mode* parameter is used to indicate the Unix permission bits " "that should be set if a new database must be created; this will be masked by " "the current umask value for the process." msgstr "" -# 21a76cd2b4964fbe890aa6d10f899c11 -# c63cb43b71b24bef8bf077f503b4c417 -# 76d6a6a49c594ee0ab3da86a04beee97 -# cff93a5e331f481ebefa3b39a47c0c86 -# 680295c0c01c42b3acfc7ed899212a0b -#: ../src/Doc/library/dbhash.rst:60 ../src/Doc/library/dbm.rst:78 -#: ../src/Doc/library/dumbdbm.rst:63 ../src/Doc/library/gdbm.rst:126 -#: ../src/Doc/library/shelve.rst:184 -msgid "Module :mod:`anydbm`" -msgstr "" +#: library/dbhash.rst:61 library/dbm.rst:79 library/dumbdbm.rst:64 +#: library/gdbm.rst:127 library/shelve.rst:185 +#, fuzzy +msgid "Module anydbm" +msgstr "Modules" # 2f974add175143ee95b92832c1ab8c67 # c46a7970d34c48748488507261005b06 # 3c0e70fb289a4db2bdc6abd31c21f36e # cb3dd039e8794c91bc511aa7e513a330 # b9b1d2e8847c496fa3e94933abb6bb4e -#: ../src/Doc/library/dbhash.rst:61 ../src/Doc/library/dbm.rst:79 -#: ../src/Doc/library/dumbdbm.rst:64 ../src/Doc/library/gdbm.rst:127 -#: ../src/Doc/library/shelve.rst:185 +#: library/dbhash.rst:61 library/dbm.rst:79 library/dumbdbm.rst:64 +#: library/gdbm.rst:127 library/shelve.rst:185 msgid "Generic interface to ``dbm``\\ -style databases." msgstr "" -# 42d1daefc7664736a40b938c94da1ff3 -# 69c7420a3ce040468281091abb896ad1 -#: ../src/Doc/library/dbhash.rst:63 ../src/Doc/library/shelve.rst:187 -msgid "Module :mod:`bsddb`" -msgstr "" +#: library/dbhash.rst:64 library/shelve.rst:188 +#, fuzzy +msgid "Module bsddb" +msgstr "Modules" # 681e674ccda74be38042929d95d0b795 -#: ../src/Doc/library/dbhash.rst:64 +#: library/dbhash.rst:64 msgid "Lower-level interface to the BSD ``db`` library." msgstr "" -#: ../src/Doc/library/dbhash.rst:73 ../src/Doc/library/msilib.rst:133 +#: library/dbhash.rst:73 library/msilib.rst:133 msgid "Database Objects" msgstr "" # 2a97beac1c914f34a15282fb673ae892 -#: ../src/Doc/library/dbhash.rst:75 +#: library/dbhash.rst:75 msgid "" "The database objects returned by :func:`.open` provide the methods common " "to all the DBM-style databases and mapping objects. The following methods " @@ -27935,7 +28116,7 @@ msgid "" msgstr "" # 2f7aa07b78c14315a112016b79108c22 -#: ../src/Doc/library/dbhash.rst:82 +#: library/dbhash.rst:82 msgid "" "It's possible to loop over every key/value pair in the database using this " "method and the :meth:`!next` method. The traversal is ordered by the " @@ -27944,14 +28125,14 @@ msgid "" msgstr "" # c173aeb53f6641e0b996ac7caadde459 -#: ../src/Doc/library/dbhash.rst:90 +#: library/dbhash.rst:90 msgid "" "Return the last key/value pair in a database traversal. This may be used to " "begin a reverse-order traversal; see :meth:`previous`." msgstr "" # ff942956e9804758956f3bc49d247e9a -#: ../src/Doc/library/dbhash.rst:96 +#: library/dbhash.rst:96 msgid "" "Returns the key next key/value pair in a database traversal. The following " "code prints every key in the database ``db``, without having to create a " @@ -27959,7 +28140,7 @@ msgid "" msgstr "" # 3c9750abdd6c479787e47db401340180 -#: ../src/Doc/library/dbhash.rst:107 +#: library/dbhash.rst:107 msgid "" "Returns the previous key/value pair in a forward-traversal of the database. " "In conjunction with :meth:`last`, this may be used to implement a reverse-" @@ -27967,17 +28148,17 @@ msgid "" msgstr "" # fe22d281bc1d4baeb64c1884c2921e7d -#: ../src/Doc/library/dbhash.rst:114 +#: library/dbhash.rst:114 msgid "This method forces any unwritten data to be written to the disk." msgstr "" # 5009b72ae55147aabdec39ce2db0b766 -#: ../src/Doc/library/dbm.rst:2 +#: library/dbm.rst:2 msgid ":mod:`dbm` --- Simple \"database\" interface" msgstr "" # 802c5b5ccdd34e1d9c4a7d6997df7cca -#: ../src/Doc/library/dbm.rst:9 +#: library/dbm.rst:9 msgid "" "The :mod:`dbm` module has been renamed to :mod:`dbm.ndbm` in Python 3. The :" "term:`2to3` tool will automatically adapt imports when converting your " @@ -27985,7 +28166,7 @@ msgid "" msgstr "" # 576982b4ea21489daab9e26aa1423286 -#: ../src/Doc/library/dbm.rst:14 +#: library/dbm.rst:14 msgid "" "The :mod:`dbm` module provides an interface to the Unix \"(n)dbm\" library. " "Dbm objects behave like mappings (dictionaries), except that keys and values " @@ -27993,7 +28174,7 @@ msgid "" "and the :meth:`items` and :meth:`values` methods are not supported." msgstr "" -#: ../src/Doc/library/dbm.rst:19 +#: library/dbm.rst:19 msgid "" "This module can be used with the \"classic\" ndbm interface, the BSD DB " "compatibility interface, or the GNU GDBM compatibility interface. On Unix, " @@ -28001,24 +28182,23 @@ msgid "" "header file to simplify building this module." msgstr "" -#: ../src/Doc/library/dbm.rst:24 ../src/Doc/library/dumbdbm.rst:26 -#: ../src/Doc/library/select.rst:17 +#: library/dbm.rst:24 library/dumbdbm.rst:26 library/select.rst:17 msgid "The module defines the following:" msgstr "" # 0199b465c80b4c648dd2543a96c338e6 -#: ../src/Doc/library/dbm.rst:29 +#: library/dbm.rst:29 msgid "" "Raised on dbm-specific errors, such as I/O errors. :exc:`KeyError` is raised " "for general mapping errors like specifying an incorrect key." msgstr "" -#: ../src/Doc/library/dbm.rst:35 +#: library/dbm.rst:35 msgid "Name of the ``ndbm`` implementation library used." msgstr "" # 17978e0b00224c51bcc166b32d59f2cb -#: ../src/Doc/library/dbm.rst:40 +#: library/dbm.rst:40 msgid "" "Open a dbm database and return a dbm object. The *filename* argument is the " "name of the database file (without the :file:`.dir` or :file:`.pag` " @@ -28027,28 +28207,28 @@ msgid "" msgstr "" # f94090ad8687465e90249ace651ed51b -#: ../src/Doc/library/dbm.rst:67 +#: library/dbm.rst:67 msgid "" "In addition to the dictionary-like methods, ``dbm`` objects provide the " "following method:" msgstr "" # c46a7970d34c48748488507261005b06 -#: ../src/Doc/library/dbm.rst:73 +#: library/dbm.rst:73 msgid "Close the ``dbm`` database." msgstr "" # acbed54a7d1c4e0c9e3fe9aad7fbc414 # ad12ed3b6d0043d890a2925f384363c4 -#: ../src/Doc/library/dbm.rst:82 ../src/Doc/library/dumbdbm.rst:70 +#: library/dbm.rst:82 library/dumbdbm.rst:70 msgid "Similar interface to the GNU GDBM library." msgstr "" -#: ../src/Doc/library/debug.rst:3 +#: library/debug.rst:3 msgid "Debugging and Profiling" msgstr "" -#: ../src/Doc/library/debug.rst:5 +#: library/debug.rst:5 msgid "" "These libraries help you with Python development: the debugger enables you " "to step through code, analyze stack frames and set breakpoints etc., and the " @@ -28056,17 +28236,17 @@ msgid "" "allowing you to identify bottlenecks in your programs." msgstr "" -#: ../src/Doc/library/decimal.rst:3 +#: library/decimal.rst:3 msgid ":mod:`decimal` --- Decimal fixed point and floating point arithmetic" msgstr "" -#: ../src/Doc/library/decimal.rst:29 +#: library/decimal.rst:29 msgid "" "The :mod:`decimal` module provides support for decimal floating point " "arithmetic. It offers several advantages over the :class:`float` datatype:" msgstr "" -#: ../src/Doc/library/decimal.rst:32 +#: library/decimal.rst:32 msgid "" "Decimal \"is based on a floating-point model which was designed with people " "in mind, and necessarily has a paramount guiding principle -- computers must " @@ -28076,7 +28256,7 @@ msgid "" msgstr "" # a0acab779eed4712a0f303e7632f8a31 -#: ../src/Doc/library/decimal.rst:37 +#: library/decimal.rst:37 msgid "" "Decimal numbers can be represented exactly. In contrast, numbers like :" "const:`1.1` and :const:`2.2` do not have exact representations in binary " @@ -28084,7 +28264,7 @@ msgid "" "display as :const:`3.3000000000000003` as it does with binary floating point." msgstr "" -#: ../src/Doc/library/decimal.rst:42 +#: library/decimal.rst:42 msgid "" "The exactness carries over into arithmetic. In decimal floating point, " "``0.1 + 0.1 + 0.1 - 0.3`` is exactly equal to zero. In binary floating " @@ -28094,7 +28274,7 @@ msgid "" "which have strict equality invariants." msgstr "" -#: ../src/Doc/library/decimal.rst:49 +#: library/decimal.rst:49 msgid "" "The decimal module incorporates a notion of significant places so that " "``1.30 + 1.20`` is :const:`2.50`. The trailing zero is kept to indicate " @@ -28104,14 +28284,14 @@ msgid "" "* 1.20`` gives :const:`1.5600`." msgstr "" -#: ../src/Doc/library/decimal.rst:56 +#: library/decimal.rst:56 msgid "" "Unlike hardware based binary floating point, the decimal module has a user " "alterable precision (defaulting to 28 places) which can be as large as " "needed for a given problem:" msgstr "" -#: ../src/Doc/library/decimal.rst:68 +#: library/decimal.rst:68 msgid "" "Both binary and decimal floating point are implemented in terms of published " "standards. While the built-in float type exposes only a modest portion of " @@ -28121,7 +28301,7 @@ msgid "" "using exceptions to block any inexact operations." msgstr "" -#: ../src/Doc/library/decimal.rst:75 +#: library/decimal.rst:75 msgid "" "The decimal module was designed to support \"without prejudice, both exact " "unrounded decimal arithmetic (sometimes called fixed-point arithmetic) and " @@ -28129,13 +28309,13 @@ msgid "" "specification." msgstr "" -#: ../src/Doc/library/decimal.rst:80 +#: library/decimal.rst:80 msgid "" "The module design is centered around three concepts: the decimal number, " "the context for arithmetic, and signals." msgstr "" -#: ../src/Doc/library/decimal.rst:83 +#: library/decimal.rst:83 msgid "" "A decimal number is immutable. It has a sign, coefficient digits, and an " "exponent. To preserve significance, the coefficient digits do not truncate " @@ -28144,7 +28324,7 @@ msgid "" "differentiates :const:`-0` from :const:`+0`." msgstr "" -#: ../src/Doc/library/decimal.rst:89 +#: library/decimal.rst:89 msgid "" "The context for arithmetic is an environment specifying precision, rounding " "rules, limits on exponents, flags indicating the results of operations, and " @@ -28154,7 +28334,7 @@ msgid "" "`ROUND_HALF_UP`, :const:`ROUND_UP`, and :const:`ROUND_05UP`." msgstr "" -#: ../src/Doc/library/decimal.rst:96 +#: library/decimal.rst:96 msgid "" "Signals are groups of exceptional conditions arising during the course of " "computation. Depending on the needs of the application, signals may be " @@ -28164,7 +28344,7 @@ msgid "" "`Subnormal`, :const:`Overflow`, and :const:`Underflow`." msgstr "" -#: ../src/Doc/library/decimal.rst:103 +#: library/decimal.rst:103 msgid "" "For each signal there is a flag and a trap enabler. When a signal is " "encountered, its flag is set to one, then, if the trap enabler is set to " @@ -28173,30 +28353,30 @@ msgid "" msgstr "" # ae2e920b0cbd4a9a891c8be959f38543 -#: ../src/Doc/library/decimal.rst:111 +#: library/decimal.rst:111 msgid "" "IBM's General Decimal Arithmetic Specification, `The General Decimal " "Arithmetic Specification `_." msgstr "" -#: ../src/Doc/library/decimal.rst:114 +#: library/decimal.rst:114 msgid "" "IEEE standard 854-1987, `Unofficial IEEE 854 Text `_." msgstr "" -#: ../src/Doc/library/decimal.rst:123 +#: library/decimal.rst:123 msgid "Quick-start Tutorial" msgstr "" -#: ../src/Doc/library/decimal.rst:125 +#: library/decimal.rst:125 msgid "" "The usual start to using decimals is importing the module, viewing the " "current context with :func:`getcontext` and, if necessary, setting new " "values for precision, rounding, or enabled traps::" msgstr "" -#: ../src/Doc/library/decimal.rst:137 +#: library/decimal.rst:137 msgid "" "Decimal instances can be constructed from integers, strings, floats, or " "tuples. Construction from an integer or a float performs an exact conversion " @@ -28205,53 +28385,53 @@ msgid "" "negative :const:`Infinity`, and :const:`-0`." msgstr "" -#: ../src/Doc/library/decimal.rst:161 +#: library/decimal.rst:161 msgid "" "The significance of a new Decimal is determined solely by the number of " "digits input. Context precision and rounding only come into play during " "arithmetic operations." msgstr "" -#: ../src/Doc/library/decimal.rst:178 +#: library/decimal.rst:178 msgid "" "Decimals interact well with much of the rest of Python. Here is a small " "decimal floating point flying circus:" msgstr "" -#: ../src/Doc/library/decimal.rst:210 +#: library/decimal.rst:210 msgid "And some mathematical functions are also available to Decimal:" msgstr "" -#: ../src/Doc/library/decimal.rst:222 +#: library/decimal.rst:222 msgid "" "The :meth:`quantize` method rounds a number to a fixed exponent. This " "method is useful for monetary applications that often round results to a " "fixed number of places:" msgstr "" -#: ../src/Doc/library/decimal.rst:231 +#: library/decimal.rst:231 msgid "" "As shown above, the :func:`getcontext` function accesses the current context " "and allows the settings to be changed. This approach meets the needs of " "most applications." msgstr "" -#: ../src/Doc/library/decimal.rst:235 +#: library/decimal.rst:235 msgid "" "For more advanced work, it may be useful to create alternate contexts using " "the Context() constructor. To make an alternate active, use the :func:" "`setcontext` function." msgstr "" -#: ../src/Doc/library/decimal.rst:239 +#: library/decimal.rst:239 msgid "" -"In accordance with the standard, the :mod:`Decimal` module provides two " +"In accordance with the standard, the :mod:`decimal` module provides two " "ready to use standard contexts, :const:`BasicContext` and :const:" "`ExtendedContext`. The former is especially useful for debugging because " "many of the traps are enabled:" msgstr "" -#: ../src/Doc/library/decimal.rst:268 +#: library/decimal.rst:268 msgid "" "Contexts also have signal flags for monitoring exceptional conditions " "encountered during computations. The flags remain set until explicitly " @@ -28259,20 +28439,20 @@ msgid "" "computations by using the :meth:`clear_flags` method. ::" msgstr "" -#: ../src/Doc/library/decimal.rst:281 +#: library/decimal.rst:281 msgid "" "The *flags* entry shows that the rational approximation to :const:`Pi` was " "rounded (digits beyond the context precision were thrown away) and that the " "result is inexact (some of the discarded digits were non-zero)." msgstr "" -#: ../src/Doc/library/decimal.rst:285 +#: library/decimal.rst:285 msgid "" "Individual traps are set using the dictionary in the :attr:`traps` field of " "a context:" msgstr "" -#: ../src/Doc/library/decimal.rst:300 +#: library/decimal.rst:300 msgid "" "Most programs adjust the current context only once, at the beginning of the " "program. And, in many applications, data is converted to :class:`Decimal` " @@ -28281,15 +28461,15 @@ msgid "" "Python numeric types." msgstr "" -#: ../src/Doc/library/decimal.rst:312 +#: library/decimal.rst:312 msgid "Decimal objects" msgstr "" -#: ../src/Doc/library/decimal.rst:317 +#: library/decimal.rst:317 msgid "Construct a new :class:`Decimal` object based from *value*." msgstr "" -#: ../src/Doc/library/decimal.rst:319 +#: library/decimal.rst:319 msgid "" "*value* can be an integer, string, tuple, :class:`float`, or another :class:" "`Decimal` object. If no *value* is given, returns ``Decimal('0')``. If " @@ -28298,7 +28478,7 @@ msgid "" msgstr "" # c187fdb23d8e4713822480bd7804572b -#: ../src/Doc/library/decimal.rst:335 +#: library/decimal.rst:335 msgid "" "If *value* is a unicode string then other Unicode decimal digits are also " "permitted where ``digit`` appears above. These include decimal digits from " @@ -28306,7 +28486,7 @@ msgid "" "along with the fullwidth digits ``u'\\uff10'`` through ``u'\\uff19'``." msgstr "" -#: ../src/Doc/library/decimal.rst:341 +#: library/decimal.rst:341 msgid "" "If *value* is a :class:`tuple`, it should have three components, a sign (:" "const:`0` for positive or :const:`1` for negative), a :class:`tuple` of " @@ -28314,7 +28494,7 @@ msgid "" "-3))`` returns ``Decimal('1.414')``." msgstr "" -#: ../src/Doc/library/decimal.rst:346 +#: library/decimal.rst:346 msgid "" "If *value* is a :class:`float`, the binary floating point value is " "losslessly converted to its exact decimal equivalent. This conversion can " @@ -28323,7 +28503,7 @@ msgid "" "``Decimal('1.100000000000000088817841970012523233890533447265625')``." msgstr "" -#: ../src/Doc/library/decimal.rst:352 +#: library/decimal.rst:352 msgid "" "The *context* precision does not affect how many digits are stored. That is " "determined exclusively by the number of digits in *value*. For example, " @@ -28331,7 +28511,7 @@ msgid "" "is only three." msgstr "" -#: ../src/Doc/library/decimal.rst:357 +#: library/decimal.rst:357 msgid "" "The purpose of the *context* argument is determining what to do if *value* " "is a malformed string. If the context traps :const:`InvalidOperation`, an " @@ -28339,12 +28519,24 @@ msgid "" "the value of :const:`NaN`." msgstr "" -#: ../src/Doc/library/decimal.rst:362 +#: library/decimal.rst:362 msgid "Once constructed, :class:`Decimal` objects are immutable." msgstr "" +#: library/decimal.rst:364 +msgid "" +"leading and trailing whitespace characters are permitted when creating a " +"Decimal instance from a string." +msgstr "" + +#: library/decimal.rst:368 +msgid "" +"The argument to the constructor is now permitted to be a :class:`float` " +"instance." +msgstr "" + # cd31f1efcdd84fd7bf25c5a274b2754b -#: ../src/Doc/library/decimal.rst:371 +#: library/decimal.rst:371 msgid "" "Decimal floating point objects share many properties with the other built-in " "numeric types such as :class:`float` and :class:`int`. All of the usual " @@ -28355,7 +28547,7 @@ msgid "" msgstr "" # ce9980344cd5440c8013ed05cd2e2838 -#: ../src/Doc/library/decimal.rst:378 +#: library/decimal.rst:378 msgid "" "There are some small differences between arithmetic on Decimal objects and " "arithmetic on integers and floats. When the remainder operator ``%`` is " @@ -28364,7 +28556,7 @@ msgid "" msgstr "" # 16927c666dd54934ac2f1bbd687dbe12 -#: ../src/Doc/library/decimal.rst:388 +#: library/decimal.rst:388 msgid "" "The integer division operator ``//`` behaves analogously, returning the " "integer part of the true quotient (truncating towards zero) rather than its " @@ -28372,14 +28564,14 @@ msgid "" msgstr "" # 5e56251d9ba04db685f891cabe103acf -#: ../src/Doc/library/decimal.rst:397 +#: library/decimal.rst:397 msgid "" "The ``%`` and ``//`` operators implement the ``remainder`` and ``divide-" "integer`` operations (respectively) as described in the specification." msgstr "" # 0f4e189d699a45f8a11580a770ba6f29 -#: ../src/Doc/library/decimal.rst:401 +#: library/decimal.rst:401 msgid "" "Decimal objects cannot generally be combined with floats in arithmetic " "operations: an attempt to add a :class:`Decimal` to a :class:`float`, for " @@ -28392,13 +28584,21 @@ msgid "" "to confusing results." msgstr "" -#: ../src/Doc/library/decimal.rst:419 +#: library/decimal.rst:412 +msgid "" +"A comparison between a :class:`float` instance ``x`` and a :class:`Decimal` " +"instance ``y`` now returns a result based on the values of ``x`` and ``y``. " +"In earlier versions ``x < y`` returned the same (arbitrary) result for any :" +"class:`Decimal` instance ``x`` and any :class:`float` instance ``y``." +msgstr "" + +#: library/decimal.rst:419 msgid "" "In addition to the standard numeric properties, decimal floating point " "objects also have a number of specialized methods:" msgstr "" -#: ../src/Doc/library/decimal.rst:425 +#: library/decimal.rst:425 msgid "" "Return the adjusted exponent after shifting out the coefficient's rightmost " "digits until only the lead digit remains: ``Decimal('321e+5').adjusted()`` " @@ -28406,13 +28606,17 @@ msgid "" "digit with respect to the decimal point." msgstr "" -#: ../src/Doc/library/decimal.rst:433 +#: library/decimal.rst:433 msgid "" "Return a :term:`named tuple` representation of the number: " "``DecimalTuple(sign, digits, exponent)``." msgstr "" -#: ../src/Doc/library/decimal.rst:442 +#: library/decimal.rst:436 library/doctest.rst:1561 +msgid "Use a named tuple." +msgstr "" + +#: library/decimal.rst:442 msgid "" "Return the canonical encoding of the argument. Currently, the encoding of " "a :class:`Decimal` instance is always canonical, so this operation returns " @@ -28420,7 +28624,7 @@ msgid "" msgstr "" # ec5020d85b6f421da141b64e300f6843 -#: ../src/Doc/library/decimal.rst:450 +#: library/decimal.rst:450 msgid "" "Compare the values of two Decimal instances. This operation behaves in the " "same way as the usual comparison method :meth:`__cmp__`, except that :meth:" @@ -28428,14 +28632,14 @@ msgid "" "operand is a NaN then the result is a NaN::" msgstr "" -#: ../src/Doc/library/decimal.rst:462 +#: library/decimal.rst:462 msgid "" "This operation is identical to the :meth:`compare` method, except that all " "NaNs signal. That is, if neither operand is a signaling NaN then any quiet " "NaN operand is treated as though it were a signaling NaN." msgstr "" -#: ../src/Doc/library/decimal.rst:470 +#: library/decimal.rst:470 msgid "" "Compare two operands using their abstract representation rather than their " "numerical value. Similar to the :meth:`compare` method, but the result " @@ -28444,7 +28648,7 @@ msgid "" "unequal in this ordering:" msgstr "" -#: ../src/Doc/library/decimal.rst:479 +#: library/decimal.rst:479 msgid "" "Quiet and signaling NaNs are also included in the total ordering. The " "result of this function is ``Decimal('0')`` if both operands have the same " @@ -28454,7 +28658,7 @@ msgid "" "details of the total order." msgstr "" -#: ../src/Doc/library/decimal.rst:490 +#: library/decimal.rst:490 msgid "" "Compare two operands using their abstract representation rather than their " "value as in :meth:`compare_total`, but ignoring the sign of each operand. " @@ -28462,48 +28666,48 @@ msgid "" "copy_abs())``." msgstr "" -#: ../src/Doc/library/decimal.rst:499 +#: library/decimal.rst:499 msgid "" "Just returns self, this method is only to comply with the Decimal " "Specification." msgstr "" -#: ../src/Doc/library/decimal.rst:506 +#: library/decimal.rst:506 msgid "" "Return the absolute value of the argument. This operation is unaffected by " "the context and is quiet: no flags are changed and no rounding is performed." msgstr "" -#: ../src/Doc/library/decimal.rst:514 +#: library/decimal.rst:514 msgid "" "Return the negation of the argument. This operation is unaffected by the " "context and is quiet: no flags are changed and no rounding is performed." msgstr "" -#: ../src/Doc/library/decimal.rst:521 +#: library/decimal.rst:521 msgid "" "Return a copy of the first operand with the sign set to be the same as the " "sign of the second operand. For example:" msgstr "" -#: ../src/Doc/library/decimal.rst:527 +#: library/decimal.rst:527 msgid "" "This operation is unaffected by the context and is quiet: no flags are " "changed and no rounding is performed." msgstr "" -#: ../src/Doc/library/decimal.rst:534 +#: library/decimal.rst:534 msgid "" "Return the value of the (natural) exponential function ``e**x`` at the given " "number. The result is correctly rounded using the :const:`ROUND_HALF_EVEN` " "rounding mode." msgstr "" -#: ../src/Doc/library/decimal.rst:547 +#: library/decimal.rst:547 msgid "Classmethod that converts a float to a decimal number, exactly." msgstr "" -#: ../src/Doc/library/decimal.rst:549 +#: library/decimal.rst:549 msgid "" "Note `Decimal.from_float(0.1)` is not the same as `Decimal('0.1')`. Since " "0.1 is not exactly representable in binary floating point, the value is " @@ -28513,45 +28717,45 @@ msgid "" msgstr "" # 8040433817cb4e18aacf8ca787e8046b -#: ../src/Doc/library/decimal.rst:555 +#: library/decimal.rst:555 msgid "" "From Python 2.7 onwards, a :class:`Decimal` instance can also be constructed " "directly from a :class:`float`." msgstr "" -#: ../src/Doc/library/decimal.rst:573 +#: library/decimal.rst:573 msgid "" "Fused multiply-add. Return self*other+third with no rounding of the " "intermediate product self*other." msgstr "" -#: ../src/Doc/library/decimal.rst:583 +#: library/decimal.rst:583 msgid "" "Return :const:`True` if the argument is canonical and :const:`False` " "otherwise. Currently, a :class:`Decimal` instance is always canonical, so " "this operation always returns :const:`True`." msgstr "" -#: ../src/Doc/library/decimal.rst:591 +#: library/decimal.rst:591 msgid "" "Return :const:`True` if the argument is a finite number, and :const:`False` " "if the argument is an infinity or a NaN." msgstr "" -#: ../src/Doc/library/decimal.rst:598 +#: library/decimal.rst:598 msgid "" "Return :const:`True` if the argument is either positive or negative infinity " "and :const:`False` otherwise." msgstr "" -#: ../src/Doc/library/decimal.rst:605 +#: library/decimal.rst:605 msgid "" "Return :const:`True` if the argument is a (quiet or signaling) NaN and :" "const:`False` otherwise." msgstr "" # 7c32dad2436d4fba94f546089a848437 -#: ../src/Doc/library/decimal.rst:612 +#: library/decimal.rst:612 msgid "" "Return :const:`True` if the argument is a *normal* finite non-zero number " "with an adjusted exponent greater than or equal to *Emin*. Return :const:" @@ -28560,51 +28764,51 @@ msgid "" "method which is used to create canonical values." msgstr "" -#: ../src/Doc/library/decimal.rst:622 +#: library/decimal.rst:622 msgid "" "Return :const:`True` if the argument is a quiet NaN, and :const:`False` " "otherwise." msgstr "" -#: ../src/Doc/library/decimal.rst:629 +#: library/decimal.rst:629 msgid "" "Return :const:`True` if the argument has a negative sign and :const:`False` " "otherwise. Note that zeros and NaNs can both carry signs." msgstr "" -#: ../src/Doc/library/decimal.rst:636 +#: library/decimal.rst:636 msgid "" "Return :const:`True` if the argument is a signaling NaN and :const:`False` " "otherwise." msgstr "" # 646b055185744cdea3939006d6a2a84c -#: ../src/Doc/library/decimal.rst:643 +#: library/decimal.rst:643 msgid "" "Return :const:`True` if the argument is subnormal, and :const:`False` " "otherwise. A number is subnormal is if it is nonzero, finite, and has an " "adjusted exponent less than *Emin*." msgstr "" -#: ../src/Doc/library/decimal.rst:651 +#: library/decimal.rst:651 msgid "" "Return :const:`True` if the argument is a (positive or negative) zero and :" "const:`False` otherwise." msgstr "" -#: ../src/Doc/library/decimal.rst:658 +#: library/decimal.rst:658 msgid "" "Return the natural (base e) logarithm of the operand. The result is " "correctly rounded using the :const:`ROUND_HALF_EVEN` rounding mode." msgstr "" -#: ../src/Doc/library/decimal.rst:665 +#: library/decimal.rst:665 msgid "" "Return the base ten logarithm of the operand. The result is correctly " "rounded using the :const:`ROUND_HALF_EVEN` rounding mode." msgstr "" -#: ../src/Doc/library/decimal.rst:672 +#: library/decimal.rst:672 msgid "" "For a nonzero number, return the adjusted exponent of its operand as a :" "class:`Decimal` instance. If the operand is a zero then ``Decimal('-" @@ -28612,74 +28816,74 @@ msgid "" "the operand is an infinity then ``Decimal('Infinity')`` is returned." msgstr "" -#: ../src/Doc/library/decimal.rst:682 +#: library/decimal.rst:682 msgid "" ":meth:`logical_and` is a logical operation which takes two *logical " "operands* (see :ref:`logical_operands_label`). The result is the digit-wise " "``and`` of the two operands." msgstr "" -#: ../src/Doc/library/decimal.rst:690 +#: library/decimal.rst:690 msgid "" ":meth:`logical_invert` is a logical operation. The result is the digit-wise " "inversion of the operand." msgstr "" -#: ../src/Doc/library/decimal.rst:697 +#: library/decimal.rst:697 msgid "" ":meth:`logical_or` is a logical operation which takes two *logical operands* " "(see :ref:`logical_operands_label`). The result is the digit-wise ``or`` of " "the two operands." msgstr "" -#: ../src/Doc/library/decimal.rst:705 +#: library/decimal.rst:705 msgid "" ":meth:`logical_xor` is a logical operation which takes two *logical " "operands* (see :ref:`logical_operands_label`). The result is the digit-wise " "exclusive or of the two operands." msgstr "" -#: ../src/Doc/library/decimal.rst:713 +#: library/decimal.rst:713 msgid "" "Like ``max(self, other)`` except that the context rounding rule is applied " "before returning and that :const:`NaN` values are either signaled or ignored " "(depending on the context and whether they are signaling or quiet)." msgstr "" -#: ../src/Doc/library/decimal.rst:720 +#: library/decimal.rst:720 msgid "" "Similar to the :meth:`.max` method, but the comparison is done using the " "absolute values of the operands." msgstr "" -#: ../src/Doc/library/decimal.rst:727 +#: library/decimal.rst:727 msgid "" "Like ``min(self, other)`` except that the context rounding rule is applied " "before returning and that :const:`NaN` values are either signaled or ignored " "(depending on the context and whether they are signaling or quiet)." msgstr "" -#: ../src/Doc/library/decimal.rst:734 +#: library/decimal.rst:734 msgid "" "Similar to the :meth:`.min` method, but the comparison is done using the " "absolute values of the operands." msgstr "" -#: ../src/Doc/library/decimal.rst:741 +#: library/decimal.rst:741 msgid "" "Return the largest number representable in the given context (or in the " "current thread's context if no context is given) that is smaller than the " "given operand." msgstr "" -#: ../src/Doc/library/decimal.rst:749 +#: library/decimal.rst:749 msgid "" "Return the smallest number representable in the given context (or in the " "current thread's context if no context is given) that is larger than the " "given operand." msgstr "" -#: ../src/Doc/library/decimal.rst:757 +#: library/decimal.rst:757 msgid "" "If the two operands are unequal, return the number closest to the first " "operand in the direction of the second operand. If both operands are " @@ -28688,7 +28892,7 @@ msgid "" msgstr "" # de73aeebf8604f6cb514a3f06a04d85c -#: ../src/Doc/library/decimal.rst:766 +#: library/decimal.rst:766 msgid "" "Normalize the number by stripping the rightmost trailing zeros and " "converting any result equal to :const:`Decimal('0')` to :const:" @@ -28698,63 +28902,63 @@ msgid "" "``Decimal('32.1')``." msgstr "" -#: ../src/Doc/library/decimal.rst:775 +#: library/decimal.rst:775 msgid "" "Return a string describing the *class* of the operand. The returned value " "is one of the following ten strings." msgstr "" -#: ../src/Doc/library/decimal.rst:778 +#: library/decimal.rst:778 msgid "``\"-Infinity\"``, indicating that the operand is negative infinity." msgstr "" -#: ../src/Doc/library/decimal.rst:779 +#: library/decimal.rst:779 msgid "" "``\"-Normal\"``, indicating that the operand is a negative normal number." msgstr "" -#: ../src/Doc/library/decimal.rst:780 +#: library/decimal.rst:780 msgid "" "``\"-Subnormal\"``, indicating that the operand is negative and subnormal." msgstr "" -#: ../src/Doc/library/decimal.rst:781 +#: library/decimal.rst:781 msgid "``\"-Zero\"``, indicating that the operand is a negative zero." msgstr "" -#: ../src/Doc/library/decimal.rst:782 +#: library/decimal.rst:782 msgid "``\"+Zero\"``, indicating that the operand is a positive zero." msgstr "" -#: ../src/Doc/library/decimal.rst:783 +#: library/decimal.rst:783 msgid "" "``\"+Subnormal\"``, indicating that the operand is positive and subnormal." msgstr "" -#: ../src/Doc/library/decimal.rst:784 +#: library/decimal.rst:784 msgid "" "``\"+Normal\"``, indicating that the operand is a positive normal number." msgstr "" -#: ../src/Doc/library/decimal.rst:785 +#: library/decimal.rst:785 msgid "``\"+Infinity\"``, indicating that the operand is positive infinity." msgstr "" -#: ../src/Doc/library/decimal.rst:786 +#: library/decimal.rst:786 msgid "``\"NaN\"``, indicating that the operand is a quiet NaN (Not a Number)." msgstr "" -#: ../src/Doc/library/decimal.rst:787 +#: library/decimal.rst:787 msgid "``\"sNaN\"``, indicating that the operand is a signaling NaN." msgstr "" -#: ../src/Doc/library/decimal.rst:793 +#: library/decimal.rst:793 msgid "" "Return a value equal to the first operand after rounding and having the " "exponent of the second operand." msgstr "" -#: ../src/Doc/library/decimal.rst:799 +#: library/decimal.rst:799 msgid "" "Unlike other operations, if the length of the coefficient after the quantize " "operation would be greater than precision, then an :const:`InvalidOperation` " @@ -28762,13 +28966,13 @@ msgid "" "quantized exponent is always equal to that of the right-hand operand." msgstr "" -#: ../src/Doc/library/decimal.rst:805 +#: library/decimal.rst:805 msgid "" "Also unlike other operations, quantize never signals Underflow, even if the " "result is subnormal and inexact." msgstr "" -#: ../src/Doc/library/decimal.rst:808 +#: library/decimal.rst:808 msgid "" "If the exponent of the second operand is larger than that of the first then " "rounding may be necessary. In this case, the rounding mode is determined by " @@ -28777,20 +28981,20 @@ msgid "" "context is used." msgstr "" -#: ../src/Doc/library/decimal.rst:814 +#: library/decimal.rst:814 msgid "" "If *watchexp* is set (default), then an error is returned whenever the " "resulting exponent is greater than :attr:`Emax` or less than :attr:`Etiny`." msgstr "" -#: ../src/Doc/library/decimal.rst:820 +#: library/decimal.rst:820 msgid "" "Return ``Decimal(10)``, the radix (base) in which the :class:`Decimal` class " "does all its arithmetic. Included for compatibility with the specification." msgstr "" # 10f82040776640b6b16c38cd45d82403 -#: ../src/Doc/library/decimal.rst:828 +#: library/decimal.rst:828 msgid "" "Return the remainder from dividing *self* by *other*. This differs from " "``self % other`` in that the sign of the remainder is chosen so as to " @@ -28800,11 +29004,11 @@ msgid "" msgstr "" # e7fafbfd83c043dab7f576cfd58684c4 -#: ../src/Doc/library/decimal.rst:835 +#: library/decimal.rst:835 msgid "If the result is zero then its sign will be the sign of *self*." msgstr "" -#: ../src/Doc/library/decimal.rst:846 +#: library/decimal.rst:846 msgid "" "Return the result of rotating the digits of the first operand by an amount " "specified by the second operand. The second operand must be an integer in " @@ -28816,20 +29020,20 @@ msgid "" "are unchanged." msgstr "" -#: ../src/Doc/library/decimal.rst:859 +#: library/decimal.rst:859 msgid "" "Test whether self and other have the same exponent or whether both are :" "const:`NaN`." msgstr "" -#: ../src/Doc/library/decimal.rst:864 +#: library/decimal.rst:864 msgid "" "Return the first operand with exponent adjusted by the second. Equivalently, " "return the first operand multiplied by ``10**other``. The second operand " "must be an integer." msgstr "" -#: ../src/Doc/library/decimal.rst:872 +#: library/decimal.rst:872 msgid "" "Return the result of shifting the digits of the first operand by an amount " "specified by the second operand. The second operand must be an integer in " @@ -28840,28 +29044,28 @@ msgid "" "exponent of the first operand are unchanged." msgstr "" -#: ../src/Doc/library/decimal.rst:884 +#: library/decimal.rst:884 msgid "Return the square root of the argument to full precision." msgstr "" -#: ../src/Doc/library/decimal.rst:889 +#: library/decimal.rst:889 msgid "Convert to an engineering-type string." msgstr "" -#: ../src/Doc/library/decimal.rst:891 +#: library/decimal.rst:891 msgid "" "Engineering notation has an exponent which is a multiple of 3, so there are " "up to 3 digits left of the decimal place. For example, converts " -"``Decimal('123E+1')`` to ``Decimal('1.23E+3')``" +"``Decimal('123E+1')`` to ``Decimal('1.23E+3')``." msgstr "" -#: ../src/Doc/library/decimal.rst:897 +#: library/decimal.rst:897 msgid "" "Identical to the :meth:`to_integral_value` method. The ``to_integral`` name " "has been kept for compatibility with older versions." msgstr "" -#: ../src/Doc/library/decimal.rst:902 +#: library/decimal.rst:902 msgid "" "Round to the nearest integer, signaling :const:`Inexact` or :const:`Rounded` " "as appropriate if rounding occurs. The rounding mode is determined by the " @@ -28869,18 +29073,24 @@ msgid "" "parameter is given then the rounding mode of the current context is used." msgstr "" -#: ../src/Doc/library/decimal.rst:912 +#: library/decimal.rst:912 msgid "" "Round to the nearest integer without signaling :const:`Inexact` or :const:" "`Rounded`. If given, applies *rounding*; otherwise, uses the rounding " "method in either the supplied *context* or the current context." msgstr "" -#: ../src/Doc/library/decimal.rst:923 +#: library/decimal.rst:916 +msgid "" +"renamed from ``to_integral`` to ``to_integral_value``. The old name remains " +"valid for compatibility." +msgstr "" + +#: library/decimal.rst:923 msgid "Logical operands" msgstr "" -#: ../src/Doc/library/decimal.rst:925 +#: library/decimal.rst:925 msgid "" "The :meth:`logical_and`, :meth:`logical_invert`, :meth:`logical_or`, and :" "meth:`logical_xor` methods expect their arguments to be *logical operands*. " @@ -28888,40 +29098,40 @@ msgid "" "are both zero, and whose digits are all either :const:`0` or :const:`1`." msgstr "" -#: ../src/Doc/library/decimal.rst:937 +#: library/decimal.rst:937 msgid "Context objects" msgstr "" -#: ../src/Doc/library/decimal.rst:939 +#: library/decimal.rst:939 msgid "" "Contexts are environments for arithmetic operations. They govern precision, " "set rules for rounding, determine which signals are treated as exceptions, " "and limit the range for exponents." msgstr "" -#: ../src/Doc/library/decimal.rst:943 +#: library/decimal.rst:943 msgid "" "Each thread has its own current context which is accessed or changed using " "the :func:`getcontext` and :func:`setcontext` functions:" msgstr "" -#: ../src/Doc/library/decimal.rst:949 +#: library/decimal.rst:949 msgid "Return the current context for the active thread." msgstr "" -#: ../src/Doc/library/decimal.rst:954 +#: library/decimal.rst:954 msgid "Set the current context for the active thread to *c*." msgstr "" # 12bfbd12a66f4836a281a7d41a0ce907 -#: ../src/Doc/library/decimal.rst:956 +#: library/decimal.rst:956 msgid "" "Beginning with Python 2.5, you can also use the :keyword:`with` statement " "and the :func:`localcontext` function to temporarily change the active " "context." msgstr "" -#: ../src/Doc/library/decimal.rst:962 +#: library/decimal.rst:962 msgid "" "Return a context manager that will set the current context for the active " "thread to a copy of *c* on entry to the with-statement and restore the " @@ -28929,20 +29139,20 @@ msgid "" "specified, a copy of the current context is used." msgstr "" -#: ../src/Doc/library/decimal.rst:969 +#: library/decimal.rst:969 msgid "" "For example, the following code sets the current decimal precision to 42 " "places, performs a calculation, and then automatically restores the previous " "context::" msgstr "" -#: ../src/Doc/library/decimal.rst:983 +#: library/decimal.rst:983 msgid "" "New contexts can also be created using the :class:`Context` constructor " "described below. In addition, the module provides three pre-made contexts:" msgstr "" -#: ../src/Doc/library/decimal.rst:989 +#: library/decimal.rst:989 msgid "" "This is a standard context defined by the General Decimal Arithmetic " "Specification. Precision is set to nine. Rounding is set to :const:" @@ -28951,12 +29161,12 @@ msgid "" "`Subnormal`." msgstr "" -#: ../src/Doc/library/decimal.rst:995 +#: library/decimal.rst:995 msgid "" "Because many of the traps are enabled, this context is useful for debugging." msgstr "" -#: ../src/Doc/library/decimal.rst:1000 +#: library/decimal.rst:1000 msgid "" "This is a standard context defined by the General Decimal Arithmetic " "Specification. Precision is set to nine. Rounding is set to :const:" @@ -28964,7 +29174,7 @@ msgid "" "exceptions are not raised during computations)." msgstr "" -#: ../src/Doc/library/decimal.rst:1005 +#: library/decimal.rst:1005 msgid "" "Because the traps are disabled, this context is useful for applications that " "prefer to have result value of :const:`NaN` or :const:`Infinity` instead of " @@ -28972,7 +29182,7 @@ msgid "" "presence of conditions that would otherwise halt the program." msgstr "" -#: ../src/Doc/library/decimal.rst:1013 +#: library/decimal.rst:1013 msgid "" "This context is used by the :class:`Context` constructor as a prototype for " "new contexts. Changing a field (such a precision) has the effect of " @@ -28980,7 +29190,7 @@ msgid "" "constructor." msgstr "" -#: ../src/Doc/library/decimal.rst:1017 +#: library/decimal.rst:1017 msgid "" "This context is most useful in multi-threaded environments. Changing one of " "the fields before threads are started has the effect of setting system-wide " @@ -28988,98 +29198,102 @@ msgid "" "as it would require thread synchronization to prevent race conditions." msgstr "" -#: ../src/Doc/library/decimal.rst:1022 +#: library/decimal.rst:1022 msgid "" "In single threaded environments, it is preferable to not use this context at " "all. Instead, simply create contexts explicitly as described below." msgstr "" -#: ../src/Doc/library/decimal.rst:1025 +#: library/decimal.rst:1025 msgid "" "The default values are precision=28, rounding=ROUND_HALF_EVEN, and enabled " "traps for Overflow, InvalidOperation, and DivisionByZero." msgstr "" -#: ../src/Doc/library/decimal.rst:1028 +#: library/decimal.rst:1028 msgid "" "In addition to the three supplied contexts, new contexts can be created with " "the :class:`Context` constructor." msgstr "" -#: ../src/Doc/library/decimal.rst:1034 +#: library/decimal.rst:1034 msgid "" "Creates a new context. If a field is not specified or is :const:`None`, the " "default values are copied from the :const:`DefaultContext`. If the *flags* " "field is not specified or is :const:`None`, all flags are cleared." msgstr "" -#: ../src/Doc/library/decimal.rst:1038 +#: library/decimal.rst:1038 msgid "" "The *prec* field is a positive integer that sets the precision for " "arithmetic operations in the context." msgstr "" -#: ../src/Doc/library/decimal.rst:1041 +#: library/decimal.rst:1041 msgid "The *rounding* option is one of:" msgstr "" -#: ../src/Doc/library/decimal.rst:1043 +#: library/decimal.rst:1043 msgid ":const:`ROUND_CEILING` (towards :const:`Infinity`)," msgstr "" -#: ../src/Doc/library/decimal.rst:1044 +#: library/decimal.rst:1044 msgid ":const:`ROUND_DOWN` (towards zero)," msgstr "" -#: ../src/Doc/library/decimal.rst:1045 +#: library/decimal.rst:1045 msgid ":const:`ROUND_FLOOR` (towards :const:`-Infinity`)," msgstr "" -#: ../src/Doc/library/decimal.rst:1046 +#: library/decimal.rst:1046 msgid ":const:`ROUND_HALF_DOWN` (to nearest with ties going towards zero)," msgstr "" -#: ../src/Doc/library/decimal.rst:1047 +#: library/decimal.rst:1047 msgid "" ":const:`ROUND_HALF_EVEN` (to nearest with ties going to nearest even " "integer)," msgstr "" -#: ../src/Doc/library/decimal.rst:1048 +#: library/decimal.rst:1048 msgid ":const:`ROUND_HALF_UP` (to nearest with ties going away from zero), or" msgstr "" -#: ../src/Doc/library/decimal.rst:1049 +#: library/decimal.rst:1049 msgid ":const:`ROUND_UP` (away from zero)." msgstr "" -#: ../src/Doc/library/decimal.rst:1050 +#: library/decimal.rst:1050 msgid "" ":const:`ROUND_05UP` (away from zero if last digit after rounding towards " "zero would have been 0 or 5; otherwise towards zero)" msgstr "" -#: ../src/Doc/library/decimal.rst:1053 +#: library/decimal.rst:1053 msgid "" "The *traps* and *flags* fields list any signals to be set. Generally, new " "contexts should only set traps and leave the flags clear." msgstr "" -#: ../src/Doc/library/decimal.rst:1056 +#: library/decimal.rst:1056 msgid "" "The *Emin* and *Emax* fields are integers specifying the outer limits " "allowable for exponents." msgstr "" -#: ../src/Doc/library/decimal.rst:1059 +#: library/decimal.rst:1059 msgid "" "The *capitals* field is either :const:`0` or :const:`1` (the default). If " "set to :const:`1`, exponents are printed with a capital :const:`E`; " "otherwise, a lowercase :const:`e` is used: :const:`Decimal('6.02e+23')`." msgstr "" +#: library/decimal.rst:1063 +msgid "The :const:`ROUND_05UP` rounding mode was added." +msgstr "" + # 250ede4e04964bc79f947472707f779a -#: ../src/Doc/library/decimal.rst:1066 +#: library/decimal.rst:1066 msgid "" "The :class:`Context` class defines several general purpose methods as well " "as a large number of methods for doing arithmetic directly in a given " @@ -29092,26 +29306,26 @@ msgid "" "`long`) anywhere that a Decimal instance is accepted." msgstr "" -#: ../src/Doc/library/decimal.rst:1079 +#: library/decimal.rst:1079 msgid "Resets all of the flags to :const:`0`." msgstr "" -#: ../src/Doc/library/decimal.rst:1083 +#: library/decimal.rst:1083 msgid "Return a duplicate of the context." msgstr "" -#: ../src/Doc/library/decimal.rst:1087 +#: library/decimal.rst:1087 msgid "Return a copy of the Decimal instance num." msgstr "" -#: ../src/Doc/library/decimal.rst:1091 +#: library/decimal.rst:1091 msgid "" "Creates a new Decimal instance from *num* but using *self* as context. " "Unlike the :class:`Decimal` constructor, the context precision, rounding " "method, flags, and traps are applied to the conversion." msgstr "" -#: ../src/Doc/library/decimal.rst:1095 +#: library/decimal.rst:1095 msgid "" "This is useful because constants are often given to a greater precision than " "is needed by the application. Another benefit is that rounding immediately " @@ -29120,13 +29334,13 @@ msgid "" "sum can change the result:" msgstr "" -#: ../src/Doc/library/decimal.rst:1109 +#: library/decimal.rst:1109 msgid "" "This method implements the to-number operation of the IBM specification. If " "the argument is a string, no leading or trailing whitespace is permitted." msgstr "" -#: ../src/Doc/library/decimal.rst:1115 +#: library/decimal.rst:1115 msgid "" "Creates a new Decimal instance from a float *f* but rounding using *self* as " "the context. Unlike the :meth:`Decimal.from_float` class method, the " @@ -29134,18 +29348,18 @@ msgid "" "conversion." msgstr "" -#: ../src/Doc/library/decimal.rst:1135 +#: library/decimal.rst:1135 msgid "" "Returns a value equal to ``Emin - prec + 1`` which is the minimum exponent " "value for subnormal results. When underflow occurs, the exponent is set to :" "const:`Etiny`." msgstr "" -#: ../src/Doc/library/decimal.rst:1142 +#: library/decimal.rst:1142 msgid "Returns a value equal to ``Emax - prec + 1``." msgstr "" -#: ../src/Doc/library/decimal.rst:1144 +#: library/decimal.rst:1144 msgid "" "The usual approach to working with decimals is to create :class:`Decimal` " "instances and then apply arithmetic operations which take place within the " @@ -29155,199 +29369,199 @@ msgid "" "recounted here." msgstr "" -#: ../src/Doc/library/decimal.rst:1154 +#: library/decimal.rst:1154 msgid "Returns the absolute value of *x*." msgstr "" -#: ../src/Doc/library/decimal.rst:1159 +#: library/decimal.rst:1159 msgid "Return the sum of *x* and *y*." msgstr "" -#: ../src/Doc/library/decimal.rst:1164 +#: library/decimal.rst:1164 msgid "Returns the same Decimal object *x*." msgstr "" -#: ../src/Doc/library/decimal.rst:1169 +#: library/decimal.rst:1169 msgid "Compares *x* and *y* numerically." msgstr "" -#: ../src/Doc/library/decimal.rst:1174 +#: library/decimal.rst:1174 msgid "Compares the values of the two operands numerically." msgstr "" -#: ../src/Doc/library/decimal.rst:1179 +#: library/decimal.rst:1179 msgid "Compares two operands using their abstract representation." msgstr "" -#: ../src/Doc/library/decimal.rst:1184 +#: library/decimal.rst:1184 msgid "" "Compares two operands using their abstract representation, ignoring sign." msgstr "" -#: ../src/Doc/library/decimal.rst:1189 +#: library/decimal.rst:1189 msgid "Returns a copy of *x* with the sign set to 0." msgstr "" -#: ../src/Doc/library/decimal.rst:1194 +#: library/decimal.rst:1194 msgid "Returns a copy of *x* with the sign inverted." msgstr "" -#: ../src/Doc/library/decimal.rst:1199 +#: library/decimal.rst:1199 msgid "Copies the sign from *y* to *x*." msgstr "" -#: ../src/Doc/library/decimal.rst:1204 +#: library/decimal.rst:1204 msgid "Return *x* divided by *y*." msgstr "" -#: ../src/Doc/library/decimal.rst:1209 +#: library/decimal.rst:1209 msgid "Return *x* divided by *y*, truncated to an integer." msgstr "" -#: ../src/Doc/library/decimal.rst:1214 +#: library/decimal.rst:1214 msgid "Divides two numbers and returns the integer part of the result." msgstr "" -#: ../src/Doc/library/decimal.rst:1219 +#: library/decimal.rst:1219 msgid "Returns `e ** x`." msgstr "" -#: ../src/Doc/library/decimal.rst:1224 +#: library/decimal.rst:1224 msgid "Returns *x* multiplied by *y*, plus *z*." msgstr "" # a7c8eb16fb4a48e78bbff29a2850aff3 -#: ../src/Doc/library/decimal.rst:1229 +#: library/decimal.rst:1229 msgid "Returns ``True`` if *x* is canonical; otherwise returns ``False``." msgstr "" # 813eb21a472e49c486151cee1015e39b -#: ../src/Doc/library/decimal.rst:1234 +#: library/decimal.rst:1234 msgid "Returns ``True`` if *x* is finite; otherwise returns ``False``." msgstr "" # 3537a19e11e24bb5ae51332abf0fe061 -#: ../src/Doc/library/decimal.rst:1239 +#: library/decimal.rst:1239 msgid "Returns ``True`` if *x* is infinite; otherwise returns ``False``." msgstr "" # e21f37574a0946fb89a335d0c5d374c4 -#: ../src/Doc/library/decimal.rst:1244 +#: library/decimal.rst:1244 msgid "Returns ``True`` if *x* is a qNaN or sNaN; otherwise returns ``False``." msgstr "" # d2a75490c6d94b6680535357b06e6441 -#: ../src/Doc/library/decimal.rst:1249 +#: library/decimal.rst:1249 msgid "" "Returns ``True`` if *x* is a normal number; otherwise returns ``False``." msgstr "" # 0cf46525a47e40a989e4452aa577751d -#: ../src/Doc/library/decimal.rst:1254 +#: library/decimal.rst:1254 msgid "Returns ``True`` if *x* is a quiet NaN; otherwise returns ``False``." msgstr "" # d6b617bf5c39446d8593a993a118c91a -#: ../src/Doc/library/decimal.rst:1259 +#: library/decimal.rst:1259 msgid "Returns ``True`` if *x* is negative; otherwise returns ``False``." msgstr "" # 5ba4aaa9d2934f9887254817a3e0f721 -#: ../src/Doc/library/decimal.rst:1264 +#: library/decimal.rst:1264 msgid "" "Returns ``True`` if *x* is a signaling NaN; otherwise returns ``False``." msgstr "" # 6659427f08c64fd795157944661232bc -#: ../src/Doc/library/decimal.rst:1269 +#: library/decimal.rst:1269 msgid "Returns ``True`` if *x* is subnormal; otherwise returns ``False``." msgstr "" # a69a3cb1b0484634ad59057cd6e0044c -#: ../src/Doc/library/decimal.rst:1274 +#: library/decimal.rst:1274 msgid "Returns ``True`` if *x* is a zero; otherwise returns ``False``." msgstr "" -#: ../src/Doc/library/decimal.rst:1279 +#: library/decimal.rst:1279 msgid "Returns the natural (base e) logarithm of *x*." msgstr "" -#: ../src/Doc/library/decimal.rst:1284 +#: library/decimal.rst:1284 msgid "Returns the base 10 logarithm of *x*." msgstr "" -#: ../src/Doc/library/decimal.rst:1289 +#: library/decimal.rst:1289 msgid "Returns the exponent of the magnitude of the operand's MSD." msgstr "" -#: ../src/Doc/library/decimal.rst:1294 +#: library/decimal.rst:1294 msgid "Applies the logical operation *and* between each operand's digits." msgstr "" -#: ../src/Doc/library/decimal.rst:1299 +#: library/decimal.rst:1299 msgid "Invert all the digits in *x*." msgstr "" -#: ../src/Doc/library/decimal.rst:1304 +#: library/decimal.rst:1304 msgid "Applies the logical operation *or* between each operand's digits." msgstr "" -#: ../src/Doc/library/decimal.rst:1309 +#: library/decimal.rst:1309 msgid "Applies the logical operation *xor* between each operand's digits." msgstr "" -#: ../src/Doc/library/decimal.rst:1314 +#: library/decimal.rst:1314 msgid "Compares two values numerically and returns the maximum." msgstr "" -#: ../src/Doc/library/decimal.rst:1319 ../src/Doc/library/decimal.rst:1329 +#: library/decimal.rst:1319 library/decimal.rst:1329 msgid "Compares the values numerically with their sign ignored." msgstr "" -#: ../src/Doc/library/decimal.rst:1324 +#: library/decimal.rst:1324 msgid "Compares two values numerically and returns the minimum." msgstr "" -#: ../src/Doc/library/decimal.rst:1334 +#: library/decimal.rst:1334 msgid "Minus corresponds to the unary prefix minus operator in Python." msgstr "" -#: ../src/Doc/library/decimal.rst:1339 +#: library/decimal.rst:1339 msgid "Return the product of *x* and *y*." msgstr "" -#: ../src/Doc/library/decimal.rst:1344 +#: library/decimal.rst:1344 msgid "Returns the largest representable number smaller than *x*." msgstr "" -#: ../src/Doc/library/decimal.rst:1349 +#: library/decimal.rst:1349 msgid "Returns the smallest representable number larger than *x*." msgstr "" -#: ../src/Doc/library/decimal.rst:1354 +#: library/decimal.rst:1354 msgid "Returns the number closest to *x*, in direction towards *y*." msgstr "" -#: ../src/Doc/library/decimal.rst:1359 +#: library/decimal.rst:1359 msgid "Reduces *x* to its simplest form." msgstr "" -#: ../src/Doc/library/decimal.rst:1364 +#: library/decimal.rst:1364 msgid "Returns an indication of the class of *x*." msgstr "" -#: ../src/Doc/library/decimal.rst:1369 +#: library/decimal.rst:1369 msgid "" "Plus corresponds to the unary prefix plus operator in Python. This " "operation applies the context precision and rounding, so it is *not* an " "identity operation." msgstr "" -#: ../src/Doc/library/decimal.rst:1376 +#: library/decimal.rst:1376 msgid "Return ``x`` to the power of ``y``, reduced modulo ``modulo`` if given." msgstr "" -#: ../src/Doc/library/decimal.rst:1378 +#: library/decimal.rst:1378 msgid "" "With two arguments, compute ``x**y``. If ``x`` is negative then ``y`` must " "be integral. The result will be inexact unless ``y`` is integral and the " @@ -29356,29 +29570,29 @@ msgid "" "current thread's context." msgstr "" -#: ../src/Doc/library/decimal.rst:1384 +#: library/decimal.rst:1384 msgid "" "With three arguments, compute ``(x**y) % modulo``. For the three argument " "form, the following restrictions on the arguments hold:" msgstr "" -#: ../src/Doc/library/decimal.rst:1387 +#: library/decimal.rst:1387 msgid "all three arguments must be integral" msgstr "" -#: ../src/Doc/library/decimal.rst:1388 +#: library/decimal.rst:1388 msgid "``y`` must be nonnegative" msgstr "" -#: ../src/Doc/library/decimal.rst:1389 +#: library/decimal.rst:1389 msgid "at least one of ``x`` or ``y`` must be nonzero" msgstr "" -#: ../src/Doc/library/decimal.rst:1390 +#: library/decimal.rst:1390 msgid "``modulo`` must be nonzero and have at most 'precision' digits" msgstr "" -#: ../src/Doc/library/decimal.rst:1392 +#: library/decimal.rst:1392 msgid "" "The value resulting from ``Context.power(x, y, modulo)`` is equal to the " "value that would be obtained by computing ``(x**y) % modulo`` with unbounded " @@ -29387,78 +29601,84 @@ msgid "" "result is always exact." msgstr "" -#: ../src/Doc/library/decimal.rst:1406 +#: library/decimal.rst:1399 +msgid "" +"``y`` may now be nonintegral in ``x**y``. Stricter requirements for the " +"three-argument version." +msgstr "" + +#: library/decimal.rst:1406 msgid "Returns a value equal to *x* (rounded), having the exponent of *y*." msgstr "" -#: ../src/Doc/library/decimal.rst:1411 +#: library/decimal.rst:1411 msgid "Just returns 10, as this is Decimal, :)" msgstr "" -#: ../src/Doc/library/decimal.rst:1416 +#: library/decimal.rst:1416 msgid "Returns the remainder from integer division." msgstr "" -#: ../src/Doc/library/decimal.rst:1418 +#: library/decimal.rst:1418 msgid "" "The sign of the result, if non-zero, is the same as that of the original " "dividend." msgstr "" -#: ../src/Doc/library/decimal.rst:1423 +#: library/decimal.rst:1423 msgid "" "Returns ``x - y * n``, where *n* is the integer nearest the exact value of " "``x / y`` (if the result is 0 then its sign will be the sign of *x*)." msgstr "" -#: ../src/Doc/library/decimal.rst:1429 +#: library/decimal.rst:1429 msgid "Returns a rotated copy of *x*, *y* times." msgstr "" # 6965bbe36fae4d4d99676100d248bfc9 -#: ../src/Doc/library/decimal.rst:1434 +#: library/decimal.rst:1434 msgid "Returns ``True`` if the two operands have the same exponent." msgstr "" -#: ../src/Doc/library/decimal.rst:1439 +#: library/decimal.rst:1439 msgid "Returns the first operand after adding the second value its exp." msgstr "" -#: ../src/Doc/library/decimal.rst:1444 +#: library/decimal.rst:1444 msgid "Returns a shifted copy of *x*, *y* times." msgstr "" -#: ../src/Doc/library/decimal.rst:1449 +#: library/decimal.rst:1449 msgid "Square root of a non-negative number to context precision." msgstr "" -#: ../src/Doc/library/decimal.rst:1454 +#: library/decimal.rst:1454 msgid "Return the difference between *x* and *y*." msgstr "" -#: ../src/Doc/library/decimal.rst:1459 +#: library/decimal.rst:1459 msgid "Converts a number to a string, using scientific notation." msgstr "" -#: ../src/Doc/library/decimal.rst:1464 +#: library/decimal.rst:1464 msgid "Rounds to an integer." msgstr "" -#: ../src/Doc/library/decimal.rst:1469 +#: library/decimal.rst:1469 msgid "Converts a number to a string using scientific notation." msgstr "" -#: ../src/Doc/library/decimal.rst:1477 +#: library/decimal.rst:1477 msgid "Signals" msgstr "" -#: ../src/Doc/library/decimal.rst:1479 +#: library/decimal.rst:1479 msgid "" "Signals represent conditions that arise during computation. Each corresponds " "to one context flag and one context trap enabler." msgstr "" -#: ../src/Doc/library/decimal.rst:1482 +#: library/decimal.rst:1482 msgid "" "The context flag is set whenever the condition is encountered. After the " "computation, flags may be checked for informational purposes (for instance, " @@ -29466,7 +29686,7 @@ msgid "" "sure to clear all flags before starting the next computation." msgstr "" -#: ../src/Doc/library/decimal.rst:1487 +#: library/decimal.rst:1487 msgid "" "If the context's trap enabler is set for the signal, then the condition " "causes a Python exception to be raised. For example, if the :class:" @@ -29474,26 +29694,26 @@ msgid "" "raised upon encountering the condition." msgstr "" -#: ../src/Doc/library/decimal.rst:1495 +#: library/decimal.rst:1495 msgid "Altered an exponent to fit representation constraints." msgstr "" -#: ../src/Doc/library/decimal.rst:1497 +#: library/decimal.rst:1497 msgid "" "Typically, clamping occurs when an exponent falls outside the context's :" "attr:`Emin` and :attr:`Emax` limits. If possible, the exponent is reduced " "to fit by adding zeros to the coefficient." msgstr "" -#: ../src/Doc/library/decimal.rst:1504 +#: library/decimal.rst:1504 msgid "Base class for other signals and a subclass of :exc:`ArithmeticError`." msgstr "" -#: ../src/Doc/library/decimal.rst:1509 +#: library/decimal.rst:1509 msgid "Signals the division of a non-infinite number by zero." msgstr "" -#: ../src/Doc/library/decimal.rst:1511 +#: library/decimal.rst:1511 msgid "" "Can occur with division, modulo division, or when raising a number to a " "negative power. If this signal is not trapped, returns :const:`Infinity` " @@ -29501,32 +29721,32 @@ msgid "" "calculation." msgstr "" -#: ../src/Doc/library/decimal.rst:1518 +#: library/decimal.rst:1518 msgid "Indicates that rounding occurred and the result is not exact." msgstr "" -#: ../src/Doc/library/decimal.rst:1520 +#: library/decimal.rst:1520 msgid "" "Signals when non-zero digits were discarded during rounding. The rounded " "result is returned. The signal flag or trap is used to detect when results " "are inexact." msgstr "" -#: ../src/Doc/library/decimal.rst:1527 +#: library/decimal.rst:1527 msgid "An invalid operation was performed." msgstr "" -#: ../src/Doc/library/decimal.rst:1529 +#: library/decimal.rst:1529 msgid "" "Indicates that an operation was requested that does not make sense. If not " "trapped, returns :const:`NaN`. Possible causes include::" msgstr "" -#: ../src/Doc/library/decimal.rst:1546 +#: library/decimal.rst:1546 msgid "Numerical overflow." msgstr "" -#: ../src/Doc/library/decimal.rst:1548 +#: library/decimal.rst:1548 msgid "" "Indicates the exponent is larger than :attr:`Emax` after rounding has " "occurred. If not trapped, the result depends on the rounding mode, either " @@ -29535,11 +29755,11 @@ msgid "" "`Rounded` are also signaled." msgstr "" -#: ../src/Doc/library/decimal.rst:1557 +#: library/decimal.rst:1557 msgid "Rounding occurred though possibly no information was lost." msgstr "" -#: ../src/Doc/library/decimal.rst:1559 +#: library/decimal.rst:1559 msgid "" "Signaled whenever rounding discards digits; even if those digits are zero " "(such as rounding :const:`5.00` to :const:`5.0`). If not trapped, returns " @@ -29547,39 +29767,39 @@ msgid "" "digits." msgstr "" -#: ../src/Doc/library/decimal.rst:1567 +#: library/decimal.rst:1567 msgid "Exponent was lower than :attr:`Emin` prior to rounding." msgstr "" -#: ../src/Doc/library/decimal.rst:1569 +#: library/decimal.rst:1569 msgid "" "Occurs when an operation result is subnormal (the exponent is too small). If " "not trapped, returns the result unchanged." msgstr "" -#: ../src/Doc/library/decimal.rst:1575 +#: library/decimal.rst:1575 msgid "Numerical underflow with result rounded to zero." msgstr "" -#: ../src/Doc/library/decimal.rst:1577 +#: library/decimal.rst:1577 msgid "" "Occurs when a subnormal result is pushed to zero by rounding. :class:" "`Inexact` and :class:`Subnormal` are also signaled." msgstr "" -#: ../src/Doc/library/decimal.rst:1580 +#: library/decimal.rst:1580 msgid "The following table summarizes the hierarchy of signals::" msgstr "" -#: ../src/Doc/library/decimal.rst:1599 +#: library/decimal.rst:1599 msgid "Floating Point Notes" msgstr "" -#: ../src/Doc/library/decimal.rst:1603 +#: library/decimal.rst:1603 msgid "Mitigating round-off error with increased precision" msgstr "" -#: ../src/Doc/library/decimal.rst:1605 +#: library/decimal.rst:1605 msgid "" "The use of decimal floating point eliminates decimal representation error " "(making it possible to represent :const:`0.1` exactly); however, some " @@ -29587,7 +29807,7 @@ msgid "" "fixed precision." msgstr "" -#: ../src/Doc/library/decimal.rst:1609 +#: library/decimal.rst:1609 msgid "" "The effects of round-off error can be amplified by the addition or " "subtraction of nearly offsetting quantities resulting in loss of " @@ -29596,24 +29816,24 @@ msgid "" "of the associative and distributive properties of addition:" msgstr "" -#: ../src/Doc/library/decimal.rst:1633 +#: library/decimal.rst:1633 msgid "" "The :mod:`decimal` module makes it possible to restore the identities by " "expanding the precision sufficiently to avoid loss of significance:" msgstr "" -#: ../src/Doc/library/decimal.rst:1653 +#: library/decimal.rst:1653 msgid "Special values" msgstr "" -#: ../src/Doc/library/decimal.rst:1655 +#: library/decimal.rst:1655 msgid "" "The number system for the :mod:`decimal` module provides special values " "including :const:`NaN`, :const:`sNaN`, :const:`-Infinity`, :const:" "`Infinity`, and two zeros, :const:`+0` and :const:`-0`." msgstr "" -#: ../src/Doc/library/decimal.rst:1659 +#: library/decimal.rst:1659 msgid "" "Infinities can be constructed directly with: ``Decimal('Infinity')``. Also, " "they can arise from dividing by zero when the :exc:`DivisionByZero` signal " @@ -29622,14 +29842,14 @@ msgid "" "representable number." msgstr "" -#: ../src/Doc/library/decimal.rst:1664 +#: library/decimal.rst:1664 msgid "" "The infinities are signed (affine) and can be used in arithmetic operations " "where they get treated as very large, indeterminate numbers. For instance, " "adding a constant to infinity gives another infinite result." msgstr "" -#: ../src/Doc/library/decimal.rst:1668 +#: library/decimal.rst:1668 msgid "" "Some operations are indeterminate and return :const:`NaN`, or if the :exc:" "`InvalidOperation` signal is trapped, raise an exception. For example, " @@ -29640,14 +29860,14 @@ msgid "" "the calculation to proceed while flagging specific results as invalid." msgstr "" -#: ../src/Doc/library/decimal.rst:1676 +#: library/decimal.rst:1676 msgid "" "A variant is :const:`sNaN` which signals rather than remaining quiet after " "every operation. This is a useful return value when an invalid result needs " "to interrupt a calculation for special handling." msgstr "" -#: ../src/Doc/library/decimal.rst:1680 +#: library/decimal.rst:1680 msgid "" "The behavior of Python's comparison operators can be a little surprising " "where a :const:`NaN` is involved. A test for equality where one of the " @@ -29664,7 +29884,7 @@ msgid "" "methods instead." msgstr "" -#: ../src/Doc/library/decimal.rst:1693 +#: library/decimal.rst:1693 msgid "" "The signed zeros can result from calculations that underflow. They keep the " "sign that would have resulted if the calculation had been carried out to " @@ -29672,7 +29892,7 @@ msgid "" "negative zeros are treated as equal and their sign is informational." msgstr "" -#: ../src/Doc/library/decimal.rst:1698 +#: library/decimal.rst:1698 msgid "" "In addition to the two signed zeros which are distinct yet equal, there are " "various representations of zero with differing precisions yet equivalent in " @@ -29681,11 +29901,11 @@ msgid "" "that the following calculation returns a value equal to zero:" msgstr "" -#: ../src/Doc/library/decimal.rst:1713 +#: library/decimal.rst:1713 msgid "Working with threads" msgstr "" -#: ../src/Doc/library/decimal.rst:1715 +#: library/decimal.rst:1715 msgid "" "The :func:`getcontext` function accesses a different :class:`Context` object " "for each thread. Having separate thread contexts means that threads may " @@ -29693,20 +29913,20 @@ msgid "" "threads." msgstr "" -#: ../src/Doc/library/decimal.rst:1719 +#: library/decimal.rst:1719 msgid "" "Likewise, the :func:`setcontext` function automatically assigns its target " "to the current thread." msgstr "" -#: ../src/Doc/library/decimal.rst:1722 +#: library/decimal.rst:1722 msgid "" "If :func:`setcontext` has not been called before :func:`getcontext`, then :" "func:`getcontext` will automatically create a new context for use in the " "current thread." msgstr "" -#: ../src/Doc/library/decimal.rst:1726 +#: library/decimal.rst:1726 msgid "" "The new context is copied from a prototype context called *DefaultContext*. " "To control the defaults so that each thread will use the same values " @@ -29715,50 +29935,50 @@ msgid "" "a race condition between threads calling :func:`getcontext`. For example::" msgstr "" -#: ../src/Doc/library/decimal.rst:1751 ../src/Doc/library/itertools.rst:661 +#: library/decimal.rst:1751 library/itertools.rst:661 msgid "Recipes" msgstr "" -#: ../src/Doc/library/decimal.rst:1753 +#: library/decimal.rst:1753 msgid "" "Here are a few recipes that serve as utility functions and that demonstrate " "ways to work with the :class:`Decimal` class::" msgstr "" -#: ../src/Doc/library/decimal.rst:1901 +#: library/decimal.rst:1901 msgid "Decimal FAQ" msgstr "" -#: ../src/Doc/library/decimal.rst:1903 +#: library/decimal.rst:1903 msgid "" "Q. It is cumbersome to type ``decimal.Decimal('1234.5')``. Is there a way " "to minimize typing when using the interactive interpreter?" msgstr "" -#: ../src/Doc/library/decimal.rst:1906 +#: library/decimal.rst:1906 msgid "A. Some users abbreviate the constructor to just a single letter:" msgstr "" -#: ../src/Doc/library/decimal.rst:1912 +#: library/decimal.rst:1912 msgid "" "Q. In a fixed-point application with two decimal places, some inputs have " "many places and need to be rounded. Others are not supposed to have excess " "digits and need to be validated. What methods should be used?" msgstr "" -#: ../src/Doc/library/decimal.rst:1916 +#: library/decimal.rst:1916 msgid "" "A. The :meth:`quantize` method rounds to a fixed number of decimal places. " "If the :const:`Inexact` trap is set, it is also useful for validation:" msgstr "" -#: ../src/Doc/library/decimal.rst:1934 +#: library/decimal.rst:1934 msgid "" "Q. Once I have valid two place inputs, how do I maintain that invariant " "throughout an application?" msgstr "" -#: ../src/Doc/library/decimal.rst:1937 +#: library/decimal.rst:1937 msgid "" "A. Some operations like addition, subtraction, and multiplication by an " "integer will automatically preserve fixed point. Others operations, like " @@ -29766,13 +29986,13 @@ msgid "" "places and need to be followed-up with a :meth:`quantize` step:" msgstr "" -#: ../src/Doc/library/decimal.rst:1955 +#: library/decimal.rst:1955 msgid "" "In developing fixed-point applications, it is convenient to define functions " "to handle the :meth:`quantize` step:" msgstr "" -#: ../src/Doc/library/decimal.rst:1968 +#: library/decimal.rst:1968 msgid "" "Q. There are many ways to express the same value. The numbers :const:" "`200`, :const:`200.000`, :const:`2E2`, and :const:`.02E+4` all have the same " @@ -29780,19 +30000,19 @@ msgid "" "recognizable canonical value?" msgstr "" -#: ../src/Doc/library/decimal.rst:1973 +#: library/decimal.rst:1973 msgid "" "A. The :meth:`normalize` method maps all equivalent values to a single " "representative:" msgstr "" -#: ../src/Doc/library/decimal.rst:1980 +#: library/decimal.rst:1980 msgid "" "Q. Some decimal values always print with exponential notation. Is there a " "way to get a non-exponential representation?" msgstr "" -#: ../src/Doc/library/decimal.rst:1983 +#: library/decimal.rst:1983 msgid "" "A. For some values, exponential notation is the only way to express the " "number of significant places in the coefficient. For example, expressing :" @@ -29801,31 +30021,31 @@ msgid "" msgstr "" # f2dd1888c30845c782606fb63d6cd572 -#: ../src/Doc/library/decimal.rst:1988 +#: library/decimal.rst:1988 msgid "" "If an application does not care about tracking significance, it is easy to " "remove the exponent and trailing zeros, losing significance, but keeping the " "value unchanged::" msgstr "" -#: ../src/Doc/library/decimal.rst:2001 +#: library/decimal.rst:2001 msgid "Q. Is there a way to convert a regular float to a :class:`Decimal`?" msgstr "" -#: ../src/Doc/library/decimal.rst:2003 +#: library/decimal.rst:2003 msgid "" "A. Yes, any binary floating point number can be exactly expressed as a " "Decimal though an exact conversion may take more precision than intuition " "would suggest:" msgstr "" -#: ../src/Doc/library/decimal.rst:2012 +#: library/decimal.rst:2012 msgid "" "Q. Within a complex calculation, how can I make sure that I haven't gotten a " "spurious result because of insufficient precision or rounding anomalies." msgstr "" -#: ../src/Doc/library/decimal.rst:2015 +#: library/decimal.rst:2015 msgid "" "A. The decimal module makes it easy to test results. A best practice is to " "re-run calculations using greater precision and with various rounding modes. " @@ -29833,14 +30053,14 @@ msgid "" "issues, ill-conditioned inputs, or a numerically unstable algorithm." msgstr "" -#: ../src/Doc/library/decimal.rst:2020 +#: library/decimal.rst:2020 msgid "" "Q. I noticed that context precision is applied to the results of operations " "but not to the inputs. Is there anything to watch out for when mixing " "values of different precisions?" msgstr "" -#: ../src/Doc/library/decimal.rst:2024 +#: library/decimal.rst:2024 msgid "" "A. Yes. The principle is that all values are considered to be exact and so " "is the arithmetic on those values. Only the results are rounded. The " @@ -29849,23 +30069,23 @@ msgid "" "haven't been rounded:" msgstr "" -#: ../src/Doc/library/decimal.rst:2037 +#: library/decimal.rst:2037 msgid "" "The solution is either to increase precision or to force rounding of inputs " "using the unary plus operation:" msgstr "" -#: ../src/Doc/library/decimal.rst:2046 +#: library/decimal.rst:2046 msgid "" "Alternatively, inputs can be rounded upon creation using the :meth:`Context." "create_decimal` method:" msgstr "" -#: ../src/Doc/library/development.rst:6 +#: library/development.rst:6 msgid "Development Tools" msgstr "" -#: ../src/Doc/library/development.rst:8 +#: library/development.rst:8 msgid "" "The modules described in this chapter help you write software. For example, " "the :mod:`pydoc` module takes a module and generates documentation based on " @@ -29875,16 +30095,16 @@ msgid "" "translate Python 2.x source code into valid Python 3.x code." msgstr "" -#: ../src/Doc/library/development.rst:15 ../src/Doc/library/i18n.rst:13 -#: ../src/Doc/library/ipc.rst:15 ../src/Doc/library/persistence.rst:16 +#: library/development.rst:15 library/i18n.rst:13 library/ipc.rst:15 +#: library/persistence.rst:16 msgid "The list of modules described in this chapter is:" msgstr "" -#: ../src/Doc/library/difflib.rst:2 +#: library/difflib.rst:2 msgid ":mod:`difflib` --- Helpers for computing deltas" msgstr "" -#: ../src/Doc/library/difflib.rst:17 +#: library/difflib.rst:17 msgid "" "This module provides classes and functions for comparing sequences. It can " "be used for example, for comparing files, and can produce difference " @@ -29893,7 +30113,7 @@ msgid "" "module." msgstr "" -#: ../src/Doc/library/difflib.rst:24 +#: library/difflib.rst:24 msgid "" "This is a flexible class for comparing pairs of sequences of any type, so " "long as the sequence elements are :term:`hashable`. The basic algorithm " @@ -29907,7 +30127,7 @@ msgid "" "yield matches that \"look right\" to people." msgstr "" -#: ../src/Doc/library/difflib.rst:34 +#: library/difflib.rst:34 msgid "" "**Timing:** The basic Ratcliff-Obershelp algorithm is cubic time in the " "worst case and quadratic time in the expected case. :class:`SequenceMatcher` " @@ -29917,7 +30137,7 @@ msgid "" msgstr "" # 11f6f4a6ce7b4dc5bae0976566343fe2 -#: ../src/Doc/library/difflib.rst:40 +#: library/difflib.rst:40 msgid "" "**Automatic junk heuristic:** :class:`SequenceMatcher` supports a heuristic " "that automatically treats certain sequence items as junk. The heuristic " @@ -29929,7 +30149,11 @@ msgid "" "``False`` when creating the :class:`SequenceMatcher`." msgstr "" -#: ../src/Doc/library/difflib.rst:53 +#: library/difflib.rst:48 library/difflib.rst:366 +msgid "The *autojunk* parameter." +msgstr "" + +#: library/difflib.rst:53 msgid "" "This is a class for comparing sequences of lines of text, and producing " "human-readable differences or deltas. Differ uses :class:`SequenceMatcher` " @@ -29937,54 +30161,54 @@ msgid "" "within similar (near-matching) lines." msgstr "" -#: ../src/Doc/library/difflib.rst:58 +#: library/difflib.rst:58 msgid "Each line of a :class:`Differ` delta begins with a two-letter code:" msgstr "" -#: ../src/Doc/library/difflib.rst:61 +#: library/difflib.rst:61 msgid "Code" msgstr "" -#: ../src/Doc/library/difflib.rst:63 +#: library/difflib.rst:63 msgid "``'- '``" msgstr "" -#: ../src/Doc/library/difflib.rst:63 +#: library/difflib.rst:63 msgid "line unique to sequence 1" msgstr "" -#: ../src/Doc/library/difflib.rst:65 +#: library/difflib.rst:65 msgid "``'+ '``" msgstr "" -#: ../src/Doc/library/difflib.rst:65 +#: library/difflib.rst:65 msgid "line unique to sequence 2" msgstr "" -#: ../src/Doc/library/difflib.rst:67 +#: library/difflib.rst:67 msgid "``' '``" msgstr "" -#: ../src/Doc/library/difflib.rst:67 +#: library/difflib.rst:67 msgid "line common to both sequences" msgstr "" -#: ../src/Doc/library/difflib.rst:69 +#: library/difflib.rst:69 msgid "``'? '``" msgstr "" -#: ../src/Doc/library/difflib.rst:69 +#: library/difflib.rst:69 msgid "line not present in either input sequence" msgstr "" -#: ../src/Doc/library/difflib.rst:72 +#: library/difflib.rst:72 msgid "" "Lines beginning with '``?``' attempt to guide the eye to intraline " "differences, and were not present in either input sequence. These lines can " "be confusing if the sequences contain tab characters." msgstr "" -#: ../src/Doc/library/difflib.rst:79 +#: library/difflib.rst:79 msgid "" "This class can be used to create an HTML table (or a complete HTML file " "containing the table) showing a side by side, line by line comparison of " @@ -29992,52 +30216,52 @@ msgid "" "generated in either full or contextual difference mode." msgstr "" -#: ../src/Doc/library/difflib.rst:84 +#: library/difflib.rst:84 msgid "The constructor for this class is:" msgstr "" -#: ../src/Doc/library/difflib.rst:89 +#: library/difflib.rst:89 msgid "Initializes instance of :class:`HtmlDiff`." msgstr "" -#: ../src/Doc/library/difflib.rst:91 +#: library/difflib.rst:91 msgid "" "*tabsize* is an optional keyword argument to specify tab stop spacing and " "defaults to ``8``." msgstr "" -#: ../src/Doc/library/difflib.rst:94 +#: library/difflib.rst:94 msgid "" "*wrapcolumn* is an optional keyword to specify column number where lines are " "broken and wrapped, defaults to ``None`` where lines are not wrapped." msgstr "" -#: ../src/Doc/library/difflib.rst:97 +#: library/difflib.rst:97 msgid "" -"*linejunk* and *charjunk* are optional keyword arguments passed into " -"``ndiff()`` (used by :class:`HtmlDiff` to generate the side by side HTML " -"differences). See ``ndiff()`` documentation for argument default values and " -"descriptions." +"*linejunk* and *charjunk* are optional keyword arguments passed into :func:" +"`ndiff` (used by :class:`HtmlDiff` to generate the side by side HTML " +"differences). See :func:`ndiff` documentation for argument default values " +"and descriptions." msgstr "" -#: ../src/Doc/library/difflib.rst:101 +#: library/difflib.rst:101 msgid "The following methods are public:" msgstr "" -#: ../src/Doc/library/difflib.rst:106 +#: library/difflib.rst:106 msgid "" "Compares *fromlines* and *tolines* (lists of strings) and returns a string " "which is a complete HTML file containing a table showing line by line " "differences with inter-line and intra-line changes highlighted." msgstr "" -#: ../src/Doc/library/difflib.rst:110 +#: library/difflib.rst:110 msgid "" "*fromdesc* and *todesc* are optional keyword arguments to specify from/to " "file column header strings (both default to an empty string)." msgstr "" -#: ../src/Doc/library/difflib.rst:113 +#: library/difflib.rst:113 msgid "" "*context* and *numlines* are both optional keyword arguments. Set *context* " "to ``True`` when contextual differences are to be shown, else the default is " @@ -30050,39 +30274,39 @@ msgid "" "without any leading context)." msgstr "" -#: ../src/Doc/library/difflib.rst:126 +#: library/difflib.rst:126 msgid "" "Compares *fromlines* and *tolines* (lists of strings) and returns a string " "which is a complete HTML table showing line by line differences with inter-" "line and intra-line changes highlighted." msgstr "" -#: ../src/Doc/library/difflib.rst:130 +#: library/difflib.rst:130 msgid "" "The arguments for this method are the same as those for the :meth:" "`make_file` method." msgstr "" -#: ../src/Doc/library/difflib.rst:133 +#: library/difflib.rst:133 msgid "" ":file:`Tools/scripts/diff.py` is a command-line front-end to this class and " "contains a good example of its use." msgstr "" -#: ../src/Doc/library/difflib.rst:141 +#: library/difflib.rst:141 msgid "" "Compare *a* and *b* (lists of strings); return a delta (a :term:`generator` " "generating the delta lines) in context diff format." msgstr "" -#: ../src/Doc/library/difflib.rst:144 +#: library/difflib.rst:144 msgid "" "Context diffs are a compact way of showing just the lines that have changed " "plus a few lines of context. The changes are shown in a before/after " "style. The number of context lines is set by *n* which defaults to three." msgstr "" -#: ../src/Doc/library/difflib.rst:148 +#: library/difflib.rst:148 msgid "" "By default, the diff control lines (those with ``***`` or ``---``) are " "created with a trailing newline. This is helpful so that inputs created " @@ -30091,13 +30315,13 @@ msgid "" "newlines." msgstr "" -#: ../src/Doc/library/difflib.rst:154 ../src/Doc/library/difflib.rst:289 +#: library/difflib.rst:154 library/difflib.rst:289 msgid "" "For inputs that do not have trailing newlines, set the *lineterm* argument " "to ``\"\"`` so that the output will be uniformly newline free." msgstr "" -#: ../src/Doc/library/difflib.rst:157 ../src/Doc/library/difflib.rst:292 +#: library/difflib.rst:157 library/difflib.rst:292 msgid "" "The context diff format normally has a header for filenames and modification " "times. Any or all of these may be specified using strings for *fromfile*, " @@ -30106,11 +30330,11 @@ msgid "" "default to blanks." msgstr "" -#: ../src/Doc/library/difflib.rst:181 ../src/Doc/library/difflib.rst:313 +#: library/difflib.rst:181 library/difflib.rst:313 msgid "See :ref:`difflib-interface` for a more detailed example." msgstr "" -#: ../src/Doc/library/difflib.rst:188 +#: library/difflib.rst:188 msgid "" "Return a list of the best \"good enough\" matches. *word* is a sequence for " "which close matches are desired (typically a string), and *possibilities* is " @@ -30118,38 +30342,38 @@ msgid "" "strings)." msgstr "" -#: ../src/Doc/library/difflib.rst:192 +#: library/difflib.rst:192 msgid "" "Optional argument *n* (default ``3``) is the maximum number of close matches " "to return; *n* must be greater than ``0``." msgstr "" -#: ../src/Doc/library/difflib.rst:195 +#: library/difflib.rst:195 msgid "" "Optional argument *cutoff* (default ``0.6``) is a float in the range [0, 1]. " "Possibilities that don't score at least that similar to *word* are ignored." msgstr "" -#: ../src/Doc/library/difflib.rst:198 +#: library/difflib.rst:198 msgid "" "The best (no more than *n*) matches among the possibilities are returned in " "a list, sorted by similarity score, most similar first." msgstr "" -#: ../src/Doc/library/difflib.rst:214 +#: library/difflib.rst:214 msgid "" "Compare *a* and *b* (lists of strings); return a :class:`Differ`\\ -style " "delta (a :term:`generator` generating the delta lines)." msgstr "" -#: ../src/Doc/library/difflib.rst:217 ../src/Doc/library/difflib.rst:617 +#: library/difflib.rst:217 library/difflib.rst:617 msgid "" "Optional keyword parameters *linejunk* and *charjunk* are for filter " "functions (or ``None``):" msgstr "" # c0f305827d69432bb881f0f21753c993 -#: ../src/Doc/library/difflib.rst:220 +#: library/difflib.rst:220 msgid "" "*linejunk*: A function that accepts a single string argument, and returns " "true if the string is junk, or false if not. The default is (``None``), " @@ -30161,7 +30385,7 @@ msgid "" "works better than the pre-2.3 default." msgstr "" -#: ../src/Doc/library/difflib.rst:229 +#: library/difflib.rst:229 msgid "" "*charjunk*: A function that accepts a character (a string of length 1), and " "returns if the character is junk, or false if not. The default is module-" @@ -30169,29 +30393,29 @@ msgid "" "characters (a blank or tab; note: bad idea to include newline in this!)." msgstr "" -#: ../src/Doc/library/difflib.rst:234 +#: library/difflib.rst:234 msgid "" ":file:`Tools/scripts/ndiff.py` is a command-line front-end to this function." msgstr "" -#: ../src/Doc/library/difflib.rst:252 +#: library/difflib.rst:252 msgid "Return one of the two sequences that generated a delta." msgstr "" -#: ../src/Doc/library/difflib.rst:254 +#: library/difflib.rst:254 msgid "" "Given a *sequence* produced by :meth:`Differ.compare` or :func:`ndiff`, " "extract lines originating from file 1 or 2 (parameter *which*), stripping " "off line prefixes." msgstr "" -#: ../src/Doc/library/difflib.rst:275 +#: library/difflib.rst:275 msgid "" "Compare *a* and *b* (lists of strings); return a delta (a :term:`generator` " "generating the delta lines) in unified diff format." msgstr "" -#: ../src/Doc/library/difflib.rst:278 +#: library/difflib.rst:278 msgid "" "Unified diffs are a compact way of showing just the lines that have changed " "plus a few lines of context. The changes are shown in a inline style " @@ -30199,7 +30423,7 @@ msgid "" "set by *n* which defaults to three." msgstr "" -#: ../src/Doc/library/difflib.rst:283 +#: library/difflib.rst:283 msgid "" "By default, the diff control lines (those with ``---``, ``+++``, or ``@@``) " "are created with a trailing newline. This is helpful so that inputs created " @@ -30209,44 +30433,41 @@ msgid "" msgstr "" # b94c31815fd54d3186b72532602eab50 -#: ../src/Doc/library/difflib.rst:320 +#: library/difflib.rst:320 msgid "" "Return true for ignorable lines. The line *line* is ignorable if *line* is " "blank or contains a single ``'#'``, otherwise it is not ignorable. Used as " "a default for parameter *linejunk* in :func:`ndiff` before Python 2.3." msgstr "" -#: ../src/Doc/library/difflib.rst:327 +#: library/difflib.rst:327 msgid "" "Return true for ignorable characters. The character *ch* is ignorable if " "*ch* is a space or tab, otherwise it is not ignorable. Used as a default " "for parameter *charjunk* in :func:`ndiff`." msgstr "" -# f635a801774c4ecdbd782dcf5e04dab7 -#: ../src/Doc/library/difflib.rst:334 -msgid "" -"`Pattern Matching: The Gestalt Approach `_" +#: library/difflib.rst:335 +msgid "Pattern Matching: The Gestalt Approach" msgstr "" # bcb91c7fb1144c309960abed2ed4b2f7 -#: ../src/Doc/library/difflib.rst:335 +#: library/difflib.rst:335 msgid "" "Discussion of a similar algorithm by John W. Ratcliff and D. E. Metzener. " "This was published in `Dr. Dobb's Journal `_ in " "July, 1988." msgstr "" -#: ../src/Doc/library/difflib.rst:342 +#: library/difflib.rst:342 msgid "SequenceMatcher Objects" msgstr "" -#: ../src/Doc/library/difflib.rst:344 +#: library/difflib.rst:344 msgid "The :class:`SequenceMatcher` class has this constructor:" msgstr "" -#: ../src/Doc/library/difflib.rst:349 +#: library/difflib.rst:349 msgid "" "Optional argument *isjunk* must be ``None`` (the default) or a one-argument " "function that takes a sequence element and returns true if and only if the " @@ -30255,13 +30476,13 @@ msgid "" "ignored. For example, pass::" msgstr "" -#: ../src/Doc/library/difflib.rst:357 +#: library/difflib.rst:357 msgid "" "if you're comparing lines as sequences of characters, and don't want to " "synch up on blanks or hard tabs." msgstr "" -#: ../src/Doc/library/difflib.rst:360 +#: library/difflib.rst:360 msgid "" "The optional arguments *a* and *b* are sequences to be compared; both " "default to empty strings. The elements of both sequences must be :term:" @@ -30269,21 +30490,21 @@ msgid "" msgstr "" # 9ce6a482dc8e4bc3a374fec8821df800 -#: ../src/Doc/library/difflib.rst:363 +#: library/difflib.rst:363 msgid "" "The optional argument *autojunk* can be used to disable the automatic junk " "heuristic." msgstr "" -#: ../src/Doc/library/difflib.rst:369 +#: library/difflib.rst:369 msgid ":class:`SequenceMatcher` objects have the following methods:" msgstr "" -#: ../src/Doc/library/difflib.rst:373 +#: library/difflib.rst:373 msgid "Set the two sequences to be compared." msgstr "" -#: ../src/Doc/library/difflib.rst:375 +#: library/difflib.rst:375 msgid "" ":class:`SequenceMatcher` computes and caches detailed information about the " "second sequence, so if you want to compare one sequence against many " @@ -30291,23 +30512,23 @@ msgid "" "call :meth:`set_seq1` repeatedly, once for each of the other sequences." msgstr "" -#: ../src/Doc/library/difflib.rst:383 +#: library/difflib.rst:383 msgid "" "Set the first sequence to be compared. The second sequence to be compared " "is not changed." msgstr "" -#: ../src/Doc/library/difflib.rst:389 +#: library/difflib.rst:389 msgid "" "Set the second sequence to be compared. The first sequence to be compared " "is not changed." msgstr "" -#: ../src/Doc/library/difflib.rst:395 +#: library/difflib.rst:395 msgid "Find longest matching block in ``a[alo:ahi]`` and ``b[blo:bhi]``." msgstr "" -#: ../src/Doc/library/difflib.rst:397 +#: library/difflib.rst:397 msgid "" "If *isjunk* was omitted or ``None``, :meth:`find_longest_match` returns " "``(i, j, k)`` such that ``a[i:i+k]`` is equal to ``b[j:j+k]``, where ``alo " @@ -30319,7 +30540,7 @@ msgid "" "that starts earliest in *b*." msgstr "" -#: ../src/Doc/library/difflib.rst:410 +#: library/difflib.rst:410 msgid "" "If *isjunk* was provided, first the longest matching block is determined as " "above, but with the additional restriction that no junk element appears in " @@ -30328,7 +30549,7 @@ msgid "" "junk except as identical junk happens to be adjacent to an interesting match." msgstr "" -#: ../src/Doc/library/difflib.rst:417 +#: library/difflib.rst:417 msgid "" "Here's the same example as before, but considering blanks to be junk. That " "prevents ``' abcd'`` from matching the ``' abcd'`` at the tail end of the " @@ -30336,18 +30557,22 @@ msgid "" "matches the leftmost ``'abcd'`` in the second sequence:" msgstr "" -#: ../src/Doc/library/difflib.rst:426 +#: library/difflib.rst:426 msgid "If no blocks match, this returns ``(alo, blo, 0)``." msgstr "" -#: ../src/Doc/library/difflib.rst:434 +#: library/difflib.rst:428 +msgid "This method returns a :term:`named tuple` ``Match(a, b, size)``." +msgstr "" + +#: library/difflib.rst:434 msgid "" "Return list of triples describing matching subsequences. Each triple is of " "the form ``(i, j, n)``, and means that ``a[i:i+n] == b[j:j+n]``. The " "triples are monotonically increasing in *i* and *j*." msgstr "" -#: ../src/Doc/library/difflib.rst:438 +#: library/difflib.rst:438 msgid "" "The last triple is a dummy, and has the value ``(len(a), len(b), 0)``. It " "is the only triple with ``n == 0``. If ``(i, j, n)`` and ``(i', j', n')`` " @@ -30356,7 +30581,13 @@ msgid "" "triples always describe non-adjacent equal blocks." msgstr "" -#: ../src/Doc/library/difflib.rst:459 +#: library/difflib.rst:446 +msgid "" +"The guarantee that adjacent triples always describe non-adjacent blocks was " +"implemented." +msgstr "" + +#: library/difflib.rst:459 msgid "" "Return list of 5-tuples describing how to turn *a* into *b*. Each tuple is " "of the form ``(tag, i1, i2, j1, j2)``. The first tuple has ``i1 == j1 == " @@ -30364,90 +30595,89 @@ msgid "" "tuple, and, likewise, *j1* equal to the previous *j2*." msgstr "" -#: ../src/Doc/library/difflib.rst:464 +#: library/difflib.rst:464 msgid "The *tag* values are strings, with these meanings:" msgstr "" -#: ../src/Doc/library/difflib.rst:469 +#: library/difflib.rst:469 msgid "``a[i1:i2]`` should be replaced by ``b[j1:j2]``." msgstr "" -#: ../src/Doc/library/difflib.rst:472 +#: library/difflib.rst:472 msgid "``'delete'``" msgstr "" -#: ../src/Doc/library/difflib.rst:472 +#: library/difflib.rst:472 msgid "``a[i1:i2]`` should be deleted. Note that ``j1 == j2`` in this case." msgstr "" -#: ../src/Doc/library/difflib.rst:475 +#: library/difflib.rst:475 msgid "``'insert'``" msgstr "" -#: ../src/Doc/library/difflib.rst:475 +#: library/difflib.rst:475 msgid "" "``b[j1:j2]`` should be inserted at ``a[i1:i1]``. Note that ``i1 == i2`` in " "this case." msgstr "" -#: ../src/Doc/library/difflib.rst:479 +#: library/difflib.rst:479 msgid "``'equal'``" msgstr "" -#: ../src/Doc/library/difflib.rst:479 +#: library/difflib.rst:479 msgid "``a[i1:i2] == b[j1:j2]`` (the sub-sequences are equal)." msgstr "" -#: ../src/Doc/library/difflib.rst:483 -#: ../src/Doc/library/multiprocessing.rst:837 ../src/Doc/library/re.rst:895 -#: ../src/Doc/library/time.rst:378 ../src/Doc/library/turtle.rst:1427 +#: library/difflib.rst:483 library/multiprocessing.rst:859 library/re.rst:900 +#: library/time.rst:377 library/turtle.rst:1427 #, fuzzy msgid "For example:" msgstr "Par exemple ::" -#: ../src/Doc/library/difflib.rst:500 +#: library/difflib.rst:500 msgid "Return a :term:`generator` of groups with up to *n* lines of context." msgstr "" -#: ../src/Doc/library/difflib.rst:502 +#: library/difflib.rst:502 msgid "" "Starting with the groups returned by :meth:`get_opcodes`, this method splits " "out smaller change clusters and eliminates intervening ranges which have no " "changes." msgstr "" -#: ../src/Doc/library/difflib.rst:506 +#: library/difflib.rst:506 msgid "The groups are returned in the same format as :meth:`get_opcodes`." msgstr "" -#: ../src/Doc/library/difflib.rst:513 +#: library/difflib.rst:513 msgid "" "Return a measure of the sequences' similarity as a float in the range [0, 1]." msgstr "" -#: ../src/Doc/library/difflib.rst:516 +#: library/difflib.rst:516 msgid "" "Where T is the total number of elements in both sequences, and M is the " "number of matches, this is 2.0\\*M / T. Note that this is ``1.0`` if the " "sequences are identical, and ``0.0`` if they have nothing in common." msgstr "" -#: ../src/Doc/library/difflib.rst:520 +#: library/difflib.rst:520 msgid "" "This is expensive to compute if :meth:`get_matching_blocks` or :meth:" "`get_opcodes` hasn't already been called, in which case you may want to try :" "meth:`quick_ratio` or :meth:`real_quick_ratio` first to get an upper bound." msgstr "" -#: ../src/Doc/library/difflib.rst:528 +#: library/difflib.rst:528 msgid "Return an upper bound on :meth:`ratio` relatively quickly." msgstr "" -#: ../src/Doc/library/difflib.rst:533 +#: library/difflib.rst:533 msgid "Return an upper bound on :meth:`ratio` very quickly." msgstr "" -#: ../src/Doc/library/difflib.rst:536 +#: library/difflib.rst:536 msgid "" "The three methods that return the ratio of matching to total characters can " "give different results due to differing levels of approximation, although :" @@ -30455,57 +30685,57 @@ msgid "" "as :meth:`ratio`:" msgstr "" -#: ../src/Doc/library/difflib.rst:553 +#: library/difflib.rst:553 msgid "SequenceMatcher Examples" msgstr "" -#: ../src/Doc/library/difflib.rst:555 +#: library/difflib.rst:555 msgid "This example compares two strings, considering blanks to be \"junk:\"" msgstr "" -#: ../src/Doc/library/difflib.rst:561 +#: library/difflib.rst:561 msgid "" ":meth:`ratio` returns a float in [0, 1], measuring the similarity of the " "sequences. As a rule of thumb, a :meth:`ratio` value over 0.6 means the " "sequences are close matches:" msgstr "" -#: ../src/Doc/library/difflib.rst:568 +#: library/difflib.rst:568 msgid "" "If you're only interested in where the sequences match, :meth:" "`get_matching_blocks` is handy:" msgstr "" -#: ../src/Doc/library/difflib.rst:577 +#: library/difflib.rst:577 msgid "" "Note that the last tuple returned by :meth:`get_matching_blocks` is always a " "dummy, ``(len(a), len(b), 0)``, and this is the only case in which the last " "tuple element (number of elements matched) is ``0``." msgstr "" -#: ../src/Doc/library/difflib.rst:581 +#: library/difflib.rst:581 msgid "" "If you want to know how to change the first sequence into the second, use :" "meth:`get_opcodes`:" msgstr "" -#: ../src/Doc/library/difflib.rst:592 +#: library/difflib.rst:592 msgid "" "The :func:`get_close_matches` function in this module which shows how simple " "code building on :class:`SequenceMatcher` can be used to do useful work." msgstr "" -#: ../src/Doc/library/difflib.rst:596 +#: library/difflib.rst:596 msgid "" "`Simple version control recipe `_ for a small application built with :class:`SequenceMatcher`." msgstr "" -#: ../src/Doc/library/difflib.rst:604 +#: library/difflib.rst:604 msgid "Differ Objects" msgstr "" -#: ../src/Doc/library/difflib.rst:606 +#: library/difflib.rst:606 msgid "" "Note that :class:`Differ`\\ -generated deltas make no claim to be " "**minimal** diffs. To the contrary, minimal diffs are often counter-" @@ -30515,36 +30745,36 @@ msgid "" "longer diff." msgstr "" -#: ../src/Doc/library/difflib.rst:612 +#: library/difflib.rst:612 msgid "The :class:`Differ` class has this constructor:" msgstr "" -#: ../src/Doc/library/difflib.rst:620 +#: library/difflib.rst:620 msgid "" "*linejunk*: A function that accepts a single string argument, and returns " "true if the string is junk. The default is ``None``, meaning that no line " "is considered junk." msgstr "" -#: ../src/Doc/library/difflib.rst:624 +#: library/difflib.rst:624 msgid "" "*charjunk*: A function that accepts a single character argument (a string of " "length 1), and returns true if the character is junk. The default is " "``None``, meaning that no character is considered junk." msgstr "" -#: ../src/Doc/library/difflib.rst:628 +#: library/difflib.rst:628 msgid "" ":class:`Differ` objects are used (deltas generated) via a single method:" msgstr "" -#: ../src/Doc/library/difflib.rst:633 +#: library/difflib.rst:633 msgid "" "Compare two sequences of lines, and generate the delta (a sequence of lines)." msgstr "" # 4b2b95c95b5a40ab87c545eb7bb96185 -#: ../src/Doc/library/difflib.rst:635 +#: library/difflib.rst:635 msgid "" "Each sequence must contain individual single-line strings ending with " "newlines. Such sequences can be obtained from the :meth:`~file.readlines` " @@ -30553,46 +30783,46 @@ msgid "" "writelines` method of a file-like object." msgstr "" -#: ../src/Doc/library/difflib.rst:646 +#: library/difflib.rst:646 msgid "Differ Example" msgstr "" # d84589339e73444292d3221f02eedb46 -#: ../src/Doc/library/difflib.rst:648 +#: library/difflib.rst:648 msgid "" "This example compares two texts. First we set up the texts, sequences of " "individual single-line strings ending with newlines (such sequences can also " "be obtained from the :meth:`~file.readlines` method of file-like objects):" msgstr "" -#: ../src/Doc/library/difflib.rst:667 +#: library/difflib.rst:667 msgid "Next we instantiate a Differ object:" msgstr "" -#: ../src/Doc/library/difflib.rst:671 +#: library/difflib.rst:671 msgid "" "Note that when instantiating a :class:`Differ` object we may pass functions " "to filter out line and character \"junk.\" See the :meth:`Differ` " "constructor for details." msgstr "" -#: ../src/Doc/library/difflib.rst:675 +#: library/difflib.rst:675 msgid "Finally, we compare the two:" msgstr "" -#: ../src/Doc/library/difflib.rst:679 +#: library/difflib.rst:679 msgid "``result`` is a list of strings, so let's pretty-print it:" msgstr "" -#: ../src/Doc/library/difflib.rst:694 +#: library/difflib.rst:694 msgid "As a single multi-line string it looks like this:" msgstr "" -#: ../src/Doc/library/difflib.rst:713 +#: library/difflib.rst:713 msgid "A command-line interface to difflib" msgstr "" -#: ../src/Doc/library/difflib.rst:715 +#: library/difflib.rst:715 msgid "" "This example shows how to use difflib to create a ``diff``-like utility. It " "is also contained in the Python source distribution, as :file:`Tools/scripts/" @@ -30600,12 +30830,16 @@ msgid "" msgstr "" # 598e497ae00b45baaef3093cb31a65b4 -#: ../src/Doc/library/dircache.rst:3 +#: library/dircache.rst:3 msgid ":mod:`dircache` --- Cached directory listings" msgstr "" +#: library/dircache.rst:9 +msgid "The :mod:`dircache` module has been removed in Python 3." +msgstr "" + # 72f12a558de64786b207fad36b33c3ad -#: ../src/Doc/library/dircache.rst:16 +#: library/dircache.rst:16 msgid "" "The :mod:`dircache` module defines a function for reading directory listing " "using a cache, and cache invalidation using the *mtime* of the directory. " @@ -30614,17 +30848,17 @@ msgid "" msgstr "" # e23492ec77804f9faf73e6aa33c81144 -#: ../src/Doc/library/dircache.rst:21 +#: library/dircache.rst:21 msgid "The :mod:`dircache` module defines the following functions:" msgstr "" # 258721654ab94c4fb4f06bb265124916 -#: ../src/Doc/library/dircache.rst:26 +#: library/dircache.rst:26 msgid "Resets the directory cache." msgstr "" # 365c8480a702437d95e24402b72593ad -#: ../src/Doc/library/dircache.rst:31 +#: library/dircache.rst:31 msgid "" "Return a directory listing of *path*, as gotten from :func:`os.listdir`. " "Note that unless *path* changes, further call to :func:`listdir` will not re-" @@ -30632,35 +30866,35 @@ msgid "" msgstr "" # b67ded595f0b4047a0ad2c67a495dcde -#: ../src/Doc/library/dircache.rst:35 +#: library/dircache.rst:35 msgid "" "Note that the list returned should be regarded as read-only. (Perhaps a " "future version should change it to return a tuple?)" msgstr "" # 50326e6c17c94f17a3606c7841642393 -#: ../src/Doc/library/dircache.rst:41 +#: library/dircache.rst:41 msgid "Same as :func:`listdir`. Defined for backwards compatibility." msgstr "" # e378bc7d6dc948a39ed669c1f13f8b3c -#: ../src/Doc/library/dircache.rst:46 +#: library/dircache.rst:46 msgid "" "Assume *list* is a list of paths relative to *head*, and append, in place, a " "``'/'`` to each path which points to a directory." msgstr "" -#: ../src/Doc/library/dis.rst:2 +#: library/dis.rst:2 msgid ":mod:`dis` --- Disassembler for Python bytecode" msgstr "" # e9d764feb9e14de2b94be2e24a406c85 -#: ../src/Doc/library/dis.rst:7 +#: library/dis.rst:7 msgid "**Source code:** :source:`Lib/dis.py`" msgstr "" # 51dde7ed7f9243fdbef81540f0d8efda -#: ../src/Doc/library/dis.rst:11 +#: library/dis.rst:11 msgid "" "The :mod:`dis` module supports the analysis of CPython :term:`bytecode` by " "disassembling it. The CPython bytecode which this module takes as an input " @@ -30669,7 +30903,7 @@ msgid "" msgstr "" # 2a245517a61f42978786de57dc749e1c -#: ../src/Doc/library/dis.rst:18 +#: library/dis.rst:18 msgid "" "Bytecode is an implementation detail of the CPython interpreter! No " "guarantees are made that bytecode will not be added, removed, or changed " @@ -30677,283 +30911,282 @@ msgid "" "work across Python VMs or Python releases." msgstr "" -#: ../src/Doc/library/dis.rst:23 +#: library/dis.rst:23 msgid "Example: Given the function :func:`myfunc`::" msgstr "" -#: ../src/Doc/library/dis.rst:28 +#: library/dis.rst:28 msgid "" "the following command can be used to get the disassembly of :func:`myfunc`::" msgstr "" -#: ../src/Doc/library/dis.rst:36 +#: library/dis.rst:36 msgid "(The \"2\" is a line number)." msgstr "" -#: ../src/Doc/library/dis.rst:38 +#: library/dis.rst:38 msgid "The :mod:`dis` module defines the following functions and constants:" msgstr "" -# afc2a99449944cdcb687eb4f6b4d93d6 -#: ../src/Doc/library/dis.rst:43 +#: library/dis.rst:43 msgid "" "Disassemble the *bytesource* object. *bytesource* can denote either a " -"module, a class, a method, a function, or a code object. For a module, it " +"module, a class, a method, a function, or a code object. For a module, it " "disassembles all functions. For a class, it disassembles all methods. For " "a single code sequence, it prints one line per bytecode instruction. If no " "object is provided, it disassembles the last traceback." msgstr "" -#: ../src/Doc/library/dis.rst:52 +#: library/dis.rst:52 msgid "" "Disassembles the top-of-stack function of a traceback, using the last " "traceback if none was passed. The instruction causing the exception is " "indicated." msgstr "" -#: ../src/Doc/library/dis.rst:58 +#: library/dis.rst:59 msgid "" "Disassembles a code object, indicating the last instruction if *lasti* was " "provided. The output is divided in the following columns:" msgstr "" -#: ../src/Doc/library/dis.rst:61 +#: library/dis.rst:62 msgid "the line number, for the first instruction of each line" msgstr "" -#: ../src/Doc/library/dis.rst:62 +#: library/dis.rst:63 msgid "the current instruction, indicated as ``-->``," msgstr "" -#: ../src/Doc/library/dis.rst:63 +#: library/dis.rst:64 msgid "a labelled instruction, indicated with ``>>``," msgstr "" -#: ../src/Doc/library/dis.rst:64 +#: library/dis.rst:65 msgid "the address of the instruction," msgstr "" -#: ../src/Doc/library/dis.rst:65 +#: library/dis.rst:66 msgid "the operation code name," msgstr "" -#: ../src/Doc/library/dis.rst:66 +#: library/dis.rst:67 msgid "operation parameters, and" msgstr "" -#: ../src/Doc/library/dis.rst:67 +#: library/dis.rst:68 msgid "interpretation of the parameters in parentheses." msgstr "" -#: ../src/Doc/library/dis.rst:69 +#: library/dis.rst:70 msgid "" "The parameter interpretation recognizes local and global variable names, " "constant values, branch targets, and compare operators." msgstr "" # 8e909eae7ff94d7488004460428b9f0d -#: ../src/Doc/library/dis.rst:75 +#: library/dis.rst:76 msgid "" "A synonym for :func:`disassemble`. It is more convenient to type, and kept " "for compatibility with earlier Python releases." msgstr "" -#: ../src/Doc/library/dis.rst:81 +#: library/dis.rst:82 msgid "" "This generator function uses the ``co_firstlineno`` and ``co_lnotab`` " "attributes of the code object *code* to find the offsets which are starts of " "lines in the source code. They are generated as ``(offset, lineno)`` pairs." msgstr "" -#: ../src/Doc/library/dis.rst:88 +#: library/dis.rst:89 msgid "" "Detect all offsets in the code object *code* which are jump targets, and " "return a list of these offsets." msgstr "" -#: ../src/Doc/library/dis.rst:94 +#: library/dis.rst:95 msgid "Sequence of operation names, indexable using the bytecode." msgstr "" # fdc9c0b360ba44d8b4537f8240f699a2 -#: ../src/Doc/library/dis.rst:99 +#: library/dis.rst:100 msgid "Dictionary mapping operation names to bytecodes." msgstr "" -#: ../src/Doc/library/dis.rst:104 +#: library/dis.rst:105 msgid "Sequence of all compare operation names." msgstr "" -#: ../src/Doc/library/dis.rst:109 +#: library/dis.rst:110 msgid "Sequence of bytecodes that have a constant parameter." msgstr "" -#: ../src/Doc/library/dis.rst:114 +#: library/dis.rst:115 msgid "Sequence of bytecodes that access a free variable." msgstr "" -#: ../src/Doc/library/dis.rst:119 +#: library/dis.rst:120 msgid "Sequence of bytecodes that access an attribute by name." msgstr "" -#: ../src/Doc/library/dis.rst:124 +#: library/dis.rst:125 msgid "Sequence of bytecodes that have a relative jump target." msgstr "" -#: ../src/Doc/library/dis.rst:129 +#: library/dis.rst:130 msgid "Sequence of bytecodes that have an absolute jump target." msgstr "" -#: ../src/Doc/library/dis.rst:134 +#: library/dis.rst:135 msgid "Sequence of bytecodes that access a local variable." msgstr "" -#: ../src/Doc/library/dis.rst:139 +#: library/dis.rst:140 msgid "Sequence of bytecodes of Boolean operations." msgstr "" -#: ../src/Doc/library/dis.rst:145 +#: library/dis.rst:146 msgid "Python Bytecode Instructions" msgstr "" -#: ../src/Doc/library/dis.rst:147 +#: library/dis.rst:148 msgid "" "The Python compiler currently generates the following bytecode instructions." msgstr "" -#: ../src/Doc/library/dis.rst:152 +#: library/dis.rst:153 msgid "Indicates end-of-code to the compiler, not used by the interpreter." msgstr "" -#: ../src/Doc/library/dis.rst:157 +#: library/dis.rst:158 msgid "Do nothing code. Used as a placeholder by the bytecode optimizer." msgstr "" -#: ../src/Doc/library/dis.rst:162 +#: library/dis.rst:163 msgid "Removes the top-of-stack (TOS) item." msgstr "" -#: ../src/Doc/library/dis.rst:167 +#: library/dis.rst:168 msgid "Swaps the two top-most stack items." msgstr "" -#: ../src/Doc/library/dis.rst:172 +#: library/dis.rst:173 msgid "" "Lifts second and third stack item one position up, moves top down to " "position three." msgstr "" -#: ../src/Doc/library/dis.rst:178 +#: library/dis.rst:179 msgid "" "Lifts second, third and forth stack item one position up, moves top down to " "position four." msgstr "" -#: ../src/Doc/library/dis.rst:184 +#: library/dis.rst:185 msgid "Duplicates the reference on top of the stack." msgstr "" -#: ../src/Doc/library/dis.rst:186 +#: library/dis.rst:187 msgid "" "Unary Operations take the top of the stack, apply the operation, and push " "the result back on the stack." msgstr "" -#: ../src/Doc/library/dis.rst:192 +#: library/dis.rst:193 msgid "Implements ``TOS = +TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:197 +#: library/dis.rst:198 msgid "Implements ``TOS = -TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:202 +#: library/dis.rst:203 msgid "Implements ``TOS = not TOS``." msgstr "" # bea3f2e8dd334e19a70c179f99183c6a -#: ../src/Doc/library/dis.rst:207 +#: library/dis.rst:208 msgid "Implements ``TOS = `TOS```." msgstr "" -#: ../src/Doc/library/dis.rst:212 +#: library/dis.rst:213 msgid "Implements ``TOS = ~TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:217 +#: library/dis.rst:218 msgid "Implements ``TOS = iter(TOS)``." msgstr "" -#: ../src/Doc/library/dis.rst:219 +#: library/dis.rst:220 msgid "" "Binary operations remove the top of the stack (TOS) and the second top-most " "stack item (TOS1) from the stack. They perform the operation, and put the " "result back on the stack." msgstr "" -#: ../src/Doc/library/dis.rst:226 +#: library/dis.rst:227 msgid "Implements ``TOS = TOS1 ** TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:231 +#: library/dis.rst:232 msgid "Implements ``TOS = TOS1 * TOS``." msgstr "" # e39375dc84bd4fe999518422cf0c29ec -#: ../src/Doc/library/dis.rst:236 +#: library/dis.rst:237 msgid "" "Implements ``TOS = TOS1 / TOS`` when ``from __future__ import division`` is " "not in effect." msgstr "" -#: ../src/Doc/library/dis.rst:242 +#: library/dis.rst:243 msgid "Implements ``TOS = TOS1 // TOS``." msgstr "" # 043d46521b414af5ada512da3eb7d3db -#: ../src/Doc/library/dis.rst:247 +#: library/dis.rst:248 msgid "" "Implements ``TOS = TOS1 / TOS`` when ``from __future__ import division`` is " "in effect." msgstr "" -#: ../src/Doc/library/dis.rst:253 +#: library/dis.rst:254 msgid "Implements ``TOS = TOS1 % TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:258 +#: library/dis.rst:259 msgid "Implements ``TOS = TOS1 + TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:263 +#: library/dis.rst:264 msgid "Implements ``TOS = TOS1 - TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:268 +#: library/dis.rst:269 msgid "Implements ``TOS = TOS1[TOS]``." msgstr "" -#: ../src/Doc/library/dis.rst:273 +#: library/dis.rst:274 msgid "Implements ``TOS = TOS1 << TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:278 +#: library/dis.rst:279 msgid "Implements ``TOS = TOS1 >> TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:283 +#: library/dis.rst:284 msgid "Implements ``TOS = TOS1 & TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:288 +#: library/dis.rst:289 msgid "Implements ``TOS = TOS1 ^ TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:293 +#: library/dis.rst:294 msgid "Implements ``TOS = TOS1 | TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:295 +#: library/dis.rst:296 msgid "" "In-place operations are like binary operations, in that they remove TOS and " "TOS1, and push the result back on the stack, but the operation is done in-" @@ -30961,150 +31194,150 @@ msgid "" "to be) the original TOS1." msgstr "" -#: ../src/Doc/library/dis.rst:303 +#: library/dis.rst:304 msgid "Implements in-place ``TOS = TOS1 ** TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:308 +#: library/dis.rst:309 msgid "Implements in-place ``TOS = TOS1 * TOS``." msgstr "" # 7153711547bd4586a731b79db1192dc1 -#: ../src/Doc/library/dis.rst:313 +#: library/dis.rst:314 msgid "" "Implements in-place ``TOS = TOS1 / TOS`` when ``from __future__ import " "division`` is not in effect." msgstr "" -#: ../src/Doc/library/dis.rst:319 +#: library/dis.rst:320 msgid "Implements in-place ``TOS = TOS1 // TOS``." msgstr "" # a3d970532a4a4f3fa7f5f7213a72cd02 -#: ../src/Doc/library/dis.rst:324 +#: library/dis.rst:325 msgid "" "Implements in-place ``TOS = TOS1 / TOS`` when ``from __future__ import " "division`` is in effect." msgstr "" -#: ../src/Doc/library/dis.rst:330 +#: library/dis.rst:331 msgid "Implements in-place ``TOS = TOS1 % TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:335 +#: library/dis.rst:336 msgid "Implements in-place ``TOS = TOS1 + TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:340 +#: library/dis.rst:341 msgid "Implements in-place ``TOS = TOS1 - TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:345 +#: library/dis.rst:346 msgid "Implements in-place ``TOS = TOS1 << TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:350 +#: library/dis.rst:351 msgid "Implements in-place ``TOS = TOS1 >> TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:355 +#: library/dis.rst:356 msgid "Implements in-place ``TOS = TOS1 & TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:360 +#: library/dis.rst:361 msgid "Implements in-place ``TOS = TOS1 ^ TOS``." msgstr "" -#: ../src/Doc/library/dis.rst:365 +#: library/dis.rst:366 msgid "Implements in-place ``TOS = TOS1 | TOS``." msgstr "" # 0e2ee145d2324306ae12d3f8a6077d8f -#: ../src/Doc/library/dis.rst:367 +#: library/dis.rst:368 msgid "The slice opcodes take up to three parameters." msgstr "" # e9b094d2fc6448a1aae85ea88e0238d8 -#: ../src/Doc/library/dis.rst:372 +#: library/dis.rst:373 msgid "Implements ``TOS = TOS[:]``." msgstr "" # 235e6050d6bc46ec8cdde8d47ebf5551 -#: ../src/Doc/library/dis.rst:377 +#: library/dis.rst:378 msgid "Implements ``TOS = TOS1[TOS:]``." msgstr "" # a5bdfe57a6014214b12f8d9837e0c023 -#: ../src/Doc/library/dis.rst:382 +#: library/dis.rst:383 msgid "Implements ``TOS = TOS1[:TOS]``." msgstr "" # e22fa27ac03848e1b604a130c0f2fec4 -#: ../src/Doc/library/dis.rst:387 +#: library/dis.rst:388 msgid "Implements ``TOS = TOS2[TOS1:TOS]``." msgstr "" # cddc0a86abf24d4d9a4068b6876a37b9 -#: ../src/Doc/library/dis.rst:389 +#: library/dis.rst:390 msgid "" "Slice assignment needs even an additional parameter. As any statement, they " "put nothing on the stack." msgstr "" # 8f51bc52bcf943428f404068dea0fdbe -#: ../src/Doc/library/dis.rst:395 +#: library/dis.rst:396 msgid "Implements ``TOS[:] = TOS1``." msgstr "" # f42c09eb39624838b29178ec53129052 -#: ../src/Doc/library/dis.rst:400 +#: library/dis.rst:401 msgid "Implements ``TOS1[TOS:] = TOS2``." msgstr "" # 34fa60d68ef949eda82f5ca8d56bd4f6 -#: ../src/Doc/library/dis.rst:405 +#: library/dis.rst:406 msgid "Implements ``TOS1[:TOS] = TOS2``." msgstr "" # 8fee99b316864a84b43d2599710edbf3 -#: ../src/Doc/library/dis.rst:410 +#: library/dis.rst:411 msgid "Implements ``TOS2[TOS1:TOS] = TOS3``." msgstr "" # 8e01bb9163ae4133b47cda0d7f593f58 -#: ../src/Doc/library/dis.rst:415 +#: library/dis.rst:416 msgid "Implements ``del TOS[:]``." msgstr "" # 86afcc6405664a0d804634fe9577931f -#: ../src/Doc/library/dis.rst:420 +#: library/dis.rst:421 msgid "Implements ``del TOS1[TOS:]``." msgstr "" # c6217e1bf60f4b36a26b5a5b67fb3c8c -#: ../src/Doc/library/dis.rst:425 +#: library/dis.rst:426 msgid "Implements ``del TOS1[:TOS]``." msgstr "" # 95a95a87b47146068716ef6e5edce2d4 -#: ../src/Doc/library/dis.rst:430 +#: library/dis.rst:431 msgid "Implements ``del TOS2[TOS1:TOS]``." msgstr "" -#: ../src/Doc/library/dis.rst:435 +#: library/dis.rst:436 msgid "Implements ``TOS1[TOS] = TOS2``." msgstr "" -#: ../src/Doc/library/dis.rst:440 +#: library/dis.rst:441 msgid "Implements ``del TOS1[TOS]``." msgstr "" -#: ../src/Doc/library/dis.rst:442 +#: library/dis.rst:443 msgid "Miscellaneous opcodes." msgstr "" # df4ebd8e7eb647e7a385f0dbbf362df2 -#: ../src/Doc/library/dis.rst:447 +#: library/dis.rst:448 msgid "" "Implements the expression statement for the interactive mode. TOS is " "removed from the stack and printed. In non-interactive mode, an expression " @@ -31112,21 +31345,21 @@ msgid "" msgstr "" # 8163d2c4bdac47c9ab15ef13fbfc3b7b -#: ../src/Doc/library/dis.rst:454 +#: library/dis.rst:455 msgid "" "Prints TOS to the file-like object bound to ``sys.stdout``. There is one " "such instruction for each item in the :keyword:`print` statement." msgstr "" # 95194b5507114ed499cdfcdacc08df98 -#: ../src/Doc/library/dis.rst:460 +#: library/dis.rst:461 msgid "" "Like ``PRINT_ITEM``, but prints the item second from TOS to the file-like " "object at TOS. This is used by the extended print statement." msgstr "" # 383cbfb64956454794b799b51e36dc59 -#: ../src/Doc/library/dis.rst:466 +#: library/dis.rst:467 msgid "" "Prints a new line on ``sys.stdout``. This is generated as the last " "operation of a :keyword:`print` statement, unless the statement ends with a " @@ -31134,25 +31367,25 @@ msgid "" msgstr "" # 120bb6d152bd44e3b520a7a409be7c74 -#: ../src/Doc/library/dis.rst:472 +#: library/dis.rst:473 msgid "" "Like ``PRINT_NEWLINE``, but prints the new line on the file-like object on " "the TOS. This is used by the extended print statement." msgstr "" -#: ../src/Doc/library/dis.rst:478 +#: library/dis.rst:479 msgid "Terminates a loop due to a :keyword:`break` statement." msgstr "" # 7d90c095adba4a5ca5bce9af1bfbad88 -#: ../src/Doc/library/dis.rst:483 +#: library/dis.rst:484 msgid "" "Continues a loop due to a :keyword:`continue` statement. *target* is the " "address to jump to (which should be a :opcode:`FOR_ITER` instruction)." msgstr "" # 18139d244ea147088d28db38dbcd08d2 -#: ../src/Doc/library/dis.rst:489 +#: library/dis.rst:490 msgid "" "Calls ``list.append(TOS[-i], TOS)``. Used to implement list comprehensions. " "While the appended value is popped off, the list object remains on the stack " @@ -31160,22 +31393,22 @@ msgid "" msgstr "" # 92a796b7db6c44ca9aa4c445895d6026 -#: ../src/Doc/library/dis.rst:496 +#: library/dis.rst:497 msgid "" "Pushes a reference to the locals of the current scope on the stack. This is " "used in the code for a class definition: After the class body is evaluated, " "the locals are passed to the class definition." msgstr "" -#: ../src/Doc/library/dis.rst:503 +#: library/dis.rst:504 msgid "Returns with TOS to the caller of the function." msgstr "" -#: ../src/Doc/library/dis.rst:508 +#: library/dis.rst:509 msgid "Pops ``TOS`` and yields it from a :term:`generator`." msgstr "" -#: ../src/Doc/library/dis.rst:513 +#: library/dis.rst:514 msgid "" "Loads all symbols not starting with ``'_'`` directly from the module TOS to " "the local namespace. The module is popped after loading all names. This " @@ -31183,19 +31416,19 @@ msgid "" msgstr "" # b0738c6dbd2540e8a7b26f197b42c415 -#: ../src/Doc/library/dis.rst:520 +#: library/dis.rst:521 msgid "" "Implements ``exec TOS2,TOS1,TOS``. The compiler fills missing optional " "parameters with ``None``." msgstr "" -#: ../src/Doc/library/dis.rst:526 +#: library/dis.rst:527 msgid "" -"Removes one block from the block stack. Per frame, there is a stack of " +"Removes one block from the block stack. Per frame, there is a stack of " "blocks, denoting nested loops, try statements, and such." msgstr "" -#: ../src/Doc/library/dis.rst:532 +#: library/dis.rst:533 msgid "" "Terminates a :keyword:`finally` clause. The interpreter recalls whether the " "exception has to be re-raised, or whether the function returns, and " @@ -31203,13 +31436,13 @@ msgid "" msgstr "" # 0baea5d08168420c8be4ead5acd57881 -#: ../src/Doc/library/dis.rst:539 +#: library/dis.rst:540 msgid "" "Creates a new class object. TOS is the methods dictionary, TOS1 the tuple " "of the names of the base classes, and TOS2 the class name." msgstr "" -#: ../src/Doc/library/dis.rst:545 +#: library/dis.rst:546 msgid "" "This opcode performs several operations before a with block starts. First, " "it loads :meth:`~object.__exit__` from the context manager and pushes it " @@ -31222,47 +31455,47 @@ msgid "" msgstr "" # f6cb74909d39440f9349734cf9c62ec0 -#: ../src/Doc/library/dis.rst:557 +#: library/dis.rst:558 msgid "" "Cleans up the stack when a :keyword:`with` statement block exits. On top of " "the stack are 1--3 values indicating how/why the finally clause was entered:" msgstr "" # 6fbfb852a11649099845bbea54611033 -#: ../src/Doc/library/dis.rst:560 +#: library/dis.rst:561 msgid "TOP = ``None``" msgstr "" # 92f4d5ee06f444e7a8acfa61df0bffa2 -#: ../src/Doc/library/dis.rst:561 +#: library/dis.rst:562 msgid "(TOP, SECOND) = (``WHY_{RETURN,CONTINUE}``), retval" msgstr "" # cacd15a5850c4b9b82b3c4cad534efbf -#: ../src/Doc/library/dis.rst:562 +#: library/dis.rst:563 msgid "TOP = ``WHY_*``; no retval below it" msgstr "" # f3b558d1adca45d5bd8ec772dcd4dbbd -#: ../src/Doc/library/dis.rst:563 +#: library/dis.rst:564 msgid "(TOP, SECOND, THIRD) = exc_info()" msgstr "" # 407c26f1ee7441c8806dbed1134dd521 -#: ../src/Doc/library/dis.rst:565 +#: library/dis.rst:566 msgid "" "Under them is EXIT, the context manager's :meth:`__exit__` bound method." msgstr "" # 8fe277afaa2a4c25bff7b03639e3275f -#: ../src/Doc/library/dis.rst:567 +#: library/dis.rst:568 msgid "" "In the last case, ``EXIT(TOP, SECOND, THIRD)`` is called, otherwise " "``EXIT(None, None, None)``." msgstr "" # b2c0a5a8aff54f85ab53449b168776c2 -#: ../src/Doc/library/dis.rst:570 +#: library/dis.rst:571 msgid "" "EXIT is removed from the stack, leaving the values above it in the same " "order. In addition, if the stack represents an exception, *and* the function " @@ -31271,91 +31504,95 @@ msgid "" "still be resumed.)" msgstr "" -#: ../src/Doc/library/dis.rst:579 +#: library/dis.rst:580 msgid "" "All of the following opcodes expect arguments. An argument is two bytes, " "with the more significant byte last." msgstr "" -#: ../src/Doc/library/dis.rst:584 +#: library/dis.rst:585 msgid "" "Implements ``name = TOS``. *namei* is the index of *name* in the attribute :" "attr:`co_names` of the code object. The compiler tries to use ``STORE_FAST`` " "or ``STORE_GLOBAL`` if possible." msgstr "" -#: ../src/Doc/library/dis.rst:591 +#: library/dis.rst:592 msgid "" "Implements ``del name``, where *namei* is the index into :attr:`co_names` " "attribute of the code object." msgstr "" -#: ../src/Doc/library/dis.rst:597 +#: library/dis.rst:598 msgid "" "Unpacks TOS into *count* individual values, which are put onto the stack " "right-to-left." msgstr "" -#: ../src/Doc/library/dis.rst:603 +#: library/dis.rst:604 msgid "" "Duplicate *count* items, keeping them in the same order. Due to " "implementation limits, *count* should be between 1 and 5 inclusive." msgstr "" -#: ../src/Doc/library/dis.rst:609 +#: library/dis.rst:610 msgid "" "Implements ``TOS.name = TOS1``, where *namei* is the index of name in :attr:" "`co_names`." msgstr "" -#: ../src/Doc/library/dis.rst:615 +#: library/dis.rst:616 msgid "" "Implements ``del TOS.name``, using *namei* as index into :attr:`co_names`." msgstr "" -#: ../src/Doc/library/dis.rst:620 +#: library/dis.rst:621 msgid "Works as ``STORE_NAME``, but stores the name as a global." msgstr "" -#: ../src/Doc/library/dis.rst:625 +#: library/dis.rst:626 msgid "Works as ``DELETE_NAME``, but deletes a global name." msgstr "" -#: ../src/Doc/library/dis.rst:630 +#: library/dis.rst:631 msgid "Pushes ``co_consts[consti]`` onto the stack." msgstr "" -#: ../src/Doc/library/dis.rst:635 +#: library/dis.rst:636 msgid "Pushes the value associated with ``co_names[namei]`` onto the stack." msgstr "" -#: ../src/Doc/library/dis.rst:640 +#: library/dis.rst:641 msgid "" "Creates a tuple consuming *count* items from the stack, and pushes the " "resulting tuple onto the stack." msgstr "" -#: ../src/Doc/library/dis.rst:646 +#: library/dis.rst:647 msgid "Works as ``BUILD_TUPLE``, but creates a list." msgstr "" -#: ../src/Doc/library/dis.rst:651 +#: library/dis.rst:652 +msgid "Works as ``BUILD_TUPLE``, but creates a set." +msgstr "" + +#: library/dis.rst:659 msgid "" "Pushes a new dictionary object onto the stack. The dictionary is pre-sized " "to hold *count* entries." msgstr "" -#: ../src/Doc/library/dis.rst:657 +#: library/dis.rst:665 msgid "Replaces TOS with ``getattr(TOS, co_names[namei])``." msgstr "" -#: ../src/Doc/library/dis.rst:662 +#: library/dis.rst:670 msgid "" "Performs a Boolean operation. The operation name can be found in " "``cmp_op[opname]``." msgstr "" -#: ../src/Doc/library/dis.rst:668 +#: library/dis.rst:676 msgid "" "Imports the module ``co_names[namei]``. TOS and TOS1 are popped and provide " "the *fromlist* and *level* arguments of :func:`__import__`. The module " @@ -31364,43 +31601,43 @@ msgid "" "the namespace." msgstr "" -#: ../src/Doc/library/dis.rst:677 +#: library/dis.rst:685 msgid "" "Loads the attribute ``co_names[namei]`` from the module found in TOS. The " "resulting object is pushed onto the stack, to be subsequently stored by a " "``STORE_FAST`` instruction." msgstr "" -#: ../src/Doc/library/dis.rst:684 +#: library/dis.rst:692 msgid "Increments bytecode counter by *delta*." msgstr "" -#: ../src/Doc/library/dis.rst:689 +#: library/dis.rst:697 msgid "If TOS is true, sets the bytecode counter to *target*. TOS is popped." msgstr "" -#: ../src/Doc/library/dis.rst:694 +#: library/dis.rst:702 msgid "If TOS is false, sets the bytecode counter to *target*. TOS is popped." msgstr "" -#: ../src/Doc/library/dis.rst:699 +#: library/dis.rst:707 msgid "" "If TOS is true, sets the bytecode counter to *target* and leaves TOS on the " "stack. Otherwise (TOS is false), TOS is popped." msgstr "" -#: ../src/Doc/library/dis.rst:705 +#: library/dis.rst:713 msgid "" "If TOS is false, sets the bytecode counter to *target* and leaves TOS on the " "stack. Otherwise (TOS is true), TOS is popped." msgstr "" -#: ../src/Doc/library/dis.rst:711 +#: library/dis.rst:719 msgid "Set bytecode counter to *target*." msgstr "" # 29409e244b69401d91e3b3f55d24cc79 -#: ../src/Doc/library/dis.rst:716 +#: library/dis.rst:724 msgid "" "``TOS`` is an :term:`iterator`. Call its :meth:`!next` method. If this " "yields a new value, push it on the stack (leaving the iterator below it). " @@ -31408,79 +31645,79 @@ msgid "" "bytecode counter is incremented by *delta*." msgstr "" -#: ../src/Doc/library/dis.rst:724 +#: library/dis.rst:732 msgid "Loads the global named ``co_names[namei]`` onto the stack." msgstr "" -#: ../src/Doc/library/dis.rst:729 +#: library/dis.rst:737 msgid "" "Pushes a block for a loop onto the block stack. The block spans from the " "current instruction with a size of *delta* bytes." msgstr "" -#: ../src/Doc/library/dis.rst:735 +#: library/dis.rst:743 msgid "" "Pushes a try block from a try-except clause onto the block stack. *delta* " "points to the first except block." msgstr "" -#: ../src/Doc/library/dis.rst:741 +#: library/dis.rst:749 msgid "" "Pushes a try block from a try-except clause onto the block stack. *delta* " "points to the finally block." msgstr "" -#: ../src/Doc/library/dis.rst:746 +#: library/dis.rst:754 msgid "" "Store a key and value pair in a dictionary. Pops the key and value while " "leaving the dictionary on the stack." msgstr "" -#: ../src/Doc/library/dis.rst:751 +#: library/dis.rst:759 msgid "" "Pushes a reference to the local ``co_varnames[var_num]`` onto the stack." msgstr "" -#: ../src/Doc/library/dis.rst:756 +#: library/dis.rst:764 msgid "Stores TOS into the local ``co_varnames[var_num]``." msgstr "" -#: ../src/Doc/library/dis.rst:761 +#: library/dis.rst:769 msgid "Deletes local ``co_varnames[var_num]``." msgstr "" -#: ../src/Doc/library/dis.rst:766 +#: library/dis.rst:774 msgid "" "Pushes a reference to the cell contained in slot *i* of the cell and free " -"variable storage. The name of the variable is ``co_cellvars[i]`` if *i* is " -"less than the length of *co_cellvars*. Otherwise it is ``co_freevars[i - " +"variable storage. The name of the variable is ``co_cellvars[i]`` if *i* is " +"less than the length of *co_cellvars*. Otherwise it is ``co_freevars[i - " "len(co_cellvars)]``." msgstr "" -#: ../src/Doc/library/dis.rst:774 +#: library/dis.rst:782 msgid "" "Loads the cell contained in slot *i* of the cell and free variable storage. " "Pushes a reference to the object the cell contains on the stack." msgstr "" -#: ../src/Doc/library/dis.rst:780 +#: library/dis.rst:788 msgid "" "Stores TOS into the cell contained in slot *i* of the cell and free variable " "storage." msgstr "" -#: ../src/Doc/library/dis.rst:786 +#: library/dis.rst:794 msgid "This opcode is obsolete." msgstr "" -#: ../src/Doc/library/dis.rst:791 +#: library/dis.rst:799 msgid "" "Raises an exception. *argc* indicates the number of parameters to the raise " "statement, ranging from 0 to 3. The handler will find the traceback as " "TOS2, the parameter as TOS1, and the exception as TOS." msgstr "" -#: ../src/Doc/library/dis.rst:798 +#: library/dis.rst:806 msgid "" "Calls a function. The low byte of *argc* indicates the number of positional " "parameters, the high byte the number of keyword parameters. On the stack, " @@ -31492,7 +31729,7 @@ msgid "" "pushes the return value." msgstr "" -#: ../src/Doc/library/dis.rst:809 +#: library/dis.rst:818 msgid "" "Pushes a new function object on the stack. TOS is the code associated with " "the function. The function object is defined to have *argc* default " @@ -31500,7 +31737,7 @@ msgid "" msgstr "" # 4e8fe468fa394e9ba5bce0512fb83f02 -#: ../src/Doc/library/dis.rst:816 +#: library/dis.rst:825 msgid "" "Creates a new function object, sets its *func_closure* slot, and pushes it " "on the stack. TOS is the code associated with the function, TOS1 the tuple " @@ -31508,14 +31745,14 @@ msgid "" "*argc* default parameters, which are found below the cells." msgstr "" -#: ../src/Doc/library/dis.rst:826 +#: library/dis.rst:835 msgid "" "Pushes a slice object on the stack. *argc* must be 2 or 3. If it is 2, " "``slice(TOS1, TOS)`` is pushed; if it is 3, ``slice(TOS2, TOS1, TOS)`` is " "pushed. See the :func:`slice` built-in function for more information." msgstr "" -#: ../src/Doc/library/dis.rst:833 +#: library/dis.rst:842 msgid "" "Prefixes any opcode which has an argument too big to fit into the default " "two bytes. *ext* holds two additional bytes which, taken together with the " @@ -31524,23 +31761,22 @@ msgid "" msgstr "" # d9bcd0bb3a5740d7bad8da3d3c8e193d -#: ../src/Doc/library/dis.rst:841 +#: library/dis.rst:850 msgid "" "Calls a function. *argc* is interpreted as in :opcode:`CALL_FUNCTION`. The " "top element on the stack contains the variable argument list, followed by " "keyword and positional arguments." msgstr "" -# 594dcf148f8048629dfe3a649aecae23 -#: ../src/Doc/library/dis.rst:848 +#: library/dis.rst:857 msgid "" "Calls a function. *argc* is interpreted as in :opcode:`CALL_FUNCTION`. The " -"top element on the stack contains the keyword arguments dictionary, " -"followed by explicit keyword and positional arguments." +"top element on the stack contains the keyword arguments dictionary, followed " +"by explicit keyword and positional arguments." msgstr "" # 7a44a97430214705ac1abb642d637d67 -#: ../src/Doc/library/dis.rst:855 +#: library/dis.rst:864 msgid "" "Calls a function. *argc* is interpreted as in :opcode:`CALL_FUNCTION`. The " "top element on the stack contains the keyword arguments dictionary, followed " @@ -31548,7 +31784,7 @@ msgid "" "arguments." msgstr "" -#: ../src/Doc/library/dis.rst:862 +#: library/dis.rst:872 msgid "" "This is not really an opcode. It identifies the dividing line between " "opcodes which don't take arguments ``< HAVE_ARGUMENT`` and those which do " @@ -31556,12 +31792,12 @@ msgid "" msgstr "" # 503a37eb387a4236b07e3231d08dfdb4 -#: ../src/Doc/library/distribution.rst:3 +#: library/distribution.rst:3 msgid "Software Packaging and Distribution" msgstr "" # 613433da98084f6aade325a234f328bc -#: ../src/Doc/library/distribution.rst:5 +#: library/distribution.rst:5 msgid "" "These libraries help you with publishing and installing Python software. " "While these modules are designed to work in conjunction with the `Python " @@ -31569,11 +31805,11 @@ msgid "" "local index server, or without any index server at all." msgstr "" -#: ../src/Doc/library/distutils.rst:3 +#: library/distutils.rst:3 msgid ":mod:`distutils` --- Building and installing Python modules" msgstr "" -#: ../src/Doc/library/distutils.rst:11 +#: library/distutils.rst:11 msgid "" "The :mod:`distutils` package provides support for building and installing " "additional modules into a Python installation. The new modules may be " @@ -31582,29 +31818,27 @@ msgid "" "and C." msgstr "" -#: ../src/Doc/library/distutils.rst:16 +#: library/distutils.rst:16 msgid "This package is discussed in two separate chapters:" msgstr "" -# 0959b1b5c9d64b15931a09a9da975834 -#: ../src/Doc/library/distutils.rst:23 -msgid ":ref:`distutils-index`" +#: library/distutils.rst:24 +msgid "distutils-index" msgstr "" -#: ../src/Doc/library/distutils.rst:22 +#: library/distutils.rst:22 msgid "" "The manual for developers and packagers of Python modules. This describes " "how to prepare :mod:`distutils`\\ -based packages so that they may be easily " "installed into an existing Python installation." msgstr "" -# ccaa45cbd9564f3b9b99bb3e42701c07 -#: ../src/Doc/library/distutils.rst:27 -msgid ":ref:`install-index`" +#: library/distutils.rst:28 +msgid "install-index" msgstr "" # 9b4f01b0715c4717903bbd48b12cc1d7 -#: ../src/Doc/library/distutils.rst:27 +#: library/distutils.rst:27 msgid "" "An \"administrators\" manual which includes information on installing " "modules into an existing Python installation. You do not need to be a Python " @@ -31612,12 +31846,18 @@ msgid "" msgstr "" # b5fb5e1e794e4198933685b6dcd6b5a3 -#: ../src/Doc/library/dl.rst:3 +#: library/dl.rst:3 msgid ":mod:`dl` --- Call C functions in shared objects" msgstr "" +#: library/dl.rst:10 +msgid "" +"The :mod:`dl` module has been removed in Python 3. Use the :mod:`ctypes` " +"module instead." +msgstr "" + # f0fb5cb8fa8343ea91b95d742a5c1c95 -#: ../src/Doc/library/dl.rst:16 +#: library/dl.rst:16 msgid "" "The :mod:`dl` module defines an interface to the :c:func:`dlopen` function, " "which is the most common interface on Unix platforms for handling " @@ -31626,7 +31866,7 @@ msgid "" msgstr "" # 35db7e87fefb448982f26f4cbbe85688 -#: ../src/Doc/library/dl.rst:22 +#: library/dl.rst:22 msgid "" "The :mod:`dl` module bypasses the Python type system and error handling. If " "used incorrectly it may cause segmentation faults, crashes or other " @@ -31634,7 +31874,7 @@ msgid "" msgstr "" # f365d7d9558a4d589b5a91b0ce5944e1 -#: ../src/Doc/library/dl.rst:28 +#: library/dl.rst:28 msgid "" "This module will not work unless ``sizeof(int) == sizeof(long) == " "sizeof(char *)`` If this is not the case, :exc:`SystemError` will be raised " @@ -31642,12 +31882,12 @@ msgid "" msgstr "" # 9190d12d5ac5453f8ea8bdde5fda7a46 -#: ../src/Doc/library/dl.rst:31 +#: library/dl.rst:31 msgid "The :mod:`dl` module defines the following function:" msgstr "" # b516beaf22594202a4ba7d2b956e6385 -#: ../src/Doc/library/dl.rst:36 +#: library/dl.rst:36 msgid "" "Open a shared object file, and return a handle. Mode signifies late binding " "(:const:`RTLD_LAZY`) or immediate binding (:const:`RTLD_NOW`). Default is :" @@ -31655,22 +31895,22 @@ msgid "" msgstr "" # 12422b89b06141a1b36e6544ef222485 -#: ../src/Doc/library/dl.rst:40 +#: library/dl.rst:40 msgid "Return value is a :class:`dlobject`." msgstr "" # 98752190720e4887ab3cff1c36956e82 -#: ../src/Doc/library/dl.rst:42 +#: library/dl.rst:42 msgid "The :mod:`dl` module defines the following constants:" msgstr "" # 74d8781ad1a745e888c36d7c1fc83297 -#: ../src/Doc/library/dl.rst:47 +#: library/dl.rst:47 msgid "Useful as an argument to :func:`.open`." msgstr "" # ee7e88f31de7404193b850ac310a5f77 -#: ../src/Doc/library/dl.rst:52 +#: library/dl.rst:52 msgid "" "Useful as an argument to :func:`.open`. Note that on systems which do not " "support immediate binding, this constant will not appear in the module. For " @@ -31679,42 +31919,42 @@ msgid "" msgstr "" # 07f2fa3ab3514c1d8e3fe8b06fd23784 -#: ../src/Doc/library/dl.rst:57 +#: library/dl.rst:57 msgid "The :mod:`dl` module defines the following exception:" msgstr "" # fda938b5b26047caa54f2eb8fa3710cc -#: ../src/Doc/library/dl.rst:62 +#: library/dl.rst:62 msgid "" "Exception raised when an error has occurred inside the dynamic loading and " "linking routines." msgstr "" # 6c07d57bf57b41a8840be2a7ad43fd2b -#: ../src/Doc/library/dl.rst:72 +#: library/dl.rst:72 msgid "" "This example was tried on a Debian GNU/Linux system, and is a good example " "of the fact that using this module is usually a bad alternative." msgstr "" # b3a3d188f9bb4987b9da62cc6ef75b60 -#: ../src/Doc/library/dl.rst:79 +#: library/dl.rst:79 msgid "Dl Objects" msgstr "" # ded7a9e32ccb4458a1fbc6628aa0d860 -#: ../src/Doc/library/dl.rst:81 +#: library/dl.rst:81 msgid "" "Dl objects, as returned by :func:`.open` above, have the following methods:" msgstr "" # e8748a2637f74ac69391e504a888f342 -#: ../src/Doc/library/dl.rst:86 +#: library/dl.rst:86 msgid "Free all resources, except the memory." msgstr "" # 6753fa1ec7864073b1cccd83c32de778 -#: ../src/Doc/library/dl.rst:91 +#: library/dl.rst:91 msgid "" "Return the pointer for the function named *name*, as a number, if it exists " "in the referenced shared object, otherwise ``None``. This is useful in code " @@ -31722,14 +31962,14 @@ msgid "" msgstr "" # 3c144dca41244e7191b4a622f0f121fc -#: ../src/Doc/library/dl.rst:99 +#: library/dl.rst:99 msgid "" "(Note that this function will return a non-zero number, as zero is the " "*NULL* pointer)" msgstr "" # cf6894da3a6f47a8af4884a5c8f6ce63 -#: ../src/Doc/library/dl.rst:105 +#: library/dl.rst:105 msgid "" "Call the function named *name* in the referenced shared object. The " "arguments must be either Python integers, which will be passed as is, " @@ -31739,37 +31979,37 @@ msgid "" msgstr "" # f7fa48a291784c61afa1501677105d78 -#: ../src/Doc/library/dl.rst:111 +#: library/dl.rst:111 msgid "" "There must be at most 10 arguments, and arguments not given will be treated " "as ``None``. The function's return value must be a C :c:type:`long`, which " "is a Python integer." msgstr "" -#: ../src/Doc/library/doctest.rst:4 +#: library/doctest.rst:4 msgid ":mod:`doctest` --- Test interactive Python examples" msgstr "" -#: ../src/Doc/library/doctest.rst:14 +#: library/doctest.rst:14 msgid "" "The :mod:`doctest` module searches for pieces of text that look like " "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 "" -#: ../src/Doc/library/doctest.rst:18 +#: library/doctest.rst:18 msgid "" "To check that a module's docstrings are up-to-date by verifying that all " "interactive examples still work as documented." msgstr "" -#: ../src/Doc/library/doctest.rst:21 +#: library/doctest.rst:21 msgid "" "To perform regression testing by verifying that interactive examples from a " "test file or a test object work as expected." msgstr "" -#: ../src/Doc/library/doctest.rst:24 +#: library/doctest.rst:24 msgid "" "To write tutorial documentation for a package, liberally illustrated with " "input-output examples. Depending on whether the examples or the expository " @@ -31777,29 +32017,29 @@ msgid "" "\"executable documentation\"." msgstr "" -#: ../src/Doc/library/doctest.rst:29 +#: library/doctest.rst:29 msgid "Here's a complete but small example module::" msgstr "" -#: ../src/Doc/library/doctest.rst:93 +#: library/doctest.rst:93 msgid "" "If you run :file:`example.py` directly from the command line, :mod:`doctest` " "works its magic::" msgstr "" # cac457fff31a4fd2b349ddddac79d9db -#: ../src/Doc/library/doctest.rst:99 +#: library/doctest.rst:99 msgid "" "There's no output! That's normal, and it means all the examples worked. " "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 "" -#: ../src/Doc/library/doctest.rst:120 +#: library/doctest.rst:120 msgid "And so on, eventually ending with::" msgstr "" -#: ../src/Doc/library/doctest.rst:137 +#: library/doctest.rst:137 msgid "" "That's all you need to know to start making productive use of :mod:" "`doctest`! Jump in. The following sections provide full details. Note that " @@ -31808,27 +32048,27 @@ msgid "" "file :file:`Lib/test/test_doctest.py`." msgstr "" -#: ../src/Doc/library/doctest.rst:147 +#: library/doctest.rst:147 msgid "Simple Usage: Checking Examples in Docstrings" msgstr "" -#: ../src/Doc/library/doctest.rst:149 +#: library/doctest.rst:149 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 "" -#: ../src/Doc/library/doctest.rst:156 +#: library/doctest.rst:156 msgid ":mod:`doctest` then examines docstrings in module :mod:`M`." msgstr "" -#: ../src/Doc/library/doctest.rst:158 +#: library/doctest.rst:158 msgid "" "Running the module as a script causes the examples in the docstrings to get " "executed and verified::" msgstr "" -#: ../src/Doc/library/doctest.rst:163 +#: library/doctest.rst:163 msgid "" "This won't display anything unless an example fails, in which case the " "failing example(s) and the cause(s) of the failure(s) are printed to stdout, " @@ -31837,18 +32077,18 @@ msgid "" msgstr "" # 47270a21f944486d82613876d047152d -#: ../src/Doc/library/doctest.rst:168 +#: library/doctest.rst:168 msgid "Run it with the ``-v`` switch instead::" msgstr "" -#: ../src/Doc/library/doctest.rst:172 +#: library/doctest.rst:172 msgid "" "and a detailed report of all examples tried is printed to standard output, " "along with assorted summaries at the end." msgstr "" # cd41d0b0340749a785f85421393a7230 -#: ../src/Doc/library/doctest.rst:175 +#: library/doctest.rst:175 msgid "" "You can force verbose mode by passing ``verbose=True`` to :func:`testmod`, " "or prohibit it by passing ``verbose=False``. In either of those cases, " @@ -31857,7 +32097,7 @@ msgid "" msgstr "" # 6357d31c8988480992aa19cae6a5e779 -#: ../src/Doc/library/doctest.rst:180 +#: library/doctest.rst:180 msgid "" "Since Python 2.6, there is also a command line shortcut for running :func:" "`testmod`. You can instruct the Python interpreter to run the doctest " @@ -31865,30 +32105,30 @@ msgid "" "command line::" msgstr "" -#: ../src/Doc/library/doctest.rst:187 +#: library/doctest.rst:187 msgid "" "This will import :file:`example.py` as a standalone module and run :func:" "`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 "" -#: ../src/Doc/library/doctest.rst:191 +#: library/doctest.rst:191 msgid "" "For more information on :func:`testmod`, see section :ref:`doctest-basic-" "api`." msgstr "" -#: ../src/Doc/library/doctest.rst:197 +#: library/doctest.rst:197 msgid "Simple Usage: Checking Examples in a Text File" msgstr "" -#: ../src/Doc/library/doctest.rst:199 +#: library/doctest.rst:199 msgid "" "Another simple application of doctest is testing interactive examples in a " "text file. This can be done with the :func:`testfile` function::" msgstr "" -#: ../src/Doc/library/doctest.rst:205 +#: library/doctest.rst:205 msgid "" "That short script executes and verifies any interactive Python examples " "contained in the file :file:`example.txt`. The file content is treated as " @@ -31896,13 +32136,13 @@ msgid "" "Python program! For example, perhaps :file:`example.txt` contains this::" msgstr "" -#: ../src/Doc/library/doctest.rst:226 +#: library/doctest.rst:226 msgid "" "Running ``doctest.testfile(\"example.txt\")`` then finds the error in this " "documentation::" msgstr "" -#: ../src/Doc/library/doctest.rst:237 +#: library/doctest.rst:237 msgid "" "As with :func:`testmod`, :func:`testfile` won't display anything unless an " "example fails. If an example does fail, then the failing example(s) and the " @@ -31910,7 +32150,7 @@ msgid "" "func:`testmod`." msgstr "" -#: ../src/Doc/library/doctest.rst:242 +#: library/doctest.rst:242 msgid "" "By default, :func:`testfile` looks for files in the calling module's " "directory. See section :ref:`doctest-basic-api` for a description of the " @@ -31919,14 +32159,14 @@ msgid "" msgstr "" # f1b7f1d817df4001af72463aa05485ec -#: ../src/Doc/library/doctest.rst:246 +#: library/doctest.rst:246 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 "" # 29efb24c201b45fa8490323a2a2c7f2a -#: ../src/Doc/library/doctest.rst:250 +#: library/doctest.rst:250 msgid "" "Since Python 2.6, there is also a command line shortcut for running :func:" "`testfile`. You can instruct the Python interpreter to run the doctest " @@ -31934,23 +32174,23 @@ msgid "" "command line::" msgstr "" -#: ../src/Doc/library/doctest.rst:257 +#: library/doctest.rst:257 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 "" -#: ../src/Doc/library/doctest.rst:260 +#: library/doctest.rst:260 msgid "" "For more information on :func:`testfile`, see section :ref:`doctest-basic-" "api`." msgstr "" -#: ../src/Doc/library/doctest.rst:266 +#: library/doctest.rst:266 msgid "How It Works" msgstr "" -#: ../src/Doc/library/doctest.rst:268 +#: library/doctest.rst:268 msgid "" "This section examines in detail how doctest works: which docstrings it looks " "at, how it finds interactive examples, what execution context it uses, how " @@ -31960,17 +32200,17 @@ msgid "" "see the following sections." msgstr "" -#: ../src/Doc/library/doctest.rst:279 +#: library/doctest.rst:279 msgid "Which Docstrings Are Examined?" msgstr "" -#: ../src/Doc/library/doctest.rst:281 +#: library/doctest.rst:281 msgid "" "The module docstring, and all function, class and method docstrings are " "searched. Objects imported into the module are not searched." msgstr "" -#: ../src/Doc/library/doctest.rst:284 +#: library/doctest.rst:284 msgid "" "In addition, if ``M.__test__`` exists and \"is true\", it must be a dict, " "and each entry maps a (string) name to a function object, class object, or " @@ -31979,35 +32219,39 @@ msgid "" "key ``K`` in ``M.__test__`` appears with name ::" msgstr "" -#: ../src/Doc/library/doctest.rst:292 +#: library/doctest.rst:292 msgid "" "Any classes found are recursively searched similarly, to test docstrings in " "their contained methods and nested classes." msgstr "" -#: ../src/Doc/library/doctest.rst:302 +#: library/doctest.rst:295 +msgid "A \"private name\" concept is deprecated and no longer documented." +msgstr "" + +#: library/doctest.rst:302 msgid "How are Docstring Examples Recognized?" msgstr "" -#: ../src/Doc/library/doctest.rst:304 +#: library/doctest.rst:304 msgid "" "In most cases a copy-and-paste of an interactive console session works fine, " "but doctest isn't trying to do an exact emulation of any specific Python " "shell." msgstr "" -#: ../src/Doc/library/doctest.rst:325 +#: library/doctest.rst:325 msgid "" "Any expected output must immediately follow the final ``'>>> '`` or ``'... " "'`` line containing the code, and the expected output (if any) extends to " "the next ``'>>> '`` or all-whitespace line." msgstr "" -#: ../src/Doc/library/doctest.rst:329 +#: library/doctest.rst:329 msgid "The fine print:" msgstr "" -#: ../src/Doc/library/doctest.rst:331 +#: library/doctest.rst:331 msgid "" "Expected output cannot contain an all-whitespace line, since such a line is " "taken to signal the end of expected output. If expected output does contain " @@ -32015,8 +32259,14 @@ msgid "" "line is expected." msgstr "" +#: library/doctest.rst:336 +msgid "" +"```` was added; there was no way to use expected output " +"containing empty lines in previous versions." +msgstr "" + # beaf3e7d93a74d7e92b1206e09cb50c9 -#: ../src/Doc/library/doctest.rst:340 +#: library/doctest.rst:340 msgid "" "All hard tab characters are expanded to spaces, using 8-column tab stops. " "Tabs in output generated by the tested code are not modified. Because any " @@ -32031,13 +32281,19 @@ msgid "" "`DocTestParser` class." msgstr "" -#: ../src/Doc/library/doctest.rst:356 +#: library/doctest.rst:352 +msgid "" +"Expanding tabs to spaces is new; previous versions tried to preserve hard " +"tabs, with confusing results." +msgstr "" + +#: library/doctest.rst:356 msgid "" "Output to stdout is captured, but not output to stderr (exception tracebacks " "are captured via a different means)." msgstr "" -#: ../src/Doc/library/doctest.rst:359 +#: library/doctest.rst:359 msgid "" "If you continue a line via backslashing in an interactive session, or for " "any other reason use a backslash, you should use a raw docstring, which will " @@ -32045,7 +32301,7 @@ msgid "" msgstr "" # 2a60334413754ab987d1d50a2c25c43b -#: ../src/Doc/library/doctest.rst:368 +#: library/doctest.rst:368 msgid "" "Otherwise, the backslash will be interpreted as part of the string. For " "example, the ``\\n`` above would be interpreted as a newline character. " @@ -32053,21 +32309,21 @@ msgid "" "use a raw string)::" msgstr "" -#: ../src/Doc/library/doctest.rst:377 +#: library/doctest.rst:377 msgid "The starting column doesn't matter::" msgstr "" -#: ../src/Doc/library/doctest.rst:384 +#: library/doctest.rst:384 msgid "" "and as many leading whitespace characters are stripped from the expected " "output as appeared in the initial ``'>>> '`` line that started the example." msgstr "" -#: ../src/Doc/library/doctest.rst:391 +#: library/doctest.rst:391 msgid "What's the Execution Context?" msgstr "" -#: ../src/Doc/library/doctest.rst:393 +#: library/doctest.rst:393 msgid "" "By default, each time :mod:`doctest` finds a docstring to test, it uses a " "*shallow copy* of :mod:`M`'s globals, so that running tests doesn't change " @@ -32078,17 +32334,17 @@ msgid "" "defined in other docstrings." msgstr "" -#: ../src/Doc/library/doctest.rst:401 +#: library/doctest.rst:401 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 "" -#: ../src/Doc/library/doctest.rst:408 +#: library/doctest.rst:408 msgid "What About Exceptions?" msgstr "" -#: ../src/Doc/library/doctest.rst:410 +#: library/doctest.rst:410 msgid "" "No problem, provided that the traceback is the only output produced by the " "example: just paste in the traceback. [#]_ Since tracebacks contain details " @@ -32097,31 +32353,31 @@ msgid "" "it accepts." msgstr "" -#: ../src/Doc/library/doctest.rst:416 +#: library/doctest.rst:416 msgid "Simple example::" msgstr "" -#: ../src/Doc/library/doctest.rst:423 +#: library/doctest.rst:423 msgid "" "That doctest succeeds if :exc:`ValueError` is raised, with the ``list." "remove(x): x not in list`` detail as shown." msgstr "" -#: ../src/Doc/library/doctest.rst:426 +#: library/doctest.rst:426 msgid "" "The expected output for an exception must start with a traceback header, " "which may be either of the following two lines, indented the same as the " "first line of the example::" msgstr "" -#: ../src/Doc/library/doctest.rst:433 +#: library/doctest.rst:433 msgid "" "The traceback header is followed by an optional traceback stack, whose " "contents are ignored by doctest. The traceback stack is typically omitted, " "or copied verbatim from an interactive session." msgstr "" -#: ../src/Doc/library/doctest.rst:437 +#: library/doctest.rst:437 msgid "" "The traceback stack is followed by the most interesting part: the line(s) " "containing the exception type and detail. This is usually the last line of " @@ -32129,20 +32385,24 @@ msgid "" "multi-line detail::" msgstr "" -#: ../src/Doc/library/doctest.rst:449 +#: library/doctest.rst:449 msgid "" "The last three lines (starting with :exc:`ValueError`) are compared against " "the exception's type and detail, and the rest are ignored." msgstr "" -#: ../src/Doc/library/doctest.rst:455 +#: library/doctest.rst:452 +msgid "Previous versions were unable to handle multi-line exception details." +msgstr "" + +#: library/doctest.rst:455 msgid "" "Best practice is to omit the traceback stack, unless it adds significant " "documentation value to the example. So the last example is probably better " "as::" msgstr "" -#: ../src/Doc/library/doctest.rst:465 +#: library/doctest.rst:465 msgid "" "Note that tracebacks are treated very specially. In particular, in the " "rewritten example, the use of ``...`` is independent of doctest's :const:" @@ -32151,11 +32411,11 @@ msgid "" "transcript of a Monty Python skit." msgstr "" -#: ../src/Doc/library/doctest.rst:471 +#: library/doctest.rst:471 msgid "Some details you should read once, but won't need to remember:" msgstr "" -#: ../src/Doc/library/doctest.rst:473 +#: library/doctest.rst:473 msgid "" "Doctest can't guess whether your expected output came from an exception " "traceback or from ordinary printing. So, e.g., an example that expects " @@ -32165,7 +32425,7 @@ msgid "" "create real problems." msgstr "" -#: ../src/Doc/library/doctest.rst:480 +#: library/doctest.rst:480 msgid "" "Each line of the traceback stack (if present) must be indented further than " "the first line of the example, *or* start with a non-alphanumeric character. " @@ -32174,14 +32434,14 @@ msgid "" "course this does the right thing for genuine tracebacks." msgstr "" -#: ../src/Doc/library/doctest.rst:486 +#: library/doctest.rst:486 msgid "" "When the :const:`IGNORE_EXCEPTION_DETAIL` doctest option is specified, " "everything following the leftmost colon and any module information in the " "exception name is ignored." msgstr "" -#: ../src/Doc/library/doctest.rst:490 +#: library/doctest.rst:490 msgid "" "The interactive shell omits the traceback header line for some :exc:" "`SyntaxError`\\ s. But doctest uses the traceback header line to " @@ -32190,13 +32450,13 @@ msgid "" "need to manually add the traceback header line to your test example." msgstr "" -#: ../src/Doc/library/doctest.rst:496 +#: library/doctest.rst:496 msgid "" "For some :exc:`SyntaxError`\\ s, Python displays the character position of " "the syntax error, using a ``^`` marker::" msgstr "" -#: ../src/Doc/library/doctest.rst:505 +#: library/doctest.rst:505 msgid "" "Since the lines showing the position of the error come before the exception " "type and detail, they are not checked by doctest. For example, the " @@ -32205,12 +32465,12 @@ msgid "" msgstr "" # 255d7c7c666840b0ad85305c18e4c771 -#: ../src/Doc/library/doctest.rst:521 +#: library/doctest.rst:521 msgid "Option Flags" msgstr "" # b8b7f7299f6f4b95b09c93182e7a0a71 -#: ../src/Doc/library/doctest.rst:523 +#: library/doctest.rst:523 msgid "" "A number of option flags control various aspects of doctest's behavior. " "Symbolic names for the flags are supplied as module constants, which can be " @@ -32218,13 +32478,13 @@ msgid "" "in :ref:`doctest directives `." msgstr "" -#: ../src/Doc/library/doctest.rst:528 +#: library/doctest.rst:528 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 "" -#: ../src/Doc/library/doctest.rst:534 +#: library/doctest.rst:534 msgid "" "By default, if an expected output block contains just ``1``, an actual " "output block containing just ``1`` or just ``True`` is considered to be a " @@ -32236,7 +32496,7 @@ msgid "" "not for several years." msgstr "" -#: ../src/Doc/library/doctest.rst:545 +#: library/doctest.rst:545 msgid "" "By default, if an expected output block contains a line containing only the " "string ````, then that line will match a blank line in the actual " @@ -32245,7 +32505,7 @@ msgid "" "`DONT_ACCEPT_BLANKLINE` is specified, this substitution is not allowed." msgstr "" -#: ../src/Doc/library/doctest.rst:554 +#: library/doctest.rst:554 msgid "" "When specified, all sequences of whitespace (blanks and newlines) are " "treated as equal. Any sequence of whitespace within the expected output " @@ -32255,7 +32515,7 @@ msgid "" "across multiple lines in your source." msgstr "" -#: ../src/Doc/library/doctest.rst:564 +#: library/doctest.rst:564 msgid "" "When specified, an ellipsis marker (``...``) in the expected output can " "match any substring in the actual output. This includes substrings that " @@ -32264,7 +32524,7 @@ msgid "" "matched too much!\" surprises that ``.*`` is prone to in regular expressions." msgstr "" -#: ../src/Doc/library/doctest.rst:573 +#: library/doctest.rst:573 msgid "" "When specified, an example that expects an exception passes if an exception " "of the expected type is raised, even if the exception detail does not " @@ -32274,7 +32534,7 @@ msgid "" msgstr "" # daa820f533a449c8875800b32db8e1c3 -#: ../src/Doc/library/doctest.rst:579 +#: library/doctest.rst:579 msgid "" "It will also ignore the module name used in Python 3 doctest reports. Hence " "both of these variations will work with the flag specified, regardless of " @@ -32282,7 +32542,7 @@ msgid "" msgstr "" # 1ac2e8970fc44340a825b12065cd901a -#: ../src/Doc/library/doctest.rst:591 +#: library/doctest.rst:591 msgid "" "Note that :const:`ELLIPSIS` can also be used to ignore the details of the " "exception message, but such a test may still fail based on whether or not " @@ -32295,14 +32555,20 @@ msgid "" msgstr "" # e204b680e6a9431695c91a508b7b0bb9 -#: ../src/Doc/library/doctest.rst:605 +#: library/doctest.rst:605 msgid "" "passes under Python 2.3 and later Python versions with the flag specified, " "even though the detail changed in Python 2.4 to say \"does not\" instead of " "\"doesn't\"." msgstr "" -#: ../src/Doc/library/doctest.rst:616 +#: library/doctest.rst:609 +msgid "" +":const:`IGNORE_EXCEPTION_DETAIL` now also ignores any information relating " +"to the module containing the exception under test" +msgstr "" + +#: library/doctest.rst:616 msgid "" "When specified, do not run the example at all. This can be useful in " "contexts where doctest examples serve as both documentation and test cases, " @@ -32311,32 +32577,32 @@ msgid "" "might depend on resources which would be unavailable to the test driver." msgstr "" -#: ../src/Doc/library/doctest.rst:622 +#: library/doctest.rst:622 msgid "" "The SKIP flag can also be used for temporarily \"commenting out\" examples." msgstr "" -#: ../src/Doc/library/doctest.rst:629 +#: library/doctest.rst:629 msgid "A bitmask or'ing together all the comparison flags above." msgstr "" -#: ../src/Doc/library/doctest.rst:631 +#: library/doctest.rst:631 msgid "The second group of options controls how test failures are reported:" msgstr "" -#: ../src/Doc/library/doctest.rst:636 +#: library/doctest.rst:636 msgid "" "When specified, failures that involve multi-line expected and actual outputs " "are displayed using a unified diff." msgstr "" -#: ../src/Doc/library/doctest.rst:642 +#: library/doctest.rst:642 msgid "" "When specified, failures that involve multi-line expected and actual outputs " "will be displayed using a context diff." msgstr "" -#: ../src/Doc/library/doctest.rst:648 +#: library/doctest.rst:648 msgid "" "When specified, differences are computed by ``difflib.Differ``, using the " "same algorithm as the popular :file:`ndiff.py` utility. This is the only " @@ -32346,7 +32612,7 @@ msgid "" "mismatching column positions." msgstr "" -#: ../src/Doc/library/doctest.rst:657 +#: library/doctest.rst:657 msgid "" "When specified, display the first failing example in each doctest, but " "suppress output for all remaining examples. This will prevent doctest from " @@ -32357,17 +32623,26 @@ msgid "" "of failures reported; only the output is suppressed." msgstr "" -#: ../src/Doc/library/doctest.rst:668 +#: library/doctest.rst:668 msgid "A bitmask or'ing together all the reporting flags above." msgstr "" -#: ../src/Doc/library/doctest.rst:679 +#: library/doctest.rst:671 +msgid "" +"The constants :const:`DONT_ACCEPT_BLANKLINE`, :const:" +"`NORMALIZE_WHITESPACE`, :const:`ELLIPSIS`, :const:" +"`IGNORE_EXCEPTION_DETAIL`, :const:`REPORT_UDIFF`, :const:`REPORT_CDIFF`, :" +"const:`REPORT_NDIFF`, :const:`REPORT_ONLY_FIRST_FAILURE`, :const:" +"`COMPARISON_FLAGS` and :const:`REPORTING_FLAGS` were added." +msgstr "" + +#: library/doctest.rst:679 msgid "" "There's also a way to register new option flag names, although this isn't " "useful unless you intend to extend :mod:`doctest` internals via subclassing:" msgstr "" -#: ../src/Doc/library/doctest.rst:685 +#: library/doctest.rst:685 msgid "" "Create a new option flag with a given name, and return the new flag's " "integer value. :func:`register_optionflag` can be used when subclassing :" @@ -32377,36 +32652,36 @@ msgid "" msgstr "" # 4d739a6e201240d2ab761bffd6914410 -#: ../src/Doc/library/doctest.rst:699 +#: library/doctest.rst:699 msgid "Directives" msgstr "" # 5cfb32fa34cd42878da711c8489357b3 -#: ../src/Doc/library/doctest.rst:701 +#: library/doctest.rst:701 msgid "" "Doctest directives may be used to modify the :ref:`option flags ` for an individual example. Doctest directives are special Python " "comments following an example's source code:" msgstr "" -#: ../src/Doc/library/doctest.rst:712 +#: library/doctest.rst:712 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 "" -#: ../src/Doc/library/doctest.rst:716 +#: library/doctest.rst:716 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 "" -#: ../src/Doc/library/doctest.rst:719 +#: library/doctest.rst:719 msgid "For example, this test passes::" msgstr "" -#: ../src/Doc/library/doctest.rst:725 +#: library/doctest.rst:725 msgid "" "Without the directive it would fail, both because the actual output doesn't " "have two blanks before the single-digit list elements, and because the " @@ -32414,26 +32689,26 @@ msgid "" "a directive to do so::" msgstr "" -#: ../src/Doc/library/doctest.rst:733 +#: library/doctest.rst:733 msgid "" "Multiple directives can be used on a single physical line, separated by " "commas::" msgstr "" -#: ../src/Doc/library/doctest.rst:739 +#: library/doctest.rst:739 msgid "" "If multiple directive comments are used for a single example, then they are " "combined::" msgstr "" -#: ../src/Doc/library/doctest.rst:746 +#: library/doctest.rst:746 msgid "" "As the previous example shows, you can add ``...`` lines to your example " "containing only directives. This can be useful when an example is too long " "for a directive to comfortably fit on the same line::" msgstr "" -#: ../src/Doc/library/doctest.rst:754 +#: library/doctest.rst:754 msgid "" "Note that since all options are disabled by default, and directives apply " "only to the example they appear in, enabling options (via ``+`` in a " @@ -32443,11 +32718,15 @@ msgid "" "be useful." msgstr "" -#: ../src/Doc/library/doctest.rst:767 +#: library/doctest.rst:760 +msgid "Support for doctest directives was added." +msgstr "" + +#: library/doctest.rst:767 msgid "Warnings" msgstr "" -#: ../src/Doc/library/doctest.rst:769 +#: library/doctest.rst:769 msgid "" ":mod:`doctest` is serious about requiring exact matches in expected output. " "If even a single character doesn't match, the test fails. This will " @@ -32457,52 +32736,52 @@ msgid "" "order, so a test like ::" msgstr "" -#: ../src/Doc/library/doctest.rst:779 +#: library/doctest.rst:779 msgid "is vulnerable! One workaround is to do ::" msgstr "" -#: ../src/Doc/library/doctest.rst:784 +#: library/doctest.rst:784 msgid "instead. Another is to do ::" msgstr "" -#: ../src/Doc/library/doctest.rst:791 +#: library/doctest.rst:791 msgid "There are others, but you get the idea." msgstr "" -#: ../src/Doc/library/doctest.rst:793 +#: library/doctest.rst:793 msgid "" "Another bad idea is to print things that embed an object address, like ::" msgstr "" -#: ../src/Doc/library/doctest.rst:801 +#: library/doctest.rst:801 msgid "" "The :const:`ELLIPSIS` directive gives a nice approach for the last example::" msgstr "" -#: ../src/Doc/library/doctest.rst:806 +#: library/doctest.rst:806 msgid "" "Floating-point numbers are also subject to small output variations across " "platforms, because Python defers to the platform C library for float " "formatting, and C libraries vary widely in quality here. ::" msgstr "" -#: ../src/Doc/library/doctest.rst:817 +#: library/doctest.rst:817 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 "" -#: ../src/Doc/library/doctest.rst:823 +#: library/doctest.rst:823 msgid "" "Simple fractions are also easier for people to understand, and that makes " "for better documentation." msgstr "" -#: ../src/Doc/library/doctest.rst:830 +#: library/doctest.rst:830 msgid "Basic API" msgstr "" -#: ../src/Doc/library/doctest.rst:832 +#: library/doctest.rst:832 msgid "" "The functions :func:`testmod` and :func:`testfile` provide a simple " "interface to doctest that should be sufficient for most basic uses. For a " @@ -32510,25 +32789,25 @@ msgid "" "simple-testmod` and :ref:`doctest-simple-testfile`." msgstr "" -#: ../src/Doc/library/doctest.rst:840 +#: library/doctest.rst:840 msgid "" "All arguments except *filename* are optional, and should be specified in " "keyword form." msgstr "" -#: ../src/Doc/library/doctest.rst:843 +#: library/doctest.rst:843 msgid "" "Test examples in the file named *filename*. Return ``(failure_count, " "test_count)``." msgstr "" -#: ../src/Doc/library/doctest.rst:846 +#: library/doctest.rst:846 msgid "" "Optional argument *module_relative* specifies how the filename should be " "interpreted:" msgstr "" -#: ../src/Doc/library/doctest.rst:849 +#: library/doctest.rst:849 msgid "" "If *module_relative* is ``True`` (the default), then *filename* specifies an " "OS-independent module-relative path. By default, this path is relative to " @@ -32538,20 +32817,20 @@ msgid "" "absolute path (i.e., it may not begin with ``/``)." msgstr "" -#: ../src/Doc/library/doctest.rst:856 +#: library/doctest.rst:856 msgid "" "If *module_relative* is ``False``, then *filename* specifies an OS-specific " "path. The path may be absolute or relative; relative paths are resolved " "with respect to the current working directory." msgstr "" -#: ../src/Doc/library/doctest.rst:860 +#: library/doctest.rst:860 msgid "" "Optional argument *name* gives the name of the test; by default, or if " "``None``, ``os.path.basename(filename)`` is used." msgstr "" -#: ../src/Doc/library/doctest.rst:863 +#: library/doctest.rst:863 msgid "" "Optional argument *package* is a Python package or the name of a Python " "package whose directory should be used as the base directory for a module-" @@ -32560,7 +32839,7 @@ msgid "" "is an error to specify *package* if *module_relative* is ``False``." msgstr "" -#: ../src/Doc/library/doctest.rst:869 +#: library/doctest.rst:869 msgid "" "Optional argument *globs* gives a dict to be used as the globals when " "executing examples. A new shallow copy of this dict is created for the " @@ -32568,7 +32847,7 @@ msgid "" "``None``, a new empty dict is used." msgstr "" -#: ../src/Doc/library/doctest.rst:874 +#: library/doctest.rst:874 msgid "" "Optional argument *extraglobs* gives a dict merged into the globals used to " "execute examples. This works like :meth:`dict.update`: if *globs* and " @@ -32581,27 +32860,27 @@ msgid "" "tested." msgstr "" -#: ../src/Doc/library/doctest.rst:883 +#: library/doctest.rst:883 msgid "" "Optional argument *verbose* prints lots of stuff if true, and prints only " "failures if false; by default, or if ``None``, it's true if and only if ``'-" "v'`` is in ``sys.argv``." msgstr "" -#: ../src/Doc/library/doctest.rst:887 +#: library/doctest.rst:887 msgid "" "Optional argument *report* prints a summary at the end when true, else " "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 "" -#: ../src/Doc/library/doctest.rst:891 +#: library/doctest.rst:891 msgid "" "Optional argument *optionflags* or's together option flags. See section :" "ref:`doctest-options`." msgstr "" -#: ../src/Doc/library/doctest.rst:894 +#: library/doctest.rst:894 msgid "" "Optional argument *raise_on_error* defaults to false. If true, an exception " "is raised upon the first failure or unexpected exception in an example. " @@ -32609,33 +32888,37 @@ msgid "" "continue running examples." msgstr "" -#: ../src/Doc/library/doctest.rst:899 ../src/Doc/library/doctest.rst:1063 +#: library/doctest.rst:899 library/doctest.rst:1059 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 "" -#: ../src/Doc/library/doctest.rst:903 ../src/Doc/library/doctest.rst:1067 +#: library/doctest.rst:903 library/doctest.rst:1063 msgid "" "Optional argument *encoding* specifies an encoding that should be used to " "convert the file to unicode." msgstr "" -#: ../src/Doc/library/doctest.rst:914 +#: library/doctest.rst:908 library/doctest.rst:1072 +msgid "The parameter *encoding* was added." +msgstr "" + +#: library/doctest.rst:914 msgid "" "All arguments are optional, and all except for *m* should be specified in " "keyword form." msgstr "" -#: ../src/Doc/library/doctest.rst:917 +#: library/doctest.rst:917 msgid "" "Test examples in docstrings in functions and classes reachable from module " "*m* (or module :mod:`__main__` if *m* is not supplied or is ``None``), " "starting with ``m.__doc__``." msgstr "" -#: ../src/Doc/library/doctest.rst:921 +#: library/doctest.rst:921 msgid "" "Also test examples reachable from dict ``m.__test__``, if it exists and is " "not ``None``. ``m.__test__`` maps names (strings) to functions, classes and " @@ -32643,22 +32926,22 @@ msgid "" "are searched directly, as if they were docstrings." msgstr "" -#: ../src/Doc/library/doctest.rst:926 +#: library/doctest.rst:926 msgid "" "Only docstrings attached to objects belonging to module *m* are searched." msgstr "" -#: ../src/Doc/library/doctest.rst:928 +#: library/doctest.rst:928 msgid "Return ``(failure_count, test_count)``." msgstr "" -#: ../src/Doc/library/doctest.rst:930 +#: library/doctest.rst:930 msgid "" "Optional argument *name* gives the name of the module; by default, or if " "``None``, ``m.__name__`` is used." msgstr "" -#: ../src/Doc/library/doctest.rst:933 +#: library/doctest.rst:933 msgid "" "Optional argument *exclude_empty* defaults to false. If true, objects for " "which no doctests are found are excluded from consideration. The default is " @@ -32668,46 +32951,52 @@ msgid "" "class:`DocTestFinder` constructor defaults to true." msgstr "" -#: ../src/Doc/library/doctest.rst:940 +#: library/doctest.rst:940 msgid "" "Optional arguments *extraglobs*, *verbose*, *report*, *optionflags*, " "*raise_on_error*, and *globs* are the same as for function :func:`testfile` " "above, except that *globs* defaults to ``m.__dict__``." msgstr "" -#: ../src/Doc/library/doctest.rst:953 -msgid "" -"There's also a function to run the doctests associated with a single object. " -"This function is provided for backward compatibility. There are no plans to " -"deprecate it, but it's rarely useful:" +#: library/doctest.rst:944 +msgid "The parameter *optionflags* was added." msgstr "" -#: ../src/Doc/library/doctest.rst:960 +#: library/doctest.rst:947 msgid "" -"Test examples associated with object *f*; for example, *f* may be a module, " -"function, or class object." +"The parameters *extraglobs*, *raise_on_error* and *exclude_empty* were added." msgstr "" -#: ../src/Doc/library/doctest.rst:963 +#: library/doctest.rst:950 +msgid "The optional argument *isprivate*, deprecated in 2.4, was removed." +msgstr "" + +#: library/doctest.rst:956 +msgid "" +"Test examples associated with object *f*; for example, *f* may be a string, " +"a module, a function, or a class object." +msgstr "" + +#: library/doctest.rst:959 msgid "" "A shallow copy of dictionary argument *globs* is used for the execution " "context." msgstr "" -#: ../src/Doc/library/doctest.rst:965 +#: library/doctest.rst:961 msgid "" "Optional argument *name* is used in failure messages, and defaults to ``" "\"NoName\"``." msgstr "" -#: ../src/Doc/library/doctest.rst:968 +#: library/doctest.rst:964 msgid "" "If optional argument *verbose* is true, output is generated even if there " "are no failures. By default, output is generated only in case of an example " "failure." msgstr "" -#: ../src/Doc/library/doctest.rst:971 +#: library/doctest.rst:967 msgid "" "Optional argument *compileflags* gives the set of flags that should be used " "by the Python compiler when running the examples. By default, or if " @@ -32715,17 +33004,17 @@ msgid "" "found in *globs*." msgstr "" -#: ../src/Doc/library/doctest.rst:975 +#: library/doctest.rst:971 msgid "" "Optional argument *optionflags* works as for function :func:`testfile` above." msgstr "" -#: ../src/Doc/library/doctest.rst:981 +#: library/doctest.rst:977 msgid "Unittest API" msgstr "" # 417295cf59234f5e91f15dec05f8ec5e -#: ../src/Doc/library/doctest.rst:983 +#: library/doctest.rst:979 msgid "" "As your collection of doctest'ed modules grows, you'll want a way to run all " "their doctests systematically. Prior to Python 2.4, :mod:`doctest` had a " @@ -32740,19 +33029,19 @@ msgid "" "`load_tests` function in your test module::" msgstr "" -#: ../src/Doc/library/doctest.rst:1003 +#: library/doctest.rst:999 msgid "" "There are two main functions for creating :class:`unittest.TestSuite` " "instances from text files and modules with doctests:" msgstr "" -#: ../src/Doc/library/doctest.rst:1009 +#: library/doctest.rst:1005 msgid "" "Convert doctest tests from one or more text files to a :class:`unittest." "TestSuite`." msgstr "" -#: ../src/Doc/library/doctest.rst:1012 +#: library/doctest.rst:1008 msgid "" "The returned :class:`unittest.TestSuite` is to be run by the unittest " "framework and runs the interactive examples in each file. If an example in " @@ -32761,21 +33050,21 @@ msgid "" "containing the test and a (sometimes approximate) line number." msgstr "" -#: ../src/Doc/library/doctest.rst:1018 +#: library/doctest.rst:1014 msgid "Pass one or more paths (as strings) to text files to be examined." msgstr "" -#: ../src/Doc/library/doctest.rst:1020 +#: library/doctest.rst:1016 msgid "Options may be provided as keyword arguments:" msgstr "" -#: ../src/Doc/library/doctest.rst:1022 +#: library/doctest.rst:1018 msgid "" "Optional argument *module_relative* specifies how the filenames in *paths* " "should be interpreted:" msgstr "" -#: ../src/Doc/library/doctest.rst:1025 +#: library/doctest.rst:1021 msgid "" "If *module_relative* is ``True`` (the default), then each filename in " "*paths* specifies an OS-independent module-relative path. By default, this " @@ -32786,14 +33075,14 @@ msgid "" "``)." msgstr "" -#: ../src/Doc/library/doctest.rst:1033 +#: library/doctest.rst:1029 msgid "" "If *module_relative* is ``False``, then each filename in *paths* specifies " "an OS-specific path. The path may be absolute or relative; relative paths " "are resolved with respect to the current working directory." msgstr "" -#: ../src/Doc/library/doctest.rst:1037 +#: library/doctest.rst:1033 msgid "" "Optional argument *package* is a Python package or the name of a Python " "package whose directory should be used as the base directory for module-" @@ -32803,7 +33092,7 @@ msgid "" "``False``." msgstr "" -#: ../src/Doc/library/doctest.rst:1044 +#: library/doctest.rst:1040 msgid "" "Optional argument *setUp* specifies a set-up function for the test suite. " "This is called before running the tests in each file. The *setUp* function " @@ -32811,7 +33100,7 @@ msgid "" "test globals as the *globs* attribute of the test passed." msgstr "" -#: ../src/Doc/library/doctest.rst:1049 +#: library/doctest.rst:1045 msgid "" "Optional argument *tearDown* specifies a tear-down function for the test " "suite. This is called after running the tests in each file. The *tearDown* " @@ -32819,14 +33108,14 @@ msgid "" "access the test globals as the *globs* attribute of the test passed." msgstr "" -#: ../src/Doc/library/doctest.rst:1054 ../src/Doc/library/doctest.rst:1104 +#: library/doctest.rst:1050 library/doctest.rst:1100 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 "" -#: ../src/Doc/library/doctest.rst:1058 +#: library/doctest.rst:1054 msgid "" "Optional argument *optionflags* specifies the default doctest options for " "the tests, created by or-ing together individual option flags. See section :" @@ -32834,8 +33123,14 @@ msgid "" "for a better way to set reporting options." msgstr "" +#: library/doctest.rst:1068 +msgid "" +"The global ``__file__`` was added to the globals provided to doctests loaded " +"from a text file using :func:`DocFileSuite`." +msgstr "" + # a72be5ac054c4d0bba5fb3d3e114111a -#: ../src/Doc/library/doctest.rst:1080 +#: library/doctest.rst:1076 msgid "" "Unlike :func:`testmod` and :class:`DocTestFinder`, this function raises a :" "exc:`ValueError` if *module* contains no docstrings. You can prevent this " @@ -32843,11 +33138,11 @@ msgid "" "argument with its *exclude_empty* keyword argument set to ``False``::" msgstr "" -#: ../src/Doc/library/doctest.rst:1092 +#: library/doctest.rst:1088 msgid "Convert doctest tests for a module to a :class:`unittest.TestSuite`." msgstr "" -#: ../src/Doc/library/doctest.rst:1094 +#: library/doctest.rst:1090 msgid "" "The returned :class:`unittest.TestSuite` is to be run by the unittest " "framework and runs each doctest in the module. If any of the doctests fail, " @@ -32856,32 +33151,39 @@ msgid "" "(sometimes approximate) line number." msgstr "" -#: ../src/Doc/library/doctest.rst:1100 +#: library/doctest.rst:1096 msgid "" "Optional argument *module* provides the module to be tested. It can be a " "module object or a (possibly dotted) module name. If not specified, the " "module calling this function is used." msgstr "" -#: ../src/Doc/library/doctest.rst:1108 +#: library/doctest.rst:1104 msgid "" "Optional argument *extraglobs* specifies an extra set of global variables, " "which is merged into *globs*. By default, no extra globals are used." msgstr "" -#: ../src/Doc/library/doctest.rst:1111 +#: library/doctest.rst:1107 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 "" -#: ../src/Doc/library/doctest.rst:1114 +#: library/doctest.rst:1110 msgid "" "Optional arguments *setUp*, *tearDown*, and *optionflags* are the same as " "for function :func:`DocFileSuite` above." msgstr "" -#: ../src/Doc/library/doctest.rst:1124 +#: library/doctest.rst:1115 +msgid "" +"The parameters *globs*, *extraglobs*, *test_finder*, *setUp*, *tearDown*, " +"and *optionflags* were added; this function now uses the same search " +"technique as :func:`testmod`." +msgstr "" + +#: library/doctest.rst:1120 msgid "" "Under the covers, :func:`DocTestSuite` creates a :class:`unittest.TestSuite` " "out of :class:`doctest.DocTestCase` instances, and :class:`DocTestCase` is a " @@ -32890,14 +33192,14 @@ msgid "" "questions about the exact details of :mod:`unittest` integration." msgstr "" -#: ../src/Doc/library/doctest.rst:1130 +#: library/doctest.rst:1126 msgid "" "Similarly, :func:`DocFileSuite` creates a :class:`unittest.TestSuite` out " "of :class:`doctest.DocFileCase` instances, and :class:`DocFileCase` is a " "subclass of :class:`DocTestCase`." msgstr "" -#: ../src/Doc/library/doctest.rst:1134 +#: library/doctest.rst:1130 msgid "" "So both ways of creating a :class:`unittest.TestSuite` run instances of :" "class:`DocTestCase`. This is important for a subtle reason: when you run :" @@ -32910,23 +33212,23 @@ msgid "" "through :mod:`unittest` to :mod:`doctest` test runners." msgstr "" -#: ../src/Doc/library/doctest.rst:1144 +#: library/doctest.rst:1140 msgid "" "For this reason, :mod:`doctest` also supports a notion of :mod:`doctest` " "reporting flags specific to :mod:`unittest` support, via this function:" msgstr "" -#: ../src/Doc/library/doctest.rst:1150 +#: library/doctest.rst:1146 msgid "Set the :mod:`doctest` reporting flags to use." msgstr "" -#: ../src/Doc/library/doctest.rst:1152 +#: library/doctest.rst:1148 msgid "" "Argument *flags* or's together option flags. See section :ref:`doctest-" "options`. Only \"reporting flags\" can be used." msgstr "" -#: ../src/Doc/library/doctest.rst:1155 +#: library/doctest.rst:1151 msgid "" "This is a module-global setting, and affects all future doctests run by " "module :mod:`unittest`: the :meth:`runTest` method of :class:`DocTestCase` " @@ -32940,17 +33242,17 @@ msgid "" "reporting flags are ignored." msgstr "" -#: ../src/Doc/library/doctest.rst:1165 +#: library/doctest.rst:1161 msgid "" "The value of the :mod:`unittest` reporting flags in effect before the " "function was called is returned by the function." msgstr "" -#: ../src/Doc/library/doctest.rst:1174 +#: library/doctest.rst:1170 msgid "Advanced API" msgstr "" -#: ../src/Doc/library/doctest.rst:1176 +#: library/doctest.rst:1172 msgid "" "The basic API is a simple wrapper that's intended to make doctest easy to " "use. It is fairly flexible, and should meet most users' needs; however, if " @@ -32958,67 +33260,67 @@ msgid "" "doctest's capabilities, then you should use the advanced API." msgstr "" -#: ../src/Doc/library/doctest.rst:1181 +#: library/doctest.rst:1177 msgid "" "The advanced API revolves around two container classes, which are used to " "store the interactive examples extracted from doctest cases:" msgstr "" -#: ../src/Doc/library/doctest.rst:1184 +#: library/doctest.rst:1180 msgid "" ":class:`Example`: A single Python :term:`statement`, paired with its " "expected output." msgstr "" -#: ../src/Doc/library/doctest.rst:1187 +#: library/doctest.rst:1183 msgid "" ":class:`DocTest`: A collection of :class:`Example`\\ s, typically extracted " "from a single docstring or text file." msgstr "" -#: ../src/Doc/library/doctest.rst:1190 +#: library/doctest.rst:1186 msgid "" "Additional processing classes are defined to find, parse, and run, and check " "doctest examples:" msgstr "" -#: ../src/Doc/library/doctest.rst:1193 +#: library/doctest.rst:1189 msgid "" ":class:`DocTestFinder`: Finds all docstrings in a given module, and uses a :" "class:`DocTestParser` to create a :class:`DocTest` from every docstring that " "contains interactive examples." msgstr "" -#: ../src/Doc/library/doctest.rst:1197 +#: library/doctest.rst:1193 msgid "" ":class:`DocTestParser`: Creates a :class:`DocTest` object from a string " "(such as an object's docstring)." msgstr "" -#: ../src/Doc/library/doctest.rst:1200 +#: library/doctest.rst:1196 msgid "" ":class:`DocTestRunner`: Executes the examples in a :class:`DocTest`, and " "uses an :class:`OutputChecker` to verify their output." msgstr "" -#: ../src/Doc/library/doctest.rst:1203 +#: library/doctest.rst:1199 msgid "" ":class:`OutputChecker`: Compares the actual output from a doctest example " "with the expected output, and decides whether they match." msgstr "" -#: ../src/Doc/library/doctest.rst:1206 +#: library/doctest.rst:1202 msgid "" "The relationships among these processing classes are summarized in the " "following diagram::" msgstr "" -#: ../src/Doc/library/doctest.rst:1222 +#: library/doctest.rst:1218 msgid "DocTest Objects" msgstr "" # 4474c4d06d394014a4a835bcd22b827a -#: ../src/Doc/library/doctest.rst:1227 +#: library/doctest.rst:1223 msgid "" "A collection of doctest examples that should be run in a single namespace. " "The constructor arguments are used to initialize the attributes of the same " @@ -33026,19 +33328,19 @@ msgid "" msgstr "" # 3b84f97b1ca64aca831e81e27db8ab10 -#: ../src/Doc/library/doctest.rst:1232 +#: library/doctest.rst:1228 msgid "" ":class:`DocTest` defines the following attributes. They are initialized by " "the constructor, and should not be modified directly." msgstr "" -#: ../src/Doc/library/doctest.rst:1238 +#: library/doctest.rst:1234 msgid "" "A list of :class:`Example` objects encoding the individual interactive " "Python examples that should be run by this test." msgstr "" -#: ../src/Doc/library/doctest.rst:1244 +#: library/doctest.rst:1240 msgid "" "The namespace (aka globals) that the examples should be run in. This is a " "dictionary mapping names to values. Any changes to the namespace made by " @@ -33046,38 +33348,38 @@ msgid "" "`globs` after the test is run." msgstr "" -#: ../src/Doc/library/doctest.rst:1252 +#: library/doctest.rst:1248 msgid "" "A string name identifying the :class:`DocTest`. Typically, this is the name " "of the object or file that the test was extracted from." msgstr "" -#: ../src/Doc/library/doctest.rst:1258 +#: library/doctest.rst:1254 msgid "" "The name of the file that this :class:`DocTest` was extracted from; or " "``None`` if the filename is unknown, or if the :class:`DocTest` was not " "extracted from a file." msgstr "" -#: ../src/Doc/library/doctest.rst:1265 +#: library/doctest.rst:1261 msgid "" "The line number within :attr:`filename` where this :class:`DocTest` begins, " "or ``None`` if the line number is unavailable. This line number is zero-" "based with respect to the beginning of the file." msgstr "" -#: ../src/Doc/library/doctest.rst:1272 +#: library/doctest.rst:1268 msgid "" "The string that the test was extracted from, or 'None' if the string is " "unavailable, or if the test was not extracted from a string." msgstr "" -#: ../src/Doc/library/doctest.rst:1279 +#: library/doctest.rst:1275 msgid "Example Objects" msgstr "" # 47be47396206425c99142b2f214e9095 -#: ../src/Doc/library/doctest.rst:1284 +#: library/doctest.rst:1280 msgid "" "A single interactive example, consisting of a Python statement and its " "expected output. The constructor arguments are used to initialize the " @@ -33085,20 +33387,20 @@ msgid "" msgstr "" # 8a7aa09a5a364c759f4adc482762e10d -#: ../src/Doc/library/doctest.rst:1290 +#: library/doctest.rst:1286 msgid "" ":class:`Example` defines the following attributes. They are initialized by " "the constructor, and should not be modified directly." msgstr "" -#: ../src/Doc/library/doctest.rst:1296 +#: library/doctest.rst:1292 msgid "" "A string containing the example's source code. This source code consists of " "a single Python statement, and always ends with a newline; the constructor " "adds a newline when necessary." msgstr "" -#: ../src/Doc/library/doctest.rst:1303 +#: library/doctest.rst:1299 msgid "" "The expected output from running the example's source code (either from " "stdout, or a traceback in case of exception). :attr:`want` ends with a " @@ -33106,7 +33408,7 @@ msgid "" "The constructor adds a newline when necessary." msgstr "" -#: ../src/Doc/library/doctest.rst:1311 +#: library/doctest.rst:1307 msgid "" "The exception message generated by the example, if the example is expected " "to generate an exception; or ``None`` if it is not expected to generate an " @@ -33115,20 +33417,20 @@ msgid "" "unless it's ``None``. The constructor adds a newline if needed." msgstr "" -#: ../src/Doc/library/doctest.rst:1320 +#: library/doctest.rst:1316 msgid "" "The line number within the string containing this example where the example " "begins. This line number is zero-based with respect to the beginning of the " "containing string." msgstr "" -#: ../src/Doc/library/doctest.rst:1327 +#: library/doctest.rst:1323 msgid "" "The example's indentation in the containing string, i.e., the number of " "space characters that precede the example's first prompt." msgstr "" -#: ../src/Doc/library/doctest.rst:1333 +#: library/doctest.rst:1329 msgid "" "A dictionary mapping from option flags to ``True`` or ``False``, which is " "used to override default options for this example. Any option flags not " @@ -33137,11 +33439,11 @@ msgid "" "are set." msgstr "" -#: ../src/Doc/library/doctest.rst:1342 +#: library/doctest.rst:1338 msgid "DocTestFinder objects" msgstr "" -#: ../src/Doc/library/doctest.rst:1347 +#: library/doctest.rst:1343 msgid "" "A processing class used to extract the :class:`DocTest`\\ s that are " "relevant to a given object, from its docstring and the docstrings of its " @@ -33150,48 +33452,48 @@ msgid "" "classmethods, and properties." msgstr "" -#: ../src/Doc/library/doctest.rst:1353 +#: library/doctest.rst:1349 msgid "" "The optional argument *verbose* can be used to display the objects searched " "by the finder. It defaults to ``False`` (no output)." msgstr "" -#: ../src/Doc/library/doctest.rst:1356 +#: library/doctest.rst:1352 msgid "" "The optional argument *parser* specifies the :class:`DocTestParser` object " "(or a drop-in replacement) that is used to extract doctests from docstrings." msgstr "" -#: ../src/Doc/library/doctest.rst:1359 +#: library/doctest.rst:1355 msgid "" "If the optional argument *recurse* is false, then :meth:`DocTestFinder.find` " "will only examine the given object, and not any contained objects." msgstr "" -#: ../src/Doc/library/doctest.rst:1362 +#: library/doctest.rst:1358 msgid "" "If the optional argument *exclude_empty* is false, then :meth:`DocTestFinder." "find` will include tests for objects with empty docstrings." msgstr "" -#: ../src/Doc/library/doctest.rst:1367 +#: library/doctest.rst:1363 msgid ":class:`DocTestFinder` defines the following method:" msgstr "" -#: ../src/Doc/library/doctest.rst:1372 +#: library/doctest.rst:1368 msgid "" "Return a list of the :class:`DocTest`\\ s that are defined by *obj*'s " "docstring, or by any of its contained objects' docstrings." msgstr "" -#: ../src/Doc/library/doctest.rst:1375 +#: library/doctest.rst:1371 msgid "" "The optional argument *name* specifies the object's name; this name will be " "used to construct names for the returned :class:`DocTest`\\ s. If *name* is " "not specified, then ``obj.__name__`` is used." msgstr "" -#: ../src/Doc/library/doctest.rst:1379 +#: library/doctest.rst:1375 msgid "" "The optional parameter *module* is the module that contains the given " "object. If the module is not specified or is None, then the test finder will " @@ -33199,26 +33501,26 @@ msgid "" "is used:" msgstr "" -#: ../src/Doc/library/doctest.rst:1383 +#: library/doctest.rst:1379 msgid "As a default namespace, if *globs* is not specified." msgstr "" -#: ../src/Doc/library/doctest.rst:1385 +#: library/doctest.rst:1381 msgid "" "To prevent the DocTestFinder from extracting DocTests from objects that are " "imported from other modules. (Contained objects with modules other than " "*module* are ignored.)" msgstr "" -#: ../src/Doc/library/doctest.rst:1389 +#: library/doctest.rst:1385 msgid "To find the name of the file containing the object." msgstr "" -#: ../src/Doc/library/doctest.rst:1391 +#: library/doctest.rst:1387 msgid "To help find the line number of the object within its file." msgstr "" -#: ../src/Doc/library/doctest.rst:1393 +#: library/doctest.rst:1389 msgid "" "If *module* is ``False``, no attempt to find the module will be made. This " "is obscure, of use mostly in testing doctest itself: if *module* is " @@ -33227,7 +33529,7 @@ msgid "" "contained objects will (recursively) be searched for doctests." msgstr "" -#: ../src/Doc/library/doctest.rst:1399 +#: library/doctest.rst:1395 msgid "" "The globals for each :class:`DocTest` is formed by combining *globs* and " "*extraglobs* (bindings in *extraglobs* override bindings in *globs*). A new " @@ -33237,34 +33539,34 @@ msgid "" "defaults to ``{}``." msgstr "" -#: ../src/Doc/library/doctest.rst:1410 +#: library/doctest.rst:1406 msgid "DocTestParser objects" msgstr "" -#: ../src/Doc/library/doctest.rst:1415 +#: library/doctest.rst:1411 msgid "" "A processing class used to extract interactive examples from a string, and " "use them to create a :class:`DocTest` object." msgstr "" -#: ../src/Doc/library/doctest.rst:1420 ../src/Doc/library/doctest.rst:1489 +#: library/doctest.rst:1416 library/doctest.rst:1485 msgid ":class:`DocTestParser` defines the following methods:" msgstr "" -#: ../src/Doc/library/doctest.rst:1425 +#: library/doctest.rst:1421 msgid "" "Extract all doctest examples from the given string, and collect them into a :" "class:`DocTest` object." msgstr "" -#: ../src/Doc/library/doctest.rst:1428 +#: library/doctest.rst:1424 msgid "" "*globs*, *name*, *filename*, and *lineno* are attributes for the new :class:" "`DocTest` object. See the documentation for :class:`DocTest` for more " "information." msgstr "" -#: ../src/Doc/library/doctest.rst:1435 +#: library/doctest.rst:1431 msgid "" "Extract all doctest examples from the given string, and return them as a " "list of :class:`Example` objects. Line numbers are 0-based. The optional " @@ -33272,7 +33574,7 @@ msgid "" "error messages." msgstr "" -#: ../src/Doc/library/doctest.rst:1442 +#: library/doctest.rst:1438 msgid "" "Divide the given string into examples and intervening text, and return them " "as a list of alternating :class:`Example`\\ s and strings. Line numbers for " @@ -33280,17 +33582,17 @@ msgid "" "name identifying this string, and is only used for error messages." msgstr "" -#: ../src/Doc/library/doctest.rst:1451 +#: library/doctest.rst:1447 msgid "DocTestRunner objects" msgstr "" -#: ../src/Doc/library/doctest.rst:1456 +#: library/doctest.rst:1452 msgid "" "A processing class used to execute and verify the interactive examples in a :" "class:`DocTest`." msgstr "" -#: ../src/Doc/library/doctest.rst:1459 +#: library/doctest.rst:1455 msgid "" "The comparison between expected outputs and actual outputs is done by an :" "class:`OutputChecker`. This comparison may be customized with a number of " @@ -33300,7 +33602,7 @@ msgid "" "constructor." msgstr "" -#: ../src/Doc/library/doctest.rst:1465 +#: library/doctest.rst:1461 msgid "" "The test runner's display output can be controlled in two ways. First, an " "output function can be passed to :meth:`TestRunner.run`; this function will " @@ -33311,7 +33613,7 @@ msgid "" "`report_unexpected_exception`, and :meth:`report_failure`." msgstr "" -#: ../src/Doc/library/doctest.rst:1473 +#: library/doctest.rst:1469 msgid "" "The optional keyword argument *checker* specifies the :class:`OutputChecker` " "object (or drop-in replacement) that should be used to compare the expected " @@ -33319,7 +33621,7 @@ msgid "" msgstr "" # 99ba7031a47d4a3fbfd78fa12c39402e -#: ../src/Doc/library/doctest.rst:1477 +#: library/doctest.rst:1473 msgid "" "The optional keyword argument *verbose* controls the :class:" "`DocTestRunner`'s verbosity. If *verbose* is ``True``, then information is " @@ -33328,56 +33630,56 @@ msgid "" "verbose output is used iff the command-line switch ``-v`` is used." msgstr "" -#: ../src/Doc/library/doctest.rst:1483 +#: library/doctest.rst:1479 msgid "" "The optional keyword argument *optionflags* can be used to control how the " "test runner compares expected output to actual output, and how it displays " "failures. For more information, see section :ref:`doctest-options`." msgstr "" -#: ../src/Doc/library/doctest.rst:1494 +#: library/doctest.rst:1490 msgid "" "Report that the test runner is about to process the given example. This " "method is provided to allow subclasses of :class:`DocTestRunner` to " "customize their output; it should not be called directly." msgstr "" -#: ../src/Doc/library/doctest.rst:1498 +#: library/doctest.rst:1494 msgid "" "*example* is the example about to be processed. *test* is the test " "*containing example*. *out* is the output function that was passed to :meth:" "`DocTestRunner.run`." msgstr "" -#: ../src/Doc/library/doctest.rst:1505 +#: library/doctest.rst:1501 msgid "" "Report that the given example ran successfully. This method is provided to " "allow subclasses of :class:`DocTestRunner` to customize their output; it " "should not be called directly." msgstr "" -#: ../src/Doc/library/doctest.rst:1509 ../src/Doc/library/doctest.rst:1520 +#: library/doctest.rst:1505 library/doctest.rst:1516 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 " "output function that was passed to :meth:`DocTestRunner.run`." msgstr "" -#: ../src/Doc/library/doctest.rst:1516 +#: library/doctest.rst:1512 msgid "" "Report that the given example failed. This method is provided to allow " "subclasses of :class:`DocTestRunner` to customize their output; it should " "not be called directly." msgstr "" -#: ../src/Doc/library/doctest.rst:1527 +#: library/doctest.rst:1523 msgid "" "Report that the given example raised an unexpected exception. This method is " "provided to allow subclasses of :class:`DocTestRunner` to customize their " "output; it should not be called directly." msgstr "" -#: ../src/Doc/library/doctest.rst:1531 +#: library/doctest.rst:1527 msgid "" "*example* is the example about to be processed. *exc_info* is a tuple " "containing information about the unexpected exception (as returned by :func:" @@ -33385,13 +33687,13 @@ msgid "" "output function that was passed to :meth:`DocTestRunner.run`." msgstr "" -#: ../src/Doc/library/doctest.rst:1539 +#: library/doctest.rst:1535 msgid "" "Run the examples in *test* (a :class:`DocTest` object), and display the " "results using the writer function *out*." msgstr "" -#: ../src/Doc/library/doctest.rst:1542 +#: library/doctest.rst:1538 msgid "" "The examples are run in the namespace ``test.globs``. If *clear_globs* is " "true (the default), then this namespace will be cleared after the test runs, " @@ -33399,39 +33701,39 @@ msgid "" "after the test completes, then use *clear_globs=False*." msgstr "" -#: ../src/Doc/library/doctest.rst:1547 +#: library/doctest.rst:1543 msgid "" "*compileflags* gives the set of flags that should be used by the Python " "compiler when running the examples. If not specified, then it will default " "to the set of future-import flags that apply to *globs*." msgstr "" -#: ../src/Doc/library/doctest.rst:1551 +#: library/doctest.rst:1547 msgid "" "The output of each example is checked using the :class:`DocTestRunner`'s " "output checker, and the results are formatted by the :meth:`DocTestRunner." "report_\\*` methods." msgstr "" -#: ../src/Doc/library/doctest.rst:1558 +#: library/doctest.rst:1554 msgid "" "Print a summary of all the test cases that have been run by this " "DocTestRunner, and return a :term:`named tuple` ``TestResults(failed, " "attempted)``." msgstr "" -#: ../src/Doc/library/doctest.rst:1561 +#: library/doctest.rst:1557 msgid "" "The optional *verbose* argument controls how detailed the summary is. If " "the verbosity is not specified, then the :class:`DocTestRunner`'s verbosity " "is used." msgstr "" -#: ../src/Doc/library/doctest.rst:1572 +#: library/doctest.rst:1568 msgid "OutputChecker objects" msgstr "" -#: ../src/Doc/library/doctest.rst:1577 +#: library/doctest.rst:1573 msgid "" "A class used to check the whether the actual output from a doctest example " "matches the expected output. :class:`OutputChecker` defines two methods: :" @@ -33440,11 +33742,11 @@ msgid "" "describing the differences between two outputs." msgstr "" -#: ../src/Doc/library/doctest.rst:1585 +#: library/doctest.rst:1581 msgid ":class:`OutputChecker` defines the following methods:" msgstr "" -#: ../src/Doc/library/doctest.rst:1590 +#: library/doctest.rst:1586 msgid "" "Return ``True`` iff the actual output from an example (*got*) matches the " "expected output (*want*). These strings are always considered to match if " @@ -33453,28 +33755,28 @@ msgid "" "`doctest-options` for more information about option flags." msgstr "" -#: ../src/Doc/library/doctest.rst:1599 +#: library/doctest.rst:1595 msgid "" "Return a string describing the differences between the expected output for a " "given example (*example*) and the actual output (*got*). *optionflags* is " "the set of option flags used to compare *want* and *got*." msgstr "" -#: ../src/Doc/library/doctest.rst:1607 +#: library/doctest.rst:1603 msgid "Debugging" msgstr "" -#: ../src/Doc/library/doctest.rst:1609 +#: library/doctest.rst:1605 msgid "Doctest provides several mechanisms for debugging doctest examples:" msgstr "" -#: ../src/Doc/library/doctest.rst:1611 +#: library/doctest.rst:1607 msgid "" "Several functions convert doctests to executable Python programs, which can " "be run under the Python debugger, :mod:`pdb`." msgstr "" -#: ../src/Doc/library/doctest.rst:1614 +#: library/doctest.rst:1610 msgid "" "The :class:`DebugRunner` class is a subclass of :class:`DocTestRunner` that " "raises an exception for the first failing example, containing information " @@ -33482,13 +33784,13 @@ msgid "" "debugging on the example." msgstr "" -#: ../src/Doc/library/doctest.rst:1619 +#: library/doctest.rst:1615 msgid "" "The :mod:`unittest` cases generated by :func:`DocTestSuite` support the :" "meth:`debug` method defined by :class:`unittest.TestCase`." msgstr "" -#: ../src/Doc/library/doctest.rst:1622 +#: library/doctest.rst:1618 msgid "" "You can add a call to :func:`pdb.set_trace` in a doctest example, and you'll " "drop into the Python debugger when that line is executed. Then you can " @@ -33496,21 +33798,26 @@ msgid "" "`a.py` contains just this module docstring::" msgstr "" -#: ../src/Doc/library/doctest.rst:1637 +#: library/doctest.rst:1633 msgid "Then an interactive Python session may look like this::" msgstr "" -#: ../src/Doc/library/doctest.rst:1672 +#: library/doctest.rst:1665 +msgid "" +"The ability to use :func:`pdb.set_trace` usefully inside doctests was added." +msgstr "" + +#: library/doctest.rst:1668 msgid "" "Functions that convert doctests to Python code, and possibly run the " "synthesized code under the debugger:" msgstr "" -#: ../src/Doc/library/doctest.rst:1678 +#: library/doctest.rst:1674 msgid "Convert text with examples to a script." msgstr "" -#: ../src/Doc/library/doctest.rst:1680 +#: library/doctest.rst:1676 msgid "" "Argument *s* is a string containing doctest examples. The string is " "converted to a Python script, where doctest examples in *s* are converted to " @@ -33518,22 +33825,22 @@ msgid "" "generated script is returned as a string. For example, ::" msgstr "" -#: ../src/Doc/library/doctest.rst:1695 +#: library/doctest.rst:1691 msgid "displays::" msgstr "" -#: ../src/Doc/library/doctest.rst:1705 +#: library/doctest.rst:1701 msgid "" "This function is used internally by other functions (see below), but can " "also be useful when you want to transform an interactive Python session into " "a Python script." msgstr "" -#: ../src/Doc/library/doctest.rst:1714 +#: library/doctest.rst:1710 msgid "Convert the doctest for an object to a script." msgstr "" -#: ../src/Doc/library/doctest.rst:1716 +#: library/doctest.rst:1712 msgid "" "Argument *module* is a module object, or dotted name of a module, containing " "the object whose doctests are of interest. Argument *name* is the name " @@ -33543,17 +33850,17 @@ msgid "" "module :file:`a.py` contains a top-level function :func:`f`, then ::" msgstr "" -#: ../src/Doc/library/doctest.rst:1726 +#: library/doctest.rst:1722 msgid "" "prints a script version of function :func:`f`'s docstring, with doctests " "converted to code, and the rest placed in comments." msgstr "" -#: ../src/Doc/library/doctest.rst:1734 +#: library/doctest.rst:1730 msgid "Debug the doctests for an object." msgstr "" -#: ../src/Doc/library/doctest.rst:1736 +#: library/doctest.rst:1732 msgid "" "The *module* and *name* arguments are the same as for function :func:" "`testsource` above. The synthesized Python script for the named object's " @@ -33561,14 +33868,14 @@ msgid "" "the control of the Python debugger, :mod:`pdb`." msgstr "" -#: ../src/Doc/library/doctest.rst:1741 +#: library/doctest.rst:1737 msgid "" "A shallow copy of ``module.__dict__`` is used for both local and global " "execution context." msgstr "" # 529a7df71a3e4733a5ac7bd2eab0efea -#: ../src/Doc/library/doctest.rst:1744 +#: library/doctest.rst:1740 msgid "" "Optional argument *pm* controls whether post-mortem debugging is used. If " "*pm* has a true value, the script file is run directly, and the debugger " @@ -33580,30 +33887,34 @@ msgid "" "call to :func:`pdb.run`." msgstr "" -#: ../src/Doc/library/doctest.rst:1760 +#: library/doctest.rst:1750 +msgid "The *pm* argument was added." +msgstr "" + +#: library/doctest.rst:1756 msgid "Debug the doctests in a string." msgstr "" -#: ../src/Doc/library/doctest.rst:1762 +#: library/doctest.rst:1758 msgid "" "This is like function :func:`debug` above, except that a string containing " "doctest examples is specified directly, via the *src* argument." msgstr "" -#: ../src/Doc/library/doctest.rst:1765 +#: library/doctest.rst:1761 msgid "" "Optional argument *pm* has the same meaning as in function :func:`debug` " "above." msgstr "" -#: ../src/Doc/library/doctest.rst:1767 +#: library/doctest.rst:1763 msgid "" "Optional argument *globs* gives a dictionary to use as both local and global " "execution context. If not specified, or ``None``, an empty dictionary is " "used. If specified, a shallow copy of the dictionary is used." msgstr "" -#: ../src/Doc/library/doctest.rst:1773 +#: library/doctest.rst:1769 msgid "" "The :class:`DebugRunner` class, and the special exceptions it may raise, are " "of most interest to testing framework authors, and will only be sketched " @@ -33611,7 +33922,7 @@ msgid "" "(which is a doctest!) for more details:" msgstr "" -#: ../src/Doc/library/doctest.rst:1781 +#: library/doctest.rst:1777 msgid "" "A subclass of :class:`DocTestRunner` that raises an exception as soon as a " "failure is encountered. If an unexpected exception occurs, an :exc:" @@ -33621,21 +33932,21 @@ msgid "" "the actual output." msgstr "" -#: ../src/Doc/library/doctest.rst:1788 +#: library/doctest.rst:1784 msgid "" "For information about the constructor parameters and methods, see the " "documentation for :class:`DocTestRunner` in section :ref:`doctest-advanced-" "api`." msgstr "" -#: ../src/Doc/library/doctest.rst:1791 +#: library/doctest.rst:1787 msgid "" "There are two exceptions that may be raised by :class:`DebugRunner` " "instances:" msgstr "" # 4d23622fa9984fffa1534f46c29cc1ad -#: ../src/Doc/library/doctest.rst:1796 +#: library/doctest.rst:1792 msgid "" "An exception raised by :class:`DocTestRunner` to signal that a doctest " "example's actual output did not match its expected output. The constructor " @@ -33643,24 +33954,24 @@ msgid "" msgstr "" # 672f9bc06bd2444dae0558e953bba8d1 -#: ../src/Doc/library/doctest.rst:1800 +#: library/doctest.rst:1796 msgid ":exc:`DocTestFailure` defines the following attributes:" msgstr "" -#: ../src/Doc/library/doctest.rst:1805 ../src/Doc/library/doctest.rst:1829 +#: library/doctest.rst:1801 library/doctest.rst:1825 msgid "The :class:`DocTest` object that was being run when the example failed." msgstr "" -#: ../src/Doc/library/doctest.rst:1810 ../src/Doc/library/doctest.rst:1834 +#: library/doctest.rst:1806 library/doctest.rst:1830 msgid "The :class:`Example` that failed." msgstr "" -#: ../src/Doc/library/doctest.rst:1815 +#: library/doctest.rst:1811 msgid "The example's actual output." msgstr "" # b73baa146a79449587ca1db1dbeacc13 -#: ../src/Doc/library/doctest.rst:1820 +#: library/doctest.rst:1816 msgid "" "An exception raised by :class:`DocTestRunner` to signal that a doctest " "example raised an unexpected exception. The constructor arguments are used " @@ -33668,46 +33979,46 @@ msgid "" msgstr "" # 4a7bce7d856347d2af32ebfeba90aed1 -#: ../src/Doc/library/doctest.rst:1824 +#: library/doctest.rst:1820 msgid ":exc:`UnexpectedException` defines the following attributes:" msgstr "" -#: ../src/Doc/library/doctest.rst:1839 +#: library/doctest.rst:1835 msgid "" "A tuple containing information about the unexpected exception, as returned " "by :func:`sys.exc_info`." msgstr "" -#: ../src/Doc/library/doctest.rst:1846 +#: library/doctest.rst:1842 msgid "Soapbox" msgstr "" -#: ../src/Doc/library/doctest.rst:1848 +#: library/doctest.rst:1844 msgid "" "As mentioned in the introduction, :mod:`doctest` has grown to have three " "primary uses:" msgstr "" -#: ../src/Doc/library/doctest.rst:1851 +#: library/doctest.rst:1847 msgid "Checking examples in docstrings." msgstr "" -#: ../src/Doc/library/doctest.rst:1853 +#: library/doctest.rst:1849 msgid "Regression testing." msgstr "" -#: ../src/Doc/library/doctest.rst:1855 +#: library/doctest.rst:1851 msgid "Executable documentation / literate testing." msgstr "" -#: ../src/Doc/library/doctest.rst:1857 +#: library/doctest.rst:1853 msgid "" "These uses have different requirements, and it is important to distinguish " "them. In particular, filling your docstrings with obscure test cases makes " "for bad documentation." msgstr "" -#: ../src/Doc/library/doctest.rst:1861 +#: library/doctest.rst:1857 msgid "" "When writing a docstring, choose docstring examples with care. There's an " "art to this that needs to be learned---it may not be natural at first. " @@ -33719,7 +34030,7 @@ msgid "" "\"harmless\" change." msgstr "" -#: ../src/Doc/library/doctest.rst:1869 +#: library/doctest.rst:1865 msgid "" "Doctest also makes an excellent tool for regression testing, especially if " "you don't skimp on explanatory text. By interleaving prose and examples, it " @@ -33740,13 +34051,13 @@ msgid "" "different results, blurring the distinction between testing and explaining." msgstr "" -#: ../src/Doc/library/doctest.rst:1887 +#: library/doctest.rst:1883 msgid "" "Regression testing is best confined to dedicated objects or files. There " "are several options for organizing tests:" msgstr "" -#: ../src/Doc/library/doctest.rst:1890 +#: library/doctest.rst:1886 msgid "" "Write text files containing test cases as interactive examples, and test the " "files using :func:`testfile` or :func:`DocFileSuite`. This is recommended, " @@ -33754,7 +34065,7 @@ msgid "" "doctest." msgstr "" -#: ../src/Doc/library/doctest.rst:1895 +#: library/doctest.rst:1891 msgid "" "Define functions named ``_regrtest_topic`` that consist of single " "docstrings, containing test cases for the named topics. These functions can " @@ -33762,13 +34073,21 @@ msgid "" "test file." msgstr "" -#: ../src/Doc/library/doctest.rst:1899 +#: library/doctest.rst:1895 msgid "" "Define a ``__test__`` dictionary mapping from regression test topics to " "docstrings containing test cases." msgstr "" -#: ../src/Doc/library/doctest.rst:1904 +#: library/doctest.rst:1898 +msgid "" +"When you have placed your tests in a module, the module can itself be the " +"test runner. When a test fails, you can arrange for your test runner to re-" +"run only the failing doctest while you debug the problem. Here is a minimal " +"example of such a test runner::" +msgstr "" + +#: library/doctest.rst:1921 msgid "" "Examples containing both expected output and an exception are not supported. " "Trying to guess where one ends and the other begins is too error-prone, and " @@ -33776,12 +34095,12 @@ msgid "" msgstr "" # c1293b7cee594aedb8ccdc780858773a -#: ../src/Doc/library/docxmlrpcserver.rst:2 +#: library/docxmlrpcserver.rst:2 msgid ":mod:`DocXMLRPCServer` --- Self-documenting XML-RPC server" msgstr "" # 9a8594fa51e9469fb3ce3e60fda657af -#: ../src/Doc/library/docxmlrpcserver.rst:10 +#: library/docxmlrpcserver.rst:10 msgid "" "The :mod:`DocXMLRPCServer` module has been merged into :mod:`xmlrpc.server` " "in Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -33789,7 +34108,7 @@ msgid "" msgstr "" # 13bb41603ef0482682f5f408ccdfeb8e -#: ../src/Doc/library/docxmlrpcserver.rst:17 +#: library/docxmlrpcserver.rst:17 msgid "" "The :mod:`DocXMLRPCServer` module extends the classes found in :mod:" "`SimpleXMLRPCServer` to serve HTML documentation in response to HTTP GET " @@ -33799,18 +34118,18 @@ msgid "" msgstr "" # 68f63a91013c43008a3733657309519e -#: ../src/Doc/library/docxmlrpcserver.rst:25 +#: library/docxmlrpcserver.rst:25 msgid "" "Create a new server instance. All parameters have the same meaning as for :" "class:`SimpleXMLRPCServer.SimpleXMLRPCServer`; *requestHandler* defaults to :" "class:`DocXMLRPCRequestHandler`." msgstr "" -#: ../src/Doc/library/docxmlrpcserver.rst:32 +#: library/docxmlrpcserver.rst:32 msgid "Create a new instance to handle XML-RPC requests in a CGI environment." msgstr "" -#: ../src/Doc/library/docxmlrpcserver.rst:37 +#: library/docxmlrpcserver.rst:37 msgid "" "Create a new request handler instance. This request handler supports XML-RPC " "POST requests, documentation GET requests, and modifies logging so that the " @@ -33818,12 +34137,12 @@ msgid "" "parameter is honored." msgstr "" -#: ../src/Doc/library/docxmlrpcserver.rst:46 +#: library/docxmlrpcserver.rst:46 msgid "DocXMLRPCServer Objects" msgstr "" # fa8219b331884fa18cfcf5ac69563b95 -#: ../src/Doc/library/docxmlrpcserver.rst:48 +#: library/docxmlrpcserver.rst:48 msgid "" "The :class:`DocXMLRPCServer` class is derived from :class:" "`SimpleXMLRPCServer.SimpleXMLRPCServer` and provides a means of creating " @@ -33833,34 +34152,31 @@ msgid "" "based documentation." msgstr "" -#: ../src/Doc/library/docxmlrpcserver.rst:58 -#: ../src/Doc/library/docxmlrpcserver.rst:87 +#: library/docxmlrpcserver.rst:58 library/docxmlrpcserver.rst:87 msgid "" "Set the title used in the generated HTML documentation. This title will be " "used inside the HTML \"title\" element." msgstr "" -#: ../src/Doc/library/docxmlrpcserver.rst:64 -#: ../src/Doc/library/docxmlrpcserver.rst:93 +#: library/docxmlrpcserver.rst:64 library/docxmlrpcserver.rst:93 msgid "" "Set the name used in the generated HTML documentation. This name will appear " "at the top of the generated documentation inside a \"h1\" element." msgstr "" -#: ../src/Doc/library/docxmlrpcserver.rst:70 -#: ../src/Doc/library/docxmlrpcserver.rst:99 +#: library/docxmlrpcserver.rst:70 library/docxmlrpcserver.rst:99 msgid "" "Set the description used in the generated HTML documentation. This " "description will appear as a paragraph, below the server name, in the " "documentation." msgstr "" -#: ../src/Doc/library/docxmlrpcserver.rst:75 +#: library/docxmlrpcserver.rst:75 msgid "DocCGIXMLRPCRequestHandler" msgstr "" # e09294e0587647898b81b771d9ab539f -#: ../src/Doc/library/docxmlrpcserver.rst:77 +#: library/docxmlrpcserver.rst:77 msgid "" "The :class:`DocCGIXMLRPCRequestHandler` class is derived from :class:" "`SimpleXMLRPCServer.CGIXMLRPCRequestHandler` and provides a means of " @@ -33871,12 +34187,12 @@ msgid "" msgstr "" # fa0e89e70d0248b4812ae876a209b938 -#: ../src/Doc/library/dumbdbm.rst:2 +#: library/dumbdbm.rst:2 msgid ":mod:`dumbdbm` --- Portable DBM implementation" msgstr "" # 2e3cc4d4fd394d6f8c9e335ca2038a5b -#: ../src/Doc/library/dumbdbm.rst:8 +#: library/dumbdbm.rst:8 msgid "" "The :mod:`dumbdbm` module has been renamed to :mod:`dbm.dumb` in Python 3. " "The :term:`2to3` tool will automatically adapt imports when converting your " @@ -33884,7 +34200,7 @@ msgid "" msgstr "" # 767f0d6219d849b39098f2ecf3c64697 -#: ../src/Doc/library/dumbdbm.rst:16 +#: library/dumbdbm.rst:16 msgid "" "The :mod:`dumbdbm` module is intended as a last resort fallback for the :mod:" "`anydbm` module when no more robust module is available. The :mod:`dumbdbm` " @@ -33893,7 +34209,7 @@ msgid "" msgstr "" # 6809798edda34de7a971716bf851d08c -#: ../src/Doc/library/dumbdbm.rst:21 +#: library/dumbdbm.rst:21 msgid "" "The :mod:`dumbdbm` module provides a persistent dictionary-like interface " "which is written entirely in Python. Unlike other modules such as :mod:" @@ -33902,14 +34218,14 @@ msgid "" msgstr "" # db70cb7be2cd4b439432514e63dd5759 -#: ../src/Doc/library/dumbdbm.rst:31 +#: library/dumbdbm.rst:31 msgid "" "Raised on dumbdbm-specific errors, such as I/O errors. :exc:`KeyError` is " "raised for general mapping errors like specifying an incorrect key." msgstr "" # 876bc501decc49f3b0f630700119f385 -#: ../src/Doc/library/dumbdbm.rst:37 +#: library/dumbdbm.rst:37 msgid "" "Open a dumbdbm database and return a dumbdbm object. The *filename* " "argument is the basename of the database file (without any specific " @@ -33917,60 +34233,64 @@ msgid "" "and :file:`.dir` extensions are created." msgstr "" -#: ../src/Doc/library/dumbdbm.rst:42 +#: library/dumbdbm.rst:42 msgid "" "The optional *flag* argument is currently ignored; the database is always " "opened for update, and will be created if it does not exist." msgstr "" +#: library/dumbdbm.rst:49 +msgid "The *mode* argument was ignored in earlier versions." +msgstr "" + # e97ddcf94bc04f05ac8bd07284ba8c3e -#: ../src/Doc/library/dumbdbm.rst:52 +#: library/dumbdbm.rst:52 msgid "" "In addition to the dictionary-like methods, ``dumbdm`` objects provide the " "following method:" msgstr "" # 3c0e70fb289a4db2bdc6abd31c21f36e -#: ../src/Doc/library/dumbdbm.rst:58 +#: library/dumbdbm.rst:58 msgid "Close the ``dumbdm`` database." msgstr "" # be09bed998da4d0a862dc289306536f8 -#: ../src/Doc/library/dumbdbm.rst:67 +#: library/dumbdbm.rst:67 msgid "Similar interface to the DBM/NDBM library." msgstr "" -#: ../src/Doc/library/dumbdbm.rst:73 +#: library/dumbdbm.rst:73 msgid "Persistence module which stores non-string data." msgstr "" # 241f06323e3248e2825111c9f823c1c2 -#: ../src/Doc/library/dumbdbm.rst:82 +#: library/dumbdbm.rst:82 msgid "Dumbdbm Objects" msgstr "" # e97ddcf94bc04f05ac8bd07284ba8c3e -#: ../src/Doc/library/dumbdbm.rst:84 +#: library/dumbdbm.rst:84 msgid "" "In addition to the methods provided by the :class:`UserDict.DictMixin` " "class, :class:`dumbdbm` objects provide the following methods." msgstr "" # 3ee1570fe27442aebc8e303bf581e830 -#: ../src/Doc/library/dumbdbm.rst:90 +#: library/dumbdbm.rst:90 msgid "" "Synchronize the on-disk directory and data files. This method is called by " "the :meth:`sync` method of :class:`Shelve` objects." msgstr "" # 7d66c20fa33d4b0eb70e8c20b4024b6b -#: ../src/Doc/library/dummy_thread.rst:2 +#: library/dummy_thread.rst:2 msgid "" ":mod:`dummy_thread` --- Drop-in replacement for the :mod:`thread` module" msgstr "" # 34e95ac17f4d47bab4ef3d2220062aec -#: ../src/Doc/library/dummy_thread.rst:8 +#: library/dummy_thread.rst:8 msgid "" "The :mod:`dummy_thread` module has been renamed to :mod:`_dummy_thread` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -33979,28 +34299,26 @@ msgid "" msgstr "" # 073f53322c624e27b6f10dd49500692d -#: ../src/Doc/library/dummy_thread.rst:13 +#: library/dummy_thread.rst:13 #, fuzzy msgid "**Source code:** :source:`Lib/dummy_thread.py`" msgstr "**Code source:** :source:`Lib/_dummy_thread.py`" # 3a1e6fe41f5544d5831c9c9c77684952 -#: ../src/Doc/library/dummy_thread.rst:17 +#: library/dummy_thread.rst:17 msgid "" "This module provides a duplicate interface to the :mod:`thread` module. It " "is meant to be imported when the :mod:`thread` module is not provided on a " "platform." msgstr "" -#: ../src/Doc/library/dummy_thread.rst:21 -#: ../src/Doc/library/dummy_threading.rst:15 +#: library/dummy_thread.rst:21 library/dummy_threading.rst:15 msgid "Suggested usage is::" msgstr "Utilisation suggérée : " # f30a5f7989fd4407a5b366ac1a0960bf # b8f7d393555b4e5bbc79d59ab77bafa2 -#: ../src/Doc/library/dummy_thread.rst:28 -#: ../src/Doc/library/dummy_threading.rst:22 +#: library/dummy_thread.rst:28 library/dummy_threading.rst:22 #, fuzzy msgid "" "Be careful to not use this module where deadlock might occur from a thread " @@ -34011,20 +34329,20 @@ msgstr "" "produire à partir d'un thread en cours de création qui bloque en attentant " "qu'un autre thread soit créé. Cela se produit souvent avec des I/O bloquants." -#: ../src/Doc/library/dummy_threading.rst:2 +#: library/dummy_threading.rst:2 msgid "" ":mod:`dummy_threading` --- Drop-in replacement for the :mod:`threading` " "module" msgstr "" # 5ea7ffa6beb44f85a522262a3a85a16c -#: ../src/Doc/library/dummy_threading.rst:7 +#: library/dummy_threading.rst:7 #, fuzzy msgid "**Source code:** :source:`Lib/dummy_threading.py`" msgstr "**Code source:** :source:`Lib/_dummy_thread.py`" # 07acfbf21d30489cb18ac56f0be01804 -#: ../src/Doc/library/dummy_threading.rst:11 +#: library/dummy_threading.rst:11 msgid "" "This module provides a duplicate interface to the :mod:`threading` module. " "It is meant to be imported when the :mod:`thread` module is not provided on " @@ -34032,12 +34350,12 @@ msgid "" msgstr "" # 429e6e5e66224580a53bf0920762a95a -#: ../src/Doc/library/easydialogs.rst:3 +#: library/easydialogs.rst:3 msgid ":mod:`EasyDialogs` --- Basic Macintosh dialogs" msgstr "" # 817ddd79371d4b34990082958dc437f6 -#: ../src/Doc/library/easydialogs.rst:11 +#: library/easydialogs.rst:11 msgid "" "The :mod:`EasyDialogs` module contains some simple dialogs for the " "Macintosh. The dialogs get launched in a separate application which appears " @@ -34049,12 +34367,12 @@ msgid "" msgstr "" # 2c71043b27fb4b929f70e7eabdfb0cf7 -#: ../src/Doc/library/easydialogs.rst:24 +#: library/easydialogs.rst:24 msgid "The :mod:`EasyDialogs` module defines the following functions:" msgstr "" # 89d2c2f1958744c5b9454cecf68debff -#: ../src/Doc/library/easydialogs.rst:29 +#: library/easydialogs.rst:29 msgid "" "Displays a modal dialog with the message text *str*, which should be at most " "255 characters long. The button text defaults to \"OK\", but is set to the " @@ -34063,7 +34381,7 @@ msgid "" msgstr "" # 3e2b0259b8aa4e89b8b2ac9796aa41e9 -#: ../src/Doc/library/easydialogs.rst:37 +#: library/easydialogs.rst:37 msgid "" "Asks the user to input a string value via a modal dialog. *prompt* is the " "prompt message, and the optional *default* supplies the initial value for " @@ -34074,7 +34392,7 @@ msgid "" msgstr "" # e3ec4ae0f6d344928626fe10a1b2af9f -#: ../src/Doc/library/easydialogs.rst:47 +#: library/easydialogs.rst:47 msgid "" "Asks the user to input a string value via a modal dialog. Like :func:" "`AskString`, but with the text shown as bullets. The arguments have the same " @@ -34082,7 +34400,7 @@ msgid "" msgstr "" # 912dd65933154133b6ee1c7994562722 -#: ../src/Doc/library/easydialogs.rst:54 +#: library/easydialogs.rst:54 msgid "" "Presents a dialog with prompt *question* and three buttons labelled \"Yes\", " "\"No\", and \"Cancel\". Returns ``1`` for \"Yes\", ``0`` for \"No\" and " @@ -34094,7 +34412,7 @@ msgid "" msgstr "" # f6643890eceb4cf289174d17ec7bd25e -#: ../src/Doc/library/easydialogs.rst:64 +#: library/easydialogs.rst:64 msgid "" "Displays a modeless progress-bar dialog. This is the constructor for the :" "class:`ProgressBar` class described below. *title* is the text string " @@ -34105,7 +34423,7 @@ msgid "" msgstr "" # fbde2ec87fad4627bcefeb6f7172196a -#: ../src/Doc/library/easydialogs.rst:73 +#: library/easydialogs.rst:73 msgid "" "Displays a dialog which aids the user in constructing a command-line " "argument list. Returns the list in ``sys.argv`` format, suitable for " @@ -34121,7 +34439,7 @@ msgid "" msgstr "" # ff17fb88885b462ba85bc710728055c0 -#: ../src/Doc/library/easydialogs.rst:84 +#: library/easydialogs.rst:84 msgid "" "*optionlist* is a list that determines a popup menu from which the allowed " "options are selected. Its items can take one of two forms: *optstr* or " @@ -34131,56 +34449,56 @@ msgid "" msgstr "" # 8daef511cb8d43aa8d5de08b70fc909c -#: ../src/Doc/library/easydialogs.rst:91 +#: library/easydialogs.rst:91 msgid "*optstr* format" msgstr "" # e22382ee02a7439b82e241f1071e4c40 -#: ../src/Doc/library/easydialogs.rst:91 +#: library/easydialogs.rst:91 msgid "Command-line format" msgstr "" -#: ../src/Doc/library/easydialogs.rst:93 ../src/Doc/library/struct.rst:168 +#: library/easydialogs.rst:93 library/struct.rst:168 msgid "``x``" msgstr "" # 667adaebbd8344abbf7764e8137d5478 -#: ../src/Doc/library/easydialogs.rst:93 +#: library/easydialogs.rst:93 msgid ":option:`-x` (short option)" msgstr "" # 6d26e800d6044679951749d3ea95574f -#: ../src/Doc/library/easydialogs.rst:95 +#: library/easydialogs.rst:95 msgid "``x:`` or ``x=``" msgstr "" # 6b30a067a20749d1b1b17f36822be45a -#: ../src/Doc/library/easydialogs.rst:95 +#: library/easydialogs.rst:95 msgid ":option:`-x` (short option with value)" msgstr "" # 13db285912374602ab62e76f6dd14ab4 -#: ../src/Doc/library/easydialogs.rst:97 +#: library/easydialogs.rst:97 msgid "``xyz``" msgstr "" # f0c3c577ce144fe992f11bc706e3c06f -#: ../src/Doc/library/easydialogs.rst:97 +#: library/easydialogs.rst:97 msgid ":option:`--xyz` (long option)" msgstr "" # 047d5927a8bb42cb8d5d0b56aa187443 -#: ../src/Doc/library/easydialogs.rst:99 +#: library/easydialogs.rst:99 msgid "``xyz:`` or ``xyz=``" msgstr "" # 0d0cd5041bc54717b735bc6f953c6ce2 -#: ../src/Doc/library/easydialogs.rst:99 +#: library/easydialogs.rst:99 msgid ":option:`--xyz` (long option with value)" msgstr "" # f71a4a193f184f01b714b738db148650 -#: ../src/Doc/library/easydialogs.rst:102 +#: library/easydialogs.rst:102 msgid "" "*commandlist* is a list of items of the form *cmdstr* or ``(cmdstr, " "descr)``, where *descr* is as above. The *cmdstr*\\ s will appear in a " @@ -34190,7 +34508,7 @@ msgid "" msgstr "" # 437e0e0f179143b89a1358dbe1bf8d5a -#: ../src/Doc/library/easydialogs.rst:112 +#: library/easydialogs.rst:112 msgid "" "Post a dialog asking the user for a file to open, and return the file " "selected or :const:`None` if the user cancelled. *message* is a text message " @@ -34205,14 +34523,14 @@ msgid "" msgstr "" # a0c720f8d04a409cb9f11a3b10c1ad3a -#: ../src/Doc/library/easydialogs.rst:125 +#: library/easydialogs.rst:125 msgid "" "For a description of the other arguments please see the Apple Navigation " "Services documentation and the :mod:`EasyDialogs` source code." msgstr "" # 01db41e9929a49c6896bb2c915ccafb0 -#: ../src/Doc/library/easydialogs.rst:131 +#: library/easydialogs.rst:131 msgid "" "Post a dialog asking the user for a file to save to, and return the file " "selected or :const:`None` if the user cancelled. *savedFileName* is the " @@ -34221,35 +34539,31 @@ msgid "" msgstr "" # 124b1430be204931b0a322176db96588 -#: ../src/Doc/library/easydialogs.rst:139 +#: library/easydialogs.rst:139 msgid "" "Post a dialog asking the user to select a folder, and return the folder " "selected or :const:`None` if the user cancelled. See :func:`AskFileForOpen` " "for a description of the arguments." msgstr "" -# e2c7c5b0cc614ca486ceaf4dcd572c9e -#: ../src/Doc/library/easydialogs.rst:146 -msgid "" -"`Navigation Services Reference `_" +#: library/easydialogs.rst:147 +msgid "Navigation Services Reference" msgstr "" # d7f8c41738674260b052776a04eed872 -#: ../src/Doc/library/easydialogs.rst:147 +#: library/easydialogs.rst:147 msgid "" "Programmer's reference documentation for the Navigation Services, a part of " "the Carbon framework." msgstr "" # 211343ca59624ecfa573db5c0589e450 -#: ../src/Doc/library/easydialogs.rst:154 +#: library/easydialogs.rst:154 msgid "ProgressBar Objects" msgstr "" # 0799816dd3f54c9588911280f2c4d3c0 -#: ../src/Doc/library/easydialogs.rst:156 +#: library/easydialogs.rst:156 msgid "" ":class:`ProgressBar` objects provide support for modeless progress-bar " "dialogs. Both determinate (thermometer style) and indeterminate (barber-pole " @@ -34257,8 +34571,12 @@ msgid "" "maximum value is greater than zero; otherwise it will be indeterminate." msgstr "" +#: library/easydialogs.rst:161 +msgid "Support for indeterminate-style progress bars was added." +msgstr "" + # 9bddda48f81b48d08d6c226248e3ce7b -#: ../src/Doc/library/easydialogs.rst:164 +#: library/easydialogs.rst:164 msgid "" "The dialog is displayed immediately after creation. If the dialog's \"Cancel" "\" button is pressed, or if :kbd:`Cmd-.` or :kbd:`ESC` is typed, the dialog " @@ -34269,13 +34587,13 @@ msgid "" msgstr "" # 0d6b40f99bbe49ee8b8cd0181f2f090a -#: ../src/Doc/library/easydialogs.rst:171 +#: library/easydialogs.rst:171 msgid "" ":class:`ProgressBar` objects possess the following attributes and methods:" msgstr "" # f1936a44531b4a3fbaf3e8b009a3f654 -#: ../src/Doc/library/easydialogs.rst:176 +#: library/easydialogs.rst:176 msgid "" "The current value (of type integer or long integer) of the progress bar. " "The normal access methods coerce :attr:`curval` between ``0`` and :attr:" @@ -34283,7 +34601,7 @@ msgid "" msgstr "" # 864a8ff7e14945fea147ca124f0a85f4 -#: ../src/Doc/library/easydialogs.rst:183 +#: library/easydialogs.rst:183 msgid "" "The maximum value (of type integer or long integer) of the progress bar; the " "progress bar (thermometer style) is full when :attr:`curval` equals :attr:" @@ -34292,17 +34610,17 @@ msgid "" msgstr "" # ae300ff26e444e65bfc1099a5ab63e28 -#: ../src/Doc/library/easydialogs.rst:191 +#: library/easydialogs.rst:191 msgid "Sets the text in the title bar of the progress dialog to *newstr*." msgstr "" # c63e442056fa4ca29eca061050999eb8 -#: ../src/Doc/library/easydialogs.rst:196 +#: library/easydialogs.rst:196 msgid "Sets the text in the progress box of the progress dialog to *newstr*." msgstr "" # e06595e98c32447daafad8dfddcdefbc -#: ../src/Doc/library/easydialogs.rst:201 +#: library/easydialogs.rst:201 msgid "" "Sets the progress bar's :attr:`curval` to *value*, and also :attr:`maxval` " "to *max* if the latter is provided. *value* is first coerced between 0 and :" @@ -34311,7 +34629,7 @@ msgid "" msgstr "" # 90fb71747e984fdf82746ef355966032 -#: ../src/Doc/library/easydialogs.rst:209 +#: library/easydialogs.rst:209 msgid "" "Increments the progress bar's :attr:`curval` by *n*, or by ``1`` if *n* is " "not provided. (Note that *n* may be negative, in which case the effect is a " @@ -34321,12 +34639,12 @@ msgid "" "incrementing causes it to fall outside this range." msgstr "" -#: ../src/Doc/library/email.rst:2 +#: library/email.rst:2 msgid ":mod:`email` --- An email and MIME handling package" msgstr "" # ea350e135a744ed99ed9cc30aa8230f1 -#: ../src/Doc/library/email.rst:14 +#: library/email.rst:14 msgid "" "The :mod:`email` package is a library for managing email messages, including " "MIME and other :rfc:`2822`\\ -based message documents. It subsumes most of " @@ -34340,7 +34658,7 @@ msgid "" "`2046`, :rfc:`2047`, and :rfc:`2231`." msgstr "" -#: ../src/Doc/library/email.rst:25 +#: library/email.rst:25 msgid "" "The primary distinguishing feature of the :mod:`email` package is that it " "splits the parsing and generating of email messages from the internal " @@ -34355,7 +34673,7 @@ msgid "" "etc." msgstr "" -#: ../src/Doc/library/email.rst:36 +#: library/email.rst:36 msgid "" "The following sections describe the functionality of the :mod:`email` " "package. The ordering follows a progression that should be common in " @@ -34365,14 +34683,14 @@ msgid "" "rendered back into flat text." msgstr "" -#: ../src/Doc/library/email.rst:42 +#: library/email.rst:42 msgid "" "It is perfectly feasible to create the object structure out of whole cloth " "--- i.e. completely from scratch. From there, a similar progression can be " "taken as above." msgstr "" -#: ../src/Doc/library/email.rst:46 +#: library/email.rst:46 msgid "" "Also included are detailed specifications of all the classes and modules " "that the :mod:`email` package provides, the exception classes you might " @@ -34382,33 +34700,32 @@ msgid "" "porting is provided." msgstr "" -#: ../src/Doc/library/email.rst:52 +#: library/email.rst:52 msgid "Contents of the :mod:`email` package documentation:" msgstr "" -# 3db5f413859b45269c7376d15fb02fc9 -#: ../src/Doc/library/email.rst:71 -msgid "Module :mod:`smtplib`" -msgstr "" +#: library/email.rst:72 +#, fuzzy +msgid "Module smtplib" +msgstr "Modules" -#: ../src/Doc/library/email.rst:72 +#: library/email.rst:72 msgid "SMTP protocol client" msgstr "" -# b0c36af922c7478d939eb75552679cdc -#: ../src/Doc/library/email.rst:73 -msgid "Module :mod:`nntplib`" +#: library/email.rst:74 +msgid "Module nntplib" msgstr "" -#: ../src/Doc/library/email.rst:75 +#: library/email.rst:75 msgid "NNTP protocol client" msgstr "" -#: ../src/Doc/library/email.rst:81 +#: library/email.rst:81 msgid "Package History" msgstr "" -#: ../src/Doc/library/email.rst:83 +#: library/email.rst:83 msgid "" "This table describes the release history of the email package, corresponding " "to the version of Python that the package was released with. For purposes " @@ -34418,75 +34735,75 @@ msgid "" "of the package." msgstr "" -#: ../src/Doc/library/email.rst:90 +#: library/email.rst:90 msgid "email version" msgstr "" -#: ../src/Doc/library/email.rst:90 +#: library/email.rst:90 msgid "distributed with" msgstr "" -#: ../src/Doc/library/email.rst:90 +#: library/email.rst:90 msgid "compatible with" msgstr "" -#: ../src/Doc/library/email.rst:92 +#: library/email.rst:92 msgid ":const:`1.x`" msgstr "" -#: ../src/Doc/library/email.rst:92 +#: library/email.rst:92 msgid "Python 2.2.0 to Python 2.2.1" msgstr "" -#: ../src/Doc/library/email.rst:92 +#: library/email.rst:92 msgid "*no longer supported*" msgstr "" -#: ../src/Doc/library/email.rst:94 +#: library/email.rst:94 msgid ":const:`2.5`" msgstr "" -#: ../src/Doc/library/email.rst:94 +#: library/email.rst:94 msgid "Python 2.2.2+ and Python 2.3" msgstr "" -#: ../src/Doc/library/email.rst:94 +#: library/email.rst:94 msgid "Python 2.1 to 2.5" msgstr "" -#: ../src/Doc/library/email.rst:96 +#: library/email.rst:96 msgid ":const:`3.0`" msgstr "" -#: ../src/Doc/library/email.rst:96 +#: library/email.rst:96 msgid "Python 2.4" msgstr "" -#: ../src/Doc/library/email.rst:96 ../src/Doc/library/email.rst:98 +#: library/email.rst:96 library/email.rst:98 msgid "Python 2.3 to 2.5" msgstr "" -#: ../src/Doc/library/email.rst:98 +#: library/email.rst:98 msgid ":const:`4.0`" msgstr "" -#: ../src/Doc/library/email.rst:98 +#: library/email.rst:98 msgid "Python 2.5" msgstr "" -#: ../src/Doc/library/email.rst:101 +#: library/email.rst:101 msgid "" "Here are the major differences between :mod:`email` version 4 and version 3:" msgstr "" -#: ../src/Doc/library/email.rst:103 +#: library/email.rst:103 msgid "" "All modules have been renamed according to :pep:`8` standards. For example, " "the version 3 module :mod:`email.Message` was renamed to :mod:`email." "message` in version 4." msgstr "" -#: ../src/Doc/library/email.rst:107 +#: library/email.rst:107 msgid "" "A new subpackage :mod:`email.mime` was added and all the version 3 :mod:" "`email.MIME\\*` modules were renamed and situated into the :mod:`email.mime` " @@ -34494,18 +34811,18 @@ msgid "" "renamed to :mod:`email.mime.text`." msgstr "" -#: ../src/Doc/library/email.rst:112 +#: library/email.rst:112 msgid "*Note that the version 3 names will continue to work until Python 2.6*." msgstr "" # 5486bbc1e9c24fb3aba73ae2c34baefd -#: ../src/Doc/library/email.rst:114 +#: library/email.rst:114 msgid "" "The :mod:`email.mime.application` module was added, which contains the :" "class:`~email.mime.application.MIMEApplication` class." msgstr "" -#: ../src/Doc/library/email.rst:117 +#: library/email.rst:117 msgid "" "Methods that were deprecated in version 3 have been removed. These include :" "meth:`Generator.__call__`, :meth:`Message.get_type`, :meth:`Message." @@ -34513,7 +34830,7 @@ msgid "" msgstr "" # ca82f3e05181488b97a87ca54400ca9c -#: ../src/Doc/library/email.rst:121 +#: library/email.rst:121 msgid "" "Fixes have been added for :rfc:`2231` support which can change some of the " "return types for :func:`Message.get_param ` " @@ -34525,13 +34842,13 @@ msgid "" "done only for encoded segments." msgstr "" -#: ../src/Doc/library/email.rst:130 +#: library/email.rst:130 msgid "" "Here are the major differences between :mod:`email` version 3 and version 2:" msgstr "" # 8e91aa3fe9ee4ae1973d05c9a68134a8 -#: ../src/Doc/library/email.rst:132 +#: library/email.rst:132 msgid "" "The :class:`~email.parser.FeedParser` class was introduced, and the :class:" "`~email.parser.Parser` class was implemented in terms of the :class:`~email." @@ -34541,7 +34858,7 @@ msgid "" msgstr "" # 2e50ca2ea1f14706bd2b509eab1eedea -#: ../src/Doc/library/email.rst:139 +#: library/email.rst:139 msgid "" "All aspects of the API which raised :exc:`DeprecationWarning`\\ s in version " "2 have been removed. These include the *_encoder* argument to the :class:" @@ -34551,7 +34868,7 @@ msgid "" msgstr "" # 86f9cf9e071e4a8bbbe0eed27d522a62 -#: ../src/Doc/library/email.rst:145 +#: library/email.rst:145 msgid "" "New :exc:`DeprecationWarning`\\ s have been added to: :meth:`Generator." "__call__`, :meth:`Message.get_type`, :meth:`Message.get_main_type`, :meth:" @@ -34559,21 +34876,21 @@ msgid "" "parser.Parser` class. These are expected to be removed in future versions." msgstr "" -#: ../src/Doc/library/email.rst:151 +#: library/email.rst:151 msgid "Support for Pythons earlier than 2.3 has been removed." msgstr "" -#: ../src/Doc/library/email.rst:153 +#: library/email.rst:153 msgid "Here are the differences between :mod:`email` version 2 and version 1:" msgstr "" -#: ../src/Doc/library/email.rst:155 +#: library/email.rst:155 msgid "" "The :mod:`email.Header` and :mod:`email.Charset` modules have been added." msgstr "" # a09bfed733a8406888555359bc60d08f -#: ../src/Doc/library/email.rst:157 +#: library/email.rst:157 msgid "" "The pickle format for :class:`~email.message.Message` instances has changed. " "Since this was never (and still isn't) formally defined, this isn't " @@ -34584,7 +34901,7 @@ msgid "" msgstr "" # 2987aed9e29c4e329cd9dee4926083fd -#: ../src/Doc/library/email.rst:164 +#: library/email.rst:164 msgid "" "Several methods in the :class:`~email.message.Message` class have been " "deprecated, or their signatures changed. Also, many new methods have been " @@ -34593,7 +34910,7 @@ msgid "" msgstr "" # e73e94d6b7a4484c88b1be0fef1310ae -#: ../src/Doc/library/email.rst:169 +#: library/email.rst:169 msgid "" "The object structure has changed in the face of :mimetype:`message/rfc822` " "content types. In :mod:`email` version 1, such a type would be represented " @@ -34604,7 +34921,7 @@ msgid "" msgstr "" # 386016006f7f468e948cbcf39f776be1 -#: ../src/Doc/library/email.rst:176 +#: library/email.rst:176 msgid "" "This structure was inconsistent with the rest of the package, so the object " "representation for :mimetype:`message/rfc822` content types was changed. " @@ -34615,7 +34932,7 @@ msgid "" msgstr "" # 28b56d4f7a864aaabed1de9c82e2e055 -#: ../src/Doc/library/email.rst:183 +#: library/email.rst:183 msgid "" "Note that this is one place that backward compatibility could not be " "completely maintained. However, if you're already testing the return type " @@ -34626,7 +34943,7 @@ msgid "" msgstr "" # 58172dbc276b452f84f534caf8691504 -#: ../src/Doc/library/email.rst:190 +#: library/email.rst:190 msgid "" "The :class:`~email.parser.Parser` constructor's *strict* argument was added, " "and its :meth:`~email.parser.Parser.parse` and :meth:`~email.parser.Parser." @@ -34636,7 +34953,7 @@ msgid "" msgstr "" # bac67488d95140f285ffd728f9fac11a -#: ../src/Doc/library/email.rst:196 +#: library/email.rst:196 msgid "" ":meth:`Generator.__call__` is deprecated; use :meth:`Generator.flatten " "` instead. The :class:`~email.generator." @@ -34645,14 +34962,14 @@ msgid "" msgstr "" # b7145b1a43cb41f58f1808d91559fee5 -#: ../src/Doc/library/email.rst:201 +#: library/email.rst:201 msgid "" "The :class:`~email.generator.DecodedGenerator` class in the :mod:`email." "generator` module was added." msgstr "" # d9523476e4cd4e7e80938ef3302f97c9 -#: ../src/Doc/library/email.rst:204 +#: library/email.rst:204 msgid "" "The intermediate base classes :class:`~email.mime.nonmultipart." "MIMENonMultipart` and :class:`~email.mime.multipart.MIMEMultipart` have been " @@ -34661,14 +34978,14 @@ msgid "" msgstr "" # 97922479bd3e4c05b4ee7beb7cd1ebad -#: ../src/Doc/library/email.rst:209 +#: library/email.rst:209 msgid "" "The *_encoder* argument to the :class:`~email.mime.text.MIMEText` " "constructor has been deprecated. Encoding now happens implicitly based on " "the *_charset* argument." msgstr "" -#: ../src/Doc/library/email.rst:213 +#: library/email.rst:213 msgid "" "The following functions in the :mod:`email.Utils` module have been " "deprecated: :func:`dump_address_pairs`, :func:`decode`, and :func:`encode`. " @@ -34676,16 +34993,16 @@ msgid "" "func:`decode_rfc2231`, :func:`encode_rfc2231`, and :func:`decode_params`." msgstr "" -#: ../src/Doc/library/email.rst:218 +#: library/email.rst:218 msgid "The non-public function :func:`email.Iterators._structure` was added." msgstr "" -#: ../src/Doc/library/email.rst:222 +#: library/email.rst:222 msgid "Differences from :mod:`mimelib`" msgstr "" # ccf1d61d4dd24cf0933c337d6bc9ab7d -#: ../src/Doc/library/email.rst:224 +#: library/email.rst:224 msgid "" "The :mod:`email` package was originally prototyped as a separate library " "called `mimelib `_. Changes have been made " @@ -34697,84 +35014,84 @@ msgid "" "and the :mod:`email` package was not a priority." msgstr "" -#: ../src/Doc/library/email.rst:233 +#: library/email.rst:233 msgid "" "Here is a brief description of the differences between the :mod:`mimelib` " "and the :mod:`email` packages, along with hints on how to port your " "applications." msgstr "" -#: ../src/Doc/library/email.rst:236 +#: library/email.rst:236 msgid "" "Of course, the most visible difference between the two packages is that the " "package name has been changed to :mod:`email`. In addition, the top-level " "package has the following differences:" msgstr "" -#: ../src/Doc/library/email.rst:240 +#: library/email.rst:240 msgid "" ":func:`messageFromString` has been renamed to :func:`message_from_string`." msgstr "" -#: ../src/Doc/library/email.rst:242 +#: library/email.rst:242 msgid ":func:`messageFromFile` has been renamed to :func:`message_from_file`." msgstr "" # bc7dd1411b824fae99172e35c9ef7bb5 -#: ../src/Doc/library/email.rst:244 +#: library/email.rst:244 msgid "" "The :class:`~email.message.Message` class has the following differences:" msgstr "" # 2a1fee3d488940368c50d0f243e038db -#: ../src/Doc/library/email.rst:246 +#: library/email.rst:246 msgid "" "The method :meth:`asString` was renamed to :meth:`~email.message.Message." "as_string`." msgstr "" # ac4919c70ae149278cc2a49d98d7b815 -#: ../src/Doc/library/email.rst:249 +#: library/email.rst:249 msgid "" "The method :meth:`ismultipart` was renamed to :meth:`~email.message.Message." "is_multipart`." msgstr "" # 319cf1aa95b64c85a20dd29e74850a6e -#: ../src/Doc/library/email.rst:252 +#: library/email.rst:252 msgid "" "The :meth:`~email.message.Message.get_payload` method has grown a *decode* " "optional argument." msgstr "" # efb8606ad564430e8d9d5cbfdb990e66 -#: ../src/Doc/library/email.rst:255 +#: library/email.rst:255 msgid "" "The method :meth:`getall` was renamed to :meth:`~email.message.Message." "get_all`." msgstr "" # 4f0a5ff14331407c93358e42caf0c847 -#: ../src/Doc/library/email.rst:258 +#: library/email.rst:258 msgid "" "The method :meth:`addheader` was renamed to :meth:`~email.message.Message." "add_header`." msgstr "" -#: ../src/Doc/library/email.rst:261 +#: library/email.rst:261 msgid "The method :meth:`gettype` was renamed to :meth:`get_type`." msgstr "" -#: ../src/Doc/library/email.rst:263 +#: library/email.rst:263 msgid "The method :meth:`getmaintype` was renamed to :meth:`get_main_type`." msgstr "" -#: ../src/Doc/library/email.rst:265 +#: library/email.rst:265 msgid "The method :meth:`getsubtype` was renamed to :meth:`get_subtype`." msgstr "" # 98702a3f329941ad89a5ac94d1f7ec2a -#: ../src/Doc/library/email.rst:267 +#: library/email.rst:267 msgid "" "The method :meth:`getparams` was renamed to :meth:`~email.message.Message." "get_params`. Also, whereas :meth:`getparams` returned a list of strings, :" @@ -34783,42 +35100,42 @@ msgid "" msgstr "" # a56053d7ddb6442fa1dfb0869eaed2dc -#: ../src/Doc/library/email.rst:273 +#: library/email.rst:273 msgid "" "The method :meth:`getparam` was renamed to :meth:`~email.message.Message." "get_param`." msgstr "" # ddb2a765ff4f488ca914e88baef0d9fc -#: ../src/Doc/library/email.rst:276 +#: library/email.rst:276 msgid "" "The method :meth:`getcharsets` was renamed to :meth:`~email.message.Message." "get_charsets`." msgstr "" # 37f7636126b94c1e88a26a5b0174ab0d -#: ../src/Doc/library/email.rst:279 +#: library/email.rst:279 msgid "" "The method :meth:`getfilename` was renamed to :meth:`~email.message.Message." "get_filename`." msgstr "" # 49d5709484be4d6e83c2c4f23b8da58c -#: ../src/Doc/library/email.rst:282 +#: library/email.rst:282 msgid "" "The method :meth:`getboundary` was renamed to :meth:`~email.message.Message." "get_boundary`." msgstr "" # 514c70f0b81a4699b1836367d14bfee3 -#: ../src/Doc/library/email.rst:285 +#: library/email.rst:285 msgid "" "The method :meth:`setboundary` was renamed to :meth:`~email.message.Message." "set_boundary`." msgstr "" # 0d3d85bf2589499196c7d85b708af03e -#: ../src/Doc/library/email.rst:288 +#: library/email.rst:288 msgid "" "The method :meth:`getdecodedpayload` was removed. To get similar " "functionality, pass the value 1 to the *decode* flag of the :meth:`~email." @@ -34826,7 +35143,7 @@ msgid "" msgstr "" # c48202439f54407ab6353d3d1b0e004e -#: ../src/Doc/library/email.rst:292 +#: library/email.rst:292 msgid "" "The method :meth:`getpayloadastext` was removed. Similar functionality is " "supported by the :class:`~email.generator.DecodedGenerator` class in the :" @@ -34834,7 +35151,7 @@ msgid "" msgstr "" # 1658d6976ace4739a5cfe1c2089dfe8d -#: ../src/Doc/library/email.rst:296 +#: library/email.rst:296 msgid "" "The method :meth:`getbodyastext` was removed. You can get similar " "functionality by creating an iterator with :func:`~email.iterators." @@ -34842,7 +35159,7 @@ msgid "" msgstr "" # 79c2fc5f008d42b78e1ada25b14eba1e -#: ../src/Doc/library/email.rst:301 +#: library/email.rst:301 msgid "" "The :class:`~email.parser.Parser` class has no differences in its public " "interface. It does have some additional smarts to recognize :mimetype:" @@ -34853,7 +35170,7 @@ msgid "" msgstr "" # 2da88aeaf3574ec9a2e595cd48de8261 -#: ../src/Doc/library/email.rst:308 +#: library/email.rst:308 msgid "" "The :class:`~email.generator.Generator` class has no differences in its " "public interface. There is a new class in the :mod:`email.generator` module " @@ -34862,30 +35179,30 @@ msgid "" "getpayloadastext` method." msgstr "" -#: ../src/Doc/library/email.rst:314 +#: library/email.rst:314 msgid "The following modules and classes have been changed:" msgstr "" # 43b905a70dde4f149fefca6d97de36ad -#: ../src/Doc/library/email.rst:316 +#: library/email.rst:316 msgid "" "The :class:`~email.mime.base.MIMEBase` class constructor arguments *_major* " "and *_minor* have changed to *_maintype* and *_subtype* respectively." msgstr "" -#: ../src/Doc/library/email.rst:319 +#: library/email.rst:319 msgid "" "The ``Image`` class/module has been renamed to ``MIMEImage``. The *_minor* " "argument has been renamed to *_subtype*." msgstr "" -#: ../src/Doc/library/email.rst:322 +#: library/email.rst:322 msgid "" "The ``Text`` class/module has been renamed to ``MIMEText``. The *_minor* " "argument has been renamed to *_subtype*." msgstr "" -#: ../src/Doc/library/email.rst:325 +#: library/email.rst:325 msgid "" "The ``MessageRFC822`` class/module has been renamed to ``MIMEMessage``. " "Note that an earlier version of :mod:`mimelib` called this class/module " @@ -34894,7 +35211,7 @@ msgid "" msgstr "" # 551e5a168d0e42e08efdef887a79c640 -#: ../src/Doc/library/email.rst:330 +#: library/email.rst:330 msgid "" "Also, the :class:`~email.mime.message.MIMEMessage` class now represents any " "kind of MIME message with main type :mimetype:`message`. It takes an " @@ -34902,7 +35219,7 @@ msgid "" "*_subtype* defaults to :mimetype:`rfc822`." msgstr "" -#: ../src/Doc/library/email.rst:336 +#: library/email.rst:336 msgid "" ":mod:`mimelib` provided some utility functions in its :mod:`address` and :" "mod:`date` modules. All of these functions have been moved to the :mod:" @@ -34910,76 +35227,76 @@ msgid "" msgstr "" # c5256eab750649cb991c50b0b406bf43 -#: ../src/Doc/library/email.rst:340 +#: library/email.rst:340 msgid "" "The ``MsgReader`` class/module has been removed. Its functionality is most " "closely supported in the :func:`~email.iterators.body_line_iterator` " "function in the :mod:`email.iterators` module." msgstr "" -#: ../src/Doc/library/email.rst:346 +#: library/email.rst:346 msgid "Delivery Status Notifications (DSN) are defined in :rfc:`1894`." msgstr "" -#: ../src/Doc/library/email-examples.rst:4 +#: library/email-examples.rst:4 msgid ":mod:`email`: Examples" msgstr "" -#: ../src/Doc/library/email-examples.rst:6 +#: library/email-examples.rst:6 msgid "" "Here are a few examples of how to use the :mod:`email` package to read, " "write, and send simple email messages, as well as more complex MIME messages." msgstr "" -#: ../src/Doc/library/email-examples.rst:9 +#: library/email-examples.rst:9 msgid "First, let's see how to create and send a simple text message:" msgstr "" -#: ../src/Doc/library/email-examples.rst:14 +#: library/email-examples.rst:14 msgid "" "And parsing RFC822 headers can easily be done by the parse(filename) or " "parsestr(message_as_string) methods of the Parser() class:" msgstr "" -#: ../src/Doc/library/email-examples.rst:20 +#: library/email-examples.rst:20 msgid "" "Here's an example of how to send a MIME message containing a bunch of family " "pictures that may be residing in a directory:" msgstr "" -#: ../src/Doc/library/email-examples.rst:26 +#: library/email-examples.rst:26 msgid "" "Here's an example of how to send the entire contents of a directory as an " "email message: [1]_" msgstr "" -#: ../src/Doc/library/email-examples.rst:32 +#: library/email-examples.rst:32 msgid "" "Here's an example of how to unpack a MIME message like the one above, into a " "directory of files:" msgstr "" -#: ../src/Doc/library/email-examples.rst:37 +#: library/email-examples.rst:37 msgid "" "Here's an example of how to create an HTML message with an alternative plain " "text version: [2]_" msgstr "" -#: ../src/Doc/library/email-examples.rst:45 +#: library/email-examples.rst:45 msgid "" "Thanks to Matthew Dixon Cowles for the original inspiration and examples." msgstr "" -#: ../src/Doc/library/email-examples.rst:46 +#: library/email-examples.rst:46 msgid "Contributed by Martin Matejek." msgstr "" # 8e63d65664b745ffa8966780c73be6f5 -#: ../src/Doc/library/email.charset.rst:2 +#: library/email.charset.rst:2 msgid ":mod:`email.charset`: Representing character sets" msgstr "" -#: ../src/Doc/library/email.charset.rst:8 +#: library/email.charset.rst:8 msgid "" "This module provides a class :class:`Charset` for representing character " "sets and character set conversions in email messages, as well as a character " @@ -34988,15 +35305,15 @@ msgid "" "mod:`email` package." msgstr "" -#: ../src/Doc/library/email.charset.rst:14 +#: library/email.charset.rst:14 msgid "Import this class from the :mod:`email.charset` module." msgstr "" -#: ../src/Doc/library/email.charset.rst:21 +#: library/email.charset.rst:21 msgid "Map character sets to their email properties." msgstr "" -#: ../src/Doc/library/email.charset.rst:23 +#: library/email.charset.rst:23 msgid "" "This class provides information about the requirements imposed on email for " "a specific character set. It also provides convenience routines for " @@ -35005,14 +35322,14 @@ msgid "" "on how to use that character set in an email message in an RFC-compliant way." msgstr "" -#: ../src/Doc/library/email.charset.rst:29 +#: library/email.charset.rst:29 msgid "" "Certain character sets must be encoded with quoted-printable or base64 when " "used in email headers or bodies. Certain character sets must be converted " "outright, and are not allowed in email." msgstr "" -#: ../src/Doc/library/email.charset.rst:33 +#: library/email.charset.rst:33 msgid "" "Optional *input_charset* is as described below; it is always coerced to " "lower case. After being alias normalized it is also used as a lookup into " @@ -35025,18 +35342,18 @@ msgid "" "from the ``euc-jp`` character set to the ``iso-2022-jp`` character set." msgstr "" -#: ../src/Doc/library/email.charset.rst:43 +#: library/email.charset.rst:43 msgid ":class:`Charset` instances have the following data attributes:" msgstr "" -#: ../src/Doc/library/email.charset.rst:48 +#: library/email.charset.rst:48 msgid "" "The initial character set specified. Common aliases are converted to their " "*official* email names (e.g. ``latin_1`` is converted to ``iso-8859-1``). " "Defaults to 7-bit ``us-ascii``." msgstr "" -#: ../src/Doc/library/email.charset.rst:55 +#: library/email.charset.rst:55 msgid "" "If the character set must be encoded before it can be used in an email " "header, this attribute will be set to ``Charset.QP`` (for quoted-printable), " @@ -35044,7 +35361,7 @@ msgid "" "shortest of QP or BASE64 encoding. Otherwise, it will be ``None``." msgstr "" -#: ../src/Doc/library/email.charset.rst:64 +#: library/email.charset.rst:64 msgid "" "Same as *header_encoding*, but describes the encoding for the mail message's " "body, which indeed may be different than the header encoding. ``Charset." @@ -35052,7 +35369,7 @@ msgid "" msgstr "" # d3fd8051b51b4b7e9d3854f2c21af5eb -#: ../src/Doc/library/email.charset.rst:71 +#: library/email.charset.rst:71 msgid "" "Some character sets must be converted before they can be used in email " "headers or bodies. If the *input_charset* is one of them, this attribute " @@ -35060,29 +35377,29 @@ msgid "" "Otherwise, it will be ``None``." msgstr "" -#: ../src/Doc/library/email.charset.rst:79 +#: library/email.charset.rst:79 msgid "" "The name of the Python codec used to convert the *input_charset* to " "Unicode. If no conversion codec is necessary, this attribute will be " "``None``." msgstr "" -#: ../src/Doc/library/email.charset.rst:86 +#: library/email.charset.rst:86 msgid "" "The name of the Python codec used to convert Unicode to the " "*output_charset*. If no conversion codec is necessary, this attribute will " "have the same value as the *input_codec*." msgstr "" -#: ../src/Doc/library/email.charset.rst:90 +#: library/email.charset.rst:90 msgid ":class:`Charset` instances also have the following methods:" msgstr "" -#: ../src/Doc/library/email.charset.rst:95 +#: library/email.charset.rst:95 msgid "Return the content transfer encoding used for body encoding." msgstr "" -#: ../src/Doc/library/email.charset.rst:97 +#: library/email.charset.rst:97 msgid "" "This is either the string ``quoted-printable`` or ``base64`` depending on " "the encoding used, or it is a function, in which case you should call the " @@ -35091,7 +35408,7 @@ msgid "" "itself to whatever is appropriate." msgstr "" -#: ../src/Doc/library/email.charset.rst:103 +#: library/email.charset.rst:103 msgid "" "Returns the string ``quoted-printable`` if *body_encoding* is ``QP``, " "returns the string ``base64`` if *body_encoding* is ``BASE64``, and returns " @@ -35099,47 +35416,47 @@ msgid "" msgstr "" # 25874fa5fab241a69cd21680cdaf727f -#: ../src/Doc/library/email.charset.rst:110 +#: library/email.charset.rst:110 msgid "Convert the string *s* from the *input_codec* to the *output_codec*." msgstr "" # 40155d8dd5d4415383aad5bbd775311c -#: ../src/Doc/library/email.charset.rst:115 +#: library/email.charset.rst:115 msgid "" "Convert a possibly multibyte string to a safely splittable format. *s* is " "the string to split." msgstr "" # cac78885d3fa417589513e8d71e6c840 -#: ../src/Doc/library/email.charset.rst:118 +#: library/email.charset.rst:118 msgid "" "Uses the *input_codec* to try and convert the string to Unicode, so it can " "be safely split on character boundaries (even for multibyte characters)." msgstr "" # b1f43aa718f5495fb4b873d98c5f2fad -#: ../src/Doc/library/email.charset.rst:121 +#: library/email.charset.rst:121 msgid "" "Returns the string as-is if it isn't known how to convert *s* to Unicode " "with the *input_charset*." msgstr "" # 472537b6820742038c5beee8292e449f -#: ../src/Doc/library/email.charset.rst:124 +#: library/email.charset.rst:124 msgid "" "Characters that could not be converted to Unicode will be replaced with the " "Unicode replacement character ``'U+FFFD'``." msgstr "" # fb61b338244b4437a5727bcb9165048f -#: ../src/Doc/library/email.charset.rst:130 +#: library/email.charset.rst:130 msgid "" "Convert a splittable string back into an encoded string. *ustr* is a " "Unicode string to \"unsplit\"." msgstr "" # b3265f9a100f48a3b78adea92f86b38e -#: ../src/Doc/library/email.charset.rst:133 +#: library/email.charset.rst:133 msgid "" "This method uses the proper codec to try and convert the string from Unicode " "back into an encoded format. Return the string as-is if it is not Unicode, " @@ -35147,42 +35464,42 @@ msgid "" msgstr "" # 93c6f2d734a34f3c9e231b1365afa36d -#: ../src/Doc/library/email.charset.rst:137 +#: library/email.charset.rst:137 msgid "" "Characters that could not be converted from Unicode will be replaced with an " "appropriate character (usually ``'?'``)." msgstr "" # ca9a672a87174eeba31483c9e7b784f2 -#: ../src/Doc/library/email.charset.rst:140 +#: library/email.charset.rst:140 msgid "" "If *to_output* is ``True`` (the default), uses *output_codec* to convert to " "an encoded format. If *to_output* is ``False``, it uses *input_codec*." msgstr "" -#: ../src/Doc/library/email.charset.rst:146 +#: library/email.charset.rst:146 msgid "Return the output character set." msgstr "" -#: ../src/Doc/library/email.charset.rst:148 +#: library/email.charset.rst:148 msgid "" "This is the *output_charset* attribute if that is not ``None``, otherwise it " "is *input_charset*." msgstr "" -#: ../src/Doc/library/email.charset.rst:154 +#: library/email.charset.rst:154 msgid "" "Return the length of the encoded header string, properly calculating for " "quoted-printable or base64 encoding." msgstr "" # 1be456990f054dd99c7bcd89715518ae -#: ../src/Doc/library/email.charset.rst:160 +#: library/email.charset.rst:160 msgid "Header-encode the string *s*." msgstr "" # ba82febae027456d81ab40c209fb4617 -#: ../src/Doc/library/email.charset.rst:162 +#: library/email.charset.rst:162 msgid "" "If *convert* is ``True``, the string will be converted from the input " "charset to the output charset automatically. This is not useful for " @@ -35192,19 +35509,19 @@ msgid "" "(see :mod:`email.header`). *convert* defaults to ``False``." msgstr "" -#: ../src/Doc/library/email.charset.rst:169 +#: library/email.charset.rst:169 msgid "" "The type of encoding (base64 or quoted-printable) will be based on the " "*header_encoding* attribute." msgstr "" # 40753fd1bcfc46f5b00efb54c09316ae -#: ../src/Doc/library/email.charset.rst:175 +#: library/email.charset.rst:175 msgid "Body-encode the string *s*." msgstr "" # fd8dd82d2c9e48f0bc4fe678141da0c6 -#: ../src/Doc/library/email.charset.rst:177 +#: library/email.charset.rst:177 msgid "" "If *convert* is ``True`` (the default), the string will be converted from " "the input charset to output charset automatically. Unlike :meth:" @@ -35212,53 +35529,53 @@ msgid "" "charsets in email bodies, so this is usually pretty safe." msgstr "" -#: ../src/Doc/library/email.charset.rst:182 +#: library/email.charset.rst:182 msgid "" "The type of encoding (base64 or quoted-printable) will be based on the " "*body_encoding* attribute." msgstr "" -#: ../src/Doc/library/email.charset.rst:185 +#: library/email.charset.rst:185 msgid "" "The :class:`Charset` class also provides a number of methods to support " "standard operations and built-in functions." msgstr "" -#: ../src/Doc/library/email.charset.rst:191 +#: library/email.charset.rst:191 msgid "" "Returns *input_charset* as a string coerced to lower case. :meth:`__repr__` " "is an alias for :meth:`__str__`." msgstr "" -#: ../src/Doc/library/email.charset.rst:197 +#: library/email.charset.rst:197 msgid "" "This method allows you to compare two :class:`Charset` instances for " "equality." msgstr "" -#: ../src/Doc/library/email.charset.rst:203 +#: library/email.charset.rst:203 msgid "" "This method allows you to compare two :class:`Charset` instances for " "inequality." msgstr "" -#: ../src/Doc/library/email.charset.rst:206 +#: library/email.charset.rst:206 msgid "" "The :mod:`email.charset` module also provides the following functions for " "adding new entries to the global character set, alias, and codec registries:" msgstr "" -#: ../src/Doc/library/email.charset.rst:212 +#: library/email.charset.rst:212 msgid "Add character properties to the global registry." msgstr "" -#: ../src/Doc/library/email.charset.rst:214 +#: library/email.charset.rst:214 msgid "" "*charset* is the input character set, and must be the canonical name of a " "character set." msgstr "" -#: ../src/Doc/library/email.charset.rst:217 +#: library/email.charset.rst:217 msgid "" "Optional *header_enc* and *body_enc* is either ``Charset.QP`` for quoted-" "printable, ``Charset.BASE64`` for base64 encoding, ``Charset.SHORTEST`` for " @@ -35267,7 +35584,7 @@ msgid "" "``None`` for no encoding." msgstr "" -#: ../src/Doc/library/email.charset.rst:223 +#: library/email.charset.rst:223 msgid "" "Optional *output_charset* is the character set that the output should be in. " "Conversions will proceed from input charset, to Unicode, to the output " @@ -35275,7 +35592,7 @@ msgid "" "to output in the same character set as the input." msgstr "" -#: ../src/Doc/library/email.charset.rst:228 +#: library/email.charset.rst:228 msgid "" "Both *input_charset* and *output_charset* must have Unicode codec entries in " "the module's character set-to-codec mapping; use :func:`add_codec` to add " @@ -35283,32 +35600,32 @@ msgid "" "documentation for more information." msgstr "" -#: ../src/Doc/library/email.charset.rst:233 +#: library/email.charset.rst:233 msgid "" "The global character set registry is kept in the module global dictionary " "``CHARSETS``." msgstr "" -#: ../src/Doc/library/email.charset.rst:239 +#: library/email.charset.rst:239 msgid "" "Add a character set alias. *alias* is the alias name, e.g. ``latin-1``. " "*canonical* is the character set's canonical name, e.g. ``iso-8859-1``." msgstr "" -#: ../src/Doc/library/email.charset.rst:242 +#: library/email.charset.rst:242 msgid "" "The global charset alias registry is kept in the module global dictionary " "``ALIASES``." msgstr "" -#: ../src/Doc/library/email.charset.rst:248 +#: library/email.charset.rst:248 msgid "" "Add a codec that map characters in the given character set to and from " "Unicode." msgstr "" # e8cc36108fdb41f386af3297b6971f27 -#: ../src/Doc/library/email.charset.rst:250 +#: library/email.charset.rst:250 msgid "" "*charset* is the canonical name of a character set. *codecname* is the name " "of a Python codec, as appropriate for the second argument to the :func:" @@ -35317,11 +35634,11 @@ msgid "" msgstr "" # f2942f6b2078466397ff1a95fc0203be -#: ../src/Doc/library/email.encoders.rst:2 +#: library/email.encoders.rst:2 msgid ":mod:`email.encoders`: Encoders" msgstr "" -#: ../src/Doc/library/email.encoders.rst:8 +#: library/email.encoders.rst:8 msgid "" "When creating :class:`~email.message.Message` objects from scratch, you " "often need to encode the payloads for transport through compliant mail " @@ -35329,7 +35646,7 @@ msgid "" "`text/\\*` type messages containing binary data." msgstr "" -#: ../src/Doc/library/email.encoders.rst:13 +#: library/email.encoders.rst:13 msgid "" "The :mod:`email` package provides some convenient encodings in its :mod:" "`encoders` module. These encoders are actually used by the :class:`~email." @@ -35342,18 +35659,18 @@ msgid "" msgstr "" # 45bbd8227105428fb725e344364c8447 -#: ../src/Doc/library/email.encoders.rst:21 +#: library/email.encoders.rst:21 msgid "" "Note that these functions are not meaningful for a multipart message. They " "must be applied to individual subparts instead, and will raise a :exc:" "`TypeError` if passed a message whose type is multipart." msgstr "" -#: ../src/Doc/library/email.encoders.rst:25 +#: library/email.encoders.rst:25 msgid "Here are the encoding functions provided:" msgstr "" -#: ../src/Doc/library/email.encoders.rst:30 +#: library/email.encoders.rst:30 msgid "" "Encodes the payload into quoted-printable form and sets the :mailheader:" "`Content-Transfer-Encoding` header to ``quoted-printable`` [#]_. This is a " @@ -35361,7 +35678,7 @@ msgid "" "contains a few unprintable characters." msgstr "" -#: ../src/Doc/library/email.encoders.rst:38 +#: library/email.encoders.rst:38 msgid "" "Encodes the payload into base64 form and sets the :mailheader:`Content-" "Transfer-Encoding` header to ``base64``. This is a good encoding to use " @@ -35370,37 +35687,37 @@ msgid "" "renders the text non-human readable." msgstr "" -#: ../src/Doc/library/email.encoders.rst:47 +#: library/email.encoders.rst:47 msgid "" "This doesn't actually modify the message's payload, but it does set the :" "mailheader:`Content-Transfer-Encoding` header to either ``7bit`` or ``8bit`` " "as appropriate, based on the payload data." msgstr "" -#: ../src/Doc/library/email.encoders.rst:54 +#: library/email.encoders.rst:54 msgid "" "This does nothing; it doesn't even set the :mailheader:`Content-Transfer-" "Encoding` header." msgstr "" -#: ../src/Doc/library/email.encoders.rst:59 +#: library/email.encoders.rst:59 msgid "" "Note that encoding with :meth:`encode_quopri` also encodes all tabs and " "space characters in the data." msgstr "" # 5ebf922579f64907abdc6e8d19c9e708 -#: ../src/Doc/library/email.errors.rst:2 +#: library/email.errors.rst:2 msgid ":mod:`email.errors`: Exception and Defect classes" msgstr "" -#: ../src/Doc/library/email.errors.rst:8 +#: library/email.errors.rst:8 msgid "" "The following exception classes are defined in the :mod:`email.errors` " "module:" msgstr "" -#: ../src/Doc/library/email.errors.rst:13 +#: library/email.errors.rst:13 msgid "" "This is the base class for all exceptions that the :mod:`email` package can " "raise. It is derived from the standard :exc:`Exception` class and defines " @@ -35408,7 +35725,7 @@ msgid "" msgstr "" # 0d248a4d55814e54a686e43054c16da9 -#: ../src/Doc/library/email.errors.rst:20 +#: library/email.errors.rst:20 msgid "" "This is the base class for exceptions raised by the :class:`~email.parser." "Parser` class. It is derived from :exc:`MessageError`." @@ -35416,8 +35733,7 @@ msgstr "" # e0e1d7ba40f6446a99bdf4051e0e2d37 # 139857b0bc944e289961a4b147d4c6ff -#: ../src/Doc/library/email.errors.rst:26 -#: ../src/Doc/library/email.errors.rst:39 +#: library/email.errors.rst:26 library/email.errors.rst:39 msgid "" "Raised under some error conditions when parsing the :rfc:`2822` headers of a " "message, this class is derived from :exc:`MessageParseError`. It can be " @@ -35425,7 +35741,7 @@ msgid "" "`Parser.parsestr ` methods." msgstr "" -#: ../src/Doc/library/email.errors.rst:31 +#: library/email.errors.rst:31 msgid "" "Situations where it can be raised include finding an envelope header after " "the first :rfc:`2822` header of the message, finding a continuation line " @@ -35433,7 +35749,7 @@ msgid "" "headers which is neither a header or a continuation line." msgstr "" -#: ../src/Doc/library/email.errors.rst:44 +#: library/email.errors.rst:44 msgid "" "Situations where it can be raised include not being able to find the " "starting or terminating boundary in a :mimetype:`multipart/\\*` message when " @@ -35441,7 +35757,7 @@ msgid "" msgstr "" # 6b0189e3da424952ba543fa632487512 -#: ../src/Doc/library/email.errors.rst:51 +#: library/email.errors.rst:51 msgid "" "Raised when a payload is added to a :class:`~email.message.Message` object " "using :meth:`add_payload`, but the payload is already a scalar and the " @@ -35451,7 +35767,7 @@ msgid "" msgstr "" # 56b68f3046c644b0875f4c3fa45298cc -#: ../src/Doc/library/email.errors.rst:57 +#: library/email.errors.rst:57 msgid "" "Since :meth:`Message.add_payload` is deprecated, this exception is rarely " "raised in practice. However the exception may also be raised if the :meth:" @@ -35461,7 +35777,7 @@ msgid "" msgstr "" # 93eae5a5ead8464b91876a02d722b044 -#: ../src/Doc/library/email.errors.rst:64 +#: library/email.errors.rst:64 msgid "" "Here's the list of the defects that the :class:`~email.parser.FeedParser` " "can find while parsing messages. Note that the defects are added to the " @@ -35471,44 +35787,48 @@ msgid "" "not." msgstr "" -#: ../src/Doc/library/email.errors.rst:70 +#: library/email.errors.rst:70 msgid "" "All defect classes are subclassed from :class:`email.errors.MessageDefect`, " "but this class is *not* an exception!" msgstr "" -#: ../src/Doc/library/email.errors.rst:76 +#: library/email.errors.rst:73 +msgid "All the defect classes were added." +msgstr "" + +#: library/email.errors.rst:76 msgid "" ":class:`NoBoundaryInMultipartDefect` -- A message claimed to be a multipart, " "but had no :mimetype:`boundary` parameter." msgstr "" -#: ../src/Doc/library/email.errors.rst:79 +#: library/email.errors.rst:79 msgid "" ":class:`StartBoundaryNotFoundDefect` -- The start boundary claimed in the :" "mailheader:`Content-Type` header was never found." msgstr "" -#: ../src/Doc/library/email.errors.rst:82 +#: library/email.errors.rst:82 msgid "" ":class:`FirstHeaderLineIsContinuationDefect` -- The message had a " "continuation line as its first header line." msgstr "" -#: ../src/Doc/library/email.errors.rst:85 +#: library/email.errors.rst:85 msgid "" ":class:`MisplacedEnvelopeHeaderDefect` - A \"Unix From\" header was found in " "the middle of a header block." msgstr "" -#: ../src/Doc/library/email.errors.rst:88 +#: library/email.errors.rst:88 msgid "" ":class:`MalformedHeaderDefect` -- A header was found that was missing a " "colon, or was otherwise malformed." msgstr "" # 0d6d916f28514f679ea6c340e040f14a -#: ../src/Doc/library/email.errors.rst:91 +#: library/email.errors.rst:91 msgid "" ":class:`MultipartInvariantViolationDefect` -- A message claimed to be a :" "mimetype:`multipart`, but no subparts were found. Note that when a message " @@ -35517,11 +35837,11 @@ msgid "" msgstr "" # b12f9053db9c45778ea740ed41b903a7 -#: ../src/Doc/library/email.generator.rst:2 +#: library/email.generator.rst:2 msgid ":mod:`email.generator`: Generating MIME documents" msgstr "" -#: ../src/Doc/library/email.generator.rst:8 +#: library/email.generator.rst:8 msgid "" "One of the most common tasks is to generate the flat text of the email " "message represented by a message object structure. You will need to do this " @@ -35532,7 +35852,7 @@ msgid "" msgstr "" # 06b7b2e04ce14e32b30fd8cd8d522e70 -#: ../src/Doc/library/email.generator.rst:14 +#: library/email.generator.rst:14 msgid "" "Again, as with the :mod:`email.parser` module, you aren't limited to the " "functionality of the bundled generator; you could write one from scratch " @@ -35546,21 +35866,21 @@ msgid "" "Message` object as defaults are filled in." msgstr "" -#: ../src/Doc/library/email.generator.rst:25 +#: library/email.generator.rst:25 msgid "" "Here are the public methods of the :class:`Generator` class, imported from " "the :mod:`email.generator` module:" msgstr "" # 5c952eb03e2048a48d1ccc2d3d5f4b55 -#: ../src/Doc/library/email.generator.rst:31 +#: library/email.generator.rst:31 msgid "" "The constructor for the :class:`Generator` class takes a file-like object " "called *outfp* for an argument. *outfp* must support the :meth:`write` " "method and be usable as the output file in a Python extended print statement." msgstr "" -#: ../src/Doc/library/email.generator.rst:35 +#: library/email.generator.rst:35 msgid "" "Optional *mangle_from_* is a flag that, when ``True``, puts a ``>`` " "character in front of any line in the body that starts exactly as ``From``, " @@ -35572,7 +35892,7 @@ msgid "" "``False`` if you are not writing Unix mailbox format files." msgstr "" -#: ../src/Doc/library/email.generator.rst:44 +#: library/email.generator.rst:44 msgid "" "Optional *maxheaderlen* specifies the longest length for a non-continued " "header. When a header line is longer than *maxheaderlen* (in characters, " @@ -35581,11 +35901,11 @@ msgid "" "The default is 78, as recommended (but not required) by :rfc:`2822`." msgstr "" -#: ../src/Doc/library/email.generator.rst:50 +#: library/email.generator.rst:50 msgid "The other public :class:`Generator` methods are:" msgstr "" -#: ../src/Doc/library/email.generator.rst:55 +#: library/email.generator.rst:55 msgid "" "Print the textual representation of the message object structure rooted at " "*msg* to the output file specified when the :class:`Generator` instance was " @@ -35593,7 +35913,7 @@ msgid "" "properly MIME encoded." msgstr "" -#: ../src/Doc/library/email.generator.rst:60 +#: library/email.generator.rst:60 msgid "" "Optional *unixfrom* is a flag that forces the printing of the envelope " "header delimiter before the first :rfc:`2822` header of the root message " @@ -35602,25 +35922,25 @@ msgid "" "the envelope delimiter." msgstr "" -#: ../src/Doc/library/email.generator.rst:66 +#: library/email.generator.rst:66 msgid "Note that for subparts, no envelope header is ever printed." msgstr "" -#: ../src/Doc/library/email.generator.rst:73 +#: library/email.generator.rst:73 msgid "" "Return an independent clone of this :class:`Generator` instance with the " "exact same options." msgstr "" # 2b5ed3e8115e47e68db4bf544248861b -#: ../src/Doc/library/email.generator.rst:81 +#: library/email.generator.rst:81 msgid "" "Write the string *s* to the underlying file object, i.e. *outfp* passed to :" "class:`Generator`'s constructor. This provides just enough file-like API " "for :class:`Generator` instances to be used in extended print statements." msgstr "" -#: ../src/Doc/library/email.generator.rst:85 +#: library/email.generator.rst:85 msgid "" "As a convenience, see the methods :meth:`Message.as_string` and " "``str(aMessage)``, a.k.a. :meth:`Message.__str__`, which simplify the " @@ -35628,7 +35948,7 @@ msgid "" "more detail, see :mod:`email.message`." msgstr "" -#: ../src/Doc/library/email.generator.rst:90 +#: library/email.generator.rst:90 msgid "" "The :mod:`email.generator` module also provides a derived class, called :" "class:`DecodedGenerator` which is like the :class:`Generator` base class, " @@ -35636,7 +35956,7 @@ msgid "" "string representing the part." msgstr "" -#: ../src/Doc/library/email.generator.rst:98 +#: library/email.generator.rst:98 msgid "" "This class, derived from :class:`Generator` walks through all the subparts " "of a message. If the subpart is of main type :mimetype:`text`, then it " @@ -35644,46 +35964,50 @@ msgid "" "*maxheaderlen* are as with the :class:`Generator` base class." msgstr "" -#: ../src/Doc/library/email.generator.rst:103 +#: library/email.generator.rst:103 msgid "" "If the subpart is not of main type :mimetype:`text`, optional *fmt* is a " "format string that is used instead of the message payload. *fmt* is expanded " "with the following keywords, ``%(keyword)s`` format:" msgstr "" -#: ../src/Doc/library/email.generator.rst:107 +#: library/email.generator.rst:107 msgid "``type`` -- Full MIME type of the non-\\ :mimetype:`text` part" msgstr "" -#: ../src/Doc/library/email.generator.rst:109 +#: library/email.generator.rst:109 msgid "``maintype`` -- Main MIME type of the non-\\ :mimetype:`text` part" msgstr "" -#: ../src/Doc/library/email.generator.rst:111 +#: library/email.generator.rst:111 msgid "``subtype`` -- Sub-MIME type of the non-\\ :mimetype:`text` part" msgstr "" -#: ../src/Doc/library/email.generator.rst:113 +#: library/email.generator.rst:113 msgid "``filename`` -- Filename of the non-\\ :mimetype:`text` part" msgstr "" -#: ../src/Doc/library/email.generator.rst:115 +#: library/email.generator.rst:115 msgid "" "``description`` -- Description associated with the non-\\ :mimetype:`text` " "part" msgstr "" -#: ../src/Doc/library/email.generator.rst:117 +#: library/email.generator.rst:117 msgid "" "``encoding`` -- Content transfer encoding of the non-\\ :mimetype:`text` part" msgstr "" -#: ../src/Doc/library/email.generator.rst:119 +#: library/email.generator.rst:119 msgid "The default value for *fmt* is ``None``, meaning ::" msgstr "" +#: library/email.generator.rst:125 +msgid "The previously deprecated method :meth:`__call__` was removed." +msgstr "" + # 4df7fe2edbcb4263aeb752a0fa7cd096 -#: ../src/Doc/library/email.generator.rst:131 +#: library/email.generator.rst:131 msgid "" "This statement assumes that you use the appropriate setting for the " "``unixfrom`` argument, and that you set maxheaderlen=0 (which will preserve " @@ -35693,11 +36017,11 @@ msgid "" msgstr "" # 10273483814940d59545d836bcf937a4 -#: ../src/Doc/library/email.header.rst:2 +#: library/email.header.rst:2 msgid ":mod:`email.header`: Internationalized headers" msgstr "" -#: ../src/Doc/library/email.header.rst:8 +#: library/email.header.rst:8 msgid "" ":rfc:`2822` is the base standard that describes the format of email " "messages. It derives from the older :rfc:`822` standard which came into " @@ -35706,7 +36030,7 @@ msgid "" "bit ASCII characters." msgstr "" -#: ../src/Doc/library/email.header.rst:13 +#: library/email.header.rst:13 msgid "" "Of course, as email has been deployed worldwide, it has become " "internationalized, such that language specific character sets can now be " @@ -35718,7 +36042,7 @@ msgid "" "these standards in its :mod:`email.header` and :mod:`email.charset` modules." msgstr "" -#: ../src/Doc/library/email.header.rst:22 +#: library/email.header.rst:22 msgid "" "If you want to include non-ASCII characters in your email headers, say in " "the :mailheader:`Subject` or :mailheader:`To` fields, you should use the :" @@ -35728,7 +36052,7 @@ msgid "" "header` module. For example::" msgstr "" -#: ../src/Doc/library/email.header.rst:39 +#: library/email.header.rst:39 msgid "" "Notice here how we wanted the :mailheader:`Subject` field to contain a non-" "ASCII character? We did this by creating a :class:`Header` instance and " @@ -35738,18 +36062,18 @@ msgid "" "mail readers would show this header using the embedded ISO-8859-1 character." msgstr "" -#: ../src/Doc/library/email.header.rst:48 +#: library/email.header.rst:48 msgid "Here is the :class:`Header` class description:" msgstr "" -#: ../src/Doc/library/email.header.rst:53 +#: library/email.header.rst:53 msgid "" "Create a MIME-compliant header that can contain strings in different " "character sets." msgstr "" # 1735d496fe9e4334aa56906cf15063bb -#: ../src/Doc/library/email.header.rst:56 +#: library/email.header.rst:56 msgid "" "Optional *s* is the initial header value. If ``None`` (the default), the " "initial header value is not set. You can later append to the header with :" @@ -35757,7 +36081,7 @@ msgid "" "but see the :meth:`append` documentation for semantics." msgstr "" -#: ../src/Doc/library/email.header.rst:61 +#: library/email.header.rst:61 msgid "" "Optional *charset* serves two purposes: it has the same meaning as the " "*charset* argument to the :meth:`append` method. It also sets the default " @@ -35768,7 +36092,7 @@ msgid "" msgstr "" # 198e9bd5d30d459780df2f27877a5290 -#: ../src/Doc/library/email.header.rst:68 +#: library/email.header.rst:68 msgid "" "The maximum line length can be specified explicitly via *maxlinelen*. For " "splitting the first line to a shorter value (to account for the field header " @@ -35779,7 +36103,7 @@ msgid "" msgstr "" # 321fc51bb07e45b0b00c0791f3e2ee0a -#: ../src/Doc/library/email.header.rst:75 +#: library/email.header.rst:75 msgid "" "Optional *continuation_ws* must be :rfc:`2822`\\ -compliant folding " "whitespace, and is usually either a space or a hard tab character. This " @@ -35787,16 +36111,16 @@ msgid "" "defaults to a single space character (\" \")." msgstr "" -#: ../src/Doc/library/email.header.rst:80 +#: library/email.header.rst:80 msgid "" "Optional *errors* is passed straight through to the :meth:`append` method." msgstr "" -#: ../src/Doc/library/email.header.rst:85 +#: library/email.header.rst:85 msgid "Append the string *s* to the MIME header." msgstr "" -#: ../src/Doc/library/email.header.rst:87 +#: library/email.header.rst:87 msgid "" "Optional *charset*, if given, should be a :class:`~email.charset.Charset` " "instance (see :mod:`email.charset`) or the name of a character set, which " @@ -35806,7 +36130,7 @@ msgid "" msgstr "" # 60473e70b8d54894afe0ca84af96c308 -#: ../src/Doc/library/email.header.rst:93 +#: library/email.header.rst:93 msgid "" "*s* may be a byte string or a Unicode string. If it is a byte string (i.e. " "``isinstance(s, str)`` is true), then *charset* is the encoding of that byte " @@ -35815,7 +36139,7 @@ msgid "" msgstr "" # 60851647bad34536aa2e1a1d7108f0d5 -#: ../src/Doc/library/email.header.rst:98 +#: library/email.header.rst:98 msgid "" "If *s* is a Unicode string, then *charset* is a hint specifying the " "character set of the characters in the string. In this case, when producing " @@ -35826,13 +36150,13 @@ msgid "" msgstr "" # 57d1ee2b89764502ab75627badbd3411 -#: ../src/Doc/library/email.header.rst:105 +#: library/email.header.rst:105 msgid "" "Optional *errors* is passed through to any :func:`unicode` or :meth:`unicode." "encode` call, and defaults to \"strict\"." msgstr "" -#: ../src/Doc/library/email.header.rst:111 +#: library/email.header.rst:111 msgid "" "Encode a message header into an RFC-compliant format, possibly wrapping long " "lines and encapsulating non-ASCII parts in base64 or quoted-printable " @@ -35841,47 +36165,47 @@ msgid "" "syntactic breaks*. This doesn't affect :rfc:`2047` encoded lines." msgstr "" -#: ../src/Doc/library/email.header.rst:117 +#: library/email.header.rst:117 msgid "" "The :class:`Header` class also provides a number of methods to support " "standard operators and built-in functions." msgstr "" -#: ../src/Doc/library/email.header.rst:123 +#: library/email.header.rst:123 msgid "A synonym for :meth:`Header.encode`. Useful for ``str(aHeader)``." msgstr "" # 5dcf1da973b444ffbb2d0648a877afdc -#: ../src/Doc/library/email.header.rst:128 +#: library/email.header.rst:128 msgid "" "A helper for the built-in :func:`unicode` function. Returns the header as a " "Unicode string." msgstr "" -#: ../src/Doc/library/email.header.rst:134 +#: library/email.header.rst:134 msgid "" "This method allows you to compare two :class:`Header` instances for equality." msgstr "" -#: ../src/Doc/library/email.header.rst:140 +#: library/email.header.rst:140 msgid "" "This method allows you to compare two :class:`Header` instances for " "inequality." msgstr "" -#: ../src/Doc/library/email.header.rst:143 +#: library/email.header.rst:143 msgid "" "The :mod:`email.header` module also provides the following convenient " "functions." msgstr "" -#: ../src/Doc/library/email.header.rst:148 +#: library/email.header.rst:148 msgid "" "Decode a message header value without converting the character set. The " "header value is in *header*." msgstr "" -#: ../src/Doc/library/email.header.rst:151 +#: library/email.header.rst:151 msgid "" "This function returns a list of ``(decoded_string, charset)`` pairs " "containing each of the decoded parts of the header. *charset* is ``None`` " @@ -35889,25 +36213,24 @@ msgid "" "containing the name of the character set specified in the encoded string." msgstr "" -#: ../src/Doc/library/email.header.rst:156 -#: ../src/Doc/library/email.message.rst:290 +#: library/email.header.rst:156 library/email.message.rst:290 msgid "Here's an example::" msgstr "" -#: ../src/Doc/library/email.header.rst:165 +#: library/email.header.rst:165 msgid "" "Create a :class:`Header` instance from a sequence of pairs as returned by :" "func:`decode_header`." msgstr "" -#: ../src/Doc/library/email.header.rst:168 +#: library/email.header.rst:168 msgid "" ":func:`decode_header` takes a header value string and returns a sequence of " "pairs of the format ``(decoded_string, charset)`` where *charset* is the " "name of the character set." msgstr "" -#: ../src/Doc/library/email.header.rst:172 +#: library/email.header.rst:172 msgid "" "This function takes one of those sequence of pairs and returns a :class:" "`Header` instance. Optional *maxlinelen*, *header_name*, and " @@ -35915,12 +36238,12 @@ msgid "" msgstr "" # c6a34a744a404a51bc818e82209f35f9 -#: ../src/Doc/library/email.iterators.rst:2 +#: library/email.iterators.rst:2 msgid ":mod:`email.iterators`: Iterators" msgstr "" # 2548c76b605a4a85b8cbb9a81e8185f0 -#: ../src/Doc/library/email.iterators.rst:8 +#: library/email.iterators.rst:8 msgid "" "Iterating over a message object tree is fairly easy with the :meth:`Message." "walk ` method. The :mod:`email.iterators` " @@ -35929,7 +36252,7 @@ msgid "" msgstr "" # 47bdce077fe1429c87d40522e4aecb5b -#: ../src/Doc/library/email.iterators.rst:16 +#: library/email.iterators.rst:16 msgid "" "This iterates over all the payloads in all the subparts of *msg*, returning " "the string payloads line-by-line. It skips over all the subpart headers, " @@ -35940,56 +36263,56 @@ msgid "" msgstr "" # d56b474959794da58f323334cb8f32bd -#: ../src/Doc/library/email.iterators.rst:23 +#: library/email.iterators.rst:23 msgid "" "Optional *decode* is passed through to :meth:`Message.get_payload `." msgstr "" -#: ../src/Doc/library/email.iterators.rst:29 +#: library/email.iterators.rst:29 msgid "" "This iterates over all the subparts of *msg*, returning only those subparts " "that match the MIME type specified by *maintype* and *subtype*." msgstr "" -#: ../src/Doc/library/email.iterators.rst:32 +#: library/email.iterators.rst:32 msgid "" "Note that *subtype* is optional; if omitted, then subpart MIME type matching " "is done only with the main type. *maintype* is optional too; it defaults " "to :mimetype:`text`." msgstr "" -#: ../src/Doc/library/email.iterators.rst:36 +#: library/email.iterators.rst:36 msgid "" "Thus, by default :func:`typed_subpart_iterator` returns each subpart that " "has a MIME type of :mimetype:`text/\\*`." msgstr "" -#: ../src/Doc/library/email.iterators.rst:39 +#: library/email.iterators.rst:39 msgid "" "The following function has been added as a useful debugging tool. It should " "*not* be considered part of the supported public interface for the package." msgstr "" -#: ../src/Doc/library/email.iterators.rst:45 +#: library/email.iterators.rst:45 msgid "" "Prints an indented representation of the content types of the message object " "structure. For example::" msgstr "" # b36ddd0bf0184eadab8fe731e8cf54a3 -#: ../src/Doc/library/email.iterators.rst:66 +#: library/email.iterators.rst:66 msgid "" "Optional *fp* is a file-like object to print the output to. It must be " "suitable for Python's extended print statement. *level* is used internally." msgstr "" # 4c7106ae39ab4c0381cfd6f2489322ef -#: ../src/Doc/library/email.message.rst:2 +#: library/email.message.rst:2 msgid ":mod:`email.message`: Representing an email message" msgstr "" -#: ../src/Doc/library/email.message.rst:8 +#: library/email.message.rst:8 msgid "" "The central class in the :mod:`email` package is the :class:`Message` class, " "imported from the :mod:`email.message` module. It is the base class for " @@ -35998,7 +36321,7 @@ msgid "" "message bodies." msgstr "" -#: ../src/Doc/library/email.message.rst:13 +#: library/email.message.rst:13 msgid "" "Conceptually, a :class:`Message` object consists of *headers* and " "*payloads*. Headers are :rfc:`2822` style field names and values where the " @@ -36006,7 +36329,7 @@ msgid "" "either the field name or the field value." msgstr "" -#: ../src/Doc/library/email.message.rst:18 +#: library/email.message.rst:18 msgid "" "Headers are stored and returned in case-preserving form but are matched case-" "insensitively. There may also be a single envelope header, also known as " @@ -36016,7 +36339,7 @@ msgid "" "mimetype:`message/rfc822`)." msgstr "" -#: ../src/Doc/library/email.message.rst:25 +#: library/email.message.rst:25 msgid "" ":class:`Message` objects provide a mapping style interface for accessing the " "message headers, and an explicit interface for accessing both the headers " @@ -36025,15 +36348,15 @@ msgid "" "header parameters, and for recursively walking over the object tree." msgstr "" -#: ../src/Doc/library/email.message.rst:31 +#: library/email.message.rst:31 msgid "Here are the methods of the :class:`Message` class:" msgstr "" -#: ../src/Doc/library/email.message.rst:36 +#: library/email.message.rst:36 msgid "The constructor takes no arguments." msgstr "" -#: ../src/Doc/library/email.message.rst:41 +#: library/email.message.rst:41 msgid "" "Return the entire message flattened as a string. When optional *unixfrom* " "is ``True``, the envelope header is included in the returned string. " @@ -36044,7 +36367,7 @@ msgid "" msgstr "" # a99bc5f081284f37b55a5cba612e1722 -#: ../src/Doc/library/email.message.rst:48 +#: library/email.message.rst:48 msgid "" "Note that this method is provided as a convenience and may not always format " "the message the way you want. For example, by default it mangles lines that " @@ -36053,30 +36376,30 @@ msgid "" "flatten` method directly. For example::" msgstr "" -#: ../src/Doc/library/email.message.rst:64 +#: library/email.message.rst:64 msgid "Equivalent to ``as_string(unixfrom=True)``." msgstr "" # 41196368ab7b4772968415a308c21ff1 -#: ../src/Doc/library/email.message.rst:69 +#: library/email.message.rst:69 msgid "" "Return ``True`` if the message's payload is a list of sub-\\ :class:" "`Message` objects, otherwise return ``False``. When :meth:`is_multipart` " "returns ``False``, the payload should be a string object." msgstr "" -#: ../src/Doc/library/email.message.rst:76 +#: library/email.message.rst:76 msgid "" "Set the message's envelope header to *unixfrom*, which should be a string." msgstr "" -#: ../src/Doc/library/email.message.rst:81 +#: library/email.message.rst:81 msgid "" "Return the message's envelope header. Defaults to ``None`` if the envelope " "header was never set." msgstr "" -#: ../src/Doc/library/email.message.rst:87 +#: library/email.message.rst:87 msgid "" "Add the given *payload* to the current payload, which must be ``None`` or a " "list of :class:`Message` objects before the call. After the call, the " @@ -36085,7 +36408,7 @@ msgid "" "instead." msgstr "" -#: ../src/Doc/library/email.message.rst:96 +#: library/email.message.rst:96 msgid "" "Return the current payload, which will be a list of :class:`Message` objects " "when :meth:`is_multipart` is ``True``, or a string when :meth:`is_multipart` " @@ -36093,7 +36416,7 @@ msgid "" "modify the message's payload in place." msgstr "" -#: ../src/Doc/library/email.message.rst:101 +#: library/email.message.rst:101 msgid "" "With optional argument *i*, :meth:`get_payload` will return the *i*-th " "element of the payload, counting from zero, if :meth:`is_multipart` is " @@ -36103,7 +36426,7 @@ msgid "" "exc:`TypeError` is raised." msgstr "" -#: ../src/Doc/library/email.message.rst:108 +#: library/email.message.rst:108 msgid "" "Optional *decode* is a flag indicating whether the payload should be decoded " "or not, according to the :mailheader:`Content-Transfer-Encoding` header. " @@ -36116,15 +36439,19 @@ msgid "" "``False``." msgstr "" -#: ../src/Doc/library/email.message.rst:121 +#: library/email.message.rst:121 msgid "" "Set the entire message object's payload to *payload*. It is the client's " "responsibility to ensure the payload invariants. Optional *charset* sets " "the message's default character set; see :meth:`set_charset` for details." msgstr "" +#: library/email.message.rst:125 +msgid "*charset* argument added." +msgstr "" + # 75eda45f0b8345c3bb26f3eec3fb03aa -#: ../src/Doc/library/email.message.rst:131 +#: library/email.message.rst:131 msgid "" "Set the character set of the payload to *charset*, which can either be a :" "class:`~email.charset.Charset` instance (see :mod:`email.charset`), a string " @@ -36136,7 +36463,7 @@ msgid "" msgstr "" # 3304ad5d3e944674a97d7d747d74bff7 -#: ../src/Doc/library/email.message.rst:139 +#: library/email.message.rst:139 msgid "" "If there is no existing :mailheader:`MIME-Version` header one will be " "added. If there is no existing :mailheader:`Content-Type` header, one will " @@ -36154,7 +36481,7 @@ msgid "" msgstr "" # ef7052ed09ca40beaa8c65e4c5dd916b -#: ../src/Doc/library/email.message.rst:153 +#: library/email.message.rst:153 msgid "" "The message will be assumed to be of type :mimetype:`text/\\*`, with the " "payload either in unicode or encoded with *charset.input_charset*. It will " @@ -36164,13 +36491,13 @@ msgid "" "Type`, :mailheader:`Content-Transfer-Encoding`) will be added as needed." msgstr "" -#: ../src/Doc/library/email.message.rst:166 +#: library/email.message.rst:166 msgid "" "Return the :class:`~email.charset.Charset` instance associated with the " "message's payload." msgstr "" -#: ../src/Doc/library/email.message.rst:171 +#: library/email.message.rst:171 msgid "" "The following methods implement a mapping-like interface for accessing the " "message's :rfc:`2822` headers. Note that there are some semantic " @@ -36183,37 +36510,37 @@ msgid "" "deleted and then re-added are always appended to the end of the header list." msgstr "" -#: ../src/Doc/library/email.message.rst:181 +#: library/email.message.rst:181 msgid "" "These semantic differences are intentional and are biased toward maximal " "convenience." msgstr "" -#: ../src/Doc/library/email.message.rst:184 +#: library/email.message.rst:184 msgid "" "Note that in all cases, any envelope header present in the message is not " "included in the mapping interface." msgstr "" -#: ../src/Doc/library/email.message.rst:190 +#: library/email.message.rst:190 msgid "Return the total number of headers, including duplicates." msgstr "" -#: ../src/Doc/library/email.message.rst:195 +#: library/email.message.rst:195 msgid "" "Return true if the message object has a field named *name*. Matching is done " "case-insensitively and *name* should not include the trailing colon. Used " "for the ``in`` operator, e.g.::" msgstr "" -#: ../src/Doc/library/email.message.rst:205 +#: library/email.message.rst:205 msgid "" "Return the value of the named header field. *name* should not include the " "colon field separator. If the header is missing, ``None`` is returned; a :" "exc:`KeyError` is never raised." msgstr "" -#: ../src/Doc/library/email.message.rst:209 +#: library/email.message.rst:209 msgid "" "Note that if the named field appears more than once in the message's " "headers, exactly which of those field values will be returned is undefined. " @@ -36221,65 +36548,65 @@ msgid "" "headers." msgstr "" -#: ../src/Doc/library/email.message.rst:217 +#: library/email.message.rst:217 msgid "" "Add a header to the message with field name *name* and value *val*. The " "field is appended to the end of the message's existing fields." msgstr "" -#: ../src/Doc/library/email.message.rst:220 +#: library/email.message.rst:220 msgid "" "Note that this does *not* overwrite or delete any existing header with the " "same name. If you want to ensure that the new header is the only one " "present in the message with field name *name*, delete the field first, e.g.::" msgstr "" -#: ../src/Doc/library/email.message.rst:230 +#: library/email.message.rst:230 msgid "" "Delete all occurrences of the field with name *name* from the message's " "headers. No exception is raised if the named field isn't present in the " "headers." msgstr "" -#: ../src/Doc/library/email.message.rst:236 +#: library/email.message.rst:236 msgid "" "Return true if the message contains a header field named *name*, otherwise " "return false." msgstr "" -#: ../src/Doc/library/email.message.rst:242 +#: library/email.message.rst:242 msgid "Return a list of all the message's header field names." msgstr "" -#: ../src/Doc/library/email.message.rst:247 +#: library/email.message.rst:247 msgid "Return a list of all the message's field values." msgstr "" -#: ../src/Doc/library/email.message.rst:252 +#: library/email.message.rst:252 msgid "" "Return a list of 2-tuples containing all the message's field headers and " "values." msgstr "" -#: ../src/Doc/library/email.message.rst:258 +#: library/email.message.rst:258 msgid "" "Return the value of the named header field. This is identical to :meth:" "`__getitem__` except that optional *failobj* is returned if the named header " "is missing (defaults to ``None``)." msgstr "" -#: ../src/Doc/library/email.message.rst:262 +#: library/email.message.rst:262 msgid "Here are some additional useful methods:" msgstr "" -#: ../src/Doc/library/email.message.rst:267 +#: library/email.message.rst:267 msgid "" "Return a list of all the values for the field named *name*. If there are no " "such named headers in the message, *failobj* is returned (defaults to " "``None``)." msgstr "" -#: ../src/Doc/library/email.message.rst:274 +#: library/email.message.rst:274 msgid "" "Extended header setting. This method is similar to :meth:`__setitem__` " "except that additional header parameters can be provided as keyword " @@ -36288,7 +36615,7 @@ msgid "" msgstr "" # a25218f877204109a0f3240bf171cb5f -#: ../src/Doc/library/email.message.rst:279 +#: library/email.message.rst:279 msgid "" "For each item in the keyword argument dictionary *_params*, the key is taken " "as the parameter name, with underscores converted to dashes (since dashes " @@ -36302,28 +36629,28 @@ msgid "" "containing non-ASCII code points." msgstr "" -#: ../src/Doc/library/email.message.rst:294 +#: library/email.message.rst:294 msgid "This will add a header that looks like ::" msgstr "" # b385c9426128407289e1eec73bac4e1c -#: ../src/Doc/library/email.message.rst:298 +#: library/email.message.rst:298 msgid "An example with non-ASCII characters::" msgstr "" # 50a0140845cc4146b228325ed590c6e0 -#: ../src/Doc/library/email.message.rst:303 +#: library/email.message.rst:303 msgid "Which produces ::" msgstr "" -#: ../src/Doc/library/email.message.rst:310 +#: library/email.message.rst:310 msgid "" "Replace a header. Replace the first header found in the message that " "matches *_name*, retaining header order and field name case. If no matching " "header was found, a :exc:`KeyError` is raised." msgstr "" -#: ../src/Doc/library/email.message.rst:319 +#: library/email.message.rst:319 msgid "" "Return the message's content type. The returned string is coerced to lower " "case of the form :mimetype:`maintype/subtype`. If there was no :mailheader:" @@ -36333,7 +36660,7 @@ msgid "" "return a value." msgstr "" -#: ../src/Doc/library/email.message.rst:326 +#: library/email.message.rst:326 msgid "" ":rfc:`2045` defines a message's default type to be :mimetype:`text/plain` " "unless it appears inside a :mimetype:`multipart/digest` container, in which " @@ -36342,19 +36669,19 @@ msgid "" "the default type be :mimetype:`text/plain`." msgstr "" -#: ../src/Doc/library/email.message.rst:337 +#: library/email.message.rst:337 msgid "" "Return the message's main content type. This is the :mimetype:`maintype` " "part of the string returned by :meth:`get_content_type`." msgstr "" -#: ../src/Doc/library/email.message.rst:345 +#: library/email.message.rst:345 msgid "" "Return the message's sub-content type. This is the :mimetype:`subtype` part " "of the string returned by :meth:`get_content_type`." msgstr "" -#: ../src/Doc/library/email.message.rst:353 +#: library/email.message.rst:353 msgid "" "Return the default content type. Most messages have a default content type " "of :mimetype:`text/plain`, except for messages that are subparts of :" @@ -36362,14 +36689,14 @@ msgid "" "content type of :mimetype:`message/rfc822`." msgstr "" -#: ../src/Doc/library/email.message.rst:363 +#: library/email.message.rst:363 msgid "" "Set the default content type. *ctype* should either be :mimetype:`text/" "plain` or :mimetype:`message/rfc822`, although this is not enforced. The " "default content type is not stored in the :mailheader:`Content-Type` header." msgstr "" -#: ../src/Doc/library/email.message.rst:373 +#: library/email.message.rst:373 msgid "" "Return the message's :mailheader:`Content-Type` parameters, as a list. The " "elements of the returned list are 2-tuples of key/value pairs, as split on " @@ -36379,14 +36706,18 @@ msgid "" "`get_param` and is unquoted if optional *unquote* is ``True`` (the default)." msgstr "" -#: ../src/Doc/library/email.message.rst:381 +#: library/email.message.rst:381 msgid "" "Optional *failobj* is the object to return if there is no :mailheader:" "`Content-Type` header. Optional *header* is the header to search instead " "of :mailheader:`Content-Type`." msgstr "" -#: ../src/Doc/library/email.message.rst:391 +#: library/email.message.rst:385 +msgid "*unquote* argument added." +msgstr "" + +#: library/email.message.rst:391 msgid "" "Return the value of the :mailheader:`Content-Type` header's parameter " "*param* as a string. If the message has no :mailheader:`Content-Type` " @@ -36394,13 +36725,13 @@ msgid "" "(defaults to ``None``)." msgstr "" -#: ../src/Doc/library/email.message.rst:396 +#: library/email.message.rst:396 msgid "" "Optional *header* if given, specifies the message header to use instead of :" "mailheader:`Content-Type`." msgstr "" -#: ../src/Doc/library/email.message.rst:399 +#: library/email.message.rst:399 msgid "" "Parameter keys are always compared case insensitively. The return value can " "either be a string, or a 3-tuple if the parameter was :rfc:`2231` encoded. " @@ -36411,7 +36742,7 @@ msgid "" msgstr "" # 41699c62f9d842ed9fecfe6ea0056462 -#: ../src/Doc/library/email.message.rst:407 +#: library/email.message.rst:407 msgid "" "If your application doesn't care whether the parameter was encoded as in :" "rfc:`2231`, you can collapse the parameter value by calling :func:`email." @@ -36420,14 +36751,18 @@ msgid "" "value is a tuple, or the original string unquoted if it isn't. For example::" msgstr "" -#: ../src/Doc/library/email.message.rst:417 +#: library/email.message.rst:417 msgid "" "In any case, the parameter value (either the returned string, or the " "``VALUE`` item in the 3-tuple) is always unquoted, unless *unquote* is set " "to ``False``." msgstr "" -#: ../src/Doc/library/email.message.rst:427 +#: library/email.message.rst:421 +msgid "*unquote* argument added, and 3-tuple return value possible." +msgstr "" + +#: library/email.message.rst:427 msgid "" "Set a parameter in the :mailheader:`Content-Type` header. If the parameter " "already exists in the header, its value will be replaced with *value*. If " @@ -36436,14 +36771,14 @@ msgid "" "value will be appended as per :rfc:`2045`." msgstr "" -#: ../src/Doc/library/email.message.rst:433 +#: library/email.message.rst:433 msgid "" "Optional *header* specifies an alternative header to :mailheader:`Content-" "Type`, and all parameters will be quoted as necessary unless optional " "*requote* is ``False`` (the default is ``True``)." msgstr "" -#: ../src/Doc/library/email.message.rst:437 +#: library/email.message.rst:437 msgid "" "If optional *charset* is specified, the parameter will be encoded according " "to :rfc:`2231`. Optional *language* specifies the RFC 2231 language, " @@ -36451,7 +36786,7 @@ msgid "" "strings." msgstr "" -#: ../src/Doc/library/email.message.rst:447 +#: library/email.message.rst:447 msgid "" "Remove the given parameter completely from the :mailheader:`Content-Type` " "header. The header will be re-written in place without the parameter or its " @@ -36460,14 +36795,14 @@ msgid "" "mailheader:`Content-Type`." msgstr "" -#: ../src/Doc/library/email.message.rst:458 +#: library/email.message.rst:458 msgid "" "Set the main type and subtype for the :mailheader:`Content-Type` header. " "*type* must be a string in the form :mimetype:`maintype/subtype`, otherwise " "a :exc:`ValueError` is raised." msgstr "" -#: ../src/Doc/library/email.message.rst:462 +#: library/email.message.rst:462 msgid "" "This method replaces the :mailheader:`Content-Type` header, keeping all the " "parameters in place. If *requote* is ``False``, this leaves the existing " @@ -36475,14 +36810,14 @@ msgid "" "default)." msgstr "" -#: ../src/Doc/library/email.message.rst:467 +#: library/email.message.rst:467 msgid "" "An alternative header can be specified in the *header* argument. When the :" "mailheader:`Content-Type` header is set a :mailheader:`MIME-Version` header " "is also added." msgstr "" -#: ../src/Doc/library/email.message.rst:476 +#: library/email.message.rst:476 msgid "" "Return the value of the ``filename`` parameter of the :mailheader:`Content-" "Disposition` header of the message. If the header does not have a " @@ -36492,7 +36827,7 @@ msgid "" "always be unquoted as per :func:`email.utils.unquote`." msgstr "" -#: ../src/Doc/library/email.message.rst:487 +#: library/email.message.rst:487 msgid "" "Return the value of the ``boundary`` parameter of the :mailheader:`Content-" "Type` header of the message, or *failobj* if either the header is missing, " @@ -36501,7 +36836,7 @@ msgid "" msgstr "" # bce925e9cf1844088d95a6eb6ce962c7 -#: ../src/Doc/library/email.message.rst:495 +#: library/email.message.rst:495 msgid "" "Set the ``boundary`` parameter of the :mailheader:`Content-Type` header to " "*boundary*. :meth:`set_boundary` will always quote *boundary* if " @@ -36509,7 +36844,7 @@ msgid "" "object has no :mailheader:`Content-Type` header." msgstr "" -#: ../src/Doc/library/email.message.rst:500 +#: library/email.message.rst:500 msgid "" "Note that using this method is subtly different than deleting the old :" "mailheader:`Content-Type` header and adding a new one with the new boundary " @@ -36519,28 +36854,28 @@ msgid "" "the original :mailheader:`Content-Type` header." msgstr "" -#: ../src/Doc/library/email.message.rst:510 +#: library/email.message.rst:510 msgid "" "Return the ``charset`` parameter of the :mailheader:`Content-Type` header, " "coerced to lower case. If there is no :mailheader:`Content-Type` header, or " "if that header has no ``charset`` parameter, *failobj* is returned." msgstr "" -#: ../src/Doc/library/email.message.rst:514 +#: library/email.message.rst:514 msgid "" "Note that this method differs from :meth:`get_charset` which returns the :" "class:`~email.charset.Charset` instance for the default encoding of the " "message body." msgstr "" -#: ../src/Doc/library/email.message.rst:522 +#: library/email.message.rst:522 msgid "" "Return a list containing the character set names in the message. If the " "message is a :mimetype:`multipart`, then the list will contain one element " "for each subpart in the payload, otherwise, it will be a list of length 1." msgstr "" -#: ../src/Doc/library/email.message.rst:526 +#: library/email.message.rst:526 msgid "" "Each item in the list will be a string which is the value of the ``charset`` " "parameter in the :mailheader:`Content-Type` header for the represented " @@ -36549,7 +36884,7 @@ msgid "" "then that item in the returned list will be *failobj*." msgstr "" -#: ../src/Doc/library/email.message.rst:536 +#: library/email.message.rst:536 msgid "" "The :meth:`walk` method is an all-purpose generator which can be used to " "iterate over all the parts and subparts of a message object tree, in depth-" @@ -36557,20 +36892,26 @@ msgid "" "in a ``for`` loop; each iteration returns the next subpart." msgstr "" -#: ../src/Doc/library/email.message.rst:541 +#: library/email.message.rst:541 msgid "" "Here's an example that prints the MIME type of every part of a multipart " "message structure::" msgstr "" -#: ../src/Doc/library/email.message.rst:557 +#: library/email.message.rst:553 +msgid "" +"The previously deprecated methods :meth:`get_type`, :meth:`get_main_type`, " +"and :meth:`get_subtype` were removed." +msgstr "" + +#: library/email.message.rst:557 msgid "" ":class:`Message` objects can also optionally contain two instance " "attributes, which can be used when generating the plain text of a MIME " "message." msgstr "" -#: ../src/Doc/library/email.message.rst:563 +#: library/email.message.rst:563 msgid "" "The format of a MIME document allows for some text between the blank line " "following the headers, and the first multipart boundary string. Normally, " @@ -36580,7 +36921,7 @@ msgid "" "can become visible." msgstr "" -#: ../src/Doc/library/email.message.rst:570 +#: library/email.message.rst:570 msgid "" "The *preamble* attribute contains this leading extra-armor text for MIME " "documents. When the :class:`~email.parser.Parser` discovers some text after " @@ -36592,20 +36933,26 @@ msgid "" "parser` and :mod:`email.generator` for details." msgstr "" -#: ../src/Doc/library/email.message.rst:580 +#: library/email.message.rst:580 msgid "" "Note that if the message object has no preamble, the *preamble* attribute " "will be ``None``." msgstr "" -#: ../src/Doc/library/email.message.rst:586 +#: library/email.message.rst:586 msgid "" "The *epilogue* attribute acts the same way as the *preamble* attribute, " "except that it contains text that appears between the last boundary and the " "end of the message." msgstr "" -#: ../src/Doc/library/email.message.rst:598 +#: library/email.message.rst:590 +msgid "" +"You do not need to set the epilogue to the empty string in order for the :" +"class:`~email.generator.Generator` to print a newline at the end of the file." +msgstr "" + +#: library/email.message.rst:598 msgid "" "The *defects* attribute contains a list of all the problems found when " "parsing this message. See :mod:`email.errors` for a detailed description of " @@ -36613,11 +36960,11 @@ msgid "" msgstr "" # bef154904d044125954c8bc603945206 -#: ../src/Doc/library/email.mime.rst:2 +#: library/email.mime.rst:2 msgid ":mod:`email.mime`: Creating email and MIME objects from scratch" msgstr "" -#: ../src/Doc/library/email.mime.rst:8 +#: library/email.mime.rst:8 msgid "" "Ordinarily, you get a message object structure by passing a file or some " "text to a parser, which parses the text and returns the root message " @@ -36628,7 +36975,7 @@ msgid "" "convenient interface for slicing-and-dicing MIME messages." msgstr "" -#: ../src/Doc/library/email.mime.rst:16 +#: library/email.mime.rst:16 msgid "" "You can create a new object structure by creating :class:`~email.message." "Message` instances, adding attachments and all the appropriate headers " @@ -36636,15 +36983,15 @@ msgid "" "convenient subclasses to make things easier." msgstr "" -#: ../src/Doc/library/email.mime.rst:21 +#: library/email.mime.rst:21 msgid "Here are the classes:" msgstr "" -#: ../src/Doc/library/email.mime.rst:27 +#: library/email.mime.rst:27 msgid "Module: :mod:`email.mime.base`" msgstr "" -#: ../src/Doc/library/email.mime.rst:29 +#: library/email.mime.rst:29 msgid "" "This is the base class for all the MIME-specific subclasses of :class:" "`~email.message.Message`. Ordinarily you won't create instances " @@ -36654,7 +37001,7 @@ msgid "" msgstr "" # 0f7f024b21ba41e7bd18186bd6f2d9fd -#: ../src/Doc/library/email.mime.rst:35 +#: library/email.mime.rst:35 msgid "" "*_maintype* is the :mailheader:`Content-Type` major type (e.g. :mimetype:" "`text` or :mimetype:`image`), and *_subtype* is the :mailheader:`Content-" @@ -36663,19 +37010,19 @@ msgid "" "add_header `." msgstr "" -#: ../src/Doc/library/email.mime.rst:41 +#: library/email.mime.rst:41 msgid "" "The :class:`MIMEBase` class always adds a :mailheader:`Content-Type` header " "(based on *_maintype*, *_subtype*, and *_params*), and a :mailheader:`MIME-" "Version` header (always set to ``1.0``)." msgstr "" -#: ../src/Doc/library/email.mime.rst:50 +#: library/email.mime.rst:50 msgid "Module: :mod:`email.mime.nonmultipart`" msgstr "" # f525b7034d6949dbb319cc38f3a3ddb1 -#: ../src/Doc/library/email.mime.rst:52 +#: library/email.mime.rst:52 msgid "" "A subclass of :class:`~email.mime.base.MIMEBase`, this is an intermediate " "base class for MIME messages that are not :mimetype:`multipart`. The " @@ -36685,11 +37032,11 @@ msgid "" "a :exc:`~email.errors.MultipartConversionError` exception is raised." msgstr "" -#: ../src/Doc/library/email.mime.rst:66 +#: library/email.mime.rst:66 msgid "Module: :mod:`email.mime.multipart`" msgstr "" -#: ../src/Doc/library/email.mime.rst:68 +#: library/email.mime.rst:68 msgid "" "A subclass of :class:`~email.mime.base.MIMEBase`, this is an intermediate " "base class for MIME messages that are :mimetype:`multipart`. Optional " @@ -36699,7 +37046,7 @@ msgid "" "`MIME-Version` header will also be added." msgstr "" -#: ../src/Doc/library/email.mime.rst:75 +#: library/email.mime.rst:75 msgid "" "Optional *boundary* is the multipart boundary string. When ``None`` (the " "default), the boundary is calculated when needed (for example, when the " @@ -36707,7 +37054,7 @@ msgid "" msgstr "" # e0020dabf04a4bcabcc5d2ff3f244b28 -#: ../src/Doc/library/email.mime.rst:79 +#: library/email.mime.rst:79 msgid "" "*_subparts* is a sequence of initial subparts for the payload. It must be " "possible to convert this sequence to a list. You can always attach new " @@ -36715,18 +37062,18 @@ msgid "" "Message.attach>` method." msgstr "" -#: ../src/Doc/library/email.mime.rst:84 +#: library/email.mime.rst:84 msgid "" "Additional parameters for the :mailheader:`Content-Type` header are taken " "from the keyword arguments, or passed into the *_params* argument, which is " "a keyword dictionary." msgstr "" -#: ../src/Doc/library/email.mime.rst:95 +#: library/email.mime.rst:95 msgid "Module: :mod:`email.mime.application`" msgstr "" -#: ../src/Doc/library/email.mime.rst:97 +#: library/email.mime.rst:97 msgid "" "A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" "`MIMEApplication` class is used to represent MIME message objects of major " @@ -36736,7 +37083,7 @@ msgid "" msgstr "" # 20930e2d341d471f847264c6db8ba056 -#: ../src/Doc/library/email.mime.rst:103 +#: library/email.mime.rst:103 msgid "" "Optional *_encoder* is a callable (i.e. function) which will perform the " "actual encoding of the data for transport. This callable takes one " @@ -36748,15 +37095,15 @@ msgid "" "encoders` module for a list of the built-in encoders." msgstr "" -#: ../src/Doc/library/email.mime.rst:113 ../src/Doc/library/email.mime.rst:143 +#: library/email.mime.rst:113 library/email.mime.rst:143 msgid "*_params* are passed straight through to the base class constructor." msgstr "" -#: ../src/Doc/library/email.mime.rst:122 +#: library/email.mime.rst:122 msgid "Module: :mod:`email.mime.audio`" msgstr "" -#: ../src/Doc/library/email.mime.rst:124 +#: library/email.mime.rst:124 msgid "" "A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" "`MIMEAudio` class is used to create MIME message objects of major type :" @@ -36769,7 +37116,7 @@ msgid "" msgstr "" # 533a73a4c4ab402aa44c4fc5b9ee79a7 -#: ../src/Doc/library/email.mime.rst:133 +#: library/email.mime.rst:133 msgid "" "Optional *_encoder* is a callable (i.e. function) which will perform the " "actual encoding of the audio data for transport. This callable takes one " @@ -36781,11 +37128,11 @@ msgid "" "encoders` module for a list of the built-in encoders." msgstr "" -#: ../src/Doc/library/email.mime.rst:150 +#: library/email.mime.rst:150 msgid "Module: :mod:`email.mime.image`" msgstr "" -#: ../src/Doc/library/email.mime.rst:152 +#: library/email.mime.rst:152 msgid "" "A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" "`MIMEImage` class is used to create MIME message objects of major type :" @@ -36798,7 +37145,7 @@ msgid "" msgstr "" # b1a22105702044d9ac582166a280de5a -#: ../src/Doc/library/email.mime.rst:161 +#: library/email.mime.rst:161 msgid "" "Optional *_encoder* is a callable (i.e. function) which will perform the " "actual encoding of the image data for transport. This callable takes one " @@ -36810,17 +37157,17 @@ msgid "" "encoders` module for a list of the built-in encoders." msgstr "" -#: ../src/Doc/library/email.mime.rst:171 +#: library/email.mime.rst:171 msgid "" "*_params* are passed straight through to the :class:`~email.mime.base." "MIMEBase` constructor." msgstr "" -#: ../src/Doc/library/email.mime.rst:179 +#: library/email.mime.rst:179 msgid "Module: :mod:`email.mime.message`" msgstr "" -#: ../src/Doc/library/email.mime.rst:181 +#: library/email.mime.rst:181 msgid "" "A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" "`MIMEMessage` class is used to create MIME objects of main type :mimetype:" @@ -36829,18 +37176,18 @@ msgid "" "`TypeError` is raised." msgstr "" -#: ../src/Doc/library/email.mime.rst:187 +#: library/email.mime.rst:187 msgid "" "Optional *_subtype* sets the subtype of the message; it defaults to :" "mimetype:`rfc822`." msgstr "" -#: ../src/Doc/library/email.mime.rst:195 +#: library/email.mime.rst:195 msgid "Module: :mod:`email.mime.text`" msgstr "" # b55c4bad2f5345559ce1f1238983665a -#: ../src/Doc/library/email.mime.rst:197 +#: library/email.mime.rst:197 msgid "" "A subclass of :class:`~email.mime.nonmultipart.MIMENonMultipart`, the :class:" "`MIMEText` class is used to create MIME objects of major type :mimetype:" @@ -36852,8 +37199,14 @@ msgid "" "it is used as-is." msgstr "" +#: library/email.mime.rst:206 +msgid "" +"The previously deprecated *_encoding* argument has been removed. Content " +"Transfer Encoding now happens implicitly based on the *_charset* argument." +msgstr "" + # 2f185468c5734a4f9feb509b14829738 -#: ../src/Doc/library/email.mime.rst:211 +#: library/email.mime.rst:211 msgid "" "Unless the ``_charset`` parameter is explicitly set to ``None``, the " "MIMEText object created will have both a :mailheader:`Content-Type` header " @@ -36867,12 +37220,12 @@ msgid "" msgstr "" # 7a5b0a95525b4100b728822b443c8d24 -#: ../src/Doc/library/email.parser.rst:2 +#: library/email.parser.rst:2 msgid ":mod:`email.parser`: Parsing email messages" msgstr "" # 8226b2c3238841f6bc8ee2f5320cc3ab -#: ../src/Doc/library/email.parser.rst:8 +#: library/email.parser.rst:8 msgid "" "Message object structures can be created in one of two ways: they can be " "created from whole cloth by instantiating :class:`~email.message.Message` " @@ -36882,7 +37235,7 @@ msgid "" msgstr "" # 84ead9ec024a4b60a492818d3ed5a398 -#: ../src/Doc/library/email.parser.rst:14 +#: library/email.parser.rst:14 msgid "" "The :mod:`email` package provides a standard parser that understands most " "email document structures, including MIME documents. You can pass the " @@ -36895,7 +37248,7 @@ msgid "" "message.Message.get_payload` and :meth:`~email.message.Message.walk` methods." msgstr "" -#: ../src/Doc/library/email.parser.rst:24 +#: library/email.parser.rst:24 msgid "" "There are actually two parser interfaces available for use, the classic :" "class:`Parser` API and the incremental :class:`FeedParser` API. The " @@ -36908,7 +37261,7 @@ msgid "" "object when you close the parser [#]_." msgstr "" -#: ../src/Doc/library/email.parser.rst:33 +#: library/email.parser.rst:33 msgid "" "Note that the parser can be extended in limited ways, and of course you can " "implement your own parser completely from scratch. There is no magical " @@ -36917,11 +37270,11 @@ msgid "" "object trees any way it finds necessary." msgstr "" -#: ../src/Doc/library/email.parser.rst:41 +#: library/email.parser.rst:41 msgid "FeedParser API" msgstr "" -#: ../src/Doc/library/email.parser.rst:45 +#: library/email.parser.rst:45 msgid "" "The :class:`FeedParser`, imported from the :mod:`email.feedparser` module, " "provides an API that is conducive to incremental parsing of email messages, " @@ -36932,7 +37285,7 @@ msgid "" "use cases. The semantics and results of the two parser APIs are identical." msgstr "" -#: ../src/Doc/library/email.parser.rst:53 +#: library/email.parser.rst:53 msgid "" "The :class:`FeedParser`'s API is simple; you create an instance, feed it a " "bunch of text until there's no more to feed it, then close the parser to " @@ -36944,18 +37297,18 @@ msgid "" "`email.errors` module for the list of defects that it can find." msgstr "" -#: ../src/Doc/library/email.parser.rst:62 +#: library/email.parser.rst:62 msgid "Here is the API for the :class:`FeedParser`:" msgstr "" -#: ../src/Doc/library/email.parser.rst:67 +#: library/email.parser.rst:67 msgid "" "Create a :class:`FeedParser` instance. Optional *_factory* is a no-argument " "callable that will be called whenever a new message object is needed. It " "defaults to the :class:`email.message.Message` class." msgstr "" -#: ../src/Doc/library/email.parser.rst:74 +#: library/email.parser.rst:74 msgid "" "Feed the :class:`FeedParser` some more data. *data* should be a string " "containing one or more lines. The lines can be partial and the :class:" @@ -36964,18 +37317,18 @@ msgid "" "newline, or carriage return and newline (they can even be mixed)." msgstr "" -#: ../src/Doc/library/email.parser.rst:84 +#: library/email.parser.rst:84 msgid "" "Closing a :class:`FeedParser` completes the parsing of all previously fed " "data, and returns the root message object. It is undefined what happens if " "you feed more data to a closed :class:`FeedParser`." msgstr "" -#: ../src/Doc/library/email.parser.rst:90 +#: library/email.parser.rst:90 msgid "Parser class API" msgstr "" -#: ../src/Doc/library/email.parser.rst:92 +#: library/email.parser.rst:92 msgid "" "The :class:`Parser` class, imported from the :mod:`email.parser` module, " "provides an API that can be used to parse a message when the complete " @@ -36988,7 +37341,7 @@ msgid "" "`Parser` class." msgstr "" -#: ../src/Doc/library/email.parser.rst:105 +#: library/email.parser.rst:105 msgid "" "The constructor for the :class:`Parser` class takes an optional argument " "*_class*. This must be a callable factory (such as a function or a class), " @@ -36997,16 +37350,33 @@ msgid "" "factory will be called without arguments." msgstr "" -#: ../src/Doc/library/email.parser.rst:111 +#: library/email.parser.rst:111 msgid "The optional *strict* flag is ignored." msgstr "" -#: ../src/Doc/library/email.parser.rst:125 +#: library/email.parser.rst:113 +msgid "" +"Because the :class:`Parser` class is a backward compatible API wrapper " +"around the new-in-Python 2.4 :class:`FeedParser`, *all* parsing is " +"effectively non-strict. You should simply stop passing a *strict* flag to " +"the :class:`Parser` constructor." +msgstr "" + +#: library/email.parser.rst:119 library/email.parser.rst:173 +#: library/email.parser.rst:183 +msgid "The *strict* flag was added." +msgstr "" + +#: library/email.parser.rst:122 +msgid "The *strict* flag was deprecated." +msgstr "" + +#: library/email.parser.rst:125 msgid "The other public :class:`Parser` methods are:" msgstr "" # b2fb91b6e04b4ca19c9a275d87cf9296 -#: ../src/Doc/library/email.parser.rst:130 +#: library/email.parser.rst:130 msgid "" "Read all the data from the file-like object *fp*, parse the resulting text, " "and return the root message object. *fp* must support both the :meth:`~io." @@ -37014,24 +37384,28 @@ msgid "" "like objects." msgstr "" -#: ../src/Doc/library/email.parser.rst:135 +#: library/email.parser.rst:135 msgid "" "The text contained in *fp* must be formatted as a block of :rfc:`2822` style " -"headers and header continuation lines, optionally preceded by a envelope " +"headers and header continuation lines, optionally preceded by an envelope " "header. The header block is terminated either by the end of the data or by " "a blank line. Following the header block is the body of the message (which " "may contain MIME-encoded subparts)." msgstr "" -#: ../src/Doc/library/email.parser.rst:141 +#: library/email.parser.rst:141 msgid "" "Optional *headersonly* is a flag specifying whether to stop parsing after " "reading the headers or not. The default is ``False``, meaning it parses the " "entire contents of the file." msgstr "" +#: library/email.parser.rst:145 library/email.parser.rst:158 +msgid "The *headersonly* flag was added." +msgstr "" + # c7b052f7f34f43b68ad3b39967c38c46 -#: ../src/Doc/library/email.parser.rst:151 +#: library/email.parser.rst:151 msgid "" "Similar to the :meth:`parse` method, except it takes a string object instead " "of a file-like object. Calling this method on a string is exactly " @@ -37039,11 +37413,11 @@ msgid "" "first and calling :meth:`parse`." msgstr "" -#: ../src/Doc/library/email.parser.rst:156 +#: library/email.parser.rst:156 msgid "Optional *headersonly* is as with the :meth:`parse` method." msgstr "" -#: ../src/Doc/library/email.parser.rst:161 +#: library/email.parser.rst:161 msgid "" "Since creating a message object structure from a string or a file object is " "such a common task, two functions are provided as a convenience. They are " @@ -37051,7 +37425,7 @@ msgid "" msgstr "" # b8eb468a89714357a4c6c1a5c90f8999 -#: ../src/Doc/library/email.parser.rst:169 +#: library/email.parser.rst:169 msgid "" "Return a message object structure from a string. This is exactly equivalent " "to ``Parser().parsestr(s)``. Optional *_class* and *strict* are interpreted " @@ -37059,7 +37433,7 @@ msgid "" msgstr "" # fa58a5fd57dc48f08e0553bb3523337b -#: ../src/Doc/library/email.parser.rst:179 +#: library/email.parser.rst:179 msgid "" "Return a message object structure tree from an open file object. This is " "exactly equivalent to ``Parser().parse(fp)``. Optional *_class* and " @@ -37067,21 +37441,21 @@ msgid "" "constructor." msgstr "" -#: ../src/Doc/library/email.parser.rst:186 +#: library/email.parser.rst:186 msgid "" "Here's an example of how you might use this at an interactive Python prompt::" msgstr "" -#: ../src/Doc/library/email.parser.rst:193 +#: library/email.parser.rst:193 msgid "Additional notes" msgstr "" -#: ../src/Doc/library/email.parser.rst:195 +#: library/email.parser.rst:195 msgid "Here are some notes on the parsing semantics:" msgstr "" # 07a7b52a49f74b08b297ccfb73b380cf -#: ../src/Doc/library/email.parser.rst:197 +#: library/email.parser.rst:197 msgid "" "Most non-\\ :mimetype:`multipart` type messages are parsed as a single " "message object with a string payload. These objects will return ``False`` " @@ -37090,7 +37464,7 @@ msgid "" msgstr "" # 3ffa475ae4bc44b88e5416a325cadadb -#: ../src/Doc/library/email.parser.rst:202 +#: library/email.parser.rst:202 msgid "" "All :mimetype:`multipart` type messages will be parsed as a container " "message object with a list of sub-message objects for their payload. The " @@ -37100,7 +37474,7 @@ msgid "" msgstr "" # be95cdbddad543bdab3a87aaa2a8123e -#: ../src/Doc/library/email.parser.rst:209 +#: library/email.parser.rst:209 msgid "" "Most messages with a content type of :mimetype:`message/\\*` (e.g. :mimetype:" "`message/delivery-status` and :mimetype:`message/rfc822`) will also be " @@ -37110,7 +37484,7 @@ msgid "" msgstr "" # cfbc00405a474ccbbf5e46eaf4f8fda5 -#: ../src/Doc/library/email.parser.rst:215 +#: library/email.parser.rst:215 msgid "" "Some non-standards compliant messages may not be internally consistent about " "their :mimetype:`multipart`\\ -edness. Such messages may have a :mailheader:" @@ -37123,7 +37497,7 @@ msgid "" msgstr "" # 3e8a2eb5260d49f6874ddaffa1fc34e7 -#: ../src/Doc/library/email.parser.rst:226 +#: library/email.parser.rst:226 msgid "" "As of email package version 3.0, introduced in Python 2.4, the classic :" "class:`~email.parser.Parser` was re-implemented in terms of the :class:" @@ -37132,29 +37506,29 @@ msgid "" msgstr "" # 6ffd4226b3744858b00c012aba64e0aa -#: ../src/Doc/library/email.util.rst:2 +#: library/email.util.rst:2 msgid ":mod:`email.utils`: Miscellaneous utilities" msgstr "" -#: ../src/Doc/library/email.util.rst:8 +#: library/email.util.rst:8 msgid "" "There are several useful utilities provided in the :mod:`email.utils` module:" msgstr "" -#: ../src/Doc/library/email.util.rst:13 +#: library/email.util.rst:13 msgid "" "Return a new string with backslashes in *str* replaced by two backslashes, " "and double quotes replaced by backslash-double quote." msgstr "" -#: ../src/Doc/library/email.util.rst:19 ../src/Doc/library/rfc822.rst:74 +#: library/email.util.rst:19 library/rfc822.rst:74 msgid "" "Return a new string which is an *unquoted* version of *str*. If *str* ends " "and begins with double quotes, they are stripped off. Likewise if *str* " "ends and begins with angle brackets, they are stripped off." msgstr "" -#: ../src/Doc/library/email.util.rst:26 +#: library/email.util.rst:26 msgid "" "Parse address -- which should be the value of some address-containing field " "such as :mailheader:`To` or :mailheader:`Cc` -- into its constituent " @@ -37162,7 +37536,7 @@ msgid "" "unless the parse fails, in which case a 2-tuple of ``('', '')`` is returned." msgstr "" -#: ../src/Doc/library/email.util.rst:34 ../src/Doc/library/rfc822.rst:89 +#: library/email.util.rst:34 library/rfc822.rst:89 msgid "" "The inverse of :meth:`parseaddr`, this takes a 2-tuple of the form " "``(realname, email_address)`` and returns the string value suitable for a :" @@ -37171,7 +37545,7 @@ msgid "" msgstr "" # 26c1200166644c89bba37b639913b191 -#: ../src/Doc/library/email.util.rst:42 +#: library/email.util.rst:42 msgid "" "This method returns a list of 2-tuples of the form returned by " "``parseaddr()``. *fieldvalues* is a sequence of header field values as might " @@ -37179,7 +37553,7 @@ msgid "" "Here's a simple example that gets all the recipients of a message::" msgstr "" -#: ../src/Doc/library/email.util.rst:58 +#: library/email.util.rst:58 msgid "" "Attempts to parse a date according to the rules in :rfc:`2822`. however, " "some mailers don't follow that format as specified, so :func:`parsedate` " @@ -37190,7 +37564,7 @@ msgid "" "returned. Note that indexes 6, 7, and 8 of the result tuple are not usable." msgstr "" -#: ../src/Doc/library/email.util.rst:69 +#: library/email.util.rst:69 msgid "" "Performs the same function as :func:`parsedate`, but returns either ``None`` " "or a 10-tuple; the first 9 elements make up a tuple that can be passed " @@ -37202,25 +37576,25 @@ msgid "" msgstr "" # b44f072cad2b40e5ad386bba85eb1f0a -#: ../src/Doc/library/email.util.rst:79 +#: library/email.util.rst:79 msgid "" "Turn a 10-tuple as returned by :func:`parsedate_tz` into a UTC timestamp " "(seconds since the Epoch). If the timezone item in the tuple is ``None``, " "assume local time." msgstr "" -#: ../src/Doc/library/email.util.rst:86 +#: library/email.util.rst:86 msgid "Returns a date string as per :rfc:`2822`, e.g.::" msgstr "" -#: ../src/Doc/library/email.util.rst:90 +#: library/email.util.rst:90 msgid "" "Optional *timeval* if given is a floating point time value as accepted by :" "func:`time.gmtime` and :func:`time.localtime`, otherwise the current time is " "used." msgstr "" -#: ../src/Doc/library/email.util.rst:94 +#: library/email.util.rst:94 msgid "" "Optional *localtime* is a flag that when ``True``, interprets *timeval*, and " "returns a date relative to the local timezone instead of UTC, properly " @@ -37228,7 +37602,7 @@ msgid "" "UTC is used." msgstr "" -#: ../src/Doc/library/email.util.rst:99 +#: library/email.util.rst:99 msgid "" "Optional *usegmt* is a flag that when ``True``, outputs a date string with " "the timezone as an ascii string ``GMT``, rather than a numeric ``-0000``. " @@ -37236,18 +37610,18 @@ msgid "" "*localtime* is ``False``. The default is ``False``." msgstr "" -#: ../src/Doc/library/email.util.rst:109 +#: library/email.util.rst:109 msgid "" "Returns a string suitable for an :rfc:`2822`\\ -compliant :mailheader:" "`Message-ID` header. Optional *idstring* if given, is a string used to " "strengthen the uniqueness of the message id." msgstr "" -#: ../src/Doc/library/email.util.rst:116 +#: library/email.util.rst:116 msgid "Decode the string *s* according to :rfc:`2231`." msgstr "" -#: ../src/Doc/library/email.util.rst:121 +#: library/email.util.rst:121 msgid "" "Encode the string *s* according to :rfc:`2231`. Optional *charset* and " "*language*, if given is the character set name and language name to use. If " @@ -37257,7 +37631,7 @@ msgid "" msgstr "" # 48a6b52a0e32413c901024f668ae14cb -#: ../src/Doc/library/email.util.rst:129 +#: library/email.util.rst:129 msgid "" "When a header parameter is encoded in :rfc:`2231` format, :meth:`Message." "get_param ` may return a 3-tuple containing " @@ -37269,19 +37643,37 @@ msgid "" "``us-ascii``." msgstr "" -#: ../src/Doc/library/email.util.rst:138 +#: library/email.util.rst:138 msgid "" "For convenience, if the *value* passed to :func:`collapse_rfc2231_value` is " "not a tuple, it should be a string and it is returned unquoted." msgstr "" -#: ../src/Doc/library/email.util.rst:144 +#: library/email.util.rst:144 msgid "" "Decode parameters list according to :rfc:`2231`. *params* is a sequence of " "2-tuples containing elements of the form ``(content-type, string-value)``." msgstr "" -#: ../src/Doc/library/email.util.rst:162 +#: library/email.util.rst:147 +msgid "" +"The :func:`dump_address_pair` function has been removed; use :func:" +"`formataddr` instead." +msgstr "" + +#: library/email.util.rst:151 +msgid "" +"The :func:`decode` function has been removed; use the :meth:`Header." +"decode_header ` method instead." +msgstr "" + +#: library/email.util.rst:156 +msgid "" +"The :func:`encode` function has been removed; use the :meth:`Header.encode " +"` method instead." +msgstr "" + +#: library/email.util.rst:162 msgid "" "Note that the sign of the timezone offset is the opposite of the sign of the " "``time.timezone`` variable for the same timezone; the latter variable " @@ -37289,12 +37681,12 @@ msgid "" msgstr "" # e7d12a31144e4a6387ca251675b94698 -#: ../src/Doc/library/ensurepip.rst:2 +#: library/ensurepip.rst:2 msgid ":mod:`ensurepip` --- Bootstrapping the ``pip`` installer" msgstr "" # 7b225363fdc4483787cfb048867a78e0 -#: ../src/Doc/library/ensurepip.rst:10 +#: library/ensurepip.rst:10 msgid "" "The :mod:`ensurepip` package provides support for bootstrapping the ``pip`` " "installer into an existing Python installation or virtual environment. This " @@ -37305,7 +37697,7 @@ msgid "" msgstr "" # 31a6f25ef4cb4c8795366a6df939f117 -#: ../src/Doc/library/ensurepip.rst:17 +#: library/ensurepip.rst:17 msgid "" "In most cases, end users of Python shouldn't need to invoke this module " "directly (as ``pip`` should be bootstrapped by default), but it may be " @@ -37314,60 +37706,57 @@ msgid "" msgstr "" # 5e421c1ff00d409d8f9f351e1019b133 -#: ../src/Doc/library/ensurepip.rst:24 +#: library/ensurepip.rst:24 msgid "" "This module *does not* access the internet. All of the components needed to " "bootstrap ``pip`` are included as internal parts of the package." msgstr "" -# e1fa541392084eb29d43c32a6afcf107 -#: ../src/Doc/library/ensurepip.rst:30 -msgid ":ref:`installing-index`" +#: library/ensurepip.rst:31 +msgid "installing-index" msgstr "" # 574e01ab53564400b96d3818da72b034 -#: ../src/Doc/library/ensurepip.rst:31 +#: library/ensurepip.rst:31 msgid "The end user guide for installing Python packages" msgstr "" -# 3e5c66ab11944e479a9cb523e2637942 -#: ../src/Doc/library/ensurepip.rst:33 -msgid ":pep:`453`: Explicit bootstrapping of pip in Python installations" +#: library/ensurepip.rst:34 +msgid "PEP 453: Explicit bootstrapping of pip in Python installations" msgstr "" # a9784f4dd1d142c2831901c6d57bfdf1 -#: ../src/Doc/library/ensurepip.rst:34 +#: library/ensurepip.rst:34 msgid "The original rationale and specification for this module." msgstr "" -# 7c3b4bc75c4345f2a38e6e400b0bab91 -#: ../src/Doc/library/ensurepip.rst:35 -msgid ":pep:`477`: Backport ensurepip (PEP 453) to Python 2.7" +#: library/ensurepip.rst:36 +msgid "PEP 477: Backport ensurepip (PEP 453) to Python 2.7" msgstr "" # 020a85026e594e0c9cc8de7e26d7448e -#: ../src/Doc/library/ensurepip.rst:37 +#: library/ensurepip.rst:37 msgid "The rationale and specification for backporting PEP 453 to Python 2.7." msgstr "" # cab072f8e5e94636aeca49163b9089cd -#: ../src/Doc/library/ensurepip.rst:41 +#: library/ensurepip.rst:41 msgid "Command line interface" msgstr "" # de9ca54896c04ddc90e56e0d40975d6d -#: ../src/Doc/library/ensurepip.rst:43 +#: library/ensurepip.rst:43 msgid "" "The command line interface is invoked using the interpreter's ``-m`` switch." msgstr "" # 5ee01562c7084543b6ee9fbeffe6a714 -#: ../src/Doc/library/ensurepip.rst:45 +#: library/ensurepip.rst:45 msgid "The simplest possible invocation is::" msgstr "" # 5cc82ea0aef74bd3957221d752003f15 -#: ../src/Doc/library/ensurepip.rst:49 +#: library/ensurepip.rst:49 msgid "" "This invocation will install ``pip`` if it is not already installed, but " "otherwise does nothing. To ensure the installed version of ``pip`` is at " @@ -37376,7 +37765,7 @@ msgid "" msgstr "" # 9d22a3d148c34617b65f9d26a84dfc43 -#: ../src/Doc/library/ensurepip.rst:56 +#: library/ensurepip.rst:56 msgid "" "By default, ``pip`` is installed into the current virtual environment (if " "one is active) or into the system site packages (if there is no active " @@ -37385,7 +37774,7 @@ msgid "" msgstr "" # 1fb726d7395f43d5a4f00469b5abace4 -#: ../src/Doc/library/ensurepip.rst:61 +#: library/ensurepip.rst:61 msgid "" "``--root ``: Installs ``pip`` relative to the given root directory " "rather than the root of the currently active virtual environment (if any) or " @@ -37393,7 +37782,7 @@ msgid "" msgstr "" # 40e11f708a364bae9b2a11a786d3f4da -#: ../src/Doc/library/ensurepip.rst:64 +#: library/ensurepip.rst:64 msgid "" "``--user``: Installs ``pip`` into the user site packages directory rather " "than globally for the current Python installation (this option is not " @@ -37401,7 +37790,7 @@ msgid "" msgstr "" # 7b0ee8d3697249689015a65fd433ef41 -#: ../src/Doc/library/ensurepip.rst:68 +#: library/ensurepip.rst:68 msgid "" "By default, the scripts ``pip``, ``pipX``, and ``pipX.Y`` will be installed " "(where X.Y stands for the version of Python used to invoke ``ensurepip``). " @@ -37410,43 +37799,43 @@ msgid "" msgstr "" # c8926ff49e184320a4aceb30fc28bd1c -#: ../src/Doc/library/ensurepip.rst:73 +#: library/ensurepip.rst:73 msgid "" "``--altinstall``: if an alternate installation is requested, the ``pip`` and " "``pipX`` script will *not* be installed." msgstr "" # 01b9d7a10bb24fe1ad96a8ab719c339e -#: ../src/Doc/library/ensurepip.rst:76 +#: library/ensurepip.rst:76 msgid "" "``--no-default-pip``: if a non-default installation is request, the ``pip`` " "script will *not* be installed." msgstr "" # 74d449707e4847f1b5a18182e101a818 -#: ../src/Doc/library/ensurepip.rst:81 +#: library/ensurepip.rst:81 msgid "Module API" msgstr "" # d06f7b9eed75451797342ffbd1de45fb -#: ../src/Doc/library/ensurepip.rst:83 +#: library/ensurepip.rst:83 msgid ":mod:`ensurepip` exposes two functions for programmatic use:" msgstr "" # b6463f6516b643dbbb91b976b85576c6 -#: ../src/Doc/library/ensurepip.rst:87 +#: library/ensurepip.rst:87 msgid "" "Returns a string specifying the bundled version of pip that will be " "installed when bootstrapping an environment." msgstr "" # 6aab28671e444343b190047a7a2f88ab -#: ../src/Doc/library/ensurepip.rst:94 +#: library/ensurepip.rst:94 msgid "Bootstraps ``pip`` into the current or designated environment." msgstr "" # 3796129d739441a89261591c67a611e4 -#: ../src/Doc/library/ensurepip.rst:96 +#: library/ensurepip.rst:96 msgid "" "*root* specifies an alternative root directory to install relative to. If " "*root* is None, then installation uses the default install location for the " @@ -37454,53 +37843,53 @@ msgid "" msgstr "" # 4e31ce39657345649d506a5ecb02084f -#: ../src/Doc/library/ensurepip.rst:100 +#: library/ensurepip.rst:100 msgid "" "*upgrade* indicates whether or not to upgrade an existing installation of an " "earlier version of ``pip`` to the bundled version." msgstr "" # 6b7d692119c24d02907f754bb310f0d7 -#: ../src/Doc/library/ensurepip.rst:103 +#: library/ensurepip.rst:103 msgid "" "*user* indicates whether to use the user scheme rather than installing " "globally." msgstr "" # 0b71983828774f258a24075183d13b83 -#: ../src/Doc/library/ensurepip.rst:106 +#: library/ensurepip.rst:106 msgid "" "By default, the scripts ``pip``, ``pipX``, and ``pipX.Y`` will be installed " "(where X.Y stands for the current version of Python)." msgstr "" # 50e6d941ad474189b5a3b52628b1b3f0 -#: ../src/Doc/library/ensurepip.rst:109 +#: library/ensurepip.rst:109 msgid "" "If *altinstall* is set, then ``pip`` and ``pipX`` will *not* be installed." msgstr "" # 22ea84c0794e4fe894a8acba4217be75 -#: ../src/Doc/library/ensurepip.rst:111 +#: library/ensurepip.rst:111 msgid "" "If *default_pip* is set to ``False``, then ``pip`` will *not* be installed." msgstr "" # 5a8b2c9903ea495982e175c001181f5c -#: ../src/Doc/library/ensurepip.rst:113 +#: library/ensurepip.rst:113 msgid "" "Setting both *altinstall* and *default_pip* will trigger :exc:`ValueError`." msgstr "" # 52d410685172431ca5807c771bbd3769 -#: ../src/Doc/library/ensurepip.rst:116 +#: library/ensurepip.rst:116 msgid "" "*verbosity* controls the level of output to :data:`sys.stdout` from the " "bootstrapping operation." msgstr "" # 5885ce2e98e94fbda323807ae646e680 -#: ../src/Doc/library/ensurepip.rst:121 +#: library/ensurepip.rst:121 msgid "" "The bootstrapping process has side effects on both ``sys.path`` and ``os." "environ``. Invoking the command line interface in a subprocess instead " @@ -37508,7 +37897,7 @@ msgid "" msgstr "" # a3a5b0db60f94a599f7571251143a0b2 -#: ../src/Doc/library/ensurepip.rst:127 +#: library/ensurepip.rst:127 msgid "" "The bootstrapping process may install additional modules required by " "``pip``, but other software should not assume those dependencies will always " @@ -37516,11 +37905,11 @@ msgid "" "version of ``pip``)." msgstr "" -#: ../src/Doc/library/errno.rst:3 +#: library/errno.rst:3 msgid ":mod:`errno` --- Standard errno system symbols" msgstr "" -#: ../src/Doc/library/errno.rst:9 +#: library/errno.rst:9 msgid "" "This module makes available standard ``errno`` system symbols. The value of " "each symbol is the corresponding integer value. The names and descriptions " @@ -37528,520 +37917,520 @@ msgid "" "inclusive." msgstr "" -#: ../src/Doc/library/errno.rst:17 +#: library/errno.rst:17 msgid "" "Dictionary providing a mapping from the errno value to the string name in " "the underlying system. For instance, ``errno.errorcode[errno.EPERM]`` maps " "to ``'EPERM'``." msgstr "" -#: ../src/Doc/library/errno.rst:21 +#: library/errno.rst:21 msgid "" "To translate a numeric error code to an error message, use :func:`os." "strerror`." msgstr "" -#: ../src/Doc/library/errno.rst:23 +#: library/errno.rst:23 msgid "" "Of the following list, symbols that are not used on the current platform are " "not defined by the module. The specific list of defined symbols is " "available as ``errno.errorcode.keys()``. Symbols available can include:" msgstr "" -#: ../src/Doc/library/errno.rst:30 +#: library/errno.rst:30 msgid "Operation not permitted" msgstr "" -#: ../src/Doc/library/errno.rst:35 +#: library/errno.rst:35 msgid "No such file or directory" msgstr "" -#: ../src/Doc/library/errno.rst:40 +#: library/errno.rst:40 msgid "No such process" msgstr "" -#: ../src/Doc/library/errno.rst:45 +#: library/errno.rst:45 msgid "Interrupted system call" msgstr "" -#: ../src/Doc/library/errno.rst:50 +#: library/errno.rst:50 msgid "I/O error" msgstr "" -#: ../src/Doc/library/errno.rst:55 +#: library/errno.rst:55 msgid "No such device or address" msgstr "" -#: ../src/Doc/library/errno.rst:60 +#: library/errno.rst:60 msgid "Arg list too long" msgstr "" -#: ../src/Doc/library/errno.rst:65 +#: library/errno.rst:65 msgid "Exec format error" msgstr "" -#: ../src/Doc/library/errno.rst:70 +#: library/errno.rst:70 msgid "Bad file number" msgstr "" -#: ../src/Doc/library/errno.rst:75 +#: library/errno.rst:75 msgid "No child processes" msgstr "" -#: ../src/Doc/library/errno.rst:80 +#: library/errno.rst:80 msgid "Try again" msgstr "" -#: ../src/Doc/library/errno.rst:85 +#: library/errno.rst:85 msgid "Out of memory" msgstr "" -#: ../src/Doc/library/errno.rst:90 +#: library/errno.rst:90 msgid "Permission denied" msgstr "" -#: ../src/Doc/library/errno.rst:95 +#: library/errno.rst:95 msgid "Bad address" msgstr "" -#: ../src/Doc/library/errno.rst:100 +#: library/errno.rst:100 msgid "Block device required" msgstr "" -#: ../src/Doc/library/errno.rst:105 +#: library/errno.rst:105 msgid "Device or resource busy" msgstr "" -#: ../src/Doc/library/errno.rst:110 +#: library/errno.rst:110 msgid "File exists" msgstr "" -#: ../src/Doc/library/errno.rst:115 +#: library/errno.rst:115 msgid "Cross-device link" msgstr "" -#: ../src/Doc/library/errno.rst:120 +#: library/errno.rst:120 msgid "No such device" msgstr "" -#: ../src/Doc/library/errno.rst:125 +#: library/errno.rst:125 msgid "Not a directory" msgstr "" -#: ../src/Doc/library/errno.rst:130 +#: library/errno.rst:130 msgid "Is a directory" msgstr "" -#: ../src/Doc/library/errno.rst:135 +#: library/errno.rst:135 msgid "Invalid argument" msgstr "" -#: ../src/Doc/library/errno.rst:140 +#: library/errno.rst:140 msgid "File table overflow" msgstr "" -#: ../src/Doc/library/errno.rst:145 +#: library/errno.rst:145 msgid "Too many open files" msgstr "" -#: ../src/Doc/library/errno.rst:150 +#: library/errno.rst:150 msgid "Not a typewriter" msgstr "" -#: ../src/Doc/library/errno.rst:155 +#: library/errno.rst:155 msgid "Text file busy" msgstr "" -#: ../src/Doc/library/errno.rst:160 +#: library/errno.rst:160 msgid "File too large" msgstr "" -#: ../src/Doc/library/errno.rst:165 +#: library/errno.rst:165 msgid "No space left on device" msgstr "" -#: ../src/Doc/library/errno.rst:170 +#: library/errno.rst:170 msgid "Illegal seek" msgstr "" -#: ../src/Doc/library/errno.rst:175 +#: library/errno.rst:175 msgid "Read-only file system" msgstr "" -#: ../src/Doc/library/errno.rst:180 +#: library/errno.rst:180 msgid "Too many links" msgstr "" -#: ../src/Doc/library/errno.rst:185 +#: library/errno.rst:185 msgid "Broken pipe" msgstr "" -#: ../src/Doc/library/errno.rst:190 +#: library/errno.rst:190 msgid "Math argument out of domain of func" msgstr "" -#: ../src/Doc/library/errno.rst:195 +#: library/errno.rst:195 msgid "Math result not representable" msgstr "" -#: ../src/Doc/library/errno.rst:200 +#: library/errno.rst:200 msgid "Resource deadlock would occur" msgstr "" -#: ../src/Doc/library/errno.rst:205 +#: library/errno.rst:205 msgid "File name too long" msgstr "" -#: ../src/Doc/library/errno.rst:210 +#: library/errno.rst:210 msgid "No record locks available" msgstr "" -#: ../src/Doc/library/errno.rst:215 +#: library/errno.rst:215 msgid "Function not implemented" msgstr "" -#: ../src/Doc/library/errno.rst:220 +#: library/errno.rst:220 msgid "Directory not empty" msgstr "" -#: ../src/Doc/library/errno.rst:225 +#: library/errno.rst:225 msgid "Too many symbolic links encountered" msgstr "" -#: ../src/Doc/library/errno.rst:230 +#: library/errno.rst:230 msgid "Operation would block" msgstr "" -#: ../src/Doc/library/errno.rst:235 +#: library/errno.rst:235 msgid "No message of desired type" msgstr "" -#: ../src/Doc/library/errno.rst:240 +#: library/errno.rst:240 msgid "Identifier removed" msgstr "" -#: ../src/Doc/library/errno.rst:245 +#: library/errno.rst:245 msgid "Channel number out of range" msgstr "" -#: ../src/Doc/library/errno.rst:250 +#: library/errno.rst:250 msgid "Level 2 not synchronized" msgstr "" -#: ../src/Doc/library/errno.rst:255 +#: library/errno.rst:255 msgid "Level 3 halted" msgstr "" -#: ../src/Doc/library/errno.rst:260 +#: library/errno.rst:260 msgid "Level 3 reset" msgstr "" -#: ../src/Doc/library/errno.rst:265 +#: library/errno.rst:265 msgid "Link number out of range" msgstr "" -#: ../src/Doc/library/errno.rst:270 +#: library/errno.rst:270 msgid "Protocol driver not attached" msgstr "" -#: ../src/Doc/library/errno.rst:275 +#: library/errno.rst:275 msgid "No CSI structure available" msgstr "" -#: ../src/Doc/library/errno.rst:280 +#: library/errno.rst:280 msgid "Level 2 halted" msgstr "" -#: ../src/Doc/library/errno.rst:285 +#: library/errno.rst:285 msgid "Invalid exchange" msgstr "" -#: ../src/Doc/library/errno.rst:290 +#: library/errno.rst:290 msgid "Invalid request descriptor" msgstr "" -#: ../src/Doc/library/errno.rst:295 +#: library/errno.rst:295 msgid "Exchange full" msgstr "" -#: ../src/Doc/library/errno.rst:300 +#: library/errno.rst:300 msgid "No anode" msgstr "" -#: ../src/Doc/library/errno.rst:305 +#: library/errno.rst:305 msgid "Invalid request code" msgstr "" -#: ../src/Doc/library/errno.rst:310 +#: library/errno.rst:310 msgid "Invalid slot" msgstr "" -#: ../src/Doc/library/errno.rst:315 +#: library/errno.rst:315 msgid "File locking deadlock error" msgstr "" -#: ../src/Doc/library/errno.rst:320 +#: library/errno.rst:320 msgid "Bad font file format" msgstr "" -#: ../src/Doc/library/errno.rst:325 +#: library/errno.rst:325 msgid "Device not a stream" msgstr "" -#: ../src/Doc/library/errno.rst:330 +#: library/errno.rst:330 msgid "No data available" msgstr "" -#: ../src/Doc/library/errno.rst:335 +#: library/errno.rst:335 msgid "Timer expired" msgstr "" -#: ../src/Doc/library/errno.rst:340 +#: library/errno.rst:340 msgid "Out of streams resources" msgstr "" -#: ../src/Doc/library/errno.rst:345 +#: library/errno.rst:345 msgid "Machine is not on the network" msgstr "" -#: ../src/Doc/library/errno.rst:350 +#: library/errno.rst:350 msgid "Package not installed" msgstr "" -#: ../src/Doc/library/errno.rst:355 +#: library/errno.rst:355 msgid "Object is remote" msgstr "" -#: ../src/Doc/library/errno.rst:360 +#: library/errno.rst:360 msgid "Link has been severed" msgstr "" -#: ../src/Doc/library/errno.rst:365 +#: library/errno.rst:365 msgid "Advertise error" msgstr "" -#: ../src/Doc/library/errno.rst:370 +#: library/errno.rst:370 msgid "Srmount error" msgstr "" -#: ../src/Doc/library/errno.rst:375 +#: library/errno.rst:375 msgid "Communication error on send" msgstr "" -#: ../src/Doc/library/errno.rst:380 +#: library/errno.rst:380 msgid "Protocol error" msgstr "" -#: ../src/Doc/library/errno.rst:385 +#: library/errno.rst:385 msgid "Multihop attempted" msgstr "" -#: ../src/Doc/library/errno.rst:390 +#: library/errno.rst:390 msgid "RFS specific error" msgstr "" -#: ../src/Doc/library/errno.rst:395 +#: library/errno.rst:395 msgid "Not a data message" msgstr "" -#: ../src/Doc/library/errno.rst:400 +#: library/errno.rst:400 msgid "Value too large for defined data type" msgstr "" -#: ../src/Doc/library/errno.rst:405 +#: library/errno.rst:405 msgid "Name not unique on network" msgstr "" -#: ../src/Doc/library/errno.rst:410 +#: library/errno.rst:410 msgid "File descriptor in bad state" msgstr "" -#: ../src/Doc/library/errno.rst:415 +#: library/errno.rst:415 msgid "Remote address changed" msgstr "" -#: ../src/Doc/library/errno.rst:420 +#: library/errno.rst:420 msgid "Can not access a needed shared library" msgstr "" -#: ../src/Doc/library/errno.rst:425 +#: library/errno.rst:425 msgid "Accessing a corrupted shared library" msgstr "" -#: ../src/Doc/library/errno.rst:430 +#: library/errno.rst:430 msgid ".lib section in a.out corrupted" msgstr "" -#: ../src/Doc/library/errno.rst:435 +#: library/errno.rst:435 msgid "Attempting to link in too many shared libraries" msgstr "" -#: ../src/Doc/library/errno.rst:440 +#: library/errno.rst:440 msgid "Cannot exec a shared library directly" msgstr "" -#: ../src/Doc/library/errno.rst:445 +#: library/errno.rst:445 msgid "Illegal byte sequence" msgstr "" -#: ../src/Doc/library/errno.rst:450 +#: library/errno.rst:450 msgid "Interrupted system call should be restarted" msgstr "" -#: ../src/Doc/library/errno.rst:455 +#: library/errno.rst:455 msgid "Streams pipe error" msgstr "" -#: ../src/Doc/library/errno.rst:460 +#: library/errno.rst:460 msgid "Too many users" msgstr "" -#: ../src/Doc/library/errno.rst:465 +#: library/errno.rst:465 msgid "Socket operation on non-socket" msgstr "" -#: ../src/Doc/library/errno.rst:470 +#: library/errno.rst:470 msgid "Destination address required" msgstr "" -#: ../src/Doc/library/errno.rst:475 +#: library/errno.rst:475 msgid "Message too long" msgstr "" -#: ../src/Doc/library/errno.rst:480 +#: library/errno.rst:480 msgid "Protocol wrong type for socket" msgstr "" -#: ../src/Doc/library/errno.rst:485 +#: library/errno.rst:485 msgid "Protocol not available" msgstr "" -#: ../src/Doc/library/errno.rst:490 +#: library/errno.rst:490 msgid "Protocol not supported" msgstr "" -#: ../src/Doc/library/errno.rst:495 +#: library/errno.rst:495 msgid "Socket type not supported" msgstr "" -#: ../src/Doc/library/errno.rst:500 +#: library/errno.rst:500 msgid "Operation not supported on transport endpoint" msgstr "" -#: ../src/Doc/library/errno.rst:505 +#: library/errno.rst:505 msgid "Protocol family not supported" msgstr "" -#: ../src/Doc/library/errno.rst:510 +#: library/errno.rst:510 msgid "Address family not supported by protocol" msgstr "" -#: ../src/Doc/library/errno.rst:515 +#: library/errno.rst:515 msgid "Address already in use" msgstr "" -#: ../src/Doc/library/errno.rst:520 +#: library/errno.rst:520 msgid "Cannot assign requested address" msgstr "" -#: ../src/Doc/library/errno.rst:525 +#: library/errno.rst:525 msgid "Network is down" msgstr "" -#: ../src/Doc/library/errno.rst:530 +#: library/errno.rst:530 msgid "Network is unreachable" msgstr "" -#: ../src/Doc/library/errno.rst:535 +#: library/errno.rst:535 msgid "Network dropped connection because of reset" msgstr "" -#: ../src/Doc/library/errno.rst:540 +#: library/errno.rst:540 msgid "Software caused connection abort" msgstr "" -#: ../src/Doc/library/errno.rst:545 +#: library/errno.rst:545 msgid "Connection reset by peer" msgstr "" -#: ../src/Doc/library/errno.rst:550 +#: library/errno.rst:550 msgid "No buffer space available" msgstr "" -#: ../src/Doc/library/errno.rst:555 +#: library/errno.rst:555 msgid "Transport endpoint is already connected" msgstr "" -#: ../src/Doc/library/errno.rst:560 +#: library/errno.rst:560 msgid "Transport endpoint is not connected" msgstr "" -#: ../src/Doc/library/errno.rst:565 +#: library/errno.rst:565 msgid "Cannot send after transport endpoint shutdown" msgstr "" -#: ../src/Doc/library/errno.rst:570 +#: library/errno.rst:570 msgid "Too many references: cannot splice" msgstr "" -#: ../src/Doc/library/errno.rst:575 +#: library/errno.rst:575 msgid "Connection timed out" msgstr "" -#: ../src/Doc/library/errno.rst:580 +#: library/errno.rst:580 msgid "Connection refused" msgstr "" -#: ../src/Doc/library/errno.rst:585 +#: library/errno.rst:585 msgid "Host is down" msgstr "" -#: ../src/Doc/library/errno.rst:590 +#: library/errno.rst:590 msgid "No route to host" msgstr "" -#: ../src/Doc/library/errno.rst:595 +#: library/errno.rst:595 msgid "Operation already in progress" msgstr "" -#: ../src/Doc/library/errno.rst:600 +#: library/errno.rst:600 msgid "Operation now in progress" msgstr "" -#: ../src/Doc/library/errno.rst:605 +#: library/errno.rst:605 msgid "Stale NFS file handle" msgstr "" -#: ../src/Doc/library/errno.rst:610 +#: library/errno.rst:610 msgid "Structure needs cleaning" msgstr "" -#: ../src/Doc/library/errno.rst:615 +#: library/errno.rst:615 msgid "Not a XENIX named type file" msgstr "" -#: ../src/Doc/library/errno.rst:620 +#: library/errno.rst:620 msgid "No XENIX semaphores available" msgstr "" -#: ../src/Doc/library/errno.rst:625 +#: library/errno.rst:625 msgid "Is a named type file" msgstr "" -#: ../src/Doc/library/errno.rst:630 +#: library/errno.rst:630 msgid "Remote I/O error" msgstr "" -#: ../src/Doc/library/errno.rst:635 +#: library/errno.rst:635 msgid "Quota exceeded" msgstr "" -#: ../src/Doc/library/exceptions.rst:4 +#: library/exceptions.rst:4 msgid "Built-in Exceptions" msgstr "" # b8fd4baa26b0484db0d283e9cc39cbf4 -#: ../src/Doc/library/exceptions.rst:10 +#: library/exceptions.rst:10 msgid "" "Exceptions should be class objects. The exceptions are defined in the " "module :mod:`exceptions`. This module never needs to be imported " @@ -38050,7 +38439,7 @@ msgid "" msgstr "" # a3573a9912c2452082912d3a78a68468 -#: ../src/Doc/library/exceptions.rst:19 +#: library/exceptions.rst:19 msgid "" "For class exceptions, in a :keyword:`try` statement with an :keyword:" "`except` clause that mentions a particular class, that clause also handles " @@ -38060,7 +38449,7 @@ msgid "" msgstr "" # 8602cb2d186d4f1b8cafaeb9d72461b6 -#: ../src/Doc/library/exceptions.rst:27 +#: library/exceptions.rst:27 msgid "" "The built-in exceptions listed below can be generated by the interpreter or " "built-in functions. Except where mentioned, they have an \"associated value" @@ -38072,7 +38461,7 @@ msgid "" "the exception instance's :attr:`args` attribute." msgstr "" -#: ../src/Doc/library/exceptions.rst:36 +#: library/exceptions.rst:36 msgid "" "User code can raise built-in exceptions. This can be used to test an " "exception handler or to report an error condition \"just like\" the " @@ -38082,7 +38471,7 @@ msgid "" msgstr "" # a6641066c9094195adb3b2bba4d77ea4 -#: ../src/Doc/library/exceptions.rst:41 +#: library/exceptions.rst:41 msgid "" "The built-in exception classes can be subclassed to define new exceptions; " "programmers are encouraged to derive new exceptions from the :exc:" @@ -38092,13 +38481,13 @@ msgid "" msgstr "" # 4c49332770d74ae5a06c03e96c16dece -#: ../src/Doc/library/exceptions.rst:47 +#: library/exceptions.rst:47 msgid "" "The following exceptions are only used as base classes for other exceptions." msgstr "" # f68e2dbb51a147f68a5171e5a6673765 -#: ../src/Doc/library/exceptions.rst:51 +#: library/exceptions.rst:51 msgid "" "The base class for all built-in exceptions. It is not meant to be directly " "inherited by user-defined classes (for that, use :exc:`Exception`). If :" @@ -38108,7 +38497,7 @@ msgid "" msgstr "" # 5d89cba3cde74aec9a58359a6e9198bd -#: ../src/Doc/library/exceptions.rst:61 +#: library/exceptions.rst:61 msgid "" "The tuple of arguments given to the exception constructor. Some built-in " "exceptions (like :exc:`IOError`) expect a certain number of arguments and " @@ -38116,21 +38505,26 @@ msgid "" "usually called only with a single string giving an error message." msgstr "" -#: ../src/Doc/library/exceptions.rst:69 +#: library/exceptions.rst:69 msgid "" "All built-in, non-system-exiting exceptions are derived from this class. " "All user-defined exceptions should also be derived from this class." msgstr "" +#: library/exceptions.rst:72 library/exceptions.rst:167 +#: library/exceptions.rst:214 library/exceptions.rst:365 +msgid "Changed to inherit from :exc:`BaseException`." +msgstr "" + # 84b7b727aaba4298929f73a7c3af3cf5 -#: ../src/Doc/library/exceptions.rst:78 +#: library/exceptions.rst:78 msgid "" "The base class for all built-in exceptions except :exc:`StopIteration`, :exc:" "`GeneratorExit`, :exc:`KeyboardInterrupt` and :exc:`SystemExit`. :exc:" "`StandardError` itself is derived from :exc:`Exception`." msgstr "" -#: ../src/Doc/library/exceptions.rst:85 +#: library/exceptions.rst:85 msgid "" "The base class for those built-in exceptions that are raised for various " "arithmetic errors: :exc:`OverflowError`, :exc:`ZeroDivisionError`, :exc:" @@ -38138,20 +38532,20 @@ msgid "" msgstr "" # 845496d2577d4c33862be3876ad3eca5 -#: ../src/Doc/library/exceptions.rst:92 +#: library/exceptions.rst:92 msgid "" "Raised when a :ref:`buffer ` related operation cannot be " "performed." msgstr "" -#: ../src/Doc/library/exceptions.rst:98 +#: library/exceptions.rst:98 msgid "" "The base class for the exceptions that are raised when a key or index used " "on a mapping or sequence is invalid: :exc:`IndexError`, :exc:`KeyError`. " "This can be raised directly by :func:`codecs.lookup`." msgstr "" -#: ../src/Doc/library/exceptions.rst:105 +#: library/exceptions.rst:105 msgid "" "The base class for exceptions that can occur outside the Python system: :exc:" "`IOError`, :exc:`OSError`. When exceptions of this type are created with a " @@ -38162,7 +38556,7 @@ msgid "" "attribute." msgstr "" -#: ../src/Doc/library/exceptions.rst:114 +#: library/exceptions.rst:114 msgid "" "When an :exc:`EnvironmentError` exception is instantiated with a 3-tuple, " "the first two items are available as above, while the third item is " @@ -38171,7 +38565,7 @@ msgid "" "first two constructor arguments." msgstr "" -#: ../src/Doc/library/exceptions.rst:120 +#: library/exceptions.rst:120 msgid "" "The :attr:`filename` attribute is ``None`` when this exception is created " "with other than 3 arguments. The :attr:`errno` and :attr:`strerror` " @@ -38181,22 +38575,22 @@ msgid "" msgstr "" # 89e89c9c3f974b29b47b21bfe8ee9149 -#: ../src/Doc/library/exceptions.rst:126 +#: library/exceptions.rst:126 msgid "The following exceptions are the exceptions that are actually raised." msgstr "" -#: ../src/Doc/library/exceptions.rst:133 +#: library/exceptions.rst:133 msgid "Raised when an :keyword:`assert` statement fails." msgstr "" -#: ../src/Doc/library/exceptions.rst:138 +#: library/exceptions.rst:138 msgid "" "Raised when an attribute reference (see :ref:`attribute-references`) or " "assignment fails. (When an object does not support attribute references or " "attribute assignments at all, :exc:`TypeError` is raised.)" msgstr "" -#: ../src/Doc/library/exceptions.rst:145 +#: library/exceptions.rst:145 msgid "" "Raised when one of the built-in functions (:func:`input` or :func:" "`raw_input`) hits an end-of-file condition (EOF) without reading any data. " @@ -38205,7 +38599,7 @@ msgid "" msgstr "" # 63a6d04b069d4a5a8bb1f18f7c1b9779 -#: ../src/Doc/library/exceptions.rst:153 +#: library/exceptions.rst:153 msgid "" "Raised when a floating point operation fails. This exception is always " "defined, but can only be raised when Python is configured with the ``--with-" @@ -38214,7 +38608,7 @@ msgid "" msgstr "" # 4617c6d66e0f4cf98af753112f8bbc14 -#: ../src/Doc/library/exceptions.rst:161 +#: library/exceptions.rst:161 msgid "" "Raised when a :term:`generator`\\'s :meth:`close` method is called. It " "directly inherits from :exc:`BaseException` instead of :exc:`StandardError` " @@ -38222,20 +38616,24 @@ msgid "" msgstr "" # 11a341c189754ec591c5ed26051dc1e4 -#: ../src/Doc/library/exceptions.rst:172 +#: library/exceptions.rst:172 msgid "" "Raised when an I/O operation (such as a :keyword:`print` statement, the " "built-in :func:`open` function or a method of a file object) fails for an I/" "O-related reason, e.g., \"file not found\" or \"disk full\"." msgstr "" -#: ../src/Doc/library/exceptions.rst:176 +#: library/exceptions.rst:176 msgid "" "This class is derived from :exc:`EnvironmentError`. See the discussion " "above for more information on exception instance attributes." msgstr "" -#: ../src/Doc/library/exceptions.rst:185 +#: library/exceptions.rst:179 +msgid "Changed :exc:`socket.error` to use this as a base class." +msgstr "" + +#: library/exceptions.rst:185 msgid "" "Raised when an :keyword:`import` statement fails to find the module " "definition or when a ``from ... import`` fails to find a name that is to be " @@ -38243,21 +38641,21 @@ msgid "" msgstr "" # b6cf20d948a7426ebdce1d7e6cc9311d -#: ../src/Doc/library/exceptions.rst:191 +#: library/exceptions.rst:191 msgid "" "Raised when a sequence subscript is out of range. (Slice indices are " "silently truncated to fall in the allowed range; if an index is not a plain " "integer, :exc:`TypeError` is raised.)" msgstr "" -#: ../src/Doc/library/exceptions.rst:200 +#: library/exceptions.rst:200 msgid "" "Raised when a mapping (dictionary) key is not found in the set of existing " "keys." msgstr "" # be88f4dceaf446d3aedcea5a809a9b2e -#: ../src/Doc/library/exceptions.rst:207 +#: library/exceptions.rst:207 msgid "" "Raised when the user hits the interrupt key (normally :kbd:`Control-C` or :" "kbd:`Delete`). During execution, a check for interrupts is made regularly. " @@ -38268,7 +38666,7 @@ msgid "" msgstr "" # 873873c667e842a79a553adc8555b37c -#: ../src/Doc/library/exceptions.rst:220 +#: library/exceptions.rst:220 msgid "" "Raised when an operation runs out of memory but the situation may still be " "rescued (by deleting some objects). The associated value is a string " @@ -38279,14 +38677,14 @@ msgid "" "stack traceback can be printed, in case a run-away program was the cause." msgstr "" -#: ../src/Doc/library/exceptions.rst:231 +#: library/exceptions.rst:231 msgid "" "Raised when a local or global name is not found. This applies only to " "unqualified names. The associated value is an error message that includes " "the name that could not be found." msgstr "" -#: ../src/Doc/library/exceptions.rst:238 +#: library/exceptions.rst:238 msgid "" "This exception is derived from :exc:`RuntimeError`. In user defined base " "classes, abstract methods should raise this exception when they require " @@ -38294,7 +38692,7 @@ msgid "" msgstr "" # 9e3b91222ac34591b944230241ef7f72 -#: ../src/Doc/library/exceptions.rst:249 +#: library/exceptions.rst:249 msgid "" "This exception is derived from :exc:`EnvironmentError`. It is raised when a " "function returns a system-related error (not for illegal argument types or " @@ -38305,7 +38703,7 @@ msgid "" "codes defined by the underlying operating system." msgstr "" -#: ../src/Doc/library/exceptions.rst:257 +#: library/exceptions.rst:257 msgid "" "For exceptions that involve a file system path (such as :func:`chdir` or :" "func:`unlink`), the exception instance will contain a third attribute, :attr:" @@ -38313,7 +38711,7 @@ msgid "" msgstr "" # f0f7776abbc54b43828ad6adfb0e4ffb -#: ../src/Doc/library/exceptions.rst:266 +#: library/exceptions.rst:266 msgid "" "Raised when the result of an arithmetic operation is too large to be " "represented. This cannot occur for long integers (which would rather raise :" @@ -38323,7 +38721,7 @@ msgid "" "also aren't checked." msgstr "" -#: ../src/Doc/library/exceptions.rst:276 +#: library/exceptions.rst:276 msgid "" "This exception is raised when a weak reference proxy, created by the :func:" "`weakref.proxy` function, is used to access an attribute of the referent " @@ -38331,8 +38729,12 @@ msgid "" "references, see the :mod:`weakref` module." msgstr "" +#: library/exceptions.rst:281 +msgid "Previously known as the :exc:`weakref.ReferenceError` exception." +msgstr "" + # 5100b4ab208a4b82a1a8ab33028f1a90 -#: ../src/Doc/library/exceptions.rst:287 +#: library/exceptions.rst:287 msgid "" "Raised when an error is detected that doesn't fall in any of the other " "categories. The associated value is a string indicating what precisely went " @@ -38340,7 +38742,7 @@ msgid "" msgstr "" # d11adaf44135489493b10271a13ab525 -#: ../src/Doc/library/exceptions.rst:294 +#: library/exceptions.rst:294 msgid "" "Raised by an :term:`iterator`\\'s :meth:`~iterator.next` method to signal " "that there are no further values. This is derived from :exc:`Exception` " @@ -38349,7 +38751,7 @@ msgid "" msgstr "" # ff2c28731f524e35992040b8adf79782 -#: ../src/Doc/library/exceptions.rst:304 +#: library/exceptions.rst:304 msgid "" "Raised when the parser encounters a syntax error. This may occur in an :" "keyword:`import` statement, in an :keyword:`exec` statement, in a call to " @@ -38357,7 +38759,7 @@ msgid "" "initial script or standard input (also interactively)." msgstr "" -#: ../src/Doc/library/exceptions.rst:309 +#: library/exceptions.rst:309 msgid "" "Instances of this class have attributes :attr:`filename`, :attr:`lineno`, :" "attr:`offset` and :attr:`text` for easier access to the details. :func:" @@ -38365,27 +38767,27 @@ msgid "" msgstr "" # 30b5dd97f1b64ec68487b7a96d9f773b -#: ../src/Doc/library/exceptions.rst:316 +#: library/exceptions.rst:316 msgid "" "Base class for syntax errors related to incorrect indentation. This is a " "subclass of :exc:`SyntaxError`." msgstr "" # a373f2584c914933b7ff455ab253adbf -#: ../src/Doc/library/exceptions.rst:322 +#: library/exceptions.rst:322 msgid "" "Raised when indentation contains an inconsistent use of tabs and spaces. " "This is a subclass of :exc:`IndentationError`." msgstr "" -#: ../src/Doc/library/exceptions.rst:328 +#: library/exceptions.rst:328 msgid "" "Raised when the interpreter finds an internal error, but the situation does " "not look so serious to cause it to abandon all hope. The associated value is " "a string indicating what went wrong (in low-level terms)." msgstr "" -#: ../src/Doc/library/exceptions.rst:332 +#: library/exceptions.rst:332 msgid "" "You should report this to the author or maintainer of your Python " "interpreter. Be sure to report the version of the Python interpreter (``sys." @@ -38395,7 +38797,7 @@ msgid "" msgstr "" # ffeaa30f3a7948eda0a8115f9d8eea74 -#: ../src/Doc/library/exceptions.rst:341 +#: library/exceptions.rst:341 msgid "" "This exception is raised by the :func:`sys.exit` function. When it is not " "handled, the Python interpreter exits; no stack traceback is printed. If " @@ -38406,7 +38808,7 @@ msgid "" msgstr "" # ef9d6135b30640949c53504ae0ab8331 -#: ../src/Doc/library/exceptions.rst:348 +#: library/exceptions.rst:348 msgid "" "Instances have an attribute :attr:`!code` which is set to the proposed exit " "status or error message (defaulting to ``None``). Also, this exception " @@ -38415,7 +38817,7 @@ msgid "" msgstr "" # 6abca5f159f84b9498c8cd37bc7f395d -#: ../src/Doc/library/exceptions.rst:353 +#: library/exceptions.rst:353 msgid "" "A call to :func:`sys.exit` is translated into an exception so that clean-up " "handlers (:keyword:`finally` clauses of :keyword:`try` statements) can be " @@ -38426,7 +38828,7 @@ msgid "" msgstr "" # 4334603a290d488bb0ccff4655c3b3e7 -#: ../src/Doc/library/exceptions.rst:360 +#: library/exceptions.rst:360 msgid "" "The exception inherits from :exc:`BaseException` instead of :exc:" "`StandardError` or :exc:`Exception` so that it is not accidentally caught by " @@ -38434,28 +38836,28 @@ msgid "" "propagate up and cause the interpreter to exit." msgstr "" -#: ../src/Doc/library/exceptions.rst:371 +#: library/exceptions.rst:371 msgid "" "Raised when an operation or function is applied to an object of " "inappropriate type. The associated value is a string giving details about " "the type mismatch." msgstr "" -#: ../src/Doc/library/exceptions.rst:377 +#: library/exceptions.rst:377 msgid "" "Raised when a reference is made to a local variable in a function or method, " "but no value has been bound to that variable. This is a subclass of :exc:" "`NameError`." msgstr "" -#: ../src/Doc/library/exceptions.rst:386 +#: library/exceptions.rst:386 msgid "" "Raised when a Unicode-related encoding or decoding error occurs. It is a " "subclass of :exc:`ValueError`." msgstr "" # 5d2c29bec9d54c9c90550909ff53702f -#: ../src/Doc/library/exceptions.rst:389 +#: library/exceptions.rst:389 msgid "" ":exc:`UnicodeError` has attributes that describe the encoding or decoding " "error. For example, ``err.object[err.start:err.end]`` gives the particular " @@ -38463,61 +38865,61 @@ msgid "" msgstr "" # d2886bae4c004b1b87f6959aabd94305 -#: ../src/Doc/library/exceptions.rst:395 +#: library/exceptions.rst:395 msgid "The name of the encoding that raised the error." msgstr "" # 9898134803a54cf499422cb05f3e20f2 -#: ../src/Doc/library/exceptions.rst:399 +#: library/exceptions.rst:399 msgid "A string describing the specific codec error." msgstr "" # 6ea4f432c45c47f89466156bbce09456 -#: ../src/Doc/library/exceptions.rst:403 +#: library/exceptions.rst:403 msgid "The object the codec was attempting to encode or decode." msgstr "" # 391ae326a5dd4424aaf1210fbada0a6d -#: ../src/Doc/library/exceptions.rst:407 +#: library/exceptions.rst:407 msgid "The first index of invalid data in :attr:`object`." msgstr "" # d5ee4a6b5e4e4a7eba8ce8ad359049e2 -#: ../src/Doc/library/exceptions.rst:411 +#: library/exceptions.rst:411 msgid "The index after the last invalid data in :attr:`object`." msgstr "" -#: ../src/Doc/library/exceptions.rst:418 +#: library/exceptions.rst:418 msgid "" "Raised when a Unicode-related error occurs during encoding. It is a " "subclass of :exc:`UnicodeError`." msgstr "" -#: ../src/Doc/library/exceptions.rst:426 +#: library/exceptions.rst:426 msgid "" "Raised when a Unicode-related error occurs during decoding. It is a " "subclass of :exc:`UnicodeError`." msgstr "" -#: ../src/Doc/library/exceptions.rst:434 +#: library/exceptions.rst:434 msgid "" "Raised when a Unicode-related error occurs during translating. It is a " "subclass of :exc:`UnicodeError`." msgstr "" -#: ../src/Doc/library/exceptions.rst:442 +#: library/exceptions.rst:442 msgid "" "Raised when a built-in operation or function receives an argument that has " "the right type but an inappropriate value, and the situation is not " "described by a more precise exception such as :exc:`IndexError`." msgstr "" -#: ../src/Doc/library/exceptions.rst:449 +#: library/exceptions.rst:449 msgid "Only available on VMS. Raised when a VMS-specific error occurs." msgstr "" # 19b54952d5db4e12bed603bddaba907d -#: ../src/Doc/library/exceptions.rst:454 +#: library/exceptions.rst:454 msgid "" "Raised when a Windows-specific error occurs or when the error number does " "not correspond to an :c:data:`errno` value. The :attr:`winerror` and :attr:" @@ -38527,81 +38929,86 @@ msgid "" "corresponding ``errno.h`` values. This is a subclass of :exc:`OSError`." msgstr "" -#: ../src/Doc/library/exceptions.rst:469 +#: library/exceptions.rst:463 +msgid "" +"Previous versions put the :c:func:`GetLastError` codes into :attr:`errno`." +msgstr "" + +#: library/exceptions.rst:469 msgid "" "Raised when the second argument of a division or modulo operation is zero. " "The associated value is a string indicating the type of the operands and the " "operation." msgstr "" -#: ../src/Doc/library/exceptions.rst:473 +#: library/exceptions.rst:473 msgid "" "The following exceptions are used as warning categories; see the :mod:" "`warnings` module for more information." msgstr "" -#: ../src/Doc/library/exceptions.rst:479 +#: library/exceptions.rst:479 msgid "Base class for warning categories." msgstr "" -#: ../src/Doc/library/exceptions.rst:484 +#: library/exceptions.rst:484 msgid "Base class for warnings generated by user code." msgstr "" -#: ../src/Doc/library/exceptions.rst:489 +#: library/exceptions.rst:489 msgid "Base class for warnings about deprecated features." msgstr "" -#: ../src/Doc/library/exceptions.rst:494 +#: library/exceptions.rst:494 msgid "" "Base class for warnings about features which will be deprecated in the " "future." msgstr "" -#: ../src/Doc/library/exceptions.rst:499 -msgid "Base class for warnings about dubious syntax" +#: library/exceptions.rst:499 +msgid "Base class for warnings about dubious syntax." msgstr "" -#: ../src/Doc/library/exceptions.rst:504 +#: library/exceptions.rst:504 msgid "Base class for warnings about dubious runtime behavior." msgstr "" -#: ../src/Doc/library/exceptions.rst:509 +#: library/exceptions.rst:509 msgid "" "Base class for warnings about constructs that will change semantically in " "the future." msgstr "" -#: ../src/Doc/library/exceptions.rst:515 +#: library/exceptions.rst:515 msgid "Base class for warnings about probable mistakes in module imports." msgstr "" -#: ../src/Doc/library/exceptions.rst:522 +#: library/exceptions.rst:522 msgid "Base class for warnings related to Unicode." msgstr "" -#: ../src/Doc/library/exceptions.rst:528 +#: library/exceptions.rst:528 msgid "Exception hierarchy" msgstr "" -#: ../src/Doc/library/exceptions.rst:530 +#: library/exceptions.rst:530 msgid "The class hierarchy for built-in exceptions is:" msgstr "" # 57826a93454e42938bbc91b0ae589ccb -#: ../src/Doc/library/fcntl.rst:2 +#: library/fcntl.rst:2 msgid ":mod:`fcntl` --- The ``fcntl`` and ``ioctl`` system calls" msgstr "" # d696ad99e0134a46b5d5fae6a23dab71 -#: ../src/Doc/library/fcntl.rst:14 +#: library/fcntl.rst:14 msgid "" "This module performs file control and I/O control on file descriptors. It is " "an interface to the :c:func:`fcntl` and :c:func:`ioctl` Unix routines." msgstr "" # 2d24388693f54b3db17b0525f5784e26 -#: ../src/Doc/library/fcntl.rst:17 +#: library/fcntl.rst:17 msgid "" "All functions in this module take a file descriptor *fd* as their first " "argument. This can be an integer file descriptor, such as returned by ``sys." @@ -38610,7 +39017,7 @@ msgid "" msgstr "" # 1111835a0e91466a9754bd671b8480f7 -#: ../src/Doc/library/fcntl.rst:27 +#: library/fcntl.rst:27 msgid "" "Perform the operation *op* on file descriptor *fd* (file objects providing " "a :meth:`~io.IOBase.fileno` method are accepted as well). The values used " @@ -38632,12 +39039,12 @@ msgid "" msgstr "" # e634c960537543fdbb0214219f500c93 -#: ../src/Doc/library/fcntl.rst:44 +#: library/fcntl.rst:44 msgid "If the :c:func:`fcntl` fails, an :exc:`IOError` is raised." msgstr "" # 71991b6c5af84d8a8ff96266569d256b -#: ../src/Doc/library/fcntl.rst:49 +#: library/fcntl.rst:49 msgid "" "This function is identical to the :func:`~fcntl.fcntl` function, except that " "the operations are typically defined in the library module :mod:`termios` " @@ -38645,7 +39052,7 @@ msgid "" msgstr "" # 089d45b8e1bc4ea6a7df1cdbc0f1508a -#: ../src/Doc/library/fcntl.rst:53 +#: library/fcntl.rst:53 msgid "" "The op parameter is limited to values that can fit in 32-bits. Additional " "constants of interest for use as the *op* argument can be found in the :mod:" @@ -38653,7 +39060,7 @@ msgid "" "files." msgstr "" -#: ../src/Doc/library/fcntl.rst:58 +#: library/fcntl.rst:58 msgid "" "The parameter *arg* can be one of an integer, absent (treated identically to " "the integer ``0``), an object supporting the read-only buffer interface " @@ -38662,19 +39069,19 @@ msgid "" msgstr "" # 04818ea926e849bc9ef5c67daa22035c -#: ../src/Doc/library/fcntl.rst:62 +#: library/fcntl.rst:62 msgid "" "In all but the last case, behaviour is as for the :func:`~fcntl.fcntl` " "function." msgstr "" -#: ../src/Doc/library/fcntl.rst:65 +#: library/fcntl.rst:65 msgid "" "If a mutable buffer is passed, then the behaviour is determined by the value " "of the *mutate_flag* parameter." msgstr "" -#: ../src/Doc/library/fcntl.rst:68 +#: library/fcntl.rst:68 msgid "" "If it is false, the buffer's mutability is ignored and behaviour is as for a " "read-only buffer, except that the 1024 byte limit mentioned above is avoided " @@ -38683,7 +39090,7 @@ msgid "" msgstr "" # 6988241614474a58a693179d70dd272d -#: ../src/Doc/library/fcntl.rst:73 +#: library/fcntl.rst:73 msgid "" "If *mutate_flag* is true, then the buffer is (in effect) passed to the " "underlying :func:`ioctl` system call, the latter's return code is passed " @@ -38695,19 +39102,23 @@ msgid "" msgstr "" # 93d87977d57647b5880052c8e1022bc4 -#: ../src/Doc/library/fcntl.rst:81 +#: library/fcntl.rst:81 msgid "" "If *mutate_flag* is not supplied, then from Python 2.5 it defaults to true, " "which is a change from versions 2.3 and 2.4. Supply the argument explicitly " "if version portability is a priority." msgstr "" -#: ../src/Doc/library/fcntl.rst:85 ../src/Doc/library/ttk.rst:1199 +#: library/fcntl.rst:85 +msgid "If the :c:func:`ioctl` fails, an :exc:`IOError` exception is raised." +msgstr "" + +#: library/fcntl.rst:87 library/ttk.rst:1199 msgid "An example::" msgstr "" # 64df347c2e6c45d8bdcba3a021fd60af -#: ../src/Doc/library/fcntl.rst:101 +#: library/fcntl.rst:103 msgid "" "Perform the lock operation *op* on file descriptor *fd* (file objects " "providing a :meth:`~io.IOBase.fileno` method are accepted as well). See the " @@ -38715,27 +39126,31 @@ msgid "" "function is emulated using :c:func:`fcntl`.)" msgstr "" +#: library/fcntl.rst:108 +msgid "If the :c:func:`flock` fails, an :exc:`IOError` exception is raised." +msgstr "" + # e41ab2641cf045d68be582ca766a402e -#: ../src/Doc/library/fcntl.rst:109 +#: library/fcntl.rst:113 msgid "" "This is essentially a wrapper around the :func:`~fcntl.fcntl` locking calls. " "*fd* is the file descriptor of the file to lock or unlock, and *operation* " "is one of the following values:" msgstr "" -#: ../src/Doc/library/fcntl.rst:113 +#: library/fcntl.rst:117 msgid ":const:`LOCK_UN` -- unlock" msgstr "" -#: ../src/Doc/library/fcntl.rst:114 +#: library/fcntl.rst:118 msgid ":const:`LOCK_SH` -- acquire a shared lock" msgstr "" -#: ../src/Doc/library/fcntl.rst:115 +#: library/fcntl.rst:119 msgid ":const:`LOCK_EX` -- acquire an exclusive lock" msgstr "" -#: ../src/Doc/library/fcntl.rst:117 +#: library/fcntl.rst:121 msgid "" "When *operation* is :const:`LOCK_SH` or :const:`LOCK_EX`, it can also be " "bitwise ORed with :const:`LOCK_NB` to avoid blocking on lock acquisition. " @@ -38748,7 +39163,7 @@ msgid "" msgstr "" # e968a9b5087f498081123b2eba576d1c -#: ../src/Doc/library/fcntl.rst:126 +#: library/fcntl.rst:130 msgid "" "*length* is the number of bytes to lock, *start* is the byte offset at which " "the lock starts, relative to *whence*, and *whence* is as with :func:`io." @@ -38756,33 +39171,33 @@ msgid "" msgstr "" # d1805347705f49228245490aac52da08 -#: ../src/Doc/library/fcntl.rst:130 +#: library/fcntl.rst:134 msgid ":const:`0` -- relative to the start of the file (:data:`os.SEEK_SET`)" msgstr "" # 9941a49d2b4a4be89a4e876bbb8d18f2 -#: ../src/Doc/library/fcntl.rst:131 +#: library/fcntl.rst:135 msgid "" ":const:`1` -- relative to the current buffer position (:data:`os.SEEK_CUR`)" msgstr "" # 6d1f2fc6b9694727946eac3d951b6fe0 -#: ../src/Doc/library/fcntl.rst:132 +#: library/fcntl.rst:136 msgid ":const:`2` -- relative to the end of the file (:data:`os.SEEK_END`)" msgstr "" -#: ../src/Doc/library/fcntl.rst:134 +#: library/fcntl.rst:138 msgid "" "The default for *start* is 0, which means to start at the beginning of the " "file. The default for *length* is 0 which means to lock to the end of the " "file. The default for *whence* is also 0." msgstr "" -#: ../src/Doc/library/fcntl.rst:138 +#: library/fcntl.rst:142 msgid "Examples (all on a SVR4 compliant system)::" msgstr "" -#: ../src/Doc/library/fcntl.rst:148 +#: library/fcntl.rst:152 msgid "" "Note that in the first example the return value variable *rv* will hold an " "integer value; in the second example it will hold a string value. The " @@ -38790,71 +39205,70 @@ msgid "" "therefore using the :func:`flock` call may be better." msgstr "" -# a57b81fa36ce4a05a723ce836fcd53d9 -# 34c6f576969f4944a1023683093c2897 -#: ../src/Doc/library/fcntl.rst:158 ../src/Doc/library/filesys.rst:35 -msgid "Module :mod:`os`" -msgstr "" +#: library/fcntl.rst:163 library/filesys.rst:36 +#, fuzzy +msgid "Module os" +msgstr "Modules" # e93f6fa8bf484972b31b497fdf1877a3 -#: ../src/Doc/library/fcntl.rst:157 +#: library/fcntl.rst:161 msgid "" "If the locking flags :data:`~os.O_SHLOCK` and :data:`~os.O_EXLOCK` are " "present in the :mod:`os` module (on BSD only), the :func:`os.open` function " "provides an alternative to the :func:`lockf` and :func:`flock` functions." msgstr "" -#: ../src/Doc/library/filecmp.rst:2 +#: library/filecmp.rst:2 msgid ":mod:`filecmp` --- File and Directory Comparisons" msgstr "" # 74592b5b98da4485896652305d531966 -#: ../src/Doc/library/filecmp.rst:8 +#: library/filecmp.rst:8 msgid "**Source code:** :source:`Lib/filecmp.py`" msgstr "" -#: ../src/Doc/library/filecmp.rst:12 +#: library/filecmp.rst:12 msgid "" "The :mod:`filecmp` module defines functions to compare files and " "directories, with various optional time/correctness trade-offs. For " "comparing files, see also the :mod:`difflib` module." msgstr "" -#: ../src/Doc/library/filecmp.rst:16 +#: library/filecmp.rst:16 msgid "The :mod:`filecmp` module defines the following functions:" msgstr "" -#: ../src/Doc/library/filecmp.rst:21 +#: library/filecmp.rst:21 msgid "" "Compare the files named *f1* and *f2*, returning ``True`` if they seem " "equal, ``False`` otherwise." msgstr "" -#: ../src/Doc/library/filecmp.rst:24 +#: library/filecmp.rst:24 msgid "" "Unless *shallow* is given and is false, files with identical :func:`os.stat` " "signatures are taken to be equal." msgstr "" -#: ../src/Doc/library/filecmp.rst:27 +#: library/filecmp.rst:27 msgid "" "Files that were compared using this function will not be compared again " "unless their :func:`os.stat` signature changes." msgstr "" -#: ../src/Doc/library/filecmp.rst:30 +#: library/filecmp.rst:30 msgid "" "Note that no external programs are called from this function, giving it " "portability and efficiency." msgstr "" -#: ../src/Doc/library/filecmp.rst:36 +#: library/filecmp.rst:36 msgid "" "Compare the files in the two directories *dir1* and *dir2* whose names are " "given by *common*." msgstr "" -#: ../src/Doc/library/filecmp.rst:39 +#: library/filecmp.rst:39 msgid "" "Returns three lists of file names: *match*, *mismatch*, *errors*. *match* " "contains the list of files that match, *mismatch* contains the names of " @@ -38864,28 +39278,28 @@ msgid "" "could not be done for some other reason." msgstr "" -#: ../src/Doc/library/filecmp.rst:46 +#: library/filecmp.rst:46 msgid "" "The *shallow* parameter has the same meaning and default value as for :func:" "`filecmp.cmp`." msgstr "" -#: ../src/Doc/library/filecmp.rst:49 +#: library/filecmp.rst:49 msgid "" "For example, ``cmpfiles('a', 'b', ['c', 'd/e'])`` will compare ``a/c`` with " "``b/c`` and ``a/d/e`` with ``b/d/e``. ``'c'`` and ``'d/e'`` will each be in " "one of the three returned lists." msgstr "" -#: ../src/Doc/library/filecmp.rst:66 +#: library/filecmp.rst:66 msgid "The :class:`dircmp` class" msgstr "" -#: ../src/Doc/library/filecmp.rst:68 +#: library/filecmp.rst:68 msgid ":class:`dircmp` instances are built using this constructor:" msgstr "" -#: ../src/Doc/library/filecmp.rst:73 +#: library/filecmp.rst:73 msgid "" "Construct a new directory comparison object, to compare the directories *a* " "and *b*. *ignore* is a list of names to ignore, and defaults to ``['RCS', " @@ -38894,40 +39308,40 @@ msgid "" msgstr "" # 8d72bafab6d54d9ba39b31716aa6b405 -#: ../src/Doc/library/filecmp.rst:78 +#: library/filecmp.rst:78 msgid "" "The :class:`dircmp` class compares files by doing *shallow* comparisons as " "described for :func:`filecmp.cmp`." msgstr "" -#: ../src/Doc/library/filecmp.rst:81 +#: library/filecmp.rst:81 msgid "The :class:`dircmp` class provides the following methods:" msgstr "" -#: ../src/Doc/library/filecmp.rst:86 +#: library/filecmp.rst:86 msgid "Print (to ``sys.stdout``) a comparison between *a* and *b*." msgstr "" -#: ../src/Doc/library/filecmp.rst:91 +#: library/filecmp.rst:91 msgid "" "Print a comparison between *a* and *b* and common immediate subdirectories." msgstr "" -#: ../src/Doc/library/filecmp.rst:97 +#: library/filecmp.rst:97 msgid "" "Print a comparison between *a* and *b* and common subdirectories " "(recursively)." msgstr "" # bb561926f2d34e9eaf13c40ffe88028d -#: ../src/Doc/library/filecmp.rst:100 +#: library/filecmp.rst:100 msgid "" "The :class:`dircmp` class offers a number of interesting attributes that may " "be used to get various bits of information about the directory trees being " "compared." msgstr "" -#: ../src/Doc/library/filecmp.rst:104 +#: library/filecmp.rst:104 msgid "" "Note that via :meth:`__getattr__` hooks, all attributes are computed lazily, " "so there is no speed penalty if only those attributes which are lightweight " @@ -38935,110 +39349,110 @@ msgid "" msgstr "" # 4b3504369ed24db9bd153d3991749df5 -#: ../src/Doc/library/filecmp.rst:111 +#: library/filecmp.rst:111 msgid "The directory *a*." msgstr "" # 59727709c8144153bc868d80b6671e9a -#: ../src/Doc/library/filecmp.rst:116 +#: library/filecmp.rst:116 msgid "The directory *b*." msgstr "" -#: ../src/Doc/library/filecmp.rst:121 +#: library/filecmp.rst:121 msgid "Files and subdirectories in *a*, filtered by *hide* and *ignore*." msgstr "" -#: ../src/Doc/library/filecmp.rst:126 +#: library/filecmp.rst:126 msgid "Files and subdirectories in *b*, filtered by *hide* and *ignore*." msgstr "" -#: ../src/Doc/library/filecmp.rst:131 +#: library/filecmp.rst:131 msgid "Files and subdirectories in both *a* and *b*." msgstr "" -#: ../src/Doc/library/filecmp.rst:136 +#: library/filecmp.rst:136 msgid "Files and subdirectories only in *a*." msgstr "" -#: ../src/Doc/library/filecmp.rst:141 +#: library/filecmp.rst:141 msgid "Files and subdirectories only in *b*." msgstr "" -#: ../src/Doc/library/filecmp.rst:146 +#: library/filecmp.rst:146 msgid "Subdirectories in both *a* and *b*." msgstr "" -#: ../src/Doc/library/filecmp.rst:151 +#: library/filecmp.rst:151 msgid "Files in both *a* and *b*" msgstr "" -#: ../src/Doc/library/filecmp.rst:156 +#: library/filecmp.rst:156 msgid "" "Names in both *a* and *b*, such that the type differs between the " "directories, or names for which :func:`os.stat` reports an error." msgstr "" # 215b41549a2049db86e7b72060f11773 -#: ../src/Doc/library/filecmp.rst:162 +#: library/filecmp.rst:162 msgid "" "Files which are identical in both *a* and *b*, using the class's file " "comparison operator." msgstr "" # f2bad301242c432c84fa690ff98d987b -#: ../src/Doc/library/filecmp.rst:168 +#: library/filecmp.rst:168 msgid "" "Files which are in both *a* and *b*, whose contents differ according to the " "class's file comparison operator." msgstr "" -#: ../src/Doc/library/filecmp.rst:174 +#: library/filecmp.rst:174 msgid "Files which are in both *a* and *b*, but could not be compared." msgstr "" -#: ../src/Doc/library/filecmp.rst:179 +#: library/filecmp.rst:179 msgid "" "A dictionary mapping names in :attr:`common_dirs` to :class:`dircmp` objects." msgstr "" # a938d52df8e84ef59ed0ee251cf3a633 -#: ../src/Doc/library/filecmp.rst:182 +#: library/filecmp.rst:182 msgid "" "Here is a simplified example of using the ``subdirs`` attribute to search " "recursively through two directories to show common different files::" msgstr "" -#: ../src/Doc/library/fileformats.rst:6 +#: library/fileformats.rst:6 msgid "File Formats" msgstr "" -#: ../src/Doc/library/fileformats.rst:8 +#: library/fileformats.rst:8 msgid "" "The modules described in this chapter parse various miscellaneous file " "formats that aren't markup languages or are related to e-mail." msgstr "" -#: ../src/Doc/library/fileinput.rst:2 +#: library/fileinput.rst:2 msgid ":mod:`fileinput` --- Iterate over lines from multiple input streams" msgstr "" # ad9e4595cba0436cb5ed77ae33594a07 -#: ../src/Doc/library/fileinput.rst:9 +#: library/fileinput.rst:9 msgid "**Source code:** :source:`Lib/fileinput.py`" msgstr "" -#: ../src/Doc/library/fileinput.rst:13 +#: library/fileinput.rst:13 msgid "" "This module implements a helper class and functions to quickly write a loop " "over standard input or a list of files. If you just want to read or write " "one file see :func:`open`." msgstr "" -#: ../src/Doc/library/fileinput.rst:17 +#: library/fileinput.rst:17 msgid "The typical use is::" msgstr "" -#: ../src/Doc/library/fileinput.rst:23 +#: library/fileinput.rst:23 msgid "" "This iterates over the lines of all files listed in ``sys.argv[1:]``, " "defaulting to ``sys.stdin`` if the list is empty. If a filename is ``'-'``, " @@ -39047,7 +39461,7 @@ msgid "" "name is also allowed." msgstr "" -#: ../src/Doc/library/fileinput.rst:28 +#: library/fileinput.rst:28 msgid "" "All files are opened in text mode by default, but you can override this by " "specifying the *mode* parameter in the call to :func:`.input` or :class:" @@ -39055,27 +39469,27 @@ msgid "" "exc:`IOError` is raised." msgstr "" -#: ../src/Doc/library/fileinput.rst:33 +#: library/fileinput.rst:33 msgid "" "If ``sys.stdin`` is used more than once, the second and further use will " "return no lines, except perhaps for interactive use, or if it has been " "explicitly reset (e.g. using ``sys.stdin.seek(0)``)." msgstr "" -#: ../src/Doc/library/fileinput.rst:37 +#: library/fileinput.rst:37 msgid "" "Empty files are opened and immediately closed; the only time their presence " "in the list of filenames is noticeable at all is when the last file opened " "is empty." msgstr "" -#: ../src/Doc/library/fileinput.rst:41 +#: library/fileinput.rst:41 msgid "" "Lines are returned with any newlines intact, which means that the last line " "in a file may not have one." msgstr "" -#: ../src/Doc/library/fileinput.rst:44 +#: library/fileinput.rst:44 msgid "" "You can control how files are opened by providing an opening hook via the " "*openhook* parameter to :func:`fileinput.input` or :class:`FileInput()`. The " @@ -39084,11 +39498,11 @@ msgid "" "provided by this module." msgstr "" -#: ../src/Doc/library/fileinput.rst:50 +#: library/fileinput.rst:50 msgid "The following function is the primary interface of this module:" msgstr "" -#: ../src/Doc/library/fileinput.rst:55 +#: library/fileinput.rst:55 msgid "" "Create an instance of the :class:`FileInput` class. The instance will be " "used as global state for the functions of this module, and is also returned " @@ -39096,51 +39510,55 @@ msgid "" "along to the constructor of the :class:`FileInput` class." msgstr "" -#: ../src/Doc/library/fileinput.rst:63 +#: library/fileinput.rst:60 library/fileinput.rst:143 +msgid "Added the *mode* and *openhook* parameters." +msgstr "" + +#: library/fileinput.rst:63 msgid "" "The following functions use the global state created by :func:`fileinput." "input`; if there is no active state, :exc:`RuntimeError` is raised." msgstr "" -#: ../src/Doc/library/fileinput.rst:69 +#: library/fileinput.rst:69 msgid "" "Return the name of the file currently being read. Before the first line has " "been read, returns ``None``." msgstr "" -#: ../src/Doc/library/fileinput.rst:75 +#: library/fileinput.rst:75 msgid "" "Return the integer \"file descriptor\" for the current file. When no file is " "opened (before the first line and between files), returns ``-1``." msgstr "" -#: ../src/Doc/library/fileinput.rst:83 +#: library/fileinput.rst:83 msgid "" "Return the cumulative line number of the line that has just been read. " "Before the first line has been read, returns ``0``. After the last line of " "the last file has been read, returns the line number of that line." msgstr "" -#: ../src/Doc/library/fileinput.rst:90 +#: library/fileinput.rst:90 msgid "" "Return the line number in the current file. Before the first line has been " "read, returns ``0``. After the last line of the last file has been read, " "returns the line number of that line within the file." msgstr "" -#: ../src/Doc/library/fileinput.rst:97 +#: library/fileinput.rst:97 msgid "" "Returns true if the line just read is the first line of its file, otherwise " "returns false." msgstr "" -#: ../src/Doc/library/fileinput.rst:103 +#: library/fileinput.rst:103 msgid "" "Returns true if the last line was read from ``sys.stdin``, otherwise returns " "false." msgstr "" -#: ../src/Doc/library/fileinput.rst:109 +#: library/fileinput.rst:109 msgid "" "Close the current file so that the next iteration will read the first line " "from the next file (if any); lines not read from the file will not count " @@ -39151,18 +39569,18 @@ msgid "" "no effect." msgstr "" -#: ../src/Doc/library/fileinput.rst:119 +#: library/fileinput.rst:119 msgid "Close the sequence." msgstr "" -#: ../src/Doc/library/fileinput.rst:121 +#: library/fileinput.rst:121 msgid "" "The class which implements the sequence behavior provided by the module is " "available for subclassing as well:" msgstr "" # eb818f088fa44b9c9f313a163b9de96f -#: ../src/Doc/library/fileinput.rst:127 +#: library/fileinput.rst:127 msgid "" "Class :class:`FileInput` is the implementation; its methods :meth:" "`filename`, :meth:`fileno`, :meth:`lineno`, :meth:`filelineno`, :meth:" @@ -39174,20 +39592,20 @@ msgid "" "meth:`~file.readline` cannot be mixed." msgstr "" -#: ../src/Doc/library/fileinput.rst:136 +#: library/fileinput.rst:136 msgid "" "With *mode* you can specify which file mode will be passed to :func:`open`. " "It must be one of ``'r'``, ``'rU'``, ``'U'`` and ``'rb'``." msgstr "" -#: ../src/Doc/library/fileinput.rst:139 +#: library/fileinput.rst:139 msgid "" "The *openhook*, when given, must be a function that takes two arguments, " "*filename* and *mode*, and returns an accordingly opened file-like object. " "You cannot use *inplace* and *openhook* together." msgstr "" -#: ../src/Doc/library/fileinput.rst:146 +#: library/fileinput.rst:146 msgid "" "**Optional in-place filtering:** if the keyword argument ``inplace=1`` is " "passed to :func:`fileinput.input` or to the :class:`FileInput` constructor, " @@ -39201,15 +39619,15 @@ msgid "" "In-place filtering is disabled when standard input is read." msgstr "" -#: ../src/Doc/library/fileinput.rst:159 +#: library/fileinput.rst:159 msgid "The current implementation does not work for MS-DOS 8+3 filesystems." msgstr "" -#: ../src/Doc/library/fileinput.rst:162 +#: library/fileinput.rst:162 msgid "The two following opening hooks are provided by this module:" msgstr "" -#: ../src/Doc/library/fileinput.rst:166 +#: library/fileinput.rst:166 msgid "" "Transparently opens files compressed with gzip and bzip2 (recognized by the " "extensions ``'.gz'`` and ``'.bz2'``) using the :mod:`gzip` and :mod:`bz2` " @@ -39217,36 +39635,36 @@ msgid "" "is opened normally (ie, using :func:`open` without any decompression)." msgstr "" -#: ../src/Doc/library/fileinput.rst:171 +#: library/fileinput.rst:171 msgid "" "Usage example: ``fi = fileinput.FileInput(openhook=fileinput." "hook_compressed)``" msgstr "" -#: ../src/Doc/library/fileinput.rst:178 +#: library/fileinput.rst:178 msgid "" "Returns a hook which opens each file with :func:`codecs.open`, using the " "given *encoding* to read the file." msgstr "" -#: ../src/Doc/library/fileinput.rst:181 +#: library/fileinput.rst:181 msgid "" "Usage example: ``fi = fileinput.FileInput(openhook=fileinput." "hook_encoded(\"iso-8859-1\"))``" msgstr "" # 769397d1e5ab48799ee93cd0ec66f512 -#: ../src/Doc/library/fileinput.rst:186 +#: library/fileinput.rst:186 msgid "" "With this hook, :class:`FileInput` might return Unicode strings depending on " "the specified *encoding*." msgstr "" -#: ../src/Doc/library/filesys.rst:6 +#: library/filesys.rst:6 msgid "File and Directory Access" msgstr "" -#: ../src/Doc/library/filesys.rst:8 +#: library/filesys.rst:8 msgid "" "The modules described in this chapter deal with disk files and directories. " "For example, there are modules for reading the properties of files, " @@ -39254,29 +39672,32 @@ msgid "" "full list of modules in this chapter is:" msgstr "" -# 2d3ceb4744734877846b2b995d0c7c77 -#: ../src/Doc/library/filesys.rst:32 -msgid "Section :ref:`bltin-file-objects`" +#: library/filesys.rst:33 +msgid "Section bltin-file-objects" msgstr "" # e20e7c0c900744d99d5eb89ce2f93bae -#: ../src/Doc/library/filesys.rst:33 +#: library/filesys.rst:33 msgid "A description of Python's built-in file objects." msgstr "" -#: ../src/Doc/library/filesys.rst:36 +#: library/filesys.rst:36 msgid "" "Operating system interfaces, including functions to work with files at a " "lower level than the built-in file object." msgstr "" # 0f7b4366c1a74a77b04ce15ea23de890 -#: ../src/Doc/library/fl.rst:3 +#: library/fl.rst:3 msgid ":mod:`fl` --- FORMS library for graphical user interfaces" msgstr "" +#: library/fl.rst:11 +msgid "The :mod:`fl` module has been removed in Python 3." +msgstr "" + # d9ebbf06498946a59c544311f54f03aa -#: ../src/Doc/library/fl.rst:19 +#: library/fl.rst:19 msgid "" "This module provides an interface to the FORMS Library by Mark Overmars. " "The source for the library can be retrieved by anonymous ftp from host ``ftp." @@ -39285,7 +39706,7 @@ msgid "" msgstr "" # 3cccfbb677d64ad293056cb02dc616b3 -#: ../src/Doc/library/fl.rst:24 +#: library/fl.rst:24 msgid "" "Most functions are literal translations of their C equivalents, dropping the " "initial ``fl_`` from their name. Constants used by the library are defined " @@ -39293,7 +39714,7 @@ msgid "" msgstr "" # 9f2b0ed736424c78a21a6241128ccfec -#: ../src/Doc/library/fl.rst:28 +#: library/fl.rst:28 msgid "" "The creation of objects is a little different in Python than in C: instead " "of the 'current form' maintained by the library to which new FORMS objects " @@ -39305,7 +39726,7 @@ msgid "" msgstr "" # 696a1b55a64247c896978557b8dfd972 -#: ../src/Doc/library/fl.rst:35 +#: library/fl.rst:35 msgid "" "Watch out for the somewhat confusing terminology: FORMS uses the word :dfn:" "`object` for the buttons, sliders etc. that you can place in a form. In " @@ -39316,7 +39737,7 @@ msgid "" msgstr "" # ebe60d21bb64470cb9cd52cd18da06fb -#: ../src/Doc/library/fl.rst:42 +#: library/fl.rst:42 msgid "" "There are no 'free objects' in the Python interface to FORMS, nor is there " "an easy way to add object classes written in Python. The FORMS interface to " @@ -39325,19 +39746,19 @@ msgid "" msgstr "" # 8538e8f76c9f4232bb9e0cf3e81944a7 -#: ../src/Doc/library/fl.rst:46 +#: library/fl.rst:46 msgid "" "**Please note:** importing :mod:`fl` implies a call to the GL function :c:" "func:`foreground` and to the FORMS routine :c:func:`fl_init`." msgstr "" # a6cecd344a824f93a149b391cd919197 -#: ../src/Doc/library/fl.rst:53 +#: library/fl.rst:53 msgid "Functions Defined in Module :mod:`fl`" msgstr "" # 8990d0aaada54176a8b263c9d69dd5d3 -#: ../src/Doc/library/fl.rst:55 +#: library/fl.rst:55 msgid "" "Module :mod:`fl` defines the following functions. For more information " "about what they do, see the description of the equivalent C function in the " @@ -39345,64 +39766,64 @@ msgid "" msgstr "" # f9fd059ebe3f42658c3f8ba3857418a2 -#: ../src/Doc/library/fl.rst:62 +#: library/fl.rst:62 msgid "" "Create a form with given type, width and height. This returns a :dfn:`form` " "object, whose methods are described below." msgstr "" # 8947b1fac9924644a640000a1766dece -#: ../src/Doc/library/fl.rst:68 +#: library/fl.rst:68 msgid "" "The standard FORMS main loop. Returns a Python object representing the " "FORMS object needing interaction, or the special value :const:`FL.EVENT`." msgstr "" # ff736d84ec494419ab9bbd550902c4fb -#: ../src/Doc/library/fl.rst:74 +#: library/fl.rst:74 msgid "" "Check for FORMS events. Returns what :func:`do_forms` above returns, or " "``None`` if there is no event that immediately needs interaction." msgstr "" # daa8e0e385d242b9a9c3dd873232f133 -#: ../src/Doc/library/fl.rst:80 +#: library/fl.rst:80 msgid "Set the event callback function." msgstr "" # bcec26496ead47408d019f7e8f306dd9 -#: ../src/Doc/library/fl.rst:85 +#: library/fl.rst:85 msgid "Set the graphics modes." msgstr "" # b9693fc483ba4d10983a1d6c8faae195 -#: ../src/Doc/library/fl.rst:90 +#: library/fl.rst:90 msgid "" "Return the current rgb mode. This is the value of the C global variable :c:" "data:`fl_rgbmode`." msgstr "" # 48c8f2553556422f9ee431f8fc46792a -#: ../src/Doc/library/fl.rst:96 +#: library/fl.rst:96 msgid "Show a dialog box with a three-line message and an OK button." msgstr "" # 95579607675946d9b145c336b83c593b -#: ../src/Doc/library/fl.rst:101 +#: library/fl.rst:101 msgid "" "Show a dialog box with a three-line message and YES and NO buttons. It " "returns ``1`` if the user pressed YES, ``0`` if NO." msgstr "" # 8207b7a3eee941c8b3e213e98bdcdf3f -#: ../src/Doc/library/fl.rst:107 +#: library/fl.rst:107 msgid "" "Show a dialog box with a three-line message and up to three buttons. It " "returns the number of the button clicked by the user (``1``, ``2`` or ``3``)." msgstr "" # 3383ae2010fa41948efd5ee90d20781a -#: ../src/Doc/library/fl.rst:113 +#: library/fl.rst:113 msgid "" "Show a dialog box with a one-line prompt message and text field in which the " "user can enter a string. The second argument is the default input string. " @@ -39410,7 +39831,7 @@ msgid "" msgstr "" # 7de3876b02124c14843faa35573851cc -#: ../src/Doc/library/fl.rst:120 +#: library/fl.rst:120 msgid "" "Show a dialog box in which the user can select a file. It returns the " "absolute filename selected by the user, or ``None`` if the user presses " @@ -39418,14 +39839,14 @@ msgid "" msgstr "" # 3f491437b3e2454cba73d225df519b62 -#: ../src/Doc/library/fl.rst:128 +#: library/fl.rst:128 msgid "" "These functions return the directory, pattern and filename (the tail part " "only) selected by the user in the last :func:`show_file_selector` call." msgstr "" # 82f36c67a51147409bb6c22cce34bb44 -#: ../src/Doc/library/fl.rst:142 +#: library/fl.rst:142 msgid "" "These functions are the FORMS interfaces to the corresponding GL functions. " "Use these if you want to handle some GL events yourself when using :func:`fl." @@ -39436,19 +39857,19 @@ msgid "" msgstr "" # 7d03a29e14914c09a5d982d73c412a13 -#: ../src/Doc/library/fl.rst:156 +#: library/fl.rst:156 msgid "" "See the description in the FORMS documentation of :c:func:`fl_color`, :c:" "func:`fl_mapcolor` and :c:func:`fl_getmcolor`." msgstr "" # e4c80e7272754b068a1399d7c71c1cd3 -#: ../src/Doc/library/fl.rst:163 +#: library/fl.rst:163 msgid "Form Objects" msgstr "" # de68c02f6a7b41deb880b48391cdf38a -#: ../src/Doc/library/fl.rst:165 +#: library/fl.rst:165 msgid "" "Form objects (returned by :func:`make_form` above) have the following " "methods. Each method corresponds to a C function whose name is prefixed with " @@ -39457,7 +39878,7 @@ msgid "" msgstr "" # f87efb3833944d50a42a12adefceebed -#: ../src/Doc/library/fl.rst:170 +#: library/fl.rst:170 msgid "" "All the :meth:`add_\\*` methods return a Python object representing the " "FORMS object. Methods of FORMS objects are described below. Most kinds of " @@ -39466,103 +39887,103 @@ msgid "" msgstr "" # 291cbddc898c4c0e8494b8da63721388 -#: ../src/Doc/library/fl.rst:178 +#: library/fl.rst:178 msgid "Show the form." msgstr "" # 05d34144bc1b4682b59403be2ef9bf11 -#: ../src/Doc/library/fl.rst:183 +#: library/fl.rst:183 msgid "Hide the form." msgstr "" # b4825bf62fa0433c86f8d143d79f8588 -#: ../src/Doc/library/fl.rst:188 +#: library/fl.rst:188 msgid "Redraw the form." msgstr "" # c899b2f961c44646846d287e5bb31e93 -#: ../src/Doc/library/fl.rst:193 +#: library/fl.rst:193 msgid "Set the form's position." msgstr "" # a015528c49c9456c8967018806268fef -#: ../src/Doc/library/fl.rst:198 +#: library/fl.rst:198 msgid "Freeze the form." msgstr "" # 6617a2eca28b42079f60fd5213dcaf63 -#: ../src/Doc/library/fl.rst:203 +#: library/fl.rst:203 msgid "Unfreeze the form." msgstr "" # 740ce0b2b0424493a741c155f0ce169a -#: ../src/Doc/library/fl.rst:208 +#: library/fl.rst:208 msgid "Activate the form." msgstr "" # c6d38b8ed6e3429f8b9c47e639656633 -#: ../src/Doc/library/fl.rst:213 +#: library/fl.rst:213 msgid "Deactivate the form." msgstr "" # b5302312ac9c48e0a406dd9bbf6fcce0 -#: ../src/Doc/library/fl.rst:218 +#: library/fl.rst:218 msgid "Begin a new group of objects; return a group object." msgstr "" # 0307c615a55e474b9223bb598410a29d -#: ../src/Doc/library/fl.rst:223 +#: library/fl.rst:223 msgid "End the current group of objects." msgstr "" # b27911c9dea748469931a43f9646c54d -#: ../src/Doc/library/fl.rst:228 +#: library/fl.rst:228 msgid "Find the first object in the form." msgstr "" # 340c99da63b24649b8fb42bfb8f42513 -#: ../src/Doc/library/fl.rst:233 +#: library/fl.rst:233 msgid "Find the last object in the form." msgstr "" # 2e4c6924b878416d992ec12d79457ccc -#: ../src/Doc/library/fl.rst:238 +#: library/fl.rst:238 msgid "Add a box object to the form. No extra methods." msgstr "" # 8ab5e06c11454e98877d2afcbefb8ab5 -#: ../src/Doc/library/fl.rst:243 +#: library/fl.rst:243 msgid "Add a text object to the form. No extra methods." msgstr "" # 06af8c2a04e14bbbb39a32ae817e3dca -#: ../src/Doc/library/fl.rst:252 +#: library/fl.rst:252 msgid "Add a clock object to the form. --- Method: :meth:`get_clock`." msgstr "" # c21ca763251d42ef97d1bb8ad3f69855 -#: ../src/Doc/library/fl.rst:257 +#: library/fl.rst:257 msgid "" "Add a button object to the form. --- Methods: :meth:`get_button`, :meth:" "`set_button`." msgstr "" # b2117b82a1a948dc99e59831ddd04055 -#: ../src/Doc/library/fl.rst:263 +#: library/fl.rst:263 msgid "" "Add a lightbutton object to the form. --- Methods: :meth:`get_button`, :" "meth:`set_button`." msgstr "" # dbbd657d14cc4123bed468ad74a784a4 -#: ../src/Doc/library/fl.rst:269 +#: library/fl.rst:269 msgid "" "Add a roundbutton object to the form. --- Methods: :meth:`get_button`, :" "meth:`set_button`." msgstr "" # 65425fe1846e4aa7a12419e164951dc4 -#: ../src/Doc/library/fl.rst:275 +#: library/fl.rst:275 msgid "" "Add a slider object to the form. --- Methods: :meth:`set_slider_value`, :" "meth:`get_slider_value`, :meth:`set_slider_bounds`, :meth:" @@ -39571,7 +39992,7 @@ msgid "" msgstr "" # cafa45d055a84a138759ea6ee694bcf1 -#: ../src/Doc/library/fl.rst:283 +#: library/fl.rst:283 msgid "" "Add a valslider object to the form. --- Methods: :meth:" "`set_slider_value`, :meth:`get_slider_value`, :meth:`set_slider_bounds`, :" @@ -39580,14 +40001,14 @@ msgid "" msgstr "" # e5b739ae609344b0885ceba995f7f263 -#: ../src/Doc/library/fl.rst:291 +#: library/fl.rst:291 msgid "" "Add a dial object to the form. --- Methods: :meth:`set_dial_value`, :meth:" "`get_dial_value`, :meth:`set_dial_bounds`, :meth:`get_dial_bounds`." msgstr "" # 71f00ebedc8348f7bd5903f6374028fd -#: ../src/Doc/library/fl.rst:297 +#: library/fl.rst:297 msgid "" "Add a positioner object to the form. --- Methods: :meth:" "`set_positioner_xvalue`, :meth:`set_positioner_yvalue`, :meth:" @@ -39597,7 +40018,7 @@ msgid "" msgstr "" # 82635dc2cba34a4cbd77f467c9fc6229 -#: ../src/Doc/library/fl.rst:306 +#: library/fl.rst:306 msgid "" "Add a counter object to the form. --- Methods: :meth:`set_counter_value`, :" "meth:`get_counter_value`, :meth:`set_counter_bounds`, :meth:" @@ -39606,21 +40027,21 @@ msgid "" msgstr "" # 6bff4af6487a45f99d1a0a1387403d2c -#: ../src/Doc/library/fl.rst:313 +#: library/fl.rst:313 msgid "" "Add a input object to the form. --- Methods: :meth:`set_input`, :meth:" "`get_input`, :meth:`set_input_color`, :meth:`set_input_return`." msgstr "" # 2be701edfd1342aaa29cb22ddc0b3a95 -#: ../src/Doc/library/fl.rst:319 +#: library/fl.rst:319 msgid "" "Add a menu object to the form. --- Methods: :meth:`set_menu`, :meth:" "`get_menu`, :meth:`addto_menu`." msgstr "" # 0c0d01ed7ffe48ccb7e4742aee105cd6 -#: ../src/Doc/library/fl.rst:325 +#: library/fl.rst:325 msgid "" "Add a choice object to the form. --- Methods: :meth:`set_choice`, :meth:" "`get_choice`, :meth:`clear_choice`, :meth:`addto_choice`, :meth:" @@ -39629,7 +40050,7 @@ msgid "" msgstr "" # 190aeb8d0bc64168b057a802ecf95eaf -#: ../src/Doc/library/fl.rst:333 +#: library/fl.rst:333 msgid "" "Add a browser object to the form. --- Methods: :meth:" "`set_browser_topline`, :meth:`clear_browser`, :meth:`add_browser_line`, :" @@ -39643,20 +40064,20 @@ msgid "" msgstr "" # 2c1c054e328c4d60b6255bd9a124f2bb -#: ../src/Doc/library/fl.rst:346 +#: library/fl.rst:346 msgid "" "Add a timer object to the form. --- Methods: :meth:`set_timer`, :meth:" "`get_timer`." msgstr "" # ff162beeab954f87bce1b6d6f334a976 -#: ../src/Doc/library/fl.rst:349 +#: library/fl.rst:349 msgid "" "Form objects have the following data attributes; see the FORMS documentation:" msgstr "" # 87726ebe47bf4afdbf3e0ed3e2bc4387 -#: ../src/Doc/library/fl.rst:354 +#: library/fl.rst:354 msgid ":attr:`window`" msgstr "" @@ -39672,120 +40093,117 @@ msgstr "" # 08aa32667c914933a037414ec3b0e140 # e1bce1ec3d5e45bab8a9440ef29ad5c2 # da8bf5411cc14e758143a5d309d43630 -#: ../src/Doc/library/fl.rst:354 ../src/Doc/library/fl.rst:432 -#: ../src/Doc/library/fl.rst:434 ../src/Doc/library/fl.rst:460 -#: ../src/Doc/library/fl.rst:462 ../src/Doc/library/fl.rst:464 -#: ../src/Doc/library/fl.rst:466 ../src/Doc/library/fl.rst:468 -#: ../src/Doc/library/fl.rst:470 ../src/Doc/library/fl.rst:472 -#: ../src/Doc/library/fl.rst:474 ../src/Doc/library/fl.rst:476 +#: library/fl.rst:354 library/fl.rst:432 library/fl.rst:434 library/fl.rst:460 +#: library/fl.rst:462 library/fl.rst:464 library/fl.rst:466 library/fl.rst:468 +#: library/fl.rst:470 library/fl.rst:472 library/fl.rst:474 library/fl.rst:476 msgid "int (read-only)" msgstr "" # 4e8aa065d82d4b779fef2fe847e6b861 -#: ../src/Doc/library/fl.rst:354 +#: library/fl.rst:354 msgid "GL window id" msgstr "" # 90ae6e38e49149bc8e69a5979dd57c82 # 1eca3c9094fa4eec8f212b712d2f3b21 -#: ../src/Doc/library/fl.rst:356 ../src/Doc/library/fl.rst:442 +#: library/fl.rst:356 library/fl.rst:442 msgid ":attr:`w`" msgstr "" # 3c54a5f0441e4a99ae20986157244657 -#: ../src/Doc/library/fl.rst:356 +#: library/fl.rst:356 msgid "form width" msgstr "" # 1ab92e773aaf4768b50ae13152356405 # 7a77fc6b000e49cfae5f41616ce7e078 -#: ../src/Doc/library/fl.rst:358 ../src/Doc/library/fl.rst:444 +#: library/fl.rst:358 library/fl.rst:444 msgid ":attr:`h`" msgstr "" # 2b798a3db2444f37b7b3bda86f156194 -#: ../src/Doc/library/fl.rst:358 +#: library/fl.rst:358 msgid "form height" msgstr "" # 7cad67cd7b5c4d5ebbbf3d5f30cf8b23 # d2298416661e42d6af81f116aa288c65 -#: ../src/Doc/library/fl.rst:360 ../src/Doc/library/fl.rst:438 +#: library/fl.rst:360 library/fl.rst:438 msgid ":attr:`x`" msgstr "" # b5be9e092bef434faf1ca8c0d70d177a -#: ../src/Doc/library/fl.rst:360 +#: library/fl.rst:360 msgid "form x origin" msgstr "" # 7e2418a49fef4f6ea596e059ca605b66 # 4441d3adbcf64bc59372368cc0b6ebfe -#: ../src/Doc/library/fl.rst:362 ../src/Doc/library/fl.rst:440 +#: library/fl.rst:362 library/fl.rst:440 msgid ":attr:`y`" msgstr "" # 1cefa75ce239487b8fc3289cc585ef13 -#: ../src/Doc/library/fl.rst:362 +#: library/fl.rst:362 msgid "form y origin" msgstr "" # cbeb32e09d0b4c408b229332f9c69b09 -#: ../src/Doc/library/fl.rst:364 +#: library/fl.rst:364 msgid ":attr:`deactivated`" msgstr "" # b3fe6b94b3b04aba888b53d225ad8851 -#: ../src/Doc/library/fl.rst:364 +#: library/fl.rst:364 msgid "nonzero if form is deactivated" msgstr "" # 8ea273b9128a45f99ff2b9a002ab16b2 # f86662900cc748ae8720525d9baaf76a -#: ../src/Doc/library/fl.rst:366 ../src/Doc/library/fl.rst:472 +#: library/fl.rst:366 library/fl.rst:472 msgid ":attr:`visible`" msgstr "" # c407867ecaff45c0a52122855ceff934 -#: ../src/Doc/library/fl.rst:366 +#: library/fl.rst:366 msgid "nonzero if form is visible" msgstr "" # 3b24c0f827944aff919292cae3c69c3d # ce66de2c45e14f2594d47988afadbc57 -#: ../src/Doc/library/fl.rst:368 ../src/Doc/library/fl.rst:466 +#: library/fl.rst:368 library/fl.rst:466 msgid ":attr:`frozen`" msgstr "" # e07ce2e621b54106baa7310d44b458af -#: ../src/Doc/library/fl.rst:368 +#: library/fl.rst:368 msgid "nonzero if form is frozen" msgstr "" # caa3107c46ef44129fdfed48efe1b71d -#: ../src/Doc/library/fl.rst:370 +#: library/fl.rst:370 msgid ":attr:`doublebuf`" msgstr "" # 2949dabe437d4cd195b5b8cdc79a27d7 -#: ../src/Doc/library/fl.rst:370 +#: library/fl.rst:370 msgid "nonzero if double buffering on" msgstr "" # 4e1410aed050497c95661d3632cbc5f6 -#: ../src/Doc/library/fl.rst:377 +#: library/fl.rst:377 msgid "FORMS Objects" msgstr "" # 97ac5ed68fb34ff1a6e828b8f5e01436 -#: ../src/Doc/library/fl.rst:379 +#: library/fl.rst:379 msgid "" "Besides methods specific to particular kinds of FORMS objects, all FORMS " "objects also have the following methods:" msgstr "" # d815348591ad469b85b481696579e1fc -#: ../src/Doc/library/fl.rst:385 +#: library/fl.rst:385 msgid "" "Set the object's callback function and argument. When the object needs " "interaction, the callback function will be called with two arguments: the " @@ -39796,162 +40214,162 @@ msgid "" msgstr "" # 8ab19246693c44998cfd9273d690ef3d -#: ../src/Doc/library/fl.rst:395 +#: library/fl.rst:395 msgid "Delete the object." msgstr "" # 15915a0934c048229706ff4f2b37ea7b -#: ../src/Doc/library/fl.rst:400 +#: library/fl.rst:400 msgid "Show the object." msgstr "" # 014401013f994e77a01fcd77a0ccb978 -#: ../src/Doc/library/fl.rst:405 +#: library/fl.rst:405 msgid "Hide the object." msgstr "" # 09cc4f9b71ba4060a96423a09c999e9f -#: ../src/Doc/library/fl.rst:410 +#: library/fl.rst:410 msgid "Redraw the object." msgstr "" # 33ce53a657ac49f4a27f06aa97c69109 -#: ../src/Doc/library/fl.rst:415 +#: library/fl.rst:415 msgid "Freeze the object." msgstr "" # 88dbbb36e81f4cfaa0516163cb65c78d -#: ../src/Doc/library/fl.rst:420 +#: library/fl.rst:420 msgid "Unfreeze the object." msgstr "" # 926307d5a2b24c7490013d93643aad31 -#: ../src/Doc/library/fl.rst:422 +#: library/fl.rst:422 msgid "FORMS objects have these data attributes; see the FORMS documentation:" msgstr "" # 411b26fb695649ce8d54d5f89d32c5f4 -#: ../src/Doc/library/fl.rst:432 +#: library/fl.rst:432 msgid ":attr:`objclass`" msgstr "" # b83f62199ff946dba7783b1ee4eaa16d -#: ../src/Doc/library/fl.rst:432 +#: library/fl.rst:432 msgid "object class" msgstr "" # 68bcd514faa949a9aea770cb096c74f7 -#: ../src/Doc/library/fl.rst:434 +#: library/fl.rst:434 msgid ":attr:`type`" msgstr "" # 76e0c982f76d48169a3f9b07cba91359 -#: ../src/Doc/library/fl.rst:434 +#: library/fl.rst:434 msgid "object type" msgstr "" # 5868a67a4e084799a5538f290bc614d9 -#: ../src/Doc/library/fl.rst:436 +#: library/fl.rst:436 msgid ":attr:`boxtype`" msgstr "" # dc7a78d84dba44f3bfac98d0cfd3bbc0 -#: ../src/Doc/library/fl.rst:436 +#: library/fl.rst:436 msgid "box type" msgstr "" # 8e07e30a6e034739896f8d5b88ed37ba -#: ../src/Doc/library/fl.rst:438 +#: library/fl.rst:438 msgid "x origin" msgstr "" # f9003ca6d4f54bbb9aa17f534e32f0d4 -#: ../src/Doc/library/fl.rst:440 +#: library/fl.rst:440 msgid "y origin" msgstr "" -#: ../src/Doc/library/fl.rst:442 ../src/Doc/library/ttk.rst:197 -#: ../src/Doc/library/ttk.rst:338 ../src/Doc/library/ttk.rst:399 +#: library/fl.rst:442 library/ttk.rst:197 library/ttk.rst:338 +#: library/ttk.rst:399 msgid "width" msgstr "" -#: ../src/Doc/library/fl.rst:444 ../src/Doc/library/ttk.rst:316 -#: ../src/Doc/library/ttk.rst:389 ../src/Doc/library/ttk.rst:721 +#: library/fl.rst:444 library/ttk.rst:316 library/ttk.rst:389 +#: library/ttk.rst:721 msgid "height" msgstr "" # ed8c8c4db49844b9998959a73831aeeb -#: ../src/Doc/library/fl.rst:446 +#: library/fl.rst:446 msgid ":attr:`col1`" msgstr "" # 254674660a5e4f9483fa8cc6fee06ea2 -#: ../src/Doc/library/fl.rst:446 +#: library/fl.rst:446 msgid "primary color" msgstr "" # 432b98b14ec244b38ad51af38bd44d0c -#: ../src/Doc/library/fl.rst:448 +#: library/fl.rst:448 msgid ":attr:`col2`" msgstr "" # 8a39b8aa5d504336b9e4cc13abfc882e -#: ../src/Doc/library/fl.rst:448 +#: library/fl.rst:448 msgid "secondary color" msgstr "" # a029eb7836ed442db9df418a4ccf41d1 -#: ../src/Doc/library/fl.rst:450 +#: library/fl.rst:450 msgid ":attr:`align`" msgstr "" # ae492e41be504995ad364d8861edbfed -#: ../src/Doc/library/fl.rst:450 +#: library/fl.rst:450 msgid "alignment" msgstr "" # 089ee69e244d4e97a8a5444b476c2244 -#: ../src/Doc/library/fl.rst:452 +#: library/fl.rst:452 msgid ":attr:`lcol`" msgstr "" # f8cedb44db3b431bb537cce0d7378865 -#: ../src/Doc/library/fl.rst:452 +#: library/fl.rst:452 msgid "label color" msgstr "" # d37aca820f0a45ffb56f7dcb2bb3ad40 -#: ../src/Doc/library/fl.rst:454 +#: library/fl.rst:454 msgid ":attr:`lsize`" msgstr "" # 329380caf4b6444792f35f904cbe66a7 -#: ../src/Doc/library/fl.rst:454 +#: library/fl.rst:454 msgid "label font size" msgstr "" # eaea019b63704358bc8a0df584cd2938 -#: ../src/Doc/library/fl.rst:456 +#: library/fl.rst:456 msgid ":attr:`label`" msgstr "" # 7791519a292b4f6d96f7520752610efd -#: ../src/Doc/library/fl.rst:456 +#: library/fl.rst:456 msgid "label string" msgstr "" # e269b0f693c94f749fd47e4438fa70e6 -#: ../src/Doc/library/fl.rst:458 +#: library/fl.rst:458 msgid ":attr:`lstyle`" msgstr "" # 866cb4b48b9448dfa92c2f493f911672 -#: ../src/Doc/library/fl.rst:458 +#: library/fl.rst:458 msgid "label style" msgstr "" # 76f6cb5c563a46209ad48750a6399f16 -#: ../src/Doc/library/fl.rst:460 +#: library/fl.rst:460 msgid ":attr:`pushed`" msgstr "" @@ -39964,51 +40382,53 @@ msgstr "" # d23dd837810841969b7998ce373cc4b6 # 5897aadd2417436ca82c4e01c317a977 # bb25138602cc4d54bc2d79c10701b205 -#: ../src/Doc/library/fl.rst:460 ../src/Doc/library/fl.rst:462 -#: ../src/Doc/library/fl.rst:464 ../src/Doc/library/fl.rst:466 -#: ../src/Doc/library/fl.rst:468 ../src/Doc/library/fl.rst:470 -#: ../src/Doc/library/fl.rst:472 ../src/Doc/library/fl.rst:474 -#: ../src/Doc/library/fl.rst:476 +#: library/fl.rst:460 library/fl.rst:462 library/fl.rst:464 library/fl.rst:466 +#: library/fl.rst:468 library/fl.rst:470 library/fl.rst:472 library/fl.rst:474 +#: library/fl.rst:476 msgid "(see FORMS docs)" msgstr "" # eb805f1686e645ffa7506d01d44be471 -#: ../src/Doc/library/fl.rst:462 +#: library/fl.rst:462 msgid ":attr:`focus`" msgstr "" # 49404f90d6034a2bafb2301b01944b12 -#: ../src/Doc/library/fl.rst:464 +#: library/fl.rst:464 msgid ":attr:`belowmouse`" msgstr "" # 70546baa651f487a8d36617f5c5fc821 -#: ../src/Doc/library/fl.rst:468 +#: library/fl.rst:468 msgid ":attr:`active`" msgstr "" # 6add1cefb87d4f6d95dad0f5d8d7e91f -#: ../src/Doc/library/fl.rst:470 +#: library/fl.rst:470 msgid ":attr:`input`" msgstr "" # 3e844ea9e51b438cbcc97ca1f9a0c480 -#: ../src/Doc/library/fl.rst:474 +#: library/fl.rst:474 msgid ":attr:`radio`" msgstr "" # e15475e5e66d44fdac5bd0649d018ada -#: ../src/Doc/library/fl.rst:476 +#: library/fl.rst:476 msgid ":attr:`automatic`" msgstr "" # 8aad581c0138435eb670ad364ffe8719 -#: ../src/Doc/library/fl.rst:481 +#: library/fl.rst:481 msgid ":mod:`FL` --- Constants used with the :mod:`fl` module" msgstr "" +#: library/fl.rst:489 +msgid "The :mod:`FL` module has been removed in Python 3." +msgstr "" + # e66dfc91698b422aabed0f4c0385f8dc -#: ../src/Doc/library/fl.rst:493 +#: library/fl.rst:493 msgid "" "This module defines symbolic constants needed to use the built-in module :" "mod:`fl` (see above); they are equivalent to those defined in the C header " @@ -40017,12 +40437,16 @@ msgid "" msgstr "" # 5880f347e1de4f0caa8579144d0d35bb -#: ../src/Doc/library/fl.rst:503 +#: library/fl.rst:503 msgid ":mod:`flp` --- Functions for loading stored FORMS designs" msgstr "" +#: library/fl.rst:511 +msgid "The :mod:`flp` module has been removed in Python 3." +msgstr "" + # 13d39c91c911452fb092938b748d6c5d -#: ../src/Doc/library/fl.rst:515 +#: library/fl.rst:515 msgid "" "This module defines functions that can read form definitions created by the " "'form designer' (:program:`fdesign`) program that comes with the FORMS " @@ -40030,24 +40454,28 @@ msgid "" msgstr "" # 6d2c9dac572a4f7d952975edae31f2c1 -#: ../src/Doc/library/fl.rst:519 +#: library/fl.rst:519 msgid "" "For now, see the file :file:`flp.doc` in the Python library source directory " "for a description." msgstr "" # 507891e583de439fbf9699003cf21237 -#: ../src/Doc/library/fl.rst:522 +#: library/fl.rst:522 msgid "XXX A complete description should be inserted here!" msgstr "" # da393fc3074246c2bb2f5584e264dac5 -#: ../src/Doc/library/fm.rst:3 +#: library/fm.rst:3 msgid ":mod:`fm` --- *Font Manager* interface" msgstr "" +#: library/fm.rst:10 +msgid "The :mod:`fm` module has been removed in Python 3." +msgstr "" + # aa38a5d8bdf34a10a8fcda71026cb1a1 -#: ../src/Doc/library/fm.rst:19 +#: library/fm.rst:19 msgid "" "This module provides access to the IRIS *Font Manager* library. It is " "available only on Silicon Graphics machines. See also: *4Sight User's " @@ -40055,7 +40483,7 @@ msgid "" msgstr "" # c5c0783ed28844c8aea2b08095c0674b -#: ../src/Doc/library/fm.rst:23 +#: library/fm.rst:23 msgid "" "This is not yet a full interface to the IRIS Font Manager. Among the " "unsupported features are: matrix operations; cache operations; character " @@ -40064,12 +40492,12 @@ msgid "" msgstr "" # cb6e66781d5e4d1499c83f64eb43b691 -#: ../src/Doc/library/fm.rst:28 +#: library/fm.rst:28 msgid "It supports the following operations:" msgstr "" # e500cfde2b9345ed8754f98fd9c2f436 -#: ../src/Doc/library/fm.rst:33 +#: library/fm.rst:33 msgid "" "Initialization function. Calls :c:func:`fminit`. It is normally not " "necessary to call this function, since it is called automatically the first " @@ -40077,69 +40505,69 @@ msgid "" msgstr "" # 79fe03bf21b043288a66cd25d3da59c4 -#: ../src/Doc/library/fm.rst:40 +#: library/fm.rst:40 msgid "Return a font handle object. Calls ``fmfindfont(fontname)``." msgstr "" # de2ce14718664226828a163acd7ac5e2 -#: ../src/Doc/library/fm.rst:45 +#: library/fm.rst:45 msgid "" "Returns a list of available font names. This is an interface to :c:func:" "`fmenumerate`." msgstr "" # f5a6376cc79b4977b7b8c8b8b590987c -#: ../src/Doc/library/fm.rst:51 +#: library/fm.rst:51 msgid "" "Render a string using the current font (see the :func:`setfont` font handle " "method below). Calls ``fmprstr(string)``." msgstr "" # a1a4b71ae7bf46d1aab6e8b563583c53 -#: ../src/Doc/library/fm.rst:57 +#: library/fm.rst:57 msgid "" "Sets the font search path. Calls ``fmsetpath(string)``. (XXX Does not " "work!?!)" msgstr "" # 38e20e16199741d48bab5452b23bf59e -#: ../src/Doc/library/fm.rst:62 +#: library/fm.rst:62 msgid "Returns the current font search path." msgstr "" # 3b433461b7744e5d847e56561146dbe3 -#: ../src/Doc/library/fm.rst:64 +#: library/fm.rst:64 msgid "Font handle objects support the following operations:" msgstr "" # 0c65c037ac324fe58691cd4c9fd42375 -#: ../src/Doc/library/fm.rst:69 +#: library/fm.rst:69 msgid "" "Returns a handle for a scaled version of this font. Calls ``fmscalefont(fh, " "factor)``." msgstr "" # 6475bb8050b84645b151cc5cbfde485f -#: ../src/Doc/library/fm.rst:75 +#: library/fm.rst:75 msgid "" "Makes this font the current font. Note: the effect is undone silently when " "the font handle object is deleted. Calls ``fmsetfont(fh)``." msgstr "" # 67e07b375b354d1ea7436641ec4f09fc -#: ../src/Doc/library/fm.rst:81 +#: library/fm.rst:81 msgid "Returns this font's name. Calls ``fmgetfontname(fh)``." msgstr "" # ef69ea6cca684824808a363086f84d0a -#: ../src/Doc/library/fm.rst:86 +#: library/fm.rst:86 msgid "" "Returns the comment string associated with this font. Raises an exception if " "there is none. Calls ``fmgetcomment(fh)``." msgstr "" # 478b76f070094513a329ec4d6af11414 -#: ../src/Doc/library/fm.rst:92 +#: library/fm.rst:92 msgid "" "Returns a tuple giving some pertinent data about this font. This is an " "interface to ``fmgetfontinfo()``. The returned tuple contains the following " @@ -40148,75 +40576,74 @@ msgid "" msgstr "" # d29acbe9ded7406dbbaefd40ef547d67 -#: ../src/Doc/library/fm.rst:99 +#: library/fm.rst:99 msgid "" "Returns the width, in pixels, of *string* when drawn in this font. Calls " "``fmgetstrwidth(fh, string)``." msgstr "" -#: ../src/Doc/library/fnmatch.rst:2 +#: library/fnmatch.rst:2 msgid ":mod:`fnmatch` --- Unix filename pattern matching" msgstr "" # a55066db514348239ad74065e11e7a8c -#: ../src/Doc/library/fnmatch.rst:12 +#: library/fnmatch.rst:12 msgid "**Source code:** :source:`Lib/fnmatch.py`" msgstr "" -#: ../src/Doc/library/fnmatch.rst:16 +#: library/fnmatch.rst:16 msgid "" "This module provides support for Unix shell-style wildcards, which are *not* " "the same as regular expressions (which are documented in the :mod:`re` " "module). The special characters used in shell-style wildcards are:" msgstr "" -#: ../src/Doc/library/fnmatch.rst:21 +#: library/fnmatch.rst:21 msgid "Pattern" msgstr "" -#: ../src/Doc/library/fnmatch.rst:23 -#: ../src/Doc/library/xml.etree.elementtree.rst:326 +#: library/fnmatch.rst:23 library/xml.etree.elementtree.rst:393 msgid "``*``" msgstr "" -#: ../src/Doc/library/fnmatch.rst:23 +#: library/fnmatch.rst:23 msgid "matches everything" msgstr "" -#: ../src/Doc/library/fnmatch.rst:25 ../src/Doc/library/posixfile.rst:128 -#: ../src/Doc/library/posixfile.rst:166 ../src/Doc/library/struct.rst:176 +#: library/fnmatch.rst:25 library/posixfile.rst:128 library/posixfile.rst:166 +#: library/struct.rst:176 msgid "``?``" msgstr "" -#: ../src/Doc/library/fnmatch.rst:25 +#: library/fnmatch.rst:25 msgid "matches any single character" msgstr "" -#: ../src/Doc/library/fnmatch.rst:27 +#: library/fnmatch.rst:27 msgid "``[seq]``" msgstr "" -#: ../src/Doc/library/fnmatch.rst:27 +#: library/fnmatch.rst:27 msgid "matches any character in *seq*" msgstr "" -#: ../src/Doc/library/fnmatch.rst:29 +#: library/fnmatch.rst:29 msgid "``[!seq]``" msgstr "" -#: ../src/Doc/library/fnmatch.rst:29 +#: library/fnmatch.rst:29 msgid "matches any character not in *seq*" msgstr "" # 2e5aa560bafc46ed8d1a3abe4cbd5661 # 5f6de87f475a4abf8185c31088cf27a6 -#: ../src/Doc/library/fnmatch.rst:32 ../src/Doc/library/glob.rst:24 +#: library/fnmatch.rst:32 library/glob.rst:24 msgid "" "For a literal match, wrap the meta-characters in brackets. For example, " "``'[?]'`` matches the character ``'?'``." msgstr "" -#: ../src/Doc/library/fnmatch.rst:37 +#: library/fnmatch.rst:37 msgid "" "Note that the filename separator (``'/'`` on Unix) is *not* special to this " "module. See module :mod:`glob` for pathname expansion (:mod:`glob` uses :" @@ -40225,7 +40652,7 @@ msgid "" "and ``?`` patterns." msgstr "" -#: ../src/Doc/library/fnmatch.rst:46 +#: library/fnmatch.rst:46 msgid "" "Test whether the *filename* string matches the *pattern* string, returning :" "const:`True` or :const:`False`. If the operating system is case-" @@ -40235,44 +40662,44 @@ msgid "" "for the operating system." msgstr "" -#: ../src/Doc/library/fnmatch.rst:53 +#: library/fnmatch.rst:53 msgid "" "This example will print all file names in the current directory with the " "extension ``.txt``::" msgstr "" -#: ../src/Doc/library/fnmatch.rst:66 +#: library/fnmatch.rst:66 msgid "" "Test whether *filename* matches *pattern*, returning :const:`True` or :const:" "`False`; the comparison is case-sensitive." msgstr "" -#: ../src/Doc/library/fnmatch.rst:72 +#: library/fnmatch.rst:72 msgid "" "Return the subset of the list of *names* that match *pattern*. It is the " "same as ``[n for n in names if fnmatch(n, pattern)]``, but implemented more " "efficiently." msgstr "" -#: ../src/Doc/library/fnmatch.rst:80 +#: library/fnmatch.rst:80 msgid "Return the shell-style *pattern* converted to a regular expression." msgstr "" -# f5e3763702d94528b07390a87c48a701 -#: ../src/Doc/library/fnmatch.rst:95 -msgid "Module :mod:`glob`" -msgstr "" +#: library/fnmatch.rst:96 +#, fuzzy +msgid "Module glob" +msgstr "Modules" -#: ../src/Doc/library/fnmatch.rst:97 +#: library/fnmatch.rst:97 msgid "Unix shell-style path expansion." msgstr "" -#: ../src/Doc/library/formatter.rst:3 +#: library/formatter.rst:3 msgid ":mod:`formatter` --- Generic output formatting" msgstr "" # a18b963b86a2401a809833f5fcdf5fcd -#: ../src/Doc/library/formatter.rst:11 +#: library/formatter.rst:11 msgid "" "This module supports two interface definitions, each with multiple " "implementations. The *formatter* interface is used by the :class:" @@ -40280,7 +40707,7 @@ msgid "" "is required by the formatter interface." msgstr "" -#: ../src/Doc/library/formatter.rst:16 +#: library/formatter.rst:16 msgid "" "Formatter objects transform an abstract flow of formatting events into " "specific output events on writer objects. Formatters manage several stack " @@ -40294,7 +40721,7 @@ msgid "" "paragraph separation." msgstr "" -#: ../src/Doc/library/formatter.rst:26 +#: library/formatter.rst:26 msgid "" "Writer objects encapsulate device interfaces. Abstract devices, such as " "file formats, are supported as well as physical devices. The provided " @@ -40303,22 +40730,22 @@ msgid "" "manage and inserting data into the output." msgstr "" -#: ../src/Doc/library/formatter.rst:36 +#: library/formatter.rst:36 msgid "The Formatter Interface" msgstr "" -#: ../src/Doc/library/formatter.rst:38 +#: library/formatter.rst:38 msgid "" "Interfaces to create formatters are dependent on the specific formatter " "class being instantiated. The interfaces described below are the required " "interfaces which all formatters must support once initialized." msgstr "" -#: ../src/Doc/library/formatter.rst:42 +#: library/formatter.rst:42 msgid "One data element is defined at the module level:" msgstr "" -#: ../src/Doc/library/formatter.rst:47 +#: library/formatter.rst:47 msgid "" "Value which can be used in the font specification passed to the " "``push_font()`` method described below, or as the new value to any other " @@ -40327,27 +40754,27 @@ msgid "" "whether the property was changed." msgstr "" -#: ../src/Doc/library/formatter.rst:52 +#: library/formatter.rst:52 msgid "The following attributes are defined for formatter instance objects:" msgstr "" -#: ../src/Doc/library/formatter.rst:57 +#: library/formatter.rst:57 msgid "The writer instance with which the formatter interacts." msgstr "" -#: ../src/Doc/library/formatter.rst:62 +#: library/formatter.rst:62 msgid "" "Close any open paragraphs and insert at least *blanklines* before the next " "paragraph." msgstr "" -#: ../src/Doc/library/formatter.rst:68 +#: library/formatter.rst:68 msgid "" "Add a hard line break if one does not already exist. This does not break " "the logical paragraph." msgstr "" -#: ../src/Doc/library/formatter.rst:74 +#: library/formatter.rst:74 msgid "" "Insert a horizontal rule in the output. A hard break is inserted if there " "is data in the current paragraph, but the logical paragraph is not broken. " @@ -40355,7 +40782,7 @@ msgid "" "`send_line_break` method." msgstr "" -#: ../src/Doc/library/formatter.rst:82 +#: library/formatter.rst:82 msgid "" "Provide data which should be formatted with collapsed whitespace. Whitespace " "from preceding and successive calls to :meth:`add_flowing_data` is " @@ -40365,14 +40792,14 @@ msgid "" "object due to the need to rely on device and font information." msgstr "" -#: ../src/Doc/library/formatter.rst:92 +#: library/formatter.rst:92 msgid "" "Provide data which should be passed to the writer unchanged. Whitespace, " "including newline and tab characters, are considered legal in the value of " "*data*." msgstr "" -#: ../src/Doc/library/formatter.rst:99 +#: library/formatter.rst:99 msgid "" "Insert a label which should be placed to the left of the current left " "margin. This should be used for constructing bulleted or numbered lists. If " @@ -40384,7 +40811,7 @@ msgid "" "label values is dependent on the associated writer." msgstr "" -#: ../src/Doc/library/formatter.rst:108 +#: library/formatter.rst:108 msgid "" "Format specifications are strings which, in combination with a counter " "value, are used to compute label values. Each character in the format " @@ -40398,14 +40825,14 @@ msgid "" "be greater than zero." msgstr "" -#: ../src/Doc/library/formatter.rst:121 +#: library/formatter.rst:121 msgid "" "Send any pending whitespace buffered from a previous call to :meth:" "`add_flowing_data` to the associated writer object. This should be called " "before any direct manipulation of the writer object." msgstr "" -#: ../src/Doc/library/formatter.rst:128 +#: library/formatter.rst:128 msgid "" "Push a new alignment setting onto the alignment stack. This may be :const:" "`AS_IS` if no change is desired. If the alignment value is changed from the " @@ -40413,11 +40840,11 @@ msgid "" "the *align* value." msgstr "" -#: ../src/Doc/library/formatter.rst:136 +#: library/formatter.rst:136 msgid "Restore the previous alignment." msgstr "" -#: ../src/Doc/library/formatter.rst:141 +#: library/formatter.rst:141 msgid "" "Change some or all font properties of the writer object. Properties which " "are not set to :const:`AS_IS` are set to the values passed in while others " @@ -40425,11 +40852,11 @@ msgid "" "method is called with the fully resolved font specification." msgstr "" -#: ../src/Doc/library/formatter.rst:149 +#: library/formatter.rst:149 msgid "Restore the previous font." msgstr "" -#: ../src/Doc/library/formatter.rst:154 +#: library/formatter.rst:154 msgid "" "Increase the number of left margin indentations by one, associating the " "logical tag *margin* with the new indentation. The initial margin level is " @@ -40437,11 +40864,11 @@ msgid "" "other than :const:`AS_IS` are not sufficient to change the margin." msgstr "" -#: ../src/Doc/library/formatter.rst:162 +#: library/formatter.rst:162 msgid "Restore the previous margin." msgstr "" -#: ../src/Doc/library/formatter.rst:167 +#: library/formatter.rst:167 msgid "" "Push any number of arbitrary style specifications. All styles are pushed " "onto the styles stack in order. A tuple representing the entire stack, " @@ -40449,18 +40876,18 @@ msgid "" "`new_styles` method." msgstr "" -#: ../src/Doc/library/formatter.rst:174 +#: library/formatter.rst:174 msgid "" "Pop the last *n* style specifications passed to :meth:`push_style`. A tuple " "representing the revised stack, including :const:`AS_IS` values, is passed " "to the writer's :meth:`new_styles` method." msgstr "" -#: ../src/Doc/library/formatter.rst:181 +#: library/formatter.rst:181 msgid "Set the spacing style for the writer." msgstr "" -#: ../src/Doc/library/formatter.rst:186 +#: library/formatter.rst:186 msgid "" "Inform the formatter that data has been added to the current paragraph out-" "of-band. This should be used when the writer has been manipulated " @@ -40468,18 +40895,18 @@ msgid "" "manipulations produced a hard line break at the end of the output." msgstr "" -#: ../src/Doc/library/formatter.rst:195 +#: library/formatter.rst:195 msgid "Formatter Implementations" msgstr "" -#: ../src/Doc/library/formatter.rst:197 +#: library/formatter.rst:197 msgid "" "Two implementations of formatter objects are provided by this module. Most " "applications may use one of these classes without modification or " "subclassing." msgstr "" -#: ../src/Doc/library/formatter.rst:203 +#: library/formatter.rst:203 msgid "" "A formatter which does nothing. If *writer* is omitted, a :class:" "`NullWriter` instance is created. No methods of the writer are called by :" @@ -40488,7 +40915,7 @@ msgid "" "implementation." msgstr "" -#: ../src/Doc/library/formatter.rst:212 +#: library/formatter.rst:212 msgid "" "The standard formatter. This implementation has demonstrated wide " "applicability to many writers, and may be used directly in most " @@ -40496,11 +40923,11 @@ msgid "" "browser." msgstr "" -#: ../src/Doc/library/formatter.rst:220 +#: library/formatter.rst:220 msgid "The Writer Interface" msgstr "" -#: ../src/Doc/library/formatter.rst:222 +#: library/formatter.rst:222 msgid "" "Interfaces to create writers are dependent on the specific writer class " "being instantiated. The interfaces described below are the required " @@ -40509,11 +40936,11 @@ msgid "" "formatter, the writer must typically be provided by the application." msgstr "" -#: ../src/Doc/library/formatter.rst:231 +#: library/formatter.rst:231 msgid "Flush any buffered output or device control events." msgstr "" -#: ../src/Doc/library/formatter.rst:236 +#: library/formatter.rst:236 msgid "" "Set the alignment style. The *align* value can be any object, but by " "convention is a string or ``None``, where ``None`` indicates that the " @@ -40521,7 +40948,7 @@ msgid "" "are ``'left'``, ``'center'``, ``'right'``, and ``'justify'``." msgstr "" -#: ../src/Doc/library/formatter.rst:244 +#: library/formatter.rst:244 msgid "" "Set the font style. The value of *font* will be ``None``, indicating that " "the device's default font should be used, or a tuple of the form ``(size, " @@ -40531,7 +40958,7 @@ msgid "" "Boolean values specifying which of those font attributes should be used." msgstr "" -#: ../src/Doc/library/formatter.rst:254 +#: library/formatter.rst:254 msgid "" "Set the margin level to the integer *level* and the logical tag to *margin*. " "Interpretation of the logical tag is at the writer's discretion; the only " @@ -40539,11 +40966,11 @@ msgid "" "for non-zero values of *level*." msgstr "" -#: ../src/Doc/library/formatter.rst:262 +#: library/formatter.rst:262 msgid "Set the spacing style to *spacing*." msgstr "" -#: ../src/Doc/library/formatter.rst:267 +#: library/formatter.rst:267 msgid "" "Set additional styles. The *styles* value is a tuple of arbitrary values; " "the value :const:`AS_IS` should be ignored. The *styles* tuple may be " @@ -40551,11 +40978,11 @@ msgid "" "the application and writer implementation." msgstr "" -#: ../src/Doc/library/formatter.rst:275 +#: library/formatter.rst:275 msgid "Break the current line." msgstr "" -#: ../src/Doc/library/formatter.rst:280 +#: library/formatter.rst:280 msgid "" "Produce a paragraph separation of at least *blankline* blank lines, or the " "equivalent. The *blankline* value will be an integer. Note that the " @@ -40565,7 +40992,7 @@ msgid "" "between paragraphs." msgstr "" -#: ../src/Doc/library/formatter.rst:290 +#: library/formatter.rst:290 msgid "" "Display a horizontal rule on the output device. The arguments to this " "method are entirely application- and writer-specific, and should be " @@ -40573,7 +41000,7 @@ msgid "" "break has already been issued via :meth:`send_line_break`." msgstr "" -#: ../src/Doc/library/formatter.rst:298 +#: library/formatter.rst:298 msgid "" "Output character data which may be word-wrapped and re-flowed as needed. " "Within any sequence of calls to this method, the writer may assume that " @@ -40581,7 +41008,7 @@ msgid "" "characters." msgstr "" -#: ../src/Doc/library/formatter.rst:305 +#: library/formatter.rst:305 msgid "" "Output character data which has already been formatted for display. " "Generally, this should be interpreted to mean that line breaks indicated by " @@ -40590,7 +41017,7 @@ msgid "" "unlike data provided to the :meth:`send_formatted_data` interface." msgstr "" -#: ../src/Doc/library/formatter.rst:314 +#: library/formatter.rst:314 msgid "" "Set *data* to the left of the current left margin, if possible. The value of " "*data* is not restricted; treatment of non-string values is entirely " @@ -40598,25 +41025,25 @@ msgid "" "beginning of a line." msgstr "" -#: ../src/Doc/library/formatter.rst:323 +#: library/formatter.rst:323 msgid "Writer Implementations" msgstr "" -#: ../src/Doc/library/formatter.rst:325 +#: library/formatter.rst:325 msgid "" "Three implementations of the writer object interface are provided as " "examples by this module. Most applications will need to derive new writer " "classes from the :class:`NullWriter` class." msgstr "" -#: ../src/Doc/library/formatter.rst:332 +#: library/formatter.rst:332 msgid "" "A writer which only provides the interface definition; no actions are taken " "on any methods. This should be the base class for all writers which do not " "need to inherit any implementation methods." msgstr "" -#: ../src/Doc/library/formatter.rst:339 +#: library/formatter.rst:339 msgid "" "A writer which can be used in debugging formatters, but not much else. Each " "method simply announces itself by printing its name and arguments on " @@ -40624,7 +41051,7 @@ msgid "" msgstr "" # 504ec285d1e34dc3966edb049a199711 -#: ../src/Doc/library/formatter.rst:346 +#: library/formatter.rst:346 msgid "" "Simple writer class which writes output on the file object passed in as " "*file* or, if *file* is None, on standard output. The output is simply word-" @@ -40632,18 +41059,18 @@ msgid "" "suitable for reflowing a sequence of paragraphs." msgstr "" -#: ../src/Doc/library/fpectl.rst:3 +#: library/fpectl.rst:3 msgid ":mod:`fpectl` --- Floating point exception control" msgstr "" -#: ../src/Doc/library/fpectl.rst:14 +#: library/fpectl.rst:14 msgid "" "The :mod:`fpectl` module is not built by default, and its usage is " "discouraged and may be dangerous except in the hands of experts. See also " "the section :ref:`fpectl-limitations` on limitations for more details." msgstr "" -#: ../src/Doc/library/fpectl.rst:20 +#: library/fpectl.rst:20 msgid "" "Most computers carry out floating point operations in conformance with the " "so-called IEEE-754 standard. On any real computer, some floating point " @@ -40651,7 +41078,7 @@ msgid "" "point value. For example, try ::" msgstr "" -#: ../src/Doc/library/fpectl.rst:31 +#: library/fpectl.rst:31 msgid "" "(The example above will work on many platforms. DEC Alpha may be one " "exception.) \"Inf\" is a special, non-numeric value in IEEE-754 that stands " @@ -40662,7 +41089,7 @@ msgid "" "now." msgstr "" -#: ../src/Doc/library/fpectl.rst:38 +#: library/fpectl.rst:38 msgid "" "In some circumstances, it would be better to raise an exception and stop " "processing at the point where the faulty operation was attempted. The :mod:" @@ -40675,47 +41102,47 @@ msgid "" "the Python :exc:`FloatingPointError` exception." msgstr "" -#: ../src/Doc/library/fpectl.rst:48 +#: library/fpectl.rst:48 msgid "" "The :mod:`fpectl` module defines the following functions and may raise the " "given exception:" msgstr "" -#: ../src/Doc/library/fpectl.rst:54 +#: library/fpectl.rst:54 msgid "" "Turn on the generation of :const:`SIGFPE`, and set up an appropriate signal " "handler." msgstr "" -#: ../src/Doc/library/fpectl.rst:60 +#: library/fpectl.rst:60 msgid "Reset default handling of floating point exceptions." msgstr "" -#: ../src/Doc/library/fpectl.rst:65 +#: library/fpectl.rst:65 msgid "" "After :func:`turnon_sigfpe` has been executed, a floating point operation " "that raises one of the IEEE-754 exceptions Division by Zero, Overflow, or " "Invalid operation will in turn raise this standard Python exception." msgstr "" -#: ../src/Doc/library/fpectl.rst:75 +#: library/fpectl.rst:75 msgid "" "The following example demonstrates how to start up and test operation of " "the :mod:`fpectl` module. ::" msgstr "" -#: ../src/Doc/library/fpectl.rst:98 +#: library/fpectl.rst:98 msgid "Limitations and other considerations" msgstr "" -#: ../src/Doc/library/fpectl.rst:100 +#: library/fpectl.rst:100 msgid "" "Setting up a given processor to trap IEEE-754 floating point errors " "currently requires custom code on a per-architecture basis. You may have to " "modify :mod:`fpectl` to control your particular hardware." msgstr "" -#: ../src/Doc/library/fpectl.rst:104 +#: library/fpectl.rst:104 msgid "" "Conversion of an IEEE-754 exception to a Python exception requires that the " "wrapper macros ``PyFPE_START_PROTECT`` and ``PyFPE_END_PROTECT`` be inserted " @@ -40724,12 +41151,12 @@ msgid "" "numerical analysts have not." msgstr "" -#: ../src/Doc/library/fpectl.rst:110 +#: library/fpectl.rst:110 msgid "The :mod:`fpectl` module is not thread-safe." msgstr "" # 33f317d5245746e6ab93197bca5e8a41 -#: ../src/Doc/library/fpectl.rst:115 +#: library/fpectl.rst:115 msgid "" "Some files in the source distribution may be interesting in learning more " "about how this module operates. The include file :source:`Include/pyfpe.h` " @@ -40739,19 +41166,23 @@ msgid "" msgstr "" # 093fad5d926d4ef6b3076e8d4204d251 -#: ../src/Doc/library/fpformat.rst:3 +#: library/fpformat.rst:3 msgid ":mod:`fpformat` --- Floating point conversions" msgstr "" +#: library/fpformat.rst:9 +msgid "The :mod:`fpformat` module has been removed in Python 3." +msgstr "" + # 3b1c70e4bdb8426bb42febe7631ec270 -#: ../src/Doc/library/fpformat.rst:15 +#: library/fpformat.rst:15 msgid "" "The :mod:`fpformat` module defines functions for dealing with floating point " "numbers representations in 100% pure Python." msgstr "" # 68e52a56177a4e289fda88b72c98ca08 -#: ../src/Doc/library/fpformat.rst:20 +#: library/fpformat.rst:20 msgid "" "This module is unnecessary: everything here can be done using the ``%`` " "string interpolation operator described in the :ref:`string-formatting` " @@ -40759,20 +41190,20 @@ msgid "" msgstr "" # 31ebb599ecf84553ac8111590e571664 -#: ../src/Doc/library/fpformat.rst:23 +#: library/fpformat.rst:23 msgid "" "The :mod:`fpformat` module defines the following functions and an exception:" msgstr "" # a728f4898e224229acb935a8598fd4c2 -#: ../src/Doc/library/fpformat.rst:28 +#: library/fpformat.rst:28 msgid "" "Format *x* as ``[-]ddd.ddd`` with *digs* digits after the point and at least " "one digit before. If ``digs <= 0``, the decimal point is suppressed." msgstr "" # 50a8adbafa604fc09ea86f6a072033e1 -#: ../src/Doc/library/fpformat.rst:31 +#: library/fpformat.rst:31 msgid "" "*x* can be either a number or a string that looks like one. *digs* is an " "integer." @@ -40780,12 +41211,12 @@ msgstr "" # 5528cf28ff7446fa8454edb9950c33e6 # e8040d2ec67942e780c81ec0d50e3049 -#: ../src/Doc/library/fpformat.rst:34 ../src/Doc/library/fpformat.rst:46 +#: library/fpformat.rst:34 library/fpformat.rst:46 msgid "Return value is a string." msgstr "" # e5558532fb31402ba23438a5477cd79d -#: ../src/Doc/library/fpformat.rst:39 +#: library/fpformat.rst:39 msgid "" "Format *x* as ``[-]d.dddE[+-]ddd`` with *digs* digits after the point and " "exactly one digit before. If ``digs <= 0``, one digit is kept and the point " @@ -40793,14 +41224,14 @@ msgid "" msgstr "" # 1da103a362c24850a2b86ff8bad086f9 -#: ../src/Doc/library/fpformat.rst:43 +#: library/fpformat.rst:43 msgid "" "*x* can be either a real number, or a string that looks like one. *digs* is " "an integer." msgstr "" # 3d5f9df8b8804eb39837e6530e362b35 -#: ../src/Doc/library/fpformat.rst:51 +#: library/fpformat.rst:51 msgid "" "Exception raised when a string passed to :func:`fix` or :func:`sci` as the " "*x* parameter does not look like a number. This is a subclass of :exc:" @@ -40808,27 +41239,27 @@ msgid "" "is the improperly formatted string that caused the exception to be raised." msgstr "" -#: ../src/Doc/library/fractions.rst:2 +#: library/fractions.rst:2 msgid ":mod:`fractions` --- Rational numbers" msgstr "" # c1b451e12cae4583b4e867f42d9ceb78 -#: ../src/Doc/library/fractions.rst:10 +#: library/fractions.rst:10 msgid "**Source code:** :source:`Lib/fractions.py`" msgstr "" -#: ../src/Doc/library/fractions.rst:14 +#: library/fractions.rst:14 msgid "" "The :mod:`fractions` module provides support for rational number arithmetic." msgstr "" -#: ../src/Doc/library/fractions.rst:17 +#: library/fractions.rst:17 msgid "" "A Fraction instance can be constructed from a pair of integers, from another " "rational number, or from a string." msgstr "" -#: ../src/Doc/library/fractions.rst:26 +#: library/fractions.rst:26 msgid "" "The first version requires that *numerator* and *denominator* are instances " "of :class:`numbers.Rational` and returns a new :class:`Fraction` instance " @@ -40846,7 +41277,7 @@ msgid "" "instance. The usual form for this instance is::" msgstr "" -#: ../src/Doc/library/fractions.rst:43 +#: library/fractions.rst:43 msgid "" "where the optional ``sign`` may be either '+' or '-' and ``numerator`` and " "``denominator`` (if present) are strings of decimal digits. In addition, " @@ -40856,7 +41287,7 @@ msgid "" "whitespace. Here are some examples::" msgstr "" -#: ../src/Doc/library/fractions.rst:77 +#: library/fractions.rst:77 msgid "" "The :class:`Fraction` class inherits from the abstract base class :class:" "`numbers.Rational`, and implements all of the methods and operations from " @@ -40864,46 +41295,52 @@ msgid "" "as immutable. In addition, :class:`Fraction` has the following methods:" msgstr "" -#: ../src/Doc/library/fractions.rst:90 +#: library/fractions.rst:83 +msgid "" +"The :class:`Fraction` constructor now accepts :class:`float` and :class:" +"`decimal.Decimal` instances." +msgstr "" + +#: library/fractions.rst:90 msgid "" "This class method constructs a :class:`Fraction` representing the exact " "value of *flt*, which must be a :class:`float`. Beware that ``Fraction." -"from_float(0.3)`` is not the same value as ``Fraction(3, 10)``" +"from_float(0.3)`` is not the same value as ``Fraction(3, 10)``." msgstr "" # 1263f39233af4074a87b0ee92c599cae -#: ../src/Doc/library/fractions.rst:94 +#: library/fractions.rst:94 msgid "" "From Python 2.7 onwards, you can also construct a :class:`Fraction` instance " "directly from a :class:`float`." msgstr "" # 8a09d82341f247b697066fed6396114a -#: ../src/Doc/library/fractions.rst:100 +#: library/fractions.rst:100 msgid "" "This class method constructs a :class:`Fraction` representing the exact " "value of *dec*, which must be a :class:`decimal.Decimal`." msgstr "" # a2bd98b9695142fb8585e409684f6e16 -#: ../src/Doc/library/fractions.rst:103 +#: library/fractions.rst:103 msgid "" "From Python 2.7 onwards, you can also construct a :class:`Fraction` instance " "directly from a :class:`decimal.Decimal` instance." msgstr "" -#: ../src/Doc/library/fractions.rst:110 +#: library/fractions.rst:110 msgid "" "Finds and returns the closest :class:`Fraction` to ``self`` that has " "denominator at most max_denominator. This method is useful for finding " "rational approximations to a given floating-point number:" msgstr "" -#: ../src/Doc/library/fractions.rst:118 +#: library/fractions.rst:118 msgid "or for recovering a rational number that's represented as a float:" msgstr "" -#: ../src/Doc/library/fractions.rst:131 +#: library/fractions.rst:131 msgid "" "Return the greatest common divisor of the integers *a* and *b*. If either " "*a* or *b* is nonzero, then the absolute value of ``gcd(a, b)`` is the " @@ -40912,22 +41349,22 @@ msgid "" "0)`` returns ``0``." msgstr "" -# d5e656a2b4a048e18feff0997429cbdc -#: ../src/Doc/library/fractions.rst:139 -msgid "Module :mod:`numbers`" -msgstr "" +#: library/fractions.rst:140 +#, fuzzy +msgid "Module numbers" +msgstr "Modules" -#: ../src/Doc/library/fractions.rst:141 +#: library/fractions.rst:141 msgid "The abstract base classes making up the numeric tower." msgstr "" # 4d691acca3bc481ca8cd2086e0b97b27 -#: ../src/Doc/library/framework.rst:3 +#: library/framework.rst:3 msgid ":mod:`FrameWork` --- Interactive application framework" msgstr "" # c082280ba0f14204a5840ec80802c7ec -#: ../src/Doc/library/framework.rst:11 +#: library/framework.rst:11 msgid "" "The :mod:`FrameWork` module contains classes that together provide a " "framework for an interactive Macintosh application. The programmer builds an " @@ -40939,7 +41376,7 @@ msgid "" msgstr "" # 9369da507b554a7faf6413dea6d21806 -#: ../src/Doc/library/framework.rst:23 +#: library/framework.rst:23 msgid "" "Work on the :mod:`FrameWork` has pretty much stopped, now that :mod:`PyObjC` " "is available for full Cocoa access from Python, and the documentation " @@ -40950,7 +41387,7 @@ msgid "" msgstr "" # d0140c80051b4bbd914dbdcc4c0cf61a -#: ../src/Doc/library/framework.rst:33 +#: library/framework.rst:33 msgid "" "The strong point of :mod:`FrameWork` is that it allows you to break into the " "control-flow at many different places. :mod:`W`, for instance, uses a " @@ -40961,12 +41398,12 @@ msgid "" msgstr "" # 840c2e2aad1e480a9a8bf1b63cd2433b -#: ../src/Doc/library/framework.rst:40 +#: library/framework.rst:40 msgid "The :mod:`FrameWork` module defines the following functions:" msgstr "" # ddd0e4d4d4424bce89f8db26c60f9cae -#: ../src/Doc/library/framework.rst:45 +#: library/framework.rst:45 msgid "" "An object representing the complete application. See below for a description " "of the methods. The default :meth:`__init__` routine creates an empty window " @@ -40974,14 +41411,14 @@ msgid "" msgstr "" # ba26f0299b674efea0056bf6ab83dc93 -#: ../src/Doc/library/framework.rst:52 +#: library/framework.rst:52 msgid "" "An object representing the menubar. This object is usually not created by " "the user." msgstr "" # 45174fd3d9084d7badb9a1fc98643d10 -#: ../src/Doc/library/framework.rst:58 +#: library/framework.rst:58 msgid "" "An object representing a menu. Upon creation you pass the ``MenuBar`` the " "menu appears in, the *title* string and a position (1-based) *after* where " @@ -40989,7 +41426,7 @@ msgid "" msgstr "" # bfc75fd74c7b43cc95492f45f00c0a0b -#: ../src/Doc/library/framework.rst:65 +#: library/framework.rst:65 msgid "" "Create a menu item object. The arguments are the menu to create, the item " "title string and optionally the keyboard shortcut and a callback routine. " @@ -40998,7 +41435,7 @@ msgid "" msgstr "" # 0e61da2ce6ef4566ba250d55e72a7441 -#: ../src/Doc/library/framework.rst:70 +#: library/framework.rst:70 msgid "" "Instead of a callable object the callback can also be a string. In this case " "menu selection causes the lookup of a method in the topmost window and the " @@ -41007,38 +41444,38 @@ msgid "" msgstr "" # a663f007cc4741949b1fdcc8147e6233 -#: ../src/Doc/library/framework.rst:75 +#: library/framework.rst:75 msgid "" "Calling the ``MenuBar`` :meth:`fixmenudimstate` method sets the correct " "dimming for all menu items based on the current front window." msgstr "" # e5463fa4f57c4650995677306cc9a5bd -#: ../src/Doc/library/framework.rst:81 +#: library/framework.rst:81 msgid "Add a separator to the end of a menu." msgstr "" # 73e3d0b4ca984d3ea5ddb048f256adf0 -#: ../src/Doc/library/framework.rst:86 +#: library/framework.rst:86 msgid "" "Create a submenu named *label* under menu *menu*. The menu object is " "returned." msgstr "" # 3ab5270a392648d5bf38b137a97f12af -#: ../src/Doc/library/framework.rst:91 +#: library/framework.rst:91 msgid "" "Creates a (modeless) window. *Parent* is the application object to which the " "window belongs. The window is not displayed until later." msgstr "" # 3532b816b78245238984824458e52ec6 -#: ../src/Doc/library/framework.rst:97 +#: library/framework.rst:97 msgid "Creates a modeless dialog window." msgstr "" # 93a754dec75f412890c85c89a35567de -#: ../src/Doc/library/framework.rst:102 +#: library/framework.rst:102 msgid "" "Return a ``(left, top, right, bottom)`` tuple suitable for creation of a " "window of given width and height. The window will be staggered with respect " @@ -41048,34 +41485,34 @@ msgid "" msgstr "" # 44f194424d8d45b18b481f026b5c4ef4 -#: ../src/Doc/library/framework.rst:110 +#: library/framework.rst:110 msgid "Set the mouse cursor to a watch." msgstr "" # dab9b20fe53346d6bd2828f9b69020a9 -#: ../src/Doc/library/framework.rst:115 +#: library/framework.rst:115 msgid "Set the mouse cursor to an arrow." msgstr "" # f647cebda44944e1b4665b09fdfa2cba -#: ../src/Doc/library/framework.rst:121 +#: library/framework.rst:121 msgid "Application Objects" msgstr "" # 4722c12e512645d4a4f61bb9d3cee86a -#: ../src/Doc/library/framework.rst:123 +#: library/framework.rst:123 msgid "Application objects have the following methods, among others:" msgstr "" # 24c883ced93344be9b0fafdd1720d181 -#: ../src/Doc/library/framework.rst:128 +#: library/framework.rst:128 msgid "" "Override this method if you need menus in your application. Append the menus " "to the attribute :attr:`menubar`." msgstr "" # 18eeea9053ec45fe8db6f17793310b1e -#: ../src/Doc/library/framework.rst:134 +#: library/framework.rst:134 msgid "" "Override this method to return a text string describing your application. " "Alternatively, override the :meth:`do_about` method for more elaborate " @@ -41083,7 +41520,7 @@ msgid "" msgstr "" # 9d09b8066da64daa9c2f33e62a1ed155 -#: ../src/Doc/library/framework.rst:141 +#: library/framework.rst:141 msgid "" "This routine is the main event loop, call it to set your application " "rolling. *Mask* is the mask of events you want to handle, *wait* is the " @@ -41094,7 +41531,7 @@ msgid "" msgstr "" # 23af0de81f104a75900b5e1fe2839511 -#: ../src/Doc/library/framework.rst:147 +#: library/framework.rst:147 msgid "" "The event loop is split into many small parts, each of which can be " "overridden. The default methods take care of dispatching events to windows " @@ -41103,7 +41540,7 @@ msgid "" msgstr "" # 0b556100713e4397b7f291d627e59dda -#: ../src/Doc/library/framework.rst:151 +#: library/framework.rst:151 msgid "" "In general, all event handlers should return ``1`` if the event is fully " "handled and ``0`` otherwise (because the front window was not a FrameWork " @@ -41115,7 +41552,7 @@ msgid "" msgstr "" # 87172a78d5344fbbb704402d4a0cc093 -#: ../src/Doc/library/framework.rst:161 +#: library/framework.rst:161 msgid "" "Call this method with a nonzero parameter to enable asynchronous event " "handling. This will tell the inner interpreter loop to call the application " @@ -41129,18 +41566,18 @@ msgid "" msgstr "" # fc3def50f2c54d3e9754878e6eda44db -#: ../src/Doc/library/framework.rst:170 +#: library/framework.rst:170 msgid "The old on/off value is returned." msgstr "" # 7be456f3dff94b9590da580f166021f9 -#: ../src/Doc/library/framework.rst:175 +#: library/framework.rst:175 msgid "" "Terminate the running :meth:`mainloop` call at the next convenient moment." msgstr "" # e6d03b87d71a4229aba2667bb99ad69b -#: ../src/Doc/library/framework.rst:180 +#: library/framework.rst:180 msgid "" "The user typed character *c*. The complete details of the event can be found " "in the *event* structure. This method can also be provided in a ``Window`` " @@ -41149,7 +41586,7 @@ msgid "" msgstr "" # b14e18063b804a19b7e56492a022fb8e -#: ../src/Doc/library/framework.rst:187 +#: library/framework.rst:187 msgid "" "Called early in the event loop to handle modeless dialog events. The default " "method simply dispatches the event to the relevant dialog (not through the " @@ -41158,19 +41595,19 @@ msgid "" msgstr "" # 0e0627328c1e4a779a2acca601e947bc -#: ../src/Doc/library/framework.rst:195 +#: library/framework.rst:195 msgid "" "Called by the main event loop when no events are available. The null-event " "is passed (so you can look at mouse position, etc)." msgstr "" # 450b4a01ac5f49c1bd9c0eb5b918f304 -#: ../src/Doc/library/framework.rst:204 +#: library/framework.rst:204 msgid "Window objects have the following methods, among others:" msgstr "" # 9e693b780bde4ef69fc1a52a55180aef -#: ../src/Doc/library/framework.rst:209 +#: library/framework.rst:209 msgid "" "Override this method to open a window. Store the Mac OS window-id in :attr:" "`self.wid` and call the :meth:`do_postopen` method to register the window " @@ -41178,71 +41615,71 @@ msgid "" msgstr "" # 3fe3d38b994d4f6e84a8fedeb1a29b1a -#: ../src/Doc/library/framework.rst:216 +#: library/framework.rst:216 msgid "" "Override this method to do any special processing on window close. Call the :" "meth:`do_postclose` method to cleanup the parent state." msgstr "" # 91c1c6b5804a43c6895a6b41c67b6926 -#: ../src/Doc/library/framework.rst:222 +#: library/framework.rst:222 msgid "" "Called after the window is resized. Override if more needs to be done than " "calling ``InvalRect``." msgstr "" # 9ceac3e1e0924b30a270cdec317b71be -#: ../src/Doc/library/framework.rst:228 +#: library/framework.rst:228 msgid "" "The user clicked in the content part of a window. The arguments are the " "coordinates (window-relative), the key modifiers and the raw event." msgstr "" # c9c3407a8bb34715986ed4b7ec1058c1 -#: ../src/Doc/library/framework.rst:234 +#: library/framework.rst:234 msgid "An update event for the window was received. Redraw the window." msgstr "" # 7d6c328f263143b2bb892270ec991111 -#: ../src/Doc/library/framework.rst:239 +#: library/framework.rst:239 msgid "" "The window was activated (``activate == 1``) or deactivated (``activate == " "0``). Handle things like focus highlighting, etc." msgstr "" # f21e0872dd474841b8b424a8f3f779fc -#: ../src/Doc/library/framework.rst:246 +#: library/framework.rst:246 msgid "ControlsWindow Object" msgstr "" # 32720a31f80f4266a86a70c19c170ac6 -#: ../src/Doc/library/framework.rst:248 +#: library/framework.rst:248 msgid "" "ControlsWindow objects have the following methods besides those of " "``Window`` objects:" msgstr "" # a8142996d2e0426bbc2fb1d721508ee0 -#: ../src/Doc/library/framework.rst:254 +#: library/framework.rst:254 msgid "" "Part *pcode* of control *control* was hit by the user. Tracking and such has " "already been taken care of." msgstr "" # bf98756f050b4e65b0eb42575211041e -#: ../src/Doc/library/framework.rst:261 +#: library/framework.rst:261 msgid "ScrolledWindow Object" msgstr "" # 680c0be6b339423fa2c6f2b19ee84180 -#: ../src/Doc/library/framework.rst:263 +#: library/framework.rst:263 msgid "" "ScrolledWindow objects are ControlsWindow objects with the following extra " "methods:" msgstr "" # bdc67f30d190484c893995dabaaa05e0 -#: ../src/Doc/library/framework.rst:269 +#: library/framework.rst:269 msgid "" "Create (or destroy) horizontal and vertical scrollbars. The arguments " "specify which you want (default: both). The scrollbars always have minimum " @@ -41250,7 +41687,7 @@ msgid "" msgstr "" # d018f7f25fd24da5b689550973014bf9 -#: ../src/Doc/library/framework.rst:276 +#: library/framework.rst:276 msgid "" "You must supply this method. It should return a tuple ``(x, y)`` giving the " "current position of the scrollbars (between ``0`` and ``32767``). You can " @@ -41259,14 +41696,14 @@ msgid "" msgstr "" # 52c237cb8b6949d78b9980b4c266e4bb -#: ../src/Doc/library/framework.rst:283 +#: library/framework.rst:283 msgid "" "Call this method when the document has changed. It will call :meth:" "`getscrollbarvalues` and update the scrollbars." msgstr "" # 849a82902cff4410918c65c5b2d4a54f -#: ../src/Doc/library/framework.rst:289 +#: library/framework.rst:289 msgid "" "Supplied by you and called after user interaction. *which* will be ``'x'`` " "or ``'y'``, *what* will be ``'-'``, ``'--'``, ``'set'``, ``'++'`` or " @@ -41274,7 +41711,7 @@ msgid "" msgstr "" # 780cce7f430f4a83a10cfd47a54a8fe9 -#: ../src/Doc/library/framework.rst:296 +#: library/framework.rst:296 msgid "" "Auxiliary method to help you calculate values to return from :meth:" "`getscrollbarvalues`. You pass document minimum and maximum value and " @@ -41283,7 +41720,7 @@ msgid "" msgstr "" # 41ed2359c8b945a2824c6c0aed1a373a -#: ../src/Doc/library/framework.rst:304 +#: library/framework.rst:304 msgid "" "Takes care of dimming/highlighting scrollbars when a window becomes " "frontmost. If you override this method, call this one at the end of your " @@ -41291,14 +41728,14 @@ msgid "" msgstr "" # f0d95ac1bab24680b724d0d4bb2e3114 -#: ../src/Doc/library/framework.rst:310 +#: library/framework.rst:310 msgid "" "Moves scrollbars to the correct position. Call this method initially if you " "override it." msgstr "" # fe62c5aea35c4cc39247ac018d745ba5 -#: ../src/Doc/library/framework.rst:316 +#: library/framework.rst:316 msgid "" "Handles scrollbar interaction. If you override it call this method first, a " "nonzero return value indicates the hit was in the scrollbars and has been " @@ -41306,53 +41743,53 @@ msgid "" msgstr "" # 575a09dcde5d49d88a0f7e4d5c9dcf6e -#: ../src/Doc/library/framework.rst:324 +#: library/framework.rst:324 msgid "DialogWindow Objects" msgstr "" # 5fa4cc35d00643fe93c9da3919ea2c64 -#: ../src/Doc/library/framework.rst:326 +#: library/framework.rst:326 msgid "" "DialogWindow objects have the following methods besides those of ``Window`` " "objects:" msgstr "" # b5abf89ea02d41169f8ffd81c7d9cbaf -#: ../src/Doc/library/framework.rst:332 +#: library/framework.rst:332 msgid "" "Create the dialog window, from the DLOG resource with id *resid*. The dialog " "object is stored in :attr:`self.wid`." msgstr "" # 1e7ece38ff324eb69a4b2834c9a71eb6 -#: ../src/Doc/library/framework.rst:338 +#: library/framework.rst:338 msgid "" "Item number *item* was hit. You are responsible for redrawing toggle " "buttons, etc." msgstr "" -#: ../src/Doc/library/frameworks.rst:6 +#: library/frameworks.rst:6 msgid "Program Frameworks" msgstr "" -#: ../src/Doc/library/frameworks.rst:8 +#: library/frameworks.rst:8 msgid "" "The modules described in this chapter are frameworks that will largely " "dictate the structure of your program. Currently the modules described " "here are all oriented toward writing command-line interfaces." msgstr "" -#: ../src/Doc/library/ftplib.rst:2 +#: library/ftplib.rst:2 msgid ":mod:`ftplib` --- FTP protocol client" msgstr "" # fb4b580d0de6401e922881d3424d0db0 -#: ../src/Doc/library/ftplib.rst:12 +#: library/ftplib.rst:12 msgid "**Source code:** :source:`Lib/ftplib.py`" msgstr "" # 2b7a475140cd489aa01586919ce3cb66 -#: ../src/Doc/library/ftplib.rst:16 +#: library/ftplib.rst:16 msgid "" "This module defines the class :class:`FTP` and a few related items. The :" "class:`FTP` class implements the client side of the FTP protocol. You can " @@ -41362,16 +41799,15 @@ msgid "" "Transfer Protocol), see Internet :rfc:`959`." msgstr "" -#: ../src/Doc/library/ftplib.rst:23 +#: library/ftplib.rst:23 msgid "Here's a sample session using the :mod:`ftplib` module::" msgstr "" -#: ../src/Doc/library/ftplib.rst:42 ../src/Doc/library/gzip.rst:25 -#: ../src/Doc/library/zipfile.rst:28 +#: library/ftplib.rst:42 library/gzip.rst:25 library/zipfile.rst:28 msgid "The module defines the following items:" msgstr "" -#: ../src/Doc/library/ftplib.rst:46 +#: library/ftplib.rst:46 msgid "" "Return a new instance of the :class:`FTP` class. When *host* is given, the " "method call ``connect(host)`` is made. When *user* is given, additionally " @@ -41382,48 +41818,67 @@ msgid "" "will be used)." msgstr "" -# ab1fac00ce8845d0acb9f9d5624521f6 -#: ../src/Doc/library/ftplib.rst:60 +#: library/ftplib.rst:54 library/ftplib.rst:181 library/httplib.rst:71 +#: library/httplib.rst:93 library/poplib.rst:38 library/smtplib.rst:42 +#: library/telnetlib.rst:46 library/telnetlib.rst:138 library/urllib2.rst:82 +#: library/urllib2.rst:483 +msgid "*timeout* was added." +msgstr "" + +#: library/ftplib.rst:60 msgid "" "A :class:`FTP` subclass which adds TLS support to FTP as described in :rfc:" "`4217`. Connect as usual to port 21 implicitly securing the FTP control " "connection before authenticating. Securing the data connection requires the " -"user to explicitly ask for it by calling the :meth:`prot_p` method. " -"*keyfile* and *certfile* are optional -- they can contain a PEM formatted " -"private key and certificate chain file name for the SSL connection." +"user to explicitly ask for it by calling the :meth:`prot_p` method. " +"*context* is a :class:`ssl.SSLContext` object which allows bundling SSL " +"configuration options, certificates and private keys into a single " +"(potentially long-lived) structure. Please read :ref:`ssl-security` for " +"best practices." msgstr "" -#: ../src/Doc/library/ftplib.rst:70 +#: library/ftplib.rst:69 +msgid "" +"*keyfile* and *certfile* are a legacy alternative to *context* -- they can " +"point to PEM-formatted private key and certificate chain files " +"(respectively) for the SSL connection." +msgstr "" + +#: library/ftplib.rst:75 library/urllib.rst:144 +msgid "The *context* parameter was added." +msgstr "" + +#: library/ftplib.rst:78 msgid "Here's a sample session using the :class:`FTP_TLS` class:" msgstr "" -#: ../src/Doc/library/ftplib.rst:94 +#: library/ftplib.rst:102 msgid "Exception raised when an unexpected reply is received from the server." msgstr "" # f66f9937072d4b54b663a0ccad0bc4d6 -#: ../src/Doc/library/ftplib.rst:99 +#: library/ftplib.rst:107 msgid "" "Exception raised when an error code signifying a temporary error (response " "codes in the range 400--499) is received." msgstr "" # 705736298e5c4f79837ba0d092bdc3b5 -#: ../src/Doc/library/ftplib.rst:105 +#: library/ftplib.rst:113 msgid "" "Exception raised when an error code signifying a permanent error (response " "codes in the range 500--599) is received." msgstr "" # a8722575bb4841b7a6a833cf934818e4 -#: ../src/Doc/library/ftplib.rst:111 +#: library/ftplib.rst:119 msgid "" "Exception raised when a reply is received from the server that does not fit " "the response specifications of the File Transfer Protocol, i.e. begin with a " "digit in the range 1--5." msgstr "" -#: ../src/Doc/library/ftplib.rst:118 +#: library/ftplib.rst:126 msgid "" "The set of all exceptions (as a tuple) that methods of :class:`FTP` " "instances may raise as a result of problems with the FTP connection (as " @@ -41432,19 +41887,19 @@ msgid "" "`IOError`." msgstr "" -# 48c7b5bb92c04a89a8aadb8881243e50 -#: ../src/Doc/library/ftplib.rst:129 -msgid "Module :mod:`netrc`" -msgstr "" +#: library/ftplib.rst:138 +#, fuzzy +msgid "Module netrc" +msgstr "Modules" -#: ../src/Doc/library/ftplib.rst:128 +#: library/ftplib.rst:136 msgid "" "Parser for the :file:`.netrc` file format. The file :file:`.netrc` is " "typically used by FTP clients to load user authentication information before " "prompting the user." msgstr "" -#: ../src/Doc/library/ftplib.rst:134 +#: library/ftplib.rst:142 msgid "" "The file :file:`Tools/scripts/ftpmirror.py` in the Python source " "distribution is a script that can mirror FTP sites, or portions thereof, " @@ -41452,11 +41907,11 @@ msgid "" "applies this module." msgstr "" -#: ../src/Doc/library/ftplib.rst:142 +#: library/ftplib.rst:150 msgid "FTP Objects" msgstr "" -#: ../src/Doc/library/ftplib.rst:144 +#: library/ftplib.rst:152 msgid "" "Several methods are available in two flavors: one for handling text files " "and another for binary files. These are named for the command which is used " @@ -41464,11 +41919,11 @@ msgid "" "version." msgstr "" -#: ../src/Doc/library/ftplib.rst:148 +#: library/ftplib.rst:156 msgid ":class:`FTP` instances have the following methods:" msgstr "" -#: ../src/Doc/library/ftplib.rst:153 ../src/Doc/library/poplib.rst:85 +#: library/ftplib.rst:161 library/poplib.rst:85 msgid "" "Set the instance's debugging level. This controls the amount of debugging " "output printed. The default, ``0``, produces no debugging output. A value " @@ -41478,7 +41933,7 @@ msgid "" "connection." msgstr "" -#: ../src/Doc/library/ftplib.rst:162 +#: library/ftplib.rst:170 msgid "" "Connect to the given host and port. The default port number is ``21``, as " "specified by the FTP protocol specification. It is rarely needed to specify " @@ -41488,21 +41943,21 @@ msgid "" "has been made." msgstr "" -#: ../src/Doc/library/ftplib.rst:169 +#: library/ftplib.rst:177 msgid "" "The optional *timeout* parameter specifies a timeout in seconds for the " "connection attempt. If no *timeout* is passed, the global default timeout " "setting will be used." msgstr "" -#: ../src/Doc/library/ftplib.rst:179 ../src/Doc/library/nntplib.rst:130 +#: library/ftplib.rst:187 library/nntplib.rst:130 msgid "" "Return the welcome message sent by the server in reply to the initial " "connection. (This message sometimes contains disclaimers or help " "information that may be relevant to the user.)" msgstr "" -#: ../src/Doc/library/ftplib.rst:186 +#: library/ftplib.rst:194 msgid "" "Log in as the given *user*. The *passwd* and *acct* parameters are optional " "and default to the empty string. If no *user* is specified, it defaults to " @@ -41514,19 +41969,19 @@ msgid "" "parameter supplies \"accounting information\"; few systems implement this." msgstr "" -#: ../src/Doc/library/ftplib.rst:198 +#: library/ftplib.rst:206 msgid "" "Abort a file transfer that is in progress. Using this does not always work, " "but it's worth a try." msgstr "" -#: ../src/Doc/library/ftplib.rst:204 +#: library/ftplib.rst:212 msgid "" "Send a simple command string to the server and return the response string." msgstr "" # c26917fb37f445388517efc5628dc15d -#: ../src/Doc/library/ftplib.rst:209 +#: library/ftplib.rst:217 msgid "" "Send a simple command string to the server and handle the response. Return " "nothing if a response code corresponding to success (codes in the range " @@ -41534,7 +41989,7 @@ msgid "" msgstr "" # 786f991137b8422480d1cb84e0f29eb9 -#: ../src/Doc/library/ftplib.rst:216 +#: library/ftplib.rst:224 msgid "" "Retrieve a file in binary transfer mode. *command* should be an appropriate " "``RETR`` command: ``'RETR filename'``. The *callback* function is called for " @@ -41547,7 +42002,7 @@ msgid "" msgstr "" # 083f213f49a84679be5e9bb2b8262d8d -#: ../src/Doc/library/ftplib.rst:228 +#: library/ftplib.rst:236 msgid "" "Retrieve a file or directory listing in ASCII transfer mode. *command* " "should be an appropriate ``RETR`` command (see :meth:`retrbinary`) or a " @@ -41561,7 +42016,7 @@ msgid "" msgstr "" # 808f6a22696c4e2a90d1ffccaebcfbcf -#: ../src/Doc/library/ftplib.rst:240 +#: library/ftplib.rst:248 msgid "" "Enable \"passive\" mode if *boolean* is true, other disable passive mode. " "(In Python 2.0 and before, passive mode was off by default; in Python 2.1 " @@ -41569,7 +42024,7 @@ msgid "" msgstr "" # 21bbeb864ee641b9b27ce3f042c30dba -#: ../src/Doc/library/ftplib.rst:247 +#: library/ftplib.rst:255 msgid "" "Store a file in binary transfer mode. *command* should be an appropriate " "``STOR`` command: ``\"STOR filename\"``. *file* is an open file object which " @@ -41580,8 +42035,20 @@ msgid "" "thing as in the :meth:`transfercmd` method." msgstr "" +#: library/ftplib.rst:263 +msgid "default for *blocksize* added." +msgstr "" + +#: library/ftplib.rst:266 library/ftplib.rst:280 +msgid "*callback* parameter added." +msgstr "" + +#: library/ftplib.rst:269 +msgid "*rest* parameter added." +msgstr "" + # 467c34cbf5324e719b10fb154bd2f789 -#: ../src/Doc/library/ftplib.rst:266 +#: library/ftplib.rst:274 msgid "" "Store a file in ASCII transfer mode. *command* should be an appropriate " "``STOR`` command (see :meth:`storbinary`). Lines are read until EOF from " @@ -41590,7 +42057,7 @@ msgid "" "callable that is called on each line after it is sent." msgstr "" -#: ../src/Doc/library/ftplib.rst:278 +#: library/ftplib.rst:286 msgid "" "Initiate a transfer over the data connection. If the transfer is active, " "send a ``EPRT`` or ``PORT`` command and the transfer command specified by " @@ -41599,7 +42066,7 @@ msgid "" "way, return the socket for the connection." msgstr "" -#: ../src/Doc/library/ftplib.rst:284 +#: library/ftplib.rst:292 msgid "" "If optional *rest* is given, a ``REST`` command is sent to the server, " "passing *rest* as an argument. *rest* is usually a byte offset into the " @@ -41613,7 +42080,7 @@ msgid "" "happens, simply call :meth:`transfercmd` without a *rest* argument." msgstr "" -#: ../src/Doc/library/ftplib.rst:298 +#: library/ftplib.rst:306 msgid "" "Like :meth:`transfercmd`, but returns a tuple of the data connection and the " "expected size of the data. If the expected size could not be computed, " @@ -41622,7 +42089,7 @@ msgid "" msgstr "" # 55ef33b82bd841c2aabd8955c68be026 -#: ../src/Doc/library/ftplib.rst:306 +#: library/ftplib.rst:314 msgid "" "Return a list of file names as returned by the ``NLST`` command. The " "optional *argument* is a directory to list (default is the current server " @@ -41630,7 +42097,7 @@ msgid "" "the ``NLST`` command." msgstr "" -#: ../src/Doc/library/ftplib.rst:314 +#: library/ftplib.rst:322 msgid "" "Produce a directory listing as returned by the ``LIST`` command, printing it " "to standard output. The optional *argument* is a directory to list (default " @@ -41640,34 +42107,34 @@ msgid "" "default prints to ``sys.stdout``. This method returns ``None``." msgstr "" -#: ../src/Doc/library/ftplib.rst:324 +#: library/ftplib.rst:332 msgid "Rename file *fromname* on the server to *toname*." msgstr "" -#: ../src/Doc/library/ftplib.rst:329 +#: library/ftplib.rst:337 msgid "" "Remove the file named *filename* from the server. If successful, returns " "the text of the response, otherwise raises :exc:`error_perm` on permission " "errors or :exc:`error_reply` on other errors." msgstr "" -#: ../src/Doc/library/ftplib.rst:336 +#: library/ftplib.rst:344 msgid "Set the current directory on the server." msgstr "" -#: ../src/Doc/library/ftplib.rst:341 +#: library/ftplib.rst:349 msgid "Create a new directory on the server." msgstr "" -#: ../src/Doc/library/ftplib.rst:346 +#: library/ftplib.rst:354 msgid "Return the pathname of the current directory on the server." msgstr "" -#: ../src/Doc/library/ftplib.rst:351 +#: library/ftplib.rst:359 msgid "Remove the directory named *dirname* on the server." msgstr "" -#: ../src/Doc/library/ftplib.rst:356 +#: library/ftplib.rst:364 msgid "" "Request the size of the file named *filename* on the server. On success, " "the size of the file is returned as an integer, otherwise ``None`` is " @@ -41675,7 +42142,7 @@ msgid "" "supported by many common server implementations." msgstr "" -#: ../src/Doc/library/ftplib.rst:364 +#: library/ftplib.rst:372 msgid "" "Send a ``QUIT`` command to the server and close the connection. This is the " "\"polite\" way to close a connection, but it may raise an exception if the " @@ -41685,7 +42152,7 @@ msgid "" msgstr "" # b682acdc5f9d48a0b2b497deddbfae3a -#: ../src/Doc/library/ftplib.rst:373 +#: library/ftplib.rst:381 msgid "" "Close the connection unilaterally. This should not be applied to an already " "closed connection such as after a successful call to :meth:`~FTP.quit`. " @@ -41694,441 +42161,429 @@ msgid "" "connection by issuing another :meth:`login` method)." msgstr "" -#: ../src/Doc/library/ftplib.rst:381 +#: library/ftplib.rst:389 msgid "FTP_TLS Objects" msgstr "" -#: ../src/Doc/library/ftplib.rst:383 +#: library/ftplib.rst:391 msgid "" ":class:`FTP_TLS` class inherits from :class:`FTP`, defining these additional " "objects:" msgstr "" -#: ../src/Doc/library/ftplib.rst:387 -msgid "The SSL version to use (defaults to *TLSv1*)." +#: library/ftplib.rst:395 +msgid "The SSL version to use (defaults to :attr:`ssl.PROTOCOL_SSLv23`)." msgstr "" -#: ../src/Doc/library/ftplib.rst:391 +#: library/ftplib.rst:399 msgid "" "Set up secure control connection by using TLS or SSL, depending on what " "specified in :meth:`ssl_version` attribute." msgstr "" -#: ../src/Doc/library/ftplib.rst:396 +#: library/ftplib.rst:404 msgid "Set up secure data connection." msgstr "" -#: ../src/Doc/library/ftplib.rst:400 +#: library/ftplib.rst:408 msgid "Set up clear text data connection." msgstr "" -#: ../src/Doc/library/functions.rst:5 ../src/Doc/library/functions.rst:11 +#: library/functions.rst:5 library/functions.rst:11 msgid "Built-in Functions" msgstr "" # 4dc96dc54df449d2a92a8371424e6924 -#: ../src/Doc/library/functions.rst:7 +#: library/functions.rst:7 msgid "" "The Python interpreter has a number of functions built into it that are " "always available. They are listed here in alphabetical order." msgstr "" -#: ../src/Doc/library/functions.rst:13 +#: library/functions.rst:13 msgid ":func:`abs`" msgstr "" -#: ../src/Doc/library/functions.rst:13 +#: library/functions.rst:13 msgid ":func:`divmod`" msgstr "" # 593f6728b7f14cbb8063da21cee1308f -#: ../src/Doc/library/functions.rst:13 +#: library/functions.rst:13 msgid ":func:`input`" msgstr "" # dd53f5be11e7432a8dcc3ab1e97da9a4 -#: ../src/Doc/library/functions.rst:13 +#: library/functions.rst:13 msgid ":func:`open`" msgstr "" # 54be2b12c2e0424c8edae9d372a659dc -#: ../src/Doc/library/functions.rst:13 +#: library/functions.rst:13 msgid ":func:`staticmethod`" msgstr "" # d6f8f4fd345546eeb07c1e9b61a57e6a -#: ../src/Doc/library/functions.rst:14 +#: library/functions.rst:14 msgid ":func:`all`" msgstr "" # 0cc34239b2404337996c033d5d20f4c1 -#: ../src/Doc/library/functions.rst:14 +#: library/functions.rst:14 msgid ":func:`enumerate`" msgstr "" -#: ../src/Doc/library/functions.rst:14 +#: library/functions.rst:14 msgid ":func:`int`" msgstr "" # 09b5e4043ab14a5fbb6896878914e5fd -#: ../src/Doc/library/functions.rst:14 +#: library/functions.rst:14 msgid ":func:`ord`" msgstr "" # 20de1ea4b43b4423821d39e4badbe906 -#: ../src/Doc/library/functions.rst:14 +#: library/functions.rst:14 msgid ":func:`str`" msgstr "" # 117799b6217b499ab33c6d6d47764ca1 -#: ../src/Doc/library/functions.rst:15 +#: library/functions.rst:15 msgid ":func:`any`" msgstr "" # adf9112d180e48d18d3041d1eead5106 -#: ../src/Doc/library/functions.rst:15 +#: library/functions.rst:15 msgid ":func:`eval`" msgstr "" # 1bf09bab1dad447d940eb76314630980 -#: ../src/Doc/library/functions.rst:15 +#: library/functions.rst:15 msgid ":func:`isinstance`" msgstr "" -#: ../src/Doc/library/functions.rst:15 +#: library/functions.rst:15 msgid ":func:`pow`" msgstr "" # 6a48fefb4dde4004a26648351a5bff6a -#: ../src/Doc/library/functions.rst:15 +#: library/functions.rst:15 msgid ":func:`sum`" msgstr "" # a2c895b0101145189263d7a94006b571 -#: ../src/Doc/library/functions.rst:16 +#: library/functions.rst:16 msgid ":func:`basestring`" msgstr "" # bb35f565e37f4564ae06da7070dd7f7f -#: ../src/Doc/library/functions.rst:16 +#: library/functions.rst:16 msgid ":func:`execfile`" msgstr "" # c85f95b5b886484fab1a1be15e3adbc1 -#: ../src/Doc/library/functions.rst:16 +#: library/functions.rst:16 msgid ":func:`issubclass`" msgstr "" # f5d0f75211164a18aa8f1100b69ce8d4 -#: ../src/Doc/library/functions.rst:16 +#: library/functions.rst:16 msgid ":func:`print`" msgstr "" # 40fd54b43e7d4ef4801295476a074d0f -#: ../src/Doc/library/functions.rst:16 +#: library/functions.rst:16 msgid ":func:`super`" msgstr "" # 6b35eea52d3548698533bb6025b54110 -#: ../src/Doc/library/functions.rst:17 +#: library/functions.rst:17 msgid ":func:`bin`" msgstr "" # 76dbde7fb13e4f23a44ec974c337624a -#: ../src/Doc/library/functions.rst:17 +#: library/functions.rst:17 msgid ":func:`file`" msgstr "" # f6527442a4664d70bd596ee997081221 -#: ../src/Doc/library/functions.rst:17 +#: library/functions.rst:17 msgid ":func:`iter`" msgstr "" # 5a559a3262344f18810dd1b16f18bbcd -#: ../src/Doc/library/functions.rst:17 +#: library/functions.rst:17 msgid ":func:`property`" msgstr "" # 547d2b84a0aa4e7ebb8fa921dd8fe0e4 -#: ../src/Doc/library/functions.rst:17 +#: library/functions.rst:17 msgid ":func:`tuple`" msgstr "" # 31fab7b4cf174cb0b4f62eb6f7c9bf34 -#: ../src/Doc/library/functions.rst:18 +#: library/functions.rst:18 msgid ":func:`bool`" msgstr "" # 3d11386a255c4652abe651a185775c69 -#: ../src/Doc/library/functions.rst:18 +#: library/functions.rst:18 msgid ":func:`filter`" msgstr "" # 3a4932efa44e4195a402e00fc6792888 -#: ../src/Doc/library/functions.rst:18 +#: library/functions.rst:18 msgid ":func:`len`" msgstr "" # 874d5befae564c799ad7c73e1e2f6a8e -#: ../src/Doc/library/functions.rst:18 +#: library/functions.rst:18 msgid ":func:`range`" msgstr "" # 33ba8bf6e3944b72908b0ad602f93ccc -#: ../src/Doc/library/functions.rst:18 +#: library/functions.rst:18 msgid ":func:`type`" msgstr "" # d8e7b2494285447dab0ba68c85100136 -#: ../src/Doc/library/functions.rst:19 +#: library/functions.rst:19 msgid ":func:`bytearray`" msgstr "" -#: ../src/Doc/library/functions.rst:19 +#: library/functions.rst:19 msgid ":func:`float`" msgstr "" # 71aa78f0cd7648dea52ce18c727d4943 -#: ../src/Doc/library/functions.rst:19 +#: library/functions.rst:19 msgid ":func:`list`" msgstr "" # 52c8481e020b42b08c423121183867c0 -#: ../src/Doc/library/functions.rst:19 +#: library/functions.rst:19 msgid ":func:`raw_input`" msgstr "" # c01ca4dadd084d48a184c4e2993001e2 -#: ../src/Doc/library/functions.rst:19 +#: library/functions.rst:19 msgid ":func:`unichr`" msgstr "" # 9d2862e3ec3f46a0a96670dc892a9dd4 -#: ../src/Doc/library/functions.rst:20 +#: library/functions.rst:20 msgid ":func:`callable`" msgstr "" # 721405bd8f49453887055f60483d78ab -#: ../src/Doc/library/functions.rst:20 +#: library/functions.rst:20 msgid ":func:`format`" msgstr "" # 51c3ed67468641dd8983b5b27d70f549 -#: ../src/Doc/library/functions.rst:20 +#: library/functions.rst:20 msgid ":func:`locals`" msgstr "" # 839d93480b14424d9858928b0aa9b523 -#: ../src/Doc/library/functions.rst:20 +#: library/functions.rst:20 msgid ":func:`reduce`" msgstr "" # 1dcde2d7fc0e49ae9b63cffafc2358d1 -#: ../src/Doc/library/functions.rst:20 +#: library/functions.rst:20 msgid ":func:`unicode`" msgstr "" # f362e366a4b64d0297c895b433e9fa38 -#: ../src/Doc/library/functions.rst:21 +#: library/functions.rst:21 msgid ":func:`chr`" msgstr "" # ff80d4d98466417fb0e6e5068abebbec -#: ../src/Doc/library/functions.rst:21 +#: library/functions.rst:21 msgid "|func-frozenset|_" msgstr "" # ee07899f3737459caccb29824889141e -#: ../src/Doc/library/functions.rst:21 +#: library/functions.rst:21 msgid ":func:`long`" msgstr "" # dd3e8dfd9ab14aaf9d31233f4f92fd9d -#: ../src/Doc/library/functions.rst:21 +#: library/functions.rst:21 msgid ":func:`reload`" msgstr "" # c484268e1093466ab0144f122ad223c7 -#: ../src/Doc/library/functions.rst:21 +#: library/functions.rst:21 msgid ":func:`vars`" msgstr "" # fcc03513e8df43cf930e1811f71bd7f0 -#: ../src/Doc/library/functions.rst:22 +#: library/functions.rst:22 msgid ":func:`classmethod`" msgstr "" # ef951fb8b99f49fa987072922f21db05 -#: ../src/Doc/library/functions.rst:22 +#: library/functions.rst:22 msgid ":func:`getattr`" msgstr "" # 97f43aa3dc2d4f54b4ea068ed72d5fac -#: ../src/Doc/library/functions.rst:22 +#: library/functions.rst:22 msgid ":func:`map`" msgstr "" # dea008304dce47229033967052d46777 -#: ../src/Doc/library/functions.rst:22 +#: library/functions.rst:22 msgid "|func-repr|_" msgstr "" # 30ae2a993f62457cac0f3a14b2479dac -#: ../src/Doc/library/functions.rst:22 +#: library/functions.rst:22 msgid ":func:`xrange`" msgstr "" # 88057290d0084e90a253c4d53f7ec543 -#: ../src/Doc/library/functions.rst:23 +#: library/functions.rst:23 msgid ":func:`cmp`" msgstr "" # e418945fdcb540adb806eed7292f5ccd -#: ../src/Doc/library/functions.rst:23 +#: library/functions.rst:23 msgid ":func:`globals`" msgstr "" # c05818dd779b4b7d92518d92d05084f3 -#: ../src/Doc/library/functions.rst:23 +#: library/functions.rst:23 msgid ":func:`max`" msgstr "" # 8d3323419c1f48e58703ab56036fd337 -#: ../src/Doc/library/functions.rst:23 +#: library/functions.rst:23 msgid ":func:`reversed`" msgstr "" # ec2e9e324fd348078582bba7fc9e5dfb -#: ../src/Doc/library/functions.rst:23 +#: library/functions.rst:23 msgid ":func:`zip`" msgstr "" # a3528b6e4b1f4bfeb3e5144a31024c85 -#: ../src/Doc/library/functions.rst:24 +#: library/functions.rst:24 msgid ":func:`compile`" msgstr "" # 1b9da477661742d4924b00e1ea6f9a51 -#: ../src/Doc/library/functions.rst:24 +#: library/functions.rst:24 msgid ":func:`hasattr`" msgstr "" # a800962af9d4427fb4e29b908efe1f2e -#: ../src/Doc/library/functions.rst:24 +#: library/functions.rst:24 msgid "|func-memoryview|_" msgstr "" # cfff146375ce4fe3bc5e8db017844c26 -#: ../src/Doc/library/functions.rst:24 +#: library/functions.rst:24 msgid ":func:`round`" msgstr "" # cec1f0ec554c44c9a8abe49ebc0342fa -#: ../src/Doc/library/functions.rst:24 +#: library/functions.rst:24 msgid ":func:`__import__`" msgstr "" -#: ../src/Doc/library/functions.rst:25 +#: library/functions.rst:25 msgid ":func:`complex`" msgstr "" # 9928ad6413a04e918a3fb31507b66096 -#: ../src/Doc/library/functions.rst:25 +#: library/functions.rst:25 msgid ":func:`hash`" msgstr "" # efecc9fe91e44b7297f44f53a6c62394 -#: ../src/Doc/library/functions.rst:25 +#: library/functions.rst:25 msgid ":func:`min`" msgstr "" # dea008304dce47229033967052d46777 -#: ../src/Doc/library/functions.rst:25 +#: library/functions.rst:25 msgid "|func-set|_" msgstr "" -# 11620eaf39d84a469b0e97d9b747e6df -#: ../src/Doc/library/functions.rst:25 -msgid ":func:`apply`" -msgstr "" - # 664139f1d9e64c66b37901d1ed797876 -#: ../src/Doc/library/functions.rst:26 +#: library/functions.rst:26 msgid ":func:`delattr`" msgstr "" # 2d12587a56104eefa5f9977ca815fbca -#: ../src/Doc/library/functions.rst:26 +#: library/functions.rst:26 msgid ":func:`help`" msgstr "" # f5be51fb9c124e558c4f71fa286c73ea -#: ../src/Doc/library/functions.rst:26 +#: library/functions.rst:26 msgid ":func:`next`" msgstr "" # 15fd5416562940238dadcdf9b4115735 -#: ../src/Doc/library/functions.rst:26 +#: library/functions.rst:26 msgid ":func:`setattr`" msgstr "" -# 8b8e6a636bad4ad986f930a624be43b9 -#: ../src/Doc/library/functions.rst:26 -msgid ":func:`buffer`" -msgstr "" - # 473b661fb74b4dbeabca1f953478a66e -#: ../src/Doc/library/functions.rst:27 +#: library/functions.rst:27 msgid "|func-dict|_" msgstr "" # b859a9839f59414d9014d53b6dcfe24f -#: ../src/Doc/library/functions.rst:27 +#: library/functions.rst:27 msgid ":func:`hex`" msgstr "" # a7a44998b7984d57824496986a9a9442 -#: ../src/Doc/library/functions.rst:27 +#: library/functions.rst:27 msgid ":func:`object`" msgstr "" # f198a26e7b904e15ae42e35786dcf06c -#: ../src/Doc/library/functions.rst:27 +#: library/functions.rst:27 msgid ":func:`slice`" msgstr "" -# 6cdc6a592c6448f8a5c84a72e241899e -#: ../src/Doc/library/functions.rst:27 -msgid ":func:`coerce`" -msgstr "" - # db63322c7dcc45649cd1914d26560c06 -#: ../src/Doc/library/functions.rst:28 +#: library/functions.rst:28 msgid ":func:`dir`" msgstr "" # 19fe732f78f944e9a2ad88d8b5164be8 -#: ../src/Doc/library/functions.rst:28 +#: library/functions.rst:28 msgid ":func:`id`" msgstr "" # 537fa60c386445d3a4f6379960266b5e -#: ../src/Doc/library/functions.rst:28 +#: library/functions.rst:28 msgid ":func:`oct`" msgstr "" # 8df6bab83f1440549f808980faee1659 -#: ../src/Doc/library/functions.rst:28 +#: library/functions.rst:28 msgid ":func:`sorted`" msgstr "" -# 88661f468dd2490da2a7e292c61562f4 -#: ../src/Doc/library/functions.rst:28 -msgid ":func:`intern`" +#: library/functions.rst:31 +msgid "" +"In addition, there are other four built-in functions that are no longer " +"considered essential: :func:`apply`, :func:`buffer`, :func:`coerce`, and :" +"func:`intern`. They are documented in the :ref:`non-essential-built-in-" +"funcs` section." msgstr "" # d128a3c59e1e4bc0b094453f21efd60c -#: ../src/Doc/library/functions.rst:43 +#: library/functions.rst:48 msgid "" "Return the absolute value of a number. The argument may be a plain or long " "integer or a floating point number. If the argument is a complex number, " @@ -42136,21 +42591,21 @@ msgid "" msgstr "" # 5481355f5a2744f88ae891b9cf399cf8 -#: ../src/Doc/library/functions.rst:50 +#: library/functions.rst:55 msgid "" "Return ``True`` if all elements of the *iterable* are true (or if the " "iterable is empty). Equivalent to::" msgstr "" # b865ad0eb0334d78badd04ac7e1f8874 -#: ../src/Doc/library/functions.rst:64 +#: library/functions.rst:69 msgid "" "Return ``True`` if any element of the *iterable* is true. If the iterable " "is empty, return ``False``. Equivalent to::" msgstr "" # 8d91be8bb1df4c5ba8b3d1e1d99575d6 -#: ../src/Doc/library/functions.rst:78 +#: library/functions.rst:83 msgid "" "This abstract type is the superclass for :class:`str` and :class:`unicode`. " "It cannot be called or instantiated, but it can be used to test whether an " @@ -42158,7 +42613,7 @@ msgid "" "basestring)`` is equivalent to ``isinstance(obj, (str, unicode))``." msgstr "" -#: ../src/Doc/library/functions.rst:88 +#: library/functions.rst:93 msgid "" "Convert an integer number to a binary string. The result is a valid Python " "expression. If *x* is not a Python :class:`int` object, it has to define " @@ -42166,7 +42621,7 @@ msgid "" msgstr "" # 18af5cfe09be42e18d148d783dc264cc -#: ../src/Doc/library/functions.rst:97 +#: library/functions.rst:102 msgid "" "Return a Boolean value, i.e. one of ``True`` or ``False``. *x* is converted " "using the standard truth testing procedure. If *x* is false or omitted, " @@ -42176,8 +42631,12 @@ msgid "" "and :const:`True`." msgstr "" +#: library/functions.rst:113 +msgid "If no argument is given, this function returns :const:`False`." +msgstr "" + # 09b4d18e67b248b0aa8e29f103158814 -#: ../src/Doc/library/functions.rst:114 +#: library/functions.rst:119 msgid "" "Return a new array of bytes. The :class:`bytearray` class is a mutable " "sequence of integers in the range 0 <= x < 256. It has most of the usual " @@ -42185,44 +42644,44 @@ msgid "" "as most methods that the :class:`str` type has, see :ref:`string-methods`." msgstr "" -#: ../src/Doc/library/functions.rst:119 +#: library/functions.rst:124 msgid "" "The optional *source* parameter can be used to initialize the array in a few " "different ways:" msgstr "" # 8ffd745ed84640f494eb56f82c2b6e6a -#: ../src/Doc/library/functions.rst:122 +#: library/functions.rst:127 msgid "" "If it is *unicode*, you must also give the *encoding* (and optionally, " "*errors*) parameters; :func:`bytearray` then converts the unicode to bytes " "using :meth:`unicode.encode`." msgstr "" -#: ../src/Doc/library/functions.rst:126 +#: library/functions.rst:131 msgid "" "If it is an *integer*, the array will have that size and will be initialized " "with null bytes." msgstr "" -#: ../src/Doc/library/functions.rst:129 +#: library/functions.rst:134 msgid "" "If it is an object conforming to the *buffer* interface, a read-only buffer " "of the object will be used to initialize the bytes array." msgstr "" -#: ../src/Doc/library/functions.rst:132 +#: library/functions.rst:137 msgid "" "If it is an *iterable*, it must be an iterable of integers in the range ``0 " "<= x < 256``, which are used as the initial contents of the array." msgstr "" -#: ../src/Doc/library/functions.rst:135 +#: library/functions.rst:140 msgid "Without an argument, an array of size 0 is created." msgstr "" # 0667984117c641f88ee6a4d133652af9 -#: ../src/Doc/library/functions.rst:142 +#: library/functions.rst:147 msgid "" "Return :const:`True` if the *object* argument appears callable, :const:" "`False` if not. If this returns true, it is still possible that a call " @@ -42232,7 +42691,7 @@ msgid "" msgstr "" # a2968228aca94bf5b027db8be5b7b67c -#: ../src/Doc/library/functions.rst:152 +#: library/functions.rst:157 msgid "" "Return a string of one character whose ASCII code is the integer *i*. For " "example, ``chr(97)`` returns the string ``'a'``. This is the inverse of :" @@ -42241,24 +42700,24 @@ msgid "" "`unichr`." msgstr "" -#: ../src/Doc/library/functions.rst:161 +#: library/functions.rst:166 msgid "Return a class method for *function*." msgstr "" -#: ../src/Doc/library/functions.rst:163 +#: library/functions.rst:168 msgid "" "A class method receives the class as implicit first argument, just like an " "instance method receives the instance. To declare a class method, use this " "idiom::" msgstr "" -#: ../src/Doc/library/functions.rst:172 +#: library/functions.rst:177 msgid "" "The ``@classmethod`` form is a function :term:`decorator` -- see the " "description of function definitions in :ref:`function` for details." msgstr "" -#: ../src/Doc/library/functions.rst:175 +#: library/functions.rst:180 msgid "" "It can be called either on the class (such as ``C.f()``) or on an instance " "(such as ``C().f()``). The instance is ignored except for its class. If a " @@ -42266,20 +42725,24 @@ msgid "" "passed as the implied first argument." msgstr "" -#: ../src/Doc/library/functions.rst:180 +#: library/functions.rst:185 msgid "" "Class methods are different than C++ or Java static methods. If you want " "those, see :func:`staticmethod` in this section." msgstr "" -#: ../src/Doc/library/functions.rst:183 +#: library/functions.rst:188 msgid "" "For more information on class methods, consult the documentation on the " "standard type hierarchy in :ref:`types`." msgstr "" +#: library/functions.rst:193 library/functions.rst:1361 +msgid "Function decorator syntax added." +msgstr "" + # e6b811755dbd42a193db7ec179c263be -#: ../src/Doc/library/functions.rst:194 +#: library/functions.rst:199 msgid "" "Compare the two objects *x* and *y* and return an integer according to the " "outcome. The return value is negative if ``x < y``, zero if ``x == y`` and " @@ -42287,7 +42750,7 @@ msgid "" msgstr "" # cebf3fa645d34c7e9d861c15474368ad -#: ../src/Doc/library/functions.rst:201 +#: library/functions.rst:206 msgid "" "Compile the *source* into a code or AST object. Code objects can be " "executed by an :keyword:`exec` statement or evaluated by a call to :func:" @@ -42296,14 +42759,14 @@ msgid "" "information on how to work with AST objects." msgstr "" -#: ../src/Doc/library/functions.rst:208 +#: library/functions.rst:213 msgid "" "The *filename* argument should give the file from which the code was read; " "pass some recognizable value if it wasn't read from a file (``''`` " "is commonly used)." msgstr "" -#: ../src/Doc/library/functions.rst:212 +#: library/functions.rst:217 msgid "" "The *mode* argument specifies what kind of code must be compiled; it can be " "``'exec'`` if *source* consists of a sequence of statements, ``'eval'`` if " @@ -42313,7 +42776,7 @@ msgid "" msgstr "" # 9ee0000d732140fe9568a4eeeaed654b -#: ../src/Doc/library/functions.rst:218 +#: library/functions.rst:223 msgid "" "The optional arguments *flags* and *dont_inherit* control which future " "statements (see :pep:`236`) affect the compilation of *source*. If neither " @@ -42327,7 +42790,7 @@ msgid "" msgstr "" # 66b1263daff045979aed18975e4c5d18 -#: ../src/Doc/library/functions.rst:228 +#: library/functions.rst:233 msgid "" "Future statements are specified by bits which can be bitwise ORed together " "to specify multiple statements. The bitfield required to specify a given " @@ -42336,20 +42799,20 @@ msgid "" "`__future__` module." msgstr "" -#: ../src/Doc/library/functions.rst:233 +#: library/functions.rst:238 msgid "" "This function raises :exc:`SyntaxError` if the compiled source is invalid, " "and :exc:`TypeError` if the source contains null bytes." msgstr "" # 6010c728813d4593acd28212dee6a05e -#: ../src/Doc/library/functions.rst:236 +#: library/functions.rst:241 msgid "" "If you want to parse Python code into its AST representation, see :func:`ast." "parse`." msgstr "" -#: ../src/Doc/library/functions.rst:241 +#: library/functions.rst:246 msgid "" "When compiling a string with multi-line code in ``'single'`` or ``'eval'`` " "mode, input must be terminated by at least one newline character. This is " @@ -42357,10 +42820,23 @@ msgid "" "`code` module." msgstr "" -# a848d3679d9a49239dc22edc911a6acb -#: ../src/Doc/library/functions.rst:259 +#: library/functions.rst:251 +msgid "The *flags* and *dont_inherit* arguments were added." +msgstr "" + +#: library/functions.rst:254 +msgid "Support for compiling AST objects." +msgstr "" + +#: library/functions.rst:257 msgid "" -"Return a complex number with the value *real* + *imag*\\*j or convert a " +"Allowed use of Windows and Mac newlines. Also input in ``'exec'`` mode does " +"not have to end in a newline anymore." +msgstr "" + +#: library/functions.rst:264 +msgid "" +"Return a complex number with the value *real* + *imag*\\*1j or convert a " "string or number to a complex number. If the first parameter is a string, " "it will be interpreted as a complex number and the function must be called " "without a second parameter. The second parameter can never be a string. " @@ -42371,18 +42847,18 @@ msgid "" msgstr "" # f3fd573b01f6403bb770e053d1af2f85 -#: ../src/Doc/library/functions.rst:269 +#: library/functions.rst:274 msgid "" "When converting from a string, the string must not contain whitespace around " "the central ``+`` or ``-`` operator. For example, ``complex('1+2j')`` is " "fine, but ``complex('1 + 2j')`` raises :exc:`ValueError`." msgstr "" -#: ../src/Doc/library/functions.rst:274 +#: library/functions.rst:279 msgid "The complex type is described in :ref:`typesnumeric`." msgstr "" -#: ../src/Doc/library/functions.rst:279 +#: library/functions.rst:284 msgid "" "This is a relative of :func:`setattr`. The arguments are an object and a " "string. The string must be the name of one of the object's attributes. The " @@ -42391,27 +42867,27 @@ msgid "" msgstr "" # f178819937594e48819829e53f9f4311 -#: ../src/Doc/library/functions.rst:291 +#: library/functions.rst:296 msgid "" "Create a new dictionary. The :class:`dict` object is the dictionary class. " "See :class:`dict` and :ref:`typesmapping` for documentation about this class." msgstr "" # 27663220f903421681fd3b19680f4af9 -#: ../src/Doc/library/functions.rst:294 +#: library/functions.rst:299 msgid "" "For other containers see the built-in :class:`list`, :class:`set`, and :" "class:`tuple` classes, as well as the :mod:`collections` module." msgstr "" -#: ../src/Doc/library/functions.rst:300 +#: library/functions.rst:305 msgid "" "Without arguments, return the list of names in the current local scope. " "With an argument, attempt to return a list of valid attributes for that " "object." msgstr "" -#: ../src/Doc/library/functions.rst:303 +#: library/functions.rst:308 msgid "" "If the object has a method named :meth:`__dir__`, this method will be called " "and must return the list of attributes. This allows objects that implement a " @@ -42419,7 +42895,7 @@ msgid "" "the way :func:`dir` reports their attributes." msgstr "" -#: ../src/Doc/library/functions.rst:308 +#: library/functions.rst:313 msgid "" "If the object does not provide :meth:`__dir__`, the function tries its best " "to gather information from the object's :attr:`__dict__` attribute, if " @@ -42428,37 +42904,37 @@ msgid "" "`__getattr__`." msgstr "" -#: ../src/Doc/library/functions.rst:313 +#: library/functions.rst:318 msgid "" "The default :func:`dir` mechanism behaves differently with different types " "of objects, as it attempts to produce the most relevant, rather than " "complete, information:" msgstr "" -#: ../src/Doc/library/functions.rst:317 +#: library/functions.rst:322 msgid "" "If the object is a module object, the list contains the names of the " "module's attributes." msgstr "" -#: ../src/Doc/library/functions.rst:320 +#: library/functions.rst:325 msgid "" "If the object is a type or class object, the list contains the names of its " "attributes, and recursively of the attributes of its bases." msgstr "" -#: ../src/Doc/library/functions.rst:323 +#: library/functions.rst:328 msgid "" "Otherwise, the list contains the object's attributes' names, the names of " "its class's attributes, and recursively of the attributes of its class's " "base classes." msgstr "" -#: ../src/Doc/library/functions.rst:327 +#: library/functions.rst:332 msgid "The resulting list is sorted alphabetically. For example:" msgstr "" -#: ../src/Doc/library/functions.rst:345 +#: library/functions.rst:350 msgid "" "Because :func:`dir` is supplied primarily as a convenience for use at an " "interactive prompt, it tries to supply an interesting set of names more than " @@ -42468,7 +42944,7 @@ msgid "" msgstr "" # aea6036bea774978bf565856a43cd669 -#: ../src/Doc/library/functions.rst:354 +#: library/functions.rst:359 msgid "" "Take two (non complex) numbers as arguments and return a pair of numbers " "consisting of their quotient and remainder when using long division. With " @@ -42480,8 +42956,12 @@ msgid "" "*b*, and ``0 <= abs(a % b) < abs(b)``." msgstr "" +#: library/functions.rst:368 +msgid "Using :func:`divmod` with complex numbers is deprecated." +msgstr "" + # 45338d0df5f7492c85f77428ce2e321f -#: ../src/Doc/library/functions.rst:369 +#: library/functions.rst:374 msgid "" "Return an enumerate object. *sequence* must be a sequence, an :term:" "`iterator`, or some other object which supports iteration. The :meth:`!" @@ -42490,23 +42970,30 @@ msgid "" "obtained from iterating over *sequence*::" msgstr "" -#: ../src/Doc/library/functions.rst:381 ../src/Doc/library/itertools.rst:132 -#: ../src/Doc/library/itertools.rst:183 ../src/Doc/library/itertools.rst:502 -#: ../src/Doc/library/operator.rst:508 ../src/Doc/library/operator.rst:547 -#: ../src/Doc/library/operator.rst:597 ../src/Doc/library/stdtypes.rst:494 +#: library/functions.rst:386 library/itertools.rst:132 +#: library/itertools.rst:183 library/itertools.rst:502 library/operator.rst:508 +#: library/operator.rst:547 library/operator.rst:597 library/stdtypes.rst:494 msgid "Equivalent to::" msgstr "" +#: library/functions.rst:395 +msgid "The *start* parameter was added." +msgstr "" + # 867d824f1d28487fbc14881c90149cf3 -#: ../src/Doc/library/functions.rst:396 +#: library/functions.rst:401 msgid "" "The arguments are a Unicode or *Latin-1* encoded string and optional globals " "and locals. If provided, *globals* must be a dictionary. If provided, " "*locals* can be any mapping object." msgstr "" +#: library/functions.rst:405 library/functions.rst:453 +msgid "formerly *locals* was required to be a dictionary." +msgstr "" + # f88f740aa4b04b21b288343da8e1a1c5 -#: ../src/Doc/library/functions.rst:403 +#: library/functions.rst:408 msgid "" "The *expression* argument is parsed and evaluated as a Python expression " "(technically speaking, a condition list) using the *globals* and *locals* " @@ -42521,7 +43008,7 @@ msgid "" "errors are reported as exceptions. Example:" msgstr "" -#: ../src/Doc/library/functions.rst:418 +#: library/functions.rst:423 msgid "" "This function can also be used to execute arbitrary code objects (such as " "those created by :func:`compile`). In this case pass a code object instead " @@ -42530,7 +43017,7 @@ msgid "" msgstr "" # 18879ae437de470e898d3d563acc7354 -#: ../src/Doc/library/functions.rst:423 +#: library/functions.rst:428 msgid "" "Hints: dynamic execution of statements is supported by the :keyword:`exec` " "statement. Execution of statements from a file is supported by the :func:" @@ -42540,14 +43027,14 @@ msgid "" msgstr "" # 71b79af07e0f40ebbb34f0b6e9d088fd -#: ../src/Doc/library/functions.rst:429 +#: library/functions.rst:434 msgid "" "See :func:`ast.literal_eval` for a function that can safely evaluate strings " "with expressions containing only literals." msgstr "" # 1d1ca5f44e6e4cdc9a61eb0baca9f815 -#: ../src/Doc/library/functions.rst:435 +#: library/functions.rst:440 msgid "" "This function is similar to the :keyword:`exec` statement, but parses a file " "instead of a string. It is different from the :keyword:`import` statement " @@ -42556,7 +43043,7 @@ msgid "" msgstr "" # f35a8438864a437b8e64cc617818cf13 -#: ../src/Doc/library/functions.rst:440 +#: library/functions.rst:445 msgid "" "The arguments are a file name and two optional dictionaries. The file is " "parsed and evaluated as a sequence of Python statements (similarly to a " @@ -42568,7 +43055,7 @@ msgid "" msgstr "" # e85cac5bda4d4cbfa495a60bb61f3e19 -#: ../src/Doc/library/functions.rst:451 +#: library/functions.rst:456 msgid "" "If the *locals* dictionary is omitted it defaults to the *globals* " "dictionary. If both dictionaries are omitted, the expression is executed in " @@ -42577,7 +43064,7 @@ msgid "" msgstr "" # fda8d9d8773a485ba1185a85af42687f -#: ../src/Doc/library/functions.rst:457 +#: library/functions.rst:462 msgid "" "The default *locals* act as described for function :func:`locals` below: " "modifications to the default *locals* dictionary should not be attempted. " @@ -42587,7 +43074,7 @@ msgid "" msgstr "" # ee668a40a75d4947ab79228a13ad4733 -#: ../src/Doc/library/functions.rst:466 +#: library/functions.rst:471 msgid "" "Constructor function for the :class:`file` type, described further in " "section :ref:`bltin-file-objects`. The constructor's arguments are the same " @@ -42595,7 +43082,7 @@ msgid "" msgstr "" # 306406f666114c879fd1a3e83f43aeb5 -#: ../src/Doc/library/functions.rst:470 +#: library/functions.rst:475 msgid "" "When opening a file, it's preferable to use :func:`open` instead of " "invoking this constructor directly. :class:`file` is more suited to type " @@ -42603,7 +43090,7 @@ msgid "" msgstr "" # d02d444efcd240529af1c3052587b6f3 -#: ../src/Doc/library/functions.rst:479 +#: library/functions.rst:484 msgid "" "Construct a list from those elements of *iterable* for which *function* " "returns true. *iterable* may be either a sequence, a container which " @@ -42614,7 +43101,7 @@ msgid "" msgstr "" # d128284858d14285bb1590b75c4b1713 -#: ../src/Doc/library/functions.rst:486 +#: library/functions.rst:491 msgid "" "Note that ``filter(function, iterable)`` is equivalent to ``[item for item " "in iterable if function(item)]`` if function is not ``None`` and ``[item for " @@ -42622,7 +43109,7 @@ msgid "" msgstr "" # 8cf53af6725643a3b217670d62725506 -#: ../src/Doc/library/functions.rst:490 +#: library/functions.rst:495 msgid "" "See :func:`itertools.ifilter` and :func:`itertools.ifilterfalse` for " "iterator versions of this function, including a variation that filters for " @@ -42630,12 +43117,12 @@ msgid "" msgstr "" # 52555ee23a6b4b49a4eaaf8f0b205b79 -#: ../src/Doc/library/functions.rst:497 +#: library/functions.rst:502 msgid "Return a floating point number constructed from a number or string *x*." msgstr "" # 95660046351149e8a97df66549439a43 -#: ../src/Doc/library/functions.rst:499 +#: library/functions.rst:504 msgid "" "If the argument is a string, it must contain a possibly signed decimal or " "floating point number, possibly embedded in whitespace. The argument may " @@ -42646,7 +43133,7 @@ msgid "" msgstr "" # 22c715eb36cc4d48a301c378c3173854 -#: ../src/Doc/library/functions.rst:513 +#: library/functions.rst:518 msgid "" "When passing in a string, values for NaN and Infinity may be returned, " "depending on the underlying C library. Float accepts the strings nan, inf " @@ -42655,11 +43142,11 @@ msgid "" "represents NaN and infinity as nan, inf or -inf." msgstr "" -#: ../src/Doc/library/functions.rst:519 +#: library/functions.rst:524 msgid "The float type is described in :ref:`typesnumeric`." msgstr "" -#: ../src/Doc/library/functions.rst:528 +#: library/functions.rst:533 msgid "" "Convert a *value* to a \"formatted\" representation, as controlled by " "*format_spec*. The interpretation of *format_spec* will depend on the type " @@ -42667,14 +43154,14 @@ msgid "" "is used by most built-in types: :ref:`formatspec`." msgstr "" -#: ../src/Doc/library/functions.rst:535 +#: library/functions.rst:540 msgid "" "``format(value, format_spec)`` merely calls ``value." "__format__(format_spec)``." msgstr "" # 278778ac95ee46a7ab34273df555e214 -#: ../src/Doc/library/functions.rst:545 +#: library/functions.rst:550 msgid "" "Return a new :class:`frozenset` object, optionally with elements taken from " "*iterable*. ``frozenset`` is a built-in class. See :class:`frozenset` and :" @@ -42682,14 +43169,14 @@ msgid "" msgstr "" # f7a30ae9bd0043518ed7e3b865eb7348 -#: ../src/Doc/library/functions.rst:549 +#: library/functions.rst:554 msgid "" "For other containers see the built-in :class:`set`, :class:`list`, :class:" "`tuple`, and :class:`dict` classes, as well as the :mod:`collections` module." msgstr "" # e96e1cedf2a74e58a4fb36b1476f379c -#: ../src/Doc/library/functions.rst:558 +#: library/functions.rst:563 msgid "" "Return the value of the named attribute of *object*. *name* must be a " "string. If the string is the name of one of the object's attributes, the " @@ -42699,7 +43186,7 @@ msgid "" "raised." msgstr "" -#: ../src/Doc/library/functions.rst:567 +#: library/functions.rst:572 msgid "" "Return a dictionary representing the current global symbol table. This is " "always the dictionary of the current module (inside a function or method, " @@ -42707,7 +43194,7 @@ msgid "" "called)." msgstr "" -#: ../src/Doc/library/functions.rst:574 +#: library/functions.rst:579 msgid "" "The arguments are an object and a string. The result is ``True`` if the " "string is the name of one of the object's attributes, ``False`` if not. " @@ -42715,7 +43202,7 @@ msgid "" "it raises an exception or not.)" msgstr "" -#: ../src/Doc/library/functions.rst:582 +#: library/functions.rst:587 msgid "" "Return the hash value of the object (if it has one). Hash values are " "integers. They are used to quickly compare dictionary keys during a " @@ -42723,7 +43210,7 @@ msgid "" "value (even if they are of different types, as is the case for 1 and 1.0)." msgstr "" -#: ../src/Doc/library/functions.rst:590 +#: library/functions.rst:595 msgid "" "Invoke the built-in help system. (This function is intended for interactive " "use.) If no argument is given, the interactive help system starts on the " @@ -42733,40 +43220,44 @@ msgid "" "argument is any other kind of object, a help page on the object is generated." msgstr "" -#: ../src/Doc/library/functions.rst:597 +#: library/functions.rst:602 msgid "" "This function is added to the built-in namespace by the :mod:`site` module." msgstr "" # 7d7f499ac7e94d339bdb0e177a97505f -#: ../src/Doc/library/functions.rst:604 +#: library/functions.rst:609 msgid "" "Convert an integer number (of any size) to a lowercase hexadecimal string " "prefixed with \"0x\", for example:" msgstr "" # 9916d95866c645f0bdde7a77491bc30c -#: ../src/Doc/library/functions.rst:614 +#: library/functions.rst:619 msgid "" "If x is not a Python :class:`int` or :class:`long` object, it has to define " "an __index__() method that returns an integer." msgstr "" # fa927d9c80f5458a88501431b1a3ece6 -#: ../src/Doc/library/functions.rst:617 +#: library/functions.rst:622 msgid "" "See also :func:`int` for converting a hexadecimal string to an integer using " "a base of 16." msgstr "" -#: ../src/Doc/library/functions.rst:622 +#: library/functions.rst:627 msgid "" "To obtain a hexadecimal string representation for a float, use the :meth:" "`float.hex` method." msgstr "" +#: library/functions.rst:630 library/functions.rst:869 +msgid "Formerly only returned an unsigned literal." +msgstr "" + # 981e5e56a5254b068bf4cd5052d0fd73 -#: ../src/Doc/library/functions.rst:631 +#: library/functions.rst:636 msgid "" "Return the \"identity\" of an object. This is an integer (or long integer) " "which is guaranteed to be unique and constant for this object during its " @@ -42775,32 +43266,32 @@ msgid "" msgstr "" # 522002faf5784e8985efa8fed198382f -#: ../src/Doc/library/functions.rst:641 +#: library/functions.rst:646 msgid "Equivalent to ``eval(raw_input(prompt))``." msgstr "" # 1c6788166d684a97966cdc0b42508049 -#: ../src/Doc/library/functions.rst:643 +#: library/functions.rst:648 msgid "" "This function does not catch user errors. If the input is not syntactically " "valid, a :exc:`SyntaxError` will be raised. Other exceptions may be raised " "if there is an error during evaluation." msgstr "" -#: ../src/Doc/library/functions.rst:647 +#: library/functions.rst:652 msgid "" "If the :mod:`readline` module was loaded, then :func:`input` will use it to " "provide elaborate line editing and history features." msgstr "" # da4d6e0f65da4131ae80d02074c235d4 -#: ../src/Doc/library/functions.rst:650 +#: library/functions.rst:655 msgid "" "Consider using the :func:`raw_input` function for general input from users." msgstr "" # 3e02820fe7f1476183345ab9fa0e8dfb -#: ../src/Doc/library/functions.rst:656 +#: library/functions.rst:661 msgid "" "Return an integer object constructed from a number or string *x*, or return " "``0`` if no arguments are given. If *x* is a number, it can be a plain " @@ -42810,7 +43301,7 @@ msgid "" msgstr "" # 238f31cf41584c1789dc5d510c6056c3 -#: ../src/Doc/library/functions.rst:662 +#: library/functions.rst:667 msgid "" "If *x* is not a number or if *base* is given, then *x* must be a string or " "Unicode object representing an :ref:`integer literal ` in radix " @@ -42824,12 +43315,11 @@ msgid "" "that the actual base is 2, 8, 10, or 16." msgstr "" -#: ../src/Doc/library/functions.rst:674 +#: library/functions.rst:679 msgid "The integer type is described in :ref:`typesnumeric`." msgstr "" -# e0a4fda599ae494e87985a54fd8e8611 -#: ../src/Doc/library/functions.rst:679 +#: library/functions.rst:684 msgid "" "Return true if the *object* argument is an instance of the *classinfo* " "argument, or of a (direct, indirect or :term:`virtual `) subclass thereof. If " "*object* is not a class instance or an object of the given type, the " -"function always returns false. If *classinfo* is neither a class object nor " -"a type object, it may be a tuple of class or type objects, or may " -"recursively contain other such tuples (other sequence types are not " -"accepted). If *classinfo* is not a class, type, or tuple of classes, types, " -"and such tuples, a :exc:`TypeError` exception is raised." +"function always returns false. If *classinfo* is a tuple of class or type " +"objects (or recursively, other such tuples), return true if *object* is an " +"instance of any of the classes or types. If *classinfo* is not a class, " +"type, or tuple of classes, types, and such tuples, a :exc:`TypeError` " +"exception is raised." +msgstr "" + +#: library/functions.rst:696 library/functions.rst:708 +msgid "Support for a tuple of type information was added." msgstr "" # e917036e1e1b490aae85a1161e75812f -#: ../src/Doc/library/functions.rst:697 +#: library/functions.rst:702 msgid "" "Return true if *class* is a subclass (direct, indirect or :term:`virtual " "`) of *classinfo*. A class is considered a subclass of " @@ -42855,7 +43349,7 @@ msgid "" msgstr "" # 3e1393400c3a430fa2af8f71e5be6c6c -#: ../src/Doc/library/functions.rst:709 +#: library/functions.rst:714 msgid "" "Return an :term:`iterator` object. The first argument is interpreted very " "differently depending on the presence of the second argument. Without a " @@ -42871,7 +43365,7 @@ msgid "" msgstr "" # 8a0c7d31a226495ebfbf00fb771a25e6 -#: ../src/Doc/library/functions.rst:720 +#: library/functions.rst:725 msgid "" "One useful application of the second form of :func:`iter` is to read lines " "of a file until a certain line is reached. The following example reads a " @@ -42880,7 +43374,7 @@ msgid "" msgstr "" # 1774b0ef22a44c51b6aeaabd1157f8b1 -#: ../src/Doc/library/functions.rst:733 +#: library/functions.rst:738 msgid "" "Return the length (the number of items) of an object. The argument may be a " "sequence (such as a string, bytes, tuple, list, or range) or a collection " @@ -42888,7 +43382,7 @@ msgid "" msgstr "" # 38285a52ceda403c96b5e50283da8672 -#: ../src/Doc/library/functions.rst:740 +#: library/functions.rst:745 msgid "" "Return a list whose items are the same and in the same order as *iterable*'s " "items. *iterable* may be either a sequence, a container that supports " @@ -42900,28 +43394,28 @@ msgid "" msgstr "" # 175ae8eff4bf427693abe8ed1ff56b78 -#: ../src/Doc/library/functions.rst:747 +#: library/functions.rst:752 msgid "" ":class:`list` is a mutable sequence type, as documented in :ref:`typesseq`. " "For other containers see the built in :class:`dict`, :class:`set`, and :" "class:`tuple` classes, and the :mod:`collections` module." msgstr "" -#: ../src/Doc/library/functions.rst:754 +#: library/functions.rst:759 msgid "" "Update and return a dictionary representing the current local symbol table. " "Free variables are returned by :func:`locals` when it is called in function " "blocks, but not in class blocks." msgstr "" -#: ../src/Doc/library/functions.rst:760 +#: library/functions.rst:765 msgid "" "The contents of this dictionary should not be modified; changes may not " "affect the values of local and free variables used by the interpreter." msgstr "" # 068ca9d6458f48fb8a1d4f2fc974bda7 -#: ../src/Doc/library/functions.rst:767 +#: library/functions.rst:772 msgid "" "Return a long integer object constructed from a string or number *x*. If the " "argument is a string, it must contain a possibly signed number of arbitrary " @@ -42934,12 +43428,12 @@ msgid "" msgstr "" # 996dd742d19c4fd3a921de4ca23b14f6 -#: ../src/Doc/library/functions.rst:776 +#: library/functions.rst:781 msgid "The long type is described in :ref:`typesnumeric`." msgstr "" # 9b5d084efd8a434b9c157e0436c6b97a -#: ../src/Doc/library/functions.rst:781 +#: library/functions.rst:786 msgid "" "Apply *function* to every item of *iterable* and return a list of the " "results. If additional *iterable* arguments are passed, *function* must take " @@ -42953,14 +43447,14 @@ msgid "" msgstr "" # b4f844019e8740a1a5790a034acf4248 -#: ../src/Doc/library/functions.rst:795 +#: library/functions.rst:800 msgid "" "Return the largest item in an iterable or the largest of two or more " "arguments." msgstr "" # 52e0422066a14020b89f2f77815e3a9e -#: ../src/Doc/library/functions.rst:798 +#: library/functions.rst:803 msgid "" "If one positional argument is provided, *iterable* must be a non-empty " "iterable (such as a non-empty string, tuple or list). The largest item in " @@ -42969,28 +43463,32 @@ msgid "" msgstr "" # 5e261046963d4dd58581fbf06f6522f6 -#: ../src/Doc/library/functions.rst:803 +#: library/functions.rst:808 msgid "" "The optional *key* argument specifies a one-argument ordering function like " "that used for :meth:`list.sort`. The *key* argument, if supplied, must be " "in keyword form (for example, ``max(a,b,c,key=func)``)." msgstr "" -#: ../src/Doc/library/functions.rst:814 +#: library/functions.rst:812 library/functions.rst:838 +msgid "Added support for the optional *key* argument." +msgstr "" + +#: library/functions.rst:819 msgid "" "Return a \"memory view\" object created from the given argument. See :ref:" "`typememoryview` for more information." msgstr "" # 42f9e4bb28074cfc897403f4e7e7f0cc -#: ../src/Doc/library/functions.rst:821 +#: library/functions.rst:826 msgid "" "Return the smallest item in an iterable or the smallest of two or more " "arguments." msgstr "" # 9a642d7422bf4ddc9a424f1fef7a8e06 -#: ../src/Doc/library/functions.rst:824 +#: library/functions.rst:829 msgid "" "If one positional argument is provided, *iterable* must be a non-empty " "iterable (such as a non-empty string, tuple or list). The smallest item in " @@ -42999,7 +43497,7 @@ msgid "" msgstr "" # 9182c4da168c4aaeb6095197c32dc41f -#: ../src/Doc/library/functions.rst:829 +#: library/functions.rst:834 msgid "" "The optional *key* argument specifies a one-argument ordering function like " "that used for :meth:`list.sort`. The *key* argument, if supplied, must be " @@ -43007,7 +43505,7 @@ msgid "" msgstr "" # 8a7fb18501d7422dadf77dabc6bd8b53 -#: ../src/Doc/library/functions.rst:839 +#: library/functions.rst:844 msgid "" "Retrieve the next item from the *iterator* by calling its :meth:`~iterator." "next` method. If *default* is given, it is returned if the iterator is " @@ -43015,22 +43513,28 @@ msgid "" msgstr "" # f7b54abddd2d49758e23b30a9d812ec2 -#: ../src/Doc/library/functions.rst:848 +#: library/functions.rst:853 msgid "" "Return a new featureless object. :class:`object` is a base for all new " "style classes. It has the methods that are common to all instances of new " "style classes." msgstr "" +#: library/functions.rst:859 +msgid "" +"This function does not accept any arguments. Formerly, it accepted arguments " +"but ignored them." +msgstr "" + # 73d051ff13b84840a93e2abdd6950f85 -#: ../src/Doc/library/functions.rst:861 +#: library/functions.rst:866 msgid "" "Convert an integer number (of any size) to an octal string. The result is a " "valid Python expression." msgstr "" # 12c7621f03394bfe889d3d81ea00a604 -#: ../src/Doc/library/functions.rst:870 +#: library/functions.rst:875 msgid "" "Open a file, returning an object of the :class:`file` type described in " "section :ref:`bltin-file-objects`. If the file cannot be opened, :exc:" @@ -43039,7 +43543,7 @@ msgid "" msgstr "" # 4082cefb9cdf4fd0a0104c471a4bb76e -#: ../src/Doc/library/functions.rst:875 +#: library/functions.rst:880 msgid "" "The first two arguments are the same as for ``stdio``'s :c:func:`fopen`: " "*name* is the file name to be opened, and *mode* is a string indicating how " @@ -43047,7 +43551,7 @@ msgid "" msgstr "" # 53b8ed05e7de4b4cb732d0406ae566c8 -#: ../src/Doc/library/functions.rst:879 +#: library/functions.rst:884 msgid "" "The most commonly-used values of *mode* are ``'r'`` for reading, ``'w'`` for " "writing (truncating the file if it already exists), and ``'a'`` for " @@ -43063,7 +43567,7 @@ msgid "" msgstr "" # a70d3d08fcea46359463d99b2151b495 -#: ../src/Doc/library/functions.rst:897 +#: library/functions.rst:902 msgid "" "The optional *buffering* argument specifies the file's desired buffer size: " "0 means unbuffered, 1 means line buffered, any other positive value means " @@ -43074,7 +43578,7 @@ msgid "" msgstr "" # 035d105c2b3342f0aca890d3d6a8ac03 -#: ../src/Doc/library/functions.rst:903 +#: library/functions.rst:908 msgid "" "Modes ``'r+'``, ``'w+'`` and ``'a+'`` open the file for updating (reading " "and writing); note that ``'w+'`` truncates the file. Append ``'b'`` to the " @@ -43084,7 +43588,7 @@ msgid "" msgstr "" # f4f173e2244d4002b753009c4bf49574 -#: ../src/Doc/library/functions.rst:911 +#: library/functions.rst:916 msgid "" "In addition to the standard :c:func:`fopen` values *mode* may be ``'U'`` or " "``'rU'``. Python is usually built with :term:`universal newlines` support; " @@ -43100,21 +43604,25 @@ msgid "" msgstr "" # e80b3074e1bd4200ae5f97fe8b33eebe -#: ../src/Doc/library/functions.rst:923 +#: library/functions.rst:928 msgid "" "Python enforces that the mode, after stripping ``'U'``, begins with ``'r'``, " "``'w'`` or ``'a'``." msgstr "" # e5791e974f1f4f779f2da29f2d94348e -#: ../src/Doc/library/functions.rst:926 +#: library/functions.rst:931 msgid "" "Python provides many file handling modules including :mod:`fileinput`, :mod:" "`os`, :mod:`os.path`, :mod:`tempfile`, and :mod:`shutil`." msgstr "" +#: library/functions.rst:935 +msgid "Restriction on first letter of mode string introduced." +msgstr "" + # a7e714f4411345de82c4baa272df2236 -#: ../src/Doc/library/functions.rst:936 +#: library/functions.rst:941 msgid "" "Given a string of length one, return an integer representing the Unicode " "code point of the character when the argument is a unicode object, or the " @@ -43127,7 +43635,7 @@ msgid "" "`TypeError` will be raised." msgstr "" -#: ../src/Doc/library/functions.rst:948 +#: library/functions.rst:953 msgid "" "Return *x* to the power *y*; if *z* is present, return *x* to the power *y*, " "modulo *z* (computed more efficiently than ``pow(x, y) % z``). The two-" @@ -43136,7 +43644,7 @@ msgid "" msgstr "" # 2dcc79b5c3f34a66a5a3e0e46c00a31b -#: ../src/Doc/library/functions.rst:952 +#: library/functions.rst:957 msgid "" "The arguments must have numeric types. With mixed operand types, the " "coercion rules for binary arithmetic operators apply. For int and long int " @@ -43154,7 +43662,7 @@ msgid "" msgstr "" # 89b6ba330c7f421796e4f6a60654e533 -#: ../src/Doc/library/functions.rst:969 +#: library/functions.rst:974 msgid "" "Print *objects* to the stream *file*, separated by *sep* and followed by " "*end*. *sep*, *end* and *file*, if present, must be given as keyword " @@ -43162,7 +43670,7 @@ msgid "" msgstr "" # 9fbc051cf5cd448291486f3f03f2e3b4 -#: ../src/Doc/library/functions.rst:973 +#: library/functions.rst:978 msgid "" "All non-keyword arguments are converted to strings like :func:`str` does and " "written to the stream, separated by *sep* and followed by *end*. Both *sep* " @@ -43172,7 +43680,7 @@ msgid "" msgstr "" # 27a5700749d34eda979634eaa4b5892d -#: ../src/Doc/library/functions.rst:979 +#: library/functions.rst:984 msgid "" "The *file* argument must be an object with a ``write(string)`` method; if it " "is not present or ``None``, :data:`sys.stdout` will be used. Output " @@ -43181,7 +43689,7 @@ msgid "" msgstr "" # 7ee8cae34bc84d37a9dc9f70939849f7 -#: ../src/Doc/library/functions.rst:986 +#: library/functions.rst:991 msgid "" "This function is not normally available as a built-in since the name " "``print`` is recognized as the :keyword:`print` statement. To disable the " @@ -43190,14 +43698,14 @@ msgid "" msgstr "" # c21273ed69a64ee18c79d6a5f839ca80 -#: ../src/Doc/library/functions.rst:998 +#: library/functions.rst:1003 msgid "" "Return a property attribute for :term:`new-style class`\\es (classes that " "derive from :class:`object`)." msgstr "" # 260d960c0ea44902ae901a112f72833b -#: ../src/Doc/library/functions.rst:1001 +#: library/functions.rst:1006 msgid "" "*fget* is a function for getting an attribute value. *fset* is a function " "for setting an attribute value. *fdel* is a function for deleting an " @@ -43205,18 +43713,18 @@ msgid "" msgstr "" # 28c71c2723584c229b163b85a0caaa57 -#: ../src/Doc/library/functions.rst:1005 +#: library/functions.rst:1010 msgid "A typical use is to define a managed attribute ``x``::" msgstr "" # 0bdaa5c4d1654283b2a24132833e380e -#: ../src/Doc/library/functions.rst:1022 +#: library/functions.rst:1027 msgid "" "If *c* is an instance of *C*, ``c.x`` will invoke the getter, ``c.x = " "value`` will invoke the setter and ``del c.x`` the deleter." msgstr "" -#: ../src/Doc/library/functions.rst:1025 +#: library/functions.rst:1030 msgid "" "If given, *doc* will be the docstring of the property attribute. Otherwise, " "the property will copy *fget*'s docstring (if it exists). This makes it " @@ -43225,7 +43733,7 @@ msgid "" msgstr "" # c8f7991f4d88460eb3bd43cd65eb9195 -#: ../src/Doc/library/functions.rst:1038 +#: library/functions.rst:1043 msgid "" "The ``@property`` decorator turns the :meth:`voltage` method into a \"getter" "\" for a read-only attribute with the same name, and it sets the docstring " @@ -43233,7 +43741,7 @@ msgid "" msgstr "" # 20dbe82ef09845ae9501272f2d755bb5 -#: ../src/Doc/library/functions.rst:1042 +#: library/functions.rst:1047 msgid "" "A property object has :attr:`~property.getter`, :attr:`~property.setter`, " "and :attr:`~property.deleter` methods usable as decorators that create a " @@ -43241,7 +43749,7 @@ msgid "" "decorated function. This is best explained with an example::" msgstr "" -#: ../src/Doc/library/functions.rst:1064 +#: library/functions.rst:1069 msgid "" "This code is exactly equivalent to the first example. Be sure to give the " "additional functions the same name as the original property (``x`` in this " @@ -43249,14 +43757,22 @@ msgid "" msgstr "" # 278848c1321d47f5898a9fe7d4096f2d -#: ../src/Doc/library/functions.rst:1068 +#: library/functions.rst:1073 msgid "" "The returned property object also has the attributes ``fget``, ``fset``, and " "``fdel`` corresponding to the constructor arguments." msgstr "" +#: library/functions.rst:1078 +msgid "Use *fget*'s docstring if no *doc* given." +msgstr "" + +#: library/functions.rst:1081 +msgid "The ``getter``, ``setter``, and ``deleter`` attributes were added." +msgstr "" + # 8e1eb338723a4e0fa373db334da8c130 -#: ../src/Doc/library/functions.rst:1083 +#: library/functions.rst:1088 msgid "" "This is a versatile function to create lists containing arithmetic " "progressions. It is most often used in :keyword:`for` loops. The arguments " @@ -43270,7 +43786,7 @@ msgid "" msgstr "" # f2a45385616a4f4bb2e820ccb567939e -#: ../src/Doc/library/functions.rst:1111 +#: library/functions.rst:1116 msgid "" "If the *prompt* argument is present, it is written to standard output " "without a trailing newline. The function then reads a line from input, " @@ -43279,14 +43795,14 @@ msgid "" msgstr "" # 3d8a95caf8b344b8ba09bac8d70e5671 -#: ../src/Doc/library/functions.rst:1121 +#: library/functions.rst:1126 msgid "" "If the :mod:`readline` module was loaded, then :func:`raw_input` will use it " "to provide elaborate line editing and history features." msgstr "" # b512af01ee604f6ba8198a7d25e49a1d -#: ../src/Doc/library/functions.rst:1127 +#: library/functions.rst:1132 msgid "" "Apply *function* of two arguments cumulatively to the items of *iterable*, " "from left to right, so as to reduce the iterable to a single value. For " @@ -43299,7 +43815,7 @@ msgid "" "the first item is returned. Roughly equivalent to::" msgstr "" -#: ../src/Doc/library/functions.rst:1151 +#: library/functions.rst:1156 msgid "" "Reload a previously imported *module*. The argument must be a module " "object, so it must have been successfully imported before. This is useful " @@ -43308,11 +43824,11 @@ msgid "" "return value is the module object (the same as the *module* argument)." msgstr "" -#: ../src/Doc/library/functions.rst:1157 +#: library/functions.rst:1162 msgid "When ``reload(module)`` is executed:" msgstr "" -#: ../src/Doc/library/functions.rst:1159 +#: library/functions.rst:1164 msgid "" "Python modules' code is recompiled and the module-level code reexecuted, " "defining a new set of objects which are bound to names in the module's " @@ -43320,40 +43836,30 @@ msgid "" "second time." msgstr "" -#: ../src/Doc/library/functions.rst:1164 +#: library/functions.rst:1169 msgid "" "As with all other objects in Python the old objects are only reclaimed after " "their reference counts drop to zero." msgstr "" -#: ../src/Doc/library/functions.rst:1167 +#: library/functions.rst:1172 msgid "" "The names in the module namespace are updated to point to any new or changed " "objects." msgstr "" -#: ../src/Doc/library/functions.rst:1170 +#: library/functions.rst:1175 msgid "" "Other references to the old objects (such as names external to the module) " "are not rebound to refer to the new objects and must be updated in each " "namespace where they occur if that is desired." msgstr "" -#: ../src/Doc/library/functions.rst:1174 +#: library/functions.rst:1179 msgid "There are a number of other caveats:" msgstr "" -#: ../src/Doc/library/functions.rst:1176 -msgid "" -"If a module is syntactically correct but its initialization fails, the " -"first :keyword:`import` statement for it does not bind its name locally, but " -"does store a (partially initialized) module object in ``sys.modules``. To " -"reload the module you must first :keyword:`import` it again (this will bind " -"the name to the partially initialized module object) before you can :func:" -"`reload` it." -msgstr "" - -#: ../src/Doc/library/functions.rst:1182 +#: library/functions.rst:1181 msgid "" "When a module is reloaded, its dictionary (containing the module's global " "variables) is retained. Redefinitions of names will override the old " @@ -43365,15 +43871,16 @@ msgid "" "if desired::" msgstr "" -#: ../src/Doc/library/functions.rst:1195 +#: library/functions.rst:1194 msgid "" -"It is legal though generally not very useful to reload built-in or " -"dynamically loaded modules, except for :mod:`sys`, :mod:`__main__` and :mod:" -"`__builtin__`. In many cases, however, extension modules are not designed to " -"be initialized more than once, and may fail in arbitrary ways when reloaded." +"It is generally not very useful to reload built-in or dynamically loaded " +"modules. Reloading :mod:`sys`, :mod:`__main__`, :mod:`builtins` and other " +"key modules is not recommended. In many cases extension modules are not " +"designed to be initialized more than once, and may fail in arbitrary ways " +"when reloaded." msgstr "" -#: ../src/Doc/library/functions.rst:1200 +#: library/functions.rst:1200 msgid "" "If a module imports objects from another module using :keyword:`from` ... :" "keyword:`import` ..., calling :func:`reload` for the other module does not " @@ -43382,7 +43889,7 @@ msgid "" "and qualified names (*module*.*name*) instead." msgstr "" -#: ../src/Doc/library/functions.rst:1206 +#: library/functions.rst:1206 msgid "" "If a module instantiates instances of a class, reloading the module that " "defines the class does not affect the method definitions of the instances " @@ -43391,7 +43898,7 @@ msgid "" msgstr "" # b155a72d4a2b48f9a16d5e395c543435 -#: ../src/Doc/library/functions.rst:1214 +#: library/functions.rst:1214 msgid "" "Return a string containing a printable representation of an object. This is " "the same value yielded by conversions (reverse quotes). It is sometimes " @@ -43404,7 +43911,7 @@ msgid "" "function returns for its instances by defining a :meth:`__repr__` method." msgstr "" -#: ../src/Doc/library/functions.rst:1227 +#: library/functions.rst:1227 msgid "" "Return a reverse :term:`iterator`. *seq* must be an object which has a :" "meth:`__reversed__` method or supports the sequence protocol (the :meth:" @@ -43412,8 +43919,12 @@ msgid "" "starting at ``0``)." msgstr "" +#: library/functions.rst:1234 +msgid "Added the possibility to write a custom :meth:`__reversed__` method." +msgstr "" + # 7e63aad0612c4bfaa8ff83c2ba12a6b1 -#: ../src/Doc/library/functions.rst:1240 +#: library/functions.rst:1240 msgid "" "Return the floating point value *number* rounded to *ndigits* digits after " "the decimal point. If *ndigits* is omitted, it defaults to zero. The result " @@ -43424,7 +43935,7 @@ msgid "" msgstr "" # 48923377831e480cb893154d21fd99fa -#: ../src/Doc/library/functions.rst:1250 +#: library/functions.rst:1250 msgid "" "The behavior of :func:`round` for floats can be surprising: for example, " "``round(2.675, 2)`` gives ``2.67`` instead of the expected ``2.68``. This is " @@ -43434,7 +43945,7 @@ msgid "" msgstr "" # 2eb4a3a7f8cc4e2ebf7b7da8120655b7 -#: ../src/Doc/library/functions.rst:1261 +#: library/functions.rst:1261 msgid "" "Return a new :class:`set` object, optionally with elements taken from " "*iterable*. ``set`` is a built-in class. See :class:`set` and :ref:`types-" @@ -43442,14 +43953,14 @@ msgid "" msgstr "" # f7a30ae9bd0043518ed7e3b865eb7348 -#: ../src/Doc/library/functions.rst:1265 +#: library/functions.rst:1265 msgid "" "For other containers see the built-in :class:`frozenset`, :class:`list`, :" "class:`tuple`, and :class:`dict` classes, as well as the :mod:`collections` " "module." msgstr "" -#: ../src/Doc/library/functions.rst:1274 +#: library/functions.rst:1274 msgid "" "This is the counterpart of :func:`getattr`. The arguments are an object, a " "string and an arbitrary value. The string may name an existing attribute or " @@ -43459,7 +43970,7 @@ msgid "" msgstr "" # 24081335269f45929da8d70665209deb -#: ../src/Doc/library/functions.rst:1286 +#: library/functions.rst:1286 msgid "" "Return a :term:`slice` object representing the set of indices specified by " "``range(start, stop, step)``. The *start* and *step* arguments default to " @@ -43473,12 +43984,12 @@ msgid "" "iterator." msgstr "" -#: ../src/Doc/library/functions.rst:1299 +#: library/functions.rst:1299 msgid "Return a new sorted list from the items in *iterable*." msgstr "" # cd32255c486f43ff8bf9eaa6202781e9 -#: ../src/Doc/library/functions.rst:1301 +#: library/functions.rst:1301 msgid "" "The optional arguments *cmp*, *key*, and *reverse* have the same meaning as " "those for the :meth:`list.sort` method (described in section :ref:`typesseq-" @@ -43486,7 +43997,7 @@ msgid "" msgstr "" # 62ff2d3ded5c4869a18ac4065cbd5b0a -#: ../src/Doc/library/functions.rst:1305 +#: library/functions.rst:1305 msgid "" "*cmp* specifies a custom comparison function of two arguments (iterable " "elements) which should return a negative, zero or positive number depending " @@ -43495,14 +44006,14 @@ msgid "" "lower())``. The default value is ``None``." msgstr "" -#: ../src/Doc/library/functions.rst:1311 +#: library/functions.rst:1311 msgid "" "*key* specifies a function of one argument that is used to extract a " "comparison key from each list element: ``key=str.lower``. The default value " "is ``None`` (compare the elements directly)." msgstr "" -#: ../src/Doc/library/functions.rst:1315 ../src/Doc/library/stdtypes.rst:1690 +#: library/functions.rst:1315 library/stdtypes.rst:1696 msgid "" "*reverse* is a boolean value. If set to ``True``, then the list elements " "are sorted as if each comparison were reversed." @@ -43510,7 +44021,7 @@ msgstr "" # 6324ee6cdf14415ca1d4220369bc9a70 # 2bb86cff52334f9b8d95b6e2a6aeea4e -#: ../src/Doc/library/functions.rst:1318 ../src/Doc/library/stdtypes.rst:1693 +#: library/functions.rst:1318 library/stdtypes.rst:1699 msgid "" "In general, the *key* and *reverse* conversion processes are much faster " "than specifying an equivalent *cmp* function. This is because *cmp* is " @@ -43520,7 +44031,7 @@ msgid "" msgstr "" # e0849879f8c943a789e7a4621a534c77 -#: ../src/Doc/library/functions.rst:1324 +#: library/functions.rst:1324 msgid "" "The built-in :func:`sorted` function is guaranteed to be stable. A sort is " "stable if it guarantees not to change the relative order of elements that " @@ -43530,49 +44041,49 @@ msgstr "" # 8ba3f6bb379f4ef684e4bf73d145e619 # be0f71bec8964d67a98598aa0e98da0b -#: ../src/Doc/library/functions.rst:1329 ../src/Doc/library/functools.rst:41 +#: library/functions.rst:1329 library/functools.rst:41 msgid "" "For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`." msgstr "" -#: ../src/Doc/library/functions.rst:1336 +#: library/functions.rst:1336 msgid "Return a static method for *function*." msgstr "" -#: ../src/Doc/library/functions.rst:1338 +#: library/functions.rst:1338 msgid "" "A static method does not receive an implicit first argument. To declare a " "static method, use this idiom::" msgstr "" -#: ../src/Doc/library/functions.rst:1346 +#: library/functions.rst:1346 msgid "" "The ``@staticmethod`` form is a function :term:`decorator` -- see the " "description of function definitions in :ref:`function` for details." msgstr "" -#: ../src/Doc/library/functions.rst:1349 +#: library/functions.rst:1349 msgid "" "It can be called either on the class (such as ``C.f()``) or on an instance " "(such as ``C().f()``). The instance is ignored except for its class." msgstr "" # f43ee32571234e00a384f6c776b57251 -#: ../src/Doc/library/functions.rst:1352 +#: library/functions.rst:1352 msgid "" "Static methods in Python are similar to those found in Java or C++. Also " "see :func:`classmethod` for a variant that is useful for creating alternate " "class constructors." msgstr "" -#: ../src/Doc/library/functions.rst:1356 +#: library/functions.rst:1356 msgid "" "For more information on static methods, consult the documentation on the " "standard type hierarchy in :ref:`types`." msgstr "" # c9617735d2304b86857d445274e7826e -#: ../src/Doc/library/functions.rst:1367 +#: library/functions.rst:1367 msgid "" "Return a string containing a nicely printable representation of an object. " "For strings, this returns the string itself. The difference with " @@ -43582,7 +44093,7 @@ msgid "" msgstr "" # b222428125cc42f7b315cf9f5528e10b -#: ../src/Doc/library/functions.rst:1373 +#: library/functions.rst:1373 msgid "" "For more information on strings see :ref:`typesseq` which describes sequence " "functionality (strings are sequences), and also the string-specific methods " @@ -43593,7 +44104,7 @@ msgid "" msgstr "" # ab0d44c21fa44577b872110db6e26778 -#: ../src/Doc/library/functions.rst:1383 +#: library/functions.rst:1383 msgid "" "Sums *start* and the items of an *iterable* from left to right and returns " "the total. *start* defaults to ``0``. The *iterable*'s items are normally " @@ -43601,7 +44112,7 @@ msgid "" msgstr "" # 5cd1fc53b56f422ca2332ab34e2561da -#: ../src/Doc/library/functions.rst:1387 +#: library/functions.rst:1387 msgid "" "For some use cases, there are good alternatives to :func:`sum`. The " "preferred, fast way to concatenate a sequence of strings is by calling ``''." @@ -43610,7 +44121,7 @@ msgid "" "using :func:`itertools.chain`." msgstr "" -#: ../src/Doc/library/functions.rst:1398 +#: library/functions.rst:1398 msgid "" "Return a proxy object that delegates method calls to a parent or sibling " "class of *type*. This is useful for accessing inherited methods that have " @@ -43619,7 +44130,7 @@ msgid "" msgstr "" # 46b4272cf7db4d1894a1640e8be15601 -#: ../src/Doc/library/functions.rst:1403 +#: library/functions.rst:1403 msgid "" "The :attr:`~class.__mro__` attribute of the *type* lists the method " "resolution search order used by both :func:`getattr` and :func:`super`. The " @@ -43627,7 +44138,7 @@ msgid "" "updated." msgstr "" -#: ../src/Doc/library/functions.rst:1408 +#: library/functions.rst:1408 msgid "" "If the second argument is omitted, the super object returned is unbound. If " "the second argument is an object, ``isinstance(obj, type)`` must be true. " @@ -43636,11 +44147,11 @@ msgid "" msgstr "" # 9b436690b89f4efa9463e8b3a0b7bfd8 -#: ../src/Doc/library/functions.rst:1414 +#: library/functions.rst:1414 msgid ":func:`super` only works for :term:`new-style class`\\es." msgstr "" -#: ../src/Doc/library/functions.rst:1416 +#: library/functions.rst:1416 msgid "" "There are two typical use cases for *super*. In a class hierarchy with " "single inheritance, *super* can be used to refer to parent classes without " @@ -43648,7 +44159,7 @@ msgid "" "closely parallels the use of *super* in other programming languages." msgstr "" -#: ../src/Doc/library/functions.rst:1421 +#: library/functions.rst:1421 msgid "" "The second use case is to support cooperative multiple inheritance in a " "dynamic execution environment. This use case is unique to Python and is not " @@ -43661,11 +44172,11 @@ msgid "" "are unknown prior to runtime)." msgstr "" -#: ../src/Doc/library/functions.rst:1431 +#: library/functions.rst:1431 msgid "For both use cases, a typical superclass call looks like this::" msgstr "" -#: ../src/Doc/library/functions.rst:1437 +#: library/functions.rst:1437 msgid "" "Note that :func:`super` is implemented as part of the binding process for " "explicit dotted attribute lookups such as ``super().__getitem__(name)``. It " @@ -43676,7 +44187,7 @@ msgid "" msgstr "" # b3f26ccf341346ccbdcdcf1ea8753fdf -#: ../src/Doc/library/functions.rst:1444 +#: library/functions.rst:1444 msgid "" "Also note that :func:`super` is not limited to use inside methods. The two " "argument form specifies the arguments exactly and makes the appropriate " @@ -43684,14 +44195,14 @@ msgid "" msgstr "" # 7f67d6e61f404a9e9cba903703adc793 -#: ../src/Doc/library/functions.rst:1448 +#: library/functions.rst:1448 msgid "" "For practical suggestions on how to design cooperative classes using :func:" "`super`, see `guide to using super() `_." msgstr "" -#: ../src/Doc/library/functions.rst:1457 +#: library/functions.rst:1457 msgid "" "Return a tuple whose items are the same and in the same order as " "*iterable*'s items. *iterable* may be a sequence, a container that supports " @@ -43702,7 +44213,7 @@ msgid "" msgstr "" # 94d1469ab3874c83898067f332e524df -#: ../src/Doc/library/functions.rst:1464 +#: library/functions.rst:1464 msgid "" ":class:`tuple` is an immutable sequence type, as documented in :ref:" "`typesseq`. For other containers see the built in :class:`dict`, :class:" @@ -43710,7 +44221,7 @@ msgid "" msgstr "" # 95c8ae1e9abf4922be6ba0516215b2c1 -#: ../src/Doc/library/functions.rst:1474 +#: library/functions.rst:1474 msgid "" "With one argument, return the type of an *object*. The return value is a " "type object. The :func:`isinstance` built-in function is recommended for " @@ -43718,7 +44229,7 @@ msgid "" msgstr "" # 4d7bc3be8b3c48f2882d18ef71c60768 -#: ../src/Doc/library/functions.rst:1478 +#: library/functions.rst:1478 msgid "" "With three arguments, return a new type object. This is essentially a " "dynamic form of the :keyword:`class` statement. The *name* string is the " @@ -43730,7 +44241,7 @@ msgid "" msgstr "" # 347d3ff00fc944e297e1686b124672c7 -#: ../src/Doc/library/functions.rst:1496 +#: library/functions.rst:1496 msgid "" "Return the Unicode string of one character whose Unicode code is the integer " "*i*. For example, ``unichr(97)`` returns the string ``u'a'``. This is the " @@ -43741,14 +44252,14 @@ msgid "" msgstr "" # 2b11e0d9ca9841289d23ced3c584f988 -#: ../src/Doc/library/functions.rst:1509 +#: library/functions.rst:1509 msgid "" "Return the Unicode string version of *object* using one of the following " "modes:" msgstr "" # e535155ddd854031a9b1227e72f94d53 -#: ../src/Doc/library/functions.rst:1511 +#: library/functions.rst:1511 msgid "" "If *encoding* and/or *errors* are given, ``unicode()`` will decode the " "object which can either be an 8-bit string or a character buffer using the " @@ -43764,7 +44275,7 @@ msgid "" msgstr "" # c6b6950dccad403bb94c7b1a674f3703 -#: ../src/Doc/library/functions.rst:1522 +#: library/functions.rst:1522 msgid "" "If no optional parameters are given, ``unicode()`` will mimic the behaviour " "of ``str()`` except that it returns Unicode strings instead of 8-bit " @@ -43773,7 +44284,7 @@ msgid "" msgstr "" # 0f9683207d674fef8ffb3112beb562d0 -#: ../src/Doc/library/functions.rst:1527 +#: library/functions.rst:1527 msgid "" "For objects which provide a :meth:`__unicode__` method, it will call this " "method without arguments to create a Unicode string. For all other objects, " @@ -43783,7 +44294,7 @@ msgid "" msgstr "" # e7ffaad9530642978c6d3cf7c7655e94 -#: ../src/Doc/library/functions.rst:1532 +#: library/functions.rst:1532 msgid "" "For more information on Unicode strings see :ref:`typesseq` which describes " "sequence functionality (Unicode strings are sequences), and also the string-" @@ -43793,15 +44304,19 @@ msgid "" "`stringservices` section. See also :func:`str`." msgstr "" +#: library/functions.rst:1541 +msgid "Support for :meth:`__unicode__` added." +msgstr "" + # ad0b3012d49445248fc9b0c27e35128f -#: ../src/Doc/library/functions.rst:1547 +#: library/functions.rst:1547 msgid "" "Return the :attr:`~object.__dict__` attribute for a module, class, instance, " "or any other object with a :attr:`__dict__` attribute." msgstr "" # 5338d96f48354502b84c639c70fc1321 -#: ../src/Doc/library/functions.rst:1550 +#: library/functions.rst:1550 msgid "" "Objects such as modules and instances have an updateable :attr:`__dict__` " "attribute; however, other objects may have write restrictions on their :attr:" @@ -43810,7 +44325,7 @@ msgid "" msgstr "" # 698c0343804b4f94b699c3035ab511ec -#: ../src/Doc/library/functions.rst:1555 +#: library/functions.rst:1555 msgid "" "Without an argument, :func:`vars` acts like :func:`locals`. Note, the " "locals dictionary is only useful for reads since updates to the locals " @@ -43818,7 +44333,7 @@ msgid "" msgstr "" # 00df7fdef8d74646b5f1ff5c71ecf9b6 -#: ../src/Doc/library/functions.rst:1563 +#: library/functions.rst:1563 msgid "" "This function is very similar to :func:`range`, but returns an :ref:`xrange " "object ` instead of a list. This is an opaque sequence " @@ -43833,7 +44348,7 @@ msgid "" msgstr "" # fa91a25675124b0d8c5fde234b1e50bf -#: ../src/Doc/library/functions.rst:1576 +#: library/functions.rst:1576 msgid "" ":func:`xrange` is intended to be simple and fast. Implementations may " "impose restrictions to achieve this. The C implementation of Python " @@ -43845,7 +44360,7 @@ msgid "" msgstr "" # 84942c24d00342dc9cbb241a25c5c6e4 -#: ../src/Doc/library/functions.rst:1587 +#: library/functions.rst:1587 msgid "" "This function returns a list of tuples, where the *i*-th tuple contains the " "*i*-th element from each of the argument sequences or iterables. The " @@ -43856,28 +44371,34 @@ msgid "" "With no arguments, it returns an empty list." msgstr "" -#: ../src/Doc/library/functions.rst:1595 +#: library/functions.rst:1595 msgid "" "The left-to-right evaluation order of the iterables is guaranteed. This " "makes possible an idiom for clustering a data series into n-length groups " "using ``zip(*[iter(s)]*n)``." msgstr "" -#: ../src/Doc/library/functions.rst:1599 +#: library/functions.rst:1599 msgid "" ":func:`zip` in conjunction with the ``*`` operator can be used to unzip a " "list::" msgstr "" +#: library/functions.rst:1613 +msgid "" +"Formerly, :func:`zip` required at least one argument and ``zip()`` raised a :" +"exc:`TypeError` instead of returning an empty list." +msgstr "" + # a527e3de93704951a8b083eacb971b5f -#: ../src/Doc/library/functions.rst:1626 +#: library/functions.rst:1626 msgid "" "This is an advanced function that is not needed in everyday Python " "programming, unlike :func:`importlib.import_module`." msgstr "" # fcfe85d91e0948e6988d23a26947e988 -#: ../src/Doc/library/functions.rst:1629 +#: library/functions.rst:1629 msgid "" "This function is invoked by the :keyword:`import` statement. It can be " "replaced (by importing the :mod:`__builtin__` module and assigning to " @@ -43887,7 +44408,7 @@ msgid "" "where you want to import a module whose name is only known at runtime." msgstr "" -#: ../src/Doc/library/functions.rst:1636 +#: library/functions.rst:1636 msgid "" "The function imports the module *name*, potentially using the given " "*globals* and *locals* to determine how to interpret the name in a package " @@ -43898,7 +44419,7 @@ msgid "" msgstr "" # fb94409581c94f64a0fbdb2037a8ab22 -#: ../src/Doc/library/functions.rst:1643 +#: library/functions.rst:1643 msgid "" "*level* specifies whether to use absolute or relative imports. The default " "is ``-1`` which indicates both absolute and relative imports will be " @@ -43907,7 +44428,7 @@ msgid "" "directory of the module calling :func:`__import__`." msgstr "" -#: ../src/Doc/library/functions.rst:1649 +#: library/functions.rst:1649 msgid "" "When the *name* variable is of the form ``package.module``, normally, the " "top-level package (the name up till the first dot) is returned, *not* the " @@ -43915,29 +44436,29 @@ msgid "" "given, the module named by *name* is returned." msgstr "" -#: ../src/Doc/library/functions.rst:1654 +#: library/functions.rst:1654 msgid "" "For example, the statement ``import spam`` results in bytecode resembling " "the following code::" msgstr "" -#: ../src/Doc/library/functions.rst:1659 +#: library/functions.rst:1659 msgid "The statement ``import spam.ham`` results in this call::" msgstr "" -#: ../src/Doc/library/functions.rst:1663 +#: library/functions.rst:1663 msgid "" "Note how :func:`__import__` returns the toplevel module here because this is " "the object that is bound to a name by the :keyword:`import` statement." msgstr "" -#: ../src/Doc/library/functions.rst:1666 +#: library/functions.rst:1666 msgid "" "On the other hand, the statement ``from spam.ham import eggs, sausage as " "saus`` results in ::" msgstr "" -#: ../src/Doc/library/functions.rst:1673 +#: library/functions.rst:1673 msgid "" "Here, the ``spam.ham`` module is returned from :func:`__import__`. From " "this object, the names to import are retrieved and assigned to their " @@ -43945,19 +44466,27 @@ msgid "" msgstr "" # 6010c728813d4593acd28212dee6a05e -#: ../src/Doc/library/functions.rst:1677 +#: library/functions.rst:1677 msgid "" "If you simply want to import a module (potentially within a package) by " "name, use :func:`importlib.import_module`." msgstr "" +#: library/functions.rst:1681 +msgid "The level parameter was added." +msgstr "" + +#: library/functions.rst:1684 +msgid "Keyword support for parameters was added." +msgstr "" + # 0407e87bb85649e7ae97cff55147c52c -#: ../src/Doc/library/functions.rst:1693 +#: library/functions.rst:1693 msgid "Non-essential Built-in Functions" msgstr "" # eb9c38b1e6de425eb7d4d00707d9d823 -#: ../src/Doc/library/functions.rst:1695 +#: library/functions.rst:1695 msgid "" "There are several built-in functions that are no longer essential to learn, " "know or use in modern Python programming. They have been kept here to " @@ -43966,14 +44495,14 @@ msgid "" msgstr "" # db846c24e58344448216ee2a0357fad0 -#: ../src/Doc/library/functions.rst:1699 +#: library/functions.rst:1699 msgid "" "Python programmers, trainers, students and book writers should feel free to " "bypass these functions without concerns about missing something important." msgstr "" # 5718a2901033469bb268b13fc60d25a8 -#: ../src/Doc/library/functions.rst:1705 +#: library/functions.rst:1705 msgid "" "The *function* argument must be a callable object (a user-defined or built-" "in function or method, or a class object) and the *args* argument must be a " @@ -43986,8 +44515,14 @@ msgid "" "`apply` is equivalent to ``function(*args, **keywords)``." msgstr "" +#: library/functions.rst:1715 +msgid "" +"Use ``function(*args, **keywords)`` instead of ``apply(function, args, " +"keywords)`` (see :ref:`tut-unpacking-arguments`)." +msgstr "" + # 15bf1ee03a2e498db48ef647626746c7 -#: ../src/Doc/library/functions.rst:1722 +#: library/functions.rst:1722 msgid "" "The *object* argument must be an object that supports the buffer call " "interface (such as strings, arrays, and buffers). A new buffer object will " @@ -43998,14 +44533,14 @@ msgid "" msgstr "" # 665ee66d11324a09a487a4e2924cf47a -#: ../src/Doc/library/functions.rst:1732 +#: library/functions.rst:1732 msgid "" "Return a tuple consisting of the two numeric arguments converted to a common " "type, using the same rules as used by arithmetic operations. If coercion is " "not possible, raise :exc:`TypeError`." msgstr "" -#: ../src/Doc/library/functions.rst:1739 +#: library/functions.rst:1739 msgid "" "Enter *string* in the table of \"interned\" strings and return the interned " "string -- which is *string* itself or a copy. Interning strings is useful to " @@ -44017,14 +44552,21 @@ msgid "" "attributes have interned keys." msgstr "" +#: library/functions.rst:1747 +msgid "" +"Interned strings are not immortal (like they used to be in Python 2.2 and " +"before); you must keep a reference to the return value of :func:`intern` " +"around to benefit from it." +msgstr "" + # 75f1dc7cfab14bbdbd27d6b07f06f09e -#: ../src/Doc/library/functions.rst:1754 +#: library/functions.rst:1754 msgid "" "It is used relatively rarely so does not warrant being made into a statement." msgstr "" # 1b51e1b4cf674c3b8db156e847f54bee -#: ../src/Doc/library/functions.rst:1756 +#: library/functions.rst:1756 msgid "" "Specifying a buffer size currently has no effect on systems that don't have :" "c:func:`setvbuf`. The interface to specify the buffer size is not done " @@ -44033,7 +44575,7 @@ msgid "" "determine whether this is the case." msgstr "" -#: ../src/Doc/library/functions.rst:1762 +#: library/functions.rst:1762 msgid "" "In the current implementation, local variable bindings cannot normally be " "affected this way, but variables retrieved from other scopes (such as " @@ -44041,30 +44583,30 @@ msgid "" msgstr "" # b094601956e844ffa5b204d2a66bd28e -#: ../src/Doc/library/functools.rst:2 +#: library/functools.rst:2 msgid "" ":mod:`functools` --- Higher-order functions and operations on callable " "objects" msgstr "" # 1410c312e8b940118183b898e1e6cd7d -#: ../src/Doc/library/functools.rst:13 +#: library/functools.rst:13 msgid "**Source code:** :source:`Lib/functools.py`" msgstr "" -#: ../src/Doc/library/functools.rst:17 +#: library/functools.rst:17 msgid "" "The :mod:`functools` module is for higher-order functions: functions that " "act on or return other functions. In general, any callable object can be " "treated as a function for the purposes of this module." msgstr "" -#: ../src/Doc/library/functools.rst:21 +#: library/functools.rst:21 msgid "The :mod:`functools` module defines the following functions:" msgstr "" # c2c2288004d7482ea39fa04c6a3bb4b8 -#: ../src/Doc/library/functools.rst:25 +#: library/functools.rst:25 msgid "" "Transform an old-style comparison function to a :term:`key function`. Used " "with tools that accept key functions (such as :func:`sorted`, :func:`min`, :" @@ -44075,7 +44617,7 @@ msgid "" msgstr "" # b379dd896ada42bd83b1119b81cf3bc3 -#: ../src/Doc/library/functools.rst:32 +#: library/functools.rst:32 msgid "" "A comparison function is any callable that accept two arguments, compares " "them, and returns a negative number for less-than, zero for equality, or a " @@ -44083,14 +44625,14 @@ msgid "" "one argument and returns another value to be used as the sort key." msgstr "" -#: ../src/Doc/library/functools.rst:48 +#: library/functools.rst:48 msgid "" "Given a class defining one or more rich comparison ordering methods, this " "class decorator supplies the rest. This simplifies the effort involved in " "specifying all of the possible rich comparison operations:" msgstr "" -#: ../src/Doc/library/functools.rst:52 +#: library/functools.rst:52 msgid "" "The class must define one of :meth:`__lt__`, :meth:`__le__`, :meth:`__gt__`, " "or :meth:`__ge__`. In addition, the class should supply an :meth:`__eq__` " @@ -44098,13 +44640,13 @@ msgid "" msgstr "" # ce076cbb430d4e078a4c7d35b81e76bd -#: ../src/Doc/library/functools.rst:71 +#: library/functools.rst:71 msgid "" "This is the same function as :func:`reduce`. It is made available in this " "module to allow writing code more forward-compatible with Python 3." msgstr "" -#: ../src/Doc/library/functools.rst:79 +#: library/functools.rst:79 msgid "" "Return a new :class:`partial` object which when called will behave like " "*func* called with the positional arguments *args* and keyword arguments " @@ -44113,7 +44655,7 @@ msgid "" "override *keywords*. Roughly equivalent to::" msgstr "" -#: ../src/Doc/library/functools.rst:95 +#: library/functools.rst:95 msgid "" "The :func:`partial` is used for partial function application which \"freezes" "\" some portion of a function's arguments and/or keywords resulting in a new " @@ -44122,7 +44664,7 @@ msgid "" "the *base* argument defaults to two:" msgstr "" -#: ../src/Doc/library/functools.rst:110 +#: library/functools.rst:110 msgid "" "Update a *wrapper* function to look like the *wrapped* function. The " "optional arguments are tuples to specify which attributes of the original " @@ -44135,7 +44677,7 @@ msgid "" "function's *__dict__*, i.e. the instance dictionary)." msgstr "" -#: ../src/Doc/library/functools.rst:120 +#: library/functools.rst:120 msgid "" "The main intended use for this function is in :term:`decorator` functions " "which wrap the decorated function and return the wrapper. If the wrapper " @@ -44145,7 +44687,7 @@ msgid "" msgstr "" # e70f19bcd5ac452287206bc1a606ea3a -#: ../src/Doc/library/functools.rst:129 +#: library/functools.rst:129 msgid "" "This is a convenience function for invoking :func:`update_wrapper` as a " "function decorator when defining a wrapper function. It is equivalent to " @@ -44153,42 +44695,42 @@ msgid "" "updated=updated)``. For example::" msgstr "" -#: ../src/Doc/library/functools.rst:155 +#: library/functools.rst:155 msgid "" "Without the use of this decorator factory, the name of the example function " "would have been ``'wrapper'``, and the docstring of the original :func:" "`example` would have been lost." msgstr "" -#: ../src/Doc/library/functools.rst:163 +#: library/functools.rst:163 msgid ":class:`partial` Objects" msgstr "" -#: ../src/Doc/library/functools.rst:165 +#: library/functools.rst:165 msgid "" ":class:`partial` objects are callable objects created by :func:`partial`. " "They have three read-only attributes:" msgstr "" -#: ../src/Doc/library/functools.rst:171 +#: library/functools.rst:171 msgid "" "A callable object or function. Calls to the :class:`partial` object will be " "forwarded to :attr:`func` with new arguments and keywords." msgstr "" -#: ../src/Doc/library/functools.rst:177 +#: library/functools.rst:177 msgid "" "The leftmost positional arguments that will be prepended to the positional " "arguments provided to a :class:`partial` object call." msgstr "" -#: ../src/Doc/library/functools.rst:183 +#: library/functools.rst:183 msgid "" "The keyword arguments that will be supplied when the :class:`partial` object " "is called." msgstr "" -#: ../src/Doc/library/functools.rst:186 +#: library/functools.rst:186 msgid "" ":class:`partial` objects are like :class:`function` objects in that they are " "callable, weak referencable, and can have attributes. There are some " @@ -44199,33 +44741,33 @@ msgid "" msgstr "" # ee7bc687c755409db70d5242c426d927 -#: ../src/Doc/library/future_builtins.rst:2 +#: library/future_builtins.rst:2 msgid ":mod:`future_builtins` --- Python 3 builtins" msgstr "" # c395f12ad281423583232c1e0066af75 -#: ../src/Doc/library/future_builtins.rst:8 +#: library/future_builtins.rst:8 msgid "" "This module provides functions that exist in 2.x, but have different " "behavior in Python 3, so they cannot be put into the 2.x builtins namespace." msgstr "" # ebb98a4851d4432699dfd305de189cf1 -#: ../src/Doc/library/future_builtins.rst:11 +#: library/future_builtins.rst:11 msgid "" "Instead, if you want to write code compatible with Python 3 builtins, import " "them from this module, like this::" msgstr "" # 0a715bb374f84454b121bcc68595505a -#: ../src/Doc/library/future_builtins.rst:18 +#: library/future_builtins.rst:18 msgid "" "The :term:`2to3` tool that ports Python 2 code to Python 3 will recognize " "this usage and leave the new builtins alone." msgstr "" # 2a660e897f094884bc655716362a5712 -#: ../src/Doc/library/future_builtins.rst:23 +#: library/future_builtins.rst:23 msgid "" "The Python 3 :func:`print` function is already in the builtins, but cannot " "be accessed from Python 2 code unless you use the appropriate future " @@ -44233,12 +44775,12 @@ msgid "" msgstr "" # 6916d5bf51604a2fa120b9c6de363270 -#: ../src/Doc/library/future_builtins.rst:29 +#: library/future_builtins.rst:29 msgid "Available builtins are:" msgstr "" # a4d1586b478e450594b3aed520c90ba5 -#: ../src/Doc/library/future_builtins.rst:33 +#: library/future_builtins.rst:33 msgid "" "Returns the same as :func:`repr`. In Python 3, :func:`repr` will return " "printable Unicode characters unescaped, while :func:`ascii` will always " @@ -44247,12 +44789,12 @@ msgid "" msgstr "" # 88564963271341b0ad04abaf55bc506f -#: ../src/Doc/library/future_builtins.rst:41 +#: library/future_builtins.rst:41 msgid "Works like :func:`itertools.ifilter`." msgstr "" # a20a5b522cb843899fb51a2f6e01722c -#: ../src/Doc/library/future_builtins.rst:45 +#: library/future_builtins.rst:45 msgid "" "Works like the built-in :func:`hex`, but instead of :meth:`__hex__` it will " "use the :meth:`__index__` method on its argument to get an integer that is " @@ -44260,18 +44802,18 @@ msgid "" msgstr "" # 44fc0f14780241efb6a35ef7f6ebbc35 -#: ../src/Doc/library/future_builtins.rst:51 +#: library/future_builtins.rst:51 msgid "Works like :func:`itertools.imap`." msgstr "" # 3bd581e0743a494ea77fcce08a8f1d11 -#: ../src/Doc/library/future_builtins.rst:55 +#: library/future_builtins.rst:55 msgid "" "In Python 3, :func:`map` does not accept ``None`` for the function argument." msgstr "" # 92e09ede8b5c46e5b82601e9751cbe2f -#: ../src/Doc/library/future_builtins.rst:60 +#: library/future_builtins.rst:60 msgid "" "Works like the built-in :func:`oct`, but instead of :meth:`__oct__` it will " "use the :meth:`__index__` method on its argument to get an integer that is " @@ -44279,15 +44821,15 @@ msgid "" msgstr "" # 980b8fbe79534925a4b9c828901a83e1 -#: ../src/Doc/library/future_builtins.rst:66 +#: library/future_builtins.rst:66 msgid "Works like :func:`itertools.izip`." msgstr "" -#: ../src/Doc/library/gc.rst:3 +#: library/gc.rst:3 msgid ":mod:`gc` --- Garbage Collector interface" msgstr "" -#: ../src/Doc/library/gc.rst:11 +#: library/gc.rst:11 msgid "" "This module provides an interface to the optional garbage collector. It " "provides the ability to disable the collector, tune the collection " @@ -44301,23 +44843,23 @@ msgid "" "saved in gc.garbage for inspection." msgstr "" -#: ../src/Doc/library/gc.rst:22 +#: library/gc.rst:22 msgid "The :mod:`gc` module provides the following functions:" msgstr "" -#: ../src/Doc/library/gc.rst:27 +#: library/gc.rst:27 msgid "Enable automatic garbage collection." msgstr "" -#: ../src/Doc/library/gc.rst:32 +#: library/gc.rst:32 msgid "Disable automatic garbage collection." msgstr "" -#: ../src/Doc/library/gc.rst:37 +#: library/gc.rst:37 msgid "Returns true if automatic collection is enabled." msgstr "" -#: ../src/Doc/library/gc.rst:42 +#: library/gc.rst:42 msgid "" "With no arguments, run a full collection. The optional argument " "*generation* may be an integer specifying which generation to collect (from " @@ -44325,30 +44867,42 @@ msgid "" "invalid. The number of unreachable objects found is returned." msgstr "" -#: ../src/Doc/library/gc.rst:59 +#: library/gc.rst:47 +msgid "The optional *generation* argument was added." +msgstr "" + +#: library/gc.rst:50 +msgid "" +"The free lists maintained for a number of built-in types are cleared " +"whenever a full collection or collection of the highest generation (2) is " +"run. Not all items in some free lists may be freed due to the particular " +"implementation, in particular :class:`int` and :class:`float`." +msgstr "" + +#: library/gc.rst:59 msgid "" "Set the garbage collection debugging flags. Debugging information will be " "written to ``sys.stderr``. See below for a list of debugging flags which " "can be combined using bit operations to control debugging." msgstr "" -#: ../src/Doc/library/gc.rst:66 +#: library/gc.rst:66 msgid "Return the debugging flags currently set." msgstr "" -#: ../src/Doc/library/gc.rst:71 +#: library/gc.rst:71 msgid "" "Returns a list of all objects tracked by the collector, excluding the list " "returned." msgstr "" -#: ../src/Doc/library/gc.rst:79 +#: library/gc.rst:79 msgid "" "Set the garbage collection thresholds (the collection frequency). Setting " "*threshold0* to zero disables collection." msgstr "" -#: ../src/Doc/library/gc.rst:82 +#: library/gc.rst:82 msgid "" "The GC classifies objects into three generations depending on how many " "collection sweeps they have survived. New objects are placed in the " @@ -44365,19 +44919,19 @@ msgid "" "collections of generation ``1`` before collecting generation ``2``." msgstr "" -#: ../src/Doc/library/gc.rst:99 +#: library/gc.rst:99 msgid "" "Return the current collection counts as a tuple of ``(count0, count1, " "count2)``." msgstr "" -#: ../src/Doc/library/gc.rst:107 +#: library/gc.rst:107 msgid "" "Return the current collection thresholds as a tuple of ``(threshold0, " "threshold1, threshold2)``." msgstr "" -#: ../src/Doc/library/gc.rst:113 +#: library/gc.rst:113 msgid "" "Return the list of objects that directly refer to any of objs. This function " "will only locate those containers which support garbage collection; " @@ -44385,7 +44939,7 @@ msgid "" "collection will not be found." msgstr "" -#: ../src/Doc/library/gc.rst:118 +#: library/gc.rst:118 msgid "" "Note that objects which have already been dereferenced, but which live in " "cycles and have not yet been collected by the garbage collector can be " @@ -44393,7 +44947,7 @@ msgid "" "call :func:`collect` before calling :func:`get_referrers`." msgstr "" -#: ../src/Doc/library/gc.rst:123 +#: library/gc.rst:123 msgid "" "Care must be taken when using objects returned by :func:`get_referrers` " "because some of them could still be under construction and hence in a " @@ -44402,7 +44956,7 @@ msgid "" msgstr "" # 5ea9e07bc67a4c2999354adbb7485c83 -#: ../src/Doc/library/gc.rst:133 +#: library/gc.rst:133 msgid "" "Return a list of objects directly referred to by any of the arguments. The " "referents returned are those objects visited by the arguments' C-level :c:" @@ -44415,7 +44969,7 @@ msgid "" msgstr "" # 52897870e26c4b51b789ce51a71f857f -#: ../src/Doc/library/gc.rst:145 +#: library/gc.rst:145 msgid "" "Returns ``True`` if the object is currently tracked by the garbage " "collector, ``False`` otherwise. As a general rule, instances of atomic " @@ -44425,14 +44979,14 @@ msgid "" "instances (e.g. dicts containing only atomic keys and values)::" msgstr "" -#: ../src/Doc/library/gc.rst:168 +#: library/gc.rst:168 msgid "" "The following variable is provided for read-only access (you can mutate its " "value but should not rebind it):" msgstr "" # ab3f03a4eb9a459dac5f6229a84a1ac1 -#: ../src/Doc/library/gc.rst:174 +#: library/gc.rst:174 msgid "" "A list of objects which the collector found to be unreachable but could not " "be freed (uncollectable objects). By default, this list contains only " @@ -44452,27 +45006,27 @@ msgid "" "being created." msgstr "" -#: ../src/Doc/library/gc.rst:190 +#: library/gc.rst:190 msgid "" "If :const:`DEBUG_SAVEALL` is set, then all unreachable objects will be added " "to this list rather than freed." msgstr "" -#: ../src/Doc/library/gc.rst:193 +#: library/gc.rst:193 msgid "The following constants are provided for use with :func:`set_debug`:" msgstr "" -#: ../src/Doc/library/gc.rst:198 +#: library/gc.rst:198 msgid "" "Print statistics during collection. This information can be useful when " "tuning the collection frequency." msgstr "" -#: ../src/Doc/library/gc.rst:204 +#: library/gc.rst:204 msgid "Print information on collectable objects found." msgstr "" -#: ../src/Doc/library/gc.rst:209 +#: library/gc.rst:209 msgid "" "Print information of uncollectable objects found (objects which are not " "reachable but cannot be freed by the collector). These objects will be " @@ -44480,27 +45034,27 @@ msgid "" msgstr "" # 50bdaeff63554f1bb689c7e4e0f18e83 -#: ../src/Doc/library/gc.rst:216 +#: library/gc.rst:216 msgid "" "When :const:`DEBUG_COLLECTABLE` or :const:`DEBUG_UNCOLLECTABLE` is set, " "print information about instance objects found." msgstr "" # 1aa482042e5744619c3675c94cdb1726 -#: ../src/Doc/library/gc.rst:222 +#: library/gc.rst:222 msgid "" "When :const:`DEBUG_COLLECTABLE` or :const:`DEBUG_UNCOLLECTABLE` is set, " "print information about objects other than instance objects found." msgstr "" -#: ../src/Doc/library/gc.rst:228 +#: library/gc.rst:228 msgid "" "When set, all unreachable objects found will be appended to *garbage* rather " "than being freed. This can be useful for debugging a leaking program." msgstr "" # b48b46cdd7e94ed3a1bc12a4257e4223 -#: ../src/Doc/library/gc.rst:234 +#: library/gc.rst:234 msgid "" "The debugging flags necessary for the collector to print information about a " "leaking program (equal to ``DEBUG_COLLECTABLE | DEBUG_UNCOLLECTABLE | " @@ -44508,19 +45062,19 @@ msgid "" msgstr "" # 3c76505f7fae411fac27316ee091ac27 -#: ../src/Doc/library/gc.rst:240 +#: library/gc.rst:240 msgid "" "Prior to Python 2.2, the list contained all instance objects in unreachable " "cycles, not only those with :meth:`__del__` methods." msgstr "" # a16c63420da04b879a1dcab564e49f41 -#: ../src/Doc/library/gdbm.rst:2 +#: library/gdbm.rst:2 msgid ":mod:`gdbm` --- GNU's reinterpretation of dbm" msgstr "" # 86ffe88dab5b4a2c99d8e5c552e98ded -#: ../src/Doc/library/gdbm.rst:9 +#: library/gdbm.rst:9 msgid "" "The :mod:`gdbm` module has been renamed to :mod:`dbm.gnu` in Python 3. The :" "term:`2to3` tool will automatically adapt imports when converting your " @@ -44528,7 +45082,7 @@ msgid "" msgstr "" # 6603f76fd2e64b818f635d9423f3aecc -#: ../src/Doc/library/gdbm.rst:16 +#: library/gdbm.rst:16 msgid "" "This module is quite similar to the :mod:`dbm` module, but uses ``gdbm`` " "instead to provide some additional functionality. Please note that the file " @@ -44536,7 +45090,7 @@ msgid "" msgstr "" # 43a78e015a56427ea279a66b345dcfa4 -#: ../src/Doc/library/gdbm.rst:20 +#: library/gdbm.rst:20 msgid "" "The :mod:`gdbm` module provides an interface to the GNU DBM library. " "``gdbm`` objects behave like mappings (dictionaries), except that keys and " @@ -44546,56 +45100,55 @@ msgid "" msgstr "" # db9f070b242049719267bad121de27b5 -#: ../src/Doc/library/gdbm.rst:25 +#: library/gdbm.rst:25 msgid "The module defines the following constant and functions:" msgstr "" # 58a1b60bd5844b71ae6fc79ad3615a6a -#: ../src/Doc/library/gdbm.rst:30 +#: library/gdbm.rst:30 msgid "" "Raised on ``gdbm``\\ -specific errors, such as I/O errors. :exc:`KeyError` " "is raised for general mapping errors like specifying an incorrect key." msgstr "" # 8571af451191481b96672b19fe4a5c74 -#: ../src/Doc/library/gdbm.rst:36 +#: library/gdbm.rst:36 msgid "" "Open a ``gdbm`` database and return a ``gdbm`` object. The *filename* " "argument is the name of the database file." msgstr "" -#: ../src/Doc/library/gdbm.rst:39 +#: library/gdbm.rst:39 msgid "The optional *flag* argument can be:" msgstr "" -#: ../src/Doc/library/gdbm.rst:57 +#: library/gdbm.rst:57 msgid "" "The following additional characters may be appended to the flag to control " "how the database is opened:" msgstr "" -#: ../src/Doc/library/gdbm.rst:63 +#: library/gdbm.rst:63 msgid "" "Open the database in fast mode. Writes to the database will not be " "synchronized." msgstr "" -#: ../src/Doc/library/gdbm.rst:66 ../src/Doc/library/stdtypes.rst:1478 -#: ../src/Doc/library/string.rst:411 +#: library/gdbm.rst:66 library/stdtypes.rst:1481 library/string.rst:411 msgid "``'s'``" msgstr "" -#: ../src/Doc/library/gdbm.rst:66 +#: library/gdbm.rst:66 msgid "" "Synchronized mode. This will cause changes to the database to be immediately " "written to the file." msgstr "" -#: ../src/Doc/library/gdbm.rst:70 +#: library/gdbm.rst:70 msgid "Do not lock database." msgstr "" -#: ../src/Doc/library/gdbm.rst:73 +#: library/gdbm.rst:73 msgid "" "Not all flags are valid for all versions of ``gdbm``. The module constant :" "const:`open_flags` is a string of supported flag characters. The exception :" @@ -44603,19 +45156,19 @@ msgid "" msgstr "" # 7cc93204963c4166809888d0457f5752 -#: ../src/Doc/library/gdbm.rst:77 +#: library/gdbm.rst:77 msgid "" "The optional *mode* argument is the Unix mode of the file, used only when " "the database has to be created. It defaults to octal ``0666``." msgstr "" -#: ../src/Doc/library/gdbm.rst:80 +#: library/gdbm.rst:80 msgid "" "In addition to the dictionary-like methods, ``gdbm`` objects have the " "following methods:" msgstr "" -#: ../src/Doc/library/gdbm.rst:86 +#: library/gdbm.rst:86 msgid "" "It's possible to loop over every key in the database using this method and " "the :meth:`nextkey` method. The traversal is ordered by ``gdbm``'s internal " @@ -44623,7 +45176,7 @@ msgid "" "starting key." msgstr "" -#: ../src/Doc/library/gdbm.rst:94 +#: library/gdbm.rst:94 msgid "" "Returns the key that follows *key* in the traversal. The following code " "prints every key in the database ``db``, without having to create a list in " @@ -44631,7 +45184,7 @@ msgid "" msgstr "" # 8ac2b4aae5fd4a56a58374885fa16ca5 -#: ../src/Doc/library/gdbm.rst:106 +#: library/gdbm.rst:106 msgid "" "If you have carried out a lot of deletions and would like to shrink the " "space used by the ``gdbm`` file, this routine will reorganize the database. " @@ -44640,24 +45193,24 @@ msgid "" "(key, value) pairs are added." msgstr "" -#: ../src/Doc/library/gdbm.rst:115 +#: library/gdbm.rst:115 msgid "" "When the database has been opened in fast mode, this method forces any " "unwritten data to be written to the disk." msgstr "" # cb3dd039e8794c91bc511aa7e513a330 -#: ../src/Doc/library/gdbm.rst:121 +#: library/gdbm.rst:121 msgid "Close the ``gdbm`` database." msgstr "" # 72bab39f5ab54fdd99064b8951e7070a -#: ../src/Doc/library/gensuitemodule.rst:3 +#: library/gensuitemodule.rst:3 msgid ":mod:`gensuitemodule` --- Generate OSA stub packages" msgstr "" # 95a7cc2640bd423f8ec2f858d0d9cccd -#: ../src/Doc/library/gensuitemodule.rst:11 +#: library/gensuitemodule.rst:11 msgid "" "The :mod:`gensuitemodule` module creates a Python package implementing stub " "code for the AppleScript suites that are implemented by a specific " @@ -44665,7 +45218,7 @@ msgid "" msgstr "" # a272c833fd7b4e0b865b28dadc0137f3 -#: ../src/Doc/library/gensuitemodule.rst:15 +#: library/gensuitemodule.rst:15 msgid "" "It is usually invoked by the user through the :program:`PythonIDE`, but it " "can also be run as a script from the command line (pass :option:`--help` for " @@ -44675,12 +45228,12 @@ msgid "" msgstr "" # aaf7674c39fd4f8b881c104cea4c9959 -#: ../src/Doc/library/gensuitemodule.rst:21 +#: library/gensuitemodule.rst:21 msgid "It defines the following public functions:" msgstr "" # ced076bf7f4146089577b2cbec7e02a2 -#: ../src/Doc/library/gensuitemodule.rst:26 +#: library/gensuitemodule.rst:26 msgid "" "Returns true if ``application``, which should be passed as a pathname, " "appears to be scriptable. Take the return value with a grain of salt: :" @@ -44688,7 +45241,7 @@ msgid "" msgstr "" # 7f4dfb4dad6c4f598860e299b35a1a98 -#: ../src/Doc/library/gensuitemodule.rst:33 +#: library/gensuitemodule.rst:33 msgid "" "Create a stub package for ``application``, which should be passed as a full " "pathname. For a :file:`.app` bundle this is the pathname to the bundle, not " @@ -44697,7 +45250,7 @@ msgid "" msgstr "" # 169a178b3ad949288acecd9ddfc4273e -#: ../src/Doc/library/gensuitemodule.rst:38 +#: library/gensuitemodule.rst:38 msgid "" "This function asks the application for its OSA terminology resources, " "decodes these resources and uses the resultant data to create the Python " @@ -44705,7 +45258,7 @@ msgid "" msgstr "" # ab11c91209e44f178fa5853826cdde96 -#: ../src/Doc/library/gensuitemodule.rst:42 +#: library/gensuitemodule.rst:42 msgid "" "``output`` is the pathname where the resulting package is stored, if not " "specified a standard \"save file as\" dialog is presented to the user. " @@ -44723,7 +45276,7 @@ msgid "" msgstr "" # 1801f4551b554718b1568edabee37866 -#: ../src/Doc/library/gensuitemodule.rst:58 +#: library/gensuitemodule.rst:58 msgid "" "This function does the same as ``processfile``, except that it uses a " "different method to get the terminology resources. It opens ``application`` " @@ -44731,17 +45284,17 @@ msgid "" "from this file." msgstr "" -#: ../src/Doc/library/getopt.rst:2 +#: library/getopt.rst:2 msgid ":mod:`getopt` --- C-style parser for command line options" msgstr "" # f010d1ecc5544952b8ee1dd8b7bad140 -#: ../src/Doc/library/getopt.rst:8 +#: library/getopt.rst:8 msgid "**Source code:** :source:`Lib/getopt.py`" msgstr "" # 94fef3cfc9534489a1dcb9482e4a7a9a -#: ../src/Doc/library/getopt.rst:14 +#: library/getopt.rst:14 msgid "" "The :mod:`getopt` module is a parser for command line options whose API is " "designed to be familiar to users of the C :c:func:`getopt` function. Users " @@ -44751,7 +45304,7 @@ msgid "" msgstr "" # ed30e4c2fa37409a96de1376dd8e7b85 -#: ../src/Doc/library/getopt.rst:20 +#: library/getopt.rst:20 msgid "" "This module helps scripts to parse the command line arguments in ``sys." "argv``. It supports the same conventions as the Unix :c:func:`getopt` " @@ -44760,12 +45313,12 @@ msgid "" "be used as well via an optional third argument." msgstr "" -#: ../src/Doc/library/getopt.rst:26 +#: library/getopt.rst:26 msgid "This module provides two functions and an exception:" msgstr "" # caca561fc5dd4ec483cbe7083545325b -#: ../src/Doc/library/getopt.rst:32 +#: library/getopt.rst:32 msgid "" "Parses command line options and parameter list. *args* is the argument list " "to be parsed, without the leading reference to the running program. " @@ -44776,7 +45329,7 @@ msgid "" msgstr "" # 191cfa0cc8814009aedc8eaffbabf6c8 -#: ../src/Doc/library/getopt.rst:40 +#: library/getopt.rst:40 msgid "" "Unlike GNU :c:func:`getopt`, after a non-option argument, all further " "arguments are considered also non-options. This is similar to the way non-" @@ -44784,7 +45337,7 @@ msgid "" msgstr "" # 9d0eab4b12d34e84b77275285bb2a06b -#: ../src/Doc/library/getopt.rst:44 +#: library/getopt.rst:44 msgid "" "*long_options*, if specified, must be a list of strings with the names of " "the long options which should be supported. The leading ``'--'`` characters " @@ -44798,7 +45351,7 @@ msgid "" "uniquely, so :exc:`GetoptError` will be raised." msgstr "" -#: ../src/Doc/library/getopt.rst:55 +#: library/getopt.rst:55 msgid "" "The return value consists of two elements: the first is a list of ``(option, " "value)`` pairs; the second is the list of program arguments left after the " @@ -44811,7 +45364,7 @@ msgid "" "occurrences. Long and short options may be mixed." msgstr "" -#: ../src/Doc/library/getopt.rst:68 +#: library/getopt.rst:68 msgid "" "This function works like :func:`getopt`, except that GNU style scanning mode " "is used by default. This means that option and non-option arguments may be " @@ -44820,14 +45373,14 @@ msgid "" msgstr "" # 66de76e09aa34bf1b16de6dee9b189c8 -#: ../src/Doc/library/getopt.rst:73 +#: library/getopt.rst:73 msgid "" "If the first character of the option string is ``'+'``, or if the " "environment variable :envvar:`POSIXLY_CORRECT` is set, then option " "processing stops as soon as a non-option argument is encountered." msgstr "" -#: ../src/Doc/library/getopt.rst:82 +#: library/getopt.rst:82 msgid "" "This is raised when an unrecognized option is found in the argument list or " "when an option requiring an argument is given none. The argument to the " @@ -44838,48 +45391,52 @@ msgid "" "which the exception relates, :attr:`opt` is an empty string." msgstr "" -#: ../src/Doc/library/getopt.rst:96 +#: library/getopt.rst:90 +msgid "Introduced :exc:`GetoptError` as a synonym for :exc:`error`." +msgstr "" + +#: library/getopt.rst:96 msgid "Alias for :exc:`GetoptError`; for backward compatibility." msgstr "" -#: ../src/Doc/library/getopt.rst:98 +#: library/getopt.rst:98 msgid "An example using only Unix style options:" msgstr "" -#: ../src/Doc/library/getopt.rst:110 +#: library/getopt.rst:110 msgid "Using long option names is equally easy:" msgstr "" -#: ../src/Doc/library/getopt.rst:123 +#: library/getopt.rst:123 msgid "In a script, typical usage is something like this::" msgstr "" -#: ../src/Doc/library/getopt.rst:152 +#: library/getopt.rst:152 msgid "" "Note that an equivalent command line interface could be produced with less " "code and more informative help and error messages by using the :mod:" "`argparse` module::" msgstr "" -# 1df418c0d3744460b3cad00dba6eb3ee -#: ../src/Doc/library/getopt.rst:166 -msgid "Module :mod:`argparse`" -msgstr "" +#: library/getopt.rst:167 +#, fuzzy +msgid "Module argparse" +msgstr "Modules" -#: ../src/Doc/library/getopt.rst:168 +#: library/getopt.rst:168 msgid "Alternative command line option and argument parsing library." msgstr "" -#: ../src/Doc/library/getpass.rst:2 +#: library/getpass.rst:2 msgid ":mod:`getpass` --- Portable password input" msgstr "" -#: ../src/Doc/library/getpass.rst:10 +#: library/getpass.rst:10 msgid "The :mod:`getpass` module provides two functions:" msgstr "" # e6ffdcf6ebdb4d7696f5facf2d23b1f8 -#: ../src/Doc/library/getpass.rst:15 +#: library/getpass.rst:15 msgid "" "Prompt the user for a password without echoing. The user is prompted using " "the string *prompt*, which defaults to ``'Password: '``. On Unix, the prompt " @@ -44888,32 +45445,42 @@ msgid "" "(this argument is ignored on Windows)." msgstr "" -#: ../src/Doc/library/getpass.rst:21 +#: library/getpass.rst:21 msgid "" "If echo free input is unavailable getpass() falls back to printing a warning " "message to *stream* and reading from ``sys.stdin`` and issuing a :exc:" "`GetPassWarning`." msgstr "" -#: ../src/Doc/library/getpass.rst:25 +#: library/getpass.rst:25 msgid "Availability: Macintosh, Unix, Windows." msgstr "" -#: ../src/Doc/library/getpass.rst:33 +#: library/getpass.rst:27 +msgid "The *stream* parameter was added." +msgstr "" + +#: library/getpass.rst:29 +msgid "" +"On Unix it defaults to using /dev/tty before falling back to ``sys.stdin`` " +"and ``sys.stderr``." +msgstr "" + +#: library/getpass.rst:33 msgid "" "If you call getpass from within IDLE, the input may be done in the terminal " "you launched IDLE from rather than the idle window itself." msgstr "" -#: ../src/Doc/library/getpass.rst:39 +#: library/getpass.rst:39 msgid "A :exc:`UserWarning` subclass issued when password input may be echoed." msgstr "" -#: ../src/Doc/library/getpass.rst:44 +#: library/getpass.rst:44 msgid "Return the \"login name\" of the user. Availability: Unix, Windows." msgstr "" -#: ../src/Doc/library/getpass.rst:46 +#: library/getpass.rst:46 msgid "" "This function checks the environment variables :envvar:`LOGNAME`, :envvar:" "`USER`, :envvar:`LNAME` and :envvar:`USERNAME`, in order, and returns the " @@ -44922,16 +45489,16 @@ msgid "" "support the :mod:`pwd` module, otherwise, an exception is raised." msgstr "" -#: ../src/Doc/library/gettext.rst:2 +#: library/gettext.rst:2 msgid ":mod:`gettext` --- Multilingual internationalization services" msgstr "" # 1a74291bcbfd47959d0b354b61655540 -#: ../src/Doc/library/gettext.rst:9 +#: library/gettext.rst:9 msgid "**Source code:** :source:`Lib/gettext.py`" msgstr "" -#: ../src/Doc/library/gettext.rst:13 +#: library/gettext.rst:13 msgid "" "The :mod:`gettext` module provides internationalization (I18N) and " "localization (L10N) services for your Python modules and applications. It " @@ -44942,16 +45509,16 @@ msgid "" "messages for running under different natural languages." msgstr "" -#: ../src/Doc/library/gettext.rst:21 +#: library/gettext.rst:21 msgid "" "Some hints on localizing your Python modules and applications are also given." msgstr "" -#: ../src/Doc/library/gettext.rst:25 +#: library/gettext.rst:25 msgid "GNU :program:`gettext` API" msgstr "" -#: ../src/Doc/library/gettext.rst:27 +#: library/gettext.rst:27 msgid "" "The :mod:`gettext` module defines the following API, which is very similar " "to the GNU :program:`gettext` API. If you use this API you will affect the " @@ -44962,7 +45529,7 @@ msgid "" "probably want to use the class-based API instead." msgstr "" -#: ../src/Doc/library/gettext.rst:38 +#: library/gettext.rst:38 msgid "" "Bind the *domain* to the locale directory *localedir*. More concretely, :" "mod:`gettext` will look for binary :file:`.mo` files for the given domain " @@ -44972,53 +45539,53 @@ msgid "" "respectively." msgstr "" -#: ../src/Doc/library/gettext.rst:44 +#: library/gettext.rst:44 msgid "" "If *localedir* is omitted or ``None``, then the current binding for *domain* " "is returned. [#]_" msgstr "" -#: ../src/Doc/library/gettext.rst:50 +#: library/gettext.rst:50 msgid "" "Bind the *domain* to *codeset*, changing the encoding of strings returned by " "the :func:`gettext` family of functions. If *codeset* is omitted, then the " "current binding is returned." msgstr "" -#: ../src/Doc/library/gettext.rst:59 +#: library/gettext.rst:59 msgid "" "Change or query the current global domain. If *domain* is ``None``, then " "the current global domain is returned, otherwise the global domain is set to " "*domain*, which is returned." msgstr "" -#: ../src/Doc/library/gettext.rst:66 +#: library/gettext.rst:66 msgid "" "Return the localized translation of *message*, based on the current global " "domain, language, and locale directory. This function is usually aliased " "as :func:`_` in the local namespace (see examples below)." msgstr "" -#: ../src/Doc/library/gettext.rst:73 +#: library/gettext.rst:73 msgid "" "Equivalent to :func:`gettext`, but the translation is returned in the " "preferred system encoding, if no other encoding was explicitly set with :" "func:`bind_textdomain_codeset`." msgstr "" -#: ../src/Doc/library/gettext.rst:82 +#: library/gettext.rst:82 msgid "" "Like :func:`gettext`, but look the message up in the specified *domain*." msgstr "" -#: ../src/Doc/library/gettext.rst:87 +#: library/gettext.rst:87 msgid "" "Equivalent to :func:`dgettext`, but the translation is returned in the " "preferred system encoding, if no other encoding was explicitly set with :" "func:`bind_textdomain_codeset`." msgstr "" -#: ../src/Doc/library/gettext.rst:96 +#: library/gettext.rst:96 msgid "" "Like :func:`gettext`, but consider plural forms. If a translation is found, " "apply the plural formula to *n*, and return the resulting message (some " @@ -45026,7 +45593,7 @@ msgid "" "return *singular* if *n* is 1; return *plural* otherwise." msgstr "" -#: ../src/Doc/library/gettext.rst:101 +#: library/gettext.rst:101 msgid "" "The Plural formula is taken from the catalog header. It is a C or Python " "expression that has a free variable *n*; the expression evaluates to the " @@ -45035,41 +45602,41 @@ msgid "" "variety of languages." msgstr "" -#: ../src/Doc/library/gettext.rst:112 +#: library/gettext.rst:112 msgid "" "Equivalent to :func:`ngettext`, but the translation is returned in the " "preferred system encoding, if no other encoding was explicitly set with :" "func:`bind_textdomain_codeset`." msgstr "" -#: ../src/Doc/library/gettext.rst:121 +#: library/gettext.rst:121 msgid "" "Like :func:`ngettext`, but look the message up in the specified *domain*." msgstr "" -#: ../src/Doc/library/gettext.rst:128 +#: library/gettext.rst:128 msgid "" "Equivalent to :func:`dngettext`, but the translation is returned in the " "preferred system encoding, if no other encoding was explicitly set with :" "func:`bind_textdomain_codeset`." msgstr "" -#: ../src/Doc/library/gettext.rst:134 +#: library/gettext.rst:134 msgid "" "Note that GNU :program:`gettext` also defines a :func:`dcgettext` method, " "but this was deemed not useful and so it is currently unimplemented." msgstr "" -#: ../src/Doc/library/gettext.rst:137 +#: library/gettext.rst:137 msgid "Here's an example of typical usage for this API::" msgstr "" -#: ../src/Doc/library/gettext.rst:148 +#: library/gettext.rst:148 msgid "Class-based API" msgstr "" # 067d296ff636490aa1d4fdb3dc697d9a -#: ../src/Doc/library/gettext.rst:150 +#: library/gettext.rst:150 msgid "" "The class-based API of the :mod:`gettext` module gives you more flexibility " "and greater convenience than the GNU :program:`gettext` API. It is the " @@ -45081,7 +45648,7 @@ msgid "" "`_`." msgstr "" -#: ../src/Doc/library/gettext.rst:161 +#: library/gettext.rst:161 msgid "" "This function implements the standard :file:`.mo` file search algorithm. It " "takes a *domain*, identical to what :func:`textdomain` takes. Optional " @@ -45089,7 +45656,7 @@ msgid "" "of strings, where each string is a language code." msgstr "" -#: ../src/Doc/library/gettext.rst:166 +#: library/gettext.rst:166 msgid "" "If *localedir* is not given, then the default system locale directory is " "used. [#]_ If *languages* is not given, then the following environment " @@ -45100,18 +45667,18 @@ msgid "" "colon to produce the expected list of language code strings." msgstr "" -#: ../src/Doc/library/gettext.rst:174 +#: library/gettext.rst:174 msgid "" ":func:`find` then expands and normalizes the languages, and then iterates " "through them, searching for an existing file built of these components:" msgstr "" # 3794d41a11574912856319b8ea148daa -#: ../src/Doc/library/gettext.rst:177 +#: library/gettext.rst:177 msgid ":file:`localedir/language/LC_MESSAGES/domain.mo`" msgstr "" -#: ../src/Doc/library/gettext.rst:179 +#: library/gettext.rst:179 msgid "" "The first such file name that exists is returned by :func:`find`. If no such " "file is found, then ``None`` is returned. If *all* is given, it returns a " @@ -45120,7 +45687,7 @@ msgid "" msgstr "" # 81e54481e1454a948e642c2bbcb0f099 -#: ../src/Doc/library/gettext.rst:187 +#: library/gettext.rst:187 msgid "" "Return a :class:`Translations` instance based on the *domain*, *localedir*, " "and *languages*, which are first passed to :func:`find` to get a list of the " @@ -45131,7 +45698,7 @@ msgid "" "charset used to encode translated strings." msgstr "" -#: ../src/Doc/library/gettext.rst:195 +#: library/gettext.rst:195 msgid "" "If multiple files are found, later files are used as fallbacks for earlier " "ones. To allow setting the fallback, :func:`copy.copy` is used to clone each " @@ -45139,15 +45706,19 @@ msgid "" "with the cache." msgstr "" -#: ../src/Doc/library/gettext.rst:200 +#: library/gettext.rst:200 msgid "" "If no :file:`.mo` file is found, this function raises :exc:`IOError` if " "*fallback* is false (which is the default), and returns a :class:" "`NullTranslations` instance if *fallback* is true." msgstr "" +#: library/gettext.rst:204 library/gettext.rst:228 +msgid "Added the *codeset* parameter." +msgstr "" + # 81857e2ec0f145c0a2f1ccaf93bcade3 -#: ../src/Doc/library/gettext.rst:210 +#: library/gettext.rst:210 msgid "" "This installs the function :func:`_` in Python's builtins namespace, based " "on *domain*, *localedir*, and *codeset* which are passed to the function :" @@ -45155,31 +45726,35 @@ msgid "" "translation object's :meth:`~NullTranslations.install` method." msgstr "" -#: ../src/Doc/library/gettext.rst:215 +#: library/gettext.rst:215 msgid "" "For the *names* parameter, please see the description of the translation " "object's :meth:`~NullTranslations.install` method." msgstr "" -#: ../src/Doc/library/gettext.rst:218 +#: library/gettext.rst:218 msgid "" "As seen below, you usually mark the strings in your application that are " "candidates for translation, by wrapping them in a call to the :func:`_` " "function, like this::" msgstr "" -#: ../src/Doc/library/gettext.rst:224 +#: library/gettext.rst:224 msgid "" "For convenience, you want the :func:`_` function to be installed in Python's " "builtins namespace, so it is easily accessible in all modules of your " "application." msgstr "" -#: ../src/Doc/library/gettext.rst:236 +#: library/gettext.rst:231 library/gettext.rst:372 +msgid "Added the *names* parameter." +msgstr "" + +#: library/gettext.rst:236 msgid "The :class:`NullTranslations` class" msgstr "" -#: ../src/Doc/library/gettext.rst:238 +#: library/gettext.rst:238 msgid "" "Translation classes are what actually implement the translation of original " "source file message strings to translated message strings. The base class " @@ -45188,7 +45763,7 @@ msgid "" "classes. Here are the methods of :class:`NullTranslations`:" msgstr "" -#: ../src/Doc/library/gettext.rst:247 +#: library/gettext.rst:247 msgid "" "Takes an optional file object *fp*, which is ignored by the base class. " "Initializes \"protected\" instance variables *_info* and *_charset* which " @@ -45197,7 +45772,7 @@ msgid "" "``None``." msgstr "" -#: ../src/Doc/library/gettext.rst:256 +#: library/gettext.rst:256 msgid "" "No-op'd in the base class, this method takes file object *fp*, and reads the " "data from the file, initializing its message catalog. If you have an " @@ -45205,78 +45780,78 @@ msgid "" "parse your format." msgstr "" -#: ../src/Doc/library/gettext.rst:264 +#: library/gettext.rst:264 msgid "" "Add *fallback* as the fallback object for the current translation object. A " "translation object should consult the fallback if it cannot provide a " "translation for a given message." msgstr "" -#: ../src/Doc/library/gettext.rst:271 +#: library/gettext.rst:271 msgid "" "If a fallback has been set, forward :meth:`gettext` to the fallback. " "Otherwise, return the translated message. Overridden in derived classes." msgstr "" -#: ../src/Doc/library/gettext.rst:278 +#: library/gettext.rst:278 msgid "" "If a fallback has been set, forward :meth:`lgettext` to the fallback. " "Otherwise, return the translated message. Overridden in derived classes." msgstr "" # 944034bc76d94b429696a59f89d63f79 -#: ../src/Doc/library/gettext.rst:287 +#: library/gettext.rst:287 msgid "" "If a fallback has been set, forward :meth:`ugettext` to the fallback. " "Otherwise, return the translated message as a Unicode string. Overridden in " "derived classes." msgstr "" -#: ../src/Doc/library/gettext.rst:294 +#: library/gettext.rst:294 msgid "" "If a fallback has been set, forward :meth:`ngettext` to the fallback. " "Otherwise, return the translated message. Overridden in derived classes." msgstr "" # 9502965e5ed2433591565bb8d32d70ef -#: ../src/Doc/library/gettext.rst:303 +#: library/gettext.rst:303 msgid "" "If a fallback has been set, forward :meth:`lngettext` to the fallback. " "Otherwise, return the translated message. Overridden in derived classes." msgstr "" # 4bd5263b563f435cbc0127e8a16882d8 -#: ../src/Doc/library/gettext.rst:312 +#: library/gettext.rst:312 msgid "" "If a fallback has been set, forward :meth:`ungettext` to the fallback. " "Otherwise, return the translated message as a Unicode string. Overridden in " "derived classes." msgstr "" -#: ../src/Doc/library/gettext.rst:321 +#: library/gettext.rst:321 msgid "Return the \"protected\" :attr:`_info` variable." msgstr "" # fe45bf1521de4055b1b3c58e435e48c6 -#: ../src/Doc/library/gettext.rst:326 +#: library/gettext.rst:326 msgid "Return the \"protected\" :attr:`_charset` variable." msgstr "" # 64ee026cc7c5478e8ccf87987a1a42c8 -#: ../src/Doc/library/gettext.rst:331 +#: library/gettext.rst:331 msgid "" "Return the \"protected\" :attr:`_output_charset` variable, which defines the " "encoding used to return translated messages." msgstr "" -#: ../src/Doc/library/gettext.rst:339 +#: library/gettext.rst:339 msgid "" "Change the \"protected\" :attr:`_output_charset` variable, which defines the " "encoding used to return translated messages." msgstr "" # 46a7d79c4e8f46698434e6c43698f838 -#: ../src/Doc/library/gettext.rst:347 +#: library/gettext.rst:347 msgid "" "If the *unicode* flag is false, this method installs :meth:`self.gettext` " "into the built-in namespace, binding it to ``_``. If *unicode* is true, it " @@ -45284,7 +45859,7 @@ msgid "" msgstr "" # cb580e14b79b49d48b8e629f8c72c89a -#: ../src/Doc/library/gettext.rst:351 +#: library/gettext.rst:351 msgid "" "If the *names* parameter is given, it must be a sequence containing the " "names of functions you want to install in the builtins namespace in addition " @@ -45294,7 +45869,7 @@ msgid "" "according to the *unicode* flag), ``'lgettext'`` and ``'lngettext'``." msgstr "" -#: ../src/Doc/library/gettext.rst:359 +#: library/gettext.rst:359 msgid "" "Note that this is only one way, albeit the most convenient way, to make the :" "func:`_` function available to your application. Because it affects the " @@ -45303,18 +45878,18 @@ msgid "" "this code to make :func:`_` available to their module::" msgstr "" -#: ../src/Doc/library/gettext.rst:369 +#: library/gettext.rst:369 msgid "" "This puts :func:`_` only in the module's global namespace and so only " "affects calls within this module." msgstr "" -#: ../src/Doc/library/gettext.rst:377 +#: library/gettext.rst:377 msgid "The :class:`GNUTranslations` class" msgstr "" # 58e97327b3974ba985a118b83c7c2213 -#: ../src/Doc/library/gettext.rst:379 +#: library/gettext.rst:379 msgid "" "The :mod:`gettext` module provides one additional class derived from :class:" "`NullTranslations`: :class:`GNUTranslations`. This class overrides :meth:" @@ -45324,7 +45899,7 @@ msgid "" msgstr "" # a5862e1a5ffc4f108bf9a64226f58243 -#: ../src/Doc/library/gettext.rst:385 +#: library/gettext.rst:385 msgid "" ":class:`GNUTranslations` parses optional meta-data out of the translation " "catalog. It is convention with GNU :program:`gettext` to include meta-data " @@ -45342,26 +45917,26 @@ msgid "" "are the recommended interface to use for internationalized Python programs." msgstr "" -#: ../src/Doc/library/gettext.rst:400 +#: library/gettext.rst:400 msgid "" "The entire set of key/value pairs are placed into a dictionary and set as " "the \"protected\" :attr:`_info` instance variable." msgstr "" -#: ../src/Doc/library/gettext.rst:403 +#: library/gettext.rst:403 msgid "" "If the :file:`.mo` file's magic number is invalid, or if other problems " "occur while reading the file, instantiating a :class:`GNUTranslations` class " "can raise :exc:`IOError`." msgstr "" -#: ../src/Doc/library/gettext.rst:407 +#: library/gettext.rst:407 msgid "" "The following methods are overridden from the base class implementation:" msgstr "" # e079a21592ef47d289945545f7652dec -#: ../src/Doc/library/gettext.rst:412 +#: library/gettext.rst:412 msgid "" "Look up the *message* id in the catalog and return the corresponding message " "string, as an 8-bit string encoded with the catalog's charset encoding, if " @@ -45372,7 +45947,7 @@ msgstr "" # 29868c5bb2774ae886904dd166a08983 # 670f9e42cd104059b26184c4a88f44a7 -#: ../src/Doc/library/gettext.rst:421 ../src/Doc/library/gettext.rst:452 +#: library/gettext.rst:421 library/gettext.rst:452 msgid "" "Equivalent to :meth:`gettext`, but the translation is returned in the " "preferred system encoding, if no other encoding was explicitly set with :" @@ -45380,7 +45955,7 @@ msgid "" msgstr "" # 8c860f8f619046ea903927ab3f78107a -#: ../src/Doc/library/gettext.rst:430 +#: library/gettext.rst:430 msgid "" "Look up the *message* id in the catalog and return the corresponding message " "string, as a Unicode string. If there is no entry in the catalog for the " @@ -45389,7 +45964,7 @@ msgid "" msgstr "" # 91151cbceacd478993c193fc32037b56 -#: ../src/Doc/library/gettext.rst:438 +#: library/gettext.rst:438 msgid "" "Do a plural-forms lookup of a message id. *singular* is used as the message " "id for purposes of lookup in the catalog, while *n* is used to determine " @@ -45397,7 +45972,7 @@ msgid "" "encoded with the catalog's charset encoding, if known." msgstr "" -#: ../src/Doc/library/gettext.rst:443 +#: library/gettext.rst:443 msgid "" "If the message id is not found in the catalog, and a fallback is specified, " "the request is forwarded to the fallback's :meth:`ngettext` method. " @@ -45405,7 +45980,7 @@ msgid "" "all other cases." msgstr "" -#: ../src/Doc/library/gettext.rst:461 +#: library/gettext.rst:461 msgid "" "Do a plural-forms lookup of a message id. *singular* is used as the message " "id for purposes of lookup in the catalog, while *n* is used to determine " @@ -45413,7 +45988,7 @@ msgid "" msgstr "" # 1f094846ba564cb1aa1c83be4beb7f86 -#: ../src/Doc/library/gettext.rst:465 +#: library/gettext.rst:465 msgid "" "If the message id is not found in the catalog, and a fallback is specified, " "the request is forwarded to the fallback's :meth:`ungettext` method. " @@ -45421,49 +45996,49 @@ msgid "" "all other cases." msgstr "" -#: ../src/Doc/library/gettext.rst:470 +#: library/gettext.rst:470 msgid "Here is an example::" msgstr "" -#: ../src/Doc/library/gettext.rst:483 +#: library/gettext.rst:483 msgid "Solaris message catalog support" msgstr "" -#: ../src/Doc/library/gettext.rst:485 +#: library/gettext.rst:485 msgid "" "The Solaris operating system defines its own binary :file:`.mo` file format, " "but since no documentation can be found on this format, it is not supported " "at this time." msgstr "" -#: ../src/Doc/library/gettext.rst:491 +#: library/gettext.rst:491 msgid "The Catalog constructor" msgstr "" -#: ../src/Doc/library/gettext.rst:495 +#: library/gettext.rst:495 msgid "" "GNOME uses a version of the :mod:`gettext` module by James Henstridge, but " "this version has a slightly different API. Its documented usage was::" msgstr "" -#: ../src/Doc/library/gettext.rst:503 +#: library/gettext.rst:503 msgid "" "For compatibility with this older module, the function :func:`Catalog` is an " "alias for the :func:`translation` function described above." msgstr "" -#: ../src/Doc/library/gettext.rst:506 +#: library/gettext.rst:506 msgid "" "One difference between this module and Henstridge's: his catalog objects " "supported access through a mapping API, but this appears to be unused and so " "is not currently supported." msgstr "" -#: ../src/Doc/library/gettext.rst:512 +#: library/gettext.rst:512 msgid "Internationalizing your programs and modules" msgstr "" -#: ../src/Doc/library/gettext.rst:514 +#: library/gettext.rst:514 msgid "" "Internationalization (I18N) refers to the operation by which a program is " "made aware of multiple languages. Localization (L10N) refers to the " @@ -45472,26 +46047,26 @@ msgid "" "Python programs, you need to take the following steps:" msgstr "" -#: ../src/Doc/library/gettext.rst:520 +#: library/gettext.rst:520 msgid "" "prepare your program or module by specially marking translatable strings" msgstr "" -#: ../src/Doc/library/gettext.rst:522 +#: library/gettext.rst:522 msgid "" "run a suite of tools over your marked files to generate raw messages catalogs" msgstr "" -#: ../src/Doc/library/gettext.rst:524 +#: library/gettext.rst:524 msgid "create language specific translations of the message catalogs" msgstr "" -#: ../src/Doc/library/gettext.rst:526 +#: library/gettext.rst:526 msgid "" "use the :mod:`gettext` module so that message strings are properly translated" msgstr "" -#: ../src/Doc/library/gettext.rst:528 +#: library/gettext.rst:528 msgid "" "In order to prepare your code for I18N, you need to look at all the strings " "in your files. Any string that needs to be translated should be marked by " @@ -45499,14 +46074,14 @@ msgid "" "For example::" msgstr "" -#: ../src/Doc/library/gettext.rst:538 +#: library/gettext.rst:538 msgid "" "In this example, the string ``'writing a log message'`` is marked as a " "candidate for translation, while the strings ``'mylog.txt'`` and ``'w'`` are " "not." msgstr "" -#: ../src/Doc/library/gettext.rst:541 +#: library/gettext.rst:541 msgid "" "The Python distribution comes with two tools which help you generate the " "message catalogs once you've prepared your source code. These may or may " @@ -45514,7 +46089,7 @@ msgid "" "source distribution, in the :file:`Tools/i18n` directory." msgstr "" -#: ../src/Doc/library/gettext.rst:546 +#: library/gettext.rst:546 msgid "" "The :program:`pygettext` [#]_ program scans all your Python source code " "looking for the strings you previously marked as translatable. It is " @@ -45524,7 +46099,7 @@ msgid "" "translating C code (such as C extension modules)." msgstr "" -#: ../src/Doc/library/gettext.rst:553 +#: library/gettext.rst:553 msgid "" ":program:`pygettext` generates textual Uniforum-style human readable message " "catalog :file:`.pot` files, essentially structured human readable files " @@ -45534,7 +46109,7 @@ msgid "" "`xgettext`; for details on its use, run::" msgstr "" -#: ../src/Doc/library/gettext.rst:562 +#: library/gettext.rst:562 msgid "" "Copies of these :file:`.pot` files are then handed over to the individual " "human translators who write language-specific versions for every supported " @@ -45546,25 +46121,25 @@ msgid "" "for the actual translation processing during run-time." msgstr "" -#: ../src/Doc/library/gettext.rst:571 +#: library/gettext.rst:571 msgid "" "How you use the :mod:`gettext` module in your code depends on whether you " "are internationalizing a single module or your entire application. The next " "two sections will discuss each case." msgstr "" -#: ../src/Doc/library/gettext.rst:577 +#: library/gettext.rst:577 msgid "Localizing your module" msgstr "" -#: ../src/Doc/library/gettext.rst:579 +#: library/gettext.rst:579 msgid "" "If you are localizing your module, you must take care not to make global " "changes, e.g. to the built-in namespace. You should not use the GNU " "``gettext`` API but instead the class-based API." msgstr "" -#: ../src/Doc/library/gettext.rst:583 +#: library/gettext.rst:583 msgid "" "Let's say your module is called \"spam\" and the module's various natural " "language translation :file:`.mo` files reside in :file:`/usr/share/locale` " @@ -45573,17 +46148,17 @@ msgid "" msgstr "" # f0aa8f94418b4b2e9f9b5291e0c90955 -#: ../src/Doc/library/gettext.rst:592 +#: library/gettext.rst:592 msgid "" "If your translators were providing you with Unicode strings in their :file:`." "po` files, you'd instead do::" msgstr "" -#: ../src/Doc/library/gettext.rst:601 +#: library/gettext.rst:601 msgid "Localizing your application" msgstr "" -#: ../src/Doc/library/gettext.rst:603 +#: library/gettext.rst:603 msgid "" "If you are localizing your application, you can install the :func:`_` " "function globally into the built-in namespace, usually in the main driver " @@ -45591,53 +46166,53 @@ msgid "" "just use ``_('...')`` without having to explicitly install it in each file." msgstr "" -#: ../src/Doc/library/gettext.rst:608 +#: library/gettext.rst:608 msgid "" "In the simple case then, you need only add the following bit of code to the " "main driver file of your application::" msgstr "" # ec07fa938c394dbb92d6ba20591b7fbd -#: ../src/Doc/library/gettext.rst:614 +#: library/gettext.rst:614 msgid "" "If you need to set the locale directory or the *unicode* flag, you can pass " "these into the :func:`install` function::" msgstr "" -#: ../src/Doc/library/gettext.rst:622 +#: library/gettext.rst:622 msgid "Changing languages on the fly" msgstr "" -#: ../src/Doc/library/gettext.rst:624 +#: library/gettext.rst:624 msgid "" "If your program needs to support many languages at the same time, you may " "want to create multiple translation instances and then switch between them " "explicitly, like so::" msgstr "" -#: ../src/Doc/library/gettext.rst:645 +#: library/gettext.rst:645 msgid "Deferred translations" msgstr "" -#: ../src/Doc/library/gettext.rst:647 +#: library/gettext.rst:647 msgid "" "In most coding situations, strings are translated where they are coded. " "Occasionally however, you need to mark strings for translation, but defer " "actual translation until later. A classic example is::" msgstr "" -#: ../src/Doc/library/gettext.rst:660 +#: library/gettext.rst:660 msgid "" "Here, you want to mark the strings in the ``animals`` list as being " "translatable, but you don't actually want to translate them until they are " "printed." msgstr "" -#: ../src/Doc/library/gettext.rst:664 +#: library/gettext.rst:664 msgid "Here is one way you can handle this situation::" msgstr "" -#: ../src/Doc/library/gettext.rst:680 +#: library/gettext.rst:680 msgid "" "This works because the dummy definition of :func:`_` simply returns the " "string unchanged. And this dummy definition will temporarily override any " @@ -45646,17 +46221,17 @@ msgid "" "in the local namespace." msgstr "" -#: ../src/Doc/library/gettext.rst:686 +#: library/gettext.rst:686 msgid "" "Note that the second use of :func:`_` will not identify \"a\" as being " "translatable to the :program:`pygettext` program, since it is not a string." msgstr "" -#: ../src/Doc/library/gettext.rst:689 +#: library/gettext.rst:689 msgid "Another way to handle this is with the following example::" msgstr "" -#: ../src/Doc/library/gettext.rst:703 +#: library/gettext.rst:703 msgid "" "In this case, you are marking translatable strings with the function :func:" "`N_`, [#]_ which won't conflict with any definition of :func:`_`. However, " @@ -45666,12 +46241,12 @@ msgid "" msgstr "" # 669fcbefdb3446cb82aeee1fe0afa300 -#: ../src/Doc/library/gettext.rst:711 +#: library/gettext.rst:711 msgid ":func:`gettext` vs. :func:`lgettext`" msgstr "" # abd26c9c342d4aceb0ef41133f488d50 -#: ../src/Doc/library/gettext.rst:713 +#: library/gettext.rst:713 msgid "" "In Python 2.4 the :func:`lgettext` family of functions were introduced. The " "intention of these functions is to provide an alternative which is more " @@ -45685,50 +46260,50 @@ msgid "" "requested codeset, as would be expected in the GNU gettext implementation." msgstr "" -#: ../src/Doc/library/gettext.rst:726 +#: library/gettext.rst:726 msgid "Acknowledgements" msgstr "" -#: ../src/Doc/library/gettext.rst:728 +#: library/gettext.rst:728 msgid "" "The following people contributed code, feedback, design suggestions, " "previous implementations, and valuable experience to the creation of this " "module:" msgstr "" -#: ../src/Doc/library/gettext.rst:731 +#: library/gettext.rst:731 msgid "Peter Funk" msgstr "Peter Funk" -#: ../src/Doc/library/gettext.rst:733 +#: library/gettext.rst:733 msgid "James Henstridge" msgstr "" -#: ../src/Doc/library/gettext.rst:735 +#: library/gettext.rst:735 msgid "Juan David Ibáñez Palomar" msgstr "" -#: ../src/Doc/library/gettext.rst:737 +#: library/gettext.rst:737 msgid "Marc-André Lemburg" msgstr "Marc-André Lemburg" -#: ../src/Doc/library/gettext.rst:739 +#: library/gettext.rst:739 msgid "Martin von Löwis" msgstr "Martin von Löwis" -#: ../src/Doc/library/gettext.rst:741 +#: library/gettext.rst:741 msgid "François Pinard" msgstr "François Pinard" -#: ../src/Doc/library/gettext.rst:743 +#: library/gettext.rst:743 msgid "Barry Warsaw" msgstr "Barry Warsaw" -#: ../src/Doc/library/gettext.rst:745 +#: library/gettext.rst:745 msgid "Gustavo Niemeyer" msgstr "" -#: ../src/Doc/library/gettext.rst:749 +#: library/gettext.rst:749 msgid "" "The default locale directory is system dependent; for example, on RedHat " "Linux it is :file:`/usr/share/locale`, but on Solaris it is :file:`/usr/lib/" @@ -45738,19 +46313,19 @@ msgid "" "explicit absolute path at the start of your application." msgstr "" -#: ../src/Doc/library/gettext.rst:756 +#: library/gettext.rst:756 msgid "See the footnote for :func:`bindtextdomain` above." msgstr "" # 3389486f27184398940fed7bd9e9975f -#: ../src/Doc/library/gettext.rst:758 +#: library/gettext.rst:758 msgid "" "François Pinard has written a program called :program:`xpot` which does a " "similar job. It is available as part of his `po-utils package `__." msgstr "" -#: ../src/Doc/library/gettext.rst:762 +#: library/gettext.rst:762 msgid "" ":program:`msgfmt.py` is binary compatible with GNU :program:`msgfmt` except " "that it provides a simpler, all-Python implementation. With this and :" @@ -45758,26 +46333,30 @@ msgid "" "`gettext` package to internationalize your Python applications." msgstr "" -#: ../src/Doc/library/gettext.rst:767 +#: library/gettext.rst:767 msgid "" "The choice of :func:`N_` here is totally arbitrary; it could have just as " "easily been :func:`MarkThisStringForTranslation`." msgstr "" # efa46395cb8c4637b56f90450129d5fa -#: ../src/Doc/library/gl.rst:2 +#: library/gl.rst:2 msgid ":mod:`gl` --- *Graphics Library* interface" msgstr "" +#: library/gl.rst:10 +msgid "The :mod:`gl` module has been removed in Python 3." +msgstr "" + # f9d9bb01883e49af829d7418935881be -#: ../src/Doc/library/gl.rst:14 +#: library/gl.rst:14 msgid "" "This module provides access to the Silicon Graphics *Graphics Library*. It " "is available only on Silicon Graphics machines." msgstr "" # d5c224f3f6d44556be020ed809a00143 -#: ../src/Doc/library/gl.rst:19 +#: library/gl.rst:19 msgid "" "Some illegal calls to the GL library cause the Python interpreter to dump " "core. In particular, the use of most GL calls is unsafe before the first " @@ -45785,7 +46364,7 @@ msgid "" msgstr "" # c3cf74dc8a9f4dc0ac5191f3a6056014 -#: ../src/Doc/library/gl.rst:23 +#: library/gl.rst:23 msgid "" "The module is too large to document here in its entirety, but the following " "should help you to get started. The parameter conventions for the C " @@ -45793,34 +46372,34 @@ msgid "" msgstr "" # dc45d90f253d45cfb42eb9376052b77e -#: ../src/Doc/library/gl.rst:27 +#: library/gl.rst:27 msgid "" "All (short, long, unsigned) int values are represented by Python integers." msgstr "" # b992c71e05b146b19adf9f17702d53ca -#: ../src/Doc/library/gl.rst:29 +#: library/gl.rst:29 msgid "" "All float and double values are represented by Python floating point " "numbers. In most cases, Python integers are also allowed." msgstr "" # 5e00d3ba4254436abee9e15b206f062d -#: ../src/Doc/library/gl.rst:32 +#: library/gl.rst:32 msgid "" "All arrays are represented by one-dimensional Python lists. In most cases, " "tuples are also allowed." msgstr "" # 895aa51d1865448eb5f61e2dfd281fed -#: ../src/Doc/library/gl.rst:35 +#: library/gl.rst:35 msgid "" "All string and character arguments are represented by Python strings, for " "instance, ``winopen('Hi There!')`` and ``rotate(900, 'z')``." msgstr "" # f1ef24b413dc4fa3a1a4abe49f6459fa -#: ../src/Doc/library/gl.rst:38 +#: library/gl.rst:38 msgid "" "All (short, long, unsigned) integer arguments or return values that are only " "used to specify the length of an array argument are omitted. For example, " @@ -45829,12 +46408,12 @@ msgstr "" # d1385c691e424f3fa4a84d42fac00c8e # 346dc1eaae554bdf965ee0ff674fc803 -#: ../src/Doc/library/gl.rst:44 ../src/Doc/library/gl.rst:56 +#: library/gl.rst:44 library/gl.rst:56 msgid "is translated to Python as ::" msgstr "" # 1838a144bce74558a308944f1565a00d -#: ../src/Doc/library/gl.rst:48 +#: library/gl.rst:48 msgid "" "Output arguments are omitted from the argument list; they are transmitted as " "function return values instead. If more than one value must be returned, the " @@ -45844,14 +46423,14 @@ msgid "" msgstr "" # 3d2580ba356349899994683b9538facb -#: ../src/Doc/library/gl.rst:60 +#: library/gl.rst:60 msgid "" "The following functions are non-standard or have special argument " "conventions:" msgstr "" # afc8b98cd4d6435bad5156634229ed7e -#: ../src/Doc/library/gl.rst:65 +#: library/gl.rst:65 msgid "" "Equivalent to but faster than a number of ``v3d()`` calls. The *argument* is " "a list (or tuple) of points. Each point must be a tuple of coordinates ``(x, " @@ -45863,7 +46442,7 @@ msgid "" msgstr "" # 0efc7a301b1e4598bdee3cd2a91b594c -#: ../src/Doc/library/gl.rst:77 +#: library/gl.rst:77 msgid "" "Equivalent to but faster than a number of ``n3f`` and ``v3f`` calls. The " "argument is an array (list or tuple) of pairs of normals and points. Each " @@ -45874,41 +46453,41 @@ msgid "" msgstr "" # e53d1f55e64f46c5ad04a5b10675ae43 -#: ../src/Doc/library/gl.rst:87 +#: library/gl.rst:87 msgid "" "Similar to ``nvarray()`` but the pairs have the point first and the normal " "second." msgstr "" # 5cad0c8e1c094cfaa70cd1cf9bbac2aa -#: ../src/Doc/library/gl.rst:93 +#: library/gl.rst:93 msgid "" "Defines a nurbs surface. The dimensions of ``ctl[][]`` are computed as " "follows: ``[len(s_k) - s_ord]``, ``[len(t_k) - t_ord]``." msgstr "" # 859bbdf930474349a2ebc7951e4ab84c -#: ../src/Doc/library/gl.rst:101 +#: library/gl.rst:101 msgid "" "Defines a nurbs curve. The length of ctlpoints is ``len(knots) - order``." msgstr "" # ea1cd97f9911452ebc70214c7de74612 -#: ../src/Doc/library/gl.rst:106 +#: library/gl.rst:106 msgid "" "Defines a piecewise-linear curve. *points* is a list of points. *type* must " "be ``N_ST``." msgstr "" # a340847143674001af76ec0d4605c78c -#: ../src/Doc/library/gl.rst:113 +#: library/gl.rst:113 msgid "" "The only argument to these functions specifies the desired size of the pick " "or select buffer." msgstr "" # 3dc3162c0ea14028b4c0592f524421a2 -#: ../src/Doc/library/gl.rst:120 +#: library/gl.rst:120 msgid "" "These functions have no arguments. They return a list of integers " "representing the used part of the pick/select buffer. No method is provided " @@ -45916,18 +46495,16 @@ msgid "" msgstr "" # a08299dd6a3a4a83afc6a67854ca8ab6 -#: ../src/Doc/library/gl.rst:124 +#: library/gl.rst:124 msgid "Here is a tiny but complete example GL program in Python::" msgstr "" -# aa1f9a5a470542359b181fa4e4281178 -#: ../src/Doc/library/gl.rst:156 -msgid "" -"`PyOpenGL: The Python OpenGL Binding `_" +#: library/gl.rst:157 +msgid "PyOpenGL: The Python OpenGL Binding" msgstr "" # afb0b083ea1143aba407f47ab51b87bf -#: ../src/Doc/library/gl.rst:156 +#: library/gl.rst:156 msgid "" "An interface to OpenGL is also available; see information about the " "**PyOpenGL** project online at http://pyopengl.sourceforge.net/. This may " @@ -45936,12 +46513,16 @@ msgid "" msgstr "" # 5d6f5c83ad664af4bab6ac2413734834 -#: ../src/Doc/library/gl.rst:162 +#: library/gl.rst:162 msgid ":mod:`DEVICE` --- Constants used with the :mod:`gl` module" msgstr "" +#: library/gl.rst:170 +msgid "The :mod:`DEVICE` module has been removed in Python 3." +msgstr "" + # 02388f7089a14c389ba0e5cd21c42467 -#: ../src/Doc/library/gl.rst:174 +#: library/gl.rst:174 msgid "" "This modules defines the constants used by the Silicon Graphics *Graphics " "Library* that C programmers find in the header file ````. Read " @@ -45949,42 +46530,45 @@ msgid "" msgstr "" # 604b452f61314313945fe6eed699d0f2 -#: ../src/Doc/library/gl.rst:180 +#: library/gl.rst:180 msgid ":mod:`GL` --- Constants used with the :mod:`gl` module" msgstr "" +#: library/gl.rst:188 +msgid "The :mod:`GL` module has been removed in Python 3." +msgstr "" + # a12137eced28455ba803f0c89b1d5d3e -#: ../src/Doc/library/gl.rst:191 +#: library/gl.rst:191 msgid "" "This module contains constants used by the Silicon Graphics *Graphics " "Library* from the C header file ````. Read the module source file " "for details." msgstr "" -#: ../src/Doc/library/glob.rst:2 +#: library/glob.rst:2 msgid ":mod:`glob` --- Unix style pathname pattern expansion" msgstr "" # 55a2a6330f60453fbe8c06cc7e985abd -#: ../src/Doc/library/glob.rst:10 +#: library/glob.rst:10 msgid "**Source code:** :source:`Lib/glob.py`" msgstr "" -# 1171cbefc9874fa5bc8a639d51d56189 -#: ../src/Doc/library/glob.rst:14 +#: library/glob.rst:14 msgid "" "The :mod:`glob` module finds all the pathnames matching a specified pattern " -"according to the rules used by the Unix shell. No tilde expansion is done, " -"but ``*``, ``?``, and character ranges expressed with ``[]`` will be " -"correctly matched. This is done by using the :func:`os.listdir` and :func:" -"`fnmatch.fnmatch` functions in concert, and not by actually invoking a " -"subshell. Note that unlike :func:`fnmatch.fnmatch`, :mod:`glob` treats " -"filenames beginning with a dot (``.``) as special cases. (For tilde and " -"shell variable expansion, use :func:`os.path.expanduser` and :func:`os.path." -"expandvars`.)" +"according to the rules used by the Unix shell, although results are returned " +"in arbitrary order. No tilde expansion is done, but ``*``, ``?``, and " +"character ranges expressed with ``[]`` will be correctly matched. This is " +"done by using the :func:`os.listdir` and :func:`fnmatch.fnmatch` functions " +"in concert, and not by actually invoking a subshell. Note that unlike :func:" +"`fnmatch.fnmatch`, :mod:`glob` treats filenames beginning with a dot (``.``) " +"as special cases. (For tilde and shell variable expansion, use :func:`os." +"path.expanduser` and :func:`os.path.expandvars`.)" msgstr "" -#: ../src/Doc/library/glob.rst:30 +#: library/glob.rst:30 msgid "" "Return a possibly-empty list of path names that match *pathname*, which must " "be a string containing a path specification. *pathname* can be either " @@ -45993,13 +46577,13 @@ msgid "" "symlinks are included in the results (as in the shell)." msgstr "" -#: ../src/Doc/library/glob.rst:39 +#: library/glob.rst:39 msgid "" "Return an :term:`iterator` which yields the same values as :func:`glob` " "without actually storing them all simultaneously." msgstr "" -#: ../src/Doc/library/glob.rst:44 +#: library/glob.rst:44 msgid "" "For example, consider a directory containing only the following files: :file:" "`1.gif`, :file:`2.txt`, and :file:`card.gif`. :func:`glob` will produce the " @@ -46008,80 +46592,78 @@ msgid "" msgstr "" # ed7fe724aeb34accac246d8f332e8647 -#: ../src/Doc/library/glob.rst:57 +#: library/glob.rst:57 msgid "" "If the directory contains files starting with ``.`` they won't be matched by " "default. For example, consider a directory containing :file:`card.gif` and :" "file:`.card.gif`::" msgstr "" -# 5fe87816fe8048b08095937b2b08216a -#: ../src/Doc/library/glob.rst:68 -msgid "Module :mod:`fnmatch`" +#: library/glob.rst:69 +msgid "Module fnmatch" msgstr "" -#: ../src/Doc/library/glob.rst:70 +#: library/glob.rst:70 msgid "Shell-style filename (not path) expansion" msgstr "" -#: ../src/Doc/library/grp.rst:3 +#: library/grp.rst:3 msgid ":mod:`grp` --- The group database" msgstr "" -#: ../src/Doc/library/grp.rst:10 +#: library/grp.rst:10 msgid "" "This module provides access to the Unix group database. It is available on " "all Unix versions." msgstr "" -#: ../src/Doc/library/grp.rst:13 +#: library/grp.rst:13 msgid "" "Group database entries are reported as a tuple-like object, whose attributes " "correspond to the members of the ``group`` structure (Attribute field below, " "see ````):" msgstr "" -#: ../src/Doc/library/grp.rst:20 +#: library/grp.rst:20 msgid "gr_name" msgstr "" -#: ../src/Doc/library/grp.rst:20 +#: library/grp.rst:20 msgid "the name of the group" msgstr "" -#: ../src/Doc/library/grp.rst:22 +#: library/grp.rst:22 msgid "gr_passwd" msgstr "" -#: ../src/Doc/library/grp.rst:22 +#: library/grp.rst:22 msgid "the (encrypted) group password; often empty" msgstr "" -#: ../src/Doc/library/grp.rst:25 +#: library/grp.rst:25 msgid "gr_gid" msgstr "" -#: ../src/Doc/library/grp.rst:25 +#: library/grp.rst:25 msgid "the numerical group ID" msgstr "" -#: ../src/Doc/library/grp.rst:27 ../src/Doc/library/pwd.rst:26 -#: ../src/Doc/library/spwd.rst:31 ../src/Doc/library/time.rst:413 -#: ../src/Doc/library/tkinter.rst:447 ../src/Doc/library/urlparse.rst:102 -#: ../src/Doc/library/urlparse.rst:206 +#: library/grp.rst:27 library/pwd.rst:26 library/spwd.rst:31 +#: library/time.rst:412 library/tkinter.rst:447 library/urlparse.rst:102 +#: library/urlparse.rst:206 msgid "3" msgstr "" -#: ../src/Doc/library/grp.rst:27 +#: library/grp.rst:27 msgid "gr_mem" msgstr "" -#: ../src/Doc/library/grp.rst:27 +#: library/grp.rst:27 msgid "all the group member's user names" msgstr "" # ade043bd775f45cca008802eb8e797db -#: ../src/Doc/library/grp.rst:31 +#: library/grp.rst:31 msgid "" "The gid is an integer, name and password are strings, and the member list is " "a list of strings. (Note that most users are not explicitly listed as " @@ -46092,67 +46674,65 @@ msgid "" "`getgrgid`.)" msgstr "" -#: ../src/Doc/library/grp.rst:38 ../src/Doc/library/mimetools.rst:21 -#: ../src/Doc/library/pwd.rst:51 ../src/Doc/library/spwd.rst:53 +#: library/grp.rst:38 library/mimetools.rst:21 library/pwd.rst:51 +#: library/spwd.rst:53 msgid "It defines the following items:" msgstr "" -#: ../src/Doc/library/grp.rst:43 +#: library/grp.rst:43 msgid "" "Return the group database entry for the given numeric group ID. :exc:" "`KeyError` is raised if the entry asked for cannot be found." msgstr "" -#: ../src/Doc/library/grp.rst:49 +#: library/grp.rst:49 msgid "" "Return the group database entry for the given group name. :exc:`KeyError` is " "raised if the entry asked for cannot be found." msgstr "" -#: ../src/Doc/library/grp.rst:55 +#: library/grp.rst:55 msgid "Return a list of all available group entries, in arbitrary order." msgstr "" -# 9caed61f520a4bb39dbc16c53d26321e -# 6fe6c95df8f9478795a2b5bcc98034e3 -#: ../src/Doc/library/grp.rst:60 ../src/Doc/library/spwd.rst:71 -msgid "Module :mod:`pwd`" -msgstr "" +#: library/grp.rst:61 library/spwd.rst:72 +#, fuzzy +msgid "Module pwd" +msgstr "Modules" -#: ../src/Doc/library/grp.rst:61 +#: library/grp.rst:61 msgid "An interface to the user database, similar to this." msgstr "" -# d72708ae2ea0405ea4a8982de61558d3 -# 97dc1733fc5e4ae3b64fc7f775d0a68f -#: ../src/Doc/library/grp.rst:62 ../src/Doc/library/pwd.rst:73 -msgid "Module :mod:`spwd`" -msgstr "" +#: library/grp.rst:63 library/pwd.rst:74 +#, fuzzy +msgid "Module spwd" +msgstr "Modules" -#: ../src/Doc/library/grp.rst:64 ../src/Doc/library/pwd.rst:75 +#: library/grp.rst:64 library/pwd.rst:75 msgid "An interface to the shadow password database, similar to this." msgstr "" -#: ../src/Doc/library/gzip.rst:2 +#: library/gzip.rst:2 msgid ":mod:`gzip` --- Support for :program:`gzip` files" msgstr "" # 4805bf2fd3d443fd9279713edf186ca8 -#: ../src/Doc/library/gzip.rst:7 +#: library/gzip.rst:7 msgid "**Source code:** :source:`Lib/gzip.py`" msgstr "" -#: ../src/Doc/library/gzip.rst:11 +#: library/gzip.rst:11 msgid "" "This module provides a simple interface to compress and decompress files " "just like the GNU programs :program:`gzip` and :program:`gunzip` would." msgstr "" -#: ../src/Doc/library/gzip.rst:14 +#: library/gzip.rst:14 msgid "The data compression is provided by the :mod:`zlib` module." msgstr "" -#: ../src/Doc/library/gzip.rst:16 +#: library/gzip.rst:16 msgid "" "The :mod:`gzip` module provides the :class:`GzipFile` class which is modeled " "after Python's File Object. The :class:`GzipFile` class reads and writes :" @@ -46160,14 +46740,14 @@ msgid "" "the data so that it looks like an ordinary file object." msgstr "" -#: ../src/Doc/library/gzip.rst:21 +#: library/gzip.rst:21 msgid "" "Note that additional file formats which can be decompressed by the :program:" "`gzip` and :program:`gunzip` programs, such as those produced by :program:" "`compress` and :program:`pack`, are not supported by this module." msgstr "" -#: ../src/Doc/library/gzip.rst:30 +#: library/gzip.rst:30 msgid "" "Constructor for the :class:`GzipFile` class, which simulates most of the " "methods of a file object, with the exception of the :meth:`readinto` and :" @@ -46176,7 +46756,7 @@ msgid "" msgstr "" # 80f0b88343b0450fbeba85f90bd01781 -#: ../src/Doc/library/gzip.rst:35 +#: library/gzip.rst:35 msgid "" "The new class instance is based on *fileobj*, which can be a regular file, " "a :class:`~StringIO.StringIO` object, or any other object which simulates a " @@ -46185,7 +46765,7 @@ msgid "" msgstr "" # 8759de122fbe4e5bba7aa7edd8cf286d -#: ../src/Doc/library/gzip.rst:40 +#: library/gzip.rst:40 msgid "" "When *fileobj* is not ``None``, the *filename* argument is only used to be " "included in the :program:`gzip` file header, which may include the original " @@ -46194,7 +46774,7 @@ msgid "" "in this case the original filename is not included in the header." msgstr "" -#: ../src/Doc/library/gzip.rst:46 +#: library/gzip.rst:46 msgid "" "The *mode* argument can be any of ``'r'``, ``'rb'``, ``'a'``, ``'ab'``, " "``'w'``, or ``'wb'``, depending on whether the file will be read or " @@ -46205,7 +46785,7 @@ msgid "" msgstr "" # ef2a387905054cd3a396c172e59bc627 -#: ../src/Doc/library/gzip.rst:52 +#: library/gzip.rst:52 msgid "" "The *compresslevel* argument is an integer from ``0`` to ``9`` controlling " "the level of compression; ``1`` is fastest and produces the least " @@ -46214,7 +46794,7 @@ msgid "" msgstr "" # 4284e122f97b4405b7f6e57646106ed4 -#: ../src/Doc/library/gzip.rst:57 +#: library/gzip.rst:57 msgid "" "The *mtime* argument is an optional numeric timestamp to be written to the " "stream when compressing. All :program:`gzip` compressed streams are " @@ -46226,7 +46806,7 @@ msgid "" msgstr "" # c6c7d18e8b2240899b4a1624aeaaeb0f -#: ../src/Doc/library/gzip.rst:66 +#: library/gzip.rst:66 msgid "" "Calling a :class:`GzipFile` object's :meth:`close` method does not close " "*fileobj*, since you might wish to append more material after the compressed " @@ -46236,55 +46816,63 @@ msgid "" "method." msgstr "" -#: ../src/Doc/library/gzip.rst:72 +#: library/gzip.rst:72 msgid ":class:`GzipFile` supports iteration and the :keyword:`with` statement." msgstr "" -#: ../src/Doc/library/gzip.rst:86 +#: library/gzip.rst:77 +msgid "Support for zero-padded files was added." +msgstr "" + +#: library/gzip.rst:80 +msgid "The *mtime* argument." +msgstr "" + +#: library/gzip.rst:86 msgid "" "This is a shorthand for ``GzipFile(filename,`` ``mode,`` ``compresslevel)``. " "The *filename* argument is required; *mode* defaults to ``'rb'`` and " "*compresslevel* defaults to ``9``." msgstr "" -#: ../src/Doc/library/gzip.rst:94 +#: library/gzip.rst:94 msgid "Examples of usage" msgstr "" -#: ../src/Doc/library/gzip.rst:96 +#: library/gzip.rst:96 msgid "Example of how to read a compressed file::" msgstr "" -#: ../src/Doc/library/gzip.rst:103 +#: library/gzip.rst:102 msgid "Example of how to create a compressed GZIP file::" msgstr "" -#: ../src/Doc/library/gzip.rst:111 +#: library/gzip.rst:109 msgid "Example of how to GZIP compress an existing file::" msgstr "" -# 9eae7256789549568b75df1bb8d7eb85 -#: ../src/Doc/library/gzip.rst:123 -msgid "Module :mod:`zlib`" -msgstr "" +#: library/gzip.rst:120 +#, fuzzy +msgid "Module zlib" +msgstr "Modules" -#: ../src/Doc/library/gzip.rst:124 +#: library/gzip.rst:120 msgid "" "The basic data compression module needed to support the :program:`gzip` file " "format." msgstr "" -#: ../src/Doc/library/hashlib.rst:2 +#: library/hashlib.rst:2 msgid ":mod:`hashlib` --- Secure hashes and message digests" msgstr "" # 69496929d23c4a08a92470f9f9f75a9b -#: ../src/Doc/library/hashlib.rst:16 +#: library/hashlib.rst:16 msgid "**Source code:** :source:`Lib/hashlib.py`" msgstr "" # c6048d536cc14c75bc0a738632d1e830 -#: ../src/Doc/library/hashlib.rst:20 +#: library/hashlib.rst:20 msgid "" "This module implements a common interface to many different secure hash and " "message digest algorithms. Included are the FIPS secure hash algorithms " @@ -46295,21 +46883,21 @@ msgid "" msgstr "" # 279f08a8a154450e962aa46680e7d748 -#: ../src/Doc/library/hashlib.rst:29 +#: library/hashlib.rst:29 msgid "" "If you want the adler32 or crc32 hash functions, they are available in the :" "mod:`zlib` module." msgstr "" # 5d995cf9cbda4cf3ae10838b974757ae -#: ../src/Doc/library/hashlib.rst:34 +#: library/hashlib.rst:34 msgid "" "Some algorithms have known hash collision weaknesses, refer to the \"See also" "\" section at the end." msgstr "" # 1ffb9611d2c147cba30c4ffc0e9ce93f -#: ../src/Doc/library/hashlib.rst:37 +#: library/hashlib.rst:37 msgid "" "There is one constructor method named for each type of :dfn:`hash`. All " "return a hash object with the same simple interface. For example: use :func:" @@ -46319,7 +46907,7 @@ msgid "" "far using the :meth:`digest` or :meth:`hexdigest` methods." msgstr "" -#: ../src/Doc/library/hashlib.rst:46 +#: library/hashlib.rst:46 msgid "" "Constructors for hash algorithms that are always present in this module are :" "func:`md5`, :func:`sha1`, :func:`sha224`, :func:`sha256`, :func:`sha384`, " @@ -46329,17 +46917,17 @@ msgstr "" # 80949c6fa92d470394ead67d75b146fe # 53442b60cb354a57918ab05d6f6c3390 -#: ../src/Doc/library/hashlib.rst:51 ../src/Doc/library/md5.rst:24 +#: library/hashlib.rst:51 library/md5.rst:24 msgid "" "For example, to obtain the digest of the string ``'Nobody inspects the " "spammish repetition'``:" msgstr "" -#: ../src/Doc/library/hashlib.rst:65 ../src/Doc/library/md5.rst:34 +#: library/hashlib.rst:65 library/md5.rst:34 msgid "More condensed:" msgstr "" -#: ../src/Doc/library/hashlib.rst:70 +#: library/hashlib.rst:70 msgid "" "A generic :func:`new` constructor that takes the string name of the desired " "algorithm as its first parameter also exists to allow access to the above " @@ -46348,29 +46936,29 @@ msgid "" "be preferred." msgstr "" -#: ../src/Doc/library/hashlib.rst:75 +#: library/hashlib.rst:75 msgid "Using :func:`new` with an algorithm provided by OpenSSL:" msgstr "" -#: ../src/Doc/library/hashlib.rst:82 +#: library/hashlib.rst:82 msgid "This module provides the following constant attribute:" msgstr "" -#: ../src/Doc/library/hashlib.rst:86 +#: library/hashlib.rst:86 msgid "" "A tuple providing the names of the hash algorithms guaranteed to be " "supported by this module." msgstr "" # 28a0aac4fc224a07a49be9ee3f932798 -#: ../src/Doc/library/hashlib.rst:93 +#: library/hashlib.rst:93 msgid "" "A set containing the names of the hash algorithms guaranteed to be supported " "by this module on all platforms." msgstr "" # d3076b565a234a9bafa9170d7abd0974 -#: ../src/Doc/library/hashlib.rst:100 +#: library/hashlib.rst:100 msgid "" "A set containing the names of the hash algorithms that are available in the " "running Python interpreter. These names will be recognized when passed to :" @@ -46379,34 +46967,41 @@ msgid "" "(thanks to OpenSSL)." msgstr "" -#: ../src/Doc/library/hashlib.rst:109 +#: library/hashlib.rst:109 msgid "" "The following values are provided as constant attributes of the hash objects " "returned by the constructors:" msgstr "" -#: ../src/Doc/library/hashlib.rst:115 +#: library/hashlib.rst:115 msgid "The size of the resulting hash in bytes." msgstr "" -#: ../src/Doc/library/hashlib.rst:119 +#: library/hashlib.rst:119 msgid "The internal block size of the hash algorithm in bytes." msgstr "" -#: ../src/Doc/library/hashlib.rst:121 +#: library/hashlib.rst:121 msgid "A hash object has the following methods:" msgstr "" # 72a9afc8fc224bc6ace66555755ccc1a -#: ../src/Doc/library/hashlib.rst:126 +#: library/hashlib.rst:126 msgid "" "Update the hash object with the string *arg*. Repeated calls are equivalent " "to a single call with the concatenation of all the arguments: ``m.update(a); " "m.update(b)`` is equivalent to ``m.update(a+b)``." msgstr "" +#: library/hashlib.rst:130 +msgid "" +"The Python GIL is released to allow other threads to run while hash updates " +"on data larger than 2048 bytes is taking place when using hash algorithms " +"supplied by OpenSSL." +msgstr "" + # 592af5a9dede44ed84abc3bba5eeeaa7 -#: ../src/Doc/library/hashlib.rst:138 +#: library/hashlib.rst:138 msgid "" "Return the digest of the strings passed to the :meth:`update` method so far. " "This is a string of :attr:`digest_size` bytes which may contain non-ASCII " @@ -46414,7 +47009,7 @@ msgid "" msgstr "" # 352c26f4cc314f5ea697ce49f12862ff -#: ../src/Doc/library/hashlib.rst:145 +#: library/hashlib.rst:145 msgid "" "Like :meth:`digest` except the digest is returned as a string of double " "length, containing only hexadecimal digits. This may be used to exchange " @@ -46422,20 +47017,20 @@ msgid "" msgstr "" # 1b1fe75ccabb49b8b760f8b1bcd6644d -#: ../src/Doc/library/hashlib.rst:152 +#: library/hashlib.rst:152 msgid "" "Return a copy (\"clone\") of the hash object. This can be used to " "efficiently compute the digests of strings that share a common initial " "substring." msgstr "" -# 89421186b78744ac88894253e9625f2d -#: ../src/Doc/library/hashlib.rst:157 -msgid "Key Derivation Function" -msgstr "" +#: library/hashlib.rst:157 +#, fuzzy +msgid "Key derivation" +msgstr "description" # 8cd2ba73dd18431daa2acae4c9732e1b -#: ../src/Doc/library/hashlib.rst:159 +#: library/hashlib.rst:159 msgid "" "Key derivation and key stretching algorithms are designed for secure " "password hashing. Naive algorithms such as ``sha1(password)`` are not " @@ -46445,14 +47040,14 @@ msgid "" msgstr "" # 815ba61cc4e646969ce97a1b3b32845e -#: ../src/Doc/library/hashlib.rst:167 +#: library/hashlib.rst:167 msgid "" "The function provides PKCS#5 password-based key derivation function 2. It " "uses HMAC as pseudorandom function." msgstr "" # b415b23bd24e40a6a74edf351479b579 -#: ../src/Doc/library/hashlib.rst:170 +#: library/hashlib.rst:170 msgid "" "The string *name* is the desired name of the hash digest algorithm for HMAC, " "e.g. 'sha1' or 'sha256'. *password* and *salt* are interpreted as buffers of " @@ -46462,79 +47057,78 @@ msgid "" msgstr "" # f19f908f18b14d86b4cb78b8a32e95b4 -#: ../src/Doc/library/hashlib.rst:176 +#: library/hashlib.rst:176 msgid "" "The number of *rounds* should be chosen based on the hash algorithm and " "computing power. As of 2013, at least 100,000 rounds of SHA-256 is suggested." msgstr "" # 6f519dd24fca4f4ca8c205fac4f328a6 -#: ../src/Doc/library/hashlib.rst:179 +#: library/hashlib.rst:179 msgid "" "*dklen* is the length of the derived key. If *dklen* is ``None`` then the " "digest size of the hash algorithm *name* is used, e.g. 64 for SHA-512." msgstr "" # 758985effec4438ba3a8972060017609 -#: ../src/Doc/library/hashlib.rst:191 +#: library/hashlib.rst:191 msgid "" "A fast implementation of *pbkdf2_hmac* is available with OpenSSL. The " "Python implementation uses an inline version of :mod:`hmac`. It is about " "three times slower and doesn't release the GIL." msgstr "" -# 77aef100be314f1697aa6f254fd31ad6 -#: ../src/Doc/library/hashlib.rst:198 -msgid "Module :mod:`hmac`" -msgstr "" +#: library/hashlib.rst:199 +#, fuzzy +msgid "Module hmac" +msgstr "Modules" -#: ../src/Doc/library/hashlib.rst:199 +#: library/hashlib.rst:199 msgid "A module to generate message authentication codes using hashes." msgstr "" -#: ../src/Doc/library/hashlib.rst:202 +#: library/hashlib.rst:202 msgid "Another way to encode binary hashes for non-binary environments." msgstr "" # b8459439595f46769442a6bdc241c512 -#: ../src/Doc/library/hashlib.rst:204 +#: library/hashlib.rst:205 msgid "http://csrc.nist.gov/publications/fips/fips180-2/fips180-2.pdf" msgstr "" -#: ../src/Doc/library/hashlib.rst:205 +#: library/hashlib.rst:205 msgid "The FIPS 180-2 publication on Secure Hash Algorithms." msgstr "" -# 84f6cf5ea3934097a04190680512846f -#: ../src/Doc/library/hashlib.rst:207 +#: library/hashlib.rst:208 msgid "" -"http://en.wikipedia.org/wiki/" +"https://en.wikipedia.org/wiki/" "Cryptographic_hash_function#Cryptographic_hash_algorithms" msgstr "" -#: ../src/Doc/library/hashlib.rst:208 +#: library/hashlib.rst:208 msgid "" "Wikipedia article with information on which algorithms have known issues and " "what that means regarding their use." msgstr "" -#: ../src/Doc/library/heapq.rst:2 +#: library/heapq.rst:2 msgid ":mod:`heapq` --- Heap queue algorithm" msgstr "" # 2a4dff0a7e694329a94acd13f8c4bccc -#: ../src/Doc/library/heapq.rst:13 +#: library/heapq.rst:13 msgid "**Source code:** :source:`Lib/heapq.py`" msgstr "" -#: ../src/Doc/library/heapq.rst:17 +#: library/heapq.rst:17 msgid "" "This module provides an implementation of the heap queue algorithm, also " "known as the priority queue algorithm." msgstr "" # e0a73daa866c4473b2caf87529eecd6a -#: ../src/Doc/library/heapq.rst:20 +#: library/heapq.rst:20 msgid "" "Heaps are binary trees for which every parent node has a value less than or " "equal to any of its children. This implementation uses arrays for which " @@ -46544,7 +47138,7 @@ msgid "" "is that its smallest element is always the root, ``heap[0]``." msgstr "" -#: ../src/Doc/library/heapq.rst:27 +#: library/heapq.rst:27 msgid "" "The API below differs from textbook heap algorithms in two aspects: (a) We " "use zero-based indexing. This makes the relationship between the index for " @@ -46555,42 +47149,43 @@ msgid "" "sorting)." msgstr "" -#: ../src/Doc/library/heapq.rst:34 +#: library/heapq.rst:34 msgid "" "These two make it possible to view the heap as a regular Python list without " "surprises: ``heap[0]`` is the smallest item, and ``heap.sort()`` maintains " "the heap invariant!" msgstr "" -#: ../src/Doc/library/heapq.rst:38 +#: library/heapq.rst:38 msgid "" "To create a heap, use a list initialized to ``[]``, or you can transform a " "populated list into a heap via function :func:`heapify`." msgstr "" -#: ../src/Doc/library/heapq.rst:46 +#: library/heapq.rst:46 msgid "Push the value *item* onto the *heap*, maintaining the heap invariant." msgstr "" -#: ../src/Doc/library/heapq.rst:51 +#: library/heapq.rst:51 msgid "" "Pop and return the smallest item from the *heap*, maintaining the heap " -"invariant. If the heap is empty, :exc:`IndexError` is raised." +"invariant. If the heap is empty, :exc:`IndexError` is raised. To access " +"the smallest item without popping it, use ``heap[0]``." msgstr "" -#: ../src/Doc/library/heapq.rst:56 +#: library/heapq.rst:57 msgid "" "Push *item* on the heap, then pop and return the smallest item from the " "*heap*. The combined action runs more efficiently than :func:`heappush` " "followed by a separate call to :func:`heappop`." msgstr "" -#: ../src/Doc/library/heapq.rst:64 +#: library/heapq.rst:65 msgid "Transform list *x* into a heap, in-place, in linear time." msgstr "" # e86d5883772a4b219f27012452bd1e3f -#: ../src/Doc/library/heapq.rst:69 +#: library/heapq.rst:70 msgid "" "Pop and return the smallest item from the *heap*, and also push the new " "*item*. The heap size doesn't change. If the heap is empty, :exc:" @@ -46598,7 +47193,7 @@ msgid "" msgstr "" # 69da970419c542ae9665dd3551bd8434 -#: ../src/Doc/library/heapq.rst:72 +#: library/heapq.rst:73 msgid "" "This one step operation is more efficient than a :func:`heappop` followed " "by :func:`heappush` and can be more appropriate when using a fixed-size " @@ -46607,7 +47202,7 @@ msgid "" msgstr "" # 5afc1f9f84ef44c2a89bb32e556002da -#: ../src/Doc/library/heapq.rst:77 +#: library/heapq.rst:78 msgid "" "The value returned may be larger than the *item* added. If that isn't " "desired, consider using :func:`heappushpop` instead. Its push/pop " @@ -46615,25 +47210,25 @@ msgid "" "on the heap." msgstr "" -#: ../src/Doc/library/heapq.rst:83 +#: library/heapq.rst:84 msgid "The module also offers three general purpose functions based on heaps." msgstr "" -#: ../src/Doc/library/heapq.rst:88 +#: library/heapq.rst:89 msgid "" "Merge multiple sorted inputs into a single sorted output (for example, merge " "timestamped entries from multiple log files). Returns an :term:`iterator` " "over the sorted values." msgstr "" -#: ../src/Doc/library/heapq.rst:92 +#: library/heapq.rst:93 msgid "" "Similar to ``sorted(itertools.chain(*iterables))`` but returns an iterable, " "does not pull the data into memory all at once, and assumes that each of the " "input streams is already sorted (smallest to largest)." msgstr "" -#: ../src/Doc/library/heapq.rst:101 +#: library/heapq.rst:102 msgid "" "Return a list with the *n* largest elements from the dataset defined by " "*iterable*. *key*, if provided, specifies a function of one argument that " @@ -46642,7 +47237,13 @@ msgid "" "n]``" msgstr "" -#: ../src/Doc/library/heapq.rst:115 +# 30e5ab4a94f04c30a0d3a5d94e2de6ef +#: library/heapq.rst:110 library/heapq.rst:123 +#, fuzzy +msgid "Added the optional *key* argument." +msgstr "augment positionnel" + +#: library/heapq.rst:116 msgid "" "Return a list with the *n* smallest elements from the dataset defined by " "*iterable*. *key*, if provided, specifies a function of one argument that " @@ -46650,22 +47251,23 @@ msgid "" "``key=str.lower`` Equivalent to: ``sorted(iterable, key=key)[:n]``" msgstr "" -#: ../src/Doc/library/heapq.rst:125 +#: library/heapq.rst:126 msgid "" "The latter two functions perform best for smaller values of *n*. For larger " "values, it is more efficient to use the :func:`sorted` function. Also, when " "``n==1``, it is more efficient to use the built-in :func:`min` and :func:" -"`max` functions." +"`max` functions. If repeated usage of these functions is required, consider " +"turning the iterable into an actual heap." msgstr "" # e86ac7c1758d40bbbd6f3b1fc1cfc68e # ce1558aab9434fa3a5d36f9b6d60339e -#: ../src/Doc/library/heapq.rst:132 ../src/Doc/library/timeit.rst:26 +#: library/heapq.rst:134 library/timeit.rst:26 msgid "Basic Examples" msgstr "" # ed715c3d43744a01aee58190a475f023 -#: ../src/Doc/library/heapq.rst:134 +#: library/heapq.rst:136 msgid "" "A `heapsort `_ can be implemented by " "pushing all values onto a heap and then popping off the smallest values one " @@ -46673,40 +47275,40 @@ msgid "" msgstr "" # 4c0d8563bedd4cdc9f0fded2b3b4221b -#: ../src/Doc/library/heapq.rst:147 +#: library/heapq.rst:149 msgid "" "This is similar to ``sorted(iterable)``, but unlike :func:`sorted`, this " "implementation is not stable." msgstr "" # 7919c259827d4affaf7e9c8881615a89 -#: ../src/Doc/library/heapq.rst:150 +#: library/heapq.rst:152 msgid "" "Heap elements can be tuples. This is useful for assigning comparison values " "(such as task priorities) alongside the main record being tracked::" msgstr "" # 9e967174a430440b94f7bd6b8a570305 -#: ../src/Doc/library/heapq.rst:163 +#: library/heapq.rst:165 msgid "Priority Queue Implementation Notes" msgstr "" # 21be7e73c6cb4c9db5709e106b2bddf6 -#: ../src/Doc/library/heapq.rst:165 +#: library/heapq.rst:167 msgid "" "A `priority queue `_ is common " "use for a heap, and it presents several implementation challenges:" msgstr "" # ce7341dd6f984d84b8df017f0dd0cdef -#: ../src/Doc/library/heapq.rst:168 +#: library/heapq.rst:170 msgid "" "Sort stability: how do you get two tasks with equal priorities to be " "returned in the order they were originally added?" msgstr "" # 7308bf12fd9c43499f35a34770278f4f -#: ../src/Doc/library/heapq.rst:171 +#: library/heapq.rst:173 msgid "" "In the future with Python 3, tuple comparison breaks for (priority, task) " "pairs if the priorities are equal and the tasks do not have a default " @@ -46714,21 +47316,21 @@ msgid "" msgstr "" # b0b0df55ba804589852cf56fe0684ff3 -#: ../src/Doc/library/heapq.rst:175 +#: library/heapq.rst:177 msgid "" "If the priority of a task changes, how do you move it to a new position in " "the heap?" msgstr "" # 0c47644b01274a87a489e3b4ffcab072 -#: ../src/Doc/library/heapq.rst:178 +#: library/heapq.rst:180 msgid "" "Or if a pending task needs to be deleted, how do you find it and remove it " "from the queue?" msgstr "" # 91376ba6bd0c4391bb267d753d07bac2 -#: ../src/Doc/library/heapq.rst:181 +#: library/heapq.rst:183 msgid "" "A solution to the first two challenges is to store entries as 3-element list " "including the priority, an entry count, and the task. The entry count " @@ -46738,7 +47340,7 @@ msgid "" msgstr "" # 7621a149046c40cdbf7c143ae3fa296f -#: ../src/Doc/library/heapq.rst:187 +#: library/heapq.rst:189 msgid "" "The remaining challenges revolve around finding a pending task and making " "changes to its priority or removing it entirely. Finding a task can be done " @@ -46746,7 +47348,7 @@ msgid "" msgstr "" # b60c396c5b9c478391fd214ecea7030f -#: ../src/Doc/library/heapq.rst:191 +#: library/heapq.rst:193 msgid "" "Removing the entry or changing its priority is more difficult because it " "would break the heap structure invariants. So, a possible solution is to " @@ -46754,11 +47356,11 @@ msgid "" "priority::" msgstr "" -#: ../src/Doc/library/heapq.rst:225 +#: library/heapq.rst:227 msgid "Theory" msgstr "" -#: ../src/Doc/library/heapq.rst:227 +#: library/heapq.rst:229 msgid "" "Heaps are arrays for which ``a[k] <= a[2*k+1]`` and ``a[k] <= a[2*k+2]`` for " "all *k*, counting elements from 0. For the sake of comparison, non-existing " @@ -46766,13 +47368,13 @@ msgid "" "is that ``a[0]`` is always its smallest element." msgstr "" -#: ../src/Doc/library/heapq.rst:232 +#: library/heapq.rst:234 msgid "" "The strange invariant above is meant to be an efficient memory " "representation for a tournament. The numbers below are *k*, not ``a[k]``::" msgstr "" -#: ../src/Doc/library/heapq.rst:245 +#: library/heapq.rst:247 msgid "" "In the tree above, each cell *k* is topping ``2*k+1`` and ``2*k+2``. In an " "usual binary tournament we see in sports, each cell is the winner over the " @@ -46785,7 +47387,7 @@ msgid "" "over the two topped cells." msgstr "" -#: ../src/Doc/library/heapq.rst:254 +#: library/heapq.rst:256 msgid "" "If this heap invariant is protected at all time, index 0 is clearly the " "overall winner. The simplest algorithmic way to remove it and find the " @@ -46797,7 +47399,7 @@ msgid "" msgstr "" # 82c73c35916f461aaa5d62ad74f76e00 -#: ../src/Doc/library/heapq.rst:261 +#: library/heapq.rst:263 msgid "" "A nice feature of this sort is that you can efficiently insert new items " "while the sort is going on, provided that the inserted items are not \"better" @@ -46809,7 +47411,7 @@ msgid "" "schedulers (this is what I used for my MIDI sequencer :-)." msgstr "" -#: ../src/Doc/library/heapq.rst:270 +#: library/heapq.rst:272 msgid "" "Various structures for implementing schedulers have been extensively " "studied, and heaps are good for this, as they are reasonably speedy, the " @@ -46818,21 +47420,21 @@ msgid "" "efficient overall, yet the worst cases might be terrible." msgstr "" -#: ../src/Doc/library/heapq.rst:276 +#: library/heapq.rst:278 msgid "" "Heaps are also very useful in big disk sorts. You most probably all know " "that a big sort implies producing \"runs\" (which are pre-sorted sequences, " -"which size is usually related to the amount of CPU memory), followed by a " +"whose size is usually related to the amount of CPU memory), followed by a " "merging passes for these runs, which merging is often very cleverly " "organised [#]_. It is very important that the initial sort produces the " -"longest runs possible. Tournaments are a good way to that. If, using all " -"the memory available to hold a tournament, you replace and percolate items " -"that happen to fit the current run, you'll produce runs which are twice the " -"size of the memory for random input, and much better for input fuzzily " -"ordered." +"longest runs possible. Tournaments are a good way to achieve that. If, " +"using all the memory available to hold a tournament, you replace and " +"percolate items that happen to fit the current run, you'll produce runs " +"which are twice the size of the memory for random input, and much better for " +"input fuzzily ordered." msgstr "" -#: ../src/Doc/library/heapq.rst:286 +#: library/heapq.rst:288 msgid "" "Moreover, if you output the 0'th item on disk and get an input which may not " "fit in the current tournament (because the value \"wins\" over the last " @@ -46843,13 +47445,13 @@ msgid "" "switch heaps and start a new run. Clever and quite effective!" msgstr "" -#: ../src/Doc/library/heapq.rst:294 +#: library/heapq.rst:296 msgid "" "In a word, heaps are useful memory structures to know. I use them in a few " "applications, and I think it is good to keep a 'heap' module around. :-)" msgstr "" -#: ../src/Doc/library/heapq.rst:299 +#: library/heapq.rst:301 msgid "" "The disk balancing algorithms which are current, nowadays, are more annoying " "than clever, and this is a consequence of the seeking capabilities of the " @@ -46862,39 +47464,39 @@ msgid "" "times, sorting has always been a Great Art! :-)" msgstr "" -#: ../src/Doc/library/hmac.rst:2 +#: library/hmac.rst:2 msgid ":mod:`hmac` --- Keyed-Hashing for Message Authentication" msgstr "" # dda93327a1c34f9b9af6deb407f0baa2 -#: ../src/Doc/library/hmac.rst:12 +#: library/hmac.rst:12 msgid "**Source code:** :source:`Lib/hmac.py`" msgstr "" -#: ../src/Doc/library/hmac.rst:16 +#: library/hmac.rst:16 msgid "This module implements the HMAC algorithm as described by :rfc:`2104`." msgstr "" # 577c3527e5bb4240afb39f3b86b850fa -#: ../src/Doc/library/hmac.rst:21 +#: library/hmac.rst:21 msgid "" "Return a new hmac object. If *msg* is present, the method call " "``update(msg)`` is made. *digestmod* is the digest constructor or module for " "the HMAC object to use. It defaults to the :data:`hashlib.md5` constructor." msgstr "" -#: ../src/Doc/library/hmac.rst:26 +#: library/hmac.rst:26 msgid "An HMAC object has the following methods:" msgstr "" -#: ../src/Doc/library/hmac.rst:30 +#: library/hmac.rst:30 msgid "" "Update the hmac object with the string *msg*. Repeated calls are equivalent " "to a single call with the concatenation of all the arguments: ``m.update(a); " "m.update(b)`` is equivalent to ``m.update(a + b)``." msgstr "" -#: ../src/Doc/library/hmac.rst:37 +#: library/hmac.rst:37 msgid "" "Return the digest of the strings passed to the :meth:`update` method so far. " "This string will be the same length as the *digest_size* of the digest given " @@ -46903,7 +47505,7 @@ msgid "" msgstr "" # 0086990bef6545e88e4fa953fa0dcf17 -#: ../src/Doc/library/hmac.rst:43 +#: library/hmac.rst:43 msgid "" "When comparing the output of :meth:`digest` to an externally-supplied digest " "during a verification routine, it is recommended to use the :func:" @@ -46911,7 +47513,7 @@ msgid "" "vulnerability to timing attacks." msgstr "" -#: ../src/Doc/library/hmac.rst:51 +#: library/hmac.rst:51 msgid "" "Like :meth:`digest` except the digest is returned as a string twice the " "length containing only hexadecimal digits. This may be used to exchange the " @@ -46919,7 +47521,7 @@ msgid "" msgstr "" # 60d0b4d87d644108bbc3a6e57f06336a -#: ../src/Doc/library/hmac.rst:57 +#: library/hmac.rst:57 msgid "" "When comparing the output of :meth:`hexdigest` to an externally-supplied " "digest during a verification routine, it is recommended to use the :func:" @@ -46927,7 +47529,7 @@ msgid "" "vulnerability to timing attacks." msgstr "" -#: ../src/Doc/library/hmac.rst:65 +#: library/hmac.rst:65 msgid "" "Return a copy (\"clone\") of the hmac object. This can be used to " "efficiently compute the digests of strings that share a common initial " @@ -46935,12 +47537,12 @@ msgid "" msgstr "" # addfd0245e774d95a57859283c6379b8 -#: ../src/Doc/library/hmac.rst:69 +#: library/hmac.rst:69 msgid "This module also provides the following helper function:" msgstr "" # 1c7ef490e6504a43a66c6f7c9142b4f5 -#: ../src/Doc/library/hmac.rst:73 +#: library/hmac.rst:73 msgid "" "Return ``a == b``. This function uses an approach designed to prevent " "timing analysis by avoiding content-based short circuiting behaviour, making " @@ -46949,29 +47551,29 @@ msgid "" msgstr "" # c05379486b414a3f91b36e7cf0032c8c -#: ../src/Doc/library/hmac.rst:80 +#: library/hmac.rst:80 msgid "" "If *a* and *b* are of different lengths, or if an error occurs, a timing " "attack could theoretically reveal information about the types and lengths of " "*a* and *b*--but not their values." msgstr "" -# b13a0091891343b8b277dab05ede9236 -#: ../src/Doc/library/hmac.rst:89 -msgid "Module :mod:`hashlib`" -msgstr "" +#: library/hmac.rst:90 +#, fuzzy +msgid "Module hashlib" +msgstr "Modules" -#: ../src/Doc/library/hmac.rst:91 +#: library/hmac.rst:91 msgid "The Python module providing secure hash functions." msgstr "" # d215769e4b98442b9e0204f5b6046235 -#: ../src/Doc/library/hotshot.rst:3 +#: library/hotshot.rst:3 msgid ":mod:`hotshot` --- High performance logging profiler" msgstr "" # 966723d289e3400e9034c555f3379c82 -#: ../src/Doc/library/hotshot.rst:13 +#: library/hotshot.rst:13 msgid "" "This module provides a nicer interface to the :mod:`_hotshot` C module. " "Hotshot is a replacement for the existing :mod:`profile` module. As it's " @@ -46980,7 +47582,7 @@ msgid "" msgstr "" # 0e6eccf4b1f0477e846fc80ce0c38778 -#: ../src/Doc/library/hotshot.rst:20 +#: library/hotshot.rst:20 msgid "" "The :mod:`hotshot` module focuses on minimizing the overhead while " "profiling, at the expense of long data post-processing times. For common " @@ -46988,8 +47590,14 @@ msgid "" "not maintained and might be removed from the standard library in the future." msgstr "" +#: library/hotshot.rst:25 library/profile.rst:50 +msgid "" +"The results should be more meaningful than in the past: the timing core " +"contained a critical bug." +msgstr "" + # a83a2a2ae81f4234a4e46e0b105ac985 -#: ../src/Doc/library/hotshot.rst:31 +#: library/hotshot.rst:31 msgid "" "The :mod:`hotshot` profiler does not yet work well with threads. It is " "useful to use an unthreaded script to run the profiler over the code you're " @@ -46997,7 +47605,7 @@ msgid "" msgstr "" # 50cb602280d44e3a98707a6424dc1713 -#: ../src/Doc/library/hotshot.rst:38 +#: library/hotshot.rst:38 msgid "" "The profiler object. The argument *logfile* is the name of a log file to use " "for logged profile data. The argument *lineevents* specifies whether to " @@ -47008,32 +47616,32 @@ msgid "" msgstr "" # 31a5b7c7d7c3498385910621f3daf516 -#: ../src/Doc/library/hotshot.rst:49 +#: library/hotshot.rst:49 msgid "Profile Objects" msgstr "" # db064857f7d14888bc2a8a896151ee72 -#: ../src/Doc/library/hotshot.rst:51 +#: library/hotshot.rst:51 msgid "Profile objects have the following methods:" msgstr "" # 2c247ff9763540ebbdc811fd2deaea90 -#: ../src/Doc/library/hotshot.rst:56 +#: library/hotshot.rst:56 msgid "Add an arbitrary labelled value to the profile output." msgstr "" # c320c3f2803f4f1b81ad9875ac7fd01b -#: ../src/Doc/library/hotshot.rst:61 +#: library/hotshot.rst:61 msgid "Close the logfile and terminate the profiler." msgstr "" # ca3f5a948ec3488c9d1793391fad7af8 -#: ../src/Doc/library/hotshot.rst:66 +#: library/hotshot.rst:66 msgid "Return the file descriptor of the profiler's log file." msgstr "" # f91014720044423490209bce3115ad0f -#: ../src/Doc/library/hotshot.rst:71 +#: library/hotshot.rst:71 msgid "" "Profile an :keyword:`exec`\\ -compatible string in the script environment. " "The globals from the :mod:`__main__` module are used as both the globals and " @@ -47041,7 +47649,7 @@ msgid "" msgstr "" # d2bf9337f84e4a9a9de641ad28cd9668 -#: ../src/Doc/library/hotshot.rst:78 +#: library/hotshot.rst:78 msgid "" "Profile a single call of a callable. Additional positional and keyword " "arguments may be passed along; the result of the call is returned, and " @@ -47050,70 +47658,76 @@ msgid "" msgstr "" # 5d1d6cf0ff2c49f8b69281db49602b34 -#: ../src/Doc/library/hotshot.rst:86 +#: library/hotshot.rst:86 msgid "" "Evaluate an :keyword:`exec`\\ -compatible string in a specific environment. " "The string is compiled before profiling begins." msgstr "" # b98e20dd129c41b1b3b27cc07ce94be3 -#: ../src/Doc/library/hotshot.rst:92 +#: library/hotshot.rst:92 msgid "Start the profiler." msgstr "" # 5aada9d63ef94b568fabd75183572ec0 -#: ../src/Doc/library/hotshot.rst:97 +#: library/hotshot.rst:97 msgid "Stop the profiler." msgstr "" # 590757bd5c02494198f5ecc4239e1802 -#: ../src/Doc/library/hotshot.rst:101 +#: library/hotshot.rst:101 msgid "Using hotshot data" msgstr "" # f2124d8d538149cd86f581053353396f -#: ../src/Doc/library/hotshot.rst:109 +#: library/hotshot.rst:109 msgid "" "This module loads hotshot profiling data into the standard :mod:`pstats` " "Stats objects." msgstr "" # 671a87cdef3a4a0fb2d897249e9e3544 -#: ../src/Doc/library/hotshot.rst:115 +#: library/hotshot.rst:115 msgid "" "Load hotshot data from *filename*. Returns an instance of the :class:`pstats." "Stats` class." msgstr "" -# afb8cdcb9289413ba9136e9d5bf88a4e -#: ../src/Doc/library/hotshot.rst:120 -msgid "Module :mod:`profile`" +#: library/hotshot.rst:121 +msgid "Module profile" msgstr "" # bae7602143e74553a13bd08f45b534fb -#: ../src/Doc/library/hotshot.rst:122 +#: library/hotshot.rst:122 msgid "The :mod:`profile` module's :class:`Stats` class" msgstr "" # 53efdffe5c9142ea927e8d0534c09633 -#: ../src/Doc/library/hotshot.rst:128 +#: library/hotshot.rst:128 msgid "Example Usage" msgstr "" # 47d6dd59746d410a87d5253f83720036 -#: ../src/Doc/library/hotshot.rst:130 +#: library/hotshot.rst:130 msgid "" "Note that this example runs the Python \"benchmark\" pystones. It can take " "some time to run, and will produce large output files. ::" msgstr "" # a2aaa9c4306b4c04b97c7326e28787a0 -#: ../src/Doc/library/htmllib.rst:2 +#: library/htmllib.rst:2 msgid ":mod:`htmllib` --- A parser for HTML documents" msgstr "" +#: library/htmllib.rst:8 +msgid "" +"The :mod:`htmllib` module has been removed in Python 3. Use :mod:" +"`HTMLParser` instead in Python 2, and the equivalent, :mod:`html.parser`, in " +"Python 3." +msgstr "" + # 6cedc70b49c04cee85869db9b3ace32e -#: ../src/Doc/library/htmllib.rst:21 +#: library/htmllib.rst:23 msgid "" "This module defines a class which can serve as a base for parsing text files " "formatted in the HyperText Mark-up Language (HTML). The class is not " @@ -47130,14 +47744,14 @@ msgid "" msgstr "" # 4294160b2f214508895bbd09098c8835 -#: ../src/Doc/library/htmllib.rst:34 +#: library/htmllib.rst:36 msgid "" "The following is a summary of the interface defined by :class:`sgmllib." "SGMLParser`:" msgstr "" # 27ce3f782b784f4ba4dcd2689d62e130 -#: ../src/Doc/library/htmllib.rst:37 +#: library/htmllib.rst:39 msgid "" "The interface to feed data to an instance is through the :meth:`feed` " "method, which takes a string argument. This can be called with as little or " @@ -47149,12 +47763,12 @@ msgid "" msgstr "" # c708a400bbff4b1680eb1daa3cb7db84 -#: ../src/Doc/library/htmllib.rst:44 +#: library/htmllib.rst:46 msgid "For example, to parse the entire contents of a file, use::" msgstr "" # 784700f7a38d44c4ab4df4f3767b6f17 -#: ../src/Doc/library/htmllib.rst:49 +#: library/htmllib.rst:51 msgid "" "The interface to define semantics for HTML tags is very simple: derive a " "class and define methods called :meth:`start_tag`, :meth:`end_tag`, or :meth:" @@ -47168,12 +47782,12 @@ msgid "" msgstr "" # 5956efb628ad4b0ea230fa2a175b5880 -#: ../src/Doc/library/htmllib.rst:59 +#: library/htmllib.rst:61 msgid "The module defines a parser class and an exception:" msgstr "" # 15e1a8adb4524027bc3e07c541b8b486 -#: ../src/Doc/library/htmllib.rst:64 +#: library/htmllib.rst:66 msgid "" "This is the basic HTML parser class. It supports all entity names required " "by the XHTML 1.0 Recommendation (http://www.w3.org/TR/xhtml1). It also " @@ -47181,76 +47795,73 @@ msgid "" msgstr "" # 0942bb9eb69c4eafa1387cd59a1fb9ae -#: ../src/Doc/library/htmllib.rst:71 +#: library/htmllib.rst:73 msgid "" "Exception raised by the :class:`HTMLParser` class when it encounters an " "error while parsing." msgstr "" -# 645ee97b6ceb40fd9c38e9632d224f77 -#: ../src/Doc/library/htmllib.rst:80 -msgid "Module :mod:`formatter`" +#: library/htmllib.rst:83 +msgid "Module formatter" msgstr "" # 277a68ccbb594f8a89f158d681b52c03 -#: ../src/Doc/library/htmllib.rst:80 +#: library/htmllib.rst:82 msgid "" "Interface definition for transforming an abstract flow of formatting events " "into specific output events on writer objects." msgstr "" -# 970bbdfcd70b43868ffa43b67d1f3477 -#: ../src/Doc/library/htmllib.rst:85 -msgid "Module :mod:`HTMLParser`" +#: library/htmllib.rst:88 +msgid "Module HTMLParser" msgstr "" # aed684955ce14b9bb79a49c689e7dd36 -#: ../src/Doc/library/htmllib.rst:84 +#: library/htmllib.rst:86 msgid "" "Alternate HTML parser that offers a slightly lower-level view of the input, " "but is designed to work with XHTML, and does not implement some of the SGML " "syntax not used in \"HTML as deployed\" and which isn't legal for XHTML." msgstr "" -# 813044be80494a29b076f6e60b95b1c9 -#: ../src/Doc/library/htmllib.rst:88 -msgid "Module :mod:`htmlentitydefs`" +#: library/htmllib.rst:91 +msgid "Module htmlentitydefs" msgstr "" # b9a721d127824d0fab47b361632067a8 -#: ../src/Doc/library/htmllib.rst:89 +#: library/htmllib.rst:91 msgid "Definition of replacement text for XHTML 1.0 entities." msgstr "" -# 22b695a9105d4844bb2c922f401e42b8 -#: ../src/Doc/library/htmllib.rst:90 -msgid "Module :mod:`sgmllib`" -msgstr "" +#: library/htmllib.rst:93 +#, fuzzy +msgid "Module sgmllib" +msgstr "Modules" # c632ad5dd8dc43a29cf8e783f4771828 -#: ../src/Doc/library/htmllib.rst:92 +#: library/htmllib.rst:94 msgid "Base class for :class:`HTMLParser`." msgstr "" # fbeaadf66b314e8a9f349032dd363327 -#: ../src/Doc/library/htmllib.rst:98 +#: library/htmllib.rst:100 msgid "HTMLParser Objects" msgstr "" # 1114148d7339493b92b45ae5152ba364 -#: ../src/Doc/library/htmllib.rst:100 +#: library/htmllib.rst:102 msgid "" "In addition to tag methods, the :class:`HTMLParser` class provides some " "additional methods and instance variables for use within tag methods." msgstr "" # 9d7ff49f06c84b2d88cf44084700bae9 -#: ../src/Doc/library/htmllib.rst:106 +#: library/htmllib.rst:108 msgid "This is the formatter instance associated with the parser." msgstr "" # ce9132ce15b248f3bc2ceb2f4212e8ac -#: ../src/Doc/library/htmllib.rst:111 +#: library/htmllib.rst:113 msgid "" "Boolean flag which should be true when whitespace should not be collapsed, " "or false when it should be. In general, this should only be true when " @@ -47260,7 +47871,7 @@ msgid "" msgstr "" # b6241ba8cf2745f8847b9840ab46f853 -#: ../src/Doc/library/htmllib.rst:120 +#: library/htmllib.rst:122 msgid "" "This method is called at the start of an anchor region. The arguments " "correspond to the attributes of the ```` tag with the same names. The " @@ -47270,7 +47881,7 @@ msgid "" msgstr "" # d1f71d29cfce4aa5bd75bc79ae23d67f -#: ../src/Doc/library/htmllib.rst:129 +#: library/htmllib.rst:131 msgid "" "This method is called at the end of an anchor region. The default " "implementation adds a textual footnote marker using an index into the list " @@ -47278,14 +47889,14 @@ msgid "" msgstr "" # 564652e530fd4dd2b49b7cfed6f56a86 -#: ../src/Doc/library/htmllib.rst:136 +#: library/htmllib.rst:138 msgid "" "This method is called to handle images. The default implementation simply " "passes the *alt* value to the :meth:`handle_data` method." msgstr "" # b0bb7d6d073d48b2b011db6a08a052b4 -#: ../src/Doc/library/htmllib.rst:142 +#: library/htmllib.rst:144 msgid "" "Begins saving character data in a buffer instead of sending it to the " "formatter object. Retrieve the stored data via :meth:`save_end`. Use of " @@ -47293,7 +47904,7 @@ msgid "" msgstr "" # 95435916bdc14a69a19d2ea95dafa364 -#: ../src/Doc/library/htmllib.rst:149 +#: library/htmllib.rst:151 msgid "" "Ends buffering character data and returns all data saved since the preceding " "call to :meth:`save_bgn`. If the :attr:`nofill` flag is false, whitespace " @@ -47302,12 +47913,12 @@ msgid "" msgstr "" # cc434a0a8ed8491d93bd4448719fdd86 -#: ../src/Doc/library/htmllib.rst:156 +#: library/htmllib.rst:158 msgid ":mod:`htmlentitydefs` --- Definitions of HTML general entities" msgstr "" # 8264c3d285b549638add420142b4ee43 -#: ../src/Doc/library/htmllib.rst:164 +#: library/htmllib.rst:166 msgid "" "The :mod:`htmlentitydefs` module has been renamed to :mod:`html.entities` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -47315,12 +47926,12 @@ msgid "" msgstr "" # 2631094415414a63b684d1f931022b35 -#: ../src/Doc/library/htmllib.rst:168 +#: library/htmllib.rst:170 msgid "**Source code:** :source:`Lib/htmlentitydefs.py`" msgstr "" # bb3e16e197af4040b31501bc6edd952c -#: ../src/Doc/library/htmllib.rst:172 +#: library/htmllib.rst:174 msgid "" "This module defines three dictionaries, ``name2codepoint``, " "``codepoint2name``, and ``entitydefs``. ``entitydefs`` is used by the :mod:" @@ -47330,27 +47941,27 @@ msgid "" "in the Latin-1 character set (ISO-8859-1)." msgstr "" -#: ../src/Doc/library/htmllib.rst:182 +#: library/htmllib.rst:184 msgid "" "A dictionary mapping XHTML 1.0 entity definitions to their replacement text " "in ISO Latin-1." msgstr "" -#: ../src/Doc/library/htmllib.rst:188 -msgid "A dictionary that maps HTML entity names to the Unicode codepoints." +#: library/htmllib.rst:190 +msgid "A dictionary that maps HTML entity names to the Unicode code points." msgstr "" -#: ../src/Doc/library/htmllib.rst:195 -msgid "A dictionary that maps Unicode codepoints to HTML entity names." +#: library/htmllib.rst:197 +msgid "A dictionary that maps Unicode code points to HTML entity names." msgstr "" # 51dba347d0cc435b98803ad5bf8c7216 -#: ../src/Doc/library/htmlparser.rst:3 +#: library/htmlparser.rst:3 msgid ":mod:`HTMLParser` --- Simple HTML and XHTML parser" msgstr "" # 4e587196563b435f9ff4cdea1627a70b -#: ../src/Doc/library/htmlparser.rst:10 +#: library/htmlparser.rst:10 msgid "" "The :mod:`HTMLParser` module has been renamed to :mod:`html.parser` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -47358,12 +47969,12 @@ msgid "" msgstr "" # 0cf2b51a87724ac6843767d07e7a32cd -#: ../src/Doc/library/htmlparser.rst:21 +#: library/htmlparser.rst:21 msgid "**Source code:** :source:`Lib/HTMLParser.py`" msgstr "" # 1e672bebddf94d26b07a77e20f9c5f37 -#: ../src/Doc/library/htmlparser.rst:25 +#: library/htmlparser.rst:25 msgid "" "This module defines a class :class:`.HTMLParser` which serves as the basis " "for parsing text files formatted in HTML (HyperText Mark-up Language) and " @@ -47372,7 +47983,7 @@ msgid "" msgstr "" # c82279ed9b5d4c4bbfbc34bc75ef00c1 -#: ../src/Doc/library/htmlparser.rst:33 +#: library/htmlparser.rst:33 msgid "" "An :class:`.HTMLParser` instance is fed HTML data and calls handler methods " "when start tags, end tags, text, comments, and other markup elements are " @@ -47381,24 +47992,24 @@ msgid "" msgstr "" # fbc35e7794df41be89d4864c47d1217f -#: ../src/Doc/library/htmlparser.rst:38 +#: library/htmlparser.rst:38 msgid "The :class:`.HTMLParser` class is instantiated without arguments." msgstr "" # ec4333f2b33b4f15a731efb93c2ee81b -#: ../src/Doc/library/htmlparser.rst:40 +#: library/htmlparser.rst:40 msgid "" "Unlike the parser in :mod:`htmllib`, this parser does not check that end " "tags match start tags or call the end-tag handler for elements which are " "closed implicitly by closing an outer element." msgstr "" -#: ../src/Doc/library/htmlparser.rst:44 +#: library/htmlparser.rst:44 msgid "An exception is defined as well:" msgstr "" # ae2b40d0abb24a14a62d23a54ed305ce -#: ../src/Doc/library/htmlparser.rst:48 +#: library/htmlparser.rst:48 msgid "" ":class:`.HTMLParser` is able to handle broken markup, but in some cases it " "might raise this exception when it encounters an error while parsing. This " @@ -47408,12 +48019,12 @@ msgid "" "characters into the line at which the construct starts." msgstr "" -#: ../src/Doc/library/htmlparser.rst:57 +#: library/htmlparser.rst:57 msgid "Example HTML Parser Application" msgstr "" # fe749f33c83946f29a2ccc2119e8fe26 -#: ../src/Doc/library/htmlparser.rst:59 +#: library/htmlparser.rst:59 msgid "" "As a basic example, below is a simple HTML parser that uses the :class:`." "HTMLParser` class to print out start tags, end tags and data as they are " @@ -47421,22 +48032,22 @@ msgid "" msgstr "" # 24fc159da4154a5589d33315ac01ab96 -#: ../src/Doc/library/htmlparser.rst:79 +#: library/htmlparser.rst:79 msgid "The output will then be::" msgstr "" # e8873cde0c7740b9a09723f9709f364e -#: ../src/Doc/library/htmlparser.rst:96 +#: library/htmlparser.rst:96 msgid ":class:`.HTMLParser` Methods" msgstr "" # c5b16ee4aff2429aaac84714c1d22f2f -#: ../src/Doc/library/htmlparser.rst:98 +#: library/htmlparser.rst:98 msgid ":class:`.HTMLParser` instances have the following methods:" msgstr "" # 3004c6a033e341888d177d3aced1dabe -#: ../src/Doc/library/htmlparser.rst:103 +#: library/htmlparser.rst:103 msgid "" "Feed some text to the parser. It is processed insofar as it consists of " "complete elements; incomplete data is buffered until more data is fed or :" @@ -47445,7 +48056,7 @@ msgid "" msgstr "" # 6de9027a47f04c17b98d407babdab4c3 -#: ../src/Doc/library/htmlparser.rst:111 +#: library/htmlparser.rst:111 msgid "" "Force processing of all buffered data as if it were followed by an end-of-" "file mark. This method may be redefined by a derived class to define " @@ -47453,17 +48064,17 @@ msgid "" "should always call the :class:`.HTMLParser` base class method :meth:`close`." msgstr "" -#: ../src/Doc/library/htmlparser.rst:119 ../src/Doc/library/sgmllib.rst:52 +#: library/htmlparser.rst:119 library/sgmllib.rst:52 msgid "" "Reset the instance. Loses all unprocessed data. This is called implicitly " "at instantiation time." msgstr "" -#: ../src/Doc/library/htmlparser.rst:125 +#: library/htmlparser.rst:125 msgid "Return current line number and offset." msgstr "" -#: ../src/Doc/library/htmlparser.rst:130 ../src/Doc/library/sgmllib.rst:84 +#: library/htmlparser.rst:130 library/sgmllib.rst:84 msgid "" "Return the text of the most recently opened start tag. This should not " "normally be needed for structured processing, but may be useful in dealing " @@ -47472,7 +48083,7 @@ msgid "" msgstr "" # 0fa93ff4a64b4eed9ed6b2d85d34ae31 -#: ../src/Doc/library/htmlparser.rst:136 +#: library/htmlparser.rst:136 msgid "" "The following methods are called when data or markup elements are " "encountered and they are meant to be overridden in a subclass. The base " @@ -47481,14 +48092,14 @@ msgid "" msgstr "" # 50d38753944c4e11bdbad3ea9ab0dee5 -#: ../src/Doc/library/htmlparser.rst:143 +#: library/htmlparser.rst:143 msgid "" "This method is called to handle the start of a tag (e.g. ````)." msgstr "" # c143554cb2b94878ae2e0f9c064f8e17 -#: ../src/Doc/library/htmlparser.rst:163 +#: library/htmlparser.rst:163 msgid "The *tag* argument is the name of the tag converted to lower case." msgstr "" # 3ec13ea856bf4efea82838f95be838b6 -#: ../src/Doc/library/htmlparser.rst:168 +#: library/htmlparser.rst:168 msgid "" "Similar to :meth:`handle_starttag`, but called when the parser encounters an " "XHTML-style empty tag (````). This method may be overridden by " @@ -47527,14 +48144,14 @@ msgid "" msgstr "" # 8ef41df4b9654d2c9b82ac2f2aa245e9 -#: ../src/Doc/library/htmlparser.rst:176 +#: library/htmlparser.rst:176 msgid "" "This method is called to process arbitrary data (e.g. text nodes and the " "content of ```` and ````)." msgstr "" # f90e1cadd8864a278aa183730a9e648d -#: ../src/Doc/library/htmlparser.rst:182 +#: library/htmlparser.rst:182 msgid "" "This method is called to process a named character reference of the form " "``&name;`` (e.g. ``>``), where *name* is a general entity reference (e.g. " @@ -47542,7 +48159,7 @@ msgid "" msgstr "" # 61d9326ce9e0458195220570bb03152d -#: ../src/Doc/library/htmlparser.rst:189 +#: library/htmlparser.rst:189 msgid "" "This method is called to process decimal and hexadecimal numeric character " "references of the form ``&#NNN;`` and ``&#xNNN;``. For example, the decimal " @@ -47551,44 +48168,43 @@ msgid "" msgstr "" # e2f1625e9ed1462e9b722bba44f3cbd1 -#: ../src/Doc/library/htmlparser.rst:197 +#: library/htmlparser.rst:197 msgid "" "This method is called when a comment is encountered (e.g. ```` will cause this method to be " "called with the argument ``' comment '``." msgstr "" -# e35cdfe0e9a74ce4ad9d06ddae728809 -#: ../src/Doc/library/htmlparser.rst:202 +#: library/htmlparser.rst:202 msgid "" "The content of Internet Explorer conditional comments (condcoms) will also " "be sent to this method, so, for ````, this method will receive ``'[if IE 9]>IE-specific content``, this method will receive ``'[if IE 9]>IE9-specific content``)." msgstr "" # ea3d35cc49c24421b9648ff07ecbd7e3 -#: ../src/Doc/library/htmlparser.rst:212 +#: library/htmlparser.rst:212 msgid "" "The *decl* parameter will be the entire contents of the declaration inside " "the ```` markup (e.g. ``'DOCTYPE html'``)." msgstr "" # 58f775cb6a8a43158452a3aacd3acbea -#: ../src/Doc/library/htmlparser.rst:218 +#: library/htmlparser.rst:218 msgid "" "This method is called when a processing instruction is encountered. The " "*data* parameter will contain the entire processing instruction. For " @@ -47597,7 +48213,7 @@ msgid "" msgstr "" # 9b1107aa46d94ba9b7491fa1ab5eedb5 -#: ../src/Doc/library/htmlparser.rst:225 +#: library/htmlparser.rst:225 msgid "" "The :class:`.HTMLParser` class uses the SGML syntactic rules for processing " "instructions. An XHTML processing instruction using the trailing ``'?'`` " @@ -47605,13 +48221,13 @@ msgid "" msgstr "" # 382968474b71455a85d65c5bb082e70e -#: ../src/Doc/library/htmlparser.rst:232 +#: library/htmlparser.rst:232 msgid "" "This method is called when an unrecognized declaration is read by the parser." msgstr "" # dad129ed801448f99f5716af9ffce8c2 -#: ../src/Doc/library/htmlparser.rst:234 +#: library/htmlparser.rst:234 msgid "" "The *data* parameter will be the entire contents of the declaration inside " "the ```` markup. It is sometimes useful to be overridden by a " @@ -47619,60 +48235,60 @@ msgid "" msgstr "" # 078762b30b8a4e0fb4110b17fb5834b5 -#: ../src/Doc/library/htmlparser.rst:244 +#: library/htmlparser.rst:244 msgid "" "The following class implements a parser that will be used to illustrate more " "examples::" msgstr "" # a897ea32917a41b3b46e4d2d2c9f4d35 -#: ../src/Doc/library/htmlparser.rst:275 +#: library/htmlparser.rst:275 msgid "Parsing a doctype::" msgstr "" # 984af65430ab4c9c9360c87e38ee366d -#: ../src/Doc/library/htmlparser.rst:281 +#: library/htmlparser.rst:281 msgid "Parsing an element with a few attributes and a title::" msgstr "" # 4f9c7c95745e491481eb6166dd96f284 -#: ../src/Doc/library/htmlparser.rst:293 +#: library/htmlparser.rst:293 msgid "" "The content of ``script`` and ``style`` elements is returned as is, without " "further parsing::" msgstr "" # 84ce805230044509a535ff05256ca25c -#: ../src/Doc/library/htmlparser.rst:309 +#: library/htmlparser.rst:309 msgid "Parsing comments::" msgstr "" # a13ada51e10b4bc99669c2922ea4a89d -#: ../src/Doc/library/htmlparser.rst:316 +#: library/htmlparser.rst:316 msgid "" "Parsing named and numeric character references and converting them to the " "correct char (note: these 3 references are all equivalent to ``'>'``)::" msgstr "" # 33ae415f70eb40199e41748ea71d1a9c -#: ../src/Doc/library/htmlparser.rst:324 +#: library/htmlparser.rst:324 msgid "" "Feeding incomplete chunks to :meth:`~HTMLParser.feed` works, but :meth:" "`~HTMLParser.handle_data` might be called more than once::" msgstr "" # a0bc963ed6854c52a808578eb6465f95 -#: ../src/Doc/library/htmlparser.rst:336 +#: library/htmlparser.rst:336 msgid "Parsing invalid HTML (e.g. unquoted attributes) also works::" msgstr "" # e3429701f76f470c9a1f61400ac7458b -#: ../src/Doc/library/httplib.rst:2 +#: library/httplib.rst:2 msgid ":mod:`httplib` --- HTTP protocol client" msgstr "" # 785e4527dd7a4b4487bf13b5a116322c -#: ../src/Doc/library/httplib.rst:8 +#: library/httplib.rst:8 msgid "" "The :mod:`httplib` module has been renamed to :mod:`http.client` in Python " "3. The :term:`2to3` tool will automatically adapt imports when converting " @@ -47680,26 +48296,32 @@ msgid "" msgstr "" # bd3462d9420a4e1599e3760afd563128 -#: ../src/Doc/library/httplib.rst:19 +#: library/httplib.rst:19 msgid "**Source code:** :source:`Lib/httplib.py`" msgstr "" # 25c670776d87461caad96b2b8e9063c7 -#: ../src/Doc/library/httplib.rst:23 +#: library/httplib.rst:23 msgid "" "This module defines classes which implement the client side of the HTTP and " "HTTPS protocols. It is normally not used directly --- the module :mod:" "`urllib` uses it to handle URLs that use HTTP and HTTPS." msgstr "" -#: ../src/Doc/library/httplib.rst:29 +#: library/httplib.rst:29 library/urllib.rst:29 library/urllib2.rst:23 +msgid "" +"The `Requests package `_ is recommended " +"for a higher-level http client interface." +msgstr "" + +#: library/httplib.rst:34 msgid "" "HTTPS support is only available if the :mod:`socket` module was compiled " "with SSL support." msgstr "" # 330f090ce769450bb830a59dc8d877d7 -#: ../src/Doc/library/httplib.rst:34 +#: library/httplib.rst:39 msgid "" "The public interface for this module changed substantially in Python 2.0. " "The :class:`HTTP` class is retained only for backward compatibility with " @@ -47707,12 +48329,12 @@ msgid "" "for usage." msgstr "" -#: ../src/Doc/library/httplib.rst:38 +#: library/httplib.rst:43 msgid "The module provides the following classes:" msgstr "" # 3fb2ef2fc9824474822fa66dc6f87e8d -#: ../src/Doc/library/httplib.rst:43 +#: library/httplib.rst:48 msgid "" "An :class:`HTTPConnection` instance represents one transaction with an HTTP " "server. It should be instantiated passing it a host and optional port " @@ -47728,33 +48350,54 @@ msgid "" "made from." msgstr "" -#: ../src/Doc/library/httplib.rst:56 +#: library/httplib.rst:61 msgid "" "For example, the following calls all create instances that connect to the " "server at the same host and port::" msgstr "" -#: ../src/Doc/library/httplib.rst:75 +#: library/httplib.rst:74 library/httplib.rst:96 library/socket.rst:229 +msgid "*source_address* was added." +msgstr "" + +#: library/httplib.rst:80 msgid "" "A subclass of :class:`HTTPConnection` that uses SSL for communication with " -"secure servers. Default port is ``443``. *key_file* is the name of a PEM " -"formatted file that contains your private key. *cert_file* is a PEM " -"formatted certificate chain file." +"secure servers. Default port is ``443``. If *context* is specified, it " +"must be a :class:`ssl.SSLContext` instance describing the various SSL " +"options." msgstr "" -# 4074f1c7d43d458d8648d77cdccf0460 -#: ../src/Doc/library/httplib.rst:81 -msgid "This does not do any verification of the server's certificate." +#: library/httplib.rst:84 +msgid "" +"*key_file* and *cert_file* are deprecated, please use :meth:`ssl.SSLContext." +"load_cert_chain` instead, or let :func:`ssl.create_default_context` select " +"the system's trusted CA certificates for you." msgstr "" -#: ../src/Doc/library/httplib.rst:94 +#: library/httplib.rst:89 +msgid "Please read :ref:`ssl-security` for more information on best practices." +msgstr "" + +#: library/httplib.rst:99 +msgid "*context* was added." +msgstr "" + +#: library/httplib.rst:102 +msgid "" +"This class now performs all the necessary certificate and hostname checks by " +"default. To revert to the previous, unverified, behavior :func:`ssl." +"_create_unverified_context` can be passed to the *context* parameter." +msgstr "" + +#: library/httplib.rst:110 msgid "" "Class whose instances are returned upon successful connection. Not " "instantiated directly by user." msgstr "" # b7aefb09362e4d9bb301ff77d643f040 -#: ../src/Doc/library/httplib.rst:101 +#: library/httplib.rst:117 msgid "" "An :class:`HTTPMessage` instance is used to hold the headers from an HTTP " "response. It is implemented using the :class:`mimetools.Message` class and " @@ -47762,816 +48405,826 @@ msgid "" "instantiated by the users." msgstr "" -#: ../src/Doc/library/httplib.rst:107 ../src/Doc/library/urllib2.rst:101 +#: library/httplib.rst:123 library/urllib2.rst:118 msgid "The following exceptions are raised as appropriate:" msgstr "" -#: ../src/Doc/library/httplib.rst:112 +#: library/httplib.rst:128 msgid "" "The base class of the other exceptions in this module. It is a subclass of :" "exc:`Exception`." msgstr "" -#: ../src/Doc/library/httplib.rst:120 ../src/Doc/library/httplib.rst:135 -#: ../src/Doc/library/httplib.rst:142 ../src/Doc/library/httplib.rst:149 -#: ../src/Doc/library/httplib.rst:156 ../src/Doc/library/httplib.rst:163 +#: library/httplib.rst:136 library/httplib.rst:151 library/httplib.rst:158 +#: library/httplib.rst:165 library/httplib.rst:172 library/httplib.rst:179 msgid "A subclass of :exc:`HTTPException`." msgstr "" -#: ../src/Doc/library/httplib.rst:127 +#: library/httplib.rst:143 msgid "" "A subclass of :exc:`HTTPException`, raised if a port is given and is either " "non-numeric or empty." msgstr "" -#: ../src/Doc/library/httplib.rst:170 ../src/Doc/library/httplib.rst:177 -#: ../src/Doc/library/httplib.rst:184 +#: library/httplib.rst:186 library/httplib.rst:193 library/httplib.rst:200 msgid "A subclass of :exc:`ImproperConnectionState`." msgstr "" -#: ../src/Doc/library/httplib.rst:191 +#: library/httplib.rst:207 msgid "" "A subclass of :exc:`HTTPException`. Raised if a server responds with a HTTP " "status code that we don't understand." msgstr "" -#: ../src/Doc/library/httplib.rst:196 ../src/Doc/library/string.rst:27 +#: library/httplib.rst:212 library/string.rst:27 msgid "The constants defined in this module are:" msgstr "" -#: ../src/Doc/library/httplib.rst:201 +#: library/httplib.rst:217 msgid "The default port for the HTTP protocol (always ``80``)." msgstr "" -#: ../src/Doc/library/httplib.rst:206 +#: library/httplib.rst:222 msgid "The default port for the HTTPS protocol (always ``443``)." msgstr "" -#: ../src/Doc/library/httplib.rst:208 +#: library/httplib.rst:224 msgid "and also the following constants for integer status codes:" msgstr "" -#: ../src/Doc/library/httplib.rst:211 +#: library/httplib.rst:227 msgid "Definition" msgstr "" -#: ../src/Doc/library/httplib.rst:213 +#: library/httplib.rst:229 msgid ":const:`CONTINUE`" msgstr "" -#: ../src/Doc/library/httplib.rst:213 +#: library/httplib.rst:229 msgid "``100``" msgstr "" -#: ../src/Doc/library/httplib.rst:213 +#: library/httplib.rst:229 msgid "" "HTTP/1.1, `RFC 2616, Section 10.1.1 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:217 +#: library/httplib.rst:233 msgid ":const:`SWITCHING_PROTOCOLS`" msgstr "" -#: ../src/Doc/library/httplib.rst:217 +#: library/httplib.rst:233 msgid "``101``" msgstr "" -#: ../src/Doc/library/httplib.rst:217 +#: library/httplib.rst:233 msgid "" "HTTP/1.1, `RFC 2616, Section 10.1.2 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:221 +#: library/httplib.rst:237 msgid ":const:`PROCESSING`" msgstr "" -#: ../src/Doc/library/httplib.rst:221 +#: library/httplib.rst:237 msgid "``102``" msgstr "" -#: ../src/Doc/library/httplib.rst:221 +#: library/httplib.rst:237 msgid "" "WEBDAV, `RFC 2518, Section 10.1 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:224 +#: library/httplib.rst:240 msgid ":const:`OK`" msgstr "" -#: ../src/Doc/library/httplib.rst:224 +#: library/httplib.rst:240 msgid "``200``" msgstr "" -#: ../src/Doc/library/httplib.rst:224 +#: library/httplib.rst:240 msgid "" "HTTP/1.1, `RFC 2616, Section 10.2.1 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:228 +#: library/httplib.rst:244 msgid ":const:`CREATED`" msgstr "" -#: ../src/Doc/library/httplib.rst:228 +#: library/httplib.rst:244 msgid "``201``" msgstr "" -#: ../src/Doc/library/httplib.rst:228 +#: library/httplib.rst:244 msgid "" "HTTP/1.1, `RFC 2616, Section 10.2.2 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:232 +#: library/httplib.rst:248 msgid ":const:`ACCEPTED`" msgstr "" -#: ../src/Doc/library/httplib.rst:232 +#: library/httplib.rst:248 msgid "``202``" msgstr "" -#: ../src/Doc/library/httplib.rst:232 +#: library/httplib.rst:248 msgid "" "HTTP/1.1, `RFC 2616, Section 10.2.3 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:236 +#: library/httplib.rst:252 msgid ":const:`NON_AUTHORITATIVE_INFORMATION`" msgstr "" -#: ../src/Doc/library/httplib.rst:236 +#: library/httplib.rst:252 msgid "``203``" msgstr "" -#: ../src/Doc/library/httplib.rst:236 +#: library/httplib.rst:252 msgid "" "HTTP/1.1, `RFC 2616, Section 10.2.4 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:240 +#: library/httplib.rst:256 msgid ":const:`NO_CONTENT`" msgstr "" -#: ../src/Doc/library/httplib.rst:240 +#: library/httplib.rst:256 msgid "``204``" msgstr "" -#: ../src/Doc/library/httplib.rst:240 +#: library/httplib.rst:256 msgid "" "HTTP/1.1, `RFC 2616, Section 10.2.5 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:244 +#: library/httplib.rst:260 msgid ":const:`RESET_CONTENT`" msgstr "" -#: ../src/Doc/library/httplib.rst:244 +#: library/httplib.rst:260 msgid "``205``" msgstr "" -#: ../src/Doc/library/httplib.rst:244 +#: library/httplib.rst:260 msgid "" "HTTP/1.1, `RFC 2616, Section 10.2.6 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:248 +#: library/httplib.rst:264 msgid ":const:`PARTIAL_CONTENT`" msgstr "" -#: ../src/Doc/library/httplib.rst:248 +#: library/httplib.rst:264 msgid "``206``" msgstr "" -#: ../src/Doc/library/httplib.rst:248 +#: library/httplib.rst:264 msgid "" "HTTP/1.1, `RFC 2616, Section 10.2.7 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:252 +#: library/httplib.rst:268 msgid ":const:`MULTI_STATUS`" msgstr "" -#: ../src/Doc/library/httplib.rst:252 +#: library/httplib.rst:268 msgid "``207``" msgstr "" -#: ../src/Doc/library/httplib.rst:252 +#: library/httplib.rst:268 msgid "" "WEBDAV `RFC 2518, Section 10.2 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:255 +#: library/httplib.rst:271 msgid ":const:`IM_USED`" msgstr "" -#: ../src/Doc/library/httplib.rst:255 +#: library/httplib.rst:271 msgid "``226``" msgstr "" -#: ../src/Doc/library/httplib.rst:255 +#: library/httplib.rst:271 msgid "Delta encoding in HTTP, :rfc:`3229`, Section 10.4.1" msgstr "" -#: ../src/Doc/library/httplib.rst:258 +#: library/httplib.rst:274 msgid ":const:`MULTIPLE_CHOICES`" msgstr "" -#: ../src/Doc/library/httplib.rst:258 +#: library/httplib.rst:274 msgid "``300``" msgstr "" -#: ../src/Doc/library/httplib.rst:258 +#: library/httplib.rst:274 msgid "" "HTTP/1.1, `RFC 2616, Section 10.3.1 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:262 +#: library/httplib.rst:278 msgid ":const:`MOVED_PERMANENTLY`" msgstr "" -#: ../src/Doc/library/httplib.rst:262 +#: library/httplib.rst:278 msgid "``301``" msgstr "" -#: ../src/Doc/library/httplib.rst:262 +#: library/httplib.rst:278 msgid "" "HTTP/1.1, `RFC 2616, Section 10.3.2 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:266 +#: library/httplib.rst:282 msgid ":const:`FOUND`" msgstr "" -#: ../src/Doc/library/httplib.rst:266 +#: library/httplib.rst:282 msgid "``302``" msgstr "" -#: ../src/Doc/library/httplib.rst:266 +#: library/httplib.rst:282 msgid "" "HTTP/1.1, `RFC 2616, Section 10.3.3 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:270 +#: library/httplib.rst:286 msgid ":const:`SEE_OTHER`" msgstr "" -#: ../src/Doc/library/httplib.rst:270 +#: library/httplib.rst:286 msgid "``303``" msgstr "" -#: ../src/Doc/library/httplib.rst:270 +#: library/httplib.rst:286 msgid "" "HTTP/1.1, `RFC 2616, Section 10.3.4 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:274 +#: library/httplib.rst:290 msgid ":const:`NOT_MODIFIED`" msgstr "" -#: ../src/Doc/library/httplib.rst:274 +#: library/httplib.rst:290 msgid "``304``" msgstr "" -#: ../src/Doc/library/httplib.rst:274 +#: library/httplib.rst:290 msgid "" "HTTP/1.1, `RFC 2616, Section 10.3.5 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:278 +#: library/httplib.rst:294 msgid ":const:`USE_PROXY`" msgstr "" -#: ../src/Doc/library/httplib.rst:278 +#: library/httplib.rst:294 msgid "``305``" msgstr "" -#: ../src/Doc/library/httplib.rst:278 +#: library/httplib.rst:294 msgid "" "HTTP/1.1, `RFC 2616, Section 10.3.6 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:282 +#: library/httplib.rst:298 msgid ":const:`TEMPORARY_REDIRECT`" msgstr "" -#: ../src/Doc/library/httplib.rst:282 +#: library/httplib.rst:298 msgid "``307``" msgstr "" -#: ../src/Doc/library/httplib.rst:282 +#: library/httplib.rst:298 msgid "" "HTTP/1.1, `RFC 2616, Section 10.3.8 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:286 +#: library/httplib.rst:302 msgid ":const:`BAD_REQUEST`" msgstr "" -#: ../src/Doc/library/httplib.rst:286 +#: library/httplib.rst:302 msgid "``400``" msgstr "" -#: ../src/Doc/library/httplib.rst:286 +#: library/httplib.rst:302 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.1 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:290 +#: library/httplib.rst:306 msgid ":const:`UNAUTHORIZED`" msgstr "" -#: ../src/Doc/library/httplib.rst:290 +#: library/httplib.rst:306 msgid "``401``" msgstr "" -#: ../src/Doc/library/httplib.rst:290 +#: library/httplib.rst:306 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.2 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:294 +#: library/httplib.rst:310 msgid ":const:`PAYMENT_REQUIRED`" msgstr "" -#: ../src/Doc/library/httplib.rst:294 +#: library/httplib.rst:310 msgid "``402``" msgstr "" -#: ../src/Doc/library/httplib.rst:294 +#: library/httplib.rst:310 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.3 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:298 +#: library/httplib.rst:314 msgid ":const:`FORBIDDEN`" msgstr "" -#: ../src/Doc/library/httplib.rst:298 +#: library/httplib.rst:314 msgid "``403``" msgstr "" -#: ../src/Doc/library/httplib.rst:298 +#: library/httplib.rst:314 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.4 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:302 +#: library/httplib.rst:318 msgid ":const:`NOT_FOUND`" msgstr "" -#: ../src/Doc/library/httplib.rst:302 +#: library/httplib.rst:318 msgid "``404``" msgstr "" -#: ../src/Doc/library/httplib.rst:302 +#: library/httplib.rst:318 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.5 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:306 +#: library/httplib.rst:322 msgid ":const:`METHOD_NOT_ALLOWED`" msgstr "" -#: ../src/Doc/library/httplib.rst:306 +#: library/httplib.rst:322 msgid "``405``" msgstr "" -#: ../src/Doc/library/httplib.rst:306 +#: library/httplib.rst:322 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.6 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:310 +#: library/httplib.rst:326 msgid ":const:`NOT_ACCEPTABLE`" msgstr "" -#: ../src/Doc/library/httplib.rst:310 +#: library/httplib.rst:326 msgid "``406``" msgstr "" -#: ../src/Doc/library/httplib.rst:310 +#: library/httplib.rst:326 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.7 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:314 +#: library/httplib.rst:330 msgid ":const:`PROXY_AUTHENTICATION_REQUIRED`" msgstr "" -#: ../src/Doc/library/httplib.rst:314 +#: library/httplib.rst:330 msgid "``407``" msgstr "" -#: ../src/Doc/library/httplib.rst:314 +#: library/httplib.rst:330 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.8 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:318 +#: library/httplib.rst:334 msgid ":const:`REQUEST_TIMEOUT`" msgstr "" -#: ../src/Doc/library/httplib.rst:318 +#: library/httplib.rst:334 msgid "``408``" msgstr "" -#: ../src/Doc/library/httplib.rst:318 +#: library/httplib.rst:334 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.9 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:322 +#: library/httplib.rst:338 msgid ":const:`CONFLICT`" msgstr "" -#: ../src/Doc/library/httplib.rst:322 +#: library/httplib.rst:338 msgid "``409``" msgstr "" -#: ../src/Doc/library/httplib.rst:322 +#: library/httplib.rst:338 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.10 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:326 +#: library/httplib.rst:342 msgid ":const:`GONE`" msgstr "" -#: ../src/Doc/library/httplib.rst:326 +#: library/httplib.rst:342 msgid "``410``" msgstr "" -#: ../src/Doc/library/httplib.rst:326 +#: library/httplib.rst:342 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.11 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:330 +#: library/httplib.rst:346 msgid ":const:`LENGTH_REQUIRED`" msgstr "" -#: ../src/Doc/library/httplib.rst:330 +#: library/httplib.rst:346 msgid "``411``" msgstr "" -#: ../src/Doc/library/httplib.rst:330 +#: library/httplib.rst:346 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.12 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:334 +#: library/httplib.rst:350 msgid ":const:`PRECONDITION_FAILED`" msgstr "" -#: ../src/Doc/library/httplib.rst:334 +#: library/httplib.rst:350 msgid "``412``" msgstr "" -#: ../src/Doc/library/httplib.rst:334 +#: library/httplib.rst:350 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.13 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:338 +#: library/httplib.rst:354 msgid ":const:`REQUEST_ENTITY_TOO_LARGE`" msgstr "" -#: ../src/Doc/library/httplib.rst:338 +#: library/httplib.rst:354 msgid "``413``" msgstr "" -#: ../src/Doc/library/httplib.rst:338 +#: library/httplib.rst:354 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.14 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:342 +#: library/httplib.rst:358 msgid ":const:`REQUEST_URI_TOO_LONG`" msgstr "" -#: ../src/Doc/library/httplib.rst:342 +#: library/httplib.rst:358 msgid "``414``" msgstr "" -#: ../src/Doc/library/httplib.rst:342 +#: library/httplib.rst:358 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.15 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:346 +#: library/httplib.rst:362 msgid ":const:`UNSUPPORTED_MEDIA_TYPE`" msgstr "" -#: ../src/Doc/library/httplib.rst:346 +#: library/httplib.rst:362 msgid "``415``" msgstr "" -#: ../src/Doc/library/httplib.rst:346 +#: library/httplib.rst:362 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.16 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:350 +#: library/httplib.rst:366 msgid ":const:`REQUESTED_RANGE_NOT_SATISFIABLE`" msgstr "" -#: ../src/Doc/library/httplib.rst:350 +#: library/httplib.rst:366 msgid "``416``" msgstr "" -#: ../src/Doc/library/httplib.rst:350 +#: library/httplib.rst:366 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.17 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:354 +#: library/httplib.rst:370 msgid ":const:`EXPECTATION_FAILED`" msgstr "" -#: ../src/Doc/library/httplib.rst:354 +#: library/httplib.rst:370 msgid "``417``" msgstr "" -#: ../src/Doc/library/httplib.rst:354 +#: library/httplib.rst:370 msgid "" "HTTP/1.1, `RFC 2616, Section 10.4.18 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:358 +#: library/httplib.rst:374 msgid ":const:`UNPROCESSABLE_ENTITY`" msgstr "" -#: ../src/Doc/library/httplib.rst:358 +#: library/httplib.rst:374 msgid "``422``" msgstr "" -#: ../src/Doc/library/httplib.rst:358 +#: library/httplib.rst:374 msgid "" "WEBDAV, `RFC 2518, Section 10.3 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:361 +#: library/httplib.rst:377 msgid ":const:`LOCKED`" msgstr "" -#: ../src/Doc/library/httplib.rst:361 +#: library/httplib.rst:377 msgid "``423``" msgstr "" -#: ../src/Doc/library/httplib.rst:361 +#: library/httplib.rst:377 msgid "" "WEBDAV `RFC 2518, Section 10.4 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:364 +#: library/httplib.rst:380 msgid ":const:`FAILED_DEPENDENCY`" msgstr "" -#: ../src/Doc/library/httplib.rst:364 +#: library/httplib.rst:380 msgid "``424``" msgstr "" -#: ../src/Doc/library/httplib.rst:364 +#: library/httplib.rst:380 msgid "" "WEBDAV, `RFC 2518, Section 10.5 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:367 +#: library/httplib.rst:383 msgid ":const:`UPGRADE_REQUIRED`" msgstr "" -#: ../src/Doc/library/httplib.rst:367 +#: library/httplib.rst:383 msgid "``426``" msgstr "" -#: ../src/Doc/library/httplib.rst:367 +#: library/httplib.rst:383 msgid "HTTP Upgrade to TLS, :rfc:`2817`, Section 6" msgstr "" -#: ../src/Doc/library/httplib.rst:370 +#: library/httplib.rst:386 msgid ":const:`INTERNAL_SERVER_ERROR`" msgstr "" -#: ../src/Doc/library/httplib.rst:370 +#: library/httplib.rst:386 msgid "``500``" msgstr "" -#: ../src/Doc/library/httplib.rst:370 +#: library/httplib.rst:386 msgid "" "HTTP/1.1, `RFC 2616, Section 10.5.1 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:374 +#: library/httplib.rst:390 msgid ":const:`NOT_IMPLEMENTED`" msgstr "" -#: ../src/Doc/library/httplib.rst:374 +#: library/httplib.rst:390 msgid "``501``" msgstr "" -#: ../src/Doc/library/httplib.rst:374 +#: library/httplib.rst:390 msgid "" "HTTP/1.1, `RFC 2616, Section 10.5.2 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:378 +#: library/httplib.rst:394 msgid ":const:`BAD_GATEWAY`" msgstr "" -#: ../src/Doc/library/httplib.rst:378 +#: library/httplib.rst:394 msgid "``502``" msgstr "" -#: ../src/Doc/library/httplib.rst:378 +#: library/httplib.rst:394 msgid "" "HTTP/1.1 `RFC 2616, Section 10.5.3 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:382 +#: library/httplib.rst:398 msgid ":const:`SERVICE_UNAVAILABLE`" msgstr "" -#: ../src/Doc/library/httplib.rst:382 +#: library/httplib.rst:398 msgid "``503``" msgstr "" -#: ../src/Doc/library/httplib.rst:382 +#: library/httplib.rst:398 msgid "" "HTTP/1.1, `RFC 2616, Section 10.5.4 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:386 +#: library/httplib.rst:402 msgid ":const:`GATEWAY_TIMEOUT`" msgstr "" -#: ../src/Doc/library/httplib.rst:386 +#: library/httplib.rst:402 msgid "``504``" msgstr "" -#: ../src/Doc/library/httplib.rst:386 +#: library/httplib.rst:402 msgid "" "HTTP/1.1 `RFC 2616, Section 10.5.5 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:390 +#: library/httplib.rst:406 msgid ":const:`HTTP_VERSION_NOT_SUPPORTED`" msgstr "" -#: ../src/Doc/library/httplib.rst:390 +#: library/httplib.rst:406 msgid "``505``" msgstr "" -#: ../src/Doc/library/httplib.rst:390 +#: library/httplib.rst:406 msgid "" "HTTP/1.1, `RFC 2616, Section 10.5.6 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:394 +#: library/httplib.rst:410 msgid ":const:`INSUFFICIENT_STORAGE`" msgstr "" -#: ../src/Doc/library/httplib.rst:394 +#: library/httplib.rst:410 msgid "``507``" msgstr "" -#: ../src/Doc/library/httplib.rst:394 +#: library/httplib.rst:410 msgid "" "WEBDAV, `RFC 2518, Section 10.6 `_" msgstr "" -#: ../src/Doc/library/httplib.rst:397 +#: library/httplib.rst:413 msgid ":const:`NOT_EXTENDED`" msgstr "" -#: ../src/Doc/library/httplib.rst:397 +#: library/httplib.rst:413 msgid "``510``" msgstr "" -#: ../src/Doc/library/httplib.rst:397 +#: library/httplib.rst:413 msgid "An HTTP Extension Framework, :rfc:`2774`, Section 7" msgstr "" -#: ../src/Doc/library/httplib.rst:404 +#: library/httplib.rst:420 msgid "This dictionary maps the HTTP 1.1 status codes to the W3C names." msgstr "" # 1e03d0c8772448e1b0fc038f28fd3c48 -#: ../src/Doc/library/httplib.rst:406 +#: library/httplib.rst:422 msgid "Example: ``httplib.responses[httplib.NOT_FOUND]`` is ``'Not Found'``." msgstr "" -#: ../src/Doc/library/httplib.rst:414 +#: library/httplib.rst:430 msgid "HTTPConnection Objects" msgstr "" -#: ../src/Doc/library/httplib.rst:416 +#: library/httplib.rst:432 msgid ":class:`HTTPConnection` instances have the following methods:" msgstr "" -# a4a87825d3954fa89790cc3156cc8a62 -#: ../src/Doc/library/httplib.rst:421 +#: library/httplib.rst:437 msgid "" "This will send a request to the server using the HTTP request method " "*method* and the selector *url*. If the *body* argument is present, it " "should be a string of data to send after the headers are finished. " "Alternatively, it may be an open file object, in which case the contents of " "the file is sent; this file object should support ``fileno()`` and " -"``read()`` methods. The header Content-Length is automatically set to the " -"correct value. The *headers* argument should be a mapping of extra HTTP " +"``read()`` methods. The *headers* argument should be a mapping of extra HTTP " "headers to send with the request." msgstr "" -#: ../src/Doc/library/httplib.rst:435 +#: library/httplib.rst:445 +msgid "" +"If one is not provided in *headers*, a ``Content-Length`` header is added " +"automatically for all methods if the length of the body can be determined, " +"either from the length of the ``str`` representation, or from the reported " +"size of the file on disk. If *body* is ``None`` the header is not set except " +"for methods that expect a body (``PUT``, ``POST``, and ``PATCH``) in which " +"case it is set to ``0``." +msgstr "" + +#: library/httplib.rst:452 +msgid "*body* can be a file object." +msgstr "" + +#: library/httplib.rst:458 msgid "" "Should be called after a request is sent to get the response from the " "server. Returns an :class:`HTTPResponse` instance." msgstr "" -#: ../src/Doc/library/httplib.rst:440 +#: library/httplib.rst:463 msgid "" "Note that you must have read the whole response before you can send a new " "request to the server." msgstr "" -#: ../src/Doc/library/httplib.rst:446 +#: library/httplib.rst:469 msgid "" "Set the debugging level (the amount of debugging output printed). The " "default debug level is ``0``, meaning no debugging output is printed." msgstr "" # 17e8e51f6db94939a068fa06e966172f -#: ../src/Doc/library/httplib.rst:452 +#: library/httplib.rst:475 msgid "" "Set the host and the port for HTTP Connect Tunnelling. Normally used when it " "is required to do HTTPS Conection through a proxy server." msgstr "" # f0f3ab00dbf94766bfa67b2d995ad694 -#: ../src/Doc/library/httplib.rst:455 +#: library/httplib.rst:478 msgid "" "The headers argument should be a mapping of extra HTTP headers to send with " "the CONNECT request." msgstr "" -#: ../src/Doc/library/httplib.rst:463 +#: library/httplib.rst:486 msgid "Connect to the server specified when the object was created." msgstr "" -#: ../src/Doc/library/httplib.rst:468 +#: library/httplib.rst:491 msgid "Close the connection to the server." msgstr "" -#: ../src/Doc/library/httplib.rst:470 +#: library/httplib.rst:493 msgid "" "As an alternative to using the :meth:`request` method described above, you " "can also send your request step by step, by using the four functions below." msgstr "" -#: ../src/Doc/library/httplib.rst:476 +#: library/httplib.rst:499 msgid "" "This should be the first call after the connection to the server has been " "made. It sends a line to the server consisting of the *request* string, the " @@ -48581,7 +49234,11 @@ msgid "" "*skip_accept_encoding* with non-False values." msgstr "" -#: ../src/Doc/library/httplib.rst:489 +#: library/httplib.rst:506 +msgid "*skip_accept_encoding* argument added." +msgstr "" + +#: library/httplib.rst:512 msgid "" "Send an :rfc:`822`\\ -style header to the server. It sends a line to the " "server consisting of the header, a colon and a space, and the first " @@ -48590,7 +49247,7 @@ msgid "" msgstr "" # 53f6a6d86ce04875bcd8766f784dd176 -#: ../src/Doc/library/httplib.rst:497 +#: library/httplib.rst:520 msgid "" "Send a blank line to the server, signalling the end of the headers. The " "optional *message_body* argument can be used to pass a message body " @@ -48599,75 +49256,79 @@ msgid "" "separate packet." msgstr "" -#: ../src/Doc/library/httplib.rst:509 +#: library/httplib.rst:526 +msgid "*message_body* was added." +msgstr "" + +#: library/httplib.rst:532 msgid "" "Send data to the server. This should be used directly only after the :meth:" "`endheaders` method has been called and before :meth:`getresponse` is called." msgstr "" -#: ../src/Doc/library/httplib.rst:517 +#: library/httplib.rst:540 msgid "HTTPResponse Objects" msgstr "" # df323a82af664c7d85d6e90a34bba87b -#: ../src/Doc/library/httplib.rst:519 +#: library/httplib.rst:542 msgid "" ":class:`HTTPResponse` instances have the following methods and attributes:" msgstr "" -#: ../src/Doc/library/httplib.rst:524 +#: library/httplib.rst:547 msgid "Reads and returns the response body, or up to the next *amt* bytes." msgstr "" -#: ../src/Doc/library/httplib.rst:529 +#: library/httplib.rst:552 msgid "" "Get the contents of the header *name*, or *default* if there is no matching " "header." msgstr "" -#: ../src/Doc/library/httplib.rst:535 +#: library/httplib.rst:558 msgid "Return a list of (header, value) tuples." msgstr "" # c95b14774d024747a7d0bde85bcab68c -#: ../src/Doc/library/httplib.rst:541 +#: library/httplib.rst:564 msgid "Returns the ``fileno`` of the underlying socket." msgstr "" # 11aa58e12630442492f566547d230871 -#: ../src/Doc/library/httplib.rst:545 +#: library/httplib.rst:568 msgid "A :class:`mimetools.Message` instance containing the response headers." msgstr "" -#: ../src/Doc/library/httplib.rst:550 +#: library/httplib.rst:573 msgid "" "HTTP protocol version used by server. 10 for HTTP/1.0, 11 for HTTP/1.1." msgstr "" -#: ../src/Doc/library/httplib.rst:555 +#: library/httplib.rst:578 msgid "Status code returned by server." msgstr "" -#: ../src/Doc/library/httplib.rst:560 +#: library/httplib.rst:583 msgid "Reason phrase returned by server." msgstr "" -#: ../src/Doc/library/httplib.rst:568 +#: library/httplib.rst:591 msgid "Here is an example session that uses the ``GET`` method::" msgstr "" -#: ../src/Doc/library/httplib.rst:584 +#: library/httplib.rst:607 msgid "" "Here is an example session that uses the ``HEAD`` method. Note that the " "``HEAD`` method never returns any data. ::" msgstr "" -#: ../src/Doc/library/httplib.rst:599 +#: library/httplib.rst:622 msgid "Here is an example session that shows how to ``POST`` requests::" msgstr "" # 704babb8f0d1454b884e07086cb58a02 -#: ../src/Doc/library/httplib.rst:615 +#: library/httplib.rst:638 msgid "" "Client side ``HTTP PUT`` requests are very similar to ``POST`` requests. The " "difference lies only the server side where HTTP server will allow resources " @@ -48675,11 +49336,11 @@ msgid "" "to do ``PUT`` request using httplib::" msgstr "" -#: ../src/Doc/library/i18n.rst:6 +#: library/i18n.rst:6 msgid "Internationalization" msgstr "" -#: ../src/Doc/library/i18n.rst:8 +#: library/i18n.rst:8 msgid "" "The modules described in this chapter help you write software that is " "independent of language and locale by providing mechanisms for selecting a " @@ -48688,19 +49349,19 @@ msgid "" msgstr "" # fd79df13501c4b47b45a204faebda6d3 -#: ../src/Doc/library/ic.rst:2 +#: library/ic.rst:2 msgid ":mod:`ic` --- Access to the Mac OS X Internet Config" msgstr "" # 60a57c7273d947b88acf306f54e6c448 -#: ../src/Doc/library/ic.rst:10 +#: library/ic.rst:10 msgid "" "This module provides access to various internet-related preferences set " "through :program:`System Preferences` or the :program:`Finder`." msgstr "" # 0a6d3d97f6f44c75addd81231b27c615 -#: ../src/Doc/library/ic.rst:20 +#: library/ic.rst:20 msgid "" "There is a low-level companion module :mod:`icglue` which provides the basic " "Internet Config access functionality. This low-level module is not " @@ -48711,24 +49372,24 @@ msgid "" msgstr "" # 9ff2f0752ddd4a8bb049d096dfe32ee0 -#: ../src/Doc/library/ic.rst:26 +#: library/ic.rst:26 msgid "" "The :mod:`ic` module defines the :exc:`error` exception and symbolic names " "for all error codes Internet Config can produce; see the source for details." msgstr "" # 6a24619bf14a4e868f9cde75e6301892 -#: ../src/Doc/library/ic.rst:32 +#: library/ic.rst:32 msgid "Exception raised on errors in the :mod:`ic` module." msgstr "" # e7f2e6c4e4b948618cc2bedc9b3b6d38 -#: ../src/Doc/library/ic.rst:34 +#: library/ic.rst:34 msgid "The :mod:`ic` module defines the following class and function:" msgstr "" # 93023b2916a4456bac740baf1047a9ee -#: ../src/Doc/library/ic.rst:39 +#: library/ic.rst:39 msgid "" "Create an Internet Config object. The signature is a 4-character creator " "code of the current application (default ``'Pyth'``) which may influence " @@ -48738,19 +49399,19 @@ msgid "" msgstr "" # 96aff02175014bbbbacc568584a119bb -#: ../src/Doc/library/ic.rst:52 +#: library/ic.rst:52 msgid "" "These functions are \"shortcuts\" to the methods of the same name, described " "below." msgstr "" # 2efdf39c1c644e2384db5af762a6f3a5 -#: ../src/Doc/library/ic.rst:57 +#: library/ic.rst:57 msgid "IC Objects" msgstr "" # c9279109d21940ebaa86502449cb68ed -#: ../src/Doc/library/ic.rst:59 +#: library/ic.rst:59 msgid "" ":class:`IC` objects have a mapping interface, hence to obtain the mail " "address you simply get ``ic['MailAddress']``. Assignment also works, and " @@ -48758,7 +49419,7 @@ msgid "" msgstr "" # a705a3bcc02a4b738dff816e1fd37e7c -#: ../src/Doc/library/ic.rst:63 +#: library/ic.rst:63 msgid "" "The module knows about various datatypes, and converts the internal IC " "representation to a \"logical\" Python data structure. Running the :mod:`ic` " @@ -48767,7 +49428,7 @@ msgid "" msgstr "" # 0c3ef72d384f4e71adff0dffdaf8fb12 -#: ../src/Doc/library/ic.rst:68 +#: library/ic.rst:68 msgid "" "If the module does not know how to represent the data it returns an instance " "of the ``ICOpaqueData`` type, with the raw data in its :attr:`data` " @@ -48775,14 +49436,14 @@ msgid "" msgstr "" # daa23b0bcd354257898bc1b21f72e488 -#: ../src/Doc/library/ic.rst:72 +#: library/ic.rst:72 msgid "" "Besides the dictionary interface, :class:`IC` objects have the following " "methods:" msgstr "" # 2f0fe7041ada4690b459d8fb2be15a87 -#: ../src/Doc/library/ic.rst:78 +#: library/ic.rst:78 msgid "" "Parse the given URL, launch the correct application and pass it the URL. The " "optional *hint* can be a scheme name such as ``'mailto:'``, in which case " @@ -48791,7 +49452,7 @@ msgid "" msgstr "" # 9fa3e910cc3a4d529994b615975dab41 -#: ../src/Doc/library/ic.rst:86 +#: library/ic.rst:86 msgid "" "Find an URL somewhere in *data* and return start position, end position and " "the URL. The optional *start* and *end* can be used to limit the search, so " @@ -48802,14 +49463,14 @@ msgid "" msgstr "" # 029a52a10cee4853a21b03d123cca0da -#: ../src/Doc/library/ic.rst:96 +#: library/ic.rst:96 msgid "" "Return the mapping entry for the given *file*, which can be passed as either " "a filename or an :func:`FSSpec` result, and which need not exist." msgstr "" # 3c57f8a76ee6410c96fa9f081e3453c4 -#: ../src/Doc/library/ic.rst:99 +#: library/ic.rst:99 msgid "" "The mapping entry is returned as a tuple ``(version, type, creator, " "postcreator, flags, extension, appname, postappname, mimetype, entryname)``, " @@ -48825,7 +49486,7 @@ msgid "" msgstr "" # cdb988d64e9c485992417847a10d068c -#: ../src/Doc/library/ic.rst:113 +#: library/ic.rst:113 msgid "" "Return the mapping entry for files with given 4-character *type* and " "*creator* codes. The optional *filename* may be specified to further help " @@ -48833,12 +49494,12 @@ msgid "" msgstr "" # cf1c91b6055d4f07a9675cf779cac5bb -#: ../src/Doc/library/ic.rst:117 +#: library/ic.rst:117 msgid "The mapping entry is returned in the same format as for *mapfile*." msgstr "" # 0ffb33655e8c417cb745b846f2b70367 -#: ../src/Doc/library/ic.rst:122 +#: library/ic.rst:122 msgid "" "Given an existing *file*, specified either as a filename or as an :func:" "`FSSpec` result, set its creator and type correctly based on its extension. " @@ -48846,666 +49507,1150 @@ msgid "" "quickly." msgstr "" -#: ../src/Doc/library/idle.rst:4 +#: library/idle.rst:4 msgid "IDLE" msgstr "IDLE" -#: ../src/Doc/library/idle.rst:13 -msgid "IDLE is the Python IDE built with the :mod:`tkinter` GUI toolkit." +#: library/idle.rst:13 +msgid "IDLE is Python's Integrated Development and Learning Environment." msgstr "" -#: ../src/Doc/library/idle.rst:15 +#: library/idle.rst:15 msgid "IDLE has the following features:" msgstr "" -#: ../src/Doc/library/idle.rst:17 +#: library/idle.rst:17 msgid "coded in 100% pure Python, using the :mod:`tkinter` GUI toolkit" msgstr "" -#: ../src/Doc/library/idle.rst:19 -msgid "cross-platform: works on Windows and Unix" +#: library/idle.rst:19 +msgid "cross-platform: works mostly the same on Windows, Unix, and Mac OS X" msgstr "" -#: ../src/Doc/library/idle.rst:21 +#: library/idle.rst:21 msgid "" -"multi-window text editor with multiple undo, Python colorizing and many " -"other features, e.g. smart indent and call tips" +"Python shell window (interactive interpreter) with colorizing of code input, " +"output, and error messages" msgstr "" -#: ../src/Doc/library/idle.rst:24 -msgid "Python shell window (a.k.a. interactive interpreter)" +#: library/idle.rst:24 +msgid "" +"multi-window text editor with multiple undo, Python colorizing, smart " +"indent, call tips, auto completion, and other features" msgstr "" -#: ../src/Doc/library/idle.rst:26 -msgid "debugger (not complete, but you can set breakpoints, view and step)" +#: library/idle.rst:27 +msgid "" +"search within any window, replace within editor windows, and search through " +"multiple files (grep)" msgstr "" -#: ../src/Doc/library/idle.rst:30 +#: library/idle.rst:30 +msgid "" +"debugger with persistent breakpoints, stepping, and viewing of global and " +"local namespaces" +msgstr "" + +#: library/idle.rst:33 +msgid "configuration, browsers, and other dialogs" +msgstr "" + +#: library/idle.rst:36 msgid "Menus" msgstr "" -#: ../src/Doc/library/idle.rst:34 -msgid "File menu" +#: library/idle.rst:38 +msgid "" +"IDLE has two main window types, the Shell window and the Editor window. It " +"is possible to have multiple editor windows simultaneously. Output windows, " +"such as used for Edit / Find in Files, are a subtype of edit window. They " +"currently have the same top menu as Editor windows but a different default " +"title and context menu." msgstr "" -# 8e99a5efcf7546d199d5f3e4fe7f127a -#: ../src/Doc/library/idle.rst:36 -msgid "New file" +#: library/idle.rst:44 +msgid "" +"IDLE's menus dynamically change based on which window is currently selected. " +"Each menu documented below indicates which window type it is associated with." msgstr "" -# 0ce51a2f8da2487f94b885a33caf330a -#: ../src/Doc/library/idle.rst:37 -msgid "create a new file editing window" +#: library/idle.rst:48 +msgid "File menu (Shell and Editor)" +msgstr "" + +#: library/idle.rst:51 +msgid "New File" +msgstr "" + +#: library/idle.rst:51 +msgid "Create a new file editing window." msgstr "" # 65475d0f6dda4df58aef850fcb4014b4 -#: ../src/Doc/library/idle.rst:39 +#: library/idle.rst:54 msgid "Open..." msgstr "" -#: ../src/Doc/library/idle.rst:40 -msgid "open an existing file" +#: library/idle.rst:54 +msgid "Open an existing file with an Open dialog." msgstr "" -# 214d176928784d769cf933d1699e805c -#: ../src/Doc/library/idle.rst:42 -msgid "Open module..." +#: library/idle.rst:57 +msgid "Recent Files" msgstr "" -#: ../src/Doc/library/idle.rst:43 -msgid "open an existing module (searches sys.path)" +#: library/idle.rst:57 +msgid "Open a list of recent files. Click one to open it." msgstr "" -# 1b7b561c009141ea95e52f9c4b61e511 -#: ../src/Doc/library/idle.rst:45 -msgid "Class browser" +#: library/idle.rst:60 +msgid "Open Module..." msgstr "" -#: ../src/Doc/library/idle.rst:46 -msgid "show classes and methods in current file" +#: library/idle.rst:60 +msgid "Open an existing module (searches sys.path)." msgstr "" -# e207b45ddb1641f7bb0e2d362860d9e1 -#: ../src/Doc/library/idle.rst:48 -msgid "Path browser" -msgstr "" +#: library/idle.rst:68 +#, fuzzy +msgid "Class Browser" +msgstr "Classes" -#: ../src/Doc/library/idle.rst:49 -msgid "show sys.path directories, modules, classes and methods" -msgstr "" - -#: ../src/Doc/library/idle.rst:56 +#: library/idle.rst:67 msgid "" -"save current window to the associated file (unsaved windows have a \\* " -"before and after the window title)" +"Show functions, classes, and methods in the current Editor file in a tree " +"structure. In the shell, open a module first." +msgstr "" + +#: library/idle.rst:72 +msgid "Path Browser" +msgstr "" + +#: library/idle.rst:71 +msgid "" +"Show sys.path directories, modules, functions, classes and methods in a tree " +"structure." +msgstr "" + +#: library/idle.rst:75 +msgid "" +"Save the current window to the associated file, if there is one. Windows " +"that have been changed since being opened or last saved have a \\* before " +"and after the window title. If there is no associated file, do Save As " +"instead." msgstr "" # 1f434bf83c714e399e5d0a3286f3ce08 -#: ../src/Doc/library/idle.rst:59 +#: library/idle.rst:82 msgid "Save As..." msgstr "" -#: ../src/Doc/library/idle.rst:60 -msgid "save current window to new file, which becomes the associated file" +#: library/idle.rst:81 +msgid "" +"Save the current window with a Save As dialog. The file saved becomes the " +"new associated file for the window." msgstr "" # 8e17fd73e82047b4a934f6668809a54a -#: ../src/Doc/library/idle.rst:62 +#: library/idle.rst:86 msgid "Save Copy As..." msgstr "" -#: ../src/Doc/library/idle.rst:63 +#: library/idle.rst:85 msgid "" -"save current window to different file without changing the associated file" +"Save the current window to different file without changing the associated " +"file." msgstr "" -#: ../src/Doc/library/idle.rst:66 -msgid "close current window (asks to save if unsaved)" +#: library/idle.rst:89 +#, fuzzy +msgid "Print Window" +msgstr "Windows" + +#: library/idle.rst:89 +msgid "Print the current window to the default printer." msgstr "" -#: ../src/Doc/library/idle.rst:69 -msgid "close all windows and quit IDLE (asks to save if unsaved)" +#: library/idle.rst:92 +msgid "Close the current window (ask to save if unsaved)." msgstr "" -#: ../src/Doc/library/idle.rst:73 -msgid "Edit menu" +#: library/idle.rst:95 +msgid "Close all windows and quit IDLE (ask to save unsaved windows)." msgstr "" -#: ../src/Doc/library/idle.rst:76 -msgid "Undo last change to current window (max 1000 changes)" +#: library/idle.rst:98 +msgid "Edit menu (Shell and Editor)" msgstr "" -#: ../src/Doc/library/idle.rst:79 -msgid "Redo last undone change to current window" +#: library/idle.rst:101 +msgid "" +"Undo the last change to the current window. A maximum of 1000 changes may " +"be undone." +msgstr "" + +#: library/idle.rst:105 +msgid "Redo the last undone change to the current window." msgstr "" # 8413f62862794308932148a37fcc6f2b # 058db335f910413c8abce68ba0a68af8 # edae633022324a2e9fc39d8d52d6b5be -#: ../src/Doc/library/idle.rst:81 ../src/Doc/library/idle.rst:186 -#: ../src/Doc/library/idle.rst:215 +#: library/idle.rst:108 library/idle.rst:316 msgid "Cut" msgstr "" -#: ../src/Doc/library/idle.rst:82 ../src/Doc/library/idle.rst:187 -#: ../src/Doc/library/idle.rst:216 -msgid "Copy selection into system-wide clipboard; then delete selection" +#: library/idle.rst:108 library/idle.rst:316 +msgid "" +"Copy selection into the system-wide clipboard; then delete the selection." msgstr "" -#: ../src/Doc/library/idle.rst:85 ../src/Doc/library/idle.rst:190 -#: ../src/Doc/library/idle.rst:219 -msgid "Copy selection into system-wide clipboard" +#: library/idle.rst:111 library/idle.rst:319 +msgid "Copy selection into the system-wide clipboard." msgstr "" # 5ac0a789bfe343df96ee8225e32ad302 # d69ced7c35ec43a5abe82af3a4306128 # 13514a4361a946f795f2891ee94a78f5 -#: ../src/Doc/library/idle.rst:87 ../src/Doc/library/idle.rst:192 -#: ../src/Doc/library/idle.rst:221 +#: library/idle.rst:114 library/idle.rst:322 msgid "Paste" msgstr "" -#: ../src/Doc/library/idle.rst:88 ../src/Doc/library/idle.rst:193 -#: ../src/Doc/library/idle.rst:222 -msgid "Insert system-wide clipboard into window" +#: library/idle.rst:114 library/idle.rst:322 +msgid "Insert contents of the system-wide clipboard into the current window." +msgstr "" + +#: library/idle.rst:116 +msgid "The clipboard functions are also available in context menus." msgstr "" # 6c0015fc24a74eab8aecd26c5deb6a21 -#: ../src/Doc/library/idle.rst:90 +#: library/idle.rst:119 msgid "Select All" msgstr "" -#: ../src/Doc/library/idle.rst:91 -msgid "Select the entire contents of the edit buffer" +#: library/idle.rst:119 +msgid "Select the entire contents of the current window." msgstr "" # e9d061d0ce79456eb7fae4986ca8f90a -#: ../src/Doc/library/idle.rst:93 +#: library/idle.rst:122 msgid "Find..." msgstr "" -#: ../src/Doc/library/idle.rst:94 -msgid "Open a search dialog box with many options" +#: library/idle.rst:122 +msgid "Open a search dialog with many options" msgstr "" -# 4a57e481b4f8493f8c2a6362b3773b03 -#: ../src/Doc/library/idle.rst:96 -msgid "Find again" +#: library/idle.rst:125 +msgid "Find Again" msgstr "" -#: ../src/Doc/library/idle.rst:97 -msgid "Repeat last search" +#: library/idle.rst:125 +msgid "Repeat the last search, if there is one." msgstr "" -# ece1d36a678b456ba27e284a4b594db4 -#: ../src/Doc/library/idle.rst:99 -msgid "Find selection" +#: library/idle.rst:128 +msgid "Find Selection" msgstr "" -#: ../src/Doc/library/idle.rst:100 -msgid "Search for the string in the selection" +#: library/idle.rst:128 +msgid "Search for the currently selected string, if there is one." msgstr "" # 13f0049fd4e2468a89651d2edc62c955 -#: ../src/Doc/library/idle.rst:102 +#: library/idle.rst:131 msgid "Find in Files..." msgstr "" -#: ../src/Doc/library/idle.rst:103 -msgid "Open a search dialog box for searching files" +#: library/idle.rst:131 +msgid "Open a file search dialog. Put results in an new output window." msgstr "" # dd62a4b1e0ab4416afc8a28430eed255 -#: ../src/Doc/library/idle.rst:105 +#: library/idle.rst:134 msgid "Replace..." msgstr "" -#: ../src/Doc/library/idle.rst:106 -msgid "Open a search-and-replace dialog box" +#: library/idle.rst:134 +msgid "Open a search-and-replace dialog." msgstr "" -# 392f0a4c9a6f4fcdaf64ddfa767fec47 -#: ../src/Doc/library/idle.rst:108 -msgid "Go to line" +#: library/idle.rst:137 +msgid "Go to Line" msgstr "" -#: ../src/Doc/library/idle.rst:109 -msgid "Ask for a line number and show that line" +#: library/idle.rst:137 +msgid "Move cursor to the line number requested and make that line visible." msgstr "" -# 56134165c4634748846cbec99581bf7f -#: ../src/Doc/library/idle.rst:111 -msgid "Indent region" +#: library/idle.rst:141 +msgid "Show Completions" msgstr "" -#: ../src/Doc/library/idle.rst:112 -msgid "Shift selected lines right 4 spaces" -msgstr "" - -# 36bc1d959a3640038cdbacea6f666e4d -#: ../src/Doc/library/idle.rst:114 -msgid "Dedent region" -msgstr "" - -#: ../src/Doc/library/idle.rst:115 -msgid "Shift selected lines left 4 spaces" -msgstr "" - -# f259c2e621b14476b986a3bd16699f33 -#: ../src/Doc/library/idle.rst:117 -msgid "Comment out region" -msgstr "" - -#: ../src/Doc/library/idle.rst:118 -msgid "Insert ## in front of selected lines" -msgstr "" - -# bad1f3603ffa4a9cb9983a72d9bc5ac5 -#: ../src/Doc/library/idle.rst:120 -msgid "Uncomment region" -msgstr "" - -#: ../src/Doc/library/idle.rst:121 -msgid "Remove leading # or ## from selected lines" -msgstr "" - -# fa4b66ba4bdb4053b2bbf18f29820d79 -#: ../src/Doc/library/idle.rst:123 -msgid "Tabify region" -msgstr "" - -#: ../src/Doc/library/idle.rst:124 -msgid "Turns *leading* stretches of spaces into tabs" -msgstr "" - -# 81bd7e027214476b8c81a1410020f466 -#: ../src/Doc/library/idle.rst:126 -msgid "Untabify region" -msgstr "" - -#: ../src/Doc/library/idle.rst:127 -msgid "Turn *all* tabs into the right number of spaces" -msgstr "" - -# cb0540acc0ce4215b83c75de9931446d -#: ../src/Doc/library/idle.rst:130 -msgid "Expand word" -msgstr "" - -#: ../src/Doc/library/idle.rst:130 +#: library/idle.rst:140 msgid "" -"Expand the word you have typed to match another word in the same buffer; " -"repeat to get a different expansion" +"Open a scrollable list allowing selection of keywords and attributes. See " +"Completions in the Tips sections below." +msgstr "" + +#: library/idle.rst:145 +msgid "Expand Word" +msgstr "" + +#: library/idle.rst:144 +msgid "" +"Expand a prefix you have typed to match a full word in the same window; " +"repeat to get a different expansion." +msgstr "" + +#: library/idle.rst:149 +msgid "Show call tip" +msgstr "" + +#: library/idle.rst:148 +msgid "" +"After an unclosed parenthesis for a function, open a small window with " +"function parameter hints." +msgstr "" + +#: library/idle.rst:152 +msgid "Show surrounding parens" +msgstr "" + +#: library/idle.rst:152 +msgid "Highlight the surrounding parenthesis." +msgstr "" + +#: library/idle.rst:155 +msgid "Format menu (Editor window only)" +msgstr "" + +#: library/idle.rst:158 +msgid "Indent Region" +msgstr "" + +#: library/idle.rst:158 +msgid "Shift selected lines right by the indent width (default 4 spaces)." +msgstr "" + +#: library/idle.rst:161 +msgid "Dedent Region" +msgstr "" + +#: library/idle.rst:161 +msgid "Shift selected lines left by the indent width (default 4 spaces)." +msgstr "" + +#: library/idle.rst:164 +msgid "Comment Out Region" +msgstr "" + +#: library/idle.rst:164 +msgid "Insert ## in front of selected lines." +msgstr "" + +#: library/idle.rst:167 +msgid "Uncomment Region" +msgstr "" + +#: library/idle.rst:167 +msgid "Remove leading # or ## from selected lines." +msgstr "" + +#: library/idle.rst:171 +msgid "Tabify Region" +msgstr "" + +#: library/idle.rst:170 +msgid "" +"Turn *leading* stretches of spaces into tabs. (Note: We recommend using 4 " +"space blocks to indent Python code.)" +msgstr "" + +#: library/idle.rst:174 +msgid "Untabify Region" +msgstr "" + +#: library/idle.rst:174 +msgid "Turn *all* tabs into the correct number of spaces." +msgstr "" + +#: library/idle.rst:177 +msgid "Toggle Tabs" +msgstr "" + +#: library/idle.rst:177 +msgid "Open a dialog to switch between indenting with spaces and tabs." +msgstr "" + +#: library/idle.rst:181 +msgid "New Indent Width" +msgstr "" + +#: library/idle.rst:180 +msgid "" +"Open a dialog to change indent width. The accepted default by the Python " +"community is 4 spaces." msgstr "" # 66e399616bd34266b8145093a1bc8422 -#: ../src/Doc/library/idle.rst:133 +#: library/idle.rst:186 msgid "Format Paragraph" msgstr "" -#: ../src/Doc/library/idle.rst:134 -msgid "Reformat the current blank-line-separated paragraph" +#: library/idle.rst:184 +msgid "" +"Reformat the current blank-line-delimited paragraph in comment block or " +"multiline string or selected line in a string. All lines in the paragraph " +"will be formatted to less than N columns, where N defaults to 72." msgstr "" -# 794142de8b634dae9b117b77dc60be83 -#: ../src/Doc/library/idle.rst:136 -msgid "Import module" +#: library/idle.rst:189 +msgid "Strip trailing whitespace" msgstr "" -#: ../src/Doc/library/idle.rst:137 -msgid "Import or reload the current module" +#: library/idle.rst:189 +msgid "" +"Remove any space characters after the last non-space character of a line." msgstr "" -# 1872f642e9ff4fac95ffcdbe5ea62911 -#: ../src/Doc/library/idle.rst:139 -msgid "Run script" +#: library/idle.rst:195 +msgid "Run menu (Editor window only)" msgstr "" -#: ../src/Doc/library/idle.rst:140 -msgid "Execute the current file in the __main__ namespace" +#: library/idle.rst:198 +msgid "Python Shell" msgstr "" -#: ../src/Doc/library/idle.rst:148 -msgid "Windows menu" +#: library/idle.rst:198 +msgid "Open or wake up the Python Shell window." +msgstr "" + +#: library/idle.rst:205 +#, fuzzy +msgid "Check Module" +msgstr "Modules" + +#: library/idle.rst:201 +msgid "" +"Check the syntax of the module currently open in the Editor window. If the " +"module has not been saved IDLE will either prompt the user to save or " +"autosave, as selected in the General tab of the Idle Settings dialog. If " +"there is a syntax error, the approximate location is indicated in the Editor " +"window." +msgstr "" + +#: library/idle.rst:214 +#, fuzzy +msgid "Run Module" +msgstr "Modules" + +#: library/idle.rst:208 +msgid "" +"Do Check Module (above). If no error, restart the shell to clean the " +"environment, then execute the module. Output is displayed in the Shell " +"window. Note that output requires use of ``print`` or ``write``. When " +"execution is complete, the Shell retains focus and displays a prompt. At " +"this point, one may interactively explore the result of execution. This is " +"similar to executing a file with ``python -i file`` at a command line." +msgstr "" + +#: library/idle.rst:217 +msgid "Shell menu (Shell window only)" +msgstr "" + +#: library/idle.rst:220 +msgid "View Last Restart" +msgstr "" + +#: library/idle.rst:220 +msgid "Scroll the shell window to the last Shell restart." +msgstr "" + +#: library/idle.rst:223 +msgid "Restart Shell" +msgstr "" + +#: library/idle.rst:223 +msgid "Restart the shell to clean the environment." +msgstr "" + +#: library/idle.rst:226 +msgid "Debug menu (Shell window only)" +msgstr "" + +#: library/idle.rst:233 +msgid "Go to File/Line" +msgstr "" + +#: library/idle.rst:229 +msgid "" +"Look on the current line. with the cursor, and the line above for a filename " +"and line number. If found, open the file if not already open, and show the " +"line. Use this to view source lines referenced in an exception traceback " +"and lines found by Find in Files. Also available in the context menu of the " +"Shell window and Output windows." +msgstr "" + +#: library/idle.rst:242 +msgid "Debugger (toggle)" +msgstr "" + +#: library/idle.rst:240 +msgid "" +"When actived, code entered in the Shell or run from an Editor will run under " +"the debugger. In the Editor, breakpoints can be set with the context menu. " +"This feature is still incomplete and somewhat experimental." +msgstr "" + +#: library/idle.rst:246 +msgid "Stack Viewer" +msgstr "" + +#: library/idle.rst:245 +msgid "" +"Show the stack traceback of the last exception in a tree widget, with access " +"to locals and globals." +msgstr "" + +# b139ac7f5a754e719d1946d9f3edfb2c +#: library/idle.rst:249 +msgid "Auto-open Stack Viewer" +msgstr "" + +#: library/idle.rst:249 +msgid "" +"Toggle automatically opening the stack viewer on an unhandled exception." +msgstr "" + +#: library/idle.rst:252 +msgid "Options menu (Shell and Editor)" +msgstr "" + +#: library/idle.rst:264 +msgid "Configure IDLE" +msgstr "" + +#: library/idle.rst:255 +msgid "" +"Open a configuration dialog and change preferences for the following: fonts, " +"indentation, keybindings, text color themes, startup windows and size, " +"additional help sources, and extensions (see below). On OS X, open the " +"configuration dialog by selecting Preferences in the application menu. To " +"use a new built-in color theme (IDLE Dark) with older IDLEs, save it as a " +"new custom theme." +msgstr "" + +#: library/idle.rst:262 +msgid "" +"Non-default user settings are saved in a .idlerc directory in the user's " +"home directory. Problems caused by bad user configuration files are solved " +"by editing or deleting one or more of the files in .idlerc." +msgstr "" + +#: library/idle.rst:268 +msgid "Code Context (toggle)(Editor Window only)" +msgstr "" + +#: library/idle.rst:267 +msgid "" +"Open a pane at the top of the edit window which shows the block context of " +"the code which has scrolled above the top of the window." +msgstr "" + +#: library/idle.rst:271 +msgid "Window menu (Shell and Editor)" msgstr "" # d23a0745b4fb4f15a6ea729aa3654e84 -#: ../src/Doc/library/idle.rst:150 +#: library/idle.rst:276 msgid "Zoom Height" msgstr "" -#: ../src/Doc/library/idle.rst:151 -msgid "toggles the window between normal size (24x80) and maximum height." +#: library/idle.rst:274 +msgid "" +"Toggles the window between normal size and maximum height. The initial size " +"defaults to 40 lines by 80 chars unless changed on the General tab of the " +"Configure IDLE dialog." msgstr "" -#: ../src/Doc/library/idle.rst:153 +#: library/idle.rst:278 msgid "" "The rest of this menu lists the names of all open windows; select one to " "bring it to the foreground (deiconifying it if necessary)." msgstr "" -# 25aec4b17e9943488e681aab03165d78 -#: ../src/Doc/library/idle.rst:158 -msgid "Debug menu" +#: library/idle.rst:282 +msgid "Help menu (Shell and Editor)" msgstr "" -# fdcc0732da6a4409a2fea14abd288287 -#: ../src/Doc/library/idle.rst:160 -msgid "in the Python Shell window only" +#: library/idle.rst:285 +msgid "About IDLE" +msgstr "" + +#: library/idle.rst:285 +msgid "Display version, copyright, license, credits, and more." +msgstr "" + +#: library/idle.rst:289 +#, fuzzy +msgid "IDLE Help" +msgstr "IDLE" + +#: library/idle.rst:288 +msgid "" +"Display a help file for IDLE detailing the menu options, basic editing and " +"navigation, and other tips." +msgstr "" + +#: library/idle.rst:293 +msgid "Python Docs" +msgstr "" + +#: library/idle.rst:292 +msgid "" +"Access local Python documentation, if installed, or start a web browser and " +"open docs.python.org showing the latest Python documentation." +msgstr "" + +#: library/idle.rst:296 +msgid "Turtle Demo" +msgstr "" + +#: library/idle.rst:296 +msgid "Run the turtledemo module with example python code and turtle drawings." +msgstr "" + +#: library/idle.rst:298 +msgid "" +"Additional help sources may be added here with the Configure IDLE dialog " +"under the General tab." +msgstr "" + +#: library/idle.rst:310 +msgid "Context Menus" +msgstr "" + +#: library/idle.rst:312 +msgid "" +"Open a context menu by right-clicking in a window (Control-click on OS X). " +"Context menus have the standard clipboard functions also on the Edit menu." +msgstr "" + +#: library/idle.rst:324 +msgid "" +"Editor windows also have breakpoint functions. Lines with a breakpoint set " +"are specially marked. Breakpoints only have an effect when running under " +"the debugger. Breakpoints for a file are saved in the user's .idlerc " +"directory." +msgstr "" + +# 6478778c573e46f7a651e697d0093a3b +#: library/idle.rst:329 +msgid "Set Breakpoint" +msgstr "" + +#: library/idle.rst:329 +msgid "Set a breakpoint on the current line." +msgstr "" + +# 07965d0e20d740e6aaa47b358259d161 +#: library/idle.rst:332 +msgid "Clear Breakpoint" +msgstr "" + +#: library/idle.rst:332 +msgid "Clear the breakpoint on that line." +msgstr "" + +#: library/idle.rst:334 +msgid "Shell and Output windows have the following." msgstr "" # a5a3bbcfb8204af6ab3cc214e630b77b # 956c1e92d87541a8a6bb3205e7d0fb1b -#: ../src/Doc/library/idle.rst:164 ../src/Doc/library/idle.rst:225 +#: library/idle.rst:338 msgid "Go to file/line" msgstr "" -# af4e5ed470ad48a1b681cd29a995b9f8 -#: ../src/Doc/library/idle.rst:163 -msgid "" -"Look around the insert point for a filename and line number, open the file, " -"and show the line. Useful to view the source lines referenced in an " -"exception traceback." -msgstr "" - -# 13863b22ba6641e4b7fee8bcf2f64c03 -#: ../src/Doc/library/idle.rst:167 -msgid "Debugger" -msgstr "" - -# 937fb2b1a1a34eafb141fdee09c0aaed -#: ../src/Doc/library/idle.rst:168 -msgid "Run commands in the shell under the debugger." -msgstr "" - -# 2851546816d642c8ab9cee361a2b5a58 -#: ../src/Doc/library/idle.rst:170 -msgid "Stack viewer" -msgstr "" - -# a959e61775d0411f9f921b377392b551 -#: ../src/Doc/library/idle.rst:171 -msgid "Show the stack traceback of the last exception." -msgstr "" - -# b139ac7f5a754e719d1946d9f3edfb2c -#: ../src/Doc/library/idle.rst:173 -msgid "Auto-open Stack Viewer" -msgstr "" - -# 8439865f672b4ae5b76bf2b7446607c8 -#: ../src/Doc/library/idle.rst:174 -msgid "Open stack viewer on traceback." -msgstr "" - -# eab1b44d98d84ef1b52af61a6f68696f -#: ../src/Doc/library/idle.rst:182 -msgid "Edit context menu" -msgstr "" - -# 5c3367157c4a442d8e660453452bd25a -#: ../src/Doc/library/idle.rst:184 -msgid "Right-click in Edit window (Control-click on OS X)" -msgstr "" - -# 6478778c573e46f7a651e697d0093a3b -#: ../src/Doc/library/idle.rst:195 -msgid "Set Breakpoint" -msgstr "" - -# 8a7bf757ead14fbabb7354756c56e655 -#: ../src/Doc/library/idle.rst:196 -msgid "" -"Sets a breakpoint. Breakpoints are only enabled when the debugger is open." -msgstr "" - -# 07965d0e20d740e6aaa47b358259d161 -#: ../src/Doc/library/idle.rst:198 -msgid "Clear Breakpoint" -msgstr "" - -# efd77b575111419ab59ca10ca7b413d3 -#: ../src/Doc/library/idle.rst:199 -msgid "Clears the breakpoint on that line." -msgstr "" - -# a0011eda90484a1e8fcefa117029ad07 -#: ../src/Doc/library/idle.rst:211 -msgid "Shell context menu" -msgstr "" - -# d81e496c4cb845789866935a39fbeb1f -#: ../src/Doc/library/idle.rst:213 -msgid "Right-click in Python Shell window (Control-click on OS X)" -msgstr "" - # 47eb1546533249b5bdf9042f1fdd6971 -#: ../src/Doc/library/idle.rst:225 +#: library/idle.rst:337 msgid "Same as in Debug menu." msgstr "" -#: ../src/Doc/library/idle.rst:229 -msgid "Basic editing and navigation" +#: library/idle.rst:341 +msgid "Editing and navigation" msgstr "" -#: ../src/Doc/library/idle.rst:231 +#: library/idle.rst:343 +msgid "" +"In this section, 'C' refers to the :kbd:`Control` key on Windows and Unix " +"and the :kbd:`Command` key on Mac OSX." +msgstr "" + +#: library/idle.rst:346 msgid ":kbd:`Backspace` deletes to the left; :kbd:`Del` deletes to the right" msgstr "" -#: ../src/Doc/library/idle.rst:233 +#: library/idle.rst:348 +msgid "" +":kbd:`C-Backspace` delete word left; :kbd:`C-Del` delete word to the right" +msgstr "" + +#: library/idle.rst:350 msgid "Arrow keys and :kbd:`Page Up`/:kbd:`Page Down` to move around" msgstr "" -#: ../src/Doc/library/idle.rst:235 +#: library/idle.rst:352 +msgid ":kbd:`C-LeftArrow` and :kbd:`C-RightArrow` moves by words" +msgstr "" + +#: library/idle.rst:354 msgid ":kbd:`Home`/:kbd:`End` go to begin/end of line" msgstr "" -#: ../src/Doc/library/idle.rst:237 +#: library/idle.rst:356 msgid ":kbd:`C-Home`/:kbd:`C-End` go to begin/end of file" msgstr "" -#: ../src/Doc/library/idle.rst:239 -msgid "" -"Some :program:`Emacs` bindings may also work, including :kbd:`C-B`, :kbd:`C-" -"P`, :kbd:`C-A`, :kbd:`C-E`, :kbd:`C-D`, :kbd:`C-L`" +#: library/idle.rst:358 +msgid "Some useful Emacs bindings are inherited from Tcl/Tk:" msgstr "" -#: ../src/Doc/library/idle.rst:244 +#: library/idle.rst:360 +msgid ":kbd:`C-a` beginning of line" +msgstr "" + +#: library/idle.rst:362 +msgid ":kbd:`C-e` end of line" +msgstr "" + +#: library/idle.rst:364 +msgid ":kbd:`C-k` kill line (but doesn't put it in clipboard)" +msgstr "" + +#: library/idle.rst:366 +msgid ":kbd:`C-l` center window around the insertion point" +msgstr "" + +#: library/idle.rst:368 +msgid "" +":kbd:`C-b` go backwards one character without deleting (usually you can also " +"use the cursor key for this)" +msgstr "" + +#: library/idle.rst:371 +msgid "" +":kbd:`C-f` go forward one character without deleting (usually you can also " +"use the cursor key for this)" +msgstr "" + +#: library/idle.rst:374 +msgid "" +":kbd:`C-p` go up one line (usually you can also use the cursor key for this)" +msgstr "" + +#: library/idle.rst:377 +msgid ":kbd:`C-d` delete next character" +msgstr "" + +#: library/idle.rst:379 +msgid "" +"Standard keybindings (like :kbd:`C-c` to copy and :kbd:`C-v` to paste) may " +"work. Keybindings are selected in the Configure IDLE dialog." +msgstr "" + +#: library/idle.rst:384 msgid "Automatic indentation" msgstr "" -#: ../src/Doc/library/idle.rst:246 +#: library/idle.rst:386 msgid "" "After a block-opening statement, the next line is indented by 4 spaces (in " "the Python Shell window by one tab). After certain keywords (break, return " "etc.) the next line is dedented. In leading indentation, :kbd:`Backspace` " -"deletes up to 4 spaces if they are there. :kbd:`Tab` inserts 1-4 spaces (in " -"the Python Shell window one tab). See also the indent/dedent region commands " -"in the edit menu." +"deletes up to 4 spaces if they are there. :kbd:`Tab` inserts spaces (in the " +"Python Shell window one tab), number depends on Indent width. Currently tabs " +"are restricted to four spaces due to Tcl/Tk limitations." msgstr "" -#: ../src/Doc/library/idle.rst:255 +#: library/idle.rst:393 +msgid "See also the indent/dedent region commands in the edit menu." +msgstr "" + +# 44573c5d07ca4b409899d66ef06775f5 +#: library/idle.rst:396 +#, fuzzy +msgid "Completions" +msgstr "*options*" + +#: library/idle.rst:398 +msgid "" +"Completions are supplied for functions, classes, and attributes of classes, " +"both built-in and user-defined. Completions are also provided for filenames." +msgstr "" + +#: library/idle.rst:402 +msgid "" +"The AutoCompleteWindow (ACW) will open after a predefined delay (default is " +"two seconds) after a '.' or (in a string) an os.sep is typed. If after one " +"of those characters (plus zero or more other characters) a tab is typed the " +"ACW will open immediately if a possible continuation is found." +msgstr "" + +#: library/idle.rst:407 +msgid "" +"If there is only one possible completion for the characters entered, a :kbd:" +"`Tab` will supply that completion without opening the ACW." +msgstr "" + +#: library/idle.rst:410 +msgid "" +"'Show Completions' will force open a completions window, by default the :kbd:" +"`C-space` will open a completions window. In an empty string, this will " +"contain the files in the current directory. On a blank line, it will contain " +"the built-in and user-defined functions and classes in the current name " +"spaces, plus any modules imported. If some characters have been entered, the " +"ACW will attempt to be more specific." +msgstr "" + +#: library/idle.rst:417 +msgid "" +"If a string of characters is typed, the ACW selection will jump to the entry " +"most closely matching those characters. Entering a :kbd:`tab` will cause " +"the longest non-ambiguous match to be entered in the Editor window or " +"Shell. Two :kbd:`tab` in a row will supply the current ACW selection, as " +"will return or a double click. Cursor keys, Page Up/Down, mouse selection, " +"and the scroll wheel all operate on the ACW." +msgstr "" + +#: library/idle.rst:424 +msgid "" +"\"Hidden\" attributes can be accessed by typing the beginning of hidden name " +"after a '.', e.g. '_'. This allows access to modules with ``__all__`` set, " +"or to class-private attributes." +msgstr "" + +#: library/idle.rst:428 +msgid "Completions and the 'Expand Word' facility can save a lot of typing!" +msgstr "" + +#: library/idle.rst:430 +msgid "" +"Completions are currently limited to those in the namespaces. Names in an " +"Editor window which are not via ``__main__`` and :data:`sys.modules` will " +"not be found. Run the module once with your imports to correct this " +"situation. Note that IDLE itself places quite a few modules in sys.modules, " +"so much can be found by default, e.g. the re module." +msgstr "" + +#: library/idle.rst:436 +msgid "" +"If you don't like the ACW popping up unbidden, simply make the delay longer " +"or disable the extension." +msgstr "" + +#: library/idle.rst:440 +msgid "Calltips" +msgstr "" + +#: library/idle.rst:442 +msgid "" +"A calltip is shown when one types :kbd:`(` after the name of an " +"*acccessible* function. A name expression may include dots and subscripts. " +"A calltip remains until it is clicked, the cursor is moved out of the " +"argument area, or :kbd:`)` is typed. When the cursor is in the argument " +"part of a definition, the menu or shortcut display a calltip." +msgstr "" + +#: library/idle.rst:448 +msgid "" +"A calltip consists of the function signature and the first line of the " +"docstring. For builtins without an accessible signature, the calltip " +"consists of all lines up the fifth line or the first blank line. These " +"details may change." +msgstr "" + +#: library/idle.rst:453 +msgid "" +"The set of *accessible* functions depends on what modules have been imported " +"into the user process, including those imported by Idle itself, and what " +"definitions have been run, all since the last restart." +msgstr "" + +#: library/idle.rst:457 +msgid "" +"For example, restart the Shell and enter ``itertools.count(``. A calltip " +"appears because Idle imports itertools into the user process for its own " +"use. (This could change.) Enter ``turtle.write(`` and nothing appears. " +"Idle does not import turtle. The menu or shortcut do nothing either. Enter " +"``import turtle`` and then ``turtle.write(`` will work." +msgstr "" + +#: library/idle.rst:463 +msgid "" +"In an editor, import statements have no effect until one runs the file. One " +"might want to run a file after writing the import statements at the top, or " +"immediately run an existing file before editing." +msgstr "" + +#: library/idle.rst:468 msgid "Python Shell window" msgstr "" -#: ../src/Doc/library/idle.rst:257 -msgid ":kbd:`C-C` interrupts executing command" +#: library/idle.rst:470 +msgid ":kbd:`C-c` interrupts executing command" msgstr "" -#: ../src/Doc/library/idle.rst:259 +#: library/idle.rst:472 msgid "" -":kbd:`C-D` sends end-of-file; closes window if typed at a ``>>>`` prompt" +":kbd:`C-d` sends end-of-file; closes window if typed at a ``>>>`` prompt" msgstr "" -#: ../src/Doc/library/idle.rst:261 -msgid ":kbd:`Alt-p` retrieves previous command matching what you have typed" +#: library/idle.rst:474 +msgid ":kbd:`Alt-/` (Expand word) is also useful to reduce typing" msgstr "" -#: ../src/Doc/library/idle.rst:263 -msgid ":kbd:`Alt-n` retrieves next" +#: library/idle.rst:476 +msgid "Command history" msgstr "" -#: ../src/Doc/library/idle.rst:265 +#: library/idle.rst:478 +msgid "" +":kbd:`Alt-p` retrieves previous command matching what you have typed. On OS " +"X use :kbd:`C-p`." +msgstr "" + +#: library/idle.rst:481 +msgid ":kbd:`Alt-n` retrieves next. On OS X use :kbd:`C-n`." +msgstr "" + +#: library/idle.rst:483 msgid ":kbd:`Return` while on any previous command retrieves that command" msgstr "" -#: ../src/Doc/library/idle.rst:267 -msgid ":kbd:`Alt-/` (Expand word) is also useful here" +#: library/idle.rst:487 +msgid "Text colors" msgstr "" -#: ../src/Doc/library/idle.rst:273 -msgid "Syntax colors" -msgstr "" - -#: ../src/Doc/library/idle.rst:275 +#: library/idle.rst:489 msgid "" -"The coloring is applied in a background \"thread,\" so you may occasionally " -"see uncolorized text. To change the color scheme, edit the ``[Colors]`` " -"section in :file:`config.txt`." +"Idle defaults to black on white text, but colors text with special meanings. " +"For the shell, these are shell output, shell error, user output, and user " +"error. For Python code, at the shell prompt or in an editor, these are " +"keywords, builtin class and function names, names following ``class`` and " +"``def``, strings, and comments. For any text window, these are the cursor " +"(when present), found text (when possible), and selected text." msgstr "" -# e7f95af32cfc4410893e12bc75b619b2 -#: ../src/Doc/library/idle.rst:289 -msgid "Python syntax colors:" +#: library/idle.rst:496 +msgid "" +"Text coloring is done in the background, so uncolorized text is occasionally " +"visible. To change the color scheme, use the Configure IDLE dialog " +"Highlighting tab. The marking of debugger breakpoint lines in the editor " +"and text in popups and dialogs is not user-configurable." msgstr "" -# 378ed6756c504a66b0afb2b7cf1dcbc0 -#: ../src/Doc/library/idle.rst:280 -msgid "Keywords" +#: library/idle.rst:503 +msgid "Startup and code execution" msgstr "" -#: ../src/Doc/library/idle.rst:281 -msgid "orange" -msgstr "" - -# 28893d70cf3e45eab810c679c6530a44 -#: ../src/Doc/library/idle.rst:283 -msgid "Strings" -msgstr "Les chaînes de caractères" - -#: ../src/Doc/library/idle.rst:284 -msgid "green" -msgstr "" - -# c598a784e7114b1abf301b5a9ed12c5c -#: ../src/Doc/library/idle.rst:286 -msgid "Comments" -msgstr "" - -#: ../src/Doc/library/idle.rst:287 -msgid "red" -msgstr "" - -# 8cf6b46685124f369796c4b1e2059e41 -#: ../src/Doc/library/idle.rst:289 -msgid "Definitions" -msgstr "" - -#: ../src/Doc/library/idle.rst:290 ../src/Doc/library/idle.rst:297 -msgid "blue" -msgstr "" - -# 69c987f915d64d689875f21d4d3d7d5f -#: ../src/Doc/library/idle.rst:303 -msgid "Shell colors:" -msgstr "" - -# 2e7ad529ffd0470e849751ecf4611e1f -#: ../src/Doc/library/idle.rst:293 -msgid "Console output" -msgstr "" - -#: ../src/Doc/library/idle.rst:294 -msgid "brown" -msgstr "" - -# 27423722a92843a78e0cec4fff3027b5 -#: ../src/Doc/library/idle.rst:296 -msgid "stdout" -msgstr "" - -# f7b68d60ec44426a820cbd66156996b3 -#: ../src/Doc/library/idle.rst:299 -msgid "stderr" -msgstr "" - -#: ../src/Doc/library/idle.rst:300 -msgid "dark green" -msgstr "" - -# 25296789eaa24cf39d20a3053672699a -#: ../src/Doc/library/idle.rst:303 -msgid "stdin" -msgstr "" - -#: ../src/Doc/library/idle.rst:303 -msgid "black" -msgstr "" - -#: ../src/Doc/library/idle.rst:307 -msgid "Startup" -msgstr "" - -#: ../src/Doc/library/idle.rst:309 +#: library/idle.rst:505 msgid "" "Upon startup with the ``-s`` option, IDLE will execute the file referenced " "by the environment variables :envvar:`IDLESTARTUP` or :envvar:" -"`PYTHONSTARTUP`. Idle first checks for ``IDLESTARTUP``; if ``IDLESTARTUP`` " +"`PYTHONSTARTUP`. IDLE first checks for ``IDLESTARTUP``; if ``IDLESTARTUP`` " "is present the file referenced is run. If ``IDLESTARTUP`` is not present, " -"Idle checks for ``PYTHONSTARTUP``. Files referenced by these environment " +"IDLE checks for ``PYTHONSTARTUP``. Files referenced by these environment " "variables are convenient places to store functions that are used frequently " -"from the Idle shell, or for executing import statements to import common " +"from the IDLE shell, or for executing import statements to import common " "modules." msgstr "" -#: ../src/Doc/library/idle.rst:317 +#: library/idle.rst:513 msgid "" "In addition, ``Tk`` also loads a startup file if it is present. Note that " "the Tk file is loaded unconditionally. This additional file is ``.Idle.py`` " "and is looked for in the user's home directory. Statements in this file " "will be executed in the Tk namespace, so this file is not useful for " -"importing functions to be used from Idle's Python shell." +"importing functions to be used from IDLE's Python shell." msgstr "" -#: ../src/Doc/library/idle.rst:325 +#: library/idle.rst:521 msgid "Command line usage" msgstr "" -#: ../src/Doc/library/idle.rst:337 +#: library/idle.rst:537 msgid "If there are arguments:" msgstr "" -# 7538ef7a9b0f48969e398e54e70101ee -#: ../src/Doc/library/idle.rst:339 +#: library/idle.rst:539 msgid "" -"If ``-e`` is used, arguments are files opened for editing and ``sys.argv`` " -"reflects the arguments passed to IDLE itself." +"If ``-``, ``-c``, or ``r`` is used, all arguments are placed in ``sys." +"argv[1:...]`` and ``sys.argv[0]`` is set to ``''``, ``'-c'``, or ``'-r'``. " +"No editor window is opened, even if that is the default set in the Options " +"dialog." msgstr "" -# 1758f81ea2e64ae0a8b8cbd0765da41c -#: ../src/Doc/library/idle.rst:342 +#: library/idle.rst:544 msgid "" -"Otherwise, if ``-c`` is used, all arguments are placed in ``sys." -"argv[1:...]``, with ``sys.argv[0]`` set to ``'-c'``." +"Otherwise, arguments are files opened for editing and ``sys.argv`` reflects " +"the arguments passed to IDLE itself." msgstr "" -# c63dbc402d464aa0970fe50b053581cc -#: ../src/Doc/library/idle.rst:345 +#: library/idle.rst:549 +msgid "IDLE-console differences" +msgstr "" + +#: library/idle.rst:551 msgid "" -"Otherwise, if neither ``-e`` nor ``-c`` is used, the first argument is a " -"script which is executed with the remaining arguments in ``sys." -"argv[1:...]`` and ``sys.argv[0]`` set to the script name. If the script " -"name is '-', no script is executed but an interactive Python session is " -"started; the arguments are still available in ``sys.argv``." +"As much as possible, the result of executing Python code with IDLE is the " +"same as executing the same code in a console window. However, the different " +"interface and operation occasionally affects results." +msgstr "" + +#: library/idle.rst:555 +msgid "" +"For instance, IDLE normally executes user code in a separate process from " +"the IDLE GUI itself. The IDLE versions of sys.stdin, .stdout, and .stderr " +"in the execution process get input from and send output to the GUI process, " +"which keeps control of the keyboard and screen. This is normally " +"transparent, but code that access these object will see different attribute " +"values. Also, functions that directly access the keyboard and screen will " +"not work." +msgstr "" + +#: library/idle.rst:562 +msgid "" +"With IDLE's Shell, one enters, edits, and recalls complete statements. Some " +"consoles only work with a single physical line at a time." +msgstr "" + +#: library/idle.rst:566 +msgid "Running without a subprocess" +msgstr "" + +#: library/idle.rst:568 +msgid "" +"By default, IDLE executes user code in a separate subprocess via a socket, " +"which uses the internal loopback interface. This connection is not " +"externally visible and no data is sent to or received from the Internet. If " +"firewall software complains anyway, you can ignore it." +msgstr "" + +#: library/idle.rst:573 +msgid "" +"If the attempt to make the socket connection fails, Idle will notify you. " +"Such failures are sometimes transient, but if persistent, the problem may be " +"either a firewall blocking the connecton or misconfiguration of a particular " +"system. Until the problem is fixed, one can run Idle with the -n command " +"line switch." +msgstr "" + +#: library/idle.rst:579 +msgid "" +"If IDLE is started with the -n command line switch it will run in a single " +"process and will not create the subprocess which runs the RPC Python " +"execution server. This can be useful if Python cannot create the subprocess " +"or the RPC socket interface on your platform. However, in this mode user " +"code is not isolated from IDLE itself. Also, the environment is not " +"restarted when Run/Run Module (F5) is selected. If your code has been " +"modified, you must reload() the affected modules and re-import any specific " +"items (e.g. from foo import baz) if the changes are to take effect. For " +"these reasons, it is preferable to run IDLE with the default subprocess if " +"at all possible." +msgstr "" + +#: library/idle.rst:594 +msgid "Help and preferences" +msgstr "" + +#: library/idle.rst:597 +msgid "Additional help sources" +msgstr "" + +#: library/idle.rst:599 +msgid "" +"IDLE includes a help menu entry called \"Python Docs\" that will open the " +"extensive sources of help, including tutorials, available at docs.python." +"org. Selected URLs can be added or removed from the help menu at any time " +"using the Configure IDLE dialog. See the IDLE help option in the help menu " +"of IDLE for more information." +msgstr "" + +#: library/idle.rst:607 +msgid "Setting preferences" +msgstr "" + +#: library/idle.rst:609 +msgid "" +"The font preferences, highlighting, keys, and general preferences can be " +"changed via Configure IDLE on the Option menu. Keys can be user defined; " +"IDLE ships with four built in key sets. In addition a user can create a " +"custom key set in the Configure IDLE dialog under the keys tab." +msgstr "" + +#: library/idle.rst:616 +#, fuzzy +msgid "Extensions" +msgstr "Exceptions" + +#: library/idle.rst:618 +msgid "" +"IDLE contains an extension facility. Peferences for extensions can be " +"changed with Configure Extensions. See the beginning of config-extensions." +"def in the idlelib directory for further information. The default " +"extensions are currently:" +msgstr "" + +#: library/idle.rst:623 +msgid "FormatParagraph" +msgstr "" + +#: library/idle.rst:625 +msgid "AutoExpand" +msgstr "" + +#: library/idle.rst:627 +msgid "ZoomHeight" +msgstr "" + +#: library/idle.rst:629 +msgid "ScriptBinding" +msgstr "" + +#: library/idle.rst:631 +msgid "CallTips" +msgstr "" + +#: library/idle.rst:633 +msgid "ParenMatch" +msgstr "" + +#: library/idle.rst:635 +msgid "AutoComplete" +msgstr "" + +#: library/idle.rst:637 +msgid "CodeContext" +msgstr "" + +#: library/idle.rst:639 +msgid "RstripExtension" msgstr "" # 7dae34f8e94546aca1de204172910fc8 -#: ../src/Doc/library/imageop.rst:3 +#: library/imageop.rst:3 msgid ":mod:`imageop` --- Manipulate raw image data" msgstr "" +#: library/imageop.rst:9 +msgid "The :mod:`imageop` module has been removed in Python 3." +msgstr "" + # 715bb7248803427a9de7248af5d66ae5 -#: ../src/Doc/library/imageop.rst:12 +#: library/imageop.rst:12 msgid "" "The :mod:`imageop` module contains some useful operations on images. It " "operates on images consisting of 8 or 32 bit pixels stored in Python " @@ -49514,14 +50659,14 @@ msgid "" msgstr "" # a8226a1980244dde895d0085d89dc932 -#: ../src/Doc/library/imageop.rst:21 +#: library/imageop.rst:21 msgid "" "This exception is raised on all errors, such as unknown number of bits per " "pixel, etc." msgstr "" # 0e3b5e265ce841afb821858f6b4855cb -#: ../src/Doc/library/imageop.rst:27 +#: library/imageop.rst:27 msgid "" "Return the selected part of *image*, which should be *width* by *height* in " "size and consist of pixels of *psize* bytes. *x0*, *y0*, *x1* and *y1* are " @@ -49533,7 +50678,7 @@ msgid "" msgstr "" # 24b7a6d55d0c45019bb99828345d342b -#: ../src/Doc/library/imageop.rst:37 +#: library/imageop.rst:37 msgid "" "Return *image* scaled to size *newwidth* by *newheight*. No interpolation is " "done, scaling is done by simple-minded pixel duplication or removal. " @@ -49542,7 +50687,7 @@ msgid "" msgstr "" # 05b3a389799a4cd49229daf253eced97 -#: ../src/Doc/library/imageop.rst:44 +#: library/imageop.rst:44 msgid "" "Run a vertical low-pass filter over an image. It does so by computing each " "destination pixel as the average of two vertically-aligned source pixels. " @@ -49551,7 +50696,7 @@ msgid "" msgstr "" # 5ab0cf6ace9d4892805fb8091276bf16 -#: ../src/Doc/library/imageop.rst:52 +#: library/imageop.rst:52 msgid "" "Convert a 8-bit deep greyscale image to a 1-bit deep image by thresholding " "all the pixels. The resulting image is tightly packed and is probably only " @@ -49559,14 +50704,14 @@ msgid "" msgstr "" # 29bd1bca43c84872817b88af4d9cdf60 -#: ../src/Doc/library/imageop.rst:59 +#: library/imageop.rst:59 msgid "" "Convert an 8-bit greyscale image to a 1-bit monochrome image using a (simple-" "minded) dithering algorithm." msgstr "" # 2f0caee49dd1410da6a53184a17857bc -#: ../src/Doc/library/imageop.rst:65 +#: library/imageop.rst:65 msgid "" "Convert a 1-bit monochrome image to an 8 bit greyscale or color image. All " "pixels that are zero-valued on input get value *p0* on output and all one-" @@ -49575,38 +50720,38 @@ msgid "" msgstr "" # a8f764353adb4e81b1587d3b015b4d08 -#: ../src/Doc/library/imageop.rst:73 +#: library/imageop.rst:73 msgid "" "Convert an 8-bit greyscale image to a 4-bit greyscale image without " "dithering." msgstr "" # 8d5a878e2bbf4ef8880e7f7c72ca5159 -#: ../src/Doc/library/imageop.rst:78 +#: library/imageop.rst:78 msgid "" "Convert an 8-bit greyscale image to a 2-bit greyscale image without " "dithering." msgstr "" # 37953fc6a83c4bba81fa38e394dcf538 -#: ../src/Doc/library/imageop.rst:83 +#: library/imageop.rst:83 msgid "" "Convert an 8-bit greyscale image to a 2-bit greyscale image with dithering. " "As for :func:`dither2mono`, the dithering algorithm is currently very simple." msgstr "" # b471a7464e6e46f1b54d8463c12c29ed -#: ../src/Doc/library/imageop.rst:89 +#: library/imageop.rst:89 msgid "Convert a 4-bit greyscale image to an 8-bit greyscale image." msgstr "" # f91e075e612441afb17716178e0ddc7a -#: ../src/Doc/library/imageop.rst:94 +#: library/imageop.rst:94 msgid "Convert a 2-bit greyscale image to an 8-bit greyscale image." msgstr "" # 388a7e95845e427abb966637c14cbc7b -#: ../src/Doc/library/imageop.rst:99 +#: library/imageop.rst:99 msgid "" "If set to 0, the functions in this module use a non-backward compatible way " "of representing multi-byte pixels on little-endian systems. The SGI for " @@ -49618,16 +50763,16 @@ msgid "" "as on big-endian systems." msgstr "" -#: ../src/Doc/library/imaplib.rst:2 +#: library/imaplib.rst:2 msgid ":mod:`imaplib` --- IMAP4 protocol client" msgstr "" # 8fc5305d466144949de0a91cf1fcc09f -#: ../src/Doc/library/imaplib.rst:19 +#: library/imaplib.rst:19 msgid "**Source code:** :source:`Lib/imaplib.py`" msgstr "" -#: ../src/Doc/library/imaplib.rst:23 +#: library/imaplib.rst:23 msgid "" "This module defines three classes, :class:`IMAP4`, :class:`IMAP4_SSL` and :" "class:`IMAP4_stream`, which encapsulate a connection to an IMAP4 server and " @@ -49636,13 +50781,13 @@ msgid "" "that the ``STATUS`` command is not supported in IMAP4." msgstr "" -#: ../src/Doc/library/imaplib.rst:29 +#: library/imaplib.rst:29 msgid "" "Three classes are provided by the :mod:`imaplib` module, :class:`IMAP4` is " "the base class:" msgstr "" -#: ../src/Doc/library/imaplib.rst:35 +#: library/imaplib.rst:35 msgid "" "This class implements the actual IMAP4 protocol. The connection is created " "and protocol version (IMAP4 or IMAP4rev1) is determined when the instance is " @@ -49650,24 +50795,24 @@ msgid "" "*port* is omitted, the standard IMAP4 port (143) is used." msgstr "" -#: ../src/Doc/library/imaplib.rst:40 +#: library/imaplib.rst:40 msgid "Three exceptions are defined as attributes of the :class:`IMAP4` class:" msgstr "" -#: ../src/Doc/library/imaplib.rst:45 +#: library/imaplib.rst:45 msgid "" "Exception raised on any errors. The reason for the exception is passed to " "the constructor as a string." msgstr "" -#: ../src/Doc/library/imaplib.rst:51 +#: library/imaplib.rst:51 msgid "" "IMAP4 server errors cause this exception to be raised. This is a sub-class " "of :exc:`IMAP4.error`. Note that closing the instance and instantiating a " "new one will usually allow recovery from this exception." msgstr "" -#: ../src/Doc/library/imaplib.rst:58 +#: library/imaplib.rst:58 msgid "" "This exception is raised when a writable mailbox has its status changed by " "the server. This is a sub-class of :exc:`IMAP4.error`. Some other client " @@ -49675,11 +50820,11 @@ msgid "" "obtain write permission." msgstr "" -#: ../src/Doc/library/imaplib.rst:63 +#: library/imaplib.rst:63 msgid "There's also a subclass for secure connections:" msgstr "" -#: ../src/Doc/library/imaplib.rst:68 +#: library/imaplib.rst:68 msgid "" "This is a subclass derived from :class:`IMAP4` that connects over an SSL " "encrypted socket (to use this class you need a socket module that was " @@ -49689,41 +50834,41 @@ msgid "" "PEM formatted private key and certificate chain file for the SSL connection." msgstr "" -#: ../src/Doc/library/imaplib.rst:75 +#: library/imaplib.rst:75 msgid "The second subclass allows for connections created by a child process:" msgstr "" # 50a4ad35fe4a4a57aff3657e319492b8 -#: ../src/Doc/library/imaplib.rst:80 +#: library/imaplib.rst:80 msgid "" "This is a subclass derived from :class:`IMAP4` that connects to the ``stdin/" "stdout`` file descriptors created by passing *command* to ``os.popen2()``." msgstr "" -#: ../src/Doc/library/imaplib.rst:86 +#: library/imaplib.rst:86 msgid "The following utility functions are defined:" msgstr "" # 09f83e9ac69744eb9bc6f5957e8f2114 -#: ../src/Doc/library/imaplib.rst:91 +#: library/imaplib.rst:91 msgid "" "Parse an IMAP4 ``INTERNALDATE`` string and return corresponding local time. " "The return value is a :class:`time.struct_time` instance or None if the " "string has wrong format." msgstr "" -#: ../src/Doc/library/imaplib.rst:97 +#: library/imaplib.rst:97 msgid "" "Converts an integer into a string representation using characters from the " "set [``A`` .. ``P``]." msgstr "" -#: ../src/Doc/library/imaplib.rst:103 +#: library/imaplib.rst:103 msgid "Converts an IMAP4 ``FLAGS`` response to a tuple of individual flags." msgstr "" # a25bd746b96e4cd1bbe068452bbe7eb5 -#: ../src/Doc/library/imaplib.rst:108 +#: library/imaplib.rst:108 msgid "" "Convert *date_time* to an IMAP4 ``INTERNALDATE`` representation. The return " "value is a string in the form: ``\"DD-Mmm-YYYY HH:MM:SS +HHMM\"`` (including " @@ -49734,7 +50879,7 @@ msgid "" "correct format." msgstr "" -#: ../src/Doc/library/imaplib.rst:116 +#: library/imaplib.rst:116 msgid "" "Note that IMAP4 message numbers change as the mailbox changes; in " "particular, after an ``EXPUNGE`` command performs deletions the remaining " @@ -49742,30 +50887,30 @@ msgid "" "the UID command." msgstr "" -#: ../src/Doc/library/imaplib.rst:120 ../src/Doc/library/poplib.rst:198 +#: library/imaplib.rst:120 library/poplib.rst:198 msgid "" "At the end of the module, there is a test section that contains a more " "extensive example of usage." msgstr "" -#: ../src/Doc/library/imaplib.rst:126 +#: library/imaplib.rst:126 msgid "" "Documents describing the protocol, and sources and binaries for servers " "implementing it, can all be found at the University of Washington's *IMAP " "Information Center* (http://www.washington.edu/imap/)." msgstr "" -#: ../src/Doc/library/imaplib.rst:134 +#: library/imaplib.rst:134 msgid "IMAP4 Objects" msgstr "" -#: ../src/Doc/library/imaplib.rst:136 +#: library/imaplib.rst:136 msgid "" "All IMAP4rev1 commands are represented by methods of the same name, either " "upper-case or lower-case." msgstr "" -#: ../src/Doc/library/imaplib.rst:139 +#: library/imaplib.rst:139 msgid "" "All arguments to commands are converted to strings, except for " "``AUTHENTICATE``, and the last argument to ``APPEND`` which is passed as an " @@ -49777,7 +50922,7 @@ msgid "" "(eg: ``r'(\\Deleted)'``)." msgstr "" -#: ../src/Doc/library/imaplib.rst:147 +#: library/imaplib.rst:147 msgid "" "Each command returns a tuple: ``(type, [data, ...])`` where *type* is " "usually ``'OK'`` or ``'NO'``, and *data* is either the text from the command " @@ -49786,7 +50931,7 @@ msgid "" "response, and the second part contains the data (ie: 'literal' value)." msgstr "" -#: ../src/Doc/library/imaplib.rst:153 +#: library/imaplib.rst:153 msgid "" "The *message_set* options to commands below is a string specifying one or " "more messages to be acted upon. It may be a simple message number " @@ -49795,145 +50940,145 @@ msgid "" "an asterisk to indicate an infinite upper bound (``'3:*'``)." msgstr "" -#: ../src/Doc/library/imaplib.rst:159 +#: library/imaplib.rst:159 msgid "An :class:`IMAP4` instance has the following methods:" msgstr "" -#: ../src/Doc/library/imaplib.rst:164 +#: library/imaplib.rst:164 msgid "Append *message* to named mailbox." msgstr "" -#: ../src/Doc/library/imaplib.rst:169 +#: library/imaplib.rst:169 msgid "Authenticate command --- requires response processing." msgstr "" -#: ../src/Doc/library/imaplib.rst:171 +#: library/imaplib.rst:171 msgid "" "*mechanism* specifies which authentication mechanism is to be used - it " "should appear in the instance variable ``capabilities`` in the form " "``AUTH=mechanism``." msgstr "" -#: ../src/Doc/library/imaplib.rst:174 +#: library/imaplib.rst:174 msgid "*authobject* must be a callable object::" msgstr "" -#: ../src/Doc/library/imaplib.rst:178 +#: library/imaplib.rst:178 msgid "" "It will be called to process server continuation responses. It should return " "``data`` that will be encoded and sent to server. It should return ``None`` " "if the client abort response ``*`` should be sent instead." msgstr "" -#: ../src/Doc/library/imaplib.rst:185 +#: library/imaplib.rst:185 msgid "Checkpoint mailbox on server." msgstr "" -#: ../src/Doc/library/imaplib.rst:190 +#: library/imaplib.rst:190 msgid "" "Close currently selected mailbox. Deleted messages are removed from writable " "mailbox. This is the recommended command before ``LOGOUT``." msgstr "" -#: ../src/Doc/library/imaplib.rst:196 +#: library/imaplib.rst:196 msgid "Copy *message_set* messages onto end of *new_mailbox*." msgstr "" -#: ../src/Doc/library/imaplib.rst:201 +#: library/imaplib.rst:201 msgid "Create new mailbox named *mailbox*." msgstr "" -#: ../src/Doc/library/imaplib.rst:206 +#: library/imaplib.rst:206 msgid "Delete old mailbox named *mailbox*." msgstr "" -#: ../src/Doc/library/imaplib.rst:211 +#: library/imaplib.rst:211 msgid "Delete the ACLs (remove any rights) set for who on mailbox." msgstr "" -#: ../src/Doc/library/imaplib.rst:218 +#: library/imaplib.rst:218 msgid "" "Permanently remove deleted items from selected mailbox. Generates an " "``EXPUNGE`` response for each deleted message. Returned data contains a list " "of ``EXPUNGE`` message numbers in order received." msgstr "" -#: ../src/Doc/library/imaplib.rst:225 +#: library/imaplib.rst:225 msgid "" "Fetch (parts of) messages. *message_parts* should be a string of message " "part names enclosed within parentheses, eg: ``\"(UID BODY[TEXT])\"``. " "Returned data are tuples of message part envelope and data." msgstr "" -#: ../src/Doc/library/imaplib.rst:232 +#: library/imaplib.rst:232 msgid "" "Get the ``ACL``\\ s for *mailbox*. The method is non-standard, but is " "supported by the ``Cyrus`` server." msgstr "" -#: ../src/Doc/library/imaplib.rst:238 +#: library/imaplib.rst:238 msgid "" "Retrieve the specified ``ANNOTATION``\\ s for *mailbox*. The method is non-" "standard, but is supported by the ``Cyrus`` server." msgstr "" -#: ../src/Doc/library/imaplib.rst:246 +#: library/imaplib.rst:246 msgid "" "Get the ``quota`` *root*'s resource usage and limits. This method is part of " "the IMAP4 QUOTA extension defined in rfc2087." msgstr "" -#: ../src/Doc/library/imaplib.rst:254 +#: library/imaplib.rst:254 msgid "" "Get the list of ``quota`` ``roots`` for the named *mailbox*. This method is " "part of the IMAP4 QUOTA extension defined in rfc2087." msgstr "" -#: ../src/Doc/library/imaplib.rst:262 +#: library/imaplib.rst:262 msgid "" "List mailbox names in *directory* matching *pattern*. *directory* defaults " "to the top-level mail folder, and *pattern* defaults to match anything. " "Returned data contains a list of ``LIST`` responses." msgstr "" -#: ../src/Doc/library/imaplib.rst:269 +#: library/imaplib.rst:269 msgid "" "Identify the client using a plaintext password. The *password* will be " "quoted." msgstr "" -#: ../src/Doc/library/imaplib.rst:274 +#: library/imaplib.rst:274 msgid "" "Force use of ``CRAM-MD5`` authentication when identifying the client to " "protect the password. Will only work if the server ``CAPABILITY`` response " "includes the phrase ``AUTH=CRAM-MD5``." msgstr "" -#: ../src/Doc/library/imaplib.rst:283 +#: library/imaplib.rst:283 msgid "Shutdown connection to server. Returns server ``BYE`` response." msgstr "" -#: ../src/Doc/library/imaplib.rst:288 +#: library/imaplib.rst:288 msgid "" "List subscribed mailbox names in directory matching pattern. *directory* " "defaults to the top level directory and *pattern* defaults to match any " "mailbox. Returned data are tuples of message part envelope and data." msgstr "" -#: ../src/Doc/library/imaplib.rst:295 +#: library/imaplib.rst:295 msgid "Show my ACLs for a mailbox (i.e. the rights that I have on mailbox)." msgstr "" -#: ../src/Doc/library/imaplib.rst:302 +#: library/imaplib.rst:302 msgid "Returns IMAP namespaces as defined in RFC2342." msgstr "" -#: ../src/Doc/library/imaplib.rst:309 +#: library/imaplib.rst:309 msgid "Send ``NOOP`` to server." msgstr "" # 4797f59d4ad94530b2615bf5066ce394 -#: ../src/Doc/library/imaplib.rst:314 +#: library/imaplib.rst:314 msgid "" "Opens socket to *port* at *host*. This method is implicitly called by the :" "class:`IMAP4` constructor. The connection objects established by this " @@ -49942,44 +51087,44 @@ msgid "" "method." msgstr "" -#: ../src/Doc/library/imaplib.rst:323 +#: library/imaplib.rst:323 msgid "" "Fetch truncated part of a message. Returned data is a tuple of message part " "envelope and data." msgstr "" -#: ../src/Doc/library/imaplib.rst:329 +#: library/imaplib.rst:329 msgid "" "Assume authentication as *user*. Allows an authorised administrator to proxy " "into any user's mailbox." msgstr "" -#: ../src/Doc/library/imaplib.rst:337 +#: library/imaplib.rst:337 msgid "" "Reads *size* bytes from the remote server. You may override this method." msgstr "" -#: ../src/Doc/library/imaplib.rst:342 +#: library/imaplib.rst:342 msgid "Reads one line from the remote server. You may override this method." msgstr "" -#: ../src/Doc/library/imaplib.rst:347 +#: library/imaplib.rst:347 msgid "" "Prompt server for an update. Returned data is ``None`` if no new messages, " "else value of ``RECENT`` response." msgstr "" -#: ../src/Doc/library/imaplib.rst:353 +#: library/imaplib.rst:353 msgid "Rename mailbox named *oldmailbox* to *newmailbox*." msgstr "" -#: ../src/Doc/library/imaplib.rst:358 +#: library/imaplib.rst:358 msgid "" "Return data for response *code* if received, or ``None``. Returns the given " "code, instead of the usual type." msgstr "" -#: ../src/Doc/library/imaplib.rst:364 +#: library/imaplib.rst:364 msgid "" "Search mailbox for matching messages. *charset* may be ``None``, in which " "case no ``CHARSET`` will be specified in the request to the server. The " @@ -49987,54 +51132,54 @@ msgid "" "exception will be raised when the server returns an error." msgstr "" -#: ../src/Doc/library/imaplib.rst:380 +#: library/imaplib.rst:380 msgid "" "Select a mailbox. Returned data is the count of messages in *mailbox* " "(``EXISTS`` response). The default *mailbox* is ``'INBOX'``. If the " "*readonly* flag is set, modifications to the mailbox are not allowed." msgstr "" -#: ../src/Doc/library/imaplib.rst:387 +#: library/imaplib.rst:387 msgid "Sends ``data`` to the remote server. You may override this method." msgstr "" -#: ../src/Doc/library/imaplib.rst:392 +#: library/imaplib.rst:392 msgid "" "Set an ``ACL`` for *mailbox*. The method is non-standard, but is supported " "by the ``Cyrus`` server." msgstr "" -#: ../src/Doc/library/imaplib.rst:398 +#: library/imaplib.rst:398 msgid "" "Set ``ANNOTATION``\\ s for *mailbox*. The method is non-standard, but is " "supported by the ``Cyrus`` server." msgstr "" -#: ../src/Doc/library/imaplib.rst:406 +#: library/imaplib.rst:406 msgid "" "Set the ``quota`` *root*'s resource *limits*. This method is part of the " "IMAP4 QUOTA extension defined in rfc2087." msgstr "" # b4288a130d114a90829e1ed81185b43c -#: ../src/Doc/library/imaplib.rst:414 +#: library/imaplib.rst:414 msgid "" "Close connection established in ``open``. This method is implicitly called " "by :meth:`IMAP4.logout`. You may override this method." msgstr "" -#: ../src/Doc/library/imaplib.rst:420 +#: library/imaplib.rst:420 msgid "Returns socket instance used to connect to server." msgstr "" -#: ../src/Doc/library/imaplib.rst:425 +#: library/imaplib.rst:425 msgid "" "The ``sort`` command is a variant of ``search`` with sorting semantics for " "the results. Returned data contains a space separated list of matching " "message numbers." msgstr "" -#: ../src/Doc/library/imaplib.rst:429 +#: library/imaplib.rst:429 msgid "" "Sort has two arguments before the *search_criterion* argument(s); a " "parenthesized list of *sort_criteria*, and the searching *charset*. Note " @@ -50046,43 +51191,43 @@ msgid "" "searching criteria. It then returns the numbers of matching messages." msgstr "" -#: ../src/Doc/library/imaplib.rst:438 ../src/Doc/library/imaplib.rst:483 +#: library/imaplib.rst:438 library/imaplib.rst:483 msgid "This is an ``IMAP4rev1`` extension command." msgstr "" -#: ../src/Doc/library/imaplib.rst:443 +#: library/imaplib.rst:443 msgid "Request named status conditions for *mailbox*." msgstr "" -#: ../src/Doc/library/imaplib.rst:448 +#: library/imaplib.rst:448 msgid "" "Alters flag dispositions for messages in mailbox. *command* is specified by " "section 6.4.6 of :rfc:`2060` as being one of \"FLAGS\", \"+FLAGS\", or \"-" "FLAGS\", optionally with a suffix of \".SILENT\"." msgstr "" -#: ../src/Doc/library/imaplib.rst:452 +#: library/imaplib.rst:452 msgid "For example, to set the delete flag on all messages::" msgstr "" -#: ../src/Doc/library/imaplib.rst:462 +#: library/imaplib.rst:462 msgid "Subscribe to new mailbox." msgstr "" -#: ../src/Doc/library/imaplib.rst:467 +#: library/imaplib.rst:467 msgid "" "The ``thread`` command is a variant of ``search`` with threading semantics " "for the results. Returned data contains a space separated list of thread " "members." msgstr "" -#: ../src/Doc/library/imaplib.rst:470 +#: library/imaplib.rst:470 msgid "" "Thread members consist of zero or more messages numbers, delimited by " "spaces, indicating successive parent and child." msgstr "" -#: ../src/Doc/library/imaplib.rst:473 +#: library/imaplib.rst:473 msgid "" "Thread has two arguments before the *search_criterion* argument(s); a " "*threading_algorithm*, and the searching *charset*. Note that unlike " @@ -50095,7 +51240,7 @@ msgid "" "specified threading algorithm." msgstr "" -#: ../src/Doc/library/imaplib.rst:490 +#: library/imaplib.rst:490 msgid "" "Execute command args with messages identified by UID, rather than message " "number. Returns response appropriate to command. At least one argument " @@ -50103,61 +51248,65 @@ msgid "" "an exception will be raised." msgstr "" -#: ../src/Doc/library/imaplib.rst:498 +#: library/imaplib.rst:498 msgid "Unsubscribe from old mailbox." msgstr "" -#: ../src/Doc/library/imaplib.rst:503 +#: library/imaplib.rst:503 msgid "" "Allow simple extension commands notified by server in ``CAPABILITY`` " "response." msgstr "" # 2dd1414dbb474c9a9d477dab4a2399d3 -#: ../src/Doc/library/imaplib.rst:505 +#: library/imaplib.rst:505 msgid "Instances of :class:`IMAP4_SSL` have just one additional method:" msgstr "" # 1547e2568b0f4ec3ae555d94e021edd3 -#: ../src/Doc/library/imaplib.rst:510 +#: library/imaplib.rst:510 msgid "" "Returns SSLObject instance used for the secure connection with the server." msgstr "" -#: ../src/Doc/library/imaplib.rst:512 +#: library/imaplib.rst:512 msgid "The following attributes are defined on instances of :class:`IMAP4`:" msgstr "" -#: ../src/Doc/library/imaplib.rst:517 +#: library/imaplib.rst:517 msgid "" "The most recent supported protocol in the ``CAPABILITY`` response from the " "server." msgstr "" -#: ../src/Doc/library/imaplib.rst:523 +#: library/imaplib.rst:523 msgid "" "Integer value to control debugging output. The initialize value is taken " "from the module variable ``Debug``. Values greater than three trace each " "command." msgstr "" -#: ../src/Doc/library/imaplib.rst:530 +#: library/imaplib.rst:530 msgid "IMAP4 Example" msgstr "" -#: ../src/Doc/library/imaplib.rst:532 ../src/Doc/library/poplib.rst:185 +#: library/imaplib.rst:532 library/poplib.rst:185 msgid "" "Here is a minimal example (without error checking) that opens a mailbox and " "retrieves and prints all messages::" msgstr "" # 7dcf1e955d424252bf8843d22155d84d -#: ../src/Doc/library/imgfile.rst:3 +#: library/imgfile.rst:3 msgid ":mod:`imgfile` --- Support for SGI imglib files" msgstr "" +#: library/imgfile.rst:10 +msgid "The :mod:`imgfile` module has been removed in Python 3." +msgstr "" + # 7bcae4bdfe504651bdb7c25f5753654f -#: ../src/Doc/library/imgfile.rst:15 +#: library/imgfile.rst:15 msgid "" "The :mod:`imgfile` module allows Python programs to access SGI imglib image " "files (also known as :file:`.rgb` files). The module is far from complete, " @@ -50166,13 +51315,13 @@ msgid "" msgstr "" # dea8be1bb9cd413b9e0802122cc2ad8f -#: ../src/Doc/library/imgfile.rst:25 +#: library/imgfile.rst:25 msgid "" "This exception is raised on all errors, such as unsupported file type, etc." msgstr "" # e36e2016cb084f6ea947818004ead2a7 -#: ../src/Doc/library/imgfile.rst:30 +#: library/imgfile.rst:30 msgid "" "This function returns a tuple ``(x, y, z)`` where *x* and *y* are the size " "of the image in pixels and *z* is the number of bytes per pixel. Only 3 byte " @@ -50180,7 +51329,7 @@ msgid "" msgstr "" # 7a8f73a938324712b15e2595290f5a71 -#: ../src/Doc/library/imgfile.rst:37 +#: library/imgfile.rst:37 msgid "" "This function reads and decodes the image on the specified file, and returns " "it as a Python string. The string has either 1 byte greyscale pixels or 4 " @@ -50189,7 +51338,7 @@ msgid "" msgstr "" # df6a4bd7949d4bbc960e482c48b536a0 -#: ../src/Doc/library/imgfile.rst:45 +#: library/imgfile.rst:45 msgid "" "This function is identical to read but it returns an image that is scaled to " "the given *x* and *y* sizes. If the *filter* and *blur* parameters are " @@ -50198,7 +51347,7 @@ msgid "" msgstr "" # e403c76138c74d3fa484a3119839e116 -#: ../src/Doc/library/imgfile.rst:50 +#: library/imgfile.rst:50 msgid "" "Alternatively, you can specify a filter to use to smooth the image after " "scaling. The filter forms supported are ``'impulse'``, ``'box'``, " @@ -50208,14 +51357,14 @@ msgid "" msgstr "" # 20bc7ae835264547bc3fe1bb29f2ea61 -#: ../src/Doc/library/imgfile.rst:56 +#: library/imgfile.rst:56 msgid "" ":func:`readscaled` makes no attempt to keep the aspect ratio correct, so " "that is the users' responsibility." msgstr "" # 7b14290f16c24ad6ab894ae8856d5e80 -#: ../src/Doc/library/imgfile.rst:62 +#: library/imgfile.rst:62 msgid "" "This function sets a global flag which defines whether the scan lines of the " "image are read or written from bottom to top (flag is zero, compatible with " @@ -50224,7 +51373,7 @@ msgid "" msgstr "" # 8d89021a1b1d42bb8663b51840a35fd1 -#: ../src/Doc/library/imgfile.rst:69 +#: library/imgfile.rst:69 msgid "" "This function writes the RGB or greyscale data in *data* to image file " "*file*. *x* and *y* give the size of the image, *z* is 1 for 1 byte " @@ -50233,167 +51382,171 @@ msgid "" "by :func:`gl.lrectread`." msgstr "" -#: ../src/Doc/library/imghdr.rst:2 +#: library/imghdr.rst:2 msgid ":mod:`imghdr` --- Determine the type of an image" msgstr "" # 09e35c29426a483fa6cae5a2ab7a8a66 -#: ../src/Doc/library/imghdr.rst:7 +#: library/imghdr.rst:7 msgid "**Source code:** :source:`Lib/imghdr.py`" msgstr "" -#: ../src/Doc/library/imghdr.rst:11 +#: library/imghdr.rst:11 msgid "" "The :mod:`imghdr` module determines the type of image contained in a file or " "byte stream." msgstr "" -#: ../src/Doc/library/imghdr.rst:14 +#: library/imghdr.rst:14 msgid "The :mod:`imghdr` module defines the following function:" msgstr "" -#: ../src/Doc/library/imghdr.rst:19 +#: library/imghdr.rst:19 msgid "" "Tests the image data contained in the file named by *filename*, and returns " "a string describing the image type. If optional *h* is provided, the " "*filename* is ignored and *h* is assumed to contain the byte stream to test." msgstr "" -#: ../src/Doc/library/imghdr.rst:23 +#: library/imghdr.rst:23 msgid "" "The following image types are recognized, as listed below with the return " "value from :func:`what`:" msgstr "" -#: ../src/Doc/library/imghdr.rst:27 +#: library/imghdr.rst:27 msgid "Image format" msgstr "" -#: ../src/Doc/library/imghdr.rst:29 +#: library/imghdr.rst:29 msgid "``'rgb'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:29 +#: library/imghdr.rst:29 msgid "SGI ImgLib Files" msgstr "" -#: ../src/Doc/library/imghdr.rst:31 +#: library/imghdr.rst:31 msgid "``'gif'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:31 +#: library/imghdr.rst:31 msgid "GIF 87a and 89a Files" msgstr "" -#: ../src/Doc/library/imghdr.rst:33 +#: library/imghdr.rst:33 msgid "``'pbm'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:33 +#: library/imghdr.rst:33 msgid "Portable Bitmap Files" msgstr "" -#: ../src/Doc/library/imghdr.rst:35 +#: library/imghdr.rst:35 msgid "``'pgm'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:35 +#: library/imghdr.rst:35 msgid "Portable Graymap Files" msgstr "" -#: ../src/Doc/library/imghdr.rst:37 +#: library/imghdr.rst:37 msgid "``'ppm'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:37 +#: library/imghdr.rst:37 msgid "Portable Pixmap Files" msgstr "" -#: ../src/Doc/library/imghdr.rst:39 +#: library/imghdr.rst:39 msgid "``'tiff'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:39 +#: library/imghdr.rst:39 msgid "TIFF Files" msgstr "" -#: ../src/Doc/library/imghdr.rst:41 +#: library/imghdr.rst:41 msgid "``'rast'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:41 +#: library/imghdr.rst:41 msgid "Sun Raster Files" msgstr "" -#: ../src/Doc/library/imghdr.rst:43 +#: library/imghdr.rst:43 msgid "``'xbm'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:43 +#: library/imghdr.rst:43 msgid "X Bitmap Files" msgstr "" -#: ../src/Doc/library/imghdr.rst:45 +#: library/imghdr.rst:45 msgid "``'jpeg'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:45 +#: library/imghdr.rst:45 msgid "JPEG data in JFIF or Exif formats" msgstr "" -#: ../src/Doc/library/imghdr.rst:47 +#: library/imghdr.rst:47 msgid "``'bmp'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:47 +#: library/imghdr.rst:47 msgid "BMP files" msgstr "" -#: ../src/Doc/library/imghdr.rst:49 +#: library/imghdr.rst:49 msgid "``'png'``" msgstr "" -#: ../src/Doc/library/imghdr.rst:49 +#: library/imghdr.rst:49 msgid "Portable Network Graphics" msgstr "" -#: ../src/Doc/library/imghdr.rst:55 +#: library/imghdr.rst:52 +msgid "Exif detection." +msgstr "" + +#: library/imghdr.rst:55 msgid "" "You can extend the list of file types :mod:`imghdr` can recognize by " "appending to this variable:" msgstr "" -#: ../src/Doc/library/imghdr.rst:61 +#: library/imghdr.rst:61 msgid "" "A list of functions performing the individual tests. Each function takes " "two arguments: the byte-stream and an open file-like object. When :func:" "`what` is called with a byte-stream, the file-like object will be ``None``." msgstr "" -#: ../src/Doc/library/imghdr.rst:65 +#: library/imghdr.rst:65 msgid "" "The test function should return a string describing the image type if the " "test succeeded, or ``None`` if it failed." msgstr "" -#: ../src/Doc/library/imp.rst:3 +#: library/imp.rst:3 msgid ":mod:`imp` --- Access the :keyword:`import` internals" msgstr "" -#: ../src/Doc/library/imp.rst:11 +#: library/imp.rst:11 msgid "" "This module provides an interface to the mechanisms used to implement the :" "keyword:`import` statement. It defines the following constants and " "functions:" msgstr "" -#: ../src/Doc/library/imp.rst:19 +#: library/imp.rst:19 msgid "" "Return the magic string value used to recognize byte-compiled code files (:" "file:`.pyc` files). (This value may be different for each Python version.)" msgstr "" -#: ../src/Doc/library/imp.rst:25 +#: library/imp.rst:25 msgid "" "Return a list of 3-element tuples, each describing a particular type of " "module. Each triple has the form ``(suffix, mode, type)``, where *suffix* is " @@ -50404,7 +51557,7 @@ msgid "" "`PY_SOURCE`, :const:`PY_COMPILED`, or :const:`C_EXTENSION`, described below." msgstr "" -#: ../src/Doc/library/imp.rst:37 +#: library/imp.rst:37 msgid "" "Try to find the module *name*. If *path* is omitted or ``None``, the list " "of directory names given by ``sys.path`` is searched, but first a few " @@ -50414,7 +51567,7 @@ msgid "" "(on Windows, it looks in the registry which may point to a specific file)." msgstr "" -#: ../src/Doc/library/imp.rst:44 +#: library/imp.rst:44 msgid "" "Otherwise, *path* must be a list of directory names; each directory is " "searched for files with any of the suffixes returned by :func:`get_suffixes` " @@ -50422,13 +51575,13 @@ msgid "" "must be strings)." msgstr "" -#: ../src/Doc/library/imp.rst:49 +#: library/imp.rst:49 msgid "" "If search is successful, the return value is a 3-element tuple ``(file, " "pathname, description)``:" msgstr "" -#: ../src/Doc/library/imp.rst:52 +#: library/imp.rst:52 msgid "" "*file* is an open file object positioned at the beginning, *pathname* is the " "pathname of the file found, and *description* is a 3-element tuple as " @@ -50436,7 +51589,7 @@ msgid "" "of module found." msgstr "" -#: ../src/Doc/library/imp.rst:57 +#: library/imp.rst:57 msgid "" "If the module does not live in a file, the returned *file* is ``None``, " "*pathname* is the empty string, and the *description* tuple contains empty " @@ -50446,14 +51599,14 @@ msgid "" "environment." msgstr "" -#: ../src/Doc/library/imp.rst:64 +#: library/imp.rst:64 msgid "" "If the module is a package, *file* is ``None``, *pathname* is the package " "path and the last item in the *description* tuple is :const:`PKG_DIRECTORY`." msgstr "" # e1c79b6eaea04627863f2690fee4b61d -#: ../src/Doc/library/imp.rst:67 +#: library/imp.rst:67 msgid "" "This function does not handle hierarchical module names (names containing " "dots). In order to find *P.M*, that is, submodule *M* of package *P*, use :" @@ -50463,7 +51616,7 @@ msgid "" msgstr "" # a22ab6eedc534dca9be668cac0c18887 -#: ../src/Doc/library/imp.rst:78 +#: library/imp.rst:78 msgid "" "Load a module that was previously found by :func:`find_module` (or by an " "otherwise conducted search yielding compatible results). This function does " @@ -50477,32 +51630,32 @@ msgid "" "`get_suffixes`, describing what kind of module must be loaded." msgstr "" -#: ../src/Doc/library/imp.rst:89 +#: library/imp.rst:89 msgid "" "If the load is successful, the return value is the module object; otherwise, " "an exception (usually :exc:`ImportError`) is raised." msgstr "" -#: ../src/Doc/library/imp.rst:92 +#: library/imp.rst:92 msgid "" "**Important:** the caller is responsible for closing the *file* argument, if " "it was not ``None``, even when an exception is raised. This is best done " "using a :keyword:`try` ... :keyword:`finally` statement." msgstr "" -#: ../src/Doc/library/imp.rst:99 +#: library/imp.rst:99 msgid "" "Return a new empty module object called *name*. This object is *not* " "inserted in ``sys.modules``." msgstr "" -#: ../src/Doc/library/imp.rst:105 +#: library/imp.rst:105 msgid "" "Return ``True`` if the import lock is currently held, else ``False``. On " "platforms without threads, always return ``False``." msgstr "" -#: ../src/Doc/library/imp.rst:108 +#: library/imp.rst:108 msgid "" "On platforms with threads, a thread executing an import holds an internal " "lock until the import is complete. This lock blocks other threads from doing " @@ -50513,72 +51666,72 @@ msgid "" msgstr "" # 69704aa9f9f0465dbac8c14fb98aa392 -#: ../src/Doc/library/imp.rst:118 +#: library/imp.rst:118 msgid "" "Acquire the interpreter's import lock for the current thread. This lock " "should be used by import hooks to ensure thread-safety when importing " "modules." msgstr "" -#: ../src/Doc/library/imp.rst:121 +#: library/imp.rst:121 msgid "" "Once a thread has acquired the import lock, the same thread may acquire it " "again without blocking; the thread must release it once for each time it has " "acquired it." msgstr "" -#: ../src/Doc/library/imp.rst:125 +#: library/imp.rst:125 msgid "On platforms without threads, this function does nothing." msgstr "" -#: ../src/Doc/library/imp.rst:132 +#: library/imp.rst:132 msgid "" "Release the interpreter's import lock. On platforms without threads, this " "function does nothing." msgstr "" -#: ../src/Doc/library/imp.rst:137 +#: library/imp.rst:137 msgid "" "The following constants with integer values, defined in this module, are " "used to indicate the search result of :func:`find_module`." msgstr "" -#: ../src/Doc/library/imp.rst:143 +#: library/imp.rst:143 msgid "The module was found as a source file." msgstr "" -#: ../src/Doc/library/imp.rst:148 +#: library/imp.rst:148 msgid "The module was found as a compiled code object file." msgstr "" -#: ../src/Doc/library/imp.rst:153 +#: library/imp.rst:153 msgid "The module was found as dynamically loadable shared library." msgstr "" -#: ../src/Doc/library/imp.rst:158 +#: library/imp.rst:158 msgid "The module was found as a package directory." msgstr "" -#: ../src/Doc/library/imp.rst:163 +#: library/imp.rst:163 msgid "The module was found as a built-in module." msgstr "" -#: ../src/Doc/library/imp.rst:168 +#: library/imp.rst:168 msgid "The module was found as a frozen module (see :func:`init_frozen`)." msgstr "" -#: ../src/Doc/library/imp.rst:170 +#: library/imp.rst:170 msgid "" "The following constant and functions are obsolete; their functionality is " "available through :func:`find_module` or :func:`load_module`. They are kept " "around for backward compatibility:" msgstr "" -#: ../src/Doc/library/imp.rst:177 +#: library/imp.rst:177 msgid "Unused." msgstr "" -#: ../src/Doc/library/imp.rst:182 +#: library/imp.rst:182 msgid "" "Initialize the built-in module called *name* and return its module object " "along with storing it in ``sys.modules``. If the module was already " @@ -50588,7 +51741,7 @@ msgid "" "called *name*, ``None`` is returned." msgstr "" -#: ../src/Doc/library/imp.rst:192 +#: library/imp.rst:192 msgid "" "Initialize the frozen module called *name* and return its module object. If " "the module was already initialized, it will be initialized *again*. If " @@ -50598,7 +51751,7 @@ msgid "" "`freeze` utility. See :file:`Tools/freeze/` for now.)" msgstr "" -#: ../src/Doc/library/imp.rst:202 +#: library/imp.rst:202 msgid "" "Return ``1`` if there is a built-in module called *name* which can be " "initialized again. Return ``-1`` if there is a built-in module called " @@ -50606,13 +51759,13 @@ msgid "" "``0`` if there is no built-in module called *name*." msgstr "" -#: ../src/Doc/library/imp.rst:210 +#: library/imp.rst:210 msgid "" "Return ``True`` if there is a frozen module (see :func:`init_frozen`) called " "*name*, or ``False`` if there is no such module." msgstr "" -#: ../src/Doc/library/imp.rst:218 +#: library/imp.rst:218 msgid "" "Load and initialize a module implemented as a byte-compiled code file and " "return its module object. If the module was already initialized, it will be " @@ -50623,7 +51776,7 @@ msgid "" "not a user-defined class emulating a file." msgstr "" -#: ../src/Doc/library/imp.rst:229 +#: library/imp.rst:229 msgid "" "Load and initialize a module implemented as a dynamically loadable shared " "library and return its module object. If the module was already " @@ -50638,7 +51791,7 @@ msgid "" msgstr "" # c27090021840403797f781e65afd94d5 -#: ../src/Doc/library/imp.rst:242 +#: library/imp.rst:242 msgid "" "The import internals identify extension modules by filename, so doing ``foo " "= load_dynamic(\"foo\", \"mod.so\")`` and ``bar = load_dynamic(\"bar\", " @@ -50649,7 +51802,7 @@ msgid "" "different file name." msgstr "" -#: ../src/Doc/library/imp.rst:254 +#: library/imp.rst:254 msgid "" "Load and initialize a module implemented as a Python source file and return " "its module object. If the module was already initialized, it will be " @@ -50662,7 +51815,7 @@ msgid "" "parsing the given source file." msgstr "" -#: ../src/Doc/library/imp.rst:266 +#: library/imp.rst:266 msgid "" "The :class:`NullImporter` type is a :pep:`302` import hook that handles non-" "directory path strings by failing to find any modules. Calling this type " @@ -50670,20 +51823,20 @@ msgid "" "Otherwise, a :class:`NullImporter` instance is returned." msgstr "" -#: ../src/Doc/library/imp.rst:271 +#: library/imp.rst:271 msgid "" "Python adds instances of this type to ``sys.path_importer_cache`` for any " "path entries that are not directories and are not handled by any other path " "hooks on ``sys.path_hooks``. Instances have only one method:" msgstr "" -#: ../src/Doc/library/imp.rst:278 +#: library/imp.rst:278 msgid "" "This method always returns ``None``, indicating that the requested module " "could not be found." msgstr "" -#: ../src/Doc/library/imp.rst:289 +#: library/imp.rst:289 msgid "" "The following function emulates what was the standard import statement up to " "Python 1.4 (no hierarchical module names). (This *implementation* wouldn't " @@ -50691,7 +51844,7 @@ msgid "" "`load_module` has been added in 1.4.) ::" msgstr "" -#: ../src/Doc/library/imp.rst:320 +#: library/imp.rst:320 msgid "" "A more complete example that implements hierarchical module names and " "includes a :func:`reload` function can be found in the module :mod:`knee`. " @@ -50700,12 +51853,12 @@ msgid "" msgstr "" # 45739e7ec7e84582975c430ed5c5f17c -#: ../src/Doc/library/importlib.rst:2 +#: library/importlib.rst:2 msgid ":mod:`importlib` -- Convenience wrappers for :func:`__import__`" msgstr "" # 2c696d45ee4a485881a7c231cc050165 -#: ../src/Doc/library/importlib.rst:12 +#: library/importlib.rst:12 msgid "" "This module is a minor subset of what is available in the more full-featured " "package of the same name from Python 3.1 that provides a complete " @@ -50714,7 +51867,7 @@ msgid "" msgstr "" # 5e6b937320ee450e886a674b23c3d0e1 -#: ../src/Doc/library/importlib.rst:20 +#: library/importlib.rst:20 msgid "" "Import a module. The *name* argument specifies what module to import in " "absolute or relative terms (e.g. either ``pkg.mod`` or ``..mod``). If the " @@ -50726,12 +51879,16 @@ msgid "" msgstr "" # 9088befb406b47b4bc04a7fde5488b83 -#: ../src/Doc/library/imputil.rst:3 +#: library/imputil.rst:3 msgid ":mod:`imputil` --- Import utilities" msgstr "" +#: library/imputil.rst:9 +msgid "The :mod:`imputil` module has been removed in Python 3." +msgstr "" + # 518a9be97c9344acae03a3986d0f66e6 -#: ../src/Doc/library/imputil.rst:15 +#: library/imputil.rst:15 msgid "" "This module provides a very handy and useful mechanism for custom :keyword:" "`import` hooks. Compared to the older :mod:`ihooks` module, :mod:`imputil` " @@ -50740,17 +51897,17 @@ msgid "" msgstr "" # d24fa9f8f0274bc18f5e9a4685e9a3f3 -#: ../src/Doc/library/imputil.rst:23 +#: library/imputil.rst:23 msgid "Manage the import process." msgstr "" # 5968491d3adb41a1becaf06cad73f0d7 -#: ../src/Doc/library/imputil.rst:27 +#: library/imputil.rst:27 msgid "Install this ImportManager into the specified namespace." msgstr "" # 48bb63de0c6f4f98baeba46bdcce97e2 -#: ../src/Doc/library/imputil.rst:31 +#: library/imputil.rst:31 msgid "Restore the previous import mechanism." msgstr "" @@ -50759,70 +51916,69 @@ msgstr "" # a72d2007e2134d38a8a8aa669311bfe9 # a12f8d6bf8d5462faf3c07ddfa0d6aa6 # 86d5cd41ea254dffb36c1bab0a37c830 -#: ../src/Doc/library/imputil.rst:35 ../src/Doc/library/imputil.rst:87 -#: ../src/Doc/library/imputil.rst:91 ../src/Doc/library/imputil.rst:95 -#: ../src/Doc/library/imputil.rst:99 +#: library/imputil.rst:35 library/imputil.rst:87 library/imputil.rst:91 +#: library/imputil.rst:95 library/imputil.rst:99 msgid "Undocumented." msgstr "" # 0f0fab6fb2bf467cad0d6426e90cfddc -#: ../src/Doc/library/imputil.rst:40 +#: library/imputil.rst:40 msgid "Base class for replacing standard import functions." msgstr "" # 5946d25b09924307a3ffc5d8fbb0d600 -#: ../src/Doc/library/imputil.rst:44 +#: library/imputil.rst:44 msgid "Import a top-level module." msgstr "" # e6d85e76683d4eb5bb1011fd3fc3d294 -#: ../src/Doc/library/imputil.rst:48 +#: library/imputil.rst:48 msgid "Find and retrieve the code for the given module." msgstr "" # 53d54bbd884e4ad5a08e04ed86b7c038 -#: ../src/Doc/library/imputil.rst:50 +#: library/imputil.rst:50 msgid "" "*parent* specifies a parent module to define a context for importing. It may " "be ``None``, indicating no particular context for the search." msgstr "" # 335f2f8d24354b809256965340912213 -#: ../src/Doc/library/imputil.rst:53 +#: library/imputil.rst:53 msgid "*modname* specifies a single module (not dotted) within the parent." msgstr "" # aca11a017eb447b183a6b65192991746 -#: ../src/Doc/library/imputil.rst:55 +#: library/imputil.rst:55 msgid "" "*fqname* specifies the fully-qualified module name. This is a (potentially) " "dotted name from the \"root\" of the module namespace down to the modname." msgstr "" # 1d38b70b2cc84a27a11c174301da8c09 -#: ../src/Doc/library/imputil.rst:59 +#: library/imputil.rst:59 msgid "If there is no parent, then modname==fqname." msgstr "" # de7658d02e3a436a81710c4129990a43 -#: ../src/Doc/library/imputil.rst:61 +#: library/imputil.rst:61 msgid "This method should return ``None``, or a 3-tuple." msgstr "" # 3904b7d2869f4cce9f0c11671f7bc7d2 -#: ../src/Doc/library/imputil.rst:63 +#: library/imputil.rst:63 msgid "If the module was not found, then ``None`` should be returned." msgstr "" # 45d7d59bc0ac49e19143a9556a74a590 -#: ../src/Doc/library/imputil.rst:65 +#: library/imputil.rst:65 msgid "" "The first item of the 2- or 3-tuple should be the integer 0 or 1, specifying " "whether the module that was found is a package or not." msgstr "" # ba257415b5544888b90acc69d3a72257 -#: ../src/Doc/library/imputil.rst:68 +#: library/imputil.rst:68 msgid "" "The second item is the code object for the module (it will be executed " "within the new module's namespace). This item can also be a fully-loaded " @@ -50830,7 +51986,7 @@ msgid "" msgstr "" # fbffaae73d994d3598229ccddde1d499 -#: ../src/Doc/library/imputil.rst:72 +#: library/imputil.rst:72 msgid "" "The third item is a dictionary of name/value pairs that will be inserted " "into new module before the code object is executed. This is provided in case " @@ -50840,41 +51996,41 @@ msgid "" msgstr "" # bfd64c48a4344a5e8ab5b6861335eed7 -#: ../src/Doc/library/imputil.rst:82 +#: library/imputil.rst:82 msgid "" "Emulate the import mechanism for built-in and frozen modules. This is a sub-" "class of the :class:`Importer` class." msgstr "" # 916c52c3df9547fea348b1587a28fd54 -#: ../src/Doc/library/imputil.rst:106 +#: library/imputil.rst:106 msgid "This is a re-implementation of hierarchical module import." msgstr "" # 290f11c95794463e9378acb60a8364bf -#: ../src/Doc/library/imputil.rst:108 +#: library/imputil.rst:108 msgid "" "This code is intended to be read, not executed. However, it does work -- " "all you need to do to enable it is \"import knee\"." msgstr "" # 06828e8ae16a430d99cdf55d77509d00 -#: ../src/Doc/library/imputil.rst:111 +#: library/imputil.rst:111 msgid "(The name is a pun on the clunkier predecessor of this module, \"ni\".)" msgstr "" # a0ca532bcd3d4d8c8afac5b1c9d10a98 -#: ../src/Doc/library/imputil.rst:235 +#: library/imputil.rst:235 msgid "" "Also see the :mod:`importers` module (which can be found in :file:`Demo/" "imputil/` in the Python source distribution) for additional examples." msgstr "" -#: ../src/Doc/library/index.rst:5 +#: library/index.rst:5 msgid "The Python Standard Library" msgstr "" -#: ../src/Doc/library/index.rst:7 +#: library/index.rst:7 msgid "" "While :ref:`reference-index` describes the exact syntax and semantics of the " "Python language, this library reference manual describes the standard " @@ -50882,7 +52038,7 @@ msgid "" "optional components that are commonly included in Python distributions." msgstr "" -#: ../src/Doc/library/index.rst:13 +#: library/index.rst:13 msgid "" "Python's standard library is very extensive, offering a wide range of " "facilities as indicated by the long table of contents listed below. The " @@ -50895,9 +52051,9 @@ msgid "" "platform-neutral APIs." msgstr "" -#: ../src/Doc/library/index.rst:23 +#: library/index.rst:23 msgid "" -"The Python installers for the Windows platform usually includes the entire " +"The Python installers for the Windows platform usually include the entire " "standard library and often also include many additional components. For Unix-" "like operating systems Python is normally provided as a collection of " "packages, so it may be necessary to use the packaging tools provided with " @@ -50905,7 +52061,7 @@ msgid "" msgstr "" # 857c0dbaaaad4f62b433482b781b07f7 -#: ../src/Doc/library/index.rst:30 +#: library/index.rst:30 msgid "" "In addition to the standard library, there is a growing collection of " "several thousand components (from individual programs and modules to " @@ -50913,16 +52069,16 @@ msgid "" "`Python Package Index `_." msgstr "" -#: ../src/Doc/library/inspect.rst:2 +#: library/inspect.rst:2 msgid ":mod:`inspect` --- Inspect live objects" msgstr "" # 3b3498b1ad1341959d03424c8ea9b084 -#: ../src/Doc/library/inspect.rst:12 +#: library/inspect.rst:12 msgid "**Source code:** :source:`Lib/inspect.py`" msgstr "" -#: ../src/Doc/library/inspect.rst:16 +#: library/inspect.rst:16 msgid "" "The :mod:`inspect` module provides several useful functions to help get " "information about live objects such as modules, classes, methods, functions, " @@ -50932,18 +52088,18 @@ msgid "" "information you need to display a detailed traceback." msgstr "" -#: ../src/Doc/library/inspect.rst:23 +#: library/inspect.rst:23 msgid "" "There are four main kinds of services provided by this module: type " "checking, getting source code, inspecting classes and functions, and " "examining the interpreter stack." msgstr "" -#: ../src/Doc/library/inspect.rst:31 +#: library/inspect.rst:31 msgid "Types and members" msgstr "" -#: ../src/Doc/library/inspect.rst:33 +#: library/inspect.rst:33 msgid "" "The :func:`getmembers` function retrieves the members of an object such as a " "class or module. The sixteen functions whose names begin with \"is\" are " @@ -50952,498 +52108,499 @@ msgid "" "following special attributes:" msgstr "" -#: ../src/Doc/library/inspect.rst:42 ../src/Doc/library/logging.rst:652 +#: library/inspect.rst:42 library/logging.rst:657 msgid "module" msgstr "module" -#: ../src/Doc/library/inspect.rst:42 ../src/Doc/library/inspect.rst:47 -#: ../src/Doc/library/inspect.rst:52 ../src/Doc/library/inspect.rst:68 -#: ../src/Doc/library/inspect.rst:207 +#: library/inspect.rst:42 library/inspect.rst:47 library/inspect.rst:52 +#: library/inspect.rst:68 library/inspect.rst:207 msgid "__doc__" msgstr "" -#: ../src/Doc/library/inspect.rst:42 ../src/Doc/library/inspect.rst:47 -#: ../src/Doc/library/inspect.rst:52 ../src/Doc/library/inspect.rst:68 -#: ../src/Doc/library/inspect.rst:207 +#: library/inspect.rst:42 library/inspect.rst:47 library/inspect.rst:52 +#: library/inspect.rst:68 library/inspect.rst:207 msgid "documentation string" msgstr "" -#: ../src/Doc/library/inspect.rst:44 +#: library/inspect.rst:44 msgid "__file__" msgstr "" -#: ../src/Doc/library/inspect.rst:44 +#: library/inspect.rst:44 msgid "filename (missing for built-in modules)" msgstr "" -#: ../src/Doc/library/inspect.rst:47 ../src/Doc/library/ttk.rst:109 +#: library/inspect.rst:47 library/ttk.rst:109 msgid "class" msgstr "classe" -#: ../src/Doc/library/inspect.rst:49 +#: library/inspect.rst:49 msgid "__module__" msgstr "" -#: ../src/Doc/library/inspect.rst:49 +#: library/inspect.rst:49 msgid "name of module in which this class was defined" msgstr "" -#: ../src/Doc/library/inspect.rst:52 +#: library/inspect.rst:52 msgid "method" msgstr "méthode" -#: ../src/Doc/library/inspect.rst:54 ../src/Doc/library/inspect.rst:70 -#: ../src/Doc/library/inspect.rst:209 +#: library/inspect.rst:54 library/inspect.rst:70 library/inspect.rst:209 msgid "__name__" msgstr "" -#: ../src/Doc/library/inspect.rst:54 +#: library/inspect.rst:54 msgid "name with which this method was defined" msgstr "" # 71bf7bb3054646a08943dc7e10061fdc -#: ../src/Doc/library/inspect.rst:57 +#: library/inspect.rst:57 msgid "im_class" msgstr "" # d076eaef82a44529bd3f7dc8b63e1618 -#: ../src/Doc/library/inspect.rst:57 +#: library/inspect.rst:57 msgid "class object that asked for this method" msgstr "" # e4a627fc32c54422b07fba271943d3be -#: ../src/Doc/library/inspect.rst:60 +#: library/inspect.rst:60 msgid "im_func or __func__" msgstr "" -#: ../src/Doc/library/inspect.rst:60 +#: library/inspect.rst:60 msgid "function object containing implementation of method" msgstr "" # addd7f314ad9478ca85bb130820a79fb -#: ../src/Doc/library/inspect.rst:64 +#: library/inspect.rst:64 msgid "im_self or __self__" msgstr "" -#: ../src/Doc/library/inspect.rst:64 +#: library/inspect.rst:64 msgid "instance to which this method is bound, or ``None``" msgstr "" -#: ../src/Doc/library/inspect.rst:68 +#: library/inspect.rst:68 msgid "function" msgstr "fonction" -#: ../src/Doc/library/inspect.rst:70 +#: library/inspect.rst:70 msgid "name with which this function was defined" msgstr "" # 236028285d9440c6ac0230150a9d4680 -#: ../src/Doc/library/inspect.rst:73 +#: library/inspect.rst:73 msgid "func_code" msgstr "" -#: ../src/Doc/library/inspect.rst:73 +#: library/inspect.rst:73 msgid "code object containing compiled function :term:`bytecode`" msgstr "" # 01b134e86a8b4ad1ba9d969227de5f51 -#: ../src/Doc/library/inspect.rst:77 +#: library/inspect.rst:77 msgid "func_defaults" msgstr "" -#: ../src/Doc/library/inspect.rst:77 +#: library/inspect.rst:77 msgid "tuple of any default values for arguments" msgstr "" # 55ebb7efc2c74117926b0770b68c136b -#: ../src/Doc/library/inspect.rst:80 +#: library/inspect.rst:80 msgid "func_doc" msgstr "" # 0bec466520df426da8cac2964232209b -#: ../src/Doc/library/inspect.rst:80 +#: library/inspect.rst:80 msgid "(same as __doc__)" msgstr "" # f2043bb6d01c4f9588dfb574a7ebf663 -#: ../src/Doc/library/inspect.rst:82 +#: library/inspect.rst:82 msgid "func_globals" msgstr "" -#: ../src/Doc/library/inspect.rst:82 +#: library/inspect.rst:82 msgid "global namespace in which this function was defined" msgstr "" # e7bcc90700d24c6b989d2c22099efd7c -#: ../src/Doc/library/inspect.rst:85 +#: library/inspect.rst:85 msgid "func_name" msgstr "" # fd88f096f1f3405c82f152c3ab8e9f70 -#: ../src/Doc/library/inspect.rst:85 +#: library/inspect.rst:85 msgid "(same as __name__)" msgstr "" # 554be1de8032417d8a9733eaaae2c2c2 -#: ../src/Doc/library/inspect.rst:87 +#: library/inspect.rst:87 msgid "generator" msgstr "générateur" # 7e0ddc3c4fc041ef87e74fb534aeacb4 -#: ../src/Doc/library/inspect.rst:87 +#: library/inspect.rst:87 msgid "__iter__" msgstr "" # a30b40de1e99431c9f6106a0edfc31f3 -#: ../src/Doc/library/inspect.rst:87 +#: library/inspect.rst:87 msgid "defined to support iteration over container" msgstr "" # f54054c875c24d5486cd36aefe5f6509 -#: ../src/Doc/library/inspect.rst:90 +#: library/inspect.rst:90 msgid "close" msgstr "" # 402a23e0bd894472aa1896176f725b09 -#: ../src/Doc/library/inspect.rst:90 +#: library/inspect.rst:90 msgid "" "raises new GeneratorExit exception inside the generator to terminate the " "iteration" msgstr "" # 3568f79f90e74cbc8ac4a9d6441a08b8 -#: ../src/Doc/library/inspect.rst:95 +#: library/inspect.rst:95 msgid "gi_code" msgstr "" # e6b1f58cd9c74b4fbc447f39bcba6da4 -#: ../src/Doc/library/inspect.rst:95 +#: library/inspect.rst:95 msgid "code object" msgstr "" # e3c29b0d26f84c01b03f8b1a0cfa1598 -#: ../src/Doc/library/inspect.rst:97 +#: library/inspect.rst:97 msgid "gi_frame" msgstr "" # 4405d9878de34a98ba5ec11f02f29754 -#: ../src/Doc/library/inspect.rst:97 +#: library/inspect.rst:97 msgid "frame object or possibly None once the generator has been exhausted" msgstr "" # bc8cc8de89ec4a318e2bac656762b67f -#: ../src/Doc/library/inspect.rst:101 +#: library/inspect.rst:101 msgid "gi_running" msgstr "" # 4d31e618f10c4fa1b922128b7aa00067 -#: ../src/Doc/library/inspect.rst:101 +#: library/inspect.rst:101 msgid "set to 1 when generator is executing, 0 otherwise" msgstr "" # b9624a60d1bd4a03b93006df5e2fd234 -#: ../src/Doc/library/inspect.rst:104 +#: library/inspect.rst:104 msgid "next" msgstr "" # 925d2a6f0e8b4d71a04a4a390569c3cd -#: ../src/Doc/library/inspect.rst:104 +#: library/inspect.rst:104 msgid "return the next item from the container" msgstr "" # e05228a18bed4dc793b02ee0b0ecc1ce -#: ../src/Doc/library/inspect.rst:107 +#: library/inspect.rst:107 msgid "send" msgstr "" # b5dcfb811ad745b380504842d65b9d60 -#: ../src/Doc/library/inspect.rst:107 +#: library/inspect.rst:107 msgid "" "resumes the generator and \"sends\" a value that becomes the result of the " "current yield-expression" msgstr "" # 7218ba1c3aeb4125b05ee293447d02af -#: ../src/Doc/library/inspect.rst:112 +#: library/inspect.rst:112 msgid "throw" msgstr "" # 59fbc9399390406fbf762ac0a05b2a0e -#: ../src/Doc/library/inspect.rst:112 +#: library/inspect.rst:112 msgid "used to raise an exception inside the generator" msgstr "" -#: ../src/Doc/library/inspect.rst:116 +#: library/inspect.rst:116 msgid "traceback" msgstr "" -#: ../src/Doc/library/inspect.rst:116 +#: library/inspect.rst:116 msgid "tb_frame" msgstr "" -#: ../src/Doc/library/inspect.rst:116 +#: library/inspect.rst:116 msgid "frame object at this level" msgstr "" -#: ../src/Doc/library/inspect.rst:119 +#: library/inspect.rst:119 msgid "tb_lasti" msgstr "" -#: ../src/Doc/library/inspect.rst:119 ../src/Doc/library/inspect.rst:152 +#: library/inspect.rst:119 library/inspect.rst:152 msgid "index of last attempted instruction in bytecode" msgstr "" -#: ../src/Doc/library/inspect.rst:122 +#: library/inspect.rst:122 msgid "tb_lineno" msgstr "" -#: ../src/Doc/library/inspect.rst:122 ../src/Doc/library/inspect.rst:155 +#: library/inspect.rst:122 library/inspect.rst:155 msgid "current line number in Python source code" msgstr "" -#: ../src/Doc/library/inspect.rst:125 +#: library/inspect.rst:125 msgid "tb_next" msgstr "" -#: ../src/Doc/library/inspect.rst:125 +#: library/inspect.rst:125 msgid "next inner traceback object (called by this level)" msgstr "" -#: ../src/Doc/library/inspect.rst:129 +#: library/inspect.rst:129 msgid "frame" msgstr "" -#: ../src/Doc/library/inspect.rst:129 +#: library/inspect.rst:129 msgid "f_back" msgstr "" -#: ../src/Doc/library/inspect.rst:129 +#: library/inspect.rst:129 msgid "next outer frame object (this frame's caller)" msgstr "" -#: ../src/Doc/library/inspect.rst:132 +#: library/inspect.rst:132 msgid "f_builtins" msgstr "" -#: ../src/Doc/library/inspect.rst:132 +#: library/inspect.rst:132 msgid "builtins namespace seen by this frame" msgstr "" -#: ../src/Doc/library/inspect.rst:135 +#: library/inspect.rst:135 msgid "f_code" msgstr "" -#: ../src/Doc/library/inspect.rst:135 +#: library/inspect.rst:135 msgid "code object being executed in this frame" msgstr "" # 9e09483432ff4409a270d9bd87f1debb -#: ../src/Doc/library/inspect.rst:138 +#: library/inspect.rst:138 msgid "f_exc_traceback" msgstr "" # 29d17bc93254429fa645c214f5ea1b4d -#: ../src/Doc/library/inspect.rst:138 +#: library/inspect.rst:138 msgid "traceback if raised in this frame, or ``None``" msgstr "" # aecde8d9b6d0461a945d10477546460b -#: ../src/Doc/library/inspect.rst:141 +#: library/inspect.rst:141 msgid "f_exc_type" msgstr "" # 9f8c21e8e13b48dbacb8d67fd0b357ca -#: ../src/Doc/library/inspect.rst:141 +#: library/inspect.rst:141 msgid "exception type if raised in this frame, or ``None``" msgstr "" # 2f0cea1e16344f5e9064df68474361f4 -#: ../src/Doc/library/inspect.rst:145 +#: library/inspect.rst:145 msgid "f_exc_value" msgstr "" # c62244a8b23b45038ac9a7caf1c323f3 -#: ../src/Doc/library/inspect.rst:145 +#: library/inspect.rst:145 msgid "exception value if raised in this frame, or ``None``" msgstr "" -#: ../src/Doc/library/inspect.rst:149 +#: library/inspect.rst:149 msgid "f_globals" msgstr "" -#: ../src/Doc/library/inspect.rst:149 +#: library/inspect.rst:149 msgid "global namespace seen by this frame" msgstr "" -#: ../src/Doc/library/inspect.rst:152 +#: library/inspect.rst:152 msgid "f_lasti" msgstr "" -#: ../src/Doc/library/inspect.rst:155 +#: library/inspect.rst:155 msgid "f_lineno" msgstr "" -#: ../src/Doc/library/inspect.rst:158 +#: library/inspect.rst:158 msgid "f_locals" msgstr "" -#: ../src/Doc/library/inspect.rst:158 +#: library/inspect.rst:158 msgid "local namespace seen by this frame" msgstr "" -#: ../src/Doc/library/inspect.rst:161 +#: library/inspect.rst:161 msgid "f_restricted" msgstr "" -#: ../src/Doc/library/inspect.rst:161 +#: library/inspect.rst:161 msgid "0 or 1 if frame is in restricted execution mode" msgstr "" -#: ../src/Doc/library/inspect.rst:164 +#: library/inspect.rst:164 msgid "f_trace" msgstr "" -#: ../src/Doc/library/inspect.rst:164 +#: library/inspect.rst:164 msgid "tracing function for this frame, or ``None``" msgstr "" -#: ../src/Doc/library/inspect.rst:167 +#: library/inspect.rst:167 msgid "code" msgstr "" -#: ../src/Doc/library/inspect.rst:167 +#: library/inspect.rst:167 msgid "co_argcount" msgstr "" -#: ../src/Doc/library/inspect.rst:167 +#: library/inspect.rst:167 msgid "number of arguments (not including \\* or \\*\\* args)" msgstr "" -#: ../src/Doc/library/inspect.rst:171 +#: library/inspect.rst:171 msgid "co_code" msgstr "" -#: ../src/Doc/library/inspect.rst:171 +#: library/inspect.rst:171 msgid "string of raw compiled bytecode" msgstr "" -#: ../src/Doc/library/inspect.rst:174 +#: library/inspect.rst:174 msgid "co_consts" msgstr "" -#: ../src/Doc/library/inspect.rst:174 +#: library/inspect.rst:174 msgid "tuple of constants used in the bytecode" msgstr "" -#: ../src/Doc/library/inspect.rst:177 +#: library/inspect.rst:177 msgid "co_filename" msgstr "" -#: ../src/Doc/library/inspect.rst:177 +#: library/inspect.rst:177 msgid "name of file in which this code object was created" msgstr "" -#: ../src/Doc/library/inspect.rst:181 +#: library/inspect.rst:181 msgid "co_firstlineno" msgstr "" -#: ../src/Doc/library/inspect.rst:181 +#: library/inspect.rst:181 msgid "number of first line in Python source code" msgstr "" -#: ../src/Doc/library/inspect.rst:184 +#: library/inspect.rst:184 msgid "co_flags" msgstr "" -#: ../src/Doc/library/inspect.rst:184 +#: library/inspect.rst:184 msgid "bitmap: 1=optimized ``|`` 2=newlocals ``|`` 4=\\*arg ``|`` 8=\\*\\*arg" msgstr "" -#: ../src/Doc/library/inspect.rst:188 +#: library/inspect.rst:188 msgid "co_lnotab" msgstr "" -#: ../src/Doc/library/inspect.rst:188 +#: library/inspect.rst:188 msgid "encoded mapping of line numbers to bytecode indices" msgstr "" -#: ../src/Doc/library/inspect.rst:192 +#: library/inspect.rst:192 msgid "co_name" msgstr "" -#: ../src/Doc/library/inspect.rst:192 +#: library/inspect.rst:192 msgid "name with which this code object was defined" msgstr "" -#: ../src/Doc/library/inspect.rst:195 +#: library/inspect.rst:195 msgid "co_names" msgstr "" -#: ../src/Doc/library/inspect.rst:195 +#: library/inspect.rst:195 msgid "tuple of names of local variables" msgstr "" -#: ../src/Doc/library/inspect.rst:198 +#: library/inspect.rst:198 msgid "co_nlocals" msgstr "" -#: ../src/Doc/library/inspect.rst:198 +#: library/inspect.rst:198 msgid "number of local variables" msgstr "" -#: ../src/Doc/library/inspect.rst:200 +#: library/inspect.rst:200 msgid "co_stacksize" msgstr "" -#: ../src/Doc/library/inspect.rst:200 +#: library/inspect.rst:200 msgid "virtual machine stack space required" msgstr "" -#: ../src/Doc/library/inspect.rst:203 +#: library/inspect.rst:203 msgid "co_varnames" msgstr "" -#: ../src/Doc/library/inspect.rst:203 +#: library/inspect.rst:203 msgid "tuple of names of arguments and local variables" msgstr "" -#: ../src/Doc/library/inspect.rst:207 +#: library/inspect.rst:207 msgid "builtin" msgstr "" -#: ../src/Doc/library/inspect.rst:209 +#: library/inspect.rst:209 msgid "original name of this function or method" msgstr "" -#: ../src/Doc/library/inspect.rst:212 +#: library/inspect.rst:212 msgid "__self__" msgstr "" -#: ../src/Doc/library/inspect.rst:212 +#: library/inspect.rst:212 msgid "instance to which a method is bound, or ``None``" msgstr "" # 7144d0e3ea074af6b46fc60177a42cfa # 32ec2be543d34f00b5a3f6a5f578635a -#: ../src/Doc/library/inspect.rst:217 ../src/Doc/library/posixfile.rst:134 +#: library/inspect.rst:217 library/posixfile.rst:134 msgid "Note:" msgstr "" -#: ../src/Doc/library/inspect.rst:226 +#: library/inspect.rst:220 +msgid ":attr:`im_class` used to refer to the class that defined the method." +msgstr "" + +#: library/inspect.rst:226 msgid "" "Return all the members of an object in a list of (name, value) pairs sorted " "by name. If the optional *predicate* argument is supplied, only members for " "which the predicate returns a true value are included." msgstr "" -#: ../src/Doc/library/inspect.rst:232 +#: library/inspect.rst:232 msgid "" ":func:`getmembers` does not return metaclass attributes when the argument is " "a class (this behavior is inherited from the :func:`dir` function)." msgstr "" # 4ce7ad41b2014e468ccd4f1e3bee6663 -#: ../src/Doc/library/inspect.rst:238 +#: library/inspect.rst:238 msgid "" "Return a tuple of values that describe how Python will interpret the file " "identified by *path* if it is a module, or ``None`` if it would not be " @@ -51457,7 +52614,13 @@ msgid "" "documentation for that module for more information on module types." msgstr "" -#: ../src/Doc/library/inspect.rst:256 +#: library/inspect.rst:249 +msgid "" +"Returns a :term:`named tuple` ``ModuleInfo(name, suffix, mode, " +"module_type)``." +msgstr "" + +#: library/inspect.rst:256 msgid "" "Return the name of the module named by the file *path*, without including " "the names of enclosing packages. This uses the same algorithm as the " @@ -51465,66 +52628,66 @@ msgid "" "according to the interpreter's rules, ``None`` is returned." msgstr "" -#: ../src/Doc/library/inspect.rst:264 +#: library/inspect.rst:264 msgid "Return true if the object is a module." msgstr "" # 7e161f05e9fa42c1baab79ce2c0d312c -#: ../src/Doc/library/inspect.rst:269 +#: library/inspect.rst:269 msgid "" "Return true if the object is a class, whether built-in or created in Python " "code." msgstr "" # 4378cd0f4c604db39d6249b0a92b3d83 -#: ../src/Doc/library/inspect.rst:275 +#: library/inspect.rst:275 msgid "Return true if the object is a bound method written in Python." msgstr "" # a711d5b9973f4d40afc2f316df4e0c4e -#: ../src/Doc/library/inspect.rst:280 +#: library/inspect.rst:280 msgid "" "Return true if the object is a Python function, which includes functions " "created by a :term:`lambda` expression." msgstr "" -#: ../src/Doc/library/inspect.rst:286 +#: library/inspect.rst:286 msgid "Return true if the object is a Python generator function." msgstr "" -#: ../src/Doc/library/inspect.rst:293 +#: library/inspect.rst:293 msgid "Return true if the object is a generator." msgstr "" -#: ../src/Doc/library/inspect.rst:300 +#: library/inspect.rst:300 msgid "Return true if the object is a traceback." msgstr "" -#: ../src/Doc/library/inspect.rst:305 +#: library/inspect.rst:305 msgid "Return true if the object is a frame." msgstr "" -#: ../src/Doc/library/inspect.rst:310 +#: library/inspect.rst:310 msgid "Return true if the object is a code." msgstr "" # 8fe3f20849db4dc5937c383418cd6386 -#: ../src/Doc/library/inspect.rst:315 +#: library/inspect.rst:315 msgid "" "Return true if the object is a built-in function or a bound built-in method." msgstr "" -#: ../src/Doc/library/inspect.rst:320 +#: library/inspect.rst:320 msgid "" "Return true if the object is a user-defined or built-in function or method." msgstr "" -#: ../src/Doc/library/inspect.rst:325 +#: library/inspect.rst:325 msgid "Return true if the object is an abstract base class." msgstr "" # 7c41bbd2852e41fdafeaadb94cbc25bc -#: ../src/Doc/library/inspect.rst:332 +#: library/inspect.rst:332 msgid "" "Return true if the object is a method descriptor, but not if :func:" "`ismethod`, :func:`isclass`, :func:`isfunction` or :func:`isbuiltin` are " @@ -51532,7 +52695,7 @@ msgid "" msgstr "" # f3f0c8e5bf3b46c5b8b53421c0b698aa -#: ../src/Doc/library/inspect.rst:336 +#: library/inspect.rst:336 msgid "" "This is new as of Python 2.2, and, for example, is true of ``int.__add__``. " "An object passing this test has a :attr:`__get__` attribute but not a :attr:" @@ -51541,7 +52704,7 @@ msgid "" msgstr "" # c94b4642206c42d6966c20a710d06faf -#: ../src/Doc/library/inspect.rst:341 +#: library/inspect.rst:341 msgid "" "Methods implemented via descriptors that also pass one of the other tests " "return false from the :func:`ismethoddescriptor` test, simply because the " @@ -51549,11 +52712,11 @@ msgid "" "`im_func` attribute (etc) when an object passes :func:`ismethod`." msgstr "" -#: ../src/Doc/library/inspect.rst:349 +#: library/inspect.rst:349 msgid "Return true if the object is a data descriptor." msgstr "" -#: ../src/Doc/library/inspect.rst:351 +#: library/inspect.rst:351 msgid "" "Data descriptors have both a :attr:`__get__` and a :attr:`__set__` " "attribute. Examples are properties (defined in Python), getsets, and " @@ -51564,65 +52727,65 @@ msgid "" "attributes), but this is not guaranteed." msgstr "" -#: ../src/Doc/library/inspect.rst:364 +#: library/inspect.rst:364 msgid "Return true if the object is a getset descriptor." msgstr "" # 3b5ebbf5801f4dd6aa3b141c5c8f1050 -#: ../src/Doc/library/inspect.rst:368 +#: library/inspect.rst:368 msgid "" "getsets are attributes defined in extension modules via :c:type:" "`PyGetSetDef` structures. For Python implementations without such types, " "this method will always return ``False``." msgstr "" -#: ../src/Doc/library/inspect.rst:377 +#: library/inspect.rst:377 msgid "Return true if the object is a member descriptor." msgstr "" # 4bdfdf5844dc4e14b2b635757e39cbe5 -#: ../src/Doc/library/inspect.rst:381 +#: library/inspect.rst:381 msgid "" "Member descriptors are attributes defined in extension modules via :c:type:" "`PyMemberDef` structures. For Python implementations without such types, " "this method will always return ``False``." msgstr "" -#: ../src/Doc/library/inspect.rst:391 +#: library/inspect.rst:391 msgid "Retrieving source code" msgstr "" -#: ../src/Doc/library/inspect.rst:395 +#: library/inspect.rst:395 msgid "" "Get the documentation string for an object, cleaned up with :func:`cleandoc`." msgstr "" -#: ../src/Doc/library/inspect.rst:400 +#: library/inspect.rst:400 msgid "" "Return in a single string any lines of comments immediately preceding the " "object's source code (for a class, function, or method), or at the top of " "the Python source file (if the object is a module)." msgstr "" -#: ../src/Doc/library/inspect.rst:407 +#: library/inspect.rst:407 msgid "" "Return the name of the (text or binary) file in which an object was defined. " "This will fail with a :exc:`TypeError` if the object is a built-in module, " "class, or function." msgstr "" -#: ../src/Doc/library/inspect.rst:414 +#: library/inspect.rst:414 msgid "Try to guess which module an object was defined in." msgstr "" -#: ../src/Doc/library/inspect.rst:419 +#: library/inspect.rst:419 msgid "" "Return the name of the Python source file in which an object was defined. " "This will fail with a :exc:`TypeError` if the object is a built-in module, " "class, or function." msgstr "" -#: ../src/Doc/library/inspect.rst:426 +#: library/inspect.rst:426 msgid "" "Return a list of source lines and starting line number for an object. The " "argument may be a module, class, method, function, traceback, frame, or code " @@ -51632,7 +52795,7 @@ msgid "" "code cannot be retrieved." msgstr "" -#: ../src/Doc/library/inspect.rst:436 +#: library/inspect.rst:436 msgid "" "Return the text of the source code for an object. The argument may be a " "module, class, method, function, traceback, frame, or code object. The " @@ -51640,18 +52803,18 @@ msgid "" "the source code cannot be retrieved." msgstr "" -#: ../src/Doc/library/inspect.rst:444 +#: library/inspect.rst:444 msgid "" "Clean up indentation from docstrings that are indented to line up with " "blocks of code. Any whitespace that can be uniformly removed from the " "second line onwards is removed. Also, all tabs are expanded to spaces." msgstr "" -#: ../src/Doc/library/inspect.rst:454 ../src/Doc/library/unittest.rst:677 +#: library/inspect.rst:454 library/unittest.rst:668 msgid "Classes and functions" msgstr "" -#: ../src/Doc/library/inspect.rst:459 +#: library/inspect.rst:459 msgid "" "Arrange the given list of classes into a hierarchy of nested lists. Where a " "nested list appears, it contains classes derived from the class whose entry " @@ -51663,7 +52826,7 @@ msgid "" msgstr "" # c3fc4f72371043ea9bc8a9bab18bf4ec -#: ../src/Doc/library/inspect.rst:470 +#: library/inspect.rst:470 msgid "" "Get the names and default values of a Python function's arguments. A tuple " "of four things is returned: ``(args, varargs, keywords, defaults)``. *args* " @@ -51674,8 +52837,13 @@ msgid "" "last *n* elements listed in *args*." msgstr "" +#: library/inspect.rst:478 +msgid "" +"Returns a :term:`named tuple` ``ArgSpec(args, varargs, keywords, defaults)``." +msgstr "" + # 9c98c1859a094ef7b065ea80182c67fd -#: ../src/Doc/library/inspect.rst:485 +#: library/inspect.rst:485 msgid "" "Get information about arguments passed into a particular frame. A tuple of " "four things is returned: ``(args, varargs, keywords, locals)``. *args* is a " @@ -51684,21 +52852,26 @@ msgid "" "*locals* is the locals dictionary of the given frame." msgstr "" -#: ../src/Doc/library/inspect.rst:498 +#: library/inspect.rst:491 +msgid "" +"Returns a :term:`named tuple` ``ArgInfo(args, varargs, keywords, locals)``." +msgstr "" + +#: library/inspect.rst:498 msgid "" "Format a pretty argument spec from the four values returned by :func:" "`getargspec`. The format\\* arguments are the corresponding optional " "formatting functions that are called to turn names and values into strings." msgstr "" -#: ../src/Doc/library/inspect.rst:505 +#: library/inspect.rst:505 msgid "" "Format a pretty argument spec from the four values returned by :func:" "`getargvalues`. The format\\* arguments are the corresponding optional " "formatting functions that are called to turn names and values into strings." msgstr "" -#: ../src/Doc/library/inspect.rst:512 +#: library/inspect.rst:512 msgid "" "Return a tuple of class cls's base classes, including cls, in method " "resolution order. No class appears more than once in this tuple. Note that " @@ -51706,7 +52879,7 @@ msgid "" "user-defined metatype is in use, cls will be the first element of the tuple." msgstr "" -#: ../src/Doc/library/inspect.rst:520 +#: library/inspect.rst:520 msgid "" "Bind the *args* and *kwds* to the argument names of the Python function or " "method *func*, as if it was called with them. For bound methods, bind also " @@ -51719,11 +52892,11 @@ msgid "" "example::" msgstr "" -#: ../src/Doc/library/inspect.rst:547 +#: library/inspect.rst:547 msgid "The interpreter stack" msgstr "" -#: ../src/Doc/library/inspect.rst:549 +#: library/inspect.rst:549 msgid "" "When the following functions return \"frame records,\" each record is a " "tuple of six items: the frame object, the filename, the line number of the " @@ -51731,7 +52904,7 @@ msgid "" "code, and the index of the current line within that list." msgstr "" -#: ../src/Doc/library/inspect.rst:556 +#: library/inspect.rst:556 msgid "" "Keeping references to frame objects, as found in the first element of the " "frame records these functions return, can cause your program to create " @@ -51743,7 +52916,7 @@ msgid "" "consumption which occurs." msgstr "" -#: ../src/Doc/library/inspect.rst:564 +#: library/inspect.rst:564 msgid "" "Though the cycle detector will catch these, destruction of the frames (and " "local variables) can be made deterministic by removing the cycle in a :" @@ -51751,7 +52924,7 @@ msgid "" "disabled when Python was compiled or using :func:`gc.disable`. For example::" msgstr "" -#: ../src/Doc/library/inspect.rst:576 +#: library/inspect.rst:576 msgid "" "The optional *context* argument supported by most of these functions " "specifies the number of lines of context to return, which are centered " @@ -51759,13 +52932,19 @@ msgid "" msgstr "" # d9f6570b244d4ad58c8841ea33c85afc -#: ../src/Doc/library/inspect.rst:583 +#: library/inspect.rst:583 msgid "" "Get information about a frame or traceback object. A 5-tuple is returned, " "the last five elements of the frame's frame record." msgstr "" -#: ../src/Doc/library/inspect.rst:593 +#: library/inspect.rst:586 +msgid "" +"Returns a :term:`named tuple` ``Traceback(filename, lineno, function, " +"code_context, index)``." +msgstr "" + +#: library/inspect.rst:593 msgid "" "Get a list of frame records for a frame and all outer frames. These frames " "represent the calls that lead to the creation of *frame*. The first entry in " @@ -51773,7 +52952,7 @@ msgid "" "outermost call on *frame*'s stack." msgstr "" -#: ../src/Doc/library/inspect.rst:601 +#: library/inspect.rst:601 msgid "" "Get a list of frame records for a traceback's frame and all inner frames. " "These frames represent calls made as a consequence of *frame*. The first " @@ -51781,11 +52960,11 @@ msgid "" "the exception was raised." msgstr "" -#: ../src/Doc/library/inspect.rst:609 +#: library/inspect.rst:609 msgid "Return the frame object for the caller's stack frame." msgstr "" -#: ../src/Doc/library/inspect.rst:613 +#: library/inspect.rst:613 msgid "" "This function relies on Python stack frame support in the interpreter, which " "isn't guaranteed to exist in all implementations of Python. If running in " @@ -51793,14 +52972,14 @@ msgid "" "``None``." msgstr "" -#: ../src/Doc/library/inspect.rst:621 +#: library/inspect.rst:621 msgid "" "Return a list of frame records for the caller's stack. The first entry in " "the returned list represents the caller; the last entry represents the " "outermost call on the stack." msgstr "" -#: ../src/Doc/library/inspect.rst:628 +#: library/inspect.rst:628 msgid "" "Return a list of frame records for the stack between the current frame and " "the frame in which an exception currently being handled was raised in. The " @@ -51808,11 +52987,11 @@ msgid "" "where the exception was raised." msgstr "" -#: ../src/Doc/library/internet.rst:6 +#: library/internet.rst:6 msgid "Internet Protocols and Support" msgstr "" -#: ../src/Doc/library/internet.rst:15 +#: library/internet.rst:15 msgid "" "The modules described in this chapter implement Internet protocols and " "support for related technology. They are all implemented in Python. Most of " @@ -51821,11 +53000,11 @@ msgid "" "an overview:" msgstr "" -#: ../src/Doc/library/intro.rst:8 +#: library/intro.rst:8 msgid "The \"Python library\" contains several different kinds of components." msgstr "" -#: ../src/Doc/library/intro.rst:10 +#: library/intro.rst:10 msgid "" "It contains data types that would normally be considered part of the \"core" "\" of a language, such as numbers and lists. For these types, the Python " @@ -51835,7 +53014,7 @@ msgid "" "and priorities of operators.)" msgstr "" -#: ../src/Doc/library/intro.rst:16 +#: library/intro.rst:16 msgid "" "The library also contains built-in functions and exceptions --- objects that " "can be used by all Python code without the need of an :keyword:`import` " @@ -51843,7 +53022,7 @@ msgid "" "essential for the core semantics and are only described here." msgstr "" -#: ../src/Doc/library/intro.rst:21 +#: library/intro.rst:21 msgid "" "The bulk of the library, however, consists of a collection of modules. There " "are many ways to dissect this collection. Some modules are written in C and " @@ -51859,7 +53038,7 @@ msgid "" "when Python was compiled and installed." msgstr "" -#: ../src/Doc/library/intro.rst:33 +#: library/intro.rst:33 msgid "" "This manual is organized \"from the inside out:\" it first describes the " "built-in data types, then the built-in functions and exceptions, and finally " @@ -51868,7 +53047,7 @@ msgid "" "roughly from most relevant to least important." msgstr "" -#: ../src/Doc/library/intro.rst:39 +#: library/intro.rst:39 msgid "" "This means that if you start reading this manual from the start, and skip to " "the next chapter when you get bored, you will get a reasonable overview of " @@ -51883,16 +53062,16 @@ msgid "" "familiarity with this material." msgstr "" -#: ../src/Doc/library/intro.rst:51 +#: library/intro.rst:51 msgid "Let the show begin!" msgstr "" -#: ../src/Doc/library/io.rst:2 +#: library/io.rst:2 msgid ":mod:`io` --- Core tools for working with streams" msgstr "" # 0eecc1e6a01045fe995bdda9d8dcaf12 -#: ../src/Doc/library/io.rst:16 +#: library/io.rst:16 msgid "" "The :mod:`io` module provides the Python interfaces to stream handling. " "Under Python 2.x, this is proposed as an alternative to the built-in :class:" @@ -51901,7 +53080,7 @@ msgid "" msgstr "" # 0c4d2646d35843728f06bf77ac8c3877 -#: ../src/Doc/library/io.rst:23 +#: library/io.rst:23 msgid "" "Since this module has been designed primarily for Python 3.x, you have to be " "aware that all uses of \"bytes\" in this document refer to the :class:`str` " @@ -51911,7 +53090,7 @@ msgid "" msgstr "" # 2512bc471d5845bc82bd70ba41ec1f92 -#: ../src/Doc/library/io.rst:29 +#: library/io.rst:29 msgid "" "At the top of the I/O hierarchy is the abstract base class :class:`IOBase`. " "It defines the basic interface to a stream. Note, however, that there is no " @@ -51919,7 +53098,7 @@ msgid "" "allowed to raise an :exc:`IOError` if they do not support a given operation." msgstr "" -#: ../src/Doc/library/io.rst:34 +#: library/io.rst:34 msgid "" "Extending :class:`IOBase` is :class:`RawIOBase` which deals simply with the " "reading and writing of raw bytes to a stream. :class:`FileIO` subclasses :" @@ -51927,7 +53106,7 @@ msgid "" "system." msgstr "" -#: ../src/Doc/library/io.rst:39 +#: library/io.rst:39 msgid "" ":class:`BufferedIOBase` deals with buffering on a raw byte stream (:class:" "`RawIOBase`). Its subclasses, :class:`BufferedWriter`, :class:" @@ -51938,7 +53117,7 @@ msgid "" msgstr "" # 3fb414305cad41c089436cfac78e5bff -#: ../src/Doc/library/io.rst:46 +#: library/io.rst:46 msgid "" "Another :class:`IOBase` subclass, :class:`TextIOBase`, deals with streams " "whose bytes represent text, and handles encoding and decoding from and to :" @@ -51947,31 +53126,31 @@ msgid "" "Finally, :class:`StringIO` is an in-memory stream for unicode text." msgstr "" -#: ../src/Doc/library/io.rst:53 +#: library/io.rst:53 msgid "" "Argument names are not part of the specification, and only the arguments of :" "func:`.open` are intended to be used as keyword arguments." msgstr "" -#: ../src/Doc/library/io.rst:58 +#: library/io.rst:58 msgid "Module Interface" msgstr "" -#: ../src/Doc/library/io.rst:62 +#: library/io.rst:62 msgid "" "An int containing the default buffer size used by the module's buffered I/O " "classes. :func:`.open` uses the file's blksize (as obtained by :func:`os." "stat`) if possible." msgstr "" -#: ../src/Doc/library/io.rst:68 +#: library/io.rst:68 msgid "" "Open *file* and return a corresponding stream. If the file cannot be " "opened, an :exc:`IOError` is raised." msgstr "" # a0949c48c2ef4cbcbea67f3162ec229e -#: ../src/Doc/library/io.rst:71 +#: library/io.rst:71 msgid "" "*file* is either a string giving the pathname (absolute or relative to the " "current working directory) of the file to be opened or an integer file " @@ -51980,7 +53159,7 @@ msgid "" "``False``.)" msgstr "" -#: ../src/Doc/library/io.rst:77 +#: library/io.rst:77 msgid "" "*mode* is an optional string that specifies the mode in which the file is " "opened. It defaults to ``'r'`` which means open for reading in text mode. " @@ -51992,59 +53171,58 @@ msgid "" "binary mode and leave *encoding* unspecified.) The available modes are:" msgstr "" -#: ../src/Doc/library/io.rst:87 ../src/Doc/library/struct.rst:104 +#: library/io.rst:87 library/struct.rst:104 msgid "Character" msgstr "" -#: ../src/Doc/library/io.rst:89 +#: library/io.rst:89 msgid "open for reading (default)" msgstr "" -#: ../src/Doc/library/io.rst:90 +#: library/io.rst:90 msgid "open for writing, truncating the file first" msgstr "" -#: ../src/Doc/library/io.rst:91 +#: library/io.rst:91 msgid "``'a'``" msgstr "" -#: ../src/Doc/library/io.rst:91 +#: library/io.rst:91 msgid "open for writing, appending to the end of the file if it exists" msgstr "" -#: ../src/Doc/library/io.rst:92 +#: library/io.rst:92 msgid "binary mode" msgstr "" -#: ../src/Doc/library/io.rst:93 +#: library/io.rst:93 msgid "``'t'``" msgstr "" -#: ../src/Doc/library/io.rst:93 +#: library/io.rst:93 msgid "text mode (default)" msgstr "" -#: ../src/Doc/library/io.rst:94 ../src/Doc/library/re.rst:101 -#: ../src/Doc/library/stdtypes.rst:1432 ../src/Doc/library/string.rst:369 +#: library/io.rst:94 library/stdtypes.rst:1435 library/string.rst:369 msgid "``'+'``" msgstr "" -#: ../src/Doc/library/io.rst:94 +#: library/io.rst:94 msgid "open a disk file for updating (reading and writing)" msgstr "" -#: ../src/Doc/library/io.rst:95 +#: library/io.rst:95 msgid "``'U'``" msgstr "" # 6620495f8b6846fc8d181fe59454756f -#: ../src/Doc/library/io.rst:95 +#: library/io.rst:95 msgid "" "universal newlines mode (for backwards compatibility; should not be used in " "new code)" msgstr "" -#: ../src/Doc/library/io.rst:99 +#: library/io.rst:99 msgid "" "The default mode is ``'rt'`` (open for reading text). For binary random " "access, the mode ``'w+b'`` opens and truncates the file to 0 bytes, while " @@ -52052,7 +53230,7 @@ msgid "" msgstr "" # 3077163cc2fa431099d5614035398aee -#: ../src/Doc/library/io.rst:103 +#: library/io.rst:103 msgid "" "Python distinguishes between files opened in binary and text modes, even " "when the underlying operating system doesn't. Files opened in binary mode " @@ -52063,7 +53241,7 @@ msgid "" "platform-dependent encoding or using the specified *encoding* if given." msgstr "" -#: ../src/Doc/library/io.rst:111 +#: library/io.rst:111 msgid "" "*buffering* is an optional integer used to set the buffering policy. Pass 0 " "to switch buffering off (only allowed in binary mode), 1 to select line " @@ -52072,7 +53250,7 @@ msgid "" "the default buffering policy works as follows:" msgstr "" -#: ../src/Doc/library/io.rst:117 +#: library/io.rst:117 msgid "" "Binary files are buffered in fixed-size chunks; the size of the buffer is " "chosen using a heuristic trying to determine the underlying device's \"block " @@ -52080,14 +53258,14 @@ msgid "" "buffer will typically be 4096 or 8192 bytes long." msgstr "" -#: ../src/Doc/library/io.rst:122 +#: library/io.rst:122 msgid "" "\"Interactive\" text files (files for which :meth:`isatty` returns True) use " "line buffering. Other text files use the policy described above for binary " "files." msgstr "" -#: ../src/Doc/library/io.rst:126 +#: library/io.rst:126 msgid "" "*encoding* is the name of the encoding used to decode or encode the file. " "This should only be used in text mode. The default encoding is platform " @@ -52096,7 +53274,7 @@ msgid "" "the list of supported encodings." msgstr "" -#: ../src/Doc/library/io.rst:132 +#: library/io.rst:132 msgid "" "*errors* is an optional string that specifies how encoding and decoding " "errors are to be handled--this cannot be used in binary mode. Pass " @@ -52112,7 +53290,7 @@ msgid "" msgstr "" # 9d7143fc317546258a735d5b28b6fe1d -#: ../src/Doc/library/io.rst:147 +#: library/io.rst:147 msgid "" "*newline* controls how :term:`universal newlines` works (it only applies to " "text mode). It can be ``None``, ``''``, ``'\\n'``, ``'\\r'``, and ``'\\r" @@ -52120,7 +53298,7 @@ msgid "" msgstr "" # a985c0684ebe44e29a66d56865842d34 -#: ../src/Doc/library/io.rst:151 +#: library/io.rst:151 msgid "" "On input, if *newline* is ``None``, universal newlines mode is enabled. " "Lines in the input can end in ``'\\n'``, ``'\\r'``, or ``'\\r\\n'``, and " @@ -52131,7 +53309,7 @@ msgid "" "ending is returned to the caller untranslated." msgstr "" -#: ../src/Doc/library/io.rst:159 ../src/Doc/library/io.rst:784 +#: library/io.rst:159 library/io.rst:785 msgid "" "On output, if *newline* is ``None``, any ``'\\n'`` characters written are " "translated to the system default line separator, :data:`os.linesep`. If " @@ -52140,7 +53318,7 @@ msgid "" "given string." msgstr "" -#: ../src/Doc/library/io.rst:165 +#: library/io.rst:165 msgid "" "If *closefd* is ``False`` and a file descriptor rather than a filename was " "given, the underlying file descriptor will be kept open when the file is " @@ -52148,7 +53326,7 @@ msgid "" "(the default)." msgstr "" -#: ../src/Doc/library/io.rst:170 +#: library/io.rst:170 msgid "" "The type of file object returned by the :func:`.open` function depends on " "the mode. When :func:`.open` is used to open a file in a text mode " @@ -52163,7 +53341,7 @@ msgid "" msgstr "" # 1166482b3a674ac7b1288ecc04ef3dfd -#: ../src/Doc/library/io.rst:181 +#: library/io.rst:181 msgid "" "It is also possible to use an :class:`unicode` or :class:`bytes` string as a " "file for both reading and writing. For :class:`unicode` strings :class:" @@ -52171,48 +53349,48 @@ msgid "" "`bytes` a :class:`BytesIO` can be used like a file opened in a binary mode." msgstr "" -#: ../src/Doc/library/io.rst:190 +#: library/io.rst:190 msgid "" "Error raised when blocking would occur on a non-blocking stream. It " "inherits :exc:`IOError`." msgstr "" -#: ../src/Doc/library/io.rst:193 +#: library/io.rst:193 msgid "" "In addition to those of :exc:`IOError`, :exc:`BlockingIOError` has one " "attribute:" msgstr "" -#: ../src/Doc/library/io.rst:198 +#: library/io.rst:198 msgid "" "An integer containing the number of characters written to the stream before " "it blocked." msgstr "" -#: ../src/Doc/library/io.rst:204 +#: library/io.rst:204 msgid "" "An exception inheriting :exc:`IOError` and :exc:`ValueError` that is raised " "when an unsupported operation is called on a stream." msgstr "" -#: ../src/Doc/library/io.rst:209 +#: library/io.rst:209 msgid "I/O Base Classes" msgstr "" -#: ../src/Doc/library/io.rst:213 +#: library/io.rst:213 msgid "" "The abstract base class for all I/O classes, acting on streams of bytes. " "There is no public constructor." msgstr "" -#: ../src/Doc/library/io.rst:216 +#: library/io.rst:216 msgid "" "This class provides empty abstract implementations for many methods that " "derived classes can override selectively; the default implementations " "represent a file that cannot be read, written or seeked." msgstr "" -#: ../src/Doc/library/io.rst:221 +#: library/io.rst:221 msgid "" "Even though :class:`IOBase` does not declare :meth:`read`, :meth:`readinto`, " "or :meth:`write` because their signatures will vary, implementations and " @@ -52222,7 +53400,7 @@ msgid "" msgstr "" # dbfca53890c94638be4572dd0d97bd92 -#: ../src/Doc/library/io.rst:227 +#: library/io.rst:227 msgid "" "The basic type used for binary data read from or written to a file is :class:" "`bytes` (also known as :class:`str`). :class:`bytearray`\\s are accepted " @@ -52230,14 +53408,14 @@ msgid "" "classes work with :class:`unicode` data." msgstr "" -#: ../src/Doc/library/io.rst:232 +#: library/io.rst:232 msgid "" "Note that calling any method (even inquiries) on a closed stream is " "undefined. Implementations may raise :exc:`IOError` in this case." msgstr "" # 4355ca6a7d1847ffae097180ead758ac -#: ../src/Doc/library/io.rst:235 +#: library/io.rst:235 msgid "" "IOBase (and its subclasses) support the iterator protocol, meaning that an :" "class:`IOBase` object can be iterated over yielding the lines in a stream. " @@ -52246,75 +53424,75 @@ msgid "" "`unicode` strings). See :meth:`~IOBase.readline` below." msgstr "" -#: ../src/Doc/library/io.rst:241 +#: library/io.rst:241 msgid "" "IOBase is also a context manager and therefore supports the :keyword:`with` " "statement. In this example, *file* is closed after the :keyword:`with` " "statement's suite is finished---even if an exception occurs::" msgstr "" -#: ../src/Doc/library/io.rst:248 +#: library/io.rst:248 msgid ":class:`IOBase` provides these data attributes and methods:" msgstr "" -#: ../src/Doc/library/io.rst:252 +#: library/io.rst:252 msgid "" "Flush and close this stream. This method has no effect if the file is " "already closed. Once the file is closed, any operation on the file (e.g. " "reading or writing) will raise a :exc:`ValueError`." msgstr "" -#: ../src/Doc/library/io.rst:256 +#: library/io.rst:256 msgid "" "As a convenience, it is allowed to call this method more than once; only the " "first call, however, will have an effect." msgstr "" -#: ../src/Doc/library/io.rst:261 +#: library/io.rst:261 msgid "True if the stream is closed." msgstr "" -#: ../src/Doc/library/io.rst:265 +#: library/io.rst:265 msgid "" "Return the underlying file descriptor (an integer) of the stream if it " "exists. An :exc:`IOError` is raised if the IO object does not use a file " "descriptor." msgstr "" -#: ../src/Doc/library/io.rst:271 +#: library/io.rst:271 msgid "" "Flush the write buffers of the stream if applicable. This does nothing for " "read-only and non-blocking streams." msgstr "" -#: ../src/Doc/library/io.rst:276 +#: library/io.rst:276 msgid "" "Return ``True`` if the stream is interactive (i.e., connected to a terminal/" "tty device)." msgstr "" # 6c7092b63a4a46269424eaf7f9fec1b3 -#: ../src/Doc/library/io.rst:281 +#: library/io.rst:281 msgid "" "Return ``True`` if the stream can be read from. If ``False``, :meth:`read` " "will raise :exc:`IOError`." msgstr "" -#: ../src/Doc/library/io.rst:286 +#: library/io.rst:286 msgid "" "Read and return one line from the stream. If *limit* is specified, at most " "*limit* bytes will be read." msgstr "" # 072f07ad6e1749e4b0e20df52d8e5d9d -#: ../src/Doc/library/io.rst:289 +#: library/io.rst:289 msgid "" "The line terminator is always ``b'\\n'`` for binary files; for text files, " "the *newline* argument to :func:`.open` can be used to select the line " "terminator(s) recognized." msgstr "" -#: ../src/Doc/library/io.rst:295 +#: library/io.rst:295 msgid "" "Read and return a list of lines from the stream. *hint* can be specified to " "control the number of lines read: no more lines will be read if the total " @@ -52322,51 +53500,55 @@ msgid "" msgstr "" # b2ed48b57eed4257bf0270098b35b171 -#: ../src/Doc/library/io.rst:299 +#: library/io.rst:299 msgid "" "Note that it's already possible to iterate on file objects using ``for line " "in file: ...`` without calling ``file.readlines()``." msgstr "" -#: ../src/Doc/library/io.rst:304 +#: library/io.rst:304 msgid "" "Change the stream position to the given byte *offset*. *offset* is " -"interpreted relative to the position indicated by *whence*. Values for " -"*whence* are:" +"interpreted relative to the position indicated by *whence*. The default " +"value for *whence* is :data:`SEEK_SET`. Values for *whence* are:" msgstr "" -#: ../src/Doc/library/io.rst:308 +#: library/io.rst:308 msgid "" ":data:`SEEK_SET` or ``0`` -- start of the stream (the default); *offset* " "should be zero or positive" msgstr "" -#: ../src/Doc/library/io.rst:310 +#: library/io.rst:310 msgid "" ":data:`SEEK_CUR` or ``1`` -- current stream position; *offset* may be " "negative" msgstr "" -#: ../src/Doc/library/io.rst:312 +#: library/io.rst:312 msgid "" ":data:`SEEK_END` or ``2`` -- end of the stream; *offset* is usually negative" msgstr "" -#: ../src/Doc/library/io.rst:315 +#: library/io.rst:315 msgid "Return the new absolute position." msgstr "" -#: ../src/Doc/library/io.rst:322 +#: library/io.rst:317 +msgid "The ``SEEK_*`` constants" +msgstr "" + +#: library/io.rst:322 msgid "" "Return ``True`` if the stream supports random access. If ``False``, :meth:" "`seek`, :meth:`tell` and :meth:`truncate` will raise :exc:`IOError`." msgstr "" -#: ../src/Doc/library/io.rst:327 +#: library/io.rst:327 msgid "Return the current stream position." msgstr "" -#: ../src/Doc/library/io.rst:331 +#: library/io.rst:331 msgid "" "Resize the stream to the given *size* in bytes (or the current position if " "*size* is not specified). The current stream position isn't changed. This " @@ -52376,46 +53558,46 @@ msgid "" "file size is returned." msgstr "" -#: ../src/Doc/library/io.rst:340 +#: library/io.rst:340 msgid "" "Return ``True`` if the stream supports writing. If ``False``, :meth:`write` " "and :meth:`truncate` will raise :exc:`IOError`." msgstr "" -#: ../src/Doc/library/io.rst:345 +#: library/io.rst:345 msgid "" "Write a list of lines to the stream. Line separators are not added, so it " "is usual for each of the lines provided to have a line separator at the end." msgstr "" # a59db9c27c1143fcb7e4d139928abaa0 -#: ../src/Doc/library/io.rst:351 +#: library/io.rst:351 msgid "" "Prepare for object destruction. :class:`IOBase` provides a default " "implementation of this method that calls the instance's :meth:`~IOBase." "close` method." msgstr "" -#: ../src/Doc/library/io.rst:358 +#: library/io.rst:358 msgid "" "Base class for raw binary I/O. It inherits :class:`IOBase`. There is no " "public constructor." msgstr "" -#: ../src/Doc/library/io.rst:361 +#: library/io.rst:361 msgid "" "Raw binary I/O typically provides low-level access to an underlying OS " "device or API, and does not try to encapsulate it in high-level primitives " "(this is left to Buffered I/O and Text I/O, described later in this page)." msgstr "" -#: ../src/Doc/library/io.rst:365 +#: library/io.rst:365 msgid "" "In addition to the attributes and methods from :class:`IOBase`, RawIOBase " "provides the following methods:" msgstr "" -#: ../src/Doc/library/io.rst:370 +#: library/io.rst:370 msgid "" "Read up to *n* bytes from the object and return them. As a convenience, if " "*n* is unspecified or -1, :meth:`readall` is called. Otherwise, only one " @@ -52423,28 +53605,28 @@ msgid "" "operating system call returns fewer than *n* bytes." msgstr "" -#: ../src/Doc/library/io.rst:375 +#: library/io.rst:375 msgid "" "If 0 bytes are returned, and *n* was not 0, this indicates end of file. If " "the object is in non-blocking mode and no bytes are available, ``None`` is " "returned." msgstr "" -#: ../src/Doc/library/io.rst:381 +#: library/io.rst:381 msgid "" "Read and return all the bytes from the stream until EOF, using multiple " "calls to the stream if necessary." msgstr "" # d63fbdd611a94e41aedbf3004ebe0a53 -#: ../src/Doc/library/io.rst:386 +#: library/io.rst:386 msgid "" "Read up to len(b) bytes into bytearray *b* and return the number of bytes " "read. If the object is in non-blocking mode and no bytes are available, " "``None`` is returned." msgstr "" -#: ../src/Doc/library/io.rst:392 +#: library/io.rst:392 msgid "" "Write the given bytes or bytearray object, *b*, to the underlying raw stream " "and return the number of bytes written. This can be less than ``len(b)``, " @@ -52453,13 +53635,13 @@ msgid "" "block and no single byte could be readily written to it." msgstr "" -#: ../src/Doc/library/io.rst:402 +#: library/io.rst:402 msgid "" "Base class for binary streams that support some kind of buffering. It " "inherits :class:`IOBase`. There is no public constructor." msgstr "" -#: ../src/Doc/library/io.rst:405 +#: library/io.rst:405 msgid "" "The main difference with :class:`RawIOBase` is that methods :meth:`read`, :" "meth:`readinto` and :meth:`write` will try (respectively) to read as much " @@ -52467,7 +53649,7 @@ msgid "" "perhaps more than one system call." msgstr "" -#: ../src/Doc/library/io.rst:410 +#: library/io.rst:410 msgid "" "In addition, those methods can raise :exc:`BlockingIOError` if the " "underlying raw stream is in non-blocking mode and cannot take or give enough " @@ -52475,13 +53657,13 @@ msgid "" "``None``." msgstr "" -#: ../src/Doc/library/io.rst:415 +#: library/io.rst:415 msgid "" "Besides, the :meth:`read` method does not have a default implementation that " "defers to :meth:`readinto`." msgstr "" -#: ../src/Doc/library/io.rst:418 +#: library/io.rst:418 msgid "" "A typical :class:`BufferedIOBase` implementation should not inherit from a :" "class:`RawIOBase` implementation, but wrap one, like :class:`BufferedWriter` " @@ -52489,42 +53671,42 @@ msgid "" msgstr "" # 36d9ebc007ba4be684b4a0aa4051132f -#: ../src/Doc/library/io.rst:422 +#: library/io.rst:422 msgid "" ":class:`BufferedIOBase` provides or overrides these methods and attribute in " "addition to those from :class:`IOBase`:" msgstr "" -#: ../src/Doc/library/io.rst:427 +#: library/io.rst:427 msgid "" "The underlying raw stream (a :class:`RawIOBase` instance) that :class:" "`BufferedIOBase` deals with. This is not part of the :class:" "`BufferedIOBase` API and may not exist on some implementations." msgstr "" -#: ../src/Doc/library/io.rst:433 +#: library/io.rst:433 msgid "Separate the underlying raw stream from the buffer and return it." msgstr "" -#: ../src/Doc/library/io.rst:435 +#: library/io.rst:435 msgid "" "After the raw stream has been detached, the buffer is in an unusable state." msgstr "" -#: ../src/Doc/library/io.rst:438 +#: library/io.rst:438 msgid "" "Some buffers, like :class:`BytesIO`, do not have the concept of a single raw " "stream to return from this method. They raise :exc:`UnsupportedOperation`." msgstr "" -#: ../src/Doc/library/io.rst:446 +#: library/io.rst:446 msgid "" "Read and return up to *n* bytes. If the argument is omitted, ``None``, or " "negative, data is read and returned until EOF is reached. An empty bytes " "object is returned if the stream is already at EOF." msgstr "" -#: ../src/Doc/library/io.rst:450 +#: library/io.rst:450 msgid "" "If the argument is positive, and the underlying raw stream is not " "interactive, multiple raw reads may be issued to satisfy the byte count " @@ -52533,32 +53715,32 @@ msgid "" "imminent." msgstr "" -#: ../src/Doc/library/io.rst:456 ../src/Doc/library/io.rst:474 +#: library/io.rst:456 library/io.rst:474 msgid "" "A :exc:`BlockingIOError` is raised if the underlying raw stream is in non " "blocking-mode, and has no data available at the moment." msgstr "" -#: ../src/Doc/library/io.rst:461 +#: library/io.rst:461 msgid "" "Read and return up to *n* bytes, with at most one call to the underlying raw " "stream's :meth:`~RawIOBase.read` method. This can be useful if you are " "implementing your own buffering on top of a :class:`BufferedIOBase` object." msgstr "" -#: ../src/Doc/library/io.rst:468 +#: library/io.rst:468 msgid "" "Read up to len(b) bytes into bytearray *b* and return the number of bytes " "read." msgstr "" -#: ../src/Doc/library/io.rst:471 +#: library/io.rst:471 msgid "" "Like :meth:`read`, multiple reads may be issued to the underlying raw " "stream, unless the latter is 'interactive'." msgstr "" -#: ../src/Doc/library/io.rst:479 +#: library/io.rst:479 msgid "" "Write the given bytes or bytearray object, *b* and return the number of " "bytes written (never less than ``len(b)``, since if the write fails an :exc:" @@ -52567,40 +53749,40 @@ msgid "" "for performance and latency reasons." msgstr "" -#: ../src/Doc/library/io.rst:485 +#: library/io.rst:485 msgid "" "When in non-blocking mode, a :exc:`BlockingIOError` is raised if the data " "needed to be written to the raw stream but it couldn't accept all the data " "without blocking." msgstr "" -#: ../src/Doc/library/io.rst:491 +#: library/io.rst:491 msgid "Raw File I/O" msgstr "" -#: ../src/Doc/library/io.rst:495 +#: library/io.rst:495 msgid "" ":class:`FileIO` represents an OS-level file containing bytes data. It " "implements the :class:`RawIOBase` interface (and therefore the :class:" "`IOBase` interface, too)." msgstr "" -#: ../src/Doc/library/io.rst:499 +#: library/io.rst:499 msgid "The *name* can be one of two things:" msgstr "" # 7c88c0ba9471404db1f92353ca13e3e4 -#: ../src/Doc/library/io.rst:501 +#: library/io.rst:501 msgid "a string representing the path to the file which will be opened;" msgstr "" -#: ../src/Doc/library/io.rst:502 +#: library/io.rst:502 msgid "" "an integer representing the number of an existing OS-level file descriptor " "to which the resulting :class:`FileIO` object will give access." msgstr "" -#: ../src/Doc/library/io.rst:505 +#: library/io.rst:505 msgid "" "The *mode* can be ``'r'``, ``'w'`` or ``'a'`` for reading (default), " "writing, or appending. The file will be created if it doesn't exist when " @@ -52609,66 +53791,66 @@ msgid "" "writing." msgstr "" -#: ../src/Doc/library/io.rst:510 +#: library/io.rst:510 msgid "" "The :meth:`read` (when called with a positive argument), :meth:`readinto` " "and :meth:`write` methods on this class will only make one system call." msgstr "" -#: ../src/Doc/library/io.rst:513 +#: library/io.rst:513 msgid "" "In addition to the attributes and methods from :class:`IOBase` and :class:" "`RawIOBase`, :class:`FileIO` provides the following data attributes and " "methods:" msgstr "" -#: ../src/Doc/library/io.rst:519 +#: library/io.rst:519 msgid "The mode as given in the constructor." msgstr "" -#: ../src/Doc/library/io.rst:523 +#: library/io.rst:523 msgid "" "The file name. This is the file descriptor of the file when no name is " "given in the constructor." msgstr "" -#: ../src/Doc/library/io.rst:528 +#: library/io.rst:528 msgid "Buffered Streams" msgstr "" # 092cbed1e0c945efb4712e0d8a3e7a37 -#: ../src/Doc/library/io.rst:530 +#: library/io.rst:530 msgid "" "Buffered I/O streams provide a higher-level interface to an I/O device than " "raw I/O does." msgstr "" -#: ../src/Doc/library/io.rst:535 +#: library/io.rst:535 msgid "" "A stream implementation using an in-memory bytes buffer. It inherits :class:" "`BufferedIOBase`." msgstr "" # d0aed931cfc54528acb5ed3367017cd3 -#: ../src/Doc/library/io.rst:538 +#: library/io.rst:538 msgid "The argument *initial_bytes* is an optional initial :class:`bytes`." msgstr "" -#: ../src/Doc/library/io.rst:540 +#: library/io.rst:540 msgid "" ":class:`BytesIO` provides or overrides these methods in addition to those " "from :class:`BufferedIOBase` and :class:`IOBase`:" msgstr "" -#: ../src/Doc/library/io.rst:545 +#: library/io.rst:545 msgid "Return ``bytes`` containing the entire contents of the buffer." msgstr "" -#: ../src/Doc/library/io.rst:549 +#: library/io.rst:549 msgid "In :class:`BytesIO`, this is the same as :meth:`read`." msgstr "" -#: ../src/Doc/library/io.rst:554 +#: library/io.rst:554 msgid "" "A buffer providing higher-level access to a readable, sequential :class:" "`RawIOBase` object. It inherits :class:`BufferedIOBase`. When reading data " @@ -52677,40 +53859,40 @@ msgid "" "then be returned directly on subsequent reads." msgstr "" -#: ../src/Doc/library/io.rst:560 +#: library/io.rst:560 msgid "" "The constructor creates a :class:`BufferedReader` for the given readable " "*raw* stream and *buffer_size*. If *buffer_size* is omitted, :data:" "`DEFAULT_BUFFER_SIZE` is used." msgstr "" -#: ../src/Doc/library/io.rst:564 +#: library/io.rst:564 msgid "" ":class:`BufferedReader` provides or overrides these methods in addition to " "those from :class:`BufferedIOBase` and :class:`IOBase`:" msgstr "" -#: ../src/Doc/library/io.rst:569 +#: library/io.rst:569 msgid "" "Return bytes from the stream without advancing the position. At most one " "single read on the raw stream is done to satisfy the call. The number of " "bytes returned may be less or more than requested." msgstr "" -#: ../src/Doc/library/io.rst:575 +#: library/io.rst:575 msgid "" "Read and return *n* bytes, or if *n* is not given or negative, until EOF or " "if the read call would block in non-blocking mode." msgstr "" -#: ../src/Doc/library/io.rst:580 +#: library/io.rst:580 msgid "" "Read and return up to *n* bytes with only one call on the raw stream. If at " "least one byte is buffered, only buffered bytes are returned. Otherwise, one " "raw stream read call is made." msgstr "" -#: ../src/Doc/library/io.rst:587 +#: library/io.rst:587 msgid "" "A buffer providing higher-level access to a writeable, sequential :class:" "`RawIOBase` object. It inherits :class:`BufferedIOBase`. When writing to " @@ -52719,96 +53901,96 @@ msgid "" "conditions, including:" msgstr "" -#: ../src/Doc/library/io.rst:593 +#: library/io.rst:593 msgid "when the buffer gets too small for all pending data;" msgstr "" -#: ../src/Doc/library/io.rst:594 +#: library/io.rst:594 msgid "when :meth:`flush()` is called;" msgstr "" -#: ../src/Doc/library/io.rst:595 +#: library/io.rst:595 msgid "" "when a :meth:`seek()` is requested (for :class:`BufferedRandom` objects);" msgstr "" -#: ../src/Doc/library/io.rst:596 +#: library/io.rst:596 msgid "when the :class:`BufferedWriter` object is closed or destroyed." msgstr "" -#: ../src/Doc/library/io.rst:598 +#: library/io.rst:598 msgid "" "The constructor creates a :class:`BufferedWriter` for the given writeable " "*raw* stream. If the *buffer_size* is not given, it defaults to :data:" "`DEFAULT_BUFFER_SIZE`." msgstr "" -#: ../src/Doc/library/io.rst:602 ../src/Doc/library/io.rst:629 +#: library/io.rst:602 library/io.rst:629 msgid "" "A third argument, *max_buffer_size*, is supported, but unused and deprecated." msgstr "" -#: ../src/Doc/library/io.rst:604 +#: library/io.rst:604 msgid "" ":class:`BufferedWriter` provides or overrides these methods in addition to " "those from :class:`BufferedIOBase` and :class:`IOBase`:" msgstr "" -#: ../src/Doc/library/io.rst:609 +#: library/io.rst:609 msgid "" "Force bytes held in the buffer into the raw stream. A :exc:" "`BlockingIOError` should be raised if the raw stream blocks." msgstr "" -#: ../src/Doc/library/io.rst:614 +#: library/io.rst:614 msgid "" "Write the bytes or bytearray object, *b* and return the number of bytes " "written. When in non-blocking mode, a :exc:`BlockingIOError` is raised if " "the buffer needs to be written out but the raw stream blocks." msgstr "" -#: ../src/Doc/library/io.rst:621 +#: library/io.rst:621 msgid "" "A buffered interface to random access streams. It inherits :class:" "`BufferedReader` and :class:`BufferedWriter`, and further supports :meth:" "`seek` and :meth:`tell` functionality." msgstr "" -#: ../src/Doc/library/io.rst:625 +#: library/io.rst:625 msgid "" "The constructor creates a reader and writer for a seekable raw stream, given " "in the first argument. If the *buffer_size* is omitted it defaults to :data:" "`DEFAULT_BUFFER_SIZE`." msgstr "" -#: ../src/Doc/library/io.rst:631 +#: library/io.rst:631 msgid "" ":class:`BufferedRandom` is capable of anything :class:`BufferedReader` or :" "class:`BufferedWriter` can do." msgstr "" # abdee9ee830347328c35ffa34785286e -#: ../src/Doc/library/io.rst:637 +#: library/io.rst:637 msgid "" "A buffered I/O object combining two unidirectional :class:`RawIOBase` " "objects -- one readable, the other writeable -- into a single bidirectional " "endpoint. It inherits :class:`BufferedIOBase`." msgstr "" -#: ../src/Doc/library/io.rst:641 +#: library/io.rst:641 msgid "" "*reader* and *writer* are :class:`RawIOBase` objects that are readable and " "writeable respectively. If the *buffer_size* is omitted it defaults to :" "data:`DEFAULT_BUFFER_SIZE`." msgstr "" -#: ../src/Doc/library/io.rst:645 +#: library/io.rst:645 msgid "" "A fourth argument, *max_buffer_size*, is supported, but unused and " "deprecated." msgstr "" -#: ../src/Doc/library/io.rst:648 +#: library/io.rst:648 msgid "" ":class:`BufferedRWPair` implements all of :class:`BufferedIOBase`\\'s " "methods except for :meth:`~BufferedIOBase.detach`, which raises :exc:" @@ -52816,19 +53998,19 @@ msgid "" msgstr "" # 93d4dca107d64f27be133e5ec6a762fd -#: ../src/Doc/library/io.rst:654 +#: library/io.rst:654 msgid "" ":class:`BufferedRWPair` does not attempt to synchronize accesses to its " "underlying raw streams. You should not pass it the same object as reader " "and writer; use :class:`BufferedRandom` instead." msgstr "" -#: ../src/Doc/library/io.rst:660 ../src/Doc/library/io.rst:868 +#: library/io.rst:660 library/io.rst:876 msgid "Text I/O" msgstr "" # acc0e5d775b74c37a4ff8c1089e7eee7 -#: ../src/Doc/library/io.rst:664 +#: library/io.rst:664 msgid "" "Base class for text streams. This class provides an unicode character and " "line based interface to stream I/O. There is no :meth:`readinto` method " @@ -52836,49 +54018,49 @@ msgid "" "`IOBase`. There is no public constructor." msgstr "" -#: ../src/Doc/library/io.rst:669 +#: library/io.rst:669 msgid "" ":class:`TextIOBase` provides or overrides these data attributes and methods " "in addition to those from :class:`IOBase`:" msgstr "" -#: ../src/Doc/library/io.rst:674 +#: library/io.rst:674 msgid "" "The name of the encoding used to decode the stream's bytes into strings, and " "to encode strings into bytes." msgstr "" -#: ../src/Doc/library/io.rst:679 +#: library/io.rst:679 msgid "The error setting of the decoder or encoder." msgstr "" -#: ../src/Doc/library/io.rst:683 +#: library/io.rst:683 msgid "" "A string, a tuple of strings, or ``None``, indicating the newlines " "translated so far. Depending on the implementation and the initial " "constructor flags, this may not be available." msgstr "" -#: ../src/Doc/library/io.rst:689 +#: library/io.rst:689 msgid "" "The underlying binary buffer (a :class:`BufferedIOBase` instance) that :" "class:`TextIOBase` deals with. This is not part of the :class:`TextIOBase` " "API and may not exist on some implementations." msgstr "" -#: ../src/Doc/library/io.rst:695 +#: library/io.rst:695 msgid "" "Separate the underlying binary buffer from the :class:`TextIOBase` and " "return it." msgstr "" -#: ../src/Doc/library/io.rst:698 +#: library/io.rst:698 msgid "" "After the underlying buffer has been detached, the :class:`TextIOBase` is in " "an unusable state." msgstr "" -#: ../src/Doc/library/io.rst:701 +#: library/io.rst:701 msgid "" "Some :class:`TextIOBase` implementations, like :class:`StringIO`, may not " "have the concept of an underlying buffer and calling this method will raise :" @@ -52886,33 +54068,32 @@ msgid "" msgstr "" # 6d6ae84e0172411d97f82fbf5101ca35 -#: ../src/Doc/library/io.rst:709 +#: library/io.rst:709 msgid "" "Read and return at most *n* characters from the stream as a single :class:" "`unicode`. If *n* is negative or ``None``, reads until EOF." msgstr "" # 2a1f6103f0b446c4a7922108e502fc1e -#: ../src/Doc/library/io.rst:714 +#: library/io.rst:714 msgid "" "Read until newline or EOF and return a single ``unicode``. If the stream is " "already at EOF, an empty string is returned." msgstr "" # 0ad2131604ba437aa0e9088f328eaed1 -#: ../src/Doc/library/io.rst:717 +#: library/io.rst:717 msgid "If *limit* is specified, at most *limit* characters will be read." msgstr "" -# 58f39ef541a84bf6bc32b72034f570d6 -#: ../src/Doc/library/io.rst:721 +#: library/io.rst:721 msgid "" "Change the stream position to the given *offset*. Behaviour depends on the " -"*whence* parameter:" +"*whence* parameter. The default value for *whence* is :data:`SEEK_SET`." msgstr "" # c38af41713c8471f89531786c117e4d3 -#: ../src/Doc/library/io.rst:724 +#: library/io.rst:725 msgid "" ":data:`SEEK_SET` or ``0``: seek from the start of the stream (the default); " "*offset* must either be a number returned by :meth:`TextIOBase.tell`, or " @@ -52920,51 +54101,55 @@ msgid "" msgstr "" # 4457a27d52b84231bf5d07ad220e3f97 -#: ../src/Doc/library/io.rst:728 +#: library/io.rst:729 msgid "" ":data:`SEEK_CUR` or ``1``: \"seek\" to the current position; *offset* must " "be zero, which is a no-operation (all other values are unsupported)." msgstr "" # 07eddcdcef65429da30480f2bd783a3e -#: ../src/Doc/library/io.rst:731 +#: library/io.rst:732 msgid "" ":data:`SEEK_END` or ``2``: seek to the end of the stream; *offset* must be " "zero (all other values are unsupported)." msgstr "" # e5768c8347e241e985007addce2f3aa3 -#: ../src/Doc/library/io.rst:734 +#: library/io.rst:735 msgid "Return the new absolute position as an opaque number." msgstr "" +#: library/io.rst:737 +msgid "The ``SEEK_*`` constants." +msgstr "" + # 76bb3ce7579e49c3a6840e6abb11264d -#: ../src/Doc/library/io.rst:741 +#: library/io.rst:742 msgid "" "Return the current stream position as an opaque number. The number does not " "usually represent a number of bytes in the underlying binary storage." msgstr "" # 502151bb335349489c5e0c463067169e -#: ../src/Doc/library/io.rst:747 +#: library/io.rst:748 msgid "" "Write the :class:`unicode` string *s* to the stream and return the number of " "characters written." msgstr "" -#: ../src/Doc/library/io.rst:753 +#: library/io.rst:754 msgid "" "A buffered text stream over a :class:`BufferedIOBase` binary stream. It " "inherits :class:`TextIOBase`." msgstr "" -#: ../src/Doc/library/io.rst:756 +#: library/io.rst:757 msgid "" "*encoding* gives the name of the encoding that the stream will be decoded or " "encoded with. It defaults to :func:`locale.getpreferredencoding`." msgstr "" -#: ../src/Doc/library/io.rst:759 +#: library/io.rst:760 msgid "" "*errors* is an optional string that specifies how encoding and decoding " "errors are to be handled. Pass ``'strict'`` to raise a :exc:`ValueError` " @@ -52979,14 +54164,14 @@ msgid "" msgstr "" # 95a5b8e334c243bd96c5d0b6d234c0f2 -#: ../src/Doc/library/io.rst:773 +#: library/io.rst:774 msgid "" "*newline* controls how line endings are handled. It can be ``None``, " "``''``, ``'\\n'``, ``'\\r'``, and ``'\\r\\n'``. It works as follows:" msgstr "" # abb00f7dc17d45d79a5ef7f67b34ad71 -#: ../src/Doc/library/io.rst:776 +#: library/io.rst:777 msgid "" "On input, if *newline* is ``None``, :term:`universal newlines` mode is " "enabled. Lines in the input can end in ``'\\n'``, ``'\\r'``, or ``'\\r" @@ -52997,88 +54182,95 @@ msgid "" "line ending is returned to the caller untranslated." msgstr "" -#: ../src/Doc/library/io.rst:790 +#: library/io.rst:791 msgid "" "If *line_buffering* is ``True``, :meth:`flush` is implied when a call to " "write contains a newline character." msgstr "" -#: ../src/Doc/library/io.rst:793 +#: library/io.rst:794 msgid "" ":class:`TextIOWrapper` provides one attribute in addition to those of :class:" "`TextIOBase` and its parents:" msgstr "" -#: ../src/Doc/library/io.rst:798 +#: library/io.rst:799 msgid "Whether line buffering is enabled." msgstr "" # 59ff67e428d94a8f842ed2dd2b766664 -#: ../src/Doc/library/io.rst:803 +#: library/io.rst:804 msgid "" "An in-memory stream for unicode text. It inherits :class:`TextIOWrapper`." msgstr "" -# 0112bb7c2a944525b9b0152763819847 -#: ../src/Doc/library/io.rst:805 +#: library/io.rst:806 msgid "" -"The initial value of the buffer (an empty unicode string by default) can be " -"set by providing *initial_value*. The *newline* argument works like that " -"of :class:`TextIOWrapper`. The default is to consider only ``\\n`` " -"characters as end of lines and to do no newline translation." +"The initial value of the buffer can be set by providing *initial_value*. If " +"newline translation is enabled, newlines will be encoded as if by :meth:" +"`~TextIOBase.write`. The stream is positioned at the start of the buffer." msgstr "" -#: ../src/Doc/library/io.rst:810 +#: library/io.rst:811 +msgid "" +"The *newline* argument works like that of :class:`TextIOWrapper`. The " +"default is to consider only ``\\n`` characters as ends of lines and to do no " +"newline translation. If *newline* is set to ``None``, newlines are written " +"as ``\\n`` on all platforms, but universal newline decoding is still " +"performed when reading." +msgstr "" + +#: library/io.rst:817 msgid "" ":class:`StringIO` provides this method in addition to those from :class:" "`TextIOWrapper` and its parents:" msgstr "" -# e59960ceb6ca4a498c35b3586b9946f0 -#: ../src/Doc/library/io.rst:815 +#: library/io.rst:822 msgid "" "Return a ``unicode`` containing the entire contents of the buffer at any " -"time before the :class:`StringIO` object's :meth:`close` method is called." +"time before the :class:`StringIO` object's :meth:`close` method is called. " +"Newlines are decoded as if by :meth:`~TextIOBase.read`, although the stream " +"position is not changed." msgstr "" -#: ../src/Doc/library/io.rst:819 ../src/Doc/library/stringio.rst:43 -#: ../src/Doc/library/stringio.rst:112 ../src/Doc/library/wsgiref.rst:117 -#: ../src/Doc/library/wsgiref.rst:164 ../src/Doc/library/wsgiref.rst:281 -#: ../src/Doc/library/wsgiref.rst:413 +#: library/io.rst:827 library/stringio.rst:43 library/stringio.rst:112 +#: library/wsgiref.rst:117 library/wsgiref.rst:164 library/wsgiref.rst:281 +#: library/wsgiref.rst:413 msgid "Example usage::" msgstr "" # 7f254437c4bb484ab1c19d4075923387 -#: ../src/Doc/library/io.rst:841 +#: library/io.rst:849 msgid "" "A helper codec that decodes newlines for :term:`universal newlines` mode. It " "inherits :class:`codecs.IncrementalDecoder`." msgstr "" # 985f1542b9e84c2dbf919f4576695bce -#: ../src/Doc/library/io.rst:846 +#: library/io.rst:854 msgid "Advanced topics" msgstr "" # b94f3340a25b4c06a658e1969f2d5b33 -#: ../src/Doc/library/io.rst:848 +#: library/io.rst:856 msgid "" "Here we will discuss several advanced topics pertaining to the concrete I/O " "implementations described above." msgstr "" # ad26ad5274184c9796c08515cdc10a14 -#: ../src/Doc/library/io.rst:852 +#: library/io.rst:860 msgid "Performance" msgstr "" # 40b0a165c7f64485b72f2fc89a603a95 -#: ../src/Doc/library/io.rst:855 +#: library/io.rst:863 msgid "Binary I/O" msgstr "" # 5093c77b9c7847289f5d9ab435e9ecfa -#: ../src/Doc/library/io.rst:857 +#: library/io.rst:865 msgid "" "By reading and writing only large chunks of data even when the user asks for " "a single byte, buffered I/O is designed to hide any inefficiency in calling " @@ -53092,7 +54284,7 @@ msgid "" msgstr "" # fe7be4a49ee14ac5b184fee707ff0054 -#: ../src/Doc/library/io.rst:870 +#: library/io.rst:878 msgid "" "Text I/O over a binary storage (such as a file) is significantly slower than " "binary I/O over the same storage, because it implies conversions from " @@ -53103,19 +54295,19 @@ msgid "" msgstr "" # f5c282dc73fa4e0e842135f9b98162a6 -#: ../src/Doc/library/io.rst:877 +#: library/io.rst:885 msgid "" ":class:`StringIO`, however, is a native in-memory unicode container and will " "exhibit similar speed to :class:`BytesIO`." msgstr "" # db645c228fb1468b8cbdef7c40b18435 -#: ../src/Doc/library/io.rst:881 +#: library/io.rst:889 msgid "Multi-threading" msgstr "Threads" # 2f0281f86ce64109b28850ad2aa4c15d -#: ../src/Doc/library/io.rst:883 +#: library/io.rst:891 msgid "" ":class:`FileIO` objects are thread-safe to the extent that the operating " "system calls (such as ``read(2)`` under Unix) they are wrapping are thread-" @@ -53123,7 +54315,7 @@ msgid "" msgstr "" # ce751e093e7142ba89688a868feec3b9 -#: ../src/Doc/library/io.rst:887 +#: library/io.rst:895 msgid "" "Binary buffered objects (instances of :class:`BufferedReader`, :class:" "`BufferedWriter`, :class:`BufferedRandom` and :class:`BufferedRWPair`) " @@ -53132,17 +54324,17 @@ msgid "" msgstr "" # 2385c68b7b414d37b8ee39d880195d64 -#: ../src/Doc/library/io.rst:892 +#: library/io.rst:900 msgid ":class:`TextIOWrapper` objects are not thread-safe." msgstr "" # 5f5fb5e7c5a44c36bee925634ef78654 -#: ../src/Doc/library/io.rst:895 +#: library/io.rst:903 msgid "Reentrancy" msgstr "" # 9721a15234df4f17bfb1f4ecab8afb96 -#: ../src/Doc/library/io.rst:897 +#: library/io.rst:905 msgid "" "Binary buffered objects (instances of :class:`BufferedReader`, :class:" "`BufferedWriter`, :class:`BufferedRandom` and :class:`BufferedRWPair`) are " @@ -53153,7 +54345,7 @@ msgid "" msgstr "" # 2041d81613e643359e9b8baec9ee0ed4 -#: ../src/Doc/library/io.rst:904 +#: library/io.rst:912 msgid "" "The above implicitly extends to text files, since the :func:`open()` " "function will wrap a buffered object inside a :class:`TextIOWrapper`. This " @@ -53161,35 +54353,35 @@ msgid "" "`print()` as well." msgstr "" -#: ../src/Doc/library/ipc.rst:6 +#: library/ipc.rst:6 msgid "Interprocess Communication and Networking" msgstr "" -#: ../src/Doc/library/ipc.rst:8 +#: library/ipc.rst:8 msgid "" "The modules described in this chapter provide mechanisms for different " "processes to communicate." msgstr "" -#: ../src/Doc/library/ipc.rst:11 +#: library/ipc.rst:11 msgid "" "Some modules only work for two processes that are on the same machine, e.g. :" "mod:`signal` and :mod:`subprocess`. Other modules support networking " "protocols that two or more processes can used to communicate across machines." msgstr "" -#: ../src/Doc/library/itertools.rst:3 +#: library/itertools.rst:3 msgid ":mod:`itertools` --- Functions creating iterators for efficient looping" msgstr "" -#: ../src/Doc/library/itertools.rst:17 +#: library/itertools.rst:17 msgid "" "This module implements a number of :term:`iterator` building blocks inspired " "by constructs from APL, Haskell, and SML. Each has been recast in a form " "suitable for Python." msgstr "" -#: ../src/Doc/library/itertools.rst:21 +#: library/itertools.rst:21 msgid "" "The module standardizes a core set of fast, memory efficient tools that are " "useful by themselves or in combination. Together, they form an \"iterator " @@ -53198,7 +54390,7 @@ msgid "" msgstr "" # 647e1736c7174a3aa67d97bc91e115dc -#: ../src/Doc/library/itertools.rst:26 +#: library/itertools.rst:26 msgid "" "For instance, SML provides a tabulation tool: ``tabulate(f)`` which produces " "a sequence ``f(0), f(1), ...``. The same effect can be achieved in Python " @@ -53206,7 +54398,7 @@ msgid "" msgstr "" # 421dd63a6fae44b0a82e69ec5227c0f5 -#: ../src/Doc/library/itertools.rst:30 +#: library/itertools.rst:30 msgid "" "These tools and their built-in counterparts also work well with the high-" "speed functions in the :mod:`operator` module. For example, the " @@ -53214,363 +54406,359 @@ msgid "" "efficient dot-product: ``sum(imap(operator.mul, vector1, vector2))``." msgstr "" -#: ../src/Doc/library/itertools.rst:36 +#: library/itertools.rst:36 msgid "**Infinite Iterators:**" msgstr "" -#: ../src/Doc/library/itertools.rst:39 ../src/Doc/library/itertools.rst:49 -#: ../src/Doc/library/itertools.rst:69 +#: library/itertools.rst:39 library/itertools.rst:49 library/itertools.rst:69 #, fuzzy msgid "Iterator" msgstr "Itérateurs" -#: ../src/Doc/library/itertools.rst:39 ../src/Doc/library/itertools.rst:49 -#: ../src/Doc/library/itertools.rst:69 +#: library/itertools.rst:39 library/itertools.rst:49 library/itertools.rst:69 msgid "Arguments" msgstr "" -#: ../src/Doc/library/itertools.rst:39 ../src/Doc/library/itertools.rst:49 -#: ../src/Doc/library/itertools.rst:69 +#: library/itertools.rst:39 library/itertools.rst:49 library/itertools.rst:69 msgid "Results" msgstr "" -#: ../src/Doc/library/itertools.rst:41 +#: library/itertools.rst:41 msgid ":func:`count`" msgstr "" -#: ../src/Doc/library/itertools.rst:41 +#: library/itertools.rst:41 msgid "start, [step]" msgstr "" -#: ../src/Doc/library/itertools.rst:41 +#: library/itertools.rst:41 msgid "start, start+step, start+2*step, ..." msgstr "" -#: ../src/Doc/library/itertools.rst:41 +#: library/itertools.rst:41 msgid "``count(10) --> 10 11 12 13 14 ...``" msgstr "" -#: ../src/Doc/library/itertools.rst:42 +#: library/itertools.rst:42 msgid ":func:`cycle`" msgstr "" -#: ../src/Doc/library/itertools.rst:42 +#: library/itertools.rst:42 msgid "p" msgstr "" -#: ../src/Doc/library/itertools.rst:42 +#: library/itertools.rst:42 msgid "p0, p1, ... plast, p0, p1, ..." msgstr "" -#: ../src/Doc/library/itertools.rst:42 +#: library/itertools.rst:42 msgid "``cycle('ABCD') --> A B C D A B C D ...``" msgstr "" -#: ../src/Doc/library/itertools.rst:43 +#: library/itertools.rst:43 msgid ":func:`repeat`" msgstr "" -#: ../src/Doc/library/itertools.rst:43 +#: library/itertools.rst:43 msgid "elem [,n]" msgstr "" -#: ../src/Doc/library/itertools.rst:43 +#: library/itertools.rst:43 msgid "elem, elem, elem, ... endlessly or up to n times" msgstr "" -#: ../src/Doc/library/itertools.rst:43 +#: library/itertools.rst:43 msgid "``repeat(10, 3) --> 10 10 10``" msgstr "" -#: ../src/Doc/library/itertools.rst:46 +#: library/itertools.rst:46 msgid "**Iterators terminating on the shortest input sequence:**" msgstr "" -#: ../src/Doc/library/itertools.rst:51 +#: library/itertools.rst:51 msgid ":func:`chain`" msgstr "" -#: ../src/Doc/library/itertools.rst:51 ../src/Doc/library/itertools.rst:62 -#: ../src/Doc/library/itertools.rst:63 +#: library/itertools.rst:51 library/itertools.rst:62 library/itertools.rst:63 msgid "p, q, ..." msgstr "" -#: ../src/Doc/library/itertools.rst:51 +#: library/itertools.rst:51 msgid "p0, p1, ... plast, q0, q1, ..." msgstr "" -#: ../src/Doc/library/itertools.rst:51 +#: library/itertools.rst:51 msgid "``chain('ABC', 'DEF') --> A B C D E F``" msgstr "" -#: ../src/Doc/library/itertools.rst:52 +#: library/itertools.rst:52 msgid ":func:`compress`" msgstr "" -#: ../src/Doc/library/itertools.rst:52 +#: library/itertools.rst:52 msgid "data, selectors" msgstr "" -#: ../src/Doc/library/itertools.rst:52 +#: library/itertools.rst:52 msgid "(d[0] if s[0]), (d[1] if s[1]), ..." msgstr "" -#: ../src/Doc/library/itertools.rst:52 +#: library/itertools.rst:52 msgid "``compress('ABCDEF', [1,0,1,0,1,1]) --> A C E F``" msgstr "" -#: ../src/Doc/library/itertools.rst:53 +#: library/itertools.rst:53 msgid ":func:`dropwhile`" msgstr "" -#: ../src/Doc/library/itertools.rst:53 ../src/Doc/library/itertools.rst:55 -#: ../src/Doc/library/itertools.rst:56 ../src/Doc/library/itertools.rst:61 +#: library/itertools.rst:53 library/itertools.rst:55 library/itertools.rst:56 +#: library/itertools.rst:61 msgid "pred, seq" msgstr "" -#: ../src/Doc/library/itertools.rst:53 +#: library/itertools.rst:53 msgid "seq[n], seq[n+1], starting when pred fails" msgstr "" -#: ../src/Doc/library/itertools.rst:53 +#: library/itertools.rst:53 msgid "``dropwhile(lambda x: x<5, [1,4,6,4,1]) --> 6 4 1``" msgstr "" -#: ../src/Doc/library/itertools.rst:54 +#: library/itertools.rst:54 msgid ":func:`groupby`" msgstr "" -#: ../src/Doc/library/itertools.rst:54 +#: library/itertools.rst:54 msgid "iterable[, keyfunc]" msgstr "" -#: ../src/Doc/library/itertools.rst:54 +#: library/itertools.rst:54 msgid "sub-iterators grouped by value of keyfunc(v)" msgstr "" # 11ac701d6e95458bb66124af4a19a46c -#: ../src/Doc/library/itertools.rst:55 +#: library/itertools.rst:55 msgid ":func:`ifilter`" msgstr "" # 8cc1619bf845418e9a86cc7033e40c5b -#: ../src/Doc/library/itertools.rst:55 +#: library/itertools.rst:55 msgid "elements of seq where pred(elem) is true" msgstr "" # a246f1720f6b4eec88ffe247cc369c9d -#: ../src/Doc/library/itertools.rst:55 +#: library/itertools.rst:55 msgid "``ifilter(lambda x: x%2, range(10)) --> 1 3 5 7 9``" msgstr "" # 89515b56de6b4995a313ca8d90895972 -#: ../src/Doc/library/itertools.rst:56 +#: library/itertools.rst:56 msgid ":func:`ifilterfalse`" msgstr "" # 9815035382e4431c8ce4f092052257c8 -#: ../src/Doc/library/itertools.rst:56 +#: library/itertools.rst:56 msgid "elements of seq where pred(elem) is false" msgstr "" # ea5ae03905f84353b27acbd2df472b82 -#: ../src/Doc/library/itertools.rst:56 +#: library/itertools.rst:56 msgid "``ifilterfalse(lambda x: x%2, range(10)) --> 0 2 4 6 8``" msgstr "" -#: ../src/Doc/library/itertools.rst:57 +#: library/itertools.rst:57 msgid ":func:`islice`" msgstr "" -#: ../src/Doc/library/itertools.rst:57 +#: library/itertools.rst:57 msgid "seq, [start,] stop [, step]" msgstr "" -#: ../src/Doc/library/itertools.rst:57 +#: library/itertools.rst:57 msgid "elements from seq[start:stop:step]" msgstr "" -#: ../src/Doc/library/itertools.rst:57 +#: library/itertools.rst:57 msgid "``islice('ABCDEFG', 2, None) --> C D E F G``" msgstr "" # 336f3da763a3442ea33894094ac09ee1 -#: ../src/Doc/library/itertools.rst:58 +#: library/itertools.rst:58 msgid ":func:`imap`" msgstr "" # 555f6d5dfd294b55837b13c77739066d -#: ../src/Doc/library/itertools.rst:58 +#: library/itertools.rst:58 msgid "func, p, q, ..." msgstr "" # d49eb11e88e6451a8ba605502ff33254 -#: ../src/Doc/library/itertools.rst:58 +#: library/itertools.rst:58 msgid "func(p0, q0), func(p1, q1), ..." msgstr "" # af44ac1cfbef4b0baf565e1a025ca790 -#: ../src/Doc/library/itertools.rst:58 +#: library/itertools.rst:58 msgid "``imap(pow, (2,3,10), (5,2,3)) --> 32 9 1000``" msgstr "" -#: ../src/Doc/library/itertools.rst:59 +#: library/itertools.rst:59 msgid ":func:`starmap`" msgstr "" -#: ../src/Doc/library/itertools.rst:59 +#: library/itertools.rst:59 msgid "func, seq" msgstr "" -#: ../src/Doc/library/itertools.rst:59 +#: library/itertools.rst:59 msgid "func(\\*seq[0]), func(\\*seq[1]), ..." msgstr "" -#: ../src/Doc/library/itertools.rst:59 +#: library/itertools.rst:59 msgid "``starmap(pow, [(2,5), (3,2), (10,3)]) --> 32 9 1000``" msgstr "" -#: ../src/Doc/library/itertools.rst:60 +#: library/itertools.rst:60 msgid ":func:`tee`" msgstr "" -#: ../src/Doc/library/itertools.rst:60 +#: library/itertools.rst:60 msgid "it, n" msgstr "" # 9b7696bc452144c0b9231cdc4a61bae3 -#: ../src/Doc/library/itertools.rst:60 +#: library/itertools.rst:60 msgid "it1, it2, ... itn splits one iterator into n" msgstr "" -#: ../src/Doc/library/itertools.rst:61 +#: library/itertools.rst:61 msgid ":func:`takewhile`" msgstr "" -#: ../src/Doc/library/itertools.rst:61 +#: library/itertools.rst:61 msgid "seq[0], seq[1], until pred fails" msgstr "" -#: ../src/Doc/library/itertools.rst:61 +#: library/itertools.rst:61 msgid "``takewhile(lambda x: x<5, [1,4,6,4,1]) --> 1 4``" msgstr "" # 5c76fa17b38648178711fa87c3f9d834 -#: ../src/Doc/library/itertools.rst:62 +#: library/itertools.rst:62 msgid ":func:`izip`" msgstr "" -#: ../src/Doc/library/itertools.rst:62 ../src/Doc/library/itertools.rst:63 +#: library/itertools.rst:62 library/itertools.rst:63 msgid "(p[0], q[0]), (p[1], q[1]), ..." msgstr "" # 2fa7ac9ef74142cebb7acb51a4aa7155 -#: ../src/Doc/library/itertools.rst:62 +#: library/itertools.rst:62 msgid "``izip('ABCD', 'xy') --> Ax By``" msgstr "" # 1c118f13225d49169f71955ae039af0e -#: ../src/Doc/library/itertools.rst:63 +#: library/itertools.rst:63 msgid ":func:`izip_longest`" msgstr "" # faa63798a8984bb09b092ec4d268b3c4 -#: ../src/Doc/library/itertools.rst:63 +#: library/itertools.rst:63 msgid "``izip_longest('ABCD', 'xy', fillvalue='-') --> Ax By C- D-``" msgstr "" -#: ../src/Doc/library/itertools.rst:66 +#: library/itertools.rst:66 msgid "**Combinatoric generators:**" msgstr "" -#: ../src/Doc/library/itertools.rst:71 +#: library/itertools.rst:71 msgid ":func:`product`" msgstr "" -#: ../src/Doc/library/itertools.rst:71 +#: library/itertools.rst:71 msgid "p, q, ... [repeat=1]" msgstr "" -#: ../src/Doc/library/itertools.rst:71 +#: library/itertools.rst:71 msgid "cartesian product, equivalent to a nested for-loop" msgstr "" -#: ../src/Doc/library/itertools.rst:72 +#: library/itertools.rst:72 msgid ":func:`permutations`" msgstr "" -#: ../src/Doc/library/itertools.rst:72 +#: library/itertools.rst:72 msgid "p[, r]" msgstr "" -#: ../src/Doc/library/itertools.rst:72 +#: library/itertools.rst:72 msgid "r-length tuples, all possible orderings, no repeated elements" msgstr "" -#: ../src/Doc/library/itertools.rst:73 +#: library/itertools.rst:73 msgid ":func:`combinations`" msgstr "" -#: ../src/Doc/library/itertools.rst:73 ../src/Doc/library/itertools.rst:74 +#: library/itertools.rst:73 library/itertools.rst:74 msgid "p, r" msgstr "" -#: ../src/Doc/library/itertools.rst:73 +#: library/itertools.rst:73 msgid "r-length tuples, in sorted order, no repeated elements" msgstr "" -#: ../src/Doc/library/itertools.rst:74 +#: library/itertools.rst:74 msgid ":func:`combinations_with_replacement`" msgstr "" -#: ../src/Doc/library/itertools.rst:74 +#: library/itertools.rst:74 msgid "r-length tuples, in sorted order, with repeated elements" msgstr "" -#: ../src/Doc/library/itertools.rst:75 +#: library/itertools.rst:75 msgid "``product('ABCD', repeat=2)``" msgstr "" -#: ../src/Doc/library/itertools.rst:75 +#: library/itertools.rst:75 msgid "``AA AB AC AD BA BB BC BD CA CB CC CD DA DB DC DD``" msgstr "" -#: ../src/Doc/library/itertools.rst:76 +#: library/itertools.rst:76 msgid "``permutations('ABCD', 2)``" msgstr "" -#: ../src/Doc/library/itertools.rst:76 +#: library/itertools.rst:76 msgid "``AB AC AD BA BC BD CA CB CD DA DB DC``" msgstr "" -#: ../src/Doc/library/itertools.rst:77 +#: library/itertools.rst:77 msgid "``combinations('ABCD', 2)``" msgstr "" -#: ../src/Doc/library/itertools.rst:77 +#: library/itertools.rst:77 msgid "``AB AC AD BC BD CD``" msgstr "" -#: ../src/Doc/library/itertools.rst:78 +#: library/itertools.rst:78 msgid "``combinations_with_replacement('ABCD', 2)``" msgstr "" -#: ../src/Doc/library/itertools.rst:78 +#: library/itertools.rst:78 msgid "``AA AB AC AD BB BC BD CC CD DD``" msgstr "" -#: ../src/Doc/library/itertools.rst:85 +#: library/itertools.rst:85 msgid "Itertool functions" msgstr "" -#: ../src/Doc/library/itertools.rst:87 +#: library/itertools.rst:87 msgid "" "The following module functions all construct and return iterators. Some " "provide streams of infinite length, so they should only be accessed by " "functions or loops that truncate the stream." msgstr "" -#: ../src/Doc/library/itertools.rst:94 +#: library/itertools.rst:94 msgid "" "Make an iterator that returns elements from the first iterable until it is " "exhausted, then proceeds to the next iterable, until all of the iterables " @@ -53579,69 +54767,69 @@ msgid "" msgstr "" # cc28aa0b442f4569ab8180ef12579d02 -#: ../src/Doc/library/itertools.rst:108 +#: library/itertools.rst:108 msgid "" "Alternate constructor for :func:`chain`. Gets chained inputs from a single " "iterable argument that is evaluated lazily. Roughly equivalent to::" msgstr "" -#: ../src/Doc/library/itertools.rst:122 +#: library/itertools.rst:122 msgid "Return *r* length subsequences of elements from the input *iterable*." msgstr "" -#: ../src/Doc/library/itertools.rst:124 ../src/Doc/library/itertools.rst:175 +#: library/itertools.rst:124 library/itertools.rst:175 msgid "" "Combinations are emitted in lexicographic sort order. So, if the input " "*iterable* is sorted, the combination tuples will be produced in sorted " "order." msgstr "" -#: ../src/Doc/library/itertools.rst:128 +#: library/itertools.rst:128 msgid "" "Elements are treated as unique based on their position, not on their value. " "So if the input elements are unique, there will be no repeat values in each " "combination." msgstr "" -#: ../src/Doc/library/itertools.rst:154 +#: library/itertools.rst:154 msgid "" "The code for :func:`combinations` can be also expressed as a subsequence of :" "func:`permutations` after filtering entries where the elements are not in " "sorted order (according to their position in the input pool)::" msgstr "" -#: ../src/Doc/library/itertools.rst:165 +#: library/itertools.rst:165 msgid "" "The number of items returned is ``n! / r! / (n-r)!`` when ``0 <= r <= n`` or " "zero when ``r > n``." msgstr "" -#: ../src/Doc/library/itertools.rst:172 +#: library/itertools.rst:172 msgid "" "Return *r* length subsequences of elements from the input *iterable* " "allowing individual elements to be repeated more than once." msgstr "" -#: ../src/Doc/library/itertools.rst:179 +#: library/itertools.rst:179 msgid "" "Elements are treated as unique based on their position, not on their value. " "So if the input elements are unique, the generated combinations will also be " "unique." msgstr "" -#: ../src/Doc/library/itertools.rst:202 +#: library/itertools.rst:202 msgid "" "The code for :func:`combinations_with_replacement` can be also expressed as " "a subsequence of :func:`product` after filtering entries where the elements " "are not in sorted order (according to their position in the input pool)::" msgstr "" -#: ../src/Doc/library/itertools.rst:213 +#: library/itertools.rst:213 msgid "" "The number of items returned is ``(n+r-1)! / r! / (n-1)!`` when ``n > 0``." msgstr "" -#: ../src/Doc/library/itertools.rst:219 +#: library/itertools.rst:219 msgid "" "Make an iterator that filters elements from *data* returning only those that " "have a corresponding element in *selectors* that evaluates to ``True``. " @@ -53650,34 +54838,38 @@ msgid "" msgstr "" # 441238e55d654bed894d80620b4caa09 -#: ../src/Doc/library/itertools.rst:233 +#: library/itertools.rst:233 msgid "" "Make an iterator that returns evenly spaced values starting with *n*. Often " "used as an argument to :func:`imap` to generate consecutive data points. " "Also, used with :func:`izip` to add sequence numbers. Equivalent to::" msgstr "" -#: ../src/Doc/library/itertools.rst:245 +#: library/itertools.rst:245 msgid "" "When counting with floating point numbers, better accuracy can sometimes be " "achieved by substituting multiplicative code such as: ``(start + step * i " "for i in count())``." msgstr "" -#: ../src/Doc/library/itertools.rst:254 +#: library/itertools.rst:249 +msgid "added *step* argument and allowed non-integer arguments." +msgstr "" + +#: library/itertools.rst:254 msgid "" "Make an iterator returning elements from the iterable and saving a copy of " "each. When the iterable is exhausted, return elements from the saved copy. " "Repeats indefinitely. Equivalent to::" msgstr "" -#: ../src/Doc/library/itertools.rst:268 +#: library/itertools.rst:268 msgid "" "Note, this member of the toolkit may require significant auxiliary storage " "(depending on the length of the iterable)." msgstr "" -#: ../src/Doc/library/itertools.rst:274 +#: library/itertools.rst:274 msgid "" "Make an iterator that drops elements from the iterable as long as the " "predicate is true; afterwards, returns every element. Note, the iterator " @@ -53685,7 +54877,7 @@ msgid "" "may have a lengthy start-up time. Equivalent to::" msgstr "" -#: ../src/Doc/library/itertools.rst:292 +#: library/itertools.rst:292 msgid "" "Make an iterator that returns consecutive keys and groups from the " "*iterable*. The *key* is a function computing a key value for each element. " @@ -53694,7 +54886,7 @@ msgid "" "sorted on the same key function." msgstr "" -#: ../src/Doc/library/itertools.rst:298 +#: library/itertools.rst:298 msgid "" "The operation of :func:`groupby` is similar to the ``uniq`` filter in Unix. " "It generates a break or new group every time the value of the key function " @@ -53703,7 +54895,7 @@ msgid "" "aggregates common elements regardless of their input order." msgstr "" -#: ../src/Doc/library/itertools.rst:304 +#: library/itertools.rst:304 msgid "" "The returned group is itself an iterator that shares the underlying iterable " "with :func:`groupby`. Because the source is shared, when the :func:" @@ -53711,19 +54903,19 @@ msgid "" "if that data is needed later, it should be stored as a list::" msgstr "" -#: ../src/Doc/library/itertools.rst:316 +#: library/itertools.rst:316 msgid ":func:`groupby` is equivalent to::" msgstr "" # 928d879998dc4685aeb4cc2c4f39ea3b -#: ../src/Doc/library/itertools.rst:346 +#: library/itertools.rst:346 msgid "" "Make an iterator that filters elements from iterable returning only those " "for which the predicate is ``True``. If *predicate* is ``None``, return the " "items that are true. Equivalent to::" msgstr "" -#: ../src/Doc/library/itertools.rst:361 +#: library/itertools.rst:361 msgid "" "Make an iterator that filters elements from iterable returning only those " "for which the predicate is ``False``. If *predicate* is ``None``, return the " @@ -53731,7 +54923,7 @@ msgid "" msgstr "" # 0a91847faa3c4002ac70e848dec23991 -#: ../src/Doc/library/itertools.rst:376 +#: library/itertools.rst:376 msgid "" "Make an iterator that computes the function using arguments from each of the " "iterables. If *function* is set to ``None``, then :func:`imap` returns the " @@ -53743,7 +54935,7 @@ msgid "" "Equivalent to::" msgstr "" -#: ../src/Doc/library/itertools.rst:398 +#: library/itertools.rst:398 msgid "" "Make an iterator that returns selected elements from the iterable. If " "*start* is non-zero, then elements from the iterable are skipped until start " @@ -53757,22 +54949,32 @@ msgid "" "may list a name field on every third line). Equivalent to::" msgstr "" -#: ../src/Doc/library/itertools.rst:421 +#: library/itertools.rst:421 msgid "" "If *start* is ``None``, then iteration starts at zero. If *step* is " "``None``, then the step defaults to one." msgstr "" +#: library/itertools.rst:424 +msgid "accept ``None`` values for default *start* and *step*." +msgstr "" + # 23d2d6efed0b4106b29330bf48815163 -#: ../src/Doc/library/itertools.rst:430 +#: library/itertools.rst:430 msgid "" "Make an iterator that aggregates elements from each of the iterables. Like :" "func:`zip` except that it returns an iterator instead of a list. Used for " "lock-step iteration over several iterables at a time. Equivalent to::" msgstr "" +#: library/itertools.rst:440 +msgid "" +"When no iterables are specified, returns a zero length iterator instead of " +"raising a :exc:`TypeError` exception." +msgstr "" + # 657c3fe414c0410bac8603f90b38fa06 -#: ../src/Doc/library/itertools.rst:444 +#: library/itertools.rst:444 msgid "" "The left-to-right evaluation order of the iterables is guaranteed. This " "makes possible an idiom for clustering a data series into n-length groups " @@ -53780,14 +54982,14 @@ msgid "" msgstr "" # 1253b302a11547d692de070f33fd902a -#: ../src/Doc/library/itertools.rst:448 +#: library/itertools.rst:448 msgid "" ":func:`izip` should only be used with unequal length inputs when you don't " "care about trailing, unmatched values from the longer iterables. If those " "values are important, use :func:`izip_longest` instead." msgstr "" -#: ../src/Doc/library/itertools.rst:455 +#: library/itertools.rst:455 msgid "" "Make an iterator that aggregates elements from each of the iterables. If the " "iterables are of uneven length, missing values are filled-in with " @@ -53796,7 +54998,7 @@ msgid "" msgstr "" # a53d9082ddb44a32a0d26fb0978a0ea9 -#: ../src/Doc/library/itertools.rst:479 +#: library/itertools.rst:479 msgid "" "If one of the iterables is potentially infinite, then the :func:" "`izip_longest` function should be wrapped with something that limits the " @@ -53804,55 +55006,55 @@ msgid "" "specified, *fillvalue* defaults to ``None``." msgstr "" -#: ../src/Doc/library/itertools.rst:488 +#: library/itertools.rst:488 msgid "" "Return successive *r* length permutations of elements in the *iterable*." msgstr "" -#: ../src/Doc/library/itertools.rst:490 +#: library/itertools.rst:490 msgid "" "If *r* is not specified or is ``None``, then *r* defaults to the length of " "the *iterable* and all possible full-length permutations are generated." msgstr "" -#: ../src/Doc/library/itertools.rst:494 +#: library/itertools.rst:494 msgid "" "Permutations are emitted in lexicographic sort order. So, if the input " "*iterable* is sorted, the permutation tuples will be produced in sorted " "order." msgstr "" -#: ../src/Doc/library/itertools.rst:498 +#: library/itertools.rst:498 msgid "" "Elements are treated as unique based on their position, not on their value. " "So if the input elements are unique, there will be no repeat values in each " "permutation." msgstr "" -#: ../src/Doc/library/itertools.rst:529 +#: library/itertools.rst:529 msgid "" "The code for :func:`permutations` can be also expressed as a subsequence of :" "func:`product`, filtered to exclude entries with repeated elements (those " "from the same position in the input pool)::" msgstr "" -#: ../src/Doc/library/itertools.rst:541 +#: library/itertools.rst:541 msgid "" "The number of items returned is ``n! / (n-r)!`` when ``0 <= r <= n`` or zero " "when ``r > n``." msgstr "" -#: ../src/Doc/library/itertools.rst:548 +#: library/itertools.rst:548 msgid "Cartesian product of input iterables." msgstr "" -#: ../src/Doc/library/itertools.rst:550 +#: library/itertools.rst:550 msgid "" "Equivalent to nested for-loops in a generator expression. For example, " "``product(A, B)`` returns the same as ``((x,y) for x in A for y in B)``." msgstr "" -#: ../src/Doc/library/itertools.rst:553 +#: library/itertools.rst:553 msgid "" "The nested loops cycle like an odometer with the rightmost element advancing " "on every iteration. This pattern creates a lexicographic ordering so that " @@ -53860,21 +55062,21 @@ msgid "" "sorted order." msgstr "" -#: ../src/Doc/library/itertools.rst:558 +#: library/itertools.rst:558 msgid "" "To compute the product of an iterable with itself, specify the number of " "repetitions with the optional *repeat* keyword argument. For example, " "``product(A, repeat=4)`` means the same as ``product(A, A, A, A)``." msgstr "" -#: ../src/Doc/library/itertools.rst:562 +#: library/itertools.rst:562 msgid "" "This function is equivalent to the following code, except that the actual " "implementation does not build up intermediate results in memory::" msgstr "" # 701b2a6eb9bb46c8b68c50c668b624e7 -#: ../src/Doc/library/itertools.rst:579 +#: library/itertools.rst:579 msgid "" "Make an iterator that returns *object* over and over again. Runs " "indefinitely unless the *times* argument is specified. Used as argument to :" @@ -53883,14 +55085,14 @@ msgid "" msgstr "" # 238074f9e0b948b9a9ac0aafbecef4d0 -#: ../src/Doc/library/itertools.rst:593 +#: library/itertools.rst:593 msgid "" "A common use for *repeat* is to supply a stream of constant values to *imap* " "or *zip*::" msgstr "" # 66d705843fa84c42be162c761513f215 -#: ../src/Doc/library/itertools.rst:601 +#: library/itertools.rst:601 msgid "" "Make an iterator that computes the function using arguments obtained from " "the iterable. Used instead of :func:`imap` when argument parameters are " @@ -53900,25 +55102,31 @@ msgid "" "Equivalent to::" msgstr "" -#: ../src/Doc/library/itertools.rst:618 +#: library/itertools.rst:612 +msgid "" +"Previously, :func:`starmap` required the function arguments to be tuples. " +"Now, any iterable is allowed." +msgstr "" + +#: library/itertools.rst:618 msgid "" "Make an iterator that returns elements from the iterable as long as the " "predicate is true. Equivalent to::" msgstr "" -#: ../src/Doc/library/itertools.rst:632 +#: library/itertools.rst:632 msgid "" "Return *n* independent iterators from a single iterable. Equivalent to::" msgstr "" -#: ../src/Doc/library/itertools.rst:646 +#: library/itertools.rst:646 msgid "" "Once :func:`tee` has made a split, the original *iterable* should not be " "used anywhere else; otherwise, the *iterable* could get advanced without the " "tee objects being informed." msgstr "" -#: ../src/Doc/library/itertools.rst:650 +#: library/itertools.rst:650 msgid "" "This itertool may require significant auxiliary storage (depending on how " "much temporary data needs to be stored). In general, if one iterator uses " @@ -53926,13 +55134,13 @@ msgid "" "func:`list` instead of :func:`tee`." msgstr "" -#: ../src/Doc/library/itertools.rst:663 +#: library/itertools.rst:663 msgid "" "This section shows recipes for creating an extended toolset using the " "existing itertools as building blocks." msgstr "" -#: ../src/Doc/library/itertools.rst:666 +#: library/itertools.rst:666 msgid "" "The extended tools offer the same high performance as the underlying " "toolset. The superior memory performance is kept by processing elements one " @@ -53943,7 +55151,7 @@ msgid "" "term:`generator`\\s which incur interpreter overhead." msgstr "" -#: ../src/Doc/library/itertools.rst:843 +#: library/itertools.rst:843 msgid "" "Note, many of the above recipes can be optimized by replacing global lookups " "with local variables defined as default values. For example, the " @@ -53951,12 +55159,16 @@ msgid "" msgstr "" # 4aae0bb7fb754c4788cdf77a3a012cdf -#: ../src/Doc/library/jpeg.rst:3 +#: library/jpeg.rst:3 msgid ":mod:`jpeg` --- Read and write JPEG files" msgstr "" +#: library/jpeg.rst:10 +msgid "The :mod:`jpeg` module has been removed in Python 3." +msgstr "" + # e5f08bfb02bb436c8278bc07aa544407 -#: ../src/Doc/library/jpeg.rst:17 +#: library/jpeg.rst:17 msgid "" "The module :mod:`jpeg` provides access to the jpeg compressor and " "decompressor written by the Independent JPEG Group (IJG). JPEG is a standard " @@ -53966,7 +55178,7 @@ msgid "" msgstr "" # 394dfd29beaf4f64a4f9b840684e9fc0 -#: ../src/Doc/library/jpeg.rst:28 +#: library/jpeg.rst:28 msgid "" "A portable interface to JPEG image files is available with the Python " "Imaging Library (PIL) by Fredrik Lundh. Information on PIL is available at " @@ -53974,19 +55186,19 @@ msgid "" msgstr "" # 2bc61a8decae4af98f5722d5ae789ad0 -#: ../src/Doc/library/jpeg.rst:32 +#: library/jpeg.rst:32 msgid "The :mod:`jpeg` module defines an exception and some functions." msgstr "" # 15a1a9b621c04c0dbab1e6436c245364 -#: ../src/Doc/library/jpeg.rst:37 +#: library/jpeg.rst:37 msgid "" "Exception raised by :func:`compress` and :func:`decompress` in case of " "errors." msgstr "" # 8ce935c4f3ac485f929dd6ffe8586ab3 -#: ../src/Doc/library/jpeg.rst:44 +#: library/jpeg.rst:44 msgid "" "Treat data as a pixmap of width *w* and height *h*, with *b* bytes per " "pixel. The data is in SGI GL order, so the first pixel is in the lower-left " @@ -53998,7 +55210,7 @@ msgid "" msgstr "" # b9df8667e8fb47d99c71df49b8828a97 -#: ../src/Doc/library/jpeg.rst:56 +#: library/jpeg.rst:56 msgid "" "Data is a string containing a picture in JFIF format. It returns a tuple " "``(data, width, height, bytesperpixel)``. Again, the data is suitable to " @@ -54006,145 +55218,143 @@ msgid "" msgstr "" # ca10b79411484744a6b58ccf9dc30aef -#: ../src/Doc/library/jpeg.rst:63 +#: library/jpeg.rst:63 msgid "" "Set various options. Subsequent :func:`compress` and :func:`decompress` " "calls will use these options. The following options are available:" msgstr "" -#: ../src/Doc/library/jpeg.rst:67 ../src/Doc/library/string.rst:342 -#: ../src/Doc/library/string.rst:367 ../src/Doc/library/ttk.rst:107 +#: library/jpeg.rst:67 library/string.rst:342 library/string.rst:367 +#: library/ttk.rst:107 msgid "Option" msgstr "" # eb160687d0ef4506a9c31effb1d2efa0 -#: ../src/Doc/library/jpeg.rst:67 +#: library/jpeg.rst:67 msgid "Effect" msgstr "" # cd2344d30211428da7d83f4cdceb64e8 -#: ../src/Doc/library/jpeg.rst:69 +#: library/jpeg.rst:69 msgid "``'forcegray'``" msgstr "" # 3de4100f3dfd45b5a8743aca009d005b -#: ../src/Doc/library/jpeg.rst:69 +#: library/jpeg.rst:69 msgid "Force output to be grayscale, even if input is RGB." msgstr "" # 7b9f9c2303f94cdcbb3d2d44a66bd7bd -#: ../src/Doc/library/jpeg.rst:72 +#: library/jpeg.rst:72 msgid "``'quality'``" msgstr "" # 971476e33d6d49cca64928cbde42adc0 -#: ../src/Doc/library/jpeg.rst:72 +#: library/jpeg.rst:72 msgid "" "Set the quality of the compressed image to a value between ``0`` and ``100`` " "(default is ``75``). This only affects compression." msgstr "" # d411859f86384b389943d3028dfc9910 -#: ../src/Doc/library/jpeg.rst:76 +#: library/jpeg.rst:76 msgid "``'optimize'``" msgstr "" # 284f8c5f9ca04b9b9730a5432e1373d5 -#: ../src/Doc/library/jpeg.rst:76 +#: library/jpeg.rst:76 msgid "" "Perform Huffman table optimization. Takes longer, but results in smaller " "compressed image. This only affects compression." msgstr "" # d0fbdcf7b70e4ccebc254cbabda0737b -#: ../src/Doc/library/jpeg.rst:80 +#: library/jpeg.rst:80 msgid "``'smooth'``" msgstr "" # 6856d8040119478697f043cd48766430 -#: ../src/Doc/library/jpeg.rst:80 +#: library/jpeg.rst:80 msgid "" "Perform inter-block smoothing on uncompressed image. Only useful for low- " "quality images. This only affects decompression." msgstr "" # c3461e0e7723425e9508d304822eac6c -#: ../src/Doc/library/jpeg.rst:89 +#: library/jpeg.rst:90 msgid "JPEG Still Image Data Compression Standard" msgstr "" # 36834c16b81f4ab39825f9bdb28bf916 -#: ../src/Doc/library/jpeg.rst:90 +#: library/jpeg.rst:90 msgid "" "The canonical reference for the JPEG image format, by Pennebaker and " "Mitchell." msgstr "" -# 60f7b1e7d05a4a31abc5b4833b5eb99c -#: ../src/Doc/library/jpeg.rst:92 +#: library/jpeg.rst:93 msgid "" -"`Information Technology - Digital Compression and Coding of Continuous-tone " -"Still Images - Requirements and Guidelines `_" +"Information Technology - Digital Compression and Coding of Continuous-tone " +"Still Images - Requirements and Guidelines" msgstr "" # bdef84265f764a26aa86bf7a63d77b6e -#: ../src/Doc/library/jpeg.rst:93 +#: library/jpeg.rst:93 msgid "" "The ISO standard for JPEG is also published as ITU T.81. This is available " "online in PDF form." msgstr "" -#: ../src/Doc/library/json.rst:2 +#: library/json.rst:2 msgid ":mod:`json` --- JSON encoder and decoder" msgstr "" -# 3743327a3dfd492aaf7f3a4ca1e743ea -#: ../src/Doc/library/json.rst:10 +#: library/json.rst:10 msgid "" "`JSON (JavaScript Object Notation) `_, specified by :rfc:" -"`4627`, is a lightweight data interchange format based on a subset of " -"`JavaScript `_ syntax (`ECMA-262 " -"3rd edition `_)." +"`7159` (which obsoletes :rfc:`4627`) and by `ECMA-404 `_, is a lightweight " +"data interchange format inspired by `JavaScript `_ object literal syntax (although it is not a strict subset " +"of JavaScript [#rfc-errata]_ )." msgstr "" -#: ../src/Doc/library/json.rst:15 +#: library/json.rst:17 msgid "" ":mod:`json` exposes an API familiar to users of the standard library :mod:" "`marshal` and :mod:`pickle` modules." msgstr "" -#: ../src/Doc/library/json.rst:18 +#: library/json.rst:20 msgid "Encoding basic Python object hierarchies::" msgstr "" -#: ../src/Doc/library/json.rst:37 +#: library/json.rst:39 msgid "Compact encoding::" msgstr "" -#: ../src/Doc/library/json.rst:43 +#: library/json.rst:45 msgid "Pretty printing::" msgstr "" -#: ../src/Doc/library/json.rst:53 +#: library/json.rst:55 msgid "Decoding JSON::" msgstr "" -#: ../src/Doc/library/json.rst:65 +#: library/json.rst:67 msgid "Specializing JSON object decoding::" msgstr "" -#: ../src/Doc/library/json.rst:80 +#: library/json.rst:82 msgid "Extending :class:`JSONEncoder`::" msgstr "" -#: ../src/Doc/library/json.rst:100 +#: library/json.rst:102 msgid "Using json.tool from the shell to validate and pretty-print::" msgstr "" # 94bdd1e3b91c406096b9fa9f65089e8c -#: ../src/Doc/library/json.rst:113 +#: library/json.rst:115 msgid "" "JSON is a subset of `YAML `_ 1.2. The JSON produced by " "this module's default settings (in particular, the default *separators* " @@ -54152,12 +55362,12 @@ msgid "" "used as a YAML serializer." msgstr "" -#: ../src/Doc/library/json.rst:120 +#: library/json.rst:122 msgid "Basic Usage" msgstr "" # 93e2b7caaf99456c99da8c7d6a5e1abe -#: ../src/Doc/library/json.rst:127 +#: library/json.rst:129 msgid "" "Serialize *obj* as a JSON formatted stream to *fp* (a ``.write()``-" "supporting :term:`file-like object`) using this :ref:`conversion table `. If *ensure_ascii* is ``False``, the result may " @@ -54271,12 +55481,12 @@ msgid "" msgstr "" # fca782d5d0a044e7a299219cfe70954c -#: ../src/Doc/library/json.rst:197 +#: library/json.rst:199 msgid "The arguments have the same meaning as in :func:`dump`." msgstr "" # 0a8c3fe301334db9855147fe07b11f8f -#: ../src/Doc/library/json.rst:201 +#: library/json.rst:203 msgid "" "Keys in key/value pairs of JSON are always of the type :class:`str`. When a " "dictionary is converted into JSON, all the keys of the dictionary are " @@ -54286,7 +55496,7 @@ msgid "" msgstr "" # 72066afec2fe42f89105b3276b151ca3 -#: ../src/Doc/library/json.rst:210 +#: library/json.rst:212 msgid "" "Deserialize *fp* (a ``.read()``-supporting :term:`file-like object` " "containing a JSON document) to a Python object using this :ref:`conversion " @@ -54294,7 +55504,7 @@ msgid "" msgstr "" # a555a4824050420d88c38d29c0988f32 -#: ../src/Doc/library/json.rst:214 +#: library/json.rst:216 msgid "" "If the contents of *fp* are encoded with an ASCII based encoding other than " "UTF-8 (e.g. latin-1), then an appropriate *encoding* name must be specified. " @@ -54304,7 +55514,7 @@ msgid "" msgstr "" # 6078203433d24481a590039dedd4e51c -#: ../src/Doc/library/json.rst:220 +#: library/json.rst:222 msgid "" "*object_hook* is an optional function that will be called with the result of " "any object literal decoded (a :class:`dict`). The return value of " @@ -54313,7 +55523,7 @@ msgid "" "org>`_ class hinting)." msgstr "" -#: ../src/Doc/library/json.rst:226 +#: library/json.rst:228 msgid "" "*object_pairs_hook* is an optional function that will be called with the " "result of any object literal decoded with an ordered list of pairs. The " @@ -54324,7 +55534,11 @@ msgid "" "*object_hook* is also defined, the *object_pairs_hook* takes priority." msgstr "" -#: ../src/Doc/library/json.rst:237 ../src/Doc/library/json.rst:331 +#: library/json.rst:236 library/json.rst:330 +msgid "Added support for *object_pairs_hook*." +msgstr "" + +#: library/json.rst:239 library/json.rst:333 msgid "" "*parse_float*, if specified, will be called with the string of every JSON " "float to be decoded. By default, this is equivalent to ``float(num_str)``. " @@ -54332,7 +55546,7 @@ msgid "" "class:`decimal.Decimal`)." msgstr "" -#: ../src/Doc/library/json.rst:242 ../src/Doc/library/json.rst:336 +#: library/json.rst:244 library/json.rst:338 msgid "" "*parse_int*, if specified, will be called with the string of every JSON int " "to be decoded. By default, this is equivalent to ``int(num_str)``. This " @@ -54341,15 +55555,19 @@ msgid "" msgstr "" # 4311ae4120ca4064afd7562fcf145bef -#: ../src/Doc/library/json.rst:247 +#: library/json.rst:249 msgid "" "*parse_constant*, if specified, will be called with one of the following " "strings: ``'-Infinity'``, ``'Infinity'``, ``'NaN'``. This can be used to " "raise an exception if invalid JSON numbers are encountered." msgstr "" +#: library/json.rst:254 +msgid "*parse_constant* doesn't get called on 'null', 'true', 'false' anymore." +msgstr "" + # b3b02b9c42fa44e3bfc7541734648d56 -#: ../src/Doc/library/json.rst:255 +#: library/json.rst:257 msgid "" "To use a custom :class:`JSONDecoder` subclass, specify it with the ``cls`` " "kwarg; otherwise :class:`JSONDecoder` is used. Additional keyword arguments " @@ -54357,7 +55575,7 @@ msgid "" msgstr "" # fb39a73e1fe84d9796c3a799a911826c -#: ../src/Doc/library/json.rst:262 +#: library/json.rst:264 msgid "" "Deserialize *s* (a :class:`str` or :class:`unicode` instance containing a " "JSON document) to a Python object using this :ref:`conversion table `_. This section " +"details this module's level of compliance with the RFC. For simplicity, :" +"class:`JSONEncoder` and :class:`JSONDecoder` subclasses, and parameters " +"other than those explicitly mentioned, are not considered." msgstr "" # b99726a8847546f2a0648aa1f93abcc0 -#: ../src/Doc/library/json.rst:496 +#: library/json.rst:499 msgid "" "This module does not comply with the RFC in a strict fashion, implementing " "some extensions that are valid JavaScript but not valid JSON. In particular:" msgstr "" -# e99eaafe98e346ecb6e0d748c94899c8 -#: ../src/Doc/library/json.rst:499 -msgid "Top-level non-object, non-array values are accepted and output;" -msgstr "" - # 416dacf47a3c43a6944aa05695fbaed2 -#: ../src/Doc/library/json.rst:500 +#: library/json.rst:502 msgid "Infinite and NaN number values are accepted and output;" msgstr "" # d97bc8cd0dcd4406883c440e8bfc286b -#: ../src/Doc/library/json.rst:501 +#: library/json.rst:503 msgid "" "Repeated names within an object are accepted, and only the value of the last " "name-value pair is used." msgstr "" # 2d58a585afa64264be9e13846f2c9409 -#: ../src/Doc/library/json.rst:504 +#: library/json.rst:506 msgid "" "Since the RFC permits RFC-compliant parsers to accept input texts that are " "not RFC-compliant, this module's deserializer is technically RFC-compliant " @@ -54712,20 +55922,20 @@ msgid "" msgstr "" # 1e4d783fb63649ab90203f53aafdf98c -#: ../src/Doc/library/json.rst:509 +#: library/json.rst:511 msgid "Character Encodings" msgstr "" -# 2b375bec623c4996ac63510f0cc8c117 -#: ../src/Doc/library/json.rst:511 +#: library/json.rst:513 msgid "" -"The RFC recommends that JSON be represented using either UTF-8, UTF-16, or " -"UTF-32, with UTF-8 being the default. Accordingly, this module uses UTF-8 " -"as the default for its *encoding* parameter." +"The RFC requires that JSON be represented using either UTF-8, UTF-16, or " +"UTF-32, with UTF-8 being the recommended default for maximum " +"interoperability. Accordingly, this module uses UTF-8 as the default for its " +"*encoding* parameter." msgstr "" # f2fc829165ce4e11a93172c7faa31a80 -#: ../src/Doc/library/json.rst:515 +#: library/json.rst:517 msgid "" "This module's deserializer only directly works with ASCII-compatible " "encodings; UTF-16, UTF-32, and other ASCII-incompatible encodings require " @@ -54733,60 +55943,39 @@ msgid "" "*encoding* parameter." msgstr "" -# 17eaa52e4b0f42f4a2c5981c251f4bb1 -#: ../src/Doc/library/json.rst:520 -msgid "" -"The RFC also non-normatively describes a limited encoding detection " -"technique for JSON texts; this module's deserializer does not implement this " -"or any other kind of encoding detection." -msgstr "" - # ae07f2a451eb46d082f772df8812a069 -#: ../src/Doc/library/json.rst:524 +#: library/json.rst:522 msgid "" "As permitted, though not required, by the RFC, this module's serializer sets " "*ensure_ascii=True* by default, thus escaping the output so that the " "resulting strings only contain ASCII characters." msgstr "" -# 55d8685bc28149548f451b8065d8698f -#: ../src/Doc/library/json.rst:530 -msgid "Top-level Non-Object, Non-Array Values" +#: library/json.rst:526 +msgid "" +"The RFC prohibits adding a byte order mark (BOM) to the start of a JSON " +"text, and this module's serializer does not add a BOM to its output. The RFC " +"permits, but does not require, JSON deserializers to ignore an initial BOM " +"in their input. This module's deserializer raises a :exc:`ValueError` when " +"an initial BOM is present." msgstr "" -# e6690bd926e84be2b80b7c336ffc3075 -#: ../src/Doc/library/json.rst:532 +#: library/json.rst:532 msgid "" -"The RFC specifies that the top-level value of a JSON text must be either a " -"JSON object or array (Python :class:`dict` or :class:`list`). This module's " -"deserializer also accepts input texts consisting solely of a JSON null, " -"boolean, number, or string value::" -msgstr "" - -# f6c6069af3684006ab253b705a249b35 -#: ../src/Doc/library/json.rst:541 -msgid "" -"This module itself does not include a way to request that such input texts " -"be regarded as illegal. Likewise, this module's serializer also accepts " -"single Python :data:`None`, :class:`bool`, numeric, and :class:`str` values " -"as input and will generate output texts consisting solely of a top-level " -"JSON null, boolean, number, or string value without raising an exception::" -msgstr "" - -# f3ea4ac58f4d43a2bc8547f7c995ecc8 -#: ../src/Doc/library/json.rst:551 -msgid "" -"This module's serializer does not itself include a way to enforce the " -"aforementioned constraint." +"The RFC does not explicitly forbid JSON strings which contain byte sequences " +"that don't correspond to valid Unicode characters (e.g. unpaired UTF-16 " +"surrogates), but it does note that they may cause interoperability problems. " +"By default, this module accepts and outputs (when present in the original :" +"class:`str`) code points for such sequences." msgstr "" # bfe1963a89014c4197fa91bff02534db -#: ../src/Doc/library/json.rst:556 +#: library/json.rst:540 msgid "Infinite and NaN Number Values" msgstr "" # c4a33425c8c74be7902f37212b5a173d -#: ../src/Doc/library/json.rst:558 +#: library/json.rst:542 msgid "" "The RFC does not permit the representation of infinite or NaN number values. " "Despite that, by default, this module accepts and outputs ``Infinity``, ``-" @@ -54794,7 +55983,7 @@ msgid "" msgstr "" # 30bac84245c24c899b55667d7803ed2a -#: ../src/Doc/library/json.rst:573 +#: library/json.rst:557 msgid "" "In the serializer, the *allow_nan* parameter can be used to alter this " "behavior. In the deserializer, the *parse_constant* parameter can be used " @@ -54802,74 +55991,143 @@ msgid "" msgstr "" # 106dbd264cf948ad8dd57248d85a32fc -#: ../src/Doc/library/json.rst:579 +#: library/json.rst:563 msgid "Repeated Names Within an Object" msgstr "" -# b636632fb4484a0b9f07ef0e525009e4 -#: ../src/Doc/library/json.rst:581 +#: library/json.rst:565 msgid "" "The RFC specifies that the names within a JSON object should be unique, but " -"does not specify how repeated names in JSON objects should be handled. By " +"does not mandate how repeated names in JSON objects should be handled. By " "default, this module does not raise an exception; instead, it ignores all " "but the last name-value pair for a given name::" msgstr "" # 11d29a824e7a456fb4078fb2044070cf -#: ../src/Doc/library/json.rst:590 +#: library/json.rst:574 msgid "The *object_pairs_hook* parameter can be used to alter this behavior." msgstr "" -#: ../src/Doc/library/keyword.rst:2 +# 55d8685bc28149548f451b8065d8698f +#: library/json.rst:578 +msgid "Top-level Non-Object, Non-Array Values" +msgstr "" + +#: library/json.rst:580 +msgid "" +"The old version of JSON specified by the obsolete :rfc:`4627` required that " +"the top-level value of a JSON text must be either a JSON object or array " +"(Python :class:`dict` or :class:`list`), and could not be a JSON null, " +"boolean, number, or string value. :rfc:`7159` removed that restriction, and " +"this module does not and has never implemented that restriction in either " +"its serializer or its deserializer." +msgstr "" + +#: library/json.rst:587 +msgid "" +"Regardless, for maximum interoperability, you may wish to voluntarily adhere " +"to the restriction yourself." +msgstr "" + +#: library/json.rst:592 +msgid "Implementation Limitations" +msgstr "" + +#: library/json.rst:594 +msgid "Some JSON deserializer implementations may set limits on:" +msgstr "" + +#: library/json.rst:596 +msgid "the size of accepted JSON texts" +msgstr "" + +#: library/json.rst:597 +msgid "the maximum level of nesting of JSON objects and arrays" +msgstr "" + +#: library/json.rst:598 +msgid "the range and precision of JSON numbers" +msgstr "" + +#: library/json.rst:599 +msgid "the content and maximum length of JSON strings" +msgstr "" + +#: library/json.rst:601 +msgid "" +"This module does not impose any such limits beyond those of the relevant " +"Python datatypes themselves or the Python interpreter itself." +msgstr "" + +#: library/json.rst:604 +msgid "" +"When serializing to JSON, beware any such limitations in applications that " +"may consume your JSON. In particular, it is common for JSON numbers to be " +"deserialized into IEEE 754 double precision numbers and thus subject to that " +"representation's range and precision limitations. This is especially " +"relevant when serializing Python :class:`int` values of extremely large " +"magnitude, or when serializing instances of \"exotic\" numerical types such " +"as :class:`decimal.Decimal`." +msgstr "" + +#: library/json.rst:615 +msgid "" +"As noted in `the errata for RFC 7159 `_, JSON permits literal U+2028 (LINE SEPARATOR) " +"and U+2029 (PARAGRAPH SEPARATOR) characters in strings, whereas JavaScript " +"(as of ECMAScript Edition 5.1) does not." +msgstr "" + +#: library/keyword.rst:2 msgid ":mod:`keyword` --- Testing for Python keywords" msgstr "" # 344b3c33a6b0495ba6783f930c066e57 -#: ../src/Doc/library/keyword.rst:7 +#: library/keyword.rst:7 msgid "**Source code:** :source:`Lib/keyword.py`" msgstr "" -#: ../src/Doc/library/keyword.rst:11 +#: library/keyword.rst:11 msgid "" "This module allows a Python program to determine if a string is a keyword." msgstr "" -#: ../src/Doc/library/keyword.rst:16 +#: library/keyword.rst:16 msgid "Return true if *s* is a Python keyword." msgstr "" -#: ../src/Doc/library/keyword.rst:21 +#: library/keyword.rst:21 msgid "" "Sequence containing all the keywords defined for the interpreter. If any " "keywords are defined to only be active when particular :mod:`__future__` " "statements are in effect, these will be included as well." msgstr "" -#: ../src/Doc/library/language.rst:6 +#: library/language.rst:6 msgid "Python Language Services" msgstr "" -#: ../src/Doc/library/language.rst:8 +#: library/language.rst:8 msgid "" "Python provides a number of modules to assist in working with the Python " "language. These modules support tokenizing, parsing, syntax analysis, " "bytecode disassembly, and various other facilities." msgstr "" -#: ../src/Doc/library/language.rst:12 +#: library/language.rst:12 msgid "These modules include:" msgstr "" -#: ../src/Doc/library/linecache.rst:3 +#: library/linecache.rst:3 msgid ":mod:`linecache` --- Random access to text lines" msgstr "" # c36a6235e49c4c21b41c30ca57a441b4 -#: ../src/Doc/library/linecache.rst:9 +#: library/linecache.rst:9 msgid "**Source code:** :source:`Lib/linecache.py`" msgstr "" -#: ../src/Doc/library/linecache.rst:13 +#: library/linecache.rst:13 msgid "" "The :mod:`linecache` module allows one to get any line from any file, while " "attempting to optimize internally, using a cache, the common case where many " @@ -54877,19 +56135,19 @@ msgid "" "module to retrieve source lines for inclusion in the formatted traceback." msgstr "" -#: ../src/Doc/library/linecache.rst:18 +#: library/linecache.rst:18 msgid "The :mod:`linecache` module defines the following functions:" msgstr "" # ddfd1bdd85564634a90c2a8386153547 -#: ../src/Doc/library/linecache.rst:23 +#: library/linecache.rst:23 msgid "" "Get line *lineno* from file named *filename*. This function will never raise " "an exception --- it will return ``''`` on errors (the terminating newline " "character will be included for lines that are found)." msgstr "" -#: ../src/Doc/library/linecache.rst:29 +#: library/linecache.rst:29 msgid "" "If a file named *filename* is not found, the function will look for it in " "the module search path, ``sys.path``, after first checking for a :pep:`302` " @@ -54897,24 +56155,28 @@ msgid "" "zipfile or other non-filesystem import source." msgstr "" -#: ../src/Doc/library/linecache.rst:40 +#: library/linecache.rst:34 +msgid "The *module_globals* parameter was added." +msgstr "" + +#: library/linecache.rst:40 msgid "" "Clear the cache. Use this function if you no longer need lines from files " "previously read using :func:`getline`." msgstr "" -#: ../src/Doc/library/linecache.rst:46 +#: library/linecache.rst:46 msgid "" "Check the cache for validity. Use this function if files in the cache may " "have changed on disk, and you require the updated version. If *filename* is " "omitted, it will check all the entries in the cache." msgstr "" -#: ../src/Doc/library/locale.rst:3 +#: library/locale.rst:3 msgid ":mod:`locale` --- Internationalization services" msgstr "" -#: ../src/Doc/library/locale.rst:11 +#: library/locale.rst:11 msgid "" "The :mod:`locale` module opens access to the POSIX locale database and " "functionality. The POSIX locale mechanism allows programmers to deal with " @@ -54922,25 +56184,25 @@ msgid "" "to know all the specifics of each country where the software is executed." msgstr "" -#: ../src/Doc/library/locale.rst:18 +#: library/locale.rst:18 msgid "" "The :mod:`locale` module is implemented on top of the :mod:`_locale` module, " "which in turn uses an ANSI C locale implementation if available." msgstr "" -#: ../src/Doc/library/locale.rst:21 +#: library/locale.rst:21 msgid "The :mod:`locale` module defines the following exception and functions:" msgstr "" # ca0e3ea3ade445d0a9b6d18e323523bc -#: ../src/Doc/library/locale.rst:26 +#: library/locale.rst:26 msgid "" "Exception raised when the locale passed to :func:`setlocale` is not " "recognized." msgstr "" # 9e1e4c12ae834ac8970305b03ec9c591 -#: ../src/Doc/library/locale.rst:32 +#: library/locale.rst:32 msgid "" "If *locale* is given and not ``None``, :func:`setlocale` modifies the locale " "setting for the *category*. The available categories are listed in the data " @@ -54952,20 +56214,20 @@ msgid "" "returned." msgstr "" -#: ../src/Doc/library/locale.rst:40 +#: library/locale.rst:40 msgid "" "If *locale* is omitted or ``None``, the current setting for *category* is " "returned." msgstr "" # 949588d81ff642d6ba521e27aa3407c4 -#: ../src/Doc/library/locale.rst:43 +#: library/locale.rst:43 msgid "" ":func:`setlocale` is not thread-safe on most systems. Applications typically " "start with a call of ::" msgstr "" -#: ../src/Doc/library/locale.rst:49 +#: library/locale.rst:49 msgid "" "This sets the locale for all categories to the user's default setting " "(typically specified in the :envvar:`LANG` environment variable). If the " @@ -54973,33 +56235,37 @@ msgid "" "problems." msgstr "" -#: ../src/Doc/library/locale.rst:59 +#: library/locale.rst:53 +msgid "Added support for iterable values of the *locale* parameter." +msgstr "" + +#: library/locale.rst:59 msgid "" "Returns the database of the local conventions as a dictionary. This " "dictionary has the following strings as keys:" msgstr "" -#: ../src/Doc/library/locale.rst:65 +#: library/locale.rst:65 msgid "Category" msgstr "" -#: ../src/Doc/library/locale.rst:67 +#: library/locale.rst:67 msgid ":const:`LC_NUMERIC`" msgstr "" -#: ../src/Doc/library/locale.rst:67 +#: library/locale.rst:67 msgid "``'decimal_point'``" msgstr "" -#: ../src/Doc/library/locale.rst:67 +#: library/locale.rst:67 msgid "Decimal point character." msgstr "" -#: ../src/Doc/library/locale.rst:69 +#: library/locale.rst:69 msgid "``'grouping'``" msgstr "" -#: ../src/Doc/library/locale.rst:69 +#: library/locale.rst:69 msgid "" "Sequence of numbers specifying which relative positions the " "``'thousands_sep'`` is expected. If the sequence is terminated with :const:" @@ -55007,180 +56273,177 @@ msgid "" "with a ``0``, the last group size is repeatedly used." msgstr "" -#: ../src/Doc/library/locale.rst:80 +#: library/locale.rst:80 msgid "``'thousands_sep'``" msgstr "" -#: ../src/Doc/library/locale.rst:80 +#: library/locale.rst:80 msgid "Character used between groups." msgstr "" -#: ../src/Doc/library/locale.rst:82 +#: library/locale.rst:82 msgid ":const:`LC_MONETARY`" msgstr "" -#: ../src/Doc/library/locale.rst:82 +#: library/locale.rst:82 msgid "``'int_curr_symbol'``" msgstr "" -#: ../src/Doc/library/locale.rst:82 +#: library/locale.rst:82 msgid "International currency symbol." msgstr "" -#: ../src/Doc/library/locale.rst:84 +#: library/locale.rst:84 msgid "``'currency_symbol'``" msgstr "" -#: ../src/Doc/library/locale.rst:84 +#: library/locale.rst:84 msgid "Local currency symbol." msgstr "" -#: ../src/Doc/library/locale.rst:86 +#: library/locale.rst:86 msgid "``'p_cs_precedes/n_cs_precedes'``" msgstr "" -#: ../src/Doc/library/locale.rst:86 +#: library/locale.rst:86 msgid "" "Whether the currency symbol precedes the value (for positive resp. negative " "values)." msgstr "" -#: ../src/Doc/library/locale.rst:91 +#: library/locale.rst:91 msgid "``'p_sep_by_space/n_sep_by_space'``" msgstr "" -#: ../src/Doc/library/locale.rst:91 +#: library/locale.rst:91 msgid "" "Whether the currency symbol is separated from the value by a space (for " "positive resp. negative values)." msgstr "" -#: ../src/Doc/library/locale.rst:96 +#: library/locale.rst:96 msgid "``'mon_decimal_point'``" msgstr "" -#: ../src/Doc/library/locale.rst:96 +#: library/locale.rst:96 msgid "Decimal point used for monetary values." msgstr "" -#: ../src/Doc/library/locale.rst:99 +#: library/locale.rst:99 msgid "``'frac_digits'``" msgstr "" -#: ../src/Doc/library/locale.rst:99 +#: library/locale.rst:99 msgid "" "Number of fractional digits used in local formatting of monetary values." msgstr "" -#: ../src/Doc/library/locale.rst:103 +#: library/locale.rst:103 msgid "``'int_frac_digits'``" msgstr "" -#: ../src/Doc/library/locale.rst:103 +#: library/locale.rst:103 msgid "" "Number of fractional digits used in international formatting of monetary " "values." msgstr "" -#: ../src/Doc/library/locale.rst:107 +#: library/locale.rst:107 msgid "``'mon_thousands_sep'``" msgstr "" -#: ../src/Doc/library/locale.rst:107 +#: library/locale.rst:107 msgid "Group separator used for monetary values." msgstr "" -#: ../src/Doc/library/locale.rst:110 +#: library/locale.rst:110 msgid "``'mon_grouping'``" msgstr "" -#: ../src/Doc/library/locale.rst:110 +#: library/locale.rst:110 msgid "Equivalent to ``'grouping'``, used for monetary values." msgstr "" -#: ../src/Doc/library/locale.rst:113 +#: library/locale.rst:113 msgid "``'positive_sign'``" msgstr "" -#: ../src/Doc/library/locale.rst:113 +#: library/locale.rst:113 msgid "Symbol used to annotate a positive monetary value." msgstr "" -#: ../src/Doc/library/locale.rst:116 +#: library/locale.rst:116 msgid "``'negative_sign'``" msgstr "" -#: ../src/Doc/library/locale.rst:116 +#: library/locale.rst:116 msgid "Symbol used to annotate a negative monetary value." msgstr "" -#: ../src/Doc/library/locale.rst:119 +#: library/locale.rst:119 msgid "``'p_sign_posn/n_sign_posn'``" msgstr "" -#: ../src/Doc/library/locale.rst:119 +#: library/locale.rst:119 msgid "" "The position of the sign (for positive resp. negative values), see below." msgstr "" -#: ../src/Doc/library/locale.rst:124 +#: library/locale.rst:124 msgid "" "All numeric values can be set to :const:`CHAR_MAX` to indicate that there is " "no value specified in this locale." msgstr "" -#: ../src/Doc/library/locale.rst:127 +#: library/locale.rst:127 msgid "" "The possible values for ``'p_sign_posn'`` and ``'n_sign_posn'`` are given " "below." msgstr "" -#: ../src/Doc/library/locale.rst:130 ../src/Doc/library/mailbox.rst:798 -#: ../src/Doc/library/mailbox.rst:965 ../src/Doc/library/mailbox.rst:1115 -#: ../src/Doc/library/mailbox.rst:1202 ../src/Doc/library/mailbox.rst:1335 -#: ../src/Doc/library/sys.rst:607 +#: library/locale.rst:130 library/mailbox.rst:798 library/mailbox.rst:965 +#: library/mailbox.rst:1115 library/mailbox.rst:1202 library/mailbox.rst:1335 +#: library/sys.rst:607 msgid "Explanation" msgstr "" -#: ../src/Doc/library/locale.rst:132 +#: library/locale.rst:132 msgid "Currency and value are surrounded by parentheses." msgstr "" -#: ../src/Doc/library/locale.rst:135 +#: library/locale.rst:135 msgid "The sign should precede the value and currency symbol." msgstr "" -#: ../src/Doc/library/locale.rst:138 +#: library/locale.rst:138 msgid "The sign should follow the value and currency symbol." msgstr "" -#: ../src/Doc/library/locale.rst:141 ../src/Doc/library/resource.rst:189 -#: ../src/Doc/library/zipfile.rst:412 +#: library/locale.rst:141 library/resource.rst:189 library/zipfile.rst:414 msgid "``3``" msgstr "" -#: ../src/Doc/library/locale.rst:141 +#: library/locale.rst:141 msgid "The sign should immediately precede the value." msgstr "" -#: ../src/Doc/library/locale.rst:144 ../src/Doc/library/resource.rst:191 -#: ../src/Doc/library/zipfile.rst:414 +#: library/locale.rst:144 library/resource.rst:191 library/zipfile.rst:416 msgid "``4``" msgstr "" -#: ../src/Doc/library/locale.rst:144 +#: library/locale.rst:144 msgid "The sign should immediately follow the value." msgstr "" -#: ../src/Doc/library/locale.rst:147 +#: library/locale.rst:147 msgid "``CHAR_MAX``" msgstr "" -#: ../src/Doc/library/locale.rst:147 +#: library/locale.rst:147 msgid "Nothing is specified in this locale." msgstr "" -#: ../src/Doc/library/locale.rst:153 +#: library/locale.rst:153 msgid "" "Return some locale-specific information as a string. This function is not " "available on all systems, and the set of possible options might also vary " @@ -55188,108 +56451,108 @@ msgid "" "symbolic constants are available in the locale module." msgstr "" -#: ../src/Doc/library/locale.rst:158 +#: library/locale.rst:158 msgid "" "The :func:`nl_langinfo` function accepts one of the following keys. Most " "descriptions are taken from the corresponding description in the GNU C " "library." msgstr "" -#: ../src/Doc/library/locale.rst:164 +#: library/locale.rst:164 msgid "" "Get a string with the name of the character encoding used in the selected " "locale." msgstr "" # 7de5fcebb2f84b99a602ca71937e6461 -#: ../src/Doc/library/locale.rst:169 +#: library/locale.rst:169 msgid "" "Get a string that can be used as a format string for :func:`time.strftime` " "to represent date and time in a locale-specific way." msgstr "" # d527646c1c394a48b93e4b2328a93667 -#: ../src/Doc/library/locale.rst:174 +#: library/locale.rst:174 msgid "" "Get a string that can be used as a format string for :func:`time.strftime` " "to represent a date in a locale-specific way." msgstr "" # 730156bf65ef466aad1b75922db117e6 -#: ../src/Doc/library/locale.rst:179 +#: library/locale.rst:179 msgid "" "Get a string that can be used as a format string for :func:`time.strftime` " "to represent a time in a locale-specific way." msgstr "" # 03f712263d0848d3a4a41ced566fec1c -#: ../src/Doc/library/locale.rst:184 +#: library/locale.rst:184 msgid "" "Get a format string for :func:`time.strftime` to represent time in the am/pm " "format." msgstr "" -#: ../src/Doc/library/locale.rst:189 +#: library/locale.rst:189 msgid "Get the name of the n-th day of the week." msgstr "" -#: ../src/Doc/library/locale.rst:193 +#: library/locale.rst:193 msgid "" "This follows the US convention of :const:`DAY_1` being Sunday, not the " "international convention (ISO 8601) that Monday is the first day of the week." msgstr "" -#: ../src/Doc/library/locale.rst:199 +#: library/locale.rst:199 msgid "Get the abbreviated name of the n-th day of the week." msgstr "" -#: ../src/Doc/library/locale.rst:203 +#: library/locale.rst:203 msgid "Get the name of the n-th month." msgstr "" -#: ../src/Doc/library/locale.rst:207 +#: library/locale.rst:207 msgid "Get the abbreviated name of the n-th month." msgstr "" -#: ../src/Doc/library/locale.rst:211 -msgid "Get the radix character (decimal dot, decimal comma, etc.)" +#: library/locale.rst:211 +msgid "Get the radix character (decimal dot, decimal comma, etc.)." msgstr "" -#: ../src/Doc/library/locale.rst:215 +#: library/locale.rst:215 msgid "Get the separator character for thousands (groups of three digits)." msgstr "" -#: ../src/Doc/library/locale.rst:219 +#: library/locale.rst:219 msgid "" "Get a regular expression that can be used with the regex function to " "recognize a positive response to a yes/no question." msgstr "" # bacf0720f7204d1d9f3b70b03c97b491 -#: ../src/Doc/library/locale.rst:224 +#: library/locale.rst:224 msgid "" "The expression is in the syntax suitable for the :c:func:`regex` function " "from the C library, which might differ from the syntax used in :mod:`re`." msgstr "" -#: ../src/Doc/library/locale.rst:229 +#: library/locale.rst:229 msgid "" "Get a regular expression that can be used with the regex(3) function to " "recognize a negative response to a yes/no question." msgstr "" -#: ../src/Doc/library/locale.rst:234 +#: library/locale.rst:234 msgid "" "Get the currency symbol, preceded by \"-\" if the symbol should appear " "before the value, \"+\" if the symbol should appear after the value, or \"." "\" if the symbol should replace the radix character." msgstr "" -#: ../src/Doc/library/locale.rst:240 +#: library/locale.rst:240 msgid "Get a string that represents the era used in the current locale." msgstr "" -#: ../src/Doc/library/locale.rst:242 +#: library/locale.rst:242 msgid "" "Most locales do not define this value. An example of a locale which does " "define this value is the Japanese one. In Japan, the traditional " @@ -55298,7 +56561,7 @@ msgid "" msgstr "" # a4cf43c34951469ca0a29c0412a0e141 -#: ../src/Doc/library/locale.rst:247 +#: library/locale.rst:247 msgid "" "Normally it should not be necessary to use this value directly. Specifying " "the ``E`` modifier in their format strings causes the :func:`time.strftime` " @@ -55308,39 +56571,39 @@ msgid "" msgstr "" # 26af6099d42144c7a6cf06f3ba4c4bde -#: ../src/Doc/library/locale.rst:255 +#: library/locale.rst:255 msgid "" "Get a format string for :func:`time.strftime` to represent date and time in " "a locale-specific era-based way." msgstr "" # 5fb39bb8658b4675b7611ffe4846afa6 -#: ../src/Doc/library/locale.rst:260 +#: library/locale.rst:260 msgid "" "Get a format string for :func:`time.strftime` to represent a date in a " "locale-specific era-based way." msgstr "" # 1c94e8bbd00d40a98e69e2ae89f0b704 -#: ../src/Doc/library/locale.rst:265 +#: library/locale.rst:265 msgid "" "Get a format string for :func:`time.strftime` to represent a time in a " "locale-specific era-based way." msgstr "" -#: ../src/Doc/library/locale.rst:270 +#: library/locale.rst:270 msgid "" "Get a representation of up to 100 values used to represent the values 0 to " "99." msgstr "" -#: ../src/Doc/library/locale.rst:276 +#: library/locale.rst:276 msgid "" "Tries to determine the default locale settings and returns them as a tuple " "of the form ``(language code, encoding)``." msgstr "" -#: ../src/Doc/library/locale.rst:279 +#: library/locale.rst:279 msgid "" "According to POSIX, a program which has not called ``setlocale(LC_ALL, '')`` " "runs using the portable ``'C'`` locale. Calling ``setlocale(LC_ALL, '')`` " @@ -55350,7 +56613,7 @@ msgid "" msgstr "" # b7d6eedd912f446c8cbe56d32d586746 -#: ../src/Doc/library/locale.rst:285 +#: library/locale.rst:285 msgid "" "To maintain compatibility with other platforms, not only the :envvar:`LANG` " "variable is tested, but a list of variables given as envvars parameter. The " @@ -55360,21 +56623,21 @@ msgid "" "``'LC_ALL'``, ``'LC_CTYPE'``, and ``'LANG'``, in that order." msgstr "" -#: ../src/Doc/library/locale.rst:292 ../src/Doc/library/locale.rst:305 +#: library/locale.rst:292 library/locale.rst:305 msgid "" "Except for the code ``'C'``, the language code corresponds to :rfc:`1766`. " "*language code* and *encoding* may be ``None`` if their values cannot be " "determined." msgstr "" -#: ../src/Doc/library/locale.rst:301 +#: library/locale.rst:301 msgid "" "Returns the current setting for the given locale category as sequence " "containing *language code*, *encoding*. *category* may be one of the :const:" "`LC_\\*` values except :const:`LC_ALL`. It defaults to :const:`LC_CTYPE`." msgstr "" -#: ../src/Doc/library/locale.rst:314 +#: library/locale.rst:314 msgid "" "Return the encoding used for text data, according to user preferences. User " "preferences are expressed differently on different systems, and might not be " @@ -55382,37 +56645,37 @@ msgid "" "guess." msgstr "" -#: ../src/Doc/library/locale.rst:319 +#: library/locale.rst:319 msgid "" "On some systems, it is necessary to invoke :func:`setlocale` to obtain the " "user preferences, so this function is not thread-safe. If invoking setlocale " "is not necessary or desired, *do_setlocale* should be set to ``False``." msgstr "" -#: ../src/Doc/library/locale.rst:328 +#: library/locale.rst:328 msgid "" "Returns a normalized locale code for the given locale name. The returned " "locale code is formatted for use with :func:`setlocale`. If normalization " "fails, the original name is returned unchanged." msgstr "" -#: ../src/Doc/library/locale.rst:332 +#: library/locale.rst:332 msgid "" "If the given encoding is not known, the function defaults to the default " "encoding for the locale code just like :func:`setlocale`." msgstr "" -#: ../src/Doc/library/locale.rst:340 +#: library/locale.rst:340 msgid "Sets the locale for *category* to the default setting." msgstr "" -#: ../src/Doc/library/locale.rst:342 +#: library/locale.rst:342 msgid "" "The default setting is determined by calling :func:`getdefaultlocale`. " "*category* defaults to :const:`LC_ALL`." msgstr "" -#: ../src/Doc/library/locale.rst:350 +#: library/locale.rst:350 msgid "" "Compares two strings according to the current :const:`LC_COLLATE` setting. " "As any other compare function, returns a negative, or a positive value, or " @@ -55421,7 +56684,7 @@ msgid "" msgstr "" # 4d19ecafe90e460daa2efc442e2692ad -#: ../src/Doc/library/locale.rst:360 +#: library/locale.rst:360 msgid "" "Transforms a string to one that can be used for the built-in function :func:" "`cmp`, and still returns locale-aware results. This function can be used " @@ -55429,7 +56692,7 @@ msgid "" "of strings." msgstr "" -#: ../src/Doc/library/locale.rst:368 +#: library/locale.rst:368 msgid "" "Formats a number *val* according to the current :const:`LC_NUMERIC` setting. " "The format follows the conventions of the ``%`` operator. For floating " @@ -55437,31 +56700,35 @@ msgid "" "is true, also takes the grouping into account." msgstr "" -#: ../src/Doc/library/locale.rst:373 +#: library/locale.rst:373 msgid "" "If *monetary* is true, the conversion uses monetary thousands separator and " "grouping strings." msgstr "" -#: ../src/Doc/library/locale.rst:376 +#: library/locale.rst:376 msgid "" "Please note that this function will only work for exactly one %char " "specifier. For whole format strings, use :func:`format_string`." msgstr "" -#: ../src/Doc/library/locale.rst:385 +#: library/locale.rst:379 +msgid "Added the *monetary* parameter." +msgstr "" + +#: library/locale.rst:385 msgid "" "Processes formatting specifiers as in ``format % val``, but takes the " "current locale settings into account." msgstr "" -#: ../src/Doc/library/locale.rst:393 +#: library/locale.rst:393 msgid "" "Formats a number *val* according to the current :const:`LC_MONETARY` " "settings." msgstr "" -#: ../src/Doc/library/locale.rst:395 +#: library/locale.rst:395 msgid "" "The returned string includes the currency symbol if *symbol* is true, which " "is the default. If *grouping* is true (which is not the default), grouping " @@ -55469,56 +56736,56 @@ msgid "" "default), the international currency symbol is used." msgstr "" -#: ../src/Doc/library/locale.rst:400 +#: library/locale.rst:400 msgid "" "Note that this function will not work with the 'C' locale, so you have to " "set a locale via :func:`setlocale` first." msgstr "" -#: ../src/Doc/library/locale.rst:408 +#: library/locale.rst:408 msgid "" "Formats a floating point number using the same format as the built-in " "function ``str(float)``, but takes the decimal point into account." msgstr "" -#: ../src/Doc/library/locale.rst:414 +#: library/locale.rst:414 msgid "" "Converts a string to a floating point number, following the :const:" "`LC_NUMERIC` settings." msgstr "" -#: ../src/Doc/library/locale.rst:420 +#: library/locale.rst:420 msgid "" "Converts a string to an integer, following the :const:`LC_NUMERIC` " "conventions." msgstr "" -#: ../src/Doc/library/locale.rst:427 +#: library/locale.rst:427 msgid "" "Locale category for the character type functions. Depending on the settings " "of this category, the functions of module :mod:`string` dealing with case " "change their behaviour." msgstr "" -#: ../src/Doc/library/locale.rst:434 +#: library/locale.rst:434 msgid "" "Locale category for sorting strings. The functions :func:`strcoll` and :" "func:`strxfrm` of the :mod:`locale` module are affected." msgstr "" -#: ../src/Doc/library/locale.rst:440 +#: library/locale.rst:440 msgid "" "Locale category for the formatting of time. The function :func:`time." "strftime` follows these conventions." msgstr "" -#: ../src/Doc/library/locale.rst:446 +#: library/locale.rst:446 msgid "" "Locale category for formatting of monetary values. The available options " "are available from the :func:`localeconv` function." msgstr "" -#: ../src/Doc/library/locale.rst:452 +#: library/locale.rst:452 msgid "" "Locale category for message display. Python currently does not support " "application specific locale-aware messages. Messages displayed by the " @@ -55526,7 +56793,7 @@ msgid "" "affected by this category." msgstr "" -#: ../src/Doc/library/locale.rst:460 +#: library/locale.rst:460 msgid "" "Locale category for formatting numbers. The functions :func:`.format`, :" "func:`atoi`, :func:`atof` and :func:`.str` of the :mod:`locale` module are " @@ -55534,7 +56801,7 @@ msgid "" "affected." msgstr "" -#: ../src/Doc/library/locale.rst:468 +#: library/locale.rst:468 msgid "" "Combination of all locale settings. If this flag is used when the locale is " "changed, setting the locale for all categories is attempted. If that fails " @@ -55544,17 +56811,17 @@ msgid "" "settings." msgstr "" -#: ../src/Doc/library/locale.rst:477 +#: library/locale.rst:477 msgid "" "This is a symbolic constant used for different values returned by :func:" "`localeconv`." msgstr "" -#: ../src/Doc/library/locale.rst:494 +#: library/locale.rst:494 msgid "Background, details, hints, tips and caveats" msgstr "" -#: ../src/Doc/library/locale.rst:496 +#: library/locale.rst:496 msgid "" "The C standard defines the locale as a program-wide property that may be " "relatively expensive to change. On top of that, some implementation are " @@ -55562,7 +56829,7 @@ msgid "" "This makes the locale somewhat painful to use correctly." msgstr "" -#: ../src/Doc/library/locale.rst:501 +#: library/locale.rst:501 msgid "" "Initially, when a program is started, the locale is the ``C`` locale, no " "matter what the user's preferred locale is. The program must explicitly say " @@ -55570,7 +56837,7 @@ msgid "" "``setlocale(LC_ALL, '')``." msgstr "" -#: ../src/Doc/library/locale.rst:505 +#: library/locale.rst:505 msgid "" "It is generally a bad idea to call :func:`setlocale` in some library " "routine, since as a side effect it affects the entire program. Saving and " @@ -55579,7 +56846,7 @@ msgid "" msgstr "" # 71220848fe554d1ea9ce6c9f43d11e4c -#: ../src/Doc/library/locale.rst:510 +#: library/locale.rst:510 msgid "" "If, when coding a module for general use, you need a locale independent " "version of an operation that is affected by the locale (such as :func:" @@ -55591,7 +56858,7 @@ msgid "" msgstr "" # 6f86611621464493b84848033923ace6 -#: ../src/Doc/library/locale.rst:519 +#: library/locale.rst:519 msgid "" "The case conversion functions in the :mod:`string` module are affected by " "the locale settings. When a call to the :func:`setlocale` function changes " @@ -55602,18 +56869,18 @@ msgid "" "`setlocale` calls." msgstr "" -#: ../src/Doc/library/locale.rst:527 +#: library/locale.rst:527 msgid "" "The only way to perform numeric operations according to the locale is to use " "the special functions defined by this module: :func:`atof`, :func:`atoi`, :" "func:`.format`, :func:`.str`." msgstr "" -#: ../src/Doc/library/locale.rst:535 +#: library/locale.rst:535 msgid "For extension writers and programs that embed Python" msgstr "" -#: ../src/Doc/library/locale.rst:537 +#: library/locale.rst:537 msgid "" "Extension modules should never call :func:`setlocale`, except to find out " "what the current locale is. But since the return value can only be used " @@ -55621,7 +56888,7 @@ msgid "" "whether or not the locale is ``C``)." msgstr "" -#: ../src/Doc/library/locale.rst:542 +#: library/locale.rst:542 msgid "" "When Python code uses the :mod:`locale` module to change the locale, this " "also affects the embedding application. If the embedding application " @@ -55631,11 +56898,11 @@ msgid "" "accessible as a shared library." msgstr "" -#: ../src/Doc/library/locale.rst:553 +#: library/locale.rst:553 msgid "Access to message catalogs" msgstr "" -#: ../src/Doc/library/locale.rst:555 +#: library/locale.rst:555 msgid "" "The locale module exposes the C library's gettext interface on systems that " "provide this interface. It consists of the functions :func:`gettext`, :func:" @@ -55647,7 +56914,7 @@ msgid "" msgstr "" # a8c172f074194db4a049c7819190fb5b -#: ../src/Doc/library/locale.rst:562 +#: library/locale.rst:562 msgid "" "Python applications should normally find no need to invoke these functions, " "and should use :mod:`gettext` instead. A known exception to this rule are " @@ -55657,12 +56924,17 @@ msgid "" "their message catalogs." msgstr "" -#: ../src/Doc/library/logging.rst:2 +#: library/logging.rst:2 msgid ":mod:`logging` --- Logging facility for Python" msgstr "" +#: library/logging.rst:0 library/logging.config.rst:0 +#: library/logging.handlers.rst:0 +msgid "Important" +msgstr "" + # 63225456d8214b51b77c4883c5db05d5 -#: ../src/Doc/library/logging.rst:16 +#: library/logging.rst:16 msgid "" "This page contains the API reference information. For tutorial information " "and discussion of more advanced topics, see" @@ -55671,41 +56943,41 @@ msgstr "" # 17836704fee64484878716aa52ed99f3 # 648ee525e31b4298a76768a395f6fe6e # d5965ab90bf54958a2df72a9ee0adc55 -#: ../src/Doc/library/logging.rst:19 ../src/Doc/library/logging.config.rst:16 -#: ../src/Doc/library/logging.handlers.rst:16 +#: library/logging.rst:19 library/logging.config.rst:16 +#: library/logging.handlers.rst:16 msgid ":ref:`Basic Tutorial `" msgstr "" # 85f67f317ed841fe880b6bbf48b1c253 # a3caf33b6e0e496e9622c35f035b9c8d # 5ea1e431b75d41e39dacaff9ef877dc1 -#: ../src/Doc/library/logging.rst:20 ../src/Doc/library/logging.config.rst:17 -#: ../src/Doc/library/logging.handlers.rst:17 +#: library/logging.rst:20 library/logging.config.rst:17 +#: library/logging.handlers.rst:17 msgid ":ref:`Advanced Tutorial `" msgstr "" # 2efc4ae847594a6c98e754e90f23f2f4 # 6707d5d02dec4184898d0cde8f322c60 # 2ea9c29d95a3447599ae4f568d92a8cb -#: ../src/Doc/library/logging.rst:21 ../src/Doc/library/logging.config.rst:18 -#: ../src/Doc/library/logging.handlers.rst:18 +#: library/logging.rst:21 library/logging.config.rst:18 +#: library/logging.handlers.rst:18 msgid ":ref:`Logging Cookbook `" msgstr "" # 65209a9a18594e849f3a25f70ac7edac -#: ../src/Doc/library/logging.rst:23 +#: library/logging.rst:23 msgid "**Source code:** :source:`Lib/logging/__init__.py`" msgstr "" # 782d9ebc3e11423198f018f0a62b6678 -#: ../src/Doc/library/logging.rst:29 +#: library/logging.rst:29 msgid "" "This module defines functions and classes which implement a flexible event " "logging system for applications and libraries." msgstr "" # ba36dc09368943479b8ef5cee6714298 -#: ../src/Doc/library/logging.rst:32 +#: library/logging.rst:32 msgid "" "The key benefit of having the logging API provided by a standard library " "module is that all Python modules can participate in logging, so your " @@ -55714,7 +56986,7 @@ msgid "" msgstr "" # f45897035a454f9fa748463b52ec0f3b -#: ../src/Doc/library/logging.rst:37 +#: library/logging.rst:37 msgid "" "The module provides a lot of functionality and flexibility. If you are " "unfamiliar with logging, the best way to get to grips with it is to see the " @@ -55722,42 +56994,42 @@ msgid "" msgstr "" # 41cf6df041664a508f3d67d2dce4c931 -#: ../src/Doc/library/logging.rst:41 +#: library/logging.rst:41 msgid "" "The basic classes defined by the module, together with their functions, are " "listed below." msgstr "" # bf3ebd111ae54bc3b0a9f3055612d713 -#: ../src/Doc/library/logging.rst:44 +#: library/logging.rst:44 msgid "Loggers expose the interface that application code directly uses." msgstr "" # f348616f10924704b6a8a49b26b4969e -#: ../src/Doc/library/logging.rst:45 +#: library/logging.rst:45 msgid "" "Handlers send the log records (created by loggers) to the appropriate " "destination." msgstr "" # 551bb366e413489698f1dba7c765dd96 -#: ../src/Doc/library/logging.rst:47 +#: library/logging.rst:47 msgid "" "Filters provide a finer grained facility for determining which log records " "to output." msgstr "" # fe2bf47c99dd437fac4237c52e379f37 -#: ../src/Doc/library/logging.rst:49 +#: library/logging.rst:49 msgid "Formatters specify the layout of log records in the final output." msgstr "" -#: ../src/Doc/library/logging.rst:55 +#: library/logging.rst:55 msgid "Logger Objects" msgstr "" # 6c7a2b3402104f38987bf7e3156d1bf6 -#: ../src/Doc/library/logging.rst:57 +#: library/logging.rst:57 msgid "" "Loggers have the following attributes and methods. Note that Loggers are " "never instantiated directly, but always through the module-level function " @@ -55766,7 +57038,7 @@ msgid "" msgstr "" # a34bb6e1f7d04731b7496c969ddd0304 -#: ../src/Doc/library/logging.rst:62 +#: library/logging.rst:62 msgid "" "The ``name`` is potentially a period-separated hierarchical value, like " "``foo.bar.baz`` (though it could also be just plain ``foo``, for example). " @@ -55781,7 +57053,7 @@ msgid "" msgstr "" # f59d59e49ee04b939ed0ee3b23726214 -#: ../src/Doc/library/logging.rst:78 +#: library/logging.rst:78 msgid "" "If this evaluates to true, events logged to this logger will be passed to " "the handlers of higher level (ancestor) loggers, in addition to any handlers " @@ -55791,19 +57063,19 @@ msgid "" msgstr "" # 9dd7daddfd90470c89f541cd70472ed4 -#: ../src/Doc/library/logging.rst:84 +#: library/logging.rst:84 msgid "" "If this evaluates to false, logging messages are not passed to the handlers " "of ancestor loggers." msgstr "" # 30d604360260443d8af53a89d5c3c78a -#: ../src/Doc/library/logging.rst:87 +#: library/logging.rst:87 msgid "The constructor sets this attribute to ``True``." msgstr "" # a8ff91ee694449398a3e7aa2b036b926 -#: ../src/Doc/library/logging.rst:89 +#: library/logging.rst:89 msgid "" "If you attach a handler to a logger *and* one or more of its ancestors, it " "may emit the same record multiple times. In general, you should not need to " @@ -55815,7 +57087,7 @@ msgid "" "rest." msgstr "" -#: ../src/Doc/library/logging.rst:100 +#: library/logging.rst:100 msgid "" "Sets the threshold for this logger to *lvl*. Logging messages which are less " "severe than *lvl* will be ignored. When a logger is created, the level is " @@ -55826,21 +57098,21 @@ msgid "" msgstr "" # e0b94b4a4ec044efa54c79d1c8426e01 -#: ../src/Doc/library/logging.rst:106 +#: library/logging.rst:106 msgid "" "The term 'delegation to the parent' means that if a logger has a level of " "NOTSET, its chain of ancestor loggers is traversed until either an ancestor " "with a level other than NOTSET is found, or the root is reached." msgstr "" -#: ../src/Doc/library/logging.rst:110 +#: library/logging.rst:110 msgid "" "If an ancestor is found with a level other than NOTSET, then that ancestor's " "level is treated as the effective level of the logger where the ancestor " "search began, and is used to determine how a logging event is handled." msgstr "" -#: ../src/Doc/library/logging.rst:114 +#: library/logging.rst:114 msgid "" "If the root is reached, and it has a level of NOTSET, then all messages will " "be processed. Otherwise, the root's level will be used as the effective " @@ -55849,11 +57121,11 @@ msgstr "" # d6297b4bbe0c43029c6e5a2f2a0dadf0 # 312ea233c7f545b2967797928f4b969f -#: ../src/Doc/library/logging.rst:117 ../src/Doc/library/logging.rst:357 +#: library/logging.rst:117 library/logging.rst:358 msgid "See :ref:`levels` for a list of levels." msgstr "" -#: ../src/Doc/library/logging.rst:122 +#: library/logging.rst:122 msgid "" "Indicates if a message of severity *lvl* would be processed by this logger. " "This method checks first the module-level level set by ``logging." @@ -55862,7 +57134,7 @@ msgid "" msgstr "" # ab4dfdc1878743698e953e9ab4b718bf -#: ../src/Doc/library/logging.rst:130 +#: library/logging.rst:130 msgid "" "Indicates the effective level for this logger. If a value other than :const:" "`NOTSET` has been set using :meth:`setLevel`, it is returned. Otherwise, the " @@ -55871,7 +57143,7 @@ msgid "" "integer, typically one of :const:`logging.DEBUG`, :const:`logging.INFO` etc." msgstr "" -#: ../src/Doc/library/logging.rst:140 +#: library/logging.rst:140 msgid "" "Returns a logger which is a descendant to this logger, as determined by the " "suffix. Thus, ``logging.getLogger('abc').getChild('def.ghi')`` would return " @@ -55880,7 +57152,7 @@ msgid "" "named using e.g. ``__name__`` rather than a literal string." msgstr "" -#: ../src/Doc/library/logging.rst:151 +#: library/logging.rst:151 msgid "" "Logs a message with level :const:`DEBUG` on this logger. The *msg* is the " "message format string, and the *args* are the arguments which are merged " @@ -55889,7 +57161,7 @@ msgid "" "argument.)" msgstr "" -#: ../src/Doc/library/logging.rst:156 ../src/Doc/library/logging.rst:778 +#: library/logging.rst:156 library/logging.rst:783 msgid "" "There are two keyword arguments in *kwargs* which are inspected: *exc_info* " "which, if it does not evaluate as false, causes exception information to be " @@ -55899,7 +57171,7 @@ msgid "" msgstr "" # f214ff40009a4660baa01ec333023217 -#: ../src/Doc/library/logging.rst:162 +#: library/logging.rst:162 msgid "" "The second keyword argument is *extra* which can be used to pass a " "dictionary which is used to populate the __dict__ of the LogRecord created " @@ -55908,18 +57180,18 @@ msgid "" "logged messages. For example::" msgstr "" -#: ../src/Doc/library/logging.rst:174 +#: library/logging.rst:174 msgid "would print something like ::" msgstr "" -#: ../src/Doc/library/logging.rst:178 ../src/Doc/library/logging.rst:799 +#: library/logging.rst:178 library/logging.rst:804 msgid "" "The keys in the dictionary passed in *extra* should not clash with the keys " "used by the logging system. (See the :class:`Formatter` documentation for " "more information on which keys are used by the logging system.)" msgstr "" -#: ../src/Doc/library/logging.rst:182 ../src/Doc/library/logging.rst:803 +#: library/logging.rst:182 library/logging.rst:808 msgid "" "If you choose to use these attributes in logged messages, you need to " "exercise some care. In the above example, for instance, the :class:" @@ -55930,7 +57202,7 @@ msgid "" "dictionary with these keys." msgstr "" -#: ../src/Doc/library/logging.rst:189 ../src/Doc/library/logging.rst:810 +#: library/logging.rst:189 library/logging.rst:815 msgid "" "While this might be annoying, this feature is intended for use in " "specialized circumstances, such as multi-threaded servers where the same " @@ -55941,53 +57213,54 @@ msgid "" "particular :class:`Handler`\\ s." msgstr "" -#: ../src/Doc/library/logging.rst:199 +#: library/logging.rst:199 msgid "" "Logs a message with level :const:`INFO` on this logger. The arguments are " "interpreted as for :meth:`debug`." msgstr "" -#: ../src/Doc/library/logging.rst:205 +#: library/logging.rst:205 msgid "" "Logs a message with level :const:`WARNING` on this logger. The arguments are " "interpreted as for :meth:`debug`." msgstr "" -#: ../src/Doc/library/logging.rst:211 +#: library/logging.rst:211 msgid "" "Logs a message with level :const:`ERROR` on this logger. The arguments are " "interpreted as for :meth:`debug`." msgstr "" -#: ../src/Doc/library/logging.rst:217 +#: library/logging.rst:217 msgid "" "Logs a message with level :const:`CRITICAL` on this logger. The arguments " "are interpreted as for :meth:`debug`." msgstr "" -#: ../src/Doc/library/logging.rst:223 +#: library/logging.rst:223 msgid "" "Logs a message with integer level *lvl* on this logger. The other arguments " "are interpreted as for :meth:`debug`." msgstr "" -#: ../src/Doc/library/logging.rst:229 +#: library/logging.rst:229 msgid "" "Logs a message with level :const:`ERROR` on this logger. The arguments are " -"interpreted as for :meth:`debug`. Exception info is added to the logging " -"message. This method should only be called from an exception handler." +"interpreted as for :meth:`debug`, except that any passed *exc_info* is not " +"inspected. Exception info is always added to the logging message. This " +"method should only be called from an exception handler." msgstr "" -#: ../src/Doc/library/logging.rst:236 +#: library/logging.rst:237 msgid "Adds the specified filter *filt* to this logger." msgstr "" -#: ../src/Doc/library/logging.rst:241 +#: library/logging.rst:242 msgid "Removes the specified filter *filt* from this logger." msgstr "" # ef9b47b1a060453b8c6e3bf2c7a78bab -#: ../src/Doc/library/logging.rst:246 +#: library/logging.rst:247 msgid "" "Applies this logger's filters to the record and returns a true value if the " "record is to be processed. The filters are consulted in turn, until one of " @@ -55996,21 +57269,27 @@ msgid "" "further processing of the record occurs." msgstr "" -#: ../src/Doc/library/logging.rst:255 +#: library/logging.rst:256 msgid "Adds the specified handler *hdlr* to this logger." msgstr "" -#: ../src/Doc/library/logging.rst:260 +#: library/logging.rst:261 msgid "Removes the specified handler *hdlr* from this logger." msgstr "" -#: ../src/Doc/library/logging.rst:265 +#: library/logging.rst:266 msgid "" "Finds the caller's source filename and line number. Returns the filename, " "line number and function name as a 3-element tuple." msgstr "" -#: ../src/Doc/library/logging.rst:274 +#: library/logging.rst:269 +msgid "" +"The function name was added. In earlier versions, the filename and line " +"number were returned as a 2-element tuple." +msgstr "" + +#: library/logging.rst:275 msgid "" "Handles a record by passing it to all handlers associated with this logger " "and its ancestors (until a false value of *propagate* is found). This method " @@ -56019,19 +57298,23 @@ msgid "" "filter`." msgstr "" -#: ../src/Doc/library/logging.rst:282 +#: library/logging.rst:283 msgid "" "This is a factory method which can be overridden in subclasses to create " "specialized :class:`LogRecord` instances." msgstr "" +#: library/logging.rst:286 +msgid "*func* and *extra* were added." +msgstr "" + # f3335e42ae274048bb7b80c0987889b9 -#: ../src/Doc/library/logging.rst:292 +#: library/logging.rst:293 msgid "Logging Levels" msgstr "" # 366a46b2062a4e88a368d4b348ef09e7 -#: ../src/Doc/library/logging.rst:294 +#: library/logging.rst:295 msgid "" "The numeric values of logging levels are given in the following table. These " "are primarily of interest if you want to define your own levels, and need " @@ -56040,76 +57323,74 @@ msgid "" "value; the predefined name is lost." msgstr "" -#: ../src/Doc/library/logging.rst:301 -#: ../src/Doc/library/multiprocessing.rst:2030 +#: library/logging.rst:302 library/multiprocessing.rst:2173 msgid "Level" msgstr "" -#: ../src/Doc/library/logging.rst:301 -#: ../src/Doc/library/multiprocessing.rst:2030 +#: library/logging.rst:302 library/multiprocessing.rst:2173 msgid "Numeric value" msgstr "" # 357eea401a074e0c8759f34016649ace -#: ../src/Doc/library/logging.rst:303 +#: library/logging.rst:304 msgid "``CRITICAL``" msgstr "" # 738b511c72bf45068c128966d60f6acf -#: ../src/Doc/library/logging.rst:303 +#: library/logging.rst:304 msgid "50" msgstr "" # caa2fd39d0744c2b8adebf262c689977 -#: ../src/Doc/library/logging.rst:305 +#: library/logging.rst:306 msgid "``ERROR``" msgstr "" # 960b5cfea3394c0da389dbe4088fc62f -#: ../src/Doc/library/logging.rst:305 +#: library/logging.rst:306 msgid "40" msgstr "" # ba91cb2177ca4dc99c08dab3f7461c4d -#: ../src/Doc/library/logging.rst:307 +#: library/logging.rst:308 msgid "``WARNING``" msgstr "" # 75c1058522c24bcca9a843f30a231be0 -#: ../src/Doc/library/logging.rst:307 +#: library/logging.rst:308 msgid "30" msgstr "" # 362079838e6b4c58adae51119c71fff3 -#: ../src/Doc/library/logging.rst:309 +#: library/logging.rst:310 msgid "``INFO``" msgstr "" # f55c04008dd54a569f84281c86d8f6e6 -#: ../src/Doc/library/logging.rst:309 +#: library/logging.rst:310 msgid "20" msgstr "" # c03e70d5e5ec45ff866d69eec6094d2c -#: ../src/Doc/library/logging.rst:311 +#: library/logging.rst:312 msgid "``DEBUG``" msgstr "" # 7216d97cd20e4f5ca6830f6deb2952d2 -#: ../src/Doc/library/logging.rst:311 +#: library/logging.rst:312 msgid "10" msgstr "" # 0ec840b324974e45a3465e3f96c3640d -#: ../src/Doc/library/logging.rst:313 +#: library/logging.rst:314 msgid "``NOTSET``" msgstr "" -#: ../src/Doc/library/logging.rst:320 +#: library/logging.rst:321 msgid "Handler Objects" msgstr "" -#: ../src/Doc/library/logging.rst:322 +#: library/logging.rst:323 msgid "" "Handlers have the following attributes and methods. Note that :class:" "`Handler` is never instantiated directly; this class acts as a base for more " @@ -56117,48 +57398,48 @@ msgid "" "to call :meth:`Handler.__init__`." msgstr "" -#: ../src/Doc/library/logging.rst:330 +#: library/logging.rst:331 msgid "" "Initializes the :class:`Handler` instance by setting its level, setting the " "list of filters to the empty list and creating a lock (using :meth:" "`createLock`) for serializing access to an I/O mechanism." msgstr "" -#: ../src/Doc/library/logging.rst:337 +#: library/logging.rst:338 msgid "" "Initializes a thread lock which can be used to serialize access to " "underlying I/O functionality which may not be threadsafe." msgstr "" -#: ../src/Doc/library/logging.rst:343 +#: library/logging.rst:344 msgid "Acquires the thread lock created with :meth:`createLock`." msgstr "" -#: ../src/Doc/library/logging.rst:348 +#: library/logging.rst:349 msgid "Releases the thread lock acquired with :meth:`acquire`." msgstr "" -#: ../src/Doc/library/logging.rst:353 +#: library/logging.rst:354 msgid "" "Sets the threshold for this handler to *lvl*. Logging messages which are " "less severe than *lvl* will be ignored. When a handler is created, the level " "is set to :const:`NOTSET` (which causes all messages to be processed)." msgstr "" -#: ../src/Doc/library/logging.rst:361 +#: library/logging.rst:362 msgid "Sets the :class:`Formatter` for this handler to *form*." msgstr "" -#: ../src/Doc/library/logging.rst:366 +#: library/logging.rst:367 msgid "Adds the specified filter *filt* to this handler." msgstr "" -#: ../src/Doc/library/logging.rst:371 +#: library/logging.rst:372 msgid "Removes the specified filter *filt* from this handler." msgstr "" # fd8106d0ca2843d48c33a558bf53deb8 -#: ../src/Doc/library/logging.rst:376 +#: library/logging.rst:377 msgid "" "Applies this handler's filters to the record and returns a true value if the " "record is to be processed. The filters are consulted in turn, until one of " @@ -56167,13 +57448,13 @@ msgid "" "record." msgstr "" -#: ../src/Doc/library/logging.rst:385 +#: library/logging.rst:386 msgid "" "Ensure all logging output has been flushed. This version does nothing and is " "intended to be implemented by subclasses." msgstr "" -#: ../src/Doc/library/logging.rst:391 +#: library/logging.rst:392 msgid "" "Tidy up any resources used by the handler. This version does no output but " "removes the handler from an internal list of handlers which is closed when :" @@ -56181,7 +57462,7 @@ msgid "" "from overridden :meth:`close` methods." msgstr "" -#: ../src/Doc/library/logging.rst:399 +#: library/logging.rst:400 msgid "" "Conditionally emits the specified logging record, depending on filters which " "may have been added to the handler. Wraps the actual emission of the record " @@ -56189,7 +57470,7 @@ msgid "" msgstr "" # 489ee717fb644db898004f432c3b2d47 -#: ../src/Doc/library/logging.rst:406 +#: library/logging.rst:407 msgid "" "This method should be called from handlers when an exception is encountered " "during an :meth:`emit` call. If the module-level attribute " @@ -56202,13 +57483,13 @@ msgid "" "more useful during development)." msgstr "" -#: ../src/Doc/library/logging.rst:419 +#: library/logging.rst:420 msgid "" "Do formatting for a record - if a formatter is set, use it. Otherwise, use " "the default formatter for the module." msgstr "" -#: ../src/Doc/library/logging.rst:425 +#: library/logging.rst:426 msgid "" "Do whatever it takes to actually log the specified logging record. This " "version is intended to be implemented by subclasses and so raises a :exc:" @@ -56216,27 +57497,28 @@ msgid "" msgstr "" # e027397066864e2d98a0aa0e15923f6e -#: ../src/Doc/library/logging.rst:429 +#: library/logging.rst:430 msgid "" "For a list of handlers included as standard, see :mod:`logging.handlers`." msgstr "" -#: ../src/Doc/library/logging.rst:434 +#: library/logging.rst:435 msgid "Formatter Objects" msgstr "" -# 4f6ae7d13e2943e1a3b368e1ad7c8b80 -#: ../src/Doc/library/logging.rst:438 +#: library/logging.rst:439 msgid "" ":class:`Formatter` objects have the following attributes and methods. They " "are responsible for converting a :class:`LogRecord` to (usually) a string " "which can be interpreted by either a human or an external system. The base :" "class:`Formatter` allows a formatting string to be specified. If none is " -"supplied, the default value of ``'%(message)s'`` is used." +"supplied, the default value of ``'%(message)s'`` is used, which just " +"includes the message in the logging call. To have additional items of " +"information in the formatted output (such as a timestamp), keep reading." msgstr "" # 429565fd41594b718960f8ca8f43d688 -#: ../src/Doc/library/logging.rst:444 +#: library/logging.rst:447 msgid "" "A Formatter can be initialized with a format string which makes use of " "knowledge of the :class:`LogRecord` attributes - such as the default value " @@ -56247,13 +57529,13 @@ msgid "" msgstr "" # 5849422f75184f7ea6353f9d9b36f2c6 -#: ../src/Doc/library/logging.rst:451 +#: library/logging.rst:454 msgid "" "The useful mapping keys in a :class:`LogRecord` are given in the section on :" "ref:`logrecord-attributes`." msgstr "" -#: ../src/Doc/library/logging.rst:457 +#: library/logging.rst:460 msgid "" "Returns a new instance of the :class:`Formatter` class. The instance is " "initialized with a format string for the message as a whole, as well as a " @@ -56262,7 +57544,7 @@ msgid "" "ISO8601 date format is used." msgstr "" -#: ../src/Doc/library/logging.rst:465 +#: library/logging.rst:468 msgid "" "The record's attribute dictionary is used as the operand to a string " "formatting operation. Returns the resulting string. Before formatting the " @@ -56280,7 +57562,7 @@ msgid "" "cached value but recalculates it afresh." msgstr "" -#: ../src/Doc/library/logging.rst:484 +#: library/logging.rst:487 msgid "" "This method should be called from :meth:`format` by a formatter which wants " "to make use of a formatted time. This method can be overridden in formatters " @@ -56291,7 +57573,7 @@ msgid "" msgstr "" # 00c5b187d0ad4b24a215f29062e211b4 -#: ../src/Doc/library/logging.rst:492 +#: library/logging.rst:495 msgid "" "This function uses a user-configurable function to convert the creation time " "to a tuple. By default, :func:`time.localtime` is used; to change this for a " @@ -56301,7 +57583,7 @@ msgid "" "be shown in GMT, set the ``converter`` attribute in the ``Formatter`` class." msgstr "" -#: ../src/Doc/library/logging.rst:502 +#: library/logging.rst:505 msgid "" "Formats the specified exception information (a standard exception tuple as " "returned by :func:`sys.exc_info`) as a string. This default implementation " @@ -56309,12 +57591,12 @@ msgid "" "returned." msgstr "" -#: ../src/Doc/library/logging.rst:510 +#: library/logging.rst:513 msgid "Filter Objects" msgstr "" # 2ccbda30d0bf4d71b601c2b625d5ff23 -#: ../src/Doc/library/logging.rst:512 +#: library/logging.rst:515 msgid "" "``Filters`` can be used by ``Handlers`` and ``Loggers`` for more " "sophisticated filtering than is provided by levels. The base filter class " @@ -56324,7 +57606,7 @@ msgid "" "If initialized with the empty string, all events are passed." msgstr "" -#: ../src/Doc/library/logging.rst:522 +#: library/logging.rst:525 msgid "" "Returns an instance of the :class:`Filter` class. If *name* is specified, it " "names a logger which, together with its children, will have its events " @@ -56332,14 +57614,14 @@ msgid "" "event." msgstr "" -#: ../src/Doc/library/logging.rst:529 +#: library/logging.rst:532 msgid "" "Is the specified record to be logged? Returns zero for no, nonzero for yes. " "If deemed appropriate, the record may be modified in-place by this method." msgstr "" # 2c89c607954743688ff0ca22287bf3bc -#: ../src/Doc/library/logging.rst:533 +#: library/logging.rst:536 msgid "" "Note that filters attached to handlers are consulted before an event is " "emitted by the handler, whereas filters attached to loggers are consulted " @@ -56350,14 +57632,14 @@ msgid "" msgstr "" # 7550dbb041f1417d8ddc40ce3d3028f2 -#: ../src/Doc/library/logging.rst:540 +#: library/logging.rst:543 msgid "" "You don't actually need to subclass ``Filter``: you can pass any instance " "which has a ``filter`` method with the same semantics." msgstr "" # db71aed5f5f544d5ab097b37c6cf8d91 -#: ../src/Doc/library/logging.rst:543 +#: library/logging.rst:546 msgid "" "Although filters are used primarily to filter records based on more " "sophisticated criteria than levels, they get to see every record which is " @@ -56369,12 +57651,12 @@ msgid "" "information into logs (see :ref:`filters-contextual`)." msgstr "" -#: ../src/Doc/library/logging.rst:555 +#: library/logging.rst:558 msgid "LogRecord Objects" msgstr "" # aa36f6a992c74a4a9ea85a43ffe618b5 -#: ../src/Doc/library/logging.rst:557 +#: library/logging.rst:560 msgid "" ":class:`LogRecord` instances are created automatically by the :class:" "`Logger` every time something is logged, and can be created manually via :" @@ -56383,20 +57665,69 @@ msgid "" msgstr "" # a9b9603f940b48bfae65bd327156a3f6 -#: ../src/Doc/library/logging.rst:565 +#: library/logging.rst:568 msgid "Contains all the information pertinent to the event being logged." msgstr "" # cacbf53c801a4c529587d72fce86dcb4 -#: ../src/Doc/library/logging.rst:567 +#: library/logging.rst:570 msgid "" "The primary information is passed in :attr:`msg` and :attr:`args`, which are " "combined using ``msg % args`` to create the :attr:`message` field of the " "record." msgstr "" +#: library/logging.rst:574 +msgid "" +"The name of the logger used to log the event represented by this LogRecord. " +"Note that this name will always have this value, even though it may be " +"emitted by a handler attached to a different (ancestor) logger." +msgstr "" + +#: library/logging.rst:578 +msgid "" +"The numeric level of the logging event (one of DEBUG, INFO etc.) Note that " +"this is converted to *two* attributes of the LogRecord: ``levelno`` for the " +"numeric value and ``levelname`` for the corresponding level name." +msgstr "" + +#: library/logging.rst:582 +msgid "The full pathname of the source file where the logging call was made." +msgstr "" + +#: library/logging.rst:584 +msgid "The line number in the source file where the logging call was made." +msgstr "" + +#: library/logging.rst:586 +msgid "" +"The event description message, possibly a format string with placeholders " +"for variable data." +msgstr "" + +#: library/logging.rst:588 +msgid "" +"Variable data to merge into the *msg* argument to obtain the event " +"description." +msgstr "" + +#: library/logging.rst:590 +msgid "" +"An exception tuple with the current exception information, or *None* if no " +"exception information is available." +msgstr "" + +#: library/logging.rst:592 +msgid "" +"The name of the function or method from which the logging call was invoked." +msgstr "" + +#: library/logging.rst:595 +msgid "*func* was added." +msgstr "" + # 59b7ea28e01a487dbddb8115845e1f45 -#: ../src/Doc/library/logging.rst:597 +#: library/logging.rst:600 msgid "" "Returns the message for this :class:`LogRecord` instance after merging any " "user-supplied arguments with the message. If the user-supplied message " @@ -56406,12 +57737,12 @@ msgid "" msgstr "" # c05255a098c24c68af6da824592b2cd1 -#: ../src/Doc/library/logging.rst:608 +#: library/logging.rst:611 msgid "LogRecord attributes" msgstr "" # d2395bd85fe6409bb44505ad81a9fe8d -#: ../src/Doc/library/logging.rst:610 +#: library/logging.rst:613 msgid "" "The LogRecord has a number of attributes, most of which are derived from the " "parameters to the constructor. (Note that the names do not always correspond " @@ -56423,45 +57754,46 @@ msgid "" msgstr "" # a7a0a38b143842ebbb663eebaef6360f -#: ../src/Doc/library/logging.rst:619 +#: library/logging.rst:622 msgid "Attribute name" msgstr "" -#: ../src/Doc/library/logging.rst:619 ../src/Doc/library/logging.rst:944 -#: ../src/Doc/library/ossaudiodev.rst:185 ../src/Doc/library/posixfile.rst:110 -#: ../src/Doc/library/posixfile.rst:144 ../src/Doc/library/struct.rst:166 +#: library/logging.rst:622 library/logging.rst:950 library/ossaudiodev.rst:185 +#: library/posixfile.rst:110 library/posixfile.rst:144 library/struct.rst:166 msgid "Format" msgstr "" # 81910e752dcd4fc0be61580d953923a2 -#: ../src/Doc/library/logging.rst:621 +#: library/logging.rst:624 library/optparse.rst:1327 library/optparse.rst:1341 +#: library/optparse.rst:1660 msgid "args" msgstr "" # 7d4cb177a6374a3e93acdac55ff12dd8 # 0585b32855eb4231b9ab17925ca1d148 # 6c61a121df1948a98d13753e5419c0fd -#: ../src/Doc/library/logging.rst:621 ../src/Doc/library/logging.rst:633 -#: ../src/Doc/library/logging.rst:661 +#: library/logging.rst:624 library/logging.rst:638 library/logging.rst:666 msgid "You shouldn't need to format this yourself." msgstr "" -# 1c3a23114f9e474a9f483ae2eed24bd9 -#: ../src/Doc/library/logging.rst:621 -msgid "The tuple of arguments merged into ``msg`` to produce ``message``." +#: library/logging.rst:624 +msgid "" +"The tuple of arguments merged into ``msg`` to produce ``message``, or a dict " +"whose values are used for the merge (when there is only one argument, and it " +"is a dictionary)." msgstr "" # 6700773068cd4ab5b20696c58812f451 -#: ../src/Doc/library/logging.rst:624 +#: library/logging.rst:629 msgid "asctime" msgstr "" -#: ../src/Doc/library/logging.rst:624 +#: library/logging.rst:629 msgid "``%(asctime)s``" msgstr "" # 657a301f5a7841f1900ea85f42a0f399 -#: ../src/Doc/library/logging.rst:624 +#: library/logging.rst:629 msgid "" "Human-readable time when the :class:`LogRecord` was created. By default " "this is of the form '2003-07-08 16:49:45,896' (the numbers after the comma " @@ -56469,148 +57801,148 @@ msgid "" msgstr "" # 8dd2b46876a0424db796acf99fd2424f -#: ../src/Doc/library/logging.rst:630 +#: library/logging.rst:635 msgid "created" msgstr "" -#: ../src/Doc/library/logging.rst:630 +#: library/logging.rst:635 msgid "``%(created)f``" msgstr "" -#: ../src/Doc/library/logging.rst:630 +#: library/logging.rst:635 msgid "" "Time when the :class:`LogRecord` was created (as returned by :func:`time." "time`)." msgstr "" # 3063f11903fa41cf94cff680f6a68364 -#: ../src/Doc/library/logging.rst:633 +#: library/logging.rst:638 msgid "exc_info" msgstr "" # a54d9abbf50f484695d76e817280575f -#: ../src/Doc/library/logging.rst:633 +#: library/logging.rst:638 msgid "" "Exception tuple (à la ``sys.exc_info``) or, if no exception has occurred, " "*None*." msgstr "" # 2e716d0b1a6a4b84bb41302c687f652d -#: ../src/Doc/library/logging.rst:636 +#: library/logging.rst:641 msgid "filename" msgstr "" -#: ../src/Doc/library/logging.rst:636 +#: library/logging.rst:641 msgid "``%(filename)s``" msgstr "" # 8a9d79d4ec8a4a32a0d8abfcb4826989 -#: ../src/Doc/library/logging.rst:636 +#: library/logging.rst:641 msgid "Filename portion of ``pathname``." msgstr "" # 48ca50495d3540c5b15f73077fea2bfe -#: ../src/Doc/library/logging.rst:638 +#: library/logging.rst:643 msgid "funcName" msgstr "" -#: ../src/Doc/library/logging.rst:638 +#: library/logging.rst:643 msgid "``%(funcName)s``" msgstr "" -#: ../src/Doc/library/logging.rst:638 +#: library/logging.rst:643 msgid "Name of function containing the logging call." msgstr "" # 77b9021bc9ee4dad96239109cdb73fe3 -#: ../src/Doc/library/logging.rst:640 +#: library/logging.rst:645 msgid "levelname" msgstr "" -#: ../src/Doc/library/logging.rst:640 +#: library/logging.rst:645 msgid "``%(levelname)s``" msgstr "" -#: ../src/Doc/library/logging.rst:640 +#: library/logging.rst:645 msgid "" "Text logging level for the message (``'DEBUG'``, ``'INFO'``, ``'WARNING'``, " "``'ERROR'``, ``'CRITICAL'``)." msgstr "" # 36a91c6444d3456ca629792017484e01 -#: ../src/Doc/library/logging.rst:644 +#: library/logging.rst:649 msgid "levelno" msgstr "" -#: ../src/Doc/library/logging.rst:644 +#: library/logging.rst:649 msgid "``%(levelno)s``" msgstr "" -#: ../src/Doc/library/logging.rst:644 +#: library/logging.rst:649 msgid "" "Numeric logging level for the message (:const:`DEBUG`, :const:`INFO`, :const:" "`WARNING`, :const:`ERROR`, :const:`CRITICAL`)." msgstr "" # b43450a06d4f4b8b97765e013d75fca6 -#: ../src/Doc/library/logging.rst:649 +#: library/logging.rst:654 msgid "lineno" msgstr "" -#: ../src/Doc/library/logging.rst:649 +#: library/logging.rst:654 msgid "``%(lineno)d``" msgstr "" -#: ../src/Doc/library/logging.rst:649 +#: library/logging.rst:654 msgid "Source line number where the logging call was issued (if available)." msgstr "" -#: ../src/Doc/library/logging.rst:652 +#: library/logging.rst:657 msgid "``%(module)s``" msgstr "" # 44423f241f0b4159a5444a304fbdfee0 -#: ../src/Doc/library/logging.rst:652 +#: library/logging.rst:657 msgid "Module (name portion of ``filename``)." msgstr "" # 973524b9442444668b98e639167b6bd2 -#: ../src/Doc/library/logging.rst:654 +#: library/logging.rst:659 msgid "msecs" msgstr "" -#: ../src/Doc/library/logging.rst:654 +#: library/logging.rst:659 msgid "``%(msecs)d``" msgstr "" -#: ../src/Doc/library/logging.rst:654 +#: library/logging.rst:659 msgid "" "Millisecond portion of the time when the :class:`LogRecord` was created." msgstr "" # e153e582dcc5494cbb6948a2d4e7d2ad -#: ../src/Doc/library/logging.rst:657 +#: library/logging.rst:662 msgid "message" msgstr "" -#: ../src/Doc/library/logging.rst:657 +#: library/logging.rst:662 msgid "``%(message)s``" msgstr "" # 8cda488807f24f67816564682da618be -#: ../src/Doc/library/logging.rst:657 +#: library/logging.rst:662 msgid "" "The logged message, computed as ``msg % args``. This is set when :meth:" "`Formatter.format` is invoked." msgstr "" # 83e63c65de4b4326a747dae206c107da -#: ../src/Doc/library/logging.rst:661 +#: library/logging.rst:666 msgid "msg" msgstr "" # 40fa524fda5d4cc4bdcde1e884054103 -#: ../src/Doc/library/logging.rst:661 +#: library/logging.rst:666 msgid "" "The format string passed in the original logging call. Merged with ``args`` " "to produce ``message``, or an arbitrary object (see :ref:`arbitrary-object-" @@ -56618,122 +57950,130 @@ msgid "" msgstr "" # 2b8a921e274f4064b3fccc5e6d014d32 -#: ../src/Doc/library/logging.rst:666 +#: library/logging.rst:671 msgid "name" msgstr "" -#: ../src/Doc/library/logging.rst:666 +#: library/logging.rst:671 msgid "``%(name)s``" msgstr "" # 7e095362e0264268911e340d6281d17f -#: ../src/Doc/library/logging.rst:666 +#: library/logging.rst:671 msgid "Name of the logger used to log the call." msgstr "" # 2c07b60d2d4444d7871446f5f3c75bfe -#: ../src/Doc/library/logging.rst:668 +#: library/logging.rst:673 msgid "pathname" msgstr "" -#: ../src/Doc/library/logging.rst:668 +#: library/logging.rst:673 msgid "``%(pathname)s``" msgstr "" -#: ../src/Doc/library/logging.rst:668 +#: library/logging.rst:673 msgid "" "Full pathname of the source file where the logging call was issued (if " "available)." msgstr "" # 74d053628e03412f996e4935af4f339a -#: ../src/Doc/library/logging.rst:671 +#: library/logging.rst:676 msgid "process" msgstr "" -#: ../src/Doc/library/logging.rst:671 +#: library/logging.rst:676 msgid "``%(process)d``" msgstr "" -#: ../src/Doc/library/logging.rst:671 +#: library/logging.rst:676 msgid "Process ID (if available)." msgstr "" # 9493059d3fde4f8283d8463c04227dc3 -#: ../src/Doc/library/logging.rst:673 +#: library/logging.rst:678 msgid "processName" msgstr "" # 3b62cabebfb846c3b393e3ab8d586856 -#: ../src/Doc/library/logging.rst:673 +#: library/logging.rst:678 msgid "``%(processName)s``" msgstr "" # 5befa370e7a749e1acb2438ea8da7207 -#: ../src/Doc/library/logging.rst:673 +#: library/logging.rst:678 msgid "Process name (if available)." msgstr "" # 257a5f14ab704945bfaab69ab7c2d165 -#: ../src/Doc/library/logging.rst:675 +#: library/logging.rst:680 msgid "relativeCreated" msgstr "" -#: ../src/Doc/library/logging.rst:675 +#: library/logging.rst:680 msgid "``%(relativeCreated)d``" msgstr "" -#: ../src/Doc/library/logging.rst:675 +#: library/logging.rst:680 msgid "" "Time in milliseconds when the LogRecord was created, relative to the time " "the logging module was loaded." msgstr "" # 97f5f361654345ee8bb89d8018a2c557 -#: ../src/Doc/library/logging.rst:679 +#: library/logging.rst:684 msgid "thread" msgstr "" -#: ../src/Doc/library/logging.rst:679 +#: library/logging.rst:684 msgid "``%(thread)d``" msgstr "" -#: ../src/Doc/library/logging.rst:679 +#: library/logging.rst:684 msgid "Thread ID (if available)." msgstr "" # 7fa23b02e5f14289b66730f66ba38f54 -#: ../src/Doc/library/logging.rst:681 +#: library/logging.rst:686 msgid "threadName" msgstr "" -#: ../src/Doc/library/logging.rst:681 +#: library/logging.rst:686 msgid "``%(threadName)s``" msgstr "" -#: ../src/Doc/library/logging.rst:681 +#: library/logging.rst:686 msgid "Thread name (if available)." msgstr "" -#: ../src/Doc/library/logging.rst:693 +#: library/logging.rst:689 +msgid "*funcName* was added." +msgstr "" + +#: library/logging.rst:692 +msgid "*processName* was added." +msgstr "" + +#: library/logging.rst:698 msgid "LoggerAdapter Objects" msgstr "" # 33adc8e9881d4cb69d5f67efd8fd44e3 -#: ../src/Doc/library/logging.rst:695 +#: library/logging.rst:700 msgid "" ":class:`LoggerAdapter` instances are used to conveniently pass contextual " "information into logging calls. For a usage example, see the section on :ref:" "`adding contextual information to your logging output `." msgstr "" -#: ../src/Doc/library/logging.rst:704 +#: library/logging.rst:709 msgid "" "Returns an instance of :class:`LoggerAdapter` initialized with an " "underlying :class:`Logger` instance and a dict-like object." msgstr "" -#: ../src/Doc/library/logging.rst:709 +#: library/logging.rst:714 msgid "" "Modifies the message and/or keyword arguments passed to a logging call in " "order to insert contextual information. This implementation takes the object " @@ -56743,7 +58083,7 @@ msgid "" msgstr "" # 55115b95c22d4f288d454a227d111691 -#: ../src/Doc/library/logging.rst:715 +#: library/logging.rst:720 msgid "" "In addition to the above, :class:`LoggerAdapter` supports the following " "methods of :class:`Logger`: :meth:`~Logger.debug`, :meth:`~Logger.info`, :" @@ -56754,11 +58094,17 @@ msgid "" "interchangeably for these calls." msgstr "" -#: ../src/Doc/library/logging.rst:728 +#: library/logging.rst:727 +msgid "" +"The :meth:`~Logger.isEnabledFor` method was added to :class:`LoggerAdapter`. " +"This method delegates to the underlying logger." +msgstr "" + +#: library/logging.rst:733 msgid "Thread Safety" msgstr "" -#: ../src/Doc/library/logging.rst:730 +#: library/logging.rst:735 msgid "" "The logging module is intended to be thread-safe without any special work " "needing to be done by its clients. It achieves this though using threading " @@ -56767,7 +58113,7 @@ msgid "" "O." msgstr "" -#: ../src/Doc/library/logging.rst:735 +#: library/logging.rst:740 msgid "" "If you are implementing asynchronous signal handlers using the :mod:`signal` " "module, you may not be able to use logging from within such handlers. This " @@ -56775,18 +58121,18 @@ msgid "" "always re-entrant, and so cannot be invoked from such signal handlers." msgstr "" -#: ../src/Doc/library/logging.rst:742 +#: library/logging.rst:747 msgid "Module-Level Functions" msgstr "" -#: ../src/Doc/library/logging.rst:744 +#: library/logging.rst:749 msgid "" "In addition to the classes described above, there are a number of module- " "level functions." msgstr "" # 883734484a8546cd8694abaa7b10a032 -#: ../src/Doc/library/logging.rst:750 +#: library/logging.rst:755 msgid "" "Return a logger with the specified name or, if no name is specified, return " "a logger which is the root logger of the hierarchy. If specified, the name " @@ -56795,7 +58141,7 @@ msgid "" "using logging." msgstr "" -#: ../src/Doc/library/logging.rst:755 +#: library/logging.rst:760 msgid "" "All calls to this function with a given name return the same logger " "instance. This means that logger instances never need to be passed between " @@ -56803,7 +58149,7 @@ msgid "" msgstr "" # 977d17e24eb1443b8cf8a9826a380e99 -#: ../src/Doc/library/logging.rst:762 +#: library/logging.rst:767 msgid "" "Return either the standard :class:`Logger` class, or the last class passed " "to :func:`setLoggerClass`. This function may be called from within a new " @@ -56812,7 +58158,7 @@ msgid "" "example::" msgstr "" -#: ../src/Doc/library/logging.rst:773 +#: library/logging.rst:778 msgid "" "Logs a message with level :const:`DEBUG` on the root logger. The *msg* is " "the message format string, and the *args* are the arguments which are merged " @@ -56821,7 +58167,7 @@ msgid "" "argument.)" msgstr "" -#: ../src/Doc/library/logging.rst:784 +#: library/logging.rst:789 msgid "" "The other optional keyword argument is *extra* which can be used to pass a " "dictionary which is used to populate the __dict__ of the LogRecord created " @@ -56831,49 +58177,54 @@ msgid "" msgstr "" # 8eeda34b2871478eaaeeda2d0b9bd214 -#: ../src/Doc/library/logging.rst:795 +#: library/logging.rst:800 msgid "would print something like::" msgstr "" -#: ../src/Doc/library/logging.rst:823 +#: library/logging.rst:822 +msgid "*extra* was added." +msgstr "" + +#: library/logging.rst:828 msgid "" "Logs a message with level :const:`INFO` on the root logger. The arguments " "are interpreted as for :func:`debug`." msgstr "" -#: ../src/Doc/library/logging.rst:829 +#: library/logging.rst:834 msgid "" "Logs a message with level :const:`WARNING` on the root logger. The arguments " "are interpreted as for :func:`debug`." msgstr "" -#: ../src/Doc/library/logging.rst:835 +#: library/logging.rst:840 msgid "" "Logs a message with level :const:`ERROR` on the root logger. The arguments " "are interpreted as for :func:`debug`." msgstr "" -#: ../src/Doc/library/logging.rst:841 +#: library/logging.rst:846 msgid "" "Logs a message with level :const:`CRITICAL` on the root logger. The " "arguments are interpreted as for :func:`debug`." msgstr "" -#: ../src/Doc/library/logging.rst:847 +#: library/logging.rst:852 msgid "" "Logs a message with level :const:`ERROR` on the root logger. The arguments " -"are interpreted as for :func:`debug`. Exception info is added to the logging " -"message. This function should only be called from an exception handler." +"are interpreted as for :func:`debug`, except that any passed *exc_info* is " +"not inspected. Exception info is always added to the logging message. This " +"function should only be called from an exception handler." msgstr "" -#: ../src/Doc/library/logging.rst:854 +#: library/logging.rst:860 msgid "" "Logs a message with level *level* on the root logger. The other arguments " "are interpreted as for :func:`debug`." msgstr "" # 1442a846689c4c549127f3b5cfe46774 -#: ../src/Doc/library/logging.rst:857 +#: library/logging.rst:863 msgid "" "The above module-level convenience functions, which delegate to the root " "logger, call :func:`basicConfig` to ensure that at least one handler is " @@ -56887,7 +58238,7 @@ msgid "" msgstr "" # 0242a6c6264249b3a785f87eef5f8640 -#: ../src/Doc/library/logging.rst:869 +#: library/logging.rst:875 msgid "" "Provides an overriding level *lvl* for all loggers which takes precedence " "over the logger's own level. When the need arises to temporarily throttle " @@ -56901,7 +58252,7 @@ msgid "" "individual loggers." msgstr "" -#: ../src/Doc/library/logging.rst:883 +#: library/logging.rst:889 msgid "" "Associates level *lvl* with text *levelName* in an internal dictionary, " "which is used to map numeric levels to a textual representation, for example " @@ -56912,13 +58263,13 @@ msgid "" msgstr "" # a979d5b9039b4330ace49783dd32b1ed -#: ../src/Doc/library/logging.rst:890 +#: library/logging.rst:896 msgid "" "If you are thinking of defining your own levels, please see the section on :" "ref:`custom-levels`." msgstr "" -#: ../src/Doc/library/logging.rst:895 +#: library/logging.rst:901 msgid "" "Returns the textual representation of logging level *lvl*. If the level is " "one of the predefined levels :const:`CRITICAL`, :const:`ERROR`, :const:" @@ -56931,7 +58282,7 @@ msgid "" msgstr "" # 0887f038a3d94bffa2d6ae0869c7cf20 -#: ../src/Doc/library/logging.rst:903 +#: library/logging.rst:909 msgid "" "Integer levels should be used when e.g. setting levels on instances of :" "class:`Logger` and handlers. This function is used to convert between an " @@ -56940,7 +58291,7 @@ msgid "" "attributes`)." msgstr "" -#: ../src/Doc/library/logging.rst:912 +#: library/logging.rst:918 msgid "" "Creates and returns a new :class:`LogRecord` instance whose attributes are " "defined by *attrdict*. This function is useful for taking a pickled :class:" @@ -56948,7 +58299,7 @@ msgid "" "as a :class:`LogRecord` instance at the receiving end." msgstr "" -#: ../src/Doc/library/logging.rst:920 +#: library/logging.rst:926 msgid "" "Does basic configuration for the logging system by creating a :class:" "`StreamHandler` with a default :class:`Formatter` and adding it to the root " @@ -56957,14 +58308,18 @@ msgid "" "no handlers are defined for the root logger." msgstr "" -#: ../src/Doc/library/logging.rst:926 +#: library/logging.rst:932 msgid "" "This function does nothing if the root logger already has handlers " "configured for it." msgstr "" +#: library/logging.rst:935 +msgid "Formerly, :func:`basicConfig` did not take any keyword arguments." +msgstr "" + # 5fc70754001d417cbb16d7e88b52f979 -#: ../src/Doc/library/logging.rst:932 +#: library/logging.rst:938 msgid "" "This function should be called from the main thread before other threads are " "started. In versions of Python prior to 2.7.1 and 3.2, if this function is " @@ -56973,73 +58328,73 @@ msgid "" "unexpected results such as messages being duplicated in the log." msgstr "" -#: ../src/Doc/library/logging.rst:939 +#: library/logging.rst:945 msgid "The following keyword arguments are supported." msgstr "" -#: ../src/Doc/library/logging.rst:946 +#: library/logging.rst:952 msgid "``filename``" msgstr "" -#: ../src/Doc/library/logging.rst:946 +#: library/logging.rst:952 msgid "" "Specifies that a FileHandler be created, using the specified filename, " "rather than a StreamHandler." msgstr "" -#: ../src/Doc/library/logging.rst:950 +#: library/logging.rst:956 msgid "``filemode``" msgstr "" -#: ../src/Doc/library/logging.rst:950 +#: library/logging.rst:956 msgid "" "Specifies the mode to open the file, if filename is specified (if filemode " "is unspecified, it defaults to 'a')." msgstr "" -#: ../src/Doc/library/logging.rst:954 +#: library/logging.rst:960 msgid "``format``" msgstr "" -#: ../src/Doc/library/logging.rst:954 +#: library/logging.rst:960 msgid "Use the specified format string for the handler." msgstr "" -#: ../src/Doc/library/logging.rst:957 +#: library/logging.rst:963 msgid "``datefmt``" msgstr "" -#: ../src/Doc/library/logging.rst:957 +#: library/logging.rst:963 msgid "Use the specified date/time format." msgstr "" -#: ../src/Doc/library/logging.rst:959 +#: library/logging.rst:965 msgid "``level``" msgstr "" -#: ../src/Doc/library/logging.rst:959 +#: library/logging.rst:965 msgid "Set the root logger level to the specified level." msgstr "" -#: ../src/Doc/library/logging.rst:962 +#: library/logging.rst:968 msgid "``stream``" msgstr "" -#: ../src/Doc/library/logging.rst:962 +#: library/logging.rst:968 msgid "" "Use the specified stream to initialize the StreamHandler. Note that this " "argument is incompatible with 'filename' - if both are present, 'stream' is " "ignored." msgstr "" -#: ../src/Doc/library/logging.rst:971 +#: library/logging.rst:977 msgid "" "Informs the logging system to perform an orderly shutdown by flushing and " "closing all handlers. This should be called at application exit and no " "further use of the logging system should be made after this call." msgstr "" -#: ../src/Doc/library/logging.rst:978 +#: library/logging.rst:984 msgid "" "Tells the logging system to use the class *klass* when instantiating a " "logger. The class should define :meth:`__init__` such that only a name " @@ -57048,23 +58403,23 @@ msgid "" "instantiated by applications which need to use custom logger behavior." msgstr "" -#: ../src/Doc/library/logging.rst:986 +#: library/logging.rst:992 msgid "Integration with the warnings module" msgstr "" -#: ../src/Doc/library/logging.rst:988 +#: library/logging.rst:994 msgid "" "The :func:`captureWarnings` function can be used to integrate :mod:`logging` " "with the :mod:`warnings` module." msgstr "" -#: ../src/Doc/library/logging.rst:993 +#: library/logging.rst:999 msgid "" "This function is used to turn the capture of warnings by logging on and off." msgstr "" # 2121a27f8c3a4dddba2b94b97c532b43 -#: ../src/Doc/library/logging.rst:996 +#: library/logging.rst:1002 msgid "" "If *capture* is ``True``, warnings issued by the :mod:`warnings` module will " "be redirected to the logging system. Specifically, a warning will be " @@ -57074,60 +58429,48 @@ msgid "" msgstr "" # f4e4690142d347a5a614bff5f4796575 -#: ../src/Doc/library/logging.rst:1001 +#: library/logging.rst:1007 msgid "" "If *capture* is ``False``, the redirection of warnings to the logging system " "will stop, and warnings will be redirected to their original destinations (i." "e. those in effect before ``captureWarnings(True)`` was called)." msgstr "" -# 5d8f1e12f03e4136b040659021632a5f -# f2acda4027e8428794a47108e06388ed -#: ../src/Doc/library/logging.rst:1008 -#: ../src/Doc/library/logging.handlers.rst:760 -msgid "Module :mod:`logging.config`" +#: library/logging.rst:1015 library/logging.handlers.rst:762 +msgid "Module logging.config" msgstr "" # 02381bfd31314a138946a2218d2d1fcf # b266787f521c4dec92c3f9fbf76e3512 -#: ../src/Doc/library/logging.rst:1009 -#: ../src/Doc/library/logging.handlers.rst:762 +#: library/logging.rst:1015 library/logging.handlers.rst:763 msgid "Configuration API for the logging module." msgstr "" -# 477d063bddaf4f148d3c9b8dde4839ef -# 485bcc42f82b4fd3a90af3495ef8b919 -#: ../src/Doc/library/logging.rst:1011 -#: ../src/Doc/library/logging.config.rst:738 -msgid "Module :mod:`logging.handlers`" +#: library/logging.rst:1018 library/logging.config.rst:751 +msgid "Module logging.handlers" msgstr "" # aed1815ba55242c18fc7aae82bdf327b # cd6d12487e5c42aab68d63b9f7cd2975 -#: ../src/Doc/library/logging.rst:1012 -#: ../src/Doc/library/logging.config.rst:740 +#: library/logging.rst:1018 library/logging.config.rst:752 msgid "Useful handlers included with the logging module." msgstr "" -# 9eb9af8e9d224cdfa24eae411c0e2ef3 -#: ../src/Doc/library/logging.rst:1015 -msgid ":pep:`282` - A Logging System" +#: library/logging.rst:1022 +msgid "PEP 282 - A Logging System" msgstr "" -#: ../src/Doc/library/logging.rst:1015 +#: library/logging.rst:1021 msgid "" "The proposal which described this feature for inclusion in the Python " "standard library." msgstr "" -# 37661ef389b24d07923e9746593baa55 -#: ../src/Doc/library/logging.rst:1020 -msgid "" -"`Original Python logging package `_" +#: library/logging.rst:1027 +msgid "Original Python logging package" msgstr "" -#: ../src/Doc/library/logging.rst:1019 +#: library/logging.rst:1025 msgid "" "This is the original source for the :mod:`logging` package. The version of " "the package available from this site is suitable for use with Python 1.5.2, " @@ -57136,33 +58479,32 @@ msgid "" msgstr "" # 17d6f1b685244153a0d6ee00c2e15888 -#: ../src/Doc/library/logging.config.rst:2 +#: library/logging.config.rst:2 msgid ":mod:`logging.config` --- Logging configuration" msgstr "" # e0fc4eccda8c4e749bc87085a10e63b8 # 80fd13d82359493d8976fe07aa9d1d0c -#: ../src/Doc/library/logging.config.rst:13 -#: ../src/Doc/library/logging.handlers.rst:13 +#: library/logging.config.rst:13 library/logging.handlers.rst:13 msgid "" "This page contains only reference information. For tutorials, please see" msgstr "" # f37d477db4d04f0697de20bed772a46d -#: ../src/Doc/library/logging.config.rst:20 +#: library/logging.config.rst:20 msgid "**Source code:** :source:`Lib/logging/config.py`" msgstr "" # ce189358f8bd49c2b137139618293450 -#: ../src/Doc/library/logging.config.rst:24 +#: library/logging.config.rst:24 msgid "This section describes the API for configuring the logging module." msgstr "" -#: ../src/Doc/library/logging.config.rst:29 +#: library/logging.config.rst:29 msgid "Configuration functions" msgstr "" -#: ../src/Doc/library/logging.config.rst:31 +#: library/logging.config.rst:31 msgid "" "The following functions configure the logging module. They are located in " "the :mod:`logging.config` module. Their use is optional --- you can " @@ -57171,13 +58513,13 @@ msgid "" "declared either in :mod:`logging` or :mod:`logging.handlers`." msgstr "" -#: ../src/Doc/library/logging.config.rst:39 +#: library/logging.config.rst:39 msgid "" "Takes the logging configuration from a dictionary. The contents of this " "dictionary are described in :ref:`logging-config-dictschema` below." msgstr "" -#: ../src/Doc/library/logging.config.rst:43 +#: library/logging.config.rst:43 msgid "" "If an error is encountered during configuration, this function will raise a :" "exc:`ValueError`, :exc:`TypeError`, :exc:`AttributeError` or :exc:" @@ -57185,33 +58527,33 @@ msgid "" "(possibly incomplete) list of conditions which will raise an error:" msgstr "" -#: ../src/Doc/library/logging.config.rst:49 +#: library/logging.config.rst:49 msgid "" "A ``level`` which is not a string or which is a string not corresponding to " "an actual logging level." msgstr "" -#: ../src/Doc/library/logging.config.rst:51 +#: library/logging.config.rst:51 msgid "A ``propagate`` value which is not a boolean." msgstr "" -#: ../src/Doc/library/logging.config.rst:52 +#: library/logging.config.rst:52 msgid "An id which does not have a corresponding destination." msgstr "" -#: ../src/Doc/library/logging.config.rst:53 +#: library/logging.config.rst:53 msgid "A non-existent handler id found during an incremental call." msgstr "" -#: ../src/Doc/library/logging.config.rst:54 +#: library/logging.config.rst:54 msgid "An invalid logger name." msgstr "" -#: ../src/Doc/library/logging.config.rst:55 +#: library/logging.config.rst:55 msgid "Inability to resolve to an internal or external object." msgstr "" -#: ../src/Doc/library/logging.config.rst:57 +#: library/logging.config.rst:57 msgid "" "Parsing is performed by the :class:`DictConfigurator` class, whose " "constructor is passed the dictionary used for configuration, and has a :meth:" @@ -57221,14 +58563,14 @@ msgid "" "with a suitable implementation of your own." msgstr "" -#: ../src/Doc/library/logging.config.rst:65 +#: library/logging.config.rst:65 msgid "" ":func:`dictConfig` calls :attr:`dictConfigClass` passing the specified " "dictionary, and then calls the :meth:`configure` method on the returned " "object to put the configuration into effect::" msgstr "" -#: ../src/Doc/library/logging.config.rst:72 +#: library/logging.config.rst:72 msgid "" "For example, a subclass of :class:`DictConfigurator` could call " "``DictConfigurator.__init__()`` in its own :meth:`__init__()`, then set up " @@ -57239,7 +58581,7 @@ msgid "" msgstr "" # 25a9b8304e53482a8596e4cc38cba09b -#: ../src/Doc/library/logging.config.rst:83 +#: library/logging.config.rst:83 msgid "" "Reads the logging configuration from a :mod:`configparser`\\-format file " "named *fname*. The format of the file should be as described in :ref:" @@ -57249,8 +58591,28 @@ msgid "" "and load the chosen configuration)." msgstr "" +#: library/logging.config.rst:90 +msgid "" +"Defaults to be passed to the ConfigParser can be specified in this argument." +msgstr "" + +#: library/logging.config.rst:93 +msgid "" +"If specified as ``False``, loggers which exist when this call is made are " +"left enabled. The default is ``True`` because this enables old behaviour in " +"a backward- compatible way. This behaviour is to disable any existing " +"loggers unless they or their ancestors are explicitly named in the logging " +"configuration." +msgstr "" + +#: library/logging.config.rst:102 +msgid "" +"The ``disable_existing_loggers`` keyword argument was added. Previously, " +"existing loggers were *always* disabled." +msgstr "" + # 13a01fc87aad4736bbc32e7cf945f11c -#: ../src/Doc/library/logging.config.rst:108 +#: library/logging.config.rst:108 msgid "" "Starts up a socket server on the specified port, and listens for new " "configurations. If no port is specified, the module's default :const:" @@ -57261,7 +58623,7 @@ msgid "" "when appropriate. To stop the server, call :func:`stopListening`." msgstr "" -#: ../src/Doc/library/logging.config.rst:117 +#: library/logging.config.rst:117 msgid "" "To send a configuration to the socket, read in the configuration file and " "send it to the socket as a string of bytes preceded by a four-byte length " @@ -57269,7 +58631,7 @@ msgid "" msgstr "" # c43828d7dedb42f38f5a90ef88fcd023 -#: ../src/Doc/library/logging.config.rst:123 +#: library/logging.config.rst:123 msgid "" "Because portions of the configuration are passed through :func:`eval`, use " "of this function may open its users to a security risk. While the function " @@ -57285,19 +58647,19 @@ msgid "" "if a different port is used)." msgstr "" -#: ../src/Doc/library/logging.config.rst:139 +#: library/logging.config.rst:139 msgid "" "Stops the listening server which was created with a call to :func:`listen`. " "This is typically called before calling :meth:`join` on the return value " "from :func:`listen`." msgstr "" -#: ../src/Doc/library/logging.config.rst:147 +#: library/logging.config.rst:147 msgid "Configuration dictionary schema" msgstr "" # 4e6b6097bb314760aac76459ba3457ff -#: ../src/Doc/library/logging.config.rst:149 +#: library/logging.config.rst:149 msgid "" "Describing a logging configuration requires listing the various objects to " "create and the connections between them; for example, you may create a " @@ -57310,24 +58672,24 @@ msgid "" "connections` below." msgstr "" -#: ../src/Doc/library/logging.config.rst:161 +#: library/logging.config.rst:161 msgid "Dictionary Schema Details" msgstr "" -#: ../src/Doc/library/logging.config.rst:163 +#: library/logging.config.rst:163 msgid "" "The dictionary passed to :func:`dictConfig` must contain the following keys:" msgstr "" # 53dfd445eb2940e995280a0293c1b0e8 -#: ../src/Doc/library/logging.config.rst:166 +#: library/logging.config.rst:166 msgid "" "*version* - to be set to an integer value representing the schema version. " "The only valid value at present is 1, but having this key allows the schema " "to evolve while still preserving backwards compatibility." msgstr "" -#: ../src/Doc/library/logging.config.rst:171 +#: library/logging.config.rst:171 msgid "" "All other keys are optional, but if present they will be interpreted as " "described below. In all cases below where a 'configuring dict' is " @@ -57338,7 +58700,7 @@ msgid "" msgstr "" # 8deae4a4b9954da28098e772ed7b0688 -#: ../src/Doc/library/logging.config.rst:178 +#: library/logging.config.rst:178 msgid "" "*formatters* - the corresponding value will be a dict in which each key is a " "formatter id and each value is a dict describing how to configure the " @@ -57346,7 +58708,7 @@ msgid "" msgstr "" # 823d4d361e4941be99718abde8b499a2 -#: ../src/Doc/library/logging.config.rst:182 +#: library/logging.config.rst:182 msgid "" "The configuring dict is searched for keys ``format`` and ``datefmt`` (with " "defaults of ``None``) and these are used to construct a :class:`~logging." @@ -57354,14 +58716,14 @@ msgid "" msgstr "" # 409bc390d3044d5bb5f9a884dd567d09 -#: ../src/Doc/library/logging.config.rst:186 +#: library/logging.config.rst:186 msgid "" "*filters* - the corresponding value will be a dict in which each key is a " "filter id and each value is a dict describing how to configure the " "corresponding Filter instance." msgstr "" -#: ../src/Doc/library/logging.config.rst:190 +#: library/logging.config.rst:190 msgid "" "The configuring dict is searched for the key ``name`` (defaulting to the " "empty string) and this is used to construct a :class:`logging.Filter` " @@ -57369,43 +58731,42 @@ msgid "" msgstr "" # 2d4c5caa38fc42d58ef4626472db13a5 -#: ../src/Doc/library/logging.config.rst:194 +#: library/logging.config.rst:194 msgid "" "*handlers* - the corresponding value will be a dict in which each key is a " "handler id and each value is a dict describing how to configure the " "corresponding Handler instance." msgstr "" -#: ../src/Doc/library/logging.config.rst:198 -#: ../src/Doc/library/logging.config.rst:238 +#: library/logging.config.rst:198 library/logging.config.rst:238 msgid "The configuring dict is searched for the following keys:" msgstr "" -#: ../src/Doc/library/logging.config.rst:200 +#: library/logging.config.rst:200 msgid "" "``class`` (mandatory). This is the fully qualified name of the handler " "class." msgstr "" -#: ../src/Doc/library/logging.config.rst:203 +#: library/logging.config.rst:203 msgid "``level`` (optional). The level of the handler." msgstr "" -#: ../src/Doc/library/logging.config.rst:205 +#: library/logging.config.rst:205 msgid "``formatter`` (optional). The id of the formatter for this handler." msgstr "" -#: ../src/Doc/library/logging.config.rst:208 +#: library/logging.config.rst:208 msgid "``filters`` (optional). A list of ids of the filters for this handler." msgstr "" -#: ../src/Doc/library/logging.config.rst:211 +#: library/logging.config.rst:211 msgid "" "All *other* keys are passed through as keyword arguments to the handler's " "constructor. For example, given the snippet::" msgstr "" -#: ../src/Doc/library/logging.config.rst:228 +#: library/logging.config.rst:228 msgid "" "the handler with id ``console`` is instantiated as a :class:`logging." "StreamHandler`, using ``sys.stdout`` as the underlying stream. The handler " @@ -57415,38 +58776,38 @@ msgid "" msgstr "" # ef0a49df2c8045d7a3232999b7982c35 -#: ../src/Doc/library/logging.config.rst:234 +#: library/logging.config.rst:234 msgid "" "*loggers* - the corresponding value will be a dict in which each key is a " "logger name and each value is a dict describing how to configure the " "corresponding Logger instance." msgstr "" -#: ../src/Doc/library/logging.config.rst:240 +#: library/logging.config.rst:240 msgid "``level`` (optional). The level of the logger." msgstr "" -#: ../src/Doc/library/logging.config.rst:242 +#: library/logging.config.rst:242 msgid "``propagate`` (optional). The propagation setting of the logger." msgstr "" -#: ../src/Doc/library/logging.config.rst:244 +#: library/logging.config.rst:244 msgid "``filters`` (optional). A list of ids of the filters for this logger." msgstr "" -#: ../src/Doc/library/logging.config.rst:247 +#: library/logging.config.rst:247 msgid "" "``handlers`` (optional). A list of ids of the handlers for this logger." msgstr "" -#: ../src/Doc/library/logging.config.rst:250 +#: library/logging.config.rst:250 msgid "" "The specified loggers will be configured according to the level, " "propagation, filters and handlers specified." msgstr "" # 5d4a68f1eb7b4a3a81412728cb505adb -#: ../src/Doc/library/logging.config.rst:253 +#: library/logging.config.rst:253 msgid "" "*root* - this will be the configuration for the root logger. Processing of " "the configuration will be as for any logger, except that the ``propagate`` " @@ -57454,7 +58815,7 @@ msgid "" msgstr "" # d395ecfdbaca41a3acc0a56d020fbc90 -#: ../src/Doc/library/logging.config.rst:257 +#: library/logging.config.rst:257 msgid "" "*incremental* - whether the configuration is to be interpreted as " "incremental to the existing configuration. This value defaults to " @@ -57463,14 +58824,14 @@ msgid "" "`fileConfig` API." msgstr "" -#: ../src/Doc/library/logging.config.rst:263 +#: library/logging.config.rst:263 msgid "" "If the specified value is ``True``, the configuration is processed as " "described in the section on :ref:`logging-config-dict-incremental`." msgstr "" # df81a699d40a46318dcf8c92d6232fe7 -#: ../src/Doc/library/logging.config.rst:266 +#: library/logging.config.rst:266 msgid "" "*disable_existing_loggers* - whether any existing loggers are to be " "disabled. This setting mirrors the parameter of the same name in :func:" @@ -57478,11 +58839,11 @@ msgid "" "ignored if *incremental* is ``True``." msgstr "" -#: ../src/Doc/library/logging.config.rst:274 +#: library/logging.config.rst:274 msgid "Incremental Configuration" msgstr "" -#: ../src/Doc/library/logging.config.rst:276 +#: library/logging.config.rst:276 msgid "" "It is difficult to provide complete flexibility for incremental " "configuration. For example, because objects such as filters and formatters " @@ -57490,7 +58851,7 @@ msgid "" "to such anonymous objects when augmenting a configuration." msgstr "" -#: ../src/Doc/library/logging.config.rst:282 +#: library/logging.config.rst:282 msgid "" "Furthermore, there is not a compelling case for arbitrarily altering the " "object graph of loggers, handlers, filters, formatters at run-time, once a " @@ -57501,7 +58862,7 @@ msgid "" "worth the complexity it adds to the implementation." msgstr "" -#: ../src/Doc/library/logging.config.rst:291 +#: library/logging.config.rst:291 msgid "" "Thus, when the ``incremental`` key of a configuration dict is present and is " "``True``, the system will completely ignore any ``formatters`` and " @@ -57510,7 +58871,7 @@ msgid "" "``loggers`` and ``root`` entries." msgstr "" -#: ../src/Doc/library/logging.config.rst:297 +#: library/logging.config.rst:297 msgid "" "Using a value in the configuration dict lets configurations to be sent over " "the wire as pickled dicts to a socket listener. Thus, the logging verbosity " @@ -57518,11 +58879,11 @@ msgid "" "and restart the application." msgstr "" -#: ../src/Doc/library/logging.config.rst:305 +#: library/logging.config.rst:305 msgid "Object connections" msgstr "" -#: ../src/Doc/library/logging.config.rst:307 +#: library/logging.config.rst:307 msgid "" "The schema describes a set of logging objects - loggers, handlers, " "formatters, filters - which are connected to each other in an object graph. " @@ -57538,17 +58899,17 @@ msgid "" "source and the destination object with that id." msgstr "" -#: ../src/Doc/library/logging.config.rst:321 +#: library/logging.config.rst:321 msgid "So, for example, consider the following YAML snippet::" msgstr "" -#: ../src/Doc/library/logging.config.rst:340 +#: library/logging.config.rst:340 msgid "" "(Note: YAML used here because it's a little more readable than the " "equivalent Python source form for the dictionary.)" msgstr "" -#: ../src/Doc/library/logging.config.rst:343 +#: library/logging.config.rst:343 msgid "" "The ids for loggers are the logger names which would be used " "programmatically to obtain a reference to those loggers, e.g. ``foo.bar." @@ -57559,7 +58920,7 @@ msgid "" "configuration call is complete." msgstr "" -#: ../src/Doc/library/logging.config.rst:351 +#: library/logging.config.rst:351 msgid "" "The above snippet indicates that logger named ``foo.bar.baz`` should have " "two handlers attached to it, which are described by the handler ids ``h1`` " @@ -57567,11 +58928,11 @@ msgid "" "the formatter for ``h2`` is that described by id ``precise``." msgstr "" -#: ../src/Doc/library/logging.config.rst:361 +#: library/logging.config.rst:361 msgid "User-defined objects" msgstr "" -#: ../src/Doc/library/logging.config.rst:363 +#: library/logging.config.rst:363 msgid "" "The schema supports user-defined objects for handlers, filters and " "formatters. (Loggers do not need to have different types for different " @@ -57579,7 +58940,7 @@ msgid "" "defined logger classes.)" msgstr "" -#: ../src/Doc/library/logging.config.rst:368 +#: library/logging.config.rst:368 msgid "" "Objects to be configured are described by dictionaries which detail their " "configuration. In some places, the logging system will be able to infer " @@ -57592,7 +58953,7 @@ msgid "" "made available under the special key ``'()'``. Here's a concrete example::" msgstr "" -#: ../src/Doc/library/logging.config.rst:392 +#: library/logging.config.rst:392 msgid "" "The above YAML snippet defines three formatters. The first, with id " "``brief``, is a standard :class:`logging.Formatter` instance with the " @@ -57603,11 +58964,11 @@ msgid "" "configuration sub-dictionaries::" msgstr "" -#: ../src/Doc/library/logging.config.rst:404 +#: library/logging.config.rst:404 msgid "and::" msgstr "" -#: ../src/Doc/library/logging.config.rst:411 +#: library/logging.config.rst:411 msgid "" "respectively, and as these dictionaries do not contain the special key " "``'()'``, the instantiation is inferred from the context: as a result, " @@ -57616,7 +58977,7 @@ msgid "" "is::" msgstr "" -#: ../src/Doc/library/logging.config.rst:424 +#: library/logging.config.rst:424 msgid "" "and this contains the special key ``'()'``, which means that user-defined " "instantiation is wanted. In this case, the specified factory callable will " @@ -57628,7 +58989,7 @@ msgid "" "assumed to be returned by the call::" msgstr "" -#: ../src/Doc/library/logging.config.rst:436 +#: library/logging.config.rst:436 msgid "" "The key ``'()'`` has been used as the special key because it is not a valid " "keyword parameter name, and so will not clash with the names of the keyword " @@ -57636,11 +58997,11 @@ msgid "" "corresponding value is a callable." msgstr "" -#: ../src/Doc/library/logging.config.rst:445 +#: library/logging.config.rst:445 msgid "Access to external objects" msgstr "" -#: ../src/Doc/library/logging.config.rst:447 +#: library/logging.config.rst:447 msgid "" "There are times where a configuration needs to refer to objects external to " "the configuration, for example ``sys.stderr``. If the configuration dict is " @@ -57655,7 +59016,7 @@ msgid "" "import mechanisms." msgstr "" -#: ../src/Doc/library/logging.config.rst:460 +#: library/logging.config.rst:460 msgid "" "The handling of such prefixes is done in a way analogous to protocol " "handling: there is a generic mechanism to look for prefixes which match the " @@ -57665,11 +59026,11 @@ msgid "" "prefix is not recognised, then the string value will be left as-is." msgstr "" -#: ../src/Doc/library/logging.config.rst:472 +#: library/logging.config.rst:472 msgid "Access to internal objects" msgstr "" -#: ../src/Doc/library/logging.config.rst:474 +#: library/logging.config.rst:474 msgid "" "As well as external objects, there is sometimes also a need to refer to " "objects in the configuration. This will be done implicitly by the " @@ -57680,7 +59041,7 @@ msgid "" "and resolve to the appropriate destination object." msgstr "" -#: ../src/Doc/library/logging.config.rst:482 +#: library/logging.config.rst:482 msgid "" "However, a more generic mechanism is needed for user-defined objects which " "are not known to the :mod:`logging` module. For example, consider :class:" @@ -57694,7 +59055,7 @@ msgid "" "resolution system allows the user to specify::" msgstr "" -#: ../src/Doc/library/logging.config.rst:502 +#: library/logging.config.rst:502 msgid "" "The literal string ``'cfg://handlers.file'`` will be resolved in an " "analogous way to strings with the ``ext://`` prefix, but looking in the " @@ -57703,7 +59064,7 @@ msgid "" "format``. Thus, given the following snippet::" msgstr "" -#: ../src/Doc/library/logging.config.rst:518 +#: library/logging.config.rst:518 msgid "" "in the configuration, the string ``'cfg://handlers'`` would resolve to the " "dict with key ``handlers``, the string ``'cfg://handlers.email`` would " @@ -57719,7 +59080,7 @@ msgid "" "needed." msgstr "" -#: ../src/Doc/library/logging.config.rst:532 +#: library/logging.config.rst:532 msgid "" "Given a string ``cfg://handlers.myhandler.mykey.123``, this will resolve to " "``config_dict['handlers']['myhandler']['mykey']['123']``. If the string is " @@ -57730,12 +59091,12 @@ msgid "" msgstr "" # 7d48ebbc3c6a4372994f7d191bd29549 -#: ../src/Doc/library/logging.config.rst:544 +#: library/logging.config.rst:544 msgid "Import resolution and custom importers" msgstr "" # 926c721ef8dd467da516d76ffd82d26c -#: ../src/Doc/library/logging.config.rst:546 +#: library/logging.config.rst:546 msgid "" "Import resolution, by default, uses the builtin :func:`__import__` function " "to do its importing. You may want to replace this with your own importing " @@ -57748,17 +59109,17 @@ msgid "" msgstr "" # 862120d8e7354423a7028bcaa1f423a7 -#: ../src/Doc/library/logging.config.rst:561 +#: library/logging.config.rst:561 msgid "" "You don't need to wrap with :func:`staticmethod` if you're setting the " "import callable on a configurator *instance*." msgstr "" -#: ../src/Doc/library/logging.config.rst:568 +#: library/logging.config.rst:568 msgid "Configuration file format" msgstr "" -#: ../src/Doc/library/logging.config.rst:570 +#: library/logging.config.rst:570 msgid "" "The configuration file format understood by :func:`fileConfig` is based on :" "mod:`configparser` functionality. The file must contain sections called " @@ -57775,17 +59136,30 @@ msgid "" "specified in a section called ``[logger_root]``." msgstr "" -#: ../src/Doc/library/logging.config.rst:583 +#: library/logging.config.rst:585 +msgid "" +"The :func:`fileConfig` API is older than the :func:`dictConfig` API and does " +"not provide functionality to cover certain aspects of logging. For example, " +"you cannot configure :class:`~logging.Filter` objects, which provide for " +"filtering of messages beyond simple integer levels, using :func:" +"`fileConfig`. If you need to have instances of :class:`~logging.Filter` in " +"your logging configuration, you will need to use :func:`dictConfig`. Note " +"that future enhancements to configuration functionality will be added to :" +"func:`dictConfig`, so it's worth considering transitioning to this newer API " +"when it's convenient to do so." +msgstr "" + +#: library/logging.config.rst:595 msgid "Examples of these sections in the file are given below. ::" msgstr "" -#: ../src/Doc/library/logging.config.rst:594 +#: library/logging.config.rst:606 msgid "" "The root logger must specify a level and a list of handlers. An example of a " "root logger section is given below. ::" msgstr "" -#: ../src/Doc/library/logging.config.rst:601 +#: library/logging.config.rst:613 msgid "" "The ``level`` entry can be one of ``DEBUG, INFO, WARNING, ERROR, CRITICAL`` " "or ``NOTSET``. For the root logger only, ``NOTSET`` means that all messages " @@ -57793,7 +59167,7 @@ msgid "" "``logging`` package's namespace." msgstr "" -#: ../src/Doc/library/logging.config.rst:606 +#: library/logging.config.rst:618 msgid "" "The ``handlers`` entry is a comma-separated list of handler names, which " "must appear in the ``[handlers]`` section. These names must appear in the " @@ -57801,13 +59175,13 @@ msgid "" "file." msgstr "" -#: ../src/Doc/library/logging.config.rst:611 +#: library/logging.config.rst:623 msgid "" "For loggers other than the root logger, some additional information is " "required. This is illustrated by the following example. ::" msgstr "" -#: ../src/Doc/library/logging.config.rst:620 +#: library/logging.config.rst:632 msgid "" "The ``level`` and ``handlers`` entries are interpreted as for the root " "logger, except that if a non-root logger's level is specified as ``NOTSET``, " @@ -57820,21 +59194,27 @@ msgid "" "application to get the logger." msgstr "" -#: ../src/Doc/library/logging.config.rst:629 +#: library/logging.config.rst:641 msgid "" "Sections which specify handler configuration are exemplified by the " "following. ::" msgstr "" # 749e5c1d0ead439681cfb186841d83e9 -#: ../src/Doc/library/logging.config.rst:638 +#: library/logging.config.rst:650 msgid "" "The ``class`` entry indicates the handler's class (as determined by :func:" "`eval` in the ``logging`` package's namespace). The ``level`` is interpreted " "as for loggers, and ``NOTSET`` is taken to mean 'log everything'." msgstr "" -#: ../src/Doc/library/logging.config.rst:646 +#: library/logging.config.rst:654 +msgid "" +"Added support for resolving the handler’s class as a dotted module and class " +"name." +msgstr "" + +#: library/logging.config.rst:658 msgid "" "The ``formatter`` entry indicates the key name of the formatter for this " "handler. If blank, a default formatter (``logging._defaultFormatter``) is " @@ -57842,7 +59222,7 @@ msgid "" "and have a corresponding section in the configuration file." msgstr "" -#: ../src/Doc/library/logging.config.rst:651 +#: library/logging.config.rst:663 msgid "" "The ``args`` entry, when :func:`eval`\\ uated in the context of the " "``logging`` package's namespace, is the list of arguments to the constructor " @@ -57850,14 +59230,14 @@ msgid "" "or to the examples below, to see how typical entries are constructed. ::" msgstr "" -#: ../src/Doc/library/logging.config.rst:705 +#: library/logging.config.rst:717 msgid "" "Sections which specify formatter configuration are typified by the " "following. ::" msgstr "" # 1f2ebb3490c04fc1916a0f616c98c553 -#: ../src/Doc/library/logging.config.rst:712 +#: library/logging.config.rst:724 msgid "" "The ``format`` entry is the overall format string, and the ``datefmt`` entry " "is the :func:`strftime`\\ -compatible date/time format string. If empty, " @@ -57869,7 +59249,7 @@ msgid "" msgstr "" # bb931fced82a44b299fae6484ede7d65 -#: ../src/Doc/library/logging.config.rst:720 +#: library/logging.config.rst:732 msgid "" "The ``class`` entry is optional. It indicates the name of the formatter's " "class (as a dotted module and class name.) This option is useful for " @@ -57879,7 +59259,7 @@ msgid "" msgstr "" # 8b9cd247793049d286908faeeb533933 -#: ../src/Doc/library/logging.config.rst:728 +#: library/logging.config.rst:740 msgid "" "Due to the use of :func:`eval` as described above, there are potential " "security risks which result from using the :func:`listen` to send and " @@ -57888,32 +59268,28 @@ msgid "" "`listen` documentation for more information." msgstr "" -# 11edd1cffe724489b2c312360a9ac66e -# fb02937449d64032a0c039f6595a8263 -#: ../src/Doc/library/logging.config.rst:736 -#: ../src/Doc/library/logging.handlers.rst:758 -msgid "Module :mod:`logging`" +#: library/logging.config.rst:749 library/logging.handlers.rst:760 +msgid "Module logging" msgstr "" # 05baf41642b94033b1ebbbb974e96b16 # e0ecd95d8004411c91819abf7ca40e91 -#: ../src/Doc/library/logging.config.rst:737 -#: ../src/Doc/library/logging.handlers.rst:759 +#: library/logging.config.rst:749 library/logging.handlers.rst:760 msgid "API reference for the logging module." msgstr "" # 0eabd6411b3b43edbebb3b1b8d84c703 -#: ../src/Doc/library/logging.handlers.rst:2 +#: library/logging.handlers.rst:2 msgid ":mod:`logging.handlers` --- Logging handlers" msgstr "" # 95a6c5128fdd45e18fd00648a2ec0faf -#: ../src/Doc/library/logging.handlers.rst:20 +#: library/logging.handlers.rst:20 msgid "**Source code:** :source:`Lib/logging/handlers.py`" msgstr "" # d450e322c01248318f97edd471981745 -#: ../src/Doc/library/logging.handlers.rst:26 +#: library/logging.handlers.rst:26 msgid "" "The following useful handlers are provided in the package. Note that three " "of the handlers (:class:`StreamHandler`, :class:`FileHandler` and :class:" @@ -57921,11 +59297,11 @@ msgid "" "have been documented here along with the other handlers." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:34 +#: library/logging.handlers.rst:34 msgid "StreamHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:36 +#: library/logging.handlers.rst:36 msgid "" "The :class:`StreamHandler` class, located in the core :mod:`logging` " "package, sends logging output to streams such as *sys.stdout*, *sys.stderr* " @@ -57933,7 +59309,7 @@ msgid "" "`write` and :meth:`flush` methods)." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:44 +#: library/logging.handlers.rst:44 msgid "" "Returns a new instance of the :class:`StreamHandler` class. If *stream* is " "specified, the instance will use it for logging output; otherwise, *sys." @@ -57941,7 +59317,7 @@ msgid "" msgstr "" # b88365886d4846018cfd1ba518826616 -#: ../src/Doc/library/logging.handlers.rst:51 +#: library/logging.handlers.rst:51 msgid "" "If a formatter is specified, it is used to format the record. The record is " "then written to the stream with a newline terminator. If exception " @@ -57950,25 +59326,25 @@ msgid "" msgstr "" # ba4151e205ea4e82a64e5bdccec3a77a -#: ../src/Doc/library/logging.handlers.rst:59 +#: library/logging.handlers.rst:59 msgid "" "Flushes the stream by calling its :meth:`flush` method. Note that the :meth:" "`close` method is inherited from :class:`~logging.Handler` and so does no " "output, so an explicit :meth:`flush` call may be needed at times." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:66 +#: library/logging.handlers.rst:66 msgid "FileHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:68 +#: library/logging.handlers.rst:68 msgid "" "The :class:`FileHandler` class, located in the core :mod:`logging` package, " "sends logging output to a disk file. It inherits the output functionality " "from :class:`StreamHandler`." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:75 +#: library/logging.handlers.rst:75 msgid "" "Returns a new instance of the :class:`FileHandler` class. The specified file " "is opened and used as the stream for logging. If *mode* is not specified, :" @@ -57978,53 +59354,56 @@ msgid "" "indefinitely." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:86 +#: library/logging.handlers.rst:81 library/logging.handlers.rst:199 +msgid "*delay* was added." +msgstr "" + +#: library/logging.handlers.rst:86 msgid "Closes the file." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:91 +#: library/logging.handlers.rst:91 msgid "Outputs the record to the file." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:97 +#: library/logging.handlers.rst:97 msgid "NullHandler" msgstr "" # 4ba3bc7ba400465aa897f3afe42c3626 -#: ../src/Doc/library/logging.handlers.rst:101 +#: library/logging.handlers.rst:101 msgid "" "The :class:`NullHandler` class, located in the core :mod:`logging` package, " "does not do any formatting or output. It is essentially a 'no-op' handler " "for use by library developers." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:107 +#: library/logging.handlers.rst:107 msgid "Returns a new instance of the :class:`NullHandler` class." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:111 -#: ../src/Doc/library/logging.handlers.rst:115 +#: library/logging.handlers.rst:111 library/logging.handlers.rst:115 msgid "This method does nothing." msgstr "" # 85dc2275067042b4a1d1839d590fabb7 -#: ../src/Doc/library/logging.handlers.rst:119 +#: library/logging.handlers.rst:119 msgid "" "This method returns ``None`` for the lock, since there is no underlying I/O " "to which access needs to be serialized." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:123 +#: library/logging.handlers.rst:123 msgid "" "See :ref:`library-config` for more information on how to use :class:" "`NullHandler`." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:129 +#: library/logging.handlers.rst:129 msgid "WatchedFileHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:135 +#: library/logging.handlers.rst:135 msgid "" "The :class:`WatchedFileHandler` class, located in the :mod:`logging." "handlers` module, is a :class:`FileHandler` which watches the file it is " @@ -58032,7 +59411,7 @@ msgid "" "name." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:139 +#: library/logging.handlers.rst:139 msgid "" "A file change can happen because of usage of programs such as *newsyslog* " "and *logrotate* which perform log file rotation. This handler, intended for " @@ -58043,7 +59422,7 @@ msgid "" msgstr "" # 4b5350d2d6344d0f828a54a0b349ef2e -#: ../src/Doc/library/logging.handlers.rst:146 +#: library/logging.handlers.rst:146 msgid "" "This handler is not appropriate for use under Windows, because under Windows " "open log files cannot be moved or renamed - logging opens the files with " @@ -58052,7 +59431,7 @@ msgid "" "zero for this value." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:155 +#: library/logging.handlers.rst:155 msgid "" "Returns a new instance of the :class:`WatchedFileHandler` class. The " "specified file is opened and used as the stream for logging. If *mode* is " @@ -58062,24 +59441,24 @@ msgid "" "file grows indefinitely." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:164 +#: library/logging.handlers.rst:164 msgid "" "Outputs the record to the file, but first checks to see if the file has " "changed. If it has, the existing stream is flushed and closed and the file " "opened again, before outputting the record to the file." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:171 +#: library/logging.handlers.rst:171 msgid "RotatingFileHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:173 +#: library/logging.handlers.rst:173 msgid "" "The :class:`RotatingFileHandler` class, located in the :mod:`logging." "handlers` module, supports rotation of disk log files." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:179 +#: library/logging.handlers.rst:179 msgid "" "Returns a new instance of the :class:`RotatingFileHandler` class. The " "specified file is opened and used as the stream for logging. If *mode* is " @@ -58089,47 +59468,45 @@ msgid "" "indefinitely." msgstr "" -# b8027697f0134bec81cd58db90002f80 -#: ../src/Doc/library/logging.handlers.rst:185 +#: library/logging.handlers.rst:185 msgid "" "You can use the *maxBytes* and *backupCount* values to allow the file to :" "dfn:`rollover` at a predetermined size. When the size is about to be " "exceeded, the file is closed and a new file is silently opened for output. " "Rollover occurs whenever the current log file is nearly *maxBytes* in " -"length; if *maxBytes* is zero, rollover never occurs. If *backupCount* is " -"non-zero, the system will save old log files by appending the extensions " -"'.1', '.2' etc., to the filename. For example, with a *backupCount* of 5 and " -"a base file name of :file:`app.log`, you would get :file:`app.log`, :file:" -"`app.log.1`, :file:`app.log.2`, up to :file:`app.log.5`. The file being " -"written to is always :file:`app.log`. When this file is filled, it is " -"closed and renamed to :file:`app.log.1`, and if files :file:`app.log.1`, :" -"file:`app.log.2`, etc. exist, then they are renamed to :file:`app.log.2`, :" -"file:`app.log.3` etc. respectively." +"length; if either of *maxBytes* or *backupCount* is zero, rollover never " +"occurs. If *backupCount* is non-zero, the system will save old log files by " +"appending the extensions '.1', '.2' etc., to the filename. For example, with " +"a *backupCount* of 5 and a base file name of :file:`app.log`, you would get :" +"file:`app.log`, :file:`app.log.1`, :file:`app.log.2`, up to :file:`app." +"log.5`. The file being written to is always :file:`app.log`. When this file " +"is filled, it is closed and renamed to :file:`app.log.1`, and if files :file:" +"`app.log.1`, :file:`app.log.2`, etc. exist, then they are renamed to :file:" +"`app.log.2`, :file:`app.log.3` etc. respectively." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:204 -#: ../src/Doc/library/logging.handlers.rst:278 +#: library/logging.handlers.rst:205 library/logging.handlers.rst:279 msgid "Does a rollover, as described above." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:209 +#: library/logging.handlers.rst:210 msgid "" "Outputs the record to the file, catering for rollover as described " "previously." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:215 +#: library/logging.handlers.rst:216 msgid "TimedRotatingFileHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:217 +#: library/logging.handlers.rst:218 msgid "" "The :class:`TimedRotatingFileHandler` class, located in the :mod:`logging." "handlers` module, supports rotation of disk log files at certain timed " "intervals." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:224 +#: library/logging.handlers.rst:225 msgid "" "Returns a new instance of the :class:`TimedRotatingFileHandler` class. The " "specified file is opened and used as the stream for logging. On rotating it " @@ -58137,91 +59514,91 @@ msgid "" "*when* and *interval*." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:229 +#: library/logging.handlers.rst:230 msgid "" "You can use the *when* to specify the type of *interval*. The list of " "possible values is below. Note that they are not case sensitive." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:233 +#: library/logging.handlers.rst:234 msgid "Type of interval" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:235 +#: library/logging.handlers.rst:236 msgid "``'S'``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:235 +#: library/logging.handlers.rst:236 msgid "Seconds" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:237 +#: library/logging.handlers.rst:238 msgid "``'M'``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:237 +#: library/logging.handlers.rst:238 msgid "Minutes" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:239 +#: library/logging.handlers.rst:240 msgid "Hours" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:241 +#: library/logging.handlers.rst:242 msgid "``'D'``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:241 +#: library/logging.handlers.rst:242 msgid "Days" msgstr "" # 90761d273a1c403983c2ddcc2ca0e798 -#: ../src/Doc/library/logging.handlers.rst:243 +#: library/logging.handlers.rst:244 msgid "``'W0'-'W6'``" msgstr "" # 425cdcdcfe4142a2a8166e0f96ee7fdf -#: ../src/Doc/library/logging.handlers.rst:243 +#: library/logging.handlers.rst:244 msgid "Weekday (0=Monday)" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:245 +#: library/logging.handlers.rst:246 msgid "``'midnight'``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:245 +#: library/logging.handlers.rst:246 msgid "Roll over at midnight" msgstr "" # f77d773be3bf4825a409485a757ce8f6 -#: ../src/Doc/library/logging.handlers.rst:248 +#: library/logging.handlers.rst:249 msgid "" "When using weekday-based rotation, specify 'W0' for Monday, 'W1' for " "Tuesday, and so on up to 'W6' for Sunday. In this case, the value passed for " "*interval* isn't used." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:252 +#: library/logging.handlers.rst:253 msgid "" "The system will save old log files by appending extensions to the filename. " "The extensions are date-and-time based, using the strftime format ``%Y-%m-%d_" "%H-%M-%S`` or a leading portion thereof, depending on the rollover interval." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:257 +#: library/logging.handlers.rst:258 msgid "" "When computing the next rollover time for the first time (when the handler " "is created), the last modification time of an existing log file, or else the " "current time, is used to compute when the next rotation will occur." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:261 +#: library/logging.handlers.rst:262 msgid "" "If the *utc* argument is true, times in UTC will be used; otherwise local " "time is used." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:264 +#: library/logging.handlers.rst:265 msgid "" "If *backupCount* is nonzero, at most *backupCount* files will be kept, and " "if more would be created when rollover occurs, the oldest one is deleted. " @@ -58229,41 +59606,45 @@ msgid "" "changing the interval may leave old files lying around." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:269 +#: library/logging.handlers.rst:270 msgid "" "If *delay* is true, then file opening is deferred until the first call to :" "meth:`emit`." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:283 +#: library/logging.handlers.rst:273 +msgid "*delay* and *utc* were added." +msgstr "" + +#: library/logging.handlers.rst:284 msgid "" "Outputs the record to the file, catering for rollover as described above." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:289 +#: library/logging.handlers.rst:290 msgid "SocketHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:291 +#: library/logging.handlers.rst:292 msgid "" "The :class:`SocketHandler` class, located in the :mod:`logging.handlers` " "module, sends logging output to a network socket. The base class uses a TCP " "socket." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:297 +#: library/logging.handlers.rst:298 msgid "" "Returns a new instance of the :class:`SocketHandler` class intended to " "communicate with a remote machine whose address is given by *host* and " "*port*." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:303 +#: library/logging.handlers.rst:304 msgid "Closes the socket." msgstr "" # b26873cbadf5497abd22c2113af226c1 -#: ../src/Doc/library/logging.handlers.rst:308 +#: library/logging.handlers.rst:309 msgid "" "Pickles the record's attribute dictionary and writes it to the socket in " "binary format. If there is an error with the socket, silently drops the " @@ -58272,27 +59653,27 @@ msgid "" "`~logging.LogRecord`, use the :func:`~logging.makeLogRecord` function." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:318 +#: library/logging.handlers.rst:319 msgid "" "Handles an error which has occurred during :meth:`emit`. The most likely " "cause is a lost connection. Closes the socket so that we can retry on the " "next event." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:325 +#: library/logging.handlers.rst:326 msgid "" "This is a factory method which allows subclasses to define the precise type " "of socket they want. The default implementation creates a TCP socket (:const:" "`socket.SOCK_STREAM`)." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:332 +#: library/logging.handlers.rst:333 msgid "" "Pickles the record's attribute dictionary in binary format with a length " "prefix, and returns it ready for transmission across the socket." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:335 +#: library/logging.handlers.rst:336 msgid "" "Note that pickles aren't completely secure. If you are concerned about " "security, you may want to override this method to implement a more secure " @@ -58301,14 +59682,14 @@ msgid "" "objects on the receiving end." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:344 +#: library/logging.handlers.rst:345 msgid "" "Send a pickled string *packet* to the socket. This function allows for " "partial sends which can happen when the network is busy." msgstr "" # 5cf55ab0d95246e987309df4800c652a -#: ../src/Doc/library/logging.handlers.rst:350 +#: library/logging.handlers.rst:351 msgid "" "Tries to create a socket; on failure, uses an exponential back-off " "algorithm. On intial failure, the handler will drop the message it was " @@ -58320,27 +59701,27 @@ msgid "" msgstr "" # 2d016af5cfc247548e489c49b085744a -#: ../src/Doc/library/logging.handlers.rst:358 +#: library/logging.handlers.rst:359 msgid "This behaviour is controlled by the following handler attributes:" msgstr "" # 4848b5ec45844f00aa61099f919306a3 -#: ../src/Doc/library/logging.handlers.rst:360 +#: library/logging.handlers.rst:361 msgid "``retryStart`` (initial delay, defaulting to 1.0 seconds)." msgstr "" # 2a863a1566cc4211ad3b1440ed00c234 -#: ../src/Doc/library/logging.handlers.rst:361 +#: library/logging.handlers.rst:362 msgid "``retryFactor`` (multiplier, defaulting to 2.0)." msgstr "" # 1cf86ae0cf8b41729ca9a977bbb5f242 -#: ../src/Doc/library/logging.handlers.rst:362 +#: library/logging.handlers.rst:363 msgid "``retryMax`` (maximum delay, defaulting to 30.0 seconds)." msgstr "" # b342601e71284165920dad24e7c78dff -#: ../src/Doc/library/logging.handlers.rst:364 +#: library/logging.handlers.rst:365 msgid "" "This means that if the remote listener starts up *after* the handler has " "been used, you could lose messages (since the handler won't even attempt a " @@ -58348,18 +59729,18 @@ msgid "" "during the delay period)." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:373 +#: library/logging.handlers.rst:374 msgid "DatagramHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:375 +#: library/logging.handlers.rst:376 msgid "" "The :class:`DatagramHandler` class, located in the :mod:`logging.handlers` " "module, inherits from :class:`SocketHandler` to support sending logging " "messages over UDP sockets." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:382 +#: library/logging.handlers.rst:383 msgid "" "Returns a new instance of the :class:`DatagramHandler` class intended to " "communicate with a remote machine whose address is given by *host* and " @@ -58367,7 +59748,7 @@ msgid "" msgstr "" # 5f8bf994cba64acaa5989a5765f38581 -#: ../src/Doc/library/logging.handlers.rst:388 +#: library/logging.handlers.rst:389 msgid "" "Pickles the record's attribute dictionary and writes it to the socket in " "binary format. If there is an error with the socket, silently drops the " @@ -58375,28 +59756,28 @@ msgid "" "LogRecord`, use the :func:`~logging.makeLogRecord` function." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:397 +#: library/logging.handlers.rst:398 msgid "" "The factory method of :class:`SocketHandler` is here overridden to create a " "UDP socket (:const:`socket.SOCK_DGRAM`)." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:403 +#: library/logging.handlers.rst:404 msgid "Send a pickled string to a socket." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:409 +#: library/logging.handlers.rst:410 msgid "SysLogHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:411 +#: library/logging.handlers.rst:412 msgid "" "The :class:`SysLogHandler` class, located in the :mod:`logging.handlers` " "module, supports sending logging messages to a remote or local Unix syslog." msgstr "" # de147dda0ee6465c80d4e542f728ab60 -#: ../src/Doc/library/logging.handlers.rst:417 +#: library/logging.handlers.rst:418 msgid "" "Returns a new instance of the :class:`SysLogHandler` class intended to " "communicate with a remote Unix machine whose address is given by *address* " @@ -58412,7 +59793,7 @@ msgid "" msgstr "" # 861ab6ec78f248bbaef3df931918514e -#: ../src/Doc/library/logging.handlers.rst:429 +#: library/logging.handlers.rst:430 msgid "" "Note that if your server is not listening on UDP port 514, :class:" "`SysLogHandler` may appear not to work. In that case, check what address you " @@ -58423,273 +59804,275 @@ msgid "" "platforms). On Windows, you pretty much have to use the UDP option." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:444 +#: library/logging.handlers.rst:439 +msgid "*socktype* was added." +msgstr "" + +#: library/logging.handlers.rst:445 msgid "Closes the socket to the remote host." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:449 +#: library/logging.handlers.rst:450 msgid "" "The record is formatted, and then sent to the syslog server. If exception " "information is present, it is *not* sent to the server." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:455 +#: library/logging.handlers.rst:456 msgid "" "Encodes the facility and priority into an integer. You can pass in strings " "or integers - if strings are passed, internal mapping dictionaries are used " "to convert them to integers." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:459 +#: library/logging.handlers.rst:460 msgid "" "The symbolic ``LOG_`` values are defined in :class:`SysLogHandler` and " "mirror the values defined in the ``sys/syslog.h`` header file." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:462 +#: library/logging.handlers.rst:463 msgid "**Priorities**" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:465 -#: ../src/Doc/library/logging.handlers.rst:487 +#: library/logging.handlers.rst:466 library/logging.handlers.rst:488 msgid "Name (string)" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:465 -#: ../src/Doc/library/logging.handlers.rst:487 +#: library/logging.handlers.rst:466 library/logging.handlers.rst:488 msgid "Symbolic value" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:467 +#: library/logging.handlers.rst:468 msgid "``alert``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:467 +#: library/logging.handlers.rst:468 msgid "LOG_ALERT" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:469 +#: library/logging.handlers.rst:470 msgid "``crit`` or ``critical``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:469 +#: library/logging.handlers.rst:470 msgid "LOG_CRIT" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:471 +#: library/logging.handlers.rst:472 msgid "``debug``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:471 +#: library/logging.handlers.rst:472 msgid "LOG_DEBUG" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:473 +#: library/logging.handlers.rst:474 msgid "``emerg`` or ``panic``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:473 +#: library/logging.handlers.rst:474 msgid "LOG_EMERG" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:475 +#: library/logging.handlers.rst:476 msgid "``err`` or ``error``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:475 +#: library/logging.handlers.rst:476 msgid "LOG_ERR" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:477 +#: library/logging.handlers.rst:478 msgid "``info``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:477 +#: library/logging.handlers.rst:478 msgid "LOG_INFO" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:479 +#: library/logging.handlers.rst:480 msgid "``notice``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:479 +#: library/logging.handlers.rst:480 msgid "LOG_NOTICE" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:481 +#: library/logging.handlers.rst:482 msgid "``warn`` or ``warning``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:481 +#: library/logging.handlers.rst:482 msgid "LOG_WARNING" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:484 +#: library/logging.handlers.rst:485 msgid "**Facilities**" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:489 +#: library/logging.handlers.rst:490 msgid "``auth``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:489 +#: library/logging.handlers.rst:490 msgid "LOG_AUTH" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:491 +#: library/logging.handlers.rst:492 msgid "``authpriv``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:491 +#: library/logging.handlers.rst:492 msgid "LOG_AUTHPRIV" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:493 +#: library/logging.handlers.rst:494 msgid "``cron``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:493 +#: library/logging.handlers.rst:494 msgid "LOG_CRON" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:495 +#: library/logging.handlers.rst:496 msgid "``daemon``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:495 +#: library/logging.handlers.rst:496 msgid "LOG_DAEMON" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:497 +#: library/logging.handlers.rst:498 msgid "``ftp``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:497 +#: library/logging.handlers.rst:498 msgid "LOG_FTP" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:499 +#: library/logging.handlers.rst:500 msgid "``kern``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:499 +#: library/logging.handlers.rst:500 msgid "LOG_KERN" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:501 +#: library/logging.handlers.rst:502 msgid "``lpr``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:501 +#: library/logging.handlers.rst:502 msgid "LOG_LPR" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:503 +#: library/logging.handlers.rst:504 msgid "``mail``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:503 +#: library/logging.handlers.rst:504 msgid "LOG_MAIL" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:505 +#: library/logging.handlers.rst:506 msgid "``news``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:505 +#: library/logging.handlers.rst:506 msgid "LOG_NEWS" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:507 +#: library/logging.handlers.rst:508 msgid "``syslog``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:507 +#: library/logging.handlers.rst:508 msgid "LOG_SYSLOG" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:509 +#: library/logging.handlers.rst:510 msgid "``user``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:509 +#: library/logging.handlers.rst:510 msgid "LOG_USER" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:511 +#: library/logging.handlers.rst:512 msgid "``uucp``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:511 +#: library/logging.handlers.rst:512 msgid "LOG_UUCP" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:513 +#: library/logging.handlers.rst:514 msgid "``local0``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:513 +#: library/logging.handlers.rst:514 msgid "LOG_LOCAL0" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:515 +#: library/logging.handlers.rst:516 msgid "``local1``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:515 +#: library/logging.handlers.rst:516 msgid "LOG_LOCAL1" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:517 +#: library/logging.handlers.rst:518 msgid "``local2``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:517 +#: library/logging.handlers.rst:518 msgid "LOG_LOCAL2" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:519 +#: library/logging.handlers.rst:520 msgid "``local3``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:519 +#: library/logging.handlers.rst:520 msgid "LOG_LOCAL3" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:521 +#: library/logging.handlers.rst:522 msgid "``local4``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:521 +#: library/logging.handlers.rst:522 msgid "LOG_LOCAL4" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:523 +#: library/logging.handlers.rst:524 msgid "``local5``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:523 +#: library/logging.handlers.rst:524 msgid "LOG_LOCAL5" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:525 +#: library/logging.handlers.rst:526 msgid "``local6``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:525 +#: library/logging.handlers.rst:526 msgid "LOG_LOCAL6" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:527 +#: library/logging.handlers.rst:528 msgid "``local7``" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:527 +#: library/logging.handlers.rst:528 msgid "LOG_LOCAL7" msgstr "" # 72de546d844b4cda8064ee1ffa94f047 -#: ../src/Doc/library/logging.handlers.rst:532 +#: library/logging.handlers.rst:533 msgid "" "Maps a logging level name to a syslog priority name. You may need to " "override this if you are using custom levels, or if the default algorithm is " @@ -58698,11 +60081,11 @@ msgid "" "all other level names to 'warning'." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:542 +#: library/logging.handlers.rst:543 msgid "NTEventLogHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:544 +#: library/logging.handlers.rst:545 msgid "" "The :class:`NTEventLogHandler` class, located in the :mod:`logging.handlers` " "module, supports sending logging messages to a local Windows NT, Windows " @@ -58710,7 +60093,7 @@ msgid "" "Win32 extensions for Python installed." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:552 +#: library/logging.handlers.rst:553 msgid "" "Returns a new instance of the :class:`NTEventLogHandler` class. The " "*appname* is used to define the application name as it appears in the event " @@ -58726,7 +60109,7 @@ msgid "" "or ``'Security'``, and defaults to ``'Application'``." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:568 +#: library/logging.handlers.rst:569 msgid "" "At this point, you can remove the application name from the registry as a " "source of event log entries. However, if you do this, you will not be able " @@ -58735,19 +60118,19 @@ msgid "" "not do this." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:577 +#: library/logging.handlers.rst:578 msgid "" "Determines the message ID, event category and event type, and then logs the " "message in the NT event log." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:583 +#: library/logging.handlers.rst:584 msgid "" "Returns the event category for the record. Override this if you want to " "specify your own categories. This version returns 0." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:589 +#: library/logging.handlers.rst:590 msgid "" "Returns the event type for the record. Override this if you want to specify " "your own types. This version does a mapping using the handler's typemap " @@ -58758,7 +60141,7 @@ msgid "" "the handler's *typemap* attribute." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:600 +#: library/logging.handlers.rst:601 msgid "" "Returns the message ID for the record. If you are using your own messages, " "you could do this by having the *msg* passed to the logger being an ID " @@ -58767,17 +60150,17 @@ msgid "" "message ID in :file:`win32service.pyd`." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:609 +#: library/logging.handlers.rst:610 msgid "SMTPHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:611 +#: library/logging.handlers.rst:612 msgid "" "The :class:`SMTPHandler` class, located in the :mod:`logging.handlers` " "module, supports sending logging messages to an email address via SMTP." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:617 +#: library/logging.handlers.rst:618 msgid "" "Returns a new instance of the :class:`SMTPHandler` class. The instance is " "initialized with the from and to addresses and subject line of the email. " @@ -58789,7 +60172,7 @@ msgid "" msgstr "" # 67591cf0fef0499bbdf28a6b1efe4c8b -#: ../src/Doc/library/logging.handlers.rst:625 +#: library/logging.handlers.rst:626 msgid "" "To specify the use of a secure protocol (TLS), pass in a tuple to the " "*secure* argument. This will only be used when authentication credentials " @@ -58799,21 +60182,29 @@ msgid "" "SMTP.starttls` method.)" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:641 +#: library/logging.handlers.rst:633 +msgid "*credentials* was added." +msgstr "" + +#: library/logging.handlers.rst:636 +msgid "*secure* was added." +msgstr "" + +#: library/logging.handlers.rst:642 msgid "Formats the record and sends it to the specified addressees." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:646 +#: library/logging.handlers.rst:647 msgid "" "If you want to specify a subject line which is record-dependent, override " "this method." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:652 +#: library/logging.handlers.rst:653 msgid "MemoryHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:654 +#: library/logging.handlers.rst:655 msgid "" "The :class:`MemoryHandler` class, located in the :mod:`logging.handlers` " "module, supports buffering of logging records in memory, periodically " @@ -58822,7 +60213,7 @@ msgid "" msgstr "" # eacacec5dece4124a97b4bd06ce2f8e8 -#: ../src/Doc/library/logging.handlers.rst:659 +#: library/logging.handlers.rst:660 msgid "" ":class:`MemoryHandler` is a subclass of the more general :class:" "`BufferingHandler`, which is an abstract class. This buffers logging records " @@ -58831,29 +60222,29 @@ msgid "" "should, then :meth:`flush` is expected to do the flushing." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:668 +#: library/logging.handlers.rst:669 msgid "Initializes the handler with a buffer of the specified capacity." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:673 +#: library/logging.handlers.rst:674 msgid "" "Appends the record to the buffer. If :meth:`shouldFlush` returns true, " "calls :meth:`flush` to process the buffer." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:679 +#: library/logging.handlers.rst:680 msgid "" "You can override this to implement custom flushing behavior. This version " "just zaps the buffer to empty." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:685 +#: library/logging.handlers.rst:686 msgid "" "Returns true if the buffer is up to capacity. This method can be overridden " "to implement custom flushing strategies." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:691 +#: library/logging.handlers.rst:692 msgid "" "Returns a new instance of the :class:`MemoryHandler` class. The instance is " "initialized with a buffer size of *capacity*. If *flushLevel* is not " @@ -58862,32 +60253,32 @@ msgid "" "anything useful." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:699 +#: library/logging.handlers.rst:700 msgid "" "Calls :meth:`flush`, sets the target to :const:`None` and clears the buffer." msgstr "" # 9ab562dc02a4452fbbe8a12a0311d022 -#: ../src/Doc/library/logging.handlers.rst:705 +#: library/logging.handlers.rst:706 msgid "" "For a :class:`MemoryHandler`, flushing means just sending the buffered " "records to the target, if there is one. The buffer is also cleared when this " "happens. Override if you want different behavior." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:712 +#: library/logging.handlers.rst:713 msgid "Sets the target handler for this handler." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:717 +#: library/logging.handlers.rst:718 msgid "Checks for buffer full or a record at the *flushLevel* or higher." msgstr "" -#: ../src/Doc/library/logging.handlers.rst:723 +#: library/logging.handlers.rst:724 msgid "HTTPHandler" msgstr "" -#: ../src/Doc/library/logging.handlers.rst:725 +#: library/logging.handlers.rst:726 msgid "" "The :class:`HTTPHandler` class, located in the :mod:`logging.handlers` " "module, supports sending logging messages to a Web server, using either " @@ -58895,14 +60286,14 @@ msgid "" msgstr "" # 4908e0915d914d67b6c0f5cfa95781ef -#: ../src/Doc/library/logging.handlers.rst:732 +#: library/logging.handlers.rst:733 msgid "" "Returns a new instance of the :class:`HTTPHandler` class. The ``host`` can " "be of the form ``host:port``, should you need to use a specific port number." msgstr "" # c02a7afb161b49318ea4333e911eb8db -#: ../src/Doc/library/logging.handlers.rst:737 +#: library/logging.handlers.rst:738 msgid "" "Provides a dictionary, based on ``record``, which is to be URL-encoded and " "sent to the web server. The default implementation just returns ``record." @@ -58912,7 +60303,7 @@ msgid "" msgstr "" # a86f3e844f9a47fcb97cf8bfb872dcaf -#: ../src/Doc/library/logging.handlers.rst:745 +#: library/logging.handlers.rst:746 msgid "" "Sends the record to the Web server as an URL-encoded dictionary. The :meth:" "`mapLogRecord` method is used to convert the record to the dictionary to be " @@ -58920,7 +60311,7 @@ msgid "" msgstr "" # f2bf341011d34093ad68da9e1731f2ba -#: ../src/Doc/library/logging.handlers.rst:749 +#: library/logging.handlers.rst:750 msgid "" "Since preparing a record for sending it to a Web server is not the same as a " "generic formatting operation, using :meth:`setFormatter` to specify a :class:" @@ -58931,19 +60322,19 @@ msgid "" msgstr "" # 1085e61b8673434e9da61d3df31ccd70 -#: ../src/Doc/library/mac.rst:5 +#: library/mac.rst:5 msgid "Mac OS X specific services" msgstr "" # 12ef98dfd62c4073b87add31bf3951c1 -#: ../src/Doc/library/mac.rst:7 +#: library/mac.rst:7 msgid "" "This chapter describes modules that are only available on the Mac OS X " "platform." msgstr "" # 6b9b0fd2f41041c3bf316ee47ed7cc9f -#: ../src/Doc/library/mac.rst:9 +#: library/mac.rst:9 msgid "" "See the chapters :ref:`mac-scripting` and :ref:`undoc-mac-modules` for more " "modules, and the HOWTO :ref:`using-on-mac` for a general introduction to Mac-" @@ -58951,7 +60342,7 @@ msgid "" msgstr "" # d61b69dbb6884be3a63948a9113dfbf9 -#: ../src/Doc/library/mac.rst:15 +#: library/mac.rst:15 msgid "" "Most of the OS X APIs that these modules use are deprecated or removed in " "recent versions of OS X. Many are not available when Python is executing in " @@ -58960,12 +60351,12 @@ msgid "" msgstr "" # 2d7459f641644faeb6f2ca61f699c35d -#: ../src/Doc/library/macos.rst:2 +#: library/macos.rst:2 msgid ":mod:`MacOS` --- Access to Mac OS interpreter features" msgstr "" # 7ab97c35bb9f450d9b4a715253b3f2da -#: ../src/Doc/library/macos.rst:10 +#: library/macos.rst:10 msgid "" "This module provides access to MacOS specific functionality in the Python " "interpreter, such as how the interpreter eventloop functions and the like. " @@ -58973,13 +60364,13 @@ msgid "" msgstr "" # 4f9d668d79c144cd890c6cc3f9f12082 -#: ../src/Doc/library/macos.rst:18 +#: library/macos.rst:18 msgid "" "Note the capitalization of the module name; this is a historical artifact." msgstr "" # 6b9eeb12b2a44b1ebe298c3ca3d92896 -#: ../src/Doc/library/macos.rst:23 +#: library/macos.rst:23 msgid "" "Always ``'macho'``, from Python 2.4 on. In earlier versions of Python the " "value could also be ``'ppc'`` for the classic Mac OS 8 runtime model or " @@ -58987,7 +60378,7 @@ msgid "" msgstr "" # db7513ffe75141588c0d00061e23bf6b -#: ../src/Doc/library/macos.rst:30 +#: library/macos.rst:30 msgid "" "The way the interpreter has been linked. As extension modules may be " "incompatible between linking models, packages could use this information to " @@ -58998,7 +60389,7 @@ msgid "" msgstr "" # adfaf188461a4b7880364e7ad6bcd157 -#: ../src/Doc/library/macos.rst:42 +#: library/macos.rst:42 msgid "" "This exception is raised on MacOS generated errors, either from functions in " "this module or from other mac-specific modules like the toolbox interfaces. " @@ -59008,12 +60399,12 @@ msgid "" msgstr "" # 5057c54068734e7b9fa76311ecce8b53 -#: ../src/Doc/library/macos.rst:51 +#: library/macos.rst:51 msgid "Return the textual description of MacOS error code *errno*." msgstr "" # 2cb1943f89c845509101c1d144b4bbed -#: ../src/Doc/library/macos.rst:56 +#: library/macos.rst:56 msgid "" "On Mac OS X the string is simply printed to stderr (on older Mac OS systems " "more elaborate functionality was available), but it provides a convenient " @@ -59023,23 +60414,22 @@ msgstr "" # f0c013f69ecf4a8c95d947d2272e1bd6 # a3ef62a2d4934bcdbcf4bfa478a27cf6 # 9b59f3c3ae694675a090b6f5db438330 -#: ../src/Doc/library/macos.rst:62 ../src/Doc/library/macos.rst:71 -#: ../src/Doc/library/macos.rst:122 +#: library/macos.rst:62 library/macos.rst:71 library/macos.rst:122 msgid "Not available in 64-bit mode." msgstr "" # af8fd49846164a099e3f8b5c10e1d261 -#: ../src/Doc/library/macos.rst:67 +#: library/macos.rst:67 msgid "Ring the bell." msgstr "" # e74da3728415410d86af374c5ab73517 -#: ../src/Doc/library/macos.rst:76 +#: library/macos.rst:76 msgid "Get the number of clock ticks (1/60th of a second) since system boot." msgstr "" # aa10636a88884161b056035660684c89 -#: ../src/Doc/library/macos.rst:81 +#: library/macos.rst:81 msgid "" "Return the file creator and file type as two four-character strings. The " "*file* parameter can be a pathname or an ``FSSpec`` or ``FSRef`` object." @@ -59047,12 +60437,12 @@ msgstr "" # c1babad67c6f4351a6fa633f77460a4c # 422c2b1f95ab4f7d8c6664f4808a08b9 -#: ../src/Doc/library/macos.rst:86 ../src/Doc/library/macos.rst:97 +#: library/macos.rst:86 library/macos.rst:97 msgid "It is not possible to use an ``FSSpec`` in 64-bit mode." msgstr "" # b902ccfc7d4943edace297978ed97861 -#: ../src/Doc/library/macos.rst:91 +#: library/macos.rst:91 msgid "" "Set the file creator and file type. The *file* parameter can be a pathname " "or an ``FSSpec`` or ``FSRef`` object. *creator* and *type* must be four " @@ -59060,7 +60450,7 @@ msgid "" msgstr "" # 9cf7eef526c94e79a7e1e71eb9b1b697 -#: ../src/Doc/library/macos.rst:101 +#: library/macos.rst:101 msgid "" "Open the resource fork of a file. Arguments are the same as for the built-in " "function :func:`open`. The object returned has file-like semantics, but it " @@ -59068,7 +60458,7 @@ msgid "" msgstr "" # 8f392a77a08140c89bc78f79f4e8eea4 -#: ../src/Doc/library/macos.rst:108 +#: library/macos.rst:108 msgid "" "Checks whether the current process has access to the window manager. The " "method will return ``False`` if the window manager is not available, for " @@ -59080,19 +60470,19 @@ msgid "" msgstr "" # 1d1664732e8d4f439c15d73b6e83fbed -#: ../src/Doc/library/macos.rst:117 +#: library/macos.rst:117 msgid "" "Opens a splash screen by resource id. Use resourceid ``0`` to close the " "splash screen." msgstr "" # 508198342be4420eb289710001c193df -#: ../src/Doc/library/macosa.rst:6 +#: library/macosa.rst:6 msgid "MacPython OSA Modules" msgstr "" # 625820153dd94c14a321cbce56766d5f -#: ../src/Doc/library/macosa.rst:8 +#: library/macosa.rst:8 msgid "" "This chapter describes the current implementation of the Open Scripting " "Architecture (OSA, also commonly referred to as AppleScript) for Python, " @@ -59102,7 +60492,7 @@ msgid "" msgstr "" # fccbab37aca44c7f92db3ab3614b8206 -#: ../src/Doc/library/macosa.rst:14 +#: library/macosa.rst:14 msgid "" "For a description of the various components of AppleScript and OSA, and to " "get an understanding of the architecture and terminology, you should read " @@ -59114,7 +60504,7 @@ msgid "" msgstr "" # 54e281a9b916427faa6a07ff8ddcb76d -#: ../src/Doc/library/macosa.rst:22 +#: library/macosa.rst:22 msgid "" "As an example of scripting an application, the following piece of " "AppleScript will get the name of the frontmost :program:`Finder` window and " @@ -59122,12 +60512,12 @@ msgid "" msgstr "" # a70872d1f0684f05ad2ea306e104cadd -#: ../src/Doc/library/macosa.rst:29 +#: library/macosa.rst:29 msgid "In Python, the following code fragment will do the same::" msgstr "" # c4ae168f12794baaaeea19070d460eff -#: ../src/Doc/library/macosa.rst:36 +#: library/macosa.rst:36 msgid "" "As distributed the Python library includes packages that implement the " "standard suites, plus packages that interface to a small number of common " @@ -59135,7 +60525,7 @@ msgid "" msgstr "" # e9dfade38f4e4857a0159a9bb7903082 -#: ../src/Doc/library/macosa.rst:39 +#: library/macosa.rst:39 msgid "" "To send AppleEvents to an application you must first create the Python " "package interfacing to the terminology of the application (what :program:" @@ -59145,7 +60535,7 @@ msgid "" msgstr "" # 22a40a0063224faa90605be9796533c2 -#: ../src/Doc/library/macosa.rst:45 +#: library/macosa.rst:45 msgid "" "The generated output is a package with a number of modules, one for every " "suite used in the program plus an :mod:`__init__` module to glue it all " @@ -59161,7 +60551,7 @@ msgid "" msgstr "" # 057b59aae0e844eebd74ef866b54160d -#: ../src/Doc/library/macosa.rst:56 +#: library/macosa.rst:56 msgid "" "The output package implements a main class with the same name as the package " "which contains all the AppleScript verbs as methods, with the direct object " @@ -59171,7 +60561,7 @@ msgid "" msgstr "" # 89bd6620322a43df9137163a4824f6a0 -#: ../src/Doc/library/macosa.rst:62 +#: library/macosa.rst:62 msgid "" "The main Python class implementing the verbs also allows access to the " "properties and elements declared in the AppleScript class \"application\". " @@ -59181,38 +60571,38 @@ msgid "" msgstr "" # f7d159648e4e468abdd598962d9ede43 -#: ../src/Doc/library/macosa.rst:68 +#: library/macosa.rst:68 msgid "" "If an AppleScript identifier is not a Python identifier the name is mangled " "according to a small number of rules:" msgstr "" # 1d6006c97b8c48319e4e5b8ce995f90f -#: ../src/Doc/library/macosa.rst:71 +#: library/macosa.rst:71 msgid "spaces are replaced with underscores" msgstr "" # 7a13e2d1cd704a71bf3f67b38c327fc9 -#: ../src/Doc/library/macosa.rst:73 +#: library/macosa.rst:73 msgid "" "other non-alphanumeric characters are replaced with ``_xx_`` where ``xx`` is " "the hexadecimal character value" msgstr "" # c1c70be9020741f282a13390421d3f0d -#: ../src/Doc/library/macosa.rst:76 +#: library/macosa.rst:76 msgid "any Python reserved word gets an underscore appended" msgstr "" # 70dc47f2dd8945498dc401a0c4e91063 -#: ../src/Doc/library/macosa.rst:78 +#: library/macosa.rst:78 msgid "" "Python also has support for creating scriptable applications in Python, but " "The following modules are relevant to MacPython AppleScript support:" msgstr "" # cdea16c701564f9d896c5024863d5979 -#: ../src/Doc/library/macosa.rst:90 +#: library/macosa.rst:90 msgid "" "In addition, support modules have been pre-generated for :mod:`Finder`, :mod:" "`Terminal`, :mod:`Explorer`, :mod:`Netscape`, :mod:`CodeWarrior`, :mod:" @@ -59220,12 +60610,12 @@ msgid "" msgstr "" # 817e4832d1f5494cb8e1ce31fcfe8563 -#: ../src/Doc/library/macostools.rst:3 +#: library/macostools.rst:3 msgid ":mod:`macostools` --- Convenience routines for file manipulation" msgstr "" # 0b4f1073f60a440d8033fe70a77a7d96 -#: ../src/Doc/library/macostools.rst:11 +#: library/macostools.rst:11 msgid "" "This module contains some convenience routines for file-manipulation on the " "Macintosh. All file parameters can be specified as pathnames, :class:`FSRef` " @@ -59234,17 +60624,17 @@ msgid "" msgstr "" # 68c4fa7057fd45c19b1ffa0ae0f52c8e -#: ../src/Doc/library/macostools.rst:18 +#: library/macostools.rst:18 msgid "This module has been removed in Python 3." msgstr "" # 6c00e4f30bc14b749acbb21751771fdf -#: ../src/Doc/library/macostools.rst:22 +#: library/macostools.rst:22 msgid "The :mod:`macostools` module defines the following functions:" msgstr "" # f5f74ddc8322442f816e54e6c501f29c -#: ../src/Doc/library/macostools.rst:27 +#: library/macostools.rst:27 msgid "" "Copy file *src* to *dst*. If *createpath* is non-zero the folders leading " "to *dst* are created if necessary. The method copies data and resource fork " @@ -59256,40 +60646,44 @@ msgstr "" # 9f82b19d5b574bc6b0671ddb543bdf43 # a6ca96487b864f05854673bd7fac36d9 # df85bc435a464e81b22db34feb6970df -#: ../src/Doc/library/macostools.rst:35 ../src/Doc/library/macostools.rst:45 -#: ../src/Doc/library/macostools.rst:54 +#: library/macostools.rst:35 library/macostools.rst:45 +#: library/macostools.rst:54 msgid "" "This function does not work in 64-bit code because it uses APIs that are not " "available in 64-bit mode." msgstr "" # 99826d1bcae94bf9b33567112f898390 -#: ../src/Doc/library/macostools.rst:40 +#: library/macostools.rst:40 msgid "" "Recursively copy a file tree from *src* to *dst*, creating folders as " "needed. *src* and *dst* should be specified as pathnames." msgstr "" # 477eee5dd2d4421691f16d029ebbd5e7 -#: ../src/Doc/library/macostools.rst:50 +#: library/macostools.rst:50 msgid "Create a finder alias *dst* pointing to *src*." msgstr "" # 0f62daf0a4e044d59972cee255af18d2 -#: ../src/Doc/library/macostools.rst:60 +#: library/macostools.rst:60 msgid "" "Tell the finder that some bits of finder-information such as creator or type " "for file *dst* has changed. The file can be specified by pathname or fsspec. " "This call should tell the finder to redraw the files icon." msgstr "" +#: library/macostools.rst:64 +msgid "The function is a no-op on OS X." +msgstr "" + # f38bf9e7f87a49999d79e988156b0bf8 -#: ../src/Doc/library/macostools.rst:70 +#: library/macostools.rst:70 msgid "The buffer size for ``copy``, default 1 megabyte." msgstr "" # ff3a0934a3024c679865d4c4af76852e -#: ../src/Doc/library/macostools.rst:72 +#: library/macostools.rst:72 msgid "" "Note that the process of creating finder aliases is not specified in the " "Apple documentation. Hence, aliases created with :func:`mkalias` could " @@ -59297,12 +60691,12 @@ msgid "" msgstr "" # 180813fb57274a29b5b811c850d48045 -#: ../src/Doc/library/macostools.rst:78 +#: library/macostools.rst:78 msgid ":mod:`findertools` --- The :program:`finder`'s Apple Events interface" msgstr "" # ab5a4f1aaf0943249d22c89f01536353 -#: ../src/Doc/library/macostools.rst:87 +#: library/macostools.rst:87 msgid "" "This module contains routines that give Python programs access to some " "functionality provided by the finder. They are implemented as wrappers " @@ -59310,19 +60704,19 @@ msgid "" msgstr "" # d0d3812a656d489dbcb3742e1f4b9d5a -#: ../src/Doc/library/macostools.rst:91 +#: library/macostools.rst:91 msgid "" "All file and folder parameters can be specified either as full pathnames, or " "as :class:`FSRef` or :class:`FSSpec` objects." msgstr "" # b96ea2dd610a495bb33d7745d9f93e7c -#: ../src/Doc/library/macostools.rst:94 +#: library/macostools.rst:94 msgid "The :mod:`findertools` module defines the following functions:" msgstr "" # b68ccc78d1e249d3b63201ba85359d9f -#: ../src/Doc/library/macostools.rst:99 +#: library/macostools.rst:99 msgid "" "Tell the finder to launch *file*. What launching means depends on the file: " "applications are started, folders are opened and documents are opened in the " @@ -59330,54 +60724,54 @@ msgid "" msgstr "" # d8cccffc09604a9788232ae3a18f732d -#: ../src/Doc/library/macostools.rst:106 +#: library/macostools.rst:106 msgid "" "Tell the finder to print a file. The behaviour is identical to selecting the " "file and using the print command in the finder's file menu." msgstr "" # 3bcaa518ddd5480e98b7b9654fc2dc45 -#: ../src/Doc/library/macostools.rst:112 +#: library/macostools.rst:112 msgid "" "Tell the finder to copy a file or folder *file* to folder *destdir*. The " "function returns an :class:`Alias` object pointing to the new file." msgstr "" # 4ff26baac49b49f294e42f76b067c174 -#: ../src/Doc/library/macostools.rst:118 +#: library/macostools.rst:118 msgid "" "Tell the finder to move a file or folder *file* to folder *destdir*. The " "function returns an :class:`Alias` object pointing to the new file." msgstr "" # cbf05229e1ee4b56be446951bb9ea215 -#: ../src/Doc/library/macostools.rst:124 +#: library/macostools.rst:124 msgid "" "Tell the finder to put the Macintosh to sleep, if your machine supports it." msgstr "" # 54b21e61c14e4be79092c5676882c9ae -#: ../src/Doc/library/macostools.rst:129 +#: library/macostools.rst:129 msgid "Tell the finder to perform an orderly restart of the machine." msgstr "" # 14dea3834bea42098b487d8335661710 -#: ../src/Doc/library/macostools.rst:134 +#: library/macostools.rst:134 msgid "Tell the finder to perform an orderly shutdown of the machine." msgstr "" -#: ../src/Doc/library/macpath.rst:3 +#: library/macpath.rst:3 msgid ":mod:`macpath` --- Mac OS 9 path manipulation functions" msgstr "" -#: ../src/Doc/library/macpath.rst:9 +#: library/macpath.rst:9 msgid "" "This module is the Mac OS 9 (and earlier) implementation of the :mod:`os." "path` module. It can be used to manipulate old-style Macintosh pathnames on " "Mac OS X (or any other platform)." msgstr "" -#: ../src/Doc/library/macpath.rst:13 +#: library/macpath.rst:13 msgid "" "The following functions are available in this module: :func:`normcase`, :" "func:`normpath`, :func:`isabs`, :func:`join`, :func:`split`, :func:`isdir`, :" @@ -59385,12 +60779,12 @@ msgid "" "in :mod:`os.path` dummy counterparts are available." msgstr "" -#: ../src/Doc/library/mailbox.rst:3 +#: library/mailbox.rst:3 msgid ":mod:`mailbox` --- Manipulate mailboxes in various formats" msgstr "" # 37e3a2b404d44d0a84eef5d3af2e1cc9 -#: ../src/Doc/library/mailbox.rst:11 +#: library/mailbox.rst:11 msgid "" "This module defines two classes, :class:`Mailbox` and :class:`Message`, for " "accessing and manipulating on-disk mailboxes and the messages they contain. :" @@ -59400,35 +60794,32 @@ msgid "" "mailbox formats are Maildir, mbox, MH, Babyl, and MMDF." msgstr "" -# 9902b60a2fd644a8bed9914dd06d7dd9 -# 9ae20185eb204ea3b376cdddaf19c7e7 -# 2128231dbed648179c64721d60104709 -# 87f6b30775244741bf86ad7ef820b4e3 -#: ../src/Doc/library/mailbox.rst:21 ../src/Doc/library/mimetools.rst:68 -#: ../src/Doc/library/multifile.rst:42 ../src/Doc/library/rfc822.rst:130 -msgid "Module :mod:`email`" -msgstr "" +#: library/mailbox.rst:22 library/mimetools.rst:69 library/multifile.rst:43 +#: library/rfc822.rst:131 +#, fuzzy +msgid "Module email" +msgstr "Modules" -#: ../src/Doc/library/mailbox.rst:23 +#: library/mailbox.rst:23 msgid "Represent and manipulate messages." msgstr "" -#: ../src/Doc/library/mailbox.rst:29 +#: library/mailbox.rst:29 msgid ":class:`Mailbox` objects" msgstr "" -#: ../src/Doc/library/mailbox.rst:34 +#: library/mailbox.rst:34 msgid "A mailbox, which may be inspected and modified." msgstr "" -#: ../src/Doc/library/mailbox.rst:36 +#: library/mailbox.rst:36 msgid "" "The :class:`Mailbox` class defines an interface and is not intended to be " "instantiated. Instead, format-specific subclasses should inherit from :" "class:`Mailbox` and your code should instantiate a particular subclass." msgstr "" -#: ../src/Doc/library/mailbox.rst:40 +#: library/mailbox.rst:40 msgid "" "The :class:`Mailbox` interface is dictionary-like, with small keys " "corresponding to messages. Keys are issued by the :class:`Mailbox` instance " @@ -59438,14 +60829,14 @@ msgid "" "message." msgstr "" -#: ../src/Doc/library/mailbox.rst:46 +#: library/mailbox.rst:46 msgid "" "Messages may be added to a :class:`Mailbox` instance using the set-like " "method :meth:`add` and removed using a ``del`` statement or the set-like " "methods :meth:`remove` and :meth:`discard`." msgstr "" -#: ../src/Doc/library/mailbox.rst:50 +#: library/mailbox.rst:50 msgid "" ":class:`Mailbox` interface semantics differ from dictionary semantics in " "some noteworthy ways. Each time a message is requested, a new representation " @@ -59456,7 +60847,7 @@ msgid "" "the :class:`Mailbox` instance." msgstr "" -#: ../src/Doc/library/mailbox.rst:58 +#: library/mailbox.rst:58 msgid "" "The default :class:`Mailbox` iterator iterates over message representations, " "not keys as the default dictionary iterator does. Moreover, modification of " @@ -59467,7 +60858,7 @@ msgid "" "`KeyError` exception if the corresponding message is subsequently removed." msgstr "" -#: ../src/Doc/library/mailbox.rst:69 +#: library/mailbox.rst:69 msgid "" "Be very cautious when modifying mailboxes that might be simultaneously " "changed by some other process. The safest mailbox format to use for such " @@ -59479,17 +60870,17 @@ msgid "" "the entire mailbox." msgstr "" -#: ../src/Doc/library/mailbox.rst:78 +#: library/mailbox.rst:78 msgid ":class:`Mailbox` instances have the following methods:" msgstr "" -#: ../src/Doc/library/mailbox.rst:83 +#: library/mailbox.rst:83 msgid "" "Add *message* to the mailbox and return the key that has been assigned to it." msgstr "" # c099af2466284272b625675228a881a6 -#: ../src/Doc/library/mailbox.rst:86 +#: library/mailbox.rst:86 msgid "" "Parameter *message* may be a :class:`Message` instance, an :class:`email." "message.Message` instance, a string, or a file-like object (which should be " @@ -59500,11 +60891,11 @@ msgid "" "information are used." msgstr "" -#: ../src/Doc/library/mailbox.rst:99 +#: library/mailbox.rst:99 msgid "Delete the message corresponding to *key* from the mailbox." msgstr "" -#: ../src/Doc/library/mailbox.rst:101 +#: library/mailbox.rst:101 msgid "" "If no such message exists, a :exc:`KeyError` exception is raised if the " "method was called as :meth:`remove` or :meth:`__delitem__` but no exception " @@ -59513,14 +60904,14 @@ msgid "" "concurrent modification by other processes." msgstr "" -#: ../src/Doc/library/mailbox.rst:110 +#: library/mailbox.rst:110 msgid "" "Replace the message corresponding to *key* with *message*. Raise a :exc:" "`KeyError` exception if no message already corresponds to *key*." msgstr "" # 93328077c6d74e9dbcd7b79cef7025ab -#: ../src/Doc/library/mailbox.rst:113 +#: library/mailbox.rst:113 msgid "" "As with :meth:`add`, parameter *message* may be a :class:`Message` instance, " "an :class:`email.message.Message` instance, a string, or a file-like object " @@ -59532,13 +60923,13 @@ msgid "" "unchanged." msgstr "" -#: ../src/Doc/library/mailbox.rst:126 +#: library/mailbox.rst:126 msgid "" "Return an iterator over all keys if called as :meth:`iterkeys` or return a " "list of keys if called as :meth:`keys`." msgstr "" -#: ../src/Doc/library/mailbox.rst:134 +#: library/mailbox.rst:134 msgid "" "Return an iterator over representations of all messages if called as :meth:" "`itervalues` or :meth:`__iter__` or return a list of such representations if " @@ -59548,13 +60939,13 @@ msgid "" "initialized." msgstr "" -#: ../src/Doc/library/mailbox.rst:143 +#: library/mailbox.rst:143 msgid "" "The behavior of :meth:`__iter__` is unlike that of dictionaries, which " "iterate over keys." msgstr "" -#: ../src/Doc/library/mailbox.rst:150 +#: library/mailbox.rst:150 msgid "" "Return an iterator over (*key*, *message*) pairs, where *key* is a key and " "*message* is a message representation, if called as :meth:`iteritems` or " @@ -59564,7 +60955,7 @@ msgid "" "`Mailbox` instance was initialized." msgstr "" -#: ../src/Doc/library/mailbox.rst:161 +#: library/mailbox.rst:161 msgid "" "Return a representation of the message corresponding to *key*. If no such " "message exists, *default* is returned if the method was called as :meth:" @@ -59575,20 +60966,20 @@ msgid "" "initialized." msgstr "" -#: ../src/Doc/library/mailbox.rst:172 +#: library/mailbox.rst:172 msgid "" "Return a representation of the message corresponding to *key* as an instance " "of the appropriate format-specific :class:`Message` subclass, or raise a :" "exc:`KeyError` exception if no such message exists." msgstr "" -#: ../src/Doc/library/mailbox.rst:179 +#: library/mailbox.rst:179 msgid "" "Return a string representation of the message corresponding to *key*, or " "raise a :exc:`KeyError` exception if no such message exists." msgstr "" -#: ../src/Doc/library/mailbox.rst:185 +#: library/mailbox.rst:185 msgid "" "Return a file-like representation of the message corresponding to *key*, or " "raise a :exc:`KeyError` exception if no such message exists. The file-like " @@ -59596,7 +60987,7 @@ msgid "" "is no longer needed." msgstr "" -#: ../src/Doc/library/mailbox.rst:192 +#: library/mailbox.rst:192 msgid "" "Unlike other representations of messages, file-like representations are not " "necessarily independent of the :class:`Mailbox` instance that created them " @@ -59604,20 +60995,20 @@ msgid "" "each subclass." msgstr "" -#: ../src/Doc/library/mailbox.rst:201 +#: library/mailbox.rst:201 msgid "Return ``True`` if *key* corresponds to a message, ``False`` otherwise." msgstr "" -#: ../src/Doc/library/mailbox.rst:206 +#: library/mailbox.rst:206 msgid "Return a count of messages in the mailbox." msgstr "" -#: ../src/Doc/library/mailbox.rst:211 +#: library/mailbox.rst:211 msgid "Delete all messages from the mailbox." msgstr "" # 8c4c69d37876431a90a22dc55f694cb7 -#: ../src/Doc/library/mailbox.rst:216 +#: library/mailbox.rst:216 msgid "" "Return a representation of the message corresponding to *key* and delete the " "message. If no such message exists, return *default* if it was supplied or " @@ -59627,7 +61018,7 @@ msgid "" "was initialized." msgstr "" -#: ../src/Doc/library/mailbox.rst:226 +#: library/mailbox.rst:226 msgid "" "Return an arbitrary (*key*, *message*) pair, where *key* is a key and " "*message* is a message representation, and delete the corresponding message. " @@ -59637,7 +61028,7 @@ msgid "" "class:`Mailbox` instance was initialized." msgstr "" -#: ../src/Doc/library/mailbox.rst:236 +#: library/mailbox.rst:236 msgid "" "Parameter *arg* should be a *key*-to-*message* mapping or an iterable of " "(*key*, *message*) pairs. Updates the mailbox so that, for each given *key* " @@ -59648,18 +61039,18 @@ msgid "" "class:`Mailbox` instance." msgstr "" -#: ../src/Doc/library/mailbox.rst:246 +#: library/mailbox.rst:246 msgid "Unlike with dictionaries, keyword arguments are not supported." msgstr "" -#: ../src/Doc/library/mailbox.rst:251 +#: library/mailbox.rst:251 msgid "" "Write any pending changes to the filesystem. For some :class:`Mailbox` " "subclasses, changes are always written immediately and :meth:`flush` does " "nothing, but you should still make a habit of calling this method." msgstr "" -#: ../src/Doc/library/mailbox.rst:258 +#: library/mailbox.rst:258 msgid "" "Acquire an exclusive advisory lock on the mailbox so that other processes " "know not to modify it. An :exc:`ExternalClashError` is raised if the lock is " @@ -59668,21 +61059,21 @@ msgid "" "modifications to its contents." msgstr "" -#: ../src/Doc/library/mailbox.rst:267 +#: library/mailbox.rst:267 msgid "Release the lock on the mailbox, if any." msgstr "" -#: ../src/Doc/library/mailbox.rst:272 +#: library/mailbox.rst:272 msgid "" "Flush the mailbox, unlock it if necessary, and close any open files. For " "some :class:`Mailbox` subclasses, this method does nothing." msgstr "" -#: ../src/Doc/library/mailbox.rst:279 +#: library/mailbox.rst:279 msgid ":class:`Maildir`" msgstr "" -#: ../src/Doc/library/mailbox.rst:284 +#: library/mailbox.rst:284 msgid "" "A subclass of :class:`Mailbox` for mailboxes in Maildir format. Parameter " "*factory* is a callable object that accepts a file-like message " @@ -59693,7 +61084,7 @@ msgid "" msgstr "" # 34f1806157a24e7b99f006f0cc181fcd -#: ../src/Doc/library/mailbox.rst:291 +#: library/mailbox.rst:291 msgid "" "It is for historical reasons that *factory* defaults to :class:`rfc822." "Message` and that *dirname* is named as such rather than *path*. For a :" @@ -59701,7 +61092,7 @@ msgid "" "`Mailbox` subclasses, set *factory* to ``None``." msgstr "" -#: ../src/Doc/library/mailbox.rst:296 +#: library/mailbox.rst:296 msgid "" "Maildir is a directory-based mailbox format invented for the qmail mail " "transfer agent and now widely supported by other programs. Messages in a " @@ -59711,7 +61102,7 @@ msgid "" "unnecessary." msgstr "" -#: ../src/Doc/library/mailbox.rst:303 +#: library/mailbox.rst:303 msgid "" "Maildir mailboxes contain three subdirectories, namely: :file:`tmp`, :file:" "`new`, and :file:`cur`. Messages are created momentarily in the :file:`tmp` " @@ -59721,7 +61112,7 @@ msgid "" "special \"info\" section appended to its file name." msgstr "" -#: ../src/Doc/library/mailbox.rst:310 +#: library/mailbox.rst:310 msgid "" "Folders of the style introduced by the Courier mail transfer agent are also " "supported. Any subdirectory of the main mailbox is considered a folder if " @@ -59731,7 +61122,7 @@ msgid "" "indicated using ``'.'`` to delimit levels, e.g., \"Archived.2005.07\"." msgstr "" -#: ../src/Doc/library/mailbox.rst:319 +#: library/mailbox.rst:319 msgid "" "The Maildir specification requires the use of a colon (``':'``) in certain " "message file names. However, some operating systems do not permit this " @@ -59740,54 +61131,54 @@ msgid "" "exclamation point (``'!'``) is a popular choice. For example::" msgstr "" -#: ../src/Doc/library/mailbox.rst:329 +#: library/mailbox.rst:329 msgid "The :attr:`colon` attribute may also be set on a per-instance basis." msgstr "" -#: ../src/Doc/library/mailbox.rst:331 +#: library/mailbox.rst:331 msgid "" ":class:`Maildir` instances have all of the methods of :class:`Mailbox` in " "addition to the following:" msgstr "" -#: ../src/Doc/library/mailbox.rst:337 ../src/Doc/library/mailbox.rst:515 +#: library/mailbox.rst:337 library/mailbox.rst:515 msgid "Return a list of the names of all folders." msgstr "" -#: ../src/Doc/library/mailbox.rst:342 +#: library/mailbox.rst:342 msgid "" "Return a :class:`Maildir` instance representing the folder whose name is " "*folder*. A :exc:`NoSuchMailboxError` exception is raised if the folder does " "not exist." msgstr "" -#: ../src/Doc/library/mailbox.rst:349 +#: library/mailbox.rst:349 msgid "" "Create a folder whose name is *folder* and return a :class:`Maildir` " "instance representing it." msgstr "" -#: ../src/Doc/library/mailbox.rst:355 ../src/Doc/library/mailbox.rst:533 +#: library/mailbox.rst:355 library/mailbox.rst:533 msgid "" "Delete the folder whose name is *folder*. If the folder contains any " "messages, a :exc:`NotEmptyError` exception will be raised and the folder " "will not be deleted." msgstr "" -#: ../src/Doc/library/mailbox.rst:362 +#: library/mailbox.rst:362 msgid "" "Delete temporary files from the mailbox that have not been accessed in the " "last 36 hours. The Maildir specification says that mail-reading programs " "should do this occasionally." msgstr "" -#: ../src/Doc/library/mailbox.rst:366 +#: library/mailbox.rst:366 msgid "" "Some :class:`Mailbox` methods implemented by :class:`Maildir` deserve " "special remarks:" msgstr "" -#: ../src/Doc/library/mailbox.rst:376 +#: library/mailbox.rst:376 msgid "" "These methods generate unique file names based upon the current process ID. " "When using multiple threads, undetected name clashes may occur and cause " @@ -59795,68 +61186,63 @@ msgid "" "these methods to manipulate the same mailbox simultaneously." msgstr "" -#: ../src/Doc/library/mailbox.rst:384 +#: library/mailbox.rst:384 msgid "" "All changes to Maildir mailboxes are immediately applied, so this method " "does nothing." msgstr "" -#: ../src/Doc/library/mailbox.rst:391 +#: library/mailbox.rst:391 msgid "" "Maildir mailboxes do not support (or require) locking, so these methods do " "nothing." msgstr "" -#: ../src/Doc/library/mailbox.rst:397 +#: library/mailbox.rst:397 msgid "" ":class:`Maildir` instances do not keep any open files and the underlying " "mailboxes do not support locking, so this method does nothing." msgstr "" -#: ../src/Doc/library/mailbox.rst:403 +#: library/mailbox.rst:403 msgid "" "Depending upon the host platform, it may not be possible to modify or remove " "the underlying message while the returned file remains open." msgstr "" -# 2c0774fa8e524661addfbd41f1db3e00 -#: ../src/Doc/library/mailbox.rst:409 -msgid "" -"`maildir man page from qmail `_" +#: library/mailbox.rst:410 +msgid "maildir man page from qmail" msgstr "" -#: ../src/Doc/library/mailbox.rst:410 +#: library/mailbox.rst:410 msgid "The original specification of the format." msgstr "" -# 9386a3b6d0374756b5bd447b30a7765e -#: ../src/Doc/library/mailbox.rst:413 -msgid "`Using maildir format `_" +#: library/mailbox.rst:414 +msgid "Using maildir format" msgstr "" -#: ../src/Doc/library/mailbox.rst:413 +#: library/mailbox.rst:413 msgid "" "Notes on Maildir by its inventor. Includes an updated name-creation scheme " "and details on \"info\" semantics." msgstr "" -# 5122a9e720e34cdda7c5352f87882012 -#: ../src/Doc/library/mailbox.rst:416 -msgid "" -"`maildir man page from Courier `_" +#: library/mailbox.rst:417 +msgid "maildir man page from Courier" msgstr "" -#: ../src/Doc/library/mailbox.rst:417 +#: library/mailbox.rst:417 msgid "" "Another specification of the format. Describes a common extension for " "supporting folders." msgstr "" -#: ../src/Doc/library/mailbox.rst:424 +#: library/mailbox.rst:424 msgid ":class:`mbox`" msgstr "" -#: ../src/Doc/library/mailbox.rst:429 +#: library/mailbox.rst:429 msgid "" "A subclass of :class:`Mailbox` for mailboxes in mbox format. Parameter " "*factory* is a callable object that accepts a file-like message " @@ -59866,7 +61252,7 @@ msgid "" "mailbox is created if it does not exist." msgstr "" -#: ../src/Doc/library/mailbox.rst:436 +#: library/mailbox.rst:436 msgid "" "The mbox format is the classic format for storing mail on Unix systems. All " "messages in an mbox mailbox are stored in a single file with the beginning " @@ -59874,7 +61260,7 @@ msgid "" "\"." msgstr "" -#: ../src/Doc/library/mailbox.rst:440 +#: library/mailbox.rst:440 msgid "" "Several variations of the mbox format exist to address perceived " "shortcomings in the original. In the interest of compatibility, :class:" @@ -59886,13 +61272,13 @@ msgid "" "when reading the message." msgstr "" -#: ../src/Doc/library/mailbox.rst:448 +#: library/mailbox.rst:448 msgid "" "Some :class:`Mailbox` methods implemented by :class:`mbox` deserve special " "remarks:" msgstr "" -#: ../src/Doc/library/mailbox.rst:454 +#: library/mailbox.rst:454 msgid "" "Using the file after calling :meth:`flush` or :meth:`close` on the :class:" "`mbox` instance may yield unpredictable results or raise an exception." @@ -59901,61 +61287,49 @@ msgstr "" # 9a14076bf357426a81072e51b0d30f81 # 049785cd0e094b5f9b651f7602c2dfea # 6f05e77430c5452a88ca3ee6fc4465bf -#: ../src/Doc/library/mailbox.rst:462 ../src/Doc/library/mailbox.rst:674 -#: ../src/Doc/library/mailbox.rst:725 +#: library/mailbox.rst:462 library/mailbox.rst:674 library/mailbox.rst:725 msgid "" "Three locking mechanisms are used---dot locking and, if available, the :c:" "func:`flock` and :c:func:`lockf` system calls." msgstr "" -# 6b75ae2e3ea841c3a3a5c1853fef0f0e -#: ../src/Doc/library/mailbox.rst:468 -msgid "`mbox man page from qmail `_" +#: library/mailbox.rst:469 +msgid "mbox man page from qmail" msgstr "" -#: ../src/Doc/library/mailbox.rst:469 +#: library/mailbox.rst:469 msgid "A specification of the format and its variations." msgstr "" -# 03298d5505e743d09301199bf366b481 -#: ../src/Doc/library/mailbox.rst:471 -msgid "" -"`mbox man page from tin `_" +#: library/mailbox.rst:472 +msgid "mbox man page from tin" msgstr "" -#: ../src/Doc/library/mailbox.rst:472 +#: library/mailbox.rst:472 msgid "Another specification of the format, with details on locking." msgstr "" -# 2b96a5896d0f4073b20a14b7033d06e0 -#: ../src/Doc/library/mailbox.rst:474 -msgid "" -"`Configuring Netscape Mail on Unix: Why The Content-Length Format is Bad " -"`_" +#: library/mailbox.rst:475 +msgid "Configuring Netscape Mail on Unix: Why The Content-Length Format is Bad" msgstr "" -#: ../src/Doc/library/mailbox.rst:475 +#: library/mailbox.rst:475 msgid "An argument for using the original mbox format rather than a variation." msgstr "" -# 0cb88026c3a74365a45b719f487685cd -#: ../src/Doc/library/mailbox.rst:476 -msgid "" -"`\"mbox\" is a family of several mutually incompatible mailbox formats " -"`_" +#: library/mailbox.rst:477 +msgid "\"mbox\" is a family of several mutually incompatible mailbox formats" msgstr "" -#: ../src/Doc/library/mailbox.rst:478 +#: library/mailbox.rst:478 msgid "A history of mbox variations." msgstr "" -#: ../src/Doc/library/mailbox.rst:484 +#: library/mailbox.rst:484 msgid ":class:`MH`" msgstr "" -#: ../src/Doc/library/mailbox.rst:489 +#: library/mailbox.rst:489 msgid "" "A subclass of :class:`Mailbox` for mailboxes in MH format. Parameter " "*factory* is a callable object that accepts a file-like message " @@ -59965,7 +61339,7 @@ msgid "" "is created if it does not exist." msgstr "" -#: ../src/Doc/library/mailbox.rst:496 +#: library/mailbox.rst:496 msgid "" "MH is a directory-based mailbox format invented for the MH Message Handling " "System, a mail user agent. Each message in an MH mailbox resides in its own " @@ -59976,7 +61350,7 @@ msgid "" "called :file:`.mh_sequences` in each folder." msgstr "" -#: ../src/Doc/library/mailbox.rst:504 +#: library/mailbox.rst:504 msgid "" "The :class:`MH` class manipulates MH mailboxes, but it does not attempt to " "emulate all of :program:`mh`'s behaviors. In particular, it does not modify " @@ -59984,64 +61358,64 @@ msgid "" "are used by :program:`mh` to store its state and configuration." msgstr "" -#: ../src/Doc/library/mailbox.rst:509 +#: library/mailbox.rst:509 msgid "" ":class:`MH` instances have all of the methods of :class:`Mailbox` in " "addition to the following:" msgstr "" -#: ../src/Doc/library/mailbox.rst:520 +#: library/mailbox.rst:520 msgid "" "Return an :class:`MH` instance representing the folder whose name is " "*folder*. A :exc:`NoSuchMailboxError` exception is raised if the folder does " "not exist." msgstr "" -#: ../src/Doc/library/mailbox.rst:527 +#: library/mailbox.rst:527 msgid "" "Create a folder whose name is *folder* and return an :class:`MH` instance " "representing it." msgstr "" -#: ../src/Doc/library/mailbox.rst:540 +#: library/mailbox.rst:540 msgid "" "Return a dictionary of sequence names mapped to key lists. If there are no " "sequences, the empty dictionary is returned." msgstr "" -#: ../src/Doc/library/mailbox.rst:546 +#: library/mailbox.rst:546 msgid "" "Re-define the sequences that exist in the mailbox based upon *sequences*, a " "dictionary of names mapped to key lists, like returned by :meth:" "`get_sequences`." msgstr "" -#: ../src/Doc/library/mailbox.rst:553 +#: library/mailbox.rst:553 msgid "" "Rename messages in the mailbox as necessary to eliminate gaps in numbering. " "Entries in the sequences list are updated correspondingly." msgstr "" -#: ../src/Doc/library/mailbox.rst:558 +#: library/mailbox.rst:558 msgid "" "Already-issued keys are invalidated by this operation and should not be " "subsequently used." msgstr "" -#: ../src/Doc/library/mailbox.rst:561 +#: library/mailbox.rst:561 msgid "" "Some :class:`Mailbox` methods implemented by :class:`MH` deserve special " "remarks:" msgstr "" -#: ../src/Doc/library/mailbox.rst:569 +#: library/mailbox.rst:569 msgid "" "These methods immediately delete the message. The MH convention of marking a " "message for deletion by prepending a comma to its name is not used." msgstr "" # 8ebbb9ccafef4c40b282e64571886d1f -#: ../src/Doc/library/mailbox.rst:576 +#: library/mailbox.rst:576 msgid "" "Three locking mechanisms are used---dot locking and, if available, the :c:" "func:`flock` and :c:func:`lockf` system calls. For MH mailboxes, locking the " @@ -60050,53 +61424,49 @@ msgid "" "files." msgstr "" -#: ../src/Doc/library/mailbox.rst:585 +#: library/mailbox.rst:585 msgid "" "Depending upon the host platform, it may not be possible to remove the " "underlying message while the returned file remains open." msgstr "" -#: ../src/Doc/library/mailbox.rst:591 +#: library/mailbox.rst:591 msgid "" "All changes to MH mailboxes are immediately applied, so this method does " "nothing." msgstr "" -#: ../src/Doc/library/mailbox.rst:597 +#: library/mailbox.rst:597 msgid "" ":class:`MH` instances do not keep any open files, so this method is " "equivalent to :meth:`unlock`." msgstr "" -# f47f7da1159d44de887940f6ed9b9ca7 -#: ../src/Doc/library/mailbox.rst:603 -msgid "`nmh - Message Handling System `_" +#: library/mailbox.rst:604 +msgid "nmh - Message Handling System" msgstr "" -#: ../src/Doc/library/mailbox.rst:604 +#: library/mailbox.rst:604 msgid "" "Home page of :program:`nmh`, an updated version of the original :program:" "`mh`." msgstr "" -# 2bc8e2a7fcba4d83a997a726bbee5c92 -#: ../src/Doc/library/mailbox.rst:606 -msgid "" -"`MH & nmh: Email for Users & Programmers `_" +#: library/mailbox.rst:607 +msgid "MH & nmh: Email for Users & Programmers" msgstr "" -#: ../src/Doc/library/mailbox.rst:607 +#: library/mailbox.rst:607 msgid "" "A GPL-licensed book on :program:`mh` and :program:`nmh`, with some " "information on the mailbox format." msgstr "" -#: ../src/Doc/library/mailbox.rst:614 +#: library/mailbox.rst:614 msgid ":class:`Babyl`" msgstr "" -#: ../src/Doc/library/mailbox.rst:619 +#: library/mailbox.rst:619 msgid "" "A subclass of :class:`Mailbox` for mailboxes in Babyl format. Parameter " "*factory* is a callable object that accepts a file-like message " @@ -60106,7 +61476,7 @@ msgid "" "mailbox is created if it does not exist." msgstr "" -#: ../src/Doc/library/mailbox.rst:626 +#: library/mailbox.rst:626 msgid "" "Babyl is a single-file mailbox format used by the Rmail mail user agent " "included with Emacs. The beginning of a message is indicated by a line " @@ -60116,7 +61486,7 @@ msgid "" "Underscore (``'\\037'``) character." msgstr "" -#: ../src/Doc/library/mailbox.rst:633 +#: library/mailbox.rst:633 msgid "" "Messages in a Babyl mailbox have two sets of headers, original headers and " "so-called visible headers. Visible headers are typically a subset of the " @@ -60127,32 +61497,32 @@ msgid "" "in the Babyl options section." msgstr "" -#: ../src/Doc/library/mailbox.rst:641 +#: library/mailbox.rst:641 msgid "" ":class:`Babyl` instances have all of the methods of :class:`Mailbox` in " "addition to the following:" msgstr "" -#: ../src/Doc/library/mailbox.rst:647 +#: library/mailbox.rst:647 msgid "" "Return a list of the names of all user-defined labels used in the mailbox." msgstr "" -#: ../src/Doc/library/mailbox.rst:651 +#: library/mailbox.rst:651 msgid "" "The actual messages are inspected to determine which labels exist in the " "mailbox rather than consulting the list of labels in the Babyl options " "section, but the Babyl section is updated whenever the mailbox is modified." msgstr "" -#: ../src/Doc/library/mailbox.rst:656 +#: library/mailbox.rst:656 msgid "" "Some :class:`Mailbox` methods implemented by :class:`Babyl` deserve special " "remarks:" msgstr "" # 2f8277c421864f9eadb2aec69e7ce1da -#: ../src/Doc/library/mailbox.rst:662 +#: library/mailbox.rst:662 msgid "" "In Babyl mailboxes, the headers of a message are not stored contiguously " "with the body of the message. To generate a file-like representation, the " @@ -60163,31 +61533,27 @@ msgid "" "representation." msgstr "" -# 3350b17d39374b49b7cce854b8b8ef27 -#: ../src/Doc/library/mailbox.rst:680 -msgid "`Format of Version 5 Babyl Files `_" +#: library/mailbox.rst:681 +msgid "Format of Version 5 Babyl Files" msgstr "" -#: ../src/Doc/library/mailbox.rst:681 +#: library/mailbox.rst:681 msgid "A specification of the Babyl format." msgstr "" -# d6fce0877b794878a6ddbcf6f3e461e1 -#: ../src/Doc/library/mailbox.rst:682 -msgid "" -"`Reading Mail with Rmail `_" +#: library/mailbox.rst:683 +msgid "Reading Mail with Rmail" msgstr "" -#: ../src/Doc/library/mailbox.rst:684 +#: library/mailbox.rst:684 msgid "The Rmail manual, with some information on Babyl semantics." msgstr "" -#: ../src/Doc/library/mailbox.rst:690 +#: library/mailbox.rst:690 msgid ":class:`MMDF`" msgstr "" -#: ../src/Doc/library/mailbox.rst:695 +#: library/mailbox.rst:695 msgid "" "A subclass of :class:`Mailbox` for mailboxes in MMDF format. Parameter " "*factory* is a callable object that accepts a file-like message " @@ -60197,7 +61563,7 @@ msgid "" "mailbox is created if it does not exist." msgstr "" -#: ../src/Doc/library/mailbox.rst:702 +#: library/mailbox.rst:702 msgid "" "MMDF is a single-file mailbox format invented for the Multichannel " "Memorandum Distribution Facility, a mail transfer agent. Each message is in " @@ -60210,47 +61576,43 @@ msgid "" "subsequent messages." msgstr "" -#: ../src/Doc/library/mailbox.rst:711 +#: library/mailbox.rst:711 msgid "" "Some :class:`Mailbox` methods implemented by :class:`MMDF` deserve special " "remarks:" msgstr "" -#: ../src/Doc/library/mailbox.rst:717 +#: library/mailbox.rst:717 msgid "" "Using the file after calling :meth:`flush` or :meth:`close` on the :class:" "`MMDF` instance may yield unpredictable results or raise an exception." msgstr "" -# 73819ac93ae44ba198f2cfe97cc972f3 -#: ../src/Doc/library/mailbox.rst:731 -msgid "" -"`mmdf man page from tin `_" +#: library/mailbox.rst:732 +msgid "mmdf man page from tin" msgstr "" -#: ../src/Doc/library/mailbox.rst:732 +#: library/mailbox.rst:732 msgid "" "A specification of MMDF format from the documentation of tin, a newsreader." msgstr "" -# 30d7b2c95f024471baecf1f536250c74 -#: ../src/Doc/library/mailbox.rst:734 -msgid "`MMDF `_" +#: library/mailbox.rst:735 +msgid "MMDF" msgstr "" -#: ../src/Doc/library/mailbox.rst:735 +#: library/mailbox.rst:735 msgid "" "A Wikipedia article describing the Multichannel Memorandum Distribution " "Facility." msgstr "" -#: ../src/Doc/library/mailbox.rst:742 +#: library/mailbox.rst:742 msgid ":class:`Message` objects" msgstr "" # 9d1529f9edfd4caea9cf2483f0434b94 -#: ../src/Doc/library/mailbox.rst:747 +#: library/mailbox.rst:747 msgid "" "A subclass of the :mod:`email.message` module's :class:`~email.message." "Message`. Subclasses of :class:`mailbox.Message` add mailbox-format-specific " @@ -60258,7 +61620,7 @@ msgid "" msgstr "" # 02a97f125dbd44f1b120a6b855582e53 -#: ../src/Doc/library/mailbox.rst:751 +#: library/mailbox.rst:751 msgid "" "If *message* is omitted, the new instance is created in a default, empty " "state. If *message* is an :class:`email.message.Message` instance, its " @@ -60268,7 +61630,7 @@ msgid "" "compliant message, which is read and parsed." msgstr "" -#: ../src/Doc/library/mailbox.rst:758 +#: library/mailbox.rst:758 msgid "" "The format-specific state and behaviors offered by subclasses vary, but in " "general it is only the properties that are not specific to a particular " @@ -60281,7 +61643,7 @@ msgid "" msgstr "" # 6e1dee1c4a684ba38628086c58158c3f -#: ../src/Doc/library/mailbox.rst:767 +#: library/mailbox.rst:767 msgid "" "There is no requirement that :class:`Message` instances be used to represent " "messages retrieved using :class:`Mailbox` instances. In some situations, the " @@ -60291,17 +61653,17 @@ msgid "" "be specified when a :class:`Mailbox` instance is initialized." msgstr "" -#: ../src/Doc/library/mailbox.rst:778 +#: library/mailbox.rst:778 msgid ":class:`MaildirMessage`" msgstr "" -#: ../src/Doc/library/mailbox.rst:783 +#: library/mailbox.rst:783 msgid "" "A message with Maildir-specific behaviors. Parameter *message* has the same " "meaning as with the :class:`Message` constructor." msgstr "" -#: ../src/Doc/library/mailbox.rst:786 +#: library/mailbox.rst:786 msgid "" "Typically, a mail user agent application moves all of the messages in the :" "file:`new` subdirectory to the :file:`cur` subdirectory after the first time " @@ -60315,117 +61677,111 @@ msgid "" "flags for Maildir messages are as follows:" msgstr "" -#: ../src/Doc/library/mailbox.rst:798 ../src/Doc/library/mailbox.rst:965 -#: ../src/Doc/library/mailbox.rst:1335 ../src/Doc/library/stdtypes.rst:1419 +#: library/mailbox.rst:798 library/mailbox.rst:965 library/mailbox.rst:1335 +#: library/stdtypes.rst:1422 msgid "Flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:800 ../src/Doc/library/mailbox.rst:971 -#: ../src/Doc/library/mailbox.rst:1341 +#: library/mailbox.rst:800 library/mailbox.rst:971 library/mailbox.rst:1341 msgid "D" msgstr "" -#: ../src/Doc/library/mailbox.rst:800 +#: library/mailbox.rst:800 msgid "Draft" msgstr "" -#: ../src/Doc/library/mailbox.rst:800 +#: library/mailbox.rst:800 msgid "Under composition" msgstr "" -#: ../src/Doc/library/mailbox.rst:802 ../src/Doc/library/mailbox.rst:973 -#: ../src/Doc/library/mailbox.rst:1343 +#: library/mailbox.rst:802 library/mailbox.rst:973 library/mailbox.rst:1343 msgid "F" msgstr "" -#: ../src/Doc/library/mailbox.rst:802 ../src/Doc/library/mailbox.rst:973 -#: ../src/Doc/library/mailbox.rst:1343 +#: library/mailbox.rst:802 library/mailbox.rst:973 library/mailbox.rst:1343 msgid "Flagged" msgstr "" -#: ../src/Doc/library/mailbox.rst:802 ../src/Doc/library/mailbox.rst:973 -#: ../src/Doc/library/mailbox.rst:1121 ../src/Doc/library/mailbox.rst:1343 +#: library/mailbox.rst:802 library/mailbox.rst:973 library/mailbox.rst:1121 +#: library/mailbox.rst:1343 msgid "Marked as important" msgstr "" -#: ../src/Doc/library/mailbox.rst:804 +#: library/mailbox.rst:804 msgid "P" msgstr "" -#: ../src/Doc/library/mailbox.rst:804 +#: library/mailbox.rst:804 msgid "Passed" msgstr "" -#: ../src/Doc/library/mailbox.rst:804 +#: library/mailbox.rst:804 msgid "Forwarded, resent, or bounced" msgstr "" -#: ../src/Doc/library/mailbox.rst:806 ../src/Doc/library/mailbox.rst:967 -#: ../src/Doc/library/mailbox.rst:1337 +#: library/mailbox.rst:806 library/mailbox.rst:967 library/mailbox.rst:1337 msgid "R" msgstr "" -#: ../src/Doc/library/mailbox.rst:806 +#: library/mailbox.rst:806 msgid "Replied" msgstr "" -#: ../src/Doc/library/mailbox.rst:806 ../src/Doc/library/mailbox.rst:975 -#: ../src/Doc/library/mailbox.rst:1119 ../src/Doc/library/mailbox.rst:1210 -#: ../src/Doc/library/mailbox.rst:1345 +#: library/mailbox.rst:806 library/mailbox.rst:975 library/mailbox.rst:1119 +#: library/mailbox.rst:1210 library/mailbox.rst:1345 msgid "Replied to" msgstr "" -#: ../src/Doc/library/mailbox.rst:808 +#: library/mailbox.rst:808 msgid "S" msgstr "" -#: ../src/Doc/library/mailbox.rst:808 +#: library/mailbox.rst:808 msgid "Seen" msgstr "" -#: ../src/Doc/library/mailbox.rst:808 ../src/Doc/library/mailbox.rst:967 -#: ../src/Doc/library/mailbox.rst:1337 +#: library/mailbox.rst:808 library/mailbox.rst:967 library/mailbox.rst:1337 msgid "Read" msgstr "" -#: ../src/Doc/library/mailbox.rst:810 +#: library/mailbox.rst:810 msgid "T" msgstr "" -#: ../src/Doc/library/mailbox.rst:810 +#: library/mailbox.rst:810 msgid "Trashed" msgstr "" -#: ../src/Doc/library/mailbox.rst:810 ../src/Doc/library/mailbox.rst:971 -#: ../src/Doc/library/mailbox.rst:1206 ../src/Doc/library/mailbox.rst:1341 +#: library/mailbox.rst:810 library/mailbox.rst:971 library/mailbox.rst:1206 +#: library/mailbox.rst:1341 msgid "Marked for subsequent deletion" msgstr "" -#: ../src/Doc/library/mailbox.rst:813 +#: library/mailbox.rst:813 msgid ":class:`MaildirMessage` instances offer the following methods:" msgstr "" -#: ../src/Doc/library/mailbox.rst:818 +#: library/mailbox.rst:818 msgid "" "Return either \"new\" (if the message should be stored in the :file:`new` " "subdirectory) or \"cur\" (if the message should be stored in the :file:`cur` " "subdirectory)." msgstr "" -#: ../src/Doc/library/mailbox.rst:824 +#: library/mailbox.rst:824 msgid "" "A message is typically moved from :file:`new` to :file:`cur` after its " "mailbox has been accessed, whether or not the message is has been read. A " "message ``msg`` has been read if ``\"S\" in msg.get_flags()`` is ``True``." msgstr "" -#: ../src/Doc/library/mailbox.rst:832 +#: library/mailbox.rst:832 msgid "" "Set the subdirectory the message should be stored in. Parameter *subdir* " "must be either \"new\" or \"cur\"." msgstr "" -#: ../src/Doc/library/mailbox.rst:838 +#: library/mailbox.rst:838 msgid "" "Return a string specifying the flags that are currently set. If the message " "complies with the standard Maildir format, the result is the concatenation " @@ -60434,11 +61790,11 @@ msgid "" "flags are set or if \"info\" contains experimental semantics." msgstr "" -#: ../src/Doc/library/mailbox.rst:848 +#: library/mailbox.rst:848 msgid "Set the flags specified by *flags* and unset all others." msgstr "" -#: ../src/Doc/library/mailbox.rst:853 +#: library/mailbox.rst:853 msgid "" "Set the flag(s) specified by *flag* without changing other flags. To add " "more than one flag at a time, *flag* may be a string of more than one " @@ -60446,7 +61802,7 @@ msgid "" "experimental information rather than flags." msgstr "" -#: ../src/Doc/library/mailbox.rst:861 +#: library/mailbox.rst:861 msgid "" "Unset the flag(s) specified by *flag* without changing other flags. To " "remove more than one flag at a time, *flag* maybe a string of more than one " @@ -60454,30 +61810,30 @@ msgid "" "the current \"info\" is not modified." msgstr "" -#: ../src/Doc/library/mailbox.rst:869 +#: library/mailbox.rst:869 msgid "" "Return the delivery date of the message as a floating-point number " "representing seconds since the epoch." msgstr "" -#: ../src/Doc/library/mailbox.rst:875 +#: library/mailbox.rst:875 msgid "" "Set the delivery date of the message to *date*, a floating-point number " "representing seconds since the epoch." msgstr "" -#: ../src/Doc/library/mailbox.rst:881 +#: library/mailbox.rst:881 msgid "" "Return a string containing the \"info\" for a message. This is useful for " "accessing and modifying \"info\" that is experimental (i.e., not a list of " "flags)." msgstr "" -#: ../src/Doc/library/mailbox.rst:888 +#: library/mailbox.rst:888 msgid "Set \"info\" to *info*, which should be a string." msgstr "" -#: ../src/Doc/library/mailbox.rst:890 +#: library/mailbox.rst:890 msgid "" "When a :class:`MaildirMessage` instance is created based upon an :class:" "`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` " @@ -60485,176 +61841,153 @@ msgid "" "take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:896 ../src/Doc/library/mailbox.rst:914 -#: ../src/Doc/library/mailbox.rst:929 ../src/Doc/library/mailbox.rst:1036 -#: ../src/Doc/library/mailbox.rst:1053 ../src/Doc/library/mailbox.rst:1068 -#: ../src/Doc/library/mailbox.rst:1083 ../src/Doc/library/mailbox.rst:1150 -#: ../src/Doc/library/mailbox.rst:1165 ../src/Doc/library/mailbox.rst:1179 -#: ../src/Doc/library/mailbox.rst:1276 ../src/Doc/library/mailbox.rst:1293 -#: ../src/Doc/library/mailbox.rst:1307 ../src/Doc/library/mailbox.rst:1407 -#: ../src/Doc/library/mailbox.rst:1424 ../src/Doc/library/mailbox.rst:1439 -#: ../src/Doc/library/mailbox.rst:1455 +#: library/mailbox.rst:896 library/mailbox.rst:914 library/mailbox.rst:929 +#: library/mailbox.rst:1036 library/mailbox.rst:1053 library/mailbox.rst:1068 +#: library/mailbox.rst:1083 library/mailbox.rst:1150 library/mailbox.rst:1165 +#: library/mailbox.rst:1179 library/mailbox.rst:1276 library/mailbox.rst:1293 +#: library/mailbox.rst:1307 library/mailbox.rst:1407 library/mailbox.rst:1424 +#: library/mailbox.rst:1439 library/mailbox.rst:1455 msgid "Resulting state" msgstr "" -#: ../src/Doc/library/mailbox.rst:896 ../src/Doc/library/mailbox.rst:1165 -#: ../src/Doc/library/mailbox.rst:1293 +#: library/mailbox.rst:896 library/mailbox.rst:1165 library/mailbox.rst:1293 msgid ":class:`mboxMessage` or :class:`MMDFMessage` state" msgstr "" -#: ../src/Doc/library/mailbox.rst:899 ../src/Doc/library/mailbox.rst:916 -#: ../src/Doc/library/mailbox.rst:931 ../src/Doc/library/mailbox.rst:1040 -#: ../src/Doc/library/mailbox.rst:1411 +#: library/mailbox.rst:899 library/mailbox.rst:916 library/mailbox.rst:931 +#: library/mailbox.rst:1040 library/mailbox.rst:1411 msgid "\"cur\" subdirectory" msgstr "" -#: ../src/Doc/library/mailbox.rst:899 ../src/Doc/library/mailbox.rst:1040 -#: ../src/Doc/library/mailbox.rst:1057 ../src/Doc/library/mailbox.rst:1072 -#: ../src/Doc/library/mailbox.rst:1087 ../src/Doc/library/mailbox.rst:1411 -#: ../src/Doc/library/mailbox.rst:1428 ../src/Doc/library/mailbox.rst:1443 -#: ../src/Doc/library/mailbox.rst:1459 +#: library/mailbox.rst:899 library/mailbox.rst:1040 library/mailbox.rst:1057 +#: library/mailbox.rst:1072 library/mailbox.rst:1087 library/mailbox.rst:1411 +#: library/mailbox.rst:1428 library/mailbox.rst:1443 library/mailbox.rst:1459 msgid "O flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:901 ../src/Doc/library/mailbox.rst:920 -#: ../src/Doc/library/mailbox.rst:1044 ../src/Doc/library/mailbox.rst:1059 -#: ../src/Doc/library/mailbox.rst:1091 ../src/Doc/library/mailbox.rst:1156 -#: ../src/Doc/library/mailbox.rst:1172 ../src/Doc/library/mailbox.rst:1415 -#: ../src/Doc/library/mailbox.rst:1430 ../src/Doc/library/mailbox.rst:1463 +#: library/mailbox.rst:901 library/mailbox.rst:920 library/mailbox.rst:1044 +#: library/mailbox.rst:1059 library/mailbox.rst:1091 library/mailbox.rst:1156 +#: library/mailbox.rst:1172 library/mailbox.rst:1415 library/mailbox.rst:1430 +#: library/mailbox.rst:1463 msgid "F flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:903 ../src/Doc/library/mailbox.rst:905 -#: ../src/Doc/library/mailbox.rst:922 ../src/Doc/library/mailbox.rst:937 -#: ../src/Doc/library/mailbox.rst:1038 ../src/Doc/library/mailbox.rst:1046 -#: ../src/Doc/library/mailbox.rst:1085 ../src/Doc/library/mailbox.rst:1154 -#: ../src/Doc/library/mailbox.rst:1282 ../src/Doc/library/mailbox.rst:1409 -#: ../src/Doc/library/mailbox.rst:1417 ../src/Doc/library/mailbox.rst:1457 +#: library/mailbox.rst:903 library/mailbox.rst:905 library/mailbox.rst:922 +#: library/mailbox.rst:937 library/mailbox.rst:1038 library/mailbox.rst:1046 +#: library/mailbox.rst:1085 library/mailbox.rst:1154 library/mailbox.rst:1282 +#: library/mailbox.rst:1409 library/mailbox.rst:1417 library/mailbox.rst:1457 msgid "R flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:903 ../src/Doc/library/mailbox.rst:1046 -#: ../src/Doc/library/mailbox.rst:1061 ../src/Doc/library/mailbox.rst:1076 -#: ../src/Doc/library/mailbox.rst:1093 ../src/Doc/library/mailbox.rst:1170 -#: ../src/Doc/library/mailbox.rst:1300 ../src/Doc/library/mailbox.rst:1417 -#: ../src/Doc/library/mailbox.rst:1432 ../src/Doc/library/mailbox.rst:1447 -#: ../src/Doc/library/mailbox.rst:1465 +#: library/mailbox.rst:903 library/mailbox.rst:1046 library/mailbox.rst:1061 +#: library/mailbox.rst:1076 library/mailbox.rst:1093 library/mailbox.rst:1170 +#: library/mailbox.rst:1300 library/mailbox.rst:1417 library/mailbox.rst:1432 +#: library/mailbox.rst:1447 library/mailbox.rst:1465 msgid "A flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:905 ../src/Doc/library/mailbox.rst:1038 -#: ../src/Doc/library/mailbox.rst:1409 +#: library/mailbox.rst:905 library/mailbox.rst:1038 library/mailbox.rst:1409 msgid "S flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:907 ../src/Doc/library/mailbox.rst:939 -#: ../src/Doc/library/mailbox.rst:1042 ../src/Doc/library/mailbox.rst:1280 -#: ../src/Doc/library/mailbox.rst:1413 +#: library/mailbox.rst:907 library/mailbox.rst:939 library/mailbox.rst:1042 +#: library/mailbox.rst:1280 library/mailbox.rst:1413 msgid "T flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:907 ../src/Doc/library/mailbox.rst:1042 -#: ../src/Doc/library/mailbox.rst:1074 ../src/Doc/library/mailbox.rst:1089 -#: ../src/Doc/library/mailbox.rst:1298 ../src/Doc/library/mailbox.rst:1413 -#: ../src/Doc/library/mailbox.rst:1445 ../src/Doc/library/mailbox.rst:1461 +#: library/mailbox.rst:907 library/mailbox.rst:1042 library/mailbox.rst:1074 +#: library/mailbox.rst:1089 library/mailbox.rst:1298 library/mailbox.rst:1413 +#: library/mailbox.rst:1445 library/mailbox.rst:1461 msgid "D flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:910 +#: library/mailbox.rst:910 msgid "" "When a :class:`MaildirMessage` instance is created based upon an :class:" "`MHMessage` instance, the following conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:914 ../src/Doc/library/mailbox.rst:1053 -#: ../src/Doc/library/mailbox.rst:1307 ../src/Doc/library/mailbox.rst:1424 +#: library/mailbox.rst:914 library/mailbox.rst:1053 library/mailbox.rst:1307 +#: library/mailbox.rst:1424 msgid ":class:`MHMessage` state" msgstr "" -#: ../src/Doc/library/mailbox.rst:916 ../src/Doc/library/mailbox.rst:1057 -#: ../src/Doc/library/mailbox.rst:1152 ../src/Doc/library/mailbox.rst:1168 -#: ../src/Doc/library/mailbox.rst:1181 ../src/Doc/library/mailbox.rst:1309 -#: ../src/Doc/library/mailbox.rst:1428 +#: library/mailbox.rst:916 library/mailbox.rst:1057 library/mailbox.rst:1152 +#: library/mailbox.rst:1168 library/mailbox.rst:1181 library/mailbox.rst:1309 +#: library/mailbox.rst:1428 msgid "\"unseen\" sequence" msgstr "" -#: ../src/Doc/library/mailbox.rst:918 ../src/Doc/library/mailbox.rst:933 +#: library/mailbox.rst:918 library/mailbox.rst:933 msgid "\"cur\" subdirectory and S flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:918 ../src/Doc/library/mailbox.rst:1055 -#: ../src/Doc/library/mailbox.rst:1426 +#: library/mailbox.rst:918 library/mailbox.rst:1055 library/mailbox.rst:1426 msgid "no \"unseen\" sequence" msgstr "" -#: ../src/Doc/library/mailbox.rst:920 ../src/Doc/library/mailbox.rst:1059 -#: ../src/Doc/library/mailbox.rst:1156 ../src/Doc/library/mailbox.rst:1172 -#: ../src/Doc/library/mailbox.rst:1430 +#: library/mailbox.rst:920 library/mailbox.rst:1059 library/mailbox.rst:1156 +#: library/mailbox.rst:1172 library/mailbox.rst:1430 msgid "\"flagged\" sequence" msgstr "" -#: ../src/Doc/library/mailbox.rst:922 ../src/Doc/library/mailbox.rst:1061 -#: ../src/Doc/library/mailbox.rst:1154 ../src/Doc/library/mailbox.rst:1170 -#: ../src/Doc/library/mailbox.rst:1183 ../src/Doc/library/mailbox.rst:1311 -#: ../src/Doc/library/mailbox.rst:1432 +#: library/mailbox.rst:922 library/mailbox.rst:1061 library/mailbox.rst:1154 +#: library/mailbox.rst:1170 library/mailbox.rst:1183 library/mailbox.rst:1311 +#: library/mailbox.rst:1432 msgid "\"replied\" sequence" msgstr "" -#: ../src/Doc/library/mailbox.rst:925 +#: library/mailbox.rst:925 msgid "" "When a :class:`MaildirMessage` instance is created based upon a :class:" "`BabylMessage` instance, the following conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:929 ../src/Doc/library/mailbox.rst:1068 -#: ../src/Doc/library/mailbox.rst:1179 ../src/Doc/library/mailbox.rst:1439 +#: library/mailbox.rst:929 library/mailbox.rst:1068 library/mailbox.rst:1179 +#: library/mailbox.rst:1439 msgid ":class:`BabylMessage` state" msgstr "" -#: ../src/Doc/library/mailbox.rst:931 ../src/Doc/library/mailbox.rst:1072 -#: ../src/Doc/library/mailbox.rst:1181 ../src/Doc/library/mailbox.rst:1278 -#: ../src/Doc/library/mailbox.rst:1296 ../src/Doc/library/mailbox.rst:1309 -#: ../src/Doc/library/mailbox.rst:1443 +#: library/mailbox.rst:931 library/mailbox.rst:1072 library/mailbox.rst:1181 +#: library/mailbox.rst:1278 library/mailbox.rst:1296 library/mailbox.rst:1309 +#: library/mailbox.rst:1443 msgid "\"unseen\" label" msgstr "" -#: ../src/Doc/library/mailbox.rst:933 ../src/Doc/library/mailbox.rst:1070 -#: ../src/Doc/library/mailbox.rst:1441 +#: library/mailbox.rst:933 library/mailbox.rst:1070 library/mailbox.rst:1441 msgid "no \"unseen\" label" msgstr "" -#: ../src/Doc/library/mailbox.rst:935 ../src/Doc/library/mailbox.rst:1284 +#: library/mailbox.rst:935 library/mailbox.rst:1284 msgid "P flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:935 +#: library/mailbox.rst:935 msgid "\"forwarded\" or \"resent\" label" msgstr "" -#: ../src/Doc/library/mailbox.rst:937 ../src/Doc/library/mailbox.rst:1076 -#: ../src/Doc/library/mailbox.rst:1183 ../src/Doc/library/mailbox.rst:1282 -#: ../src/Doc/library/mailbox.rst:1300 ../src/Doc/library/mailbox.rst:1311 -#: ../src/Doc/library/mailbox.rst:1447 +#: library/mailbox.rst:937 library/mailbox.rst:1076 library/mailbox.rst:1183 +#: library/mailbox.rst:1282 library/mailbox.rst:1300 library/mailbox.rst:1311 +#: library/mailbox.rst:1447 msgid "\"answered\" label" msgstr "" -#: ../src/Doc/library/mailbox.rst:939 ../src/Doc/library/mailbox.rst:1074 -#: ../src/Doc/library/mailbox.rst:1280 ../src/Doc/library/mailbox.rst:1298 -#: ../src/Doc/library/mailbox.rst:1445 +#: library/mailbox.rst:939 library/mailbox.rst:1074 library/mailbox.rst:1280 +#: library/mailbox.rst:1298 library/mailbox.rst:1445 msgid "\"deleted\" label" msgstr "" -#: ../src/Doc/library/mailbox.rst:946 +#: library/mailbox.rst:946 msgid ":class:`mboxMessage`" msgstr "" -#: ../src/Doc/library/mailbox.rst:951 +#: library/mailbox.rst:951 msgid "" "A message with mbox-specific behaviors. Parameter *message* has the same " "meaning as with the :class:`Message` constructor." msgstr "" -#: ../src/Doc/library/mailbox.rst:954 +#: library/mailbox.rst:954 msgid "" "Messages in an mbox mailbox are stored together in a single file. The " "sender's envelope address and the time of delivery are typically stored in a " @@ -60665,46 +61998,46 @@ msgid "" "typically stored in :mailheader:`Status` and :mailheader:`X-Status` headers." msgstr "" -#: ../src/Doc/library/mailbox.rst:962 +#: library/mailbox.rst:962 msgid "Conventional flags for mbox messages are as follows:" msgstr "" -#: ../src/Doc/library/mailbox.rst:969 ../src/Doc/library/mailbox.rst:1339 +#: library/mailbox.rst:969 library/mailbox.rst:1339 msgid "O" msgstr "" -#: ../src/Doc/library/mailbox.rst:969 ../src/Doc/library/mailbox.rst:1339 +#: library/mailbox.rst:969 library/mailbox.rst:1339 msgid "Old" msgstr "" -#: ../src/Doc/library/mailbox.rst:969 ../src/Doc/library/mailbox.rst:1339 +#: library/mailbox.rst:969 library/mailbox.rst:1339 msgid "Previously detected by MUA" msgstr "" -#: ../src/Doc/library/mailbox.rst:971 ../src/Doc/library/mailbox.rst:1341 +#: library/mailbox.rst:971 library/mailbox.rst:1341 msgid "Deleted" msgstr "" -#: ../src/Doc/library/mailbox.rst:975 ../src/Doc/library/mailbox.rst:1345 +#: library/mailbox.rst:975 library/mailbox.rst:1345 msgid "A" msgstr "" -#: ../src/Doc/library/mailbox.rst:975 ../src/Doc/library/mailbox.rst:1345 +#: library/mailbox.rst:975 library/mailbox.rst:1345 msgid "Answered" msgstr "" -#: ../src/Doc/library/mailbox.rst:978 ../src/Doc/library/mailbox.rst:1348 +#: library/mailbox.rst:978 library/mailbox.rst:1348 msgid "" "The \"R\" and \"O\" flags are stored in the :mailheader:`Status` header, and " "the \"D\", \"F\", and \"A\" flags are stored in the :mailheader:`X-Status` " "header. The flags and headers typically appear in the order mentioned." msgstr "" -#: ../src/Doc/library/mailbox.rst:982 +#: library/mailbox.rst:982 msgid ":class:`mboxMessage` instances offer the following methods:" msgstr "" -#: ../src/Doc/library/mailbox.rst:987 ../src/Doc/library/mailbox.rst:1358 +#: library/mailbox.rst:987 library/mailbox.rst:1358 msgid "" "Return a string representing the \"From \" line that marks the start of the " "message in an mbox mailbox. The leading \"From \" and the trailing newline " @@ -60713,7 +62046,7 @@ msgstr "" # 391f573c22da4eb987f8a85ac561e56d # e42793384255441c910d85f49f0e0091 -#: ../src/Doc/library/mailbox.rst:994 ../src/Doc/library/mailbox.rst:1365 +#: library/mailbox.rst:994 library/mailbox.rst:1365 msgid "" "Set the \"From \" line to *from_*, which should be specified without a " "leading \"From \" or trailing newline. For convenience, *time_* may be " @@ -60723,7 +62056,7 @@ msgid "" "meth:`time.gmtime`)." msgstr "" -#: ../src/Doc/library/mailbox.rst:1004 ../src/Doc/library/mailbox.rst:1375 +#: library/mailbox.rst:1004 library/mailbox.rst:1375 msgid "" "Return a string specifying the flags that are currently set. If the message " "complies with the conventional format, the result is the concatenation in " @@ -60731,28 +62064,28 @@ msgid "" "``'D'``, ``'F'``, and ``'A'``." msgstr "" -#: ../src/Doc/library/mailbox.rst:1012 ../src/Doc/library/mailbox.rst:1383 +#: library/mailbox.rst:1012 library/mailbox.rst:1383 msgid "" "Set the flags specified by *flags* and unset all others. Parameter *flags* " "should be the concatenation in any order of zero or more occurrences of each " "of ``'R'``, ``'O'``, ``'D'``, ``'F'``, and ``'A'``." msgstr "" -#: ../src/Doc/library/mailbox.rst:1019 ../src/Doc/library/mailbox.rst:1390 +#: library/mailbox.rst:1019 library/mailbox.rst:1390 msgid "" "Set the flag(s) specified by *flag* without changing other flags. To add " "more than one flag at a time, *flag* may be a string of more than one " "character." msgstr "" -#: ../src/Doc/library/mailbox.rst:1026 ../src/Doc/library/mailbox.rst:1397 +#: library/mailbox.rst:1026 library/mailbox.rst:1397 msgid "" "Unset the flag(s) specified by *flag* without changing other flags. To " "remove more than one flag at a time, *flag* maybe a string of more than one " "character." msgstr "" -#: ../src/Doc/library/mailbox.rst:1030 +#: library/mailbox.rst:1030 msgid "" "When an :class:`mboxMessage` instance is created based upon a :class:" "`MaildirMessage` instance, a \"From \" line is generated based upon the :" @@ -60760,50 +62093,50 @@ msgid "" "conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1036 ../src/Doc/library/mailbox.rst:1150 -#: ../src/Doc/library/mailbox.rst:1276 ../src/Doc/library/mailbox.rst:1407 +#: library/mailbox.rst:1036 library/mailbox.rst:1150 library/mailbox.rst:1276 +#: library/mailbox.rst:1407 msgid ":class:`MaildirMessage` state" msgstr "" -#: ../src/Doc/library/mailbox.rst:1049 +#: library/mailbox.rst:1049 msgid "" "When an :class:`mboxMessage` instance is created based upon an :class:" "`MHMessage` instance, the following conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1055 ../src/Doc/library/mailbox.rst:1070 -#: ../src/Doc/library/mailbox.rst:1426 ../src/Doc/library/mailbox.rst:1441 +#: library/mailbox.rst:1055 library/mailbox.rst:1070 library/mailbox.rst:1426 +#: library/mailbox.rst:1441 msgid "R flag and O flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:1064 +#: library/mailbox.rst:1064 msgid "" "When an :class:`mboxMessage` instance is created based upon a :class:" "`BabylMessage` instance, the following conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1079 +#: library/mailbox.rst:1079 msgid "" "When a :class:`Message` instance is created based upon an :class:" "`MMDFMessage` instance, the \"From \" line is copied and all flags directly " "correspond:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1083 +#: library/mailbox.rst:1083 msgid ":class:`MMDFMessage` state" msgstr "" -#: ../src/Doc/library/mailbox.rst:1100 +#: library/mailbox.rst:1100 msgid ":class:`MHMessage`" msgstr "" -#: ../src/Doc/library/mailbox.rst:1105 +#: library/mailbox.rst:1105 msgid "" "A message with MH-specific behaviors. Parameter *message* has the same " "meaning as with the :class:`Message` constructor." msgstr "" -#: ../src/Doc/library/mailbox.rst:1108 +#: library/mailbox.rst:1108 msgid "" "MH messages do not support marks or flags in the traditional sense, but they " "do support sequences, which are logical groupings of arbitrary messages. " @@ -60812,57 +62145,57 @@ msgid "" "formats, as follows:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1115 +#: library/mailbox.rst:1115 msgid "Sequence" msgstr "" -#: ../src/Doc/library/mailbox.rst:1117 ../src/Doc/library/mailbox.rst:1204 +#: library/mailbox.rst:1117 library/mailbox.rst:1204 msgid "unseen" msgstr "" -#: ../src/Doc/library/mailbox.rst:1117 ../src/Doc/library/mailbox.rst:1204 +#: library/mailbox.rst:1117 library/mailbox.rst:1204 msgid "Not read, but previously detected by MUA" msgstr "" -#: ../src/Doc/library/mailbox.rst:1119 +#: library/mailbox.rst:1119 msgid "replied" msgstr "" -#: ../src/Doc/library/mailbox.rst:1121 +#: library/mailbox.rst:1121 msgid "flagged" msgstr "" -#: ../src/Doc/library/mailbox.rst:1124 +#: library/mailbox.rst:1124 msgid ":class:`MHMessage` instances offer the following methods:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1129 +#: library/mailbox.rst:1129 msgid "Return a list of the names of sequences that include this message." msgstr "" -#: ../src/Doc/library/mailbox.rst:1134 +#: library/mailbox.rst:1134 msgid "Set the list of sequences that include this message." msgstr "" -#: ../src/Doc/library/mailbox.rst:1139 +#: library/mailbox.rst:1139 msgid "Add *sequence* to the list of sequences that include this message." msgstr "" -#: ../src/Doc/library/mailbox.rst:1144 +#: library/mailbox.rst:1144 msgid "Remove *sequence* from the list of sequences that include this message." msgstr "" -#: ../src/Doc/library/mailbox.rst:1146 +#: library/mailbox.rst:1146 msgid "" "When an :class:`MHMessage` instance is created based upon a :class:" "`MaildirMessage` instance, the following conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1152 ../src/Doc/library/mailbox.rst:1278 +#: library/mailbox.rst:1152 library/mailbox.rst:1278 msgid "no S flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:1159 +#: library/mailbox.rst:1159 msgid "" "When an :class:`MHMessage` instance is created based upon an :class:" "`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` " @@ -60870,111 +62203,111 @@ msgid "" "take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1168 ../src/Doc/library/mailbox.rst:1296 +#: library/mailbox.rst:1168 library/mailbox.rst:1296 msgid "no R flag" msgstr "" -#: ../src/Doc/library/mailbox.rst:1175 +#: library/mailbox.rst:1175 msgid "" "When an :class:`MHMessage` instance is created based upon a :class:" "`BabylMessage` instance, the following conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1190 +#: library/mailbox.rst:1190 msgid ":class:`BabylMessage`" msgstr "" -#: ../src/Doc/library/mailbox.rst:1195 +#: library/mailbox.rst:1195 msgid "" "A message with Babyl-specific behaviors. Parameter *message* has the same " "meaning as with the :class:`Message` constructor." msgstr "" -#: ../src/Doc/library/mailbox.rst:1198 +#: library/mailbox.rst:1198 msgid "" "Certain message labels, called :dfn:`attributes`, are defined by convention " "to have special meanings. The attributes are as follows:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1202 +#: library/mailbox.rst:1202 msgid "Label" msgstr "" -#: ../src/Doc/library/mailbox.rst:1206 +#: library/mailbox.rst:1206 msgid "deleted" msgstr "" -#: ../src/Doc/library/mailbox.rst:1208 +#: library/mailbox.rst:1208 msgid "filed" msgstr "" -#: ../src/Doc/library/mailbox.rst:1208 +#: library/mailbox.rst:1208 msgid "Copied to another file or mailbox" msgstr "" -#: ../src/Doc/library/mailbox.rst:1210 +#: library/mailbox.rst:1210 msgid "answered" msgstr "" -#: ../src/Doc/library/mailbox.rst:1212 +#: library/mailbox.rst:1212 msgid "forwarded" msgstr "" -#: ../src/Doc/library/mailbox.rst:1212 +#: library/mailbox.rst:1212 msgid "Forwarded" msgstr "" -#: ../src/Doc/library/mailbox.rst:1214 +#: library/mailbox.rst:1214 msgid "edited" msgstr "" -#: ../src/Doc/library/mailbox.rst:1214 +#: library/mailbox.rst:1214 msgid "Modified by the user" msgstr "" -#: ../src/Doc/library/mailbox.rst:1216 +#: library/mailbox.rst:1216 msgid "resent" msgstr "" -#: ../src/Doc/library/mailbox.rst:1216 +#: library/mailbox.rst:1216 msgid "Resent" msgstr "" -#: ../src/Doc/library/mailbox.rst:1219 +#: library/mailbox.rst:1219 msgid "" "By default, Rmail displays only visible headers. The :class:`BabylMessage` " "class, though, uses the original headers because they are more complete. " "Visible headers may be accessed explicitly if desired." msgstr "" -#: ../src/Doc/library/mailbox.rst:1223 +#: library/mailbox.rst:1223 msgid ":class:`BabylMessage` instances offer the following methods:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1228 +#: library/mailbox.rst:1228 msgid "Return a list of labels on the message." msgstr "" -#: ../src/Doc/library/mailbox.rst:1233 +#: library/mailbox.rst:1233 msgid "Set the list of labels on the message to *labels*." msgstr "" -#: ../src/Doc/library/mailbox.rst:1238 +#: library/mailbox.rst:1238 msgid "Add *label* to the list of labels on the message." msgstr "" -#: ../src/Doc/library/mailbox.rst:1243 +#: library/mailbox.rst:1243 msgid "Remove *label* from the list of labels on the message." msgstr "" -#: ../src/Doc/library/mailbox.rst:1248 +#: library/mailbox.rst:1248 msgid "" "Return an :class:`Message` instance whose headers are the message's visible " "headers and whose body is empty." msgstr "" # a9f5e4d7c77c4349a78935ee43c2f17b -#: ../src/Doc/library/mailbox.rst:1254 +#: library/mailbox.rst:1254 msgid "" "Set the message's visible headers to be the same as the headers in " "*message*. Parameter *visible* should be a :class:`Message` instance, an :" @@ -60982,7 +62315,7 @@ msgid "" "(which should be open in text mode)." msgstr "" -#: ../src/Doc/library/mailbox.rst:1262 +#: library/mailbox.rst:1262 msgid "" "When a :class:`BabylMessage` instance's original headers are modified, the " "visible headers are not automatically modified to correspond. This method " @@ -60995,17 +62328,17 @@ msgid "" "visible headers." msgstr "" -#: ../src/Doc/library/mailbox.rst:1272 +#: library/mailbox.rst:1272 msgid "" "When a :class:`BabylMessage` instance is created based upon a :class:" "`MaildirMessage` instance, the following conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1284 +#: library/mailbox.rst:1284 msgid "\"forwarded\" label" msgstr "" -#: ../src/Doc/library/mailbox.rst:1287 +#: library/mailbox.rst:1287 msgid "" "When a :class:`BabylMessage` instance is created based upon an :class:" "`mboxMessage` or :class:`MMDFMessage` instance, the :mailheader:`Status` " @@ -61013,23 +62346,23 @@ msgid "" "take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1303 +#: library/mailbox.rst:1303 msgid "" "When a :class:`BabylMessage` instance is created based upon an :class:" "`MHMessage` instance, the following conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1318 +#: library/mailbox.rst:1318 msgid ":class:`MMDFMessage`" msgstr "" -#: ../src/Doc/library/mailbox.rst:1323 +#: library/mailbox.rst:1323 msgid "" "A message with MMDF-specific behaviors. Parameter *message* has the same " "meaning as with the :class:`Message` constructor." msgstr "" -#: ../src/Doc/library/mailbox.rst:1326 +#: library/mailbox.rst:1326 msgid "" "As with message in an mbox mailbox, MMDF messages are stored with the " "sender's address and the delivery date in an initial line beginning with " @@ -61037,19 +62370,19 @@ msgid "" "typically stored in :mailheader:`Status` and :mailheader:`X-Status` headers." msgstr "" -#: ../src/Doc/library/mailbox.rst:1331 +#: library/mailbox.rst:1331 msgid "" "Conventional flags for MMDF messages are identical to those of mbox message " "and are as follows:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1352 +#: library/mailbox.rst:1352 msgid "" ":class:`MMDFMessage` instances offer the following methods, which are " "identical to those offered by :class:`mboxMessage`:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1401 +#: library/mailbox.rst:1401 msgid "" "When an :class:`MMDFMessage` instance is created based upon a :class:" "`MaildirMessage` instance, a \"From \" line is generated based upon the :" @@ -61057,44 +62390,44 @@ msgid "" "conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1420 +#: library/mailbox.rst:1420 msgid "" "When an :class:`MMDFMessage` instance is created based upon an :class:" "`MHMessage` instance, the following conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1435 +#: library/mailbox.rst:1435 msgid "" "When an :class:`MMDFMessage` instance is created based upon a :class:" "`BabylMessage` instance, the following conversions take place:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1450 +#: library/mailbox.rst:1450 msgid "" "When an :class:`MMDFMessage` instance is created based upon an :class:" "`mboxMessage` instance, the \"From \" line is copied and all flags directly " "correspond:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1455 +#: library/mailbox.rst:1455 msgid ":class:`mboxMessage` state" msgstr "" -#: ../src/Doc/library/mailbox.rst:1470 ../src/Doc/library/subprocess.rst:429 -#: ../src/Doc/library/xdrlib.rst:256 ../src/Doc/library/xml.dom.rst:824 +#: library/mailbox.rst:1470 library/subprocess.rst:429 library/xdrlib.rst:256 +#: library/xml.dom.rst:824 msgid "Exceptions" msgstr "Exceptions" -#: ../src/Doc/library/mailbox.rst:1472 +#: library/mailbox.rst:1472 msgid "" "The following exception classes are defined in the :mod:`mailbox` module:" msgstr "" -#: ../src/Doc/library/mailbox.rst:1477 +#: library/mailbox.rst:1477 msgid "The based class for all other module-specific exceptions." msgstr "" -#: ../src/Doc/library/mailbox.rst:1482 +#: library/mailbox.rst:1482 msgid "" "Raised when a mailbox is expected but is not found, such as when " "instantiating a :class:`Mailbox` subclass with a path that does not exist " @@ -61102,13 +62435,13 @@ msgid "" "that does not exist." msgstr "" -#: ../src/Doc/library/mailbox.rst:1489 +#: library/mailbox.rst:1489 msgid "" "Raised when a mailbox is not empty but is expected to be, such as when " "deleting a folder that contains messages." msgstr "" -#: ../src/Doc/library/mailbox.rst:1495 +#: library/mailbox.rst:1495 msgid "" "Raised when some mailbox-related condition beyond the control of the program " "causes it to be unable to proceed, such as when failing to acquire a lock " @@ -61116,19 +62449,19 @@ msgid "" "name already exists." msgstr "" -#: ../src/Doc/library/mailbox.rst:1503 +#: library/mailbox.rst:1503 msgid "" "Raised when the data in a file cannot be parsed, such as when an :class:`MH` " "instance attempts to read a corrupted :file:`.mh_sequences` file." msgstr "" # 93058381aed248159b87c70bae98f4cc -#: ../src/Doc/library/mailbox.rst:1510 +#: library/mailbox.rst:1510 msgid "Deprecated classes and methods" msgstr "" # dd17289d98bf4b93bec1e93934bb494a -#: ../src/Doc/library/mailbox.rst:1514 +#: library/mailbox.rst:1514 msgid "" "Older versions of the :mod:`mailbox` module do not support modification of " "mailboxes, such as adding or removing message, and do not provide classes to " @@ -61139,14 +62472,14 @@ msgid "" msgstr "" # b567d1ddc1104520b1b4525241489fab -#: ../src/Doc/library/mailbox.rst:1520 +#: library/mailbox.rst:1520 msgid "" "Older mailbox objects support only iteration and provide a single public " "method:" msgstr "" # 76b7003ba02b421786f3b6f6dac27fb2 -#: ../src/Doc/library/mailbox.rst:1525 +#: library/mailbox.rst:1525 msgid "" "Return the next message in the mailbox, created with the optional *factory* " "argument passed into the mailbox object's constructor. By default this is " @@ -61159,7 +62492,7 @@ msgid "" msgstr "" # 321b4fe4321544129d4c3c43dbda2b82 -#: ../src/Doc/library/mailbox.rst:1533 +#: library/mailbox.rst:1533 msgid "" "Most of the older mailbox classes have names that differ from the current " "mailbox class names, except for :class:`Maildir`. For this reason, the new :" @@ -61168,14 +62501,14 @@ msgid "" msgstr "" # c61fccc9ac1b4a72ab167ccb1f554d00 -#: ../src/Doc/library/mailbox.rst:1538 +#: library/mailbox.rst:1538 msgid "" "The older mailbox classes whose names are not the same as their newer " "counterparts are as follows:" msgstr "" # 8e48fa9dd1844a67914e87608dec1c93 -#: ../src/Doc/library/mailbox.rst:1544 +#: library/mailbox.rst:1544 msgid "" "Access to a classic Unix-style mailbox, where all messages are contained in " "a single file and separated by ``From`` (a.k.a. ``From_``) lines. The file " @@ -61187,7 +62520,7 @@ msgid "" msgstr "" # aacd7ca20f6842098c3481b9a1be2f1e -#: ../src/Doc/library/mailbox.rst:1554 +#: library/mailbox.rst:1554 msgid "" "For reasons of this module's internal implementation, you will probably want " "to open the *fp* object in binary mode. This is especially important on " @@ -61195,7 +62528,7 @@ msgid "" msgstr "" # 739a62d26777464a8ad8ebd2c11655dd -#: ../src/Doc/library/mailbox.rst:1557 +#: library/mailbox.rst:1557 msgid "" "For maximum portability, messages in a Unix-style mailbox are separated by " "any line that begins exactly with the string ``'From '`` (note the trailing " @@ -61206,7 +62539,7 @@ msgid "" msgstr "" # 564ceb9fffb4456d9752b458654559de -#: ../src/Doc/library/mailbox.rst:1564 +#: library/mailbox.rst:1564 msgid "" "The :class:`UnixMailbox` class implements a more strict version of ``From_`` " "line checking, using a regular expression that usually correctly matched " @@ -61218,7 +62551,7 @@ msgid "" msgstr "" # 39b2eb77602245698797a6103d8201fa -#: ../src/Doc/library/mailbox.rst:1575 +#: library/mailbox.rst:1575 msgid "" "A less-strict version of :class:`UnixMailbox`, which considers only the " "``From`` at the beginning of the line separating messages. The \"*name* " @@ -61229,7 +62562,7 @@ msgid "" msgstr "" # fe6d3af6293948df8e01948bca5fbec1 -#: ../src/Doc/library/mailbox.rst:1584 +#: library/mailbox.rst:1584 msgid "" "Access an MMDF-style mailbox, where all messages are contained in a single " "file and separated by lines consisting of 4 control-A characters. The file " @@ -61238,7 +62571,7 @@ msgid "" msgstr "" # 9618f684fad8472794efbbe9b5553418 -#: ../src/Doc/library/mailbox.rst:1592 +#: library/mailbox.rst:1592 msgid "" "Access an MH mailbox, a directory with each message in a separate file with " "a numeric name. The name of the mailbox directory is passed in *dirname*. " @@ -61246,7 +62579,7 @@ msgid "" msgstr "" # 5ee033f9111d4ee2b4c12da368bf71c6 -#: ../src/Doc/library/mailbox.rst:1599 +#: library/mailbox.rst:1599 msgid "" "Access a Babyl mailbox, which is similar to an MMDF mailbox. In Babyl " "format, each message has two sets of headers, the *original* headers and the " @@ -61261,32 +62594,32 @@ msgid "" msgstr "" # 8cbe99acb4874de2bbc15ab026ce90f6 -#: ../src/Doc/library/mailbox.rst:1610 +#: library/mailbox.rst:1610 msgid "" "If you wish to use the older mailbox classes with the :mod:`email` module " "rather than the deprecated :mod:`rfc822` module, you can do so as follows::" msgstr "" # 78e1f058b27d4c5cbcf67964e392bb9a -#: ../src/Doc/library/mailbox.rst:1627 +#: library/mailbox.rst:1627 msgid "" "Alternatively, if you know your mailbox contains only well-formed MIME " "messages, you can simplify this to::" msgstr "" -#: ../src/Doc/library/mailbox.rst:1641 +#: library/mailbox.rst:1641 msgid "" "A simple example of printing the subjects of all messages in a mailbox that " "seem interesting::" msgstr "" -#: ../src/Doc/library/mailbox.rst:1650 +#: library/mailbox.rst:1650 msgid "" "To copy all mail from a Babyl mailbox to an MH mailbox, converting all of " "the format-specific information that can be converted::" msgstr "" -#: ../src/Doc/library/mailbox.rst:1661 +#: library/mailbox.rst:1661 msgid "" "This example sorts mail from several mailing lists into different mailboxes, " "being careful to avoid mail corruption due to concurrent modification by " @@ -61294,16 +62627,16 @@ msgid "" "termination due to malformed messages in the mailbox::" msgstr "" -#: ../src/Doc/library/mailcap.rst:2 +#: library/mailcap.rst:2 msgid ":mod:`mailcap` --- Mailcap file handling" msgstr "" # a57ddaebe8664956b6e854c5ca9d6ec6 -#: ../src/Doc/library/mailcap.rst:7 +#: library/mailcap.rst:7 msgid "**Source code:** :source:`Lib/mailcap.py`" msgstr "" -#: ../src/Doc/library/mailcap.rst:11 +#: library/mailcap.rst:11 msgid "" "Mailcap files are used to configure how MIME-aware applications such as mail " "readers and Web browsers react to files with different MIME types. (The name " @@ -61315,7 +62648,7 @@ msgid "" "automatically started to view the file." msgstr "" -#: ../src/Doc/library/mailcap.rst:20 +#: library/mailcap.rst:20 msgid "" "The mailcap format is documented in :rfc:`1524`, \"A User Agent " "Configuration Mechanism For Multimedia Mail Format Information,\" but is not " @@ -61323,7 +62656,7 @@ msgid "" "systems." msgstr "" -#: ../src/Doc/library/mailcap.rst:27 +#: library/mailcap.rst:27 msgid "" "Return a 2-tuple; the first element is a string containing the command line " "to be executed (which can be passed to :func:`os.system`), and the second " @@ -61331,7 +62664,7 @@ msgid "" "type can be found, ``(None, None)`` is returned." msgstr "" -#: ../src/Doc/library/mailcap.rst:32 +#: library/mailcap.rst:32 msgid "" "*key* is the name of the field desired, which represents the type of " "activity to be performed; the default value is 'view', since in the most " @@ -61341,14 +62674,14 @@ msgid "" "`1524` for a complete list of these fields." msgstr "" -#: ../src/Doc/library/mailcap.rst:39 +#: library/mailcap.rst:39 msgid "" "*filename* is the filename to be substituted for ``%s`` in the command line; " "the default value is ``'/dev/null'`` which is almost certainly not what you " "want, so usually you'll override it by specifying a filename." msgstr "" -#: ../src/Doc/library/mailcap.rst:43 +#: library/mailcap.rst:43 msgid "" "*plist* can be a list containing named parameters; the default value is " "simply an empty list. Each entry in the list must be a string containing " @@ -61360,7 +62693,7 @@ msgid "" "command line would be ``'showpartial 1 2 3'``." msgstr "" -#: ../src/Doc/library/mailcap.rst:52 +#: library/mailcap.rst:52 msgid "" "In a mailcap file, the \"test\" field can optionally be specified to test " "some external condition (such as the machine architecture, or the window " @@ -61369,7 +62702,7 @@ msgid "" "the check fails." msgstr "" -#: ../src/Doc/library/mailcap.rst:60 +#: library/mailcap.rst:60 msgid "" "Returns a dictionary mapping MIME types to a list of mailcap file entries. " "This dictionary must be passed to the :func:`findmatch` function. An entry " @@ -61377,7 +62710,7 @@ msgid "" "the details of this representation." msgstr "" -#: ../src/Doc/library/mailcap.rst:65 +#: library/mailcap.rst:65 msgid "" "The information is derived from all of the mailcap files found on the " "system. Settings in the user's mailcap file :file:`$HOME/.mailcap` will " @@ -61385,15 +62718,15 @@ msgid "" "usr/etc/mailcap`, and :file:`/usr/local/etc/mailcap`." msgstr "" -#: ../src/Doc/library/mailcap.rst:70 +#: library/mailcap.rst:70 msgid "An example usage::" msgstr "" -#: ../src/Doc/library/markup.rst:5 +#: library/markup.rst:5 msgid "Structured Markup Processing Tools" msgstr "" -#: ../src/Doc/library/markup.rst:7 +#: library/markup.rst:7 msgid "" "Python supports a variety of modules to work with various forms of " "structured data markup. This includes modules to work with the Standard " @@ -61402,7 +62735,7 @@ msgid "" msgstr "" # 58e2c52229d44837ba3159514d7e5de9 -#: ../src/Doc/library/markup.rst:12 +#: library/markup.rst:12 msgid "" "It is important to note that modules in the :mod:`xml` package require that " "there be at least one SAX-compliant XML parser available. Starting with " @@ -61412,17 +62745,17 @@ msgid "" "package provides an extended set of XML libraries for Python." msgstr "" -#: ../src/Doc/library/markup.rst:19 ../src/Doc/library/xml.rst:25 +#: library/markup.rst:19 library/xml.rst:25 msgid "" "The documentation for the :mod:`xml.dom` and :mod:`xml.sax` packages are the " "definition of the Python bindings for the DOM and SAX interfaces." msgstr "" -#: ../src/Doc/library/marshal.rst:3 +#: library/marshal.rst:3 msgid ":mod:`marshal` --- Internal Python object serialization" msgstr "" -#: ../src/Doc/library/marshal.rst:10 +#: library/marshal.rst:10 msgid "" "This module contains functions that can read and write Python values in a " "binary format. The format is specific to Python, but independent of machine " @@ -61432,7 +62765,7 @@ msgid "" "it rarely does). [#]_" msgstr "" -#: ../src/Doc/library/marshal.rst:22 +#: library/marshal.rst:22 msgid "" "This is not a general \"persistence\" module. For general persistence and " "transfer of Python objects through RPC calls, see the modules :mod:`pickle` " @@ -61446,7 +62779,7 @@ msgid "" "marshal." msgstr "" -#: ../src/Doc/library/marshal.rst:34 +#: library/marshal.rst:34 msgid "" "The :mod:`marshal` module is not intended to be secure against erroneous or " "maliciously constructed data. Never unmarshal data received from an " @@ -61454,7 +62787,7 @@ msgid "" msgstr "" # 14a2044080044b018df677850ee7bc76 -#: ../src/Doc/library/marshal.rst:38 +#: library/marshal.rst:38 msgid "" "Not all Python object types are supported; in general, only objects whose " "value is independent from a particular invocation of Python can be written " @@ -61470,7 +62803,7 @@ msgid "" msgstr "" # 3498beb64dd741698dc82515ccd3c81c -#: ../src/Doc/library/marshal.rst:51 +#: library/marshal.rst:51 msgid "" "On machines where C's ``long int`` type has more than 32 bits (such as the " "DEC Alpha), it is possible to create plain Python integers that are longer " @@ -61482,18 +62815,18 @@ msgid "" "was printed.)" msgstr "" -#: ../src/Doc/library/marshal.rst:60 +#: library/marshal.rst:60 msgid "" "There are functions that read/write files as well as functions operating on " "strings." msgstr "" -#: ../src/Doc/library/marshal.rst:63 +#: library/marshal.rst:63 msgid "The module defines these functions:" msgstr "" # e23e8f70d6cf4203b99a08946f591977 -#: ../src/Doc/library/marshal.rst:68 +#: library/marshal.rst:68 msgid "" "Write the value on the open file. The value must be a supported type. The " "file must be a open file object such as ``sys.stdout`` or returned by :func:" @@ -61501,7 +62834,7 @@ msgid "" "on Windows. It must be opened in binary mode (``'wb'`` or ``'w+b'``)." msgstr "" -#: ../src/Doc/library/marshal.rst:74 +#: library/marshal.rst:74 msgid "" "If the value has (or contains an object that has) an unsupported type, a :" "exc:`ValueError` exception is raised --- but garbage data will also be " @@ -61509,7 +62842,13 @@ msgid "" "`load`." msgstr "" -#: ../src/Doc/library/marshal.rst:85 +#: library/marshal.rst:78 +msgid "" +"The *version* argument indicates the data format that ``dump`` should use " +"(see below)." +msgstr "" + +#: library/marshal.rst:85 msgid "" "Read one value from the open file and return it. If no valid value is read " "(e.g. because the data has a different Python version's incompatible marshal " @@ -61518,32 +62857,38 @@ msgid "" "+b'``)." msgstr "" -#: ../src/Doc/library/marshal.rst:93 +#: library/marshal.rst:93 msgid "" "If an object containing an unsupported type was marshalled with :func:" "`dump`, :func:`load` will substitute ``None`` for the unmarshallable type." msgstr "" -#: ../src/Doc/library/marshal.rst:99 +#: library/marshal.rst:99 msgid "" "Return the string that would be written to a file by ``dump(value, file)``. " "The value must be a supported type. Raise a :exc:`ValueError` exception if " "value has (or contains an object that has) an unsupported type." msgstr "" -#: ../src/Doc/library/marshal.rst:110 +#: library/marshal.rst:103 +msgid "" +"The *version* argument indicates the data format that ``dumps`` should use " +"(see below)." +msgstr "" + +#: library/marshal.rst:110 msgid "" "Convert the string to a value. If no valid value is found, raise :exc:" "`EOFError`, :exc:`ValueError` or :exc:`TypeError`. Extra characters in the " "string are ignored." msgstr "" -#: ../src/Doc/library/marshal.rst:115 +#: library/marshal.rst:115 msgid "In addition, the following constants are defined:" msgstr "" # 510686d08f094d23b07cff12a190b0d7 -#: ../src/Doc/library/marshal.rst:119 +#: library/marshal.rst:119 msgid "" "Indicates the format that the module uses. Version 0 is the historical " "format, version 1 (added in Python 2.4) shares interned strings and version " @@ -61551,7 +62896,7 @@ msgid "" "current version is 2." msgstr "" -#: ../src/Doc/library/marshal.rst:129 +#: library/marshal.rst:129 msgid "" "The name of this module stems from a bit of terminology used by the " "designers of Modula-3 (amongst others), who use the term \"marshalling\" for " @@ -61560,17 +62905,17 @@ msgid "" "RPC buffer for instance) and \"unmarshalling\" for the reverse process." msgstr "" -#: ../src/Doc/library/math.rst:3 +#: library/math.rst:3 msgid ":mod:`math` --- Mathematical functions" msgstr "" -#: ../src/Doc/library/math.rst:12 +#: library/math.rst:12 msgid "" "This module is always available. It provides access to the mathematical " "functions defined by the C standard." msgstr "" -#: ../src/Doc/library/math.rst:15 +#: library/math.rst:15 msgid "" "These functions cannot be used with complex numbers; use the functions of " "the same name from the :mod:`cmath` module if you require support for " @@ -61582,47 +62927,47 @@ msgid "" "can determine how and why it was generated in the first place." msgstr "" -#: ../src/Doc/library/math.rst:24 +#: library/math.rst:24 msgid "" "The following functions are provided by this module. Except when explicitly " "noted otherwise, all return values are floats." msgstr "" -#: ../src/Doc/library/math.rst:29 +#: library/math.rst:29 msgid "Number-theoretic and representation functions" msgstr "" # 81148c89ad5749b9854cc8739360f961 -#: ../src/Doc/library/math.rst:33 +#: library/math.rst:33 msgid "" "Return the ceiling of *x* as a float, the smallest integer value greater " "than or equal to *x*." msgstr "" -#: ../src/Doc/library/math.rst:39 +#: library/math.rst:39 msgid "" "Return *x* with the sign of *y*. On a platform that supports signed zeros, " "``copysign(1.0, -0.0)`` returns *-1.0*." msgstr "" -#: ../src/Doc/library/math.rst:47 +#: library/math.rst:47 msgid "Return the absolute value of *x*." msgstr "" -#: ../src/Doc/library/math.rst:52 +#: library/math.rst:52 msgid "" "Return *x* factorial. Raises :exc:`ValueError` if *x* is not integral or is " "negative." msgstr "" # be31bb1f90f04219bdbefab05f20f839 -#: ../src/Doc/library/math.rst:60 +#: library/math.rst:60 msgid "" "Return the floor of *x* as a float, the largest integer value less than or " "equal to *x*." msgstr "" -#: ../src/Doc/library/math.rst:66 +#: library/math.rst:66 msgid "" "Return ``fmod(x, y)``, as defined by the platform C library. Note that the " "Python expression ``x % y`` may not return the same result. The intent of " @@ -61638,7 +62983,7 @@ msgid "" "preferred when working with integers." msgstr "" -#: ../src/Doc/library/math.rst:81 +#: library/math.rst:81 msgid "" "Return the mantissa and exponent of *x* as the pair ``(m, e)``. *m* is a " "float and *e* is an integer such that ``x == m * 2**e`` exactly. If *x* is " @@ -61647,14 +62992,14 @@ msgid "" msgstr "" # 090da423c5454e758c4ba708eafa7dc7 -#: ../src/Doc/library/math.rst:89 +#: library/math.rst:89 msgid "" "Return an accurate floating point sum of values in the iterable. Avoids " "loss of precision by tracking multiple intermediate partial sums::" msgstr "" # c3bf55ac023b4fc0b64f111ac8a5536c -#: ../src/Doc/library/math.rst:97 +#: library/math.rst:97 msgid "" "The algorithm's accuracy depends on IEEE-754 arithmetic guarantees and the " "typical case where the rounding mode is half-even. On some non-Windows " @@ -61664,43 +63009,43 @@ msgid "" msgstr "" # a847e1e8fc184b67a8ee5e7cabedf406 -#: ../src/Doc/library/math.rst:103 +#: library/math.rst:103 msgid "" "For further discussion and two alternative approaches, see the `ASPN " "cookbook recipes for accurate floating point summation `_\\." msgstr "" -#: ../src/Doc/library/math.rst:112 +#: library/math.rst:112 msgid "Check if the float *x* is positive or negative infinity." msgstr "" -#: ../src/Doc/library/math.rst:119 +#: library/math.rst:119 msgid "" "Check if the float *x* is a NaN (not a number). For more information on " "NaNs, see the IEEE 754 standards." msgstr "" -#: ../src/Doc/library/math.rst:127 +#: library/math.rst:127 msgid "" "Return ``x * (2**i)``. This is essentially the inverse of function :func:" "`frexp`." msgstr "" -#: ../src/Doc/library/math.rst:133 +#: library/math.rst:133 msgid "" "Return the fractional and integer parts of *x*. Both results carry the sign " "of *x* and are floats." msgstr "" # add25668ddbf4248bc499cccba326466 -#: ../src/Doc/library/math.rst:139 +#: library/math.rst:139 msgid "" "Return the :class:`~numbers.Real` value *x* truncated to an :class:`~numbers." "Integral` (usually a long integer). Uses the ``__trunc__`` method." msgstr "" -#: ../src/Doc/library/math.rst:146 +#: library/math.rst:146 msgid "" "Note that :func:`frexp` and :func:`modf` have a different call/return " "pattern than their C equivalents: they take a single argument and return a " @@ -61708,7 +63053,7 @@ msgid "" "'output parameter' (there is no such thing in Python)." msgstr "" -#: ../src/Doc/library/math.rst:151 +#: library/math.rst:151 msgid "" "For the :func:`ceil`, :func:`floor`, and :func:`modf` functions, note that " "*all* floating-point numbers of sufficiently large magnitude are exact " @@ -61717,40 +63062,40 @@ msgid "" "``abs(x) >= 2**52`` necessarily has no fractional bits." msgstr "" -#: ../src/Doc/library/math.rst:163 +#: library/math.rst:163 msgid "Return ``e**x``." msgstr "" -#: ../src/Doc/library/math.rst:168 +#: library/math.rst:168 msgid "" "Return ``e**x - 1``. For small floats *x*, the subtraction in ``exp(x) - " "1`` can result in a significant loss of precision; the :func:`expm1` " "function provides a way to compute this quantity to full precision::" msgstr "" -#: ../src/Doc/library/math.rst:184 +#: library/math.rst:184 msgid "With one argument, return the natural logarithm of *x* (to base *e*)." msgstr "" -#: ../src/Doc/library/math.rst:186 +#: library/math.rst:186 msgid "" "With two arguments, return the logarithm of *x* to the given *base*, " "calculated as ``log(x)/log(base)``." msgstr "" -#: ../src/Doc/library/math.rst:195 +#: library/math.rst:195 msgid "" "Return the natural logarithm of *1+x* (base *e*). The result is calculated " "in a way which is accurate for *x* near zero." msgstr "" -#: ../src/Doc/library/math.rst:203 +#: library/math.rst:203 msgid "" "Return the base-10 logarithm of *x*. This is usually more accurate than " "``log(x, 10)``." msgstr "" -#: ../src/Doc/library/math.rst:209 +#: library/math.rst:209 msgid "" "Return ``x`` raised to the power ``y``. Exceptional cases follow Annex 'F' " "of the C99 standard as far as possible. In particular, ``pow(1.0, x)`` and " @@ -61760,30 +63105,34 @@ msgid "" msgstr "" # b96fafb405744235b091ab6a6bcf43a7 -#: ../src/Doc/library/math.rst:216 +#: library/math.rst:216 msgid "" "Unlike the built-in ``**`` operator, :func:`math.pow` converts both its " "arguments to type :class:`float`. Use ``**`` or the built-in :func:`pow` " "function for computing exact integer powers." msgstr "" -#: ../src/Doc/library/math.rst:226 +#: library/math.rst:220 +msgid "The outcome of ``1**nan`` and ``nan**0`` was undefined." +msgstr "" + +#: library/math.rst:226 msgid "Return the square root of *x*." msgstr "" -#: ../src/Doc/library/math.rst:234 +#: library/math.rst:234 msgid "Return the arc cosine of *x*, in radians." msgstr "" -#: ../src/Doc/library/math.rst:239 +#: library/math.rst:239 msgid "Return the arc sine of *x*, in radians." msgstr "" -#: ../src/Doc/library/math.rst:244 +#: library/math.rst:244 msgid "Return the arc tangent of *x*, in radians." msgstr "" -#: ../src/Doc/library/math.rst:249 +#: library/math.rst:249 msgid "" "Return ``atan(y / x)``, in radians. The result is between ``-pi`` and " "``pi``. The vector in the plane from the origin to point ``(x, y)`` makes " @@ -61793,79 +63142,79 @@ msgid "" "``pi/4``, but ``atan2(-1, -1)`` is ``-3*pi/4``." msgstr "" -#: ../src/Doc/library/math.rst:259 +#: library/math.rst:259 msgid "Return the cosine of *x* radians." msgstr "" -#: ../src/Doc/library/math.rst:264 +#: library/math.rst:264 msgid "" "Return the Euclidean norm, ``sqrt(x*x + y*y)``. This is the length of the " "vector from the origin to point ``(x, y)``." msgstr "" -#: ../src/Doc/library/math.rst:270 +#: library/math.rst:270 msgid "Return the sine of *x* radians." msgstr "" -#: ../src/Doc/library/math.rst:275 +#: library/math.rst:275 msgid "Return the tangent of *x* radians." msgstr "" -#: ../src/Doc/library/math.rst:279 +#: library/math.rst:279 msgid "Angular conversion" msgstr "" -#: ../src/Doc/library/math.rst:283 -msgid "Converts angle *x* from radians to degrees." +#: library/math.rst:283 +msgid "Convert angle *x* from radians to degrees." msgstr "" -#: ../src/Doc/library/math.rst:288 -msgid "Converts angle *x* from degrees to radians." +#: library/math.rst:288 +msgid "Convert angle *x* from degrees to radians." msgstr "" -#: ../src/Doc/library/math.rst:296 +#: library/math.rst:296 msgid "Return the inverse hyperbolic cosine of *x*." msgstr "" -#: ../src/Doc/library/math.rst:303 +#: library/math.rst:303 msgid "Return the inverse hyperbolic sine of *x*." msgstr "" -#: ../src/Doc/library/math.rst:310 +#: library/math.rst:310 msgid "Return the inverse hyperbolic tangent of *x*." msgstr "" -#: ../src/Doc/library/math.rst:331 +#: library/math.rst:331 msgid "Special functions" msgstr "" -#: ../src/Doc/library/math.rst:335 +#: library/math.rst:335 msgid "Return the error function at *x*." msgstr "" -#: ../src/Doc/library/math.rst:342 +#: library/math.rst:342 msgid "Return the complementary error function at *x*." msgstr "" -#: ../src/Doc/library/math.rst:349 +#: library/math.rst:349 msgid "Return the Gamma function at *x*." msgstr "" -#: ../src/Doc/library/math.rst:356 +#: library/math.rst:356 msgid "" "Return the natural logarithm of the absolute value of the Gamma function at " "*x*." msgstr "" -#: ../src/Doc/library/math.rst:367 +#: library/math.rst:367 msgid "The mathematical constant π = 3.141592..., to available precision." msgstr "" -#: ../src/Doc/library/math.rst:372 +#: library/math.rst:372 msgid "The mathematical constant e = 2.718281..., to available precision." msgstr "" -#: ../src/Doc/library/math.rst:377 +#: library/math.rst:377 msgid "" "The :mod:`math` module consists mostly of thin wrappers around the platform " "C math library functions. Behavior in exceptional cases follows Annex F of " @@ -61880,29 +63229,39 @@ msgid "" "``hypot(float('nan'), float('inf'))``." msgstr "" -#: ../src/Doc/library/math.rst:389 +#: library/math.rst:389 msgid "" "Note that Python makes no effort to distinguish signaling NaNs from quiet " "NaNs, and behavior for signaling NaNs remains unspecified. Typical behavior " "is to treat all NaNs as though they were quiet." msgstr "" -# 33adc4f5a7b8413c8a6705440674e1bc -#: ../src/Doc/library/math.rst:399 -msgid "Module :mod:`cmath`" +#: library/math.rst:393 +msgid "" +"Behavior in special cases now aims to follow C99 Annex F. In earlier " +"versions of Python the behavior in special cases was loosely specified." msgstr "" -#: ../src/Doc/library/math.rst:401 +#: library/math.rst:400 +#, fuzzy +msgid "Module cmath" +msgstr "Modules" + +#: library/math.rst:401 msgid "Complex number versions of many of these functions." msgstr "" # 0b9703e818ea4d93bd2902af5ad71ef1 -#: ../src/Doc/library/md5.rst:3 +#: library/md5.rst:3 msgid ":mod:`md5` --- MD5 message digest algorithm" msgstr "" +#: library/md5.rst:10 library/sha.rst:11 +msgid "Use the :mod:`hashlib` module instead." +msgstr "" + # f04373932c434f75a7a272945ae05852 -#: ../src/Doc/library/md5.rst:17 +#: library/md5.rst:17 msgid "" "This module implements the interface to RSA's MD5 message digest algorithm " "(see also Internet :rfc:`1321`). Its use is quite straightforward: use :" @@ -61914,43 +63273,43 @@ msgid "" msgstr "" # dd527d2cbe6d4187b080c99817019cb4 -#: ../src/Doc/library/md5.rst:39 +#: library/md5.rst:39 msgid "" "The following values are provided as constants in the module and as " "attributes of the md5 objects returned by :func:`new`:" msgstr "" # c462c665df1f460883dc31ed84ca007d -#: ../src/Doc/library/md5.rst:45 +#: library/md5.rst:45 msgid "The size of the resulting digest in bytes. This is always ``16``." msgstr "" # 9309b63228f04f948f7124976f03f9c3 -#: ../src/Doc/library/md5.rst:47 +#: library/md5.rst:47 msgid "The md5 module provides the following functions:" msgstr "" # 8159d1909685460b8072c7035256c63f -#: ../src/Doc/library/md5.rst:52 +#: library/md5.rst:52 msgid "" "Return a new md5 object. If *arg* is present, the method call " "``update(arg)`` is made." msgstr "" # f82c57e88b7e4c23bd8e7688de6058ee -#: ../src/Doc/library/md5.rst:58 +#: library/md5.rst:58 msgid "" "For backward compatibility reasons, this is an alternative name for the :" "func:`new` function." msgstr "" # 62950e5836cd45eda6a51f2553af38c6 -#: ../src/Doc/library/md5.rst:61 +#: library/md5.rst:61 msgid "An md5 object has the following methods:" msgstr "" # b1988bd896994710b7014b78d49be0bc -#: ../src/Doc/library/md5.rst:66 +#: library/md5.rst:66 msgid "" "Update the md5 object with the string *arg*. Repeated calls are equivalent " "to a single call with the concatenation of all the arguments: ``m.update(a); " @@ -61958,7 +63317,7 @@ msgid "" msgstr "" # ddea4caab76940ed94ee1b302a9e7d10 -#: ../src/Doc/library/md5.rst:73 +#: library/md5.rst:73 msgid "" "Return the digest of the strings passed to the :meth:`update` method so far. " "This is a 16-byte string which may contain non-ASCII characters, including " @@ -61966,7 +63325,7 @@ msgid "" msgstr "" # 587ecd495d0b4960a52663a36c79c189 -#: ../src/Doc/library/md5.rst:80 +#: library/md5.rst:80 msgid "" "Like :meth:`digest` except the digest is returned as a string of length 32, " "containing only hexadecimal digits. This may be used to exchange the value " @@ -61974,39 +63333,45 @@ msgid "" msgstr "" # 868908b64adc4c2db2d131a19f13d538 -#: ../src/Doc/library/md5.rst:87 +#: library/md5.rst:87 msgid "" "Return a copy (\"clone\") of the md5 object. This can be used to " "efficiently compute the digests of strings that share a common initial " "substring." msgstr "" -# 555391e0a9584832b5bcd91cf345796a -#: ../src/Doc/library/md5.rst:93 -msgid "Module :mod:`sha`" -msgstr "" +#: library/md5.rst:94 +#, fuzzy +msgid "Module sha" +msgstr "Modules" # a79d281b49d44bc0aeb67e61fbdb0060 -#: ../src/Doc/library/md5.rst:94 +#: library/md5.rst:94 msgid "" "Similar module implementing the Secure Hash Algorithm (SHA). The SHA " "algorithm is considered a more secure hash." msgstr "" # 66bd4f365e5f493cbdd8a06a858dbeef -#: ../src/Doc/library/mhlib.rst:2 +#: library/mhlib.rst:2 msgid ":mod:`mhlib` --- Access to MH mailboxes" msgstr "" +#: library/mhlib.rst:8 +msgid "" +"The :mod:`mhlib` module has been removed in Python 3. Use the :mod:`mailbox` " +"instead." +msgstr "" + # 66b5de73c83c436f9bea99aa500f111d -#: ../src/Doc/library/mhlib.rst:14 +#: library/mhlib.rst:14 msgid "" "The :mod:`mhlib` module provides a Python interface to MH folders and their " "contents." msgstr "" # 74a719a89cda4dd1844657f1b41e2449 -#: ../src/Doc/library/mhlib.rst:17 +#: library/mhlib.rst:17 msgid "" "The module contains three basic classes, :class:`MH`, which represents a " "particular collection of folders, :class:`Folder`, which represents a single " @@ -62014,207 +63379,214 @@ msgid "" msgstr "" # 382d62284c054a43a4d6ea3c893e2035 -#: ../src/Doc/library/mhlib.rst:24 +#: library/mhlib.rst:24 msgid ":class:`MH` represents a collection of MH folders." msgstr "" # 7bfab9de96ef46749368c246fd5b09fa -#: ../src/Doc/library/mhlib.rst:29 +#: library/mhlib.rst:29 msgid "The :class:`Folder` class represents a single folder and its messages." msgstr "" # 3299e26cba9c4ec0be3647ad1b58028b -#: ../src/Doc/library/mhlib.rst:34 +#: library/mhlib.rst:34 msgid "" ":class:`Message` objects represent individual messages in a folder. The " "Message class is derived from :class:`mimetools.Message`." msgstr "" # 691b4bc0976f440cb619c7ee3c45ce7f -#: ../src/Doc/library/mhlib.rst:41 +#: library/mhlib.rst:41 msgid "MH Objects" msgstr "" # 4d46483157f945d1b4f8aeb09ab4e1bb -#: ../src/Doc/library/mhlib.rst:43 +#: library/mhlib.rst:43 msgid ":class:`MH` instances have the following methods:" msgstr "" # dfc2a57fc1dd402aa375d4484b31dc13 # 0c47b058dec849c18c6c188c41892d07 -#: ../src/Doc/library/mhlib.rst:48 ../src/Doc/library/mhlib.rst:116 +#: library/mhlib.rst:48 library/mhlib.rst:116 msgid "Print an error message -- can be overridden." msgstr "" # 98e816290c0549e7b2b878938cb90d03 -#: ../src/Doc/library/mhlib.rst:53 +#: library/mhlib.rst:53 msgid "Return a profile entry (``None`` if not set)." msgstr "" # 3b853485fbc0418b953e0d88879e9d49 -#: ../src/Doc/library/mhlib.rst:58 +#: library/mhlib.rst:58 msgid "Return the mailbox pathname." msgstr "" # 46a20a8aad7b4e60910bbd0168eab0a0 -#: ../src/Doc/library/mhlib.rst:63 +#: library/mhlib.rst:63 msgid "Return the current folder name." msgstr "" # bed2c822fc094924bc907c4f2fe2b63b -#: ../src/Doc/library/mhlib.rst:68 +#: library/mhlib.rst:68 msgid "Set the current folder name." msgstr "" # 1479a08bfb3b48609207ff2f31ff6a37 -#: ../src/Doc/library/mhlib.rst:73 +#: library/mhlib.rst:73 msgid "Return a list of top-level folders." msgstr "" # 8d5fe99d78e1410a82e52d9cebf95d9c -#: ../src/Doc/library/mhlib.rst:78 +#: library/mhlib.rst:78 msgid "Return a list of all folders." msgstr "" # def7fc044726490ca30c2966f06086e3 -#: ../src/Doc/library/mhlib.rst:83 +#: library/mhlib.rst:83 msgid "Return a list of direct subfolders of the given folder." msgstr "" # e200507af20b4ce8bd38cceb1eaca3f1 -#: ../src/Doc/library/mhlib.rst:88 +#: library/mhlib.rst:88 msgid "Return a list of all subfolders of the given folder." msgstr "" # bb31a0000b6a41d7acbb4d099328cbf5 -#: ../src/Doc/library/mhlib.rst:93 +#: library/mhlib.rst:93 msgid "Create a new folder." msgstr "" # 5d7da6b6dcf5431fa0db42183a5b5e5a -#: ../src/Doc/library/mhlib.rst:98 +#: library/mhlib.rst:98 msgid "Delete a folder -- must have no subfolders." msgstr "" # 9396d23e58c141c5b7ce3e536e2b537d -#: ../src/Doc/library/mhlib.rst:103 +#: library/mhlib.rst:103 msgid "Return a new open folder object." msgstr "" # c05160f701d04fd7ab56a2a5ef9df880 -#: ../src/Doc/library/mhlib.rst:109 +#: library/mhlib.rst:109 msgid "Folder Objects" msgstr "" # 3c2baf5c4db8437f8d03a8b926c39bdd -#: ../src/Doc/library/mhlib.rst:111 +#: library/mhlib.rst:111 msgid "" ":class:`Folder` instances represent open folders and have the following " "methods:" msgstr "" # 1bf4aa7e7696493788491294304a65f1 -#: ../src/Doc/library/mhlib.rst:121 +#: library/mhlib.rst:121 msgid "Return the folder's full pathname." msgstr "" # 88da15ea422644bda9538120f27bdeac -#: ../src/Doc/library/mhlib.rst:126 +#: library/mhlib.rst:126 msgid "Return the full pathname of the folder's sequences file." msgstr "" # 32329158f1d44ea2989d11d47fc19a71 -#: ../src/Doc/library/mhlib.rst:131 +#: library/mhlib.rst:131 msgid "Return the full pathname of message *n* of the folder." msgstr "" # 982a5f9835224d0c8915674a6ba9a4f5 -#: ../src/Doc/library/mhlib.rst:136 +#: library/mhlib.rst:136 msgid "Return a list of messages in the folder (as numbers)." msgstr "" # 147210c56d674147ba0493f8425fffd8 -#: ../src/Doc/library/mhlib.rst:141 +#: library/mhlib.rst:141 msgid "Return the current message number." msgstr "" # 72e5476e2ff24237a746586dd2877b12 -#: ../src/Doc/library/mhlib.rst:146 +#: library/mhlib.rst:146 msgid "Set the current message number to *n*." msgstr "" # 140da9cd7a2c412c81165b2cef24fe90 -#: ../src/Doc/library/mhlib.rst:151 +#: library/mhlib.rst:151 msgid "Parse msgs syntax into list of messages." msgstr "" # 12b918f686f340c1badd75b0407d0a41 -#: ../src/Doc/library/mhlib.rst:156 +#: library/mhlib.rst:156 msgid "Get last message, or ``0`` if no messages are in the folder." msgstr "" # f2decab1ebd74634a7caba697f9d5ddb -#: ../src/Doc/library/mhlib.rst:161 +#: library/mhlib.rst:161 msgid "Set last message (internal use only)." msgstr "" # 3907fe2ee42548a6b51a4e2285ce9d1d -#: ../src/Doc/library/mhlib.rst:166 +#: library/mhlib.rst:166 msgid "" "Return dictionary of sequences in folder. The sequence names are used as " "keys, and the values are the lists of message numbers in the sequences." msgstr "" # 3b9ad83a44b1438a8c4aefaca7be05d7 -#: ../src/Doc/library/mhlib.rst:172 +#: library/mhlib.rst:172 msgid "Return dictionary of sequences in folder name: list." msgstr "" # db6953c17bc6401e927c4b3323c2a8f9 -#: ../src/Doc/library/mhlib.rst:177 +#: library/mhlib.rst:177 msgid "Remove messages in list from folder." msgstr "" # 119d21d808b94a6f8aa304429936d003 -#: ../src/Doc/library/mhlib.rst:182 +#: library/mhlib.rst:182 msgid "Move messages in list to other folder." msgstr "" # c53c59c62c1b417296b1dd1a6c76c0a9 -#: ../src/Doc/library/mhlib.rst:187 +#: library/mhlib.rst:187 msgid "Move one message to a given destination in another folder." msgstr "" # bf4b35f3b07d4c0381ba0c8a3dacc438 -#: ../src/Doc/library/mhlib.rst:192 +#: library/mhlib.rst:192 msgid "Copy one message to a given destination in another folder." msgstr "" # 1fdf3d3453eb4835962e225436820f6f # 5874ce7f61a84419a5ed8851295fd2d2 -#: ../src/Doc/library/mhlib.rst:198 ../src/Doc/library/rfc822.rst:143 +#: library/mhlib.rst:198 library/rfc822.rst:143 msgid "Message Objects" msgstr "" # 79d01dd7bb524ad99ac502a6912749bd -#: ../src/Doc/library/mhlib.rst:200 +#: library/mhlib.rst:200 msgid "" "The :class:`Message` class adds one method to those of :class:`mimetools." "Message`:" msgstr "" # 278428a2f7924d04b6bf6ea496e1f2c1 -#: ../src/Doc/library/mhlib.rst:206 +#: library/mhlib.rst:206 msgid "Return a new open message object (costs a file descriptor)." msgstr "" # 71bdaf512ead40d984e23f8703d95a44 -#: ../src/Doc/library/mimetools.rst:3 +#: library/mimetools.rst:3 msgid ":mod:`mimetools` --- Tools for parsing MIME messages" msgstr "" +#: library/mimetools.rst:10 +msgid "" +"The :mod:`email` package should be used in preference to the :mod:" +"`mimetools` module. This module is present only to maintain backward " +"compatibility, and it has been removed in 3.x." +msgstr "" + # fa75d894bad143309e77c40188c4b194 -#: ../src/Doc/library/mimetools.rst:17 +#: library/mimetools.rst:17 msgid "" "This module defines a subclass of the :mod:`rfc822` module's :class:" "`Message` class and a number of utility functions that are useful for the " @@ -62222,7 +63594,7 @@ msgid "" msgstr "" # 98e4c047d29f49169edb23e4c455199d -#: ../src/Doc/library/mimetools.rst:26 +#: library/mimetools.rst:26 msgid "" "Return a new instance of the :class:`Message` class. This is a subclass of " "the :class:`rfc822.Message` class, with some additional methods (see " @@ -62231,14 +63603,14 @@ msgid "" msgstr "" # 0764aacda5664f918f448e92a417fab0 -#: ../src/Doc/library/mimetools.rst:33 +#: library/mimetools.rst:33 msgid "" "Return a unique string that has a high likelihood of being usable as a part " "boundary. The string has the form ``'hostipaddr.uid.pid.timestamp.random'``." msgstr "" # 90fe0708530b4c23b99c530b46b4ec94 -#: ../src/Doc/library/mimetools.rst:39 +#: library/mimetools.rst:39 msgid "" "Read data encoded using the allowed MIME *encoding* from open file object " "*input* and write the decoded data to open file object *output*. Valid " @@ -62249,7 +63621,7 @@ msgid "" msgstr "" # 1ed347a3de064695bed0620c40d7a266 -#: ../src/Doc/library/mimetools.rst:49 +#: library/mimetools.rst:49 msgid "" "Read data from open file object *input* and write it encoded using the " "allowed MIME *encoding* to open file object *output*. Valid values for " @@ -62257,72 +63629,71 @@ msgid "" msgstr "" # 0f2e2054441a4ccd89c6c76631c36514 -#: ../src/Doc/library/mimetools.rst:56 +#: library/mimetools.rst:56 msgid "" "Read lines from open file *input* until EOF and write them to open file " "*output*." msgstr "" # 700227bce1c84c6391e88fe7a1bbaf6d -#: ../src/Doc/library/mimetools.rst:62 +#: library/mimetools.rst:62 msgid "" "Read blocks until EOF from open file *input* and write them to open file " "*output*. The block size is currently fixed at 8192." msgstr "" # fcd5de9d446f4274bce3f6d8646e31a8 -#: ../src/Doc/library/mimetools.rst:69 +#: library/mimetools.rst:69 msgid "" "Comprehensive email handling package; supersedes the :mod:`mimetools` module." msgstr "" -# 51ac38bd0e2642d38d1027e6408808ec -#: ../src/Doc/library/mimetools.rst:71 -msgid "Module :mod:`rfc822`" -msgstr "" +#: library/mimetools.rst:72 +#, fuzzy +msgid "Module rfc822" +msgstr "Modules" # 54c42447a3fc48b4a476816d71b49896 -#: ../src/Doc/library/mimetools.rst:72 +#: library/mimetools.rst:72 msgid "Provides the base class for :class:`mimetools.Message`." msgstr "" -# 3e9f327e885e4973962804782bd1ddf6 -#: ../src/Doc/library/mimetools.rst:74 -msgid "Module :mod:`multifile`" +#: library/mimetools.rst:75 +msgid "Module multifile" msgstr "" # 7295f281a57c4e928a325c50e3237430 -#: ../src/Doc/library/mimetools.rst:75 +#: library/mimetools.rst:75 msgid "" "Support for reading files which contain distinct parts, such as MIME data." msgstr "" # f0c673c26caa424098c04575b9d01af3 -#: ../src/Doc/library/mimetools.rst:77 +#: library/mimetools.rst:78 msgid "http://faqs.cs.uu.nl/na-dir/mail/mime-faq/.html" msgstr "" # 7115efb52e98451abb84fdc48f8fe25a -#: ../src/Doc/library/mimetools.rst:78 +#: library/mimetools.rst:78 msgid "" "The MIME Frequently Asked Questions document. For an overview of MIME, see " "the answer to question 1.1 in Part 1 of this document." msgstr "" # 43323c5f9c7749c092bbed6751e37687 -#: ../src/Doc/library/mimetools.rst:85 +#: library/mimetools.rst:85 msgid "Additional Methods of Message Objects" msgstr "" # 60f5e5b7d610437284c9bdf8b592bc07 -#: ../src/Doc/library/mimetools.rst:87 +#: library/mimetools.rst:87 msgid "" "The :class:`Message` class defines the following methods in addition to the :" "class:`rfc822.Message` methods:" msgstr "" # d5c02f4cc18f4e469489b2d56f11e998 -#: ../src/Doc/library/mimetools.rst:93 +#: library/mimetools.rst:93 msgid "" "Return the parameter list of the :mailheader:`Content-Type` header. This is " "a list of strings. For parameters of the form ``key=value``, *key* is " @@ -62332,7 +63703,7 @@ msgid "" msgstr "" # 523f3ee26cf9470aa1abdec4f6e04a60 -#: ../src/Doc/library/mimetools.rst:102 +#: library/mimetools.rst:102 msgid "" "Return the *value* of the first parameter (as returned by :meth:`getplist`) " "of the form ``name=value`` for the given *name*. If *value* is surrounded " @@ -62341,7 +63712,7 @@ msgid "" msgstr "" # ff4d8426cd634024999ef0951101664e -#: ../src/Doc/library/mimetools.rst:109 +#: library/mimetools.rst:109 msgid "" "Return the encoding specified in the :mailheader:`Content-Transfer-Encoding` " "message header. If no such header exists, return ``'7bit'``. The encoding " @@ -62349,7 +63720,7 @@ msgid "" msgstr "" # 36004d8242144c328820c70d1cf393ba -#: ../src/Doc/library/mimetools.rst:116 +#: library/mimetools.rst:116 msgid "" "Return the message type (of the form ``type/subtype``) as specified in the :" "mailheader:`Content-Type` header. If no such header exists, return ``'text/" @@ -62357,7 +63728,7 @@ msgid "" msgstr "" # a0811fcc30ba4176a27091f3b4a6c1fa -#: ../src/Doc/library/mimetools.rst:123 +#: library/mimetools.rst:123 msgid "" "Return the main type as specified in the :mailheader:`Content-Type` header. " "If no such header exists, return ``'text'``. The main type is converted to " @@ -62365,23 +63736,23 @@ msgid "" msgstr "" # eb77b339ade94856b2d8695930e07ae0 -#: ../src/Doc/library/mimetools.rst:130 +#: library/mimetools.rst:130 msgid "" "Return the subtype as specified in the :mailheader:`Content-Type` header. " "If no such header exists, return ``'plain'``. The subtype is converted to " "lower case." msgstr "" -#: ../src/Doc/library/mimetypes.rst:2 +#: library/mimetypes.rst:2 msgid ":mod:`mimetypes` --- Map filenames to MIME types" msgstr "" # a50b4ab86c19460fa3e73c247ef76410 -#: ../src/Doc/library/mimetypes.rst:11 +#: library/mimetypes.rst:11 msgid "**Source code:** :source:`Lib/mimetypes.py`" msgstr "" -#: ../src/Doc/library/mimetypes.rst:15 +#: library/mimetypes.rst:15 msgid "" "The :mod:`mimetypes` module converts between a filename or URL and the MIME " "type associated with the filename extension. Conversions are provided from " @@ -62389,14 +63760,14 @@ msgid "" "are not supported for the latter conversion." msgstr "" -#: ../src/Doc/library/mimetypes.rst:20 +#: library/mimetypes.rst:20 msgid "" "The module provides one class and a number of convenience functions. The " "functions are the normal interface to this module, but some applications may " "be interested in the class as well." msgstr "" -#: ../src/Doc/library/mimetypes.rst:24 +#: library/mimetypes.rst:24 msgid "" "The functions described below provide the primary interface for this " "module. If the module has not been initialized, they will call :func:`init` " @@ -62404,7 +63775,7 @@ msgid "" msgstr "" # f58d7446f48b4bb6986c4d7fe52b00a3 -#: ../src/Doc/library/mimetypes.rst:33 +#: library/mimetypes.rst:33 msgid "" "Guess the type of a file based on its filename or URL, given by *url*. The " "return value is a tuple ``(type, encoding)`` where *type* is ``None`` if the " @@ -62413,7 +63784,7 @@ msgid "" msgstr "" # ad1a4a4b398a4a96bee8234113a3f70a -#: ../src/Doc/library/mimetypes.rst:38 +#: library/mimetypes.rst:38 msgid "" "*encoding* is ``None`` for no encoding or the name of the program used to " "encode (e.g. :program:`compress` or :program:`gzip`). The encoding is " @@ -62424,7 +63795,7 @@ msgid "" msgstr "" # 0b75089a37454402b988db439d0114ee -#: ../src/Doc/library/mimetypes.rst:45 +#: library/mimetypes.rst:45 msgid "" "The optional *strict* argument is a flag specifying whether the list of " "known MIME types is limited to only the official types `registered with IANA " @@ -62434,7 +63805,7 @@ msgid "" "types are also recognized." msgstr "" -#: ../src/Doc/library/mimetypes.rst:55 +#: library/mimetypes.rst:55 msgid "" "Guess the extensions for a file based on its MIME type, given by *type*. The " "return value is a list of strings giving all possible filename extensions, " @@ -62445,14 +63816,14 @@ msgstr "" # c4d7a3632f7d4793b0ae70913c9b2fca # 1698e1db334a48f1b2c5fbe3ecf6f9d9 -#: ../src/Doc/library/mimetypes.rst:61 ../src/Doc/library/mimetypes.rst:73 +#: library/mimetypes.rst:61 library/mimetypes.rst:73 msgid "" "The optional *strict* argument has the same meaning as with the :func:" "`guess_type` function." msgstr "" # 832958e6dc9d4bf794d0767cf7b46665 -#: ../src/Doc/library/mimetypes.rst:66 +#: library/mimetypes.rst:66 msgid "" "Guess the extension for a file based on its MIME type, given by *type*. The " "return value is a string giving a filename extension, including the leading " @@ -62462,13 +63833,13 @@ msgid "" "returned." msgstr "" -#: ../src/Doc/library/mimetypes.rst:75 +#: library/mimetypes.rst:75 msgid "" "Some additional functions and data items are available for controlling the " "behavior of the module." msgstr "" -#: ../src/Doc/library/mimetypes.rst:81 +#: library/mimetypes.rst:81 msgid "" "Initialize the internal data structures. If given, *files* must be a " "sequence of file names which should be used to augment the default type " @@ -62479,15 +63850,19 @@ msgid "" msgstr "" # 1cdab083ed904cb79d6d2fa177cd6174 -#: ../src/Doc/library/mimetypes.rst:88 +#: library/mimetypes.rst:88 msgid "" "Specifying an empty list for *files* will prevent the system defaults from " "being applied: only the well-known values will be present from a built-in " "list." msgstr "" +#: library/mimetypes.rst:91 +msgid "Previously, Windows registry settings were ignored." +msgstr "" + # c1fb1490309f4aeb993209de5d33de92 -#: ../src/Doc/library/mimetypes.rst:97 +#: library/mimetypes.rst:97 msgid "" "Load the type map given in the file *filename*, if it exists. The type map " "is returned as a dictionary mapping filename extensions, including the " @@ -62496,7 +63871,7 @@ msgid "" msgstr "" # e3da979667c7495c8451b34ebc5501d4 -#: ../src/Doc/library/mimetypes.rst:105 +#: library/mimetypes.rst:105 msgid "" "Add a mapping from the MIME type *type* to the extension *ext*. When the " "extension is already known, the new type will replace the old one. When the " @@ -62504,28 +63879,27 @@ msgid "" "extensions." msgstr "" -# 401d055b776041df9656d760c28aa1f8 -#: ../src/Doc/library/mimetypes.rst:109 +#: library/mimetypes.rst:109 msgid "" -"When *strict* is ``True`` (the default), the mapping will added to the " +"When *strict* is ``True`` (the default), the mapping will be added to the " "official MIME types, otherwise to the non-standard ones." msgstr "" # d526a618b9fc4ce3b476c4be671ee328 -#: ../src/Doc/library/mimetypes.rst:115 +#: library/mimetypes.rst:115 msgid "" "Flag indicating whether or not the global data structures have been " "initialized. This is set to ``True`` by :func:`init`." msgstr "" -#: ../src/Doc/library/mimetypes.rst:123 +#: library/mimetypes.rst:123 msgid "" "List of type map file names commonly installed. These files are typically " "named :file:`mime.types` and are installed in different locations by " "different packages." msgstr "" -#: ../src/Doc/library/mimetypes.rst:130 +#: library/mimetypes.rst:130 msgid "" "Dictionary mapping suffixes to suffixes. This is used to allow recognition " "of encoded files for which the encoding and the type are indicated by the " @@ -62533,37 +63907,37 @@ msgid "" "`.tar.gz` to allow the encoding and type to be recognized separately." msgstr "" -#: ../src/Doc/library/mimetypes.rst:138 +#: library/mimetypes.rst:138 msgid "Dictionary mapping filename extensions to encoding types." msgstr "" -#: ../src/Doc/library/mimetypes.rst:143 +#: library/mimetypes.rst:143 msgid "Dictionary mapping filename extensions to MIME types." msgstr "" -#: ../src/Doc/library/mimetypes.rst:148 +#: library/mimetypes.rst:148 msgid "" "Dictionary mapping filename extensions to non-standard, but commonly found " "MIME types." msgstr "" -#: ../src/Doc/library/mimetypes.rst:152 +#: library/mimetypes.rst:152 msgid "An example usage of the module::" msgstr "" -#: ../src/Doc/library/mimetypes.rst:169 +#: library/mimetypes.rst:169 msgid "MimeTypes Objects" msgstr "" # 1e7d3b6d83ba496c98077c5ac231c896 -#: ../src/Doc/library/mimetypes.rst:171 +#: library/mimetypes.rst:171 msgid "" "The :class:`MimeTypes` class may be useful for applications which may want " "more than one MIME-type database; it provides an interface similar to the " "one of the :mod:`mimetypes` module." msgstr "" -#: ../src/Doc/library/mimetypes.rst:178 +#: library/mimetypes.rst:178 msgid "" "This class represents a MIME-types database. By default, it provides access " "to the same database as the rest of this module. The initial database is a " @@ -62573,14 +63947,14 @@ msgid "" "cleared before loading additional data if the default data is not desired." msgstr "" -#: ../src/Doc/library/mimetypes.rst:185 +#: library/mimetypes.rst:185 msgid "" "The optional *filenames* parameter can be used to cause additional files to " "be loaded \"on top\" of the default database." msgstr "" # f3c207b6aacf45ec8b2f08372ab12619 -#: ../src/Doc/library/mimetypes.rst:191 +#: library/mimetypes.rst:191 msgid "" "Dictionary mapping suffixes to suffixes. This is used to allow recognition " "of encoded files for which the encoding and the type are indicated by the " @@ -62590,14 +63964,14 @@ msgid "" msgstr "" # e1a84884bac74195af3dab0a21bbc57b -#: ../src/Doc/library/mimetypes.rst:200 +#: library/mimetypes.rst:200 msgid "" "Dictionary mapping filename extensions to encoding types. This is initially " "a copy of the global :data:`encodings_map` defined in the module." msgstr "" # a81937a7da9f4d45bc88674b35dfb6da -#: ../src/Doc/library/mimetypes.rst:206 +#: library/mimetypes.rst:206 msgid "" "Tuple containing two dictionaries, mapping filename extensions to MIME " "types: the first dictionary is for the non-standards types and the second " @@ -62606,7 +63980,7 @@ msgid "" msgstr "" # 3986d82db8e24487832acaca43dea46d -#: ../src/Doc/library/mimetypes.rst:214 +#: library/mimetypes.rst:214 msgid "" "Tuple containing two dictionaries, mapping MIME types to a list of filename " "extensions: the first dictionary is for the non-standards types and the " @@ -62614,41 +63988,41 @@ msgid "" "`common_types` and :data:`types_map`." msgstr "" -#: ../src/Doc/library/mimetypes.rst:222 +#: library/mimetypes.rst:222 msgid "" "Similar to the :func:`guess_extension` function, using the tables stored as " "part of the object." msgstr "" -#: ../src/Doc/library/mimetypes.rst:228 +#: library/mimetypes.rst:228 msgid "" "Similar to the :func:`guess_type` function, using the tables stored as part " "of the object." msgstr "" # 60d4a5f4d1394f85981253d9992894c7 -#: ../src/Doc/library/mimetypes.rst:234 +#: library/mimetypes.rst:234 msgid "" "Similar to the :func:`guess_all_extensions` function, using the tables " "stored as part of the object." msgstr "" # 4687e6857ef54ff9a593f2c75d19ba1e -#: ../src/Doc/library/mimetypes.rst:240 +#: library/mimetypes.rst:240 msgid "" "Load MIME information from a file named *filename*. This uses :meth:" "`readfp` to parse the file." msgstr "" # 53a75a7f6b8243d18e2a703f232ea4bc -#: ../src/Doc/library/mimetypes.rst:243 +#: library/mimetypes.rst:243 msgid "" "If *strict* is ``True``, information will be added to list of standard " "types, else to the list of non-standard types." msgstr "" # a697916499cf42f5b5c40485eff2ce95 -#: ../src/Doc/library/mimetypes.rst:249 +#: library/mimetypes.rst:249 msgid "" "Load MIME type information from an open file *fp*. The file must have the " "format of the standard :file:`mime.types` files." @@ -62656,24 +64030,31 @@ msgstr "" # 74549b7604f8491c9d976ab5fce3109e # 3e7783deb0b64cde92f2b65d8d466c1f -#: ../src/Doc/library/mimetypes.rst:252 ../src/Doc/library/mimetypes.rst:260 +#: library/mimetypes.rst:252 library/mimetypes.rst:260 msgid "" "If *strict* is ``True``, information will be added to the list of standard " "types, else to the list of non-standard types." msgstr "" -#: ../src/Doc/library/mimetypes.rst:258 +#: library/mimetypes.rst:258 msgid "" "Load MIME type information from the Windows registry. Availability: Windows." msgstr "" # b0a4cbb24d3a416f895668dcbcb8ff93 -#: ../src/Doc/library/mimewriter.rst:2 +#: library/mimewriter.rst:2 msgid ":mod:`MimeWriter` --- Generic MIME file writer" msgstr "" +#: library/mimewriter.rst:11 +msgid "" +"The :mod:`email` package should be used in preference to the :mod:" +"`MimeWriter` module. This module is present only to maintain backward " +"compatibility." +msgstr "" + # e7b3efa19d4a475d9ba1324acc239abe -#: ../src/Doc/library/mimewriter.rst:15 +#: library/mimewriter.rst:15 msgid "" "This module defines the class :class:`MimeWriter`. The :class:`MimeWriter` " "class implements a basic formatter for creating MIME multi-part files. It " @@ -62684,7 +64065,7 @@ msgid "" msgstr "" # 5c121dfac1aa4015a4d4fcaee4fb1626 -#: ../src/Doc/library/mimewriter.rst:25 +#: library/mimewriter.rst:25 msgid "" "Return a new instance of the :class:`MimeWriter` class. The only argument " "passed, *fp*, is a file object to be used for writing. Note that a :class:" @@ -62692,17 +64073,17 @@ msgid "" msgstr "" # b15c68dd308b4199b5b587a67106d30d -#: ../src/Doc/library/mimewriter.rst:33 +#: library/mimewriter.rst:33 msgid "MimeWriter Objects" msgstr "" # ecad28db735945d3a917114493937bc3 -#: ../src/Doc/library/mimewriter.rst:35 +#: library/mimewriter.rst:35 msgid ":class:`MimeWriter` instances have the following methods:" msgstr "" # 2cc6c26eb587434ea3b23e141761e005 -#: ../src/Doc/library/mimewriter.rst:40 +#: library/mimewriter.rst:40 msgid "" "Add a header line to the MIME message. The *key* is the name of the header, " "where the *value* obviously provides the value of the header. The optional " @@ -62711,7 +64092,7 @@ msgid "" msgstr "" # 9ccdb7a69d474adcbb93cfd5681feecf -#: ../src/Doc/library/mimewriter.rst:48 +#: library/mimewriter.rst:48 msgid "" "Causes all headers accumulated so far to be written out (and forgotten). " "This is useful if you don't need a body part at all, e.g. for a subpart of " @@ -62720,7 +64101,7 @@ msgid "" msgstr "" # b23d0663ec7147998845782ef3d106a9 -#: ../src/Doc/library/mimewriter.rst:56 +#: library/mimewriter.rst:56 msgid "" "Returns a file-like object which can be used to write to the body of the " "message. The content-type is set to the provided *ctype*, and the optional " @@ -62730,7 +64111,7 @@ msgid "" msgstr "" # d559aec6f6214bd99e21304100c8d93d -#: ../src/Doc/library/mimewriter.rst:65 +#: library/mimewriter.rst:65 msgid "" "Returns a file-like object which can be used to write to the body of the " "message. Additionally, this method initializes the multi-part code, where " @@ -62741,7 +64122,7 @@ msgid "" msgstr "" # 3577d57752f04dd29d53fa08392cb13c -#: ../src/Doc/library/mimewriter.rst:75 +#: library/mimewriter.rst:75 msgid "" "Returns a new instance of :class:`MimeWriter` which represents an individual " "part in a multipart message. This may be used to write the part as well as " @@ -62751,19 +64132,25 @@ msgid "" msgstr "" # bfca6e12c5f84c64b37a23ba94cc1a6f -#: ../src/Doc/library/mimewriter.rst:83 +#: library/mimewriter.rst:83 msgid "" "This is used to designate the last part of a multipart message, and should " "*always* be used when writing multipart messages." msgstr "" # 48d2422932364cedae960e3b315b3671 -#: ../src/Doc/library/mimify.rst:3 +#: library/mimify.rst:3 msgid ":mod:`mimify` --- MIME processing of mail messages" msgstr "" +#: library/mimify.rst:10 +msgid "" +"The :mod:`email` package should be used in preference to the :mod:`mimify` " +"module. This module is present only to maintain backward compatibility." +msgstr "" + # 1b60f4c15e9a4aa19ccf5a1436500342 -#: ../src/Doc/library/mimify.rst:14 +#: library/mimify.rst:14 msgid "" "The :mod:`mimify` module defines two functions to convert mail messages to " "and from MIME format. The mail message can be either a simple message or a " @@ -62776,14 +64163,14 @@ msgid "" msgstr "" # b3cc883790cf41228cf39678efee9fc1 -#: ../src/Doc/library/mimify.rst:28 +#: library/mimify.rst:28 msgid "" "The modules defines the following user-callable functions and user-settable " "variables:" msgstr "" # 06a4688d9b6d4621a324ad6522cfc655 -#: ../src/Doc/library/mimify.rst:34 +#: library/mimify.rst:34 msgid "" "Copy the message in *infile* to *outfile*, converting parts to quoted-" "printable and adding MIME mail headers when necessary. *infile* and " @@ -62794,7 +64181,7 @@ msgid "" msgstr "" # 076904a027df4831a8c3fa4b79c57120 -#: ../src/Doc/library/mimify.rst:43 +#: library/mimify.rst:43 msgid "" "Copy the message in *infile* to *outfile*, decoding all quoted-printable " "parts. *infile* and *outfile* can be file objects (actually, any object that " @@ -62806,19 +64193,19 @@ msgid "" msgstr "" # 953fe3b6963b4433bd849bb465410548 -#: ../src/Doc/library/mimify.rst:54 +#: library/mimify.rst:54 msgid "" "Return a decoded version of the encoded header line in *line*. This only " "supports the ISO 8859-1 charset (Latin-1)." msgstr "" # 2d5a9a2ea6084ddfaabac43fd1eeefa5 -#: ../src/Doc/library/mimify.rst:60 +#: library/mimify.rst:60 msgid "Return a MIME-encoded version of the header line in *line*." msgstr "" # c6c769a0c2954e3285e5c119beb3f68b -#: ../src/Doc/library/mimify.rst:65 +#: library/mimify.rst:65 msgid "" "By default, a part will be encoded as quoted-printable when it contains any " "non-ASCII characters (characters with the 8th bit set), or if there are any " @@ -62826,7 +64213,7 @@ msgid "" msgstr "" # 5090585753274cccb078a038ea7503cc -#: ../src/Doc/library/mimify.rst:72 +#: library/mimify.rst:72 msgid "" "When not specified in the mail headers, a character set must be filled in. " "The string used is stored in :const:`CHARSET`, and the default value is " @@ -62834,13 +64221,13 @@ msgid "" msgstr "" # 5055aab2b9324e20a20250dca25ef56f -#: ../src/Doc/library/mimify.rst:76 +#: library/mimify.rst:76 msgid "" "This module can also be used from the command line. Usage is as follows::" msgstr "" # a68f275d798b42dc945cc12cd5ceba87 -#: ../src/Doc/library/mimify.rst:81 +#: library/mimify.rst:81 msgid "" "to encode (mimify) and decode (unmimify) respectively. *infile* defaults to " "standard input, *outfile* defaults to standard output. The same file can be " @@ -62848,31 +64235,31 @@ msgid "" msgstr "" # 3f88b830bdc3454a94276dbe88cb756e -#: ../src/Doc/library/mimify.rst:85 +#: library/mimify.rst:85 msgid "" "If the **-l** option is given when encoding, if there are any lines longer " "than the specified *length*, the containing part will be encoded." msgstr "" # 6a0288f72d62483a8497677238cf46b0 -#: ../src/Doc/library/mimify.rst:88 +#: library/mimify.rst:88 msgid "" "If the **-b** option is given when decoding, any base64 parts will be " "decoded as well." msgstr "" # 1e5f09626dfc499daadad919f2bb6708 -#: ../src/Doc/library/mimify.rst:95 +#: library/mimify.rst:95 msgid "Encode and decode MIME quoted-printable files." msgstr "" # 86e3291247f341499a0020b27cd72b08 -#: ../src/Doc/library/miniaeframe.rst:3 +#: library/miniaeframe.rst:3 msgid ":mod:`MiniAEFrame` --- Open Scripting Architecture server support" msgstr "" # 67862cb1126842cd882d5af44008341e -#: ../src/Doc/library/miniaeframe.rst:15 +#: library/miniaeframe.rst:15 msgid "" "The module :mod:`MiniAEFrame` provides a framework for an application that " "can function as an Open Scripting Architecture (OSA) server, i.e. receive " @@ -62881,12 +64268,12 @@ msgid "" msgstr "" # 064711443f254e27a5e7ee32c577643e -#: ../src/Doc/library/miniaeframe.rst:20 +#: library/miniaeframe.rst:20 msgid "The :mod:`MiniAEFrame` module defines the following classes:" msgstr "" # 60e004f05c604764bcff4f42ce21693c -#: ../src/Doc/library/miniaeframe.rst:25 +#: library/miniaeframe.rst:25 msgid "" "A class that handles AppleEvent dispatch. Your application should subclass " "this class together with either :class:`MiniApplication` or :class:" @@ -62895,7 +64282,7 @@ msgid "" msgstr "" # a0c197584c49433da6baec81b6fe4222 -#: ../src/Doc/library/miniaeframe.rst:33 +#: library/miniaeframe.rst:33 msgid "" "A class that is more or less compatible with :class:`FrameWork.Application` " "but with less functionality. Its event loop supports the apple menu, command-" @@ -62905,12 +64292,12 @@ msgid "" msgstr "" # 665683621c8548beb7ea7da82e25c6d7 -#: ../src/Doc/library/miniaeframe.rst:43 +#: library/miniaeframe.rst:43 msgid "AEServer Objects" msgstr "" # 1a1f0650485c442bb2844f5b4aaf13a7 -#: ../src/Doc/library/miniaeframe.rst:48 +#: library/miniaeframe.rst:48 msgid "" "Installs an AppleEvent handler. *classe* and *type* are the four-character " "OSA Class and Type designators, ``'****'`` wildcards are allowed. When a " @@ -62919,7 +64306,7 @@ msgid "" msgstr "" # 6052f900385f419eb778002f1c2583a6 -#: ../src/Doc/library/miniaeframe.rst:55 +#: library/miniaeframe.rst:55 msgid "" "Your callback is called with the OSA Direct Object as first positional " "parameter. The other parameters are passed as keyword arguments, with the 4-" @@ -62929,14 +64316,14 @@ msgid "" msgstr "" # 69ec70e30f1b4e79a0cee40d638e8f6a -#: ../src/Doc/library/miniaeframe.rst:61 +#: library/miniaeframe.rst:61 msgid "" "The return value of your method is packed with :func:`aetools.packevent` and " "sent as reply." msgstr "" # 6567bfb139bf4af28c792bae41cd818a -#: ../src/Doc/library/miniaeframe.rst:64 +#: library/miniaeframe.rst:64 msgid "" "Note that there are some serious problems with the current design. " "AppleEvents which have non-identifier 4-character designators for arguments " @@ -62944,33 +64331,33 @@ msgid "" "originator. This will be addressed in a future release." msgstr "" -#: ../src/Doc/library/misc.rst:6 +#: library/misc.rst:6 msgid "Miscellaneous Services" msgstr "" -#: ../src/Doc/library/misc.rst:8 +#: library/misc.rst:8 msgid "" "The modules described in this chapter provide miscellaneous services that " "are available in all Python versions. Here's an overview:" msgstr "" -#: ../src/Doc/library/mm.rst:6 +#: library/mm.rst:6 msgid "Multimedia Services" msgstr "" -#: ../src/Doc/library/mm.rst:8 +#: library/mm.rst:8 msgid "" "The modules described in this chapter implement various algorithms or " "interfaces that are mainly useful for multimedia applications. They are " "available at the discretion of the installation. Here's an overview:" msgstr "" -#: ../src/Doc/library/mmap.rst:3 +#: library/mmap.rst:3 msgid ":mod:`mmap` --- Memory-mapped file support" msgstr "" # e804d0f574f845eaa731eed91e67762d -#: ../src/Doc/library/mmap.rst:9 +#: library/mmap.rst:9 msgid "" "Memory-mapped file objects behave like both strings and like file objects. " "Unlike normal string objects, however, these are mutable. You can use mmap " @@ -62982,7 +64369,7 @@ msgid "" "`seek` through the file to different positions." msgstr "" -#: ../src/Doc/library/mmap.rst:18 +#: library/mmap.rst:18 msgid "" "A memory-mapped file is created by the :class:`mmap` constructor, which is " "different on Unix and on Windows. In either case you must provide a file " @@ -62994,7 +64381,7 @@ msgid "" msgstr "" # 4a22a1c97fb540788bcc9f687c00f8e3 -#: ../src/Doc/library/mmap.rst:27 +#: library/mmap.rst:27 msgid "" "If you want to create a memory-mapping for a writable, buffered file, you " "should :func:`~io.IOBase.flush` the file first. This is necessary to ensure " @@ -63002,7 +64389,7 @@ msgid "" "mapping." msgstr "" -#: ../src/Doc/library/mmap.rst:32 +#: library/mmap.rst:32 msgid "" "For both the Unix and Windows versions of the constructor, *access* may be " "specified as an optional keyword parameter. *access* accepts one of three " @@ -63017,7 +64404,19 @@ msgid "" "memory map affects memory but does not update the underlying file." msgstr "" -#: ../src/Doc/library/mmap.rst:54 +#: library/mmap.rst:44 +msgid "" +"To map anonymous memory, -1 should be passed as the fileno along with the " +"length." +msgstr "" + +#: library/mmap.rst:48 +msgid "" +"mmap.mmap has formerly been a factory function creating mmap objects. Now " +"mmap.mmap is the class itself." +msgstr "" + +#: library/mmap.rst:54 msgid "" "**(Windows version)** Maps *length* bytes from the file specified by the " "file handle *fileno*, and creates a mmap object. If *length* is larger than " @@ -63027,7 +64426,7 @@ msgid "" "exception (you cannot create an empty mapping on Windows)." msgstr "" -#: ../src/Doc/library/mmap.rst:61 +#: library/mmap.rst:61 msgid "" "*tagname*, if specified and not ``None``, is a string giving a tag name for " "the mapping. Windows allows you to have many different mappings against the " @@ -63038,14 +64437,14 @@ msgid "" "Windows." msgstr "" -#: ../src/Doc/library/mmap.rst:69 +#: library/mmap.rst:69 msgid "" "*offset* may be specified as a non-negative integer offset. mmap references " "will be relative to the offset from the beginning of the file. *offset* " "defaults to 0. *offset* must be a multiple of the ALLOCATIONGRANULARITY." msgstr "" -#: ../src/Doc/library/mmap.rst:77 +#: library/mmap.rst:77 msgid "" "**(Unix version)** Maps *length* bytes from the file specified by the file " "descriptor *fileno*, and returns a mmap object. If *length* is ``0``, the " @@ -63053,7 +64452,7 @@ msgid "" "`mmap` is called." msgstr "" -#: ../src/Doc/library/mmap.rst:82 +#: library/mmap.rst:82 msgid "" "*flags* specifies the nature of the mapping. :const:`MAP_PRIVATE` creates a " "private copy-on-write mapping, so changes to the contents of the mmap object " @@ -63062,7 +64461,7 @@ msgid "" "The default value is :const:`MAP_SHARED`." msgstr "" -#: ../src/Doc/library/mmap.rst:88 +#: library/mmap.rst:88 msgid "" "*prot*, if specified, gives the desired memory protection; the two most " "useful values are :const:`PROT_READ` and :const:`PROT_WRITE`, to specify " @@ -63070,7 +64469,7 @@ msgid "" "\\| PROT_WRITE`." msgstr "" -#: ../src/Doc/library/mmap.rst:93 +#: library/mmap.rst:93 msgid "" "*access* may be specified in lieu of *flags* and *prot* as an optional " "keyword parameter. It is an error to specify both *flags*, *prot* and " @@ -63078,7 +64477,7 @@ msgid "" "use this parameter." msgstr "" -#: ../src/Doc/library/mmap.rst:98 +#: library/mmap.rst:98 msgid "" "*offset* may be specified as a non-negative integer offset. mmap references " "will be relative to the offset from the beginning of the file. *offset* " @@ -63087,36 +64486,36 @@ msgid "" msgstr "" # b47674ecf58f4865a822dd9bdba76ef5 -#: ../src/Doc/library/mmap.rst:103 +#: library/mmap.rst:103 msgid "" "To ensure validity of the created memory mapping the file specified by the " "descriptor *fileno* is internally automatically synchronized with physical " "backing store on Mac OS X and OpenVMS." msgstr "" -#: ../src/Doc/library/mmap.rst:107 +#: library/mmap.rst:107 msgid "This example shows a simple way of using :class:`mmap`::" msgstr "" -#: ../src/Doc/library/mmap.rst:132 +#: library/mmap.rst:132 msgid "" "The next example demonstrates how to create an anonymous map and exchange " "data between the parent and child processes::" msgstr "" -#: ../src/Doc/library/mmap.rst:150 +#: library/mmap.rst:150 msgid "Memory-mapped file objects support the following methods:" msgstr "" # 57ebe2fa31fc41c7add85a209f6a5a29 -#: ../src/Doc/library/mmap.rst:155 +#: library/mmap.rst:155 msgid "" "Closes the mmap. Subsequent calls to other methods of the object will result " "in a ValueError exception being raised. This will not close the open file." msgstr "" # 2e3f43cce9e24cba8ad9b0b8b9d0da64 -#: ../src/Doc/library/mmap.rst:162 +#: library/mmap.rst:162 msgid "" "Returns the lowest index in the object where the substring *string* is " "found, such that *string* is contained in the range [*start*, *end*]. " @@ -63124,7 +64523,7 @@ msgid "" "Returns ``-1`` on failure." msgstr "" -#: ../src/Doc/library/mmap.rst:170 +#: library/mmap.rst:170 msgid "" "Flushes changes made to the in-memory copy of a file back to disk. Without " "use of this call there is no guarantee that changes are written back before " @@ -63133,20 +64532,20 @@ msgid "" "extent of the mapping is flushed." msgstr "" -#: ../src/Doc/library/mmap.rst:176 +#: library/mmap.rst:176 msgid "" "**(Windows version)** A nonzero value returned indicates success; zero " "indicates failure." msgstr "" -#: ../src/Doc/library/mmap.rst:179 +#: library/mmap.rst:179 msgid "" "**(Unix version)** A zero value is returned to indicate success. An " "exception is raised when the call failed." msgstr "" # 8787ac18ac15421ba2fb4fd56c8263d0 -#: ../src/Doc/library/mmap.rst:185 +#: library/mmap.rst:185 msgid "" "Copy the *count* bytes starting at offset *src* to the destination index " "*dest*. If the mmap was created with :const:`ACCESS_READ`, then calls to " @@ -63154,7 +64553,7 @@ msgid "" msgstr "" # ddca554c6e824c358260525e1e4c3e76 -#: ../src/Doc/library/mmap.rst:192 +#: library/mmap.rst:192 msgid "" "Return a string containing up to *num* bytes starting from the current file " "position; the file position is updated to point after the bytes that were " @@ -63162,20 +64561,20 @@ msgid "" msgstr "" # a4b71e4c23b947579b920f8800855129 -#: ../src/Doc/library/mmap.rst:199 +#: library/mmap.rst:199 msgid "" "Returns a string of length 1 containing the character at the current file " "position, and advances the file position by 1." msgstr "" -#: ../src/Doc/library/mmap.rst:205 +#: library/mmap.rst:205 msgid "" "Returns a single line, starting at the current file position and up to the " "next newline." msgstr "" # fa821eb270d94912a528623df9f2f6b0 -#: ../src/Doc/library/mmap.rst:211 +#: library/mmap.rst:211 msgid "" "Resizes the map and the underlying file, if any. If the mmap was created " "with :const:`ACCESS_READ` or :const:`ACCESS_COPY`, resizing the map will " @@ -63183,7 +64582,7 @@ msgid "" msgstr "" # 9029e4ce112543179a425c7395db1af7 -#: ../src/Doc/library/mmap.rst:218 +#: library/mmap.rst:218 msgid "" "Returns the highest index in the object where the substring *string* is " "found, such that *string* is contained in the range [*start*, *end*]. " @@ -63191,7 +64590,7 @@ msgid "" "Returns ``-1`` on failure." msgstr "" -#: ../src/Doc/library/mmap.rst:226 +#: library/mmap.rst:226 msgid "" "Set the file's current position. *whence* argument is optional and defaults " "to ``os.SEEK_SET`` or ``0`` (absolute file positioning); other values are " @@ -63199,18 +64598,18 @@ msgid "" "SEEK_END`` or ``2`` (seek relative to the file's end)." msgstr "" -#: ../src/Doc/library/mmap.rst:234 +#: library/mmap.rst:234 msgid "" "Return the length of the file, which can be larger than the size of the " "memory-mapped area." msgstr "" -#: ../src/Doc/library/mmap.rst:240 +#: library/mmap.rst:240 msgid "Returns the current position of the file pointer." msgstr "" # 699fcb343282427cb61967e480b9db17 -#: ../src/Doc/library/mmap.rst:245 +#: library/mmap.rst:245 msgid "" "Write the bytes in *string* into memory at the current position of the file " "pointer; the file position is updated to point after the bytes that were " @@ -63219,7 +64618,7 @@ msgid "" msgstr "" # cec4a5644a484317b78d1255a40b0ce7 -#: ../src/Doc/library/mmap.rst:253 +#: library/mmap.rst:253 msgid "" "Write the single-character string *byte* into memory at the current position " "of the file pointer; the file position is advanced by ``1``. If the mmap was " @@ -63227,16 +64626,16 @@ msgid "" "`TypeError` exception." msgstr "" -#: ../src/Doc/library/modulefinder.rst:2 +#: library/modulefinder.rst:2 msgid ":mod:`modulefinder` --- Find modules used by a script" msgstr "" # 517d2880adc543c38cbd9f265e5542de -#: ../src/Doc/library/modulefinder.rst:11 +#: library/modulefinder.rst:11 msgid "**Source code:** :source:`Lib/modulefinder.py`" msgstr "" -#: ../src/Doc/library/modulefinder.rst:15 +#: library/modulefinder.rst:15 msgid "" "This module provides a :class:`ModuleFinder` class that can be used to " "determine the set of modules imported by a script. ``modulefinder.py`` can " @@ -63244,13 +64643,13 @@ msgid "" "argument, after which a report of the imported modules will be printed." msgstr "" -#: ../src/Doc/library/modulefinder.rst:23 +#: library/modulefinder.rst:23 msgid "" "Record that the package named *pkg_name* can be found in the specified " "*path*." msgstr "" -#: ../src/Doc/library/modulefinder.rst:28 +#: library/modulefinder.rst:28 msgid "" "Allows specifying that the module named *oldname* is in fact the package " "named *newname*. The most common usage would be to handle how the :mod:" @@ -63258,7 +64657,7 @@ msgid "" msgstr "" # d4c4e5989d0b43c58fe9f84798bb8788 -#: ../src/Doc/library/modulefinder.rst:35 +#: library/modulefinder.rst:35 msgid "" "This class provides :meth:`run_script` and :meth:`report` methods to " "determine the set of modules imported by a script. *path* can be a list of " @@ -63269,54 +64668,55 @@ msgid "" "newpath)`` tuples that will be replaced in module paths." msgstr "" -#: ../src/Doc/library/modulefinder.rst:46 +#: library/modulefinder.rst:46 msgid "" "Print a report to standard output that lists the modules imported by the " "script and their paths, as well as modules that are missing or seem to be " "missing." msgstr "" -#: ../src/Doc/library/modulefinder.rst:52 +#: library/modulefinder.rst:52 msgid "" "Analyze the contents of the *pathname* file, which must contain Python code." msgstr "" -#: ../src/Doc/library/modulefinder.rst:57 +#: library/modulefinder.rst:57 msgid "" -"A dictionary mapping module names to modules. See :ref:`modulefinder-example`" +"A dictionary mapping module names to modules. See :ref:`modulefinder-" +"example`." msgstr "" -#: ../src/Doc/library/modulefinder.rst:64 +#: library/modulefinder.rst:64 msgid "Example usage of :class:`ModuleFinder`" msgstr "" -#: ../src/Doc/library/modulefinder.rst:66 +#: library/modulefinder.rst:66 msgid "The script that is going to get analyzed later on (bacon.py)::" msgstr "" -#: ../src/Doc/library/modulefinder.rst:81 +#: library/modulefinder.rst:81 msgid "The script that will output the report of bacon.py::" msgstr "" -#: ../src/Doc/library/modulefinder.rst:97 +#: library/modulefinder.rst:97 msgid "Sample output (may vary depending on the architecture)::" msgstr "" -#: ../src/Doc/library/modules.rst:6 +#: library/modules.rst:6 msgid "Importing Modules" msgstr "" -#: ../src/Doc/library/modules.rst:8 +#: library/modules.rst:8 msgid "" "The modules described in this chapter provide new ways to import other " "Python modules and hooks for customizing the import process." msgstr "" -#: ../src/Doc/library/msilib.rst:2 +#: library/msilib.rst:2 msgid ":mod:`msilib` --- Read and write Microsoft Installer files" msgstr "" -#: ../src/Doc/library/msilib.rst:15 +#: library/msilib.rst:15 msgid "" "The :mod:`msilib` supports the creation of Microsoft Installer (``.msi``) " "files. Because these files often contain an embedded \"cabinet\" file (``." @@ -63325,7 +64725,7 @@ msgid "" "database is possible." msgstr "" -#: ../src/Doc/library/msilib.rst:20 +#: library/msilib.rst:20 msgid "" "This package aims to provide complete access to all tables in an ``.msi`` " "file, therefore, it is a fairly low-level API. Two primary applications of " @@ -63334,41 +64734,41 @@ msgid "" "different version of ``msilib``)." msgstr "" -#: ../src/Doc/library/msilib.rst:26 +#: library/msilib.rst:26 msgid "" "The package contents can be roughly split into four parts: low-level CAB " "routines, low-level MSI routines, higher-level MSI routines, and standard " "table structures." msgstr "" -#: ../src/Doc/library/msilib.rst:33 +#: library/msilib.rst:33 msgid "" "Create a new CAB file named *cabname*. *files* must be a list of tuples, " "each containing the name of the file on disk, and the name of the file " "inside the CAB file." msgstr "" -#: ../src/Doc/library/msilib.rst:37 +#: library/msilib.rst:37 msgid "" "The files are added to the CAB file in the order they appear in the list. " "All files are added into a single CAB file, using the MSZIP compression " "algorithm." msgstr "" -#: ../src/Doc/library/msilib.rst:40 +#: library/msilib.rst:40 msgid "" "Callbacks to Python for the various steps of MSI creation are currently not " "exposed." msgstr "" # 472c0c7a04164949a18b53f2d8299fde -#: ../src/Doc/library/msilib.rst:46 +#: library/msilib.rst:46 msgid "" "Return the string representation of a new unique identifier. This wraps the " "Windows API functions :c:func:`UuidCreate` and :c:func:`UuidToString`." msgstr "" -#: ../src/Doc/library/msilib.rst:52 +#: library/msilib.rst:52 msgid "" "Return a new database object by calling MsiOpenDatabase. *path* is the " "file name of the MSI file; *persist* can be one of the constants " @@ -63380,87 +64780,87 @@ msgid "" msgstr "" # ac959200c049461e88c27206dbb7218b -#: ../src/Doc/library/msilib.rst:63 +#: library/msilib.rst:63 msgid "" "Return a new record object by calling :c:func:`MSICreateRecord`. *count* is " "the number of fields of the record." msgstr "" -#: ../src/Doc/library/msilib.rst:69 +#: library/msilib.rst:69 msgid "" "Create and return a new database *name*, initialize it with *schema*, and " "set the properties *ProductName*, *ProductCode*, *ProductVersion*, and " "*Manufacturer*." msgstr "" -#: ../src/Doc/library/msilib.rst:73 +#: library/msilib.rst:73 msgid "" "*schema* must be a module object containing ``tables`` and " "``_Validation_records`` attributes; typically, :mod:`msilib.schema` should " "be used." msgstr "" -#: ../src/Doc/library/msilib.rst:77 +#: library/msilib.rst:77 msgid "" "The database will contain just the schema and the validation records when " "this function returns." msgstr "" -#: ../src/Doc/library/msilib.rst:83 +#: library/msilib.rst:83 msgid "Add all *records* to the table named *table* in *database*." msgstr "" -#: ../src/Doc/library/msilib.rst:85 +#: library/msilib.rst:85 msgid "" "The *table* argument must be one of the predefined tables in the MSI schema, " "e.g. ``'Feature'``, ``'File'``, ``'Component'``, ``'Dialog'``, " "``'Control'``, etc." msgstr "" -#: ../src/Doc/library/msilib.rst:89 +#: library/msilib.rst:89 msgid "" "*records* should be a list of tuples, each one containing all fields of a " "record according to the schema of the table. For optional fields, ``None`` " "can be passed." msgstr "" -#: ../src/Doc/library/msilib.rst:93 +#: library/msilib.rst:93 msgid "" "Field values can be int or long numbers, strings, or instances of the Binary " "class." msgstr "" -#: ../src/Doc/library/msilib.rst:99 +#: library/msilib.rst:99 msgid "" "Represents entries in the Binary table; inserting such an object using :func:" "`add_data` reads the file named *filename* into the table." msgstr "" -#: ../src/Doc/library/msilib.rst:105 +#: library/msilib.rst:105 msgid "" "Add all table content from *module* to *database*. *module* must contain an " "attribute *tables* listing all tables for which content should be added, and " "one attribute per table that has the actual content." msgstr "" -#: ../src/Doc/library/msilib.rst:109 +#: library/msilib.rst:109 msgid "This is typically used to install the sequence tables." msgstr "" -#: ../src/Doc/library/msilib.rst:114 +#: library/msilib.rst:114 msgid "" "Add the file *path* into the ``_Stream`` table of *database*, with the " "stream name *name*." msgstr "" -#: ../src/Doc/library/msilib.rst:120 +#: library/msilib.rst:120 msgid "" "Return a new UUID, in the format that MSI typically requires (i.e. in curly " "braces, and with all hexdigits in upper-case)." msgstr "" # b2a33ac22f5a46029b7aa0ac392f4317 -#: ../src/Doc/library/msilib.rst:126 +#: library/msilib.rst:126 msgid "" "`FCICreateFile `_ `UuidCreate `_ `MSIDatabaseCommit `_" msgstr "" -#: ../src/Doc/library/msilib.rst:164 +#: library/msilib.rst:164 msgid "View Objects" msgstr "" # 6b4bbbf46c4543a19f542738f9378f27 -#: ../src/Doc/library/msilib.rst:169 +#: library/msilib.rst:169 msgid "" "Execute the SQL query of the view, through :c:func:`MSIViewExecute`. If " "*params* is not ``None``, it is a record describing actual values of the " @@ -63512,7 +64912,7 @@ msgid "" msgstr "" # da458741c7bb49af90f7ea395d2ff4bf -#: ../src/Doc/library/msilib.rst:176 +#: library/msilib.rst:176 msgid "" "Return a record describing the columns of the view, through calling :c:func:" "`MsiViewGetColumnInfo`. *kind* can be either ``MSICOLINFO_NAMES`` or " @@ -63520,13 +64920,13 @@ msgid "" msgstr "" # eb81e7fc30324b918871a7cd0d862400 -#: ../src/Doc/library/msilib.rst:183 +#: library/msilib.rst:183 msgid "" "Return a result record of the query, through calling :c:func:`MsiViewFetch`." msgstr "" # adb9b7b4d3054593abd7fb63e40622c2 -#: ../src/Doc/library/msilib.rst:188 +#: library/msilib.rst:188 msgid "" "Modify the view, by calling :c:func:`MsiViewModify`. *kind* can be one of " "``MSIMODIFY_SEEK``, ``MSIMODIFY_REFRESH``, ``MSIMODIFY_INSERT``, " @@ -63536,17 +64936,17 @@ msgid "" "``MSIMODIFY_VALIDATE_FIELD``, or ``MSIMODIFY_VALIDATE_DELETE``." msgstr "" -#: ../src/Doc/library/msilib.rst:195 +#: library/msilib.rst:195 msgid "*data* must be a record describing the new data." msgstr "" # e755d3273ef242cb9df23398711976bc -#: ../src/Doc/library/msilib.rst:200 +#: library/msilib.rst:200 msgid "Close the view, through :c:func:`MsiViewClose`." msgstr "" # 60fc31005cbf422b88c1633a5f6715b3 -#: ../src/Doc/library/msilib.rst:205 +#: library/msilib.rst:205 msgid "" "`MsiViewExecute `_ `MSIViewGetColumnInfo `_" msgstr "" -#: ../src/Doc/library/msilib.rst:214 +#: library/msilib.rst:214 msgid "Summary Information Objects" msgstr "" # c23941afecad421aa0f663dad6efaadf -#: ../src/Doc/library/msilib.rst:219 +#: library/msilib.rst:219 msgid "" "Return a property of the summary, through :c:func:" "`MsiSummaryInfoGetProperty`. *field* is the name of the property, and can be " @@ -63574,14 +64974,14 @@ msgid "" msgstr "" # 53fa774455e14c0d82d71e190f4eaae7 -#: ../src/Doc/library/msilib.rst:230 +#: library/msilib.rst:230 msgid "" "Return the number of summary properties, through :c:func:" "`MsiSummaryInfoGetPropertyCount`." msgstr "" # 7b25b6ec5f0d49d4af194e2fa385acd2 -#: ../src/Doc/library/msilib.rst:236 +#: library/msilib.rst:236 msgid "" "Set a property through :c:func:`MsiSummaryInfoSetProperty`. *field* can have " "the same values as in :meth:`GetProperty`, *value* is the new value of the " @@ -63589,14 +64989,14 @@ msgid "" msgstr "" # 4de64144e35845c3b8ffe35114bf770a -#: ../src/Doc/library/msilib.rst:243 +#: library/msilib.rst:243 msgid "" "Write the modified properties to the summary information stream, using :c:" "func:`MsiSummaryInfoPersist`." msgstr "" # 280aef293ac6439682cb58cec890e8cc -#: ../src/Doc/library/msilib.rst:249 +#: library/msilib.rst:249 msgid "" "`MsiSummaryInfoGetProperty `_ " @@ -63608,58 +65008,58 @@ msgid "" "msisummaryinfopersist.asp>`_" msgstr "" -#: ../src/Doc/library/msilib.rst:257 +#: library/msilib.rst:257 msgid "Record Objects" msgstr "" # 6e6cbf07e12a481f8537668a7b5124bd -#: ../src/Doc/library/msilib.rst:262 +#: library/msilib.rst:262 msgid "" "Return the number of fields of the record, through :c:func:" "`MsiRecordGetFieldCount`." msgstr "" -#: ../src/Doc/library/msilib.rst:268 +#: library/msilib.rst:268 msgid "" "Return the value of *field* as an integer where possible. *field* must be " "an integer." msgstr "" -#: ../src/Doc/library/msilib.rst:274 +#: library/msilib.rst:274 msgid "" "Return the value of *field* as a string where possible. *field* must be an " "integer." msgstr "" # dbcefd272e494426afd8f701d5e0e592 -#: ../src/Doc/library/msilib.rst:280 +#: library/msilib.rst:280 msgid "" "Set *field* to *value* through :c:func:`MsiRecordSetString`. *field* must be " "an integer; *value* a string." msgstr "" # fe9f46e1bc874c2686a36c496db6d53b -#: ../src/Doc/library/msilib.rst:286 +#: library/msilib.rst:286 msgid "" "Set *field* to the contents of the file named *value*, through :c:func:" "`MsiRecordSetStream`. *field* must be an integer; *value* a string." msgstr "" # bde1bbc15ea644e7b1f0b659942f6592 -#: ../src/Doc/library/msilib.rst:292 +#: library/msilib.rst:292 msgid "" "Set *field* to *value* through :c:func:`MsiRecordSetInteger`. Both *field* " "and *value* must be an integer." msgstr "" # 17ade156edb4479db1fd348e9d5b41dc -#: ../src/Doc/library/msilib.rst:298 +#: library/msilib.rst:298 msgid "" "Set all fields of the record to 0, through :c:func:`MsiRecordClearData`." msgstr "" # 4c7a8fe7c481428eb81f74df1c2ff311 -#: ../src/Doc/library/msilib.rst:303 +#: library/msilib.rst:303 msgid "" "`MsiRecordGetFieldCount `_ `MsiRecordSetString `_" msgstr "" -#: ../src/Doc/library/msilib.rst:312 +#: library/msilib.rst:312 msgid "Errors" msgstr "" -#: ../src/Doc/library/msilib.rst:314 +#: library/msilib.rst:314 msgid "" "All wrappers around MSI functions raise :exc:`MsiError`; the string inside " "the exception will contain more detail." msgstr "" -#: ../src/Doc/library/msilib.rst:321 +#: library/msilib.rst:321 msgid "CAB Objects" msgstr "" -#: ../src/Doc/library/msilib.rst:326 +#: library/msilib.rst:326 msgid "" "The class :class:`CAB` represents a CAB file. During MSI construction, files " "will be added simultaneously to the ``Files`` table, and to a CAB file. " @@ -63693,34 +65093,34 @@ msgid "" "added to the MSI file." msgstr "" -#: ../src/Doc/library/msilib.rst:331 +#: library/msilib.rst:331 msgid "*name* is the name of the CAB file in the MSI file." msgstr "" -#: ../src/Doc/library/msilib.rst:336 +#: library/msilib.rst:336 msgid "" "Add the file with the pathname *full* to the CAB file, under the name " "*logical*. If there is already a file named *logical*, a new file name is " "created." msgstr "" -#: ../src/Doc/library/msilib.rst:340 +#: library/msilib.rst:340 msgid "" "Return the index of the file in the CAB file, and the new name of the file " "inside the CAB file." msgstr "" -#: ../src/Doc/library/msilib.rst:346 +#: library/msilib.rst:346 msgid "" "Generate a CAB file, add it as a stream to the MSI file, put it into the " "``Media`` table, and remove the generated file from the disk." msgstr "" -#: ../src/Doc/library/msilib.rst:353 +#: library/msilib.rst:353 msgid "Directory Objects" msgstr "" -#: ../src/Doc/library/msilib.rst:358 +#: library/msilib.rst:358 msgid "" "Create a new directory in the Directory table. There is a current component " "at each point in time for the directory, which is either explicitly created " @@ -63732,7 +65132,7 @@ msgid "" "table. *componentflags* specifies the default flags that new components get." msgstr "" -#: ../src/Doc/library/msilib.rst:370 +#: library/msilib.rst:370 msgid "" "Add an entry to the Component table, and make this component the current " "component for this directory. If no component name is given, the directory " @@ -63741,7 +65141,7 @@ msgid "" "is given, the KeyPath is left null in the Component table." msgstr "" -#: ../src/Doc/library/msilib.rst:379 +#: library/msilib.rst:379 msgid "" "Add a file to the current component of the directory, starting a new one if " "there is no current component. By default, the file name in the source and " @@ -63750,18 +65150,18 @@ msgid "" "*language* can be specified for the entry in the File table." msgstr "" -#: ../src/Doc/library/msilib.rst:388 +#: library/msilib.rst:388 msgid "" "Add a list of files to the current component as specified in the glob " "pattern. Individual files can be excluded in the *exclude* list." msgstr "" -#: ../src/Doc/library/msilib.rst:394 +#: library/msilib.rst:394 msgid "Remove ``.pyc``/``.pyo`` files on uninstall." msgstr "" # 25822c6bc24149c1be92c1aa4460a2e5 -#: ../src/Doc/library/msilib.rst:399 +#: library/msilib.rst:399 msgid "" "`Directory Table `_ `File Table `_" msgstr "" -#: ../src/Doc/library/msilib.rst:407 ../src/Doc/library/turtle.rst:2179 +#: library/msilib.rst:407 library/turtle.rst:2179 msgid "Features" msgstr "" -#: ../src/Doc/library/msilib.rst:412 +#: library/msilib.rst:412 msgid "" "Add a new record to the ``Feature`` table, using the values *id*, *parent." "id*, *title*, *desc*, *display*, *level*, *directory*, and *attributes*. The " @@ -63783,7 +65183,7 @@ msgid "" "of :class:`Directory`." msgstr "" -#: ../src/Doc/library/msilib.rst:420 +#: library/msilib.rst:420 msgid "" "Make this feature the current feature of :mod:`msilib`. New components are " "automatically added to the default feature, unless a feature is explicitly " @@ -63791,18 +65191,18 @@ msgid "" msgstr "" # 57da848008f84527a54658132ce6bd7f -#: ../src/Doc/library/msilib.rst:427 +#: library/msilib.rst:427 msgid "" "`Feature Table `_" msgstr "" -#: ../src/Doc/library/msilib.rst:432 +#: library/msilib.rst:432 msgid "GUI classes" msgstr "" # e1f3fe7149824ca4b441a06524203735 -#: ../src/Doc/library/msilib.rst:434 +#: library/msilib.rst:434 msgid "" ":mod:`msilib` provides several classes that wrap the GUI tables in an MSI " "database. However, no standard user interface is provided; use :mod:" @@ -63810,83 +65210,83 @@ msgid "" "installing Python packages." msgstr "" -#: ../src/Doc/library/msilib.rst:442 +#: library/msilib.rst:442 msgid "" "Base class of the dialog controls. *dlg* is the dialog object the control " "belongs to, and *name* is the control's name." msgstr "" -#: ../src/Doc/library/msilib.rst:448 +#: library/msilib.rst:448 msgid "Make an entry into the ``ControlEvent`` table for this control." msgstr "" -#: ../src/Doc/library/msilib.rst:453 +#: library/msilib.rst:453 msgid "Make an entry into the ``EventMapping`` table for this control." msgstr "" -#: ../src/Doc/library/msilib.rst:458 +#: library/msilib.rst:458 msgid "Make an entry into the ``ControlCondition`` table for this control." msgstr "" -#: ../src/Doc/library/msilib.rst:463 +#: library/msilib.rst:463 msgid "" "Create a radio button control named *name*. *property* is the installer " "property that gets set when a radio button is selected." msgstr "" # 640e9d2a951e4409959d52ee55593957 -#: ../src/Doc/library/msilib.rst:469 +#: library/msilib.rst:469 msgid "" "Add a radio button named *name* to the group, at the coordinates *x*, *y*, " "*width*, *height*, and with the label *text*. If *value* is omitted, it " "defaults to *name*." msgstr "" -#: ../src/Doc/library/msilib.rst:476 +#: library/msilib.rst:476 msgid "" "Return a new :class:`Dialog` object. An entry in the ``Dialog`` table is " "made, with the specified coordinates, dialog attributes, title, name of the " "first, default, and cancel controls." msgstr "" -#: ../src/Doc/library/msilib.rst:483 +#: library/msilib.rst:483 msgid "" "Return a new :class:`Control` object. An entry in the ``Control`` table is " "made with the specified parameters." msgstr "" -#: ../src/Doc/library/msilib.rst:486 +#: library/msilib.rst:486 msgid "" "This is a generic method; for specific types, specialized methods are " "provided." msgstr "" -#: ../src/Doc/library/msilib.rst:492 +#: library/msilib.rst:492 msgid "Add and return a ``Text`` control." msgstr "" -#: ../src/Doc/library/msilib.rst:497 +#: library/msilib.rst:497 msgid "Add and return a ``Bitmap`` control." msgstr "" -#: ../src/Doc/library/msilib.rst:502 +#: library/msilib.rst:502 msgid "Add and return a ``Line`` control." msgstr "" -#: ../src/Doc/library/msilib.rst:507 +#: library/msilib.rst:507 msgid "Add and return a ``PushButton`` control." msgstr "" -#: ../src/Doc/library/msilib.rst:512 +#: library/msilib.rst:512 msgid "Add and return a ``RadioButtonGroup`` control." msgstr "" -#: ../src/Doc/library/msilib.rst:517 +#: library/msilib.rst:517 msgid "Add and return a ``CheckBox`` control." msgstr "" # 53a791cc753f4ef79a9cc014fbab536f -#: ../src/Doc/library/msilib.rst:522 +#: library/msilib.rst:522 msgid "" "`Dialog Table `_ `Control Table `_" msgstr "" -#: ../src/Doc/library/msilib.rst:533 +#: library/msilib.rst:533 msgid "Precomputed tables" msgstr "" -#: ../src/Doc/library/msilib.rst:535 +#: library/msilib.rst:535 msgid "" ":mod:`msilib` provides a few subpackages that contain only schema and table " "definitions. Currently, these definitions are based on MSI version 2.0." msgstr "" -#: ../src/Doc/library/msilib.rst:541 +#: library/msilib.rst:541 msgid "" "This is the standard MSI schema for MSI 2.0, with the *tables* variable " "providing a list of table definitions, and *_Validation_records* providing " "the data for MSI validation." msgstr "" -#: ../src/Doc/library/msilib.rst:548 +#: library/msilib.rst:548 msgid "" "This module contains table contents for the standard sequence tables: " "*AdminExecuteSequence*, *AdminUISequence*, *AdvtExecuteSequence*, " "*InstallExecuteSequence*, and *InstallUISequence*." msgstr "" -#: ../src/Doc/library/msilib.rst:555 +#: library/msilib.rst:555 msgid "" "This module contains definitions for the UIText and ActionText tables, for " "the standard installer actions." msgstr "" -#: ../src/Doc/library/msvcrt.rst:3 +#: library/msvcrt.rst:3 msgid ":mod:`msvcrt` -- Useful routines from the MS VC++ runtime" msgstr "" -#: ../src/Doc/library/msvcrt.rst:11 +#: library/msvcrt.rst:11 msgid "" "These functions provide access to some useful capabilities on Windows " "platforms. Some higher-level modules use these functions to build the " @@ -63942,25 +65342,25 @@ msgid "" "module uses this in the implementation of the :func:`getpass` function." msgstr "" -#: ../src/Doc/library/msvcrt.rst:16 +#: library/msvcrt.rst:16 msgid "" "Further documentation on these functions can be found in the Platform API " "documentation." msgstr "" -#: ../src/Doc/library/msvcrt.rst:19 +#: library/msvcrt.rst:19 msgid "" "The module implements both the normal and wide char variants of the console " "I/O api. The normal API deals only with ASCII characters and is of limited " "use for internationalized applications. The wide char API should be used " -"where ever possible" +"where ever possible." msgstr "" -#: ../src/Doc/library/msvcrt.rst:27 +#: library/msvcrt.rst:27 msgid "File Operations" msgstr "" -#: ../src/Doc/library/msvcrt.rst:32 +#: library/msvcrt.rst:32 msgid "" "Lock part of a file based on file descriptor *fd* from the C runtime. " "Raises :exc:`IOError` on failure. The locked region of the file extends " @@ -63971,31 +65371,31 @@ msgid "" "individually." msgstr "" -#: ../src/Doc/library/msvcrt.rst:43 +#: library/msvcrt.rst:43 msgid "" "Locks the specified bytes. If the bytes cannot be locked, the program " "immediately tries again after 1 second. If, after 10 attempts, the bytes " "cannot be locked, :exc:`IOError` is raised." msgstr "" -#: ../src/Doc/library/msvcrt.rst:51 +#: library/msvcrt.rst:51 msgid "" "Locks the specified bytes. If the bytes cannot be locked, :exc:`IOError` is " "raised." msgstr "" -#: ../src/Doc/library/msvcrt.rst:57 +#: library/msvcrt.rst:57 msgid "Unlocks the specified bytes, which must have been previously locked." msgstr "" -#: ../src/Doc/library/msvcrt.rst:62 +#: library/msvcrt.rst:62 msgid "" "Set the line-end translation mode for the file descriptor *fd*. To set it to " "text mode, *flags* should be :const:`os.O_TEXT`; for binary, it should be :" "const:`os.O_BINARY`." msgstr "" -#: ../src/Doc/library/msvcrt.rst:69 +#: library/msvcrt.rst:69 msgid "" "Create a C runtime file descriptor from the file handle *handle*. The " "*flags* parameter should be a bitwise OR of :const:`os.O_APPEND`, :const:`os." @@ -64003,21 +65403,21 @@ msgid "" "as a parameter to :func:`os.fdopen` to create a file object." msgstr "" -#: ../src/Doc/library/msvcrt.rst:77 +#: library/msvcrt.rst:77 msgid "" "Return the file handle for the file descriptor *fd*. Raises :exc:`IOError` " "if *fd* is not recognized." msgstr "" -#: ../src/Doc/library/msvcrt.rst:84 +#: library/msvcrt.rst:84 msgid "Console I/O" msgstr "" -#: ../src/Doc/library/msvcrt.rst:89 +#: library/msvcrt.rst:89 msgid "Return true if a keypress is waiting to be read." msgstr "" -#: ../src/Doc/library/msvcrt.rst:94 +#: library/msvcrt.rst:94 msgid "" "Read a keypress and return the resulting character. Nothing is echoed to " "the console. This call will block if a keypress is not already available, " @@ -64027,56 +65427,63 @@ msgid "" "with this function." msgstr "" -#: ../src/Doc/library/msvcrt.rst:104 +#: library/msvcrt.rst:104 msgid "Wide char variant of :func:`getch`, returning a Unicode value." msgstr "" -#: ../src/Doc/library/msvcrt.rst:111 +#: library/msvcrt.rst:111 msgid "" "Similar to :func:`getch`, but the keypress will be echoed if it represents " "a printable character." msgstr "" -#: ../src/Doc/library/msvcrt.rst:117 +#: library/msvcrt.rst:117 msgid "Wide char variant of :func:`getche`, returning a Unicode value." msgstr "" -#: ../src/Doc/library/msvcrt.rst:124 +#: library/msvcrt.rst:124 msgid "Print the character *char* to the console without buffering." msgstr "" -#: ../src/Doc/library/msvcrt.rst:129 +#: library/msvcrt.rst:129 msgid "Wide char variant of :func:`putch`, accepting a Unicode value." msgstr "" -#: ../src/Doc/library/msvcrt.rst:136 +#: library/msvcrt.rst:136 msgid "" "Cause the character *char* to be \"pushed back\" into the console buffer; it " "will be the next character read by :func:`getch` or :func:`getche`." msgstr "" -#: ../src/Doc/library/msvcrt.rst:142 +#: library/msvcrt.rst:142 msgid "Wide char variant of :func:`ungetch`, accepting a Unicode value." msgstr "" -#: ../src/Doc/library/msvcrt.rst:150 +#: library/msvcrt.rst:150 msgid "Other Functions" msgstr "" # f17975fe9326435d971e7bbdee3c2289 -#: ../src/Doc/library/msvcrt.rst:155 +#: library/msvcrt.rst:155 msgid "" "Force the :c:func:`malloc` heap to clean itself up and return unused blocks " "to the operating system. On failure, this raises :exc:`IOError`." msgstr "" # 3d1015a7a96e4c08baa9dec88b199aac -#: ../src/Doc/library/multifile.rst:3 +#: library/multifile.rst:3 msgid ":mod:`multifile` --- Support for files containing distinct parts" msgstr "" +#: library/multifile.rst:11 +msgid "" +"The :mod:`email` package should be used in preference to the :mod:" +"`multifile` module. This module is present only to maintain backward " +"compatibility." +msgstr "" + # d137c4bf2eae42bd959dd06de4c2295d -#: ../src/Doc/library/multifile.rst:15 +#: library/multifile.rst:15 msgid "" "The :class:`MultiFile` object enables you to treat sections of a text file " "as file-like input objects, with ``''`` being returned by :meth:`readline` " @@ -64087,7 +65494,7 @@ msgid "" msgstr "" # aa4f917cb4dd45b089cd136538210047 -#: ../src/Doc/library/multifile.rst:24 +#: library/multifile.rst:24 msgid "" "Create a multi-file. You must instantiate this class with an input object " "argument for the :class:`MultiFile` instance to get lines from, such as a " @@ -64095,7 +65502,7 @@ msgid "" msgstr "" # 6f4f5a66acb540cbbceffb8723f97d07 -#: ../src/Doc/library/multifile.rst:28 +#: library/multifile.rst:28 msgid "" ":class:`MultiFile` only ever looks at the input object's :meth:`readline`, :" "meth:`seek` and :meth:`tell` methods, and the latter two are only needed if " @@ -64106,7 +65513,7 @@ msgid "" msgstr "" # eacd6a1f17c647ffa11de819096cd526 -#: ../src/Doc/library/multifile.rst:34 +#: library/multifile.rst:34 msgid "" "It will be useful to know that in :class:`MultiFile`'s view of the world, " "text is composed of three kinds of lines: data, section-dividers, and end-" @@ -64116,23 +65523,23 @@ msgid "" msgstr "" # 64693295926e4d7db7c1fee68dc4f167 -#: ../src/Doc/library/multifile.rst:44 +#: library/multifile.rst:44 msgid "" "Comprehensive email handling package; supersedes the :mod:`multifile` module." msgstr "" # 4c671a145060488b9b961856312d3573 -#: ../src/Doc/library/multifile.rst:50 +#: library/multifile.rst:50 msgid "MultiFile Objects" msgstr "" # 8f007093c46a48e29c4a0faba940b43b -#: ../src/Doc/library/multifile.rst:52 +#: library/multifile.rst:52 msgid "A :class:`MultiFile` instance has the following methods:" msgstr "" # f8e9cdaaab844dcba9fad49f8cdd6fe4 -#: ../src/Doc/library/multifile.rst:57 +#: library/multifile.rst:57 msgid "" "Read a line. If the line is data (not a section-divider or end-marker or " "real EOF) return it. If the line matches the most-recently-stacked " @@ -64144,31 +65551,31 @@ msgid "" msgstr "" # 00c69eeb015846199acef06b42377f56 -#: ../src/Doc/library/multifile.rst:67 +#: library/multifile.rst:67 msgid "Return all lines remaining in this part as a list of strings." msgstr "" # eff6977672ce49e2a85cbfc65ac3aade -#: ../src/Doc/library/multifile.rst:72 +#: library/multifile.rst:72 msgid "" "Read all lines, up to the next section. Return them as a single (multiline) " "string. Note that this doesn't take a size argument!" msgstr "" # 59bf206d19714fbd901316bc89228194 -#: ../src/Doc/library/multifile.rst:78 +#: library/multifile.rst:78 msgid "" "Seek. Seek indices are relative to the start of the current section. The " "*pos* and *whence* arguments are interpreted as for a file seek." msgstr "" # d5fe63a2d9e34cd18babe31d92336956 -#: ../src/Doc/library/multifile.rst:84 +#: library/multifile.rst:84 msgid "Return the file position relative to the start of the current section." msgstr "" # ab9e14496b5a4d818088a03978e6c045 -#: ../src/Doc/library/multifile.rst:89 +#: library/multifile.rst:89 msgid "" "Skip lines to the next section (that is, read lines until a section-divider " "or end-marker has been consumed). Return true if there is such a section, " @@ -64176,7 +65583,7 @@ msgid "" msgstr "" # df3c9da6ee54471cacb4f3901492a868 -#: ../src/Doc/library/multifile.rst:96 +#: library/multifile.rst:96 msgid "" "Return true if *str* is data and false if it might be a section boundary. " "As written, it tests for a prefix other than ``'-``\\ ``-'`` at start of " @@ -64185,7 +65592,7 @@ msgid "" msgstr "" # ba2d7f1c3893475faf9ec39284a1aca1 -#: ../src/Doc/library/multifile.rst:101 +#: library/multifile.rst:101 msgid "" "Note that this test is used intended as a fast guard for the real boundary " "tests; if it always returns false it will merely slow processing, not cause " @@ -64193,7 +65600,7 @@ msgid "" msgstr "" # 376c48f01f62495dadf5c47e7ce50889 -#: ../src/Doc/library/multifile.rst:108 +#: library/multifile.rst:108 msgid "" "Push a boundary string. When a decorated version of this boundary is found " "as an input line, it will be interpreted as a section-divider or end-marker " @@ -64203,7 +65610,7 @@ msgid "" msgstr "" # a47d485ca06c48bf818b8640041b851d -#: ../src/Doc/library/multifile.rst:114 +#: library/multifile.rst:114 msgid "" "It is possible to push more than one boundary. Encountering the most-" "recently-pushed boundary will return EOF; encountering any other boundary " @@ -64211,13 +65618,13 @@ msgid "" msgstr "" # a944c89af50e43ff907b7f3dcfb98205 -#: ../src/Doc/library/multifile.rst:121 +#: library/multifile.rst:121 msgid "" "Pop a section boundary. This boundary will no longer be interpreted as EOF." msgstr "" # 77c2011643864a1ca88e011c815aa1d2 -#: ../src/Doc/library/multifile.rst:126 +#: library/multifile.rst:126 msgid "" "Turn a boundary into a section-divider line. By default, this method " "prepends ``'--'`` (which MIME section boundaries have) but it is declared so " @@ -64226,7 +65633,7 @@ msgid "" msgstr "" # 369d9cf49c00491793ef45b4935fff5c -#: ../src/Doc/library/multifile.rst:134 +#: library/multifile.rst:134 msgid "" "Turn a boundary string into an end-marker line. By default, this method " "prepends ``'--'`` and appends ``'--'`` (like a MIME-multipart end-of-message " @@ -64236,31 +65643,31 @@ msgid "" msgstr "" # 0a5807763de04825b58fde40b2f7566b -#: ../src/Doc/library/multifile.rst:140 +#: library/multifile.rst:140 msgid "" "Finally, :class:`MultiFile` instances have two public instance variables:" msgstr "" # aceedaac31664db8a0ba7061514292e6 -#: ../src/Doc/library/multifile.rst:145 +#: library/multifile.rst:145 msgid "Nesting depth of the current part." msgstr "" # ebd7ffa1f42543b49e99dba9b5b829b4 -#: ../src/Doc/library/multifile.rst:150 +#: library/multifile.rst:150 msgid "True if the last end-of-file was for an end-of-message marker." msgstr "" # 2c7989c939e74ff4b3eb184157fcd5cf -#: ../src/Doc/library/multifile.rst:156 +#: library/multifile.rst:156 msgid ":class:`MultiFile` Example" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2 +#: library/multiprocessing.rst:2 msgid ":mod:`multiprocessing` --- Process-based \"threading\" interface" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:13 +#: library/multiprocessing.rst:13 msgid "" ":mod:`multiprocessing` is a package that supports spawning processes using " "an API similar to the :mod:`threading` module. The :mod:`multiprocessing` " @@ -64271,37 +65678,27 @@ msgid "" "runs on both Unix and Windows." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:23 +#: library/multiprocessing.rst:21 msgid "" -"Some of this package's functionality requires a functioning shared semaphore " -"implementation on the host operating system. Without one, the :mod:" -"`multiprocessing.synchronize` module will be disabled, and attempts to " -"import it will result in an :exc:`ImportError`. See :issue:`3770` for " -"additional information." +"The :mod:`multiprocessing` module also introduces APIs which do not have " +"analogs in the :mod:`threading` module. A prime example of this is the :" +"class:`Pool` object which offers a convenient means of parallelizing the " +"execution of a function across multiple input values, distributing the input " +"data across processes (data parallelism). The following example " +"demonstrates the common practice of defining such functions in a module so " +"that child processes can successfully import that module. This basic " +"example of data parallelism using :class:`Pool`, ::" msgstr "" -# a0f30e2f5704418382ee5f9291c14842 -#: ../src/Doc/library/multiprocessing.rst:31 -msgid "" -"Functionality within this package requires that the ``__main__`` module be " -"importable by the children. This is covered in :ref:`multiprocessing-" -"programming` however it is worth pointing out here. This means that some " -"examples, such as the :class:`multiprocessing.Pool` examples will not work " -"in the interactive interpreter. For example::" +#: library/multiprocessing.rst:39 +msgid "will print to standard output ::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:53 -msgid "" -"(If you try this it will actually output three full tracebacks interleaved " -"in a semi-random fashion, and then you may have to stop the master process " -"somehow.)" -msgstr "" - -#: ../src/Doc/library/multiprocessing.rst:59 +#: library/multiprocessing.rst:45 msgid "The :class:`Process` class" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:61 +#: library/multiprocessing.rst:47 msgid "" "In :mod:`multiprocessing`, processes are spawned by creating a :class:" "`Process` object and then calling its :meth:`~Process.start` method. :class:" @@ -64309,53 +65706,53 @@ msgid "" "of a multiprocess program is ::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:76 +#: library/multiprocessing.rst:62 msgid "" "To show the individual process IDs involved, here is an expanded example::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:98 +#: library/multiprocessing.rst:84 msgid "" "For an explanation of why (on Windows) the ``if __name__ == '__main__'`` " "part is necessary, see :ref:`multiprocessing-programming`." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:104 +#: library/multiprocessing.rst:89 msgid "Exchanging objects between processes" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:106 +#: library/multiprocessing.rst:91 msgid "" ":mod:`multiprocessing` supports two types of communication channel between " "processes:" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:109 +#: library/multiprocessing.rst:94 msgid "**Queues**" msgstr "" # c3bf58dd908d41f59f83c8fd9a829df7 -#: ../src/Doc/library/multiprocessing.rst:111 +#: library/multiprocessing.rst:96 msgid "" "The :class:`~multiprocessing.Queue` class is a near clone of :class:`Queue." "Queue`. For example::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:126 +#: library/multiprocessing.rst:111 msgid "Queues are thread and process safe." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:128 +#: library/multiprocessing.rst:113 msgid "**Pipes**" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:130 +#: library/multiprocessing.rst:115 msgid "" "The :func:`Pipe` function returns a pair of connection objects connected by " "a pipe which by default is duplex (two-way). For example::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:146 +#: library/multiprocessing.rst:131 msgid "" "The two connection objects returned by :func:`Pipe` represent the two ends " "of the pipe. Each connection object has :meth:`~Connection.send` and :meth:" @@ -64365,57 +65762,56 @@ msgid "" "corruption from processes using different ends of the pipe at the same time." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:156 +#: library/multiprocessing.rst:141 msgid "Synchronization between processes" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:158 +#: library/multiprocessing.rst:143 msgid "" ":mod:`multiprocessing` contains equivalents of all the synchronization " "primitives from :mod:`threading`. For instance one can use a lock to ensure " "that only one process prints to standard output at a time::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:175 +#: library/multiprocessing.rst:160 msgid "" "Without using the lock output from the different processes is liable to get " "all mixed up." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:180 +#: library/multiprocessing.rst:165 msgid "Sharing state between processes" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:182 +#: library/multiprocessing.rst:167 msgid "" "As mentioned above, when doing concurrent programming it is usually best to " "avoid using shared state as far as possible. This is particularly true when " "using multiple processes." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:186 +#: library/multiprocessing.rst:171 msgid "" "However, if you really do need to use some shared data then :mod:" "`multiprocessing` provides a couple of ways of doing so." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:189 +#: library/multiprocessing.rst:174 msgid "**Shared memory**" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:191 +#: library/multiprocessing.rst:176 msgid "" "Data can be stored in a shared memory map using :class:`Value` or :class:" "`Array`. For example, the following code ::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:212 -#: ../src/Doc/library/multiprocessing.rst:259 +#: library/multiprocessing.rst:197 library/multiprocessing.rst:244 msgid "will print ::" msgstr "" # c054ad77125a4d599c70bb32e7bd3cef -#: ../src/Doc/library/multiprocessing.rst:217 +#: library/multiprocessing.rst:202 msgid "" "The ``'d'`` and ``'i'`` arguments used when creating ``num`` and ``arr`` are " "typecodes of the kind used by the :mod:`array` module: ``'d'`` indicates a " @@ -64423,18 +65819,18 @@ msgid "" "objects will be process and thread-safe." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:222 +#: library/multiprocessing.rst:207 msgid "" "For more flexibility in using shared memory one can use the :mod:" "`multiprocessing.sharedctypes` module which supports the creation of " "arbitrary ctypes objects allocated from shared memory." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:226 +#: library/multiprocessing.rst:211 msgid "**Server process**" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:228 +#: library/multiprocessing.rst:213 msgid "" "A manager object returned by :func:`Manager` controls a server process which " "holds Python objects and allows other processes to manipulate them using " @@ -64442,7 +65838,7 @@ msgid "" msgstr "" # bee37f0b28614fe0aee2d870cb4832c9 -#: ../src/Doc/library/multiprocessing.rst:232 +#: library/multiprocessing.rst:217 msgid "" "A manager returned by :func:`Manager` will support types :class:`list`, :" "class:`dict`, :class:`Namespace`, :class:`Lock`, :class:`RLock`, :class:" @@ -64451,7 +65847,7 @@ msgid "" "example, ::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:264 +#: library/multiprocessing.rst:249 msgid "" "Server process managers are more flexible than using shared memory objects " "because they can be made to support arbitrary object types. Also, a single " @@ -64459,11 +65855,11 @@ msgid "" "They are, however, slower than using shared memory." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:271 +#: library/multiprocessing.rst:256 msgid "Using a pool of workers" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:273 +#: library/multiprocessing.rst:258 msgid "" "The :class:`~multiprocessing.pool.Pool` class represents a pool of worker " "processes. It has methods which allows tasks to be offloaded to the worker " @@ -64471,35 +65867,50 @@ msgid "" msgstr "" # 14baf8f6a02346a1b17cc61545ea9b9d -#: ../src/Doc/library/multiprocessing.rst:290 +#: library/multiprocessing.rst:275 msgid "" "Note that the methods of a pool should only ever be used by the process " "which created it." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:295 -#: ../src/Doc/library/xml.etree.elementtree.rst:360 +#: library/multiprocessing.rst:280 +msgid "" +"Functionality within this package requires that the ``__main__`` module be " +"importable by the children. This is covered in :ref:`multiprocessing-" +"programming` however it is worth pointing out here. This means that some " +"examples, such as the :class:`Pool` examples will not work in the " +"interactive interpreter. For example::" +msgstr "" + +#: library/multiprocessing.rst:302 +msgid "" +"(If you try this it will actually output three full tracebacks interleaved " +"in a semi-random fashion, and then you may have to stop the master process " +"somehow.)" +msgstr "" + +#: library/multiprocessing.rst:308 library/xml.etree.elementtree.rst:431 msgid "Reference" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:297 +#: library/multiprocessing.rst:310 msgid "" "The :mod:`multiprocessing` package mostly replicates the API of the :mod:" "`threading` module." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:302 +#: library/multiprocessing.rst:315 msgid ":class:`Process` and exceptions" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:306 +#: library/multiprocessing.rst:319 msgid "" "Process objects represent activity that is run in a separate process. The :" "class:`Process` class has equivalents of all the methods of :class:" "`threading.Thread`." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:310 +#: library/multiprocessing.rst:323 msgid "" "The constructor should always be called with keyword arguments. *group* " "should always be ``None``; it exists solely for compatibility with :class:" @@ -64513,18 +65924,18 @@ msgid "" "for the target invocation. By default, no arguments are passed to *target*." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:322 +#: library/multiprocessing.rst:335 msgid "" "If a subclass overrides the constructor, it must make sure it invokes the " "base class constructor (:meth:`Process.__init__`) before doing anything else " "to the process." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:328 +#: library/multiprocessing.rst:341 msgid "Method representing the process's activity." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:330 +#: library/multiprocessing.rst:343 msgid "" "You may override this method in a subclass. The standard :meth:`run` method " "invokes the callable object passed to the object's constructor as the target " @@ -64532,75 +65943,75 @@ msgid "" "*args* and *kwargs* arguments, respectively." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:337 +#: library/multiprocessing.rst:350 msgid "Start the process's activity." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:339 +#: library/multiprocessing.rst:352 msgid "" "This must be called at most once per process object. It arranges for the " "object's :meth:`run` method to be invoked in a separate process." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:344 +#: library/multiprocessing.rst:357 msgid "" "Block the calling thread until the process whose :meth:`join` method is " "called terminates or until the optional timeout occurs." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:347 +#: library/multiprocessing.rst:360 msgid "If *timeout* is ``None`` then there is no timeout." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:349 +#: library/multiprocessing.rst:362 msgid "A process can be joined many times." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:351 +#: library/multiprocessing.rst:364 msgid "" "A process cannot join itself because this would cause a deadlock. It is an " "error to attempt to join a process before it has been started." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:356 +#: library/multiprocessing.rst:369 msgid "The process's name." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:358 +#: library/multiprocessing.rst:371 msgid "" "The name is a string used for identification purposes only. It has no " "semantics. Multiple processes may be given the same name. The initial name " "is set by the constructor." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:364 +#: library/multiprocessing.rst:377 msgid "Return whether the process is alive." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:366 +#: library/multiprocessing.rst:379 msgid "" "Roughly, a process object is alive from the moment the :meth:`start` method " "returns until the child process terminates." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:371 +#: library/multiprocessing.rst:384 msgid "" "The process's daemon flag, a Boolean value. This must be set before :meth:" "`start` is called." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:374 +#: library/multiprocessing.rst:387 msgid "The initial value is inherited from the creating process." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:376 +#: library/multiprocessing.rst:389 msgid "" "When a process exits, it attempts to terminate all of its daemonic child " "processes." msgstr "" # 7c8e526e05ba4702b7e218f07dc0747a -#: ../src/Doc/library/multiprocessing.rst:379 +#: library/multiprocessing.rst:392 msgid "" "Note that a daemonic process is not allowed to create child processes. " "Otherwise a daemonic process would leave its children orphaned if it gets " @@ -64610,61 +66021,61 @@ msgid "" msgstr "" # 3ae0f3ea952d40279e762692bc538622 -#: ../src/Doc/library/multiprocessing.rst:385 +#: library/multiprocessing.rst:398 msgid "" "In addition to the :class:`threading.Thread` API, :class:`Process` objects " "also support the following attributes and methods:" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:390 +#: library/multiprocessing.rst:403 msgid "" "Return the process ID. Before the process is spawned, this will be ``None``." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:395 +#: library/multiprocessing.rst:408 msgid "" "The child's exit code. This will be ``None`` if the process has not yet " "terminated. A negative value *-N* indicates that the child was terminated " "by signal *N*." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:401 +#: library/multiprocessing.rst:414 msgid "The process's authentication key (a byte string)." msgstr "" # 3d20944267d1472cb469e342d46d2ce9 -#: ../src/Doc/library/multiprocessing.rst:403 +#: library/multiprocessing.rst:416 msgid "" "When :mod:`multiprocessing` is initialized the main process is assigned a " "random string using :func:`os.urandom`." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:406 +#: library/multiprocessing.rst:419 msgid "" "When a :class:`Process` object is created, it will inherit the " "authentication key of its parent process, although this may be changed by " "setting :attr:`authkey` to another byte string." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:410 +#: library/multiprocessing.rst:423 msgid "See :ref:`multiprocessing-auth-keys`." msgstr "" # bb3ce8c840824f73bf15dc4d914bfee6 -#: ../src/Doc/library/multiprocessing.rst:414 +#: library/multiprocessing.rst:427 msgid "" "Terminate the process. On Unix this is done using the ``SIGTERM`` signal; " "on Windows :c:func:`TerminateProcess` is used. Note that exit handlers and " "finally clauses, etc., will not be executed." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:418 +#: library/multiprocessing.rst:431 msgid "" "Note that descendant processes of the process will *not* be terminated -- " "they will simply become orphaned." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:423 +#: library/multiprocessing.rst:436 msgid "" "If this method is used when the associated process is using a pipe or queue " "then the pipe or queue is liable to become corrupted and may become unusable " @@ -64674,48 +66085,48 @@ msgid "" msgstr "" # 14baf8f6a02346a1b17cc61545ea9b9d -#: ../src/Doc/library/multiprocessing.rst:429 +#: library/multiprocessing.rst:442 msgid "" "Note that the :meth:`start`, :meth:`join`, :meth:`is_alive`, :meth:" "`terminate` and :attr:`exitcode` methods should only be called by the " "process that created the process object." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:433 +#: library/multiprocessing.rst:446 msgid "Example usage of some of the methods of :class:`Process`:" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:454 +#: library/multiprocessing.rst:467 msgid "" "Exception raised by :meth:`Connection.recv_bytes_into()` when the supplied " "buffer object is too small for the message read." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:457 +#: library/multiprocessing.rst:470 msgid "" "If ``e`` is an instance of :exc:`BufferTooShort` then ``e.args[0]`` will " "give the message as a byte string." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:462 +#: library/multiprocessing.rst:475 msgid "Pipes and Queues" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:464 +#: library/multiprocessing.rst:477 msgid "" "When using multiple processes, one generally uses message passing for " "communication between processes and avoids having to use any synchronization " "primitives like locks." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:468 +#: library/multiprocessing.rst:481 msgid "" "For passing messages one can use :func:`Pipe` (for a connection between two " "processes) or a queue (which allows multiple producers and consumers)." msgstr "" # 76802f618ccf4faba372c182cd633c20 -#: ../src/Doc/library/multiprocessing.rst:471 +#: library/multiprocessing.rst:484 msgid "" "The :class:`~multiprocessing.Queue`, :class:`multiprocessing.queues." "SimpleQueue` and :class:`JoinableQueue` types are multi-producer, multi-" @@ -64726,7 +66137,7 @@ msgid "" msgstr "" # b02620ccb23044a597e8ae429301c624 -#: ../src/Doc/library/multiprocessing.rst:477 +#: library/multiprocessing.rst:490 msgid "" "If you use :class:`JoinableQueue` then you **must** call :meth:" "`JoinableQueue.task_done` for each task removed from the queue or else the " @@ -64734,14 +66145,14 @@ msgid "" "overflow, raising an exception." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:482 +#: library/multiprocessing.rst:495 msgid "" "Note that one can also create a shared queue by using a manager object -- " "see :ref:`multiprocessing-managers`." msgstr "" # c277eee27d4f49238c35024bfdfd0678 -#: ../src/Doc/library/multiprocessing.rst:487 +#: library/multiprocessing.rst:500 msgid "" ":mod:`multiprocessing` uses the usual :exc:`Queue.Empty` and :exc:`Queue." "Full` exceptions to signal a timeout. They are not available in the :mod:" @@ -64749,7 +66160,7 @@ msgid "" msgstr "" # 1225a6eca7c54abc8ccf15e59d54e970 -#: ../src/Doc/library/multiprocessing.rst:494 +#: library/multiprocessing.rst:507 msgid "" "When an object is put on a queue, the object is pickled and a background " "thread later flushes the pickled data to an underlying pipe. This has some " @@ -64759,7 +66170,7 @@ msgid "" msgstr "" # 8edf09b2c2c243b7b5cd930c6da1609c -#: ../src/Doc/library/multiprocessing.rst:501 +#: library/multiprocessing.rst:514 msgid "" "After putting an object on an empty queue there may be an infinitesimal " "delay before the queue's :meth:`~Queue.empty` method returns :const:`False` " @@ -64767,7 +66178,7 @@ msgid "" msgstr "" # ab26c61dd612444db3dc52077dfdf19d -#: ../src/Doc/library/multiprocessing.rst:506 +#: library/multiprocessing.rst:519 msgid "" "If multiple processes are enqueuing objects, it is possible for the objects " "to be received at the other end out-of-order. However, objects enqueued by " @@ -64776,7 +66187,7 @@ msgid "" msgstr "" # dd23ca11eb2440c09f25aa4801b78f1e -#: ../src/Doc/library/multiprocessing.rst:513 +#: library/multiprocessing.rst:526 msgid "" "If a process is killed using :meth:`Process.terminate` or :func:`os.kill` " "while it is trying to use a :class:`~multiprocessing.Queue`, then the data " @@ -64785,7 +66196,7 @@ msgid "" msgstr "" # cd41e71da3e54414954641f9083800e7 -#: ../src/Doc/library/multiprocessing.rst:520 +#: library/multiprocessing.rst:533 msgid "" "As mentioned above, if a child process has put items on a queue (and it has " "not used :meth:`JoinableQueue.cancel_join_thread `, the " "data received is automatically unpickled. Unfortunately unpickling data " @@ -66411,7 +67986,7 @@ msgid "" "authentication." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:1964 +#: library/multiprocessing.rst:2107 msgid "" "An authentication key is a string which can be thought of as a password: " "once a connection is established both ends will demand proof that the other " @@ -66419,7 +67994,7 @@ msgid "" "same key does **not** involve sending the key over the connection.)" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:1969 +#: library/multiprocessing.rst:2112 msgid "" "If authentication is requested but do authentication key is specified then " "the return value of ``current_process().authkey`` is used (see :class:" @@ -66430,17 +68005,17 @@ msgid "" "setting up connections between themselves." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:1977 +#: library/multiprocessing.rst:2120 msgid "" "Suitable authentication keys can also be generated by using :func:`os." "urandom`." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:1981 +#: library/multiprocessing.rst:2124 msgid "Logging" msgstr "Journalisation" -#: ../src/Doc/library/multiprocessing.rst:1983 +#: library/multiprocessing.rst:2126 msgid "" "Some support for logging is available. Note, however, that the :mod:" "`logging` package does not use process shared locks so it is possible " @@ -66448,27 +68023,27 @@ msgid "" "mixed up." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:1990 +#: library/multiprocessing.rst:2133 msgid "" "Returns the logger used by :mod:`multiprocessing`. If necessary, a new one " "will be created." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:1993 +#: library/multiprocessing.rst:2136 msgid "" "When first created the logger has level :data:`logging.NOTSET` and no " "default handler. Messages sent to this logger will not by default propagate " "to the root logger." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:1997 +#: library/multiprocessing.rst:2140 msgid "" "Note that on Windows child processes will only inherit the level of the " "parent process's logger -- any other customization of the logger will not be " "inherited." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2004 +#: library/multiprocessing.rst:2147 msgid "" "This function performs a call to :func:`get_logger` but in addition to " "returning the logger created by get_logger, it adds a handler which sends " @@ -66476,11 +68051,11 @@ msgid "" "%(message)s'``." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2009 +#: library/multiprocessing.rst:2152 msgid "Below is an example session with logging turned on::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2024 +#: library/multiprocessing.rst:2167 msgid "" "In addition to having these two logging functions, the multiprocessing also " "exposes two additional logging level attributes. These are :const:" @@ -66488,105 +68063,104 @@ msgid "" "fit in the normal level hierarchy." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2032 +#: library/multiprocessing.rst:2175 msgid "``SUBWARNING``" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2032 +#: library/multiprocessing.rst:2175 msgid "25" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2034 +#: library/multiprocessing.rst:2177 msgid "``SUBDEBUG``" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2034 ../src/Doc/library/pwd.rst:30 -#: ../src/Doc/library/spwd.rst:37 ../src/Doc/library/time.rst:417 -#: ../src/Doc/library/urlparse.rst:107 +#: library/multiprocessing.rst:2177 library/pwd.rst:30 library/spwd.rst:37 +#: library/time.rst:416 library/urlparse.rst:107 msgid "5" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2037 +#: library/multiprocessing.rst:2180 msgid "For a full table of logging levels, see the :mod:`logging` module." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2039 +#: library/multiprocessing.rst:2182 msgid "" "These additional logging levels are used primarily for certain debug " "messages within the multiprocessing module. Below is the same example as " "above, except with :const:`SUBDEBUG` enabled::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2063 +#: library/multiprocessing.rst:2206 msgid "The :mod:`multiprocessing.dummy` module" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2068 +#: library/multiprocessing.rst:2211 msgid "" ":mod:`multiprocessing.dummy` replicates the API of :mod:`multiprocessing` " "but is no more than a wrapper around the :mod:`threading` module." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2075 +#: library/multiprocessing.rst:2218 msgid "Programming guidelines" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2077 +#: library/multiprocessing.rst:2220 msgid "" "There are certain guidelines and idioms which should be adhered to when " "using :mod:`multiprocessing`." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2082 +#: library/multiprocessing.rst:2225 msgid "All platforms" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2084 +#: library/multiprocessing.rst:2227 msgid "Avoid shared state" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2086 +#: library/multiprocessing.rst:2229 msgid "" "As far as possible one should try to avoid shifting large amounts of data " "between processes." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2089 +#: library/multiprocessing.rst:2232 msgid "" "It is probably best to stick to using queues or pipes for communication " "between processes rather than using the lower level synchronization " "primitives from the :mod:`threading` module." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2093 +#: library/multiprocessing.rst:2236 msgid "Picklability" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2095 +#: library/multiprocessing.rst:2238 msgid "Ensure that the arguments to the methods of proxies are picklable." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2097 +#: library/multiprocessing.rst:2240 msgid "Thread safety of proxies" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2099 +#: library/multiprocessing.rst:2242 msgid "" "Do not use a proxy object from more than one thread unless you protect it " "with a lock." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2102 +#: library/multiprocessing.rst:2245 msgid "" "(There is never a problem with different processes using the *same* proxy.)" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2104 +#: library/multiprocessing.rst:2247 msgid "Joining zombie processes" msgstr "" # ec656715f3ba493fa9b3f16a2205488e -#: ../src/Doc/library/multiprocessing.rst:2106 +#: library/multiprocessing.rst:2249 msgid "" "On Unix when a process finishes but has not been joined it becomes a zombie. " "There should never be very many because each time a new process starts (or :" @@ -66597,12 +68171,12 @@ msgid "" "all the processes that you start." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2114 +#: library/multiprocessing.rst:2257 msgid "Better to inherit than pickle/unpickle" msgstr "" # 1db4a98a057d4d32820e26a3d4221f3a -#: ../src/Doc/library/multiprocessing.rst:2116 +#: library/multiprocessing.rst:2259 msgid "" "On Windows many types from :mod:`multiprocessing` need to be picklable so " "that child processes can use them. However, one should generally avoid " @@ -66611,12 +68185,12 @@ msgid "" "shared resource created elsewhere can inherit it from an ancestor process." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2122 +#: library/multiprocessing.rst:2265 msgid "Avoid terminating processes" msgstr "" # 42326200c5304baea650e622ec4e6be3 -#: ../src/Doc/library/multiprocessing.rst:2124 +#: library/multiprocessing.rst:2267 msgid "" "Using the :meth:`Process.terminate ` " "method to stop a process is liable to cause any shared resources (such as " @@ -66625,19 +68199,19 @@ msgid "" msgstr "" # 7b95f89eaa1f4435a0786985d9c2ea65 -#: ../src/Doc/library/multiprocessing.rst:2130 +#: library/multiprocessing.rst:2273 msgid "" "Therefore it is probably best to only consider using :meth:`Process." "terminate ` on processes which never use " "any shared resources." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2134 +#: library/multiprocessing.rst:2277 msgid "Joining processes that use queues" msgstr "" # b275d375c3474ba0b6355006bcd5a72d -#: ../src/Doc/library/multiprocessing.rst:2136 +#: library/multiprocessing.rst:2279 msgid "" "Bear in mind that a process that has put items in a queue will wait before " "terminating until all the buffered items are fed by the \"feeder\" thread to " @@ -66647,7 +68221,7 @@ msgid "" msgstr "" # aefc4a8145c747dbb83dda83bb5c5df5 -#: ../src/Doc/library/multiprocessing.rst:2141 +#: library/multiprocessing.rst:2284 msgid "" "This means that whenever you use a queue you need to make sure that all " "items which have been put on the queue will eventually be removed before the " @@ -66656,29 +68230,29 @@ msgid "" "processes will be joined automatically." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2147 +#: library/multiprocessing.rst:2290 msgid "An example which will deadlock is the following::" msgstr "" # af73edf0ec894d09a3f16c600c8df525 -#: ../src/Doc/library/multiprocessing.rst:2161 +#: library/multiprocessing.rst:2304 msgid "" "A fix here would be to swap the last two lines (or simply remove the ``p." "join()`` line)." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2164 +#: library/multiprocessing.rst:2307 msgid "Explicitly pass resources to child processes" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2166 +#: library/multiprocessing.rst:2309 msgid "" "On Unix a child process can make use of a shared resource created in a " "parent process using a global resource. However, it is better to pass the " "object as an argument to the constructor for the child process." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2170 +#: library/multiprocessing.rst:2313 msgid "" "Apart from making the code (potentially) compatible with Windows this also " "ensures that as long as the child process is still alive the object will not " @@ -66686,31 +68260,31 @@ msgid "" "resource is freed when the object is garbage collected in the parent process." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2176 +#: library/multiprocessing.rst:2319 msgid "So for instance ::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2188 +#: library/multiprocessing.rst:2331 msgid "should be rewritten as ::" msgstr "" # dfe2c2a59cb047fcbec64d2dadfdf5c4 -#: ../src/Doc/library/multiprocessing.rst:2200 +#: library/multiprocessing.rst:2343 msgid "Beware of replacing :data:`sys.stdin` with a \"file like object\"" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2202 +#: library/multiprocessing.rst:2345 msgid ":mod:`multiprocessing` originally unconditionally called::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2206 +#: library/multiprocessing.rst:2349 msgid "" "in the :meth:`multiprocessing.Process._bootstrap` method --- this resulted " "in issues with processes-in-processes. This has been changed to::" msgstr "" # 93eae33e244340ae8362fd45da22d75a -#: ../src/Doc/library/multiprocessing.rst:2212 +#: library/multiprocessing.rst:2355 msgid "" "Which solves the fundamental issue of processes colliding with each other " "resulting in a bad file descriptor error, but introduces a potential danger " @@ -66720,32 +68294,31 @@ msgid "" "data being flushed to the object multiple times, resulting in corruption." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2219 +#: library/multiprocessing.rst:2362 msgid "" "If you write a file-like object and implement your own caching, you can make " "it fork-safe by storing the pid whenever you append to the cache, and " "discarding the cache when the pid changes. For example::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2231 +#: library/multiprocessing.rst:2374 msgid "" "For more information, see :issue:`5155`, :issue:`5313` and :issue:`5331`" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2234 -#: ../src/Doc/library/socket.rst:639 ../src/Doc/library/sys.rst:759 +#: library/multiprocessing.rst:2377 library/socket.rst:639 library/sys.rst:759 msgid "Windows" msgstr "Windows" -#: ../src/Doc/library/multiprocessing.rst:2236 +#: library/multiprocessing.rst:2379 msgid "Since Windows lacks :func:`os.fork` it has a few extra restrictions:" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2238 +#: library/multiprocessing.rst:2381 msgid "More picklability" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2240 +#: library/multiprocessing.rst:2383 msgid "" "Ensure that all arguments to :meth:`Process.__init__` are picklable. This " "means, in particular, that bound or unbound methods cannot be used directly " @@ -66754,19 +68327,19 @@ msgid "" msgstr "" # ff316ccc35c741c78e963c18f719bc69 -#: ../src/Doc/library/multiprocessing.rst:2245 +#: library/multiprocessing.rst:2388 msgid "" "Also, if you subclass :class:`~multiprocessing.Process` then make sure that " "instances will be picklable when the :meth:`Process.start ` method is called." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2249 +#: library/multiprocessing.rst:2392 msgid "Global variables" msgstr "" # 5436864f04ed4a20ac5fd4c47755b650 -#: ../src/Doc/library/multiprocessing.rst:2251 +#: library/multiprocessing.rst:2394 msgid "" "Bear in mind that if code run in a child process tries to access a global " "variable, then the value it sees (if any) may not be the same as the value " @@ -66774,93 +68347,97 @@ msgid "" "Process.start>` was called." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2256 +#: library/multiprocessing.rst:2399 msgid "" "However, global variables which are just module level constants cause no " "problems." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2259 +#: library/multiprocessing.rst:2402 msgid "Safe importing of main module" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2261 +#: library/multiprocessing.rst:2404 msgid "" "Make sure that the main module can be safely imported by a new Python " "interpreter without causing unintended side effects (such a starting a new " "process)." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2265 +#: library/multiprocessing.rst:2408 msgid "" "For example, under Windows running the following module would fail with a :" "exc:`RuntimeError`::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2276 +#: library/multiprocessing.rst:2419 msgid "" "Instead one should protect the \"entry point\" of the program by using ``if " "__name__ == '__main__':`` as follows::" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2289 +#: library/multiprocessing.rst:2432 msgid "" "(The ``freeze_support()`` line can be omitted if the program will be run " "normally instead of frozen.)" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2292 +#: library/multiprocessing.rst:2435 msgid "" "This allows the newly spawned Python interpreter to safely import the module " "and then run the module's ``foo()`` function." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2295 +#: library/multiprocessing.rst:2438 msgid "" "Similar restrictions apply if a pool or manager is created in the main " "module." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2304 +#: library/multiprocessing.rst:2447 msgid "Demonstration of how to create and use customized managers and proxies:" msgstr "" # b14570b09328427996f3f1591ac64328 -#: ../src/Doc/library/multiprocessing.rst:2309 +#: library/multiprocessing.rst:2452 msgid "Using :class:`~multiprocessing.pool.Pool`:" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2314 +#: library/multiprocessing.rst:2457 msgid "Synchronization types like locks, conditions and queues:" msgstr "" # 9a68188dbb8344a99e4109e9838b04fa -#: ../src/Doc/library/multiprocessing.rst:2319 +#: library/multiprocessing.rst:2462 msgid "" "An example showing how to use queues to feed tasks to a collection of worker " "processes and collect the results:" msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2325 +#: library/multiprocessing.rst:2468 msgid "" "An example of how a pool of worker processes can each run a :class:" "`SimpleHTTPServer.HttpServer` instance while sharing a single listening " "socket." msgstr "" -#: ../src/Doc/library/multiprocessing.rst:2332 +#: library/multiprocessing.rst:2475 msgid "" "Some simple benchmarks comparing :mod:`multiprocessing` with :mod:" "`threading`:" msgstr "" # 1a2c25f1822e48839801a5e5658dfe45 -#: ../src/Doc/library/mutex.rst:3 +#: library/mutex.rst:3 msgid ":mod:`mutex` --- Mutual exclusion support" msgstr "" +#: library/mutex.rst:9 +msgid "The :mod:`mutex` module has been removed in Python 3." +msgstr "" + # 1ebb5a937c814c15b22b99094f11392a -#: ../src/Doc/library/mutex.rst:15 +#: library/mutex.rst:15 msgid "" "The :mod:`mutex` module defines a class that allows mutual-exclusion via " "acquiring and releasing locks. It does not require (or imply) :mod:" @@ -66868,17 +68445,17 @@ msgid "" msgstr "" # 162939210b5e469fad1b87bd47fb1673 -#: ../src/Doc/library/mutex.rst:20 +#: library/mutex.rst:20 msgid "The :mod:`mutex` module defines the following class:" msgstr "" # 2e70138183a5405e896721a2e332dab4 -#: ../src/Doc/library/mutex.rst:25 +#: library/mutex.rst:25 msgid "Create a new (unlocked) mutex." msgstr "" # de734b797ca547a68a0705af4c88e263 -#: ../src/Doc/library/mutex.rst:27 +#: library/mutex.rst:27 msgid "" "A mutex has two pieces of state --- a \"locked\" bit and a queue. When the " "mutex is not locked, the queue is empty. Otherwise, the queue contains zero " @@ -66889,36 +68466,36 @@ msgid "" msgstr "" # e0b6d90bd1cd4eb3bfaab6b9d4a2927e -#: ../src/Doc/library/mutex.rst:34 +#: library/mutex.rst:34 msgid "" "Of course, no multi-threading is implied -- hence the funny interface for :" "meth:`lock`, where a function is called once the lock is acquired." msgstr "" # 131a9ae751ad4484ac4c53a135b6eb66 -#: ../src/Doc/library/mutex.rst:41 +#: library/mutex.rst:41 msgid "Mutex Objects" msgstr "" # 7c8b84a539a1406ab3af2d7ddb120fe7 -#: ../src/Doc/library/mutex.rst:43 +#: library/mutex.rst:43 msgid ":class:`mutex` objects have following methods:" msgstr "" # 184fd9cc1b2946198e5f3e1efc5596ee -#: ../src/Doc/library/mutex.rst:48 +#: library/mutex.rst:48 msgid "Check whether the mutex is locked." msgstr "" # 230feb658c684fd5953ca7470247a8ec -#: ../src/Doc/library/mutex.rst:53 +#: library/mutex.rst:53 msgid "" "\"Atomic\" test-and-set, grab the lock if it is not set, and return " "``True``, otherwise, return ``False``." msgstr "" # 79192ce630914e31b53d03e38f1d8ee2 -#: ../src/Doc/library/mutex.rst:59 +#: library/mutex.rst:59 msgid "" "Execute ``function(argument)``, unless the mutex is locked. In the case it " "is locked, place the function and argument on the queue. See :meth:`unlock` " @@ -66926,39 +68503,39 @@ msgid "" msgstr "" # b3e558ab69284cb9a66b24d03052bb63 -#: ../src/Doc/library/mutex.rst:66 +#: library/mutex.rst:66 msgid "" "Unlock the mutex if queue is empty, otherwise execute the first element in " "the queue." msgstr "" -#: ../src/Doc/library/netdata.rst:6 +#: library/netdata.rst:6 msgid "Internet Data Handling" msgstr "" -#: ../src/Doc/library/netdata.rst:8 +#: library/netdata.rst:8 msgid "" "This chapter describes modules which support handling data formats commonly " "used on the Internet." msgstr "" -#: ../src/Doc/library/netrc.rst:3 +#: library/netrc.rst:3 msgid ":mod:`netrc` --- netrc file processing" msgstr "" # 4bef7e9f02fc4d3b99ed20be5eafe758 -#: ../src/Doc/library/netrc.rst:13 +#: library/netrc.rst:13 msgid "**Source code:** :source:`Lib/netrc.py`" msgstr "" -#: ../src/Doc/library/netrc.rst:17 +#: library/netrc.rst:17 msgid "" "The :class:`netrc` class parses and encapsulates the netrc file format used " "by the Unix :program:`ftp` program and other FTP clients." msgstr "" # 661153b4e98a4020ae7f300b394b2c0d -#: ../src/Doc/library/netrc.rst:23 +#: library/netrc.rst:23 msgid "" "A :class:`netrc` instance or subclass instance encapsulates data from a " "netrc file. The initialization argument, if present, specifies the file to " @@ -66973,7 +68550,11 @@ msgid "" "programs that use :file:`.netrc`." msgstr "" -#: ../src/Doc/library/netrc.rst:40 +#: library/netrc.rst:35 +msgid "Added the POSIX permissions check." +msgstr "" + +#: library/netrc.rst:40 msgid "" "Exception raised by the :class:`netrc` class when syntactical errors are " "encountered in source text. Instances of this exception provide three " @@ -66982,15 +68563,15 @@ msgid "" "line number on which the error was found." msgstr "" -#: ../src/Doc/library/netrc.rst:50 +#: library/netrc.rst:50 msgid "netrc Objects" msgstr "" -#: ../src/Doc/library/netrc.rst:52 +#: library/netrc.rst:52 msgid "A :class:`netrc` instance has the following methods:" msgstr "" -#: ../src/Doc/library/netrc.rst:57 +#: library/netrc.rst:57 msgid "" "Return a 3-tuple ``(login, account, password)`` of authenticators for " "*host*. If the netrc file did not contain an entry for the given host, " @@ -66998,28 +68579,28 @@ msgid "" "host nor default entry is available, return ``None``." msgstr "" -#: ../src/Doc/library/netrc.rst:65 +#: library/netrc.rst:65 msgid "" "Dump the class data as a string in the format of a netrc file. (This " "discards comments and may reorder the entries.)" msgstr "" -#: ../src/Doc/library/netrc.rst:68 +#: library/netrc.rst:68 msgid "Instances of :class:`netrc` have public instance variables:" msgstr "" -#: ../src/Doc/library/netrc.rst:73 +#: library/netrc.rst:73 msgid "" "Dictionary mapping host names to ``(login, account, password)`` tuples. The " "'default' entry, if any, is represented as a pseudo-host by that name." msgstr "" -#: ../src/Doc/library/netrc.rst:79 +#: library/netrc.rst:79 msgid "Dictionary mapping macro names to string lists." msgstr "" # 722548c3779046fb88f213883130daf9 -#: ../src/Doc/library/netrc.rst:83 +#: library/netrc.rst:83 msgid "" "Passwords are limited to a subset of the ASCII character set. Versions of " "this module prior to 2.3 were extremely limited. Starting with 2.3, all " @@ -67030,12 +68611,18 @@ msgid "" msgstr "" # a0ca1dd15cf74cf69c90477886564a45 -#: ../src/Doc/library/new.rst:2 +#: library/new.rst:2 msgid ":mod:`new` --- Creation of runtime internal objects" msgstr "" +#: library/new.rst:8 +msgid "" +"The :mod:`new` module has been removed in Python 3. Use the :mod:`types` " +"module's classes instead." +msgstr "" + # 259983e0f9b24560bbe3888d259b06fe -#: ../src/Doc/library/new.rst:15 +#: library/new.rst:15 msgid "" "The :mod:`new` module allows an interface to the interpreter object creation " "functions. This is for use primarily in marshal-type functions, when a new " @@ -67047,12 +68634,12 @@ msgid "" msgstr "" # f0d23d8078ad47c99eb5bccb313afc04 -#: ../src/Doc/library/new.rst:22 +#: library/new.rst:22 msgid "The :mod:`new` module defines the following functions:" msgstr "" # cd2c9f64058443c796c7ef3d7d98bd2a -#: ../src/Doc/library/new.rst:27 +#: library/new.rst:27 msgid "" "This function creates an instance of *class* with dictionary *dict* without " "calling the :meth:`__init__` constructor. If *dict* is omitted or ``None``, " @@ -67061,14 +68648,14 @@ msgid "" msgstr "" # ed568ae03bcc4779b8bd66970eb9fab7 -#: ../src/Doc/library/new.rst:35 +#: library/new.rst:35 msgid "" "This function will return a method object, bound to *instance*, or unbound " "if *instance* is ``None``. *function* must be callable." msgstr "" # 6480f593e3594e84b101f9f6974e1a84 -#: ../src/Doc/library/new.rst:41 +#: library/new.rst:41 msgid "" "Returns a (Python) function with the given code and globals. If *name* is " "given, it must be a string or ``None``. If it is a string, the function " @@ -67080,45 +68667,45 @@ msgid "" msgstr "" # 33ce7ad4cae84c25bf474b1269637259 -#: ../src/Doc/library/new.rst:51 +#: library/new.rst:51 msgid "This function is an interface to the :c:func:`PyCode_New` C function." msgstr "" # b28524b0b76d4bed95d22537053ba3bf -#: ../src/Doc/library/new.rst:58 +#: library/new.rst:58 msgid "" "This function returns a new module object with name *name*. *name* must be a " "string. The optional *doc* argument can have any type." msgstr "" # ab0fe5237da44f0c8c4f9d1378711f4c -#: ../src/Doc/library/new.rst:64 +#: library/new.rst:64 msgid "" "This function returns a new class object, with name *name*, derived from " "*baseclasses* (which should be a tuple of classes) and with namespace *dict*." msgstr "" -#: ../src/Doc/library/nis.rst:3 +#: library/nis.rst:3 msgid ":mod:`nis` --- Interface to Sun's NIS (Yellow Pages)" msgstr "" -#: ../src/Doc/library/nis.rst:12 +#: library/nis.rst:12 msgid "" "The :mod:`nis` module gives a thin wrapper around the NIS library, useful " "for central administration of several hosts." msgstr "" -#: ../src/Doc/library/nis.rst:15 +#: library/nis.rst:15 msgid "" "Because NIS exists only on Unix systems, this module is only available for " "Unix." msgstr "" -#: ../src/Doc/library/nis.rst:17 +#: library/nis.rst:17 msgid "The :mod:`nis` module defines the following functions:" msgstr "" -#: ../src/Doc/library/nis.rst:22 +#: library/nis.rst:22 msgid "" "Return the match for *key* in map *mapname*, or raise an error (:exc:`nis." "error`) if there is none. Both should be strings, *key* is 8-bit clean. " @@ -67126,43 +68713,49 @@ msgid "" "joys)." msgstr "" -#: ../src/Doc/library/nis.rst:27 ../src/Doc/library/nis.rst:40 +#: library/nis.rst:27 library/nis.rst:40 msgid "Note that *mapname* is first checked if it is an alias to another name." msgstr "" -#: ../src/Doc/library/nis.rst:36 +#: library/nis.rst:29 library/nis.rst:42 library/nis.rst:51 +msgid "" +"The *domain* argument allows to override the NIS domain used for the lookup. " +"If unspecified, lookup is in the default NIS domain." +msgstr "" + +#: library/nis.rst:36 msgid "" "Return a dictionary mapping *key* to *value* such that ``match(key, " "mapname)==value``. Note that both keys and values of the dictionary are " "arbitrary arrays of bytes." msgstr "" -#: ../src/Doc/library/nis.rst:49 +#: library/nis.rst:49 msgid "Return a list of all valid maps." msgstr "" -#: ../src/Doc/library/nis.rst:58 +#: library/nis.rst:58 msgid "Return the system default NIS domain." msgstr "" -#: ../src/Doc/library/nis.rst:62 +#: library/nis.rst:62 msgid "The :mod:`nis` module defines the following exception:" msgstr "" -#: ../src/Doc/library/nis.rst:67 +#: library/nis.rst:67 msgid "An error raised when a NIS function returns an error code." msgstr "" -#: ../src/Doc/library/nntplib.rst:3 +#: library/nntplib.rst:3 msgid ":mod:`nntplib` --- NNTP protocol client" msgstr "" # cd3dbac1283447c496d9c8b954a16c36 -#: ../src/Doc/library/nntplib.rst:13 +#: library/nntplib.rst:13 msgid "**Source code:** :source:`Lib/nntplib.py`" msgstr "" -#: ../src/Doc/library/nntplib.rst:17 +#: library/nntplib.rst:17 msgid "" "This module defines the class :class:`NNTP` which implements the client side " "of the NNTP protocol. It can be used to implement a news reader or poster, " @@ -67170,24 +68763,24 @@ msgid "" "Transfer Protocol), see Internet :rfc:`977`." msgstr "" -#: ../src/Doc/library/nntplib.rst:22 +#: library/nntplib.rst:22 msgid "" "Here are two small examples of how it can be used. To list some statistics " "about a newsgroup and print the subjects of the last 10 articles::" msgstr "" # 0c43d46d83184972bb59836fe8a88577 -#: ../src/Doc/library/nntplib.rst:45 +#: library/nntplib.rst:45 msgid "" "To post an article from a file (this assumes that the article has valid " "headers, and that you have right to post on the particular newsgroup)::" msgstr "" -#: ../src/Doc/library/nntplib.rst:55 +#: library/nntplib.rst:55 msgid "The module itself defines the following items:" msgstr "" -#: ../src/Doc/library/nntplib.rst:60 +#: library/nntplib.rst:60 msgid "" "Return a new instance of the :class:`NNTP` class, representing a connection " "to the NNTP server running on host *host*, listening at port *port*. The " @@ -67204,52 +68797,56 @@ msgid "" "``True``." msgstr "" -#: ../src/Doc/library/nntplib.rst:79 +#: library/nntplib.rst:73 +msgid "*usenetrc* argument added." +msgstr "" + +#: library/nntplib.rst:79 msgid "" "Derived from the standard exception :exc:`Exception`, this is the base class " "for all exceptions raised by the :mod:`nntplib` module." msgstr "" -#: ../src/Doc/library/nntplib.rst:85 +#: library/nntplib.rst:85 msgid "" "Exception raised when an unexpected reply is received from the server. For " "backwards compatibility, the exception ``error_reply`` is equivalent to this " "class." msgstr "" -#: ../src/Doc/library/nntplib.rst:92 +#: library/nntplib.rst:92 msgid "" "Exception raised when an error code in the range 400--499 is received. For " "backwards compatibility, the exception ``error_temp`` is equivalent to this " "class." msgstr "" -#: ../src/Doc/library/nntplib.rst:99 +#: library/nntplib.rst:99 msgid "" "Exception raised when an error code in the range 500--599 is received. For " "backwards compatibility, the exception ``error_perm`` is equivalent to this " "class." msgstr "" -#: ../src/Doc/library/nntplib.rst:106 +#: library/nntplib.rst:106 msgid "" "Exception raised when a reply is received from the server that does not " "begin with a digit in the range 1--5. For backwards compatibility, the " "exception ``error_proto`` is equivalent to this class." msgstr "" -#: ../src/Doc/library/nntplib.rst:113 +#: library/nntplib.rst:113 msgid "" "Exception raised when there is some error in the response data. For " "backwards compatibility, the exception ``error_data`` is equivalent to this " "class." msgstr "" -#: ../src/Doc/library/nntplib.rst:120 +#: library/nntplib.rst:120 msgid "NNTP Objects" msgstr "" -#: ../src/Doc/library/nntplib.rst:122 +#: library/nntplib.rst:122 msgid "" "NNTP instances have the following methods. The *response* that is returned " "as the first item in the return tuple of almost all methods is the server's " @@ -67257,7 +68854,7 @@ msgid "" "response indicates an error, the method raises one of the above exceptions." msgstr "" -#: ../src/Doc/library/nntplib.rst:137 +#: library/nntplib.rst:137 msgid "" "Set the instance's debugging level. This controls the amount of debugging " "output printed. The default, ``0``, produces no debugging output. A value " @@ -67267,7 +68864,7 @@ msgid "" "the connection (including message text)." msgstr "" -#: ../src/Doc/library/nntplib.rst:147 +#: library/nntplib.rst:147 msgid "" "Send a ``NEWGROUPS`` command. The *date* argument should be a string of the " "form ``'yymmdd'`` indicating the date, and *time* should be a string of the " @@ -67281,7 +68878,7 @@ msgid "" "returned *list* is an empty list." msgstr "" -#: ../src/Doc/library/nntplib.rst:160 +#: library/nntplib.rst:160 msgid "" "Send a ``NEWNEWS`` command. Here, *group* is a group name or ``'*'``, and " "*date* and *time* have the same meaning as for :meth:`newgroups`. Return a " @@ -67294,7 +68891,7 @@ msgid "" "is an empty list." msgstr "" -#: ../src/Doc/library/nntplib.rst:172 +#: library/nntplib.rst:172 msgid "" "Send a ``LIST`` command. Return a pair ``(response, list)`` where *list* is " "a list of tuples. Each tuple has the form ``(group, last, first, flag)``, " @@ -67309,7 +68906,7 @@ msgid "" "supplied, then the returned *list* is an empty list." msgstr "" -#: ../src/Doc/library/nntplib.rst:187 +#: library/nntplib.rst:187 msgid "" "Send a ``LIST NEWSGROUPS`` command, where *grouppattern* is a wildmat string " "as specified in RFC2980 (it's essentially the same as DOS or UNIX shell " @@ -67317,20 +68914,20 @@ msgid "" "list of tuples containing ``(name, title)``." msgstr "" -#: ../src/Doc/library/nntplib.rst:197 +#: library/nntplib.rst:197 msgid "" "Get a description for a single group *group*. If more than one group " "matches (if 'group' is a real wildmat string), return the first match. If " "no group matches, return an empty string." msgstr "" -#: ../src/Doc/library/nntplib.rst:201 +#: library/nntplib.rst:201 msgid "" "This elides the response code from the server. If the response code is " "needed, use :meth:`descriptions`." msgstr "" -#: ../src/Doc/library/nntplib.rst:209 +#: library/nntplib.rst:209 msgid "" "Send a ``GROUP`` command, where *name* is the group name. Return a tuple " "``(response, count, first, last, name)`` where *count* is the (estimated) " @@ -67339,7 +68936,7 @@ msgid "" "group name. The numbers are returned as strings." msgstr "" -#: ../src/Doc/library/nntplib.rst:218 +#: library/nntplib.rst:218 msgid "" "Send a ``HELP`` command. Return a pair ``(response, list)`` where *list* is " "a list of help strings. If the *file* parameter is supplied, then the output " @@ -67350,7 +68947,7 @@ msgid "" "returned *list* is an empty list." msgstr "" -#: ../src/Doc/library/nntplib.rst:229 +#: library/nntplib.rst:229 msgid "" "Send a ``STAT`` command, where *id* is the message id (enclosed in ``'<'`` " "and ``'>'``) or an article number (as a string). Return a triple " @@ -67359,17 +68956,17 @@ msgid "" msgstr "" # b59037406f4a4b0b916b7f20ccd8ed89 -#: ../src/Doc/library/nntplib.rst:237 +#: library/nntplib.rst:237 msgid "Send a ``NEXT`` command. Return as for :meth:`.stat`." msgstr "" # 7a4072d5d8eb486cbc23ec205c193855 -#: ../src/Doc/library/nntplib.rst:242 +#: library/nntplib.rst:242 msgid "Send a ``LAST`` command. Return as for :meth:`.stat`." msgstr "" # ec66c2f44dde474fa7ce6019a5f8d87d -#: ../src/Doc/library/nntplib.rst:247 +#: library/nntplib.rst:247 msgid "" "Send a ``HEAD`` command, where *id* has the same meaning as for :meth:`." "stat`. Return a tuple ``(response, number, id, list)`` where the first three " @@ -67378,7 +68975,7 @@ msgid "" msgstr "" # 9d8bc68275d94d81ab7fe958abb21c4f -#: ../src/Doc/library/nntplib.rst:255 +#: library/nntplib.rst:255 msgid "" "Send a ``BODY`` command, where *id* has the same meaning as for :meth:`." "stat`. If the *file* parameter is supplied, then the body is stored in a " @@ -67390,17 +68987,17 @@ msgid "" msgstr "" # ecfcc03a2c524ef489fc36cebf20a9a1 -#: ../src/Doc/library/nntplib.rst:265 +#: library/nntplib.rst:265 msgid "" "Send an ``ARTICLE`` command, where *id* has the same meaning as for :meth:`." "stat`. Return as for :meth:`head`." msgstr "" -#: ../src/Doc/library/nntplib.rst:271 +#: library/nntplib.rst:271 msgid "Send a ``SLAVE`` command. Return the server's *response*." msgstr "" -#: ../src/Doc/library/nntplib.rst:276 +#: library/nntplib.rst:276 msgid "" "Send an ``XHDR`` command. This command is not defined in the RFC but is a " "common extension. The *header* argument is a header keyword, e.g. " @@ -67417,7 +69014,7 @@ msgid "" msgstr "" # 9d28634c76a34a7aad021818f1b83d4d -#: ../src/Doc/library/nntplib.rst:292 +#: library/nntplib.rst:292 msgid "" "Post an article using the ``POST`` command. The *file* argument is an open " "file object which is read until EOF using its :meth:`~file.readline` " @@ -67426,14 +69023,14 @@ msgid "" "``.``." msgstr "" -#: ../src/Doc/library/nntplib.rst:300 +#: library/nntplib.rst:300 msgid "" "Send an ``IHAVE`` command. *id* is a message id (enclosed in ``'<'`` and " "``'>'``). If the response is not an error, treat *file* exactly as for the :" "meth:`post` method." msgstr "" -#: ../src/Doc/library/nntplib.rst:307 +#: library/nntplib.rst:307 msgid "" "Return a triple ``(response, date, time)``, containing the current date and " "time in a form suitable for the :meth:`newnews` and :meth:`newgroups` " @@ -67441,7 +69038,7 @@ msgid "" "servers." msgstr "" -#: ../src/Doc/library/nntplib.rst:314 +#: library/nntplib.rst:314 msgid "" "Process an ``XGTITLE`` command, returning a pair ``(response, list)``, where " "*list* is a list of tuples containing ``(name, title)``. If the *file* " @@ -67454,13 +69051,13 @@ msgid "" "servers." msgstr "" -#: ../src/Doc/library/nntplib.rst:323 +#: library/nntplib.rst:323 msgid "" "RFC2980 says \"It is suggested that this extension be deprecated\". Use :" "meth:`descriptions` or :meth:`description` instead." msgstr "" -#: ../src/Doc/library/nntplib.rst:329 +#: library/nntplib.rst:329 msgid "" "Return a pair ``(resp, list)``. *list* is a list of tuples, one for each " "article in the range delimited by the *start* and *end* article numbers. " @@ -67474,25 +69071,25 @@ msgid "" "NNTP extension, and may not be supported by all servers." msgstr "" -#: ../src/Doc/library/nntplib.rst:343 +#: library/nntplib.rst:343 msgid "" "Return a pair ``(resp, path)``, where *path* is the directory path to the " "article with message ID *id*. This is an optional NNTP extension, and may " "not be supported by all servers." msgstr "" -#: ../src/Doc/library/nntplib.rst:350 +#: library/nntplib.rst:350 msgid "" "Send a ``QUIT`` command and close the connection. Once this method has been " "called, no other methods of the NNTP object should be called." msgstr "" -#: ../src/Doc/library/numbers.rst:2 +#: library/numbers.rst:2 msgid ":mod:`numbers` --- Numeric abstract base classes" msgstr "" # 2580466e2be24e318b83d097f8f16784 -#: ../src/Doc/library/numbers.rst:10 +#: library/numbers.rst:10 msgid "" "The :mod:`numbers` module (:pep:`3141`) defines a hierarchy of numeric :term:" "`abstract base classes ` which progressively define " @@ -67500,17 +69097,17 @@ msgid "" "instantiated." msgstr "" -#: ../src/Doc/library/numbers.rst:17 +#: library/numbers.rst:17 msgid "" "The root of the numeric hierarchy. If you just want to check if an argument " "*x* is a number, without caring what kind, use ``isinstance(x, Number)``." msgstr "" -#: ../src/Doc/library/numbers.rst:22 +#: library/numbers.rst:22 msgid "The numeric tower" msgstr "" -#: ../src/Doc/library/numbers.rst:26 +#: library/numbers.rst:26 msgid "" "Subclasses of this type describe complex numbers and include the operations " "that work on the built-in :class:`complex` type. These are: conversions to :" @@ -67519,54 +69116,54 @@ msgid "" "except ``-`` and ``!=`` are abstract." msgstr "" -#: ../src/Doc/library/numbers.rst:34 +#: library/numbers.rst:34 msgid "Abstract. Retrieves the real component of this number." msgstr "" -#: ../src/Doc/library/numbers.rst:38 +#: library/numbers.rst:38 msgid "Abstract. Retrieves the imaginary component of this number." msgstr "" -#: ../src/Doc/library/numbers.rst:42 +#: library/numbers.rst:42 msgid "" "Abstract. Returns the complex conjugate. For example, ``(1+3j).conjugate() " "== (1-3j)``." msgstr "" -#: ../src/Doc/library/numbers.rst:47 +#: library/numbers.rst:47 msgid "" "To :class:`Complex`, :class:`Real` adds the operations that work on real " "numbers." msgstr "" # 64aa991671804e8fa68aedf04889aed0 -#: ../src/Doc/library/numbers.rst:50 +#: library/numbers.rst:50 msgid "" "In short, those are: a conversion to :class:`float`, :func:`math.trunc`, :" "func:`round`, :func:`math.floor`, :func:`math.ceil`, :func:`divmod`, ``//``, " "``%``, ``<``, ``<=``, ``>``, and ``>=``." msgstr "" -#: ../src/Doc/library/numbers.rst:54 +#: library/numbers.rst:54 msgid "" "Real also provides defaults for :func:`complex`, :attr:`~Complex.real`, :" "attr:`~Complex.imag`, and :meth:`~Complex.conjugate`." msgstr "" -#: ../src/Doc/library/numbers.rst:60 +#: library/numbers.rst:60 msgid "" "Subtypes :class:`Real` and adds :attr:`~Rational.numerator` and :attr:" "`~Rational.denominator` properties, which should be in lowest terms. With " "these, it provides a default for :func:`float`." msgstr "" -#: ../src/Doc/library/numbers.rst:67 ../src/Doc/library/numbers.rst:71 +#: library/numbers.rst:67 library/numbers.rst:71 #, fuzzy msgid "Abstract." msgstr "Résumé" # b6352165da084e02a423d5dbb03a3a20 -#: ../src/Doc/library/numbers.rst:76 +#: library/numbers.rst:76 msgid "" "Subtypes :class:`Rational` and adds a conversion to :class:`int`. Provides " "defaults for :func:`float`, :attr:`~Rational.numerator`, and :attr:" @@ -67574,11 +69171,11 @@ msgid "" "operations: ``<<``, ``>>``, ``&``, ``^``, ``|``, ``~``." msgstr "" -#: ../src/Doc/library/numbers.rst:83 +#: library/numbers.rst:83 msgid "Notes for type implementors" msgstr "" -#: ../src/Doc/library/numbers.rst:85 +#: library/numbers.rst:85 msgid "" "Implementors should be careful to make equal numbers equal and hash them to " "the same values. This may be subtle if there are two different extensions of " @@ -67586,22 +69183,22 @@ msgid "" "`hash` as follows::" msgstr "" -#: ../src/Doc/library/numbers.rst:104 +#: library/numbers.rst:104 msgid "Adding More Numeric ABCs" msgstr "" -#: ../src/Doc/library/numbers.rst:106 +#: library/numbers.rst:106 msgid "" "There are, of course, more possible ABCs for numbers, and this would be a " "poor hierarchy if it precluded the possibility of adding those. You can add " "``MyFoo`` between :class:`Complex` and :class:`Real` with::" msgstr "" -#: ../src/Doc/library/numbers.rst:116 +#: library/numbers.rst:116 msgid "Implementing the arithmetic operations" msgstr "" -#: ../src/Doc/library/numbers.rst:118 +#: library/numbers.rst:118 msgid "" "We want to implement the arithmetic operations so that mixed-mode operations " "either call an implementation whose author knew about the types of both " @@ -67610,7 +69207,7 @@ msgid "" "and :meth:`__radd__` should be defined as::" msgstr "" -#: ../src/Doc/library/numbers.rst:149 +#: library/numbers.rst:149 msgid "" "There are 5 different cases for a mixed-type operation on subclasses of :" "class:`Complex`. I'll refer to all of the above code that doesn't refer to " @@ -67619,11 +69216,11 @@ msgid "" "Complex``), and ``b : B <: Complex``. I'll consider ``a + b``:" msgstr "" -#: ../src/Doc/library/numbers.rst:156 +#: library/numbers.rst:156 msgid "If ``A`` defines an :meth:`__add__` which accepts ``b``, all is well." msgstr "" -#: ../src/Doc/library/numbers.rst:158 +#: library/numbers.rst:158 msgid "" "If ``A`` falls back to the boilerplate code, and it were to return a value " "from :meth:`__add__`, we'd miss the possibility that ``B`` defines a more " @@ -67632,33 +69229,33 @@ msgid "" "`__add__` at all.)" msgstr "" -#: ../src/Doc/library/numbers.rst:164 +#: library/numbers.rst:164 msgid "" "Then ``B``'s :meth:`__radd__` gets a chance. If it accepts ``a``, all is " "well." msgstr "" -#: ../src/Doc/library/numbers.rst:166 +#: library/numbers.rst:166 msgid "" "If it falls back to the boilerplate, there are no more possible methods to " "try, so this is where the default implementation should live." msgstr "" -#: ../src/Doc/library/numbers.rst:169 +#: library/numbers.rst:169 msgid "" "If ``B <: A``, Python tries ``B.__radd__`` before ``A.__add__``. This is ok, " "because it was implemented with knowledge of ``A``, so it can handle those " "instances before delegating to :class:`Complex`." msgstr "" -#: ../src/Doc/library/numbers.rst:174 +#: library/numbers.rst:174 msgid "" "If ``A <: Complex`` and ``B <: Real`` without sharing any other knowledge, " "then the appropriate shared operation is the one involving the built in :" "class:`complex`, and both :meth:`__radd__` s land there, so ``a+b == b+a``." msgstr "" -#: ../src/Doc/library/numbers.rst:179 +#: library/numbers.rst:179 msgid "" "Because most of the operations on any given type will be very similar, it " "can be useful to define a helper function which generates the forward and " @@ -67666,11 +69263,11 @@ msgid "" "Fraction` uses::" msgstr "" -#: ../src/Doc/library/numeric.rst:6 +#: library/numeric.rst:6 msgid "Numeric and Mathematical Modules" msgstr "" -#: ../src/Doc/library/numeric.rst:8 +#: library/numeric.rst:8 msgid "" "The modules described in this chapter provide numeric and math-related " "functions and data types. The :mod:`numbers` module defines an abstract " @@ -67680,12 +69277,12 @@ msgid "" "module supports exact representations of decimal numbers." msgstr "" -#: ../src/Doc/library/operator.rst:2 +#: library/operator.rst:2 msgid ":mod:`operator` --- Standard operators as functions" msgstr "" # 6946858d49a54eecbf4cf9bad4513d60 -#: ../src/Doc/library/operator.rst:15 +#: library/operator.rst:15 msgid "" "The :mod:`operator` module exports a set of efficient functions " "corresponding to the intrinsic operators of Python. For example, ``operator." @@ -67694,21 +69291,21 @@ msgid "" "``__`` are also provided for convenience." msgstr "" -#: ../src/Doc/library/operator.rst:21 +#: library/operator.rst:21 msgid "" "The functions fall into categories that perform object comparisons, logical " "operations, mathematical operations, sequence operations, and abstract type " "tests." msgstr "" -#: ../src/Doc/library/operator.rst:25 +#: library/operator.rst:25 msgid "" "The object comparison functions are useful for all objects, and are named " "after the rich comparison operators they support:" msgstr "" # da90fd5714994a4d9a2c3122990375ac -#: ../src/Doc/library/operator.rst:42 +#: library/operator.rst:42 msgid "" "Perform \"rich comparisons\" between *a* and *b*. Specifically, ``lt(a, b)`` " "is equivalent to ``a < b``, ``le(a, b)`` is equivalent to ``a <= b``, " @@ -67720,14 +69317,14 @@ msgid "" "comparisons." msgstr "" -#: ../src/Doc/library/operator.rst:52 +#: library/operator.rst:52 msgid "" "The logical operations are also generally applicable to all objects, and " "support truth tests, identity tests, and boolean operations:" msgstr "" # 6c28260c43414b4e98ac86673ae8fc62 -#: ../src/Doc/library/operator.rst:59 +#: library/operator.rst:59 msgid "" "Return the outcome of :keyword:`not` *obj*. (Note that there is no :meth:" "`__not__` method for object instances; only the interpreter core defines " @@ -67735,169 +69332,204 @@ msgid "" "`__len__` methods.)" msgstr "" -#: ../src/Doc/library/operator.rst:67 +#: library/operator.rst:67 msgid "" "Return :const:`True` if *obj* is true, and :const:`False` otherwise. This " "is equivalent to using the :class:`bool` constructor." msgstr "" -#: ../src/Doc/library/operator.rst:73 +#: library/operator.rst:73 msgid "Return ``a is b``. Tests object identity." msgstr "" -#: ../src/Doc/library/operator.rst:80 +#: library/operator.rst:80 msgid "Return ``a is not b``. Tests object identity." msgstr "" -#: ../src/Doc/library/operator.rst:84 +#: library/operator.rst:84 msgid "The mathematical and bitwise operations are the most numerous:" msgstr "" -#: ../src/Doc/library/operator.rst:90 +#: library/operator.rst:90 msgid "Return the absolute value of *obj*." msgstr "" -#: ../src/Doc/library/operator.rst:96 +#: library/operator.rst:96 msgid "Return ``a + b``, for *a* and *b* numbers." msgstr "" -#: ../src/Doc/library/operator.rst:102 +#: library/operator.rst:102 msgid "Return the bitwise and of *a* and *b*." msgstr "" # 665c3d8b59d444ad9fc40edb9d0d3f7b -#: ../src/Doc/library/operator.rst:108 +#: library/operator.rst:108 msgid "" "Return ``a / b`` when ``__future__.division`` is not in effect. This is " "also known as \"classic\" division." msgstr "" -#: ../src/Doc/library/operator.rst:115 +#: library/operator.rst:115 msgid "Return ``a // b``." msgstr "" -#: ../src/Doc/library/operator.rst:123 +#: library/operator.rst:123 msgid "Return *a* converted to an integer. Equivalent to ``a.__index__()``." msgstr "" -#: ../src/Doc/library/operator.rst:133 +#: library/operator.rst:133 msgid "" "Return the bitwise inverse of the number *obj*. This is equivalent to " "``~obj``." msgstr "" -#: ../src/Doc/library/operator.rst:142 +#: library/operator.rst:135 +#, fuzzy +msgid "The names :func:`invert` and :func:`__invert__`." +msgstr "Convertit :func:`intern` en :func:`sys.intern`." + +#: library/operator.rst:142 msgid "Return *a* shifted left by *b*." msgstr "" -#: ../src/Doc/library/operator.rst:148 +#: library/operator.rst:148 msgid "Return ``a % b``." msgstr "" -#: ../src/Doc/library/operator.rst:154 +#: library/operator.rst:154 msgid "Return ``a * b``, for *a* and *b* numbers." msgstr "" -#: ../src/Doc/library/operator.rst:160 +#: library/operator.rst:160 msgid "Return *obj* negated (``-obj``)." msgstr "" -#: ../src/Doc/library/operator.rst:166 +#: library/operator.rst:166 msgid "Return the bitwise or of *a* and *b*." msgstr "" -#: ../src/Doc/library/operator.rst:172 +#: library/operator.rst:172 msgid "Return *obj* positive (``+obj``)." msgstr "" -#: ../src/Doc/library/operator.rst:178 +#: library/operator.rst:178 msgid "Return ``a ** b``, for *a* and *b* numbers." msgstr "" -#: ../src/Doc/library/operator.rst:186 +#: library/operator.rst:186 msgid "Return *a* shifted right by *b*." msgstr "" -#: ../src/Doc/library/operator.rst:192 +#: library/operator.rst:192 msgid "Return ``a - b``." msgstr "" # d2509357b35e4c8da178ca7afbb79dd6 -#: ../src/Doc/library/operator.rst:198 +#: library/operator.rst:198 msgid "" "Return ``a / b`` when ``__future__.division`` is in effect. This is also " "known as \"true\" division." msgstr "" -#: ../src/Doc/library/operator.rst:207 +#: library/operator.rst:207 msgid "Return the bitwise exclusive or of *a* and *b*." msgstr "" -#: ../src/Doc/library/operator.rst:210 +#: library/operator.rst:210 msgid "" "Operations which work with sequences (some of them with mappings too) " "include:" msgstr "" -#: ../src/Doc/library/operator.rst:215 +#: library/operator.rst:215 msgid "Return ``a + b`` for *a* and *b* sequences." msgstr "" -#: ../src/Doc/library/operator.rst:221 +#: library/operator.rst:221 msgid "Return the outcome of the test ``b in a``. Note the reversed operands." msgstr "" -#: ../src/Doc/library/operator.rst:229 +#: library/operator.rst:223 +msgid "The name :func:`__contains__`." +msgstr "" + +#: library/operator.rst:229 msgid "Return the number of occurrences of *b* in *a*." msgstr "" -#: ../src/Doc/library/operator.rst:235 +#: library/operator.rst:235 msgid "Remove the value of *a* at index *b*." msgstr "" # d1b9f61380a847f1981257f8849de755 -#: ../src/Doc/library/operator.rst:241 +#: library/operator.rst:241 msgid "Delete the slice of *a* from index *b* to index *c-1*." msgstr "" -#: ../src/Doc/library/operator.rst:251 +#: library/operator.rst:243 +msgid "" +"This function is removed in Python 3.x. Use :func:`delitem` with a slice " +"index." +msgstr "" + +#: library/operator.rst:251 msgid "Return the value of *a* at index *b*." msgstr "" # b85deaf044dc43a9bd7b461a88ef96d6 -#: ../src/Doc/library/operator.rst:257 +#: library/operator.rst:257 msgid "Return the slice of *a* from index *b* to index *c-1*." msgstr "" -#: ../src/Doc/library/operator.rst:266 +#: library/operator.rst:259 +msgid "" +"This function is removed in Python 3.x. Use :func:`getitem` with a slice " +"index." +msgstr "" + +#: library/operator.rst:266 msgid "Return the index of the first of occurrence of *b* in *a*." msgstr "" +#: library/operator.rst:272 +msgid "Use :func:`__mul__` instead." +msgstr "" + # 1a61be6b379e4969a0907fab2dd88600 -#: ../src/Doc/library/operator.rst:275 +#: library/operator.rst:275 msgid "Return ``a * b`` where *a* is a sequence and *b* is an integer." msgstr "" +#: library/operator.rst:280 +msgid "Use :func:`contains` instead." +msgstr "" + # aadb0f59685c4352a14fdea16c7664b6 -#: ../src/Doc/library/operator.rst:283 +#: library/operator.rst:283 msgid "Alias for :func:`contains`." msgstr "" -#: ../src/Doc/library/operator.rst:289 +#: library/operator.rst:289 msgid "Set the value of *a* at index *b* to *c*." msgstr "" # 3c8853eb9202439484bf82a5de37ed02 -#: ../src/Doc/library/operator.rst:295 +#: library/operator.rst:295 msgid "Set the slice of *a* from index *b* to index *c-1* to the sequence *v*." msgstr "" +#: library/operator.rst:297 +msgid "" +"This function is removed in Python 3.x. Use :func:`setitem` with a slice " +"index." +msgstr "" + # eadf99d062674622a63b9877a554babc -#: ../src/Doc/library/operator.rst:301 +#: library/operator.rst:301 msgid "Example use of operator functions::" msgstr "" -#: ../src/Doc/library/operator.rst:311 +#: library/operator.rst:311 msgid "" "Many operations have an \"in-place\" version. The following functions " "provide a more primitive access to in-place operators than the usual syntax " @@ -67906,78 +69538,82 @@ msgid "" "iadd(x, y)`` is equivalent to the compound statement ``z = x; z += y``." msgstr "" -#: ../src/Doc/library/operator.rst:321 +#: library/operator.rst:321 msgid "``a = iadd(a, b)`` is equivalent to ``a += b``." msgstr "" -#: ../src/Doc/library/operator.rst:329 +#: library/operator.rst:329 msgid "``a = iand(a, b)`` is equivalent to ``a &= b``." msgstr "" -#: ../src/Doc/library/operator.rst:337 +#: library/operator.rst:337 msgid "" "``a = iconcat(a, b)`` is equivalent to ``a += b`` for *a* and *b* sequences." msgstr "" # 826a8a1b62c44fb2b2980508891b89c7 -#: ../src/Doc/library/operator.rst:345 +#: library/operator.rst:345 msgid "" "``a = idiv(a, b)`` is equivalent to ``a /= b`` when ``__future__.division`` " "is not in effect." msgstr "" -#: ../src/Doc/library/operator.rst:354 +#: library/operator.rst:354 msgid "``a = ifloordiv(a, b)`` is equivalent to ``a //= b``." msgstr "" -#: ../src/Doc/library/operator.rst:362 +#: library/operator.rst:362 msgid "``a = ilshift(a, b)`` is equivalent to ``a <<= b``." msgstr "" -#: ../src/Doc/library/operator.rst:370 +#: library/operator.rst:370 msgid "``a = imod(a, b)`` is equivalent to ``a %= b``." msgstr "" -#: ../src/Doc/library/operator.rst:378 +#: library/operator.rst:378 msgid "``a = imul(a, b)`` is equivalent to ``a *= b``." msgstr "" -#: ../src/Doc/library/operator.rst:386 +#: library/operator.rst:386 msgid "``a = ior(a, b)`` is equivalent to ``a |= b``." msgstr "" -#: ../src/Doc/library/operator.rst:394 +#: library/operator.rst:394 msgid "``a = ipow(a, b)`` is equivalent to ``a **= b``." msgstr "" +#: library/operator.rst:402 +msgid "Use :func:`__imul__` instead." +msgstr "" + # cf294365903d464ba95a1457bd5bde58 -#: ../src/Doc/library/operator.rst:405 +#: library/operator.rst:405 msgid "" "``a = irepeat(a, b)`` is equivalent to ``a *= b`` where *a* is a sequence " "and *b* is an integer." msgstr "" -#: ../src/Doc/library/operator.rst:414 +#: library/operator.rst:414 msgid "``a = irshift(a, b)`` is equivalent to ``a >>= b``." msgstr "" -#: ../src/Doc/library/operator.rst:422 +#: library/operator.rst:422 msgid "``a = isub(a, b)`` is equivalent to ``a -= b``." msgstr "" # 977b0e2082e34d978014626fde962e74 -#: ../src/Doc/library/operator.rst:430 +#: library/operator.rst:430 msgid "" "``a = itruediv(a, b)`` is equivalent to ``a /= b`` when ``__future__." "division`` is in effect." msgstr "" -#: ../src/Doc/library/operator.rst:439 +#: library/operator.rst:439 msgid "``a = ixor(a, b)`` is equivalent to ``a ^= b``." msgstr "" # 0cf5571cf4654c098f61f45d47929bd7 -#: ../src/Doc/library/operator.rst:444 +#: library/operator.rst:444 msgid "" "The :mod:`operator` module also defines a few predicates to test the type of " "objects; however, these are not all reliable. It is preferable to test " @@ -67985,8 +69621,12 @@ msgid "" "details)." msgstr "" +#: library/operator.rst:451 +msgid "Use ``isinstance(x, collections.Callable)`` instead." +msgstr "" + # ee8934369903487aac97f9aecc6f6cc6 -#: ../src/Doc/library/operator.rst:454 +#: library/operator.rst:454 msgid "" "Returns true if the object *obj* can be called like a function, otherwise it " "returns false. True is returned for functions, bound and unbound methods, " @@ -67994,29 +69634,41 @@ msgid "" "method." msgstr "" +#: library/operator.rst:461 +msgid "Use ``isinstance(x, collections.Mapping)`` instead." +msgstr "" + # 0fe0753243c94bbeba71a9548d9ac222 -#: ../src/Doc/library/operator.rst:464 +#: library/operator.rst:464 msgid "" "Returns true if the object *obj* supports the mapping interface. This is " "true for dictionaries and all instance objects defining :meth:`__getitem__`." msgstr "" +#: library/operator.rst:470 +msgid "Use ``isinstance(x, numbers.Number)`` instead." +msgstr "" + # ed72d92632024258a78313d9b54ab202 -#: ../src/Doc/library/operator.rst:473 +#: library/operator.rst:473 msgid "" "Returns true if the object *obj* represents a number. This is true for all " "numeric types implemented in C." msgstr "" +#: library/operator.rst:479 +msgid "Use ``isinstance(x, collections.Sequence)`` instead." +msgstr "" + # 9db669663ab849d9a2cd8ceb242796c1 -#: ../src/Doc/library/operator.rst:482 +#: library/operator.rst:482 msgid "" "Returns true if the object *obj* supports the sequence protocol. This " "returns true for all objects which define sequence methods in C, and for all " "instance objects defining :meth:`__getitem__`." msgstr "" -#: ../src/Doc/library/operator.rst:487 +#: library/operator.rst:487 msgid "" "The :mod:`operator` module also defines tools for generalized attribute and " "item lookups. These are useful for making fast field extractors as " @@ -68025,7 +69677,7 @@ msgid "" msgstr "" # fd995088563342f2a182653d4ae2679f -#: ../src/Doc/library/operator.rst:496 +#: library/operator.rst:496 msgid "" "Return a callable object that fetches *attr* from its operand. If more than " "one attribute is requested, returns a tuple of attributes. The attribute " @@ -68033,26 +69685,34 @@ msgid "" msgstr "" # 98134a3ddb494cf4b574ad14525e837b -#: ../src/Doc/library/operator.rst:500 +#: library/operator.rst:500 msgid "After ``f = attrgetter('name')``, the call ``f(b)`` returns ``b.name``." msgstr "" # 98134a3ddb494cf4b574ad14525e837b -#: ../src/Doc/library/operator.rst:502 +#: library/operator.rst:502 msgid "" "After ``f = attrgetter('name', 'date')``, the call ``f(b)`` returns ``(b." "name, b.date)``." msgstr "" # eee6967575e043e59d51034ac9454e4f -#: ../src/Doc/library/operator.rst:505 +#: library/operator.rst:505 msgid "" "After ``f = attrgetter('name.first', 'name.last')``, the call ``f(b)`` " "returns ``(b.name.first, b.name.last)``." msgstr "" +#: library/operator.rst:528 +msgid "Added support for multiple attributes." +msgstr "" + +#: library/operator.rst:531 +msgid "Added support for dotted attributes." +msgstr "" + # 7be736fcb50c42dcbe0c838128663070 -#: ../src/Doc/library/operator.rst:538 +#: library/operator.rst:538 msgid "" "Return a callable object that fetches *item* from its operand using the " "operand's :meth:`__getitem__` method. If multiple items are specified, " @@ -68060,32 +69720,36 @@ msgid "" msgstr "" # 98134a3ddb494cf4b574ad14525e837b -#: ../src/Doc/library/operator.rst:542 +#: library/operator.rst:542 msgid "After ``f = itemgetter(2)``, the call ``f(r)`` returns ``r[2]``." msgstr "" # 715320273b2d4683964c2c75545b54dc -#: ../src/Doc/library/operator.rst:544 +#: library/operator.rst:544 msgid "" "After ``g = itemgetter(2, 5, 3)``, the call ``g(r)`` returns ``(r[2], r[5], " "r[3])``." msgstr "" -#: ../src/Doc/library/operator.rst:559 +#: library/operator.rst:559 msgid "" "The items can be any type accepted by the operand's :meth:`__getitem__` " "method. Dictionaries accept any hashable value. Lists, tuples, and strings " "accept an index or a slice:" msgstr "" -#: ../src/Doc/library/operator.rst:575 +#: library/operator.rst:572 +msgid "Added support for multiple item extraction." +msgstr "" + +#: library/operator.rst:575 msgid "" "Example of using :func:`itemgetter` to retrieve specific fields from a tuple " "record:" msgstr "" # 829d4be07bba4e548938d92b9eb04039 -#: ../src/Doc/library/operator.rst:588 +#: library/operator.rst:588 msgid "" "Return a callable object that calls the method *name* on its operand. If " "additional arguments and/or keyword arguments are given, they will be given " @@ -68093,455 +69757,459 @@ msgid "" msgstr "" # 98134a3ddb494cf4b574ad14525e837b -#: ../src/Doc/library/operator.rst:592 +#: library/operator.rst:592 msgid "" "After ``f = methodcaller('name')``, the call ``f(b)`` returns ``b.name()``." msgstr "" # 98134a3ddb494cf4b574ad14525e837b -#: ../src/Doc/library/operator.rst:594 +#: library/operator.rst:594 msgid "" "After ``f = methodcaller('name', 'foo', bar=1)``, the call ``f(b)`` returns " "``b.name('foo', bar=1)``." msgstr "" -#: ../src/Doc/library/operator.rst:610 +#: library/operator.rst:610 msgid "Mapping Operators to Functions" msgstr "" -#: ../src/Doc/library/operator.rst:612 +#: library/operator.rst:612 msgid "" "This table shows how abstract operations correspond to operator symbols in " "the Python syntax and the functions in the :mod:`operator` module." msgstr "" -#: ../src/Doc/library/operator.rst:616 -#: ../src/Doc/library/xml.etree.elementtree.rst:318 +#: library/operator.rst:616 library/xml.etree.elementtree.rst:385 msgid "Syntax" msgstr "" -#: ../src/Doc/library/operator.rst:616 +#: library/operator.rst:616 msgid "Function" msgstr "" -#: ../src/Doc/library/operator.rst:618 +#: library/operator.rst:618 msgid "Addition" msgstr "" -#: ../src/Doc/library/operator.rst:618 +#: library/operator.rst:618 msgid "``a + b``" msgstr "" -#: ../src/Doc/library/operator.rst:618 +#: library/operator.rst:618 msgid "``add(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:620 +#: library/operator.rst:620 msgid "Concatenation" msgstr "" -#: ../src/Doc/library/operator.rst:620 +#: library/operator.rst:620 msgid "``seq1 + seq2``" msgstr "" -#: ../src/Doc/library/operator.rst:620 +#: library/operator.rst:620 msgid "``concat(seq1, seq2)``" msgstr "" -#: ../src/Doc/library/operator.rst:622 +#: library/operator.rst:622 msgid "Containment Test" msgstr "" -#: ../src/Doc/library/operator.rst:622 +#: library/operator.rst:622 msgid "``obj in seq``" msgstr "" -#: ../src/Doc/library/operator.rst:622 +#: library/operator.rst:622 msgid "``contains(seq, obj)``" msgstr "" -#: ../src/Doc/library/operator.rst:624 ../src/Doc/library/operator.rst:627 -#: ../src/Doc/library/operator.rst:630 +#: library/operator.rst:624 library/operator.rst:627 library/operator.rst:630 msgid "Division" msgstr "" -#: ../src/Doc/library/operator.rst:624 ../src/Doc/library/operator.rst:627 +#: library/operator.rst:624 library/operator.rst:627 msgid "``a / b``" msgstr "" # 9a3ab8f0d16c4b089c83e26d9f50de7a -#: ../src/Doc/library/operator.rst:624 +#: library/operator.rst:624 msgid "``div(a, b)`` (without ``__future__.division``)" msgstr "" # fdeb47702aee4716a2a262155ebe6e08 -#: ../src/Doc/library/operator.rst:627 +#: library/operator.rst:627 msgid "``truediv(a, b)`` (with ``__future__.division``)" msgstr "" -#: ../src/Doc/library/operator.rst:630 +#: library/operator.rst:630 msgid "``a // b``" msgstr "" -#: ../src/Doc/library/operator.rst:630 +#: library/operator.rst:630 msgid "``floordiv(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:632 +#: library/operator.rst:632 msgid "Bitwise And" msgstr "" -#: ../src/Doc/library/operator.rst:632 +#: library/operator.rst:632 msgid "``a & b``" msgstr "" -#: ../src/Doc/library/operator.rst:632 +#: library/operator.rst:632 msgid "``and_(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:634 +#: library/operator.rst:634 msgid "Bitwise Exclusive Or" msgstr "" -#: ../src/Doc/library/operator.rst:634 +#: library/operator.rst:634 msgid "``a ^ b``" msgstr "" -#: ../src/Doc/library/operator.rst:634 +#: library/operator.rst:634 msgid "``xor(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:636 +#: library/operator.rst:636 msgid "Bitwise Inversion" msgstr "" -#: ../src/Doc/library/operator.rst:636 +#: library/operator.rst:636 msgid "``~ a``" msgstr "" -#: ../src/Doc/library/operator.rst:636 +#: library/operator.rst:636 msgid "``invert(a)``" msgstr "" -#: ../src/Doc/library/operator.rst:638 +#: library/operator.rst:638 msgid "Bitwise Or" msgstr "" -#: ../src/Doc/library/operator.rst:638 +#: library/operator.rst:638 msgid "``a | b``" msgstr "" -#: ../src/Doc/library/operator.rst:638 +#: library/operator.rst:638 msgid "``or_(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:640 +#: library/operator.rst:640 msgid "Exponentiation" msgstr "" -#: ../src/Doc/library/operator.rst:640 +#: library/operator.rst:640 msgid "``a ** b``" msgstr "" -#: ../src/Doc/library/operator.rst:640 +#: library/operator.rst:640 msgid "``pow(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:642 ../src/Doc/library/operator.rst:644 +#: library/operator.rst:642 library/operator.rst:644 msgid "Identity" msgstr "" -#: ../src/Doc/library/operator.rst:642 ../src/Doc/library/unittest.rst:813 +#: library/operator.rst:642 library/unittest.rst:804 msgid "``a is b``" msgstr "" -#: ../src/Doc/library/operator.rst:642 +#: library/operator.rst:642 msgid "``is_(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:644 ../src/Doc/library/unittest.rst:816 +#: library/operator.rst:644 library/unittest.rst:807 msgid "``a is not b``" msgstr "" -#: ../src/Doc/library/operator.rst:644 +#: library/operator.rst:644 msgid "``is_not(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:646 +#: library/operator.rst:646 msgid "Indexed Assignment" msgstr "" -#: ../src/Doc/library/operator.rst:646 +#: library/operator.rst:646 msgid "``obj[k] = v``" msgstr "" -#: ../src/Doc/library/operator.rst:646 +#: library/operator.rst:646 msgid "``setitem(obj, k, v)``" msgstr "" -#: ../src/Doc/library/operator.rst:648 +#: library/operator.rst:648 msgid "Indexed Deletion" msgstr "" -#: ../src/Doc/library/operator.rst:648 +#: library/operator.rst:648 msgid "``del obj[k]``" msgstr "" -#: ../src/Doc/library/operator.rst:648 +#: library/operator.rst:648 msgid "``delitem(obj, k)``" msgstr "" -#: ../src/Doc/library/operator.rst:650 +#: library/operator.rst:650 msgid "Indexing" msgstr "" -#: ../src/Doc/library/operator.rst:650 +#: library/operator.rst:650 msgid "``obj[k]``" msgstr "" -#: ../src/Doc/library/operator.rst:650 +#: library/operator.rst:650 msgid "``getitem(obj, k)``" msgstr "" -#: ../src/Doc/library/operator.rst:652 +#: library/operator.rst:652 msgid "Left Shift" msgstr "" -#: ../src/Doc/library/operator.rst:652 +#: library/operator.rst:652 msgid "``a << b``" msgstr "" -#: ../src/Doc/library/operator.rst:652 +#: library/operator.rst:652 msgid "``lshift(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:654 +#: library/operator.rst:654 msgid "Modulo" msgstr "" -#: ../src/Doc/library/operator.rst:654 +#: library/operator.rst:654 msgid "``a % b``" msgstr "" -#: ../src/Doc/library/operator.rst:654 +#: library/operator.rst:654 msgid "``mod(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:656 +#: library/operator.rst:656 msgid "Multiplication" msgstr "" -#: ../src/Doc/library/operator.rst:656 +#: library/operator.rst:656 msgid "``a * b``" msgstr "" -#: ../src/Doc/library/operator.rst:656 +#: library/operator.rst:656 msgid "``mul(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:658 +#: library/operator.rst:658 msgid "Negation (Arithmetic)" msgstr "" -#: ../src/Doc/library/operator.rst:658 +#: library/operator.rst:658 msgid "``- a``" msgstr "" -#: ../src/Doc/library/operator.rst:658 +#: library/operator.rst:658 msgid "``neg(a)``" msgstr "" -#: ../src/Doc/library/operator.rst:660 +#: library/operator.rst:660 msgid "Negation (Logical)" msgstr "" -#: ../src/Doc/library/operator.rst:660 +#: library/operator.rst:660 msgid "``not a``" msgstr "" -#: ../src/Doc/library/operator.rst:660 +#: library/operator.rst:660 msgid "``not_(a)``" msgstr "" -#: ../src/Doc/library/operator.rst:662 +#: library/operator.rst:662 msgid "Positive" msgstr "" -#: ../src/Doc/library/operator.rst:662 +#: library/operator.rst:662 msgid "``+ a``" msgstr "" -#: ../src/Doc/library/operator.rst:662 +#: library/operator.rst:662 msgid "``pos(a)``" msgstr "" -#: ../src/Doc/library/operator.rst:664 +#: library/operator.rst:664 msgid "Right Shift" msgstr "" -#: ../src/Doc/library/operator.rst:664 +#: library/operator.rst:664 msgid "``a >> b``" msgstr "" -#: ../src/Doc/library/operator.rst:664 +#: library/operator.rst:664 msgid "``rshift(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:666 +#: library/operator.rst:666 msgid "Sequence Repetition" msgstr "" -#: ../src/Doc/library/operator.rst:666 +#: library/operator.rst:666 msgid "``seq * i``" msgstr "" -#: ../src/Doc/library/operator.rst:666 +#: library/operator.rst:666 msgid "``repeat(seq, i)``" msgstr "" -#: ../src/Doc/library/operator.rst:668 +#: library/operator.rst:668 msgid "Slice Assignment" msgstr "" -#: ../src/Doc/library/operator.rst:668 +#: library/operator.rst:668 msgid "``seq[i:j] = values``" msgstr "" -#: ../src/Doc/library/operator.rst:668 +#: library/operator.rst:668 msgid "``setitem(seq, slice(i, j), values)``" msgstr "" -#: ../src/Doc/library/operator.rst:670 +#: library/operator.rst:670 msgid "Slice Deletion" msgstr "" -#: ../src/Doc/library/operator.rst:670 +#: library/operator.rst:670 msgid "``del seq[i:j]``" msgstr "" -#: ../src/Doc/library/operator.rst:670 +#: library/operator.rst:670 msgid "``delitem(seq, slice(i, j))``" msgstr "" -#: ../src/Doc/library/operator.rst:672 +#: library/operator.rst:672 msgid "Slicing" msgstr "" -#: ../src/Doc/library/operator.rst:672 +#: library/operator.rst:672 msgid "``seq[i:j]``" msgstr "" -#: ../src/Doc/library/operator.rst:672 +#: library/operator.rst:672 msgid "``getitem(seq, slice(i, j))``" msgstr "" -#: ../src/Doc/library/operator.rst:674 ../src/Doc/library/string.rst:109 +#: library/operator.rst:674 library/string.rst:109 msgid "String Formatting" msgstr "" -#: ../src/Doc/library/operator.rst:674 +#: library/operator.rst:674 msgid "``s % obj``" msgstr "" -#: ../src/Doc/library/operator.rst:674 +#: library/operator.rst:674 msgid "``mod(s, obj)``" msgstr "" -#: ../src/Doc/library/operator.rst:676 +#: library/operator.rst:676 msgid "Subtraction" msgstr "" -#: ../src/Doc/library/operator.rst:676 +#: library/operator.rst:676 msgid "``a - b``" msgstr "" -#: ../src/Doc/library/operator.rst:676 +#: library/operator.rst:676 msgid "``sub(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:678 +#: library/operator.rst:678 msgid "Truth Test" msgstr "" -#: ../src/Doc/library/operator.rst:678 +#: library/operator.rst:678 msgid "``obj``" msgstr "" -#: ../src/Doc/library/operator.rst:678 +#: library/operator.rst:678 msgid "``truth(obj)``" msgstr "" -#: ../src/Doc/library/operator.rst:680 ../src/Doc/library/operator.rst:682 -#: ../src/Doc/library/operator.rst:688 ../src/Doc/library/operator.rst:690 +#: library/operator.rst:680 library/operator.rst:682 library/operator.rst:688 +#: library/operator.rst:690 msgid "Ordering" msgstr "" -#: ../src/Doc/library/operator.rst:680 ../src/Doc/library/unittest.rst:990 +#: library/operator.rst:680 library/unittest.rst:981 msgid "``a < b``" msgstr "" -#: ../src/Doc/library/operator.rst:680 +#: library/operator.rst:680 msgid "``lt(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:682 ../src/Doc/library/unittest.rst:993 +#: library/operator.rst:682 library/unittest.rst:984 msgid "``a <= b``" msgstr "" -#: ../src/Doc/library/operator.rst:682 +#: library/operator.rst:682 msgid "``le(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:684 +#: library/operator.rst:684 msgid "Equality" msgstr "" -#: ../src/Doc/library/operator.rst:684 ../src/Doc/library/unittest.rst:801 +#: library/operator.rst:684 library/unittest.rst:792 msgid "``a == b``" msgstr "" -#: ../src/Doc/library/operator.rst:684 +#: library/operator.rst:684 msgid "``eq(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:686 +#: library/operator.rst:686 msgid "Difference" msgstr "" -#: ../src/Doc/library/operator.rst:686 ../src/Doc/library/unittest.rst:804 +#: library/operator.rst:686 library/unittest.rst:795 msgid "``a != b``" msgstr "" -#: ../src/Doc/library/operator.rst:686 +#: library/operator.rst:686 msgid "``ne(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:688 ../src/Doc/library/unittest.rst:987 +#: library/operator.rst:688 library/unittest.rst:978 msgid "``a >= b``" msgstr "" -#: ../src/Doc/library/operator.rst:688 +#: library/operator.rst:688 msgid "``ge(a, b)``" msgstr "" -#: ../src/Doc/library/operator.rst:690 ../src/Doc/library/unittest.rst:984 +#: library/operator.rst:690 library/unittest.rst:975 msgid "``a > b``" msgstr "" -#: ../src/Doc/library/operator.rst:690 +#: library/operator.rst:690 msgid "``gt(a, b)``" msgstr "" -#: ../src/Doc/library/optparse.rst:2 +#: library/optparse.rst:2 msgid ":mod:`optparse` --- Parser for command line options" msgstr "" +#: library/optparse.rst:12 +msgid "" +"The :mod:`optparse` module is deprecated and will not be developed further; " +"development will continue with the :mod:`argparse` module." +msgstr "" + # db3c2fdb76cf42fabd8394adae3ff7a6 -#: ../src/Doc/library/optparse.rst:16 +#: library/optparse.rst:16 msgid "**Source code:** :source:`Lib/optparse.py`" msgstr "" -#: ../src/Doc/library/optparse.rst:20 +#: library/optparse.rst:20 msgid "" ":mod:`optparse` is a more convenient, flexible, and powerful library for " "parsing command-line options than the old :mod:`getopt` module. :mod:" @@ -68552,17 +70220,17 @@ msgid "" "messages for you." msgstr "" -#: ../src/Doc/library/optparse.rst:27 +#: library/optparse.rst:27 msgid "Here's an example of using :mod:`optparse` in a simple script::" msgstr "" -#: ../src/Doc/library/optparse.rst:40 +#: library/optparse.rst:40 msgid "" "With these few lines of code, users of your script can now do the \"usual " "thing\" on the command-line, for example::" msgstr "" -#: ../src/Doc/library/optparse.rst:45 +#: library/optparse.rst:45 msgid "" "As it parses the command line, :mod:`optparse` sets attributes of the " "``options`` object returned by :meth:`parse_args` based on user-supplied " @@ -68574,26 +70242,26 @@ msgid "" "following command lines are all equivalent to the above example::" msgstr "" -#: ../src/Doc/library/optparse.rst:59 +#: library/optparse.rst:59 msgid "Additionally, users can run one of ::" msgstr "" -#: ../src/Doc/library/optparse.rst:64 +#: library/optparse.rst:64 msgid "" "and :mod:`optparse` will print out a brief summary of your script's options:" msgstr "" -#: ../src/Doc/library/optparse.rst:75 +#: library/optparse.rst:75 msgid "" "where the value of *yourscript* is determined at runtime (normally from " "``sys.argv[0]``)." msgstr "" -#: ../src/Doc/library/optparse.rst:82 +#: library/optparse.rst:82 msgid "Background" msgstr "" -#: ../src/Doc/library/optparse.rst:84 +#: library/optparse.rst:84 msgid "" ":mod:`optparse` was explicitly designed to encourage the creation of " "programs with straightforward, conventional command-line interfaces. To " @@ -68602,16 +70270,16 @@ msgid "" "conventions, read this section to acquaint yourself with them." msgstr "" -#: ../src/Doc/library/optparse.rst:94 +#: library/optparse.rst:94 msgid "Terminology" msgstr "" # 2b9bf41d44ab4a42b42f40c3ab0614dd -#: ../src/Doc/library/optparse.rst:104 +#: library/optparse.rst:105 msgid "argument" msgstr "argument" -#: ../src/Doc/library/optparse.rst:97 +#: library/optparse.rst:97 msgid "" "a string entered on the command-line, and passed by the shell to ``execl()`` " "or ``execv()``. In Python, arguments are elements of ``sys.argv[1:]`` " @@ -68619,7 +70287,7 @@ msgid "" "also use the term \"word\"." msgstr "" -#: ../src/Doc/library/optparse.rst:102 +#: library/optparse.rst:102 msgid "" "It is occasionally desirable to substitute an argument list other than ``sys." "argv[1:]``, so you should read \"argument\" as \"an element of ``sys." @@ -68627,17 +70295,16 @@ msgid "" "argv[1:]``\"." msgstr "" -#: ../src/Doc/library/optparse.rst:134 ../src/Doc/library/ttk.rst:139 -#: ../src/Doc/library/ttk.rst:167 ../src/Doc/library/ttk.rst:208 -#: ../src/Doc/library/ttk.rst:307 ../src/Doc/library/ttk.rst:387 -#: ../src/Doc/library/ttk.rst:411 ../src/Doc/library/ttk.rst:573 -#: ../src/Doc/library/ttk.rst:642 ../src/Doc/library/ttk.rst:711 -#: ../src/Doc/library/ttk.rst:760 ../src/Doc/library/ttk.rst:786 +#: library/optparse.rst:135 library/optparse.rst:1619 library/ttk.rst:139 +#: library/ttk.rst:167 library/ttk.rst:208 library/ttk.rst:307 +#: library/ttk.rst:387 library/ttk.rst:411 library/ttk.rst:573 +#: library/ttk.rst:642 library/ttk.rst:711 library/ttk.rst:760 +#: library/ttk.rst:786 msgid "option" msgstr "" # e04e5cb26d814ce7baa8be603f0fec09 -#: ../src/Doc/library/optparse.rst:108 +#: library/optparse.rst:108 msgid "" "an argument used to supply extra information to guide or customize the " "execution of a program. There are many different syntaxes for options; the " @@ -68649,19 +70316,19 @@ msgid "" "option syntaxes provided by :mod:`optparse`." msgstr "" -#: ../src/Doc/library/optparse.rst:117 +#: library/optparse.rst:117 msgid "Some other option syntaxes that the world has seen include:" msgstr "" # f364f1bb83514883bb59b4d6ab6b2487 -#: ../src/Doc/library/optparse.rst:119 +#: library/optparse.rst:119 msgid "" "a hyphen followed by a few letters, e.g. ``-pf`` (this is *not* the same as " "multiple options merged into a single argument)" msgstr "" # f9fc48a3b08f42b9bba3baa4ff253608 -#: ../src/Doc/library/optparse.rst:122 +#: library/optparse.rst:122 msgid "" "a hyphen followed by a whole word, e.g. ``-file`` (this is technically " "equivalent to the previous syntax, but they aren't usually seen in the same " @@ -68669,20 +70336,20 @@ msgid "" msgstr "" # 598c89b22dd845a1bdaac9f0efe900eb -#: ../src/Doc/library/optparse.rst:126 +#: library/optparse.rst:126 msgid "" "a plus sign followed by a single letter, or a few letters, or a word, e.g. ``" "+f``, ``+rgb``" msgstr "" # 485c460663a841de980881262020942b -#: ../src/Doc/library/optparse.rst:129 +#: library/optparse.rst:129 msgid "" "a slash followed by a letter, or a few letters, or a word, e.g. ``/f``, ``/" "file``" msgstr "" -#: ../src/Doc/library/optparse.rst:132 +#: library/optparse.rst:132 msgid "" "These option syntaxes are not supported by :mod:`optparse`, and they never " "will be. This is deliberate: the first three are non-standard on any " @@ -68691,11 +70358,11 @@ msgid "" msgstr "" # 3eddd47f8c1141cea38938b7bedbd958 -#: ../src/Doc/library/optparse.rst:160 +#: library/optparse.rst:161 msgid "option argument" msgstr "" -#: ../src/Doc/library/optparse.rst:138 +#: library/optparse.rst:138 msgid "" "an argument that follows an option, is closely associated with that option, " "and is consumed from the argument list when that option is. With :mod:" @@ -68703,12 +70370,12 @@ msgid "" "option:" msgstr "" -#: ../src/Doc/library/optparse.rst:148 +#: library/optparse.rst:148 msgid "or included in the same argument:" msgstr "" # 22427f53fe2349168a46b32d3ce2d74a -#: ../src/Doc/library/optparse.rst:155 +#: library/optparse.rst:155 msgid "" "Typically, a given option either takes an argument or it doesn't. Lots of " "people want an \"optional option arguments\" feature, meaning that some " @@ -68720,11 +70387,11 @@ msgid "" msgstr "" # 30e5ab4a94f04c30a0d3a5d94e2de6ef -#: ../src/Doc/library/optparse.rst:165 +#: library/optparse.rst:166 msgid "positional argument" msgstr "augment positionnel" -#: ../src/Doc/library/optparse.rst:164 +#: library/optparse.rst:164 msgid "" "something leftover in the argument list after options have been parsed, i.e. " "after options and their arguments have been parsed and removed from the " @@ -68732,11 +70399,11 @@ msgid "" msgstr "" # 8b52c9eeedf24c58890458b7453d3a74 -#: ../src/Doc/library/optparse.rst:171 +#: library/optparse.rst:172 msgid "required option" msgstr "" -#: ../src/Doc/library/optparse.rst:169 +#: library/optparse.rst:169 msgid "" "an option that must be supplied on the command-line; note that the phrase " "\"required option\" is self-contradictory in English. :mod:`optparse` " @@ -68744,23 +70411,23 @@ msgid "" "much help at it either." msgstr "" -#: ../src/Doc/library/optparse.rst:174 +#: library/optparse.rst:174 msgid "For example, consider this hypothetical command-line::" msgstr "" # c4cc521ebe9648539f923ad791ead553 -#: ../src/Doc/library/optparse.rst:178 +#: library/optparse.rst:178 msgid "" "``-v`` and ``--report`` are both options. Assuming that ``--report`` takes " "one argument, ``report.txt`` is an option argument. ``foo`` and ``bar`` are " "positional arguments." msgstr "" -#: ../src/Doc/library/optparse.rst:186 +#: library/optparse.rst:186 msgid "What are options for?" msgstr "" -#: ../src/Doc/library/optparse.rst:188 +#: library/optparse.rst:188 msgid "" "Options are used to provide extra information to tune or customize the " "execution of a program. In case it wasn't clear, options are usually " @@ -68772,7 +70439,7 @@ msgid "" "interfaces.)" msgstr "" -#: ../src/Doc/library/optparse.rst:196 +#: library/optparse.rst:196 msgid "" "Lots of people want their programs to have \"required options\". Think " "about it. If it's required, then it's *not optional*! If there is a piece " @@ -68780,7 +70447,7 @@ msgid "" "successfully, that's what positional arguments are for." msgstr "" -#: ../src/Doc/library/optparse.rst:201 +#: library/optparse.rst:201 msgid "" "As an example of good command-line interface design, consider the humble " "``cp`` utility, for copying files. It doesn't make much sense to try to " @@ -68789,7 +70456,7 @@ msgid "" "useful syntax that does not require any options at all::" msgstr "" -#: ../src/Doc/library/optparse.rst:210 +#: library/optparse.rst:210 msgid "" "You can get pretty far with just that. Most ``cp`` implementations provide " "a bunch of options to tweak exactly how the files are copied: you can " @@ -68799,17 +70466,17 @@ msgid "" "files to another directory." msgstr "" -#: ../src/Doc/library/optparse.rst:221 +#: library/optparse.rst:221 msgid "What are positional arguments for?" msgstr "" -#: ../src/Doc/library/optparse.rst:223 +#: library/optparse.rst:223 msgid "" "Positional arguments are for those pieces of information that your program " "absolutely, positively requires to run." msgstr "" -#: ../src/Doc/library/optparse.rst:226 +#: library/optparse.rst:226 msgid "" "A good user interface should have as few absolute requirements as possible. " "If your program requires 17 distinct pieces of information in order to run " @@ -68820,7 +70487,7 @@ msgid "" "most of them will simply give up." msgstr "" -#: ../src/Doc/library/optparse.rst:234 +#: library/optparse.rst:234 msgid "" "In short, try to minimize the amount of information that users are " "absolutely required to supply---use sensible defaults whenever possible. Of " @@ -68833,43 +70500,38 @@ msgid "" "make your code much harder to maintain." msgstr "" -#: ../src/Doc/library/optparse.rst:247 -#: ../src/Doc/library/xml.etree.elementtree.rst:58 -msgid "Tutorial" -msgstr "Tutoriel [fr]" - -#: ../src/Doc/library/optparse.rst:249 +#: library/optparse.rst:249 msgid "" "While :mod:`optparse` is quite flexible and powerful, it's also " "straightforward to use in most cases. This section covers the code patterns " "that are common to any :mod:`optparse`\\ -based program." msgstr "" -#: ../src/Doc/library/optparse.rst:253 +#: library/optparse.rst:253 msgid "" "First, you need to import the OptionParser class; then, early in the main " "program, create an OptionParser instance::" msgstr "" -#: ../src/Doc/library/optparse.rst:260 +#: library/optparse.rst:260 msgid "Then you can start defining options. The basic syntax is::" msgstr "" # 8dffbec7df7e47f58c2ecf00e936170b -#: ../src/Doc/library/optparse.rst:265 +#: library/optparse.rst:265 msgid "" "Each option has one or more option strings, such as ``-f`` or ``--file``, " "and several option attributes that tell :mod:`optparse` what to expect and " "what to do when it encounters that option on the command line." msgstr "" -#: ../src/Doc/library/optparse.rst:269 +#: library/optparse.rst:269 msgid "" "Typically, each option will have one short option string and one long option " "string, e.g.::" msgstr "" -#: ../src/Doc/library/optparse.rst:274 +#: library/optparse.rst:274 msgid "" "You're free to define as many short option strings and as many long option " "strings as you like (including zero), as long as there is at least one " @@ -68877,7 +70539,7 @@ msgid "" msgstr "" # fec71caf355f444c8c0a1392d1a2b732 -#: ../src/Doc/library/optparse.rst:278 +#: library/optparse.rst:278 msgid "" "The option strings passed to :meth:`OptionParser.add_option` are effectively " "labels for the option defined by that call. For brevity, we will frequently " @@ -68885,24 +70547,24 @@ msgid "" "`optparse` encounters *option strings* and looks up options from them." msgstr "" -#: ../src/Doc/library/optparse.rst:284 +#: library/optparse.rst:284 msgid "" "Once all of your options are defined, instruct :mod:`optparse` to parse your " "program's command line::" msgstr "" -#: ../src/Doc/library/optparse.rst:289 +#: library/optparse.rst:289 msgid "" "(If you like, you can pass a custom argument list to :meth:`parse_args`, but " "that's rarely necessary: by default it uses ``sys.argv[1:]``.)" msgstr "" -#: ../src/Doc/library/optparse.rst:292 +#: library/optparse.rst:292 msgid ":meth:`parse_args` returns two values:" msgstr "" # a15b7bdc0a324b80a60c832e491fc313 -#: ../src/Doc/library/optparse.rst:294 +#: library/optparse.rst:294 msgid "" "``options``, an object containing values for all of your options---e.g. if " "``--file`` takes a single string argument, then ``options.file`` will be the " @@ -68910,12 +70572,12 @@ msgid "" "option" msgstr "" -#: ../src/Doc/library/optparse.rst:299 +#: library/optparse.rst:299 msgid "" "``args``, the list of positional arguments leftover after parsing options" msgstr "" -#: ../src/Doc/library/optparse.rst:301 +#: library/optparse.rst:301 msgid "" "This tutorial section only covers the four most important option " "attributes: :attr:`~Option.action`, :attr:`~Option.type`, :attr:`~Option." @@ -68923,11 +70585,11 @@ msgid "" "action` is the most fundamental." msgstr "" -#: ../src/Doc/library/optparse.rst:310 +#: library/optparse.rst:310 msgid "Understanding option actions" msgstr "" -#: ../src/Doc/library/optparse.rst:312 +#: library/optparse.rst:312 msgid "" "Actions tell :mod:`optparse` what to do when it encounters an option on the " "command line. There is a fixed set of actions hard-coded into :mod:" @@ -68937,49 +70599,49 @@ msgid "" "and store it in an attribute of ``options``." msgstr "" -#: ../src/Doc/library/optparse.rst:319 +#: library/optparse.rst:319 msgid "" "If you don't specify an option action, :mod:`optparse` defaults to ``store``." msgstr "" -#: ../src/Doc/library/optparse.rst:325 +#: library/optparse.rst:325 msgid "The store action" msgstr "" -#: ../src/Doc/library/optparse.rst:327 +#: library/optparse.rst:327 msgid "" "The most common option action is ``store``, which tells :mod:`optparse` to " "take the next argument (or the remainder of the current argument), ensure " "that it is of the correct type, and store it to your chosen destination." msgstr "" -#: ../src/Doc/library/optparse.rst:336 +#: library/optparse.rst:336 msgid "" "Now let's make up a fake command line and ask :mod:`optparse` to parse it::" msgstr "" # aca977c1276c4f4b9f1a0a39a49b6687 -#: ../src/Doc/library/optparse.rst:341 +#: library/optparse.rst:341 msgid "" "When :mod:`optparse` sees the option string ``-f``, it consumes the next " "argument, ``foo.txt``, and stores it in ``options.filename``. So, after " "this call to :meth:`parse_args`, ``options.filename`` is ``\"foo.txt\"``." msgstr "" -#: ../src/Doc/library/optparse.rst:345 +#: library/optparse.rst:345 msgid "" "Some other option types supported by :mod:`optparse` are ``int`` and " "``float``. Here's an option that expects an integer argument::" msgstr "" -#: ../src/Doc/library/optparse.rst:350 +#: library/optparse.rst:350 msgid "" "Note that this option has no long option string, which is perfectly " "acceptable. Also, there's no explicit action, since the default is ``store``." msgstr "" # 59d9b09d9fa14d5ba374d3aac5029b24 -#: ../src/Doc/library/optparse.rst:353 +#: library/optparse.rst:353 msgid "" "Let's parse another fake command-line. This time, we'll jam the option " "argument right up against the option: since ``-n42`` (one argument) is " @@ -68987,12 +70649,12 @@ msgid "" msgstr "" # e3a884bec4384c2282000e5bbe682be8 -#: ../src/Doc/library/optparse.rst:360 +#: library/optparse.rst:360 #, fuzzy msgid "will print ``42``." msgstr "imprimera ``5``." -#: ../src/Doc/library/optparse.rst:362 +#: library/optparse.rst:362 msgid "" "If you don't specify a type, :mod:`optparse` assumes ``string``. Combined " "with the fact that the default action is ``store``, that means our first " @@ -69000,7 +70662,7 @@ msgid "" msgstr "" # c49064bcd895440381653b28ed103fc2 -#: ../src/Doc/library/optparse.rst:368 +#: library/optparse.rst:368 msgid "" "If you don't supply a destination, :mod:`optparse` figures out a sensible " "default from the option strings: if the first long option string is ``--foo-" @@ -69010,18 +70672,18 @@ msgid "" msgstr "" # 8a11ca471ba3402eb11d8a284b0c5ee9 -#: ../src/Doc/library/optparse.rst:374 +#: library/optparse.rst:374 msgid "" ":mod:`optparse` also includes built-in ``long`` and ``complex`` types. " "Adding types is covered in section :ref:`optparse-extending-optparse`." msgstr "" -#: ../src/Doc/library/optparse.rst:381 +#: library/optparse.rst:381 msgid "Handling boolean (flag) options" msgstr "" # 54f896129dd244a690d0a6601185ac0d -#: ../src/Doc/library/optparse.rst:383 +#: library/optparse.rst:383 msgid "" "Flag options---set a variable to true or false when a particular option is " "seen ---are quite common. :mod:`optparse` supports them with two separate " @@ -69029,7 +70691,7 @@ msgid "" "``verbose`` flag that is turned on with ``-v`` and off with ``-q``::" msgstr "" -#: ../src/Doc/library/optparse.rst:391 +#: library/optparse.rst:391 msgid "" "Here we have two different options with the same destination, which is " "perfectly OK. (It just means you have to be a bit careful when setting " @@ -69037,73 +70699,65 @@ msgid "" msgstr "" # c21807e7e31a44ff87a50322642a29dc -#: ../src/Doc/library/optparse.rst:395 +#: library/optparse.rst:395 msgid "" "When :mod:`optparse` encounters ``-v`` on the command line, it sets " "``options.verbose`` to ``True``; when it encounters ``-q``, ``options." "verbose`` is set to ``False``." msgstr "" -#: ../src/Doc/library/optparse.rst:403 +#: library/optparse.rst:403 msgid "Other actions" msgstr "" -#: ../src/Doc/library/optparse.rst:405 +#: library/optparse.rst:405 msgid "Some other actions supported by :mod:`optparse` are:" msgstr "" -# d4245e0569714896a8915b901e33b5c9 -# 36f30a0c72074719b8524d0b2bd563b5 -#: ../src/Doc/library/optparse.rst:407 ../src/Doc/library/optparse.rst:923 -msgid "``\"store_const\"``" +#: library/optparse.rst:408 library/optparse.rst:924 +msgid "\"store_const\"" msgstr "" -#: ../src/Doc/library/optparse.rst:408 ../src/Doc/library/optparse.rst:924 +#: library/optparse.rst:408 library/optparse.rst:924 msgid "store a constant value" msgstr "" -# 8fa68ac7d6fb4045882d370a94d23d2f -# 095d18e4b1da4d73ba19cb42b249b74e -#: ../src/Doc/library/optparse.rst:410 ../src/Doc/library/optparse.rst:932 -msgid "``\"append\"``" +#: library/optparse.rst:411 library/optparse.rst:933 +msgid "\"append\"" msgstr "" -#: ../src/Doc/library/optparse.rst:411 ../src/Doc/library/optparse.rst:933 +#: library/optparse.rst:411 library/optparse.rst:933 msgid "append this option's argument to a list" msgstr "" -# 8275a2b01db64128aca2ff99fdb0d083 -# 2167776b50e14daf8e3d66f2ac8c00f2 -#: ../src/Doc/library/optparse.rst:413 ../src/Doc/library/optparse.rst:938 -msgid "``\"count\"``" +#: library/optparse.rst:414 library/optparse.rst:939 +msgid "\"count\"" msgstr "" -#: ../src/Doc/library/optparse.rst:414 ../src/Doc/library/optparse.rst:939 +#: library/optparse.rst:414 library/optparse.rst:939 msgid "increment a counter by one" msgstr "" -# 1731c2f2f28b4afe8c66612e07301ef1 -# f6cc14a2b1a741b9bcc8cbb4d5d3065b -#: ../src/Doc/library/optparse.rst:416 ../src/Doc/library/optparse.rst:941 -msgid "``\"callback\"``" +#: library/optparse.rst:417 library/optparse.rst:942 +msgid "\"callback\"" msgstr "" -#: ../src/Doc/library/optparse.rst:417 ../src/Doc/library/optparse.rst:942 +#: library/optparse.rst:417 library/optparse.rst:942 msgid "call a specified function" msgstr "" -#: ../src/Doc/library/optparse.rst:419 +#: library/optparse.rst:419 msgid "" "These are covered in section :ref:`optparse-reference-guide`, Reference " "Guide and section :ref:`optparse-option-callbacks`." msgstr "" -#: ../src/Doc/library/optparse.rst:426 +#: library/optparse.rst:426 #, fuzzy msgid "Default values" msgstr "Valeur par défaut" -#: ../src/Doc/library/optparse.rst:428 +#: library/optparse.rst:428 msgid "" "All of the above examples involve setting some variable (the \"destination" "\") when certain command-line options are seen. What happens if those " @@ -69114,48 +70768,48 @@ msgid "" msgstr "" # dfa290c0bf65433f850e70cdbf8c692e -#: ../src/Doc/library/optparse.rst:435 +#: library/optparse.rst:435 msgid "" "First, consider the verbose/quiet example. If we want :mod:`optparse` to " "set ``verbose`` to ``True`` unless ``-q`` is seen, then we can do this::" msgstr "" -#: ../src/Doc/library/optparse.rst:441 +#: library/optparse.rst:441 msgid "" "Since default values apply to the *destination* rather than to any " "particular option, and these two options happen to have the same " "destination, this is exactly equivalent::" msgstr "" -#: ../src/Doc/library/optparse.rst:448 +#: library/optparse.rst:448 msgid "Consider this::" msgstr "" -#: ../src/Doc/library/optparse.rst:453 +#: library/optparse.rst:453 msgid "" "Again, the default value for ``verbose`` will be ``True``: the last default " "value supplied for any particular destination is the one that counts." msgstr "" -#: ../src/Doc/library/optparse.rst:456 +#: library/optparse.rst:456 msgid "" "A clearer way to specify default values is the :meth:`set_defaults` method " "of OptionParser, which you can call at any time before calling :meth:" "`parse_args`::" msgstr "" -#: ../src/Doc/library/optparse.rst:463 +#: library/optparse.rst:463 msgid "" "As before, the last value specified for a given option destination is the " "one that counts. For clarity, try to use one method or the other of setting " "default values, not both." msgstr "" -#: ../src/Doc/library/optparse.rst:471 +#: library/optparse.rst:471 msgid "Generating help" msgstr "" -#: ../src/Doc/library/optparse.rst:473 +#: library/optparse.rst:473 msgid "" ":mod:`optparse`'s ability to generate help and usage text automatically is " "useful for creating user-friendly command-line interfaces. All you have to " @@ -69165,31 +70819,31 @@ msgid "" msgstr "" # 4edb5d36c46e46768b645ce1be909731 -#: ../src/Doc/library/optparse.rst:494 +#: library/optparse.rst:494 msgid "" "If :mod:`optparse` encounters either ``-h`` or ``--help`` on the command-" "line, or if you just call :meth:`parser.print_help`, it prints the following " "to standard output:" msgstr "" -#: ../src/Doc/library/optparse.rst:511 +#: library/optparse.rst:511 msgid "" "(If the help output is triggered by a help option, :mod:`optparse` exits " "after printing the help text.)" msgstr "" -#: ../src/Doc/library/optparse.rst:514 +#: library/optparse.rst:514 msgid "" "There's a lot going on here to help :mod:`optparse` generate the best " "possible help message:" msgstr "" -#: ../src/Doc/library/optparse.rst:517 +#: library/optparse.rst:517 msgid "the script defines its own usage message::" msgstr "" # 9d585ad650a64802a44c3865af03f838 -#: ../src/Doc/library/optparse.rst:521 +#: library/optparse.rst:521 msgid "" ":mod:`optparse` expands ``%prog`` in the usage string to the name of the " "current program, i.e. ``os.path.basename(sys.argv[0])``. The expanded " @@ -69197,28 +70851,28 @@ msgid "" msgstr "" # 8f7401e4041f45a3960d1f011db8a484 -#: ../src/Doc/library/optparse.rst:525 +#: library/optparse.rst:525 msgid "" "If you don't supply a usage string, :mod:`optparse` uses a bland but " "sensible default: ``\"Usage: %prog [options]\"``, which is fine if your " "script doesn't take any positional arguments." msgstr "" -#: ../src/Doc/library/optparse.rst:529 +#: library/optparse.rst:529 msgid "" "every option defines a help string, and doesn't worry about line-" "wrapping--- :mod:`optparse` takes care of wrapping lines and making the help " "output look good." msgstr "" -#: ../src/Doc/library/optparse.rst:533 +#: library/optparse.rst:533 msgid "" "options that take a value indicate this fact in their automatically-" "generated help message, e.g. for the \"mode\" option::" msgstr "" # 43bc1afe398c489e87875491ddbb4090 -#: ../src/Doc/library/optparse.rst:538 +#: library/optparse.rst:538 msgid "" "Here, \"MODE\" is called the meta-variable: it stands for the argument that " "the user is expected to supply to ``-m``/``--mode``. By default, :mod:" @@ -69229,7 +70883,7 @@ msgid "" msgstr "" # f64bce28ff9344c1a9a880c686407d70 -#: ../src/Doc/library/optparse.rst:547 +#: library/optparse.rst:547 msgid "" "This is important for more than just saving space, though: the manually " "written help text uses the meta-variable ``FILE`` to clue the user in that " @@ -69239,12 +70893,20 @@ msgid "" "users." msgstr "" +#: library/optparse.rst:553 +msgid "" +"Options that have a default value can include ``%default`` in the help " +"string---\\ :mod:`optparse` will replace it with :func:`str` of the option's " +"default value. If an option has no default value (or the default value is " +"``None``), ``%default`` expands to ``none``." +msgstr "" + # 772fbca670fc497cbf623894cf8276cc -#: ../src/Doc/library/optparse.rst:560 +#: library/optparse.rst:560 msgid "Grouping Options" msgstr "" -#: ../src/Doc/library/optparse.rst:562 +#: library/optparse.rst:562 msgid "" "When dealing with many options, it is convenient to group these options for " "better help output. An :class:`OptionParser` can contain several option " @@ -69252,33 +70914,33 @@ msgid "" msgstr "" # 97b8a89aa2624209831a0eb458713e5f -#: ../src/Doc/library/optparse.rst:566 +#: library/optparse.rst:566 msgid "An option group is obtained using the class :class:`OptionGroup`:" msgstr "" -#: ../src/Doc/library/optparse.rst:570 ../src/Doc/library/optparse.rst:1616 +#: library/optparse.rst:570 library/optparse.rst:1616 msgid "where" msgstr "" # ec0bdb23f9e84ef69b232e762bcfe7e6 -#: ../src/Doc/library/optparse.rst:572 +#: library/optparse.rst:572 msgid "" "parser is the :class:`OptionParser` instance the group will be insterted in " "to" msgstr "" # e3663ce919d446a4a848ff94f3b6553f -#: ../src/Doc/library/optparse.rst:574 +#: library/optparse.rst:574 msgid "title is the group title" msgstr "" # 241a340aa896408cacd98e619abd9613 -#: ../src/Doc/library/optparse.rst:575 +#: library/optparse.rst:575 msgid "description, optional, is a long description of the group" msgstr "" # 577113502b0744779dee1f7e378dd65e -#: ../src/Doc/library/optparse.rst:577 +#: library/optparse.rst:577 msgid "" ":class:`OptionGroup` inherits from :class:`OptionContainer` (like :class:" "`OptionParser`) and so the :meth:`add_option` method can be used to add an " @@ -69286,55 +70948,55 @@ msgid "" msgstr "" # 05fa48dabe0e46f6a944539c2b40dc11 -#: ../src/Doc/library/optparse.rst:581 +#: library/optparse.rst:581 msgid "" "Once all the options are declared, using the :class:`OptionParser` method :" "meth:`add_option_group` the group is added to the previously defined parser." msgstr "" # 3da8c006049d447486566e49775ccd9e -#: ../src/Doc/library/optparse.rst:584 +#: library/optparse.rst:584 msgid "" "Continuing with the parser defined in the previous section, adding an :class:" "`OptionGroup` to a parser is easy::" msgstr "" -#: ../src/Doc/library/optparse.rst:593 +#: library/optparse.rst:593 msgid "This would result in the following help output:" msgstr "" # d0259b983fe74b4dbe76888a92075329 -#: ../src/Doc/library/optparse.rst:614 +#: library/optparse.rst:614 msgid "" "A bit more complete example might involve using more than one group: still " "extending the previous example::" msgstr "" # 6d02a527417f4a4a9c41f22ffd8fb337 -#: ../src/Doc/library/optparse.rst:631 +#: library/optparse.rst:631 msgid "that results in the following output:" msgstr "" # 8243fb7a8ab84e8497e4e1ed7bf49a88 -#: ../src/Doc/library/optparse.rst:657 +#: library/optparse.rst:657 msgid "" "Another interesting method, in particular when working programmatically with " "option groups is:" msgstr "" # b4a2d061dd5a4b5ebf5256c1e453f453 -#: ../src/Doc/library/optparse.rst:662 +#: library/optparse.rst:662 msgid "" "Return the :class:`OptionGroup` to which the short or long option string " "*opt_str* (e.g. ``'-o'`` or ``'--option'``) belongs. If there's no such :" "class:`OptionGroup`, return ``None``." msgstr "" -#: ../src/Doc/library/optparse.rst:669 +#: library/optparse.rst:669 msgid "Printing a version string" msgstr "" -#: ../src/Doc/library/optparse.rst:671 +#: library/optparse.rst:671 msgid "" "Similar to the brief usage string, :mod:`optparse` can also print a version " "string for your program. You have to supply the string as the ``version`` " @@ -69342,7 +71004,7 @@ msgid "" msgstr "" # 307a42b09bc54379a735fc9e26dac953 -#: ../src/Doc/library/optparse.rst:677 +#: library/optparse.rst:677 msgid "" "``%prog`` is expanded just like it is in ``usage``. Apart from that, " "``version`` can contain anything you like. When you supply it, :mod:" @@ -69351,18 +71013,18 @@ msgid "" "string (by replacing ``%prog``), prints it to stdout, and exits." msgstr "" -#: ../src/Doc/library/optparse.rst:683 +#: library/optparse.rst:683 msgid "For example, if your script is called ``/usr/bin/foo``::" msgstr "" -#: ../src/Doc/library/optparse.rst:688 +#: library/optparse.rst:688 msgid "" "The following two methods can be used to print and get the ``version`` " "string:" msgstr "" # 2023012476604b609e4adb058b4f9af5 -#: ../src/Doc/library/optparse.rst:692 +#: library/optparse.rst:692 msgid "" "Print the version message for the current program (``self.version``) to " "*file* (default stdout). As with :meth:`print_usage`, any occurrence of ``" @@ -69370,17 +71032,17 @@ msgid "" "program. Does nothing if ``self.version`` is empty or undefined." msgstr "" -#: ../src/Doc/library/optparse.rst:699 +#: library/optparse.rst:699 msgid "" "Same as :meth:`print_version` but returns the version string instead of " "printing it." msgstr "" -#: ../src/Doc/library/optparse.rst:706 +#: library/optparse.rst:706 msgid "How :mod:`optparse` handles errors" msgstr "" -#: ../src/Doc/library/optparse.rst:708 +#: library/optparse.rst:708 msgid "" "There are two broad classes of errors that :mod:`optparse` has to worry " "about: programmer errors and user errors. Programmer errors are usually " @@ -69391,7 +71053,7 @@ msgid "" msgstr "" # c26e8f539d784e3682dd29cd9df17382 -#: ../src/Doc/library/optparse.rst:715 +#: library/optparse.rst:715 msgid "" "Handling user errors is much more important, since they are guaranteed to " "happen no matter how stable your code is. :mod:`optparse` can automatically " @@ -69402,7 +71064,7 @@ msgid "" "error condition::" msgstr "" -#: ../src/Doc/library/optparse.rst:728 +#: library/optparse.rst:728 msgid "" "In either case, :mod:`optparse` handles the error the same way: it prints " "the program's usage message and an error message to standard error and exits " @@ -69410,65 +71072,64 @@ msgid "" msgstr "" # 27ff30e2ff3f429fbc2d70da92baa56d -#: ../src/Doc/library/optparse.rst:732 +#: library/optparse.rst:732 msgid "" "Consider the first example above, where the user passes ``4x`` to an option " "that takes an integer::" msgstr "" -#: ../src/Doc/library/optparse.rst:740 +#: library/optparse.rst:740 msgid "Or, where the user fails to pass a value at all::" msgstr "" -#: ../src/Doc/library/optparse.rst:747 +#: library/optparse.rst:747 msgid "" ":mod:`optparse`\\ -generated error messages take care always to mention the " "option involved in the error; be sure to do the same when calling :func:" "`OptionParser.error` from your application code." msgstr "" -#: ../src/Doc/library/optparse.rst:751 +#: library/optparse.rst:751 msgid "" "If :mod:`optparse`'s default error-handling behaviour does not suit your " "needs, you'll need to subclass OptionParser and override its :meth:" "`~OptionParser.exit` and/or :meth:`~OptionParser.error` methods." msgstr "" -#: ../src/Doc/library/optparse.rst:759 +#: library/optparse.rst:759 msgid "Putting it all together" msgstr "" -#: ../src/Doc/library/optparse.rst:761 +#: library/optparse.rst:761 msgid "Here's what :mod:`optparse`\\ -based scripts usually look like::" msgstr "" -#: ../src/Doc/library/optparse.rst:789 +#: library/optparse.rst:789 msgid "Reference Guide" msgstr "" -#: ../src/Doc/library/optparse.rst:795 +#: library/optparse.rst:795 msgid "Creating the parser" msgstr "" -#: ../src/Doc/library/optparse.rst:797 +#: library/optparse.rst:797 msgid "" "The first step in using :mod:`optparse` is to create an OptionParser " "instance." msgstr "" -#: ../src/Doc/library/optparse.rst:801 +#: library/optparse.rst:801 msgid "" "The OptionParser constructor has no required arguments, but a number of " "optional keyword arguments. You should always pass them as keyword " "arguments, i.e. do not rely on the order in which the arguments are declared." msgstr "" -# ff784f0852cb46afb328377cc08bb7f1 -#: ../src/Doc/library/optparse.rst:809 -msgid "``usage`` (default: ``\"%prog [options]\"``)" +#: library/optparse.rst:810 +msgid "usage (default: \"%prog [options]\")" msgstr "" -#: ../src/Doc/library/optparse.rst:806 +#: library/optparse.rst:806 msgid "" "The usage summary to print when your program is run incorrectly or with a " "help option. When :mod:`optparse` prints the usage string, it expands ``" @@ -69477,12 +71138,11 @@ msgid "" "value :data:`optparse.SUPPRESS_USAGE`." msgstr "" -# d009123d8888455c86ae50acb5cbfd49 -#: ../src/Doc/library/optparse.rst:816 -msgid "``option_list`` (default: ``[]``)" +#: library/optparse.rst:817 +msgid "option_list (default: [])" msgstr "" -#: ../src/Doc/library/optparse.rst:813 +#: library/optparse.rst:813 msgid "" "A list of Option objects to populate the parser with. The options in " "``option_list`` are added after any options in ``standard_option_list`` (a " @@ -69491,22 +71151,20 @@ msgid "" "the parser instead." msgstr "" -# ed51f76b0d2a4c7f89c8f96e612da739 -#: ../src/Doc/library/optparse.rst:819 -msgid "``option_class`` (default: optparse.Option)" +#: library/optparse.rst:820 +msgid "option_class (default: optparse.Option)" msgstr "" -#: ../src/Doc/library/optparse.rst:820 +#: library/optparse.rst:820 msgid "Class to use when adding options to the parser in :meth:`add_option`." msgstr "" -# 80c9cf5ce2b24ab9a11783ed46d6b3b8 -#: ../src/Doc/library/optparse.rst:825 -msgid "``version`` (default: ``None``)" +#: library/optparse.rst:826 +msgid "version (default: None)" msgstr "" # 565063087ebf4380a3b8d54340c023bc -#: ../src/Doc/library/optparse.rst:823 +#: library/optparse.rst:823 msgid "" "A version string to print when the user supplies a version option. If you " "supply a true value for ``version``, :mod:`optparse` automatically adds a " @@ -69514,23 +71172,21 @@ msgid "" "%prog`` is expanded the same as for ``usage``." msgstr "" -# 498ba29b4bcb4b4db7e6ef477746c5d7 -#: ../src/Doc/library/optparse.rst:830 -msgid "``conflict_handler`` (default: ``\"error\"``)" +#: library/optparse.rst:831 +msgid "conflict_handler (default: \"error\")" msgstr "" -#: ../src/Doc/library/optparse.rst:829 +#: library/optparse.rst:829 msgid "" "Specifies what to do when options with conflicting option strings are added " "to the parser; see section :ref:`optparse-conflicts-between-options`." msgstr "" -# d51f6889a79747cc81ffc76cde646e5d -#: ../src/Doc/library/optparse.rst:836 -msgid "``description`` (default: ``None``)" +#: library/optparse.rst:837 +msgid "description (default: None)" msgstr "" -#: ../src/Doc/library/optparse.rst:834 +#: library/optparse.rst:834 msgid "" "A paragraph of text giving a brief overview of your program. :mod:`optparse` " "reformats this paragraph to fit the current terminal width and prints it " @@ -69538,80 +71194,72 @@ msgid "" "options)." msgstr "" -# 485020c5b20c4083b7e8300d9b4e4b87 -#: ../src/Doc/library/optparse.rst:841 -msgid "``formatter`` (default: a new :class:`IndentedHelpFormatter`)" +#: library/optparse.rst:842 +msgid "formatter (default: a new IndentedHelpFormatter)" msgstr "" -#: ../src/Doc/library/optparse.rst:840 +#: library/optparse.rst:840 msgid "" "An instance of optparse.HelpFormatter that will be used for printing help " "text. :mod:`optparse` provides two concrete classes for this purpose: " "IndentedHelpFormatter and TitledHelpFormatter." msgstr "" -# 4a0f0148046b46b9afd53e31105a9082 -#: ../src/Doc/library/optparse.rst:845 -msgid "``add_help_option`` (default: ``True``)" +#: library/optparse.rst:846 +msgid "add_help_option (default: True)" msgstr "" # e7a3ee96c3704a978dfbc0ea9b157417 -#: ../src/Doc/library/optparse.rst:845 +#: library/optparse.rst:845 msgid "" "If true, :mod:`optparse` will add a help option (with option strings ``-h`` " "and ``--help``) to the parser." msgstr "" -# c16d57e9f4854888920db036ef97e5a2 -#: ../src/Doc/library/optparse.rst:849 -msgid "``prog``" -msgstr "" - # 014d992df50a42f8a8cc1c2e5374631c -#: ../src/Doc/library/optparse.rst:849 +#: library/optparse.rst:849 msgid "" "The string to use when expanding ``%prog`` in ``usage`` and ``version`` " "instead of ``os.path.basename(sys.argv[0])``." msgstr "" -# 3d3dfda6fc994ffeb5854a8d30b75632 -#: ../src/Doc/library/optparse.rst:851 -msgid "``epilog`` (default: ``None``)" +#: library/optparse.rst:852 +msgid "epilog (default: None)" msgstr "" -#: ../src/Doc/library/optparse.rst:853 +#: library/optparse.rst:853 msgid "A paragraph of help text to print after the option help." msgstr "" -#: ../src/Doc/library/optparse.rst:858 +#: library/optparse.rst:858 msgid "Populating the parser" msgstr "" -#: ../src/Doc/library/optparse.rst:860 +#: library/optparse.rst:860 msgid "" "There are several ways to populate the parser with options. The preferred " "way is by using :meth:`OptionParser.add_option`, as shown in section :ref:" "`optparse-tutorial`. :meth:`add_option` can be called in one of two ways:" msgstr "" -#: ../src/Doc/library/optparse.rst:864 +#: library/optparse.rst:864 msgid "pass it an Option instance (as returned by :func:`make_option`)" msgstr "" -#: ../src/Doc/library/optparse.rst:866 +#: library/optparse.rst:866 msgid "" "pass it any combination of positional and keyword arguments that are " "acceptable to :func:`make_option` (i.e., to the Option constructor), and it " "will create the Option instance for you" msgstr "" -#: ../src/Doc/library/optparse.rst:870 +#: library/optparse.rst:870 msgid "" "The other alternative is to pass a list of pre-constructed Option instances " "to the OptionParser constructor, as in::" msgstr "" -#: ../src/Doc/library/optparse.rst:881 +#: library/optparse.rst:881 msgid "" "(:func:`make_option` is a factory function for creating Option instances; " "currently it is an alias for the Option constructor. A future version of :" @@ -69620,33 +71268,33 @@ msgid "" "Option directly.)" msgstr "" -#: ../src/Doc/library/optparse.rst:890 +#: library/optparse.rst:890 msgid "Defining options" msgstr "" # 97dc3511ab5f41c180aebd2a8d63b97c -#: ../src/Doc/library/optparse.rst:892 +#: library/optparse.rst:892 msgid "" "Each Option instance represents a set of synonymous command-line option " "strings, e.g. ``-f`` and ``--file``. You can specify any number of short or " "long option strings, but you must specify at least one overall option string." msgstr "" -#: ../src/Doc/library/optparse.rst:896 +#: library/optparse.rst:896 msgid "" "The canonical way to create an :class:`Option` instance is with the :meth:" "`add_option` method of :class:`OptionParser`." msgstr "" -#: ../src/Doc/library/optparse.rst:902 +#: library/optparse.rst:902 msgid "To define an option with only a short option string::" msgstr "" -#: ../src/Doc/library/optparse.rst:906 +#: library/optparse.rst:906 msgid "And to define an option with only a long option string::" msgstr "" -#: ../src/Doc/library/optparse.rst:910 +#: library/optparse.rst:910 msgid "" "The keyword arguments define attributes of the new Option object. The most " "important option attribute is :attr:`~Option.action`, and it largely " @@ -69655,66 +71303,62 @@ msgid "" "raises an :exc:`OptionError` exception explaining your mistake." msgstr "" -#: ../src/Doc/library/optparse.rst:916 +#: library/optparse.rst:916 msgid "" "An option's *action* determines what :mod:`optparse` does when it encounters " "this option on the command-line. The standard option actions hard-coded " "into :mod:`optparse` are:" msgstr "" -# 195699d3c57248cdb18fed39ea391ce7 -#: ../src/Doc/library/optparse.rst:920 -msgid "``\"store\"``" +#: library/optparse.rst:921 +msgid "\"store\"" msgstr "" -#: ../src/Doc/library/optparse.rst:921 +#: library/optparse.rst:921 msgid "store this option's argument (default)" msgstr "" -# a460d27d87c0493095488d799cecef2d -#: ../src/Doc/library/optparse.rst:926 -msgid "``\"store_true\"``" +#: library/optparse.rst:927 +msgid "\"store_true\"" msgstr "" -#: ../src/Doc/library/optparse.rst:927 +#: library/optparse.rst:927 msgid "store a true value" msgstr "" -# 70e85c2580114a5b898b160ea71ec2fe -#: ../src/Doc/library/optparse.rst:929 -msgid "``\"store_false\"``" +#: library/optparse.rst:930 +msgid "\"store_false\"" msgstr "" -#: ../src/Doc/library/optparse.rst:930 +#: library/optparse.rst:930 msgid "store a false value" msgstr "" -# 02698a8ced844a04b0fc92b16bd25de5 -#: ../src/Doc/library/optparse.rst:935 -msgid "``\"append_const\"``" +#: library/optparse.rst:936 +msgid "\"append_const\"" msgstr "" -#: ../src/Doc/library/optparse.rst:936 +#: library/optparse.rst:936 msgid "append a constant value to a list" msgstr "" -#: ../src/Doc/library/optparse.rst:944 ../src/Doc/library/optparse.rst:1222 -msgid "``\"help\"``" +#: library/optparse.rst:945 +msgid "\"help\"" msgstr "" -#: ../src/Doc/library/optparse.rst:945 +#: library/optparse.rst:945 msgid "" "print a usage message including all options and the documentation for them" msgstr "" -#: ../src/Doc/library/optparse.rst:947 +#: library/optparse.rst:947 msgid "" "(If you don't supply an action, the default is ``\"store\"``. For this " "action, you may also supply :attr:`~Option.type` and :attr:`~Option.dest` " "option attributes; see :ref:`optparse-standard-option-actions`.)" msgstr "" -#: ../src/Doc/library/optparse.rst:951 +#: library/optparse.rst:951 msgid "" "As you can see, most actions involve storing or updating a value somewhere. :" "mod:`optparse` always creates a special object for this, conventionally " @@ -69724,41 +71368,41 @@ msgid "" "(destination) option attribute." msgstr "" -#: ../src/Doc/library/optparse.rst:957 +#: library/optparse.rst:957 msgid "For example, when you call ::" msgstr "" -#: ../src/Doc/library/optparse.rst:961 +#: library/optparse.rst:961 msgid "" "one of the first things :mod:`optparse` does is create the ``options`` " "object::" msgstr "" -#: ../src/Doc/library/optparse.rst:965 +#: library/optparse.rst:965 msgid "If one of the options in this parser is defined with ::" msgstr "" -#: ../src/Doc/library/optparse.rst:969 +#: library/optparse.rst:969 msgid "and the command-line being parsed includes any of the following::" msgstr "" -#: ../src/Doc/library/optparse.rst:976 +#: library/optparse.rst:976 msgid "" "then :mod:`optparse`, on seeing this option, will do the equivalent of ::" msgstr "" -#: ../src/Doc/library/optparse.rst:980 +#: library/optparse.rst:980 msgid "" "The :attr:`~Option.type` and :attr:`~Option.dest` option attributes are " "almost as important as :attr:`~Option.action`, but :attr:`~Option.action` is " "the only one that makes sense for *all* options." msgstr "" -#: ../src/Doc/library/optparse.rst:988 +#: library/optparse.rst:988 msgid "Option attributes" msgstr "" -#: ../src/Doc/library/optparse.rst:990 +#: library/optparse.rst:990 msgid "" "The following option attributes may be passed as keyword arguments to :meth:" "`OptionParser.add_option`. If you pass an option attribute that is not " @@ -69766,33 +71410,33 @@ msgid "" "attribute, :mod:`optparse` raises :exc:`OptionError`." msgstr "" -#: ../src/Doc/library/optparse.rst:997 +#: library/optparse.rst:997 msgid "(default: ``\"store\"``)" msgstr "" -#: ../src/Doc/library/optparse.rst:999 +#: library/optparse.rst:999 msgid "" "Determines :mod:`optparse`'s behaviour when this option is seen on the " "command line; the available options are documented :ref:`here `." msgstr "" -#: ../src/Doc/library/optparse.rst:1005 +#: library/optparse.rst:1005 msgid "(default: ``\"string\"``)" msgstr "" -#: ../src/Doc/library/optparse.rst:1007 +#: library/optparse.rst:1007 msgid "" "The argument type expected by this option (e.g., ``\"string\"`` or ``\"int" "\"``); the available option types are documented :ref:`here `." msgstr "" -#: ../src/Doc/library/optparse.rst:1013 ../src/Doc/library/optparse.rst:1063 +#: library/optparse.rst:1013 library/optparse.rst:1063 msgid "(default: derived from option strings)" msgstr "" -#: ../src/Doc/library/optparse.rst:1015 +#: library/optparse.rst:1015 msgid "" "If the option's action implies writing or modifying a value somewhere, this " "tells :mod:`optparse` where to write it: :attr:`~Option.dest` names an " @@ -69800,48 +71444,48 @@ msgid "" "the command line." msgstr "" -#: ../src/Doc/library/optparse.rst:1022 +#: library/optparse.rst:1022 msgid "" "The value to use for this option's destination if the option is not seen on " "the command line. See also :meth:`OptionParser.set_defaults`." msgstr "" -#: ../src/Doc/library/optparse.rst:1027 +#: library/optparse.rst:1027 msgid "(default: 1)" msgstr "" -#: ../src/Doc/library/optparse.rst:1029 +#: library/optparse.rst:1029 msgid "" "How many arguments of type :attr:`~Option.type` should be consumed when this " "option is seen. If > 1, :mod:`optparse` will store a tuple of values to :" "attr:`~Option.dest`." msgstr "" -#: ../src/Doc/library/optparse.rst:1035 +#: library/optparse.rst:1035 msgid "For actions that store a constant value, the constant value to store." msgstr "" -#: ../src/Doc/library/optparse.rst:1039 +#: library/optparse.rst:1039 msgid "" "For options of type ``\"choice\"``, the list of strings the user may choose " "from." msgstr "" -#: ../src/Doc/library/optparse.rst:1044 +#: library/optparse.rst:1044 msgid "" "For options with action ``\"callback\"``, the callable to call when this " "option is seen. See section :ref:`optparse-option-callbacks` for detail on " "the arguments passed to the callable." msgstr "" -#: ../src/Doc/library/optparse.rst:1051 +#: library/optparse.rst:1051 msgid "" "Additional positional and keyword arguments to pass to ``callback`` after " "the four standard callback arguments." msgstr "" # 67ee843f72244a6abe7651f201530305 -#: ../src/Doc/library/optparse.rst:1056 +#: library/optparse.rst:1056 msgid "" "Help text to print for this option when listing all available options after " "the user supplies a :attr:`~Option.help` option (such as ``--help``). If no " @@ -69849,17 +71493,17 @@ msgid "" "this option, use the special value :data:`optparse.SUPPRESS_HELP`." msgstr "" -#: ../src/Doc/library/optparse.rst:1065 +#: library/optparse.rst:1065 msgid "" "Stand-in for the option argument(s) to use when printing help text. See " "section :ref:`optparse-tutorial` for an example." msgstr "" -#: ../src/Doc/library/optparse.rst:1072 +#: library/optparse.rst:1072 msgid "Standard option actions" msgstr "" -#: ../src/Doc/library/optparse.rst:1074 +#: library/optparse.rst:1074 msgid "" "The various option actions all have slightly different requirements and " "effects. Most actions have several relevant option attributes which you may " @@ -69867,13 +71511,13 @@ msgid "" "attributes, which you must specify for any option using that action." msgstr "" -#: ../src/Doc/library/optparse.rst:1079 +#: library/optparse.rst:1079 msgid "" "``\"store\"`` [relevant: :attr:`~Option.type`, :attr:`~Option.dest`, :attr:" "`~Option.nargs`, :attr:`~Option.choices`]" msgstr "" -#: ../src/Doc/library/optparse.rst:1082 +#: library/optparse.rst:1082 msgid "" "The option must be followed by an argument, which is converted to a value " "according to :attr:`~Option.type` and stored in :attr:`~Option.dest`. If :" @@ -69883,18 +71527,18 @@ msgid "" "option-types` section." msgstr "" -#: ../src/Doc/library/optparse.rst:1089 +#: library/optparse.rst:1089 msgid "" "If :attr:`~Option.choices` is supplied (a list or tuple of strings), the " "type defaults to ``\"choice\"``." msgstr "" -#: ../src/Doc/library/optparse.rst:1092 +#: library/optparse.rst:1092 msgid "If :attr:`~Option.type` is not supplied, it defaults to ``\"string\"``." msgstr "" # c5c80a31cad24ca78e25695def9e6aaa -#: ../src/Doc/library/optparse.rst:1094 +#: library/optparse.rst:1094 msgid "" "If :attr:`~Option.dest` is not supplied, :mod:`optparse` derives a " "destination from the first long option string (e.g., ``--foo-bar`` implies " @@ -69902,54 +71546,54 @@ msgid "" "destination from the first short option string (e.g., ``-f`` implies ``f``)." msgstr "" -#: ../src/Doc/library/optparse.rst:1104 +#: library/optparse.rst:1104 msgid "As it parses the command line ::" msgstr "" -#: ../src/Doc/library/optparse.rst:1108 +#: library/optparse.rst:1108 msgid ":mod:`optparse` will set ::" msgstr "" -#: ../src/Doc/library/optparse.rst:1114 +#: library/optparse.rst:1114 msgid "" "``\"store_const\"`` [required: :attr:`~Option.const`; relevant: :attr:" "`~Option.dest`]" msgstr "" -#: ../src/Doc/library/optparse.rst:1117 +#: library/optparse.rst:1117 msgid "The value :attr:`~Option.const` is stored in :attr:`~Option.dest`." msgstr "" # 2c8baf98902c4d148b62a227591ab473 -#: ../src/Doc/library/optparse.rst:1128 +#: library/optparse.rst:1128 msgid "If ``--noisy`` is seen, :mod:`optparse` will set ::" msgstr "" -#: ../src/Doc/library/optparse.rst:1132 +#: library/optparse.rst:1132 msgid "``\"store_true\"`` [relevant: :attr:`~Option.dest`]" msgstr "" -#: ../src/Doc/library/optparse.rst:1134 +#: library/optparse.rst:1134 msgid "" "A special case of ``\"store_const\"`` that stores a true value to :attr:" "`~Option.dest`." msgstr "" -#: ../src/Doc/library/optparse.rst:1137 +#: library/optparse.rst:1137 msgid "``\"store_false\"`` [relevant: :attr:`~Option.dest`]" msgstr "" -#: ../src/Doc/library/optparse.rst:1139 +#: library/optparse.rst:1139 msgid "Like ``\"store_true\"``, but stores a false value." msgstr "" -#: ../src/Doc/library/optparse.rst:1146 +#: library/optparse.rst:1146 msgid "" "``\"append\"`` [relevant: :attr:`~Option.type`, :attr:`~Option.dest`, :attr:" "`~Option.nargs`, :attr:`~Option.choices`]" msgstr "" -#: ../src/Doc/library/optparse.rst:1149 +#: library/optparse.rst:1149 msgid "" "The option must be followed by an argument, which is appended to the list " "in :attr:`~Option.dest`. If no default value for :attr:`~Option.dest` is " @@ -69959,26 +71603,26 @@ msgid "" "is appended to :attr:`~Option.dest`." msgstr "" -#: ../src/Doc/library/optparse.rst:1156 +#: library/optparse.rst:1156 msgid "" "The defaults for :attr:`~Option.type` and :attr:`~Option.dest` are the same " "as for the ``\"store\"`` action." msgstr "" # f887a5e944d540c584802b14768129f5 -#: ../src/Doc/library/optparse.rst:1163 +#: library/optparse.rst:1163 msgid "" "If ``-t3`` is seen on the command-line, :mod:`optparse` does the equivalent " "of::" msgstr "" # d78dab615e704696a45191974f53adea -#: ../src/Doc/library/optparse.rst:1169 +#: library/optparse.rst:1169 msgid "If, a little later on, ``--tracks=4`` is seen, it does::" msgstr "" # 6a9adda6e0d848babdadd9de1596adab -#: ../src/Doc/library/optparse.rst:1173 +#: library/optparse.rst:1173 msgid "" "The ``append`` action calls the ``append`` method on the current value of " "the option. This means that any default value specified must have an " @@ -69987,13 +71631,13 @@ msgid "" "with any values from the command line appended after those default values::" msgstr "" -#: ../src/Doc/library/optparse.rst:1184 +#: library/optparse.rst:1184 msgid "" "``\"append_const\"`` [required: :attr:`~Option.const`; relevant: :attr:" "`~Option.dest`]" msgstr "" -#: ../src/Doc/library/optparse.rst:1187 +#: library/optparse.rst:1187 msgid "" "Like ``\"store_const\"``, but the value :attr:`~Option.const` is appended " "to :attr:`~Option.dest`; as with ``\"append\"``, :attr:`~Option.dest` " @@ -70001,11 +71645,11 @@ msgid "" "time the option is encountered." msgstr "" -#: ../src/Doc/library/optparse.rst:1192 +#: library/optparse.rst:1192 msgid "``\"count\"`` [relevant: :attr:`~Option.dest`]" msgstr "" -#: ../src/Doc/library/optparse.rst:1194 +#: library/optparse.rst:1194 msgid "" "Increment the integer stored at :attr:`~Option.dest`. If no default value " "is supplied, :attr:`~Option.dest` is set to zero before being incremented " @@ -70013,35 +71657,39 @@ msgid "" msgstr "" # 6076f43233d545898c75a82146e9d4e1 -#: ../src/Doc/library/optparse.rst:1202 +#: library/optparse.rst:1202 msgid "" "The first time ``-v`` is seen on the command line, :mod:`optparse` does the " "equivalent of::" msgstr "" # b276fd5b2f164c20afcc10a9387ad5db -#: ../src/Doc/library/optparse.rst:1208 +#: library/optparse.rst:1208 msgid "Every subsequent occurrence of ``-v`` results in ::" msgstr "" -#: ../src/Doc/library/optparse.rst:1212 +#: library/optparse.rst:1212 msgid "" "``\"callback\"`` [required: :attr:`~Option.callback`; relevant: :attr:" "`~Option.type`, :attr:`~Option.nargs`, :attr:`~Option.callback_args`, :attr:" "`~Option.callback_kwargs`]" msgstr "" -#: ../src/Doc/library/optparse.rst:1216 +#: library/optparse.rst:1216 msgid "" "Call the function specified by :attr:`~Option.callback`, which is called " "as ::" msgstr "" -#: ../src/Doc/library/optparse.rst:1220 +#: library/optparse.rst:1220 msgid "See section :ref:`optparse-option-callbacks` for more detail." msgstr "" -#: ../src/Doc/library/optparse.rst:1224 +#: library/optparse.rst:1222 +msgid "``\"help\"``" +msgstr "" + +#: library/optparse.rst:1224 msgid "" "Prints a complete help message for all the options in the current option " "parser. The help message is constructed from the ``usage`` string passed to " @@ -70049,38 +71697,38 @@ msgid "" "every option." msgstr "" -#: ../src/Doc/library/optparse.rst:1229 +#: library/optparse.rst:1229 msgid "" "If no :attr:`~Option.help` string is supplied for an option, it will still " "be listed in the help message. To omit an option entirely, use the special " "value :data:`optparse.SUPPRESS_HELP`." msgstr "" -#: ../src/Doc/library/optparse.rst:1233 +#: library/optparse.rst:1233 msgid "" ":mod:`optparse` automatically adds a :attr:`~Option.help` option to all " "OptionParsers, so you do not normally need to create one." msgstr "" # 9e59181054b143b59a0bb7400d97134e -#: ../src/Doc/library/optparse.rst:1251 +#: library/optparse.rst:1251 msgid "" "If :mod:`optparse` sees either ``-h`` or ``--help`` on the command line, it " "will print something like the following help message to stdout (assuming " "``sys.argv[0]`` is ``\"foo.py\"``):" msgstr "" -#: ../src/Doc/library/optparse.rst:1264 +#: library/optparse.rst:1264 msgid "" "After printing the help message, :mod:`optparse` terminates your process " "with ``sys.exit(0)``." msgstr "" -#: ../src/Doc/library/optparse.rst:1267 +#: library/optparse.rst:1267 msgid "``\"version\"``" msgstr "" -#: ../src/Doc/library/optparse.rst:1269 +#: library/optparse.rst:1269 msgid "" "Prints the version number supplied to the OptionParser to stdout and exits. " "The version number is actually formatted and printed by the " @@ -70090,19 +71738,19 @@ msgid "" "since :mod:`optparse` automatically adds them when needed." msgstr "" -#: ../src/Doc/library/optparse.rst:1280 +#: library/optparse.rst:1280 msgid "Standard option types" msgstr "" # b2966639dcd3490888a91abaf1166125 -#: ../src/Doc/library/optparse.rst:1282 +#: library/optparse.rst:1282 msgid "" ":mod:`optparse` has six built-in option types: ``\"string\"``, ``\"int\"``, " "``\"long\"``, ``\"choice\"``, ``\"float\"`` and ``\"complex\"``. If you " "need to add new option types, see section :ref:`optparse-extending-optparse`." msgstr "" -#: ../src/Doc/library/optparse.rst:1286 +#: library/optparse.rst:1286 msgid "" "Arguments to string options are not checked or converted in any way: the " "text on the command line is stored in the destination (or passed to the " @@ -70110,43 +71758,43 @@ msgid "" msgstr "" # 33f7363c032642578feb75573a62bbf4 -#: ../src/Doc/library/optparse.rst:1289 +#: library/optparse.rst:1289 msgid "" "Integer arguments (type ``\"int\"`` or ``\"long\"``) are parsed as follows:" msgstr "" -#: ../src/Doc/library/optparse.rst:1291 +#: library/optparse.rst:1291 msgid "if the number starts with ``0x``, it is parsed as a hexadecimal number" msgstr "" -#: ../src/Doc/library/optparse.rst:1293 +#: library/optparse.rst:1293 msgid "if the number starts with ``0``, it is parsed as an octal number" msgstr "" -#: ../src/Doc/library/optparse.rst:1295 +#: library/optparse.rst:1295 msgid "if the number starts with ``0b``, it is parsed as a binary number" msgstr "" -#: ../src/Doc/library/optparse.rst:1297 +#: library/optparse.rst:1297 msgid "otherwise, the number is parsed as a decimal number" msgstr "" # 5c956ce07d514b969ca01a56efbd18c1 -#: ../src/Doc/library/optparse.rst:1300 +#: library/optparse.rst:1300 msgid "" "The conversion is done by calling either :func:`int` or :func:`long` with " "the appropriate base (2, 8, 10, or 16). If this fails, so will :mod:" "`optparse`, although with a more useful error message." msgstr "" -#: ../src/Doc/library/optparse.rst:1304 +#: library/optparse.rst:1304 msgid "" "``\"float\"`` and ``\"complex\"`` option arguments are converted directly " "with :func:`float` and :func:`complex`, with similar error-handling." msgstr "" # fb4c8ee74e4248bcb45a12d9f1dca181 -#: ../src/Doc/library/optparse.rst:1307 +#: library/optparse.rst:1307 msgid "" "``\"choice\"`` options are a subtype of ``\"string\"`` options. The :attr:" "`~Option.choices` option attribute (a sequence of strings) defines the set " @@ -70155,61 +71803,54 @@ msgid "" "`OptionValueError` if an invalid string is given." msgstr "" -#: ../src/Doc/library/optparse.rst:1319 +#: library/optparse.rst:1319 msgid "" "The whole point of creating and populating an OptionParser is to call its :" "meth:`parse_args` method::" msgstr "" -#: ../src/Doc/library/optparse.rst:1324 +#: library/optparse.rst:1324 msgid "where the input parameters are" msgstr "" -# 8b036ae836b243889167934683d2cc50 -# 800d7f8ffdbc4196bd1b1f01063f7668 -# a3e07652ae0647e2b08869dc826264a3 -#: ../src/Doc/library/optparse.rst:1326 ../src/Doc/library/optparse.rst:1340 -#: ../src/Doc/library/optparse.rst:1659 -msgid "``args``" -msgstr "" - -#: ../src/Doc/library/optparse.rst:1327 +#: library/optparse.rst:1327 msgid "the list of arguments to process (default: ``sys.argv[1:]``)" msgstr "" -# b3ff0460792e481cb439638a967dda30 -#: ../src/Doc/library/optparse.rst:1331 -msgid "``values``" -msgstr "" +#: library/optparse.rst:1332 library/ttk.rst:335 library/ttk.rst:766 +#, fuzzy +msgid "values" +msgstr "valeur" # afbebed663ee43f6a941bc38643983df -#: ../src/Doc/library/optparse.rst:1330 +#: library/optparse.rst:1330 msgid "" "a :class:`optparse.Values` object to store option arguments in (default: a " "new instance of :class:`Values`) -- if you give an existing object, the " "option defaults will not be initialized on it" msgstr "" -#: ../src/Doc/library/optparse.rst:1334 +#: library/optparse.rst:1334 msgid "and the return values are" msgstr "" -# 9929d301a90e4f16af0dc3bbd065410b -#: ../src/Doc/library/optparse.rst:1337 -msgid "``options``" -msgstr "" +# 44573c5d07ca4b409899d66ef06775f5 +#: library/optparse.rst:1338 library/tkinter.rst:280 +#, fuzzy +msgid "options" +msgstr "*options*" -#: ../src/Doc/library/optparse.rst:1337 +#: library/optparse.rst:1337 msgid "" "the same object that was passed in as ``values``, or the optparse.Values " "instance created by :mod:`optparse`" msgstr "" -#: ../src/Doc/library/optparse.rst:1341 +#: library/optparse.rst:1341 msgid "the leftover positional arguments after all options have been processed" msgstr "" -#: ../src/Doc/library/optparse.rst:1343 +#: library/optparse.rst:1343 msgid "" "The most common usage is to supply neither keyword argument. If you supply " "``values``, it will be modified with repeated :func:`setattr` calls (roughly " @@ -70217,7 +71858,7 @@ msgid "" "by :meth:`parse_args`." msgstr "" -#: ../src/Doc/library/optparse.rst:1348 +#: library/optparse.rst:1348 msgid "" "If :meth:`parse_args` encounters any errors in the argument list, it calls " "the OptionParser's :meth:`error` method with an appropriate end-user error " @@ -70225,11 +71866,11 @@ msgid "" "(the traditional Unix exit status for command-line errors)." msgstr "" -#: ../src/Doc/library/optparse.rst:1357 +#: library/optparse.rst:1357 msgid "Querying and manipulating your option parser" msgstr "" -#: ../src/Doc/library/optparse.rst:1359 +#: library/optparse.rst:1359 msgid "" "The default behavior of the option parser can be customized slightly, and " "you can also poke around your option parser and see what's there. " @@ -70237,51 +71878,51 @@ msgid "" msgstr "" # 91497615742747e0891978b59682e4d5 -#: ../src/Doc/library/optparse.rst:1365 +#: library/optparse.rst:1365 msgid "" "Set parsing to stop on the first non-option. For example, if ``-a`` and ``-" "b`` are both simple options that take no arguments, :mod:`optparse` normally " "accepts this syntax::" msgstr "" -#: ../src/Doc/library/optparse.rst:1371 +#: library/optparse.rst:1371 msgid "and treats it as equivalent to ::" msgstr "" -#: ../src/Doc/library/optparse.rst:1375 +#: library/optparse.rst:1375 msgid "" "To disable this feature, call :meth:`disable_interspersed_args`. This " "restores traditional Unix syntax, where option parsing stops with the first " "non-option argument." msgstr "" -#: ../src/Doc/library/optparse.rst:1379 +#: library/optparse.rst:1379 msgid "" "Use this if you have a command processor which runs another command which " "has options of its own and you want to make sure these options don't get " "confused. For example, each command might have a different set of options." msgstr "" -#: ../src/Doc/library/optparse.rst:1385 +#: library/optparse.rst:1385 msgid "" "Set parsing to not stop on the first non-option, allowing interspersing " "switches with command arguments. This is the default behavior." msgstr "" -#: ../src/Doc/library/optparse.rst:1390 +#: library/optparse.rst:1390 msgid "" "Returns the Option instance with the option string *opt_str*, or ``None`` if " "no options have that option string." msgstr "" # a3c331901a824fd18b62d146704ecd65 -#: ../src/Doc/library/optparse.rst:1395 +#: library/optparse.rst:1395 msgid "" "Return true if the OptionParser has an option with option string *opt_str* " "(e.g., ``-q`` or ``--verbose``)." msgstr "" -#: ../src/Doc/library/optparse.rst:1400 +#: library/optparse.rst:1400 msgid "" "If the :class:`OptionParser` has an option corresponding to *opt_str*, that " "option is removed. If that option provided any other option strings, all of " @@ -70289,23 +71930,23 @@ msgid "" "option belonging to this :class:`OptionParser`, raises :exc:`ValueError`." msgstr "" -#: ../src/Doc/library/optparse.rst:1409 +#: library/optparse.rst:1409 msgid "Conflicts between options" msgstr "" -#: ../src/Doc/library/optparse.rst:1411 +#: library/optparse.rst:1411 msgid "" "If you're not careful, it's easy to define options with conflicting option " "strings::" msgstr "" -#: ../src/Doc/library/optparse.rst:1418 +#: library/optparse.rst:1418 msgid "" "(This is particularly true if you've defined your own OptionParser subclass " "with some standard options.)" msgstr "" -#: ../src/Doc/library/optparse.rst:1421 +#: library/optparse.rst:1421 msgid "" "Every time you add an option, :mod:`optparse` checks for conflicts with " "existing options. If it finds any, it invokes the current conflict-handling " @@ -70313,42 +71954,40 @@ msgid "" "constructor::" msgstr "" -#: ../src/Doc/library/optparse.rst:1427 +#: library/optparse.rst:1427 msgid "or with a separate call::" msgstr "" -#: ../src/Doc/library/optparse.rst:1431 +#: library/optparse.rst:1431 msgid "The available conflict handlers are:" msgstr "" -# b8a64b352a1e406da3ffdf36e007b5de -#: ../src/Doc/library/optparse.rst:1434 -msgid "``\"error\"`` (default)" +#: library/optparse.rst:1435 +msgid "\"error\" (default)" msgstr "" -#: ../src/Doc/library/optparse.rst:1434 +#: library/optparse.rst:1434 msgid "" "assume option conflicts are a programming error and raise :exc:" "`OptionConflictError`" msgstr "" -# d57143d9bf2e4a84898293605ab13070 -#: ../src/Doc/library/optparse.rst:1438 -msgid "``\"resolve\"``" +#: library/optparse.rst:1439 +msgid "\"resolve\"" msgstr "" -#: ../src/Doc/library/optparse.rst:1438 +#: library/optparse.rst:1438 msgid "resolve option conflicts intelligently (see below)" msgstr "" -#: ../src/Doc/library/optparse.rst:1441 +#: library/optparse.rst:1441 msgid "" "As an example, let's define an :class:`OptionParser` that resolves conflicts " "intelligently and add conflicting options to it::" msgstr "" # e9ff3f507fdf4842a31283f0aff6b13f -#: ../src/Doc/library/optparse.rst:1448 +#: library/optparse.rst:1448 msgid "" "At this point, :mod:`optparse` detects that a previously-added option is " "already using the ``-n`` option string. Since ``conflict_handler`` is ``" @@ -70358,7 +71997,7 @@ msgid "" "will reflect that::" msgstr "" -#: ../src/Doc/library/optparse.rst:1459 +#: library/optparse.rst:1459 msgid "" "It's possible to whittle away the option strings for a previously-added " "option until there are none left, and the user has no way of invoking that " @@ -70368,13 +72007,13 @@ msgid "" msgstr "" # 9b958095aefa43bcbe764a32f5c7a0f9 -#: ../src/Doc/library/optparse.rst:1467 +#: library/optparse.rst:1467 msgid "" "At this point, the original ``-n``/``--dry-run`` option is no longer " "accessible, so :mod:`optparse` removes it, leaving this help text::" msgstr "" -#: ../src/Doc/library/optparse.rst:1481 +#: library/optparse.rst:1481 msgid "" "OptionParser instances have several cyclic references. This should not be a " "problem for Python's garbage collector, but you may wish to break the cyclic " @@ -70384,15 +72023,15 @@ msgid "" "OptionParser." msgstr "" -#: ../src/Doc/library/optparse.rst:1492 +#: library/optparse.rst:1492 msgid "Other methods" msgstr "" -#: ../src/Doc/library/optparse.rst:1494 +#: library/optparse.rst:1494 msgid "OptionParser supports several other public methods:" msgstr "" -#: ../src/Doc/library/optparse.rst:1498 +#: library/optparse.rst:1498 msgid "" "Set the usage string according to the rules described above for the " "``usage`` constructor keyword argument. Passing ``None`` sets the default " @@ -70401,7 +72040,7 @@ msgid "" msgstr "" # c4fb083d70e94b13a30e8705d956908d -#: ../src/Doc/library/optparse.rst:1504 +#: library/optparse.rst:1504 msgid "" "Print the usage message for the current program (``self.usage``) to *file* " "(default stdout). Any occurrence of the string ``%prog`` in ``self.usage`` " @@ -70409,13 +72048,13 @@ msgid "" "usage`` is empty or not defined." msgstr "" -#: ../src/Doc/library/optparse.rst:1511 +#: library/optparse.rst:1511 msgid "" "Same as :meth:`print_usage` but returns the usage string instead of printing " "it." msgstr "" -#: ../src/Doc/library/optparse.rst:1516 +#: library/optparse.rst:1516 msgid "" "Set default values for several option destinations at once. Using :meth:" "`set_defaults` is the preferred way to set default values for options, since " @@ -70424,15 +72063,15 @@ msgid "" "default, and the last one wins::" msgstr "" -#: ../src/Doc/library/optparse.rst:1529 +#: library/optparse.rst:1529 msgid "To avoid this confusion, use :meth:`set_defaults`::" msgstr "" -#: ../src/Doc/library/optparse.rst:1541 +#: library/optparse.rst:1541 msgid "Option Callbacks" msgstr "" -#: ../src/Doc/library/optparse.rst:1543 +#: library/optparse.rst:1543 msgid "" "When :mod:`optparse`'s built-in actions and types aren't quite enough for " "your needs, you have two choices: extend :mod:`optparse` or define a " @@ -70440,25 +72079,25 @@ msgid "" "a lot of simple cases. Quite often a simple callback is all you need." msgstr "" -#: ../src/Doc/library/optparse.rst:1548 +#: library/optparse.rst:1548 msgid "There are two steps to defining a callback option:" msgstr "" -#: ../src/Doc/library/optparse.rst:1550 +#: library/optparse.rst:1550 msgid "define the option itself using the ``\"callback\"`` action" msgstr "" -#: ../src/Doc/library/optparse.rst:1552 +#: library/optparse.rst:1552 msgid "" "write the callback; this is a function (or method) that takes at least four " "arguments, as described below" msgstr "" -#: ../src/Doc/library/optparse.rst:1559 +#: library/optparse.rst:1559 msgid "Defining a callback option" msgstr "" -#: ../src/Doc/library/optparse.rst:1561 +#: library/optparse.rst:1561 msgid "" "As always, the easiest way to define a callback option is by using the :meth:" "`OptionParser.add_option` method. Apart from :attr:`~Option.action`, the " @@ -70467,7 +72106,7 @@ msgid "" msgstr "" # 6f76ff2f75e44667aa0381737102a364 -#: ../src/Doc/library/optparse.rst:1567 +#: library/optparse.rst:1567 msgid "" "``callback`` is a function (or other callable object), so you must have " "already defined ``my_callback()`` when you create this callback option. In " @@ -70479,7 +72118,7 @@ msgid "" "tricky; it's covered later in this section." msgstr "" -#: ../src/Doc/library/optparse.rst:1576 +#: library/optparse.rst:1576 msgid "" ":mod:`optparse` always passes four particular arguments to your callback, " "and it will only pass additional arguments if you specify them via :attr:" @@ -70487,22 +72126,17 @@ msgid "" "minimal callback function signature is::" msgstr "" -#: ../src/Doc/library/optparse.rst:1583 +#: library/optparse.rst:1583 msgid "The four arguments to a callback are described below." msgstr "" -#: ../src/Doc/library/optparse.rst:1585 +#: library/optparse.rst:1585 msgid "" "There are several other option attributes that you can supply when you " "define a callback option:" msgstr "" -# 03c5d2068afd42d1ae91374bc8c260dd -#: ../src/Doc/library/optparse.rst:1591 -msgid ":attr:`~Option.type`" -msgstr "" - -#: ../src/Doc/library/optparse.rst:1589 +#: library/optparse.rst:1589 msgid "" "has its usual meaning: as with the ``\"store\"`` or ``\"append\"`` actions, " "it instructs :mod:`optparse` to consume one argument and convert it to :attr:" @@ -70510,12 +72144,7 @@ msgid "" "though, :mod:`optparse` passes it to your callback function." msgstr "" -# afaee44b19a744138985e4867f593276 -#: ../src/Doc/library/optparse.rst:1597 -msgid ":attr:`~Option.nargs`" -msgstr "" - -#: ../src/Doc/library/optparse.rst:1595 +#: library/optparse.rst:1595 msgid "" "also has its usual meaning: if it is supplied and > 1, :mod:`optparse` will " "consume :attr:`~Option.nargs` arguments, each of which must be convertible " @@ -70523,48 +72152,40 @@ msgid "" "callback." msgstr "" -# b0c9ab5d98db498b9b56b34c2f079a87 -#: ../src/Doc/library/optparse.rst:1600 -msgid ":attr:`~Option.callback_args`" +#: library/optparse.rst:1601 +msgid "callback_args" msgstr "" -#: ../src/Doc/library/optparse.rst:1601 +#: library/optparse.rst:1601 msgid "a tuple of extra positional arguments to pass to the callback" msgstr "" -# 95449bff1f0c4cc280f59ed6590bca7f -#: ../src/Doc/library/optparse.rst:1604 -msgid ":attr:`~Option.callback_kwargs`" +#: library/optparse.rst:1605 +msgid "callback_kwargs" msgstr "" -#: ../src/Doc/library/optparse.rst:1604 +#: library/optparse.rst:1604 msgid "a dictionary of extra keyword arguments to pass to the callback" msgstr "" -#: ../src/Doc/library/optparse.rst:1610 +#: library/optparse.rst:1610 msgid "How callbacks are called" msgstr "" -#: ../src/Doc/library/optparse.rst:1612 +#: library/optparse.rst:1612 msgid "All callbacks are called as follows::" msgstr "" -# f3868273e34c436c9c546cea3a93521d -#: ../src/Doc/library/optparse.rst:1618 -msgid "``option``" -msgstr "" - -#: ../src/Doc/library/optparse.rst:1619 +#: library/optparse.rst:1619 msgid "is the Option instance that's calling the callback" msgstr "" -# d83b437f7ec941abab52f8f9608f71ff -#: ../src/Doc/library/optparse.rst:1625 -msgid "``opt_str``" +#: library/optparse.rst:1626 +msgid "opt_str" msgstr "" # c5c74aa983f74d03b9b3e59267b032cd -#: ../src/Doc/library/optparse.rst:1622 +#: library/optparse.rst:1622 msgid "" "is the option string seen on the command-line that's triggering the " "callback. (If an abbreviated long option was used, ``opt_str`` will be the " @@ -70573,12 +72194,11 @@ msgid "" "\"--foobar\"``.)" msgstr "" -# eae5e74e63b240068c0fc2e9badd5aa9 -#: ../src/Doc/library/optparse.rst:1632 -msgid "``value``" -msgstr "" +#: library/optparse.rst:1633 library/ttk.rst:585 +msgid "value" +msgstr "valeur" -#: ../src/Doc/library/optparse.rst:1629 +#: library/optparse.rst:1629 msgid "" "is the argument to this option seen on the command-line. :mod:`optparse` " "will only expect an argument if :attr:`~Option.type` is set; the type of " @@ -70588,23 +72208,21 @@ msgid "" "of values of the appropriate type." msgstr "" -# f8878409e1ab449b827f483ecd99e6e0 -#: ../src/Doc/library/optparse.rst:1655 -msgid "``parser``" +#: library/optparse.rst:1656 +msgid "parser" msgstr "" -#: ../src/Doc/library/optparse.rst:1636 +#: library/optparse.rst:1636 msgid "" "is the OptionParser instance driving the whole thing, mainly useful because " "you can access some other interesting data through its instance attributes:" msgstr "" -# 55b89765513d469d9ddea7125e0b9833 -#: ../src/Doc/library/optparse.rst:1642 -msgid "``parser.largs``" +#: library/optparse.rst:1643 +msgid "parser.largs" msgstr "" -#: ../src/Doc/library/optparse.rst:1640 +#: library/optparse.rst:1640 msgid "" "the current list of leftover arguments, ie. arguments that have been " "consumed but are neither options nor option arguments. Feel free to modify " @@ -70612,24 +72230,23 @@ msgid "" "become ``args``, the second return value of :meth:`parse_args`.)" msgstr "" -# ece5ddec2f344d5fa2c015a838e1274e -#: ../src/Doc/library/optparse.rst:1648 -msgid "``parser.rargs``" +#: library/optparse.rst:1649 +msgid "parser.rargs" msgstr "" -#: ../src/Doc/library/optparse.rst:1646 +#: library/optparse.rst:1646 msgid "" "the current list of remaining arguments, ie. with ``opt_str`` and ``value`` " "(if applicable) removed, and only the arguments following them still there. " "Feel free to modify ``parser.rargs``, e.g. by consuming more arguments." msgstr "" -# 97062b86cce04edfbc34f79564351cf0 -#: ../src/Doc/library/optparse.rst:1655 -msgid "``parser.values``" -msgstr "" +#: library/optparse.rst:1656 +#, fuzzy +msgid "parser.values" +msgstr "valeur" -#: ../src/Doc/library/optparse.rst:1652 +#: library/optparse.rst:1652 msgid "" "the object where option values are by default stored (an instance of " "optparse.OptionValues). This lets callbacks use the same mechanism as the " @@ -70638,28 +72255,27 @@ msgid "" "of any options already encountered on the command-line." msgstr "" -#: ../src/Doc/library/optparse.rst:1659 +#: library/optparse.rst:1659 msgid "" "is a tuple of arbitrary positional arguments supplied via the :attr:`~Option." "callback_args` option attribute." msgstr "" -# 0d93e8d4cbde46a387525c538bd621b3 -#: ../src/Doc/library/optparse.rst:1664 -msgid "``kwargs``" +#: library/optparse.rst:1665 +msgid "kwargs" msgstr "" -#: ../src/Doc/library/optparse.rst:1663 +#: library/optparse.rst:1663 msgid "" "is a dictionary of arbitrary keyword arguments supplied via :attr:`~Option." "callback_kwargs`." msgstr "" -#: ../src/Doc/library/optparse.rst:1670 +#: library/optparse.rst:1670 msgid "Raising errors in a callback" msgstr "" -#: ../src/Doc/library/optparse.rst:1672 +#: library/optparse.rst:1672 msgid "" "The callback function should raise :exc:`OptionValueError` if there are any " "problems with the option or its argument(s). :mod:`optparse` catches this " @@ -70669,48 +72285,48 @@ msgid "" "he did wrong." msgstr "" -#: ../src/Doc/library/optparse.rst:1682 +#: library/optparse.rst:1682 msgid "Callback example 1: trivial callback" msgstr "" -#: ../src/Doc/library/optparse.rst:1684 +#: library/optparse.rst:1684 msgid "" "Here's an example of a callback option that takes no arguments, and simply " "records that the option was seen::" msgstr "" -#: ../src/Doc/library/optparse.rst:1692 +#: library/optparse.rst:1692 msgid "Of course, you could do that with the ``\"store_true\"`` action." msgstr "" -#: ../src/Doc/library/optparse.rst:1698 +#: library/optparse.rst:1698 msgid "Callback example 2: check option order" msgstr "" # 07da18bd9b6547b5ab408afcb7631538 -#: ../src/Doc/library/optparse.rst:1700 +#: library/optparse.rst:1700 msgid "" "Here's a slightly more interesting example: record the fact that ``-a`` is " "seen, but blow up if it comes after ``-b`` in the command-line. ::" msgstr "" -#: ../src/Doc/library/optparse.rst:1715 +#: library/optparse.rst:1715 msgid "Callback example 3: check option order (generalized)" msgstr "" # a8cd3ad4adec40cfbca688f014b0d8d8 -#: ../src/Doc/library/optparse.rst:1717 +#: library/optparse.rst:1717 msgid "" "If you want to re-use this callback for several similar options (set a flag, " "but blow up if ``-b`` has already been seen), it needs a bit of work: the " "error message and the flag that it sets must be generalized. ::" msgstr "" -#: ../src/Doc/library/optparse.rst:1734 +#: library/optparse.rst:1734 msgid "Callback example 4: check arbitrary condition" msgstr "" -#: ../src/Doc/library/optparse.rst:1736 +#: library/optparse.rst:1736 msgid "" "Of course, you could put any condition in there---you're not limited to " "checking the values of already-defined options. For example, if you have " @@ -70718,16 +72334,16 @@ msgid "" "is this::" msgstr "" -#: ../src/Doc/library/optparse.rst:1749 +#: library/optparse.rst:1749 msgid "" "(The definition of ``is_moon_full()`` is left as an exercise for the reader.)" msgstr "" -#: ../src/Doc/library/optparse.rst:1755 +#: library/optparse.rst:1755 msgid "Callback example 5: fixed arguments" msgstr "" -#: ../src/Doc/library/optparse.rst:1757 +#: library/optparse.rst:1757 msgid "" "Things get slightly more interesting when you define callback options that " "take a fixed number of arguments. Specifying that a callback option takes " @@ -70737,24 +72353,24 @@ msgid "" "nargs`, then the option takes :attr:`~Option.nargs` arguments." msgstr "" -#: ../src/Doc/library/optparse.rst:1764 +#: library/optparse.rst:1764 msgid "" "Here's an example that just emulates the standard ``\"store\"`` action::" msgstr "" -#: ../src/Doc/library/optparse.rst:1773 +#: library/optparse.rst:1773 msgid "" "Note that :mod:`optparse` takes care of consuming 3 arguments and converting " "them to integers for you; all you have to do is store them. (Or whatever; " "obviously you don't need a callback for this example.)" msgstr "" -#: ../src/Doc/library/optparse.rst:1781 +#: library/optparse.rst:1781 msgid "Callback example 6: variable arguments" msgstr "" # c9d97ab9df2c449daa24fc322f88d113 -#: ../src/Doc/library/optparse.rst:1783 +#: library/optparse.rst:1783 msgid "" "Things get hairy when you want an option to take a variable number of " "arguments. For this case, you must write a callback, as :mod:`optparse` " @@ -70765,25 +72381,25 @@ msgid "" msgstr "" # 5c31b41cf506476bb974db5d23917594 -#: ../src/Doc/library/optparse.rst:1790 +#: library/optparse.rst:1790 msgid "either ``--`` or ``-`` can be option arguments" msgstr "" # 5aeb091820c94d3198bfed4a679f5211 -#: ../src/Doc/library/optparse.rst:1792 +#: library/optparse.rst:1792 msgid "" "bare ``--`` (if not the argument to some option): halt command-line " "processing and discard the ``--``" msgstr "" # 1e3e951e138c439e8a728c0b62971af6 -#: ../src/Doc/library/optparse.rst:1795 +#: library/optparse.rst:1795 msgid "" "bare ``-`` (if not the argument to some option): halt command-line " "processing but keep the ``-`` (append it to ``parser.largs``)" msgstr "" -#: ../src/Doc/library/optparse.rst:1798 +#: library/optparse.rst:1798 msgid "" "If you want an option that takes a variable number of arguments, there are " "several subtle, tricky issues to worry about. The exact implementation you " @@ -70792,28 +72408,28 @@ msgid "" "directly)." msgstr "" -#: ../src/Doc/library/optparse.rst:1804 +#: library/optparse.rst:1804 msgid "" "Nevertheless, here's a stab at a callback for an option with variable " "arguments::" msgstr "" -#: ../src/Doc/library/optparse.rst:1838 +#: library/optparse.rst:1838 msgid "Extending :mod:`optparse`" msgstr "" -#: ../src/Doc/library/optparse.rst:1840 +#: library/optparse.rst:1840 msgid "" "Since the two major controlling factors in how :mod:`optparse` interprets " "command-line options are the action and type of each option, the most likely " "direction of extension is to add new actions and new types." msgstr "" -#: ../src/Doc/library/optparse.rst:1848 +#: library/optparse.rst:1848 msgid "Adding new types" msgstr "" -#: ../src/Doc/library/optparse.rst:1850 +#: library/optparse.rst:1850 msgid "" "To add new types, you need to define your own subclass of :mod:`optparse`'s :" "class:`Option` class. This class has a couple of attributes that define :" @@ -70821,20 +72437,20 @@ msgid "" "TYPE_CHECKER`." msgstr "" -#: ../src/Doc/library/optparse.rst:1856 +#: library/optparse.rst:1856 msgid "" "A tuple of type names; in your subclass, simply define a new tuple :attr:" "`TYPES` that builds on the standard one." msgstr "" -#: ../src/Doc/library/optparse.rst:1861 +#: library/optparse.rst:1861 msgid "" "A dictionary mapping type names to type-checking functions. A type-checking " "function has the following signature::" msgstr "" # 15444ee8c06f46c9bdf6465b5fbfe25c -#: ../src/Doc/library/optparse.rst:1866 +#: library/optparse.rst:1866 msgid "" "where ``option`` is an :class:`Option` instance, ``opt`` is an option string " "(e.g., ``-f``), and ``value`` is the string from the command line that must " @@ -70845,7 +72461,7 @@ msgid "" "``value`` parameter." msgstr "" -#: ../src/Doc/library/optparse.rst:1874 +#: library/optparse.rst:1874 msgid "" "Your type-checking function should raise :exc:`OptionValueError` if it " "encounters any problems. :exc:`OptionValueError` takes a single string " @@ -70854,7 +72470,7 @@ msgid "" "\"`` and prints everything to stderr before terminating the process." msgstr "" -#: ../src/Doc/library/optparse.rst:1880 +#: library/optparse.rst:1880 msgid "" "Here's a silly example that demonstrates adding a ``\"complex\"`` option " "type to parse Python-style complex numbers on the command line. (This is " @@ -70862,21 +72478,21 @@ msgid "" "support for complex numbers, but never mind.)" msgstr "" -#: ../src/Doc/library/optparse.rst:1885 +#: library/optparse.rst:1885 msgid "First, the necessary imports::" msgstr "" -#: ../src/Doc/library/optparse.rst:1890 +#: library/optparse.rst:1890 msgid "" "You need to define your type-checker first, since it's referred to later (in " "the :attr:`~Option.TYPE_CHECKER` class attribute of your Option subclass)::" msgstr "" -#: ../src/Doc/library/optparse.rst:1900 +#: library/optparse.rst:1900 msgid "Finally, the Option subclass::" msgstr "" -#: ../src/Doc/library/optparse.rst:1907 +#: library/optparse.rst:1907 msgid "" "(If we didn't make a :func:`copy` of :attr:`Option.TYPE_CHECKER`, we would " "end up modifying the :attr:`~Option.TYPE_CHECKER` attribute of :mod:" @@ -70884,36 +72500,36 @@ msgid "" "that except good manners and common sense.)" msgstr "" -#: ../src/Doc/library/optparse.rst:1912 +#: library/optparse.rst:1912 msgid "" "That's it! Now you can write a script that uses the new option type just " "like any other :mod:`optparse`\\ -based script, except you have to instruct " "your OptionParser to use MyOption instead of Option::" msgstr "" -#: ../src/Doc/library/optparse.rst:1919 +#: library/optparse.rst:1919 msgid "" "Alternately, you can build your own option list and pass it to OptionParser; " "if you don't use :meth:`add_option` in the above way, you don't need to tell " "OptionParser which option class to use::" msgstr "" -#: ../src/Doc/library/optparse.rst:1930 +#: library/optparse.rst:1930 msgid "Adding new actions" msgstr "" -#: ../src/Doc/library/optparse.rst:1932 +#: library/optparse.rst:1932 msgid "" "Adding new actions is a bit trickier, because you have to understand that :" "mod:`optparse` has a couple of classifications for actions:" msgstr "" # e80a6af24e334468aad3cc01842871d5 -#: ../src/Doc/library/optparse.rst:1937 +#: library/optparse.rst:1938 msgid "\"store\" actions" msgstr "" -#: ../src/Doc/library/optparse.rst:1936 +#: library/optparse.rst:1936 msgid "" "actions that result in :mod:`optparse` storing a value to an attribute of " "the current OptionValues instance; these options require a :attr:`~Option." @@ -70921,11 +72537,11 @@ msgid "" msgstr "" # 458798eed88243979d18d3533bfd9028 -#: ../src/Doc/library/optparse.rst:1943 +#: library/optparse.rst:1944 msgid "\"typed\" actions" msgstr "" -#: ../src/Doc/library/optparse.rst:1941 +#: library/optparse.rst:1941 msgid "" "actions that take a value from the command line and expect it to be of a " "certain type; or rather, a string that can be converted to a certain type. " @@ -70933,7 +72549,7 @@ msgid "" "constructor." msgstr "" -#: ../src/Doc/library/optparse.rst:1946 +#: library/optparse.rst:1946 msgid "" "These are overlapping sets: some default \"store\" actions are ``\"store" "\"``, ``\"store_const\"``, ``\"append\"``, and ``\"count\"``, while the " @@ -70941,25 +72557,25 @@ msgid "" "\"``." msgstr "" -#: ../src/Doc/library/optparse.rst:1950 +#: library/optparse.rst:1950 msgid "" "When you add an action, you need to categorize it by listing it in at least " "one of the following class attributes of Option (all are lists of strings):" msgstr "" -#: ../src/Doc/library/optparse.rst:1955 +#: library/optparse.rst:1955 msgid "All actions must be listed in ACTIONS." msgstr "" -#: ../src/Doc/library/optparse.rst:1959 +#: library/optparse.rst:1959 msgid "\"store\" actions are additionally listed here." msgstr "" -#: ../src/Doc/library/optparse.rst:1963 +#: library/optparse.rst:1963 msgid "\"typed\" actions are additionally listed here." msgstr "" -#: ../src/Doc/library/optparse.rst:1967 +#: library/optparse.rst:1967 msgid "" "Actions that always take a type (i.e. whose options always take a value) are " "additionally listed here. The only effect of this is that :mod:`optparse` " @@ -70967,14 +72583,14 @@ msgid "" "whose action is listed in :attr:`ALWAYS_TYPED_ACTIONS`." msgstr "" -#: ../src/Doc/library/optparse.rst:1972 +#: library/optparse.rst:1972 msgid "" "In order to actually implement your new action, you must override Option's :" "meth:`take_action` method and add a case that recognizes your action." msgstr "" # ad1cfab7d6314c96840af978884d17ac -#: ../src/Doc/library/optparse.rst:1975 +#: library/optparse.rst:1975 msgid "" "For example, let's add an ``\"extend\"`` action. This is similar to the " "standard ``\"append\"`` action, but instead of taking a single value from " @@ -70984,47 +72600,47 @@ msgid "" "option of type ``\"string\"``, the command line ::" msgstr "" -#: ../src/Doc/library/optparse.rst:1984 +#: library/optparse.rst:1984 msgid "would result in a list ::" msgstr "" -#: ../src/Doc/library/optparse.rst:1988 +#: library/optparse.rst:1988 msgid "Again we define a subclass of Option::" msgstr "" -#: ../src/Doc/library/optparse.rst:2005 +#: library/optparse.rst:2005 msgid "Features of note:" msgstr "" -#: ../src/Doc/library/optparse.rst:2007 +#: library/optparse.rst:2007 msgid "" "``\"extend\"`` both expects a value on the command-line and stores that " "value somewhere, so it goes in both :attr:`~Option.STORE_ACTIONS` and :attr:" "`~Option.TYPED_ACTIONS`." msgstr "" -#: ../src/Doc/library/optparse.rst:2011 +#: library/optparse.rst:2011 msgid "" "to ensure that :mod:`optparse` assigns the default type of ``\"string\"`` to " "``\"extend\"`` actions, we put the ``\"extend\"`` action in :attr:`~Option." "ALWAYS_TYPED_ACTIONS` as well." msgstr "" -#: ../src/Doc/library/optparse.rst:2015 +#: library/optparse.rst:2015 msgid "" ":meth:`MyOption.take_action` implements just this one new action, and passes " "control back to :meth:`Option.take_action` for the standard :mod:`optparse` " "actions." msgstr "" -#: ../src/Doc/library/optparse.rst:2019 +#: library/optparse.rst:2019 msgid "" "``values`` is an instance of the optparse_parser.Values class, which " "provides the very useful :meth:`ensure_value` method. :meth:`ensure_value` " "is essentially :func:`getattr` with a safety valve; it is called as ::" msgstr "" -#: ../src/Doc/library/optparse.rst:2025 +#: library/optparse.rst:2025 msgid "" "If the ``attr`` attribute of ``values`` doesn't exist or is None, then " "ensure_value() first sets it to ``value``, and then returns 'value. This is " @@ -71037,11 +72653,11 @@ msgid "" "will take care of getting it right when it's needed." msgstr "" -#: ../src/Doc/library/os.rst:2 +#: library/os.rst:2 msgid ":mod:`os` --- Miscellaneous operating system interfaces" msgstr "" -#: ../src/Doc/library/os.rst:8 +#: library/os.rst:8 msgid "" "This module provides a portable way of using operating system dependent " "functionality. If you just want to read or write a file see :func:`open`, " @@ -71052,11 +72668,11 @@ msgid "" "the :mod:`shutil` module." msgstr "" -#: ../src/Doc/library/os.rst:16 +#: library/os.rst:16 msgid "Notes on the availability of these functions:" msgstr "" -#: ../src/Doc/library/os.rst:18 +#: library/os.rst:18 msgid "" "The design of all built-in operating system dependent modules of Python is " "such that as long as the same functionality is available, it uses the same " @@ -71065,72 +72681,78 @@ msgid "" "originated with the POSIX interface)." msgstr "" -#: ../src/Doc/library/os.rst:24 +#: library/os.rst:24 msgid "" "Extensions peculiar to a particular operating system are also available " "through the :mod:`os` module, but using them is of course a threat to " "portability." msgstr "" -#: ../src/Doc/library/os.rst:28 +#: library/os.rst:28 msgid "" "An \"Availability: Unix\" note means that this function is commonly found on " "Unix systems. It does not make any claims about its existence on a specific " "operating system." msgstr "" -#: ../src/Doc/library/os.rst:32 +#: library/os.rst:32 msgid "" "If not separately noted, all functions that claim \"Availability: Unix\" are " "supported on Mac OS X, which builds on a Unix core." msgstr "" -#: ../src/Doc/library/os.rst:40 +#: library/os.rst:40 msgid "" "All functions in this module raise :exc:`OSError` in the case of invalid or " "inaccessible file names and paths, or other arguments that have the correct " "type, but are not accepted by the operating system." msgstr "" -#: ../src/Doc/library/os.rst:47 +#: library/os.rst:47 msgid "An alias for the built-in :exc:`OSError` exception." msgstr "" # 1d788e85b35742f4a129b87b993b1651 -#: ../src/Doc/library/os.rst:52 +#: library/os.rst:52 msgid "" "The name of the operating system dependent module imported. The following " "names have currently been registered: ``'posix'``, ``'nt'``, ``'os2'``, " "``'ce'``, ``'java'``, ``'riscos'``." msgstr "" +#: library/os.rst:57 +msgid "" +":attr:`sys.platform` has a finer granularity. :func:`os.uname` gives system-" +"dependent version information." +msgstr "" + # 0310e343177044d3a2cfcbcfd9da49dd # 10ce47c9f3de4438a46ece5aaa14dba3 -#: ../src/Doc/library/os.rst:60 ../src/Doc/library/sys.rst:772 +#: library/os.rst:60 library/sys.rst:772 msgid "" "The :mod:`platform` module provides detailed checks for the system's " "identity." msgstr "" -#: ../src/Doc/library/os.rst:67 +#: library/os.rst:67 msgid "Process Parameters" msgstr "" -#: ../src/Doc/library/os.rst:69 +#: library/os.rst:69 msgid "" "These functions and data items provide information and operate on the " "current process and user." msgstr "" # 0df87afbb65d4089875a0ab235195c11 -#: ../src/Doc/library/os.rst:75 +#: library/os.rst:75 msgid "" "A :term:`mapping` object representing the string environment. For example, " "``environ['HOME']`` is the pathname of your home directory (on some " "platforms), and is equivalent to ``getenv(\"HOME\")`` in C." msgstr "" -#: ../src/Doc/library/os.rst:79 +#: library/os.rst:79 msgid "" "This mapping is captured the first time the :mod:`os` module is imported, " "typically during Python startup as part of processing :file:`site.py`. " @@ -71138,34 +72760,34 @@ msgid "" "environ``, except for changes made by modifying ``os.environ`` directly." msgstr "" -#: ../src/Doc/library/os.rst:84 +#: library/os.rst:84 msgid "" "If the platform supports the :func:`putenv` function, this mapping may be " "used to modify the environment as well as query the environment. :func:" "`putenv` will be called automatically when the mapping is modified." msgstr "" -#: ../src/Doc/library/os.rst:90 +#: library/os.rst:90 msgid "" "Calling :func:`putenv` directly does not change ``os.environ``, so it's " "better to modify ``os.environ``." msgstr "" # d0ca61fb54f34cbf90043497d45b28aa -#: ../src/Doc/library/os.rst:95 +#: library/os.rst:95 msgid "" "On some platforms, including FreeBSD and Mac OS X, setting ``environ`` may " "cause memory leaks. Refer to the system documentation for :c:func:`putenv`." msgstr "" -#: ../src/Doc/library/os.rst:99 +#: library/os.rst:99 msgid "" "If :func:`putenv` is not provided, a modified copy of this mapping may be " "passed to the appropriate process-creation functions to cause child " "processes to use a modified environment." msgstr "" -#: ../src/Doc/library/os.rst:103 +#: library/os.rst:103 msgid "" "If the platform supports the :func:`unsetenv` function, you can delete items " "in this mapping to unset environment variables. :func:`unsetenv` will be " @@ -71173,84 +72795,72 @@ msgid "" "one of the :meth:`pop` or :meth:`clear` methods is called." msgstr "" -#: ../src/Doc/library/os.rst:118 +#: library/os.rst:108 +msgid "" +"Also unset environment variables when calling :meth:`os.environ.clear` and :" +"meth:`os.environ.pop`." +msgstr "" + +#: library/os.rst:118 msgid "These functions are described in :ref:`os-file-dir`." msgstr "" -#: ../src/Doc/library/os.rst:123 +#: library/os.rst:123 msgid "" "Return the filename corresponding to the controlling terminal of the process." msgstr "" -#: ../src/Doc/library/os.rst:125 ../src/Doc/library/os.rst:133 -#: ../src/Doc/library/os.rst:142 ../src/Doc/library/os.rst:151 -#: ../src/Doc/library/os.rst:158 ../src/Doc/library/os.rst:183 -#: ../src/Doc/library/os.rst:196 ../src/Doc/library/os.rst:204 -#: ../src/Doc/library/os.rst:215 ../src/Doc/library/os.rst:233 -#: ../src/Doc/library/os.rst:241 ../src/Doc/library/os.rst:251 -#: ../src/Doc/library/os.rst:262 ../src/Doc/library/os.rst:298 -#: ../src/Doc/library/os.rst:305 ../src/Doc/library/os.rst:312 -#: ../src/Doc/library/os.rst:321 ../src/Doc/library/os.rst:335 -#: ../src/Doc/library/os.rst:344 ../src/Doc/library/os.rst:351 -#: ../src/Doc/library/os.rst:358 ../src/Doc/library/os.rst:367 -#: ../src/Doc/library/os.rst:376 ../src/Doc/library/os.rst:383 -#: ../src/Doc/library/os.rst:392 ../src/Doc/library/os.rst:401 -#: ../src/Doc/library/os.rst:659 ../src/Doc/library/os.rst:669 -#: ../src/Doc/library/os.rst:679 ../src/Doc/library/os.rst:700 -#: ../src/Doc/library/os.rst:715 ../src/Doc/library/os.rst:735 -#: ../src/Doc/library/os.rst:830 ../src/Doc/library/os.rst:838 -#: ../src/Doc/library/os.rst:847 ../src/Doc/library/os.rst:1012 -#: ../src/Doc/library/os.rst:1051 ../src/Doc/library/os.rst:1106 -#: ../src/Doc/library/os.rst:1114 ../src/Doc/library/os.rst:1125 -#: ../src/Doc/library/os.rst:1135 ../src/Doc/library/os.rst:1144 -#: ../src/Doc/library/os.rst:1176 ../src/Doc/library/os.rst:1273 -#: ../src/Doc/library/os.rst:1294 ../src/Doc/library/os.rst:1492 -#: ../src/Doc/library/os.rst:1502 ../src/Doc/library/os.rst:1773 -#: ../src/Doc/library/os.rst:1783 ../src/Doc/library/os.rst:1792 -#: ../src/Doc/library/os.rst:1801 ../src/Doc/library/os.rst:1810 -#: ../src/Doc/library/os.rst:1819 ../src/Doc/library/os.rst:1828 -#: ../src/Doc/library/os.rst:1837 ../src/Doc/library/os.rst:1847 -#: ../src/Doc/library/os.rst:1857 ../src/Doc/library/os.rst:1866 -#: ../src/Doc/library/os.rst:1875 ../src/Doc/library/os.rst:1886 -#: ../src/Doc/library/os.rst:1896 ../src/Doc/library/os.rst:1906 -#: ../src/Doc/library/os.rst:1915 ../src/Doc/library/os.rst:1924 -#: ../src/Doc/library/os.rst:1941 ../src/Doc/library/os.rst:1983 -#: ../src/Doc/library/os.rst:1992 ../src/Doc/library/os.rst:2000 -#: ../src/Doc/library/os.rst:2198 ../src/Doc/library/os.rst:2238 -#: ../src/Doc/library/os.rst:2251 ../src/Doc/library/os.rst:2261 -#: ../src/Doc/library/os.rst:2279 ../src/Doc/library/os.rst:2293 -#: ../src/Doc/library/os.rst:2303 ../src/Doc/library/os.rst:2313 -#: ../src/Doc/library/os.rst:2321 ../src/Doc/library/os.rst:2329 -#: ../src/Doc/library/os.rst:2337 ../src/Doc/library/os.rst:2344 -#: ../src/Doc/library/os.rst:2351 ../src/Doc/library/os.rst:2387 -#: ../src/Doc/library/os.rst:2396 ../src/Doc/library/os.rst:2408 -#: ../src/Doc/library/os.rst:2417 ../src/Doc/library/os.path.rst:262 -#: ../src/Doc/library/os.path.rst:269 ../src/Doc/library/os.path.rst:279 -#: ../src/Doc/library/time.rst:470 +#: library/os.rst:125 library/os.rst:133 library/os.rst:142 library/os.rst:151 +#: library/os.rst:158 library/os.rst:183 library/os.rst:196 library/os.rst:204 +#: library/os.rst:215 library/os.rst:233 library/os.rst:241 library/os.rst:251 +#: library/os.rst:262 library/os.rst:298 library/os.rst:305 library/os.rst:312 +#: library/os.rst:321 library/os.rst:335 library/os.rst:344 library/os.rst:351 +#: library/os.rst:358 library/os.rst:367 library/os.rst:376 library/os.rst:383 +#: library/os.rst:392 library/os.rst:401 library/os.rst:659 library/os.rst:669 +#: library/os.rst:679 library/os.rst:700 library/os.rst:715 library/os.rst:735 +#: library/os.rst:830 library/os.rst:838 library/os.rst:847 library/os.rst:1012 +#: library/os.rst:1051 library/os.rst:1106 library/os.rst:1114 +#: library/os.rst:1125 library/os.rst:1135 library/os.rst:1144 +#: library/os.rst:1176 library/os.rst:1273 library/os.rst:1294 +#: library/os.rst:1492 library/os.rst:1502 library/os.rst:1773 +#: library/os.rst:1783 library/os.rst:1792 library/os.rst:1801 +#: library/os.rst:1810 library/os.rst:1819 library/os.rst:1828 +#: library/os.rst:1837 library/os.rst:1847 library/os.rst:1857 +#: library/os.rst:1866 library/os.rst:1875 library/os.rst:1886 +#: library/os.rst:1896 library/os.rst:1906 library/os.rst:1915 +#: library/os.rst:1924 library/os.rst:1941 library/os.rst:1983 +#: library/os.rst:1992 library/os.rst:2000 library/os.rst:2198 +#: library/os.rst:2238 library/os.rst:2251 library/os.rst:2261 +#: library/os.rst:2279 library/os.rst:2293 library/os.rst:2303 +#: library/os.rst:2313 library/os.rst:2321 library/os.rst:2329 +#: library/os.rst:2337 library/os.rst:2344 library/os.rst:2351 +#: library/os.rst:2387 library/os.rst:2396 library/os.rst:2408 +#: library/os.rst:2417 library/os.path.rst:262 library/os.path.rst:269 +#: library/os.path.rst:279 library/time.rst:469 msgid "Availability: Unix." msgstr "" -#: ../src/Doc/library/os.rst:130 +#: library/os.rst:130 msgid "" "Return the effective group id of the current process. This corresponds to " "the \"set id\" bit on the file being executed in the current process." msgstr "" -#: ../src/Doc/library/os.rst:140 +#: library/os.rst:140 msgid "Return the current process's effective user id." msgstr "" -#: ../src/Doc/library/os.rst:149 +#: library/os.rst:149 msgid "Return the real group id of the current process." msgstr "" -#: ../src/Doc/library/os.rst:156 +#: library/os.rst:156 msgid "" "Return list of supplemental group ids associated with the current process." msgstr "" # 080fc0dcc5ec4bed972f3c5041c736d1 -#: ../src/Doc/library/os.rst:162 +#: library/os.rst:162 msgid "" "On Mac OS X, :func:`getgroups` behavior differs somewhat from other Unix " "platforms. If the Python interpreter was built with a deployment target of :" @@ -71267,7 +72877,7 @@ msgid "" "get_config_var`." msgstr "" -#: ../src/Doc/library/os.rst:179 +#: library/os.rst:179 msgid "" "Call the system initgroups() to initialize the group access list with all of " "the groups of which the specified username is a member, plus the specified " @@ -71275,7 +72885,7 @@ msgid "" msgstr "" # b59826da7ea44d1fae669e6afc73293c -#: ../src/Doc/library/os.rst:190 +#: library/os.rst:190 msgid "" "Return the name of the user logged in on the controlling terminal of the " "process. For most purposes, it is more useful to use the environment " @@ -71283,92 +72893,83 @@ msgid "" "getuid())[0]`` to get the login name of the process's real user id." msgstr "" -#: ../src/Doc/library/os.rst:201 +#: library/os.rst:201 msgid "" "Return the process group id of the process with process id *pid*. If *pid* " "is 0, the process group id of the current process is returned." msgstr "" -#: ../src/Doc/library/os.rst:213 +#: library/os.rst:213 msgid "Return the id of the current process group." msgstr "" -#: ../src/Doc/library/os.rst:222 +#: library/os.rst:222 msgid "Return the current process id." msgstr "" -#: ../src/Doc/library/os.rst:224 ../src/Doc/library/os.rst:411 -#: ../src/Doc/library/os.rst:418 ../src/Doc/library/os.rst:470 -#: ../src/Doc/library/os.rst:493 ../src/Doc/library/os.rst:512 -#: ../src/Doc/library/os.rst:550 ../src/Doc/library/os.rst:564 -#: ../src/Doc/library/os.rst:578 ../src/Doc/library/os.rst:614 -#: ../src/Doc/library/os.rst:635 ../src/Doc/library/os.rst:644 -#: ../src/Doc/library/os.rst:651 ../src/Doc/library/os.rst:707 -#: ../src/Doc/library/os.rst:752 ../src/Doc/library/os.rst:779 -#: ../src/Doc/library/os.rst:805 ../src/Doc/library/os.rst:814 -#: ../src/Doc/library/os.rst:855 ../src/Doc/library/os.rst:938 -#: ../src/Doc/library/os.rst:1003 ../src/Doc/library/os.rst:1021 -#: ../src/Doc/library/os.rst:1028 ../src/Doc/library/os.rst:1091 -#: ../src/Doc/library/os.rst:1154 ../src/Doc/library/os.rst:1232 -#: ../src/Doc/library/os.rst:1306 ../src/Doc/library/os.rst:1336 -#: ../src/Doc/library/os.rst:1360 ../src/Doc/library/os.rst:1439 -#: ../src/Doc/library/os.rst:1523 ../src/Doc/library/os.rst:1558 -#: ../src/Doc/library/os.rst:1577 ../src/Doc/library/os.rst:1694 -#: ../src/Doc/library/os.rst:1743 ../src/Doc/library/os.rst:1751 -#: ../src/Doc/library/os.rst:2088 ../src/Doc/library/os.rst:2101 -#: ../src/Doc/library/os.rst:2175 +#: library/os.rst:224 library/os.rst:411 library/os.rst:418 library/os.rst:470 +#: library/os.rst:493 library/os.rst:512 library/os.rst:550 library/os.rst:564 +#: library/os.rst:578 library/os.rst:614 library/os.rst:635 library/os.rst:644 +#: library/os.rst:651 library/os.rst:707 library/os.rst:752 library/os.rst:779 +#: library/os.rst:805 library/os.rst:814 library/os.rst:855 library/os.rst:938 +#: library/os.rst:1003 library/os.rst:1021 library/os.rst:1028 +#: library/os.rst:1091 library/os.rst:1154 library/os.rst:1232 +#: library/os.rst:1306 library/os.rst:1336 library/os.rst:1360 +#: library/os.rst:1439 library/os.rst:1523 library/os.rst:1558 +#: library/os.rst:1577 library/os.rst:1694 library/os.rst:1743 +#: library/os.rst:1751 library/os.rst:2088 library/os.rst:2101 +#: library/os.rst:2175 msgid "Availability: Unix, Windows." msgstr "" -#: ../src/Doc/library/os.rst:231 +#: library/os.rst:231 msgid "Return the parent's process id." msgstr "" -#: ../src/Doc/library/os.rst:238 +#: library/os.rst:238 msgid "" "Return a tuple (ruid, euid, suid) denoting the current process's real, " "effective, and saved user ids." msgstr "" # 194ef79063db430d8e7bcfd351fa6024 -#: ../src/Doc/library/os.rst:248 +#: library/os.rst:248 msgid "" "Return a tuple (rgid, egid, sgid) denoting the current process's real, " "effective, and saved group ids." msgstr "" # 0a70f18d5ed341879908a6d10ffa4655 -#: ../src/Doc/library/os.rst:260 +#: library/os.rst:260 msgid "Return the current process's real user id." msgstr "" # 5f63d7dbc25745a3a3d6969a434fa5f1 -#: ../src/Doc/library/os.rst:267 +#: library/os.rst:267 msgid "" "Return the value of the environment variable *varname* if it exists, or " "*value* if it doesn't. *value* defaults to ``None``." msgstr "" -#: ../src/Doc/library/os.rst:270 ../src/Doc/library/os.rst:281 -#: ../src/Doc/library/os.rst:450 +#: library/os.rst:270 library/os.rst:281 library/os.rst:450 msgid "Availability: most flavors of Unix, Windows." msgstr "" # 934fbc3a2e6b4f9db542bbc401fa3a83 -#: ../src/Doc/library/os.rst:277 +#: library/os.rst:277 msgid "" "Set the environment variable named *varname* to the string *value*. Such " "changes to the environment affect subprocesses started with :func:`os." "system`, :func:`popen` or :func:`fork` and :func:`execv`." msgstr "" -#: ../src/Doc/library/os.rst:285 +#: library/os.rst:285 msgid "" "On some platforms, including FreeBSD and Mac OS X, setting ``environ`` may " "cause memory leaks. Refer to the system documentation for putenv." msgstr "" -#: ../src/Doc/library/os.rst:288 +#: library/os.rst:288 msgid "" "When :func:`putenv` is supported, assignments to items in ``os.environ`` are " "automatically translated into corresponding calls to :func:`putenv`; " @@ -71376,19 +72977,19 @@ msgid "" "actually preferable to assign to items of ``os.environ``." msgstr "" -#: ../src/Doc/library/os.rst:296 +#: library/os.rst:296 msgid "Set the current process's effective group id." msgstr "" -#: ../src/Doc/library/os.rst:303 +#: library/os.rst:303 msgid "Set the current process's effective user id." msgstr "" -#: ../src/Doc/library/os.rst:310 +#: library/os.rst:310 msgid "Set the current process' group id." msgstr "" -#: ../src/Doc/library/os.rst:317 +#: library/os.rst:317 msgid "" "Set the list of supplemental group ids associated with the current process " "to *groups*. *groups* must be a sequence, and each element must be an " @@ -71397,7 +72998,7 @@ msgid "" msgstr "" # 13af0d74739d4bb9b16bbc003160a56c -#: ../src/Doc/library/os.rst:325 +#: library/os.rst:325 msgid "" "On Mac OS X, the length of *groups* may not exceed the system-defined " "maximum number of effective group ids, typically 16. See the documentation " @@ -71406,7 +73007,7 @@ msgid "" msgstr "" # cefb02d1c124441ab8dff3e3354acde8 -#: ../src/Doc/library/os.rst:332 +#: library/os.rst:332 msgid "" "Call the system call :c:func:`setpgrp` or :c:func:`setpgrp(0, 0)` depending " "on which version is implemented (if any). See the Unix manual for the " @@ -71414,60 +73015,60 @@ msgid "" msgstr "" # 12b5af1866de4b40972c6015581f6bd2 -#: ../src/Doc/library/os.rst:340 +#: library/os.rst:340 msgid "" "Call the system call :c:func:`setpgid` to set the process group id of the " "process with id *pid* to the process group with id *pgrp*. See the Unix " "manual for the semantics." msgstr "" -#: ../src/Doc/library/os.rst:349 +#: library/os.rst:349 msgid "Set the current process's real and effective group ids." msgstr "" -#: ../src/Doc/library/os.rst:356 +#: library/os.rst:356 msgid "Set the current process's real, effective, and saved group ids." msgstr "" -#: ../src/Doc/library/os.rst:365 +#: library/os.rst:365 msgid "Set the current process's real, effective, and saved user ids." msgstr "" -#: ../src/Doc/library/os.rst:374 +#: library/os.rst:374 msgid "Set the current process's real and effective user ids." msgstr "" # 71c8c97c264a47179fcb8890d89589fb -#: ../src/Doc/library/os.rst:381 +#: library/os.rst:381 msgid "" "Call the system call :c:func:`getsid`. See the Unix manual for the " "semantics." msgstr "" # b47723c971b94f93b0b6a0ea851e7c73 -#: ../src/Doc/library/os.rst:390 +#: library/os.rst:390 msgid "" "Call the system call :c:func:`setsid`. See the Unix manual for the " "semantics." msgstr "" -#: ../src/Doc/library/os.rst:399 +#: library/os.rst:399 msgid "Set the current process's user id." msgstr "" # 2add7bb87b1b4c40b72d5988bdc29aac -#: ../src/Doc/library/os.rst:407 +#: library/os.rst:407 msgid "" "Return the error message corresponding to the error code in *code*. On " "platforms where :c:func:`strerror` returns ``NULL`` when given an unknown " "error number, :exc:`ValueError` is raised." msgstr "" -#: ../src/Doc/library/os.rst:416 +#: library/os.rst:416 msgid "Set the current numeric umask and return the previous umask." msgstr "" -#: ../src/Doc/library/os.rst:427 +#: library/os.rst:427 msgid "" "Return a 5-tuple containing information identifying the current operating " "system. The tuple contains 5 strings: ``(sysname, nodename, release, " @@ -71476,19 +73077,19 @@ msgid "" "gethostname` or even ``socket.gethostbyaddr(socket.gethostname())``." msgstr "" -#: ../src/Doc/library/os.rst:434 +#: library/os.rst:434 msgid "Availability: recent flavors of Unix." msgstr "" # 651c1c5559424bb7ab0ec37165b64b9b -#: ../src/Doc/library/os.rst:441 +#: library/os.rst:441 msgid "" "Unset (delete) the environment variable named *varname*. Such changes to the " "environment affect subprocesses started with :func:`os.system`, :func:" "`popen` or :func:`fork` and :func:`execv`." msgstr "" -#: ../src/Doc/library/os.rst:445 +#: library/os.rst:445 msgid "" "When :func:`unsetenv` is supported, deletion of items in ``os.environ`` is " "automatically translated into a corresponding call to :func:`unsetenv`; " @@ -71496,16 +73097,16 @@ msgid "" "actually preferable to delete items of ``os.environ``." msgstr "" -#: ../src/Doc/library/os.rst:456 +#: library/os.rst:456 msgid "File Object Creation" msgstr "" -#: ../src/Doc/library/os.rst:458 +#: library/os.rst:458 msgid "These functions create new file objects. (See also :func:`open`.)" msgstr "" # f095af6952fb4946a6ec67cd8528843e -#: ../src/Doc/library/os.rst:465 +#: library/os.rst:465 msgid "" "Return an open file object connected to the file descriptor *fd*. The " "*mode* and *bufsize* arguments have the same meaning as the corresponding " @@ -71513,8 +73114,21 @@ msgid "" "an exception, it leaves *fd* untouched (unclosed)." msgstr "" +#: library/os.rst:472 +msgid "" +"When specified, the *mode* argument must now start with one of the letters " +"``'r'``, ``'w'``, or ``'a'``, otherwise a :exc:`ValueError` is raised." +msgstr "" + +#: library/os.rst:476 +msgid "" +"On Unix, when the *mode* argument starts with ``'a'``, the *O_APPEND* flag " +"is set on the file descriptor (which the :c:func:`fdopen` implementation " +"already does on most platforms)." +msgstr "" + # 89e6d2c062dc46fd8a904b55b7c15e61 -#: ../src/Doc/library/os.rst:484 +#: library/os.rst:484 msgid "" "Open a pipe to or from *command*. The return value is an open file object " "connected to the pipe, which can be read or written depending on whether " @@ -71526,8 +73140,22 @@ msgid "" "(termination without errors), ``None`` is returned." msgstr "" +#: library/os.rst:495 library/os.rst:546 library/os.rst:560 library/os.rst:574 +msgid "" +"This function is obsolete. Use the :mod:`subprocess` module. Check " +"especially the :ref:`subprocess-replacements` section." +msgstr "" + +#: library/os.rst:499 +msgid "" +"This function worked unreliably under Windows in earlier versions of Python. " +"This was due to the use of the :c:func:`_popen` function from the libraries " +"provided with Windows. Newer versions of Python do not use the broken " +"implementation from the Windows libraries." +msgstr "" + # a179e78bf7534d5dadc5f87e66a04346 -#: ../src/Doc/library/os.rst:508 +#: library/os.rst:508 msgid "" "Return a new file object opened in update mode (``w+b``). The file has no " "directory entries associated with it and will be automatically deleted once " @@ -71535,14 +73163,20 @@ msgid "" msgstr "" # 028e5fe85409425f9d49870a5fec9072 -#: ../src/Doc/library/os.rst:514 +#: library/os.rst:514 msgid "" "There are a number of different :func:`popen\\*` functions that provide " "slightly different ways to create subprocesses." msgstr "" +#: library/os.rst:517 +msgid "" +"All of the :func:`popen\\*` functions are obsolete. Use the :mod:" +"`subprocess` module." +msgstr "" + # 1da805975cca4c3e97fe1d27c70ed8d0 -#: ../src/Doc/library/os.rst:521 +#: library/os.rst:521 msgid "" "For each of the :func:`popen\\*` variants, if *bufsize* is specified, it " "specifies the buffer size for the I/O pipes. *mode*, if provided, should be " @@ -71552,7 +73186,7 @@ msgid "" msgstr "" # 8a8139ebb5714127987b82a134dc8dbc -#: ../src/Doc/library/os.rst:527 +#: library/os.rst:527 msgid "" "Also, for each of these variants, on Unix, *cmd* may be a sequence, in which " "case arguments will be passed directly to the program without shell " @@ -71561,7 +73195,7 @@ msgid "" msgstr "" # 52571dbbaafc42499b6145a46d07d0f3 -#: ../src/Doc/library/os.rst:532 +#: library/os.rst:532 msgid "" "These methods do not make it possible to retrieve the exit status from the " "child processes. The only way to control the input and output streams and " @@ -71570,35 +73204,35 @@ msgid "" msgstr "" # 8a19f3e1a798454b94ef9fe707db60fd -#: ../src/Doc/library/os.rst:537 +#: library/os.rst:537 msgid "" "For a discussion of possible deadlock conditions related to the use of these " "functions, see :ref:`popen2-flow-control`." msgstr "" # 2f70f6ab20f9475ea5a2d4612e343efa -#: ../src/Doc/library/os.rst:543 +#: library/os.rst:543 msgid "" "Execute *cmd* as a sub-process and return the file objects ``(child_stdin, " "child_stdout)``." msgstr "" # 37b984c9ea704ee3ae0f671cae9c114c -#: ../src/Doc/library/os.rst:557 +#: library/os.rst:557 msgid "" "Execute *cmd* as a sub-process and return the file objects ``(child_stdin, " "child_stdout, child_stderr)``." msgstr "" # 8afbb1725d5a47538563533a1ed1f79f -#: ../src/Doc/library/os.rst:571 +#: library/os.rst:571 msgid "" "Execute *cmd* as a sub-process and return the file objects ``(child_stdin, " "child_stdout_and_stderr)``." msgstr "" # 8e80dda07247401e8b9ec0df1db3113e -#: ../src/Doc/library/os.rst:582 +#: library/os.rst:582 msgid "" "(Note that ``child_stdin, child_stdout, and child_stderr`` are named from " "the point of view of the child process, so *child_stdin* is the child's " @@ -71606,23 +73240,23 @@ msgid "" msgstr "" # bc164dafa96f4675879a6e74830b8b81 -#: ../src/Doc/library/os.rst:586 +#: library/os.rst:586 msgid "" "This functionality is also available in the :mod:`popen2` module using " "functions of the same names, but the return values of those functions have a " "different order." msgstr "" -#: ../src/Doc/library/os.rst:594 +#: library/os.rst:594 msgid "File Descriptor Operations" msgstr "" -#: ../src/Doc/library/os.rst:596 +#: library/os.rst:596 msgid "" "These functions operate on I/O streams referenced using file descriptors." msgstr "" -#: ../src/Doc/library/os.rst:598 +#: library/os.rst:598 msgid "" "File descriptors are small integers corresponding to a file that has been " "opened by the current process. For example, standard input is usually file " @@ -71632,7 +73266,7 @@ msgid "" "pipes are also referenced by file descriptors." msgstr "" -#: ../src/Doc/library/os.rst:605 +#: library/os.rst:605 msgid "" "The :meth:`~file.fileno` method can be used to obtain the file descriptor " "associated with a file object when required. Note that using the file " @@ -71640,12 +73274,12 @@ msgid "" "such as internal buffering of data." msgstr "" -#: ../src/Doc/library/os.rst:612 +#: library/os.rst:612 msgid "Close file descriptor *fd*." msgstr "" # 00dde9762988491d9715682cf1b11a92 -#: ../src/Doc/library/os.rst:618 +#: library/os.rst:618 msgid "" "This function is intended for low-level I/O and must be applied to a file " "descriptor as returned by :func:`os.open` or :func:`pipe`. To close a " @@ -71653,45 +73287,45 @@ msgid "" "`popen` or :func:`fdopen`, use its :meth:`~io.IOBase.close` method." msgstr "" -#: ../src/Doc/library/os.rst:626 +#: library/os.rst:626 msgid "" "Close all file descriptors from *fd_low* (inclusive) to *fd_high* " "(exclusive), ignoring errors. Equivalent to::" msgstr "" -#: ../src/Doc/library/os.rst:642 +#: library/os.rst:642 msgid "Return a duplicate of file descriptor *fd*." msgstr "" -#: ../src/Doc/library/os.rst:649 +#: library/os.rst:649 msgid "" "Duplicate file descriptor *fd* to *fd2*, closing the latter first if " "necessary." msgstr "" -#: ../src/Doc/library/os.rst:656 +#: library/os.rst:656 msgid "" "Change the mode of the file given by *fd* to the numeric *mode*. See the " "docs for :func:`chmod` for possible values of *mode*." msgstr "" -#: ../src/Doc/library/os.rst:666 +#: library/os.rst:666 msgid "" "Change the owner and group id of the file given by *fd* to the numeric *uid* " "and *gid*. To leave one of the ids unchanged, set it to -1." msgstr "" -#: ../src/Doc/library/os.rst:676 +#: library/os.rst:676 msgid "" "Force write of file with filedescriptor *fd* to disk. Does not force update " "of metadata." msgstr "" -#: ../src/Doc/library/os.rst:682 +#: library/os.rst:682 msgid "This function is not available on MacOS." msgstr "" -#: ../src/Doc/library/os.rst:687 +#: library/os.rst:687 msgid "" "Return system configuration information relevant to an open file. *name* " "specifies the configuration value to retrieve; it may be a string which is " @@ -71702,7 +73336,7 @@ msgid "" "included in that mapping, passing an integer for *name* is also accepted." msgstr "" -#: ../src/Doc/library/os.rst:695 ../src/Doc/library/os.rst:1268 +#: library/os.rst:695 library/os.rst:1268 msgid "" "If *name* is a string and is not known, :exc:`ValueError` is raised. If a " "specific value for *name* is not supported by the host system, even if it is " @@ -71711,25 +73345,25 @@ msgid "" msgstr "" # 3138207ade0b43c39853f2ca79d9bf36 -#: ../src/Doc/library/os.rst:705 +#: library/os.rst:705 msgid "Return status for file descriptor *fd*, like :func:`~os.stat`." msgstr "" -#: ../src/Doc/library/os.rst:712 +#: library/os.rst:712 msgid "" "Return information about the filesystem containing the file associated with " "file descriptor *fd*, like :func:`statvfs`." msgstr "" # ae01e30ebac744979d6d14f2280814db -#: ../src/Doc/library/os.rst:720 +#: library/os.rst:720 msgid "" "Force write of file with filedescriptor *fd* to disk. On Unix, this calls " "the native :c:func:`fsync` function; on Windows, the MS :c:func:`_commit` " "function." msgstr "" -#: ../src/Doc/library/os.rst:723 +#: library/os.rst:723 msgid "" "If you're starting with a Python file object *f*, first do ``f.flush()``, " "and then do ``os.fsync(f.fileno())``, to ensure that all internal buffers " @@ -71737,24 +73371,24 @@ msgid "" msgstr "" # 7f287aab60284b30ba7422a41d22fbbe -#: ../src/Doc/library/os.rst:727 +#: library/os.rst:727 msgid "Availability: Unix, and Windows starting in 2.2.3." msgstr "" -#: ../src/Doc/library/os.rst:732 +#: library/os.rst:732 msgid "" "Truncate the file corresponding to file descriptor *fd*, so that it is at " "most *length* bytes in size." msgstr "" -#: ../src/Doc/library/os.rst:740 +#: library/os.rst:740 msgid "" "Return ``True`` if the file descriptor *fd* is open and connected to a tty(-" "like) device, else ``False``." msgstr "" # 8b03b45e02eb4db1b43e30a9c50731e4 -#: ../src/Doc/library/os.rst:746 +#: library/os.rst:746 msgid "" "Set the current position of file descriptor *fd* to position *pos*, modified " "by *how*: :const:`SEEK_SET` or ``0`` to set the position relative to the " @@ -71765,19 +73399,19 @@ msgid "" msgstr "" # b897cc5c8b9247faba0d7a3e649fe9ba -#: ../src/Doc/library/os.rst:759 +#: library/os.rst:759 msgid "" "Parameters to the :func:`lseek` function. Their values are 0, 1, and 2, " "respectively." msgstr "" # 68bfd74eae2749d4a612e75d0e2ad91c -#: ../src/Doc/library/os.rst:762 +#: library/os.rst:762 msgid "Availability: Windows, Unix." msgstr "" # edaf1e0addbb4289a07e85a18dd3dbad -#: ../src/Doc/library/os.rst:769 +#: library/os.rst:769 msgid "" "Open the file *file* and set various flags according to *flags* and possibly " "its mode according to *mode*. The default *mode* is ``0777`` (octal), and " @@ -71785,7 +73419,7 @@ msgid "" "the newly opened file." msgstr "" -#: ../src/Doc/library/os.rst:774 +#: library/os.rst:774 msgid "" "For a description of the flag and mode values, see the C run-time " "documentation; flag constants (like :const:`O_RDONLY` and :const:`O_WRONLY`) " @@ -71794,7 +73428,7 @@ msgid "" msgstr "" # 3601b38f93a44babb1f662e21c7fa972 -#: ../src/Doc/library/os.rst:783 +#: library/os.rst:783 msgid "" "This function is intended for low-level I/O. For normal usage, use the " "built-in function :func:`open`, which returns a \"file object\" with :meth:" @@ -71802,32 +73436,32 @@ msgid "" "file descriptor in a \"file object\", use :func:`fdopen`." msgstr "" -#: ../src/Doc/library/os.rst:793 +#: library/os.rst:793 msgid "" "Open a new pseudo-terminal pair. Return a pair of file descriptors " "``(master, slave)`` for the pty and the tty, respectively. For a (slightly) " "more portable approach, use the :mod:`pty` module." msgstr "" -#: ../src/Doc/library/os.rst:797 ../src/Doc/library/os.rst:1952 +#: library/os.rst:797 library/os.rst:1952 msgid "Availability: some flavors of Unix." msgstr "" -#: ../src/Doc/library/os.rst:802 +#: library/os.rst:802 msgid "" "Create a pipe. Return a pair of file descriptors ``(r, w)`` usable for " "reading and writing, respectively." msgstr "" # 6c74549e8bdd48f4bfb361d57d1bcf37 -#: ../src/Doc/library/os.rst:810 +#: library/os.rst:810 msgid "" "Read at most *n* bytes from file descriptor *fd*. Return a string containing " "the bytes read. If the end of the file referred to by *fd* has been " "reached, an empty string is returned." msgstr "" -#: ../src/Doc/library/os.rst:818 +#: library/os.rst:818 msgid "" "This function is intended for low-level I/O and must be applied to a file " "descriptor as returned by :func:`os.open` or :func:`pipe`. To read a \"file " @@ -71836,19 +73470,19 @@ msgid "" "`~file.readline` methods." msgstr "" -#: ../src/Doc/library/os.rst:827 +#: library/os.rst:827 msgid "" "Return the process group associated with the terminal given by *fd* (an open " "file descriptor as returned by :func:`os.open`)." msgstr "" -#: ../src/Doc/library/os.rst:835 +#: library/os.rst:835 msgid "" "Set the process group associated with the terminal given by *fd* (an open " "file descriptor as returned by :func:`os.open`) to *pg*." msgstr "" -#: ../src/Doc/library/os.rst:843 +#: library/os.rst:843 msgid "" "Return a string which specifies the terminal device associated with file " "descriptor *fd*. If *fd* is not associated with a terminal device, an " @@ -71856,13 +73490,13 @@ msgid "" msgstr "" # 8a0693730c634bac9ec945aa01cd5ed2 -#: ../src/Doc/library/os.rst:852 +#: library/os.rst:852 msgid "" "Write the string *str* to file descriptor *fd*. Return the number of bytes " "actually written." msgstr "" -#: ../src/Doc/library/os.rst:859 +#: library/os.rst:859 msgid "" "This function is intended for low-level I/O and must be applied to a file " "descriptor as returned by :func:`os.open` or :func:`pipe`. To write a " @@ -71871,11 +73505,11 @@ msgid "" "its :meth:`~file.write` method." msgstr "" -#: ../src/Doc/library/os.rst:869 +#: library/os.rst:869 msgid "``open()`` flag constants" msgstr "" -#: ../src/Doc/library/os.rst:871 +#: library/os.rst:871 msgid "" "The following constants are options for the *flags* parameter to the :func:" "`~os.open` function. They can be combined using the bitwise OR operator ``|" @@ -71885,29 +73519,29 @@ msgid "" "on Windows." msgstr "" -#: ../src/Doc/library/os.rst:886 +#: library/os.rst:886 msgid "These constants are available on Unix and Windows." msgstr "" -#: ../src/Doc/library/os.rst:898 +#: library/os.rst:898 msgid "These constants are only available on Unix." msgstr "" -#: ../src/Doc/library/os.rst:909 +#: library/os.rst:909 msgid "These constants are only available on Windows." msgstr "" -#: ../src/Doc/library/os.rst:918 +#: library/os.rst:918 msgid "" "These constants are GNU extensions and not present if they are not defined " "by the C library." msgstr "" -#: ../src/Doc/library/os.rst:925 +#: library/os.rst:925 msgid "Files and Directories" msgstr "" -#: ../src/Doc/library/os.rst:929 +#: library/os.rst:929 msgid "" "Use the real uid/gid to test for access to *path*. Note that most " "operations will use the effective uid/gid, therefore this routine can be " @@ -71920,7 +73554,7 @@ msgid "" msgstr "" # d3665067af184a15acf0c81a9eb34e16 -#: ../src/Doc/library/os.rst:942 +#: library/os.rst:942 msgid "" "Using :func:`access` to check if a user is authorized to e.g. open a file " "before actually doing so using :func:`open` creates a security hole, because " @@ -71930,62 +73564,62 @@ msgid "" msgstr "" # 2b5b4c86e15c4c8f97caa65410c7c92d -#: ../src/Doc/library/os.rst:953 +#: library/os.rst:953 msgid "is better written as::" msgstr "" -#: ../src/Doc/library/os.rst:968 +#: library/os.rst:968 msgid "" "I/O operations may fail even when :func:`access` indicates that they would " "succeed, particularly for operations on network filesystems which may have " "permissions semantics beyond the usual POSIX permission-bit model." msgstr "" -#: ../src/Doc/library/os.rst:975 +#: library/os.rst:975 msgid "" "Value to pass as the *mode* parameter of :func:`access` to test the " "existence of *path*." msgstr "" -#: ../src/Doc/library/os.rst:981 +#: library/os.rst:981 msgid "" "Value to include in the *mode* parameter of :func:`access` to test the " "readability of *path*." msgstr "" -#: ../src/Doc/library/os.rst:987 +#: library/os.rst:987 msgid "" "Value to include in the *mode* parameter of :func:`access` to test the " "writability of *path*." msgstr "" -#: ../src/Doc/library/os.rst:993 +#: library/os.rst:993 msgid "" "Value to include in the *mode* parameter of :func:`access` to determine if " "*path* can be executed." msgstr "" -#: ../src/Doc/library/os.rst:1001 +#: library/os.rst:1001 msgid "Change the current working directory to *path*." msgstr "" -#: ../src/Doc/library/os.rst:1008 +#: library/os.rst:1008 msgid "" "Change the current working directory to the directory represented by the " "file descriptor *fd*. The descriptor must refer to an opened directory, not " "an open file." msgstr "" -#: ../src/Doc/library/os.rst:1019 +#: library/os.rst:1019 msgid "Return a string representing the current working directory." msgstr "" # b8929f8bfcce48f58b15bdd4db01b9c2 -#: ../src/Doc/library/os.rst:1026 +#: library/os.rst:1026 msgid "Return a Unicode object representing the current working directory." msgstr "" -#: ../src/Doc/library/os.rst:1035 +#: library/os.rst:1035 msgid "" "Set the flags of *path* to the numeric *flags*. *flags* may take a " "combination (bitwise OR) of the following values (as defined in the :mod:" @@ -71993,199 +73627,206 @@ msgid "" msgstr "" # 823d8192a8af4fe597d16d56c40bdb65 -#: ../src/Doc/library/os.rst:1038 +#: library/os.rst:1038 msgid ":data:`stat.UF_NODUMP`" msgstr "" # b023ff2aa30741d6b23dc6f988560e94 -#: ../src/Doc/library/os.rst:1039 +#: library/os.rst:1039 msgid ":data:`stat.UF_IMMUTABLE`" msgstr "" # 9ca5a39ae1e14a8bb04d3c90631ee4d6 -#: ../src/Doc/library/os.rst:1040 +#: library/os.rst:1040 msgid ":data:`stat.UF_APPEND`" msgstr "" # 1244b440c4394963897e9a9ccf3f3617 -#: ../src/Doc/library/os.rst:1041 +#: library/os.rst:1041 msgid ":data:`stat.UF_OPAQUE`" msgstr "" # de52ffc970d1439baf143e2fbb7e2555 -#: ../src/Doc/library/os.rst:1042 +#: library/os.rst:1042 msgid ":data:`stat.UF_NOUNLINK`" msgstr "" # 0445518aeb6443388dee2796d205e2d1 -#: ../src/Doc/library/os.rst:1043 +#: library/os.rst:1043 msgid ":data:`stat.UF_COMPRESSED`" msgstr "" # 7d0fedc91d4349748af0784de7546efa -#: ../src/Doc/library/os.rst:1044 +#: library/os.rst:1044 msgid ":data:`stat.UF_HIDDEN`" msgstr "" # da4f2f84c7a646829fa1ab5ed33e54b5 -#: ../src/Doc/library/os.rst:1045 +#: library/os.rst:1045 msgid ":data:`stat.SF_ARCHIVED`" msgstr "" # b706bbf7da5546a4a2ddaf64938f0348 -#: ../src/Doc/library/os.rst:1046 +#: library/os.rst:1046 msgid ":data:`stat.SF_IMMUTABLE`" msgstr "" # 2cc694e93b374e0bbc61a44d222fa0d0 -#: ../src/Doc/library/os.rst:1047 +#: library/os.rst:1047 msgid ":data:`stat.SF_APPEND`" msgstr "" # c07b6eae7a964b98ace2f1ae85eaab1f -#: ../src/Doc/library/os.rst:1048 +#: library/os.rst:1048 msgid ":data:`stat.SF_NOUNLINK`" msgstr "" # b46cf7b281e840c2bd46482b013ea83f -#: ../src/Doc/library/os.rst:1049 +#: library/os.rst:1049 msgid ":data:`stat.SF_SNAPSHOT`" msgstr "" -#: ../src/Doc/library/os.rst:1058 +#: library/os.rst:1058 msgid "" "Change the root directory of the current process to *path*. Availability: " "Unix." msgstr "" -#: ../src/Doc/library/os.rst:1066 +#: library/os.rst:1066 msgid "" "Change the mode of *path* to the numeric *mode*. *mode* may take one of the " "following values (as defined in the :mod:`stat` module) or bitwise ORed " "combinations of them:" msgstr "" -#: ../src/Doc/library/os.rst:1071 +#: library/os.rst:1071 msgid ":data:`stat.S_ISUID`" msgstr "" -#: ../src/Doc/library/os.rst:1072 +#: library/os.rst:1072 msgid ":data:`stat.S_ISGID`" msgstr "" -#: ../src/Doc/library/os.rst:1073 +#: library/os.rst:1073 msgid ":data:`stat.S_ENFMT`" msgstr "" -#: ../src/Doc/library/os.rst:1074 +#: library/os.rst:1074 msgid ":data:`stat.S_ISVTX`" msgstr "" -#: ../src/Doc/library/os.rst:1075 +#: library/os.rst:1075 msgid ":data:`stat.S_IREAD`" msgstr "" -#: ../src/Doc/library/os.rst:1076 +#: library/os.rst:1076 msgid ":data:`stat.S_IWRITE`" msgstr "" -#: ../src/Doc/library/os.rst:1077 +#: library/os.rst:1077 msgid ":data:`stat.S_IEXEC`" msgstr "" -#: ../src/Doc/library/os.rst:1078 +#: library/os.rst:1078 msgid ":data:`stat.S_IRWXU`" msgstr "" -#: ../src/Doc/library/os.rst:1079 +#: library/os.rst:1079 msgid ":data:`stat.S_IRUSR`" msgstr "" -#: ../src/Doc/library/os.rst:1080 +#: library/os.rst:1080 msgid ":data:`stat.S_IWUSR`" msgstr "" -#: ../src/Doc/library/os.rst:1081 +#: library/os.rst:1081 msgid ":data:`stat.S_IXUSR`" msgstr "" -#: ../src/Doc/library/os.rst:1082 +#: library/os.rst:1082 msgid ":data:`stat.S_IRWXG`" msgstr "" -#: ../src/Doc/library/os.rst:1083 +#: library/os.rst:1083 msgid ":data:`stat.S_IRGRP`" msgstr "" -#: ../src/Doc/library/os.rst:1084 +#: library/os.rst:1084 msgid ":data:`stat.S_IWGRP`" msgstr "" -#: ../src/Doc/library/os.rst:1085 +#: library/os.rst:1085 msgid ":data:`stat.S_IXGRP`" msgstr "" -#: ../src/Doc/library/os.rst:1086 +#: library/os.rst:1086 msgid ":data:`stat.S_IRWXO`" msgstr "" -#: ../src/Doc/library/os.rst:1087 +#: library/os.rst:1087 msgid ":data:`stat.S_IROTH`" msgstr "" -#: ../src/Doc/library/os.rst:1088 +#: library/os.rst:1088 msgid ":data:`stat.S_IWOTH`" msgstr "" -#: ../src/Doc/library/os.rst:1089 +#: library/os.rst:1089 msgid ":data:`stat.S_IXOTH`" msgstr "" -#: ../src/Doc/library/os.rst:1095 +#: library/os.rst:1095 msgid "" "Although Windows supports :func:`chmod`, you can only set the file's read-" "only flag with it (via the ``stat.S_IWRITE`` and ``stat.S_IREAD`` constants " "or a corresponding integer value). All other bits are ignored." msgstr "" -#: ../src/Doc/library/os.rst:1103 +#: library/os.rst:1103 msgid "" "Change the owner and group id of *path* to the numeric *uid* and *gid*. To " "leave one of the ids unchanged, set it to -1." msgstr "" -#: ../src/Doc/library/os.rst:1111 +#: library/os.rst:1111 msgid "" "Set the flags of *path* to the numeric *flags*, like :func:`chflags`, but do " "not follow symbolic links." msgstr "" -#: ../src/Doc/library/os.rst:1121 +#: library/os.rst:1121 msgid "" "Change the mode of *path* to the numeric *mode*. If path is a symlink, this " "affects the symlink rather than the target. See the docs for :func:`chmod` " "for possible values of *mode*." msgstr "" -#: ../src/Doc/library/os.rst:1132 +#: library/os.rst:1132 msgid "" "Change the owner and group id of *path* to the numeric *uid* and *gid*. This " "function will not follow symbolic links." msgstr "" -#: ../src/Doc/library/os.rst:1142 +#: library/os.rst:1142 msgid "Create a hard link pointing to *source* named *link_name*." msgstr "" -#: ../src/Doc/library/os.rst:1149 +#: library/os.rst:1149 msgid "" "Return a list containing the names of the entries in the directory given by " "*path*. The list is in arbitrary order. It does not include the special " "entries ``'.'`` and ``'..'`` even if they are present in the directory." msgstr "" +#: library/os.rst:1156 +msgid "" +"On Windows NT/2k/XP and Unix, if *path* is a Unicode object, the result will " +"be a list of Unicode objects. Undecodable filenames will still be returned " +"as string objects." +msgstr "" + # 0e0e8bd261054f05aee3a1a844355dfb -#: ../src/Doc/library/os.rst:1164 +#: library/os.rst:1164 msgid "" "Perform the equivalent of an :c:func:`lstat` system call on the given path. " "Similar to :func:`~os.stat`, but does not follow symbolic links. On " @@ -72194,14 +73835,14 @@ msgid "" msgstr "" # 365f97efdeac44b4808be0a6d0dcb7a5 -#: ../src/Doc/library/os.rst:1172 +#: library/os.rst:1172 msgid "" "Create a FIFO (a named pipe) named *path* with numeric mode *mode*. The " "default *mode* is ``0666`` (octal). The current umask value is first masked " "out from the mode." msgstr "" -#: ../src/Doc/library/os.rst:1178 +#: library/os.rst:1178 msgid "" "FIFOs are pipes that can be accessed like regular files. FIFOs exist until " "they are deleted (for example with :func:`os.unlink`). Generally, FIFOs are " @@ -72212,7 +73853,7 @@ msgid "" msgstr "" # 89ff218248584a099af946e5d9598a4d -#: ../src/Doc/library/os.rst:1187 +#: library/os.rst:1187 msgid "" "Create a filesystem node (file, device special file or named pipe) named " "*filename*. *mode* specifies both the permissions to use and the type of " @@ -72224,25 +73865,25 @@ msgid "" msgstr "" # 63e1ca3148c44055aeb69bdd51472a38 -#: ../src/Doc/library/os.rst:1201 +#: library/os.rst:1201 msgid "" "Extract the device major number from a raw device number (usually the :attr:" "`st_dev` or :attr:`st_rdev` field from :c:type:`stat`)." msgstr "" # f568396b4dc54dbd840a2af17a3333b1 -#: ../src/Doc/library/os.rst:1209 +#: library/os.rst:1209 msgid "" "Extract the device minor number from a raw device number (usually the :attr:" "`st_dev` or :attr:`st_rdev` field from :c:type:`stat`)." msgstr "" -#: ../src/Doc/library/os.rst:1217 +#: library/os.rst:1217 msgid "Compose a raw device number from the major and minor device numbers." msgstr "" # b70fc7c0254d4228bc0b6087149c23b4 -#: ../src/Doc/library/os.rst:1224 +#: library/os.rst:1224 msgid "" "Create a directory named *path* with numeric mode *mode*. The default *mode* " "is ``0777`` (octal). On some systems, *mode* is ignored. Where it is used, " @@ -72250,14 +73891,14 @@ msgid "" "exists, :exc:`OSError` is raised." msgstr "" -#: ../src/Doc/library/os.rst:1229 +#: library/os.rst:1229 msgid "" "It is also possible to create temporary directories; see the :mod:`tempfile` " "module's :func:`tempfile.mkdtemp` function." msgstr "" # d644100a225e4f4f86b3a3132f23487d -#: ../src/Doc/library/os.rst:1241 +#: library/os.rst:1241 msgid "" "Recursive directory creation function. Like :func:`mkdir`, but makes all " "intermediate-level directories needed to contain the leaf directory. Raises " @@ -72266,13 +73907,17 @@ msgid "" "is ignored. Where it is used, the current umask value is first masked out." msgstr "" -#: ../src/Doc/library/os.rst:1249 +#: library/os.rst:1249 msgid "" ":func:`makedirs` will become confused if the path elements to create " "include :data:`os.pardir`." msgstr "" -#: ../src/Doc/library/os.rst:1260 +#: library/os.rst:1254 +msgid "This function now handles UNC paths correctly." +msgstr "" + +#: library/os.rst:1260 msgid "" "Return system configuration information relevant to a named file. *name* " "specifies the configuration value to retrieve; it may be a string which is " @@ -72283,7 +73928,7 @@ msgid "" "included in that mapping, passing an integer for *name* is also accepted." msgstr "" -#: ../src/Doc/library/os.rst:1278 +#: library/os.rst:1278 msgid "" "Dictionary mapping names accepted by :func:`pathconf` and :func:`fpathconf` " "to the integer values defined for those names by the host operating system. " @@ -72291,7 +73936,7 @@ msgid "" "Availability: Unix." msgstr "" -#: ../src/Doc/library/os.rst:1286 +#: library/os.rst:1286 msgid "" "Return a string representing the path to which the symbolic link points. " "The result may be either an absolute or relative pathname; if it is " @@ -72299,7 +73944,12 @@ msgid "" "join(os.path.dirname(path), result)``." msgstr "" -#: ../src/Doc/library/os.rst:1299 +#: library/os.rst:1291 +msgid "" +"If the *path* is a Unicode object the result will also be a Unicode object." +msgstr "" + +#: library/os.rst:1299 msgid "" "Remove (delete) the file *path*. If *path* is a directory, :exc:`OSError` " "is raised; see :func:`rmdir` below to remove a directory. This is identical " @@ -72309,7 +73959,7 @@ msgid "" "available until the original file is no longer in use." msgstr "" -#: ../src/Doc/library/os.rst:1313 +#: library/os.rst:1313 msgid "" "Remove directories recursively. Works like :func:`rmdir` except that, if " "the leaf directory is successfully removed, :func:`removedirs` tries to " @@ -72321,7 +73971,7 @@ msgid "" "could not be successfully removed." msgstr "" -#: ../src/Doc/library/os.rst:1327 +#: library/os.rst:1327 msgid "" "Rename the file or directory *src* to *dst*. If *dst* is a directory, :exc:" "`OSError` will be raised. On Unix, if *dst* exists and is a file, it will " @@ -72333,7 +73983,7 @@ msgid "" "rename when *dst* names an existing file." msgstr "" -#: ../src/Doc/library/os.rst:1341 +#: library/os.rst:1341 msgid "" "Recursive directory or file renaming function. Works like :func:`rename`, " "except creation of any intermediate directories needed to make the new " @@ -72342,13 +73992,13 @@ msgid "" "using :func:`removedirs`." msgstr "" -#: ../src/Doc/library/os.rst:1350 +#: library/os.rst:1350 msgid "" "This function can fail with the new directory structure made if you lack " "permissions needed to remove the leaf directory or file." msgstr "" -#: ../src/Doc/library/os.rst:1356 +#: library/os.rst:1356 msgid "" "Remove (delete) the directory *path*. Only works when the directory is " "empty, otherwise, :exc:`OSError` is raised. In order to remove whole " @@ -72356,137 +74006,144 @@ msgid "" msgstr "" # 204f7bf72a9f4423a3909cfcfb92c84a -#: ../src/Doc/library/os.rst:1365 +#: library/os.rst:1365 msgid "" "Perform the equivalent of a :c:func:`stat` system call on the given path. " "(This function follows symlinks; to stat a symlink use :func:`lstat`.)" msgstr "" # 7f61d408b1324c9cb077939183d14683 -#: ../src/Doc/library/os.rst:1368 +#: library/os.rst:1368 msgid "" "The return value is an object whose attributes correspond to the members of " "the :c:type:`stat` structure, namely:" msgstr "" # 968d7f67443140d7a71c13d69f0b79a0 -#: ../src/Doc/library/os.rst:1371 +#: library/os.rst:1371 msgid ":attr:`st_mode` - protection bits," msgstr "" # d1fbf670ff9a43eb9d9b1d442c9611dd -#: ../src/Doc/library/os.rst:1372 +#: library/os.rst:1372 msgid ":attr:`st_ino` - inode number," msgstr "" # b230d0bf724549edad83d79a23d8a597 -#: ../src/Doc/library/os.rst:1373 +#: library/os.rst:1373 msgid ":attr:`st_dev` - device," msgstr "" # e45cba0f5a454e2b9979d080071e99e3 -#: ../src/Doc/library/os.rst:1374 +#: library/os.rst:1374 msgid ":attr:`st_nlink` - number of hard links," msgstr "" # 12763519da664599a297adec8df0eae7 -#: ../src/Doc/library/os.rst:1375 +#: library/os.rst:1375 msgid ":attr:`st_uid` - user id of owner," msgstr "" # 38cc26da8ba2408ea22d7b4dacb331b2 -#: ../src/Doc/library/os.rst:1376 +#: library/os.rst:1376 msgid ":attr:`st_gid` - group id of owner," msgstr "" # 7c10c1284e2b45cd97677aa956f94e66 -#: ../src/Doc/library/os.rst:1377 +#: library/os.rst:1377 msgid ":attr:`st_size` - size of file, in bytes," msgstr "" # 3c8360781a5a419a95e57cfc88bb92b3 -#: ../src/Doc/library/os.rst:1378 +#: library/os.rst:1378 msgid ":attr:`st_atime` - time of most recent access," msgstr "" # 8e605e57df8a4984b6e895d3f35559e5 -#: ../src/Doc/library/os.rst:1379 +#: library/os.rst:1379 msgid ":attr:`st_mtime` - time of most recent content modification," msgstr "" # 58c26f96353a4508b0ca4781df960002 -#: ../src/Doc/library/os.rst:1380 +#: library/os.rst:1380 msgid "" ":attr:`st_ctime` - platform dependent; time of most recent metadata change " "on Unix, or the time of creation on Windows)" msgstr "" +#: library/os.rst:1383 +msgid "" +"If :func:`stat_float_times` returns ``True``, the time values are floats, " +"measuring seconds. Fractions of a second may be reported if the system " +"supports that. See :func:`stat_float_times` for further discussion." +msgstr "" + # 6bc559b41fbb42cdbd0d8a166e5d6bb8 -#: ../src/Doc/library/os.rst:1388 +#: library/os.rst:1388 msgid "" "On some Unix systems (such as Linux), the following attributes may also be " "available:" msgstr "" # 740e8d2bc2ce44aa9938f1a29e1dbdcb -#: ../src/Doc/library/os.rst:1391 +#: library/os.rst:1391 msgid ":attr:`st_blocks` - number of 512-byte blocks allocated for file" msgstr "" # 8f2c60755d824d40aa23c2ebeb539a68 -#: ../src/Doc/library/os.rst:1392 +#: library/os.rst:1392 msgid ":attr:`st_blksize` - filesystem blocksize for efficient file system I/O" msgstr "" # be267dedfb2f4ec2a31c27160b3919a5 -#: ../src/Doc/library/os.rst:1393 +#: library/os.rst:1393 msgid ":attr:`st_rdev` - type of device if an inode device" msgstr "" # 7c1f7fa059884fd5af7d307c83b8729f -#: ../src/Doc/library/os.rst:1394 +#: library/os.rst:1394 msgid ":attr:`st_flags` - user defined flags for file" msgstr "" # 1efde6efe39a44a2814d8e005f08afe3 -#: ../src/Doc/library/os.rst:1396 +#: library/os.rst:1396 msgid "" "On other Unix systems (such as FreeBSD), the following attributes may be " "available (but may be only filled out if root tries to use them):" msgstr "" # 841449e8a8bd40729fbf623853659cbf -#: ../src/Doc/library/os.rst:1399 +#: library/os.rst:1399 msgid ":attr:`st_gen` - file generation number" msgstr "" # 1ba8ee4972b64fa1ab8aea09b327328b -#: ../src/Doc/library/os.rst:1400 +#: library/os.rst:1400 msgid ":attr:`st_birthtime` - time of file creation" msgstr "" # 4fdacfed33614859afcc526b088b4ead -#: ../src/Doc/library/os.rst:1402 +#: library/os.rst:1402 msgid "On RISCOS systems, the following attributes are also available:" msgstr "" # d0b039df027e48f3bb7af09145f6e48d -#: ../src/Doc/library/os.rst:1404 +#: library/os.rst:1404 msgid ":attr:`st_ftype` (file type)" msgstr "" # 905252877caf49719db615bce72ac5b2 -#: ../src/Doc/library/os.rst:1405 +#: library/os.rst:1405 msgid ":attr:`st_attrs` (attributes)" msgstr "" # f2d2eddf00434c6895e86a23a41b9107 -#: ../src/Doc/library/os.rst:1406 +#: library/os.rst:1406 msgid ":attr:`st_obtype` (object type)." msgstr "" # 6e179481a2514bccb038bfc582a54fca -#: ../src/Doc/library/os.rst:1410 +#: library/os.rst:1410 msgid "" "The exact meaning and resolution of the :attr:`st_atime`, :attr:`st_mtime`, " "and :attr:`st_ctime` attributes depend on the operating system and the file " @@ -72496,7 +74153,7 @@ msgid "" msgstr "" # 60ce73fc656f4372b38a7005155e0696 -#: ../src/Doc/library/os.rst:1417 +#: library/os.rst:1417 msgid "" "For backward compatibility, the return value of :func:`~os.stat` is also " "accessible as a tuple of at least 10 integers giving the most important (and " @@ -72508,15 +74165,23 @@ msgid "" msgstr "" # a66a8863115a45cdbfe65112494dc21d -#: ../src/Doc/library/os.rst:1426 +#: library/os.rst:1426 msgid "" "The standard module :mod:`stat` defines functions and constants that are " "useful for extracting information from a :c:type:`stat` structure. (On " "Windows, some items are filled with dummy values.)" msgstr "" +#: library/os.rst:1441 library/os.rst:1494 library/resource.rst:219 +msgid "Added access to values as attributes of the returned object." +msgstr "" + +#: library/os.rst:1444 +msgid "Added :attr:`st_gen` and :attr:`st_birthtime`." +msgstr "" + # fd0e0e1cb37b4865b8c7ed6edcc9d7d9 -#: ../src/Doc/library/os.rst:1450 +#: library/os.rst:1450 msgid "" "Determine whether :class:`stat_result` represents time stamps as float " "objects. If *newvalue* is ``True``, future calls to :func:`~os.stat` return " @@ -72524,20 +74189,27 @@ msgid "" "omitted, return the current setting." msgstr "" -#: ../src/Doc/library/os.rst:1455 +#: library/os.rst:1455 msgid "" "For compatibility with older Python versions, accessing :class:`stat_result` " "as a tuple always returns integers." msgstr "" -#: ../src/Doc/library/os.rst:1463 +#: library/os.rst:1458 +msgid "" +"Python now returns float values by default. Applications which do not work " +"correctly with floating point time stamps can use this function to restore " +"the old behaviour." +msgstr "" + +#: library/os.rst:1463 msgid "" "The resolution of the timestamps (that is the smallest possible fraction) " "depends on the system. Some systems only support second resolution; on these " "systems, the fraction will always be zero." msgstr "" -#: ../src/Doc/library/os.rst:1467 +#: library/os.rst:1467 msgid "" "It is recommended that this setting is only changed at program startup time " "in the *__main__* module; libraries should never change this setting. If an " @@ -72547,7 +74219,7 @@ msgid "" msgstr "" # 71fb2e52d91249a2af8e9bcff3346076 -#: ../src/Doc/library/os.rst:1476 +#: library/os.rst:1476 msgid "" "Perform a :c:func:`statvfs` system call on the given path. The return value " "is an object whose attributes describe the filesystem on the given path, and " @@ -72558,7 +74230,7 @@ msgid "" msgstr "" # 3dbaac34be6a4924a26764aa3ce63496 -#: ../src/Doc/library/os.rst:1485 +#: library/os.rst:1485 msgid "" "For backward compatibility, the return value is also accessible as a tuple " "whose values correspond to the attributes, in the order given above. The " @@ -72568,12 +74240,12 @@ msgid "" "versions of Python that don't support accessing the fields as attributes." msgstr "" -#: ../src/Doc/library/os.rst:1500 +#: library/os.rst:1500 msgid "Create a symbolic link pointing to *source* named *link_name*." msgstr "" # 9b7a0982d0404ec9bdf0f466ede085ab -#: ../src/Doc/library/os.rst:1507 +#: library/os.rst:1507 msgid "" "Return a unique path name that is reasonable for creating a temporary file. " "This will be an absolute path that names a potential directory entry in the " @@ -72588,14 +74260,14 @@ msgid "" msgstr "" # 1729c258d86e40ea9513c2ed6ee1142e -#: ../src/Doc/library/os.rst:1520 +#: library/os.rst:1520 msgid "" "Use of :func:`tempnam` is vulnerable to symlink attacks; consider using :" "func:`tmpfile` (section :ref:`os-newstreams`) instead." msgstr "" # a4c3c2a75fc743a5a066ba57b6e45a92 -#: ../src/Doc/library/os.rst:1528 +#: library/os.rst:1528 msgid "" "Return a unique path name that is reasonable for creating a temporary file. " "This will be an absolute path that names a potential directory entry in a " @@ -72605,14 +74277,14 @@ msgid "" msgstr "" # aed1994762b24b9c923305d03da5e1c8 -#: ../src/Doc/library/os.rst:1536 +#: library/os.rst:1536 msgid "" "Use of :func:`tmpnam` is vulnerable to symlink attacks; consider using :func:" "`tmpfile` (section :ref:`os-newstreams`) instead." msgstr "" # d38db19e53fb46a28a302f65ce8160bb -#: ../src/Doc/library/os.rst:1539 +#: library/os.rst:1539 msgid "" "Availability: Unix, Windows. This function probably shouldn't be used on " "Windows, though: Microsoft's implementation of :func:`tmpnam` always creates " @@ -72622,20 +74294,20 @@ msgid "" msgstr "" # 745a942487ef46628e55db2c06f758a9 -#: ../src/Doc/library/os.rst:1548 +#: library/os.rst:1548 msgid "" "The maximum number of unique names that :func:`tmpnam` will generate before " "reusing names." msgstr "" -#: ../src/Doc/library/os.rst:1554 +#: library/os.rst:1554 msgid "" "Remove (delete) the file *path*. This is the same function as :func:" "`remove`; the :func:`unlink` name is its traditional Unix name." msgstr "" # e4b956b5529342888e64b3c6e232a303 -#: ../src/Doc/library/os.rst:1563 +#: library/os.rst:1563 msgid "" "Set the access and modified times of the file specified by *path*. If " "*times* is ``None``, then the file's access and modified times are set to " @@ -72650,7 +74322,11 @@ msgid "" "times; see :func:`~os.stat`." msgstr "" -#: ../src/Doc/library/os.rst:1586 +#: library/os.rst:1574 +msgid "Added support for ``None`` for *times*." +msgstr "" + +#: library/os.rst:1586 msgid "" "Generate the file names in a directory tree by walking the tree either top-" "down or bottom-up. For each directory in the tree rooted at directory *top* " @@ -72658,7 +74334,7 @@ msgid "" "filenames)``." msgstr "" -#: ../src/Doc/library/os.rst:1591 +#: library/os.rst:1591 msgid "" "*dirpath* is a string, the path to the directory. *dirnames* is a list of " "the names of the subdirectories in *dirpath* (excluding ``'.'`` and " @@ -72669,7 +74345,7 @@ msgid "" msgstr "" # b4c86ad3fb3c480392caf7c4a9fc969e -#: ../src/Doc/library/os.rst:1598 +#: library/os.rst:1598 msgid "" "If optional argument *topdown* is ``True`` or not specified, the triple for " "a directory is generated before the triples for any of its subdirectories " @@ -72680,7 +74356,7 @@ msgid "" "its subdirectories are generated." msgstr "" -#: ../src/Doc/library/os.rst:1606 +#: library/os.rst:1606 msgid "" "When *topdown* is ``True``, the caller can modify the *dirnames* list in-" "place (perhaps using :keyword:`del` or slice assignment), and :func:`walk` " @@ -72688,12 +74364,13 @@ msgid "" "this can be used to prune the search, impose a specific order of visiting, " "or even to inform :func:`walk` about directories the caller creates or " "renames before it resumes :func:`walk` again. Modifying *dirnames* when " -"*topdown* is ``False`` is ineffective, because in bottom-up mode the " -"directories in *dirnames* are generated before *dirpath* itself is generated." +"*topdown* is ``False`` has no effect on the behavior of the walk, because in " +"bottom-up mode the directories in *dirnames* are generated before *dirpath* " +"itself is generated." msgstr "" # f438678f859e4543ac7291a5fcb33ac8 -#: ../src/Doc/library/os.rst:1615 +#: library/os.rst:1615 msgid "" "By default, errors from the :func:`listdir` call are ignored. If optional " "argument *onerror* is specified, it should be a function; it will be called " @@ -72703,50 +74380,54 @@ msgid "" "object." msgstr "" -#: ../src/Doc/library/os.rst:1621 +#: library/os.rst:1621 msgid "" "By default, :func:`walk` will not walk down into symbolic links that resolve " "to directories. Set *followlinks* to ``True`` to visit directories pointed " "to by symlinks, on systems that support them." msgstr "" -#: ../src/Doc/library/os.rst:1630 +#: library/os.rst:1625 +msgid "The *followlinks* parameter." +msgstr "" + +#: library/os.rst:1630 msgid "" "Be aware that setting *followlinks* to ``True`` can lead to infinite " "recursion if a link points to a parent directory of itself. :func:`walk` " "does not keep track of the directories it visited already." msgstr "" -#: ../src/Doc/library/os.rst:1636 +#: library/os.rst:1636 msgid "" "If you pass a relative pathname, don't change the current working directory " "between resumptions of :func:`walk`. :func:`walk` never changes the current " "directory, and assumes that its caller doesn't either." msgstr "" -#: ../src/Doc/library/os.rst:1640 +#: library/os.rst:1640 msgid "" "This example displays the number of bytes taken by non-directory files in " "each directory under the starting directory, except that it doesn't look " "under any CVS subdirectory::" msgstr "" -#: ../src/Doc/library/os.rst:1653 +#: library/os.rst:1653 msgid "" "In the next example, walking the tree bottom-up is essential: :func:`rmdir` " "doesn't allow deleting a directory before the directory is empty::" msgstr "" -#: ../src/Doc/library/os.rst:1673 +#: library/os.rst:1673 msgid "Process Management" msgstr "" -#: ../src/Doc/library/os.rst:1675 +#: library/os.rst:1675 msgid "These functions may be used to create and manage processes." msgstr "" # 4597eaaec99f460ba9102eb9932ca766 -#: ../src/Doc/library/os.rst:1677 +#: library/os.rst:1677 msgid "" "The various :func:`exec\\* ` functions take a list of arguments for " "the new program loaded into the process. In each case, the first of these " @@ -72758,7 +74439,7 @@ msgid "" msgstr "" # 917021ac82554cc79001200bbdf92998 -#: ../src/Doc/library/os.rst:1688 +#: library/os.rst:1688 msgid "" "Generate a :const:`SIGABRT` signal to the current process. On Unix, the " "default behavior is to produce a core dump; on Windows, the process " @@ -72767,7 +74448,7 @@ msgid "" "`SIGABRT` with :func:`signal.signal`." msgstr "" -#: ../src/Doc/library/os.rst:1706 +#: library/os.rst:1706 msgid "" "These functions all execute a new program, replacing the current process; " "they do not return. On Unix, the new executable is loaded into the current " @@ -72776,7 +74457,7 @@ msgid "" msgstr "" # c2f68c74c77143fda42badf32cd2c3ce -#: ../src/Doc/library/os.rst:1711 +#: library/os.rst:1711 msgid "" "The current process is replaced immediately. Open file objects and " "descriptors are not flushed, so if there may be data buffered on these open " @@ -72785,7 +74466,7 @@ msgid "" msgstr "" # fdeb929ba44c46a9824692401db9cf96 -#: ../src/Doc/library/os.rst:1717 +#: library/os.rst:1717 msgid "" "The \"l\" and \"v\" variants of the :func:`exec\\* ` functions differ " "in how command-line arguments are passed. The \"l\" variants are perhaps " @@ -72799,7 +74480,7 @@ msgid "" msgstr "" # cdcdc6e5dfc64bd4be7677067a8ade42 -#: ../src/Doc/library/os.rst:1726 +#: library/os.rst:1726 msgid "" "The variants which include a \"p\" near the end (:func:`execlp`, :func:" "`execlpe`, :func:`execvp`, and :func:`execvpe`) will use the :envvar:`PATH` " @@ -72812,7 +74493,7 @@ msgid "" "absolute or relative path." msgstr "" -#: ../src/Doc/library/os.rst:1736 +#: library/os.rst:1736 msgid "" "For :func:`execle`, :func:`execlpe`, :func:`execve`, and :func:`execvpe` " "(note that these all end in \"e\"), the *env* parameter must be a mapping " @@ -72823,20 +74504,20 @@ msgid "" msgstr "" # e02e6c9806da41cc9a4620092a90d26b -#: ../src/Doc/library/os.rst:1748 +#: library/os.rst:1748 msgid "" "Exit the process with status *n*, without calling cleanup handlers, flushing " "stdio buffers, etc." msgstr "" # 727ee64d938241c5ae8a34ef60b621a8 -#: ../src/Doc/library/os.rst:1755 +#: library/os.rst:1755 msgid "" "The standard way to exit is ``sys.exit(n)``. :func:`_exit` should normally " "only be used in the child process after a :func:`fork`." msgstr "" -#: ../src/Doc/library/os.rst:1758 +#: library/os.rst:1758 msgid "" "The following exit codes are defined and can be used with :func:`_exit`, " "although they are not required. These are typically used for system " @@ -72844,113 +74525,113 @@ msgid "" "delivery program." msgstr "" -#: ../src/Doc/library/os.rst:1764 +#: library/os.rst:1764 msgid "" "Some of these may not be available on all Unix platforms, since there is " "some variation. These constants are defined where they are defined by the " "underlying platform." msgstr "" -#: ../src/Doc/library/os.rst:1771 +#: library/os.rst:1771 msgid "Exit code that means no error occurred." msgstr "" -#: ../src/Doc/library/os.rst:1780 +#: library/os.rst:1780 msgid "" "Exit code that means the command was used incorrectly, such as when the " "wrong number of arguments are given." msgstr "" -#: ../src/Doc/library/os.rst:1790 +#: library/os.rst:1790 msgid "Exit code that means the input data was incorrect." msgstr "" -#: ../src/Doc/library/os.rst:1799 +#: library/os.rst:1799 msgid "Exit code that means an input file did not exist or was not readable." msgstr "" -#: ../src/Doc/library/os.rst:1808 +#: library/os.rst:1808 msgid "Exit code that means a specified user did not exist." msgstr "" -#: ../src/Doc/library/os.rst:1817 +#: library/os.rst:1817 msgid "Exit code that means a specified host did not exist." msgstr "" -#: ../src/Doc/library/os.rst:1826 +#: library/os.rst:1826 msgid "Exit code that means that a required service is unavailable." msgstr "" -#: ../src/Doc/library/os.rst:1835 +#: library/os.rst:1835 msgid "Exit code that means an internal software error was detected." msgstr "" -#: ../src/Doc/library/os.rst:1844 +#: library/os.rst:1844 msgid "" "Exit code that means an operating system error was detected, such as the " "inability to fork or create a pipe." msgstr "" -#: ../src/Doc/library/os.rst:1854 +#: library/os.rst:1854 msgid "" "Exit code that means some system file did not exist, could not be opened, or " "had some other kind of error." msgstr "" -#: ../src/Doc/library/os.rst:1864 +#: library/os.rst:1864 msgid "Exit code that means a user specified output file could not be created." msgstr "" -#: ../src/Doc/library/os.rst:1873 +#: library/os.rst:1873 msgid "" "Exit code that means that an error occurred while doing I/O on some file." msgstr "" -#: ../src/Doc/library/os.rst:1882 +#: library/os.rst:1882 msgid "" "Exit code that means a temporary failure occurred. This indicates something " "that may not really be an error, such as a network connection that couldn't " "be made during a retryable operation." msgstr "" -#: ../src/Doc/library/os.rst:1893 +#: library/os.rst:1893 msgid "" "Exit code that means that a protocol exchange was illegal, invalid, or not " "understood." msgstr "" -#: ../src/Doc/library/os.rst:1903 +#: library/os.rst:1903 msgid "" "Exit code that means that there were insufficient permissions to perform the " "operation (but not intended for file system problems)." msgstr "" -#: ../src/Doc/library/os.rst:1913 +#: library/os.rst:1913 msgid "Exit code that means that some kind of configuration error occurred." msgstr "" -#: ../src/Doc/library/os.rst:1922 +#: library/os.rst:1922 msgid "Exit code that means something like \"an entry was not found\"." msgstr "" -#: ../src/Doc/library/os.rst:1931 +#: library/os.rst:1931 msgid "" "Fork a child process. Return ``0`` in the child and the child's process id " "in the parent. If an error occurs :exc:`OSError` is raised." msgstr "" -#: ../src/Doc/library/os.rst:1934 +#: library/os.rst:1934 msgid "" "Note that some platforms including FreeBSD <= 6.3, Cygwin and OS/2 EMX have " "known issues when using fork() from a thread." msgstr "" # b11f038c1be043a88093539ebc453391 -#: ../src/Doc/library/os.rst:1939 +#: library/os.rst:1939 msgid "See :mod:`ssl` for applications that use the SSL module with fork()." msgstr "" -#: ../src/Doc/library/os.rst:1946 +#: library/os.rst:1946 msgid "" "Fork a child process, using a new pseudo-terminal as the child's controlling " "terminal. Return a pair of ``(pid, fd)``, where *pid* is ``0`` in the child, " @@ -72959,13 +74640,13 @@ msgid "" "the :mod:`pty` module. If an error occurs :exc:`OSError` is raised." msgstr "" -#: ../src/Doc/library/os.rst:1961 +#: library/os.rst:1961 msgid "" "Send signal *sig* to the process *pid*. Constants for the specific signals " "available on the host platform are defined in the :mod:`signal` module." msgstr "" -#: ../src/Doc/library/os.rst:1964 +#: library/os.rst:1964 msgid "" "Windows: The :data:`signal.CTRL_C_EVENT` and :data:`signal.CTRL_BREAK_EVENT` " "signals are special signals which can only be sent to console processes " @@ -72975,32 +74656,37 @@ msgid "" "version of :func:`kill` additionally takes process handles to be killed." msgstr "" -#: ../src/Doc/library/os.rst:1981 +#: library/os.rst:1972 +#, fuzzy +msgid "Windows support" +msgstr "Windows" + +#: library/os.rst:1981 msgid "Send the signal *sig* to the process group *pgid*." msgstr "" -#: ../src/Doc/library/os.rst:1990 +#: library/os.rst:1990 msgid "" "Add *increment* to the process's \"niceness\". Return the new niceness." msgstr "" -#: ../src/Doc/library/os.rst:1997 +#: library/os.rst:1997 msgid "" "Lock program segments into memory. The value of *op* (defined in ````) determines which segments are locked." msgstr "" -#: ../src/Doc/library/os.rst:2009 +#: library/os.rst:2009 msgid "" "Run child processes, returning opened pipes for communications. These " "functions are described in section :ref:`os-newstreams`." msgstr "" -#: ../src/Doc/library/os.rst:2022 +#: library/os.rst:2022 msgid "Execute the program *path* in a new process." msgstr "" -#: ../src/Doc/library/os.rst:2024 +#: library/os.rst:2024 msgid "" "(Note that the :mod:`subprocess` module provides more powerful facilities " "for spawning new processes and retrieving their results; using that module " @@ -73008,7 +74694,7 @@ msgid "" "`subprocess-replacements` section.)" msgstr "" -#: ../src/Doc/library/os.rst:2029 +#: library/os.rst:2029 msgid "" "If *mode* is :const:`P_NOWAIT`, this function returns the process id of the " "new process; if *mode* is :const:`P_WAIT`, returns the process's exit code " @@ -73018,7 +74704,7 @@ msgid "" msgstr "" # 446402b1054244c981fe276eee5cb575 -#: ../src/Doc/library/os.rst:2035 +#: library/os.rst:2035 msgid "" "The \"l\" and \"v\" variants of the :func:`spawn\\* ` functions " "differ in how command-line arguments are passed. The \"l\" variants are " @@ -73031,7 +74717,7 @@ msgid "" msgstr "" # 1f24f07820ea4ad6a1cbebd9c7a76620 -#: ../src/Doc/library/os.rst:2044 +#: library/os.rst:2044 msgid "" "The variants which include a second \"p\" near the end (:func:`spawnlp`, :" "func:`spawnlpe`, :func:`spawnvp`, and :func:`spawnvpe`) will use the :envvar:" @@ -73044,7 +74730,7 @@ msgid "" "appropriate absolute or relative path." msgstr "" -#: ../src/Doc/library/os.rst:2054 +#: library/os.rst:2054 msgid "" "For :func:`spawnle`, :func:`spawnlpe`, :func:`spawnve`, and :func:`spawnvpe` " "(note that these all end in \"e\"), the *env* parameter must be a mapping " @@ -73056,14 +74742,14 @@ msgid "" "values will cause the function to fail, with a return value of ``127``." msgstr "" -#: ../src/Doc/library/os.rst:2063 +#: library/os.rst:2063 msgid "" "As an example, the following calls to :func:`spawnlp` and :func:`spawnvpe` " "are equivalent::" msgstr "" # 1cf6c774cec7464eb31c33c5ca247fef -#: ../src/Doc/library/os.rst:2072 +#: library/os.rst:2072 msgid "" "Availability: Unix, Windows. :func:`spawnlp`, :func:`spawnlpe`, :func:" "`spawnvp` and :func:`spawnvpe` are not available on Windows. :func:" @@ -73072,7 +74758,7 @@ msgid "" msgstr "" # 7108c9f0841b453e8a4f45575b6a71b9 -#: ../src/Doc/library/os.rst:2083 +#: library/os.rst:2083 msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. If either of these values is given, the :func:`spawn" @@ -73081,7 +74767,7 @@ msgid "" msgstr "" # c7cd069502564fe6b8a1b4a2c46cb484 -#: ../src/Doc/library/os.rst:2095 +#: library/os.rst:2095 msgid "" "Possible value for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. If this is given as *mode*, the :func:`spawn\\*` " @@ -73091,7 +74777,7 @@ msgid "" msgstr "" # 508b647d925642099e689b21310bd819 -#: ../src/Doc/library/os.rst:2109 +#: library/os.rst:2109 msgid "" "Possible values for the *mode* parameter to the :func:`spawn\\* ` " "family of functions. These are less portable than those listed above. :" @@ -73101,18 +74787,17 @@ msgid "" "will not return." msgstr "" -#: ../src/Doc/library/os.rst:2115 ../src/Doc/library/os.rst:2142 -#: ../src/Doc/library/signal.rst:83 ../src/Doc/library/signal.rst:93 -#: ../src/Doc/library/ssl.rst:426 ../src/Doc/library/ssl.rst:441 -#: ../src/Doc/library/sys.rst:546 +#: library/os.rst:2115 library/os.rst:2142 library/signal.rst:83 +#: library/signal.rst:93 library/ssl.rst:430 library/ssl.rst:445 +#: library/sys.rst:546 msgid "Availability: Windows." msgstr "" -#: ../src/Doc/library/os.rst:2122 +#: library/os.rst:2122 msgid "Start a file with its associated application." msgstr "" -#: ../src/Doc/library/os.rst:2124 +#: library/os.rst:2124 msgid "" "When *operation* is not specified or ``'open'``, this acts like double-" "clicking the file in Windows Explorer, or giving the file name as an " @@ -73121,7 +74806,7 @@ msgid "" "associated." msgstr "" -#: ../src/Doc/library/os.rst:2129 +#: library/os.rst:2129 msgid "" "When another *operation* is given, it must be a \"command verb\" that " "specifies what should be done with the file. Common verbs documented by " @@ -73130,7 +74815,7 @@ msgid "" msgstr "" # 4c5506db683d4c2e8b4322420ed3cb0c -#: ../src/Doc/library/os.rst:2134 +#: library/os.rst:2134 msgid "" ":func:`startfile` returns as soon as the associated application is launched. " "There is no option to wait for the application to close, and no way to " @@ -73141,8 +74826,12 @@ msgid "" "normpath` function to ensure that the path is properly encoded for Win32." msgstr "" +#: library/os.rst:2146 +msgid "The *operation* parameter." +msgstr "" + # 6f89ca2c683f4540841df3f3ffdca696 -#: ../src/Doc/library/os.rst:2152 +#: library/os.rst:2152 msgid "" "Execute the command (a string) in a subshell. This is implemented by " "calling the Standard C function :c:func:`system`, and has the same " @@ -73151,7 +74840,7 @@ msgid "" msgstr "" # b420068034b24299ae0d36f5e2afc3ba -#: ../src/Doc/library/os.rst:2157 +#: library/os.rst:2157 msgid "" "On Unix, the return value is the exit status of the process encoded in the " "format specified for :func:`wait`. Note that POSIX does not specify the " @@ -73159,7 +74848,7 @@ msgid "" "return value of the Python function is system-dependent." msgstr "" -#: ../src/Doc/library/os.rst:2162 +#: library/os.rst:2162 msgid "" "On Windows, the return value is that returned by the system shell after " "running *command*, given by the Windows environment variable :envvar:" @@ -73170,7 +74859,7 @@ msgid "" msgstr "" # ee24b5e8d7224d6a8eb488c8f126d2c1 -#: ../src/Doc/library/os.rst:2169 +#: library/os.rst:2169 msgid "" "The :mod:`subprocess` module provides more powerful facilities for spawning " "new processes and retrieving their results; using that module is preferable " @@ -73178,7 +74867,7 @@ msgid "" "the :mod:`subprocess` documentation for some helpful recipes." msgstr "" -#: ../src/Doc/library/os.rst:2180 +#: library/os.rst:2180 msgid "" "Return a 5-tuple of floating point numbers indicating accumulated (processor " "or other) times, in seconds. The items are: user time, system time, " @@ -73188,11 +74877,11 @@ msgid "" "Windows, only the first two items are filled, the others are zero." msgstr "" -#: ../src/Doc/library/os.rst:2187 +#: library/os.rst:2187 msgid "Availability: Unix, Windows" msgstr "" -#: ../src/Doc/library/os.rst:2192 +#: library/os.rst:2192 msgid "" "Wait for completion of a child process, and return a tuple containing its " "pid and exit status indication: a 16-bit number, whose low byte is the " @@ -73201,11 +74890,11 @@ msgid "" "if a core file was produced." msgstr "" -#: ../src/Doc/library/os.rst:2203 +#: library/os.rst:2203 msgid "The details of this function differ on Unix and Windows." msgstr "" -#: ../src/Doc/library/os.rst:2205 +#: library/os.rst:2205 msgid "" "On Unix: Wait for completion of a child process given by process id *pid*, " "and return a tuple containing its process id and exit status indication " @@ -73214,7 +74903,7 @@ msgid "" "operation." msgstr "" -#: ../src/Doc/library/os.rst:2210 +#: library/os.rst:2210 msgid "" "If *pid* is greater than ``0``, :func:`waitpid` requests status information " "for that specific process. If *pid* is ``0``, the request is for the status " @@ -73224,14 +74913,14 @@ msgid "" "group ``-pid`` (the absolute value of *pid*)." msgstr "" -#: ../src/Doc/library/os.rst:2217 +#: library/os.rst:2217 msgid "" "An :exc:`OSError` is raised with the value of errno when the syscall returns " "-1." msgstr "" # b7095c6dff3240c3b9563086d1f349db -#: ../src/Doc/library/os.rst:2220 +#: library/os.rst:2220 msgid "" "On Windows: Wait for completion of a process given by process handle *pid*, " "and return a tuple containing *pid*, and its exit status shifted left by 8 " @@ -73244,7 +74933,7 @@ msgid "" msgstr "" # 812c44cd74c74c2da04cb3a0a56aeba1 -#: ../src/Doc/library/os.rst:2231 +#: library/os.rst:2231 msgid "" "Similar to :func:`waitpid`, except no process id argument is given and a 3-" "element tuple containing the child's process id, exit status indication, and " @@ -73254,7 +74943,7 @@ msgid "" msgstr "" # 49ba25bbe1084487b1b57e3ff30ffaca -#: ../src/Doc/library/os.rst:2245 +#: library/os.rst:2245 msgid "" "Similar to :func:`waitpid`, except a 3-element tuple, containing the child's " "process id, exit status indication, and resource usage information is " @@ -73263,84 +74952,84 @@ msgid "" "the same as those provided to :func:`waitpid`." msgstr "" -#: ../src/Doc/library/os.rst:2258 +#: library/os.rst:2258 msgid "" "The option for :func:`waitpid` to return immediately if no child process " "status is available immediately. The function returns ``(0, 0)`` in this " "case." msgstr "" -#: ../src/Doc/library/os.rst:2266 +#: library/os.rst:2266 msgid "" "This option causes child processes to be reported if they have been " "continued from a job control stop since their status was last reported." msgstr "" -#: ../src/Doc/library/os.rst:2269 +#: library/os.rst:2269 msgid "Availability: Some Unix systems." msgstr "" -#: ../src/Doc/library/os.rst:2276 +#: library/os.rst:2276 msgid "" "This option causes child processes to be reported if they have been stopped " "but their current state has not been reported since they were stopped." msgstr "" -#: ../src/Doc/library/os.rst:2283 +#: library/os.rst:2283 msgid "" "The following functions take a process status code as returned by :func:" "`system`, :func:`wait`, or :func:`waitpid` as a parameter. They may be used " "to determine the disposition of a process." msgstr "" -#: ../src/Doc/library/os.rst:2290 +#: library/os.rst:2290 msgid "" "Return ``True`` if a core dump was generated for the process, otherwise " "return ``False``." msgstr "" -#: ../src/Doc/library/os.rst:2300 +#: library/os.rst:2300 msgid "" "Return ``True`` if the process has been continued from a job control stop, " "otherwise return ``False``." msgstr "" -#: ../src/Doc/library/os.rst:2310 +#: library/os.rst:2310 msgid "" "Return ``True`` if the process has been stopped, otherwise return ``False``." msgstr "" -#: ../src/Doc/library/os.rst:2318 +#: library/os.rst:2318 msgid "" "Return ``True`` if the process exited due to a signal, otherwise return " "``False``." msgstr "" -#: ../src/Doc/library/os.rst:2326 +#: library/os.rst:2326 msgid "" "Return ``True`` if the process exited using the :manpage:`exit(2)` system " "call, otherwise return ``False``." msgstr "" -#: ../src/Doc/library/os.rst:2334 +#: library/os.rst:2334 msgid "" "If ``WIFEXITED(status)`` is true, return the integer parameter to the :" "manpage:`exit(2)` system call. Otherwise, the return value is meaningless." msgstr "" -#: ../src/Doc/library/os.rst:2342 +#: library/os.rst:2342 msgid "Return the signal which caused the process to stop." msgstr "" -#: ../src/Doc/library/os.rst:2349 +#: library/os.rst:2349 msgid "Return the signal which caused the process to exit." msgstr "" -#: ../src/Doc/library/os.rst:2357 +#: library/os.rst:2357 msgid "Miscellaneous System Information" msgstr "" -#: ../src/Doc/library/os.rst:2362 +#: library/os.rst:2362 msgid "" "Return string-valued system configuration values. *name* specifies the " "configuration value to retrieve; it may be a string which is the name of a " @@ -73351,13 +75040,13 @@ msgid "" "included in that mapping, passing an integer for *name* is also accepted." msgstr "" -#: ../src/Doc/library/os.rst:2370 +#: library/os.rst:2370 msgid "" "If the configuration value specified by *name* isn't defined, ``None`` is " "returned." msgstr "" -#: ../src/Doc/library/os.rst:2373 +#: library/os.rst:2373 msgid "" "If *name* is a string and is not known, :exc:`ValueError` is raised. If a " "specific value for *name* is not supported by the host system, even if it is " @@ -73365,25 +75054,25 @@ msgid "" "`errno.EINVAL` for the error number." msgstr "" -#: ../src/Doc/library/os.rst:2378 +#: library/os.rst:2378 msgid "Availability: Unix" msgstr "" -#: ../src/Doc/library/os.rst:2383 +#: library/os.rst:2383 msgid "" "Dictionary mapping names accepted by :func:`confstr` to the integer values " "defined for those names by the host operating system. This can be used to " "determine the set of names known to the system." msgstr "" -#: ../src/Doc/library/os.rst:2392 +#: library/os.rst:2392 msgid "" "Return the number of processes in the system run queue averaged over the " "last 1, 5, and 15 minutes or raises :exc:`OSError` if the load average was " "unobtainable." msgstr "" -#: ../src/Doc/library/os.rst:2403 +#: library/os.rst:2403 msgid "" "Return integer-valued system configuration values. If the configuration " "value specified by *name* isn't defined, ``-1`` is returned. The comments " @@ -73392,40 +75081,40 @@ msgid "" "``sysconf_names``." msgstr "" -#: ../src/Doc/library/os.rst:2413 +#: library/os.rst:2413 msgid "" "Dictionary mapping names accepted by :func:`sysconf` to the integer values " "defined for those names by the host operating system. This can be used to " "determine the set of names known to the system." msgstr "" -#: ../src/Doc/library/os.rst:2419 +#: library/os.rst:2419 msgid "" "The following data values are used to support path manipulation operations. " "These are defined for all platforms." msgstr "" -#: ../src/Doc/library/os.rst:2422 +#: library/os.rst:2422 msgid "" "Higher-level operations on pathnames are defined in the :mod:`os.path` " "module." msgstr "" -#: ../src/Doc/library/os.rst:2427 +#: library/os.rst:2427 msgid "" "The constant string used by the operating system to refer to the current " "directory. This is ``'.'`` for Windows and POSIX. Also available via :mod:" "`os.path`." msgstr "" -#: ../src/Doc/library/os.rst:2434 +#: library/os.rst:2434 msgid "" "The constant string used by the operating system to refer to the parent " "directory. This is ``'..'`` for Windows and POSIX. Also available via :mod:" "`os.path`." msgstr "" -#: ../src/Doc/library/os.rst:2441 +#: library/os.rst:2441 msgid "" "The character used by the operating system to separate pathname components. " "This is ``'/'`` for POSIX and ``'\\\\'`` for Windows. Note that knowing " @@ -73434,7 +75123,7 @@ msgid "" "useful. Also available via :mod:`os.path`." msgstr "" -#: ../src/Doc/library/os.rst:2450 +#: library/os.rst:2450 msgid "" "An alternative character used by the operating system to separate pathname " "components, or ``None`` if only one separator character exists. This is set " @@ -73442,13 +75131,13 @@ msgid "" "via :mod:`os.path`." msgstr "" -#: ../src/Doc/library/os.rst:2458 +#: library/os.rst:2458 msgid "" "The character which separates the base filename from the extension; for " "example, the ``'.'`` in :file:`os.py`. Also available via :mod:`os.path`." msgstr "" -#: ../src/Doc/library/os.rst:2466 +#: library/os.rst:2466 msgid "" "The character conventionally used by the operating system to separate search " "path components (as in :envvar:`PATH`), such as ``':'`` for POSIX or ``';'`` " @@ -73456,14 +75145,14 @@ msgid "" msgstr "" # dc9b8c93de864aacb4bd5ecedb870712 -#: ../src/Doc/library/os.rst:2473 +#: library/os.rst:2473 msgid "" "The default search path used by :func:`exec\\*p\\* ` and :func:`spawn" "\\*p\\* ` if the environment doesn't have a ``'PATH'`` key. Also " "available via :mod:`os.path`." msgstr "" -#: ../src/Doc/library/os.rst:2480 +#: library/os.rst:2480 msgid "" "The string used to separate (or, rather, terminate) lines on the current " "platform. This may be a single character, such as ``'\\n'`` for POSIX, or " @@ -73472,22 +75161,22 @@ msgid "" "default); use a single ``'\\n'`` instead, on all platforms." msgstr "" -#: ../src/Doc/library/os.rst:2489 +#: library/os.rst:2489 msgid "" "The file path of the null device. For example: ``'/dev/null'`` for POSIX, " "``'nul'`` for Windows. Also available via :mod:`os.path`." msgstr "" -#: ../src/Doc/library/os.rst:2498 +#: library/os.rst:2498 msgid "Miscellaneous Functions" msgstr "" -#: ../src/Doc/library/os.rst:2503 +#: library/os.rst:2503 msgid "Return a string of *n* random bytes suitable for cryptographic use." msgstr "" # 179b06586aa84ce0bbcd175197af6057 -#: ../src/Doc/library/os.rst:2505 +#: library/os.rst:2505 msgid "" "This function returns random bytes from an OS-specific randomness source. " "The returned data should be unpredictable enough for cryptographic " @@ -73498,18 +75187,18 @@ msgid "" msgstr "" # 1508b71d1d1b4e46b53077dfa087ba0a -#: ../src/Doc/library/os.rst:2512 +#: library/os.rst:2512 msgid "" "For an easy-to-use interface to the random number generator provided by your " "platform, please see :class:`random.SystemRandom`." msgstr "" -#: ../src/Doc/library/os.path.rst:2 +#: library/os.path.rst:2 msgid ":mod:`os.path` --- Common pathname manipulations" msgstr "" # d9cc3c906cff4d55b076aa843912f661 -#: ../src/Doc/library/os.path.rst:9 +#: library/os.path.rst:9 msgid "" "This module implements some useful functions on pathnames. To read or write " "files see :func:`open`, and for accessing the filesystem see the :mod:`os` " @@ -73517,14 +75206,14 @@ msgid "" msgstr "" # 57dc88622c4a41359b881861b737e9e7 -#: ../src/Doc/library/os.path.rst:15 +#: library/os.path.rst:15 msgid "" "On Windows, many of these functions do not properly support UNC pathnames. :" "func:`splitunc` and :func:`ismount` do handle them correctly." msgstr "" # faf9176263f64d3680365d6d38350e22 -#: ../src/Doc/library/os.path.rst:19 +#: library/os.path.rst:19 msgid "" "Unlike a unix shell, Python does not do any *automatic* path expansions. " "Functions such as :func:`expanduser` and :func:`expandvars` can be invoked " @@ -73532,7 +75221,7 @@ msgid "" "the :mod:`glob` module.)" msgstr "" -#: ../src/Doc/library/os.path.rst:26 +#: library/os.path.rst:26 msgid "" "Since different operating systems have different path name conventions, " "there are several versions of this module in the standard library. The :mod:" @@ -73543,24 +75232,24 @@ msgid "" "same interface:" msgstr "" -#: ../src/Doc/library/os.path.rst:34 +#: library/os.path.rst:34 msgid ":mod:`posixpath` for UNIX-style paths" msgstr "" -#: ../src/Doc/library/os.path.rst:35 +#: library/os.path.rst:35 msgid ":mod:`ntpath` for Windows paths" msgstr "" -#: ../src/Doc/library/os.path.rst:36 +#: library/os.path.rst:36 msgid ":mod:`macpath` for old-style MacOS paths" msgstr "" -#: ../src/Doc/library/os.path.rst:37 +#: library/os.path.rst:37 msgid ":mod:`os2emxpath` for OS/2 EMX paths" msgstr "" # b55a0af7e50e436894afe9640d14a77f -#: ../src/Doc/library/os.path.rst:42 +#: library/os.path.rst:42 msgid "" "Return a normalized absolutized version of the pathname *path*. On most " "platforms, this is equivalent to calling the function :func:`normpath` as " @@ -73568,7 +75257,7 @@ msgid "" msgstr "" # c635717835bb4eae974773d8028e6ac1 -#: ../src/Doc/library/os.path.rst:51 +#: library/os.path.rst:51 msgid "" "Return the base name of pathname *path*. This is the second element of the " "pair returned by passing *path* to the function :func:`split`. Note that " @@ -73577,7 +75266,7 @@ msgid "" "the :func:`basename` function returns an empty string (``''``)." msgstr "" -#: ../src/Doc/library/os.path.rst:61 +#: library/os.path.rst:61 msgid "" "Return the longest path prefix (taken character-by-character) that is a " "prefix of all paths in *list*. If *list* is empty, return the empty string " @@ -73586,13 +75275,13 @@ msgid "" msgstr "" # 5c0e51c36bf74f9c983fd897d4139b69 -#: ../src/Doc/library/os.path.rst:68 +#: library/os.path.rst:68 msgid "" "Return the directory name of pathname *path*. This is the first element of " "the pair returned by passing *path* to the function :func:`split`." msgstr "" -#: ../src/Doc/library/os.path.rst:74 +#: library/os.path.rst:74 msgid "" "Return ``True`` if *path* refers to an existing path. Returns ``False`` for " "broken symbolic links. On some platforms, this function may return ``False`` " @@ -73600,20 +75289,20 @@ msgid "" "file, even if the *path* physically exists." msgstr "" -#: ../src/Doc/library/os.path.rst:82 +#: library/os.path.rst:82 msgid "" "Return ``True`` if *path* refers to an existing path. Returns ``True`` for " "broken symbolic links. Equivalent to :func:`exists` on platforms lacking :" "func:`os.lstat`." msgstr "" -#: ../src/Doc/library/os.path.rst:91 +#: library/os.path.rst:91 msgid "" "On Unix and Windows, return the argument with an initial component of ``~`` " "or ``~user`` replaced by that *user*'s home directory." msgstr "" -#: ../src/Doc/library/os.path.rst:96 +#: library/os.path.rst:96 msgid "" "On Unix, an initial ``~`` is replaced by the environment variable :envvar:" "`HOME` if it is set; otherwise the current user's home directory is looked " @@ -73621,7 +75310,7 @@ msgid "" "initial ``~user`` is looked up directly in the password directory." msgstr "" -#: ../src/Doc/library/os.path.rst:101 +#: library/os.path.rst:101 msgid "" "On Windows, :envvar:`HOME` and :envvar:`USERPROFILE` will be used if set, " "otherwise a combination of :envvar:`HOMEPATH` and :envvar:`HOMEDRIVE` will " @@ -73629,13 +75318,13 @@ msgid "" "component from the created user path derived above." msgstr "" -#: ../src/Doc/library/os.path.rst:106 +#: library/os.path.rst:106 msgid "" "If the expansion fails or if the path does not begin with a tilde, the path " "is returned unchanged." msgstr "" -#: ../src/Doc/library/os.path.rst:112 +#: library/os.path.rst:112 msgid "" "Return the argument with environment variables expanded. Substrings of the " "form ``$name`` or ``${name}`` are replaced by the value of environment " @@ -73643,20 +75332,26 @@ msgid "" "variables are left unchanged." msgstr "" -#: ../src/Doc/library/os.path.rst:117 +#: library/os.path.rst:117 msgid "" "On Windows, ``%name%`` expansions are supported in addition to ``$name`` and " "``${name}``." msgstr "" -#: ../src/Doc/library/os.path.rst:123 +#: library/os.path.rst:123 msgid "" "Return the time of last access of *path*. The return value is a number " "giving the number of seconds since the epoch (see the :mod:`time` module). " "Raise :exc:`os.error` if the file does not exist or is inaccessible." msgstr "" -#: ../src/Doc/library/os.path.rst:136 +#: library/os.path.rst:129 library/os.path.rst:142 +msgid "" +"If :func:`os.stat_float_times` returns ``True``, the result is a floating " +"point number." +msgstr "" + +#: library/os.path.rst:136 msgid "" "Return the time of last modification of *path*. The return value is a " "number giving the number of seconds since the epoch (see the :mod:`time` " @@ -73664,7 +75359,7 @@ msgid "" msgstr "" # 1a6c3c24105a4960909fe6e09a55eca9 -#: ../src/Doc/library/os.path.rst:149 +#: library/os.path.rst:149 msgid "" "Return the system's ctime which, on some systems (like Unix) is the time of " "the last metadata change, and, on others (like Windows), is the creation " @@ -73673,27 +75368,27 @@ msgid "" "file does not exist or is inaccessible." msgstr "" -#: ../src/Doc/library/os.path.rst:160 +#: library/os.path.rst:160 msgid "" "Return the size, in bytes, of *path*. Raise :exc:`os.error` if the file " "does not exist or is inaccessible." msgstr "" -#: ../src/Doc/library/os.path.rst:168 +#: library/os.path.rst:168 msgid "" "Return ``True`` if *path* is an absolute pathname. On Unix, that means it " "begins with a slash, on Windows that it begins with a (back)slash after " "chopping off a potential drive letter." msgstr "" -#: ../src/Doc/library/os.path.rst:175 +#: library/os.path.rst:175 msgid "" "Return ``True`` if *path* is an existing regular file. This follows " "symbolic links, so both :func:`islink` and :func:`isfile` can be true for " "the same path." msgstr "" -#: ../src/Doc/library/os.path.rst:181 +#: library/os.path.rst:181 msgid "" "Return ``True`` if *path* is an existing directory. This follows symbolic " "links, so both :func:`islink` and :func:`isdir` can be true for the same " @@ -73701,14 +75396,14 @@ msgid "" msgstr "" # 047854ab03cd490798d3c81a5d68f629 -#: ../src/Doc/library/os.path.rst:187 +#: library/os.path.rst:187 msgid "" "Return ``True`` if *path* refers to a directory entry that is a symbolic " "link. Always ``False`` if symbolic links are not supported by the python " "runtime." msgstr "" -#: ../src/Doc/library/os.path.rst:193 +#: library/os.path.rst:193 msgid "" "Return ``True`` if pathname *path* is a :dfn:`mount point`: a point in a " "file system where a different file system has been mounted. The function " @@ -73719,7 +75414,7 @@ msgid "" msgstr "" # 62239d51aef94e07b9f5f475805eae5c -#: ../src/Doc/library/os.path.rst:202 +#: library/os.path.rst:202 msgid "" "Join one or more path components intelligently. The return value is the " "concatenation of *path* and any members of *\\*paths* with exactly one " @@ -73730,7 +75425,7 @@ msgid "" msgstr "" # 62239d51aef94e07b9f5f475805eae5c -#: ../src/Doc/library/os.path.rst:210 +#: library/os.path.rst:210 msgid "" "On Windows, the drive letter is not reset when an absolute path component (e." "g., ``r'\\foo'``) is encountered. If a component contains a drive letter, " @@ -73741,7 +75436,7 @@ msgid "" msgstr "" # 7b0cfd3517e7482bb6cd8332660f3806 -#: ../src/Doc/library/os.path.rst:220 +#: library/os.path.rst:220 msgid "" "Normalize the case of a pathname. On Unix and Mac OS X, this returns the " "path unchanged; on case-insensitive filesystems, it converts the path to " @@ -73749,7 +75444,7 @@ msgid "" msgstr "" # 6158a032ee784bac8c9cd0ee32ef6fb1 -#: ../src/Doc/library/os.path.rst:227 +#: library/os.path.rst:227 msgid "" "Normalize a pathname by collapsing redundant separators and up-level " "references so that ``A//B``, ``A/B/``, ``A/./B`` and ``A/foo/../B`` all " @@ -73758,7 +75453,7 @@ msgid "" "backward slashes. To normalize case, use :func:`normcase`." msgstr "" -#: ../src/Doc/library/os.path.rst:236 +#: library/os.path.rst:236 msgid "" "Return the canonical path of the specified filename, eliminating any " "symbolic links encountered in the path (if they are supported by the " @@ -73766,7 +75461,7 @@ msgid "" msgstr "" # cb57c18bf25e433d9d0a94e56d493736 -#: ../src/Doc/library/os.path.rst:244 +#: library/os.path.rst:244 msgid "" "Return a relative filepath to *path* either from the current directory or " "from an optional *start* directory. This is a path computation: the " @@ -73774,29 +75469,29 @@ msgid "" "*start*." msgstr "" -#: ../src/Doc/library/os.path.rst:249 +#: library/os.path.rst:249 msgid "*start* defaults to :attr:`os.curdir`." msgstr "" -#: ../src/Doc/library/os.path.rst:251 +#: library/os.path.rst:251 msgid "Availability: Windows, Unix." msgstr "" -#: ../src/Doc/library/os.path.rst:258 +#: library/os.path.rst:258 msgid "" "Return ``True`` if both pathname arguments refer to the same file or " "directory (as indicated by device number and i-node number). Raise an " "exception if a :func:`os.stat` call on either pathname fails." msgstr "" -#: ../src/Doc/library/os.path.rst:267 +#: library/os.path.rst:267 msgid "" "Return ``True`` if the file descriptors *fp1* and *fp2* refer to the same " "file." msgstr "" # a6bfa1c2a41241ca995ecbc0ed356562 -#: ../src/Doc/library/os.path.rst:274 +#: library/os.path.rst:274 msgid "" "Return ``True`` if the stat tuples *stat1* and *stat2* refer to the same " "file. These structures may have been returned by :func:`os.fstat`, :func:`os." @@ -73805,7 +75500,7 @@ msgid "" msgstr "" # f55fd1655cae4eb98ea8e72e60a08707 -#: ../src/Doc/library/os.path.rst:284 +#: library/os.path.rst:284 msgid "" "Split the pathname *path* into a pair, ``(head, tail)`` where *tail* is the " "last pathname component and *head* is everything leading up to that. The " @@ -73819,7 +75514,7 @@ msgid "" msgstr "" # 95927ea580e646aaadd8c7525855185c -#: ../src/Doc/library/os.path.rst:297 +#: library/os.path.rst:297 msgid "" "Split the pathname *path* into a pair ``(drive, tail)`` where *drive* is " "either a drive specification or the empty string. On systems which do not " @@ -73827,7 +75522,7 @@ msgid "" "cases, ``drive + tail`` will be the same as *path*." msgstr "" -#: ../src/Doc/library/os.path.rst:307 +#: library/os.path.rst:307 msgid "" "Split the pathname *path* into a pair ``(root, ext)`` such that ``root + " "ext == path``, and *ext* is empty or begins with a period and contains at " @@ -73835,7 +75530,13 @@ msgid "" "cshrc')`` returns ``('.cshrc', '')``." msgstr "" -#: ../src/Doc/library/os.path.rst:319 +#: library/os.path.rst:312 +msgid "" +"Earlier versions could produce an empty root when the only period was the " +"first character." +msgstr "" + +#: library/os.path.rst:319 msgid "" "Split the pathname *path* into a pair ``(unc, rest)`` so that *unc* is the " "UNC mount point (such as ``r'\\\\host\\mount'``), if present, and *rest* the " @@ -73843,12 +75544,12 @@ msgid "" "drive letters, *unc* will always be the empty string." msgstr "" -#: ../src/Doc/library/os.path.rst:324 +#: library/os.path.rst:324 msgid "Availability: Windows." msgstr "" # 62709a2274a64544b7349d834f0fa095 -#: ../src/Doc/library/os.path.rst:329 +#: library/os.path.rst:329 msgid "" "Calls the function *visit* with arguments ``(arg, dirname, names)`` for each " "directory in the directory tree rooted at *path* (including *path* itself, " @@ -73861,7 +75562,7 @@ msgid "" msgstr "" # e62491a7114d491a809c865402f16650 -#: ../src/Doc/library/os.path.rst:340 +#: library/os.path.rst:340 msgid "" "Symbolic links to directories are not treated as subdirectories, and that :" "func:`walk` therefore will not visit them. To visit linked directories you " @@ -73870,24 +75571,24 @@ msgid "" msgstr "" # e1d2daf561554d8dac7562ace6885495 -#: ../src/Doc/library/os.path.rst:347 +#: library/os.path.rst:347 msgid "" "This function is deprecated and has been removed in Python 3 in favor of :" "func:`os.walk`." msgstr "" # ea8654bab65547b3bcd369fd4b4ecedd -#: ../src/Doc/library/os.path.rst:353 +#: library/os.path.rst:353 msgid "" "``True`` if arbitrary Unicode strings can be used as file names (within " "limitations imposed by the file system)." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:3 +#: library/ossaudiodev.rst:3 msgid ":mod:`ossaudiodev` --- Access to OSS-compatible audio devices" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:12 +#: library/ossaudiodev.rst:12 msgid "" "This module allows you to access the OSS (Open Sound System) audio " "interface. OSS is available for a wide range of open-source and commercial " @@ -73895,36 +75596,33 @@ msgid "" "FreeBSD." msgstr "" -# 3e0800d049214ca69c39793fcc9ba7a5 -#: ../src/Doc/library/ossaudiodev.rst:47 -msgid "" -"`Open Sound System Programmer's Guide `_" +#: library/ossaudiodev.rst:48 +msgid "Open Sound System Programmer's Guide" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:48 +#: library/ossaudiodev.rst:48 msgid "the official documentation for the OSS C API" msgstr "" # 91f6a06d33fc43b59b9a0515b8b11efb -#: ../src/Doc/library/ossaudiodev.rst:50 +#: library/ossaudiodev.rst:50 msgid "" "The module defines a large number of constants supplied by the OSS device " "driver; see ```` on either Linux or FreeBSD for a listing." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:53 +#: library/ossaudiodev.rst:53 msgid ":mod:`ossaudiodev` defines the following variables and functions:" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:58 +#: library/ossaudiodev.rst:58 msgid "" "This exception is raised on certain errors. The argument is a string " "describing what went wrong." msgstr "" # 35372f8f66964cb3bb9ee2c7b7055515 -#: ../src/Doc/library/ossaudiodev.rst:61 +#: library/ossaudiodev.rst:61 msgid "" "(If :mod:`ossaudiodev` receives an error from a system call such as :c:func:" "`open`, :c:func:`write`, or :c:func:`ioctl`, it raises :exc:`IOError`. " @@ -73932,13 +75630,13 @@ msgid "" "`OSSAudioError`.)" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:65 +#: library/ossaudiodev.rst:65 msgid "" "(For backwards compatibility, the exception class is also available as " "``ossaudiodev.error``.)" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:72 +#: library/ossaudiodev.rst:72 msgid "" "Open an audio device and return an OSS audio device object. This object " "supports many file-like methods, such as :meth:`read`, :meth:`write`, and :" @@ -73948,14 +75646,14 @@ msgid "" "methods." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:78 +#: library/ossaudiodev.rst:78 msgid "" "*device* is the audio device filename to use. If it is not specified, this " "module first looks in the environment variable :envvar:`AUDIODEV` for a " "device to use. If not found, it falls back to :file:`/dev/dsp`." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:82 +#: library/ossaudiodev.rst:82 msgid "" "*mode* is one of ``'r'`` for read-only (record) access, ``'w'`` for write-" "only (playback) access and ``'rw'`` for both. Since many sound cards only " @@ -73965,14 +75663,14 @@ msgid "" "not both at once." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:89 +#: library/ossaudiodev.rst:89 msgid "" "Note the unusual calling syntax: the *first* argument is optional, and the " "second is required. This is a historical artifact for compatibility with " "the older :mod:`linuxaudiodev` module which :mod:`ossaudiodev` supersedes." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:100 +#: library/ossaudiodev.rst:100 msgid "" "Open a mixer device and return an OSS mixer device object. *device* is the " "mixer device filename to use. If it is not specified, this module first " @@ -73980,53 +75678,53 @@ msgid "" "If not found, it falls back to :file:`/dev/mixer`." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:109 ../src/Doc/library/sunaudio.rst:55 +#: library/ossaudiodev.rst:109 library/sunaudio.rst:55 msgid "Audio Device Objects" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:111 +#: library/ossaudiodev.rst:111 msgid "" "Before you can write to or read from an audio device, you must call three " "methods in the correct order:" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:114 +#: library/ossaudiodev.rst:114 msgid ":meth:`setfmt` to set the output format" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:116 +#: library/ossaudiodev.rst:116 msgid ":meth:`channels` to set the number of channels" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:118 +#: library/ossaudiodev.rst:118 msgid ":meth:`speed` to set the sample rate" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:120 +#: library/ossaudiodev.rst:120 msgid "" "Alternately, you can use the :meth:`setparameters` method to set all three " "audio parameters at once. This is more convenient, but may not be as " "flexible in all cases." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:124 +#: library/ossaudiodev.rst:124 msgid "" "The audio device objects returned by :func:`.open` define the following " "methods and (read-only) attributes:" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:130 +#: library/ossaudiodev.rst:130 msgid "" "Explicitly close the audio device. When you are done writing to or reading " "from an audio device, you should explicitly close it. A closed device " "cannot be used again." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:137 +#: library/ossaudiodev.rst:137 msgid "Return the file descriptor associated with the device." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:142 +#: library/ossaudiodev.rst:142 msgid "" "Read *size* bytes from the audio input and return them as a Python string. " "Unlike most Unix device drivers, OSS audio devices in blocking mode (the " @@ -74034,7 +75732,7 @@ msgid "" "is available." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:150 +#: library/ossaudiodev.rst:150 msgid "" "Write the Python string *data* to the audio device and return the number of " "bytes written. If the audio device is in blocking mode (the default), the " @@ -74043,7 +75741,7 @@ msgid "" "be written ---see :meth:`writeall`." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:159 +#: library/ossaudiodev.rst:159 msgid "" "Write the entire Python string *data* to the audio device: waits until the " "audio device is able to accept data, writes as much data as it will accept, " @@ -74055,7 +75753,7 @@ msgid "" msgstr "" # aff98ee6b1874a318ccc278c90243f40 -#: ../src/Doc/library/ossaudiodev.rst:166 +#: library/ossaudiodev.rst:166 msgid "" "The following methods each map to exactly one :c:func:`ioctl` system call. " "The correspondence is obvious: for example, :meth:`setfmt` corresponds to " @@ -74064,95 +75762,95 @@ msgid "" "underlying :c:func:`ioctl` fails, they all raise :exc:`IOError`." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:175 +#: library/ossaudiodev.rst:175 msgid "" "Put the device into non-blocking mode. Once in non-blocking mode, there is " "no way to return it to blocking mode." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:181 +#: library/ossaudiodev.rst:181 msgid "" "Return a bitmask of the audio output formats supported by the soundcard. " "Some of the formats supported by OSS are:" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:187 +#: library/ossaudiodev.rst:187 msgid ":const:`AFMT_MU_LAW`" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:187 +#: library/ossaudiodev.rst:187 msgid "" "a logarithmic encoding (used by Sun ``.au`` files and :file:`/dev/audio`)" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:190 +#: library/ossaudiodev.rst:190 msgid ":const:`AFMT_A_LAW`" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:190 +#: library/ossaudiodev.rst:190 msgid "a logarithmic encoding" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:192 +#: library/ossaudiodev.rst:192 msgid ":const:`AFMT_IMA_ADPCM`" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:192 +#: library/ossaudiodev.rst:192 msgid "" "a 4:1 compressed format defined by the Interactive Multimedia Association" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:195 +#: library/ossaudiodev.rst:195 msgid ":const:`AFMT_U8`" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:195 +#: library/ossaudiodev.rst:195 msgid "Unsigned, 8-bit audio" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:197 +#: library/ossaudiodev.rst:197 msgid ":const:`AFMT_S16_LE`" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:197 +#: library/ossaudiodev.rst:197 msgid "" "Signed, 16-bit audio, little-endian byte order (as used by Intel processors)" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:200 +#: library/ossaudiodev.rst:200 msgid ":const:`AFMT_S16_BE`" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:200 +#: library/ossaudiodev.rst:200 msgid "" "Signed, 16-bit audio, big-endian byte order (as used by 68k, PowerPC, Sparc)" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:203 +#: library/ossaudiodev.rst:203 msgid ":const:`AFMT_S8`" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:203 +#: library/ossaudiodev.rst:203 msgid "Signed, 8 bit audio" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:205 +#: library/ossaudiodev.rst:205 msgid ":const:`AFMT_U16_LE`" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:205 +#: library/ossaudiodev.rst:205 msgid "Unsigned, 16-bit little-endian audio" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:207 +#: library/ossaudiodev.rst:207 msgid ":const:`AFMT_U16_BE`" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:207 +#: library/ossaudiodev.rst:207 msgid "Unsigned, 16-bit big-endian audio" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:210 +#: library/ossaudiodev.rst:210 msgid "" "Consult the OSS documentation for a full list of audio formats, and note " "that most devices support only a subset of these formats. Some older " @@ -74160,7 +75858,7 @@ msgid "" "const:`AFMT_S16_LE`." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:218 +#: library/ossaudiodev.rst:218 msgid "" "Try to set the current audio format to *format*---see :meth:`getfmts` for a " "list. Returns the audio format that the device was set to, which may not be " @@ -74168,7 +75866,7 @@ msgid "" "do this by passing an \"audio format\" of :const:`AFMT_QUERY`." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:226 +#: library/ossaudiodev.rst:226 msgid "" "Set the number of output channels to *nchannels*. A value of 1 indicates " "monophonic sound, 2 stereophonic. Some devices may have more than 2 " @@ -74176,68 +75874,68 @@ msgid "" "of channels the device was set to." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:234 +#: library/ossaudiodev.rst:234 msgid "" "Try to set the audio sampling rate to *samplerate* samples per second. " "Returns the rate actually set. Most sound devices don't support arbitrary " "sampling rates. Common rates are:" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:239 +#: library/ossaudiodev.rst:239 msgid "Rate" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:241 +#: library/ossaudiodev.rst:241 msgid "8000" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:241 +#: library/ossaudiodev.rst:241 msgid "default rate for :file:`/dev/audio`" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:243 +#: library/ossaudiodev.rst:243 msgid "11025" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:243 +#: library/ossaudiodev.rst:243 msgid "speech recording" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:245 +#: library/ossaudiodev.rst:245 msgid "22050" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:247 +#: library/ossaudiodev.rst:247 msgid "44100" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:247 +#: library/ossaudiodev.rst:247 msgid "CD quality audio (at 16 bits/sample and 2 channels)" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:250 +#: library/ossaudiodev.rst:250 msgid "96000" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:250 +#: library/ossaudiodev.rst:250 msgid "DVD quality audio (at 24 bits/sample)" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:256 +#: library/ossaudiodev.rst:256 msgid "" "Wait until the sound device has played every byte in its buffer. (This " "happens implicitly when the device is closed.) The OSS documentation " "recommends closing and re-opening the device rather than using :meth:`sync`." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:263 +#: library/ossaudiodev.rst:263 msgid "" "Immediately stop playing or recording and return the device to a state where " "it can accept commands. The OSS documentation recommends closing and re-" "opening the device after calling :meth:`reset`." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:270 +#: library/ossaudiodev.rst:270 msgid "" "Tell the driver that there is likely to be a pause in the output, making it " "possible for the device to handle the pause more intelligently. You might " @@ -74245,13 +75943,13 @@ msgid "" "or before doing disk I/O." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:275 +#: library/ossaudiodev.rst:275 msgid "" "The following convenience methods combine several ioctls, or one ioctl and " "some simple calculations." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:281 +#: library/ossaudiodev.rst:281 msgid "" "Set the key audio sampling parameters---sample format, number of channels, " "and sampling rate---in one method call. *format*, *nchannels*, and " @@ -74264,69 +75962,69 @@ msgid "" "`channels`, and :meth:`speed`)." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:291 +#: library/ossaudiodev.rst:291 msgid "For example, ::" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:295 +#: library/ossaudiodev.rst:295 msgid "is equivalent to ::" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:304 +#: library/ossaudiodev.rst:304 msgid "Returns the size of the hardware buffer, in samples." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:309 +#: library/ossaudiodev.rst:309 msgid "" "Returns the number of samples that are in the hardware buffer yet to be " "played." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:314 +#: library/ossaudiodev.rst:314 msgid "" "Returns the number of samples that could be queued into the hardware buffer " "to be played without blocking." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:317 +#: library/ossaudiodev.rst:317 msgid "Audio device objects also support several read-only attributes:" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:322 +#: library/ossaudiodev.rst:322 msgid "Boolean indicating whether the device has been closed." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:327 +#: library/ossaudiodev.rst:327 msgid "String containing the name of the device file." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:332 +#: library/ossaudiodev.rst:332 msgid "The I/O mode for the file, either ``\"r\"``, ``\"rw\"``, or ``\"w\"``." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:338 +#: library/ossaudiodev.rst:338 msgid "Mixer Device Objects" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:340 +#: library/ossaudiodev.rst:340 msgid "The mixer object provides two file-like methods:" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:345 +#: library/ossaudiodev.rst:345 msgid "" "This method closes the open mixer device file. Any further attempts to use " "the mixer after this file is closed will raise an :exc:`IOError`." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:351 +#: library/ossaudiodev.rst:351 msgid "Returns the file handle number of the open mixer device file." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:353 +#: library/ossaudiodev.rst:353 msgid "The remaining methods are specific to audio mixing:" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:358 +#: library/ossaudiodev.rst:358 msgid "" "This method returns a bitmask specifying the available mixer controls " "(\"Control\" being a specific mixable \"channel\", such as :const:" @@ -74336,7 +76034,7 @@ msgid "" "mixer object supports a PCM mixer, use the following Python code::" msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:370 +#: library/ossaudiodev.rst:370 msgid "" "For most purposes, the :const:`SOUND_MIXER_VOLUME` (master volume) and :" "const:`SOUND_MIXER_PCM` controls should suffice---but code that uses the " @@ -74344,7 +76042,7 @@ msgid "" "Gravis Ultrasound, for example, :const:`SOUND_MIXER_VOLUME` does not exist." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:378 +#: library/ossaudiodev.rst:378 msgid "" "Returns a bitmask indicating stereo mixer controls. If a bit is set, the " "corresponding control is stereo; if it is unset, the control is either " @@ -74352,20 +76050,20 @@ msgid "" "`controls` to determine which)." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:383 +#: library/ossaudiodev.rst:383 msgid "" "See the code example for the :meth:`controls` function for an example of " "getting data from a bitmask." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:389 +#: library/ossaudiodev.rst:389 msgid "" "Returns a bitmask specifying the mixer controls that may be used to record. " "See the code example for :meth:`controls` for an example of reading from a " "bitmask." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:395 +#: library/ossaudiodev.rst:395 msgid "" "Returns the volume of a given mixer control. The returned volume is a 2-" "tuple ``(left_volume,right_volume)``. Volumes are specified as numbers from " @@ -74373,13 +76071,13 @@ msgid "" "still returned, but both volumes are the same." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:400 +#: library/ossaudiodev.rst:400 msgid "" "Raises :exc:`OSSAudioError` if an invalid control was is specified, or :exc:" "`IOError` if an unsupported control is specified." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:406 +#: library/ossaudiodev.rst:406 msgid "" "Sets the volume for a given mixer control to ``(left,right)``. ``left`` and " "``right`` must be ints and between 0 (silent) and 100 (full volume). On " @@ -74388,19 +76086,19 @@ msgid "" "of some soundcard's mixers." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:412 +#: library/ossaudiodev.rst:412 msgid "" "Raises :exc:`OSSAudioError` if an invalid mixer control was specified, or if " "the specified volumes were out-of-range." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:418 +#: library/ossaudiodev.rst:418 msgid "" "This method returns a bitmask indicating which control(s) are currently " "being used as a recording source." msgstr "" -#: ../src/Doc/library/ossaudiodev.rst:424 +#: library/ossaudiodev.rst:424 msgid "" "Call this function to specify a recording source. Returns a bitmask " "indicating the new recording source (or sources) if successful; raises :exc:" @@ -74408,24 +76106,23 @@ msgid "" "source to the microphone input::" msgstr "" -#: ../src/Doc/library/othergui.rst:4 +#: library/othergui.rst:4 msgid "Other Graphical User Interface Packages" msgstr "" # fd37205acf1f4afea67656351a01e359 -#: ../src/Doc/library/othergui.rst:6 +#: library/othergui.rst:6 msgid "" "Major cross-platform (Windows, Mac OS X, Unix-like) GUI toolkits are " "available for Python:" msgstr "" -# 3b7591fe916c4bd0bf6b533e81a6e64c -#: ../src/Doc/library/othergui.rst:16 -msgid "`PyGTK `_" +#: library/othergui.rst:17 +msgid "PyGTK" msgstr "" # 962c512371df4dcda0deeed83315a80c -#: ../src/Doc/library/othergui.rst:12 +#: library/othergui.rst:12 msgid "" "is a set of bindings for the `GTK `_ widget set. It " "provides an object oriented interface that is slightly higher level than the " @@ -74435,12 +76132,11 @@ msgid "" "pygtk2tutorial/index.html>`_ is available." msgstr "" -# 55d027c06ea546eda245b032388483bc -#: ../src/Doc/library/othergui.rst:28 -msgid "`PyQt `_" +#: library/othergui.rst:29 +msgid "PyQt" msgstr "" -#: ../src/Doc/library/othergui.rst:20 +#: library/othergui.rst:20 msgid "" "PyQt is a :program:`sip`\\ -wrapped binding to the Qt toolkit. Qt is an " "extensive C++ GUI application development framework that is available for " @@ -74452,12 +76148,11 @@ msgid "" "and Qt `_, by Mark Summerfield." msgstr "" -# 7a1cfd798e184fc5aba3badb95d40a4b -#: ../src/Doc/library/othergui.rst:41 -msgid "`wxPython `_" +#: library/othergui.rst:42 +msgid "wxPython" msgstr "" -#: ../src/Doc/library/othergui.rst:32 +#: library/othergui.rst:32 msgid "" "wxPython is a cross-platform GUI toolkit for Python that is built around the " "popular `wxWidgets `_ (formerly wxWindows) C++ " @@ -74468,12 +76163,12 @@ msgid "" "sensitive help, printing, HTML viewing, low-level device context drawing, " "drag and drop, system clipboard access, an XML-based resource format and " "more, including an ever growing library of user-contributed modules. " -"wxPython has a book, `wxPython in Action `_, by Noel Rappin and Robin Dunn." +"wxPython has a book, `wxPython in Action `_, " +"by Noel Rappin and Robin Dunn." msgstr "" # 54232000d0cb4e01a0d51b9fb26564db -#: ../src/Doc/library/othergui.rst:45 +#: library/othergui.rst:45 msgid "" "PyGTK, PyQt, and wxPython, all have a modern look and feel and more widgets " "than Tkinter. In addition, there are many other GUI toolkits for Python, " @@ -74483,11 +76178,11 @@ msgid "" "different GUI toolkits are compared." msgstr "" -#: ../src/Doc/library/parser.rst:3 +#: library/parser.rst:3 msgid ":mod:`parser` --- Access Python parse trees" msgstr "" -#: ../src/Doc/library/parser.rst:20 +#: library/parser.rst:20 msgid "" "The :mod:`parser` module provides an interface to Python's internal parser " "and byte-code compiler. The primary purpose for this interface is to allow " @@ -74498,7 +76193,7 @@ msgid "" "faster." msgstr "" -#: ../src/Doc/library/parser.rst:29 +#: library/parser.rst:29 msgid "" "From Python 2.5 onward, it's much more convenient to cut in at the Abstract " "Syntax Tree (AST) generation and compilation stage, using the :mod:`ast` " @@ -74506,7 +76201,7 @@ msgid "" msgstr "" # 4f72cfeb478f4e719e5a1b78eed5a155 -#: ../src/Doc/library/parser.rst:33 +#: library/parser.rst:33 msgid "" "The :mod:`parser` module exports the names documented here also with \"st\" " "replaced by \"ast\"; this is a legacy from the time when there was no other " @@ -74515,7 +76210,7 @@ msgid "" "*st*. The \"ast\" functions have been removed in Python 3." msgstr "" -#: ../src/Doc/library/parser.rst:39 +#: library/parser.rst:39 msgid "" "There are a few things to note about this module which are important to " "making use of the data structures created. This is not a tutorial on " @@ -74523,7 +76218,7 @@ msgid "" "`parser` module are presented." msgstr "" -#: ../src/Doc/library/parser.rst:44 +#: library/parser.rst:44 msgid "" "Most importantly, a good understanding of the Python grammar processed by " "the internal parser is required. For full information on the language " @@ -74544,7 +76239,7 @@ msgid "" "compatible." msgstr "" -#: ../src/Doc/library/parser.rst:61 +#: library/parser.rst:61 msgid "" "Each element of the sequences returned by :func:`st2list` or :func:" "`st2tuple` has a simple form. Sequences representing non-terminal elements " @@ -74565,7 +76260,7 @@ msgid "" "the ``12`` represents the line number at which the terminal symbol was found." msgstr "" -#: ../src/Doc/library/parser.rst:78 +#: library/parser.rst:78 msgid "" "Terminal elements are represented in much the same way, but without any " "child elements and the addition of the source text which was identified. " @@ -74574,7 +76269,7 @@ msgid "" "`Include/token.h` and the Python module :mod:`token`." msgstr "" -#: ../src/Doc/library/parser.rst:84 +#: library/parser.rst:84 msgid "" "The ST objects are not required to support the functionality of this module, " "but are provided for three purposes: to allow an application to amortize the " @@ -74585,7 +76280,7 @@ msgid "" "Python to hide the use of ST objects." msgstr "" -#: ../src/Doc/library/parser.rst:92 +#: library/parser.rst:92 msgid "" "The :mod:`parser` module defines functions for a few distinct purposes. The " "most important purposes are to create ST objects and to convert ST objects " @@ -74594,31 +76289,31 @@ msgid "" "represented by an ST object." msgstr "" -# 3ac2cd0857df4e85bc061ac94d43b97b -#: ../src/Doc/library/parser.rst:101 -msgid "Module :mod:`symbol`" -msgstr "" +#: library/parser.rst:102 +#, fuzzy +msgid "Module symbol" +msgstr "Modules" -#: ../src/Doc/library/parser.rst:102 +#: library/parser.rst:102 msgid "Useful constants representing internal nodes of the parse tree." msgstr "" -# 0f171613744c49808f055426d94a8628 -#: ../src/Doc/library/parser.rst:104 -msgid "Module :mod:`token`" -msgstr "" +#: library/parser.rst:105 +#, fuzzy +msgid "Module token" +msgstr "Modules" -#: ../src/Doc/library/parser.rst:105 +#: library/parser.rst:105 msgid "" "Useful constants representing leaf nodes of the parse tree and functions for " "testing node values." msgstr "" -#: ../src/Doc/library/parser.rst:112 +#: library/parser.rst:112 msgid "Creating ST Objects" msgstr "" -#: ../src/Doc/library/parser.rst:114 +#: library/parser.rst:114 msgid "" "ST objects may be created from source code or from a parse tree. When " "creating an ST object from source, different functions are used to create " @@ -74626,7 +76321,7 @@ msgid "" msgstr "" # ba9c1ff123e8467ebb3144782251c35e -#: ../src/Doc/library/parser.rst:121 +#: library/parser.rst:121 msgid "" "The :func:`expr` function parses the parameter *source* as if it were an " "input to ``compile(source, 'file.py', 'eval')``. If the parse succeeds, an " @@ -74635,7 +76330,7 @@ msgid "" msgstr "" # 83bb90e70eb542fc9f594ff1eff67e80 -#: ../src/Doc/library/parser.rst:129 +#: library/parser.rst:129 msgid "" "The :func:`suite` function parses the parameter *source* as if it were an " "input to ``compile(source, 'file.py', 'exec')``. If the parse succeeds, an " @@ -74644,7 +76339,7 @@ msgid "" msgstr "" # 93996ac3019a4a1db658df3f9d5a72c2 -#: ../src/Doc/library/parser.rst:137 +#: library/parser.rst:137 msgid "" "This function accepts a parse tree represented as a sequence and builds an " "internal representation if possible. If it can validate that the tree " @@ -74661,7 +76356,7 @@ msgid "" "compiler." msgstr "" -#: ../src/Doc/library/parser.rst:150 +#: library/parser.rst:150 msgid "" "Sequences representing terminal tokens may be represented as either two-" "element lists of the form ``(1, 'name')`` or as three-element lists of the " @@ -74670,17 +76365,17 @@ msgid "" "the terminal symbols in the input tree." msgstr "" -#: ../src/Doc/library/parser.rst:159 +#: library/parser.rst:159 msgid "" "This is the same function as :func:`sequence2st`. This entry point is " "maintained for backward compatibility." msgstr "" -#: ../src/Doc/library/parser.rst:166 +#: library/parser.rst:166 msgid "Converting ST Objects" msgstr "" -#: ../src/Doc/library/parser.rst:168 +#: library/parser.rst:168 msgid "" "ST objects, regardless of the input used to create them, may be converted to " "parse trees represented as list- or tuple- trees, or may be compiled into " @@ -74689,7 +76384,7 @@ msgid "" msgstr "" # 17fd19b100e34be1a9990bbc4a754d27 -#: ../src/Doc/library/parser.rst:176 +#: library/parser.rst:176 msgid "" "This function accepts an ST object from the caller in *ast* and returns a " "Python list representing the equivalent parse tree. The resulting list " @@ -74702,7 +76397,7 @@ msgid "" "representation and converting that to nested lists." msgstr "" -#: ../src/Doc/library/parser.rst:186 +#: library/parser.rst:186 msgid "" "If *line_info* is true, line number information will be included for all " "terminal tokens as a third element of the list representing the token. Note " @@ -74711,14 +76406,14 @@ msgid "" msgstr "" # 3d9f985956294f9598d9a4c06637d81f -#: ../src/Doc/library/parser.rst:194 +#: library/parser.rst:194 msgid "" "This function accepts an ST object from the caller in *ast* and returns a " "Python tuple representing the equivalent parse tree. Other than returning a " "tuple instead of a list, this function is identical to :func:`st2list`." msgstr "" -#: ../src/Doc/library/parser.rst:198 +#: library/parser.rst:198 msgid "" "If *line_info* is true, line number information will be included for all " "terminal tokens as a third element of the list representing the token. This " @@ -74726,7 +76421,7 @@ msgid "" msgstr "" # 7dbd20228afd4d74a77e98b29d502720 -#: ../src/Doc/library/parser.rst:207 +#: library/parser.rst:207 msgid "" "The Python byte compiler can be invoked on an ST object to produce code " "objects which can be used as part of an :keyword:`exec` statement or a call " @@ -74737,7 +76432,7 @@ msgid "" "object." msgstr "" -#: ../src/Doc/library/parser.rst:214 +#: library/parser.rst:214 msgid "" "Compiling an ST object may result in exceptions related to compilation; an " "example would be a :exc:`SyntaxError` caused by the parse tree for ``del " @@ -74749,11 +76444,11 @@ msgid "" "programmatically by inspection of the parse tree." msgstr "" -#: ../src/Doc/library/parser.rst:227 +#: library/parser.rst:227 msgid "Queries on ST Objects" msgstr "" -#: ../src/Doc/library/parser.rst:229 +#: library/parser.rst:229 msgid "" "Two functions are provided which allow an application to determine if an ST " "was created as an expression or a suite. Neither of these functions can be " @@ -74762,7 +76457,7 @@ msgid "" msgstr "" # 1c3b871904754996ae79a6b02db19bbe -#: ../src/Doc/library/parser.rst:239 +#: library/parser.rst:239 msgid "" "When *ast* represents an ``'eval'`` form, this function returns true, " "otherwise it returns false. This is useful, since code objects normally " @@ -74773,7 +76468,7 @@ msgid "" msgstr "" # 63072dcef06c410cb905864777fd7442 -#: ../src/Doc/library/parser.rst:248 +#: library/parser.rst:248 msgid "" "This function mirrors :func:`isexpr` in that it reports whether an ST object " "represents an ``'exec'`` form, commonly known as a \"suite.\" It is not " @@ -74781,11 +76476,11 @@ msgid "" "additional syntactic fragments may be supported in the future." msgstr "" -#: ../src/Doc/library/parser.rst:257 +#: library/parser.rst:257 msgid "Exceptions and Error Handling" msgstr "" -#: ../src/Doc/library/parser.rst:259 +#: library/parser.rst:259 msgid "" "The parser module defines a single exception, but may also pass other built-" "in exceptions from other portions of the Python runtime environment. See " @@ -74793,7 +76488,7 @@ msgid "" msgstr "" # 13097a0405584e7795db1206f643ca68 -#: ../src/Doc/library/parser.rst:266 +#: library/parser.rst:266 msgid "" "Exception raised when a failure occurs within the parser module. This is " "generally produced for validation failures rather than the built-in :exc:" @@ -74806,7 +76501,7 @@ msgid "" msgstr "" # 902930dcb44f4e8e9f79b7d2304b12cb -#: ../src/Doc/library/parser.rst:275 +#: library/parser.rst:275 msgid "" "Note that the functions :func:`compilest`, :func:`expr`, and :func:`suite` " "may raise exceptions which are normally raised by the parsing and " @@ -74817,54 +76512,54 @@ msgid "" "for detailed information." msgstr "" -#: ../src/Doc/library/parser.rst:286 +#: library/parser.rst:286 msgid "ST Objects" msgstr "" -#: ../src/Doc/library/parser.rst:288 +#: library/parser.rst:288 msgid "" "Ordered and equality comparisons are supported between ST objects. Pickling " "of ST objects (using the :mod:`pickle` module) is also supported." msgstr "" -#: ../src/Doc/library/parser.rst:294 +#: library/parser.rst:294 msgid "" "The type of the objects returned by :func:`expr`, :func:`suite` and :func:" "`sequence2st`." msgstr "" -#: ../src/Doc/library/parser.rst:297 +#: library/parser.rst:297 msgid "ST objects have the following methods:" msgstr "" -#: ../src/Doc/library/parser.rst:302 +#: library/parser.rst:302 msgid "Same as ``compilest(st, filename)``." msgstr "" -#: ../src/Doc/library/parser.rst:307 +#: library/parser.rst:307 msgid "Same as ``isexpr(st)``." msgstr "" -#: ../src/Doc/library/parser.rst:312 +#: library/parser.rst:312 msgid "Same as ``issuite(st)``." msgstr "" # c6e9fba154cf43489e46d4588836e932 -#: ../src/Doc/library/parser.rst:317 +#: library/parser.rst:317 msgid "Same as ``st2list(st, line_info)``." msgstr "" # dfbf5f7192364570b344e8bcfc4f41f8 -#: ../src/Doc/library/parser.rst:322 +#: library/parser.rst:322 msgid "Same as ``st2tuple(st, line_info)``." msgstr "" # 1341203b2d664c238b5f6d2f8f01b39d -#: ../src/Doc/library/parser.rst:326 +#: library/parser.rst:326 msgid "Example: Emulation of :func:`compile`" msgstr "" -#: ../src/Doc/library/parser.rst:328 +#: library/parser.rst:328 msgid "" "While many useful operations may take place between parsing and bytecode " "generation, the simplest operation is to do nothing. For this purpose, " @@ -74872,29 +76567,29 @@ msgid "" "equivalent to the code ::" msgstr "" -#: ../src/Doc/library/parser.rst:338 +#: library/parser.rst:338 msgid "" "The equivalent operation using the :mod:`parser` module is somewhat longer, " "and allows the intermediate internal parse tree to be retained as an ST " "object::" msgstr "" -#: ../src/Doc/library/parser.rst:348 +#: library/parser.rst:348 msgid "" "An application which needs both ST and code objects can package this code " "into readily available functions::" msgstr "" -#: ../src/Doc/library/pdb.rst:4 +#: library/pdb.rst:4 msgid ":mod:`pdb` --- The Python Debugger" msgstr "" # c39d68983f374847b70d57410336098b -#: ../src/Doc/library/pdb.rst:9 +#: library/pdb.rst:9 msgid "**Source code:** :source:`Lib/pdb.py`" msgstr "" -#: ../src/Doc/library/pdb.rst:15 +#: library/pdb.rst:15 msgid "" "The module :mod:`pdb` defines an interactive source code debugger for Python " "programs. It supports setting (conditional) breakpoints and single stepping " @@ -74904,26 +76599,26 @@ msgid "" "control." msgstr "" -#: ../src/Doc/library/pdb.rst:26 +#: library/pdb.rst:26 msgid "" "The debugger is extensible --- it is actually defined as the class :class:" "`Pdb`. This is currently undocumented but easily understood by reading the " "source. The extension interface uses the modules :mod:`bdb` and :mod:`cmd`." msgstr "" -#: ../src/Doc/library/pdb.rst:30 +#: library/pdb.rst:30 msgid "" "The debugger's prompt is ``(Pdb)``. Typical usage to run a program under " "control of the debugger is::" msgstr "" -#: ../src/Doc/library/pdb.rst:44 +#: library/pdb.rst:44 msgid "" ":file:`pdb.py` can also be invoked as a script to debug other scripts. For " "example::" msgstr "" -#: ../src/Doc/library/pdb.rst:49 +#: library/pdb.rst:49 msgid "" "When invoked as a script, pdb will automatically enter post-mortem debugging " "if the program being debugged exits abnormally. After post-mortem debugging " @@ -74932,31 +76627,35 @@ msgid "" "cases is more useful than quitting the debugger upon program's exit." msgstr "" -#: ../src/Doc/library/pdb.rst:58 +#: library/pdb.rst:55 +msgid "Restarting post-mortem behavior added." +msgstr "" + +#: library/pdb.rst:58 msgid "" "The typical usage to break into the debugger from a running program is to " "insert ::" msgstr "" -#: ../src/Doc/library/pdb.rst:63 +#: library/pdb.rst:63 msgid "" "at the location you want to break into the debugger. You can then step " "through the code following this statement, and continue running without the " "debugger using the ``c`` command." msgstr "" -#: ../src/Doc/library/pdb.rst:67 +#: library/pdb.rst:67 msgid "The typical usage to inspect a crashed program is::" msgstr "" -#: ../src/Doc/library/pdb.rst:85 +#: library/pdb.rst:85 msgid "" "The module defines the following functions; each enters the debugger in a " "slightly different way:" msgstr "" # 4f557745bcf044008796e00759950d4b -#: ../src/Doc/library/pdb.rst:90 +#: library/pdb.rst:90 msgid "" "Execute the *statement* (given as a string) under debugger control. The " "debugger prompt appears before any code is executed; you can set breakpoints " @@ -74968,14 +76667,14 @@ msgid "" "`eval` built-in function.)" msgstr "" -#: ../src/Doc/library/pdb.rst:102 +#: library/pdb.rst:102 msgid "" "Evaluate the *expression* (given as a string) under debugger control. When :" "func:`runeval` returns, it returns the value of the expression. Otherwise " "this function is similar to :func:`run`." msgstr "" -#: ../src/Doc/library/pdb.rst:109 +#: library/pdb.rst:109 msgid "" "Call the *function* (a function or method object, not a string) with the " "given arguments. When :func:`runcall` returns, it returns whatever the " @@ -74983,14 +76682,14 @@ msgid "" "is entered." msgstr "" -#: ../src/Doc/library/pdb.rst:116 +#: library/pdb.rst:116 msgid "" "Enter the debugger at the calling stack frame. This is useful to hard-code " "a breakpoint at a given point in a program, even if the code is not " "otherwise being debugged (e.g. when an assertion fails)." msgstr "" -#: ../src/Doc/library/pdb.rst:123 +#: library/pdb.rst:123 msgid "" "Enter post-mortem debugging of the given *traceback* object. If no " "*traceback* is given, it uses the one of the exception that is currently " @@ -74998,50 +76697,50 @@ msgid "" "used)." msgstr "" -#: ../src/Doc/library/pdb.rst:131 +#: library/pdb.rst:131 msgid "" "Enter post-mortem debugging of the traceback found in :data:`sys." "last_traceback`." msgstr "" # 132ad7b66eb14b9b9f14ae1a7caa7b4f -#: ../src/Doc/library/pdb.rst:135 +#: library/pdb.rst:135 msgid "" "The ``run*`` functions and :func:`set_trace` are aliases for instantiating " "the :class:`Pdb` class and calling the method of the same name. If you want " "to access further features, you have to do this yourself:" msgstr "" -#: ../src/Doc/library/pdb.rst:141 +#: library/pdb.rst:141 msgid ":class:`Pdb` is the debugger class." msgstr "" -#: ../src/Doc/library/pdb.rst:143 +#: library/pdb.rst:143 msgid "" "The *completekey*, *stdin* and *stdout* arguments are passed to the " "underlying :class:`cmd.Cmd` class; see the description there." msgstr "" -#: ../src/Doc/library/pdb.rst:146 +#: library/pdb.rst:146 msgid "" "The *skip* argument, if given, must be an iterable of glob-style module name " "patterns. The debugger will not step into frames that originate in a module " "that matches one of these patterns. [1]_" msgstr "" -#: ../src/Doc/library/pdb.rst:150 +#: library/pdb.rst:150 msgid "Example call to enable tracing with *skip*::" msgstr "" -#: ../src/Doc/library/pdb.rst:162 +#: library/pdb.rst:162 msgid "See the documentation for the functions explained above." msgstr "" -#: ../src/Doc/library/pdb.rst:168 +#: library/pdb.rst:168 msgid "Debugger Commands" msgstr "" -#: ../src/Doc/library/pdb.rst:170 +#: library/pdb.rst:170 msgid "" "The debugger recognizes the following commands. Most commands can be " "abbreviated to one or two letters; e.g. ``h(elp)`` means that either ``h`` " @@ -75053,13 +76752,13 @@ msgid "" "bar (``|``)." msgstr "" -#: ../src/Doc/library/pdb.rst:178 +#: library/pdb.rst:178 msgid "" "Entering a blank line repeats the last command entered. Exception: if the " "last command was a ``list`` command, the next 11 lines are listed." msgstr "" -#: ../src/Doc/library/pdb.rst:181 +#: library/pdb.rst:181 msgid "" "Commands that the debugger doesn't recognize are assumed to be Python " "statements and are executed in the context of the program being debugged. " @@ -75070,7 +76769,7 @@ msgid "" "is not changed." msgstr "" -#: ../src/Doc/library/pdb.rst:189 +#: library/pdb.rst:189 msgid "" "Multiple commands may be entered on a single line, separated by ``;;``. (A " "single ``;`` is not used as it is the separator for multiple commands in a " @@ -75079,13 +76778,13 @@ msgid "" "if it is in the middle of a quoted string." msgstr "" -#: ../src/Doc/library/pdb.rst:195 +#: library/pdb.rst:195 msgid "" "The debugger supports aliases. Aliases can have parameters which allows one " "a certain level of adaptability to the context under examination." msgstr "" -#: ../src/Doc/library/pdb.rst:202 +#: library/pdb.rst:202 msgid "" "If a file :file:`.pdbrc` exists in the user's home directory or in the " "current directory, it is read in and executed as if it had been typed at the " @@ -75094,12 +76793,11 @@ msgid "" "can be overridden by the local file." msgstr "" -# a222f04d3feb443a875471466d6caa3f -#: ../src/Doc/library/pdb.rst:213 -msgid "h(elp) [*command*]" +#: library/pdb.rst:214 +msgid "h(elp) [command]" msgstr "" -#: ../src/Doc/library/pdb.rst:209 +#: library/pdb.rst:209 msgid "" "Without argument, print the list of available commands. With a *command* as " "argument, print help about that command. ``help pdb`` displays the full " @@ -75110,44 +76808,43 @@ msgid "" msgstr "" # 09f9d48f13c94033b88ee1f4acad15e7 -#: ../src/Doc/library/pdb.rst:217 +#: library/pdb.rst:218 msgid "w(here)" msgstr "" -#: ../src/Doc/library/pdb.rst:217 +#: library/pdb.rst:217 msgid "" "Print a stack trace, with the most recent frame at the bottom. An arrow " "indicates the current frame, which determines the context of most commands." msgstr "" # bddb6d0b82f8420788cd423f29d11906 -#: ../src/Doc/library/pdb.rst:220 +#: library/pdb.rst:221 msgid "d(own)" msgstr "" # 346db8690d4941c3a95359dd70b2bb34 -#: ../src/Doc/library/pdb.rst:221 +#: library/pdb.rst:221 msgid "" "Move the current frame one level down in the stack trace (to a newer frame)." msgstr "" # 07cbd384c14442c4b098f85889a2d676 -#: ../src/Doc/library/pdb.rst:223 +#: library/pdb.rst:224 msgid "u(p)" msgstr "" # ae17199c79954896a73125540980d15d -#: ../src/Doc/library/pdb.rst:224 +#: library/pdb.rst:224 msgid "" "Move the current frame one level up in the stack trace (to an older frame)." msgstr "" -# 939dcadc932b4f8394dc797ebba57dc0 -#: ../src/Doc/library/pdb.rst:238 -msgid "b(reak) [[*filename*:]\\ *lineno* | *function*\\ [, *condition*]]" +#: library/pdb.rst:239 +msgid "b(reak) [[filename:]lineno | function[, condition]]" msgstr "" -#: ../src/Doc/library/pdb.rst:227 +#: library/pdb.rst:227 msgid "" "With a *lineno* argument, set a break there in the current file. With a " "*function* argument, set a break at the first executable statement within " @@ -75157,49 +76854,46 @@ msgid "" "is assigned a number to which all the other breakpoint commands refer." msgstr "" -#: ../src/Doc/library/pdb.rst:234 +#: library/pdb.rst:234 msgid "" "If a second argument is present, it is an expression which must evaluate to " "true before the breakpoint is honored." msgstr "" -#: ../src/Doc/library/pdb.rst:237 +#: library/pdb.rst:237 msgid "" "Without argument, list all breaks, including for each breakpoint, the number " "of times that breakpoint has been hit, the current ignore count, and the " "associated condition if any." msgstr "" -# 0d58972680c4438aa8acd782f4d504e8 -#: ../src/Doc/library/pdb.rst:242 -msgid "tbreak [[*filename*:]\\ *lineno* | *function*\\ [, *condition*]]" +#: library/pdb.rst:243 +msgid "tbreak [[filename:]lineno | function[, condition]]" msgstr "" -#: ../src/Doc/library/pdb.rst:242 +#: library/pdb.rst:242 msgid "" "Temporary breakpoint, which is removed automatically when it is first hit. " "The arguments are the same as break." msgstr "" -# 10f692ad0d784a6794c89eb969f6f3ce -#: ../src/Doc/library/pdb.rst:247 -msgid "cl(ear) [*filename:lineno* | *bpnumber* [*bpnumber ...*]]" +#: library/pdb.rst:248 +msgid "cl(ear) [filename:lineno | bpnumber [bpnumber ...]]" msgstr "" # af918529eb0245c5bbd25882d6353479 -#: ../src/Doc/library/pdb.rst:246 +#: library/pdb.rst:246 msgid "" "With a *filename:lineno* argument, clear all the breakpoints at this line. " "With a space separated list of breakpoint numbers, clear those breakpoints. " "Without argument, clear all breaks (but first ask confirmation)." msgstr "" -# 42927aa8c1964c3caf60b95a1b2c8d4f -#: ../src/Doc/library/pdb.rst:253 -msgid "disable [*bpnumber* [*bpnumber ...*]]" +#: library/pdb.rst:254 +msgid "disable [bpnumber [bpnumber ...]]" msgstr "" -#: ../src/Doc/library/pdb.rst:251 +#: library/pdb.rst:251 msgid "" "Disables the breakpoints given as a space separated list of breakpoint " "numbers. Disabling a breakpoint means it cannot cause the program to stop " @@ -75207,21 +76901,19 @@ msgid "" "breakpoints and can be (re-)enabled." msgstr "" -# 6a6d87ddf9a64977bb20e970ac10ff0e -#: ../src/Doc/library/pdb.rst:256 -msgid "enable [*bpnumber* [*bpnumber ...*]]" +#: library/pdb.rst:257 +msgid "enable [bpnumber [bpnumber ...]]" msgstr "" -#: ../src/Doc/library/pdb.rst:257 +#: library/pdb.rst:257 msgid "Enables the breakpoints specified." msgstr "" -# 4cc5b364645a41c69530f454663cafb1 -#: ../src/Doc/library/pdb.rst:263 -msgid "ignore *bpnumber* [*count*]" +#: library/pdb.rst:264 +msgid "ignore bpnumber [count]" msgstr "" -#: ../src/Doc/library/pdb.rst:260 +#: library/pdb.rst:260 msgid "" "Sets the ignore count for the given breakpoint number. If count is omitted, " "the ignore count is set to 0. A breakpoint becomes active when the ignore " @@ -75230,48 +76922,46 @@ msgid "" "condition evaluates to true." msgstr "" -# c6afc42718434fd5a8f07b6606d65906 -#: ../src/Doc/library/pdb.rst:268 -msgid "condition *bpnumber* [*condition*]" +#: library/pdb.rst:269 +msgid "condition bpnumber [condition]" msgstr "" -#: ../src/Doc/library/pdb.rst:267 +#: library/pdb.rst:267 msgid "" "Condition is an expression which must evaluate to true before the breakpoint " "is honored. If condition is absent, any existing condition is removed; i." "e., the breakpoint is made unconditional." msgstr "" -# 342250401063471b988e9d32d8df87df -#: ../src/Doc/library/pdb.rst:300 -msgid "commands [*bpnumber*]" +#: library/pdb.rst:301 +msgid "commands [bpnumber]" msgstr "" -#: ../src/Doc/library/pdb.rst:272 +#: library/pdb.rst:272 msgid "" "Specify a list of commands for breakpoint number *bpnumber*. The commands " "themselves appear on the following lines. Type a line containing just 'end' " "to terminate the commands. An example::" msgstr "" -#: ../src/Doc/library/pdb.rst:281 +#: library/pdb.rst:281 msgid "" "To remove all commands from a breakpoint, type commands and follow it " "immediately with end; that is, give no commands." msgstr "" -#: ../src/Doc/library/pdb.rst:284 +#: library/pdb.rst:284 msgid "" "With no *bpnumber* argument, commands refers to the last breakpoint set." msgstr "" -#: ../src/Doc/library/pdb.rst:286 +#: library/pdb.rst:286 msgid "" "You can use breakpoint commands to start your program up again. Simply use " "the continue command, or step, or any other command that resumes execution." msgstr "" -#: ../src/Doc/library/pdb.rst:289 +#: library/pdb.rst:289 msgid "" "Specifying any command resuming execution (currently continue, step, next, " "return, jump, quit and their abbreviations) terminates the command list (as " @@ -75281,7 +76971,7 @@ msgid "" "ambiguities about which list to execute." msgstr "" -#: ../src/Doc/library/pdb.rst:296 +#: library/pdb.rst:296 msgid "" "If you use the 'silent' command in the command list, the usual message about " "stopping at a breakpoint is not printed. This may be desirable for " @@ -75291,22 +76981,22 @@ msgid "" msgstr "" # 7f7a047c1c834b3fb55e46107a3b78b8 -#: ../src/Doc/library/pdb.rst:304 +#: library/pdb.rst:305 msgid "s(tep)" msgstr "" -#: ../src/Doc/library/pdb.rst:304 +#: library/pdb.rst:304 msgid "" "Execute the current line, stop at the first possible occasion (either in a " "function that is called or on the next line in the current function)." msgstr "" # 12d4414ab2884726b37a2c425fab45a1 -#: ../src/Doc/library/pdb.rst:310 +#: library/pdb.rst:311 msgid "n(ext)" msgstr "" -#: ../src/Doc/library/pdb.rst:308 +#: library/pdb.rst:308 msgid "" "Continue execution until the next line in the current function is reached or " "it returns. (The difference between ``next`` and ``step`` is that ``step`` " @@ -75315,59 +77005,57 @@ msgid "" msgstr "" # 6068b6798cbf4be79fec76a91805d75f -#: ../src/Doc/library/pdb.rst:316 +#: library/pdb.rst:317 msgid "unt(il)" msgstr "" -#: ../src/Doc/library/pdb.rst:314 +#: library/pdb.rst:314 msgid "" "Continue execution until the line with the line number greater than the " "current one is reached or when returning from current frame." msgstr "" # 4e4d2d7a57ff45aebeb6007bc260062e -#: ../src/Doc/library/pdb.rst:319 +#: library/pdb.rst:320 msgid "r(eturn)" msgstr "" -#: ../src/Doc/library/pdb.rst:320 +#: library/pdb.rst:320 msgid "Continue execution until the current function returns." msgstr "" # 661e4474b14046aeabaca948ffd9dad3 -#: ../src/Doc/library/pdb.rst:322 +#: library/pdb.rst:323 msgid "c(ont(inue))" msgstr "" -#: ../src/Doc/library/pdb.rst:323 +#: library/pdb.rst:323 msgid "Continue execution, only stop when a breakpoint is encountered." msgstr "" -# 2872755c35d1486e8c23deccb93e1234 -#: ../src/Doc/library/pdb.rst:331 -msgid "j(ump) *lineno*" +#: library/pdb.rst:332 +msgid "j(ump) lineno" msgstr "" -#: ../src/Doc/library/pdb.rst:326 +#: library/pdb.rst:326 msgid "" "Set the next line that will be executed. Only available in the bottom-most " "frame. This lets you jump back and execute code again, or jump forward to " "skip code that you don't want to run." msgstr "" -#: ../src/Doc/library/pdb.rst:330 +#: library/pdb.rst:330 msgid "" "It should be noted that not all jumps are allowed --- for instance it is not " "possible to jump into the middle of a :keyword:`for` loop or out of a :" "keyword:`finally` clause." msgstr "" -# 2aa5c870abd54cf5a939b5fbfbac5a48 -#: ../src/Doc/library/pdb.rst:337 -msgid "l(ist) [*first*\\ [, *last*]]" +#: library/pdb.rst:338 +msgid "l(ist) [first[, last]]" msgstr "" -#: ../src/Doc/library/pdb.rst:335 +#: library/pdb.rst:335 msgid "" "List source code for the current file. Without arguments, list 11 lines " "around the current line or continue the previous listing. With one " @@ -75377,47 +77065,44 @@ msgid "" msgstr "" # fd4cef430b824839ada66d63347203a8 -#: ../src/Doc/library/pdb.rst:340 +#: library/pdb.rst:341 msgid "a(rgs)" msgstr "" -#: ../src/Doc/library/pdb.rst:341 +#: library/pdb.rst:341 msgid "Print the argument list of the current function." msgstr "" -# 47d1b251c06f4f50820d69a90aba8333 -#: ../src/Doc/library/pdb.rst:348 -msgid "p *expression*" +#: library/pdb.rst:349 +msgid "p expression" msgstr "" -#: ../src/Doc/library/pdb.rst:344 +#: library/pdb.rst:344 msgid "Evaluate the *expression* in the current context and print its value." msgstr "" # cc9dd4cc338540e68634b2319194f67f -#: ../src/Doc/library/pdb.rst:348 +#: library/pdb.rst:348 msgid "" "``print`` can also be used, but is not a debugger command --- this executes " "the Python :keyword:`print` statement." msgstr "" -# 92c891b70c6140aab35355985cfd75e0 -#: ../src/Doc/library/pdb.rst:352 -msgid "pp *expression*" +#: library/pdb.rst:353 +msgid "pp expression" msgstr "" -#: ../src/Doc/library/pdb.rst:352 +#: library/pdb.rst:352 msgid "" "Like the ``p`` command, except the value of the expression is pretty-printed " "using the :mod:`pprint` module." msgstr "" -# b6014b9e642c4677b9b3cbb8664fb317 -#: ../src/Doc/library/pdb.rst:373 -msgid "alias [*name* [command]]" +#: library/pdb.rst:374 +msgid "alias [name [command]]" msgstr "" -#: ../src/Doc/library/pdb.rst:356 +#: library/pdb.rst:356 msgid "" "Creates an alias called *name* that executes *command*. The command must " "*not* be enclosed in quotes. Replaceable parameters can be indicated by ``" @@ -75426,7 +77111,7 @@ msgid "" "are given, all aliases are listed." msgstr "" -#: ../src/Doc/library/pdb.rst:362 +#: library/pdb.rst:362 msgid "" "Aliases may be nested and can contain anything that can be legally typed at " "the pdb prompt. Note that internal pdb commands *can* be overridden by " @@ -75435,27 +77120,25 @@ msgid "" "words in the line are left alone." msgstr "" -#: ../src/Doc/library/pdb.rst:368 +#: library/pdb.rst:368 msgid "" "As an example, here are two useful aliases (especially when placed in the :" "file:`.pdbrc` file)::" msgstr "" -# bb1dd3754b274ca8828ee54ce6e87350 -#: ../src/Doc/library/pdb.rst:376 -msgid "unalias *name*" +#: library/pdb.rst:377 +msgid "unalias name" msgstr "" -#: ../src/Doc/library/pdb.rst:377 +#: library/pdb.rst:377 msgid "Deletes the specified alias." msgstr "" -# 39d04d528b68452e815ae28e184c6b29 -#: ../src/Doc/library/pdb.rst:385 -msgid "[!]\\ *statement*" +#: library/pdb.rst:386 +msgid "[!]statement" msgstr "" -#: ../src/Doc/library/pdb.rst:380 +#: library/pdb.rst:380 msgid "" "Execute the (one-line) *statement* in the context of the current stack " "frame. The exclamation point can be omitted unless the first word of the " @@ -75464,12 +77147,11 @@ msgid "" "g.::" msgstr "" -# 6620c52f2bfa4ab686693a8f3ba3d4c7 -#: ../src/Doc/library/pdb.rst:392 -msgid "run [*args* ...]" +#: library/pdb.rst:393 +msgid "run [args ...]" msgstr "" -#: ../src/Doc/library/pdb.rst:389 +#: library/pdb.rst:389 msgid "" "Restart the debugged Python program. If an argument is supplied, it is split " "with \"shlex\" and the result is used as the new sys.argv. History, " @@ -75478,26 +77160,26 @@ msgid "" msgstr "" # aa6c4493c7e44af6b327854647818360 -#: ../src/Doc/library/pdb.rst:396 +#: library/pdb.rst:397 msgid "q(uit)" msgstr "" -#: ../src/Doc/library/pdb.rst:396 +#: library/pdb.rst:396 msgid "Quit from the debugger. The program being executed is aborted." msgstr "" -#: ../src/Doc/library/pdb.rst:401 +#: library/pdb.rst:401 msgid "" "Whether a frame is considered to originate in a certain module is determined " "by the ``__name__`` in the frame globals." msgstr "" -#: ../src/Doc/library/persistence.rst:6 +#: library/persistence.rst:6 msgid "Data Persistence" msgstr "" # 60cb3751478842a5bebfd182d61077fc -#: ../src/Doc/library/persistence.rst:8 +#: library/persistence.rst:8 msgid "" "The modules described in this chapter support storing Python data in a " "persistent form on disk. The :mod:`pickle` and :mod:`marshal` modules can " @@ -75508,12 +77190,12 @@ msgid "" "mappings based on hashing, and also supports B-Tree and record-based formats." msgstr "" -#: ../src/Doc/library/pickle.rst:2 +#: library/pickle.rst:2 msgid ":mod:`pickle` --- Python object serialization" msgstr "" # ad40457ac7e54e6d98501e3366ebdb08 -#: ../src/Doc/library/pickle.rst:17 +#: library/pickle.rst:17 msgid "" "The :mod:`pickle` module implements a fundamental, but powerful algorithm " "for serializing and de-serializing a Python object structure. \"Pickling\" " @@ -75526,25 +77208,25 @@ msgid "" msgstr "" # c0dd0831fb124d7496e8a1b000d64f70 -#: ../src/Doc/library/pickle.rst:25 +#: library/pickle.rst:25 msgid "" "This documentation describes both the :mod:`pickle` module and the :mod:" "`cPickle` module." msgstr "" -#: ../src/Doc/library/pickle.rst:30 +#: library/pickle.rst:30 msgid "" -"The :mod:`pickle` module is not intended to be secure against erroneous or " -"maliciously constructed data. Never unpickle data received from an " -"untrusted or unauthenticated source." +"The :mod:`pickle` module is not secure against erroneous or maliciously " +"constructed data. Never unpickle data received from an untrusted or " +"unauthenticated source." msgstr "" -#: ../src/Doc/library/pickle.rst:36 +#: library/pickle.rst:36 msgid "Relationship to other Python modules" msgstr "" # 43abbada95d2499f99e50286e865f05f -#: ../src/Doc/library/pickle.rst:38 +#: library/pickle.rst:38 msgid "" "The :mod:`pickle` module has an optimized cousin called the :mod:`cPickle` " "module. As its name implies, :mod:`cPickle` is written in C, so it can be " @@ -75560,13 +77242,13 @@ msgid "" msgstr "" # 9ec3a78fd1f04f3d941e40f3fa630373 -#: ../src/Doc/library/pickle.rst:49 +#: library/pickle.rst:49 msgid "" "The data streams the two modules produce are guaranteed to be " "interchangeable." msgstr "" -#: ../src/Doc/library/pickle.rst:51 +#: library/pickle.rst:51 msgid "" "Python has a more primitive serialization module called :mod:`marshal`, but " "in general :mod:`pickle` should always be the preferred way to serialize " @@ -75575,20 +77257,20 @@ msgid "" msgstr "" # 04553767c86440269d4fe6f583905380 -#: ../src/Doc/library/pickle.rst:56 +#: library/pickle.rst:56 msgid "" "The :mod:`pickle` module differs from :mod:`marshal` in several significant " "ways:" msgstr "" -#: ../src/Doc/library/pickle.rst:58 +#: library/pickle.rst:58 msgid "" "The :mod:`pickle` module keeps track of the objects it has already " "serialized, so that later references to the same object won't be serialized " "again. :mod:`marshal` doesn't do this." msgstr "" -#: ../src/Doc/library/pickle.rst:62 +#: library/pickle.rst:62 msgid "" "This has implications both for recursive objects and object sharing. " "Recursive objects are objects that contain references to themselves. These " @@ -75601,7 +77283,7 @@ msgid "" "objects." msgstr "" -#: ../src/Doc/library/pickle.rst:71 +#: library/pickle.rst:71 msgid "" ":mod:`marshal` cannot be used to serialize user-defined classes and their " "instances. :mod:`pickle` can save and restore class instances " @@ -75609,7 +77291,7 @@ msgid "" "the same module as when the object was stored." msgstr "" -#: ../src/Doc/library/pickle.rst:76 +#: library/pickle.rst:76 msgid "" "The :mod:`marshal` serialization format is not guaranteed to be portable " "across Python versions. Because its primary job in life is to support :file:" @@ -75619,7 +77301,7 @@ msgid "" "compatible across Python releases." msgstr "" -#: ../src/Doc/library/pickle.rst:83 +#: library/pickle.rst:83 msgid "" "Note that serialization is a more primitive notion than persistence; " "although :mod:`pickle` reads and writes file objects, it does not handle the " @@ -75633,11 +77315,11 @@ msgid "" "and unpickle objects on DBM-style database files." msgstr "" -#: ../src/Doc/library/pickle.rst:96 +#: library/pickle.rst:96 msgid "Data stream format" msgstr "" -#: ../src/Doc/library/pickle.rst:102 +#: library/pickle.rst:102 msgid "" "The data format used by :mod:`pickle` is Python-specific. This has the " "advantage that there are no restrictions imposed by external standards such " @@ -75646,7 +77328,7 @@ msgid "" msgstr "" # c4bbef00afe64b36bfd652269622684b -#: ../src/Doc/library/pickle.rst:107 +#: library/pickle.rst:107 msgid "" "By default, the :mod:`pickle` data format uses a printable ASCII " "representation. This is slightly more voluminous than a binary " @@ -75657,56 +77339,60 @@ msgid "" msgstr "" # 0377e7b2e7fb462c8dba7d942518c862 -#: ../src/Doc/library/pickle.rst:113 +#: library/pickle.rst:113 msgid "" "There are currently 3 different protocols which can be used for pickling." msgstr "" # c033e38f98234a8f98563073b3b88432 -#: ../src/Doc/library/pickle.rst:115 +#: library/pickle.rst:115 msgid "" "Protocol version 0 is the original ASCII protocol and is backwards " "compatible with earlier versions of Python." msgstr "" -#: ../src/Doc/library/pickle.rst:118 +#: library/pickle.rst:118 msgid "" "Protocol version 1 is the old binary format which is also compatible with " "earlier versions of Python." msgstr "" -#: ../src/Doc/library/pickle.rst:121 +#: library/pickle.rst:121 msgid "" "Protocol version 2 was introduced in Python 2.3. It provides much more " "efficient pickling of :term:`new-style class`\\es." msgstr "" # 07c79dd061934d0488c0bcb9812dacc8 -#: ../src/Doc/library/pickle.rst:124 +#: library/pickle.rst:124 msgid "Refer to :pep:`307` for more information." msgstr "" # 1fe8ffd822e84bc38cfd4ecb51c69b0c -#: ../src/Doc/library/pickle.rst:126 +#: library/pickle.rst:126 msgid "" "If a *protocol* is not specified, protocol 0 is used. If *protocol* is " "specified as a negative value or :const:`HIGHEST_PROTOCOL`, the highest " "protocol version available will be used." msgstr "" +#: library/pickle.rst:130 library/pickle.rst:176 library/pickle.rst:252 +msgid "Introduced the *protocol* parameter." +msgstr "" + # b39ae7eb538d487a8cdbbc2b65654ba9 -#: ../src/Doc/library/pickle.rst:133 +#: library/pickle.rst:133 msgid "" "A binary format, which is slightly more efficient, can be chosen by " "specifying a *protocol* version >= 1." msgstr "" # ea74fd2b14cc4d87b8ac21fcae36d547 -#: ../src/Doc/library/pickle.rst:138 +#: library/pickle.rst:138 msgid "Usage" msgstr "" -#: ../src/Doc/library/pickle.rst:140 +#: library/pickle.rst:140 msgid "" "To serialize an object hierarchy, you first create a pickler, then you call " "the pickler's :meth:`dump` method. To de-serialize a data stream, you first " @@ -75714,14 +77400,14 @@ msgid "" "The :mod:`pickle` module provides the following constant:" msgstr "" -#: ../src/Doc/library/pickle.rst:148 +#: library/pickle.rst:148 msgid "" "The highest protocol version available. This value can be passed as a " "*protocol* value." msgstr "" # d44b1c4b9224469499cf5939d0352004 -#: ../src/Doc/library/pickle.rst:155 +#: library/pickle.rst:155 msgid "" "Be sure to always open pickle files created with protocols >= 1 in binary " "mode. For the old ASCII-based pickle protocol 0 you can use either text mode " @@ -75729,20 +77415,20 @@ msgid "" msgstr "" # b847175804c84fb3a7f346dd939c0b84 -#: ../src/Doc/library/pickle.rst:159 +#: library/pickle.rst:159 msgid "" "A pickle file written with protocol 0 in binary mode will contain lone " "linefeeds as line terminators and therefore will look \"funny\" when viewed " "in Notepad or other editors which do not support this format." msgstr "" -#: ../src/Doc/library/pickle.rst:163 +#: library/pickle.rst:163 msgid "" "The :mod:`pickle` module provides the following functions to make the " "pickling process more convenient:" msgstr "" -#: ../src/Doc/library/pickle.rst:169 +#: library/pickle.rst:169 msgid "" "Write a pickled representation of *obj* to the open file object *file*. " "This is equivalent to ``Pickler(file, protocol).dump(obj)``." @@ -75751,8 +77437,7 @@ msgstr "" # 6ad4d28d014f45309fc6dd44da1b4c5c # b80185912f1445e2b6cc69a093567c84 # d40bb19540ae4fed83ffb6843c3b3744 -#: ../src/Doc/library/pickle.rst:172 ../src/Doc/library/pickle.rst:205 -#: ../src/Doc/library/pickle.rst:248 +#: library/pickle.rst:172 library/pickle.rst:205 library/pickle.rst:248 msgid "" "If the *protocol* parameter is omitted, protocol 0 is used. If *protocol* is " "specified as a negative value or :const:`HIGHEST_PROTOCOL`, the highest " @@ -75760,7 +77445,7 @@ msgid "" msgstr "" # 0cda3fdbfae348f8b88ac14a4d38f046 -#: ../src/Doc/library/pickle.rst:179 +#: library/pickle.rst:179 msgid "" "*file* must have a :meth:`write` method that accepts a single string " "argument. It can thus be a file object opened for writing, a :mod:`StringIO` " @@ -75768,7 +77453,7 @@ msgid "" msgstr "" # d06210d69ab14db590497e30502b8432 -#: ../src/Doc/library/pickle.rst:186 +#: library/pickle.rst:186 msgid "" "Read a string from the open file object *file* and interpret it as a pickle " "data stream, reconstructing and returning the original object hierarchy. " @@ -75777,7 +77462,7 @@ msgstr "" # 774cf5a8acfa40cf85b517fc990c0436 # 7eab068d629e46af823ff7854536396a -#: ../src/Doc/library/pickle.rst:190 ../src/Doc/library/pickle.rst:304 +#: library/pickle.rst:190 library/pickle.rst:304 msgid "" "*file* must have two methods, a :meth:`read` method that takes an integer " "argument, and a :meth:`readline` method that requires no arguments. Both " @@ -75787,47 +77472,51 @@ msgid "" msgstr "" # b2bce2750e27433ea472ae2d2902cf21 -#: ../src/Doc/library/pickle.rst:196 +#: library/pickle.rst:196 msgid "" "This function automatically determines whether the data stream was written " "in binary mode or not." msgstr "" # 5b7f16e4a7354cb5bf3ca4ffaccab8fb -#: ../src/Doc/library/pickle.rst:202 +#: library/pickle.rst:202 msgid "" "Return the pickled representation of the object as a string, instead of " "writing it to a file." msgstr "" +#: library/pickle.rst:209 library/shelve.rst:32 library/shelve.rst:114 +msgid "The *protocol* parameter was added." +msgstr "" + # 1797246ccd924dcd85f8af7e6219b345 -#: ../src/Doc/library/pickle.rst:215 +#: library/pickle.rst:215 msgid "" "Read a pickled object hierarchy from a string. Characters in the string " "past the pickled object's representation are ignored." msgstr "" # 989cea2cb47540519ef7397833275d06 -#: ../src/Doc/library/pickle.rst:218 +#: library/pickle.rst:218 msgid "The :mod:`pickle` module also defines three exceptions:" msgstr "" # 5921126d1397440bbec5d8e922fc2235 -#: ../src/Doc/library/pickle.rst:223 +#: library/pickle.rst:223 msgid "" "A common base class for the other exceptions defined below. This inherits " "from :exc:`Exception`." msgstr "" # 825b709b4ff14a2fa5d61b35d073206b -#: ../src/Doc/library/pickle.rst:229 +#: library/pickle.rst:229 msgid "" "This exception is raised when an unpicklable object is passed to the :meth:" "`dump` method." msgstr "" # 0137dc08671b40bb991e31490dc1d187 -#: ../src/Doc/library/pickle.rst:235 +#: library/pickle.rst:235 msgid "" "This exception is raised when there is a problem unpickling an object. Note " "that other exceptions may also be raised during unpickling, including (but " @@ -75836,20 +77525,20 @@ msgid "" msgstr "" # d64feb786eca4830a44c2fbf751ec9c8 -#: ../src/Doc/library/pickle.rst:240 +#: library/pickle.rst:240 msgid "" "The :mod:`pickle` module also exports two callables [#]_, :class:`Pickler` " "and :class:`Unpickler`:" msgstr "" # ffd22c13f9714cc9b36d8e053953c222 -#: ../src/Doc/library/pickle.rst:246 +#: library/pickle.rst:246 msgid "" "This takes a file-like object to which it will write a pickle data stream." msgstr "" # 4682b50e4a124e05a8090bd0ed411c3c -#: ../src/Doc/library/pickle.rst:255 +#: library/pickle.rst:255 msgid "" "*file* must have a :meth:`write` method that accepts a single string " "argument. It can thus be an open file object, a :mod:`StringIO` object, or " @@ -75857,12 +77546,12 @@ msgid "" msgstr "" # 8b1345602d81459ba1e28e53828efda9 -#: ../src/Doc/library/pickle.rst:259 +#: library/pickle.rst:259 msgid ":class:`Pickler` objects define one (or two) public methods:" msgstr "" # 9c10ab0bb7484f6894b6b9ab213cec38 -#: ../src/Doc/library/pickle.rst:264 +#: library/pickle.rst:264 msgid "" "Write a pickled representation of *obj* to the open file object given in the " "constructor. Either the binary or ASCII format will be used, depending on " @@ -75870,7 +77559,7 @@ msgid "" msgstr "" # c6c107d504be47d1a387a8ee3f6d7737 -#: ../src/Doc/library/pickle.rst:271 +#: library/pickle.rst:271 msgid "" "Clears the pickler's \"memo\". The memo is the data structure that " "remembers which objects the pickler has already seen, so that shared or " @@ -75879,7 +77568,7 @@ msgid "" msgstr "" # 8607f2a8b8d241f9bc89c740ce25de87 -#: ../src/Doc/library/pickle.rst:278 +#: library/pickle.rst:278 msgid "" "Prior to Python 2.3, :meth:`clear_memo` was only available on the picklers " "created by :mod:`cPickle`. In the :mod:`pickle` module, picklers have an " @@ -75889,14 +77578,14 @@ msgid "" msgstr "" # 6ae445b05f5b47beba00e95e46fb2516 -#: ../src/Doc/library/pickle.rst:285 +#: library/pickle.rst:285 msgid "" "Code that does not need to support older versions of Python should simply " "use :meth:`clear_memo`." msgstr "" # 1786235e991b4de685ae7099e9fedd13 -#: ../src/Doc/library/pickle.rst:288 +#: library/pickle.rst:288 msgid "" "It is possible to make multiple calls to the :meth:`dump` method of the " "same :class:`Pickler` instance. These must then be matched to the same " @@ -75907,12 +77596,12 @@ msgid "" msgstr "" # 4f402502892c44a78b128f8ad7dfe805 -#: ../src/Doc/library/pickle.rst:294 +#: library/pickle.rst:294 msgid ":class:`Unpickler` objects are defined as:" msgstr "" # 38298233ed744633830028f7f6331216 -#: ../src/Doc/library/pickle.rst:299 +#: library/pickle.rst:299 msgid "" "This takes a file-like object from which it will read a pickle data stream. " "This class automatically determines whether the data stream was written in " @@ -75921,26 +77610,26 @@ msgid "" msgstr "" # 6c9eb902ab7e4ee5bcc2e3d43cc176fc -#: ../src/Doc/library/pickle.rst:310 +#: library/pickle.rst:310 msgid ":class:`Unpickler` objects have one (or two) public methods:" msgstr "" # a6028a5a6f7d49629ebdf8757a2e823d -#: ../src/Doc/library/pickle.rst:315 +#: library/pickle.rst:315 msgid "" "Read a pickled object representation from the open file object given in the " "constructor, and return the reconstituted object hierarchy specified therein." msgstr "" # ab949041e7dc4d8b9a4ad28a846b8ca5 -#: ../src/Doc/library/pickle.rst:319 +#: library/pickle.rst:319 msgid "" "This method automatically determines whether the data stream was written in " "binary mode or not." msgstr "" # 04e2d8d249de4fcf86e760a1296e59a2 -#: ../src/Doc/library/pickle.rst:325 +#: library/pickle.rst:325 msgid "" "This is just like :meth:`load` except that it doesn't actually create any " "objects. This is useful primarily for finding what's called \"persistent ids" @@ -75949,53 +77638,53 @@ msgid "" msgstr "" # c20f79b3e2014bd28c837b5a41e1887c -#: ../src/Doc/library/pickle.rst:330 +#: library/pickle.rst:330 msgid "" "**Note:** the :meth:`noload` method is currently only available on :class:" "`Unpickler` objects created with the :mod:`cPickle` module. :mod:`pickle` " "module :class:`Unpickler`\\ s do not have the :meth:`noload` method." msgstr "" -#: ../src/Doc/library/pickle.rst:337 +#: library/pickle.rst:337 msgid "What can be pickled and unpickled?" msgstr "" -#: ../src/Doc/library/pickle.rst:339 +#: library/pickle.rst:339 msgid "The following types can be pickled:" msgstr "" -#: ../src/Doc/library/pickle.rst:341 +#: library/pickle.rst:341 msgid "``None``, ``True``, and ``False``" msgstr "" # d43658a450e240c38257472bf09b83e2 -#: ../src/Doc/library/pickle.rst:343 +#: library/pickle.rst:343 msgid "integers, long integers, floating point numbers, complex numbers" msgstr "" # 08d424af0f6041fba5e12ad0d6f19e73 -#: ../src/Doc/library/pickle.rst:345 +#: library/pickle.rst:345 msgid "normal and Unicode strings" msgstr "" -#: ../src/Doc/library/pickle.rst:347 +#: library/pickle.rst:347 msgid "tuples, lists, sets, and dictionaries containing only picklable objects" msgstr "" -#: ../src/Doc/library/pickle.rst:349 +#: library/pickle.rst:349 msgid "functions defined at the top level of a module" msgstr "" -#: ../src/Doc/library/pickle.rst:351 +#: library/pickle.rst:351 msgid "built-in functions defined at the top level of a module" msgstr "" -#: ../src/Doc/library/pickle.rst:353 +#: library/pickle.rst:353 msgid "classes that are defined at the top level of a module" msgstr "" # 1c97ea3a39374d4dad10e5b6868346a2 -#: ../src/Doc/library/pickle.rst:355 +#: library/pickle.rst:355 msgid "" "instances of such classes whose :attr:`~object.__dict__` or the result of " "calling :meth:`__getstate__` is picklable (see section :ref:`pickle-" @@ -76003,7 +77692,7 @@ msgid "" msgstr "" # 8a9c4af479314b67b46fe93a9013d604 -#: ../src/Doc/library/pickle.rst:359 +#: library/pickle.rst:359 msgid "" "Attempts to pickle unpicklable objects will raise the :exc:`PicklingError` " "exception; when this happens, an unspecified number of bytes may have " @@ -76014,7 +77703,7 @@ msgid "" msgstr "" # c395807a24e54621a496303b267376cd -#: ../src/Doc/library/pickle.rst:366 +#: library/pickle.rst:366 msgid "" "Note that functions (built-in and user-defined) are pickled by \"fully " "qualified\" name reference, not by value. This means that only the function " @@ -76025,7 +77714,7 @@ msgid "" "exception will be raised. [#]_" msgstr "" -#: ../src/Doc/library/pickle.rst:373 +#: library/pickle.rst:373 msgid "" "Similarly, classes are pickled by named reference, so the same restrictions " "in the unpickling environment apply. Note that none of the class's code or " @@ -76033,13 +77722,13 @@ msgid "" "not restored in the unpickling environment::" msgstr "" -#: ../src/Doc/library/pickle.rst:383 +#: library/pickle.rst:383 msgid "" "These restrictions are why picklable functions and classes must be defined " "in the top level of a module." msgstr "" -#: ../src/Doc/library/pickle.rst:386 +#: library/pickle.rst:386 msgid "" "Similarly, when class instances are pickled, their class's code and data are " "not pickled along with them. Only the instance data are pickled. This is " @@ -76052,12 +77741,12 @@ msgid "" msgstr "" # eb2a97e854514fd28d28b1b8cfb4722b -#: ../src/Doc/library/pickle.rst:398 +#: library/pickle.rst:398 msgid "The pickle protocol" msgstr "" # b9ffb50c092f403c98498583745f6f24 -#: ../src/Doc/library/pickle.rst:402 +#: library/pickle.rst:402 msgid "" "This section describes the \"pickling protocol\" that defines the interface " "between the pickler/unpickler and the objects that are being serialized. " @@ -76069,12 +77758,12 @@ msgid "" msgstr "" # 1742324dc37d4583b9dc3d270fc7e59d -#: ../src/Doc/library/pickle.rst:414 +#: library/pickle.rst:414 msgid "Pickling and unpickling normal class instances" msgstr "" # e22ea2f18e204aef8dbe455a25b60d85 -#: ../src/Doc/library/pickle.rst:418 +#: library/pickle.rst:418 msgid "" "When a pickled class instance is unpickled, its :meth:`__init__` method is " "normally *not* invoked. If it is desirable that the :meth:`__init__` method " @@ -76086,7 +77775,7 @@ msgid "" msgstr "" # 6caf6e952dc64cd1abe1b73236c9abdf -#: ../src/Doc/library/pickle.rst:428 +#: library/pickle.rst:428 msgid "" "New-style types can provide a :meth:`__getnewargs__` method that is used for " "protocol 2. Implementing this method is needed if the type establishes some " @@ -76097,14 +77786,14 @@ msgid "" msgstr "" # 54a293c0d4304f068868fc40769b2b49 -#: ../src/Doc/library/pickle.rst:437 +#: library/pickle.rst:437 msgid "" "where *args* is the result of calling :meth:`__getnewargs__` on the original " "object; if there is no :meth:`__getnewargs__`, an empty tuple is assumed." msgstr "" # 5ca1f06a837f475ba418938f2a96f0c3 -#: ../src/Doc/library/pickle.rst:442 +#: library/pickle.rst:442 msgid "" "Classes can further influence how their instances are pickled; if the class " "defines the method :meth:`__getstate__`, it is called and the return state " @@ -76114,7 +77803,7 @@ msgid "" msgstr "" # 6809519549cc487a9ba0855b79300fb1 -#: ../src/Doc/library/pickle.rst:450 +#: library/pickle.rst:450 msgid "" "Upon unpickling, if the class also defines the method :meth:`__setstate__`, " "it is called with the unpickled state. [#]_ If there is no :meth:" @@ -76125,13 +77814,13 @@ msgid "" msgstr "" # 37ddcfca285746da97a8ec27fee94985 -#: ../src/Doc/library/pickle.rst:459 +#: library/pickle.rst:459 msgid "" "For :term:`new-style class`\\es, if :meth:`__getstate__` returns a false " "value, the :meth:`__setstate__` method will not be called." msgstr "" -#: ../src/Doc/library/pickle.rst:464 +#: library/pickle.rst:464 msgid "" "At unpickling time, some methods like :meth:`__getattr__`, :meth:" "`__getattribute__`, or :meth:`__setattr__` may be called upon the instance. " @@ -76142,12 +77831,12 @@ msgid "" msgstr "" # fbcabc70eeac41628f8e63496d74e36d -#: ../src/Doc/library/pickle.rst:473 +#: library/pickle.rst:473 msgid "Pickling and unpickling extension types" msgstr "" # 3637919946e1427b9a995c58f2ac4882 -#: ../src/Doc/library/pickle.rst:477 +#: library/pickle.rst:477 msgid "" "When the :class:`Pickler` encounters an object of a type it knows nothing " "about --- such as an extension type --- it looks in two places for a hint of " @@ -76157,7 +77846,7 @@ msgid "" msgstr "" # 45d8b2dbe7db473aa61f72e211f1fcfd -#: ../src/Doc/library/pickle.rst:484 +#: library/pickle.rst:484 msgid "" "If a string is returned, it names a global variable whose contents are " "pickled as normal. The string returned by :meth:`__reduce__` should be the " @@ -76166,7 +77855,7 @@ msgid "" msgstr "" # 0aba7f9e2db243f18f69d4b930b5aa50 -#: ../src/Doc/library/pickle.rst:489 +#: library/pickle.rst:489 msgid "" "When a tuple is returned, it must be between two and five elements long. " "Optional elements can either be omitted, or ``None`` can be provided as " @@ -76176,7 +77865,7 @@ msgid "" msgstr "" # 62a0fe055e5c4d71b7731a8c9fc82f3a -#: ../src/Doc/library/pickle.rst:495 +#: library/pickle.rst:495 msgid "" "A callable object that will be called to create the initial version of the " "object. The next element of the tuple will provide arguments for this " @@ -76185,7 +77874,7 @@ msgid "" msgstr "" # cded199f4eb1416e82ca04530a718bf0 -#: ../src/Doc/library/pickle.rst:500 +#: library/pickle.rst:500 msgid "" "In the unpickling environment this object must be either a class, a callable " "registered as a \"safe constructor\" (see below), or it must have an " @@ -76195,12 +77884,16 @@ msgid "" msgstr "" # f8326bb7dc754b398556f0561ae31ab3 -#: ../src/Doc/library/pickle.rst:506 +#: library/pickle.rst:506 msgid "A tuple of arguments for the callable object." msgstr "" +#: library/pickle.rst:508 +msgid "Formerly, this argument could also be ``None``." +msgstr "" + # 59fd5bd850ee4e24866ec7f29ed363cc -#: ../src/Doc/library/pickle.rst:511 +#: library/pickle.rst:511 msgid "" "Optionally, the object's state, which will be passed to the object's :meth:" "`__setstate__` method as described in section :ref:`pickle-inst`. If the " @@ -76209,7 +77902,7 @@ msgid "" msgstr "" # 520acbe13dc443c69d21d6b89aec4f62 -#: ../src/Doc/library/pickle.rst:517 +#: library/pickle.rst:517 msgid "" "Optionally, an iterator (and not a sequence) yielding successive list " "items. These list items will be pickled, and appended to the object using " @@ -76222,7 +77915,7 @@ msgid "" msgstr "" # cb1c44a0180f49a1b88231b6c0d1b67c -#: ../src/Doc/library/pickle.rst:526 +#: library/pickle.rst:526 msgid "" "Optionally, an iterator (not a sequence) yielding successive dictionary " "items, which should be tuples of the form ``(key, value)``. These items " @@ -76232,7 +77925,7 @@ msgid "" msgstr "" # 70de4ba5cb704de2ba75f7718ee59d81 -#: ../src/Doc/library/pickle.rst:534 +#: library/pickle.rst:534 msgid "" "It is sometimes useful to know the protocol version when implementing :meth:" "`__reduce__`. This can be done by implementing a method named :meth:" @@ -76244,7 +77937,7 @@ msgid "" msgstr "" # 9e65bb433cc84da1bd5bc51de0d8cec4 -#: ../src/Doc/library/pickle.rst:542 +#: library/pickle.rst:542 msgid "" "The :class:`object` class implements both :meth:`__reduce__` and :meth:" "`__reduce_ex__`; however, if a subclass overrides :meth:`__reduce__` but " @@ -76253,7 +77946,7 @@ msgid "" msgstr "" # ba07bca2d4ab46dfb2b1d0c04988db0a -#: ../src/Doc/library/pickle.rst:547 +#: library/pickle.rst:547 msgid "" "An alternative to implementing a :meth:`__reduce__` method on the object to " "be pickled, is to register the callable with the :mod:`copy_reg` module. " @@ -76264,19 +77957,19 @@ msgid "" msgstr "" # d123050e6378461fa31adea1c588e77c -#: ../src/Doc/library/pickle.rst:554 +#: library/pickle.rst:554 msgid "" "The registered constructor is deemed a \"safe constructor\" for purposes of " "unpickling as described above." msgstr "" # a11b7e39975440b4bea6bc11b7656500 -#: ../src/Doc/library/pickle.rst:559 +#: library/pickle.rst:559 msgid "Pickling and unpickling external objects" msgstr "" # 7a32d47b6493497e82a534935af242bf -#: ../src/Doc/library/pickle.rst:565 +#: library/pickle.rst:565 msgid "" "For the benefit of object persistence, the :mod:`pickle` module supports the " "notion of a reference to an object outside the pickled data stream. Such " @@ -76287,7 +77980,7 @@ msgid "" msgstr "" # d28cdbdec7bd4acebc1b776aad10af4a -#: ../src/Doc/library/pickle.rst:572 +#: library/pickle.rst:572 msgid "" "To define external persistent id resolution, you need to set the :attr:" "`~Pickler.persistent_id` attribute of the pickler object and the :attr:" @@ -76295,7 +77988,7 @@ msgid "" msgstr "" # 38d35a8c48a045dba2d669636bec88d5 -#: ../src/Doc/library/pickle.rst:576 +#: library/pickle.rst:576 msgid "" "To pickle objects that have an external persistent id, the pickler must have " "a custom :func:`~Pickler.persistent_id` method that takes an object as an " @@ -76307,7 +78000,7 @@ msgid "" msgstr "" # a446e87781bb4e118ddd1d621cc9c15c -#: ../src/Doc/library/pickle.rst:584 +#: library/pickle.rst:584 msgid "" "To unpickle external objects, the unpickler must have a custom :func:" "`~Unpickler.persistent_load` function that takes a persistent id string and " @@ -76315,12 +78008,12 @@ msgid "" msgstr "" # d2584dfdd5b545e992942caa8341a21c -#: ../src/Doc/library/pickle.rst:588 +#: library/pickle.rst:588 msgid "Here's a silly example that *might* shed more light::" msgstr "" # 2f49ac6d598a4858b7028ba598b62065 -#: ../src/Doc/library/pickle.rst:636 +#: library/pickle.rst:636 msgid "" "In the :mod:`cPickle` module, the unpickler's :attr:`~Unpickler." "persistent_load` attribute can also be set to a Python list, in which case, " @@ -76333,12 +78026,12 @@ msgid "" msgstr "" # 6f6795d37b59455cbb283487345fac24 -#: ../src/Doc/library/pickle.rst:654 +#: library/pickle.rst:654 msgid "Subclassing Unpicklers" msgstr "" # 85334bfad74a40d487694be69272f538 -#: ../src/Doc/library/pickle.rst:660 +#: library/pickle.rst:660 msgid "" "By default, unpickling will import any class that it finds in the pickle " "data. You can control exactly what gets unpickled and what gets called by " @@ -76348,7 +78041,7 @@ msgid "" msgstr "" # c0f0d8178c6c4389bfc88bf20fbd36e2 -#: ../src/Doc/library/pickle.rst:665 +#: library/pickle.rst:665 msgid "" "In the :mod:`pickle` module, you need to derive a subclass from :class:" "`Unpickler`, overriding the :meth:`load_global` method. :meth:`load_global` " @@ -76367,7 +78060,7 @@ msgid "" msgstr "" # 3255b3ce52f048c383fb62d7447a8018 -#: ../src/Doc/library/pickle.rst:680 +#: library/pickle.rst:680 msgid "" "Things are a little cleaner with :mod:`cPickle`, but not by much. To control " "what gets unpickled, you can set the unpickler's :attr:`~Unpickler." @@ -76380,21 +78073,21 @@ msgid "" msgstr "" # d15c483c72eb43e3aa9df1a9a097a3fc -#: ../src/Doc/library/pickle.rst:689 +#: library/pickle.rst:689 msgid "" "The moral of the story is that you should be really careful about the source " "of the strings your application unpickles." msgstr "" # 8aa36dc9b7364ce6b648c2790d7ae7fe -#: ../src/Doc/library/pickle.rst:698 +#: library/pickle.rst:698 msgid "" "For the simplest code, use the :func:`dump` and :func:`load` functions. " "Note that a self-referencing list is pickled and restored correctly. ::" msgstr "" # ee36d341c62b492ba597b4cd03f40f2d -#: ../src/Doc/library/pickle.rst:720 +#: library/pickle.rst:720 msgid "" "The following example reads the resulting pickled data. When reading a " "pickle-containing file, you should open the file in binary mode because you " @@ -76402,7 +78095,7 @@ msgid "" msgstr "" # 76844a46a624462aa9bdd701978d9fe4 -#: ../src/Doc/library/pickle.rst:736 +#: library/pickle.rst:736 msgid "" "Here's a larger example that shows how to modify pickling behavior for a " "class. The :class:`TextReader` class opens a text file, and returns the line " @@ -76414,56 +78107,55 @@ msgid "" "behavior. ::" msgstr "" -#: ../src/Doc/library/pickle.rst:776 +#: library/pickle.rst:776 msgid "A sample usage might be something like this::" msgstr "" # 9f3aaa477f504a4fadbd12d6ebc75746 -#: ../src/Doc/library/pickle.rst:789 +#: library/pickle.rst:789 msgid "" "If you want to see that :mod:`pickle` works across Python processes, start " "another Python session, before continuing. What follows can happen from " "either the same process or a new process. ::" msgstr "" -# d62ab4de49774755a5dbaf3d93b85942 -#: ../src/Doc/library/pickle.rst:801 -msgid "Module :mod:`copy_reg`" +#: library/pickle.rst:802 +msgid "Module copy_reg" msgstr "" -#: ../src/Doc/library/pickle.rst:802 +#: library/pickle.rst:802 msgid "Pickle interface constructor registration for extension types." msgstr "" -#: ../src/Doc/library/pickle.rst:805 +#: library/pickle.rst:805 msgid "Indexed databases of objects; uses :mod:`pickle`." msgstr "" -# efefbe9eecbc40148d0564cd4f75aa30 -#: ../src/Doc/library/pickle.rst:807 -msgid "Module :mod:`copy`" -msgstr "" +#: library/pickle.rst:808 +#, fuzzy +msgid "Module copy" +msgstr "Modules" -#: ../src/Doc/library/pickle.rst:808 +#: library/pickle.rst:808 msgid "Shallow and deep object copying." msgstr "" -# 1d0685e1329f4385a9ce27dfe8be1ae8 -#: ../src/Doc/library/pickle.rst:809 -msgid "Module :mod:`marshal`" -msgstr "" +#: library/pickle.rst:810 +#, fuzzy +msgid "Module marshal" +msgstr "Modules" -#: ../src/Doc/library/pickle.rst:811 +#: library/pickle.rst:811 msgid "High-performance serialization of built-in types." msgstr "" # d564fbf6250c47408fa5d558e8783fd0 -#: ../src/Doc/library/pickle.rst:815 +#: library/pickle.rst:815 msgid ":mod:`cPickle` --- A faster :mod:`pickle`" msgstr "" # 05e10f6dd56d4ddc805c928d8e9bb669 -#: ../src/Doc/library/pickle.rst:825 +#: library/pickle.rst:825 msgid "" "The :mod:`cPickle` module supports serialization and de-serialization of " "Python objects, providing an interface and functionality nearly identical to " @@ -76472,7 +78164,7 @@ msgid "" msgstr "" # a89ee29f39964437abdffdf04f285bdb -#: ../src/Doc/library/pickle.rst:830 +#: library/pickle.rst:830 msgid "" "First, :mod:`cPickle` can be up to 1000 times faster than :mod:`pickle` " "because the former is implemented in C. Second, in the :mod:`cPickle` " @@ -76484,7 +78176,7 @@ msgid "" msgstr "" # d2a7d9ef10984bdeb8d222a104c3dec1 -#: ../src/Doc/library/pickle.rst:837 +#: library/pickle.rst:837 msgid "" "The pickle data stream produced by :mod:`pickle` and :mod:`cPickle` are " "identical, so it is possible to use :mod:`pickle` and :mod:`cPickle` " @@ -76492,7 +78184,7 @@ msgid "" msgstr "" # f67fb084d94f4f5abb1fedd248bad93d -#: ../src/Doc/library/pickle.rst:841 +#: library/pickle.rst:841 msgid "" "There are additional minor differences in API between :mod:`cPickle` and :" "mod:`pickle`, however for most applications, they are interchangeable. More " @@ -76500,12 +78192,12 @@ msgid "" "includes a list of the documented differences." msgstr "" -#: ../src/Doc/library/pickle.rst:848 +#: library/pickle.rst:848 msgid "Don't confuse this with the :mod:`marshal` module" msgstr "" # e2dae5ee5661490eb1fd9e5fca8b35d2 -#: ../src/Doc/library/pickle.rst:850 +#: library/pickle.rst:850 msgid "" "In the :mod:`pickle` module these callables are classes, which you could " "subclass to customize the behavior. However, in the :mod:`cPickle` module " @@ -76515,7 +78207,7 @@ msgid "" msgstr "" # 4f682ddfe48b4b3db05dc469d4dee1b6 -#: ../src/Doc/library/pickle.rst:856 +#: library/pickle.rst:856 msgid "" "*Warning*: this is intended for pickling multiple objects without " "intervening modifications to the objects or their parts. If you modify an " @@ -76526,26 +78218,26 @@ msgid "" "of changes. Garbage Collection may also become a problem here." msgstr "" -#: ../src/Doc/library/pickle.rst:864 +#: library/pickle.rst:864 msgid "" "The exception raised will likely be an :exc:`ImportError` or an :exc:" "`AttributeError` but it could be something else." msgstr "" # 38c1d6381a664197b55abe95d123403b -#: ../src/Doc/library/pickle.rst:867 +#: library/pickle.rst:867 msgid "These methods can also be used to implement copying class instances." msgstr "" # 3cc485a26efc42dd8d139505d10ef18e -#: ../src/Doc/library/pickle.rst:869 +#: library/pickle.rst:869 msgid "" "This protocol is also used by the shallow and deep copying operations " "defined in the :mod:`copy` module." msgstr "" # 66fbe15cd23c4d4788cba97ac36aea5c -#: ../src/Doc/library/pickle.rst:872 +#: library/pickle.rst:872 msgid "" "The actual mechanism for associating these user defined functions is " "slightly different for :mod:`pickle` and :mod:`cPickle`. The description " @@ -76556,14 +78248,14 @@ msgid "" msgstr "" # ba6e60ed70d747519eeceb019ce15610 -#: ../src/Doc/library/pickle.rst:879 +#: library/pickle.rst:879 msgid "" "We'll leave you with the image of Guido and Jim sitting around sniffing " "pickles in their living rooms." msgstr "" # 445590e7ed474c3187efa55cbefbb059 -#: ../src/Doc/library/pickle.rst:882 +#: library/pickle.rst:882 msgid "" "A word of caution: the mechanisms described here use internal attributes and " "methods, which are subject to change in future versions of Python. We " @@ -76572,7 +78264,7 @@ msgid "" msgstr "" # 51fd2e4b9ad24df4a73feb3af8fc094b -#: ../src/Doc/library/pickle.rst:887 +#: library/pickle.rst:887 msgid "" "Since the pickle data format is actually a tiny stack-oriented programming " "language, and some freedom is taken in the encodings of certain objects, it " @@ -76581,17 +78273,17 @@ msgid "" "read each other's data streams." msgstr "" -#: ../src/Doc/library/pickletools.rst:2 +#: library/pickletools.rst:2 msgid ":mod:`pickletools` --- Tools for pickle developers" msgstr "" # ca9bb94c7a464d12b3aceb05fb10cacf -#: ../src/Doc/library/pickletools.rst:11 +#: library/pickletools.rst:11 msgid "**Source code:** :source:`Lib/pickletools.py`" msgstr "" # 9bb4473850da4c56905c60d3c0f7111e -#: ../src/Doc/library/pickletools.rst:15 +#: library/pickletools.rst:15 msgid "" "This module contains various constants relating to the intimate details of " "the :mod:`pickle` module, some lengthy comments about the implementation, " @@ -76601,7 +78293,7 @@ msgid "" "`pickle` module probably won't find the :mod:`pickletools` module relevant." msgstr "" -#: ../src/Doc/library/pickletools.rst:25 +#: library/pickletools.rst:25 msgid "" "Outputs a symbolic disassembly of the pickle to the file-like object *out*, " "defaulting to ``sys.stdout``. *pickle* can be a string or a file-like " @@ -76611,7 +78303,7 @@ msgid "" "opcodes in the stream, are indented by *indentlevel* spaces." msgstr "" -#: ../src/Doc/library/pickletools.rst:35 +#: library/pickletools.rst:35 msgid "" "Provides an :term:`iterator` over all of the opcodes in a pickle, returning " "a sequence of ``(opcode, arg, pos)`` triples. *opcode* is an instance of " @@ -76620,40 +78312,47 @@ msgid "" "is located. *pickle* can be a string or a file-like object." msgstr "" -#: ../src/Doc/library/pickletools.rst:43 +#: library/pickletools.rst:43 msgid "" "Returns a new equivalent pickle string after eliminating unused ``PUT`` " "opcodes. The optimized pickle is shorter, takes less transmission time, " "requires less storage space, and unpickles more efficiently." msgstr "" -#: ../src/Doc/library/pipes.rst:2 +#: library/pipes.rst:2 msgid ":mod:`pipes` --- Interface to shell pipelines" msgstr "" # e14b174ff143422cbc7578a322678f01 -#: ../src/Doc/library/pipes.rst:9 +#: library/pipes.rst:9 msgid "**Source code:** :source:`Lib/pipes.py`" msgstr "" -#: ../src/Doc/library/pipes.rst:13 +#: library/pipes.rst:13 msgid "" "The :mod:`pipes` module defines a class to abstract the concept of a " "*pipeline* --- a sequence of converters from one file to another." msgstr "" -#: ../src/Doc/library/pipes.rst:16 +#: library/pipes.rst:16 msgid "" "Because the module uses :program:`/bin/sh` command lines, a POSIX or " "compatible shell for :func:`os.system` and :func:`os.popen` is required." msgstr "" -#: ../src/Doc/library/pipes.rst:22 +#: library/pipes.rst:22 msgid "An abstraction of a pipeline." msgstr "" +#: library/pipes.rst:38 +msgid "" +"Prior to Python 2.7, this function was not publicly documented. It is " +"finally exposed publicly in Python 3.3 as the :func:`quote ` " +"function in the :mod:`shlex` module." +msgstr "" + # dbba3d5b66ee4c5a98a7fd2d310bb151 -#: ../src/Doc/library/pipes.rst:43 +#: library/pipes.rst:43 msgid "" "Return a shell-escaped version of the string *s*. The returned value is a " "string that can safely be used as one token in a shell command line, for " @@ -76661,51 +78360,51 @@ msgid "" msgstr "" # 45965da4a88949719e46def8cd0f18cb -#: ../src/Doc/library/pipes.rst:47 +#: library/pipes.rst:47 msgid "This idiom would be unsafe::" msgstr "" # b1e72437162f4261b744838b941f5212 -#: ../src/Doc/library/pipes.rst:54 +#: library/pipes.rst:54 msgid ":func:`quote` lets you plug the security hole::" msgstr "" # 9770aa584c584049b799958d5287db04 -#: ../src/Doc/library/pipes.rst:63 +#: library/pipes.rst:63 msgid "" "The quoting is compatible with UNIX shells and with :func:`shlex.split`:" msgstr "" -#: ../src/Doc/library/pipes.rst:76 +#: library/pipes.rst:76 msgid "Template Objects" msgstr "" -#: ../src/Doc/library/pipes.rst:78 +#: library/pipes.rst:78 msgid "Template objects following methods:" msgstr "" -#: ../src/Doc/library/pipes.rst:83 +#: library/pipes.rst:83 msgid "Restore a pipeline template to its initial state." msgstr "" -#: ../src/Doc/library/pipes.rst:88 +#: library/pipes.rst:88 msgid "Return a new, equivalent, pipeline template." msgstr "" -#: ../src/Doc/library/pipes.rst:93 +#: library/pipes.rst:93 msgid "" "If *flag* is true, turn debugging on. Otherwise, turn debugging off. When " "debugging is on, commands to be executed are printed, and the shell is given " "``set -x`` command to be more verbose." msgstr "" -#: ../src/Doc/library/pipes.rst:100 +#: library/pipes.rst:100 msgid "" "Append a new action at the end. The *cmd* variable must be a valid bourne " "shell command. The *kind* variable consists of two letters." msgstr "" -#: ../src/Doc/library/pipes.rst:103 +#: library/pipes.rst:103 msgid "" "The first letter can be either of ``'-'`` (which means the command reads its " "standard input), ``'f'`` (which means the commands reads a given file on the " @@ -76713,7 +78412,7 @@ msgid "" "must be first.)" msgstr "" -#: ../src/Doc/library/pipes.rst:108 +#: library/pipes.rst:108 msgid "" "Similarly, the second letter can be either of ``'-'`` (which means the " "command writes to standard output), ``'f'`` (which means the command writes " @@ -76721,46 +78420,46 @@ msgid "" "write anything, and hence must be last.)" msgstr "" -#: ../src/Doc/library/pipes.rst:116 +#: library/pipes.rst:116 msgid "" "Add a new action at the beginning. See :meth:`append` for explanations of " "the arguments." msgstr "" -#: ../src/Doc/library/pipes.rst:122 +#: library/pipes.rst:122 msgid "" "Return a file-like object, open to *file*, but read from or written to by " "the pipeline. Note that only one of ``'r'``, ``'w'`` may be given." msgstr "" -#: ../src/Doc/library/pipes.rst:128 +#: library/pipes.rst:128 msgid "Copy *infile* to *outfile* through the pipe." msgstr "" -#: ../src/Doc/library/pkgutil.rst:2 +#: library/pkgutil.rst:2 msgid ":mod:`pkgutil` --- Package extension utility" msgstr "" # f3ca377485c0403d9249efb71856eaf8 -#: ../src/Doc/library/pkgutil.rst:9 +#: library/pkgutil.rst:9 msgid "**Source code:** :source:`Lib/pkgutil.py`" msgstr "" # 58dc0d5674eb4a0f9e34d2e88ceca3a0 -#: ../src/Doc/library/pkgutil.rst:13 +#: library/pkgutil.rst:13 msgid "" "This module provides utilities for the import system, in particular package " "support." msgstr "" # ead65b793b9b432296dceec85698cdad -#: ../src/Doc/library/pkgutil.rst:19 +#: library/pkgutil.rst:19 msgid "" "Extend the search path for the modules which comprise a package. Intended " "use is to place the following code in a package's :file:`__init__.py`::" msgstr "" -#: ../src/Doc/library/pkgutil.rst:25 +#: library/pkgutil.rst:25 msgid "" "This will add to the package's ``__path__`` all subdirectories of " "directories on ``sys.path`` named after the package. This is useful if one " @@ -76768,7 +78467,7 @@ msgid "" "directories." msgstr "" -#: ../src/Doc/library/pkgutil.rst:30 +#: library/pkgutil.rst:30 msgid "" "It also looks for :file:`\\*.pkg` files beginning where ``*`` matches the " "*name* argument. This feature is similar to :file:`\\*.pth` files (see the :" @@ -76779,7 +78478,7 @@ msgid "" "filesystem. (This is a feature.)" msgstr "" -#: ../src/Doc/library/pkgutil.rst:38 +#: library/pkgutil.rst:38 msgid "" "If the input path is not a list (as is the case for frozen packages) it is " "returned unchanged. The input path is not modified; an extended copy is " @@ -76787,7 +78486,7 @@ msgid "" msgstr "" # 907ea32181304ac7bc3cab9ca78b38a7 -#: ../src/Doc/library/pkgutil.rst:42 +#: library/pkgutil.rst:42 msgid "" "It is assumed that :data:`sys.path` is a sequence. Items of :data:`sys." "path` that are not (Unicode or 8-bit) strings referring to existing " @@ -76797,12 +78496,12 @@ msgid "" msgstr "" # 097a006a295c46b195e7e8f9398f813f -#: ../src/Doc/library/pkgutil.rst:51 +#: library/pkgutil.rst:51 msgid ":pep:`302` Importer that wraps Python's \"classic\" import algorithm." msgstr "" # f839e01dec4c4a3199d14a099b7682d0 -#: ../src/Doc/library/pkgutil.rst:53 +#: library/pkgutil.rst:53 msgid "" "If *dirname* is a string, a :pep:`302` importer is created that searches " "that directory. If *dirname* is ``None``, a :pep:`302` importer is created " @@ -76811,24 +78510,24 @@ msgid "" msgstr "" # e7fc87a0346b47a9ab7ba39b59c7c426 -#: ../src/Doc/library/pkgutil.rst:58 +#: library/pkgutil.rst:58 msgid "" "Note that :class:`ImpImporter` does not currently support being used by " "placement on :data:`sys.meta_path`." msgstr "" # 32c4f855e9d34ba891736d182e17c20d -#: ../src/Doc/library/pkgutil.rst:64 +#: library/pkgutil.rst:64 msgid ":pep:`302` Loader that wraps Python's \"classic\" import algorithm." msgstr "" # 23ad7e2aacc74fc9bf3f668fda805e10 -#: ../src/Doc/library/pkgutil.rst:69 +#: library/pkgutil.rst:69 msgid "Find a :pep:`302` \"loader\" object for *fullname*." msgstr "" # 9cf73a85883042cdab121033a865ef97 -#: ../src/Doc/library/pkgutil.rst:71 +#: library/pkgutil.rst:71 msgid "" "If *fullname* contains dots, path must be the containing package's " "``__path__``. Returns ``None`` if the module cannot be found or imported. " @@ -76838,19 +78537,19 @@ msgid "" msgstr "" # 68f2bed2738a4f8fb39680711b350d11 -#: ../src/Doc/library/pkgutil.rst:80 +#: library/pkgutil.rst:80 msgid "Retrieve a :pep:`302` importer for the given *path_item*." msgstr "" # 43c9232fd6994808840aa9d42e2a8598 -#: ../src/Doc/library/pkgutil.rst:82 +#: library/pkgutil.rst:82 msgid "" "The returned importer is cached in :data:`sys.path_importer_cache` if it was " "newly created by a path hook." msgstr "" # fb1c4fac923642b6aa581863e5c8435a -#: ../src/Doc/library/pkgutil.rst:85 +#: library/pkgutil.rst:85 msgid "" "If there is no importer, a wrapper around the basic import machinery is " "returned. This wrapper is never inserted into the importer cache (``None`` " @@ -76858,19 +78557,19 @@ msgid "" msgstr "" # 5c7414cd2db54688883e4c64d155bf24 -#: ../src/Doc/library/pkgutil.rst:89 +#: library/pkgutil.rst:89 msgid "" "The cache (or part of it) can be cleared manually if a rescan of :data:`sys." "path_hooks` is necessary." msgstr "" # 070bf3af17644023a26565cea9ecf619 -#: ../src/Doc/library/pkgutil.rst:95 +#: library/pkgutil.rst:95 msgid "Get a :pep:`302` \"loader\" object for *module_or_name*." msgstr "" # b35acfbd487d4d0dba69ad3cfd8a0d2b -#: ../src/Doc/library/pkgutil.rst:97 +#: library/pkgutil.rst:97 msgid "" "If the module or package is accessible via the normal import mechanism, a " "wrapper around the relevant part of that machinery is returned. Returns " @@ -76880,7 +78579,7 @@ msgid "" msgstr "" # e816f299cf61431fbaa3940bbef8d7c8 -#: ../src/Doc/library/pkgutil.rst:103 +#: library/pkgutil.rst:103 msgid "" "This function uses :func:`iter_importers`, and is thus subject to the same " "limitations regarding platform-specific special import locations such as the " @@ -76888,12 +78587,12 @@ msgid "" msgstr "" # 71a4955fe7fc49eb9fc45bb3749cd825 -#: ../src/Doc/library/pkgutil.rst:110 +#: library/pkgutil.rst:110 msgid "Yield :pep:`302` importers for the given module name." msgstr "" # f664c636c3c745cd9183b37adfe03ef1 -#: ../src/Doc/library/pkgutil.rst:112 +#: library/pkgutil.rst:112 msgid "" "If fullname contains a '.', the importers will be for the package containing " "fullname, otherwise they will be importers for :data:`sys.meta_path`, :data:" @@ -76903,7 +78602,7 @@ msgid "" msgstr "" # 087d83f3072e44588a1217946050ac11 -#: ../src/Doc/library/pkgutil.rst:118 +#: library/pkgutil.rst:118 msgid "" "Non-:pep:`302` mechanisms (e.g. the Windows registry) used by the standard " "import machinery to find files in alternative locations are partially " @@ -76913,7 +78612,7 @@ msgid "" msgstr "" # 46b8063a1441431c8003aac1e70ba1a7 -#: ../src/Doc/library/pkgutil.rst:124 +#: library/pkgutil.rst:124 msgid "" "For this to cause a visible difference in behaviour, there must be a module " "or package name that is accessible via both :data:`sys.path` and one of the " @@ -76923,14 +78622,14 @@ msgid "" msgstr "" # 551c9735a54e4bca9c5b3cb2db3ffbe6 -#: ../src/Doc/library/pkgutil.rst:129 +#: library/pkgutil.rst:129 msgid "" "Items of the following types can be affected by this discrepancy: ``imp." "C_EXTENSION``, ``imp.PY_SOURCE``, ``imp.PY_COMPILED``, ``imp.PKG_DIRECTORY``." msgstr "" # fdb62feb340042e49cf818b9a842bd67 -#: ../src/Doc/library/pkgutil.rst:136 +#: library/pkgutil.rst:136 msgid "" "Yields ``(module_loader, name, ispkg)`` for all submodules on *path*, or, if " "path is ``None``, all top-level modules on ``sys.path``." @@ -76938,27 +78637,27 @@ msgstr "" # dab32bf9ef4143488775ce61181f0109 # d190ae89c536411595713ac1bf968fec -#: ../src/Doc/library/pkgutil.rst:139 ../src/Doc/library/pkgutil.rst:149 +#: library/pkgutil.rst:139 library/pkgutil.rst:149 msgid "" "*path* should be either ``None`` or a list of paths to look for modules in." msgstr "" # 8cbd9a619bb7400b8affc3bca2fda37a # 1e9bf16c87114fd18c43308c061226bd -#: ../src/Doc/library/pkgutil.rst:141 ../src/Doc/library/pkgutil.rst:151 +#: library/pkgutil.rst:141 library/pkgutil.rst:151 msgid "" "*prefix* is a string to output on the front of every module name on output." msgstr "" # 529aaeae7d5542b19f863a96023305f6 -#: ../src/Doc/library/pkgutil.rst:146 +#: library/pkgutil.rst:146 msgid "" "Yields ``(module_loader, name, ispkg)`` for all modules recursively on " "*path*, or, if path is ``None``, all accessible modules." msgstr "" # 0144bfd5f83a4a2aa0f4e3b4f1406e07 -#: ../src/Doc/library/pkgutil.rst:153 +#: library/pkgutil.rst:153 msgid "" "Note that this function must import all *packages* (*not* all modules!) on " "the given *path*, in order to access the ``__path__`` attribute to find " @@ -76966,7 +78665,7 @@ msgid "" msgstr "" # b8fa1d912918487bb3ff6b9c45afe9ae -#: ../src/Doc/library/pkgutil.rst:157 +#: library/pkgutil.rst:157 msgid "" "*onerror* is a function which gets called with one argument (the name of the " "package which was being imported) if any exception occurs while trying to " @@ -76980,18 +78679,17 @@ msgstr "" # a9e05248160a4fdf80385fbff091d2a4 # 96cf0e15832e411ebc01031fa77fc76e # d847b344496a4052b3f322caccd2d881 -#: ../src/Doc/library/pkgutil.rst:163 ../src/Doc/library/posixfile.rst:180 -#: ../src/Doc/library/subprocess.rst:56 ../src/Doc/library/subprocess.rst:90 -#: ../src/Doc/library/subprocess.rst:131 +#: library/pkgutil.rst:163 library/posixfile.rst:180 library/subprocess.rst:56 +#: library/subprocess.rst:90 library/subprocess.rst:131 msgid "Examples::" msgstr "Exemples ::" -#: ../src/Doc/library/pkgutil.rst:174 +#: library/pkgutil.rst:174 msgid "Get a resource from a package." msgstr "" # 3b4f9d7ee30847c59a5b99cb4df9ae62 -#: ../src/Doc/library/pkgutil.rst:176 +#: library/pkgutil.rst:176 msgid "" "This is a wrapper for the :pep:`302` loader :func:`get_data` API. The " "*package* argument should be the name of a package, in standard module " @@ -77000,51 +78698,51 @@ msgid "" "name ``..`` is not allowed, and nor is a rooted name (starting with a ``/``)." msgstr "" -#: ../src/Doc/library/pkgutil.rst:182 +#: library/pkgutil.rst:182 msgid "" "The function returns a binary string that is the contents of the specified " "resource." msgstr "" -#: ../src/Doc/library/pkgutil.rst:185 +#: library/pkgutil.rst:185 msgid "" "For packages located in the filesystem, which have already been imported, " "this is the rough equivalent of::" msgstr "" # d2468e56ec9e460187e44fde82a2426c -#: ../src/Doc/library/pkgutil.rst:191 +#: library/pkgutil.rst:191 msgid "" "If the package cannot be located or loaded, or it uses a :pep:`302` loader " "which does not support :func:`get_data`, then ``None`` is returned." msgstr "" -#: ../src/Doc/library/platform.rst:2 +#: library/platform.rst:2 msgid ":mod:`platform` --- Access to underlying platform's identifying data" msgstr "" # b00e5c63cfce4e8d98a4966e8a4f92b1 -#: ../src/Doc/library/platform.rst:12 +#: library/platform.rst:12 msgid "**Source code:** :source:`Lib/platform.py`" msgstr "" -#: ../src/Doc/library/platform.rst:18 +#: library/platform.rst:18 msgid "" "Specific platforms listed alphabetically, with Linux included in the Unix " "section." msgstr "" -#: ../src/Doc/library/platform.rst:23 +#: library/platform.rst:23 msgid "Cross Platform" msgstr "" -#: ../src/Doc/library/platform.rst:28 +#: library/platform.rst:28 msgid "" "Queries the given executable (defaults to the Python interpreter binary) for " "various architecture information." msgstr "" -#: ../src/Doc/library/platform.rst:31 +#: library/platform.rst:31 msgid "" "Returns a tuple ``(bits, linkage)`` which contain information about the bit " "architecture and the linkage format used for the executable. Both values are " @@ -77052,7 +78750,7 @@ msgid "" msgstr "" # 24723f32f27d4c60888f41e5ff8b83ee -#: ../src/Doc/library/platform.rst:35 +#: library/platform.rst:35 msgid "" "Values that cannot be determined are returned as given by the parameter " "presets. If bits is given as ``''``, the :c:func:`sizeof(pointer)` (or :c:" @@ -77060,7 +78758,7 @@ msgid "" "supported pointer size." msgstr "" -#: ../src/Doc/library/platform.rst:40 +#: library/platform.rst:40 msgid "" "The function relies on the system's :file:`file` command to do the actual " "work. This is available on most if not all Unix platforms and some non-Unix " @@ -77069,44 +78767,44 @@ msgid "" msgstr "" # 73c6734e750c4a1b8972a4e695766bb8 -#: ../src/Doc/library/platform.rst:47 +#: library/platform.rst:47 msgid "" "On Mac OS X (and perhaps other platforms), executable files may be universal " "files containing multiple architectures." msgstr "" # 8dd29fefe7644b419136295c77be60d8 -#: ../src/Doc/library/platform.rst:50 +#: library/platform.rst:50 msgid "" "To get at the \"64-bitness\" of the current interpreter, it is more reliable " "to query the :attr:`sys.maxsize` attribute::" msgstr "" -#: ../src/Doc/library/platform.rst:58 +#: library/platform.rst:58 msgid "" "Returns the machine type, e.g. ``'i386'``. An empty string is returned if " "the value cannot be determined." msgstr "" -#: ../src/Doc/library/platform.rst:64 +#: library/platform.rst:64 msgid "" "Returns the computer's network name (may not be fully qualified!). An empty " "string is returned if the value cannot be determined." msgstr "" -#: ../src/Doc/library/platform.rst:70 +#: library/platform.rst:70 msgid "" "Returns a single string identifying the underlying platform with as much " "useful information as possible." msgstr "" -#: ../src/Doc/library/platform.rst:73 +#: library/platform.rst:73 msgid "" "The output is intended to be *human readable* rather than machine parseable. " "It may look different on different platforms and this is intended." msgstr "" -#: ../src/Doc/library/platform.rst:76 +#: library/platform.rst:76 msgid "" "If *aliased* is true, the function will use aliases for various platforms " "that report system names which differ from their common names, for example " @@ -77114,120 +78812,120 @@ msgid "" "used to implement this." msgstr "" -#: ../src/Doc/library/platform.rst:81 +#: library/platform.rst:81 msgid "" "Setting *terse* to true causes the function to return only the absolute " "minimum information needed to identify the platform." msgstr "" -#: ../src/Doc/library/platform.rst:87 +#: library/platform.rst:87 msgid "Returns the (real) processor name, e.g. ``'amdk6'``." msgstr "" -#: ../src/Doc/library/platform.rst:89 +#: library/platform.rst:89 msgid "" "An empty string is returned if the value cannot be determined. Note that " "many platforms do not provide this information or simply return the same " "value as for :func:`machine`. NetBSD does this." msgstr "" -#: ../src/Doc/library/platform.rst:96 +#: library/platform.rst:96 msgid "" "Returns a tuple ``(buildno, builddate)`` stating the Python build number and " "date as strings." msgstr "" -#: ../src/Doc/library/platform.rst:102 +#: library/platform.rst:102 msgid "Returns a string identifying the compiler used for compiling Python." msgstr "" -#: ../src/Doc/library/platform.rst:107 +#: library/platform.rst:107 msgid "Returns a string identifying the Python implementation SCM branch." msgstr "" # 7cdc6e8a803c4a1483d4e7485e475551 -#: ../src/Doc/library/platform.rst:114 +#: library/platform.rst:114 msgid "" "Returns a string identifying the Python implementation. Possible return " "values are: 'CPython', 'IronPython', 'Jython', 'PyPy'." msgstr "" -#: ../src/Doc/library/platform.rst:122 +#: library/platform.rst:122 msgid "Returns a string identifying the Python implementation SCM revision." msgstr "" -#: ../src/Doc/library/platform.rst:129 -msgid "Returns the Python version as string ``'major.minor.patchlevel'``" +#: library/platform.rst:129 +msgid "Returns the Python version as string ``'major.minor.patchlevel'``." msgstr "" -#: ../src/Doc/library/platform.rst:131 +#: library/platform.rst:131 msgid "" "Note that unlike the Python ``sys.version``, the returned value will always " "include the patchlevel (it defaults to 0)." msgstr "" -#: ../src/Doc/library/platform.rst:137 +#: library/platform.rst:137 msgid "" "Returns the Python version as tuple ``(major, minor, patchlevel)`` of " "strings." msgstr "" -#: ../src/Doc/library/platform.rst:139 +#: library/platform.rst:139 msgid "" "Note that unlike the Python ``sys.version``, the returned value will always " "include the patchlevel (it defaults to ``'0'``)." msgstr "" -#: ../src/Doc/library/platform.rst:145 +#: library/platform.rst:145 msgid "" "Returns the system's release, e.g. ``'2.2.0'`` or ``'NT'`` An empty string " "is returned if the value cannot be determined." msgstr "" -#: ../src/Doc/library/platform.rst:151 +#: library/platform.rst:151 msgid "" "Returns the system/OS name, e.g. ``'Linux'``, ``'Windows'``, or ``'Java'``. " "An empty string is returned if the value cannot be determined." msgstr "" -#: ../src/Doc/library/platform.rst:157 +#: library/platform.rst:157 msgid "" "Returns ``(system, release, version)`` aliased to common marketing names " "used for some systems. It also does some reordering of the information in " "some cases where it would otherwise cause confusion." msgstr "" -#: ../src/Doc/library/platform.rst:164 +#: library/platform.rst:164 msgid "" "Returns the system's release version, e.g. ``'#3 on degas'``. An empty " "string is returned if the value cannot be determined." msgstr "" -#: ../src/Doc/library/platform.rst:170 +#: library/platform.rst:170 msgid "" "Fairly portable uname interface. Returns a tuple of strings ``(system, node, " "release, version, machine, processor)`` identifying the underlying platform." msgstr "" -#: ../src/Doc/library/platform.rst:173 +#: library/platform.rst:173 msgid "" "Note that unlike the :func:`os.uname` function this also returns possible " "processor information as additional tuple entry." msgstr "" -#: ../src/Doc/library/platform.rst:176 +#: library/platform.rst:176 msgid "Entries which cannot be determined are set to ``''``." msgstr "" -#: ../src/Doc/library/platform.rst:180 +#: library/platform.rst:180 msgid "Java Platform" msgstr "" -#: ../src/Doc/library/platform.rst:185 +#: library/platform.rst:185 msgid "Version interface for Jython." msgstr "" -#: ../src/Doc/library/platform.rst:187 +#: library/platform.rst:187 msgid "" "Returns a tuple ``(release, vendor, vminfo, osinfo)`` with *vminfo* being a " "tuple ``(vm_name, vm_release, vm_vendor)`` and *osinfo* being a tuple " @@ -77235,19 +78933,19 @@ msgid "" "set to the defaults given as parameters (which all default to ``''``)." msgstr "" -#: ../src/Doc/library/platform.rst:194 +#: library/platform.rst:194 msgid "Windows Platform" msgstr "" # 505bf42e7269453b83e7368cc51c9f59 -#: ../src/Doc/library/platform.rst:199 +#: library/platform.rst:199 msgid "" "Get additional version information from the Windows Registry and return a " "tuple ``(release, version, csd, ptype)`` referring to OS release, version " "number, CSD level (service pack) and OS type (multi/single processor)." msgstr "" -#: ../src/Doc/library/platform.rst:203 +#: library/platform.rst:203 msgid "" "As a hint: *ptype* is ``'Uniprocessor Free'`` on single processor NT " "machines and ``'Multiprocessor Free'`` on multi processor machines. The " @@ -77257,47 +78955,47 @@ msgid "" msgstr "" # 95df5b2c57cf46ef869205da36266ef7 -#: ../src/Doc/library/platform.rst:211 +#: library/platform.rst:211 msgid "" "This function works best with Mark Hammond's :mod:`win32all` package " "installed, but also on Python 2.3 and later (support for this was added in " "Python 2.6). It obviously only runs on Win32 compatible platforms." msgstr "" -#: ../src/Doc/library/platform.rst:218 +#: library/platform.rst:218 msgid "Win95/98 specific" msgstr "" -#: ../src/Doc/library/platform.rst:222 +#: library/platform.rst:222 msgid "" "Portable :func:`popen` interface. Find a working popen implementation " "preferring :func:`win32pipe.popen`. On Windows NT, :func:`win32pipe.popen` " "should work; on Windows 9x it hangs due to bugs in the MS C library." msgstr "" -#: ../src/Doc/library/platform.rst:228 +#: library/platform.rst:228 msgid "Mac OS Platform" msgstr "" -#: ../src/Doc/library/platform.rst:233 +#: library/platform.rst:233 msgid "" "Get Mac OS version information and return it as tuple ``(release, " "versioninfo, machine)`` with *versioninfo* being a tuple ``(version, " "dev_stage, non_release_version)``." msgstr "" -#: ../src/Doc/library/platform.rst:237 +#: library/platform.rst:237 msgid "" "Entries which cannot be determined are set to ``''``. All tuple entries are " "strings." msgstr "" -#: ../src/Doc/library/platform.rst:242 +#: library/platform.rst:242 msgid "Unix Platforms" msgstr "" # 913d17b283564f1c88db0b390c0f51fb -#: ../src/Doc/library/platform.rst:247 +#: library/platform.rst:247 msgid "" "This is an old version of the functionality now provided by :func:" "`linux_distribution`. For new code, please use the :func:" @@ -77305,38 +79003,38 @@ msgid "" msgstr "" # fd200d8dce174f67b3318cb728da01ee -#: ../src/Doc/library/platform.rst:251 +#: library/platform.rst:251 msgid "" "The only difference between the two is that ``dist()`` always returns the " "short name of the distribution taken from the ``supported_dists`` parameter." msgstr "" -#: ../src/Doc/library/platform.rst:259 +#: library/platform.rst:259 msgid "Tries to determine the name of the Linux OS distribution name." msgstr "" -#: ../src/Doc/library/platform.rst:261 +#: library/platform.rst:261 msgid "" "``supported_dists`` may be given to define the set of Linux distributions to " "look for. It defaults to a list of currently supported Linux distributions " "identified by their release file name." msgstr "" -#: ../src/Doc/library/platform.rst:265 +#: library/platform.rst:265 msgid "" "If ``full_distribution_name`` is true (default), the full distribution read " "from the OS is returned. Otherwise the short name taken from " "``supported_dists`` is used." msgstr "" -#: ../src/Doc/library/platform.rst:269 +#: library/platform.rst:269 msgid "" "Returns a tuple ``(distname,version,id)`` which defaults to the args given " "as parameters. ``id`` is the item in parentheses after the version number. " "It is usually the version codename." msgstr "" -#: ../src/Doc/library/platform.rst:277 +#: library/platform.rst:277 msgid "" "Tries to determine the libc version against which the file executable " "(defaults to the Python interpreter) is linked. Returns a tuple of strings " @@ -77344,33 +79042,39 @@ msgid "" "fails." msgstr "" -#: ../src/Doc/library/platform.rst:281 +#: library/platform.rst:281 msgid "" "Note that this function has intimate knowledge of how different libc " "versions add symbols to the executable is probably only usable for " "executables compiled using :program:`gcc`." msgstr "" -#: ../src/Doc/library/platform.rst:285 +#: library/platform.rst:285 msgid "The file is read and scanned in chunks of *chunksize* bytes." msgstr "" -#: ../src/Doc/library/plistlib.rst:2 +#: library/plistlib.rst:2 msgid ":mod:`plistlib` --- Generate and parse Mac OS X ``.plist`` files" msgstr "" +#: library/plistlib.rst:10 +msgid "" +"This module was previously only available in the Mac-specific library, it is " +"now available for all platforms." +msgstr "" + # 07b2c9c086e14bdcb4782060fbf31337 -#: ../src/Doc/library/plistlib.rst:18 +#: library/plistlib.rst:18 msgid "**Source code:** :source:`Lib/plistlib.py`" msgstr "" -#: ../src/Doc/library/plistlib.rst:22 +#: library/plistlib.rst:22 msgid "" "This module provides an interface for reading and writing the \"property list" "\" XML files used mainly by Mac OS X." msgstr "" -#: ../src/Doc/library/plistlib.rst:25 +#: library/plistlib.rst:25 msgid "" "The property list (``.plist``) file format is a simple XML pickle supporting " "basic object types, like dictionaries, lists, numbers and strings. Usually " @@ -77378,7 +79082,7 @@ msgid "" msgstr "" # 443697c79673402cbe880e878d583a5b -#: ../src/Doc/library/plistlib.rst:29 +#: library/plistlib.rst:29 msgid "" "Values can be strings, integers, floats, booleans, tuples, lists, " "dictionaries (but only with string keys), :class:`Data` or :class:`datetime." @@ -77387,66 +79091,63 @@ msgid "" msgstr "" # d784c423dca445fb8c563610cabe9ada -#: ../src/Doc/library/plistlib.rst:34 +#: library/plistlib.rst:34 msgid "" "The ```` plist type is supported through the :class:`Data` class. " "This is a thin wrapper around a Python string. Use :class:`Data` if your " "strings contain control characters." msgstr "" -# 5e00aa7462144a23acda2efa6da57e7a -#: ../src/Doc/library/plistlib.rst:39 -msgid "" -"`PList manual page `_" +#: library/plistlib.rst:40 +msgid "PList manual page" msgstr "" -#: ../src/Doc/library/plistlib.rst:41 +#: library/plistlib.rst:41 msgid "Apple's documentation of the file format." msgstr "" -#: ../src/Doc/library/plistlib.rst:44 +#: library/plistlib.rst:44 msgid "This module defines the following functions:" msgstr "" -#: ../src/Doc/library/plistlib.rst:48 +#: library/plistlib.rst:48 msgid "" "Read a plist file. *pathOrFile* may either be a file name or a (readable) " "file object. Return the unpacked root object (which usually is a " "dictionary)." msgstr "" -#: ../src/Doc/library/plistlib.rst:52 +#: library/plistlib.rst:52 msgid "" "The XML data is parsed using the Expat parser from :mod:`xml.parsers.expat` " "-- see its documentation for possible exceptions on ill-formed XML. Unknown " "elements will simply be ignored by the plist parser." msgstr "" -#: ../src/Doc/library/plistlib.rst:59 +#: library/plistlib.rst:59 msgid "" "Write *rootObject* to a plist file. *pathOrFile* may either be a file name " "or a (writable) file object." msgstr "" -#: ../src/Doc/library/plistlib.rst:62 +#: library/plistlib.rst:62 msgid "" "A :exc:`TypeError` will be raised if the object is of an unsupported type or " "a container that contains objects of unsupported types." msgstr "" # 6dbb64a2a7c644e3b97a5b55c129bca1 -#: ../src/Doc/library/plistlib.rst:68 +#: library/plistlib.rst:68 msgid "Read a plist from a string. Return the root object." msgstr "" # 878912fae08a4e8180bd047161213fa2 -#: ../src/Doc/library/plistlib.rst:73 +#: library/plistlib.rst:73 msgid "Return *rootObject* as a plist-formatted string." msgstr "" # 9e86f74023564be69a46942ac4bfcd14 -#: ../src/Doc/library/plistlib.rst:79 +#: library/plistlib.rst:79 msgid "" "Read a plist from the resource with type *restype* from the resource fork of " "*path*. Availability: Mac OS X." @@ -77454,23 +79155,23 @@ msgstr "" # 310641d572bd4cd5a5025aa2d1548b0b # 834cb6418f1a41a2aa83574a30feb493 -#: ../src/Doc/library/plistlib.rst:84 ../src/Doc/library/plistlib.rst:94 +#: library/plistlib.rst:84 library/plistlib.rst:94 msgid "In Python 3.x, this function has been removed." msgstr "" # c6a0aef469e048f89d846f17e76c9ec6 -#: ../src/Doc/library/plistlib.rst:89 +#: library/plistlib.rst:89 msgid "" "Write *rootObject* as a resource with type *restype* to the resource fork of " "*path*. Availability: Mac OS X." msgstr "" -#: ../src/Doc/library/plistlib.rst:98 +#: library/plistlib.rst:98 msgid "The following class is available:" msgstr "" # 36776433e75c4babacf62488508b55f9 -#: ../src/Doc/library/plistlib.rst:102 +#: library/plistlib.rst:102 msgid "" "Return a \"data\" wrapper object around the string *data*. This is used in " "functions converting from/to plists to represent the ```` type " @@ -77478,34 +79179,40 @@ msgid "" msgstr "" # 80e735a8f7124defbf24e8f173dee010 -#: ../src/Doc/library/plistlib.rst:106 +#: library/plistlib.rst:106 msgid "" "It has one attribute, :attr:`data`, that can be used to retrieve the Python " "string stored in it." msgstr "" -#: ../src/Doc/library/plistlib.rst:113 +#: library/plistlib.rst:113 msgid "Generating a plist::" msgstr "" -#: ../src/Doc/library/plistlib.rst:134 +#: library/plistlib.rst:134 msgid "Parsing a plist::" msgstr "" # befd75eb2ccb47e89829a3d98bb3bc8b -#: ../src/Doc/library/popen2.rst:3 +#: library/popen2.rst:3 msgid ":mod:`popen2` --- Subprocesses with accessible I/O streams" msgstr "" +#: library/popen2.rst:11 +msgid "" +"This module is obsolete. Use the :mod:`subprocess` module. Check " +"especially the :ref:`subprocess-replacements` section." +msgstr "" + # bf1a4b0c864b49efb3c0a716c518fb14 -#: ../src/Doc/library/popen2.rst:15 +#: library/popen2.rst:15 msgid "" "This module allows you to spawn processes and connect to their input/output/" "error pipes and obtain their return codes under Unix and Windows." msgstr "" # 27d36e25462b4162aebe865a75aa2248 -#: ../src/Doc/library/popen2.rst:18 +#: library/popen2.rst:18 msgid "" "The :mod:`subprocess` module provides more powerful facilities for spawning " "new processes and retrieving their results. Using the :mod:`subprocess` " @@ -77513,7 +79220,7 @@ msgid "" msgstr "" # 2e9aedbf3ebb47a4bdb4c88bd521761f -#: ../src/Doc/library/popen2.rst:22 +#: library/popen2.rst:22 msgid "" "The primary interface offered by this module is a trio of factory functions. " "For each of these, if *bufsize* is specified, it specifies the buffer size " @@ -77524,7 +79231,7 @@ msgid "" msgstr "" # 75f9cac0340043c6824dbbceadb6d81a -#: ../src/Doc/library/popen2.rst:28 +#: library/popen2.rst:28 msgid "" "On Unix, *cmd* may be a sequence, in which case arguments will be passed " "directly to the program without shell intervention (as with :func:`os." @@ -77533,7 +79240,7 @@ msgid "" msgstr "" # 8268bd4e4df645318c1148bf474be551 -#: ../src/Doc/library/popen2.rst:32 +#: library/popen2.rst:32 msgid "" "The only way to retrieve the return codes for the child processes is by " "using the :meth:`poll` or :meth:`wait` methods on the :class:`Popen3` and :" @@ -77545,28 +79252,28 @@ msgid "" msgstr "" # bd33f5d40d54455fadf8117dd3bd1dd5 -#: ../src/Doc/library/popen2.rst:43 +#: library/popen2.rst:43 msgid "" "Executes *cmd* as a sub-process. Returns the file objects ``(child_stdout, " "child_stdin)``." msgstr "" # f850ec76e4794399bf1f99028d02bc2e -#: ../src/Doc/library/popen2.rst:49 +#: library/popen2.rst:49 msgid "" "Executes *cmd* as a sub-process. Returns the file objects ``(child_stdout, " "child_stdin, child_stderr)``." msgstr "" # baefac4f89554d5d83041b2502cf5e65 -#: ../src/Doc/library/popen2.rst:55 +#: library/popen2.rst:55 msgid "" "Executes *cmd* as a sub-process. Returns the file objects " "``(child_stdout_and_stderr, child_stdin)``." msgstr "" # f428e4e5bf2f4278bbc2c7a8e53591ae -#: ../src/Doc/library/popen2.rst:60 +#: library/popen2.rst:60 msgid "" "On Unix, a class defining the objects returned by the factory functions is " "also available. These are not used for the Windows implementation, and are " @@ -77574,7 +79281,7 @@ msgid "" msgstr "" # d06461229d774e74987c4660cc82e864 -#: ../src/Doc/library/popen2.rst:67 +#: library/popen2.rst:67 msgid "" "This class represents a child process. Normally, :class:`Popen3` instances " "are created using the :func:`popen2` and :func:`popen3` factory functions " @@ -77582,7 +79289,7 @@ msgid "" msgstr "" # a324762f14ec439b87fce49af45be3ce -#: ../src/Doc/library/popen2.rst:71 +#: library/popen2.rst:71 msgid "" "If not using one of the helper functions to create :class:`Popen3` objects, " "the parameter *cmd* is the shell command to execute in a sub-process. The " @@ -77593,7 +79300,7 @@ msgid "" msgstr "" # 42c24e1d73374e02bbd5807187d3a33c -#: ../src/Doc/library/popen2.rst:81 +#: library/popen2.rst:81 msgid "" "Similar to :class:`Popen3`, but always captures standard error into the same " "file object as standard output. These are typically created using :func:" @@ -77601,26 +79308,26 @@ msgid "" msgstr "" # 7c4c38cd00df44b29a7d775a540e243a -#: ../src/Doc/library/popen2.rst:91 +#: library/popen2.rst:91 msgid "Popen3 and Popen4 Objects" msgstr "" # 5b8e2f3cfa6d41d89e6c7af0bf1472f6 -#: ../src/Doc/library/popen2.rst:93 +#: library/popen2.rst:93 msgid "" "Instances of the :class:`Popen3` and :class:`Popen4` classes have the " "following methods:" msgstr "" # 98c59aabae894e219db3b8af26a34a31 -#: ../src/Doc/library/popen2.rst:99 +#: library/popen2.rst:99 msgid "" "Returns ``-1`` if child process hasn't completed yet, or its status code " "(see :meth:`wait`) otherwise." msgstr "" # 04ff7d0fa8794bafa7987b26a8448420 -#: ../src/Doc/library/popen2.rst:105 +#: library/popen2.rst:105 msgid "" "Waits for and returns the status code of the child process. The status code " "encodes both the return code of the process and information about whether it " @@ -77630,12 +79337,12 @@ msgid "" "functions." msgstr "" -#: ../src/Doc/library/popen2.rst:111 ../src/Doc/library/subprocess.rst:533 +#: library/popen2.rst:111 library/subprocess.rst:533 msgid "The following attributes are also available:" msgstr "" # cf2d52b16d704625b51670387b1f7258 -#: ../src/Doc/library/popen2.rst:116 +#: library/popen2.rst:116 msgid "" "A file object that provides output from the child process. For :class:" "`Popen4` instances, this will provide both the standard output and standard " @@ -77643,29 +79350,29 @@ msgid "" msgstr "" # d679d2a94c6f43f5a9f809d0f0310896 -#: ../src/Doc/library/popen2.rst:123 +#: library/popen2.rst:123 msgid "A file object that provides input to the child process." msgstr "" # 991d4b58f6564052a249c5ef163b79d4 -#: ../src/Doc/library/popen2.rst:128 +#: library/popen2.rst:128 msgid "" "A file object that provides error output from the child process, if " "*capturestderr* was true for the constructor, otherwise ``None``. This will " "always be ``None`` for :class:`Popen4` instances." msgstr "" -#: ../src/Doc/library/popen2.rst:135 ../src/Doc/library/subprocess.rst:564 +#: library/popen2.rst:135 library/subprocess.rst:564 msgid "The process ID of the child process." msgstr "" # e1d20997cda046f5b70a592285876dd8 -#: ../src/Doc/library/popen2.rst:141 +#: library/popen2.rst:141 msgid "Flow Control Issues" msgstr "" # d8caead37c354d0cbbc4c9292bce0a2e -#: ../src/Doc/library/popen2.rst:143 +#: library/popen2.rst:143 msgid "" "Any time you are working with any form of inter-process communication, " "control flow needs to be carefully thought out. This remains the case with " @@ -77674,7 +79381,7 @@ msgid "" msgstr "" # 2d4b143ab62c48d79d6628f1a4c8aa37 -#: ../src/Doc/library/popen2.rst:147 +#: library/popen2.rst:147 msgid "" "When reading output from a child process that writes a lot of data to " "standard error while the parent is reading from the child's standard output, " @@ -77686,24 +79393,24 @@ msgid "" msgstr "" # b563c850f310459994783899f29ff199 -#: ../src/Doc/library/popen2.rst:158 +#: library/popen2.rst:158 msgid "There are several ways to deal with this situation." msgstr "" # 821f920046214797bbc0405d017e1afd -#: ../src/Doc/library/popen2.rst:160 +#: library/popen2.rst:160 msgid "" "The simplest application change, in many cases, will be to follow this model " "in the parent process::" msgstr "" # 76c4c5f4ede548a390367ed9f84c3bf4 -#: ../src/Doc/library/popen2.rst:172 +#: library/popen2.rst:172 msgid "with code like this in the child::" msgstr "" # bdbc14969e344659838a410d7157e5eb -#: ../src/Doc/library/popen2.rst:184 +#: library/popen2.rst:184 msgid "" "In particular, note that ``sys.stderr`` must be closed after writing all " "data, or :meth:`readlines` won't return. Also note that :func:`os.close` " @@ -77713,7 +79420,7 @@ msgid "" msgstr "" # b198764c0e9943a3920543ac00c45abf -#: ../src/Doc/library/popen2.rst:189 +#: library/popen2.rst:189 msgid "" "Applications which need to support a more general approach should integrate " "I/O over pipes with their :func:`select` loops, or use separate threads to " @@ -77721,16 +79428,16 @@ msgid "" "function or :class:`Popen\\*` class was used." msgstr "" -#: ../src/Doc/library/poplib.rst:2 +#: library/poplib.rst:2 msgid ":mod:`poplib` --- POP3 protocol client" msgstr "" # d93856c2e8c34a97a684a4f1e38d083f -#: ../src/Doc/library/poplib.rst:11 +#: library/poplib.rst:11 msgid "**Source code:** :source:`Lib/poplib.py`" msgstr "" -#: ../src/Doc/library/poplib.rst:15 +#: library/poplib.rst:15 msgid "" "This module defines a class, :class:`POP3`, which encapsulates a connection " "to a POP3 server and implements the protocol as defined in :rfc:`1725`. " @@ -77740,7 +79447,7 @@ msgid "" "protocol layer." msgstr "" -#: ../src/Doc/library/poplib.rst:22 +#: library/poplib.rst:22 msgid "" "Note that POP3, though widely supported, is obsolescent. The implementation " "quality of POP3 servers varies widely, and too many are quite poor. If your " @@ -77749,11 +79456,11 @@ msgid "" msgstr "" # b9f29d792c5e4f76b1a442a6e371293c -#: ../src/Doc/library/poplib.rst:27 +#: library/poplib.rst:27 msgid "The :mod:`poplib` module provides two classes:" msgstr "" -#: ../src/Doc/library/poplib.rst:32 +#: library/poplib.rst:32 msgid "" "This class implements the actual POP3 protocol. The connection is created " "when the instance is initialized. If *port* is omitted, the standard POP3 " @@ -77763,7 +79470,7 @@ msgid "" msgstr "" # 21c1bc152fc34a23a3c0a0c740657b2c -#: ../src/Doc/library/poplib.rst:44 +#: library/poplib.rst:44 msgid "" "This is a subclass of :class:`POP3` that connects to the server over an SSL " "encrypted socket. If *port* is not specified, 995, the standard POP3-over-" @@ -77772,124 +79479,120 @@ msgid "" "connection." msgstr "" -#: ../src/Doc/library/poplib.rst:51 +#: library/poplib.rst:51 msgid "One exception is defined as an attribute of the :mod:`poplib` module:" msgstr "" -#: ../src/Doc/library/poplib.rst:56 +#: library/poplib.rst:56 msgid "" "Exception raised on any errors from this module (errors from :mod:`socket` " "module are not caught). The reason for the exception is passed to the " "constructor as a string." msgstr "" -# 73cfb7334bd849189ed401395b915a2c -#: ../src/Doc/library/poplib.rst:63 -msgid "Module :mod:`imaplib`" +#: library/poplib.rst:64 +msgid "Module imaplib" msgstr "" -#: ../src/Doc/library/poplib.rst:64 +#: library/poplib.rst:64 msgid "The standard Python IMAP module." msgstr "" -# a1cd81c551844f0190004f8e49851234 -#: ../src/Doc/library/poplib.rst:67 -msgid "" -"`Frequently Asked Questions About Fetchmail `_" +#: library/poplib.rst:68 +msgid "Frequently Asked Questions About Fetchmail" msgstr "" -#: ../src/Doc/library/poplib.rst:67 +#: library/poplib.rst:67 msgid "" "The FAQ for the :program:`fetchmail` POP/IMAP client collects information on " "POP3 server variations and RFC noncompliance that may be useful if you need " "to write an application based on the POP protocol." msgstr "" -#: ../src/Doc/library/poplib.rst:75 +#: library/poplib.rst:75 msgid "POP3 Objects" msgstr "" -#: ../src/Doc/library/poplib.rst:77 +#: library/poplib.rst:77 msgid "" "All POP3 commands are represented by methods of the same name, in lower-" "case; most return the response text sent by the server." msgstr "" -#: ../src/Doc/library/poplib.rst:80 +#: library/poplib.rst:80 msgid "An :class:`POP3` instance has the following methods:" msgstr "" -#: ../src/Doc/library/poplib.rst:94 +#: library/poplib.rst:94 msgid "Returns the greeting string sent by the POP3 server." msgstr "" -#: ../src/Doc/library/poplib.rst:99 +#: library/poplib.rst:99 msgid "" "Send user command, response should indicate that a password is required." msgstr "" # 6058d4204ef5412dbd35ce6da364bb02 -#: ../src/Doc/library/poplib.rst:104 +#: library/poplib.rst:104 msgid "" "Send password, response includes message count and mailbox size. Note: the " "mailbox on the server is locked until :meth:`~poplib.quit` is called." msgstr "" -#: ../src/Doc/library/poplib.rst:110 +#: library/poplib.rst:110 msgid "Use the more secure APOP authentication to log into the POP3 server." msgstr "" -#: ../src/Doc/library/poplib.rst:115 +#: library/poplib.rst:115 msgid "" "Use RPOP authentication (similar to UNIX r-commands) to log into POP3 server." msgstr "" -#: ../src/Doc/library/poplib.rst:120 +#: library/poplib.rst:120 msgid "" "Get mailbox status. The result is a tuple of 2 integers: ``(message count, " "mailbox size)``." msgstr "" -#: ../src/Doc/library/poplib.rst:126 +#: library/poplib.rst:126 msgid "" "Request message list, result is in the form ``(response, ['mesg_num " "octets', ...], octets)``. If *which* is set, it is the message to list." msgstr "" -#: ../src/Doc/library/poplib.rst:132 +#: library/poplib.rst:132 msgid "" "Retrieve whole message number *which*, and set its seen flag. Result is in " "form ``(response, ['line', ...], octets)``." msgstr "" -#: ../src/Doc/library/poplib.rst:138 +#: library/poplib.rst:138 msgid "" "Flag message number *which* for deletion. On most servers deletions are not " "actually performed until QUIT (the major exception is Eudora QPOP, which " "deliberately violates the RFCs by doing pending deletes on any disconnect)." msgstr "" -#: ../src/Doc/library/poplib.rst:145 +#: library/poplib.rst:145 msgid "Remove any deletion marks for the mailbox." msgstr "" -#: ../src/Doc/library/poplib.rst:150 +#: library/poplib.rst:150 msgid "Do nothing. Might be used as a keep-alive." msgstr "" -#: ../src/Doc/library/poplib.rst:155 +#: library/poplib.rst:155 msgid "Signoff: commit changes, unlock mailbox, drop connection." msgstr "" -#: ../src/Doc/library/poplib.rst:160 +#: library/poplib.rst:160 msgid "" "Retrieves the message header plus *howmuch* lines of the message after the " "header of message number *which*. Result is in form ``(response, " "['line', ...], octets)``." msgstr "" -#: ../src/Doc/library/poplib.rst:164 +#: library/poplib.rst:164 msgid "" "The POP3 TOP command this method uses, unlike the RETR command, doesn't set " "the message's seen flag; unfortunately, TOP is poorly specified in the RFCs " @@ -77897,28 +79600,28 @@ msgid "" "against the POP3 servers you will use before trusting it." msgstr "" -#: ../src/Doc/library/poplib.rst:172 +#: library/poplib.rst:172 msgid "" "Return message digest (unique id) list. If *which* is specified, result " "contains the unique id for that message in the form ``'response mesgnum " "uid``, otherwise result is list ``(response, ['mesgnum uid', ...], octets)``." msgstr "" -#: ../src/Doc/library/poplib.rst:176 +#: library/poplib.rst:176 msgid "" "Instances of :class:`POP3_SSL` have no additional methods. The interface of " "this subclass is identical to its parent." msgstr "" -#: ../src/Doc/library/poplib.rst:183 +#: library/poplib.rst:183 msgid "POP3 Example" msgstr "" -#: ../src/Doc/library/posix.rst:2 +#: library/posix.rst:2 msgid ":mod:`posix` --- The most common POSIX system calls" msgstr "" -#: ../src/Doc/library/posix.rst:9 +#: library/posix.rst:9 msgid "" "This module provides access to operating system functionality that is " "standardized by the C Standard and the POSIX standard (a thinly disguised " @@ -77926,7 +79629,7 @@ msgid "" msgstr "" # 129ae534cf5f4e87860797dbb48c35bd -#: ../src/Doc/library/posix.rst:15 +#: library/posix.rst:15 msgid "" "**Do not import this module directly.** Instead, import the module :mod:" "`os`, which provides a *portable* version of this interface. On Unix, the :" @@ -77939,18 +79642,18 @@ msgid "" "environ`` is changed." msgstr "" -#: ../src/Doc/library/posix.rst:24 +#: library/posix.rst:24 msgid "" "Errors are reported as exceptions; the usual exceptions are given for type " "errors, while errors reported by the system calls raise :exc:`OSError`." msgstr "" -#: ../src/Doc/library/posix.rst:31 +#: library/posix.rst:31 msgid "Large File Support" msgstr "" # 804e88a387604d54b22bbc9ecf6bffdf -#: ../src/Doc/library/posix.rst:39 +#: library/posix.rst:39 msgid "" "Several operating systems (including AIX, HP-UX, Irix and Solaris) provide " "support for files that are larger than 2 GB from a C programming model " @@ -77960,7 +79663,7 @@ msgid "" msgstr "" # 4818bed2815040d1bedabee63c114c57 -#: ../src/Doc/library/posix.rst:45 +#: library/posix.rst:45 msgid "" "Large file support is enabled in Python when the size of an :c:type:`off_t` " "is larger than a :c:type:`long` and the :c:type:`long long` type is " @@ -77972,22 +79675,22 @@ msgid "" "2.7 you need to do something like::" msgstr "" -#: ../src/Doc/library/posix.rst:56 +#: library/posix.rst:56 msgid "On large-file-capable Linux systems, this might work::" msgstr "" -#: ../src/Doc/library/posix.rst:65 +#: library/posix.rst:65 msgid "Notable Module Contents" msgstr "" -#: ../src/Doc/library/posix.rst:67 +#: library/posix.rst:67 msgid "" "In addition to many functions described in the :mod:`os` module " "documentation, :mod:`posix` defines the following data item:" msgstr "" # 83713328694742e799e06e4e1b62318e -#: ../src/Doc/library/posix.rst:72 +#: library/posix.rst:72 msgid "" "A dictionary representing the string environment at the time the interpreter " "was started. For example, ``environ['HOME']`` is the pathname of your home " @@ -77995,7 +79698,7 @@ msgid "" msgstr "" # 0fb4c42d09cd4e43816e5a44cc6e38bc -#: ../src/Doc/library/posix.rst:76 +#: library/posix.rst:76 msgid "" "Modifying this dictionary does not affect the string environment passed on " "by :func:`~os.execv`, :func:`~os.popen` or :func:`~os.system`; if you need " @@ -78005,7 +79708,7 @@ msgid "" msgstr "" # 4f387ecb69f1438eb0b78d8c2694ac3e -#: ../src/Doc/library/posix.rst:84 +#: library/posix.rst:84 msgid "" "The :mod:`os` module provides an alternate implementation of ``environ`` " "which updates the environment on modification. Note also that updating ``os." @@ -78014,12 +79717,18 @@ msgid "" msgstr "" # 93f2b86df191489abc9b1a6e6ce3c6ea -#: ../src/Doc/library/posixfile.rst:2 +#: library/posixfile.rst:2 msgid ":mod:`posixfile` --- File-like objects with locking support" msgstr "" +#: library/posixfile.rst:14 +msgid "" +"The locking operation that this module provides is done better and more " +"portably by the :func:`fcntl.lockf` call." +msgstr "" + # 91a70ce35d1e4186ad32d1a0068f7ef0 -#: ../src/Doc/library/posixfile.rst:20 +#: library/posixfile.rst:20 msgid "" "This module implements some additional functionality over the built-in file " "objects. In particular, it implements file locking, control over the file " @@ -78031,7 +79740,7 @@ msgid "" msgstr "" # b4e32f172f6a408295a0e41a6921b014 -#: ../src/Doc/library/posixfile.rst:27 +#: library/posixfile.rst:27 msgid "" "To instantiate a posixfile object, use the :func:`posixfile.open` function. " "The resulting object looks and feels roughly the same as a standard file " @@ -78039,32 +79748,32 @@ msgid "" msgstr "" # 94803863c8b04352aae5287773c8e1ba -#: ../src/Doc/library/posixfile.rst:30 +#: library/posixfile.rst:30 msgid "The :mod:`posixfile` module defines the following constants:" msgstr "" # 0be8e81bd4c541069b3a180f7891eaff -#: ../src/Doc/library/posixfile.rst:35 +#: library/posixfile.rst:35 msgid "Offset is calculated from the start of the file." msgstr "" # 2f76e4578fc5413fa13039725e774539 -#: ../src/Doc/library/posixfile.rst:40 +#: library/posixfile.rst:40 msgid "Offset is calculated from the current position in the file." msgstr "" # 5de0cd30ce2a43f6a101db5d168a79e9 -#: ../src/Doc/library/posixfile.rst:45 +#: library/posixfile.rst:45 msgid "Offset is calculated from the end of the file." msgstr "" # 6edb283dae154d40b56265c18bfd3176 -#: ../src/Doc/library/posixfile.rst:47 +#: library/posixfile.rst:47 msgid "The :mod:`posixfile` module defines the following functions:" msgstr "" # 795db365361b4fad91fefa183d0377c4 -#: ../src/Doc/library/posixfile.rst:52 +#: library/posixfile.rst:52 msgid "" "Create a new posixfile object with the given filename and mode. The " "*filename*, *mode* and *bufsize* arguments are interpreted the same way as " @@ -78072,19 +79781,19 @@ msgid "" msgstr "" # b91f72c7c72c42888be2d727be5810f4 -#: ../src/Doc/library/posixfile.rst:59 +#: library/posixfile.rst:59 msgid "" "Create a new posixfile object with the given standard file object. The " "resulting object has the same filename and mode as the original file object." msgstr "" # ef5f4573f375491ba6bb3c4ba3006463 -#: ../src/Doc/library/posixfile.rst:62 +#: library/posixfile.rst:62 msgid "The posixfile object defines the following additional methods:" msgstr "" # 27c13c77161247dfa14e54339eaf11fd -#: ../src/Doc/library/posixfile.rst:67 +#: library/posixfile.rst:67 msgid "" "Lock the specified section of the file that the file object is referring to. " "The format is explained below in a table. The *len* argument specifies the " @@ -78097,7 +79806,7 @@ msgid "" msgstr "" # 7086334c262e4029a4c9f88fda9fcafb -#: ../src/Doc/library/posixfile.rst:79 +#: library/posixfile.rst:79 msgid "" "Set the specified flags for the file that the file object is referring to. " "The new flags are ORed with the old flags, unless specified otherwise. The " @@ -78108,14 +79817,14 @@ msgid "" msgstr "" # a928e6d9816049dfba1312cf60119eda -#: ../src/Doc/library/posixfile.rst:89 +#: library/posixfile.rst:89 msgid "" "Duplicate the file object and the underlying file pointer and file " "descriptor. The resulting object behaves as if it were newly opened." msgstr "" # a6496dc7417b460a91e63bd2c64034d6 -#: ../src/Doc/library/posixfile.rst:95 +#: library/posixfile.rst:95 msgid "" "Duplicate the file object and the underlying file pointer and file " "descriptor. The new object will have the given file descriptor. Otherwise " @@ -78123,84 +79832,84 @@ msgid "" msgstr "" # 2ad39bb5ca2f4aa795149da594031828 -#: ../src/Doc/library/posixfile.rst:102 +#: library/posixfile.rst:102 msgid "" "Return the standard file object that the posixfile object is based on. This " "is sometimes necessary for functions that insist on a standard file object." msgstr "" # 5cca401f77bd4794a6d3319a7ac1d388 -#: ../src/Doc/library/posixfile.rst:105 +#: library/posixfile.rst:105 msgid "All methods raise :exc:`IOError` when the request fails." msgstr "" # 1f86e9fa842c4a259ca8cf070a7c991a -#: ../src/Doc/library/posixfile.rst:107 +#: library/posixfile.rst:107 msgid "" "Format characters for the :meth:`lock` method have the following meaning:" msgstr "" # 0f48be436b7b40d2a2ef3b8b744c1ae8 -#: ../src/Doc/library/posixfile.rst:112 +#: library/posixfile.rst:112 msgid "``u``" msgstr "" # 702665d9d2b24e96b2b07853274616a6 -#: ../src/Doc/library/posixfile.rst:112 +#: library/posixfile.rst:112 msgid "unlock the specified region" msgstr "" # ed75b87ba61446cab282403e094ce5fd -#: ../src/Doc/library/posixfile.rst:114 +#: library/posixfile.rst:114 msgid "``r``" msgstr "" # ae65b1b1ea234f2d8a191728517b3cbc -#: ../src/Doc/library/posixfile.rst:114 +#: library/posixfile.rst:114 msgid "request a read lock for the specified section" msgstr "" # 82aa8ecaf1f0462f91adff3bed0c42ed -#: ../src/Doc/library/posixfile.rst:116 +#: library/posixfile.rst:116 msgid "``w``" msgstr "" # 92624582620144d8ae320b4aa318fb2c -#: ../src/Doc/library/posixfile.rst:116 +#: library/posixfile.rst:116 msgid "request a write lock for the specified section" msgstr "" # 55054e1d63124500be2859dd7a7b2c33 # e60a7ba2bd73456fbd8612d0b34236cb -#: ../src/Doc/library/posixfile.rst:120 ../src/Doc/library/posixfile.rst:155 +#: library/posixfile.rst:120 library/posixfile.rst:155 msgid "In addition the following modifiers can be added to the format:" msgstr "" # bc8d390305244ca399cfd642d78f5381 # 719f17a2fcc7479ab28ffbe425fb3b26 -#: ../src/Doc/library/posixfile.rst:123 ../src/Doc/library/posixfile.rst:158 +#: library/posixfile.rst:123 library/posixfile.rst:158 msgid "Modifier" msgstr "" # e92e24decb7e46ef86fef31209e6488d -#: ../src/Doc/library/posixfile.rst:125 +#: library/posixfile.rst:125 msgid "``|``" msgstr "" # cdab0488d6154d1884ede81de779093e -#: ../src/Doc/library/posixfile.rst:125 +#: library/posixfile.rst:125 msgid "wait until the lock has been granted" msgstr "" # a4d3b4d272cd4c3f83ae0168df745fb7 -#: ../src/Doc/library/posixfile.rst:128 +#: library/posixfile.rst:128 msgid "" "return the first lock conflicting with the requested lock, or ``None`` if " "there is no conflict." msgstr "" # 2a9d0973f0fa4383bd6a5d661fd5a552 -#: ../src/Doc/library/posixfile.rst:137 +#: library/posixfile.rst:137 msgid "" "The lock returned is in the format ``(mode, len, start, whence, pid)`` where " "*mode* is a character representing the type of lock ('r' or 'w'). This " @@ -78209,95 +79918,95 @@ msgid "" msgstr "" # efdc067ec10e454ebef4b732630f0378 -#: ../src/Doc/library/posixfile.rst:141 +#: library/posixfile.rst:141 msgid "" "Format characters for the :meth:`flags` method have the following meanings:" msgstr "" # d283ff8c536346278f79ccaf71dbddaa -#: ../src/Doc/library/posixfile.rst:146 +#: library/posixfile.rst:146 msgid "``a``" msgstr "" # 30b2a718a4744c9486c3a2186048e9d0 -#: ../src/Doc/library/posixfile.rst:146 +#: library/posixfile.rst:146 msgid "append only flag" msgstr "" -#: ../src/Doc/library/posixfile.rst:148 ../src/Doc/library/struct.rst:170 +#: library/posixfile.rst:148 library/struct.rst:170 msgid "``c``" msgstr "" # 1269c1ff740a4907be7ad925fad7813c -#: ../src/Doc/library/posixfile.rst:148 +#: library/posixfile.rst:148 msgid "close on exec flag" msgstr "" # 7344cbbafb764a3b99a51b91268edbec -#: ../src/Doc/library/posixfile.rst:150 +#: library/posixfile.rst:150 msgid "``n``" msgstr "" # 6daa69c1d7c6477ea605689e8dec8d81 -#: ../src/Doc/library/posixfile.rst:150 +#: library/posixfile.rst:150 msgid "no delay flag (also called non-blocking flag)" msgstr "" -#: ../src/Doc/library/posixfile.rst:152 ../src/Doc/library/struct.rst:199 +#: library/posixfile.rst:152 library/struct.rst:199 msgid "``s``" msgstr "" # 0a47518760af4b4baaac4261af679c72 -#: ../src/Doc/library/posixfile.rst:152 +#: library/posixfile.rst:152 msgid "synchronization flag" msgstr "" -#: ../src/Doc/library/posixfile.rst:160 ../src/Doc/library/struct.rst:114 +#: library/posixfile.rst:160 library/struct.rst:114 msgid "``!``" msgstr "" # bcfc6e1e806f44b69f5a95d8f0e9c4b4 -#: ../src/Doc/library/posixfile.rst:160 +#: library/posixfile.rst:160 msgid "turn the specified flags 'off', instead of the default 'on'" msgstr "" -#: ../src/Doc/library/posixfile.rst:163 ../src/Doc/library/struct.rst:108 +#: library/posixfile.rst:163 library/struct.rst:108 msgid "``=``" msgstr "" # 2b9e1a023560437884fe88cdc2629690 -#: ../src/Doc/library/posixfile.rst:163 +#: library/posixfile.rst:163 msgid "replace the flags, instead of the default 'OR' operation" msgstr "" # a6edf6d574a04514b76285d0a80b1361 -#: ../src/Doc/library/posixfile.rst:166 +#: library/posixfile.rst:166 msgid "" "return a string in which the characters represent the flags that are set." msgstr "" # b73ca39a6c4741c493cbebffa3be1936 -#: ../src/Doc/library/posixfile.rst:174 +#: library/posixfile.rst:174 msgid "The ``!`` and ``=`` modifiers are mutually exclusive." msgstr "" # 59d63723a3df48b28349c629d5d5d90b -#: ../src/Doc/library/posixfile.rst:177 +#: library/posixfile.rst:177 msgid "" "This string represents the flags after they may have been altered by the " "same call." msgstr "" -#: ../src/Doc/library/pprint.rst:2 +#: library/pprint.rst:2 msgid ":mod:`pprint` --- Data pretty printer" msgstr "" # 0bac1a59621f4c7a8317bc833d480f8e -#: ../src/Doc/library/pprint.rst:9 +#: library/pprint.rst:9 msgid "**Source code:** :source:`Lib/pprint.py`" msgstr "" -#: ../src/Doc/library/pprint.rst:13 +#: library/pprint.rst:13 msgid "" "The :mod:`pprint` module provides a capability to \"pretty-print\" arbitrary " "Python data structures in a form which can be used as input to the " @@ -78308,7 +80017,7 @@ msgid "" "as Python constants." msgstr "" -#: ../src/Doc/library/pprint.rst:20 +#: library/pprint.rst:20 msgid "" "The formatted representation keeps objects on a single line if it can, and " "breaks them onto multiple lines if they don't fit within the allowed width. " @@ -78316,11 +80025,22 @@ msgid "" "the width constraint." msgstr "" -#: ../src/Doc/library/pprint.rst:34 +#: library/pprint.rst:25 +msgid "" +"Dictionaries are sorted by key before the display is computed; before 2.5, a " +"dictionary was sorted only if its display required more than one line, " +"although that wasn't documented." +msgstr "" + +#: library/pprint.rst:30 +msgid "Added support for :class:`set` and :class:`frozenset`." +msgstr "" + +#: library/pprint.rst:34 msgid "The :mod:`pprint` module defines one class:" msgstr "" -#: ../src/Doc/library/pprint.rst:41 +#: library/pprint.rst:41 msgid "" "Construct a :class:`PrettyPrinter` instance. This constructor understands " "several keyword parameters. An output stream may be set using the *stream* " @@ -78339,19 +80059,23 @@ msgid "" "width, a best effort will be made." msgstr "" -#: ../src/Doc/library/pprint.rst:74 +#: library/pprint.rst:74 msgid "The :class:`PrettyPrinter` class supports several derivative functions:" msgstr "" -#: ../src/Doc/library/pprint.rst:78 +#: library/pprint.rst:78 msgid "" "Return the formatted representation of *object* as a string. *indent*, " "*width* and *depth* will be passed to the :class:`PrettyPrinter` constructor " "as formatting parameters." msgstr "" +#: library/pprint.rst:82 library/pprint.rst:105 +msgid "The parameters *indent*, *width* and *depth* were added." +msgstr "" + # 54b6f03d3e0141238a913cc1870bf2d2 -#: ../src/Doc/library/pprint.rst:88 +#: library/pprint.rst:88 msgid "" "Prints the formatted representation of *object* on *stream*, followed by a " "newline. If *stream* is ``None``, ``sys.stdout`` is used. This may be used " @@ -78360,22 +80084,22 @@ msgid "" "class:`PrettyPrinter` constructor as formatting parameters." msgstr "" -#: ../src/Doc/library/pprint.rst:113 +#: library/pprint.rst:113 msgid "" "Determine if the formatted representation of *object* is \"readable,\" or " "can be used to reconstruct the value using :func:`eval`. This always " "returns ``False`` for recursive objects." msgstr "" -#: ../src/Doc/library/pprint.rst:123 +#: library/pprint.rst:123 msgid "Determine if *object* requires a recursive representation." msgstr "" -#: ../src/Doc/library/pprint.rst:126 +#: library/pprint.rst:126 msgid "One more support function is also defined:" msgstr "" -#: ../src/Doc/library/pprint.rst:130 +#: library/pprint.rst:130 msgid "" "Return a string representation of *object*, protected against recursive data " "structures. If the representation of *object* exposes a recursive entry, " @@ -78383,27 +80107,27 @@ msgid "" "id=number>``. The representation is not otherwise formatted." msgstr "" -#: ../src/Doc/library/pprint.rst:142 +#: library/pprint.rst:142 msgid "PrettyPrinter Objects" msgstr "" -#: ../src/Doc/library/pprint.rst:144 +#: library/pprint.rst:144 msgid ":class:`PrettyPrinter` instances have the following methods:" msgstr "" -#: ../src/Doc/library/pprint.rst:149 +#: library/pprint.rst:149 msgid "" "Return the formatted representation of *object*. This takes into account " "the options passed to the :class:`PrettyPrinter` constructor." msgstr "" -#: ../src/Doc/library/pprint.rst:155 +#: library/pprint.rst:155 msgid "" "Print the formatted representation of *object* on the configured stream, " "followed by a newline." msgstr "" -#: ../src/Doc/library/pprint.rst:158 +#: library/pprint.rst:158 msgid "" "The following methods provide the implementations for the corresponding " "functions of the same names. Using these methods on an instance is slightly " @@ -78411,7 +80135,7 @@ msgid "" "created." msgstr "" -#: ../src/Doc/library/pprint.rst:168 +#: library/pprint.rst:168 msgid "" "Determine if the formatted representation of the object is \"readable,\" or " "can be used to reconstruct the value using :func:`eval`. Note that this " @@ -78420,18 +80144,18 @@ msgid "" "returns ``False``." msgstr "" -#: ../src/Doc/library/pprint.rst:177 +#: library/pprint.rst:177 msgid "Determine if the object requires a recursive representation." msgstr "" -#: ../src/Doc/library/pprint.rst:179 +#: library/pprint.rst:179 msgid "" "This method is provided as a hook to allow subclasses to modify the way " "objects are converted to strings. The default implementation uses the " "internals of the :func:`saferepr` implementation." msgstr "" -#: ../src/Doc/library/pprint.rst:186 +#: library/pprint.rst:186 msgid "" "Returns three values: the formatted version of *object* as a string, a flag " "indicating whether the result is readable, and a flag indicating whether " @@ -78449,31 +80173,31 @@ msgid "" "of the current call." msgstr "" -#: ../src/Doc/library/pprint.rst:205 +#: library/pprint.rst:205 msgid "pprint Example" msgstr "" -#: ../src/Doc/library/pprint.rst:207 +#: library/pprint.rst:207 msgid "" "This example demonstrates several uses of the :func:`pprint` function and " "its parameters." msgstr "" -#: ../src/Doc/library/profile.rst:5 +#: library/profile.rst:5 msgid "The Python Profilers" msgstr "" # 53e9789b2d0b4d31b25d9ec5bf65bc0e -#: ../src/Doc/library/profile.rst:7 +#: library/profile.rst:7 msgid "**Source code:** :source:`Lib/profile.py` and :source:`Lib/pstats.py`" msgstr "" -#: ../src/Doc/library/profile.rst:14 +#: library/profile.rst:14 msgid "Introduction to the profilers" msgstr "" # ef12f3b4da7143d4a5c47293166a5f38 -#: ../src/Doc/library/profile.rst:20 +#: library/profile.rst:20 msgid "" ":mod:`cProfile` and :mod:`profile` provide :dfn:`deterministic profiling` of " "Python programs. A :dfn:`profile` is a set of statistics that describes how " @@ -78482,14 +80206,14 @@ msgid "" msgstr "" # b7ede0b9a8f842b9a7ffdbeaa980953f -#: ../src/Doc/library/profile.rst:25 +#: library/profile.rst:25 msgid "" "The Python standard library provides three different implementations of the " "same profiling interface:" msgstr "" # db606e39023c47dcb79e0aaad27590e8 -#: ../src/Doc/library/profile.rst:28 +#: library/profile.rst:28 msgid "" ":mod:`cProfile` is recommended for most users; it's a C extension with " "reasonable overhead that makes it suitable for profiling long-running " @@ -78497,17 +80221,21 @@ msgid "" "Czotter." msgstr "" -# 82c1b307cfda4d88a489a167664aa890 -#: ../src/Doc/library/profile.rst:35 +#: library/profile.rst:35 msgid "" ":mod:`profile`, a pure Python module whose interface is imitated by :mod:" "`cProfile`, but which adds significant overhead to profiled programs. If " "you're trying to extend the profiler in some way, the task might be easier " -"with this module." +"with this module. Originally designed and written by Jim Roskind." +msgstr "" + +#: library/profile.rst:40 +msgid "" +"Now also reports the time spent in calls to built-in functions and methods." msgstr "" # eeb5586222694ebe97ce1a0b7348dc70 -#: ../src/Doc/library/profile.rst:44 +#: library/profile.rst:44 msgid "" ":mod:`hotshot` was an experimental C module that focused on minimizing the " "overhead of profiling, at the expense of longer data post-processing times. " @@ -78515,7 +80243,7 @@ msgid "" msgstr "" # d9886b700d204e88b3f1bb77f7d88c39 -#: ../src/Doc/library/profile.rst:54 +#: library/profile.rst:54 msgid "" "The :mod:`profile` and :mod:`cProfile` modules export the same interface, so " "they are mostly interchangeable; :mod:`cProfile` has a much lower overhead " @@ -78525,7 +80253,7 @@ msgid "" msgstr "" # 4ed7d9aa36a540f5b6050f18218c92e7 -#: ../src/Doc/library/profile.rst:63 +#: library/profile.rst:63 msgid "" "The profiler modules are designed to provide an execution profile for a " "given program, not for benchmarking purposes (for that, there is :mod:" @@ -78535,11 +80263,11 @@ msgid "" "faster than any Python one." msgstr "" -#: ../src/Doc/library/profile.rst:74 +#: library/profile.rst:74 msgid "Instant User's Manual" msgstr "" -#: ../src/Doc/library/profile.rst:76 +#: library/profile.rst:76 msgid "" "This section is provided for users that \"don't want to read the manual.\" " "It provides a very brief overview, and allows a user to rapidly perform " @@ -78547,25 +80275,25 @@ msgid "" msgstr "" # bcf650f170404d67bbda7b779ab0fb47 -#: ../src/Doc/library/profile.rst:80 +#: library/profile.rst:80 msgid "To profile a function that takes a single argument, you can do::" msgstr "" -#: ../src/Doc/library/profile.rst:86 +#: library/profile.rst:86 msgid "" "(Use :mod:`profile` instead of :mod:`cProfile` if the latter is not " "available on your system.)" msgstr "" # 059f5a81062841d7b2ce416efec15e72 -#: ../src/Doc/library/profile.rst:89 +#: library/profile.rst:89 msgid "" "The above action would run :func:`re.compile` and print profile results like " "the following::" msgstr "" # a3fc11ba42c24afbbb7d64a656fcf02b -#: ../src/Doc/library/profile.rst:105 +#: library/profile.rst:105 msgid "" "The first line indicates that 197 calls were monitored. Of those calls, 192 " "were :dfn:`primitive`, meaning that the call was not induced via recursion. " @@ -78575,21 +80303,21 @@ msgid "" msgstr "" # 729789a0cf884d3cbb739e68d18a9b41 -#: ../src/Doc/library/profile.rst:110 +#: library/profile.rst:111 msgid "ncalls" msgstr "" -#: ../src/Doc/library/profile.rst:111 +#: library/profile.rst:111 msgid "for the number of calls," msgstr "" # b88d6b2544aa4c9e8934fb5314bd1ad7 -#: ../src/Doc/library/profile.rst:114 +#: library/profile.rst:115 msgid "tottime" msgstr "" # 705b422a9c0c481cb79bba0c4be3ab3f -#: ../src/Doc/library/profile.rst:114 +#: library/profile.rst:114 msgid "" "for the total time spent in the given function (and excluding time made in " "calls to sub-functions)" @@ -78597,41 +80325,41 @@ msgstr "" # 453774a7ca914493922730e985b03a7d # 3daf06f33f2843b98d980b367a087a1b -#: ../src/Doc/library/profile.rst:117 ../src/Doc/library/profile.rst:124 +#: library/profile.rst:118 library/profile.rst:125 msgid "percall" msgstr "" -#: ../src/Doc/library/profile.rst:118 +#: library/profile.rst:118 msgid "is the quotient of ``tottime`` divided by ``ncalls``" msgstr "" # 36e4342ae00649bebc68c7891034b69d -#: ../src/Doc/library/profile.rst:121 +#: library/profile.rst:122 msgid "cumtime" msgstr "" # fde82804ca0d46e7ae7d6752e96f0751 -#: ../src/Doc/library/profile.rst:121 +#: library/profile.rst:121 msgid "" "is the cumulative time spent in this and all subfunctions (from invocation " "till exit). This figure is accurate *even* for recursive functions." msgstr "" -#: ../src/Doc/library/profile.rst:125 +#: library/profile.rst:125 msgid "is the quotient of ``cumtime`` divided by primitive calls" msgstr "" # 24bc18abdcb74152ae6af0dbbf11f972 -#: ../src/Doc/library/profile.rst:127 +#: library/profile.rst:128 msgid "filename:lineno(function)" msgstr "" -#: ../src/Doc/library/profile.rst:128 +#: library/profile.rst:128 msgid "provides the respective data of each function" msgstr "" # cc82b1123cea497f954346a1dd6a39e3 -#: ../src/Doc/library/profile.rst:130 +#: library/profile.rst:130 msgid "" "When there are two numbers in the first column (for example ``3/1``), it " "means that the function recursed. The second value is the number of " @@ -78641,40 +80369,40 @@ msgid "" msgstr "" # f48ad0d1bf964b869f7b9fb587b0bdae -#: ../src/Doc/library/profile.rst:136 +#: library/profile.rst:136 msgid "" "Instead of printing the output at the end of the profile run, you can save " "the results to a file by specifying a filename to the :func:`run` function::" msgstr "" # f42d9981c87f48159778d22e067a5ecb -#: ../src/Doc/library/profile.rst:143 +#: library/profile.rst:143 msgid "" "The :class:`pstats.Stats` class reads profile results from a file and " "formats them in various ways." msgstr "" # 5aafbd4a9a06451ab8b8fb3a6c4cfabe -#: ../src/Doc/library/profile.rst:146 +#: library/profile.rst:146 msgid "" "The file :mod:`cProfile` can also be invoked as a script to profile another " "script. For example::" msgstr "" # d94e81911d5a4fc08621fe640b5398ac -#: ../src/Doc/library/profile.rst:151 +#: library/profile.rst:151 msgid "``-o`` writes the profile results to a file instead of to stdout" msgstr "" # 58b93ae4c5a747a9b24d438bd2a631df -#: ../src/Doc/library/profile.rst:153 +#: library/profile.rst:153 msgid "" "``-s`` specifies one of the :func:`~pstats.Stats.sort_stats` sort values to " "sort the output by. This only applies when ``-o`` is not supplied." msgstr "" # 1c16f75948a5475693e13d8891a8db02 -#: ../src/Doc/library/profile.rst:156 +#: library/profile.rst:156 msgid "" "The :mod:`pstats` module's :class:`~pstats.Stats` class has a variety of " "methods for manipulating and printing the data saved into a profile results " @@ -78682,7 +80410,7 @@ msgid "" msgstr "" # c7141ae1397f4cf080038760b8f95ef7 -#: ../src/Doc/library/profile.rst:163 +#: library/profile.rst:163 msgid "" "The :meth:`~pstats.Stats.strip_dirs` method removed the extraneous path from " "all the module names. The :meth:`~pstats.Stats.sort_stats` method sorted all " @@ -78691,44 +80419,44 @@ msgid "" "statistics. You might try the following sort calls::" msgstr "" -#: ../src/Doc/library/profile.rst:172 +#: library/profile.rst:172 msgid "" "The first call will actually sort the list by function name, and the second " "call will print out the statistics. The following are some interesting " "calls to experiment with::" msgstr "" -#: ../src/Doc/library/profile.rst:178 +#: library/profile.rst:178 msgid "" "This sorts the profile by cumulative time in a function, and then only " "prints the ten most significant lines. If you want to understand what " "algorithms are taking time, the above line is what you would use." msgstr "" -#: ../src/Doc/library/profile.rst:182 +#: library/profile.rst:182 msgid "" "If you were looking to see what functions were looping a lot, and taking a " "lot of time, you would do::" msgstr "" -#: ../src/Doc/library/profile.rst:187 +#: library/profile.rst:187 msgid "" "to sort according to time spent within each function, and then print the " "statistics for the top ten functions." msgstr "" -#: ../src/Doc/library/profile.rst:190 +#: library/profile.rst:190 msgid "You might also try::" msgstr "" -#: ../src/Doc/library/profile.rst:194 +#: library/profile.rst:194 msgid "" "This will sort all the statistics by file name, and then print out " "statistics for only the class init methods (since they are spelled with " "``__init__`` in them). As one final example, you could try::" msgstr "" -#: ../src/Doc/library/profile.rst:200 +#: library/profile.rst:200 msgid "" "This line sorts statistics with a primary key of time, and a secondary key " "of cumulative time, and then prints out some of the statistics. To be " @@ -78737,23 +80465,23 @@ msgid "" "list is printed." msgstr "" -#: ../src/Doc/library/profile.rst:205 +#: library/profile.rst:205 msgid "" "If you wondered what functions called the above functions, you could now " "(``p`` is still sorted according to the last criteria) do::" msgstr "" -#: ../src/Doc/library/profile.rst:210 +#: library/profile.rst:210 msgid "and you would get a list of callers for each of the listed functions." msgstr "" -#: ../src/Doc/library/profile.rst:212 +#: library/profile.rst:212 msgid "" "If you want more functionality, you're going to have to read the manual, or " "guess what the following functions do::" msgstr "" -#: ../src/Doc/library/profile.rst:218 +#: library/profile.rst:218 msgid "" "Invoked as a script, the :mod:`pstats` module is a statistics browser for " "reading and examining profile dumps. It has a simple line-oriented " @@ -78761,26 +80489,26 @@ msgid "" msgstr "" # b77f898c53be401cbc40a7e230819496 -#: ../src/Doc/library/profile.rst:223 +#: library/profile.rst:223 msgid ":mod:`profile` and :mod:`cProfile` Module Reference" msgstr "" # de7bf473830b4bcaa902d6789b7e605a -#: ../src/Doc/library/profile.rst:229 +#: library/profile.rst:229 msgid "" "Both the :mod:`profile` and :mod:`cProfile` modules provide the following " "functions:" msgstr "" # 212ec52ed54546588008c1c9a8347e4f -#: ../src/Doc/library/profile.rst:234 +#: library/profile.rst:234 msgid "" "This function takes a single argument that can be passed to the :func:`exec` " "function, and an optional file name. In all cases this routine executes::" msgstr "" # 429301762e444092a9360686abf59eb9 -#: ../src/Doc/library/profile.rst:239 +#: library/profile.rst:239 msgid "" "and gathers profiling statistics from the execution. If no file name is " "present, then this function automatically creates a :class:`~pstats.Stats` " @@ -78790,7 +80518,7 @@ msgid "" msgstr "" # 3a5f19fe9e2641c7b97fbb725e6844cd -#: ../src/Doc/library/profile.rst:247 +#: library/profile.rst:247 msgid "" "This function is similar to :func:`run`, with added arguments to supply the " "globals and locals dictionaries for the *command* string. This routine " @@ -78798,19 +80526,19 @@ msgid "" msgstr "" # 463761a7d423408f87d6883257ffd144 -#: ../src/Doc/library/profile.rst:253 +#: library/profile.rst:253 msgid "and gathers profiling statistics as in the :func:`run` function above." msgstr "" # e6af3e3b5a9a42bdb70733f1a5813089 -#: ../src/Doc/library/profile.rst:257 +#: library/profile.rst:257 msgid "" "This class is normally only used if more precise control over profiling is " "needed than what the :func:`cProfile.run` function provides." msgstr "" # c821d198d7b84a61a7d1ac023f30600f -#: ../src/Doc/library/profile.rst:260 +#: library/profile.rst:260 msgid "" "A custom timer can be supplied for measuring how long code takes to run via " "the *timer* argument. This must be a function that returns a single number " @@ -78821,70 +80549,70 @@ msgid "" msgstr "" # df0c1ed9b39e487baa89d151623686fe -#: ../src/Doc/library/profile.rst:267 +#: library/profile.rst:267 msgid "" "Directly using the :class:`Profile` class allows formatting profile results " "without writing the profile data to a file::" msgstr "" # d0798cc0f3a040f3aa9913e5ff2137f4 -#: ../src/Doc/library/profile.rst:283 +#: library/profile.rst:283 msgid "Start collecting profiling data." msgstr "" # 7d5a61ad18fe4d96a57fb6feffc558e5 -#: ../src/Doc/library/profile.rst:287 +#: library/profile.rst:287 msgid "Stop collecting profiling data." msgstr "" # cc3143846d2d49c4ae7ea68b5d24d753 -#: ../src/Doc/library/profile.rst:291 +#: library/profile.rst:291 msgid "" "Stop collecting profiling data and record the results internally as the " "current profile." msgstr "" # 8be19e2c1dbf4cb2b7dbd28cf43bd09f -#: ../src/Doc/library/profile.rst:296 +#: library/profile.rst:296 msgid "" "Create a :class:`~pstats.Stats` object based on the current profile and " "print the results to stdout." msgstr "" # 27fb904e2d4e42b5a4a34abc9d289070 -#: ../src/Doc/library/profile.rst:301 +#: library/profile.rst:301 msgid "Write the results of the current profile to *filename*." msgstr "" # 86a314e24d3745f8ad2b9e1e5d9701bf -#: ../src/Doc/library/profile.rst:305 +#: library/profile.rst:305 msgid "Profile the cmd via :func:`exec`." msgstr "" # c8f98e79f99042a2b94f3f173ad2184b -#: ../src/Doc/library/profile.rst:309 +#: library/profile.rst:309 msgid "" "Profile the cmd via :func:`exec` with the specified global and local " "environment." msgstr "" # dcc39cf945944e889a0f2c56d3ba3ffb -#: ../src/Doc/library/profile.rst:314 +#: library/profile.rst:314 msgid "Profile ``func(*args, **kwargs)``" msgstr "" -#: ../src/Doc/library/profile.rst:319 +#: library/profile.rst:319 msgid "The :class:`Stats` Class" msgstr "" # f3b3243012b54f239bdede6b274ba3a8 -#: ../src/Doc/library/profile.rst:321 +#: library/profile.rst:321 msgid "" "Analysis of the profiler data is done using the :class:`~pstats.Stats` class." msgstr "" # 50e0aecf1b46408a8ea66e7a4c841cde -#: ../src/Doc/library/profile.rst:328 +#: library/profile.rst:328 msgid "" "This class constructor creates an instance of a \"statistics object\" from a " "*filename* (or list of filenames) or from a :class:`Profile` instance. " @@ -78892,7 +80620,7 @@ msgid "" msgstr "" # 20cb42d0a94e44dcad9e4d62f9ccd96a -#: ../src/Doc/library/profile.rst:332 +#: library/profile.rst:332 msgid "" "The file selected by the above constructor must have been created by the " "corresponding version of :mod:`profile` or :mod:`cProfile`. To be specific, " @@ -78906,18 +80634,18 @@ msgid "" msgstr "" # 3a09c1c434314d20b647e4e3d55abe5e -#: ../src/Doc/library/profile.rst:342 +#: library/profile.rst:342 msgid "" "Instead of reading the profile data from a file, a :class:`cProfile.Profile` " "or :class:`profile.Profile` object can be used as the profile data source." msgstr "" -#: ../src/Doc/library/profile.rst:345 +#: library/profile.rst:345 msgid ":class:`Stats` objects have the following methods:" msgstr "" # da4bb90540c5433b8ea137c76cc38b43 -#: ../src/Doc/library/profile.rst:349 +#: library/profile.rst:349 msgid "" "This method for the :class:`Stats` class removes all leading path " "information from file names. It is very useful in reducing the size of the " @@ -78931,7 +80659,7 @@ msgid "" "single entry." msgstr "" -#: ../src/Doc/library/profile.rst:363 +#: library/profile.rst:363 msgid "" "This method of the :class:`Stats` class accumulates additional profiling " "information into the current profiling object. Its arguments should refer " @@ -78941,7 +80669,7 @@ msgid "" msgstr "" # eb6d612734374b07ba31b9595fbb9270 -#: ../src/Doc/library/profile.rst:373 +#: library/profile.rst:373 msgid "" "Save the data loaded into the :class:`Stats` object to a file named " "*filename*. The file is created if it does not exist, and is overwritten if " @@ -78949,14 +80677,14 @@ msgid "" "the :class:`profile.Profile` and :class:`cProfile.Profile` classes." msgstr "" -#: ../src/Doc/library/profile.rst:383 +#: library/profile.rst:383 msgid "" "This method modifies the :class:`Stats` object by sorting it according to " "the supplied criteria. The argument is typically a string identifying the " "basis of a sort (example: ``'time'`` or ``'name'``)." msgstr "" -#: ../src/Doc/library/profile.rst:387 +#: library/profile.rst:387 msgid "" "When more than one key is provided, then additional keys are used as " "secondary criteria when there is equality in all keys selected before them. " @@ -78965,114 +80693,113 @@ msgid "" "names) by sorting by file name." msgstr "" -#: ../src/Doc/library/profile.rst:393 +#: library/profile.rst:393 msgid "" "Abbreviations can be used for any key names, as long as the abbreviation is " "unambiguous. The following are the keys currently defined:" msgstr "" -#: ../src/Doc/library/profile.rst:397 +#: library/profile.rst:397 msgid "Valid Arg" msgstr "" -#: ../src/Doc/library/profile.rst:399 +#: library/profile.rst:399 msgid "``'calls'``" msgstr "" -#: ../src/Doc/library/profile.rst:399 ../src/Doc/library/profile.rst:411 +#: library/profile.rst:399 library/profile.rst:411 msgid "call count" msgstr "" -#: ../src/Doc/library/profile.rst:401 +#: library/profile.rst:401 msgid "``'cumulative'``" msgstr "" -#: ../src/Doc/library/profile.rst:401 ../src/Doc/library/profile.rst:403 +#: library/profile.rst:401 library/profile.rst:403 msgid "cumulative time" msgstr "" # 9abc0a24c4ab49948b083da81f1cb716 -#: ../src/Doc/library/profile.rst:403 +#: library/profile.rst:403 msgid "``'cumtime'``" msgstr "" -#: ../src/Doc/library/profile.rst:405 +#: library/profile.rst:405 msgid "``'file'``" msgstr "" -#: ../src/Doc/library/profile.rst:405 ../src/Doc/library/profile.rst:407 -#: ../src/Doc/library/profile.rst:409 +#: library/profile.rst:405 library/profile.rst:407 library/profile.rst:409 msgid "file name" msgstr "" # ea589860e36a449598b77d99be688465 -#: ../src/Doc/library/profile.rst:407 +#: library/profile.rst:407 msgid "``'filename'``" msgstr "" -#: ../src/Doc/library/profile.rst:409 +#: library/profile.rst:409 msgid "``'module'``" msgstr "" # 882e0bba5a8c4feca459545aa011351f -#: ../src/Doc/library/profile.rst:411 +#: library/profile.rst:411 msgid "``'ncalls'``" msgstr "" -#: ../src/Doc/library/profile.rst:413 +#: library/profile.rst:413 msgid "``'pcalls'``" msgstr "" -#: ../src/Doc/library/profile.rst:413 +#: library/profile.rst:413 msgid "primitive call count" msgstr "" -#: ../src/Doc/library/profile.rst:415 ../src/Doc/library/sys.rst:915 +#: library/profile.rst:415 msgid "``'line'``" msgstr "" -#: ../src/Doc/library/profile.rst:415 +#: library/profile.rst:415 msgid "line number" msgstr "" -#: ../src/Doc/library/profile.rst:417 +#: library/profile.rst:417 msgid "``'name'``" msgstr "" -#: ../src/Doc/library/profile.rst:417 +#: library/profile.rst:417 msgid "function name" msgstr "" -#: ../src/Doc/library/profile.rst:419 +#: library/profile.rst:419 msgid "``'nfl'``" msgstr "" -#: ../src/Doc/library/profile.rst:419 +#: library/profile.rst:419 msgid "name/file/line" msgstr "" -#: ../src/Doc/library/profile.rst:421 +#: library/profile.rst:421 msgid "``'stdname'``" msgstr "" -#: ../src/Doc/library/profile.rst:421 +#: library/profile.rst:421 msgid "standard name" msgstr "" -#: ../src/Doc/library/profile.rst:423 +#: library/profile.rst:423 msgid "``'time'``" msgstr "" -#: ../src/Doc/library/profile.rst:423 ../src/Doc/library/profile.rst:425 +#: library/profile.rst:423 library/profile.rst:425 msgid "internal time" msgstr "" # ee1ea3cf68194ac2a0cf2973819761dc -#: ../src/Doc/library/profile.rst:425 +#: library/profile.rst:425 msgid "``'tottime'``" msgstr "" -#: ../src/Doc/library/profile.rst:428 +#: library/profile.rst:428 msgid "" "Note that all sorts on statistics are in descending order (placing most time " "consuming items first), where as name, file, and line number searches are in " @@ -79085,7 +80812,7 @@ msgid "" "``sort_stats('name', 'file', 'line')``." msgstr "" -#: ../src/Doc/library/profile.rst:439 +#: library/profile.rst:439 msgid "" "For backward-compatibility reasons, the numeric arguments ``-1``, ``0``, " "``1``, and ``2`` are permitted. They are interpreted as ``'stdname'``, " @@ -79094,21 +80821,21 @@ msgid "" "used, and additional arguments will be silently ignored." msgstr "" -#: ../src/Doc/library/profile.rst:450 +#: library/profile.rst:450 msgid "" "This method for the :class:`Stats` class reverses the ordering of the basic " "list within the object. Note that by default ascending vs descending order " "is properly selected based on the sort key of choice." msgstr "" -#: ../src/Doc/library/profile.rst:460 +#: library/profile.rst:460 msgid "" "This method for the :class:`Stats` class prints out a report as described in " "the :func:`profile.run` definition." msgstr "" # e116bb8e39b24898b18555dad2701452 -#: ../src/Doc/library/profile.rst:463 +#: library/profile.rst:463 msgid "" "The order of the printing is based on the last :meth:`~pstats.Stats." "sort_stats` operation done on the object (subject to caveats in :meth:" @@ -79116,7 +80843,7 @@ msgid "" msgstr "" # 8a3fa4d1cc80454ab33f1edb455f2fd2 -#: ../src/Doc/library/profile.rst:468 +#: library/profile.rst:468 msgid "" "The arguments provided (if any) can be used to limit the list down to the " "significant entries. Initially, the list is taken to be the complete set of " @@ -79127,21 +80854,21 @@ msgid "" "they are applied sequentially. For example::" msgstr "" -#: ../src/Doc/library/profile.rst:478 +#: library/profile.rst:478 msgid "" "would first limit the printing to first 10% of list, and then only print " "functions that were part of filename :file:`.\\*foo:`. In contrast, the " "command::" msgstr "" -#: ../src/Doc/library/profile.rst:484 +#: library/profile.rst:484 msgid "" "would limit the list to all functions having file names :file:`.\\*foo:`, " "and then proceed to only print the first 10% of them." msgstr "" # a6e9a6f14a2143d1a7b067d9c46d0574 -#: ../src/Doc/library/profile.rst:490 +#: library/profile.rst:490 msgid "" "This method for the :class:`Stats` class prints a list of all functions that " "called each function in the profiled database. The ordering is identical to " @@ -79151,7 +80878,7 @@ msgid "" "produced the stats:" msgstr "" -#: ../src/Doc/library/profile.rst:497 +#: library/profile.rst:497 msgid "" "With :mod:`profile`, a number is shown in parentheses after each caller to " "show how many times this specific call was made. For convenience, a second " @@ -79159,7 +80886,7 @@ msgid "" "at the right." msgstr "" -#: ../src/Doc/library/profile.rst:502 +#: library/profile.rst:502 msgid "" "With :mod:`cProfile`, each caller is preceded by three numbers: the number " "of times this specific call was made, and the total and cumulative times " @@ -79167,7 +80894,7 @@ msgid "" msgstr "" # 127fb828481e42358dd294488d6bc817 -#: ../src/Doc/library/profile.rst:510 +#: library/profile.rst:510 msgid "" "This method for the :class:`Stats` class prints a list of all function that " "were called by the indicated function. Aside from this reversal of " @@ -79175,11 +80902,11 @@ msgid "" "are identical to the :meth:`~pstats.Stats.print_callers` method." msgstr "" -#: ../src/Doc/library/profile.rst:519 +#: library/profile.rst:519 msgid "What Is Deterministic Profiling?" msgstr "" -#: ../src/Doc/library/profile.rst:521 +#: library/profile.rst:521 msgid "" ":dfn:`Deterministic profiling` is meant to reflect the fact that all " "*function call*, *function return*, and *exception* events are monitored, " @@ -79192,7 +80919,7 @@ msgid "" "being spent." msgstr "" -#: ../src/Doc/library/profile.rst:530 +#: library/profile.rst:530 msgid "" "In Python, since there is an interpreter active during execution, the " "presence of instrumented code is not required to do deterministic " @@ -79204,7 +80931,7 @@ msgid "" "time statistics about the execution of a Python program." msgstr "" -#: ../src/Doc/library/profile.rst:539 +#: library/profile.rst:539 msgid "" "Call count statistics can be used to identify bugs in code (surprising " "counts), and to identify possible inline-expansion points (high call " @@ -79216,7 +80943,7 @@ msgid "" "compared to iterative implementations." msgstr "" -#: ../src/Doc/library/profile.rst:554 +#: library/profile.rst:554 msgid "" "One limitation has to do with accuracy of timing information. There is a " "fundamental problem with deterministic profilers involving accuracy. The " @@ -79227,7 +80954,7 @@ msgid "" "first error induces a second source of error." msgstr "" -#: ../src/Doc/library/profile.rst:562 +#: library/profile.rst:562 msgid "" "The second problem is that it \"takes a while\" from when an event is " "dispatched until the profiler's call to get the time actually *gets* the " @@ -79240,7 +80967,7 @@ msgid "" "clock tick), but it *can* accumulate and become very significant." msgstr "" -#: ../src/Doc/library/profile.rst:572 +#: library/profile.rst:572 msgid "" "The problem is more important with :mod:`profile` than with the lower-" "overhead :mod:`cProfile`. For this reason, :mod:`profile` provides a means " @@ -79254,12 +80981,12 @@ msgid "" "calibration." msgstr "" -#: ../src/Doc/library/profile.rst:586 +#: library/profile.rst:586 msgid "Calibration" msgstr "" # 9bb5891090644aeeb2d060bef3e8c556 -#: ../src/Doc/library/profile.rst:588 +#: library/profile.rst:588 msgid "" "The profiler of the :mod:`profile` module subtracts a constant from each " "event handling time to compensate for the overhead of calling the time " @@ -79269,7 +80996,7 @@ msgid "" msgstr "" # 48cab54fcdd9464cbe51f815926b6d24 -#: ../src/Doc/library/profile.rst:599 +#: library/profile.rst:599 msgid "" "The method executes the number of Python calls given by the argument, " "directly and again under the profiler, measuring the time for both. It then " @@ -79278,7 +81005,7 @@ msgid "" "Python's time.clock() as the timer, the magical number is about 4.04e-6." msgstr "" -#: ../src/Doc/library/profile.rst:605 +#: library/profile.rst:605 msgid "" "The object of this exercise is to get a fairly consistent result. If your " "computer is *very* fast, or your timer function has poor resolution, you " @@ -79286,13 +81013,13 @@ msgid "" msgstr "" # 96719cdc26be47149a2b97d987335b00 -#: ../src/Doc/library/profile.rst:609 +#: library/profile.rst:609 msgid "" "When you have a consistent answer, there are three ways you can use it: " "[#]_ ::" msgstr "" -#: ../src/Doc/library/profile.rst:623 +#: library/profile.rst:623 msgid "" "If you have a choice, you are better off choosing a smaller constant, and " "then your results will \"less often\" show up as negative in profile " @@ -79300,12 +81027,12 @@ msgid "" msgstr "" # bab3dfbfcda64d4c83d3fa21f6ce0604 -#: ../src/Doc/library/profile.rst:629 +#: library/profile.rst:629 msgid "Using a custom timer" msgstr "" # d51b879407fe4d128762609304adc608 -#: ../src/Doc/library/profile.rst:631 +#: library/profile.rst:631 msgid "" "If you want to change how current time is determined (for example, to force " "use of wall-clock time or elapsed process time), pass the timing function " @@ -79313,20 +81040,19 @@ msgid "" msgstr "" # 56c11ee0a484418d9c5c944502eb79d6 -#: ../src/Doc/library/profile.rst:637 +#: library/profile.rst:637 msgid "" "The resulting profiler will then call ``your_time_func``. Depending on " "whether you are using :class:`profile.Profile` or :class:`cProfile.Profile`, " "``your_time_func``'s return value will be interpreted differently:" msgstr "" -# c2bbe9db6324464ab1371dbde8609a80 -#: ../src/Doc/library/profile.rst:654 -msgid ":class:`profile.Profile`" +#: library/profile.rst:655 +msgid "profile.Profile" msgstr "" # bf8c379b390e42b29076de5aaeeb72b9 -#: ../src/Doc/library/profile.rst:642 +#: library/profile.rst:642 msgid "" "``your_time_func`` should return a single number, or a list of numbers whose " "sum is the current time (like what :func:`os.times` returns). If the " @@ -79336,7 +81062,7 @@ msgid "" msgstr "" # 5a3e59982fd64caca6fef4afdc7214d4 -#: ../src/Doc/library/profile.rst:648 +#: library/profile.rst:648 msgid "" "Be warned that you should calibrate the profiler class for the timer " "function that you choose (see :ref:`profile-calibration`). For most " @@ -79348,13 +81074,12 @@ msgid "" "along with the appropriate calibration constant." msgstr "" -# 446e9cc6411249bab498d7841d5b4462 -#: ../src/Doc/library/profile.rst:669 -msgid ":class:`cProfile.Profile`" +#: library/profile.rst:670 +msgid "cProfile.Profile" msgstr "" # dc478e7aa1c34fc98471ae85df2b4918 -#: ../src/Doc/library/profile.rst:658 +#: library/profile.rst:658 msgid "" "``your_time_func`` should return a single number. If it returns integers, " "you can also invoke the class constructor with a second argument specifying " @@ -79363,45 +81088,45 @@ msgid "" "you would construct the :class:`Profile` instance as follows::" msgstr "" -#: ../src/Doc/library/profile.rst:666 +#: library/profile.rst:666 msgid "" -"As the :mod:`cProfile.Profile` class cannot be calibrated, custom timer " +"As the :class:`cProfile.Profile` class cannot be calibrated, custom timer " "functions should be used with care and should be as fast as possible. For " "the best results with a custom timer, it might be necessary to hard-code it " "in the C source of the internal :mod:`_lsprof` module." msgstr "" # 613c7a7e72314758a79f5d42553df9b5 -#: ../src/Doc/library/profile.rst:674 +#: library/profile.rst:674 msgid "" "Prior to Python 2.2, it was necessary to edit the profiler source code to " "embed the bias as a literal number. You still can, but that method is no " "longer described, because no longer needed." msgstr "" -#: ../src/Doc/library/pty.rst:3 +#: library/pty.rst:3 msgid ":mod:`pty` --- Pseudo-terminal utilities" msgstr "" -#: ../src/Doc/library/pty.rst:12 +#: library/pty.rst:12 msgid "" "The :mod:`pty` module defines operations for handling the pseudo-terminal " "concept: starting another process and being able to write to and read from " "its controlling terminal programmatically." msgstr "" -#: ../src/Doc/library/pty.rst:16 +#: library/pty.rst:16 msgid "" "Because pseudo-terminal handling is highly platform dependent, there is code " "to do it only for Linux. (The Linux code is supposed to work on other " "platforms, but hasn't been tested yet.)" msgstr "" -#: ../src/Doc/library/pty.rst:20 +#: library/pty.rst:20 msgid "The :mod:`pty` module defines the following functions:" msgstr "" -#: ../src/Doc/library/pty.rst:25 +#: library/pty.rst:25 msgid "" "Fork. Connect the child's controlling terminal to a pseudo-terminal. Return " "value is ``(pid, fd)``. Note that the child gets *pid* 0, and the *fd* is " @@ -79410,112 +81135,111 @@ msgid "" "the child's standard input and output)." msgstr "" -#: ../src/Doc/library/pty.rst:34 +#: library/pty.rst:34 msgid "" "Open a new pseudo-terminal pair, using :func:`os.openpty` if possible, or " "emulation code for generic Unix systems. Return a pair of file descriptors " "``(master, slave)``, for the master and the slave end, respectively." msgstr "" -#: ../src/Doc/library/pty.rst:41 +#: library/pty.rst:41 msgid "" "Spawn a process, and connect its controlling terminal with the current " "process's standard io. This is often used to baffle programs which insist on " "reading from the controlling terminal." msgstr "" -#: ../src/Doc/library/pty.rst:45 +#: library/pty.rst:45 msgid "" "The functions *master_read* and *stdin_read* should be functions which read " "from a file descriptor. The defaults try to read 1024 bytes each time they " "are called." msgstr "" -#: ../src/Doc/library/pwd.rst:3 +#: library/pwd.rst:3 msgid ":mod:`pwd` --- The password database" msgstr "" -#: ../src/Doc/library/pwd.rst:10 +#: library/pwd.rst:10 msgid "" "This module provides access to the Unix user account and password database. " "It is available on all Unix versions." msgstr "" -#: ../src/Doc/library/pwd.rst:13 +#: library/pwd.rst:13 msgid "" "Password database entries are reported as a tuple-like object, whose " "attributes correspond to the members of the ``passwd`` structure (Attribute " "field below, see ````):" msgstr "" -#: ../src/Doc/library/pwd.rst:20 +#: library/pwd.rst:20 msgid "``pw_name``" msgstr "" -#: ../src/Doc/library/pwd.rst:20 ../src/Doc/library/spwd.rst:25 +#: library/pwd.rst:20 library/spwd.rst:25 msgid "Login name" msgstr "" -#: ../src/Doc/library/pwd.rst:22 +#: library/pwd.rst:22 msgid "``pw_passwd``" msgstr "" -#: ../src/Doc/library/pwd.rst:22 +#: library/pwd.rst:22 msgid "Optional encrypted password" msgstr "" -#: ../src/Doc/library/pwd.rst:24 +#: library/pwd.rst:24 msgid "``pw_uid``" msgstr "" -#: ../src/Doc/library/pwd.rst:24 +#: library/pwd.rst:24 msgid "Numerical user ID" msgstr "" -#: ../src/Doc/library/pwd.rst:26 +#: library/pwd.rst:26 msgid "``pw_gid``" msgstr "" -#: ../src/Doc/library/pwd.rst:26 +#: library/pwd.rst:26 msgid "Numerical group ID" msgstr "" -#: ../src/Doc/library/pwd.rst:28 +#: library/pwd.rst:28 msgid "``pw_gecos``" msgstr "" -#: ../src/Doc/library/pwd.rst:28 +#: library/pwd.rst:28 msgid "User name or comment field" msgstr "" -#: ../src/Doc/library/pwd.rst:30 +#: library/pwd.rst:30 msgid "``pw_dir``" msgstr "" -#: ../src/Doc/library/pwd.rst:30 +#: library/pwd.rst:30 msgid "User home directory" msgstr "" -#: ../src/Doc/library/pwd.rst:32 ../src/Doc/library/spwd.rst:40 -#: ../src/Doc/library/time.rst:420 +#: library/pwd.rst:32 library/spwd.rst:40 library/time.rst:419 msgid "6" msgstr "" -#: ../src/Doc/library/pwd.rst:32 +#: library/pwd.rst:32 msgid "``pw_shell``" msgstr "" -#: ../src/Doc/library/pwd.rst:32 +#: library/pwd.rst:32 msgid "User command interpreter" msgstr "" -#: ../src/Doc/library/pwd.rst:35 +#: library/pwd.rst:35 msgid "" "The uid and gid items are integers, all others are strings. :exc:`KeyError` " "is raised if the entry asked for cannot be found." msgstr "" -#: ../src/Doc/library/pwd.rst:42 +#: library/pwd.rst:42 msgid "" "In traditional Unix the field ``pw_passwd`` usually contains a password " "encrypted with a DES derived algorithm (see module :mod:`crypt`). However " @@ -79527,59 +81251,58 @@ msgid "" "should be used where access to the encrypted password is required." msgstr "" -#: ../src/Doc/library/pwd.rst:56 +#: library/pwd.rst:56 msgid "Return the password database entry for the given numeric user ID." msgstr "" -#: ../src/Doc/library/pwd.rst:61 +#: library/pwd.rst:61 msgid "Return the password database entry for the given user name." msgstr "" -#: ../src/Doc/library/pwd.rst:66 +#: library/pwd.rst:66 msgid "" "Return a list of all available password database entries, in arbitrary order." msgstr "" -# 102d6d185e4647cdbc1095f6c3ccc2a9 -# a35ff0b5e7a6405e9940c30a2afc1129 -#: ../src/Doc/library/pwd.rst:71 ../src/Doc/library/spwd.rst:69 -msgid "Module :mod:`grp`" -msgstr "" +#: library/pwd.rst:72 library/spwd.rst:70 +#, fuzzy +msgid "Module grp" +msgstr "Modules" -#: ../src/Doc/library/pwd.rst:72 ../src/Doc/library/spwd.rst:70 +#: library/pwd.rst:72 library/spwd.rst:70 msgid "An interface to the group database, similar to this." msgstr "" -#: ../src/Doc/library/py_compile.rst:2 +#: library/py_compile.rst:2 msgid ":mod:`py_compile` --- Compile Python source files" msgstr "" # 2517e3a42a224b72b2758922ddf760cf -#: ../src/Doc/library/py_compile.rst:11 +#: library/py_compile.rst:11 msgid "**Source code:** :source:`Lib/py_compile.py`" msgstr "" -#: ../src/Doc/library/py_compile.rst:15 +#: library/py_compile.rst:15 msgid "" "The :mod:`py_compile` module provides a function to generate a byte-code " "file from a source file, and another function used when the module source " "file is invoked as a script." msgstr "" -#: ../src/Doc/library/py_compile.rst:19 +#: library/py_compile.rst:19 msgid "" "Though not often needed, this function can be useful when installing modules " "for shared use, especially if some of the users may not have permission to " "write the byte-code cache files in the directory containing the source code." msgstr "" -#: ../src/Doc/library/py_compile.rst:26 +#: library/py_compile.rst:26 msgid "" "Exception raised when an error occurs while attempting to compile the file." msgstr "" # b6bdfb2895fe4cfeae5115d2c473312e -#: ../src/Doc/library/py_compile.rst:31 +#: library/py_compile.rst:31 msgid "" "Compile a source file to byte-code and write out the byte-code cache file. " "The source code is loaded from the file name *file*. The byte-code is " @@ -79593,7 +81316,7 @@ msgid "" msgstr "" # c85ac6f3c699411293efa922abcc33d7 -#: ../src/Doc/library/py_compile.rst:43 +#: library/py_compile.rst:43 msgid "" "Compile several source files. The files named in *args* (or on the command " "line, if *args* is not specified) are compiled and the resulting bytecode is " @@ -79603,32 +81326,39 @@ msgid "" "standard input." msgstr "" -#: ../src/Doc/library/py_compile.rst:53 +#: library/py_compile.rst:50 +msgid "Added support for ``'-'``." +msgstr "" + +#: library/py_compile.rst:53 msgid "" "When this module is run as a script, the :func:`main` is used to compile all " "the files named on the command line. The exit status is nonzero if one of " "the files could not be compiled." msgstr "" -# 9238b1aace16428faaa35d532aea4d96 -#: ../src/Doc/library/py_compile.rst:62 -msgid "Module :mod:`compileall`" +#: library/py_compile.rst:57 +msgid "Added the nonzero exit status when module is run as a script." msgstr "" -#: ../src/Doc/library/py_compile.rst:64 +#: library/py_compile.rst:63 +msgid "Module compileall" +msgstr "" + +#: library/py_compile.rst:64 msgid "Utilities to compile all Python source files in a directory tree." msgstr "" -#: ../src/Doc/library/pyclbr.rst:2 +#: library/pyclbr.rst:2 msgid ":mod:`pyclbr` --- Python class browser support" msgstr "" # a7d524470d8d4cf7b87418db4e0b6446 -#: ../src/Doc/library/pyclbr.rst:8 +#: library/pyclbr.rst:8 msgid "**Source code:** :source:`Lib/pyclbr.py`" msgstr "" -#: ../src/Doc/library/pyclbr.rst:12 +#: library/pyclbr.rst:12 msgid "" "The :mod:`pyclbr` module can be used to determine some limited information " "about the classes, methods and top-level functions defined in a module. The " @@ -79640,7 +81370,7 @@ msgid "" "modules." msgstr "" -#: ../src/Doc/library/pyclbr.rst:24 +#: library/pyclbr.rst:24 msgid "" "Read a module and return a dictionary mapping class names to class " "descriptor objects. The parameter *module* should be the name of a module " @@ -79649,7 +81379,7 @@ msgid "" "path``, which is used to locate module source code." msgstr "" -#: ../src/Doc/library/pyclbr.rst:33 +#: library/pyclbr.rst:33 msgid "" "Like :func:`readmodule`, but the returned dictionary, in addition to mapping " "class names to class descriptor objects, also maps top-level function names " @@ -79658,28 +81388,28 @@ msgid "" "a list which contains the package search path." msgstr "" -#: ../src/Doc/library/pyclbr.rst:44 +#: library/pyclbr.rst:44 msgid "Class Objects" msgstr "Les objets classe" # 5c98415d107b4720ac5add27915352ac -#: ../src/Doc/library/pyclbr.rst:46 +#: library/pyclbr.rst:46 msgid "" "The :class:`Class` objects used as values in the dictionary returned by :" "func:`readmodule` and :func:`readmodule_ex` provide the following data " "attributes:" msgstr "" -#: ../src/Doc/library/pyclbr.rst:53 +#: library/pyclbr.rst:53 msgid "" "The name of the module defining the class described by the class descriptor." msgstr "" -#: ../src/Doc/library/pyclbr.rst:58 +#: library/pyclbr.rst:58 msgid "The name of the class." msgstr "" -#: ../src/Doc/library/pyclbr.rst:63 +#: library/pyclbr.rst:63 msgid "" "A list of :class:`Class` objects which describe the immediate base classes " "of the class being described. Classes which are named as superclasses but " @@ -79687,62 +81417,62 @@ msgid "" "the class name instead of as :class:`Class` objects." msgstr "" -#: ../src/Doc/library/pyclbr.rst:72 +#: library/pyclbr.rst:72 msgid "A dictionary mapping method names to line numbers." msgstr "" -#: ../src/Doc/library/pyclbr.rst:77 +#: library/pyclbr.rst:77 msgid "Name of the file containing the ``class`` statement defining the class." msgstr "" -#: ../src/Doc/library/pyclbr.rst:82 +#: library/pyclbr.rst:82 msgid "" "The line number of the ``class`` statement within the file named by :attr:" "`~Class.file`." msgstr "" -#: ../src/Doc/library/pyclbr.rst:89 +#: library/pyclbr.rst:89 msgid "Function Objects" msgstr "" # dcb4b6c66e9545a89deeffba131eed2f -#: ../src/Doc/library/pyclbr.rst:91 +#: library/pyclbr.rst:91 msgid "" "The :class:`Function` objects used as values in the dictionary returned by :" "func:`readmodule_ex` provide the following attributes:" msgstr "" -#: ../src/Doc/library/pyclbr.rst:97 +#: library/pyclbr.rst:97 msgid "" "The name of the module defining the function described by the function " "descriptor." msgstr "" -#: ../src/Doc/library/pyclbr.rst:103 +#: library/pyclbr.rst:103 msgid "The name of the function." msgstr "" -#: ../src/Doc/library/pyclbr.rst:108 +#: library/pyclbr.rst:108 msgid "" "Name of the file containing the ``def`` statement defining the function." msgstr "" -#: ../src/Doc/library/pyclbr.rst:113 +#: library/pyclbr.rst:113 msgid "" "The line number of the ``def`` statement within the file named by :attr:" "`~Function.file`." msgstr "" -#: ../src/Doc/library/pydoc.rst:2 +#: library/pydoc.rst:2 msgid ":mod:`pydoc` --- Documentation generator and online help system" msgstr "" # 9af5a6544da14fa98ab89109e1bafe91 -#: ../src/Doc/library/pydoc.rst:17 +#: library/pydoc.rst:17 msgid "**Source code:** :source:`Lib/pydoc.py`" msgstr "" -#: ../src/Doc/library/pydoc.rst:21 +#: library/pydoc.rst:21 msgid "" "The :mod:`pydoc` module automatically generates documentation from Python " "modules. The documentation can be presented as pages of text on the " @@ -79750,7 +81480,7 @@ msgid "" msgstr "" # bab8280d4a3e4889b27ec1abb25218d3 -#: ../src/Doc/library/pydoc.rst:25 +#: library/pydoc.rst:25 msgid "" "For modules, classes, functions and methods, the displayed documentation is " "derived from the docstring (i.e. the :attr:`__doc__` attribute) of the " @@ -79761,7 +81491,7 @@ msgid "" "getcomments`)." msgstr "" -#: ../src/Doc/library/pydoc.rst:32 +#: library/pydoc.rst:32 msgid "" "The built-in function :func:`help` invokes the online help system in the " "interactive interpreter, which uses :mod:`pydoc` to generate its " @@ -79770,7 +81500,7 @@ msgid "" "a script at the operating system's command prompt. For example, running ::" msgstr "" -#: ../src/Doc/library/pydoc.rst:40 +#: library/pydoc.rst:40 msgid "" "at a shell prompt will display documentation on the :mod:`sys` module, in a " "style similar to the manual pages shown by the Unix :program:`man` command. " @@ -79782,7 +81512,7 @@ msgid "" "file, then documentation is produced for that file." msgstr "" -#: ../src/Doc/library/pydoc.rst:51 +#: library/pydoc.rst:51 msgid "" "In order to find objects and their documentation, :mod:`pydoc` imports the " "module(s) to be documented. Therefore, any code on module level will be " @@ -79790,8 +81520,15 @@ msgid "" "only execute code when a file is invoked as a script and not just imported." msgstr "" +#: library/pydoc.rst:56 +msgid "" +"When printing output to the console, :program:`pydoc` attempts to paginate " +"the output for easier reading. If the :envvar:`PAGER` environment variable " +"is set, :program:`pydoc` will use its value as a pagination program." +msgstr "" + # 56a152b099b14822baa16a0ef4c3380b -#: ../src/Doc/library/pydoc.rst:56 +#: library/pydoc.rst:60 msgid "" "Specifying a ``-w`` flag before the argument will cause HTML documentation " "to be written out to a file in the current directory, instead of displaying " @@ -79799,7 +81536,7 @@ msgid "" msgstr "" # e56264cf16574f489c3cafc5dcd8c948 -#: ../src/Doc/library/pydoc.rst:60 +#: library/pydoc.rst:64 msgid "" "Specifying a ``-k`` flag before the argument will search the synopsis lines " "of all available modules for the keyword given as the argument, again in a " @@ -79808,7 +81545,7 @@ msgid "" msgstr "" # 50f0cca565ef42178bcb33c5214639fe -#: ../src/Doc/library/pydoc.rst:65 +#: library/pydoc.rst:69 msgid "" "You can also use :program:`pydoc` to start an HTTP server on the local " "machine that will serve documentation to visiting Web browsers. :program:" @@ -79820,7 +81557,7 @@ msgid "" msgstr "" # a83bbe0d417848208ae311042fd47165 -#: ../src/Doc/library/pydoc.rst:73 +#: library/pydoc.rst:77 msgid "" "When :program:`pydoc` generates documentation, it uses the current " "environment and path to locate modules. Thus, invoking :program:`pydoc " @@ -79829,7 +81566,7 @@ msgid "" msgstr "" # c7699a7d47b245f1b81bbd8924a07ad5 -#: ../src/Doc/library/pydoc.rst:78 +#: library/pydoc.rst:82 msgid "" "Module docs for core modules are assumed to reside in https://docs.python." "org/library/. This can be overridden by setting the :envvar:`PYTHONDOCS` " @@ -79837,19 +81574,19 @@ msgid "" "the Library Reference Manual pages." msgstr "" -#: ../src/Doc/library/pyexpat.rst:3 +#: library/pyexpat.rst:3 msgid ":mod:`xml.parsers.expat` --- Fast XML parsing using Expat" msgstr "" # 719c2d4ecd7449efb3221c7a745f3cd0 -#: ../src/Doc/library/pyexpat.rst:20 +#: library/pyexpat.rst:20 msgid "" "The :mod:`pyexpat` module is not secure against maliciously constructed " "data. If you need to parse untrusted or unauthenticated data see :ref:`xml-" "vulnerabilities`." msgstr "" -#: ../src/Doc/library/pyexpat.rst:29 +#: library/pyexpat.rst:29 msgid "" "The :mod:`xml.parsers.expat` module is a Python interface to the Expat non-" "validating XML parser. The module provides a single extension type, :class:" @@ -79860,39 +81597,39 @@ msgid "" "in the XML document." msgstr "" -#: ../src/Doc/library/pyexpat.rst:39 +#: library/pyexpat.rst:39 msgid "" "This module uses the :mod:`pyexpat` module to provide access to the Expat " "parser. Direct use of the :mod:`pyexpat` module is deprecated." msgstr "" -#: ../src/Doc/library/pyexpat.rst:42 +#: library/pyexpat.rst:42 msgid "This module provides one exception and one type object:" msgstr "" -#: ../src/Doc/library/pyexpat.rst:47 +#: library/pyexpat.rst:47 msgid "" "The exception raised when Expat reports an error. See section :ref:" "`expaterror-objects` for more information on interpreting Expat errors." msgstr "" -#: ../src/Doc/library/pyexpat.rst:53 +#: library/pyexpat.rst:53 msgid "Alias for :exc:`ExpatError`." msgstr "" -#: ../src/Doc/library/pyexpat.rst:58 +#: library/pyexpat.rst:58 msgid "The type of the return values from the :func:`ParserCreate` function." msgstr "" -#: ../src/Doc/library/pyexpat.rst:60 +#: library/pyexpat.rst:60 msgid "The :mod:`xml.parsers.expat` module contains two functions:" msgstr "" -#: ../src/Doc/library/pyexpat.rst:65 +#: library/pyexpat.rst:65 msgid "Returns an explanatory string for a given error number *errno*." msgstr "" -#: ../src/Doc/library/pyexpat.rst:70 +#: library/pyexpat.rst:70 msgid "" "Creates and returns a new :class:`xmlparser` object. *encoding*, if " "specified, must be a string naming the encoding used by the XML data. " @@ -79902,7 +81639,7 @@ msgid "" "implicit or explicit encoding of the document." msgstr "" -#: ../src/Doc/library/pyexpat.rst:77 +#: library/pyexpat.rst:77 msgid "" "Expat can optionally do XML namespace processing for you, enabled by " "providing a value for *namespace_separator*. The value must be a one-" @@ -79917,20 +81654,20 @@ msgid "" "concatenated without any separator." msgstr "" -#: ../src/Doc/library/pyexpat.rst:89 +#: library/pyexpat.rst:89 msgid "" "For example, if *namespace_separator* is set to a space character (``' '``) " "and the following document is parsed::" msgstr "" -#: ../src/Doc/library/pyexpat.rst:99 +#: library/pyexpat.rst:99 msgid "" ":attr:`StartElementHandler` will receive the following strings for each " "element::" msgstr "" # ed6a82bd4eb546a8996593bc025b958b -#: ../src/Doc/library/pyexpat.rst:106 +#: library/pyexpat.rst:106 msgid "" "Due to limitations in the ``Expat`` library used by :mod:`pyexpat`, the :" "class:`xmlparser` instance returned can only be used to parse a single XML " @@ -79938,26 +81675,24 @@ msgid "" "instances." msgstr "" -# ae146d9287504e0da5b8657e5d022151 -#: ../src/Doc/library/pyexpat.rst:112 -msgid "`The Expat XML Parser `_" +#: library/pyexpat.rst:113 +msgid "The Expat XML Parser" msgstr "" -#: ../src/Doc/library/pyexpat.rst:114 +#: library/pyexpat.rst:114 msgid "Home page of the Expat project." msgstr "" -#: ../src/Doc/library/pyexpat.rst:120 -#: ../src/Doc/library/xml.etree.elementtree.rst:883 +#: library/pyexpat.rst:120 library/xml.etree.elementtree.rst:962 msgid "XMLParser Objects" msgstr "" -#: ../src/Doc/library/pyexpat.rst:122 +#: library/pyexpat.rst:122 msgid ":class:`xmlparser` objects have the following methods:" msgstr "" # 8a46b2e397724da5b48f38577c7f6bd4 -#: ../src/Doc/library/pyexpat.rst:127 +#: library/pyexpat.rst:127 msgid "" "Parses the contents of the string *data*, calling the appropriate handler " "functions to process the parsed data. *isfinal* must be true on the final " @@ -79966,14 +81701,14 @@ msgid "" "time." msgstr "" -#: ../src/Doc/library/pyexpat.rst:136 +#: library/pyexpat.rst:136 msgid "" "Parse XML data reading from the object *file*. *file* only needs to provide " "the ``read(nbytes)`` method, returning the empty string when there's no more " "data." msgstr "" -#: ../src/Doc/library/pyexpat.rst:143 +#: library/pyexpat.rst:143 msgid "" "Sets the base to be used for resolving relative URIs in system identifiers " "in declarations. Resolving relative identifiers is left to the application: " @@ -79982,13 +81717,13 @@ msgid "" "`UnparsedEntityDeclHandler` functions." msgstr "" -#: ../src/Doc/library/pyexpat.rst:152 +#: library/pyexpat.rst:152 msgid "" "Returns a string containing the base set by a previous call to :meth:" "`SetBase`, or ``None`` if :meth:`SetBase` hasn't been called." msgstr "" -#: ../src/Doc/library/pyexpat.rst:158 +#: library/pyexpat.rst:158 msgid "" "Returns the input data that generated the current event as a string. The " "data is in the encoding of the entity which contains the text. When called " @@ -79996,7 +81731,7 @@ msgid "" msgstr "" # 73ab13870f184f5891aba6afff4daaa2 -#: ../src/Doc/library/pyexpat.rst:167 +#: library/pyexpat.rst:167 msgid "" "Create a \"child\" parser which can be used to parse an external parsed " "entity referred to by content parsed by the parent parser. The *context* " @@ -80008,7 +81743,7 @@ msgid "" msgstr "" # b1b03b56c0ae4e6784e28321155a7ebb -#: ../src/Doc/library/pyexpat.rst:176 +#: library/pyexpat.rst:176 msgid "" "Control parsing of parameter entities (including the external DTD subset). " "Possible *flag* values are :const:`XML_PARAM_ENTITY_PARSING_NEVER`, :const:" @@ -80017,7 +81752,7 @@ msgid "" "successful." msgstr "" -#: ../src/Doc/library/pyexpat.rst:184 +#: library/pyexpat.rst:184 msgid "" "Calling this with a true value for *flag* (the default) will cause Expat to " "call the :attr:`ExternalEntityRefHandler` with :const:`None` for all " @@ -80027,13 +81762,13 @@ msgid "" "`EndDoctypeDeclHandler` will not be called." msgstr "" -#: ../src/Doc/library/pyexpat.rst:191 +#: library/pyexpat.rst:191 msgid "" "Passing a false value for *flag* will cancel a previous call that passed a " "true value, but otherwise has no effect." msgstr "" -#: ../src/Doc/library/pyexpat.rst:194 +#: library/pyexpat.rst:194 msgid "" "This method can only be called before the :meth:`Parse` or :meth:`ParseFile` " "methods are called; calling it after either of those have been called " @@ -80041,18 +81776,22 @@ msgid "" "to :const:`errors.XML_ERROR_CANT_CHANGE_FEATURE_ONCE_PARSING`." msgstr "" -#: ../src/Doc/library/pyexpat.rst:201 +#: library/pyexpat.rst:201 msgid ":class:`xmlparser` objects have the following attributes:" msgstr "" -#: ../src/Doc/library/pyexpat.rst:206 +#: library/pyexpat.rst:206 msgid "" "The size of the buffer used when :attr:`buffer_text` is true. A new buffer " "size can be set by assigning a new integer value to this attribute. When the " "size is changed, the buffer will be flushed." msgstr "" -#: ../src/Doc/library/pyexpat.rst:218 +#: library/pyexpat.rst:213 +msgid "The buffer size can now be changed." +msgstr "" + +#: library/pyexpat.rst:218 msgid "" "Setting this to true causes the :class:`xmlparser` object to buffer textual " "content returned by Expat to avoid multiple calls to the :meth:" @@ -80062,14 +81801,14 @@ msgid "" "changed at any time." msgstr "" -#: ../src/Doc/library/pyexpat.rst:230 +#: library/pyexpat.rst:230 msgid "" "If :attr:`buffer_text` is enabled, the number of bytes stored in the buffer. " "These bytes represent UTF-8 encoded text. This attribute has no meaningful " "interpretation when :attr:`buffer_text` is false." msgstr "" -#: ../src/Doc/library/pyexpat.rst:239 +#: library/pyexpat.rst:239 msgid "" "Setting this attribute to a non-zero integer causes the attributes to be " "reported as a list rather than a dictionary. The attributes are presented " @@ -80080,7 +81819,7 @@ msgid "" msgstr "" # 43de5dc7a47148159312b7988ee29a61 -#: ../src/Doc/library/pyexpat.rst:251 +#: library/pyexpat.rst:251 msgid "" "If this attribute is set to a non-zero integer, the handler functions will " "be passed Unicode strings. If :attr:`returns_unicode` is :const:`False`, 8-" @@ -80088,7 +81827,11 @@ msgid "" "This is :const:`True` by default when Python is built with Unicode support." msgstr "" -#: ../src/Doc/library/pyexpat.rst:262 +#: library/pyexpat.rst:256 +msgid "Can be changed at any time to affect the result type." +msgstr "" + +#: library/pyexpat.rst:262 msgid "" "If set to a non-zero integer, the parser will report only those attributes " "which were specified in the document instance and not those which were " @@ -80099,7 +81842,7 @@ msgid "" "time." msgstr "" -#: ../src/Doc/library/pyexpat.rst:271 +#: library/pyexpat.rst:271 msgid "" "The following attributes contain values relating to the most recent error " "encountered by an :class:`xmlparser` object, and will only have correct " @@ -80107,26 +81850,26 @@ msgid "" "`xml.parsers.expat.ExpatError` exception." msgstr "" -#: ../src/Doc/library/pyexpat.rst:279 +#: library/pyexpat.rst:279 msgid "Byte index at which an error occurred." msgstr "" -#: ../src/Doc/library/pyexpat.rst:284 +#: library/pyexpat.rst:284 msgid "" "Numeric code specifying the problem. This value can be passed to the :func:" "`ErrorString` function, or compared to one of the constants defined in the " "``errors`` object." msgstr "" -#: ../src/Doc/library/pyexpat.rst:291 +#: library/pyexpat.rst:291 msgid "Column number at which an error occurred." msgstr "" -#: ../src/Doc/library/pyexpat.rst:296 +#: library/pyexpat.rst:296 msgid "Line number at which an error occurred." msgstr "" -#: ../src/Doc/library/pyexpat.rst:298 +#: library/pyexpat.rst:298 msgid "" "The following attributes contain values relating to the current parse " "location in an :class:`xmlparser` object. During a callback reporting a " @@ -80136,19 +81879,19 @@ msgid "" "whether there was an associated callback)." msgstr "" -#: ../src/Doc/library/pyexpat.rst:310 +#: library/pyexpat.rst:310 msgid "Current byte index in the parser input." msgstr "" -#: ../src/Doc/library/pyexpat.rst:315 +#: library/pyexpat.rst:315 msgid "Current column number in the parser input." msgstr "" -#: ../src/Doc/library/pyexpat.rst:320 +#: library/pyexpat.rst:320 msgid "Current line number in the parser input." msgstr "" -#: ../src/Doc/library/pyexpat.rst:322 +#: library/pyexpat.rst:322 msgid "" "Here is the list of handlers that can be set. To set a handler on an :class:" "`xmlparser` object *o*, use ``o.handlername = func``. *handlername* must be " @@ -80158,7 +81901,7 @@ msgid "" msgstr "" # 9faced92a67646a08315a0557e0ddc2a -#: ../src/Doc/library/pyexpat.rst:331 +#: library/pyexpat.rst:331 msgid "" "Called when the XML declaration is parsed. The XML declaration is the " "(optional) declaration of the applicable version of the XML recommendation, " @@ -80170,7 +81913,7 @@ msgid "" "available with Expat version 1.95.0 or newer." msgstr "" -#: ../src/Doc/library/pyexpat.rst:345 +#: library/pyexpat.rst:345 msgid "" "Called when Expat begins parsing the document type declaration (``'``." msgstr "" -#: ../src/Doc/library/pyexpat.rst:459 +#: library/pyexpat.rst:459 msgid "" "Called at the start of a CDATA section. This and :attr:" "`EndCdataSectionHandler` are needed to be able to identify the syntactical " "start and end for CDATA sections." msgstr "" -#: ../src/Doc/library/pyexpat.rst:466 +#: library/pyexpat.rst:466 msgid "Called at the end of a CDATA section." msgstr "" -#: ../src/Doc/library/pyexpat.rst:471 +#: library/pyexpat.rst:471 msgid "" "Called for any characters in the XML document for which no applicable " "handler has been specified. This means characters that are part of a " @@ -80301,7 +82044,7 @@ msgid "" "supplied." msgstr "" -#: ../src/Doc/library/pyexpat.rst:478 +#: library/pyexpat.rst:478 msgid "" "This is the same as the :func:`DefaultHandler`, but doesn't inhibit " "expansion of internal entities. The entity reference will not be passed to " @@ -80309,7 +82052,7 @@ msgid "" msgstr "" # a054f7d195e84e149c50413ee0a4d5d5 -#: ../src/Doc/library/pyexpat.rst:485 +#: library/pyexpat.rst:485 msgid "" "Called if the XML document hasn't been declared as being a standalone " "document. This happens when there is an external subset or a reference to a " @@ -80319,7 +82062,7 @@ msgid "" "set, no exception is raised by the parser for this condition." msgstr "" -#: ../src/Doc/library/pyexpat.rst:495 +#: library/pyexpat.rst:495 msgid "" "Called for references to external entities. *base* is the current base, as " "set by a previous call to :meth:`SetBase`. The public and system " @@ -80329,7 +82072,7 @@ msgid "" msgstr "" # 4bc4fe8142d6442d805a6778da9b677e -#: ../src/Doc/library/pyexpat.rst:501 +#: library/pyexpat.rst:501 msgid "" "For external entities to be parsed, this handler must be implemented. It is " "responsible for creating the sub-parser using " @@ -80339,118 +82082,118 @@ msgid "" "`XML_ERROR_EXTERNAL_ENTITY_HANDLING` error, otherwise parsing will continue." msgstr "" -#: ../src/Doc/library/pyexpat.rst:509 +#: library/pyexpat.rst:509 msgid "" "If this handler is not provided, external entities are reported by the :attr:" "`DefaultHandler` callback, if provided." msgstr "" -#: ../src/Doc/library/pyexpat.rst:516 +#: library/pyexpat.rst:516 msgid "ExpatError Exceptions" msgstr "" -#: ../src/Doc/library/pyexpat.rst:521 +#: library/pyexpat.rst:521 msgid ":exc:`ExpatError` exceptions have a number of interesting attributes:" msgstr "" -#: ../src/Doc/library/pyexpat.rst:526 +#: library/pyexpat.rst:526 msgid "" "Expat's internal error number for the specific error. This will match one " "of the constants defined in the ``errors`` object from this module." msgstr "" -#: ../src/Doc/library/pyexpat.rst:534 +#: library/pyexpat.rst:534 msgid "" "Line number on which the error was detected. The first line is numbered " "``1``." msgstr "" -#: ../src/Doc/library/pyexpat.rst:541 +#: library/pyexpat.rst:541 msgid "" "Character offset into the line where the error occurred. The first column " "is numbered ``0``." msgstr "" -#: ../src/Doc/library/pyexpat.rst:552 +#: library/pyexpat.rst:552 msgid "" "The following program defines three handlers that just print out their " "arguments. ::" msgstr "" -#: ../src/Doc/library/pyexpat.rst:576 +#: library/pyexpat.rst:576 msgid "The output from this program is::" msgstr "" -#: ../src/Doc/library/pyexpat.rst:593 +#: library/pyexpat.rst:593 msgid "Content Model Descriptions" msgstr "" -#: ../src/Doc/library/pyexpat.rst:598 +#: library/pyexpat.rst:598 msgid "" "Content modules are described using nested tuples. Each tuple contains four " "values: the type, the quantifier, the name, and a tuple of children. " "Children are simply additional content module descriptions." msgstr "" -#: ../src/Doc/library/pyexpat.rst:602 +#: library/pyexpat.rst:602 msgid "" "The values of the first two fields are constants defined in the ``model`` " "object of the :mod:`xml.parsers.expat` module. These constants can be " "collected in two groups: the model type group and the quantifier group." msgstr "" -#: ../src/Doc/library/pyexpat.rst:606 +#: library/pyexpat.rst:606 msgid "The constants in the model type group are:" msgstr "" -#: ../src/Doc/library/pyexpat.rst:612 +#: library/pyexpat.rst:612 msgid "" "The element named by the model name was declared to have a content model of " "``ANY``." msgstr "" -#: ../src/Doc/library/pyexpat.rst:619 +#: library/pyexpat.rst:619 msgid "" "The named element allows a choice from a number of options; this is used for " "content models such as ``(A | B | C)``." msgstr "" -#: ../src/Doc/library/pyexpat.rst:626 +#: library/pyexpat.rst:626 msgid "Elements which are declared to be ``EMPTY`` have this model type." msgstr "" -#: ../src/Doc/library/pyexpat.rst:640 +#: library/pyexpat.rst:640 msgid "" "Models which represent a series of models which follow one after the other " "are indicated with this model type. This is used for models such as ``(A, " "B, C)``." msgstr "" -#: ../src/Doc/library/pyexpat.rst:643 +#: library/pyexpat.rst:643 msgid "The constants in the quantifier group are:" msgstr "" -#: ../src/Doc/library/pyexpat.rst:649 +#: library/pyexpat.rst:649 msgid "No modifier is given, so it can appear exactly once, as for ``A``." msgstr "" -#: ../src/Doc/library/pyexpat.rst:655 +#: library/pyexpat.rst:655 msgid "The model is optional: it can appear once or not at all, as for ``A?``." msgstr "" -#: ../src/Doc/library/pyexpat.rst:661 +#: library/pyexpat.rst:661 msgid "The model must occur one or more times (like ``A+``)." msgstr "" -#: ../src/Doc/library/pyexpat.rst:667 +#: library/pyexpat.rst:667 msgid "The model must occur zero or more times, as for ``A*``." msgstr "" -#: ../src/Doc/library/pyexpat.rst:673 +#: library/pyexpat.rst:673 msgid "Expat error constants" msgstr "" -#: ../src/Doc/library/pyexpat.rst:675 +#: library/pyexpat.rst:675 msgid "" "The following constants are provided in the ``errors`` object of the :mod:" "`xml.parsers.expat` module. These constants are useful in interpreting some " @@ -80458,162 +82201,162 @@ msgid "" "error has occurred." msgstr "" -#: ../src/Doc/library/pyexpat.rst:680 +#: library/pyexpat.rst:680 msgid "The ``errors`` object has the following attributes:" msgstr "" -#: ../src/Doc/library/pyexpat.rst:690 +#: library/pyexpat.rst:690 msgid "" "An entity reference in an attribute value referred to an external entity " "instead of an internal entity." msgstr "" -#: ../src/Doc/library/pyexpat.rst:697 +#: library/pyexpat.rst:697 msgid "" "A character reference referred to a character which is illegal in XML (for " "example, character ``0``, or '``�``')." msgstr "" -#: ../src/Doc/library/pyexpat.rst:704 +#: library/pyexpat.rst:704 msgid "" "An entity reference referred to an entity which was declared with a " "notation, so cannot be parsed." msgstr "" -#: ../src/Doc/library/pyexpat.rst:711 +#: library/pyexpat.rst:711 msgid "An attribute was used more than once in a start tag." msgstr "" -#: ../src/Doc/library/pyexpat.rst:721 +#: library/pyexpat.rst:721 msgid "" "Raised when an input byte could not properly be assigned to a character; for " "example, a NUL byte (value ``0``) in a UTF-8 input stream." msgstr "" -#: ../src/Doc/library/pyexpat.rst:728 +#: library/pyexpat.rst:728 msgid "Something other than whitespace occurred after the document element." msgstr "" -#: ../src/Doc/library/pyexpat.rst:734 +#: library/pyexpat.rst:734 msgid "" "An XML declaration was found somewhere other than the start of the input " "data." msgstr "" -#: ../src/Doc/library/pyexpat.rst:740 +#: library/pyexpat.rst:740 msgid "" "The document contains no elements (XML requires all documents to contain " "exactly one top-level element).." msgstr "" -#: ../src/Doc/library/pyexpat.rst:747 +#: library/pyexpat.rst:747 msgid "Expat was not able to allocate memory internally." msgstr "" -#: ../src/Doc/library/pyexpat.rst:753 +#: library/pyexpat.rst:753 msgid "A parameter entity reference was found where it was not allowed." msgstr "" -#: ../src/Doc/library/pyexpat.rst:759 +#: library/pyexpat.rst:759 msgid "An incomplete character was found in the input." msgstr "" -#: ../src/Doc/library/pyexpat.rst:765 +#: library/pyexpat.rst:765 msgid "" "An entity reference contained another reference to the same entity; possibly " "via a different name, and possibly indirectly." msgstr "" -#: ../src/Doc/library/pyexpat.rst:772 +#: library/pyexpat.rst:772 msgid "Some unspecified syntax error was encountered." msgstr "" -#: ../src/Doc/library/pyexpat.rst:778 +#: library/pyexpat.rst:778 msgid "An end tag did not match the innermost open start tag." msgstr "" -#: ../src/Doc/library/pyexpat.rst:784 +#: library/pyexpat.rst:784 msgid "" "Some token (such as a start tag) was not closed before the end of the stream " "or the next token was encountered." msgstr "" -#: ../src/Doc/library/pyexpat.rst:791 +#: library/pyexpat.rst:791 msgid "A reference was made to a entity which was not defined." msgstr "" -#: ../src/Doc/library/pyexpat.rst:797 +#: library/pyexpat.rst:797 msgid "The document encoding is not supported by Expat." msgstr "" -#: ../src/Doc/library/pyexpat.rst:803 +#: library/pyexpat.rst:803 msgid "A CDATA marked section was not closed." msgstr "" -#: ../src/Doc/library/pyexpat.rst:813 +#: library/pyexpat.rst:813 msgid "" "The parser determined that the document was not \"standalone\" though it " "declared itself to be in the XML declaration, and the :attr:" "`NotStandaloneHandler` was set and returned ``0``." msgstr "" -#: ../src/Doc/library/pyexpat.rst:829 +#: library/pyexpat.rst:829 msgid "" "An operation was requested that requires DTD support to be compiled in, but " "Expat was configured without DTD support. This should never be reported by " "a standard build of the :mod:`xml.parsers.expat` module." msgstr "" -#: ../src/Doc/library/pyexpat.rst:837 +#: library/pyexpat.rst:837 msgid "" "A behavioral change was requested after parsing started that can only be " "changed before parsing has started. This is (currently) only raised by :" "meth:`UseForeignDTD`." msgstr "" -#: ../src/Doc/library/pyexpat.rst:845 +#: library/pyexpat.rst:845 msgid "An undeclared prefix was found when namespace processing was enabled." msgstr "" -#: ../src/Doc/library/pyexpat.rst:851 +#: library/pyexpat.rst:851 msgid "" "The document attempted to remove the namespace declaration associated with a " "prefix." msgstr "" -#: ../src/Doc/library/pyexpat.rst:858 +#: library/pyexpat.rst:858 msgid "A parameter entity contained incomplete markup." msgstr "" -#: ../src/Doc/library/pyexpat.rst:864 +#: library/pyexpat.rst:864 msgid "The document contained no document element at all." msgstr "" -#: ../src/Doc/library/pyexpat.rst:870 +#: library/pyexpat.rst:870 msgid "There was an error parsing a text declaration in an external entity." msgstr "" -#: ../src/Doc/library/pyexpat.rst:876 +#: library/pyexpat.rst:876 msgid "Characters were found in the public id that are not allowed." msgstr "" -#: ../src/Doc/library/pyexpat.rst:882 +#: library/pyexpat.rst:882 msgid "" "The requested operation was made on a suspended parser, but isn't allowed. " "This includes attempts to provide additional input or to stop the parser." msgstr "" -#: ../src/Doc/library/pyexpat.rst:889 +#: library/pyexpat.rst:889 msgid "" "An attempt to resume the parser was made when the parser had not been " "suspended." msgstr "" -#: ../src/Doc/library/pyexpat.rst:895 +#: library/pyexpat.rst:895 msgid "This should not be reported to Python applications." msgstr "" -#: ../src/Doc/library/pyexpat.rst:901 +#: library/pyexpat.rst:901 msgid "" "The requested operation was made on a parser which was finished parsing " "input, but isn't allowed. This includes attempts to provide additional " @@ -80622,8 +82365,7 @@ msgstr "" # 85fc42d2b2e34b399c075a50cf36889d # 15da1862485b432293c2dee32846039f -#: ../src/Doc/library/pyexpat.rst:912 -#: ../src/Doc/library/xml.dom.minidom.rst:276 +#: library/pyexpat.rst:912 library/xml.dom.minidom.rst:276 msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See http://" @@ -80631,11 +82373,11 @@ msgid "" "org/assignments/character-sets/character-sets.xhtml." msgstr "" -#: ../src/Doc/library/python.rst:6 +#: library/python.rst:6 msgid "Python Runtime Services" msgstr "" -#: ../src/Doc/library/python.rst:8 +#: library/python.rst:8 msgid "" "The modules described in this chapter provide a wide range of services " "related to the Python interpreter and its interaction with its environment. " @@ -80643,12 +82385,12 @@ msgid "" msgstr "" # 9dda83ec9cc9454f81cac07122375418 -#: ../src/Doc/library/queue.rst:2 +#: library/queue.rst:2 msgid ":mod:`Queue` --- A synchronized queue class" msgstr "" # df8a886d200d4db49d9a3fe60f79b01d -#: ../src/Doc/library/queue.rst:8 +#: library/queue.rst:8 msgid "" "The :mod:`Queue` module has been renamed to :mod:`queue` in Python 3. The :" "term:`2to3` tool will automatically adapt imports when converting your " @@ -80656,12 +82398,12 @@ msgid "" msgstr "" # 459dcf013e4242d68b0799184deb5186 -#: ../src/Doc/library/queue.rst:12 +#: library/queue.rst:12 msgid "**Source code:** :source:`Lib/Queue.py`" msgstr "" # 65bd378ecadf40cb9af63f82d4c63662 -#: ../src/Doc/library/queue.rst:16 +#: library/queue.rst:16 msgid "" "The :mod:`Queue` module implements multi-producer, multi-consumer queues. It " "is especially useful in threaded programming when information must be " @@ -80671,7 +82413,7 @@ msgid "" msgstr "" # ab92ff59e21b4495a2bd850451b90021 -#: ../src/Doc/library/queue.rst:23 +#: library/queue.rst:23 msgid "" "The module implements three types of queue, which differ only in the order " "in which the entries are retrieved. In a FIFO queue, the first tasks added " @@ -80682,11 +82424,11 @@ msgid "" msgstr "" # 5874c7df954e446991e2dafac7218afb -#: ../src/Doc/library/queue.rst:30 +#: library/queue.rst:30 msgid "The :mod:`Queue` module defines the following classes and exceptions:" msgstr "" -#: ../src/Doc/library/queue.rst:34 +#: library/queue.rst:34 msgid "" "Constructor for a FIFO queue. *maxsize* is an integer that sets the " "upperbound limit on the number of items that can be placed in the queue. " @@ -80695,7 +82437,7 @@ msgid "" "infinite." msgstr "" -#: ../src/Doc/library/queue.rst:41 +#: library/queue.rst:41 msgid "" "Constructor for a LIFO queue. *maxsize* is an integer that sets the " "upperbound limit on the number of items that can be placed in the queue. " @@ -80704,7 +82446,7 @@ msgid "" "infinite." msgstr "" -#: ../src/Doc/library/queue.rst:50 +#: library/queue.rst:50 msgid "" "Constructor for a priority queue. *maxsize* is an integer that sets the " "upperbound limit on the number of items that can be placed in the queue. " @@ -80713,7 +82455,7 @@ msgid "" "infinite." msgstr "" -#: ../src/Doc/library/queue.rst:55 +#: library/queue.rst:55 msgid "" "The lowest valued entries are retrieved first (the lowest valued entry is " "the one returned by ``sorted(list(entries))[0]``). A typical pattern for " @@ -80721,44 +82463,44 @@ msgid "" msgstr "" # c3fd29788e58429a95f986364b72c866 -#: ../src/Doc/library/queue.rst:63 +#: library/queue.rst:63 msgid "" "Exception raised when non-blocking :meth:`~Queue.get` (or :meth:`~Queue." "get_nowait`) is called on a :class:`Queue` object which is empty." msgstr "" # 40ed7c0ff8134d91913eef2961303c44 -#: ../src/Doc/library/queue.rst:70 +#: library/queue.rst:70 msgid "" "Exception raised when non-blocking :meth:`~Queue.put` (or :meth:`~Queue." "put_nowait`) is called on a :class:`Queue` object which is full." msgstr "" -#: ../src/Doc/library/queue.rst:76 +#: library/queue.rst:76 msgid "" ":class:`collections.deque` is an alternative implementation of unbounded " "queues with fast atomic :func:`append` and :func:`popleft` operations that " "do not require locking." msgstr "" -#: ../src/Doc/library/queue.rst:84 +#: library/queue.rst:84 msgid "Queue Objects" msgstr "" -#: ../src/Doc/library/queue.rst:86 +#: library/queue.rst:86 msgid "" "Queue objects (:class:`Queue`, :class:`LifoQueue`, or :class:" "`PriorityQueue`) provide the public methods described below." msgstr "" -#: ../src/Doc/library/queue.rst:92 +#: library/queue.rst:92 msgid "" "Return the approximate size of the queue. Note, qsize() > 0 doesn't " "guarantee that a subsequent get() will not block, nor will qsize() < maxsize " "guarantee that put() will not block." msgstr "" -#: ../src/Doc/library/queue.rst:99 +#: library/queue.rst:99 msgid "" "Return ``True`` if the queue is empty, ``False`` otherwise. If empty() " "returns ``True`` it doesn't guarantee that a subsequent call to put() will " @@ -80766,7 +82508,7 @@ msgid "" "that a subsequent call to get() will not block." msgstr "" -#: ../src/Doc/library/queue.rst:107 +#: library/queue.rst:107 msgid "" "Return ``True`` if the queue is full, ``False`` otherwise. If full() " "returns ``True`` it doesn't guarantee that a subsequent call to get() will " @@ -80774,7 +82516,7 @@ msgid "" "a subsequent call to put() will not block." msgstr "" -#: ../src/Doc/library/queue.rst:115 +#: library/queue.rst:115 msgid "" "Put *item* into the queue. If optional args *block* is true and *timeout* is " "None (the default), block if necessary until a free slot is available. If " @@ -80785,11 +82527,15 @@ msgid "" "ignored in that case)." msgstr "" -#: ../src/Doc/library/queue.rst:129 +#: library/queue.rst:123 library/queue.rst:141 +msgid "The *timeout* parameter." +msgstr "" + +#: library/queue.rst:129 msgid "Equivalent to ``put(item, False)``." msgstr "" -#: ../src/Doc/library/queue.rst:134 +#: library/queue.rst:134 msgid "" "Remove and return an item from the queue. If optional args *block* is true " "and *timeout* is None (the default), block if necessary until an item is " @@ -80800,31 +82546,31 @@ msgid "" "ignored in that case)." msgstr "" -#: ../src/Doc/library/queue.rst:149 +#: library/queue.rst:149 msgid "" "Two methods are offered to support tracking whether enqueued tasks have been " "fully processed by daemon consumer threads." msgstr "" -#: ../src/Doc/library/queue.rst:155 +#: library/queue.rst:155 msgid "" "Indicate that a formerly enqueued task is complete. Used by queue consumer " "threads. For each :meth:`get` used to fetch a task, a subsequent call to :" "meth:`task_done` tells the queue that the processing on the task is complete." msgstr "" -#: ../src/Doc/library/queue.rst:159 +#: library/queue.rst:159 msgid "" "If a :meth:`join` is currently blocking, it will resume when all items have " "been processed (meaning that a :meth:`task_done` call was received for every " "item that had been :meth:`put` into the queue)." msgstr "" -#: ../src/Doc/library/queue.rst:171 +#: library/queue.rst:171 msgid "Blocks until all items in the queue have been gotten and processed." msgstr "" -#: ../src/Doc/library/queue.rst:173 +#: library/queue.rst:173 msgid "" "The count of unfinished tasks goes up whenever an item is added to the " "queue. The count goes down whenever a consumer thread calls :meth:" @@ -80833,20 +82579,20 @@ msgid "" "unblocks." msgstr "" -#: ../src/Doc/library/queue.rst:180 +#: library/queue.rst:180 msgid "Example of how to wait for enqueued tasks to be completed::" msgstr "" -#: ../src/Doc/library/quopri.rst:2 +#: library/quopri.rst:2 msgid ":mod:`quopri` --- Encode and decode MIME quoted-printable data" msgstr "" # 755c284755b1405bb6c93308c4719bac -#: ../src/Doc/library/quopri.rst:12 +#: library/quopri.rst:12 msgid "**Source code:** :source:`Lib/quopri.py`" msgstr "" -#: ../src/Doc/library/quopri.rst:16 +#: library/quopri.rst:16 msgid "" "This module performs quoted-printable transport encoding and decoding, as " "defined in :rfc:`1521`: \"MIME (Multipurpose Internet Mail Extensions) Part " @@ -80857,7 +82603,7 @@ msgid "" "characters, as when sending a graphics file." msgstr "" -#: ../src/Doc/library/quopri.rst:26 +#: library/quopri.rst:26 msgid "" "Decode the contents of the *input* file and write the resulting decoded " "binary data to the *output* file. *input* and *output* must either be file " @@ -80870,7 +82616,7 @@ msgid "" msgstr "" # 7d29e471d326419ba5f41dd280ae6045 -#: ../src/Doc/library/quopri.rst:37 +#: library/quopri.rst:37 msgid "" "Encode the contents of the *input* file and write the resulting quoted-" "printable data to the *output* file. *input* and *output* must either be " @@ -80882,64 +82628,64 @@ msgid "" "as per :rfc:`1521`." msgstr "" -#: ../src/Doc/library/quopri.rst:48 +#: library/quopri.rst:48 msgid "" "Like :func:`decode`, except that it accepts a source string and returns the " "corresponding decoded string." msgstr "" # 6cb534e71c9840e38d82ea96ebb71f3c -#: ../src/Doc/library/quopri.rst:54 +#: library/quopri.rst:54 msgid "" "Like :func:`encode`, except that it accepts a source string and returns the " "corresponding encoded string. *quotetabs* is optional (defaulting to 0), " "and is passed straight through to :func:`encode`." msgstr "" -# ee67682a9bc34e6b88bec60d9d6c709e -#: ../src/Doc/library/quopri.rst:61 -msgid "Module :mod:`mimify`" -msgstr "" +#: library/quopri.rst:62 +#, fuzzy +msgid "Module mimify" +msgstr "Modules" # 72470a77f6aa47b781c6bb0d4330cdc7 -#: ../src/Doc/library/quopri.rst:62 +#: library/quopri.rst:62 msgid "General utilities for processing of MIME messages." msgstr "" -#: ../src/Doc/library/quopri.rst:65 +#: library/quopri.rst:65 msgid "Encode and decode MIME base64 data" msgstr "" -#: ../src/Doc/library/random.rst:2 +#: library/random.rst:2 msgid ":mod:`random` --- Generate pseudo-random numbers" msgstr "" # 773f2dc440fb4386b3b44df76ee48f1c -#: ../src/Doc/library/random.rst:7 +#: library/random.rst:7 msgid "**Source code:** :source:`Lib/random.py`" msgstr "" -#: ../src/Doc/library/random.rst:11 +#: library/random.rst:11 msgid "" "This module implements pseudo-random number generators for various " "distributions." msgstr "" -#: ../src/Doc/library/random.rst:14 +#: library/random.rst:14 msgid "" "For integers, uniform selection from a range. For sequences, uniform " "selection of a random element, a function to generate a random permutation " "of a list in-place, and a function for random sampling without replacement." msgstr "" -#: ../src/Doc/library/random.rst:18 +#: library/random.rst:18 msgid "" "On the real line, there are functions to compute uniform, normal (Gaussian), " "lognormal, negative exponential, gamma, and beta distributions. For " "generating distributions of angles, the von Mises distribution is available." msgstr "" -#: ../src/Doc/library/random.rst:22 +#: library/random.rst:22 msgid "" "Almost all module functions depend on the basic function :func:`random`, " "which generates a random float uniformly in the semi-open range [0.0, 1.0). " @@ -80952,7 +82698,7 @@ msgid "" msgstr "" # 8056498f28d9495c98995fc5d08081ca -#: ../src/Doc/library/random.rst:31 +#: library/random.rst:31 msgid "" "The functions supplied by this module are actually bound methods of a hidden " "instance of the :class:`random.Random` class. You can instantiate your own " @@ -80964,7 +82710,7 @@ msgid "" msgstr "" # 9a0c87a635ee4a8e8357223cd1e94311 -#: ../src/Doc/library/random.rst:38 +#: library/random.rst:38 msgid "" "Class :class:`Random` can also be subclassed if you want to use a different " "basic generator of your own devising: in that case, override the :meth:" @@ -80974,7 +82720,11 @@ msgid "" "over an arbitrarily large range." msgstr "" -#: ../src/Doc/library/random.rst:47 +#: library/random.rst:44 +msgid "the :meth:`getrandbits` method." +msgstr "" + +#: library/random.rst:47 msgid "" "As an example of subclassing, the :mod:`random` module provides the :class:" "`WichmannHill` class that implements an alternative generator in pure " @@ -80986,7 +82736,11 @@ msgid "" "the references below for a recent variant that repairs these flaws." msgstr "" -#: ../src/Doc/library/random.rst:59 +#: library/random.rst:56 +msgid "MersenneTwister replaced Wichmann-Hill as the default generator." +msgstr "" + +#: library/random.rst:59 msgid "" "The :mod:`random` module also provides the :class:`SystemRandom` class which " "uses the system function :func:`os.urandom` to generate random numbers from " @@ -80994,18 +82748,18 @@ msgid "" msgstr "" # eda79818b2c84d8a97371bd3d6561314 -#: ../src/Doc/library/random.rst:65 +#: library/random.rst:65 msgid "" "The pseudo-random generators of this module should not be used for security " "purposes. Use :func:`os.urandom` or :class:`SystemRandom` if you require a " "cryptographically secure pseudo-random number generator." msgstr "" -#: ../src/Doc/library/random.rst:70 +#: library/random.rst:70 msgid "Bookkeeping functions:" msgstr "" -#: ../src/Doc/library/random.rst:75 +#: library/random.rst:75 msgid "" "Initialize the basic random number generator. Optional argument *x* can be " "any :term:`hashable` object. If *x* is omitted or ``None``, current system " @@ -81015,14 +82769,23 @@ msgid "" "func:`os.urandom` function for details on availability)." msgstr "" -#: ../src/Doc/library/random.rst:87 +#: library/random.rst:82 +msgid "formerly, operating system resources were not used." +msgstr "" + +#: library/random.rst:87 msgid "" "Return an object capturing the current internal state of the generator. " "This object can be passed to :func:`setstate` to restore the state." msgstr "" +#: library/random.rst:92 +msgid "" +"State values produced in Python 2.6 cannot be loaded into earlier versions." +msgstr "" + # d69ab2a8d3e44d3188846fc0282d32fa -#: ../src/Doc/library/random.rst:98 +#: library/random.rst:98 msgid "" "*state* should have been obtained from a previous call to :func:`getstate`, " "and :func:`setstate` restores the internal state of the generator to what it " @@ -81030,7 +82793,7 @@ msgid "" msgstr "" # ed4cf8c4125149379a727fb5eb154710 -#: ../src/Doc/library/random.rst:107 +#: library/random.rst:107 msgid "" "Change the internal state to one different from and likely far away from the " "current state. *n* is a non-negative integer which is used to scramble the " @@ -81041,8 +82804,14 @@ msgid "" "instances' states far apart." msgstr "" +#: library/random.rst:117 +msgid "" +"Instead of jumping to a specific state, *n* steps ahead, ``jumpahead(n)`` " +"jumps to another state likely to be separated by many steps." +msgstr "" + # 42efe002d32d4bd492eeff376493133f -#: ../src/Doc/library/random.rst:124 +#: library/random.rst:124 msgid "" "Returns a python :class:`long` int with *k* random bits. This method is " "supplied with the MersenneTwister generator and some other generators may " @@ -81050,11 +82819,11 @@ msgid "" "`getrandbits` enables :meth:`randrange` to handle arbitrarily large ranges." msgstr "" -#: ../src/Doc/library/random.rst:131 +#: library/random.rst:131 msgid "Functions for integers:" msgstr "" -#: ../src/Doc/library/random.rst:137 +#: library/random.rst:137 msgid "" "Return a randomly selected element from ``range(start, stop, step)``. This " "is equivalent to ``choice(range(start, stop, step))``, but doesn't actually " @@ -81062,28 +82831,28 @@ msgid "" msgstr "" # 942ca03e36ac4d5690c28e9c61980b7d -#: ../src/Doc/library/random.rst:146 +#: library/random.rst:146 msgid "Return a random integer *N* such that ``a <= N <= b``." msgstr "" -#: ../src/Doc/library/random.rst:148 +#: library/random.rst:148 msgid "Functions for sequences:" msgstr "" -#: ../src/Doc/library/random.rst:153 +#: library/random.rst:153 msgid "" "Return a random element from the non-empty sequence *seq*. If *seq* is " "empty, raises :exc:`IndexError`." msgstr "" -#: ../src/Doc/library/random.rst:159 +#: library/random.rst:159 msgid "" "Shuffle the sequence *x* in place. The optional argument *random* is a 0-" "argument function returning a random float in [0.0, 1.0); by default, this " "is the function :func:`random`." msgstr "" -#: ../src/Doc/library/random.rst:163 +#: library/random.rst:163 msgid "" "Note that for even rather small ``len(x)``, the total number of permutations " "of *x* is larger than the period of most random number generators; this " @@ -81091,13 +82860,13 @@ msgid "" msgstr "" # 4b8a5d1307a64ae8933a6c43b3ef9d66 -#: ../src/Doc/library/random.rst:170 +#: library/random.rst:170 msgid "" "Return a *k* length list of unique elements chosen from the population " "sequence. Used for random sampling without replacement." msgstr "" -#: ../src/Doc/library/random.rst:175 +#: library/random.rst:175 msgid "" "Returns a new list containing elements from the population while leaving the " "original population unchanged. The resulting list is in selection order so " @@ -81106,7 +82875,7 @@ msgid "" "winners (the subslices)." msgstr "" -#: ../src/Doc/library/random.rst:181 +#: library/random.rst:181 msgid "" "Members of the population need not be :term:`hashable` or unique. If the " "population contains repeats, then each occurrence is a possible selection in " @@ -81114,14 +82883,14 @@ msgid "" msgstr "" # 29e0f680f46e4bb2a667c815aa14eece -#: ../src/Doc/library/random.rst:184 +#: library/random.rst:184 msgid "" "To choose a sample from a range of integers, use an :func:`xrange` object as " "an argument. This is especially fast and space efficient for sampling from " "a large population: ``sample(xrange(10000000), 60)``." msgstr "" -#: ../src/Doc/library/random.rst:188 +#: library/random.rst:188 msgid "" "The following functions generate specific real-valued distributions. " "Function parameters are named after the corresponding variables in the " @@ -81129,23 +82898,23 @@ msgid "" "these equations can be found in any statistics text." msgstr "" -#: ../src/Doc/library/random.rst:196 +#: library/random.rst:196 msgid "Return the next random floating point number in the range [0.0, 1.0)." msgstr "" -#: ../src/Doc/library/random.rst:201 +#: library/random.rst:201 msgid "" "Return a random floating point number *N* such that ``a <= N <= b`` for ``a " "<= b`` and ``b <= N <= a`` for ``b < a``." msgstr "" -#: ../src/Doc/library/random.rst:204 +#: library/random.rst:204 msgid "" "The end-point value ``b`` may or may not be included in the range depending " "on floating-point rounding in the equation ``a + (b-a) * random()``." msgstr "" -#: ../src/Doc/library/random.rst:210 +#: library/random.rst:210 msgid "" "Return a random floating point number *N* such that ``low <= N <= high`` and " "with the specified *mode* between those bounds. The *low* and *high* bounds " @@ -81153,13 +82922,13 @@ msgid "" "between the bounds, giving a symmetric distribution." msgstr "" -#: ../src/Doc/library/random.rst:220 +#: library/random.rst:220 msgid "" "Beta distribution. Conditions on the parameters are ``alpha > 0`` and " "``beta > 0``. Returned values range between 0 and 1." msgstr "" -#: ../src/Doc/library/random.rst:226 +#: library/random.rst:226 msgid "" "Exponential distribution. *lambd* is 1.0 divided by the desired mean. It " "should be nonzero. (The parameter would be called \"lambda\", but that is a " @@ -81168,25 +82937,25 @@ msgid "" "negative." msgstr "" -#: ../src/Doc/library/random.rst:235 +#: library/random.rst:235 msgid "" "Gamma distribution. (*Not* the gamma function!) Conditions on the " "parameters are ``alpha > 0`` and ``beta > 0``." msgstr "" # 80d363d66ed24e3f905cc10a3455c069 -#: ../src/Doc/library/random.rst:238 +#: library/random.rst:238 msgid "The probability distribution function is::" msgstr "" -#: ../src/Doc/library/random.rst:247 +#: library/random.rst:247 msgid "" "Gaussian distribution. *mu* is the mean, and *sigma* is the standard " "deviation. This is slightly faster than the :func:`normalvariate` function " "defined below." msgstr "" -#: ../src/Doc/library/random.rst:254 +#: library/random.rst:254 msgid "" "Log normal distribution. If you take the natural logarithm of this " "distribution, you'll get a normal distribution with mean *mu* and standard " @@ -81194,13 +82963,13 @@ msgid "" "than zero." msgstr "" -#: ../src/Doc/library/random.rst:262 +#: library/random.rst:262 msgid "" "Normal distribution. *mu* is the mean, and *sigma* is the standard " "deviation." msgstr "" -#: ../src/Doc/library/random.rst:267 +#: library/random.rst:267 msgid "" "*mu* is the mean angle, expressed in radians between 0 and 2\\*\\ *pi*, and " "*kappa* is the concentration parameter, which must be greater than or equal " @@ -81208,22 +82977,22 @@ msgid "" "uniform random angle over the range 0 to 2\\*\\ *pi*." msgstr "" -#: ../src/Doc/library/random.rst:275 +#: library/random.rst:275 msgid "Pareto distribution. *alpha* is the shape parameter." msgstr "" -#: ../src/Doc/library/random.rst:280 +#: library/random.rst:280 msgid "" "Weibull distribution. *alpha* is the scale parameter and *beta* is the " "shape parameter." msgstr "" -#: ../src/Doc/library/random.rst:284 +#: library/random.rst:284 msgid "Alternative Generators:" msgstr "" # 4fb3a767654549fb8430bdf40ab7476b -#: ../src/Doc/library/random.rst:288 +#: library/random.rst:288 msgid "" "Class that implements the Wichmann-Hill algorithm as the core generator. Has " "all of the same methods as :class:`Random` plus the :meth:`whseed` method " @@ -81234,7 +83003,7 @@ msgid "" msgstr "" # 3ee8c1b6568547c08044423c2dee2400 -#: ../src/Doc/library/random.rst:298 +#: library/random.rst:298 msgid "" "This is obsolete, supplied for bit-level compatibility with versions of " "Python prior to 2.1. See :func:`seed` for details. :func:`whseed` does not " @@ -81243,7 +83012,7 @@ msgid "" msgstr "" # d14628c1897c42e8b0b16a263bd2ab53 -#: ../src/Doc/library/random.rst:306 +#: library/random.rst:306 msgid "" "Class that uses the :func:`os.urandom` function for generating random " "numbers from sources provided by the operating system. Not available on all " @@ -81253,11 +83022,11 @@ msgid "" "exc:`NotImplementedError` if called." msgstr "" -#: ../src/Doc/library/random.rst:315 +#: library/random.rst:315 msgid "Examples of basic usage::" msgstr "" -#: ../src/Doc/library/random.rst:340 +#: library/random.rst:340 msgid "" "M. Matsumoto and T. Nishimura, \"Mersenne Twister: A 623-dimensionally " "equidistributed uniform pseudorandom number generator\", ACM Transactions on " @@ -81265,32 +83034,32 @@ msgid "" msgstr "" # cb841df622234ea6b235506911164262 -#: ../src/Doc/library/random.rst:344 +#: library/random.rst:344 msgid "" "Wichmann, B. A. & Hill, I. D., \"Algorithm AS 183: An efficient and portable " "pseudo-random number generator\", Applied Statistics 31 (1982) 188-190." msgstr "" -#: ../src/Doc/library/random.rst:347 +#: library/random.rst:347 msgid "" "`Complementary-Multiply-with-Carry recipe `_ for a compatible alternative random number generator with " "a long period and comparatively simple update operations." msgstr "" -#: ../src/Doc/library/re.rst:3 +#: library/re.rst:3 msgid ":mod:`re` --- Regular expression operations" msgstr "" # 615ef58ed727441fb3bb454e9121cf11 -#: ../src/Doc/library/re.rst:11 +#: library/re.rst:11 msgid "" "This module provides regular expression matching operations similar to those " "found in Perl. Both patterns and strings to be searched can be Unicode " "strings as well as 8-bit strings." msgstr "" -#: ../src/Doc/library/re.rst:15 +#: library/re.rst:15 msgid "" "Regular expressions use the backslash character (``'\\'``) to indicate " "special forms or to allow special characters to be used without invoking " @@ -81301,7 +83070,7 @@ msgid "" "must be expressed as ``\\\\`` inside a regular Python string literal." msgstr "" -#: ../src/Doc/library/re.rst:24 +#: library/re.rst:24 msgid "" "The solution is to use Python's raw string notation for regular expression " "patterns; backslashes are not handled in any special way in a string literal " @@ -81311,7 +83080,7 @@ msgid "" "string notation." msgstr "" -#: ../src/Doc/library/re.rst:31 +#: library/re.rst:31 msgid "" "It is important to note that most regular expression operations are " "available as module-level functions and :class:`RegexObject` methods. The " @@ -81319,11 +83088,11 @@ msgid "" "first, but miss some fine-tuning parameters." msgstr "" -#: ../src/Doc/library/re.rst:40 +#: library/re.rst:40 msgid "Regular Expression Syntax" msgstr "" -#: ../src/Doc/library/re.rst:42 +#: library/re.rst:42 msgid "" "A regular expression (or RE) specifies a set of strings that matches it; the " "functions in this module let you check if a particular string matches a " @@ -81331,7 +83100,7 @@ msgid "" "particular string, which comes down to the same thing)." msgstr "" -#: ../src/Doc/library/re.rst:47 +#: library/re.rst:47 msgid "" "Regular expressions can be concatenated to form new regular expressions; if " "*A* and *B* are both regular expressions, then *AB* is also a regular " @@ -81345,14 +83114,14 @@ msgid "" "compiler construction." msgstr "" -#: ../src/Doc/library/re.rst:57 +#: library/re.rst:57 msgid "" "A brief explanation of the format of regular expressions follows. For " "further information and a gentler presentation, consult the :ref:`regex-" "howto`." msgstr "" -#: ../src/Doc/library/re.rst:60 +#: library/re.rst:60 msgid "" "Regular expressions can contain both special and ordinary characters. Most " "ordinary characters, like ``'A'``, ``'a'``, or ``'0'``, are the simplest " @@ -81362,7 +83131,7 @@ msgid "" "without quotes, and strings to be matched ``'in single quotes'``.)" msgstr "" -#: ../src/Doc/library/re.rst:67 +#: library/re.rst:67 msgid "" "Some characters, like ``'|'`` or ``'('``, are special. Special characters " "either stand for classes of ordinary characters, or affect how the regular " @@ -81371,38 +83140,36 @@ msgid "" "\\number`` notation, e.g., ``'\\x00'``." msgstr "" -#: ../src/Doc/library/re.rst:74 +#: library/re.rst:74 msgid "The special characters are:" msgstr "" -# 9332c6c2035d4503b194a27ffed81356 -#: ../src/Doc/library/re.rst:78 -msgid "``'.'``" +#: library/re.rst:79 +msgid "'.'" msgstr "" -#: ../src/Doc/library/re.rst:77 +#: library/re.rst:77 msgid "" "(Dot.) In the default mode, this matches any character except a newline. " "If the :const:`DOTALL` flag has been specified, this matches any character " "including a newline." msgstr "" -#: ../src/Doc/library/re.rst:82 ../src/Doc/library/string.rst:355 -msgid "``'^'``" +#: library/re.rst:83 +msgid "'^'" msgstr "" -#: ../src/Doc/library/re.rst:82 +#: library/re.rst:82 msgid "" "(Caret.) Matches the start of the string, and in :const:`MULTILINE` mode " "also matches immediately after each newline." msgstr "" -# 95a42378c2f542cd9f7ccc6a428b866d -#: ../src/Doc/library/re.rst:91 -msgid "``'$'``" +#: library/re.rst:92 +msgid "'$'" msgstr "" -#: ../src/Doc/library/re.rst:86 +#: library/re.rst:86 msgid "" "Matches the end of the string or just before the newline at the end of the " "string, and in :const:`MULTILINE` mode also matches before a newline. " @@ -81414,42 +83181,43 @@ msgid "" "string." msgstr "" -# 8fc991afaa7647a3abe99207b83384e0 -#: ../src/Doc/library/re.rst:96 -msgid "``'*'``" +#: library/re.rst:97 +msgid "'*'" msgstr "" -#: ../src/Doc/library/re.rst:95 +#: library/re.rst:95 msgid "" "Causes the resulting RE to match 0 or more repetitions of the preceding RE, " "as many repetitions as are possible. ``ab*`` will match 'a', 'ab', or 'a' " "followed by any number of 'b's." msgstr "" -#: ../src/Doc/library/re.rst:100 +#: library/re.rst:102 +msgid "'+'" +msgstr "" + +#: library/re.rst:100 msgid "" "Causes the resulting RE to match 1 or more repetitions of the preceding RE. " "``ab+`` will match 'a' followed by any non-zero number of 'b's; it will not " "match just 'a'." msgstr "" -# e680fc12579242799f386264fa21ffd4 -#: ../src/Doc/library/re.rst:105 -msgid "``'?'``" +#: library/re.rst:106 +msgid "'?'" msgstr "" -#: ../src/Doc/library/re.rst:105 +#: library/re.rst:105 msgid "" "Causes the resulting RE to match 0 or 1 repetitions of the preceding RE. " "``ab?`` will match either 'a' or 'ab'." msgstr "" -# c9cc3835fe304fff8ac75cf04671524c -#: ../src/Doc/library/re.rst:114 -msgid "``*?``, ``+?``, ``??``" +#: library/re.rst:115 +msgid "*?, +?, ??" msgstr "" -#: ../src/Doc/library/re.rst:109 +#: library/re.rst:109 msgid "" "The ``'*'``, ``'+'``, and ``'?'`` qualifiers are all :dfn:`greedy`; they " "match as much text as possible. Sometimes this behaviour isn't desired; if " @@ -81460,24 +83228,22 @@ msgid "" "previous expression will match only ``'

'``." msgstr "" -# 5a089333023d4a7e8908719a70c9485b -#: ../src/Doc/library/re.rst:119 -msgid "``{m}``" +#: library/re.rst:120 +msgid "{m}" msgstr "" -#: ../src/Doc/library/re.rst:118 +#: library/re.rst:118 msgid "" "Specifies that exactly *m* copies of the previous RE should be matched; " "fewer matches cause the entire RE not to match. For example, ``a{6}`` will " "match exactly six ``'a'`` characters, but not five." msgstr "" -# 2a2a9adcb10e4ee381ff9335e6a15c14 -#: ../src/Doc/library/re.rst:128 -msgid "``{m,n}``" +#: library/re.rst:129 +msgid "{m,n}" msgstr "" -#: ../src/Doc/library/re.rst:123 +#: library/re.rst:123 msgid "" "Causes the resulting RE to match from *m* to *n* repetitions of the " "preceding RE, attempting to match as many repetitions as possible. For " @@ -81489,12 +83255,11 @@ msgid "" "form." msgstr "" -# 9f849abe46e446eabaa6a4445077d660 -#: ../src/Doc/library/re.rst:135 -msgid "``{m,n}?``" +#: library/re.rst:136 +msgid "{m,n}?" msgstr "" -#: ../src/Doc/library/re.rst:132 +#: library/re.rst:132 msgid "" "Causes the resulting RE to match from *m* to *n* repetitions of the " "preceding RE, attempting to match as *few* repetitions as possible. This is " @@ -81503,19 +83268,18 @@ msgid "" "while ``a{3,5}?`` will only match 3 characters." msgstr "" -# c63b14d4198f40cfb355c1815c3c5d07 -#: ../src/Doc/library/re.rst:148 -msgid "``'\\'``" +#: library/re.rst:149 +msgid "'\\'" msgstr "" -#: ../src/Doc/library/re.rst:139 +#: library/re.rst:139 msgid "" "Either escapes special characters (permitting you to match characters like " "``'*'``, ``'?'``, and so forth), or signals a special sequence; special " "sequences are discussed below." msgstr "" -#: ../src/Doc/library/re.rst:143 +#: library/re.rst:143 msgid "" "If you're not using a raw string to express the pattern, remember that " "Python also uses the backslash as an escape sequence in string literals; if " @@ -81526,25 +83290,24 @@ msgid "" "recommended that you use raw strings for all but the simplest expressions." msgstr "" -# 7f2b68092f864347a13746c0f4ae2dfa -#: ../src/Doc/library/re.rst:180 -msgid "``[]``" +#: library/re.rst:181 +msgid "[]" msgstr "" # 9b220ac4526441ae9b07392a4767ba5c -#: ../src/Doc/library/re.rst:152 +#: library/re.rst:152 msgid "Used to indicate a set of characters. In a set:" msgstr "" # 474bb70865294e63894dee652b948dc6 -#: ../src/Doc/library/re.rst:154 +#: library/re.rst:154 msgid "" "Characters can be listed individually, e.g. ``[amk]`` will match ``'a'``, " "``'m'``, or ``'k'``." msgstr "" # 5c643510ba474897842b7685c9cf92fc -#: ../src/Doc/library/re.rst:157 +#: library/re.rst:157 msgid "" "Ranges of characters can be indicated by giving two characters and " "separating them by a ``'-'``, for example ``[a-z]`` will match any lowercase " @@ -81555,7 +83318,7 @@ msgid "" msgstr "" # 6376c7ba0f314d31921c3917ef2e7dab -#: ../src/Doc/library/re.rst:164 +#: library/re.rst:164 msgid "" "Special characters lose their special meaning inside sets. For example, " "``[(+*)]`` will match any of the literal characters ``'('``, ``'+'``, " @@ -81563,7 +83326,7 @@ msgid "" msgstr "" # 5725f62bbac7444894bef813d6daa052 -#: ../src/Doc/library/re.rst:168 +#: library/re.rst:168 msgid "" "Character classes such as ``\\w`` or ``\\S`` (defined below) are also " "accepted inside a set, although the characters they match depends on " @@ -81571,7 +83334,7 @@ msgid "" msgstr "" # 2fa2e06b1ded42a3b32434f32533a8f4 -#: ../src/Doc/library/re.rst:172 +#: library/re.rst:172 msgid "" "Characters that are not within a range can be matched by :dfn:" "`complementing` the set. If the first character of the set is ``'^'``, all " @@ -81582,19 +83345,18 @@ msgid "" msgstr "" # 11a601caaa25458ab824b9fe6ef3b61e -#: ../src/Doc/library/re.rst:179 +#: library/re.rst:179 msgid "" "To match a literal ``']'`` inside a set, precede it with a backslash, or " "place it at the beginning of the set. For example, both ``[()[\\]{}]`` and " "``[]()[{}]`` will both match a parenthesis." msgstr "" -# 7785076fa069419f9921dbc4a5ca01ca -#: ../src/Doc/library/re.rst:191 -msgid "``'|'``" +#: library/re.rst:192 +msgid "'|'" msgstr "" -#: ../src/Doc/library/re.rst:184 +#: library/re.rst:184 msgid "" "``A|B``, where A and B can be arbitrary REs, creates a regular expression " "that will match either A or B. An arbitrary number of REs can be separated " @@ -81607,12 +83369,11 @@ msgid "" "``, or enclose it inside a character class, as in ``[|]``." msgstr "" -# 884606a2aed04c99a967840391eb3cdf -#: ../src/Doc/library/re.rst:198 -msgid "``(...)``" +#: library/re.rst:199 +msgid "(...)" msgstr "" -#: ../src/Doc/library/re.rst:195 +#: library/re.rst:195 msgid "" "Matches whatever regular expression is inside the parentheses, and indicates " "the start and end of a group; the contents of a group can be retrieved after " @@ -81622,12 +83383,11 @@ msgid "" "character class: ``[(] [)]``." msgstr "" -# c452751e8ea54fafb51f5d045223e054 -#: ../src/Doc/library/re.rst:205 -msgid "``(?...)``" +#: library/re.rst:206 +msgid "(?...)" msgstr "" -#: ../src/Doc/library/re.rst:202 +#: library/re.rst:202 msgid "" "This is an extension notation (a ``'?'`` following a ``'('`` is not " "meaningful otherwise). The first character after the ``'?'`` determines " @@ -81636,13 +83396,12 @@ msgid "" "rule. Following are the currently supported extensions." msgstr "" -# a84b2f9a7783481e95803d3d4c29b5af -#: ../src/Doc/library/re.rst:222 -msgid "``(?iLmsux)``" +#: library/re.rst:223 +msgid "(?iLmsux)" msgstr "" # d34f67b19d8741f59f781c9f47603381 -#: ../src/Doc/library/re.rst:209 +#: library/re.rst:209 msgid "" "(One or more letters from the set ``'i'``, ``'L'``, ``'m'``, ``'s'``, " "``'u'``, ``'x'``.) The group matches the empty string; the letters set the " @@ -81655,7 +83414,7 @@ msgid "" "compile` function." msgstr "" -#: ../src/Doc/library/re.rst:220 +#: library/re.rst:220 msgid "" "Note that the ``(?x)`` flag changes how the expression is parsed. It should " "be used first in the expression string, or after one or more whitespace " @@ -81663,13 +83422,12 @@ msgid "" "results are undefined." msgstr "" -# f455d57022f3478bab3a00c8c3c55e72 -#: ../src/Doc/library/re.rst:228 -msgid "``(?:...)``" +#: library/re.rst:229 +msgid "(?:...)" msgstr "" # bc99cdbcf7bf47808c048a258379d4aa -#: ../src/Doc/library/re.rst:226 +#: library/re.rst:226 msgid "" "A non-capturing version of regular parentheses. Matches whatever regular " "expression is inside the parentheses, but the substring matched by the group " @@ -81677,13 +83435,12 @@ msgid "" "pattern." msgstr "" -# b76fdbb9fbe944b98171b912ffba7ccc -#: ../src/Doc/library/re.rst:253 -msgid "``(?P...)``" +#: library/re.rst:254 +msgid "(?P...)" msgstr "" # 55d5bbe4c80a4aa09ed4e9305b74b644 -#: ../src/Doc/library/re.rst:232 +#: library/re.rst:232 msgid "" "Similar to regular parentheses, but the substring matched by the group is " "accessible via the symbolic group name *name*. Group names must be valid " @@ -81693,7 +83450,7 @@ msgid "" msgstr "" # b655276b8b604c31b5526ad44e1b8c56 -#: ../src/Doc/library/re.rst:238 +#: library/re.rst:238 msgid "" "Named groups can be referenced in three contexts. If the pattern is ``(?" "P['\"]).*?(?P=quote)`` (i.e. matching a string quoted with either " @@ -81701,113 +83458,107 @@ msgid "" msgstr "" # c15a3e5aa8c540a787941e802b0af074 -#: ../src/Doc/library/re.rst:243 +#: library/re.rst:243 msgid "Context of reference to group \"quote\"" msgstr "" # 03cbf7924660414fad430f25e1502d9a -#: ../src/Doc/library/re.rst:243 +#: library/re.rst:243 msgid "Ways to reference it" msgstr "" # e4bcad5c728b41b5b1b8050754147847 -#: ../src/Doc/library/re.rst:245 +#: library/re.rst:245 msgid "in the same pattern itself" msgstr "" # 5cbc816d42f94202ac4dbbf3c5545065 -#: ../src/Doc/library/re.rst:245 +#: library/re.rst:245 msgid "``(?P=quote)`` (as shown)" msgstr "" # 0bcfff228a614447b5dceb6aa8ace86a # 0bcfff228a614447b5dceb6aa8ace86a -#: ../src/Doc/library/re.rst:246 ../src/Doc/library/re.rst:253 +#: library/re.rst:246 library/re.rst:253 msgid "``\\1``" msgstr "" # 47b09d1bf6ca4fe6be4967426189ba0d -#: ../src/Doc/library/re.rst:248 +#: library/re.rst:248 msgid "when processing match object ``m``" msgstr "" # f5ced709cded49cbba2ad7156e1e7c50 -#: ../src/Doc/library/re.rst:248 +#: library/re.rst:248 msgid "``m.group('quote')``" msgstr "" # 6fcbd65223cb417db1a36a2204e84c8f -#: ../src/Doc/library/re.rst:249 +#: library/re.rst:249 msgid "``m.end('quote')`` (etc.)" msgstr "" # 2a1414b6080c412595f606018a847fee -#: ../src/Doc/library/re.rst:251 +#: library/re.rst:251 msgid "in a string passed to the ``repl`` argument of ``re.sub()``" msgstr "" # 005ef96de250480cb90115ebb7fe731b -#: ../src/Doc/library/re.rst:251 +#: library/re.rst:251 msgid "``\\g``" msgstr "" # d722a26f49564f68ac1efb25df6a6b97 -#: ../src/Doc/library/re.rst:252 +#: library/re.rst:252 msgid "``\\g<1>``" msgstr "" -# d9edbf0692064774ac2e6d02aada8a09 -#: ../src/Doc/library/re.rst:257 -msgid "``(?P=name)``" +#: library/re.rst:258 +msgid "(?P=name)" msgstr "" # 0b29d8f7c3584346834031f68a3d1b60 -#: ../src/Doc/library/re.rst:257 +#: library/re.rst:257 msgid "" "A backreference to a named group; it matches whatever text was matched by " "the earlier group named *name*." msgstr "" -# 858b50d404bb4a8eb9014788187fc237 -#: ../src/Doc/library/re.rst:260 -msgid "``(?#...)``" +#: library/re.rst:261 +msgid "(?#...)" msgstr "" -#: ../src/Doc/library/re.rst:261 +#: library/re.rst:261 msgid "A comment; the contents of the parentheses are simply ignored." msgstr "" -# cc59504715714372a57c8323126a9707 -#: ../src/Doc/library/re.rst:265 -msgid "``(?=...)``" +#: library/re.rst:266 +msgid "(?=...)" msgstr "" -#: ../src/Doc/library/re.rst:264 +#: library/re.rst:264 msgid "" "Matches if ``...`` matches next, but doesn't consume any of the string. " "This is called a lookahead assertion. For example, ``Isaac (?=Asimov)`` " "will match ``'Isaac '`` only if it's followed by ``'Asimov'``." msgstr "" -# b90ae485010649d299433a2d152db1bc -#: ../src/Doc/library/re.rst:270 -msgid "``(?!...)``" +#: library/re.rst:271 +msgid "(?!...)" msgstr "" -#: ../src/Doc/library/re.rst:269 +#: library/re.rst:269 msgid "" "Matches if ``...`` doesn't match next. This is a negative lookahead " "assertion. For example, ``Isaac (?!Asimov)`` will match ``'Isaac '`` only if " "it's *not* followed by ``'Asimov'``." msgstr "" -# 8660f68d425b47efa178f8edc7ad30c1 -#: ../src/Doc/library/re.rst:292 -msgid "``(?<=...)``" +#: library/re.rst:295 +msgid "(?<=...)" msgstr "" -# dc04616c92d3464fbb36124a72a68b47 -#: ../src/Doc/library/re.rst:274 +#: library/re.rst:274 msgid "" "Matches if the current position in the string is preceded by a match for " "``...`` that ends at the current position. This is called a :dfn:`positive " @@ -81815,36 +83566,36 @@ msgid "" "since the lookbehind will back up 3 characters and check if the contained " "pattern matches. The contained pattern must only match strings of some fixed " "length, meaning that ``abc`` or ``a|b`` are allowed, but ``a*`` and ``a{3,4}" -"`` are not. Note that patterns which start with positive lookbehind " -"assertions will not match at the beginning of the string being searched; you " -"will most likely want to use the :func:`search` function rather than the :" -"func:`match` function:" +"`` are not. Group references are not supported even if they match strings " +"of some fixed length. Note that patterns which start with positive " +"lookbehind assertions will not match at the beginning of the string being " +"searched; you will most likely want to use the :func:`search` function " +"rather than the :func:`match` function:" msgstr "" -#: ../src/Doc/library/re.rst:289 +#: library/re.rst:291 msgid "This example looks for a word following a hyphen:" msgstr "" -# 1374e485bfbb418fbcaf1accc0318636 -#: ../src/Doc/library/re.rst:299 -msgid "``(?`` will use the substring matched " @@ -82301,13 +84048,13 @@ msgid "" "RE." msgstr "" -#: ../src/Doc/library/re.rst:674 +#: library/re.rst:679 msgid "" "Perform the same operation as :func:`sub`, but return a tuple ``(new_string, " "number_of_subs_made)``." msgstr "" -#: ../src/Doc/library/re.rst:683 +#: library/re.rst:688 msgid "" "Return *string* with all non-alphanumerics backslashed; this is useful if " "you want to match an arbitrary literal string that may have regular " @@ -82315,11 +84062,11 @@ msgid "" msgstr "" # a1abeef97bb544b3a035b16ac1fe88dd -#: ../src/Doc/library/re.rst:690 +#: library/re.rst:695 msgid "Clear the regular expression cache." msgstr "" -#: ../src/Doc/library/re.rst:695 +#: library/re.rst:700 msgid "" "Exception raised when a string passed to one of the functions here is not a " "valid regular expression (for example, it might contain unmatched " @@ -82327,16 +84074,16 @@ msgid "" "matching. It is never an error if a string contains no match for a pattern." msgstr "" -#: ../src/Doc/library/re.rst:704 +#: library/re.rst:709 msgid "Regular Expression Objects" msgstr "" -#: ../src/Doc/library/re.rst:708 +#: library/re.rst:713 msgid "" "The :class:`RegexObject` class supports the following methods and attributes:" msgstr "" -#: ../src/Doc/library/re.rst:712 +#: library/re.rst:717 msgid "" "Scan through *string* looking for a location where this regular expression " "produces a match, and return a corresponding :class:`MatchObject` instance. " @@ -82345,7 +84092,7 @@ msgid "" "string." msgstr "" -#: ../src/Doc/library/re.rst:717 +#: library/re.rst:722 msgid "" "The optional second parameter *pos* gives an index in the string where the " "search is to start; it defaults to ``0``. This is not completely equivalent " @@ -82354,7 +84101,7 @@ msgid "" "necessarily at the index where the search is to start." msgstr "" -#: ../src/Doc/library/re.rst:723 +#: library/re.rst:728 msgid "" "The optional parameter *endpos* limits how far the string will be searched; " "it will be as if the string is *endpos* characters long, so only the " @@ -82364,7 +84111,7 @@ msgid "" "equivalent to ``rx.search(string[:50], 0)``." msgstr "" -#: ../src/Doc/library/re.rst:738 +#: library/re.rst:743 msgid "" "If zero or more characters at the *beginning* of *string* match this regular " "expression, return a corresponding :class:`MatchObject` instance. Return " @@ -82372,73 +84119,73 @@ msgid "" "different from a zero-length match." msgstr "" -#: ../src/Doc/library/re.rst:743 +#: library/re.rst:748 msgid "" "The optional *pos* and *endpos* parameters have the same meaning as for the :" "meth:`~RegexObject.search` method." msgstr "" # f16be6a350b04e9eb30e5b5490316b45 -#: ../src/Doc/library/re.rst:751 +#: library/re.rst:756 msgid "" "If you want to locate a match anywhere in *string*, use :meth:`~RegexObject." "search` instead (see also :ref:`search-vs-match`)." msgstr "" -#: ../src/Doc/library/re.rst:757 +#: library/re.rst:762 msgid "Identical to the :func:`split` function, using the compiled pattern." msgstr "" -#: ../src/Doc/library/re.rst:762 +#: library/re.rst:767 msgid "" "Similar to the :func:`findall` function, using the compiled pattern, but " "also accepts optional *pos* and *endpos* parameters that limit the search " "region like for :meth:`match`." msgstr "" -#: ../src/Doc/library/re.rst:769 +#: library/re.rst:774 msgid "" "Similar to the :func:`finditer` function, using the compiled pattern, but " "also accepts optional *pos* and *endpos* parameters that limit the search " "region like for :meth:`match`." msgstr "" -#: ../src/Doc/library/re.rst:776 +#: library/re.rst:781 msgid "Identical to the :func:`sub` function, using the compiled pattern." msgstr "" -#: ../src/Doc/library/re.rst:781 +#: library/re.rst:786 msgid "Identical to the :func:`subn` function, using the compiled pattern." msgstr "" # adba7cf86015449ab823c8be48ceaf2c -#: ../src/Doc/library/re.rst:786 +#: library/re.rst:791 msgid "" "The regex matching flags. This is a combination of the flags given to :func:" "`.compile` and any ``(?...)`` inline flags in the pattern." msgstr "" -#: ../src/Doc/library/re.rst:792 +#: library/re.rst:797 msgid "The number of capturing groups in the pattern." msgstr "" -#: ../src/Doc/library/re.rst:797 +#: library/re.rst:802 msgid "" "A dictionary mapping any symbolic group names defined by ``(?P)`` to " "group numbers. The dictionary is empty if no symbolic groups were used in " "the pattern." msgstr "" -#: ../src/Doc/library/re.rst:804 +#: library/re.rst:809 msgid "The pattern string from which the RE object was compiled." msgstr "" -#: ../src/Doc/library/re.rst:810 +#: library/re.rst:815 msgid "Match Objects" msgstr "" # 19f9c0f84eec43c19f7c5715e52acc8a -#: ../src/Doc/library/re.rst:814 +#: library/re.rst:819 msgid "" "Match objects always have a boolean value of ``True``. Since :meth:`~regex." "match` and :meth:`~regex.search` return ``None`` when there is no match, you " @@ -82446,11 +84193,11 @@ msgid "" msgstr "" # 0de99aa33d2545cc98f05ab32c3a2d4f -#: ../src/Doc/library/re.rst:823 +#: library/re.rst:828 msgid "Match objects support the following methods and attributes:" msgstr "" -#: ../src/Doc/library/re.rst:828 +#: library/re.rst:833 msgid "" "Return the string obtained by doing backslash substitution on the template " "string *template*, as done by the :meth:`~RegexObject.sub` method. Escapes " @@ -82459,7 +84206,7 @@ msgid "" "\\g``) are replaced by the contents of the corresponding group." msgstr "" -#: ../src/Doc/library/re.rst:837 +#: library/re.rst:842 msgid "" "Returns one or more subgroups of the match. If there is a single argument, " "the result is a single string; if there are multiple arguments, the result " @@ -82474,7 +84221,7 @@ msgid "" "the pattern that matched multiple times, the last match is returned." msgstr "" -#: ../src/Doc/library/re.rst:859 +#: library/re.rst:864 msgid "" "If the regular expression uses the ``(?P...)`` syntax, the *groupN* " "arguments may also be strings identifying groups by their group name. If a " @@ -82482,19 +84229,19 @@ msgid "" "`IndexError` exception is raised." msgstr "" -#: ../src/Doc/library/re.rst:864 +#: library/re.rst:869 msgid "A moderately complicated example:" msgstr "" -#: ../src/Doc/library/re.rst:872 +#: library/re.rst:877 msgid "Named groups can also be referred to by their index:" msgstr "" -#: ../src/Doc/library/re.rst:879 +#: library/re.rst:884 msgid "If a group matches multiple times, only the last match is accessible:" msgstr "" -#: ../src/Doc/library/re.rst:888 +#: library/re.rst:893 msgid "" "Return a tuple containing all the subgroups of the match, from 1 up to " "however many groups are in the pattern. The *default* argument is used for " @@ -82504,21 +84251,21 @@ msgid "" "(from 1.5.1 on), a singleton tuple is returned in such cases.)" msgstr "" -#: ../src/Doc/library/re.rst:901 +#: library/re.rst:906 msgid "" "If we make the decimal place and everything after it optional, not all " "groups might participate in the match. These groups will default to " "``None`` unless the *default* argument is given:" msgstr "" -#: ../src/Doc/library/re.rst:914 +#: library/re.rst:919 msgid "" "Return a dictionary containing all the *named* subgroups of the match, keyed " "by the subgroup name. The *default* argument is used for groups that did " "not participate in the match; it defaults to ``None``. For example:" msgstr "" -#: ../src/Doc/library/re.rst:926 +#: library/re.rst:931 msgid "" "Return the indices of the start and end of the substring matched by *group*; " "*group* defaults to zero (meaning the whole matched substring). Return " @@ -82527,7 +84274,7 @@ msgid "" "matched by group *g* (equivalent to ``m.group(g)``) is ::" msgstr "" -#: ../src/Doc/library/re.rst:934 +#: library/re.rst:939 msgid "" "Note that ``m.start(group)`` will equal ``m.end(group)`` if *group* matched " "a null string. For example, after ``m = re.search('b(c?)', 'cba')``, ``m." @@ -82535,32 +84282,32 @@ msgid "" "2, and ``m.start(2)`` raises an :exc:`IndexError` exception." msgstr "" -#: ../src/Doc/library/re.rst:939 +#: library/re.rst:944 msgid "An example that will remove *remove_this* from email addresses:" msgstr "" -#: ../src/Doc/library/re.rst:949 +#: library/re.rst:954 msgid "" "For :class:`MatchObject` *m*, return the 2-tuple ``(m.start(group), m." "end(group))``. Note that if *group* did not contribute to the match, this is " "``(-1, -1)``. *group* defaults to zero, the entire match." msgstr "" -#: ../src/Doc/library/re.rst:956 +#: library/re.rst:961 msgid "" "The value of *pos* which was passed to the :meth:`~RegexObject.search` or :" "meth:`~RegexObject.match` method of the :class:`RegexObject`. This is the " "index into the string at which the RE engine started looking for a match." msgstr "" -#: ../src/Doc/library/re.rst:963 +#: library/re.rst:968 msgid "" "The value of *endpos* which was passed to the :meth:`~RegexObject.search` " "or :meth:`~RegexObject.match` method of the :class:`RegexObject`. This is " "the index into the string beyond which the RE engine will not go." msgstr "" -#: ../src/Doc/library/re.rst:970 +#: library/re.rst:975 msgid "" "The integer index of the last matched capturing group, or ``None`` if no " "group was matched at all. For example, the expressions ``(a)b``, ``((a)" @@ -82569,36 +84316,36 @@ msgid "" "applied to the same string." msgstr "" -#: ../src/Doc/library/re.rst:979 +#: library/re.rst:984 msgid "" "The name of the last matched capturing group, or ``None`` if the group " "didn't have a name, or if no group was matched at all." msgstr "" -#: ../src/Doc/library/re.rst:985 +#: library/re.rst:990 msgid "" "The regular expression object whose :meth:`~RegexObject.match` or :meth:" "`~RegexObject.search` method produced this :class:`MatchObject` instance." msgstr "" -#: ../src/Doc/library/re.rst:992 +#: library/re.rst:997 msgid "" "The string passed to :meth:`~RegexObject.match` or :meth:`~RegexObject." "search`." msgstr "" -#: ../src/Doc/library/re.rst:1001 +#: library/re.rst:1006 msgid "Checking For a Pair" msgstr "" -#: ../src/Doc/library/re.rst:1003 +#: library/re.rst:1008 msgid "" "In this example, we'll use the following helper function to display match " "objects a little more gracefully:" msgstr "" # a9018787f8574d5d98077d38780acc3e -#: ../src/Doc/library/re.rst:1013 +#: library/re.rst:1018 msgid "" "Suppose you are writing a poker program where a player's hand is represented " "as a 5-character string with each character representing a card, \"a\" for " @@ -82606,29 +84353,29 @@ msgid "" "\"2\" through \"9\" representing the card with that value." msgstr "" -#: ../src/Doc/library/re.rst:1018 +#: library/re.rst:1023 msgid "To see if a given string is a valid hand, one could do the following:" msgstr "" -#: ../src/Doc/library/re.rst:1028 +#: library/re.rst:1033 msgid "" "That last hand, ``\"727ak\"``, contained a pair, or two of the same valued " "cards. To match this with a regular expression, one could use backreferences " "as such:" msgstr "" -#: ../src/Doc/library/re.rst:1038 +#: library/re.rst:1043 msgid "" "To find out what card the pair consists of, one could use the :meth:" "`~MatchObject.group` method of :class:`MatchObject` in the following manner:" msgstr "" -#: ../src/Doc/library/re.rst:1059 +#: library/re.rst:1064 msgid "Simulating scanf()" msgstr "" # 8d655a5bad3e478c97959a3427e71dca -#: ../src/Doc/library/re.rst:1063 +#: library/re.rst:1068 msgid "" "Python does not currently have an equivalent to :c:func:`scanf`. Regular " "expressions are generally more powerful, though also more verbose, than :c:" @@ -82638,100 +84385,99 @@ msgid "" msgstr "" # 713559f81acc45f88c099d0e7ee99eb3 -#: ../src/Doc/library/re.rst:1070 +#: library/re.rst:1075 msgid ":c:func:`scanf` Token" msgstr "" -#: ../src/Doc/library/re.rst:1070 +#: library/re.rst:1075 msgid "Regular Expression" msgstr "" -#: ../src/Doc/library/re.rst:1072 -#: ../src/Doc/library/xml.etree.elementtree.rst:329 +#: library/re.rst:1077 library/xml.etree.elementtree.rst:396 msgid "``.``" msgstr "" -#: ../src/Doc/library/re.rst:1074 +#: library/re.rst:1079 msgid "``%5c``" msgstr "" -#: ../src/Doc/library/re.rst:1074 +#: library/re.rst:1079 msgid "``.{5}``" msgstr "" -#: ../src/Doc/library/re.rst:1076 +#: library/re.rst:1081 msgid "``[-+]?\\d+``" msgstr "" -#: ../src/Doc/library/re.rst:1078 +#: library/re.rst:1083 msgid "``%e``, ``%E``, ``%f``, ``%g``" msgstr "" -#: ../src/Doc/library/re.rst:1078 +#: library/re.rst:1083 msgid "``[-+]?(\\d+(\\.\\d*)?|\\.\\d+)([eE][-+]?\\d+)?``" msgstr "" -#: ../src/Doc/library/re.rst:1080 +#: library/re.rst:1085 msgid "``%i``" msgstr "" -#: ../src/Doc/library/re.rst:1080 +#: library/re.rst:1085 msgid "``[-+]?(0[xX][\\dA-Fa-f]+|0[0-7]*|\\d+)``" msgstr "" -#: ../src/Doc/library/re.rst:1082 +#: library/re.rst:1087 msgid "``%o``" msgstr "" # 8d6a9d3bae4a4cc99ba82cf138e69808 -#: ../src/Doc/library/re.rst:1082 +#: library/re.rst:1087 msgid "``[-+]?[0-7]+``" msgstr "" -#: ../src/Doc/library/re.rst:1084 +#: library/re.rst:1089 msgid "``%s``" msgstr "" -#: ../src/Doc/library/re.rst:1084 +#: library/re.rst:1089 msgid "``\\S+``" msgstr "" -#: ../src/Doc/library/re.rst:1086 +#: library/re.rst:1091 msgid "``%u``" msgstr "" -#: ../src/Doc/library/re.rst:1086 +#: library/re.rst:1091 msgid "``\\d+``" msgstr "" -#: ../src/Doc/library/re.rst:1088 +#: library/re.rst:1093 msgid "``%x``, ``%X``" msgstr "" # 4defb720350d4037877fed3dacdb7dc0 -#: ../src/Doc/library/re.rst:1088 +#: library/re.rst:1093 msgid "``[-+]?(0[xX])?[\\dA-Fa-f]+``" msgstr "" -#: ../src/Doc/library/re.rst:1091 +#: library/re.rst:1096 msgid "To extract the filename and numbers from a string like ::" msgstr "" # 52b0f5ebc6934600a84b06ccbded1f19 -#: ../src/Doc/library/re.rst:1095 +#: library/re.rst:1100 msgid "you would use a :c:func:`scanf` format like ::" msgstr "" -#: ../src/Doc/library/re.rst:1099 +#: library/re.rst:1104 msgid "The equivalent regular expression would be ::" msgstr "" -#: ../src/Doc/library/re.rst:1107 +#: library/re.rst:1112 msgid "search() vs. match()" msgstr "" # 15edffd2d62c4e1dad43a911dd07570b -#: ../src/Doc/library/re.rst:1111 +#: library/re.rst:1116 msgid "" "Python offers two different primitive operations based on regular " "expressions: :func:`re.match` checks for a match only at the beginning of " @@ -82740,25 +84486,25 @@ msgid "" msgstr "" # 1ef21ebbf44d47ff96ffc2124fe15a74 -#: ../src/Doc/library/re.rst:1122 +#: library/re.rst:1127 msgid "" "Regular expressions beginning with ``'^'`` can be used with :func:`search` " "to restrict the match at the beginning of the string::" msgstr "" # c176f10ff28e491bbfbd6dca03d0ac1c -#: ../src/Doc/library/re.rst:1130 +#: library/re.rst:1135 msgid "" "Note however that in :const:`MULTILINE` mode :func:`match` only matches at " "the beginning of the string, whereas using :func:`search` with a regular " "expression beginning with ``'^'`` will match at the beginning of each line." msgstr "" -#: ../src/Doc/library/re.rst:1140 +#: library/re.rst:1145 msgid "Making a Phonebook" msgstr "" -#: ../src/Doc/library/re.rst:1142 +#: library/re.rst:1147 msgid "" ":func:`split` splits a string into a list delimited by the passed pattern. " "The method is invaluable for converting textual data into data structures " @@ -82766,37 +84512,37 @@ msgid "" "following example that creates a phonebook." msgstr "" -#: ../src/Doc/library/re.rst:1147 +#: library/re.rst:1152 msgid "" "First, here is the input. Normally it may come from a file, here we are " "using triple-quoted string syntax:" msgstr "" -#: ../src/Doc/library/re.rst:1158 +#: library/re.rst:1163 msgid "" "The entries are separated by one or more newlines. Now we convert the string " "into a list with each nonempty line having its own entry:" msgstr "" -#: ../src/Doc/library/re.rst:1171 +#: library/re.rst:1176 msgid "" "Finally, split each entry into a list with first name, last name, telephone " "number, and address. We use the ``maxsplit`` parameter of :func:`split` " "because the address has spaces, our splitting pattern, in it:" msgstr "" -#: ../src/Doc/library/re.rst:1184 +#: library/re.rst:1189 msgid "" "The ``:?`` pattern matches the colon after the last name, so that it does " "not occur in the result list. With a ``maxsplit`` of ``4``, we could " "separate the house number from the street name:" msgstr "" -#: ../src/Doc/library/re.rst:1199 +#: library/re.rst:1204 msgid "Text Munging" msgstr "" -#: ../src/Doc/library/re.rst:1201 +#: library/re.rst:1206 msgid "" ":func:`sub` replaces every occurrence of a pattern with a string or the " "result of a function. This example demonstrates using :func:`sub` with a " @@ -82804,11 +84550,11 @@ msgid "" "each word of a sentence except for the first and last characters::" msgstr "" -#: ../src/Doc/library/re.rst:1218 +#: library/re.rst:1223 msgid "Finding all Adverbs" msgstr "" -#: ../src/Doc/library/re.rst:1220 +#: library/re.rst:1225 msgid "" ":func:`findall` matches *all* occurrences of a pattern, not just the first " "one as :func:`search` does. For example, if one was a writer and wanted to " @@ -82816,11 +84562,11 @@ msgid "" "the following manner:" msgstr "" -#: ../src/Doc/library/re.rst:1231 +#: library/re.rst:1236 msgid "Finding all Adverbs and their Positions" msgstr "" -#: ../src/Doc/library/re.rst:1233 +#: library/re.rst:1238 msgid "" "If one wants more information about all matches of a pattern than the " "matched text, :func:`finditer` is useful as it provides instances of :class:" @@ -82829,11 +84575,11 @@ msgid "" "in some text, he or she would use :func:`finditer` in the following manner:" msgstr "" -#: ../src/Doc/library/re.rst:1247 +#: library/re.rst:1252 msgid "Raw String Notation" msgstr "" -#: ../src/Doc/library/re.rst:1249 +#: library/re.rst:1254 msgid "" "Raw string notation (``r\"text\"``) keeps regular expressions sane. Without " "it, every backslash (``'\\'``) in a regular expression would have to be " @@ -82841,7 +84587,7 @@ msgid "" "lines of code are functionally identical:" msgstr "" -#: ../src/Doc/library/re.rst:1259 +#: library/re.rst:1264 msgid "" "When one wants to match a literal backslash, it must be escaped in the " "regular expression. With raw string notation, this means ``r\"\\\\\"``. " @@ -82849,12 +84595,12 @@ msgid "" "following lines of code functionally identical:" msgstr "" -#: ../src/Doc/library/readline.rst:2 +#: library/readline.rst:2 msgid ":mod:`readline` --- GNU readline interface" msgstr "" # ed28e53b372e4b96a76ff37b630cdc06 -#: ../src/Doc/library/readline.rst:10 +#: library/readline.rst:10 msgid "" "The :mod:`readline` module defines a number of functions to facilitate " "completion and reading/writing of history files from the Python interpreter. " @@ -82864,14 +84610,14 @@ msgid "" "`raw_input` and :func:`input` built-in functions." msgstr "" -#: ../src/Doc/library/readline.rst:19 +#: library/readline.rst:19 msgid "" "On MacOS X the :mod:`readline` module can be implemented using the " "``libedit`` library instead of GNU readline." msgstr "" # b639e6d3d88847569f8362c05a59b67b -#: ../src/Doc/library/readline.rst:22 +#: library/readline.rst:22 msgid "" "The configuration file for ``libedit`` is different from that of GNU " "readline. If you programmatically load configuration strings you can check " @@ -82879,83 +84625,83 @@ msgid "" "between GNU readline and libedit." msgstr "" -#: ../src/Doc/library/readline.rst:28 +#: library/readline.rst:28 msgid "The :mod:`readline` module defines the following functions:" msgstr "" -#: ../src/Doc/library/readline.rst:33 +#: library/readline.rst:33 msgid "Parse and execute single line of a readline init file." msgstr "" -#: ../src/Doc/library/readline.rst:38 +#: library/readline.rst:38 msgid "Return the current contents of the line buffer." msgstr "" -#: ../src/Doc/library/readline.rst:43 +#: library/readline.rst:43 msgid "Insert text into the command line." msgstr "" -#: ../src/Doc/library/readline.rst:48 +#: library/readline.rst:48 msgid "" "Parse a readline initialization file. The default filename is the last " "filename used." msgstr "" -#: ../src/Doc/library/readline.rst:54 +#: library/readline.rst:54 msgid "" "Load a readline history file. The default filename is :file:`~/.history`." msgstr "" -#: ../src/Doc/library/readline.rst:59 +#: library/readline.rst:59 msgid "" "Save a readline history file. The default filename is :file:`~/.history`." msgstr "" -#: ../src/Doc/library/readline.rst:64 +#: library/readline.rst:64 msgid "" "Clear the current history. (Note: this function is not available if the " "installed version of GNU readline doesn't support it.)" msgstr "" -#: ../src/Doc/library/readline.rst:72 +#: library/readline.rst:72 msgid "" "Return the desired length of the history file. Negative values imply " "unlimited history file size." msgstr "" -#: ../src/Doc/library/readline.rst:78 +#: library/readline.rst:78 msgid "" "Set the number of lines to save in the history file. :func:" "`write_history_file` uses this value to truncate the history file when " "saving. Negative values imply unlimited history file size." msgstr "" -#: ../src/Doc/library/readline.rst:85 +#: library/readline.rst:85 msgid "" "Return the number of lines currently in the history. (This is different " "from :func:`get_history_length`, which returns the maximum number of lines " "that will be written to a history file.)" msgstr "" -#: ../src/Doc/library/readline.rst:94 +#: library/readline.rst:94 msgid "Return the current contents of history item at *index*." msgstr "" -#: ../src/Doc/library/readline.rst:101 +#: library/readline.rst:101 msgid "Remove history item specified by its position from the history." msgstr "" -#: ../src/Doc/library/readline.rst:108 +#: library/readline.rst:108 msgid "Replace history item specified by its position with the given line." msgstr "" -#: ../src/Doc/library/readline.rst:115 +#: library/readline.rst:115 msgid "" "Change what's displayed on the screen to reflect the current contents of the " "line buffer." msgstr "" -#: ../src/Doc/library/readline.rst:123 +#: library/readline.rst:123 msgid "" "Set or remove the startup_hook function. If *function* is specified, it " "will be used as the new startup_hook function; if omitted or ``None``, any " @@ -82963,7 +84709,7 @@ msgid "" "called with no arguments just before readline prints the first prompt." msgstr "" -#: ../src/Doc/library/readline.rst:131 +#: library/readline.rst:131 msgid "" "Set or remove the pre_input_hook function. If *function* is specified, it " "will be used as the new pre_input_hook function; if omitted or ``None``, any " @@ -82972,7 +84718,7 @@ msgid "" "before readline starts reading input characters." msgstr "" -#: ../src/Doc/library/readline.rst:140 +#: library/readline.rst:140 msgid "" "Set or remove the completer function. If *function* is specified, it will " "be used as the new completer function; if omitted or ``None``, any completer " @@ -82982,33 +84728,33 @@ msgid "" "starting with *text*." msgstr "" -#: ../src/Doc/library/readline.rst:150 +#: library/readline.rst:150 msgid "" "Get the completer function, or ``None`` if no completer function has been " "set." msgstr "" -#: ../src/Doc/library/readline.rst:157 +#: library/readline.rst:157 msgid "Get the type of completion being attempted." msgstr "" -#: ../src/Doc/library/readline.rst:163 +#: library/readline.rst:163 msgid "Get the beginning index of the readline tab-completion scope." msgstr "" -#: ../src/Doc/library/readline.rst:168 +#: library/readline.rst:168 msgid "Get the ending index of the readline tab-completion scope." msgstr "" -#: ../src/Doc/library/readline.rst:173 +#: library/readline.rst:173 msgid "Set the readline word delimiters for tab-completion." msgstr "" -#: ../src/Doc/library/readline.rst:178 +#: library/readline.rst:178 msgid "Get the readline word delimiters for tab-completion." msgstr "" -#: ../src/Doc/library/readline.rst:182 +#: library/readline.rst:182 msgid "" "Set or remove the completion display function. If *function* is specified, " "it will be used as the new completion display function; if omitted or " @@ -83017,20 +84763,19 @@ msgid "" "longest_match_length)`` once each time matches need to be displayed." msgstr "" -#: ../src/Doc/library/readline.rst:193 +#: library/readline.rst:193 msgid "Append a line to the history buffer, as if it was the last line typed." msgstr "" -# dfd64475eaaf493c8df8e56c035945a8 -#: ../src/Doc/library/readline.rst:196 -msgid "Module :mod:`rlcompleter`" +#: library/readline.rst:197 +msgid "Module rlcompleter" msgstr "" -#: ../src/Doc/library/readline.rst:198 +#: library/readline.rst:198 msgid "Completion of Python identifiers at the interactive prompt." msgstr "" -#: ../src/Doc/library/readline.rst:206 +#: library/readline.rst:206 msgid "" "The following example demonstrates how to use the :mod:`readline` module's " "history reading and writing functions to automatically load and save a " @@ -83039,19 +84784,19 @@ msgid "" "from the user's :envvar:`PYTHONSTARTUP` file. ::" msgstr "" -#: ../src/Doc/library/readline.rst:223 +#: library/readline.rst:223 msgid "" "The following example extends the :class:`code.InteractiveConsole` class to " "support history save/restore. ::" msgstr "" # 5caf72beb5c64f2fb1b0c17c32fb4d27 -#: ../src/Doc/library/repr.rst:2 +#: library/repr.rst:2 msgid ":mod:`repr` --- Alternate :func:`repr` implementation" msgstr "" # c87b657504004834b9fee06df0d96145 -#: ../src/Doc/library/repr.rst:10 +#: library/repr.rst:10 msgid "" "The :mod:`repr` module has been renamed to :mod:`reprlib` in Python 3. The :" "term:`2to3` tool will automatically adapt imports when converting your " @@ -83059,24 +84804,24 @@ msgid "" msgstr "" # 00615105351a4edb8fd538acbaaebd1e -#: ../src/Doc/library/repr.rst:14 +#: library/repr.rst:14 msgid "**Source code:** :source:`Lib/repr.py`" msgstr "" # 038364b3e41240e68be584691cf40905 -#: ../src/Doc/library/repr.rst:18 +#: library/repr.rst:18 msgid "" "The :mod:`repr` module provides a means for producing object representations " "with limits on the size of the resulting strings. This is used in the Python " "debugger and may be useful in other contexts as well." msgstr "" -#: ../src/Doc/library/repr.rst:22 +#: library/repr.rst:22 msgid "This module provides a class, an instance, and a function:" msgstr "" # 02704d641c064974bb212cf8892ec0c3 -#: ../src/Doc/library/repr.rst:27 +#: library/repr.rst:27 msgid "" "Class which provides formatting services useful in implementing functions " "similar to the built-in :ref:`repr() `; size limits for different " @@ -83084,53 +84829,57 @@ msgid "" "excessively long." msgstr "" -#: ../src/Doc/library/repr.rst:35 +#: library/repr.rst:35 msgid "" "This is an instance of :class:`Repr` which is used to provide the :func:`." "repr` function described below. Changing the attributes of this object will " "affect the size limits used by :func:`.repr` and the Python debugger." msgstr "" -#: ../src/Doc/library/repr.rst:42 +#: library/repr.rst:42 msgid "" "This is the :meth:`~Repr.repr` method of ``aRepr``. It returns a string " "similar to that returned by the built-in function of the same name, but with " "limits on most sizes." msgstr "" -#: ../src/Doc/library/repr.rst:50 +#: library/repr.rst:50 msgid "Repr Objects" msgstr "" # fdf4c2635ae9468194ca464a4eb98b61 -#: ../src/Doc/library/repr.rst:52 +#: library/repr.rst:52 msgid "" ":class:`Repr` instances provide several attributes which can be used to " "provide size limits for the representations of different object types, and " "methods which format specific object types." msgstr "" -#: ../src/Doc/library/repr.rst:59 +#: library/repr.rst:59 msgid "" "Depth limit on the creation of recursive representations. The default is " "``6``." msgstr "" -#: ../src/Doc/library/repr.rst:70 +#: library/repr.rst:70 msgid "" "Limits on the number of entries represented for the named object type. The " "default is ``4`` for :attr:`maxdict`, ``5`` for :attr:`maxarray`, and ``6`` " "for the others." msgstr "" +#: library/repr.rst:74 +msgid ":attr:`maxset`, :attr:`maxfrozenset`, and :attr:`set`." +msgstr "" + # de6535e4cac84de1aef420ae11986ed5 -#: ../src/Doc/library/repr.rst:80 +#: library/repr.rst:80 msgid "" "Maximum number of characters in the representation for a long integer. " "Digits are dropped from the middle. The default is ``40``." msgstr "" -#: ../src/Doc/library/repr.rst:86 +#: library/repr.rst:86 msgid "" "Limit on the number of characters in the representation of the string. Note " "that the \"normal\" representation of the string is used as the character " @@ -83138,7 +84887,7 @@ msgid "" "mangled when the representation is shortened. The default is ``30``." msgstr "" -#: ../src/Doc/library/repr.rst:94 +#: library/repr.rst:94 msgid "" "This limit is used to control the size of object types for which no specific " "formatting method is available on the :class:`Repr` object. It is applied in " @@ -83146,13 +84895,13 @@ msgid "" msgstr "" # cc2d12bc9bc24a928c4a7981c0d44ff6 -#: ../src/Doc/library/repr.rst:101 +#: library/repr.rst:101 msgid "" "The equivalent to the built-in :ref:`repr() ` that uses the " "formatting imposed by the instance." msgstr "" -#: ../src/Doc/library/repr.rst:107 +#: library/repr.rst:107 msgid "" "Recursive implementation used by :meth:`.repr`. This uses the type of *obj* " "to determine which formatting method to call, passing it *obj* and *level*. " @@ -83161,7 +84910,7 @@ msgid "" "call." msgstr "" -#: ../src/Doc/library/repr.rst:116 +#: library/repr.rst:116 msgid "" "Formatting methods for specific types are implemented as methods with a name " "based on the type name. In the method name, **TYPE** is replaced by " @@ -83170,11 +84919,11 @@ msgid "" "recursively format a value should call ``self.repr1(subobj, level - 1)``." msgstr "" -#: ../src/Doc/library/repr.rst:126 +#: library/repr.rst:126 msgid "Subclassing Repr Objects" msgstr "" -#: ../src/Doc/library/repr.rst:128 +#: library/repr.rst:128 msgid "" "The use of dynamic dispatching by :meth:`Repr.repr1` allows subclasses of :" "class:`Repr` to add support for additional built-in object types or to " @@ -83182,37 +84931,37 @@ msgid "" "special support for file objects could be added::" msgstr "" -#: ../src/Doc/library/resource.rst:3 +#: library/resource.rst:3 msgid ":mod:`resource` --- Resource usage information" msgstr "" -#: ../src/Doc/library/resource.rst:12 +#: library/resource.rst:12 msgid "" "This module provides basic mechanisms for measuring and controlling system " "resources utilized by a program." msgstr "" -#: ../src/Doc/library/resource.rst:15 +#: library/resource.rst:15 msgid "" "Symbolic constants are used to specify particular system resources and to " "request usage information about either the current process or its children." msgstr "" -#: ../src/Doc/library/resource.rst:18 +#: library/resource.rst:18 msgid "A single exception is defined for errors:" msgstr "" -#: ../src/Doc/library/resource.rst:23 +#: library/resource.rst:23 msgid "" "The functions described below may raise this error if the underlying system " "call failures unexpectedly." msgstr "" -#: ../src/Doc/library/resource.rst:28 +#: library/resource.rst:28 msgid "Resource Limits" msgstr "" -#: ../src/Doc/library/resource.rst:30 +#: library/resource.rst:30 msgid "" "Resources usage can be limited using the :func:`setrlimit` function " "described below. Each resource is controlled by a pair of limits: a soft " @@ -83223,7 +84972,7 @@ msgid "" "super-user can raise a hard limit.)" msgstr "" -#: ../src/Doc/library/resource.rst:38 +#: library/resource.rst:38 msgid "" "The specific resources that can be limited are system dependent. They are " "described in the :manpage:`getrlimit(2)` man page. The resources listed " @@ -83233,11 +84982,11 @@ msgid "" msgstr "" # 720348d9b1cc453db0a54e4f91eed34b -#: ../src/Doc/library/resource.rst:47 +#: library/resource.rst:47 msgid "Constant used to represent the the limit for an unlimited resource." msgstr "" -#: ../src/Doc/library/resource.rst:52 +#: library/resource.rst:52 msgid "" "Returns a tuple ``(soft, hard)`` with the current soft and hard limits of " "*resource*. Raises :exc:`ValueError` if an invalid resource is specified, " @@ -83245,7 +84994,7 @@ msgid "" msgstr "" # 78e7b92e445a44fcbd27056a72012feb -#: ../src/Doc/library/resource.rst:59 +#: library/resource.rst:59 msgid "" "Sets new limits of consumption of *resource*. The *limits* argument must be " "a tuple ``(soft, hard)`` of two integers describing the new limits. A value " @@ -83254,7 +85003,7 @@ msgid "" msgstr "" # 22053ae869834a77a88b1d005c882c85 -#: ../src/Doc/library/resource.rst:64 +#: library/resource.rst:64 msgid "" "Raises :exc:`ValueError` if an invalid resource is specified, if the new " "soft limit exceeds the hard limit, or if a process tries to raise its hard " @@ -83266,20 +85015,20 @@ msgid "" msgstr "" # 351424acf4b44b35b741e0cab43ee030 -#: ../src/Doc/library/resource.rst:73 +#: library/resource.rst:73 msgid "" "``setrlimit`` may also raise :exc:`error` if the underlying system call " "fails." msgstr "" -#: ../src/Doc/library/resource.rst:76 +#: library/resource.rst:76 msgid "" "These symbols define resources whose consumption can be controlled using " "the :func:`setrlimit` and :func:`getrlimit` functions described below. The " "values of these symbols are exactly the constants used by C programs." msgstr "" -#: ../src/Doc/library/resource.rst:80 +#: library/resource.rst:80 msgid "" "The Unix man page for :manpage:`getrlimit(2)` lists the available resources. " "Note that not all systems use the same symbol or same value to denote the " @@ -83288,14 +85037,14 @@ msgid "" "module on that platform." msgstr "" -#: ../src/Doc/library/resource.rst:89 +#: library/resource.rst:89 msgid "" "The maximum size (in bytes) of a core file that the current process can " "create. This may result in the creation of a partial core file if a larger " "core would be required to contain the entire process image." msgstr "" -#: ../src/Doc/library/resource.rst:96 +#: library/resource.rst:96 msgid "" "The maximum amount of processor time (in seconds) that a process can use. If " "this limit is exceeded, a :const:`SIGXCPU` signal is sent to the process. " @@ -83303,60 +85052,60 @@ msgid "" "catch this signal and do something useful, e.g. flush open files to disk.)" msgstr "" -#: ../src/Doc/library/resource.rst:104 +#: library/resource.rst:104 msgid "" "The maximum size of a file which the process may create. This only affects " "the stack of the main thread in a multi-threaded process." msgstr "" -#: ../src/Doc/library/resource.rst:110 +#: library/resource.rst:110 msgid "The maximum size (in bytes) of the process's heap." msgstr "" -#: ../src/Doc/library/resource.rst:115 +#: library/resource.rst:115 msgid "The maximum size (in bytes) of the call stack for the current process." msgstr "" -#: ../src/Doc/library/resource.rst:120 +#: library/resource.rst:120 msgid "" "The maximum resident set size that should be made available to the process." msgstr "" -#: ../src/Doc/library/resource.rst:125 +#: library/resource.rst:125 msgid "The maximum number of processes the current process may create." msgstr "" -#: ../src/Doc/library/resource.rst:130 +#: library/resource.rst:130 msgid "The maximum number of open file descriptors for the current process." msgstr "" -#: ../src/Doc/library/resource.rst:135 +#: library/resource.rst:135 msgid "The BSD name for :const:`RLIMIT_NOFILE`." msgstr "" -#: ../src/Doc/library/resource.rst:140 +#: library/resource.rst:140 msgid "The maximum address space which may be locked in memory." msgstr "" -#: ../src/Doc/library/resource.rst:145 +#: library/resource.rst:145 msgid "The largest area of mapped memory which the process may occupy." msgstr "" -#: ../src/Doc/library/resource.rst:150 +#: library/resource.rst:150 msgid "" "The maximum area (in bytes) of address space which may be taken by the " "process." msgstr "" -#: ../src/Doc/library/resource.rst:154 +#: library/resource.rst:154 msgid "Resource Usage" msgstr "" -#: ../src/Doc/library/resource.rst:156 +#: library/resource.rst:156 msgid "These functions are used to retrieve resource usage information:" msgstr "" -#: ../src/Doc/library/resource.rst:161 +#: library/resource.rst:161 msgid "" "This function returns an object that describes the resources consumed by " "either the current process or its children, as specified by the *who* " @@ -83364,7 +85113,7 @@ msgid "" "`RUSAGE_\\*` constants described below." msgstr "" -#: ../src/Doc/library/resource.rst:166 +#: library/resource.rst:166 msgid "" "The fields of the return value each describe how a particular system " "resource has been used, e.g. amount of time spent running is user mode or " @@ -83373,13 +85122,13 @@ msgid "" "is using." msgstr "" -#: ../src/Doc/library/resource.rst:171 +#: library/resource.rst:171 msgid "" "For backward compatibility, the return value is also accessible as a tuple " "of 16 elements." msgstr "" -#: ../src/Doc/library/resource.rst:174 +#: library/resource.rst:174 msgid "" "The fields :attr:`ru_utime` and :attr:`ru_stime` of the return value are " "floating point values representing the amount of time spent executing in " @@ -83389,230 +85138,227 @@ msgid "" "summary is presented here:" msgstr "" -#: ../src/Doc/library/resource.rst:181 +#: library/resource.rst:181 msgid "Resource" msgstr "" -#: ../src/Doc/library/resource.rst:183 +#: library/resource.rst:183 msgid ":attr:`ru_utime`" msgstr "" -#: ../src/Doc/library/resource.rst:183 +#: library/resource.rst:183 msgid "time in user mode (float)" msgstr "" -#: ../src/Doc/library/resource.rst:185 +#: library/resource.rst:185 msgid ":attr:`ru_stime`" msgstr "" -#: ../src/Doc/library/resource.rst:185 +#: library/resource.rst:185 msgid "time in system mode (float)" msgstr "" -#: ../src/Doc/library/resource.rst:187 +#: library/resource.rst:187 msgid ":attr:`ru_maxrss`" msgstr "" -#: ../src/Doc/library/resource.rst:187 +#: library/resource.rst:187 msgid "maximum resident set size" msgstr "" -#: ../src/Doc/library/resource.rst:189 +#: library/resource.rst:189 msgid ":attr:`ru_ixrss`" msgstr "" -#: ../src/Doc/library/resource.rst:189 +#: library/resource.rst:189 msgid "shared memory size" msgstr "" -#: ../src/Doc/library/resource.rst:191 +#: library/resource.rst:191 msgid ":attr:`ru_idrss`" msgstr "" -#: ../src/Doc/library/resource.rst:191 +#: library/resource.rst:191 msgid "unshared memory size" msgstr "" -#: ../src/Doc/library/resource.rst:193 ../src/Doc/library/zipfile.rst:416 +#: library/resource.rst:193 library/zipfile.rst:418 msgid "``5``" msgstr "" -#: ../src/Doc/library/resource.rst:193 +#: library/resource.rst:193 msgid ":attr:`ru_isrss`" msgstr "" -#: ../src/Doc/library/resource.rst:193 +#: library/resource.rst:193 msgid "unshared stack size" msgstr "" -#: ../src/Doc/library/resource.rst:195 +#: library/resource.rst:195 msgid "``6``" msgstr "" -#: ../src/Doc/library/resource.rst:195 +#: library/resource.rst:195 msgid ":attr:`ru_minflt`" msgstr "" -#: ../src/Doc/library/resource.rst:195 +#: library/resource.rst:195 msgid "page faults not requiring I/O" msgstr "" -#: ../src/Doc/library/resource.rst:197 +#: library/resource.rst:197 msgid "``7``" msgstr "" -#: ../src/Doc/library/resource.rst:197 +#: library/resource.rst:197 msgid ":attr:`ru_majflt`" msgstr "" -#: ../src/Doc/library/resource.rst:197 +#: library/resource.rst:197 msgid "page faults requiring I/O" msgstr "" -#: ../src/Doc/library/resource.rst:199 +#: library/resource.rst:199 msgid "``8``" msgstr "" -#: ../src/Doc/library/resource.rst:199 +#: library/resource.rst:199 msgid ":attr:`ru_nswap`" msgstr "" -#: ../src/Doc/library/resource.rst:199 +#: library/resource.rst:199 msgid "number of swap outs" msgstr "" -#: ../src/Doc/library/resource.rst:201 +#: library/resource.rst:201 msgid "``9``" msgstr "" -#: ../src/Doc/library/resource.rst:201 +#: library/resource.rst:201 msgid ":attr:`ru_inblock`" msgstr "" -#: ../src/Doc/library/resource.rst:201 +#: library/resource.rst:201 msgid "block input operations" msgstr "" -#: ../src/Doc/library/resource.rst:203 +#: library/resource.rst:203 msgid "``10``" msgstr "" -#: ../src/Doc/library/resource.rst:203 +#: library/resource.rst:203 msgid ":attr:`ru_oublock`" msgstr "" -#: ../src/Doc/library/resource.rst:203 +#: library/resource.rst:203 msgid "block output operations" msgstr "" -#: ../src/Doc/library/resource.rst:205 +#: library/resource.rst:205 msgid "``11``" msgstr "" -#: ../src/Doc/library/resource.rst:205 +#: library/resource.rst:205 msgid ":attr:`ru_msgsnd`" msgstr "" -#: ../src/Doc/library/resource.rst:205 +#: library/resource.rst:205 msgid "messages sent" msgstr "" -#: ../src/Doc/library/resource.rst:207 +#: library/resource.rst:207 msgid "``12``" msgstr "" -#: ../src/Doc/library/resource.rst:207 +#: library/resource.rst:207 msgid ":attr:`ru_msgrcv`" msgstr "" -#: ../src/Doc/library/resource.rst:207 +#: library/resource.rst:207 msgid "messages received" msgstr "" -#: ../src/Doc/library/resource.rst:209 +#: library/resource.rst:209 msgid "``13``" msgstr "" -#: ../src/Doc/library/resource.rst:209 +#: library/resource.rst:209 msgid ":attr:`ru_nsignals`" msgstr "" -#: ../src/Doc/library/resource.rst:209 +#: library/resource.rst:209 msgid "signals received" msgstr "" -#: ../src/Doc/library/resource.rst:211 +#: library/resource.rst:211 msgid "``14``" msgstr "" -#: ../src/Doc/library/resource.rst:211 +#: library/resource.rst:211 msgid ":attr:`ru_nvcsw`" msgstr "" -#: ../src/Doc/library/resource.rst:211 +#: library/resource.rst:211 msgid "voluntary context switches" msgstr "" -#: ../src/Doc/library/resource.rst:213 +#: library/resource.rst:213 msgid "``15``" msgstr "" -#: ../src/Doc/library/resource.rst:213 +#: library/resource.rst:213 msgid ":attr:`ru_nivcsw`" msgstr "" -#: ../src/Doc/library/resource.rst:213 +#: library/resource.rst:213 msgid "involuntary context switches" msgstr "" -#: ../src/Doc/library/resource.rst:216 +#: library/resource.rst:216 msgid "" "This function will raise a :exc:`ValueError` if an invalid *who* parameter " "is specified. It may also raise :exc:`error` exception in unusual " "circumstances." msgstr "" -#: ../src/Doc/library/resource.rst:225 +#: library/resource.rst:225 msgid "" "Returns the number of bytes in a system page. (This need not be the same as " -"the hardware page size.) This function is useful for determining the number " -"of bytes of memory a process is using. The third element of the tuple " -"returned by :func:`getrusage` describes memory usage in pages; multiplying " -"by page size produces number of bytes." +"the hardware page size.)" msgstr "" -#: ../src/Doc/library/resource.rst:231 +#: library/resource.rst:228 msgid "" "The following :const:`RUSAGE_\\*` symbols are passed to the :func:" "`getrusage` function to specify which processes information should be " "provided for." msgstr "" -#: ../src/Doc/library/resource.rst:237 +#: library/resource.rst:234 msgid "" ":const:`RUSAGE_SELF` should be used to request information pertaining only " "to the process itself." msgstr "" -#: ../src/Doc/library/resource.rst:243 +#: library/resource.rst:240 msgid "" "Pass to :func:`getrusage` to request resource information for child " "processes of the calling process." msgstr "" -#: ../src/Doc/library/resource.rst:249 +#: library/resource.rst:246 msgid "" "Pass to :func:`getrusage` to request resources consumed by both the current " "process and child processes. May not be available on all systems." msgstr "" # 4fda6690f615453694b568c76c8c9337 -#: ../src/Doc/library/restricted.rst:6 +#: library/restricted.rst:6 msgid "Restricted Execution" msgstr "" # 6af7b12d5e6a43fcaed60fbb5cde12d7 -#: ../src/Doc/library/restricted.rst:10 +#: library/restricted.rst:10 msgid "" "In Python 2.3 these modules have been disabled due to various known and not " "readily fixable security holes. The modules are still documented here to " @@ -83621,7 +85367,7 @@ msgid "" msgstr "" # 46232b9a30504fb4b524dfebf90a9f60 -#: ../src/Doc/library/restricted.rst:14 +#: library/restricted.rst:14 msgid "" "*Restricted execution* is the basic framework in Python that allows for the " "segregation of trusted and untrusted code. The framework is based on the " @@ -83637,7 +85383,7 @@ msgid "" msgstr "" # d7b59980c1b4412594535d3ee3b83c05 -#: ../src/Doc/library/restricted.rst:25 +#: library/restricted.rst:25 msgid "" "An interesting aspect of Python's restricted execution model is that the " "interfaces presented to untrusted code usually have the same names as those " @@ -83658,7 +85404,7 @@ msgid "" msgstr "" # 83310294488b4d49bc8d310d8bcf62ac -#: ../src/Doc/library/restricted.rst:42 +#: library/restricted.rst:42 msgid "" "The Python run-time determines whether a particular code block is executing " "in restricted execution mode based on the identity of the ``__builtins__`` " @@ -83668,7 +85414,7 @@ msgid "" msgstr "" # be0d08d19dd44991b0870ff71b561683 -#: ../src/Doc/library/restricted.rst:48 +#: library/restricted.rst:48 msgid "" "Python code executing in restricted mode faces a number of limitations that " "are designed to prevent it from escaping from the padded cell. For instance, " @@ -83677,20 +85423,18 @@ msgid "" msgstr "" # df0e88812619400b96e71954bfff1fec -#: ../src/Doc/library/restricted.rst:53 +#: library/restricted.rst:53 msgid "" "Two modules provide the framework for setting up restricted execution " "environments:" msgstr "" -# d0bb2ede80d24cb19b287bf9cc1edc60 -# 39be768b173e4d729033976ab1d32943 -#: ../src/Doc/library/restricted.rst:65 ../src/Doc/library/rexec.rst:82 -msgid "`Grail Home Page `_" +#: library/restricted.rst:66 library/rexec.rst:83 +msgid "Grail Home Page" msgstr "" # 27258d0d801644ada24b24f3a4e0f344 -#: ../src/Doc/library/restricted.rst:65 +#: library/restricted.rst:65 msgid "" "Grail, an Internet browser written in Python, uses these modules to support " "Python applets. More information on the use of Python's restricted " @@ -83698,12 +85442,16 @@ msgid "" msgstr "" # b93ce96693634305b73dc00dfd21dacb -#: ../src/Doc/library/rexec.rst:2 +#: library/rexec.rst:2 msgid ":mod:`rexec` --- Restricted execution framework" msgstr "" +#: library/rexec.rst:8 +msgid "The :mod:`rexec` module has been removed in Python 3." +msgstr "" + # 799b827ae9344f8fb3a721fc2d170af1 -#: ../src/Doc/library/rexec.rst:19 +#: library/rexec.rst:19 msgid "" "This module contains the :class:`RExec` class, which supports :meth:" "`r_eval`, :meth:`r_execfile`, :meth:`r_exec`, and :meth:`r_import` methods, " @@ -83715,7 +85463,7 @@ msgid "" msgstr "" # c79666e21c644275bab4778484bfeb32 -#: ../src/Doc/library/rexec.rst:29 +#: library/rexec.rst:29 msgid "" "While the :mod:`rexec` module is designed to perform as described below, it " "does have a few known vulnerabilities which could be exploited by carefully " @@ -83727,7 +85475,7 @@ msgid "" msgstr "" # aaf297def6e3424e83bb121ec15bf84e -#: ../src/Doc/library/rexec.rst:39 +#: library/rexec.rst:39 msgid "" "The :class:`RExec` class can prevent code from performing unsafe operations " "like reading or writing disk files, or using TCP/IP sockets. However, it " @@ -83736,12 +85484,12 @@ msgid "" msgstr "" # 4465a0a3db834197a7bdc2f6eeb4f4b9 -#: ../src/Doc/library/rexec.rst:46 +#: library/rexec.rst:46 msgid "Returns an instance of the :class:`RExec` class." msgstr "" # 3dcfe7f798184390bbdc26970b6fb372 -#: ../src/Doc/library/rexec.rst:48 +#: library/rexec.rst:48 msgid "" "*hooks* is an instance of the :class:`RHooks` class or a subclass of it. If " "it is omitted or ``None``, the default :class:`RHooks` class is " @@ -83756,7 +85504,7 @@ msgid "" msgstr "" # 9cacec03758541ed8dc4f321e616d8f8 -#: ../src/Doc/library/rexec.rst:59 +#: library/rexec.rst:59 msgid "" "By providing an alternate :class:`RHooks` object, we can control the file " "system accesses made to import a module, without changing the actual " @@ -83768,14 +85516,14 @@ msgid "" msgstr "" # f0c3fded94b24582909f4f5dff94ec76 -#: ../src/Doc/library/rexec.rst:66 +#: library/rexec.rst:66 msgid "" "If *verbose* is true, additional debugging output may be sent to standard " "output." msgstr "" # 53457df0ffd7494f85302ea935575657 -#: ../src/Doc/library/rexec.rst:69 +#: library/rexec.rst:69 msgid "" "It is important to be aware that code running in a restricted environment " "can still call the :func:`sys.exit` function. To disallow restricted code " @@ -83789,7 +85537,7 @@ msgid "" msgstr "" # 3ffbf8e154354d6dacd6b201e384f5eb -#: ../src/Doc/library/rexec.rst:82 +#: library/rexec.rst:82 msgid "" "Grail is a Web browser written entirely in Python. It uses the :mod:`rexec` " "module as a foundation for supporting Python applets, and can be used as an " @@ -83797,17 +85545,17 @@ msgid "" msgstr "" # 429aea7ea07a402bb27c6d9617583299 -#: ../src/Doc/library/rexec.rst:90 +#: library/rexec.rst:90 msgid "RExec Objects" msgstr "" # 03cb54512e964345a634e53846e9e04b -#: ../src/Doc/library/rexec.rst:92 +#: library/rexec.rst:92 msgid ":class:`RExec` instances support the following methods:" msgstr "" # abb8abd120fc48d9b20fdedeac1c07fb -#: ../src/Doc/library/rexec.rst:97 +#: library/rexec.rst:97 msgid "" "*code* must either be a string containing a Python expression, or a compiled " "code object, which will be evaluated in the restricted environment's :mod:" @@ -83816,7 +85564,7 @@ msgid "" msgstr "" # 0c8bb1c24d6448059b6f2bcf456a82f2 -#: ../src/Doc/library/rexec.rst:105 +#: library/rexec.rst:105 msgid "" "*code* must either be a string containing one or more lines of Python code, " "or a compiled code object, which will be executed in the restricted " @@ -83824,14 +85572,14 @@ msgid "" msgstr "" # 59313694504040f8897f11c21e0b8f41 -#: ../src/Doc/library/rexec.rst:112 +#: library/rexec.rst:112 msgid "" "Execute the Python code contained in the file *filename* in the restricted " "environment's :mod:`__main__` module." msgstr "" # d31b1c574a364db297a250d407f6ba01 -#: ../src/Doc/library/rexec.rst:115 +#: library/rexec.rst:115 msgid "" "Methods whose names begin with ``s_`` are similar to the functions beginning " "with ``r_``, but the code will be granted access to restricted versions of " @@ -83839,28 +85587,28 @@ msgid "" msgstr "" # c1f80ed9beaf4d1a90ac2ee70d95769e -#: ../src/Doc/library/rexec.rst:122 +#: library/rexec.rst:122 msgid "" "*code* must be a string containing a Python expression, which will be " "evaluated in the restricted environment." msgstr "" # bf0c2cf509614ec680376eb626eda4f9 -#: ../src/Doc/library/rexec.rst:128 +#: library/rexec.rst:128 msgid "" "*code* must be a string containing one or more lines of Python code, which " "will be executed in the restricted environment." msgstr "" # b62fd1f4240b46bd89076762879ade15 -#: ../src/Doc/library/rexec.rst:134 +#: library/rexec.rst:134 msgid "" "Execute the Python code contained in the file *filename* in the restricted " "environment." msgstr "" # 3fb846db2dc44d258f431f9667986972 -#: ../src/Doc/library/rexec.rst:137 +#: library/rexec.rst:137 msgid "" ":class:`RExec` objects must also support various methods which will be " "implicitly called by code executing in the restricted environment. " @@ -83870,14 +85618,14 @@ msgstr "" # 8ce7b5553a374e5880ca0f4b235cd7f9 # 4c08b86cfab248e3974f65cd58ceabe3 -#: ../src/Doc/library/rexec.rst:145 ../src/Doc/library/rexec.rst:174 +#: library/rexec.rst:145 library/rexec.rst:174 msgid "" "Import the module *modulename*, raising an :exc:`ImportError` exception if " "the module is considered unsafe." msgstr "" # c338aa6d60874d6598b7a332d1b81be5 -#: ../src/Doc/library/rexec.rst:151 +#: library/rexec.rst:151 msgid "" "Method called when :func:`open` is called in the restricted environment. " "The arguments are identical to those of :func:`open`, and a file object (or " @@ -83889,34 +85637,34 @@ msgstr "" # 356749e82e4544978d8164bff2d2f0a4 # f3e20b014a6e440084128c8152f099d0 -#: ../src/Doc/library/rexec.rst:161 ../src/Doc/library/rexec.rst:180 +#: library/rexec.rst:161 library/rexec.rst:180 msgid "Reload the module object *module*, re-parsing and re-initializing it." msgstr "" # ae703620131d4d469571119b72dadaa0 -#: ../src/Doc/library/rexec.rst:166 +#: library/rexec.rst:166 msgid "" "Unload the module object *module* (remove it from the restricted " "environment's ``sys.modules`` dictionary)." msgstr "" # d2b211f45872482b9e38feeed4e3e9fc -#: ../src/Doc/library/rexec.rst:169 +#: library/rexec.rst:169 msgid "And their equivalents with access to restricted standard I/O streams:" msgstr "" # 7a0d05c7462b485daff64a4ca3db8564 -#: ../src/Doc/library/rexec.rst:185 +#: library/rexec.rst:185 msgid "Unload the module object *module*." msgstr "" # f515687167274592aa4ac4c6a61b2123 -#: ../src/Doc/library/rexec.rst:193 +#: library/rexec.rst:193 msgid "Defining restricted environments" msgstr "" # 0bc7f4e504604db2829dbf90206de61a -#: ../src/Doc/library/rexec.rst:195 +#: library/rexec.rst:195 msgid "" "The :class:`RExec` class has the following class attributes, which are used " "by the :meth:`__init__` method. Changing them on an existing instance won't " @@ -83926,7 +85674,7 @@ msgid "" msgstr "" # 85ac640021ed4df78bb50f708c0f1d03 -#: ../src/Doc/library/rexec.rst:204 +#: library/rexec.rst:204 msgid "" "Contains the names of built-in functions which will *not* be available to " "programs running in the restricted environment. The value for :class:" @@ -83939,7 +85687,7 @@ msgid "" msgstr "" # 364edd16e61e4b41836c62918a472556 -#: ../src/Doc/library/rexec.rst:215 +#: library/rexec.rst:215 msgid "" "Contains the names of built-in modules which can be safely imported. The " "value for :class:`RExec` is ``('audioop', 'array', 'binascii', 'cmath', " @@ -83950,7 +85698,7 @@ msgid "" msgstr "" # ee455371c2c942e3a41bc2b6c9d50c62 -#: ../src/Doc/library/rexec.rst:224 +#: library/rexec.rst:224 msgid "" "Contains the directories which will be searched when an :keyword:`import` is " "performed in the restricted environment. The value for :class:`RExec` is " @@ -83959,7 +85707,7 @@ msgid "" msgstr "" # 457b8692e7574e00ad3a8537ecece3d9 -#: ../src/Doc/library/rexec.rst:231 +#: library/rexec.rst:231 msgid "" "Contains the names of the functions in the :mod:`os` module which will be " "available to programs running in the restricted environment. The value for :" @@ -83969,7 +85717,7 @@ msgid "" msgstr "" # 566f612cabd5473b9cb4a3d5f165d02a -#: ../src/Doc/library/rexec.rst:242 +#: library/rexec.rst:242 msgid "" "Contains the names of the functions and variables in the :mod:`sys` module " "which will be available to programs running in the restricted environment. " @@ -83978,7 +85726,7 @@ msgid "" msgstr "" # a3c7fedb4612401c9d39b3eb6e51d4d6 -#: ../src/Doc/library/rexec.rst:250 +#: library/rexec.rst:250 msgid "" "Contains the file types from which modules are allowed to be loaded. Each " "file type is an integer constant defined in the :mod:`imp` module. The " @@ -83992,12 +85740,12 @@ msgid "" msgstr "" # c4ba55cfae364031b544a64dab727cd3 -#: ../src/Doc/library/rexec.rst:262 +#: library/rexec.rst:262 msgid "An example" msgstr "" # 20ee15dbfadf44038ed830eb283b4cf1 -#: ../src/Doc/library/rexec.rst:264 +#: library/rexec.rst:264 msgid "" "Let us say that we want a slightly more relaxed policy than the standard :" "class:`RExec` class. For example, if we're willing to allow files in :file:" @@ -84005,7 +85753,7 @@ msgid "" msgstr "" # b2621776a09749e2bc055e31f73bc4ed -#: ../src/Doc/library/rexec.rst:282 +#: library/rexec.rst:282 msgid "" "Notice that the above code will occasionally forbid a perfectly valid " "filename; for example, code in the restricted environment won't be able to " @@ -84018,12 +85766,19 @@ msgid "" msgstr "" # 5c9c08feae0347edb16ccb1db8adcb61 -#: ../src/Doc/library/rfc822.rst:3 +#: library/rfc822.rst:3 msgid ":mod:`rfc822` --- Parse RFC 2822 mail headers" msgstr "" +#: library/rfc822.rst:10 +msgid "" +"The :mod:`email` package should be used in preference to the :mod:`rfc822` " +"module. This module is present only to maintain backward compatibility, and " +"has been removed in Python 3." +msgstr "" + # 73e2f2b5dd064cd4a2d72c570105112d -#: ../src/Doc/library/rfc822.rst:15 +#: library/rfc822.rst:15 msgid "" "This module defines a class, :class:`Message`, which represents an \"email " "message\" as defined by the Internet standard :rfc:`2822`. [#]_ Such " @@ -84034,14 +85789,14 @@ msgid "" msgstr "" # 5625bab0970148c0874844f46a4f24a1 -#: ../src/Doc/library/rfc822.rst:24 +#: library/rfc822.rst:24 msgid "" "The :mod:`mailbox` module provides classes to read mailboxes produced by " "various end-user mail programs." msgstr "" # bcc482b0ff4342778e386e23e7d0c84b -#: ../src/Doc/library/rfc822.rst:30 +#: library/rfc822.rst:30 msgid "" "A :class:`Message` instance is instantiated with an input object as " "parameter. Message relies only on the input object having a :meth:`readline` " @@ -84052,7 +85807,7 @@ msgid "" msgstr "" # fb99a66192b0468b9fdc16045273be06 -#: ../src/Doc/library/rfc822.rst:36 +#: library/rfc822.rst:36 msgid "" "This class can work with any input object that supports a :meth:`readline` " "method. If the input object has seek and tell capability, the :meth:" @@ -84064,7 +85819,7 @@ msgid "" msgstr "" # 692a15a2c4e4473db5ca5c51cc331f01 -#: ../src/Doc/library/rfc822.rst:44 +#: library/rfc822.rst:44 msgid "" "The optional *seekable* argument is provided as a workaround for certain " "stdio libraries in which :c:func:`tell` discards buffered data before " @@ -84075,7 +85830,7 @@ msgid "" msgstr "" # c6b9fb18b2304255b63919bae679201e -#: ../src/Doc/library/rfc822.rst:51 +#: library/rfc822.rst:51 msgid "" "Input lines as read from the file may either be terminated by CR-LF or by a " "single linefeed; a terminating CR-LF is replaced by a single linefeed before " @@ -84083,14 +85838,14 @@ msgid "" msgstr "" # 96d7e8dbb175456b9267c5a17cbf4e3e -#: ../src/Doc/library/rfc822.rst:55 +#: library/rfc822.rst:55 msgid "" "All header matching is done independent of upper or lower case; e.g. " "``m['From']``, ``m['from']`` and ``m['FROM']`` all yield the same result." msgstr "" # 4408aeb93e6a448f9b4280be0458fb62 -#: ../src/Doc/library/rfc822.rst:61 +#: library/rfc822.rst:61 msgid "" "You may instantiate the :class:`AddressList` helper class using a single " "string parameter, a comma-separated list of :rfc:`2822` addresses to be " @@ -84098,14 +85853,14 @@ msgid "" msgstr "" # 2fdf4476e1b04bdeb0addd42f06e55de -#: ../src/Doc/library/rfc822.rst:68 +#: library/rfc822.rst:68 msgid "" "Return a new string with backslashes in *str* replaced by two backslashes " "and double quotes replaced by backslash-double quote." msgstr "" # c152cb8983744c489595e19cc551f8bc -#: ../src/Doc/library/rfc822.rst:81 +#: library/rfc822.rst:81 msgid "" "Parse *address*, which should be the value of some address-containing field " "such as :mailheader:`To` or :mailheader:`Cc`, into its constituent \"realname" @@ -84114,7 +85869,7 @@ msgid "" msgstr "" # 8d0e4af7a87a482b88c20e9a1f433bc0 -#: ../src/Doc/library/rfc822.rst:97 +#: library/rfc822.rst:97 msgid "" "Attempts to parse a date according to the rules in :rfc:`2822`. however, " "some mailers don't follow that format as specified, so :func:`parsedate` " @@ -84126,7 +85881,7 @@ msgid "" msgstr "" # e440c503ba80475aa062fbc0eb0f117f -#: ../src/Doc/library/rfc822.rst:108 +#: library/rfc822.rst:108 msgid "" "Performs the same function as :func:`parsedate`, but returns either ``None`` " "or a 10-tuple; the first 9 elements make up a tuple that can be passed " @@ -84140,7 +85895,7 @@ msgid "" msgstr "" # a898d9a29572411baf5d67af0e98e92a -#: ../src/Doc/library/rfc822.rst:121 +#: library/rfc822.rst:121 msgid "" "Turn a 10-tuple as returned by :func:`parsedate_tz` into a UTC timestamp. " "If the timezone item in the tuple is ``None``, assume local time. Minor " @@ -84151,46 +85906,45 @@ msgid "" msgstr "" # 22c313d977aa4521a7772c8b45f06d6b -#: ../src/Doc/library/rfc822.rst:131 +#: library/rfc822.rst:131 msgid "" "Comprehensive email handling package; supersedes the :mod:`rfc822` module." msgstr "" -# 6ef0ff14566846a4a71041eb1c347782 -#: ../src/Doc/library/rfc822.rst:133 -msgid "Module :mod:`mailbox`" +#: library/rfc822.rst:134 +msgid "Module mailbox" msgstr "" # a845a1fbf8264efc8df207bed84e4563 -#: ../src/Doc/library/rfc822.rst:134 +#: library/rfc822.rst:134 msgid "" "Classes to read various mailbox formats produced by end-user mail programs." msgstr "" -# f17765a8177344148d8d82b873853331 -#: ../src/Doc/library/rfc822.rst:135 -msgid "Module :mod:`mimetools`" -msgstr "" +#: library/rfc822.rst:136 +#, fuzzy +msgid "Module mimetools" +msgstr "Modules" # 61592935bc3d41ffad44a29ee90f17c1 -#: ../src/Doc/library/rfc822.rst:137 +#: library/rfc822.rst:137 msgid "Subclass of :class:`rfc822.Message` that handles MIME encoded messages." msgstr "" # b3794a80b0764177843562266394e426 -#: ../src/Doc/library/rfc822.rst:145 +#: library/rfc822.rst:145 msgid "A :class:`Message` instance has the following methods:" msgstr "" # e36f1f5db05d425db991c9093bab691a -#: ../src/Doc/library/rfc822.rst:150 +#: library/rfc822.rst:150 msgid "" "Seek to the start of the message body. This only works if the file object " "is seekable." msgstr "" # 22d3227801ec4b9bbd5c801c289635e8 -#: ../src/Doc/library/rfc822.rst:156 +#: library/rfc822.rst:156 msgid "" "Returns a line's canonicalized fieldname (the dictionary key that will be " "used to index it) if the line is a legal :rfc:`2822` header; otherwise " @@ -84200,7 +85954,7 @@ msgid "" msgstr "" # 3f081228b66043df9cd353a603b30d35 -#: ../src/Doc/library/rfc822.rst:165 +#: library/rfc822.rst:165 msgid "" "Return true if the given line is a delimiter on which Message should stop. " "The delimiter line is consumed, and the file object's read location " @@ -84209,7 +85963,7 @@ msgid "" msgstr "" # 45acd7d706344ed997cd4b2d204424bb -#: ../src/Doc/library/rfc822.rst:173 +#: library/rfc822.rst:173 msgid "" "Return ``True`` if the given line should be ignored entirely, just skipped. " "By default this is a stub that always returns ``False``, but you can " @@ -84217,7 +85971,7 @@ msgid "" msgstr "" # cb47cc9e860f40f4836c5b659d52b8cd -#: ../src/Doc/library/rfc822.rst:180 +#: library/rfc822.rst:180 msgid "" "Return a list of lines consisting of all headers matching *name*, if any. " "Each physical line, whether it is a continuation line or not, is a separate " @@ -84225,7 +85979,7 @@ msgid "" msgstr "" # ce3902685bf44379acf16967a978d33d -#: ../src/Doc/library/rfc822.rst:187 +#: library/rfc822.rst:187 msgid "" "Return a list of lines comprising the first header matching *name*, and its " "continuation line(s), if any. Return ``None`` if there is no header " @@ -84233,7 +85987,7 @@ msgid "" msgstr "" # d9e20263544441d19f0c3045b4111bdc -#: ../src/Doc/library/rfc822.rst:194 +#: library/rfc822.rst:194 msgid "" "Return a single string consisting of the text after the colon in the first " "header matching *name*. This includes leading whitespace, the trailing " @@ -84242,7 +85996,7 @@ msgid "" msgstr "" # 2c7ee91be4a14119afc7f9f57e1e8805 -#: ../src/Doc/library/rfc822.rst:202 +#: library/rfc822.rst:202 msgid "" "Return a single string consisting of the last header matching *name*, but " "strip leading and trailing whitespace. Internal whitespace is not stripped. " @@ -84252,14 +86006,14 @@ msgid "" msgstr "" # b58e86d04e5a4b4bba312cfb9b0c1709 -#: ../src/Doc/library/rfc822.rst:212 +#: library/rfc822.rst:212 msgid "" "An alias for :meth:`getheader`, to make the interface more compatible with " "regular dictionaries." msgstr "" # 6627d74996124d28b69b436eb4650a96 -#: ../src/Doc/library/rfc822.rst:218 +#: library/rfc822.rst:218 msgid "" "Return a pair ``(full name, email address)`` parsed from the string returned " "by ``getheader(name)``. If no header matching *name* exists, return " @@ -84268,7 +86022,7 @@ msgid "" msgstr "" # 26baae1868864e239d25478f4f06fdff -#: ../src/Doc/library/rfc822.rst:223 +#: library/rfc822.rst:223 msgid "" "Example: If *m*'s first :mailheader:`From` header contains the string " "``'jack@cwi.nl (Jack Jansen)'``, then ``m.getaddr('From')`` will yield the " @@ -84277,7 +86031,7 @@ msgid "" msgstr "" # 4694538300b94fe48aa20a7b4e174003 -#: ../src/Doc/library/rfc822.rst:231 +#: library/rfc822.rst:231 msgid "" "This is similar to ``getaddr(list)``, but parses a header containing a list " "of email addresses (e.g. a :mailheader:`To` header) and returns a list of " @@ -84286,7 +86040,7 @@ msgid "" msgstr "" # c234cc45fb604e27a76dd8faec9100c2 -#: ../src/Doc/library/rfc822.rst:236 +#: library/rfc822.rst:236 msgid "" "If multiple headers exist that match the named header (e.g. if there are " "several :mailheader:`Cc` headers), all are parsed for addresses. Any " @@ -84294,7 +86048,7 @@ msgid "" msgstr "" # 1161cda257cc4aa48f44a708e9059daf -#: ../src/Doc/library/rfc822.rst:243 +#: library/rfc822.rst:243 msgid "" "Retrieve a header using :meth:`getheader` and parse it into a 9-tuple " "compatible with :func:`time.mktime`; note that fields 6, 7, and 8 are not " @@ -84303,7 +86057,7 @@ msgid "" msgstr "" # be8aeb2c0765463f9ce6134cf8aad97b -#: ../src/Doc/library/rfc822.rst:247 +#: library/rfc822.rst:247 msgid "" "Date parsing appears to be a black art, and not all mailers adhere to the " "standard. While it has been tested and found correct on a large collection " @@ -84312,7 +86066,7 @@ msgid "" msgstr "" # 5584cfcf6ee54b0692db7ba30d9cce81 -#: ../src/Doc/library/rfc822.rst:255 +#: library/rfc822.rst:255 msgid "" "Retrieve a header using :meth:`getheader` and parse it into a 10-tuple; the " "first 9 elements will make a tuple compatible with :func:`time.mktime`, and " @@ -84322,7 +86076,7 @@ msgid "" msgstr "" # 91bbfbbf7cdb4286958fe0c737e2fc03 -#: ../src/Doc/library/rfc822.rst:261 +#: library/rfc822.rst:261 msgid "" ":class:`Message` instances also support a limited mapping interface. In " "particular: ``m[name]`` is like ``m.getheader(name)`` but raises :exc:" @@ -84338,13 +86092,13 @@ msgid "" msgstr "" # 7aba61bfe70c4c5584d54ad45bd411fb -#: ../src/Doc/library/rfc822.rst:273 +#: library/rfc822.rst:273 msgid "" "Finally, :class:`Message` instances have some public instance variables:" msgstr "" # 36e60645c5d44944bf830eb9d7ad6c6e -#: ../src/Doc/library/rfc822.rst:278 +#: library/rfc822.rst:278 msgid "" "A list containing the entire set of header lines, in the order in which they " "were read (except that setitem calls may disturb this order). Each line " @@ -84353,14 +86107,14 @@ msgid "" msgstr "" # a138608c4db24ff08b41058b05e6a8b3 -#: ../src/Doc/library/rfc822.rst:286 +#: library/rfc822.rst:286 msgid "" "The file or file-like object passed at instantiation time. This can be used " "to read the message content." msgstr "" # 1958b30db3c847acaf77e68dcb203bcb -#: ../src/Doc/library/rfc822.rst:292 +#: library/rfc822.rst:292 msgid "" "The Unix ``From`` line, if the message had one, or an empty string. This is " "needed to regenerate the message in some contexts, such as an ``mbox``\\ -" @@ -84368,43 +86122,43 @@ msgid "" msgstr "" # 9e49195c36854f3d80099da316a7bb3c -#: ../src/Doc/library/rfc822.rst:300 +#: library/rfc822.rst:300 msgid "AddressList Objects" msgstr "" # a751b9c5793540808faf026ad9e99a21 -#: ../src/Doc/library/rfc822.rst:302 +#: library/rfc822.rst:302 msgid "An :class:`AddressList` instance has the following methods:" msgstr "" # b6c24d29bda848edaf750b43fd95c915 -#: ../src/Doc/library/rfc822.rst:307 +#: library/rfc822.rst:307 msgid "Return the number of addresses in the address list." msgstr "" # f55eabf3fed0449987b7511efae0f87c -#: ../src/Doc/library/rfc822.rst:312 +#: library/rfc822.rst:312 msgid "" "Return a canonicalized string representation of the address list. Addresses " "are rendered in \"name\" form, comma-separated." msgstr "" # 8d2e63870a3340e59685e82acb0b7ea6 -#: ../src/Doc/library/rfc822.rst:318 +#: library/rfc822.rst:318 msgid "" "Return a new :class:`AddressList` instance that contains all addresses in " "both :class:`AddressList` operands, with duplicates removed (set union)." msgstr "" # e235d7f0cb6b4fd2b6d6dea35562cff4 -#: ../src/Doc/library/rfc822.rst:324 +#: library/rfc822.rst:324 msgid "" "In-place version of :meth:`__add__`; turns this :class:`AddressList` " "instance into the union of itself and the right-hand instance, *alist*." msgstr "" # 7738c9b1c1ba4344a6df16c7c013bf41 -#: ../src/Doc/library/rfc822.rst:330 +#: library/rfc822.rst:330 msgid "" "Return a new :class:`AddressList` instance that contains every address in " "the left-hand :class:`AddressList` operand that is not present in the right-" @@ -84412,20 +86166,20 @@ msgid "" msgstr "" # 47024b89196c4b46b5450b24a77d79da -#: ../src/Doc/library/rfc822.rst:337 +#: library/rfc822.rst:337 msgid "" "In-place version of :meth:`__sub__`, removing addresses in this list which " "are also in *alist*." msgstr "" # fc544786e1ef4c10bd089c5185f805ff -#: ../src/Doc/library/rfc822.rst:340 +#: library/rfc822.rst:340 msgid "" "Finally, :class:`AddressList` instances have one public instance variable:" msgstr "" # 670899912d5c49ea9f231b6f165e4cd5 -#: ../src/Doc/library/rfc822.rst:345 +#: library/rfc822.rst:345 msgid "" "A list of tuple string pairs, one per address. In each member, the first is " "the canonicalized name part, the second is the actual route-address (``'@'``" @@ -84433,7 +86187,7 @@ msgid "" msgstr "" # 98fd4c4ac99b4b3f83e7b28d9a7a5e48 -#: ../src/Doc/library/rfc822.rst:351 +#: library/rfc822.rst:351 msgid "" "This module originally conformed to :rfc:`822`, hence the name. Since " "then, :rfc:`2822` has been released as an update to :rfc:`822`. This module " @@ -84441,23 +86195,23 @@ msgid "" "the syntax or semantics have changed since :rfc:`822`." msgstr "" -#: ../src/Doc/library/rlcompleter.rst:2 +#: library/rlcompleter.rst:2 msgid ":mod:`rlcompleter` --- Completion function for GNU readline" msgstr "" # 17e14a879e464fae89219b098311583d -#: ../src/Doc/library/rlcompleter.rst:8 +#: library/rlcompleter.rst:8 msgid "**Source code:** :source:`Lib/rlcompleter.py`" msgstr "" -#: ../src/Doc/library/rlcompleter.rst:12 +#: library/rlcompleter.rst:12 msgid "" "The :mod:`rlcompleter` module defines a completion function suitable for " "the :mod:`readline` module by completing valid Python identifiers and " "keywords." msgstr "" -#: ../src/Doc/library/rlcompleter.rst:15 +#: library/rlcompleter.rst:15 msgid "" "When this module is imported on a Unix platform with the :mod:`readline` " "module available, an instance of the :class:`Completer` class is " @@ -84465,7 +86219,7 @@ msgid "" "`readline` completer." msgstr "" -#: ../src/Doc/library/rlcompleter.rst:30 +#: library/rlcompleter.rst:30 msgid "" "The :mod:`rlcompleter` module is designed for use with Python's interactive " "mode. A user can add the following lines to his or her initialization file " @@ -84473,33 +86227,33 @@ msgid "" "automatic :kbd:`Tab` completion::" msgstr "" -#: ../src/Doc/library/rlcompleter.rst:43 +#: library/rlcompleter.rst:43 msgid "" "On platforms without :mod:`readline`, the :class:`Completer` class defined " "by this module can still be used for custom purposes." msgstr "" -#: ../src/Doc/library/rlcompleter.rst:50 +#: library/rlcompleter.rst:50 msgid "Completer Objects" msgstr "" -#: ../src/Doc/library/rlcompleter.rst:52 +#: library/rlcompleter.rst:52 msgid "Completer objects have the following method:" msgstr "" -#: ../src/Doc/library/rlcompleter.rst:57 +#: library/rlcompleter.rst:57 msgid "Return the *state*\\ th completion for *text*." msgstr "" # 3fa4d4416d19455a9cd018abae107b39 -#: ../src/Doc/library/rlcompleter.rst:59 +#: library/rlcompleter.rst:59 msgid "" "If called for *text* that doesn't include a period character (``'.'``), it " "will complete from names currently defined in :mod:`__main__`, :mod:" "`__builtin__` and keywords (as defined by the :mod:`keyword` module)." msgstr "" -#: ../src/Doc/library/rlcompleter.rst:63 +#: library/rlcompleter.rst:63 msgid "" "If called for a dotted name, it will try to evaluate anything without " "obvious side-effects (functions will not be evaluated, but it can generate " @@ -84510,19 +86264,19 @@ msgid "" msgstr "" # e54a78a3edcc41afbaabbc0d5c3dc861 -#: ../src/Doc/library/robotparser.rst:3 +#: library/robotparser.rst:3 msgid ":mod:`robotparser` --- Parser for robots.txt" msgstr "" # 68c92b1c5394487d8dbad1c4414113e6 -#: ../src/Doc/library/robotparser.rst:18 +#: library/robotparser.rst:18 msgid "" "The :mod:`robotparser` module has been renamed :mod:`urllib.robotparser` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " "converting your sources to Python 3." msgstr "" -#: ../src/Doc/library/robotparser.rst:23 +#: library/robotparser.rst:23 msgid "" "This module provides a single class, :class:`RobotFileParser`, which answers " "questions about whether or not a particular user agent can fetch a URL on " @@ -84532,58 +86286,58 @@ msgid "" msgstr "" # 9bbbba70e6924e908db40cdfb705c72b -#: ../src/Doc/library/robotparser.rst:31 +#: library/robotparser.rst:31 msgid "" "This class provides methods to read, parse and answer questions about the :" "file:`robots.txt` file at *url*." msgstr "" -#: ../src/Doc/library/robotparser.rst:37 +#: library/robotparser.rst:37 msgid "Sets the URL referring to a :file:`robots.txt` file." msgstr "" -#: ../src/Doc/library/robotparser.rst:42 +#: library/robotparser.rst:42 msgid "Reads the :file:`robots.txt` URL and feeds it to the parser." msgstr "" -#: ../src/Doc/library/robotparser.rst:47 +#: library/robotparser.rst:47 msgid "Parses the lines argument." msgstr "" -#: ../src/Doc/library/robotparser.rst:52 +#: library/robotparser.rst:52 msgid "" "Returns ``True`` if the *useragent* is allowed to fetch the *url* according " "to the rules contained in the parsed :file:`robots.txt` file." msgstr "" -#: ../src/Doc/library/robotparser.rst:59 +#: library/robotparser.rst:59 msgid "" "Returns the time the ``robots.txt`` file was last fetched. This is useful " "for long-running web spiders that need to check for new ``robots.txt`` files " "periodically." msgstr "" -#: ../src/Doc/library/robotparser.rst:66 +#: library/robotparser.rst:66 msgid "" "Sets the time the ``robots.txt`` file was last fetched to the current time." msgstr "" # f72ee2df2fff49f6a598049e4fd4fa7c -#: ../src/Doc/library/robotparser.rst:69 +#: library/robotparser.rst:69 msgid "" "The following example demonstrates basic use of the RobotFileParser class. ::" msgstr "" -#: ../src/Doc/library/runpy.rst:2 +#: library/runpy.rst:2 msgid ":mod:`runpy` --- Locating and executing Python modules" msgstr "" # 4d09e4d8c2e844349b1567cedad4267b -#: ../src/Doc/library/runpy.rst:11 +#: library/runpy.rst:11 msgid "**Source code:** :source:`Lib/runpy.py`" msgstr "" -#: ../src/Doc/library/runpy.rst:15 +#: library/runpy.rst:15 msgid "" "The :mod:`runpy` module is used to locate and run Python modules without " "importing them first. Its main use is to implement the :option:`-m` command " @@ -84591,11 +86345,11 @@ msgid "" "namespace rather than the filesystem." msgstr "" -#: ../src/Doc/library/runpy.rst:20 +#: library/runpy.rst:20 msgid "The :mod:`runpy` module provides two functions:" msgstr "" -#: ../src/Doc/library/runpy.rst:28 +#: library/runpy.rst:28 msgid "" "Execute the code of the specified module and return the resulting module " "globals dictionary. The module's code is first located using the standard " @@ -84603,7 +86357,7 @@ msgid "" "fresh module namespace." msgstr "" -#: ../src/Doc/library/runpy.rst:33 +#: library/runpy.rst:33 msgid "" "If the supplied module name refers to a package rather than a normal module, " "then that package is imported and the ``__main__`` submodule within that " @@ -84611,7 +86365,7 @@ msgid "" "returned." msgstr "" -#: ../src/Doc/library/runpy.rst:38 +#: library/runpy.rst:38 msgid "" "The optional dictionary argument *init_globals* may be used to pre-populate " "the module's globals dictionary before the code is executed. The supplied " @@ -84620,7 +86374,7 @@ msgid "" "overridden by :func:`run_module`." msgstr "" -#: ../src/Doc/library/runpy.rst:44 ../src/Doc/library/runpy.rst:106 +#: library/runpy.rst:44 library/runpy.rst:109 msgid "" "The special global variables ``__name__``, ``__file__``, ``__loader__`` and " "``__package__`` are set in the globals dictionary before the module code is " @@ -84628,34 +86382,34 @@ msgid "" "be set implicitly as an interpreter implementation detail)." msgstr "" -#: ../src/Doc/library/runpy.rst:49 +#: library/runpy.rst:49 msgid "" "``__name__`` is set to *run_name* if this optional argument is not :const:" "`None`, to ``mod_name + '.__main__'`` if the named module is a package and " "to the *mod_name* argument otherwise." msgstr "" -#: ../src/Doc/library/runpy.rst:53 +#: library/runpy.rst:53 msgid "" "``__file__`` is set to the name provided by the module loader. If the loader " "does not make filename information available, this variable is set to :const:" "`None`." msgstr "" -#: ../src/Doc/library/runpy.rst:57 +#: library/runpy.rst:57 msgid "" "``__loader__`` is set to the :pep:`302` module loader used to retrieve the " "code for the module (This loader may be a wrapper around the standard import " "mechanism)." msgstr "" -#: ../src/Doc/library/runpy.rst:61 +#: library/runpy.rst:61 msgid "" "``__package__`` is set to *mod_name* if the named module is a package and to " "``mod_name.rpartition('.')[0]`` otherwise." msgstr "" -#: ../src/Doc/library/runpy.rst:64 +#: library/runpy.rst:64 msgid "" "If the argument *alter_sys* is supplied and evaluates to :const:`True`, then " "``sys.argv[0]`` is updated with the value of ``__file__`` and ``sys." @@ -84664,7 +86418,7 @@ msgid "" "restored to their original values before the function returns." msgstr "" -#: ../src/Doc/library/runpy.rst:70 +#: library/runpy.rst:70 msgid "" "Note that this manipulation of :mod:`sys` is not thread-safe. Other threads " "may see the partially initialised module, as well as the altered list of " @@ -84672,7 +86426,18 @@ msgid "" "invoking this function from threaded code." msgstr "" -#: ../src/Doc/library/runpy.rst:86 +#: library/runpy.rst:76 +msgid "" +"The :option:`-m` option offering equivalent functionality from the command " +"line." +msgstr "" + +#: library/runpy.rst:79 +msgid "" +"Added ability to execute packages by looking for a ``__main__`` submodule" +msgstr "" + +#: library/runpy.rst:89 msgid "" "Execute the code at the named filesystem location and return the resulting " "module globals dictionary. As with a script name supplied to the CPython " @@ -84681,7 +86446,7 @@ msgid "" "module (e.g. a zipfile containing a top-level ``__main__.py`` file)." msgstr "" -#: ../src/Doc/library/runpy.rst:92 +#: library/runpy.rst:95 msgid "" "For a simple script, the specified code is simply executed in a fresh module " "namespace. For a valid sys.path entry (typically a zipfile or directory), " @@ -84692,7 +86457,7 @@ msgid "" "module at the specified location." msgstr "" -#: ../src/Doc/library/runpy.rst:100 +#: library/runpy.rst:103 msgid "" "The optional dictionary argument *init_globals* may be used to pre-populate " "the module's globals dictionary before the code is executed. The supplied " @@ -84701,31 +86466,31 @@ msgid "" "overridden by :func:`run_path`." msgstr "" -#: ../src/Doc/library/runpy.rst:111 +#: library/runpy.rst:114 msgid "" "``__name__`` is set to *run_name* if this optional argument is not :const:" "`None` and to ``''`` otherwise." msgstr "" -#: ../src/Doc/library/runpy.rst:114 +#: library/runpy.rst:117 msgid "" "``__file__`` is set to the name provided by the module loader. If the loader " "does not make filename information available, this variable is set to :const:" "`None`. For a simple script, this will be set to ``file_path``." msgstr "" -#: ../src/Doc/library/runpy.rst:118 +#: library/runpy.rst:121 msgid "" "``__loader__`` is set to the :pep:`302` module loader used to retrieve the " "code for the module (This loader may be a wrapper around the standard import " "mechanism). For a simple script, this will be set to :const:`None`." msgstr "" -#: ../src/Doc/library/runpy.rst:122 +#: library/runpy.rst:125 msgid "``__package__`` is set to ``__name__.rpartition('.')[0]``." msgstr "" -#: ../src/Doc/library/runpy.rst:124 +#: library/runpy.rst:127 msgid "" "A number of alterations are also made to the :mod:`sys` module. Firstly, " "``sys.path`` may be altered as described above. ``sys.argv[0]`` is updated " @@ -84736,7 +86501,7 @@ msgid "" msgstr "" # 753dc60f269945d7b875a506b02b1b3a -#: ../src/Doc/library/runpy.rst:131 +#: library/runpy.rst:134 msgid "" "Note that, unlike :func:`run_module`, the alterations made to :mod:`sys` are " "not optional in this function as these adjustments are essential to allowing " @@ -84745,41 +86510,46 @@ msgid "" "with the import lock or delegated to a separate process." msgstr "" +#: library/runpy.rst:141 +msgid "" +":ref:`using-on-interface-options` for equivalent functionality on the " +"command line (``python path/to/script``)." +msgstr "" + # 2e8f61016d7b4f23b9577be29468c6f1 -#: ../src/Doc/library/runpy.rst:141 +#: library/runpy.rst:149 #, fuzzy -msgid ":pep:`338` - Executing modules as scripts" +msgid "PEP 338 -- Executing modules as scripts" msgstr ":pep:`338` -- Exécuter des modules en tant que scripts" -#: ../src/Doc/library/runpy.rst:142 ../src/Doc/library/runpy.rst:145 +#: library/runpy.rst:149 library/runpy.rst:152 msgid "PEP written and implemented by Nick Coghlan." msgstr "" -# e9386cebd4094ac188674d209e8dbf73 -#: ../src/Doc/library/runpy.rst:144 -msgid ":pep:`366` - Main module explicit relative imports" +#: library/runpy.rst:152 +msgid "PEP 366 -- Main module explicit relative imports" msgstr "" -#: ../src/Doc/library/runpy.rst:147 +#: library/runpy.rst:154 msgid ":ref:`using-on-general` - CPython command line details" msgstr "" -#: ../src/Doc/library/sched.rst:2 +#: library/sched.rst:2 msgid ":mod:`sched` --- Event scheduler" msgstr "" # c24452b442424ffe99057234463c7556 -#: ../src/Doc/library/sched.rst:10 +#: library/sched.rst:10 msgid "**Source code:** :source:`Lib/sched.py`" msgstr "" -#: ../src/Doc/library/sched.rst:14 +#: library/sched.rst:14 msgid "" "The :mod:`sched` module defines a class which implements a general purpose " "event scheduler:" msgstr "" -#: ../src/Doc/library/sched.rst:19 +#: library/sched.rst:19 msgid "" "The :class:`scheduler` class defines a generic interface to scheduling " "events. It needs two functions to actually deal with the \"outside world\" " @@ -84791,7 +86561,7 @@ msgid "" "to run in multi-threaded applications." msgstr "" -#: ../src/Doc/library/sched.rst:47 +#: library/sched.rst:47 msgid "" "In multi-threaded environments, the :class:`scheduler` class has limitations " "with respect to thread-safety, inability to insert a new task before the one " @@ -84800,15 +86570,15 @@ msgid "" "the :class:`threading.Timer` class instead." msgstr "" -#: ../src/Doc/library/sched.rst:77 +#: library/sched.rst:77 msgid "Scheduler Objects" msgstr "" -#: ../src/Doc/library/sched.rst:79 +#: library/sched.rst:79 msgid ":class:`scheduler` instances have the following methods and attributes:" msgstr "" -#: ../src/Doc/library/sched.rst:84 +#: library/sched.rst:84 msgid "" "Schedule a new event. The *time* argument should be a numeric type " "compatible with the return value of the *timefunc* function passed to the " @@ -84816,44 +86586,44 @@ msgid "" "order of their *priority*." msgstr "" -#: ../src/Doc/library/sched.rst:89 +#: library/sched.rst:89 msgid "" "Executing the event means executing ``action(*argument)``. *argument* must " "be a sequence holding the parameters for *action*." msgstr "" -#: ../src/Doc/library/sched.rst:92 +#: library/sched.rst:92 msgid "" "Return value is an event which may be used for later cancellation of the " "event (see :meth:`cancel`)." msgstr "" # 592c10421d9644388afc0b557cfb0ab9 -#: ../src/Doc/library/sched.rst:98 +#: library/sched.rst:98 msgid "" "Schedule an event for *delay* more time units. Other than the relative time, " "the other arguments, the effect and the return value are the same as those " "for :meth:`enterabs`." msgstr "" -#: ../src/Doc/library/sched.rst:105 +#: library/sched.rst:105 msgid "" "Remove the event from the queue. If *event* is not an event currently in the " "queue, this method will raise a :exc:`ValueError`." msgstr "" -#: ../src/Doc/library/sched.rst:111 +#: library/sched.rst:111 msgid "Return true if the event queue is empty." msgstr "" -#: ../src/Doc/library/sched.rst:116 +#: library/sched.rst:116 msgid "" "Run all scheduled events. This function will wait (using the :func:" "`delayfunc` function passed to the constructor) for the next event, then " "execute it and so on until there are no more scheduled events." msgstr "" -#: ../src/Doc/library/sched.rst:120 +#: library/sched.rst:120 msgid "" "Either *action* or *delayfunc* can raise an exception. In either case, the " "scheduler will maintain a consistent state and propagate the exception. If " @@ -84861,7 +86631,7 @@ msgid "" "future calls to :meth:`run`." msgstr "" -#: ../src/Doc/library/sched.rst:125 +#: library/sched.rst:125 msgid "" "If a sequence of events takes longer to run than the time available before " "the next event, the scheduler will simply fall behind. No events will be " @@ -84869,7 +86639,7 @@ msgid "" "longer pertinent." msgstr "" -#: ../src/Doc/library/sched.rst:132 +#: library/sched.rst:132 msgid "" "Read-only attribute returning a list of upcoming events in the order they " "will be run. Each event is shown as a :term:`named tuple` with the " @@ -84877,12 +86647,12 @@ msgid "" msgstr "" # bb5a5a6c44d34322bd7f2eebd9ce4263 -#: ../src/Doc/library/scrolledtext.rst:2 +#: library/scrolledtext.rst:2 msgid ":mod:`ScrolledText` --- Scrolled Text Widget" msgstr "" # d9929844a1074a9b839aee75fb0ef5ec -#: ../src/Doc/library/scrolledtext.rst:10 +#: library/scrolledtext.rst:10 msgid "" "The :mod:`ScrolledText` module provides a class of the same name which " "implements a basic text widget which has a vertical scroll bar configured to " @@ -84892,14 +86662,14 @@ msgid "" msgstr "" # 1afc9fbe72a949b7aebd455c4beabd74 -#: ../src/Doc/library/scrolledtext.rst:18 +#: library/scrolledtext.rst:18 msgid "" ":mod:`ScrolledText` has been renamed to :mod:`tkinter.scrolledtext` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " "converting your sources to Python 3." msgstr "" -#: ../src/Doc/library/scrolledtext.rst:22 +#: library/scrolledtext.rst:22 msgid "" "The text widget and scrollbar are packed together in a :class:`Frame`, and " "the methods of the :class:`Grid` and :class:`Pack` geometry managers are " @@ -84908,26 +86678,26 @@ msgid "" "management behavior." msgstr "" -#: ../src/Doc/library/scrolledtext.rst:27 +#: library/scrolledtext.rst:27 msgid "" "Should more specific control be necessary, the following attributes are " "available:" msgstr "" -#: ../src/Doc/library/scrolledtext.rst:33 +#: library/scrolledtext.rst:33 msgid "The frame which surrounds the text and scroll bar widgets." msgstr "" -#: ../src/Doc/library/scrolledtext.rst:38 +#: library/scrolledtext.rst:38 msgid "The scroll bar widget." msgstr "" -#: ../src/Doc/library/select.rst:3 +#: library/select.rst:3 msgid ":mod:`select` --- Waiting for I/O completion" msgstr "" # d9f0f1cd028c4f678321735b4da37dcc -#: ../src/Doc/library/select.rst:9 +#: library/select.rst:9 msgid "" "This module provides access to the :c:func:`select` and :c:func:`poll` " "functions available in most operating systems, :c:func:`epoll` available on " @@ -84939,14 +86709,14 @@ msgid "" msgstr "" # 3795d2c18a984ec88b62b2930610ee2f -#: ../src/Doc/library/select.rst:22 +#: library/select.rst:22 msgid "" "The exception raised when an error occurs. The accompanying value is a pair " "containing the numeric error code from :c:data:`errno` and the corresponding " "string, as would be printed by the C function :c:func:`perror`." msgstr "" -#: ../src/Doc/library/select.rst:29 +#: library/select.rst:29 msgid "" "(Only supported on Linux 2.5.44 and newer.) Returns an edge polling object, " "which can be used as Edge or Level Triggered interface for I/O events; see " @@ -84954,7 +86724,7 @@ msgid "" "objects." msgstr "" -#: ../src/Doc/library/select.rst:39 +#: library/select.rst:39 msgid "" "(Not supported by all operating systems.) Returns a polling object, which " "supports registering and unregistering file descriptors, and then polling " @@ -84963,21 +86733,21 @@ msgid "" msgstr "" # e3d267a6beb24e40a7e6e794c4791b21 -#: ../src/Doc/library/select.rst:47 +#: library/select.rst:47 msgid "" "(Only supported on BSD.) Returns a kernel queue object; see section :ref:" "`kqueue-objects` below for the methods supported by kqueue objects." msgstr "" # 5b0e8f43401d49b796a056d641ad1f18 -#: ../src/Doc/library/select.rst:55 +#: library/select.rst:55 msgid "" "(Only supported on BSD.) Returns a kernel event object; see section :ref:" "`kevent-objects` below for the methods supported by kevent objects." msgstr "" # 1facd17b8046473bad7e7a3cb435da73 -#: ../src/Doc/library/select.rst:63 +#: library/select.rst:63 msgid "" "This is a straightforward interface to the Unix :c:func:`select` system " "call. The first three arguments are sequences of 'waitable objects': either " @@ -84985,21 +86755,21 @@ msgid "" "method named :meth:`~io.IOBase.fileno` returning such an integer:" msgstr "" -#: ../src/Doc/library/select.rst:68 +#: library/select.rst:68 msgid "*rlist*: wait until ready for reading" msgstr "" -#: ../src/Doc/library/select.rst:69 +#: library/select.rst:69 msgid "*wlist*: wait until ready for writing" msgstr "" -#: ../src/Doc/library/select.rst:70 +#: library/select.rst:70 msgid "" "*xlist*: wait for an \"exceptional condition\" (see the manual page for what " "your system considers such a condition)" msgstr "" -#: ../src/Doc/library/select.rst:73 +#: library/select.rst:73 msgid "" "Empty sequences are allowed, but acceptance of three empty sequences is " "platform-dependent. (It is known to work on Unix but not on Windows.) The " @@ -85009,7 +86779,7 @@ msgid "" "specifies a poll and never blocks." msgstr "" -#: ../src/Doc/library/select.rst:80 +#: library/select.rst:80 msgid "" "The return value is a triple of lists of objects that are ready: subsets of " "the first three arguments. When the time-out is reached without a file " @@ -85017,7 +86787,7 @@ msgid "" msgstr "" # a2fadc1c65c2428a9411b973586f6679 -#: ../src/Doc/library/select.rst:88 +#: library/select.rst:88 msgid "" "Among the acceptable object types in the sequences are Python file objects " "(e.g. ``sys.stdin``, or objects returned by :func:`open` or :func:`os." @@ -85028,14 +86798,14 @@ msgid "" msgstr "" # ebe0c7cdef774d87b4658ccb67f7567a -#: ../src/Doc/library/select.rst:98 +#: library/select.rst:98 msgid "" "File objects on Windows are not acceptable, but sockets are. On Windows, " "the underlying :c:func:`select` function is provided by the WinSock library, " "and does not handle file descriptors that don't originate from WinSock." msgstr "" -#: ../src/Doc/library/select.rst:105 +#: library/select.rst:105 msgid "" "Files reported as ready for writing by :func:`select`, :func:`poll` or " "similar interfaces in this module are guaranteed to not block on a write of " @@ -85043,161 +86813,161 @@ msgid "" "least 512. Availability: Unix." msgstr "" -#: ../src/Doc/library/select.rst:116 +#: library/select.rst:116 msgid "Edge and Level Trigger Polling (epoll) Objects" msgstr "" -#: ../src/Doc/library/select.rst:118 +#: library/select.rst:118 msgid "http://linux.die.net/man/4/epoll" msgstr "" -#: ../src/Doc/library/select.rst:120 +#: library/select.rst:120 msgid "*eventmask*" msgstr "" -#: ../src/Doc/library/select.rst:125 +#: library/select.rst:125 msgid ":const:`EPOLLIN`" msgstr "" -#: ../src/Doc/library/select.rst:125 +#: library/select.rst:125 msgid "Available for read" msgstr "" -#: ../src/Doc/library/select.rst:127 +#: library/select.rst:127 msgid ":const:`EPOLLOUT`" msgstr "" -#: ../src/Doc/library/select.rst:127 +#: library/select.rst:127 msgid "Available for write" msgstr "" -#: ../src/Doc/library/select.rst:129 +#: library/select.rst:129 msgid ":const:`EPOLLPRI`" msgstr "" -#: ../src/Doc/library/select.rst:129 +#: library/select.rst:129 msgid "Urgent data for read" msgstr "" -#: ../src/Doc/library/select.rst:131 +#: library/select.rst:131 msgid ":const:`EPOLLERR`" msgstr "" -#: ../src/Doc/library/select.rst:131 +#: library/select.rst:131 msgid "Error condition happened on the assoc. fd" msgstr "" -#: ../src/Doc/library/select.rst:133 +#: library/select.rst:133 msgid ":const:`EPOLLHUP`" msgstr "" -#: ../src/Doc/library/select.rst:133 +#: library/select.rst:133 msgid "Hang up happened on the assoc. fd" msgstr "" -#: ../src/Doc/library/select.rst:135 +#: library/select.rst:135 msgid ":const:`EPOLLET`" msgstr "" -#: ../src/Doc/library/select.rst:135 +#: library/select.rst:135 msgid "Set Edge Trigger behavior, the default is Level Trigger behavior" msgstr "" -#: ../src/Doc/library/select.rst:138 +#: library/select.rst:138 msgid ":const:`EPOLLONESHOT`" msgstr "" -#: ../src/Doc/library/select.rst:138 +#: library/select.rst:138 msgid "" "Set one-shot behavior. After one event is pulled out, the fd is internally " "disabled" msgstr "" -#: ../src/Doc/library/select.rst:141 +#: library/select.rst:141 msgid ":const:`EPOLLRDNORM`" msgstr "" # 32f9fd7b64bf4041b663e77fa7bab14b -#: ../src/Doc/library/select.rst:141 +#: library/select.rst:141 msgid "Equivalent to :const:`EPOLLIN`" msgstr "" -#: ../src/Doc/library/select.rst:143 +#: library/select.rst:143 msgid ":const:`EPOLLRDBAND`" msgstr "" # 209d2750bf25437d893d56cee3977fbc -#: ../src/Doc/library/select.rst:143 +#: library/select.rst:143 msgid "Priority data band can be read." msgstr "" -#: ../src/Doc/library/select.rst:145 +#: library/select.rst:145 msgid ":const:`EPOLLWRNORM`" msgstr "" # 1ae4d62bd2074e0891fd41a8fd380ef1 -#: ../src/Doc/library/select.rst:145 +#: library/select.rst:145 msgid "Equivalent to :const:`EPOLLOUT`" msgstr "" -#: ../src/Doc/library/select.rst:147 +#: library/select.rst:147 msgid ":const:`EPOLLWRBAND`" msgstr "" # 4b48bbf05dfd43fa9fea937ce7662c69 -#: ../src/Doc/library/select.rst:147 +#: library/select.rst:147 msgid "Priority data may be written." msgstr "" -#: ../src/Doc/library/select.rst:149 +#: library/select.rst:149 msgid ":const:`EPOLLMSG`" msgstr "" # b1a0f61f69d5453aa08d0424bf48e019 -#: ../src/Doc/library/select.rst:149 +#: library/select.rst:149 msgid "Ignored." msgstr "" -#: ../src/Doc/library/select.rst:155 +#: library/select.rst:155 msgid "Close the control file descriptor of the epoll object." msgstr "" -#: ../src/Doc/library/select.rst:160 ../src/Doc/library/select.rst:286 +#: library/select.rst:160 library/select.rst:286 msgid "Return the file descriptor number of the control fd." msgstr "" -#: ../src/Doc/library/select.rst:165 +#: library/select.rst:165 msgid "Create an epoll object from a given file descriptor." msgstr "" -#: ../src/Doc/library/select.rst:170 +#: library/select.rst:170 msgid "Register a fd descriptor with the epoll object." msgstr "" -#: ../src/Doc/library/select.rst:174 +#: library/select.rst:174 msgid "" "Registering a file descriptor that's already registered raises an IOError -- " "contrary to :ref:`poll-objects`'s register." msgstr "" -#: ../src/Doc/library/select.rst:180 +#: library/select.rst:180 msgid "Modify a register file descriptor." msgstr "" -#: ../src/Doc/library/select.rst:185 +#: library/select.rst:185 msgid "Remove a registered file descriptor from the epoll object." msgstr "" -#: ../src/Doc/library/select.rst:190 +#: library/select.rst:190 msgid "Wait for events. timeout in seconds (float)" msgstr "" -#: ../src/Doc/library/select.rst:196 +#: library/select.rst:196 msgid "Polling Objects" msgstr "" # 72337fdeefae4a97a343025e4163ef90 -#: ../src/Doc/library/select.rst:198 +#: library/select.rst:198 msgid "" "The :c:func:`poll` system call, supported on most Unix systems, provides " "better scalability for network servers that service many, many clients at " @@ -85210,7 +86980,7 @@ msgid "" msgstr "" # e2e35abfcf5442f5a29040bbf980c7f5 -#: ../src/Doc/library/select.rst:209 +#: library/select.rst:209 msgid "" "Register a file descriptor with the polling object. Future calls to the :" "meth:`poll` method will then check whether the file descriptor has any " @@ -85219,7 +86989,7 @@ msgid "" "implement :meth:`!fileno`, so they can also be used as the argument." msgstr "" -#: ../src/Doc/library/select.rst:215 +#: library/select.rst:215 msgid "" "*eventmask* is an optional bitmask describing the type of events you want to " "check for, and can be a combination of the constants :const:`POLLIN`, :const:" @@ -85227,62 +86997,62 @@ msgid "" "specified, the default value used will check for all 3 types of events." msgstr "" -#: ../src/Doc/library/select.rst:223 +#: library/select.rst:223 msgid ":const:`POLLIN`" msgstr "" -#: ../src/Doc/library/select.rst:223 +#: library/select.rst:223 msgid "There is data to read" msgstr "" -#: ../src/Doc/library/select.rst:225 +#: library/select.rst:225 msgid ":const:`POLLPRI`" msgstr "" -#: ../src/Doc/library/select.rst:225 +#: library/select.rst:225 msgid "There is urgent data to read" msgstr "" -#: ../src/Doc/library/select.rst:227 +#: library/select.rst:227 msgid ":const:`POLLOUT`" msgstr "" -#: ../src/Doc/library/select.rst:227 +#: library/select.rst:227 msgid "Ready for output: writing will not block" msgstr "" -#: ../src/Doc/library/select.rst:229 +#: library/select.rst:229 msgid ":const:`POLLERR`" msgstr "" -#: ../src/Doc/library/select.rst:229 +#: library/select.rst:229 msgid "Error condition of some sort" msgstr "" -#: ../src/Doc/library/select.rst:231 +#: library/select.rst:231 msgid ":const:`POLLHUP`" msgstr "" -#: ../src/Doc/library/select.rst:231 +#: library/select.rst:231 msgid "Hung up" msgstr "" -#: ../src/Doc/library/select.rst:233 +#: library/select.rst:233 msgid ":const:`POLLNVAL`" msgstr "" -#: ../src/Doc/library/select.rst:233 +#: library/select.rst:233 msgid "Invalid request: descriptor not open" msgstr "" -#: ../src/Doc/library/select.rst:236 +#: library/select.rst:236 msgid "" "Registering a file descriptor that's already registered is not an error, and " "has the same effect as registering the descriptor exactly once." msgstr "" # 4b3bfdd274184383a423befeffe8c82b -#: ../src/Doc/library/select.rst:242 +#: library/select.rst:242 msgid "" "Modifies an already registered fd. This has the same effect as " "``register(fd, eventmask)``. Attempting to modify a file descriptor that " @@ -85291,20 +87061,20 @@ msgid "" msgstr "" # 0c167c73f1964055b0e3653a6bad97b5 -#: ../src/Doc/library/select.rst:252 +#: library/select.rst:252 msgid "" "Remove a file descriptor being tracked by a polling object. Just like the :" "meth:`register` method, *fd* can be an integer or an object with a :meth:" "`~io.IOBase.fileno` method that returns an integer." msgstr "" -#: ../src/Doc/library/select.rst:256 +#: library/select.rst:256 msgid "" "Attempting to remove a file descriptor that was never registered causes a :" "exc:`KeyError` exception to be raised." msgstr "" -#: ../src/Doc/library/select.rst:262 +#: library/select.rst:262 msgid "" "Polls the set of registered file descriptors, and returns a possibly-empty " "list containing ``(fd, event)`` 2-tuples for the descriptors that have " @@ -85318,43 +87088,43 @@ msgid "" "`None`, the call will block until there is an event for this poll object." msgstr "" -#: ../src/Doc/library/select.rst:277 +#: library/select.rst:277 msgid "Kqueue Objects" msgstr "" -#: ../src/Doc/library/select.rst:281 +#: library/select.rst:281 msgid "Close the control file descriptor of the kqueue object." msgstr "" -#: ../src/Doc/library/select.rst:291 +#: library/select.rst:291 msgid "Create a kqueue object from a given file descriptor." msgstr "" -#: ../src/Doc/library/select.rst:296 +#: library/select.rst:296 msgid "Low level interface to kevent" msgstr "" -#: ../src/Doc/library/select.rst:298 +#: library/select.rst:298 msgid "changelist must be an iterable of kevent object or None" msgstr "" -#: ../src/Doc/library/select.rst:299 +#: library/select.rst:299 msgid "max_events must be 0 or a positive integer" msgstr "" -#: ../src/Doc/library/select.rst:300 +#: library/select.rst:300 msgid "timeout in seconds (floats possible)" msgstr "" -#: ../src/Doc/library/select.rst:306 +#: library/select.rst:306 msgid "Kevent Objects" msgstr "" -#: ../src/Doc/library/select.rst:308 +#: library/select.rst:308 msgid "http://www.freebsd.org/cgi/man.cgi?query=kqueue&sektion=2" msgstr "" -#: ../src/Doc/library/select.rst:312 +#: library/select.rst:312 msgid "" "Value used to identify the event. The interpretation depends on the filter " "but it's usually the file descriptor. In the constructor ident can either be " @@ -85362,339 +87132,343 @@ msgid "" "internally." msgstr "" -#: ../src/Doc/library/select.rst:319 +#: library/select.rst:319 msgid "Name of the kernel filter." msgstr "" -#: ../src/Doc/library/select.rst:324 +#: library/select.rst:324 msgid ":const:`KQ_FILTER_READ`" msgstr "" -#: ../src/Doc/library/select.rst:324 +#: library/select.rst:324 msgid "Takes a descriptor and returns whenever there is data available to read" msgstr "" -#: ../src/Doc/library/select.rst:327 +#: library/select.rst:327 msgid ":const:`KQ_FILTER_WRITE`" msgstr "" -#: ../src/Doc/library/select.rst:327 +#: library/select.rst:327 msgid "" "Takes a descriptor and returns whenever there is data available to write" msgstr "" -#: ../src/Doc/library/select.rst:330 +#: library/select.rst:330 msgid ":const:`KQ_FILTER_AIO`" msgstr "" -#: ../src/Doc/library/select.rst:330 +#: library/select.rst:330 msgid "AIO requests" msgstr "" -#: ../src/Doc/library/select.rst:332 +#: library/select.rst:332 msgid ":const:`KQ_FILTER_VNODE`" msgstr "" -#: ../src/Doc/library/select.rst:332 +#: library/select.rst:332 msgid "" "Returns when one or more of the requested events watched in *fflag* occurs" msgstr "" -#: ../src/Doc/library/select.rst:335 +#: library/select.rst:335 msgid ":const:`KQ_FILTER_PROC`" msgstr "" -#: ../src/Doc/library/select.rst:335 +#: library/select.rst:335 msgid "Watch for events on a process id" msgstr "" -#: ../src/Doc/library/select.rst:337 +#: library/select.rst:337 msgid ":const:`KQ_FILTER_NETDEV`" msgstr "" -#: ../src/Doc/library/select.rst:337 +#: library/select.rst:337 msgid "Watch for events on a network device [not available on Mac OS X]" msgstr "" -#: ../src/Doc/library/select.rst:340 +#: library/select.rst:340 msgid ":const:`KQ_FILTER_SIGNAL`" msgstr "" -#: ../src/Doc/library/select.rst:340 +#: library/select.rst:340 msgid "Returns whenever the watched signal is delivered to the process" msgstr "" -#: ../src/Doc/library/select.rst:343 +#: library/select.rst:343 msgid ":const:`KQ_FILTER_TIMER`" msgstr "" -#: ../src/Doc/library/select.rst:343 +#: library/select.rst:343 msgid "Establishes an arbitrary timer" msgstr "" -#: ../src/Doc/library/select.rst:348 +#: library/select.rst:348 msgid "Filter action." msgstr "" -#: ../src/Doc/library/select.rst:353 +#: library/select.rst:353 msgid ":const:`KQ_EV_ADD`" msgstr "" -#: ../src/Doc/library/select.rst:353 +#: library/select.rst:353 msgid "Adds or modifies an event" msgstr "" -#: ../src/Doc/library/select.rst:355 +#: library/select.rst:355 msgid ":const:`KQ_EV_DELETE`" msgstr "" -#: ../src/Doc/library/select.rst:355 +#: library/select.rst:355 msgid "Removes an event from the queue" msgstr "" -#: ../src/Doc/library/select.rst:357 +#: library/select.rst:357 msgid ":const:`KQ_EV_ENABLE`" msgstr "" -#: ../src/Doc/library/select.rst:357 +#: library/select.rst:357 msgid "Permitscontrol() to returns the event" msgstr "" -#: ../src/Doc/library/select.rst:359 +#: library/select.rst:359 msgid ":const:`KQ_EV_DISABLE`" msgstr "" -#: ../src/Doc/library/select.rst:359 +#: library/select.rst:359 msgid "Disablesevent" msgstr "" -#: ../src/Doc/library/select.rst:361 +#: library/select.rst:361 msgid ":const:`KQ_EV_ONESHOT`" msgstr "" -#: ../src/Doc/library/select.rst:361 +#: library/select.rst:361 msgid "Removes event after first occurrence" msgstr "" -#: ../src/Doc/library/select.rst:363 +#: library/select.rst:363 msgid ":const:`KQ_EV_CLEAR`" msgstr "" -#: ../src/Doc/library/select.rst:363 +#: library/select.rst:363 msgid "Reset the state after an event is retrieved" msgstr "" -#: ../src/Doc/library/select.rst:365 +#: library/select.rst:365 msgid ":const:`KQ_EV_SYSFLAGS`" msgstr "" -#: ../src/Doc/library/select.rst:365 ../src/Doc/library/select.rst:367 +#: library/select.rst:365 library/select.rst:367 msgid "internal event" msgstr "" -#: ../src/Doc/library/select.rst:367 +#: library/select.rst:367 msgid ":const:`KQ_EV_FLAG1`" msgstr "" -#: ../src/Doc/library/select.rst:369 +#: library/select.rst:369 msgid ":const:`KQ_EV_EOF`" msgstr "" -#: ../src/Doc/library/select.rst:369 +#: library/select.rst:369 msgid "Filter specific EOF condition" msgstr "" -#: ../src/Doc/library/select.rst:371 +#: library/select.rst:371 msgid ":const:`KQ_EV_ERROR`" msgstr "" -#: ../src/Doc/library/select.rst:371 +#: library/select.rst:371 msgid "See return values" msgstr "" -#: ../src/Doc/library/select.rst:377 +#: library/select.rst:377 msgid "Filter specific flags." msgstr "" -#: ../src/Doc/library/select.rst:379 +#: library/select.rst:379 msgid ":const:`KQ_FILTER_READ` and :const:`KQ_FILTER_WRITE` filter flags:" msgstr "" -#: ../src/Doc/library/select.rst:384 +#: library/select.rst:384 msgid ":const:`KQ_NOTE_LOWAT`" msgstr "" -#: ../src/Doc/library/select.rst:384 +#: library/select.rst:384 msgid "low water mark of a socket buffer" msgstr "" -#: ../src/Doc/library/select.rst:387 +#: library/select.rst:387 msgid ":const:`KQ_FILTER_VNODE` filter flags:" msgstr "" -#: ../src/Doc/library/select.rst:392 +#: library/select.rst:392 msgid ":const:`KQ_NOTE_DELETE`" msgstr "" -#: ../src/Doc/library/select.rst:392 +#: library/select.rst:392 msgid "*unlink()* was called" msgstr "" -#: ../src/Doc/library/select.rst:394 +#: library/select.rst:394 msgid ":const:`KQ_NOTE_WRITE`" msgstr "" -#: ../src/Doc/library/select.rst:394 +#: library/select.rst:394 msgid "a write occurred" msgstr "" -#: ../src/Doc/library/select.rst:396 +#: library/select.rst:396 msgid ":const:`KQ_NOTE_EXTEND`" msgstr "" -#: ../src/Doc/library/select.rst:396 +#: library/select.rst:396 msgid "the file was extended" msgstr "" -#: ../src/Doc/library/select.rst:398 +#: library/select.rst:398 msgid ":const:`KQ_NOTE_ATTRIB`" msgstr "" -#: ../src/Doc/library/select.rst:398 +#: library/select.rst:398 msgid "an attribute was changed" msgstr "" -#: ../src/Doc/library/select.rst:400 +#: library/select.rst:400 msgid ":const:`KQ_NOTE_LINK`" msgstr "" -#: ../src/Doc/library/select.rst:400 +#: library/select.rst:400 msgid "the link count has changed" msgstr "" -#: ../src/Doc/library/select.rst:402 +#: library/select.rst:402 msgid ":const:`KQ_NOTE_RENAME`" msgstr "" -#: ../src/Doc/library/select.rst:402 +#: library/select.rst:402 msgid "the file was renamed" msgstr "" -#: ../src/Doc/library/select.rst:404 +#: library/select.rst:404 msgid ":const:`KQ_NOTE_REVOKE`" msgstr "" -#: ../src/Doc/library/select.rst:404 +#: library/select.rst:404 msgid "access to the file was revoked" msgstr "" -#: ../src/Doc/library/select.rst:407 +#: library/select.rst:407 msgid ":const:`KQ_FILTER_PROC` filter flags:" msgstr "" -#: ../src/Doc/library/select.rst:412 +#: library/select.rst:412 msgid ":const:`KQ_NOTE_EXIT`" msgstr "" -#: ../src/Doc/library/select.rst:412 +#: library/select.rst:412 msgid "the process has exited" msgstr "" -#: ../src/Doc/library/select.rst:414 +#: library/select.rst:414 msgid ":const:`KQ_NOTE_FORK`" msgstr "" -#: ../src/Doc/library/select.rst:414 +#: library/select.rst:414 msgid "the process has called *fork()*" msgstr "" -#: ../src/Doc/library/select.rst:416 +#: library/select.rst:416 msgid ":const:`KQ_NOTE_EXEC`" msgstr "" -#: ../src/Doc/library/select.rst:416 +#: library/select.rst:416 msgid "the process has executed a new process" msgstr "" -#: ../src/Doc/library/select.rst:418 +#: library/select.rst:418 msgid ":const:`KQ_NOTE_PCTRLMASK`" msgstr "" -#: ../src/Doc/library/select.rst:418 ../src/Doc/library/select.rst:420 +#: library/select.rst:418 library/select.rst:420 msgid "internal filter flag" msgstr "" -#: ../src/Doc/library/select.rst:420 +#: library/select.rst:420 msgid ":const:`KQ_NOTE_PDATAMASK`" msgstr "" -#: ../src/Doc/library/select.rst:422 +#: library/select.rst:422 msgid ":const:`KQ_NOTE_TRACK`" msgstr "" -#: ../src/Doc/library/select.rst:422 +#: library/select.rst:422 msgid "follow a process across *fork()*" msgstr "" -#: ../src/Doc/library/select.rst:424 +#: library/select.rst:424 msgid ":const:`KQ_NOTE_CHILD`" msgstr "" -#: ../src/Doc/library/select.rst:424 +#: library/select.rst:424 msgid "returned on the child process for *NOTE_TRACK*" msgstr "" -#: ../src/Doc/library/select.rst:427 +#: library/select.rst:427 msgid ":const:`KQ_NOTE_TRACKERR`" msgstr "" -#: ../src/Doc/library/select.rst:427 +#: library/select.rst:427 msgid "unable to attach to a child" msgstr "" -#: ../src/Doc/library/select.rst:430 +#: library/select.rst:430 msgid ":const:`KQ_FILTER_NETDEV` filter flags (not available on Mac OS X):" msgstr "" -#: ../src/Doc/library/select.rst:435 +#: library/select.rst:435 msgid ":const:`KQ_NOTE_LINKUP`" msgstr "" -#: ../src/Doc/library/select.rst:435 +#: library/select.rst:435 msgid "link is up" msgstr "" -#: ../src/Doc/library/select.rst:437 +#: library/select.rst:437 msgid ":const:`KQ_NOTE_LINKDOWN`" msgstr "" -#: ../src/Doc/library/select.rst:437 +#: library/select.rst:437 msgid "link is down" msgstr "" -#: ../src/Doc/library/select.rst:439 +#: library/select.rst:439 msgid ":const:`KQ_NOTE_LINKINV`" msgstr "" -#: ../src/Doc/library/select.rst:439 +#: library/select.rst:439 msgid "link state is invalid" msgstr "" -#: ../src/Doc/library/select.rst:445 +#: library/select.rst:445 msgid "Filter specific data." msgstr "" -#: ../src/Doc/library/select.rst:450 +#: library/select.rst:450 msgid "User defined value." msgstr "" # 05dcd5d7a2944fcf880e6437ca582ded -#: ../src/Doc/library/sets.rst:3 +#: library/sets.rst:3 msgid ":mod:`sets` --- Unordered collections of unique elements" msgstr "" +#: library/sets.rst:16 +msgid "The built-in :class:`set`/:class:`frozenset` types replace this module." +msgstr "" + # a12c1a13be054da7a0576f3f9c1172b4 -#: ../src/Doc/library/sets.rst:19 +#: library/sets.rst:19 msgid "" "The :mod:`sets` module provides classes for constructing and manipulating " "unordered collections of unique elements. Common uses include membership " @@ -85703,7 +87477,7 @@ msgid "" "difference." msgstr "" -#: ../src/Doc/library/sets.rst:25 ../src/Doc/library/stdtypes.rst:1738 +#: library/sets.rst:25 library/stdtypes.rst:1750 msgid "" "Like other collections, sets support ``x in set``, ``len(set)``, and ``for x " "in set``. Being an unordered collection, sets do not record element " @@ -85712,7 +87486,7 @@ msgid "" msgstr "" # e4310a7744094fcb9afc69687b48c74a -#: ../src/Doc/library/sets.rst:30 +#: library/sets.rst:30 msgid "" "Most set applications use the :class:`Set` class which provides every set " "method except for :meth:`__hash__`. For advanced applications requiring a " @@ -85724,7 +87498,7 @@ msgid "" msgstr "" # 369d30b030554ed189a30430982967cc -#: ../src/Doc/library/sets.rst:37 +#: library/sets.rst:37 msgid "" "The set classes are implemented using dictionaries. Accordingly, the " "requirements for set elements are the same as those for dictionary keys; " @@ -85738,7 +87512,7 @@ msgid "" msgstr "" # 1d2721ced7bc437089c08f9cb38763f4 -#: ../src/Doc/library/sets.rst:49 +#: library/sets.rst:49 msgid "" "Constructs a new empty :class:`Set` object. If the optional *iterable* " "parameter is supplied, updates the set with elements obtained from " @@ -85748,7 +87522,7 @@ msgid "" msgstr "" # 0b36cb7ab38b48a1be9c7331a1b2e6d9 -#: ../src/Doc/library/sets.rst:57 +#: library/sets.rst:57 msgid "" "Constructs a new empty :class:`ImmutableSet` object. If the optional " "*iterable* parameter is supplied, updates the set with elements obtained " @@ -85758,7 +87532,7 @@ msgid "" msgstr "" # 0d2a0b0c63454234b3b6302e1306c717 -#: ../src/Doc/library/sets.rst:62 +#: library/sets.rst:62 msgid "" "Because :class:`ImmutableSet` objects provide a :meth:`__hash__` method, " "they can be used as set elements or as dictionary keys. :class:" @@ -85767,12 +87541,12 @@ msgid "" msgstr "" # aa835a6a9bd447399b76182f352076b7 -#: ../src/Doc/library/sets.rst:71 +#: library/sets.rst:71 msgid "Set Objects" msgstr "" # 1a7df233d4e44cbca3a792544b670567 -#: ../src/Doc/library/sets.rst:73 +#: library/sets.rst:73 msgid "" "Instances of :class:`Set` and :class:`ImmutableSet` both provide the " "following operations:" @@ -85780,139 +87554,139 @@ msgstr "" # 6e4613c156cf406d9d322df8fd208be5 # 243e2859c4e0462cbf680c09d0850bf4 -#: ../src/Doc/library/sets.rst:77 ../src/Doc/library/sets.rst:147 +#: library/sets.rst:77 library/sets.rst:147 msgid "Equivalent" msgstr "" -#: ../src/Doc/library/sets.rst:79 ../src/Doc/library/stdtypes.rst:749 +#: library/sets.rst:79 library/stdtypes.rst:749 msgid "``len(s)``" msgstr "" # be17caf7a57041ec9e0d53267778d605 -#: ../src/Doc/library/sets.rst:79 +#: library/sets.rst:79 msgid "cardinality of set *s*" msgstr "" -#: ../src/Doc/library/sets.rst:81 ../src/Doc/library/stdtypes.rst:730 +#: library/sets.rst:81 library/stdtypes.rst:730 msgid "``x in s``" msgstr "" # 088eab92de7542748945c4df9ae2d45b -#: ../src/Doc/library/sets.rst:81 +#: library/sets.rst:81 msgid "test *x* for membership in *s*" msgstr "" -#: ../src/Doc/library/sets.rst:83 ../src/Doc/library/stdtypes.rst:733 +#: library/sets.rst:83 library/stdtypes.rst:733 msgid "``x not in s``" msgstr "" # 91d0543906bd41a7ad91a4af40d66161 -#: ../src/Doc/library/sets.rst:83 +#: library/sets.rst:83 msgid "test *x* for non-membership in *s*" msgstr "" # 8382aaf0c87646e3bb1d9a23f1bba95e -#: ../src/Doc/library/sets.rst:86 +#: library/sets.rst:86 msgid "``s.issubset(t)``" msgstr "" # 300fa531b78b4e7d9f1472eeb7dc8335 -#: ../src/Doc/library/sets.rst:86 +#: library/sets.rst:86 msgid "``s <= t``" msgstr "" # 870ae402f7df43ce8c8e63355d8bf698 -#: ../src/Doc/library/sets.rst:86 +#: library/sets.rst:86 msgid "test whether every element in *s* is in *t*" msgstr "" # fecf6da7680946ff8a0315445b26a9be -#: ../src/Doc/library/sets.rst:89 +#: library/sets.rst:89 msgid "``s.issuperset(t)``" msgstr "" # e75121ef55fc47879becde4c4525fd16 -#: ../src/Doc/library/sets.rst:89 +#: library/sets.rst:89 msgid "``s >= t``" msgstr "" # 6d1457897451405fbcfa0a0f894ba164 -#: ../src/Doc/library/sets.rst:89 +#: library/sets.rst:89 msgid "test whether every element in *t* is in *s*" msgstr "" # 7fd18eb1011b48ed9c13a3f73e0e0bad -#: ../src/Doc/library/sets.rst:92 +#: library/sets.rst:92 msgid "``s.union(t)``" msgstr "" # 8df5915eeba84eeeb660028d8e0bf21b -#: ../src/Doc/library/sets.rst:92 +#: library/sets.rst:92 msgid "``s | t``" msgstr "" # 17e2c0c3130041f7b70b384641e0c691 -#: ../src/Doc/library/sets.rst:92 +#: library/sets.rst:92 msgid "new set with elements from both *s* and *t*" msgstr "" # f23540e341334dc69f20819ab478d1b5 -#: ../src/Doc/library/sets.rst:95 +#: library/sets.rst:95 msgid "``s.intersection(t)``" msgstr "" # 7f622c08587140c09d94b592ca6d6bfa -#: ../src/Doc/library/sets.rst:95 +#: library/sets.rst:95 msgid "``s & t``" msgstr "" # 02a0a88501f349f5b57995ce4596b6f2 -#: ../src/Doc/library/sets.rst:95 +#: library/sets.rst:95 msgid "new set with elements common to *s* and *t*" msgstr "" # ae5cf7db9b254833a9f966da2f680695 -#: ../src/Doc/library/sets.rst:98 +#: library/sets.rst:98 msgid "``s.difference(t)``" msgstr "" # 48f538b682c64d9a9338ef9cbe8838ab -#: ../src/Doc/library/sets.rst:98 +#: library/sets.rst:98 msgid "``s - t``" msgstr "" # fbdb61ad2917402a8f3158c6d297f0ce -#: ../src/Doc/library/sets.rst:98 +#: library/sets.rst:98 msgid "new set with elements in *s* but not in *t*" msgstr "" # dcb5aa343cb048129d2ada23c4a3c564 -#: ../src/Doc/library/sets.rst:101 +#: library/sets.rst:101 msgid "``s.symmetric_difference(t)``" msgstr "" # b1de0d40c50a4395beeb0ecbaf491812 -#: ../src/Doc/library/sets.rst:101 +#: library/sets.rst:101 msgid "``s ^ t``" msgstr "" # 898d9b96792a4348a9ac63fd043ec23c -#: ../src/Doc/library/sets.rst:101 +#: library/sets.rst:101 msgid "new set with elements in either *s* or *t* but not both" msgstr "" # c14d1a9ceaf547d39a12a6bcf71f241d -#: ../src/Doc/library/sets.rst:104 +#: library/sets.rst:104 msgid "``s.copy()``" msgstr "" # e35b1b58915d4a5e98c32e5df61d6f06 -#: ../src/Doc/library/sets.rst:104 +#: library/sets.rst:104 msgid "new set with a shallow copy of *s*" msgstr "" # 24712a3fe0eb42438e9eee94c5adacd8 -#: ../src/Doc/library/sets.rst:108 +#: library/sets.rst:108 msgid "" "Note, the non-operator versions of :meth:`union`, :meth:`intersection`, :" "meth:`difference`, and :meth:`symmetric_difference` will accept any iterable " @@ -85922,8 +87696,12 @@ msgid "" "intersection('cbs')``." msgstr "" +#: library/sets.rst:115 library/sets.rst:181 +msgid "Formerly all arguments were required to be sets." +msgstr "" + # 25f3a52a8117419da1d8224c480d2a39 -#: ../src/Doc/library/sets.rst:118 +#: library/sets.rst:118 msgid "" "In addition, both :class:`Set` and :class:`ImmutableSet` support set to set " "comparisons. Two sets are equal if and only if every element of each set is " @@ -85935,7 +87713,7 @@ msgid "" msgstr "" # 5b2bd0da639044589eab971996ab7f05 -#: ../src/Doc/library/sets.rst:126 +#: library/sets.rst:126 msgid "" "The subset and equality comparisons do not generalize to a complete ordering " "function. For example, any two disjoint sets are not equal and are not " @@ -85944,149 +87722,149 @@ msgid "" "method." msgstr "" -#: ../src/Doc/library/sets.rst:131 ../src/Doc/library/stdtypes.rst:1866 +#: library/sets.rst:131 library/stdtypes.rst:1878 msgid "" "Since sets only define partial ordering (subset relationships), the output " "of the :meth:`list.sort` method is undefined for lists of sets." msgstr "" # efb4bae9ff6b402b9dcba549c1b143e9 -#: ../src/Doc/library/sets.rst:134 +#: library/sets.rst:134 msgid "" "The following table lists operations available in :class:`ImmutableSet` but " "not found in :class:`Set`:" msgstr "" # e73dc0671f0a443997d38415f3901bde -#: ../src/Doc/library/sets.rst:140 +#: library/sets.rst:140 msgid "``hash(s)``" msgstr "" # b38e1cec9890428b8096f8cc767d40a1 -#: ../src/Doc/library/sets.rst:140 +#: library/sets.rst:140 msgid "returns a hash value for *s*" msgstr "" # 20598e74bcaa4df995e4cffe8d9006d8 -#: ../src/Doc/library/sets.rst:143 +#: library/sets.rst:143 msgid "" "The following table lists operations available in :class:`Set` but not found " "in :class:`ImmutableSet`:" msgstr "" # 603a9479aeb14174ad64ce06f4f62ec9 -#: ../src/Doc/library/sets.rst:149 +#: library/sets.rst:149 msgid "``s.update(t)``" msgstr "" # 2a7f5722e5dd410eaf97c3b5076c72d1 -#: ../src/Doc/library/sets.rst:149 +#: library/sets.rst:149 msgid "*s* \\|= *t*" msgstr "" # 5d13a1ecaef4473eb273fa13dbcf554f -#: ../src/Doc/library/sets.rst:149 +#: library/sets.rst:149 msgid "return set *s* with elements added from *t*" msgstr "" # dda44cedcc2349f88daeede9fd954a00 -#: ../src/Doc/library/sets.rst:152 +#: library/sets.rst:152 msgid "``s.intersection_update(t)``" msgstr "" # 9c148cc602b544d386dcda58688ccaa5 -#: ../src/Doc/library/sets.rst:152 +#: library/sets.rst:152 msgid "*s* &= *t*" msgstr "" # f66a2ea6a9c4405b952664dc87ea71d1 -#: ../src/Doc/library/sets.rst:152 +#: library/sets.rst:152 msgid "return set *s* keeping only elements also found in *t*" msgstr "" # cd95898d3b834eef9748b198c5d799f8 -#: ../src/Doc/library/sets.rst:155 +#: library/sets.rst:155 msgid "``s.difference_update(t)``" msgstr "" # 2ee1074c5464444e919989a622c4636f -#: ../src/Doc/library/sets.rst:155 +#: library/sets.rst:155 msgid "*s* -= *t*" msgstr "" # 4f1127a31ea1418a9682db13eb229d81 -#: ../src/Doc/library/sets.rst:155 +#: library/sets.rst:155 msgid "return set *s* after removing elements found in *t*" msgstr "" # 9c1bac273b2644cb8c57fb0b984eddaa -#: ../src/Doc/library/sets.rst:158 +#: library/sets.rst:158 msgid "``s.symmetric_difference_update(t)``" msgstr "" # 4a31eb82083044b69492cfa54c49b6e8 -#: ../src/Doc/library/sets.rst:158 +#: library/sets.rst:158 msgid "*s* ^= *t*" msgstr "" # 758abc2cb41542abb66cccb7f502059f -#: ../src/Doc/library/sets.rst:158 +#: library/sets.rst:158 msgid "return set *s* with elements from *s* or *t* but not both" msgstr "" # 7c1b2001392444d9812af659be5ddd33 -#: ../src/Doc/library/sets.rst:161 +#: library/sets.rst:161 msgid "``s.add(x)``" msgstr "" # 9a7cc2624aa9411a97172d86434bba57 -#: ../src/Doc/library/sets.rst:161 +#: library/sets.rst:161 msgid "add element *x* to set *s*" msgstr "" -#: ../src/Doc/library/sets.rst:163 ../src/Doc/library/stdtypes.rst:1628 +#: library/sets.rst:163 library/stdtypes.rst:1634 msgid "``s.remove(x)``" msgstr "" # be934f8e32714758b18a657c6c988085 -#: ../src/Doc/library/sets.rst:163 +#: library/sets.rst:163 msgid "remove *x* from set *s*; raises :exc:`KeyError` if not present" msgstr "" # 8abce2d5f91445168bbfe8b4499b182f -#: ../src/Doc/library/sets.rst:166 +#: library/sets.rst:166 msgid "``s.discard(x)``" msgstr "" # 31527421feab4093abf02092ebaa01b8 -#: ../src/Doc/library/sets.rst:166 +#: library/sets.rst:166 msgid "removes *x* from set *s* if present" msgstr "" # 38ebadb133fa4bec9dc148ada9723fb5 -#: ../src/Doc/library/sets.rst:169 +#: library/sets.rst:169 msgid "``s.pop()``" msgstr "" # d7747b1f68a049e7962acec6b2c05b75 -#: ../src/Doc/library/sets.rst:169 +#: library/sets.rst:169 msgid "" "remove and return an arbitrary element from *s*; raises :exc:`KeyError` if " "empty" msgstr "" # ed828b57875f4731b3ec070acf6fe663 -#: ../src/Doc/library/sets.rst:173 +#: library/sets.rst:173 msgid "``s.clear()``" msgstr "" # 65a2cf94f0c8415698c62a8e989fdae1 -#: ../src/Doc/library/sets.rst:173 +#: library/sets.rst:173 msgid "remove all elements from set *s*" msgstr "" # 7c2c3d4476a346279d158476c727d492 -#: ../src/Doc/library/sets.rst:177 +#: library/sets.rst:177 msgid "" "Note, the non-operator versions of :meth:`update`, :meth:" "`intersection_update`, :meth:`difference_update`, and :meth:" @@ -86094,7 +87872,7 @@ msgid "" msgstr "" # 30823b17997f44afad8e710e31efa8bf -#: ../src/Doc/library/sets.rst:184 +#: library/sets.rst:184 msgid "" "Also note, the module also includes a :meth:`union_update` method which is " "an alias for :meth:`update`. The method is included for backwards " @@ -86104,12 +87882,12 @@ msgid "" msgstr "" # 86320195c95b4f05b63d9a3c784aa1e8 -#: ../src/Doc/library/sets.rst:223 +#: library/sets.rst:223 msgid "Protocol for automatic conversion to immutable" msgstr "" # 1e65f35447cc48bfa85dbfc9eccb0c59 -#: ../src/Doc/library/sets.rst:225 +#: library/sets.rst:225 msgid "" "Sets can only contain immutable elements. For convenience, mutable :class:" "`Set` objects are automatically copied to an :class:`ImmutableSet` before " @@ -86117,7 +87895,7 @@ msgid "" msgstr "" # 15049f57c414421db62220f28652fa90 -#: ../src/Doc/library/sets.rst:229 +#: library/sets.rst:229 msgid "" "The mechanism is to always add a :term:`hashable` element, or if it is not " "hashable, the element is checked to see if it has an :meth:" @@ -86125,7 +87903,7 @@ msgid "" msgstr "" # 57dda7f1a8cc4cc8a1ca594f0bef860c -#: ../src/Doc/library/sets.rst:233 +#: library/sets.rst:233 msgid "" "Since :class:`Set` objects have a :meth:`__as_immutable__` method returning " "an instance of :class:`ImmutableSet`, it is possible to construct sets of " @@ -86133,7 +87911,7 @@ msgid "" msgstr "" # 1ec5ea4f1f6d443c9100caebf9c2727c -#: ../src/Doc/library/sets.rst:236 +#: library/sets.rst:236 msgid "" "A similar mechanism is needed by the :meth:`__contains__` and :meth:`remove` " "methods which need to hash an element to check for membership in a set. " @@ -86144,14 +87922,14 @@ msgid "" msgstr "" # 344d8de45ba54e4db74b1b34e80a5e6a -#: ../src/Doc/library/sets.rst:243 +#: library/sets.rst:243 msgid "" "The alternate mechanism spares the need to build a separate copy of the " "original mutable object." msgstr "" # 789d164ed0b347b99fed72795e65469d -#: ../src/Doc/library/sets.rst:246 +#: library/sets.rst:246 msgid "" ":class:`Set` objects implement the :meth:`__as_temporarily_immutable__` " "method which returns the :class:`Set` object wrapped by a new class :class:" @@ -86159,7 +87937,7 @@ msgid "" msgstr "" # e932d8e23c704c78b0dfb1ce363508c5 -#: ../src/Doc/library/sets.rst:250 +#: library/sets.rst:250 msgid "" "The two mechanisms for adding hashability are normally invisible to the " "user; however, a conflict can arise in a multi-threaded environment where " @@ -86169,52 +87947,52 @@ msgid "" msgstr "" # 6e66a8bb74f04ca28eaa2d54f4a51126 -#: ../src/Doc/library/sets.rst:260 +#: library/sets.rst:260 msgid "Comparison to the built-in :class:`set` types" msgstr "" # 54cb383853044321b87cb47b9e6f478c -#: ../src/Doc/library/sets.rst:262 +#: library/sets.rst:262 msgid "" "The built-in :class:`set` and :class:`frozenset` types were designed based " "on lessons learned from the :mod:`sets` module. The key differences are:" msgstr "" # 64ec051a33a740c8999bc64b7c4f15bd -#: ../src/Doc/library/sets.rst:265 +#: library/sets.rst:265 msgid "" ":class:`Set` and :class:`ImmutableSet` were renamed to :class:`set` and :" "class:`frozenset`." msgstr "" # bcac7219e5d64e5cb12d7a49dc62e10f -#: ../src/Doc/library/sets.rst:268 +#: library/sets.rst:268 msgid "" "There is no equivalent to :class:`BaseSet`. Instead, use ``isinstance(x, " "(set, frozenset))``." msgstr "" # ba676c6c4b8942f083260fa5e8ac657d -#: ../src/Doc/library/sets.rst:271 +#: library/sets.rst:271 msgid "" "The hash algorithm for the built-ins performs significantly better (fewer " "collisions) for most datasets." msgstr "" # 8a8430feedfc48a096dcdfc9af68ee6e -#: ../src/Doc/library/sets.rst:274 +#: library/sets.rst:274 msgid "The built-in versions have more space efficient pickles." msgstr "" # 50d3f743ee934ed79dc93b46c015f4ef -#: ../src/Doc/library/sets.rst:276 +#: library/sets.rst:276 msgid "" "The built-in versions do not have a :meth:`union_update` method. Instead, " "use the :meth:`update` method which is equivalent." msgstr "" # aa081f6d1646418d8468800cc0fa264f -#: ../src/Doc/library/sets.rst:279 +#: library/sets.rst:279 msgid "" "The built-in versions do not have a ``_repr(sorted=True)`` method. Instead, " "use the built-in :func:`repr` and :func:`sorted` functions: " @@ -86222,7 +88000,7 @@ msgid "" msgstr "" # 0567fc38ab3a40919ce46cc4630d026f -#: ../src/Doc/library/sets.rst:283 +#: library/sets.rst:283 msgid "" "The built-in version does not have a protocol for automatic conversion to " "immutable. Many found this feature to be confusing and no one in the " @@ -86230,24 +88008,28 @@ msgid "" msgstr "" # 517d8b3a2f2c455389b479d9e6a765fa -#: ../src/Doc/library/sgi.rst:6 +#: library/sgi.rst:6 msgid "SGI IRIX Specific Services" msgstr "" # 9a2480e55ac74c8abfec281c185b3620 -#: ../src/Doc/library/sgi.rst:8 +#: library/sgi.rst:8 msgid "" "The modules described in this chapter provide interfaces to features that " "are unique to SGI's IRIX operating system (versions 4 and 5)." msgstr "" # 734a9867fd1246298f2b22560d4f675f -#: ../src/Doc/library/sgmllib.rst:2 +#: library/sgmllib.rst:2 msgid ":mod:`sgmllib` --- Simple SGML parser" msgstr "" +#: library/sgmllib.rst:8 +msgid "The :mod:`sgmllib` module has been removed in Python 3." +msgstr "" + # 742f4f4c92be4c558892f66ad9bf3c90 -#: ../src/Doc/library/sgmllib.rst:13 +#: library/sgmllib.rst:13 msgid "" "This module defines a class :class:`SGMLParser` which serves as the basis " "for parsing text files formatted in SGML (Standard Generalized Mark-up " @@ -86259,31 +88041,31 @@ msgid "" msgstr "" # 99203d6490a74df9b829e8bf4ff2f481 -#: ../src/Doc/library/sgmllib.rst:23 +#: library/sgmllib.rst:23 msgid "" "The :class:`SGMLParser` class is instantiated without arguments. The parser " "is hardcoded to recognize the following constructs:" msgstr "" # 07b3357a9f74442d8f06f6f971cb1e72 -#: ../src/Doc/library/sgmllib.rst:26 +#: library/sgmllib.rst:26 msgid "" "Opening and closing tags of the form ```` and ````, respectively." msgstr "" # 3e5e7aa2701d45c08cb5c942b5b52510 -#: ../src/Doc/library/sgmllib.rst:29 +#: library/sgmllib.rst:29 msgid "Numeric character references of the form ``&#name;``." msgstr "" # 66230967bb134d84a7f723cdce4b3bc1 -#: ../src/Doc/library/sgmllib.rst:31 +#: library/sgmllib.rst:31 msgid "Entity references of the form ``&name;``." msgstr "" # 75facd8a1882430b895db8d2275c1d11 -#: ../src/Doc/library/sgmllib.rst:33 +#: library/sgmllib.rst:33 msgid "" "SGML comments of the form ````. Note that spaces, tabs, and " "newlines are allowed between the trailing ``>`` and the immediately " @@ -86291,35 +88073,35 @@ msgid "" msgstr "" # 626ad57a54fb45bab22fe0c12869f95d -#: ../src/Doc/library/sgmllib.rst:37 +#: library/sgmllib.rst:37 msgid "A single exception is defined as well:" msgstr "" # e82ca1759a2142a4ac7007691785c6a2 -#: ../src/Doc/library/sgmllib.rst:42 +#: library/sgmllib.rst:42 msgid "" "Exception raised by the :class:`SGMLParser` class when it encounters an " "error while parsing." msgstr "" # 6402b0b545f3464fbd6a35625d0ee86f -#: ../src/Doc/library/sgmllib.rst:47 +#: library/sgmllib.rst:47 msgid ":class:`SGMLParser` instances have the following methods:" msgstr "" # 1be3d25d62d4483e96f86cd284e00c6e -#: ../src/Doc/library/sgmllib.rst:58 +#: library/sgmllib.rst:58 msgid "" "Stop processing tags. Treat all following input as literal input (CDATA). " "(This is only provided so the HTML tag ```` can be implemented.)" msgstr "" # 34089aa365b24846807e8ff9aa2f06e3 -#: ../src/Doc/library/sgmllib.rst:64 +#: library/sgmllib.rst:64 msgid "Enter literal mode (CDATA mode)." msgstr "" -#: ../src/Doc/library/sgmllib.rst:69 +#: library/sgmllib.rst:69 msgid "" "Feed some text to the parser. It is processed insofar as it consists of " "complete elements; incomplete data is buffered until more data is fed or :" @@ -86327,7 +88109,7 @@ msgid "" msgstr "" # 719e19d5a0c34c19974fb1ddc8d44ffa -#: ../src/Doc/library/sgmllib.rst:76 +#: library/sgmllib.rst:76 msgid "" "Force processing of all buffered data as if it were followed by an end-of-" "file mark. This method may be redefined by a derived class to define " @@ -86336,7 +88118,7 @@ msgid "" msgstr "" # 8619b614560c4b53876cae8dbb3b1266 -#: ../src/Doc/library/sgmllib.rst:92 +#: library/sgmllib.rst:92 msgid "" "This method is called to handle start tags for which either a :meth:" "`start_tag` or :meth:`do_tag` method has been defined. The *tag* argument " @@ -86347,7 +88129,7 @@ msgid "" msgstr "" # 25cba6c3c83342b8acaf377f0a90688a -#: ../src/Doc/library/sgmllib.rst:99 +#: library/sgmllib.rst:99 msgid "" "The *name* has been translated to lower case. Double quotes and backslashes " "in the *value* have been interpreted, as well as known character references " @@ -86358,7 +88140,7 @@ msgid "" msgstr "" # 2ece292605424d8ea90420de44702928 -#: ../src/Doc/library/sgmllib.rst:106 +#: library/sgmllib.rst:106 msgid "" "For instance, for the tag ``<A HREF=\"http://www.cwi.nl/\">``, this method " "would be called as ``unknown_starttag('a', [('href', 'http://www.cwi." @@ -86366,8 +88148,12 @@ msgid "" "as the only argument." msgstr "" +#: library/sgmllib.rst:111 +msgid "Handling of entity and character references within attribute values." +msgstr "" + # 9a32b570a6e849e1b0804a13a2c2ea8d -#: ../src/Doc/library/sgmllib.rst:117 +#: library/sgmllib.rst:117 msgid "" "This method is called to handle endtags for which an :meth:`end_tag` method " "has been defined. The *tag* argument is the name of the tag converted to " @@ -86377,14 +88163,14 @@ msgid "" "called. The base implementation simply calls *method*." msgstr "" -#: ../src/Doc/library/sgmllib.rst:127 +#: library/sgmllib.rst:127 msgid "" "This method is called to process arbitrary data. It is intended to be " "overridden by a derived class; the base class implementation does nothing." msgstr "" # c33b6fac95e7416c9d4e21064ae086bd -#: ../src/Doc/library/sgmllib.rst:133 +#: library/sgmllib.rst:133 msgid "" "This method is called to process a character reference of the form ``&#ref;" "``. The base implementation uses :meth:`convert_charref` to convert the " @@ -86393,8 +88179,12 @@ msgid "" "the error." msgstr "" +#: library/sgmllib.rst:138 +msgid "Use :meth:`convert_charref` instead of hard-coding the conversion." +msgstr "" + # 873d4718e605423b8da7d011f966b6ff -#: ../src/Doc/library/sgmllib.rst:144 +#: library/sgmllib.rst:144 msgid "" "Convert a character reference to a string, or ``None``. *ref* is the " "reference passed in as a string. In the base implementation, *ref* must be " @@ -86404,16 +88194,15 @@ msgid "" "`handle_charref` implementation and by the attribute value parser." msgstr "" -# df1ec086ac594401827240aa38795725 -#: ../src/Doc/library/sgmllib.rst:156 +#: library/sgmllib.rst:156 msgid "" -"Convert a codepoint to a :class:`str` value. Encodings can be handled here " +"Convert a code point to a :class:`str` value. Encodings can be handled here " "if appropriate, though the rest of :mod:`sgmllib` is oblivious on this " "matter." msgstr "" # 2cd9ee5c33f9406d9ab02a0dedd07367 -#: ../src/Doc/library/sgmllib.rst:164 +#: library/sgmllib.rst:164 msgid "" "This method is called to process a general entity reference of the form " "``&ref;`` where *ref* is an general entity reference. It converts *ref* by " @@ -86424,8 +88213,12 @@ msgid "" "``&quot;``." msgstr "" +#: library/sgmllib.rst:171 +msgid "Use :meth:`convert_entityref` instead of hard-coding the conversion." +msgstr "" + # 98f11632e06349019baf420e6e6d9825 -#: ../src/Doc/library/sgmllib.rst:177 +#: library/sgmllib.rst:177 msgid "" "Convert a named entity reference to a :class:`str` value, or ``None``. The " "resulting value will not be parsed. *ref* will be only the name of the " @@ -86437,7 +88230,7 @@ msgid "" msgstr "" # 1b720b5acb604c05861ba2744138e781 -#: ../src/Doc/library/sgmllib.rst:190 +#: library/sgmllib.rst:190 msgid "" "This method is called when a comment is encountered. The *comment* argument " "is a string containing the text between the ``<!--`` and ``-->`` delimiters, " @@ -86447,7 +88240,7 @@ msgid "" msgstr "" # 99a8efa2ddbe424ba1f2e79c84720b80 -#: ../src/Doc/library/sgmllib.rst:199 +#: library/sgmllib.rst:199 msgid "" "Method called when an SGML declaration is read by the parser. In practice, " "the ``DOCTYPE`` declaration is the only thing observed in HTML, but the " @@ -86458,28 +88251,28 @@ msgid "" msgstr "" # 6c4678af917e45dc9b02f430066a29a9 -#: ../src/Doc/library/sgmllib.rst:209 +#: library/sgmllib.rst:209 msgid "" "This method is called when an end tag is found which does not correspond to " "any open element." msgstr "" # aef70227347d49e99ab78cb85a724798 -#: ../src/Doc/library/sgmllib.rst:215 +#: library/sgmllib.rst:215 msgid "" "This method is called to process an unknown start tag. It is intended to be " "overridden by a derived class; the base class implementation does nothing." msgstr "" # 9331b5488769450dad396ea4ae455cce -#: ../src/Doc/library/sgmllib.rst:221 +#: library/sgmllib.rst:221 msgid "" "This method is called to process an unknown end tag. It is intended to be " "overridden by a derived class; the base class implementation does nothing." msgstr "" # a659a724884744538ba320399f258c28 -#: ../src/Doc/library/sgmllib.rst:227 +#: library/sgmllib.rst:227 msgid "" "This method is called to process unresolvable numeric character references. " "Refer to :meth:`handle_charref` to determine what is handled by default. It " @@ -86488,7 +88281,7 @@ msgid "" msgstr "" # 10d2f3e189cf4991b86002dfb0feb8ca -#: ../src/Doc/library/sgmllib.rst:235 +#: library/sgmllib.rst:235 msgid "" "This method is called to process an unknown entity reference. It is " "intended to be overridden by a derived class; the base class implementation " @@ -86496,7 +88289,7 @@ msgid "" msgstr "" # 16f2b2aa83d54709b8db1285e88f805c -#: ../src/Doc/library/sgmllib.rst:238 +#: library/sgmllib.rst:238 msgid "" "Apart from overriding or extending the methods listed above, derived classes " "may also define methods of the following form to define processing of " @@ -86505,7 +88298,7 @@ msgid "" msgstr "" # 5b9ea255a61d4f179678b43943161cc6 -#: ../src/Doc/library/sgmllib.rst:247 +#: library/sgmllib.rst:247 msgid "" "This method is called to process an opening tag *tag*. It has preference " "over :meth:`do_tag`. The *attributes* argument has the same meaning as " @@ -86513,7 +88306,7 @@ msgid "" msgstr "" # 48a70df7bfc149d7980e8d1b2df9fa24 -#: ../src/Doc/library/sgmllib.rst:255 +#: library/sgmllib.rst:255 msgid "" "This method is called to process an opening tag *tag* for which no :meth:" "`start_tag` method is defined. The *attributes* argument has the same " @@ -86521,12 +88314,12 @@ msgid "" msgstr "" # d5af10336223422185cd9c1e2ea63346 -#: ../src/Doc/library/sgmllib.rst:263 +#: library/sgmllib.rst:263 msgid "This method is called to process a closing tag *tag*." msgstr "" # f6510e6b9e38485391f2e73fcdcd87a3 -#: ../src/Doc/library/sgmllib.rst:265 +#: library/sgmllib.rst:265 msgid "" "Note that the parser maintains a stack of open elements for which no end tag " "has been found yet. Only tags processed by :meth:`start_tag` are pushed on " @@ -86538,12 +88331,12 @@ msgid "" msgstr "" # 20066f9fd37a4ef69e66f5e46b9e229f -#: ../src/Doc/library/sha.rst:3 +#: library/sha.rst:3 msgid ":mod:`sha` --- SHA-1 message digest algorithm" msgstr "" # 062e307e8b4944bbb5d009d5d266d553 -#: ../src/Doc/library/sha.rst:19 +#: library/sha.rst:19 msgid "" "This module implements the interface to NIST's secure hash algorithm, known " "as SHA-1. SHA-1 is an improved version of the original SHA hash algorithm. " @@ -86555,38 +88348,38 @@ msgid "" msgstr "" # 32260949932644d09b9a95a7517a63ed -#: ../src/Doc/library/sha.rst:30 +#: library/sha.rst:30 msgid "" "Return a new sha object. If *string* is present, the method call " "``update(string)`` is made." msgstr "" # a103d1abc4b34ea3b0516dbf9c75fe1c -#: ../src/Doc/library/sha.rst:33 +#: library/sha.rst:33 msgid "" "The following values are provided as constants in the module and as " "attributes of the sha objects returned by :func:`new`:" msgstr "" # 3043ff6ddc8540c7b0d24ac32bbe4fac -#: ../src/Doc/library/sha.rst:39 +#: library/sha.rst:39 msgid "" "Size of the blocks fed into the hash function; this is always ``1``. This " "size is used to allow an arbitrary string to be hashed." msgstr "" # eab73bf4608040079ca326a89cbd932e -#: ../src/Doc/library/sha.rst:45 +#: library/sha.rst:45 msgid "The size of the resulting digest in bytes. This is always ``20``." msgstr "" # 04f11190781c44a5a30aba7f9439c10e -#: ../src/Doc/library/sha.rst:47 +#: library/sha.rst:47 msgid "An sha object has the same methods as md5 objects:" msgstr "" # dd58428ffadd4d659d248b81ff31300f -#: ../src/Doc/library/sha.rst:52 +#: library/sha.rst:52 msgid "" "Update the sha object with the string *arg*. Repeated calls are equivalent " "to a single call with the concatenation of all the arguments: ``m.update(a); " @@ -86594,7 +88387,7 @@ msgid "" msgstr "" # 9b98347397684f49869e4fdc6bacb7ab -#: ../src/Doc/library/sha.rst:59 +#: library/sha.rst:59 msgid "" "Return the digest of the strings passed to the :meth:`update` method so far. " "This is a 20-byte string which may contain non-ASCII characters, including " @@ -86602,7 +88395,7 @@ msgid "" msgstr "" # f2201feaf56045e185b98abad5666274 -#: ../src/Doc/library/sha.rst:66 +#: library/sha.rst:66 msgid "" "Like :meth:`digest` except the digest is returned as a string of length 40, " "containing only hexadecimal digits. This may be used to exchange the value " @@ -86610,50 +88403,44 @@ msgid "" msgstr "" # 4a00326c1fce4b40a79517b20d9bcf8d -#: ../src/Doc/library/sha.rst:73 +#: library/sha.rst:73 msgid "" "Return a copy (\"clone\") of the sha object. This can be used to " "efficiently compute the digests of strings that share a common initial " "substring." msgstr "" -# 90a7dd2d01fd4a05a27780869dfc4709 -#: ../src/Doc/library/sha.rst:82 -msgid "" -"`Secure Hash Standard <http://csrc.nist.gov/publications/fips/fips180-2/" -"fips180-2withchangenotice.pdf>`_" +#: library/sha.rst:83 +msgid "Secure Hash Standard" msgstr "" # 54b327eed74640aea55b9a1800ae29ab -#: ../src/Doc/library/sha.rst:80 +#: library/sha.rst:80 msgid "" "The Secure Hash Algorithm is defined by NIST document FIPS PUB 180-2: " "`Secure Hash Standard <http://csrc.nist.gov/publications/fips/fips180-2/" "fips180-2withchangenotice.pdf>`_, published in August 2002." msgstr "" -# 17283c2a59a3438f8caf1ec4fd540842 -#: ../src/Doc/library/sha.rst:84 -msgid "" -"`Cryptographic Toolkit (Secure Hashing) <http://csrc.nist.gov/CryptoToolkit/" -"tkhash.html>`_" +#: library/sha.rst:85 +msgid "Cryptographic Toolkit (Secure Hashing)" msgstr "" # 46f6eee2e0ad4672bce880dde22de534 -#: ../src/Doc/library/sha.rst:86 +#: library/sha.rst:86 msgid "Links from NIST to various information on secure hashing." msgstr "" -#: ../src/Doc/library/shelve.rst:2 +#: library/shelve.rst:2 msgid ":mod:`shelve` --- Python object persistence" msgstr "" # 790ddab68385473db20b9a85e36ee356 -#: ../src/Doc/library/shelve.rst:10 +#: library/shelve.rst:10 msgid "**Source code:** :source:`Lib/shelve.py`" msgstr "" -#: ../src/Doc/library/shelve.rst:14 +#: library/shelve.rst:14 msgid "" "A \"shelf\" is a persistent, dictionary-like object. The difference with " "\"dbm\" databases is that the values (not the keys!) in a shelf can be " @@ -86664,7 +88451,7 @@ msgid "" msgstr "" # 42d1c2a8e2264feab7425b8574c246c8 -#: ../src/Doc/library/shelve.rst:23 +#: library/shelve.rst:23 msgid "" "Open a persistent dictionary. The filename specified is the base filename " "for the underlying database. As a side-effect, an extension may be added to " @@ -86675,13 +88462,13 @@ msgid "" msgstr "" # a2d56ef092a945b6bd0c5b3ab53557e1 -#: ../src/Doc/library/shelve.rst:29 +#: library/shelve.rst:29 msgid "" "By default, version 0 pickles are used to serialize values. The version of " "the pickle protocol can be specified with the *protocol* parameter." msgstr "" -#: ../src/Doc/library/shelve.rst:35 +#: library/shelve.rst:35 msgid "" "Because of Python semantics, a shelf cannot know when a mutable persistent-" "dictionary entry is modified. By default modified objects are written " @@ -86697,32 +88484,32 @@ msgid "" msgstr "" # eb3f6d391dd241dfa4e70a9d379c192b -#: ../src/Doc/library/shelve.rst:47 +#: library/shelve.rst:47 msgid "" "Like file objects, shelve objects should be closed explicitly to ensure that " "the persistent data is flushed to disk." msgstr "" # e60191888d184a7d91e0938d65a1ac39 -#: ../src/Doc/library/shelve.rst:52 +#: library/shelve.rst:52 msgid "" "Because the :mod:`shelve` module is backed by :mod:`pickle`, it is insecure " "to load a shelf from an untrusted source. Like with pickle, loading a shelf " "can execute arbitrary code." msgstr "" -#: ../src/Doc/library/shelve.rst:56 +#: library/shelve.rst:56 msgid "" "Shelf objects support all methods supported by dictionaries. This eases the " "transition from dictionary based scripts to those requiring persistent " "storage." msgstr "" -#: ../src/Doc/library/shelve.rst:59 +#: library/shelve.rst:59 msgid "Two additional methods are supported:" msgstr "" -#: ../src/Doc/library/shelve.rst:63 +#: library/shelve.rst:63 msgid "" "Write back all entries in the cache if the shelf was opened with *writeback* " "set to :const:`True`. Also empty the cache and synchronize the persistent " @@ -86730,25 +88517,25 @@ msgid "" "shelf is closed with :meth:`close`." msgstr "" -#: ../src/Doc/library/shelve.rst:70 +#: library/shelve.rst:70 msgid "" "Synchronize and close the persistent *dict* object. Operations on a closed " "shelf will fail with a :exc:`ValueError`." msgstr "" -#: ../src/Doc/library/shelve.rst:76 +#: library/shelve.rst:76 msgid "" "`Persistent dictionary recipe <http://code.activestate.com/recipes/576642/" ">`_ with widely supported storage formats and having the speed of native " "dictionaries." msgstr "" -#: ../src/Doc/library/shelve.rst:82 +#: library/shelve.rst:82 msgid "Restrictions" msgstr "" # fa4dca9d26334f409be53b81c6cfed23 -#: ../src/Doc/library/shelve.rst:89 +#: library/shelve.rst:89 msgid "" "The choice of which database package will be used (such as :mod:`dbm`, :mod:" "`gdbm` or :mod:`bsddb`) depends on which interface is available. Therefore " @@ -86759,7 +88546,7 @@ msgid "" "cause the database to refuse updates." msgstr "" -#: ../src/Doc/library/shelve.rst:97 +#: library/shelve.rst:97 msgid "" "The :mod:`shelve` module does not support *concurrent* read/write access to " "shelved objects. (Multiple simultaneous read accesses are safe.) When a " @@ -86770,20 +88557,20 @@ msgid "" msgstr "" # 11237961fb1543f6bf92bbb3e39563f8 -#: ../src/Doc/library/shelve.rst:107 +#: library/shelve.rst:107 msgid "" "A subclass of :class:`UserDict.DictMixin` which stores pickled values in the " "*dict* object." msgstr "" -#: ../src/Doc/library/shelve.rst:110 +#: library/shelve.rst:110 msgid "" "By default, version 0 pickles are used to serialize values. The version of " "the pickle protocol can be specified with the *protocol* parameter. See the :" "mod:`pickle` documentation for a discussion of the pickle protocols." msgstr "" -#: ../src/Doc/library/shelve.rst:117 +#: library/shelve.rst:117 msgid "" "If the *writeback* parameter is ``True``, the object will hold a cache of " "all entries accessed and write them back to the *dict* at sync and close " @@ -86792,7 +88579,7 @@ msgid "" msgstr "" # 6f8902b80e74412c813915d475656ecf -#: ../src/Doc/library/shelve.rst:125 +#: library/shelve.rst:125 msgid "" "A subclass of :class:`Shelf` which exposes :meth:`first`, :meth:`!next`, :" "meth:`previous`, :meth:`last` and :meth:`set_location` which are available " @@ -86805,7 +88592,7 @@ msgid "" msgstr "" # c7c4a0cf5eaf4b9d881f30fcf7e5018c -#: ../src/Doc/library/shelve.rst:136 +#: library/shelve.rst:136 msgid "" "A subclass of :class:`Shelf` which accepts a *filename* instead of a dict-" "like object. The underlying file will be opened using :func:`anydbm.open`. " @@ -86815,44 +88602,43 @@ msgid "" "same interpretation as for the :class:`Shelf` class." msgstr "" -#: ../src/Doc/library/shelve.rst:149 +#: library/shelve.rst:149 msgid "" "To summarize the interface (``key`` is a string, ``data`` is an arbitrary " "object)::" msgstr "" # 4cba39a49786466395460bb675b6f61c -#: ../src/Doc/library/shelve.rst:191 +#: library/shelve.rst:191 msgid "" "Thin layer around the :mod:`bsddb` which provides an :func:`~dbhash.open` " "function like the other database modules." msgstr "" -#: ../src/Doc/library/shelve.rst:204 +#: library/shelve.rst:204 msgid "Object serialization used by :mod:`shelve`." msgstr "" -# c813534174384ff28034b9c1da948125 -#: ../src/Doc/library/shelve.rst:205 -msgid "Module :mod:`cPickle`" +#: library/shelve.rst:206 +msgid "Module cPickle" msgstr "" # 097c3864e7954e93a3507e274ba1cfd0 -#: ../src/Doc/library/shelve.rst:207 +#: library/shelve.rst:207 msgid "High-performance version of :mod:`pickle`." msgstr "" -#: ../src/Doc/library/shlex.rst:2 +#: library/shlex.rst:2 msgid ":mod:`shlex` --- Simple lexical analysis" msgstr "" # b9d7be766e2b400ab8f2e911a54be28b -#: ../src/Doc/library/shlex.rst:14 +#: library/shlex.rst:14 msgid "**Source code:** :source:`Lib/shlex.py`" msgstr "" # fff4b2cb1b664673a8871fa26f8eed31 -#: ../src/Doc/library/shlex.rst:19 +#: library/shlex.rst:19 msgid "" "The :class:`~shlex.shlex` class makes it easy to write lexical analyzers for " "simple syntaxes resembling that of the Unix shell. This will often be " @@ -86861,16 +88647,16 @@ msgid "" msgstr "" # cc1065d8e2104b7fb3f0b35c78ef2ec7 -#: ../src/Doc/library/shlex.rst:24 +#: library/shlex.rst:24 msgid "Prior to Python 2.7.3, this module did not support Unicode input." msgstr "" -#: ../src/Doc/library/shlex.rst:26 +#: library/shlex.rst:26 msgid "The :mod:`shlex` module defines the following functions:" msgstr "" # 52bf81c9d9854f9f9f6f7b6cc423eb9e -#: ../src/Doc/library/shlex.rst:31 +#: library/shlex.rst:31 msgid "" "Split the string *s* using shell-like syntax. If *comments* is :const:" "`False` (the default), the parsing of comments in the given string will be " @@ -86880,20 +88666,24 @@ msgid "" "false." msgstr "" +#: library/shlex.rst:40 +msgid "Added the *posix* parameter." +msgstr "" + # b65b6ab769aa43aab7be2a31f4a721b9 -#: ../src/Doc/library/shlex.rst:45 +#: library/shlex.rst:45 msgid "" "Since the :func:`split` function instantiates a :class:`~shlex.shlex` " "instance, passing ``None`` for *s* will read the string to split from " "standard input." msgstr "" -#: ../src/Doc/library/shlex.rst:49 +#: library/shlex.rst:49 msgid "The :mod:`shlex` module defines the following class:" msgstr "" # 422a7a92646b4cddbe2ad8af07e32f00 -#: ../src/Doc/library/shlex.rst:54 +#: library/shlex.rst:54 msgid "" "A :class:`~shlex.shlex` instance or subclass instance is a lexical analyzer " "object. The initialization argument, if present, specifies where to read " @@ -86910,27 +88700,26 @@ msgid "" "will try to be as close as possible to the POSIX shell parsing rules." msgstr "" -# a9f79be3d2be4e0eb2b59a365914c78f -#: ../src/Doc/library/shlex.rst:70 -msgid "Module :mod:`ConfigParser`" +#: library/shlex.rst:71 +msgid "Module ConfigParser" msgstr "" -#: ../src/Doc/library/shlex.rst:72 +#: library/shlex.rst:72 msgid "" "Parser for configuration files similar to the Windows :file:`.ini` files." msgstr "" -#: ../src/Doc/library/shlex.rst:78 +#: library/shlex.rst:78 msgid "shlex Objects" msgstr "" # d0f795f2d9464b9fb7de2a5ab17af595 -#: ../src/Doc/library/shlex.rst:80 +#: library/shlex.rst:80 msgid "A :class:`~shlex.shlex` instance has the following methods:" msgstr "" # f4736fd63d314d48b87610429b9e413e -#: ../src/Doc/library/shlex.rst:85 +#: library/shlex.rst:85 msgid "" "Return a token. If tokens have been stacked using :meth:`push_token`, pop a " "token off the stack. Otherwise, read one from the input stream. If reading " @@ -86938,11 +88727,11 @@ msgid "" "string (``''``) in non-POSIX mode, and ``None`` in POSIX mode)." msgstr "" -#: ../src/Doc/library/shlex.rst:93 +#: library/shlex.rst:93 msgid "Push the argument onto the token stack." msgstr "" -#: ../src/Doc/library/shlex.rst:98 +#: library/shlex.rst:98 msgid "" "Read a raw token. Ignore the pushback stack, and do not interpret source " "requests. (This is not ordinarily a useful entry point, and is documented " @@ -86950,14 +88739,14 @@ msgid "" msgstr "" # bb20d2e129174f43b67b7aa92c4bcfab -#: ../src/Doc/library/shlex.rst:105 +#: library/shlex.rst:105 msgid "" "When :class:`~shlex.shlex` detects a source request (see :attr:`source` " "below) this method is given the following token as argument, and expected to " "return a tuple consisting of a filename and an open file-like object." msgstr "" -#: ../src/Doc/library/shlex.rst:109 +#: library/shlex.rst:109 msgid "" "Normally, this method first strips any quotes off the argument. If the " "result is an absolute pathname, or there was no previous source request in " @@ -86968,7 +88757,7 @@ msgid "" "preprocessor handles ``#include \"file.h\"``)." msgstr "" -#: ../src/Doc/library/shlex.rst:117 +#: library/shlex.rst:117 msgid "" "The result of the manipulations is treated as a filename, and returned as " "the first component of the tuple, with :func:`open` called on it to yield " @@ -86977,7 +88766,7 @@ msgid "" msgstr "" # a84a87e149444ec6b47f00ccd973e2e7 -#: ../src/Doc/library/shlex.rst:122 +#: library/shlex.rst:122 msgid "" "This hook is exposed so that you can use it to implement directory search " "paths, addition of file extensions, and other namespace hacks. There is no " @@ -86985,26 +88774,26 @@ msgid "" "IOBase.close` method of the sourced input stream when it returns EOF." msgstr "" -#: ../src/Doc/library/shlex.rst:128 +#: library/shlex.rst:128 msgid "" "For more explicit control of source stacking, use the :meth:`push_source` " "and :meth:`pop_source` methods." msgstr "" -#: ../src/Doc/library/shlex.rst:134 +#: library/shlex.rst:134 msgid "" "Push an input source stream onto the input stack. If the filename argument " "is specified it will later be available for use in error messages. This is " "the same method used internally by the :meth:`sourcehook` method." msgstr "" -#: ../src/Doc/library/shlex.rst:143 +#: library/shlex.rst:143 msgid "" "Pop the last-pushed input source from the input stack. This is the same " "method used internally when the lexer reaches EOF on a stacked input stream." msgstr "" -#: ../src/Doc/library/shlex.rst:151 +#: library/shlex.rst:151 msgid "" "This method generates an error message leader in the format of a Unix C " "compiler error label; the format is ``'\"%s\", line %d: '``, where the ``" @@ -87013,7 +88802,7 @@ msgid "" "override these)." msgstr "" -#: ../src/Doc/library/shlex.rst:156 +#: library/shlex.rst:156 msgid "" "This convenience is provided to encourage :mod:`shlex` users to generate " "error messages in the standard, parseable format understood by Emacs and " @@ -87021,39 +88810,39 @@ msgid "" msgstr "" # 2d1dca67db98415cb3c9731c004cff6e -#: ../src/Doc/library/shlex.rst:160 +#: library/shlex.rst:160 msgid "" "Instances of :class:`~shlex.shlex` subclasses have some public instance " "variables which either control lexical analysis or can be used for debugging:" msgstr "" -#: ../src/Doc/library/shlex.rst:166 +#: library/shlex.rst:166 msgid "" "The string of characters that are recognized as comment beginners. All " "characters from the comment beginner to end of line are ignored. Includes " "just ``'#'`` by default." msgstr "" -#: ../src/Doc/library/shlex.rst:173 +#: library/shlex.rst:173 msgid "" "The string of characters that will accumulate into multi-character tokens. " "By default, includes all ASCII alphanumerics and underscore." msgstr "" -#: ../src/Doc/library/shlex.rst:179 +#: library/shlex.rst:179 msgid "" "Characters that will be considered whitespace and skipped. Whitespace " "bounds tokens. By default, includes space, tab, linefeed and carriage-" "return." msgstr "" -#: ../src/Doc/library/shlex.rst:185 +#: library/shlex.rst:185 msgid "" "Characters that will be considered as escape. This will be only used in " "POSIX mode, and includes just ``'\\'`` by default." msgstr "" -#: ../src/Doc/library/shlex.rst:193 +#: library/shlex.rst:193 msgid "" "Characters that will be considered string quotes. The token accumulates " "until the same quote is encountered again (thus, different quote types " @@ -87061,7 +88850,7 @@ msgid "" "double quotes." msgstr "" -#: ../src/Doc/library/shlex.rst:200 +#: library/shlex.rst:200 msgid "" "Characters in :attr:`quotes` that will interpret escape characters defined " "in :attr:`escape`. This is only used in POSIX mode, and includes just " @@ -87069,14 +88858,14 @@ msgid "" msgstr "" # 0939a58132fb477081090c86cb32b5ff -#: ../src/Doc/library/shlex.rst:209 +#: library/shlex.rst:209 msgid "" "If ``True``, tokens will only be split in whitespaces. This is useful, for " "example, for parsing command lines with :class:`~shlex.shlex`, getting " "tokens in a similar way to shell arguments." msgstr "" -#: ../src/Doc/library/shlex.rst:218 +#: library/shlex.rst:218 msgid "" "The name of the current input file, as initially set at class instantiation " "time or stacked by later source requests. It may be useful to examine this " @@ -87084,14 +88873,14 @@ msgid "" msgstr "" # 6cea11d601a84cc3bca62864cb1499db -#: ../src/Doc/library/shlex.rst:225 +#: library/shlex.rst:225 msgid "" "The input stream from which this :class:`~shlex.shlex` instance is reading " "characters." msgstr "" # 708713548f0e4b989ee6e7531ba0dcdc -#: ../src/Doc/library/shlex.rst:231 +#: library/shlex.rst:231 msgid "" "This attribute is ``None`` by default. If you assign a string to it, that " "string will be recognized as a lexical-level inclusion request similar to " @@ -87103,63 +88892,63 @@ msgid "" msgstr "" # 21aba59f7c514aa6b73fbbfaa8d35a95 -#: ../src/Doc/library/shlex.rst:242 +#: library/shlex.rst:242 msgid "" "If this attribute is numeric and ``1`` or more, a :class:`~shlex.shlex` " "instance will print verbose progress output on its behavior. If you need to " "use this, you can read the module source code to learn the details." msgstr "" -#: ../src/Doc/library/shlex.rst:249 +#: library/shlex.rst:249 msgid "Source line number (count of newlines seen so far plus one)." msgstr "" -#: ../src/Doc/library/shlex.rst:254 +#: library/shlex.rst:254 msgid "" "The token buffer. It may be useful to examine this when catching exceptions." msgstr "" -#: ../src/Doc/library/shlex.rst:259 +#: library/shlex.rst:259 msgid "" "Token used to determine end of file. This will be set to the empty string " "(``''``), in non-POSIX mode, and to ``None`` in POSIX mode." msgstr "" -#: ../src/Doc/library/shlex.rst:268 +#: library/shlex.rst:268 msgid "Parsing Rules" msgstr "" # 3ce24a2848ef4a1a90f19aee37febbda -#: ../src/Doc/library/shlex.rst:270 +#: library/shlex.rst:270 msgid "" "When operating in non-POSIX mode, :class:`~shlex.shlex` will try to obey to " "the following rules." msgstr "" -#: ../src/Doc/library/shlex.rst:273 +#: library/shlex.rst:273 msgid "" "Quote characters are not recognized within words (``Do\"Not\"Separate`` is " "parsed as the single word ``Do\"Not\"Separate``);" msgstr "" -#: ../src/Doc/library/shlex.rst:276 +#: library/shlex.rst:276 msgid "Escape characters are not recognized;" msgstr "" -#: ../src/Doc/library/shlex.rst:278 +#: library/shlex.rst:278 msgid "" "Enclosing characters in quotes preserve the literal value of all characters " "within the quotes;" msgstr "" -#: ../src/Doc/library/shlex.rst:281 +#: library/shlex.rst:281 msgid "" "Closing quotes separate words (``\"Do\"Separate`` is parsed as ``\"Do\"`` " "and ``Separate``);" msgstr "" # e6be6ccf3873476fb205bda9a0922d84 -#: ../src/Doc/library/shlex.rst:284 +#: library/shlex.rst:284 msgid "" "If :attr:`~shlex.whitespace_split` is ``False``, any character not declared " "to be a word character, whitespace, or a quote will be returned as a single-" @@ -87167,35 +88956,35 @@ msgid "" "words in whitespaces;" msgstr "" -#: ../src/Doc/library/shlex.rst:289 +#: library/shlex.rst:289 msgid "EOF is signaled with an empty string (``''``);" msgstr "" -#: ../src/Doc/library/shlex.rst:291 +#: library/shlex.rst:291 msgid "It's not possible to parse empty strings, even if quoted." msgstr "" # 16ab21e04bf4497cb5e6bfefec86d35d -#: ../src/Doc/library/shlex.rst:293 +#: library/shlex.rst:293 msgid "" "When operating in POSIX mode, :class:`~shlex.shlex` will try to obey to the " "following parsing rules." msgstr "" -#: ../src/Doc/library/shlex.rst:296 +#: library/shlex.rst:296 msgid "" "Quotes are stripped out, and do not separate words (``\"Do\"Not\"Separate" "\"`` is parsed as the single word ``DoNotSeparate``);" msgstr "" -#: ../src/Doc/library/shlex.rst:299 +#: library/shlex.rst:299 msgid "" "Non-quoted escape characters (e.g. ``'\\'``) preserve the literal value of " "the next character that follows;" msgstr "" # 479dab145c75429989b687ebcad619d7 -#: ../src/Doc/library/shlex.rst:302 +#: library/shlex.rst:302 msgid "" "Enclosing characters in quotes which are not part of :attr:`~shlex." "escapedquotes` (e.g. ``\"'\"``) preserve the literal value of all characters " @@ -87203,7 +88992,7 @@ msgid "" msgstr "" # 4168165c42924b829fc67795922dfe46 -#: ../src/Doc/library/shlex.rst:306 +#: library/shlex.rst:306 msgid "" "Enclosing characters in quotes which are part of :attr:`~shlex." "escapedquotes` (e.g. ``'\"'``) preserves the literal value of all characters " @@ -87213,24 +89002,24 @@ msgid "" "escape character will be considered a normal character." msgstr "" -#: ../src/Doc/library/shlex.rst:314 +#: library/shlex.rst:314 msgid "EOF is signaled with a :const:`None` value;" msgstr "" -#: ../src/Doc/library/shlex.rst:316 +#: library/shlex.rst:316 msgid "Quoted empty strings (``''``) are allowed;" msgstr "" -#: ../src/Doc/library/shutil.rst:2 +#: library/shutil.rst:2 msgid ":mod:`shutil` --- High-level file operations" msgstr "" # bcaf949a0d2746d6b7ca40d50014df54 -#: ../src/Doc/library/shutil.rst:13 +#: library/shutil.rst:13 msgid "**Source code:** :source:`Lib/shutil.py`" msgstr "" -#: ../src/Doc/library/shutil.rst:17 +#: library/shutil.rst:17 msgid "" "The :mod:`shutil` module offers a number of high-level operations on files " "and collections of files. In particular, functions are provided which " @@ -87239,13 +89028,13 @@ msgid "" msgstr "" # 13cd2d097c5d4f45a7ff6a210d01e8d3 -#: ../src/Doc/library/shutil.rst:24 +#: library/shutil.rst:24 msgid "" "Even the higher-level file copying functions (:func:`shutil.copy`, :func:" "`shutil.copy2`) can't copy all file metadata." msgstr "" -#: ../src/Doc/library/shutil.rst:27 +#: library/shutil.rst:27 msgid "" "On POSIX platforms, this means that file owner and group are lost as well as " "ACLs. On Mac OS, the resource fork and other metadata are not used. This " @@ -87254,11 +89043,11 @@ msgid "" "copied." msgstr "" -#: ../src/Doc/library/shutil.rst:37 +#: library/shutil.rst:37 msgid "Directory and files operations" msgstr "" -#: ../src/Doc/library/shutil.rst:41 +#: library/shutil.rst:41 msgid "" "Copy the contents of the file-like object *fsrc* to the file-like object " "*fdst*. The integer *length*, if given, is the buffer size. In particular, a " @@ -87270,7 +89059,7 @@ msgid "" msgstr "" # 8e473943a9b64420be47d2985baec88f -#: ../src/Doc/library/shutil.rst:52 +#: library/shutil.rst:52 msgid "" "Copy the contents (no metadata) of the file named *src* to a file named " "*dst*. *dst* must be the complete target file name; look at :func:`shutil." @@ -87282,20 +89071,20 @@ msgid "" "*dst* are path names given as strings." msgstr "" -#: ../src/Doc/library/shutil.rst:64 +#: library/shutil.rst:64 msgid "" "Copy the permission bits from *src* to *dst*. The file contents, owner, and " "group are unaffected. *src* and *dst* are path names given as strings." msgstr "" -#: ../src/Doc/library/shutil.rst:70 +#: library/shutil.rst:70 msgid "" "Copy the permission bits, last access time, last modification time, and " "flags from *src* to *dst*. The file contents, owner, and group are " "unaffected. *src* and *dst* are path names given as strings." msgstr "" -#: ../src/Doc/library/shutil.rst:77 +#: library/shutil.rst:77 msgid "" "Copy the file *src* to the file or directory *dst*. If *dst* is a " "directory, a file with the same basename as *src* is created (or " @@ -87304,14 +89093,14 @@ msgid "" msgstr "" # 9324270ef9cd4af6a866101423293d4c -#: ../src/Doc/library/shutil.rst:85 +#: library/shutil.rst:85 msgid "" "Similar to :func:`shutil.copy`, but metadata is copied as well -- in fact, " "this is just :func:`shutil.copy` followed by :func:`copystat`. This is " "similar to the Unix command :program:`cp -p`." msgstr "" -#: ../src/Doc/library/shutil.rst:92 +#: library/shutil.rst:92 msgid "" "This factory function creates a function that can be used as a callable for :" "func:`copytree`\\'s *ignore* argument, ignoring files and directories that " @@ -87319,7 +89108,7 @@ msgid "" msgstr "" # bbff67a58156484499164bba325fc2fa -#: ../src/Doc/library/shutil.rst:101 +#: library/shutil.rst:101 msgid "" "Recursively copy an entire directory tree rooted at *src*. The destination " "directory, named by *dst*, must not already exist; it will be created as " @@ -87329,7 +89118,7 @@ msgid "" msgstr "" # 560404b69a9040cc9edbd2498f4ba2f8 -#: ../src/Doc/library/shutil.rst:107 +#: library/shutil.rst:107 msgid "" "If *symlinks* is true, symbolic links in the source tree are represented as " "symbolic links in the new tree, but the metadata of the original links is " @@ -87337,7 +89126,7 @@ msgid "" "files are copied to the new tree." msgstr "" -#: ../src/Doc/library/shutil.rst:112 +#: library/shutil.rst:112 msgid "" "If *ignore* is given, it must be a callable that will receive as its " "arguments the directory being visited by :func:`copytree`, and a list of its " @@ -87350,19 +89139,36 @@ msgid "" "ignores names based on glob-style patterns." msgstr "" -#: ../src/Doc/library/shutil.rst:122 +#: library/shutil.rst:122 msgid "" "If exception(s) occur, an :exc:`Error` is raised with a list of reasons." msgstr "" # 8586055f6f9d4f269997ce5c3a54c8fa -#: ../src/Doc/library/shutil.rst:124 +#: library/shutil.rst:124 msgid "" "The source code for this should be considered an example rather than the " "ultimate tool." msgstr "" -#: ../src/Doc/library/shutil.rst:143 +#: library/shutil.rst:127 +msgid "" +":exc:`Error` is raised if any exceptions occur during copying, rather than " +"printing a message." +msgstr "" + +#: library/shutil.rst:131 +msgid "" +"Create intermediate directories needed to create *dst*, rather than raising " +"an error. Copy permissions and times of directories using :func:`copystat`." +msgstr "" + +#: library/shutil.rst:135 +msgid "" +"Added the *ignore* argument to be able to influence what is being copied." +msgstr "" + +#: library/shutil.rst:143 msgid "" "Delete an entire directory tree; *path* must point to a directory (but not a " "symbolic link to a directory). If *ignore_errors* is true, errors resulting " @@ -87371,7 +89177,7 @@ msgid "" "they raise an exception." msgstr "" -#: ../src/Doc/library/shutil.rst:149 +#: library/shutil.rst:149 msgid "" "If *onerror* is provided, it must be a callable that accepts three " "parameters: *function*, *path*, and *excinfo*. The first parameter, " @@ -87382,29 +89188,27 @@ msgid "" "func:`sys.exc_info`. Exceptions raised by *onerror* will not be caught." msgstr "" +#: library/shutil.rst:158 +msgid "" +"Explicitly check for *path* being a symbolic link and raise :exc:`OSError` " +"in that case." +msgstr "" + # 6b30a3742a274295b3ccb224e66fc3a2 -#: ../src/Doc/library/shutil.rst:165 +#: library/shutil.rst:165 msgid "" "Recursively move a file or directory (*src*) to another location (*dst*)." msgstr "" -# e4594ab7d5ce4ce0a0836fc1c2214456 -#: ../src/Doc/library/shutil.rst:167 +#: library/shutil.rst:167 msgid "" -"If the destination is a directory or a symlink to a directory, then *src* is " -"moved inside that directory." -msgstr "" - -# 3fbfc24d7f4845cf9d2e05dfd0a30d20 -#: ../src/Doc/library/shutil.rst:170 -msgid "" -"The destination directory must not already exist. If the destination " -"already exists but is not a directory, it may be overwritten depending on :" -"func:`os.rename` semantics." +"If the destination is an existing directory, then *src* is moved inside that " +"directory. If the destination already exists but is not a directory, it may " +"be overwritten depending on :func:`os.rename` semantics." msgstr "" # 96bebaf0039b4535a2b79e4f2f11222c -#: ../src/Doc/library/shutil.rst:174 +#: library/shutil.rst:171 msgid "" "If the destination is on the current filesystem, then :func:`os.rename` is " "used. Otherwise, *src* is copied (using :func:`shutil.copy2`) to *dst* and " @@ -87412,57 +89216,57 @@ msgid "" msgstr "" # 020f9441b09e4fe7afeeaf6f1ff273a9 -#: ../src/Doc/library/shutil.rst:183 +#: library/shutil.rst:180 msgid "" "This exception collects exceptions that are raised during a multi-file " "operation. For :func:`copytree`, the exception argument is a list of 3-" "tuples (*srcname*, *dstname*, *exception*)." msgstr "" -#: ../src/Doc/library/shutil.rst:193 +#: library/shutil.rst:190 msgid "copytree example" msgstr "" -#: ../src/Doc/library/shutil.rst:195 +#: library/shutil.rst:192 msgid "" "This example is the implementation of the :func:`copytree` function, " "described above, with the docstring omitted. It demonstrates many of the " "other functions provided by this module. ::" msgstr "" -#: ../src/Doc/library/shutil.rst:238 +#: library/shutil.rst:235 msgid "Another example that uses the :func:`ignore_patterns` helper::" msgstr "" -#: ../src/Doc/library/shutil.rst:244 +#: library/shutil.rst:241 msgid "" "This will copy everything except ``.pyc`` files and files or directories " "whose name starts with ``tmp``." msgstr "" -#: ../src/Doc/library/shutil.rst:247 +#: library/shutil.rst:244 msgid "Another example that uses the *ignore* argument to add a logging call::" msgstr "" # 295c2e0ae83740d190e1a8072f82da6e -#: ../src/Doc/library/shutil.rst:262 +#: library/shutil.rst:259 msgid "Archiving operations" msgstr "" # 83b6cfaa675447d9859c0943aeace3f8 -#: ../src/Doc/library/shutil.rst:264 +#: library/shutil.rst:261 msgid "" "High-level utilities to create and read compressed and archived files are " "also provided. They rely on the :mod:`zipfile` and :mod:`tarfile` modules." msgstr "" # a58bd4e89df7430695892bd1c31f33b5 -#: ../src/Doc/library/shutil.rst:269 +#: library/shutil.rst:266 msgid "Create an archive file (eg. zip or tar) and returns its name." msgstr "" # a31c7825681b400b91ac7ac8d77bd338 -#: ../src/Doc/library/shutil.rst:271 +#: library/shutil.rst:268 msgid "" "*base_name* is the name of the file to create, including the path, minus any " "format-specific extension. *format* is the archive format: one of \"zip\", " @@ -87470,118 +89274,117 @@ msgid "" msgstr "" # 32468b86052a4dbc801d830fae8c3db8 -#: ../src/Doc/library/shutil.rst:275 +#: library/shutil.rst:272 msgid "" "*root_dir* is a directory that will be the root directory of the archive; " "ie. we typically chdir into *root_dir* before creating the archive." msgstr "" # 72ff626145fc41a881a85a343b4b8dc0 -#: ../src/Doc/library/shutil.rst:279 +#: library/shutil.rst:276 msgid "" "*base_dir* is the directory where we start archiving from; ie. *base_dir* " "will be the common prefix of all files and directories in the archive." msgstr "" -#: ../src/Doc/library/shutil.rst:283 +#: library/shutil.rst:280 msgid "*root_dir* and *base_dir* both default to the current directory." msgstr "" -#: ../src/Doc/library/shutil.rst:285 +#: library/shutil.rst:282 msgid "" "*owner* and *group* are used when creating a tar archive. By default, uses " "the current owner and group." msgstr "" # 7ac98117bc834090ae2b6e509d8393c4 -#: ../src/Doc/library/shutil.rst:288 +#: library/shutil.rst:285 msgid "" "*logger* must be an object compatible with :pep:`282`, usually an instance " "of :class:`logging.Logger`." msgstr "" -# c61582827ee14cc7b40c38c86d170dcc -#: ../src/Doc/library/shutil.rst:296 +#: library/shutil.rst:293 msgid "" "Return a list of supported formats for archiving. Each element of the " -"returned sequence is a tuple ``(name, description)``" +"returned sequence is a tuple ``(name, description)``." msgstr "" -#: ../src/Doc/library/shutil.rst:299 +#: library/shutil.rst:296 msgid "By default :mod:`shutil` provides these formats:" msgstr "" -#: ../src/Doc/library/shutil.rst:301 +#: library/shutil.rst:298 msgid "*gztar*: gzip'ed tar-file" msgstr "" # 3aa10ccd89be462589f8bd8f9df0ee8e -#: ../src/Doc/library/shutil.rst:302 +#: library/shutil.rst:299 msgid "*bztar*: bzip2'ed tar-file" msgstr "" -#: ../src/Doc/library/shutil.rst:303 +#: library/shutil.rst:300 msgid "*tar*: uncompressed tar file" msgstr "" -#: ../src/Doc/library/shutil.rst:304 +#: library/shutil.rst:301 msgid "*zip*: ZIP file" msgstr "" -#: ../src/Doc/library/shutil.rst:306 +#: library/shutil.rst:303 msgid "" "You can register new formats or provide your own archiver for any existing " "formats, by using :func:`register_archive_format`." msgstr "" # 0b25827bd9dc4c208745a99d1c6c776e -#: ../src/Doc/library/shutil.rst:314 +#: library/shutil.rst:311 msgid "" "Register an archiver for the format *name*. *function* is a callable that " "will be used to invoke the archiver." msgstr "" -#: ../src/Doc/library/shutil.rst:317 +#: library/shutil.rst:314 msgid "" "If given, *extra_args* is a sequence of ``(name, value)`` that will be used " "as extra keywords arguments when the archiver callable is used." msgstr "" -#: ../src/Doc/library/shutil.rst:320 +#: library/shutil.rst:317 msgid "" "*description* is used by :func:`get_archive_formats` which returns the list " "of archivers. Defaults to an empty list." msgstr "" -#: ../src/Doc/library/shutil.rst:328 +#: library/shutil.rst:325 msgid "Remove the archive format *name* from the list of supported formats." msgstr "" -#: ../src/Doc/library/shutil.rst:336 +#: library/shutil.rst:333 msgid "Archiving example" msgstr "" -#: ../src/Doc/library/shutil.rst:338 +#: library/shutil.rst:335 msgid "" "In this example, we create a gzip'ed tar-file archive containing all files " "found in the :file:`.ssh` directory of the user::" msgstr "" -#: ../src/Doc/library/shutil.rst:348 +#: library/shutil.rst:345 msgid "The resulting archive contains::" msgstr "" -#: ../src/Doc/library/signal.rst:3 +#: library/signal.rst:3 msgid ":mod:`signal` --- Set handlers for asynchronous events" msgstr "" -#: ../src/Doc/library/signal.rst:9 +#: library/signal.rst:9 msgid "" "This module provides mechanisms to use signal handlers in Python. Some " "general rules for working with signals and their handlers:" msgstr "" -#: ../src/Doc/library/signal.rst:12 +#: library/signal.rst:12 msgid "" "A handler for a particular signal, once set, remains installed until it is " "explicitly reset (Python emulates the BSD style interface regardless of the " @@ -87589,13 +89392,13 @@ msgid "" "`SIGCHLD`, which follows the underlying implementation." msgstr "" -#: ../src/Doc/library/signal.rst:17 +#: library/signal.rst:17 msgid "" "There is no way to \"block\" signals temporarily from critical sections " "(since this is not supported by all Unix flavors)." msgstr "" -#: ../src/Doc/library/signal.rst:20 +#: library/signal.rst:20 msgid "" "Although Python signal handlers are called asynchronously as far as the " "Python user is concerned, they can only occur between the \"atomic\" " @@ -87605,7 +89408,7 @@ msgid "" "time." msgstr "" -#: ../src/Doc/library/signal.rst:26 +#: library/signal.rst:26 msgid "" "When a signal arrives during an I/O operation, it is possible that the I/O " "operation raises an exception after the signal handler returns. This is " @@ -87613,13 +89416,13 @@ msgid "" "system calls." msgstr "" -#: ../src/Doc/library/signal.rst:31 +#: library/signal.rst:31 msgid "" "Because the C signal handler always returns, it makes little sense to catch " "synchronous errors like :const:`SIGFPE` or :const:`SIGSEGV`." msgstr "" -#: ../src/Doc/library/signal.rst:34 +#: library/signal.rst:34 msgid "" "Python installs a small number of signal handlers by default: :const:" "`SIGPIPE` is ignored (so write errors on pipes and sockets can be reported " @@ -87627,7 +89430,7 @@ msgid "" "`KeyboardInterrupt` exception. All of these can be overridden." msgstr "" -#: ../src/Doc/library/signal.rst:39 +#: library/signal.rst:39 msgid "" "Some care must be taken if both signals and threads are used in the same " "program. The fundamental thing to remember in using signals and threads " @@ -87641,11 +89444,11 @@ msgid "" "means of inter-thread communication. Use locks instead." msgstr "" -#: ../src/Doc/library/signal.rst:50 +#: library/signal.rst:50 msgid "The variables defined in the :mod:`signal` module are:" msgstr "" -#: ../src/Doc/library/signal.rst:55 +#: library/signal.rst:55 msgid "" "This is one of two standard signal handling options; it will simply perform " "the default function for the signal. For example, on most systems the " @@ -87653,14 +89456,14 @@ msgid "" "default action for :const:`SIGCHLD` is to simply ignore it." msgstr "" -#: ../src/Doc/library/signal.rst:63 +#: library/signal.rst:63 msgid "" "This is another standard signal handler, which will simply ignore the given " "signal." msgstr "" # 238d2f884b334d69a4754fbcdee4d553 -#: ../src/Doc/library/signal.rst:69 +#: library/signal.rst:69 msgid "" "All the signal numbers are defined symbolically. For example, the hangup " "signal is defined as :const:`signal.SIGHUP`; the variable names are " @@ -87671,37 +89474,35 @@ msgid "" "only those names defined by the system are defined by this module." msgstr "" -# ad9e44660e514b6e85693cd788706c82 -#: ../src/Doc/library/signal.rst:80 +#: library/signal.rst:80 msgid "" -"The signal corresponding to the CTRL+C keystroke event. This signal can only " -"be used with :func:`os.kill`." +"The signal corresponding to the :kbd:`Ctrl+C` keystroke event. This signal " +"can only be used with :func:`os.kill`." msgstr "" -# db7026e630fe4ce3b6a0ccca6ebc6e8a -#: ../src/Doc/library/signal.rst:90 +#: library/signal.rst:90 msgid "" -"The signal corresponding to the CTRL+BREAK keystroke event. This signal can " -"only be used with :func:`os.kill`." +"The signal corresponding to the :kbd:`Ctrl+Break` keystroke event. This " +"signal can only be used with :func:`os.kill`." msgstr "" -#: ../src/Doc/library/signal.rst:100 +#: library/signal.rst:100 msgid "One more than the number of the highest signal number." msgstr "" -#: ../src/Doc/library/signal.rst:105 +#: library/signal.rst:105 msgid "" "Decrements interval timer in real time, and delivers :const:`SIGALRM` upon " "expiration." msgstr "" -#: ../src/Doc/library/signal.rst:110 +#: library/signal.rst:110 msgid "" "Decrements interval timer only when the process is executing, and delivers " "SIGVTALRM upon expiration." msgstr "" -#: ../src/Doc/library/signal.rst:116 +#: library/signal.rst:116 msgid "" "Decrements interval timer both when the process executes and when the system " "is executing on behalf of the process. Coupled with ITIMER_VIRTUAL, this " @@ -87709,11 +89510,11 @@ msgid "" "and kernel space. SIGPROF is delivered upon expiration." msgstr "" -#: ../src/Doc/library/signal.rst:122 +#: library/signal.rst:122 msgid "The :mod:`signal` module defines one exception:" msgstr "" -#: ../src/Doc/library/signal.rst:126 +#: library/signal.rst:126 msgid "" "Raised to signal an error from the underlying :func:`setitimer` or :func:" "`getitimer` implementation. Expect this error if an invalid interval timer " @@ -87721,11 +89522,11 @@ msgid "" "of :exc:`IOError`." msgstr "" -#: ../src/Doc/library/signal.rst:132 +#: library/signal.rst:132 msgid "The :mod:`signal` module defines the following functions:" msgstr "" -#: ../src/Doc/library/signal.rst:137 +#: library/signal.rst:137 msgid "" "If *time* is non-zero, this function requests that a :const:`SIGALRM` signal " "be sent to the process in *time* seconds. Any previously scheduled alarm is " @@ -87736,7 +89537,7 @@ msgid "" "scheduled. (See the Unix man page :manpage:`alarm(2)`.) Availability: Unix." msgstr "" -#: ../src/Doc/library/signal.rst:148 +#: library/signal.rst:148 msgid "" "Return the current signal handler for the signal *signalnum*. The returned " "value may be a callable Python object, or one of the special values :const:" @@ -87747,14 +89548,14 @@ msgid "" "not installed from Python." msgstr "" -#: ../src/Doc/library/signal.rst:159 +#: library/signal.rst:159 msgid "" "Cause the process to sleep until a signal is received; the appropriate " "handler will then be called. Returns nothing. Not on Windows. (See the " "Unix man page :manpage:`signal(2)`.)" msgstr "" -#: ../src/Doc/library/signal.rst:166 +#: library/signal.rst:166 msgid "" "Sets given interval timer (one of :const:`signal.ITIMER_REAL`, :const:" "`signal.ITIMER_VIRTUAL` or :const:`signal.ITIMER_PROF`) specified by *which* " @@ -87763,7 +89564,7 @@ msgid "" "*which* can be cleared by setting seconds to zero." msgstr "" -#: ../src/Doc/library/signal.rst:172 +#: library/signal.rst:172 msgid "" "When an interval timer fires, a signal is sent to the process. The signal " "sent is dependent on the timer being used; :const:`signal.ITIMER_REAL` will " @@ -87771,43 +89572,43 @@ msgid "" "`SIGVTALRM`, and :const:`signal.ITIMER_PROF` will deliver :const:`SIGPROF`." msgstr "" -#: ../src/Doc/library/signal.rst:178 +#: library/signal.rst:178 msgid "The old values are returned as a tuple: (delay, interval)." msgstr "" -#: ../src/Doc/library/signal.rst:180 +#: library/signal.rst:180 msgid "" "Attempting to pass an invalid interval timer will cause an :exc:" "`ItimerError`. Availability: Unix." msgstr "" -#: ../src/Doc/library/signal.rst:188 +#: library/signal.rst:188 msgid "" "Returns current value of a given interval timer specified by *which*. " "Availability: Unix." msgstr "" -#: ../src/Doc/library/signal.rst:196 +#: library/signal.rst:196 msgid "" "Set the wakeup fd to *fd*. When a signal is received, a ``'\\0'`` byte is " "written to the fd. This can be used by a library to wakeup a poll or select " "call, allowing the signal to be fully processed." msgstr "" -#: ../src/Doc/library/signal.rst:200 +#: library/signal.rst:200 msgid "" "The old wakeup fd is returned. *fd* must be non-blocking. It is up to the " "library to remove any bytes before calling poll or select again." msgstr "" -#: ../src/Doc/library/signal.rst:203 ../src/Doc/library/signal.rst:232 +#: library/signal.rst:203 library/signal.rst:232 msgid "" "When threads are enabled, this function can only be called from the main " "thread; attempting to call it from other threads will cause a :exc:" "`ValueError` exception to be raised." msgstr "" -#: ../src/Doc/library/signal.rst:212 +#: library/signal.rst:212 msgid "" "Change system call restart behaviour: if *flag* is :const:`False`, system " "calls will be restarted when interrupted by signal *signalnum*, otherwise " @@ -87816,14 +89617,14 @@ msgid "" msgstr "" # eecc313754ad403aa39f3c68c543342d -#: ../src/Doc/library/signal.rst:217 +#: library/signal.rst:217 msgid "" "Note that installing a signal handler with :func:`signal` will reset the " "restart behaviour to interruptible by implicitly calling :c:func:" "`siginterrupt` with a true *flag* value for the given signal." msgstr "" -#: ../src/Doc/library/signal.rst:226 +#: library/signal.rst:226 msgid "" "Set the handler for signal *signalnum* to the function *handler*. *handler* " "can be a callable Python object taking two arguments (see below), or one of " @@ -87832,7 +89633,7 @@ msgid "" "`getsignal` above). (See the Unix man page :manpage:`signal(2)`.)" msgstr "" -#: ../src/Doc/library/signal.rst:236 +#: library/signal.rst:236 msgid "" "The *handler* is called with two arguments: the signal number and the " "current stack frame (``None`` or a frame object; for a description of frame " @@ -87841,14 +89642,14 @@ msgid "" msgstr "" # 6d4153a6d4714debb825f194fb9e4345 -#: ../src/Doc/library/signal.rst:241 +#: library/signal.rst:241 msgid "" "On Windows, :func:`signal` can only be called with :const:`SIGABRT`, :const:" "`SIGFPE`, :const:`SIGILL`, :const:`SIGINT`, :const:`SIGSEGV`, or :const:" "`SIGTERM`. A :exc:`ValueError` will be raised in any other case." msgstr "" -#: ../src/Doc/library/signal.rst:251 +#: library/signal.rst:251 msgid "" "Here is a minimal example program. It uses the :func:`alarm` function to " "limit the time spent waiting to open a file; this is useful if the file is " @@ -87859,12 +89660,12 @@ msgid "" msgstr "" # 1d35bd3480584b7f9eb5337d14cac049 -#: ../src/Doc/library/simplehttpserver.rst:3 +#: library/simplehttpserver.rst:3 msgid ":mod:`SimpleHTTPServer` --- Simple HTTP request handler" msgstr "" # 90011955e25c4b449738414aa5e44536 -#: ../src/Doc/library/simplehttpserver.rst:10 +#: library/simplehttpserver.rst:10 msgid "" "The :mod:`SimpleHTTPServer` module has been merged into :mod:`http.server` " "in Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -87872,7 +89673,7 @@ msgid "" msgstr "" # c8f329ff6dff463bbddb60b666922b3d -#: ../src/Doc/library/simplehttpserver.rst:15 +#: library/simplehttpserver.rst:15 msgid "" "The :mod:`SimpleHTTPServer` module defines a single class, :class:" "`SimpleHTTPRequestHandler`, which is interface-compatible with :class:" @@ -87880,37 +89681,37 @@ msgid "" msgstr "" # f9320b8af69a4b19ad464719ee9a8ca2 -#: ../src/Doc/library/simplehttpserver.rst:19 +#: library/simplehttpserver.rst:19 msgid "The :mod:`SimpleHTTPServer` module defines the following class:" msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:24 +#: library/simplehttpserver.rst:24 msgid "" "This class serves files from the current directory and below, directly " "mapping the directory structure to HTTP requests." msgstr "" # 54bc6f2e93e14dfe9f4e175a04198c0b -#: ../src/Doc/library/simplehttpserver.rst:27 +#: library/simplehttpserver.rst:27 msgid "" "A lot of the work, such as parsing the request, is done by the base class :" "class:`BaseHTTPServer.BaseHTTPRequestHandler`. This class implements the :" "func:`do_GET` and :func:`do_HEAD` functions." msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:31 +#: library/simplehttpserver.rst:31 msgid "" "The following are defined as class-level attributes of :class:" "`SimpleHTTPRequestHandler`:" msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:37 +#: library/simplehttpserver.rst:37 msgid "" "This will be ``\"SimpleHTTP/\" + __version__``, where ``__version__`` is " "defined at the module level." msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:43 +#: library/simplehttpserver.rst:43 msgid "" "A dictionary mapping suffixes into MIME types. The default is signified by " "an empty string, and is considered to be ``application/octet-stream``. The " @@ -87918,25 +89719,25 @@ msgid "" "keys." msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:48 +#: library/simplehttpserver.rst:48 msgid "" "The :class:`SimpleHTTPRequestHandler` class defines the following methods:" msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:53 +#: library/simplehttpserver.rst:53 msgid "" "This method serves the ``'HEAD'`` request type: it sends the headers it " "would send for the equivalent ``GET`` request. See the :meth:`do_GET` method " "for a more complete explanation of the possible headers." msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:60 +#: library/simplehttpserver.rst:60 msgid "" "The request is mapped to a local file by interpreting the request as a path " "relative to the current working directory." msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:63 +#: library/simplehttpserver.rst:63 msgid "" "If the request was mapped to a directory, the directory is checked for a " "file named ``index.html`` or ``index.htm`` (in that order). If found, the " @@ -87946,7 +89747,7 @@ msgid "" "func:`listdir` fails." msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:70 +#: library/simplehttpserver.rst:70 msgid "" "If the request was mapped to a file, it is opened and the contents are " "returned. Any :exc:`IOError` exception in opening the requested file is " @@ -87955,14 +89756,14 @@ msgid "" "*extensions_map* variable." msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:76 +#: library/simplehttpserver.rst:76 msgid "" "A ``'Content-type:'`` header with the guessed content type is output, " "followed by a ``'Content-Length:'`` header with the file's size and a " "``'Last-Modified:'`` header with the file's modification time." msgstr "" -#: ../src/Doc/library/simplehttpserver.rst:80 +#: library/simplehttpserver.rst:80 msgid "" "Then follows a blank line signifying the end of the headers, and then the " "contents of the file are output. If the file's MIME type starts with ``text/" @@ -87970,15 +89771,19 @@ msgid "" msgstr "" # 28def6151e9f4f71b5cfc7f86483fcb2 -#: ../src/Doc/library/simplehttpserver.rst:84 +#: library/simplehttpserver.rst:84 msgid "" "The :func:`test` function in the :mod:`SimpleHTTPServer` module is an " "example which creates a server using the :class:`SimpleHTTPRequestHandler` " "as the Handler." msgstr "" +#: library/simplehttpserver.rst:88 +msgid "The ``'Last-Modified'`` header." +msgstr "" + # 0bfaf2af782c42249725d1846810438c -#: ../src/Doc/library/simplehttpserver.rst:92 +#: library/simplehttpserver.rst:92 msgid "" "The :mod:`SimpleHTTPServer` module can be used in the following manner in " "order to set up a very basic web server serving files relative to the " @@ -87986,7 +89791,7 @@ msgid "" msgstr "" # 83e8463455d64d018f4bd2107fa870e1 -#: ../src/Doc/library/simplehttpserver.rst:108 +#: library/simplehttpserver.rst:108 msgid "" "The :mod:`SimpleHTTPServer` module can also be invoked directly using the :" "option:`-m` switch of the interpreter with a ``port number`` argument. " @@ -87995,12 +89800,12 @@ msgid "" msgstr "" # f213421edbce42acb60e7ab84f41de78 -#: ../src/Doc/library/simplexmlrpcserver.rst:2 +#: library/simplexmlrpcserver.rst:2 msgid ":mod:`SimpleXMLRPCServer` --- Basic XML-RPC server" msgstr "" # 9c53697cd4e44e56910099b8dbd1658a -#: ../src/Doc/library/simplexmlrpcserver.rst:10 +#: library/simplexmlrpcserver.rst:10 msgid "" "The :mod:`SimpleXMLRPCServer` module has been merged into :mod:`xmlrpc." "server` in Python 3. The :term:`2to3` tool will automatically adapt imports " @@ -88008,12 +89813,12 @@ msgid "" msgstr "" # 01d766320bbb45bf9e9942eb9597bffb -#: ../src/Doc/library/simplexmlrpcserver.rst:17 +#: library/simplexmlrpcserver.rst:17 msgid "**Source code:** :source:`Lib/SimpleXMLRPCServer.py`" msgstr "" # 70e8f7e601174a848237e7ff09d011fc -#: ../src/Doc/library/simplexmlrpcserver.rst:21 +#: library/simplexmlrpcserver.rst:21 msgid "" "The :mod:`SimpleXMLRPCServer` module provides a basic server framework for " "XML-RPC servers written in Python. Servers can either be free standing, " @@ -88022,7 +89827,7 @@ msgid "" msgstr "" # 61d58527471440db977b3cff97836f17 -#: ../src/Doc/library/simplexmlrpcserver.rst:29 +#: library/simplexmlrpcserver.rst:29 msgid "" "Create a new server instance. This class provides methods for registration " "of functions that can be called by the XML-RPC protocol. The " @@ -88039,34 +89844,42 @@ msgid "" "*allow_reuse_address* class variable before the address is bound." msgstr "" +#: library/simplexmlrpcserver.rst:42 library/simplexmlrpcserver.rst:57 +msgid "The *allow_none* and *encoding* parameters were added." +msgstr "" + +#: library/simplexmlrpcserver.rst:45 +msgid "The *bind_and_activate* parameter was added." +msgstr "" + # 976da6bb0b4b4b19a0b6d14af63d2baf -#: ../src/Doc/library/simplexmlrpcserver.rst:51 +#: library/simplexmlrpcserver.rst:51 msgid "" "Create a new instance to handle XML-RPC requests in a CGI environment. The " "*allow_none* and *encoding* parameters are passed on to :mod:`xmlrpclib` " "and control the XML-RPC responses that will be returned from the server." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:63 +#: library/simplexmlrpcserver.rst:63 msgid "" "Create a new request handler instance. This request handler supports " "``POST`` requests and modifies logging so that the *logRequests* parameter " "to the :class:`SimpleXMLRPCServer` constructor parameter is honored." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:71 +#: library/simplexmlrpcserver.rst:71 msgid "SimpleXMLRPCServer Objects" msgstr "" # dfff3b069caa4472b36af530fd4ed70a -#: ../src/Doc/library/simplexmlrpcserver.rst:73 +#: library/simplexmlrpcserver.rst:73 msgid "" "The :class:`SimpleXMLRPCServer` class is based on :class:`SocketServer." "TCPServer` and provides a means of creating simple, stand alone XML-RPC " "servers." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:80 +#: library/simplexmlrpcserver.rst:80 msgid "" "Register a function that can respond to XML-RPC requests. If *name* is " "given, it will be the method name associated with *function*, otherwise " @@ -88075,7 +89888,7 @@ msgid "" "including the period character." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:89 +#: library/simplexmlrpcserver.rst:89 msgid "" "Register an object which is used to expose method names which have not been " "registered using :meth:`register_function`. If *instance* contains a :meth:" @@ -88089,7 +89902,7 @@ msgid "" "attribute matching the name of the requested method." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:100 +#: library/simplexmlrpcserver.rst:100 msgid "" "If the optional *allow_dotted_names* argument is true and the instance does " "not have a :meth:`_dispatch` method, then if the requested method name " @@ -88100,24 +89913,30 @@ msgid "" "client." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:109 +#: library/simplexmlrpcserver.rst:109 msgid "" "Enabling the *allow_dotted_names* option allows intruders to access your " "module's global variables and may allow intruders to execute arbitrary code " "on your machine. Only use this option on a secure, closed network." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:120 +#: library/simplexmlrpcserver.rst:113 +msgid "" +"2.4.1 *allow_dotted_names* was added to plug a security hole; prior versions " +"are insecure." +msgstr "" + +#: library/simplexmlrpcserver.rst:120 msgid "" "Registers the XML-RPC introspection functions ``system.listMethods``, " "``system.methodHelp`` and ``system.methodSignature``." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:128 +#: library/simplexmlrpcserver.rst:128 msgid "Registers the XML-RPC multicall function system.multicall." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:133 +#: library/simplexmlrpcserver.rst:133 msgid "" "An attribute value that must be a tuple listing valid path portions of the " "URL for receiving XML-RPC requests. Requests posted to other paths will " @@ -88126,62 +89945,62 @@ msgid "" msgstr "" # f26d5fd0628a47948d4a496a0d420e27 -#: ../src/Doc/library/simplexmlrpcserver.rst:142 +#: library/simplexmlrpcserver.rst:142 msgid "" "If this attribute is not ``None``, responses larger than this value will be " "encoded using the *gzip* transfer encoding, if permitted by the client. The " "default is ``1400`` which corresponds roughly to a single TCP packet." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:152 +#: library/simplexmlrpcserver.rst:152 msgid "SimpleXMLRPCServer Example" msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:153 +#: library/simplexmlrpcserver.rst:153 msgid "Server code::" msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:187 +#: library/simplexmlrpcserver.rst:187 msgid "" "The following client code will call the methods made available by the " "preceding server::" msgstr "" # d1498882d2734a68bd29366ff04268d3 -#: ../src/Doc/library/simplexmlrpcserver.rst:200 +#: library/simplexmlrpcserver.rst:200 msgid "" "The following :class:`SimpleXMLRPCServer` example is included in the module " "`Lib/SimpleXMLRPCServer.py`::" msgstr "" # 306963ba6fce49af8c2bad3b8c5b0024 -#: ../src/Doc/library/simplexmlrpcserver.rst:209 +#: library/simplexmlrpcserver.rst:209 msgid "This demo server can be run from the command line as::" msgstr "" # 0776db10af4d43aea5c685867f23cffa -#: ../src/Doc/library/simplexmlrpcserver.rst:213 +#: library/simplexmlrpcserver.rst:213 msgid "" "Example client code which talks to the above server is included with `Lib/" "xmlrpclib.py`::" msgstr "" # f01cfe1dab7f47bdbb03afd9a1cbe05f -#: ../src/Doc/library/simplexmlrpcserver.rst:228 +#: library/simplexmlrpcserver.rst:228 msgid "And the client can be invoked directly using the following command::" msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:234 +#: library/simplexmlrpcserver.rst:234 msgid "CGIXMLRPCRequestHandler" msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:236 +#: library/simplexmlrpcserver.rst:236 msgid "" "The :class:`CGIXMLRPCRequestHandler` class can be used to handle XML-RPC " "requests sent to Python CGI scripts." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:242 +#: library/simplexmlrpcserver.rst:242 msgid "" "Register a function that can respond to XML-RPC requests. If *name* is " "given, it will be the method name associated with function, otherwise " @@ -88190,7 +90009,7 @@ msgid "" "including the period character." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:251 +#: library/simplexmlrpcserver.rst:251 msgid "" "Register an object which is used to expose method names which have not been " "registered using :meth:`register_function`. If instance contains a :meth:" @@ -88205,33 +90024,33 @@ msgid "" "the client." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:265 +#: library/simplexmlrpcserver.rst:265 msgid "" "Register the XML-RPC introspection functions ``system.listMethods``, " "``system.methodHelp`` and ``system.methodSignature``." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:271 +#: library/simplexmlrpcserver.rst:271 msgid "Register the XML-RPC multicall function ``system.multicall``." msgstr "" -#: ../src/Doc/library/simplexmlrpcserver.rst:276 +#: library/simplexmlrpcserver.rst:276 msgid "" "Handle a XML-RPC request. If *request_text* is given, it should be the POST " "data provided by the HTTP server, otherwise the contents of stdin will be " "used." msgstr "" -#: ../src/Doc/library/site.rst:2 +#: library/site.rst:2 msgid ":mod:`site` --- Site-specific configuration hook" msgstr "" # b57878d3264e4f52a7a67286ba4c5b08 -#: ../src/Doc/library/site.rst:7 +#: library/site.rst:7 msgid "**Source code:** :source:`Lib/site.py`" msgstr "" -#: ../src/Doc/library/site.rst:13 +#: library/site.rst:13 msgid "" "**This module is automatically imported during initialization.** The " "automatic import can be suppressed using the interpreter's :option:`-S` " @@ -88239,14 +90058,14 @@ msgid "" msgstr "" # bca695aa7a584014a42640b3c1fc87d8 -#: ../src/Doc/library/site.rst:18 +#: library/site.rst:18 msgid "" "Importing this module will append site-specific paths to the module search " "path and add a few builtins." msgstr "" # d901a532cc2e4e9bb280bc3a4fd6cc86 -#: ../src/Doc/library/site.rst:25 +#: library/site.rst:25 msgid "" "It starts by constructing up to four directories from a head and a tail " "part. For the head part, it uses ``sys.prefix`` and ``sys.exec_prefix``; " @@ -88259,7 +90078,7 @@ msgid "" msgstr "" # 6160d0aaca164392ad698c31fb209f57 -#: ../src/Doc/library/site.rst:34 +#: library/site.rst:34 msgid "" "A path configuration file is a file whose name has the form :file:`{name}." "pth` and exists in one of the four directories mentioned above; its contents " @@ -88271,8 +90090,12 @@ msgid "" "executed." msgstr "" +#: library/site.rst:42 +msgid "A space or tab is now required after the import keyword." +msgstr "" + # f88b11ae3707430598590b460f9ca08a -#: ../src/Doc/library/site.rst:49 +#: library/site.rst:49 msgid "" "For example, suppose ``sys.prefix`` and ``sys.exec_prefix`` are set to :file:" "`/usr/local`. The Python X.Y library is then installed in :file:`/usr/local/" @@ -88282,17 +90105,17 @@ msgid "" "and :file:`bar.pth`. Assume :file:`foo.pth` contains the following::" msgstr "" -#: ../src/Doc/library/site.rst:63 +#: library/site.rst:63 msgid "and :file:`bar.pth` contains::" msgstr "" -#: ../src/Doc/library/site.rst:69 +#: library/site.rst:69 msgid "" "Then the following version-specific directories are added to ``sys.path``, " "in this order::" msgstr "" -#: ../src/Doc/library/site.rst:75 +#: library/site.rst:75 msgid "" "Note that :file:`bletch` is omitted because it doesn't exist; the :file:" "`bar` directory precedes the :file:`foo` directory because :file:`bar.pth` " @@ -88301,7 +90124,7 @@ msgid "" msgstr "" # 9bb80511635d4b59a4566cc50227fa52 -#: ../src/Doc/library/site.rst:82 +#: library/site.rst:82 msgid "" "After these path manipulations, an attempt is made to import a module named :" "mod:`sitecustomize`, which can perform arbitrary site-specific " @@ -88315,7 +90138,7 @@ msgid "" msgstr "" # bd075dc4b1f24e21ba3f48e1f80b7ab5 -#: ../src/Doc/library/site.rst:94 +#: library/site.rst:94 msgid "" "After this, an attempt is made to import a module named :mod:" "`usercustomize`, which can perform arbitrary user-specific customizations, " @@ -88326,7 +90149,7 @@ msgid "" msgstr "" # 50c2feebc6984f5f936343cfcbfefcfd -#: ../src/Doc/library/site.rst:100 +#: library/site.rst:100 msgid "" "Note that for some non-Unix systems, ``sys.prefix`` and ``sys.exec_prefix`` " "are empty, and the path manipulations are skipped; however the import of :" @@ -88334,12 +90157,12 @@ msgid "" msgstr "" # 360ccfda08d84384a42b6637155a018c -#: ../src/Doc/library/site.rst:107 +#: library/site.rst:107 msgid "A list of prefixes for site-packages directories." msgstr "" # 5969dfe91cf24b0b997fb471a276535c -#: ../src/Doc/library/site.rst:114 +#: library/site.rst:114 msgid "" "Flag showing the status of the user site-packages directory. ``True`` means " "that it is enabled and was added to ``sys.path``. ``False`` means that it " @@ -88349,7 +90172,7 @@ msgid "" msgstr "" # 145c722d0e3848daab2baf5acd518596 -#: ../src/Doc/library/site.rst:126 +#: library/site.rst:126 msgid "" "Path to the user site-packages for the running Python. Can be ``None`` if :" "func:`getusersitepackages` hasn't been called yet. Default value is :file:" @@ -88361,7 +90184,7 @@ msgid "" msgstr "" # a33cf757d2464b29adc43326ffb0b8d0 -#: ../src/Doc/library/site.rst:139 +#: library/site.rst:139 msgid "" "Path to the base directory for the user site-packages. Can be ``None`` if :" "func:`getuserbase` hasn't been called yet. Default value is :file:`~/." @@ -88374,21 +90197,21 @@ msgid "" msgstr "" # b92e2d96764c475bb8717a7cb3e7e10d -#: ../src/Doc/library/site.rst:153 +#: library/site.rst:153 msgid "" "Add a directory to sys.path and process its :file:`.pth` files. Typically " "used in :mod:`sitecustomize` or :mod:`usercustomize` (see above)." msgstr "" # c92beee1724d4025a47a942443021731 -#: ../src/Doc/library/site.rst:159 +#: library/site.rst:159 msgid "" "Return a list containing all global site-packages directories (and possibly " "site-python)." msgstr "" # 3e5c815e683a42e48bb48bbe0851686b -#: ../src/Doc/library/site.rst:167 +#: library/site.rst:167 msgid "" "Return the path of the user base directory, :data:`USER_BASE`. If it is not " "initialized yet, this function will also set it, respecting :envvar:" @@ -88396,7 +90219,7 @@ msgid "" msgstr "" # ab7a457fafe14b8fb336c6cf79d7e46d -#: ../src/Doc/library/site.rst:176 +#: library/site.rst:176 msgid "" "Return the path of the user-specific site-packages directory, :data:" "`USER_SITE`. If it is not initialized yet, this function will also set it, " @@ -88404,14 +90227,14 @@ msgid "" msgstr "" # 0ef2cd1d92ea496e94051dc8240331a5 -#: ../src/Doc/library/site.rst:183 +#: library/site.rst:183 msgid "" "The :mod:`site` module also provides a way to get the user directories from " "the command line:" msgstr "" # de1cb660cec94ade976a9ccc7989a940 -#: ../src/Doc/library/site.rst:193 +#: library/site.rst:193 msgid "" "If it is called without arguments, it will print the contents of :data:`sys." "path` on the standard output, followed by the value of :data:`USER_BASE` and " @@ -88420,24 +90243,24 @@ msgid "" msgstr "" # 302c129fd46e4ba98eb0d84b6fb51bee -#: ../src/Doc/library/site.rst:200 +#: library/site.rst:200 msgid "Print the path to the user base directory." msgstr "" # 8beb5f65bcc749398a5a7e13814f47c7 -#: ../src/Doc/library/site.rst:204 +#: library/site.rst:204 msgid "Print the path to the user site-packages directory." msgstr "" # e12e0adfa9f7442bb84deb80b1fd2210 -#: ../src/Doc/library/site.rst:206 +#: library/site.rst:206 msgid "" "If both options are given, user base and user site will be printed (always " "in this order), separated by :data:`os.pathsep`." msgstr "" # 8fbf7e06fd0a43caba4db6a7d39cad0c -#: ../src/Doc/library/site.rst:209 +#: library/site.rst:209 msgid "" "If any option is given, the script will exit with one of these values: ``O`` " "if the user site-packages directory is enabled, ``1`` if it was disabled by " @@ -88446,31 +90269,31 @@ msgid "" msgstr "" # b21bdaf2105c4999bdc5a83ba520dcd9 -#: ../src/Doc/library/site.rst:216 +#: library/site.rst:216 msgid ":pep:`370` -- Per user site-packages directory" msgstr ":pep:`370` -- Répertoire site-packages par utilisateur " -#: ../src/Doc/library/smtpd.rst:2 +#: library/smtpd.rst:2 msgid ":mod:`smtpd` --- SMTP Server" msgstr "" # c5ed56206ea440c49639a327d5fee90f -#: ../src/Doc/library/smtpd.rst:10 +#: library/smtpd.rst:10 msgid "**Source code:** :source:`Lib/smtpd.py`" msgstr "" -#: ../src/Doc/library/smtpd.rst:14 +#: library/smtpd.rst:14 msgid "" "This module offers several classes to implement SMTP servers. One is a " "generic do-nothing implementation, which can be overridden, while the other " "two offer specific mail-sending strategies." msgstr "" -#: ../src/Doc/library/smtpd.rst:20 +#: library/smtpd.rst:20 msgid "SMTPServer Objects" msgstr "" -#: ../src/Doc/library/smtpd.rst:25 +#: library/smtpd.rst:25 msgid "" "Create a new :class:`SMTPServer` object, which binds to local address " "*localaddr*. It will treat *remoteaddr* as an upstream SMTP relayer. It " @@ -88478,7 +90301,7 @@ msgid "" "mod:`asyncore`'s event loop on instantiation." msgstr "" -#: ../src/Doc/library/smtpd.rst:33 +#: library/smtpd.rst:33 msgid "" "Raise :exc:`NotImplementedError` exception. Override this in subclasses to " "do something useful with this message. Whatever was passed in the " @@ -88489,32 +90312,32 @@ msgid "" "format)." msgstr "" -#: ../src/Doc/library/smtpd.rst:43 +#: library/smtpd.rst:43 msgid "DebuggingServer Objects" msgstr "" -#: ../src/Doc/library/smtpd.rst:48 +#: library/smtpd.rst:48 msgid "" "Create a new debugging server. Arguments are as per :class:`SMTPServer`. " "Messages will be discarded, and printed on stdout." msgstr "" -#: ../src/Doc/library/smtpd.rst:53 +#: library/smtpd.rst:53 msgid "PureProxy Objects" msgstr "" -#: ../src/Doc/library/smtpd.rst:58 +#: library/smtpd.rst:58 msgid "" "Create a new pure proxy server. Arguments are as per :class:`SMTPServer`. " "Everything will be relayed to *remoteaddr*. Note that running this has a " "good chance to make you into an open relay, so please be careful." msgstr "" -#: ../src/Doc/library/smtpd.rst:64 +#: library/smtpd.rst:64 msgid "MailmanProxy Objects" msgstr "" -#: ../src/Doc/library/smtpd.rst:69 +#: library/smtpd.rst:69 msgid "" "Create a new pure proxy server. Arguments are as per :class:`SMTPServer`. " "Everything will be relayed to *remoteaddr*, unless local mailman " @@ -88523,16 +90346,16 @@ msgid "" "relay, so please be careful." msgstr "" -#: ../src/Doc/library/smtplib.rst:2 +#: library/smtplib.rst:2 msgid ":mod:`smtplib` --- SMTP protocol client" msgstr "" # f6b9fad6ed4e4ab4af964acd188df4ef -#: ../src/Doc/library/smtplib.rst:13 +#: library/smtplib.rst:13 msgid "**Source code:** :source:`Lib/smtplib.py`" msgstr "" -#: ../src/Doc/library/smtplib.rst:17 +#: library/smtplib.rst:17 msgid "" "The :mod:`smtplib` module defines an SMTP client session object that can be " "used to send mail to any Internet machine with an SMTP or ESMTP listener " @@ -88541,7 +90364,7 @@ msgid "" msgstr "" # 00cb8df578d248e39a83ea6b9f60927f -#: ../src/Doc/library/smtplib.rst:25 +#: library/smtplib.rst:25 msgid "" "A :class:`SMTP` instance encapsulates an SMTP connection. It has methods " "that support a full repertoire of SMTP and ESMTP operations. If the optional " @@ -88557,14 +90380,14 @@ msgid "" msgstr "" # 11c08aebc6614c678504d17da8f81967 -#: ../src/Doc/library/smtplib.rst:38 +#: library/smtplib.rst:38 msgid "" "For normal use, you should only require the initialization/connect, :meth:" "`sendmail`, and :meth:`~smtplib.quit` methods. An example is included below." msgstr "" # 51408ffa968a4b8bb4b9cb2136042c70 -#: ../src/Doc/library/smtplib.rst:48 +#: library/smtplib.rst:48 msgid "" "A :class:`SMTP_SSL` instance behaves exactly the same as instances of :class:" "`SMTP`. :class:`SMTP_SSL` should be used for situations where SSL is " @@ -88581,7 +90404,7 @@ msgid "" msgstr "" # 8abe04974cc44af4b1c8f9ece284ec63 -#: ../src/Doc/library/smtplib.rst:66 +#: library/smtplib.rst:66 msgid "" "The LMTP protocol, which is very similar to ESMTP, is heavily based on the " "standard SMTP client. It's common to use Unix sockets for LMTP, so our :meth:" @@ -88591,32 +90414,32 @@ msgid "" "starting with a '/'." msgstr "" -#: ../src/Doc/library/smtplib.rst:73 +#: library/smtplib.rst:73 msgid "" "Authentication is supported, using the regular SMTP mechanism. When using a " "Unix socket, LMTP generally don't support or require any authentication, but " "your mileage might vary." msgstr "" -#: ../src/Doc/library/smtplib.rst:79 +#: library/smtplib.rst:79 msgid "A nice selection of exceptions is defined as well:" msgstr "" # ac43b9ac55244835b8a24be54c7402ed -#: ../src/Doc/library/smtplib.rst:84 +#: library/smtplib.rst:84 msgid "" "The base exception class for all the other exceptions provided by this " "module." msgstr "" -#: ../src/Doc/library/smtplib.rst:90 +#: library/smtplib.rst:90 msgid "" "This exception is raised when the server unexpectedly disconnects, or when " "an attempt is made to use the :class:`SMTP` instance before connecting it to " "a server." msgstr "" -#: ../src/Doc/library/smtplib.rst:97 +#: library/smtplib.rst:97 msgid "" "Base class for all exceptions that include an SMTP error code. These " "exceptions are generated in some instances when the SMTP server returns an " @@ -88624,70 +90447,68 @@ msgid "" "the error, and the :attr:`smtp_error` attribute is set to the error message." msgstr "" -#: ../src/Doc/library/smtplib.rst:105 +#: library/smtplib.rst:105 msgid "" "Sender address refused. In addition to the attributes set by on all :exc:" "`SMTPResponseException` exceptions, this sets 'sender' to the string that " "the SMTP server refused." msgstr "" -#: ../src/Doc/library/smtplib.rst:112 +#: library/smtplib.rst:112 msgid "" "All recipient addresses refused. The errors for each recipient are " "accessible through the attribute :attr:`recipients`, which is a dictionary " "of exactly the same sort as :meth:`SMTP.sendmail` returns." msgstr "" -#: ../src/Doc/library/smtplib.rst:119 +#: library/smtplib.rst:119 msgid "The SMTP server refused to accept the message data." msgstr "" -#: ../src/Doc/library/smtplib.rst:124 +#: library/smtplib.rst:124 msgid "Error occurred during establishment of a connection with the server." msgstr "" -#: ../src/Doc/library/smtplib.rst:129 +#: library/smtplib.rst:129 msgid "The server refused our ``HELO`` message." msgstr "" -#: ../src/Doc/library/smtplib.rst:134 +#: library/smtplib.rst:134 msgid "" "SMTP authentication went wrong. Most probably the server didn't accept the " "username/password combination provided." msgstr "" -# 89dd02368fd7404192a0ceb1b6152451 -#: ../src/Doc/library/smtplib.rst:141 -msgid ":rfc:`821` - Simple Mail Transfer Protocol" +#: library/smtplib.rst:142 +msgid "RFC 821 - Simple Mail Transfer Protocol" msgstr "" -#: ../src/Doc/library/smtplib.rst:141 +#: library/smtplib.rst:141 msgid "" "Protocol definition for SMTP. This document covers the model, operating " "procedure, and protocol details for SMTP." msgstr "" -# 1028a21fdbab43308a22dcb4fee20020 -#: ../src/Doc/library/smtplib.rst:145 -msgid ":rfc:`1869` - SMTP Service Extensions" +#: library/smtplib.rst:146 +msgid "RFC 1869 - SMTP Service Extensions" msgstr "" -#: ../src/Doc/library/smtplib.rst:145 +#: library/smtplib.rst:145 msgid "" "Definition of the ESMTP extensions for SMTP. This describes a framework for " "extending SMTP with new commands, supporting dynamic discovery of the " "commands provided by the server, and defines a few additional commands." msgstr "" -#: ../src/Doc/library/smtplib.rst:153 +#: library/smtplib.rst:153 msgid "SMTP Objects" msgstr "" -#: ../src/Doc/library/smtplib.rst:155 +#: library/smtplib.rst:155 msgid "An :class:`SMTP` instance has the following methods:" msgstr "" -#: ../src/Doc/library/smtplib.rst:160 +#: library/smtplib.rst:160 msgid "" "Set the debug output level. A true value for *level* results in debug " "messages for connection and for all messages sent to and received from the " @@ -88695,33 +90516,33 @@ msgid "" msgstr "" # 9f1a0447a8d54b7e9222460e0039b40f -#: ../src/Doc/library/smtplib.rst:166 +#: library/smtplib.rst:166 msgid "" "Send a command *cmd* to the server. The optional argument *argstring* is " "simply concatenated to the command, separated by a space." msgstr "" -#: ../src/Doc/library/smtplib.rst:169 +#: library/smtplib.rst:169 msgid "" "This returns a 2-tuple composed of a numeric response code and the actual " "response line (multiline responses are joined into one long line.)" msgstr "" -#: ../src/Doc/library/smtplib.rst:172 +#: library/smtplib.rst:172 msgid "" "In normal operation it should not be necessary to call this method " "explicitly. It is used to implement other methods and may be useful for " "testing private extensions." msgstr "" -#: ../src/Doc/library/smtplib.rst:176 +#: library/smtplib.rst:176 msgid "" "If the connection to the server is lost while waiting for the reply, :exc:" "`SMTPServerDisconnected` will be raised." msgstr "" # 52a25bf2dd1840af8b831af0cac7ec3a -#: ../src/Doc/library/smtplib.rst:182 +#: library/smtplib.rst:182 msgid "" "Connect to a host on a given port. The defaults are to connect to the local " "host at the standard SMTP port (25). If the hostname ends with a colon " @@ -88732,7 +90553,7 @@ msgid "" "connection response." msgstr "" -#: ../src/Doc/library/smtplib.rst:193 +#: library/smtplib.rst:193 msgid "" "Identify yourself to the SMTP server using ``HELO``. The hostname argument " "defaults to the fully qualified domain name of the local host. The message " @@ -88740,14 +90561,14 @@ msgid "" "object." msgstr "" -#: ../src/Doc/library/smtplib.rst:198 +#: library/smtplib.rst:198 msgid "" "In normal operation it should not be necessary to call this method " "explicitly. It will be implicitly called by the :meth:`sendmail` when " "necessary." msgstr "" -#: ../src/Doc/library/smtplib.rst:204 +#: library/smtplib.rst:204 msgid "" "Identify yourself to an ESMTP server using ``EHLO``. The hostname argument " "defaults to the fully qualified domain name of the local host. Examine the " @@ -88759,41 +90580,37 @@ msgid "" "service extensions this server supports, and their parameters (if any)." msgstr "" -#: ../src/Doc/library/smtplib.rst:214 +#: library/smtplib.rst:214 msgid "" "Unless you wish to use :meth:`has_extn` before sending mail, it should not " "be necessary to call this method explicitly. It will be implicitly called " "by :meth:`sendmail` when necessary." msgstr "" -#: ../src/Doc/library/smtplib.rst:220 +#: library/smtplib.rst:220 msgid "" "This method call :meth:`ehlo` and or :meth:`helo` if there has been no " "previous ``EHLO`` or ``HELO`` command this session. It tries ESMTP ``EHLO`` " "first." msgstr "" -# d8d45412ae4b46c1a63110099102f0a5 -# 0690307494b0480b9a24596465f1498c -# d889a554947d459ba631a097efdb89f9 -# 4b932444c5d245cb82ec751ba384e2b8 -#: ../src/Doc/library/smtplib.rst:224 ../src/Doc/library/smtplib.rst:255 -#: ../src/Doc/library/smtplib.rst:279 ../src/Doc/library/smtplib.rst:329 -msgid ":exc:`SMTPHeloError`" +#: library/smtplib.rst:225 library/smtplib.rst:256 library/smtplib.rst:280 +#: library/smtplib.rst:330 +msgid "SMTPHeloError" msgstr "" -#: ../src/Doc/library/smtplib.rst:225 ../src/Doc/library/smtplib.rst:256 -#: ../src/Doc/library/smtplib.rst:280 ../src/Doc/library/smtplib.rst:330 +#: library/smtplib.rst:225 library/smtplib.rst:256 library/smtplib.rst:280 +#: library/smtplib.rst:330 msgid "The server didn't reply properly to the ``HELO`` greeting." msgstr "" -#: ../src/Doc/library/smtplib.rst:231 +#: library/smtplib.rst:231 msgid "" "Return :const:`True` if *name* is in the set of SMTP service extensions " "returned by the server, :const:`False` otherwise. Case is ignored." msgstr "" -#: ../src/Doc/library/smtplib.rst:237 +#: library/smtplib.rst:237 msgid "" "Check the validity of an address on this server using SMTP ``VRFY``. Returns " "a tuple consisting of code 250 and a full :rfc:`822` address (including " @@ -88801,11 +90618,11 @@ msgid "" "code of 400 or greater and an error string." msgstr "" -#: ../src/Doc/library/smtplib.rst:244 +#: library/smtplib.rst:244 msgid "Many sites disable SMTP ``VRFY`` in order to foil spammers." msgstr "" -#: ../src/Doc/library/smtplib.rst:249 +#: library/smtplib.rst:249 msgid "" "Log in on an SMTP server that requires authentication. The arguments are the " "username and the password to authenticate with. If there has been no " @@ -88814,58 +90631,57 @@ msgid "" "successful, or may raise the following exceptions:" msgstr "" -# 1cf76d62c4ee4e0f815407b46001b819 -#: ../src/Doc/library/smtplib.rst:258 -msgid ":exc:`SMTPAuthenticationError`" +#: library/smtplib.rst:259 +msgid "SMTPAuthenticationError" msgstr "" -#: ../src/Doc/library/smtplib.rst:259 +#: library/smtplib.rst:259 msgid "The server didn't accept the username/password combination." msgstr "" -# b78d0c75870f4ab085b0a1f52d4f4a4f -# f653f1299b794c688ab9f3de9933d01a -#: ../src/Doc/library/smtplib.rst:260 ../src/Doc/library/smtplib.rst:282 -msgid ":exc:`SMTPException`" -msgstr "" +#: library/smtplib.rst:261 library/smtplib.rst:283 +#, fuzzy +msgid "SMTPException" +msgstr "Exceptions" -#: ../src/Doc/library/smtplib.rst:262 +#: library/smtplib.rst:262 msgid "No suitable authentication method was found." msgstr "" -#: ../src/Doc/library/smtplib.rst:267 +#: library/smtplib.rst:267 msgid "" "Put the SMTP connection in TLS (Transport Layer Security) mode. All SMTP " "commands that follow will be encrypted. You should then call :meth:`ehlo` " "again." msgstr "" -#: ../src/Doc/library/smtplib.rst:271 +#: library/smtplib.rst:271 msgid "" "If *keyfile* and *certfile* are provided, these are passed to the :mod:" "`socket` module's :func:`ssl` function." msgstr "" -#: ../src/Doc/library/smtplib.rst:274 +#: library/smtplib.rst:274 msgid "" "If there has been no previous ``EHLO`` or ``HELO`` command this session, " "this method tries ESMTP ``EHLO`` first." msgstr "" -#: ../src/Doc/library/smtplib.rst:283 +#: library/smtplib.rst:283 msgid "The server does not support the STARTTLS extension." msgstr "" # 3d66a1d33bec4f06964092b1ad748825 -#: ../src/Doc/library/smtplib.rst:286 -msgid ":exc:`RuntimeError`" +#: library/smtplib.rst:287 +#, fuzzy +msgid "RuntimeError" msgstr ":exc:`RuntimeError`" -#: ../src/Doc/library/smtplib.rst:288 +#: library/smtplib.rst:288 msgid "SSL/TLS support is not available to your Python interpreter." msgstr "" -#: ../src/Doc/library/smtplib.rst:293 +#: library/smtplib.rst:293 msgid "" "Send mail. The required arguments are an :rfc:`822` from-address string, a " "list of :rfc:`822` to-address strings (a bare string will be treated as a " @@ -88878,14 +90694,14 @@ msgid "" "the message.)" msgstr "" -#: ../src/Doc/library/smtplib.rst:304 +#: library/smtplib.rst:304 msgid "" "The *from_addr* and *to_addrs* parameters are used to construct the message " "envelope used by the transport agents. The :class:`SMTP` does not modify the " "message headers in any way." msgstr "" -#: ../src/Doc/library/smtplib.rst:308 +#: library/smtplib.rst:308 msgid "" "If there has been no previous ``EHLO`` or ``HELO`` command this session, " "this method tries ESMTP ``EHLO`` first. If the server does ESMTP, message " @@ -88895,7 +90711,7 @@ msgid "" msgstr "" # bd3370ea8ff5476494ead378ef8a9749 -#: ../src/Doc/library/smtplib.rst:314 +#: library/smtplib.rst:314 msgid "" "This method will return normally if the mail is accepted for at least one " "recipient. Otherwise it will raise an exception. That is, if this method " @@ -88905,16 +90721,15 @@ msgid "" "SMTP error code and the accompanying error message sent by the server." msgstr "" -#: ../src/Doc/library/smtplib.rst:321 +#: library/smtplib.rst:321 msgid "This method may raise the following exceptions:" msgstr "" -# b1f1e92f31194eceb4e9307205b7da15 -#: ../src/Doc/library/smtplib.rst:326 -msgid ":exc:`SMTPRecipientsRefused`" +#: library/smtplib.rst:327 +msgid "SMTPRecipientsRefused" msgstr "" -#: ../src/Doc/library/smtplib.rst:324 +#: library/smtplib.rst:324 msgid "" "All recipients were refused. Nobody got the mail. The :attr:`recipients` " "attribute of the exception object is a dictionary with information about the " @@ -88922,39 +90737,41 @@ msgid "" "accepted)." msgstr "" -# e43c2b9265ae4c9db7e4a53e38941f95 -#: ../src/Doc/library/smtplib.rst:332 -msgid ":exc:`SMTPSenderRefused`" +#: library/smtplib.rst:333 +msgid "SMTPSenderRefused" msgstr "" -#: ../src/Doc/library/smtplib.rst:333 +#: library/smtplib.rst:333 msgid "The server didn't accept the *from_addr*." msgstr "" -# e951d9f6296e4d5c973ba0f4f4b86978 -#: ../src/Doc/library/smtplib.rst:336 -msgid ":exc:`SMTPDataError`" +#: library/smtplib.rst:337 +msgid "SMTPDataError" msgstr "" -#: ../src/Doc/library/smtplib.rst:336 +#: library/smtplib.rst:336 msgid "" "The server replied with an unexpected error code (other than a refusal of a " "recipient)." msgstr "" -#: ../src/Doc/library/smtplib.rst:339 +#: library/smtplib.rst:339 msgid "" "Unless otherwise noted, the connection will be open even after an exception " "is raised." msgstr "" -#: ../src/Doc/library/smtplib.rst:345 +#: library/smtplib.rst:345 msgid "" "Terminate the SMTP session and close the connection. Return the result of " "the SMTP ``QUIT`` command." msgstr "" -#: ../src/Doc/library/smtplib.rst:352 +#: library/smtplib.rst:348 +msgid "Return a value." +msgstr "" + +#: library/smtplib.rst:352 msgid "" "Low-level methods corresponding to the standard SMTP/ESMTP commands " "``HELP``, ``RSET``, ``NOOP``, ``MAIL``, ``RCPT``, and ``DATA`` are also " @@ -88962,11 +90779,11 @@ msgid "" "documented here. For details, consult the module code." msgstr "" -#: ../src/Doc/library/smtplib.rst:361 +#: library/smtplib.rst:361 msgid "SMTP Example" msgstr "" -#: ../src/Doc/library/smtplib.rst:363 +#: library/smtplib.rst:363 msgid "" "This example prompts the user for addresses needed in the message envelope " "('To' and 'From' addresses), and the message to be delivered. Note that the " @@ -88976,23 +90793,23 @@ msgid "" "headers explicitly. ::" msgstr "" -#: ../src/Doc/library/smtplib.rst:399 +#: library/smtplib.rst:399 msgid "" "In general, you will want to use the :mod:`email` package's features to " "construct an email message, which you can then convert to a string and send " "via :meth:`sendmail`; see :ref:`email-examples`." msgstr "" -#: ../src/Doc/library/sndhdr.rst:2 +#: library/sndhdr.rst:2 msgid ":mod:`sndhdr` --- Determine type of sound file" msgstr "" # b0c40522da2b4c1db0e3ef6068328a56 -#: ../src/Doc/library/sndhdr.rst:13 +#: library/sndhdr.rst:13 msgid "**Source code:** :source:`Lib/sndhdr.py`" msgstr "" -#: ../src/Doc/library/sndhdr.rst:17 +#: library/sndhdr.rst:17 msgid "" "The :mod:`sndhdr` provides utility functions which attempt to determine the " "type of sound data which is in a file. When these functions are able to " @@ -89009,39 +90826,39 @@ msgid "" "``'A'`` for A-LAW or ``'U'`` for u-LAW." msgstr "" -#: ../src/Doc/library/sndhdr.rst:33 +#: library/sndhdr.rst:33 msgid "" "Determines the type of sound data stored in the file *filename* using :func:" "`whathdr`. If it succeeds, returns a tuple as described above, otherwise " "``None`` is returned." msgstr "" -#: ../src/Doc/library/sndhdr.rst:40 +#: library/sndhdr.rst:40 msgid "" "Determines the type of sound data stored in a file based on the file " "header. The name of the file is given by *filename*. This function returns " "a tuple as described above on success, or ``None``." msgstr "" -#: ../src/Doc/library/socket.rst:2 +#: library/socket.rst:2 msgid ":mod:`socket` --- Low-level networking interface" msgstr "" # 7bca34c9585e42b2b9a3d73cf602641b -#: ../src/Doc/library/socket.rst:8 +#: library/socket.rst:8 msgid "" "This module provides access to the BSD *socket* interface. It is available " "on all modern Unix systems, Windows, Mac OS X, BeOS, OS/2, and probably " "additional platforms." msgstr "" -#: ../src/Doc/library/socket.rst:14 +#: library/socket.rst:14 msgid "" "Some behavior may be platform dependent, since calls are made to the " "operating system socket APIs." msgstr "" -#: ../src/Doc/library/socket.rst:17 +#: library/socket.rst:17 msgid "" "For an introduction to socket programming (in C), see the following papers: " "An Introductory 4.3BSD Interprocess Communication Tutorial, by Stuart " @@ -89056,7 +90873,7 @@ msgid "" msgstr "" # 41e60d370dfb4ec78b5338f704b9ccec -#: ../src/Doc/library/socket.rst:29 +#: library/socket.rst:29 msgid "" "The Python interface is a straightforward transliteration of the Unix system " "call and library interface for sockets to Python's object-oriented style: " @@ -89068,7 +90885,7 @@ msgid "" msgstr "" # e5480fa01a2a474a9dd9799d7ab84b5e -#: ../src/Doc/library/socket.rst:37 +#: library/socket.rst:37 msgid "" "Socket addresses are represented as follows: A single string is used for " "the :const:`AF_UNIX` address family. A pair ``(host, port)`` is used for " @@ -89086,7 +90903,7 @@ msgid "" "the socket object was created." msgstr "" -#: ../src/Doc/library/socket.rst:52 +#: library/socket.rst:52 msgid "" "For IPv4 addresses, two special forms are accepted instead of a host " "address: the empty string represents :const:`INADDR_ANY`, and the string " @@ -89095,7 +90912,7 @@ msgid "" "avoid these if you intend to support IPv6 with your Python programs." msgstr "" -#: ../src/Doc/library/socket.rst:58 +#: library/socket.rst:58 msgid "" "If you use a hostname in the *host* portion of IPv4/v6 socket address, the " "program may show a nondeterministic behavior, as Python uses the first " @@ -89105,60 +90922,73 @@ msgid "" "deterministic behavior use a numeric address in *host* portion." msgstr "" +#: library/socket.rst:65 +msgid "AF_NETLINK sockets are represented as pairs ``pid, groups``." +msgstr "" + +#: library/socket.rst:68 +msgid "" +"Linux-only support for TIPC is also available using the :const:`AF_TIPC` " +"address family. TIPC is an open, non-IP based networked protocol designed " +"for use in clustered computer environments. Addresses are represented by a " +"tuple, and the fields depend on the address type. The general tuple form is " +"``(addr_type, v1, v2, v3 [, scope])``, where:" +msgstr "" + # 52e618a8c8c34cf68cfad708b92cf028 -#: ../src/Doc/library/socket.rst:75 +#: library/socket.rst:75 msgid "" "*addr_type* is one of :const:`TIPC_ADDR_NAMESEQ`, :const:`TIPC_ADDR_NAME`, " "or :const:`TIPC_ADDR_ID`." msgstr "" # 119054c82d244b85802c383b022ea913 -#: ../src/Doc/library/socket.rst:77 +#: library/socket.rst:77 msgid "" "*scope* is one of :const:`TIPC_ZONE_SCOPE`, :const:`TIPC_CLUSTER_SCOPE`, " "and :const:`TIPC_NODE_SCOPE`." msgstr "" # eb00823af01a4e949e87f2d6c71eed04 -#: ../src/Doc/library/socket.rst:79 +#: library/socket.rst:79 msgid "" "If *addr_type* is :const:`TIPC_ADDR_NAME`, then *v1* is the server type, " "*v2* is the port identifier, and *v3* should be 0." msgstr "" # 85eca52cf3754a4ab21b9e207f3f343c -#: ../src/Doc/library/socket.rst:82 +#: library/socket.rst:82 msgid "" "If *addr_type* is :const:`TIPC_ADDR_NAMESEQ`, then *v1* is the server type, " "*v2* is the lower port number, and *v3* is the upper port number." msgstr "" # a76567894e8540fa92088897bb0a4485 -#: ../src/Doc/library/socket.rst:85 +#: library/socket.rst:85 msgid "" "If *addr_type* is :const:`TIPC_ADDR_ID`, then *v1* is the node, *v2* is the " "reference, and *v3* should be set to 0." msgstr "" -#: ../src/Doc/library/socket.rst:89 +#: library/socket.rst:89 msgid "" "All errors raise exceptions. The normal exceptions for invalid argument " "types and out-of-memory conditions can be raised; errors related to socket " "or address semantics raise the error :exc:`socket.error`." msgstr "" -#: ../src/Doc/library/socket.rst:93 +#: library/socket.rst:93 msgid "" "Non-blocking mode is supported through :meth:`~socket.setblocking`. A " "generalization of this based on timeouts is supported through :meth:`~socket." "settimeout`." msgstr "" -#: ../src/Doc/library/socket.rst:97 +#: library/socket.rst:97 msgid "The module :mod:`socket` exports the following constants and functions:" msgstr "" -#: ../src/Doc/library/socket.rst:104 +#: library/socket.rst:104 msgid "" "This exception is raised for socket-related errors. The accompanying value " "is either a string telling what went wrong or a pair ``(errno, string)`` " @@ -89167,7 +90997,11 @@ msgid "" "names for the error codes defined by the underlying operating system." msgstr "" -#: ../src/Doc/library/socket.rst:116 +#: library/socket.rst:110 +msgid ":exc:`socket.error` is now a child class of :exc:`IOError`." +msgstr "" + +#: library/socket.rst:116 msgid "" "This exception is raised for address-related errors, i.e. for functions that " "use *h_errno* in the C API, including :func:`gethostbyname_ex` and :func:" @@ -89175,7 +91009,7 @@ msgid "" msgstr "" # 0195850b2b0b407d94aebb7c34376b77 -#: ../src/Doc/library/socket.rst:120 +#: library/socket.rst:120 msgid "" "The accompanying value is a pair ``(h_errno, string)`` representing an error " "returned by a library call. *string* represents the description of " @@ -89183,7 +91017,7 @@ msgid "" msgstr "" # 273ec05a06444e75b33e391435fbfc32 -#: ../src/Doc/library/socket.rst:127 +#: library/socket.rst:127 msgid "" "This exception is raised for address-related errors, for :func:`getaddrinfo` " "and :func:`getnameinfo`. The accompanying value is a pair ``(error, " @@ -89193,7 +91027,7 @@ msgid "" "`EAI_\\*` constants defined in this module." msgstr "" -#: ../src/Doc/library/socket.rst:137 +#: library/socket.rst:137 msgid "" "This exception is raised when a timeout occurs on a socket which has had " "timeouts enabled via a prior call to :meth:`settimeout`. The accompanying " @@ -89201,21 +91035,21 @@ msgid "" msgstr "" # ac2111f44351483d92358cc6fe58e6a0 -#: ../src/Doc/library/socket.rst:148 +#: library/socket.rst:148 msgid "" "These constants represent the address (and protocol) families, used for the " "first argument to :func:`.socket`. If the :const:`AF_UNIX` constant is not " "defined then this protocol is unsupported." msgstr "" -#: ../src/Doc/library/socket.rst:159 +#: library/socket.rst:159 msgid "" "These constants represent the socket types, used for the second argument to :" "func:`socket`. (Only :const:`SOCK_STREAM` and :const:`SOCK_DGRAM` appear to " "be generally useful.)" msgstr "" -#: ../src/Doc/library/socket.rst:178 +#: library/socket.rst:178 msgid "" "Many constants of these forms, documented in the Unix documentation on " "sockets and/or the IP protocol, are also defined in the socket module. They " @@ -89226,26 +91060,26 @@ msgid "" msgstr "" # 2582ffeb855f40fcaa5f6a4709e1ce6b -#: ../src/Doc/library/socket.rst:188 +#: library/socket.rst:188 msgid "" "Constants for Windows' WSAIoctl(). The constants are used as arguments to " "the :meth:`~socket.socket.ioctl` method of socket objects." msgstr "" -#: ../src/Doc/library/socket.rst:195 +#: library/socket.rst:195 msgid "" "TIPC related constants, matching the ones exported by the C socket API. See " "the TIPC documentation for more information." msgstr "" -#: ../src/Doc/library/socket.rst:202 +#: library/socket.rst:202 msgid "" "This constant contains a boolean value which indicates if IPv6 is supported " "on this platform." msgstr "" # 0e11c4163fd7466f89ad3b91f76689b0 -#: ../src/Doc/library/socket.rst:210 +#: library/socket.rst:210 msgid "" "Connect to a TCP service listening on the Internet *address* (a 2-tuple " "``(host, port)``), and return the socket object. This is a higher-level " @@ -89257,21 +91091,21 @@ msgid "" msgstr "" # e36681fdf8a04d90a0666be978fdfb32 -#: ../src/Doc/library/socket.rst:218 +#: library/socket.rst:218 msgid "" "Passing the optional *timeout* parameter will set the timeout on the socket " "instance before attempting to connect. If no *timeout* is supplied, the " "global default timeout setting returned by :func:`getdefaulttimeout` is used." msgstr "" -#: ../src/Doc/library/socket.rst:223 +#: library/socket.rst:223 msgid "" "If supplied, *source_address* must be a 2-tuple ``(host, port)`` for the " "socket to bind to as its source address before connecting. If host or port " "are '' or 0 respectively the OS default behavior will be used." msgstr "" -#: ../src/Doc/library/socket.rst:235 +#: library/socket.rst:235 msgid "" "Translate the *host*/*port* argument into a sequence of 5-tuples that " "contain all the necessary arguments for creating a socket connected to that " @@ -89282,7 +91116,7 @@ msgid "" msgstr "" # 7c04a61cc20e47648194dda1728f9043 -#: ../src/Doc/library/socket.rst:242 +#: library/socket.rst:242 msgid "" "The *family*, *socktype* and *proto* arguments can be optionally specified " "in order to narrow the list of addresses returned. By default, their value " @@ -89293,16 +91127,16 @@ msgid "" "will raise an error if *host* is a domain name." msgstr "" -#: ../src/Doc/library/socket.rst:250 +#: library/socket.rst:250 msgid "The function returns a list of 5-tuples with the following structure:" msgstr "" -#: ../src/Doc/library/socket.rst:252 +#: library/socket.rst:252 msgid "``(family, socktype, proto, canonname, sockaddr)``" msgstr "" # 6db1bf9f6ded477ca9fed7510644aff1 -#: ../src/Doc/library/socket.rst:254 +#: library/socket.rst:254 msgid "" "In these tuples, *family*, *socktype*, *proto* are all integers and are " "meant to be passed to the :func:`.socket` function. *canonname* will be a " @@ -89314,14 +91148,14 @@ msgid "" "`AF_INET6`), and is meant to be passed to the :meth:`socket.connect` method." msgstr "" -#: ../src/Doc/library/socket.rst:264 +#: library/socket.rst:264 msgid "" "The following example fetches address information for a hypothetical TCP " -"connection to ``www.python.org`` on port 80 (results may differ on your " -"system if IPv6 isn't enabled)::" +"connection to ``example.org`` on port 80 (results may differ on your system " +"if IPv6 isn't enabled)::" msgstr "" -#: ../src/Doc/library/socket.rst:277 +#: library/socket.rst:277 msgid "" "Return a fully qualified domain name for *name*. If *name* is omitted or " "empty, it is interpreted as the local host. To find the fully qualified " @@ -89331,7 +91165,7 @@ msgid "" "hostname as returned by :func:`gethostname` is returned." msgstr "" -#: ../src/Doc/library/socket.rst:289 +#: library/socket.rst:289 msgid "" "Translate a host name to IPv4 address format. The IPv4 address is returned " "as a string, such as ``'100.50.200.5'``. If the host name is an IPv4 " @@ -89341,7 +91175,7 @@ msgid "" "stack support." msgstr "" -#: ../src/Doc/library/socket.rst:298 +#: library/socket.rst:298 msgid "" "Translate a host name to IPv4 address format, extended interface. Return a " "triple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is the primary " @@ -89353,13 +91187,13 @@ msgid "" "IPv4/v6 dual stack support." msgstr "" -#: ../src/Doc/library/socket.rst:310 +#: library/socket.rst:310 msgid "" "Return a string containing the hostname of the machine where the Python " "interpreter is currently executing." msgstr "" -#: ../src/Doc/library/socket.rst:313 +#: library/socket.rst:313 msgid "" "If you want to know the current machine's IP address, you may want to use " "``gethostbyname(gethostname())``. This operation assumes that there is a " @@ -89367,13 +91201,13 @@ msgid "" "always hold." msgstr "" -#: ../src/Doc/library/socket.rst:318 +#: library/socket.rst:318 msgid "" "Note: :func:`gethostname` doesn't always return the fully qualified domain " "name; use ``getfqdn()`` (see above)." msgstr "" -#: ../src/Doc/library/socket.rst:324 +#: library/socket.rst:324 msgid "" "Return a triple ``(hostname, aliaslist, ipaddrlist)`` where *hostname* is " "the primary host name responding to the given *ip_address*, *aliaslist* is a " @@ -89384,7 +91218,7 @@ msgid "" "`gethostbyaddr` supports both IPv4 and IPv6." msgstr "" -#: ../src/Doc/library/socket.rst:335 +#: library/socket.rst:335 msgid "" "Translate a socket address *sockaddr* into a 2-tuple ``(host, port)``. " "Depending on the settings of *flags*, the result can contain a fully-" @@ -89393,7 +91227,7 @@ msgid "" msgstr "" # ac6a76bbb901420db2665dd43b9e2543 -#: ../src/Doc/library/socket.rst:345 +#: library/socket.rst:345 msgid "" "Translate an Internet protocol name (for example, ``'icmp'``) to a constant " "suitable for passing as the (optional) third argument to the :func:`.socket` " @@ -89402,21 +91236,21 @@ msgid "" "chosen automatically if the protocol is omitted or zero." msgstr "" -#: ../src/Doc/library/socket.rst:354 +#: library/socket.rst:354 msgid "" "Translate an Internet service name and protocol name to a port number for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" -#: ../src/Doc/library/socket.rst:361 +#: library/socket.rst:361 msgid "" "Translate an Internet port number and protocol name to a service name for " "that service. The optional protocol name, if given, should be ``'tcp'`` or " "``'udp'``, otherwise any protocol will match." msgstr "" -#: ../src/Doc/library/socket.rst:368 +#: library/socket.rst:368 msgid "" "Create a new socket using the given address family, socket type and protocol " "number. The address family should be :const:`AF_INET` (the default), :const:" @@ -89427,7 +91261,7 @@ msgid "" msgstr "" # e67922d101af4ad9a5a5b88e37f5f7d2 -#: ../src/Doc/library/socket.rst:378 +#: library/socket.rst:378 msgid "" "Build a pair of connected socket objects using the given address family, " "socket type, and protocol number. Address family, socket type, and protocol " @@ -89437,7 +91271,7 @@ msgid "" msgstr "" # 8b5bfa983fa2487dab6bcb76a4494004 -#: ../src/Doc/library/socket.rst:389 +#: library/socket.rst:389 msgid "" "Duplicate the file descriptor *fd* (an integer as returned by a file " "object's :meth:`fileno` method) and build a socket object from the result. " @@ -89450,28 +91284,28 @@ msgid "" "socket is assumed to be in blocking mode. Availability: Unix." msgstr "" -#: ../src/Doc/library/socket.rst:402 +#: library/socket.rst:402 msgid "" "Convert 32-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" -#: ../src/Doc/library/socket.rst:409 +#: library/socket.rst:409 msgid "" "Convert 16-bit positive integers from network to host byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 2-byte swap operation." msgstr "" -#: ../src/Doc/library/socket.rst:416 +#: library/socket.rst:416 msgid "" "Convert 32-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " "is a no-op; otherwise, it performs a 4-byte swap operation." msgstr "" -#: ../src/Doc/library/socket.rst:423 +#: library/socket.rst:423 msgid "" "Convert 16-bit positive integers from host to network byte order. On " "machines where the host byte order is the same as network byte order, this " @@ -89479,7 +91313,7 @@ msgid "" msgstr "" # 5c7ffaa5ec05458298e057daf9a3d1b0 -#: ../src/Doc/library/socket.rst:430 +#: library/socket.rst:430 msgid "" "Convert an IPv4 address from dotted-quad string format (for example, " "'123.45.67.89') to 32-bit packed binary format, as a string four characters " @@ -89488,28 +91322,28 @@ msgid "" "is the C type for the 32-bit packed binary this function returns." msgstr "" -#: ../src/Doc/library/socket.rst:436 +#: library/socket.rst:436 msgid "" ":func:`inet_aton` also accepts strings with less than three dots; see the " "Unix manual page :manpage:`inet(3)` for details." msgstr "" # 414706b958b3461e9797ba660b13902c -#: ../src/Doc/library/socket.rst:439 +#: library/socket.rst:439 msgid "" "If the IPv4 address string passed to this function is invalid, :exc:`socket." "error` will be raised. Note that exactly what is valid depends on the " "underlying C implementation of :c:func:`inet_aton`." msgstr "" -#: ../src/Doc/library/socket.rst:443 +#: library/socket.rst:443 msgid "" ":func:`inet_aton` does not support IPv6, and :func:`inet_pton` should be " "used instead for IPv4/v6 dual stack support." msgstr "" # 3eb16905396f44969dccd69a7011d553 -#: ../src/Doc/library/socket.rst:449 +#: library/socket.rst:449 msgid "" "Convert a 32-bit packed IPv4 address (a string four characters in length) to " "its standard dotted-quad string representation (for example, " @@ -89520,7 +91354,7 @@ msgid "" msgstr "" # 80c232f494d74882976bf0ade75d48ec -#: ../src/Doc/library/socket.rst:455 +#: library/socket.rst:455 msgid "" "If the string passed to this function is not exactly 4 bytes in length, :exc:" "`socket.error` will be raised. :func:`inet_ntoa` does not support IPv6, and :" @@ -89528,7 +91362,7 @@ msgid "" msgstr "" # d2fb891f133f442b9588760bf8040e2c -#: ../src/Doc/library/socket.rst:462 +#: library/socket.rst:462 msgid "" "Convert an IP address from its family-specific string format to a packed, " "binary format. :func:`inet_pton` is useful when a library or network " @@ -89537,7 +91371,7 @@ msgid "" msgstr "" # 877a2d6924524c79a049cbc758113163 -#: ../src/Doc/library/socket.rst:467 +#: library/socket.rst:467 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the IP address string *ip_string* is invalid, :exc:" @@ -89546,12 +91380,12 @@ msgid "" "func:`inet_pton`." msgstr "" -#: ../src/Doc/library/socket.rst:473 ../src/Doc/library/socket.rst:491 +#: library/socket.rst:473 library/socket.rst:491 msgid "Availability: Unix (maybe not all platforms)." msgstr "" # fad4cf1c69724914875c7faae826788c -#: ../src/Doc/library/socket.rst:480 +#: library/socket.rst:480 msgid "" "Convert a packed IP address (a string of some number of characters) to its " "standard, family-specific string representation (for example, ``'7.10.0.5'`` " @@ -89560,7 +91394,7 @@ msgid "" "func:`inet_ntoa`) or :c:type:`struct in6_addr`." msgstr "" -#: ../src/Doc/library/socket.rst:486 +#: library/socket.rst:486 msgid "" "Supported values for *address_family* are currently :const:`AF_INET` and :" "const:`AF_INET6`. If the string *packed_ip* is not the correct length for " @@ -89569,7 +91403,7 @@ msgid "" msgstr "" # 9e04a09efdf840e2a248bc4769f70bd9 -#: ../src/Doc/library/socket.rst:498 +#: library/socket.rst:498 msgid "" "Return the default timeout in seconds (float) for new socket objects. A " "value of ``None`` indicates that new socket objects have no timeout. When " @@ -89577,49 +91411,48 @@ msgid "" msgstr "" # 4f4d0c62f0db46169351a68813fbfc7d -#: ../src/Doc/library/socket.rst:507 +#: library/socket.rst:507 msgid "" "Set the default timeout in seconds (float) for new socket objects. A value " "of ``None`` indicates that new socket objects have no timeout. When the " "socket module is first imported, the default is ``None``." msgstr "" -#: ../src/Doc/library/socket.rst:516 +#: library/socket.rst:516 msgid "" "This is a Python type object that represents the socket object type. It is " "the same as ``type(socket(...))``." msgstr "" -# a36b0fe6d9d24457b31ce313423be208 -#: ../src/Doc/library/socket.rst:522 -msgid "Module :mod:`SocketServer`" +#: library/socket.rst:523 +msgid "Module SocketServer" msgstr "" -#: ../src/Doc/library/socket.rst:523 +#: library/socket.rst:523 msgid "Classes that simplify writing network servers." msgstr "" -# e5cd4175037a40759ccd3ec20f39350d -#: ../src/Doc/library/socket.rst:524 -msgid "Module :mod:`ssl`" -msgstr "" +#: library/socket.rst:525 +#, fuzzy +msgid "Module ssl" +msgstr "Modules" # dd0927ecff5d45588c19a7661f575472 -#: ../src/Doc/library/socket.rst:526 +#: library/socket.rst:526 msgid "A TLS/SSL wrapper for socket objects." msgstr "" -#: ../src/Doc/library/socket.rst:532 +#: library/socket.rst:532 msgid "Socket Objects" msgstr "" -#: ../src/Doc/library/socket.rst:534 +#: library/socket.rst:534 msgid "" "Socket objects have the following methods. Except for :meth:`makefile` " "these correspond to Unix system calls applicable to sockets." msgstr "" -#: ../src/Doc/library/socket.rst:540 +#: library/socket.rst:540 msgid "" "Accept a connection. The socket must be bound to an address and listening " "for connections. The return value is a pair ``(conn, address)`` where *conn* " @@ -89628,7 +91461,7 @@ msgid "" "connection." msgstr "" -#: ../src/Doc/library/socket.rst:548 +#: library/socket.rst:548 msgid "" "Bind the socket to *address*. The socket must not already be bound. (The " "format of *address* depends on the address family --- see above.)" @@ -89636,14 +91469,14 @@ msgstr "" # ef8f69d9152349ed81aaaa6b7e605de0 # 7258572cc2654c7e89dab9f9fa981987 -#: ../src/Doc/library/socket.rst:553 ../src/Doc/library/socket.rst:579 +#: library/socket.rst:553 library/socket.rst:579 msgid "" "This method has historically accepted a pair of parameters for :const:" "`AF_INET` addresses instead of only a tuple. This was never intentional and " "is no longer available in Python 2.0 and later." msgstr "" -#: ../src/Doc/library/socket.rst:560 +#: library/socket.rst:560 msgid "" "Close the socket. All future operations on the socket object will fail. The " "remote end will receive no more data (after queued data is flushed). Sockets " @@ -89651,7 +91484,7 @@ msgid "" msgstr "" # c47e128675b443ba9f1415c4c6a5dcb5 -#: ../src/Doc/library/socket.rst:566 +#: library/socket.rst:566 msgid "" ":meth:`close()` releases the resource associated with a connection but does " "not necessarily close the connection immediately. If you want to close the " @@ -89659,14 +91492,14 @@ msgid "" "`close()`." msgstr "" -#: ../src/Doc/library/socket.rst:574 +#: library/socket.rst:574 msgid "" "Connect to a remote socket at *address*. (The format of *address* depends on " "the address family --- see above.)" msgstr "" # e3b57bb2519647e283fd856d26dc9f75 -#: ../src/Doc/library/socket.rst:586 +#: library/socket.rst:586 msgid "" "Like ``connect(address)``, but return an error indicator instead of raising " "an exception for errors returned by the C-level :c:func:`connect` call " @@ -89677,27 +91510,27 @@ msgid "" msgstr "" # ca546eccc3fd4bd69aa150d84c610e17 -#: ../src/Doc/library/socket.rst:595 +#: library/socket.rst:595 msgid "" "This method has historically accepted a pair of parameters for :const:" "`AF_INET` addresses instead of only a tuple. This was never intentional and " "is no longer available in Python 2.0 and later." msgstr "" -#: ../src/Doc/library/socket.rst:602 +#: library/socket.rst:602 msgid "" "Return the socket's file descriptor (a small integer). This is useful with :" "func:`select.select`." msgstr "" -#: ../src/Doc/library/socket.rst:605 +#: library/socket.rst:605 msgid "" "Under Windows the small integer returned by this method cannot be used where " "a file descriptor can be used (such as :func:`os.fdopen`). Unix does not " "have this limitation." msgstr "" -#: ../src/Doc/library/socket.rst:612 +#: library/socket.rst:612 msgid "" "Return the remote address to which the socket is connected. This is useful " "to find out the port number of a remote IPv4/v6 socket, for instance. (The " @@ -89705,7 +91538,7 @@ msgid "" "above.) On some systems this function is not supported." msgstr "" -#: ../src/Doc/library/socket.rst:620 +#: library/socket.rst:620 msgid "" "Return the socket's own address. This is useful to find out the port number " "of an IPv4/v6 socket, for instance. (The format of the address returned " @@ -89713,7 +91546,7 @@ msgid "" msgstr "" # e97b6c03c87a4a939179fd77474543a2 -#: ../src/Doc/library/socket.rst:627 +#: library/socket.rst:627 msgid "" "Return the value of the given socket option (see the Unix man page :manpage:" "`getsockopt(2)`). The needed symbolic constants (:const:`SO_\\*` etc.) are " @@ -89725,21 +91558,21 @@ msgid "" "for a way to decode C structures encoded as strings)." msgstr "" -#: ../src/Doc/library/socket.rst:641 +#: library/socket.rst:641 msgid "" "The :meth:`ioctl` method is a limited interface to the WSAIoctl system " "interface. Please refer to the `Win32 documentation <http://msdn.microsoft." "com/en-us/library/ms741621%28VS.85%29.aspx>`_ for more information." msgstr "" -#: ../src/Doc/library/socket.rst:646 +#: library/socket.rst:646 msgid "" "On other platforms, the generic :func:`fcntl.fcntl` and :func:`fcntl.ioctl` " "functions may be used; they accept a socket object as their first argument." msgstr "" # 0aa1099273ad46188ecc40d362d1591c -#: ../src/Doc/library/socket.rst:654 +#: library/socket.rst:654 msgid "" "Listen for connections made to the socket. The *backlog* argument specifies " "the maximum number of queued connections and should be at least 0; the " @@ -89748,7 +91581,7 @@ msgid "" msgstr "" # 1411b4f9c75b4bd4b0433a7889ed4e06 -#: ../src/Doc/library/socket.rst:663 +#: library/socket.rst:663 msgid "" "Return a :dfn:`file object` associated with the socket. (File objects are " "described in :ref:`bltin-file-objects`.) The file object does not close the " @@ -89758,7 +91591,7 @@ msgid "" msgstr "" # 1411b4f9c75b4bd4b0433a7889ed4e06 -#: ../src/Doc/library/socket.rst:669 +#: library/socket.rst:669 msgid "" "The socket must be in blocking mode (it can not have a timeout). The " "optional *mode* and *bufsize* arguments are interpreted the same way as by " @@ -89766,7 +91599,7 @@ msgid "" msgstr "" # 4067a6e08ec94eb99ee9472371bfcf23 -#: ../src/Doc/library/socket.rst:675 +#: library/socket.rst:675 msgid "" "On Windows, the file-like object created by :meth:`makefile` cannot be used " "where a file object with a file descriptor is expected, such as the stream " @@ -89774,7 +91607,7 @@ msgid "" msgstr "" # ecb70292a8b74c04b05b4b79cddadf24 -#: ../src/Doc/library/socket.rst:682 +#: library/socket.rst:682 msgid "" "Receive data from the socket. The return value is a string representing the " "data received. The maximum amount of data to be received at once is " @@ -89782,14 +91615,14 @@ msgid "" "meaning of the optional argument *flags*; it defaults to zero." msgstr "" -#: ../src/Doc/library/socket.rst:689 +#: library/socket.rst:689 msgid "" "For best match with hardware and network realities, the value of *bufsize* " "should be a relatively small power of 2, for example, 4096." msgstr "" # 9fa51604a3954dd7af32f4e3aa64b54d -#: ../src/Doc/library/socket.rst:695 +#: library/socket.rst:695 msgid "" "Receive data from the socket. The return value is a pair ``(string, " "address)`` where *string* is a string representing the data received and " @@ -89800,7 +91633,7 @@ msgid "" msgstr "" # 4614a3a568e94971814c853b3da92dda -#: ../src/Doc/library/socket.rst:704 +#: library/socket.rst:704 msgid "" "Receive data from the socket, writing it into *buffer* instead of creating " "a new string. The return value is a pair ``(nbytes, address)`` where " @@ -89811,7 +91644,7 @@ msgid "" msgstr "" # 18e734481cfd4d84b658f0d35b35e62d -#: ../src/Doc/library/socket.rst:716 +#: library/socket.rst:716 msgid "" "Receive up to *nbytes* bytes from the socket, storing the data into a buffer " "rather than creating a new string. If *nbytes* is not specified (or 0), " @@ -89821,7 +91654,7 @@ msgid "" msgstr "" # f59752df53c5489f9948acee83696b13 -#: ../src/Doc/library/socket.rst:727 +#: library/socket.rst:727 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " @@ -89833,7 +91666,7 @@ msgid "" msgstr "" # 1148f27dbe504b7a92ff32c66d8f9a87 -#: ../src/Doc/library/socket.rst:737 +#: library/socket.rst:737 msgid "" "Send data to the socket. The socket must be connected to a remote socket. " "The optional *flags* argument has the same meaning as for :meth:`recv` " @@ -89843,7 +91676,7 @@ msgid "" "to determine how much data, if any, was successfully sent." msgstr "" -#: ../src/Doc/library/socket.rst:748 +#: library/socket.rst:748 msgid "" "Send data to the socket. The socket should not be connected to a remote " "socket, since the destination socket is specified by *address*. The " @@ -89852,7 +91685,7 @@ msgid "" "address family --- see above.)" msgstr "" -#: ../src/Doc/library/socket.rst:757 +#: library/socket.rst:757 msgid "" "Set blocking or non-blocking mode of the socket: if *flag* is 0, the socket " "is set to non-blocking, else to blocking mode. Initially all sockets are in " @@ -89864,7 +91697,7 @@ msgid "" "settimeout(None)``." msgstr "" -#: ../src/Doc/library/socket.rst:768 +#: library/socket.rst:768 msgid "" "Set a timeout on blocking socket operations. The *value* argument can be a " "nonnegative float expressing seconds, or ``None``. If a float is given, " @@ -89876,14 +91709,14 @@ msgid "" msgstr "" # d6bb702b240f46e88b3c083c2144efec -#: ../src/Doc/library/socket.rst:781 +#: library/socket.rst:781 msgid "" "Return the timeout in seconds (float) associated with socket operations, or " "``None`` if no timeout is set. This reflects the last call to :meth:" "`setblocking` or :meth:`settimeout`." msgstr "" -#: ../src/Doc/library/socket.rst:787 +#: library/socket.rst:787 msgid "" "Some notes on socket blocking and timeouts: A socket object can be in one of " "three modes: blocking, non-blocking, or timeout. Sockets are always created " @@ -89896,7 +91729,7 @@ msgid "" "simply a shorthand for certain :meth:`~socket.settimeout` calls." msgstr "" -#: ../src/Doc/library/socket.rst:797 +#: library/socket.rst:797 msgid "" "Timeout mode internally sets the socket in non-blocking mode. The blocking " "and timeout modes are shared between file descriptors and socket objects " @@ -89906,7 +91739,7 @@ msgid "" "operations that cannot be completed immediately will fail." msgstr "" -#: ../src/Doc/library/socket.rst:804 +#: library/socket.rst:804 msgid "" "Note that the :meth:`~socket.connect` operation is subject to the timeout " "setting, and in general it is recommended to call :meth:`~socket.settimeout` " @@ -89916,7 +91749,7 @@ msgid "" msgstr "" # 5b8dac27e42c4f2b8c851ccdec88b80a -#: ../src/Doc/library/socket.rst:815 +#: library/socket.rst:815 msgid "" "Set the value of the given socket option (see the Unix manual page :manpage:" "`setsockopt(2)`). The needed symbolic constants are defined in the :mod:" @@ -89927,7 +91760,7 @@ msgid "" msgstr "" # b526341830e84d389d6fee37f33e71bd -#: ../src/Doc/library/socket.rst:825 +#: library/socket.rst:825 msgid "" "Shut down one or both halves of the connection. If *how* is :const:" "`SHUT_RD`, further receives are disallowed. If *how* is :const:`SHUT_WR`, " @@ -89938,32 +91771,32 @@ msgid "" "connection)." msgstr "" -#: ../src/Doc/library/socket.rst:832 +#: library/socket.rst:832 msgid "" "Note that there are no methods :meth:`read` or :meth:`write`; use :meth:" "`~socket.recv` and :meth:`~socket.send` without *flags* argument instead." msgstr "" -#: ../src/Doc/library/socket.rst:835 +#: library/socket.rst:835 msgid "" "Socket objects also have these (read-only) attributes that correspond to the " "values given to the :class:`socket` constructor." msgstr "" -#: ../src/Doc/library/socket.rst:841 +#: library/socket.rst:841 msgid "The socket family." msgstr "" -#: ../src/Doc/library/socket.rst:848 +#: library/socket.rst:848 msgid "The socket type." msgstr "" -#: ../src/Doc/library/socket.rst:855 +#: library/socket.rst:855 msgid "The socket protocol." msgstr "" # d19c4e1a3f2f4845af1a08793ee66495 -#: ../src/Doc/library/socket.rst:865 +#: library/socket.rst:865 msgid "" "Here are four minimal example programs using the TCP/IP protocol: a server " "that echoes all data that it receives back (servicing only one client), and " @@ -89976,11 +91809,11 @@ msgid "" "new socket returned by :meth:`~socket.accept`." msgstr "" -#: ../src/Doc/library/socket.rst:875 +#: library/socket.rst:875 msgid "The first two examples support IPv4 only. ::" msgstr "" -#: ../src/Doc/library/socket.rst:907 +#: library/socket.rst:907 msgid "" "The next two examples are identical to the above two, but support both IPv4 " "and IPv6. The server side will listen to the first address family available " @@ -89990,7 +91823,7 @@ msgid "" "resolution, and sends traffic to the first one connected successfully. ::" msgstr "" -#: ../src/Doc/library/socket.rst:980 +#: library/socket.rst:980 msgid "" "The last example shows how to write a very simple network sniffer with raw " "sockets on Windows. The example requires administrator privileges to modify " @@ -89998,40 +91831,40 @@ msgid "" msgstr "" # 8da094ac4b87494e9ecc82c9785cd2aa -#: ../src/Doc/library/socket.rst:1006 +#: library/socket.rst:1006 msgid "" "Running an example several times with too small delay between executions, " "could lead to this error::" msgstr "" # 3e794ab773f640c2916b7680a032bccd -#: ../src/Doc/library/socket.rst:1011 +#: library/socket.rst:1011 msgid "" "This is because the previous execution has left the socket in a " "``TIME_WAIT`` state, and can't be immediately reused." msgstr "" # 9c744f8d08c3413593c5ab8565575050 -#: ../src/Doc/library/socket.rst:1014 +#: library/socket.rst:1014 msgid "" "There is a :mod:`socket` flag to set, in order to prevent this, :data:" "`socket.SO_REUSEADDR`::" msgstr "" # 3808b85057d94e1581c81349a440e9ee -#: ../src/Doc/library/socket.rst:1021 +#: library/socket.rst:1021 msgid "" "the :data:`SO_REUSEADDR` flag tells the kernel to reuse a local socket in " "``TIME_WAIT`` state, without waiting for its natural timeout to expire." msgstr "" # d619a76be511419baabec2a9b2ae420e -#: ../src/Doc/library/socketserver.rst:2 +#: library/socketserver.rst:2 msgid ":mod:`SocketServer` --- A framework for network servers" msgstr "" # 532587a6fc4547ef90b62b488746776b -#: ../src/Doc/library/socketserver.rst:9 +#: library/socketserver.rst:9 msgid "" "The :mod:`SocketServer` module has been renamed to :mod:`socketserver` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -90039,18 +91872,18 @@ msgid "" msgstr "" # 989d3b0571024469b93647fad44866e5 -#: ../src/Doc/library/socketserver.rst:13 +#: library/socketserver.rst:13 msgid "**Source code:** :source:`Lib/SocketServer.py`" msgstr "" # 16c2701713cb42c3b04ceb680d79382b -#: ../src/Doc/library/socketserver.rst:17 +#: library/socketserver.rst:17 msgid "" "The :mod:`SocketServer` module simplifies the task of writing network " "servers." msgstr "" -#: ../src/Doc/library/socketserver.rst:19 +#: library/socketserver.rst:19 msgid "" "There are four basic server classes: :class:`TCPServer` uses the Internet " "TCP protocol, which provides for continuous streams of data between the " @@ -90063,7 +91896,7 @@ msgid "" "Programming or Ralph Davis's Win32 Network Programming." msgstr "" -#: ../src/Doc/library/socketserver.rst:30 +#: library/socketserver.rst:30 msgid "" "These four classes process requests :dfn:`synchronously`; each request must " "be completed before the next request can be started. This isn't suitable if " @@ -90074,18 +91907,19 @@ msgid "" "classes can be used to support asynchronous behaviour." msgstr "" -#: ../src/Doc/library/socketserver.rst:38 +#: library/socketserver.rst:38 msgid "" "Creating a server requires several steps. First, you must create a request " "handler class by subclassing the :class:`BaseRequestHandler` class and " "overriding its :meth:`handle` method; this method will process incoming " "requests. Second, you must instantiate one of the server classes, passing " -"it the server's address and the request handler class. Finally, call the :" -"meth:`handle_request` or :meth:`serve_forever` method of the server object " -"to process one or many requests." +"it the server's address and the request handler class. Then call the :meth:" +"`handle_request` or :meth:`serve_forever` method of the server object to " +"process one or many requests. Finally, call :meth:`~BaseServer." +"server_close` to close the socket." msgstr "" -#: ../src/Doc/library/socketserver.rst:46 +#: library/socketserver.rst:47 msgid "" "When inheriting from :class:`ThreadingMixIn` for threaded connection " "behavior, you should explicitly declare how you want your threads to behave " @@ -90097,23 +91931,23 @@ msgid "" "`ThreadingMixIn` have exited." msgstr "" -#: ../src/Doc/library/socketserver.rst:54 +#: library/socketserver.rst:55 msgid "" "Server classes have the same external methods and attributes, no matter what " "network protocol they use." msgstr "" -#: ../src/Doc/library/socketserver.rst:59 +#: library/socketserver.rst:60 msgid "Server Creation Notes" msgstr "" -#: ../src/Doc/library/socketserver.rst:61 +#: library/socketserver.rst:62 msgid "" "There are five classes in an inheritance diagram, four of which represent " "synchronous servers of four types::" msgstr "" -#: ../src/Doc/library/socketserver.rst:78 +#: library/socketserver.rst:79 msgid "" "Note that :class:`UnixDatagramServer` derives from :class:`UDPServer`, not " "from :class:`UnixStreamServer` --- the only difference between an IP and a " @@ -90121,7 +91955,7 @@ msgid "" "Unix server classes." msgstr "" -#: ../src/Doc/library/socketserver.rst:83 +#: library/socketserver.rst:84 msgid "" "Forking and threading versions of each type of server can be created using " "the :class:`ForkingMixIn` and :class:`ThreadingMixIn` mix-in classes. For " @@ -90129,14 +91963,14 @@ msgid "" msgstr "" # 3c98719b8647450cb348e16c3437f766 -#: ../src/Doc/library/socketserver.rst:89 +#: library/socketserver.rst:90 msgid "" "The mix-in class must come first, since it overrides a method defined in :" "class:`UDPServer`. Setting the various attributes also change the behavior " "of the underlying server mechanism." msgstr "" -#: ../src/Doc/library/socketserver.rst:93 +#: library/socketserver.rst:94 msgid "" "To implement a service, you must derive a class from :class:" "`BaseRequestHandler` and redefine its :meth:`handle` method. You can then " @@ -90147,7 +91981,7 @@ msgid "" "`DatagramRequestHandler`." msgstr "" -#: ../src/Doc/library/socketserver.rst:100 +#: library/socketserver.rst:101 msgid "" "Of course, you still have to use your head! For instance, it makes no sense " "to use a forking server if the service contains state in memory that can be " @@ -90157,7 +91991,7 @@ msgid "" "probably have to use locks to protect the integrity of the shared data." msgstr "" -#: ../src/Doc/library/socketserver.rst:107 +#: library/socketserver.rst:108 msgid "" "On the other hand, if you are building an HTTP server where all data is " "stored externally (for instance, in the file system), a synchronous class " @@ -90167,7 +92001,7 @@ msgid "" "appropriate." msgstr "" -#: ../src/Doc/library/socketserver.rst:113 +#: library/socketserver.rst:114 msgid "" "In some cases, it may be appropriate to process part of a request " "synchronously, but to finish processing in a forked child depending on the " @@ -90176,7 +92010,7 @@ msgid "" msgstr "" # 8f487a0db5714d9dbeb4848b3df6411d -#: ../src/Doc/library/socketserver.rst:118 +#: library/socketserver.rst:119 msgid "" "Another approach to handling multiple simultaneous requests in an " "environment that supports neither threads nor :func:`~os.fork` (or where " @@ -90189,25 +92023,25 @@ msgid "" "this." msgstr "" -#: ../src/Doc/library/socketserver.rst:132 +#: library/socketserver.rst:133 msgid "Server Objects" msgstr "" -#: ../src/Doc/library/socketserver.rst:136 +#: library/socketserver.rst:137 msgid "" "This is the superclass of all Server objects in the module. It defines the " "interface, given below, but does not implement most of the methods, which is " "done in subclasses." msgstr "" -#: ../src/Doc/library/socketserver.rst:143 +#: library/socketserver.rst:144 msgid "" "Return an integer file descriptor for the socket on which the server is " "listening. This function is most commonly passed to :func:`select.select`, " "to allow monitoring multiple servers in the same process." msgstr "" -#: ../src/Doc/library/socketserver.rst:150 +#: library/socketserver.rst:151 msgid "" "Process a single request. This function calls the following methods in " "order: :meth:`get_request`, :meth:`verify_request`, and :meth:" @@ -90219,7 +92053,7 @@ msgid "" msgstr "" # 69d6ec0fb6dc4e01be96ef5fa7165b26 -#: ../src/Doc/library/socketserver.rst:161 +#: library/socketserver.rst:162 msgid "" "Handle requests until an explicit :meth:`shutdown` request. Poll for " "shutdown every *poll_interval* seconds. Ignores :attr:`self.timeout`. If you " @@ -90227,23 +92061,27 @@ msgid "" msgstr "" # 2cbce1138c7344bdaa2a83a346a3e298 -#: ../src/Doc/library/socketserver.rst:168 +#: library/socketserver.rst:169 msgid "Tell the :meth:`serve_forever` loop to stop and wait until it does." msgstr "" -#: ../src/Doc/library/socketserver.rst:175 +#: library/socketserver.rst:176 +msgid "Clean up the server. May be overridden." +msgstr "" + +#: library/socketserver.rst:183 msgid "" "The family of protocols to which the server's socket belongs. Common " "examples are :const:`socket.AF_INET` and :const:`socket.AF_UNIX`." msgstr "" -#: ../src/Doc/library/socketserver.rst:181 +#: library/socketserver.rst:189 msgid "" "The user-provided request handler class; an instance of this class is " "created for each request." msgstr "" -#: ../src/Doc/library/socketserver.rst:187 +#: library/socketserver.rst:195 msgid "" "The address on which the server is listening. The format of addresses " "varies depending on the protocol family; see the documentation for the " @@ -90252,22 +92090,22 @@ msgid "" "``('127.0.0.1', 80)``, for example." msgstr "" -#: ../src/Doc/library/socketserver.rst:195 +#: library/socketserver.rst:203 msgid "" "The socket object on which the server will listen for incoming requests." msgstr "" -#: ../src/Doc/library/socketserver.rst:198 +#: library/socketserver.rst:206 msgid "The server classes support the following class variables:" msgstr "" -#: ../src/Doc/library/socketserver.rst:204 +#: library/socketserver.rst:212 msgid "" "Whether the server will allow the reuse of an address. This defaults to :" "const:`False`, and can be set in subclasses to change the policy." msgstr "" -#: ../src/Doc/library/socketserver.rst:210 +#: library/socketserver.rst:218 msgid "" "The size of the request queue. If it takes a long time to process a single " "request, any requests that arrive while the server is busy are placed into a " @@ -90276,47 +92114,47 @@ msgid "" "default value is usually 5, but this can be overridden by subclasses." msgstr "" -#: ../src/Doc/library/socketserver.rst:219 +#: library/socketserver.rst:227 msgid "" "The type of socket used by the server; :const:`socket.SOCK_STREAM` and :" "const:`socket.SOCK_DGRAM` are two common values." msgstr "" -#: ../src/Doc/library/socketserver.rst:225 +#: library/socketserver.rst:233 msgid "" "Timeout duration, measured in seconds, or :const:`None` if no timeout is " "desired. If :meth:`handle_request` receives no incoming requests within the " "timeout period, the :meth:`handle_timeout` method is called." msgstr "" -#: ../src/Doc/library/socketserver.rst:230 +#: library/socketserver.rst:238 msgid "" "There are various server methods that can be overridden by subclasses of " "base server classes like :class:`TCPServer`; these methods aren't useful to " "external users of the server object." msgstr "" -#: ../src/Doc/library/socketserver.rst:239 +#: library/socketserver.rst:247 msgid "" "Actually processes the request by instantiating :attr:`RequestHandlerClass` " "and calling its :meth:`handle` method." msgstr "" -#: ../src/Doc/library/socketserver.rst:245 +#: library/socketserver.rst:253 msgid "" "Must accept a request from the socket, and return a 2-tuple containing the " "*new* socket object to be used to communicate with the client, and the " "client's address." msgstr "" -#: ../src/Doc/library/socketserver.rst:252 +#: library/socketserver.rst:260 msgid "" "This function is called if the :attr:`RequestHandlerClass`'s :meth:`handle` " "method raises an exception. The default action is to print the traceback to " "standard output and continue handling further requests." msgstr "" -#: ../src/Doc/library/socketserver.rst:259 +#: library/socketserver.rst:267 msgid "" "This function is called when the :attr:`timeout` attribute has been set to a " "value other than :const:`None` and the timeout period has passed with no " @@ -90325,7 +92163,7 @@ msgid "" "threading servers this method does nothing." msgstr "" -#: ../src/Doc/library/socketserver.rst:268 +#: library/socketserver.rst:276 msgid "" "Calls :meth:`finish_request` to create an instance of the :attr:" "`RequestHandlerClass`. If desired, this function can create a new process " @@ -90333,19 +92171,19 @@ msgid "" "`ThreadingMixIn` classes do this." msgstr "" -#: ../src/Doc/library/socketserver.rst:280 +#: library/socketserver.rst:288 msgid "" "Called by the server's constructor to activate the server. The default " "behavior just :meth:`listen`\\ s to the server's socket. May be overridden." msgstr "" -#: ../src/Doc/library/socketserver.rst:286 +#: library/socketserver.rst:294 msgid "" "Called by the server's constructor to bind the socket to the desired " "address. May be overridden." msgstr "" -#: ../src/Doc/library/socketserver.rst:292 +#: library/socketserver.rst:300 msgid "" "Must return a Boolean value; if the value is :const:`True`, the request will " "be processed, and if it's :const:`False`, the request will be denied. This " @@ -90353,11 +92191,11 @@ msgid "" "default implementation always returns :const:`True`." msgstr "" -#: ../src/Doc/library/socketserver.rst:299 +#: library/socketserver.rst:307 msgid "RequestHandler Objects" msgstr "" -#: ../src/Doc/library/socketserver.rst:301 +#: library/socketserver.rst:309 msgid "" "The request handler class must define a new :meth:`handle` method, and can " "override any of the following methods. A new instance is created for each " @@ -90365,14 +92203,14 @@ msgid "" msgstr "" # 81baf482946f4a668635f406a7bb9a20 -#: ../src/Doc/library/socketserver.rst:308 +#: library/socketserver.rst:316 msgid "" "Called after the :meth:`handle` method to perform any clean-up actions " "required. The default implementation does nothing. If :meth:`setup` raises " "an exception, this function will not be called." msgstr "" -#: ../src/Doc/library/socketserver.rst:315 +#: library/socketserver.rst:323 msgid "" "This function must do all the work required to service a request. The " "default implementation does nothing. Several instance attributes are " @@ -90381,7 +92219,7 @@ msgid "" "attr:`self.server`, in case it needs access to per-server information." msgstr "" -#: ../src/Doc/library/socketserver.rst:321 +#: library/socketserver.rst:329 msgid "" "The type of :attr:`self.request` is different for datagram or stream " "services. For stream services, :attr:`self.request` is a socket object; for " @@ -90394,23 +92232,22 @@ msgid "" "return data to the client." msgstr "" -#: ../src/Doc/library/socketserver.rst:334 +#: library/socketserver.rst:342 msgid "" "Called before the :meth:`handle` method to perform any initialization " "actions required. The default implementation does nothing." msgstr "" # 3a029f01b9d94f2db530319adf158b8c -#: ../src/Doc/library/socketserver.rst:342 +#: library/socketserver.rst:350 msgid ":class:`SocketServer.TCPServer` Example" msgstr "" -#: ../src/Doc/library/socketserver.rst:344 -#: ../src/Doc/library/socketserver.rst:444 +#: library/socketserver.rst:352 library/socketserver.rst:452 msgid "This is the server side::" msgstr "" -#: ../src/Doc/library/socketserver.rst:375 +#: library/socketserver.rst:383 msgid "" "An alternative request handler class that makes use of streams (file-like " "objects that simplify communication by providing the standard file " @@ -90418,7 +92255,7 @@ msgid "" msgstr "" # a0315b8b41e4445fb40129ad82011c56 -#: ../src/Doc/library/socketserver.rst:390 +#: library/socketserver.rst:398 msgid "" "The difference is that the ``readline()`` call in the second handler will " "call ``recv()`` multiple times until it encounters a newline character, " @@ -90426,64 +92263,63 @@ msgid "" "has been sent from the client in one ``sendall()`` call." msgstr "" -#: ../src/Doc/library/socketserver.rst:396 -#: ../src/Doc/library/socketserver.rst:468 +#: library/socketserver.rst:404 library/socketserver.rst:476 msgid "This is the client side::" msgstr "" -#: ../src/Doc/library/socketserver.rst:421 +#: library/socketserver.rst:429 msgid "The output of the example should look something like this:" msgstr "" -#: ../src/Doc/library/socketserver.rst:423 +#: library/socketserver.rst:431 msgid "Server::" msgstr "" -#: ../src/Doc/library/socketserver.rst:431 +#: library/socketserver.rst:439 msgid "Client::" msgstr "" # 4500e553d7ef4b74bb74d58e15ccc5f0 -#: ../src/Doc/library/socketserver.rst:442 +#: library/socketserver.rst:450 msgid ":class:`SocketServer.UDPServer` Example" msgstr "" -#: ../src/Doc/library/socketserver.rst:487 +#: library/socketserver.rst:495 msgid "" "The output of the example should look exactly like for the TCP server " "example." msgstr "" -#: ../src/Doc/library/socketserver.rst:491 +#: library/socketserver.rst:499 msgid "Asynchronous Mixins" msgstr "" -#: ../src/Doc/library/socketserver.rst:493 +#: library/socketserver.rst:501 msgid "" "To build asynchronous handlers, use the :class:`ThreadingMixIn` and :class:" "`ForkingMixIn` classes." msgstr "" -#: ../src/Doc/library/socketserver.rst:496 +#: library/socketserver.rst:504 msgid "An example for the :class:`ThreadingMixIn` class::" msgstr "" -#: ../src/Doc/library/socketserver.rst:545 +#: library/socketserver.rst:554 msgid "The output of the example should look something like this::" msgstr "" -#: ../src/Doc/library/socketserver.rst:554 +#: library/socketserver.rst:563 msgid "" "The :class:`ForkingMixIn` class is used in the same way, except that the " "server will spawn a new process for each request." msgstr "" -#: ../src/Doc/library/someos.rst:6 +#: library/someos.rst:6 msgid "Optional Operating System Services" msgstr "" # 2182daddd85845c3adaa66d31e7ff401 -#: ../src/Doc/library/someos.rst:8 +#: library/someos.rst:8 msgid "" "The modules described in this chapter provide interfaces to operating system " "features that are available on selected operating systems only. The " @@ -90492,126 +92328,126 @@ msgid "" "overview:" msgstr "" -#: ../src/Doc/library/spwd.rst:3 +#: library/spwd.rst:3 msgid ":mod:`spwd` --- The shadow password database" msgstr "" -#: ../src/Doc/library/spwd.rst:12 +#: library/spwd.rst:12 msgid "" "This module provides access to the Unix shadow password database. It is " "available on various Unix versions." msgstr "" -#: ../src/Doc/library/spwd.rst:15 +#: library/spwd.rst:15 msgid "" "You must have enough privileges to access the shadow password database (this " "usually means you have to be root)." msgstr "" -#: ../src/Doc/library/spwd.rst:18 +#: library/spwd.rst:18 msgid "" "Shadow password database entries are reported as a tuple-like object, whose " "attributes correspond to the members of the ``spwd`` structure (Attribute " "field below, see ``<shadow.h>``):" msgstr "" -#: ../src/Doc/library/spwd.rst:25 +#: library/spwd.rst:25 msgid "``sp_nam``" msgstr "" -#: ../src/Doc/library/spwd.rst:27 +#: library/spwd.rst:27 msgid "``sp_pwd``" msgstr "" -#: ../src/Doc/library/spwd.rst:27 +#: library/spwd.rst:27 msgid "Encrypted password" msgstr "" -#: ../src/Doc/library/spwd.rst:29 +#: library/spwd.rst:29 msgid "``sp_lstchg``" msgstr "" -#: ../src/Doc/library/spwd.rst:29 +#: library/spwd.rst:29 msgid "Date of last change" msgstr "" -#: ../src/Doc/library/spwd.rst:31 +#: library/spwd.rst:31 msgid "``sp_min``" msgstr "" -#: ../src/Doc/library/spwd.rst:31 +#: library/spwd.rst:31 msgid "Minimal number of days between changes" msgstr "" -#: ../src/Doc/library/spwd.rst:34 +#: library/spwd.rst:34 msgid "``sp_max``" msgstr "" -#: ../src/Doc/library/spwd.rst:34 +#: library/spwd.rst:34 msgid "Maximum number of days between changes" msgstr "" -#: ../src/Doc/library/spwd.rst:37 +#: library/spwd.rst:37 msgid "``sp_warn``" msgstr "" -#: ../src/Doc/library/spwd.rst:37 +#: library/spwd.rst:37 msgid "Number of days before password expires to warn user about it" msgstr "" -#: ../src/Doc/library/spwd.rst:40 +#: library/spwd.rst:40 msgid "``sp_inact``" msgstr "" -#: ../src/Doc/library/spwd.rst:40 +#: library/spwd.rst:40 msgid "Number of days after password expires until account is blocked" msgstr "" -#: ../src/Doc/library/spwd.rst:44 ../src/Doc/library/time.rst:422 +#: library/spwd.rst:44 library/time.rst:421 msgid "7" msgstr "" -#: ../src/Doc/library/spwd.rst:44 +#: library/spwd.rst:44 msgid "``sp_expire``" msgstr "" -#: ../src/Doc/library/spwd.rst:44 +#: library/spwd.rst:44 msgid "Number of days since 1970-01-01 until account is disabled" msgstr "" -#: ../src/Doc/library/spwd.rst:47 +#: library/spwd.rst:47 msgid "``sp_flag``" msgstr "" -#: ../src/Doc/library/spwd.rst:47 +#: library/spwd.rst:47 msgid "Reserved" msgstr "" -#: ../src/Doc/library/spwd.rst:50 +#: library/spwd.rst:50 msgid "" "The sp_nam and sp_pwd items are strings, all others are integers. :exc:" "`KeyError` is raised if the entry asked for cannot be found." msgstr "" -#: ../src/Doc/library/spwd.rst:58 +#: library/spwd.rst:58 msgid "Return the shadow password database entry for the given user name." msgstr "" -#: ../src/Doc/library/spwd.rst:63 +#: library/spwd.rst:63 msgid "" "Return a list of all available shadow password database entries, in " "arbitrary order." msgstr "" -#: ../src/Doc/library/spwd.rst:73 +#: library/spwd.rst:73 msgid "An interface to the normal password database, similar to this." msgstr "" -#: ../src/Doc/library/sqlite3.rst:2 +#: library/sqlite3.rst:2 msgid ":mod:`sqlite3` --- DB-API 2.0 interface for SQLite databases" msgstr "" -#: ../src/Doc/library/sqlite3.rst:11 +#: library/sqlite3.rst:11 msgid "" "SQLite is a C library that provides a lightweight disk-based database that " "doesn't require a separate server process and allows accessing the database " @@ -90622,7 +92458,7 @@ msgid "" msgstr "" # 6acb5c401f71483e9e1bd5b7111785b8 -#: ../src/Doc/library/sqlite3.rst:18 +#: library/sqlite3.rst:18 msgid "" "The sqlite3 module was written by Gerhard Häring. It provides a SQL " "interface compliant with the DB-API 2.0 specification described by :pep:" @@ -90630,33 +92466,33 @@ msgid "" msgstr "" # f8f0451f4d3b47afb464347854a99e83 -#: ../src/Doc/library/sqlite3.rst:21 +#: library/sqlite3.rst:21 msgid "" "To use the module, you must first create a :class:`Connection` object that " "represents the database. Here the data will be stored in the :file:`example." "db` file::" msgstr "" -#: ../src/Doc/library/sqlite3.rst:28 +#: library/sqlite3.rst:28 msgid "" "You can also supply the special name ``:memory:`` to create a database in " "RAM." msgstr "" -#: ../src/Doc/library/sqlite3.rst:30 +#: library/sqlite3.rst:30 msgid "" "Once you have a :class:`Connection`, you can create a :class:`Cursor` " "object and call its :meth:`~Cursor.execute` method to perform SQL commands::" msgstr "" # 37c3176f50e64d6fbabcd0a5659b332f -#: ../src/Doc/library/sqlite3.rst:49 +#: library/sqlite3.rst:49 msgid "" "The data you've saved is persistent and is available in subsequent sessions::" msgstr "" # afdeec1956cd47acafd538eb185ce982 -#: ../src/Doc/library/sqlite3.rst:55 +#: library/sqlite3.rst:55 msgid "" "Usually your SQL operations will need to use values from Python variables. " "You shouldn't assemble your query using Python's string operations because " @@ -90664,7 +92500,7 @@ msgid "" "attack (see http://xkcd.com/327/ for humorous example of what can go wrong)." msgstr "" -#: ../src/Doc/library/sqlite3.rst:60 +#: library/sqlite3.rst:60 msgid "" "Instead, use the DB-API's parameter substitution. Put ``?`` as a " "placeholder wherever you want to use a value, and then provide a tuple of " @@ -90673,7 +92509,7 @@ msgid "" "%s`` or ``:1``.) For example::" msgstr "" -#: ../src/Doc/library/sqlite3.rst:82 +#: library/sqlite3.rst:82 msgid "" "To retrieve data after executing a SELECT statement, you can either treat " "the cursor as an :term:`iterator`, call the cursor's :meth:`~Cursor." @@ -90681,87 +92517,86 @@ msgid "" "fetchall` to get a list of the matching rows." msgstr "" -#: ../src/Doc/library/sqlite3.rst:87 +#: library/sqlite3.rst:87 msgid "This example uses the iterator form::" msgstr "" # a2aec043da1e4c94b7d9cd0908eec446 -#: ../src/Doc/library/sqlite3.rst:101 +#: library/sqlite3.rst:102 msgid "https://github.com/ghaering/pysqlite" msgstr "" -#: ../src/Doc/library/sqlite3.rst:101 +#: library/sqlite3.rst:101 msgid "" "The pysqlite web page -- sqlite3 is developed externally under the name " "\"pysqlite\"." msgstr "" # fd18c58e4f894214897b022b3b6a632e -#: ../src/Doc/library/sqlite3.rst:105 +#: library/sqlite3.rst:106 msgid "http://www.sqlite.org" msgstr "" -#: ../src/Doc/library/sqlite3.rst:105 +#: library/sqlite3.rst:105 msgid "" "The SQLite web page; the documentation describes the syntax and the " "available data types for the supported SQL dialect." msgstr "" # e5a6fd7fad8c4563b459ac30882ef9c7 -#: ../src/Doc/library/sqlite3.rst:108 +#: library/sqlite3.rst:109 msgid "http://www.w3schools.com/sql/" msgstr "" # 74e651b8340d427b9ad0562dad4ce45f -#: ../src/Doc/library/sqlite3.rst:109 +#: library/sqlite3.rst:109 msgid "Tutorial, reference and examples for learning SQL syntax." msgstr "" -# a47f8f95b646497e976ea31266908cb9 -#: ../src/Doc/library/sqlite3.rst:110 -msgid ":pep:`249` - Database API Specification 2.0" +#: library/sqlite3.rst:111 +msgid "PEP 249 - Database API Specification 2.0" msgstr "" -#: ../src/Doc/library/sqlite3.rst:112 +#: library/sqlite3.rst:112 msgid "PEP written by Marc-André Lemburg." msgstr "" -#: ../src/Doc/library/sqlite3.rst:118 +#: library/sqlite3.rst:118 msgid "Module functions and constants" msgstr "" # c9478b69f8294938982f0b0f175e9943 -#: ../src/Doc/library/sqlite3.rst:123 +#: library/sqlite3.rst:123 msgid "" "The version number of this module, as a string. This is not the version of " "the SQLite library." msgstr "" # caa6216779494dfaa4db95ce879134cf -#: ../src/Doc/library/sqlite3.rst:128 +#: library/sqlite3.rst:128 msgid "" "The version number of this module, as a tuple of integers. This is not the " "version of the SQLite library." msgstr "" # 647eeffdd297452991862a054df98f27 -#: ../src/Doc/library/sqlite3.rst:133 +#: library/sqlite3.rst:133 msgid "The version number of the run-time SQLite library, as a string." msgstr "" # 50507b834ad94c7f88af81150c5ed4b1 -#: ../src/Doc/library/sqlite3.rst:137 +#: library/sqlite3.rst:137 msgid "" "The version number of the run-time SQLite library, as a tuple of integers." msgstr "" -#: ../src/Doc/library/sqlite3.rst:141 ../src/Doc/library/sqlite3.rst:154 +#: library/sqlite3.rst:141 library/sqlite3.rst:154 msgid "" "This constant is meant to be used with the *detect_types* parameter of the :" "func:`connect` function." msgstr "" -#: ../src/Doc/library/sqlite3.rst:144 +#: library/sqlite3.rst:144 msgid "" "Setting it makes the :mod:`sqlite3` module parse the declared type for each " "column it returns. It will parse out the first word of the declared type, " @@ -90771,7 +92606,7 @@ msgid "" "registered for that type there." msgstr "" -#: ../src/Doc/library/sqlite3.rst:157 +#: library/sqlite3.rst:157 msgid "" "Setting this makes the SQLite interface parse the column name for each " "column it returns. It will look for a string formed [mytype] in there, and " @@ -90784,14 +92619,14 @@ msgid "" "name would simply be \"x\"." msgstr "" -#: ../src/Doc/library/sqlite3.rst:169 +#: library/sqlite3.rst:169 msgid "" "Opens a connection to the SQLite database file *database*. You can use ``\":" "memory:\"`` to open a database connection to a database that resides in RAM " "instead of on disk." msgstr "" -#: ../src/Doc/library/sqlite3.rst:173 +#: library/sqlite3.rst:173 msgid "" "When a database is accessed by multiple connections, and one of the " "processes modifies the database, the SQLite database is locked until that " @@ -90800,14 +92635,14 @@ msgid "" "The default for the timeout parameter is 5.0 (five seconds)." msgstr "" -#: ../src/Doc/library/sqlite3.rst:179 +#: library/sqlite3.rst:179 msgid "" "For the *isolation_level* parameter, please see the :attr:`Connection." "isolation_level` property of :class:`Connection` objects." msgstr "" # 7d3a482e56644849b902640fa3ed8bbd -#: ../src/Doc/library/sqlite3.rst:182 +#: library/sqlite3.rst:182 msgid "" "SQLite natively supports only the types TEXT, INTEGER, REAL, BLOB and NULL. " "If you want to use other types you must add support for them yourself. The " @@ -90816,14 +92651,14 @@ msgid "" "that." msgstr "" -#: ../src/Doc/library/sqlite3.rst:187 +#: library/sqlite3.rst:187 msgid "" "*detect_types* defaults to 0 (i. e. off, no type detection), you can set it " "to any combination of :const:`PARSE_DECLTYPES` and :const:`PARSE_COLNAMES` " "to turn type detection on." msgstr "" -#: ../src/Doc/library/sqlite3.rst:191 +#: library/sqlite3.rst:191 msgid "" "By default, the :mod:`sqlite3` module uses its :class:`Connection` class for " "the connect call. You can, however, subclass the :class:`Connection` class " @@ -90831,11 +92666,11 @@ msgid "" "the *factory* parameter." msgstr "" -#: ../src/Doc/library/sqlite3.rst:196 +#: library/sqlite3.rst:196 msgid "Consult the section :ref:`sqlite3-types` of this manual for details." msgstr "" -#: ../src/Doc/library/sqlite3.rst:198 +#: library/sqlite3.rst:198 msgid "" "The :mod:`sqlite3` module internally uses a statement cache to avoid SQL " "parsing overhead. If you want to explicitly set the number of statements " @@ -90843,7 +92678,7 @@ msgid "" "parameter. The currently implemented default is to cache 100 statements." msgstr "" -#: ../src/Doc/library/sqlite3.rst:206 +#: library/sqlite3.rst:206 msgid "" "Registers a callable to convert a bytestring from the database into a custom " "Python type. The callable will be invoked for all database values that are " @@ -90853,7 +92688,7 @@ msgid "" msgstr "" # 7b5f422592a7428680f3fe04142ab7d9 -#: ../src/Doc/library/sqlite3.rst:215 +#: library/sqlite3.rst:215 msgid "" "Registers a callable to convert the custom Python type *type* into one of " "SQLite's supported types. The callable *callable* accepts as single " @@ -90861,7 +92696,7 @@ msgid "" "int, long, float, str (UTF-8 encoded), unicode or buffer." msgstr "" -#: ../src/Doc/library/sqlite3.rst:223 +#: library/sqlite3.rst:223 msgid "" "Returns :const:`True` if the string *sql* contains one or more complete SQL " "statements terminated by semicolons. It does not verify that the SQL is " @@ -90869,13 +92704,13 @@ msgid "" "the statement is terminated by a semicolon." msgstr "" -#: ../src/Doc/library/sqlite3.rst:228 +#: library/sqlite3.rst:228 msgid "" "This can be used to build a shell for SQLite, as in the following example:" msgstr "" # 8fe3f7c165414d69b78fd0eb5d3a7191 -#: ../src/Doc/library/sqlite3.rst:236 +#: library/sqlite3.rst:236 msgid "" "By default you will not get any tracebacks in user-defined functions, " "aggregates, converters, authorizer callbacks etc. If you want to debug them, " @@ -90884,18 +92719,18 @@ msgid "" "disable the feature again." msgstr "" -#: ../src/Doc/library/sqlite3.rst:250 +#: library/sqlite3.rst:250 msgid "A SQLite database connection has the following attributes and methods:" msgstr "" -#: ../src/Doc/library/sqlite3.rst:254 +#: library/sqlite3.rst:254 msgid "" "Get or set the current isolation level. :const:`None` for autocommit mode or " "one of \"DEFERRED\", \"IMMEDIATE\" or \"EXCLUSIVE\". See section :ref:" "`sqlite3-controlling-transactions` for a more detailed explanation." msgstr "" -#: ../src/Doc/library/sqlite3.rst:261 +#: library/sqlite3.rst:261 msgid "" "The cursor method accepts a single optional parameter *cursorClass*. If " "supplied, this must be a custom cursor class that extends :class:`sqlite3." @@ -90903,7 +92738,7 @@ msgid "" msgstr "" # 3200aaf524d747f09b024fa3801b9ed5 -#: ../src/Doc/library/sqlite3.rst:267 +#: library/sqlite3.rst:267 msgid "" "This method commits the current transaction. If you don't call this method, " "anything you did since the last call to ``commit()`` is not visible from " @@ -90911,13 +92746,13 @@ msgid "" "written to the database, please check you didn't forget to call this method." msgstr "" -#: ../src/Doc/library/sqlite3.rst:274 +#: library/sqlite3.rst:274 msgid "" "This method rolls back any changes to the database since the last call to :" "meth:`commit`." msgstr "" -#: ../src/Doc/library/sqlite3.rst:279 +#: library/sqlite3.rst:279 msgid "" "This closes the database connection. Note that this does not automatically " "call :meth:`commit`. If you just close your database connection without " @@ -90925,7 +92760,7 @@ msgid "" msgstr "" # e4c1627e086e4b09967aca3ad2dff55a -#: ../src/Doc/library/sqlite3.rst:285 +#: library/sqlite3.rst:285 msgid "" "This is a nonstandard shortcut that creates an intermediate cursor object by " "calling the cursor method, then calls the cursor's :meth:`execute <Cursor." @@ -90933,7 +92768,7 @@ msgid "" msgstr "" # 6ca14fb0499d4f6db6e50b6a2cf5808d -#: ../src/Doc/library/sqlite3.rst:292 +#: library/sqlite3.rst:292 msgid "" "This is a nonstandard shortcut that creates an intermediate cursor object by " "calling the cursor method, then calls the cursor's :meth:`executemany " @@ -90941,14 +92776,14 @@ msgid "" msgstr "" # dd6c720cbb8a48d39954cb41a02abf47 -#: ../src/Doc/library/sqlite3.rst:298 +#: library/sqlite3.rst:298 msgid "" "This is a nonstandard shortcut that creates an intermediate cursor object by " "calling the cursor method, then calls the cursor's :meth:`executescript " "<Cursor.executescript>` method with the parameters given." msgstr "" -#: ../src/Doc/library/sqlite3.rst:305 +#: library/sqlite3.rst:305 msgid "" "Creates a user-defined function that you can later use from within SQL " "statements under the function name *name*. *num_params* is the number of " @@ -90957,17 +92792,17 @@ msgid "" msgstr "" # 50507b834ad94c7f88af81150c5ed4b1 -#: ../src/Doc/library/sqlite3.rst:310 +#: library/sqlite3.rst:310 msgid "" "The function can return any of the types supported by SQLite: unicode, str, " "int, long, float, buffer and None." msgstr "" -#: ../src/Doc/library/sqlite3.rst:320 +#: library/sqlite3.rst:320 msgid "Creates a user-defined aggregate function." msgstr "" -#: ../src/Doc/library/sqlite3.rst:322 +#: library/sqlite3.rst:322 msgid "" "The aggregate class must implement a ``step`` method, which accepts the " "number of parameters *num_params*, and a ``finalize`` method which will " @@ -90975,13 +92810,13 @@ msgid "" msgstr "" # e6dc372a5e6e44348ef04b0793a948dc -#: ../src/Doc/library/sqlite3.rst:326 +#: library/sqlite3.rst:326 msgid "" "The ``finalize`` method can return any of the types supported by SQLite: " "unicode, str, int, long, float, buffer and None." msgstr "" -#: ../src/Doc/library/sqlite3.rst:336 +#: library/sqlite3.rst:336 msgid "" "Creates a collation with the specified *name* and *callable*. The callable " "will be passed two string arguments. It should return -1 if the first is " @@ -90990,30 +92825,30 @@ msgid "" "(ORDER BY in SQL) so your comparisons don't affect other SQL operations." msgstr "" -#: ../src/Doc/library/sqlite3.rst:342 +#: library/sqlite3.rst:342 msgid "" "Note that the callable will get its parameters as Python bytestrings, which " "will normally be encoded in UTF-8." msgstr "" -#: ../src/Doc/library/sqlite3.rst:345 +#: library/sqlite3.rst:345 msgid "" "The following example shows a custom collation that sorts \"the wrong way\":" msgstr "" -#: ../src/Doc/library/sqlite3.rst:349 +#: library/sqlite3.rst:349 msgid "" "To remove a collation, call ``create_collation`` with None as callable::" msgstr "" -#: ../src/Doc/library/sqlite3.rst:356 +#: library/sqlite3.rst:356 msgid "" "You can call this method from a different thread to abort any queries that " "might be executing on the connection. The query will then abort and the " "caller will get an exception." msgstr "" -#: ../src/Doc/library/sqlite3.rst:363 +#: library/sqlite3.rst:363 msgid "" "This routine registers a callback. The callback is invoked for each attempt " "to access a column of a table in the database. The callback should return :" @@ -91023,7 +92858,7 @@ msgid "" "in the :mod:`sqlite3` module." msgstr "" -#: ../src/Doc/library/sqlite3.rst:370 +#: library/sqlite3.rst:370 msgid "" "The first argument to the callback signifies what kind of operation is to be " "authorized. The second and third argument will be arguments or :const:`None` " @@ -91034,7 +92869,7 @@ msgid "" "code." msgstr "" -#: ../src/Doc/library/sqlite3.rst:377 +#: library/sqlite3.rst:377 msgid "" "Please consult the SQLite documentation about the possible values for the " "first argument and the meaning of the second and third argument depending on " @@ -91042,7 +92877,7 @@ msgid "" "module." msgstr "" -#: ../src/Doc/library/sqlite3.rst:384 +#: library/sqlite3.rst:384 msgid "" "This routine registers a callback. The callback is invoked for every *n* " "instructions of the SQLite virtual machine. This is useful if you want to " @@ -91050,14 +92885,14 @@ msgid "" "a GUI." msgstr "" -#: ../src/Doc/library/sqlite3.rst:389 +#: library/sqlite3.rst:389 msgid "" "If you want to clear any previously installed progress handler, call the " "method with :const:`None` for *handler*." msgstr "" # 0a5e7186fd604ae0b4a35b6a057feee2 -#: ../src/Doc/library/sqlite3.rst:397 +#: library/sqlite3.rst:397 msgid "" "This routine allows/disallows the SQLite engine to load SQLite extensions " "from shared libraries. SQLite extensions can define new functions, " @@ -91067,19 +92902,19 @@ msgstr "" # a6a871c9df404e55a80d1eecb622d7de # f33d31c7de644fb68e03b856703519e3 -#: ../src/Doc/library/sqlite3.rst:402 ../src/Doc/library/sqlite3.rst:414 +#: library/sqlite3.rst:402 library/sqlite3.rst:414 msgid "Loadable extensions are disabled by default. See [#f1]_." msgstr "" # d3eb2d70049b4e3fa0263fcaa4d7691e -#: ../src/Doc/library/sqlite3.rst:410 +#: library/sqlite3.rst:410 msgid "" "This routine loads a SQLite extension from a shared library. You have to " "enable extension loading with :meth:`enable_load_extension` before you can " "use this routine." msgstr "" -#: ../src/Doc/library/sqlite3.rst:420 +#: library/sqlite3.rst:420 msgid "" "You can change this attribute to a callable that accepts the cursor and the " "original row as a tuple and will return the real result row. This way, you " @@ -91087,7 +92922,7 @@ msgid "" "object that can also access columns by name." msgstr "" -#: ../src/Doc/library/sqlite3.rst:429 +#: library/sqlite3.rst:429 msgid "" "If returning a tuple doesn't suffice and you want name-based access to " "columns, you should consider setting :attr:`row_factory` to the highly-" @@ -91098,7 +92933,7 @@ msgid "" msgstr "" # e63e3c8c81414ce883f613c803e96452 -#: ../src/Doc/library/sqlite3.rst:441 +#: library/sqlite3.rst:441 msgid "" "Using this attribute you can control what objects are returned for the " "``TEXT`` data type. By default, this attribute is set to :class:`unicode` " @@ -91107,30 +92942,30 @@ msgid "" msgstr "" # ac69ef127348464a932f34605d889709 -#: ../src/Doc/library/sqlite3.rst:446 +#: library/sqlite3.rst:446 msgid "" "For efficiency reasons, there's also a way to return Unicode objects only " "for non-ASCII data, and bytestrings otherwise. To activate it, set this " "attribute to :const:`sqlite3.OptimizedUnicode`." msgstr "" -#: ../src/Doc/library/sqlite3.rst:450 +#: library/sqlite3.rst:450 msgid "" "You can also set it to any other callable that accepts a single bytestring " "parameter and returns the resulting object." msgstr "" -#: ../src/Doc/library/sqlite3.rst:453 +#: library/sqlite3.rst:453 msgid "See the following example code for illustration:" msgstr "" -#: ../src/Doc/library/sqlite3.rst:460 +#: library/sqlite3.rst:460 msgid "" "Returns the total number of database rows that have been modified, inserted, " "or deleted since the database connection was opened." msgstr "" -#: ../src/Doc/library/sqlite3.rst:466 +#: library/sqlite3.rst:466 msgid "" "Returns an iterator to dump the database in an SQL text format. Useful when " "saving an in-memory database for later restoration. This function provides " @@ -91138,17 +92973,17 @@ msgid "" "shell." msgstr "" -#: ../src/Doc/library/sqlite3.rst:487 +#: library/sqlite3.rst:487 msgid "Cursor Objects" msgstr "" # a997ba3cd8684ef798460c4f89458f9d -#: ../src/Doc/library/sqlite3.rst:491 +#: library/sqlite3.rst:491 msgid "A :class:`Cursor` instance has the following attributes and methods." msgstr "" # 07de9c7543a14de999bdc76b1b3cdaa6 -#: ../src/Doc/library/sqlite3.rst:495 +#: library/sqlite3.rst:495 msgid "" "Executes an SQL statement. The SQL statement may be parameterized (i. e. " "placeholders instead of SQL literals). The :mod:`sqlite3` module supports " @@ -91157,29 +92992,29 @@ msgid "" msgstr "" # 05246945b1b74d8cb0dff96a72146ab5 -#: ../src/Doc/library/sqlite3.rst:500 +#: library/sqlite3.rst:500 msgid "Here's an example of both styles:" msgstr "" -#: ../src/Doc/library/sqlite3.rst:504 +#: library/sqlite3.rst:504 msgid "" ":meth:`execute` will only execute a single SQL statement. If you try to " "execute more than one statement with it, it will raise a Warning. Use :meth:" "`executescript` if you want to execute multiple SQL statements with one call." msgstr "" -#: ../src/Doc/library/sqlite3.rst:512 +#: library/sqlite3.rst:512 msgid "" "Executes an SQL command against all parameter sequences or mappings found in " "the sequence *sql*. The :mod:`sqlite3` module also allows using an :term:" "`iterator` yielding parameters instead of a sequence." msgstr "" -#: ../src/Doc/library/sqlite3.rst:518 +#: library/sqlite3.rst:518 msgid "Here's a shorter example using a :term:`generator`:" msgstr "" -#: ../src/Doc/library/sqlite3.rst:525 +#: library/sqlite3.rst:525 msgid "" "This is a nonstandard convenience method for executing multiple SQL " "statements at once. It issues a ``COMMIT`` statement first, then executes " @@ -91187,23 +93022,23 @@ msgid "" msgstr "" # b7fe16d142c5432c849b9edc2005f88e -#: ../src/Doc/library/sqlite3.rst:529 +#: library/sqlite3.rst:529 msgid "*sql_script* can be a bytestring or a Unicode string." msgstr "" -#: ../src/Doc/library/sqlite3.rst:538 +#: library/sqlite3.rst:538 msgid "" "Fetches the next row of a query result set, returning a single sequence, or :" "const:`None` when no more data is available." msgstr "" -#: ../src/Doc/library/sqlite3.rst:544 +#: library/sqlite3.rst:544 msgid "" "Fetches the next set of rows of a query result, returning a list. An empty " "list is returned when no more rows are available." msgstr "" -#: ../src/Doc/library/sqlite3.rst:547 +#: library/sqlite3.rst:547 msgid "" "The number of rows to fetch per call is specified by the *size* parameter. " "If it is not given, the cursor's arraysize determines the number of rows to " @@ -91212,7 +93047,7 @@ msgid "" "not being available, fewer rows may be returned." msgstr "" -#: ../src/Doc/library/sqlite3.rst:553 +#: library/sqlite3.rst:553 msgid "" "Note there are performance considerations involved with the *size* " "parameter. For optimal performance, it is usually best to use the arraysize " @@ -91220,28 +93055,28 @@ msgid "" "the same value from one :meth:`fetchmany` call to the next." msgstr "" -#: ../src/Doc/library/sqlite3.rst:560 +#: library/sqlite3.rst:560 msgid "" "Fetches all (remaining) rows of a query result, returning a list. Note that " "the cursor's arraysize attribute can affect the performance of this " "operation. An empty list is returned when no rows are available." msgstr "" -#: ../src/Doc/library/sqlite3.rst:567 +#: library/sqlite3.rst:567 msgid "" "Although the :class:`Cursor` class of the :mod:`sqlite3` module implements " "this attribute, the database engine's own support for the determination of " "\"rows affected\"/\"rows selected\" is quirky." msgstr "" -#: ../src/Doc/library/sqlite3.rst:571 +#: library/sqlite3.rst:571 msgid "" "For :meth:`executemany` statements, the number of modifications are summed " "up into :attr:`rowcount`." msgstr "" # fd72881632ba408ea560374429a628b2 -#: ../src/Doc/library/sqlite3.rst:574 +#: library/sqlite3.rst:574 msgid "" "As required by the Python DB API Spec, the :attr:`rowcount` attribute \"is " "-1 in case no ``executeXX()`` has been performed on the cursor or the " @@ -91251,13 +93086,13 @@ msgid "" msgstr "" # 454850933da944a189863f9799589f9b -#: ../src/Doc/library/sqlite3.rst:580 +#: library/sqlite3.rst:580 msgid "" "With SQLite versions before 3.6.5, :attr:`rowcount` is set to 0 if you make " "a ``DELETE FROM table`` without any condition." msgstr "" -#: ../src/Doc/library/sqlite3.rst:585 +#: library/sqlite3.rst:585 msgid "" "This read-only attribute provides the rowid of the last modified row. It is " "only set if you issued a ``INSERT`` statement using the :meth:`execute` " @@ -91265,149 +93100,150 @@ msgid "" "called, :attr:`lastrowid` is set to :const:`None`." msgstr "" -#: ../src/Doc/library/sqlite3.rst:592 +#: library/sqlite3.rst:592 msgid "" "This read-only attribute provides the column names of the last query. To " "remain compatible with the Python DB API, it returns a 7-tuple for each " "column where the last six items of each tuple are :const:`None`." msgstr "" -#: ../src/Doc/library/sqlite3.rst:596 +#: library/sqlite3.rst:596 msgid "It is set for ``SELECT`` statements without any matching rows as well." msgstr "" -#: ../src/Doc/library/sqlite3.rst:601 +#: library/sqlite3.rst:601 msgid "Row Objects" msgstr "" -#: ../src/Doc/library/sqlite3.rst:605 +#: library/sqlite3.rst:605 msgid "" "A :class:`Row` instance serves as a highly optimized :attr:`~Connection." "row_factory` for :class:`Connection` objects. It tries to mimic a tuple in " "most of its features." msgstr "" -#: ../src/Doc/library/sqlite3.rst:609 +#: library/sqlite3.rst:609 msgid "" "It supports mapping access by column name and index, iteration, " "representation, equality testing and :func:`len`." msgstr "" -#: ../src/Doc/library/sqlite3.rst:612 +#: library/sqlite3.rst:612 msgid "" "If two :class:`Row` objects have exactly the same columns and their members " "are equal, they compare equal." msgstr "" +#: library/sqlite3.rst:615 +msgid "Added iteration and equality (hashability)." +msgstr "" + # e6724306d6b545118ec871327330b615 -#: ../src/Doc/library/sqlite3.rst:620 +#: library/sqlite3.rst:620 msgid "" "This method returns a list of column names. Immediately after a query, it is " "the first member of each tuple in :attr:`Cursor.description`." msgstr "" -#: ../src/Doc/library/sqlite3.rst:625 +#: library/sqlite3.rst:625 msgid "Let's assume we initialize a table as in the example given above::" msgstr "" -#: ../src/Doc/library/sqlite3.rst:637 +#: library/sqlite3.rst:637 msgid "Now we plug :class:`Row` in::" msgstr "" -#: ../src/Doc/library/sqlite3.rst:669 +#: library/sqlite3.rst:669 msgid "SQLite and Python types" msgstr "" -#: ../src/Doc/library/sqlite3.rst:675 +#: library/sqlite3.rst:675 msgid "" "SQLite natively supports the following types: ``NULL``, ``INTEGER``, " "``REAL``, ``TEXT``, ``BLOB``." msgstr "" -#: ../src/Doc/library/sqlite3.rst:678 +#: library/sqlite3.rst:678 msgid "" "The following Python types can thus be sent to SQLite without any problem:" msgstr "" -#: ../src/Doc/library/sqlite3.rst:681 ../src/Doc/library/sqlite3.rst:701 +#: library/sqlite3.rst:681 library/sqlite3.rst:701 msgid "SQLite type" msgstr "" -#: ../src/Doc/library/sqlite3.rst:683 ../src/Doc/library/sqlite3.rst:703 -#: ../src/Doc/library/urlparse.rst:109 ../src/Doc/library/urlparse.rst:111 -#: ../src/Doc/library/urlparse.rst:113 ../src/Doc/library/urlparse.rst:115 -#: ../src/Doc/library/urlparse.rst:210 ../src/Doc/library/urlparse.rst:212 -#: ../src/Doc/library/urlparse.rst:214 ../src/Doc/library/urlparse.rst:216 +#: library/sqlite3.rst:683 library/sqlite3.rst:703 library/urlparse.rst:109 +#: library/urlparse.rst:111 library/urlparse.rst:113 library/urlparse.rst:115 +#: library/urlparse.rst:210 library/urlparse.rst:212 library/urlparse.rst:214 +#: library/urlparse.rst:216 msgid ":const:`None`" msgstr "" -#: ../src/Doc/library/sqlite3.rst:683 ../src/Doc/library/sqlite3.rst:703 +#: library/sqlite3.rst:683 library/sqlite3.rst:703 msgid "``NULL``" msgstr "" -#: ../src/Doc/library/sqlite3.rst:685 +#: library/sqlite3.rst:685 msgid ":class:`int`" msgstr "" -#: ../src/Doc/library/sqlite3.rst:685 ../src/Doc/library/sqlite3.rst:687 -#: ../src/Doc/library/sqlite3.rst:705 +#: library/sqlite3.rst:685 library/sqlite3.rst:687 library/sqlite3.rst:705 msgid "``INTEGER``" msgstr "" # 5b1c50642087437bae0b0f3d9a8a5d8a -#: ../src/Doc/library/sqlite3.rst:687 +#: library/sqlite3.rst:687 msgid ":class:`long`" msgstr "" -#: ../src/Doc/library/sqlite3.rst:689 ../src/Doc/library/sqlite3.rst:708 +#: library/sqlite3.rst:689 library/sqlite3.rst:708 msgid ":class:`float`" msgstr "" -#: ../src/Doc/library/sqlite3.rst:689 ../src/Doc/library/sqlite3.rst:708 +#: library/sqlite3.rst:689 library/sqlite3.rst:708 msgid "``REAL``" msgstr "" # 114cd10f1b6f49b7a52fb76fdb4811fd -#: ../src/Doc/library/sqlite3.rst:691 +#: library/sqlite3.rst:691 msgid ":class:`str` (UTF8-encoded)" msgstr "" -#: ../src/Doc/library/sqlite3.rst:691 ../src/Doc/library/sqlite3.rst:693 -#: ../src/Doc/library/sqlite3.rst:710 +#: library/sqlite3.rst:691 library/sqlite3.rst:693 library/sqlite3.rst:710 msgid "``TEXT``" msgstr "" # df9daa3965894e92968cfa44d797fdd6 -#: ../src/Doc/library/sqlite3.rst:693 +#: library/sqlite3.rst:693 msgid ":class:`unicode`" msgstr "" # 03e5c4fb544c4c7fb2588428e7ca2080 # de020cd3191143dd959cf70afb7fa5ae -#: ../src/Doc/library/sqlite3.rst:695 ../src/Doc/library/sqlite3.rst:713 +#: library/sqlite3.rst:695 library/sqlite3.rst:713 msgid ":class:`buffer`" msgstr "" -#: ../src/Doc/library/sqlite3.rst:695 ../src/Doc/library/sqlite3.rst:713 +#: library/sqlite3.rst:695 library/sqlite3.rst:713 msgid "``BLOB``" msgstr "" -#: ../src/Doc/library/sqlite3.rst:698 +#: library/sqlite3.rst:698 msgid "This is how SQLite types are converted to Python types by default:" msgstr "" # 7bd4f09e0cea40e4bf91fe32ae9bcc8a -#: ../src/Doc/library/sqlite3.rst:705 +#: library/sqlite3.rst:705 msgid ":class:`int` or :class:`long`, depending on size" msgstr "" # be06d264403044c6a6fa4454aad2c774 -#: ../src/Doc/library/sqlite3.rst:710 +#: library/sqlite3.rst:710 msgid "" "depends on :attr:`~Connection.text_factory`, :class:`unicode` by default" msgstr "" -#: ../src/Doc/library/sqlite3.rst:716 +#: library/sqlite3.rst:716 msgid "" "The type system of the :mod:`sqlite3` module is extensible in two ways: you " "can store additional Python types in a SQLite database via object " @@ -91415,12 +93251,12 @@ msgid "" "to different Python types via converters." msgstr "" -#: ../src/Doc/library/sqlite3.rst:723 +#: library/sqlite3.rst:723 msgid "Using adapters to store additional Python types in SQLite databases" msgstr "" # 83a214dfe4144892ac5de31bc7e82d41 -#: ../src/Doc/library/sqlite3.rst:725 +#: library/sqlite3.rst:725 msgid "" "As described before, SQLite supports only a limited set of types natively. " "To use other Python types with SQLite, you must **adapt** them to one of the " @@ -91428,23 +93264,23 @@ msgid "" "float, str, unicode, buffer." msgstr "" -#: ../src/Doc/library/sqlite3.rst:730 +#: library/sqlite3.rst:730 msgid "" "There are two ways to enable the :mod:`sqlite3` module to adapt a custom " "Python type to one of the supported ones." msgstr "" -#: ../src/Doc/library/sqlite3.rst:735 +#: library/sqlite3.rst:735 msgid "Letting your object adapt itself" msgstr "" -#: ../src/Doc/library/sqlite3.rst:737 +#: library/sqlite3.rst:737 msgid "" "This is a good approach if you write the class yourself. Let's suppose you " "have a class like this::" msgstr "" -#: ../src/Doc/library/sqlite3.rst:744 +#: library/sqlite3.rst:744 msgid "" "Now you want to store the point in a single SQLite column. First you'll " "have to choose one of the supported types first to be used for representing " @@ -91454,11 +93290,11 @@ msgid "" "will be :class:`PrepareProtocol`." msgstr "" -#: ../src/Doc/library/sqlite3.rst:754 +#: library/sqlite3.rst:754 msgid "Registering an adapter callable" msgstr "" -#: ../src/Doc/library/sqlite3.rst:756 +#: library/sqlite3.rst:756 msgid "" "The other possibility is to create a function that converts the type to the " "string representation and register the function with :meth:" @@ -91466,13 +93302,13 @@ msgid "" msgstr "" # 5330bb60bc464ce5b20525561713b38f -#: ../src/Doc/library/sqlite3.rst:761 +#: library/sqlite3.rst:761 msgid "" "The type/class to adapt must be a :term:`new-style class`, i. e. it must " "have :class:`object` as one of its bases." msgstr "" -#: ../src/Doc/library/sqlite3.rst:766 +#: library/sqlite3.rst:766 msgid "" "The :mod:`sqlite3` module has two default adapters for Python's built-in :" "class:`datetime.date` and :class:`datetime.datetime` types. Now let's " @@ -91480,105 +93316,105 @@ msgid "" "representation, but as a Unix timestamp." msgstr "" -#: ../src/Doc/library/sqlite3.rst:775 +#: library/sqlite3.rst:775 msgid "Converting SQLite values to custom Python types" msgstr "" -#: ../src/Doc/library/sqlite3.rst:777 +#: library/sqlite3.rst:777 msgid "" "Writing an adapter lets you send custom Python types to SQLite. But to make " "it really useful we need to make the Python to SQLite to Python roundtrip " "work." msgstr "" -#: ../src/Doc/library/sqlite3.rst:780 +#: library/sqlite3.rst:780 msgid "Enter converters." msgstr "" -#: ../src/Doc/library/sqlite3.rst:782 +#: library/sqlite3.rst:782 msgid "" "Let's go back to the :class:`Point` class. We stored the x and y coordinates " "separated via semicolons as strings in SQLite." msgstr "" -#: ../src/Doc/library/sqlite3.rst:785 +#: library/sqlite3.rst:785 msgid "" "First, we'll define a converter function that accepts the string as a " "parameter and constructs a :class:`Point` object from it." msgstr "" -#: ../src/Doc/library/sqlite3.rst:790 +#: library/sqlite3.rst:790 msgid "" "Converter functions **always** get called with a string, no matter under " "which data type you sent the value to SQLite." msgstr "" -#: ../src/Doc/library/sqlite3.rst:799 +#: library/sqlite3.rst:799 msgid "" "Now you need to make the :mod:`sqlite3` module know that what you select " "from the database is actually a point. There are two ways of doing this:" msgstr "" -#: ../src/Doc/library/sqlite3.rst:802 +#: library/sqlite3.rst:802 msgid "Implicitly via the declared type" msgstr "" -#: ../src/Doc/library/sqlite3.rst:804 +#: library/sqlite3.rst:804 msgid "Explicitly via the column name" msgstr "" -#: ../src/Doc/library/sqlite3.rst:806 +#: library/sqlite3.rst:806 msgid "" "Both ways are described in section :ref:`sqlite3-module-contents`, in the " "entries for the constants :const:`PARSE_DECLTYPES` and :const:" "`PARSE_COLNAMES`." msgstr "" -#: ../src/Doc/library/sqlite3.rst:809 +#: library/sqlite3.rst:809 msgid "The following example illustrates both approaches." msgstr "" -#: ../src/Doc/library/sqlite3.rst:815 +#: library/sqlite3.rst:815 msgid "Default adapters and converters" msgstr "" -#: ../src/Doc/library/sqlite3.rst:817 +#: library/sqlite3.rst:817 msgid "" "There are default adapters for the date and datetime types in the datetime " "module. They will be sent as ISO dates/ISO timestamps to SQLite." msgstr "" -#: ../src/Doc/library/sqlite3.rst:820 +#: library/sqlite3.rst:820 msgid "" "The default converters are registered under the name \"date\" for :class:" "`datetime.date` and under the name \"timestamp\" for :class:`datetime." "datetime`." msgstr "" -#: ../src/Doc/library/sqlite3.rst:824 +#: library/sqlite3.rst:824 msgid "" "This way, you can use date/timestamps from Python without any additional " "fiddling in most cases. The format of the adapters is also compatible with " "the experimental SQLite date/time functions." msgstr "" -#: ../src/Doc/library/sqlite3.rst:828 +#: library/sqlite3.rst:828 msgid "The following example demonstrates this." msgstr "" # 3899e00994904dc4aabeab49ef77039b -#: ../src/Doc/library/sqlite3.rst:832 +#: library/sqlite3.rst:832 msgid "" "If a timestamp stored in SQLite has a fractional part longer than 6 numbers, " "its value will be truncated to microsecond precision by the timestamp " "converter." msgstr "" -#: ../src/Doc/library/sqlite3.rst:840 +#: library/sqlite3.rst:840 msgid "Controlling Transactions" msgstr "" -#: ../src/Doc/library/sqlite3.rst:842 +#: library/sqlite3.rst:842 msgid "" "By default, the :mod:`sqlite3` module opens transactions implicitly before a " "Data Modification Language (DML) statement (i.e. ``INSERT``/``UPDATE``/" @@ -91588,7 +93424,7 @@ msgid "" msgstr "" # 55e62ef519824843b658aa81abebdd43 -#: ../src/Doc/library/sqlite3.rst:848 +#: library/sqlite3.rst:848 msgid "" "So if you are within a transaction and issue a command like ``CREATE " "TABLE ...``, ``VACUUM``, ``PRAGMA``, the :mod:`sqlite3` module will commit " @@ -91598,34 +93434,34 @@ msgid "" "transaction state (if a transaction is active or not)." msgstr "" -#: ../src/Doc/library/sqlite3.rst:855 +#: library/sqlite3.rst:855 msgid "" "You can control which kind of ``BEGIN`` statements sqlite3 implicitly " "executes (or none at all) via the *isolation_level* parameter to the :func:" "`connect` call, or via the :attr:`isolation_level` property of connections." msgstr "" -#: ../src/Doc/library/sqlite3.rst:859 +#: library/sqlite3.rst:859 msgid "" "If you want **autocommit mode**, then set :attr:`isolation_level` to None." msgstr "" -#: ../src/Doc/library/sqlite3.rst:861 +#: library/sqlite3.rst:861 msgid "" "Otherwise leave it at its default, which will result in a plain \"BEGIN\" " "statement, or set it to one of SQLite's supported isolation levels: " "\"DEFERRED\", \"IMMEDIATE\" or \"EXCLUSIVE\"." msgstr "" -#: ../src/Doc/library/sqlite3.rst:868 +#: library/sqlite3.rst:868 msgid "Using :mod:`sqlite3` efficiently" msgstr "" -#: ../src/Doc/library/sqlite3.rst:872 +#: library/sqlite3.rst:872 msgid "Using shortcut methods" msgstr "" -#: ../src/Doc/library/sqlite3.rst:874 +#: library/sqlite3.rst:874 msgid "" "Using the nonstandard :meth:`execute`, :meth:`executemany` and :meth:" "`executescript` methods of the :class:`Connection` object, your code can be " @@ -91637,27 +93473,27 @@ msgid "" "object." msgstr "" -#: ../src/Doc/library/sqlite3.rst:886 +#: library/sqlite3.rst:886 msgid "Accessing columns by name instead of by index" msgstr "" -#: ../src/Doc/library/sqlite3.rst:888 +#: library/sqlite3.rst:888 msgid "" "One useful feature of the :mod:`sqlite3` module is the built-in :class:" "`sqlite3.Row` class designed to be used as a row factory." msgstr "" -#: ../src/Doc/library/sqlite3.rst:891 +#: library/sqlite3.rst:891 msgid "" "Rows wrapped with this class can be accessed both by index (like tuples) and " "case-insensitively by name:" msgstr "" -#: ../src/Doc/library/sqlite3.rst:898 +#: library/sqlite3.rst:898 msgid "Using the connection as a context manager" msgstr "" -#: ../src/Doc/library/sqlite3.rst:902 +#: library/sqlite3.rst:902 msgid "" "Connection objects can be used as context managers that automatically commit " "or rollback transactions. In the event of an exception, the transaction is " @@ -91665,18 +93501,18 @@ msgid "" msgstr "" # 522e2f588dc0410d8758c6be43c78a30 -#: ../src/Doc/library/sqlite3.rst:911 +#: library/sqlite3.rst:911 msgid "Common issues" msgstr "" # b52b28e1e7004a19a892c486d9c8d479 -#: ../src/Doc/library/sqlite3.rst:914 +#: library/sqlite3.rst:914 #, fuzzy msgid "Multithreading" msgstr "Threads" # 59af51cddb74471c8c7d38bc864e73f1 -#: ../src/Doc/library/sqlite3.rst:916 +#: library/sqlite3.rst:916 msgid "" "Older SQLite versions had issues with sharing connections between threads. " "That's why the Python module disallows sharing connections and cursors " @@ -91685,14 +93521,14 @@ msgid "" msgstr "" # f3222cb7aa3043b3b046e1645ec3a755 -#: ../src/Doc/library/sqlite3.rst:920 +#: library/sqlite3.rst:920 msgid "" "The only exception is calling the :meth:`~Connection.interrupt` method, " "which only makes sense to call from a different thread." msgstr "" # 1358fe7a169247598bd02f0efde1a3f2 -#: ../src/Doc/library/sqlite3.rst:925 +#: library/sqlite3.rst:925 msgid "" "The sqlite3 module is not built with loadable extension support by default, " "because some platforms (notably Mac OS X) have SQLite libraries which are " @@ -91701,16 +93537,16 @@ msgid "" msgstr "" # 2e746467b6724be59a4feac60bb7a725 -#: ../src/Doc/library/ssl.rst:2 +#: library/ssl.rst:2 msgid ":mod:`ssl` --- TLS/SSL wrapper for socket objects" msgstr "" # f685a4c094194174a3870ebf678e58ad -#: ../src/Doc/library/ssl.rst:17 +#: library/ssl.rst:17 msgid "**Source code:** :source:`Lib/ssl.py`" msgstr "" -#: ../src/Doc/library/ssl.rst:21 +#: library/ssl.rst:21 msgid "" "This module provides access to Transport Layer Security (often known as " "\"Secure Sockets Layer\") encryption and peer authentication facilities for " @@ -91721,7 +93557,7 @@ msgid "" msgstr "" # 22a4e69192f24c10815c29f3de43fd39 -#: ../src/Doc/library/ssl.rst:29 +#: library/ssl.rst:29 msgid "" "Some behavior may be platform dependent, since calls are made to the " "operating system socket APIs. The installed version of OpenSSL may also " @@ -91730,14 +93566,14 @@ msgid "" msgstr "" # 4b3196a5b6824e21a11c03f28d0eec9e -#: ../src/Doc/library/ssl.rst:35 +#: library/ssl.rst:35 msgid "" "Don't use this module without reading the :ref:`ssl-security`. Doing so may " "lead to a false sense of security, as the default settings of the ssl module " "are not necessarily appropriate for your application." msgstr "" -#: ../src/Doc/library/ssl.rst:40 +#: library/ssl.rst:40 msgid "" "This section documents the objects and functions in the ``ssl`` module; for " "more general information about TLS, SSL, and certificates, the reader is " @@ -91745,7 +93581,7 @@ msgid "" msgstr "" # cd9588e7b0bb4652a64c1a69c5f163e7 -#: ../src/Doc/library/ssl.rst:44 +#: library/ssl.rst:44 msgid "" "This module provides a class, :class:`ssl.SSLSocket`, which is derived from " "the :class:`socket.socket` type, and provides a socket-like wrapper that " @@ -91756,19 +93592,19 @@ msgid "" msgstr "" # 257228dd9b3345a0a71561dca3556506 -#: ../src/Doc/library/ssl.rst:51 +#: library/ssl.rst:51 msgid "" "For more sophisticated applications, the :class:`ssl.SSLContext` class helps " "manage settings and certificates, which can then be inherited by SSL sockets " "created through the :meth:`SSLContext.wrap_socket` method." msgstr "" -#: ../src/Doc/library/ssl.rst:57 +#: library/ssl.rst:57 msgid "Functions, Constants, and Exceptions" msgstr "" # bcc19640e9cd46f882ee43f8d6c2464a -#: ../src/Doc/library/ssl.rst:61 +#: library/ssl.rst:61 msgid "" "Raised to signal an error from the underlying SSL implementation (currently " "provided by the OpenSSL library). This signifies some problem in the higher-" @@ -91779,7 +93615,7 @@ msgid "" msgstr "" # ec1588143ad140949efc47b5f97ec444 -#: ../src/Doc/library/ssl.rst:71 +#: library/ssl.rst:71 msgid "" "A string mnemonic designating the OpenSSL submodule in which the error " "occurred, such as ``SSL``, ``PEM`` or ``X509``. The range of possible " @@ -91787,7 +93623,7 @@ msgid "" msgstr "" # 71d31520380e41a3b8d9383df5b36d57 -#: ../src/Doc/library/ssl.rst:79 +#: library/ssl.rst:79 msgid "" "A string mnemonic designating the reason this error occurred, for example " "``CERTIFICATE_VERIFY_FAILED``. The range of possible values depends on the " @@ -91795,7 +93631,7 @@ msgid "" msgstr "" # 808fd9b4f1bf43db84fef53efb2bcbab -#: ../src/Doc/library/ssl.rst:87 +#: library/ssl.rst:87 msgid "" "A subclass of :exc:`SSLError` raised when trying to read or write and the " "SSL connection has been closed cleanly. Note that this doesn't mean that " @@ -91803,7 +93639,7 @@ msgid "" msgstr "" # 4d2733d72a9f436891ccf65eca9d1c67 -#: ../src/Doc/library/ssl.rst:95 +#: library/ssl.rst:95 msgid "" "A subclass of :exc:`SSLError` raised by a :ref:`non-blocking SSL socket <ssl-" "nonblocking>` when trying to read or write data, but more data needs to be " @@ -91811,7 +93647,7 @@ msgid "" msgstr "" # 82d29c76e98847bfa4f49336404cf3b5 -#: ../src/Doc/library/ssl.rst:104 +#: library/ssl.rst:104 msgid "" "A subclass of :exc:`SSLError` raised by a :ref:`non-blocking SSL socket <ssl-" "nonblocking>` when trying to read or write data, but more data needs to be " @@ -91819,7 +93655,7 @@ msgid "" msgstr "" # 3c48493c48e24493aa0d04f17a521d44 -#: ../src/Doc/library/ssl.rst:113 +#: library/ssl.rst:113 msgid "" "A subclass of :exc:`SSLError` raised when a system error was encountered " "while trying to fulfill an operation on a SSL socket. Unfortunately, there " @@ -91827,7 +93663,7 @@ msgid "" msgstr "" # 8b4f4fbe402945ef8c77b56437c1bb7a -#: ../src/Doc/library/ssl.rst:121 +#: library/ssl.rst:121 msgid "" "A subclass of :exc:`SSLError` raised when the SSL connection has been " "terminated abruptly. Generally, you shouldn't try to reuse the underlying " @@ -91835,7 +93671,7 @@ msgid "" msgstr "" # 56713211317046e5b6b644223f8040db -#: ../src/Doc/library/ssl.rst:129 +#: library/ssl.rst:129 msgid "" "Raised to signal an error with a certificate (such as mismatching " "hostname). Certificate errors detected by OpenSSL, though, raise an :exc:" @@ -91843,12 +93679,12 @@ msgid "" msgstr "" # ceb1ef3c81b54c13bcbab4072067915c -#: ../src/Doc/library/ssl.rst:135 +#: library/ssl.rst:135 msgid "Socket creation" msgstr "" # 386feb1a20404cd396399d54276e063a -#: ../src/Doc/library/ssl.rst:137 +#: library/ssl.rst:137 msgid "" "The following function allows for standalone socket creation. Starting from " "Python 2.7.9, it can be more flexible to use :meth:`SSLContext.wrap_socket` " @@ -91856,7 +93692,7 @@ msgid "" msgstr "" # 5c6101015a2f4ac9aeee3984ba82fbf2 -#: ../src/Doc/library/ssl.rst:143 +#: library/ssl.rst:143 msgid "" "Takes an instance ``sock`` of :class:`socket.socket`, and returns an " "instance of :class:`ssl.SSLSocket`, a subtype of :class:`socket.socket`, " @@ -91865,7 +93701,7 @@ msgid "" msgstr "" # 5c6101015a2f4ac9aeee3984ba82fbf2 -#: ../src/Doc/library/ssl.rst:148 +#: library/ssl.rst:148 msgid "" "For client-side sockets, the context construction is lazy; if the underlying " "socket isn't connected yet, the context construction will be performed " @@ -91876,7 +93712,7 @@ msgid "" "raise :exc:`SSLError`." msgstr "" -#: ../src/Doc/library/ssl.rst:156 +#: library/ssl.rst:156 msgid "" "The ``keyfile`` and ``certfile`` parameters specify optional files which " "contain a certificate to be used to identify the local side of the " @@ -91884,13 +93720,13 @@ msgid "" "information on how the certificate is stored in the ``certfile``." msgstr "" -#: ../src/Doc/library/ssl.rst:161 +#: library/ssl.rst:161 msgid "" "The parameter ``server_side`` is a boolean which identifies whether server-" "side or client-side behavior is desired from this socket." msgstr "" -#: ../src/Doc/library/ssl.rst:164 +#: library/ssl.rst:164 msgid "" "The parameter ``cert_reqs`` specifies whether a certificate is required from " "the other side of the connection, and whether it will be validated if " @@ -91901,7 +93737,7 @@ msgid "" "parameter must point to a file of CA certificates." msgstr "" -#: ../src/Doc/library/ssl.rst:172 +#: library/ssl.rst:172 msgid "" "The ``ca_certs`` file contains a set of concatenated \"certification " "authority\" certificates, which are used to validate certificates passed " @@ -91911,7 +93747,7 @@ msgid "" msgstr "" # 043907462ea04e97a067b9301b0905f4 -#: ../src/Doc/library/ssl.rst:178 +#: library/ssl.rst:178 msgid "" "The parameter ``ssl_version`` specifies which version of the SSL protocol to " "use. Typically, the server chooses a particular protocol version, and the " @@ -91921,97 +93757,93 @@ msgid "" "versions." msgstr "" -#: ../src/Doc/library/ssl.rst:185 +#: library/ssl.rst:185 msgid "" "Here's a table showing which versions in a client (down the side) can " "connect to which versions in a server (along the top):" msgstr "" -#: ../src/Doc/library/ssl.rst:191 +#: library/ssl.rst:191 msgid "*client* / **server**" msgstr "" -#: ../src/Doc/library/ssl.rst:191 +#: library/ssl.rst:191 msgid "**SSLv2**" msgstr "" -#: ../src/Doc/library/ssl.rst:191 +#: library/ssl.rst:191 msgid "**SSLv3**" msgstr "" -#: ../src/Doc/library/ssl.rst:191 +#: library/ssl.rst:191 msgid "**SSLv23**" msgstr "" -#: ../src/Doc/library/ssl.rst:191 +#: library/ssl.rst:191 msgid "**TLSv1**" msgstr "" # 2d05cdc29a59497bb3aa6d9538da47c1 -#: ../src/Doc/library/ssl.rst:191 +#: library/ssl.rst:191 msgid "**TLSv1.1**" msgstr "" # 2d05cdc29a59497bb3aa6d9538da47c1 -#: ../src/Doc/library/ssl.rst:191 +#: library/ssl.rst:191 msgid "**TLSv1.2**" msgstr "" -#: ../src/Doc/library/ssl.rst:193 +#: library/ssl.rst:193 msgid "*SSLv2*" msgstr "" -#: ../src/Doc/library/ssl.rst:193 ../src/Doc/library/ssl.rst:194 -#: ../src/Doc/library/ssl.rst:195 ../src/Doc/library/ssl.rst:196 -#: ../src/Doc/library/ssl.rst:197 ../src/Doc/library/ssl.rst:198 +#: library/ssl.rst:193 library/ssl.rst:194 library/ssl.rst:195 +#: library/ssl.rst:196 library/ssl.rst:197 library/ssl.rst:198 msgid "yes" msgstr "oui" -#: ../src/Doc/library/ssl.rst:193 ../src/Doc/library/ssl.rst:194 -#: ../src/Doc/library/ssl.rst:195 ../src/Doc/library/ssl.rst:196 -#: ../src/Doc/library/ssl.rst:197 ../src/Doc/library/ssl.rst:198 +#: library/ssl.rst:193 library/ssl.rst:194 library/ssl.rst:195 +#: library/ssl.rst:196 library/ssl.rst:197 library/ssl.rst:198 msgid "no" msgstr "non" -#: ../src/Doc/library/ssl.rst:194 +#: library/ssl.rst:194 msgid "*SSLv3*" msgstr "" -#: ../src/Doc/library/ssl.rst:195 +#: library/ssl.rst:195 msgid "*SSLv23*" msgstr "" -#: ../src/Doc/library/ssl.rst:196 +#: library/ssl.rst:196 msgid "*TLSv1*" msgstr "" # ec0403fd97bb4102a0c969ca797cecff -#: ../src/Doc/library/ssl.rst:197 +#: library/ssl.rst:197 msgid "*TLSv1.1*" msgstr "" # ec0403fd97bb4102a0c969ca797cecff -#: ../src/Doc/library/ssl.rst:198 +#: library/ssl.rst:198 msgid "*TLSv1.2*" msgstr "" -# 809bfa74ef6f4fa0b39bf93b3ec11903 -#: ../src/Doc/library/ssl.rst:203 +#: library/ssl.rst:203 msgid "" "Which connections succeed will vary depending on the version of OpenSSL. " -"For example, beginning with OpenSSL 1.0.0, an SSLv23 client will not " -"actually attempt SSLv2 connections unless you explicitly enable SSLv2 " -"ciphers (which is not recommended, as SSLv2 is broken)." +"For example, before OpenSSL 1.0.0, an SSLv23 client would always attempt " +"SSLv2 connections." msgstr "" -#: ../src/Doc/library/ssl.rst:208 +#: library/ssl.rst:207 msgid "" "The *ciphers* parameter sets the available ciphers for this SSL object. It " "should be a string in the `OpenSSL cipher list format <http://www.openssl." "org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT>`_." msgstr "" -#: ../src/Doc/library/ssl.rst:212 +#: library/ssl.rst:211 msgid "" "The parameter ``do_handshake_on_connect`` specifies whether to do the SSL " "handshake automatically after doing a :meth:`socket.connect`, or whether the " @@ -92022,7 +93854,7 @@ msgid "" msgstr "" # bae4b80d36554c47ab7238f75367afc9 -#: ../src/Doc/library/ssl.rst:219 +#: library/ssl.rst:218 msgid "" "The parameter ``suppress_ragged_eofs`` specifies how the :meth:`SSLSocket." "read` method should signal unexpected EOF from the other end of the " @@ -92032,20 +93864,26 @@ msgid "" "exceptions back to the caller." msgstr "" +# 30e5ab4a94f04c30a0d3a5d94e2de6ef +#: library/ssl.rst:225 +#, fuzzy +msgid "New optional argument *ciphers*." +msgstr "augment positionnel" + # 8944b30a117f4fedb7d234cacb729f82 -#: ../src/Doc/library/ssl.rst:231 +#: library/ssl.rst:230 msgid "Context creation" msgstr "" # 40fe456c350c483c8c2f77168a452f50 -#: ../src/Doc/library/ssl.rst:233 +#: library/ssl.rst:232 msgid "" "A convenience function helps create :class:`SSLContext` objects for common " "purposes." msgstr "" # 02232daf1c7d41df98b2bfb46e0e7822 -#: ../src/Doc/library/ssl.rst:238 +#: library/ssl.rst:237 msgid "" "Return a new :class:`SSLContext` object with default settings for the given " "*purpose*. The settings are chosen by the :mod:`ssl` module, and usually " @@ -92054,7 +93892,7 @@ msgid "" msgstr "" # 563be1aa24fa411f8fc81802f8f43260 -#: ../src/Doc/library/ssl.rst:243 +#: library/ssl.rst:242 msgid "" "*cafile*, *capath*, *cadata* represent optional CA certificates to trust for " "certificate verification, as in :meth:`SSLContext.load_verify_locations`. " @@ -92062,20 +93900,19 @@ msgid "" "system's default CA certificates instead." msgstr "" -# fd8957af6bb947028a314ca6191527bd -#: ../src/Doc/library/ssl.rst:249 +#: library/ssl.rst:248 msgid "" -"The settings in Python 2.7.9 are: :data:`PROTOCOL_SSLv23`, :data:" -"`OP_NO_SSLv2`, and :data:`OP_NO_SSLv3` with high encryption cipher suites " -"without RC4 and without unauthenticated cipher suites. Passing :data:" -"`~Purpose.SERVER_AUTH` as *purpose* sets :data:`~SSLContext.verify_mode` to :" -"data:`CERT_REQUIRED` and either loads CA certificates (when at least one of " -"*cafile*, *capath* or *cadata* is given) or uses :meth:`SSLContext." -"load_default_certs` to load default CA certificates." +"The settings are: :data:`PROTOCOL_SSLv23`, :data:`OP_NO_SSLv2`, and :data:" +"`OP_NO_SSLv3` with high encryption cipher suites without RC4 and without " +"unauthenticated cipher suites. Passing :data:`~Purpose.SERVER_AUTH` as " +"*purpose* sets :data:`~SSLContext.verify_mode` to :data:`CERT_REQUIRED` and " +"either loads CA certificates (when at least one of *cafile*, *capath* or " +"*cadata* is given) or uses :meth:`SSLContext.load_default_certs` to load " +"default CA certificates." msgstr "" # 51d5d1cc39db457ab241b47d2f665b20 -#: ../src/Doc/library/ssl.rst:259 +#: library/ssl.rst:257 msgid "" "The protocol, options, cipher and other settings may change to more " "restrictive values anytime without prior deprecation. The values represent " @@ -92083,41 +93920,42 @@ msgid "" msgstr "" # 09b77e0f0bf14d6a9a303bbc04bb0e95 -#: ../src/Doc/library/ssl.rst:263 +#: library/ssl.rst:261 msgid "" "If your application needs specific settings, you should create a :class:" "`SSLContext` and apply the settings yourself." msgstr "" -# 097e0dbe15584b2faf1d9d59570eab88 -#: ../src/Doc/library/ssl.rst:267 +#: library/ssl.rst:265 msgid "" "If you find that when certain older clients or servers attempt to connect " "with a :class:`SSLContext` created by this function that they get an error " "stating \"Protocol or cipher suite mismatch\", it may be that they only " "support SSL3.0 which this function excludes using the :data:`OP_NO_SSLv3`. " -"SSL3.0 has problematic security due to a number of poor implementations and " -"it's reliance on MD5 within the protocol. If you wish to continue to use " -"this function but still allow SSL 3.0 connections you can re-enable them " -"using::" +"SSL3.0 is widely considered to be `completely broken <https://en.wikipedia." +"org/wiki/POODLE>`_. If you still wish to continue to use this function but " +"still allow SSL 3.0 connections you can re-enable them using::" +msgstr "" + +#: library/ssl.rst:281 +msgid "RC4 was dropped from the default cipher string." msgstr "" # 8944b30a117f4fedb7d234cacb729f82 -#: ../src/Doc/library/ssl.rst:283 +#: library/ssl.rst:285 msgid "Random generation" msgstr "" -# 8753954ef06c4499b335fb525fdfc6f6 -#: ../src/Doc/library/ssl.rst:287 +#: library/ssl.rst:289 msgid "" -"Returns ``True`` if the SSL pseudo-random number generator has been seeded " +"Return ``True`` if the SSL pseudo-random number generator has been seeded " "with 'enough' randomness, and ``False`` otherwise. You can use :func:`ssl." "RAND_egd` and :func:`ssl.RAND_add` to increase the randomness of the pseudo-" "random number generator." msgstr "" # bd5c13f194614a7db76b0610e2a7cff7 -#: ../src/Doc/library/ssl.rst:294 +#: library/ssl.rst:296 msgid "" "If you are running an entropy-gathering daemon (EGD) somewhere, and *path* " "is the pathname of a socket connection open to it, this will read 256 bytes " @@ -92126,28 +93964,31 @@ msgid "" "typically only necessary on systems without better sources of randomness." msgstr "" -#: ../src/Doc/library/ssl.rst:300 +#: library/ssl.rst:302 msgid "" "See http://egd.sourceforge.net/ or http://prngd.sourceforge.net/ for sources " "of entropy-gathering daemons." msgstr "" -# 7fd9cdffc0494b33a7933857badf3d8c -#: ../src/Doc/library/ssl.rst:305 +#: library/ssl.rst:305 +msgid "Availability: not available with LibreSSL." +msgstr "" + +#: library/ssl.rst:309 msgid "" -"Mixes the given *bytes* into the SSL pseudo-random number generator. The " +"Mix the given *bytes* into the SSL pseudo-random number generator. The " "parameter *entropy* (a float) is a lower bound on the entropy contained in " "string (so you can always use :const:`0.0`). See :rfc:`1750` for more " "information on sources of entropy." msgstr "" # a1a46ac79e414a358644d2f4cc060668 -#: ../src/Doc/library/ssl.rst:311 +#: library/ssl.rst:315 msgid "Certificate handling" msgstr "" # eaa021fb12d84e6b886c7c5f7e65ae5b -#: ../src/Doc/library/ssl.rst:315 +#: library/ssl.rst:319 msgid "" "Verify that *cert* (in decoded format as returned by :meth:`SSLSocket." "getpeercert`) matches the given *hostname*. The rules applied are those for " @@ -92158,14 +93999,14 @@ msgid "" msgstr "" # 86c451b9d2124cd6b754322b72993720 -#: ../src/Doc/library/ssl.rst:323 +#: library/ssl.rst:327 msgid "" ":exc:`CertificateError` is raised on failure. On success, the function " "returns nothing::" msgstr "" # 2479a6495798475b84b3b6e83619aa11 -#: ../src/Doc/library/ssl.rst:339 +#: library/ssl.rst:343 msgid "" "Return the time in seconds since the Epoch, given the ``cert_time`` string " "representing the \"notBefore\" or \"notAfter\" date from a certificate in ``" @@ -92173,16 +94014,23 @@ msgid "" msgstr "" # 4826f4c32c344dc2a57d70ce0c71670f -#: ../src/Doc/library/ssl.rst:344 +#: library/ssl.rst:348 msgid "Here's an example:" msgstr "" # dc1cc5853e514649a3a2ae4be3cc8677 -#: ../src/Doc/library/ssl.rst:356 +#: library/ssl.rst:360 msgid "\"notBefore\" or \"notAfter\" dates must use GMT (:rfc:`5280`)." msgstr "" -#: ../src/Doc/library/ssl.rst:366 +#: library/ssl.rst:362 +msgid "" +"Interpret the input time as a time in UTC as specified by 'GMT' timezone in " +"the input string. Local timezone was used previously. Return an integer (no " +"fractions of a second in the input format)" +msgstr "" + +#: library/ssl.rst:370 msgid "" "Given the address ``addr`` of an SSL-protected server, as a (*hostname*, " "*port-number*) pair, fetches the server's certificate, and returns it as a " @@ -92194,20 +94042,27 @@ msgid "" "certificates, and will fail if the validation attempt fails." msgstr "" -#: ../src/Doc/library/ssl.rst:383 +#: library/ssl.rst:381 +msgid "" +"This function is now IPv6-compatible, and the default *ssl_version* is " +"changed from :data:`PROTOCOL_SSLv3` to :data:`PROTOCOL_SSLv23` for maximum " +"compatibility with modern servers." +msgstr "" + +#: library/ssl.rst:387 msgid "" "Given a certificate as a DER-encoded blob of bytes, returns a PEM-encoded " "string version of the same certificate." msgstr "" -#: ../src/Doc/library/ssl.rst:388 +#: library/ssl.rst:392 msgid "" "Given a certificate as an ASCII PEM string, returns a DER-encoded sequence " "of bytes for that same certificate." msgstr "" # e7ae2da15582439fb73c39991dfdb205 -#: ../src/Doc/library/ssl.rst:393 +#: library/ssl.rst:397 msgid "" "Returns a named tuple with paths to OpenSSL's default cafile and capath. The " "paths are the same as used by :meth:`SSLContext.set_default_verify_paths`. " @@ -92215,44 +94070,44 @@ msgid "" msgstr "" # 6dc5d4a3a05840dfa22d0bcd9b576dae -#: ../src/Doc/library/ssl.rst:398 +#: library/ssl.rst:402 msgid "" ":attr:`cafile` - resolved path to cafile or None if the file doesn't exist," msgstr "" # 811bf4f4474a49babba1ae1036440a53 -#: ../src/Doc/library/ssl.rst:399 +#: library/ssl.rst:403 msgid "" ":attr:`capath` - resolved path to capath or None if the directory doesn't " "exist," msgstr "" # c2a14c7523474a31a15662d8fc62362c -#: ../src/Doc/library/ssl.rst:400 +#: library/ssl.rst:404 msgid "" ":attr:`openssl_cafile_env` - OpenSSL's environment key that points to a " "cafile," msgstr "" # 7dbc0f8a11a04a408a0c30951fdd407c -#: ../src/Doc/library/ssl.rst:401 +#: library/ssl.rst:405 msgid ":attr:`openssl_cafile` - hard coded path to a cafile," msgstr "" # f0a29155d71e4e299c3f3ed81fac02e2 -#: ../src/Doc/library/ssl.rst:402 +#: library/ssl.rst:406 msgid "" ":attr:`openssl_capath_env` - OpenSSL's environment key that points to a " "capath," msgstr "" # 00db5dc19565482b8ab3ad4379d8df13 -#: ../src/Doc/library/ssl.rst:403 +#: library/ssl.rst:407 msgid ":attr:`openssl_capath` - hard coded path to a capath directory" msgstr "" # 13b1b028b69e44b58fb1f76ffcac5cbd -#: ../src/Doc/library/ssl.rst:409 +#: library/ssl.rst:413 msgid "" "Retrieve certificates from Windows' system cert store. *store_name* may be " "one of ``CA``, ``ROOT`` or ``MY``. Windows may provide additional cert " @@ -92260,7 +94115,7 @@ msgid "" msgstr "" # a08c37dfafff4322a24568417cea03a2 -#: ../src/Doc/library/ssl.rst:413 +#: library/ssl.rst:417 msgid "" "The function returns a list of (cert_bytes, encoding_type, trust) tuples. " "The encoding_type specifies the encoding of cert_bytes. It is either :const:" @@ -92270,14 +94125,14 @@ msgid "" msgstr "" # b12afd293b3f4231ac0b1fec99dbb62c -#: ../src/Doc/library/ssl.rst:432 +#: library/ssl.rst:436 msgid "" "Retrieve CRLs from Windows' system cert store. *store_name* may be one of " "``CA``, ``ROOT`` or ``MY``. Windows may provide additional cert stores, too." msgstr "" # d0fc2244aea34455b201dc7c4faf5a81 -#: ../src/Doc/library/ssl.rst:436 +#: library/ssl.rst:440 msgid "" "The function returns a list of (cert_bytes, encoding_type, trust) tuples. " "The encoding_type specifies the encoding of cert_bytes. It is either :const:" @@ -92285,7 +94140,7 @@ msgid "" msgstr "" # 1247a1ccc8c5471785a49d13a1f36132 -#: ../src/Doc/library/ssl.rst:451 +#: library/ssl.rst:455 msgid "" "Possible value for :attr:`SSLContext.verify_mode`, or the ``cert_reqs`` " "parameter to :func:`wrap_socket`. In this mode (the default), no " @@ -92296,12 +94151,12 @@ msgstr "" # 10b4b655f5444c189704c105ffd48d1e # 18b9e2da426e4c9995af633270b3c497 -#: ../src/Doc/library/ssl.rst:457 ../src/Doc/library/ssl.rst:1473 +#: library/ssl.rst:461 library/ssl.rst:1519 msgid "See the discussion of :ref:`ssl-security` below." msgstr "" # 2d67512219244c72ab374a3c9dc71b29 -#: ../src/Doc/library/ssl.rst:461 +#: library/ssl.rst:465 msgid "" "Possible value for :attr:`SSLContext.verify_mode`, or the ``cert_reqs`` " "parameter to :func:`wrap_socket`. In this mode no certificates will be " @@ -92312,7 +94167,7 @@ msgstr "" # f45f610d6b79492098dab019963ff07c # 34dac5b8e9bc4a09ac55d45ec9d3b7ad -#: ../src/Doc/library/ssl.rst:467 ../src/Doc/library/ssl.rst:478 +#: library/ssl.rst:471 library/ssl.rst:482 msgid "" "Use of this setting requires a valid set of CA certificates to be passed, " "either to :meth:`SSLContext.load_verify_locations` or as a value of the " @@ -92320,7 +94175,7 @@ msgid "" msgstr "" # 1247a1ccc8c5471785a49d13a1f36132 -#: ../src/Doc/library/ssl.rst:473 +#: library/ssl.rst:477 msgid "" "Possible value for :attr:`SSLContext.verify_mode`, or the ``cert_reqs`` " "parameter to :func:`wrap_socket`. In this mode, certificates are required " @@ -92329,7 +94184,7 @@ msgid "" msgstr "" # 1a65c238fd2345ecbc8a537ba89b1694 -#: ../src/Doc/library/ssl.rst:484 +#: library/ssl.rst:488 msgid "" "Possible value for :attr:`SSLContext.verify_flags`. In this mode, " "certificate revocation lists (CRLs) are not checked. By default OpenSSL does " @@ -92337,7 +94192,7 @@ msgid "" msgstr "" # 0a6b5171e2334f67b4c61cab33c2d37d -#: ../src/Doc/library/ssl.rst:492 +#: library/ssl.rst:496 msgid "" "Possible value for :attr:`SSLContext.verify_flags`. In this mode, only the " "peer cert is check but non of the intermediate CA certificates. The mode " @@ -92347,66 +94202,78 @@ msgid "" msgstr "" # 2ef875c973ae4d469866367f48ec6034 -#: ../src/Doc/library/ssl.rst:502 +#: library/ssl.rst:506 msgid "" "Possible value for :attr:`SSLContext.verify_flags`. In this mode, CRLs of " "all certificates in the peer cert chain are checked." msgstr "" # 9d38ef6763d643d6b54989a554aa4cbb -#: ../src/Doc/library/ssl.rst:509 +#: library/ssl.rst:513 msgid "" "Possible value for :attr:`SSLContext.verify_flags` to disable workarounds " "for broken X.509 certificates." msgstr "" +#: library/ssl.rst:520 +msgid "" +"Possible value for :attr:`SSLContext.verify_flags`. It instructs OpenSSL to " +"prefer trusted certificates when building the trust chain to validate a " +"certificate. This flag is enabled by default." +msgstr "" + # f9ed082cf2ea43a19e6fc41f2f164447 -#: ../src/Doc/library/ssl.rst:516 +#: library/ssl.rst:528 msgid "" "Selects the highest protocol version that both the client and server " "support. Despite the name, this option can select \"TLS\" protocols as well " "as \"SSL\"." msgstr "" -#: ../src/Doc/library/ssl.rst:521 +#: library/ssl.rst:533 msgid "Selects SSL version 2 as the channel encryption protocol." msgstr "" -# e23b7770dd9a4d3faf00a50ddeabb5a0 -#: ../src/Doc/library/ssl.rst:523 +#: library/ssl.rst:535 msgid "" -"This protocol is not available if OpenSSL is compiled with OPENSSL_NO_SSL2 " -"flag." +"This protocol is not available if OpenSSL is compiled with the " +"``OPENSSL_NO_SSL2`` flag." msgstr "" -#: ../src/Doc/library/ssl.rst:528 +#: library/ssl.rst:540 msgid "SSL version 2 is insecure. Its use is highly discouraged." msgstr "" # 0f12a2b8dfe740c4ac613c6795d0bd6e -#: ../src/Doc/library/ssl.rst:532 +#: library/ssl.rst:544 msgid "Selects SSL version 3 as the channel encryption protocol." msgstr "" +#: library/ssl.rst:546 +msgid "" +"This protocol is not be available if OpenSSL is compiled with the " +"``OPENSSL_NO_SSLv3`` flag." +msgstr "" + # 010abfa9853c4c2d8f9f5f5d65e7a856 -#: ../src/Doc/library/ssl.rst:536 +#: library/ssl.rst:551 msgid "SSL version 3 is insecure. Its use is highly discouraged." msgstr "" # 0f12a2b8dfe740c4ac613c6795d0bd6e -#: ../src/Doc/library/ssl.rst:540 +#: library/ssl.rst:555 msgid "Selects TLS version 1.0 as the channel encryption protocol." msgstr "" # 83396f100809458891ed6f98d9e694b2 -#: ../src/Doc/library/ssl.rst:544 +#: library/ssl.rst:559 msgid "" "Selects TLS version 1.1 as the channel encryption protocol. Available only " "with openssl version 1.0.1+." msgstr "" # c4ddff7958ff4a6e80545ae88d6b3f9c -#: ../src/Doc/library/ssl.rst:551 +#: library/ssl.rst:566 msgid "" "Selects TLS version 1.2 as the channel encryption protocol. This is the most " "modern version, and probably the best choice for maximum protection, if both " @@ -92414,7 +94281,7 @@ msgid "" msgstr "" # f0dd971612f64103a05d1bcaccc9724f -#: ../src/Doc/library/ssl.rst:559 +#: library/ssl.rst:574 msgid "" "Enables workarounds for various bugs present in other SSL implementations. " "This option is set by default. It does not necessarily set the same flags " @@ -92422,7 +94289,7 @@ msgid "" msgstr "" # 4eea59e28a034b85b20d4b22054a3179 -#: ../src/Doc/library/ssl.rst:567 +#: library/ssl.rst:582 msgid "" "Prevents an SSLv2 connection. This option is only applicable in conjunction " "with :const:`PROTOCOL_SSLv23`. It prevents the peers from choosing SSLv2 as " @@ -92430,7 +94297,7 @@ msgid "" msgstr "" # 4a399620d0eb41c094e8d79b1947f49e -#: ../src/Doc/library/ssl.rst:575 +#: library/ssl.rst:590 msgid "" "Prevents an SSLv3 connection. This option is only applicable in conjunction " "with :const:`PROTOCOL_SSLv23`. It prevents the peers from choosing SSLv3 as " @@ -92438,7 +94305,7 @@ msgid "" msgstr "" # 934af37b610b43b0b337110c84eca11f -#: ../src/Doc/library/ssl.rst:583 +#: library/ssl.rst:598 msgid "" "Prevents a TLSv1 connection. This option is only applicable in conjunction " "with :const:`PROTOCOL_SSLv23`. It prevents the peers from choosing TLSv1 as " @@ -92446,7 +94313,7 @@ msgid "" msgstr "" # 595ed8fe1d61469aba31713bc6f93405 -#: ../src/Doc/library/ssl.rst:591 +#: library/ssl.rst:606 msgid "" "Prevents a TLSv1.1 connection. This option is only applicable in conjunction " "with :const:`PROTOCOL_SSLv23`. It prevents the peers from choosing TLSv1.1 " @@ -92454,7 +94321,7 @@ msgid "" msgstr "" # cbc51dc500e64c80b783782156df8735 -#: ../src/Doc/library/ssl.rst:599 +#: library/ssl.rst:614 msgid "" "Prevents a TLSv1.2 connection. This option is only applicable in conjunction " "with :const:`PROTOCOL_SSLv23`. It prevents the peers from choosing TLSv1.2 " @@ -92462,14 +94329,14 @@ msgid "" msgstr "" # 31ac1993758a4fa4ae170628fc6b1342 -#: ../src/Doc/library/ssl.rst:607 +#: library/ssl.rst:622 msgid "" "Use the server's cipher ordering preference, rather than the client's. This " "option has no effect on client sockets and SSLv2 server sockets." msgstr "" # ead46c2dea32466e97a2d75b8e90964b -#: ../src/Doc/library/ssl.rst:614 +#: library/ssl.rst:629 msgid "" "Prevents re-use of the same DH key for distinct SSL sessions. This improves " "forward secrecy but requires more computational resources. This option only " @@ -92477,7 +94344,7 @@ msgid "" msgstr "" # 795d05a5548146eaa453283c5c4420b5 -#: ../src/Doc/library/ssl.rst:622 +#: library/ssl.rst:637 msgid "" "Prevents re-use of the same ECDH key for distinct SSL sessions. This " "improves forward secrecy but requires more computational resources. This " @@ -92485,35 +94352,39 @@ msgid "" msgstr "" # 0052e1638b704102bf616e3206177352 -#: ../src/Doc/library/ssl.rst:630 +#: library/ssl.rst:645 msgid "" "Disable compression on the SSL channel. This is useful if the application " "protocol supports its own compression scheme." msgstr "" # e23b7770dd9a4d3faf00a50ddeabb5a0 -#: ../src/Doc/library/ssl.rst:633 +#: library/ssl.rst:648 msgid "This option is only available with OpenSSL 1.0.0 and later." msgstr "" +#: library/ssl.rst:654 +msgid "" +"Whether the OpenSSL library has built-in support for the *Application-Layer " +"Protocol Negotiation* TLS extension as described in :rfc:`7301`." +msgstr "" + # 9d80b3b0993149edaddc28b59998eddc -#: ../src/Doc/library/ssl.rst:639 +#: library/ssl.rst:661 msgid "" "Whether the OpenSSL library has built-in support for Elliptic Curve-based " "Diffie-Hellman key exchange. This should be true unless the feature was " "explicitly disabled by the distributor." msgstr "" -# cccd292af57c4df48c43d53b7e54d2e6 -#: ../src/Doc/library/ssl.rst:647 +#: library/ssl.rst:669 msgid "" "Whether the OpenSSL library has built-in support for the *Server Name " -"Indication* extension (as defined in :rfc:`4366`). When true, you can use " -"the *server_hostname* argument to :meth:`SSLContext.wrap_socket`." +"Indication* extension (as defined in :rfc:`4366`)." msgstr "" # 6e1c97e8d460490f8561336c0555ece3 -#: ../src/Doc/library/ssl.rst:655 +#: library/ssl.rst:676 msgid "" "Whether the OpenSSL library has built-in support for *Next Protocol " "Negotiation* as described in the `NPN draft specification <http://tools.ietf." @@ -92523,28 +94394,28 @@ msgid "" msgstr "" # ad8fb4db085c435e84b605c51378c3a5 -#: ../src/Doc/library/ssl.rst:665 +#: library/ssl.rst:686 msgid "" "List of supported TLS channel binding types. Strings in this list can be " "used as arguments to :meth:`SSLSocket.get_channel_binding`." msgstr "" -#: ../src/Doc/library/ssl.rst:672 +#: library/ssl.rst:693 msgid "The version string of the OpenSSL library loaded by the interpreter::" msgstr "" -#: ../src/Doc/library/ssl.rst:681 +#: library/ssl.rst:702 msgid "" "A tuple of five integers representing version information about the OpenSSL " "library::" msgstr "" -#: ../src/Doc/library/ssl.rst:691 +#: library/ssl.rst:712 msgid "The raw version number of the OpenSSL library, as a single integer::" msgstr "" # 1a28acdb908f45629b8b34631e071940 -#: ../src/Doc/library/ssl.rst:704 +#: library/ssl.rst:725 msgid "" "Alert Descriptions from :rfc:`5246` and others. The `IANA TLS Alert Registry " "<http://www.iana.org/assignments/tls-parameters/tls-parameters.xml#tls-" @@ -92553,14 +94424,14 @@ msgid "" msgstr "" # 1c11f54177b341349cf0530b5e0269d5 -#: ../src/Doc/library/ssl.rst:708 +#: library/ssl.rst:729 msgid "" "Used as the return value of the callback function in :meth:`SSLContext." "set_servername_callback`." msgstr "" # 817a847c347f42a0b2367f69e4238004 -#: ../src/Doc/library/ssl.rst:715 +#: library/ssl.rst:736 msgid "" "Option for :func:`create_default_context` and :meth:`SSLContext." "load_default_certs`. This value indicates that the context may be used to " @@ -92569,7 +94440,7 @@ msgid "" msgstr "" # 45134d25b1174f02b4e8954614cb858e -#: ../src/Doc/library/ssl.rst:724 +#: library/ssl.rst:745 msgid "" "Option for :func:`create_default_context` and :meth:`SSLContext." "load_default_certs`. This value indicates that the context may be used to " @@ -92578,90 +94449,90 @@ msgid "" msgstr "" # f2243061002c4b8580ae6ab66b00bdc9 -#: ../src/Doc/library/ssl.rst:733 +#: library/ssl.rst:754 msgid "SSL Sockets" msgstr "" # 6fae959ad2c745cf97e3b6c71ce07895 -#: ../src/Doc/library/ssl.rst:735 +#: library/ssl.rst:756 msgid "SSL sockets provide the following methods of :ref:`socket-objects`:" msgstr "" # d75971165df749cd8852189f3fa3594c -#: ../src/Doc/library/ssl.rst:737 +#: library/ssl.rst:758 msgid ":meth:`~socket.socket.accept()`" msgstr "" # 5ff95e02e08b4b24a7d2b503b32d3ac2 -#: ../src/Doc/library/ssl.rst:738 +#: library/ssl.rst:759 msgid ":meth:`~socket.socket.bind()`" msgstr "" # 5ff95e02e08b4b24a7d2b503b32d3ac2 -#: ../src/Doc/library/ssl.rst:739 +#: library/ssl.rst:760 msgid ":meth:`~socket.socket.close()`" msgstr "" # 036f00d9d138491d9774199d61c9d211 -#: ../src/Doc/library/ssl.rst:740 +#: library/ssl.rst:761 msgid ":meth:`~socket.socket.connect()`" msgstr "" # ce26a15f87f445648d62b13954a3f2e9 -#: ../src/Doc/library/ssl.rst:741 +#: library/ssl.rst:762 msgid ":meth:`~socket.socket.fileno()`" msgstr "" # 788b1a7197b447a2a32485dd6743b6b5 -#: ../src/Doc/library/ssl.rst:742 +#: library/ssl.rst:763 msgid "" ":meth:`~socket.socket.getpeername()`, :meth:`~socket.socket.getsockname()`" msgstr "" # 1fe775bf0e8a4db38bab082b16332c9f -#: ../src/Doc/library/ssl.rst:743 +#: library/ssl.rst:764 msgid "" ":meth:`~socket.socket.getsockopt()`, :meth:`~socket.socket.setsockopt()`" msgstr "" # e4bdef40fb6f4a00adbeaf18c51cacdc -#: ../src/Doc/library/ssl.rst:744 +#: library/ssl.rst:765 msgid "" ":meth:`~socket.socket.gettimeout()`, :meth:`~socket.socket.settimeout()`, :" "meth:`~socket.socket.setblocking()`" msgstr "" # 8d581fe7a8274d44bb3c6af668a5c804 -#: ../src/Doc/library/ssl.rst:746 +#: library/ssl.rst:767 msgid ":meth:`~socket.socket.listen()`" msgstr "" # aba19dcac44d4e29b3572a9b3c0b6a41 -#: ../src/Doc/library/ssl.rst:747 +#: library/ssl.rst:768 msgid ":meth:`~socket.socket.makefile()`" msgstr "" # 7d7880c048ab4d20a370bc82e57ce9e3 -#: ../src/Doc/library/ssl.rst:748 +#: library/ssl.rst:769 msgid "" ":meth:`~socket.socket.recv()`, :meth:`~socket.socket.recv_into()` (but " "passing a non-zero ``flags`` argument is not allowed)" msgstr "" # 3d188d93708a456e85765b0d3601dbfd -#: ../src/Doc/library/ssl.rst:750 +#: library/ssl.rst:771 msgid "" ":meth:`~socket.socket.send()`, :meth:`~socket.socket.sendall()` (with the " "same limitation)" msgstr "" # 2d090276e12d4fd88b0dab715c83890f -#: ../src/Doc/library/ssl.rst:752 +#: library/ssl.rst:773 msgid ":meth:`~socket.socket.shutdown()`" msgstr "" # b7ed6aabc9ad4efcb8f3ac225e22b597 -#: ../src/Doc/library/ssl.rst:754 +#: library/ssl.rst:775 msgid "" "However, since the SSL (and TLS) protocol has its own framing atop of TCP, " "the SSL sockets abstraction can, in certain respects, diverge from the " @@ -92670,17 +94541,24 @@ msgid "" msgstr "" # 493c0429ee844c5c8c5cfb7491cc775a -#: ../src/Doc/library/ssl.rst:759 +#: library/ssl.rst:780 msgid "SSL sockets also have the following additional methods and attributes:" msgstr "" # f5f696540a204eb28b73d436f06025a9 -#: ../src/Doc/library/ssl.rst:763 +#: library/ssl.rst:784 msgid "Perform the SSL setup handshake." msgstr "" +#: library/ssl.rst:788 +msgid "" +"The handshake method also performs :func:`match_hostname` when the :attr:" +"`~SSLContext.check_hostname` attribute of the socket's :attr:`~SSLSocket." +"context` is true." +msgstr "" + # 7dbefe4fabc04cad87b72dec1fdbbf29 -#: ../src/Doc/library/ssl.rst:773 +#: library/ssl.rst:794 msgid "" "If there is no certificate for the peer on the other end of the connection, " "return ``None``. If the SSL handshake hasn't been done yet, raise :exc:" @@ -92688,7 +94566,7 @@ msgid "" msgstr "" # c182f6d34fc047249d91d33dbd7842d6 -#: ../src/Doc/library/ssl.rst:777 +#: library/ssl.rst:798 msgid "" "If the ``binary_form`` parameter is :const:`False`, and a certificate was " "received from the peer, this method returns a :class:`dict` instance. If " @@ -92701,7 +94579,7 @@ msgid "" msgstr "" # 4bc7d730d8ad406397216a7394a40769 -#: ../src/Doc/library/ssl.rst:786 +#: library/ssl.rst:807 msgid "" "The ``subject`` and ``issuer`` fields are tuples containing the sequence of " "relative distinguished names (RDNs) given in the certificate's data " @@ -92710,14 +94588,14 @@ msgid "" msgstr "" # 5f3b409a9b9f49d4816f126d08564cd2 -#: ../src/Doc/library/ssl.rst:812 +#: library/ssl.rst:833 msgid "" "To validate a certificate for a particular service, you can use the :func:" "`match_hostname` function." msgstr "" # cd856a8829254351af28172d1df0a4ee -#: ../src/Doc/library/ssl.rst:815 +#: library/ssl.rst:836 msgid "" "If the ``binary_form`` parameter is :const:`True`, and a certificate was " "provided, this method returns the DER-encoded form of the entire certificate " @@ -92727,14 +94605,14 @@ msgid "" msgstr "" # 9b5e7efafcd54f73bf88885482d93ceb -#: ../src/Doc/library/ssl.rst:821 +#: library/ssl.rst:842 msgid "" "for a client SSL socket, the server will always provide a certificate, " "regardless of whether validation was required;" msgstr "" # d38006d341df46838ddc1e6f074f9b59 -#: ../src/Doc/library/ssl.rst:824 +#: library/ssl.rst:845 msgid "" "for a server SSL socket, the client will only provide a certificate when " "requested by the server; therefore :meth:`getpeercert` will return :const:" @@ -92742,7 +94620,15 @@ msgid "" "or :const:`CERT_REQUIRED`)." msgstr "" -#: ../src/Doc/library/ssl.rst:837 +#: library/ssl.rst:850 +msgid "" +"The returned dictionary includes additional items such as ``issuer`` and " +"``notBefore``. Additionall :exc:`ValueError` is raised when the handshake " +"isn't done. The returned dictionary includes additional X509v3 extension " +"items such as ``crlDistributionPoints``, ``caIssuers`` and ``OCSP`` URIs." +msgstr "" + +#: library/ssl.rst:858 msgid "" "Returns a three-value tuple containing the name of the cipher being used, " "the version of the SSL protocol that defines its use, and the number of " @@ -92751,28 +94637,28 @@ msgid "" msgstr "" # e46c0730d44a48148f0419d1e7e953ee -#: ../src/Doc/library/ssl.rst:843 +#: library/ssl.rst:864 msgid "" "Return the compression algorithm being used as a string, or ``None`` if the " "connection isn't compressed." msgstr "" # d2d1e4afee684ab893b82c527714ee05 -#: ../src/Doc/library/ssl.rst:846 +#: library/ssl.rst:867 msgid "" "If the higher-level protocol supports its own compression mechanism, you can " "use :data:`OP_NO_COMPRESSION` to disable SSL-level compression." msgstr "" # 3aad36bce789409b876ca299a7c00e56 -#: ../src/Doc/library/ssl.rst:853 +#: library/ssl.rst:874 msgid "" "Get channel binding data for current connection, as a bytes object. Returns " "``None`` if not connected or the handshake has not been completed." msgstr "" # 8b95d38ef82649268e0410616d38bd93 -#: ../src/Doc/library/ssl.rst:856 +#: library/ssl.rst:877 msgid "" "The *cb_type* parameter allow selection of the desired channel binding type. " "Valid channel binding types are listed in the :data:`CHANNEL_BINDING_TYPES` " @@ -92781,17 +94667,24 @@ msgid "" "channel binding type is requested." msgstr "" -# df62b47fbf1f48dbb514500bd190a2c4 -#: ../src/Doc/library/ssl.rst:866 +#: library/ssl.rst:887 msgid "" -"Returns the higher-level protocol that was selected during the TLS/SSL " +"Return the protocol that was selected during the TLS handshake. If :meth:" +"`SSLContext.set_alpn_protocols` was not called, if the other party does not " +"support ALPN, if this socket does not support any of the client's proposed " +"protocols, or if the handshake has not happened yet, ``None`` is returned." +msgstr "" + +#: library/ssl.rst:897 +msgid "" +"Return the higher-level protocol that was selected during the TLS/SSL " "handshake. If :meth:`SSLContext.set_npn_protocols` was not called, or if the " "other party does not support NPN, or if the handshake has not yet happened, " "this will return ``None``." msgstr "" # 76ee3a4cf06d4bb99285346a14256e77 -#: ../src/Doc/library/ssl.rst:875 +#: library/ssl.rst:906 msgid "" "Performs the SSL shutdown handshake, which removes the TLS layer from the " "underlying socket, and returns the underlying socket object. This can be " @@ -92801,7 +94694,7 @@ msgid "" msgstr "" # 471845cf23db47f78ce2b2b56f8c1ad0 -#: ../src/Doc/library/ssl.rst:883 +#: library/ssl.rst:914 msgid "" "Return the actual SSL protocol version negotiated by the connection as a " "string, or ``None`` is no secure connection is established. As of this " @@ -92811,7 +94704,7 @@ msgid "" msgstr "" # e1db8fa52b504ea2b705465924710b59 -#: ../src/Doc/library/ssl.rst:893 +#: library/ssl.rst:924 msgid "" "The :class:`SSLContext` object this SSL socket is tied to. If the SSL " "socket was created using the top-level :func:`wrap_socket` function (rather " @@ -92820,12 +94713,12 @@ msgid "" msgstr "" # c2a4959c33514b80823343499191f81f -#: ../src/Doc/library/ssl.rst:902 +#: library/ssl.rst:933 msgid "SSL Contexts" msgstr "" # 31511d9f989c4d8b83e6ecdbb588ac0a -#: ../src/Doc/library/ssl.rst:906 +#: library/ssl.rst:937 msgid "" "An SSL context holds various data longer-lived than single SSL connections, " "such as SSL configuration options, certificate(s) and private key(s). It " @@ -92834,20 +94727,26 @@ msgid "" msgstr "" # b13e2e5195b24094b01149a64e283e28 -#: ../src/Doc/library/ssl.rst:913 +#: library/ssl.rst:944 msgid "" "Create a new SSL context. You must pass *protocol* which must be one of the " "``PROTOCOL_*`` constants defined in this module. :data:`PROTOCOL_SSLv23` is " "currently recommended for maximum interoperability." msgstr "" +#: library/ssl.rst:950 +msgid "" +":func:`create_default_context` lets the :mod:`ssl` module choose security " +"settings for a given purpose." +msgstr "" + # 493c0429ee844c5c8c5cfb7491cc775a -#: ../src/Doc/library/ssl.rst:923 +#: library/ssl.rst:954 msgid ":class:`SSLContext` objects have the following methods and attributes:" msgstr "" # beda183d2f524806a7868d7bdd03d841 -#: ../src/Doc/library/ssl.rst:927 +#: library/ssl.rst:958 msgid "" "Get statistics about quantities of loaded X.509 certificates, count of X.509 " "certificates flagged as CA certificates and certificate revocation lists as " @@ -92855,12 +94754,12 @@ msgid "" msgstr "" # c9e3651d6b1f40309e37604881056194 -#: ../src/Doc/library/ssl.rst:931 +#: library/ssl.rst:962 msgid "Example for a context with one CA cert and one other cert::" msgstr "" # 2b8a7bf1926946b8bbe128480f4ad521 -#: ../src/Doc/library/ssl.rst:939 +#: library/ssl.rst:970 msgid "" "Load a private key and the corresponding certificate. The *certfile* string " "must be the path to a single file in PEM format containing the certificate " @@ -92873,7 +94772,7 @@ msgid "" msgstr "" # a392910b88fd4e6890fab75ed35a4a02 -#: ../src/Doc/library/ssl.rst:948 +#: library/ssl.rst:979 msgid "" "The *password* argument may be a function to call to get the password for " "decrypting the private key. It will only be called if the private key is " @@ -92886,7 +94785,7 @@ msgid "" msgstr "" # ac1b94a4c5de436a95b9a09acb237d88 -#: ../src/Doc/library/ssl.rst:957 +#: library/ssl.rst:988 msgid "" "If the *password* argument is not specified and a password is required, " "OpenSSL's built-in password prompting mechanism will be used to " @@ -92894,14 +94793,14 @@ msgid "" msgstr "" # d0765986d72647a6902524987aab79ee -#: ../src/Doc/library/ssl.rst:961 +#: library/ssl.rst:992 msgid "" "An :class:`SSLError` is raised if the private key doesn't match with the " "certificate." msgstr "" # 5c66d36f0dcd47f19ec1207d73e5724a -#: ../src/Doc/library/ssl.rst:966 +#: library/ssl.rst:997 msgid "" "Load a set of default \"certification authority\" (CA) certificates from " "default locations. On Windows it loads CA certs from the ``CA`` and ``ROOT`` " @@ -92911,7 +94810,7 @@ msgid "" msgstr "" # f71bed37d67f468b97f8db4f7c402945 -#: ../src/Doc/library/ssl.rst:972 +#: library/ssl.rst:1003 msgid "" "The *purpose* flag specifies what kind of CA certificates are loaded. The " "default settings :data:`Purpose.SERVER_AUTH` loads certificates, that are " @@ -92921,7 +94820,7 @@ msgid "" msgstr "" # 7ec10c1b1e0545d89ce578313492eae2 -#: ../src/Doc/library/ssl.rst:980 +#: library/ssl.rst:1011 msgid "" "Load a set of \"certification authority\" (CA) certificates used to validate " "other peers' certificates when :data:`verify_mode` is other than :data:" @@ -92929,7 +94828,7 @@ msgid "" msgstr "" # c4b266c4d79e4483880bf258691bd6b8 -#: ../src/Doc/library/ssl.rst:984 +#: library/ssl.rst:1015 msgid "" "This method can also load certification revocation lists (CRLs) in PEM or " "DER format. In order to make use of CRLs, :attr:`SSLContext.verify_flags` " @@ -92937,7 +94836,7 @@ msgid "" msgstr "" # df7e430288c341afadc5f6213b1e93dd -#: ../src/Doc/library/ssl.rst:988 +#: library/ssl.rst:1019 msgid "" "The *cafile* string, if present, is the path to a file of concatenated CA " "certificates in PEM format. See the discussion of :ref:`ssl-certificates` " @@ -92945,7 +94844,7 @@ msgid "" msgstr "" # 0af04ea0cc8e47deb1328d3872b1e829 -#: ../src/Doc/library/ssl.rst:993 +#: library/ssl.rst:1024 msgid "" "The *capath* string, if present, is the path to a directory containing " "several CA certificates in PEM format, following an `OpenSSL specific layout " @@ -92953,7 +94852,7 @@ msgid "" msgstr "" # 158da096f3a64b3c84bcf68920c54ab2 -#: ../src/Doc/library/ssl.rst:998 +#: library/ssl.rst:1029 msgid "" "The *cadata* object, if present, is either an ASCII string of one or more " "PEM-encoded certificates or a bytes-like object of DER-encoded certificates. " @@ -92962,7 +94861,7 @@ msgid "" msgstr "" # 82eb08622464482b9c184a693d10cb4e -#: ../src/Doc/library/ssl.rst:1005 +#: library/ssl.rst:1036 msgid "" "Get a list of loaded \"certification authority\" (CA) certificates. If the " "``binary_form`` parameter is :const:`False` each list entry is a dict like " @@ -92973,7 +94872,7 @@ msgid "" msgstr "" # f9a2af0a1fdf4623942ec36dade8cd8d -#: ../src/Doc/library/ssl.rst:1014 +#: library/ssl.rst:1045 msgid "" "Load a set of default \"certification authority\" (CA) certificates from a " "filesystem path defined when building the OpenSSL library. Unfortunately, " @@ -92984,7 +94883,7 @@ msgid "" msgstr "" # 6295543a648843afbd2a0695678d0544 -#: ../src/Doc/library/ssl.rst:1023 +#: library/ssl.rst:1054 msgid "" "Set the available ciphers for sockets created with this context. It should " "be a string in the `OpenSSL cipher list format <http://www.openssl.org/docs/" @@ -92994,14 +94893,30 @@ msgid "" msgstr "" # e0dde0fcd11a49a9953d989cd1c75876 -#: ../src/Doc/library/ssl.rst:1031 +#: library/ssl.rst:1062 msgid "" "when connected, the :meth:`SSLSocket.cipher` method of SSL sockets will give " "the currently selected cipher." msgstr "" +#: library/ssl.rst:1067 +msgid "" +"Specify which protocols the socket should advertise during the SSL/TLS " +"handshake. It should be a list of ASCII strings, like ``['http/1.1', " +"'spdy/2']``, ordered by preference. The selection of a protocol will happen " +"during the handshake, and will play out according to :rfc:`7301`. After a " +"successful handshake, the :meth:`SSLSocket.selected_alpn_protocol` method " +"will return the agreed-upon protocol." +msgstr "" + +#: library/ssl.rst:1074 +msgid "" +"This method will raise :exc:`NotImplementedError` if :data:`HAS_ALPN` is " +"False." +msgstr "" + # 734966c0acf04171bb78f97f0f058a22 -#: ../src/Doc/library/ssl.rst:1036 +#: library/ssl.rst:1081 msgid "" "Specify which protocols the socket should advertise during the SSL/TLS " "handshake. It should be a list of strings, like ``['http/1.1', 'spdy/2']``, " @@ -93013,14 +94928,14 @@ msgid "" msgstr "" # 8f32104b82c74b5e908a97004b359772 -#: ../src/Doc/library/ssl.rst:1044 +#: library/ssl.rst:1089 msgid "" "This method will raise :exc:`NotImplementedError` if :data:`HAS_NPN` is " "False." msgstr "" # 68eda083dbe14bbf8ceffa88e34371aa -#: ../src/Doc/library/ssl.rst:1049 +#: library/ssl.rst:1094 msgid "" "Register a callback function that will be called after the TLS Client Hello " "handshake message has been received by the SSL/TLS server when the TLS " @@ -93029,7 +94944,7 @@ msgid "" msgstr "" # 71e3bc2edf5049b6831319fd70165b45 -#: ../src/Doc/library/ssl.rst:1054 +#: library/ssl.rst:1099 msgid "" "Only one callback can be set per ``SSLContext``. If *server_name_callback* " "is ``None`` then the callback is disabled. Calling this function a " @@ -93037,7 +94952,7 @@ msgid "" msgstr "" # 0cf7e71c27d84bf7b166e3f089dfdb91 -#: ../src/Doc/library/ssl.rst:1058 +#: library/ssl.rst:1103 msgid "" "The callback function, *server_name_callback*, will be called with three " "arguments; the first being the :class:`ssl.SSLSocket`, the second is a " @@ -93048,19 +94963,18 @@ msgid "" msgstr "" # 29d506f63c39451dafc8731e03584065 -#: ../src/Doc/library/ssl.rst:1065 +#: library/ssl.rst:1110 msgid "" "A typical use of this callback is to change the :class:`ssl.SSLSocket`'s :" "attr:`SSLSocket.context` attribute to a new object of type :class:" "`SSLContext` representing a certificate chain that matches the server name." msgstr "" -# eecfa65680604638a3bc0334bef65a97 -#: ../src/Doc/library/ssl.rst:1070 +#: library/ssl.rst:1115 msgid "" "Due to the early negotiation phase of the TLS connection, only limited " "methods and attributes are usable like :meth:`SSLSocket." -"selected_npn_protocol` and :attr:`SSLSocket.context`. :meth:`SSLSocket." +"selected_alpn_protocol` and :attr:`SSLSocket.context`. :meth:`SSLSocket." "getpeercert`, :meth:`SSLSocket.getpeercert`, :meth:`SSLSocket.cipher` and :" "meth:`SSLSocket.compress` methods require that the TLS connection has " "progressed beyond the TLS Client Hello and therefore will not contain return " @@ -93068,7 +94982,7 @@ msgid "" msgstr "" # 1ed2e433aec6429bb734bffa36cd54f1 -#: ../src/Doc/library/ssl.rst:1078 +#: library/ssl.rst:1123 msgid "" "The *server_name_callback* function must return ``None`` to allow the TLS " "negotiation to continue. If a TLS failure is required, a constant :const:" @@ -93078,7 +94992,7 @@ msgid "" msgstr "" # e9ce72d4909945a7895a76fd6f776bcb -#: ../src/Doc/library/ssl.rst:1084 +#: library/ssl.rst:1129 msgid "" "If there is an IDNA decoding error on the server name, the TLS connection " "will terminate with an :const:`ALERT_DESCRIPTION_INTERNAL_ERROR` fatal TLS " @@ -93086,7 +95000,7 @@ msgid "" msgstr "" # 25daa7850dc244618806e76892ab35f5 -#: ../src/Doc/library/ssl.rst:1088 +#: library/ssl.rst:1133 msgid "" "If an exception is raised from the *server_name_callback* function the TLS " "connection will terminate with a fatal TLS alert message :const:" @@ -93094,14 +95008,14 @@ msgid "" msgstr "" # 7097ec697ca148828ff3dcd2bb511f50 -#: ../src/Doc/library/ssl.rst:1092 +#: library/ssl.rst:1137 msgid "" "This method will raise :exc:`NotImplementedError` if the OpenSSL library had " "OPENSSL_NO_TLSEXT defined when it was built." msgstr "" # cfa1b4f4db904f4fadd51a039b9ef4d0 -#: ../src/Doc/library/ssl.rst:1097 +#: library/ssl.rst:1142 msgid "" "Load the key generation parameters for Diffie-Helman (DH) key exchange. " "Using DH key exchange improves forward secrecy at the expense of " @@ -93111,14 +95025,14 @@ msgid "" msgstr "" # db7867aa77e94dbd9a0efe774e456522 -#: ../src/Doc/library/ssl.rst:1103 +#: library/ssl.rst:1148 msgid "" "This setting doesn't apply to client sockets. You can also use the :data:" "`OP_SINGLE_DH_USE` option to further improve security." msgstr "" # e6de31e49fde47fa8c40dd0e2928d0b0 -#: ../src/Doc/library/ssl.rst:1108 +#: library/ssl.rst:1153 msgid "" "Set the curve name for Elliptic Curve-based Diffie-Hellman (ECDH) key " "exchange. ECDH is significantly faster than regular DH while arguably as " @@ -93128,19 +95042,27 @@ msgid "" msgstr "" # 70bb3cbbb3974908b58fb7907098909c -#: ../src/Doc/library/ssl.rst:1114 +#: library/ssl.rst:1159 msgid "" "This setting doesn't apply to client sockets. You can also use the :data:" "`OP_SINGLE_ECDH_USE` option to further improve security." msgstr "" # e23b7770dd9a4d3faf00a50ddeabb5a0 -#: ../src/Doc/library/ssl.rst:1117 +#: library/ssl.rst:1162 msgid "This method is not available if :data:`HAS_ECDH` is False." msgstr "" +#: library/ssl.rst:1165 +msgid "SSL/TLS & Perfect Forward Secrecy" +msgstr "" + +#: library/ssl.rst:1166 +msgid "Vincent Bernat." +msgstr "" + # 5c6101015a2f4ac9aeee3984ba82fbf2 -#: ../src/Doc/library/ssl.rst:1127 +#: library/ssl.rst:1172 msgid "" "Wrap an existing Python socket *sock* and return an :class:`SSLSocket` " "object. *sock* must be a :data:`~socket.SOCK_STREAM` socket; other socket " @@ -93148,7 +95070,7 @@ msgid "" msgstr "" # 2e998d69e98945739db52520ee6b4839 -#: ../src/Doc/library/ssl.rst:1131 +#: library/ssl.rst:1176 msgid "" "The returned SSL socket is tied to the context, its settings and " "certificates. The parameters *server_side*, *do_handshake_on_connect* and " @@ -93156,21 +95078,23 @@ msgid "" "`wrap_socket` function." msgstr "" -# 52d113b3f8ce431299e2b24320b9ac09 -#: ../src/Doc/library/ssl.rst:1136 +#: library/ssl.rst:1181 msgid "" "On client connections, the optional parameter *server_hostname* specifies " "the hostname of the service which we are connecting to. This allows a " "single server to host multiple SSL-based services with distinct " -"certificates, quite similarly to HTTP virtual hosts. Specifying " -"*server_hostname* will raise a :exc:`ValueError` if the OpenSSL library " -"doesn't have support for it (that is, if :data:`HAS_SNI` is :const:" -"`False`). Specifying *server_hostname* will also raise a :exc:`ValueError` " -"if *server_side* is true." +"certificates, quite similarly to HTTP virtual hosts. Specifying " +"*server_hostname* will raise a :exc:`ValueError` if *server_side* is true." +msgstr "" + +#: library/ssl.rst:1187 +msgid "" +"Always allow a server_hostname to be passed, even if OpenSSL does not have " +"SNI." msgstr "" # 796af580a3ad4355bc9718f59a79d43c -#: ../src/Doc/library/ssl.rst:1147 +#: library/ssl.rst:1193 msgid "" "Get statistics about the SSL sessions created or managed by this context. A " "dictionary is returned which maps the names of each `piece of information " @@ -93180,21 +95104,21 @@ msgid "" msgstr "" # 255b7a36cf3d4672a52783fcaa31fc1f -#: ../src/Doc/library/ssl.rst:1159 +#: library/ssl.rst:1205 msgid "" "Returns a list of dicts with information of loaded CA certs. If the optional " "argument is true, returns a DER-encoded copy of the CA certificate." msgstr "" # 3861d56612dc43ebb549e745a6cdbf3f -#: ../src/Doc/library/ssl.rst:1164 +#: library/ssl.rst:1210 msgid "" "Certificates in a capath directory aren't loaded unless they have been used " "at least once." msgstr "" # 956a8737de664e3881c5d69174fd1be0 -#: ../src/Doc/library/ssl.rst:1169 +#: library/ssl.rst:1215 msgid "" "Wether to match the peer cert's hostname with :func:`match_hostname` in :" "meth:`SSLSocket.do_handshake`. The context's :attr:`~SSLContext.verify_mode` " @@ -93204,12 +95128,12 @@ msgid "" msgstr "" # b764e658776a4d2f9e006d335420df1e -#: ../src/Doc/library/ssl.rst:1190 +#: library/ssl.rst:1236 msgid "This features requires OpenSSL 0.9.8f or newer." msgstr "" # fca740e8f46545089a2e759b6ec44eae -#: ../src/Doc/library/ssl.rst:1194 +#: library/ssl.rst:1240 msgid "" "An integer representing the set of SSL options enabled on this context. The " "default value is :data:`OP_ALL`, but you can specify other options such as :" @@ -93217,7 +95141,7 @@ msgid "" msgstr "" # 403ebe5e94a34674bb44af536d92d335 -#: ../src/Doc/library/ssl.rst:1199 +#: library/ssl.rst:1245 msgid "" "With versions of OpenSSL older than 0.9.8m, it is only possible to set " "options, not to clear them. Attempting to clear an option (by resetting the " @@ -93225,14 +95149,14 @@ msgid "" msgstr "" # 6af4ebf406ce436b86d212c8b2f4cb6d -#: ../src/Doc/library/ssl.rst:1205 +#: library/ssl.rst:1251 msgid "" "The protocol version chosen when constructing the context. This attribute " "is read-only." msgstr "" # f298bad5fd58460d9bfe71e4c479ee13 -#: ../src/Doc/library/ssl.rst:1210 +#: library/ssl.rst:1256 msgid "" "The flags for certificate verification operations. You can set flags like :" "data:`VERIFY_CRL_CHECK_LEAF` by ORing them together. By default OpenSSL does " @@ -93241,18 +95165,18 @@ msgid "" msgstr "" # d38006d341df46838ddc1e6f074f9b59 -#: ../src/Doc/library/ssl.rst:1217 +#: library/ssl.rst:1263 msgid "" "Whether to try to verify other peers' certificates and how to behave if " "verification fails. This attribute must be one of :data:`CERT_NONE`, :data:" "`CERT_OPTIONAL` or :data:`CERT_REQUIRED`." msgstr "" -#: ../src/Doc/library/ssl.rst:1229 +#: library/ssl.rst:1275 msgid "Certificates" msgstr "" -#: ../src/Doc/library/ssl.rst:1231 +#: library/ssl.rst:1277 msgid "" "Certificates in general are part of a public-key / private-key system. In " "this system, each *principal*, (which may be a machine, or a person, or an " @@ -93263,7 +95187,7 @@ msgid "" "other part, and **only** with the other part." msgstr "" -#: ../src/Doc/library/ssl.rst:1239 +#: library/ssl.rst:1285 msgid "" "A certificate contains information about two principals. It contains the " "name of a *subject*, and the subject's public key. It also contains a " @@ -93277,7 +95201,7 @@ msgid "" "as two fields, called \"notBefore\" and \"notAfter\"." msgstr "" -#: ../src/Doc/library/ssl.rst:1249 +#: library/ssl.rst:1295 msgid "" "In the Python use of certificates, a client or server can use a certificate " "to prove who they are. The other side of a network connection can also be " @@ -93290,7 +95214,7 @@ msgid "" "take place." msgstr "" -#: ../src/Doc/library/ssl.rst:1259 +#: library/ssl.rst:1305 msgid "" "Python uses files to contain certificates. They should be formatted as \"PEM" "\" (see :rfc:`1422`), which is a base-64 encoded form wrapped with a header " @@ -93298,11 +95222,11 @@ msgid "" msgstr "" # a1a46ac79e414a358644d2f4cc060668 -#: ../src/Doc/library/ssl.rst:1268 +#: library/ssl.rst:1314 msgid "Certificate chains" msgstr "" -#: ../src/Doc/library/ssl.rst:1270 +#: library/ssl.rst:1316 msgid "" "The Python files which contain certificates can contain a sequence of " "certificates, sometimes called a *certificate chain*. This chain should " @@ -93319,12 +95243,12 @@ msgid "" msgstr "" # c0ad7fbf016b424bb3e385f266023ed6 -#: ../src/Doc/library/ssl.rst:1294 +#: library/ssl.rst:1340 msgid "CA certificates" msgstr "" # 47b650e5be1d463489e83e80b0841945 -#: ../src/Doc/library/ssl.rst:1296 +#: library/ssl.rst:1342 msgid "" "If you are going to require validation of the other side of the connection's " "certificate, you need to provide a \"CA certs\" file, filled with the " @@ -93337,12 +95261,12 @@ msgid "" msgstr "" # a7dcfcc2fb774780a98a669b6b8840be -#: ../src/Doc/library/ssl.rst:1305 +#: library/ssl.rst:1351 msgid "Combined key and certificate" msgstr "" # 30325b464346444b9aa860fa22a71564 -#: ../src/Doc/library/ssl.rst:1307 +#: library/ssl.rst:1353 msgid "" "Often the private key is stored in the same file as the certificate; in this " "case, only the ``certfile`` parameter to :meth:`SSLContext.load_cert_chain` " @@ -93352,11 +95276,11 @@ msgid "" msgstr "" # ec16d00f3c444e8fa83d3bb9da84736b -#: ../src/Doc/library/ssl.rst:1321 +#: library/ssl.rst:1367 msgid "Self-signed certificates" msgstr "" -#: ../src/Doc/library/ssl.rst:1323 +#: library/ssl.rst:1369 msgid "" "If you are going to create a server that provides SSL-encrypted connection " "services, you will need to acquire a certificate for that service. There " @@ -93366,43 +95290,43 @@ msgid "" "package, using something like the following::" msgstr "" -#: ../src/Doc/library/ssl.rst:1352 +#: library/ssl.rst:1398 msgid "" "The disadvantage of a self-signed certificate is that it is its own root " "certificate, and no one else will have it in their cache of known (and " "trusted) root certificates." msgstr "" -#: ../src/Doc/library/ssl.rst:1361 +#: library/ssl.rst:1407 msgid "Testing for SSL support" msgstr "" -#: ../src/Doc/library/ssl.rst:1363 +#: library/ssl.rst:1409 msgid "" "To test for the presence of SSL support in a Python installation, user code " "should use the following idiom::" msgstr "" -#: ../src/Doc/library/ssl.rst:1374 +#: library/ssl.rst:1420 msgid "Client-side operation" msgstr "" # 1958610653104be78085c8a49faa3504 -#: ../src/Doc/library/ssl.rst:1376 +#: library/ssl.rst:1422 msgid "" "This example creates a SSL context with the recommended security settings " "for client sockets, including automatic certificate verification::" msgstr "" # 6d54354ec7c94cf1884e69ab7debf846 -#: ../src/Doc/library/ssl.rst:1381 +#: library/ssl.rst:1427 msgid "" "If you prefer to tune security settings yourself, you might create a context " "from scratch (but beware that you might not get the settings right)::" msgstr "" # bc7d94b6814144afb6792de60248e8c2 -#: ../src/Doc/library/ssl.rst:1390 +#: library/ssl.rst:1436 msgid "" "(this snippet assumes your operating system places a bundle of all CA " "certificates in ``/etc/ssl/certs/ca-bundle.crt``; if not, you'll get an " @@ -93410,7 +95334,7 @@ msgid "" msgstr "" # 2b56db1a9aef416e997bd901c72c8c03 -#: ../src/Doc/library/ssl.rst:1394 +#: library/ssl.rst:1440 msgid "" "When you use the context to connect to a server, :const:`CERT_REQUIRED` " "validates the server certificate: it ensures that the server certificate was " @@ -93419,30 +95343,30 @@ msgid "" msgstr "" # c6d0b4a6f88b4b31ae73b95ce4e7418b -#: ../src/Doc/library/ssl.rst:1403 +#: library/ssl.rst:1449 msgid "You may then fetch the certificate::" msgstr "" # 032d9746a90e41c98bfc4d0a9d7beedb -#: ../src/Doc/library/ssl.rst:1407 +#: library/ssl.rst:1453 msgid "" "Visual inspection shows that the certificate does identify the desired " "service (that is, the HTTPS host ``www.python.org``)::" msgstr "" # 5693e9c2fafb461990427dfed0127055 -#: ../src/Doc/library/ssl.rst:1450 +#: library/ssl.rst:1496 msgid "" "Now the SSL channel is established and the certificate verified, you can " "proceed to talk with the server::" msgstr "" -#: ../src/Doc/library/ssl.rst:1477 +#: library/ssl.rst:1523 msgid "Server-side operation" msgstr "" # c7c1e6897e69408b8c56b8aaa093a0b8 -#: ../src/Doc/library/ssl.rst:1479 +#: library/ssl.rst:1525 msgid "" "For server operation, typically you'll need to have a server certificate, " "and private key, each in a file. You'll first create a context holding the " @@ -93452,7 +95376,7 @@ msgid "" msgstr "" # bd502659242e429ba7b3712eba6d555f -#: ../src/Doc/library/ssl.rst:1494 +#: library/ssl.rst:1540 msgid "" "When a client connects, you'll call :meth:`accept` on the socket to get the " "new socket from the other end, and use the context's :meth:`SSLContext." @@ -93460,14 +95384,14 @@ msgid "" msgstr "" # 8a20b6a8669c4d7aaf1bf2516a3bc84a -#: ../src/Doc/library/ssl.rst:1507 +#: library/ssl.rst:1553 msgid "" "Then you'll read data from the ``connstream`` and do something with it till " "you are finished with the client (or the client is finished with you)::" msgstr "" # b3e21441388e405e9fb8a1671b29f862 -#: ../src/Doc/library/ssl.rst:1521 +#: library/ssl.rst:1567 msgid "" "And go back to listening for new client connections (of course, a real " "server would probably handle each client connection in a separate thread, or " @@ -93475,19 +95399,19 @@ msgid "" msgstr "" # fe61bb3a0dc948be8a4fd53251bd6368 -#: ../src/Doc/library/ssl.rst:1529 +#: library/ssl.rst:1575 msgid "Notes on non-blocking sockets" msgstr "" # 038edb296d1744758c6872809dccad37 -#: ../src/Doc/library/ssl.rst:1531 +#: library/ssl.rst:1577 msgid "" "When working with non-blocking sockets, there are several things you need to " "be aware of:" msgstr "" # 5d748e208c3f4761ad188a1cd4546d18 -#: ../src/Doc/library/ssl.rst:1534 +#: library/ssl.rst:1580 msgid "" "Calling :func:`~select.select` tells you that the OS-level socket can be " "read from (or written to), but it does not imply that there is sufficient " @@ -93498,7 +95422,7 @@ msgid "" msgstr "" # f9b4d76d9a744395add4c71be8dfc7ab -#: ../src/Doc/library/ssl.rst:1541 +#: library/ssl.rst:1587 msgid "" "Conversely, since the SSL layer has its own framing, a SSL socket may still " "have data available for reading without :func:`~select.select` being aware " @@ -93508,14 +95432,14 @@ msgid "" msgstr "" # 5b4315a08b064abf8211a29ff951e2ae -#: ../src/Doc/library/ssl.rst:1547 +#: library/ssl.rst:1593 msgid "" "(of course, similar provisions apply when using other primitives such as :" "func:`~select.poll`, or those in the :mod:`selectors` module)" msgstr "" # 3a58f51c36db459680a3a1ffdc1a88b6 -#: ../src/Doc/library/ssl.rst:1550 +#: library/ssl.rst:1596 msgid "" "The SSL handshake itself will be non-blocking: the :meth:`SSLSocket." "do_handshake` method has to be retried until it returns successfully. Here " @@ -93524,17 +95448,17 @@ msgid "" msgstr "" # ceb1ef3c81b54c13bcbab4072067915c -#: ../src/Doc/library/ssl.rst:1568 +#: library/ssl.rst:1614 msgid "Security considerations" msgstr "" # d59be264b27f4679a512ad80852c47f2 -#: ../src/Doc/library/ssl.rst:1571 +#: library/ssl.rst:1617 msgid "Best defaults" msgstr "" # 1cd7516df9274863a1f0c82c8fd4bed4 -#: ../src/Doc/library/ssl.rst:1573 +#: library/ssl.rst:1619 msgid "" "For **client use**, if you don't have any special requirements for your " "security policy, it is highly recommended that you use the :func:" @@ -93545,14 +95469,14 @@ msgid "" msgstr "" # dd68132566684d888ec5d8cee0ab34af -#: ../src/Doc/library/ssl.rst:1580 +#: library/ssl.rst:1626 msgid "" "If a client certificate is needed for the connection, it can be added with :" "meth:`SSLContext.load_cert_chain`." msgstr "" # d83284d4022b4c908f317d90e9a97202 -#: ../src/Doc/library/ssl.rst:1583 +#: library/ssl.rst:1629 msgid "" "By contrast, if you create the SSL context by calling the :class:" "`SSLContext` constructor yourself, it will not have certificate validation " @@ -93561,17 +95485,17 @@ msgid "" msgstr "" # 72dd8ee492ac428dbfccdb9fdc1162d3 -#: ../src/Doc/library/ssl.rst:1589 +#: library/ssl.rst:1635 msgid "Manual settings" msgstr "" # 26dd12603f7142d1a8f797e4b631c13f -#: ../src/Doc/library/ssl.rst:1592 +#: library/ssl.rst:1638 msgid "Verifying certificates" msgstr "" # 9a4972edfc5647c39781b3fb852c874a -#: ../src/Doc/library/ssl.rst:1594 +#: library/ssl.rst:1640 msgid "" "When calling the :class:`SSLContext` constructor directly, :const:" "`CERT_NONE` is the default. Since it does not authenticate the other peer, " @@ -93587,7 +95511,7 @@ msgid "" msgstr "" # ada2fd1dbfee499c8b38ebdf0dc4da10 -#: ../src/Doc/library/ssl.rst:1607 +#: library/ssl.rst:1653 msgid "" "In server mode, if you want to authenticate your clients using the SSL layer " "(rather than using a higher-level authentication mechanism), you'll also " @@ -93596,7 +95520,7 @@ msgid "" msgstr "" # 54c018196e30476ab9fb74d1b44b0a6d -#: ../src/Doc/library/ssl.rst:1613 +#: library/ssl.rst:1659 msgid "" "In client mode, :const:`CERT_OPTIONAL` and :const:`CERT_REQUIRED` are " "equivalent unless anonymous ciphers are enabled (they are disabled by " @@ -93604,12 +95528,12 @@ msgid "" msgstr "" # 755c623ed1aa4e8995c281de01329434 -#: ../src/Doc/library/ssl.rst:1618 +#: library/ssl.rst:1664 msgid "Protocol versions" msgstr "" # f7a3ad444c184194a7e241d6bd159b34 -#: ../src/Doc/library/ssl.rst:1620 +#: library/ssl.rst:1666 msgid "" "SSL versions 2 and 3 are considered insecure and are therefore dangerous to " "use. If you want maximum compatibility between clients and servers, it is " @@ -93619,19 +95543,19 @@ msgid "" msgstr "" # 1e0d9286625f4b2bb3601c42159809b1 -#: ../src/Doc/library/ssl.rst:1630 +#: library/ssl.rst:1676 msgid "" "The SSL context created above will only allow TLSv1 and later (if supported " "by your system) connections." msgstr "" # ceb1ef3c81b54c13bcbab4072067915c -#: ../src/Doc/library/ssl.rst:1634 +#: library/ssl.rst:1680 msgid "Cipher selection" msgstr "" # 0a9ed7e0849c41b99c38eab0bea99fc9 -#: ../src/Doc/library/ssl.rst:1636 +#: library/ssl.rst:1682 msgid "" "If you have advanced security requirements, fine-tuning of the ciphers " "enabled when negotiating a SSL session is possible through the :meth:" @@ -93644,12 +95568,12 @@ msgid "" msgstr "" # 2462aad27756413e9dae4cac4f8a9525 -#: ../src/Doc/library/ssl.rst:1646 +#: library/ssl.rst:1692 msgid "Multi-processing" msgstr "" # e6ce5871f9784ad8947cddd78a2765e7 -#: ../src/Doc/library/ssl.rst:1648 +#: library/ssl.rst:1694 msgid "" "If using this module as part of a multi-processed application (using, for " "example the :mod:`multiprocessing` or :mod:`concurrent.futures` modules), be " @@ -93660,120 +95584,99 @@ msgid "" "`~ssl.RAND_pseudo_bytes` is sufficient." msgstr "" -# 2ded67770e3b4185bc14a92efe8471f0 -#: ../src/Doc/library/ssl.rst:1659 -msgid "Class :class:`socket.socket`" +#: library/ssl.rst:1706 +msgid "Class socket.socket" msgstr "" -#: ../src/Doc/library/ssl.rst:1660 +#: library/ssl.rst:1706 msgid "Documentation of underlying :mod:`socket` class" msgstr "" -# 414a6a7f42454f6b95326ec0992a9c62 -#: ../src/Doc/library/ssl.rst:1662 -msgid "" -"`SSL/TLS Strong Encryption: An Introduction <http://httpd.apache.org/docs/" -"trunk/en/ssl/ssl_intro.html>`_" +#: library/ssl.rst:1709 +msgid "SSL/TLS Strong Encryption: An Introduction" msgstr "" # b795af2355db4f51b988a34e1cc30a3f -#: ../src/Doc/library/ssl.rst:1663 +#: library/ssl.rst:1709 msgid "Intro from the Apache webserver documentation" msgstr "" -# 61be27b6623848c2aeb04f29dd43acc6 -#: ../src/Doc/library/ssl.rst:1665 +#: library/ssl.rst:1712 msgid "" -"`RFC 1422: Privacy Enhancement for Internet Electronic Mail: Part II: " -"Certificate-Based Key Management <http://www.ietf.org/rfc/rfc1422>`_" +"RFC 1422: Privacy Enhancement for Internet Electronic Mail: Part II: " +"Certificate-Based Key Management" msgstr "" -#: ../src/Doc/library/ssl.rst:1666 +#: library/ssl.rst:1712 msgid "Steve Kent" msgstr "" -# df6260180778434c8cfb627196d598bd -#: ../src/Doc/library/ssl.rst:1668 -msgid "" -"`RFC 1750: Randomness Recommendations for Security <http://www.ietf.org/rfc/" -"rfc1750>`_" +#: library/ssl.rst:1715 +msgid "RFC 1750: Randomness Recommendations for Security" msgstr "" -#: ../src/Doc/library/ssl.rst:1669 +#: library/ssl.rst:1715 msgid "D. Eastlake et. al." msgstr "" -# ddafd74039d74d9fb83de31fad20187f -#: ../src/Doc/library/ssl.rst:1671 +#: library/ssl.rst:1718 msgid "" -"`RFC 3280: Internet X.509 Public Key Infrastructure Certificate and CRL " -"Profile <http://www.ietf.org/rfc/rfc3280>`_" +"RFC 3280: Internet X.509 Public Key Infrastructure Certificate and CRL " +"Profile" msgstr "" -#: ../src/Doc/library/ssl.rst:1672 +#: library/ssl.rst:1718 msgid "Housley et. al." msgstr "" -# 0b622bd0e2264a8da37a8d7994214d63 -#: ../src/Doc/library/ssl.rst:1674 -msgid "" -"`RFC 4366: Transport Layer Security (TLS) Extensions <http://www.ietf.org/" -"rfc/rfc4366>`_" +#: library/ssl.rst:1721 +msgid "RFC 4366: Transport Layer Security (TLS) Extensions" msgstr "" # 31429c43667d475484dc0aafa074cf20 -#: ../src/Doc/library/ssl.rst:1675 +#: library/ssl.rst:1721 msgid "Blake-Wilson et. al." msgstr "" -# 9d14be3d043941a6b6427ecb7a2b4430 -#: ../src/Doc/library/ssl.rst:1677 -msgid "" -"`RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2 <http://" -"tools.ietf.org/html/rfc5246>`_" +#: library/ssl.rst:1724 +msgid "RFC 5246: The Transport Layer Security (TLS) Protocol Version 1.2" msgstr "" # 31429c43667d475484dc0aafa074cf20 -#: ../src/Doc/library/ssl.rst:1678 +#: library/ssl.rst:1724 msgid "T. Dierks et. al." msgstr "" -# 0b622bd0e2264a8da37a8d7994214d63 -#: ../src/Doc/library/ssl.rst:1680 -msgid "" -"`RFC 6066: Transport Layer Security (TLS) Extensions <http://tools.ietf.org/" -"html/rfc6066>`_" +#: library/ssl.rst:1727 +msgid "RFC 6066: Transport Layer Security (TLS) Extensions" msgstr "" # 31429c43667d475484dc0aafa074cf20 -#: ../src/Doc/library/ssl.rst:1681 +#: library/ssl.rst:1727 msgid "D. Eastlake" msgstr "" -# 28b507b581514aa490420efa062fb4f7 -#: ../src/Doc/library/ssl.rst:1682 -msgid "" -"`IANA TLS: Transport Layer Security (TLS) Parameters <http://www.iana.org/" -"assignments/tls-parameters/tls-parameters.xml>`_" +#: library/ssl.rst:1729 +msgid "IANA TLS: Transport Layer Security (TLS) Parameters" msgstr "" # 3db736f2574b4be89fae612044f87a3c -#: ../src/Doc/library/ssl.rst:1684 +#: library/ssl.rst:1730 msgid "IANA" msgstr "" # 000f0c8bef574044823f55e73a285e00 -#: ../src/Doc/library/stat.rst:2 +#: library/stat.rst:2 msgid ":mod:`stat` --- Interpreting :func:`~os.stat` results" msgstr "" # 89751dbe8d31430cb3ee478cc474f344 -#: ../src/Doc/library/stat.rst:8 +#: library/stat.rst:8 msgid "**Source code:** :source:`Lib/stat.py`" msgstr "" # 73b97558fc5c4bc78fc345875043254e -#: ../src/Doc/library/stat.rst:12 +#: library/stat.rst:12 msgid "" "The :mod:`stat` module defines constants and functions for interpreting the " "results of :func:`os.stat`, :func:`os.fstat` and :func:`os.lstat` (if they " @@ -93781,61 +95684,61 @@ msgid "" "c:func:`lstat` calls, consult the documentation for your system." msgstr "" -#: ../src/Doc/library/stat.rst:17 +#: library/stat.rst:17 msgid "" "The :mod:`stat` module defines the following functions to test for specific " "file types:" msgstr "" -#: ../src/Doc/library/stat.rst:23 +#: library/stat.rst:23 msgid "Return non-zero if the mode is from a directory." msgstr "" -#: ../src/Doc/library/stat.rst:28 +#: library/stat.rst:28 msgid "Return non-zero if the mode is from a character special device file." msgstr "" -#: ../src/Doc/library/stat.rst:33 +#: library/stat.rst:33 msgid "Return non-zero if the mode is from a block special device file." msgstr "" -#: ../src/Doc/library/stat.rst:38 +#: library/stat.rst:38 msgid "Return non-zero if the mode is from a regular file." msgstr "" -#: ../src/Doc/library/stat.rst:43 +#: library/stat.rst:43 msgid "Return non-zero if the mode is from a FIFO (named pipe)." msgstr "" -#: ../src/Doc/library/stat.rst:48 +#: library/stat.rst:48 msgid "Return non-zero if the mode is from a symbolic link." msgstr "" -#: ../src/Doc/library/stat.rst:53 +#: library/stat.rst:53 msgid "Return non-zero if the mode is from a socket." msgstr "" -#: ../src/Doc/library/stat.rst:55 +#: library/stat.rst:55 msgid "" "Two additional functions are defined for more general manipulation of the " "file's mode:" msgstr "" -#: ../src/Doc/library/stat.rst:61 +#: library/stat.rst:61 msgid "" "Return the portion of the file's mode that can be set by :func:`os.chmod`\\ " "---that is, the file's permission bits, plus the sticky bit, set-group-id, " "and set-user-id bits (on systems that support them)." msgstr "" -#: ../src/Doc/library/stat.rst:68 +#: library/stat.rst:68 msgid "" "Return the portion of the file's mode that describes the file type (used by " "the :func:`S_IS\\*` functions above)." msgstr "" # 4dd80925677e4b5699c71c020ee9ee63 -#: ../src/Doc/library/stat.rst:71 +#: library/stat.rst:71 msgid "" "Normally, you would use the :func:`os.path.is\\*` functions for testing the " "type of a file; the functions here are useful when you are doing multiple " @@ -93845,57 +95748,57 @@ msgid "" "tests for block and character devices." msgstr "" -#: ../src/Doc/library/stat.rst:106 +#: library/stat.rst:106 msgid "" "All the variables below are simply symbolic indexes into the 10-tuple " "returned by :func:`os.stat`, :func:`os.fstat` or :func:`os.lstat`." msgstr "" -#: ../src/Doc/library/stat.rst:112 +#: library/stat.rst:112 msgid "Inode protection mode." msgstr "" -#: ../src/Doc/library/stat.rst:117 +#: library/stat.rst:117 msgid "Inode number." msgstr "" -#: ../src/Doc/library/stat.rst:122 +#: library/stat.rst:122 msgid "Device inode resides on." msgstr "" -#: ../src/Doc/library/stat.rst:127 +#: library/stat.rst:127 msgid "Number of links to the inode." msgstr "" -#: ../src/Doc/library/stat.rst:132 +#: library/stat.rst:132 msgid "User id of the owner." msgstr "" -#: ../src/Doc/library/stat.rst:137 +#: library/stat.rst:137 msgid "Group id of the owner." msgstr "" -#: ../src/Doc/library/stat.rst:142 +#: library/stat.rst:142 msgid "" "Size in bytes of a plain file; amount of data waiting on some special files." msgstr "" -#: ../src/Doc/library/stat.rst:147 +#: library/stat.rst:147 msgid "Time of last access." msgstr "" -#: ../src/Doc/library/stat.rst:152 ../src/Doc/library/tarfile.rst:541 +#: library/stat.rst:152 library/tarfile.rst:541 msgid "Time of last modification." msgstr "" -#: ../src/Doc/library/stat.rst:157 +#: library/stat.rst:157 msgid "" "The \"ctime\" as reported by the operating system. On some systems (like " "Unix) is the time of the last metadata change, and, on others (like " "Windows), is the creation time (see platform documentation for details)." msgstr "" -#: ../src/Doc/library/stat.rst:161 +#: library/stat.rst:161 msgid "" "The interpretation of \"file size\" changes according to the file type. For " "plain files this is the size of the file in bytes. For FIFOs and sockets " @@ -93907,56 +95810,56 @@ msgid "" "varies more, depending on the implementation of the underlying system call." msgstr "" -#: ../src/Doc/library/stat.rst:170 +#: library/stat.rst:170 msgid "The variables below define the flags used in the :data:`ST_MODE` field." msgstr "" -#: ../src/Doc/library/stat.rst:172 +#: library/stat.rst:172 msgid "" "Use of the functions above is more portable than use of the first set of " "flags:" msgstr "" -#: ../src/Doc/library/stat.rst:176 +#: library/stat.rst:176 msgid "Socket." msgstr "" -#: ../src/Doc/library/stat.rst:180 +#: library/stat.rst:180 msgid "Symbolic link." msgstr "" -#: ../src/Doc/library/stat.rst:184 +#: library/stat.rst:184 msgid "Regular file." msgstr "" -#: ../src/Doc/library/stat.rst:188 +#: library/stat.rst:188 msgid "Block device." msgstr "" -#: ../src/Doc/library/stat.rst:192 +#: library/stat.rst:192 #, fuzzy msgid "Directory." msgstr "Répertoire" -#: ../src/Doc/library/stat.rst:196 +#: library/stat.rst:196 msgid "Character device." msgstr "" -#: ../src/Doc/library/stat.rst:200 +#: library/stat.rst:200 msgid "FIFO." msgstr "" -#: ../src/Doc/library/stat.rst:202 +#: library/stat.rst:202 msgid "" "The following flags can also be used in the *mode* argument of :func:`os." "chmod`:" msgstr "" -#: ../src/Doc/library/stat.rst:206 +#: library/stat.rst:206 msgid "Set UID bit." msgstr "" -#: ../src/Doc/library/stat.rst:210 +#: library/stat.rst:210 msgid "" "Set-group-ID bit. This bit has several special uses. For a directory it " "indicates that BSD semantics is to be used for that directory: files created " @@ -93967,149 +95870,153 @@ msgid "" "mandatory file/record locking (see also :data:`S_ENFMT`)." msgstr "" -#: ../src/Doc/library/stat.rst:221 +#: library/stat.rst:221 msgid "" "Sticky bit. When this bit is set on a directory it means that a file in " "that directory can be renamed or deleted only by the owner of the file, by " "the owner of the directory, or by a privileged process." msgstr "" -#: ../src/Doc/library/stat.rst:227 +#: library/stat.rst:227 msgid "Mask for file owner permissions." msgstr "" -#: ../src/Doc/library/stat.rst:231 +#: library/stat.rst:231 msgid "Owner has read permission." msgstr "" -#: ../src/Doc/library/stat.rst:235 +#: library/stat.rst:235 msgid "Owner has write permission." msgstr "" -#: ../src/Doc/library/stat.rst:239 +#: library/stat.rst:239 msgid "Owner has execute permission." msgstr "" -#: ../src/Doc/library/stat.rst:243 +#: library/stat.rst:243 msgid "Mask for group permissions." msgstr "" -#: ../src/Doc/library/stat.rst:247 +#: library/stat.rst:247 msgid "Group has read permission." msgstr "" -#: ../src/Doc/library/stat.rst:251 +#: library/stat.rst:251 msgid "Group has write permission." msgstr "" -#: ../src/Doc/library/stat.rst:255 +#: library/stat.rst:255 msgid "Group has execute permission." msgstr "" -#: ../src/Doc/library/stat.rst:259 +#: library/stat.rst:259 msgid "Mask for permissions for others (not in group)." msgstr "" -#: ../src/Doc/library/stat.rst:263 +#: library/stat.rst:263 msgid "Others have read permission." msgstr "" -#: ../src/Doc/library/stat.rst:267 +#: library/stat.rst:267 msgid "Others have write permission." msgstr "" -#: ../src/Doc/library/stat.rst:271 +#: library/stat.rst:271 msgid "Others have execute permission." msgstr "" -#: ../src/Doc/library/stat.rst:275 +#: library/stat.rst:275 msgid "" "System V file locking enforcement. This flag is shared with :data:" "`S_ISGID`: file/record locking is enforced on files that do not have the " "group execution bit (:data:`S_IXGRP`) set." msgstr "" -#: ../src/Doc/library/stat.rst:281 +#: library/stat.rst:281 msgid "Unix V7 synonym for :data:`S_IRUSR`." msgstr "" -#: ../src/Doc/library/stat.rst:285 +#: library/stat.rst:285 msgid "Unix V7 synonym for :data:`S_IWUSR`." msgstr "" -#: ../src/Doc/library/stat.rst:289 +#: library/stat.rst:289 msgid "Unix V7 synonym for :data:`S_IXUSR`." msgstr "" # f3901ef899cd499b9f26ee64c4d3cdaf -#: ../src/Doc/library/stat.rst:291 +#: library/stat.rst:291 msgid "" "The following flags can be used in the *flags* argument of :func:`os." "chflags`:" msgstr "" # 087102c9c34d40c48806a183272de84c -#: ../src/Doc/library/stat.rst:295 +#: library/stat.rst:295 msgid "Do not dump the file." msgstr "" # e6a02742cbb6438287b88714f3e82433 # b258a508e9a7466ea3f0729a4e848bdd -#: ../src/Doc/library/stat.rst:299 ../src/Doc/library/stat.rst:327 +#: library/stat.rst:299 library/stat.rst:327 msgid "The file may not be changed." msgstr "" # 669f0292a1974fdfa212268ee5242db2 # ccdbc72ae5fc4a14a1f505e94eae7097 -#: ../src/Doc/library/stat.rst:303 ../src/Doc/library/stat.rst:331 +#: library/stat.rst:303 library/stat.rst:331 msgid "The file may only be appended to." msgstr "" # fbc1e93419d74c238ac8ee826449b06a -#: ../src/Doc/library/stat.rst:307 +#: library/stat.rst:307 msgid "The directory is opaque when viewed through a union stack." msgstr "" # 2e6b802e158e4209a1b1aae41e25ee1b # fb720393301a47e7a70c41c5f6149f63 -#: ../src/Doc/library/stat.rst:311 ../src/Doc/library/stat.rst:335 +#: library/stat.rst:311 library/stat.rst:335 msgid "The file may not be renamed or deleted." msgstr "" # 190e2a4dcce745d4aa3d782e252907ac -#: ../src/Doc/library/stat.rst:315 +#: library/stat.rst:315 msgid "The file is stored compressed (Mac OS X 10.6+)." msgstr "" # 3a47b931d32346de84a14d83d7380acb -#: ../src/Doc/library/stat.rst:319 +#: library/stat.rst:319 msgid "The file should not be displayed in a GUI (Mac OS X 10.5+)." msgstr "" # be611a62f547439bbf72c1dd5381e114 -#: ../src/Doc/library/stat.rst:323 +#: library/stat.rst:323 msgid "The file may be archived." msgstr "" # da54542e7b5541d582f66e8f61b1831f -#: ../src/Doc/library/stat.rst:339 +#: library/stat.rst:339 msgid "The file is a snapshot file." msgstr "" # 31dd0a2c22f2487187e323f42ed96b9e -#: ../src/Doc/library/stat.rst:341 +#: library/stat.rst:341 msgid "" "See the \\*BSD or Mac OS systems man page :manpage:`chflags(2)` for more " "information." msgstr "" # 7dd6b9e702f4471b822258db13a247ed -#: ../src/Doc/library/statvfs.rst:2 +#: library/statvfs.rst:2 msgid ":mod:`statvfs` --- Constants used with :func:`os.statvfs`" msgstr "" +#: library/statvfs.rst:8 +msgid "The :mod:`statvfs` module has been removed in Python 3." +msgstr "" + # 9a830f91edcd4906a0a4030b64166f92 -#: ../src/Doc/library/statvfs.rst:15 +#: library/statvfs.rst:15 msgid "" "The :mod:`statvfs` module defines constants so interpreting the result if :" "func:`os.statvfs`, which returns a tuple, can be made without remembering " @@ -94119,67 +96026,67 @@ msgid "" msgstr "" # 6814c9e2cab441519592fdec49b14218 -#: ../src/Doc/library/statvfs.rst:24 +#: library/statvfs.rst:24 msgid "Preferred file system block size." msgstr "" # 3bb108f8ad97423f870dd9acdd9f7670 -#: ../src/Doc/library/statvfs.rst:29 +#: library/statvfs.rst:29 msgid "Fundamental file system block size." msgstr "" # 73b98e88e0bd428090870633b889f6e7 -#: ../src/Doc/library/statvfs.rst:34 +#: library/statvfs.rst:34 msgid "Total number of blocks in the filesystem." msgstr "" # 5e73730a4886428ba575acfc988748a9 -#: ../src/Doc/library/statvfs.rst:39 +#: library/statvfs.rst:39 msgid "Total number of free blocks." msgstr "" # b43e5cf186114ed78cc8431dc873b288 -#: ../src/Doc/library/statvfs.rst:44 +#: library/statvfs.rst:44 msgid "Free blocks available to non-super user." msgstr "" # 9f897a5ffb4a45dfaf6a092378307703 -#: ../src/Doc/library/statvfs.rst:49 +#: library/statvfs.rst:49 msgid "Total number of file nodes." msgstr "" # fffb08c23ad747859636b183f1db1ccb -#: ../src/Doc/library/statvfs.rst:54 +#: library/statvfs.rst:54 msgid "Total number of free file nodes." msgstr "" # 22aa50de645a4eada00c96c3f804f4e0 -#: ../src/Doc/library/statvfs.rst:59 +#: library/statvfs.rst:59 msgid "Free nodes available to non-super user." msgstr "" # 4d0bfed066d345e98417e9d9061f8d35 -#: ../src/Doc/library/statvfs.rst:64 +#: library/statvfs.rst:64 msgid "Flags. System dependent: see :c:func:`statvfs` man page." msgstr "" # fe5f9c9432964c4bb66e82fe966fc334 -#: ../src/Doc/library/statvfs.rst:69 +#: library/statvfs.rst:69 msgid "Maximum file name length." msgstr "" -#: ../src/Doc/library/stdtypes.rst:8 +#: library/stdtypes.rst:8 msgid "Built-in Types" msgstr "" -#: ../src/Doc/library/stdtypes.rst:10 +#: library/stdtypes.rst:10 msgid "" "The following sections describe the standard types that are built into the " "interpreter." msgstr "" # 69905a41db2f4fb1ba09ff09234e463d -#: ../src/Doc/library/stdtypes.rst:15 +#: library/stdtypes.rst:15 msgid "" "Historically (until release 2.2), Python's built-in types have differed from " "user-defined types because it was not possible to use the built-in types as " @@ -94187,14 +96094,14 @@ msgid "" msgstr "" # 1f049089150f49178aaeb29a0d7103bd -#: ../src/Doc/library/stdtypes.rst:22 +#: library/stdtypes.rst:22 msgid "" "The principal built-in types are numerics, sequences, mappings, files, " "classes, instances and exceptions." msgstr "" # 951d05061d704d45b8b93159db97b890 -#: ../src/Doc/library/stdtypes.rst:27 +#: library/stdtypes.rst:27 msgid "" "Some operations are supported by several object types; in particular, " "practically all objects can be compared, tested for truth value, and " @@ -94203,49 +96110,49 @@ msgid "" "used when an object is written by the :func:`print` function." msgstr "" -#: ../src/Doc/library/stdtypes.rst:37 +#: library/stdtypes.rst:37 msgid "Truth Value Testing" msgstr "" -#: ../src/Doc/library/stdtypes.rst:46 +#: library/stdtypes.rst:46 msgid "" "Any object can be tested for truth value, for use in an :keyword:`if` or :" "keyword:`while` condition or as operand of the Boolean operations below. The " "following values are considered false:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:56 +#: library/stdtypes.rst:56 msgid "``False``" msgstr "" # f0702d5aa6c043a5af63ffa91fcab5ad -#: ../src/Doc/library/stdtypes.rst:58 +#: library/stdtypes.rst:58 msgid "zero of any numeric type, for example, ``0``, ``0L``, ``0.0``, ``0j``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:60 +#: library/stdtypes.rst:60 msgid "any empty sequence, for example, ``''``, ``()``, ``[]``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:62 +#: library/stdtypes.rst:62 msgid "any empty mapping, for example, ``{}``." msgstr "" # 5eadb7d8a6f74230b3e081a4d2ad2e7d -#: ../src/Doc/library/stdtypes.rst:64 +#: library/stdtypes.rst:64 msgid "" "instances of user-defined classes, if the class defines a :meth:" "`__nonzero__` or :meth:`__len__` method, when that method returns the " "integer zero or :class:`bool` value ``False``. [1]_" msgstr "" -#: ../src/Doc/library/stdtypes.rst:70 +#: library/stdtypes.rst:70 msgid "" "All other values are considered true --- so objects of many types are always " "true." msgstr "" -#: ../src/Doc/library/stdtypes.rst:79 +#: library/stdtypes.rst:79 msgid "" "Operations and built-in functions that have a Boolean result always return " "``0`` or ``False`` for false and ``1`` or ``True`` for true, unless " @@ -94253,62 +96160,62 @@ msgid "" "``and`` always return one of their operands.)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:88 +#: library/stdtypes.rst:88 msgid "Boolean Operations --- :keyword:`and`, :keyword:`or`, :keyword:`not`" msgstr "" -#: ../src/Doc/library/stdtypes.rst:92 +#: library/stdtypes.rst:92 msgid "These are the Boolean operations, ordered by ascending priority:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:97 +#: library/stdtypes.rst:97 msgid "``x or y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:97 +#: library/stdtypes.rst:97 msgid "if *x* is false, then *y*, else *x*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:100 +#: library/stdtypes.rst:100 msgid "``x and y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:100 +#: library/stdtypes.rst:100 msgid "if *x* is false, then *x*, else *y*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:103 +#: library/stdtypes.rst:103 msgid "``not x``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:103 +#: library/stdtypes.rst:103 msgid "if *x* is false, then ``True``, else ``False``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:115 +#: library/stdtypes.rst:115 msgid "" "This is a short-circuit operator, so it only evaluates the second argument " "if the first one is :const:`False`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:119 +#: library/stdtypes.rst:119 msgid "" "This is a short-circuit operator, so it only evaluates the second argument " "if the first one is :const:`True`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:123 +#: library/stdtypes.rst:123 msgid "" "``not`` has a lower priority than non-Boolean operators, so ``not a == b`` " "is interpreted as ``not (a == b)``, and ``a == not b`` is a syntax error." msgstr "" -#: ../src/Doc/library/stdtypes.rst:130 +#: library/stdtypes.rst:130 msgid "Comparisons" msgstr "" # cb6ad7ffcdc74779ae470a1086a40c99 -#: ../src/Doc/library/stdtypes.rst:144 +#: library/stdtypes.rst:144 msgid "" "Comparison operations are supported by all objects. They all have the same " "priority (which is higher than that of the Boolean operations). Comparisons " @@ -94317,83 +96224,83 @@ msgid "" "*z* is not evaluated at all when ``x < y`` is found to be false)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:150 +#: library/stdtypes.rst:150 msgid "This table summarizes the comparison operations:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:155 ../src/Doc/library/struct.rst:110 +#: library/stdtypes.rst:155 library/struct.rst:110 msgid "``<``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:155 +#: library/stdtypes.rst:155 msgid "strictly less than" msgstr "" -#: ../src/Doc/library/stdtypes.rst:157 +#: library/stdtypes.rst:157 msgid "``<=``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:157 +#: library/stdtypes.rst:157 msgid "less than or equal" msgstr "" -#: ../src/Doc/library/stdtypes.rst:159 ../src/Doc/library/struct.rst:112 +#: library/stdtypes.rst:159 library/struct.rst:112 msgid "``>``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:159 +#: library/stdtypes.rst:159 msgid "strictly greater than" msgstr "" -#: ../src/Doc/library/stdtypes.rst:161 +#: library/stdtypes.rst:161 msgid "``>=``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:161 +#: library/stdtypes.rst:161 msgid "greater than or equal" msgstr "" -#: ../src/Doc/library/stdtypes.rst:163 +#: library/stdtypes.rst:163 msgid "``==``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:163 +#: library/stdtypes.rst:163 msgid "equal" msgstr "" -#: ../src/Doc/library/stdtypes.rst:165 +#: library/stdtypes.rst:165 msgid "``!=``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:165 +#: library/stdtypes.rst:165 msgid "not equal" msgstr "" -#: ../src/Doc/library/stdtypes.rst:167 +#: library/stdtypes.rst:167 msgid "``is``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:167 +#: library/stdtypes.rst:167 msgid "object identity" msgstr "" -#: ../src/Doc/library/stdtypes.rst:169 +#: library/stdtypes.rst:169 msgid "``is not``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:169 +#: library/stdtypes.rst:169 msgid "negated object identity" msgstr "" # dff337e14bcd467499c6404a4601030a -#: ../src/Doc/library/stdtypes.rst:175 +#: library/stdtypes.rst:175 msgid "" "``!=`` can also be written ``<>``, but this is an obsolete usage kept for " "backwards compatibility only. New code should always use ``!=``." msgstr "" # f1face9160bc4ee7895b8cd56d90fe90 -#: ../src/Doc/library/stdtypes.rst:183 +#: library/stdtypes.rst:183 msgid "" "Objects of different types, except different numeric types and different " "string types, never compare equal; such objects are ordered consistently but " @@ -94406,14 +96313,14 @@ msgid "" msgstr "" # a40cd91e6f634cb1ac8c070d2ff290c1 -#: ../src/Doc/library/stdtypes.rst:201 +#: library/stdtypes.rst:201 msgid "" "Non-identical instances of a class normally compare as non-equal unless the " "class defines the :meth:`__eq__` method or the :meth:`__cmp__` method." msgstr "" # cf8e617223224b8a9877b4787485efb4 -#: ../src/Doc/library/stdtypes.rst:204 +#: library/stdtypes.rst:204 msgid "" "Instances of a class cannot be ordered with respect to other instances of " "the same class, or other types of object, unless the class defines either " @@ -94422,28 +96329,28 @@ msgid "" msgstr "" # 90ab649e33524de798210f8e5932a6a6 -#: ../src/Doc/library/stdtypes.rst:211 +#: library/stdtypes.rst:211 msgid "" "Objects of different types except numbers are ordered by their type names; " "objects of the same types that don't support proper comparison are ordered " "by their address." msgstr "" -#: ../src/Doc/library/stdtypes.rst:219 +#: library/stdtypes.rst:219 msgid "" "Two more operations with the same syntactic priority, ``in`` and ``not in``, " "are supported only by sequence types (below)." msgstr "" # bad7cc6374544c13afd4d661ff8ec6a9 -#: ../src/Doc/library/stdtypes.rst:226 +#: library/stdtypes.rst:226 msgid "" "Numeric Types --- :class:`int`, :class:`float`, :class:`long`, :class:" "`complex`" msgstr "" # 61e327ff33944805acbeffb50764b975 -#: ../src/Doc/library/stdtypes.rst:237 +#: library/stdtypes.rst:237 msgid "" "There are four distinct numeric types: :dfn:`plain integers`, :dfn:`long " "integers`, :dfn:`floating point numbers`, and :dfn:`complex numbers`. In " @@ -94464,7 +96371,7 @@ msgid "" msgstr "" # 371a64ae0cb04bb8b17c03370118c3ab -#: ../src/Doc/library/stdtypes.rst:262 +#: library/stdtypes.rst:262 msgid "" "Numbers are created by numeric literals or as the result of built-in " "functions and operators. Unadorned integer literals (including binary, hex, " @@ -94479,7 +96386,7 @@ msgid "" msgstr "" # 84730c2f762e40708a0f3e4e285e079a -#: ../src/Doc/library/stdtypes.rst:287 +#: library/stdtypes.rst:287 msgid "" "Python fully supports mixed arithmetic: when a binary arithmetic operator " "has operands of different numeric types, the operand with the \"narrower\" " @@ -94491,172 +96398,171 @@ msgid "" msgstr "" # 51803d66fd4941b598843624bddcbf15 -#: ../src/Doc/library/stdtypes.rst:295 +#: library/stdtypes.rst:295 msgid "" "All built-in numeric types support the following operations. See :ref:" "`power` and later sections for the operators' priorities." msgstr "" -#: ../src/Doc/library/stdtypes.rst:301 +#: library/stdtypes.rst:301 msgid "``x + y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:301 +#: library/stdtypes.rst:301 msgid "sum of *x* and *y*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:303 +#: library/stdtypes.rst:303 msgid "``x - y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:303 +#: library/stdtypes.rst:303 msgid "difference of *x* and *y*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:305 +#: library/stdtypes.rst:305 msgid "``x * y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:305 +#: library/stdtypes.rst:305 msgid "product of *x* and *y*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:307 +#: library/stdtypes.rst:307 msgid "``x / y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:307 +#: library/stdtypes.rst:307 msgid "quotient of *x* and *y*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:309 +#: library/stdtypes.rst:309 msgid "``x // y``" msgstr "" # 96f443b1a13e4af89122dc2f2a91bf08 -#: ../src/Doc/library/stdtypes.rst:309 +#: library/stdtypes.rst:309 msgid "(floored) quotient of *x* and *y*" msgstr "" # f318f4c091e04570915735364a0ca145 -#: ../src/Doc/library/stdtypes.rst:309 +#: library/stdtypes.rst:309 msgid "(4)(5)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:312 +#: library/stdtypes.rst:312 msgid "``x % y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:312 +#: library/stdtypes.rst:312 msgid "remainder of ``x / y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:314 +#: library/stdtypes.rst:314 msgid "``-x``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:314 +#: library/stdtypes.rst:314 msgid "*x* negated" msgstr "" -#: ../src/Doc/library/stdtypes.rst:316 +#: library/stdtypes.rst:316 msgid "``+x``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:316 +#: library/stdtypes.rst:316 msgid "*x* unchanged" msgstr "" -#: ../src/Doc/library/stdtypes.rst:318 +#: library/stdtypes.rst:318 msgid "``abs(x)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:318 +#: library/stdtypes.rst:318 msgid "absolute value or magnitude of *x*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:321 +#: library/stdtypes.rst:321 msgid "``int(x)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:321 +#: library/stdtypes.rst:321 msgid "*x* converted to integer" msgstr "" # 228a900d8a394f10ae790a2e3ba5edc8 -#: ../src/Doc/library/stdtypes.rst:323 +#: library/stdtypes.rst:323 msgid "``long(x)``" msgstr "" # 079c77475216476899362b0293afa93e -#: ../src/Doc/library/stdtypes.rst:323 +#: library/stdtypes.rst:323 msgid "*x* converted to long integer" msgstr "" -#: ../src/Doc/library/stdtypes.rst:325 +#: library/stdtypes.rst:325 msgid "``float(x)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:325 +#: library/stdtypes.rst:325 msgid "*x* converted to floating point" msgstr "" # bc888ce47caa4b73be8318fc1a5862a2 -#: ../src/Doc/library/stdtypes.rst:327 +#: library/stdtypes.rst:327 msgid "``complex(re,im)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:327 +#: library/stdtypes.rst:327 msgid "" "a complex number with real part *re*, imaginary part *im*. *im* defaults to " "zero." msgstr "" -#: ../src/Doc/library/stdtypes.rst:331 +#: library/stdtypes.rst:331 msgid "``c.conjugate()``" msgstr "" # 48dd9f08def541bab03a445455791b85 -#: ../src/Doc/library/stdtypes.rst:331 +#: library/stdtypes.rst:331 msgid "conjugate of the complex number *c*. (Identity on real numbers)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:334 +#: library/stdtypes.rst:334 msgid "``divmod(x, y)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:334 +#: library/stdtypes.rst:334 msgid "the pair ``(x // y, x % y)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:334 ../src/Doc/library/stdtypes.rst:744 +#: library/stdtypes.rst:334 library/stdtypes.rst:744 msgid "(3)(4)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:336 +#: library/stdtypes.rst:336 msgid "``pow(x, y)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:336 ../src/Doc/library/stdtypes.rst:338 +#: library/stdtypes.rst:336 library/stdtypes.rst:338 msgid "*x* to the power *y*" msgstr "" # d2a538d03f1a454e9f9494270f28f989 -#: ../src/Doc/library/stdtypes.rst:336 +#: library/stdtypes.rst:336 msgid "(3)(7)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:338 +#: library/stdtypes.rst:338 msgid "``x ** y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:338 ../src/Doc/library/stdtypes.rst:1450 -#: ../src/Doc/library/stdtypes.rst:1630 +#: library/stdtypes.rst:338 library/stdtypes.rst:1453 library/stdtypes.rst:1636 msgid "\\(7)" msgstr "" # f5ea5e25488e4892ace91c7ba3a1bee8 -#: ../src/Doc/library/stdtypes.rst:352 +#: library/stdtypes.rst:352 msgid "" "For (plain or long) integer division, the result is an integer. The result " "is always rounded towards minus infinity: 1/2 is 0, (-1)/2 is -1, 1/(-2) is " @@ -94665,7 +96571,7 @@ msgid "" msgstr "" # 57ed890be3f94ad6978d453deb591b68 -#: ../src/Doc/library/stdtypes.rst:365 +#: library/stdtypes.rst:365 msgid "" "Conversion from floats using :func:`int` or :func:`long` truncates toward " "zero like the related function, :func:`math.trunc`. Use the function :func:" @@ -94673,85 +96579,92 @@ msgid "" msgstr "" # 665c7c1bf0fd4dd283e2731d4a2b0ffa -#: ../src/Doc/library/stdtypes.rst:371 +#: library/stdtypes.rst:371 msgid "See :ref:`built-in-funcs` for a full description." msgstr "" +#: library/stdtypes.rst:374 +msgid "" +"The floor division operator, the modulo operator, and the :func:`divmod` " +"function are no longer defined for complex numbers. Instead, convert to a " +"floating point number using the :func:`abs` function if appropriate." +msgstr "" + # 37d0a7037dd1480990608df8b8668207 -#: ../src/Doc/library/stdtypes.rst:380 +#: library/stdtypes.rst:380 msgid "" "Also referred to as integer division. The resultant value is a whole " "integer, though the result's type is not necessarily int." msgstr "" -#: ../src/Doc/library/stdtypes.rst:384 +#: library/stdtypes.rst:384 msgid "" "float also accepts the strings \"nan\" and \"inf\" with an optional prefix " "\"+\" or \"-\" for Not a Number (NaN) and positive or negative infinity." msgstr "" -#: ../src/Doc/library/stdtypes.rst:390 +#: library/stdtypes.rst:390 msgid "" "Python defines ``pow(0, 0)`` and ``0 ** 0`` to be ``1``, as is common for " "programming languages." msgstr "" # daf53220471e4978ae15326ff72b809d -#: ../src/Doc/library/stdtypes.rst:393 +#: library/stdtypes.rst:393 msgid "" "All :class:`numbers.Real` types (:class:`int`, :class:`long`, and :class:" "`float`) also include the following operations:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:399 +#: library/stdtypes.rst:399 msgid "``math.trunc(x)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:399 +#: library/stdtypes.rst:399 msgid "*x* truncated to Integral" msgstr "" -#: ../src/Doc/library/stdtypes.rst:401 +#: library/stdtypes.rst:401 msgid "``round(x[, n])``" msgstr "" # fb25153a10b6472a99748b617e9e86d2 -#: ../src/Doc/library/stdtypes.rst:401 +#: library/stdtypes.rst:401 msgid "" "*x* rounded to n digits, rounding ties away from zero. If n is omitted, it " "defaults to 0." msgstr "" -#: ../src/Doc/library/stdtypes.rst:405 +#: library/stdtypes.rst:405 msgid "``math.floor(x)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:405 +#: library/stdtypes.rst:405 msgid "the greatest integral float <= *x*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:407 +#: library/stdtypes.rst:407 msgid "``math.ceil(x)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:407 +#: library/stdtypes.rst:407 msgid "the least integral float >= *x*" msgstr "" # 035b95a179f448e596dce4b389664c68 -#: ../src/Doc/library/stdtypes.rst:416 +#: library/stdtypes.rst:416 msgid "Bitwise Operations on Integer Types" msgstr "" # a6af92cfe4fa4590b2a011079f564187 -#: ../src/Doc/library/stdtypes.rst:428 +#: library/stdtypes.rst:428 msgid "" "Bitwise operations only make sense for integers. Negative numbers are " "treated as their 2's complement value (this assumes a sufficiently large " "number of bits that no overflow occurs during the operation)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:432 +#: library/stdtypes.rst:432 msgid "" "The priorities of the binary bitwise operations are all lower than the " "numeric operations and higher than the comparisons; the unary operation " @@ -94760,101 +96673,101 @@ msgid "" msgstr "" # 9d75f6d84b974b49b961070d5aff3574 -#: ../src/Doc/library/stdtypes.rst:436 +#: library/stdtypes.rst:436 msgid "This table lists the bitwise operations sorted in ascending priority:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:441 +#: library/stdtypes.rst:441 msgid "``x | y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:441 +#: library/stdtypes.rst:441 msgid "bitwise :dfn:`or` of *x* and *y*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:444 +#: library/stdtypes.rst:444 msgid "``x ^ y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:444 +#: library/stdtypes.rst:444 msgid "bitwise :dfn:`exclusive or` of *x* and *y*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:447 +#: library/stdtypes.rst:447 msgid "``x & y``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:447 +#: library/stdtypes.rst:447 msgid "bitwise :dfn:`and` of *x* and *y*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:450 +#: library/stdtypes.rst:450 msgid "``x << n``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:450 +#: library/stdtypes.rst:450 msgid "*x* shifted left by *n* bits" msgstr "" -#: ../src/Doc/library/stdtypes.rst:450 +#: library/stdtypes.rst:450 msgid "(1)(2)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:452 +#: library/stdtypes.rst:452 msgid "``x >> n``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:452 +#: library/stdtypes.rst:452 msgid "*x* shifted right by *n* bits" msgstr "" -#: ../src/Doc/library/stdtypes.rst:452 +#: library/stdtypes.rst:452 msgid "(1)(3)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:454 +#: library/stdtypes.rst:454 msgid "``~x``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:454 +#: library/stdtypes.rst:454 msgid "the bits of *x* inverted" msgstr "" -#: ../src/Doc/library/stdtypes.rst:460 +#: library/stdtypes.rst:460 msgid "" "Negative shift counts are illegal and cause a :exc:`ValueError` to be raised." msgstr "" # 0110cd3efb204109a7c12464ca8dab4a -#: ../src/Doc/library/stdtypes.rst:463 +#: library/stdtypes.rst:463 msgid "" "A left shift by *n* bits is equivalent to multiplication by ``pow(2, n)``. " "A long integer is returned if the result exceeds the range of plain integers." msgstr "" # 97f6fea83b5449aaa287d24b6b10273a -#: ../src/Doc/library/stdtypes.rst:467 +#: library/stdtypes.rst:467 msgid "A right shift by *n* bits is equivalent to division by ``pow(2, n)``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:471 +#: library/stdtypes.rst:471 msgid "Additional Methods on Integer Types" msgstr "" # 9906c29fe9654d2e946c1ed8bcfae40f -#: ../src/Doc/library/stdtypes.rst:473 +#: library/stdtypes.rst:473 msgid "" "The integer types implement the :class:`numbers.Integral` :term:`abstract " "base class`. In addition, they provide one more method:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:479 +#: library/stdtypes.rst:479 msgid "" "Return the number of bits necessary to represent an integer in binary, " "excluding the sign and leading zeros::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:488 +#: library/stdtypes.rst:488 msgid "" "More precisely, if ``x`` is nonzero, then ``x.bit_length()`` is the unique " "positive integer ``k`` such that ``2**(k-1) <= abs(x) < 2**k``. " @@ -94863,18 +96776,18 @@ msgid "" "bit_length()`` returns ``0``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:505 +#: library/stdtypes.rst:505 msgid "Additional Methods on Float" msgstr "" # 5601eddd2c9c4c9b9b39e402c267a838 -#: ../src/Doc/library/stdtypes.rst:507 +#: library/stdtypes.rst:507 msgid "" "The float type implements the :class:`numbers.Real` :term:`abstract base " "class`. float also has the following additional methods." msgstr "" -#: ../src/Doc/library/stdtypes.rst:512 +#: library/stdtypes.rst:512 msgid "" "Return a pair of integers whose ratio is exactly equal to the original float " "and with a positive denominator. Raises :exc:`OverflowError` on infinities " @@ -94882,13 +96795,13 @@ msgid "" msgstr "" # 3618b4fa118447a7b1e253a5592aaa65 -#: ../src/Doc/library/stdtypes.rst:521 +#: library/stdtypes.rst:521 msgid "" "Return ``True`` if the float instance is finite with integral value, and " "``False`` otherwise::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:531 +#: library/stdtypes.rst:531 msgid "" "Two methods support conversion to and from hexadecimal strings. Since " "Python's floats are stored internally as binary numbers, converting a float " @@ -94898,30 +96811,30 @@ msgid "" "numerical work." msgstr "" -#: ../src/Doc/library/stdtypes.rst:542 +#: library/stdtypes.rst:542 msgid "" "Return a representation of a floating-point number as a hexadecimal string. " "For finite floating-point numbers, this representation will always include a " "leading ``0x`` and a trailing ``p`` and exponent." msgstr "" -#: ../src/Doc/library/stdtypes.rst:552 +#: library/stdtypes.rst:552 msgid "" "Class method to return the float represented by a hexadecimal string *s*. " "The string *s* may have leading and trailing whitespace." msgstr "" -#: ../src/Doc/library/stdtypes.rst:559 +#: library/stdtypes.rst:559 msgid "" "Note that :meth:`float.hex` is an instance method, while :meth:`float." "fromhex` is a class method." msgstr "" -#: ../src/Doc/library/stdtypes.rst:562 +#: library/stdtypes.rst:562 msgid "A hexadecimal string takes the form::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:566 +#: library/stdtypes.rst:566 msgid "" "where the optional ``sign`` may by either ``+`` or ``-``, ``integer`` and " "``fraction`` are strings of hexadecimal digits, and ``exponent`` is a " @@ -94935,7 +96848,7 @@ msgid "" "by :meth:`float.fromhex`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:579 +#: library/stdtypes.rst:579 msgid "" "Note that the exponent is written in decimal rather than hexadecimal, and " "that it gives the power of 2 by which to multiply the coefficient. For " @@ -94943,17 +96856,17 @@ msgid "" "number ``(3 + 10./16 + 7./16**2) * 2.0**10``, or ``3740.0``::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:589 +#: library/stdtypes.rst:589 msgid "" "Applying the reverse conversion to ``3740.0`` gives a different hexadecimal " "string representing the same number::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:599 +#: library/stdtypes.rst:599 msgid "Iterator Types" msgstr "" -#: ../src/Doc/library/stdtypes.rst:609 +#: library/stdtypes.rst:609 msgid "" "Python supports a concept of iteration over containers. This is implemented " "using two distinct methods; these are used to allow user-defined classes to " @@ -94961,14 +96874,14 @@ msgid "" "support the iteration methods." msgstr "" -#: ../src/Doc/library/stdtypes.rst:614 +#: library/stdtypes.rst:614 msgid "" "One method needs to be defined for container objects to provide iteration " "support:" msgstr "" # e216626662da4694b12a3a0dae6ae65a -#: ../src/Doc/library/stdtypes.rst:621 +#: library/stdtypes.rst:621 msgid "" "Return an iterator object. The object is required to support the iterator " "protocol described below. If a container supports different types of " @@ -94980,14 +96893,14 @@ msgid "" "in the Python/C API." msgstr "" -#: ../src/Doc/library/stdtypes.rst:630 +#: library/stdtypes.rst:630 msgid "" "The iterator objects themselves are required to support the following two " "methods, which together form the :dfn:`iterator protocol`:" msgstr "" # 5ce3e7a44509423a81586712ff9bbbdd -#: ../src/Doc/library/stdtypes.rst:636 +#: library/stdtypes.rst:636 msgid "" "Return the iterator object itself. This is required to allow both " "containers and iterators to be used with the :keyword:`for` and :keyword:" @@ -94996,7 +96909,7 @@ msgid "" msgstr "" # 2a97f5f6450f4af8a367cd846cee901a -#: ../src/Doc/library/stdtypes.rst:644 +#: library/stdtypes.rst:644 msgid "" "Return the next item from the container. If there are no further items, " "raise the :exc:`StopIteration` exception. This method corresponds to the :c:" @@ -95004,7 +96917,7 @@ msgid "" "objects in the Python/C API." msgstr "" -#: ../src/Doc/library/stdtypes.rst:649 +#: library/stdtypes.rst:649 msgid "" "Python defines several iterator objects to support iteration over general " "and specific sequence types, dictionaries, and other more specialized " @@ -95013,7 +96926,7 @@ msgid "" msgstr "" # 8472396304ba436d94312e5cc1403969 -#: ../src/Doc/library/stdtypes.rst:654 +#: library/stdtypes.rst:654 msgid "" "The intention of the protocol is that once an iterator's :meth:`~iterator." "next` method raises :exc:`StopIteration`, it will continue to do so on " @@ -95022,12 +96935,12 @@ msgid "" "iterators are broken according to this rule.)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:664 +#: library/stdtypes.rst:664 msgid "Generator Types" msgstr "" # 8b5323b9ba4e4baeb61994e938627698 -#: ../src/Doc/library/stdtypes.rst:666 +#: library/stdtypes.rst:666 msgid "" "Python's :term:`generator`\\s provide a convenient way to implement the " "iterator protocol. If a container object's :meth:`__iter__` method is " @@ -95038,28 +96951,28 @@ msgid "" msgstr "" # 06fc842c56904ed0a85e6498d3084007 -#: ../src/Doc/library/stdtypes.rst:677 +#: library/stdtypes.rst:677 msgid "" "Sequence Types --- :class:`str`, :class:`unicode`, :class:`list`, :class:" "`tuple`, :class:`bytearray`, :class:`buffer`, :class:`xrange`" msgstr "" # 4dc60e859a9c4cbebdf081f20baacff8 -#: ../src/Doc/library/stdtypes.rst:679 +#: library/stdtypes.rst:679 msgid "" "There are seven sequence types: strings, Unicode strings, lists, tuples, " "bytearrays, buffers, and xrange objects." msgstr "" # 43e8062ebf6446248986c5aeed2710f0 -#: ../src/Doc/library/stdtypes.rst:682 +#: library/stdtypes.rst:682 msgid "" "For other containers see the built in :class:`dict` and :class:`set` " "classes, and the :mod:`collections` module." msgstr "" # b0e23635d36844adb21f9bd806c54470 -#: ../src/Doc/library/stdtypes.rst:696 +#: library/stdtypes.rst:696 msgid "" "String literals are written in single or double quotes: ``'xyzzy'``, ``" "\"frobozz\"``. See :ref:`strings` for more about string literals. Unicode " @@ -95075,13 +96988,13 @@ msgid "" msgstr "" # e173b91488cc491685e421e249203ac4 -#: ../src/Doc/library/stdtypes.rst:708 +#: library/stdtypes.rst:708 msgid "" "Bytearray objects are created with the built-in function :func:`bytearray`." msgstr "" # 0914cd349d114c7daf450cd1820235dd -#: ../src/Doc/library/stdtypes.rst:710 +#: library/stdtypes.rst:710 msgid "" "Buffer objects are not directly supported by Python syntax, but can be " "created by calling the built-in function :func:`buffer`. They don't support " @@ -95089,7 +97002,7 @@ msgid "" msgstr "" # 3481f69d12344da387c307db832f2c70 -#: ../src/Doc/library/stdtypes.rst:714 +#: library/stdtypes.rst:714 msgid "" "Objects of type xrange are similar to buffers in that there is no specific " "syntax to create them, but they are created using the :func:`xrange` " @@ -95098,7 +97011,7 @@ msgid "" msgstr "" # 297f102dfa834898b6b037cc6f48e15e -#: ../src/Doc/library/stdtypes.rst:719 +#: library/stdtypes.rst:719 msgid "" "Most sequence types support the following operations. The ``in`` and ``not " "in`` operations have the same priorities as the comparison operations. The " @@ -95108,107 +97021,107 @@ msgid "" msgstr "" # 675659cbca8448588dedd232137faea4 -#: ../src/Doc/library/stdtypes.rst:724 +#: library/stdtypes.rst:724 msgid "" "This table lists the sequence operations sorted in ascending priority. In " "the table, *s* and *t* are sequences of the same type; *n*, *i* and *j* are " "integers:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:730 +#: library/stdtypes.rst:730 msgid "``True`` if an item of *s* is equal to *x*, else ``False``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:733 +#: library/stdtypes.rst:733 msgid "``False`` if an item of *s* is equal to *x*, else ``True``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:736 +#: library/stdtypes.rst:736 msgid "``s + t``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:736 +#: library/stdtypes.rst:736 msgid "the concatenation of *s* and *t*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:739 +#: library/stdtypes.rst:739 msgid "``s * n, n * s``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:739 -msgid "*n* shallow copies of *s* concatenated" +#: library/stdtypes.rst:739 +msgid "equivalent to adding *s* to itself *n* times" msgstr "" -#: ../src/Doc/library/stdtypes.rst:742 +#: library/stdtypes.rst:742 msgid "``s[i]``" msgstr "" # 1819899822414b0f8ae7d8f16c3fd486 -#: ../src/Doc/library/stdtypes.rst:742 +#: library/stdtypes.rst:742 msgid "*i*\\ th item of *s*, origin 0" msgstr "" -#: ../src/Doc/library/stdtypes.rst:744 +#: library/stdtypes.rst:744 msgid "``s[i:j]``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:744 +#: library/stdtypes.rst:744 msgid "slice of *s* from *i* to *j*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:746 +#: library/stdtypes.rst:746 msgid "``s[i:j:k]``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:746 +#: library/stdtypes.rst:746 msgid "slice of *s* from *i* to *j* with step *k*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:746 +#: library/stdtypes.rst:746 msgid "(3)(5)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:749 +#: library/stdtypes.rst:749 msgid "length of *s*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:751 +#: library/stdtypes.rst:751 msgid "``min(s)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:751 +#: library/stdtypes.rst:751 msgid "smallest item of *s*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:753 +#: library/stdtypes.rst:753 msgid "``max(s)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:753 +#: library/stdtypes.rst:753 msgid "largest item of *s*" msgstr "" # c8859159985c406c81203859ca956f5c -#: ../src/Doc/library/stdtypes.rst:755 +#: library/stdtypes.rst:755 msgid "``s.index(x)``" msgstr "" # 6bae6b1ad3f44ff8ba85afe7fedc6115 -#: ../src/Doc/library/stdtypes.rst:755 +#: library/stdtypes.rst:755 msgid "index of the first occurrence of *x* in *s*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:758 ../src/Doc/library/stdtypes.rst:1616 +#: library/stdtypes.rst:758 library/stdtypes.rst:1622 msgid "``s.count(x)``" msgstr "" # 90b3518c4241488bafdaff295ae469d4 -#: ../src/Doc/library/stdtypes.rst:758 +#: library/stdtypes.rst:758 msgid "total number of occurrences of *x* in *s*" msgstr "" # f20b6b6a3f974f6d88db5622b657be82 -#: ../src/Doc/library/stdtypes.rst:762 +#: library/stdtypes.rst:762 msgid "" "Sequence types also support comparisons. In particular, tuples and lists are " "compared lexicographically by comparing corresponding elements. This means " @@ -95218,7 +97131,7 @@ msgid "" msgstr "" # 89d03c4f1c8d4280a9221c5b5af3761c -#: ../src/Doc/library/stdtypes.rst:785 +#: library/stdtypes.rst:785 msgid "" "When *s* is a string or Unicode string object the ``in`` and ``not in`` " "operations act like a substring test. In Python versions before 2.3, *x* " @@ -95226,30 +97139,36 @@ msgid "" "string of any length." msgstr "" -#: ../src/Doc/library/stdtypes.rst:791 +#: library/stdtypes.rst:791 msgid "" "Values of *n* less than ``0`` are treated as ``0`` (which yields an empty " -"sequence of the same type as *s*). Note also that the copies are shallow; " -"nested structures are not copied. This often haunts new Python programmers; " -"consider:" +"sequence of the same type as *s*). Note that items in the sequence *s* are " +"not copied; they are referenced multiple times. This often haunts new " +"Python programmers; consider:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:803 +#: library/stdtypes.rst:803 msgid "" "What has happened is that ``[[]]`` is a one-element list containing an empty " -"list, so all three elements of ``[[]] * 3`` are (pointers to) this single " +"list, so all three elements of ``[[]] * 3`` are references to this single " "empty list. Modifying any of the elements of ``lists`` modifies this single " "list. You can create a list of different lists this way:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:816 +#: library/stdtypes.rst:815 +msgid "" +"Further explanation is available in the FAQ entry :ref:`faq-multidimensional-" +"list`." +msgstr "" + +#: library/stdtypes.rst:819 msgid "" "If *i* or *j* is negative, the index is relative to the end of the string: " "``len(s) + i`` or ``len(s) + j`` is substituted. But note that ``-0`` is " "still ``0``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:821 +#: library/stdtypes.rst:824 msgid "" "The slice of *s* from *i* to *j* is defined as the sequence of items with " "index *k* such that ``i <= k < j``. If *i* or *j* is greater than " @@ -95258,7 +97177,7 @@ msgid "" "to *j*, the slice is empty." msgstr "" -#: ../src/Doc/library/stdtypes.rst:828 +#: library/stdtypes.rst:831 msgid "" "The slice of *s* from *i* to *j* with step *k* is defined as the sequence of " "items with index ``x = i + n*k`` such that ``0 <= n < (j-i)/k``. In other " @@ -95270,7 +97189,7 @@ msgid "" "``1``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:839 +#: library/stdtypes.rst:842 msgid "" "If *s* and *t* are both strings, some Python implementations such as CPython " "can usually perform an in-place optimization for assignments of the form ``s " @@ -95281,12 +97200,16 @@ msgid "" "concatenation performance across versions and implementations." msgstr "" -#: ../src/Doc/library/stdtypes.rst:854 +#: library/stdtypes.rst:850 +msgid "Formerly, string concatenation never occurred in-place." +msgstr "" + +#: library/stdtypes.rst:857 msgid "String Methods" msgstr "" # 7b673f63b62a45a7953a47cf8932ad75 -#: ../src/Doc/library/stdtypes.rst:858 +#: library/stdtypes.rst:861 msgid "" "Below are listed the string methods which both 8-bit strings and Unicode " "objects support. Some of them are also available on :class:`bytearray` " @@ -95294,7 +97217,7 @@ msgid "" msgstr "" # 6faa66fbe7944599adb2c2c064055eab -#: ../src/Doc/library/stdtypes.rst:862 +#: library/stdtypes.rst:865 msgid "" "In addition, Python's strings support the sequence type methods described in " "the :ref:`typesseq` section. To output formatted strings use template " @@ -95304,7 +97227,7 @@ msgid "" msgstr "" # 463e660f664e4460b7612f7459978d69 -#: ../src/Doc/library/stdtypes.rst:870 +#: library/stdtypes.rst:873 msgid "" "Return a copy of the string with its first character capitalized and the " "rest lowercased." @@ -95322,22 +97245,26 @@ msgstr "" # 4cd0a1e552964144a5c84862061d50fb # d1bd13fa79c042789fa7bb75a8457795 # 70f3623e7c8047759e7713dcb67e02e7 -#: ../src/Doc/library/stdtypes.rst:873 ../src/Doc/library/stdtypes.rst:1010 -#: ../src/Doc/library/stdtypes.rst:1018 ../src/Doc/library/stdtypes.rst:1026 -#: ../src/Doc/library/stdtypes.rst:1034 ../src/Doc/library/stdtypes.rst:1042 -#: ../src/Doc/library/stdtypes.rst:1051 ../src/Doc/library/stdtypes.rst:1059 -#: ../src/Doc/library/stdtypes.rst:1084 ../src/Doc/library/stdtypes.rst:1257 -#: ../src/Doc/library/stdtypes.rst:1285 ../src/Doc/library/stdtypes.rst:1322 +#: library/stdtypes.rst:876 library/stdtypes.rst:1013 library/stdtypes.rst:1021 +#: library/stdtypes.rst:1029 library/stdtypes.rst:1037 +#: library/stdtypes.rst:1045 library/stdtypes.rst:1054 +#: library/stdtypes.rst:1062 library/stdtypes.rst:1087 +#: library/stdtypes.rst:1260 library/stdtypes.rst:1288 +#: library/stdtypes.rst:1325 msgid "For 8-bit strings, this method is locale-dependent." msgstr "" -#: ../src/Doc/library/stdtypes.rst:878 +#: library/stdtypes.rst:881 msgid "" "Return centered in a string of length *width*. Padding is done using the " "specified *fillchar* (default is a space)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:887 +#: library/stdtypes.rst:884 library/stdtypes.rst:1078 library/stdtypes.rst:1142 +msgid "Support for the *fillchar* argument." +msgstr "" + +#: library/stdtypes.rst:890 msgid "" "Return the number of non-overlapping occurrences of substring *sub* in the " "range [*start*, *end*]. Optional arguments *start* and *end* are " @@ -95345,7 +97272,7 @@ msgid "" msgstr "" # 96e971efd610443cb8b13f9c2b57618f -#: ../src/Doc/library/stdtypes.rst:894 +#: library/stdtypes.rst:897 msgid "" "Decodes the string using the codec registered for *encoding*. *encoding* " "defaults to the default string encoding. *errors* may be given to set a " @@ -95355,8 +97282,16 @@ msgid "" "register_error`, see section :ref:`codec-base-classes`." msgstr "" +#: library/stdtypes.rst:906 +msgid "Support for other error handling schemes added." +msgstr "" + +#: library/stdtypes.rst:909 library/stdtypes.rst:929 +msgid "Support for keyword arguments added." +msgstr "" + # 8bdfd59892f94bd2b4f38d1918817444 -#: ../src/Doc/library/stdtypes.rst:911 +#: library/stdtypes.rst:914 msgid "" "Return an encoded version of the string. Default encoding is the current " "default string encoding. *errors* may be given to set a different error " @@ -95368,7 +97303,13 @@ msgid "" "section :ref:`standard-encodings`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:931 +#: library/stdtypes.rst:925 +msgid "" +"Support for ``'xmlcharrefreplace'`` and ``'backslashreplace'`` and other " +"error handling schemes added." +msgstr "" + +#: library/stdtypes.rst:934 msgid "" "Return ``True`` if the string ends with the specified *suffix*, otherwise " "return ``False``. *suffix* can also be a tuple of suffixes to look for. " @@ -95376,8 +97317,12 @@ msgid "" "*end*, stop comparing at that position." msgstr "" +#: library/stdtypes.rst:939 +msgid "Accept tuples as *suffix*." +msgstr "" + # 47f0462ae1264ea9b3184dcad943bff6 -#: ../src/Doc/library/stdtypes.rst:942 +#: library/stdtypes.rst:945 msgid "" "Return a copy of the string where all tab characters are replaced by one or " "more spaces, depending on the current column and the given tab size. Tab " @@ -95393,7 +97338,7 @@ msgid "" "printed." msgstr "" -#: ../src/Doc/library/stdtypes.rst:963 +#: library/stdtypes.rst:966 msgid "" "Return the lowest index in the string where substring *sub* is found, such " "that *sub* is contained in the slice ``s[start:end]``. Optional arguments " @@ -95402,14 +97347,14 @@ msgid "" msgstr "" # 5ebe86fdd25949efaf389447ea4d5133 -#: ../src/Doc/library/stdtypes.rst:970 +#: library/stdtypes.rst:973 msgid "" "The :meth:`~str.find` method should be used only if you need to know the " "position of *sub*. To check if *sub* is a substring or not, use the :" "keyword:`in` operator::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:980 +#: library/stdtypes.rst:983 msgid "" "Perform a string formatting operation. The string on which this method is " "called can contain literal text or replacement fields delimited by braces " @@ -95419,58 +97364,58 @@ msgid "" "the corresponding argument." msgstr "" -#: ../src/Doc/library/stdtypes.rst:990 +#: library/stdtypes.rst:993 msgid "" "See :ref:`formatstrings` for a description of the various formatting options " "that can be specified in format strings." msgstr "" # 0b06396641ac4e30906dde2795680515 -#: ../src/Doc/library/stdtypes.rst:993 +#: library/stdtypes.rst:996 msgid "" "This method of string formatting is the new standard in Python 3, and should " "be preferred to the ``%`` formatting described in :ref:`string-formatting` " "in new code." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1002 +#: library/stdtypes.rst:1005 msgid "" "Like :meth:`find`, but raise :exc:`ValueError` when the substring is not " "found." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1007 +#: library/stdtypes.rst:1010 msgid "" "Return true if all characters in the string are alphanumeric and there is at " "least one character, false otherwise." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1015 +#: library/stdtypes.rst:1018 msgid "" "Return true if all characters in the string are alphabetic and there is at " "least one character, false otherwise." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1023 +#: library/stdtypes.rst:1026 msgid "" "Return true if all characters in the string are digits and there is at least " "one character, false otherwise." msgstr "" # db242e080fad48ec9e5f3ad6e2ff1abc -#: ../src/Doc/library/stdtypes.rst:1031 +#: library/stdtypes.rst:1034 msgid "" "Return true if all cased characters [4]_ in the string are lowercase and " "there is at least one cased character, false otherwise." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1039 +#: library/stdtypes.rst:1042 msgid "" "Return true if there are only whitespace characters in the string and there " "is at least one character, false otherwise." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1047 +#: library/stdtypes.rst:1050 msgid "" "Return true if the string is a titlecased string and there is at least one " "character, for example uppercase characters may only follow uncased " @@ -95478,14 +97423,14 @@ msgid "" msgstr "" # 88a1691945814104ba5b3621b46182be -#: ../src/Doc/library/stdtypes.rst:1056 +#: library/stdtypes.rst:1059 msgid "" "Return true if all cased characters [4]_ in the string are uppercase and " "there is at least one cased character, false otherwise." msgstr "" # e7f416be207c4a41b70d0e37211f149b -#: ../src/Doc/library/stdtypes.rst:1064 +#: library/stdtypes.rst:1067 msgid "" "Return a string which is the concatenation of the strings in the :term:" "`iterable` *iterable*. The separator between elements is the string " @@ -95493,7 +97438,7 @@ msgid "" msgstr "" # 32dbc45226244eb4aa866c052747f2b4 -#: ../src/Doc/library/stdtypes.rst:1071 +#: library/stdtypes.rst:1074 msgid "" "Return the string left justified in a string of length *width*. Padding is " "done using the specified *fillchar* (default is a space). The original " @@ -95501,13 +97446,13 @@ msgid "" msgstr "" # 032abd4becd14da183f20078f8fd9a5e -#: ../src/Doc/library/stdtypes.rst:1081 +#: library/stdtypes.rst:1084 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "lowercase." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1089 +#: library/stdtypes.rst:1092 msgid "" "Return a copy of the string with leading characters removed. The *chars* " "argument is a string specifying the set of characters to be removed. If " @@ -95516,7 +97461,12 @@ msgid "" "are stripped:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1105 +#: library/stdtypes.rst:1102 library/stdtypes.rst:1179 +#: library/stdtypes.rst:1251 +msgid "Support for the *chars* argument." +msgstr "" + +#: library/stdtypes.rst:1108 msgid "" "Split the string at the first occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " @@ -95524,35 +97474,35 @@ msgid "" "containing the string itself, followed by two empty strings." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1115 +#: library/stdtypes.rst:1118 msgid "" "Return a copy of the string with all occurrences of substring *old* replaced " "by *new*. If the optional argument *count* is given, only the first *count* " "occurrences are replaced." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1122 +#: library/stdtypes.rst:1125 msgid "" "Return the highest index in the string where substring *sub* is found, such " "that *sub* is contained within ``s[start:end]``. Optional arguments *start* " "and *end* are interpreted as in slice notation. Return ``-1`` on failure." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1129 +#: library/stdtypes.rst:1132 msgid "" "Like :meth:`rfind` but raises :exc:`ValueError` when the substring *sub* is " "not found." msgstr "" # 2ca98ea91b864d34ba0ddf694af68402 -#: ../src/Doc/library/stdtypes.rst:1135 +#: library/stdtypes.rst:1138 msgid "" "Return the string right justified in a string of length *width*. Padding is " "done using the specified *fillchar* (default is a space). The original " "string is returned if *width* is less than or equal to ``len(s)``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1145 +#: library/stdtypes.rst:1148 msgid "" "Split the string at the last occurrence of *sep*, and return a 3-tuple " "containing the part before the separator, the separator itself, and the part " @@ -95560,7 +97510,7 @@ msgid "" "containing two empty strings, followed by the string itself." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1155 +#: library/stdtypes.rst:1158 msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done, the " @@ -95569,7 +97519,7 @@ msgid "" "behaves like :meth:`split` which is described in detail below." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1166 +#: library/stdtypes.rst:1169 msgid "" "Return a copy of the string with trailing characters removed. The *chars* " "argument is a string specifying the set of characters to be removed. If " @@ -95579,7 +97529,7 @@ msgid "" msgstr "" # 9141e167f9a64769b716ec7a9b43ae09 -#: ../src/Doc/library/stdtypes.rst:1182 +#: library/stdtypes.rst:1185 msgid "" "Return a list of the words in the string, using *sep* as the delimiter " "string. If *maxsplit* is given, at most *maxsplit* splits are done (thus, " @@ -95588,7 +97538,7 @@ msgid "" "possible splits are made)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1188 +#: library/stdtypes.rst:1191 msgid "" "If *sep* is given, consecutive delimiters are not grouped together and are " "deemed to delimit empty strings (for example, ``'1,,2'.split(',')`` returns " @@ -95597,7 +97547,7 @@ msgid "" "Splitting an empty string with a specified separator returns ``['']``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1194 +#: library/stdtypes.rst:1197 msgid "" "If *sep* is not specified or is ``None``, a different splitting algorithm is " "applied: runs of consecutive whitespace are regarded as a single separator, " @@ -95607,14 +97557,14 @@ msgid "" "returns ``[]``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1201 +#: library/stdtypes.rst:1204 msgid "" "For example, ``' 1 2 3 '.split()`` returns ``['1', '2', '3']``, and ``' " "1 2 3 '.split(None, 1)`` returns ``['1', '2 3 ']``." msgstr "" # 97b4673fecf148beb8fcb948c3408bdb -#: ../src/Doc/library/stdtypes.rst:1210 +#: library/stdtypes.rst:1213 msgid "" "Return a list of the lines in the string, breaking at line boundaries. This " "method uses the :term:`universal newlines` approach to splitting lines. Line " @@ -95623,7 +97573,7 @@ msgid "" msgstr "" # 7e16302d09b54b1a90d16a599f47aa91 -#: ../src/Doc/library/stdtypes.rst:1215 +#: library/stdtypes.rst:1218 msgid "" "For example, ``'ab c\\n\\nde fg\\rkl\\r\\n'.splitlines()`` returns ``['ab " "c', '', 'de fg', 'kl']``, while the same call with ``splitlines(True)`` " @@ -95631,14 +97581,14 @@ msgid "" msgstr "" # 94451cb5f0774ad8900e67b2ee12f030 -#: ../src/Doc/library/stdtypes.rst:1219 +#: library/stdtypes.rst:1222 msgid "" "Unlike :meth:`~str.split` when a delimiter string *sep* is given, this " "method returns an empty list for the empty string, and a terminal line break " "does not result in an extra line." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1226 +#: library/stdtypes.rst:1229 msgid "" "Return ``True`` if string starts with the *prefix*, otherwise return " "``False``. *prefix* can also be a tuple of prefixes to look for. With " @@ -95646,7 +97596,11 @@ msgid "" "*end*, stop comparing string at that position." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1237 +#: library/stdtypes.rst:1234 +msgid "Accept tuples as *prefix*." +msgstr "" + +#: library/stdtypes.rst:1240 msgid "" "Return a copy of the string with the leading and trailing characters " "removed. The *chars* argument is a string specifying the set of characters " @@ -95655,19 +97609,19 @@ msgid "" "all combinations of its values are stripped:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1254 +#: library/stdtypes.rst:1257 msgid "" "Return a copy of the string with uppercase characters converted to lowercase " "and vice versa." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1262 +#: library/stdtypes.rst:1265 msgid "" "Return a titlecased version of the string where words start with an " "uppercase character and the remaining characters are lowercase." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1265 +#: library/stdtypes.rst:1268 msgid "" "The algorithm uses a simple language-independent definition of a word as " "groups of consecutive letters. The definition works in many contexts but it " @@ -95675,13 +97629,13 @@ msgid "" "which may not be the desired result::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1273 +#: library/stdtypes.rst:1276 msgid "" "A workaround for apostrophes can be constructed using regular expressions::" msgstr "" # 05f84e04459f472687bf753d964ac284 -#: ../src/Doc/library/stdtypes.rst:1290 +#: library/stdtypes.rst:1293 msgid "" "Return a copy of the string where all characters occurring in the optional " "argument *deletechars* are removed, and the remaining characters have been " @@ -95689,15 +97643,19 @@ msgid "" "256." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1295 +#: library/stdtypes.rst:1298 msgid "" "You can use the :func:`~string.maketrans` helper function in the :mod:" "`string` module to create a translation table. For string objects, set the " "*table* argument to ``None`` for translations that only delete characters:" msgstr "" +#: library/stdtypes.rst:1305 +msgid "Support for a ``None`` *table* argument." +msgstr "" + # 18cca0d755b242da8eccbb3f02fd0a2c -#: ../src/Doc/library/stdtypes.rst:1305 +#: library/stdtypes.rst:1308 msgid "" "For Unicode objects, the :meth:`translate` method does not accept the " "optional *deletechars* argument. Instead, it returns a copy of the *s* " @@ -95710,7 +97668,7 @@ msgid "" msgstr "" # 46e87f8fbff64076a4ab6775af972155 -#: ../src/Doc/library/stdtypes.rst:1317 +#: library/stdtypes.rst:1320 msgid "" "Return a copy of the string with all the cased characters [4]_ converted to " "uppercase. Note that ``str.upper().isupper()`` might be ``False`` if ``s`` " @@ -95720,7 +97678,7 @@ msgid "" msgstr "" # 053f990e1f244ed683f25cb5a97b2005 -#: ../src/Doc/library/stdtypes.rst:1327 +#: library/stdtypes.rst:1330 msgid "" "Return the numeric string left filled with zeros in a string of length " "*width*. A sign prefix is handled correctly. The original string is " @@ -95728,12 +97686,12 @@ msgid "" msgstr "" # 203d91fdfdc6495bb99355ff2b0badb7 -#: ../src/Doc/library/stdtypes.rst:1334 +#: library/stdtypes.rst:1337 msgid "The following methods are present only on unicode objects:" msgstr "" # fee33b77ef54424b822f5bc0c13b3552 -#: ../src/Doc/library/stdtypes.rst:1338 +#: library/stdtypes.rst:1341 msgid "" "Return ``True`` if there are only numeric characters in S, ``False`` " "otherwise. Numeric characters include digit characters, and all characters " @@ -95742,7 +97700,7 @@ msgid "" msgstr "" # 1d72aaec9523414d924656cf8a077e80 -#: ../src/Doc/library/stdtypes.rst:1345 +#: library/stdtypes.rst:1348 msgid "" "Return ``True`` if there are only decimal characters in S, ``False`` " "otherwise. Decimal characters include digit characters, and all characters " @@ -95751,12 +97709,12 @@ msgid "" msgstr "" # f7aed2bb948b4431ae0335ea75ececf7 -#: ../src/Doc/library/stdtypes.rst:1354 +#: library/stdtypes.rst:1357 msgid "String Formatting Operations" msgstr "" # 1e70b20350ac498598c52862facbe210 -#: ../src/Doc/library/stdtypes.rst:1366 +#: library/stdtypes.rst:1369 msgid "" "String and Unicode objects have one unique built-in operation: the ``%`` " "operator (modulo). This is also known as the string *formatting* or " @@ -95769,7 +97727,7 @@ msgid "" msgstr "" # 9c9ea094be5142f681f8c9aa43b6eae5 -#: ../src/Doc/library/stdtypes.rst:1375 +#: library/stdtypes.rst:1378 msgid "" "If *format* requires a single argument, *values* may be a single non-tuple " "object. [5]_ Otherwise, *values* must be a tuple with exactly the number of " @@ -95777,36 +97735,36 @@ msgid "" "example, a dictionary)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1380 +#: library/stdtypes.rst:1383 msgid "" "A conversion specifier contains two or more characters and has the following " "components, which must occur in this order:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1383 +#: library/stdtypes.rst:1386 msgid "The ``'%'`` character, which marks the start of the specifier." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1385 +#: library/stdtypes.rst:1388 msgid "" "Mapping key (optional), consisting of a parenthesised sequence of characters " "(for example, ``(somename)``)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1388 +#: library/stdtypes.rst:1391 msgid "" "Conversion flags (optional), which affect the result of some conversion " "types." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1391 +#: library/stdtypes.rst:1394 msgid "" "Minimum field width (optional). If specified as an ``'*'`` (asterisk), the " "actual width is read from the next element of the tuple in *values*, and the " "object to convert comes after the minimum field width and optional precision." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1395 +#: library/stdtypes.rst:1398 msgid "" "Precision (optional), given as a ``'.'`` (dot) followed by the precision. " "If specified as ``'*'`` (an asterisk), the actual width is read from the " @@ -95814,15 +97772,15 @@ msgid "" "the precision." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1400 +#: library/stdtypes.rst:1403 msgid "Length modifier (optional)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1402 +#: library/stdtypes.rst:1405 msgid "Conversion type." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1404 +#: library/stdtypes.rst:1407 msgid "" "When the right argument is a dictionary (or other mapping type), then the " "formats in the string *must* include a parenthesised mapping key into that " @@ -95830,178 +97788,178 @@ msgid "" "selects the value to be formatted from the mapping. For example:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1413 +#: library/stdtypes.rst:1416 msgid "" "In this case no ``*`` specifiers may occur in a format (since they require a " "sequential parameter list)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1416 +#: library/stdtypes.rst:1419 msgid "The conversion flag characters are:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1421 +#: library/stdtypes.rst:1424 msgid "``'#'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1421 +#: library/stdtypes.rst:1424 msgid "" "The value conversion will use the \"alternate form\" (where defined below)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1424 +#: library/stdtypes.rst:1427 msgid "``'0'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1424 +#: library/stdtypes.rst:1427 msgid "The conversion will be zero padded for numeric values." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1426 ../src/Doc/library/string.rst:372 +#: library/stdtypes.rst:1429 library/string.rst:372 msgid "``'-'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1426 +#: library/stdtypes.rst:1429 msgid "" "The converted value is left adjusted (overrides the ``'0'`` conversion if " "both are given)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1429 +#: library/stdtypes.rst:1432 msgid "``' '``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1429 +#: library/stdtypes.rst:1432 msgid "" "(a space) A blank should be left before a positive number (or empty string) " "produced by a signed conversion." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1432 +#: library/stdtypes.rst:1435 msgid "" "A sign character (``'+'`` or ``'-'``) will precede the conversion (overrides " "a \"space\" flag)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1436 +#: library/stdtypes.rst:1439 msgid "" "A length modifier (``h``, ``l``, or ``L``) may be present, but is ignored as " "it is not necessary for Python -- so e.g. ``%ld`` is identical to ``%d``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1439 +#: library/stdtypes.rst:1442 msgid "The conversion types are:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1442 +#: library/stdtypes.rst:1445 msgid "Conversion" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1444 ../src/Doc/library/stdtypes.rst:1446 +#: library/stdtypes.rst:1447 library/stdtypes.rst:1449 msgid "Signed integer decimal." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1448 ../src/Doc/library/string.rst:429 +#: library/stdtypes.rst:1451 library/string.rst:429 msgid "``'o'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1448 +#: library/stdtypes.rst:1451 msgid "Signed octal value." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1450 +#: library/stdtypes.rst:1453 msgid "Obsolete type -- it is identical to ``'d'``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1452 ../src/Doc/library/string.rst:431 +#: library/stdtypes.rst:1455 library/string.rst:431 msgid "``'x'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1452 +#: library/stdtypes.rst:1455 msgid "Signed hexadecimal (lowercase)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1454 ../src/Doc/library/string.rst:434 +#: library/stdtypes.rst:1457 library/string.rst:434 msgid "``'X'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1454 +#: library/stdtypes.rst:1457 msgid "Signed hexadecimal (uppercase)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1456 ../src/Doc/library/string.rst:454 +#: library/stdtypes.rst:1459 library/string.rst:454 msgid "``'e'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1456 +#: library/stdtypes.rst:1459 msgid "Floating point exponential format (lowercase)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1458 ../src/Doc/library/string.rst:458 +#: library/stdtypes.rst:1461 library/string.rst:458 msgid "``'E'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1458 +#: library/stdtypes.rst:1461 msgid "Floating point exponential format (uppercase)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1460 ../src/Doc/library/stdtypes.rst:1462 +#: library/stdtypes.rst:1463 library/stdtypes.rst:1465 msgid "Floating point decimal format." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1462 ../src/Doc/library/string.rst:464 +#: library/stdtypes.rst:1465 library/string.rst:464 msgid "``'F'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1464 ../src/Doc/library/string.rst:466 +#: library/stdtypes.rst:1467 library/string.rst:466 msgid "``'g'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1464 +#: library/stdtypes.rst:1467 msgid "" "Floating point format. Uses lowercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1468 ../src/Doc/library/string.rst:490 +#: library/stdtypes.rst:1471 library/string.rst:490 msgid "``'G'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1468 +#: library/stdtypes.rst:1471 msgid "" "Floating point format. Uses uppercase exponential format if exponent is less " "than -4 or not less than precision, decimal format otherwise." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1472 +#: library/stdtypes.rst:1475 msgid "Single character (accepts integer or single character string)." msgstr "" # 7ad6afa23d8f4ab08a946b3f16a10d0d -#: ../src/Doc/library/stdtypes.rst:1475 +#: library/stdtypes.rst:1478 msgid "String (converts any Python object using :ref:`repr() <func-repr>`)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1478 +#: library/stdtypes.rst:1481 msgid "String (converts any Python object using :func:`str`)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1481 ../src/Doc/library/string.rst:498 +#: library/stdtypes.rst:1484 library/string.rst:498 msgid "``'%'``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1481 +#: library/stdtypes.rst:1484 msgid "No argument is converted, results in a ``'%'`` character in the result." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1488 +#: library/stdtypes.rst:1491 msgid "" "The alternate form causes a leading zero (``'0'``) to be inserted between " "left-hand padding and the formatting of the number if the leading character " "of the result is not already a zero." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1493 +#: library/stdtypes.rst:1496 msgid "" "The alternate form causes a leading ``'0x'`` or ``'0X'`` (depending on " "whether the ``'x'`` or ``'X'`` format was used) to be inserted between left-" @@ -96009,69 +97967,75 @@ msgid "" "the result is not already a zero." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1499 +#: library/stdtypes.rst:1502 msgid "" "The alternate form causes the result to always contain a decimal point, even " "if no digits follow it." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1502 +#: library/stdtypes.rst:1505 msgid "" "The precision determines the number of digits after the decimal point and " "defaults to 6." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1506 +#: library/stdtypes.rst:1509 msgid "" "The alternate form causes the result to always contain a decimal point, and " "trailing zeroes are not removed as they would otherwise be." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1509 +#: library/stdtypes.rst:1512 msgid "" "The precision determines the number of significant digits before and after " "the decimal point and defaults to 6." msgstr "" # 8f3f99626cf24ca6bcc0316fd8898d10 -#: ../src/Doc/library/stdtypes.rst:1513 +#: library/stdtypes.rst:1516 msgid "The ``%r`` conversion was added in Python 2.0." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1515 ../src/Doc/library/stdtypes.rst:1521 +#: library/stdtypes.rst:1518 library/stdtypes.rst:1524 msgid "The precision determines the maximal number of characters used." msgstr "" # 4a6b12c1b10845cf859176cd3e7c0ac7 -#: ../src/Doc/library/stdtypes.rst:1518 +#: library/stdtypes.rst:1521 msgid "" "If the object or format provided is a :class:`unicode` string, the resulting " "string will also be :class:`unicode`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1524 +#: library/stdtypes.rst:1527 msgid "See :pep:`237`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1526 +#: library/stdtypes.rst:1529 msgid "" "Since Python strings have an explicit length, ``%s`` conversions do not " "assume that ``'\\0'`` is the end of the string." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1539 +#: library/stdtypes.rst:1534 +msgid "" +"``%f`` conversions for numbers whose absolute value is over 1e50 are no " +"longer replaced by ``%g`` conversions." +msgstr "" + +#: library/stdtypes.rst:1542 msgid "" "Additional string operations are defined in standard modules :mod:`string` " "and :mod:`re`." msgstr "" # 1b6a6be12f824bc8a211001d68833482 -#: ../src/Doc/library/stdtypes.rst:1546 +#: library/stdtypes.rst:1549 msgid "XRange Type" msgstr "" # 87a5e0eb56ed4440873b431fe702b806 -#: ../src/Doc/library/stdtypes.rst:1550 +#: library/stdtypes.rst:1553 msgid "" "The :class:`xrange` type is an immutable sequence which is commonly used for " "looping. The advantage of the :class:`xrange` type is that an :class:" @@ -96081,18 +98045,18 @@ msgid "" msgstr "" # b1304e9b2d824edbb03c5256dc2783de -#: ../src/Doc/library/stdtypes.rst:1555 +#: library/stdtypes.rst:1558 msgid "" "XRange objects have very little behavior: they only support indexing, " "iteration, and the :func:`len` function." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1562 +#: library/stdtypes.rst:1565 msgid "Mutable Sequence Types" msgstr "" # d9fa338fddba4851b03abbefd73363a2 -#: ../src/Doc/library/stdtypes.rst:1568 +#: library/stdtypes.rst:1571 msgid "" "List and :class:`bytearray` objects support additional operations that allow " "in-place modification of the object. Other mutable sequence types (when " @@ -96102,136 +98066,148 @@ msgid "" "(where *x* is an arbitrary object):" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1595 +#: library/stdtypes.rst:1598 msgid "``s[i] = x``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1595 +#: library/stdtypes.rst:1598 msgid "item *i* of *s* is replaced by *x*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1598 +#: library/stdtypes.rst:1601 msgid "``s[i:j] = t``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1598 +#: library/stdtypes.rst:1601 msgid "" "slice of *s* from *i* to *j* is replaced by the contents of the iterable *t*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1602 +#: library/stdtypes.rst:1605 msgid "``del s[i:j]``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1602 +#: library/stdtypes.rst:1605 msgid "same as ``s[i:j] = []``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1604 +#: library/stdtypes.rst:1607 msgid "``s[i:j:k] = t``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1604 +#: library/stdtypes.rst:1607 msgid "the elements of ``s[i:j:k]`` are replaced by those of *t*" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1607 +#: library/stdtypes.rst:1610 msgid "``del s[i:j:k]``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1607 +#: library/stdtypes.rst:1610 msgid "removes the elements of ``s[i:j:k]`` from the list" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1610 +#: library/stdtypes.rst:1613 msgid "``s.append(x)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1610 +#: library/stdtypes.rst:1613 msgid "same as ``s[len(s):len(s)] = [x]``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1613 -msgid "``s.extend(x)``" +#: library/stdtypes.rst:1616 +msgid "``s.extend(x)`` or ``s += t``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1613 -msgid "same as ``s[len(s):len(s)] = x``" +#: library/stdtypes.rst:1616 +msgid "for the most part the same as ``s[len(s):len(s)] = x``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1616 +#: library/stdtypes.rst:1619 +msgid "``s *= n``" +msgstr "" + +#: library/stdtypes.rst:1619 +msgid "updates *s* with its contents repeated *n* times" +msgstr "" + +#: library/stdtypes.rst:1619 +msgid "\\(11)" +msgstr "" + +#: library/stdtypes.rst:1622 msgid "return number of *i*'s for which ``s[i] == x``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1619 +#: library/stdtypes.rst:1625 msgid "``s.index(x[, i[, j]])``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1619 +#: library/stdtypes.rst:1625 msgid "return smallest *k* such that ``s[k] == x`` and ``i <= k < j``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1623 +#: library/stdtypes.rst:1629 msgid "``s.insert(i, x)``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1623 +#: library/stdtypes.rst:1629 msgid "same as ``s[i:i] = [x]``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1625 +#: library/stdtypes.rst:1631 msgid "``s.pop([i])``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1625 +#: library/stdtypes.rst:1631 msgid "same as ``x = s[i]; del s[i]; return x``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1628 +#: library/stdtypes.rst:1634 msgid "same as ``del s[s.index(x)]``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1630 +#: library/stdtypes.rst:1636 msgid "``s.reverse()``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1630 +#: library/stdtypes.rst:1636 msgid "reverses the items of *s* in place" msgstr "" # 35c6f3f9400645199bf38bcfef1d50ff -#: ../src/Doc/library/stdtypes.rst:1633 +#: library/stdtypes.rst:1639 msgid "``s.sort([cmp[, key[, reverse]]])``" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1633 +#: library/stdtypes.rst:1639 msgid "sort the items of *s* in place" msgstr "" # 3bffe8b7ebde40c484219918e52a7cac -#: ../src/Doc/library/stdtypes.rst:1633 +#: library/stdtypes.rst:1639 msgid "(7)(8)(9)(10)" msgstr "" # b11a969c87f8420f906eaaf3990e26d2 -#: ../src/Doc/library/stdtypes.rst:1640 +#: library/stdtypes.rst:1646 msgid "*t* must have the same length as the slice it is replacing." msgstr "" # ba5109552d6344119608fa9924f4ca9f -#: ../src/Doc/library/stdtypes.rst:1643 +#: library/stdtypes.rst:1649 msgid "" "The C implementation of Python has historically accepted multiple parameters " "and implicitly joined them into a tuple; this no longer works in Python " "2.0. Use of this misfeature has been deprecated since Python 1.4." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1648 +#: library/stdtypes.rst:1654 msgid "*x* can be any iterable object." msgstr "" # 223c081c32a7418688befa996d88ee02 -#: ../src/Doc/library/stdtypes.rst:1651 +#: library/stdtypes.rst:1657 msgid "" "Raises :exc:`ValueError` when *x* is not found in *s*. When a negative index " "is passed as the second or third parameter to the :meth:`index` method, the " @@ -96239,23 +98215,33 @@ msgid "" "truncated to zero, as for slice indices." msgstr "" +#: library/stdtypes.rst:1662 +msgid "" +"Previously, :meth:`index` didn't have arguments for specifying start and " +"stop positions." +msgstr "" + # 8f22cf3112564b2fa0e14ef4ccaa3af6 -#: ../src/Doc/library/stdtypes.rst:1661 +#: library/stdtypes.rst:1667 msgid "" "When a negative index is passed as the first parameter to the :meth:`insert` " "method, the list length is added, as for slice indices. If it is still " "negative, it is truncated to zero, as for slice indices." msgstr "" +#: library/stdtypes.rst:1671 +msgid "Previously, all negative indices were truncated to zero." +msgstr "" + # b024e2dedd644650a10a219ff83b7d44 -#: ../src/Doc/library/stdtypes.rst:1669 +#: library/stdtypes.rst:1675 msgid "" "The :meth:`pop` method's optional argument *i* defaults to ``-1``, so that " "by default the last item is removed and returned." msgstr "" # b8b2a162522c49f6ae404028cb107db2 -#: ../src/Doc/library/stdtypes.rst:1673 +#: library/stdtypes.rst:1679 msgid "" "The :meth:`sort` and :meth:`reverse` methods modify the list in place for " "economy of space when sorting or reversing a large list. To remind you that " @@ -96263,14 +98249,14 @@ msgid "" msgstr "" # e60676f0d0ac404c94f11813de67416b -#: ../src/Doc/library/stdtypes.rst:1678 +#: library/stdtypes.rst:1684 msgid "" "The :meth:`sort` method takes optional arguments for controlling the " "comparisons." msgstr "" # e0da0cdaf31f4fa5bb240a25e181c4ab -#: ../src/Doc/library/stdtypes.rst:1681 +#: library/stdtypes.rst:1687 msgid "" "*cmp* specifies a custom comparison function of two arguments (list items) " "which should return a negative, zero or positive number depending on whether " @@ -96280,15 +98266,23 @@ msgid "" msgstr "" # 2b419a15d807449c96392616c8a59bb9 -#: ../src/Doc/library/stdtypes.rst:1687 +#: library/stdtypes.rst:1693 msgid "" "*key* specifies a function of one argument that is used to extract a " "comparison key from each list element: ``key=str.lower``. The default value " "is ``None``." msgstr "" +#: library/stdtypes.rst:1705 +msgid "Support for ``None`` as an equivalent to omitting *cmp* was added." +msgstr "" + +#: library/stdtypes.rst:1708 +msgid "Support for *key* and *reverse* was added." +msgstr "" + # 8dba5a8facf7483ababc8aa62908999d -#: ../src/Doc/library/stdtypes.rst:1706 +#: library/stdtypes.rst:1712 msgid "" "Starting with Python 2.3, the :meth:`sort` method is guaranteed to be " "stable. A sort is stable if it guarantees not to change the relative order " @@ -96297,7 +98291,7 @@ msgid "" msgstr "" # a63c3e279c0f45d1a80c51857927f29c -#: ../src/Doc/library/stdtypes.rst:1714 +#: library/stdtypes.rst:1720 msgid "" "While a list is being sorted, the effect of attempting to mutate, or even " "inspect, the list is undefined. The C implementation of Python 2.3 and " @@ -96305,11 +98299,19 @@ msgid "" "`ValueError` if it can detect that the list has been mutated during a sort." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1724 +#: library/stdtypes.rst:1727 +msgid "" +"The value *n* is an integer, or an object implementing :meth:`~object." +"__index__`. Zero and negative values of *n* clear the sequence. Items in " +"the sequence are not copied; they are referenced multiple times, as " +"explained for ``s * n`` under :ref:`typesseq`." +msgstr "" + +#: library/stdtypes.rst:1736 msgid "Set Types --- :class:`set`, :class:`frozenset`" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1728 +#: library/stdtypes.rst:1740 msgid "" "A :dfn:`set` object is an unordered collection of distinct :term:`hashable` " "objects. Common uses include membership testing, removing duplicates from a " @@ -96320,7 +98322,7 @@ msgid "" msgstr "" # 2a73b46ba4f543d0b78d3d3233d62a1d -#: ../src/Doc/library/stdtypes.rst:1743 +#: library/stdtypes.rst:1755 msgid "" "There are currently two built-in set types, :class:`set` and :class:" "`frozenset`. The :class:`set` type is mutable --- the contents can be " @@ -96333,19 +98335,19 @@ msgid "" msgstr "" # 0ca95d9977c94740ba03f44099bf71f9 -#: ../src/Doc/library/stdtypes.rst:1751 +#: library/stdtypes.rst:1763 msgid "" "As of Python 2.7, non-empty sets (not frozensets) can be created by placing " "a comma-separated list of elements within braces, for example: ``{'jack', " "'sjoerd'}``, in addition to the :class:`set` constructor." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1755 +#: library/stdtypes.rst:1767 msgid "The constructors for both classes work the same:" msgstr "" # dc57b1938d624ee89fc4e78e953e92ce -#: ../src/Doc/library/stdtypes.rst:1760 +#: library/stdtypes.rst:1772 msgid "" "Return a new set or frozenset object whose elements are taken from " "*iterable*. The elements of a set must be :term:`hashable`. To represent " @@ -96353,75 +98355,81 @@ msgid "" "*iterable* is not specified, a new empty set is returned." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1766 +#: library/stdtypes.rst:1778 msgid "" "Instances of :class:`set` and :class:`frozenset` provide the following " "operations:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1771 +#: library/stdtypes.rst:1783 msgid "Return the cardinality of set *s*." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1775 +#: library/stdtypes.rst:1787 msgid "Test *x* for membership in *s*." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1779 +#: library/stdtypes.rst:1791 msgid "Test *x* for non-membership in *s*." msgstr "" # 0f593a1efd6f4425971fa99967d16b83 -#: ../src/Doc/library/stdtypes.rst:1783 +#: library/stdtypes.rst:1795 msgid "" "Return ``True`` if the set has no elements in common with *other*. Sets are " "disjoint if and only if their intersection is the empty set." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1791 +#: library/stdtypes.rst:1803 msgid "Test whether every element in the set is in *other*." msgstr "" # dfd7ab3f1e02441dabc801ec0bf0cce0 -#: ../src/Doc/library/stdtypes.rst:1795 +#: library/stdtypes.rst:1807 msgid "" "Test whether the set is a proper subset of *other*, that is, ``set <= other " "and set != other``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1801 +#: library/stdtypes.rst:1813 msgid "Test whether every element in *other* is in the set." msgstr "" # d7609f94cf994f7eaaecc194f432067d -#: ../src/Doc/library/stdtypes.rst:1805 +#: library/stdtypes.rst:1817 msgid "" "Test whether the set is a proper superset of *other*, that is, ``set >= " "other and set != other``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1811 +#: library/stdtypes.rst:1823 msgid "Return a new set with elements from the set and all others." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1819 +#: library/stdtypes.rst:1825 library/stdtypes.rst:1833 +#: library/stdtypes.rst:1841 library/stdtypes.rst:1895 +#: library/stdtypes.rst:1903 library/stdtypes.rst:1911 +msgid "Accepts multiple input iterables." +msgstr "" + +#: library/stdtypes.rst:1831 msgid "Return a new set with elements common to the set and all others." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1827 +#: library/stdtypes.rst:1839 msgid "Return a new set with elements in the set that are not in the others." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1835 +#: library/stdtypes.rst:1847 msgid "" "Return a new set with elements in either the set or *other* but not both." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1839 +#: library/stdtypes.rst:1851 msgid "Return a new set with a shallow copy of *s*." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1842 +#: library/stdtypes.rst:1854 msgid "" "Note, the non-operator versions of :meth:`union`, :meth:`intersection`, :" "meth:`difference`, and :meth:`symmetric_difference`, :meth:`issubset`, and :" @@ -96431,7 +98439,7 @@ msgid "" "in favor of the more readable ``set('abc').intersection('cbs')``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1849 +#: library/stdtypes.rst:1861 msgid "" "Both :class:`set` and :class:`frozenset` support set to set comparisons. Two " "sets are equal if and only if every element of each set is contained in the " @@ -96441,7 +98449,7 @@ msgid "" "set is a proper superset of the second set (is a superset, but is not equal)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1856 +#: library/stdtypes.rst:1868 msgid "" "Instances of :class:`set` are compared to instances of :class:`frozenset` " "based on their members. For example, ``set('abc') == frozenset('abc')`` " @@ -96449,7 +98457,7 @@ msgid "" msgstr "" # 52ae6ae2c34846cfbf9ee07a4bf1c3b2 -#: ../src/Doc/library/stdtypes.rst:1860 +#: library/stdtypes.rst:1872 msgid "" "The subset and equality comparisons do not generalize to a total ordering " "function. For example, any two non-empty disjoint sets are not equal and " @@ -96458,65 +98466,65 @@ msgid "" "`__cmp__` method." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1869 +#: library/stdtypes.rst:1881 msgid "Set elements, like dictionary keys, must be :term:`hashable`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1871 +#: library/stdtypes.rst:1883 msgid "" "Binary operations that mix :class:`set` instances with :class:`frozenset` " "return the type of the first operand. For example: ``frozenset('ab') | " "set('bc')`` returns an instance of :class:`frozenset`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1875 +#: library/stdtypes.rst:1887 msgid "" "The following table lists operations available for :class:`set` that do not " "apply to immutable instances of :class:`frozenset`:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1881 +#: library/stdtypes.rst:1893 msgid "Update the set, adding elements from all others." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1889 +#: library/stdtypes.rst:1901 msgid "Update the set, keeping only elements found in it and all others." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1897 +#: library/stdtypes.rst:1909 msgid "Update the set, removing elements found in others." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1905 +#: library/stdtypes.rst:1917 msgid "" "Update the set, keeping only elements found in either set, but not in both." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1909 +#: library/stdtypes.rst:1921 msgid "Add element *elem* to the set." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1913 +#: library/stdtypes.rst:1925 msgid "" "Remove element *elem* from the set. Raises :exc:`KeyError` if *elem* is not " "contained in the set." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1918 +#: library/stdtypes.rst:1930 msgid "Remove element *elem* from the set if it is present." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1922 +#: library/stdtypes.rst:1934 msgid "" "Remove and return an arbitrary element from the set. Raises :exc:`KeyError` " "if the set is empty." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1927 +#: library/stdtypes.rst:1939 msgid "Remove all elements from the set." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1930 +#: library/stdtypes.rst:1942 msgid "" "Note, the non-operator versions of the :meth:`update`, :meth:" "`intersection_update`, :meth:`difference_update`, and :meth:" @@ -96524,7 +98532,7 @@ msgid "" "argument." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1935 +#: library/stdtypes.rst:1947 msgid "" "Note, the *elem* argument to the :meth:`__contains__`, :meth:`remove`, and :" "meth:`discard` methods may be a set. To support searching for an equivalent " @@ -96533,22 +98541,21 @@ msgid "" "since it does not have a meaningful value." msgstr "" -# ebd51acdd40e4bb1855dc792489f5de3 -#: ../src/Doc/library/stdtypes.rst:1943 -msgid ":ref:`comparison-to-builtin-set`" +#: library/stdtypes.rst:1956 +msgid "comparison-to-builtin-set" msgstr "" # d71058d3a92344c98b081d8bc0fa6c74 -#: ../src/Doc/library/stdtypes.rst:1945 +#: library/stdtypes.rst:1957 msgid "Differences between the :mod:`sets` module and the built-in set types." msgstr "" -#: ../src/Doc/library/stdtypes.rst:1951 +#: library/stdtypes.rst:1963 msgid "Mapping Types --- :class:`dict`" msgstr "" # a63ec7d7bb744305960607f24924ad58 -#: ../src/Doc/library/stdtypes.rst:1961 +#: library/stdtypes.rst:1973 msgid "" "A :term:`mapping` object maps :term:`hashable` values to arbitrary objects. " "Mappings are mutable objects. There is currently only one standard mapping " @@ -96557,7 +98564,7 @@ msgid "" "module.)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1967 +#: library/stdtypes.rst:1979 msgid "" "A dictionary's keys are *almost* arbitrary values. Values that are not :" "term:`hashable`, that is, values containing lists, dictionaries or other " @@ -96569,7 +98576,7 @@ msgid "" "approximations it is usually unwise to use them as dictionary keys.)" msgstr "" -#: ../src/Doc/library/stdtypes.rst:1976 +#: library/stdtypes.rst:1988 msgid "" "Dictionaries can be created by placing a comma-separated list of ``key: " "value`` pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` " @@ -96577,14 +98584,14 @@ msgid "" msgstr "" # 0a38c8ab3c494b19973b736cba1bd6c5 -#: ../src/Doc/library/stdtypes.rst:1984 +#: library/stdtypes.rst:1996 msgid "" "Return a new dictionary initialized from an optional positional argument and " "a possibly empty set of keyword arguments." msgstr "" # db60589e67974b0f8cf87f78263b4547 -#: ../src/Doc/library/stdtypes.rst:1987 +#: library/stdtypes.rst:1999 msgid "" "If no positional argument is given, an empty dictionary is created. If a " "positional argument is given and it is a mapping object, a dictionary is " @@ -96597,7 +98604,7 @@ msgid "" msgstr "" # 4e551dbae0fd4df09a574e348e8e5f15 -#: ../src/Doc/library/stdtypes.rst:1997 +#: library/stdtypes.rst:2009 msgid "" "If keyword arguments are given, the keyword arguments and their values are " "added to the dictionary created from the positional argument. If a key " @@ -96606,80 +98613,106 @@ msgid "" msgstr "" # 2c3bf3f04ce7430aa4736615205bea02 -#: ../src/Doc/library/stdtypes.rst:2002 +#: library/stdtypes.rst:2014 msgid "" "To illustrate, the following examples all return a dictionary equal to " "``{\"one\": 1, \"two\": 2, \"three\": 3}``::" msgstr "" # 228dcffe3c7f4e1b8005478ec5b84354 -#: ../src/Doc/library/stdtypes.rst:2013 +#: library/stdtypes.rst:2025 msgid "" "Providing keyword arguments as in the first example only works for keys that " "are valid Python identifiers. Otherwise, any valid keys can be used." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2022 +#: library/stdtypes.rst:2030 +msgid "Support for building a dictionary from keyword arguments added." +msgstr "" + +#: library/stdtypes.rst:2034 msgid "" "These are the operations that dictionaries support (and therefore, custom " "mapping types should support too):" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2027 +#: library/stdtypes.rst:2039 msgid "Return the number of items in the dictionary *d*." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2031 +#: library/stdtypes.rst:2043 msgid "" "Return the item of *d* with key *key*. Raises a :exc:`KeyError` if *key* is " "not in the map." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2047 +#: library/stdtypes.rst:2048 +msgid "" +"If a subclass of dict defines a method :meth:`__missing__` and *key* is not " +"present, the ``d[key]`` operation calls that method with the key *key* as " +"argument. The ``d[key]`` operation then returns or raises whatever is " +"returned or raised by the ``__missing__(key)`` call. No other operations or " +"methods invoke :meth:`__missing__`. If :meth:`__missing__` is not defined, :" +"exc:`KeyError` is raised. :meth:`__missing__` must be a method; it cannot be " +"an instance variable::" +msgstr "" + +#: library/stdtypes.rst:2066 +msgid "" +"The example above shows part of the implementation of :class:`collections." +"Counter`. A different ``__missing__`` method is used by :class:`collections." +"defaultdict`." +msgstr "" + +#: library/stdtypes.rst:2070 +msgid "Recognition of __missing__ methods of dict subclasses." +msgstr "" + +#: library/stdtypes.rst:2075 msgid "Set ``d[key]`` to *value*." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2051 +#: library/stdtypes.rst:2079 msgid "" "Remove ``d[key]`` from *d*. Raises a :exc:`KeyError` if *key* is not in the " "map." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2056 +#: library/stdtypes.rst:2084 msgid "Return ``True`` if *d* has a key *key*, else ``False``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2062 +#: library/stdtypes.rst:2090 msgid "Equivalent to ``not key in d``." msgstr "" # 52d992597619429fb0c3a22d5d9826bf -#: ../src/Doc/library/stdtypes.rst:2068 +#: library/stdtypes.rst:2096 msgid "" "Return an iterator over the keys of the dictionary. This is a shortcut for :" "meth:`iterkeys`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2073 +#: library/stdtypes.rst:2101 msgid "Remove all items from the dictionary." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2077 +#: library/stdtypes.rst:2105 msgid "Return a shallow copy of the dictionary." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2081 +#: library/stdtypes.rst:2109 msgid "Create a new dictionary with keys from *seq* and values set to *value*." msgstr "" # 2e132f5747194cc685389819fcf62e55 -#: ../src/Doc/library/stdtypes.rst:2083 +#: library/stdtypes.rst:2111 msgid "" ":func:`fromkeys` is a class method that returns a new dictionary. *value* " "defaults to ``None``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2090 +#: library/stdtypes.rst:2118 msgid "" "Return the value for *key* if *key* is in the dictionary, else *default*. If " "*default* is not given, it defaults to ``None``, so that this method never " @@ -96687,19 +98720,19 @@ msgid "" msgstr "" # 30d2806574ca49cd86643d2df42ca2d6 -#: ../src/Doc/library/stdtypes.rst:2096 +#: library/stdtypes.rst:2124 msgid "" "Test for the presence of *key* in the dictionary. :meth:`has_key` is " "deprecated in favor of ``key in d``." msgstr "" # 692e8688fcb449749a920a2f5ac2314c -#: ../src/Doc/library/stdtypes.rst:2101 +#: library/stdtypes.rst:2129 msgid "Return a copy of the dictionary's list of ``(key, value)`` pairs." msgstr "" # 64ac43b53c52450dae6baee73b20ec90 -#: ../src/Doc/library/stdtypes.rst:2105 +#: library/stdtypes.rst:2133 msgid "" "Keys and values are listed in an arbitrary order which is non-random, varies " "across Python implementations, and depends on the dictionary's history of " @@ -96707,7 +98740,7 @@ msgid "" msgstr "" # cf434d917b134bef9c46835d7e7a1914 -#: ../src/Doc/library/stdtypes.rst:2109 +#: library/stdtypes.rst:2137 msgid "" "If :meth:`items`, :meth:`keys`, :meth:`values`, :meth:`iteritems`, :meth:" "`iterkeys`, and :meth:`itervalues` are called with no intervening " @@ -96720,88 +98753,88 @@ msgid "" msgstr "" # e8ae3e5ae8774381ad9fe7fd39260660 -#: ../src/Doc/library/stdtypes.rst:2121 +#: library/stdtypes.rst:2149 msgid "" "Return an iterator over the dictionary's ``(key, value)`` pairs. See the " "note for :meth:`dict.items`." msgstr "" # 36881f6b356647afac486c026d908b75 -#: ../src/Doc/library/stdtypes.rst:2124 +#: library/stdtypes.rst:2152 msgid "" "Using :meth:`iteritems` while adding or deleting entries in the dictionary " "may raise a :exc:`RuntimeError` or fail to iterate over all entries." msgstr "" # a1e124fb92d9423a8a5a90486995066f -#: ../src/Doc/library/stdtypes.rst:2131 +#: library/stdtypes.rst:2159 msgid "" "Return an iterator over the dictionary's keys. See the note for :meth:`dict." "items`." msgstr "" # a22284c8865f4e068a24fdb171694e90 -#: ../src/Doc/library/stdtypes.rst:2134 +#: library/stdtypes.rst:2162 msgid "" "Using :meth:`iterkeys` while adding or deleting entries in the dictionary " "may raise a :exc:`RuntimeError` or fail to iterate over all entries." msgstr "" # 124446b9eb0c4fc1b009310656818b9d -#: ../src/Doc/library/stdtypes.rst:2141 +#: library/stdtypes.rst:2169 msgid "" "Return an iterator over the dictionary's values. See the note for :meth:" "`dict.items`." msgstr "" # 403cd204079f412eb3934449c6e4ffda -#: ../src/Doc/library/stdtypes.rst:2144 +#: library/stdtypes.rst:2172 msgid "" "Using :meth:`itervalues` while adding or deleting entries in the dictionary " "may raise a :exc:`RuntimeError` or fail to iterate over all entries." msgstr "" # 9018dd4be1104c2ba3cc08bbf4a6d3b8 -#: ../src/Doc/library/stdtypes.rst:2152 +#: library/stdtypes.rst:2180 msgid "" "Return a copy of the dictionary's list of keys. See the note for :meth:" "`dict.items`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2157 +#: library/stdtypes.rst:2185 msgid "" "If *key* is in the dictionary, remove it and return its value, else return " "*default*. If *default* is not given and *key* is not in the dictionary, a :" "exc:`KeyError` is raised." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2165 +#: library/stdtypes.rst:2193 msgid "" "Remove and return an arbitrary ``(key, value)`` pair from the dictionary." msgstr "" # bbc7d8b34b0c4462a77440d536ec8580 -#: ../src/Doc/library/stdtypes.rst:2167 +#: library/stdtypes.rst:2195 msgid "" ":func:`popitem` is useful to destructively iterate over a dictionary, as " "often used in set algorithms. If the dictionary is empty, calling :func:" "`popitem` raises a :exc:`KeyError`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2173 +#: library/stdtypes.rst:2201 msgid "" "If *key* is in the dictionary, return its value. If not, insert *key* with " "a value of *default* and return *default*. *default* defaults to ``None``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2179 +#: library/stdtypes.rst:2207 msgid "" "Update the dictionary with the key/value pairs from *other*, overwriting " "existing keys. Return ``None``." msgstr "" # 22638ceb95264c76bcf1440b04d1d165 -#: ../src/Doc/library/stdtypes.rst:2182 +#: library/stdtypes.rst:2210 msgid "" ":func:`update` accepts either another dictionary object or an iterable of " "key/value pairs (as tuples or other iterables of length two). If keyword " @@ -96809,37 +98842,49 @@ msgid "" "pairs: ``d.update(red=1, blue=2)``." msgstr "" +#: library/stdtypes.rst:2215 +msgid "" +"Allowed the argument to be an iterable of key/value pairs and allowed " +"keyword arguments." +msgstr "" + # c3b9695b665544049e6f66f5ec1be143 -#: ../src/Doc/library/stdtypes.rst:2193 +#: library/stdtypes.rst:2221 msgid "" "Return a copy of the dictionary's list of values. See the note for :meth:" "`dict.items`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2198 +#: library/stdtypes.rst:2226 msgid "" "Return a new view of the dictionary's items (``(key, value)`` pairs). See " "below for documentation of view objects." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2205 +#: library/stdtypes.rst:2233 msgid "" "Return a new view of the dictionary's keys. See below for documentation of " "view objects." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2212 +#: library/stdtypes.rst:2240 msgid "" "Return a new view of the dictionary's values. See below for documentation " "of view objects." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2221 +#: library/stdtypes.rst:2245 +msgid "" +"Dictionaries compare equal if and only if they have the same ``(key, " +"value)`` pairs." +msgstr "" + +#: library/stdtypes.rst:2252 msgid "Dictionary view objects" msgstr "" # 5703ddf17653435fb449868fc834198a -#: ../src/Doc/library/stdtypes.rst:2223 +#: library/stdtypes.rst:2254 msgid "" "The objects returned by :meth:`dict.viewkeys`, :meth:`dict.viewvalues` and :" "meth:`dict.viewitems` are *view objects*. They provide a dynamic view on " @@ -96847,23 +98892,23 @@ msgid "" "view reflects these changes." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2228 +#: library/stdtypes.rst:2259 msgid "" "Dictionary views can be iterated over to yield their respective data, and " "support membership tests:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2233 +#: library/stdtypes.rst:2264 msgid "Return the number of entries in the dictionary." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2237 +#: library/stdtypes.rst:2268 msgid "" "Return an iterator over the keys, values or items (represented as tuples of " "``(key, value)``) in the dictionary." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2240 +#: library/stdtypes.rst:2271 msgid "" "Keys and values are iterated over in an arbitrary order which is non-random, " "varies across Python implementations, and depends on the dictionary's " @@ -96875,19 +98920,19 @@ msgid "" "items()]``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2248 +#: library/stdtypes.rst:2279 msgid "" "Iterating views while adding or deleting entries in the dictionary may raise " "a :exc:`RuntimeError` or fail to iterate over all entries." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2253 +#: library/stdtypes.rst:2284 msgid "" "Return ``True`` if *x* is in the underlying dictionary's keys, values or " "items (in the latter case, *x* should be a ``(key, value)`` tuple)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2257 +#: library/stdtypes.rst:2288 msgid "" "Keys views are set-like since their entries are unique and hashable. If all " "values are hashable, so that (key, value) pairs are unique and hashable, " @@ -96896,38 +98941,38 @@ msgid "" "are available (\"other\" refers either to another view or a set):" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2265 +#: library/stdtypes.rst:2296 msgid "" "Return the intersection of the dictview and the other object as a new set." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2269 +#: library/stdtypes.rst:2300 msgid "Return the union of the dictview and the other object as a new set." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2273 +#: library/stdtypes.rst:2304 msgid "" "Return the difference between the dictview and the other object (all " "elements in *dictview* that aren't in *other*) as a new set." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2278 +#: library/stdtypes.rst:2309 msgid "" "Return the symmetric difference (all elements either in *dictview* or " "*other*, but not in both) of the dictview and the other object as a new set." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2282 +#: library/stdtypes.rst:2313 msgid "An example of dictionary view usage::" msgstr "" # ab9340ed4dee4e66aec8e3abe1a9bbce -#: ../src/Doc/library/stdtypes.rst:2315 +#: library/stdtypes.rst:2346 msgid "File Objects" msgstr "Objets fichiers" # c7372abb942a4c7db9614f2aa4c1b4aa -#: ../src/Doc/library/stdtypes.rst:2323 +#: library/stdtypes.rst:2354 msgid "" "File objects are implemented using C's ``stdio`` package and can be created " "with the built-in :func:`open` function. File objects are also returned by " @@ -96939,7 +98984,7 @@ msgid "" msgstr "" # f77a7c7fd8c7442cb31c3dd8e0c2644f -#: ../src/Doc/library/stdtypes.rst:2332 +#: library/stdtypes.rst:2363 msgid "" "When a file operation fails for an I/O-related reason, the exception :exc:" "`IOError` is raised. This includes situations where the operation is not " @@ -96948,12 +98993,12 @@ msgid "" msgstr "" # dc0c4065c95c4a2aa7ff3f59fe9cb15b -#: ../src/Doc/library/stdtypes.rst:2337 +#: library/stdtypes.rst:2368 msgid "Files have the following methods:" msgstr "" # ddf475f549234b2994579e8249c49697 -#: ../src/Doc/library/stdtypes.rst:2342 +#: library/stdtypes.rst:2373 msgid "" "Close the file. A closed file cannot be read or written any more. Any " "operation which requires that the file be open will raise a :exc:" @@ -96962,7 +99007,7 @@ msgid "" msgstr "" # baccc66716234d42b51671b3c6af9108 -#: ../src/Doc/library/stdtypes.rst:2346 +#: library/stdtypes.rst:2377 msgid "" "As of Python 2.5, you can avoid having to call this method explicitly if you " "use the :keyword:`with` statement. For example, the following code will " @@ -96970,14 +99015,14 @@ msgid "" msgstr "" # a0b62cfb5baf4753abc5afc0240674c0 -#: ../src/Doc/library/stdtypes.rst:2356 +#: library/stdtypes.rst:2387 msgid "" "In older versions of Python, you would have needed to do this to get the " "same effect::" msgstr "" # 36fd84e2a671416f920fd38e7b9addb8 -#: ../src/Doc/library/stdtypes.rst:2368 +#: library/stdtypes.rst:2399 msgid "" "Not all \"file-like\" types in Python support use as a context manager for " "the :keyword:`with` statement. If your code is intended to work with any " @@ -96986,21 +99031,21 @@ msgid "" msgstr "" # 077e39ee57e642b483d93c77691a6057 -#: ../src/Doc/library/stdtypes.rst:2376 +#: library/stdtypes.rst:2407 msgid "" "Flush the internal buffer, like ``stdio``'s :c:func:`fflush`. This may be a " "no-op on some file-like objects." msgstr "" # 0319a8d9f09e4c6295a016efb613a474 -#: ../src/Doc/library/stdtypes.rst:2381 +#: library/stdtypes.rst:2412 msgid "" ":meth:`flush` does not necessarily write the file's data to disk. Use :meth:" "`flush` followed by :func:`os.fsync` to ensure this behavior." msgstr "" # eae169f6428e4efda150eb6e72861cd4 -#: ../src/Doc/library/stdtypes.rst:2391 +#: library/stdtypes.rst:2422 msgid "" "Return the integer \"file descriptor\" that is used by the underlying " "implementation to request I/O operations from the operating system. This " @@ -97009,28 +99054,28 @@ msgid "" msgstr "" # a515f4ac03f24ecb931280ee692281db -#: ../src/Doc/library/stdtypes.rst:2398 +#: library/stdtypes.rst:2429 msgid "" "File-like objects which do not have a real file descriptor should *not* " "provide this method!" msgstr "" # 0169960ab8c64aa5942f53af6d7ff2c2 -#: ../src/Doc/library/stdtypes.rst:2404 +#: library/stdtypes.rst:2435 msgid "" "Return ``True`` if the file is connected to a tty(-like) device, else " "``False``." msgstr "" # c81671cde05c429ea2419f755cc86fd1 -#: ../src/Doc/library/stdtypes.rst:2408 +#: library/stdtypes.rst:2439 msgid "" "If a file-like object is not associated with a real file, this method should " "*not* be implemented." msgstr "" # f6474469bdc8473f9d627ec8fe2622e3 -#: ../src/Doc/library/stdtypes.rst:2414 +#: library/stdtypes.rst:2445 msgid "" "A file object is its own iterator, for example ``iter(f)`` returns *f* " "(unless *f* is closed). When a file is used as an iterator, typically in a :" @@ -97048,7 +99093,7 @@ msgid "" msgstr "" # 0046e6ee5a9d4281bfbc8ddee8f001b0 -#: ../src/Doc/library/stdtypes.rst:2432 +#: library/stdtypes.rst:2463 msgid "" "Read at most *size* bytes from the file (less if the read hits EOF before " "obtaining *size* bytes). If the *size* argument is negative or omitted, " @@ -97062,7 +99107,7 @@ msgid "" msgstr "" # ec185d0f13924d77a0f7a34b154692db -#: ../src/Doc/library/stdtypes.rst:2443 +#: library/stdtypes.rst:2474 msgid "" "This function is simply a wrapper for the underlying :c:func:`fread` C " "function, and will behave the same in corner cases, such as whether the EOF " @@ -97070,7 +99115,7 @@ msgid "" msgstr "" # 2af5c482e99146cbba88816443dd4dff -#: ../src/Doc/library/stdtypes.rst:2450 +#: library/stdtypes.rst:2481 msgid "" "Read one entire line from the file. A trailing newline character is kept in " "the string (but may be absent when a file ends with an incomplete line). " @@ -97081,14 +99126,14 @@ msgid "" msgstr "" # 6bb7c9924aa242119ac4e778193dec81 -#: ../src/Doc/library/stdtypes.rst:2459 +#: library/stdtypes.rst:2490 msgid "" "Unlike ``stdio``'s :c:func:`fgets`, the returned string contains null " "characters (``'\\0'``) if they occurred in the input." msgstr "" # 54419b200b9a4ae5ac62737504f7384e -#: ../src/Doc/library/stdtypes.rst:2465 +#: library/stdtypes.rst:2496 msgid "" "Read until EOF using :meth:`~file.readline` and return a list containing the " "lines thus read. If the optional *sizehint* argument is present, instead of " @@ -97099,12 +99144,16 @@ msgid "" msgstr "" # e86f332049bb45ebb9d407f2c859d0f5 -#: ../src/Doc/library/stdtypes.rst:2475 +#: library/stdtypes.rst:2506 msgid "This method returns the same thing as ``iter(f)``." msgstr "" +#: library/stdtypes.rst:2510 +msgid "Use ``for line in file`` instead." +msgstr "" + # 6d5fe8bcf0f24a9487fb46a535197ca8 -#: ../src/Doc/library/stdtypes.rst:2485 +#: library/stdtypes.rst:2516 msgid "" "Set the file's current position, like ``stdio``'s :c:func:`fseek`. The " "*whence* argument is optional and defaults to ``os.SEEK_SET`` or ``0`` " @@ -97114,14 +99163,14 @@ msgid "" msgstr "" # 56216de01e6b4ac890dd7f970c0170c1 -#: ../src/Doc/library/stdtypes.rst:2491 +#: library/stdtypes.rst:2522 msgid "" "For example, ``f.seek(2, os.SEEK_CUR)`` advances the position by two and ``f." "seek(-3, os.SEEK_END)`` sets the position to the third to last." msgstr "" # d4d8d93b7d174fb5bf269ef6586c5627 -#: ../src/Doc/library/stdtypes.rst:2494 +#: library/stdtypes.rst:2525 msgid "" "Note that if the file is opened for appending (mode ``'a'`` or ``'a+'``), " "any :meth:`seek` operations will be undone at the next write. If the file " @@ -97133,17 +99182,21 @@ msgid "" msgstr "" # 7caea89004f5418e85347bfffcff2a16 -#: ../src/Doc/library/stdtypes.rst:2502 +#: library/stdtypes.rst:2533 msgid "Note that not all file objects are seekable." msgstr "" +#: library/stdtypes.rst:2535 +msgid "Passing float values as offset has been deprecated." +msgstr "" + # 05ebea3a33a34d5a8f645bc82b97da67 -#: ../src/Doc/library/stdtypes.rst:2510 +#: library/stdtypes.rst:2541 msgid "Return the file's current position, like ``stdio``'s :c:func:`ftell`." msgstr "" # dbbed00882044adf9cbf0005c13ca0b3 -#: ../src/Doc/library/stdtypes.rst:2514 +#: library/stdtypes.rst:2545 msgid "" "On Windows, :meth:`tell` can return illegal values (after an :c:func:" "`fgets`) when reading files with Unix-style line-endings. Use binary mode " @@ -97151,7 +99204,7 @@ msgid "" msgstr "" # a0606584f46c40e58b3658cf783f87a6 -#: ../src/Doc/library/stdtypes.rst:2521 +#: library/stdtypes.rst:2552 msgid "" "Truncate the file's size. If the optional *size* argument is present, the " "file is truncated to (at most) that size. The size defaults to the current " @@ -97164,7 +99217,7 @@ msgid "" msgstr "" # 411985b0d66548f2b734af2ff2de3f72 -#: ../src/Doc/library/stdtypes.rst:2532 +#: library/stdtypes.rst:2563 msgid "" "Write a string to the file. There is no return value. Due to buffering, " "the string may not actually show up in the file until the :meth:`flush` or :" @@ -97172,7 +99225,7 @@ msgid "" msgstr "" # 6781636e32d3460998d5ab5b94b0933c -#: ../src/Doc/library/stdtypes.rst:2539 +#: library/stdtypes.rst:2570 msgid "" "Write a sequence of strings to the file. The sequence can be any iterable " "object producing strings, typically a list of strings. There is no return " @@ -97181,7 +99234,7 @@ msgid "" msgstr "" # 1717c1759c2d402cad1fa45ce63bac2a -#: ../src/Doc/library/stdtypes.rst:2544 +#: library/stdtypes.rst:2575 msgid "" "Files support the iterator protocol. Each iteration returns the same result " "as :meth:`~file.readline`, and iteration ends when the :meth:`~file." @@ -97189,7 +99242,7 @@ msgid "" msgstr "" # 7800bdd19ca24945bd8207f66e691577 -#: ../src/Doc/library/stdtypes.rst:2548 +#: library/stdtypes.rst:2579 msgid "" "File objects also offer a number of other interesting attributes. These are " "not required for file-like objects, but should be implemented if they make " @@ -97197,7 +99250,7 @@ msgid "" msgstr "" # 376f85f412394347a40ce3161eef4d2f -#: ../src/Doc/library/stdtypes.rst:2555 +#: library/stdtypes.rst:2586 msgid "" "bool indicating the current state of the file object. This is a read-only " "attribute; the :meth:`close` method changes the value. It may not be " @@ -97205,7 +99258,7 @@ msgid "" msgstr "" # 153276d13dce4576beebd86f2f5b00f7 -#: ../src/Doc/library/stdtypes.rst:2562 +#: library/stdtypes.rst:2593 msgid "" "The encoding that this file uses. When Unicode strings are written to a " "file, they will be converted to byte strings using this encoding. In " @@ -97218,12 +99271,12 @@ msgid "" msgstr "" # da509f687b3943afa6c07bfff2f3fa7f -#: ../src/Doc/library/stdtypes.rst:2575 +#: library/stdtypes.rst:2606 msgid "The Unicode error handler used along with the encoding." msgstr "" # fa4fc5efe1e34c2eaf10d8c30c77cac2 -#: ../src/Doc/library/stdtypes.rst:2582 +#: library/stdtypes.rst:2613 msgid "" "The I/O mode for the file. If the file was created using the :func:`open` " "built-in function, this will be the value of the *mode* parameter. This is " @@ -97231,7 +99284,7 @@ msgid "" msgstr "" # e0667c9e296140ca810e4b9cd3355970 -#: ../src/Doc/library/stdtypes.rst:2589 +#: library/stdtypes.rst:2620 msgid "" "If the file object was created using :func:`open`, the name of the file. " "Otherwise, some string that indicates the source of the file object, of the " @@ -97240,7 +99293,7 @@ msgid "" msgstr "" # 121d782dd09842ca987d19ed84ac41b9 -#: ../src/Doc/library/stdtypes.rst:2600 +#: library/stdtypes.rst:2631 msgid "" "If Python was built with :term:`universal newlines` enabled (the default) " "this read-only attribute exists, and for files opened in universal newline " @@ -97253,7 +99306,7 @@ msgid "" msgstr "" # b17e7ad2183f4500be70942d1344aa03 -#: ../src/Doc/library/stdtypes.rst:2612 +#: library/stdtypes.rst:2643 msgid "" "Boolean that indicates whether a space character needs to be printed before " "another value when using the :keyword:`print` statement. Classes that are " @@ -97265,18 +99318,18 @@ msgid "" msgstr "" # 6d4e2dedaabd4e73b51ec7b4f68d95ca -#: ../src/Doc/library/stdtypes.rst:2622 +#: library/stdtypes.rst:2653 msgid "" "This attribute is not used to control the :keyword:`print` statement, but to " "allow the implementation of :keyword:`print` to keep track of its internal " "state." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2630 +#: library/stdtypes.rst:2661 msgid "memoryview type" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2634 +#: library/stdtypes.rst:2665 msgid "" ":class:`memoryview` objects allow Python code to access the internal data of " "an object that supports the buffer protocol without copying. Memory is " @@ -97284,7 +99337,7 @@ msgid "" msgstr "" # 6c903fbcefea47a29357d2dad55033ce -#: ../src/Doc/library/stdtypes.rst:2640 +#: library/stdtypes.rst:2671 msgid "" "Create a :class:`memoryview` that references *obj*. *obj* must support the " "buffer protocol. Built-in objects that support the buffer protocol include :" @@ -97292,7 +99345,7 @@ msgid "" msgstr "" # d47bdbcd80a948faa18413e516ba29c6 -#: ../src/Doc/library/stdtypes.rst:2644 +#: library/stdtypes.rst:2675 msgid "" "A :class:`memoryview` has the notion of an *element*, which is the atomic " "memory unit handled by the originating object *obj*. For many simple types " @@ -97301,7 +99354,7 @@ msgid "" msgstr "" # 93bb2a0607f942589c7654a54b792ed0 -#: ../src/Doc/library/stdtypes.rst:2649 +#: library/stdtypes.rst:2680 msgid "" "``len(view)`` returns the total number of elements in the memoryview, " "*view*. The :class:`~memoryview.itemsize` attribute will give you the " @@ -97309,7 +99362,7 @@ msgid "" msgstr "" # e94e64753b54401aa3515c384a7867ec -#: ../src/Doc/library/stdtypes.rst:2653 +#: library/stdtypes.rst:2684 msgid "" "A :class:`memoryview` supports slicing to expose its data. Taking a single " "index will return a single element as a :class:`str` object. Full slicing " @@ -97317,73 +99370,73 @@ msgid "" msgstr "" # dafb7a441cde42569081bdff3339e514 -#: ../src/Doc/library/stdtypes.rst:2667 +#: library/stdtypes.rst:2698 msgid "" "If the object the memoryview is over supports changing its data, the " "memoryview supports slice assignment::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2685 +#: library/stdtypes.rst:2716 msgid "Notice how the size of the memoryview object cannot be changed." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2687 +#: library/stdtypes.rst:2718 msgid ":class:`memoryview` has two methods:" msgstr "" # 4290e3f48fef4963a66644a825e74901 -#: ../src/Doc/library/stdtypes.rst:2691 +#: library/stdtypes.rst:2722 msgid "" "Return the data in the buffer as a bytestring (an object of class :class:" "`str`). ::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2700 +#: library/stdtypes.rst:2731 msgid "Return the data in the buffer as a list of integers. ::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2705 +#: library/stdtypes.rst:2736 msgid "There are also several readonly attributes available:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2709 +#: library/stdtypes.rst:2740 msgid "" "A string containing the format (in :mod:`struct` module style) for each " "element in the view. This defaults to ``'B'``, a simple bytestring." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2714 +#: library/stdtypes.rst:2745 msgid "The size in bytes of each element of the memoryview." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2718 +#: library/stdtypes.rst:2749 msgid "" "A tuple of integers the length of :attr:`ndim` giving the shape of the " "memory as a N-dimensional array." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2723 +#: library/stdtypes.rst:2754 msgid "" "An integer indicating how many dimensions of a multi-dimensional array the " "memory represents." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2728 +#: library/stdtypes.rst:2759 msgid "" "A tuple of integers the length of :attr:`ndim` giving the size in bytes to " "access each element for each dimension of the array." msgstr "" # 50dcac9963b2436490c7b6795d3b661a -#: ../src/Doc/library/stdtypes.rst:2733 +#: library/stdtypes.rst:2764 msgid "A bool indicating whether the memory is read only." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2741 +#: library/stdtypes.rst:2772 msgid "Context Manager Types" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2750 +#: library/stdtypes.rst:2781 msgid "" "Python's :keyword:`with` statement supports the concept of a runtime context " "defined by a context manager. This is implemented using two separate " @@ -97392,13 +99445,13 @@ msgid "" "ends." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2755 +#: library/stdtypes.rst:2786 msgid "" "The :dfn:`context management protocol` consists of a pair of methods that " "need to be provided for a context manager object to define a runtime context:" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2761 +#: library/stdtypes.rst:2792 msgid "" "Enter the runtime context and return either this object or another object " "related to the runtime context. The value returned by this method is bound " @@ -97406,14 +99459,14 @@ msgid "" "using this context manager." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2766 +#: library/stdtypes.rst:2797 msgid "" "An example of a context manager that returns itself is a file object. File " "objects return themselves from __enter__() to allow :func:`open` to be used " "as the context expression in a :keyword:`with` statement." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2770 +#: library/stdtypes.rst:2801 msgid "" "An example of a context manager that returns a related object is the one " "returned by :func:`decimal.localcontext`. These managers set the active " @@ -97423,7 +99476,7 @@ msgid "" "the :keyword:`with` statement." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2780 +#: library/stdtypes.rst:2811 msgid "" "Exit the runtime context and return a Boolean flag indicating if any " "exception that occurred should be suppressed. If an exception occurred while " @@ -97432,7 +99485,7 @@ msgid "" "arguments are ``None``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2785 +#: library/stdtypes.rst:2816 msgid "" "Returning a true value from this method will cause the :keyword:`with` " "statement to suppress the exception and continue execution with the " @@ -97442,7 +99495,7 @@ msgid "" "exception that occurred in the body of the :keyword:`with` statement." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2792 +#: library/stdtypes.rst:2823 msgid "" "The exception passed in should never be reraised explicitly - instead, this " "method should return a false value to indicate that the method completed " @@ -97451,7 +99504,7 @@ msgid "" "whether or not an :meth:`__exit__` method has actually failed." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2798 +#: library/stdtypes.rst:2829 msgid "" "Python defines several context managers to support easy thread " "synchronisation, prompt closure of files or other objects, and simpler " @@ -97460,7 +99513,7 @@ msgid "" "management protocol. See the :mod:`contextlib` module for some examples." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2804 +#: library/stdtypes.rst:2835 msgid "" "Python's :term:`generator`\\s and the ``contextlib.contextmanager`` :term:" "`decorator` provide a convenient way to implement these protocols. If a " @@ -97470,7 +99523,7 @@ msgid "" "by an undecorated generator function." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2811 +#: library/stdtypes.rst:2842 msgid "" "Note that there is no specific slot for any of these methods in the type " "structure for Python objects in the Python/C API. Extension types wanting to " @@ -97479,21 +99532,21 @@ msgid "" "a single class dictionary lookup is negligible." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2821 +#: library/stdtypes.rst:2852 msgid "Other Built-in Types" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2823 +#: library/stdtypes.rst:2854 msgid "" "The interpreter supports several other kinds of objects. Most of these " "support only one or two operations." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2830 +#: library/stdtypes.rst:2861 msgid "Modules" msgstr "Modules" -#: ../src/Doc/library/stdtypes.rst:2832 +#: library/stdtypes.rst:2863 msgid "" "The only special operation on a module is attribute access: ``m.name``, " "where *m* is a module and *name* accesses a name defined in *m*'s symbol " @@ -97505,7 +99558,7 @@ msgid "" msgstr "" # 9477f29feada4f9f951fe8ff1fa4cf50 -#: ../src/Doc/library/stdtypes.rst:2839 +#: library/stdtypes.rst:2870 msgid "" "A special attribute of every module is :attr:`~object.__dict__`. This is the " "dictionary containing the module's symbol table. Modifying this dictionary " @@ -97516,28 +99569,28 @@ msgid "" "recommended." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2846 +#: library/stdtypes.rst:2877 msgid "" "Modules built into the interpreter are written like this: ``<module " "'sys' (built-in)>``. If loaded from a file, they are written as ``<module " "'os' from '/usr/local/lib/pythonX.Y/os.pyc'>``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2854 +#: library/stdtypes.rst:2885 msgid "Classes and Class Instances" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2856 +#: library/stdtypes.rst:2887 msgid "See :ref:`objects` and :ref:`class` for these." msgstr "Voir :ref:`objets` et :ref:`classe`." -#: ../src/Doc/library/stdtypes.rst:2864 +#: library/stdtypes.rst:2895 msgid "" "Function objects are created by function definitions. The only operation on " "a function object is to call it: ``func(argument-list)``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2867 +#: library/stdtypes.rst:2898 msgid "" "There are really two flavors of function objects: built-in functions and " "user-defined functions. Both support the same operation (to call the " @@ -97545,15 +99598,15 @@ msgid "" "types." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2871 +#: library/stdtypes.rst:2902 msgid "See :ref:`function` for more information." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2877 +#: library/stdtypes.rst:2908 msgid "Methods" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2881 +#: library/stdtypes.rst:2912 msgid "" "Methods are functions that are called using the attribute notation. There " "are two flavors: built-in methods (such as :meth:`append` on lists) and " @@ -97562,7 +99615,7 @@ msgid "" msgstr "" # b593494ce7e949909d88afe611793691 -#: ../src/Doc/library/stdtypes.rst:2886 +#: library/stdtypes.rst:2917 msgid "" "The implementation adds two special read-only attributes to class instance " "methods: ``m.im_self`` is the object on which the method operates, and ``m." @@ -97572,7 +99625,7 @@ msgid "" msgstr "" # 13d92a1f54e24929ba8966a8f2daad7b -#: ../src/Doc/library/stdtypes.rst:2892 +#: library/stdtypes.rst:2923 msgid "" "Class instance methods are either *bound* or *unbound*, referring to whether " "the method was accessed through an instance or a class, respectively. When " @@ -97583,7 +99636,7 @@ msgid "" msgstr "" # 2a14d4e9f86943b4b494794eaaad4df7 -#: ../src/Doc/library/stdtypes.rst:2899 +#: library/stdtypes.rst:2930 msgid "" "Like function objects, methods objects support getting arbitrary attributes. " "However, since method attributes are actually stored on the underlying " @@ -97594,16 +99647,16 @@ msgid "" "object::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2920 ../src/Doc/library/stdtypes.rst:2948 +#: library/stdtypes.rst:2951 library/stdtypes.rst:2979 msgid "See :ref:`types` for more information." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2926 +#: library/stdtypes.rst:2957 msgid "Code Objects" msgstr "Objets Code" # 3a064aabe83543d6ad9abecad71f3976 -#: ../src/Doc/library/stdtypes.rst:2934 +#: library/stdtypes.rst:2965 msgid "" "Code objects are used by the implementation to represent \"pseudo-compiled\" " "executable Python code such as a function body. They differ from function " @@ -97614,18 +99667,18 @@ msgid "" msgstr "" # 76492b993b3d4c16b6fd5c54baa5679b -#: ../src/Doc/library/stdtypes.rst:2945 +#: library/stdtypes.rst:2976 msgid "" "A code object can be executed or evaluated by passing it (instead of a " "source string) to the :keyword:`exec` statement or the built-in :func:`eval` " "function." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2954 +#: library/stdtypes.rst:2985 msgid "Type Objects" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2960 +#: library/stdtypes.rst:2991 msgid "" "Type objects represent the various object types. An object's type is " "accessed by the built-in function :func:`type`. There are no special " @@ -97634,31 +99687,31 @@ msgid "" msgstr "" # f8494e3833ab41b8895e1d9f005b00c3 -#: ../src/Doc/library/stdtypes.rst:2965 +#: library/stdtypes.rst:2996 msgid "Types are written like this: ``<type 'int'>``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2971 +#: library/stdtypes.rst:3002 msgid "The Null Object" msgstr "" -#: ../src/Doc/library/stdtypes.rst:2973 +#: library/stdtypes.rst:3004 msgid "" "This object is returned by functions that don't explicitly return a value. " "It supports no special operations. There is exactly one null object, named " "``None`` (a built-in name)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2977 +#: library/stdtypes.rst:3008 msgid "It is written as ``None``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:2983 +#: library/stdtypes.rst:3014 msgid "The Ellipsis Object" msgstr "" # c9a86b0abd174a99a8f710c03e6b5e0f -#: ../src/Doc/library/stdtypes.rst:2985 +#: library/stdtypes.rst:3016 msgid "" "This object is used by extended slice notation (see :ref:`slicings`). It " "supports no special operations. There is exactly one ellipsis object, " @@ -97666,19 +99719,19 @@ msgid "" msgstr "" # d0f8b42f69814542a85c7ed514f29ba9 -#: ../src/Doc/library/stdtypes.rst:2989 +#: library/stdtypes.rst:3020 msgid "" "It is written as ``Ellipsis``. When in a subscript, it can also be written " "as ``...``, for example ``seq[...]``." msgstr "" # 44212b32f6ed41e9b400ba2f13b87195 -#: ../src/Doc/library/stdtypes.rst:2994 +#: library/stdtypes.rst:3025 msgid "The NotImplemented Object" msgstr "" # 2b11899a70354fea962400500860463d -#: ../src/Doc/library/stdtypes.rst:2996 +#: library/stdtypes.rst:3027 msgid "" "This object is returned from comparisons and binary operations when they are " "asked to operate on types they don't support. See :ref:`comparisons` for " @@ -97686,16 +99739,16 @@ msgid "" msgstr "" # 6ae229d2bba64af6a7981dc9a8a1012e -#: ../src/Doc/library/stdtypes.rst:3000 +#: library/stdtypes.rst:3031 msgid "It is written as ``NotImplemented``." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3004 +#: library/stdtypes.rst:3035 msgid "Boolean Values" msgstr "" # ac9ee11456d84a2690f56f8062fc203a -#: ../src/Doc/library/stdtypes.rst:3006 +#: library/stdtypes.rst:3037 msgid "" "Boolean values are the two constant objects ``False`` and ``True``. They " "are used to represent truth values (although other values can also be " @@ -97706,107 +99759,113 @@ msgid "" "(see section :ref:`truth` above)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3019 +#: library/stdtypes.rst:3050 msgid "They are written as ``False`` and ``True``, respectively." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3025 +#: library/stdtypes.rst:3056 msgid "Internal Objects" msgstr "" -#: ../src/Doc/library/stdtypes.rst:3027 +#: library/stdtypes.rst:3058 msgid "" "See :ref:`types` for this information. It describes stack frame objects, " "traceback objects, and slice objects." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3034 +#: library/stdtypes.rst:3065 msgid "Special Attributes" msgstr "" -#: ../src/Doc/library/stdtypes.rst:3036 +#: library/stdtypes.rst:3067 msgid "" "The implementation adds a few special read-only attributes to several object " "types, where they are relevant. Some of these are not reported by the :func:" "`dir` built-in function." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3043 +#: library/stdtypes.rst:3074 msgid "" "A dictionary or other mapping object used to store an object's (writable) " "attributes." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3063 +#: library/stdtypes.rst:3080 library/stdtypes.rst:3087 +msgid "" +"Use the built-in function :func:`dir` to get a list of an object's " +"attributes. This attribute is no longer available." +msgstr "" + +#: library/stdtypes.rst:3094 msgid "The class to which a class instance belongs." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3068 +#: library/stdtypes.rst:3099 msgid "The tuple of base classes of a class object." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3073 +#: library/stdtypes.rst:3104 msgid "The name of the class or type." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3076 +#: library/stdtypes.rst:3107 msgid "" "The following attributes are only supported by :term:`new-style class`\\ es." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3080 +#: library/stdtypes.rst:3111 msgid "" "This attribute is a tuple of classes that are considered when looking for " "base classes during method resolution." msgstr "" # ea10454eb2264379a66f07cef6216687 -#: ../src/Doc/library/stdtypes.rst:3086 +#: library/stdtypes.rst:3117 msgid "" "This method can be overridden by a metaclass to customize the method " "resolution order for its instances. It is called at class instantiation, " "and its result is stored in :attr:`~class.__mro__`." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3093 +#: library/stdtypes.rst:3124 msgid "" "Each new-style class keeps a list of weak references to its immediate " "subclasses. This method returns a list of all those references still alive. " "Example::" msgstr "" -#: ../src/Doc/library/stdtypes.rst:3103 +#: library/stdtypes.rst:3134 msgid "" "Additional information on these special methods may be found in the Python " "Reference Manual (:ref:`customization`)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3106 +#: library/stdtypes.rst:3137 msgid "" "As a consequence, the list ``[1, 2]`` is considered equal to ``[1.0, 2.0]``, " "and similarly for tuples." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3109 +#: library/stdtypes.rst:3140 msgid "They must have since the parser can't tell the type of the operands." msgstr "" # bd96b284b8424ac78653985dee68315a -#: ../src/Doc/library/stdtypes.rst:3111 +#: library/stdtypes.rst:3142 msgid "" "Cased characters are those with general category property being one of \"Lu" "\" (Letter, uppercase), \"Ll\" (Letter, lowercase), or \"Lt\" (Letter, " "titlecase)." msgstr "" -#: ../src/Doc/library/stdtypes.rst:3114 +#: library/stdtypes.rst:3145 msgid "" "To format only a tuple you should therefore provide a singleton tuple whose " "only element is the tuple to be formatted." msgstr "" # 84859b871b244cdc95cce28d77c5478a -#: ../src/Doc/library/stdtypes.rst:3117 +#: library/stdtypes.rst:3148 msgid "" "The advantage of leaving the newline on is that returning an empty string is " "then an unambiguous EOF indication. It is also possible (in cases where it " @@ -97815,17 +99874,17 @@ msgid "" "newline or not (yes this happens!)." msgstr "" -#: ../src/Doc/library/string.rst:2 +#: library/string.rst:2 msgid ":mod:`string` --- Common string operations" msgstr "" # 0ef339c383ac4bf8a6896bdecec1e650 -#: ../src/Doc/library/string.rst:10 +#: library/string.rst:10 msgid "**Source code:** :source:`Lib/string.py`" msgstr "" # d5b3f637b7044d318d2a18e411d950ac -#: ../src/Doc/library/string.rst:14 +#: library/string.rst:14 msgid "" "The :mod:`string` module contains a number of useful constants and classes, " "as well as some deprecated legacy functions that are also available as " @@ -97837,39 +99896,39 @@ msgid "" "module for string functions based on regular expressions." msgstr "" -#: ../src/Doc/library/string.rst:25 +#: library/string.rst:25 msgid "String constants" msgstr "" -#: ../src/Doc/library/string.rst:32 +#: library/string.rst:32 msgid "" "The concatenation of the :const:`ascii_lowercase` and :const:" "`ascii_uppercase` constants described below. This value is not locale-" "dependent." msgstr "" -#: ../src/Doc/library/string.rst:38 +#: library/string.rst:38 msgid "" "The lowercase letters ``'abcdefghijklmnopqrstuvwxyz'``. This value is not " "locale-dependent and will not change." msgstr "" -#: ../src/Doc/library/string.rst:44 +#: library/string.rst:44 msgid "" "The uppercase letters ``'ABCDEFGHIJKLMNOPQRSTUVWXYZ'``. This value is not " "locale-dependent and will not change." msgstr "" -#: ../src/Doc/library/string.rst:50 +#: library/string.rst:50 msgid "The string ``'0123456789'``." msgstr "" -#: ../src/Doc/library/string.rst:55 +#: library/string.rst:55 msgid "The string ``'0123456789abcdefABCDEF'``." msgstr "" # 72a5dd4581e1439dbb88c225cc1a276f -#: ../src/Doc/library/string.rst:60 +#: library/string.rst:60 msgid "" "The concatenation of the strings :const:`lowercase` and :const:`uppercase` " "described below. The specific value is locale-dependent, and will be " @@ -97877,7 +99936,7 @@ msgid "" msgstr "" # eb3bc0a7694d4ebe9c81735a78d2199c -#: ../src/Doc/library/string.rst:67 +#: library/string.rst:67 msgid "" "A string containing all the characters that are considered lowercase " "letters. On most systems this is the string " @@ -97885,18 +99944,18 @@ msgid "" "and will be updated when :func:`locale.setlocale` is called." msgstr "" -#: ../src/Doc/library/string.rst:75 +#: library/string.rst:75 msgid "The string ``'01234567'``." msgstr "" -#: ../src/Doc/library/string.rst:80 +#: library/string.rst:80 msgid "" "String of ASCII characters which are considered punctuation characters in " "the ``C`` locale." msgstr "" # e05dda1c77a34dc989cbaa38d0c5b861 -#: ../src/Doc/library/string.rst:86 +#: library/string.rst:86 msgid "" "String of characters which are considered printable. This is a combination " "of :const:`digits`, :const:`letters`, :const:`punctuation`, and :const:" @@ -97904,7 +99963,7 @@ msgid "" msgstr "" # b907e439d0ea4489bdb3e7a399998700 -#: ../src/Doc/library/string.rst:93 +#: library/string.rst:93 msgid "" "A string containing all the characters that are considered uppercase " "letters. On most systems this is the string " @@ -97913,7 +99972,7 @@ msgid "" msgstr "" # 0e9227319fce477ca19b59204faaa1c2 -#: ../src/Doc/library/string.rst:101 +#: library/string.rst:101 msgid "" "A string containing all characters that are considered whitespace. On most " "systems this includes the characters space, tab, linefeed, return, formfeed, " @@ -97921,7 +99980,7 @@ msgid "" msgstr "" # aada308263fd49268b46c9051efb682c -#: ../src/Doc/library/string.rst:113 +#: library/string.rst:113 msgid "" "The built-in str and unicode classes provide the ability to do complex " "variable substitutions and value formatting via the :meth:`str.format` " @@ -97931,12 +99990,12 @@ msgid "" "`format` method." msgstr "" -#: ../src/Doc/library/string.rst:122 +#: library/string.rst:122 msgid "The :class:`Formatter` class has the following public methods:" msgstr "" # 5b88be2d73674a72bc33b1291e1e92a5 -#: ../src/Doc/library/string.rst:126 +#: library/string.rst:126 msgid "" ":meth:`format` is the primary API method. It takes a format string and an " "arbitrary set of positional and keyword arguments. :meth:`format` is just a " @@ -97944,7 +100003,7 @@ msgid "" msgstr "" # fcfc8bcdca8146c79d2f54510c4b17d3 -#: ../src/Doc/library/string.rst:132 +#: library/string.rst:132 msgid "" "This function does the actual work of formatting. It is exposed as a " "separate function for cases where you want to pass in a predefined " @@ -97954,14 +100013,14 @@ msgid "" "and replacement fields. It calls the various methods described below." msgstr "" -#: ../src/Doc/library/string.rst:140 +#: library/string.rst:140 msgid "" "In addition, the :class:`Formatter` defines a number of methods that are " "intended to be replaced by subclasses:" msgstr "" # df8fa7e13e1e41dc9bbe5f9461eaf5e8 -#: ../src/Doc/library/string.rst:145 +#: library/string.rst:145 msgid "" "Loop over the format_string and return an iterable of tuples " "(*literal_text*, *field_name*, *format_spec*, *conversion*). This is used " @@ -97969,7 +100028,7 @@ msgid "" "replacement fields." msgstr "" -#: ../src/Doc/library/string.rst:150 +#: library/string.rst:150 msgid "" "The values in the tuple conceptually represent a span of literal text " "followed by a single replacement field. If there is no literal text (which " @@ -97979,7 +100038,7 @@ msgid "" "be ``None``." msgstr "" -#: ../src/Doc/library/string.rst:159 +#: library/string.rst:159 msgid "" "Given *field_name* as returned by :meth:`parse` (see above), convert it to " "an object to be formatted. Returns a tuple (obj, used_key). The default " @@ -97989,7 +100048,7 @@ msgid "" "*key* parameter to :meth:`get_value`." msgstr "" -#: ../src/Doc/library/string.rst:168 +#: library/string.rst:168 msgid "" "Retrieve a given field value. The *key* argument will be either an integer " "or a string. If it is an integer, it represents the index of the positional " @@ -97997,21 +100056,21 @@ msgid "" "in *kwargs*." msgstr "" -#: ../src/Doc/library/string.rst:173 +#: library/string.rst:173 msgid "" "The *args* parameter is set to the list of positional arguments to :meth:" "`vformat`, and the *kwargs* parameter is set to the dictionary of keyword " "arguments." msgstr "" -#: ../src/Doc/library/string.rst:177 +#: library/string.rst:177 msgid "" "For compound field names, these functions are only called for the first " "component of the field name; Subsequent components are handled through " "normal attribute and indexing operations." msgstr "" -#: ../src/Doc/library/string.rst:181 +#: library/string.rst:181 msgid "" "So for example, the field expression '0.name' would cause :meth:`get_value` " "to be called with a *key* argument of 0. The ``name`` attribute will be " @@ -98019,14 +100078,14 @@ msgid "" "`getattr` function." msgstr "" -#: ../src/Doc/library/string.rst:186 +#: library/string.rst:186 msgid "" "If the index or keyword refers to an item that does not exist, then an :exc:" "`IndexError` or :exc:`KeyError` should be raised." msgstr "" # 428506f633d1470d958e2a3ea37002d8 -#: ../src/Doc/library/string.rst:191 +#: library/string.rst:191 msgid "" "Implement checking for unused arguments if desired. The arguments to this " "function is the set of all argument keys that were actually referred to in " @@ -98036,33 +100095,33 @@ msgid "" "meth:`check_unused_args` is assumed to raise an exception if the check fails." msgstr "" -#: ../src/Doc/library/string.rst:201 +#: library/string.rst:201 msgid "" ":meth:`format_field` simply calls the global :func:`format` built-in. The " "method is provided so that subclasses can override it." msgstr "" # 382a8e976e194803ba18c9f963ba488f -#: ../src/Doc/library/string.rst:206 +#: library/string.rst:206 msgid "" "Converts the value (returned by :meth:`get_field`) given a conversion type " "(as in the tuple returned by the :meth:`parse` method). The default version " "understands 's' (str), 'r' (repr) and 'a' (ascii) conversion types." msgstr "" -#: ../src/Doc/library/string.rst:215 +#: library/string.rst:215 msgid "Format String Syntax" msgstr "" # 8be41ed06ade44368d268be83139994d -#: ../src/Doc/library/string.rst:217 +#: library/string.rst:217 msgid "" "The :meth:`str.format` method and the :class:`Formatter` class share the " "same syntax for format strings (although in the case of :class:`Formatter`, " "subclasses can define their own format string syntax)." msgstr "" -#: ../src/Doc/library/string.rst:221 +#: library/string.rst:221 msgid "" "Format strings contain \"replacement fields\" surrounded by curly braces ``{}" "``. Anything that is not contained in braces is considered literal text, " @@ -98071,11 +100130,11 @@ msgid "" "``." msgstr "" -#: ../src/Doc/library/string.rst:226 +#: library/string.rst:226 msgid "The grammar for a replacement field is as follows:" msgstr "" -#: ../src/Doc/library/string.rst:238 +#: library/string.rst:238 msgid "" "In less formal terms, the replacement field can start with a *field_name* " "that specifies the object whose value is to be formatted and inserted into " @@ -98086,12 +100145,12 @@ msgid "" msgstr "" # 4506ebd32b5e4bf78826e89cb926169c -#: ../src/Doc/library/string.rst:245 +#: library/string.rst:245 msgid "See also the :ref:`formatspec` section." msgstr "" # e183ca76f42f4d51b902223f86adbb4e -#: ../src/Doc/library/string.rst:247 +#: library/string.rst:247 msgid "" "The *field_name* itself begins with an *arg_name* that is either a number or " "a keyword. If it's a number, it refers to a positional argument, and if " @@ -98107,11 +100166,17 @@ msgid "" "`__getitem__`." msgstr "" -#: ../src/Doc/library/string.rst:263 +#: library/string.rst:259 +msgid "" +"The positional argument specifiers can be omitted, so ``'{} {}'`` is " +"equivalent to ``'{0} {1}'``." +msgstr "" + +#: library/string.rst:263 msgid "Some simple format string examples::" msgstr "" -#: ../src/Doc/library/string.rst:272 +#: library/string.rst:272 msgid "" "The *conversion* field causes a type coercion before formatting. Normally, " "the job of formatting a value is done by the :meth:`__format__` method of " @@ -98122,17 +100187,17 @@ msgid "" msgstr "" # a220b52d6d0b4b83baa7f64c26405fc6 -#: ../src/Doc/library/string.rst:279 +#: library/string.rst:279 msgid "" "Two conversion flags are currently supported: ``'!s'`` which calls :func:" "`str` on the value, and ``'!r'`` which calls :func:`repr`." msgstr "" -#: ../src/Doc/library/string.rst:282 +#: library/string.rst:282 msgid "Some examples::" msgstr "Quelques exemples ::" -#: ../src/Doc/library/string.rst:287 +#: library/string.rst:287 msgid "" "The *format_spec* field contains a specification of how the value should be " "presented, including such details as field width, alignment, padding, " @@ -98140,13 +100205,13 @@ msgid "" "\"formatting mini-language\" or interpretation of the *format_spec*." msgstr "" -#: ../src/Doc/library/string.rst:292 +#: library/string.rst:292 msgid "" "Most built-in types support a common formatting mini-language, which is " "described in the next section." msgstr "" -#: ../src/Doc/library/string.rst:295 +#: library/string.rst:295 msgid "" "A *format_spec* field can also include nested replacement fields within it. " "These nested replacement fields can contain only a field name; conversion " @@ -98157,16 +100222,16 @@ msgid "" msgstr "" # e298b0a040144c88888ed0f122884bcd -#: ../src/Doc/library/string.rst:301 +#: library/string.rst:301 msgid "See the :ref:`formatexamples` section for some examples." msgstr "" -#: ../src/Doc/library/string.rst:307 +#: library/string.rst:307 msgid "Format Specification Mini-Language" msgstr "" # 3acf57b3cbf5401fb146b0bc585dd7fd -#: ../src/Doc/library/string.rst:309 +#: library/string.rst:309 msgid "" "\"Format specifications\" are used within replacement fields contained " "within a format string to define how individual values are presented (see :" @@ -98175,26 +100240,26 @@ msgid "" "specification is to be interpreted." msgstr "" -#: ../src/Doc/library/string.rst:315 +#: library/string.rst:315 msgid "" "Most built-in types implement the following options for format " "specifications, although some of the formatting options are only supported " "by the numeric types." msgstr "" -#: ../src/Doc/library/string.rst:318 +#: library/string.rst:318 msgid "" "A general convention is that an empty format string (``\"\"``) produces the " "same result as if you had called :func:`str` on the value. A non-empty " "format string typically modifies the result." msgstr "" -#: ../src/Doc/library/string.rst:322 +#: library/string.rst:322 msgid "The general form of a *standard format specifier* is:" msgstr "" # f93c7e55b27b4b6782c90784a37094fd -#: ../src/Doc/library/string.rst:333 +#: library/string.rst:333 msgid "" "If a valid *align* value is specified, it can be preceded by a *fill* " "character that can be any character and defaults to a space if omitted. Note " @@ -98203,110 +100268,118 @@ msgid "" "func:`format` function." msgstr "" -#: ../src/Doc/library/string.rst:339 +#: library/string.rst:339 msgid "The meaning of the various alignment options is as follows:" msgstr "" -#: ../src/Doc/library/string.rst:344 +#: library/string.rst:344 msgid "``'<'``" msgstr "" # dc393b0ccdc84d869b27ea03431238d8 -#: ../src/Doc/library/string.rst:344 +#: library/string.rst:344 msgid "" "Forces the field to be left-aligned within the available space (this is the " "default for most objects)." msgstr "" -#: ../src/Doc/library/string.rst:347 +#: library/string.rst:347 msgid "``'>'``" msgstr "" # 00392db9f3e94f5793c50ba7911e69e1 -#: ../src/Doc/library/string.rst:347 +#: library/string.rst:347 msgid "" "Forces the field to be right-aligned within the available space (this is the " "default for numbers)." msgstr "" -#: ../src/Doc/library/string.rst:350 +#: library/string.rst:350 msgid "``'='``" msgstr "" -#: ../src/Doc/library/string.rst:350 +#: library/string.rst:350 msgid "" "Forces the padding to be placed after the sign (if any) but before the " "digits. This is used for printing fields in the form '+000000120'. This " "alignment option is only valid for numeric types." msgstr "" -#: ../src/Doc/library/string.rst:355 +#: library/string.rst:355 +msgid "``'^'``" +msgstr "" + +#: library/string.rst:355 msgid "Forces the field to be centered within the available space." msgstr "" -#: ../src/Doc/library/string.rst:359 +#: library/string.rst:359 msgid "" "Note that unless a minimum field width is defined, the field width will " "always be the same size as the data to fill it, so that the alignment option " "has no meaning in this case." msgstr "" -#: ../src/Doc/library/string.rst:363 +#: library/string.rst:363 msgid "" "The *sign* option is only valid for number types, and can be one of the " "following:" msgstr "" -#: ../src/Doc/library/string.rst:369 +#: library/string.rst:369 msgid "" "indicates that a sign should be used for both positive as well as negative " "numbers." msgstr "" -#: ../src/Doc/library/string.rst:372 +#: library/string.rst:372 msgid "" "indicates that a sign should be used only for negative numbers (this is the " "default behavior)." msgstr "" -#: ../src/Doc/library/string.rst:375 +#: library/string.rst:375 msgid "space" msgstr "" -#: ../src/Doc/library/string.rst:375 +#: library/string.rst:375 msgid "" "indicates that a leading space should be used on positive numbers, and a " "minus sign on negative numbers." msgstr "" -#: ../src/Doc/library/string.rst:379 +#: library/string.rst:379 msgid "" "The ``'#'`` option is only valid for integers, and only for binary, octal, " "or hexadecimal output. If present, it specifies that the output will be " "prefixed by ``'0b'``, ``'0o'``, or ``'0x'``, respectively." msgstr "" -#: ../src/Doc/library/string.rst:383 +#: library/string.rst:383 msgid "" "The ``','`` option signals the use of a comma for a thousands separator. For " "a locale aware separator, use the ``'n'`` integer presentation type instead." msgstr "" -#: ../src/Doc/library/string.rst:390 +#: library/string.rst:387 +msgid "Added the ``','`` option (see also :pep:`378`)." +msgstr "" + +#: library/string.rst:390 msgid "" "*width* is a decimal integer defining the minimum field width. If not " "specified, then the field width will be determined by the content." msgstr "" # ef704322def84ed2bd68a0787b0fa024 -#: ../src/Doc/library/string.rst:393 +#: library/string.rst:393 msgid "" "Preceding the *width* field by a zero (``'0'``) character enables sign-aware " "zero-padding for numeric types. This is equivalent to a *fill* character of " "``'0'`` with an *alignment* type of ``'='``." msgstr "" -#: ../src/Doc/library/string.rst:397 +#: library/string.rst:397 msgid "" "The *precision* is a decimal number indicating how many digits should be " "displayed after the decimal point for a floating point value formatted with " @@ -98317,67 +100390,67 @@ msgid "" "integer values." msgstr "" -#: ../src/Doc/library/string.rst:404 +#: library/string.rst:404 msgid "Finally, the *type* determines how the data should be presented." msgstr "" -#: ../src/Doc/library/string.rst:406 +#: library/string.rst:406 msgid "The available string presentation types are:" msgstr "" -#: ../src/Doc/library/string.rst:411 +#: library/string.rst:411 msgid "String format. This is the default type for strings and may be omitted." msgstr "" -#: ../src/Doc/library/string.rst:414 +#: library/string.rst:414 msgid "The same as ``'s'``." msgstr "" -#: ../src/Doc/library/string.rst:417 +#: library/string.rst:417 msgid "The available integer presentation types are:" msgstr "" -#: ../src/Doc/library/string.rst:422 +#: library/string.rst:422 msgid "Binary format. Outputs the number in base 2." msgstr "" -#: ../src/Doc/library/string.rst:424 +#: library/string.rst:424 msgid "" "Character. Converts the integer to the corresponding unicode character " "before printing." msgstr "" -#: ../src/Doc/library/string.rst:427 +#: library/string.rst:427 msgid "Decimal Integer. Outputs the number in base 10." msgstr "" -#: ../src/Doc/library/string.rst:429 +#: library/string.rst:429 msgid "Octal format. Outputs the number in base 8." msgstr "" -#: ../src/Doc/library/string.rst:431 +#: library/string.rst:431 msgid "" "Hex format. Outputs the number in base 16, using lower- case letters for the " "digits above 9." msgstr "" -#: ../src/Doc/library/string.rst:434 +#: library/string.rst:434 msgid "" "Hex format. Outputs the number in base 16, using upper- case letters for the " "digits above 9." msgstr "" -#: ../src/Doc/library/string.rst:437 +#: library/string.rst:437 msgid "" "Number. This is the same as ``'d'``, except that it uses the current locale " "setting to insert the appropriate number separator characters." msgstr "" -#: ../src/Doc/library/string.rst:441 +#: library/string.rst:441 msgid "The same as ``'d'``." msgstr "" -#: ../src/Doc/library/string.rst:444 +#: library/string.rst:444 msgid "" "In addition to the above presentation types, integers can be formatted with " "the floating point presentation types listed below (except ``'n'`` and " @@ -98385,44 +100458,44 @@ msgid "" "floating point number before formatting." msgstr "" -#: ../src/Doc/library/string.rst:449 +#: library/string.rst:449 msgid "" "The available presentation types for floating point and decimal values are:" msgstr "" # d4660221881645aba92a129bb759caf3 -#: ../src/Doc/library/string.rst:454 +#: library/string.rst:454 msgid "" "Exponent notation. Prints the number in scientific notation using the letter " "'e' to indicate the exponent. The default precision is ``6``." msgstr "" -#: ../src/Doc/library/string.rst:458 +#: library/string.rst:458 msgid "" "Exponent notation. Same as ``'e'`` except it uses an upper case 'E' as the " "separator character." msgstr "" # e08a42aaf7aa44be90de0bc4c60d2878 -#: ../src/Doc/library/string.rst:461 +#: library/string.rst:461 msgid "" "Fixed point. Displays the number as a fixed-point number. The default " "precision is ``6``." msgstr "" # 54e076332449410e8365a939f53bb39e -#: ../src/Doc/library/string.rst:464 +#: library/string.rst:464 msgid "Fixed point. Same as ``'f'``." msgstr "" -#: ../src/Doc/library/string.rst:466 +#: library/string.rst:466 msgid "" "General format. For a given precision ``p >= 1``, this rounds the number to " "``p`` significant digits and then formats the result in either fixed-point " "format or in scientific notation, depending on its magnitude." msgstr "" -#: ../src/Doc/library/string.rst:471 +#: library/string.rst:471 msgid "" "The precise rules are as follows: suppose that the result formatted with " "presentation type ``'e'`` and precision ``p-1`` would have exponent " @@ -98434,7 +100507,7 @@ msgid "" msgstr "" # aac17450ba2140d58b8e9e027cc04e3b -#: ../src/Doc/library/string.rst:482 +#: library/string.rst:482 msgid "" "Positive and negative infinity, positive and negative zero, and nans, are " "formatted as ``inf``, ``-inf``, ``0``, ``-0`` and ``nan`` respectively, " @@ -98442,49 +100515,49 @@ msgid "" msgstr "" # 5cc01c3a4b6543e9b36b8ba10c07fecd -#: ../src/Doc/library/string.rst:487 +#: library/string.rst:487 msgid "" "A precision of ``0`` is treated as equivalent to a precision of ``1``. The " "default precision is ``6``." msgstr "" -#: ../src/Doc/library/string.rst:490 +#: library/string.rst:490 msgid "" "General format. Same as ``'g'`` except switches to ``'E'`` if the number " "gets too large. The representations of infinity and NaN are uppercased, too." msgstr "" -#: ../src/Doc/library/string.rst:494 +#: library/string.rst:494 msgid "" "Number. This is the same as ``'g'``, except that it uses the current locale " "setting to insert the appropriate number separator characters." msgstr "" -#: ../src/Doc/library/string.rst:498 +#: library/string.rst:498 msgid "" "Percentage. Multiplies the number by 100 and displays in fixed (``'f'``) " "format, followed by a percent sign." msgstr "" # 56b94cf0061741dfa9aaf48c8be6f9cd -#: ../src/Doc/library/string.rst:501 +#: library/string.rst:501 msgid "The same as ``'g'``." msgstr "" # fb7e92d609984249a62034da55061a1b -#: ../src/Doc/library/string.rst:509 +#: library/string.rst:509 msgid "Format examples" msgstr "" # ee7b87a27fd9411f94b34fb959a8f2fa -#: ../src/Doc/library/string.rst:511 +#: library/string.rst:511 msgid "" "This section contains examples of the new format syntax and comparison with " "the old ``%``-formatting." msgstr "" # 4a40a668d9dd42ba91f063c028a56a21 -#: ../src/Doc/library/string.rst:514 +#: library/string.rst:514 msgid "" "In most of the cases the syntax is similar to the old ``%``-formatting, with " "the addition of the ``{}`` and with ``:`` used instead of ``%``. For " @@ -98492,89 +100565,89 @@ msgid "" msgstr "" # ff5c29baaab74b7d9daf2c4969b9b595 -#: ../src/Doc/library/string.rst:518 +#: library/string.rst:518 msgid "" "The new format syntax also supports new and different options, shown in the " "follow examples." msgstr "" # 889931f6b93e46a0a07ed11f6515b265 -#: ../src/Doc/library/string.rst:521 +#: library/string.rst:521 msgid "Accessing arguments by position::" msgstr "" # 1a065a0e5c064f769eb03525fdebfeed -#: ../src/Doc/library/string.rst:534 +#: library/string.rst:534 msgid "Accessing arguments by name::" msgstr "" # 7f816407619e47509dc87814e4a7a60e -#: ../src/Doc/library/string.rst:542 +#: library/string.rst:542 msgid "Accessing arguments' attributes::" msgstr "" # 0c6cbf948a264248b4349d481d872616 -#: ../src/Doc/library/string.rst:558 +#: library/string.rst:558 msgid "Accessing arguments' items::" msgstr "" # c8f95e99b8324ab4abda86f426217b35 -#: ../src/Doc/library/string.rst:564 +#: library/string.rst:564 msgid "Replacing ``%s`` and ``%r``::" msgstr "" # b2951fbd2b874b12844456c08ce56033 -#: ../src/Doc/library/string.rst:569 +#: library/string.rst:569 msgid "Aligning the text and specifying a width::" msgstr "" # 8ff2fa72a1a2496d9c79dbc4aaee6a83 -#: ../src/Doc/library/string.rst:580 +#: library/string.rst:580 msgid "Replacing ``%+f``, ``%-f``, and ``% f`` and specifying a sign::" msgstr "" # 54b38a5be830428dab191ee6d38923a0 -#: ../src/Doc/library/string.rst:589 +#: library/string.rst:589 msgid "" "Replacing ``%x`` and ``%o`` and converting the value to different bases::" msgstr "" # 14f647f32b114796905684a645c4709e -#: ../src/Doc/library/string.rst:598 +#: library/string.rst:598 msgid "Using the comma as a thousands separator::" msgstr "" # c325edb623ca4c84b3ac33c45e83729a -#: ../src/Doc/library/string.rst:603 +#: library/string.rst:603 msgid "Expressing a percentage::" msgstr "" # 33675cfc145545b287ba224cf9d49383 -#: ../src/Doc/library/string.rst:610 +#: library/string.rst:610 msgid "Using type-specific formatting::" msgstr "" # 34697c4745244678ad83b9a2fcf302e0 -#: ../src/Doc/library/string.rst:617 +#: library/string.rst:617 msgid "Nesting arguments and more complex examples::" msgstr "" -#: ../src/Doc/library/string.rst:649 +#: library/string.rst:649 msgid "Template strings" msgstr "" -#: ../src/Doc/library/string.rst:653 +#: library/string.rst:653 msgid "" "Templates provide simpler string substitutions as described in :pep:`292`. " "Instead of the normal ``%``\\ -based substitutions, Templates support ``$``" "\\ -based substitutions, using the following rules:" msgstr "" -#: ../src/Doc/library/string.rst:657 +#: library/string.rst:657 msgid "``$$`` is an escape; it is replaced with a single ``$``." msgstr "" -#: ../src/Doc/library/string.rst:659 +#: library/string.rst:659 msgid "" "``$identifier`` names a substitution placeholder matching a mapping key of ``" "\"identifier\"``. By default, ``\"identifier\"`` must spell a Python " @@ -98582,31 +100655,31 @@ msgid "" "terminates this placeholder specification." msgstr "" -#: ../src/Doc/library/string.rst:664 +#: library/string.rst:664 msgid "" "``${identifier}`` is equivalent to ``$identifier``. It is required when " "valid identifier characters follow the placeholder but are not part of the " "placeholder, such as ``\"${noun}ification\"``." msgstr "" -#: ../src/Doc/library/string.rst:668 +#: library/string.rst:668 msgid "" "Any other appearance of ``$`` in the string will result in a :exc:" "`ValueError` being raised." msgstr "" -#: ../src/Doc/library/string.rst:671 +#: library/string.rst:671 msgid "" "The :mod:`string` module provides a :class:`Template` class that implements " "these rules. The methods of :class:`Template` are:" msgstr "" -#: ../src/Doc/library/string.rst:677 +#: library/string.rst:677 msgid "The constructor takes a single argument which is the template string." msgstr "" # e4d2106c2ba04906aecf19d31321244b -#: ../src/Doc/library/string.rst:682 +#: library/string.rst:682 msgid "" "Performs the template substitution, returning a new string. *mapping* is " "any dictionary-like object with keys that match the placeholders in the " @@ -98616,7 +100689,7 @@ msgid "" msgstr "" # f2ed9d426bc5417996ddb5dbe05b5956 -#: ../src/Doc/library/string.rst:691 +#: library/string.rst:691 msgid "" "Like :meth:`substitute`, except that if placeholders are missing from " "*mapping* and *kws*, instead of raising a :exc:`KeyError` exception, the " @@ -98625,7 +100698,7 @@ msgid "" "simply return ``$`` instead of raising :exc:`ValueError`." msgstr "" -#: ../src/Doc/library/string.rst:697 +#: library/string.rst:697 msgid "" "While other exceptions may still occur, this method is called \"safe\" " "because substitutions always tries to return a usable string instead of " @@ -98635,22 +100708,22 @@ msgid "" "not valid Python identifiers." msgstr "" -#: ../src/Doc/library/string.rst:704 +#: library/string.rst:704 msgid ":class:`Template` instances also provide one public data attribute:" msgstr "" -#: ../src/Doc/library/string.rst:708 +#: library/string.rst:708 msgid "" "This is the object passed to the constructor's *template* argument. In " "general, you shouldn't change it, but read-only access is not enforced." msgstr "" # 5463f74fb5fc4f19bf35b228400cf0d6 -#: ../src/Doc/library/string.rst:711 +#: library/string.rst:711 msgid "Here is an example of how to use a Template::" msgstr "" -#: ../src/Doc/library/string.rst:729 +#: library/string.rst:729 msgid "" "Advanced usage: you can derive subclasses of :class:`Template` to customize " "the placeholder syntax, delimiter character, or the entire regular " @@ -98659,7 +100732,7 @@ msgid "" msgstr "" # ba0ac15144014664a6afcf2c8f3209f8 -#: ../src/Doc/library/string.rst:733 +#: library/string.rst:733 msgid "" "*delimiter* -- This is the literal string describing a placeholder " "introducing delimiter. The default value is ``$``. Note that this should " @@ -98667,7 +100740,7 @@ msgid "" "escape` on this string as needed." msgstr "" -#: ../src/Doc/library/string.rst:738 +#: library/string.rst:738 msgid "" "*idpattern* -- This is the regular expression describing the pattern for non-" "braced placeholders (the braces will be added automatically as " @@ -98675,7 +100748,7 @@ msgid "" "z0-9]*``." msgstr "" -#: ../src/Doc/library/string.rst:743 +#: library/string.rst:743 msgid "" "Alternatively, you can provide the entire regular expression pattern by " "overriding the class attribute *pattern*. If you do this, the value must be " @@ -98684,43 +100757,43 @@ msgid "" "placeholder rule:" msgstr "" -#: ../src/Doc/library/string.rst:749 +#: library/string.rst:749 msgid "" "*escaped* -- This group matches the escape sequence, e.g. ``$$``, in the " "default pattern." msgstr "" -#: ../src/Doc/library/string.rst:752 +#: library/string.rst:752 msgid "" "*named* -- This group matches the unbraced placeholder name; it should not " "include the delimiter in capturing group." msgstr "" -#: ../src/Doc/library/string.rst:755 +#: library/string.rst:755 msgid "" "*braced* -- This group matches the brace enclosed placeholder name; it " "should not include either the delimiter or braces in the capturing group." msgstr "" -#: ../src/Doc/library/string.rst:758 +#: library/string.rst:758 msgid "" "*invalid* -- This group matches any other delimiter pattern (usually a " "single delimiter), and it should appear last in the regular expression." msgstr "" # 029a45a74fb1466c90a3682c00019ba5 -#: ../src/Doc/library/string.rst:763 +#: library/string.rst:763 msgid "String functions" msgstr "" # 9bb25411a57746f3a1d251e4d089a08d -#: ../src/Doc/library/string.rst:765 +#: library/string.rst:765 msgid "" "The following functions are available to operate on string and Unicode " "objects. They are not available as string methods." msgstr "" -#: ../src/Doc/library/string.rst:771 +#: library/string.rst:771 msgid "" "Split the argument into words using :meth:`str.split`, capitalize each word " "using :meth:`str.capitalize`, and join the capitalized words using :meth:" @@ -98731,7 +100804,7 @@ msgid "" msgstr "" # 35623651ebd5435194c574069e899c0b -#: ../src/Doc/library/string.rst:781 +#: library/string.rst:781 msgid "" "Return a translation table suitable for passing to :func:`translate`, that " "will map each character in *from* into the character at the same position in " @@ -98739,7 +100812,7 @@ msgid "" msgstr "" # 9ca428fddff440a2ab911b4659bac160 -#: ../src/Doc/library/string.rst:787 +#: library/string.rst:787 msgid "" "Don't use strings derived from :const:`lowercase` and :const:`uppercase` as " "arguments; in some locales, these don't have the same length. For case " @@ -98747,12 +100820,12 @@ msgid "" msgstr "" # c1dd986ed38644ff9b973d92c9eaaa79 -#: ../src/Doc/library/string.rst:793 +#: library/string.rst:793 msgid "Deprecated string functions" msgstr "" # 388cfb9c903445218a497243152eb923 -#: ../src/Doc/library/string.rst:795 +#: library/string.rst:795 msgid "" "The following list of functions are also defined as methods of string and " "Unicode objects; see section :ref:`string-methods` for more information on " @@ -98761,8 +100834,12 @@ msgid "" "are:" msgstr "" +#: library/string.rst:803 +msgid "Use the :func:`float` built-in function." +msgstr "" + # 42f71db27eb746bf8b8f08fb3071ae3c -#: ../src/Doc/library/string.rst:808 +#: library/string.rst:808 msgid "" "Convert a string to a floating point number. The string must have the " "standard syntax for a floating point literal in Python, optionally preceded " @@ -98771,7 +100848,7 @@ msgid "" msgstr "" # cfa7d1d81aa34223a10125c45943f704 -#: ../src/Doc/library/string.rst:819 +#: library/string.rst:819 msgid "" "When passing in a string, values for NaN and Infinity may be returned, " "depending on the underlying C library. The specific set of strings accepted " @@ -98779,8 +100856,12 @@ msgid "" "and is known to vary." msgstr "" +#: library/string.rst:827 +msgid "Use the :func:`int` built-in function." +msgstr "" + # 596f353163cb4bf985096bfd60794a65 -#: ../src/Doc/library/string.rst:832 +#: library/string.rst:832 msgid "" "Convert string *s* to an integer in the given *base*. The string must " "consist of one or more digits, optionally preceded by a sign (``+`` or ``-" @@ -98793,8 +100874,12 @@ msgid "" "numeric literals, use the built-in function :func:`eval`.)" msgstr "" +#: library/string.rst:845 +msgid "Use the :func:`long` built-in function." +msgstr "" + # 4d1d32cd1313430588aa969ddba020d3 -#: ../src/Doc/library/string.rst:850 +#: library/string.rst:850 msgid "" "Convert string *s* to a long integer in the given *base*. The string must " "consist of one or more digits, optionally preceded by a sign (``+`` or ``-" @@ -98805,12 +100890,12 @@ msgid "" msgstr "" # 79a02a1dd4b147a0a3f6069344346c1b -#: ../src/Doc/library/string.rst:860 +#: library/string.rst:860 msgid "Return a copy of *word* with only its first character capitalized." msgstr "" # d0eef65e42164e5fa03742735a1c7aae -#: ../src/Doc/library/string.rst:865 +#: library/string.rst:865 msgid "" "Expand tabs in a string replacing them by one or more spaces, depending on " "the current column and the given tab size. The column number is reset to " @@ -98820,7 +100905,7 @@ msgid "" msgstr "" # e7400f342ec340878fe2f821f2c3e063 -#: ../src/Doc/library/string.rst:873 +#: library/string.rst:873 msgid "" "Return the lowest index in *s* where the substring *sub* is found such that " "*sub* is wholly contained in ``s[start:end]``. Return ``-1`` on failure. " @@ -98829,26 +100914,26 @@ msgid "" msgstr "" # 4f11ae870ad542d79a1d7c0a609935c8 -#: ../src/Doc/library/string.rst:881 +#: library/string.rst:881 msgid "Like :func:`find` but find the highest index." msgstr "" # 49bca843893d466eb6d294296ab77872 -#: ../src/Doc/library/string.rst:886 +#: library/string.rst:886 msgid "" "Like :func:`find` but raise :exc:`ValueError` when the substring is not " "found." msgstr "" # f027a817098542ac9d837cdd91699b4d -#: ../src/Doc/library/string.rst:891 +#: library/string.rst:891 msgid "" "Like :func:`rfind` but raise :exc:`ValueError` when the substring is not " "found." msgstr "" # 2f85f20aa9e244baa29c86645576afa5 -#: ../src/Doc/library/string.rst:896 +#: library/string.rst:896 msgid "" "Return the number of (non-overlapping) occurrences of substring *sub* in " "string ``s[start:end]``. Defaults for *start* and *end* and interpretation " @@ -98856,13 +100941,13 @@ msgid "" msgstr "" # ec3777352f854324bc9b9fc0f38b4c19 -#: ../src/Doc/library/string.rst:903 +#: library/string.rst:903 msgid "" "Return a copy of *s*, but with upper case letters converted to lower case." msgstr "" # 064bb1397bea4e458f0271710d406006 -#: ../src/Doc/library/string.rst:908 +#: library/string.rst:908 msgid "" "Return a list of the words of the string *s*. If the optional second " "argument *sep* is absent or ``None``, the words are separated by arbitrary " @@ -98878,7 +100963,7 @@ msgid "" msgstr "" # 1de0907d8b574358b04cf9f41d552263 -#: ../src/Doc/library/string.rst:920 +#: library/string.rst:920 msgid "" "The behavior of split on an empty string depends on the value of *sep*. If " "*sep* is not specified, or specified as ``None``, the result will be an " @@ -98887,7 +100972,7 @@ msgid "" msgstr "" # d553875a096c4047a44aad1a08e1e4d6 -#: ../src/Doc/library/string.rst:928 +#: library/string.rst:928 msgid "" "Return a list of the words of the string *s*, scanning *s* from the end. To " "all intents and purposes, the resulting list of words is the same as " @@ -98899,7 +100984,7 @@ msgid "" msgstr "" # 55bce1e68bb346fc8dcfb09742958647 -#: ../src/Doc/library/string.rst:941 +#: library/string.rst:941 msgid "" "This function behaves identically to :func:`split`. (In the past, :func:" "`split` was only used with one argument, while :func:`splitfields` was only " @@ -98907,7 +100992,7 @@ msgid "" msgstr "" # a0f3aee38fc749d6aa2a6811ce94848c -#: ../src/Doc/library/string.rst:948 +#: library/string.rst:948 msgid "" "Concatenate a list or tuple of words with intervening occurrences of *sep*. " "The default value for *sep* is a single space character. It is always true " @@ -98915,7 +101000,7 @@ msgid "" msgstr "" # 4714572fae4b4215a0c8f50d5618c538 -#: ../src/Doc/library/string.rst:955 +#: library/string.rst:955 msgid "" "This function behaves identically to :func:`join`. (In the past, :func:" "`join` was only used with one argument, while :func:`joinfields` was only " @@ -98924,7 +101009,7 @@ msgid "" msgstr "" # df01782ddece472ca7ee9e7e784f27e0 -#: ../src/Doc/library/string.rst:963 +#: library/string.rst:963 msgid "" "Return a copy of the string with leading characters removed. If *chars* is " "omitted or ``None``, whitespace characters are removed. If given and not " @@ -98932,8 +101017,14 @@ msgid "" "stripped from the beginning of the string this method is called on." msgstr "" +#: library/string.rst:968 library/string.rst:980 library/string.rst:992 +msgid "" +"The *chars* parameter was added. The *chars* parameter cannot be passed in " +"earlier 2.2 versions." +msgstr "" + # 64c7501dff504ddab260555a879aa53c -#: ../src/Doc/library/string.rst:975 +#: library/string.rst:975 msgid "" "Return a copy of the string with trailing characters removed. If *chars* is " "omitted or ``None``, whitespace characters are removed. If given and not " @@ -98942,7 +101033,7 @@ msgid "" msgstr "" # e8e266b045504177b3a6acf5478096bc -#: ../src/Doc/library/string.rst:987 +#: library/string.rst:987 msgid "" "Return a copy of the string with leading and trailing characters removed. " "If *chars* is omitted or ``None``, whitespace characters are removed. If " @@ -98952,14 +101043,14 @@ msgid "" msgstr "" # 9c8a7dae49984c60a1073cba7dab8fb6 -#: ../src/Doc/library/string.rst:999 +#: library/string.rst:999 msgid "" "Return a copy of *s*, but with lower case letters converted to upper case " "and vice versa." msgstr "" # 59844a245e2741e8aaf10906545c2763 -#: ../src/Doc/library/string.rst:1005 +#: library/string.rst:1005 msgid "" "Delete all characters from *s* that are in *deletechars* (if present), and " "then translate the characters using *table*, which must be a 256-character " @@ -98969,13 +101060,13 @@ msgid "" msgstr "" # b04fbd8cafdf43a2a697a8b44c17d4b4 -#: ../src/Doc/library/string.rst:1013 +#: library/string.rst:1013 msgid "" "Return a copy of *s*, but with lower case letters converted to upper case." msgstr "" # a0ea41092f6341278b64309c3d381c4c -#: ../src/Doc/library/string.rst:1020 +#: library/string.rst:1020 msgid "" "These functions respectively left-justify, right-justify and center a string " "in a field of given width. They return a string that is at least *width* " @@ -98985,14 +101076,14 @@ msgid "" msgstr "" # a34e190b820c4937bad57997c04b42f7 -#: ../src/Doc/library/string.rst:1029 +#: library/string.rst:1029 msgid "" "Pad a numeric string *s* on the left with zero digits until the given " "*width* is reached. Strings starting with a sign are handled correctly." msgstr "" # db7445191d144b65a876ade471b899e3 -#: ../src/Doc/library/string.rst:1036 +#: library/string.rst:1036 msgid "" "Return a copy of string *s* with all occurrences of substring *old* replaced " "by *new*. If the optional argument *maxreplace* is given, the first " @@ -99000,12 +101091,12 @@ msgid "" msgstr "" # 3e2272e0269f41448a5d6c032697007d -#: ../src/Doc/library/stringio.rst:3 +#: library/stringio.rst:3 msgid ":mod:`StringIO` --- Read and write strings as files" msgstr "" # c7bc219a47cd43829172fb545adc04cb -#: ../src/Doc/library/stringio.rst:9 +#: library/stringio.rst:9 msgid "" "This module implements a file-like class, :class:`StringIO`, that reads and " "writes a string buffer (also known as *memory files*). See the description " @@ -99014,7 +101105,7 @@ msgid "" msgstr "" # fcab23f8643d4e7f989a7e6ca9597286 -#: ../src/Doc/library/stringio.rst:17 +#: library/stringio.rst:17 msgid "" "When a :class:`StringIO` object is created, it can be initialized to an " "existing string by passing the string to the constructor. If no string is " @@ -99023,7 +101114,7 @@ msgid "" msgstr "" # 3e50a540fe52424dad6992b51cfbcbba -#: ../src/Doc/library/stringio.rst:22 +#: library/stringio.rst:22 msgid "" "The :class:`StringIO` object can accept either Unicode or 8-bit strings, but " "mixing the two may take some care. If both are used, 8-bit strings that " @@ -99032,13 +101123,13 @@ msgid "" msgstr "" # da0afbf5d807408e970469b6323c1bda -#: ../src/Doc/library/stringio.rst:27 +#: library/stringio.rst:27 msgid "" "The following methods of :class:`StringIO` objects require special mention:" msgstr "" # 40d36b5c87b446f0bee9ad767b90cab6 -#: ../src/Doc/library/stringio.rst:32 +#: library/stringio.rst:32 msgid "" "Retrieve the entire contents of the \"file\" at any time before the :class:" "`StringIO` object's :meth:`close` method is called. See the note above for " @@ -99047,19 +101138,19 @@ msgid "" msgstr "" # 13a89af479f1453999861e577ab44f32 -#: ../src/Doc/library/stringio.rst:40 +#: library/stringio.rst:40 msgid "" "Free the memory buffer. Attempting to do further operations with a closed :" "class:`StringIO` object will raise a :exc:`ValueError`." msgstr "" # 9b056a65d32e482bac596cca843586c1 -#: ../src/Doc/library/stringio.rst:61 +#: library/stringio.rst:61 msgid ":mod:`cStringIO` --- Faster version of :mod:`StringIO`" msgstr "" # df9aba84e622471685645f18a70a4408 -#: ../src/Doc/library/stringio.rst:69 +#: library/stringio.rst:69 msgid "" "The module :mod:`cStringIO` provides an interface similar to that of the :" "mod:`StringIO` module. Heavy use of :class:`StringIO.StringIO` objects can " @@ -99068,12 +101159,12 @@ msgid "" msgstr "" # 7e934de965f94c88b222d51083c90975 -#: ../src/Doc/library/stringio.rst:77 +#: library/stringio.rst:77 msgid "Return a StringIO-like stream for reading or writing." msgstr "" # 42b8615e080b44e89ffc6600c9be2019 -#: ../src/Doc/library/stringio.rst:79 +#: library/stringio.rst:79 msgid "" "Since this is a factory function which returns objects of built-in types, " "there's no way to build your own version using subclassing. It's not " @@ -99082,14 +101173,14 @@ msgid "" msgstr "" # 0b240fdc699d49dbb2a4422739f43fb8 -#: ../src/Doc/library/stringio.rst:84 +#: library/stringio.rst:84 msgid "" "Unlike the :mod:`StringIO` module, this module is not able to accept Unicode " "strings that cannot be encoded as plain ASCII strings." msgstr "" # 2a33d6264194452bba1ee36afa725782 -#: ../src/Doc/library/stringio.rst:87 +#: library/stringio.rst:87 msgid "" "Another difference from the :mod:`StringIO` module is that calling :func:" "`StringIO` with a string parameter creates a read-only object. Unlike an " @@ -99099,36 +101190,36 @@ msgid "" msgstr "" # c1ff42164fe2433e955a02ff6fbddaf1 -#: ../src/Doc/library/stringio.rst:95 +#: library/stringio.rst:95 msgid "The following data objects are provided as well:" msgstr "" # 2d46777263584027bd69f0add6200721 -#: ../src/Doc/library/stringio.rst:100 +#: library/stringio.rst:100 msgid "" "The type object of the objects created by calling :func:`StringIO` with a " "string parameter." msgstr "" # 2199663a33ff4c5bbf97e990b3de58de -#: ../src/Doc/library/stringio.rst:106 +#: library/stringio.rst:106 msgid "" "The type object of the objects returned by calling :func:`StringIO` with no " "parameters." msgstr "" # 68c11e978f314bf28ea5e3eb73769279 -#: ../src/Doc/library/stringio.rst:109 +#: library/stringio.rst:109 msgid "" "There is a C API to the module as well; refer to the module source for more " "information." msgstr "" -#: ../src/Doc/library/stringprep.rst:3 +#: library/stringprep.rst:3 msgid ":mod:`stringprep` --- Internet String Preparation" msgstr "" -#: ../src/Doc/library/stringprep.rst:13 +#: library/stringprep.rst:13 msgid "" "When identifying things (such as host names) in the internet, it is often " "necessary to compare such identifications for \"equality\". Exactly how this " @@ -99138,7 +101229,7 @@ msgid "" "\"printable\" characters." msgstr "" -#: ../src/Doc/library/stringprep.rst:20 +#: library/stringprep.rst:20 msgid "" ":rfc:`3454` defines a procedure for \"preparing\" Unicode strings in " "internet protocols. Before passing strings onto the wire, they are processed " @@ -99150,7 +101241,7 @@ msgid "" "domain names." msgstr "" -#: ../src/Doc/library/stringprep.rst:28 +#: library/stringprep.rst:28 msgid "" "The module :mod:`stringprep` only exposes the tables from RFC 3454. As these " "tables would be very large to represent them as dictionaries or lists, the " @@ -99158,7 +101249,7 @@ msgid "" "code itself was generated using the ``mkstringprep.py`` utility." msgstr "" -#: ../src/Doc/library/stringprep.rst:33 +#: library/stringprep.rst:33 msgid "" "As a result, these tables are exposed as functions, not as data structures. " "There are two kinds of tables in the RFC: sets and mappings. For a set, :mod:" @@ -99168,115 +101259,115 @@ msgid "" "is a list of all functions available in the module." msgstr "" -#: ../src/Doc/library/stringprep.rst:43 +#: library/stringprep.rst:43 msgid "" "Determine whether *code* is in tableA.1 (Unassigned code points in Unicode " "3.2)." msgstr "" -#: ../src/Doc/library/stringprep.rst:48 +#: library/stringprep.rst:48 msgid "Determine whether *code* is in tableB.1 (Commonly mapped to nothing)." msgstr "" -#: ../src/Doc/library/stringprep.rst:53 +#: library/stringprep.rst:53 msgid "" "Return the mapped value for *code* according to tableB.2 (Mapping for case-" "folding used with NFKC)." msgstr "" -#: ../src/Doc/library/stringprep.rst:59 +#: library/stringprep.rst:59 msgid "" "Return the mapped value for *code* according to tableB.3 (Mapping for case-" "folding used with no normalization)." msgstr "" -#: ../src/Doc/library/stringprep.rst:65 +#: library/stringprep.rst:65 msgid "Determine whether *code* is in tableC.1.1 (ASCII space characters)." msgstr "" -#: ../src/Doc/library/stringprep.rst:70 +#: library/stringprep.rst:70 msgid "" "Determine whether *code* is in tableC.1.2 (Non-ASCII space characters)." msgstr "" -#: ../src/Doc/library/stringprep.rst:75 +#: library/stringprep.rst:75 msgid "" "Determine whether *code* is in tableC.1 (Space characters, union of C.1.1 " "and C.1.2)." msgstr "" -#: ../src/Doc/library/stringprep.rst:81 +#: library/stringprep.rst:81 msgid "Determine whether *code* is in tableC.2.1 (ASCII control characters)." msgstr "" -#: ../src/Doc/library/stringprep.rst:86 +#: library/stringprep.rst:86 msgid "" "Determine whether *code* is in tableC.2.2 (Non-ASCII control characters)." msgstr "" -#: ../src/Doc/library/stringprep.rst:91 +#: library/stringprep.rst:91 msgid "" "Determine whether *code* is in tableC.2 (Control characters, union of C.2.1 " "and C.2.2)." msgstr "" -#: ../src/Doc/library/stringprep.rst:97 +#: library/stringprep.rst:97 msgid "Determine whether *code* is in tableC.3 (Private use)." msgstr "" -#: ../src/Doc/library/stringprep.rst:102 +#: library/stringprep.rst:102 msgid "Determine whether *code* is in tableC.4 (Non-character code points)." msgstr "" -#: ../src/Doc/library/stringprep.rst:107 +#: library/stringprep.rst:107 msgid "Determine whether *code* is in tableC.5 (Surrogate codes)." msgstr "" -#: ../src/Doc/library/stringprep.rst:112 +#: library/stringprep.rst:112 msgid "" "Determine whether *code* is in tableC.6 (Inappropriate for plain text)." msgstr "" -#: ../src/Doc/library/stringprep.rst:117 +#: library/stringprep.rst:117 msgid "" "Determine whether *code* is in tableC.7 (Inappropriate for canonical " "representation)." msgstr "" -#: ../src/Doc/library/stringprep.rst:123 +#: library/stringprep.rst:123 msgid "" "Determine whether *code* is in tableC.8 (Change display properties or are " "deprecated)." msgstr "" -#: ../src/Doc/library/stringprep.rst:129 +#: library/stringprep.rst:129 msgid "Determine whether *code* is in tableC.9 (Tagging characters)." msgstr "" -#: ../src/Doc/library/stringprep.rst:134 +#: library/stringprep.rst:134 msgid "" "Determine whether *code* is in tableD.1 (Characters with bidirectional " "property \"R\" or \"AL\")." msgstr "" -#: ../src/Doc/library/stringprep.rst:140 +#: library/stringprep.rst:140 msgid "" "Determine whether *code* is in tableD.2 (Characters with bidirectional " "property \"L\")." msgstr "" -#: ../src/Doc/library/strings.rst:6 +#: library/strings.rst:6 msgid "String Services" msgstr "" -#: ../src/Doc/library/strings.rst:8 +#: library/strings.rst:8 msgid "" "The modules described in this chapter provide a wide range of string " "manipulation operations." msgstr "" # 4e686e7fcea84c6f988002fc02f1a3aa -#: ../src/Doc/library/strings.rst:11 +#: library/strings.rst:11 msgid "" "In addition, Python's built-in string classes support the sequence type " "methods described in the :ref:`typesseq` section, and also the string-" @@ -99287,12 +101378,12 @@ msgid "" msgstr "" # b460fe55fd21415e8817f6a9b89c09e2 -#: ../src/Doc/library/struct.rst:3 +#: library/struct.rst:3 msgid ":mod:`struct` --- Interpret strings as packed binary data" msgstr "" # 1ce2cb6773074d71852d923c0c6a236e -#: ../src/Doc/library/struct.rst:12 +#: library/struct.rst:12 msgid "" "This module performs conversions between Python values and C structs " "represented as Python strings. This can be used in handling binary data " @@ -99302,7 +101393,7 @@ msgid "" msgstr "" # e43b7a89e9b84e678322273e5322f984 -#: ../src/Doc/library/struct.rst:20 +#: library/struct.rst:20 msgid "" "By default, the result of packing a given C struct includes pad bytes in " "order to maintain proper alignment for the C types involved; similarly, " @@ -99313,22 +101404,22 @@ msgid "" "``native`` size and alignment: see :ref:`struct-alignment` for details." msgstr "" -#: ../src/Doc/library/struct.rst:29 +#: library/struct.rst:29 msgid "Functions and Exceptions" msgstr "" -#: ../src/Doc/library/struct.rst:31 +#: library/struct.rst:31 msgid "The module defines the following exception and functions:" msgstr "" -#: ../src/Doc/library/struct.rst:36 +#: library/struct.rst:36 msgid "" "Exception raised on various occasions; argument is a string describing what " "is wrong." msgstr "" # 76a1dd74196443439bec73882ceecd5e -#: ../src/Doc/library/struct.rst:42 +#: library/struct.rst:42 msgid "" "Return a string containing the values ``v1, v2, ...`` packed according to " "the given format. The arguments must match the values required by the " @@ -99336,7 +101427,7 @@ msgid "" msgstr "" # ca0cfffdb6a046848205dc8cfff3760f -#: ../src/Doc/library/struct.rst:49 +#: library/struct.rst:49 msgid "" "Pack the values ``v1, v2, ...`` according to the given format, write the " "packed bytes into the writable *buffer* starting at *offset*. Note that the " @@ -99344,7 +101435,7 @@ msgid "" msgstr "" # a22643884db445a78f42af3339f1357b -#: ../src/Doc/library/struct.rst:58 +#: library/struct.rst:58 msgid "" "Unpack the string (presumably packed by ``pack(fmt, ...)``) according to the " "given format. The result is a tuple even if it contains exactly one item. " @@ -99353,7 +101444,7 @@ msgid "" msgstr "" # 0e6ad7b99cf447f985565ff605a974df -#: ../src/Doc/library/struct.rst:66 +#: library/struct.rst:66 msgid "" "Unpack the *buffer* according to the given format. The result is a tuple " "even if it contains exactly one item. The *buffer* must contain at least the " @@ -99362,17 +101453,17 @@ msgid "" msgstr "" # de21e9218d4a4a45b5a1a7a859886709 -#: ../src/Doc/library/struct.rst:76 +#: library/struct.rst:76 msgid "" "Return the size of the struct (and hence of the string) corresponding to the " "given format." msgstr "" -#: ../src/Doc/library/struct.rst:82 +#: library/struct.rst:82 msgid "Format Strings" msgstr "" -#: ../src/Doc/library/struct.rst:84 +#: library/struct.rst:84 msgid "" "Format strings are the mechanism used to specify the expected layout when " "packing and unpacking data. They are built up from :ref:`format-" @@ -99381,71 +101472,71 @@ msgid "" "alignment`." msgstr "" -#: ../src/Doc/library/struct.rst:93 +#: library/struct.rst:93 msgid "Byte Order, Size, and Alignment" msgstr "" -#: ../src/Doc/library/struct.rst:95 +#: library/struct.rst:95 msgid "" "By default, C types are represented in the machine's native format and byte " "order, and properly aligned by skipping pad bytes if necessary (according to " "the rules used by the C compiler)." msgstr "" -#: ../src/Doc/library/struct.rst:99 +#: library/struct.rst:99 msgid "" "Alternatively, the first character of the format string can be used to " "indicate the byte order, size and alignment of the packed data, according to " "the following table:" msgstr "" -#: ../src/Doc/library/struct.rst:104 +#: library/struct.rst:104 msgid "Byte order" msgstr "" -#: ../src/Doc/library/struct.rst:104 +#: library/struct.rst:104 msgid "Size" msgstr "" -#: ../src/Doc/library/struct.rst:104 +#: library/struct.rst:104 msgid "Alignment" msgstr "" -#: ../src/Doc/library/struct.rst:106 +#: library/struct.rst:106 msgid "``@``" msgstr "" -#: ../src/Doc/library/struct.rst:106 ../src/Doc/library/struct.rst:108 +#: library/struct.rst:106 library/struct.rst:108 msgid "native" msgstr "" -#: ../src/Doc/library/struct.rst:108 ../src/Doc/library/struct.rst:110 -#: ../src/Doc/library/struct.rst:112 ../src/Doc/library/struct.rst:114 +#: library/struct.rst:108 library/struct.rst:110 library/struct.rst:112 +#: library/struct.rst:114 msgid "standard" msgstr "" -#: ../src/Doc/library/struct.rst:108 ../src/Doc/library/struct.rst:110 -#: ../src/Doc/library/struct.rst:112 ../src/Doc/library/struct.rst:114 +#: library/struct.rst:108 library/struct.rst:110 library/struct.rst:112 +#: library/struct.rst:114 msgid "none" msgstr "" -#: ../src/Doc/library/struct.rst:110 +#: library/struct.rst:110 msgid "little-endian" msgstr "" -#: ../src/Doc/library/struct.rst:112 +#: library/struct.rst:112 msgid "big-endian" msgstr "" -#: ../src/Doc/library/struct.rst:114 +#: library/struct.rst:114 msgid "network (= big-endian)" msgstr "" -#: ../src/Doc/library/struct.rst:117 +#: library/struct.rst:117 msgid "If the first character is not one of these, ``'@'`` is assumed." msgstr "" -#: ../src/Doc/library/struct.rst:119 +#: library/struct.rst:119 msgid "" "Native byte order is big-endian or little-endian, depending on the host " "system. For example, Intel x86 and AMD64 (x86-64) are little-endian; " @@ -99454,60 +101545,60 @@ msgid "" "endianness of your system." msgstr "" -#: ../src/Doc/library/struct.rst:125 +#: library/struct.rst:125 msgid "" "Native size and alignment are determined using the C compiler's ``sizeof`` " "expression. This is always combined with native byte order." msgstr "" -#: ../src/Doc/library/struct.rst:128 +#: library/struct.rst:128 msgid "" "Standard size depends only on the format character; see the table in the :" "ref:`format-characters` section." msgstr "" -#: ../src/Doc/library/struct.rst:131 +#: library/struct.rst:131 msgid "" "Note the difference between ``'@'`` and ``'='``: both use native byte order, " "but the size and alignment of the latter is standardized." msgstr "" -#: ../src/Doc/library/struct.rst:134 +#: library/struct.rst:134 msgid "" "The form ``'!'`` is available for those poor souls who claim they can't " "remember whether network byte order is big-endian or little-endian." msgstr "" -#: ../src/Doc/library/struct.rst:137 +#: library/struct.rst:137 msgid "" "There is no way to indicate non-native byte order (force byte-swapping); use " "the appropriate choice of ``'<'`` or ``'>'``." msgstr "" -#: ../src/Doc/library/struct.rst:142 +#: library/struct.rst:142 msgid "" "Padding is only automatically added between successive structure members. No " "padding is added at the beginning or the end of the encoded struct." msgstr "" -#: ../src/Doc/library/struct.rst:145 +#: library/struct.rst:145 msgid "" "No padding is added when using non-native size and alignment, e.g. with '<', " "'>', '=', and '!'." msgstr "" -#: ../src/Doc/library/struct.rst:148 +#: library/struct.rst:148 msgid "" "To align the end of a structure to the alignment requirement of a particular " "type, end the format with the code for that type with a repeat count of " "zero. See :ref:`struct-examples`." msgstr "" -#: ../src/Doc/library/struct.rst:156 +#: library/struct.rst:156 msgid "Format Characters" msgstr "" -#: ../src/Doc/library/struct.rst:158 +#: library/struct.rst:158 msgid "" "Format characters have the following meaning; the conversion between C and " "Python values should be obvious given their types. The 'Standard size' " @@ -99517,122 +101608,122 @@ msgid "" "platform-dependent." msgstr "" -#: ../src/Doc/library/struct.rst:166 +#: library/struct.rst:166 msgid "Standard size" msgstr "" -#: ../src/Doc/library/struct.rst:168 +#: library/struct.rst:168 msgid "pad byte" msgstr "" -#: ../src/Doc/library/struct.rst:168 +#: library/struct.rst:168 msgid "no value" msgstr "" # b10311735b3b4f86aca1f0c42647d5b4 -#: ../src/Doc/library/struct.rst:170 +#: library/struct.rst:170 msgid "string of length 1" msgstr "" -#: ../src/Doc/library/struct.rst:172 +#: library/struct.rst:172 msgid "``b``" msgstr "" # 9b1d8cc5dc804ebf8ed062622c6dd980 -#: ../src/Doc/library/struct.rst:172 +#: library/struct.rst:172 msgid ":c:type:`signed char`" msgstr "" -#: ../src/Doc/library/struct.rst:174 +#: library/struct.rst:174 msgid "``B``" msgstr "" -#: ../src/Doc/library/struct.rst:176 +#: library/struct.rst:176 msgid "bool" msgstr "" -#: ../src/Doc/library/struct.rst:178 +#: library/struct.rst:178 msgid "``h``" msgstr "" -#: ../src/Doc/library/struct.rst:180 +#: library/struct.rst:180 msgid "``H``" msgstr "" -#: ../src/Doc/library/struct.rst:182 +#: library/struct.rst:182 msgid "``i``" msgstr "" -#: ../src/Doc/library/struct.rst:184 +#: library/struct.rst:184 msgid "``I``" msgstr "" -#: ../src/Doc/library/struct.rst:186 +#: library/struct.rst:186 msgid "``l``" msgstr "" -#: ../src/Doc/library/struct.rst:188 +#: library/struct.rst:188 msgid "``L``" msgstr "" -#: ../src/Doc/library/struct.rst:190 +#: library/struct.rst:190 msgid "``q``" msgstr "" # d4dba5649fdd4e18a14c5465f9e4d0b9 -#: ../src/Doc/library/struct.rst:190 +#: library/struct.rst:190 msgid ":c:type:`long long`" msgstr "" # 5aaab3dc6b3d403d919ce519374afa90 # 52d32af56bc6478b8938b60c01d59152 -#: ../src/Doc/library/struct.rst:190 ../src/Doc/library/struct.rst:192 +#: library/struct.rst:190 library/struct.rst:192 msgid "\\(2), \\(3)" msgstr "" -#: ../src/Doc/library/struct.rst:192 +#: library/struct.rst:192 msgid "``Q``" msgstr "" # c8bdad82f1f947d2bf4fbf55535431a5 -#: ../src/Doc/library/struct.rst:192 +#: library/struct.rst:192 msgid ":c:type:`unsigned long long`" msgstr "" -#: ../src/Doc/library/struct.rst:195 +#: library/struct.rst:195 msgid "``f``" msgstr "" -#: ../src/Doc/library/struct.rst:197 +#: library/struct.rst:197 msgid "``d``" msgstr "" # 401bc0ed38cd495ab2f5742306f06f20 # 9e8abdd25a28423399b421460b323c08 -#: ../src/Doc/library/struct.rst:199 ../src/Doc/library/struct.rst:201 +#: library/struct.rst:199 library/struct.rst:201 msgid ":c:type:`char[]`" msgstr "" -#: ../src/Doc/library/struct.rst:201 +#: library/struct.rst:201 msgid "``p``" msgstr "" -#: ../src/Doc/library/struct.rst:203 +#: library/struct.rst:203 msgid "``P``" msgstr "" # d227a89395f9405490c986fd5c9db4d9 -#: ../src/Doc/library/struct.rst:203 +#: library/struct.rst:203 msgid ":c:type:`void \\*`" msgstr "" # 901993d9fc11450ab245c64bdfa1f3cb -#: ../src/Doc/library/struct.rst:203 +#: library/struct.rst:203 msgid "\\(5), \\(3)" msgstr "" # e92c0fc2d1ef4da4ad8c9fd7c560ac42 -#: ../src/Doc/library/struct.rst:209 +#: library/struct.rst:209 msgid "" "The ``'?'`` conversion code corresponds to the :c:type:`_Bool` type defined " "by C99. If this type is not available, it is simulated using a :c:type:" @@ -99640,7 +101731,7 @@ msgid "" msgstr "" # 995d62adb4ed4aeb8ccb460890e2964c -#: ../src/Doc/library/struct.rst:216 +#: library/struct.rst:216 msgid "" "The ``'q'`` and ``'Q'`` conversion codes are available in native mode only " "if the platform C compiler supports C :c:type:`long long`, or, on Windows, :" @@ -99648,7 +101739,7 @@ msgid "" msgstr "" # 8d6fade092284c06bb596f7e65a27174 -#: ../src/Doc/library/struct.rst:223 +#: library/struct.rst:223 msgid "" "When attempting to pack a non-integer using any of the integer conversion " "codes, if the non-integer has a :meth:`__index__` method then that method is " @@ -99658,14 +101749,25 @@ msgid "" "meth:`__int__` is deprecated, and will raise :exc:`DeprecationWarning`." msgstr "" -#: ../src/Doc/library/struct.rst:239 +#: library/struct.rst:230 +msgid "Use of the :meth:`__index__` method for non-integers is new in 2.7." +msgstr "" + +#: library/struct.rst:233 +msgid "" +"Prior to version 2.7, not all integer conversion codes would use the :meth:" +"`__int__` method to convert, and :exc:`DeprecationWarning` was raised only " +"for float arguments." +msgstr "" + +#: library/struct.rst:239 msgid "" "For the ``'f'`` and ``'d'`` conversion codes, the packed representation uses " "the IEEE 754 binary32 (for ``'f'``) or binary64 (for ``'d'``) format, " "regardless of the floating-point format used by the platform." msgstr "" -#: ../src/Doc/library/struct.rst:244 +#: library/struct.rst:244 msgid "" "The ``'P'`` format character is only available for the native byte ordering " "(selected as the default or with the ``'@'`` byte order character). The byte " @@ -99674,20 +101776,20 @@ msgid "" "ordering, so the ``'P'`` format is not available." msgstr "" -#: ../src/Doc/library/struct.rst:251 +#: library/struct.rst:251 msgid "" "A format character may be preceded by an integral repeat count. For " "example, the format string ``'4h'`` means exactly the same as ``'hhhh'``." msgstr "" -#: ../src/Doc/library/struct.rst:254 +#: library/struct.rst:254 msgid "" "Whitespace characters between formats are ignored; a count and its format " "must not contain whitespace though." msgstr "" # d2ce45fba39447749aabfdbef040616c -#: ../src/Doc/library/struct.rst:257 +#: library/struct.rst:257 msgid "" "For the ``'s'`` format character, the count is interpreted as the size of " "the string, not a repeat count like for the other format characters; for " @@ -99700,7 +101802,7 @@ msgid "" msgstr "" # b2cfa98324574e86ab516c67c1e29aa7 -#: ../src/Doc/library/struct.rst:266 +#: library/struct.rst:266 msgid "" "The ``'p'`` format character encodes a \"Pascal string\", meaning a short " "variable-length string stored in a *fixed number of bytes*, given by the " @@ -99715,7 +101817,7 @@ msgid "" msgstr "" # 35afdf89b9714e5c920eb5c7571fa32f -#: ../src/Doc/library/struct.rst:276 +#: library/struct.rst:276 msgid "" "For the ``'P'`` format character, the return value is a Python integer or " "long integer, depending on the size needed to hold a pointer when it has " @@ -99728,7 +101830,7 @@ msgid "" msgstr "" # 35f76f0d17de4a189aaef3c0005e1ae1 -#: ../src/Doc/library/struct.rst:284 +#: library/struct.rst:284 msgid "" "For the ``'?'`` format character, the return value is either :const:`True` " "or :const:`False`. When packing, the truth value of the argument object is " @@ -99736,62 +101838,62 @@ msgid "" "packed, and any non-zero value will be ``True`` when unpacking." msgstr "" -#: ../src/Doc/library/struct.rst:297 +#: library/struct.rst:297 msgid "" "All examples assume a native byte order, size, and alignment with a big-" "endian machine." msgstr "" -#: ../src/Doc/library/struct.rst:300 +#: library/struct.rst:300 msgid "A basic example of packing/unpacking three integers::" msgstr "" -#: ../src/Doc/library/struct.rst:310 +#: library/struct.rst:310 msgid "" "Unpacked fields can be named by assigning them to variables or by wrapping " "the result in a named tuple::" msgstr "" -#: ../src/Doc/library/struct.rst:321 +#: library/struct.rst:321 msgid "" "The ordering of format characters may have an impact on size since the " "padding needed to satisfy alignment requirements is different::" msgstr "" -#: ../src/Doc/library/struct.rst:333 +#: library/struct.rst:333 msgid "" "The following format ``'llh0l'`` specifies two pad bytes at the end, " "assuming longs are aligned on 4-byte boundaries::" msgstr "" -#: ../src/Doc/library/struct.rst:339 +#: library/struct.rst:339 msgid "" "This only works when native size and alignment are in effect; standard size " "and alignment does not enforce any alignment." msgstr "" -# 5d53305006c3477b9496bc8f01727605 -#: ../src/Doc/library/struct.rst:345 -msgid "Module :mod:`array`" -msgstr "" +#: library/struct.rst:346 +#, fuzzy +msgid "Module array" +msgstr "Modules" -#: ../src/Doc/library/struct.rst:346 +#: library/struct.rst:346 msgid "Packed binary storage of homogeneous data." msgstr "" -#: ../src/Doc/library/struct.rst:349 +#: library/struct.rst:349 msgid "Packing and unpacking of XDR data." msgstr "" -#: ../src/Doc/library/struct.rst:355 +#: library/struct.rst:355 msgid "Classes" msgstr "Classes" -#: ../src/Doc/library/struct.rst:357 +#: library/struct.rst:357 msgid "The :mod:`struct` module also defines the following type:" msgstr "" -#: ../src/Doc/library/struct.rst:362 +#: library/struct.rst:362 msgid "" "Return a new Struct object which writes and reads binary data according to " "the format string *format*. Creating a Struct object once and calling its " @@ -99799,50 +101901,50 @@ msgid "" "same format since the format string only needs to be compiled once." msgstr "" -#: ../src/Doc/library/struct.rst:369 +#: library/struct.rst:369 msgid "Compiled Struct objects support the following methods and attributes:" msgstr "" -#: ../src/Doc/library/struct.rst:374 +#: library/struct.rst:374 msgid "" "Identical to the :func:`pack` function, using the compiled format. " "(``len(result)`` will equal :attr:`self.size`.)" msgstr "" -#: ../src/Doc/library/struct.rst:380 +#: library/struct.rst:380 msgid "Identical to the :func:`pack_into` function, using the compiled format." msgstr "" # edbf41dd977946dda457cf972ee4e4e3 -#: ../src/Doc/library/struct.rst:385 +#: library/struct.rst:385 msgid "" "Identical to the :func:`unpack` function, using the compiled format. " "(``len(string)`` must equal :attr:`self.size`)." msgstr "" -#: ../src/Doc/library/struct.rst:391 +#: library/struct.rst:391 msgid "" "Identical to the :func:`unpack_from` function, using the compiled format. " "(``len(buffer[offset:])`` must be at least :attr:`self.size`)." msgstr "" -#: ../src/Doc/library/struct.rst:397 +#: library/struct.rst:397 msgid "The format string used to construct this Struct object." msgstr "" # e896bfb3af0e4a74a1d0bb6a7419de16 -#: ../src/Doc/library/struct.rst:401 +#: library/struct.rst:401 msgid "" "The calculated size of the struct (and hence of the string) corresponding " "to :attr:`format`." msgstr "" -#: ../src/Doc/library/subprocess.rst:3 +#: library/subprocess.rst:3 msgid ":mod:`subprocess` --- Subprocess management" msgstr "" # d694e40f6e854b0984687ac1db474112 -#: ../src/Doc/library/subprocess.rst:13 +#: library/subprocess.rst:13 msgid "" "The :mod:`subprocess` module allows you to spawn new processes, connect to " "their input/output/error pipes, and obtain their return codes. This module " @@ -99850,14 +101952,14 @@ msgid "" msgstr "" # dfcc1a3501094ce9990f231f9145ac44 -#: ../src/Doc/library/subprocess.rst:23 +#: library/subprocess.rst:23 msgid "" "Information about how this module can be used to replace the older functions " "can be found in the subprocess-replacements_ section." msgstr "" # 56a31dec93884e3a88d249cc939fd05f -#: ../src/Doc/library/subprocess.rst:28 +#: library/subprocess.rst:28 msgid "" "POSIX users (Linux, BSD, etc.) are strongly encouraged to install and use " "the much more recent subprocess32_ module instead of the version included " @@ -99865,17 +101967,17 @@ msgid "" "situations." msgstr "" -#: ../src/Doc/library/subprocess.rst:33 +#: library/subprocess.rst:33 msgid ":pep:`324` -- PEP proposing the subprocess module" msgstr "" # 9bfefd5798aa4f70aa446bd434df50d1 -#: ../src/Doc/library/subprocess.rst:38 +#: library/subprocess.rst:38 msgid "Using the :mod:`subprocess` Module" msgstr "" # f18b8217dc8f47f8abe523f03b894f57 -#: ../src/Doc/library/subprocess.rst:40 +#: library/subprocess.rst:40 msgid "" "The recommended way to launch subprocesses is to use the following " "convenience functions. For more advanced use cases when these do not meet " @@ -99883,7 +101985,7 @@ msgid "" msgstr "" # 71fad437d7174ecc9ab6b89d7dffc125 -#: ../src/Doc/library/subprocess.rst:47 +#: library/subprocess.rst:47 msgid "" "Run the command described by *args*. Wait for command to complete, then " "return the :attr:`returncode` attribute." @@ -99891,7 +101993,7 @@ msgstr "" # 29c330df907c41f3abd9c9438691e5b0 # 60e7715ef0cc44129b690795bfce3cea -#: ../src/Doc/library/subprocess.rst:50 ../src/Doc/library/subprocess.rst:84 +#: library/subprocess.rst:50 library/subprocess.rst:84 msgid "" "The arguments shown above are merely the most common ones, described below " "in :ref:`frequently-used-arguments` (hence the slightly odd notation in the " @@ -99903,8 +102005,8 @@ msgstr "" # 5158f76d531e41aeadc2aa4cc968346a # 5158f76d531e41aeadc2aa4cc968346a # 5158f76d531e41aeadc2aa4cc968346a -#: ../src/Doc/library/subprocess.rst:66 ../src/Doc/library/subprocess.rst:104 -#: ../src/Doc/library/subprocess.rst:154 +#: library/subprocess.rst:66 library/subprocess.rst:104 +#: library/subprocess.rst:154 msgid "" "Using ``shell=True`` can be a security hazard. See the warning under :ref:" "`frequently-used-arguments` for details." @@ -99912,7 +102014,7 @@ msgstr "" # 64954cad3c914e89aad302c5c1737132 # 64954cad3c914e89aad302c5c1737132 -#: ../src/Doc/library/subprocess.rst:71 ../src/Doc/library/subprocess.rst:109 +#: library/subprocess.rst:71 library/subprocess.rst:109 msgid "" "Do not use ``stdout=PIPE`` or ``stderr=PIPE`` with this function as that can " "deadlock based on the child process output volume. Use :class:`Popen` with " @@ -99920,7 +102022,7 @@ msgid "" msgstr "" # 4c59d1b9f2db4600ab1a2a0c53446f16 -#: ../src/Doc/library/subprocess.rst:79 +#: library/subprocess.rst:79 msgid "" "Run command with arguments. Wait for command to complete. If the return " "code was zero then return, otherwise raise :exc:`CalledProcessError`. The :" @@ -99928,12 +102030,12 @@ msgid "" "`~CalledProcessError.returncode` attribute." msgstr "" -#: ../src/Doc/library/subprocess.rst:117 +#: library/subprocess.rst:117 msgid "Run command with arguments and return its output as a byte string." msgstr "" # c0d102659d3e4ef29522ba40aa1b216a -#: ../src/Doc/library/subprocess.rst:119 +#: library/subprocess.rst:119 msgid "" "If the return code was non-zero it raises a :exc:`CalledProcessError`. The :" "exc:`CalledProcessError` object will have the return code in the :attr:" @@ -99942,7 +102044,7 @@ msgid "" msgstr "" # 3d2a71edae42475f95d20e84f788576c -#: ../src/Doc/library/subprocess.rst:124 +#: library/subprocess.rst:124 msgid "" "The arguments shown above are merely the most common ones, described below " "in :ref:`frequently-used-arguments` (hence the slightly odd notation in the " @@ -99953,28 +102055,28 @@ msgid "" msgstr "" # e6349e4b214a47a4ac23c4a399641861 -#: ../src/Doc/library/subprocess.rst:141 +#: library/subprocess.rst:141 msgid "" "To also capture standard error in the result, use ``stderr=subprocess." "STDOUT``::" msgstr "" # b0f615fc0ef444578b2b06c4e7881bb4 -#: ../src/Doc/library/subprocess.rst:159 +#: library/subprocess.rst:159 msgid "" "Do not use ``stderr=PIPE`` with this function as that can deadlock based on " "the child process error volume. Use :class:`Popen` with the :meth:" "`communicate` method when you need a stderr pipe." msgstr "" -#: ../src/Doc/library/subprocess.rst:166 +#: library/subprocess.rst:166 msgid "" "Special value that can be used as the *stdin*, *stdout* or *stderr* argument " "to :class:`Popen` and indicates that a pipe to the standard stream should be " "opened." msgstr "" -#: ../src/Doc/library/subprocess.rst:173 +#: library/subprocess.rst:173 msgid "" "Special value that can be used as the *stderr* argument to :class:`Popen` " "and indicates that standard error should go into the same handle as standard " @@ -99982,36 +102084,36 @@ msgid "" msgstr "" # 71f91d8913a743319a6e6ab389b1d0a0 -#: ../src/Doc/library/subprocess.rst:180 +#: library/subprocess.rst:180 msgid "" "Exception raised when a process run by :func:`check_call` or :func:" "`check_output` returns a non-zero exit status." msgstr "" # 3d0a6f0eb9154f458825403904a7ea2c -#: ../src/Doc/library/subprocess.rst:185 +#: library/subprocess.rst:185 msgid "Exit status of the child process." msgstr "" # 59e002e1e43f409c8438061404d1aac2 -#: ../src/Doc/library/subprocess.rst:189 +#: library/subprocess.rst:189 msgid "Command that was used to spawn the child process." msgstr "" # d1243cee43f84d2da7e52330aadee9af -#: ../src/Doc/library/subprocess.rst:193 +#: library/subprocess.rst:193 msgid "" "Output of the child process if this exception is raised by :func:" "`check_output`. Otherwise, ``None``." msgstr "" # 62863ec5a965452bb4e9dc1dcf09cf0e -#: ../src/Doc/library/subprocess.rst:201 +#: library/subprocess.rst:201 msgid "Frequently Used Arguments" msgstr "" # a5ecc74b103c4051853a5e41deaaf418 -#: ../src/Doc/library/subprocess.rst:203 +#: library/subprocess.rst:203 msgid "" "To support a wide variety of use cases, the :class:`Popen` constructor (and " "the convenience functions) accept a large number of optional arguments. For " @@ -100020,7 +102122,7 @@ msgid "" msgstr "" # 9544e97fa6d24c509619556bf985c02d -#: ../src/Doc/library/subprocess.rst:208 +#: library/subprocess.rst:208 msgid "" "*args* is required for all calls and should be a string, or a sequence of " "program arguments. Providing a sequence of arguments is generally preferred, " @@ -100032,7 +102134,7 @@ msgstr "" # 1aa11b223d08426bbd0a2f5be6d21a15 # 347b5f16bddc47f183456ca4c415142c -#: ../src/Doc/library/subprocess.rst:216 ../src/Doc/library/subprocess.rst:372 +#: library/subprocess.rst:216 library/subprocess.rst:372 msgid "" "*stdin*, *stdout* and *stderr* specify the executed program's standard " "input, standard output and standard error file handles, respectively. Valid " @@ -100046,7 +102148,7 @@ msgid "" msgstr "" # 17caa0fb30ad4e1789ad6196941bc6ef -#: ../src/Doc/library/subprocess.rst:229 +#: library/subprocess.rst:229 msgid "" "When *stdout* or *stderr* are pipes and *universal_newlines* is ``True`` " "then all line endings will be converted to ``'\\n'`` as described for the :" @@ -100054,7 +102156,7 @@ msgid "" msgstr "" # 22cc902a546043b695be86cae23ef408 -#: ../src/Doc/library/subprocess.rst:233 +#: library/subprocess.rst:233 msgid "" "If *shell* is ``True``, the specified command will be executed through the " "shell. This can be useful if you are using Python primarily for the " @@ -100068,7 +102170,7 @@ msgid "" msgstr "" # f8d13f009c4144c0b04b0fa7e2f5ae11 -#: ../src/Doc/library/subprocess.rst:245 +#: library/subprocess.rst:245 msgid "" "Executing shell commands that incorporate unsanitized input from an " "untrusted source makes a program vulnerable to `shell injection <http://en." @@ -100079,7 +102181,7 @@ msgid "" msgstr "" # 0d719274e584474d8c0f2eb8cabdb9cc -#: ../src/Doc/library/subprocess.rst:258 +#: library/subprocess.rst:258 msgid "" "``shell=False`` disables all shell based features, but does not suffer from " "this vulnerability; see the Note in the :class:`Popen` constructor " @@ -100087,7 +102189,7 @@ msgid "" msgstr "" # 98ccf215b48a459ab7907ce96b0461f2 -#: ../src/Doc/library/subprocess.rst:262 +#: library/subprocess.rst:262 msgid "" "When using ``shell=True``, :func:`pipes.quote` can be used to properly " "escape whitespace and shell metacharacters in strings that are going to be " @@ -100095,19 +102197,19 @@ msgid "" msgstr "" # 79f69d9bc36e4092be2f59cd60e1e90f -#: ../src/Doc/library/subprocess.rst:266 +#: library/subprocess.rst:266 msgid "" "These options, along with all of the other options, are described in more " "detail in the :class:`Popen` constructor documentation." msgstr "" # 6a334f47d7014131b32e2bf09d0b5362 -#: ../src/Doc/library/subprocess.rst:271 +#: library/subprocess.rst:271 msgid "Popen Constructor" msgstr "" # f4fc7b26adaf44598e415ff3948ea0cd -#: ../src/Doc/library/subprocess.rst:273 +#: library/subprocess.rst:273 msgid "" "The underlying process creation and management in this module is handled by " "the :class:`Popen` class. It offers a lot of flexibility so that developers " @@ -100116,7 +102218,7 @@ msgid "" msgstr "" # 71479d65f34141328dca467840f3c5c4 -#: ../src/Doc/library/subprocess.rst:284 +#: library/subprocess.rst:284 msgid "" "Execute a child program in a new process. On Unix, the class uses :meth:`os." "execvp`-like behavior to execute the child program. On Windows, the class " @@ -100125,7 +102227,7 @@ msgid "" msgstr "" # 3f718bc5b01b4d07a9d9f17fc347f605 -#: ../src/Doc/library/subprocess.rst:289 +#: library/subprocess.rst:289 msgid "" "*args* should be a sequence of program arguments or else a single string. By " "default, the program to execute is the first item in *args* if *args* is a " @@ -100136,20 +102238,20 @@ msgid "" msgstr "" # 85836ebb42bb4a4b8cb9d1a2f16a32c3 -#: ../src/Doc/library/subprocess.rst:296 +#: library/subprocess.rst:296 msgid "" "On Unix, if *args* is a string, the string is interpreted as the name or " "path of the program to execute. However, this can only be done if not " "passing arguments to the program." msgstr "" -#: ../src/Doc/library/subprocess.rst:302 +#: library/subprocess.rst:302 msgid "" ":meth:`shlex.split` can be useful when determining the correct tokenization " "for *args*, especially in complex cases::" msgstr "" -#: ../src/Doc/library/subprocess.rst:313 +#: library/subprocess.rst:313 msgid "" "Note in particular that options (such as *-input*) and arguments (such as " "*eggs.txt*) that are separated by whitespace in the shell go in separate " @@ -100159,7 +102261,7 @@ msgid "" msgstr "" # 99b6765884a34ad2bdeea59c6a7a00b3 -#: ../src/Doc/library/subprocess.rst:319 +#: library/subprocess.rst:319 msgid "" "On Windows, if *args* is a sequence, it will be converted to a string in a " "manner described in :ref:`converting-argument-sequence`. This is because " @@ -100167,7 +102269,7 @@ msgid "" msgstr "" # c9fa1830d1444f6999d8ffa873141a83 -#: ../src/Doc/library/subprocess.rst:323 +#: library/subprocess.rst:323 msgid "" "The *shell* argument (which defaults to *False*) specifies whether to use " "the shell as the program to execute. If *shell* is *True*, it is " @@ -100175,7 +102277,7 @@ msgid "" msgstr "" # a3afa57089934e9885c5276443cb3f04 -#: ../src/Doc/library/subprocess.rst:327 +#: library/subprocess.rst:327 msgid "" "On Unix with ``shell=True``, the shell defaults to :file:`/bin/sh`. If " "*args* is a string, the string specifies the command to execute through the " @@ -100188,7 +102290,7 @@ msgid "" msgstr "" # a58221852baa4ded9207266293caa487 -#: ../src/Doc/library/subprocess.rst:338 +#: library/subprocess.rst:338 msgid "" "On Windows with ``shell=True``, the :envvar:`COMSPEC` environment variable " "specifies the default shell. The only time you need to specify " @@ -100198,13 +102300,13 @@ msgid "" msgstr "" # 5158f76d531e41aeadc2aa4cc968346a -#: ../src/Doc/library/subprocess.rst:346 +#: library/subprocess.rst:346 msgid "" "Passing ``shell=True`` can be a security hazard if combined with untrusted " "input. See the warning under :ref:`frequently-used-arguments` for details." msgstr "" -#: ../src/Doc/library/subprocess.rst:350 +#: library/subprocess.rst:350 msgid "" "*bufsize*, if given, has the same meaning as the corresponding argument to " "the built-in open() function: :const:`0` means unbuffered, :const:`1` means " @@ -100214,7 +102316,7 @@ msgid "" "*bufsize* is :const:`0` (unbuffered)." msgstr "" -#: ../src/Doc/library/subprocess.rst:358 +#: library/subprocess.rst:358 msgid "" "If you experience performance issues, it is recommended that you try to " "enable buffering by setting *bufsize* to either -1 or a large enough " @@ -100222,7 +102324,7 @@ msgid "" msgstr "" # 55213eb43d884f0ea75c7286d33da50e -#: ../src/Doc/library/subprocess.rst:362 +#: library/subprocess.rst:362 msgid "" "The *executable* argument specifies a replacement program to execute. It " "is very seldom needed. When ``shell=False``, *executable* replaces the " @@ -100235,13 +102337,13 @@ msgid "" "default :file:`/bin/sh`." msgstr "" -#: ../src/Doc/library/subprocess.rst:382 +#: library/subprocess.rst:382 msgid "" "If *preexec_fn* is set to a callable object, this object will be called in " "the child process just before the child is executed. (Unix only)" msgstr "" -#: ../src/Doc/library/subprocess.rst:385 +#: library/subprocess.rst:385 msgid "" "If *close_fds* is true, all file descriptors except :const:`0`, :const:`1` " "and :const:`2` will be closed before the child process is executed. (Unix " @@ -100251,7 +102353,7 @@ msgid "" "*stdin*, *stdout* or *stderr*." msgstr "" -#: ../src/Doc/library/subprocess.rst:391 +#: library/subprocess.rst:391 msgid "" "If *cwd* is not ``None``, the child's current directory will be changed to " "*cwd* before it is executed. Note that this directory is not considered " @@ -100260,14 +102362,14 @@ msgid "" msgstr "" # ad0f5a4b9f1a448eb74ec22b9e5c06f0 -#: ../src/Doc/library/subprocess.rst:396 +#: library/subprocess.rst:396 msgid "" "If *env* is not ``None``, it must be a mapping that defines the environment " "variables for the new process; these are used instead of inheriting the " "current process' environment, which is the default behavior." msgstr "" -#: ../src/Doc/library/subprocess.rst:402 +#: library/subprocess.rst:402 msgid "" "If specified, *env* must provide any variables required for the program to " "execute. On Windows, in order to run a `side-by-side assembly`_ the " @@ -100275,7 +102377,7 @@ msgid "" msgstr "" # d480d982ac0f487aba5b350369f467e5 -#: ../src/Doc/library/subprocess.rst:409 +#: library/subprocess.rst:409 msgid "" "If *universal_newlines* is ``True``, the file objects *stdout* and *stderr* " "are opened as text files in :term:`universal newlines` mode. Lines may be " @@ -100285,7 +102387,7 @@ msgid "" msgstr "" # 02a93ae17d0c487881b7c63dbce94168 -#: ../src/Doc/library/subprocess.rst:417 +#: library/subprocess.rst:417 msgid "" "This feature is only available if Python is built with universal newline " "support (the default). Also, the newlines attribute of the file objects :" @@ -100294,7 +102396,7 @@ msgid "" msgstr "" # 49c84a99714a437bab9225536756b4d0 -#: ../src/Doc/library/subprocess.rst:422 +#: library/subprocess.rst:422 msgid "" "If given, *startupinfo* will be a :class:`STARTUPINFO` object, which is " "passed to the underlying ``CreateProcess`` function. *creationflags*, if " @@ -100303,7 +102405,7 @@ msgid "" msgstr "" # d134086bfa554df3a58cfcf5985f12e5 -#: ../src/Doc/library/subprocess.rst:431 +#: library/subprocess.rst:431 msgid "" "Exceptions raised in the child process, before the new program has started " "to execute, will be re-raised in the parent. Additionally, the exception " @@ -100311,32 +102413,32 @@ msgid "" "is a string containing traceback information from the child's point of view." msgstr "" -#: ../src/Doc/library/subprocess.rst:436 +#: library/subprocess.rst:436 msgid "" "The most common exception raised is :exc:`OSError`. This occurs, for " "example, when trying to execute a non-existent file. Applications should " "prepare for :exc:`OSError` exceptions." msgstr "" -#: ../src/Doc/library/subprocess.rst:440 +#: library/subprocess.rst:440 msgid "" "A :exc:`ValueError` will be raised if :class:`Popen` is called with invalid " "arguments." msgstr "" # ae3df7f80a384543a6e1dd03ad6d9e00 -#: ../src/Doc/library/subprocess.rst:443 +#: library/subprocess.rst:443 msgid "" ":func:`check_call` and :func:`check_output` will raise :exc:" "`CalledProcessError` if the called process returns a non-zero return code." msgstr "" -#: ../src/Doc/library/subprocess.rst:449 +#: library/subprocess.rst:449 msgid "Security" msgstr "" # 0dd49fed54a54d64b24f5243d6cca41e -#: ../src/Doc/library/subprocess.rst:451 +#: library/subprocess.rst:451 msgid "" "Unlike some other popen functions, this implementation will never call a " "system shell implicitly. This means that all characters, including shell " @@ -100345,29 +102447,29 @@ msgid "" "ensure that all whitespace and metacharacters are quoted appropriately." msgstr "" -#: ../src/Doc/library/subprocess.rst:459 +#: library/subprocess.rst:459 msgid "Popen Objects" msgstr "" -#: ../src/Doc/library/subprocess.rst:461 +#: library/subprocess.rst:461 msgid "Instances of the :class:`Popen` class have the following methods:" msgstr "" # bc9b96e924464fe2978e6fd6916ac89b -#: ../src/Doc/library/subprocess.rst:466 +#: library/subprocess.rst:466 msgid "" "Check if child process has terminated. Set and return :attr:`~Popen." "returncode` attribute." msgstr "" # 42a8e2b542dd4579830d8b6e7694c15b -#: ../src/Doc/library/subprocess.rst:472 +#: library/subprocess.rst:472 msgid "" "Wait for child process to terminate. Set and return :attr:`~Popen." "returncode` attribute." msgstr "" -#: ../src/Doc/library/subprocess.rst:477 +#: library/subprocess.rst:477 msgid "" "This will deadlock when using ``stdout=PIPE`` and/or ``stderr=PIPE`` and the " "child process generates enough output to a pipe such that it blocks waiting " @@ -100376,7 +102478,7 @@ msgid "" msgstr "" # 41d4bf91fc534f92b2bfa67b7fb56623 -#: ../src/Doc/library/subprocess.rst:485 +#: library/subprocess.rst:485 msgid "" "Interact with process: Send data to stdin. Read data from stdout and " "stderr, until end-of-file is reached. Wait for process to terminate. The " @@ -100384,11 +102486,11 @@ msgid "" "process, or ``None``, if no data should be sent to the child." msgstr "" -#: ../src/Doc/library/subprocess.rst:490 +#: library/subprocess.rst:490 msgid ":meth:`communicate` returns a tuple ``(stdoutdata, stderrdata)``." msgstr "" -#: ../src/Doc/library/subprocess.rst:492 +#: library/subprocess.rst:492 msgid "" "Note that if you want to send data to the process's stdin, you need to " "create the Popen object with ``stdin=PIPE``. Similarly, to get anything " @@ -100396,18 +102498,18 @@ msgid "" "and/or ``stderr=PIPE`` too." msgstr "" -#: ../src/Doc/library/subprocess.rst:499 +#: library/subprocess.rst:499 msgid "" "The data read is buffered in memory, so do not use this method if the data " "size is large or unlimited." msgstr "" -#: ../src/Doc/library/subprocess.rst:505 +#: library/subprocess.rst:505 msgid "Sends the signal *signal* to the child." msgstr "" # 708095ac59494dfdbd2b2d5359d09dbf -#: ../src/Doc/library/subprocess.rst:509 +#: library/subprocess.rst:509 msgid "" "On Windows, SIGTERM is an alias for :meth:`terminate`. CTRL_C_EVENT and " "CTRL_BREAK_EVENT can be sent to processes started with a *creationflags* " @@ -100415,21 +102517,21 @@ msgid "" msgstr "" # 6c1e14ddac9845699f8e07dcb738c59f -#: ../src/Doc/library/subprocess.rst:518 +#: library/subprocess.rst:518 msgid "" "Stop the child. On Posix OSs the method sends SIGTERM to the child. On " "Windows the Win32 API function :c:func:`TerminateProcess` is called to stop " "the child." msgstr "" -#: ../src/Doc/library/subprocess.rst:527 +#: library/subprocess.rst:527 msgid "" "Kills the child. On Posix OSs the function sends SIGKILL to the child. On " "Windows :meth:`kill` is an alias for :meth:`terminate`." msgstr "" # 0d0b83afe169486191bc617b3d0a3e08 -#: ../src/Doc/library/subprocess.rst:537 +#: library/subprocess.rst:537 msgid "" "Use :meth:`~Popen.communicate` rather than :attr:`.stdin.write <Popen." "stdin>`, :attr:`.stdout.read <Popen.stdout>` or :attr:`.stderr.read <Popen." @@ -100437,58 +102539,58 @@ msgid "" "up and blocking the child process." msgstr "" -#: ../src/Doc/library/subprocess.rst:545 +#: library/subprocess.rst:545 msgid "" "If the *stdin* argument was :data:`PIPE`, this attribute is a file object " "that provides input to the child process. Otherwise, it is ``None``." msgstr "" -#: ../src/Doc/library/subprocess.rst:551 +#: library/subprocess.rst:551 msgid "" "If the *stdout* argument was :data:`PIPE`, this attribute is a file object " "that provides output from the child process. Otherwise, it is ``None``." msgstr "" -#: ../src/Doc/library/subprocess.rst:557 +#: library/subprocess.rst:557 msgid "" "If the *stderr* argument was :data:`PIPE`, this attribute is a file object " "that provides error output from the child process. Otherwise, it is " "``None``." msgstr "" -#: ../src/Doc/library/subprocess.rst:566 +#: library/subprocess.rst:566 msgid "" "Note that if you set the *shell* argument to ``True``, this is the process " "ID of the spawned shell." msgstr "" -#: ../src/Doc/library/subprocess.rst:572 +#: library/subprocess.rst:572 msgid "" "The child return code, set by :meth:`poll` and :meth:`wait` (and indirectly " "by :meth:`communicate`). A ``None`` value indicates that the process hasn't " "terminated yet." msgstr "" -#: ../src/Doc/library/subprocess.rst:576 +#: library/subprocess.rst:576 msgid "" "A negative value ``-N`` indicates that the child was terminated by signal " "``N`` (Unix only)." msgstr "" # 6a150f8d79a84d0788787ba26d2626ae -#: ../src/Doc/library/subprocess.rst:581 +#: library/subprocess.rst:581 msgid "Windows Popen Helpers" msgstr "" # d8c9dc90cd26440992554e669cdc19fe -#: ../src/Doc/library/subprocess.rst:583 +#: library/subprocess.rst:583 msgid "" "The :class:`STARTUPINFO` class and following constants are only available on " "Windows." msgstr "" # 53fa489480e64208b85c5c066a01463f -#: ../src/Doc/library/subprocess.rst:588 +#: library/subprocess.rst:588 msgid "" "Partial support of the Windows `STARTUPINFO <http://msdn.microsoft.com/en-us/" "library/ms686331(v=vs.85).aspx>`__ structure is used for :class:`Popen` " @@ -100496,14 +102598,14 @@ msgid "" msgstr "" # b5378f53610648338a395fb865f3b117 -#: ../src/Doc/library/subprocess.rst:594 +#: library/subprocess.rst:594 msgid "" "A bit field that determines whether certain :class:`STARTUPINFO` attributes " "are used when the process creates a window. ::" msgstr "" # 7bc55cd9fbe74c56adcd921ed9fc6e50 -#: ../src/Doc/library/subprocess.rst:602 +#: library/subprocess.rst:602 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard input handle for the process. If :data:`STARTF_USESTDHANDLES` " @@ -100511,7 +102613,7 @@ msgid "" msgstr "" # 27f7d2ae71f64d0b98041a2079280026 -#: ../src/Doc/library/subprocess.rst:609 +#: library/subprocess.rst:609 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard output handle for the process. Otherwise, this attribute is " @@ -100519,7 +102621,7 @@ msgid "" msgstr "" # f9643f1e70044641b6165110e44bceff -#: ../src/Doc/library/subprocess.rst:616 +#: library/subprocess.rst:616 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESTDHANDLES`, this attribute is " "the standard error handle for the process. Otherwise, this attribute is " @@ -100527,7 +102629,7 @@ msgid "" msgstr "" # c7c32adab61242b3ac82d5637bb03f52 -#: ../src/Doc/library/subprocess.rst:622 +#: library/subprocess.rst:622 msgid "" "If :attr:`dwFlags` specifies :data:`STARTF_USESHOWWINDOW`, this attribute " "can be any of the values that can be specified in the ``nCmdShow`` parameter " @@ -100537,45 +102639,45 @@ msgid "" msgstr "" # 45959ced5a674191b296e56e3b804a6c -#: ../src/Doc/library/subprocess.rst:629 +#: library/subprocess.rst:629 msgid "" ":data:`SW_HIDE` is provided for this attribute. It is used when :class:" "`Popen` is called with ``shell=True``." msgstr "" # 12be7d6338f142dda643564714f11643 -#: ../src/Doc/library/subprocess.rst:636 +#: library/subprocess.rst:636 msgid "The :mod:`subprocess` module exposes the following constants." msgstr "" # 85d3cbf50e064e9396df25ead697c077 -#: ../src/Doc/library/subprocess.rst:640 +#: library/subprocess.rst:640 msgid "" "The standard input device. Initially, this is the console input buffer, " "``CONIN$``." msgstr "" # b14754805e7f440a98b8399bad4f6daa -#: ../src/Doc/library/subprocess.rst:645 +#: library/subprocess.rst:645 msgid "" "The standard output device. Initially, this is the active console screen " "buffer, ``CONOUT$``." msgstr "" # 413c6fac58b84c4e8185681882050877 -#: ../src/Doc/library/subprocess.rst:650 +#: library/subprocess.rst:650 msgid "" "The standard error device. Initially, this is the active console screen " "buffer, ``CONOUT$``." msgstr "" # df6e8d90ce854d3dad46ccc20c0b8acf -#: ../src/Doc/library/subprocess.rst:655 +#: library/subprocess.rst:655 msgid "Hides the window. Another window will be activated." msgstr "" # fb82dc4145114cd885ca7f1f6d5e3ccd -#: ../src/Doc/library/subprocess.rst:659 +#: library/subprocess.rst:659 msgid "" "Specifies that the :attr:`STARTUPINFO.hStdInput`, :attr:`STARTUPINFO." "hStdOutput`, and :attr:`STARTUPINFO.hStdError` attributes contain additional " @@ -100583,27 +102685,27 @@ msgid "" msgstr "" # 3606042b1e0e4d1da88b4c4947967a75 -#: ../src/Doc/library/subprocess.rst:665 +#: library/subprocess.rst:665 msgid "" "Specifies that the :attr:`STARTUPINFO.wShowWindow` attribute contains " "additional information." msgstr "" # d70ca7242d46448b8db2495ccc81abe2 -#: ../src/Doc/library/subprocess.rst:670 +#: library/subprocess.rst:670 msgid "" "The new process has a new console, instead of inheriting its parent's " "console (the default)." msgstr "" # 6efe94072800445e9d6c83c04cd8801f -#: ../src/Doc/library/subprocess.rst:673 +#: library/subprocess.rst:673 msgid "" "This flag is always set when :class:`Popen` is created with ``shell=True``." msgstr "" # 051f9de3847d454cbda9d3ef2e5aaf95 -#: ../src/Doc/library/subprocess.rst:677 +#: library/subprocess.rst:677 msgid "" "A :class:`Popen` ``creationflags`` parameter to specify that a new process " "group will be created. This flag is necessary for using :func:`os.kill` on " @@ -100611,24 +102713,24 @@ msgid "" msgstr "" # fcb59d246af348108fd9b6d5aef20423 -#: ../src/Doc/library/subprocess.rst:681 +#: library/subprocess.rst:681 msgid "This flag is ignored if :data:`CREATE_NEW_CONSOLE` is specified." msgstr "" # 367801db09bb48c9901d8e68397144ed -#: ../src/Doc/library/subprocess.rst:687 +#: library/subprocess.rst:687 msgid "Replacing Older Functions with the :mod:`subprocess` Module" msgstr "" # 3470f296dd8545c5872db8f8baf9f747 -#: ../src/Doc/library/subprocess.rst:689 +#: library/subprocess.rst:689 msgid "" "In this section, \"a becomes b\" means that b can be used as a replacement " "for a." msgstr "" # 49ef01b6de2e41d49b7ff172ae52a792 -#: ../src/Doc/library/subprocess.rst:693 +#: library/subprocess.rst:693 msgid "" "All \"a\" functions in this section fail (more or less) silently if the " "executed program cannot be found; the \"b\" replacements raise :exc:" @@ -100636,7 +102738,7 @@ msgid "" msgstr "" # 5fa49bb7be954aaa87ccf71516ec4962 -#: ../src/Doc/library/subprocess.rst:697 +#: library/subprocess.rst:697 msgid "" "In addition, the replacements using :func:`check_output` will fail with a :" "exc:`CalledProcessError` if the requested operation produces a non-zero " @@ -100645,125 +102747,125 @@ msgid "" msgstr "" # 2d8d5105d1f74d11a709be005d5c5c3f -#: ../src/Doc/library/subprocess.rst:702 +#: library/subprocess.rst:702 msgid "" "In the following examples, we assume that the relevant functions have " "already been imported from the :mod:`subprocess` module." msgstr "" -#: ../src/Doc/library/subprocess.rst:707 +#: library/subprocess.rst:707 msgid "Replacing /bin/sh shell backquote" msgstr "" -#: ../src/Doc/library/subprocess.rst:717 +#: library/subprocess.rst:717 msgid "Replacing shell pipeline" msgstr "" # 00bad569be724876aae75fecf2714f5d -#: ../src/Doc/library/subprocess.rst:728 +#: library/subprocess.rst:728 msgid "" "The p1.stdout.close() call after starting the p2 is important in order for " "p1 to receive a SIGPIPE if p2 exits before p1." msgstr "" # 8e3131dabddb4700a8e65353c8f76a06 -#: ../src/Doc/library/subprocess.rst:731 +#: library/subprocess.rst:731 msgid "" "Alternatively, for trusted input, the shell's own pipeline support may still " "be used directly::" msgstr "" -#: ../src/Doc/library/subprocess.rst:740 +#: library/subprocess.rst:740 msgid "Replacing :func:`os.system`" msgstr "" -#: ../src/Doc/library/subprocess.rst:750 +#: library/subprocess.rst:750 msgid "Calling the program through the shell is usually not required." msgstr "" -#: ../src/Doc/library/subprocess.rst:752 +#: library/subprocess.rst:752 msgid "A more realistic example would look like this::" msgstr "" -#: ../src/Doc/library/subprocess.rst:765 +#: library/subprocess.rst:765 msgid "Replacing the :func:`os.spawn <os.spawnl>` family" msgstr "" -#: ../src/Doc/library/subprocess.rst:767 +#: library/subprocess.rst:767 msgid "P_NOWAIT example::" msgstr "" -#: ../src/Doc/library/subprocess.rst:773 +#: library/subprocess.rst:773 msgid "P_WAIT example::" msgstr "" -#: ../src/Doc/library/subprocess.rst:779 +#: library/subprocess.rst:779 msgid "Vector example::" msgstr "" -#: ../src/Doc/library/subprocess.rst:785 +#: library/subprocess.rst:785 msgid "Environment example::" msgstr "" -#: ../src/Doc/library/subprocess.rst:793 +#: library/subprocess.rst:793 msgid "Replacing :func:`os.popen`, :func:`os.popen2`, :func:`os.popen3`" msgstr "" # a1bafce01a1b404e88bcba7444663b2b -#: ../src/Doc/library/subprocess.rst:836 +#: library/subprocess.rst:836 msgid "" "On Unix, os.popen2, os.popen3 and os.popen4 also accept a sequence as the " "command to execute, in which case arguments will be passed directly to the " "program without shell intervention. This usage can be replaced as follows::" msgstr "" -#: ../src/Doc/library/subprocess.rst:847 +#: library/subprocess.rst:847 msgid "Return code handling translates as follows::" msgstr "" -#: ../src/Doc/library/subprocess.rst:863 +#: library/subprocess.rst:863 msgid "Replacing functions from the :mod:`popen2` module" msgstr "" # ff78d0654c8e443199611983666cb17e -#: ../src/Doc/library/subprocess.rst:873 +#: library/subprocess.rst:873 msgid "" "On Unix, popen2 also accepts a sequence as the command to execute, in which " "case arguments will be passed directly to the program without shell " "intervention. This usage can be replaced as follows::" msgstr "" -#: ../src/Doc/library/subprocess.rst:884 +#: library/subprocess.rst:884 msgid "" ":class:`popen2.Popen3` and :class:`popen2.Popen4` basically work as :class:" "`subprocess.Popen`, except that:" msgstr "" -#: ../src/Doc/library/subprocess.rst:887 +#: library/subprocess.rst:887 msgid ":class:`Popen` raises an exception if the execution fails." msgstr "" -#: ../src/Doc/library/subprocess.rst:889 +#: library/subprocess.rst:889 msgid "the *capturestderr* argument is replaced with the *stderr* argument." msgstr "" -#: ../src/Doc/library/subprocess.rst:891 +#: library/subprocess.rst:891 msgid "``stdin=PIPE`` and ``stdout=PIPE`` must be specified." msgstr "" -#: ../src/Doc/library/subprocess.rst:893 +#: library/subprocess.rst:893 msgid "" "popen2 closes all file descriptors by default, but you have to specify " "``close_fds=True`` with :class:`Popen`." msgstr "" # 3b0c960987004b6598d784745281fe0a -#: ../src/Doc/library/subprocess.rst:903 +#: library/subprocess.rst:903 msgid "Converting an argument sequence to a string on Windows" msgstr "" # 879f52094e9f449e81e416333eba0801 -#: ../src/Doc/library/subprocess.rst:905 +#: library/subprocess.rst:905 msgid "" "On Windows, an *args* sequence is converted to a string that can be parsed " "using the following rules (which correspond to the rules used by the MS C " @@ -100771,13 +102873,13 @@ msgid "" msgstr "" # 10c71a6a1e7942c6b1881e3b9bb1e1c5 -#: ../src/Doc/library/subprocess.rst:909 +#: library/subprocess.rst:909 msgid "" "Arguments are delimited by white space, which is either a space or a tab." msgstr "" # eddbaa271f944bdd90dc62476181123c -#: ../src/Doc/library/subprocess.rst:912 +#: library/subprocess.rst:912 msgid "" "A string surrounded by double quotation marks is interpreted as a single " "argument, regardless of white space contained within. A quoted string can " @@ -100785,21 +102887,21 @@ msgid "" msgstr "" # f2b4f419daf247aa9580cfeaa7b02acb -#: ../src/Doc/library/subprocess.rst:917 +#: library/subprocess.rst:917 msgid "" "A double quotation mark preceded by a backslash is interpreted as a literal " "double quotation mark." msgstr "" # 4679a7dcedb74b7d90925fe548135a02 -#: ../src/Doc/library/subprocess.rst:920 +#: library/subprocess.rst:920 msgid "" "Backslashes are interpreted literally, unless they immediately precede a " "double quotation mark." msgstr "" # 1a73c46357584ed3944bd42746f30935 -#: ../src/Doc/library/subprocess.rst:923 +#: library/subprocess.rst:923 msgid "" "If backslashes immediately precede a double quotation mark, every pair of " "backslashes is interpreted as a literal backslash. If the number of " @@ -100808,336 +102910,348 @@ msgid "" msgstr "" # 750945a70fba4907b1edafe7de4d96d9 -#: ../src/Doc/library/sun.rst:6 +#: library/sun.rst:6 msgid "SunOS Specific Services" msgstr "" # 7c15cef596b14c6e86bc4786e690f0c4 -#: ../src/Doc/library/sun.rst:8 +#: library/sun.rst:8 msgid "" "The modules described in this chapter provide interfaces to features that " "are unique to SunOS 5 (also known as Solaris version 2)." msgstr "" -#: ../src/Doc/library/sunau.rst:2 +#: library/sunau.rst:2 msgid ":mod:`sunau` --- Read and write Sun AU files" msgstr "" # 4231967c6917471cb4d5597f44dec3ae -#: ../src/Doc/library/sunau.rst:8 +#: library/sunau.rst:8 msgid "**Source code:** :source:`Lib/sunau.py`" msgstr "" -#: ../src/Doc/library/sunau.rst:12 +#: library/sunau.rst:12 msgid "" "The :mod:`sunau` module provides a convenient interface to the Sun AU sound " "format. Note that this module is interface-compatible with the modules :mod:" "`aifc` and :mod:`wave`." msgstr "" -#: ../src/Doc/library/sunau.rst:16 +#: library/sunau.rst:16 msgid "" "An audio file consists of a header followed by the data. The fields of the " "header are:" msgstr "" -#: ../src/Doc/library/sunau.rst:22 +#: library/sunau.rst:22 msgid "magic word" msgstr "" -#: ../src/Doc/library/sunau.rst:22 +#: library/sunau.rst:22 msgid "The four bytes ``.snd``." msgstr "" -#: ../src/Doc/library/sunau.rst:24 +#: library/sunau.rst:24 msgid "header size" msgstr "" -#: ../src/Doc/library/sunau.rst:24 +#: library/sunau.rst:24 msgid "Size of the header, including info, in bytes." msgstr "" -#: ../src/Doc/library/sunau.rst:26 +#: library/sunau.rst:26 msgid "data size" msgstr "" -#: ../src/Doc/library/sunau.rst:26 +#: library/sunau.rst:26 msgid "Physical size of the data, in bytes." msgstr "" -#: ../src/Doc/library/sunau.rst:28 +#: library/sunau.rst:28 msgid "encoding" msgstr "" -#: ../src/Doc/library/sunau.rst:28 +#: library/sunau.rst:28 msgid "Indicates how the audio samples are encoded." msgstr "" -#: ../src/Doc/library/sunau.rst:30 +#: library/sunau.rst:30 msgid "sample rate" msgstr "" -#: ../src/Doc/library/sunau.rst:30 +#: library/sunau.rst:30 msgid "The sampling rate." msgstr "" -#: ../src/Doc/library/sunau.rst:32 +#: library/sunau.rst:32 msgid "# of channels" msgstr "" -#: ../src/Doc/library/sunau.rst:32 +#: library/sunau.rst:32 msgid "The number of channels in the samples." msgstr "" -#: ../src/Doc/library/sunau.rst:34 +#: library/sunau.rst:34 msgid "info" msgstr "" -#: ../src/Doc/library/sunau.rst:34 +#: library/sunau.rst:34 msgid "" "ASCII string giving a description of the audio file (padded with null bytes)." msgstr "" -#: ../src/Doc/library/sunau.rst:38 +#: library/sunau.rst:38 msgid "" "Apart from the info field, all header fields are 4 bytes in size. They are " "all 32-bit unsigned integers encoded in big-endian byte order." msgstr "" -#: ../src/Doc/library/sunau.rst:41 +#: library/sunau.rst:41 msgid "The :mod:`sunau` module defines the following functions:" msgstr "" -#: ../src/Doc/library/sunau.rst:46 +#: library/sunau.rst:46 msgid "" "If *file* is a string, open the file by that name, otherwise treat it as a " "seekable file-like object. *mode* can be any of" msgstr "" -#: ../src/Doc/library/sunau.rst:50 ../src/Doc/library/wave.rst:25 +#: library/sunau.rst:50 +msgid "'r'" +msgstr "" + +#: library/sunau.rst:50 library/wave.rst:25 msgid "Read only mode." msgstr "" -#: ../src/Doc/library/sunau.rst:53 ../src/Doc/library/wave.rst:28 +#: library/sunau.rst:53 +msgid "'w'" +msgstr "" + +#: library/sunau.rst:53 library/wave.rst:28 msgid "Write only mode." msgstr "" -#: ../src/Doc/library/sunau.rst:55 +#: library/sunau.rst:55 msgid "Note that it does not allow read/write files." msgstr "" -#: ../src/Doc/library/sunau.rst:57 +#: library/sunau.rst:57 msgid "" "A *mode* of ``'r'`` returns a :class:`AU_read` object, while a *mode* of " "``'w'`` or ``'wb'`` returns a :class:`AU_write` object." msgstr "" -#: ../src/Doc/library/sunau.rst:63 ../src/Doc/library/wave.rst:45 +#: library/sunau.rst:63 library/wave.rst:45 msgid "A synonym for :func:`.open`, maintained for backwards compatibility." msgstr "" -#: ../src/Doc/library/sunau.rst:66 +#: library/sunau.rst:66 msgid "The :mod:`sunau` module defines the following exception:" msgstr "" -#: ../src/Doc/library/sunau.rst:70 +#: library/sunau.rst:70 msgid "" "An error raised when something is impossible because of Sun AU specs or " "implementation deficiency." msgstr "" -#: ../src/Doc/library/sunau.rst:74 +#: library/sunau.rst:74 msgid "The :mod:`sunau` module defines the following data items:" msgstr "" -#: ../src/Doc/library/sunau.rst:78 +#: library/sunau.rst:78 msgid "" "An integer every valid Sun AU file begins with, stored in big-endian form. " "This is the string ``.snd`` interpreted as an integer." msgstr "" -#: ../src/Doc/library/sunau.rst:89 +#: library/sunau.rst:89 msgid "" "Values of the encoding field from the AU header which are supported by this " "module." msgstr "" -#: ../src/Doc/library/sunau.rst:100 +#: library/sunau.rst:100 msgid "" "Additional known values of the encoding field from the AU header, but which " "are not supported by this module." msgstr "" -#: ../src/Doc/library/sunau.rst:107 +#: library/sunau.rst:107 msgid "AU_read Objects" msgstr "" -#: ../src/Doc/library/sunau.rst:109 +#: library/sunau.rst:109 msgid "" "AU_read objects, as returned by :func:`.open` above, have the following " "methods:" msgstr "" -#: ../src/Doc/library/sunau.rst:114 +#: library/sunau.rst:114 msgid "" "Close the stream, and make the instance unusable. (This is called " "automatically on deletion.)" msgstr "" -#: ../src/Doc/library/sunau.rst:120 +#: library/sunau.rst:120 msgid "Returns number of audio channels (1 for mone, 2 for stereo)." msgstr "" -#: ../src/Doc/library/sunau.rst:125 ../src/Doc/library/wave.rst:75 +#: library/sunau.rst:125 library/wave.rst:75 msgid "Returns sample width in bytes." msgstr "" -#: ../src/Doc/library/sunau.rst:130 ../src/Doc/library/wave.rst:80 +#: library/sunau.rst:130 library/wave.rst:80 msgid "Returns sampling frequency." msgstr "" -#: ../src/Doc/library/sunau.rst:135 ../src/Doc/library/wave.rst:85 +#: library/sunau.rst:135 library/wave.rst:85 msgid "Returns number of audio frames." msgstr "" -#: ../src/Doc/library/sunau.rst:140 +#: library/sunau.rst:140 msgid "" "Returns compression type. Supported compression types are ``'ULAW'``, " "``'ALAW'`` and ``'NONE'``." msgstr "" -#: ../src/Doc/library/sunau.rst:146 +#: library/sunau.rst:146 msgid "" "Human-readable version of :meth:`getcomptype`. The supported types have the " "respective names ``'CCITT G.711 u-law'``, ``'CCITT G.711 A-law'`` and ``'not " "compressed'``." msgstr "" -#: ../src/Doc/library/sunau.rst:153 ../src/Doc/library/wave.rst:101 +#: library/sunau.rst:153 library/wave.rst:101 msgid "" "Returns a tuple ``(nchannels, sampwidth, framerate, nframes, comptype, " "compname)``, equivalent to output of the :meth:`get\\*` methods." msgstr "" -#: ../src/Doc/library/sunau.rst:159 +#: library/sunau.rst:159 msgid "" "Reads and returns at most *n* frames of audio, as a string of bytes. The " "data will be returned in linear format. If the original data is in u-LAW " "format, it will be converted." msgstr "" -#: ../src/Doc/library/sunau.rst:166 ../src/Doc/library/wave.rst:112 +#: library/sunau.rst:166 library/wave.rst:112 msgid "Rewind the file pointer to the beginning of the audio stream." msgstr "" -#: ../src/Doc/library/sunau.rst:168 ../src/Doc/library/wave.rst:127 +#: library/sunau.rst:168 library/wave.rst:127 msgid "" "The following two methods define a term \"position\" which is compatible " "between them, and is otherwise implementation dependent." msgstr "" -#: ../src/Doc/library/sunau.rst:174 +#: library/sunau.rst:174 msgid "" "Set the file pointer to the specified position. Only values returned from :" "meth:`tell` should be used for *pos*." msgstr "" -#: ../src/Doc/library/sunau.rst:180 +#: library/sunau.rst:180 msgid "" "Return current file pointer position. Note that the returned value has " "nothing to do with the actual position in the file." msgstr "" -#: ../src/Doc/library/sunau.rst:183 +#: library/sunau.rst:183 msgid "" "The following two functions are defined for compatibility with the :mod:" "`aifc`, and don't do anything interesting." msgstr "" -#: ../src/Doc/library/sunau.rst:189 ../src/Doc/library/wave.rst:120 +#: library/sunau.rst:189 library/wave.rst:120 msgid "Returns ``None``." msgstr "" -#: ../src/Doc/library/sunau.rst:194 ../src/Doc/library/wave.rst:125 +#: library/sunau.rst:194 library/wave.rst:125 msgid "Raise an error." msgstr "" -#: ../src/Doc/library/sunau.rst:200 +#: library/sunau.rst:200 msgid "AU_write Objects" msgstr "" -#: ../src/Doc/library/sunau.rst:202 +#: library/sunau.rst:202 msgid "" "AU_write objects, as returned by :func:`.open` above, have the following " "methods:" msgstr "" -#: ../src/Doc/library/sunau.rst:207 ../src/Doc/library/wave.rst:157 +#: library/sunau.rst:207 library/wave.rst:157 msgid "Set the number of channels." msgstr "" -#: ../src/Doc/library/sunau.rst:212 +#: library/sunau.rst:212 msgid "Set the sample width (in bytes.)" msgstr "" -#: ../src/Doc/library/sunau.rst:217 +#: library/sunau.rst:217 msgid "Set the frame rate." msgstr "" -#: ../src/Doc/library/sunau.rst:222 +#: library/sunau.rst:222 msgid "" "Set the number of frames. This can be later changed, when and if more " "frames are written." msgstr "" -#: ../src/Doc/library/sunau.rst:228 +#: library/sunau.rst:228 msgid "" "Set the compression type and description. Only ``'NONE'`` and ``'ULAW'`` are " "supported on output." msgstr "" -#: ../src/Doc/library/sunau.rst:234 +#: library/sunau.rst:234 msgid "" "The *tuple* should be ``(nchannels, sampwidth, framerate, nframes, comptype, " "compname)``, with values valid for the :meth:`set\\*` methods. Set all " "parameters." msgstr "" -#: ../src/Doc/library/sunau.rst:241 +#: library/sunau.rst:241 msgid "" "Return current position in the file, with the same disclaimer for the :meth:" "`AU_read.tell` and :meth:`AU_read.setpos` methods." msgstr "" -#: ../src/Doc/library/sunau.rst:247 ../src/Doc/library/wave.rst:197 +#: library/sunau.rst:247 library/wave.rst:197 msgid "Write audio frames, without correcting *nframes*." msgstr "" -#: ../src/Doc/library/sunau.rst:252 ../src/Doc/library/wave.rst:202 +#: library/sunau.rst:252 library/wave.rst:202 msgid "Write audio frames and make sure *nframes* is correct." msgstr "" -#: ../src/Doc/library/sunau.rst:257 +#: library/sunau.rst:257 msgid "Make sure *nframes* is correct, and close the file." msgstr "" -#: ../src/Doc/library/sunau.rst:259 +#: library/sunau.rst:259 msgid "This method is called upon deletion." msgstr "" -#: ../src/Doc/library/sunau.rst:261 +#: library/sunau.rst:261 msgid "" "Note that it is invalid to set any parameters after calling :meth:" "`writeframes` or :meth:`writeframesraw`." msgstr "" # 7afa8e9d77a546aa9c277b43545d7f45 -#: ../src/Doc/library/sunaudio.rst:3 +#: library/sunaudio.rst:3 msgid ":mod:`sunaudiodev` --- Access to Sun audio hardware" msgstr "" +#: library/sunaudio.rst:10 +msgid "The :mod:`sunaudiodev` module has been removed in Python 3." +msgstr "" + # 369bf6a7cc064643a0316efaee809960 -#: ../src/Doc/library/sunaudio.rst:17 +#: library/sunaudio.rst:17 msgid "" "This module allows you to access the Sun audio interface. The Sun audio " "hardware is capable of recording and playing back audio data in u-LAW format " @@ -101146,26 +103260,26 @@ msgid "" msgstr "" # bd4da5ed5d76466081416f3364f85e66 -#: ../src/Doc/library/sunaudio.rst:24 +#: library/sunaudio.rst:24 msgid "" "The module :mod:`SUNAUDIODEV` defines constants which may be used with this " "module." msgstr "" # ccd104204dc247349a41b7837a2d9f9c -#: ../src/Doc/library/sunaudio.rst:27 +#: library/sunaudio.rst:27 msgid "This module defines the following variables and functions:" msgstr "" # 57dd27d7b75d44d6b8ec1da150884061 -#: ../src/Doc/library/sunaudio.rst:32 +#: library/sunaudio.rst:32 msgid "" "This exception is raised on all errors. The argument is a string describing " "what went wrong." msgstr "" # e8e148d61b7f4921ad83424fd5705757 -#: ../src/Doc/library/sunaudio.rst:38 +#: library/sunaudio.rst:38 msgid "" "This function opens the audio device and returns a Sun audio device object. " "This object can then be used to do I/O on. The *mode* parameter is one of " @@ -101177,7 +103291,7 @@ msgid "" msgstr "" # 24873b9a34314313a721fd5f4b736c43 -#: ../src/Doc/library/sunaudio.rst:46 +#: library/sunaudio.rst:46 msgid "" "As per the manpage, this module first looks in the environment variable " "``AUDIODEV`` for the base audio device filename. If not found, it falls " @@ -101186,7 +103300,7 @@ msgid "" msgstr "" # fafd4db783bd469787397d065a579507 -#: ../src/Doc/library/sunaudio.rst:57 +#: library/sunaudio.rst:57 msgid "" "The audio device objects are returned by :func:`.open` define the following " "methods (except ``control`` objects which only provide :meth:`getinfo`, :" @@ -101194,7 +103308,7 @@ msgid "" msgstr "" # fb78226355484ca085204c0141ecb379 -#: ../src/Doc/library/sunaudio.rst:64 +#: library/sunaudio.rst:64 msgid "" "This method explicitly closes the device. It is useful in situations where " "deleting the object does not immediately close it since there are other " @@ -101202,14 +103316,14 @@ msgid "" msgstr "" # 28a56a1142584df4babb2190b52d0367 -#: ../src/Doc/library/sunaudio.rst:71 +#: library/sunaudio.rst:71 msgid "" "Returns the file descriptor associated with the device. This can be used to " "set up ``SIGPOLL`` notification, as described below." msgstr "" # 5b7c0737448d43b3a7aaa668aaa29133 -#: ../src/Doc/library/sunaudio.rst:77 +#: library/sunaudio.rst:77 msgid "" "This method waits until all pending output is processed and then returns. " "Calling this method is often not necessary: destroying the object will " @@ -101217,7 +103331,7 @@ msgid "" msgstr "" # 56c01bc377154828b5a18b33ba1aed90 -#: ../src/Doc/library/sunaudio.rst:84 +#: library/sunaudio.rst:84 msgid "" "This method discards all pending output. It can be used avoid the slow " "response to a user's stop request (due to buffering of up to one second of " @@ -101225,7 +103339,7 @@ msgid "" msgstr "" # b8fb43c17ace4f98811e2d221c6846e7 -#: ../src/Doc/library/sunaudio.rst:90 +#: library/sunaudio.rst:90 msgid "" "This method retrieves status information like input and output volume, etc. " "and returns it in the form of an audio status object. This object has no " @@ -101241,7 +103355,7 @@ msgid "" msgstr "" # ab53842042be4cf99c6efdcd6f328f58 -#: ../src/Doc/library/sunaudio.rst:105 +#: library/sunaudio.rst:105 msgid "" "This method returns the number of samples that are buffered on the recording " "side, i.e. the program will not block on a :func:`read` call of so many " @@ -101249,7 +103363,7 @@ msgid "" msgstr "" # 639700fc45fb499f8d5fe922d59cbccb -#: ../src/Doc/library/sunaudio.rst:111 +#: library/sunaudio.rst:111 msgid "" "This method returns the number of samples buffered on the playback side. " "Unfortunately, this number cannot be used to determine a number of samples " @@ -101258,14 +103372,14 @@ msgid "" msgstr "" # 40e8b0b57a864d82b9904a68d33416dd -#: ../src/Doc/library/sunaudio.rst:119 +#: library/sunaudio.rst:119 msgid "" "This method reads *size* samples from the audio input and returns them as a " "Python string. The function blocks until enough data is available." msgstr "" # 7598687be6b1437b95ad16d65edadd12 -#: ../src/Doc/library/sunaudio.rst:125 +#: library/sunaudio.rst:125 msgid "" "This method sets the audio device status parameters. The *status* parameter " "is an device status object as returned by :func:`getinfo` and possibly " @@ -101273,7 +103387,7 @@ msgid "" msgstr "" # 1dc15fb773fd4dd29f073d1eadb75f1e -#: ../src/Doc/library/sunaudio.rst:132 +#: library/sunaudio.rst:132 msgid "" "Write is passed a Python string containing audio samples to be played. If " "there is enough buffer space free it will immediately return, otherwise it " @@ -101281,7 +103395,7 @@ msgid "" msgstr "" # c1b48f8ddc21408388e2751951b4fb07 -#: ../src/Doc/library/sunaudio.rst:135 +#: library/sunaudio.rst:135 msgid "" "The audio device supports asynchronous notification of various events, " "through the SIGPOLL signal. Here's an example of how you might enable this " @@ -101289,12 +103403,16 @@ msgid "" msgstr "" # da67403b0a1f4412a28ace21fcd54b1a -#: ../src/Doc/library/sunaudio.rst:148 +#: library/sunaudio.rst:148 msgid ":mod:`SUNAUDIODEV` --- Constants used with :mod:`sunaudiodev`" msgstr "" +#: library/sunaudio.rst:155 +msgid "The :mod:`SUNAUDIODEV` module has been removed in Python 3." +msgstr "" + # 1b844fb15028418ba288ddd519970d4d -#: ../src/Doc/library/sunaudio.rst:162 +#: library/sunaudio.rst:162 msgid "" "This is a companion module to :mod:`sunaudiodev` which defines useful " "symbolic constants like :const:`MIN_GAIN`, :const:`MAX_GAIN`, :const:" @@ -101303,16 +103421,16 @@ msgid "" "stripped." msgstr "" -#: ../src/Doc/library/symbol.rst:2 +#: library/symbol.rst:2 msgid ":mod:`symbol` --- Constants used with Python parse trees" msgstr "" # 5b078217f5ce41d090e6a85f0224ecf6 -#: ../src/Doc/library/symbol.rst:8 +#: library/symbol.rst:8 msgid "**Source code:** :source:`Lib/symbol.py`" msgstr "" -#: ../src/Doc/library/symbol.rst:12 +#: library/symbol.rst:12 msgid "" "This module provides constants which represent the numeric values of " "internal nodes of the parse tree. Unlike most Python constants, these use " @@ -101322,27 +103440,27 @@ msgid "" "between Python versions." msgstr "" -#: ../src/Doc/library/symbol.rst:19 +#: library/symbol.rst:19 msgid "This module also provides one additional data object:" msgstr "" -#: ../src/Doc/library/symbol.rst:24 ../src/Doc/library/token.rst:24 +#: library/symbol.rst:24 library/token.rst:24 msgid "" "Dictionary mapping the numeric values of the constants defined in this " "module back to name strings, allowing more human-readable representation of " "parse trees to be generated." msgstr "" -#: ../src/Doc/library/symtable.rst:2 +#: library/symtable.rst:2 msgid ":mod:`symtable` --- Access to the compiler's symbol tables" msgstr "" # f7556c0b12194d9e8f0ba349ad13a823 -#: ../src/Doc/library/symtable.rst:7 +#: library/symtable.rst:7 msgid "**Source code:** :source:`Lib/symtable.py`" msgstr "" -#: ../src/Doc/library/symtable.rst:15 +#: library/symtable.rst:15 msgid "" "Symbol tables are generated by the compiler from AST just before bytecode is " "generated. The symbol table is responsible for calculating the scope of " @@ -101350,198 +103468,198 @@ msgid "" "examine these tables." msgstr "" -#: ../src/Doc/library/symtable.rst:22 +#: library/symtable.rst:22 msgid "Generating Symbol Tables" msgstr "" -#: ../src/Doc/library/symtable.rst:26 +#: library/symtable.rst:26 msgid "" "Return the toplevel :class:`SymbolTable` for the Python source *code*. " "*filename* is the name of the file containing the code. *compile_type* is " "like the *mode* argument to :func:`compile`." msgstr "" -#: ../src/Doc/library/symtable.rst:32 +#: library/symtable.rst:32 msgid "Examining Symbol Tables" msgstr "" -#: ../src/Doc/library/symtable.rst:36 +#: library/symtable.rst:36 msgid "A namespace table for a block. The constructor is not public." msgstr "" -#: ../src/Doc/library/symtable.rst:40 +#: library/symtable.rst:40 msgid "" "Return the type of the symbol table. Possible values are ``'class'``, " "``'module'``, and ``'function'``." msgstr "" -#: ../src/Doc/library/symtable.rst:45 +#: library/symtable.rst:45 msgid "Return the table's identifier." msgstr "" -#: ../src/Doc/library/symtable.rst:49 +#: library/symtable.rst:49 msgid "" "Return the table's name. This is the name of the class if the table is for " "a class, the name of the function if the table is for a function, or " "``'top'`` if the table is global (:meth:`get_type` returns ``'module'``)." msgstr "" -#: ../src/Doc/library/symtable.rst:55 +#: library/symtable.rst:55 msgid "Return the number of the first line in the block this table represents." msgstr "" -#: ../src/Doc/library/symtable.rst:59 +#: library/symtable.rst:59 msgid "Return ``True`` if the locals in this table can be optimized." msgstr "" -#: ../src/Doc/library/symtable.rst:63 +#: library/symtable.rst:63 msgid "Return ``True`` if the block is a nested class or function." msgstr "" -#: ../src/Doc/library/symtable.rst:67 +#: library/symtable.rst:67 msgid "" "Return ``True`` if the block has nested namespaces within it. These can be " "obtained with :meth:`get_children`." msgstr "" -#: ../src/Doc/library/symtable.rst:72 +#: library/symtable.rst:72 msgid "Return ``True`` if the block uses ``exec``." msgstr "" -#: ../src/Doc/library/symtable.rst:76 +#: library/symtable.rst:76 msgid "Return ``True`` if the block uses a starred from-import." msgstr "" -#: ../src/Doc/library/symtable.rst:80 +#: library/symtable.rst:80 msgid "Return a list of names of symbols in this table." msgstr "" -#: ../src/Doc/library/symtable.rst:84 +#: library/symtable.rst:84 msgid "Lookup *name* in the table and return a :class:`Symbol` instance." msgstr "" -#: ../src/Doc/library/symtable.rst:88 +#: library/symtable.rst:88 msgid "Return a list of :class:`Symbol` instances for names in the table." msgstr "" -#: ../src/Doc/library/symtable.rst:92 +#: library/symtable.rst:92 msgid "Return a list of the nested symbol tables." msgstr "" -#: ../src/Doc/library/symtable.rst:97 +#: library/symtable.rst:97 msgid "" "A namespace for a function or method. This class inherits :class:" "`SymbolTable`." msgstr "" -#: ../src/Doc/library/symtable.rst:102 +#: library/symtable.rst:102 msgid "Return a tuple containing names of parameters to this function." msgstr "" -#: ../src/Doc/library/symtable.rst:106 +#: library/symtable.rst:106 msgid "Return a tuple containing names of locals in this function." msgstr "" -#: ../src/Doc/library/symtable.rst:110 +#: library/symtable.rst:110 msgid "Return a tuple containing names of globals in this function." msgstr "" -#: ../src/Doc/library/symtable.rst:114 +#: library/symtable.rst:114 msgid "Return a tuple containing names of free variables in this function." msgstr "" -#: ../src/Doc/library/symtable.rst:119 +#: library/symtable.rst:119 msgid "A namespace of a class. This class inherits :class:`SymbolTable`." msgstr "" -#: ../src/Doc/library/symtable.rst:123 +#: library/symtable.rst:123 msgid "Return a tuple containing the names of methods declared in the class." msgstr "" -#: ../src/Doc/library/symtable.rst:128 +#: library/symtable.rst:128 msgid "" "An entry in a :class:`SymbolTable` corresponding to an identifier in the " "source. The constructor is not public." msgstr "" -#: ../src/Doc/library/symtable.rst:133 +#: library/symtable.rst:133 msgid "Return the symbol's name." msgstr "" -#: ../src/Doc/library/symtable.rst:137 +#: library/symtable.rst:137 msgid "Return ``True`` if the symbol is used in its block." msgstr "" -#: ../src/Doc/library/symtable.rst:141 +#: library/symtable.rst:141 msgid "Return ``True`` if the symbol is created from an import statement." msgstr "" -#: ../src/Doc/library/symtable.rst:145 +#: library/symtable.rst:145 msgid "Return ``True`` if the symbol is a parameter." msgstr "" -#: ../src/Doc/library/symtable.rst:149 +#: library/symtable.rst:149 msgid "Return ``True`` if the symbol is global." msgstr "" -#: ../src/Doc/library/symtable.rst:153 +#: library/symtable.rst:153 msgid "" "Return ``True`` if the symbol is declared global with a global statement." msgstr "" -#: ../src/Doc/library/symtable.rst:157 +#: library/symtable.rst:157 msgid "Return ``True`` if the symbol is local to its block." msgstr "" -#: ../src/Doc/library/symtable.rst:161 +#: library/symtable.rst:161 msgid "" "Return ``True`` if the symbol is referenced in its block, but not assigned " "to." msgstr "" -#: ../src/Doc/library/symtable.rst:166 +#: library/symtable.rst:166 msgid "Return ``True`` if the symbol is assigned to in its block." msgstr "" -#: ../src/Doc/library/symtable.rst:170 +#: library/symtable.rst:170 msgid "Return ``True`` if name binding introduces new namespace." msgstr "" -#: ../src/Doc/library/symtable.rst:172 +#: library/symtable.rst:172 msgid "" "If the name is used as the target of a function or class statement, this " "will be true." msgstr "" -#: ../src/Doc/library/symtable.rst:181 +#: library/symtable.rst:181 msgid "" "Note that a single name can be bound to multiple objects. If the result is " "``True``, the name may also be bound to other objects, like an int or list, " "that does not introduce a new namespace." msgstr "" -#: ../src/Doc/library/symtable.rst:187 +#: library/symtable.rst:187 msgid "Return a list of namespaces bound to this name." msgstr "" -#: ../src/Doc/library/symtable.rst:191 +#: library/symtable.rst:191 msgid "" "Return the namespace bound to this name. If more than one namespace is " "bound, a :exc:`ValueError` is raised." msgstr "" -#: ../src/Doc/library/sys.rst:2 +#: library/sys.rst:2 msgid ":mod:`sys` --- System-specific parameters and functions" msgstr "" -#: ../src/Doc/library/sys.rst:8 +#: library/sys.rst:8 msgid "" "This module provides access to some variables used or maintained by the " "interpreter and to functions that interact strongly with the interpreter. It " "is always available." msgstr "" -#: ../src/Doc/library/sys.rst:15 +#: library/sys.rst:15 msgid "" "The list of command line arguments passed to a Python script. ``argv[0]`` is " "the script name (it is operating system dependent whether this is a full " @@ -101551,20 +103669,20 @@ msgid "" "is the empty string." msgstr "" -#: ../src/Doc/library/sys.rst:21 +#: library/sys.rst:21 msgid "" "To loop over the standard input, or the list of files given on the command " "line, see the :mod:`fileinput` module." msgstr "" -#: ../src/Doc/library/sys.rst:27 +#: library/sys.rst:27 msgid "" "An indicator of the native byte order. This will have the value ``'big'`` " "on big-endian (most-significant byte first) platforms, and ``'little'`` on " "little-endian (least-significant byte first) platforms." msgstr "" -#: ../src/Doc/library/sys.rst:36 +#: library/sys.rst:36 msgid "" "A tuple of strings giving the names of all modules that are compiled into " "this Python interpreter. (This information is not available in any other " @@ -101572,30 +103690,30 @@ msgid "" msgstr "" # ba7c060055ec4ae1ba93a8a8cb8fba6b -#: ../src/Doc/library/sys.rst:43 +#: library/sys.rst:43 msgid "" "Call ``func(*args)``, while tracing is enabled. The tracing state is saved, " "and restored afterwards. This is intended to be called from a debugger from " "a checkpoint, to recursively debug some other code." msgstr "" -#: ../src/Doc/library/sys.rst:50 +#: library/sys.rst:50 msgid "A string containing the copyright pertaining to the Python interpreter." msgstr "" -#: ../src/Doc/library/sys.rst:55 +#: library/sys.rst:55 msgid "" "Clear the internal type cache. The type cache is used to speed up attribute " "and method lookups. Use the function *only* to drop unnecessary references " "during reference leak debugging." msgstr "" -#: ../src/Doc/library/sys.rst:59 ../src/Doc/library/sys.rst:77 +#: library/sys.rst:59 library/sys.rst:77 msgid "" "This function should be used for internal and specialized purposes only." msgstr "" -#: ../src/Doc/library/sys.rst:66 +#: library/sys.rst:66 msgid "" "Return a dictionary mapping each thread's identifier to the topmost stack " "frame currently active in that thread at the time the function is called. " @@ -101603,7 +103721,7 @@ msgid "" "given such a frame." msgstr "" -#: ../src/Doc/library/sys.rst:71 +#: library/sys.rst:71 msgid "" "This is most useful for debugging deadlock: this function does not require " "the deadlocked threads' cooperation, and such threads' call stacks are " @@ -101612,18 +103730,18 @@ msgid "" "by the time calling code examines the frame." msgstr "" -#: ../src/Doc/library/sys.rst:84 +#: library/sys.rst:84 msgid "Integer specifying the handle of the Python DLL. Availability: Windows." msgstr "" # a3a9edea707e4c9380443ebc51360e69 -#: ../src/Doc/library/sys.rst:89 +#: library/sys.rst:89 msgid "" "If *value* is not ``None``, this function prints it to ``sys.stdout``, and " "saves it in ``__builtin__._``." msgstr "" -#: ../src/Doc/library/sys.rst:92 +#: library/sys.rst:92 msgid "" "``sys.displayhook`` is called on the result of evaluating an :term:" "`expression` entered in an interactive Python session. The display of these " @@ -101632,7 +103750,7 @@ msgid "" msgstr "" # a3057d25d9a849cb964c3832e3e7b198 -#: ../src/Doc/library/sys.rst:99 +#: library/sys.rst:99 msgid "" "If this is true, Python won't try to write ``.pyc`` or ``.pyo`` files on the " "import of source modules. This value is initially set to ``True`` or " @@ -101641,12 +103759,12 @@ msgid "" "to control bytecode file generation." msgstr "" -#: ../src/Doc/library/sys.rst:110 +#: library/sys.rst:110 msgid "" "This function prints out a given traceback and exception to ``sys.stderr``." msgstr "" -#: ../src/Doc/library/sys.rst:112 +#: library/sys.rst:112 msgid "" "When an exception is raised and uncaught, the interpreter calls ``sys." "excepthook`` with three arguments, the exception class, exception instance, " @@ -101657,7 +103775,7 @@ msgid "" "excepthook``." msgstr "" -#: ../src/Doc/library/sys.rst:123 +#: library/sys.rst:123 msgid "" "These objects contain the original values of ``displayhook`` and " "``excepthook`` at the start of the program. They are saved so that " @@ -101666,7 +103784,7 @@ msgid "" msgstr "" # 708a9fda0c1d4934aaf2c3fe1b46f0f7 -#: ../src/Doc/library/sys.rst:131 +#: library/sys.rst:131 msgid "" "This function returns a tuple of three values that give information about " "the exception that is currently being handled. The information returned is " @@ -101680,7 +103798,7 @@ msgid "" msgstr "" # 1565ace7e7f9475d881e16004369ca52 -#: ../src/Doc/library/sys.rst:142 +#: library/sys.rst:142 msgid "" "If no exception is being handled anywhere on the stack, a tuple containing " "three ``None`` values is returned. Otherwise, the values returned are " @@ -101694,7 +103812,7 @@ msgid "" msgstr "" # cb36c6f8331f4789943ff334523b8273 -#: ../src/Doc/library/sys.rst:151 +#: library/sys.rst:151 msgid "" "If :func:`exc_clear` is called, this function will return three ``None`` " "values until either another exception is raised in the current thread or the " @@ -101702,7 +103820,7 @@ msgid "" msgstr "" # 20f98ce36afd4646a0002e3d455e479c -#: ../src/Doc/library/sys.rst:157 +#: library/sys.rst:157 msgid "" "Assigning the *traceback* return value to a local variable in a function " "that is handling an exception will cause a circular reference. This will " @@ -101716,7 +103834,7 @@ msgid "" msgstr "" # e14154def4914f7a9540c16a9c92f473 -#: ../src/Doc/library/sys.rst:169 +#: library/sys.rst:169 msgid "" "Beginning with Python 2.2, such cycles are automatically reclaimed when " "garbage collection is enabled and they become unreachable, but it remains " @@ -101724,7 +103842,7 @@ msgid "" msgstr "" # 114be944669e4623a6c6881edfaa8022 -#: ../src/Doc/library/sys.rst:176 +#: library/sys.rst:176 msgid "" "This function clears all information relating to the current or last " "exception that occurred in the current thread. After calling this " @@ -101734,7 +103852,7 @@ msgid "" msgstr "" # ec91f2d364a548ee997726037df8ef82 -#: ../src/Doc/library/sys.rst:182 +#: library/sys.rst:182 msgid "" "This function is only needed in only a few obscure situations. These " "include logging and error handling systems that report information on the " @@ -101743,8 +103861,12 @@ msgid "" "what objects will be freed, if any." msgstr "" +#: library/sys.rst:195 +msgid "Use :func:`exc_info` instead." +msgstr "" + # 0b93ef8f289d43888473643bc58e6def -#: ../src/Doc/library/sys.rst:198 +#: library/sys.rst:198 msgid "" "Since they are global variables, they are not specific to the current " "thread, so their use is not safe in a multi-threaded program. When no " @@ -101753,7 +103875,7 @@ msgid "" msgstr "" # 8ac5cd05eb2a439abe99665c542e700b -#: ../src/Doc/library/sys.rst:205 +#: library/sys.rst:205 msgid "" "A string giving the site-specific directory prefix where the platform-" "dependent Python files are installed; by default, this is also ``'/usr/" @@ -101766,7 +103888,7 @@ msgid "" msgstr "" # 5b99f63167fe41989858f97019ff6cab -#: ../src/Doc/library/sys.rst:217 +#: library/sys.rst:217 msgid "" "A string giving the absolute path of the executable binary for the Python " "interpreter, on systems where this makes sense. If Python is unable to " @@ -101775,7 +103897,7 @@ msgid "" msgstr "" # 36f32dc9553c45788e6eb82f91b952ac -#: ../src/Doc/library/sys.rst:225 +#: library/sys.rst:225 msgid "" "Exit from Python. This is implemented by raising the :exc:`SystemExit` " "exception, so cleanup actions specified by finally clauses of :keyword:`try` " @@ -101784,7 +103906,7 @@ msgid "" msgstr "" # 20e873c4e2f54638afb577fd1caeeb59 -#: ../src/Doc/library/sys.rst:230 +#: library/sys.rst:230 msgid "" "The optional argument *arg* can be an integer giving the exit status " "(defaulting to zero), or another type of object. If it is an integer, zero " @@ -101801,7 +103923,7 @@ msgid "" msgstr "" # 7b61449f860f4044a631fd6197d3b8ad -#: ../src/Doc/library/sys.rst:243 +#: library/sys.rst:243 msgid "" "Since :func:`exit` ultimately \"only\" raises an exception, it will only " "exit the process when called from the main thread, and the exception is not " @@ -101809,7 +103931,7 @@ msgid "" msgstr "" # f2c5657318f143e2bc1d9d821e85a2cb -#: ../src/Doc/library/sys.rst:250 +#: library/sys.rst:250 msgid "" "This value is not actually defined by the module, but can be set by the user " "(or by a program) to specify a clean-up action at program exit. When set, " @@ -101820,173 +103942,181 @@ msgid "" msgstr "" # 96a38174cb9d4ec49bf73e8a9867020b -#: ../src/Doc/library/sys.rst:258 +#: library/sys.rst:258 msgid "" "The exit function is not called when the program is killed by a signal, when " "a Python fatal internal error is detected, or when ``os._exit()`` is called." msgstr "" -#: ../src/Doc/library/sys.rst:267 +#: library/sys.rst:261 +msgid "Use :mod:`atexit` instead." +msgstr "" + +#: library/sys.rst:267 msgid "" "The struct sequence *flags* exposes the status of command line flags. The " "attributes are read only." msgstr "" -#: ../src/Doc/library/sys.rst:271 ../src/Doc/library/sys.rst:308 +#: library/sys.rst:271 library/sys.rst:308 msgid "attribute" msgstr "attribut" -#: ../src/Doc/library/sys.rst:271 ../src/Doc/library/ttk.rst:222 +#: library/sys.rst:271 library/ttk.rst:222 msgid "flag" msgstr "" -#: ../src/Doc/library/sys.rst:273 +#: library/sys.rst:273 msgid ":const:`debug`" msgstr "" # 1a256aa4284d459f955f99058d7f2bd7 -#: ../src/Doc/library/sys.rst:273 +#: library/sys.rst:273 msgid ":option:`-d`" msgstr "" # 26f19e24e9aa480bb084af4e76bd835e -#: ../src/Doc/library/sys.rst:274 +#: library/sys.rst:274 msgid ":const:`py3k_warning`" msgstr "" # 89f9a6e45a7f47da94642e5f4b4b1ae7 -#: ../src/Doc/library/sys.rst:274 +#: library/sys.rst:274 msgid ":option:`-3`" msgstr "" -#: ../src/Doc/library/sys.rst:275 +#: library/sys.rst:275 msgid ":const:`division_warning`" msgstr "" # 60ec27ca4bd547149c61061a1ca086d6 -#: ../src/Doc/library/sys.rst:275 +#: library/sys.rst:275 msgid ":option:`-Q`" msgstr "" # f876fe57e0084db5b328c232ab6789db -#: ../src/Doc/library/sys.rst:276 +#: library/sys.rst:276 msgid ":const:`division_new`" msgstr "" # b8cfadd8e099470891f36fb80cd768a6 -#: ../src/Doc/library/sys.rst:276 +#: library/sys.rst:276 msgid ":option:`-Qnew <-Q>`" msgstr "" -#: ../src/Doc/library/sys.rst:277 +#: library/sys.rst:277 msgid ":const:`inspect`" msgstr "" # 60c19c0c7923425b9a6cdb9672fc856a # 2bf9ae3e3fdd463b8918f50cefb81fcb -#: ../src/Doc/library/sys.rst:277 ../src/Doc/library/sys.rst:278 +#: library/sys.rst:277 library/sys.rst:278 msgid ":option:`-i`" msgstr "" -#: ../src/Doc/library/sys.rst:278 +#: library/sys.rst:278 msgid ":const:`interactive`" msgstr "" -#: ../src/Doc/library/sys.rst:279 +#: library/sys.rst:279 msgid ":const:`optimize`" msgstr "" # 3343156e639044c1a504777741626d99 -#: ../src/Doc/library/sys.rst:279 +#: library/sys.rst:279 msgid ":option:`-O` or :option:`-OO`" msgstr "" -#: ../src/Doc/library/sys.rst:280 +#: library/sys.rst:280 msgid ":const:`dont_write_bytecode`" msgstr "" # 9a1db8a42bd54408b908f3e5fde17ee7 -#: ../src/Doc/library/sys.rst:280 +#: library/sys.rst:280 msgid ":option:`-B`" msgstr "" -#: ../src/Doc/library/sys.rst:281 +#: library/sys.rst:281 msgid ":const:`no_user_site`" msgstr "" # 9a411461813a48eb9115cf2192cf477f -#: ../src/Doc/library/sys.rst:281 +#: library/sys.rst:281 msgid ":option:`-s`" msgstr "" -#: ../src/Doc/library/sys.rst:282 +#: library/sys.rst:282 msgid ":const:`no_site`" msgstr "" # 6aafeab9520140fea918a4b4b7255f54 -#: ../src/Doc/library/sys.rst:282 +#: library/sys.rst:282 msgid ":option:`-S`" msgstr "" -#: ../src/Doc/library/sys.rst:283 +#: library/sys.rst:283 msgid ":const:`ignore_environment`" msgstr "" # decc2eb711c1420ba65ffd6ed38ebb24 -#: ../src/Doc/library/sys.rst:283 +#: library/sys.rst:283 msgid ":option:`-E`" msgstr "" # fbd0449681b0493fb06facf4dd8db37c -#: ../src/Doc/library/sys.rst:284 +#: library/sys.rst:284 msgid ":const:`tabcheck`" msgstr "" # c78d956d8f8044e68a9a6bf00e595782 -#: ../src/Doc/library/sys.rst:284 +#: library/sys.rst:284 msgid ":option:`-t` or :option:`-tt <-t>`" msgstr "" -#: ../src/Doc/library/sys.rst:285 +#: library/sys.rst:285 msgid ":const:`verbose`" msgstr "" # 25bd75e229f140b4b2317de8546aa7e5 -#: ../src/Doc/library/sys.rst:285 +#: library/sys.rst:285 msgid ":option:`-v`" msgstr "" # 620c277a9a8d42a9a529a27a7c164ebc -#: ../src/Doc/library/sys.rst:286 +#: library/sys.rst:286 msgid ":const:`unicode`" msgstr "" # dd96a306bb424891a854e61d717dc056 -#: ../src/Doc/library/sys.rst:286 +#: library/sys.rst:286 msgid ":option:`-U`" msgstr "" -#: ../src/Doc/library/sys.rst:287 +#: library/sys.rst:287 msgid ":const:`bytes_warning`" msgstr "" # 8575cba814814140afd3f27a382ceef3 -#: ../src/Doc/library/sys.rst:287 +#: library/sys.rst:287 msgid ":option:`-b`" msgstr "" # 9df9dc9c56b8407a83652c677a287f3b -#: ../src/Doc/library/sys.rst:288 +#: library/sys.rst:288 msgid ":const:`hash_randomization`" msgstr "" # 06d871c8aac14a85ab1698f45734f6a5 -#: ../src/Doc/library/sys.rst:288 +#: library/sys.rst:288 msgid ":option:`-R`" msgstr "" +#: library/sys.rst:293 +msgid "The ``hash_randomization`` attribute." +msgstr "" + # 506d7ae53dab4d02999d3ed04062dee3 -#: ../src/Doc/library/sys.rst:298 +#: library/sys.rst:298 msgid "" "A structseq holding information about the float type. It contains low level " "information about the precision and internal representation. The values " @@ -101997,173 +104127,173 @@ msgid "" msgstr "" # 41eda387464945558020513971cf0d8a -#: ../src/Doc/library/sys.rst:308 +#: library/sys.rst:308 msgid "float.h macro" msgstr "" -#: ../src/Doc/library/sys.rst:308 +#: library/sys.rst:308 msgid "explanation" msgstr "" -#: ../src/Doc/library/sys.rst:310 +#: library/sys.rst:310 msgid ":const:`epsilon`" msgstr "" # 9cc62899358b40d7bd184fbc44276385 -#: ../src/Doc/library/sys.rst:310 +#: library/sys.rst:310 msgid "DBL_EPSILON" msgstr "" # 35b18dd4223640019822b24134dfc412 -#: ../src/Doc/library/sys.rst:310 +#: library/sys.rst:310 msgid "" "difference between 1 and the least value greater than 1 that is " "representable as a float" msgstr "" -#: ../src/Doc/library/sys.rst:313 +#: library/sys.rst:313 msgid ":const:`dig`" msgstr "" # a423dd43527d46b1880a6d9a6e8758a5 -#: ../src/Doc/library/sys.rst:313 +#: library/sys.rst:313 msgid "DBL_DIG" msgstr "" # 6f6d687c44984dd68663f27d8c4e998a -#: ../src/Doc/library/sys.rst:313 +#: library/sys.rst:313 msgid "" "maximum number of decimal digits that can be faithfully represented in a " "float; see below" msgstr "" -#: ../src/Doc/library/sys.rst:316 +#: library/sys.rst:316 msgid ":const:`mant_dig`" msgstr "" # 55b67fd31dbd4ee9a0948f186b4f639e -#: ../src/Doc/library/sys.rst:316 +#: library/sys.rst:316 msgid "DBL_MANT_DIG" msgstr "" # ee5867e38db545f68fe42ec1b35022d7 -#: ../src/Doc/library/sys.rst:316 +#: library/sys.rst:316 msgid "" "float precision: the number of base-``radix`` digits in the significand of a " "float" msgstr "" -#: ../src/Doc/library/sys.rst:319 +#: library/sys.rst:319 msgid ":const:`max`" msgstr "" # 3bfaa92137f74855bb5f1cbce3b29600 -#: ../src/Doc/library/sys.rst:319 +#: library/sys.rst:319 msgid "DBL_MAX" msgstr "" -#: ../src/Doc/library/sys.rst:319 +#: library/sys.rst:319 msgid "maximum representable finite float" msgstr "" -#: ../src/Doc/library/sys.rst:321 +#: library/sys.rst:321 msgid ":const:`max_exp`" msgstr "" # 5ae54f92eb4044b4a0f78b1ec0f42924 -#: ../src/Doc/library/sys.rst:321 +#: library/sys.rst:321 msgid "DBL_MAX_EXP" msgstr "" # a6d232bd4d324fbe86a523caacd1fe65 -#: ../src/Doc/library/sys.rst:321 +#: library/sys.rst:321 msgid "" "maximum integer e such that ``radix**(e-1)`` is a representable finite float" msgstr "" -#: ../src/Doc/library/sys.rst:324 +#: library/sys.rst:324 msgid ":const:`max_10_exp`" msgstr "" # 036eaaaf70ca4897bf0097bd207fc218 -#: ../src/Doc/library/sys.rst:324 +#: library/sys.rst:324 msgid "DBL_MAX_10_EXP" msgstr "" # 71d6932f46ee4a6781a22ec088e0f91c -#: ../src/Doc/library/sys.rst:324 +#: library/sys.rst:324 msgid "" "maximum integer e such that ``10**e`` is in the range of representable " "finite floats" msgstr "" -#: ../src/Doc/library/sys.rst:327 +#: library/sys.rst:327 msgid ":const:`min`" msgstr "" # d878eb553ae341b2abdf14e2a624bc62 -#: ../src/Doc/library/sys.rst:327 +#: library/sys.rst:327 msgid "DBL_MIN" msgstr "" # 08c19b568a7b405684300f6bff26fa4b -#: ../src/Doc/library/sys.rst:327 +#: library/sys.rst:327 msgid "minimum positive normalized float" msgstr "" -#: ../src/Doc/library/sys.rst:329 +#: library/sys.rst:329 msgid ":const:`min_exp`" msgstr "" # 2bc8d9ec8db640ea9ddaba0c4331c018 -#: ../src/Doc/library/sys.rst:329 +#: library/sys.rst:329 msgid "DBL_MIN_EXP" msgstr "" # 50288576313f4a1bbd3e1ea8ad6b4d1d -#: ../src/Doc/library/sys.rst:329 +#: library/sys.rst:329 msgid "minimum integer e such that ``radix**(e-1)`` is a normalized float" msgstr "" -#: ../src/Doc/library/sys.rst:332 +#: library/sys.rst:332 msgid ":const:`min_10_exp`" msgstr "" # 4a7cbd85a980477792d0e3bade2a4421 -#: ../src/Doc/library/sys.rst:332 +#: library/sys.rst:332 msgid "DBL_MIN_10_EXP" msgstr "" # 609dbf4372c14432836fefef9c517c3d -#: ../src/Doc/library/sys.rst:332 +#: library/sys.rst:332 msgid "minimum integer e such that ``10**e`` is a normalized float" msgstr "" -#: ../src/Doc/library/sys.rst:335 +#: library/sys.rst:335 msgid ":const:`radix`" msgstr "" # 12fa1b890786433e8f24782143961315 -#: ../src/Doc/library/sys.rst:335 +#: library/sys.rst:335 msgid "FLT_RADIX" msgstr "" # 5fb6dcf5f7c94a4ca2d6f96b9d0d22ac -#: ../src/Doc/library/sys.rst:335 +#: library/sys.rst:335 msgid "radix of exponent representation" msgstr "" -#: ../src/Doc/library/sys.rst:337 +#: library/sys.rst:337 msgid ":const:`rounds`" msgstr "" # e5b464a60a674a2f8a2f7701c07ab69f -#: ../src/Doc/library/sys.rst:337 +#: library/sys.rst:337 msgid "FLT_ROUNDS" msgstr "" # 4a3fa8c197774636b4b839c21f58be84 -#: ../src/Doc/library/sys.rst:337 +#: library/sys.rst:337 msgid "" "integer constant representing the rounding mode used for arithmetic " "operations. This reflects the value of the system FLT_ROUNDS macro at " @@ -102172,7 +104302,7 @@ msgid "" msgstr "" # 5e90ef4e5a48430cbbd558dcbe922581 -#: ../src/Doc/library/sys.rst:345 +#: library/sys.rst:345 msgid "" "The attribute :attr:`sys.float_info.dig` needs further explanation. If " "``s`` is any string representing a decimal number with at most :attr:`sys." @@ -102181,14 +104311,14 @@ msgid "" msgstr "" # aafa066ce2e940709e18c7d327041ede -#: ../src/Doc/library/sys.rst:358 +#: library/sys.rst:358 msgid "" "But for strings with more than :attr:`sys.float_info.dig` significant " "digits, this isn't always true::" msgstr "" # 1ee17e2d5d384743b3bcf8e2d8378d05 -#: ../src/Doc/library/sys.rst:369 +#: library/sys.rst:369 msgid "" "A string indicating how the :func:`repr` function behaves for floats. If " "the string has value ``'short'`` then for a finite float ``x``, ``repr(x)`` " @@ -102198,19 +104328,19 @@ msgid "" "same way as it did in versions of Python prior to 2.7." msgstr "" -#: ../src/Doc/library/sys.rst:382 +#: library/sys.rst:382 msgid "" "Return the interpreter's \"check interval\"; see :func:`setcheckinterval`." msgstr "" -#: ../src/Doc/library/sys.rst:389 +#: library/sys.rst:389 msgid "" "Return the name of the current default string encoding used by the Unicode " "implementation." msgstr "" # e92985a4d54a42eb938ac653b2e8b9b4 -#: ../src/Doc/library/sys.rst:397 +#: library/sys.rst:397 msgid "" "Return the current value of the flags that are used for :c:func:`dlopen` " "calls. The flag constants are defined in the :mod:`dl` and :mod:`DLFCN` " @@ -102218,25 +104348,25 @@ msgid "" msgstr "" # ef11fd8f7d55405cb217a451b6c213ea -#: ../src/Doc/library/sys.rst:406 +#: library/sys.rst:406 msgid "" "Return the name of the encoding used to convert Unicode filenames into " "system file names, or ``None`` if the system default encoding is used. The " "result value depends on the operating system:" msgstr "" -#: ../src/Doc/library/sys.rst:410 +#: library/sys.rst:410 msgid "On Mac OS X, the encoding is ``'utf-8'``." msgstr "" # 674d77510882461c8ddf13d7c1b84697 -#: ../src/Doc/library/sys.rst:412 +#: library/sys.rst:412 msgid "" "On Unix, the encoding is the user's preference according to the result of " "nl_langinfo(CODESET), or ``None`` if the ``nl_langinfo(CODESET)`` failed." msgstr "" -#: ../src/Doc/library/sys.rst:416 +#: library/sys.rst:416 msgid "" "On Windows NT+, file names are Unicode natively, so no conversion is " "performed. :func:`getfilesystemencoding` still returns ``'mbcs'``, as this " @@ -102245,18 +104375,18 @@ msgid "" "file names." msgstr "" -#: ../src/Doc/library/sys.rst:422 +#: library/sys.rst:422 msgid "On Windows 9x, the encoding is ``'mbcs'``." msgstr "" -#: ../src/Doc/library/sys.rst:429 +#: library/sys.rst:429 msgid "" "Return the reference count of the *object*. The count returned is generally " "one higher than you might expect, because it includes the (temporary) " "reference as an argument to :func:`getrefcount`." msgstr "" -#: ../src/Doc/library/sys.rst:436 +#: library/sys.rst:436 msgid "" "Return the current value of the recursion limit, the maximum depth of the " "Python interpreter stack. This limit prevents infinite recursion from " @@ -102264,27 +104394,27 @@ msgid "" "func:`setrecursionlimit`." msgstr "" -#: ../src/Doc/library/sys.rst:444 +#: library/sys.rst:444 msgid "" "Return the size of an object in bytes. The object can be any type of object. " "All built-in objects will return correct results, but this does not have to " "hold true for third-party extensions as it is implementation specific." msgstr "" -#: ../src/Doc/library/sys.rst:449 +#: library/sys.rst:449 msgid "" "If given, *default* will be returned if the object does not provide means to " "retrieve the size. Otherwise a :exc:`TypeError` will be raised." msgstr "" -#: ../src/Doc/library/sys.rst:452 +#: library/sys.rst:452 msgid "" ":func:`getsizeof` calls the object's ``__sizeof__`` method and adds an " "additional garbage collector overhead if the object is managed by the " "garbage collector." msgstr "" -#: ../src/Doc/library/sys.rst:461 +#: library/sys.rst:461 msgid "" "Return a frame object from the call stack. If optional integer *depth* is " "given, return the frame object that many calls below the top of the stack. " @@ -102293,21 +104423,21 @@ msgid "" "stack." msgstr "" -#: ../src/Doc/library/sys.rst:468 +#: library/sys.rst:468 msgid "" "This function should be used for internal and specialized purposes only. It " "is not guaranteed to exist in all implementations of Python." msgstr "" -#: ../src/Doc/library/sys.rst:478 +#: library/sys.rst:478 msgid "Get the profiler function as set by :func:`setprofile`." msgstr "" -#: ../src/Doc/library/sys.rst:489 +#: library/sys.rst:489 msgid "Get the trace function as set by :func:`settrace`." msgstr "" -#: ../src/Doc/library/sys.rst:493 +#: library/sys.rst:493 msgid "" "The :func:`gettrace` function is intended only for implementing debuggers, " "profilers, coverage tools and the like. Its behavior is part of the " @@ -102315,7 +104445,7 @@ msgid "" "thus may not be available in all Python implementations." msgstr "" -#: ../src/Doc/library/sys.rst:503 +#: library/sys.rst:503 msgid "" "Return a named tuple describing the Windows version currently running. The " "named elements are *major*, *minor*, *build*, *platform*, *service_pack*, " @@ -102327,83 +104457,89 @@ msgid "" "retrievable by indexing." msgstr "" -#: ../src/Doc/library/sys.rst:513 +#: library/sys.rst:513 msgid "*platform* may be one of the following values:" msgstr "" -#: ../src/Doc/library/sys.rst:516 +#: library/sys.rst:516 msgid "Platform" msgstr "Plateforme" -#: ../src/Doc/library/sys.rst:518 +#: library/sys.rst:518 msgid ":const:`0 (VER_PLATFORM_WIN32s)`" msgstr "" -#: ../src/Doc/library/sys.rst:518 +#: library/sys.rst:518 msgid "Win32s on Windows 3.1" msgstr "" -#: ../src/Doc/library/sys.rst:520 +#: library/sys.rst:520 msgid ":const:`1 (VER_PLATFORM_WIN32_WINDOWS)`" msgstr "" -#: ../src/Doc/library/sys.rst:520 +#: library/sys.rst:520 msgid "Windows 95/98/ME" msgstr "" -#: ../src/Doc/library/sys.rst:522 +#: library/sys.rst:522 msgid ":const:`2 (VER_PLATFORM_WIN32_NT)`" msgstr "" -#: ../src/Doc/library/sys.rst:522 +#: library/sys.rst:522 msgid "Windows NT/2000/XP/x64" msgstr "" -#: ../src/Doc/library/sys.rst:524 +#: library/sys.rst:524 msgid ":const:`3 (VER_PLATFORM_WIN32_CE)`" msgstr "" -#: ../src/Doc/library/sys.rst:524 +#: library/sys.rst:524 msgid "Windows CE" msgstr "" -#: ../src/Doc/library/sys.rst:527 +#: library/sys.rst:527 msgid "*product_type* may be one of the following values:" msgstr "" -#: ../src/Doc/library/sys.rst:532 +#: library/sys.rst:532 msgid ":const:`1 (VER_NT_WORKSTATION)`" msgstr "" -#: ../src/Doc/library/sys.rst:532 +#: library/sys.rst:532 msgid "The system is a workstation." msgstr "" -#: ../src/Doc/library/sys.rst:534 +#: library/sys.rst:534 msgid ":const:`2 (VER_NT_DOMAIN_CONTROLLER)`" msgstr "" -#: ../src/Doc/library/sys.rst:534 +#: library/sys.rst:534 msgid "The system is a domain controller." msgstr "" -#: ../src/Doc/library/sys.rst:537 +#: library/sys.rst:537 msgid ":const:`3 (VER_NT_SERVER)`" msgstr "" -#: ../src/Doc/library/sys.rst:537 +#: library/sys.rst:537 msgid "The system is a server, but not a domain controller." msgstr "" # 4262e933181c4f5984d435ee6ba4fb4b -#: ../src/Doc/library/sys.rst:542 +#: library/sys.rst:542 msgid "" "This function wraps the Win32 :c:func:`GetVersionEx` function; see the " "Microsoft documentation on :c:func:`OSVERSIONINFOEX` for more information " "about these fields." msgstr "" -#: ../src/Doc/library/sys.rst:556 +#: library/sys.rst:549 +msgid "" +"Changed to a named tuple and added *service_pack_minor*, " +"*service_pack_major*, *suite_mask*, and *product_type*." +msgstr "" + +#: library/sys.rst:556 msgid "" "The version number encoded as a single integer. This is guaranteed to " "increase with each version, including proper support for non-production " @@ -102411,7 +104547,7 @@ msgid "" "version 1.5.2, use::" msgstr "" -#: ../src/Doc/library/sys.rst:567 +#: library/sys.rst:567 msgid "" "This is called ``hexversion`` since it only really looks meaningful when " "viewed as the result of passing it to the built-in :func:`hex` function. " @@ -102420,99 +104556,99 @@ msgid "" msgstr "" # f13dd6be1a3948f0a15758162faf8a5d -#: ../src/Doc/library/sys.rst:572 +#: library/sys.rst:572 msgid "The ``hexversion`` is a 32-bit number with the following layout:" msgstr "" # 4cbca1ea4a34404589a2c23936c69b59 -#: ../src/Doc/library/sys.rst:575 +#: library/sys.rst:575 msgid "Bits (big endian order)" msgstr "" # 3f770e2d514147ab9c21b24491d320e8 -#: ../src/Doc/library/sys.rst:577 +#: library/sys.rst:577 msgid ":const:`1-8`" msgstr "" # 71c98d4fa7604986a0d86c47e98b6eb9 -#: ../src/Doc/library/sys.rst:577 +#: library/sys.rst:577 msgid "``PY_MAJOR_VERSION`` (the ``2`` in ``2.1.0a3``)" msgstr "" # decc7a3b1d964b92bd9c821012ffbd70 -#: ../src/Doc/library/sys.rst:580 +#: library/sys.rst:580 msgid ":const:`9-16`" msgstr "" # cd54a3e1058b425a828d5b8394f7dbc6 -#: ../src/Doc/library/sys.rst:580 +#: library/sys.rst:580 msgid "``PY_MINOR_VERSION`` (the ``1`` in ``2.1.0a3``)" msgstr "" # 25a30ed9521e47c58d15022a7a007e2d -#: ../src/Doc/library/sys.rst:583 +#: library/sys.rst:583 msgid ":const:`17-24`" msgstr "" # 95dc33371eac4b59958dadbbe9d34cba -#: ../src/Doc/library/sys.rst:583 +#: library/sys.rst:583 msgid "``PY_MICRO_VERSION`` (the ``0`` in ``2.1.0a3``)" msgstr "" # d556439ef6884315bbb0a94d8116fb1f -#: ../src/Doc/library/sys.rst:586 +#: library/sys.rst:586 msgid ":const:`25-28`" msgstr "" # 5b0cce2eec644344aecf27ce669b150a -#: ../src/Doc/library/sys.rst:586 +#: library/sys.rst:586 msgid "" "``PY_RELEASE_LEVEL`` (``0xA`` for alpha, ``0xB`` for beta, ``0xC`` for " "release candidate and ``0xF`` for final)" msgstr "" # 1fa10b1467a4445892ca9bb12f920abc -#: ../src/Doc/library/sys.rst:590 +#: library/sys.rst:590 msgid ":const:`29-32`" msgstr "" # cceb7a1ba7a1444985498759c9928a6c -#: ../src/Doc/library/sys.rst:590 +#: library/sys.rst:590 msgid "" "``PY_RELEASE_SERIAL`` (the ``3`` in ``2.1.0a3``, zero for final releases)" msgstr "" # 1cfa3277f26a4aee83ef5d6e72dfede4 -#: ../src/Doc/library/sys.rst:594 +#: library/sys.rst:594 msgid "Thus ``2.1.0a3`` is hexversion ``0x020100a3``." msgstr "" -#: ../src/Doc/library/sys.rst:601 +#: library/sys.rst:601 msgid "" "A struct sequence that holds information about Python's internal " "representation of integers. The attributes are read only." msgstr "" -#: ../src/Doc/library/sys.rst:609 +#: library/sys.rst:609 msgid ":const:`bits_per_digit`" msgstr "" # f63198f8721f4a3db46aa2fda9d70793 -#: ../src/Doc/library/sys.rst:609 +#: library/sys.rst:609 msgid "" "number of bits held in each digit. Python integers are stored internally in " "base ``2**long_info.bits_per_digit``" msgstr "" -#: ../src/Doc/library/sys.rst:613 +#: library/sys.rst:613 msgid ":const:`sizeof_digit`" msgstr "" -#: ../src/Doc/library/sys.rst:613 +#: library/sys.rst:613 msgid "size in bytes of the C type used to represent a digit" msgstr "" -#: ../src/Doc/library/sys.rst:624 +#: library/sys.rst:624 msgid "" "These three variables are not always defined; they are set when an exception " "is not handled and the interpreter prints an error message and a stack " @@ -102524,7 +104660,7 @@ msgid "" msgstr "" # dae963b4e81e494e8570e474b61f7f06 -#: ../src/Doc/library/sys.rst:632 +#: library/sys.rst:632 msgid "" "The meaning of the variables is the same as that of the return values from :" "func:`exc_info` above. (Since there is only one interactive thread, thread-" @@ -102532,7 +104668,7 @@ msgid "" msgstr "" # 8134fa7a72174685846c464440826430 -#: ../src/Doc/library/sys.rst:640 +#: library/sys.rst:640 msgid "" "The largest positive integer supported by Python's regular integer type. " "This is at least 2\\*\\*31-1. The largest negative integer is ``-maxint-1`` " @@ -102540,14 +104676,14 @@ msgid "" msgstr "" # 96d01fad81c548e998b5d93fc484967c -#: ../src/Doc/library/sys.rst:646 +#: library/sys.rst:646 msgid "" "The largest positive integer supported by the platform's Py_ssize_t type, " "and thus the maximum size lists, strings, dicts, and many other containers " "can have." msgstr "" -#: ../src/Doc/library/sys.rst:652 +#: library/sys.rst:652 msgid "" "An integer giving the largest supported code point for a Unicode character. " "The value of this depends on the configuration option that specifies whether " @@ -102555,7 +104691,7 @@ msgid "" msgstr "" # 13979584e7a141f7a84f2542ca8cff76 -#: ../src/Doc/library/sys.rst:659 +#: library/sys.rst:659 msgid "" "A list of :term:`finder` objects that have their :meth:`find_module` methods " "called to see if one of the objects can find the module to be imported. The :" @@ -102566,18 +104702,18 @@ msgid "" "else returns a :term:`loader`." msgstr "" -#: ../src/Doc/library/sys.rst:667 +#: library/sys.rst:667 msgid "" ":data:`sys.meta_path` is searched before any implicit default finders or :" "data:`sys.path`." msgstr "" -#: ../src/Doc/library/sys.rst:670 +#: library/sys.rst:670 msgid "See :pep:`302` for the original specification." msgstr "" # e69bebfc0af24c8d946423ad08ef5c3e -#: ../src/Doc/library/sys.rst:677 +#: library/sys.rst:677 msgid "" "This is a dictionary that maps module names to modules which have already " "been loaded. This can be manipulated to force reloading of modules and " @@ -102585,14 +104721,14 @@ msgid "" "same as calling :func:`reload` on the corresponding module object." msgstr "" -#: ../src/Doc/library/sys.rst:687 +#: library/sys.rst:687 msgid "" "A list of strings that specifies the search path for modules. Initialized " "from the environment variable :envvar:`PYTHONPATH`, plus an installation-" "dependent default." msgstr "" -#: ../src/Doc/library/sys.rst:691 +#: library/sys.rst:691 msgid "" "As initialized upon program startup, the first item of this list, " "``path[0]``, is the directory containing the script that was used to invoke " @@ -102604,23 +104740,33 @@ msgid "" "`PYTHONPATH`." msgstr "" -#: ../src/Doc/library/sys.rst:699 +#: library/sys.rst:699 msgid "A program is free to modify this list for its own purposes." msgstr "" -#: ../src/Doc/library/sys.rst:711 +#: library/sys.rst:701 +msgid "Unicode strings are no longer ignored." +msgstr "" + +#: library/sys.rst:705 +msgid "" +"Module :mod:`site` This describes how to use .pth files to extend :data:`sys." +"path`." +msgstr "" + +#: library/sys.rst:711 msgid "" "A list of callables that take a path argument to try to create a :term:" "`finder` for the path. If a finder can be created, it is to be returned by " "the callable, else raise :exc:`ImportError`." msgstr "" -#: ../src/Doc/library/sys.rst:715 ../src/Doc/library/sys.rst:727 +#: library/sys.rst:715 library/sys.rst:727 msgid "Originally specified in :pep:`302`." msgstr "" # 3a5ff01d3699400d97e46f82471cba63 -#: ../src/Doc/library/sys.rst:720 +#: library/sys.rst:720 msgid "" "A dictionary acting as a cache for :term:`finder` objects. The keys are " "paths that have been passed to :data:`sys.path_hooks` and the values are the " @@ -102630,14 +104776,14 @@ msgid "" "an existing path then :class:`imp.NullImporter` is set." msgstr "" -#: ../src/Doc/library/sys.rst:732 +#: library/sys.rst:732 msgid "" "This string contains a platform identifier that can be used to append " "platform-specific components to :data:`sys.path`, for instance." msgstr "" # d1f3e499b7624a2180df2cdb34045018 -#: ../src/Doc/library/sys.rst:735 +#: library/sys.rst:735 msgid "" "For most Unix systems, this is the lowercased OS name as returned by ``uname " "-s`` with the first part of the version as returned by ``uname -r`` " @@ -102646,87 +104792,102 @@ msgid "" "to use the following idiom::" msgstr "" +#: library/sys.rst:746 +msgid "" +"Since lots of code check for ``sys.platform == 'linux2'``, and there is no " +"essential change between Linux 2.x and 3.x, ``sys.platform`` is always set " +"to ``'linux2'``, even on Linux 3.x. In Python 3.3 and later, the value will " +"always be set to ``'linux'``, so it is recommended to always use the " +"``startswith`` idiom presented above." +msgstr "" + # 431fc68e8cf543db9bc76364ab3975cf -#: ../src/Doc/library/sys.rst:753 +#: library/sys.rst:753 msgid "For other systems, the values are:" msgstr "" -#: ../src/Doc/library/sys.rst:756 +#: library/sys.rst:756 msgid "System" msgstr "" -#: ../src/Doc/library/sys.rst:756 +#: library/sys.rst:756 msgid ":data:`platform` value" msgstr "" # bd23a84b08b94d4a9012cf5242d34e57 -#: ../src/Doc/library/sys.rst:758 +#: library/sys.rst:758 msgid "Linux (2.x *and* 3.x)" msgstr "" # 2d0d019174d34c22b6adf997f2744ea0 -#: ../src/Doc/library/sys.rst:758 +#: library/sys.rst:758 msgid "``'linux2'``" msgstr "" -#: ../src/Doc/library/sys.rst:759 +#: library/sys.rst:759 msgid "``'win32'``" msgstr "" -#: ../src/Doc/library/sys.rst:760 +#: library/sys.rst:760 msgid "Windows/Cygwin" msgstr "" -#: ../src/Doc/library/sys.rst:760 +#: library/sys.rst:760 msgid "``'cygwin'``" msgstr "" -#: ../src/Doc/library/sys.rst:761 +#: library/sys.rst:761 msgid "Mac OS X" msgstr "" -#: ../src/Doc/library/sys.rst:761 +#: library/sys.rst:761 msgid "``'darwin'``" msgstr "" -#: ../src/Doc/library/sys.rst:762 +#: library/sys.rst:762 msgid "OS/2" msgstr "" -#: ../src/Doc/library/sys.rst:762 +#: library/sys.rst:762 msgid "``'os2'``" msgstr "" -#: ../src/Doc/library/sys.rst:763 +#: library/sys.rst:763 msgid "OS/2 EMX" msgstr "" -#: ../src/Doc/library/sys.rst:763 +#: library/sys.rst:763 msgid "``'os2emx'``" msgstr "" # 207507c8fb3a4a46bc2295b75a84d91e -#: ../src/Doc/library/sys.rst:764 +#: library/sys.rst:764 msgid "RiscOS" msgstr "" # 46a3b43cecda428f945afa8b14f14ca3 -#: ../src/Doc/library/sys.rst:764 +#: library/sys.rst:764 msgid "``'riscos'``" msgstr "" # 05c74051d324430c8916141cd6fa0fcd -#: ../src/Doc/library/sys.rst:765 +#: library/sys.rst:765 msgid "AtheOS" msgstr "" # b0a4d05cad8d40e1ac0adac194a18e16 -#: ../src/Doc/library/sys.rst:765 +#: library/sys.rst:765 msgid "``'atheos'``" msgstr "" +#: library/sys.rst:769 +msgid "" +":attr:`os.name` has a coarser granularity. :func:`os.uname` gives system-" +"dependent version information." +msgstr "" + # 3d809101016947ab8953e88cc057dac1 -#: ../src/Doc/library/sys.rst:777 +#: library/sys.rst:777 msgid "" "A string giving the site-specific directory prefix where the platform " "independent Python files are installed; by default, this is the string ``'/" @@ -102738,7 +104899,7 @@ msgid "" "number of Python, for example ``2.7``." msgstr "" -#: ../src/Doc/library/sys.rst:794 +#: library/sys.rst:794 msgid "" "Strings specifying the primary and secondary prompt of the interpreter. " "These are only defined if the interpreter is in interactive mode. Their " @@ -102749,14 +104910,14 @@ msgid "" msgstr "" # e91ce1d480c4494ea39387598b9ea0d6 -#: ../src/Doc/library/sys.rst:804 +#: library/sys.rst:804 msgid "" "Bool containing the status of the Python 3 warning flag. It's ``True`` when " "Python is started with the -3 option. (This should be considered read-only; " "setting it to a different value doesn't have an effect on Python 3 warnings.)" msgstr "" -#: ../src/Doc/library/sys.rst:814 +#: library/sys.rst:814 msgid "" "Set the interpreter's \"check interval\". This integer value determines how " "often the interpreter checks for periodic things such as thread switches and " @@ -102767,7 +104928,7 @@ msgid "" "as overhead." msgstr "" -#: ../src/Doc/library/sys.rst:824 +#: library/sys.rst:824 msgid "" "Set the current default string encoding used by the Unicode implementation. " "If *name* does not match any available encoding, :exc:`LookupError` is " @@ -102777,7 +104938,7 @@ msgid "" msgstr "" # f45a2cb88e2942ea928e05f9a073fcc7 -#: ../src/Doc/library/sys.rst:838 +#: library/sys.rst:838 msgid "" "Set the flags used by the interpreter for :c:func:`dlopen` calls, such as " "when the interpreter loads extension modules. Among other things, this will " @@ -102790,7 +104951,7 @@ msgid "" "Unix." msgstr "" -#: ../src/Doc/library/sys.rst:857 +#: library/sys.rst:857 msgid "" "Set the system's profile function, which allows you to implement a Python " "source code profiler in Python. See chapter :ref:`profile` for more " @@ -102804,14 +104965,14 @@ msgid "" "used, so it can simply return ``None``." msgstr "" -#: ../src/Doc/library/sys.rst:870 +#: library/sys.rst:870 msgid "" "Set the maximum depth of the Python interpreter stack to *limit*. This " "limit prevents infinite recursion from causing an overflow of the C stack " "and crashing Python." msgstr "" -#: ../src/Doc/library/sys.rst:874 +#: library/sys.rst:874 msgid "" "The highest possible limit is platform-dependent. A user may need to set " "the limit higher when she has a program that requires deep recursion and a " @@ -102819,7 +104980,7 @@ msgid "" "because a too-high limit can lead to a crash." msgstr "" -#: ../src/Doc/library/sys.rst:886 +#: library/sys.rst:886 msgid "" "Set the system's trace function, which allows you to implement a Python " "source code debugger in Python. The function is thread-specific; for a " @@ -102827,7 +104988,7 @@ msgid "" "`settrace` for each thread being debugged." msgstr "" -#: ../src/Doc/library/sys.rst:891 +#: library/sys.rst:891 msgid "" "Trace functions should have three arguments: *frame*, *event*, and *arg*. " "*frame* is the current stack frame. *event* is a string: ``'call'``, " @@ -102835,37 +104996,40 @@ msgid "" "``'c_exception'``. *arg* depends on the event type." msgstr "" -#: ../src/Doc/library/sys.rst:896 +#: library/sys.rst:896 msgid "" "The trace function is invoked (with *event* set to ``'call'``) whenever a " "new local scope is entered; it should return a reference to a local trace " "function to be used that scope, or ``None`` if the scope shouldn't be traced." msgstr "" -#: ../src/Doc/library/sys.rst:900 +#: library/sys.rst:900 msgid "" "The local trace function should return a reference to itself (or to another " "function for further tracing in that scope), or ``None`` to turn off tracing " "in that scope." msgstr "" -#: ../src/Doc/library/sys.rst:904 +#: library/sys.rst:904 msgid "The events have the following meaning:" msgstr "" -# 1723a1ced9e1476f8a5b2ed983694931 -#: ../src/Doc/library/sys.rst:908 -msgid "``'call'``" +#: library/sys.rst:909 +msgid "'call'" msgstr "" -#: ../src/Doc/library/sys.rst:907 +#: library/sys.rst:907 msgid "" "A function is called (or some other code block entered). The global trace " "function is called; *arg* is ``None``; the return value specifies the local " "trace function." msgstr "" -#: ../src/Doc/library/sys.rst:912 +#: library/sys.rst:916 +msgid "'line'" +msgstr "" + +#: library/sys.rst:912 msgid "" "The interpreter is about to execute a new line of code or re-execute the " "condition of a loop. The local trace function is called; *arg* is ``None``; " @@ -102873,13 +105037,12 @@ msgid "" "lnotab_notes.txt` for a detailed explanation of how this works." msgstr "" -# 5db05999b3fb45bf921243d66658f3c7 -#: ../src/Doc/library/sys.rst:921 -msgid "``'return'``" +#: library/sys.rst:922 +msgid "'return'" msgstr "" # 1935edce836d4e25857dc19fd9aff6bd -#: ../src/Doc/library/sys.rst:919 +#: library/sys.rst:919 msgid "" "A function (or other code block) is about to return. The local trace " "function is called; *arg* is the value that will be returned, or ``None`` if " @@ -102887,60 +105050,58 @@ msgid "" "return value is ignored." msgstr "" -# a40e7915017b41ae9e0f7e9da25ba762 -#: ../src/Doc/library/sys.rst:926 -msgid "``'exception'``" -msgstr "" +#: library/sys.rst:927 +#, fuzzy +msgid "'exception'" +msgstr "Exceptions" -#: ../src/Doc/library/sys.rst:925 +#: library/sys.rst:925 msgid "" "An exception has occurred. The local trace function is called; *arg* is a " "tuple ``(exception, value, traceback)``; the return value specifies the new " "local trace function." msgstr "" -# c3096faf111d4e54b554cf68fbeae943 -#: ../src/Doc/library/sys.rst:930 -msgid "``'c_call'``" +#: library/sys.rst:931 +msgid "'c_call'" msgstr "" -#: ../src/Doc/library/sys.rst:930 +#: library/sys.rst:930 msgid "" "A C function is about to be called. This may be an extension function or a " "built-in. *arg* is the C function object." msgstr "" -# 7ed220019d4846e4beb13c41b6e4fe0f -#: ../src/Doc/library/sys.rst:933 -msgid "``'c_return'``" +#: library/sys.rst:934 +msgid "'c_return'" msgstr "" # d0f3dae909ee49c4904131a8676e90f4 -#: ../src/Doc/library/sys.rst:934 +#: library/sys.rst:934 msgid "A C function has returned. *arg* is the C function object." msgstr "" -# fd817043bd84445a9e4df46931359237 -#: ../src/Doc/library/sys.rst:936 -msgid "``'c_exception'``" -msgstr "" +#: library/sys.rst:937 +#, fuzzy +msgid "'c_exception'" +msgstr "Exceptions" # e756ff492d5d4fbeaba6273a249cd535 -#: ../src/Doc/library/sys.rst:937 +#: library/sys.rst:937 msgid "A C function has raised an exception. *arg* is the C function object." msgstr "" -#: ../src/Doc/library/sys.rst:939 +#: library/sys.rst:939 msgid "" "Note that as an exception is propagated down the chain of callers, an " "``'exception'`` event is generated at each level." msgstr "" -#: ../src/Doc/library/sys.rst:942 +#: library/sys.rst:942 msgid "For more information on code and frame objects, refer to :ref:`types`." msgstr "" -#: ../src/Doc/library/sys.rst:946 +#: library/sys.rst:946 msgid "" "The :func:`settrace` function is intended only for implementing debuggers, " "profilers, coverage tools and the like. Its behavior is part of the " @@ -102949,7 +105110,7 @@ msgid "" msgstr "" # f31dcf82378d424ab64047a59c5a05ed -#: ../src/Doc/library/sys.rst:954 +#: library/sys.rst:954 msgid "" "Activate dumping of VM measurements using the Pentium timestamp counter, if " "*on_flag* is true. Deactivate these dumps if *on_flag* is off. The function " @@ -102958,14 +105119,14 @@ msgid "" msgstr "" # 89b264e58be54c7cbc599b5e1a295ddb -#: ../src/Doc/library/sys.rst:963 +#: library/sys.rst:963 msgid "" "This function is intimately bound to CPython implementation details and thus " "not likely to be implemented elsewhere." msgstr "" # ad2ca286e0984220b3549f3c45cbb453 -#: ../src/Doc/library/sys.rst:975 +#: library/sys.rst:975 msgid "" "File objects corresponding to the interpreter's standard input, output and " "error streams. ``stdin`` is used for all interpreter input except for " @@ -102980,7 +105141,7 @@ msgid "" "func:`exec\\*` family of functions in the :mod:`os` module.)" msgstr "" -#: ../src/Doc/library/sys.rst:992 +#: library/sys.rst:992 msgid "" "These objects contain the original values of ``stdin``, ``stderr`` and " "``stdout`` at the start of the program. They are used during finalization, " @@ -102988,7 +105149,7 @@ msgid "" "``sys.std*`` object has been redirected." msgstr "" -#: ../src/Doc/library/sys.rst:997 +#: library/sys.rst:997 msgid "" "It can also be used to restore the actual files to known working file " "objects in case they have been overwritten with a broken object. However, " @@ -102996,7 +105157,7 @@ msgid "" "before replacing it, and restore the saved object." msgstr "" -#: ../src/Doc/library/sys.rst:1005 +#: library/sys.rst:1005 msgid "" "A triple (repo, branch, version) representing the Subversion information of " "the Python interpreter. *repo* is the name of the repository, ``'CPython'``. " @@ -103010,14 +105171,14 @@ msgid "" msgstr "" # 4989c6045b9b498f9ad94c095d4461ad -#: ../src/Doc/library/sys.rst:1017 +#: library/sys.rst:1017 msgid "" "Python is now `developed <https://docs.python.org/devguide/>`_ using " "Mercurial. In recent Python 2.7 bugfix releases, :data:`subversion` " "therefore contains placeholder information. It is removed in Python 3.3." msgstr "" -#: ../src/Doc/library/sys.rst:1025 +#: library/sys.rst:1025 msgid "" "When this variable is set to an integer value, it determines the maximum " "number of levels of traceback information printed when an unhandled " @@ -103027,7 +105188,7 @@ msgid "" msgstr "" # 735d23a3436342e6821a83944057d5c5 -#: ../src/Doc/library/sys.rst:1033 +#: library/sys.rst:1033 msgid "" "A string containing the version number of the Python interpreter plus " "additional information on the build number and compiler used. This string " @@ -103036,13 +105197,13 @@ msgid "" "functions provided by the :mod:`platform` module." msgstr "" -#: ../src/Doc/library/sys.rst:1042 +#: library/sys.rst:1042 msgid "" "The C API version for this interpreter. Programmers may find this useful " "when debugging version conflicts between Python and extension modules." msgstr "" -#: ../src/Doc/library/sys.rst:1050 +#: library/sys.rst:1050 msgid "" "A tuple containing the five components of the version number: *major*, " "*minor*, *micro*, *releaselevel*, and *serial*. All values except " @@ -103053,14 +105214,18 @@ msgid "" "version_info.major`` and so on." msgstr "" -#: ../src/Doc/library/sys.rst:1065 +#: library/sys.rst:1059 +msgid "Added named component attributes" +msgstr "" + +#: library/sys.rst:1065 msgid "" "This is an implementation detail of the warnings framework; do not modify " "this value. Refer to the :mod:`warnings` module for more information on the " "warnings framework." msgstr "" -#: ../src/Doc/library/sys.rst:1072 +#: library/sys.rst:1072 msgid "" "The version number used to form registry keys on Windows platforms. This is " "stored as string resource 1000 in the Python DLL. The value is normally the " @@ -103070,91 +105235,91 @@ msgid "" msgstr "" # 4408820266b04f14ba45d7933dcf392e -#: ../src/Doc/library/sys.rst:1079 +#: library/sys.rst:1079 msgid "Citations" msgstr "" # c8ff37ed552346d2bb29ad7a728f833d -#: ../src/Doc/library/sys.rst:1080 +#: library/sys.rst:1080 msgid "" "ISO/IEC 9899:1999. \"Programming languages -- C.\" A public draft of this " "standard is available at http://www.open-std.org/jtc1/sc22/wg14/www/docs/" "n1256.pdf\\ ." msgstr "" -#: ../src/Doc/library/sysconfig.rst:2 +#: library/sysconfig.rst:2 msgid "" ":mod:`sysconfig` --- Provide access to Python's configuration information" msgstr "" # eef534359d734d97af0a682bfad6f083 -#: ../src/Doc/library/sysconfig.rst:13 +#: library/sysconfig.rst:13 msgid "**Source code:** :source:`Lib/sysconfig.py`" msgstr "" -#: ../src/Doc/library/sysconfig.rst:17 +#: library/sysconfig.rst:17 msgid "" "The :mod:`sysconfig` module provides access to Python's configuration " "information like the list of installation paths and the configuration " "variables relevant for the current platform." msgstr "" -#: ../src/Doc/library/sysconfig.rst:22 +#: library/sysconfig.rst:22 msgid "Configuration variables" msgstr "" -#: ../src/Doc/library/sysconfig.rst:24 +#: library/sysconfig.rst:24 msgid "" "A Python distribution contains a :file:`Makefile` and a :file:`pyconfig.h` " "header file that are necessary to build both the Python binary itself and " "third-party C extensions compiled using :mod:`distutils`." msgstr "" -#: ../src/Doc/library/sysconfig.rst:28 +#: library/sysconfig.rst:28 msgid "" ":mod:`sysconfig` puts all variables found in these files in a dictionary " "that can be accessed using :func:`get_config_vars` or :func:`get_config_var`." msgstr "" -#: ../src/Doc/library/sysconfig.rst:31 +#: library/sysconfig.rst:31 msgid "Notice that on Windows, it's a much smaller set." msgstr "" -#: ../src/Doc/library/sysconfig.rst:35 +#: library/sysconfig.rst:35 msgid "" "With no arguments, return a dictionary of all configuration variables " "relevant for the current platform." msgstr "" -#: ../src/Doc/library/sysconfig.rst:38 +#: library/sysconfig.rst:38 msgid "" "With arguments, return a list of values that result from looking up each " "argument in the configuration variable dictionary." msgstr "" -#: ../src/Doc/library/sysconfig.rst:41 +#: library/sysconfig.rst:41 msgid "For each argument, if the value is not found, return ``None``." msgstr "" -#: ../src/Doc/library/sysconfig.rst:46 +#: library/sysconfig.rst:46 msgid "" "Return the value of a single variable *name*. Equivalent to " "``get_config_vars().get(name)``." msgstr "" -#: ../src/Doc/library/sysconfig.rst:49 ../src/Doc/library/sysconfig.rst:141 +#: library/sysconfig.rst:49 library/sysconfig.rst:141 msgid "If *name* is not found, return ``None``." msgstr "" -#: ../src/Doc/library/sysconfig.rst:51 +#: library/sysconfig.rst:51 msgid "Example of usage::" msgstr "" -#: ../src/Doc/library/sysconfig.rst:63 +#: library/sysconfig.rst:63 msgid "Installation paths" msgstr "" -#: ../src/Doc/library/sysconfig.rst:65 +#: library/sysconfig.rst:65 msgid "" "Python uses an installation scheme that differs depending on the platform " "and on the installation options. These schemes are stored in :mod:" @@ -103162,130 +105327,130 @@ msgid "" "`os.name`." msgstr "" -#: ../src/Doc/library/sysconfig.rst:69 +#: library/sysconfig.rst:69 msgid "" "Every new component that is installed using :mod:`distutils` or a Distutils-" "based system will follow the same scheme to copy its file in the right " "places." msgstr "" -#: ../src/Doc/library/sysconfig.rst:73 +#: library/sysconfig.rst:73 msgid "Python currently supports seven schemes:" msgstr "" -#: ../src/Doc/library/sysconfig.rst:75 +#: library/sysconfig.rst:75 msgid "" "*posix_prefix*: scheme for Posix platforms like Linux or Mac OS X. This is " "the default scheme used when Python or a component is installed." msgstr "" -#: ../src/Doc/library/sysconfig.rst:77 +#: library/sysconfig.rst:77 msgid "" "*posix_home*: scheme for Posix platforms used when a *home* option is used " "upon installation. This scheme is used when a component is installed " "through Distutils with a specific home prefix." msgstr "" -#: ../src/Doc/library/sysconfig.rst:80 +#: library/sysconfig.rst:80 msgid "" "*posix_user*: scheme for Posix platforms used when a component is installed " "through Distutils and the *user* option is used. This scheme defines paths " "located under the user home directory." msgstr "" -#: ../src/Doc/library/sysconfig.rst:83 +#: library/sysconfig.rst:83 msgid "*nt*: scheme for NT platforms like Windows." msgstr "" -#: ../src/Doc/library/sysconfig.rst:84 +#: library/sysconfig.rst:84 msgid "*nt_user*: scheme for NT platforms, when the *user* option is used." msgstr "" -#: ../src/Doc/library/sysconfig.rst:85 +#: library/sysconfig.rst:85 msgid "*os2*: scheme for OS/2 platforms." msgstr "" -#: ../src/Doc/library/sysconfig.rst:86 +#: library/sysconfig.rst:86 msgid "*os2_home*: scheme for OS/2 patforms, when the *user* option is used." msgstr "" -#: ../src/Doc/library/sysconfig.rst:88 +#: library/sysconfig.rst:88 msgid "" "Each scheme is itself composed of a series of paths and each path has a " "unique identifier. Python currently uses eight paths:" msgstr "" -#: ../src/Doc/library/sysconfig.rst:91 +#: library/sysconfig.rst:91 msgid "" "*stdlib*: directory containing the standard Python library files that are " "not platform-specific." msgstr "" -#: ../src/Doc/library/sysconfig.rst:93 +#: library/sysconfig.rst:93 msgid "" "*platstdlib*: directory containing the standard Python library files that " "are platform-specific." msgstr "" -#: ../src/Doc/library/sysconfig.rst:95 +#: library/sysconfig.rst:95 msgid "*platlib*: directory for site-specific, platform-specific files." msgstr "" -#: ../src/Doc/library/sysconfig.rst:96 +#: library/sysconfig.rst:96 msgid "*purelib*: directory for site-specific, non-platform-specific files." msgstr "" -#: ../src/Doc/library/sysconfig.rst:97 +#: library/sysconfig.rst:97 msgid "*include*: directory for non-platform-specific header files." msgstr "" -#: ../src/Doc/library/sysconfig.rst:98 +#: library/sysconfig.rst:98 msgid "*platinclude*: directory for platform-specific header files." msgstr "" -#: ../src/Doc/library/sysconfig.rst:99 +#: library/sysconfig.rst:99 msgid "*scripts*: directory for script files." msgstr "" -#: ../src/Doc/library/sysconfig.rst:100 +#: library/sysconfig.rst:100 msgid "*data*: directory for data files." msgstr "" -#: ../src/Doc/library/sysconfig.rst:102 +#: library/sysconfig.rst:102 msgid ":mod:`sysconfig` provides some functions to determine these paths." msgstr "" -#: ../src/Doc/library/sysconfig.rst:106 +#: library/sysconfig.rst:106 msgid "" "Return a tuple containing all schemes currently supported in :mod:" "`sysconfig`." msgstr "" -#: ../src/Doc/library/sysconfig.rst:112 +#: library/sysconfig.rst:112 msgid "" "Return a tuple containing all path names currently supported in :mod:" "`sysconfig`." msgstr "" -#: ../src/Doc/library/sysconfig.rst:118 +#: library/sysconfig.rst:118 msgid "" "Return an installation path corresponding to the path *name*, from the " "install scheme named *scheme*." msgstr "" -#: ../src/Doc/library/sysconfig.rst:121 +#: library/sysconfig.rst:121 msgid "" "*name* has to be a value from the list returned by :func:`get_path_names`." msgstr "" -#: ../src/Doc/library/sysconfig.rst:123 +#: library/sysconfig.rst:123 msgid "" ":mod:`sysconfig` stores installation paths corresponding to each path name, " "for each platform, with variables to be expanded. For instance the *stdlib* " "path for the *nt* scheme is: ``{base}/Lib``." msgstr "" -#: ../src/Doc/library/sysconfig.rst:127 +#: library/sysconfig.rst:127 msgid "" ":func:`get_path` will use the variables returned by :func:`get_config_vars` " "to expand the path. All variables have default values for each platform so " @@ -103293,68 +105458,68 @@ msgid "" msgstr "" # a395a187ab24434599f3bc62d966fa41 -#: ../src/Doc/library/sysconfig.rst:131 +#: library/sysconfig.rst:131 msgid "" "If *scheme* is provided, it must be a value from the list returned by :func:" "`get_scheme_names`. Otherwise, the default scheme for the current platform " "is used." msgstr "" -#: ../src/Doc/library/sysconfig.rst:135 +#: library/sysconfig.rst:135 msgid "" "If *vars* is provided, it must be a dictionary of variables that will update " "the dictionary return by :func:`get_config_vars`." msgstr "" -#: ../src/Doc/library/sysconfig.rst:138 +#: library/sysconfig.rst:138 msgid "" "If *expand* is set to ``False``, the path will not be expanded using the " "variables." msgstr "" -#: ../src/Doc/library/sysconfig.rst:146 +#: library/sysconfig.rst:146 msgid "" "Return a dictionary containing all installation paths corresponding to an " "installation scheme. See :func:`get_path` for more information." msgstr "" -#: ../src/Doc/library/sysconfig.rst:149 +#: library/sysconfig.rst:149 msgid "" "If *scheme* is not provided, will use the default scheme for the current " "platform." msgstr "" -#: ../src/Doc/library/sysconfig.rst:152 +#: library/sysconfig.rst:152 msgid "" "If *vars* is provided, it must be a dictionary of variables that will update " "the dictionary used to expand the paths." msgstr "" -#: ../src/Doc/library/sysconfig.rst:155 +#: library/sysconfig.rst:155 msgid "If *expand* is set to False, the paths will not be expanded." msgstr "" -#: ../src/Doc/library/sysconfig.rst:157 +#: library/sysconfig.rst:157 msgid "" "If *scheme* is not an existing scheme, :func:`get_paths` will raise a :exc:" "`KeyError`." msgstr "" -#: ../src/Doc/library/sysconfig.rst:162 +#: library/sysconfig.rst:162 msgid "Other functions" msgstr "" -#: ../src/Doc/library/sysconfig.rst:166 +#: library/sysconfig.rst:166 msgid "" "Return the ``MAJOR.MINOR`` Python version number as a string. Similar to " "``sys.version[:3]``." msgstr "" -#: ../src/Doc/library/sysconfig.rst:172 +#: library/sysconfig.rst:172 msgid "Return a string that identifies the current platform." msgstr "" -#: ../src/Doc/library/sysconfig.rst:174 +#: library/sysconfig.rst:174 msgid "" "This is used mainly to distinguish platform-specific build directories and " "platform-specific built distributions. Typically includes the OS name and " @@ -103364,120 +105529,120 @@ msgid "" "the kernel version isn't particularly important." msgstr "" -#: ../src/Doc/library/sysconfig.rst:181 +#: library/sysconfig.rst:181 msgid "Examples of returned values:" msgstr "" -#: ../src/Doc/library/sysconfig.rst:183 +#: library/sysconfig.rst:183 msgid "linux-i586" msgstr "" -#: ../src/Doc/library/sysconfig.rst:184 +#: library/sysconfig.rst:184 msgid "linux-alpha (?)" msgstr "" -#: ../src/Doc/library/sysconfig.rst:185 +#: library/sysconfig.rst:185 msgid "solaris-2.6-sun4u" msgstr "" -#: ../src/Doc/library/sysconfig.rst:186 +#: library/sysconfig.rst:186 msgid "irix-5.3" msgstr "" -#: ../src/Doc/library/sysconfig.rst:187 +#: library/sysconfig.rst:187 msgid "irix64-6.2" msgstr "" -#: ../src/Doc/library/sysconfig.rst:189 +#: library/sysconfig.rst:189 msgid "Windows will return one of:" msgstr "" -#: ../src/Doc/library/sysconfig.rst:191 +#: library/sysconfig.rst:191 msgid "win-amd64 (64bit Windows on AMD64 (aka x86_64, Intel64, EM64T, etc)" msgstr "" -#: ../src/Doc/library/sysconfig.rst:192 +#: library/sysconfig.rst:192 msgid "win-ia64 (64bit Windows on Itanium)" msgstr "" -#: ../src/Doc/library/sysconfig.rst:193 +#: library/sysconfig.rst:193 msgid "win32 (all others - specifically, sys.platform is returned)" msgstr "" -#: ../src/Doc/library/sysconfig.rst:195 +#: library/sysconfig.rst:195 msgid "Mac OS X can return:" msgstr "" -#: ../src/Doc/library/sysconfig.rst:197 +#: library/sysconfig.rst:197 msgid "macosx-10.6-ppc" msgstr "" -#: ../src/Doc/library/sysconfig.rst:198 +#: library/sysconfig.rst:198 msgid "macosx-10.4-ppc64" msgstr "" -#: ../src/Doc/library/sysconfig.rst:199 +#: library/sysconfig.rst:199 msgid "macosx-10.3-i386" msgstr "" -#: ../src/Doc/library/sysconfig.rst:200 +#: library/sysconfig.rst:200 msgid "macosx-10.4-fat" msgstr "" -#: ../src/Doc/library/sysconfig.rst:202 +#: library/sysconfig.rst:202 msgid "" "For other non-POSIX platforms, currently just returns :data:`sys.platform`." msgstr "" -#: ../src/Doc/library/sysconfig.rst:207 +#: library/sysconfig.rst:207 msgid "" "Return ``True`` if the current Python installation was built from source." msgstr "" -#: ../src/Doc/library/sysconfig.rst:212 +#: library/sysconfig.rst:212 msgid "Parse a :file:`config.h`\\-style file." msgstr "" -#: ../src/Doc/library/sysconfig.rst:214 +#: library/sysconfig.rst:214 msgid "" "*fp* is a file-like object pointing to the :file:`config.h`\\-like file." msgstr "" -#: ../src/Doc/library/sysconfig.rst:216 +#: library/sysconfig.rst:216 msgid "" "A dictionary containing name/value pairs is returned. If an optional " "dictionary is passed in as the second argument, it is used instead of a new " "dictionary, and updated with the values read in the file." msgstr "" -#: ../src/Doc/library/sysconfig.rst:223 +#: library/sysconfig.rst:223 msgid "Return the path of :file:`pyconfig.h`." msgstr "" # d305e9d4ca0242bc9bf125be9a7dc295 -#: ../src/Doc/library/sysconfig.rst:227 +#: library/sysconfig.rst:227 msgid "Return the path of :file:`Makefile`." msgstr "" -#: ../src/Doc/library/syslog.rst:2 +#: library/syslog.rst:2 msgid ":mod:`syslog` --- Unix syslog library routines" msgstr "" -#: ../src/Doc/library/syslog.rst:9 +#: library/syslog.rst:9 msgid "" "This module provides an interface to the Unix ``syslog`` library routines. " "Refer to the Unix manual pages for a detailed description of the ``syslog`` " "facility." msgstr "" -#: ../src/Doc/library/syslog.rst:13 +#: library/syslog.rst:13 msgid "" "This module wraps the system ``syslog`` family of routines. A pure Python " "library that can speak to a syslog server is available in the :mod:`logging." "handlers` module as :class:`SysLogHandler`." msgstr "" -#: ../src/Doc/library/syslog.rst:23 +#: library/syslog.rst:23 msgid "" "Send the string *message* to the system logger. A trailing newline is added " "if necessary. Each message is tagged with a priority composed of a " @@ -103487,13 +105652,13 @@ msgid "" "value given in the :func:`openlog` call is used." msgstr "" -#: ../src/Doc/library/syslog.rst:30 +#: library/syslog.rst:30 msgid "" "If :func:`openlog` has not been called prior to the call to :func:`syslog`, " "``openlog()`` will be called with no arguments." msgstr "" -#: ../src/Doc/library/syslog.rst:36 +#: library/syslog.rst:36 msgid "" "Logging options of subsequent :func:`syslog` calls can be set by calling :" "func:`openlog`. :func:`syslog` will call :func:`openlog` with no arguments " @@ -103501,7 +105666,7 @@ msgid "" msgstr "" # f8c68af40d5f443ebaf05730d66eca58 -#: ../src/Doc/library/syslog.rst:40 +#: library/syslog.rst:40 msgid "" "The optional *ident* keyword argument is a string which is prepended to " "every message, and defaults to ``sys.argv[0]`` with leading path components " @@ -103511,12 +105676,12 @@ msgid "" "for messages which do not have a facility explicitly encoded." msgstr "" -#: ../src/Doc/library/syslog.rst:50 +#: library/syslog.rst:50 msgid "" "Reset the syslog module values and call the system library ``closelog()``." msgstr "" -#: ../src/Doc/library/syslog.rst:52 +#: library/syslog.rst:52 msgid "" "This causes the module to behave as it does when initially imported. For " "example, :func:`openlog` will be called on the first :func:`syslog` call " @@ -103524,7 +105689,7 @@ msgid "" "`openlog` parameters are reset to defaults." msgstr "" -#: ../src/Doc/library/syslog.rst:60 +#: library/syslog.rst:60 msgid "" "Set the priority mask to *maskpri* and return the previous mask value. " "Calls to :func:`syslog` with a priority level not set in *maskpri* are " @@ -103534,16 +105699,16 @@ msgid "" "and including *pri*." msgstr "" -#: ../src/Doc/library/syslog.rst:67 +#: library/syslog.rst:67 msgid "The module defines the following constants:" msgstr "" # 7f5a789b6b06477a8cb4025129427bb6 -#: ../src/Doc/library/syslog.rst:71 +#: library/syslog.rst:72 msgid "Priority levels (high to low):" msgstr "" -#: ../src/Doc/library/syslog.rst:70 +#: library/syslog.rst:70 msgid "" ":const:`LOG_EMERG`, :const:`LOG_ALERT`, :const:`LOG_CRIT`, :const:" "`LOG_ERR`, :const:`LOG_WARNING`, :const:`LOG_NOTICE`, :const:`LOG_INFO`, :" @@ -103551,12 +105716,12 @@ msgid "" msgstr "" # f5ff77ba51ea4dbca3d35bae29c225d5 -#: ../src/Doc/library/syslog.rst:77 +#: library/syslog.rst:78 msgid "Facilities:" msgstr "" # d086d4264ab942d3882e995fe7dd739c -#: ../src/Doc/library/syslog.rst:75 +#: library/syslog.rst:75 msgid "" ":const:`LOG_KERN`, :const:`LOG_USER`, :const:`LOG_MAIL`, :const:" "`LOG_DAEMON`, :const:`LOG_AUTH`, :const:`LOG_LPR`, :const:`LOG_NEWS`, :const:" @@ -103565,55 +105730,55 @@ msgid "" msgstr "" # e47c060d08e04554af91cd8eede985e0 -#: ../src/Doc/library/syslog.rst:82 +#: library/syslog.rst:83 msgid "Log options:" msgstr "" -#: ../src/Doc/library/syslog.rst:81 +#: library/syslog.rst:81 msgid "" ":const:`LOG_PID`, :const:`LOG_CONS`, :const:`LOG_NDELAY`, :const:" "`LOG_NOWAIT` and :const:`LOG_PERROR` if defined in ``<syslog.h>``." msgstr "" -#: ../src/Doc/library/syslog.rst:89 +#: library/syslog.rst:89 msgid "Simple example" msgstr "" -#: ../src/Doc/library/syslog.rst:91 +#: library/syslog.rst:91 msgid "A simple set of examples::" msgstr "" -#: ../src/Doc/library/syslog.rst:99 +#: library/syslog.rst:99 msgid "" "An example of setting some log options, these would include the process ID " "in logged messages, and write the messages to the destination facility used " "for mail logging::" msgstr "" -#: ../src/Doc/library/tabnanny.rst:2 +#: library/tabnanny.rst:2 msgid ":mod:`tabnanny` --- Detection of ambiguous indentation" msgstr "" # 59a20c3ce87a4ab3a51c5a8a1b59dcbb -#: ../src/Doc/library/tabnanny.rst:12 +#: library/tabnanny.rst:12 msgid "**Source code:** :source:`Lib/tabnanny.py`" msgstr "" -#: ../src/Doc/library/tabnanny.rst:16 +#: library/tabnanny.rst:16 msgid "" "For the time being this module is intended to be called as a script. However " "it is possible to import it into an IDE and use the function :func:`check` " "described below." msgstr "" -#: ../src/Doc/library/tabnanny.rst:22 +#: library/tabnanny.rst:22 msgid "" "The API provided by this module is likely to change in future releases; such " "changes may not be backward compatible." msgstr "" # 066ea0111ad94531964ee3e8680b6128 -#: ../src/Doc/library/tabnanny.rst:28 +#: library/tabnanny.rst:28 msgid "" "If *file_or_dir* is a directory and not a symbolic link, then recursively " "descend the directory tree named by *file_or_dir*, checking all :file:`.py` " @@ -103622,51 +105787,50 @@ msgid "" "written to standard output using the print statement." msgstr "" -#: ../src/Doc/library/tabnanny.rst:37 +#: library/tabnanny.rst:37 msgid "" "Flag indicating whether to print verbose messages. This is incremented by " "the ``-v`` option if called as a script." msgstr "" -#: ../src/Doc/library/tabnanny.rst:43 +#: library/tabnanny.rst:43 msgid "" "Flag indicating whether to print only the filenames of files containing " "whitespace related problems. This is set to true by the ``-q`` option if " "called as a script." msgstr "" -#: ../src/Doc/library/tabnanny.rst:50 +#: library/tabnanny.rst:50 msgid "" "Raised by :func:`tokeneater` if detecting an ambiguous indent. Captured and " "handled in :func:`check`." msgstr "" -#: ../src/Doc/library/tabnanny.rst:56 +#: library/tabnanny.rst:56 msgid "" "This function is used by :func:`check` as a callback parameter to the " "function :func:`tokenize.tokenize`." msgstr "" -# 19485743275f418a9f3118a08b7d934b -#: ../src/Doc/library/tabnanny.rst:64 -msgid "Module :mod:`tokenize`" +#: library/tabnanny.rst:65 +msgid "Module tokenize" msgstr "" -#: ../src/Doc/library/tabnanny.rst:66 +#: library/tabnanny.rst:66 msgid "Lexical scanner for Python source code." msgstr "" -#: ../src/Doc/library/tarfile.rst:2 +#: library/tarfile.rst:2 msgid ":mod:`tarfile` --- Read and write tar archive files" msgstr "" # 9e163bd8da574b7c98d7b902abba1bdc -#: ../src/Doc/library/tarfile.rst:13 +#: library/tarfile.rst:13 msgid "**Source code:** :source:`Lib/tarfile.py`" msgstr "" # 8da8a3fc65c145deb9a2200c633ac32b -#: ../src/Doc/library/tarfile.rst:17 +#: library/tarfile.rst:17 msgid "" "The :mod:`tarfile` module makes it possible to read and write tar archives, " "including those using gzip or bz2 compression. Use the :mod:`zipfile` module " @@ -103674,122 +105838,122 @@ msgid "" "`shutil <archiving-operations>`." msgstr "" -#: ../src/Doc/library/tarfile.rst:22 +#: library/tarfile.rst:22 msgid "Some facts and figures:" msgstr "" # 05da2eba96594ff68ab7d2feb613cf11 -#: ../src/Doc/library/tarfile.rst:24 +#: library/tarfile.rst:24 msgid "" "reads and writes :mod:`gzip` and :mod:`bz2` compressed archives if the " "respective modules are available." msgstr "" -#: ../src/Doc/library/tarfile.rst:27 +#: library/tarfile.rst:27 msgid "read/write support for the POSIX.1-1988 (ustar) format." msgstr "" -#: ../src/Doc/library/tarfile.rst:29 +#: library/tarfile.rst:29 msgid "" "read/write support for the GNU tar format including *longname* and " "*longlink* extensions, read-only support for the *sparse* extension." msgstr "" -#: ../src/Doc/library/tarfile.rst:32 +#: library/tarfile.rst:32 msgid "read/write support for the POSIX.1-2001 (pax) format." msgstr "" -#: ../src/Doc/library/tarfile.rst:36 +#: library/tarfile.rst:36 msgid "" "handles directories, regular files, hardlinks, symbolic links, fifos, " "character devices and block devices and is able to acquire and restore file " "information like timestamp, access permissions and owner." msgstr "" -#: ../src/Doc/library/tarfile.rst:43 +#: library/tarfile.rst:43 msgid "" "Return a :class:`TarFile` object for the pathname *name*. For detailed " "information on :class:`TarFile` objects and the keyword arguments that are " "allowed, see :ref:`tarfile-objects`." msgstr "" -#: ../src/Doc/library/tarfile.rst:47 +#: library/tarfile.rst:47 msgid "" "*mode* has to be a string of the form ``'filemode[:compression]'``, it " "defaults to ``'r'``. Here is a full list of mode combinations:" msgstr "" -#: ../src/Doc/library/tarfile.rst:51 ../src/Doc/library/ttk.rst:581 +#: library/tarfile.rst:51 library/ttk.rst:581 msgid "mode" msgstr "" -#: ../src/Doc/library/tarfile.rst:53 +#: library/tarfile.rst:53 msgid "``'r' or 'r:*'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:53 +#: library/tarfile.rst:53 msgid "Open for reading with transparent compression (recommended)." msgstr "" -#: ../src/Doc/library/tarfile.rst:56 +#: library/tarfile.rst:56 msgid "``'r:'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:56 +#: library/tarfile.rst:56 msgid "Open for reading exclusively without compression." msgstr "" -#: ../src/Doc/library/tarfile.rst:59 +#: library/tarfile.rst:59 msgid "``'r:gz'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:59 +#: library/tarfile.rst:59 msgid "Open for reading with gzip compression." msgstr "" -#: ../src/Doc/library/tarfile.rst:61 +#: library/tarfile.rst:61 msgid "``'r:bz2'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:61 +#: library/tarfile.rst:61 msgid "Open for reading with bzip2 compression." msgstr "" -#: ../src/Doc/library/tarfile.rst:63 +#: library/tarfile.rst:63 msgid "``'a' or 'a:'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:63 +#: library/tarfile.rst:63 msgid "" "Open for appending with no compression. The file is created if it does not " "exist." msgstr "" -#: ../src/Doc/library/tarfile.rst:66 +#: library/tarfile.rst:66 msgid "``'w' or 'w:'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:66 +#: library/tarfile.rst:66 msgid "Open for uncompressed writing." msgstr "" -#: ../src/Doc/library/tarfile.rst:68 +#: library/tarfile.rst:68 msgid "``'w:gz'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:68 +#: library/tarfile.rst:68 msgid "Open for gzip compressed writing." msgstr "" -#: ../src/Doc/library/tarfile.rst:70 +#: library/tarfile.rst:70 msgid "``'w:bz2'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:70 +#: library/tarfile.rst:70 msgid "Open for bzip2 compressed writing." msgstr "" -#: ../src/Doc/library/tarfile.rst:73 +#: library/tarfile.rst:73 msgid "" "Note that ``'a:gz'`` or ``'a:bz2'`` is not possible. If *mode* is not " "suitable to open a certain (compressed) file for reading, :exc:`ReadError` " @@ -103797,21 +105961,21 @@ msgid "" "supported, :exc:`CompressionError` is raised." msgstr "" -#: ../src/Doc/library/tarfile.rst:78 +#: library/tarfile.rst:78 msgid "" "If *fileobj* is specified, it is used as an alternative to a file object " "opened for *name*. It is supposed to be at position 0." msgstr "" # 293c2675c47d48abb3a3860e6950b5d2 -#: ../src/Doc/library/tarfile.rst:81 +#: library/tarfile.rst:81 msgid "" "For modes ``'w:gz'``, ``'r:gz'``, ``'w:bz2'``, ``'r:bz2'``, :func:`tarfile." "open` accepts the keyword argument *compresslevel* to specify the " "compression level of the file." msgstr "" -#: ../src/Doc/library/tarfile.rst:85 +#: library/tarfile.rst:85 msgid "" "For special purposes, there is a second format for *mode*: ``'filemode|" "[compression]'``. :func:`tarfile.open` will return a :class:`TarFile` " @@ -103825,80 +105989,80 @@ msgid "" "possible modes:" msgstr "" -#: ../src/Doc/library/tarfile.rst:97 ../src/Doc/library/turtle.rst:1716 +#: library/tarfile.rst:97 library/turtle.rst:1716 msgid "Mode" msgstr "" -#: ../src/Doc/library/tarfile.rst:99 +#: library/tarfile.rst:99 msgid "``'r|*'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:99 +#: library/tarfile.rst:99 msgid "Open a *stream* of tar blocks for reading with transparent compression." msgstr "" -#: ../src/Doc/library/tarfile.rst:102 +#: library/tarfile.rst:102 msgid "``'r|'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:102 +#: library/tarfile.rst:102 msgid "Open a *stream* of uncompressed tar blocks for reading." msgstr "" -#: ../src/Doc/library/tarfile.rst:105 +#: library/tarfile.rst:105 msgid "``'r|gz'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:105 +#: library/tarfile.rst:105 msgid "Open a gzip compressed *stream* for reading." msgstr "" -#: ../src/Doc/library/tarfile.rst:108 +#: library/tarfile.rst:108 msgid "``'r|bz2'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:108 +#: library/tarfile.rst:108 msgid "Open a bzip2 compressed *stream* for reading." msgstr "" -#: ../src/Doc/library/tarfile.rst:111 +#: library/tarfile.rst:111 msgid "``'w|'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:111 +#: library/tarfile.rst:111 msgid "Open an uncompressed *stream* for writing." msgstr "" -#: ../src/Doc/library/tarfile.rst:113 +#: library/tarfile.rst:113 msgid "``'w|gz'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:113 +#: library/tarfile.rst:113 msgid "Open an gzip compressed *stream* for writing." msgstr "" -#: ../src/Doc/library/tarfile.rst:116 +#: library/tarfile.rst:116 msgid "``'w|bz2'``" msgstr "" -#: ../src/Doc/library/tarfile.rst:116 +#: library/tarfile.rst:116 msgid "Open an bzip2 compressed *stream* for writing." msgstr "" -#: ../src/Doc/library/tarfile.rst:123 +#: library/tarfile.rst:123 msgid "" "Class for reading and writing tar archives. Do not use this class directly, " "better use :func:`tarfile.open` instead. See :ref:`tarfile-objects`." msgstr "" -#: ../src/Doc/library/tarfile.rst:129 +#: library/tarfile.rst:129 msgid "" "Return :const:`True` if *name* is a tar archive file, that the :mod:" "`tarfile` module can read." msgstr "" # 0006d15a28764f8e8f0978299e5e5c70 -#: ../src/Doc/library/tarfile.rst:135 +#: library/tarfile.rst:135 msgid "" "Class for limited access to tar archives with a :mod:`zipfile`\\ -like " "interface. Please consult the documentation of the :mod:`zipfile` module for " @@ -103906,121 +106070,120 @@ msgid "" msgstr "" # 9cdbeab902484094b122c0ce868454ba -#: ../src/Doc/library/tarfile.rst:142 +#: library/tarfile.rst:142 msgid "Constant for an uncompressed tar archive." msgstr "" # 78f93d7b8c314f62a1430042e0a3d5c0 -#: ../src/Doc/library/tarfile.rst:147 +#: library/tarfile.rst:147 msgid "Constant for a :mod:`gzip` compressed tar archive." msgstr "" -#: ../src/Doc/library/tarfile.rst:156 +#: library/tarfile.rst:150 +msgid "The :class:`TarFileCompat` class has been removed in Python 3." +msgstr "" + +#: library/tarfile.rst:156 msgid "Base class for all :mod:`tarfile` exceptions." msgstr "" -#: ../src/Doc/library/tarfile.rst:161 +#: library/tarfile.rst:161 msgid "" "Is raised when a tar archive is opened, that either cannot be handled by " "the :mod:`tarfile` module or is somehow invalid." msgstr "" -#: ../src/Doc/library/tarfile.rst:167 +#: library/tarfile.rst:167 msgid "" "Is raised when a compression method is not supported or when the data cannot " "be decoded properly." msgstr "" -#: ../src/Doc/library/tarfile.rst:173 +#: library/tarfile.rst:173 msgid "" "Is raised for the limitations that are typical for stream-like :class:" "`TarFile` objects." msgstr "" -#: ../src/Doc/library/tarfile.rst:179 +#: library/tarfile.rst:179 msgid "" "Is raised for *non-fatal* errors when using :meth:`TarFile.extract`, but " "only if :attr:`TarFile.errorlevel`\\ ``== 2``." msgstr "" # b782004a57014fb0806923b1a2ba5c35 -#: ../src/Doc/library/tarfile.rst:183 +#: library/tarfile.rst:183 msgid "The following constants are available at the module level:" msgstr "" # e2829344b5c44c0390d2f198e53414c6 -#: ../src/Doc/library/tarfile.rst:187 +#: library/tarfile.rst:187 msgid "" "The default character encoding: ``'utf-8'`` on Windows, the value returned " "by :func:`sys.getfilesystemencoding` otherwise." msgstr "" -#: ../src/Doc/library/tarfile.rst:193 +#: library/tarfile.rst:193 msgid "Is raised by :meth:`TarInfo.frombuf` if the buffer it gets is invalid." msgstr "" -#: ../src/Doc/library/tarfile.rst:198 +#: library/tarfile.rst:198 msgid "" "Each of the following constants defines a tar archive format that the :mod:" "`tarfile` module is able to create. See section :ref:`tar-formats` for " "details." msgstr "" -#: ../src/Doc/library/tarfile.rst:205 +#: library/tarfile.rst:205 msgid "POSIX.1-1988 (ustar) format." msgstr "" -#: ../src/Doc/library/tarfile.rst:210 +#: library/tarfile.rst:210 msgid "GNU tar format." msgstr "" -#: ../src/Doc/library/tarfile.rst:215 +#: library/tarfile.rst:215 msgid "POSIX.1-2001 (pax) format." msgstr "" -#: ../src/Doc/library/tarfile.rst:220 +#: library/tarfile.rst:220 msgid "" "The default format for creating archives. This is currently :const:" "`GNU_FORMAT`." msgstr "" -# d267fb22eabc489c962aa61a843ba995 -#: ../src/Doc/library/tarfile.rst:225 -msgid "Module :mod:`zipfile`" +#: library/tarfile.rst:226 +msgid "Module zipfile" msgstr "" -#: ../src/Doc/library/tarfile.rst:226 +#: library/tarfile.rst:226 msgid "Documentation of the :mod:`zipfile` standard module." msgstr "" -# 5990f63f770b4b89bef648003cb32f67 -#: ../src/Doc/library/tarfile.rst:229 -msgid ":ref:`archiving-operations`" +#: library/tarfile.rst:230 +msgid "archiving-operations" msgstr "" # 75a68ee8087d4beebaed4d897a50609a -#: ../src/Doc/library/tarfile.rst:229 +#: library/tarfile.rst:229 msgid "" "Documentation of the higher-level archiving facilities provided by the " "standard :mod:`shutil` module." msgstr "" -# 892432d65a974138b924c6c97d80b12e -#: ../src/Doc/library/tarfile.rst:231 -msgid "" -"`GNU tar manual, Basic Tar Format <http://www.gnu.org/software/tar/manual/" -"html_node/Standard.html>`_" +#: library/tarfile.rst:232 +msgid "GNU tar manual, Basic Tar Format" msgstr "" -#: ../src/Doc/library/tarfile.rst:233 +#: library/tarfile.rst:233 msgid "Documentation for tar archive files, including GNU tar extensions." msgstr "" -#: ../src/Doc/library/tarfile.rst:239 +#: library/tarfile.rst:239 msgid "TarFile Objects" msgstr "" -#: ../src/Doc/library/tarfile.rst:241 +#: library/tarfile.rst:241 msgid "" "The :class:`TarFile` object provides an interface to a tar archive. A tar " "archive is a sequence of blocks. An archive member (a stored file) is made " @@ -104029,7 +106192,7 @@ msgid "" "class:`TarInfo` object, see :ref:`tarinfo-objects` for details." msgstr "" -#: ../src/Doc/library/tarfile.rst:247 +#: library/tarfile.rst:247 msgid "" "A :class:`TarFile` object can be used as a context manager in a :keyword:" "`with` statement. It will automatically be closed when the block is " @@ -104038,58 +106201,62 @@ msgid "" "be closed. See the :ref:`tar-examples` section for a use case." msgstr "" -#: ../src/Doc/library/tarfile.rst:258 +#: library/tarfile.rst:253 +msgid "Added support for the context management protocol." +msgstr "" + +#: library/tarfile.rst:258 msgid "" "All following arguments are optional and can be accessed as instance " "attributes as well." msgstr "" -#: ../src/Doc/library/tarfile.rst:261 +#: library/tarfile.rst:261 msgid "" "*name* is the pathname of the archive. It can be omitted if *fileobj* is " "given. In this case, the file object's :attr:`name` attribute is used if it " "exists." msgstr "" -#: ../src/Doc/library/tarfile.rst:264 +#: library/tarfile.rst:264 msgid "" "*mode* is either ``'r'`` to read from an existing archive, ``'a'`` to append " "data to an existing file or ``'w'`` to create a new file overwriting an " "existing one." msgstr "" -#: ../src/Doc/library/tarfile.rst:268 +#: library/tarfile.rst:268 msgid "" "If *fileobj* is given, it is used for reading or writing data. If it can be " "determined, *mode* is overridden by *fileobj*'s mode. *fileobj* will be used " "from position 0." msgstr "" -#: ../src/Doc/library/tarfile.rst:274 +#: library/tarfile.rst:274 msgid "*fileobj* is not closed, when :class:`TarFile` is closed." msgstr "" -#: ../src/Doc/library/tarfile.rst:276 +#: library/tarfile.rst:276 msgid "" "*format* controls the archive format. It must be one of the constants :const:" "`USTAR_FORMAT`, :const:`GNU_FORMAT` or :const:`PAX_FORMAT` that are defined " "at module level." msgstr "" -#: ../src/Doc/library/tarfile.rst:282 +#: library/tarfile.rst:282 msgid "" "The *tarinfo* argument can be used to replace the default :class:`TarInfo` " "class with a different one." msgstr "" -#: ../src/Doc/library/tarfile.rst:287 +#: library/tarfile.rst:287 msgid "" "If *dereference* is :const:`False`, add symbolic and hard links to the " "archive. If it is :const:`True`, add the content of the target files to the " "archive. This has no effect on systems that do not support symbolic links." msgstr "" -#: ../src/Doc/library/tarfile.rst:291 +#: library/tarfile.rst:291 msgid "" "If *ignore_zeros* is :const:`False`, treat an empty block as the end of the " "archive. If it is :const:`True`, skip empty (and invalid) blocks and try to " @@ -104097,13 +106264,13 @@ msgid "" "concatenated or damaged archives." msgstr "" -#: ../src/Doc/library/tarfile.rst:295 +#: library/tarfile.rst:295 msgid "" "*debug* can be set from ``0`` (no debug messages) up to ``3`` (all debug " "messages). The messages are written to ``sys.stderr``." msgstr "" -#: ../src/Doc/library/tarfile.rst:298 +#: library/tarfile.rst:298 msgid "" "If *errorlevel* is ``0``, all errors are ignored when using :meth:`TarFile." "extract`. Nevertheless, they appear as error messages in the debug output, " @@ -104113,7 +106280,7 @@ msgid "" msgstr "" # 15142ba490984673b6686113f23c38d9 -#: ../src/Doc/library/tarfile.rst:304 +#: library/tarfile.rst:304 msgid "" "The *encoding* and *errors* arguments control the way strings are converted " "to unicode objects and vice versa. The default settings will work for most " @@ -104121,58 +106288,58 @@ msgid "" msgstr "" # a5bd1d0b902247d4870502ee726c5ca2 -#: ../src/Doc/library/tarfile.rst:310 +#: library/tarfile.rst:310 msgid "" "The *pax_headers* argument is an optional dictionary of unicode strings " "which will be added as a pax global header if *format* is :const:" "`PAX_FORMAT`." msgstr "" -#: ../src/Doc/library/tarfile.rst:318 +#: library/tarfile.rst:318 msgid "" "Alternative constructor. The :func:`tarfile.open` function is actually a " "shortcut to this classmethod." msgstr "" -#: ../src/Doc/library/tarfile.rst:324 +#: library/tarfile.rst:324 msgid "" "Return a :class:`TarInfo` object for member *name*. If *name* can not be " "found in the archive, :exc:`KeyError` is raised." msgstr "" -#: ../src/Doc/library/tarfile.rst:329 +#: library/tarfile.rst:329 msgid "" "If a member occurs more than once in the archive, its last occurrence is " "assumed to be the most up-to-date version." msgstr "" -#: ../src/Doc/library/tarfile.rst:335 +#: library/tarfile.rst:335 msgid "" "Return the members of the archive as a list of :class:`TarInfo` objects. The " "list has the same order as the members in the archive." msgstr "" -#: ../src/Doc/library/tarfile.rst:341 +#: library/tarfile.rst:341 msgid "" "Return the members as a list of their names. It has the same order as the " "list returned by :meth:`getmembers`." msgstr "" -#: ../src/Doc/library/tarfile.rst:347 +#: library/tarfile.rst:347 msgid "" "Print a table of contents to ``sys.stdout``. If *verbose* is :const:`False`, " "only the names of the members are printed. If it is :const:`True`, output " "similar to that of :program:`ls -l` is produced." msgstr "" -#: ../src/Doc/library/tarfile.rst:354 +#: library/tarfile.rst:354 msgid "" "Return the next member of the archive as a :class:`TarInfo` object, when :" "class:`TarFile` is opened for reading. Return :const:`None` if there is no " "more available." msgstr "" -#: ../src/Doc/library/tarfile.rst:361 +#: library/tarfile.rst:361 msgid "" "Extract all members from the archive to the current working directory or " "directory *path*. If optional *members* is given, it must be a subset of the " @@ -104184,7 +106351,7 @@ msgid "" "fail." msgstr "" -#: ../src/Doc/library/tarfile.rst:371 ../src/Doc/library/zipfile.rst:237 +#: library/tarfile.rst:371 library/zipfile.rst:239 msgid "" "Never extract archives from untrusted sources without prior inspection. It " "is possible that files are created outside of *path*, e.g. members that have " @@ -104192,7 +106359,7 @@ msgid "" "\"``." msgstr "" -#: ../src/Doc/library/tarfile.rst:381 +#: library/tarfile.rst:381 msgid "" "Extract a member from the archive to the current working directory, using " "its full name. Its file information is extracted as accurately as possible. " @@ -104200,17 +106367,17 @@ msgid "" "different directory using *path*." msgstr "" -#: ../src/Doc/library/tarfile.rst:388 +#: library/tarfile.rst:388 msgid "" "The :meth:`extract` method does not take care of several extraction issues. " "In most cases you should consider using the :meth:`extractall` method." msgstr "" -#: ../src/Doc/library/tarfile.rst:393 +#: library/tarfile.rst:393 msgid "See the warning for :meth:`extractall`." msgstr "" -#: ../src/Doc/library/tarfile.rst:398 +#: library/tarfile.rst:398 msgid "" "Extract a member from the archive as a file object. *member* may be a " "filename or a :class:`TarInfo` object. If *member* is a regular file, a file-" @@ -104219,7 +106386,7 @@ msgid "" "`None` is returned." msgstr "" -#: ../src/Doc/library/tarfile.rst:405 +#: library/tarfile.rst:405 msgid "" "The file-like object is read-only. It provides the methods :meth:`read`, :" "meth:`readline`, :meth:`readlines`, :meth:`seek`, :meth:`tell`, and :meth:" @@ -104227,7 +106394,7 @@ msgid "" msgstr "" # 23d05d497ce24ab095d465b99bb66b6c -#: ../src/Doc/library/tarfile.rst:412 +#: library/tarfile.rst:412 msgid "" "Add the file *name* to the archive. *name* may be any type of file " "(directory, fifo, symbolic link, etc.). If given, *arcname* specifies an " @@ -104242,20 +106409,36 @@ msgid "" "from the archive. See :ref:`tar-examples` for an example." msgstr "" -#: ../src/Doc/library/tarfile.rst:439 +#: library/tarfile.rst:424 +msgid "Added the *exclude* parameter." +msgstr "" + +#: library/tarfile.rst:427 +msgid "Added the *filter* parameter." +msgstr "" + +#: library/tarfile.rst:430 +msgid "" +"The *exclude* parameter is deprecated, please use the *filter* parameter " +"instead. For maximum portability, *filter* should be used as a keyword " +"argument rather than as a positional argument so that code won't be affected " +"when *exclude* is ultimately removed." +msgstr "" + +#: library/tarfile.rst:439 msgid "" "Add the :class:`TarInfo` object *tarinfo* to the archive. If *fileobj* is " "given, ``tarinfo.size`` bytes are read from it and added to the archive. " "You can create :class:`TarInfo` objects using :meth:`gettarinfo`." msgstr "" -#: ../src/Doc/library/tarfile.rst:445 +#: library/tarfile.rst:445 msgid "" "On Windows platforms, *fileobj* should always be opened with mode ``'rb'`` " "to avoid irritation about the file size." msgstr "" -#: ../src/Doc/library/tarfile.rst:451 +#: library/tarfile.rst:451 msgid "" "Create a :class:`TarInfo` object for either the file *name* or the file " "object *fileobj* (using :func:`os.fstat` on its file descriptor). You can " @@ -104264,29 +106447,37 @@ msgid "" "file in the archive." msgstr "" -#: ../src/Doc/library/tarfile.rst:459 +#: library/tarfile.rst:459 msgid "" "Close the :class:`TarFile`. In write mode, two finishing zero blocks are " "appended to the archive." msgstr "" # 3578ad1133c74685828287aa456dfd01 -#: ../src/Doc/library/tarfile.rst:465 +#: library/tarfile.rst:465 msgid "" "Setting this to :const:`True` is equivalent to setting the :attr:`format` " "attribute to :const:`USTAR_FORMAT`, :const:`False` is equivalent to :const:" "`GNU_FORMAT`." msgstr "" -#: ../src/Doc/library/tarfile.rst:478 +#: library/tarfile.rst:469 +msgid "*posix* defaults to :const:`False`." +msgstr "" + +#: library/tarfile.rst:472 +msgid "Use the :attr:`format` attribute instead." +msgstr "" + +#: library/tarfile.rst:478 msgid "A dictionary containing key-value pairs of pax global headers." msgstr "" -#: ../src/Doc/library/tarfile.rst:486 +#: library/tarfile.rst:486 msgid "TarInfo Objects" msgstr "" -#: ../src/Doc/library/tarfile.rst:488 +#: library/tarfile.rst:488 msgid "" "A :class:`TarInfo` object represents one member in a :class:`TarFile`. Aside " "from storing all required attributes of a file (like file type, size, time, " @@ -104294,50 +106485,58 @@ msgid "" "type. It does *not* contain the file's data itself." msgstr "" -#: ../src/Doc/library/tarfile.rst:493 +#: library/tarfile.rst:493 msgid "" ":class:`TarInfo` objects are returned by :class:`TarFile`'s methods :meth:" "`getmember`, :meth:`getmembers` and :meth:`gettarinfo`." msgstr "" -#: ../src/Doc/library/tarfile.rst:499 +#: library/tarfile.rst:499 msgid "Create a :class:`TarInfo` object." msgstr "" -#: ../src/Doc/library/tarfile.rst:504 +#: library/tarfile.rst:504 msgid "Create and return a :class:`TarInfo` object from string buffer *buf*." msgstr "" -#: ../src/Doc/library/tarfile.rst:512 +#: library/tarfile.rst:506 +msgid "Raises :exc:`HeaderError` if the buffer is invalid.." +msgstr "" + +#: library/tarfile.rst:512 msgid "" "Read the next member from the :class:`TarFile` object *tarfile* and return " "it as a :class:`TarInfo` object." msgstr "" -#: ../src/Doc/library/tarfile.rst:520 +#: library/tarfile.rst:520 msgid "" "Create a string buffer from a :class:`TarInfo` object. For information on " "the arguments see the constructor of the :class:`TarFile` class." msgstr "" -#: ../src/Doc/library/tarfile.rst:526 +#: library/tarfile.rst:523 +msgid "The arguments were added." +msgstr "" + +#: library/tarfile.rst:526 msgid "A ``TarInfo`` object has the following public data attributes:" msgstr "" -#: ../src/Doc/library/tarfile.rst:531 +#: library/tarfile.rst:531 msgid "Name of the archive member." msgstr "" -#: ../src/Doc/library/tarfile.rst:536 +#: library/tarfile.rst:536 msgid "Size in bytes." msgstr "" -#: ../src/Doc/library/tarfile.rst:546 +#: library/tarfile.rst:546 msgid "Permission bits." msgstr "" # a76a84d0583f4d7c9cf203aec37055f3 -#: ../src/Doc/library/tarfile.rst:551 +#: library/tarfile.rst:551 msgid "" "File type. *type* is usually one of these constants: :const:`REGTYPE`, :" "const:`AREGTYPE`, :const:`LNKTYPE`, :const:`SYMTYPE`, :const:`DIRTYPE`, :" @@ -104346,115 +106545,115 @@ msgid "" "more conveniently, use the ``is*()`` methods below." msgstr "" -#: ../src/Doc/library/tarfile.rst:560 +#: library/tarfile.rst:560 msgid "" "Name of the target file name, which is only present in :class:`TarInfo` " "objects of type :const:`LNKTYPE` and :const:`SYMTYPE`." msgstr "" -#: ../src/Doc/library/tarfile.rst:566 +#: library/tarfile.rst:566 msgid "User ID of the user who originally stored this member." msgstr "" -#: ../src/Doc/library/tarfile.rst:571 +#: library/tarfile.rst:571 msgid "Group ID of the user who originally stored this member." msgstr "" -#: ../src/Doc/library/tarfile.rst:576 +#: library/tarfile.rst:576 msgid "User name." msgstr "" -#: ../src/Doc/library/tarfile.rst:581 +#: library/tarfile.rst:581 msgid "Group name." msgstr "" -#: ../src/Doc/library/tarfile.rst:586 +#: library/tarfile.rst:586 msgid "" "A dictionary containing key-value pairs of an associated pax extended header." msgstr "" -#: ../src/Doc/library/tarfile.rst:590 +#: library/tarfile.rst:590 msgid "A :class:`TarInfo` object also provides some convenient query methods:" msgstr "" -#: ../src/Doc/library/tarfile.rst:595 +#: library/tarfile.rst:595 msgid "Return :const:`True` if the :class:`Tarinfo` object is a regular file." msgstr "" -#: ../src/Doc/library/tarfile.rst:600 +#: library/tarfile.rst:600 msgid "Same as :meth:`isfile`." msgstr "" -#: ../src/Doc/library/tarfile.rst:605 +#: library/tarfile.rst:605 msgid "Return :const:`True` if it is a directory." msgstr "" -#: ../src/Doc/library/tarfile.rst:610 +#: library/tarfile.rst:610 msgid "Return :const:`True` if it is a symbolic link." msgstr "" -#: ../src/Doc/library/tarfile.rst:615 +#: library/tarfile.rst:615 msgid "Return :const:`True` if it is a hard link." msgstr "" -#: ../src/Doc/library/tarfile.rst:620 +#: library/tarfile.rst:620 msgid "Return :const:`True` if it is a character device." msgstr "" -#: ../src/Doc/library/tarfile.rst:625 +#: library/tarfile.rst:625 msgid "Return :const:`True` if it is a block device." msgstr "" -#: ../src/Doc/library/tarfile.rst:630 +#: library/tarfile.rst:630 msgid "Return :const:`True` if it is a FIFO." msgstr "" -#: ../src/Doc/library/tarfile.rst:635 +#: library/tarfile.rst:635 msgid "" "Return :const:`True` if it is one of character device, block device or FIFO." msgstr "" -#: ../src/Doc/library/tarfile.rst:643 +#: library/tarfile.rst:643 msgid "How to extract an entire tar archive to the current working directory::" msgstr "" -#: ../src/Doc/library/tarfile.rst:650 +#: library/tarfile.rst:650 msgid "" "How to extract a subset of a tar archive with :meth:`TarFile.extractall` " "using a generator function instead of a list::" msgstr "" -#: ../src/Doc/library/tarfile.rst:665 +#: library/tarfile.rst:665 msgid "How to create an uncompressed tar archive from a list of filenames::" msgstr "" -#: ../src/Doc/library/tarfile.rst:673 +#: library/tarfile.rst:673 msgid "The same example using the :keyword:`with` statement::" msgstr "" -#: ../src/Doc/library/tarfile.rst:680 +#: library/tarfile.rst:680 msgid "" "How to read a gzip compressed tar archive and display some member " "information::" msgstr "" -#: ../src/Doc/library/tarfile.rst:694 +#: library/tarfile.rst:694 msgid "" "How to create an archive and reset the user information using the *filter* " "parameter in :meth:`TarFile.add`::" msgstr "" -#: ../src/Doc/library/tarfile.rst:710 +#: library/tarfile.rst:710 msgid "Supported tar formats" msgstr "" -#: ../src/Doc/library/tarfile.rst:712 +#: library/tarfile.rst:712 msgid "" "There are three tar formats that can be created with the :mod:`tarfile` " "module:" msgstr "" -#: ../src/Doc/library/tarfile.rst:714 +#: library/tarfile.rst:714 msgid "" "The POSIX.1-1988 ustar format (:const:`USTAR_FORMAT`). It supports filenames " "up to a length of at best 256 characters and linknames up to 100 characters. " @@ -104462,7 +106661,7 @@ msgid "" "supported format." msgstr "" -#: ../src/Doc/library/tarfile.rst:719 +#: library/tarfile.rst:719 msgid "" "The GNU tar format (:const:`GNU_FORMAT`). It supports long filenames and " "linknames, files bigger than 8 gigabytes and sparse files. It is the de " @@ -104470,7 +106669,7 @@ msgid "" "tar extensions for long names, sparse file support is read-only." msgstr "" -#: ../src/Doc/library/tarfile.rst:724 +#: library/tarfile.rst:724 msgid "" "The POSIX.1-2001 pax format (:const:`PAX_FORMAT`). It is the most flexible " "format with virtually no limits. It supports long filenames and linknames, " @@ -104478,7 +106677,7 @@ msgid "" "implementations today are able to handle pax archives properly." msgstr "" -#: ../src/Doc/library/tarfile.rst:729 +#: library/tarfile.rst:729 msgid "" "The *pax* format is an extension to the existing *ustar* format. It uses " "extra headers for information that cannot be stored otherwise. There are two " @@ -104488,13 +106687,13 @@ msgid "" "portability reasons." msgstr "" -#: ../src/Doc/library/tarfile.rst:735 +#: library/tarfile.rst:735 msgid "" "There are some more variants of the tar format which can be read, but not " "created:" msgstr "" -#: ../src/Doc/library/tarfile.rst:738 +#: library/tarfile.rst:738 msgid "" "The ancient V7 format. This is the first tar format from Unix Seventh " "Edition, storing only regular files and directories. Names must not be " @@ -104503,18 +106702,18 @@ msgid "" "ASCII characters." msgstr "" -#: ../src/Doc/library/tarfile.rst:743 +#: library/tarfile.rst:743 msgid "" "The SunOS tar extended format. This format is a variant of the POSIX.1-2001 " "pax format, but is not compatible." msgstr "" -#: ../src/Doc/library/tarfile.rst:749 +#: library/tarfile.rst:749 msgid "Unicode issues" msgstr "" # d828b88c75c44ae092993e4e1c9f2f06 -#: ../src/Doc/library/tarfile.rst:751 +#: library/tarfile.rst:751 msgid "" "The tar format was originally conceived to make backups on tape drives with " "the main focus on preserving file system information. Nowadays tar archives " @@ -104529,7 +106728,7 @@ msgid "" msgstr "" # 092bb652cfb348869d27d6a424081064 -#: ../src/Doc/library/tarfile.rst:762 +#: library/tarfile.rst:762 msgid "" "The pax format was designed to solve this problem. It stores non-ASCII names " "using the universal character encoding *UTF-8*. When a pax archive is read, " @@ -104537,14 +106736,14 @@ msgid "" msgstr "" # 2ee1a2b6011f4e658c2102dd752f8706 -#: ../src/Doc/library/tarfile.rst:766 +#: library/tarfile.rst:766 msgid "" "The details of unicode conversion are controlled by the *encoding* and " "*errors* keyword arguments of the :class:`TarFile` class." msgstr "" # 8b164bb5b64e4a138990bf4a26246d65 -#: ../src/Doc/library/tarfile.rst:769 +#: library/tarfile.rst:769 msgid "" "The default value for *encoding* is the local character encoding. It is " "deduced from :func:`sys.getfilesystemencoding` and :func:`sys." @@ -104559,7 +106758,7 @@ msgid "" msgstr "" # a8843970efb5437cbed2ca1ea9506e4c -#: ../src/Doc/library/tarfile.rst:779 +#: library/tarfile.rst:779 msgid "" "The *errors* argument defines how characters are treated that cannot be " "converted to or from *encoding*. Possible values are listed in section :ref:" @@ -104570,16 +106769,16 @@ msgid "" "unnoticed." msgstr "" -#: ../src/Doc/library/telnetlib.rst:2 +#: library/telnetlib.rst:2 msgid ":mod:`telnetlib` --- Telnet client" msgstr "" # a69b38f953cc4713bcb7e70e1e3fc9c3 -#: ../src/Doc/library/telnetlib.rst:11 +#: library/telnetlib.rst:11 msgid "**Source code:** :source:`Lib/telnetlib.py`" msgstr "" -#: ../src/Doc/library/telnetlib.rst:15 +#: library/telnetlib.rst:15 msgid "" "The :mod:`telnetlib` module provides a :class:`Telnet` class that implements " "the Telnet protocol. See :rfc:`854` for details about the protocol. In " @@ -104590,7 +106789,7 @@ msgid "" "in ``arpa/telnet.h``, see the module source itself." msgstr "" -#: ../src/Doc/library/telnetlib.rst:23 +#: library/telnetlib.rst:23 msgid "" "The symbolic constants for the telnet commands are: IAC, DONT, DO, WONT, " "WILL, SE (Subnegotiation End), NOP (No Operation), DM (Data Mark), BRK " @@ -104598,7 +106797,7 @@ msgid "" "(Erase Character), EL (Erase Line), GA (Go Ahead), SB (Subnegotiation Begin)." msgstr "" -#: ../src/Doc/library/telnetlib.rst:31 +#: library/telnetlib.rst:31 msgid "" ":class:`Telnet` represents a connection to a Telnet server. The instance is " "initially not connected by default; the :meth:`open` method must be used to " @@ -104610,11 +106809,11 @@ msgid "" "setting will be used)." msgstr "" -#: ../src/Doc/library/telnetlib.rst:40 +#: library/telnetlib.rst:40 msgid "Do not reopen an already connected instance." msgstr "" -#: ../src/Doc/library/telnetlib.rst:42 +#: library/telnetlib.rst:42 msgid "" "This class has many :meth:`read_\\*` methods. Note that some of them " "raise :exc:`EOFError` when the end of the connection is read, because they " @@ -104622,32 +106821,31 @@ msgid "" "descriptions below." msgstr "" -# 7625818d4de4460b9f9e9e6bd21b7fab -#: ../src/Doc/library/telnetlib.rst:51 -msgid ":rfc:`854` - Telnet Protocol Specification" +#: library/telnetlib.rst:52 +msgid "RFC 854 - Telnet Protocol Specification" msgstr "" -#: ../src/Doc/library/telnetlib.rst:53 +#: library/telnetlib.rst:53 msgid "Definition of the Telnet protocol." msgstr "" -#: ../src/Doc/library/telnetlib.rst:59 +#: library/telnetlib.rst:59 msgid "Telnet Objects" msgstr "" -#: ../src/Doc/library/telnetlib.rst:61 +#: library/telnetlib.rst:61 msgid ":class:`Telnet` instances have the following methods:" msgstr "" # d0cbed50aa9f485290cfe150ab23c01c -#: ../src/Doc/library/telnetlib.rst:66 +#: library/telnetlib.rst:66 msgid "" "Read until a given string, *expected*, is encountered or until *timeout* " "seconds have passed." msgstr "" # afb8383d9fa74277b4caa7df47c2934c -#: ../src/Doc/library/telnetlib.rst:69 +#: library/telnetlib.rst:69 msgid "" "When no match is found, return whatever is available instead, possibly the " "empty string. Raise :exc:`EOFError` if the connection is closed and no " @@ -104655,65 +106853,65 @@ msgid "" msgstr "" # 02ce598bc39e4444a4e62006dde84f36 -#: ../src/Doc/library/telnetlib.rst:76 +#: library/telnetlib.rst:76 msgid "Read all data until EOF; block until connection closed." msgstr "" # fd1764d419a941c1bcb2518eed81a09f -#: ../src/Doc/library/telnetlib.rst:81 +#: library/telnetlib.rst:81 msgid "" "Read at least one byte of cooked data unless EOF is hit. Return ``''`` if " "EOF is hit. Block if no data is immediately available." msgstr "" -#: ../src/Doc/library/telnetlib.rst:87 +#: library/telnetlib.rst:87 msgid "Read everything that can be without blocking in I/O (eager)." msgstr "" # 386161462354478094b4f628981b2a11 # 06438da28721487291ebbf86dcbfb443 -#: ../src/Doc/library/telnetlib.rst:89 ../src/Doc/library/telnetlib.rst:98 +#: library/telnetlib.rst:89 library/telnetlib.rst:98 msgid "" "Raise :exc:`EOFError` if connection closed and no cooked data available. " "Return ``''`` if no cooked data available otherwise. Do not block unless in " "the midst of an IAC sequence." msgstr "" -#: ../src/Doc/library/telnetlib.rst:96 +#: library/telnetlib.rst:96 msgid "Read readily available data." msgstr "" -#: ../src/Doc/library/telnetlib.rst:105 +#: library/telnetlib.rst:105 msgid "Process and return data already in the queues (lazy)." msgstr "" # 9e5d12e925c74fd5bffac7f2b6961c43 -#: ../src/Doc/library/telnetlib.rst:107 +#: library/telnetlib.rst:107 msgid "" "Raise :exc:`EOFError` if connection closed and no data available. Return " "``''`` if no cooked data available otherwise. Do not block unless in the " "midst of an IAC sequence." msgstr "" -#: ../src/Doc/library/telnetlib.rst:114 +#: library/telnetlib.rst:114 msgid "Return any data available in the cooked queue (very lazy)." msgstr "" # 425e6323b5e14c339cd21e4200ed1614 -#: ../src/Doc/library/telnetlib.rst:116 +#: library/telnetlib.rst:116 msgid "" "Raise :exc:`EOFError` if connection closed and no data available. Return " "``''`` if no cooked data available otherwise. This method never blocks." msgstr "" -#: ../src/Doc/library/telnetlib.rst:122 +#: library/telnetlib.rst:122 msgid "" "Return the data collected between a SB/SE pair (suboption begin/end). The " "callback should access these data when it was invoked with a ``SE`` command. " "This method never blocks." msgstr "" -#: ../src/Doc/library/telnetlib.rst:131 +#: library/telnetlib.rst:131 msgid "" "Connect to a host. The optional second argument is the port number, which " "defaults to the standard Telnet port (23). The optional *timeout* parameter " @@ -104721,53 +106919,53 @@ msgid "" "attempt (if not specified, the global default timeout setting will be used)." msgstr "" -#: ../src/Doc/library/telnetlib.rst:136 +#: library/telnetlib.rst:136 msgid "Do not try to reopen an already connected instance." msgstr "" -#: ../src/Doc/library/telnetlib.rst:144 +#: library/telnetlib.rst:144 msgid "" "Print a debug message when the debug level is ``>`` 0. If extra arguments " "are present, they are substituted in the message using the standard string " "formatting operator." msgstr "" -#: ../src/Doc/library/telnetlib.rst:151 +#: library/telnetlib.rst:151 msgid "" "Set the debug level. The higher the value of *debuglevel*, the more debug " "output you get (on ``sys.stdout``)." msgstr "" -#: ../src/Doc/library/telnetlib.rst:162 +#: library/telnetlib.rst:162 msgid "Return the socket object used internally." msgstr "" -#: ../src/Doc/library/telnetlib.rst:167 +#: library/telnetlib.rst:167 msgid "Return the file descriptor of the socket object used internally." msgstr "" # 21265b16b5bb41e8974ed7cd7711137d -#: ../src/Doc/library/telnetlib.rst:172 +#: library/telnetlib.rst:172 msgid "" "Write a string to the socket, doubling any IAC characters. This can block if " "the connection is blocked. May raise :exc:`socket.error` if the connection " "is closed." msgstr "" -#: ../src/Doc/library/telnetlib.rst:179 +#: library/telnetlib.rst:179 msgid "Interaction function, emulates a very dumb Telnet client." msgstr "" -#: ../src/Doc/library/telnetlib.rst:184 +#: library/telnetlib.rst:184 msgid "Multithreaded version of :meth:`interact`." msgstr "" -#: ../src/Doc/library/telnetlib.rst:189 +#: library/telnetlib.rst:189 msgid "Read until one from a list of a regular expressions matches." msgstr "" # 13465db9f5d24b1c91f2fe4f75b9a791 -#: ../src/Doc/library/telnetlib.rst:191 +#: library/telnetlib.rst:191 msgid "" "The first argument is a list of regular expressions, either compiled (:class:" "`regex objects <re-objects>`) or uncompiled (strings). The optional second " @@ -104775,7 +106973,7 @@ msgid "" msgstr "" # f775bd57fd0a408d992b9af4b766429a -#: ../src/Doc/library/telnetlib.rst:195 +#: library/telnetlib.rst:195 msgid "" "Return a tuple of three items: the index in the list of the first regular " "expression that matches; the match object returned; and the text read up " @@ -104783,7 +106981,7 @@ msgid "" msgstr "" # 80ac3023ad09498d91dfe068abea42c1 -#: ../src/Doc/library/telnetlib.rst:199 +#: library/telnetlib.rst:199 msgid "" "If end of file is found and no text was read, raise :exc:`EOFError`. " "Otherwise, when nothing matches, return ``(-1, None, text)`` where *text* is " @@ -104791,7 +106989,7 @@ msgid "" msgstr "" # cc97092f8bb24eb49d16ba7e7f62423d -#: ../src/Doc/library/telnetlib.rst:203 +#: library/telnetlib.rst:203 msgid "" "If a regular expression ends with a greedy match (such as ``.*``) or if more " "than one expression can match the same input, the results are non-" @@ -104799,7 +106997,7 @@ msgid "" msgstr "" # d44872b4eb5e4d0a8f4393e38b2315a7 -#: ../src/Doc/library/telnetlib.rst:210 +#: library/telnetlib.rst:210 msgid "" "Each time a telnet option is read on the input flow, this *callback* (if " "set) is called with the following parameters: callback(telnet socket, " @@ -104807,28 +107005,28 @@ msgid "" "telnetlib." msgstr "" -#: ../src/Doc/library/telnetlib.rst:218 +#: library/telnetlib.rst:218 msgid "Telnet Example" msgstr "" -#: ../src/Doc/library/tempfile.rst:2 +#: library/tempfile.rst:2 msgid ":mod:`tempfile` --- Generate temporary files and directories" msgstr "" # b2689b0aebd442479dcd74e8f808a208 -#: ../src/Doc/library/tempfile.rst:15 +#: library/tempfile.rst:15 msgid "**Source code:** :source:`Lib/tempfile.py`" msgstr "" # 24ebfd3af6014d4985bd97c5469d59d4 -#: ../src/Doc/library/tempfile.rst:19 +#: library/tempfile.rst:19 msgid "" "This module generates temporary files and directories. It works on all " "supported platforms." msgstr "" # 4905158c9e3748878df80338631e86a2 -#: ../src/Doc/library/tempfile.rst:22 +#: library/tempfile.rst:22 msgid "" "In version 2.3 of Python, this module was overhauled for enhanced security. " "It now provides three new functions, :func:`NamedTemporaryFile`, :func:" @@ -104838,7 +107036,7 @@ msgid "" "characters is used." msgstr "" -#: ../src/Doc/library/tempfile.rst:29 +#: library/tempfile.rst:29 msgid "" "Also, all the user-callable functions now take additional arguments which " "allow direct control over the location and name of temporary files. It is " @@ -104847,11 +107045,11 @@ msgid "" "recommended to use keyword arguments for clarity." msgstr "" -#: ../src/Doc/library/tempfile.rst:35 +#: library/tempfile.rst:35 msgid "The module defines the following user-callable functions:" msgstr "" -#: ../src/Doc/library/tempfile.rst:40 +#: library/tempfile.rst:40 msgid "" "Return a file-like object that can be used as a temporary storage area. The " "file is created using :func:`mkstemp`. It will be destroyed as soon as it is " @@ -104863,7 +107061,7 @@ msgid "" msgstr "" # f61e5d9645a44369ace91562b463c1b0 -#: ../src/Doc/library/tempfile.rst:48 +#: library/tempfile.rst:48 msgid "" "The *mode* parameter defaults to ``'w+b'`` so that the file created can be " "read and written without being closed. Binary mode is used so that it " @@ -104872,12 +107070,12 @@ msgid "" "default is used." msgstr "" -#: ../src/Doc/library/tempfile.rst:54 +#: library/tempfile.rst:54 msgid "" "The *dir*, *prefix* and *suffix* parameters are passed to :func:`mkstemp`." msgstr "" -#: ../src/Doc/library/tempfile.rst:56 +#: library/tempfile.rst:56 msgid "" "The returned object is a true file object on POSIX platforms. On other " "platforms, it is a file-like object whose :attr:`!file` attribute is the " @@ -104886,7 +107084,7 @@ msgid "" msgstr "" # e6c1d3ab23bc41a29c5d7287d610d6d5 -#: ../src/Doc/library/tempfile.rst:64 +#: library/tempfile.rst:64 msgid "" "This function operates exactly as :func:`TemporaryFile` does, except that " "the file is guaranteed to have a visible name in the file system (on Unix, " @@ -104899,15 +107097,19 @@ msgid "" msgstr "" # 5e72c031be4f40aabfd5829e9db76554 -#: ../src/Doc/library/tempfile.rst:73 +#: library/tempfile.rst:73 msgid "" "The returned object is always a file-like object whose :attr:`!file` " "attribute is the underlying true file object. This file-like object can be " "used in a :keyword:`with` statement, just like a normal file." msgstr "" +#: library/tempfile.rst:79 +msgid "The *delete* parameter." +msgstr "" + # aa22a6b054e34e618e4160abb10e4cfc -#: ../src/Doc/library/tempfile.rst:85 +#: library/tempfile.rst:85 msgid "" "This function operates exactly as :func:`TemporaryFile` does, except that " "data is spooled in memory until the file size exceeds *max_size*, or until " @@ -104916,14 +107118,14 @@ msgid "" "it's ``truncate`` method does not accept a ``size`` argument." msgstr "" -#: ../src/Doc/library/tempfile.rst:92 +#: library/tempfile.rst:92 msgid "" "The resulting file has one additional method, :func:`rollover`, which causes " "the file to roll over to an on-disk file regardless of its size." msgstr "" # 5b3d2737af6a49f7a71c68c32f33e7bd -#: ../src/Doc/library/tempfile.rst:95 +#: library/tempfile.rst:95 msgid "" "The returned object is a file-like object whose :attr:`_file` attribute is " "either a :class:`~StringIO.StringIO` object or a true file object, depending " @@ -104931,7 +107133,7 @@ msgid "" "used in a :keyword:`with` statement, just like a normal file." msgstr "" -#: ../src/Doc/library/tempfile.rst:105 +#: library/tempfile.rst:105 msgid "" "Creates a temporary file in the most secure manner possible. There are no " "race conditions in the file's creation, assuming that the platform properly " @@ -104942,13 +107144,13 @@ msgid "" "processes." msgstr "" -#: ../src/Doc/library/tempfile.rst:113 +#: library/tempfile.rst:113 msgid "" "Unlike :func:`TemporaryFile`, the user of :func:`mkstemp` is responsible for " "deleting the temporary file when done with it." msgstr "" -#: ../src/Doc/library/tempfile.rst:116 +#: library/tempfile.rst:116 msgid "" "If *suffix* is specified, the file name will end with that suffix, otherwise " "there will be no suffix. :func:`mkstemp` does not put a dot between the " @@ -104956,13 +107158,13 @@ msgid "" "*suffix*." msgstr "" -#: ../src/Doc/library/tempfile.rst:121 +#: library/tempfile.rst:121 msgid "" "If *prefix* is specified, the file name will begin with that prefix; " "otherwise, a default prefix is used." msgstr "" -#: ../src/Doc/library/tempfile.rst:124 +#: library/tempfile.rst:124 msgid "" "If *dir* is specified, the file will be created in that directory; " "otherwise, a default directory is used. The default directory is chosen " @@ -104973,50 +107175,54 @@ msgid "" "commands via ``os.popen()``." msgstr "" -#: ../src/Doc/library/tempfile.rst:132 +#: library/tempfile.rst:132 msgid "" "If *text* is specified, it indicates whether to open the file in binary mode " "(the default) or text mode. On some platforms, this makes no difference." msgstr "" -#: ../src/Doc/library/tempfile.rst:136 +#: library/tempfile.rst:136 msgid "" ":func:`mkstemp` returns a tuple containing an OS-level handle to an open " "file (as would be returned by :func:`os.open`) and the absolute pathname of " "that file, in that order." msgstr "" -#: ../src/Doc/library/tempfile.rst:145 +#: library/tempfile.rst:145 msgid "" "Creates a temporary directory in the most secure manner possible. There are " "no race conditions in the directory's creation. The directory is readable, " "writable, and searchable only by the creating user ID." msgstr "" -#: ../src/Doc/library/tempfile.rst:149 +#: library/tempfile.rst:149 msgid "" "The user of :func:`mkdtemp` is responsible for deleting the temporary " "directory and its contents when done with it." msgstr "" -#: ../src/Doc/library/tempfile.rst:152 +#: library/tempfile.rst:152 msgid "" "The *prefix*, *suffix*, and *dir* arguments are the same as for :func:" "`mkstemp`." msgstr "" -#: ../src/Doc/library/tempfile.rst:155 +#: library/tempfile.rst:155 msgid ":func:`mkdtemp` returns the absolute pathname of the new directory." msgstr "" -#: ../src/Doc/library/tempfile.rst:165 +#: library/tempfile.rst:162 +msgid "Use :func:`mkstemp` instead." +msgstr "" + +#: library/tempfile.rst:165 msgid "" "Return an absolute pathname of a file that did not exist at the time the " "call is made. The *prefix*, *suffix*, and *dir* arguments are the same as " "for :func:`mkstemp`." msgstr "" -#: ../src/Doc/library/tempfile.rst:171 +#: library/tempfile.rst:171 msgid "" "Use of this function may introduce a security hole in your program. By the " "time you get around to doing anything with the file name it returns, someone " @@ -105026,7 +107232,7 @@ msgid "" msgstr "" # 0ff3b95cad394a48a68394bafe05761d -#: ../src/Doc/library/tempfile.rst:188 +#: library/tempfile.rst:188 msgid "" "The module uses a global variable that tell it how to construct a temporary " "name. They are initialized at the first call to any of the functions " @@ -105034,67 +107240,71 @@ msgid "" "appropriate function arguments, instead." msgstr "" -#: ../src/Doc/library/tempfile.rst:196 +#: library/tempfile.rst:196 msgid "" "When set to a value other than ``None``, this variable defines the default " "value for the *dir* argument to all the functions defined in this module." msgstr "" -#: ../src/Doc/library/tempfile.rst:200 +#: library/tempfile.rst:200 msgid "" "If ``tempdir`` is unset or ``None`` at any call to any of the above " "functions, Python searches a standard list of directories and sets *tempdir* " "to the first one which the calling user can create files in. The list is:" msgstr "" -#: ../src/Doc/library/tempfile.rst:205 +#: library/tempfile.rst:205 msgid "The directory named by the :envvar:`TMPDIR` environment variable." msgstr "" -#: ../src/Doc/library/tempfile.rst:207 +#: library/tempfile.rst:207 msgid "The directory named by the :envvar:`TEMP` environment variable." msgstr "" -#: ../src/Doc/library/tempfile.rst:209 +#: library/tempfile.rst:209 msgid "The directory named by the :envvar:`TMP` environment variable." msgstr "" -#: ../src/Doc/library/tempfile.rst:211 +#: library/tempfile.rst:211 msgid "A platform-specific location:" msgstr "" # dcce5a91c7d04d0aaebfbd0d2c556822 -#: ../src/Doc/library/tempfile.rst:213 +#: library/tempfile.rst:213 msgid "" "On RiscOS, the directory named by the :envvar:`Wimp$ScrapDir` environment " "variable." msgstr "" -#: ../src/Doc/library/tempfile.rst:216 +#: library/tempfile.rst:216 msgid "" "On Windows, the directories :file:`C:\\\\TEMP`, :file:`C:\\\\TMP`, :file:`\\" "\\TEMP`, and :file:`\\\\TMP`, in that order." msgstr "" -#: ../src/Doc/library/tempfile.rst:219 +#: library/tempfile.rst:219 msgid "" "On all other platforms, the directories :file:`/tmp`, :file:`/var/tmp`, and :" "file:`/usr/tmp`, in that order." msgstr "" -#: ../src/Doc/library/tempfile.rst:222 +#: library/tempfile.rst:222 msgid "As a last resort, the current working directory." msgstr "" -#: ../src/Doc/library/tempfile.rst:227 +#: library/tempfile.rst:227 msgid "" "Return the directory currently selected to create temporary files in. If :" "data:`tempdir` is not ``None``, this simply returns its contents; otherwise, " "the search described above is performed, and the result returned." msgstr "" +#: library/tempfile.rst:236 +msgid "Use :func:`gettempprefix` instead." +msgstr "" + # 76aa162a7dc14d2e8d58df9d160fea17 -#: ../src/Doc/library/tempfile.rst:239 +#: library/tempfile.rst:239 msgid "" "When set to a value other than ``None``, this variable defines the prefix of " "the final component of the filenames returned by :func:`mktemp`. A string " @@ -105103,7 +107313,7 @@ msgid "" msgstr "" # 75974e324d94418fa4f0c1977076fcb6 -#: ../src/Doc/library/tempfile.rst:244 +#: library/tempfile.rst:244 msgid "" "Older versions of this module used to require that ``template`` be set to " "``None`` after a call to :func:`os.fork`; this has not been necessary since " @@ -105111,18 +107321,18 @@ msgid "" msgstr "" # 0db811b34de54f50b86a0adc25b02e31 -#: ../src/Doc/library/tempfile.rst:251 +#: library/tempfile.rst:251 msgid "" "Return the filename prefix used to create temporary files. This does not " "contain the directory component. Using this function is preferred over " "reading the *template* variable directly." msgstr "" -#: ../src/Doc/library/termios.rst:3 +#: library/termios.rst:3 msgid ":mod:`termios` --- POSIX style tty control" msgstr "" -#: ../src/Doc/library/termios.rst:14 +#: library/termios.rst:14 msgid "" "This module provides an interface to the POSIX calls for tty I/O control. " "For a complete description of these calls, see the POSIX or Unix manual " @@ -105131,14 +107341,14 @@ msgid "" "time)." msgstr "" -#: ../src/Doc/library/termios.rst:19 +#: library/termios.rst:19 msgid "" "All functions in this module take a file descriptor *fd* as their first " "argument. This can be an integer file descriptor, such as returned by ``sys." "stdin.fileno()``, or a file object, such as ``sys.stdin`` itself." msgstr "" -#: ../src/Doc/library/termios.rst:23 +#: library/termios.rst:23 msgid "" "This module also defines all the constants needed to work with the functions " "provided here; these have the same name as their counterparts in C. Please " @@ -105146,7 +107356,7 @@ msgid "" "terminal control interfaces." msgstr "" -#: ../src/Doc/library/termios.rst:33 +#: library/termios.rst:33 msgid "" "Return a list containing the tty attributes for file descriptor *fd*, as " "follows: ``[iflag, oflag, cflag, lflag, ispeed, ospeed, cc]`` where *cc* is " @@ -105157,7 +107367,7 @@ msgid "" "constants defined in the :mod:`termios` module." msgstr "" -#: ../src/Doc/library/termios.rst:44 +#: library/termios.rst:44 msgid "" "Set the tty attributes for file descriptor *fd* from the *attributes*, which " "is a list like the one returned by :func:`tcgetattr`. The *when* argument " @@ -105167,41 +107377,41 @@ msgid "" "and discarding all queued input." msgstr "" -#: ../src/Doc/library/termios.rst:54 +#: library/termios.rst:54 msgid "" "Send a break on file descriptor *fd*. A zero *duration* sends a break for " "0.25 --0.5 seconds; a nonzero *duration* has a system dependent meaning." msgstr "" -#: ../src/Doc/library/termios.rst:60 +#: library/termios.rst:60 msgid "" "Wait until all output written to file descriptor *fd* has been transmitted." msgstr "" -#: ../src/Doc/library/termios.rst:65 +#: library/termios.rst:65 msgid "" "Discard queued data on file descriptor *fd*. The *queue* selector specifies " "which queue: :const:`TCIFLUSH` for the input queue, :const:`TCOFLUSH` for " "the output queue, or :const:`TCIOFLUSH` for both queues." msgstr "" -#: ../src/Doc/library/termios.rst:72 +#: library/termios.rst:72 msgid "" "Suspend or resume input or output on file descriptor *fd*. The *action* " "argument can be :const:`TCOOFF` to suspend output, :const:`TCOON` to restart " "output, :const:`TCIOFF` to suspend input, or :const:`TCION` to restart input." msgstr "" -# 6256b898aa014dbe879e848f5d68f7f8 -#: ../src/Doc/library/termios.rst:78 -msgid "Module :mod:`tty`" -msgstr "" +#: library/termios.rst:79 +#, fuzzy +msgid "Module tty" +msgstr "Modules" -#: ../src/Doc/library/termios.rst:80 +#: library/termios.rst:80 msgid "Convenience functions for common terminal control operations." msgstr "" -#: ../src/Doc/library/termios.rst:88 +#: library/termios.rst:88 msgid "" "Here's a function that prompts for a password with echoing turned off. Note " "the technique using a separate :func:`tcgetattr` call and a :keyword:" @@ -105209,12 +107419,12 @@ msgid "" "are restored exactly no matter what happens::" msgstr "" -#: ../src/Doc/library/test.rst:3 +#: library/test.rst:3 msgid ":mod:`test` --- Regression tests package for Python" msgstr "" # 8ff56ff4bbe04b58ba5703d05b0525b6 -#: ../src/Doc/library/test.rst:10 +#: library/test.rst:10 msgid "" "The :mod:`test` package is meant for internal use by Python only. It is " "documented for the benefit of the core developers of Python. Any use of this " @@ -105224,7 +107434,7 @@ msgid "" msgstr "" # 42221dc4da524f558825885a5539a85e -#: ../src/Doc/library/test.rst:17 +#: library/test.rst:17 msgid "" "The :mod:`test` package contains all regression tests for Python as well as " "the modules :mod:`test.test_support` and :mod:`test.regrtest`. :mod:`test." @@ -105232,7 +107442,7 @@ msgid "" "drives the testing suite." msgstr "" -#: ../src/Doc/library/test.rst:22 +#: library/test.rst:22 msgid "" "Each module in the :mod:`test` package whose name starts with ``test_`` is a " "testing suite for a specific module or feature. All new tests should be " @@ -105241,30 +107451,29 @@ msgid "" "printed to ``sys.stdout``; this style of test is considered deprecated." msgstr "" -# 33cf841a95cb4392a4f47ae745f3c352 -#: ../src/Doc/library/test.rst:31 -msgid "Module :mod:`unittest`" -msgstr "" +#: library/test.rst:32 +#, fuzzy +msgid "Module unittest" +msgstr "Modules" -#: ../src/Doc/library/test.rst:32 +#: library/test.rst:32 msgid "Writing PyUnit regression tests." msgstr "" -# 854e29cabbef46279230c7849a4d2236 -# b6a09c97497c441da8f0c6e68a21da01 -#: ../src/Doc/library/test.rst:33 ../src/Doc/library/unittest.rst:78 -msgid "Module :mod:`doctest`" -msgstr "" +#: library/test.rst:34 library/unittest.rst:79 +#, fuzzy +msgid "Module doctest" +msgstr "Modules" -#: ../src/Doc/library/test.rst:35 +#: library/test.rst:35 msgid "Tests embedded in documentation strings." msgstr "" -#: ../src/Doc/library/test.rst:41 +#: library/test.rst:41 msgid "Writing Unit Tests for the :mod:`test` package" msgstr "" -#: ../src/Doc/library/test.rst:43 +#: library/test.rst:43 msgid "" "It is preferred that tests that use the :mod:`unittest` module follow a few " "guidelines. One is to name the test module by starting it with ``test_`` and " @@ -105278,30 +107487,30 @@ msgid "" "exist and thus what test is being run is not stated." msgstr "" -#: ../src/Doc/library/test.rst:54 +#: library/test.rst:54 msgid "A basic boilerplate is often used::" msgstr "" -#: ../src/Doc/library/test.rst:93 +#: library/test.rst:93 msgid "" "This boilerplate code allows the testing suite to be run by :mod:`test." "regrtest` as well as on its own as a script." msgstr "" -#: ../src/Doc/library/test.rst:96 +#: library/test.rst:96 msgid "" "The goal for regression testing is to try to break code. This leads to a few " "guidelines to be followed:" msgstr "" -#: ../src/Doc/library/test.rst:99 +#: library/test.rst:99 msgid "" "The testing suite should exercise all classes, functions, and constants. " "This includes not just the external API that is to be presented to the " "outside world but also \"private\" code." msgstr "" -#: ../src/Doc/library/test.rst:103 +#: library/test.rst:103 msgid "" "Whitebox testing (examining the code being tested when the tests are being " "written) is preferred. Blackbox testing (testing only the published user " @@ -105309,46 +107518,46 @@ msgid "" "are tested." msgstr "" -#: ../src/Doc/library/test.rst:108 +#: library/test.rst:108 msgid "" "Make sure all possible values are tested including invalid ones. This makes " "sure that not only all valid values are acceptable but also that improper " "values are handled correctly." msgstr "" -#: ../src/Doc/library/test.rst:112 +#: library/test.rst:112 msgid "" "Exhaust as many code paths as possible. Test where branching occurs and thus " "tailor input to make sure as many different paths through the code are taken." msgstr "" -#: ../src/Doc/library/test.rst:115 +#: library/test.rst:115 msgid "" "Add an explicit test for any bugs discovered for the tested code. This will " "make sure that the error does not crop up again if the code is changed in " "the future." msgstr "" -#: ../src/Doc/library/test.rst:119 +#: library/test.rst:119 msgid "" "Make sure to clean up after your tests (such as close and remove all " "temporary files)." msgstr "" -#: ../src/Doc/library/test.rst:122 +#: library/test.rst:122 msgid "" "If a test is dependent on a specific condition of the operating system then " "verify the condition already exists before attempting the test." msgstr "" -#: ../src/Doc/library/test.rst:125 +#: library/test.rst:125 msgid "" "Import as few modules as possible and do it as soon as possible. This " "minimizes external dependencies of tests and also minimizes possible " "anomalous behavior from side-effects of importing a module." msgstr "" -#: ../src/Doc/library/test.rst:129 +#: library/test.rst:129 msgid "" "Try to maximize code reuse. On occasion, tests will vary by something as " "small as what type of input is used. Minimize code duplication by " @@ -105356,21 +107565,21 @@ msgid "" msgstr "" # eb9a22c97808457291e7661a37543f3e -#: ../src/Doc/library/test.rst:151 +#: library/test.rst:152 msgid "Test Driven Development" msgstr "" -#: ../src/Doc/library/test.rst:153 +#: library/test.rst:153 msgid "A book by Kent Beck on writing tests before code." msgstr "" # 53173fc885204b4bbe1b174cd2806daf -#: ../src/Doc/library/test.rst:159 +#: library/test.rst:159 msgid "Running tests using the command-line interface" msgstr "" # e7970f28ba9847288c992d67f94830ad -#: ../src/Doc/library/test.rst:161 +#: library/test.rst:161 msgid "" "The :mod:`test.regrtest` module can be run as a script to drive Python's " "regression test suite, thanks to the :option:`-m` option: :program:`python -" @@ -105384,7 +107593,7 @@ msgid "" msgstr "" # b311d92ceae341f88705895c9e6a7f1d -#: ../src/Doc/library/test.rst:171 +#: library/test.rst:171 msgid "" "Running :mod:`test.regrtest` directly allows what resources are available " "for tests to use to be set. You do this by using the ``-u`` command-line " @@ -105399,7 +107608,7 @@ msgid "" msgstr "" # ef371d98b5e24aefb45c2154535e92fc -#: ../src/Doc/library/test.rst:182 +#: library/test.rst:182 msgid "" "Some other ways to execute the regression tests depend on what platform the " "tests are being executed on. On Unix, you can run :program:`make test` at " @@ -105409,36 +107618,36 @@ msgid "" msgstr "" # 6137d05773a44d4a88e267cc43b15d9a -#: ../src/Doc/library/test.rst:190 +#: library/test.rst:190 msgid ":mod:`test.test_support` --- Utility functions for tests" msgstr "" # 16596f8c126640ef948e77b33135aca4 -#: ../src/Doc/library/test.rst:197 +#: library/test.rst:197 msgid "" "The :mod:`test.test_support` module has been renamed to :mod:`test.support` " "in Python 3.x." msgstr "" # ece43f6e3c2f4b629a6787fba58e8781 -#: ../src/Doc/library/test.rst:200 +#: library/test.rst:200 msgid "" "The :mod:`test.test_support` module provides support for Python's regression " "tests." msgstr "" -#: ../src/Doc/library/test.rst:203 +#: library/test.rst:203 msgid "This module defines the following exceptions:" msgstr "" -#: ../src/Doc/library/test.rst:208 +#: library/test.rst:208 msgid "" "Exception to be raised when a test fails. This is deprecated in favor of :" "mod:`unittest`\\ -based tests and :class:`unittest.TestCase`'s assertion " "methods." msgstr "" -#: ../src/Doc/library/test.rst:215 +#: library/test.rst:215 msgid "" "Subclass of :exc:`unittest.SkipTest`. Raised when a resource (such as a " "network connection) is not available. Raised by the :func:`requires` " @@ -105446,11 +107655,11 @@ msgid "" msgstr "" # 2de30410376444b196798210fd63e58d -#: ../src/Doc/library/test.rst:219 +#: library/test.rst:219 msgid "The :mod:`test.test_support` module defines the following constants:" msgstr "" -#: ../src/Doc/library/test.rst:224 +#: library/test.rst:224 msgid "" ":const:`True` when verbose output is enabled. Should be checked when more " "detailed information is desired about a running test. *verbose* is set by :" @@ -105458,39 +107667,39 @@ msgid "" msgstr "" # 9ed11a285c844475b55008085c71550b -#: ../src/Doc/library/test.rst:231 +#: library/test.rst:231 msgid ":const:`True` when Unicode support is available." msgstr "" -#: ../src/Doc/library/test.rst:236 +#: library/test.rst:236 msgid ":const:`True` if the running interpreter is Jython." msgstr "" -#: ../src/Doc/library/test.rst:241 +#: library/test.rst:241 msgid "" "Set to a name that is safe to use as the name of a temporary file. Any " "temporary file that is created should be closed and unlinked (removed)." msgstr "" # e75c1e6ffc034f718d48e6983ded58da -#: ../src/Doc/library/test.rst:244 +#: library/test.rst:244 msgid "The :mod:`test.test_support` module defines the following functions:" msgstr "" -#: ../src/Doc/library/test.rst:249 +#: library/test.rst:249 msgid "" "Remove the module named *module_name* from ``sys.modules`` and delete any " "byte-compiled files of the module." msgstr "" -#: ../src/Doc/library/test.rst:255 +#: library/test.rst:255 msgid "" "Return :const:`True` if *resource* is enabled and available. The list of " "available resources is only set when :mod:`test.regrtest` is executing the " "tests." msgstr "" -#: ../src/Doc/library/test.rst:262 +#: library/test.rst:262 msgid "" "Raise :exc:`ResourceDenied` if *resource* is not available. *msg* is the " "argument to :exc:`ResourceDenied` if it is raised. Always returns :const:" @@ -105498,21 +107707,21 @@ msgid "" "when tests are executed by :mod:`test.regrtest`." msgstr "" -#: ../src/Doc/library/test.rst:270 +#: library/test.rst:270 msgid "" "Return the path to the file named *filename*. If no match is found " "*filename* is returned. This does not equal a failure since it could be the " "path to the file." msgstr "" -#: ../src/Doc/library/test.rst:277 +#: library/test.rst:277 msgid "" "Execute :class:`unittest.TestCase` subclasses passed to the function. The " "function scans the classes for methods starting with the prefix ``test_`` " "and executes the tests individually." msgstr "" -#: ../src/Doc/library/test.rst:281 +#: library/test.rst:281 msgid "" "It is also legal to pass strings as parameters; these should be keys in " "``sys.modules``. Each associated module will be scanned by ``unittest." @@ -105520,11 +107729,11 @@ msgid "" "func:`test_main` function::" msgstr "" -#: ../src/Doc/library/test.rst:289 +#: library/test.rst:289 msgid "This will run all tests defined in the named module." msgstr "" -#: ../src/Doc/library/test.rst:294 +#: library/test.rst:294 msgid "" "A convenience wrapper for :func:`warnings.catch_warnings()` that makes it " "easier to test that a warning was correctly raised. It is approximately " @@ -105533,7 +107742,7 @@ msgid "" "automatically validate the results that are recorded." msgstr "" -#: ../src/Doc/library/test.rst:300 +#: library/test.rst:300 msgid "" "``check_warnings`` accepts 2-tuples of the form ``(\"message regexp\", " "WarningCategory)`` as positional arguments. If one or more *filters* are " @@ -105545,15 +107754,15 @@ msgid "" "*quiet* to :const:`True`." msgstr "" -#: ../src/Doc/library/test.rst:309 +#: library/test.rst:309 msgid "If no arguments are specified, it defaults to::" msgstr "" -#: ../src/Doc/library/test.rst:313 +#: library/test.rst:313 msgid "In this case all warnings are caught and no errors are raised." msgstr "" -#: ../src/Doc/library/test.rst:315 +#: library/test.rst:315 msgid "" "On entry to the context manager, a :class:`WarningRecorder` instance is " "returned. The underlying warnings list from :func:`~warnings.catch_warnings` " @@ -105565,36 +107774,40 @@ msgid "" "return :const:`None`." msgstr "" -#: ../src/Doc/library/test.rst:324 +#: library/test.rst:324 msgid "" "The recorder object also has a :meth:`reset` method, which clears the " "warnings list." msgstr "" -#: ../src/Doc/library/test.rst:327 +#: library/test.rst:327 msgid "The context manager is designed to be used like this::" msgstr "" -#: ../src/Doc/library/test.rst:334 +#: library/test.rst:334 msgid "" "In this case if either warning was not raised, or some other warning was " "raised, :func:`check_warnings` would raise an error." msgstr "" -#: ../src/Doc/library/test.rst:337 +#: library/test.rst:337 msgid "" "When a test needs to look more deeply into the warnings, rather than just " "checking whether or not they occurred, code like this can be used::" msgstr "" -#: ../src/Doc/library/test.rst:350 +#: library/test.rst:350 msgid "" "Here all warnings will be caught, and the test code tests the captured " "warnings directly." msgstr "" +#: library/test.rst:354 +msgid "New optional arguments *filters* and *quiet*." +msgstr "" + # bbad4bba49484fb4b0fcf598337f9b24 -#: ../src/Doc/library/test.rst:360 +#: library/test.rst:360 msgid "" "Similar to :func:`check_warnings`, but for Python 3 compatibility warnings. " "If ``sys.py3kwarning == 1``, it checks if the warning is effectively raised. " @@ -105605,31 +107818,31 @@ msgid "" "defaults to::" msgstr "" -#: ../src/Doc/library/test.rst:375 +#: library/test.rst:375 msgid "" "This is a context manager that runs the :keyword:`with` statement body using " "a :class:`StringIO.StringIO` object as sys.stdout. That object can be " "retrieved using the ``as`` clause of the :keyword:`with` statement." msgstr "" -#: ../src/Doc/library/test.rst:379 ../src/Doc/library/test.rst:424 +#: library/test.rst:379 library/test.rst:424 msgid "Example use::" msgstr "" -#: ../src/Doc/library/test.rst:390 +#: library/test.rst:390 msgid "" "This function imports and returns the named module. Unlike a normal import, " "this function raises :exc:`unittest.SkipTest` if the module cannot be " "imported." msgstr "" -#: ../src/Doc/library/test.rst:394 ../src/Doc/library/test.rst:418 +#: library/test.rst:394 library/test.rst:418 msgid "" "Module and package deprecation messages are suppressed during this import if " "*deprecated* is :const:`True`." msgstr "" -#: ../src/Doc/library/test.rst:402 +#: library/test.rst:402 msgid "" "This function imports and returns a fresh copy of the named Python module by " "removing the named module from ``sys.modules`` before doing the import. Note " @@ -105637,38 +107850,38 @@ msgid "" "operation." msgstr "" -#: ../src/Doc/library/test.rst:407 +#: library/test.rst:407 msgid "" "*fresh* is an iterable of additional module names that are also removed from " "the ``sys.modules`` cache before doing the import." msgstr "" -#: ../src/Doc/library/test.rst:410 +#: library/test.rst:410 msgid "" "*blocked* is an iterable of module names that are replaced with :const:`0` " "in the module cache during the import to ensure that attempts to import them " "raise :exc:`ImportError`." msgstr "" -#: ../src/Doc/library/test.rst:414 +#: library/test.rst:414 msgid "" "The named module and any modules named in the *fresh* and *blocked* " "parameters are saved before starting the import and then reinserted into " "``sys.modules`` when the fresh import is complete." msgstr "" -#: ../src/Doc/library/test.rst:421 +#: library/test.rst:421 msgid "" "This function will raise :exc:`unittest.SkipTest` is the named module cannot " "be imported." msgstr "" # d74dbc206b3b4e0b94d33a4f9084347d -#: ../src/Doc/library/test.rst:436 +#: library/test.rst:436 msgid "The :mod:`test.test_support` module defines the following classes:" msgstr "" -#: ../src/Doc/library/test.rst:440 +#: library/test.rst:440 msgid "" "Instances are a context manager that raises :exc:`ResourceDenied` if the " "specified exception type is raised. Any keyword arguments are treated as " @@ -105677,7 +107890,7 @@ msgid "" "attributes on the exception is :exc:`ResourceDenied` raised." msgstr "" -#: ../src/Doc/library/test.rst:449 +#: library/test.rst:449 msgid "" "Class used to temporarily set or unset environment variables. Instances can " "be used as a context manager and have a complete dictionary interface for " @@ -105686,32 +107899,36 @@ msgid "" "instance will be rolled back." msgstr "" -#: ../src/Doc/library/test.rst:462 +#: library/test.rst:456 +msgid "Added dictionary interface." +msgstr "" + +#: library/test.rst:462 msgid "" "Temporarily set the environment variable ``envvar`` to the value of " "``value``." msgstr "" -#: ../src/Doc/library/test.rst:468 +#: library/test.rst:468 msgid "Temporarily unset the environment variable ``envvar``." msgstr "" -#: ../src/Doc/library/test.rst:473 +#: library/test.rst:473 msgid "" "Class used to record warnings for unit tests. See documentation of :func:" "`check_warnings` above for more details." msgstr "" -#: ../src/Doc/library/textwrap.rst:2 +#: library/textwrap.rst:2 msgid ":mod:`textwrap` --- Text wrapping and filling" msgstr "" # 764f2f47e4fb45febba4a5284e2fde7c -#: ../src/Doc/library/textwrap.rst:11 +#: library/textwrap.rst:11 msgid "**Source code:** :source:`Lib/textwrap.py`" msgstr "" -#: ../src/Doc/library/textwrap.rst:15 +#: library/textwrap.rst:15 msgid "" "The :mod:`textwrap` module provides two convenience functions, :func:`wrap` " "and :func:`fill`, as well as :class:`TextWrapper`, the class that does all " @@ -105721,39 +107938,39 @@ msgid "" "for efficiency." msgstr "" -#: ../src/Doc/library/textwrap.rst:23 +#: library/textwrap.rst:23 msgid "" "Wraps the single paragraph in *text* (a string) so every line is at most " "*width* characters long. Returns a list of output lines, without final " "newlines." msgstr "" -#: ../src/Doc/library/textwrap.rst:26 +#: library/textwrap.rst:26 msgid "" "Optional keyword arguments correspond to the instance attributes of :class:" "`TextWrapper`, documented below. *width* defaults to ``70``." msgstr "" # a1463df8b70d4187be3c7fcfb2d08351 -#: ../src/Doc/library/textwrap.rst:29 +#: library/textwrap.rst:29 msgid "" "See the :meth:`TextWrapper.wrap` method for additional details on how :func:" "`wrap` behaves." msgstr "" -#: ../src/Doc/library/textwrap.rst:35 +#: library/textwrap.rst:35 msgid "" "Wraps the single paragraph in *text*, and returns a single string containing " "the wrapped paragraph. :func:`fill` is shorthand for ::" msgstr "" -#: ../src/Doc/library/textwrap.rst:40 +#: library/textwrap.rst:40 msgid "" "In particular, :func:`fill` accepts exactly the same keyword arguments as :" "func:`wrap`." msgstr "" -#: ../src/Doc/library/textwrap.rst:43 +#: library/textwrap.rst:43 msgid "" "Both :func:`wrap` and :func:`fill` work by creating a :class:`TextWrapper` " "instance and calling a single method on it. That instance is not reused, so " @@ -105761,32 +107978,32 @@ msgid "" "for you to create your own :class:`TextWrapper` object." msgstr "" -#: ../src/Doc/library/textwrap.rst:48 +#: library/textwrap.rst:48 msgid "" "Text is preferably wrapped on whitespaces and right after the hyphens in " "hyphenated words; only then will long words be broken if necessary, unless :" "attr:`TextWrapper.break_long_words` is set to false." msgstr "" -#: ../src/Doc/library/textwrap.rst:52 +#: library/textwrap.rst:52 msgid "" "An additional utility function, :func:`dedent`, is provided to remove " "indentation from strings that have unwanted whitespace to the left of the " "text." msgstr "" -#: ../src/Doc/library/textwrap.rst:58 +#: library/textwrap.rst:58 msgid "Remove any common leading whitespace from every line in *text*." msgstr "" -#: ../src/Doc/library/textwrap.rst:60 +#: library/textwrap.rst:60 msgid "" "This can be used to make triple-quoted strings line up with the left edge of " "the display, while still presenting them in the source code in indented form." msgstr "" # 8aaa2b7bfeeb465ebbaf7ded566d4039 -#: ../src/Doc/library/textwrap.rst:63 +#: library/textwrap.rst:63 msgid "" "Note that tabs and spaces are both treated as whitespace, but they are not " "equal: the lines ``\" hello\"`` and ``\"\\thello\"`` are considered to have " @@ -105796,31 +108013,31 @@ msgid "" msgstr "" # c56c29ab74184ee2886b9bce3816780f -#: ../src/Doc/library/textwrap.rst:83 +#: library/textwrap.rst:83 msgid "" "The :class:`TextWrapper` constructor accepts a number of optional keyword " "arguments. Each argument corresponds to one instance attribute, so for " "example ::" msgstr "" -#: ../src/Doc/library/textwrap.rst:89 +#: library/textwrap.rst:89 msgid "is the same as ::" msgstr "" -#: ../src/Doc/library/textwrap.rst:94 +#: library/textwrap.rst:94 msgid "" "You can re-use the same :class:`TextWrapper` object many times, and you can " "change any of its options through direct assignment to instance attributes " "between uses." msgstr "" -#: ../src/Doc/library/textwrap.rst:98 +#: library/textwrap.rst:98 msgid "" "The :class:`TextWrapper` instance attributes (and keyword arguments to the " "constructor) are as follows:" msgstr "" -#: ../src/Doc/library/textwrap.rst:104 +#: library/textwrap.rst:104 msgid "" "(default: ``70``) The maximum length of wrapped lines. As long as there are " "no individual words in the input text longer than :attr:`width`, :class:" @@ -105828,14 +108045,14 @@ msgid "" "`width` characters." msgstr "" -#: ../src/Doc/library/textwrap.rst:112 +#: library/textwrap.rst:112 msgid "" "(default: ``True``) If true, then all tab characters in *text* will be " "expanded to spaces using the :meth:`expandtabs` method of *text*." msgstr "" # dd962f30f8cd4b42858f25ddd2ad0358 -#: ../src/Doc/library/textwrap.rst:118 +#: library/textwrap.rst:118 msgid "" "(default: ``True``) If true, after tab expansion but before wrapping, the :" "meth:`wrap` method will replace each whitespace character with a single " @@ -105843,7 +108060,7 @@ msgid "" "vertical tab, formfeed, and carriage return (``'\\t\\n\\v\\f\\r'``)." msgstr "" -#: ../src/Doc/library/textwrap.rst:126 +#: library/textwrap.rst:126 msgid "" "If :attr:`expand_tabs` is false and :attr:`replace_whitespace` is true, each " "tab character will be replaced by a single space, which is *not* the same as " @@ -105851,7 +108068,7 @@ msgid "" msgstr "" # dd43327728fa4914a6f2952ddb402ad3 -#: ../src/Doc/library/textwrap.rst:132 +#: library/textwrap.rst:132 msgid "" "If :attr:`replace_whitespace` is false, newlines may appear in the middle of " "a line and cause strange output. For this reason, text should be split into " @@ -105860,7 +108077,7 @@ msgid "" msgstr "" # a176615e623d4de88f72ebfc1aa2d87b -#: ../src/Doc/library/textwrap.rst:140 +#: library/textwrap.rst:140 msgid "" "(default: ``True``) If true, whitespace at the beginning and ending of every " "line (after wrapping but before indenting) is dropped. Whitespace at the " @@ -105869,22 +108086,26 @@ msgid "" "line is dropped." msgstr "" +#: library/textwrap.rst:146 +msgid "Whitespace was always dropped in earlier versions." +msgstr "" + # 9d42f58aa4294531ad798223b4e092f8 -#: ../src/Doc/library/textwrap.rst:152 +#: library/textwrap.rst:152 msgid "" "(default: ``''``) String that will be prepended to the first line of wrapped " "output. Counts towards the length of the first line. The empty string is " "not indented." msgstr "" -#: ../src/Doc/library/textwrap.rst:159 +#: library/textwrap.rst:159 msgid "" "(default: ``''``) String that will be prepended to all lines of wrapped " "output except the first. Counts towards the length of each line except the " "first." msgstr "" -#: ../src/Doc/library/textwrap.rst:166 +#: library/textwrap.rst:166 msgid "" "(default: ``False``) If true, :class:`TextWrapper` attempts to detect " "sentence endings and ensure that sentences are always separated by exactly " @@ -105896,15 +108117,15 @@ msgid "" "unable to detect the difference between \"Dr.\" in ::" msgstr "" -#: ../src/Doc/library/textwrap.rst:177 +#: library/textwrap.rst:177 msgid "and \"Spot.\" in ::" msgstr "" -#: ../src/Doc/library/textwrap.rst:181 +#: library/textwrap.rst:181 msgid ":attr:`fix_sentence_endings` is false by default." msgstr "" -#: ../src/Doc/library/textwrap.rst:183 +#: library/textwrap.rst:183 msgid "" "Since the sentence detection algorithm relies on ``string.lowercase`` for " "the definition of \"lowercase letter,\" and a convention of using two spaces " @@ -105912,7 +108133,7 @@ msgid "" "English-language texts." msgstr "" -#: ../src/Doc/library/textwrap.rst:191 +#: library/textwrap.rst:191 msgid "" "(default: ``True``) If true, then words longer than :attr:`width` will be " "broken in order to ensure that no lines are longer than :attr:`width`. If " @@ -105921,7 +108142,7 @@ msgid "" "order to minimize the amount by which :attr:`width` is exceeded.)" msgstr "" -#: ../src/Doc/library/textwrap.rst:200 +#: library/textwrap.rst:200 msgid "" "(default: ``True``) If true, wrapping will occur preferably on whitespaces " "and right after hyphens in compound words, as it is customary in English. If " @@ -105931,14 +108152,14 @@ msgid "" "always allow breaking hyphenated words." msgstr "" -#: ../src/Doc/library/textwrap.rst:210 +#: library/textwrap.rst:210 msgid "" ":class:`TextWrapper` also provides two public methods, analogous to the " "module-level convenience functions:" msgstr "" # 9a0585a79a9d48f1b1a6d5deb83b9cea -#: ../src/Doc/library/textwrap.rst:215 +#: library/textwrap.rst:215 msgid "" "Wraps the single paragraph in *text* (a string) so every line is at most :" "attr:`width` characters long. All wrapping options are taken from instance " @@ -105947,19 +108168,19 @@ msgid "" "returned list is empty." msgstr "" -#: ../src/Doc/library/textwrap.rst:224 +#: library/textwrap.rst:224 msgid "" "Wraps the single paragraph in *text*, and returns a single string containing " "the wrapped paragraph." msgstr "" # e7cb01e1a5474a159cbadd41e3250c5a -#: ../src/Doc/library/thread.rst:2 +#: library/thread.rst:2 msgid ":mod:`thread` --- Multiple threads of control" msgstr "" # f032f09aa217499e9ddc75fc380f25c6 -#: ../src/Doc/library/thread.rst:8 +#: library/thread.rst:8 msgid "" "The :mod:`thread` module has been renamed to :mod:`_thread` in Python 3. " "The :term:`2to3` tool will automatically adapt imports when converting your " @@ -105967,7 +108188,7 @@ msgid "" "`threading` module instead." msgstr "" -#: ../src/Doc/library/thread.rst:20 +#: library/thread.rst:20 msgid "" "This module provides low-level primitives for working with multiple threads " "(also called :dfn:`light-weight processes` or :dfn:`tasks`) --- multiple " @@ -105978,7 +108199,7 @@ msgid "" msgstr "" # cc9077b7d30d4fc5bdcf72394fb4fccc -#: ../src/Doc/library/thread.rst:31 +#: library/thread.rst:31 msgid "" "The module is optional. It is supported on Windows, Linux, SGI IRIX, " "Solaris 2.x, as well as on systems that have a POSIX thread (a.k.a. \"pthread" @@ -105988,19 +108209,19 @@ msgid "" msgstr "" # 2077e59d882b4ac5bf997ebe8f280f9e -#: ../src/Doc/library/thread.rst:37 +#: library/thread.rst:37 msgid "It defines the following constant and functions:" msgstr "" -#: ../src/Doc/library/thread.rst:42 +#: library/thread.rst:42 msgid "Raised on thread-specific errors." msgstr "" -#: ../src/Doc/library/thread.rst:47 +#: library/thread.rst:47 msgid "This is the type of lock objects." msgstr "" -#: ../src/Doc/library/thread.rst:52 +#: library/thread.rst:52 msgid "" "Start a new thread and return its identifier. The thread executes the " "function *function* with the argument list *args* (which must be a tuple). " @@ -106010,19 +108231,19 @@ msgid "" "the thread exits (but other threads continue to run)." msgstr "" -#: ../src/Doc/library/thread.rst:62 +#: library/thread.rst:62 msgid "" "Raise a :exc:`KeyboardInterrupt` exception in the main thread. A subthread " "can use this function to interrupt the main thread." msgstr "" -#: ../src/Doc/library/thread.rst:70 +#: library/thread.rst:70 msgid "" "Raise the :exc:`SystemExit` exception. When not caught, this will cause the " "thread to exit silently." msgstr "" -#: ../src/Doc/library/thread.rst:84 +#: library/thread.rst:84 msgid "" "Return a new lock object. Methods of locks are described below. The lock " "is initially unlocked." @@ -106030,7 +108251,7 @@ msgstr "" "Retourne un nouvel objet *lock*. Les méthodes de l'objet *lock* sont " "décrites ci-après. Le *lock* est initialement déverrouillé." -#: ../src/Doc/library/thread.rst:90 +#: library/thread.rst:90 msgid "" "Return the 'thread identifier' of the current thread. This is a nonzero " "integer. Its value has no direct meaning; it is intended as a magic cookie " @@ -106039,31 +108260,31 @@ msgid "" "created." msgstr "" -# b120bc089792434ca180fe14352cecb2 -#: ../src/Doc/library/thread.rst:98 +#: library/thread.rst:98 msgid "" "Return the thread stack size used when creating new threads. The optional " "*size* argument specifies the stack size to be used for subsequently created " "threads, and must be 0 (use platform or configured default) or a positive " -"integer value of at least 32,768 (32kB). If changing the thread stack size " -"is unsupported, the :exc:`error` exception is raised. If the specified " -"stack size is invalid, a :exc:`ValueError` is raised and the stack size is " -"unmodified. 32kB is currently the minimum supported stack size value to " -"guarantee sufficient stack space for the interpreter itself. Note that some " -"platforms may have particular restrictions on values for the stack size, " -"such as requiring a minimum stack size > 32kB or requiring allocation in " -"multiples of the system memory page size - platform documentation should be " -"referred to for more information (4kB pages are common; using multiples of " -"4096 for the stack size is the suggested approach in the absence of more " -"specific information). Availability: Windows, systems with POSIX threads." +"integer value of at least 32,768 (32kB). If *size* is not specified, 0 is " +"used. If changing the thread stack size is unsupported, the :exc:`error` " +"exception is raised. If the specified stack size is invalid, a :exc:" +"`ValueError` is raised and the stack size is unmodified. 32kB is currently " +"the minimum supported stack size value to guarantee sufficient stack space " +"for the interpreter itself. Note that some platforms may have particular " +"restrictions on values for the stack size, such as requiring a minimum stack " +"size > 32kB or requiring allocation in multiples of the system memory page " +"size - platform documentation should be referred to for more information " +"(4kB pages are common; using multiples of 4096 for the stack size is the " +"suggested approach in the absence of more specific information). " +"Availability: Windows, systems with POSIX threads." msgstr "" -#: ../src/Doc/library/thread.rst:116 +#: library/thread.rst:117 msgid "Lock objects have the following methods:" msgstr "" # 57d2cd43d3f94562bf41ceb60a445bc3 -#: ../src/Doc/library/thread.rst:121 +#: library/thread.rst:122 msgid "" "Without the optional argument, this method acquires the lock " "unconditionally, if necessary waiting until it is released by another thread " @@ -106075,29 +108296,29 @@ msgid "" "lock is acquired successfully, ``False`` if not." msgstr "" -#: ../src/Doc/library/thread.rst:132 +#: library/thread.rst:133 msgid "" "Releases the lock. The lock must have been acquired earlier, but not " "necessarily by the same thread." msgstr "" -#: ../src/Doc/library/thread.rst:138 +#: library/thread.rst:139 msgid "" "Return the status of the lock: ``True`` if it has been acquired by some " "thread, ``False`` if not." msgstr "" -#: ../src/Doc/library/thread.rst:141 +#: library/thread.rst:142 msgid "" "In addition to these methods, lock objects can also be used via the :keyword:" "`with` statement, e.g.::" msgstr "" -#: ../src/Doc/library/thread.rst:151 +#: library/thread.rst:152 msgid "**Caveats:**" msgstr "**Avertissements :**" -#: ../src/Doc/library/thread.rst:155 +#: library/thread.rst:156 msgid "" "Threads interact strangely with interrupts: the :exc:`KeyboardInterrupt` " "exception will be received by an arbitrary thread. (When the :mod:`signal` " @@ -106105,13 +108326,13 @@ msgid "" msgstr "" # a07bdfd968e64d059c1db33e2f23edf7 -#: ../src/Doc/library/thread.rst:159 +#: library/thread.rst:160 msgid "" "Calling :func:`sys.exit` or raising the :exc:`SystemExit` exception is " "equivalent to calling :func:`thread.exit`." msgstr "" -#: ../src/Doc/library/thread.rst:162 +#: library/thread.rst:163 msgid "" "It is not possible to interrupt the :meth:`acquire` method on a lock --- " "the :exc:`KeyboardInterrupt` exception will happen after the lock has been " @@ -106119,7 +108340,7 @@ msgid "" msgstr "" # e3888818bde24a30a4269003bc6f68ed -#: ../src/Doc/library/thread.rst:167 +#: library/thread.rst:168 msgid "" "When the main thread exits, it is system defined whether the other threads " "survive. On SGI IRIX using the native thread implementation, they survive. " @@ -106127,24 +108348,24 @@ msgid "" "keyword:`finally` clauses or executing object destructors." msgstr "" -#: ../src/Doc/library/thread.rst:172 +#: library/thread.rst:173 msgid "" "When the main thread exits, it does not do any of its usual cleanup (except " "that :keyword:`try` ... :keyword:`finally` clauses are honored), and the " "standard I/O files are not flushed." msgstr "" -#: ../src/Doc/library/threading.rst:2 +#: library/threading.rst:2 msgid ":mod:`threading` --- Higher-level threading interface" msgstr "" # d82e5e9babdc4db1946409a79db74d91 -#: ../src/Doc/library/threading.rst:7 +#: library/threading.rst:7 msgid "**Source code:** :source:`Lib/threading.py`" msgstr "" # 011533f0cf41480da1b458e43fcbaab7 -#: ../src/Doc/library/threading.rst:11 +#: library/threading.rst:11 msgid "" "This module constructs higher-level threading interfaces on top of the " "lower level :mod:`thread` module. See also the :mod:`mutex` and :mod:`Queue` " @@ -106152,14 +108373,14 @@ msgid "" msgstr "" # 1b411b90300e43ee97d43a261b4c7936 -#: ../src/Doc/library/threading.rst:15 +#: library/threading.rst:15 msgid "" "The :mod:`dummy_threading` module is provided for situations where :mod:" "`threading` cannot be used because :mod:`thread` is missing." msgstr "" # 5eca4bcf70594bdf9957fbeeff5dd8fd -#: ../src/Doc/library/threading.rst:20 +#: library/threading.rst:20 msgid "" "Starting with Python 2.6, this module provides :pep:`8` compliant aliases " "and properties to replace the ``camelCase`` names that were inspired by " @@ -106170,14 +108391,14 @@ msgid "" msgstr "" # 736dc6991d0c464f86f9094b828cf5ce -#: ../src/Doc/library/threading.rst:29 +#: library/threading.rst:29 msgid "" "Starting with Python 2.5, several Thread methods raise :exc:`RuntimeError` " "instead of :exc:`AssertionError` if called erroneously." msgstr "" # e13920ab118f4df7bc2554efc5351514 -#: ../src/Doc/library/threading.rst:34 +#: library/threading.rst:34 msgid "" "In CPython, due to the :term:`Global Interpreter Lock`, only one thread can " "execute Python code at once (even though certain performance-oriented " @@ -106187,17 +108408,21 @@ msgid "" "appropriate model if you want to run multiple I/O-bound tasks simultaneously." msgstr "" -#: ../src/Doc/library/threading.rst:43 +#: library/threading.rst:43 msgid "This module defines the following functions and objects:" msgstr "" -#: ../src/Doc/library/threading.rst:48 +#: library/threading.rst:48 msgid "" "Return the number of :class:`Thread` objects currently alive. The returned " "count is equal to the length of the list returned by :func:`.enumerate`." msgstr "" -#: ../src/Doc/library/threading.rst:58 +#: library/threading.rst:51 +msgid "Added ``active_count()`` spelling." +msgstr "" + +#: library/threading.rst:58 msgid "" "A factory function that returns a new condition variable object. A condition " "variable allows one or more threads to wait until they are notified by " @@ -106205,11 +108430,11 @@ msgid "" msgstr "" # 393557f274b649ebb72826b00e4e835d -#: ../src/Doc/library/threading.rst:62 +#: library/threading.rst:62 msgid "See :ref:`condition-objects`." msgstr "" -#: ../src/Doc/library/threading.rst:68 +#: library/threading.rst:68 msgid "" "Return the current :class:`Thread` object, corresponding to the caller's " "thread of control. If the caller's thread of control was not created " @@ -106217,7 +108442,11 @@ msgid "" "functionality is returned." msgstr "" -#: ../src/Doc/library/threading.rst:79 +#: library/threading.rst:73 +msgid "Added ``current_thread()`` spelling." +msgstr "" + +#: library/threading.rst:79 msgid "" "Return a list of all :class:`Thread` objects currently alive. The list " "includes daemonic threads, dummy thread objects created by :func:" @@ -106225,7 +108454,7 @@ msgid "" "threads that have not yet been started." msgstr "" -#: ../src/Doc/library/threading.rst:88 +#: library/threading.rst:88 msgid "" "A factory function that returns a new event object. An event manages a flag " "that can be set to true with the :meth:`~Event.set` method and reset to " @@ -106234,28 +108463,28 @@ msgid "" msgstr "" # c7b5706d4f694c368871c323b34b2088 -#: ../src/Doc/library/threading.rst:93 +#: library/threading.rst:93 msgid "See :ref:`event-objects`." msgstr "" -#: ../src/Doc/library/threading.rst:98 +#: library/threading.rst:98 msgid "" "A class that represents thread-local data. Thread-local data are data whose " "values are thread specific. To manage thread-local data, just create an " "instance of :class:`local` (or a subclass) and store attributes on it::" msgstr "" -#: ../src/Doc/library/threading.rst:105 +#: library/threading.rst:105 msgid "The instance's values will be different for separate threads." msgstr "" -#: ../src/Doc/library/threading.rst:107 +#: library/threading.rst:107 msgid "" "For more details and extensive examples, see the documentation string of " "the :mod:`_threading_local` module." msgstr "" -#: ../src/Doc/library/threading.rst:115 +#: library/threading.rst:115 msgid "" "A factory function that returns a new primitive lock object. Once a thread " "has acquired it, subsequent attempts to acquire it block, until it is " @@ -106263,11 +108492,11 @@ msgid "" msgstr "" # 9b95cecfe92e499d9eaaf6abe12ecf77 -#: ../src/Doc/library/threading.rst:119 +#: library/threading.rst:119 msgid "See :ref:`lock-objects`." msgstr "" -#: ../src/Doc/library/threading.rst:124 +#: library/threading.rst:124 msgid "" "A factory function that returns a new reentrant lock object. A reentrant " "lock must be released by the thread that acquired it. Once a thread has " @@ -106276,11 +108505,11 @@ msgid "" msgstr "" # 7d3e3a683519426dbd9ed69e91690870 -#: ../src/Doc/library/threading.rst:129 +#: library/threading.rst:129 msgid "See :ref:`rlock-objects`." msgstr "" -#: ../src/Doc/library/threading.rst:135 +#: library/threading.rst:135 msgid "" "A factory function that returns a new semaphore object. A semaphore manages " "a counter representing the number of :meth:`release` calls minus the number " @@ -106290,11 +108519,11 @@ msgid "" msgstr "" # 91fac4c971954a729ae2bcc6f8ddb68d -#: ../src/Doc/library/threading.rst:141 +#: library/threading.rst:141 msgid "See :ref:`semaphore-objects`." msgstr "" -#: ../src/Doc/library/threading.rst:146 +#: library/threading.rst:146 msgid "" "A factory function that returns a new bounded semaphore object. A bounded " "semaphore checks to make sure its current value doesn't exceed its initial " @@ -106304,29 +108533,29 @@ msgid "" "*value* defaults to 1." msgstr "" -#: ../src/Doc/library/threading.rst:156 +#: library/threading.rst:156 msgid "" "A class that represents a thread of control. This class can be safely " "subclassed in a limited fashion." msgstr "" # 26b2ecd5a4ad4e8eb0bdc754a8be3d7e -#: ../src/Doc/library/threading.rst:159 +#: library/threading.rst:159 msgid "See :ref:`thread-objects`." msgstr "" -#: ../src/Doc/library/threading.rst:165 +#: library/threading.rst:165 msgid "" "A thread that executes a function after a specified interval has passed." msgstr "" # fc111c54aef04f13b489b7f99a3f563f -#: ../src/Doc/library/threading.rst:167 +#: library/threading.rst:167 msgid "See :ref:`timer-objects`." msgstr "" # 48acc48e52b34c789397dc9ebc9c082d -#: ../src/Doc/library/threading.rst:174 +#: library/threading.rst:174 msgid "" "Set a trace function for all threads started from the :mod:`threading` " "module. The *func* will be passed to :func:`sys.settrace` for each thread, " @@ -106334,43 +108563,44 @@ msgid "" msgstr "" # 725f766baef649d7912043b43acc5bf1 -#: ../src/Doc/library/threading.rst:185 +#: library/threading.rst:185 msgid "" "Set a profile function for all threads started from the :mod:`threading` " "module. The *func* will be passed to :func:`sys.setprofile` for each " "thread, before its :meth:`~Thread.run` method is called." msgstr "" -#: ../src/Doc/library/threading.rst:194 +#: library/threading.rst:194 msgid "" "Return the thread stack size used when creating new threads. The optional " "*size* argument specifies the stack size to be used for subsequently created " "threads, and must be 0 (use platform or configured default) or a positive " -"integer value of at least 32,768 (32kB). If changing the thread stack size " -"is unsupported, a :exc:`ThreadError` is raised. If the specified stack size " -"is invalid, a :exc:`ValueError` is raised and the stack size is unmodified. " -"32kB is currently the minimum supported stack size value to guarantee " -"sufficient stack space for the interpreter itself. Note that some platforms " -"may have particular restrictions on values for the stack size, such as " -"requiring a minimum stack size > 32kB or requiring allocation in multiples " -"of the system memory page size - platform documentation should be referred " -"to for more information (4kB pages are common; using multiples of 4096 for " -"the stack size is the suggested approach in the absence of more specific " -"information). Availability: Windows, systems with POSIX threads." +"integer value of at least 32,768 (32 KiB). If *size* is not specified, 0 is " +"used. If changing the thread stack size is unsupported, a :exc:" +"`ThreadError` is raised. If the specified stack size is invalid, a :exc:" +"`ValueError` is raised and the stack size is unmodified. 32kB is currently " +"the minimum supported stack size value to guarantee sufficient stack space " +"for the interpreter itself. Note that some platforms may have particular " +"restrictions on values for the stack size, such as requiring a minimum stack " +"size > 32kB or requiring allocation in multiples of the system memory page " +"size - platform documentation should be referred to for more information " +"(4kB pages are common; using multiples of 4096 for the stack size is the " +"suggested approach in the absence of more specific information). " +"Availability: Windows, systems with POSIX threads." msgstr "" # 0c5626c4d9d54abdab5f20894bbf6bc4 -#: ../src/Doc/library/threading.rst:214 +#: library/threading.rst:215 msgid "" "Raised for various threading-related errors as described below. Note that " "many interfaces use :exc:`RuntimeError` instead of :exc:`ThreadError`." msgstr "" -#: ../src/Doc/library/threading.rst:218 +#: library/threading.rst:219 msgid "Detailed interfaces for the objects are documented below." msgstr "" -#: ../src/Doc/library/threading.rst:220 +#: library/threading.rst:221 msgid "" "The design of this module is loosely based on Java's threading model. " "However, where Java makes locks and condition variables basic behavior of " @@ -106381,15 +108611,15 @@ msgid "" "Thread class, when implemented, are mapped to module-level functions." msgstr "" -#: ../src/Doc/library/threading.rst:228 +#: library/threading.rst:229 msgid "All of the methods described below are executed atomically." msgstr "" -#: ../src/Doc/library/threading.rst:234 +#: library/threading.rst:235 msgid "Thread Objects" msgstr "" -#: ../src/Doc/library/threading.rst:236 +#: library/threading.rst:237 msgid "" "This class represents an activity that is run in a separate thread of " "control. There are two ways to specify the activity: by passing a callable " @@ -106399,14 +108629,14 @@ msgid "" "`__init__` and :meth:`run` methods of this class." msgstr "" -#: ../src/Doc/library/threading.rst:243 +#: library/threading.rst:244 msgid "" "Once a thread object is created, its activity must be started by calling the " "thread's :meth:`start` method. This invokes the :meth:`run` method in a " "separate thread of control." msgstr "" -#: ../src/Doc/library/threading.rst:247 +#: library/threading.rst:248 msgid "" "Once the thread's activity is started, the thread is considered 'alive'. It " "stops being alive when its :meth:`run` method terminates -- either normally, " @@ -106414,20 +108644,20 @@ msgid "" "whether the thread is alive." msgstr "" -#: ../src/Doc/library/threading.rst:252 +#: library/threading.rst:253 msgid "" "Other threads can call a thread's :meth:`join` method. This blocks the " "calling thread until the thread whose :meth:`join` method is called is " "terminated." msgstr "" -#: ../src/Doc/library/threading.rst:255 +#: library/threading.rst:256 msgid "" "A thread has a name. The name can be passed to the constructor, and read or " "changed through the :attr:`name` attribute." msgstr "" -#: ../src/Doc/library/threading.rst:258 +#: library/threading.rst:259 msgid "" "A thread can be flagged as a \"daemon thread\". The significance of this " "flag is that the entire Python program exits when only daemon threads are " @@ -106436,7 +108666,7 @@ msgid "" msgstr "" # c3df59adad804f9a91387a173cacea36 -#: ../src/Doc/library/threading.rst:264 +#: library/threading.rst:265 msgid "" "Daemon threads are abruptly stopped at shutdown. Their resources (such as " "open files, database transactions, etc.) may not be released properly. If " @@ -106444,13 +108674,13 @@ msgid "" "suitable signalling mechanism such as an :class:`Event`." msgstr "" -#: ../src/Doc/library/threading.rst:269 +#: library/threading.rst:270 msgid "" "There is a \"main thread\" object; this corresponds to the initial thread of " "control in the Python program. It is not a daemon thread." msgstr "" -#: ../src/Doc/library/threading.rst:272 +#: library/threading.rst:273 msgid "" "There is the possibility that \"dummy thread objects\" are created. These " "are thread objects corresponding to \"alien threads\", which are threads of " @@ -106460,70 +108690,70 @@ msgid "" "deleted, since it is impossible to detect the termination of alien threads." msgstr "" -#: ../src/Doc/library/threading.rst:282 +#: library/threading.rst:283 msgid "" "This constructor should always be called with keyword arguments. Arguments " "are:" msgstr "" -#: ../src/Doc/library/threading.rst:285 +#: library/threading.rst:286 msgid "" "*group* should be ``None``; reserved for future extension when a :class:" "`ThreadGroup` class is implemented." msgstr "" -#: ../src/Doc/library/threading.rst:288 +#: library/threading.rst:289 msgid "" "*target* is the callable object to be invoked by the :meth:`run` method. " "Defaults to ``None``, meaning nothing is called." msgstr "" -#: ../src/Doc/library/threading.rst:291 +#: library/threading.rst:292 msgid "" "*name* is the thread name. By default, a unique name is constructed of the " "form \"Thread-*N*\" where *N* is a small decimal number." msgstr "" -#: ../src/Doc/library/threading.rst:294 +#: library/threading.rst:295 msgid "" "*args* is the argument tuple for the target invocation. Defaults to ``()``." msgstr "" -#: ../src/Doc/library/threading.rst:296 +#: library/threading.rst:297 msgid "" "*kwargs* is a dictionary of keyword arguments for the target invocation. " "Defaults to ``{}``." msgstr "" -#: ../src/Doc/library/threading.rst:299 +#: library/threading.rst:300 msgid "" "If the subclass overrides the constructor, it must make sure to invoke the " "base class constructor (``Thread.__init__()``) before doing anything else to " "the thread." msgstr "" -#: ../src/Doc/library/threading.rst:305 +#: library/threading.rst:306 msgid "Start the thread's activity." msgstr "" -#: ../src/Doc/library/threading.rst:307 +#: library/threading.rst:308 msgid "" "It must be called at most once per thread object. It arranges for the " "object's :meth:`run` method to be invoked in a separate thread of control." msgstr "" # 9880934e0990446fa81fab06235d2d1d -#: ../src/Doc/library/threading.rst:310 +#: library/threading.rst:311 msgid "" "This method will raise a :exc:`RuntimeError` if called more than once on the " "same thread object." msgstr "" -#: ../src/Doc/library/threading.rst:315 +#: library/threading.rst:316 msgid "Method representing the thread's activity." msgstr "" -#: ../src/Doc/library/threading.rst:317 +#: library/threading.rst:318 msgid "" "You may override this method in a subclass. The standard :meth:`run` method " "invokes the callable object passed to the object's constructor as the " @@ -106531,7 +108761,7 @@ msgid "" "the *args* and *kwargs* arguments, respectively." msgstr "" -#: ../src/Doc/library/threading.rst:324 +#: library/threading.rst:325 msgid "" "Wait until the thread terminates. This blocks the calling thread until the " "thread whose :meth:`join` method is called terminates -- either normally or " @@ -106539,7 +108769,7 @@ msgid "" msgstr "" # d7f76ada4db94366ad2913385e8bcf82 -#: ../src/Doc/library/threading.rst:328 +#: library/threading.rst:329 msgid "" "When the *timeout* argument is present and not ``None``, it should be a " "floating point number specifying a timeout for the operation in seconds (or " @@ -106548,17 +108778,17 @@ msgid "" "the thread is still alive, the :meth:`join` call timed out." msgstr "" -#: ../src/Doc/library/threading.rst:334 +#: library/threading.rst:335 msgid "" "When the *timeout* argument is not present or ``None``, the operation will " "block until the thread terminates." msgstr "" -#: ../src/Doc/library/threading.rst:337 +#: library/threading.rst:338 msgid "A thread can be :meth:`join`\\ ed many times." msgstr "" -#: ../src/Doc/library/threading.rst:339 +#: library/threading.rst:340 msgid "" ":meth:`join` raises a :exc:`RuntimeError` if an attempt is made to join the " "current thread as that would cause a deadlock. It is also an error to :meth:" @@ -106566,7 +108796,7 @@ msgid "" "same exception." msgstr "" -#: ../src/Doc/library/threading.rst:346 +#: library/threading.rst:347 msgid "" "A string used for identification purposes only. It has no semantics. " "Multiple threads may be given the same name. The initial name is set by the " @@ -106574,11 +108804,11 @@ msgid "" msgstr "" # 13f9afb93445422295ce71c7c533ae6e -#: ../src/Doc/library/threading.rst:355 +#: library/threading.rst:356 msgid "Pre-2.6 API for :attr:`~Thread.name`." msgstr "" -#: ../src/Doc/library/threading.rst:359 +#: library/threading.rst:360 msgid "" "The 'thread identifier' of this thread or ``None`` if the thread has not " "been started. This is a nonzero integer. See the :func:`thread." @@ -106587,19 +108817,23 @@ msgid "" "the thread has exited." msgstr "" -#: ../src/Doc/library/threading.rst:370 +#: library/threading.rst:371 msgid "Return whether the thread is alive." msgstr "" # 623a7eb5dbf54055b98f4fc9d20f362d -#: ../src/Doc/library/threading.rst:372 +#: library/threading.rst:373 msgid "" "This method returns ``True`` just before the :meth:`run` method starts until " "just after the :meth:`run` method terminates. The module function :func:`." "enumerate` returns a list of all alive threads." msgstr "" -#: ../src/Doc/library/threading.rst:381 +#: library/threading.rst:377 +msgid "Added ``is_alive()`` spelling." +msgstr "" + +#: library/threading.rst:382 msgid "" "A boolean value indicating whether this thread is a daemon thread (True) or " "not (False). This must be set before :meth:`start` is called, otherwise :" @@ -106608,22 +108842,22 @@ msgid "" "threads created in the main thread default to :attr:`daemon` = ``False``." msgstr "" -#: ../src/Doc/library/threading.rst:388 +#: library/threading.rst:389 msgid "" "The entire Python program exits when no alive non-daemon threads are left." msgstr "" # 4467a4b435694c528e447f1593d16f6d -#: ../src/Doc/library/threading.rst:395 +#: library/threading.rst:396 msgid "Pre-2.6 API for :attr:`~Thread.daemon`." msgstr "" -#: ../src/Doc/library/threading.rst:401 +#: library/threading.rst:402 msgid "Lock Objects" msgstr "" # 78a3cb0a8aa746eb9b707512706329ba -#: ../src/Doc/library/threading.rst:403 +#: library/threading.rst:404 msgid "" "A primitive lock is a synchronization primitive that is not owned by a " "particular thread when locked. In Python, it is currently the lowest level " @@ -106632,7 +108866,7 @@ msgid "" msgstr "" # 0e02b01a814941c8aaf3d69631bb7651 -#: ../src/Doc/library/threading.rst:408 +#: library/threading.rst:409 msgid "" "A primitive lock is in one of two states, \"locked\" or \"unlocked\". It is " "created in the unlocked state. It has two basic methods, :meth:`acquire` " @@ -106646,7 +108880,7 @@ msgid "" "raised." msgstr "" -#: ../src/Doc/library/threading.rst:418 +#: library/threading.rst:419 msgid "" "When more than one thread is blocked in :meth:`acquire` waiting for the " "state to turn to unlocked, only one thread proceeds when a :meth:`release` " @@ -106654,34 +108888,30 @@ msgid "" "is not defined, and may vary across implementations." msgstr "" -#: ../src/Doc/library/threading.rst:423 +#: library/threading.rst:424 msgid "All methods are executed atomically." msgstr "" -#: ../src/Doc/library/threading.rst:428 ../src/Doc/library/threading.rst:472 -msgid "Acquire a lock, blocking or non-blocking." -msgstr "" - # d73f12714c37471e9731d42d344113bd -#: ../src/Doc/library/threading.rst:430 +#: library/threading.rst:431 msgid "" "When invoked with the *blocking* argument set to ``True`` (the default), " "block until the lock is unlocked, then set it to locked and return ``True``." msgstr "" # 241217bfe1514e65bbb43e98192e8f48 -#: ../src/Doc/library/threading.rst:433 +#: library/threading.rst:434 msgid "" "When invoked with the *blocking* argument set to ``False``, do not block. If " "a call with *blocking* set to ``True`` would block, return ``False`` " "immediately; otherwise, set the lock to locked and return ``True``." msgstr "" -#: ../src/Doc/library/threading.rst:440 +#: library/threading.rst:441 msgid "Release a lock." msgstr "" -#: ../src/Doc/library/threading.rst:442 +#: library/threading.rst:443 msgid "" "When the lock is locked, reset it to unlocked, and return. If any other " "threads are blocked waiting for the lock to become unlocked, allow exactly " @@ -106689,19 +108919,19 @@ msgid "" msgstr "" # 0c33c33caad741cfa8644f7f3f036a0f -#: ../src/Doc/library/threading.rst:446 +#: library/threading.rst:447 msgid "When invoked on an unlocked lock, a :exc:`ThreadError` is raised." msgstr "" -#: ../src/Doc/library/threading.rst:448 ../src/Doc/library/threading.rst:502 +#: library/threading.rst:449 library/threading.rst:503 msgid "There is no return value." msgstr "" -#: ../src/Doc/library/threading.rst:454 +#: library/threading.rst:455 msgid "RLock Objects" msgstr "" -#: ../src/Doc/library/threading.rst:456 +#: library/threading.rst:457 msgid "" "A reentrant lock is a synchronization primitive that may be acquired " "multiple times by the same thread. Internally, it uses the concepts of " @@ -106710,7 +108940,7 @@ msgid "" "lock; in the unlocked state, no thread owns it." msgstr "" -#: ../src/Doc/library/threading.rst:462 +#: library/threading.rst:463 msgid "" "To lock the lock, a thread calls its :meth:`acquire` method; this returns " "once the thread owns the lock. To unlock the lock, a thread calls its :meth:" @@ -106720,7 +108950,7 @@ msgid "" "`acquire` to proceed." msgstr "" -#: ../src/Doc/library/threading.rst:474 +#: library/threading.rst:475 msgid "" "When invoked without arguments: if this thread already owns the lock, " "increment the recursion level by one, and return immediately. Otherwise, if " @@ -106731,20 +108961,20 @@ msgid "" "ownership of the lock. There is no return value in this case." msgstr "" -#: ../src/Doc/library/threading.rst:482 +#: library/threading.rst:483 msgid "" "When invoked with the *blocking* argument set to true, do the same thing as " "when called without arguments, and return true." msgstr "" -#: ../src/Doc/library/threading.rst:485 +#: library/threading.rst:486 msgid "" "When invoked with the *blocking* argument set to false, do not block. If a " "call without an argument would block, return false immediately; otherwise, " "do the same thing as when called without arguments, and return true." msgstr "" -#: ../src/Doc/library/threading.rst:492 +#: library/threading.rst:493 msgid "" "Release a lock, decrementing the recursion level. If after the decrement it " "is zero, reset the lock to unlocked (not owned by any thread), and if any " @@ -106753,17 +108983,17 @@ msgid "" "is still nonzero, the lock remains locked and owned by the calling thread." msgstr "" -#: ../src/Doc/library/threading.rst:498 +#: library/threading.rst:499 msgid "" "Only call this method when the calling thread owns the lock. A :exc:" "`RuntimeError` is raised if this method is called when the lock is unlocked." msgstr "" -#: ../src/Doc/library/threading.rst:508 +#: library/threading.rst:509 msgid "Condition Objects" msgstr "" -#: ../src/Doc/library/threading.rst:510 +#: library/threading.rst:511 msgid "" "A condition variable is always associated with some kind of lock; this can " "be passed in or one will be created by default. (Passing one in is useful " @@ -106771,7 +109001,7 @@ msgid "" msgstr "" # 9170973b80d844128086918db9df2423 -#: ../src/Doc/library/threading.rst:514 +#: library/threading.rst:515 msgid "" "A condition variable has :meth:`acquire` and :meth:`release` methods that " "call the corresponding methods of the associated lock. It also has a :meth:" @@ -106781,7 +109011,7 @@ msgid "" msgstr "" # ff4a1261336f41dea255e02bc1a5c9b1 -#: ../src/Doc/library/threading.rst:520 +#: library/threading.rst:521 msgid "" "The :meth:`wait` method releases the lock, and then blocks until it is " "awakened by a :meth:`notify` or :meth:`notifyAll` call for the same " @@ -106790,7 +109020,7 @@ msgid "" msgstr "" # 9f8fafc9ed9f40b28995c17af1baafbe -#: ../src/Doc/library/threading.rst:525 +#: library/threading.rst:526 msgid "" "The :meth:`notify` method wakes up one of the threads waiting for the " "condition variable, if any are waiting. The :meth:`notifyAll` method wakes " @@ -106798,7 +109028,7 @@ msgid "" msgstr "" # 38ca7bc6c2b6449bae843c7441cf0e8e -#: ../src/Doc/library/threading.rst:529 +#: library/threading.rst:530 msgid "" "Note: the :meth:`notify` and :meth:`notifyAll` methods don't release the " "lock; this means that the thread or threads awakened will not return from " @@ -106808,7 +109038,7 @@ msgid "" msgstr "" # 82340ce6718048a59bf54722008ce2e7 -#: ../src/Doc/library/threading.rst:534 +#: library/threading.rst:535 msgid "" "Tip: the typical programming style using condition variables uses the lock " "to synchronize access to some shared state; threads that are interested in a " @@ -106821,7 +109051,7 @@ msgid "" msgstr "" # 5749e08dba4946e58a222fcde3045443 -#: ../src/Doc/library/threading.rst:555 +#: library/threading.rst:556 msgid "" "To choose between :meth:`notify` and :meth:`notifyAll`, consider whether one " "state change can be interesting for only one or several waiting threads. E." @@ -106829,26 +109059,26 @@ msgid "" "only needs to wake up one consumer thread." msgstr "" -#: ../src/Doc/library/threading.rst:563 +#: library/threading.rst:564 msgid "" "If the *lock* argument is given and not ``None``, it must be a :class:`Lock` " "or :class:`RLock` object, and it is used as the underlying lock. Otherwise, " "a new :class:`RLock` object is created and used as the underlying lock." msgstr "" -#: ../src/Doc/library/threading.rst:569 +#: library/threading.rst:570 msgid "" "Acquire the underlying lock. This method calls the corresponding method on " "the underlying lock; the return value is whatever that method returns." msgstr "" -#: ../src/Doc/library/threading.rst:574 +#: library/threading.rst:575 msgid "" "Release the underlying lock. This method calls the corresponding method on " "the underlying lock; there is no return value." msgstr "" -#: ../src/Doc/library/threading.rst:579 +#: library/threading.rst:580 msgid "" "Wait until notified or until a timeout occurs. If the calling thread has not " "acquired the lock when this method is called, a :exc:`RuntimeError` is " @@ -106856,7 +109086,7 @@ msgid "" msgstr "" # f52ec3c39ee345bc961383db49e3033c -#: ../src/Doc/library/threading.rst:582 +#: library/threading.rst:583 msgid "" "This method releases the underlying lock, and then blocks until it is " "awakened by a :meth:`notify` or :meth:`notifyAll` call for the same " @@ -106864,14 +109094,14 @@ msgid "" "Once awakened or timed out, it re-acquires the lock and returns." msgstr "" -#: ../src/Doc/library/threading.rst:587 +#: library/threading.rst:588 msgid "" "When the *timeout* argument is present and not ``None``, it should be a " "floating point number specifying a timeout for the operation in seconds (or " "fractions thereof)." msgstr "" -#: ../src/Doc/library/threading.rst:591 +#: library/threading.rst:592 msgid "" "When the underlying lock is an :class:`RLock`, it is not released using its :" "meth:`release` method, since this may not actually unlock the lock when it " @@ -106882,7 +109112,7 @@ msgid "" msgstr "" # 97d135c9f0a14281a7aa36e2483c248a -#: ../src/Doc/library/threading.rst:601 +#: library/threading.rst:602 msgid "" "By default, wake up one thread waiting on this condition, if any. If the " "calling thread has not acquired the lock when this method is called, a :exc:" @@ -106890,14 +109120,14 @@ msgid "" msgstr "" # 186791408cd2411c922c9e74565343e9 -#: ../src/Doc/library/threading.rst:605 +#: library/threading.rst:606 msgid "" "This method wakes up at most *n* of the threads waiting for the condition " "variable; it is a no-op if no threads are waiting." msgstr "" # 204dd95fd3564d0caeaaf361aa25ce47 -#: ../src/Doc/library/threading.rst:608 +#: library/threading.rst:609 msgid "" "The current implementation wakes up exactly *n* threads, if at least *n* " "threads are waiting. However, it's not safe to rely on this behavior. A " @@ -106906,14 +109136,14 @@ msgid "" msgstr "" # 9065e841dbff42ce987a63444c95f6d4 -#: ../src/Doc/library/threading.rst:613 +#: library/threading.rst:614 msgid "" "Note: an awakened thread does not actually return from its :meth:`wait` call " "until it can reacquire the lock. Since :meth:`notify` does not release the " "lock, its caller should." msgstr "" -#: ../src/Doc/library/threading.rst:620 +#: library/threading.rst:621 msgid "" "Wake up all threads waiting on this condition. This method acts like :meth:" "`notify`, but wakes up all waiting threads instead of one. If the calling " @@ -106921,11 +109151,15 @@ msgid "" "`RuntimeError` is raised." msgstr "" -#: ../src/Doc/library/threading.rst:632 +#: library/threading.rst:626 +msgid "Added ``notify_all()`` spelling." +msgstr "" + +#: library/threading.rst:633 msgid "Semaphore Objects" msgstr "" -#: ../src/Doc/library/threading.rst:634 +#: library/threading.rst:635 msgid "" "This is one of the oldest synchronization primitives in the history of " "computer science, invented by the early Dutch computer scientist Edsger W. " @@ -106933,7 +109167,7 @@ msgid "" "meth:`release`)." msgstr "" -#: ../src/Doc/library/threading.rst:638 +#: library/threading.rst:639 msgid "" "A semaphore manages an internal counter which is decremented by each :meth:" "`acquire` call and incremented by each :meth:`release` call. The counter " @@ -106941,19 +109175,19 @@ msgid "" "blocks, waiting until some other thread calls :meth:`release`." msgstr "" -#: ../src/Doc/library/threading.rst:646 +#: library/threading.rst:647 msgid "" "The optional argument gives the initial *value* for the internal counter; it " "defaults to ``1``. If the *value* given is less than 0, :exc:`ValueError` is " "raised." msgstr "" -#: ../src/Doc/library/threading.rst:652 +#: library/threading.rst:653 msgid "Acquire a semaphore." msgstr "" # 5ebc03d400c9480588654cb3a4bb9dc7 -#: ../src/Doc/library/threading.rst:654 +#: library/threading.rst:655 msgid "" "When invoked without arguments: if the internal counter is larger than zero " "on entry, decrement it by one and return immediately. If it is zero on " @@ -106966,32 +109200,32 @@ msgid "" msgstr "" # 236af3d100954f8aa2e45e05bdaf233a -#: ../src/Doc/library/threading.rst:663 +#: library/threading.rst:664 msgid "" "When invoked with *blocking* set to true, do the same thing as when called " "without arguments, and return true." msgstr "" -#: ../src/Doc/library/threading.rst:666 +#: library/threading.rst:667 msgid "" "When invoked with *blocking* set to false, do not block. If a call without " "an argument would block, return false immediately; otherwise, do the same " "thing as when called without arguments, and return true." msgstr "" -#: ../src/Doc/library/threading.rst:672 +#: library/threading.rst:673 msgid "" "Release a semaphore, incrementing the internal counter by one. When it was " "zero on entry and another thread is waiting for it to become larger than " "zero again, wake up that thread." msgstr "" -#: ../src/Doc/library/threading.rst:680 +#: library/threading.rst:681 msgid ":class:`Semaphore` Example" msgstr "" # 8d382c21244a4dafb816d585d3579f36 -#: ../src/Doc/library/threading.rst:682 +#: library/threading.rst:683 msgid "" "Semaphores are often used to guard resources with limited capacity, for " "example, a database server. In any situation where the size of the resource " @@ -106999,52 +109233,56 @@ msgid "" "threads, your main thread would initialize the semaphore::" msgstr "" -#: ../src/Doc/library/threading.rst:691 +#: library/threading.rst:692 msgid "" "Once spawned, worker threads call the semaphore's acquire and release " "methods when they need to connect to the server::" msgstr "" -#: ../src/Doc/library/threading.rst:700 +#: library/threading.rst:701 msgid "" "The use of a bounded semaphore reduces the chance that a programming error " "which causes the semaphore to be released more than it's acquired will go " "undetected." msgstr "" -#: ../src/Doc/library/threading.rst:707 +#: library/threading.rst:708 msgid "Event Objects" msgstr "" -#: ../src/Doc/library/threading.rst:709 +#: library/threading.rst:710 msgid "" "This is one of the simplest mechanisms for communication between threads: " "one thread signals an event and other threads wait for it." msgstr "" -#: ../src/Doc/library/threading.rst:712 +#: library/threading.rst:713 msgid "" "An event object manages an internal flag that can be set to true with the :" -"meth:`~Event.set` method and reset to false with the :meth:`clear` method. " -"The :meth:`wait` method blocks until the flag is true." +"meth:`~Event.set` method and reset to false with the :meth:`~Event.clear` " +"method. The :meth:`~Event.wait` method blocks until the flag is true." msgstr "" -#: ../src/Doc/library/threading.rst:719 +#: library/threading.rst:720 msgid "The internal flag is initially false." msgstr "" -#: ../src/Doc/library/threading.rst:724 +#: library/threading.rst:725 msgid "Return true if and only if the internal flag is true." msgstr "" -#: ../src/Doc/library/threading.rst:731 +#: library/threading.rst:727 +msgid "Added ``is_set()`` spelling." +msgstr "" + +#: library/threading.rst:732 msgid "" "Set the internal flag to true. All threads waiting for it to become true are " "awakened. Threads that call :meth:`wait` once the flag is true will not " "block at all." msgstr "" -#: ../src/Doc/library/threading.rst:737 +#: library/threading.rst:738 msgid "" "Reset the internal flag to false. Subsequently, threads calling :meth:`wait` " "will block until :meth:`.set` is called to set the internal flag to true " @@ -107052,31 +109290,31 @@ msgid "" msgstr "" # 87ad84c53400433dab3ba162e40e3520 -#: ../src/Doc/library/threading.rst:743 +#: library/threading.rst:744 msgid "" "Block until the internal flag is true. If the internal flag is true on " "entry, return immediately. Otherwise, block until another thread calls :" "meth:`.set` to set the flag to true, or until the optional timeout occurs." msgstr "" -#: ../src/Doc/library/threading.rst:748 +#: library/threading.rst:749 msgid "" "When the timeout argument is present and not ``None``, it should be a " "floating point number specifying a timeout for the operation in seconds (or " "fractions thereof)." msgstr "" -#: ../src/Doc/library/threading.rst:752 +#: library/threading.rst:753 msgid "" "This method returns the internal flag on exit, so it will always return " "``True`` except if a timeout is given and the operation times out." msgstr "" -#: ../src/Doc/library/threading.rst:762 +#: library/threading.rst:763 msgid "Timer Objects" msgstr "" -#: ../src/Doc/library/threading.rst:764 +#: library/threading.rst:765 msgid "" "This class represents an action that should be run only after a certain " "amount of time has passed --- a timer. :class:`Timer` is a subclass of :" @@ -107085,7 +109323,7 @@ msgid "" msgstr "" # f440b6890cb44e7785b047076e4890ee -#: ../src/Doc/library/threading.rst:768 +#: library/threading.rst:769 msgid "" "Timers are started, as with threads, by calling their :meth:`~Timer.start` " "method. The timer can be stopped (before its action has begun) by calling " @@ -107094,24 +109332,24 @@ msgid "" "by the user." msgstr "" -#: ../src/Doc/library/threading.rst:785 +#: library/threading.rst:786 msgid "" "Create a timer that will run *function* with arguments *args* and keyword " "arguments *kwargs*, after *interval* seconds have passed." msgstr "" -#: ../src/Doc/library/threading.rst:790 +#: library/threading.rst:791 msgid "" "Stop the timer, and cancel the execution of the timer's action. This will " "only work if the timer is still in its waiting stage." msgstr "" -#: ../src/Doc/library/threading.rst:797 +#: library/threading.rst:798 msgid "" "Using locks, conditions, and semaphores in the :keyword:`with` statement" msgstr "" -#: ../src/Doc/library/threading.rst:799 +#: library/threading.rst:800 msgid "" "All of the objects provided by this module that have :meth:`acquire` and :" "meth:`release` methods can be used as context managers for a :keyword:`with` " @@ -107119,26 +109357,26 @@ msgid "" "entered, and :meth:`release` will be called when the block is exited." msgstr "" -#: ../src/Doc/library/threading.rst:804 +#: library/threading.rst:805 msgid "" "Currently, :class:`Lock`, :class:`RLock`, :class:`Condition`, :class:" "`Semaphore`, and :class:`BoundedSemaphore` objects may be used as :keyword:" "`with` statement context managers. For example::" msgstr "" -#: ../src/Doc/library/threading.rst:819 +#: library/threading.rst:820 msgid "Importing in threaded code" msgstr "" # bcb157a014d743ffa31e10fc37c597e3 -#: ../src/Doc/library/threading.rst:821 +#: library/threading.rst:822 msgid "" "While the import machinery is thread-safe, there are two key restrictions on " "threaded imports due to inherent limitations in the way that thread-safety " "is provided:" msgstr "" -#: ../src/Doc/library/threading.rst:825 +#: library/threading.rst:826 msgid "" "Firstly, other than in the main module, an import should not have the side " "effect of spawning a new thread and then waiting for that thread in any way. " @@ -107146,7 +109384,7 @@ msgid "" "thread directly or indirectly attempts to import a module." msgstr "" -#: ../src/Doc/library/threading.rst:829 +#: library/threading.rst:830 msgid "" "Secondly, all import attempts must be completed before the interpreter " "starts shutting itself down. This can be most easily achieved by only " @@ -107159,17 +109397,17 @@ msgid "" "is no longer in a valid state)." msgstr "" -#: ../src/Doc/library/time.rst:3 +#: library/time.rst:3 msgid ":mod:`time` --- Time access and conversions" msgstr "" -#: ../src/Doc/library/time.rst:9 +#: library/time.rst:9 msgid "" "This module provides various time-related functions. For related " "functionality, see also the :mod:`datetime` and :mod:`calendar` modules." msgstr "" -#: ../src/Doc/library/time.rst:12 +#: library/time.rst:12 msgid "" "Although this module is always available, not all functions are available on " "all platforms. Most of the functions defined in this module call platform C " @@ -107178,25 +109416,25 @@ msgid "" "varies among platforms." msgstr "" -#: ../src/Doc/library/time.rst:18 +#: library/time.rst:18 msgid "An explanation of some terminology and conventions is in order." msgstr "" -#: ../src/Doc/library/time.rst:22 +#: library/time.rst:22 msgid "" "The :dfn:`epoch` is the point where the time starts. On January 1st of that " "year, at 0 hours, the \"time since the epoch\" is zero. For Unix, the epoch " "is 1970. To find out what the epoch is, look at ``gmtime(0)``." msgstr "" -#: ../src/Doc/library/time.rst:28 +#: library/time.rst:28 msgid "" "The functions in this module do not handle dates and times before the epoch " "or far in the future. The cut-off point in the future is determined by the " "C library; for Unix, it is typically in 2038." msgstr "" -#: ../src/Doc/library/time.rst:38 +#: library/time.rst:38 msgid "" "**Year 2000 (Y2K) issues**: Python depends on the platform's C library, " "which generally doesn't have year 2000 issues, since all dates and times are " @@ -107210,19 +109448,17 @@ msgid "" "digit years for all year input. When 2-digit years are accepted, they are " "converted according to the POSIX or X/Open standard: values 69-99 are mapped " "to 1969-1999, and values 0--68 are mapped to 2000--2068. Values 100--1899 " -"are always illegal. Note that this is new as of Python 1.5.2(a2); earlier " -"versions, up to Python 1.5.1 and 1.5.2a1, would add 1900 to year values " -"below 1900." +"are always illegal." msgstr "" -#: ../src/Doc/library/time.rst:58 +#: library/time.rst:56 msgid "" "UTC is Coordinated Universal Time (formerly known as Greenwich Mean Time, or " "GMT). The acronym UTC is not a mistake but a compromise between English and " "French." msgstr "" -#: ../src/Doc/library/time.rst:64 +#: library/time.rst:62 msgid "" "DST is Daylight Saving Time, an adjustment of the timezone by (usually) one " "hour during part of the year. DST rules are magic (determined by local law) " @@ -107231,7 +109467,7 @@ msgid "" "only source of True Wisdom in this respect." msgstr "" -#: ../src/Doc/library/time.rst:70 +#: library/time.rst:68 msgid "" "The precision of the various real-time functions may be less than suggested " "by the units in which their value or argument is expressed. E.g. on most " @@ -107239,7 +109475,7 @@ msgid "" msgstr "" # 369d4abc6d31463d9ad9ea6f729a6394 -#: ../src/Doc/library/time.rst:74 +#: library/time.rst:72 msgid "" "On the other hand, the precision of :func:`.time` and :func:`sleep` is " "better than their Unix equivalents: times are expressed as floating point " @@ -107250,7 +109486,7 @@ msgid "" msgstr "" # ce40984dbf0249a8bcf62a46e061f61d -#: ../src/Doc/library/time.rst:81 +#: library/time.rst:79 msgid "" "The time value as returned by :func:`gmtime`, :func:`localtime`, and :func:" "`strptime`, and accepted by :func:`asctime`, :func:`mktime` and :func:" @@ -107260,52 +109496,58 @@ msgid "" msgstr "" # 65aa372197394027a0a7da6a022cfc20 -#: ../src/Doc/library/time.rst:87 +#: library/time.rst:85 msgid "See :class:`struct_time` for a description of these objects." msgstr "" -#: ../src/Doc/library/time.rst:93 +#: library/time.rst:87 +msgid "" +"The time value sequence was changed from a tuple to a :class:`struct_time`, " +"with the addition of attribute names for the fields." +msgstr "" + +#: library/time.rst:91 msgid "Use the following functions to convert between time representations:" msgstr "" -#: ../src/Doc/library/time.rst:96 +#: library/time.rst:94 msgid "Use" msgstr "" -#: ../src/Doc/library/time.rst:98 ../src/Doc/library/time.rst:101 -#: ../src/Doc/library/time.rst:104 ../src/Doc/library/time.rst:107 +#: library/time.rst:96 library/time.rst:99 library/time.rst:102 +#: library/time.rst:105 msgid "seconds since the epoch" msgstr "" -#: ../src/Doc/library/time.rst:98 ../src/Doc/library/time.rst:104 +#: library/time.rst:96 library/time.rst:102 msgid ":class:`struct_time` in UTC" msgstr "" -#: ../src/Doc/library/time.rst:98 +#: library/time.rst:96 msgid ":func:`gmtime`" msgstr "" -#: ../src/Doc/library/time.rst:101 ../src/Doc/library/time.rst:107 +#: library/time.rst:99 library/time.rst:105 msgid ":class:`struct_time` in local time" msgstr "" -#: ../src/Doc/library/time.rst:101 +#: library/time.rst:99 msgid ":func:`localtime`" msgstr "" -#: ../src/Doc/library/time.rst:104 +#: library/time.rst:102 msgid ":func:`calendar.timegm`" msgstr "" -#: ../src/Doc/library/time.rst:107 +#: library/time.rst:105 msgid ":func:`mktime`" msgstr "" -#: ../src/Doc/library/time.rst:112 +#: library/time.rst:110 msgid "The module defines the following functions and data items:" msgstr "" -#: ../src/Doc/library/time.rst:116 +#: library/time.rst:114 msgid "" "Boolean value indicating whether two-digit year values will be accepted. " "This is true by default, but will be set to false if the environment " @@ -107313,14 +109555,14 @@ msgid "" "also be modified at run time." msgstr "" -#: ../src/Doc/library/time.rst:124 +#: library/time.rst:122 msgid "" "The offset of the local DST timezone, in seconds west of UTC, if one is " "defined. This is negative if the local DST timezone is east of UTC (as in " "Western Europe, including the UK). Only use this if ``daylight`` is nonzero." msgstr "" -#: ../src/Doc/library/time.rst:131 +#: library/time.rst:129 msgid "" "Convert a tuple or :class:`struct_time` representing a time as returned by :" "func:`gmtime` or :func:`localtime` to a 24-character string of the following " @@ -107329,11 +109571,15 @@ msgid "" "used by :func:`asctime`." msgstr "" -#: ../src/Doc/library/time.rst:139 +#: library/time.rst:137 msgid "Unlike the C function of the same name, there is no trailing newline." msgstr "" -#: ../src/Doc/library/time.rst:152 +#: library/time.rst:139 library/time.rst:242 +msgid "Allowed *t* to be omitted." +msgstr "" + +#: library/time.rst:150 msgid "" "On Unix, return the current processor time as a floating point number " "expressed in seconds. The precision, and in fact the very definition of the " @@ -107343,7 +109589,7 @@ msgid "" msgstr "" # 440dd3df95ed4731a305b9fabcd7d3c5 -#: ../src/Doc/library/time.rst:157 +#: library/time.rst:155 msgid "" "On Windows, this function returns wall-clock seconds elapsed since the first " "call to this function, as a floating point number, based on the Win32 " @@ -107352,7 +109598,7 @@ msgid "" msgstr "" # 3a37fc79066b4739b6468c781cfa2d8e -#: ../src/Doc/library/time.rst:165 +#: library/time.rst:163 msgid "" "Convert a time expressed in seconds since the epoch to a string representing " "local time. If *secs* is not provided or :const:`None`, the current time as " @@ -107361,12 +109607,20 @@ msgid "" "`ctime`." msgstr "" -#: ../src/Doc/library/time.rst:179 +#: library/time.rst:168 library/time.rst:189 library/time.rst:202 +msgid "Allowed *secs* to be omitted." +msgstr "" + +#: library/time.rst:171 library/time.rst:192 library/time.rst:205 +msgid "If *secs* is :const:`None`, the current time is used." +msgstr "" + +#: library/time.rst:177 msgid "Nonzero if a DST timezone is defined." msgstr "" # 2fbac1da154449caaf598222a1be272a -#: ../src/Doc/library/time.rst:184 +#: library/time.rst:182 msgid "" "Convert a time expressed in seconds since the epoch to a :class:" "`struct_time` in UTC in which the dst flag is always zero. If *secs* is not " @@ -107377,7 +109631,7 @@ msgid "" msgstr "" # 9c4f31dcb2e54333a27290dc372c08c6 -#: ../src/Doc/library/time.rst:200 +#: library/time.rst:198 msgid "" "Like :func:`gmtime` but converts to local time. If *secs* is not provided " "or :const:`None`, the current time as returned by :func:`.time` is used. " @@ -107385,7 +109639,7 @@ msgid "" msgstr "" # 7748e8196d814f1eb6f83b4f41a450a9 -#: ../src/Doc/library/time.rst:213 +#: library/time.rst:211 msgid "" "This is the inverse function of :func:`localtime`. Its argument is the :" "class:`struct_time` or full 9-tuple (since the dst flag is needed; use " @@ -107398,19 +109652,19 @@ msgid "" "dependent." msgstr "" -#: ../src/Doc/library/time.rst:225 +#: library/time.rst:223 msgid "" -"Suspend execution for the given number of seconds. The argument may be a " -"floating point number to indicate a more precise sleep time. The actual " -"suspension time may be less than that requested because any caught signal " -"will terminate the :func:`sleep` following execution of that signal's " -"catching routine. Also, the suspension time may be longer than requested by " -"an arbitrary amount because of the scheduling of other activity in the " -"system." +"Suspend execution of the current thread for the given number of seconds. The " +"argument may be a floating point number to indicate a more precise sleep " +"time. The actual suspension time may be less than that requested because any " +"caught signal will terminate the :func:`sleep` following execution of that " +"signal's catching routine. Also, the suspension time may be longer than " +"requested by an arbitrary amount because of the scheduling of other activity " +"in the system." msgstr "" # f90128642ac54af694c9f7449a4e778a -#: ../src/Doc/library/time.rst:235 +#: library/time.rst:234 msgid "" "Convert a tuple or :class:`struct_time` representing a time as returned by :" "func:`gmtime` or :func:`localtime` to a string as specified by the *format* " @@ -107421,110 +109675,120 @@ msgid "" "unicode by doing ``strftime(<myformat>).decode(locale.getlocale()[1])``." msgstr "" -#: ../src/Doc/library/time.rst:253 +#: library/time.rst:245 +msgid ":exc:`ValueError` raised if a field in *t* is out of range." +msgstr "" + +#: library/time.rst:248 +msgid "" +"0 is now a legal argument for any position in the time tuple; if it is " +"normally illegal the value is forced to a correct one." +msgstr "" + +#: library/time.rst:252 msgid "" "The following directives can be embedded in the *format* string. They are " "shown without the optional field width and precision specification, and are " "replaced by the indicated characters in the :func:`strftime` result:" msgstr "" -#: ../src/Doc/library/time.rst:260 +#: library/time.rst:259 msgid "Locale's abbreviated weekday name." msgstr "" -#: ../src/Doc/library/time.rst:263 +#: library/time.rst:262 msgid "Locale's full weekday name." msgstr "" -#: ../src/Doc/library/time.rst:265 +#: library/time.rst:264 msgid "Locale's abbreviated month name." msgstr "" -#: ../src/Doc/library/time.rst:268 +#: library/time.rst:267 msgid "Locale's full month name." msgstr "" -#: ../src/Doc/library/time.rst:273 +#: library/time.rst:272 msgid "Day of the month as a decimal number [01,31]." msgstr "" -#: ../src/Doc/library/time.rst:276 +#: library/time.rst:275 msgid "Hour (24-hour clock) as a decimal number [00,23]." msgstr "" -#: ../src/Doc/library/time.rst:279 +#: library/time.rst:278 msgid "Hour (12-hour clock) as a decimal number [01,12]." msgstr "" -#: ../src/Doc/library/time.rst:282 +#: library/time.rst:281 msgid "Day of the year as a decimal number [001,366]." msgstr "" -#: ../src/Doc/library/time.rst:285 +#: library/time.rst:284 msgid "Month as a decimal number [01,12]." msgstr "" -#: ../src/Doc/library/time.rst:288 +#: library/time.rst:287 msgid "Minute as a decimal number [00,59]." msgstr "" -#: ../src/Doc/library/time.rst:294 +#: library/time.rst:293 msgid "Second as a decimal number [00,61]." msgstr "" -#: ../src/Doc/library/time.rst:297 +#: library/time.rst:296 msgid "" "Week number of the year (Sunday as the first day of the week) as a decimal " "number [00,53]. All days in a new year preceding the first Sunday are " "considered to be in week 0." msgstr "" -#: ../src/Doc/library/time.rst:305 +#: library/time.rst:304 msgid "Weekday as a decimal number [0(Sunday),6]." msgstr "" -#: ../src/Doc/library/time.rst:308 +#: library/time.rst:307 msgid "" "Week number of the year (Monday as the first day of the week) as a decimal " "number [00,53]. All days in a new year preceding the first Monday are " "considered to be in week 0." msgstr "" -#: ../src/Doc/library/time.rst:322 +#: library/time.rst:321 msgid "Year without century as a decimal number [00,99]." msgstr "" -#: ../src/Doc/library/time.rst:328 +#: library/time.rst:327 msgid "Time zone name (no characters if no time zone exists)." msgstr "" -#: ../src/Doc/library/time.rst:337 +#: library/time.rst:336 msgid "" "When used with the :func:`strptime` function, the ``%p`` directive only " "affects the output hour field if the ``%I`` directive is used to parse the " "hour." msgstr "" -#: ../src/Doc/library/time.rst:341 +#: library/time.rst:340 msgid "" "The range really is ``0`` to ``61``; this accounts for leap seconds and the " "(very rare) double leap seconds." msgstr "" -#: ../src/Doc/library/time.rst:345 +#: library/time.rst:344 msgid "" "When used with the :func:`strptime` function, ``%U`` and ``%W`` are only " "used in calculations when the day of the week and the year are specified." msgstr "" -#: ../src/Doc/library/time.rst:348 +#: library/time.rst:347 msgid "" "Here is an example, a format for dates compatible with that specified in " "the :rfc:`2822` Internet email standard. [#]_ ::" msgstr "" # 4837ebdb8c9c499698aa40c1a8070825 -#: ../src/Doc/library/time.rst:355 +#: library/time.rst:354 msgid "" "Additional directives may be supported on certain platforms, but only the " "ones listed here have a meaning standardized by ANSI C. To see the full set " @@ -107532,7 +109796,7 @@ msgid "" "`strftime(3)` documentation." msgstr "" -#: ../src/Doc/library/time.rst:360 +#: library/time.rst:359 msgid "" "On some platforms, an optional field width and precision specification can " "immediately follow the initial ``'%'`` of a directive in the following " @@ -107541,14 +109805,14 @@ msgid "" msgstr "" # a484c6fb845d400bbb8c89721b91345a -#: ../src/Doc/library/time.rst:368 +#: library/time.rst:367 msgid "" "Parse a string representing a time according to a format. The return value " "is a :class:`struct_time` as returned by :func:`gmtime` or :func:`localtime`." msgstr "" # 020a0ae4f6c640d588eebd75f42ff298 -#: ../src/Doc/library/time.rst:371 +#: library/time.rst:370 msgid "" "The *format* parameter uses the same directives as those used by :func:" "`strftime`; it defaults to ``\"%a %b %d %H:%M:%S %Y\"`` which matches the " @@ -107558,7 +109822,7 @@ msgid "" "accurate values cannot be inferred are ``(1900, 1, 1, 0, 0, 0, 0, 1, -1)``." msgstr "" -#: ../src/Doc/library/time.rst:385 +#: library/time.rst:384 msgid "" "Support for the ``%Z`` directive is based on the values contained in " "``tzname`` and whether ``daylight`` is true. Because of this, it is " @@ -107566,7 +109830,7 @@ msgid "" "(and are considered to be non-daylight savings timezones)." msgstr "" -#: ../src/Doc/library/time.rst:390 +#: library/time.rst:389 msgid "" "Only the directives specified in the documentation are supported. Because " "``strftime()`` is implemented per platform it can sometimes offer more " @@ -107576,7 +109840,7 @@ msgid "" msgstr "" # 2fa6d8bed4af42ce9a81ce74bf479e3c -#: ../src/Doc/library/time.rst:399 +#: library/time.rst:398 msgid "" "The type of the time value sequence returned by :func:`gmtime`, :func:" "`localtime`, and :func:`strptime`. It is an object with a :term:`named " @@ -107584,85 +109848,85 @@ msgid "" "The following values are present:" msgstr "" -#: ../src/Doc/library/time.rst:405 +#: library/time.rst:404 msgid "Values" msgstr "" -#: ../src/Doc/library/time.rst:407 +#: library/time.rst:406 msgid ":attr:`tm_year`" msgstr "" -#: ../src/Doc/library/time.rst:407 +#: library/time.rst:406 msgid "(for example, 1993)" msgstr "" -#: ../src/Doc/library/time.rst:409 +#: library/time.rst:408 msgid ":attr:`tm_mon`" msgstr "" -#: ../src/Doc/library/time.rst:409 +#: library/time.rst:408 msgid "range [1, 12]" msgstr "" -#: ../src/Doc/library/time.rst:411 +#: library/time.rst:410 msgid ":attr:`tm_mday`" msgstr "" -#: ../src/Doc/library/time.rst:411 +#: library/time.rst:410 msgid "range [1, 31]" msgstr "" -#: ../src/Doc/library/time.rst:413 +#: library/time.rst:412 msgid ":attr:`tm_hour`" msgstr "" -#: ../src/Doc/library/time.rst:413 +#: library/time.rst:412 msgid "range [0, 23]" msgstr "" -#: ../src/Doc/library/time.rst:415 +#: library/time.rst:414 msgid ":attr:`tm_min`" msgstr "" -#: ../src/Doc/library/time.rst:415 +#: library/time.rst:414 msgid "range [0, 59]" msgstr "" -#: ../src/Doc/library/time.rst:417 +#: library/time.rst:416 msgid ":attr:`tm_sec`" msgstr "" # 07cea1d191514dddadd6f26e25a7c48a -#: ../src/Doc/library/time.rst:417 +#: library/time.rst:416 msgid "range [0, 61]; see **(2)** in :func:`strftime` description" msgstr "" -#: ../src/Doc/library/time.rst:420 +#: library/time.rst:419 msgid ":attr:`tm_wday`" msgstr "" -#: ../src/Doc/library/time.rst:420 +#: library/time.rst:419 msgid "range [0, 6], Monday is 0" msgstr "" -#: ../src/Doc/library/time.rst:422 +#: library/time.rst:421 msgid ":attr:`tm_yday`" msgstr "" -#: ../src/Doc/library/time.rst:422 +#: library/time.rst:421 msgid "range [1, 366]" msgstr "" -#: ../src/Doc/library/time.rst:424 +#: library/time.rst:423 msgid ":attr:`tm_isdst`" msgstr "" -#: ../src/Doc/library/time.rst:424 +#: library/time.rst:423 msgid "0, 1 or -1; see below" msgstr "" # 29559812430344429b144340eac26f4b -#: ../src/Doc/library/time.rst:429 +#: library/time.rst:428 msgid "" "Note that unlike the C structure, the month value is a range of [1, 12], not " "[0, 11]. A year value will be handled as described under :ref:`Year 2000 " @@ -107671,7 +109935,7 @@ msgid "" "daylight savings state to be filled in." msgstr "" -#: ../src/Doc/library/time.rst:435 +#: library/time.rst:434 msgid "" "When a tuple with an incorrect length is passed to a function expecting a :" "class:`struct_time`, or having elements of the wrong type, a :exc:" @@ -107679,7 +109943,7 @@ msgid "" msgstr "" # 0420a470e8d74d36b24adcbd3e35448a -#: ../src/Doc/library/time.rst:442 +#: library/time.rst:441 msgid "" "Return the time in seconds since the epoch as a floating point number. Note " "that even though the time is always returned as a floating point number, not " @@ -107689,63 +109953,61 @@ msgid "" "calls." msgstr "" -#: ../src/Doc/library/time.rst:452 +#: library/time.rst:451 msgid "" "The offset of the local (non-DST) timezone, in seconds west of UTC (negative " "in most of Western Europe, positive in the US, zero in the UK)." msgstr "" -#: ../src/Doc/library/time.rst:458 +#: library/time.rst:457 msgid "" "A tuple of two strings: the first is the name of the local non-DST timezone, " "the second is the name of the local DST timezone. If no DST timezone is " "defined, the second string should not be used." msgstr "" -#: ../src/Doc/library/time.rst:465 +#: library/time.rst:464 msgid "" "Resets the time conversion rules used by the library routines. The " "environment variable :envvar:`TZ` specifies how this is done." msgstr "" -#: ../src/Doc/library/time.rst:474 +#: library/time.rst:473 msgid "" "Although in many cases, changing the :envvar:`TZ` environment variable may " "affect the output of functions like :func:`localtime` without calling :func:" "`tzset`, this behavior should not be relied on." msgstr "" -#: ../src/Doc/library/time.rst:478 +#: library/time.rst:477 msgid "The :envvar:`TZ` environment variable should contain no whitespace." msgstr "" -#: ../src/Doc/library/time.rst:480 +#: library/time.rst:479 msgid "" "The standard format of the :envvar:`TZ` environment variable is (whitespace " "added for clarity)::" msgstr "" -#: ../src/Doc/library/time.rst:485 +#: library/time.rst:484 msgid "Where the components are:" msgstr "" -# 85adfd0ee3da4fc893cd826b731c0eaf -#: ../src/Doc/library/time.rst:488 -msgid "``std`` and ``dst``" +#: library/time.rst:488 +msgid "std and dst" msgstr "" -#: ../src/Doc/library/time.rst:488 +#: library/time.rst:487 msgid "" "Three or more alphanumerics giving the timezone abbreviations. These will be " "propagated into time.tzname" msgstr "" -# af4bdacf73144285ad28e5942667a3b1 -#: ../src/Doc/library/time.rst:494 -msgid "``offset``" +#: library/time.rst:494 +msgid "offset" msgstr "" -#: ../src/Doc/library/time.rst:492 +#: library/time.rst:491 msgid "" "The offset has the form: ``± hh[:mm[:ss]]``. This indicates the value added " "the local time to arrive at UTC. If preceded by a '-', the timezone is east " @@ -107753,45 +110015,42 @@ msgid "" "summer time is assumed to be one hour ahead of standard time." msgstr "" -# 8781f1d94646433092e04da5557c344a -#: ../src/Doc/library/time.rst:516 -msgid "``start[/time], end[/time]``" +#: library/time.rst:516 +msgid "start[/time], end[/time]" msgstr "" -#: ../src/Doc/library/time.rst:498 +#: library/time.rst:497 msgid "" "Indicates when to change to and back from DST. The format of the start and " "end dates are one of the following:" msgstr "" -# c197e53b9a5d4976baf5ce12428061f8 -#: ../src/Doc/library/time.rst:502 -msgid ":samp:`J{n}`" +#: library/time.rst:502 +msgid "Jn" msgstr "" -#: ../src/Doc/library/time.rst:502 +#: library/time.rst:501 msgid "" "The Julian day *n* (1 <= *n* <= 365). Leap days are not counted, so in all " "years February 28 is day 59 and March 1 is day 60." msgstr "" -# 49895c05b3ab4c7c8b00edd1d984211f -#: ../src/Doc/library/time.rst:506 -msgid ":samp:`{n}`" -msgstr "" +#: library/time.rst:506 +#, fuzzy +msgid "n" +msgstr "non" -#: ../src/Doc/library/time.rst:506 +#: library/time.rst:505 msgid "" "The zero-based Julian day (0 <= *n* <= 365). Leap days are counted, and it " "is possible to refer to February 29." msgstr "" -# 3253a6629ee64e36a336bfbaba743115 -#: ../src/Doc/library/time.rst:513 -msgid ":samp:`M{m}.{n}.{d}`" +#: library/time.rst:513 +msgid "Mm.n.d" msgstr "" -#: ../src/Doc/library/time.rst:510 +#: library/time.rst:509 msgid "" "The *d*'th day (0 <= *d* <= 6) or week *n* of month *m* of the year (1 <= " "*n* <= 5, 1 <= *m* <= 12, where week 5 means \"the last *d* day in month *m*" @@ -107799,13 +110058,13 @@ msgid "" "first week in which the *d*'th day occurs. Day zero is Sunday." msgstr "" -#: ../src/Doc/library/time.rst:516 +#: library/time.rst:515 msgid "" "``time`` has the same format as ``offset`` except that no leading sign ('-' " "or '+') is allowed. The default, if time is not given, is 02:00:00." msgstr "" -#: ../src/Doc/library/time.rst:530 +#: library/time.rst:529 msgid "" "On many Unix systems (including \\*BSD, Linux, Solaris, and Darwin), it is " "more convenient to use the system's zoneinfo (:manpage:`tzfile(5)`) " @@ -107816,17 +110075,17 @@ msgid "" "``'Australia/Melbourne'``, ``'Egypt'`` or ``'Europe/Amsterdam'``. ::" msgstr "" -#: ../src/Doc/library/time.rst:551 +#: library/time.rst:550 msgid "More object-oriented interface to dates and times." msgstr "" -# 7df862a5a57c47bdb22469ea73416068 -#: ../src/Doc/library/time.rst:554 -msgid "Module :mod:`locale`" -msgstr "" +#: library/time.rst:554 +#, fuzzy +msgid "Module locale" +msgstr "Modules" # 8f17cce89e764df790e03d59dae09798 -#: ../src/Doc/library/time.rst:554 +#: library/time.rst:553 msgid "" "Internationalization services. The locale setting affects the " "interpretation of many format specifiers in :func:`strftime` and :func:" @@ -107834,14 +110093,14 @@ msgid "" msgstr "" # dfe242200f4445c4b9d945892ffac0fe -#: ../src/Doc/library/time.rst:558 +#: library/time.rst:557 msgid "" "General calendar-related functions. :func:`~calendar.timegm` is the " "inverse of :func:`gmtime` from this module." msgstr "" # 62caedb5547e4f2ab6c67bb5b7d01d6e -#: ../src/Doc/library/time.rst:563 +#: library/time.rst:562 msgid "" "The use of ``%Z`` is now deprecated, but the ``%z`` escape that expands to " "the preferred hour/minute offset is not supported by all ANSI C libraries. " @@ -107852,17 +110111,17 @@ msgid "" "rfc:`2822`." msgstr "" -#: ../src/Doc/library/timeit.rst:2 +#: library/timeit.rst:2 msgid ":mod:`timeit` --- Measure execution time of small code snippets" msgstr "" # 00db047c4f9a490897aa603897cd4b5a -#: ../src/Doc/library/timeit.rst:14 +#: library/timeit.rst:14 msgid "**Source code:** :source:`Lib/timeit.py`" msgstr "" # 19fd59063bb04d9ea074a8c69414e2a6 -#: ../src/Doc/library/timeit.rst:18 +#: library/timeit.rst:18 msgid "" "This module provides a simple way to time small bits of Python code. It has " "both a :ref:`command-line-interface` as well as a :ref:`callable <python-" @@ -107872,19 +110131,19 @@ msgid "" msgstr "" # b66522458d75401abde866abc0ee227e -#: ../src/Doc/library/timeit.rst:28 +#: library/timeit.rst:28 msgid "" "The following example shows how the :ref:`command-line-interface` can be " "used to compare three different expressions:" msgstr "" # 8b85dcb7c0994451b45fee971898be7c -#: ../src/Doc/library/timeit.rst:40 +#: library/timeit.rst:40 msgid "This can be achieved from the :ref:`python-interface` with::" msgstr "" # 2f58624f64a245bcab46ac7cb9e1a1bc -#: ../src/Doc/library/timeit.rst:50 +#: library/timeit.rst:50 msgid "" "Note however that :mod:`timeit` will automatically determine the number of " "repetitions only when the command-line interface is used. In the :ref:" @@ -107892,24 +110151,24 @@ msgid "" msgstr "" # 417150bdef0a497fbc284a89fb9253ac -#: ../src/Doc/library/timeit.rst:58 +#: library/timeit.rst:58 msgid "Python Interface" msgstr "" # bcca188d0ac440da8e49dcba386f358b -#: ../src/Doc/library/timeit.rst:60 +#: library/timeit.rst:60 msgid "The module defines three convenience functions and a public class:" msgstr "" # 91b93181fa174e97a0f859e12386948b -#: ../src/Doc/library/timeit.rst:65 +#: library/timeit.rst:65 msgid "" "Create a :class:`Timer` instance with the given statement, *setup* code and " "*timer* function and run its :meth:`.timeit` method with *number* executions." msgstr "" # 6be8d4ffbcec4e11868269775a7f4720 -#: ../src/Doc/library/timeit.rst:73 +#: library/timeit.rst:73 msgid "" "Create a :class:`Timer` instance with the given statement, *setup* code and " "*timer* function and run its :meth:`.repeat` method with the given *repeat* " @@ -107917,7 +110176,7 @@ msgid "" msgstr "" # 2d3672edc58b4ab4a07e528082c6ed33 -#: ../src/Doc/library/timeit.rst:82 +#: library/timeit.rst:82 msgid "" "Define a default timer, in a platform-specific manner. On Windows, :func:" "`time.clock` has microsecond granularity, but :func:`time.time`'s " @@ -107928,12 +110187,12 @@ msgid "" "interfere with the timing." msgstr "" -#: ../src/Doc/library/timeit.rst:93 +#: library/timeit.rst:93 msgid "Class for timing execution speed of small code snippets." msgstr "" # 73d1e35eef244c89be57be1c693867b1 -#: ../src/Doc/library/timeit.rst:95 +#: library/timeit.rst:95 msgid "" "The constructor takes a statement to be timed, an additional statement used " "for setup, and a timer function. Both statements default to ``'pass'``; the " @@ -107943,15 +110202,24 @@ msgid "" msgstr "" # a6065a04fe944a778e34f5abc29f6769 -#: ../src/Doc/library/timeit.rst:101 +#: library/timeit.rst:101 msgid "" "To measure the execution time of the first statement, use the :meth:`." "timeit` method. The :meth:`.repeat` method is a convenience to call :meth:`." "timeit` multiple times and return a list of results." msgstr "" +#: library/timeit.rst:105 +msgid "" +"The *stmt* and *setup* parameters can now also take objects that are " +"callable without arguments. This will embed calls to them in a timer " +"function that will then be executed by :meth:`.timeit`. Note that the " +"timing overhead is a little larger in this case because of the extra " +"function calls." +msgstr "" + # 78c119a968bc4d5db36bcfe8ef7aa16d -#: ../src/Doc/library/timeit.rst:115 +#: library/timeit.rst:115 msgid "" "Time *number* executions of the main statement. This executes the setup " "statement once, and then returns the time it takes to execute the main " @@ -107962,7 +110230,7 @@ msgid "" msgstr "" # fb35b4e940b649b1aa2122f6d1f0de84 -#: ../src/Doc/library/timeit.rst:124 +#: library/timeit.rst:124 msgid "" "By default, :meth:`.timeit` temporarily turns off :term:`garbage collection` " "during the timing. The advantage of this approach is that it makes " @@ -107973,12 +110241,12 @@ msgid "" msgstr "" # 47029537e1d24fc1af1b3c9b560a5a90 -#: ../src/Doc/library/timeit.rst:136 +#: library/timeit.rst:136 msgid "Call :meth:`.timeit` a few times." msgstr "" # e465bda1a89141c484d02faea274ecf2 -#: ../src/Doc/library/timeit.rst:138 +#: library/timeit.rst:138 msgid "" "This is a convenience function that calls the :meth:`.timeit` repeatedly, " "returning a list of results. The first argument specifies how many times to " @@ -107987,7 +110255,7 @@ msgid "" msgstr "" # 586be33784a54eab8c066e5a4d2b197a -#: ../src/Doc/library/timeit.rst:145 +#: library/timeit.rst:145 msgid "" "It's tempting to calculate mean and standard deviation from the result " "vector and report these. However, this is not very useful. In a typical " @@ -107999,16 +110267,16 @@ msgid "" "entire vector and apply common sense rather than statistics." msgstr "" -#: ../src/Doc/library/timeit.rst:158 +#: library/timeit.rst:158 msgid "Helper to print a traceback from the timed code." msgstr "" -#: ../src/Doc/library/timeit.rst:160 +#: library/timeit.rst:160 msgid "Typical use::" msgstr "" # 106e05c541b04b08b206f0df248bd45d -#: ../src/Doc/library/timeit.rst:168 +#: library/timeit.rst:168 msgid "" "The advantage over the standard traceback is that source lines in the " "compiled template will be displayed. The optional *file* argument directs " @@ -108017,50 +110285,50 @@ msgstr "" # 0c4da8ab56a5454387984a0ce388ce20 # e005ebcee41847c5845f3840ac866381 -#: ../src/Doc/library/timeit.rst:176 ../src/Doc/library/unittest.rst:198 +#: library/timeit.rst:176 library/unittest.rst:189 msgid "Command-Line Interface" msgstr "" -#: ../src/Doc/library/timeit.rst:178 +#: library/timeit.rst:178 msgid "" "When called as a program from the command line, the following form is used::" msgstr "" # 5477e41c7b894323bff7fa2c5aa0662d -#: ../src/Doc/library/timeit.rst:182 +#: library/timeit.rst:182 msgid "Where the following options are understood:" msgstr "" -#: ../src/Doc/library/timeit.rst:188 +#: library/timeit.rst:188 msgid "how many times to execute 'statement'" msgstr "" -#: ../src/Doc/library/timeit.rst:192 +#: library/timeit.rst:192 msgid "how many times to repeat the timer (default 3)" msgstr "" # 6c0950aeebf8419397b527ca3081937c -#: ../src/Doc/library/timeit.rst:196 +#: library/timeit.rst:196 msgid "statement to be executed once initially (default ``pass``)" msgstr "" -#: ../src/Doc/library/timeit.rst:200 +#: library/timeit.rst:200 msgid "use :func:`time.time` (default on all platforms but Windows)" msgstr "" -#: ../src/Doc/library/timeit.rst:204 +#: library/timeit.rst:204 msgid "use :func:`time.clock` (default on Windows)" msgstr "" -#: ../src/Doc/library/timeit.rst:208 +#: library/timeit.rst:208 msgid "print raw timing results; repeat for more digits precision" msgstr "" -#: ../src/Doc/library/timeit.rst:212 +#: library/timeit.rst:212 msgid "print a short usage message and exit" msgstr "" -#: ../src/Doc/library/timeit.rst:214 +#: library/timeit.rst:214 msgid "" "A multi-line statement may be given by specifying each line as a separate " "statement argument; indented lines are possible by enclosing an argument in " @@ -108068,14 +110336,14 @@ msgid "" "similarly." msgstr "" -#: ../src/Doc/library/timeit.rst:219 +#: library/timeit.rst:219 msgid "" "If :option:`-n` is not given, a suitable number of loops is calculated by " "trying successive powers of 10 until the total time is at least 0.2 seconds." msgstr "" # 26c44aef40324c9a8164289b756d016b -#: ../src/Doc/library/timeit.rst:222 +#: library/timeit.rst:222 msgid "" ":func:`default_timer` measurations can be affected by other programs running " "on the same machine, so the best thing to do when accurate timing is " @@ -108086,7 +110354,7 @@ msgid "" msgstr "" # e5fc3c64a3a744818a080bf0b97e8fef -#: ../src/Doc/library/timeit.rst:231 +#: library/timeit.rst:231 msgid "" "There is a certain baseline overhead associated with executing a pass " "statement. The code here doesn't try to hide it, but you should be aware of " @@ -108098,19 +110366,19 @@ msgid "" msgstr "" # a0e26da65b394840933e05d5b2d32440 -#: ../src/Doc/library/timeit.rst:244 +#: library/timeit.rst:244 msgid "" "It is possible to provide a setup statement that is executed only once at " "the beginning:" msgstr "" # a6ea1719e03a4dcc8d32a70c1ed9cc16 -#: ../src/Doc/library/timeit.rst:261 +#: library/timeit.rst:261 msgid "The same can be done using the :class:`Timer` class and its methods::" msgstr "" # 2b49c57144a44a72a01cc43c5fc85f71 -#: ../src/Doc/library/timeit.rst:271 +#: library/timeit.rst:271 msgid "" "The following examples show how to time expressions that contain multiple " "lines. Here we compare the cost of using :func:`hasattr` vs. :keyword:`try`/:" @@ -108118,19 +110386,19 @@ msgid "" msgstr "" # 849ca348855440f4a3a21f84c20964bc -#: ../src/Doc/library/timeit.rst:316 +#: library/timeit.rst:316 msgid "" "To give the :mod:`timeit` module access to functions you define, you can " "pass a *setup* parameter which contains an import statement::" msgstr "" # 4579bc82e7a448e9823461b34834b082 -#: ../src/Doc/library/tix.rst:2 +#: library/tix.rst:2 msgid ":mod:`Tix` --- Extension widgets for Tk" msgstr "" # b1745940821f4575b5dea9b5063071e6 -#: ../src/Doc/library/tix.rst:11 +#: library/tix.rst:11 msgid "" "The :mod:`Tix` (Tk Interface Extension) module provides an additional rich " "set of widgets. Although the standard Tk library has many useful widgets, " @@ -108142,7 +110410,7 @@ msgid "" "`FileEntry`, :class:`PanedWindow`, etc; there are more than 40 of them." msgstr "" -#: ../src/Doc/library/tix.rst:20 +#: library/tix.rst:20 msgid "" "With all these new widgets, you can introduce new interaction techniques " "into applications, creating more useful and more intuitive user interfaces. " @@ -108151,70 +110419,62 @@ msgid "" msgstr "" # 541fe97d842844ecad18471a4efae33a -#: ../src/Doc/library/tix.rst:27 +#: library/tix.rst:27 msgid "" ":mod:`Tix` has been renamed to :mod:`tkinter.tix` in Python 3. The :term:" "`2to3` tool will automatically adapt imports when converting your sources to " "Python 3." msgstr "" -# bbdc70c3ea2c4ecd946aeb631bed5c8e -#: ../src/Doc/library/tix.rst:34 -msgid "`Tix Homepage <http://tix.sourceforge.net/>`_" +#: library/tix.rst:35 +msgid "Tix Homepage" msgstr "" -#: ../src/Doc/library/tix.rst:34 +#: library/tix.rst:34 msgid "" "The home page for :mod:`Tix`. This includes links to additional " "documentation and downloads." msgstr "" -# 2a863ade94d14e3bb31ca9e7f8ae1d98 -#: ../src/Doc/library/tix.rst:37 -msgid "`Tix Man Pages <http://tix.sourceforge.net/dist/current/man/>`_" +#: library/tix.rst:38 +msgid "Tix Man Pages" msgstr "" -#: ../src/Doc/library/tix.rst:38 +#: library/tix.rst:38 msgid "On-line version of the man pages and reference material." msgstr "" -# 6362add58e3a47fb829058b80cb9b746 -#: ../src/Doc/library/tix.rst:40 -msgid "" -"`Tix Programming Guide <http://tix.sourceforge.net/dist/current/docs/tix-" -"book/tix.book.html>`_" +#: library/tix.rst:41 +msgid "Tix Programming Guide" msgstr "" -#: ../src/Doc/library/tix.rst:41 +#: library/tix.rst:41 msgid "On-line version of the programmer's reference material." msgstr "" -# c00472a56845405ebbd5319d69043077 -#: ../src/Doc/library/tix.rst:44 -msgid "" -"`Tix Development Applications <http://tix.sourceforge.net/Tixapps/src/Tide." -"html>`_" +#: library/tix.rst:45 +msgid "Tix Development Applications" msgstr "" -#: ../src/Doc/library/tix.rst:44 +#: library/tix.rst:44 msgid "" "Tix applications for development of Tix and Tkinter programs. Tide " "applications work under Tk or Tkinter, and include :program:`TixInspect`, an " "inspector to remotely modify and debug Tix/Tk/Tkinter applications." msgstr "" -#: ../src/Doc/library/tix.rst:50 +#: library/tix.rst:50 msgid "Using Tix" msgstr "" -#: ../src/Doc/library/tix.rst:55 +#: library/tix.rst:55 msgid "" "Toplevel widget of Tix which represents mostly the main window of an " "application. It has an associated Tcl interpreter." msgstr "" # 0da93aacadfc4d77b096b0152ba0a032 -#: ../src/Doc/library/tix.rst:58 +#: library/tix.rst:58 msgid "" "Classes in the :mod:`Tix` module subclasses the classes in the :mod:" "`Tkinter` module. The former imports the latter, so to use :mod:`Tix` with " @@ -108224,7 +110484,7 @@ msgid "" msgstr "" # b7f74cadbced428b9c492a0fdc54f5de -#: ../src/Doc/library/tix.rst:68 +#: library/tix.rst:68 msgid "" "To use :mod:`Tix`, you must have the :mod:`Tix` widgets installed, usually " "alongside your installation of the Tk widgets. To test your installation, " @@ -108232,7 +110492,7 @@ msgid "" msgstr "" # 34f3248753e74077b3e1ed089bfab3f3 -#: ../src/Doc/library/tix.rst:76 +#: library/tix.rst:76 msgid "" "If this fails, you have a Tk installation problem which must be resolved " "before proceeding. Use the environment variable :envvar:`TIX_LIBRARY` to " @@ -108244,12 +110504,12 @@ msgid "" "sensitive), which contains the line::" msgstr "" -#: ../src/Doc/library/tix.rst:89 +#: library/tix.rst:89 msgid "Tix Widgets" msgstr "" # 14d1a9e072ec43edb9ed3a7cf9c1bb22 -#: ../src/Doc/library/tix.rst:91 +#: library/tix.rst:91 msgid "" "`Tix <http://tix.sourceforge.net/dist/current/man/html/TixCmd/TixIntro." "htm>`_ introduces over 40 widget classes to the :mod:`Tkinter` repertoire. " @@ -108257,11 +110517,11 @@ msgid "" "directory of the standard distribution." msgstr "" -#: ../src/Doc/library/tix.rst:100 +#: library/tix.rst:100 msgid "Basic Widgets" msgstr "" -#: ../src/Doc/library/tix.rst:105 +#: library/tix.rst:105 msgid "" "A `Balloon <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixBalloon.htm>`_ that pops up over a widget to provide help. When the user " @@ -108269,14 +110529,14 @@ msgid "" "small pop-up window with a descriptive message will be shown on the screen." msgstr "" -#: ../src/Doc/library/tix.rst:117 +#: library/tix.rst:117 msgid "" "The `ButtonBox <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixButtonBox.htm>`_ widget creates a box of buttons, such as is commonly " "used for ``Ok Cancel``." msgstr "" -#: ../src/Doc/library/tix.rst:127 +#: library/tix.rst:127 msgid "" "The `ComboBox <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixComboBox.htm>`_ widget is similar to the combo box control in MS Windows. " @@ -108284,7 +110544,7 @@ msgid "" "selecting from the listbox subwidget." msgstr "" -#: ../src/Doc/library/tix.rst:139 +#: library/tix.rst:139 msgid "" "The `Control <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixControl.htm>`_ widget is also known as the :class:`SpinBox` widget. The " @@ -108293,7 +110553,7 @@ msgid "" "user-defined upper and lower limits." msgstr "" -#: ../src/Doc/library/tix.rst:152 +#: library/tix.rst:152 msgid "" "The `LabelEntry <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixLabelEntry.htm>`_ widget packages an entry widget and a label into one " @@ -108301,7 +110561,7 @@ msgid "" "\" type of interface." msgstr "" -#: ../src/Doc/library/tix.rst:163 +#: library/tix.rst:163 msgid "" "The `LabelFrame <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixLabelFrame.htm>`_ widget packages a frame widget and a label into one " @@ -108310,20 +110570,20 @@ msgid "" "the :attr:`frame` subwidget." msgstr "" -#: ../src/Doc/library/tix.rst:175 +#: library/tix.rst:175 msgid "" "The `Meter <http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixMeter." "htm>`_ widget can be used to show the progress of a background job which may " "take a long time to execute." msgstr "" -#: ../src/Doc/library/tix.rst:186 +#: library/tix.rst:186 msgid "" "The `OptionMenu <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixOptionMenu.htm>`_ creates a menu button of options." msgstr "" -#: ../src/Doc/library/tix.rst:196 +#: library/tix.rst:196 msgid "" "The `PopupMenu <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixPopupMenu.htm>`_ widget can be used as a replacement of the ``tk_popup`` " @@ -108331,25 +110591,25 @@ msgid "" "requires less application code to manipulate." msgstr "" -#: ../src/Doc/library/tix.rst:208 +#: library/tix.rst:208 msgid "" "The `Select <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixSelect.htm>`_ widget is a container of button subwidgets. It can be used " "to provide radio-box or check-box style of selection options for the user." msgstr "" -#: ../src/Doc/library/tix.rst:219 +#: library/tix.rst:219 msgid "" "The `StdButtonBox <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixStdButtonBox.htm>`_ widget is a group of standard buttons for Motif-like " "dialog boxes." msgstr "" -#: ../src/Doc/library/tix.rst:228 +#: library/tix.rst:228 msgid "File Selectors" msgstr "" -#: ../src/Doc/library/tix.rst:233 +#: library/tix.rst:233 msgid "" "The `DirList <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixDirList.htm>`_ widget displays a list view of a directory, its previous " @@ -108357,7 +110617,7 @@ msgid "" "directories displayed in the list or change to another directory." msgstr "" -#: ../src/Doc/library/tix.rst:245 +#: library/tix.rst:245 msgid "" "The `DirTree <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixDirTree.htm>`_ widget displays a tree view of a directory, its previous " @@ -108365,7 +110625,7 @@ msgid "" "directories displayed in the list or change to another directory." msgstr "" -#: ../src/Doc/library/tix.rst:257 +#: library/tix.rst:257 msgid "" "The `DirSelectDialog <http://tix.sourceforge.net/dist/current/man/html/" "TixCmd/tixDirSelectDialog.htm>`_ widget presents the directories in the file " @@ -108373,7 +110633,7 @@ msgid "" "through the file system to select the desired directory." msgstr "" -#: ../src/Doc/library/tix.rst:269 +#: library/tix.rst:269 msgid "" "The :class:`DirSelectBox` is similar to the standard Motif(TM) directory-" "selection box. It is generally used for the user to choose a directory. " @@ -108381,7 +110641,7 @@ msgid "" "widget so that they can be quickly selected again." msgstr "" -#: ../src/Doc/library/tix.rst:277 +#: library/tix.rst:277 msgid "" "The `ExFileSelectBox <http://tix.sourceforge.net/dist/current/man/html/" "TixCmd/tixExFileSelectBox.htm>`_ widget is usually embedded in a " @@ -108390,7 +110650,7 @@ msgid "" "similar to the standard file dialog on MS Windows 3.1." msgstr "" -#: ../src/Doc/library/tix.rst:290 +#: library/tix.rst:290 msgid "" "The `FileSelectBox <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixFileSelectBox.htm>`_ is similar to the standard Motif(TM) file-selection " @@ -108399,7 +110659,7 @@ msgid "" "that they can be quickly selected again." msgstr "" -#: ../src/Doc/library/tix.rst:303 +#: library/tix.rst:303 msgid "" "The `FileEntry <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixFileEntry.htm>`_ widget can be used to input a filename. The user can " @@ -108408,11 +110668,11 @@ msgid "" "dialog." msgstr "" -#: ../src/Doc/library/tix.rst:314 +#: library/tix.rst:314 msgid "Hierarchical ListBox" msgstr "" -#: ../src/Doc/library/tix.rst:319 +#: library/tix.rst:319 msgid "" "The `HList <http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixHList." "htm>`_ widget can be used to display any data that have a hierarchical " @@ -108421,7 +110681,7 @@ msgid "" "hierarchy." msgstr "" -#: ../src/Doc/library/tix.rst:331 +#: library/tix.rst:331 msgid "" "The `CheckList <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixCheckList.htm>`_ widget displays a list of items to be selected by the " @@ -108430,18 +110690,18 @@ msgid "" "radiobuttons." msgstr "" -#: ../src/Doc/library/tix.rst:347 +#: library/tix.rst:347 msgid "" "The `Tree <http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixTree." "htm>`_ widget can be used to display hierarchical data in a tree form. The " "user can adjust the view of the tree by opening or closing parts of the tree." msgstr "" -#: ../src/Doc/library/tix.rst:359 +#: library/tix.rst:359 msgid "Tabular ListBox" msgstr "" -#: ../src/Doc/library/tix.rst:364 +#: library/tix.rst:364 msgid "" "The `TList <http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixTList." "htm>`_ widget can be used to display data in a tabular format. The list " @@ -108451,11 +110711,11 @@ msgid "" "graphical images as well as multiple colors and fonts for the list entries." msgstr "" -#: ../src/Doc/library/tix.rst:387 +#: library/tix.rst:387 msgid "Manager Widgets" msgstr "" -#: ../src/Doc/library/tix.rst:392 +#: library/tix.rst:392 msgid "" "The `PanedWindow <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixPanedWindow.htm>`_ widget allows the user to interactively manipulate the " @@ -108464,7 +110724,7 @@ msgid "" "resize handle between two panes." msgstr "" -#: ../src/Doc/library/tix.rst:404 +#: library/tix.rst:404 msgid "" "The `ListNoteBook <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixListNoteBook.htm>`_ widget is very similar to the :class:`TixNoteBook` " @@ -108475,7 +110735,7 @@ msgid "" "`hlist` subwidget." msgstr "" -#: ../src/Doc/library/tix.rst:418 +#: library/tix.rst:418 msgid "" "The `NoteBook <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixNoteBook.htm>`_ widget can be used to display many windows in a limited " @@ -108485,24 +110745,24 @@ msgid "" "the NoteBook widget." msgstr "" -#: ../src/Doc/library/tix.rst:440 +#: library/tix.rst:440 msgid "Image Types" msgstr "" # d033dd932abd4ce19c5d984d7be98667 -#: ../src/Doc/library/tix.rst:442 +#: library/tix.rst:442 msgid "The :mod:`Tix` module adds:" msgstr "" # cc8a708c64f649d5b50374208a7fbc14 -#: ../src/Doc/library/tix.rst:444 +#: library/tix.rst:444 msgid "" "`pixmap <http://tix.sourceforge.net/dist/current/man/html/TixCmd/pixmap." "htm>`_ capabilities to all :mod:`Tix` and :mod:`Tkinter` widgets to create " "color images from XPM files." msgstr "" -#: ../src/Doc/library/tix.rst:453 +#: library/tix.rst:453 msgid "" "`Compound <http://tix.sourceforge.net/dist/current/man/html/TixCmd/compound." "htm>`_ image types can be used to create images that consists of multiple " @@ -108512,37 +110772,37 @@ msgid "" "simultaneously in a Tk :class:`Button` widget." msgstr "" -#: ../src/Doc/library/tix.rst:472 +#: library/tix.rst:472 msgid "Miscellaneous Widgets" msgstr "" -#: ../src/Doc/library/tix.rst:477 +#: library/tix.rst:477 msgid "" "The `InputOnly <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tixInputOnly.htm>`_ widgets are to accept inputs from the user, which can be " "done with the ``bind`` command (Unix only)." msgstr "" -#: ../src/Doc/library/tix.rst:484 +#: library/tix.rst:484 msgid "Form Geometry Manager" msgstr "" # ae519898c109469783181427ad54b74a -#: ../src/Doc/library/tix.rst:486 +#: library/tix.rst:486 msgid "In addition, :mod:`Tix` augments :mod:`Tkinter` by providing:" msgstr "" -#: ../src/Doc/library/tix.rst:491 +#: library/tix.rst:491 msgid "" "The `Form <http://tix.sourceforge.net/dist/current/man/html/TixCmd/tixForm." "htm>`_ geometry manager based on attachment rules for all Tk widgets." msgstr "" -#: ../src/Doc/library/tix.rst:498 +#: library/tix.rst:498 msgid "Tix Commands" msgstr "" -#: ../src/Doc/library/tix.rst:503 +#: library/tix.rst:503 msgid "" "The `tix commands <http://tix.sourceforge.net/dist/current/man/html/TixCmd/" "tix.htm>`_ provide access to miscellaneous elements of :mod:`Tix`'s internal " @@ -108551,11 +110811,11 @@ msgid "" "screen or display, rather than to a particular window." msgstr "" -#: ../src/Doc/library/tix.rst:510 +#: library/tix.rst:510 msgid "To view the current settings, the common usage is::" msgstr "" -#: ../src/Doc/library/tix.rst:519 +#: library/tix.rst:519 msgid "" "Query or modify the configuration options of the Tix application context. If " "no option is specified, returns a dictionary all of the available options. " @@ -108567,13 +110827,13 @@ msgid "" "an empty string. Option may be any of the configuration options." msgstr "" -#: ../src/Doc/library/tix.rst:531 +#: library/tix.rst:531 msgid "" "Returns the current value of the configuration option given by *option*. " "Option may be any of the configuration options." msgstr "" -#: ../src/Doc/library/tix.rst:537 +#: library/tix.rst:537 msgid "" "Locates a bitmap file of the name ``name.xpm`` or ``name`` in one of the " "bitmap directories (see the :meth:`tix_addbitmapdir` method). By using :" @@ -108583,7 +110843,7 @@ msgid "" "can be used to configure the ``bitmap`` option of the Tk and Tix widgets." msgstr "" -#: ../src/Doc/library/tix.rst:547 +#: library/tix.rst:547 msgid "" "Tix maintains a list of directories under which the :meth:`tix_getimage` " "and :meth:`tix_getbitmap` methods will search for image files. The standard " @@ -108593,7 +110853,7 @@ msgid "" "meth:`tix_getimage` or :meth:`tix_getbitmap` method." msgstr "" -#: ../src/Doc/library/tix.rst:557 +#: library/tix.rst:557 msgid "" "Returns the file selection dialog that may be shared among different calls " "from this application. This method will create a file selection dialog " @@ -108604,7 +110864,7 @@ msgid "" "``tixExFileSelectDialog``." msgstr "" -#: ../src/Doc/library/tix.rst:567 +#: library/tix.rst:567 msgid "" "Locates an image file of the name :file:`name.xpm`, :file:`name.xbm` or :" "file:`name.ppm` in one of the bitmap directories (see the :meth:" @@ -108618,11 +110878,11 @@ msgid "" "and Tix widgets." msgstr "" -#: ../src/Doc/library/tix.rst:580 +#: library/tix.rst:580 msgid "Gets the options maintained by the Tix scheme mechanism." msgstr "" -#: ../src/Doc/library/tix.rst:585 +#: library/tix.rst:585 msgid "" "Resets the scheme and fontset of the Tix application to *newScheme* and " "*newFontSet*, respectively. This affects only those widgets created after " @@ -108630,13 +110890,13 @@ msgid "" "creation of any widgets in a Tix application." msgstr "" -#: ../src/Doc/library/tix.rst:590 +#: library/tix.rst:590 msgid "" "The optional parameter *newScmPrio* can be given to reset the priority level " "of the Tk options set by the Tix schemes." msgstr "" -#: ../src/Doc/library/tix.rst:593 +#: library/tix.rst:593 msgid "" "Because of the way Tk handles the X option database, after Tix has been has " "imported and inited, it is not possible to reset the color schemes and font " @@ -108644,12 +110904,12 @@ msgid "" "`tix_resetoptions` method must be used." msgstr "" -#: ../src/Doc/library/tk.rst:5 +#: library/tk.rst:5 msgid "Graphical User Interfaces with Tk" msgstr "" # 8893ff4f0470474ab8f2060beea660b8 -#: ../src/Doc/library/tk.rst:13 +#: library/tk.rst:13 msgid "" "Tk/Tcl has long been an integral part of Python. It provides a robust and " "platform independent windowing toolkit, that is available to Python " @@ -108658,7 +110918,7 @@ msgid "" msgstr "" # f050b87f23ad422f83684988ad23ad8d -#: ../src/Doc/library/tk.rst:18 +#: library/tk.rst:18 msgid "" "The :mod:`Tkinter` module is a thin object-oriented layer on top of Tcl/Tk. " "To use :mod:`Tkinter`, you don't need to write Tcl code, but you will need " @@ -108669,7 +110929,7 @@ msgid "" msgstr "" # b494b7a3022945dfb32b006f1a04ebed -#: ../src/Doc/library/tk.rst:25 +#: library/tk.rst:25 msgid "" ":mod:`Tkinter`'s chief virtues are that it is fast, and that it usually " "comes bundled with Python. Although its standard documentation is weak, good " @@ -108681,12 +110941,12 @@ msgid "" msgstr "" # bb7f89600979425da44259b74ac601dc -#: ../src/Doc/library/tkinter.rst:2 +#: library/tkinter.rst:2 msgid ":mod:`Tkinter` --- Python interface to Tcl/Tk" msgstr "" # 020daedcd53444a99df171c9069ca7c0 -#: ../src/Doc/library/tkinter.rst:9 +#: library/tkinter.rst:9 msgid "" "The :mod:`Tkinter` module (\"Tk interface\") is the standard Python " "interface to the Tk GUI toolkit. Both Tk and :mod:`Tkinter` are available " @@ -108695,109 +110955,93 @@ msgid "" msgstr "" # 37e7f43292984c7fa97f90b62ca7e008 -#: ../src/Doc/library/tkinter.rst:16 +#: library/tkinter.rst:16 msgid "" ":mod:`Tkinter` has been renamed to :mod:`tkinter` in Python 3. The :term:" "`2to3` tool will automatically adapt imports when converting your sources to " "Python 3." msgstr "" -# 83cff378a7e74abf919b83031eb6aaa7 -#: ../src/Doc/library/tkinter.rst:23 -msgid "`Python Tkinter Resources <https://wiki.python.org/moin/TkInter>`_" +#: library/tkinter.rst:24 +msgid "Python Tkinter Resources" msgstr "" -#: ../src/Doc/library/tkinter.rst:23 +#: library/tkinter.rst:23 msgid "" "The Python Tkinter Topic Guide provides a great deal of information on using " "Tk from Python and links to other sources of information on Tk." msgstr "" -# 8613792d6a9a4e388a03beed326bebe8 -#: ../src/Doc/library/tkinter.rst:26 -msgid "`TKDocs <http://www.tkdocs.com/>`_" +#: library/tkinter.rst:27 +msgid "TKDocs" msgstr "" # b2c92c4818254b21a9bc0e5875603f75 -#: ../src/Doc/library/tkinter.rst:27 +#: library/tkinter.rst:27 msgid "" "Extensive tutorial plus friendlier widget pages for some of the widgets." msgstr "" -# ce86390e6b394e0792b3cb84c76dcb33 -#: ../src/Doc/library/tkinter.rst:29 -msgid "" -"`Tkinter reference: a GUI for Python <http://infohost.nmt.edu/tcc/help/pubs/" -"tkinter/web/index.html>`_" +#: library/tkinter.rst:30 +msgid "Tkinter reference: a GUI for Python" msgstr "" -#: ../src/Doc/library/tkinter.rst:30 +#: library/tkinter.rst:30 msgid "On-line reference material." msgstr "" -# 94bf451f1af946c6a12f9b58babb0bb3 -#: ../src/Doc/library/tkinter.rst:32 -msgid "`Tkinter docs from effbot <http://effbot.org/tkinterbook/>`_" +#: library/tkinter.rst:33 +msgid "Tkinter docs from effbot" msgstr "" # 6498a2e1abcc4fe5b415512ba8e0cc2d -#: ../src/Doc/library/tkinter.rst:33 +#: library/tkinter.rst:33 msgid "Online reference for tkinter supported by effbot.org." msgstr "" -# 54d9b0c19270463092eedf282dbd87db -#: ../src/Doc/library/tkinter.rst:35 -msgid "`Tcl/Tk manual <http://www.tcl.tk/man/tcl8.5/>`_" +#: library/tkinter.rst:36 +msgid "Tcl/Tk manual" msgstr "" # a36901da97724033bf9e43e533fff3d8 -#: ../src/Doc/library/tkinter.rst:36 +#: library/tkinter.rst:36 msgid "Official manual for the latest tcl/tk version." msgstr "" -# e007307d98ba496eb037f6bb90af5c0b -#: ../src/Doc/library/tkinter.rst:38 -msgid "" -"`Programming Python <http://www.amazon.com/Programming-Python-Mark-Lutz/" -"dp/0596158106/>`_" +#: library/tkinter.rst:39 +msgid "Programming Python" msgstr "" # a5080f3eb6cb405f89e0614a85271546 -#: ../src/Doc/library/tkinter.rst:39 +#: library/tkinter.rst:39 msgid "Book by Mark Lutz, has excellent coverage of Tkinter." msgstr "" -# b0199e34b78949f89648791d46ab3cfd -#: ../src/Doc/library/tkinter.rst:41 -msgid "" -"`Modern Tkinter for Busy Python Developers <http://www.amazon.com/Modern-" -"Tkinter-Python-Developers-ebook/dp/B0071QDNLO/>`_" +#: library/tkinter.rst:42 +msgid "Modern Tkinter for Busy Python Developers" msgstr "" # 54c5b40c20dc42ffad5053d8f6abae55 -#: ../src/Doc/library/tkinter.rst:42 +#: library/tkinter.rst:42 msgid "" "Book by Mark Rozerman about building attractive and modern graphical user " "interfaces with Python and Tkinter." msgstr "" -# 898259ff76524b43a81089f313ac3cb8 -#: ../src/Doc/library/tkinter.rst:43 -msgid "" -"`Python and Tkinter Programming <http://www.amazon.com/exec/obidos/" -"ASIN/1884777813>`_" +#: library/tkinter.rst:44 +msgid "Python and Tkinter Programming" msgstr "" -#: ../src/Doc/library/tkinter.rst:45 +#: library/tkinter.rst:45 msgid "The book by John Grayson (ISBN 1-884777-81-3)." msgstr "" -#: ../src/Doc/library/tkinter.rst:49 +#: library/tkinter.rst:49 msgid "Tkinter Modules" msgstr "" # f21c61dc60de4657aa3dde539573bfad -#: ../src/Doc/library/tkinter.rst:51 +#: library/tkinter.rst:51 msgid "" "Most of the time, the :mod:`Tkinter` module is all you really need, but a " "number of additional modules are available as well. The Tk interface is " @@ -108808,7 +111052,7 @@ msgid "" msgstr "" # 82cc9dbb6c3a456198df8ea4e6e1bc01 -#: ../src/Doc/library/tkinter.rst:58 +#: library/tkinter.rst:58 msgid "" "In addition to the Tk interface module, :mod:`Tkinter` includes a number of " "Python modules. The two most important modules are the :mod:`Tkinter` module " @@ -108817,18 +111061,22 @@ msgid "" "module::" msgstr "" -#: ../src/Doc/library/tkinter.rst:65 +#: library/tkinter.rst:65 msgid "Or, more often::" msgstr "" -#: ../src/Doc/library/tkinter.rst:72 +#: library/tkinter.rst:72 msgid "" "The :class:`Tk` class is instantiated without arguments. This creates a " "toplevel widget of Tk which usually is the main window of an application. " "Each instance has its own associated Tcl interpreter." msgstr "" -#: ../src/Doc/library/tkinter.rst:84 +#: library/tkinter.rst:78 +msgid "The *useTk* parameter was added." +msgstr "" + +#: library/tkinter.rst:84 msgid "" "The :func:`Tcl` function is a factory function which creates an object much " "like that created by the :class:`Tk` class, except that it does not " @@ -108840,153 +111088,144 @@ msgid "" "`loadtk` method." msgstr "" -#: ../src/Doc/library/tkinter.rst:94 +#: library/tkinter.rst:94 msgid "Other modules that provide Tk support include:" msgstr "" -# 89b7e95f05104546a2cc409b78325a51 -#: ../src/Doc/library/tkinter.rst:96 -msgid ":mod:`ScrolledText`" +#: library/tkinter.rst:97 +msgid "ScrolledText" msgstr "" -#: ../src/Doc/library/tkinter.rst:97 +#: library/tkinter.rst:97 msgid "Text widget with a vertical scroll bar built in." msgstr "" -# e5cea778e4db4dac977890193a213fe4 -#: ../src/Doc/library/tkinter.rst:99 -msgid ":mod:`tkColorChooser`" +#: library/tkinter.rst:100 +msgid "tkColorChooser" msgstr "" -#: ../src/Doc/library/tkinter.rst:100 +#: library/tkinter.rst:100 msgid "Dialog to let the user choose a color." msgstr "" -# aded045407b045cb9866bfd235482b02 -#: ../src/Doc/library/tkinter.rst:102 -msgid ":mod:`tkCommonDialog`" +#: library/tkinter.rst:103 +msgid "tkCommonDialog" msgstr "" -#: ../src/Doc/library/tkinter.rst:103 +#: library/tkinter.rst:103 msgid "Base class for the dialogs defined in the other modules listed here." msgstr "" -# ccea4177e43f4fcc8602b675ba3dae0a -#: ../src/Doc/library/tkinter.rst:105 -msgid ":mod:`tkFileDialog`" +#: library/tkinter.rst:106 +msgid "tkFileDialog" msgstr "" -#: ../src/Doc/library/tkinter.rst:106 +#: library/tkinter.rst:106 msgid "Common dialogs to allow the user to specify a file to open or save." msgstr "" -# c5dfe379b56d452899cb61477f92a7db -#: ../src/Doc/library/tkinter.rst:108 -msgid ":mod:`tkFont`" +#: library/tkinter.rst:109 +msgid "tkFont" msgstr "" -#: ../src/Doc/library/tkinter.rst:109 +#: library/tkinter.rst:109 msgid "Utilities to help work with fonts." msgstr "" -# 9dd2fc94390242dfbac9f5ef97637ba1 -#: ../src/Doc/library/tkinter.rst:111 -msgid ":mod:`tkMessageBox`" +#: library/tkinter.rst:112 +msgid "tkMessageBox" msgstr "" -#: ../src/Doc/library/tkinter.rst:112 +#: library/tkinter.rst:112 msgid "Access to standard Tk dialog boxes." msgstr "" -# f220f7ab80994bfaa1a578957cab60d5 -#: ../src/Doc/library/tkinter.rst:114 -msgid ":mod:`tkSimpleDialog`" +#: library/tkinter.rst:115 +msgid "tkSimpleDialog" msgstr "" -#: ../src/Doc/library/tkinter.rst:115 +#: library/tkinter.rst:115 msgid "Basic dialogs and convenience functions." msgstr "" -# 23ecdf15f5554fa4b66104c87bfd71ab -#: ../src/Doc/library/tkinter.rst:118 -msgid ":mod:`Tkdnd`" +#: library/tkinter.rst:119 +msgid "Tkdnd" msgstr "" # f67209df243244d58e676e27ab16eec3 -#: ../src/Doc/library/tkinter.rst:118 +#: library/tkinter.rst:118 msgid "" "Drag-and-drop support for :mod:`Tkinter`. This is experimental and should " "become deprecated when it is replaced with the Tk DND." msgstr "" -# 508bc0987439425caf2db16594f9a396 -#: ../src/Doc/library/tkinter.rst:121 -msgid ":mod:`turtle`" +#: library/tkinter.rst:122 +msgid "turtle" msgstr "" -#: ../src/Doc/library/tkinter.rst:122 +#: library/tkinter.rst:122 msgid "Turtle graphics in a Tk window." msgstr "" # 247c7e3e066845b78bcd8e52b0c623b7 -#: ../src/Doc/library/tkinter.rst:124 +#: library/tkinter.rst:124 msgid "" "These have been renamed as well in Python 3; they were all made submodules " "of the new ``tkinter`` package." msgstr "" -#: ../src/Doc/library/tkinter.rst:129 +#: library/tkinter.rst:129 msgid "Tkinter Life Preserver" msgstr "" -#: ../src/Doc/library/tkinter.rst:134 +#: library/tkinter.rst:134 msgid "" "This section is not designed to be an exhaustive tutorial on either Tk or " "Tkinter. Rather, it is intended as a stop gap, providing some introductory " "orientation on the system." msgstr "" -#: ../src/Doc/library/tkinter.rst:138 +#: library/tkinter.rst:138 msgid "Credits:" msgstr "" -#: ../src/Doc/library/tkinter.rst:140 +#: library/tkinter.rst:140 msgid "Tkinter was written by Steen Lumholt and Guido van Rossum." msgstr "" -#: ../src/Doc/library/tkinter.rst:142 +#: library/tkinter.rst:142 msgid "Tk was written by John Ousterhout while at Berkeley." msgstr "" -#: ../src/Doc/library/tkinter.rst:144 +#: library/tkinter.rst:144 msgid "" "This Life Preserver was written by Matt Conway at the University of Virginia." msgstr "" # d192f138212446128e5ed2d3f9692ce7 -#: ../src/Doc/library/tkinter.rst:146 +#: library/tkinter.rst:146 msgid "" "The html rendering, and some liberal editing, was produced from a FrameMaker " "version by Ken Manheimer." msgstr "" -#: ../src/Doc/library/tkinter.rst:149 +#: library/tkinter.rst:149 msgid "" "Fredrik Lundh elaborated and revised the class interface descriptions, to " "get them current with Tk 4.2." msgstr "" -#: ../src/Doc/library/tkinter.rst:152 +#: library/tkinter.rst:152 msgid "" "Mike Clarkson converted the documentation to LaTeX, and compiled the User " "Interface chapter of the reference manual." msgstr "" -#: ../src/Doc/library/tkinter.rst:157 +#: library/tkinter.rst:157 msgid "How To Use This Section" msgstr "" -#: ../src/Doc/library/tkinter.rst:159 +#: library/tkinter.rst:159 msgid "" "This section is designed in two parts: the first half (roughly) covers " "background material, while the second half can be taken to the keyboard as a " @@ -108994,7 +111233,7 @@ msgid "" msgstr "" # 4d84aa369e3741f8ac08f09d3b37e795 -#: ../src/Doc/library/tkinter.rst:163 +#: library/tkinter.rst:163 msgid "" "When trying to answer questions of the form \"how do I do blah\", it is " "often best to find out how to do\"blah\" in straight Tk, and then convert " @@ -109007,7 +111246,7 @@ msgid "" msgstr "" # 9645ce3979bc4b59acc809eb4589a518 -#: ../src/Doc/library/tkinter.rst:171 +#: library/tkinter.rst:171 msgid "" "The authors strongly suggest getting a copy of the Tk man pages. " "Specifically, the man pages in the ``mann`` directory are most useful. The " @@ -109015,7 +111254,7 @@ msgid "" "not especially helpful for script writers." msgstr "" -#: ../src/Doc/library/tkinter.rst:176 +#: library/tkinter.rst:176 msgid "" "Addison-Wesley publishes a book called Tcl and the Tk Toolkit by John " "Ousterhout (ISBN 0-201-63337-X) which is a good introduction to Tcl and Tk " @@ -109024,72 +111263,66 @@ msgid "" msgstr "" # 750ea27a53be411fa7993efb1ac91e24 -#: ../src/Doc/library/tkinter.rst:181 +#: library/tkinter.rst:181 msgid "" ":file:`Tkinter.py` is a last resort for most, but can be a good place to go " "when nothing else makes sense." msgstr "" -# 9894e368f16045758f4c9265cff692dd -#: ../src/Doc/library/tkinter.rst:187 -msgid "`ActiveState Tcl Home Page <http://tcl.activestate.com/>`_" +#: library/tkinter.rst:188 +msgid "ActiveState Tcl Home Page" msgstr "" -#: ../src/Doc/library/tkinter.rst:188 +#: library/tkinter.rst:188 msgid "The Tk/Tcl development is largely taking place at ActiveState." msgstr "" -# 3b2ca9b9677a4f88870275282a065ae3 -#: ../src/Doc/library/tkinter.rst:190 -msgid "" -"`Tcl and the Tk Toolkit <http://www.amazon.com/exec/obidos/ASIN/020163337X>`_" +#: library/tkinter.rst:191 +msgid "Tcl and the Tk Toolkit" msgstr "" # d1860e1aae884d26bc4cb86430856036 -#: ../src/Doc/library/tkinter.rst:191 +#: library/tkinter.rst:191 msgid "The book by John Ousterhout, the inventor of Tcl." msgstr "" -# 042c657e702d48fa9fa6074533763b72 -#: ../src/Doc/library/tkinter.rst:192 -msgid "" -"`Practical Programming in Tcl and Tk <http://www.amazon.com/exec/obidos/" -"ASIN/0130220280>`_" +#: library/tkinter.rst:193 +msgid "Practical Programming in Tcl and Tk" msgstr "" -#: ../src/Doc/library/tkinter.rst:194 +#: library/tkinter.rst:194 msgid "Brent Welch's encyclopedic book." msgstr "" -#: ../src/Doc/library/tkinter.rst:198 +#: library/tkinter.rst:198 msgid "A Simple Hello World Program" msgstr "" -#: ../src/Doc/library/tkinter.rst:234 +#: library/tkinter.rst:234 msgid "A (Very) Quick Look at Tcl/Tk" msgstr "" -#: ../src/Doc/library/tkinter.rst:236 +#: library/tkinter.rst:236 msgid "" "The class hierarchy looks complicated, but in actual practice, application " "programmers almost always refer to the classes at the very bottom of the " "hierarchy." msgstr "" -#: ../src/Doc/library/tkinter.rst:242 +#: library/tkinter.rst:242 msgid "" "These classes are provided for the purposes of organizing certain functions " "under one namespace. They aren't meant to be instantiated independently." msgstr "" -#: ../src/Doc/library/tkinter.rst:245 +#: library/tkinter.rst:245 msgid "" "The :class:`Tk` class is meant to be instantiated only once in an " "application. Application programmers need not instantiate one explicitly, " "the system creates one whenever any of the other classes are instantiated." msgstr "" -#: ../src/Doc/library/tkinter.rst:249 +#: library/tkinter.rst:249 msgid "" "The :class:`Widget` class is not meant to be instantiated, it is meant only " "for subclassing to make \"real\" widgets (in C++, this is called an " @@ -109097,7 +111330,7 @@ msgid "" msgstr "" # aba39028623240c0b69001e3e410bd67 -#: ../src/Doc/library/tkinter.rst:253 +#: library/tkinter.rst:253 msgid "" "To make use of this reference material, there will be times when you will " "need to know how to read short passages of Tk and how to identify the " @@ -109105,7 +111338,7 @@ msgid "" "for the :mod:`Tkinter` equivalents of what's below.)" msgstr "" -#: ../src/Doc/library/tkinter.rst:258 +#: library/tkinter.rst:258 msgid "" "Tk scripts are Tcl programs. Like all Tcl programs, Tk scripts are just " "lists of tokens separated by spaces. A Tk widget is just its *class*, the " @@ -109113,25 +111346,23 @@ msgid "" "things." msgstr "" -#: ../src/Doc/library/tkinter.rst:262 +#: library/tkinter.rst:262 msgid "To make a widget in Tk, the command is always of the form::" msgstr "" -# 95569927409f43c8ace61b942ecb90bd -#: ../src/Doc/library/tkinter.rst:266 -msgid "*classCommand*" +#: library/tkinter.rst:267 +msgid "classCommand" msgstr "" -#: ../src/Doc/library/tkinter.rst:267 +#: library/tkinter.rst:267 msgid "denotes which kind of widget to make (a button, a label, a menu...)" msgstr "" -# 16b1227acaa34bb1b6f803c5b231f07f -#: ../src/Doc/library/tkinter.rst:273 -msgid "*newPathname*" +#: library/tkinter.rst:274 +msgid "newPathname" msgstr "" -#: ../src/Doc/library/tkinter.rst:270 +#: library/tkinter.rst:270 msgid "" "is the new name for this widget. All names in Tk must be unique. To help " "enforce this, widgets in Tk are named with *pathnames*, just like files in a " @@ -109140,12 +111371,7 @@ msgid "" "okButton`` might be the name of a widget." msgstr "" -# 44573c5d07ca4b409899d66ef06775f5 -#: ../src/Doc/library/tkinter.rst:279 -msgid "*options*" -msgstr "*options*" - -#: ../src/Doc/library/tkinter.rst:277 +#: library/tkinter.rst:277 msgid "" "configure the widget's appearance and in some cases, its behavior. The " "options come in the form of a list of flags and values. Flags are preceded " @@ -109153,7 +111379,7 @@ msgid "" "they are more than one word." msgstr "" -#: ../src/Doc/library/tkinter.rst:290 +#: library/tkinter.rst:290 msgid "" "Once created, the pathname to the widget becomes a new command. This new " "*widget command* is the programmer's handle for getting the new widget to " @@ -109162,11 +111388,11 @@ msgid "" "someAction(someOptions), and in Tk, you say::" msgstr "" -#: ../src/Doc/library/tkinter.rst:298 +#: library/tkinter.rst:298 msgid "Note that the object name, ``.fred``, starts with a dot." msgstr "" -#: ../src/Doc/library/tkinter.rst:300 +#: library/tkinter.rst:300 msgid "" "As you'd expect, the legal values for *someAction* will depend on the " "widget's class: ``.fred disable`` works if fred is a button (fred gets " @@ -109174,7 +111400,7 @@ msgid "" "not supported in Tk)." msgstr "" -#: ../src/Doc/library/tkinter.rst:304 +#: library/tkinter.rst:304 msgid "" "The legal values of *someOptions* is action dependent. Some actions, like " "``disable``, require no arguments, others, like a text-entry box's " @@ -109182,21 +111408,21 @@ msgid "" "delete." msgstr "" -#: ../src/Doc/library/tkinter.rst:312 +#: library/tkinter.rst:312 msgid "Mapping Basic Tk into Tkinter" msgstr "" -#: ../src/Doc/library/tkinter.rst:314 +#: library/tkinter.rst:314 msgid "Class commands in Tk correspond to class constructors in Tkinter. ::" msgstr "" -#: ../src/Doc/library/tkinter.rst:318 +#: library/tkinter.rst:318 msgid "" "The master of an object is implicit in the new name given to it at creation " "time. In Tkinter, masters are specified explicitly. ::" msgstr "" -#: ../src/Doc/library/tkinter.rst:323 +#: library/tkinter.rst:323 msgid "" "The configuration options in Tk are given in lists of hyphened tags followed " "by values. In Tkinter, options are specified as keyword-arguments in the " @@ -109206,7 +111432,7 @@ msgid "" msgstr "" # 04a80a1e6cdf405985a352776b5cae48 -#: ../src/Doc/library/tkinter.rst:333 +#: library/tkinter.rst:333 msgid "" "In Tk, to perform an action on a widget, use the widget name as a command, " "and follow it with an action name, possibly with arguments (options). In " @@ -109216,7 +111442,7 @@ msgid "" msgstr "" # f3ffaab218df4602ae1ebbb4dfee023c -#: ../src/Doc/library/tkinter.rst:341 +#: library/tkinter.rst:341 msgid "" "To give a widget to the packer (geometry manager), you call pack with " "optional arguments. In Tkinter, the Pack class holds all this " @@ -109226,31 +111452,31 @@ msgid "" "for additional information on the Form geometry manager. ::" msgstr "" -#: ../src/Doc/library/tkinter.rst:352 +#: library/tkinter.rst:352 msgid "How Tk and Tkinter are Related" msgstr "" -#: ../src/Doc/library/tkinter.rst:354 +#: library/tkinter.rst:354 msgid "From the top down:" msgstr "" # c2f393066efe4b7e885bda394fbb2beb -#: ../src/Doc/library/tkinter.rst:356 +#: library/tkinter.rst:357 msgid "Your App Here (Python)" msgstr "" # 7561422388524fecb312c7b268cabe29 -#: ../src/Doc/library/tkinter.rst:357 +#: library/tkinter.rst:357 msgid "A Python application makes a :mod:`Tkinter` call." msgstr "" # a3c96b87d57242b18dec5dd36ff643d1 -#: ../src/Doc/library/tkinter.rst:362 +#: library/tkinter.rst:363 msgid "Tkinter (Python Module)" msgstr "" # c69b228b5bd447038a79496a8ea6f180 -#: ../src/Doc/library/tkinter.rst:360 +#: library/tkinter.rst:360 msgid "" "This call (say, for example, creating a button widget), is implemented in " "the *Tkinter* module, which is written in Python. This Python function will " @@ -109259,24 +111485,24 @@ msgid "" msgstr "" # 9688f5eb945e4a60a3c281ded999c450 -#: ../src/Doc/library/tkinter.rst:366 +#: library/tkinter.rst:367 msgid "tkinter (C)" msgstr "" # 4d7083cb8d364c8cb0d6505924010761 -#: ../src/Doc/library/tkinter.rst:366 +#: library/tkinter.rst:366 msgid "" "These commands and their arguments will be passed to a C function in the " "*tkinter* - note the lowercase - extension module." msgstr "" # 22d42955aef04c0db1197e9c043a6d3c -#: ../src/Doc/library/tkinter.rst:373 +#: library/tkinter.rst:374 msgid "Tk Widgets (C and Tcl)" msgstr "" # f1b614e1039748e2a21326d7c40685cf -#: ../src/Doc/library/tkinter.rst:370 +#: library/tkinter.rst:370 msgid "" "This C function is able to make calls into other C modules, including the C " "functions that make up the Tk library. Tk is implemented in C and some Tcl. " @@ -109286,61 +111512,61 @@ msgid "" msgstr "" # 2f1097fce0e84dada963a2370d29fd75 -#: ../src/Doc/library/tkinter.rst:376 +#: library/tkinter.rst:377 msgid "Tk (C)" msgstr "" -#: ../src/Doc/library/tkinter.rst:377 +#: library/tkinter.rst:377 msgid "The Tk part of the Tk Widgets implement the final mapping to ..." msgstr "" # 0ad1a2f7b5104de6aeea1a76f302ed9b -#: ../src/Doc/library/tkinter.rst:380 +#: library/tkinter.rst:381 msgid "Xlib (C)" msgstr "" -#: ../src/Doc/library/tkinter.rst:380 +#: library/tkinter.rst:380 msgid "the Xlib library to draw graphics on the screen." msgstr "" -#: ../src/Doc/library/tkinter.rst:384 +#: library/tkinter.rst:384 msgid "Handy Reference" msgstr "" -#: ../src/Doc/library/tkinter.rst:390 +#: library/tkinter.rst:390 msgid "Setting Options" msgstr "" -#: ../src/Doc/library/tkinter.rst:392 +#: library/tkinter.rst:392 msgid "" "Options control things like the color and border width of a widget. Options " "can be set in three ways:" msgstr "" # 6b3d35a435be46fda2385fee5f6b9522 -#: ../src/Doc/library/tkinter.rst:397 +#: library/tkinter.rst:398 msgid "At object creation time, using keyword arguments" msgstr "" # aac7be549ca44f2487ad8e2cfe1fad36 -#: ../src/Doc/library/tkinter.rst:403 +#: library/tkinter.rst:404 msgid "After object creation, treating the option name like a dictionary index" msgstr "" # 364597163d054725a7590df75d7a7881 -#: ../src/Doc/library/tkinter.rst:408 +#: library/tkinter.rst:409 msgid "" "Use the config() method to update multiple attrs subsequent to object " "creation" msgstr "" -#: ../src/Doc/library/tkinter.rst:411 +#: library/tkinter.rst:411 msgid "" "For a complete explanation of a given option and its behavior, see the Tk " "man pages for the widget in question." msgstr "" -#: ../src/Doc/library/tkinter.rst:414 +#: library/tkinter.rst:414 msgid "" "Note that the man pages list \"STANDARD OPTIONS\" and \"WIDGET SPECIFIC " "OPTIONS\" for each widget. The former is a list of options that are common " @@ -109349,7 +111575,7 @@ msgid "" "`options(3)` man page." msgstr "" -#: ../src/Doc/library/tkinter.rst:420 +#: library/tkinter.rst:420 msgid "" "No distinction between standard and widget-specific options is made in this " "document. Some options don't apply to some kinds of widgets. Whether a " @@ -109357,7 +111583,7 @@ msgid "" "widget; buttons have a ``command`` option, labels do not." msgstr "" -#: ../src/Doc/library/tkinter.rst:425 +#: library/tkinter.rst:425 msgid "" "The options supported by a given widget are listed in that widget's man " "page, or can be queried at runtime by calling the :meth:`config` method " @@ -109366,7 +111592,7 @@ msgid "" "option as a string (for example, ``'relief'``) and whose values are 5-tuples." msgstr "" -#: ../src/Doc/library/tkinter.rst:431 +#: library/tkinter.rst:431 msgid "" "Some options, like ``bg`` are synonyms for common options with long names " "(``bg`` is shorthand for \"background\"). Passing the ``config()`` method " @@ -109375,53 +111601,53 @@ msgid "" "option (such as ``('bg', 'background')``)." msgstr "" -#: ../src/Doc/library/tkinter.rst:440 +#: library/tkinter.rst:440 msgid "option name" msgstr "" -#: ../src/Doc/library/tkinter.rst:440 ../src/Doc/library/tkinter.rst:442 +#: library/tkinter.rst:440 library/tkinter.rst:442 msgid "``'relief'``" msgstr "" -#: ../src/Doc/library/tkinter.rst:442 +#: library/tkinter.rst:442 msgid "option name for database lookup" msgstr "" -#: ../src/Doc/library/tkinter.rst:444 +#: library/tkinter.rst:444 msgid "option class for database lookup" msgstr "" -#: ../src/Doc/library/tkinter.rst:444 +#: library/tkinter.rst:444 msgid "``'Relief'``" msgstr "" -#: ../src/Doc/library/tkinter.rst:447 +#: library/tkinter.rst:447 msgid "default value" msgstr "" -#: ../src/Doc/library/tkinter.rst:447 +#: library/tkinter.rst:447 msgid "``'raised'``" msgstr "" -#: ../src/Doc/library/tkinter.rst:449 +#: library/tkinter.rst:449 msgid "current value" msgstr "" -#: ../src/Doc/library/tkinter.rst:449 +#: library/tkinter.rst:449 msgid "``'groove'``" msgstr "" -#: ../src/Doc/library/tkinter.rst:457 +#: library/tkinter.rst:457 msgid "" "Of course, the dictionary printed will include all the options available and " "their values. This is meant only as an example." msgstr "" -#: ../src/Doc/library/tkinter.rst:462 +#: library/tkinter.rst:462 msgid "The Packer" msgstr "" -#: ../src/Doc/library/tkinter.rst:466 +#: library/tkinter.rst:466 msgid "" "The packer is one of Tk's geometry-management mechanisms. Geometry " "managers are used to specify the relative positioning of the positioning of " @@ -109432,7 +111658,7 @@ msgid "" "exact placement coordinates for you." msgstr "" -#: ../src/Doc/library/tkinter.rst:474 +#: library/tkinter.rst:474 msgid "" "The size of any *master* widget is determined by the size of the \"slave " "widgets\" inside. The packer is used to control where slave widgets appear " @@ -109442,7 +111668,7 @@ msgid "" "accommodate incremental changes to the configuration, once it is packed." msgstr "" -#: ../src/Doc/library/tkinter.rst:481 +#: library/tkinter.rst:481 msgid "" "Note that widgets do not appear until they have had their geometry specified " "with a geometry manager. It's a common early mistake to leave out the " @@ -109451,18 +111677,18 @@ msgid "" "the packer's :meth:`pack` method applied to it." msgstr "" -#: ../src/Doc/library/tkinter.rst:487 +#: library/tkinter.rst:487 msgid "" "The pack() method can be called with keyword-option/value pairs that control " "where the widget is to appear within its container, and how it is to behave " "when the main application window is resized. Here are some examples::" msgstr "" -#: ../src/Doc/library/tkinter.rst:497 +#: library/tkinter.rst:497 msgid "Packer Options" msgstr "" -#: ../src/Doc/library/tkinter.rst:499 +#: library/tkinter.rst:499 msgid "" "For more extensive information on the packer and the options that it can " "take, see the man pages and page 183 of John Ousterhout's book." @@ -109470,67 +111696,67 @@ msgstr "" # 7d3c173eabe34600aa166256eec5c719 # e4df1a460d794ab9a994b8a69f072657 -#: ../src/Doc/library/tkinter.rst:502 ../src/Doc/library/tkinter.rst:618 +#: library/tkinter.rst:503 library/tkinter.rst:619 msgid "anchor" msgstr "" -#: ../src/Doc/library/tkinter.rst:503 +#: library/tkinter.rst:503 msgid "" "Anchor type. Denotes where the packer is to place each slave in its parcel." msgstr "" # 3dbf110abac14a04b0725afc0efa3ae1 -#: ../src/Doc/library/tkinter.rst:505 +#: library/tkinter.rst:506 msgid "expand" msgstr "" -#: ../src/Doc/library/tkinter.rst:506 +#: library/tkinter.rst:506 msgid "Boolean, ``0`` or ``1``." msgstr "" # 6ce2ecc4251046c08bbc8f1c6f3325f1 -#: ../src/Doc/library/tkinter.rst:508 +#: library/tkinter.rst:509 msgid "fill" msgstr "" -#: ../src/Doc/library/tkinter.rst:509 +#: library/tkinter.rst:509 msgid "Legal values: ``'x'``, ``'y'``, ``'both'``, ``'none'``." msgstr "" # 4d50330f04f84c70985ffa5fa0838a3d -#: ../src/Doc/library/tkinter.rst:511 +#: library/tkinter.rst:512 msgid "ipadx and ipady" msgstr "" -#: ../src/Doc/library/tkinter.rst:512 +#: library/tkinter.rst:512 msgid "" "A distance - designating internal padding on each side of the slave widget." msgstr "" # 073554dc7a3a4bdaa75dcbc2c3ad1b8e -#: ../src/Doc/library/tkinter.rst:514 +#: library/tkinter.rst:515 msgid "padx and pady" msgstr "" -#: ../src/Doc/library/tkinter.rst:515 +#: library/tkinter.rst:515 msgid "" "A distance - designating external padding on each side of the slave widget." msgstr "" # d421b1046e9043d38b55a7434f654207 -#: ../src/Doc/library/tkinter.rst:518 +#: library/tkinter.rst:519 msgid "side" msgstr "" -#: ../src/Doc/library/tkinter.rst:518 +#: library/tkinter.rst:518 msgid "Legal values are: ``'left'``, ``'right'``, ``'top'``, ``'bottom'``." msgstr "" -#: ../src/Doc/library/tkinter.rst:522 +#: library/tkinter.rst:522 msgid "Coupling Widget Variables" msgstr "" -#: ../src/Doc/library/tkinter.rst:524 +#: library/tkinter.rst:524 msgid "" "The current-value setting of some widgets (like text entry widgets) can be " "connected directly to application variables by using special options. These " @@ -109541,7 +111767,7 @@ msgid "" msgstr "" # 674d2e8314c44bfab2b25f434638ee3f -#: ../src/Doc/library/tkinter.rst:530 +#: library/tkinter.rst:530 msgid "" "Unfortunately, in the current implementation of :mod:`Tkinter` it is not " "possible to hand over an arbitrary Python variable to a widget through a " @@ -109550,7 +111776,7 @@ msgid "" "Variable, defined in the :mod:`Tkinter` module." msgstr "" -#: ../src/Doc/library/tkinter.rst:536 +#: library/tkinter.rst:536 msgid "" "There are many useful subclasses of Variable already defined: :class:" "`StringVar`, :class:`IntVar`, :class:`DoubleVar`, and :class:`BooleanVar`. " @@ -109560,12 +111786,12 @@ msgid "" "no further intervention on your part." msgstr "" -#: ../src/Doc/library/tkinter.rst:572 +#: library/tkinter.rst:572 msgid "The Window Manager" msgstr "" # 616d70e3a05c4d30a7b710ac8d39fb17 -#: ../src/Doc/library/tkinter.rst:576 +#: library/tkinter.rst:576 msgid "" "In Tk, there is a utility command, ``wm``, for interacting with the window " "manager. Options to the ``wm`` command allow you to control things like " @@ -109575,7 +111801,7 @@ msgid "" "the :class:`Wm` methods directly." msgstr "" -#: ../src/Doc/library/tkinter.rst:583 +#: library/tkinter.rst:583 msgid "" "To get at the toplevel window that contains a given widget, you can often " "just refer to the widget's master. Of course if the widget has been packed " @@ -109586,15 +111812,15 @@ msgid "" "to Tk functionality." msgstr "" -#: ../src/Doc/library/tkinter.rst:590 +#: library/tkinter.rst:590 msgid "Here are some examples of typical usage::" msgstr "" -#: ../src/Doc/library/tkinter.rst:613 +#: library/tkinter.rst:613 msgid "Tk Option Data Types" msgstr "" -#: ../src/Doc/library/tkinter.rst:618 +#: library/tkinter.rst:618 msgid "" "Legal values are points of the compass: ``\"n\"``, ``\"ne\"``, ``\"e\"``, ``" "\"se\"``, ``\"s\"``, ``\"sw\"``, ``\"w\"``, ``\"nw\"``, and also ``\"center" @@ -109602,11 +111828,11 @@ msgid "" msgstr "" # 41e7a0bac2bb47e7af53ec9ab56cb539 -#: ../src/Doc/library/tkinter.rst:624 +#: library/tkinter.rst:625 msgid "bitmap" msgstr "" -#: ../src/Doc/library/tkinter.rst:622 +#: library/tkinter.rst:622 msgid "" "There are eight built-in, named bitmaps: ``'error'``, ``'gray25'``, " "``'gray50'``, ``'hourglass'``, ``'info'``, ``'questhead'``, ``'question'``, " @@ -109615,30 +111841,30 @@ msgid "" msgstr "" # a0e0d217764e4ac5bdb686a0b47c93bc -#: ../src/Doc/library/tkinter.rst:627 +#: library/tkinter.rst:628 msgid "boolean" msgstr "" # 70bec589eff0435e87482da6b28f1a85 -#: ../src/Doc/library/tkinter.rst:628 +#: library/tkinter.rst:628 msgid "You can pass integers 0 or 1 or the strings ``\"yes\"`` or ``\"no\"``." msgstr "" # b23e4e90a51f4197856d359048ab9623 -#: ../src/Doc/library/tkinter.rst:634 +#: library/tkinter.rst:635 msgid "callback" msgstr "" -#: ../src/Doc/library/tkinter.rst:631 +#: library/tkinter.rst:631 msgid "This is any Python function that takes no arguments. For example::" msgstr "" # ea0ac50d32a14675a124d7b9bdc95fa2 -#: ../src/Doc/library/tkinter.rst:640 +#: library/tkinter.rst:641 msgid "color" msgstr "" -#: ../src/Doc/library/tkinter.rst:638 +#: library/tkinter.rst:638 msgid "" "Colors can be given as the names of X colors in the rgb.txt file, or as " "strings representing RGB values in 4 bit: ``\"#RGB\"``, 8 bit: ``\"#RRGGBB" @@ -109647,11 +111873,11 @@ msgid "" "Ousterhout's book for details." msgstr "" -#: ../src/Doc/library/tkinter.rst:646 ../src/Doc/library/ttk.rst:116 +#: library/tkinter.rst:647 library/ttk.rst:116 msgid "cursor" msgstr "" -#: ../src/Doc/library/tkinter.rst:644 +#: library/tkinter.rst:644 msgid "" "The standard X cursor names from :file:`cursorfont.h` can be used, without " "the ``XC_`` prefix. For example to get a hand cursor (:const:`XC_hand2`), " @@ -109660,11 +111886,11 @@ msgid "" msgstr "" # 266a920a3c2e42a19daafa9a39446f58 -#: ../src/Doc/library/tkinter.rst:653 +#: library/tkinter.rst:654 msgid "distance" msgstr "" -#: ../src/Doc/library/tkinter.rst:650 +#: library/tkinter.rst:650 msgid "" "Screen distances can be specified in either pixels or absolute distances. " "Pixels are given as numbers and absolute distances as strings, with the " @@ -109673,11 +111899,11 @@ msgid "" "is expressed as ``\"3.5i\"``." msgstr "" -#: ../src/Doc/library/tkinter.rst:658 ../src/Doc/library/ttk.rst:792 +#: library/tkinter.rst:659 library/ttk.rst:792 msgid "font" msgstr "" -#: ../src/Doc/library/tkinter.rst:657 +#: library/tkinter.rst:657 msgid "" "Tk uses a list font name format, such as ``{courier 10 bold}``. Font sizes " "with positive numbers are measured in points; sizes with negative numbers " @@ -109685,32 +111911,32 @@ msgid "" msgstr "" # 6056479d540d42d5b23d424edbb50972 -#: ../src/Doc/library/tkinter.rst:663 +#: library/tkinter.rst:664 msgid "geometry" msgstr "" -#: ../src/Doc/library/tkinter.rst:662 +#: library/tkinter.rst:662 msgid "" "This is a string of the form ``widthxheight``, where width and height are " "measured in pixels for most widgets (in characters for widgets displaying " "text). For example: ``fred[\"geometry\"] = \"200x100\"``." msgstr "" -#: ../src/Doc/library/tkinter.rst:667 ../src/Doc/library/ttk.rst:313 +#: library/tkinter.rst:668 library/ttk.rst:313 msgid "justify" msgstr "" -#: ../src/Doc/library/tkinter.rst:667 +#: library/tkinter.rst:667 msgid "" "Legal values are the strings: ``\"left\"``, ``\"center\"``, ``\"right\"``, " "and ``\"fill\"``." msgstr "" -#: ../src/Doc/library/tkinter.rst:672 ../src/Doc/library/ttk.rst:978 +#: library/tkinter.rst:673 library/ttk.rst:978 msgid "region" msgstr "" -#: ../src/Doc/library/tkinter.rst:671 +#: library/tkinter.rst:671 msgid "" "This is a string with four space-delimited elements, each of which is a " "legal distance (see above). For example: ``\"2 3 4 5\"`` and ``\"3i 2i 4.5i " @@ -109718,11 +111944,11 @@ msgid "" msgstr "" # d590382e6b6f47b29849340a3cbf5182 -#: ../src/Doc/library/tkinter.rst:676 +#: library/tkinter.rst:677 msgid "relief" msgstr "" -#: ../src/Doc/library/tkinter.rst:676 +#: library/tkinter.rst:676 msgid "" "Determines what the border style of a widget will be. Legal values are: ``" "\"raised\"``, ``\"sunken\"``, ``\"flat\"``, ``\"groove\"``, and ``\"ridge" @@ -109730,11 +111956,11 @@ msgid "" msgstr "" # 45fc4f4ea4714002b1bf621fd5f550e0 -#: ../src/Doc/library/tkinter.rst:682 +#: library/tkinter.rst:683 msgid "scrollcommand" msgstr "" -#: ../src/Doc/library/tkinter.rst:680 +#: library/tkinter.rst:680 msgid "" "This is almost always the :meth:`!set` method of some scrollbar widget, but " "can be any widget method that takes a single argument. Refer to the file :" @@ -109743,46 +111969,46 @@ msgid "" msgstr "" # 6afc1870456842bfb79a7c1a8b9b6b8a -#: ../src/Doc/library/tkinter.rst:686 +#: library/tkinter.rst:687 msgid "wrap:" msgstr "" -#: ../src/Doc/library/tkinter.rst:686 +#: library/tkinter.rst:686 msgid "Must be one of: ``\"none\"``, ``\"char\"``, or ``\"word\"``." msgstr "" -#: ../src/Doc/library/tkinter.rst:690 +#: library/tkinter.rst:690 msgid "Bindings and Events" msgstr "" -#: ../src/Doc/library/tkinter.rst:696 +#: library/tkinter.rst:696 msgid "" "The bind method from the widget command allows you to watch for certain " "events and to have a callback function trigger when that event type occurs. " "The form of the bind method is::" msgstr "" -#: ../src/Doc/library/tkinter.rst:702 +#: library/tkinter.rst:702 msgid "where:" msgstr "" # e522869a24d34dc49b5f83f6028e564e -#: ../src/Doc/library/tkinter.rst:705 +#: library/tkinter.rst:706 msgid "sequence" msgstr "" -#: ../src/Doc/library/tkinter.rst:705 +#: library/tkinter.rst:705 msgid "" "is a string that denotes the target kind of event. (See the bind man page " "and page 201 of John Ousterhout's book for details)." msgstr "" # fd247dadb18e43a7846f1904f1026a1b -#: ../src/Doc/library/tkinter.rst:710 +#: library/tkinter.rst:711 msgid "func" msgstr "" -#: ../src/Doc/library/tkinter.rst:709 +#: library/tkinter.rst:709 msgid "" "is a Python function, taking one argument, to be invoked when the event " "occurs. An Event instance will be passed as the argument. (Functions " @@ -109790,11 +112016,11 @@ msgid "" msgstr "" # e7596cb84ac94d609676673404f931eb -#: ../src/Doc/library/tkinter.rst:716 +#: library/tkinter.rst:717 msgid "add" msgstr "" -#: ../src/Doc/library/tkinter.rst:714 +#: library/tkinter.rst:714 msgid "" "is optional, either ``''`` or ``'+'``. Passing an empty string denotes that " "this binding is to replace any other bindings that this event is associated " @@ -109803,7 +112029,7 @@ msgid "" msgstr "" # 4a4b1a6c4c874243a1c466207eae597d -#: ../src/Doc/library/tkinter.rst:726 +#: library/tkinter.rst:726 msgid "" "Notice how the widget field of the event is being accessed in the :meth:" "`turnRed` callback. This field contains the widget that caught the X " @@ -109812,12 +112038,12 @@ msgid "" "pages. ::" msgstr "" -#: ../src/Doc/library/tkinter.rst:745 +#: library/tkinter.rst:745 msgid "The index Parameter" msgstr "" # 2014f11e5ab948a9b44bf18ab74e0337 -#: ../src/Doc/library/tkinter.rst:747 +#: library/tkinter.rst:747 msgid "" "A number of widgets require\"index\" parameters to be passed. These are " "used to point at a specific place in a Text widget, or to particular " @@ -109825,12 +112051,12 @@ msgid "" msgstr "" # c27b94f30a3a424fbefa4c59ec92699e -#: ../src/Doc/library/tkinter.rst:769 +#: library/tkinter.rst:770 msgid "Entry widget indexes (index, view index, etc.)" msgstr "" # 9d5cbd98f889419caf69859f05c0963a -#: ../src/Doc/library/tkinter.rst:752 +#: library/tkinter.rst:752 msgid "" "Entry widgets have options that refer to character positions in the text " "being displayed. You can use these :mod:`Tkinter` functions to access these " @@ -109838,104 +112064,104 @@ msgid "" msgstr "" # 5444d263cad74b86901f212cec21741e -#: ../src/Doc/library/tkinter.rst:756 +#: library/tkinter.rst:757 msgid "AtEnd()" msgstr "" -#: ../src/Doc/library/tkinter.rst:757 +#: library/tkinter.rst:757 msgid "refers to the last position in the text" msgstr "" # 1b005ea765be4822a3c0c6fad430c02b -#: ../src/Doc/library/tkinter.rst:759 +#: library/tkinter.rst:760 msgid "AtInsert()" msgstr "" -#: ../src/Doc/library/tkinter.rst:760 +#: library/tkinter.rst:760 msgid "refers to the point where the text cursor is" msgstr "" # e042600b051347b48850fe4c1570df7f -#: ../src/Doc/library/tkinter.rst:762 +#: library/tkinter.rst:763 msgid "AtSelFirst()" msgstr "" -#: ../src/Doc/library/tkinter.rst:763 +#: library/tkinter.rst:763 msgid "indicates the beginning point of the selected text" msgstr "" # 241dcac2d65e4f0aaf2d839ba6d838d8 -#: ../src/Doc/library/tkinter.rst:765 +#: library/tkinter.rst:766 msgid "AtSelLast()" msgstr "" -#: ../src/Doc/library/tkinter.rst:766 +#: library/tkinter.rst:766 msgid "denotes the last point of the selected text and finally" msgstr "" # 4f282ec4615141fda149d4a72ab63417 -#: ../src/Doc/library/tkinter.rst:769 +#: library/tkinter.rst:770 msgid "At(x[, y])" msgstr "" -#: ../src/Doc/library/tkinter.rst:769 +#: library/tkinter.rst:769 msgid "" "refers to the character at pixel location *x*, *y* (with *y* not used in the " "case of a text entry widget, which contains a single line of text)." msgstr "" # 78988845e9ef48ee9800a14f44bc455e -#: ../src/Doc/library/tkinter.rst:773 +#: library/tkinter.rst:774 msgid "Text widget indexes" msgstr "" -#: ../src/Doc/library/tkinter.rst:773 +#: library/tkinter.rst:773 msgid "" "The index notation for Text widgets is very rich and is best described in " "the Tk man pages." msgstr "" # 31a837f9f05748118e7a2b2a2a8bf132 -#: ../src/Doc/library/tkinter.rst:798 +#: library/tkinter.rst:799 msgid "Menu indexes (menu.invoke(), menu.entryconfig(), etc.)" msgstr "" -#: ../src/Doc/library/tkinter.rst:777 +#: library/tkinter.rst:777 msgid "" "Some options and methods for menus manipulate specific menu entries. Anytime " "a menu index is needed for an option or a parameter, you may pass in:" msgstr "" -#: ../src/Doc/library/tkinter.rst:780 +#: library/tkinter.rst:780 msgid "" "an integer which refers to the numeric position of the entry in the widget, " "counted from the top, starting with 0;" msgstr "" # e1a427b5e3974191bee8f27c2da1b978 -#: ../src/Doc/library/tkinter.rst:783 +#: library/tkinter.rst:783 msgid "" "the string ``'active'``, which refers to the menu position that is currently " "under the cursor;" msgstr "" -#: ../src/Doc/library/tkinter.rst:786 +#: library/tkinter.rst:786 msgid "the string ``\"last\"`` which refers to the last menu item;" msgstr "" -#: ../src/Doc/library/tkinter.rst:788 +#: library/tkinter.rst:788 msgid "" "An integer preceded by ``@``, as in ``@6``, where the integer is interpreted " "as a y pixel coordinate in the menu's coordinate system;" msgstr "" -#: ../src/Doc/library/tkinter.rst:791 +#: library/tkinter.rst:791 msgid "" "the string ``\"none\"``, which indicates no menu entry at all, most often " "used with menu.activate() to deactivate all entries, and finally," msgstr "" -#: ../src/Doc/library/tkinter.rst:794 +#: library/tkinter.rst:794 msgid "" "a text string that is pattern matched against the label of the menu entry, " "as scanned from the top of the menu to the bottom. Note that this index " @@ -109944,32 +112170,32 @@ msgid "" "above literals, instead." msgstr "" -#: ../src/Doc/library/tkinter.rst:802 +#: library/tkinter.rst:802 msgid "Images" msgstr "" # c03ec91fe71047bc9adbda50128cf54e -#: ../src/Doc/library/tkinter.rst:804 +#: library/tkinter.rst:804 msgid "" "Bitmap/Pixelmap images can be created through the subclasses of :class:" "`Tkinter.Image`:" msgstr "" -#: ../src/Doc/library/tkinter.rst:807 +#: library/tkinter.rst:807 msgid ":class:`BitmapImage` can be used for X11 bitmap data." msgstr "" -#: ../src/Doc/library/tkinter.rst:809 +#: library/tkinter.rst:809 msgid ":class:`PhotoImage` can be used for GIF and PPM/PGM color bitmaps." msgstr "" -#: ../src/Doc/library/tkinter.rst:811 +#: library/tkinter.rst:811 msgid "" "Either type of image is created through either the ``file`` or the ``data`` " "option (other options are available as well)." msgstr "" -#: ../src/Doc/library/tkinter.rst:814 +#: library/tkinter.rst:814 msgid "" "The image object can then be used wherever an ``image`` option is supported " "by some widget (e.g. labels, buttons, menus). In these cases, Tk will not " @@ -109978,16 +112204,59 @@ msgid "" "empty box wherever the image was used." msgstr "" -#: ../src/Doc/library/token.rst:2 +#: library/tkinter.rst:824 +msgid "File Handlers" +msgstr "" + +#: library/tkinter.rst:826 +msgid "" +"Tk allows you to register and unregister a callback function which will be " +"called from the Tk mainloop when I/O is possible on a file descriptor. Only " +"one handler may be registered per file descriptor. Example code::" +msgstr "" + +#: library/tkinter.rst:837 +msgid "This feature is not available on Windows." +msgstr "" + +#: library/tkinter.rst:839 +msgid "" +"Since you don't know how many bytes are available for reading, you may not " +"want to use the :class:`~io.BufferedIOBase` or :class:`~io.TextIOBase` :meth:" +"`~io.BufferedIOBase.read` or :meth:`~io.IOBase.readline` methods, since " +"these will insist on reading a predefined number of bytes. For sockets, the :" +"meth:`~socket.socket.recv` or :meth:`~socket.socket.recvfrom` methods will " +"work fine; for other files, use raw reads or ``os.read(file.fileno(), " +"maxbytecount)``." +msgstr "" + +#: library/tkinter.rst:850 +msgid "" +"Registers the file handler callback function *func*. The *file* argument may " +"either be an object with a :meth:`~io.IOBase.fileno` method (such as a file " +"or socket object), or an integer file descriptor. The *mask* argument is an " +"ORed combination of any of the three constants below. The callback is called " +"as follows::" +msgstr "" + +#: library/tkinter.rst:861 +msgid "Unregisters a file handler." +msgstr "" + +#: library/tkinter.rst:868 +msgid "Constants used in the *mask* arguments." +msgstr "" + +#: library/token.rst:2 msgid ":mod:`token` --- Constants used with Python parse trees" msgstr "" # b6a25f6da4ed4964959f4db892dfe539 -#: ../src/Doc/library/token.rst:8 +#: library/token.rst:8 msgid "**Source code:** :source:`Lib/token.py`" msgstr "" -#: ../src/Doc/library/token.rst:12 +#: library/token.rst:12 msgid "" "This module provides constants which represent the numeric values of leaf " "nodes of the parse tree (terminal tokens). Refer to the file :file:`Grammar/" @@ -109997,50 +112266,50 @@ msgid "" msgstr "" # c84da0c9e5114ed19a5831eaf2c8e078 -#: ../src/Doc/library/token.rst:18 +#: library/token.rst:18 msgid "" "The module also provides a mapping from numeric codes to names and some " "functions. The functions mirror definitions in the Python C header files." msgstr "" -#: ../src/Doc/library/token.rst:31 +#: library/token.rst:31 msgid "Return true for terminal token values." msgstr "" -#: ../src/Doc/library/token.rst:36 +#: library/token.rst:36 msgid "Return true for non-terminal token values." msgstr "" -#: ../src/Doc/library/token.rst:41 +#: library/token.rst:41 msgid "Return true if *x* is the marker indicating the end of input." msgstr "" # 9413558222104c118ee61ff578a1b7d5 -#: ../src/Doc/library/token.rst:44 +#: library/token.rst:44 msgid "The token constants are:" msgstr "" -# c17662f0d3134ee4b94ba1e6553dbc7e -#: ../src/Doc/library/token.rst:105 -msgid "Module :mod:`parser`" -msgstr "" +#: library/token.rst:106 +#, fuzzy +msgid "Module parser" +msgstr "Modules" -#: ../src/Doc/library/token.rst:106 +#: library/token.rst:106 msgid "" "The second example for the :mod:`parser` module shows how to use the :mod:" "`symbol` module." msgstr "" -#: ../src/Doc/library/tokenize.rst:2 +#: library/tokenize.rst:2 msgid ":mod:`tokenize` --- Tokenizer for Python source" msgstr "" # 4aa2784beed149edb02c63ea9b25c081 -#: ../src/Doc/library/tokenize.rst:9 +#: library/tokenize.rst:9 msgid "**Source code:** :source:`Lib/tokenize.py`" msgstr "" -#: ../src/Doc/library/tokenize.rst:13 +#: library/tokenize.rst:13 msgid "" "The :mod:`tokenize` module provides a lexical scanner for Python source " "code, implemented in Python. The scanner in this module returns comments as " @@ -110049,7 +112318,7 @@ msgid "" msgstr "" # 6603fdb4685d433598f43d5df8e2a9b2 -#: ../src/Doc/library/tokenize.rst:18 +#: library/tokenize.rst:18 msgid "" "To simplify token stream handling, all :ref:`operators` and :ref:" "`delimiters` tokens are returned using the generic :data:`token.OP` token " @@ -110059,12 +112328,12 @@ msgid "" "specific operator token." msgstr "" -#: ../src/Doc/library/tokenize.rst:25 +#: library/tokenize.rst:25 msgid "The primary entry point is a :term:`generator`:" msgstr "" # d6b58617afef47f882dc1541b67dba80 -#: ../src/Doc/library/tokenize.rst:29 +#: library/tokenize.rst:29 msgid "" "The :func:`generate_tokens` generator requires one argument, *readline*, " "which must be a callable object which provides the same interface as the :" @@ -110075,7 +112344,7 @@ msgid "" msgstr "" # 5c86f00602ea4f90ad16b601047c609b -#: ../src/Doc/library/tokenize.rst:36 +#: library/tokenize.rst:36 msgid "" "The generator produces 5-tuples with these members: the token type; the " "token string; a 2-tuple ``(srow, scol)`` of ints specifying the row and " @@ -110086,19 +112355,19 @@ msgid "" msgstr "" # 4c118ea925c7422a9c4fb92f349524cf -#: ../src/Doc/library/tokenize.rst:45 +#: library/tokenize.rst:45 msgid "An older entry point is retained for backward compatibility:" msgstr "" # 91f598b0db074e93b400cdb5812f8fcf -#: ../src/Doc/library/tokenize.rst:50 +#: library/tokenize.rst:50 msgid "" "The :func:`tokenize` function accepts two parameters: one representing the " "input stream, and one providing an output mechanism for :func:`tokenize`." msgstr "" # 4fbbc5217f5c4adb9d661b778b2cefab -#: ../src/Doc/library/tokenize.rst:53 +#: library/tokenize.rst:53 msgid "" "The first parameter, *readline*, must be a callable object which provides " "the same interface as the :meth:`readline` method of built-in file objects " @@ -110107,8 +112376,12 @@ msgid "" "callable object that signals completion by raising :exc:`StopIteration`." msgstr "" +#: library/tokenize.rst:59 +msgid "Added :exc:`StopIteration` support." +msgstr "" + # 42c60f03a8684190b5a1966234a91a62 -#: ../src/Doc/library/tokenize.rst:62 +#: library/tokenize.rst:62 msgid "" "The second parameter, *tokeneater*, must also be a callable object. It is " "called once for each token, with five arguments, corresponding to the tuples " @@ -110116,25 +112389,25 @@ msgid "" msgstr "" # 14a87554c26441a39ade3c0930888666 -#: ../src/Doc/library/tokenize.rst:66 +#: library/tokenize.rst:66 msgid "" "All constants from the :mod:`token` module are also exported from :mod:" "`tokenize`, as are two additional token type values that might be passed to " "the *tokeneater* function by :func:`tokenize`:" msgstr "" -#: ../src/Doc/library/tokenize.rst:73 +#: library/tokenize.rst:73 msgid "Token value used to indicate a comment." msgstr "" -#: ../src/Doc/library/tokenize.rst:78 +#: library/tokenize.rst:78 msgid "" "Token value used to indicate a non-terminating newline. The NEWLINE token " "indicates the end of a logical line of Python code; NL tokens are generated " "when a logical line of code is continued over multiple physical lines." msgstr "" -#: ../src/Doc/library/tokenize.rst:82 +#: library/tokenize.rst:82 msgid "" "Another function is provided to reverse the tokenization process. This is " "useful for creating tools that tokenize a script, modify the token stream, " @@ -110142,14 +112415,14 @@ msgid "" msgstr "" # 7f93f055c753454289a3a678c345a8b4 -#: ../src/Doc/library/tokenize.rst:89 +#: library/tokenize.rst:89 msgid "" "Converts tokens back into Python source code. The *iterable* must return " "sequences with at least two elements, the token type and the token string. " "Any additional sequence elements are ignored." msgstr "" -#: ../src/Doc/library/tokenize.rst:93 +#: library/tokenize.rst:93 msgid "" "The reconstructed script is returned as a single string. The result is " "guaranteed to tokenize back to match the input so that the conversion is " @@ -110159,40 +112432,40 @@ msgid "" msgstr "" # 5b057be558704e74bbd8641b45c023e0 -#: ../src/Doc/library/tokenize.rst:103 +#: library/tokenize.rst:103 msgid "" "Raised when either a docstring or expression that may be split over several " "lines is not completed anywhere in the file, for example::" msgstr "" -#: ../src/Doc/library/tokenize.rst:109 ../src/Doc/library/unittest.rst:964 +#: library/tokenize.rst:109 library/unittest.rst:955 msgid "or::" msgstr "" # 324237504aba4353a449349822cf0ec9 -#: ../src/Doc/library/tokenize.rst:115 +#: library/tokenize.rst:115 msgid "" "Note that unclosed single-quoted strings do not cause an error to be raised. " "They are tokenized as ``ERRORTOKEN``, followed by the tokenization of their " "contents." msgstr "" -#: ../src/Doc/library/tokenize.rst:119 +#: library/tokenize.rst:119 msgid "" "Example of a script re-writer that transforms float literals into Decimal " "objects::" msgstr "" -#: ../src/Doc/library/trace.rst:2 +#: library/trace.rst:2 msgid ":mod:`trace` --- Trace or track Python statement execution" msgstr "" # db76f4a8a2484a2ea9e44fa586ea8750 -#: ../src/Doc/library/trace.rst:7 +#: library/trace.rst:7 msgid "**Source code:** :source:`Lib/trace.py`" msgstr "" -#: ../src/Doc/library/trace.rst:11 +#: library/trace.rst:11 msgid "" "The :mod:`trace` module allows you to trace program execution, generate " "annotated statement coverage listings, print caller/callee relationships and " @@ -110201,18 +112474,18 @@ msgid "" msgstr "" # edfd245df2bc4216b1b0d79dbbbbb421 -#: ../src/Doc/library/trace.rst:19 +#: library/trace.rst:19 msgid "Command-Line Usage" msgstr "" -#: ../src/Doc/library/trace.rst:21 +#: library/trace.rst:21 msgid "" "The :mod:`trace` module can be invoked from the command line. It can be as " "simple as ::" msgstr "" # b3124e1550d744faae9716d1036cb274 -#: ../src/Doc/library/trace.rst:26 +#: library/trace.rst:26 msgid "" "The above will execute :file:`somefile.py` and generate annotated listings " "of all Python modules imported during the execution into the current " @@ -110220,22 +112493,22 @@ msgid "" msgstr "" # 11f6c5ddfb3245e1a4d609bf22808864 -#: ../src/Doc/library/trace.rst:33 +#: library/trace.rst:33 msgid "Display usage and exit." msgstr "" # d0b234c08f434ed983f62e4c5e77e08c -#: ../src/Doc/library/trace.rst:37 +#: library/trace.rst:37 msgid "Display the version of the module and exit." msgstr "" # 914fb382a12544b3af4cf138fbc7d092 -#: ../src/Doc/library/trace.rst:40 +#: library/trace.rst:40 msgid "Main options" msgstr "" # 2f221749b60d4625b300070d7c0e3090 -#: ../src/Doc/library/trace.rst:42 +#: library/trace.rst:42 msgid "" "At least one of the following options must be specified when invoking :mod:" "`trace`. The :option:`--listfuncs <-l>` option is mutually exclusive with " @@ -110245,24 +112518,24 @@ msgid "" msgstr "" # 2f21ac575f564c95abf174c6f15aa65d -#: ../src/Doc/library/trace.rst:52 +#: library/trace.rst:52 msgid "" "Produce a set of annotated listing files upon program completion that shows " "how many times each statement was executed. See also :option:`--coverdir <-" "C>`, :option:`--file <-f>` and :option:`--no-report <-R>` below." msgstr "" -#: ../src/Doc/library/trace.rst:59 +#: library/trace.rst:59 msgid "Display lines as they are executed." msgstr "" # 1bcefb955f254ea8ac9cc4a0287a0efb -#: ../src/Doc/library/trace.rst:63 +#: library/trace.rst:63 msgid "Display the functions executed by running the program." msgstr "" # d45401bddf1e464b94c5d3836819e609 -#: ../src/Doc/library/trace.rst:67 +#: library/trace.rst:67 msgid "" "Produce an annotated list from an earlier program run that used the :option:" "`--count <-c>` and :option:`--file <-f>` option. This does not execute any " @@ -110270,45 +112543,45 @@ msgid "" msgstr "" # 7600e52067b246b3a5973cbef87c8fc0 -#: ../src/Doc/library/trace.rst:73 +#: library/trace.rst:73 msgid "Display the calling relationships exposed by running the program." msgstr "" # 856ac72f982b428e84e3942c45dac635 -#: ../src/Doc/library/trace.rst:76 +#: library/trace.rst:76 msgid "Modifiers" msgstr "" # f92d36aa27de4112b7eba682a453fc4f -#: ../src/Doc/library/trace.rst:82 +#: library/trace.rst:82 msgid "" "Name of a file to accumulate counts over several tracing runs. Should be " "used with the :option:`--count <-c>` option." msgstr "" # 19076ca934c94e8c9f7a9333007994b4 -#: ../src/Doc/library/trace.rst:87 +#: library/trace.rst:87 msgid "" "Directory where the report files go. The coverage report for ``package." "module`` is written to file :file:`{dir}/{package}/{module}.cover`." msgstr "" # 21c44a05913c448d8e7ce335ceafe73c -#: ../src/Doc/library/trace.rst:92 +#: library/trace.rst:92 msgid "" "When generating annotated listings, mark lines which were not executed with " "``>>>>>>``." msgstr "" # 54ea57cc52eb436581c041ffea174d32 -#: ../src/Doc/library/trace.rst:97 +#: library/trace.rst:97 msgid "" "When using :option:`--count <-c>` or :option:`--report <-r>`, write a brief " "summary to stdout for each file processed." msgstr "" # a40125af422b484cb7861da6cb7e60e6 -#: ../src/Doc/library/trace.rst:102 +#: library/trace.rst:102 msgid "" "Do not generate annotated listings. This is useful if you intend to make " "several runs with :option:`--count <-c>`, and then produce a single set of " @@ -110316,43 +112589,43 @@ msgid "" msgstr "" # 3e9c2497a62d43a0b38122fbfdd2f394 -#: ../src/Doc/library/trace.rst:108 +#: library/trace.rst:108 msgid "" "Prefix each line with the time since the program started. Only used while " "tracing." msgstr "" # 76727872bc434c03bd6c84aadd0c09a9 -#: ../src/Doc/library/trace.rst:112 +#: library/trace.rst:112 msgid "Filters" msgstr "" # 70f890bf578942c7a9774932501f9e79 -#: ../src/Doc/library/trace.rst:114 +#: library/trace.rst:114 msgid "These options may be repeated multiple times." msgstr "" # 16654454275c45db93b3e7045794ab31 -#: ../src/Doc/library/trace.rst:120 +#: library/trace.rst:120 msgid "" "Ignore each of the given module names and its submodules (if it is a " "package). The argument can be a list of names separated by a comma." msgstr "" # 4cd41a39e9084fb7a431c0af46be794b -#: ../src/Doc/library/trace.rst:125 +#: library/trace.rst:125 msgid "" "Ignore all modules and packages in the named directory and subdirectories. " "The argument can be a list of directories separated by :data:`os.pathsep`." msgstr "" # 5cdfc04653e743cbaafefc2d7ba738da -#: ../src/Doc/library/trace.rst:131 +#: library/trace.rst:131 msgid "Programmatic Interface" msgstr "" # 791cb95ea1814c8982a04ca8b7a6c6c4 -#: ../src/Doc/library/trace.rst:135 +#: library/trace.rst:135 msgid "" "Create an object to trace execution of a single statement or expression. " "All parameters are optional. *count* enables counting of line numbers. " @@ -110367,7 +112640,7 @@ msgid "" msgstr "" # a5c8316ddd8b4f5499ea34ee4f1eb5b7 -#: ../src/Doc/library/trace.rst:148 +#: library/trace.rst:148 msgid "" "Execute the command and gather statistics from the execution with the " "current tracing parameters. *cmd* must be a string or code object, suitable " @@ -110375,21 +112648,21 @@ msgid "" msgstr "" # 8cdbab863b08472cb8ce3bc5ddfb25e4 -#: ../src/Doc/library/trace.rst:154 +#: library/trace.rst:154 msgid "" "Execute the command and gather statistics from the execution with the " "current tracing parameters, in the defined global and local environments. " "If not defined, *globals* and *locals* default to empty dictionaries." msgstr "" -#: ../src/Doc/library/trace.rst:161 +#: library/trace.rst:161 msgid "" "Call *func* with the given arguments under control of the :class:`Trace` " "object with the current tracing parameters." msgstr "" # d0a5396f7db54710afde6334c9aa7a0d -#: ../src/Doc/library/trace.rst:166 +#: library/trace.rst:166 msgid "" "Return a :class:`CoverageResults` object that contains the cumulative " "results of all previous calls to ``run``, ``runctx`` and ``runfunc`` for the " @@ -110397,19 +112670,19 @@ msgid "" msgstr "" # edbe9af05f8e4dc88b59559b07e3e754 -#: ../src/Doc/library/trace.rst:173 +#: library/trace.rst:173 msgid "" "A container for coverage results, created by :meth:`Trace.results`. Should " "not be created directly by the user." msgstr "" # 4260047eac2240689b7a86de24abea8e -#: ../src/Doc/library/trace.rst:178 +#: library/trace.rst:178 msgid "Merge in data from another :class:`CoverageResults` object." msgstr "" # c99b3adbc4c542309490be8b26685623 -#: ../src/Doc/library/trace.rst:182 +#: library/trace.rst:182 msgid "" "Write coverage results. Set *show_missing* to show lines that had no hits. " "Set *summary* to include in the output the coverage summary per module. " @@ -110419,15 +112692,15 @@ msgid "" msgstr "" # acc1ea58e9d547fd896f5d66867db6f2 -#: ../src/Doc/library/trace.rst:188 +#: library/trace.rst:188 msgid "A simple example demonstrating the use of the programmatic interface::" msgstr "" -#: ../src/Doc/library/traceback.rst:2 +#: library/traceback.rst:2 msgid ":mod:`traceback` --- Print or retrieve a stack traceback" msgstr "" -#: ../src/Doc/library/traceback.rst:8 +#: library/traceback.rst:8 msgid "" "This module provides a standard interface to extract, format and print stack " "traces of Python programs. It exactly mimics the behavior of the Python " @@ -110437,14 +112710,14 @@ msgid "" msgstr "" # f6143f34ed104ca8a2ffd78fa9e77bc0 -#: ../src/Doc/library/traceback.rst:16 +#: library/traceback.rst:16 msgid "" "The module uses traceback objects --- this is the object type that is stored " "in the variables :data:`sys.exc_traceback` (deprecated) and :data:`sys." "last_traceback` and returned as the third item from :func:`sys.exc_info`." msgstr "" -#: ../src/Doc/library/traceback.rst:25 +#: library/traceback.rst:25 msgid "" "Print up to *limit* stack trace entries from *traceback*. If *limit* is " "omitted or ``None``, all entries are printed. If *file* is omitted or " @@ -110453,7 +112726,7 @@ msgid "" msgstr "" # dd361fbc1d284f6bb1385173032bb185 -#: ../src/Doc/library/traceback.rst:33 +#: library/traceback.rst:33 msgid "" "Print exception information and up to *limit* stack trace entries from " "*traceback* to *file*. This differs from :func:`print_tb` in the following " @@ -110465,7 +112738,7 @@ msgid "" msgstr "" # a640b2802f2341d897ec0d116d7eff1c -#: ../src/Doc/library/traceback.rst:44 +#: library/traceback.rst:44 msgid "" "This is a shorthand for ``print_exception(sys.exc_type, sys.exc_value, sys." "exc_traceback, limit, file)``. (In fact, it uses :func:`sys.exc_info` to " @@ -110473,20 +112746,20 @@ msgid "" "deprecated variables.)" msgstr "" -#: ../src/Doc/library/traceback.rst:52 +#: library/traceback.rst:52 msgid "" "This is like ``print_exc(limit)`` but returns a string instead of printing " "to a file." msgstr "" -#: ../src/Doc/library/traceback.rst:60 +#: library/traceback.rst:60 msgid "" "This is a shorthand for ``print_exception(sys.last_type, sys.last_value, sys." "last_traceback, limit, file)``. In general it will work only after an " "exception has reached an interactive prompt (see :data:`sys.last_type`)." msgstr "" -#: ../src/Doc/library/traceback.rst:67 +#: library/traceback.rst:67 msgid "" "This function prints a stack trace from its invocation point. The optional " "*f* argument can be used to specify an alternate stack frame to start. The " @@ -110495,7 +112768,7 @@ msgid "" msgstr "" # dbf3313674724049bd309f5d253f579d -#: ../src/Doc/library/traceback.rst:75 +#: library/traceback.rst:75 msgid "" "Return a list of up to *limit* \"pre-processed\" stack trace entries " "extracted from the traceback object *traceback*. It is useful for alternate " @@ -110507,14 +112780,14 @@ msgid "" "available it is ``None``." msgstr "" -#: ../src/Doc/library/traceback.rst:86 +#: library/traceback.rst:86 msgid "" "Extract the raw traceback from the current stack frame. The return value " "has the same format as for :func:`extract_tb`. The optional *f* and *limit* " "arguments have the same meaning as for :func:`print_stack`." msgstr "" -#: ../src/Doc/library/traceback.rst:93 +#: library/traceback.rst:93 msgid "" "Given a list of tuples as returned by :func:`extract_tb` or :func:" "`extract_stack`, return a list of strings ready for printing. Each string " @@ -110524,7 +112797,7 @@ msgid "" "``None``." msgstr "" -#: ../src/Doc/library/traceback.rst:102 +#: library/traceback.rst:102 msgid "" "Format the exception part of a traceback. The arguments are the exception " "type and value such as given by ``sys.last_type`` and ``sys.last_value``. " @@ -110535,7 +112808,7 @@ msgid "" "which exception occurred is the always last string in the list." msgstr "" -#: ../src/Doc/library/traceback.rst:113 +#: library/traceback.rst:113 msgid "" "Format a stack trace and the exception information. The arguments have the " "same meaning as the corresponding arguments to :func:`print_exception`. The " @@ -110544,16 +112817,16 @@ msgid "" "printed, exactly the same text is printed as does :func:`print_exception`." msgstr "" -#: ../src/Doc/library/traceback.rst:122 +#: library/traceback.rst:122 msgid "A shorthand for ``format_list(extract_tb(tb, limit))``." msgstr "" -#: ../src/Doc/library/traceback.rst:127 +#: library/traceback.rst:127 msgid "A shorthand for ``format_list(extract_stack(f, limit))``." msgstr "" # ec3eb04ae4c54865b63f6a23aec3e47b -#: ../src/Doc/library/traceback.rst:132 +#: library/traceback.rst:132 msgid "" "This function returns the current line number set in the traceback object. " "This function was necessary because in versions of Python prior to 2.3 when " @@ -110561,11 +112834,11 @@ msgid "" "updated correctly. This function has no use in versions past 2.3." msgstr "" -#: ../src/Doc/library/traceback.rst:141 +#: library/traceback.rst:141 msgid "Traceback Examples" msgstr "" -#: ../src/Doc/library/traceback.rst:143 +#: library/traceback.rst:143 msgid "" "This simple example implements a basic read-eval-print loop, similar to (but " "less useful than) the standard Python interactive interpreter loop. For a " @@ -110574,34 +112847,34 @@ msgid "" msgstr "" # e0d8cfb7e2a54e3bad7202822d15eaac -#: ../src/Doc/library/traceback.rst:165 +#: library/traceback.rst:165 msgid "" "The following example demonstrates the different ways to print and format " "the exception and traceback::" msgstr "" # 812c7dbc015a435bab5a52c94a9f9425 -#: ../src/Doc/library/traceback.rst:201 +#: library/traceback.rst:201 msgid "The output for the example would look similar to this::" msgstr "" -#: ../src/Doc/library/traceback.rst:240 +#: library/traceback.rst:240 msgid "" "The following example shows the different ways to print and format the " "stack::" msgstr "" -#: ../src/Doc/library/traceback.rst:266 +#: library/traceback.rst:266 msgid "This last example demonstrates the final few formatting functions:" msgstr "" # 8f3c34bff1344e45be48591b63e86810 -#: ../src/Doc/library/ttk.rst:2 +#: library/ttk.rst:2 msgid ":mod:`ttk` --- Tk themed widgets" msgstr "" # 10aa2b1d606f418fa4c2b280e0acf0dd -#: ../src/Doc/library/ttk.rst:11 +#: library/ttk.rst:11 msgid "" "The :mod:`ttk` module provides access to the Tk themed widget set, which has " "been introduced in Tk 8.5. If Python is not compiled against Tk 8.5 code may " @@ -110612,43 +112885,42 @@ msgid "" msgstr "" # 44b77c544b38421b9c9828e12f530b30 -#: ../src/Doc/library/ttk.rst:18 +#: library/ttk.rst:18 msgid "" "The basic idea of :mod:`ttk` is to separate, to the extent possible, the " "code implementing a widget's behavior from the code implementing its " "appearance." msgstr "" -# c009724fc2ed4c8fa75d55fe330f286d -#: ../src/Doc/library/ttk.rst:23 -msgid "`Tk Widget Styling Support <http://www.tcl.tk/cgi-bin/tct/tip/48>`_" +#: library/ttk.rst:24 +msgid "Tk Widget Styling Support" msgstr "" # 5a94651ff0644f1fa1f72aa8dc34834e -#: ../src/Doc/library/ttk.rst:25 +#: library/ttk.rst:25 msgid "The document which brought up theming support for Tk" msgstr "" -#: ../src/Doc/library/ttk.rst:29 +#: library/ttk.rst:29 msgid "Using Ttk" msgstr "" -#: ../src/Doc/library/ttk.rst:31 +#: library/ttk.rst:31 msgid "To start using Ttk, import its module::" msgstr "" # 08a4d9c10f5c4898aa3eb737c477e2b5 -#: ../src/Doc/library/ttk.rst:35 +#: library/ttk.rst:35 msgid "But code like this::" msgstr "" # eb031073f2e14e03a02ce6e1a600b66b -#: ../src/Doc/library/ttk.rst:39 +#: library/ttk.rst:39 msgid "may optionally want to use this::" msgstr "" # 87183ec4b45548e3b9a7ae8ccb439586 -#: ../src/Doc/library/ttk.rst:44 +#: library/ttk.rst:44 msgid "" "And then several :mod:`ttk` widgets (:class:`Button`, :class:`Checkbutton`, :" "class:`Entry`, :class:`Frame`, :class:`Label`, :class:`LabelFrame`, :class:" @@ -110657,7 +112929,7 @@ msgid "" msgstr "" # 275a0b0edc19433baf647166c35d322c -#: ../src/Doc/library/ttk.rst:49 +#: library/ttk.rst:49 msgid "" "This has the direct benefit of using the new widgets, giving better look & " "feel across platforms, but be aware that they are not totally compatible. " @@ -110666,26 +112938,23 @@ msgid "" "`ttk.Style` to achieve the same (or better) styling." msgstr "" -# fcf1b4b68e494c59829a2d2bc6076610 -#: ../src/Doc/library/ttk.rst:57 -msgid "" -"`Converting existing applications to use the Tile widgets <http://tktable." -"sourceforge.net/tile/doc/converting.txt>`_" +#: library/ttk.rst:58 +msgid "Converting existing applications to use the Tile widgets" msgstr "" # 6c59e1b9ee794bc783fa6db1f6856104 -#: ../src/Doc/library/ttk.rst:58 +#: library/ttk.rst:58 msgid "" "A text which talks in Tcl terms about differences typically found when " "converting applications to use the new widgets." msgstr "" -#: ../src/Doc/library/ttk.rst:63 +#: library/ttk.rst:63 msgid "Ttk Widgets" msgstr "" # 89ad052d413a41bfb6ec74bb7887974d -#: ../src/Doc/library/ttk.rst:65 +#: library/ttk.rst:65 msgid "" "Ttk comes with 17 widgets, 11 of which already exist in Tkinter: :class:" "`Button`, :class:`Checkbutton`, :class:`Entry`, :class:`Frame`, :class:" @@ -110697,50 +112966,50 @@ msgid "" msgstr "" # 15b26ada2c5e45ef86d3f0249a197612 -#: ../src/Doc/library/ttk.rst:74 +#: library/ttk.rst:74 msgid "" "As said previously, you will notice changes in look-and-feel as well in the " "styling code. To demonstrate the latter, a very simple example is shown " "below." msgstr "" -#: ../src/Doc/library/ttk.rst:77 +#: library/ttk.rst:77 msgid "Tk code::" msgstr "" # f670dd16156f4793a0481e1b88d9c1da -#: ../src/Doc/library/ttk.rst:83 +#: library/ttk.rst:83 msgid "Corresponding Ttk code::" msgstr "" # 86f2a4698b914f45a165282986b713fc -#: ../src/Doc/library/ttk.rst:91 +#: library/ttk.rst:91 msgid "" "For more information about TtkStyling_ read the :class:`Style` class " "documentation." msgstr "" -#: ../src/Doc/library/ttk.rst:95 +#: library/ttk.rst:95 msgid "Widget" msgstr "" -#: ../src/Doc/library/ttk.rst:97 +#: library/ttk.rst:97 msgid "" ":class:`ttk.Widget` defines standard options and methods supported by Tk " "themed widgets and is not supposed to be directly instantiated." msgstr "" -#: ../src/Doc/library/ttk.rst:102 +#: library/ttk.rst:102 msgid "Standard Options" msgstr "" # 9db2698cf0224057ad1062fd95df129a -#: ../src/Doc/library/ttk.rst:104 +#: library/ttk.rst:104 msgid "All the :mod:`ttk` widgets accept the following options:" msgstr "" # b6c86c35b30f40f9babfb501608c836d -#: ../src/Doc/library/ttk.rst:109 +#: library/ttk.rst:109 msgid "" "Specifies the window class. The class is used when querying the option " "database for the window's other options, to determine the default bindtags " @@ -110749,18 +113018,18 @@ msgid "" msgstr "" # 1947183e8ed443a88a8f09cfb4fe5222 -#: ../src/Doc/library/ttk.rst:116 +#: library/ttk.rst:116 msgid "" "Specifies the mouse cursor to be used for the widget. If set to the empty " "string (the default), the cursor is inherited from the parent widget." msgstr "" -#: ../src/Doc/library/ttk.rst:120 +#: library/ttk.rst:120 msgid "takefocus" msgstr "" # ad1ddb8e69014d11822453a6db847edc -#: ../src/Doc/library/ttk.rst:120 +#: library/ttk.rst:120 msgid "" "Determines whether the window accepts the focus during keyboard traversal. " "0, 1 or an empty string is returned. If 0, the window should be skipped " @@ -110770,104 +113039,103 @@ msgid "" "window." msgstr "" -#: ../src/Doc/library/ttk.rst:128 +#: library/ttk.rst:128 msgid "style" msgstr "" -#: ../src/Doc/library/ttk.rst:128 +#: library/ttk.rst:128 msgid "May be used to specify a custom widget style." msgstr "" -#: ../src/Doc/library/ttk.rst:133 +#: library/ttk.rst:133 msgid "Scrollable Widget Options" msgstr "" -#: ../src/Doc/library/ttk.rst:135 +#: library/ttk.rst:135 msgid "" "The following options are supported by widgets that are controlled by a " "scrollbar." msgstr "" -#: ../src/Doc/library/ttk.rst:141 +#: library/ttk.rst:141 msgid "xscrollcommand" msgstr "" -#: ../src/Doc/library/ttk.rst:141 +#: library/ttk.rst:141 msgid "Used to communicate with horizontal scrollbars." msgstr "" # e95422cdae004da4a8630d4e64bfd5db -#: ../src/Doc/library/ttk.rst:143 +#: library/ttk.rst:143 msgid "" "When the view in the widget's window changes, the widget will generate a Tcl " "command based on the scrollcommand." msgstr "" # 0cebd8eaaf1d47fabb88bb16d7b1d954 -#: ../src/Doc/library/ttk.rst:146 +#: library/ttk.rst:146 msgid "" "Usually this option consists of the :meth:`Scrollbar.set` method of some " "scrollbar. This will cause the scrollbar to be updated whenever the view in " "the window changes." msgstr "" -#: ../src/Doc/library/ttk.rst:152 +#: library/ttk.rst:152 msgid "yscrollcommand" msgstr "" # d9ccd48c4b6b4b51a963d1451c61cfd5 -#: ../src/Doc/library/ttk.rst:152 +#: library/ttk.rst:152 msgid "" "Used to communicate with vertical scrollbars. For more information, see " "above." msgstr "" -#: ../src/Doc/library/ttk.rst:158 +#: library/ttk.rst:158 msgid "Label Options" msgstr "" -#: ../src/Doc/library/ttk.rst:160 +#: library/ttk.rst:160 msgid "" "The following options are supported by labels, buttons and other button-like " "widgets." msgstr "" -#: ../src/Doc/library/ttk.rst:169 ../src/Doc/library/ttk.rst:427 -#: ../src/Doc/library/ttk.rst:762 +#: library/ttk.rst:169 library/ttk.rst:427 library/ttk.rst:762 msgid "text" msgstr "" -#: ../src/Doc/library/ttk.rst:169 +#: library/ttk.rst:169 msgid "Specifies a text string to be displayed inside the widget." msgstr "" -#: ../src/Doc/library/ttk.rst:171 ../src/Doc/library/ttk.rst:330 +#: library/ttk.rst:171 library/ttk.rst:330 msgid "textvariable" msgstr "" -#: ../src/Doc/library/ttk.rst:171 +#: library/ttk.rst:171 msgid "" "Specifies a name whose value will be used in place of the text option " "resource." msgstr "" -#: ../src/Doc/library/ttk.rst:174 ../src/Doc/library/ttk.rst:436 +#: library/ttk.rst:174 library/ttk.rst:436 msgid "underline" msgstr "" -#: ../src/Doc/library/ttk.rst:174 +#: library/ttk.rst:174 msgid "" "If set, specifies the index (0-based) of a character to underline in the " "text string. The underline character is used for mnemonic activation." msgstr "" -#: ../src/Doc/library/ttk.rst:178 ../src/Doc/library/ttk.rst:429 -#: ../src/Doc/library/ttk.rst:764 ../src/Doc/library/ttk.rst:794 +#: library/ttk.rst:178 library/ttk.rst:429 library/ttk.rst:764 +#: library/ttk.rst:794 msgid "image" msgstr "" # a5a1efa605514d32bd3849720dfda478 -#: ../src/Doc/library/ttk.rst:178 +#: library/ttk.rst:178 msgid "" "Specifies an image to display. This is a list of 1 or more elements. The " "first element is the default image name. The rest of the list is a sequence " @@ -110876,184 +113144,183 @@ msgid "" "combination of states. All images in the list should have the same size." msgstr "" -#: ../src/Doc/library/ttk.rst:186 ../src/Doc/library/ttk.rst:432 +#: library/ttk.rst:186 library/ttk.rst:432 msgid "compound" msgstr "" # 9206418fc51b4d16909f980db792e5f2 -#: ../src/Doc/library/ttk.rst:186 +#: library/ttk.rst:186 msgid "" "Specifies how to display the image relative to the text, in the case both " "text and image options are present. Valid values are:" msgstr "" -#: ../src/Doc/library/ttk.rst:190 +#: library/ttk.rst:190 msgid "text: display text only" msgstr "" -#: ../src/Doc/library/ttk.rst:191 +#: library/ttk.rst:191 msgid "image: display image only" msgstr "" -#: ../src/Doc/library/ttk.rst:192 +#: library/ttk.rst:192 msgid "" "top, bottom, left, right: display image above, below, left of, or right of " "the text, respectively." msgstr "" -#: ../src/Doc/library/ttk.rst:194 +#: library/ttk.rst:194 msgid "none: the default. display the image if present, otherwise the text." msgstr "" # 54a7adbdd55245b78003b8122b6add0f -#: ../src/Doc/library/ttk.rst:197 +#: library/ttk.rst:197 msgid "" "If greater than zero, specifies how much space, in character widths, to " "allocate for the text label; if less than zero, specifies a minimum width. " "If zero or unspecified, the natural width of the text label is used." msgstr "" -#: ../src/Doc/library/ttk.rst:205 +#: library/ttk.rst:205 msgid "Compatibility Options" msgstr "" -#: ../src/Doc/library/ttk.rst:210 ../src/Doc/library/ttk.rst:323 -#: ../src/Doc/library/ttk.rst:413 +#: library/ttk.rst:210 library/ttk.rst:323 library/ttk.rst:413 msgid "state" msgstr "" -#: ../src/Doc/library/ttk.rst:210 +#: library/ttk.rst:210 msgid "" "May be set to \"normal\" or \"disabled\" to control the \"disabled\" state " "bit. This is a write-only option: setting it changes the widget state, but " "the :meth:`Widget.state` method does not affect this option." msgstr "" -#: ../src/Doc/library/ttk.rst:217 +#: library/ttk.rst:217 msgid "Widget States" msgstr "" -#: ../src/Doc/library/ttk.rst:219 +#: library/ttk.rst:219 msgid "The widget state is a bitmap of independent state flags." msgstr "" -#: ../src/Doc/library/ttk.rst:224 +#: library/ttk.rst:224 msgid "active" msgstr "" # d47c715aeed9494fb48c50613100b01d -#: ../src/Doc/library/ttk.rst:224 +#: library/ttk.rst:224 msgid "" "The mouse cursor is over the widget and pressing a mouse button will cause " "some action to occur." msgstr "" -#: ../src/Doc/library/ttk.rst:227 +#: library/ttk.rst:227 msgid "disabled" msgstr "" # be9330af3e684de68ec6df25de2f1d15 -#: ../src/Doc/library/ttk.rst:227 +#: library/ttk.rst:227 msgid "Widget is disabled under program control." msgstr "" -#: ../src/Doc/library/ttk.rst:229 +#: library/ttk.rst:229 msgid "focus" msgstr "" # 90f466992b84425b8c94147b52f5c7f6 -#: ../src/Doc/library/ttk.rst:229 +#: library/ttk.rst:229 msgid "Widget has keyboard focus." msgstr "" -#: ../src/Doc/library/ttk.rst:231 +#: library/ttk.rst:231 msgid "pressed" msgstr "" # eb05e35f55924c3eb79f40160a16a3de -#: ../src/Doc/library/ttk.rst:231 +#: library/ttk.rst:231 msgid "Widget is being pressed." msgstr "" -#: ../src/Doc/library/ttk.rst:233 +#: library/ttk.rst:233 msgid "selected" msgstr "" # c731e738a0cc40e0a619a6f35998be81 -#: ../src/Doc/library/ttk.rst:233 +#: library/ttk.rst:233 msgid "" "\"On\", \"true\", or \"current\" for things like Checkbuttons and " "radiobuttons." msgstr "" -#: ../src/Doc/library/ttk.rst:236 ../src/Doc/library/ttk.rst:790 +#: library/ttk.rst:236 library/ttk.rst:790 msgid "background" msgstr "" # 5ee5a2a01ec14d59ae0de77b0306ea76 -#: ../src/Doc/library/ttk.rst:236 +#: library/ttk.rst:236 msgid "" "Windows and Mac have a notion of an \"active\" or foreground window. The " "*background* state is set for widgets in a background window, and cleared " "for those in the foreground window." msgstr "" -#: ../src/Doc/library/ttk.rst:241 +#: library/ttk.rst:241 msgid "readonly" msgstr "" # 66f8876ccea7455e8996db8b388e7166 -#: ../src/Doc/library/ttk.rst:241 +#: library/ttk.rst:241 msgid "Widget should not allow user modification." msgstr "" -#: ../src/Doc/library/ttk.rst:243 +#: library/ttk.rst:243 msgid "alternate" msgstr "" # 641fbf3b2f914d238d6a493f2804dcd4 -#: ../src/Doc/library/ttk.rst:243 +#: library/ttk.rst:243 msgid "A widget-specific alternate display format." msgstr "" -#: ../src/Doc/library/ttk.rst:245 +#: library/ttk.rst:245 msgid "invalid" msgstr "" # e943631d2401422183c174dadf1726ba -#: ../src/Doc/library/ttk.rst:245 +#: library/ttk.rst:245 msgid "The widget's value is invalid." msgstr "" -#: ../src/Doc/library/ttk.rst:248 +#: library/ttk.rst:248 msgid "" "A state specification is a sequence of state names, optionally prefixed with " "an exclamation point indicating that the bit is off." msgstr "" -#: ../src/Doc/library/ttk.rst:253 +#: library/ttk.rst:253 msgid "ttk.Widget" msgstr "" # cf3920d6a85d4676911436d73fa4fa1d -#: ../src/Doc/library/ttk.rst:255 +#: library/ttk.rst:255 msgid "" "Besides the methods described below, the :class:`ttk.Widget` class supports " "the :meth:`Tkinter.Widget.cget` and :meth:`Tkinter.Widget.configure` methods." msgstr "" -#: ../src/Doc/library/ttk.rst:262 +#: library/ttk.rst:262 msgid "" "Returns the name of the element at position *x* *y*, or the empty string if " "the point does not lie within any element." msgstr "" -#: ../src/Doc/library/ttk.rst:265 +#: library/ttk.rst:265 msgid "*x* and *y* are pixel coordinates relative to the widget." msgstr "" # 52a6dfc4bd5b4b51b6ce70d665875dbf -#: ../src/Doc/library/ttk.rst:270 +#: library/ttk.rst:270 msgid "" "Test the widget's state. If a callback is not specified, returns ``True`` if " "the widget state matches *statespec* and ``False`` otherwise. If callback is " @@ -111061,7 +113328,7 @@ msgid "" msgstr "" # b785e152db324951810aa50a1d36b2fa -#: ../src/Doc/library/ttk.rst:278 +#: library/ttk.rst:278 msgid "" "Modify or read widget state. If *statespec* is specified, sets the widget " "state accordingly and returns a new *statespec* indicating which flags were " @@ -111069,22 +113336,22 @@ msgid "" "state flags." msgstr "" -#: ../src/Doc/library/ttk.rst:283 +#: library/ttk.rst:283 msgid "*statespec* will usually be a list or a tuple." msgstr "" -#: ../src/Doc/library/ttk.rst:287 +#: library/ttk.rst:287 msgid "Combobox" msgstr "" -#: ../src/Doc/library/ttk.rst:289 +#: library/ttk.rst:289 msgid "" "The :class:`ttk.Combobox` widget combines a text field with a pop-down list " "of values. This widget is a subclass of :class:`Entry`." msgstr "" # 6295e6dbb2c04a26b27a5413628d4f03 -#: ../src/Doc/library/ttk.rst:292 +#: library/ttk.rst:292 msgid "" "Besides the methods inherited from :class:`Widget` (:meth:`Widget.cget`, :" "meth:`Widget.configure`, :meth:`Widget.identify`, :meth:`Widget.instate` " @@ -111095,38 +113362,38 @@ msgid "" msgstr "" # 80db82ec3a0c42579d9a8fbb01380ea6 -#: ../src/Doc/library/ttk.rst:304 +#: library/ttk.rst:304 msgid "This widget accepts the following options:" msgstr "" -#: ../src/Doc/library/ttk.rst:309 +#: library/ttk.rst:309 msgid "exportselection" msgstr "" # 4996afd502854fae9f0ca6b038acda8b -#: ../src/Doc/library/ttk.rst:309 +#: library/ttk.rst:309 msgid "" "Boolean value. If set, the widget selection is linked to the Window Manager " "selection (which can be returned by invoking :meth:`Misc.selection_get`, for " "example)." msgstr "" -#: ../src/Doc/library/ttk.rst:313 +#: library/ttk.rst:313 msgid "" "Specifies how the text is aligned within the widget. One of \"left\", " "\"center\", or \"right\"." msgstr "" -#: ../src/Doc/library/ttk.rst:316 +#: library/ttk.rst:316 msgid "Specifies the height of the pop-down listbox, in rows." msgstr "" -#: ../src/Doc/library/ttk.rst:318 +#: library/ttk.rst:318 msgid "postcommand" msgstr "" # b2258925e5f6459d9773e239a73275fe -#: ../src/Doc/library/ttk.rst:318 +#: library/ttk.rst:318 msgid "" "A script (possibly registered with :meth:`Misc.register`) that is called " "immediately before displaying the values. It may specify which values to " @@ -111134,7 +113401,7 @@ msgid "" msgstr "" # 50ab9787afc545eba411cb98b53abe35 -#: ../src/Doc/library/ttk.rst:323 +#: library/ttk.rst:323 msgid "" "One of \"normal\", \"readonly\", or \"disabled\". In the \"readonly\" state, " "the value may not be edited directly, and the user can only select one of " @@ -111143,89 +113410,82 @@ msgid "" msgstr "" # 38ecb203e376471bb4baf4e1777070a3 -#: ../src/Doc/library/ttk.rst:330 +#: library/ttk.rst:330 msgid "" "Specifies a name whose value is linked to the widget value. Whenever the " "value associated with that name changes, the widget value is updated, and " "vice versa. See :class:`Tkinter.StringVar`." msgstr "" -#: ../src/Doc/library/ttk.rst:335 ../src/Doc/library/ttk.rst:766 -#, fuzzy -msgid "values" -msgstr "valeur" - -#: ../src/Doc/library/ttk.rst:335 +#: library/ttk.rst:335 msgid "Specifies the list of values to display in the drop-down listbox." msgstr "" -#: ../src/Doc/library/ttk.rst:338 +#: library/ttk.rst:338 msgid "" "Specifies an integer value indicating the desired width of the entry window, " "in average-size characters of the widget's font." msgstr "" -#: ../src/Doc/library/ttk.rst:345 +#: library/ttk.rst:345 msgid "Virtual events" msgstr "" # a44f691ab2e64dee8c4e4cabf3e7f213 -#: ../src/Doc/library/ttk.rst:347 +#: library/ttk.rst:347 msgid "" "The combobox widget generates a **<<ComboboxSelected>>** virtual event when " "the user selects an element from the list of values." msgstr "" -#: ../src/Doc/library/ttk.rst:352 +#: library/ttk.rst:352 msgid "ttk.Combobox" msgstr "" -#: ../src/Doc/library/ttk.rst:358 +#: library/ttk.rst:358 msgid "" "If *newindex* is specified, sets the combobox value to the element position " "*newindex*. Otherwise, returns the index of the current value or -1 if the " "current value is not in the values list." msgstr "" -#: ../src/Doc/library/ttk.rst:365 +#: library/ttk.rst:365 msgid "Returns the current value of the combobox." msgstr "" -#: ../src/Doc/library/ttk.rst:370 +#: library/ttk.rst:370 msgid "Sets the value of the combobox to *value*." msgstr "" -#: ../src/Doc/library/ttk.rst:374 +#: library/ttk.rst:374 msgid "Notebook" msgstr "" # 2a69ca40f7bb4c359e4a079e17764a82 -#: ../src/Doc/library/ttk.rst:376 +#: library/ttk.rst:376 msgid "" "The Ttk Notebook widget manages a collection of windows and displays a " "single one at a time. Each child window is associated with a tab, which the " "user may select to change the currently-displayed window." msgstr "" -#: ../src/Doc/library/ttk.rst:384 ../src/Doc/library/ttk.rst:570 -#: ../src/Doc/library/ttk.rst:705 +#: library/ttk.rst:384 library/ttk.rst:570 library/ttk.rst:705 msgid "This widget accepts the following specific options:" msgstr "" -#: ../src/Doc/library/ttk.rst:389 +#: library/ttk.rst:389 msgid "" "If present and greater than zero, specifies the desired height of the pane " "area (not including internal padding or tabs). Otherwise, the maximum height " "of all panes is used." msgstr "" -#: ../src/Doc/library/ttk.rst:393 ../src/Doc/library/ttk.rst:423 -#: ../src/Doc/library/ttk.rst:725 +#: library/ttk.rst:393 library/ttk.rst:423 library/ttk.rst:725 msgid "padding" msgstr "" # 89c228be2aa74263883833b611c6ff04 -#: ../src/Doc/library/ttk.rst:393 +#: library/ttk.rst:393 msgid "" "Specifies the amount of extra space to add around the outside of the " "notebook. The padding is a list of up to four length specifications: left " @@ -111234,32 +113494,32 @@ msgid "" msgstr "" # 2bff21a4c901480fa3feb668579a2a22 -#: ../src/Doc/library/ttk.rst:399 +#: library/ttk.rst:399 msgid "" "If present and greater than zero, specifies the desired width of the pane " "area (not including internal padding). Otherwise, the maximum width of all " "panes is used." msgstr "" -#: ../src/Doc/library/ttk.rst:406 +#: library/ttk.rst:406 msgid "Tab Options" msgstr "" -#: ../src/Doc/library/ttk.rst:408 +#: library/ttk.rst:408 msgid "There are also specific options for tabs:" msgstr "" -#: ../src/Doc/library/ttk.rst:413 +#: library/ttk.rst:413 msgid "" "Either \"normal\", \"disabled\" or \"hidden\". If \"disabled\", then the tab " "is not selectable. If \"hidden\", then the tab is not shown." msgstr "" -#: ../src/Doc/library/ttk.rst:417 +#: library/ttk.rst:417 msgid "sticky" msgstr "" -#: ../src/Doc/library/ttk.rst:417 +#: library/ttk.rst:417 msgid "" "Specifies how the child window is positioned within the pane area. Value is " "a string containing zero or more of the characters \"n\", \"s\", \"e\" or \"w" @@ -111267,209 +113527,211 @@ msgid "" "window will stick to, as per the :meth:`grid` geometry manager." msgstr "" -#: ../src/Doc/library/ttk.rst:423 +#: library/ttk.rst:423 msgid "" "Specifies the amount of extra space to add between the notebook and this " "pane. Syntax is the same as for the option padding used by this widget." msgstr "" -#: ../src/Doc/library/ttk.rst:427 +#: library/ttk.rst:427 msgid "Specifies a text to be displayed in the tab." msgstr "" -#: ../src/Doc/library/ttk.rst:429 +#: library/ttk.rst:429 msgid "" "Specifies an image to display in the tab. See the option image described in :" "class:`Widget`." msgstr "" # 87cafaef905749d2aef80760adfa1744 -#: ../src/Doc/library/ttk.rst:432 +#: library/ttk.rst:432 msgid "" "Specifies how to display the image relative to the text, in the case both " "text and image options are present. See `Label Options`_ for legal values." msgstr "" -#: ../src/Doc/library/ttk.rst:436 +#: library/ttk.rst:436 msgid "" "Specifies the index (0-based) of a character to underline in the text " "string. The underlined character is used for mnemonic activation if :meth:" "`Notebook.enable_traversal` is called." msgstr "" -#: ../src/Doc/library/ttk.rst:444 +#: library/ttk.rst:444 msgid "Tab Identifiers" msgstr "" # 46bc4f7ddaac4929a65b89d94374e984 -#: ../src/Doc/library/ttk.rst:446 +#: library/ttk.rst:446 msgid "" "The *tab_id* present in several methods of :class:`ttk.Notebook` may take " "any of the following forms:" msgstr "" # f503daf6257d41c8b73ae851b83a63b4 -#: ../src/Doc/library/ttk.rst:449 +#: library/ttk.rst:449 msgid "An integer between zero and the number of tabs." msgstr "" # 6bf93559b43c4fbb8e8354730ba07ad9 -#: ../src/Doc/library/ttk.rst:450 +#: library/ttk.rst:450 msgid "The name of a child window." msgstr "" # 4d32087f5fb940c7885ea852c7ee1dab -#: ../src/Doc/library/ttk.rst:451 +#: library/ttk.rst:451 msgid "" "A positional specification of the form \"@x,y\", which identifies the tab." msgstr "" # 7dcbf2a20be14078a95359f3c0a914ec -#: ../src/Doc/library/ttk.rst:452 +#: library/ttk.rst:452 msgid "" "The literal string \"current\", which identifies the currently-selected tab." msgstr "" # 11dde4fb3aac448782f2960a440e637f -#: ../src/Doc/library/ttk.rst:453 +#: library/ttk.rst:453 msgid "" "The literal string \"end\", which returns the number of tabs (only valid " "for :meth:`Notebook.index`)." msgstr "" -#: ../src/Doc/library/ttk.rst:458 ../src/Doc/library/ttk.rst:824 +#: library/ttk.rst:458 library/ttk.rst:824 msgid "Virtual Events" msgstr "" -#: ../src/Doc/library/ttk.rst:460 +#: library/ttk.rst:460 msgid "" "This widget generates a **<<NotebookTabChanged>>** virtual event after a new " "tab is selected." msgstr "" -#: ../src/Doc/library/ttk.rst:465 +#: library/ttk.rst:465 msgid "ttk.Notebook" msgstr "" -#: ../src/Doc/library/ttk.rst:471 +#: library/ttk.rst:471 msgid "Adds a new tab to the notebook." msgstr "" -#: ../src/Doc/library/ttk.rst:473 +#: library/ttk.rst:473 msgid "" "If window is currently managed by the notebook but hidden, it is restored to " "its previous position." msgstr "" -#: ../src/Doc/library/ttk.rst:476 ../src/Doc/library/ttk.rst:514 +#: library/ttk.rst:476 library/ttk.rst:514 msgid "See `Tab Options`_ for the list of available options." msgstr "" -#: ../src/Doc/library/ttk.rst:481 +#: library/ttk.rst:481 msgid "" "Removes the tab specified by *tab_id*, unmaps and unmanages the associated " "window." msgstr "" -#: ../src/Doc/library/ttk.rst:487 +#: library/ttk.rst:487 msgid "Hides the tab specified by *tab_id*." msgstr "" -#: ../src/Doc/library/ttk.rst:489 +#: library/ttk.rst:489 msgid "" "The tab will not be displayed, but the associated window remains managed by " "the notebook and its configuration remembered. Hidden tabs may be restored " "with the :meth:`add` command." msgstr "" -#: ../src/Doc/library/ttk.rst:496 +#: library/ttk.rst:496 msgid "" "Returns the name of the tab element at position *x*, *y*, or the empty " "string if none." msgstr "" -#: ../src/Doc/library/ttk.rst:502 +#: library/ttk.rst:502 msgid "" "Returns the numeric index of the tab specified by *tab_id*, or the total " "number of tabs if *tab_id* is the string \"end\"." msgstr "" -#: ../src/Doc/library/ttk.rst:508 +#: library/ttk.rst:508 msgid "Inserts a pane at the specified position." msgstr "" -#: ../src/Doc/library/ttk.rst:510 +#: library/ttk.rst:510 msgid "" "*pos* is either the string \"end\", an integer index, or the name of a " "managed child. If *child* is already managed by the notebook, moves it to " "the specified position." msgstr "" -#: ../src/Doc/library/ttk.rst:519 +#: library/ttk.rst:519 msgid "Selects the specified *tab_id*." msgstr "" -#: ../src/Doc/library/ttk.rst:521 +#: library/ttk.rst:521 msgid "" "The associated child window will be displayed, and the previously-selected " "window (if different) is unmapped. If *tab_id* is omitted, returns the " "widget name of the currently selected pane." msgstr "" -#: ../src/Doc/library/ttk.rst:528 +#: library/ttk.rst:528 msgid "Query or modify the options of the specific *tab_id*." msgstr "" -#: ../src/Doc/library/ttk.rst:530 +#: library/ttk.rst:530 msgid "" "If *kw* is not given, returns a dictionary of the tab option values. If " "*option* is specified, returns the value of that *option*. Otherwise, sets " "the options to the corresponding values." msgstr "" -#: ../src/Doc/library/ttk.rst:537 +#: library/ttk.rst:537 msgid "Returns a list of windows managed by the notebook." msgstr "" -#: ../src/Doc/library/ttk.rst:542 +#: library/ttk.rst:542 msgid "" "Enable keyboard traversal for a toplevel window containing this notebook." msgstr "" -#: ../src/Doc/library/ttk.rst:544 +#: library/ttk.rst:544 msgid "" "This will extend the bindings for the toplevel window containing the " "notebook as follows:" msgstr "" -#: ../src/Doc/library/ttk.rst:547 -msgid "Control-Tab: selects the tab following the currently selected one." -msgstr "" - -#: ../src/Doc/library/ttk.rst:548 +#: library/ttk.rst:547 msgid "" -"Shift-Control-Tab: selects the tab preceding the currently selected one." +":kbd:`Control-Tab`: selects the tab following the currently selected one." msgstr "" -#: ../src/Doc/library/ttk.rst:549 +#: library/ttk.rst:548 msgid "" -"Alt-K: where K is the mnemonic (underlined) character of any tab, will " -"select that tab." +":kbd:`Shift-Control-Tab`: selects the tab preceding the currently selected " +"one." msgstr "" -#: ../src/Doc/library/ttk.rst:552 +#: library/ttk.rst:549 +msgid "" +":kbd:`Alt-K`: where *K* is the mnemonic (underlined) character of any tab, " +"will select that tab." +msgstr "" + +#: library/ttk.rst:552 msgid "" "Multiple notebooks in a single toplevel may be enabled for traversal, " "including nested notebooks. However, notebook traversal only works properly " "if all panes have the notebook they are in as master." msgstr "" -#: ../src/Doc/library/ttk.rst:558 +#: library/ttk.rst:558 msgid "Progressbar" msgstr "" # 675ae99b828d42e3b82d95dc271ea11a -#: ../src/Doc/library/ttk.rst:560 +#: library/ttk.rst:560 msgid "" "The :class:`ttk.Progressbar` widget shows the status of a long-running " "operation. It can operate in two modes: determinate mode shows the amount " @@ -111478,43 +113740,39 @@ msgid "" "happening." msgstr "" -#: ../src/Doc/library/ttk.rst:575 ../src/Doc/library/ttk.rst:644 +#: library/ttk.rst:575 library/ttk.rst:644 msgid "orient" msgstr "" -#: ../src/Doc/library/ttk.rst:575 +#: library/ttk.rst:575 msgid "" "One of \"horizontal\" or \"vertical\". Specifies the orientation of the " "progress bar." msgstr "" -#: ../src/Doc/library/ttk.rst:578 +#: library/ttk.rst:578 msgid "length" msgstr "" -#: ../src/Doc/library/ttk.rst:578 +#: library/ttk.rst:578 msgid "" "Specifies the length of the long axis of the progress bar (width if " "horizontal, height if vertical)." msgstr "" -#: ../src/Doc/library/ttk.rst:581 +#: library/ttk.rst:581 msgid "One of \"determinate\" or \"indeterminate\"." msgstr "" -#: ../src/Doc/library/ttk.rst:583 +#: library/ttk.rst:583 msgid "maximum" msgstr "" -#: ../src/Doc/library/ttk.rst:583 +#: library/ttk.rst:583 msgid "A number specifying the maximum value. Defaults to 100." msgstr "" -#: ../src/Doc/library/ttk.rst:585 -msgid "value" -msgstr "valeur" - -#: ../src/Doc/library/ttk.rst:585 +#: library/ttk.rst:585 msgid "" "The current value of the progress bar. In \"determinate\" mode, this " "represents the amount of work completed. In \"indeterminate\" mode, it is " @@ -111522,22 +113780,22 @@ msgid "" "\"cycle\" when its value increases by *maximum*." msgstr "" -#: ../src/Doc/library/ttk.rst:591 +#: library/ttk.rst:591 msgid "variable" msgstr "" -#: ../src/Doc/library/ttk.rst:591 +#: library/ttk.rst:591 msgid "" "A name which is linked to the option value. If specified, the value of the " "progress bar is automatically set to the value of this name whenever the " "latter is modified." msgstr "" -#: ../src/Doc/library/ttk.rst:595 +#: library/ttk.rst:595 msgid "phase" msgstr "" -#: ../src/Doc/library/ttk.rst:595 +#: library/ttk.rst:595 msgid "" "Read-only option. The widget periodically increments the value of this " "option whenever its value is greater than 0 and, in determinate mode, less " @@ -111545,104 +113803,104 @@ msgid "" "additional animation effects." msgstr "" -#: ../src/Doc/library/ttk.rst:603 +#: library/ttk.rst:603 msgid "ttk.Progressbar" msgstr "" -#: ../src/Doc/library/ttk.rst:609 +#: library/ttk.rst:609 msgid "" "Begin autoincrement mode: schedules a recurring timer event that calls :meth:" "`Progressbar.step` every *interval* milliseconds. If omitted, *interval* " "defaults to 50 milliseconds." msgstr "" -#: ../src/Doc/library/ttk.rst:616 +#: library/ttk.rst:616 msgid "Increments the progress bar's value by *amount*." msgstr "" -#: ../src/Doc/library/ttk.rst:618 +#: library/ttk.rst:618 msgid "*amount* defaults to 1.0 if omitted." msgstr "" -#: ../src/Doc/library/ttk.rst:623 +#: library/ttk.rst:623 msgid "" "Stop autoincrement mode: cancels any recurring timer event initiated by :" "meth:`Progressbar.start` for this progress bar." msgstr "" -#: ../src/Doc/library/ttk.rst:628 +#: library/ttk.rst:628 msgid "Separator" msgstr "" -#: ../src/Doc/library/ttk.rst:630 +#: library/ttk.rst:630 msgid "" "The :class:`ttk.Separator` widget displays a horizontal or vertical " "separator bar." msgstr "" -#: ../src/Doc/library/ttk.rst:633 +#: library/ttk.rst:633 msgid "" "It has no other methods besides the ones inherited from :class:`ttk.Widget`." msgstr "" -#: ../src/Doc/library/ttk.rst:639 +#: library/ttk.rst:639 msgid "This widget accepts the following specific option:" msgstr "" -#: ../src/Doc/library/ttk.rst:644 +#: library/ttk.rst:644 msgid "" "One of \"horizontal\" or \"vertical\". Specifies the orientation of the " "separator." msgstr "" -#: ../src/Doc/library/ttk.rst:650 +#: library/ttk.rst:650 msgid "Sizegrip" msgstr "" -#: ../src/Doc/library/ttk.rst:652 +#: library/ttk.rst:652 msgid "" "The :class:`ttk.Sizegrip` widget (also known as a grow box) allows the user " "to resize the containing toplevel window by pressing and dragging the grip." msgstr "" -#: ../src/Doc/library/ttk.rst:655 +#: library/ttk.rst:655 msgid "" "This widget has neither specific options nor specific methods, besides the " "ones inherited from :class:`ttk.Widget`." msgstr "" -#: ../src/Doc/library/ttk.rst:660 +#: library/ttk.rst:660 msgid "Platform-specific notes" msgstr "" # 227002545f8b4b74b7746aea45e4d806 -#: ../src/Doc/library/ttk.rst:662 +#: library/ttk.rst:662 msgid "" "On Mac OS X, toplevel windows automatically include a built-in size grip by " "default. Adding a :class:`Sizegrip` is harmless, since the built-in grip " "will just mask the widget." msgstr "" -#: ../src/Doc/library/ttk.rst:668 +#: library/ttk.rst:668 msgid "Bugs" msgstr "" -#: ../src/Doc/library/ttk.rst:670 +#: library/ttk.rst:670 msgid "" "If the containing toplevel's position was specified relative to the right or " "bottom of the screen (e.g. ....), the :class:`Sizegrip` widget will not " "resize the window." msgstr "" -#: ../src/Doc/library/ttk.rst:673 +#: library/ttk.rst:673 msgid "This widget supports only \"southeast\" resizing." msgstr "" -#: ../src/Doc/library/ttk.rst:677 +#: library/ttk.rst:677 msgid "Treeview" msgstr "" -#: ../src/Doc/library/ttk.rst:679 +#: library/ttk.rst:679 msgid "" "The :class:`ttk.Treeview` widget displays a hierarchical collection of " "items. Each item has a textual label, an optional image, and an optional " @@ -111650,7 +113908,7 @@ msgid "" "after the tree label." msgstr "" -#: ../src/Doc/library/ttk.rst:684 +#: library/ttk.rst:684 msgid "" "The order in which data values are displayed may be controlled by setting " "the widget option ``displaycolumns``. The tree widget can also display " @@ -111658,7 +113916,7 @@ msgid "" "in the widget option columns. See `Column Identifiers`_." msgstr "" -#: ../src/Doc/library/ttk.rst:689 +#: library/ttk.rst:689 msgid "" "Each item is identified by an unique name. The widget will generate item IDs " "if they are not supplied by the caller. There is a distinguished root item, " @@ -111666,57 +113924,57 @@ msgid "" "the top level of the hierarchy." msgstr "" -#: ../src/Doc/library/ttk.rst:694 +#: library/ttk.rst:694 msgid "" "Each item also has a list of tags, which can be used to associate event " "bindings with individual items and control the appearance of the item." msgstr "" -#: ../src/Doc/library/ttk.rst:697 +#: library/ttk.rst:697 msgid "" "The Treeview widget supports horizontal and vertical scrolling, according to " "the options described in `Scrollable Widget Options`_ and the methods :meth:" "`Treeview.xview` and :meth:`Treeview.yview`." msgstr "" -#: ../src/Doc/library/ttk.rst:713 +#: library/ttk.rst:713 msgid "columns" msgstr "" -#: ../src/Doc/library/ttk.rst:713 +#: library/ttk.rst:713 msgid "" "A list of column identifiers, specifying the number of columns and their " "names." msgstr "" -#: ../src/Doc/library/ttk.rst:716 +#: library/ttk.rst:716 msgid "displaycolumns" msgstr "" -#: ../src/Doc/library/ttk.rst:716 +#: library/ttk.rst:716 msgid "" "A list of column identifiers (either symbolic or integer indices) specifying " "which data columns are displayed and the order in which they appear, or the " "string \"#all\"." msgstr "" -#: ../src/Doc/library/ttk.rst:721 +#: library/ttk.rst:721 msgid "" "Specifies the number of rows which should be visible. Note: the requested " "width is determined from the sum of the column widths." msgstr "" -#: ../src/Doc/library/ttk.rst:725 +#: library/ttk.rst:725 msgid "" "Specifies the internal padding for the widget. The padding is a list of up " "to four length specifications." msgstr "" -#: ../src/Doc/library/ttk.rst:728 +#: library/ttk.rst:728 msgid "selectmode" msgstr "" -#: ../src/Doc/library/ttk.rst:728 +#: library/ttk.rst:728 msgid "" "Controls how the built-in class bindings manage the selection. One of " "\"extended\", \"browse\" or \"none\". If set to \"extended\" (the default), " @@ -111724,63 +113982,63 @@ msgid "" "selected at a time. If \"none\", the selection will not be changed." msgstr "" -#: ../src/Doc/library/ttk.rst:735 +#: library/ttk.rst:735 msgid "" "Note that the application code and tag bindings can set the selection " "however they wish, regardless of the value of this option." msgstr "" -#: ../src/Doc/library/ttk.rst:739 +#: library/ttk.rst:739 msgid "show" msgstr "" -#: ../src/Doc/library/ttk.rst:739 +#: library/ttk.rst:739 msgid "" "A list containing zero or more of the following values, specifying which " "elements of the tree to display." msgstr "" -#: ../src/Doc/library/ttk.rst:742 +#: library/ttk.rst:742 msgid "tree: display tree labels in column #0." msgstr "" -#: ../src/Doc/library/ttk.rst:743 +#: library/ttk.rst:743 msgid "headings: display the heading row." msgstr "" -#: ../src/Doc/library/ttk.rst:745 +#: library/ttk.rst:745 msgid "The default is \"tree headings\", i.e., show all elements." msgstr "" -#: ../src/Doc/library/ttk.rst:748 +#: library/ttk.rst:748 msgid "" "**Note**: Column #0 always refers to the tree column, even if show=\"tree\" " "is not specified." msgstr "" -#: ../src/Doc/library/ttk.rst:754 +#: library/ttk.rst:754 msgid "Item Options" msgstr "" -#: ../src/Doc/library/ttk.rst:756 +#: library/ttk.rst:756 msgid "" "The following item options may be specified for items in the insert and item " "widget commands." msgstr "" -#: ../src/Doc/library/ttk.rst:762 +#: library/ttk.rst:762 msgid "The textual label to display for the item." msgstr "" -#: ../src/Doc/library/ttk.rst:764 +#: library/ttk.rst:764 msgid "A Tk Image, displayed to the left of the label." msgstr "" -#: ../src/Doc/library/ttk.rst:766 +#: library/ttk.rst:766 msgid "The list of values associated with the item." msgstr "" -#: ../src/Doc/library/ttk.rst:768 +#: library/ttk.rst:768 msgid "" "Each item should have the same number of values as the widget option " "columns. If there are fewer values than columns, the remaining values are " @@ -111788,87 +114046,87 @@ msgid "" "ignored." msgstr "" -#: ../src/Doc/library/ttk.rst:773 +#: library/ttk.rst:773 msgid "open" msgstr "" -#: ../src/Doc/library/ttk.rst:773 +#: library/ttk.rst:773 msgid "" "True/False value indicating whether the item's children should be displayed " "or hidden." msgstr "" -#: ../src/Doc/library/ttk.rst:776 +#: library/ttk.rst:776 msgid "tags" msgstr "" -#: ../src/Doc/library/ttk.rst:776 +#: library/ttk.rst:776 msgid "A list of tags associated with this item." msgstr "" -#: ../src/Doc/library/ttk.rst:781 +#: library/ttk.rst:781 msgid "Tag Options" msgstr "" -#: ../src/Doc/library/ttk.rst:783 +#: library/ttk.rst:783 msgid "The following options may be specified on tags:" msgstr "" -#: ../src/Doc/library/ttk.rst:788 +#: library/ttk.rst:788 msgid "foreground" msgstr "" -#: ../src/Doc/library/ttk.rst:788 +#: library/ttk.rst:788 msgid "Specifies the text foreground color." msgstr "" -#: ../src/Doc/library/ttk.rst:790 +#: library/ttk.rst:790 msgid "Specifies the cell or item background color." msgstr "" -#: ../src/Doc/library/ttk.rst:792 +#: library/ttk.rst:792 msgid "Specifies the font to use when drawing text." msgstr "" -#: ../src/Doc/library/ttk.rst:794 +#: library/ttk.rst:794 msgid "Specifies the item image, in case the item's image option is empty." msgstr "" -#: ../src/Doc/library/ttk.rst:800 +#: library/ttk.rst:800 msgid "Column Identifiers" msgstr "" -#: ../src/Doc/library/ttk.rst:802 +#: library/ttk.rst:802 msgid "Column identifiers take any of the following forms:" msgstr "" -#: ../src/Doc/library/ttk.rst:804 +#: library/ttk.rst:804 msgid "A symbolic name from the list of columns option." msgstr "" -#: ../src/Doc/library/ttk.rst:805 +#: library/ttk.rst:805 msgid "An integer n, specifying the nth data column." msgstr "" -#: ../src/Doc/library/ttk.rst:806 +#: library/ttk.rst:806 msgid "" "A string of the form #n, where n is an integer, specifying the nth display " "column." msgstr "" -#: ../src/Doc/library/ttk.rst:811 +#: library/ttk.rst:811 msgid "" "Item's option values may be displayed in a different order than the order in " "which they are stored." msgstr "" -#: ../src/Doc/library/ttk.rst:813 +#: library/ttk.rst:813 msgid "" "Column #0 always refers to the tree column, even if show=\"tree\" is not " "specified." msgstr "" -#: ../src/Doc/library/ttk.rst:816 +#: library/ttk.rst:816 msgid "" "A data column number is an index into an item's option values list; a " "display column number is the column number in the tree where the values are " @@ -111877,74 +114135,74 @@ msgid "" "#0 always refers to the tree column**." msgstr "" -#: ../src/Doc/library/ttk.rst:826 +#: library/ttk.rst:826 msgid "The Treeview widget generates the following virtual events." msgstr "" -#: ../src/Doc/library/ttk.rst:829 +#: library/ttk.rst:829 msgid "event" msgstr "" -#: ../src/Doc/library/ttk.rst:831 +#: library/ttk.rst:831 msgid "<<TreeviewSelect>>" msgstr "" -#: ../src/Doc/library/ttk.rst:831 +#: library/ttk.rst:831 msgid "Generated whenever the selection changes." msgstr "" -#: ../src/Doc/library/ttk.rst:833 +#: library/ttk.rst:833 msgid "<<TreeviewOpen>>" msgstr "" -#: ../src/Doc/library/ttk.rst:833 +#: library/ttk.rst:833 msgid "Generated just before settings the focus item to open=True." msgstr "" -#: ../src/Doc/library/ttk.rst:836 +#: library/ttk.rst:836 msgid "<<TreeviewClose>>" msgstr "" -#: ../src/Doc/library/ttk.rst:836 +#: library/ttk.rst:836 msgid "Generated just after setting the focus item to open=False." msgstr "" -#: ../src/Doc/library/ttk.rst:840 +#: library/ttk.rst:840 msgid "" "The :meth:`Treeview.focus` and :meth:`Treeview.selection` methods can be " "used to determine the affected item or items." msgstr "" -#: ../src/Doc/library/ttk.rst:845 +#: library/ttk.rst:845 msgid "ttk.Treeview" msgstr "" -#: ../src/Doc/library/ttk.rst:851 +#: library/ttk.rst:851 msgid "" "Returns the bounding box (relative to the treeview widget's window) of the " "specified *item* in the form (x, y, width, height)." msgstr "" -#: ../src/Doc/library/ttk.rst:854 +#: library/ttk.rst:854 msgid "" "If *column* is specified, returns the bounding box of that cell. If the " "*item* is not visible (i.e., if it is a descendant of a closed item or is " "scrolled offscreen), returns an empty string." msgstr "" -#: ../src/Doc/library/ttk.rst:861 +#: library/ttk.rst:861 msgid "Returns the list of children belonging to *item*." msgstr "" -#: ../src/Doc/library/ttk.rst:863 +#: library/ttk.rst:863 msgid "If *item* is not specified, returns root children." msgstr "" -#: ../src/Doc/library/ttk.rst:868 +#: library/ttk.rst:868 msgid "Replaces *item*'s child with *newchildren*." msgstr "" -#: ../src/Doc/library/ttk.rst:870 +#: library/ttk.rst:870 msgid "" "Children present in *item* that are not present in *newchildren* are " "detached from the tree. No items in *newchildren* may be an ancestor of " @@ -111952,47 +114210,47 @@ msgid "" "children." msgstr "" -#: ../src/Doc/library/ttk.rst:878 +#: library/ttk.rst:878 msgid "Query or modify the options for the specified *column*." msgstr "" -#: ../src/Doc/library/ttk.rst:880 +#: library/ttk.rst:880 msgid "" "If *kw* is not given, returns a dict of the column option values. If " "*option* is specified then the value for that *option* is returned. " "Otherwise, sets the options to the corresponding values." msgstr "" -#: ../src/Doc/library/ttk.rst:884 ../src/Doc/library/ttk.rst:939 +#: library/ttk.rst:884 library/ttk.rst:939 msgid "The valid options/values are:" msgstr "" # 5d15ed59dee14eaeb9d8dc98612d515e -#: ../src/Doc/library/ttk.rst:885 +#: library/ttk.rst:886 msgid "id" msgstr "" -#: ../src/Doc/library/ttk.rst:887 +#: library/ttk.rst:887 msgid "Returns the column name. This is a read-only option." msgstr "" # 974361fe7d364216ac153ecff7ccaa94 -#: ../src/Doc/library/ttk.rst:888 +#: library/ttk.rst:889 msgid "anchor: One of the standard Tk anchor values." msgstr "" -#: ../src/Doc/library/ttk.rst:889 +#: library/ttk.rst:889 msgid "" "Specifies how the text in this column should be aligned with respect to the " "cell." msgstr "" # 67b1d56906a4434e9882ee7dab56c3a8 -#: ../src/Doc/library/ttk.rst:892 +#: library/ttk.rst:893 msgid "minwidth: width" msgstr "" -#: ../src/Doc/library/ttk.rst:892 +#: library/ttk.rst:892 msgid "" "The minimum width of the column in pixels. The treeview widget will not make " "the column any smaller than specified by this option when the widget is " @@ -112000,67 +114258,67 @@ msgid "" msgstr "" # e7594ab8300a40a8abb2addd37326bfc -#: ../src/Doc/library/ttk.rst:895 +#: library/ttk.rst:896 msgid "stretch: True/False" msgstr "" -#: ../src/Doc/library/ttk.rst:896 +#: library/ttk.rst:896 msgid "" "Specifies whether the column's width should be adjusted when the widget is " "resized." msgstr "" # 52beee472aa14e50a0fb2e45d88a1a14 -#: ../src/Doc/library/ttk.rst:898 +#: library/ttk.rst:899 msgid "width: width" msgstr "" -#: ../src/Doc/library/ttk.rst:899 +#: library/ttk.rst:899 msgid "The width of the column in pixels." msgstr "" -#: ../src/Doc/library/ttk.rst:901 +#: library/ttk.rst:901 msgid "To configure the tree column, call this with column = \"#0\"" msgstr "" -#: ../src/Doc/library/ttk.rst:905 +#: library/ttk.rst:905 msgid "Delete all specified *items* and all their descendants." msgstr "" -#: ../src/Doc/library/ttk.rst:907 +#: library/ttk.rst:907 msgid "The root item may not be deleted." msgstr "" -#: ../src/Doc/library/ttk.rst:912 +#: library/ttk.rst:912 msgid "Unlinks all of the specified *items* from the tree." msgstr "" -#: ../src/Doc/library/ttk.rst:914 +#: library/ttk.rst:914 msgid "" "The items and all of their descendants are still present, and may be " "reinserted at another point in the tree, but will not be displayed." msgstr "" -#: ../src/Doc/library/ttk.rst:917 +#: library/ttk.rst:917 msgid "The root item may not be detached." msgstr "" # 096cb186f1974f4ca60a94c7a25e6582 -#: ../src/Doc/library/ttk.rst:922 +#: library/ttk.rst:922 msgid "Returns ``True`` if the specified *item* is present in the tree." msgstr "" -#: ../src/Doc/library/ttk.rst:927 +#: library/ttk.rst:927 msgid "" "If *item* is specified, sets the focus item to *item*. Otherwise, returns " "the current focus item, or '' if there is none." msgstr "" -#: ../src/Doc/library/ttk.rst:933 +#: library/ttk.rst:933 msgid "Query or modify the heading options for the specified *column*." msgstr "" -#: ../src/Doc/library/ttk.rst:935 +#: library/ttk.rst:935 msgid "" "If *kw* is not given, returns a dict of the heading option values. If " "*option* is specified then the value for that *option* is returned. " @@ -112068,125 +114326,125 @@ msgid "" msgstr "" # db2a69202e0743a6ab775f8421761b08 -#: ../src/Doc/library/ttk.rst:940 +#: library/ttk.rst:941 msgid "text: text" msgstr "" -#: ../src/Doc/library/ttk.rst:942 +#: library/ttk.rst:942 msgid "The text to display in the column heading." msgstr "" # 5039cb75ccf64f0bbce41081acd4ebcd -#: ../src/Doc/library/ttk.rst:942 +#: library/ttk.rst:943 msgid "image: imageName" msgstr "" -#: ../src/Doc/library/ttk.rst:944 +#: library/ttk.rst:944 msgid "Specifies an image to display to the right of the column heading." msgstr "" # 009bfa3468aa43438f0c2831229e6c6e -#: ../src/Doc/library/ttk.rst:945 +#: library/ttk.rst:946 msgid "anchor: anchor" msgstr "" -#: ../src/Doc/library/ttk.rst:946 +#: library/ttk.rst:946 msgid "" "Specifies how the heading text should be aligned. One of the standard Tk " "anchor values." msgstr "" # eb881579a3794b44bfa8173f705cc19d -#: ../src/Doc/library/ttk.rst:948 +#: library/ttk.rst:949 msgid "command: callback" msgstr "" -#: ../src/Doc/library/ttk.rst:949 +#: library/ttk.rst:949 msgid "A callback to be invoked when the heading label is pressed." msgstr "" -#: ../src/Doc/library/ttk.rst:951 +#: library/ttk.rst:951 msgid "To configure the tree column heading, call this with column = \"#0\"." msgstr "" -#: ../src/Doc/library/ttk.rst:956 +#: library/ttk.rst:956 msgid "" "Returns a description of the specified *component* under the point given by " "*x* and *y*, or the empty string if no such *component* is present at that " "position." msgstr "" -#: ../src/Doc/library/ttk.rst:963 +#: library/ttk.rst:963 msgid "Returns the item ID of the item at position *y*." msgstr "" -#: ../src/Doc/library/ttk.rst:968 +#: library/ttk.rst:968 msgid "Returns the data column identifier of the cell at position *x*." msgstr "" -#: ../src/Doc/library/ttk.rst:970 +#: library/ttk.rst:970 msgid "The tree column has ID #0." msgstr "" -#: ../src/Doc/library/ttk.rst:975 +#: library/ttk.rst:975 msgid "Returns one of:" msgstr "" -#: ../src/Doc/library/ttk.rst:978 +#: library/ttk.rst:978 msgid "meaning" msgstr "" -#: ../src/Doc/library/ttk.rst:980 +#: library/ttk.rst:980 msgid "heading" msgstr "" -#: ../src/Doc/library/ttk.rst:980 +#: library/ttk.rst:980 msgid "Tree heading area." msgstr "" -#: ../src/Doc/library/ttk.rst:982 +#: library/ttk.rst:982 msgid "separator" msgstr "" -#: ../src/Doc/library/ttk.rst:982 +#: library/ttk.rst:982 msgid "Space between two columns headings." msgstr "" -#: ../src/Doc/library/ttk.rst:984 ../src/Doc/library/turtle.rst:2216 +#: library/ttk.rst:984 library/turtle.rst:2216 msgid "tree" msgstr "" -#: ../src/Doc/library/ttk.rst:984 +#: library/ttk.rst:984 msgid "The tree area." msgstr "" -#: ../src/Doc/library/ttk.rst:986 +#: library/ttk.rst:986 msgid "cell" msgstr "" -#: ../src/Doc/library/ttk.rst:986 +#: library/ttk.rst:986 msgid "A data cell." msgstr "" -#: ../src/Doc/library/ttk.rst:989 ../src/Doc/library/ttk.rst:996 +#: library/ttk.rst:989 library/ttk.rst:996 msgid "Availability: Tk 8.6." msgstr "" -#: ../src/Doc/library/ttk.rst:994 +#: library/ttk.rst:994 msgid "Returns the element at position *x*, *y*." msgstr "" -#: ../src/Doc/library/ttk.rst:1001 +#: library/ttk.rst:1001 msgid "" "Returns the integer index of *item* within its parent's list of children." msgstr "" -#: ../src/Doc/library/ttk.rst:1006 +#: library/ttk.rst:1006 msgid "" "Creates a new item and returns the item identifier of the newly created item." msgstr "" -#: ../src/Doc/library/ttk.rst:1009 +#: library/ttk.rst:1009 msgid "" "*parent* is the item ID of the parent item, or the empty string to create a " "new top-level item. *index* is an integer, or the value \"end\", specifying " @@ -112198,15 +114456,15 @@ msgid "" "unique identifier is generated." msgstr "" -#: ../src/Doc/library/ttk.rst:1018 +#: library/ttk.rst:1018 msgid "See `Item Options`_ for the list of available points." msgstr "" -#: ../src/Doc/library/ttk.rst:1023 +#: library/ttk.rst:1023 msgid "Query or modify the options for the specified *item*." msgstr "" -#: ../src/Doc/library/ttk.rst:1025 +#: library/ttk.rst:1025 msgid "" "If no options are given, a dict with options/values for the item is " "returned. If *option* is specified then the value for that option is " @@ -112214,11 +114472,11 @@ msgid "" "by *kw*." msgstr "" -#: ../src/Doc/library/ttk.rst:1033 +#: library/ttk.rst:1033 msgid "Moves *item* to position *index* in *parent*'s list of children." msgstr "" -#: ../src/Doc/library/ttk.rst:1035 +#: library/ttk.rst:1035 msgid "" "It is illegal to move an item under one of its descendants. If *index* is " "less than or equal to zero, *item* is moved to the beginning; if greater " @@ -112226,62 +114484,62 @@ msgid "" "was detached it is reattached." msgstr "" -#: ../src/Doc/library/ttk.rst:1043 +#: library/ttk.rst:1043 msgid "" "Returns the identifier of *item*'s next sibling, or '' if *item* is the last " "child of its parent." msgstr "" -#: ../src/Doc/library/ttk.rst:1049 +#: library/ttk.rst:1049 msgid "" "Returns the ID of the parent of *item*, or '' if *item* is at the top level " "of the hierarchy." msgstr "" -#: ../src/Doc/library/ttk.rst:1055 +#: library/ttk.rst:1055 msgid "" "Returns the identifier of *item*'s previous sibling, or '' if *item* is the " "first child of its parent." msgstr "" -#: ../src/Doc/library/ttk.rst:1061 +#: library/ttk.rst:1061 msgid "An alias for :meth:`Treeview.move`." msgstr "" -#: ../src/Doc/library/ttk.rst:1066 +#: library/ttk.rst:1066 msgid "Ensure that *item* is visible." msgstr "" # 5327ad93c4904e0bbe2575c5ff1aa951 -#: ../src/Doc/library/ttk.rst:1068 +#: library/ttk.rst:1068 msgid "" "Sets all of *item*'s ancestors open option to ``True``, and scrolls the " "widget if necessary so that *item* is within the visible portion of the tree." msgstr "" -#: ../src/Doc/library/ttk.rst:1075 +#: library/ttk.rst:1075 msgid "" "If *selop* is not specified, returns selected items. Otherwise, it will act " "according to the following selection methods." msgstr "" -#: ../src/Doc/library/ttk.rst:1081 +#: library/ttk.rst:1081 msgid "*items* becomes the new selection." msgstr "" -#: ../src/Doc/library/ttk.rst:1086 +#: library/ttk.rst:1086 msgid "Add *items* to the selection." msgstr "" -#: ../src/Doc/library/ttk.rst:1091 +#: library/ttk.rst:1091 msgid "Remove *items* from the selection." msgstr "" -#: ../src/Doc/library/ttk.rst:1096 +#: library/ttk.rst:1096 msgid "Toggle the selection state of each item in *items*." msgstr "" -#: ../src/Doc/library/ttk.rst:1101 +#: library/ttk.rst:1101 msgid "" "With one argument, returns a dictionary of column/value pairs for the " "specified *item*. With two arguments, returns the current value of the " @@ -112289,18 +114547,18 @@ msgid "" "in given *item* to the specified *value*." msgstr "" -#: ../src/Doc/library/ttk.rst:1109 +#: library/ttk.rst:1109 msgid "" "Bind a callback for the given event *sequence* to the tag *tagname*. When an " "event is delivered to an item, the callbacks for each of the item's tags " "option are called." msgstr "" -#: ../src/Doc/library/ttk.rst:1116 +#: library/ttk.rst:1116 msgid "Query or modify the options for the specified *tagname*." msgstr "" -#: ../src/Doc/library/ttk.rst:1118 +#: library/ttk.rst:1118 msgid "" "If *kw* is not given, returns a dict of the option settings for *tagname*. " "If *option* is specified, returns the value for that *option* for the " @@ -112308,31 +114566,31 @@ msgid "" "for the given *tagname*." msgstr "" -#: ../src/Doc/library/ttk.rst:1126 +#: library/ttk.rst:1126 msgid "" "If *item* is specified, returns 1 or 0 depending on whether the specified " "*item* has the given *tagname*. Otherwise, returns a list of all items that " "have the specified tag." msgstr "" -#: ../src/Doc/library/ttk.rst:1130 +#: library/ttk.rst:1130 msgid "Availability: Tk 8.6" msgstr "" -#: ../src/Doc/library/ttk.rst:1135 +#: library/ttk.rst:1135 msgid "Query or modify horizontal position of the treeview." msgstr "" -#: ../src/Doc/library/ttk.rst:1140 +#: library/ttk.rst:1140 msgid "Query or modify vertical position of the treeview." msgstr "" -#: ../src/Doc/library/ttk.rst:1146 +#: library/ttk.rst:1146 msgid "Ttk Styling" msgstr "" # 3a511c3c6f8744ab8f7bac22f35fd73d -#: ../src/Doc/library/ttk.rst:1148 +#: library/ttk.rst:1148 msgid "" "Each widget in :mod:`ttk` is assigned a style, which specifies the set of " "elements making up the widget and how they are arranged, along with dynamic " @@ -112342,44 +114600,41 @@ msgid "" "`Misc.winfo_class` (somewidget.winfo_class())." msgstr "" -# a789d010bf554ef79686a0bc2fbc2dcd -#: ../src/Doc/library/ttk.rst:1156 -msgid "" -"`Tcl'2004 conference presentation <http://tktable.sourceforge.net/tile/tile-" -"tcl2004.pdf>`_" +#: library/ttk.rst:1157 +msgid "Tcl'2004 conference presentation" msgstr "" -#: ../src/Doc/library/ttk.rst:1158 +#: library/ttk.rst:1158 msgid "This document explains how the theme engine works" msgstr "" -#: ../src/Doc/library/ttk.rst:1163 +#: library/ttk.rst:1163 msgid "This class is used to manipulate the style database." msgstr "" -#: ../src/Doc/library/ttk.rst:1168 +#: library/ttk.rst:1168 msgid "Query or set the default value of the specified option(s) in *style*." msgstr "" -#: ../src/Doc/library/ttk.rst:1170 +#: library/ttk.rst:1170 msgid "" "Each key in *kw* is an option and each value is a string identifying the " "value for that option." msgstr "" # 24fafbc6ea594a30ae5077a58670ed5a -#: ../src/Doc/library/ttk.rst:1173 +#: library/ttk.rst:1173 msgid "" "For example, to change every default button to be a flat button with some " "padding and a different background color do::" msgstr "" -#: ../src/Doc/library/ttk.rst:1192 +#: library/ttk.rst:1192 msgid "Query or sets dynamic values of the specified option(s) in *style*." msgstr "" # 38c5a854b6394b45a0456436fcbceae0 -#: ../src/Doc/library/ttk.rst:1194 +#: library/ttk.rst:1194 msgid "" "Each key in *kw* is an option and each value should be a list or a tuple " "(usually) containing statespecs grouped in tuples, lists, or something else " @@ -112388,7 +114643,7 @@ msgid "" msgstr "" # 4e0dba3f6f5640b8914d28189f3462c1 -#: ../src/Doc/library/ttk.rst:1217 +#: library/ttk.rst:1217 msgid "" "Note that the order of the (states, value) sequences for an option matters. " "In the previous example, if you change the order to ``[('active', 'blue'), " @@ -112396,11 +114651,11 @@ msgid "" "blue foreground when the widget is in the active or pressed states." msgstr "" -#: ../src/Doc/library/ttk.rst:1225 +#: library/ttk.rst:1225 msgid "Returns the value specified for *option* in *style*." msgstr "" -#: ../src/Doc/library/ttk.rst:1227 +#: library/ttk.rst:1227 msgid "" "If *state* is specified, it is expected to be a sequence of one or more " "states. If the *default* argument is set, it is used as a fallback value in " @@ -112408,18 +114663,18 @@ msgid "" msgstr "" # 58ee0e20278a42c28cb4d2f745707c50 -#: ../src/Doc/library/ttk.rst:1231 +#: library/ttk.rst:1231 msgid "To check what font a Button uses by default, do::" msgstr "" -#: ../src/Doc/library/ttk.rst:1240 +#: library/ttk.rst:1240 msgid "" "Define the widget layout for given *style*. If *layoutspec* is omitted, " "return the layout specification for given style." msgstr "" # 5a1c5577d7174a10911e7b88a7aa8a7d -#: ../src/Doc/library/ttk.rst:1243 +#: library/ttk.rst:1243 msgid "" "*layoutspec*, if specified, is expected to be a list or some other sequence " "type (excluding strings), where each item should be a tuple and the first " @@ -112427,20 +114682,20 @@ msgid "" "in `Layouts`_." msgstr "" -#: ../src/Doc/library/ttk.rst:1248 +#: library/ttk.rst:1248 msgid "" "To understand the format, see the following example (it is not intended to " "do anything useful)::" msgstr "" -#: ../src/Doc/library/ttk.rst:1275 +#: library/ttk.rst:1275 msgid "" "Create a new element in the current theme, of the given *etype* which is " "expected to be either \"image\", \"from\" or \"vsapi\". The latter is only " "available in Tk 8.6a for Windows XP and Vista and is not described here." msgstr "" -#: ../src/Doc/library/ttk.rst:1279 +#: library/ttk.rst:1279 msgid "" "If \"image\" is used, *args* should contain the default image name followed " "by statespec/value pairs (this is the imagespec), and *kw* may have the " @@ -112448,62 +114703,62 @@ msgid "" msgstr "" # cb19feff181348969d5b3bc85c8f02a9 -#: ../src/Doc/library/ttk.rst:1284 +#: library/ttk.rst:1285 msgid "border=padding" msgstr "" -#: ../src/Doc/library/ttk.rst:1284 +#: library/ttk.rst:1284 msgid "" "padding is a list of up to four integers, specifying the left, top, right, " "and bottom borders, respectively." msgstr "" # 5394a17845e545a4b9fdb4feeecfcfe4 -#: ../src/Doc/library/ttk.rst:1288 +#: library/ttk.rst:1289 msgid "height=height" msgstr "" -#: ../src/Doc/library/ttk.rst:1288 +#: library/ttk.rst:1288 msgid "" "Specifies a minimum height for the element. If less than zero, the base " "image's height is used as a default." msgstr "" # c061ebf62c514055b29dd0f27a8c57bf -#: ../src/Doc/library/ttk.rst:1292 +#: library/ttk.rst:1293 msgid "padding=padding" msgstr "" -#: ../src/Doc/library/ttk.rst:1292 +#: library/ttk.rst:1292 msgid "" "Specifies the element's interior padding. Defaults to border's value if not " "specified." msgstr "" # 2df092170547465aa23fa6b685c6199f -#: ../src/Doc/library/ttk.rst:1296 +#: library/ttk.rst:1297 msgid "sticky=spec" msgstr "" # 94126cf1b5c14fb9a66e627f3ccb11c7 -#: ../src/Doc/library/ttk.rst:1296 +#: library/ttk.rst:1296 msgid "" "Specifies how the image is placed within the final parcel. spec contains " "zero or more characters \"n\", \"s\", \"w\", or \"e\"." msgstr "" # ffe53327c63b4a9182eb630a31a5ca11 -#: ../src/Doc/library/ttk.rst:1300 +#: library/ttk.rst:1301 msgid "width=width" msgstr "" -#: ../src/Doc/library/ttk.rst:1300 +#: library/ttk.rst:1300 msgid "" "Specifies a minimum width for the element. If less than zero, the base " "image's width is used as a default." msgstr "" -#: ../src/Doc/library/ttk.rst:1303 +#: library/ttk.rst:1303 msgid "" "If \"from\" is used as the value of *etype*, :meth:`element_create` will " "clone an existing element. *args* is expected to contain a themename, from " @@ -112512,19 +114767,19 @@ msgid "" "used. *kw* is discarded." msgstr "" -#: ../src/Doc/library/ttk.rst:1313 +#: library/ttk.rst:1313 msgid "Returns the list of elements defined in the current theme." msgstr "" -#: ../src/Doc/library/ttk.rst:1318 +#: library/ttk.rst:1318 msgid "Returns the list of *elementname*'s options." msgstr "" -#: ../src/Doc/library/ttk.rst:1323 +#: library/ttk.rst:1323 msgid "Create a new theme." msgstr "" -#: ../src/Doc/library/ttk.rst:1325 +#: library/ttk.rst:1325 msgid "" "It is an error if *themename* already exists. If *parent* is specified, the " "new theme will inherit styles, elements and layouts from the parent theme. " @@ -112532,13 +114787,13 @@ msgid "" "for :meth:`theme_settings`." msgstr "" -#: ../src/Doc/library/ttk.rst:1333 +#: library/ttk.rst:1333 msgid "" "Temporarily sets the current theme to *themename*, apply specified " "*settings* and then restore the previous theme." msgstr "" -#: ../src/Doc/library/ttk.rst:1336 +#: library/ttk.rst:1336 msgid "" "Each key in *settings* is a style and each value may contain the keys " "'configure', 'map', 'layout' and 'element create' and they are expected to " @@ -112547,26 +114802,26 @@ msgid "" "respectively." msgstr "" -#: ../src/Doc/library/ttk.rst:1342 +#: library/ttk.rst:1342 msgid "As an example, let's change the Combobox for the default theme a bit::" msgstr "" -#: ../src/Doc/library/ttk.rst:1370 +#: library/ttk.rst:1370 msgid "Returns a list of all known themes." msgstr "" -#: ../src/Doc/library/ttk.rst:1375 +#: library/ttk.rst:1375 msgid "" "If *themename* is not given, returns the theme in use. Otherwise, sets the " "current theme to *themename*, refreshes all widgets and emits a " "<<ThemeChanged>> event." msgstr "" -#: ../src/Doc/library/ttk.rst:1381 +#: library/ttk.rst:1381 msgid "Layouts" msgstr "" -#: ../src/Doc/library/ttk.rst:1383 +#: library/ttk.rst:1383 msgid "" "A layout can be just None, if it takes no options, or a dict of options " "specifying how to arrange the element. The layout mechanism uses a " @@ -112575,31 +114830,31 @@ msgid "" msgstr "" # 8c841d46938445cbaa888a9612408ec5 -#: ../src/Doc/library/ttk.rst:1391 +#: library/ttk.rst:1392 msgid "side: whichside" msgstr "" -#: ../src/Doc/library/ttk.rst:1390 +#: library/ttk.rst:1390 msgid "" "Specifies which side of the cavity to place the element; one of top, right, " "bottom or left. If omitted, the element occupies the entire cavity." msgstr "" # eaaeb43220c74a1da8b38d548c605b76 -#: ../src/Doc/library/ttk.rst:1394 +#: library/ttk.rst:1395 msgid "sticky: nswe" msgstr "" -#: ../src/Doc/library/ttk.rst:1395 +#: library/ttk.rst:1395 msgid "Specifies where the element is placed inside its allocated parcel." msgstr "" # 77e9b1ef8eac4d2aa2f5ff94790a2eb1 -#: ../src/Doc/library/ttk.rst:1399 +#: library/ttk.rst:1400 msgid "unit: 0 or 1" msgstr "" -#: ../src/Doc/library/ttk.rst:1398 +#: library/ttk.rst:1398 msgid "" "If set to 1, causes the element and all of its descendants to be treated as " "a single element for the purposes of :meth:`Widget.identify` et al. It's " @@ -112607,64 +114862,64 @@ msgid "" msgstr "" # 2e75a06709d24011b68b97433b8e2a7c -#: ../src/Doc/library/ttk.rst:1404 +#: library/ttk.rst:1405 msgid "children: [sublayout... ]" msgstr "" -#: ../src/Doc/library/ttk.rst:1403 +#: library/ttk.rst:1403 msgid "" "Specifies a list of elements to place inside the element. Each element is a " "tuple (or other sequence type) where the first item is the layout name, and " "the other is a `Layout`_." msgstr "" -#: ../src/Doc/library/tty.rst:3 +#: library/tty.rst:3 msgid ":mod:`tty` --- Terminal control functions" msgstr "" -#: ../src/Doc/library/tty.rst:12 +#: library/tty.rst:12 msgid "" "The :mod:`tty` module defines functions for putting the tty into cbreak and " "raw modes." msgstr "" -#: ../src/Doc/library/tty.rst:15 +#: library/tty.rst:15 msgid "" "Because it requires the :mod:`termios` module, it will work only on Unix." msgstr "" -#: ../src/Doc/library/tty.rst:17 +#: library/tty.rst:17 msgid "The :mod:`tty` module defines the following functions:" msgstr "" -#: ../src/Doc/library/tty.rst:22 +#: library/tty.rst:22 msgid "" "Change the mode of the file descriptor *fd* to raw. If *when* is omitted, it " "defaults to :const:`termios.TCSAFLUSH`, and is passed to :func:`termios." "tcsetattr`." msgstr "" -#: ../src/Doc/library/tty.rst:29 +#: library/tty.rst:29 msgid "" "Change the mode of file descriptor *fd* to cbreak. If *when* is omitted, it " "defaults to :const:`termios.TCSAFLUSH`, and is passed to :func:`termios." "tcsetattr`." msgstr "" -# f66ef5f6ad99457f9b79654a7378febe -#: ../src/Doc/library/tty.rst:35 -msgid "Module :mod:`termios`" -msgstr "" +#: library/tty.rst:36 +#, fuzzy +msgid "Module termios" +msgstr "Modules" -#: ../src/Doc/library/tty.rst:37 +#: library/tty.rst:37 msgid "Low-level terminal control interface." msgstr "" -#: ../src/Doc/library/turtle.rst:3 +#: library/turtle.rst:3 msgid ":mod:`turtle` --- Turtle graphics for Tk" msgstr "" -#: ../src/Doc/library/turtle.rst:17 +#: library/turtle.rst:17 msgid "" "Turtle graphics is a popular way for introducing programming to kids. It " "was part of the original Logo programming language developed by Wally " @@ -112672,7 +114927,7 @@ msgid "" msgstr "" # cd16f41e225e4f0998c7994744b18b6e -#: ../src/Doc/library/turtle.rst:21 +#: library/turtle.rst:21 msgid "" "Imagine a robotic turtle starting at (0, 0) in the x-y plane. After an " "``import turtle``, give it the command ``turtle.forward(15)``, and it moves " @@ -112681,19 +114936,19 @@ msgid "" "degrees clockwise." msgstr "" -#: ../src/Doc/library/turtle.rst:26 +#: library/turtle.rst:26 msgid "" "By combining together these and similar commands, intricate shapes and " "pictures can easily be drawn." msgstr "" -#: ../src/Doc/library/turtle.rst:29 +#: library/turtle.rst:29 msgid "" "The :mod:`turtle` module is an extended reimplementation of the same-named " "module from the Python standard distribution up to version Python 2.5." msgstr "" -#: ../src/Doc/library/turtle.rst:32 +#: library/turtle.rst:32 msgid "" "It tries to keep the merits of the old turtle module and to be (nearly) 100% " "compatible with it. This means in the first place to enable the learning " @@ -112702,7 +114957,7 @@ msgid "" msgstr "" # 4c78ee9c94e04e1c868659ca0ee4703b -#: ../src/Doc/library/turtle.rst:37 +#: library/turtle.rst:37 msgid "" "The turtle module provides turtle graphics primitives, in both object-" "oriented and procedure-oriented ways. Because it uses :mod:`Tkinter` for " @@ -112710,12 +114965,12 @@ msgid "" "support." msgstr "" -#: ../src/Doc/library/turtle.rst:41 +#: library/turtle.rst:41 msgid "The object-oriented interface uses essentially two+two classes:" msgstr "" # d183a201ed8b48e1a5fd59c2f7b3e95e -#: ../src/Doc/library/turtle.rst:43 +#: library/turtle.rst:43 msgid "" "The :class:`TurtleScreen` class defines graphics windows as a playground for " "the drawing turtles. Its constructor needs a :class:`Tkinter.Canvas` or a :" @@ -112723,7 +114978,7 @@ msgid "" "used as part of some application." msgstr "" -#: ../src/Doc/library/turtle.rst:48 +#: library/turtle.rst:48 msgid "" "The function :func:`Screen` returns a singleton object of a :class:" "`TurtleScreen` subclass. This function should be used when :mod:`turtle` is " @@ -112731,13 +114986,13 @@ msgid "" "inheriting from its class is not possible." msgstr "" -#: ../src/Doc/library/turtle.rst:53 +#: library/turtle.rst:53 msgid "" "All methods of TurtleScreen/Screen also exist as functions, i.e. as part of " "the procedure-oriented interface." msgstr "" -#: ../src/Doc/library/turtle.rst:56 +#: library/turtle.rst:56 msgid "" ":class:`RawTurtle` (alias: :class:`RawPen`) defines Turtle objects which " "draw on a :class:`TurtleScreen`. Its constructor needs a Canvas, " @@ -112745,20 +115000,20 @@ msgid "" "where to draw." msgstr "" -#: ../src/Doc/library/turtle.rst:60 +#: library/turtle.rst:60 msgid "" "Derived from RawTurtle is the subclass :class:`Turtle` (alias: :class:" "`Pen`), which draws on \"the\" :class:`Screen` - instance which is " "automatically created, if not already present." msgstr "" -#: ../src/Doc/library/turtle.rst:64 +#: library/turtle.rst:64 msgid "" "All methods of RawTurtle/Turtle also exist as functions, i.e. part of the " "procedure-oriented interface." msgstr "" -#: ../src/Doc/library/turtle.rst:67 +#: library/turtle.rst:67 msgid "" "The procedural interface provides functions which are derived from the " "methods of the classes :class:`Screen` and :class:`Turtle`. They have the " @@ -112768,221 +115023,589 @@ msgid "" "functions derived from a Turtle method is called." msgstr "" -#: ../src/Doc/library/turtle.rst:74 +#: library/turtle.rst:74 msgid "" "To use multiple turtles an a screen one has to use the object-oriented " "interface." msgstr "" -#: ../src/Doc/library/turtle.rst:77 +#: library/turtle.rst:77 msgid "" "In the following documentation the argument list for functions is given. " "Methods, of course, have the additional first argument *self* which is " "omitted here." msgstr "" -#: ../src/Doc/library/turtle.rst:83 +#: library/turtle.rst:83 msgid "Overview over available Turtle and Screen methods" msgstr "" -#: ../src/Doc/library/turtle.rst:86 +#: library/turtle.rst:86 msgid "Turtle methods" msgstr "" -#: ../src/Doc/library/turtle.rst:116 ../src/Doc/library/turtle.rst:222 +#: library/turtle.rst:117 library/turtle.rst:222 msgid "Turtle motion" msgstr "" # cda4d6135a3549ac8bd95470c5d13f60 -#: ../src/Doc/library/turtle.rst:104 +#: library/turtle.rst:105 msgid "Move and draw" msgstr "" -#: ../src/Doc/library/turtle.rst:112 ../src/Doc/library/turtle.rst:603 +#: library/turtle.rst:0 +msgid ":func:`forward` | :func:`fd`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`backward` | :func:`bk` | :func:`back`" +msgstr "" + +#: library/turtle.rst:0 +#, fuzzy +msgid ":func:`right` | :func:`rt`" +msgstr "Convertit :func:`raw_input` en :func:`input`." + +#: library/turtle.rst:0 +msgid ":func:`left` | :func:`lt`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`goto` | :func:`setpos` | :func:`setposition`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`setx`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`sety`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`setheading` | :func:`seth`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`home`" +msgstr "" + +#: library/turtle.rst:0 library/turtle.rst:2222 +msgid ":func:`circle`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`dot`" +msgstr "" + +#: library/turtle.rst:0 library/turtle.rst:2210 +msgid ":func:`stamp`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`clearstamp`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`clearstamps`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`undo`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`speed`" +msgstr "" + +#: library/turtle.rst:113 library/turtle.rst:603 msgid "Tell Turtle's state" msgstr "" +#: library/turtle.rst:0 +msgid ":func:`position` | :func:`pos`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`towards`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`xcor`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`ycor`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`heading`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`distance`" +msgstr "" + # 7818382621194c4c81edd065ca53123d -#: ../src/Doc/library/turtle.rst:116 +#: library/turtle.rst:117 msgid "Setting and measurement" msgstr "" -#: ../src/Doc/library/turtle.rst:139 ../src/Doc/library/turtle.rst:745 +#: library/turtle.rst:0 +msgid ":func:`degrees`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`radians`" +msgstr "" + +#: library/turtle.rst:140 library/turtle.rst:745 msgid "Pen control" msgstr "" -#: ../src/Doc/library/turtle.rst:124 ../src/Doc/library/turtle.rst:748 +#: library/turtle.rst:125 library/turtle.rst:748 msgid "Drawing state" msgstr "" -#: ../src/Doc/library/turtle.rst:129 ../src/Doc/library/turtle.rst:841 +#: library/turtle.rst:0 +msgid ":func:`pendown` | :func:`pd` | :func:`down`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`penup` | :func:`pu` | :func:`up`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`pensize` | :func:`width`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`pen`" +msgstr "" + +#: library/turtle.rst:0 +#, fuzzy +msgid ":func:`isdown`" +msgstr "fonction" + +#: library/turtle.rst:130 library/turtle.rst:841 msgid "Color control" msgstr "" -#: ../src/Doc/library/turtle.rst:134 ../src/Doc/library/turtle.rst:971 +#: library/turtle.rst:0 +msgid ":func:`color`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`pencolor`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`fillcolor`" +msgstr "" + +#: library/turtle.rst:135 library/turtle.rst:971 msgid "Filling" msgstr "" -#: ../src/Doc/library/turtle.rst:139 ../src/Doc/library/turtle.rst:1015 +#: library/turtle.rst:0 +msgid ":func:`fill`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`begin_fill`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`end_fill`" +msgstr "" + +#: library/turtle.rst:140 library/turtle.rst:1015 msgid "More drawing control" msgstr "" -#: ../src/Doc/library/turtle.rst:153 ../src/Doc/library/turtle.rst:1060 +#: library/turtle.rst:0 +msgid ":func:`reset`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`clear`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`write`" +msgstr "" + +#: library/turtle.rst:154 library/turtle.rst:1060 msgid "Turtle state" msgstr "" -#: ../src/Doc/library/turtle.rst:145 ../src/Doc/library/turtle.rst:1063 +#: library/turtle.rst:146 library/turtle.rst:1063 msgid "Visibility" msgstr "" -#: ../src/Doc/library/turtle.rst:153 ../src/Doc/library/turtle.rst:1100 +#: library/turtle.rst:0 +msgid ":func:`showturtle` | :func:`st`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`hideturtle` | :func:`ht`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`isvisible`" +msgstr "" + +#: library/turtle.rst:154 library/turtle.rst:1100 msgid "Appearance" msgstr "" -#: ../src/Doc/library/turtle.rst:159 ../src/Doc/library/turtle.rst:1226 +#: library/turtle.rst:0 +msgid ":func:`shape`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`resizemode`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`shapesize` | :func:`turtlesize`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`settiltangle`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`tiltangle`" +msgstr "" + +#: library/turtle.rst:0 +#, fuzzy +msgid ":func:`tilt`" +msgstr "fonction" + +#: library/turtle.rst:160 library/turtle.rst:1226 msgid "Using events" msgstr "" -#: ../src/Doc/library/turtle.rst:173 ../src/Doc/library/turtle.rst:1305 +#: library/turtle.rst:0 library/turtle.rst:2204 +msgid ":func:`onclick`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`onrelease`" +msgstr "" + +#: library/turtle.rst:0 library/turtle.rst:2193 +msgid ":func:`ondrag`" +msgstr "" + +#: library/turtle.rst:0 +#, fuzzy +msgid ":func:`mainloop` | :func:`done`" +msgstr "Convertit :func:`raw_input` en :func:`input`." + +#: library/turtle.rst:174 library/turtle.rst:1305 msgid "Special Turtle methods" msgstr "" -#: ../src/Doc/library/turtle.rst:177 +#: library/turtle.rst:0 +msgid ":func:`begin_poly`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`end_poly`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`get_poly`" +msgstr "" + +#: library/turtle.rst:0 library/turtle.rst:2216 +msgid ":func:`clone`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`getturtle` | :func:`getpen`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`getscreen`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`setundobuffer`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`undobufferentries`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`tracer`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`window_width`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`window_height`" +msgstr "" + +#: library/turtle.rst:177 msgid "Methods of TurtleScreen/Screen" msgstr "" -#: ../src/Doc/library/turtle.rst:184 ../src/Doc/library/turtle.rst:1464 +#: library/turtle.rst:185 library/turtle.rst:1464 msgid "Window control" msgstr "" -#: ../src/Doc/library/turtle.rst:189 ../src/Doc/library/turtle.rst:1578 +#: library/turtle.rst:0 +msgid ":func:`bgcolor`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`bgpic`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`clear` | :func:`clearscreen`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`reset` | :func:`resetscreen`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`screensize`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`setworldcoordinates`" +msgstr "" + +#: library/turtle.rst:190 library/turtle.rst:1578 msgid "Animation control" msgstr "" -#: ../src/Doc/library/turtle.rst:195 ../src/Doc/library/turtle.rst:1627 +#: library/turtle.rst:0 +msgid ":func:`delay`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`update`" +msgstr "" + +#: library/turtle.rst:196 library/turtle.rst:1627 msgid "Using screen events" msgstr "" -#: ../src/Doc/library/turtle.rst:205 ../src/Doc/library/turtle.rst:1701 +#: library/turtle.rst:0 +msgid ":func:`listen`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`onkey`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`onclick` | :func:`onscreenclick`" +msgstr "" + +# 3d66a1d33bec4f06964092b1ad748825 +#: library/turtle.rst:0 +#, fuzzy +msgid ":func:`ontimer`" +msgstr ":exc:`RuntimeError`" + +#: library/turtle.rst:206 library/turtle.rst:1701 msgid "Settings and special methods" msgstr "" +#: library/turtle.rst:0 +msgid ":func:`mode`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`colormode`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`getcanvas`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`getshapes`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`register_shape` | :func:`addshape`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`turtles`" +msgstr "" + # dae399f2653d4b0f8158dc06f4c24e39 -#: ../src/Doc/library/turtle.rst:212 +#: library/turtle.rst:213 msgid "Methods specific to Screen" msgstr "" -#: ../src/Doc/library/turtle.rst:216 +#: library/turtle.rst:0 +msgid ":func:`bye`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`exitonclick`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`setup`" +msgstr "" + +#: library/turtle.rst:0 +msgid ":func:`title`" +msgstr "" + +#: library/turtle.rst:216 msgid "Methods of RawTurtle/Turtle and corresponding functions" msgstr "" -#: ../src/Doc/library/turtle.rst:218 +#: library/turtle.rst:218 msgid "" "Most of the examples in this section refer to a Turtle instance called " "``turtle``." msgstr "" -#: ../src/Doc/library/turtle.rst:229 +#: library/turtle.rst:227 library/turtle.rst:270 library/turtle.rst:293 +#: library/turtle.rst:349 library/turtle.rst:370 library/turtle.rst:391 +msgid "a number (integer or float)" +msgstr "" + +#: library/turtle.rst:229 msgid "" "Move the turtle forward by the specified *distance*, in the direction the " "turtle is headed." msgstr "" -#: ../src/Doc/library/turtle.rst:250 +#: library/turtle.rst:248 library/turtle.rst:438 library/turtle.rst:701 +#: library/turtle.rst:1175 library/turtle.rst:1193 +msgid "a number" +msgstr "" + +#: library/turtle.rst:250 msgid "" "Move the turtle backward by *distance*, opposite to the direction the turtle " "is headed. Do not change the turtle's heading." msgstr "" -#: ../src/Doc/library/turtle.rst:272 +#: library/turtle.rst:272 msgid "" "Turn turtle right by *angle* units. (Units are by default degrees, but can " "be set via the :func:`degrees` and :func:`radians` functions.) Angle " "orientation depends on the turtle mode, see :func:`mode`." msgstr "" -#: ../src/Doc/library/turtle.rst:295 +#: library/turtle.rst:295 msgid "" "Turn turtle left by *angle* units. (Units are by default degrees, but can " "be set via the :func:`degrees` and :func:`radians` functions.) Angle " "orientation depends on the turtle mode, see :func:`mode`." msgstr "" -#: ../src/Doc/library/turtle.rst:320 +#: library/turtle.rst:317 +msgid "a number or a pair/vector of numbers" +msgstr "" + +#: library/turtle.rst:318 +msgid "a number or ``None``" +msgstr "" + +#: library/turtle.rst:320 msgid "" "If *y* is ``None``, *x* must be a pair of coordinates or a :class:`Vec2D` (e." "g. as returned by :func:`pos`)." msgstr "" -#: ../src/Doc/library/turtle.rst:323 +#: library/turtle.rst:323 msgid "" "Move turtle to an absolute position. If the pen is down, draw line. Do not " "change the turtle's orientation." msgstr "" -#: ../src/Doc/library/turtle.rst:351 +#: library/turtle.rst:351 msgid "" "Set the turtle's first coordinate to *x*, leave second coordinate unchanged." msgstr "" -#: ../src/Doc/library/turtle.rst:372 +#: library/turtle.rst:372 msgid "" "Set the turtle's second coordinate to *y*, leave first coordinate unchanged." msgstr "" -#: ../src/Doc/library/turtle.rst:393 +#: library/turtle.rst:393 msgid "" "Set the orientation of the turtle to *to_angle*. Here are some common " "directions in degrees:" msgstr "" -#: ../src/Doc/library/turtle.rst:397 +#: library/turtle.rst:397 msgid "standard mode" msgstr "" -#: ../src/Doc/library/turtle.rst:397 +#: library/turtle.rst:397 msgid "logo mode" msgstr "" -#: ../src/Doc/library/turtle.rst:399 +#: library/turtle.rst:399 msgid "0 - east" msgstr "" -#: ../src/Doc/library/turtle.rst:399 +#: library/turtle.rst:399 msgid "0 - north" msgstr "" -#: ../src/Doc/library/turtle.rst:400 +#: library/turtle.rst:400 msgid "90 - north" msgstr "" -#: ../src/Doc/library/turtle.rst:400 +#: library/turtle.rst:400 msgid "90 - east" msgstr "" -#: ../src/Doc/library/turtle.rst:401 +#: library/turtle.rst:401 msgid "180 - west" msgstr "" -#: ../src/Doc/library/turtle.rst:401 +#: library/turtle.rst:401 msgid "180 - south" msgstr "" -#: ../src/Doc/library/turtle.rst:402 +#: library/turtle.rst:402 msgid "270 - south" msgstr "" -#: ../src/Doc/library/turtle.rst:402 +#: library/turtle.rst:402 msgid "270 - west" msgstr "" -#: ../src/Doc/library/turtle.rst:414 +#: library/turtle.rst:414 msgid "" "Move turtle to the origin -- coordinates (0,0) -- and set its heading to its " "start-orientation (which depends on the mode, see :func:`mode`)." msgstr "" -#: ../src/Doc/library/turtle.rst:442 +#: library/turtle.rst:439 +msgid "a number (or ``None``)" +msgstr "" + +#: library/turtle.rst:440 library/turtle.rst:530 +msgid "an integer (or ``None``)" +msgstr "" + +#: library/turtle.rst:442 msgid "" "Draw a circle with given *radius*. The center is *radius* units left of the " "turtle; *extent* -- an angle -- determines which part of the circle is " @@ -112993,93 +115616,117 @@ msgid "" "changed by the amount of *extent*." msgstr "" -#: ../src/Doc/library/turtle.rst:450 +#: library/turtle.rst:450 msgid "" "As the circle is approximated by an inscribed regular polygon, *steps* " "determines the number of steps to use. If not given, it will be calculated " "automatically. May be used to draw regular polygons." msgstr "" -#: ../src/Doc/library/turtle.rst:478 +#: library/turtle.rst:475 +msgid "an integer >= 1 (if given)" +msgstr "" + +#: library/turtle.rst:476 +msgid "a colorstring or a numeric color tuple" +msgstr "" + +#: library/turtle.rst:478 msgid "" "Draw a circular dot with diameter *size*, using *color*. If *size* is not " "given, the maximum of pensize+4 and 2*pensize is used." msgstr "" -#: ../src/Doc/library/turtle.rst:495 +#: library/turtle.rst:495 msgid "" "Stamp a copy of the turtle shape onto the canvas at the current turtle " "position. Return a stamp_id for that stamp, which can be used to delete it " "by calling ``clearstamp(stamp_id)``." msgstr "" -#: ../src/Doc/library/turtle.rst:512 +#: library/turtle.rst:509 +msgid "an integer, must be return value of previous :func:`stamp` call" +msgstr "" + +#: library/turtle.rst:512 msgid "Delete stamp with given *stampid*." msgstr "" -#: ../src/Doc/library/turtle.rst:532 +#: library/turtle.rst:532 msgid "" "Delete all or first/last *n* of turtle's stamps. If *n* is None, delete all " "stamps, if *n* > 0 delete first *n* stamps, else if *n* < 0 delete last *n* " "stamps." msgstr "" -#: ../src/Doc/library/turtle.rst:555 +#: library/turtle.rst:555 msgid "" "Undo (repeatedly) the last turtle action(s). Number of available undo " "actions is determined by the size of the undobuffer." msgstr "" -#: ../src/Doc/library/turtle.rst:571 +#: library/turtle.rst:569 +msgid "an integer in the range 0..10 or a speedstring (see below)" +msgstr "" + +#: library/turtle.rst:571 msgid "" "Set the turtle's speed to an integer value in the range 0..10. If no " "argument is given, return current speed." msgstr "" -#: ../src/Doc/library/turtle.rst:574 +#: library/turtle.rst:574 msgid "" "If input is a number greater than 10 or smaller than 0.5, speed is set to " "0. Speedstrings are mapped to speedvalues as follows:" msgstr "" -#: ../src/Doc/library/turtle.rst:577 +#: library/turtle.rst:577 msgid "\"fastest\": 0" msgstr "" -#: ../src/Doc/library/turtle.rst:578 +#: library/turtle.rst:578 msgid "\"fast\": 10" msgstr "" -#: ../src/Doc/library/turtle.rst:579 +#: library/turtle.rst:579 msgid "\"normal\": 6" msgstr "" -#: ../src/Doc/library/turtle.rst:580 +#: library/turtle.rst:580 msgid "\"slow\": 3" msgstr "" -#: ../src/Doc/library/turtle.rst:581 +#: library/turtle.rst:581 msgid "\"slowest\": 1" msgstr "" -#: ../src/Doc/library/turtle.rst:583 +#: library/turtle.rst:583 msgid "" "Speeds from 1 to 10 enforce increasingly faster animation of line drawing " "and turtle turning." msgstr "" -#: ../src/Doc/library/turtle.rst:586 +#: library/turtle.rst:586 msgid "" "Attention: *speed* = 0 means that *no* animation takes place. forward/back " "makes turtle jump and likewise left/right make the turtle turn instantly." msgstr "" -#: ../src/Doc/library/turtle.rst:608 +#: library/turtle.rst:608 msgid "" "Return the turtle's current location (x,y) (as a :class:`Vec2D` vector)." msgstr "" -#: ../src/Doc/library/turtle.rst:621 +#: library/turtle.rst:618 library/turtle.rst:677 +msgid "a number or a pair/vector of numbers or a turtle instance" +msgstr "" + +#: library/turtle.rst:619 library/turtle.rst:678 +msgid "a number if *x* is a number, else ``None``" +msgstr "" + +#: library/turtle.rst:621 msgid "" "Return the angle between the line from turtle position to position specified " "by (x,y), the vector or the other turtle. This depends on the turtle's " @@ -113087,104 +115734,116 @@ msgid "" "\"logo\")." msgstr "" -#: ../src/Doc/library/turtle.rst:634 +#: library/turtle.rst:634 msgid "Return the turtle's x coordinate." msgstr "" -#: ../src/Doc/library/turtle.rst:649 +#: library/turtle.rst:649 msgid "Return the turtle's y coordinate." msgstr "" -#: ../src/Doc/library/turtle.rst:664 +#: library/turtle.rst:664 msgid "" "Return the turtle's current heading (value depends on the turtle mode, see :" "func:`mode`)." msgstr "" -#: ../src/Doc/library/turtle.rst:680 +#: library/turtle.rst:680 msgid "" "Return the distance from the turtle to (x,y), the given vector, or the given " "other turtle, in turtle step units." msgstr "" -#: ../src/Doc/library/turtle.rst:697 +#: library/turtle.rst:697 msgid "Settings for measurement" msgstr "" -#: ../src/Doc/library/turtle.rst:703 +#: library/turtle.rst:703 msgid "" "Set angle measurement units, i.e. set number of \"degrees\" for a full " "circle. Default value is 360 degrees." msgstr "" -#: ../src/Doc/library/turtle.rst:725 +#: library/turtle.rst:725 msgid "" "Set the angle measurement units to radians. Equivalent to ``degrees(2*math." "pi)``." msgstr "" -#: ../src/Doc/library/turtle.rst:754 +#: library/turtle.rst:754 msgid "Pull the pen down -- drawing when moving." msgstr "" -#: ../src/Doc/library/turtle.rst:761 +#: library/turtle.rst:761 msgid "Pull the pen up -- no drawing when moving." msgstr "" -#: ../src/Doc/library/turtle.rst:769 +#: library/turtle.rst:767 +msgid "a positive number" +msgstr "" + +#: library/turtle.rst:769 msgid "" "Set the line thickness to *width* or return it. If resizemode is set to " "\"auto\" and turtleshape is a polygon, that polygon is drawn with the same " "line thickness. If no argument is given, the current pensize is returned." msgstr "" -#: ../src/Doc/library/turtle.rst:785 +#: library/turtle.rst:782 +msgid "a dictionary with some or all of the below listed keys" +msgstr "" + +#: library/turtle.rst:783 +msgid "one or more keyword-arguments with the below listed keys as keywords" +msgstr "" + +#: library/turtle.rst:785 msgid "" "Return or set the pen's attributes in a \"pen-dictionary\" with the " "following key/value pairs:" msgstr "" -#: ../src/Doc/library/turtle.rst:788 +#: library/turtle.rst:788 msgid "\"shown\": True/False" msgstr "" -#: ../src/Doc/library/turtle.rst:789 +#: library/turtle.rst:789 msgid "\"pendown\": True/False" msgstr "" -#: ../src/Doc/library/turtle.rst:790 +#: library/turtle.rst:790 msgid "\"pencolor\": color-string or color-tuple" msgstr "" -#: ../src/Doc/library/turtle.rst:791 +#: library/turtle.rst:791 msgid "\"fillcolor\": color-string or color-tuple" msgstr "" -#: ../src/Doc/library/turtle.rst:792 +#: library/turtle.rst:792 msgid "\"pensize\": positive number" msgstr "" -#: ../src/Doc/library/turtle.rst:793 +#: library/turtle.rst:793 msgid "\"speed\": number in range 0..10" msgstr "" -#: ../src/Doc/library/turtle.rst:794 +#: library/turtle.rst:794 msgid "\"resizemode\": \"auto\" or \"user\" or \"noresize\"" msgstr "" -#: ../src/Doc/library/turtle.rst:795 +#: library/turtle.rst:795 msgid "\"stretchfactor\": (positive number, positive number)" msgstr "" -#: ../src/Doc/library/turtle.rst:796 +#: library/turtle.rst:796 msgid "\"outline\": positive number" msgstr "" -#: ../src/Doc/library/turtle.rst:797 +#: library/turtle.rst:797 msgid "\"tilt\": number" msgstr "" -#: ../src/Doc/library/turtle.rst:799 +#: library/turtle.rst:799 msgid "" "This dictionary can be used as argument for a subsequent call to :func:`pen` " "to restore the former pen-state. Moreover one or more of these attributes " @@ -113192,181 +115851,173 @@ msgid "" "attributes in one statement." msgstr "" -#: ../src/Doc/library/turtle.rst:828 +#: library/turtle.rst:828 msgid "Return ``True`` if pen is down, ``False`` if it's up." msgstr "" -#: ../src/Doc/library/turtle.rst:845 +#: library/turtle.rst:845 msgid "Return or set the pencolor." msgstr "" -#: ../src/Doc/library/turtle.rst:847 ../src/Doc/library/turtle.rst:895 +#: library/turtle.rst:847 library/turtle.rst:895 msgid "Four input formats are allowed:" msgstr "" -# d1cd268ac0094b3998abe222c892a38d -#: ../src/Doc/library/turtle.rst:851 -msgid "``pencolor()``" +#: library/turtle.rst:852 +msgid "pencolor()" msgstr "" -#: ../src/Doc/library/turtle.rst:850 +#: library/turtle.rst:850 msgid "" "Return the current pencolor as color specification string or as a tuple (see " "example). May be used as input to another color/pencolor/fillcolor call." msgstr "" -# d3343f2ac09f41d2887fa8d1c334c468 -#: ../src/Doc/library/turtle.rst:855 -msgid "``pencolor(colorstring)``" +#: library/turtle.rst:856 +msgid "pencolor(colorstring)" msgstr "" -#: ../src/Doc/library/turtle.rst:855 +#: library/turtle.rst:855 msgid "" "Set pencolor to *colorstring*, which is a Tk color specification string, " "such as ``\"red\"``, ``\"yellow\"``, or ``\"#33cc8c\"``." msgstr "" -# 4dc8d044ade5475489b2784614cd842c -#: ../src/Doc/library/turtle.rst:860 -msgid "``pencolor((r, g, b))``" +#: library/turtle.rst:861 +msgid "pencolor((r, g, b))" msgstr "" -#: ../src/Doc/library/turtle.rst:859 +#: library/turtle.rst:859 msgid "" "Set pencolor to the RGB color represented by the tuple of *r*, *g*, and " "*b*. Each of *r*, *g*, and *b* must be in the range 0..colormode, where " "colormode is either 1.0 or 255 (see :func:`colormode`)." msgstr "" -# 73e242f4d6a14c349f4ab01e335e0bbd -#: ../src/Doc/library/turtle.rst:867 -msgid "``pencolor(r, g, b)``" +#: library/turtle.rst:868 +msgid "pencolor(r, g, b)" msgstr "" -#: ../src/Doc/library/turtle.rst:864 +#: library/turtle.rst:864 msgid "" "Set pencolor to the RGB color represented by *r*, *g*, and *b*. Each of " "*r*, *g*, and *b* must be in the range 0..colormode." msgstr "" -#: ../src/Doc/library/turtle.rst:867 +#: library/turtle.rst:867 msgid "" "If turtleshape is a polygon, the outline of that polygon is drawn with the " "newly set pencolor." msgstr "" -#: ../src/Doc/library/turtle.rst:893 +#: library/turtle.rst:893 msgid "Return or set the fillcolor." msgstr "" -# 974a1299b7824755aeacb5506078205c -#: ../src/Doc/library/turtle.rst:899 -msgid "``fillcolor()``" +#: library/turtle.rst:900 +msgid "fillcolor()" msgstr "" -#: ../src/Doc/library/turtle.rst:898 +#: library/turtle.rst:898 msgid "" "Return the current fillcolor as color specification string, possibly in " "tuple format (see example). May be used as input to another color/pencolor/" "fillcolor call." msgstr "" -# 7aff97fb697748d7a57f950db8c74dbe -#: ../src/Doc/library/turtle.rst:903 -msgid "``fillcolor(colorstring)``" +#: library/turtle.rst:904 +msgid "fillcolor(colorstring)" msgstr "" -#: ../src/Doc/library/turtle.rst:903 +#: library/turtle.rst:903 msgid "" "Set fillcolor to *colorstring*, which is a Tk color specification string, " "such as ``\"red\"``, ``\"yellow\"``, or ``\"#33cc8c\"``." msgstr "" -# 19836899c3c346c69c3d9cec41ff4c28 -#: ../src/Doc/library/turtle.rst:908 -msgid "``fillcolor((r, g, b))``" +#: library/turtle.rst:909 +msgid "fillcolor((r, g, b))" msgstr "" -#: ../src/Doc/library/turtle.rst:907 +#: library/turtle.rst:907 msgid "" "Set fillcolor to the RGB color represented by the tuple of *r*, *g*, and " "*b*. Each of *r*, *g*, and *b* must be in the range 0..colormode, where " "colormode is either 1.0 or 255 (see :func:`colormode`)." msgstr "" -# 79be519f78df4278bccd63c8b8c9654e -#: ../src/Doc/library/turtle.rst:915 -msgid "``fillcolor(r, g, b)``" +#: library/turtle.rst:916 +msgid "fillcolor(r, g, b)" msgstr "" -#: ../src/Doc/library/turtle.rst:912 +#: library/turtle.rst:912 msgid "" "Set fillcolor to the RGB color represented by *r*, *g*, and *b*. Each of " "*r*, *g*, and *b* must be in the range 0..colormode." msgstr "" -#: ../src/Doc/library/turtle.rst:915 +#: library/turtle.rst:915 msgid "" "If turtleshape is a polygon, the interior of that polygon is drawn with the " "newly set fillcolor." msgstr "" -#: ../src/Doc/library/turtle.rst:936 +#: library/turtle.rst:936 msgid "Return or set pencolor and fillcolor." msgstr "" -#: ../src/Doc/library/turtle.rst:938 +#: library/turtle.rst:938 msgid "" "Several input formats are allowed. They use 0 to 3 arguments as follows:" msgstr "" -# 429ce1f8bcaa434991364201506c6c0d -#: ../src/Doc/library/turtle.rst:943 -msgid "``color()``" +#: library/turtle.rst:944 +msgid "color()" msgstr "" -#: ../src/Doc/library/turtle.rst:942 +#: library/turtle.rst:942 msgid "" "Return the current pencolor and the current fillcolor as a pair of color " "specification strings or tuples as returned by :func:`pencolor` and :func:" "`fillcolor`." msgstr "" -# f59430745a2e434da6f73b0d6654f493 -#: ../src/Doc/library/turtle.rst:947 -msgid "``color(colorstring)``, ``color((r,g,b))``, ``color(r,g,b)``" +#: library/turtle.rst:948 +msgid "color(colorstring), color((r,g,b)), color(r,g,b)" msgstr "" -#: ../src/Doc/library/turtle.rst:947 +#: library/turtle.rst:947 msgid "" "Inputs as in :func:`pencolor`, set both, fillcolor and pencolor, to the " "given value." msgstr "" -# 28c2ee444170442b9f5a99dcd11ec59e -#: ../src/Doc/library/turtle.rst:954 -msgid "" -"``color(colorstring1, colorstring2)``, ``color((r1,g1,b1), (r2,g2,b2))``" +#: library/turtle.rst:955 +msgid "color(colorstring1, colorstring2), color((r1,g1,b1), (r2,g2,b2))" msgstr "" -#: ../src/Doc/library/turtle.rst:951 +#: library/turtle.rst:951 msgid "" "Equivalent to ``pencolor(colorstring1)`` and ``fillcolor(colorstring2)`` and " "analogously if the other input format is used." msgstr "" -#: ../src/Doc/library/turtle.rst:954 +#: library/turtle.rst:954 msgid "" "If turtleshape is a polygon, outline and interior of that polygon is drawn " "with the newly set colors." msgstr "" -#: ../src/Doc/library/turtle.rst:967 +#: library/turtle.rst:967 msgid "See also: Screen method :func:`colormode`." msgstr "" +#: library/turtle.rst:980 +msgid "True/False (or 1/0 respectively)" +msgstr "" + # ae4b2896fcf8417d9eac0ac4f2e9f4a8 -#: ../src/Doc/library/turtle.rst:982 +#: library/turtle.rst:982 msgid "" "Call ``fill(True)`` before drawing the shape you want to fill, and " "``fill(False)`` when done. When used without argument: return fillstate " @@ -113374,33 +116025,49 @@ msgid "" msgstr "" # 7445e8693e714a0dade5566e609b9982 -#: ../src/Doc/library/turtle.rst:998 +#: library/turtle.rst:998 msgid "" "Call just before drawing a shape to be filled. Equivalent to ``fill(True)``." msgstr "" # 2e2db8c77d4d42e7bad45d34257bf4ee -#: ../src/Doc/library/turtle.rst:1003 +#: library/turtle.rst:1003 msgid "" "Fill the shape drawn after the last call to :func:`begin_fill`. Equivalent " "to ``fill(False)``." msgstr "" -#: ../src/Doc/library/turtle.rst:1019 +#: library/turtle.rst:1019 msgid "" "Delete the turtle's drawings from the screen, re-center the turtle and set " "variables to the default values." msgstr "" -#: ../src/Doc/library/turtle.rst:1039 +#: library/turtle.rst:1039 msgid "" "Delete the turtle's drawings from the screen. Do not move turtle. State " "and position of the turtle as well as drawings of other turtles are not " "affected." msgstr "" +#: library/turtle.rst:1045 +msgid "object to be written to the TurtleScreen" +msgstr "" + +#: library/turtle.rst:1046 +msgid "True/False" +msgstr "" + +#: library/turtle.rst:1047 +msgid "one of the strings \"left\", \"center\" or right\"" +msgstr "" + +#: library/turtle.rst:1048 +msgid "a triple (fontname, fontsize, fonttype)" +msgstr "" + # feb4779bbb8148ed9ce8ba955dc83b45 -#: ../src/Doc/library/turtle.rst:1050 +#: library/turtle.rst:1050 msgid "" "Write text - the string representation of *arg* - at the current turtle " "position according to *align* (\"left\", \"center\" or right\") and with the " @@ -113408,23 +116075,27 @@ msgid "" "of the text. By default, *move* is ``False``." msgstr "" -#: ../src/Doc/library/turtle.rst:1068 +#: library/turtle.rst:1068 msgid "" "Make the turtle invisible. It's a good idea to do this while you're in the " "middle of doing some complex drawing, because hiding the turtle speeds up " "the drawing observably." msgstr "" -#: ../src/Doc/library/turtle.rst:1080 +#: library/turtle.rst:1080 msgid "Make the turtle visible." msgstr "" # ece715ec23644f7186d49bf9eb686118 -#: ../src/Doc/library/turtle.rst:1089 +#: library/turtle.rst:1089 msgid "Return ``True`` if the Turtle is shown, ``False`` if it's hidden." msgstr "" -#: ../src/Doc/library/turtle.rst:1106 +#: library/turtle.rst:1104 +msgid "a string which is a valid shapename" +msgstr "" + +#: library/turtle.rst:1106 msgid "" "Set turtle shape to shape with given *name* or, if name is not given, return " "name of current shape. Shape with *name* must exist in the TurtleScreen's " @@ -113433,35 +116104,43 @@ msgid "" "about how to deal with shapes see Screen method :func:`register_shape`." msgstr "" -#: ../src/Doc/library/turtle.rst:1125 +#: library/turtle.rst:1123 +msgid "one of the strings \"auto\", \"user\", \"noresize\"" +msgstr "" + +#: library/turtle.rst:1125 msgid "" "Set resizemode to one of the values: \"auto\", \"user\", \"noresize\". If " "*rmode* is not given, return current resizemode. Different resizemodes have " "the following effects:" msgstr "" -#: ../src/Doc/library/turtle.rst:1129 +#: library/turtle.rst:1129 msgid "" "\"auto\": adapts the appearance of the turtle corresponding to the value of " "pensize." msgstr "" -#: ../src/Doc/library/turtle.rst:1130 +#: library/turtle.rst:1130 msgid "" "\"user\": adapts the appearance of the turtle according to the values of " "stretchfactor and outlinewidth (outline), which are set by :func:`shapesize`." msgstr "" -#: ../src/Doc/library/turtle.rst:1133 +#: library/turtle.rst:1133 msgid "\"noresize\": no adaption of the turtle's appearance takes place." msgstr "" -#: ../src/Doc/library/turtle.rst:1135 +#: library/turtle.rst:1135 msgid "" "resizemode(\"user\") is called by :func:`shapesize` when used with arguments." msgstr "" -#: ../src/Doc/library/turtle.rst:1153 +#: library/turtle.rst:1149 library/turtle.rst:1150 library/turtle.rst:1151 +msgid "positive number" +msgstr "" + +#: library/turtle.rst:1153 msgid "" "Return or set the pen's attributes x/y-stretchfactors and/or outline. Set " "resizemode to \"user\". If and only if resizemode is set to \"user\", the " @@ -113471,13 +116150,13 @@ msgid "" "determines the width of the shapes's outline." msgstr "" -#: ../src/Doc/library/turtle.rst:1177 +#: library/turtle.rst:1177 msgid "" "Rotate the turtleshape by *angle* from its current tilt-angle, but do *not* " "change the turtle's heading (direction of movement)." msgstr "" -#: ../src/Doc/library/turtle.rst:1195 +#: library/turtle.rst:1195 msgid "" "Rotate the turtleshape to point in the direction specified by *angle*, " "regardless of its current tilt-angle. *Do not* change the turtle's heading " @@ -113485,85 +116164,108 @@ msgid "" msgstr "" # f00ff7d0c8a14436bacab682ce9423f0 -#: ../src/Doc/library/turtle.rst:1212 +#: library/turtle.rst:1212 msgid "" "Return the current tilt-angle, i.e. the angle between the orientation of the " "turtleshape and the heading of the turtle (its direction of movement)." msgstr "" -#: ../src/Doc/library/turtle.rst:1236 +#: library/turtle.rst:1230 library/turtle.rst:1251 library/turtle.rst:1275 +#: library/turtle.rst:1657 +msgid "" +"a function with two arguments which will be called with the coordinates of " +"the clicked point on the canvas" +msgstr "" + +#: library/turtle.rst:1232 library/turtle.rst:1253 library/turtle.rst:1277 +#: library/turtle.rst:1659 +msgid "number of the mouse-button, defaults to 1 (left mouse button)" +msgstr "" + +#: library/turtle.rst:1233 library/turtle.rst:1254 library/turtle.rst:1278 +#: library/turtle.rst:1660 +msgid "" +"``True`` or ``False`` -- if ``True``, a new binding will be added, otherwise " +"it will replace a former binding" +msgstr "" + +#: library/turtle.rst:1236 msgid "" "Bind *fun* to mouse-click events on this turtle. If *fun* is ``None``, " "existing bindings are removed. Example for the anonymous turtle, i.e. the " "procedural way:" msgstr "" -#: ../src/Doc/library/turtle.rst:1257 +#: library/turtle.rst:1257 msgid "" "Bind *fun* to mouse-button-release events on this turtle. If *fun* is " "``None``, existing bindings are removed." msgstr "" -#: ../src/Doc/library/turtle.rst:1281 +#: library/turtle.rst:1281 msgid "" "Bind *fun* to mouse-move events on this turtle. If *fun* is ``None``, " "existing bindings are removed." msgstr "" -#: ../src/Doc/library/turtle.rst:1284 +#: library/turtle.rst:1284 msgid "" "Remark: Every sequence of mouse-move-events on a turtle is preceded by a " "mouse-click event on that turtle." msgstr "" -#: ../src/Doc/library/turtle.rst:1291 +#: library/turtle.rst:1291 msgid "" "Subsequently, clicking and dragging the Turtle will move it across the " "screen thereby producing handdrawings (if pen is down)." msgstr "" # 01cd32633b7246e28255ad446ae58fb9 -#: ../src/Doc/library/turtle.rst:1298 +#: library/turtle.rst:1298 msgid "" "Starts event loop - calling Tkinter's mainloop function. Must be the last " "statement in a turtle graphics program." msgstr "" -#: ../src/Doc/library/turtle.rst:1309 +#: library/turtle.rst:1309 msgid "" "Start recording the vertices of a polygon. Current turtle position is first " "vertex of polygon." msgstr "" -#: ../src/Doc/library/turtle.rst:1315 +#: library/turtle.rst:1315 msgid "" "Stop recording the vertices of a polygon. Current turtle position is last " "vertex of polygon. This will be connected with the first vertex." msgstr "" -#: ../src/Doc/library/turtle.rst:1321 +#: library/turtle.rst:1321 msgid "Return the last recorded polygon." msgstr "" -#: ../src/Doc/library/turtle.rst:1339 +#: library/turtle.rst:1339 msgid "" "Create and return a clone of the turtle with same position, heading and " "turtle properties." msgstr "" -#: ../src/Doc/library/turtle.rst:1351 +#: library/turtle.rst:1351 msgid "" "Return the Turtle object itself. Only reasonable use: as a function to " "return the \"anonymous turtle\":" msgstr "" -#: ../src/Doc/library/turtle.rst:1364 +#: library/turtle.rst:1364 msgid "" "Return the :class:`TurtleScreen` object the turtle is drawing on. " "TurtleScreen methods can then be called for that object." msgstr "" -#: ../src/Doc/library/turtle.rst:1379 +#: library/turtle.rst:1377 +msgid "an integer or ``None``" +msgstr "" + +#: library/turtle.rst:1379 msgid "" "Set or disable undobuffer. If *size* is an integer an empty undobuffer of " "given size is installed. *size* gives the maximum number of turtle actions " @@ -113571,67 +116273,77 @@ msgid "" "``None``, the undobuffer is disabled." msgstr "" -#: ../src/Doc/library/turtle.rst:1391 +#: library/turtle.rst:1391 msgid "Return number of entries in the undobuffer." msgstr "" # ac90ab2142a341b1812affeee78af994 -#: ../src/Doc/library/turtle.rst:1401 +#: library/turtle.rst:1401 msgid "A replica of the corresponding TurtleScreen method." msgstr "" # 58117a57d1d140e0bdda482db4a23aa2 -#: ../src/Doc/library/turtle.rst:1409 +#: library/turtle.rst:1409 msgid "Both are replicas of the corresponding TurtleScreen methods." msgstr "" -#: ../src/Doc/library/turtle.rst:1417 +#: library/turtle.rst:1417 msgid "Excursus about the use of compound shapes" msgstr "" -#: ../src/Doc/library/turtle.rst:1419 +#: library/turtle.rst:1419 msgid "" "To use compound turtle shapes, which consist of several polygons of " "different color, you must use the helper class :class:`Shape` explicitly as " "described below:" msgstr "" -#: ../src/Doc/library/turtle.rst:1423 +#: library/turtle.rst:1423 msgid "Create an empty Shape object of type \"compound\"." msgstr "" -#: ../src/Doc/library/turtle.rst:1424 +#: library/turtle.rst:1424 msgid "" "Add as many components to this object as desired, using the :meth:" "`addcomponent` method." msgstr "" -#: ../src/Doc/library/turtle.rst:1437 +#: library/turtle.rst:1437 msgid "Now add the Shape to the Screen's shapelist and use it:" msgstr "" -#: ../src/Doc/library/turtle.rst:1447 +#: library/turtle.rst:1447 msgid "" "The :class:`Shape` class is used internally by the :func:`register_shape` " "method in different ways. The application programmer has to deal with the " "Shape class *only* when using compound shapes like shown above!" msgstr "" -#: ../src/Doc/library/turtle.rst:1453 +#: library/turtle.rst:1453 msgid "Methods of TurtleScreen/Screen and corresponding functions" msgstr "" -#: ../src/Doc/library/turtle.rst:1455 +#: library/turtle.rst:1455 msgid "" "Most of the examples in this section refer to a TurtleScreen instance called " "``screen``." msgstr "" -#: ../src/Doc/library/turtle.rst:1472 +#: library/turtle.rst:1468 +msgid "" +"a color string or three numbers in the range 0..colormode or a 3-tuple of " +"such numbers" +msgstr "" + +#: library/turtle.rst:1472 msgid "Set or return background color of the TurtleScreen." msgstr "" -#: ../src/Doc/library/turtle.rst:1488 +#: library/turtle.rst:1486 +msgid "a string, name of a gif-file or ``\"nopic\"``, or ``None``" +msgstr "" + +#: library/turtle.rst:1488 msgid "" "Set background image or return name of current backgroundimage. If " "*picname* is a filename, set the corresponding image as background. If " @@ -113639,32 +116351,44 @@ msgid "" "*picname* is ``None``, return the filename of the current backgroundimage. ::" msgstr "" -#: ../src/Doc/library/turtle.rst:1503 +#: library/turtle.rst:1503 msgid "" "Delete all drawings and all turtles from the TurtleScreen. Reset the now " "empty TurtleScreen to its initial state: white background, no background " "image, no event bindings and tracing on." msgstr "" -#: ../src/Doc/library/turtle.rst:1508 +#: library/turtle.rst:1508 msgid "" "This TurtleScreen method is available as a global function only under the " "name ``clearscreen``. The global function ``clear`` is another one derived " "from the Turtle method ``clear``." msgstr "" -#: ../src/Doc/library/turtle.rst:1516 +#: library/turtle.rst:1516 msgid "Reset all Turtles on the Screen to their initial state." msgstr "" -#: ../src/Doc/library/turtle.rst:1519 +#: library/turtle.rst:1519 msgid "" "This TurtleScreen method is available as a global function only under the " "name ``resetscreen``. The global function ``reset`` is another one derived " "from the Turtle method ``reset``." msgstr "" -#: ../src/Doc/library/turtle.rst:1530 +#: library/turtle.rst:1526 +msgid "positive integer, new width of canvas in pixels" +msgstr "" + +#: library/turtle.rst:1527 +msgid "positive integer, new height of canvas in pixels" +msgstr "" + +#: library/turtle.rst:1528 +msgid "colorstring or color-tuple, new background color" +msgstr "" + +#: library/turtle.rst:1530 msgid "" "If no arguments are given, return current (canvaswidth, canvasheight). Else " "resize the canvas the turtles are drawing on. Do not alter the drawing " @@ -113673,35 +116397,59 @@ msgid "" "outside the canvas before." msgstr "" -#: ../src/Doc/library/turtle.rst:1542 +#: library/turtle.rst:1542 msgid "e.g. to search for an erroneously escaped turtle ;-)" msgstr "" -#: ../src/Doc/library/turtle.rst:1552 +#: library/turtle.rst:1547 +msgid "a number, x-coordinate of lower left corner of canvas" +msgstr "" + +#: library/turtle.rst:1548 +msgid "a number, y-coordinate of lower left corner of canvas" +msgstr "" + +#: library/turtle.rst:1549 +msgid "a number, x-coordinate of upper right corner of canvas" +msgstr "" + +#: library/turtle.rst:1550 +msgid "a number, y-coordinate of upper right corner of canvas" +msgstr "" + +#: library/turtle.rst:1552 msgid "" "Set up user-defined coordinate system and switch to mode \"world\" if " "necessary. This performs a ``screen.reset()``. If mode \"world\" is " "already active, all drawings are redrawn according to the new coordinates." msgstr "" -#: ../src/Doc/library/turtle.rst:1556 +#: library/turtle.rst:1556 msgid "" "**ATTENTION**: in user-defined coordinate systems angles may appear " "distorted." msgstr "" -#: ../src/Doc/library/turtle.rst:1584 +#: library/turtle.rst:1582 +msgid "positive integer" +msgstr "" + +#: library/turtle.rst:1584 msgid "" "Set or return the drawing *delay* in milliseconds. (This is approximately " "the time interval between two consecutive canvas updates.) The longer the " "drawing delay, the slower the animation." msgstr "" -#: ../src/Doc/library/turtle.rst:1588 +#: library/turtle.rst:1588 msgid "Optional argument:" msgstr "" -#: ../src/Doc/library/turtle.rst:1604 +#: library/turtle.rst:1601 library/turtle.rst:1602 +msgid "nonnegative integer" +msgstr "" + +#: library/turtle.rst:1604 msgid "" "Turn turtle animation on/off and set delay for update drawings. If *n* is " "given, only each n-th regular screen update is really performed. (Can be " @@ -113709,58 +116457,78 @@ msgid "" "delay value (see :func:`delay`)." msgstr "" -#: ../src/Doc/library/turtle.rst:1621 +#: library/turtle.rst:1621 msgid "Perform a TurtleScreen update. To be used when tracer is turned off." msgstr "" -#: ../src/Doc/library/turtle.rst:1623 +#: library/turtle.rst:1623 msgid "See also the RawTurtle/Turtle method :func:`speed`." msgstr "" -#: ../src/Doc/library/turtle.rst:1631 +#: library/turtle.rst:1631 msgid "" "Set focus on TurtleScreen (in order to collect key-events). Dummy arguments " "are provided in order to be able to pass :func:`listen` to the onclick " "method." msgstr "" -#: ../src/Doc/library/turtle.rst:1640 +#: library/turtle.rst:1637 +msgid "a function with no arguments or ``None``" +msgstr "" + +#: library/turtle.rst:1638 +msgid "a string: key (e.g. \"a\") or key-symbol (e.g. \"space\")" +msgstr "" + +#: library/turtle.rst:1640 msgid "" "Bind *fun* to key-release event of key. If *fun* is ``None``, event " "bindings are removed. Remark: in order to be able to register key-events, " "TurtleScreen must have the focus. (See method :func:`listen`.)" msgstr "" -#: ../src/Doc/library/turtle.rst:1663 +#: library/turtle.rst:1663 msgid "" "Bind *fun* to mouse-click events on this screen. If *fun* is ``None``, " "existing bindings are removed." msgstr "" -#: ../src/Doc/library/turtle.rst:1666 +#: library/turtle.rst:1666 msgid "" "Example for a TurtleScreen instance named ``screen`` and a Turtle instance " "named turtle:" msgstr "" -#: ../src/Doc/library/turtle.rst:1676 +#: library/turtle.rst:1676 msgid "" "This TurtleScreen method is available as a global function only under the " "name ``onscreenclick``. The global function ``onclick`` is another one " "derived from the Turtle method ``onclick``." msgstr "" -#: ../src/Doc/library/turtle.rst:1686 +#: library/turtle.rst:1683 +msgid "a function with no arguments" +msgstr "" + +#: library/turtle.rst:1684 +msgid "a number >= 0" +msgstr "" + +#: library/turtle.rst:1686 msgid "Install a timer that calls *fun* after *t* milliseconds." msgstr "" -#: ../src/Doc/library/turtle.rst:1707 +#: library/turtle.rst:1705 +msgid "one of the strings \"standard\", \"logo\" or \"world\"" +msgstr "" + +#: library/turtle.rst:1707 msgid "" "Set turtle mode (\"standard\", \"logo\" or \"world\") and perform reset. If " "mode is not given, current mode is returned." msgstr "" -#: ../src/Doc/library/turtle.rst:1710 +#: library/turtle.rst:1710 msgid "" "Mode \"standard\" is compatible with old :mod:`turtle`. Mode \"logo\" is " "compatible with most Logo turtle graphics. Mode \"world\" uses user-defined " @@ -113768,113 +116536,117 @@ msgid "" "if ``x/y`` unit-ratio doesn't equal 1." msgstr "" -#: ../src/Doc/library/turtle.rst:1716 +#: library/turtle.rst:1716 msgid "Initial turtle heading" msgstr "" -#: ../src/Doc/library/turtle.rst:1716 +#: library/turtle.rst:1716 msgid "positive angles" msgstr "" -#: ../src/Doc/library/turtle.rst:1718 +#: library/turtle.rst:1718 msgid "\"standard\"" msgstr "" -#: ../src/Doc/library/turtle.rst:1718 +#: library/turtle.rst:1718 msgid "to the right (east)" msgstr "" -#: ../src/Doc/library/turtle.rst:1718 +#: library/turtle.rst:1718 msgid "counterclockwise" msgstr "" -#: ../src/Doc/library/turtle.rst:1719 +#: library/turtle.rst:1719 msgid "\"logo\"" msgstr "" -#: ../src/Doc/library/turtle.rst:1719 +#: library/turtle.rst:1719 msgid "upward (north)" msgstr "" -#: ../src/Doc/library/turtle.rst:1719 +#: library/turtle.rst:1719 msgid "clockwise" msgstr "" -#: ../src/Doc/library/turtle.rst:1733 +#: library/turtle.rst:1731 +msgid "one of the values 1.0 or 255" +msgstr "" + +#: library/turtle.rst:1733 msgid "" "Return the colormode or set it to 1.0 or 255. Subsequently *r*, *g*, *b* " "values of color triples have to be in the range 0..\\ *cmode*." msgstr "" -#: ../src/Doc/library/turtle.rst:1753 +#: library/turtle.rst:1753 msgid "" "Return the Canvas of this TurtleScreen. Useful for insiders who know what " "to do with a Tkinter Canvas." msgstr "" -#: ../src/Doc/library/turtle.rst:1765 +#: library/turtle.rst:1765 msgid "Return a list of names of all currently available turtle shapes." msgstr "" -#: ../src/Doc/library/turtle.rst:1776 +#: library/turtle.rst:1776 msgid "There are three different ways to call this function:" msgstr "" -#: ../src/Doc/library/turtle.rst:1778 +#: library/turtle.rst:1778 msgid "" "*name* is the name of a gif-file and *shape* is ``None``: Install the " "corresponding image shape. ::" msgstr "" -#: ../src/Doc/library/turtle.rst:1784 +#: library/turtle.rst:1784 msgid "" "Image shapes *do not* rotate when turning the turtle, so they do not display " "the heading of the turtle!" msgstr "" -#: ../src/Doc/library/turtle.rst:1787 +#: library/turtle.rst:1787 msgid "" "*name* is an arbitrary string and *shape* is a tuple of pairs of " "coordinates: Install the corresponding polygon shape." msgstr "" -#: ../src/Doc/library/turtle.rst:1794 +#: library/turtle.rst:1794 msgid "" "*name* is an arbitrary string and shape is a (compound) :class:`Shape` " "object: Install the corresponding compound shape." msgstr "" -#: ../src/Doc/library/turtle.rst:1797 +#: library/turtle.rst:1797 msgid "" "Add a turtle shape to TurtleScreen's shapelist. Only thusly registered " "shapes can be used by issuing the command ``shape(shapename)``." msgstr "" -#: ../src/Doc/library/turtle.rst:1803 +#: library/turtle.rst:1803 msgid "Return the list of turtles on the screen." msgstr "" -#: ../src/Doc/library/turtle.rst:1813 +#: library/turtle.rst:1813 msgid "Return the height of the turtle window. ::" msgstr "" -#: ../src/Doc/library/turtle.rst:1821 +#: library/turtle.rst:1821 msgid "Return the width of the turtle window. ::" msgstr "" -#: ../src/Doc/library/turtle.rst:1830 +#: library/turtle.rst:1830 msgid "Methods specific to Screen, not inherited from TurtleScreen" msgstr "" -#: ../src/Doc/library/turtle.rst:1834 +#: library/turtle.rst:1834 msgid "Shut the turtlegraphics window." msgstr "" -#: ../src/Doc/library/turtle.rst:1839 +#: library/turtle.rst:1839 msgid "Bind bye() method to mouse clicks on the Screen." msgstr "" -#: ../src/Doc/library/turtle.rst:1842 +#: library/turtle.rst:1842 msgid "" "If the value \"using_IDLE\" in the configuration dictionary is ``False`` " "(default value), also enter mainloop. Remark: If IDLE with the ``-n`` " @@ -113884,178 +116656,242 @@ msgid "" msgstr "" # 86d4e60c13594061949d44d5a6c018d6 -#: ../src/Doc/library/turtle.rst:1851 +#: library/turtle.rst:1851 msgid "" "Set the size and position of the main window. Default values of arguments " "are stored in the configuration dictionary and can be changed via a :file:" "`turtle.cfg` file." msgstr "" -#: ../src/Doc/library/turtle.rst:1879 +#: library/turtle.rst:1855 +msgid "" +"if an integer, a size in pixels, if a float, a fraction of the screen; " +"default is 50% of screen" +msgstr "" + +#: library/turtle.rst:1857 +msgid "" +"if an integer, the height in pixels, if a float, a fraction of the screen; " +"default is 75% of screen" +msgstr "" + +#: library/turtle.rst:1859 +msgid "" +"if positive, starting position in pixels from the left edge of the screen, " +"if negative from the right edge, if None, center window horizontally" +msgstr "" + +#: library/turtle.rst:1862 +msgid "" +"if positive, starting position in pixels from the top edge of the screen, if " +"negative from the bottom edge, if None, center window vertically" +msgstr "" + +#: library/turtle.rst:1876 +msgid "a string that is shown in the titlebar of the turtle graphics window" +msgstr "" + +#: library/turtle.rst:1879 msgid "Set title of turtle window to *titlestring*." msgstr "" -#: ../src/Doc/library/turtle.rst:1887 +#: library/turtle.rst:1887 msgid "The public classes of the module :mod:`turtle`" msgstr "" -#: ../src/Doc/library/turtle.rst:1896 +#: library/turtle.rst:1893 +msgid "" +"a :class:`Tkinter.Canvas`, a :class:`ScrolledCanvas` or a :class:" +"`TurtleScreen`" +msgstr "" + +#: library/turtle.rst:1896 msgid "" "Create a turtle. The turtle has all methods described above as \"methods of " "Turtle/RawTurtle\"." msgstr "" -#: ../src/Doc/library/turtle.rst:1902 +#: library/turtle.rst:1902 msgid "" "Subclass of RawTurtle, has the same interface but draws on a default :class:" "`Screen` object created automatically when needed for the first time." msgstr "" -#: ../src/Doc/library/turtle.rst:1910 +#: library/turtle.rst:1908 +msgid "a :class:`Tkinter.Canvas`" +msgstr "" + +#: library/turtle.rst:1910 msgid "" "Provides screen oriented methods like :func:`setbg` etc. that are described " "above." msgstr "" -#: ../src/Doc/library/turtle.rst:1915 +#: library/turtle.rst:1915 msgid "" "Subclass of TurtleScreen, with :ref:`four methods added <screenspecific>`." msgstr "" -#: ../src/Doc/library/turtle.rst:1923 +#: library/turtle.rst:1920 +msgid "" +"some Tkinter widget to contain the ScrolledCanvas, i.e. a Tkinter-canvas " +"with scrollbars added" +msgstr "" + +#: library/turtle.rst:1923 msgid "" "Used by class Screen, which thus automatically provides a ScrolledCanvas as " "playground for the turtles." msgstr "" -#: ../src/Doc/library/turtle.rst:1930 +#: library/turtle.rst:1928 +msgid "one of the strings \"polygon\", \"image\", \"compound\"" +msgstr "" + +#: library/turtle.rst:1930 msgid "" "Data structure modeling shapes. The pair ``(type_, data)`` must follow this " "specification:" msgstr "" -#: ../src/Doc/library/turtle.rst:1935 +#: library/turtle.rst:1935 msgid "*type_*" msgstr "" -#: ../src/Doc/library/turtle.rst:1935 +#: library/turtle.rst:1935 msgid "*data*" msgstr "" -#: ../src/Doc/library/turtle.rst:1937 +#: library/turtle.rst:1937 msgid "\"polygon\"" msgstr "" -#: ../src/Doc/library/turtle.rst:1937 +#: library/turtle.rst:1937 msgid "a polygon-tuple, i.e. a tuple of pairs of coordinates" msgstr "" -#: ../src/Doc/library/turtle.rst:1938 +#: library/turtle.rst:1938 msgid "\"image\"" msgstr "" -#: ../src/Doc/library/turtle.rst:1938 +#: library/turtle.rst:1938 msgid "an image (in this form only used internally!)" msgstr "" -#: ../src/Doc/library/turtle.rst:1939 +#: library/turtle.rst:1939 msgid "\"compound\"" msgstr "" -#: ../src/Doc/library/turtle.rst:1939 +#: library/turtle.rst:1939 msgid "" "``None`` (a compound shape has to be constructed using the :meth:" "`addcomponent` method)" msgstr "" -#: ../src/Doc/library/turtle.rst:1958 +#: library/turtle.rst:1945 +msgid "a polygon, i.e. a tuple of pairs of numbers" +msgstr "" + +#: library/turtle.rst:1946 +msgid "a color the *poly* will be filled with" +msgstr "" + +#: library/turtle.rst:1947 +msgid "a color for the poly's outline (if given)" +msgstr "" + +#: library/turtle.rst:1958 msgid "See :ref:`compoundshapes`." msgstr "" -#: ../src/Doc/library/turtle.rst:1963 +#: library/turtle.rst:1963 msgid "" "A two-dimensional vector class, used as a helper class for implementing " "turtle graphics. May be useful for turtle graphics programs too. Derived " "from tuple, so a vector is a tuple!" msgstr "" -#: ../src/Doc/library/turtle.rst:1967 +#: library/turtle.rst:1967 msgid "Provides (for *a*, *b* vectors, *k* number):" msgstr "" -#: ../src/Doc/library/turtle.rst:1969 +#: library/turtle.rst:1969 msgid "``a + b`` vector addition" msgstr "" -#: ../src/Doc/library/turtle.rst:1970 +#: library/turtle.rst:1970 msgid "``a - b`` vector subtraction" msgstr "" -#: ../src/Doc/library/turtle.rst:1971 +#: library/turtle.rst:1971 msgid "``a * b`` inner product" msgstr "" -#: ../src/Doc/library/turtle.rst:1972 +#: library/turtle.rst:1972 msgid "``k * a`` and ``a * k`` multiplication with scalar" msgstr "" -#: ../src/Doc/library/turtle.rst:1973 +#: library/turtle.rst:1973 msgid "``abs(a)`` absolute value of a" msgstr "" -#: ../src/Doc/library/turtle.rst:1974 +#: library/turtle.rst:1974 msgid "``a.rotate(angle)`` rotation" msgstr "" -#: ../src/Doc/library/turtle.rst:1978 +#: library/turtle.rst:1978 msgid "Help and configuration" msgstr "" -#: ../src/Doc/library/turtle.rst:1981 +#: library/turtle.rst:1981 msgid "How to use help" msgstr "" -#: ../src/Doc/library/turtle.rst:1983 +#: library/turtle.rst:1983 msgid "" "The public methods of the Screen and Turtle classes are documented " "extensively via docstrings. So these can be used as online-help via the " "Python help facilities:" msgstr "" -#: ../src/Doc/library/turtle.rst:1987 +#: library/turtle.rst:1987 msgid "" "When using IDLE, tooltips show the signatures and first lines of the " "docstrings of typed in function-/method calls." msgstr "" -#: ../src/Doc/library/turtle.rst:1990 +#: library/turtle.rst:1990 msgid "Calling :func:`help` on methods or functions displays the docstrings::" msgstr "" -#: ../src/Doc/library/turtle.rst:2021 +#: library/turtle.rst:2021 msgid "" "The docstrings of the functions which are derived from methods have a " "modified form::" msgstr "" -#: ../src/Doc/library/turtle.rst:2055 +#: library/turtle.rst:2055 msgid "" "These modified docstrings are created automatically together with the " "function definitions that are derived from the methods at import time." msgstr "" -#: ../src/Doc/library/turtle.rst:2060 +#: library/turtle.rst:2060 msgid "Translation of docstrings into different languages" msgstr "" -#: ../src/Doc/library/turtle.rst:2062 +#: library/turtle.rst:2062 msgid "" "There is a utility to create a dictionary the keys of which are the method " "names and the values of which are the docstrings of the public methods of " "the classes Screen and Turtle." msgstr "" -#: ../src/Doc/library/turtle.rst:2070 +#: library/turtle.rst:2068 +msgid "a string, used as filename" +msgstr "" + +#: library/turtle.rst:2070 msgid "" "Create and write docstring-dictionary to a Python script with the given " "filename. This function has to be called explicitly (it is not used by the " @@ -114064,37 +116900,37 @@ msgid "" "for translation of the docstrings into different languages." msgstr "" -#: ../src/Doc/library/turtle.rst:2076 +#: library/turtle.rst:2076 msgid "" "If you (or your students) want to use :mod:`turtle` with online help in your " "native language, you have to translate the docstrings and save the resulting " "file as e.g. :file:`turtle_docstringdict_german.py`." msgstr "" -#: ../src/Doc/library/turtle.rst:2080 +#: library/turtle.rst:2080 msgid "" "If you have an appropriate entry in your :file:`turtle.cfg` file this " "dictionary will be read in at import time and will replace the original " "English docstrings." msgstr "" -#: ../src/Doc/library/turtle.rst:2083 +#: library/turtle.rst:2083 msgid "" "At the time of this writing there are docstring dictionaries in German and " "in Italian. (Requests please to glingl@aon.at.)" msgstr "" -#: ../src/Doc/library/turtle.rst:2089 +#: library/turtle.rst:2089 msgid "How to configure Screen and Turtles" msgstr "" -#: ../src/Doc/library/turtle.rst:2091 +#: library/turtle.rst:2091 msgid "" "The built-in default configuration mimics the appearance and behaviour of " "the old turtle module in order to retain best possible compatibility with it." msgstr "" -#: ../src/Doc/library/turtle.rst:2094 +#: library/turtle.rst:2094 msgid "" "If you want to use a different configuration which better reflects the " "features of this module or which better fits to your needs, e.g. for use in " @@ -114103,54 +116939,54 @@ msgid "" "settings." msgstr "" -#: ../src/Doc/library/turtle.rst:2099 +#: library/turtle.rst:2099 msgid "" "The built in configuration would correspond to the following turtle.cfg::" msgstr "" -#: ../src/Doc/library/turtle.rst:2122 +#: library/turtle.rst:2122 msgid "Short explanation of selected entries:" msgstr "" -#: ../src/Doc/library/turtle.rst:2124 +#: library/turtle.rst:2124 msgid "" "The first four lines correspond to the arguments of the :meth:`Screen.setup` " "method." msgstr "" -#: ../src/Doc/library/turtle.rst:2126 +#: library/turtle.rst:2126 msgid "" "Line 5 and 6 correspond to the arguments of the method :meth:`Screen." "screensize`." msgstr "" -#: ../src/Doc/library/turtle.rst:2128 +#: library/turtle.rst:2128 msgid "" "*shape* can be any of the built-in shapes, e.g: arrow, turtle, etc. For " "more info try ``help(shape)``." msgstr "" -#: ../src/Doc/library/turtle.rst:2130 +#: library/turtle.rst:2130 msgid "" "If you want to use no fillcolor (i.e. make the turtle transparent), you have " "to write ``fillcolor = \"\"`` (but all nonempty strings must not have quotes " "in the cfg-file)." msgstr "" -#: ../src/Doc/library/turtle.rst:2133 +#: library/turtle.rst:2133 msgid "" "If you want to reflect the turtle its state, you have to use ``resizemode = " "auto``." msgstr "" -#: ../src/Doc/library/turtle.rst:2135 +#: library/turtle.rst:2135 msgid "" "If you set e.g. ``language = italian`` the docstringdict :file:" "`turtle_docstringdict_italian.py` will be loaded at import time (if present " "on the import path, e.g. in the same directory as :mod:`turtle`." msgstr "" -#: ../src/Doc/library/turtle.rst:2138 +#: library/turtle.rst:2138 msgid "" "The entries *exampleturtle* and *examplescreen* define the names of these " "objects as they occur in the docstrings. The transformation of method-" @@ -114158,253 +116994,233 @@ msgid "" "docstrings." msgstr "" -#: ../src/Doc/library/turtle.rst:2142 +#: library/turtle.rst:2142 msgid "" "*using_IDLE*: Set this to ``True`` if you regularly work with IDLE and its -" "n switch (\"no subprocess\"). This will prevent :func:`exitonclick` to " "enter the mainloop." msgstr "" -#: ../src/Doc/library/turtle.rst:2146 +#: library/turtle.rst:2146 msgid "" "There can be a :file:`turtle.cfg` file in the directory where :mod:`turtle` " "is stored and an additional one in the current working directory. The " "latter will override the settings of the first one." msgstr "" -#: ../src/Doc/library/turtle.rst:2150 +#: library/turtle.rst:2150 msgid "" "The :file:`Demo/turtle` directory contains a :file:`turtle.cfg` file. You " "can study it as an example and see its effects when running the demos " "(preferably not from within the demo-viewer)." msgstr "" -#: ../src/Doc/library/turtle.rst:2156 +#: library/turtle.rst:2156 msgid "Demo scripts" msgstr "" -#: ../src/Doc/library/turtle.rst:2158 +#: library/turtle.rst:2158 msgid "" "There is a set of demo scripts in the turtledemo directory located in the :" "file:`Demo/turtle` directory in the source distribution." msgstr "" -#: ../src/Doc/library/turtle.rst:2161 +#: library/turtle.rst:2161 msgid "It contains:" msgstr "" -#: ../src/Doc/library/turtle.rst:2163 +#: library/turtle.rst:2163 msgid "" "a set of 15 demo scripts demonstrating different features of the new module :" "mod:`turtle`" msgstr "" -#: ../src/Doc/library/turtle.rst:2165 +#: library/turtle.rst:2165 msgid "" "a demo viewer :file:`turtleDemo.py` which can be used to view the sourcecode " "of the scripts and run them at the same time. 14 of the examples can be " "accessed via the Examples menu; all of them can also be run standalone." msgstr "" -#: ../src/Doc/library/turtle.rst:2168 +#: library/turtle.rst:2168 msgid "" "The example :file:`turtledemo_two_canvases.py` demonstrates the simultaneous " "use of two canvases with the turtle module. Therefore it only can be run " "standalone." msgstr "" -#: ../src/Doc/library/turtle.rst:2171 +#: library/turtle.rst:2171 msgid "" "There is a :file:`turtle.cfg` file in this directory, which also serves as " "an example for how to write and use such files." msgstr "" -#: ../src/Doc/library/turtle.rst:2174 +#: library/turtle.rst:2174 msgid "The demoscripts are:" msgstr "" -#: ../src/Doc/library/turtle.rst:2181 +#: library/turtle.rst:2181 msgid "bytedesign" msgstr "" -#: ../src/Doc/library/turtle.rst:2181 +#: library/turtle.rst:2181 msgid "complex classical turtlegraphics pattern" msgstr "" -#: ../src/Doc/library/turtle.rst:2181 +#: library/turtle.rst:2181 msgid ":func:`tracer`, delay, :func:`update`" msgstr "" -#: ../src/Doc/library/turtle.rst:2184 +#: library/turtle.rst:2184 msgid "chaos" msgstr "" # 9aab3700ff5a41a19266303ee9b0cd7d -#: ../src/Doc/library/turtle.rst:2184 +#: library/turtle.rst:2184 msgid "" "graphs Verhulst dynamics, shows that computer's computations can generate " "results sometimes against the common sense expectations" msgstr "" -#: ../src/Doc/library/turtle.rst:2184 +#: library/turtle.rst:2184 msgid "world coordinates" msgstr "" -#: ../src/Doc/library/turtle.rst:2190 +#: library/turtle.rst:2190 msgid "clock" msgstr "" -#: ../src/Doc/library/turtle.rst:2190 +#: library/turtle.rst:2190 msgid "analog clock showing time of your computer" msgstr "" -#: ../src/Doc/library/turtle.rst:2190 +#: library/turtle.rst:2190 msgid "turtles as clock's hands, ontimer" msgstr "" -#: ../src/Doc/library/turtle.rst:2193 +#: library/turtle.rst:2193 msgid "colormixer" msgstr "" -#: ../src/Doc/library/turtle.rst:2193 +#: library/turtle.rst:2193 msgid "experiment with r, g, b" msgstr "" -#: ../src/Doc/library/turtle.rst:2193 -msgid ":func:`ondrag`" -msgstr "" - -#: ../src/Doc/library/turtle.rst:2195 +#: library/turtle.rst:2195 msgid "fractalcurves" msgstr "" -#: ../src/Doc/library/turtle.rst:2195 +#: library/turtle.rst:2195 msgid "Hilbert & Koch curves" msgstr "" -#: ../src/Doc/library/turtle.rst:2195 +#: library/turtle.rst:2195 msgid "recursion" msgstr "" -#: ../src/Doc/library/turtle.rst:2197 +#: library/turtle.rst:2197 msgid "lindenmayer" msgstr "" -#: ../src/Doc/library/turtle.rst:2197 +#: library/turtle.rst:2197 msgid "ethnomathematics (indian kolams)" msgstr "" -#: ../src/Doc/library/turtle.rst:2197 +#: library/turtle.rst:2197 msgid "L-System" msgstr "" -#: ../src/Doc/library/turtle.rst:2200 +#: library/turtle.rst:2200 msgid "minimal_hanoi" msgstr "" -#: ../src/Doc/library/turtle.rst:2200 +#: library/turtle.rst:2200 msgid "Towers of Hanoi" msgstr "" -#: ../src/Doc/library/turtle.rst:2200 +#: library/turtle.rst:2200 msgid "Rectangular Turtles as Hanoi discs (shape, shapesize)" msgstr "" -#: ../src/Doc/library/turtle.rst:2204 +#: library/turtle.rst:2204 msgid "paint" msgstr "" -#: ../src/Doc/library/turtle.rst:2204 +#: library/turtle.rst:2204 msgid "super minimalistic drawing program" msgstr "" -#: ../src/Doc/library/turtle.rst:2204 -msgid ":func:`onclick`" -msgstr "" - -#: ../src/Doc/library/turtle.rst:2207 +#: library/turtle.rst:2207 msgid "peace" msgstr "" -#: ../src/Doc/library/turtle.rst:2207 +#: library/turtle.rst:2207 msgid "elementary" msgstr "" -#: ../src/Doc/library/turtle.rst:2207 +#: library/turtle.rst:2207 msgid "turtle: appearance and animation" msgstr "" -#: ../src/Doc/library/turtle.rst:2210 +#: library/turtle.rst:2210 msgid "penrose" msgstr "" -#: ../src/Doc/library/turtle.rst:2210 +#: library/turtle.rst:2210 msgid "aperiodic tiling with kites and darts" msgstr "" -#: ../src/Doc/library/turtle.rst:2210 -msgid ":func:`stamp`" -msgstr "" - -#: ../src/Doc/library/turtle.rst:2213 +#: library/turtle.rst:2213 msgid "planet_and_moon" msgstr "" -#: ../src/Doc/library/turtle.rst:2213 +#: library/turtle.rst:2213 msgid "simulation of gravitational system" msgstr "" -#: ../src/Doc/library/turtle.rst:2213 +#: library/turtle.rst:2213 msgid "compound shapes, :class:`Vec2D`" msgstr "" -#: ../src/Doc/library/turtle.rst:2216 +#: library/turtle.rst:2216 msgid "a (graphical) breadth first tree (using generators)" msgstr "" -#: ../src/Doc/library/turtle.rst:2216 -msgid ":func:`clone`" -msgstr "" - -#: ../src/Doc/library/turtle.rst:2219 +#: library/turtle.rst:2219 msgid "wikipedia" msgstr "" -#: ../src/Doc/library/turtle.rst:2219 +#: library/turtle.rst:2219 msgid "a pattern from the wikipedia article on turtle graphics" msgstr "" -#: ../src/Doc/library/turtle.rst:2219 +#: library/turtle.rst:2219 msgid ":func:`clone`, :func:`undo`" msgstr "" -#: ../src/Doc/library/turtle.rst:2222 +#: library/turtle.rst:2222 msgid "yingyang" msgstr "" -#: ../src/Doc/library/turtle.rst:2222 +#: library/turtle.rst:2222 msgid "another elementary example" msgstr "" -#: ../src/Doc/library/turtle.rst:2222 -msgid ":func:`circle`" -msgstr "" - -#: ../src/Doc/library/turtle.rst:2225 +#: library/turtle.rst:2225 msgid "Have fun!" msgstr "" -#: ../src/Doc/library/types.rst:2 +#: library/types.rst:2 msgid ":mod:`types` --- Names for built-in types" msgstr "" # 8f7d3b3d63c64b66ac9a899c04e720ce -#: ../src/Doc/library/types.rst:7 +#: library/types.rst:7 msgid "**Source code:** :source:`Lib/types.py`" msgstr "" # b1ddd4dbf3a04c0d8edaa5d511308ab0 -#: ../src/Doc/library/types.rst:11 +#: library/types.rst:11 msgid "" "This module defines names for some object types that are used by the " "standard Python interpreter, but not for the types defined by various " @@ -114416,14 +117232,14 @@ msgid "" msgstr "" # 3964a4d551ee4c1685567a93b15942f4 -#: ../src/Doc/library/types.rst:18 +#: library/types.rst:18 msgid "" "Typical use is for functions that do different things depending on their " "argument types, like the following::" msgstr "" # 4bc79aa99ae24e669d04f0bd8d49dd22 -#: ../src/Doc/library/types.rst:28 +#: library/types.rst:28 msgid "" "Starting in Python 2.2, built-in factory functions such as :func:`int` and :" "func:`str` are also names for the corresponding types. This is now the " @@ -114431,63 +117247,63 @@ msgid "" "Accordingly, the example above should be written as follows::" msgstr "" -#: ../src/Doc/library/types.rst:39 +#: library/types.rst:39 msgid "The module defines the following names:" msgstr "" # a7bc2d1075e94565a4250bf01e183ee9 -#: ../src/Doc/library/types.rst:44 +#: library/types.rst:44 msgid "The type of ``None``." msgstr "" # 94c2dc24f2c34d25a86c2e6bcf8a2778 -#: ../src/Doc/library/types.rst:51 +#: library/types.rst:51 msgid "" "The type of type objects (such as returned by :func:`type`); alias of the " "built-in :class:`type`." msgstr "" # 01a3dcb0d45b4694a8903c98962be971 -#: ../src/Doc/library/types.rst:57 +#: library/types.rst:57 msgid "" "The type of the :class:`bool` values ``True`` and ``False``; alias of the " "built-in :class:`bool`." msgstr "" # e0e7557f3d164adc95fc623efb371713 -#: ../src/Doc/library/types.rst:65 +#: library/types.rst:65 msgid "The type of integers (e.g. ``1``); alias of the built-in :class:`int`." msgstr "" # fc0138299b39429da0efac02c96af81b -#: ../src/Doc/library/types.rst:70 +#: library/types.rst:70 msgid "" "The type of long integers (e.g. ``1L``); alias of the built-in :class:`long`." msgstr "" # 44bd0b7e114c4e50af11fd6203ed0e7b -#: ../src/Doc/library/types.rst:75 +#: library/types.rst:75 msgid "" "The type of floating point numbers (e.g. ``1.0``); alias of the built-in :" "class:`float`." msgstr "" # 91b815a07750446597f19021346b2576 -#: ../src/Doc/library/types.rst:81 +#: library/types.rst:81 msgid "" "The type of complex numbers (e.g. ``1.0j``). This is not defined if Python " "was built without complex number support." msgstr "" # f52f3fd43dc84e4789c0d02858a7e95b -#: ../src/Doc/library/types.rst:87 +#: library/types.rst:87 msgid "" "The type of character strings (e.g. ``'Spam'``); alias of the built-in :" "class:`str`." msgstr "" # 73c0dcdca2884d489c361e0781b4448a -#: ../src/Doc/library/types.rst:93 +#: library/types.rst:93 msgid "" "The type of Unicode character strings (e.g. ``u'Spam'``). This is not " "defined if Python was built without Unicode support. It's an alias of the " @@ -114495,130 +117311,130 @@ msgid "" msgstr "" # 22264b2e16014c8f81f9eb3034db7e34 -#: ../src/Doc/library/types.rst:100 +#: library/types.rst:100 msgid "" "The type of tuples (e.g. ``(1, 2, 3, 'Spam')``); alias of the built-in :" "class:`tuple`." msgstr "" # db27bb2dc0694e95ac87e0d56caa59ec -#: ../src/Doc/library/types.rst:106 +#: library/types.rst:106 msgid "" "The type of lists (e.g. ``[0, 1, 2, 3]``); alias of the built-in :class:" "`list`." msgstr "" # 7b10db5e19c44934828722a3be073eef -#: ../src/Doc/library/types.rst:112 +#: library/types.rst:112 msgid "" "The type of dictionaries (e.g. ``{'Bacon': 1, 'Ham': 0}``); alias of the " "built-in :class:`dict`." msgstr "" # ac8fbd8a6711443898094bae47456d7e -#: ../src/Doc/library/types.rst:118 +#: library/types.rst:118 msgid "An alternate name for ``DictType``." msgstr "" -#: ../src/Doc/library/types.rst:124 +#: library/types.rst:124 msgid "" "The type of user-defined functions and functions created by :keyword:" "`lambda` expressions." msgstr "" -#: ../src/Doc/library/types.rst:130 +#: library/types.rst:130 msgid "" "The type of :term:`generator`-iterator objects, produced by calling a " "generator function." msgstr "" -#: ../src/Doc/library/types.rst:140 +#: library/types.rst:140 msgid "The type for code objects such as returned by :func:`compile`." msgstr "" # 4146a33f81044d04b73b30c73c34570b -#: ../src/Doc/library/types.rst:145 +#: library/types.rst:145 msgid "The type of user-defined old-style classes." msgstr "" # 3b5ab25169a547398657285d6991e0a5 -#: ../src/Doc/library/types.rst:150 +#: library/types.rst:150 msgid "The type of instances of user-defined classes." msgstr "" -#: ../src/Doc/library/types.rst:155 +#: library/types.rst:155 msgid "The type of methods of user-defined class instances." msgstr "" # fac35b19a1d345018cad3429f9591080 -#: ../src/Doc/library/types.rst:160 +#: library/types.rst:160 msgid "An alternate name for ``MethodType``." msgstr "" -#: ../src/Doc/library/types.rst:166 +#: library/types.rst:166 msgid "" "The type of built-in functions like :func:`len` or :func:`sys.exit`, and " "methods of built-in classes. (Here, the term \"built-in\" means \"written " "in C\".)" msgstr "" -#: ../src/Doc/library/types.rst:173 +#: library/types.rst:173 msgid "The type of modules." msgstr "" # c22979f4ed07441280985038044316ea -#: ../src/Doc/library/types.rst:178 +#: library/types.rst:178 msgid "" "The type of open file objects such as ``sys.stdout``; alias of the built-in :" "class:`file`." msgstr "" # 8f7299a3edbd4ad4adce7dd7dfbbde39 -#: ../src/Doc/library/types.rst:186 +#: library/types.rst:186 msgid "" "The type of range objects returned by :func:`xrange`; alias of the built-in :" "class:`xrange`." msgstr "" # 79fd83b1ded344c4aa110aeb0d07f992 -#: ../src/Doc/library/types.rst:194 +#: library/types.rst:194 msgid "" "The type of objects returned by :func:`slice`; alias of the built-in :class:" "`slice`." msgstr "" # af566fb68ec44eca959a8044a1b9d12d -#: ../src/Doc/library/types.rst:200 +#: library/types.rst:200 msgid "The type of ``Ellipsis``." msgstr "" # 6cadf56bb93e479f93baab76bb776369 -#: ../src/Doc/library/types.rst:205 +#: library/types.rst:205 msgid "The type of traceback objects such as found in ``sys.exc_traceback``." msgstr "" -#: ../src/Doc/library/types.rst:210 +#: library/types.rst:210 msgid "" "The type of frame objects such as found in ``tb.tb_frame`` if ``tb`` is a " "traceback object." msgstr "" # 7a400a273f98479aaefa7b0eb69ba380 -#: ../src/Doc/library/types.rst:218 +#: library/types.rst:218 msgid "The type of buffer objects created by the :func:`buffer` function." msgstr "" # 58f49d15efb841a984db2ffeb0e3010d -#: ../src/Doc/library/types.rst:223 +#: library/types.rst:223 msgid "The type of dict proxies, such as ``TypeType.__dict__``." msgstr "" # f05153bcda3e43e096eb2f98acd16a8f -#: ../src/Doc/library/types.rst:228 +#: library/types.rst:228 msgid "The type of ``NotImplemented``" msgstr "" -#: ../src/Doc/library/types.rst:233 +#: library/types.rst:233 msgid "" "The type of objects defined in extension modules with ``PyGetSetDef``, such " "as ``FrameType.f_locals`` or ``array.array.typecode``. This type is used as " @@ -114626,7 +117442,7 @@ msgid "" "`property` type, but for classes defined in extension modules." msgstr "" -#: ../src/Doc/library/types.rst:243 +#: library/types.rst:243 msgid "" "The type of objects defined in extension modules with ``PyMemberDef``, such " "as ``datetime.timedelta.days``. This type is used as descriptor for simple " @@ -114635,14 +117451,14 @@ msgid "" "modules." msgstr "" -#: ../src/Doc/library/types.rst:250 +#: library/types.rst:250 msgid "" "In other implementations of Python, this type may be identical to " "``GetSetDescriptorType``." msgstr "" # 28bda4690f6e4d0990cd9e2959bf3440 -#: ../src/Doc/library/types.rst:258 +#: library/types.rst:258 msgid "" "A sequence containing ``StringType`` and ``UnicodeType`` used to facilitate " "easier checking for any string object. Using this is more portable than " @@ -114651,18 +117467,18 @@ msgid "" "Python. For example: ``isinstance(s, types.StringTypes)``." msgstr "" -#: ../src/Doc/library/undoc.rst:6 +#: library/undoc.rst:6 msgid "Undocumented Modules" msgstr "" -#: ../src/Doc/library/undoc.rst:8 +#: library/undoc.rst:8 msgid "" "Here's a quick listing of modules that are currently undocumented, but that " "should be documented. Feel free to contribute documentation for them! " "(Send via email to docs@python.org.)" msgstr "" -#: ../src/Doc/library/undoc.rst:12 +#: library/undoc.rst:12 msgid "" "The idea and original contents for this chapter were taken from a posting by " "Fredrik Lundh; the specific contents of this chapter have been substantially " @@ -114670,64 +117486,60 @@ msgid "" msgstr "" # 96524030dc6542f9a53955be552c4597 -#: ../src/Doc/library/undoc.rst:18 +#: library/undoc.rst:18 msgid "Miscellaneous useful utilities" msgstr "" # 8b0707507cc349cc88b8c9de1a4ffb02 -#: ../src/Doc/library/undoc.rst:20 +#: library/undoc.rst:20 msgid "Some of these are very old and/or not very robust; marked with \"hmm.\"" msgstr "" -# 2f92242759f848e3a78e6c7a42c467ab -#: ../src/Doc/library/undoc.rst:24 -msgid ":mod:`ihooks`" +#: library/undoc.rst:25 +msgid "ihooks" msgstr "" # 19108c074bfb46e9be5007f318c5b09e -#: ../src/Doc/library/undoc.rst:23 +#: library/undoc.rst:23 msgid "" "--- Import hook support (for :mod:`rexec`; may become obsolete). Removed in " "Python 3.x." msgstr "" -#: ../src/Doc/library/undoc.rst:28 +#: library/undoc.rst:28 msgid "Platform specific modules" msgstr "" -#: ../src/Doc/library/undoc.rst:30 +#: library/undoc.rst:30 msgid "" "These modules are used to implement the :mod:`os.path` module, and are not " "documented beyond this mention. There's little need to document these." msgstr "" -# 61b59c623d854fb3bd5280669a3de183 -#: ../src/Doc/library/undoc.rst:33 -msgid ":mod:`ntpath`" +#: library/undoc.rst:34 +msgid "ntpath" msgstr "" -#: ../src/Doc/library/undoc.rst:34 +#: library/undoc.rst:34 msgid "" "--- Implementation of :mod:`os.path` on Win32, Win64, WinCE, and OS/2 " "platforms." msgstr "" -# 0bbcb2974fa24c408cc7503b04008c8e -#: ../src/Doc/library/undoc.rst:36 -msgid ":mod:`posixpath`" +#: library/undoc.rst:37 +msgid "posixpath" msgstr "" -#: ../src/Doc/library/undoc.rst:37 +#: library/undoc.rst:37 msgid "--- Implementation of :mod:`os.path` on POSIX." msgstr "" -# 040b3e760be24c6ca2f6cd028a4eb47e -#: ../src/Doc/library/undoc.rst:42 -msgid ":mod:`bsddb185`" +#: library/undoc.rst:43 +msgid "bsddb185" msgstr "" # 53261f892aa84c0c980337806ce0ac3e -#: ../src/Doc/library/undoc.rst:40 +#: library/undoc.rst:40 msgid "" "--- Backwards compatibility module for systems which still use the Berkeley " "DB 1.85 module. It is normally only available on certain BSD Unix-based " @@ -114735,52 +117547,48 @@ msgid "" msgstr "" # 882e32729541460db54c05e0919c44c0 -#: ../src/Doc/library/undoc.rst:46 +#: library/undoc.rst:46 msgid "Multimedia" msgstr "" -# d5c1b8d9e20847babfee306367453eec -#: ../src/Doc/library/undoc.rst:48 -msgid ":mod:`audiodev`" +#: library/undoc.rst:49 +msgid "audiodev" msgstr "" # 270a5b3863df4bd1a1e992620b345ded -#: ../src/Doc/library/undoc.rst:49 +#: library/undoc.rst:49 msgid "" "--- Platform-independent API for playing audio data. Removed in Python 3.x." msgstr "" -# 9b74b0eba164474e8b5464734678e888 -#: ../src/Doc/library/undoc.rst:52 -msgid ":mod:`linuxaudiodev`" +#: library/undoc.rst:53 +msgid "linuxaudiodev" msgstr "" # 646d1f2fde914907a739db404120018c -#: ../src/Doc/library/undoc.rst:52 +#: library/undoc.rst:52 msgid "" "--- Play audio data on the Linux audio device. Replaced in Python 2.3 by " "the :mod:`ossaudiodev` module. Removed in Python 3.x." msgstr "" -# 5e937e37b4d048a497de4c9f5e9b0530 -#: ../src/Doc/library/undoc.rst:56 -msgid ":mod:`sunaudio`" +#: library/undoc.rst:57 +msgid "sunaudio" msgstr "" # 95ff12df21454a6bad9b2412b4f255b9 -#: ../src/Doc/library/undoc.rst:56 +#: library/undoc.rst:56 msgid "" "--- Interpret Sun audio headers (may become obsolete or a tool/demo). " "Removed in Python 3.x." msgstr "" -# 6543ebf7355e4f6e93ef93dd3bd28862 -#: ../src/Doc/library/undoc.rst:61 -msgid ":mod:`toaiff`" +#: library/undoc.rst:62 +msgid "toaiff" msgstr "" # 52510bf1e4d142cca5c1d2ea1e733c4d -#: ../src/Doc/library/undoc.rst:60 +#: library/undoc.rst:60 msgid "" "--- Convert \"arbitrary\" sound files to AIFF files; should probably become " "a tool or demo. Requires the external program :program:`sox`. Removed in " @@ -114788,27 +117596,27 @@ msgid "" msgstr "" # 1c0b87421be84894a2488ee0f4930dea -#: ../src/Doc/library/undoc.rst:67 +#: library/undoc.rst:67 msgid "Undocumented Mac OS modules" msgstr "" # 441266108510444e9578ef272618fca7 -#: ../src/Doc/library/undoc.rst:71 +#: library/undoc.rst:71 msgid ":mod:`applesingle` --- AppleSingle decoder" msgstr "" # 231a58dfdf59489da424b7032b03c187 -#: ../src/Doc/library/undoc.rst:82 +#: library/undoc.rst:82 msgid ":mod:`buildtools` --- Helper module for BuildApplet and Friends" msgstr "" # a93ed4b36a3b46f0b9ac2f605fa06611 -#: ../src/Doc/library/undoc.rst:93 +#: library/undoc.rst:93 msgid ":mod:`cfmfile` --- Code Fragment Resource module" msgstr "" # 76da6163977444e7b26903817d6650b4 -#: ../src/Doc/library/undoc.rst:101 +#: library/undoc.rst:101 msgid "" ":mod:`cfmfile` is a module that understands Code Fragments and the " "accompanying \"cfrg\" resources. It can parse them and merge them, and is " @@ -114817,35 +117625,35 @@ msgid "" msgstr "" # 7053cb2310f54e88adfc2d1dbd194b49 -#: ../src/Doc/library/undoc.rst:108 +#: library/undoc.rst:108 msgid ":mod:`icopen` --- Internet Config replacement for :meth:`open`" msgstr "" # d78cd1d5f004470083d5ad9b7e517745 -#: ../src/Doc/library/undoc.rst:116 +#: library/undoc.rst:116 msgid "" "Importing :mod:`icopen` will replace the built-in :meth:`open` with a " "version that uses Internet Config to set file type and creator for new files." msgstr "" # c1d0c0a03ada4e35a093d1445aac5845 -#: ../src/Doc/library/undoc.rst:123 +#: library/undoc.rst:123 msgid ":mod:`macerrors` --- Mac OS Errors" msgstr "" # 6619448ac0604a19a5c40f79d0dfb2c1 -#: ../src/Doc/library/undoc.rst:131 +#: library/undoc.rst:131 msgid "" ":mod:`macerrors` contains constant definitions for many Mac OS error codes." msgstr "" # ef0899fa8b5545c88a78e62541c09839 -#: ../src/Doc/library/undoc.rst:137 +#: library/undoc.rst:137 msgid ":mod:`macresource` --- Locate script resources" msgstr "" # 320486e0e820462c90d06a11fd9d5be6 -#: ../src/Doc/library/undoc.rst:145 +#: library/undoc.rst:145 msgid "" ":mod:`macresource` helps scripts finding their resources, such as dialogs " "and menus, without requiring special case code for when the script is run " @@ -114853,22 +117661,22 @@ msgid "" msgstr "" # b566f39b2482404f884c87844f928280 -#: ../src/Doc/library/undoc.rst:153 +#: library/undoc.rst:153 msgid ":mod:`Nav` --- NavServices calls" msgstr "" # 33e9ec75b20e4fefb49e2cfaf94e4812 -#: ../src/Doc/library/undoc.rst:161 +#: library/undoc.rst:161 msgid "A low-level interface to Navigation Services." msgstr "" # 128166fd1dae4fcdbc2034f7867fee6c -#: ../src/Doc/library/undoc.rst:167 +#: library/undoc.rst:167 msgid ":mod:`PixMapWrapper` --- Wrapper for PixMap objects" msgstr "" # 2cfcaf5d64e646bd85d099ab5318bb23 -#: ../src/Doc/library/undoc.rst:175 +#: library/undoc.rst:175 msgid "" ":mod:`PixMapWrapper` wraps a PixMap object with a Python object that allows " "access to the fields by name. It also has methods to convert to and from :" @@ -114876,41 +117684,41 @@ msgid "" msgstr "" # 439f3b9fbfa14f1d8af40810c06b91ea -#: ../src/Doc/library/undoc.rst:183 +#: library/undoc.rst:183 msgid ":mod:`videoreader` --- Read QuickTime movies" msgstr "" # 2ce4773a94fc4561a8b52d8c7bbd87e0 -#: ../src/Doc/library/undoc.rst:191 +#: library/undoc.rst:191 msgid "" ":mod:`videoreader` reads and decodes QuickTime movies and passes a stream of " "images to your program. It also provides some support for audio tracks." msgstr "" # ee5eec70013f46fe94bedc2ea50cf611 -#: ../src/Doc/library/undoc.rst:198 +#: library/undoc.rst:198 msgid ":mod:`W` --- Widgets built on :mod:`FrameWork`" msgstr "" # 009473b0cf4c4aff83cb6c62d4d075e3 -#: ../src/Doc/library/undoc.rst:206 +#: library/undoc.rst:206 msgid "The :mod:`W` widgets are used extensively in the :program:`IDE`." msgstr "" # 11765093ce2a4a859e42c28c7847ecc7 -#: ../src/Doc/library/undoc.rst:214 +#: library/undoc.rst:214 msgid "Obsolete" msgstr "" # b3f7bae383344bfd8702a5cc7413391c -#: ../src/Doc/library/undoc.rst:216 +#: library/undoc.rst:216 msgid "" "These modules are not normally available for import; additional work must be " "done to make them available." msgstr "" # 23cd3ac08a4b4e629cb57dc5d530779e -#: ../src/Doc/library/undoc.rst:219 +#: library/undoc.rst:219 msgid "" "These extension modules written in C are not built by default. Under Unix, " "these must be enabled by uncommenting the appropriate lines in :file:" @@ -114919,57 +117727,54 @@ msgid "" "if using dynamically-loaded extensions." msgstr "" -# e504bad3b8e7416b9ae129cf4d36b2ae -#: ../src/Doc/library/undoc.rst:234 -msgid ":mod:`timing`" +#: library/undoc.rst:235 +msgid "timing" msgstr "" # 0999de498bea42bb982ff36b6336fad1 -#: ../src/Doc/library/undoc.rst:233 +#: library/undoc.rst:233 msgid "" "--- Measure time intervals to high resolution (use :func:`time.clock` " "instead). Removed in Python 3.x." msgstr "" # befd054937264ed38fadaab1b4ca2b56 -#: ../src/Doc/library/undoc.rst:238 +#: library/undoc.rst:238 msgid "SGI-specific Extension modules" msgstr "" # 3bade5ba00a24cd6b742a6aba5785065 -#: ../src/Doc/library/undoc.rst:240 +#: library/undoc.rst:240 msgid "" "The following are SGI specific, and may be out of touch with the current " "version of reality." msgstr "" -# f55d95eeffcb40c5ae37a0d1340f215c -#: ../src/Doc/library/undoc.rst:243 -msgid ":mod:`cl`" +#: library/undoc.rst:244 +msgid "cl" msgstr "" # 4a90ac2f660742a39465cafa6895d62b -#: ../src/Doc/library/undoc.rst:244 +#: library/undoc.rst:244 msgid "--- Interface to the SGI compression library." msgstr "" -# db4d9510134a421ba6e4b12f1615ae5e -#: ../src/Doc/library/undoc.rst:246 -msgid ":mod:`sv`" +#: library/undoc.rst:247 +msgid "sv" msgstr "" # 5f5e7e6041e94f629cb98e9f28b93801 -#: ../src/Doc/library/undoc.rst:247 +#: library/undoc.rst:247 msgid "" "--- Interface to the \"simple video\" board on SGI Indigo (obsolete " "hardware). Removed in Python 3.x." msgstr "" -#: ../src/Doc/library/unicodedata.rst:3 +#: library/unicodedata.rst:3 msgid ":mod:`unicodedata` --- Unicode Database" msgstr "" -#: ../src/Doc/library/unicodedata.rst:17 +#: library/unicodedata.rst:17 msgid "" "This module provides access to the Unicode Character Database which defines " "character properties for all Unicode characters. The data in this database " @@ -114977,7 +117782,7 @@ msgid "" "available from ftp://ftp.unicode.org/." msgstr "" -#: ../src/Doc/library/unicodedata.rst:22 +#: library/unicodedata.rst:22 msgid "" "The module uses the same names and symbols as defined by the UnicodeData " "File Format 5.2.0 (see http://www.unicode.org/reports/tr44/tr44-4.html). It " @@ -114985,7 +117790,7 @@ msgid "" msgstr "" # 0dbc321b5fd94e53bc90028ca5b84ef7 -#: ../src/Doc/library/unicodedata.rst:29 +#: library/unicodedata.rst:29 msgid "" "Look up character by name. If a character with the given name is found, " "return the corresponding Unicode character. If not found, :exc:`KeyError` " @@ -114993,7 +117798,7 @@ msgid "" msgstr "" # f482b653180a413fb3dd7163dcbcf0f1 -#: ../src/Doc/library/unicodedata.rst:35 +#: library/unicodedata.rst:35 msgid "" "Returns the name assigned to the Unicode character *unichr* as a string. If " "no name is defined, *default* is returned, or, if not given, :exc:" @@ -115001,7 +117806,7 @@ msgid "" msgstr "" # e07b7d72ab23456aa975e0aa04c05834 -#: ../src/Doc/library/unicodedata.rst:42 +#: library/unicodedata.rst:42 msgid "" "Returns the decimal value assigned to the Unicode character *unichr* as " "integer. If no such value is defined, *default* is returned, or, if not " @@ -115009,7 +117814,7 @@ msgid "" msgstr "" # e77aaf6f6176441e9b2f8d681bbcb2f5 -#: ../src/Doc/library/unicodedata.rst:49 +#: library/unicodedata.rst:49 msgid "" "Returns the digit value assigned to the Unicode character *unichr* as " "integer. If no such value is defined, *default* is returned, or, if not " @@ -115017,7 +117822,7 @@ msgid "" msgstr "" # 7148509cd6414cc89ec47713ed5892e3 -#: ../src/Doc/library/unicodedata.rst:56 +#: library/unicodedata.rst:56 msgid "" "Returns the numeric value assigned to the Unicode character *unichr* as " "float. If no such value is defined, *default* is returned, or, if not " @@ -115025,35 +117830,35 @@ msgid "" msgstr "" # 2fd730aaefeb4c1496efe15ad9215af2 -#: ../src/Doc/library/unicodedata.rst:63 +#: library/unicodedata.rst:63 msgid "" "Returns the general category assigned to the Unicode character *unichr* as " "string." msgstr "" # fcd4f8c117c644cb83f8a46cb8878664 -#: ../src/Doc/library/unicodedata.rst:69 +#: library/unicodedata.rst:69 msgid "" "Returns the bidirectional class assigned to the Unicode character *unichr* " "as string. If no such value is defined, an empty string is returned." msgstr "" # 8849b15e206d410db15ab6d91deaadcb -#: ../src/Doc/library/unicodedata.rst:75 +#: library/unicodedata.rst:75 msgid "" "Returns the canonical combining class assigned to the Unicode character " "*unichr* as integer. Returns ``0`` if no combining class is defined." msgstr "" # 2a62081cbbe9400887a61376ca1c477a -#: ../src/Doc/library/unicodedata.rst:81 +#: library/unicodedata.rst:81 msgid "" "Returns the east asian width assigned to the Unicode character *unichr* as " "string." msgstr "" # f16ff70aaf0449bd95fde9c2cefffb7e -#: ../src/Doc/library/unicodedata.rst:89 +#: library/unicodedata.rst:89 msgid "" "Returns the mirrored property assigned to the Unicode character *unichr* as " "integer. Returns ``1`` if the character has been identified as a \"mirrored" @@ -115061,21 +117866,21 @@ msgid "" msgstr "" # fc1a6eccad3844c2aa8dffa3901c21ca -#: ../src/Doc/library/unicodedata.rst:96 +#: library/unicodedata.rst:96 msgid "" "Returns the character decomposition mapping assigned to the Unicode " "character *unichr* as string. An empty string is returned in case no such " "mapping is defined." msgstr "" -#: ../src/Doc/library/unicodedata.rst:103 +#: library/unicodedata.rst:103 msgid "" "Return the normal form *form* for the Unicode string *unistr*. Valid values " "for *form* are 'NFC', 'NFKC', 'NFD', and 'NFKD'." msgstr "" # 3475011e130442ec865b3ed2b1db672a -#: ../src/Doc/library/unicodedata.rst:106 +#: library/unicodedata.rst:106 msgid "" "The Unicode standard defines various normalization forms of a Unicode " "string, based on the definition of canonical equivalence and compatibility " @@ -115085,7 +117890,7 @@ msgid "" "(COMBINING CEDILLA)." msgstr "" -#: ../src/Doc/library/unicodedata.rst:112 +#: library/unicodedata.rst:112 msgid "" "For each character, there are two normal forms: normal form C and normal " "form D. Normal form D (NFD) is also known as canonical decomposition, and " @@ -115094,7 +117899,7 @@ msgid "" "characters again." msgstr "" -#: ../src/Doc/library/unicodedata.rst:117 +#: library/unicodedata.rst:117 msgid "" "In addition to these two forms, there are two additional normal forms based " "on compatibility equivalence. In Unicode, certain characters are supported " @@ -115104,7 +117909,7 @@ msgid "" "character sets (e.g. gb2312)." msgstr "" -#: ../src/Doc/library/unicodedata.rst:124 +#: library/unicodedata.rst:124 msgid "" "The normal form KD (NFKD) will apply the compatibility decomposition, i.e. " "replace all compatibility characters with their equivalents. The normal form " @@ -115112,45 +117917,45 @@ msgid "" "canonical composition." msgstr "" -#: ../src/Doc/library/unicodedata.rst:129 +#: library/unicodedata.rst:129 msgid "" "Even if two unicode strings are normalized and look the same to a human " "reader, if one has combining characters and the other doesn't, they may not " "compare equal." msgstr "" -#: ../src/Doc/library/unicodedata.rst:135 +#: library/unicodedata.rst:135 msgid "In addition, the module exposes the following constant:" msgstr "" -#: ../src/Doc/library/unicodedata.rst:140 +#: library/unicodedata.rst:140 msgid "The version of the Unicode database used in this module." msgstr "" -#: ../src/Doc/library/unicodedata.rst:147 +#: library/unicodedata.rst:147 msgid "" "This is an object that has the same methods as the entire module, but uses " "the Unicode database version 3.2 instead, for applications that require this " "specific version of the Unicode database (such as IDNA)." msgstr "" -#: ../src/Doc/library/unicodedata.rst:153 +#: library/unicodedata.rst:153 #, fuzzy msgid "Examples:" msgstr "Exemples ::" -#: ../src/Doc/library/unittest.rst:2 +#: library/unittest.rst:2 msgid ":mod:`unittest` --- Unit testing framework" msgstr "" # b6c20aabcd72449c86dc6f65fb9d0e0d -#: ../src/Doc/library/unittest.rst:13 +#: library/unittest.rst:13 msgid "" "(If you are already familiar with the basic concepts of testing, you might " "want to skip to :ref:`the list of assert methods <assert-methods>`.)" msgstr "" -#: ../src/Doc/library/unittest.rst:16 +#: library/unittest.rst:16 msgid "" "The Python unit testing framework, sometimes referred to as \"PyUnit,\" is a " "Python language version of JUnit, by Kent Beck and Erich Gamma. JUnit is, in " @@ -115158,7 +117963,7 @@ msgid "" "facto standard unit testing framework for its respective language." msgstr "" -#: ../src/Doc/library/unittest.rst:21 +#: library/unittest.rst:21 msgid "" ":mod:`unittest` supports test automation, sharing of setup and shutdown code " "for tests, aggregation of tests into collections, and independence of the " @@ -115166,16 +117971,16 @@ msgid "" "classes that make it easy to support these qualities for a set of tests." msgstr "" -#: ../src/Doc/library/unittest.rst:26 +#: library/unittest.rst:26 msgid "To achieve this, :mod:`unittest` supports some important concepts:" msgstr "" # 0d19178b1cf848079cfcb7f3bafc3526 -#: ../src/Doc/library/unittest.rst:31 +#: library/unittest.rst:32 msgid "test fixture" msgstr "" -#: ../src/Doc/library/unittest.rst:29 +#: library/unittest.rst:29 msgid "" "A :dfn:`test fixture` represents the preparation needed to perform one or " "more tests, and any associate cleanup actions. This may involve, for " @@ -115184,11 +117989,11 @@ msgid "" msgstr "" # 621c644ab7a04022b5bb791c911b197d -#: ../src/Doc/library/unittest.rst:36 +#: library/unittest.rst:37 msgid "test case" msgstr "" -#: ../src/Doc/library/unittest.rst:35 +#: library/unittest.rst:35 msgid "" "A :dfn:`test case` is the smallest unit of testing. It checks for a " "specific response to a particular set of inputs. :mod:`unittest` provides a " @@ -115196,22 +118001,22 @@ msgid "" msgstr "" # e2a0b6183a79471c87b30820fdb91375 -#: ../src/Doc/library/unittest.rst:40 +#: library/unittest.rst:41 msgid "test suite" msgstr "" -#: ../src/Doc/library/unittest.rst:40 +#: library/unittest.rst:40 msgid "" "A :dfn:`test suite` is a collection of test cases, test suites, or both. It " "is used to aggregate tests that should be executed together." msgstr "" # feec29375bdb47369011097efdcf21fa -#: ../src/Doc/library/unittest.rst:46 +#: library/unittest.rst:47 msgid "test runner" msgstr "" -#: ../src/Doc/library/unittest.rst:44 +#: library/unittest.rst:44 msgid "" "A :dfn:`test runner` is a component which orchestrates the execution of " "tests and provides the outcome to the user. The runner may use a graphical " @@ -115219,7 +118024,7 @@ msgid "" "results of executing the tests." msgstr "" -#: ../src/Doc/library/unittest.rst:49 +#: library/unittest.rst:49 msgid "" "The test case and test fixture concepts are supported through the :class:" "`TestCase` and :class:`FunctionTestCase` classes; the former should be used " @@ -115235,7 +118040,7 @@ msgid "" "single test method, so a new fixture is created for each test." msgstr "" -#: ../src/Doc/library/unittest.rst:62 +#: library/unittest.rst:62 msgid "" "Test suites are implemented by the :class:`TestSuite` class. This class " "allows individual tests and test suites to be aggregated; when the suite is " @@ -115243,7 +118048,7 @@ msgid "" "are run." msgstr "" -#: ../src/Doc/library/unittest.rst:66 +#: library/unittest.rst:66 msgid "" "A test runner is an object that provides a single method, :meth:`~TestRunner." "run`, which accepts a :class:`TestCase` or :class:`TestSuite` object as a " @@ -115255,94 +118060,77 @@ msgid "" "derive from a specific class." msgstr "" -#: ../src/Doc/library/unittest.rst:79 +#: library/unittest.rst:79 msgid "Another test-support module with a very different flavor." msgstr "" -# 0f012e3678b14436a24bdf403e7e7f30 -#: ../src/Doc/library/unittest.rst:83 -msgid "" -"`unittest2: A backport of new unittest features for Python 2.4-2.6 <https://" -"pypi.python.org/pypi/unittest2>`_" +#: library/unittest.rst:84 +msgid "unittest2: A backport of new unittest features for Python 2.4-2.6" msgstr "" -#: ../src/Doc/library/unittest.rst:82 +#: library/unittest.rst:82 msgid "" "Many new features were added to unittest in Python 2.7, including test " "discovery. unittest2 allows you to use these features with earlier versions " "of Python." msgstr "" -# c311b71ce9e94b339b61438e0811b07b -#: ../src/Doc/library/unittest.rst:87 -msgid "" -"`Simple Smalltalk Testing: With Patterns <http://www.XProgramming.com/" -"testfram.htm>`_" +#: library/unittest.rst:88 +msgid "Simple Smalltalk Testing: With Patterns" msgstr "" -#: ../src/Doc/library/unittest.rst:87 +#: library/unittest.rst:87 msgid "" "Kent Beck's original paper on testing frameworks using the pattern shared " "by :mod:`unittest`." msgstr "" -# f79d254c1dd74535add2c56463d5c39c -#: ../src/Doc/library/unittest.rst:91 -msgid "" -"`Nose <http://code.google.com/p/python-nose/>`_ and `py.test <http://pytest." -"org>`_" +#: library/unittest.rst:92 +msgid "Nose and py.test" msgstr "" -#: ../src/Doc/library/unittest.rst:91 +#: library/unittest.rst:91 msgid "" "Third-party unittest frameworks with a lighter-weight syntax for writing " "tests. For example, ``assert func(10) == 42``." msgstr "" -# 833741324bf04d8ea48c7e12ab55f0bb -#: ../src/Doc/library/unittest.rst:95 -msgid "" -"`The Python Testing Tools Taxonomy <https://wiki.python.org/moin/" -"PythonTestingToolsTaxonomy>`_" +#: library/unittest.rst:96 +msgid "The Python Testing Tools Taxonomy" msgstr "" -#: ../src/Doc/library/unittest.rst:95 +#: library/unittest.rst:95 msgid "" "An extensive list of Python testing tools including functional testing " "frameworks and mock object libraries." msgstr "" -# 3aaaacdca1cc456abf0e18e6322a2490 -#: ../src/Doc/library/unittest.rst:98 -msgid "" -"`Testing in Python Mailing List <http://lists.idyll.org/listinfo/testing-in-" -"python>`_" +#: library/unittest.rst:99 +msgid "Testing in Python Mailing List" msgstr "" -#: ../src/Doc/library/unittest.rst:99 +#: library/unittest.rst:99 msgid "" "A special-interest-group for discussion of testing, and testing tools, in " "Python." msgstr "" -#: ../src/Doc/library/unittest.rst:106 +#: library/unittest.rst:106 msgid "Basic example" msgstr "" -#: ../src/Doc/library/unittest.rst:108 +#: library/unittest.rst:108 msgid "" "The :mod:`unittest` module provides a rich set of tools for constructing and " "running tests. This section demonstrates that a small subset of the tools " "suffice to meet the needs of most users." msgstr "" -#: ../src/Doc/library/unittest.rst:112 -msgid "" -"Here is a short script to test three functions from the :mod:`random` " -"module::" +#: library/unittest.rst:112 +msgid "Here is a short script to test three string methods::" msgstr "" -#: ../src/Doc/library/unittest.rst:144 +#: library/unittest.rst:136 msgid "" "A testcase is created by subclassing :class:`unittest.TestCase`. The three " "individual tests are defined with methods whose names start with the letters " @@ -115350,33 +118138,33 @@ msgid "" "methods represent tests." msgstr "" -#: ../src/Doc/library/unittest.rst:149 +#: library/unittest.rst:141 msgid "" "The crux of each test is a call to :meth:`~TestCase.assertEqual` to check " -"for an expected result; :meth:`~TestCase.assertTrue` to verify a condition; " -"or :meth:`~TestCase.assertRaises` to verify that an expected exception gets " -"raised. These methods are used instead of the :keyword:`assert` statement so " -"the test runner can accumulate all test results and produce a report." +"for an expected result; :meth:`~TestCase.assertTrue` or :meth:`~TestCase." +"assertFalse` to verify a condition; or :meth:`~TestCase.assertRaises` to " +"verify that a specific exception gets raised. These methods are used " +"instead of the :keyword:`assert` statement so the test runner can accumulate " +"all test results and produce a report." msgstr "" -#: ../src/Doc/library/unittest.rst:155 +#: library/unittest.rst:148 msgid "" -"When a :meth:`~TestCase.setUp` method is defined, the test runner will run " -"that method prior to each test. Likewise, if a :meth:`~TestCase.tearDown` " -"method is defined, the test runner will invoke that method after each test. " -"In the example, :meth:`~TestCase.setUp` was used to create a fresh sequence " -"for each test." +"The :meth:`~TestCase.setUp` and :meth:`~TestCase.tearDown` methods allow you " +"to define instructions that will be executed before and after each test " +"method. They are covered in more details in the section :ref:`organizing-" +"tests`." msgstr "" # 32cda394a9004fe2a79a354fa88ccea4 -#: ../src/Doc/library/unittest.rst:161 +#: library/unittest.rst:152 msgid "" "The final block shows a simple way to run the tests. :func:`unittest.main` " "provides a command-line interface to the test script. When run from the " "command line, the above script produces an output that looks like this::" msgstr "" -#: ../src/Doc/library/unittest.rst:171 +#: library/unittest.rst:162 msgid "" "Instead of :func:`unittest.main`, there are other ways to run the tests with " "a finer level of control, less terse output, and no requirement to be run " @@ -115384,87 +118172,97 @@ msgid "" "with::" msgstr "" -#: ../src/Doc/library/unittest.rst:178 +#: library/unittest.rst:169 msgid "" "Running the revised script from the interpreter or another script produces " "the following output::" msgstr "" -#: ../src/Doc/library/unittest.rst:190 +#: library/unittest.rst:181 msgid "" "The above examples show the most commonly used :mod:`unittest` features " "which are sufficient to meet many everyday testing needs. The remainder of " "the documentation explores the full feature set from first principles." msgstr "" -#: ../src/Doc/library/unittest.rst:200 +#: library/unittest.rst:191 msgid "" "The unittest module can be used from the command line to run tests from " "modules, classes or even individual test methods::" msgstr "" -#: ../src/Doc/library/unittest.rst:207 +#: library/unittest.rst:198 msgid "" "You can pass in a list with any combination of module names, and fully " "qualified class or method names." msgstr "" -#: ../src/Doc/library/unittest.rst:210 +#: library/unittest.rst:201 msgid "" "You can run tests with more detail (higher verbosity) by passing in the -v " "flag::" msgstr "" # 53006ca360984160ba3223c96f3b127d -#: ../src/Doc/library/unittest.rst:214 +#: library/unittest.rst:205 msgid "For a list of all the command-line options::" msgstr "" +#: library/unittest.rst:209 +msgid "" +"In earlier versions it was only possible to run individual test methods and " +"not modules or classes." +msgstr "" + # 479b6d88c7d94c6e8e42c9cd1b2a0b2f -#: ../src/Doc/library/unittest.rst:224 +#: library/unittest.rst:215 msgid "Command-line options" msgstr "" # 36ea2f26870a4dd6abf12a05e3f774be -#: ../src/Doc/library/unittest.rst:226 +#: library/unittest.rst:217 msgid ":program:`unittest` supports these command-line options:" msgstr "" -#: ../src/Doc/library/unittest.rst:232 +#: library/unittest.rst:223 msgid "" "The standard output and standard error streams are buffered during the test " "run. Output during a passing test is discarded. Output is echoed normally on " "test fail or error and is added to the failure messages." msgstr "" -#: ../src/Doc/library/unittest.rst:238 +#: library/unittest.rst:229 msgid "" -"Control-C during the test run waits for the current test to end and then " -"reports all the results so far. A second control-C raises the normal :exc:" -"`KeyboardInterrupt` exception." +":kbd:`Control-C` during the test run waits for the current test to end and " +"then reports all the results so far. A second :kbd:`Control-C` raises the " +"normal :exc:`KeyboardInterrupt` exception." msgstr "" -#: ../src/Doc/library/unittest.rst:242 +#: library/unittest.rst:233 msgid "" "See `Signal Handling`_ for the functions that provide this functionality." msgstr "" -#: ../src/Doc/library/unittest.rst:246 +#: library/unittest.rst:237 msgid "Stop the test run on the first error or failure." msgstr "" -#: ../src/Doc/library/unittest.rst:251 +#: library/unittest.rst:239 +msgid "The command-line options ``-b``, ``-c`` and ``-f`` were added." +msgstr "" + +#: library/unittest.rst:242 msgid "" "The command line can also be used for test discovery, for running all of the " "tests in a project or just a subset." msgstr "" -#: ../src/Doc/library/unittest.rst:258 +#: library/unittest.rst:249 msgid "Test Discovery" msgstr "" # 851aa85690464cde847e605d4e938299 -#: ../src/Doc/library/unittest.rst:262 +#: library/unittest.rst:253 msgid "" "Unittest supports simple test discovery. In order to be compatible with test " "discovery, all of the test files must be :ref:`modules <tut-modules>` or :" @@ -115474,43 +118272,43 @@ msgid "" msgstr "" # 64d327d1137947a78de51535bb562555 -#: ../src/Doc/library/unittest.rst:268 +#: library/unittest.rst:259 msgid "" "Test discovery is implemented in :meth:`TestLoader.discover`, but can also " "be used from the command line. The basic command-line usage is::" msgstr "" -#: ../src/Doc/library/unittest.rst:274 +#: library/unittest.rst:265 msgid "The ``discover`` sub-command has the following options:" msgstr "" -#: ../src/Doc/library/unittest.rst:280 +#: library/unittest.rst:271 msgid "Verbose output" msgstr "" # 9a0c41ceb5a741d08e579fba0c541779 -#: ../src/Doc/library/unittest.rst:284 +#: library/unittest.rst:275 msgid "Directory to start discovery (``.`` default)" msgstr "" # 6d29c2185d054df1b552e71769adb0f2 -#: ../src/Doc/library/unittest.rst:288 +#: library/unittest.rst:279 msgid "Pattern to match test files (``test*.py`` default)" msgstr "" # 880e5d3570664c92b3f6d56f0d959574 -#: ../src/Doc/library/unittest.rst:292 +#: library/unittest.rst:283 msgid "Top level directory of project (defaults to start directory)" msgstr "" -#: ../src/Doc/library/unittest.rst:294 +#: library/unittest.rst:285 msgid "" "The :option:`-s`, :option:`-p`, and :option:`-t` options can be passed in as " "positional arguments in that order. The following two command lines are " "equivalent::" msgstr "" -#: ../src/Doc/library/unittest.rst:301 +#: library/unittest.rst:292 msgid "" "As well as being a path it is possible to pass a package name, for example " "``myproject.subpackage.test``, as the start directory. The package name you " @@ -115519,7 +118317,7 @@ msgid "" msgstr "" # 75b28bcc767a437a84a7b33761b8f763 -#: ../src/Doc/library/unittest.rst:308 +#: library/unittest.rst:299 msgid "" "Test discovery loads tests by importing them. Once test discovery has found " "all the test files from the start directory you specify it turns the paths " @@ -115527,31 +118325,31 @@ msgid "" "imported as ``foo.bar.baz``." msgstr "" -#: ../src/Doc/library/unittest.rst:313 +#: library/unittest.rst:304 msgid "" "If you have a package installed globally and attempt test discovery on a " "different copy of the package then the import *could* happen from the wrong " "place. If this happens test discovery will warn you and exit." msgstr "" -#: ../src/Doc/library/unittest.rst:317 +#: library/unittest.rst:308 msgid "" "If you supply the start directory as a package name rather than a path to a " "directory then discover assumes that whichever location it imports from is " "the location you intended, so you will not get the warning." msgstr "" -#: ../src/Doc/library/unittest.rst:322 +#: library/unittest.rst:313 msgid "" "Test modules and packages can customize test loading and discovery by " "through the `load_tests protocol`_." msgstr "" -#: ../src/Doc/library/unittest.rst:329 +#: library/unittest.rst:320 msgid "Organizing test code" msgstr "" -#: ../src/Doc/library/unittest.rst:331 +#: library/unittest.rst:322 msgid "" "The basic building blocks of unit testing are :dfn:`test cases` --- single " "scenarios that must be set up and checked for correctness. In :mod:" @@ -115560,28 +118358,28 @@ msgid "" "subclasses of :class:`TestCase`, or use :class:`FunctionTestCase`." msgstr "" -#: ../src/Doc/library/unittest.rst:337 +#: library/unittest.rst:328 msgid "" "An instance of a :class:`TestCase`\\ -derived class is an object that can " "completely run a single test method, together with optional set-up and tidy-" "up code." msgstr "" -#: ../src/Doc/library/unittest.rst:341 +#: library/unittest.rst:332 msgid "" "The testing code of a :class:`TestCase` instance should be entirely self " "contained, such that it can be run either in isolation or in arbitrary " "combination with any number of other test cases." msgstr "" -#: ../src/Doc/library/unittest.rst:345 +#: library/unittest.rst:336 msgid "" "The simplest :class:`TestCase` subclass will simply override the :meth:" "`~TestCase.runTest` method in order to perform specific testing code::" msgstr "" # f38cbcadd6d248c69c0f5c75a4e82128 -#: ../src/Doc/library/unittest.rst:355 +#: library/unittest.rst:346 msgid "" "Note that in order to test something, we use one of the :meth:`assert\\*` " "methods provided by the :class:`TestCase` base class. If the test fails, an " @@ -115593,52 +118391,52 @@ msgid "" "call." msgstr "" -#: ../src/Doc/library/unittest.rst:363 +#: library/unittest.rst:354 msgid "" "The way to run a test case will be described later. For now, note that to " "construct an instance of such a test case, we call its constructor without " "arguments::" msgstr "" -#: ../src/Doc/library/unittest.rst:369 +#: library/unittest.rst:360 msgid "" "Now, such test cases can be numerous, and their set-up can be repetitive. " "In the above case, constructing a :class:`Widget` in each of 100 Widget test " "case subclasses would mean unsightly duplication." msgstr "" -#: ../src/Doc/library/unittest.rst:373 +#: library/unittest.rst:364 msgid "" "Luckily, we can factor out such set-up code by implementing a method called :" "meth:`~TestCase.setUp`, which the testing framework will automatically call " "for us when we run the test::" msgstr "" -#: ../src/Doc/library/unittest.rst:394 +#: library/unittest.rst:385 msgid "" "If the :meth:`~TestCase.setUp` method raises an exception while the test is " "running, the framework will consider the test to have suffered an error, and " "the :meth:`~TestCase.runTest` method will not be executed." msgstr "" -#: ../src/Doc/library/unittest.rst:398 +#: library/unittest.rst:389 msgid "" "Similarly, we can provide a :meth:`~TestCase.tearDown` method that tidies up " "after the :meth:`~TestCase.runTest` method has been run::" msgstr "" -#: ../src/Doc/library/unittest.rst:411 +#: library/unittest.rst:402 msgid "" "If :meth:`~TestCase.setUp` succeeded, the :meth:`~TestCase.tearDown` method " "will be run whether :meth:`~TestCase.runTest` succeeded or not." msgstr "" -#: ../src/Doc/library/unittest.rst:414 +#: library/unittest.rst:405 msgid "" "Such a working environment for the testing code is called a :dfn:`fixture`." msgstr "" -#: ../src/Doc/library/unittest.rst:416 +#: library/unittest.rst:407 msgid "" "Often, many small test cases will use the same fixture. In this case, we " "would end up subclassing :class:`SimpleWidgetTestCase` into many small one-" @@ -115647,7 +118445,7 @@ msgid "" "provides a simpler mechanism::" msgstr "" -#: ../src/Doc/library/unittest.rst:441 +#: library/unittest.rst:432 msgid "" "Here we have not provided a :meth:`~TestCase.runTest` method, but have " "instead provided two different test methods. Class instances will now each " @@ -115657,25 +118455,25 @@ msgid "" "in the constructor::" msgstr "" -#: ../src/Doc/library/unittest.rst:451 +#: library/unittest.rst:442 msgid "" "Test case instances are grouped together according to the features they " "test. :mod:`unittest` provides a mechanism for this: the :dfn:`test suite`, " "represented by :mod:`unittest`'s :class:`TestSuite` class::" msgstr "" -#: ../src/Doc/library/unittest.rst:459 +#: library/unittest.rst:450 msgid "" "For the ease of running tests, as we will see later, it is a good idea to " "provide in each test module a callable object that returns a pre-built test " "suite::" msgstr "" -#: ../src/Doc/library/unittest.rst:469 +#: library/unittest.rst:460 msgid "or even::" msgstr "" -#: ../src/Doc/library/unittest.rst:476 +#: library/unittest.rst:467 msgid "" "Since it is a common pattern to create a :class:`TestCase` subclass with " "many similarly named test functions, :mod:`unittest` provides a :class:" @@ -115683,7 +118481,7 @@ msgid "" "test suite and populating it with individual tests. For example, ::" msgstr "" -#: ../src/Doc/library/unittest.rst:483 +#: library/unittest.rst:474 msgid "" "will create a test suite that will run ``WidgetTestCase." "test_default_size()`` and ``WidgetTestCase.test_resize``. :class:" @@ -115691,14 +118489,14 @@ msgid "" "automatically." msgstr "" -#: ../src/Doc/library/unittest.rst:487 +#: library/unittest.rst:478 msgid "" "Note that the order in which the various test cases will be run is " "determined by sorting the test function names with respect to the built-in " "ordering for strings." msgstr "" -#: ../src/Doc/library/unittest.rst:491 +#: library/unittest.rst:482 msgid "" "Often it is desirable to group suites of test cases together, so as to run " "tests for the whole system at once. This is easy, since :class:`TestSuite` " @@ -115706,7 +118504,7 @@ msgid "" "instances can be added to a :class:`TestSuite`::" msgstr "" -#: ../src/Doc/library/unittest.rst:500 +#: library/unittest.rst:491 msgid "" "You can place the definitions of test cases and test suites in the same " "modules as the code they are to test (such as :file:`widget.py`), but there " @@ -115714,73 +118512,73 @@ msgid "" "as :file:`test_widget.py`:" msgstr "" -#: ../src/Doc/library/unittest.rst:505 +#: library/unittest.rst:496 msgid "The test module can be run standalone from the command line." msgstr "" -#: ../src/Doc/library/unittest.rst:507 +#: library/unittest.rst:498 msgid "The test code can more easily be separated from shipped code." msgstr "" -#: ../src/Doc/library/unittest.rst:509 +#: library/unittest.rst:500 msgid "" "There is less temptation to change test code to fit the code it tests " "without a good reason." msgstr "" -#: ../src/Doc/library/unittest.rst:512 +#: library/unittest.rst:503 msgid "" "Test code should be modified much less frequently than the code it tests." msgstr "" -#: ../src/Doc/library/unittest.rst:514 +#: library/unittest.rst:505 msgid "Tested code can be refactored more easily." msgstr "" -#: ../src/Doc/library/unittest.rst:516 +#: library/unittest.rst:507 msgid "" "Tests for modules written in C must be in separate modules anyway, so why " "not be consistent?" msgstr "" -#: ../src/Doc/library/unittest.rst:519 +#: library/unittest.rst:510 msgid "" "If the testing strategy changes, there is no need to change the source code." msgstr "" -#: ../src/Doc/library/unittest.rst:525 +#: library/unittest.rst:516 msgid "Re-using old test code" msgstr "" -#: ../src/Doc/library/unittest.rst:527 +#: library/unittest.rst:518 msgid "" "Some users will find that they have existing test code that they would like " "to run from :mod:`unittest`, without converting every old test function to " "a :class:`TestCase` subclass." msgstr "" -#: ../src/Doc/library/unittest.rst:531 +#: library/unittest.rst:522 msgid "" "For this reason, :mod:`unittest` provides a :class:`FunctionTestCase` class. " "This subclass of :class:`TestCase` can be used to wrap an existing test " "function. Set-up and tear-down functions can also be provided." msgstr "" -#: ../src/Doc/library/unittest.rst:535 +#: library/unittest.rst:526 msgid "Given the following test function::" msgstr "" -#: ../src/Doc/library/unittest.rst:542 +#: library/unittest.rst:533 msgid "one can create an equivalent test case instance as follows::" msgstr "" -#: ../src/Doc/library/unittest.rst:546 +#: library/unittest.rst:537 msgid "" "If there are additional set-up and tear-down methods that should be called " "as part of the test case's operation, they can also be provided like so::" msgstr "" -#: ../src/Doc/library/unittest.rst:553 +#: library/unittest.rst:544 msgid "" "To make migrating existing test suites easier, :mod:`unittest` supports " "tests raising :exc:`AssertionError` to indicate test failure. However, it is " @@ -115789,7 +118587,7 @@ msgid "" "may treat :exc:`AssertionError` differently." msgstr "" -#: ../src/Doc/library/unittest.rst:561 +#: library/unittest.rst:552 msgid "" "Even though :class:`FunctionTestCase` can be used to quickly convert an " "existing test base over to a :mod:`unittest`\\ -based system, this approach " @@ -115797,7 +118595,7 @@ msgid "" "subclasses will make future test refactorings infinitely easier." msgstr "" -#: ../src/Doc/library/unittest.rst:566 +#: library/unittest.rst:557 msgid "" "In some cases, the existing tests may have been written using the :mod:" "`doctest` module. If so, :mod:`doctest` provides a :class:`DocTestSuite` " @@ -115805,110 +118603,110 @@ msgid "" "from the existing :mod:`doctest`\\ -based tests." msgstr "" -#: ../src/Doc/library/unittest.rst:575 +#: library/unittest.rst:566 msgid "Skipping tests and expected failures" msgstr "" -#: ../src/Doc/library/unittest.rst:579 +#: library/unittest.rst:570 msgid "" "Unittest supports skipping individual test methods and even whole classes of " -"tests. In addition, it supports marking a test as a \"expected failure,\" a " -"test that is broken and will fail, but shouldn't be counted as a failure on " -"a :class:`TestResult`." +"tests. In addition, it supports marking a test as an \"expected failure,\" " +"a test that is broken and will fail, but shouldn't be counted as a failure " +"on a :class:`TestResult`." msgstr "" -#: ../src/Doc/library/unittest.rst:584 +#: library/unittest.rst:575 msgid "" "Skipping a test is simply a matter of using the :func:`skip` :term:" "`decorator` or one of its conditional variants." msgstr "" # dc9bd75d6d5645dda3c7a23a475cf971 -#: ../src/Doc/library/unittest.rst:587 +#: library/unittest.rst:578 msgid "Basic skipping looks like this::" msgstr "" # 4081b5e428e04ea0bfa6a59a1161bb71 -#: ../src/Doc/library/unittest.rst:606 +#: library/unittest.rst:597 msgid "This is the output of running the example above in verbose mode::" msgstr "" # f06e0ea670784b12bdb8c9d10adc9b73 -#: ../src/Doc/library/unittest.rst:617 +#: library/unittest.rst:608 msgid "Classes can be skipped just like methods::" msgstr "" -#: ../src/Doc/library/unittest.rst:624 +#: library/unittest.rst:615 msgid "" ":meth:`TestCase.setUp` can also skip the test. This is useful when a " "resource that needs to be set up is not available." msgstr "" -#: ../src/Doc/library/unittest.rst:627 +#: library/unittest.rst:618 msgid "Expected failures use the :func:`expectedFailure` decorator. ::" msgstr "" # 05d878454bea4e49ba7ad1a74b9899bc -#: ../src/Doc/library/unittest.rst:634 +#: library/unittest.rst:625 msgid "" "It's easy to roll your own skipping decorators by making a decorator that " "calls :func:`skip` on the test when it wants it to be skipped. This " "decorator skips the test unless the passed object has a certain attribute::" msgstr "" -#: ../src/Doc/library/unittest.rst:643 +#: library/unittest.rst:634 msgid "The following decorators implement test skipping and expected failures:" msgstr "" -#: ../src/Doc/library/unittest.rst:647 +#: library/unittest.rst:638 msgid "" "Unconditionally skip the decorated test. *reason* should describe why the " "test is being skipped." msgstr "" -#: ../src/Doc/library/unittest.rst:652 +#: library/unittest.rst:643 msgid "Skip the decorated test if *condition* is true." msgstr "" # 91f4f07b6ac34a549330bee2a06afd87 -#: ../src/Doc/library/unittest.rst:656 +#: library/unittest.rst:647 msgid "Skip the decorated test unless *condition* is true." msgstr "" -#: ../src/Doc/library/unittest.rst:660 +#: library/unittest.rst:651 msgid "" "Mark the test as an expected failure. If the test fails when run, the test " "is not counted as a failure." msgstr "" # e70378da0f844d92a11c3d84b56d986b -#: ../src/Doc/library/unittest.rst:665 +#: library/unittest.rst:656 msgid "This exception is raised to skip a test." msgstr "" # 825e9148b1a34238829b6ec6a73bd5c6 -#: ../src/Doc/library/unittest.rst:667 +#: library/unittest.rst:658 msgid "" "Usually you can use :meth:`TestCase.skipTest` or one of the skipping " "decorators instead of raising this directly." msgstr "" -#: ../src/Doc/library/unittest.rst:670 +#: library/unittest.rst:661 msgid "" "Skipped tests will not have :meth:`setUp` or :meth:`tearDown` run around " "them. Skipped classes will not have :meth:`setUpClass` or :meth:" "`tearDownClass` run." msgstr "" -#: ../src/Doc/library/unittest.rst:679 +#: library/unittest.rst:670 msgid "This section describes in depth the API of :mod:`unittest`." msgstr "" -#: ../src/Doc/library/unittest.rst:685 +#: library/unittest.rst:676 msgid "Test cases" msgstr "" -#: ../src/Doc/library/unittest.rst:689 +#: library/unittest.rst:680 msgid "" "Instances of the :class:`TestCase` class represent the smallest testable " "units in the :mod:`unittest` universe. This class is intended to be used as " @@ -115918,24 +118716,24 @@ msgid "" "report various kinds of failure." msgstr "" -#: ../src/Doc/library/unittest.rst:696 +#: library/unittest.rst:687 msgid "" "Each instance of :class:`TestCase` will run a single test method: the method " "named *methodName*. If you remember, we had an earlier example that went " "something like this::" msgstr "" -#: ../src/Doc/library/unittest.rst:706 +#: library/unittest.rst:697 msgid "" "Here, we create two instances of :class:`WidgetTestCase`, each of which runs " "a single test." msgstr "" -#: ../src/Doc/library/unittest.rst:709 +#: library/unittest.rst:700 msgid "*methodName* defaults to :meth:`runTest`." msgstr "" -#: ../src/Doc/library/unittest.rst:711 +#: library/unittest.rst:702 msgid "" ":class:`TestCase` instances provide three groups of methods: one group used " "to run the test, another used by the test implementation to check conditions " @@ -115943,12 +118741,12 @@ msgid "" "test itself to be gathered." msgstr "" -#: ../src/Doc/library/unittest.rst:716 +#: library/unittest.rst:707 msgid "Methods in the first group (running the test) are:" msgstr "" # 5c30433d25544b4a82345d135f168647 -#: ../src/Doc/library/unittest.rst:721 +#: library/unittest.rst:712 msgid "" "Method called to prepare the test fixture. This is called immediately " "before calling the test method; other than :exc:`AssertionError` or :exc:" @@ -115957,7 +118755,7 @@ msgid "" msgstr "" # a22e783e34634f2bbec7915aff538e41 -#: ../src/Doc/library/unittest.rst:729 +#: library/unittest.rst:720 msgid "" "Method called immediately after the test method has been called and the " "result recorded. This is called even if the test method raised an " @@ -115969,18 +118767,18 @@ msgid "" "method. The default implementation does nothing." msgstr "" -#: ../src/Doc/library/unittest.rst:740 +#: library/unittest.rst:731 msgid "" "A class method called before tests in an individual class run. " "``setUpClass`` is called with the class as the only argument and must be " "decorated as a :func:`classmethod`::" msgstr "" -#: ../src/Doc/library/unittest.rst:748 ../src/Doc/library/unittest.rst:763 +#: library/unittest.rst:739 library/unittest.rst:754 msgid "See `Class and Module Fixtures`_ for more details." msgstr "" -#: ../src/Doc/library/unittest.rst:755 +#: library/unittest.rst:746 msgid "" "A class method called after tests in an individual class have run. " "``tearDownClass`` is called with the class as the only argument and must be " @@ -115988,7 +118786,7 @@ msgid "" msgstr "" # 42e4b676e6144d848e281029fcbe2e49 -#: ../src/Doc/library/unittest.rst:770 +#: library/unittest.rst:761 msgid "" "Run the test, collecting the result into the test result object passed as " "*result*. If *result* is omitted or ``None``, a temporary result object is " @@ -115996,18 +118794,18 @@ msgid "" "result object is not returned to :meth:`run`'s caller." msgstr "" -#: ../src/Doc/library/unittest.rst:775 +#: library/unittest.rst:766 msgid "" "The same effect may be had by simply calling the :class:`TestCase` instance." msgstr "" -#: ../src/Doc/library/unittest.rst:781 +#: library/unittest.rst:772 msgid "" "Calling this during a test method or :meth:`setUp` skips the current test. " "See :ref:`unittest-skipping` for more information." msgstr "" -#: ../src/Doc/library/unittest.rst:789 +#: library/unittest.rst:780 msgid "" "Run the test without collecting the result. This allows exceptions raised " "by the test to be propagated to the caller, and can be used to support " @@ -116015,7 +118813,7 @@ msgid "" msgstr "" # d4f62604e9c14cdbba277329943e69ae -#: ../src/Doc/library/unittest.rst:795 +#: library/unittest.rst:786 msgid "" "The :class:`TestCase` class provides a number of methods to check for and " "report failures, such as:" @@ -116025,16 +118823,15 @@ msgstr "" # bc995f13b8f34920890ca3c74505708c # 6488c76c04064a43a69c0ccb90c131d1 # c80eb55655ba4ec896aed1849104bb96 -#: ../src/Doc/library/unittest.rst:799 ../src/Doc/library/unittest.rst:914 -#: ../src/Doc/library/unittest.rst:976 ../src/Doc/library/unittest.rst:1119 +#: library/unittest.rst:790 library/unittest.rst:905 library/unittest.rst:967 +#: library/unittest.rst:1110 msgid "Method" msgstr "" # 81abb8f3b5e64c53b8124a4ca06e7552 # 942764037515425990be39c69c1fcc41 # 13cc0207964d48c08ec0c4944d40cb4a -#: ../src/Doc/library/unittest.rst:799 ../src/Doc/library/unittest.rst:914 -#: ../src/Doc/library/unittest.rst:976 +#: library/unittest.rst:790 library/unittest.rst:905 library/unittest.rst:967 msgid "Checks that" msgstr "" @@ -116042,128 +118839,125 @@ msgstr "" # c43b83b34c7946acaa37b86ad2c47256 # 785d99c1f09d43109a00be8c44c9c960 # 9f385ca5e5c946df9b40872cb52dc5c1 -#: ../src/Doc/library/unittest.rst:799 ../src/Doc/library/unittest.rst:914 -#: ../src/Doc/library/unittest.rst:976 ../src/Doc/library/unittest.rst:1119 +#: library/unittest.rst:790 library/unittest.rst:905 library/unittest.rst:967 +#: library/unittest.rst:1110 msgid "New in" msgstr "" # 1ad22fe0e3b14cb19ffb1ac82330912d -#: ../src/Doc/library/unittest.rst:801 +#: library/unittest.rst:792 msgid ":meth:`assertEqual(a, b) <TestCase.assertEqual>`" msgstr "" # c682098f8c0745d19da15c5669ad33ef -#: ../src/Doc/library/unittest.rst:804 +#: library/unittest.rst:795 msgid ":meth:`assertNotEqual(a, b) <TestCase.assertNotEqual>`" msgstr "" # a91d8337d7fb4b1783ff707916ad1b3f -#: ../src/Doc/library/unittest.rst:807 +#: library/unittest.rst:798 msgid ":meth:`assertTrue(x) <TestCase.assertTrue>`" msgstr "" # e3b63a1a4b1a48008967bbadea8951e5 -#: ../src/Doc/library/unittest.rst:807 +#: library/unittest.rst:798 msgid "``bool(x) is True``" msgstr "" # 008e072154c64bcdb6e87a6b6b5d8628 -#: ../src/Doc/library/unittest.rst:810 +#: library/unittest.rst:801 msgid ":meth:`assertFalse(x) <TestCase.assertFalse>`" msgstr "" # 2ab4e840ed15478c891dbbb3c2598121 -#: ../src/Doc/library/unittest.rst:810 +#: library/unittest.rst:801 msgid "``bool(x) is False``" msgstr "" # dd229f00f9b04ed49f6491ce661fa1f3 -#: ../src/Doc/library/unittest.rst:813 +#: library/unittest.rst:804 msgid ":meth:`assertIs(a, b) <TestCase.assertIs>`" msgstr "" -#: ../src/Doc/library/unittest.rst:813 ../src/Doc/library/unittest.rst:816 -#: ../src/Doc/library/unittest.rst:819 ../src/Doc/library/unittest.rst:822 -#: ../src/Doc/library/unittest.rst:825 ../src/Doc/library/unittest.rst:828 -#: ../src/Doc/library/unittest.rst:831 ../src/Doc/library/unittest.rst:834 -#: ../src/Doc/library/unittest.rst:919 ../src/Doc/library/unittest.rst:984 -#: ../src/Doc/library/unittest.rst:987 ../src/Doc/library/unittest.rst:990 -#: ../src/Doc/library/unittest.rst:993 ../src/Doc/library/unittest.rst:996 -#: ../src/Doc/library/unittest.rst:999 ../src/Doc/library/unittest.rst:1002 -#: ../src/Doc/library/unittest.rst:1005 ../src/Doc/library/unittest.rst:1121 -#: ../src/Doc/library/unittest.rst:1124 ../src/Doc/library/unittest.rst:1127 -#: ../src/Doc/library/unittest.rst:1130 ../src/Doc/library/unittest.rst:1133 -#: ../src/Doc/library/unittest.rst:1136 +#: library/unittest.rst:804 library/unittest.rst:807 library/unittest.rst:810 +#: library/unittest.rst:813 library/unittest.rst:816 library/unittest.rst:819 +#: library/unittest.rst:822 library/unittest.rst:825 library/unittest.rst:910 +#: library/unittest.rst:975 library/unittest.rst:978 library/unittest.rst:981 +#: library/unittest.rst:984 library/unittest.rst:987 library/unittest.rst:990 +#: library/unittest.rst:993 library/unittest.rst:996 library/unittest.rst:1112 +#: library/unittest.rst:1115 library/unittest.rst:1118 +#: library/unittest.rst:1121 library/unittest.rst:1124 +#: library/unittest.rst:1127 msgid "2.7" msgstr "2.7" # 4c92660e62b946188deba75ed28c38e6 -#: ../src/Doc/library/unittest.rst:816 +#: library/unittest.rst:807 msgid ":meth:`assertIsNot(a, b) <TestCase.assertIsNot>`" msgstr "" # 06ec8b6bf7b04fa7b9fdace5382ec451 -#: ../src/Doc/library/unittest.rst:819 +#: library/unittest.rst:810 msgid ":meth:`assertIsNone(x) <TestCase.assertIsNone>`" msgstr "" # 348e8cf9e67a4f51b78e5919887aafd9 -#: ../src/Doc/library/unittest.rst:819 +#: library/unittest.rst:810 msgid "``x is None``" msgstr "" # c3239ece781b4c4f928f8d3827180f7e -#: ../src/Doc/library/unittest.rst:822 +#: library/unittest.rst:813 msgid ":meth:`assertIsNotNone(x) <TestCase.assertIsNotNone>`" msgstr "" # 1481d4390bee4234955814cf3c381996 -#: ../src/Doc/library/unittest.rst:822 +#: library/unittest.rst:813 msgid "``x is not None``" msgstr "" # 4f51857365a34a65a4517ff5888a8d04 -#: ../src/Doc/library/unittest.rst:825 +#: library/unittest.rst:816 msgid ":meth:`assertIn(a, b) <TestCase.assertIn>`" msgstr "" # 38643102426e4eb9acd8319039c76680 -#: ../src/Doc/library/unittest.rst:825 +#: library/unittest.rst:816 msgid "``a in b``" msgstr "" # 97cbb13984ae451db5db1419c64f9bab -#: ../src/Doc/library/unittest.rst:828 +#: library/unittest.rst:819 msgid ":meth:`assertNotIn(a, b) <TestCase.assertNotIn>`" msgstr "" # 41cce47f3bfb45158ab73d2fa99a7ff3 -#: ../src/Doc/library/unittest.rst:828 +#: library/unittest.rst:819 msgid "``a not in b``" msgstr "" # 035c2a518bbb4809a531a682ebaa6f9b -#: ../src/Doc/library/unittest.rst:831 +#: library/unittest.rst:822 msgid ":meth:`assertIsInstance(a, b) <TestCase.assertIsInstance>`" msgstr "" # 6aea9518a9d84698b2e4df132bca46e4 -#: ../src/Doc/library/unittest.rst:831 +#: library/unittest.rst:822 msgid "``isinstance(a, b)``" msgstr "" # 5db4a358ef864784a97524c9170cde95 -#: ../src/Doc/library/unittest.rst:834 +#: library/unittest.rst:825 msgid ":meth:`assertNotIsInstance(a, b) <TestCase.assertNotIsInstance>`" msgstr "" # e720638041744d4ba79592031105c869 -#: ../src/Doc/library/unittest.rst:834 +#: library/unittest.rst:825 msgid "``not isinstance(a, b)``" msgstr "" # 991a7d1904a64acea5e116edc684051f -#: ../src/Doc/library/unittest.rst:838 +#: library/unittest.rst:829 msgid "" "All the assert methods (except :meth:`assertRaises`, :meth:" "`assertRaisesRegexp`) accept a *msg* argument that, if specified, is used as " @@ -116171,14 +118965,14 @@ msgid "" msgstr "" # 51ee6e28390c405ca75c9e4ef97f616d -#: ../src/Doc/library/unittest.rst:845 +#: library/unittest.rst:836 msgid "" "Test that *first* and *second* are equal. If the values do not compare " "equal, the test will fail." msgstr "" # 7d82364c932f403690816a83687bec55 -#: ../src/Doc/library/unittest.rst:848 +#: library/unittest.rst:839 msgid "" "In addition, if *first* and *second* are the exact same type and one of " "list, tuple, dict, set, frozenset or unicode or any type that a subclass " @@ -116188,20 +118982,24 @@ msgid "" "methods>`)." msgstr "" +#: library/unittest.rst:846 +msgid "Added the automatic calling of type-specific equality function." +msgstr "" + # a10f653f77d74e129bed45c0b744c0b9 -#: ../src/Doc/library/unittest.rst:861 +#: library/unittest.rst:852 msgid "" "Test that *first* and *second* are not equal. If the values do compare " "equal, the test will fail." msgstr "" # 8357bb6d7dce4434ba790cb2790253a1 -#: ../src/Doc/library/unittest.rst:867 +#: library/unittest.rst:858 msgid "Test that *expr* is true (or false)." msgstr "" # 46cc44ebebbf47c5bcfdc24e198278eb -#: ../src/Doc/library/unittest.rst:869 +#: library/unittest.rst:860 msgid "" "Note that this is equivalent to ``bool(expr) is True`` and not to ``expr is " "True`` (use ``assertIs(expr, True)`` for the latter). This method should " @@ -116211,24 +119009,24 @@ msgid "" msgstr "" # 51adf5fe84a14cecad5c20d79463eefa -#: ../src/Doc/library/unittest.rst:879 +#: library/unittest.rst:870 msgid "" "Test that *first* and *second* evaluate (or don't evaluate) to the same " "object." msgstr "" # 692119484a80489d8e64494728b5c849 -#: ../src/Doc/library/unittest.rst:887 +#: library/unittest.rst:878 msgid "Test that *expr* is (or is not) None." msgstr "" # 5ec58c85fc424e0bb84d4d47a8f496a3 -#: ../src/Doc/library/unittest.rst:895 +#: library/unittest.rst:886 msgid "Test that *first* is (or is not) in *second*." msgstr "" # f1fd6cc11caa4015add2d9965ff1ff6e -#: ../src/Doc/library/unittest.rst:903 +#: library/unittest.rst:894 msgid "" "Test that *obj* is (or is not) an instance of *cls* (which can be a class or " "a tuple of classes, as supported by :func:`isinstance`). To check for the " @@ -116236,35 +119034,35 @@ msgid "" msgstr "" # 0eb85af3699544358c51b13555603137 -#: ../src/Doc/library/unittest.rst:910 +#: library/unittest.rst:901 msgid "" "It is also possible to check that exceptions and warnings are raised using " "the following methods:" msgstr "" # 81c0135665914b9f9c8a592b89823317 -#: ../src/Doc/library/unittest.rst:916 +#: library/unittest.rst:907 msgid ":meth:`assertRaises(exc, fun, *args, **kwds) <TestCase.assertRaises>`" msgstr "" # 72d3c01accdb4a24bb7ae0159ae6ac7b -#: ../src/Doc/library/unittest.rst:916 +#: library/unittest.rst:907 msgid "``fun(*args, **kwds)`` raises *exc*" msgstr "" # 8f801b3401ed43d28f7ffd7e74656111 -#: ../src/Doc/library/unittest.rst:919 +#: library/unittest.rst:910 msgid "" ":meth:`assertRaisesRegexp(exc, r, fun, *args, **kwds) <TestCase." "assertRaisesRegexp>`" msgstr "" # 52916ae5b816443cbe176e5ae78ce1de -#: ../src/Doc/library/unittest.rst:919 +#: library/unittest.rst:910 msgid "``fun(*args, **kwds)`` raises *exc* and the message matches regex *r*" msgstr "" -#: ../src/Doc/library/unittest.rst:926 +#: library/unittest.rst:917 msgid "" "Test that an exception is raised when *callable* is called with any " "positional or keyword arguments that are also passed to :meth:" @@ -116274,20 +119072,24 @@ msgid "" "be passed as *exception*." msgstr "" -#: ../src/Doc/library/unittest.rst:933 +#: library/unittest.rst:924 msgid "" "If only the *exception* argument is given, returns a context manager so that " "the code under test can be written inline rather than as a function::" msgstr "" -#: ../src/Doc/library/unittest.rst:939 +#: library/unittest.rst:930 msgid "" "The context manager will store the caught exception object in its :attr:" "`exception` attribute. This can be useful if the intention is to perform " "additional checks on the exception raised::" msgstr "" -#: ../src/Doc/library/unittest.rst:956 +#: library/unittest.rst:940 +msgid "Added the ability to use :meth:`assertRaises` as a context manager." +msgstr "" + +#: library/unittest.rst:947 msgid "" "Like :meth:`assertRaises` but also tests that *regexp* matches on the string " "representation of the raised exception. *regexp* may be a regular " @@ -116296,94 +119098,94 @@ msgid "" msgstr "" # bf573d3283d94751b06c135230de928d -#: ../src/Doc/library/unittest.rst:973 +#: library/unittest.rst:964 msgid "" "There are also other methods used to perform more specific checks, such as:" msgstr "" # b3d9b3a59a21499dae143011699f8eb3 -#: ../src/Doc/library/unittest.rst:978 +#: library/unittest.rst:969 msgid ":meth:`assertAlmostEqual(a, b) <TestCase.assertAlmostEqual>`" msgstr "" # ff74427dc947454a877299f66efd311d -#: ../src/Doc/library/unittest.rst:978 +#: library/unittest.rst:969 msgid "``round(a-b, 7) == 0``" msgstr "" # c311564fa02a4be2bebf71fa33f55549 -#: ../src/Doc/library/unittest.rst:981 +#: library/unittest.rst:972 msgid ":meth:`assertNotAlmostEqual(a, b) <TestCase.assertNotAlmostEqual>`" msgstr "" # e0e0bf5f1e2742ce913db4ac8bf483ad -#: ../src/Doc/library/unittest.rst:981 +#: library/unittest.rst:972 msgid "``round(a-b, 7) != 0``" msgstr "" # 147d33f239dc4c4d9887d0dbd278b0af -#: ../src/Doc/library/unittest.rst:984 +#: library/unittest.rst:975 msgid ":meth:`assertGreater(a, b) <TestCase.assertGreater>`" msgstr "" # 4dd609d8e6b841d5a83b6a80deee7918 -#: ../src/Doc/library/unittest.rst:987 +#: library/unittest.rst:978 msgid ":meth:`assertGreaterEqual(a, b) <TestCase.assertGreaterEqual>`" msgstr "" # cee3d108eff449e9bdde90beff69e68b -#: ../src/Doc/library/unittest.rst:990 +#: library/unittest.rst:981 msgid ":meth:`assertLess(a, b) <TestCase.assertLess>`" msgstr "" # fb51b18b9cd841f0b6c37ffeaec4623e -#: ../src/Doc/library/unittest.rst:993 +#: library/unittest.rst:984 msgid ":meth:`assertLessEqual(a, b) <TestCase.assertLessEqual>`" msgstr "" # 6ce26fd0faa14f25a1cc22a86e86d3fb -#: ../src/Doc/library/unittest.rst:996 +#: library/unittest.rst:987 msgid ":meth:`assertRegexpMatches(s, r) <TestCase.assertRegexpMatches>`" msgstr "" # 2f41a79fb3934ac4820de1b9ecb692f0 -#: ../src/Doc/library/unittest.rst:996 +#: library/unittest.rst:987 msgid "``r.search(s)``" msgstr "" # 2048e7d4df2e4e7b810857a02e7725b5 -#: ../src/Doc/library/unittest.rst:999 +#: library/unittest.rst:990 msgid ":meth:`assertNotRegexpMatches(s, r) <TestCase.assertNotRegexpMatches>`" msgstr "" # 26e82ee4a01a4314948fb71ba6420912 -#: ../src/Doc/library/unittest.rst:999 +#: library/unittest.rst:990 msgid "``not r.search(s)``" msgstr "" # d89e810560e14c7f93162472f2f52c76 -#: ../src/Doc/library/unittest.rst:1002 +#: library/unittest.rst:993 msgid ":meth:`assertItemsEqual(a, b) <TestCase.assertItemsEqual>`" msgstr "" # e5909daacd974ef69e2a799a3fe37c7f -#: ../src/Doc/library/unittest.rst:1002 +#: library/unittest.rst:993 msgid "sorted(a) == sorted(b) and works with unhashable objs" msgstr "" # 5f358f6ddbcd446abee50fd82146c211 -#: ../src/Doc/library/unittest.rst:1005 +#: library/unittest.rst:996 msgid "" ":meth:`assertDictContainsSubset(a, b) <TestCase.assertDictContainsSubset>`" msgstr "" # 83871316b8a84aa2bf19235b0f3a7bf3 -#: ../src/Doc/library/unittest.rst:1005 +#: library/unittest.rst:996 msgid "all the key/value pairs in *a* exist in *b*" msgstr "" # b3282dae298e49feac03557b8bc1f44c -#: ../src/Doc/library/unittest.rst:1013 +#: library/unittest.rst:1004 msgid "" "Test that *first* and *second* are approximately (or not approximately) " "equal by computing the difference, rounding to the given number of decimal " @@ -116393,25 +119195,32 @@ msgid "" msgstr "" # af19624677484baa91e6ff3262e2ce0b -#: ../src/Doc/library/unittest.rst:1019 +#: library/unittest.rst:1010 msgid "" "If *delta* is supplied instead of *places* then the difference between " "*first* and *second* must be less or equal to (or greater than) *delta*." msgstr "" -#: ../src/Doc/library/unittest.rst:1022 +#: library/unittest.rst:1013 msgid "Supplying both *delta* and *places* raises a ``TypeError``." msgstr "" +#: library/unittest.rst:1015 +msgid "" +":meth:`assertAlmostEqual` automatically considers almost equal objects that " +"compare equal. :meth:`assertNotAlmostEqual` automatically fails if the " +"objects compare equal. Added the *delta* keyword argument." +msgstr "" + # 688e9ffb5aa848f8a1d30386ad9830fa -#: ../src/Doc/library/unittest.rst:1036 +#: library/unittest.rst:1027 msgid "" "Test that *first* is respectively >, >=, < or <= than *second* depending on " "the method name. If not, the test will fail::" msgstr "" # 3838a3ddbcf246d18a56e91d448eb416 -#: ../src/Doc/library/unittest.rst:1047 +#: library/unittest.rst:1038 msgid "" "Test that a *regexp* search matches *text*. In case of failure, the error " "message will include the pattern and the *text* (or the pattern and the part " @@ -116420,7 +119229,7 @@ msgid "" "`re.search`." msgstr "" -#: ../src/Doc/library/unittest.rst:1058 +#: library/unittest.rst:1049 msgid "" "Verifies that a *regexp* search does not match *text*. Fails with an error " "message including the pattern and the part of *text* that matches. *regexp* " @@ -116428,14 +119237,14 @@ msgid "" "expression suitable for use by :func:`re.search`." msgstr "" -#: ../src/Doc/library/unittest.rst:1068 +#: library/unittest.rst:1059 msgid "" "Test that sequence *expected* contains the same elements as *actual*, " "regardless of their order. When they don't, an error message listing the " "differences between the sequences will be generated." msgstr "" -#: ../src/Doc/library/unittest.rst:1072 +#: library/unittest.rst:1063 msgid "" "Duplicate elements are *not* ignored when comparing *actual* and *expected*. " "It verifies if each element has the same count in both sequences. It is the " @@ -116444,11 +119253,11 @@ msgid "" msgstr "" # ec9c7dffbf564d3fb2abd8f749c871e6 -#: ../src/Doc/library/unittest.rst:1078 +#: library/unittest.rst:1069 msgid "In Python 3, this method is named ``assertCountEqual``." msgstr "" -#: ../src/Doc/library/unittest.rst:1085 +#: library/unittest.rst:1076 msgid "" "Tests whether the key/value pairs in dictionary *actual* are a superset of " "those in *expected*. If not, an error message listing the missing keys and " @@ -116456,7 +119265,7 @@ msgid "" msgstr "" # 4011c5d057d54005b5adc0db8e327ee3 -#: ../src/Doc/library/unittest.rst:1096 +#: library/unittest.rst:1087 msgid "" "The :meth:`assertEqual` method dispatches the equality check for objects of " "the same type to different type-specific methods. These methods are already " @@ -116465,7 +119274,7 @@ msgid "" msgstr "" # 7764c8026f5d4a3e8fb39229ba8dafc0 -#: ../src/Doc/library/unittest.rst:1103 +#: library/unittest.rst:1094 msgid "" "Registers a type-specific method called by :meth:`assertEqual` to check if " "two objects of exactly the same *typeobj* (not subclasses) compare equal. " @@ -116477,7 +119286,7 @@ msgid "" msgstr "" # 825e9148b1a34238829b6ec6a73bd5c6 -#: ../src/Doc/library/unittest.rst:1114 +#: library/unittest.rst:1105 msgid "" "The list of type-specific methods automatically used by :meth:`~TestCase." "assertEqual` are summarized in the following table. Note that it's usually " @@ -116485,71 +119294,71 @@ msgid "" msgstr "" # b4ceec0caa9f4162b9e00178bbdf73e9 -#: ../src/Doc/library/unittest.rst:1119 +#: library/unittest.rst:1110 msgid "Used to compare" msgstr "" # fb9450cae8a4442394c55b06605a27ce -#: ../src/Doc/library/unittest.rst:1121 +#: library/unittest.rst:1112 msgid ":meth:`assertMultiLineEqual(a, b) <TestCase.assertMultiLineEqual>`" msgstr "" # 398d1098635143759891c9fcd993b5e4 -#: ../src/Doc/library/unittest.rst:1121 +#: library/unittest.rst:1112 msgid "strings" msgstr "" # d8e561e37de342f7a2f614e35d714e28 -#: ../src/Doc/library/unittest.rst:1124 +#: library/unittest.rst:1115 msgid ":meth:`assertSequenceEqual(a, b) <TestCase.assertSequenceEqual>`" msgstr "" # c30f706204e340f8ab6f2c283b145a4c -#: ../src/Doc/library/unittest.rst:1124 +#: library/unittest.rst:1115 msgid "sequences" msgstr "" # cd05cc14330b44a688f6e46915435b7b -#: ../src/Doc/library/unittest.rst:1127 +#: library/unittest.rst:1118 msgid ":meth:`assertListEqual(a, b) <TestCase.assertListEqual>`" msgstr "" # 2bdec029d05e4b57b4c55a83cf18ca0d -#: ../src/Doc/library/unittest.rst:1127 +#: library/unittest.rst:1118 msgid "lists" msgstr "" # 8f82d4f20e3d411fbb739dde745f6d5e -#: ../src/Doc/library/unittest.rst:1130 +#: library/unittest.rst:1121 msgid ":meth:`assertTupleEqual(a, b) <TestCase.assertTupleEqual>`" msgstr "" # 9d0b1cf5d4754d6988cfac2983a80377 -#: ../src/Doc/library/unittest.rst:1130 +#: library/unittest.rst:1121 msgid "tuples" msgstr "" # ec89c4aa8add482799bdb418e0d3962d -#: ../src/Doc/library/unittest.rst:1133 +#: library/unittest.rst:1124 msgid ":meth:`assertSetEqual(a, b) <TestCase.assertSetEqual>`" msgstr "" # 4b71de9fbee0496aba985e1f487586c3 -#: ../src/Doc/library/unittest.rst:1133 +#: library/unittest.rst:1124 msgid "sets or frozensets" msgstr "" # 644915923122475ba0068d3ff55ae280 -#: ../src/Doc/library/unittest.rst:1136 +#: library/unittest.rst:1127 msgid ":meth:`assertDictEqual(a, b) <TestCase.assertDictEqual>`" msgstr "" # ffcab7b4e4184a108118b581f11e25c3 -#: ../src/Doc/library/unittest.rst:1136 +#: library/unittest.rst:1127 msgid "dicts" msgstr "" -#: ../src/Doc/library/unittest.rst:1144 +#: library/unittest.rst:1135 msgid "" "Test that the multiline string *first* is equal to the string *second*. When " "not equal a diff of the two strings highlighting the differences will be " @@ -116557,7 +119366,7 @@ msgid "" "strings with :meth:`assertEqual`." msgstr "" -#: ../src/Doc/library/unittest.rst:1154 +#: library/unittest.rst:1145 msgid "" "Tests that two sequences are equal. If a *seq_type* is supplied, both " "*seq1* and *seq2* must be instances of *seq_type* or a failure will be " @@ -116566,14 +119375,14 @@ msgid "" msgstr "" # 5fd7cf5d46f74e14a5248ecc5b43434b -#: ../src/Doc/library/unittest.rst:1159 +#: library/unittest.rst:1150 msgid "" "This method is not called directly by :meth:`assertEqual`, but it's used to " "implement :meth:`assertListEqual` and :meth:`assertTupleEqual`." msgstr "" # 59d7c3fa3d8e4078834d49be867fb261 -#: ../src/Doc/library/unittest.rst:1169 +#: library/unittest.rst:1160 msgid "" "Tests that two lists or tuples are equal. If not, an error message is " "constructed that shows only the differences between the two. An error is " @@ -116581,20 +119390,20 @@ msgid "" "are used by default when comparing lists or tuples with :meth:`assertEqual`." msgstr "" -#: ../src/Doc/library/unittest.rst:1180 +#: library/unittest.rst:1171 msgid "" "Tests that two sets are equal. If not, an error message is constructed that " "lists the differences between the sets. This method is used by default when " "comparing sets or frozensets with :meth:`assertEqual`." msgstr "" -#: ../src/Doc/library/unittest.rst:1184 +#: library/unittest.rst:1175 msgid "" "Fails if either of *set1* or *set2* does not have a :meth:`set.difference` " "method." msgstr "" -#: ../src/Doc/library/unittest.rst:1192 +#: library/unittest.rst:1183 msgid "" "Test that two dictionaries are equal. If not, an error message is " "constructed that shows the differences in the dictionaries. This method will " @@ -116602,19 +119411,19 @@ msgid "" msgstr "" # 078d0b902b924f3e91229a90ef37af8f -#: ../src/Doc/library/unittest.rst:1203 +#: library/unittest.rst:1194 msgid "" "Finally the :class:`TestCase` provides the following methods and attributes:" msgstr "" # a72a29cb668e4e428b01b7ff145463c5 -#: ../src/Doc/library/unittest.rst:1208 +#: library/unittest.rst:1199 msgid "" "Signals a test failure unconditionally, with *msg* or ``None`` for the error " "message." msgstr "" -#: ../src/Doc/library/unittest.rst:1214 +#: library/unittest.rst:1205 msgid "" "This class attribute gives the exception raised by the test method. If a " "test framework needs to use a specialized exception, possibly to carry " @@ -116624,7 +119433,7 @@ msgid "" msgstr "" # 42acf37af0e84288a8a40d6d11dd1e4a -#: ../src/Doc/library/unittest.rst:1223 +#: library/unittest.rst:1214 msgid "" "If set to ``True`` then any explicit failure message you pass in to the :ref:" "`assert methods <assert-methods>` will be appended to the end of the normal " @@ -116635,21 +119444,21 @@ msgid "" msgstr "" # 8c9ece485b454e29964610b539f82a47 -#: ../src/Doc/library/unittest.rst:1231 +#: library/unittest.rst:1222 msgid "" "This attribute defaults to ``False``, meaning that a custom message passed " "to an assert method will silence the normal message." msgstr "" # 554fd6b7840a4e7696c976f3bc77e421 -#: ../src/Doc/library/unittest.rst:1234 +#: library/unittest.rst:1225 msgid "" "The class setting can be overridden in individual tests by assigning an " "instance attribute to ``True`` or ``False`` before calling the assert " "methods." msgstr "" -#: ../src/Doc/library/unittest.rst:1242 +#: library/unittest.rst:1233 msgid "" "This attribute controls the maximum length of diffs output by assert methods " "that report diffs on failure. It defaults to 80*8 characters. Assert methods " @@ -116658,52 +119467,52 @@ msgid "" "`assertDictEqual` and :meth:`assertMultiLineEqual`." msgstr "" -#: ../src/Doc/library/unittest.rst:1249 +#: library/unittest.rst:1240 msgid "" "Setting ``maxDiff`` to None means that there is no maximum length of diffs." msgstr "" -#: ../src/Doc/library/unittest.rst:1255 +#: library/unittest.rst:1246 msgid "" "Testing frameworks can use the following methods to collect information on " "the test:" msgstr "" -#: ../src/Doc/library/unittest.rst:1261 +#: library/unittest.rst:1252 msgid "" "Return the number of tests represented by this test object. For :class:" "`TestCase` instances, this will always be ``1``." msgstr "" -#: ../src/Doc/library/unittest.rst:1267 +#: library/unittest.rst:1258 msgid "" "Return an instance of the test result class that should be used for this " "test case class (if no other result instance is provided to the :meth:`run` " "method)." msgstr "" -#: ../src/Doc/library/unittest.rst:1271 +#: library/unittest.rst:1262 msgid "" "For :class:`TestCase` instances, this will always be an instance of :class:" "`TestResult`; subclasses of :class:`TestCase` should override this as " "necessary." msgstr "" -#: ../src/Doc/library/unittest.rst:1278 +#: library/unittest.rst:1269 msgid "" "Return a string identifying the specific test case. This is usually the " "full name of the test method, including the module and class name." msgstr "" # 2760f0fd160841dc944c59305ac94ec4 -#: ../src/Doc/library/unittest.rst:1284 +#: library/unittest.rst:1275 msgid "" "Returns a description of the test, or ``None`` if no description has been " "provided. The default implementation of this method returns the first line " "of the test method's docstring, if available, or :const:`None`." msgstr "" -#: ../src/Doc/library/unittest.rst:1293 +#: library/unittest.rst:1284 msgid "" "Add a function to be called after :meth:`tearDown` to cleanup resources used " "during the test. Functions will be called in reverse order to the order they " @@ -116711,32 +119520,32 @@ msgid "" "passed into :meth:`addCleanup` when they are added." msgstr "" -#: ../src/Doc/library/unittest.rst:1299 +#: library/unittest.rst:1290 msgid "" "If :meth:`setUp` fails, meaning that :meth:`tearDown` is not called, then " "any cleanup functions added will still be called." msgstr "" -#: ../src/Doc/library/unittest.rst:1307 +#: library/unittest.rst:1298 msgid "" "This method is called unconditionally after :meth:`tearDown`, or after :meth:" "`setUp` if :meth:`setUp` raises an exception." msgstr "" -#: ../src/Doc/library/unittest.rst:1310 +#: library/unittest.rst:1301 msgid "" "It is responsible for calling all the cleanup functions added by :meth:" "`addCleanup`. If you need cleanup functions to be called *prior* to :meth:" "`tearDown` then you can call :meth:`doCleanups` yourself." msgstr "" -#: ../src/Doc/library/unittest.rst:1315 +#: library/unittest.rst:1306 msgid "" ":meth:`doCleanups` pops methods off the stack of cleanup functions one at a " "time, so it can be called at any time." msgstr "" -#: ../src/Doc/library/unittest.rst:1323 +#: library/unittest.rst:1314 msgid "" "This class implements the portion of the :class:`TestCase` interface which " "allows the test runner to drive the test, but does not provide the methods " @@ -116746,12 +119555,12 @@ msgid "" msgstr "" # bd258f9b7f9d4822984935c13ea5fdba -#: ../src/Doc/library/unittest.rst:1331 +#: library/unittest.rst:1322 msgid "Deprecated aliases" msgstr "" # bd3cb9362b2044629922ed51f13b8977 -#: ../src/Doc/library/unittest.rst:1333 +#: library/unittest.rst:1324 msgid "" "For historical reasons, some of the :class:`TestCase` methods had one or " "more aliases that are now deprecated. The following table lists the correct " @@ -116759,90 +119568,94 @@ msgid "" msgstr "" # 8a5ea4d3ac4c4ce5b9614e092d86275f -#: ../src/Doc/library/unittest.rst:1338 +#: library/unittest.rst:1329 msgid "Method Name" msgstr "" # 134479196c024bb59d47b81e4a69dcb5 -#: ../src/Doc/library/unittest.rst:1338 +#: library/unittest.rst:1329 msgid "Deprecated alias(es)" msgstr "" # f20f0abc192845748971e694f93c00ae -#: ../src/Doc/library/unittest.rst:1340 +#: library/unittest.rst:1331 msgid ":meth:`.assertEqual`" msgstr "" # a50b70a050a14bb884a99665ce977605 -#: ../src/Doc/library/unittest.rst:1340 +#: library/unittest.rst:1331 msgid "failUnlessEqual, assertEquals" msgstr "" # 29323a5e20af43c5b367c3c5399171d8 -#: ../src/Doc/library/unittest.rst:1341 +#: library/unittest.rst:1332 msgid ":meth:`.assertNotEqual`" msgstr "" # fa9d18478569441bb2fe6c5dcdae1c91 -#: ../src/Doc/library/unittest.rst:1341 +#: library/unittest.rst:1332 msgid "failIfEqual" msgstr "" # 745a780a17914cafb1143cf8c34710bb -#: ../src/Doc/library/unittest.rst:1342 +#: library/unittest.rst:1333 msgid ":meth:`.assertTrue`" msgstr "" # 2192a0b6eb3f46a98fa874b69640198b -#: ../src/Doc/library/unittest.rst:1342 +#: library/unittest.rst:1333 msgid "failUnless, assert\\_" msgstr "" # 3faaed9db83a43a3ac07b2b42440424f -#: ../src/Doc/library/unittest.rst:1343 +#: library/unittest.rst:1334 msgid ":meth:`.assertFalse`" msgstr "" # f8f4df5bfa1e42fba507dc467aa5a0fc -#: ../src/Doc/library/unittest.rst:1343 +#: library/unittest.rst:1334 msgid "failIf" msgstr "" # b726eea9f64f4cb5affca6acafc1f4a5 -#: ../src/Doc/library/unittest.rst:1344 +#: library/unittest.rst:1335 msgid ":meth:`.assertRaises`" msgstr "" # 37682e25d5744a6cb5b7cc331094cd30 -#: ../src/Doc/library/unittest.rst:1344 +#: library/unittest.rst:1335 msgid "failUnlessRaises" msgstr "" # 5b95ef1b806f464b9ea109f762fcd636 -#: ../src/Doc/library/unittest.rst:1345 +#: library/unittest.rst:1336 msgid ":meth:`.assertAlmostEqual`" msgstr "" # e253619ee83c49aba3ce80a7ffdedc9e -#: ../src/Doc/library/unittest.rst:1345 +#: library/unittest.rst:1336 msgid "failUnlessAlmostEqual" msgstr "" # a00b0fd6a4574591ba379cde5509c882 -#: ../src/Doc/library/unittest.rst:1346 +#: library/unittest.rst:1337 msgid ":meth:`.assertNotAlmostEqual`" msgstr "" # d781430d6806407690c76787e0278b65 -#: ../src/Doc/library/unittest.rst:1346 +#: library/unittest.rst:1337 msgid "failIfAlmostEqual" msgstr "" -#: ../src/Doc/library/unittest.rst:1357 +#: library/unittest.rst:1340 +msgid "the aliases listed in the second column" +msgstr "" + +#: library/unittest.rst:1348 msgid "Grouping tests" msgstr "" -#: ../src/Doc/library/unittest.rst:1361 +#: library/unittest.rst:1352 msgid "" "This class represents an aggregation of individual tests cases and test " "suites. The class presents the interface needed by the test runner to allow " @@ -116850,14 +119663,14 @@ msgid "" "is the same as iterating over the suite, running each test individually." msgstr "" -#: ../src/Doc/library/unittest.rst:1366 +#: library/unittest.rst:1357 msgid "" "If *tests* is given, it must be an iterable of individual test cases or " "other test suites that will be used to build the suite initially. Additional " "methods are provided to add test cases and suites to the collection later on." msgstr "" -#: ../src/Doc/library/unittest.rst:1370 +#: library/unittest.rst:1361 msgid "" ":class:`TestSuite` objects behave much like :class:`TestCase` objects, " "except they do not actually implement a test. Instead, they are used to " @@ -116866,47 +119679,47 @@ msgid "" "instances:" msgstr "" -#: ../src/Doc/library/unittest.rst:1378 +#: library/unittest.rst:1369 msgid "Add a :class:`TestCase` or :class:`TestSuite` to the suite." msgstr "" -#: ../src/Doc/library/unittest.rst:1383 +#: library/unittest.rst:1374 msgid "" "Add all the tests from an iterable of :class:`TestCase` and :class:" "`TestSuite` instances to this test suite." msgstr "" -#: ../src/Doc/library/unittest.rst:1386 +#: library/unittest.rst:1377 msgid "" "This is equivalent to iterating over *tests*, calling :meth:`addTest` for " "each element." msgstr "" -#: ../src/Doc/library/unittest.rst:1389 +#: library/unittest.rst:1380 msgid ":class:`TestSuite` shares the following methods with :class:`TestCase`:" msgstr "" -#: ../src/Doc/library/unittest.rst:1394 +#: library/unittest.rst:1385 msgid "" "Run the tests associated with this suite, collecting the result into the " "test result object passed as *result*. Note that unlike :meth:`TestCase." "run`, :meth:`TestSuite.run` requires the result object to be passed in." msgstr "" -#: ../src/Doc/library/unittest.rst:1402 +#: library/unittest.rst:1393 msgid "" "Run the tests associated with this suite without collecting the result. This " "allows exceptions raised by the test to be propagated to the caller and can " "be used to support running tests under a debugger." msgstr "" -#: ../src/Doc/library/unittest.rst:1409 +#: library/unittest.rst:1400 msgid "" "Return the number of tests represented by this test object, including all " "individual tests and sub-suites." msgstr "" -#: ../src/Doc/library/unittest.rst:1415 +#: library/unittest.rst:1406 msgid "" "Tests grouped by a :class:`TestSuite` are always accessed by iteration. " "Subclasses can lazily provide tests by overriding :meth:`__iter__`. Note " @@ -116915,18 +119728,25 @@ msgid "" "the same for repeated iterations." msgstr "" -#: ../src/Doc/library/unittest.rst:1426 +#: library/unittest.rst:1412 +msgid "" +"In earlier versions the :class:`TestSuite` accessed tests directly rather " +"than through iteration, so overriding :meth:`__iter__` wasn't sufficient for " +"providing tests." +msgstr "" + +#: library/unittest.rst:1417 msgid "" "In the typical usage of a :class:`TestSuite` object, the :meth:`run` method " "is invoked by a :class:`TestRunner` rather than by the end-user test harness." msgstr "" -#: ../src/Doc/library/unittest.rst:1431 +#: library/unittest.rst:1422 msgid "Loading and running tests" msgstr "" # 085f3cc52cbf4ec782acdc1a916cb1da -#: ../src/Doc/library/unittest.rst:1435 +#: library/unittest.rst:1426 msgid "" "The :class:`TestLoader` class is used to create test suites from classes and " "modules. Normally, there is no need to create an instance of this class; " @@ -116935,24 +119755,24 @@ msgid "" "customization of some configurable properties." msgstr "" -#: ../src/Doc/library/unittest.rst:1441 +#: library/unittest.rst:1432 msgid ":class:`TestLoader` objects have the following methods:" msgstr "" -#: ../src/Doc/library/unittest.rst:1446 +#: library/unittest.rst:1437 msgid "" "Return a suite of all tests cases contained in the :class:`TestCase`\\ -" "derived :class:`testCaseClass`." msgstr "" -#: ../src/Doc/library/unittest.rst:1452 +#: library/unittest.rst:1443 msgid "" "Return a suite of all tests cases contained in the given module. This method " "searches *module* for classes derived from :class:`TestCase` and creates an " "instance of the class for each test method defined for the class." msgstr "" -#: ../src/Doc/library/unittest.rst:1459 +#: library/unittest.rst:1450 msgid "" "While using a hierarchy of :class:`TestCase`\\ -derived classes can be " "convenient in sharing fixtures and helper functions, defining test methods " @@ -116961,18 +119781,22 @@ msgid "" "fixtures are different and defined in subclasses." msgstr "" -#: ../src/Doc/library/unittest.rst:1465 +#: library/unittest.rst:1456 msgid "" "If a module provides a ``load_tests`` function it will be called to load the " "tests. This allows modules to customize test loading. This is the " "`load_tests protocol`_." msgstr "" -#: ../src/Doc/library/unittest.rst:1475 +#: library/unittest.rst:1460 +msgid "Support for ``load_tests`` added." +msgstr "" + +#: library/unittest.rst:1466 msgid "Return a suite of all tests cases given a string specifier." msgstr "" -#: ../src/Doc/library/unittest.rst:1477 +#: library/unittest.rst:1468 msgid "" "The specifier *name* is a \"dotted name\" that may resolve either to a " "module, a test case class, a test method within a test case class, a :class:" @@ -116983,7 +119807,7 @@ msgid "" "object\"." msgstr "" -#: ../src/Doc/library/unittest.rst:1485 +#: library/unittest.rst:1476 msgid "" "For example, if you have a module :mod:`SampleTests` containing a :class:" "`TestCase`\\ -derived class :class:`SampleTestCase` with three test methods " @@ -116996,25 +119820,25 @@ msgid "" "a side-effect." msgstr "" -#: ../src/Doc/library/unittest.rst:1495 +#: library/unittest.rst:1486 msgid "The method optionally resolves *name* relative to the given *module*." msgstr "" -#: ../src/Doc/library/unittest.rst:1500 +#: library/unittest.rst:1491 msgid "" "Similar to :meth:`loadTestsFromName`, but takes a sequence of names rather " "than a single name. The return value is a test suite which supports all the " "tests defined for each name." msgstr "" -#: ../src/Doc/library/unittest.rst:1507 +#: library/unittest.rst:1498 msgid "" "Return a sorted sequence of method names found within *testCaseClass*; this " "should be a subclass of :class:`TestCase`." msgstr "" # bdea2aec35cf4dcfa66ebae1a9704ecc -#: ../src/Doc/library/unittest.rst:1513 +#: library/unittest.rst:1504 msgid "" "Find all the test modules by recursing into subdirectories from the " "specified start directory, and return a TestSuite object containing them. " @@ -117023,33 +119847,33 @@ msgid "" "Python identifiers) will be loaded." msgstr "" -#: ../src/Doc/library/unittest.rst:1519 +#: library/unittest.rst:1510 msgid "" "All test modules must be importable from the top level of the project. If " "the start directory is not the top level directory then the top level " "directory must be specified separately." msgstr "" -#: ../src/Doc/library/unittest.rst:1523 +#: library/unittest.rst:1514 msgid "" "If importing a module fails, for example due to a syntax error, then this " "will be recorded as a single error and discovery will continue." msgstr "" -#: ../src/Doc/library/unittest.rst:1526 +#: library/unittest.rst:1517 msgid "" "If a test package name (directory with :file:`__init__.py`) matches the " "pattern then the package will be checked for a ``load_tests`` function. If " "this exists then it will be called with *loader*, *tests*, *pattern*." msgstr "" -#: ../src/Doc/library/unittest.rst:1531 +#: library/unittest.rst:1522 msgid "" "If load_tests exists then discovery does *not* recurse into the package, " "``load_tests`` is responsible for loading all tests in the package." msgstr "" -#: ../src/Doc/library/unittest.rst:1534 +#: library/unittest.rst:1525 msgid "" "The pattern is deliberately not stored as a loader attribute so that " "packages can continue discovery themselves. *top_level_dir* is stored so " @@ -117057,30 +119881,30 @@ msgid "" "discover()``." msgstr "" -#: ../src/Doc/library/unittest.rst:1539 +#: library/unittest.rst:1530 msgid "*start_dir* can be a dotted module name as well as a directory." msgstr "" -#: ../src/Doc/library/unittest.rst:1543 +#: library/unittest.rst:1534 msgid "" "The following attributes of a :class:`TestLoader` can be configured either " "by subclassing or assignment on an instance:" msgstr "" -#: ../src/Doc/library/unittest.rst:1549 +#: library/unittest.rst:1540 msgid "" "String giving the prefix of method names which will be interpreted as test " "methods. The default value is ``'test'``." msgstr "" -#: ../src/Doc/library/unittest.rst:1552 +#: library/unittest.rst:1543 msgid "" "This affects :meth:`getTestCaseNames` and all the :meth:`loadTestsFrom\\*` " "methods." msgstr "" # 4c1cdaa1b50c42b9845703a7c943f76f -#: ../src/Doc/library/unittest.rst:1558 +#: library/unittest.rst:1549 msgid "" "Function to be used to compare method names when sorting them in :meth:" "`getTestCaseNames` and all the :meth:`loadTestsFrom\\*` methods. The default " @@ -117088,24 +119912,24 @@ msgid "" "to :const:`None` to disable the sort." msgstr "" -#: ../src/Doc/library/unittest.rst:1566 +#: library/unittest.rst:1557 msgid "" "Callable object that constructs a test suite from a list of tests. No " "methods on the resulting object are needed. The default value is the :class:" "`TestSuite` class." msgstr "" -#: ../src/Doc/library/unittest.rst:1570 +#: library/unittest.rst:1561 msgid "This affects all the :meth:`loadTestsFrom\\*` methods." msgstr "" -#: ../src/Doc/library/unittest.rst:1575 +#: library/unittest.rst:1566 msgid "" "This class is used to compile information about which tests have succeeded " "and which have failed." msgstr "" -#: ../src/Doc/library/unittest.rst:1578 +#: library/unittest.rst:1569 msgid "" "A :class:`TestResult` object stores the results of a set of tests. The :" "class:`TestCase` and :class:`TestSuite` classes ensure that results are " @@ -117113,7 +119937,7 @@ msgid "" "outcome of tests." msgstr "" -#: ../src/Doc/library/unittest.rst:1583 +#: library/unittest.rst:1574 msgid "" "Testing frameworks built on top of :mod:`unittest` may want access to the :" "class:`TestResult` object generated by running a set of tests for reporting " @@ -117121,57 +119945,61 @@ msgid "" "`TestRunner.run` method for this purpose." msgstr "" -#: ../src/Doc/library/unittest.rst:1588 +#: library/unittest.rst:1579 msgid "" ":class:`TestResult` instances have the following attributes that will be of " "interest when inspecting the results of running a set of tests:" msgstr "" -#: ../src/Doc/library/unittest.rst:1594 +#: library/unittest.rst:1585 msgid "" "A list containing 2-tuples of :class:`TestCase` instances and strings " "holding formatted tracebacks. Each tuple represents a test which raised an " "unexpected exception." msgstr "" +#: library/unittest.rst:1589 library/unittest.rst:1599 +msgid "Contains formatted tracebacks instead of :func:`sys.exc_info` results." +msgstr "" + # 3d389c63fe6d4825bae344dd43370617 -#: ../src/Doc/library/unittest.rst:1604 +#: library/unittest.rst:1595 msgid "" "A list containing 2-tuples of :class:`TestCase` instances and strings " "holding formatted tracebacks. Each tuple represents a test where a failure " "was explicitly signalled using the :meth:`TestCase.assert\\*` methods." msgstr "" -#: ../src/Doc/library/unittest.rst:1613 +#: library/unittest.rst:1604 msgid "" "A list containing 2-tuples of :class:`TestCase` instances and strings " "holding the reason for skipping the test." msgstr "" # 3a8536cacbfb48a9a7121bebb11988b4 -#: ../src/Doc/library/unittest.rst:1620 +#: library/unittest.rst:1611 msgid "" "A list containing 2-tuples of :class:`TestCase` instances and strings " "holding formatted tracebacks. Each tuple represents an expected failure of " "the test case." msgstr "" -#: ../src/Doc/library/unittest.rst:1626 +#: library/unittest.rst:1617 msgid "" "A list containing :class:`TestCase` instances that were marked as expected " "failures, but succeeded." msgstr "" -#: ../src/Doc/library/unittest.rst:1631 +#: library/unittest.rst:1622 msgid "" "Set to ``True`` when the execution of tests should stop by :meth:`stop`." msgstr "" -#: ../src/Doc/library/unittest.rst:1636 +#: library/unittest.rst:1627 msgid "The total number of tests run so far." msgstr "" -#: ../src/Doc/library/unittest.rst:1641 +#: library/unittest.rst:1632 msgid "" "If set to true, ``sys.stdout`` and ``sys.stderr`` will be buffered in " "between :meth:`startTest` and :meth:`stopTest` being called. Collected " @@ -117180,21 +120008,21 @@ msgid "" "error message." msgstr "" -#: ../src/Doc/library/unittest.rst:1651 +#: library/unittest.rst:1642 msgid "" "If set to true :meth:`stop` will be called on the first failure or error, " "halting the test run." msgstr "" # 0a7a046d3ced4a7da6c821c608c2622c -#: ../src/Doc/library/unittest.rst:1659 +#: library/unittest.rst:1650 msgid "" "Return ``True`` if all tests run so far have passed, otherwise returns " "``False``." msgstr "" # 490035a9ea0f4aa1a50973f026b624ac -#: ../src/Doc/library/unittest.rst:1665 +#: library/unittest.rst:1656 msgid "" "This method can be called to signal that the set of tests being run should " "be aborted by setting the :attr:`shouldStop` attribute to ``True``. :class:" @@ -117202,7 +120030,7 @@ msgid "" "additional tests." msgstr "" -#: ../src/Doc/library/unittest.rst:1670 +#: library/unittest.rst:1661 msgid "" "For example, this feature is used by the :class:`TextTestRunner` class to " "stop the test framework when the user signals an interrupt from the " @@ -117210,7 +120038,7 @@ msgid "" "implementations can use this in a similar manner." msgstr "" -#: ../src/Doc/library/unittest.rst:1675 +#: library/unittest.rst:1666 msgid "" "The following methods of the :class:`TestResult` class are used to maintain " "the internal data structures, and may be extended in subclasses to support " @@ -117218,111 +120046,117 @@ msgid "" "tools which support interactive reporting while tests are being run." msgstr "" -#: ../src/Doc/library/unittest.rst:1683 +#: library/unittest.rst:1674 msgid "Called when the test case *test* is about to be run." msgstr "" -#: ../src/Doc/library/unittest.rst:1687 +#: library/unittest.rst:1678 msgid "" "Called after the test case *test* has been executed, regardless of the " "outcome." msgstr "" -#: ../src/Doc/library/unittest.rst:1692 +#: library/unittest.rst:1683 msgid "Called once before any tests are executed." msgstr "" -#: ../src/Doc/library/unittest.rst:1699 +#: library/unittest.rst:1690 msgid "Called once after all tests are executed." msgstr "" # d041fecf28ce4b9e9a192330492ad138 -#: ../src/Doc/library/unittest.rst:1706 +#: library/unittest.rst:1697 msgid "" "Called when the test case *test* raises an unexpected exception. *err* is a " "tuple of the form returned by :func:`sys.exc_info`: ``(type, value, " "traceback)``." msgstr "" -#: ../src/Doc/library/unittest.rst:1710 +#: library/unittest.rst:1701 msgid "" "The default implementation appends a tuple ``(test, formatted_err)`` to the " "instance's :attr:`errors` attribute, where *formatted_err* is a formatted " "traceback derived from *err*." msgstr "" -#: ../src/Doc/library/unittest.rst:1717 +#: library/unittest.rst:1708 msgid "" "Called when the test case *test* signals a failure. *err* is a tuple of the " "form returned by :func:`sys.exc_info`: ``(type, value, traceback)``." msgstr "" -#: ../src/Doc/library/unittest.rst:1720 +#: library/unittest.rst:1711 msgid "" "The default implementation appends a tuple ``(test, formatted_err)`` to the " "instance's :attr:`failures` attribute, where *formatted_err* is a formatted " "traceback derived from *err*." msgstr "" -#: ../src/Doc/library/unittest.rst:1727 +#: library/unittest.rst:1718 msgid "Called when the test case *test* succeeds." msgstr "" -#: ../src/Doc/library/unittest.rst:1729 +#: library/unittest.rst:1720 msgid "The default implementation does nothing." msgstr "" -#: ../src/Doc/library/unittest.rst:1734 +#: library/unittest.rst:1725 msgid "" "Called when the test case *test* is skipped. *reason* is the reason the " "test gave for skipping." msgstr "" -#: ../src/Doc/library/unittest.rst:1737 +#: library/unittest.rst:1728 msgid "" "The default implementation appends a tuple ``(test, reason)`` to the " "instance's :attr:`skipped` attribute." msgstr "" -#: ../src/Doc/library/unittest.rst:1743 +#: library/unittest.rst:1734 msgid "" "Called when the test case *test* fails, but was marked with the :func:" "`expectedFailure` decorator." msgstr "" -#: ../src/Doc/library/unittest.rst:1746 +#: library/unittest.rst:1737 msgid "" "The default implementation appends a tuple ``(test, formatted_err)`` to the " "instance's :attr:`expectedFailures` attribute, where *formatted_err* is a " "formatted traceback derived from *err*." msgstr "" -#: ../src/Doc/library/unittest.rst:1753 +#: library/unittest.rst:1744 msgid "" "Called when the test case *test* was marked with the :func:`expectedFailure` " "decorator, but succeeded." msgstr "" -#: ../src/Doc/library/unittest.rst:1756 +#: library/unittest.rst:1747 msgid "" "The default implementation appends the test to the instance's :attr:" "`unexpectedSuccesses` attribute." msgstr "" -#: ../src/Doc/library/unittest.rst:1761 +#: library/unittest.rst:1752 msgid "" "A concrete implementation of :class:`TestResult` used by the :class:" "`TextTestRunner`." msgstr "" -#: ../src/Doc/library/unittest.rst:1770 +#: library/unittest.rst:1755 +msgid "" +"This class was previously named ``_TextTestResult``. The old name still " +"exists as an alias but is deprecated." +msgstr "" + +#: library/unittest.rst:1761 msgid "" "Instance of the :class:`TestLoader` class intended to be shared. If no " "customization of the :class:`TestLoader` is needed, this instance can be " "used instead of repeatedly creating new instances." msgstr "" -#: ../src/Doc/library/unittest.rst:1777 +#: library/unittest.rst:1768 msgid "" "A basic test runner implementation which prints results on standard error. " "It has a few configurable parameters, but is essentially very simple. " @@ -117330,14 +120164,14 @@ msgid "" "implementations." msgstr "" -#: ../src/Doc/library/unittest.rst:1783 +#: library/unittest.rst:1774 msgid "" "This method returns the instance of ``TestResult`` used by :meth:`run`. It " "is not intended to be called directly, but can be overridden in subclasses " "to provide a custom ``TestResult``." msgstr "" -#: ../src/Doc/library/unittest.rst:1787 +#: library/unittest.rst:1778 msgid "" "``_makeResult()`` instantiates the class or callable passed in the " "``TextTestRunner`` constructor as the ``resultclass`` argument. It defaults " @@ -117346,7 +120180,7 @@ msgid "" msgstr "" # 994eb38d41944f0891f7fdbe56d41e20 -#: ../src/Doc/library/unittest.rst:1797 +#: library/unittest.rst:1788 msgid "" "A command-line program that loads a set of tests from *module* and runs " "them; this is primarily for making test modules conveniently executable. The " @@ -117354,14 +120188,14 @@ msgid "" "of a test script::" msgstr "" -#: ../src/Doc/library/unittest.rst:1805 +#: library/unittest.rst:1796 msgid "" "You can run tests with more detailed information by passing in the verbosity " "argument::" msgstr "" # b83c6e40c75c4c02b31642503ec5f456 -#: ../src/Doc/library/unittest.rst:1811 +#: library/unittest.rst:1802 msgid "" "The *defaultTest* argument is the name of the test to run if no test names " "are specified via *argv*. If not specified or ``None`` and no test names " @@ -117369,14 +120203,14 @@ msgid "" msgstr "" # 17af1342fca6448baec6d79b79aff53c -#: ../src/Doc/library/unittest.rst:1815 +#: library/unittest.rst:1806 msgid "" "The *argv* argument can be a list of options passed to the program, with the " "first element being the program name. If not specified or ``None``, the " "values of :data:`sys.argv` are used." msgstr "" -#: ../src/Doc/library/unittest.rst:1819 +#: library/unittest.rst:1810 msgid "" "The *testRunner* argument can either be a test runner class or an already " "created instance of it. By default ``main`` calls :func:`sys.exit` with an " @@ -117384,13 +120218,13 @@ msgid "" msgstr "" # a338dd825ecb432ab8f2b00924fc0f66 -#: ../src/Doc/library/unittest.rst:1823 +#: library/unittest.rst:1814 msgid "" "The *testLoader* argument has to be a :class:`TestLoader` instance, and " "defaults to :data:`defaultTestLoader`." msgstr "" -#: ../src/Doc/library/unittest.rst:1826 +#: library/unittest.rst:1817 msgid "" "``main`` supports being used from the interactive interpreter by passing in " "the argument ``exit=False``. This displays the result on standard output " @@ -117398,40 +120232,46 @@ msgid "" msgstr "" # 7cb0778106354b35814888d3221d9f95 -#: ../src/Doc/library/unittest.rst:1833 +#: library/unittest.rst:1824 msgid "" "The *failfast*, *catchbreak* and *buffer* parameters have the same effect as " "the same-name `command-line options`_." msgstr "" -#: ../src/Doc/library/unittest.rst:1836 +#: library/unittest.rst:1827 msgid "" "Calling ``main`` actually returns an instance of the ``TestProgram`` class. " "This stores the result of the tests run as the ``result`` attribute." msgstr "" -#: ../src/Doc/library/unittest.rst:1845 +#: library/unittest.rst:1830 +msgid "" +"The *exit*, *verbosity*, *failfast*, *catchbreak* and *buffer* parameters " +"were added." +msgstr "" + +#: library/unittest.rst:1836 msgid "load_tests Protocol" msgstr "" -#: ../src/Doc/library/unittest.rst:1849 +#: library/unittest.rst:1840 msgid "" "Modules or packages can customize how tests are loaded from them during " "normal test runs or test discovery by implementing a function called " "``load_tests``." msgstr "" -#: ../src/Doc/library/unittest.rst:1852 +#: library/unittest.rst:1843 msgid "" "If a test module defines ``load_tests`` it will be called by :meth:" "`TestLoader.loadTestsFromModule` with the following arguments::" msgstr "" -#: ../src/Doc/library/unittest.rst:1857 +#: library/unittest.rst:1848 msgid "It should return a :class:`TestSuite`." msgstr "" -#: ../src/Doc/library/unittest.rst:1859 +#: library/unittest.rst:1850 msgid "" "*loader* is the instance of :class:`TestLoader` doing the loading. " "*standard_tests* are the tests that would be loaded by default from the " @@ -117440,13 +120280,13 @@ msgid "" "packages as part of test discovery." msgstr "" -#: ../src/Doc/library/unittest.rst:1865 +#: library/unittest.rst:1856 msgid "" "A typical ``load_tests`` function that loads tests from a specific set of :" "class:`TestCase` classes may look like::" msgstr "" -#: ../src/Doc/library/unittest.rst:1877 +#: library/unittest.rst:1868 msgid "" "If discovery is started, either from the command line or by calling :meth:" "`TestLoader.discover`, with a pattern that matches a package name then the " @@ -117454,43 +120294,43 @@ msgid "" msgstr "" # 97a4e46ce9ea4eaca942dfd2322ca2eb -#: ../src/Doc/library/unittest.rst:1883 +#: library/unittest.rst:1874 msgid "" "The default pattern is ``'test*.py'``. This matches all Python files that " "start with ``'test'`` but *won't* match any test directories." msgstr "" # 7c46c0a4b5294bb9b01537443a0535cc -#: ../src/Doc/library/unittest.rst:1886 +#: library/unittest.rst:1877 msgid "A pattern like ``'test*'`` will match test packages as well as modules." msgstr "" -#: ../src/Doc/library/unittest.rst:1889 +#: library/unittest.rst:1880 msgid "" "If the package :file:`__init__.py` defines ``load_tests`` then it will be " "called and discovery not continued into the package. ``load_tests`` is " "called with the following arguments::" msgstr "" -#: ../src/Doc/library/unittest.rst:1895 +#: library/unittest.rst:1886 msgid "" "This should return a :class:`TestSuite` representing all the tests from the " "package. (``standard_tests`` will only contain tests collected from :file:" "`__init__.py`.)" msgstr "" -#: ../src/Doc/library/unittest.rst:1899 +#: library/unittest.rst:1890 msgid "" "Because the pattern is passed into ``load_tests`` the package is free to " "continue (and potentially modify) test discovery. A 'do nothing' " "``load_tests`` function for a test package would look like::" msgstr "" -#: ../src/Doc/library/unittest.rst:1912 +#: library/unittest.rst:1903 msgid "Class and Module Fixtures" msgstr "" -#: ../src/Doc/library/unittest.rst:1914 +#: library/unittest.rst:1905 msgid "" "Class and module level fixtures are implemented in :class:`TestSuite`. When " "the test suite encounters a test from a new class then :meth:`tearDownClass` " @@ -117498,27 +120338,27 @@ msgid "" "`setUpClass` from the new class." msgstr "" -#: ../src/Doc/library/unittest.rst:1919 +#: library/unittest.rst:1910 msgid "" "Similarly if a test is from a different module from the previous test then " "``tearDownModule`` from the previous module is run, followed by " "``setUpModule`` from the new module." msgstr "" -#: ../src/Doc/library/unittest.rst:1923 +#: library/unittest.rst:1914 msgid "" "After all the tests have run the final ``tearDownClass`` and " "``tearDownModule`` are run." msgstr "" -#: ../src/Doc/library/unittest.rst:1926 +#: library/unittest.rst:1917 msgid "" "Note that shared fixtures do not play well with [potential] features like " "test parallelization and they break test isolation. They should be used with " "care." msgstr "" -#: ../src/Doc/library/unittest.rst:1929 +#: library/unittest.rst:1920 msgid "" "The default ordering of tests created by the unittest test loaders is to " "group all tests from the same modules and classes together. This will lead " @@ -117528,14 +120368,14 @@ msgid "" "functions may be called multiple times in a single test run." msgstr "" -#: ../src/Doc/library/unittest.rst:1936 +#: library/unittest.rst:1927 msgid "" "Shared fixtures are not intended to work with suites with non-standard " "ordering. A ``BaseTestSuite`` still exists for frameworks that don't want to " "support shared fixtures." msgstr "" -#: ../src/Doc/library/unittest.rst:1940 +#: library/unittest.rst:1931 msgid "" "If there are any exceptions raised during one of the shared fixture " "functions the test is reported as an error. Because there is no " @@ -117545,15 +120385,15 @@ msgid "" "matter, but if you are a framework author it may be relevant." msgstr "" -#: ../src/Doc/library/unittest.rst:1949 +#: library/unittest.rst:1940 msgid "setUpClass and tearDownClass" msgstr "" -#: ../src/Doc/library/unittest.rst:1951 +#: library/unittest.rst:1942 msgid "These must be implemented as class methods::" msgstr "" -#: ../src/Doc/library/unittest.rst:1964 +#: library/unittest.rst:1955 msgid "" "If you want the ``setUpClass`` and ``tearDownClass`` on base classes called " "then you must call up to them yourself. The implementations in :class:" @@ -117561,7 +120401,7 @@ msgid "" msgstr "" # d15fd582f43046e48f3c046ec036a1f5 -#: ../src/Doc/library/unittest.rst:1968 +#: library/unittest.rst:1959 msgid "" "If an exception is raised during a ``setUpClass`` then the tests in the " "class are not run and the ``tearDownClass`` is not run. Skipped classes will " @@ -117570,16 +120410,16 @@ msgid "" "instead of as an error." msgstr "" -#: ../src/Doc/library/unittest.rst:1976 +#: library/unittest.rst:1967 msgid "setUpModule and tearDownModule" msgstr "" -#: ../src/Doc/library/unittest.rst:1978 +#: library/unittest.rst:1969 msgid "These should be implemented as functions::" msgstr "" # 4a2d09cf1a2749e58ce714829568c8e5 -#: ../src/Doc/library/unittest.rst:1986 +#: library/unittest.rst:1977 msgid "" "If an exception is raised in a ``setUpModule`` then none of the tests in the " "module will be run and the ``tearDownModule`` will not be run. If the " @@ -117587,12 +120427,12 @@ msgid "" "having been skipped instead of as an error." msgstr "" -#: ../src/Doc/library/unittest.rst:1993 +#: library/unittest.rst:1984 msgid "Signal Handling" msgstr "" # 9526b79b244c42c7821a971b96dfc588 -#: ../src/Doc/library/unittest.rst:1995 +#: library/unittest.rst:1986 msgid "" "The :option:`-c/--catch <unittest -c>` command-line option to unittest, " "along with the ``catchbreak`` parameter to :func:`unittest.main()`, provide " @@ -117602,7 +120442,7 @@ msgid "" "A second control-c will raise a :exc:`KeyboardInterrupt` in the usual way." msgstr "" -#: ../src/Doc/library/unittest.rst:2002 +#: library/unittest.rst:1993 msgid "" "The control-c handling signal handler attempts to remain compatible with " "code or tests that install their own :const:`signal.SIGINT` handler. If the " @@ -117614,52 +120454,52 @@ msgid "" "disabled the :func:`removeHandler` decorator can be used." msgstr "" -#: ../src/Doc/library/unittest.rst:2011 +#: library/unittest.rst:2002 msgid "" "There are a few utility functions for framework authors to enable control-c " "handling functionality within test frameworks." msgstr "" -#: ../src/Doc/library/unittest.rst:2016 +#: library/unittest.rst:2007 msgid "" "Install the control-c handler. When a :const:`signal.SIGINT` is received " "(usually in response to the user pressing control-c) all registered results " "have :meth:`~TestResult.stop` called." msgstr "" -#: ../src/Doc/library/unittest.rst:2024 +#: library/unittest.rst:2015 msgid "" "Register a :class:`TestResult` object for control-c handling. Registering a " "result stores a weak reference to it, so it doesn't prevent the result from " "being garbage collected." msgstr "" -#: ../src/Doc/library/unittest.rst:2028 +#: library/unittest.rst:2019 msgid "" "Registering a :class:`TestResult` object has no side-effects if control-c " "handling is not enabled, so test frameworks can unconditionally register all " "results they create independently of whether or not handling is enabled." msgstr "" -#: ../src/Doc/library/unittest.rst:2036 +#: library/unittest.rst:2027 msgid "" "Remove a registered result. Once a result has been removed then :meth:" "`~TestResult.stop` will no longer be called on that result object in " "response to a control-c." msgstr "" -#: ../src/Doc/library/unittest.rst:2044 +#: library/unittest.rst:2035 msgid "" "When called without arguments this function removes the control-c handler if " "it has been installed. This function can also be used as a test decorator to " "temporarily remove the handler whilst the test is being executed::" msgstr "" -#: ../src/Doc/library/unix.rst:6 +#: library/unix.rst:6 msgid "Unix Specific Services" msgstr "" -#: ../src/Doc/library/unix.rst:8 +#: library/unix.rst:8 msgid "" "The modules described in this chapter provide interfaces to features that " "are unique to the Unix operating system, or in some cases to some or many " @@ -117667,12 +120507,12 @@ msgid "" msgstr "" # 09f31eb1224b4d2a9a66ab5c1949e78a -#: ../src/Doc/library/urllib.rst:2 +#: library/urllib.rst:2 msgid ":mod:`urllib` --- Open arbitrary resources by URL" msgstr "" # dac0ba69f70044efbdb86a5c98726e69 -#: ../src/Doc/library/urllib.rst:8 +#: library/urllib.rst:8 msgid "" "The :mod:`urllib` module has been split into parts and renamed in Python 3 " "to :mod:`urllib.request`, :mod:`urllib.parse`, and :mod:`urllib.error`. The :" @@ -117683,7 +120523,7 @@ msgid "" msgstr "" # 00c823611e0d4775b29efb4201bd1214 -#: ../src/Doc/library/urllib.rst:21 +#: library/urllib.rst:21 msgid "" "This module provides a high-level interface for fetching data across the " "World Wide Web. In particular, the :func:`urlopen` function is similar to " @@ -117693,19 +120533,19 @@ msgid "" msgstr "" # d1ff2c8bcb16410083d894ba681bde34 -#: ../src/Doc/library/urllib.rst:27 +#: library/urllib.rst:32 msgid "" "When opening HTTPS URLs, it does not attempt to validate the server " "certificate. Use at your own risk!" msgstr "" # fa9f4b5dc6014be4ae82fa128c3395dc -#: ../src/Doc/library/urllib.rst:32 +#: library/urllib.rst:37 msgid "High-level interface" msgstr "" # 2c56e21ce4a44bc7822595e0928333b8 -#: ../src/Doc/library/urllib.rst:36 +#: library/urllib.rst:41 msgid "" "Open a network object denoted by a URL for reading. If the URL does not " "have a scheme identifier, or if it has :file:`file:` as its scheme " @@ -117722,7 +120562,7 @@ msgid "" msgstr "" # 9e34480eebe143369609425329e4cc8e -#: ../src/Doc/library/urllib.rst:49 +#: library/urllib.rst:54 msgid "" "Except for the :meth:`info`, :meth:`getcode` and :meth:`geturl` methods, " "these methods have the same interface as for file objects --- see section :" @@ -117732,7 +120572,7 @@ msgid "" msgstr "" # c2f9d76e7f3d48d4b6f38b6786cdc3f9 -#: ../src/Doc/library/urllib.rst:57 +#: library/urllib.rst:62 msgid "" "The :meth:`info` method returns an instance of the class :class:`mimetools." "Message` containing meta-information associated with the URL. When the " @@ -117748,7 +120588,7 @@ msgid "" msgstr "" # e4a7a5e3d6ec4edaba506e2be948221d -#: ../src/Doc/library/urllib.rst:69 +#: library/urllib.rst:74 msgid "" "The :meth:`geturl` method returns the real URL of the page. In some cases, " "the HTTP server redirects a client to another URL. The :func:`urlopen` " @@ -117758,14 +120598,14 @@ msgid "" msgstr "" # 42cb066f43ae4993b824055e34f77a75 -#: ../src/Doc/library/urllib.rst:75 +#: library/urllib.rst:80 msgid "" "The :meth:`getcode` method returns the HTTP status code that was sent with " "the response, or ``None`` if the URL is no HTTP URL." msgstr "" # d3f21bc102484068ab2cf5d9cd63c994 -#: ../src/Doc/library/urllib.rst:78 +#: library/urllib.rst:83 msgid "" "If the *url* uses the :file:`http:` scheme identifier, the optional *data* " "argument may be given to specify a ``POST`` request (normally the request " @@ -117775,7 +120615,7 @@ msgid "" msgstr "" # 0b760a9560514441ad3430b6619bd97b -#: ../src/Doc/library/urllib.rst:84 +#: library/urllib.rst:89 msgid "" "The :func:`urlopen` function works transparently with proxies which do not " "require authentication. In a Unix or Windows environment, set the :envvar:" @@ -117785,7 +120625,7 @@ msgid "" msgstr "" # 51dda184cca547fbb27d9861379e2df1 -#: ../src/Doc/library/urllib.rst:95 +#: library/urllib.rst:100 msgid "" "The :envvar:`no_proxy` environment variable can be used to specify hosts " "which shouldn't be reached via proxy; if set, it should be a comma-separated " @@ -117794,14 +120634,14 @@ msgid "" msgstr "" # 2eed950693a94543b430665df9dedc30 -#: ../src/Doc/library/urllib.rst:100 +#: library/urllib.rst:105 msgid "" "In a Windows environment, if no proxy environment variables are set, proxy " "settings are obtained from the registry's Internet Settings section." msgstr "" # 95c3c1489b7d495f9a141981519f81be -#: ../src/Doc/library/urllib.rst:105 +#: library/urllib.rst:110 msgid "" "In a Mac OS X environment, :func:`urlopen` will retrieve proxy information " "from the OS X System Configuration Framework, which can be managed with " @@ -117809,7 +120649,7 @@ msgid "" msgstr "" # cf7d0353ce4048e1af0c17f612f40e03 -#: ../src/Doc/library/urllib.rst:110 +#: library/urllib.rst:115 msgid "" "Alternatively, the optional *proxies* argument may be used to explicitly " "specify proxies. It must be a dictionary mapping scheme names to proxy " @@ -117819,13 +120659,36 @@ msgid "" msgstr "" # bd0d5322727f44fb980c65bb01f856ea -#: ../src/Doc/library/urllib.rst:125 +#: library/urllib.rst:130 msgid "" "Proxies which require authentication for use are not currently supported; " "this is considered an implementation limitation." msgstr "" -#: ../src/Doc/library/urllib.rst:142 +#: library/urllib.rst:133 +msgid "" +"The *context* parameter may be set to a :class:`ssl.SSLContext` instance to " +"configure the SSL settings that are used if :func:`urlopen` makes a HTTPS " +"connection." +msgstr "" + +#: library/urllib.rst:137 +msgid "Added the *proxies* support." +msgstr "" + +#: library/urllib.rst:140 +msgid "" +"Added :meth:`getcode` to returned object and support for the :envvar:" +"`no_proxy` environment variable." +msgstr "" + +#: library/urllib.rst:147 +msgid "" +"The :func:`urlopen` function has been removed in Python 3 in favor of :func:" +"`urllib2.urlopen`." +msgstr "" + +#: library/urllib.rst:154 msgid "" "Copy a network object denoted by a URL to a local file, if necessary. If the " "URL points to a local file, or a valid cached copy of the object exists, the " @@ -117836,7 +120699,7 @@ msgid "" "are the same as for :func:`urlopen`." msgstr "" -#: ../src/Doc/library/urllib.rst:150 +#: library/urllib.rst:162 msgid "" "The second argument, if present, specifies the file location to copy to (if " "absent, the location will be a tempfile with a generated name). The third " @@ -117848,7 +120711,7 @@ msgid "" "file size in response to a retrieval request." msgstr "" -#: ../src/Doc/library/urllib.rst:159 ../src/Doc/library/urllib.rst:348 +#: library/urllib.rst:171 library/urllib.rst:363 msgid "" "If the *url* uses the :file:`http:` scheme identifier, the optional *data* " "argument may be given to specify a ``POST`` request (normally the request " @@ -117857,22 +120720,30 @@ msgid "" "function below." msgstr "" +#: library/urllib.rst:177 +msgid "" +":func:`urlretrieve` will raise :exc:`ContentTooShortError` when it detects " +"that the amount of data available was less than the expected amount (which " +"is the size reported by a *Content-Length* header). This can occur, for " +"example, when the download is interrupted." +msgstr "" + # 773ff3a29ac94995b87e0e31e44eb5cf -#: ../src/Doc/library/urllib.rst:171 +#: library/urllib.rst:183 msgid "" "The *Content-Length* is treated as a lower bound: if there's more data to " "read, :func:`urlretrieve` reads more data, but if less data is available, " "it raises the exception." msgstr "" -#: ../src/Doc/library/urllib.rst:175 +#: library/urllib.rst:187 msgid "" "You can still retrieve the downloaded data in this case, it is stored in " "the :attr:`content` attribute of the exception instance." msgstr "" # bd7bc49751324b93badb7ffeebc39595 -#: ../src/Doc/library/urllib.rst:178 +#: library/urllib.rst:190 msgid "" "If no *Content-Length* header was supplied, :func:`urlretrieve` can not " "check the size of the data it has downloaded, and just returns it. In this " @@ -117880,7 +120751,7 @@ msgid "" msgstr "" # 0886e7762b6d4debb1e430c7eeeb2436 -#: ../src/Doc/library/urllib.rst:185 +#: library/urllib.rst:197 msgid "" "The public functions :func:`urlopen` and :func:`urlretrieve` create an " "instance of the :class:`FancyURLopener` class and use it to perform their " @@ -117892,14 +120763,14 @@ msgid "" "This can be accomplished with the following code::" msgstr "" -#: ../src/Doc/library/urllib.rst:204 +#: library/urllib.rst:216 msgid "" "Clear the cache that may have been built up by previous calls to :func:" "`urlretrieve`." msgstr "" # 0cb3f7add2af48cdbea78f98985ed241 -#: ../src/Doc/library/urllib.rst:213 +#: library/urllib.rst:225 msgid "" "Replace special characters in *string* using the ``%xx`` escape. Letters, " "digits, and the characters ``'_.-'`` are never quoted. By default, this " @@ -117909,12 +120780,12 @@ msgid "" msgstr "" # e83391d123744564a4fadf93a4b482ff -#: ../src/Doc/library/urllib.rst:219 +#: library/urllib.rst:231 msgid "Example: ``quote('/~connolly/')`` yields ``'/%7econnolly/'``." msgstr "" # 20c98ef7222c418a985ed4a1f257511e -#: ../src/Doc/library/urllib.rst:224 +#: library/urllib.rst:236 msgid "" "Like :func:`quote`, but also replaces spaces by plus signs, as required for " "quoting HTML form values when building up a query string to go into a URL. " @@ -117923,24 +120794,24 @@ msgid "" msgstr "" # 3dd9b62d38a647c689ff4d3b6f579f51 -#: ../src/Doc/library/urllib.rst:232 +#: library/urllib.rst:244 msgid "Replace ``%xx`` escapes by their single-character equivalent." msgstr "" # 1b1e5e2b5bb642eeb7a81d89f0719cef -#: ../src/Doc/library/urllib.rst:234 +#: library/urllib.rst:246 msgid "Example: ``unquote('/%7Econnolly/')`` yields ``'/~connolly/'``." msgstr "" # ce10bd9801d94b06a00f6f3658594bb2 -#: ../src/Doc/library/urllib.rst:239 +#: library/urllib.rst:251 msgid "" "Like :func:`unquote`, but also replaces plus signs by spaces, as required " "for unquoting HTML form values." msgstr "" # 292dff703f0e41bb95109c439069503f -#: ../src/Doc/library/urllib.rst:245 +#: library/urllib.rst:257 msgid "" "Convert a mapping object or a sequence of two-element tuples to a \"percent-" "encoded\" string, suitable to pass to :func:`urlopen` above as the optional " @@ -117959,7 +120830,7 @@ msgid "" "structures." msgstr "" -#: ../src/Doc/library/urllib.rst:264 +#: library/urllib.rst:276 msgid "" "Convert the pathname *path* from the local syntax for a path to the form " "used in the path component of a URL. This does not produce a complete URL. " @@ -117967,7 +120838,7 @@ msgid "" msgstr "" # af035b181d3845cc9eddd94e352c29bd -#: ../src/Doc/library/urllib.rst:271 +#: library/urllib.rst:283 msgid "" "Convert the path component *path* from an percent-encoded URL to the local " "syntax for a path. This does not accept a complete URL. This function " @@ -117975,7 +120846,7 @@ msgid "" msgstr "" # f6757377aa31439c85f18bfb397e3f87 -#: ../src/Doc/library/urllib.rst:278 +#: library/urllib.rst:290 msgid "" "This helper function returns a dictionary of scheme to proxy server URL " "mappings. It scans the environment for variables named ``<scheme>_proxy``, " @@ -117984,28 +120855,28 @@ msgid "" "Mac OS X and Windows Systems Registry for Windows." msgstr "" -# 43aa94197ee14e7fab88356f4b03f002 -#: ../src/Doc/library/urllib.rst:285 +#: library/urllib.rst:297 msgid "" "urllib also exposes certain utility functions like splittype, splithost and " "others parsing url into various components. But it is recommended to use :" -"mod:`urlparse` for parsing urls than using these functions directly. Python " -"3 does not expose these helper functions from :mod:`urllib.parse` module." +"mod:`urlparse` for parsing urls rather than using these functions directly. " +"Python 3 does not expose these helper functions from :mod:`urllib.parse` " +"module." msgstr "" # 4d7be107591e450f8b1073fc3e95a891 -#: ../src/Doc/library/urllib.rst:293 +#: library/urllib.rst:305 msgid "URL Opener objects" msgstr "" -#: ../src/Doc/library/urllib.rst:297 +#: library/urllib.rst:309 msgid "" "Base class for opening and reading URLs. Unless you need to support opening " "objects using schemes other than :file:`http:`, :file:`ftp:`, or :file:`file:" "`, you probably want to use :class:`FancyURLopener`." msgstr "" -#: ../src/Doc/library/urllib.rst:301 +#: library/urllib.rst:313 msgid "" "By default, the :class:`URLopener` class sends a :mailheader:`User-Agent` " "header of ``urllib/VVV``, where *VVV* is the :mod:`urllib` version number. " @@ -118015,7 +120886,7 @@ msgid "" "subclass definition." msgstr "" -#: ../src/Doc/library/urllib.rst:307 +#: library/urllib.rst:319 msgid "" "The optional *proxies* parameter should be a dictionary mapping scheme names " "to proxy URLs, where an empty dictionary turns proxies off completely. Its " @@ -118023,7 +120894,13 @@ msgid "" "be used if present, as discussed in the definition of :func:`urlopen`, above." msgstr "" -#: ../src/Doc/library/urllib.rst:312 +#: library/urllib.rst:324 +msgid "" +"The *context* parameter may be a :class:`ssl.SSLContext` instance. If " +"given, it defines the SSL settings the opener uses to make HTTPS connections." +msgstr "" + +#: library/urllib.rst:327 msgid "" "Additional keyword parameters, collected in *x509*, may be used for " "authentication of the client when using the :file:`https:` scheme. The " @@ -118031,13 +120908,13 @@ msgid "" "certificate; both are needed to support client authentication." msgstr "" -#: ../src/Doc/library/urllib.rst:317 +#: library/urllib.rst:332 msgid "" ":class:`URLopener` objects will raise an :exc:`IOError` exception if the " "server returns an error code." msgstr "" -#: ../src/Doc/library/urllib.rst:322 +#: library/urllib.rst:337 msgid "" "Open *fullurl* using the appropriate protocol. This method sets up cache " "and proxy information, then calls the appropriate open method with its input " @@ -118046,12 +120923,12 @@ msgid "" "`urlopen`." msgstr "" -#: ../src/Doc/library/urllib.rst:331 +#: library/urllib.rst:346 msgid "Overridable interface to open unknown URL types." msgstr "" # 7bf9b0bc44fa454a89b75f38c3d982c6 -#: ../src/Doc/library/urllib.rst:336 +#: library/urllib.rst:351 msgid "" "Retrieves the contents of *url* and places it in *filename*. The return " "value is a tuple consisting of a local filename and either a :class:" @@ -118066,7 +120943,7 @@ msgid "" "read from the network. *reporthook* is ignored for local URLs." msgstr "" -#: ../src/Doc/library/urllib.rst:357 +#: library/urllib.rst:372 msgid "" "Variable that specifies the user agent of the opener object. To get :mod:" "`urllib` to tell servers that it is a particular user agent, set this in a " @@ -118074,7 +120951,7 @@ msgid "" "constructor." msgstr "" -#: ../src/Doc/library/urllib.rst:365 +#: library/urllib.rst:380 msgid "" ":class:`FancyURLopener` subclasses :class:`URLopener` providing default " "handling for the following HTTP response codes: 301, 302, 303, 307 and 401. " @@ -118085,14 +120962,14 @@ msgid "" "defaults to 10." msgstr "" -#: ../src/Doc/library/urllib.rst:372 +#: library/urllib.rst:387 msgid "" "For all other response codes, the method :meth:`http_error_default` is " "called which you can override in subclasses to handle the error " "appropriately." msgstr "" -#: ../src/Doc/library/urllib.rst:377 +#: library/urllib.rst:392 msgid "" "According to the letter of :rfc:`2616`, 301 and 302 responses to POST " "requests must not be automatically redirected without confirmation by the " @@ -118101,13 +120978,13 @@ msgid "" "behaviour." msgstr "" -#: ../src/Doc/library/urllib.rst:382 +#: library/urllib.rst:397 msgid "" "The parameters to the constructor are the same as those for :class:" "`URLopener`." msgstr "" -#: ../src/Doc/library/urllib.rst:386 +#: library/urllib.rst:401 msgid "" "When performing basic authentication, a :class:`FancyURLopener` instance " "calls its :meth:`prompt_user_passwd` method. The default implementation " @@ -118116,20 +120993,20 @@ msgid "" "needed." msgstr "" -#: ../src/Doc/library/urllib.rst:391 +#: library/urllib.rst:406 msgid "" "The :class:`FancyURLopener` class offers one additional method that should " "be overloaded to provide the appropriate behavior:" msgstr "" -#: ../src/Doc/library/urllib.rst:396 +#: library/urllib.rst:411 msgid "" "Return information needed to authenticate the user at the given host in the " "specified security realm. The return value should be a tuple, ``(user, " "password)``, which can be used for basic authentication." msgstr "" -#: ../src/Doc/library/urllib.rst:400 +#: library/urllib.rst:415 msgid "" "The implementation prompts for this information on the terminal; an " "application should override this method to use an appropriate interaction " @@ -118137,7 +121014,7 @@ msgid "" msgstr "" # b0b4ade1c7224d87b89f597358913fd8 -#: ../src/Doc/library/urllib.rst:406 +#: library/urllib.rst:421 msgid "" "This exception is raised when the :func:`urlretrieve` function detects that " "the amount of the downloaded data is less than the expected amount (given " @@ -118146,35 +121023,35 @@ msgid "" msgstr "" # 112b50ca2d3747ab83bbb848bee0ec06 -#: ../src/Doc/library/urllib.rst:415 +#: library/urllib.rst:430 msgid ":mod:`urllib` Restrictions" msgstr "" -#: ../src/Doc/library/urllib.rst:421 +#: library/urllib.rst:436 msgid "" "Currently, only the following protocols are supported: HTTP, (versions 0.9 " "and 1.0), FTP, and local files." msgstr "" -#: ../src/Doc/library/urllib.rst:424 +#: library/urllib.rst:439 msgid "" "The caching feature of :func:`urlretrieve` has been disabled until I find " "the time to hack proper processing of Expiration time headers." msgstr "" -#: ../src/Doc/library/urllib.rst:427 +#: library/urllib.rst:442 msgid "" "There should be a function to query whether a particular URL is in the cache." msgstr "" -#: ../src/Doc/library/urllib.rst:429 +#: library/urllib.rst:444 msgid "" "For backward compatibility, if a URL appears to point to a local file but " "the file can't be opened, the URL is re-interpreted using the FTP protocol. " "This can sometimes cause confusing error messages." msgstr "" -#: ../src/Doc/library/urllib.rst:433 +#: library/urllib.rst:448 msgid "" "The :func:`urlopen` and :func:`urlretrieve` functions can cause arbitrarily " "long delays while waiting for a network connection to be set up. This means " @@ -118183,7 +121060,7 @@ msgid "" msgstr "" # d097877ce04345f490cce6bc47676a68 -#: ../src/Doc/library/urllib.rst:443 +#: library/urllib.rst:458 msgid "" "The data returned by :func:`urlopen` or :func:`urlretrieve` is the raw data " "returned by the server. This may be binary data (such as an image), plain " @@ -118194,7 +121071,7 @@ msgid "" msgstr "" # 06b5855a46714aabbcfe0bd9a7266a37 -#: ../src/Doc/library/urllib.rst:452 +#: library/urllib.rst:467 msgid "" "The code handling the FTP protocol cannot differentiate between a file and a " "directory. This can lead to unexpected behavior when attempting to read a " @@ -118213,49 +121090,49 @@ msgid "" msgstr "" # b1d0eb38d47546d3bff533933df037a7 -#: ../src/Doc/library/urllib.rst:466 +#: library/urllib.rst:481 msgid "" "This module does not support the use of proxies which require " "authentication. This may be implemented in the future." msgstr "" # e71a0021e5474662be0f35b48df469b6 -#: ../src/Doc/library/urllib.rst:471 +#: library/urllib.rst:486 msgid "" "Although the :mod:`urllib` module contains (undocumented) routines to parse " "and unparse URL strings, the recommended interface for URL manipulation is " "in module :mod:`urlparse`." msgstr "" -#: ../src/Doc/library/urllib.rst:481 +#: library/urllib.rst:496 msgid "" "Here is an example session that uses the ``GET`` method to retrieve a URL " "containing parameters::" msgstr "" -#: ../src/Doc/library/urllib.rst:489 +#: library/urllib.rst:504 msgid "The following example uses the ``POST`` method instead::" msgstr "" -#: ../src/Doc/library/urllib.rst:496 +#: library/urllib.rst:511 msgid "" "The following example uses an explicitly specified HTTP proxy, overriding " "environment settings::" msgstr "" -#: ../src/Doc/library/urllib.rst:505 +#: library/urllib.rst:520 msgid "" "The following example uses no proxies at all, overriding environment " "settings::" msgstr "" # 643901ad69924b93866bfd4328959477 -#: ../src/Doc/library/urllib2.rst:2 +#: library/urllib2.rst:2 msgid ":mod:`urllib2` --- extensible library for opening URLs" msgstr "" # 53786894bbb443189cc0621e851aea05 -#: ../src/Doc/library/urllib2.rst:11 +#: library/urllib2.rst:11 msgid "" "The :mod:`urllib2` module has been split across several modules in Python 3 " "named :mod:`urllib.request` and :mod:`urllib.error`. The :term:`2to3` tool " @@ -118263,7 +121140,7 @@ msgid "" msgstr "" # 76c3e70160d64a5d801404001db3b9dc -#: ../src/Doc/library/urllib2.rst:17 +#: library/urllib2.rst:17 msgid "" "The :mod:`urllib2` module defines functions and classes which help in " "opening URLs (mostly HTTP) in a complex world --- basic and digest " @@ -118271,23 +121148,18 @@ msgid "" msgstr "" # 83fa29870c3944dcbd0dffbbd1090bae -#: ../src/Doc/library/urllib2.rst:22 +#: library/urllib2.rst:27 msgid "The :mod:`urllib2` module defines the following functions:" msgstr "" -#: ../src/Doc/library/urllib2.rst:27 +#: library/urllib2.rst:32 msgid "" "Open the URL *url*, which can be either a string or a :class:`Request` " "object." msgstr "" -# 2aa4ca4ed295467faef8071b788ac4fd -#: ../src/Doc/library/urllib2.rst:30 -msgid "HTTPS requests do not do any verification of the server's certificate." -msgstr "" - # 40444d1cd9064dc6b4d866888e49207a -#: ../src/Doc/library/urllib2.rst:32 +#: library/urllib2.rst:34 msgid "" "*data* may be a string specifying additional data to send to the server, or " "``None`` if no such data is needed. Currently HTTP requests are the only " @@ -118300,7 +121172,7 @@ msgid "" msgstr "" # 6d69a0fe125d4e9d8828c64d8d2e63fc -#: ../src/Doc/library/urllib2.rst:41 +#: library/urllib2.rst:43 msgid "" "The optional *timeout* parameter specifies a timeout in seconds for blocking " "operations like the connection attempt (if not specified, the global default " @@ -118308,19 +121180,39 @@ msgid "" "FTP connections." msgstr "" +#: library/urllib2.rst:48 +msgid "" +"If *context* is specified, it must be a :class:`ssl.SSLContext` instance " +"describing the various SSL options. See :class:`~httplib.HTTPSConnection` " +"for more details." +msgstr "" + +#: library/urllib2.rst:52 +msgid "" +"The optional *cafile* and *capath* parameters specify a set of trusted CA " +"certificates for HTTPS requests. *cafile* should point to a single file " +"containing a bundle of CA certificates, whereas *capath* should point to a " +"directory of hashed certificate files. More information can be found in :" +"meth:`ssl.SSLContext.load_verify_locations`." +msgstr "" + +#: library/urllib2.rst:58 +msgid "The *cadefault* parameter is ignored." +msgstr "" + # 5d4b3aeb80f9438c9bcc99f2216879f5 -#: ../src/Doc/library/urllib2.rst:46 +#: library/urllib2.rst:60 msgid "This function returns a file-like object with three additional methods:" msgstr "" -#: ../src/Doc/library/urllib2.rst:48 +#: library/urllib2.rst:62 msgid "" ":meth:`geturl` --- return the URL of the resource retrieved, commonly used " "to determine if a redirect was followed" msgstr "" # 77861982cd294aba96c59a6b4cda5e75 -#: ../src/Doc/library/urllib2.rst:51 +#: library/urllib2.rst:65 msgid "" ":meth:`info` --- return the meta-information of the page, such as headers, " "in the form of an :class:`mimetools.Message` instance (see `Quick Reference " @@ -118328,15 +121220,15 @@ msgid "" msgstr "" # f3a62b7c440746199f917d4711660b11 -#: ../src/Doc/library/urllib2.rst:55 +#: library/urllib2.rst:69 msgid ":meth:`getcode` --- return the HTTP status code of the response." msgstr "" -#: ../src/Doc/library/urllib2.rst:57 +#: library/urllib2.rst:71 msgid "Raises :exc:`URLError` on errors." msgstr "" -#: ../src/Doc/library/urllib2.rst:59 +#: library/urllib2.rst:73 msgid "" "Note that ``None`` may be returned if no handler handles the request (though " "the default installed global :class:`OpenerDirector` uses :class:" @@ -118344,7 +121236,7 @@ msgid "" msgstr "" # 2631b0a50a1b43498287c414825d6d82 -#: ../src/Doc/library/urllib2.rst:63 +#: library/urllib2.rst:77 msgid "" "In addition, if proxy settings are detected (for example, when a ``*_proxy`` " "environment variable like :envvar:`http_proxy` is set), :class:" @@ -118352,7 +121244,11 @@ msgid "" "through the proxy." msgstr "" -#: ../src/Doc/library/urllib2.rst:74 +#: library/urllib2.rst:85 +msgid "*cafile*, *capath*, *cadefault*, and *context* were added." +msgstr "" + +#: library/urllib2.rst:91 msgid "" "Install an :class:`OpenerDirector` instance as the default global opener. " "Installing an opener is only necessary if you want urlopen to use that " @@ -118362,7 +121258,7 @@ msgid "" msgstr "" # dfbdc5a3dbfc4c5087d4a8ec64177b66 -#: ../src/Doc/library/urllib2.rst:83 +#: library/urllib2.rst:100 msgid "" "Return an :class:`OpenerDirector` instance, which chains the handlers in the " "order given. *handler*\\s can be either instances of :class:`BaseHandler`, " @@ -118376,34 +121272,34 @@ msgid "" "`HTTPErrorProcessor`." msgstr "" -#: ../src/Doc/library/urllib2.rst:94 +#: library/urllib2.rst:111 msgid "" "If the Python installation has SSL support (i.e., if the :mod:`ssl` module " "can be imported), :class:`HTTPSHandler` will also be added." msgstr "" # d80cb926aa3c46daa0d3115acd5a9a51 -#: ../src/Doc/library/urllib2.rst:97 +#: library/urllib2.rst:114 msgid "" "Beginning in Python 2.3, a :class:`BaseHandler` subclass may also change " "its :attr:`handler_order` attribute to modify its position in the handlers " "list." msgstr "" -#: ../src/Doc/library/urllib2.rst:106 +#: library/urllib2.rst:123 msgid "" "The handlers raise this exception (or derived exceptions) when they run into " "a problem. It is a subclass of :exc:`IOError`." msgstr "" -#: ../src/Doc/library/urllib2.rst:111 +#: library/urllib2.rst:128 msgid "" "The reason for this error. It can be a message string or another exception " "instance (:exc:`socket.error` for remote URLs, :exc:`OSError` for local " "URLs)." msgstr "" -#: ../src/Doc/library/urllib2.rst:118 +#: library/urllib2.rst:135 msgid "" "Though being an exception (a subclass of :exc:`URLError`), an :exc:" "`HTTPError` can also function as a non-exceptional file-like return value " @@ -118412,7 +121308,7 @@ msgid "" msgstr "" # 578079a145c54033a2abd3bff9e46209 -#: ../src/Doc/library/urllib2.rst:125 +#: library/urllib2.rst:142 msgid "" "An HTTP status code as defined in `RFC 2616 <http://www.faqs.org/rfcs/" "rfc2616.html>`_. This numeric value corresponds to a value found in the " @@ -118421,22 +121317,22 @@ msgid "" msgstr "" # f8dfeacbf7e5463b8e25d64c4865dc06 -#: ../src/Doc/library/urllib2.rst:131 +#: library/urllib2.rst:148 msgid "" "The reason for this error. It can be a message string or another exception " "instance." msgstr "" -#: ../src/Doc/library/urllib2.rst:139 +#: library/urllib2.rst:156 msgid "This class is an abstraction of a URL request." msgstr "" -#: ../src/Doc/library/urllib2.rst:141 +#: library/urllib2.rst:158 msgid "*url* should be a string containing a valid URL." msgstr "" # a6b22dd51d504c7eab8466820ca4c8ee -#: ../src/Doc/library/urllib2.rst:143 +#: library/urllib2.rst:160 msgid "" "*data* may be a string specifying additional data to send to the server, or " "``None`` if no such data is needed. Currently HTTP requests are the only " @@ -118448,7 +121344,7 @@ msgid "" msgstr "" # 49f037a835514cbda77e199928f4b75d -#: ../src/Doc/library/urllib2.rst:151 +#: library/urllib2.rst:168 msgid "" "*headers* should be a dictionary, and will be treated as if :meth:" "`add_header` was called with each key and value as arguments. This is often " @@ -118460,14 +121356,14 @@ msgid "" "\"Python-urllib/2.6\"`` (on Python 2.6)." msgstr "" -#: ../src/Doc/library/urllib2.rst:159 +#: library/urllib2.rst:176 msgid "" "The final two arguments are only of interest for correct handling of third-" "party HTTP cookies:" msgstr "" # b841f0ad857b4daf8f0559dd1f2ea5aa -#: ../src/Doc/library/urllib2.rst:162 +#: library/urllib2.rst:179 msgid "" "*origin_req_host* should be the request-host of the origin transaction, as " "defined by :rfc:`2965`. It defaults to ``cookielib.request_host(self)``. " @@ -118478,7 +121374,7 @@ msgid "" msgstr "" # 684ec9c7922b49648c3c60f303dbcdad -#: ../src/Doc/library/urllib2.rst:168 +#: library/urllib2.rst:185 msgid "" "*unverifiable* should indicate whether the request is unverifiable, as " "defined by RFC 2965. It defaults to ``False``. An unverifiable request is " @@ -118487,35 +121383,35 @@ msgid "" "to approve the automatic fetching of the image, this should be true." msgstr "" -#: ../src/Doc/library/urllib2.rst:177 +#: library/urllib2.rst:194 msgid "" "The :class:`OpenerDirector` class opens URLs via :class:`BaseHandler`\\ s " "chained together. It manages the chaining of handlers, and recovery from " "errors." msgstr "" -#: ../src/Doc/library/urllib2.rst:183 +#: library/urllib2.rst:200 msgid "" "This is the base class for all registered handlers --- and handles only the " "simple mechanics of registration." msgstr "" -#: ../src/Doc/library/urllib2.rst:189 +#: library/urllib2.rst:206 msgid "" "A class which defines a default handler for HTTP error responses; all " "responses are turned into :exc:`HTTPError` exceptions." msgstr "" -#: ../src/Doc/library/urllib2.rst:195 +#: library/urllib2.rst:212 msgid "A class to handle redirections." msgstr "" -#: ../src/Doc/library/urllib2.rst:200 +#: library/urllib2.rst:217 msgid "A class to handle HTTP Cookies." msgstr "" # 95653feacb254c389aac779018d46abd -#: ../src/Doc/library/urllib2.rst:205 +#: library/urllib2.rst:222 msgid "" "Cause requests to go through a proxy. If *proxies* is given, it must be a " "dictionary mapping protocol names to URLs of proxies. The default is to read " @@ -118526,22 +121422,22 @@ msgid "" "retrieved from the OS X System Configuration Framework." msgstr "" -#: ../src/Doc/library/urllib2.rst:213 +#: library/urllib2.rst:230 msgid "To disable autodetected proxy pass an empty dictionary." msgstr "" -#: ../src/Doc/library/urllib2.rst:218 +#: library/urllib2.rst:235 msgid "Keep a database of ``(realm, uri) -> (user, password)`` mappings." msgstr "" -#: ../src/Doc/library/urllib2.rst:223 +#: library/urllib2.rst:240 msgid "" "Keep a database of ``(realm, uri) -> (user, password)`` mappings. A realm " "of ``None`` is considered a catch-all realm, which is searched if no other " "realm fits." msgstr "" -#: ../src/Doc/library/urllib2.rst:230 ../src/Doc/library/urllib2.rst:255 +#: library/urllib2.rst:247 library/urllib2.rst:272 msgid "" "This is a mixin class that helps with HTTP authentication, both to the " "remote host and to a proxy. *password_mgr*, if given, should be something " @@ -118549,7 +121445,7 @@ msgid "" "`http-password-mgr` for information on the interface that must be supported." msgstr "" -#: ../src/Doc/library/urllib2.rst:239 ../src/Doc/library/urllib2.rst:264 +#: library/urllib2.rst:256 library/urllib2.rst:281 msgid "" "Handle authentication with the remote host. *password_mgr*, if given, should " "be something that is compatible with :class:`HTTPPasswordMgr`; refer to " @@ -118557,7 +121453,7 @@ msgid "" "be supported." msgstr "" -#: ../src/Doc/library/urllib2.rst:247 ../src/Doc/library/urllib2.rst:272 +#: library/urllib2.rst:264 library/urllib2.rst:289 msgid "" "Handle authentication with the proxy. *password_mgr*, if given, should be " "something that is compatible with :class:`HTTPPasswordMgr`; refer to " @@ -118565,68 +121461,74 @@ msgid "" "be supported." msgstr "" -#: ../src/Doc/library/urllib2.rst:280 +#: library/urllib2.rst:297 msgid "A class to handle opening of HTTP URLs." msgstr "" -#: ../src/Doc/library/urllib2.rst:285 -msgid "A class to handle opening of HTTPS URLs." +#: library/urllib2.rst:302 +msgid "" +"A class to handle opening of HTTPS URLs. *context* has the same meaning as " +"for :class:`httplib.HTTPSConnection`." msgstr "" -#: ../src/Doc/library/urllib2.rst:290 +#: library/urllib2.rst:305 +msgid "*context* added." +msgstr "" + +#: library/urllib2.rst:311 msgid "Open local files." msgstr "" -#: ../src/Doc/library/urllib2.rst:295 +#: library/urllib2.rst:316 msgid "Open FTP URLs." msgstr "" -#: ../src/Doc/library/urllib2.rst:300 +#: library/urllib2.rst:321 msgid "" "Open FTP URLs, keeping a cache of open FTP connections to minimize delays." msgstr "" -#: ../src/Doc/library/urllib2.rst:305 +#: library/urllib2.rst:326 msgid "A catch-all class to handle unknown URLs." msgstr "" -#: ../src/Doc/library/urllib2.rst:310 ../src/Doc/library/urllib2.rst:910 +#: library/urllib2.rst:331 library/urllib2.rst:931 msgid "Process HTTP error responses." msgstr "" -#: ../src/Doc/library/urllib2.rst:316 +#: library/urllib2.rst:337 msgid "Request Objects" msgstr "" # 7a43b6ce0e8e4950956eee7c8ad43b0e -#: ../src/Doc/library/urllib2.rst:318 +#: library/urllib2.rst:339 msgid "" "The following methods describe all of :class:`Request`'s public interface, " "and so all must be overridden in subclasses." msgstr "" -#: ../src/Doc/library/urllib2.rst:324 +#: library/urllib2.rst:345 msgid "" "Set the :class:`Request` data to *data*. This is ignored by all handlers " "except HTTP handlers --- and there it should be a byte string, and will " "change the request to be ``POST`` rather than ``GET``." msgstr "" -#: ../src/Doc/library/urllib2.rst:331 +#: library/urllib2.rst:352 msgid "" "Return a string indicating the HTTP request method. This is only meaningful " "for HTTP requests, and currently always returns ``'GET'`` or ``'POST'``." msgstr "" -#: ../src/Doc/library/urllib2.rst:337 +#: library/urllib2.rst:358 msgid "Return whether the instance has a non-\\ ``None`` data." msgstr "" -#: ../src/Doc/library/urllib2.rst:342 +#: library/urllib2.rst:363 msgid "Return the instance's data." msgstr "" -#: ../src/Doc/library/urllib2.rst:347 +#: library/urllib2.rst:368 msgid "" "Add another header to the request. Headers are currently ignored by all " "handlers except HTTP handlers, where they are added to the list of headers " @@ -118637,73 +121539,73 @@ msgid "" "way of gaining the same functionality using only one header." msgstr "" -#: ../src/Doc/library/urllib2.rst:358 +#: library/urllib2.rst:379 msgid "Add a header that will not be added to a redirected request." msgstr "" -#: ../src/Doc/library/urllib2.rst:365 +#: library/urllib2.rst:386 msgid "" "Return whether the instance has the named header (checks both regular and " "unredirected)." msgstr "" -#: ../src/Doc/library/urllib2.rst:373 +#: library/urllib2.rst:394 msgid "Return the URL given in the constructor." msgstr "" -#: ../src/Doc/library/urllib2.rst:378 +#: library/urllib2.rst:399 msgid "Return the type of the URL --- also known as the scheme." msgstr "" -#: ../src/Doc/library/urllib2.rst:383 +#: library/urllib2.rst:404 msgid "Return the host to which a connection will be made." msgstr "" -#: ../src/Doc/library/urllib2.rst:388 +#: library/urllib2.rst:409 msgid "Return the selector --- the part of the URL that is sent to the server." msgstr "" # dc3636b13d964e23abb9b9fe8287c0e6 -#: ../src/Doc/library/urllib2.rst:393 +#: library/urllib2.rst:414 msgid "" "Return the value of the given header. If the header is not present, return " "the default value." msgstr "" # 7216340c196d48838f085aabb8faef03 -#: ../src/Doc/library/urllib2.rst:399 +#: library/urllib2.rst:420 msgid "" "Return a list of tuples (header_name, header_value) of the Request headers." msgstr "" -#: ../src/Doc/library/urllib2.rst:404 +#: library/urllib2.rst:425 msgid "" "Prepare the request by connecting to a proxy server. The *host* and *type* " "will replace those of the instance, and the instance's selector will be the " "original URL given in the constructor." msgstr "" -#: ../src/Doc/library/urllib2.rst:411 +#: library/urllib2.rst:432 msgid "" "Return the request-host of the origin transaction, as defined by :rfc:" "`2965`. See the documentation for the :class:`Request` constructor." msgstr "" -#: ../src/Doc/library/urllib2.rst:417 +#: library/urllib2.rst:438 msgid "" "Return whether the request is unverifiable, as defined by RFC 2965. See the " "documentation for the :class:`Request` constructor." msgstr "" -#: ../src/Doc/library/urllib2.rst:424 +#: library/urllib2.rst:445 msgid "OpenerDirector Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:426 +#: library/urllib2.rst:447 msgid ":class:`OpenerDirector` instances have the following methods:" msgstr "" -#: ../src/Doc/library/urllib2.rst:431 +#: library/urllib2.rst:452 msgid "" "*handler* should be an instance of :class:`BaseHandler`. The following " "methods are searched, and added to the possible chains (note that HTTP " @@ -118711,42 +121613,42 @@ msgid "" msgstr "" # 8b4d49a0f33e40108b26b05ef2dbaab9 -#: ../src/Doc/library/urllib2.rst:435 +#: library/urllib2.rst:456 msgid "" ":samp:`{protocol}_open` --- signal that the handler knows how to open " "*protocol* URLs." msgstr "" # bea44868b8f9429a845a5544186348ea -#: ../src/Doc/library/urllib2.rst:438 +#: library/urllib2.rst:459 msgid "" ":samp:`http_error_{type}` --- signal that the handler knows how to handle " "HTTP errors with HTTP error code *type*." msgstr "" # 59e3b664a3c14b6eb8c1cd291619e3dc -#: ../src/Doc/library/urllib2.rst:441 +#: library/urllib2.rst:462 msgid "" ":samp:`{protocol}_error` --- signal that the handler knows how to handle " "errors from (non-\\ ``http``) *protocol*." msgstr "" # 24f62eace9084331ba08fb39a1e0ce84 -#: ../src/Doc/library/urllib2.rst:444 +#: library/urllib2.rst:465 msgid "" ":samp:`{protocol}_request` --- signal that the handler knows how to pre-" "process *protocol* requests." msgstr "" # f3a62b7c440746199f917d4711660b11 -#: ../src/Doc/library/urllib2.rst:447 +#: library/urllib2.rst:468 msgid "" ":samp:`{protocol}_response` --- signal that the handler knows how to post-" "process *protocol* responses." msgstr "" # 3de4b62e4c344f10ae9e3dfbbefe6100 -#: ../src/Doc/library/urllib2.rst:453 +#: library/urllib2.rst:474 msgid "" "Open the given *url* (which can be a request object or a string), optionally " "passing the given *data*. Arguments, return values and exceptions raised are " @@ -118758,7 +121660,7 @@ msgid "" "HTTP, HTTPS and FTP connections)." msgstr "" -#: ../src/Doc/library/urllib2.rst:468 +#: library/urllib2.rst:489 msgid "" "Handle an error of the given protocol. This will call the registered error " "handlers for the given protocol with the given arguments (which are protocol " @@ -118767,30 +121669,30 @@ msgid "" "\\*` methods of the handler classes." msgstr "" -#: ../src/Doc/library/urllib2.rst:474 +#: library/urllib2.rst:495 msgid "" "Return values and exceptions raised are the same as those of :func:`urlopen`." msgstr "" -#: ../src/Doc/library/urllib2.rst:476 +#: library/urllib2.rst:497 msgid "OpenerDirector objects open URLs in three stages:" msgstr "" -#: ../src/Doc/library/urllib2.rst:478 +#: library/urllib2.rst:499 msgid "" "The order in which these methods are called within each stage is determined " "by sorting the handler instances." msgstr "" # 544403d4f61d4d28bbb81072af683206 -#: ../src/Doc/library/urllib2.rst:481 +#: library/urllib2.rst:502 msgid "" "Every handler with a method named like :samp:`{protocol}_request` has that " "method called to pre-process the request." msgstr "" # 13c97c3937604200b03060b7b7c9eaec -#: ../src/Doc/library/urllib2.rst:484 +#: library/urllib2.rst:505 msgid "" "Handlers with a method named like :samp:`{protocol}_open` are called to " "handle the request. This stage ends when a handler either returns a non-\\ :" @@ -118799,7 +121701,7 @@ msgid "" msgstr "" # ca454d1a5b0c437d9c9f858bb8c07917 -#: ../src/Doc/library/urllib2.rst:489 +#: library/urllib2.rst:510 msgid "" "In fact, the above algorithm is first tried for methods named :meth:" "`default_open`. If all such methods return :const:`None`, the algorithm is " @@ -118809,7 +121711,7 @@ msgid "" msgstr "" # ceb2fbfb138d4746b3a3dbd20c5f88fa -#: ../src/Doc/library/urllib2.rst:495 +#: library/urllib2.rst:516 msgid "" "Note that the implementation of these methods may involve calls of the " "parent :class:`OpenerDirector` instance's :meth:`~OpenerDirector.open` and :" @@ -118817,58 +121719,58 @@ msgid "" msgstr "" # e13aa939deaa4b5e869570b1bc28c642 -#: ../src/Doc/library/urllib2.rst:499 +#: library/urllib2.rst:520 msgid "" "Every handler with a method named like :samp:`{protocol}_response` has that " "method called to post-process the response." msgstr "" -#: ../src/Doc/library/urllib2.rst:506 +#: library/urllib2.rst:527 msgid "BaseHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:508 +#: library/urllib2.rst:529 msgid "" ":class:`BaseHandler` objects provide a couple of methods that are directly " "useful, and others that are meant to be used by derived classes. These are " "intended for direct use:" msgstr "" -#: ../src/Doc/library/urllib2.rst:515 +#: library/urllib2.rst:536 msgid "Add a director as parent." msgstr "" -#: ../src/Doc/library/urllib2.rst:520 +#: library/urllib2.rst:541 msgid "Remove any parents." msgstr "" # d52dc5265e714583a6cd56260305a64e -#: ../src/Doc/library/urllib2.rst:522 +#: library/urllib2.rst:543 msgid "" "The following attributes and methods should only be used by classes derived " "from :class:`BaseHandler`." msgstr "" -#: ../src/Doc/library/urllib2.rst:527 +#: library/urllib2.rst:548 msgid "" "The convention has been adopted that subclasses defining :meth:" "`protocol_request` or :meth:`protocol_response` methods are named :class:`" "\\*Processor`; all others are named :class:`\\*Handler`." msgstr "" -#: ../src/Doc/library/urllib2.rst:534 +#: library/urllib2.rst:555 msgid "" "A valid :class:`OpenerDirector`, which can be used to open using a different " "protocol, or handle errors." msgstr "" -#: ../src/Doc/library/urllib2.rst:540 +#: library/urllib2.rst:561 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "define it if they want to catch all URLs." msgstr "" -#: ../src/Doc/library/urllib2.rst:543 +#: library/urllib2.rst:564 msgid "" "This method, if implemented, will be called by the parent :class:" "`OpenerDirector`. It should return a file-like object as described in the " @@ -118877,7 +121779,7 @@ msgid "" "example, :exc:`MemoryError` should not be mapped to :exc:`URLError`)." msgstr "" -#: ../src/Doc/library/urllib2.rst:549 +#: library/urllib2.rst:570 msgid "This method will be called before any protocol-specific open method." msgstr "" @@ -118885,40 +121787,40 @@ msgstr "" # 718700d9c7464c49b56ed5e055cd4e04 # 93e689bfba8a46fcaf1daecc2288e916 # f4c23c8014ef4b019c9d1441ad719258 -#: ../src/Doc/library/urllib2.rst:555 ../src/Doc/library/urllib2.rst:606 -#: ../src/Doc/library/urllib2.rst:619 ../src/Doc/library/urllib2.rst:708 +#: library/urllib2.rst:576 library/urllib2.rst:627 library/urllib2.rst:640 +#: library/urllib2.rst:729 msgid "(\"protocol\" is to be replaced by the protocol name.)" msgstr "" # 3ab1a932587e4c8aac9c6d547be1aa27 -#: ../src/Doc/library/urllib2.rst:557 +#: library/urllib2.rst:578 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "define it if they want to handle URLs with the given *protocol*." msgstr "" -#: ../src/Doc/library/urllib2.rst:560 +#: library/urllib2.rst:581 msgid "" "This method, if defined, will be called by the parent :class:" "`OpenerDirector`. Return values should be the same as for :meth:" "`default_open`." msgstr "" -#: ../src/Doc/library/urllib2.rst:566 +#: library/urllib2.rst:587 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "define it if they want to catch all URLs with no specific registered handler " "to open it." msgstr "" -#: ../src/Doc/library/urllib2.rst:570 +#: library/urllib2.rst:591 msgid "" "This method, if implemented, will be called by the :attr:`parent` :class:" "`OpenerDirector`. Return values should be the same as for :meth:" "`default_open`." msgstr "" -#: ../src/Doc/library/urllib2.rst:577 +#: library/urllib2.rst:598 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "override it if they intend to provide a catch-all for otherwise unhandled " @@ -118927,7 +121829,7 @@ msgid "" "other circumstances." msgstr "" -#: ../src/Doc/library/urllib2.rst:582 +#: library/urllib2.rst:603 msgid "" "*req* will be a :class:`Request` object, *fp* will be a file-like object " "with the HTTP error body, *code* will be the three-digit code of the error, " @@ -118935,37 +121837,37 @@ msgid "" "mapping object with the headers of the error." msgstr "" -#: ../src/Doc/library/urllib2.rst:587 +#: library/urllib2.rst:608 msgid "" "Return values and exceptions raised should be the same as those of :func:" "`urlopen`." msgstr "" -#: ../src/Doc/library/urllib2.rst:593 +#: library/urllib2.rst:614 msgid "" "*nnn* should be a three-digit HTTP error code. This method is also not " "defined in :class:`BaseHandler`, but will be called, if it exists, on an " "instance of a subclass, when an HTTP error with code *nnn* occurs." msgstr "" -#: ../src/Doc/library/urllib2.rst:597 +#: library/urllib2.rst:618 msgid "Subclasses should override this method to handle specific HTTP errors." msgstr "" -#: ../src/Doc/library/urllib2.rst:599 +#: library/urllib2.rst:620 msgid "" "Arguments, return values and exceptions raised should be the same as for :" "meth:`http_error_default`." msgstr "" # b06815dd6a574cb6bbf181f8e5bebcdd -#: ../src/Doc/library/urllib2.rst:608 +#: library/urllib2.rst:629 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "define it if they want to pre-process requests of the given *protocol*." msgstr "" -#: ../src/Doc/library/urllib2.rst:611 +#: library/urllib2.rst:632 msgid "" "This method, if defined, will be called by the parent :class:" "`OpenerDirector`. *req* will be a :class:`Request` object. The return value " @@ -118973,13 +121875,13 @@ msgid "" msgstr "" # e2821077d2cd4d2097cb75a9ecd52761 -#: ../src/Doc/library/urllib2.rst:621 +#: library/urllib2.rst:642 msgid "" "This method is *not* defined in :class:`BaseHandler`, but subclasses should " "define it if they want to post-process responses of the given *protocol*." msgstr "" -#: ../src/Doc/library/urllib2.rst:624 +#: library/urllib2.rst:645 msgid "" "This method, if defined, will be called by the parent :class:" "`OpenerDirector`. *req* will be a :class:`Request` object. *response* will " @@ -118988,18 +121890,18 @@ msgid "" "return value of :func:`urlopen`." msgstr "" -#: ../src/Doc/library/urllib2.rst:634 +#: library/urllib2.rst:655 msgid "HTTPRedirectHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:638 +#: library/urllib2.rst:659 msgid "" "Some HTTP redirections require action from this module's client code. If " "this is the case, :exc:`HTTPError` is raised. See :rfc:`2616` for details " "of the precise meanings of the various redirection codes." msgstr "" -#: ../src/Doc/library/urllib2.rst:645 +#: library/urllib2.rst:666 msgid "" "Return a :class:`Request` or ``None`` in response to a redirect. This is " "called by the default implementations of the :meth:`http_error_30\\*` " @@ -119010,7 +121912,7 @@ msgid "" "``None`` if you can't but another handler might." msgstr "" -#: ../src/Doc/library/urllib2.rst:655 +#: library/urllib2.rst:676 msgid "" "The default implementation of this method does not strictly follow :rfc:" "`2616`, which says that 301 and 302 responses to ``POST`` requests must not " @@ -119019,48 +121921,48 @@ msgid "" "POST to a ``GET``, and the default implementation reproduces this behavior." msgstr "" -#: ../src/Doc/library/urllib2.rst:664 +#: library/urllib2.rst:685 msgid "" "Redirect to the ``Location:`` or ``URI:`` URL. This method is called by the " "parent :class:`OpenerDirector` when getting an HTTP 'moved permanently' " "response." msgstr "" -#: ../src/Doc/library/urllib2.rst:670 +#: library/urllib2.rst:691 msgid "" "The same as :meth:`http_error_301`, but called for the 'found' response." msgstr "" -#: ../src/Doc/library/urllib2.rst:675 +#: library/urllib2.rst:696 msgid "" "The same as :meth:`http_error_301`, but called for the 'see other' response." msgstr "" -#: ../src/Doc/library/urllib2.rst:680 +#: library/urllib2.rst:701 msgid "" "The same as :meth:`http_error_301`, but called for the 'temporary redirect' " "response." msgstr "" -#: ../src/Doc/library/urllib2.rst:687 +#: library/urllib2.rst:708 msgid "HTTPCookieProcessor Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:691 +#: library/urllib2.rst:712 msgid ":class:`HTTPCookieProcessor` instances have one attribute:" msgstr "" # ec245798201c4ec6abf2d07e7db52c65 -#: ../src/Doc/library/urllib2.rst:696 +#: library/urllib2.rst:717 msgid "The :class:`cookielib.CookieJar` in which cookies are stored." msgstr "" -#: ../src/Doc/library/urllib2.rst:702 +#: library/urllib2.rst:723 msgid "ProxyHandler Objects" msgstr "" # 159971a1df0e48bdb06a2d61a38a1037 -#: ../src/Doc/library/urllib2.rst:710 +#: library/urllib2.rst:731 msgid "" "The :class:`ProxyHandler` will have a method :samp:`{protocol}_open` for " "every *protocol* which has a proxy in the *proxies* dictionary given in the " @@ -119069,17 +121971,17 @@ msgid "" "actually execute the protocol." msgstr "" -#: ../src/Doc/library/urllib2.rst:720 +#: library/urllib2.rst:741 msgid "HTTPPasswordMgr Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:722 +#: library/urllib2.rst:743 msgid "" "These methods are available on :class:`HTTPPasswordMgr` and :class:" "`HTTPPasswordMgrWithDefaultRealm` objects." msgstr "" -#: ../src/Doc/library/urllib2.rst:728 +#: library/urllib2.rst:749 msgid "" "*uri* can be either a single URI, or a sequence of URIs. *realm*, *user* and " "*passwd* must be strings. This causes ``(user, passwd)`` to be used as " @@ -119087,23 +121989,23 @@ msgid "" "of the given URIs is given." msgstr "" -#: ../src/Doc/library/urllib2.rst:736 +#: library/urllib2.rst:757 msgid "" "Get user/password for given realm and URI, if any. This method will return " "``(None, None)`` if there is no matching user/password." msgstr "" -#: ../src/Doc/library/urllib2.rst:739 +#: library/urllib2.rst:760 msgid "" "For :class:`HTTPPasswordMgrWithDefaultRealm` objects, the realm ``None`` " "will be searched if the given *realm* has no matching user/password." msgstr "" -#: ../src/Doc/library/urllib2.rst:746 +#: library/urllib2.rst:767 msgid "AbstractBasicAuthHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:751 +#: library/urllib2.rst:772 msgid "" "Handle an authentication request by getting a user/password pair, and re-" "trying the request. *authreq* should be the name of the header where the " @@ -119112,7 +122014,7 @@ msgid "" "`Request` object, and *headers* should be the error headers." msgstr "" -#: ../src/Doc/library/urllib2.rst:757 +#: library/urllib2.rst:778 msgid "" "*host* is either an authority (e.g. ``\"python.org\"``) or a URL containing " "an authority component (e.g. ``\"http://python.org/\"``). In either case, " @@ -119120,24 +122022,24 @@ msgid "" "and ``\"python.org:80\"`` are fine, ``\"joe:password@python.org\"`` is not)." msgstr "" -#: ../src/Doc/library/urllib2.rst:766 +#: library/urllib2.rst:787 msgid "HTTPBasicAuthHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:771 ../src/Doc/library/urllib2.rst:782 -#: ../src/Doc/library/urllib2.rst:807 ../src/Doc/library/urllib2.rst:818 +#: library/urllib2.rst:792 library/urllib2.rst:803 library/urllib2.rst:828 +#: library/urllib2.rst:839 msgid "Retry the request with authentication information, if available." msgstr "" -#: ../src/Doc/library/urllib2.rst:777 +#: library/urllib2.rst:798 msgid "ProxyBasicAuthHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:788 +#: library/urllib2.rst:809 msgid "AbstractDigestAuthHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:793 +#: library/urllib2.rst:814 msgid "" "*authreq* should be the name of the header where the information about the " "realm is included in the request, *host* should be the host to authenticate " @@ -119145,91 +122047,91 @@ msgid "" "should be the error headers." msgstr "" -#: ../src/Doc/library/urllib2.rst:802 +#: library/urllib2.rst:823 msgid "HTTPDigestAuthHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:813 +#: library/urllib2.rst:834 msgid "ProxyDigestAuthHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:824 +#: library/urllib2.rst:845 msgid "HTTPHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:829 +#: library/urllib2.rst:850 msgid "" "Send an HTTP request, which can be either GET or POST, depending on ``req." "has_data()``." msgstr "" -#: ../src/Doc/library/urllib2.rst:836 +#: library/urllib2.rst:857 msgid "HTTPSHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:841 +#: library/urllib2.rst:862 msgid "" "Send an HTTPS request, which can be either GET or POST, depending on ``req." "has_data()``." msgstr "" -#: ../src/Doc/library/urllib2.rst:848 +#: library/urllib2.rst:869 msgid "FileHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:853 +#: library/urllib2.rst:874 msgid "" "Open the file locally, if there is no host name, or the host name is " "``'localhost'``. Change the protocol to ``ftp`` otherwise, and retry opening " "it using :attr:`parent`." msgstr "" -#: ../src/Doc/library/urllib2.rst:861 +#: library/urllib2.rst:882 msgid "FTPHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:866 +#: library/urllib2.rst:887 msgid "" "Open the FTP file indicated by *req*. The login is always done with empty " "username and password." msgstr "" -#: ../src/Doc/library/urllib2.rst:873 +#: library/urllib2.rst:894 msgid "CacheFTPHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:875 +#: library/urllib2.rst:896 msgid "" ":class:`CacheFTPHandler` objects are :class:`FTPHandler` objects with the " "following additional methods:" msgstr "" -#: ../src/Doc/library/urllib2.rst:881 +#: library/urllib2.rst:902 msgid "Set timeout of connections to *t* seconds." msgstr "" -#: ../src/Doc/library/urllib2.rst:886 +#: library/urllib2.rst:907 msgid "Set maximum number of cached connections to *m*." msgstr "" -#: ../src/Doc/library/urllib2.rst:892 +#: library/urllib2.rst:913 msgid "UnknownHandler Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:897 +#: library/urllib2.rst:918 msgid "Raise a :exc:`URLError` exception." msgstr "" -#: ../src/Doc/library/urllib2.rst:903 +#: library/urllib2.rst:924 msgid "HTTPErrorProcessor Objects" msgstr "" -#: ../src/Doc/library/urllib2.rst:912 +#: library/urllib2.rst:933 msgid "For 200 error codes, the response object is returned immediately." msgstr "" # ee6ac56bb37244dd828fe3e53f63a631 -#: ../src/Doc/library/urllib2.rst:914 +#: library/urllib2.rst:935 msgid "" "For non-200 error codes, this simply passes the job on to the :samp:" "`{protocol}_error_code` handler methods, via :meth:`OpenerDirector.error`. " @@ -119238,39 +122140,39 @@ msgid "" msgstr "" # c9978ab6285a40c99b58b6930c83a9c9 -#: ../src/Doc/library/urllib2.rst:922 +#: library/urllib2.rst:943 msgid "Process HTTPS error responses." msgstr "" # a515e11eaf43431abca26315c0b4ecee -#: ../src/Doc/library/urllib2.rst:924 +#: library/urllib2.rst:945 msgid "The behavior is same as :meth:`http_response`." msgstr "" # 54af6c20ff5b4f72b7ac61a8b546de4b -#: ../src/Doc/library/urllib2.rst:932 +#: library/urllib2.rst:953 msgid "" "This example gets the python.org main page and displays the first 100 bytes " "of it::" msgstr "" # 9a0c0d1a740b46d495ed58ed9a12a26d -#: ../src/Doc/library/urllib2.rst:941 +#: library/urllib2.rst:962 msgid "" "Here we are sending a data-stream to the stdin of a CGI and reading the data " "it returns to us. Note that this example will only work when the Python " "installation supports SSL. ::" msgstr "" -#: ../src/Doc/library/urllib2.rst:952 +#: library/urllib2.rst:973 msgid "The code for the sample CGI used in the above example is::" msgstr "" -#: ../src/Doc/library/urllib2.rst:959 +#: library/urllib2.rst:980 msgid "Use of Basic HTTP Authentication::" msgstr "" -#: ../src/Doc/library/urllib2.rst:973 +#: library/urllib2.rst:994 msgid "" ":func:`build_opener` provides many handlers by default, including a :class:" "`ProxyHandler`. By default, :class:`ProxyHandler` uses the environment " @@ -119279,28 +122181,28 @@ msgid "" "read to obtain the HTTP proxy's URL." msgstr "" -#: ../src/Doc/library/urllib2.rst:979 +#: library/urllib2.rst:1000 msgid "" "This example replaces the default :class:`ProxyHandler` with one that uses " "programmatically-supplied proxy URLs, and adds proxy authorization support " "with :class:`ProxyBasicAuthHandler`. ::" msgstr "" -#: ../src/Doc/library/urllib2.rst:991 +#: library/urllib2.rst:1012 msgid "Adding HTTP headers:" msgstr "" -#: ../src/Doc/library/urllib2.rst:993 +#: library/urllib2.rst:1014 msgid "Use the *headers* argument to the :class:`Request` constructor, or::" msgstr "" -#: ../src/Doc/library/urllib2.rst:1000 +#: library/urllib2.rst:1021 msgid "" ":class:`OpenerDirector` automatically adds a :mailheader:`User-Agent` header " "to every :class:`Request`. To change this::" msgstr "" -#: ../src/Doc/library/urllib2.rst:1008 +#: library/urllib2.rst:1029 msgid "" "Also, remember that a few standard headers (:mailheader:`Content-Length`, :" "mailheader:`Content-Type` and :mailheader:`Host`) are added when the :class:" @@ -119308,12 +122210,12 @@ msgid "" msgstr "" # a1108cc98c394efc926852dffeaf4f58 -#: ../src/Doc/library/urlparse.rst:2 +#: library/urlparse.rst:2 msgid ":mod:`urlparse` --- Parse URLs into components" msgstr "" # a119412fa8954e5785951768c937c82a -#: ../src/Doc/library/urlparse.rst:16 +#: library/urlparse.rst:16 msgid "" "The :mod:`urlparse` module is renamed to :mod:`urllib.parse` in Python 3. " "The :term:`2to3` tool will automatically adapt imports when converting your " @@ -119321,11 +122223,11 @@ msgid "" msgstr "" # 73465f9c73404147be51e7dc8a38ed96 -#: ../src/Doc/library/urlparse.rst:20 +#: library/urlparse.rst:20 msgid "**Source code:** :source:`Lib/urlparse.py`" msgstr "" -#: ../src/Doc/library/urlparse.rst:24 +#: library/urlparse.rst:24 msgid "" "This module defines a standard interface to break Uniform Resource Locator " "(URL) strings up in components (addressing scheme, network location, path " @@ -119334,7 +122236,7 @@ msgid "" msgstr "" # 069663fb876f42a4a5ab7da82d899372 -#: ../src/Doc/library/urlparse.rst:29 +#: library/urlparse.rst:29 msgid "" "The module has been designed to match the Internet RFC on Relative Uniform " "Resource Locators. It supports the following URL schemes: ``file``, ``ftp``, " @@ -119344,12 +122246,16 @@ msgid "" "``telnet``, ``wais``." msgstr "" +#: library/urlparse.rst:36 +msgid "Support for the ``sftp`` and ``sips`` schemes." +msgstr "" + # 3155ff92e3d94235a2909e514c19061c -#: ../src/Doc/library/urlparse.rst:39 +#: library/urlparse.rst:39 msgid "The :mod:`urlparse` module defines the following functions:" msgstr "" -#: ../src/Doc/library/urlparse.rst:44 +#: library/urlparse.rst:44 msgid "" "Parse a URL into six components, returning a 6-tuple. This corresponds to " "the general structure of a URL: ``scheme://netloc/path;parameters?" @@ -119361,14 +122267,14 @@ msgid "" msgstr "" # 6f3098b89c5f4baa85b32f568c3ce0fb -#: ../src/Doc/library/urlparse.rst:65 +#: library/urlparse.rst:65 msgid "" "Following the syntax specifications in :rfc:`1808`, urlparse recognizes a " "netloc only if it is properly introduced by '//'. Otherwise the input is " "presumed to be a relative URL and thus to start with a path component." msgstr "" -#: ../src/Doc/library/urlparse.rst:81 +#: library/urlparse.rst:81 msgid "" "If the *scheme* argument is specified, it gives the default addressing " "scheme, to be used only if the URL does not specify one. The default value " @@ -119376,7 +122282,7 @@ msgid "" msgstr "" # 3951b50a149d422690c3d6dcab0bd2a3 -#: ../src/Doc/library/urlparse.rst:85 +#: library/urlparse.rst:85 msgid "" "If the *allow_fragments* argument is false, fragment identifiers are not " "recognized and parsed as part of the preceding component, even if the URL's " @@ -119384,112 +122290,121 @@ msgid "" "argument is :const:`True`." msgstr "" -#: ../src/Doc/library/urlparse.rst:90 ../src/Doc/library/urlparse.rst:194 +#: library/urlparse.rst:90 library/urlparse.rst:194 msgid "" "The return value is actually an instance of a subclass of :class:`tuple`. " "This class has the following additional read-only convenience attributes:" msgstr "" -#: ../src/Doc/library/urlparse.rst:94 ../src/Doc/library/urlparse.rst:198 +#: library/urlparse.rst:94 library/urlparse.rst:198 msgid "Value if not present" msgstr "" -#: ../src/Doc/library/urlparse.rst:96 ../src/Doc/library/urlparse.rst:200 +#: library/urlparse.rst:96 library/urlparse.rst:200 msgid ":attr:`scheme`" msgstr "" -#: ../src/Doc/library/urlparse.rst:96 ../src/Doc/library/urlparse.rst:200 +#: library/urlparse.rst:96 library/urlparse.rst:200 msgid "URL scheme specifier" msgstr "" -#: ../src/Doc/library/urlparse.rst:96 ../src/Doc/library/urlparse.rst:98 -#: ../src/Doc/library/urlparse.rst:100 ../src/Doc/library/urlparse.rst:102 -#: ../src/Doc/library/urlparse.rst:105 ../src/Doc/library/urlparse.rst:107 -#: ../src/Doc/library/urlparse.rst:200 ../src/Doc/library/urlparse.rst:202 -#: ../src/Doc/library/urlparse.rst:204 ../src/Doc/library/urlparse.rst:206 -#: ../src/Doc/library/urlparse.rst:208 -msgid "empty string" +#: library/urlparse.rst:96 library/urlparse.rst:200 +msgid "*scheme* parameter" msgstr "" -#: ../src/Doc/library/urlparse.rst:98 ../src/Doc/library/urlparse.rst:202 +#: library/urlparse.rst:98 library/urlparse.rst:202 msgid ":attr:`netloc`" msgstr "" -#: ../src/Doc/library/urlparse.rst:98 ../src/Doc/library/urlparse.rst:202 +#: library/urlparse.rst:98 library/urlparse.rst:202 msgid "Network location part" msgstr "" -#: ../src/Doc/library/urlparse.rst:100 ../src/Doc/library/urlparse.rst:204 +#: library/urlparse.rst:98 library/urlparse.rst:100 library/urlparse.rst:102 +#: library/urlparse.rst:105 library/urlparse.rst:107 library/urlparse.rst:202 +#: library/urlparse.rst:204 library/urlparse.rst:206 library/urlparse.rst:208 +msgid "empty string" +msgstr "" + +#: library/urlparse.rst:100 library/urlparse.rst:204 msgid ":attr:`path`" msgstr "" -#: ../src/Doc/library/urlparse.rst:100 ../src/Doc/library/urlparse.rst:204 +#: library/urlparse.rst:100 library/urlparse.rst:204 msgid "Hierarchical path" msgstr "" -#: ../src/Doc/library/urlparse.rst:102 +#: library/urlparse.rst:102 msgid ":attr:`params`" msgstr "" -#: ../src/Doc/library/urlparse.rst:102 +#: library/urlparse.rst:102 msgid "Parameters for last path element" msgstr "" -#: ../src/Doc/library/urlparse.rst:105 ../src/Doc/library/urlparse.rst:206 +#: library/urlparse.rst:105 library/urlparse.rst:206 msgid ":attr:`query`" msgstr "" -#: ../src/Doc/library/urlparse.rst:105 ../src/Doc/library/urlparse.rst:206 +#: library/urlparse.rst:105 library/urlparse.rst:206 msgid "Query component" msgstr "" -#: ../src/Doc/library/urlparse.rst:107 ../src/Doc/library/urlparse.rst:208 +#: library/urlparse.rst:107 library/urlparse.rst:208 msgid ":attr:`fragment`" msgstr "" -#: ../src/Doc/library/urlparse.rst:107 ../src/Doc/library/urlparse.rst:208 +#: library/urlparse.rst:107 library/urlparse.rst:208 msgid "Fragment identifier" msgstr "" -#: ../src/Doc/library/urlparse.rst:109 ../src/Doc/library/urlparse.rst:210 +#: library/urlparse.rst:109 library/urlparse.rst:210 msgid ":attr:`username`" msgstr "" -#: ../src/Doc/library/urlparse.rst:109 ../src/Doc/library/urlparse.rst:210 +#: library/urlparse.rst:109 library/urlparse.rst:210 msgid "User name" msgstr "" -#: ../src/Doc/library/urlparse.rst:111 ../src/Doc/library/urlparse.rst:212 +#: library/urlparse.rst:111 library/urlparse.rst:212 msgid ":attr:`password`" msgstr "" -#: ../src/Doc/library/urlparse.rst:111 ../src/Doc/library/urlparse.rst:212 +#: library/urlparse.rst:111 library/urlparse.rst:212 msgid "Password" msgstr "" -#: ../src/Doc/library/urlparse.rst:113 ../src/Doc/library/urlparse.rst:214 +#: library/urlparse.rst:113 library/urlparse.rst:214 msgid ":attr:`hostname`" msgstr "" -#: ../src/Doc/library/urlparse.rst:113 ../src/Doc/library/urlparse.rst:214 +#: library/urlparse.rst:113 library/urlparse.rst:214 msgid "Host name (lower case)" msgstr "" -#: ../src/Doc/library/urlparse.rst:115 ../src/Doc/library/urlparse.rst:216 +#: library/urlparse.rst:115 library/urlparse.rst:216 msgid ":attr:`port`" msgstr "" -#: ../src/Doc/library/urlparse.rst:115 ../src/Doc/library/urlparse.rst:216 +#: library/urlparse.rst:115 library/urlparse.rst:216 msgid "Port number as integer, if present" msgstr "" -#: ../src/Doc/library/urlparse.rst:119 ../src/Doc/library/urlparse.rst:220 +#: library/urlparse.rst:119 library/urlparse.rst:220 msgid "" "See section :ref:`urlparse-result-object` for more information on the result " "object." msgstr "" -#: ../src/Doc/library/urlparse.rst:131 +#: library/urlparse.rst:122 library/urlparse.rst:225 +msgid "Added attributes to return value." +msgstr "" + +#: library/urlparse.rst:125 +msgid "Added IPv6 URL parsing capabilities." +msgstr "" + +#: library/urlparse.rst:131 msgid "" "Parse a query string given as a string argument (data of type :mimetype:" "`application/x-www-form-urlencoded`). Data are returned as a dictionary. " @@ -119499,7 +122414,7 @@ msgstr "" # 0e2130c5c75f457ca03958920604e576 # ab8d9fd1b77a4a20a3a9491255152cbd -#: ../src/Doc/library/urlparse.rst:136 ../src/Doc/library/urlparse.rst:159 +#: library/urlparse.rst:136 library/urlparse.rst:159 msgid "" "The optional argument *keep_blank_values* is a flag indicating whether blank " "values in percent-encoded queries should be treated as blank strings. A " @@ -119508,7 +122423,7 @@ msgid "" "treated as if they were not included." msgstr "" -#: ../src/Doc/library/urlparse.rst:142 ../src/Doc/library/urlparse.rst:165 +#: library/urlparse.rst:142 library/urlparse.rst:165 msgid "" "The optional argument *strict_parsing* is a flag indicating what to do with " "parsing errors. If false (the default), errors are silently ignored. If " @@ -119516,13 +122431,17 @@ msgid "" msgstr "" # 707a9747c8844cdd94807aa25e39c7ef -#: ../src/Doc/library/urlparse.rst:146 +#: library/urlparse.rst:146 msgid "" "Use the :func:`urllib.urlencode` function to convert such dictionaries into " "query strings." msgstr "" -#: ../src/Doc/library/urlparse.rst:155 +#: library/urlparse.rst:149 library/urlparse.rst:172 +msgid "Copied from the :mod:`cgi` module." +msgstr "" + +#: library/urlparse.rst:155 msgid "" "Parse a query string given as a string argument (data of type :mimetype:" "`application/x-www-form-urlencoded`). Data are returned as a list of name, " @@ -119530,14 +122449,14 @@ msgid "" msgstr "" # a7e5487eb75d4959aebef551e0114b0c -#: ../src/Doc/library/urlparse.rst:169 +#: library/urlparse.rst:169 msgid "" "Use the :func:`urllib.urlencode` function to convert such lists of pairs " "into query strings." msgstr "" # 5c24a5b4f270456fb21973b78bd57b28 -#: ../src/Doc/library/urlparse.rst:178 +#: library/urlparse.rst:178 msgid "" "Construct a URL from a tuple as returned by ``urlparse()``. The *parts* " "argument can be any six-item iterable. This may result in a slightly " @@ -119546,7 +122465,7 @@ msgid "" "that these are equivalent)." msgstr "" -#: ../src/Doc/library/urlparse.rst:187 +#: library/urlparse.rst:187 msgid "" "This is similar to :func:`urlparse`, but does not split the params from the " "URL. This should generally be used instead of :func:`urlparse` if the more " @@ -119557,7 +122476,7 @@ msgid "" "fragment identifier)." msgstr "" -#: ../src/Doc/library/urlparse.rst:231 +#: library/urlparse.rst:231 msgid "" "Combine the elements of a tuple as returned by :func:`urlsplit` into a " "complete URL as a string. The *parts* argument can be any five-item " @@ -119566,7 +122485,7 @@ msgid "" "a ? with an empty query; the RFC states that these are equivalent)." msgstr "" -#: ../src/Doc/library/urlparse.rst:242 +#: library/urlparse.rst:242 msgid "" "Construct a full (\"absolute\") URL by combining a \"base URL\" (*base*) " "with another URL (*url*). Informally, this uses components of the base URL, " @@ -119574,27 +122493,27 @@ msgid "" "path, to provide missing components in the relative URL. For example:" msgstr "" -#: ../src/Doc/library/urlparse.rst:251 +#: library/urlparse.rst:251 msgid "" "The *allow_fragments* argument has the same meaning and default as for :func:" "`urlparse`." msgstr "" -#: ../src/Doc/library/urlparse.rst:256 +#: library/urlparse.rst:256 msgid "" "If *url* is an absolute URL (that is, starting with ``//`` or ``scheme://" "``), the *url*'s host name and/or scheme will be present in the result. For " "example:" msgstr "" -#: ../src/Doc/library/urlparse.rst:265 +#: library/urlparse.rst:265 msgid "" "If you do not want that behavior, preprocess the *url* with :func:`urlsplit` " "and :func:`urlunsplit`, removing possible *scheme* and *netloc* parts." msgstr "" # 817430d987144102949981d7653c7f3b -#: ../src/Doc/library/urlparse.rst:271 +#: library/urlparse.rst:271 msgid "" "If *url* contains a fragment identifier, returns a modified version of *url* " "with no fragment identifier, and the fragment identifier as a separate " @@ -119602,12 +122521,11 @@ msgid "" "unmodified and an empty string." msgstr "" -# 627bd0b1beeb40a5968178f95a463994 -#: ../src/Doc/library/urlparse.rst:282 -msgid ":rfc:`3986` - Uniform Resource Identifiers" +#: library/urlparse.rst:283 +msgid "RFC 3986 - Uniform Resource Identifiers" msgstr "" -#: ../src/Doc/library/urlparse.rst:280 +#: library/urlparse.rst:280 msgid "" "This is the current standard (STD66). Any changes to urlparse module should " "conform to this. Certain deviations could be observed, which are mostly due " @@ -119615,61 +122533,56 @@ msgid "" "as commonly observed in major browsers." msgstr "" -# 52ba292bd2b8412986c5deeb2b0ca980 -#: ../src/Doc/library/urlparse.rst:285 -msgid ":rfc:`2732` - Format for Literal IPv6 Addresses in URL's." +#: library/urlparse.rst:286 +msgid "RFC 2732 - Format for Literal IPv6 Addresses in URL's." msgstr "" -#: ../src/Doc/library/urlparse.rst:286 +#: library/urlparse.rst:286 msgid "This specifies the parsing requirements of IPv6 URLs." msgstr "" -# d644f746aa304fb093a35608d9c6a312 -#: ../src/Doc/library/urlparse.rst:289 -msgid ":rfc:`2396` - Uniform Resource Identifiers (URI): Generic Syntax" +#: library/urlparse.rst:290 +msgid "RFC 2396 - Uniform Resource Identifiers (URI): Generic Syntax" msgstr "" -#: ../src/Doc/library/urlparse.rst:289 +#: library/urlparse.rst:289 msgid "" "Document describing the generic syntactic requirements for both Uniform " "Resource Names (URNs) and Uniform Resource Locators (URLs)." msgstr "" -# dfa3b4243d1f4261a64276a33e6f4f92 -#: ../src/Doc/library/urlparse.rst:292 -msgid ":rfc:`2368` - The mailto URL scheme." +#: library/urlparse.rst:293 +msgid "RFC 2368 - The mailto URL scheme." msgstr "" -#: ../src/Doc/library/urlparse.rst:293 +#: library/urlparse.rst:293 msgid "Parsing requirements for mailto url schemes." msgstr "" -# bb04ef197f7d475f826e1a1d7a5be466 -#: ../src/Doc/library/urlparse.rst:297 -msgid ":rfc:`1808` - Relative Uniform Resource Locators" +#: library/urlparse.rst:298 +msgid "RFC 1808 - Relative Uniform Resource Locators" msgstr "" -#: ../src/Doc/library/urlparse.rst:296 +#: library/urlparse.rst:296 msgid "" "This Request For Comments includes the rules for joining an absolute and a " "relative URL, including a fair number of \"Abnormal Examples\" which govern " "the treatment of border cases." msgstr "" -# 962941ac33034e74991482a5d24117b7 -#: ../src/Doc/library/urlparse.rst:299 -msgid ":rfc:`1738` - Uniform Resource Locators (URL)" +#: library/urlparse.rst:300 +msgid "RFC 1738 - Uniform Resource Locators (URL)" msgstr "" -#: ../src/Doc/library/urlparse.rst:301 +#: library/urlparse.rst:301 msgid "This specifies the formal syntax and semantics of absolute URLs." msgstr "" -#: ../src/Doc/library/urlparse.rst:307 +#: library/urlparse.rst:307 msgid "Results of :func:`urlparse` and :func:`urlsplit`" msgstr "" -#: ../src/Doc/library/urlparse.rst:309 +#: library/urlparse.rst:309 msgid "" "The result objects from the :func:`urlparse` and :func:`urlsplit` functions " "are subclasses of the :class:`tuple` type. These subclasses add the " @@ -119677,7 +122590,7 @@ msgid "" "method:" msgstr "" -#: ../src/Doc/library/urlparse.rst:316 +#: library/urlparse.rst:316 msgid "" "Return the re-combined version of the original URL as a string. This may " "differ from the original URL in that the scheme will always be normalized to " @@ -119685,17 +122598,17 @@ msgid "" "parameters, queries, and fragment identifiers will be removed." msgstr "" -#: ../src/Doc/library/urlparse.rst:321 +#: library/urlparse.rst:321 msgid "" "The result of this method is a fixpoint if passed back through the original " "parsing function:" msgstr "" -#: ../src/Doc/library/urlparse.rst:337 +#: library/urlparse.rst:337 msgid "The following classes provide the implementations of the parse results:" msgstr "" -#: ../src/Doc/library/urlparse.rst:342 +#: library/urlparse.rst:342 msgid "" "Base class for the concrete result classes. This provides most of the " "attribute definitions. It does not provide a :meth:`geturl` method. It is " @@ -119703,25 +122616,29 @@ msgid "" "meth:`__new__` methods." msgstr "" -#: ../src/Doc/library/urlparse.rst:350 +#: library/urlparse.rst:350 msgid "" "Concrete class for :func:`urlparse` results. The :meth:`__new__` method is " "overridden to support checking that the right number of arguments are passed." msgstr "" -#: ../src/Doc/library/urlparse.rst:356 +#: library/urlparse.rst:356 msgid "" "Concrete class for :func:`urlsplit` results. The :meth:`__new__` method is " "overridden to support checking that the right number of arguments are passed." msgstr "" # 45dda7ef4af64f62952caedbc53e1c2a -#: ../src/Doc/library/user.rst:3 +#: library/user.rst:3 msgid ":mod:`user` --- User-specific configuration hook" msgstr "" +#: library/user.rst:9 +msgid "The :mod:`user` module has been removed in Python 3." +msgstr "" + # d9d8db0f714e43a98d69b6f3d016a675 -#: ../src/Doc/library/user.rst:16 +#: library/user.rst:16 msgid "" "As a policy, Python doesn't run user-specified code on startup of Python " "programs. (Only interactive sessions execute the script specified in the :" @@ -119729,7 +122646,7 @@ msgid "" msgstr "" # 8bcc7f6bf2b7483885e3609e9b57e8be -#: ../src/Doc/library/user.rst:20 +#: library/user.rst:20 msgid "" "However, some programs or sites may find it convenient to allow users to " "have a standard customization file, which gets run when a program requests " @@ -119738,7 +122655,7 @@ msgid "" msgstr "" # c7f6810df6e24c60816cdbfad17b3da3 -#: ../src/Doc/library/user.rst:29 +#: library/user.rst:29 msgid "" "The :mod:`user` module looks for a file :file:`.pythonrc.py` in the user's " "home directory and if it can be opened, executes it (using :func:`execfile`) " @@ -119750,14 +122667,14 @@ msgid "" msgstr "" # e8eac268aa924fcab11ef80cd0a658ce -#: ../src/Doc/library/user.rst:36 +#: library/user.rst:36 msgid "" "The user's :file:`.pythonrc.py` could conceivably test for ``sys.version`` " "if it wishes to do different things depending on the Python version." msgstr "" # 290810521f034c7faf73bbb69cc67e61 -#: ../src/Doc/library/user.rst:39 +#: library/user.rst:39 msgid "" "A warning to users: be very conservative in what you place in your :file:`." "pythonrc.py` file. Since you don't know which programs will use it, " @@ -119766,7 +122683,7 @@ msgid "" msgstr "" # 66ab5e148d71429fafe6bc6d3633366a -#: ../src/Doc/library/user.rst:44 +#: library/user.rst:44 msgid "" "A suggestion for programmers who wish to use this mechanism: a simple way to " "let users specify options for your package is to have them define variables " @@ -119776,21 +122693,21 @@ msgid "" msgstr "" # 69e50e522f3f478e8cf81fa04acbfa13 -#: ../src/Doc/library/user.rst:54 +#: library/user.rst:54 msgid "" "(The three-argument form of :func:`getattr` is used in case the user has not " "defined ``spam_verbose`` in their :file:`.pythonrc.py` file.)" msgstr "" # 399aaab60298462f83119b743f12d29c -#: ../src/Doc/library/user.rst:57 +#: library/user.rst:57 msgid "" "Programs with extensive customization needs are better off reading a program-" "specific customization file." msgstr "" # 1b866d063f4f4958b0953853728aa75d -#: ../src/Doc/library/user.rst:60 +#: library/user.rst:60 msgid "" "Programs with security or privacy concerns should *not* import this module; " "a user can easily break into a program by placing arbitrary code in the :" @@ -119798,34 +122715,34 @@ msgid "" msgstr "" # 45c01701b65842ed804dac05e667c080 -#: ../src/Doc/library/user.rst:64 +#: library/user.rst:64 msgid "" "Modules for general use should *not* import this module; it may interfere " "with the operation of the importing program." msgstr "" -# 65ab8af1ae4b4d02ab8bfa7223204c83 -#: ../src/Doc/library/user.rst:69 -msgid "Module :mod:`site`" -msgstr "" +#: library/user.rst:70 +#, fuzzy +msgid "Module site" +msgstr "Modules" # cacdb48633614bb9aff23d1243b5a4aa -#: ../src/Doc/library/user.rst:71 +#: library/user.rst:71 msgid "Site-wide customization mechanism." msgstr "" # 410b1e1756fb45749a442344d665c095 -#: ../src/Doc/library/userdict.rst:2 +#: library/userdict.rst:2 msgid ":mod:`UserDict` --- Class wrapper for dictionary objects" msgstr "" # 83f07d7b48f54b0283b7ad1ba6afc175 -#: ../src/Doc/library/userdict.rst:8 +#: library/userdict.rst:8 msgid "**Source code:** :source:`Lib/UserDict.py`" msgstr "" # 535cb5f963f444b8ab65603c72097046 -#: ../src/Doc/library/userdict.rst:12 +#: library/userdict.rst:12 msgid "" "The module defines a mixin, :class:`DictMixin`, defining all dictionary " "methods for classes that already have a minimum mapping interface. This " @@ -119834,7 +122751,7 @@ msgid "" msgstr "" # 0a275825e81349f180a8ac2bc07d9d5b -#: ../src/Doc/library/userdict.rst:17 +#: library/userdict.rst:17 msgid "" "This module also defines a class, :class:`UserDict`, that acts as a wrapper " "around dictionary objects. The need for this class has been largely " @@ -119846,13 +122763,13 @@ msgid "" msgstr "" # d314bd65d7034ddeba48f602d29d56a4 -#: ../src/Doc/library/userdict.rst:25 +#: library/userdict.rst:25 msgid "" "The :mod:`UserDict` module defines the :class:`UserDict` class and :class:" "`DictMixin`:" msgstr "" -#: ../src/Doc/library/userdict.rst:31 +#: library/userdict.rst:31 msgid "" "Class that simulates a dictionary. The instance's contents are kept in a " "regular dictionary, which is accessible via the :attr:`data` attribute of :" @@ -119862,33 +122779,33 @@ msgid "" msgstr "" # b985ce9541b44253ae231de8bca8fe07 -#: ../src/Doc/library/userdict.rst:39 +#: library/userdict.rst:39 msgid "" "For backward compatibility, instances of :class:`UserDict` are not iterable." msgstr "" # 65839b9736764be289affd4659ce813d -#: ../src/Doc/library/userdict.rst:44 +#: library/userdict.rst:44 msgid "" "Subclass of :class:`UserDict` that supports direct iteration (e.g. ``for " "key in myDict``)." msgstr "" # 858c3fcd2d3246a89a13a5e80abecb4f -#: ../src/Doc/library/userdict.rst:47 +#: library/userdict.rst:47 msgid "" "In addition to supporting the methods and operations of mappings (see " "section :ref:`typesmapping`), :class:`UserDict` and :class:" "`IterableUserDict` instances provide the following attribute:" msgstr "" -#: ../src/Doc/library/userdict.rst:54 +#: library/userdict.rst:54 msgid "" "A real dictionary used to store the contents of the :class:`UserDict` class." msgstr "" # 6f2a425be934425f910490ca1f766c9f -#: ../src/Doc/library/userdict.rst:59 +#: library/userdict.rst:59 msgid "" "Mixin defining all dictionary methods for classes that already have a " "minimum dictionary interface including :meth:`__getitem__`, :meth:" @@ -119896,7 +122813,7 @@ msgid "" msgstr "" # 1ed0b6568bb14f8bb8aabc3c8e7f78e9 -#: ../src/Doc/library/userdict.rst:63 +#: library/userdict.rst:63 msgid "" "This mixin should be used as a superclass. Adding each of the above methods " "adds progressively more functionality. For instance, defining all but :meth:" @@ -119905,33 +122822,33 @@ msgid "" msgstr "" # f971a945e2394e24b35b69d2886d1d10 -#: ../src/Doc/library/userdict.rst:68 +#: library/userdict.rst:68 msgid "" "In addition to the four base methods, progressively more efficiency comes " "with defining :meth:`__contains__`, :meth:`__iter__`, and :meth:`iteritems`." msgstr "" # b020892bc03549409399a92abd2c4d8c -#: ../src/Doc/library/userdict.rst:71 +#: library/userdict.rst:71 msgid "" "Since the mixin has no knowledge of the subclass constructor, it does not " "define :meth:`__init__` or :meth:`copy`." msgstr "" # f5463b632d0048e49830434c40e85d08 -#: ../src/Doc/library/userdict.rst:74 +#: library/userdict.rst:74 msgid "" "Starting with Python version 2.6, it is recommended to use :class:" "`collections.MutableMapping` instead of :class:`DictMixin`." msgstr "" # b9ac85988a5f420195555d1cb8b2d688 -#: ../src/Doc/library/userdict.rst:78 +#: library/userdict.rst:78 msgid ":mod:`UserList` --- Class wrapper for list objects" msgstr "" # 41b1e69e57964198a5a3ea660660e5f8 -#: ../src/Doc/library/userdict.rst:86 +#: library/userdict.rst:86 msgid "" "When Python 2.2 was released, many of the use cases for this class were " "subsumed by the ability to subclass :class:`list` directly. However, a " @@ -119939,7 +122856,7 @@ msgid "" msgstr "" # d80b2f61825c41f990c93081d969d948 -#: ../src/Doc/library/userdict.rst:90 +#: library/userdict.rst:90 msgid "" "This module provides a list-interface around an underlying data store. By " "default, that data store is a :class:`list`; however, it can be used to wrap " @@ -119947,7 +122864,7 @@ msgid "" msgstr "" # 54b431b6e77d42b888c8b4de762fed4c -#: ../src/Doc/library/userdict.rst:94 +#: library/userdict.rst:94 msgid "" "In addition, this class can be mixed-in with built-in classes using multiple " "inheritance. This can sometimes be useful. For example, you can inherit " @@ -119956,7 +122873,7 @@ msgid "" msgstr "" # a11e100c5d3349f99aac0a54db7d05bf -#: ../src/Doc/library/userdict.rst:99 +#: library/userdict.rst:99 msgid "" "This module defines a class that acts as a wrapper around list objects. It " "is a useful base class for your own list-like classes, which can inherit " @@ -119965,12 +122882,12 @@ msgid "" msgstr "" # e03cc4ec603d4901bb7e1ef30e333373 -#: ../src/Doc/library/userdict.rst:104 +#: library/userdict.rst:104 msgid "The :mod:`UserList` module defines the :class:`UserList` class:" msgstr "" # f0736d2c384f49ff80ca04ff603b9200 -#: ../src/Doc/library/userdict.rst:109 +#: library/userdict.rst:109 msgid "" "Class that simulates a list. The instance's contents are kept in a regular " "list, which is accessible via the :attr:`data` attribute of :class:" @@ -119980,7 +122897,7 @@ msgid "" msgstr "" # 469c6993a91f4be09a84c873e4e70265 -#: ../src/Doc/library/userdict.rst:116 +#: library/userdict.rst:116 msgid "" "The :class:`UserList` class has been moved to the :mod:`collections` module " "in Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -119988,7 +122905,7 @@ msgid "" msgstr "" # 530baead76024140bf783c079e365b37 -#: ../src/Doc/library/userdict.rst:121 +#: library/userdict.rst:121 msgid "" "In addition to supporting the methods and operations of mutable sequences " "(see section :ref:`typesseq`), :class:`UserList` instances provide the " @@ -119996,14 +122913,14 @@ msgid "" msgstr "" # b79f1e8322c748e9a1c4f03374f6024d -#: ../src/Doc/library/userdict.rst:128 +#: library/userdict.rst:128 msgid "" "A real Python list object used to store the contents of the :class:" "`UserList` class." msgstr "" # 9c0dd13e99ea492485e763a741c9d7e2 -#: ../src/Doc/library/userdict.rst:131 +#: library/userdict.rst:131 msgid "" "**Subclassing requirements:** Subclasses of :class:`UserList` are expected " "to offer a constructor which can be called with either no arguments or one " @@ -120013,7 +122930,7 @@ msgid "" "object used as a data source." msgstr "" -#: ../src/Doc/library/userdict.rst:138 +#: library/userdict.rst:138 msgid "" "If a derived class does not wish to comply with this requirement, all of the " "special methods supported by this class will need to be overridden; please " @@ -120021,13 +122938,20 @@ msgid "" "provided in that case." msgstr "" +#: library/userdict.rst:143 +msgid "" +"Python versions 1.5.2 and 1.6 also required that the constructor be callable " +"with no parameters, and offer a mutable :attr:`data` attribute. Earlier " +"versions of Python did not attempt to create instances of the derived class." +msgstr "" + # 70595df8d118478cb1445eefba99ba0b -#: ../src/Doc/library/userdict.rst:150 +#: library/userdict.rst:150 msgid ":mod:`UserString` --- Class wrapper for string objects" msgstr "" # 1e16ee35d90141539c418ce4f0c501b4 -#: ../src/Doc/library/userdict.rst:160 +#: library/userdict.rst:160 msgid "" "This :class:`UserString` class from this module is available for backward " "compatibility only. If you are writing code that does not need to work with " @@ -120037,7 +122961,7 @@ msgid "" msgstr "" # 1ad578d743514ac48bdf7d9760a80685 -#: ../src/Doc/library/userdict.rst:166 +#: library/userdict.rst:166 msgid "" "This module defines a class that acts as a wrapper around string objects. " "It is a useful base class for your own string-like classes, which can " @@ -120046,7 +122970,7 @@ msgid "" msgstr "" # a0a626a647194768888a8c350c87a8b5 -#: ../src/Doc/library/userdict.rst:171 +#: library/userdict.rst:171 msgid "" "It should be noted that these classes are highly inefficient compared to " "real string or Unicode objects; this is especially the case for :class:" @@ -120054,12 +122978,12 @@ msgid "" msgstr "" # bdfce89af57e43daae18101106f73e57 -#: ../src/Doc/library/userdict.rst:175 +#: library/userdict.rst:175 msgid "The :mod:`UserString` module defines the following classes:" msgstr "" # 7e81498a9cbe4f20a44b6173ae151e99 -#: ../src/Doc/library/userdict.rst:180 +#: library/userdict.rst:180 msgid "" "Class that simulates a string or a Unicode string object. The instance's " "content is kept in a regular string or Unicode string object, which is " @@ -120071,7 +122995,7 @@ msgid "" msgstr "" # 9b8be167326143c0bb23f09ceb2b08be -#: ../src/Doc/library/userdict.rst:189 +#: library/userdict.rst:189 msgid "" "The :class:`UserString` class has been moved to the :mod:`collections` " "module in Python 3. The :term:`2to3` tool will automatically adapt imports " @@ -120079,7 +123003,7 @@ msgid "" msgstr "" # ad04aee7019e482186d4989e2c1b537b -#: ../src/Doc/library/userdict.rst:197 +#: library/userdict.rst:197 msgid "" "This class is derived from the :class:`UserString` above and redefines " "strings to be *mutable*. Mutable strings can't be used as dictionary keys, " @@ -120090,8 +123014,12 @@ msgid "" "would be otherwise very error prone and hard to track down." msgstr "" +#: library/userdict.rst:205 +msgid "The :class:`MutableString` class has been removed in Python 3." +msgstr "" + # ee5bf39d1eb34c3a93ff803901f43933 -#: ../src/Doc/library/userdict.rst:208 +#: library/userdict.rst:208 msgid "" "In addition to supporting the methods and operations of string and Unicode " "objects (see section :ref:`string-methods`), :class:`UserString` instances " @@ -120099,22 +123027,22 @@ msgid "" msgstr "" # 3625221ae00f4e89b890c39d22e08efa -#: ../src/Doc/library/userdict.rst:215 +#: library/userdict.rst:215 msgid "" "A real Python string or Unicode object used to store the content of the :" "class:`UserString` class." msgstr "" -#: ../src/Doc/library/uu.rst:2 +#: library/uu.rst:2 msgid ":mod:`uu` --- Encode and decode uuencode files" msgstr "" # 4833ec7120484ddfae1b259dff593581 -#: ../src/Doc/library/uu.rst:8 +#: library/uu.rst:8 msgid "**Source code:** :source:`Lib/uu.py`" msgstr "" -#: ../src/Doc/library/uu.rst:12 +#: library/uu.rst:12 msgid "" "This module encodes and decodes files in uuencode format, allowing arbitrary " "binary data to be transferred over ASCII-only connections. Wherever a file " @@ -120126,17 +123054,17 @@ msgid "" "and be sure that, when required, the mode is ``'rb'`` or ``'wb'`` on Windows." msgstr "" -#: ../src/Doc/library/uu.rst:25 +#: library/uu.rst:25 msgid "" "This code was contributed by Lance Ellinghouse, and modified by Jack Jansen." msgstr "" -#: ../src/Doc/library/uu.rst:27 +#: library/uu.rst:27 msgid "The :mod:`uu` module defines the following functions:" msgstr "" # fe5a4e2bc480400082ae63e01492285d -#: ../src/Doc/library/uu.rst:32 +#: library/uu.rst:32 msgid "" "Uuencode file *in_file* into file *out_file*. The uuencoded file will have " "the header specifying *name* and *mode* as the defaults for the results of " @@ -120144,7 +123072,7 @@ msgid "" "and ``0666`` respectively." msgstr "" -#: ../src/Doc/library/uu.rst:40 +#: library/uu.rst:40 msgid "" "This call decodes uuencoded file *in_file* placing the result on file " "*out_file*. If *out_file* is a pathname, *mode* is used to set the " @@ -120153,25 +123081,25 @@ msgid "" "in the header already exists, a :exc:`uu.Error` is raised." msgstr "" -#: ../src/Doc/library/uu.rst:46 +#: library/uu.rst:46 msgid "" ":func:`decode` may print a warning to standard error if the input was " "produced by an incorrect uuencoder and Python could recover from that " "error. Setting *quiet* to a true value silences this warning." msgstr "" -#: ../src/Doc/library/uu.rst:53 +#: library/uu.rst:53 msgid "" "Subclass of :exc:`Exception`, this can be raised by :func:`uu.decode` under " "various situations, such as described above, but also including a badly " "formatted header, or truncated input file." msgstr "" -#: ../src/Doc/library/uuid.rst:3 +#: library/uuid.rst:3 msgid ":mod:`uuid` --- UUID objects according to RFC 4122" msgstr "" -#: ../src/Doc/library/uuid.rst:13 +#: library/uuid.rst:13 msgid "" "This module provides immutable :class:`UUID` objects (the :class:`UUID` " "class) and the functions :func:`uuid1`, :func:`uuid3`, :func:`uuid4`, :func:" @@ -120179,7 +123107,7 @@ msgid "" "`4122`." msgstr "" -#: ../src/Doc/library/uuid.rst:17 +#: library/uuid.rst:17 msgid "" "If all you want is a unique ID, you should probably call :func:`uuid1` or :" "func:`uuid4`. Note that :func:`uuid1` may compromise privacy since it " @@ -120187,7 +123115,7 @@ msgid "" "creates a random UUID." msgstr "" -#: ../src/Doc/library/uuid.rst:25 +#: library/uuid.rst:25 msgid "" "Create a UUID from either a string of 32 hexadecimal digits, a string of 16 " "bytes as the *bytes* argument, a string of 16 bytes in little-endian order " @@ -120199,7 +123127,7 @@ msgid "" "example, these expressions all yield the same UUID::" msgstr "" -#: ../src/Doc/library/uuid.rst:43 +#: library/uuid.rst:43 msgid "" "Exactly one of *hex*, *bytes*, *bytes_le*, *fields*, or *int* must be given. " "The *version* argument is optional; if given, the resulting UUID will have " @@ -120207,110 +123135,110 @@ msgid "" "the given *hex*, *bytes*, *bytes_le*, *fields*, or *int*." msgstr "" -#: ../src/Doc/library/uuid.rst:48 +#: library/uuid.rst:48 msgid ":class:`UUID` instances have these read-only attributes:" msgstr "" -#: ../src/Doc/library/uuid.rst:53 +#: library/uuid.rst:53 msgid "" "The UUID as a 16-byte string (containing the six integer fields in big-" "endian byte order)." msgstr "" -#: ../src/Doc/library/uuid.rst:59 +#: library/uuid.rst:59 msgid "" "The UUID as a 16-byte string (with *time_low*, *time_mid*, and " "*time_hi_version* in little-endian byte order)." msgstr "" -#: ../src/Doc/library/uuid.rst:65 +#: library/uuid.rst:65 msgid "" "A tuple of the six integer fields of the UUID, which are also available as " "six individual attributes and two derived attributes:" msgstr "" -#: ../src/Doc/library/uuid.rst:71 +#: library/uuid.rst:71 msgid ":attr:`time_low`" msgstr "" -#: ../src/Doc/library/uuid.rst:71 +#: library/uuid.rst:71 msgid "the first 32 bits of the UUID" msgstr "" -#: ../src/Doc/library/uuid.rst:73 +#: library/uuid.rst:73 msgid ":attr:`time_mid`" msgstr "" -#: ../src/Doc/library/uuid.rst:73 ../src/Doc/library/uuid.rst:75 +#: library/uuid.rst:73 library/uuid.rst:75 msgid "the next 16 bits of the UUID" msgstr "" -#: ../src/Doc/library/uuid.rst:75 +#: library/uuid.rst:75 msgid ":attr:`time_hi_version`" msgstr "" -#: ../src/Doc/library/uuid.rst:77 +#: library/uuid.rst:77 msgid ":attr:`clock_seq_hi_variant`" msgstr "" -#: ../src/Doc/library/uuid.rst:77 ../src/Doc/library/uuid.rst:79 +#: library/uuid.rst:77 library/uuid.rst:79 msgid "the next 8 bits of the UUID" msgstr "" -#: ../src/Doc/library/uuid.rst:79 +#: library/uuid.rst:79 msgid ":attr:`clock_seq_low`" msgstr "" -#: ../src/Doc/library/uuid.rst:81 +#: library/uuid.rst:81 msgid "the last 48 bits of the UUID" msgstr "" -#: ../src/Doc/library/uuid.rst:83 +#: library/uuid.rst:83 msgid ":attr:`time`" msgstr "" -#: ../src/Doc/library/uuid.rst:83 +#: library/uuid.rst:83 msgid "the 60-bit timestamp" msgstr "" -#: ../src/Doc/library/uuid.rst:85 +#: library/uuid.rst:85 msgid ":attr:`clock_seq`" msgstr "" -#: ../src/Doc/library/uuid.rst:85 +#: library/uuid.rst:85 msgid "the 14-bit sequence number" msgstr "" -#: ../src/Doc/library/uuid.rst:91 +#: library/uuid.rst:91 msgid "The UUID as a 32-character hexadecimal string." msgstr "" -#: ../src/Doc/library/uuid.rst:96 +#: library/uuid.rst:96 msgid "The UUID as a 128-bit integer." msgstr "" -#: ../src/Doc/library/uuid.rst:101 +#: library/uuid.rst:101 msgid "The UUID as a URN as specified in RFC 4122." msgstr "" -#: ../src/Doc/library/uuid.rst:106 +#: library/uuid.rst:106 msgid "" "The UUID variant, which determines the internal layout of the UUID. This " "will be one of the integer constants :const:`RESERVED_NCS`, :const:" "`RFC_4122`, :const:`RESERVED_MICROSOFT`, or :const:`RESERVED_FUTURE`." msgstr "" -#: ../src/Doc/library/uuid.rst:113 +#: library/uuid.rst:113 msgid "" "The UUID version number (1 through 5, meaningful only when the variant is :" "const:`RFC_4122`)." msgstr "" -#: ../src/Doc/library/uuid.rst:116 +#: library/uuid.rst:116 msgid "The :mod:`uuid` module defines the following functions:" msgstr "" -#: ../src/Doc/library/uuid.rst:121 +#: library/uuid.rst:121 msgid "" "Get the hardware address as a 48-bit positive integer. The first time this " "runs, it may launch a separate program, which could be quite slow. If all " @@ -120321,7 +123249,7 @@ msgid "" "returned." msgstr "" -#: ../src/Doc/library/uuid.rst:133 +#: library/uuid.rst:133 msgid "" "Generate a UUID from a host ID, sequence number, and the current time. If " "*node* is not given, :func:`getnode` is used to obtain the hardware address. " @@ -120329,95 +123257,94 @@ msgid "" "random 14-bit sequence number is chosen." msgstr "" -#: ../src/Doc/library/uuid.rst:143 +#: library/uuid.rst:143 msgid "" "Generate a UUID based on the MD5 hash of a namespace identifier (which is a " "UUID) and a name (which is a string)." msgstr "" -#: ../src/Doc/library/uuid.rst:151 +#: library/uuid.rst:151 msgid "Generate a random UUID." msgstr "" -#: ../src/Doc/library/uuid.rst:158 +#: library/uuid.rst:158 msgid "" "Generate a UUID based on the SHA-1 hash of a namespace identifier (which is " "a UUID) and a name (which is a string)." msgstr "" -#: ../src/Doc/library/uuid.rst:163 +#: library/uuid.rst:163 msgid "" "The :mod:`uuid` module defines the following namespace identifiers for use " "with :func:`uuid3` or :func:`uuid5`." msgstr "" -#: ../src/Doc/library/uuid.rst:169 +#: library/uuid.rst:169 msgid "" "When this namespace is specified, the *name* string is a fully-qualified " "domain name." msgstr "" -#: ../src/Doc/library/uuid.rst:175 +#: library/uuid.rst:175 msgid "When this namespace is specified, the *name* string is a URL." msgstr "" -#: ../src/Doc/library/uuid.rst:180 +#: library/uuid.rst:180 msgid "When this namespace is specified, the *name* string is an ISO OID." msgstr "" -#: ../src/Doc/library/uuid.rst:185 +#: library/uuid.rst:185 msgid "" "When this namespace is specified, the *name* string is an X.500 DN in DER or " "a text output format." msgstr "" -#: ../src/Doc/library/uuid.rst:188 +#: library/uuid.rst:188 msgid "" "The :mod:`uuid` module defines the following constants for the possible " "values of the :attr:`variant` attribute:" msgstr "" -#: ../src/Doc/library/uuid.rst:194 +#: library/uuid.rst:194 msgid "Reserved for NCS compatibility." msgstr "" -#: ../src/Doc/library/uuid.rst:199 +#: library/uuid.rst:199 msgid "Specifies the UUID layout given in :rfc:`4122`." msgstr "" -#: ../src/Doc/library/uuid.rst:204 +#: library/uuid.rst:204 msgid "Reserved for Microsoft compatibility." msgstr "" -#: ../src/Doc/library/uuid.rst:209 +#: library/uuid.rst:209 msgid "Reserved for future definition." msgstr "" -# ece934a7c8d541349d35e5d6e049a2f1 -#: ../src/Doc/library/uuid.rst:214 -msgid ":rfc:`4122` - A Universally Unique IDentifier (UUID) URN Namespace" +#: library/uuid.rst:215 +msgid "RFC 4122 - A Universally Unique IDentifier (UUID) URN Namespace" msgstr "" -#: ../src/Doc/library/uuid.rst:215 +#: library/uuid.rst:215 msgid "" "This specification defines a Uniform Resource Name namespace for UUIDs, the " "internal format of UUIDs, and methods of generating UUIDs." msgstr "" -#: ../src/Doc/library/uuid.rst:224 +#: library/uuid.rst:224 msgid "Here are some examples of typical usage of the :mod:`uuid` module::" msgstr "" -#: ../src/Doc/library/warnings.rst:2 +#: library/warnings.rst:2 msgid ":mod:`warnings` --- Warning control" msgstr "" # 37acc65e844b4dcfbf82cd2b627b26ff -#: ../src/Doc/library/warnings.rst:12 +#: library/warnings.rst:12 msgid "**Source code:** :source:`Lib/warnings.py`" msgstr "" -#: ../src/Doc/library/warnings.rst:16 +#: library/warnings.rst:16 msgid "" "Warning messages are typically issued in situations where it is useful to " "alert the user of some condition in a program, where that condition " @@ -120427,14 +123354,14 @@ msgid "" msgstr "" # 92b5f21d04994e9aa6755807118acfcc -#: ../src/Doc/library/warnings.rst:21 +#: library/warnings.rst:21 msgid "" "Python programmers issue warnings by calling the :func:`warn` function " "defined in this module. (C programmers use :c:func:`PyErr_WarnEx`; see :ref:" "`exceptionhandling` for details)." msgstr "" -#: ../src/Doc/library/warnings.rst:25 +#: library/warnings.rst:25 msgid "" "Warning messages are normally written to ``sys.stderr``, but their " "disposition can be changed flexibly, from ignoring all warnings to turning " @@ -120444,7 +123371,7 @@ msgid "" "the same source location are typically suppressed." msgstr "" -#: ../src/Doc/library/warnings.rst:32 +#: library/warnings.rst:32 msgid "" "There are two stages in warning control: first, each time a warning is " "issued, a determination is made whether a message should be issued or not; " @@ -120452,7 +123379,7 @@ msgid "" "settable hook." msgstr "" -#: ../src/Doc/library/warnings.rst:36 +#: library/warnings.rst:36 msgid "" "The determination whether to issue a warning message is controlled by the " "warning filter, which is a sequence of matching rules and actions. Rules can " @@ -120460,7 +123387,7 @@ msgid "" "default state by calling :func:`resetwarnings`." msgstr "" -#: ../src/Doc/library/warnings.rst:41 +#: library/warnings.rst:41 msgid "" "The printing of warning messages is done by calling :func:`showwarning`, " "which may be overridden; the default implementation of this function formats " @@ -120468,126 +123395,136 @@ msgid "" "use by custom implementations." msgstr "" -#: ../src/Doc/library/warnings.rst:54 +#: library/warnings.rst:47 +msgid "" +":func:`logging.captureWarnings` allows you to handle all warnings with the " +"standard logging infrastructure." +msgstr "" + +#: library/warnings.rst:54 msgid "Warning Categories" msgstr "" -#: ../src/Doc/library/warnings.rst:56 +#: library/warnings.rst:56 msgid "" "There are a number of built-in exceptions that represent warning categories. " "This categorization is useful to be able to filter out groups of warnings. " "The following warnings category classes are currently defined:" msgstr "" -#: ../src/Doc/library/warnings.rst:63 +#: library/warnings.rst:63 msgid "Class" msgstr "" -#: ../src/Doc/library/warnings.rst:65 +#: library/warnings.rst:65 msgid ":exc:`Warning`" msgstr "" -#: ../src/Doc/library/warnings.rst:65 +#: library/warnings.rst:65 msgid "" "This is the base class of all warning category classes. It is a subclass " "of :exc:`Exception`." msgstr "" -#: ../src/Doc/library/warnings.rst:69 +#: library/warnings.rst:69 msgid ":exc:`UserWarning`" msgstr "" -#: ../src/Doc/library/warnings.rst:69 +#: library/warnings.rst:69 msgid "The default category for :func:`warn`." msgstr "" -#: ../src/Doc/library/warnings.rst:71 +#: library/warnings.rst:71 msgid ":exc:`DeprecationWarning`" msgstr "" -#: ../src/Doc/library/warnings.rst:71 +#: library/warnings.rst:71 msgid "" "Base category for warnings about deprecated features (ignored by default)." msgstr "" -#: ../src/Doc/library/warnings.rst:74 +#: library/warnings.rst:74 msgid ":exc:`SyntaxWarning`" msgstr "" -#: ../src/Doc/library/warnings.rst:74 +#: library/warnings.rst:74 msgid "Base category for warnings about dubious syntactic features." msgstr "" -#: ../src/Doc/library/warnings.rst:77 +#: library/warnings.rst:77 msgid ":exc:`RuntimeWarning`" msgstr "" -#: ../src/Doc/library/warnings.rst:77 +#: library/warnings.rst:77 msgid "Base category for warnings about dubious runtime features." msgstr "" -#: ../src/Doc/library/warnings.rst:80 +#: library/warnings.rst:80 msgid ":exc:`FutureWarning`" msgstr "" -#: ../src/Doc/library/warnings.rst:80 +#: library/warnings.rst:80 msgid "" "Base category for warnings about constructs that will change semantically in " "the future." msgstr "" -#: ../src/Doc/library/warnings.rst:83 +#: library/warnings.rst:83 msgid ":exc:`PendingDeprecationWarning`" msgstr "" -#: ../src/Doc/library/warnings.rst:83 +#: library/warnings.rst:83 msgid "" "Base category for warnings about features that will be deprecated in the " "future (ignored by default)." msgstr "" -#: ../src/Doc/library/warnings.rst:87 +#: library/warnings.rst:87 msgid ":exc:`ImportWarning`" msgstr "" -#: ../src/Doc/library/warnings.rst:87 +#: library/warnings.rst:87 msgid "" "Base category for warnings triggered during the process of importing a " "module (ignored by default)." msgstr "" -#: ../src/Doc/library/warnings.rst:91 +#: library/warnings.rst:91 msgid ":exc:`UnicodeWarning`" msgstr "" -#: ../src/Doc/library/warnings.rst:91 +#: library/warnings.rst:91 msgid "Base category for warnings related to Unicode." msgstr "" -#: ../src/Doc/library/warnings.rst:95 +#: library/warnings.rst:95 msgid "" "While these are technically built-in exceptions, they are documented here, " "because conceptually they belong to the warnings mechanism." msgstr "" -#: ../src/Doc/library/warnings.rst:98 +#: library/warnings.rst:98 msgid "" "User code can define additional warning categories by subclassing one of the " "standard warning categories. A warning category must always be a subclass " "of the :exc:`Warning` class." msgstr "" -#: ../src/Doc/library/warnings.rst:109 +#: library/warnings.rst:102 +msgid ":exc:`DeprecationWarning` is ignored by default." +msgstr "" + +#: library/warnings.rst:109 msgid "The Warnings Filter" msgstr "" -#: ../src/Doc/library/warnings.rst:111 +#: library/warnings.rst:111 msgid "" "The warnings filter controls whether warnings are ignored, displayed, or " "turned into errors (raising an exception)." msgstr "" -#: ../src/Doc/library/warnings.rst:114 +#: library/warnings.rst:114 msgid "" "Conceptually, the warnings filter maintains an ordered list of filter " "specifications; any specific warning is matched against each filter " @@ -120596,98 +123533,98 @@ msgid "" "(*action*, *message*, *category*, *module*, *lineno*), where:" msgstr "" -#: ../src/Doc/library/warnings.rst:120 +#: library/warnings.rst:120 msgid "*action* is one of the following strings:" msgstr "" -#: ../src/Doc/library/warnings.rst:123 +#: library/warnings.rst:123 msgid "Disposition" msgstr "" -#: ../src/Doc/library/warnings.rst:125 +#: library/warnings.rst:125 msgid "``\"error\"``" msgstr "" -#: ../src/Doc/library/warnings.rst:125 +#: library/warnings.rst:125 msgid "turn matching warnings into exceptions" msgstr "" -#: ../src/Doc/library/warnings.rst:127 +#: library/warnings.rst:127 msgid "``\"ignore\"``" msgstr "" -#: ../src/Doc/library/warnings.rst:127 +#: library/warnings.rst:127 msgid "never print matching warnings" msgstr "" -#: ../src/Doc/library/warnings.rst:129 +#: library/warnings.rst:129 msgid "``\"always\"``" msgstr "" -#: ../src/Doc/library/warnings.rst:129 +#: library/warnings.rst:129 msgid "always print matching warnings" msgstr "" -#: ../src/Doc/library/warnings.rst:131 +#: library/warnings.rst:131 msgid "``\"default\"``" msgstr "" -#: ../src/Doc/library/warnings.rst:131 +#: library/warnings.rst:131 msgid "" "print the first occurrence of matching warnings for each location where the " "warning is issued" msgstr "" -#: ../src/Doc/library/warnings.rst:135 +#: library/warnings.rst:135 msgid "``\"module\"``" msgstr "" -#: ../src/Doc/library/warnings.rst:135 +#: library/warnings.rst:135 msgid "" "print the first occurrence of matching warnings for each module where the " "warning is issued" msgstr "" -#: ../src/Doc/library/warnings.rst:139 +#: library/warnings.rst:139 msgid "``\"once\"``" msgstr "" -#: ../src/Doc/library/warnings.rst:139 +#: library/warnings.rst:139 msgid "" "print only the first occurrence of matching warnings, regardless of location" msgstr "" -#: ../src/Doc/library/warnings.rst:143 +#: library/warnings.rst:143 msgid "" "*message* is a string containing a regular expression that the warning " "message must match (the match is compiled to always be case-insensitive)." msgstr "" -#: ../src/Doc/library/warnings.rst:146 +#: library/warnings.rst:146 msgid "" "*category* is a class (a subclass of :exc:`Warning`) of which the warning " "category must be a subclass in order to match." msgstr "" -#: ../src/Doc/library/warnings.rst:149 +#: library/warnings.rst:149 msgid "" "*module* is a string containing a regular expression that the module name " "must match (the match is compiled to be case-sensitive)." msgstr "" -#: ../src/Doc/library/warnings.rst:152 +#: library/warnings.rst:152 msgid "" "*lineno* is an integer that the line number where the warning occurred must " "match, or ``0`` to match all line numbers." msgstr "" -#: ../src/Doc/library/warnings.rst:155 +#: library/warnings.rst:155 msgid "" "Since the :exc:`Warning` class is derived from the built-in :exc:`Exception` " "class, to turn a warning into an error we simply raise ``category(message)``." msgstr "" -#: ../src/Doc/library/warnings.rst:158 +#: library/warnings.rst:158 msgid "" "The warnings filter is initialized by :option:`-W` options passed to the " "Python interpreter command line. The interpreter saves the arguments for " @@ -120697,12 +123634,12 @@ msgid "" msgstr "" # caec9dcda8904e699da08010adb5f2a6 -#: ../src/Doc/library/warnings.rst:166 +#: library/warnings.rst:166 msgid "Default Warning Filters" msgstr "" # 8def5aa56930432283bf2db5f1c65601 -#: ../src/Doc/library/warnings.rst:168 +#: library/warnings.rst:168 msgid "" "By default, Python installs several warning filters, which can be overridden " "by the command-line options passed to :option:`-W` and calls to :func:" @@ -120710,32 +123647,32 @@ msgid "" msgstr "" # 4baa66d150584bcf81f168c069fd7e8f -#: ../src/Doc/library/warnings.rst:172 +#: library/warnings.rst:172 msgid "" ":exc:`DeprecationWarning` and :exc:`PendingDeprecationWarning`, and :exc:" "`ImportWarning` are ignored." msgstr "" # 06c1bee08137486f9fd2371694f99b48 -#: ../src/Doc/library/warnings.rst:175 +#: library/warnings.rst:175 msgid "" ":exc:`BytesWarning` is ignored unless the :option:`-b` option is given once " "or twice; in this case this warning is either printed (``-b``) or turned " "into an exception (``-bb``)." msgstr "" -#: ../src/Doc/library/warnings.rst:183 +#: library/warnings.rst:183 msgid "Temporarily Suppressing Warnings" msgstr "" -#: ../src/Doc/library/warnings.rst:185 +#: library/warnings.rst:185 msgid "" "If you are using code that you know will raise a warning, such as a " "deprecated function, but do not want to see the warning, then it is possible " "to suppress the warning using the :class:`catch_warnings` context manager::" msgstr "" -#: ../src/Doc/library/warnings.rst:198 +#: library/warnings.rst:198 msgid "" "While within the context manager all warnings will simply be ignored. This " "allows you to use known-deprecated code without having to see the warning " @@ -120745,11 +123682,11 @@ msgid "" "context manager at the same time, the behavior is undefined." msgstr "" -#: ../src/Doc/library/warnings.rst:210 +#: library/warnings.rst:210 msgid "Testing Warnings" msgstr "" -#: ../src/Doc/library/warnings.rst:212 +#: library/warnings.rst:212 msgid "" "To test warnings raised by code, use the :class:`catch_warnings` context " "manager. With it you can temporarily mutate the warnings filter to " @@ -120757,7 +123694,7 @@ msgid "" "raised warnings to check::" msgstr "" -#: ../src/Doc/library/warnings.rst:232 +#: library/warnings.rst:232 msgid "" "One can also cause all warnings to be exceptions by using ``error`` instead " "of ``always``. One thing to be aware of is that if a warning has already " @@ -120766,7 +123703,7 @@ msgid "" "registry related to the warning has been cleared." msgstr "" -#: ../src/Doc/library/warnings.rst:238 +#: library/warnings.rst:238 msgid "" "Once the context manager exits, the warnings filter is restored to its state " "when the context was entered. This prevents tests from changing the warnings " @@ -120777,7 +123714,7 @@ msgid "" "manager at the same time, the behavior is undefined." msgstr "" -#: ../src/Doc/library/warnings.rst:246 +#: library/warnings.rst:246 msgid "" "When testing multiple operations that raise the same kind of warning, it is " "important to test them in a manner that confirms each operation is raising a " @@ -120787,11 +123724,11 @@ msgid "" "entries from the warnings list before each new operation)." msgstr "" -#: ../src/Doc/library/warnings.rst:255 +#: library/warnings.rst:255 msgid "Updating Code For New Versions of Python" msgstr "" -#: ../src/Doc/library/warnings.rst:257 +#: library/warnings.rst:257 msgid "" "Warnings that are only of interest to the developer are ignored by default. " "As such you should make sure to test your code with typically ignored " @@ -120804,18 +123741,18 @@ msgid "" "possible." msgstr "" -#: ../src/Doc/library/warnings.rst:266 +#: library/warnings.rst:266 msgid "To programmatically do the same as :option:`-Wd`, use::" msgstr "" -#: ../src/Doc/library/warnings.rst:270 +#: library/warnings.rst:270 msgid "" "Make sure to execute this code as soon as possible. This prevents the " "registering of what warnings have been raised from unexpectedly influencing " "how future warnings are treated." msgstr "" -#: ../src/Doc/library/warnings.rst:274 +#: library/warnings.rst:274 msgid "" "Having certain warnings ignored by default is done to prevent a user from " "seeing warnings that are only of interest to the developer. As you do not " @@ -120829,11 +123766,11 @@ msgid "" "them." msgstr "" -#: ../src/Doc/library/warnings.rst:288 +#: library/warnings.rst:288 msgid "Available Functions" msgstr "" -#: ../src/Doc/library/warnings.rst:293 +#: library/warnings.rst:293 msgid "" "Issue a warning, or maybe ignore it or raise an exception. The *category* " "argument, if given, must be a warning category class (see above); it " @@ -120846,14 +123783,14 @@ msgid "" "Python, like this::" msgstr "" -#: ../src/Doc/library/warnings.rst:305 +#: library/warnings.rst:305 msgid "" "This makes the warning refer to :func:`deprecation`'s caller, rather than to " "the source of :func:`deprecation` itself (since the latter would defeat the " "purpose of the warning message)." msgstr "" -#: ../src/Doc/library/warnings.rst:312 +#: library/warnings.rst:312 msgid "" "This is a low-level interface to the functionality of :func:`warn`, passing " "in explicitly the message, category, filename and line number, and " @@ -120865,7 +123802,7 @@ msgid "" "case *category* will be ignored." msgstr "" -#: ../src/Doc/library/warnings.rst:321 +#: library/warnings.rst:321 msgid "" "*module_globals*, if supplied, should be the global namespace in use by the " "code for which the warning is issued. (This argument is used to support " @@ -120873,8 +123810,12 @@ msgid "" "import sources)." msgstr "" +#: library/warnings.rst:326 +msgid "Added the *module_globals* parameter." +msgstr "" + # ea82b85182a74c1a9c140c8cef815373 -#: ../src/Doc/library/warnings.rst:332 +#: library/warnings.rst:332 msgid "" "Issue a warning related to Python 3.x deprecation. Warnings are only shown " "when Python is started with the -3 option. Like :func:`warn` *message* must " @@ -120882,7 +123823,7 @@ msgid "" "using :exc:`DeprecationWarning` as default warning class." msgstr "" -#: ../src/Doc/library/warnings.rst:342 +#: library/warnings.rst:342 msgid "" "Write a warning to a file. The default implementation calls " "``formatwarning(message, category, filename, lineno, line)`` and writes the " @@ -120893,7 +123834,11 @@ msgid "" "to read the line specified by *filename* and *lineno*." msgstr "" -#: ../src/Doc/library/warnings.rst:357 +#: library/warnings.rst:351 +msgid "The *line* argument is required to be supported." +msgstr "" + +#: library/warnings.rst:357 msgid "" "Format a warning the standard way. This returns a string which may contain " "embedded newlines and ends in a newline. *line* is a line of source code to " @@ -120902,7 +123847,11 @@ msgid "" "*lineno*." msgstr "" -#: ../src/Doc/library/warnings.rst:369 +#: library/warnings.rst:363 +msgid "Added the *line* argument." +msgstr "" + +#: library/warnings.rst:369 msgid "" "Insert an entry into the list of :ref:`warnings filter specifications " "<warning-filter>`. The entry is inserted at the front by default; if " @@ -120914,7 +123863,7 @@ msgid "" "everything." msgstr "" -#: ../src/Doc/library/warnings.rst:381 +#: library/warnings.rst:381 msgid "" "Insert a simple entry into the list of :ref:`warnings filter specifications " "<warning-filter>`. The meaning of the function parameters is as for :func:" @@ -120923,18 +123872,18 @@ msgid "" "and line number match." msgstr "" -#: ../src/Doc/library/warnings.rst:390 +#: library/warnings.rst:390 msgid "" "Reset the warnings filter. This discards the effect of all previous calls " "to :func:`filterwarnings`, including that of the :option:`-W` command line " "options and calls to :func:`simplefilter`." msgstr "" -#: ../src/Doc/library/warnings.rst:396 +#: library/warnings.rst:396 msgid "Available Context Managers" msgstr "" -#: ../src/Doc/library/warnings.rst:400 +#: library/warnings.rst:400 msgid "" "A context manager that copies and, upon exit, restores the warnings filter " "and the :func:`showwarning` function. If the *record* argument is :const:" @@ -120945,14 +123894,14 @@ msgid "" "has attributes with the same names as the arguments to :func:`showwarning`." msgstr "" -#: ../src/Doc/library/warnings.rst:409 +#: library/warnings.rst:409 msgid "" "The *module* argument takes a module that will be used instead of the module " "returned when you import :mod:`warnings` whose filter will be protected. " "This argument exists primarily for testing the :mod:`warnings` module itself." msgstr "" -#: ../src/Doc/library/warnings.rst:416 +#: library/warnings.rst:416 msgid "" "The :class:`catch_warnings` manager works by replacing and then later " "restoring the module's :func:`showwarning` function and internal list of " @@ -120961,55 +123910,53 @@ msgid "" msgstr "" # a32395daf02348ce94298cb26df04a0f -#: ../src/Doc/library/warnings.rst:424 +#: library/warnings.rst:424 msgid "" "In Python 3, the arguments to the constructor for :class:`catch_warnings` " "are keyword-only arguments." msgstr "" -#: ../src/Doc/library/wave.rst:2 +#: library/wave.rst:2 msgid ":mod:`wave` --- Read and write WAV files" msgstr "" # eb679aa805d442b88ebdedc5d89da199 -#: ../src/Doc/library/wave.rst:9 +#: library/wave.rst:9 msgid "**Source code:** :source:`Lib/wave.py`" msgstr "" -#: ../src/Doc/library/wave.rst:13 +#: library/wave.rst:13 msgid "" "The :mod:`wave` module provides a convenient interface to the WAV sound " "format. It does not support compression/decompression, but it does support " "mono/stereo." msgstr "" -#: ../src/Doc/library/wave.rst:16 +#: library/wave.rst:16 msgid "The :mod:`wave` module defines the following function and exception:" msgstr "" # 7c88597c273840fdbec9c8d2f248287b -#: ../src/Doc/library/wave.rst:21 +#: library/wave.rst:21 msgid "" "If *file* is a string, open the file by that name, otherwise treat it as a " "seekable file-like object. *mode* can be any of" msgstr "" -# c6bffe0b4308422cbc4f6b379153a2eb -#: ../src/Doc/library/wave.rst:24 -msgid "``'r'``, ``'rb'``" +#: library/wave.rst:25 +msgid "'r', 'rb'" msgstr "" -# 8d7d8210929947109105bc79fc8f0ad4 -#: ../src/Doc/library/wave.rst:27 -msgid "``'w'``, ``'wb'``" +#: library/wave.rst:28 +msgid "'w', 'wb'" msgstr "" -#: ../src/Doc/library/wave.rst:30 +#: library/wave.rst:30 msgid "Note that it does not allow read/write WAV files." msgstr "" # bb2729c912014a53be87394084f72222 -#: ../src/Doc/library/wave.rst:32 +#: library/wave.rst:32 msgid "" "A *mode* of ``'r'`` or ``'rb'`` returns a :class:`Wave_read` object, while a " "*mode* of ``'w'`` or ``'wb'`` returns a :class:`Wave_write` object. If " @@ -121019,145 +123966,145 @@ msgid "" msgstr "" # 3eedc1c3b63b4140800da3aa38642255 -#: ../src/Doc/library/wave.rst:38 +#: library/wave.rst:38 msgid "" "If you pass in a file-like object, the wave object will not close it when " "its :meth:`close` method is called; it is the caller's responsibility to " "close the file object." msgstr "" -#: ../src/Doc/library/wave.rst:50 +#: library/wave.rst:50 msgid "" "An error raised when something is impossible because it violates the WAV " "specification or hits an implementation deficiency." msgstr "" -#: ../src/Doc/library/wave.rst:57 +#: library/wave.rst:57 msgid "Wave_read Objects" msgstr "" -#: ../src/Doc/library/wave.rst:59 +#: library/wave.rst:59 msgid "" "Wave_read objects, as returned by :func:`.open`, have the following methods:" msgstr "" # 703f8ebdb07b42a98e0465005f826665 -#: ../src/Doc/library/wave.rst:64 +#: library/wave.rst:64 msgid "" "Close the stream if it was opened by :mod:`wave`, and make the instance " "unusable. This is called automatically on object collection." msgstr "" -#: ../src/Doc/library/wave.rst:70 +#: library/wave.rst:70 msgid "Returns number of audio channels (``1`` for mono, ``2`` for stereo)." msgstr "" -#: ../src/Doc/library/wave.rst:90 +#: library/wave.rst:90 msgid "Returns compression type (``'NONE'`` is the only supported type)." msgstr "" -#: ../src/Doc/library/wave.rst:95 +#: library/wave.rst:95 msgid "" "Human-readable version of :meth:`getcomptype`. Usually ``'not compressed'`` " "parallels ``'NONE'``." msgstr "" -#: ../src/Doc/library/wave.rst:107 +#: library/wave.rst:107 msgid "Reads and returns at most *n* frames of audio, as a string of bytes." msgstr "" -#: ../src/Doc/library/wave.rst:114 +#: library/wave.rst:114 msgid "" "The following two methods are defined for compatibility with the :mod:`aifc` " "module, and don't do anything interesting." msgstr "" -#: ../src/Doc/library/wave.rst:133 +#: library/wave.rst:133 msgid "Set the file pointer to the specified position." msgstr "" -#: ../src/Doc/library/wave.rst:138 +#: library/wave.rst:138 msgid "Return current file pointer position." msgstr "" -#: ../src/Doc/library/wave.rst:144 +#: library/wave.rst:144 msgid "Wave_write Objects" msgstr "" -#: ../src/Doc/library/wave.rst:146 +#: library/wave.rst:146 msgid "" "Wave_write objects, as returned by :func:`.open`, have the following methods:" msgstr "" # f5cc98047db44afd89ed2b78b2dd0bb8 -#: ../src/Doc/library/wave.rst:151 +#: library/wave.rst:151 msgid "" "Make sure *nframes* is correct, and close the file if it was opened by :mod:" "`wave`. This method is called upon object collection." msgstr "" -#: ../src/Doc/library/wave.rst:162 +#: library/wave.rst:162 msgid "Set the sample width to *n* bytes." msgstr "" -#: ../src/Doc/library/wave.rst:167 +#: library/wave.rst:167 msgid "Set the frame rate to *n*." msgstr "" -#: ../src/Doc/library/wave.rst:172 +#: library/wave.rst:172 msgid "" "Set the number of frames to *n*. This will be changed later if more frames " "are written." msgstr "" -#: ../src/Doc/library/wave.rst:178 +#: library/wave.rst:178 msgid "" "Set the compression type and description. At the moment, only compression " "type ``NONE`` is supported, meaning no compression." msgstr "" -#: ../src/Doc/library/wave.rst:184 +#: library/wave.rst:184 msgid "" "The *tuple* should be ``(nchannels, sampwidth, framerate, nframes, comptype, " "compname)``, with values valid for the :meth:`set\\*` methods. Sets all " "parameters." msgstr "" -#: ../src/Doc/library/wave.rst:191 +#: library/wave.rst:191 msgid "" "Return current position in the file, with the same disclaimer for the :meth:" "`Wave_read.tell` and :meth:`Wave_read.setpos` methods." msgstr "" -#: ../src/Doc/library/wave.rst:205 +#: library/wave.rst:205 msgid "" "Note that it is invalid to set any parameters after calling :meth:" "`writeframes` or :meth:`writeframesraw`, and any attempt to do so will " "raise :exc:`wave.Error`." msgstr "" -#: ../src/Doc/library/weakref.rst:2 +#: library/weakref.rst:2 msgid ":mod:`weakref` --- Weak references" msgstr "" # ba89334dc71a4bdbba4df7c031c3bf3e -#: ../src/Doc/library/weakref.rst:14 +#: library/weakref.rst:14 msgid "**Source code:** :source:`Lib/weakref.py`" msgstr "" -#: ../src/Doc/library/weakref.rst:18 +#: library/weakref.rst:18 msgid "" "The :mod:`weakref` module allows the Python programmer to create :dfn:`weak " "references` to objects." msgstr "" -#: ../src/Doc/library/weakref.rst:24 +#: library/weakref.rst:24 msgid "" "In the following, the term :dfn:`referent` means the object which is " "referred to by a weak reference." msgstr "" -#: ../src/Doc/library/weakref.rst:27 +#: library/weakref.rst:27 msgid "" "A weak reference to an object is not enough to keep the object alive: when " "the only remaining references to a referent are weak references, :term:" @@ -121167,7 +124114,7 @@ msgid "" "object not be kept alive solely because it appears in a cache or mapping." msgstr "" -#: ../src/Doc/library/weakref.rst:34 +#: library/weakref.rst:34 msgid "" "For example, if you have a number of large binary image objects, you may " "wish to associate a name with each. If you used a Python dictionary to map " @@ -121184,7 +124131,7 @@ msgid "" msgstr "" # 034f65a20e714f8ea47fa60917884e3a -#: ../src/Doc/library/weakref.rst:47 +#: library/weakref.rst:47 msgid "" ":class:`WeakKeyDictionary` and :class:`WeakValueDictionary` use weak " "references in their implementation, setting up callback functions on the " @@ -121197,7 +124144,7 @@ msgid "" msgstr "" # e9e49f55fef348bbb250f94497da4800 -#: ../src/Doc/library/weakref.rst:56 +#: library/weakref.rst:56 msgid "" "Not all objects can be weakly referenced; those objects which can include " "class instances, functions written in Python (but not in C), methods (both " @@ -121207,26 +124154,34 @@ msgid "" "objects." msgstr "" -#: ../src/Doc/library/weakref.rst:68 +#: library/weakref.rst:62 +msgid "Added support for files, sockets, arrays, and patterns." +msgstr "" + +#: library/weakref.rst:65 +msgid "Added support for thread.lock, threading.Lock, and code objects." +msgstr "" + +#: library/weakref.rst:68 msgid "" "Several built-in types such as :class:`list` and :class:`dict` do not " "directly support weak references but can add support through subclassing::" msgstr "" # f0c886e7eef14f83860470b741994ef8 -#: ../src/Doc/library/weakref.rst:78 +#: library/weakref.rst:78 msgid "" "Other built-in types such as :class:`tuple` and :class:`long` do not support " "weak references even when subclassed." msgstr "" -#: ../src/Doc/library/weakref.rst:81 +#: library/weakref.rst:81 msgid "" "Extension types can easily be made to support weak references; see :ref:" "`weakref-support`." msgstr "" -#: ../src/Doc/library/weakref.rst:87 +#: library/weakref.rst:87 msgid "" "Return a weak reference to *object*. The original object can be retrieved " "by calling the reference object if the referent is still alive; if the " @@ -121238,21 +124193,21 @@ msgid "" "available." msgstr "" -#: ../src/Doc/library/weakref.rst:95 +#: library/weakref.rst:95 msgid "" "It is allowable for many weak references to be constructed for the same " "object. Callbacks registered for each weak reference will be called from the " "most recently registered callback to the oldest registered callback." msgstr "" -#: ../src/Doc/library/weakref.rst:99 +#: library/weakref.rst:99 msgid "" "Exceptions raised by the callback will be noted on the standard error " "output, but cannot be propagated; they are handled in exactly the same way " "as exceptions raised from an object's :meth:`__del__` method." msgstr "" -#: ../src/Doc/library/weakref.rst:103 +#: library/weakref.rst:103 msgid "" "Weak references are :term:`hashable` if the *object* is hashable. They will " "maintain their hash value even after the *object* was deleted. If :func:" @@ -121260,7 +124215,7 @@ msgid "" "call will raise :exc:`TypeError`." msgstr "" -#: ../src/Doc/library/weakref.rst:108 +#: library/weakref.rst:108 msgid "" "Weak references support tests for equality, but not ordering. If the " "referents are still alive, two references have the same equality " @@ -121269,7 +124224,13 @@ msgid "" "objects are the same object." msgstr "" -#: ../src/Doc/library/weakref.rst:120 +#: library/weakref.rst:113 +msgid "" +"This is now a subclassable type rather than a factory function; it derives " +"from :class:`object`." +msgstr "" + +#: library/weakref.rst:120 msgid "" "Return a proxy to *object* which uses a weak reference. This supports use " "of the proxy in most contexts instead of requiring the explicit " @@ -121282,18 +124243,18 @@ msgid "" "`ref` function." msgstr "" -#: ../src/Doc/library/weakref.rst:132 +#: library/weakref.rst:132 msgid "" "Return the number of weak references and proxies which refer to *object*." msgstr "" -#: ../src/Doc/library/weakref.rst:137 +#: library/weakref.rst:137 msgid "" "Return a list of all weak reference and proxy objects which refer to " "*object*." msgstr "" -#: ../src/Doc/library/weakref.rst:142 +#: library/weakref.rst:142 msgid "" "Mapping class that references keys weakly. Entries in the dictionary will " "be discarded when there is no longer a strong reference to the key. This " @@ -121302,7 +124263,7 @@ msgid "" "especially useful with objects that override attribute accesses." msgstr "" -#: ../src/Doc/library/weakref.rst:150 +#: library/weakref.rst:150 msgid "" "Caution: Because a :class:`WeakKeyDictionary` is built on top of a Python " "dictionary, it must not change size when iterating over it. This can be " @@ -121311,7 +124272,7 @@ msgid "" "to vanish \"by magic\" (as a side effect of garbage collection)." msgstr "" -#: ../src/Doc/library/weakref.rst:156 +#: library/weakref.rst:156 msgid "" ":class:`WeakKeyDictionary` objects have the following additional methods. " "These expose the internal references directly. The references are not " @@ -121322,22 +124283,22 @@ msgid "" msgstr "" # bbadfa3a8ebb45ed874cd758ed76c998 -#: ../src/Doc/library/weakref.rst:166 +#: library/weakref.rst:166 msgid "Return an iterable of the weak references to the keys." msgstr "" # bbadfa3a8ebb45ed874cd758ed76c998 -#: ../src/Doc/library/weakref.rst:173 +#: library/weakref.rst:173 msgid "Return a list of weak references to the keys." msgstr "" -#: ../src/Doc/library/weakref.rst:180 +#: library/weakref.rst:180 msgid "" "Mapping class that references values weakly. Entries in the dictionary will " "be discarded when no strong reference to the value exists any more." msgstr "" -#: ../src/Doc/library/weakref.rst:185 +#: library/weakref.rst:185 msgid "" "Caution: Because a :class:`WeakValueDictionary` is built on top of a Python " "dictionary, it must not change size when iterating over it. This can be " @@ -121347,7 +124308,7 @@ msgid "" msgstr "" # e653c985ca274fd58567d16306a3608f -#: ../src/Doc/library/weakref.rst:191 +#: library/weakref.rst:191 msgid "" ":class:`WeakValueDictionary` objects have the following additional methods. " "These method have the same issues as the :meth:`iterkeyrefs` and :meth:" @@ -121355,82 +124316,81 @@ msgid "" msgstr "" # 8a6b37be01c04db1ae15a3a30e9019be -#: ../src/Doc/library/weakref.rst:198 +#: library/weakref.rst:198 msgid "Return an iterable of the weak references to the values." msgstr "" # 8a6b37be01c04db1ae15a3a30e9019be -#: ../src/Doc/library/weakref.rst:205 +#: library/weakref.rst:205 msgid "Return a list of weak references to the values." msgstr "" -#: ../src/Doc/library/weakref.rst:212 +#: library/weakref.rst:212 msgid "" "Set class that keeps weak references to its elements. An element will be " "discarded when no strong reference to it exists any more." msgstr "" -#: ../src/Doc/library/weakref.rst:220 +#: library/weakref.rst:220 msgid "The type object for weak references objects." msgstr "" -#: ../src/Doc/library/weakref.rst:225 +#: library/weakref.rst:225 msgid "The type object for proxies of objects which are not callable." msgstr "" -#: ../src/Doc/library/weakref.rst:230 +#: library/weakref.rst:230 msgid "The type object for proxies of callable objects." msgstr "" -#: ../src/Doc/library/weakref.rst:235 +#: library/weakref.rst:235 msgid "" "Sequence containing all the type objects for proxies. This can make it " "simpler to test if an object is a proxy without being dependent on naming " "both proxy types." msgstr "" -#: ../src/Doc/library/weakref.rst:242 +#: library/weakref.rst:242 msgid "" "Exception raised when a proxy object is used but the underlying object has " "been collected. This is the same as the standard :exc:`ReferenceError` " "exception." msgstr "" -# 293ba880d1eb402c97d264ba38786acc -#: ../src/Doc/library/weakref.rst:248 -msgid ":pep:`0205` - Weak References" +#: library/weakref.rst:249 +msgid "PEP 0205 - Weak References" msgstr "" -#: ../src/Doc/library/weakref.rst:249 +#: library/weakref.rst:249 msgid "" "The proposal and rationale for this feature, including links to earlier " "implementations and information about similar features in other languages." msgstr "" -#: ../src/Doc/library/weakref.rst:256 +#: library/weakref.rst:256 msgid "Weak Reference Objects" msgstr "" -#: ../src/Doc/library/weakref.rst:258 +#: library/weakref.rst:258 msgid "" "Weak reference objects have no attributes or methods, but do allow the " "referent to be obtained, if it still exists, by calling it:" msgstr "" -#: ../src/Doc/library/weakref.rst:271 +#: library/weakref.rst:271 msgid "" "If the referent no longer exists, calling the reference object returns :" "const:`None`:" msgstr "" -#: ../src/Doc/library/weakref.rst:278 +#: library/weakref.rst:278 msgid "" "Testing that a weak reference object is still live should be done using the " "expression ``ref() is not None``. Normally, application code that needs to " "use a reference object should follow this pattern::" msgstr "" -#: ../src/Doc/library/weakref.rst:291 +#: library/weakref.rst:291 msgid "" "Using a separate test for \"liveness\" creates race conditions in threaded " "applications; another thread can cause a weak reference to become " @@ -121438,7 +124398,7 @@ msgid "" "safe in threaded applications as well as single-threaded applications." msgstr "" -#: ../src/Doc/library/weakref.rst:296 +#: library/weakref.rst:296 msgid "" "Specialized versions of :class:`ref` objects can be created through " "subclassing. This is used in the implementation of the :class:" @@ -121448,14 +124408,14 @@ msgid "" "to retrieve the referent." msgstr "" -#: ../src/Doc/library/weakref.rst:302 +#: library/weakref.rst:302 msgid "" "This example shows how a subclass of :class:`ref` can be used to store " "additional information about an object and affect the value that's returned " "when the referent is accessed::" msgstr "" -#: ../src/Doc/library/weakref.rst:331 +#: library/weakref.rst:331 msgid "" "This simple example shows how an application can use objects IDs to retrieve " "objects that it has seen before. The IDs of the objects can then be used in " @@ -121463,23 +124423,23 @@ msgid "" "objects can still be retrieved by ID if they do." msgstr "" -#: ../src/Doc/library/webbrowser.rst:2 +#: library/webbrowser.rst:2 msgid ":mod:`webbrowser` --- Convenient Web-browser controller" msgstr "" # 26034514f1f746e09c32b747f2dcdb12 -#: ../src/Doc/library/webbrowser.rst:9 +#: library/webbrowser.rst:9 msgid "**Source code:** :source:`Lib/webbrowser.py`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:13 +#: library/webbrowser.rst:13 msgid "" "The :mod:`webbrowser` module provides a high-level interface to allow " "displaying Web-based documents to users. Under most circumstances, simply " "calling the :func:`.open` function from this module will do the right thing." msgstr "" -#: ../src/Doc/library/webbrowser.rst:17 +#: library/webbrowser.rst:17 msgid "" "Under Unix, graphical browsers are preferred under X11, but text-mode " "browsers will be used if graphical browsers are not available or an X11 " @@ -121487,7 +124447,7 @@ msgid "" "process will block until the user exits the browser." msgstr "" -#: ../src/Doc/library/webbrowser.rst:22 +#: library/webbrowser.rst:22 msgid "" "If the environment variable :envvar:`BROWSER` exists, it is interpreted to " "override the platform default list of browsers, as a :data:`os.pathsep`-" @@ -121498,7 +124458,7 @@ msgid "" "browser to launch. [1]_" msgstr "" -#: ../src/Doc/library/webbrowser.rst:29 +#: library/webbrowser.rst:29 msgid "" "For non-Unix platforms, or when a remote browser is available on Unix, the " "controlling process will not wait for the user to finish with the browser, " @@ -121508,7 +124468,7 @@ msgid "" msgstr "" # d2de1dad885e476a92d08d45da85d0cd -#: ../src/Doc/library/webbrowser.rst:35 +#: library/webbrowser.rst:35 msgid "" "The script :program:`webbrowser` can be used as a command-line interface for " "the module. It accepts an URL as the argument. It accepts the following " @@ -121517,15 +124477,15 @@ msgid "" "are, naturally, mutually exclusive. Usage example::" msgstr "" -#: ../src/Doc/library/webbrowser.rst:48 +#: library/webbrowser.rst:48 msgid "Exception raised when a browser control error occurs." msgstr "" -#: ../src/Doc/library/webbrowser.rst:50 +#: library/webbrowser.rst:50 msgid "The following functions are defined:" msgstr "" -#: ../src/Doc/library/webbrowser.rst:55 +#: library/webbrowser.rst:55 msgid "" "Display *url* using the default browser. If *new* is 0, the *url* is opened " "in the same browser window if possible. If *new* is 1, a new browser window " @@ -121535,34 +124495,38 @@ msgid "" "the setting of this variable)." msgstr "" -#: ../src/Doc/library/webbrowser.rst:62 +#: library/webbrowser.rst:62 msgid "" "Note that on some platforms, trying to open a filename using this function, " "may work and start the operating system's associated program. However, this " "is neither supported nor portable." msgstr "" -#: ../src/Doc/library/webbrowser.rst:72 +#: library/webbrowser.rst:66 +msgid "*new* can now be 2." +msgstr "" + +#: library/webbrowser.rst:72 msgid "" "Open *url* in a new window of the default browser, if possible, otherwise, " "open *url* in the only browser window." msgstr "" -#: ../src/Doc/library/webbrowser.rst:77 +#: library/webbrowser.rst:77 msgid "" "Open *url* in a new page (\"tab\") of the default browser, if possible, " "otherwise equivalent to :func:`open_new`." msgstr "" # 1ed89edc562e437b9fe1d83386806851 -#: ../src/Doc/library/webbrowser.rst:85 +#: library/webbrowser.rst:85 msgid "" "Return a controller object for the browser type *name*. If *name* is empty, " "return a controller for a default browser appropriate to the caller's " "environment." msgstr "" -#: ../src/Doc/library/webbrowser.rst:92 +#: library/webbrowser.rst:92 msgid "" "Register the browser type *name*. Once a browser type is registered, the :" "func:`get` function can return a controller for that browser type. If " @@ -121571,172 +124535,172 @@ msgid "" "provided, *constructor* will never be called, and may be ``None``." msgstr "" -#: ../src/Doc/library/webbrowser.rst:98 +#: library/webbrowser.rst:98 msgid "" "This entry point is only useful if you plan to either set the :envvar:" "`BROWSER` variable or call :func:`get` with a nonempty argument matching the " "name of a handler you declare." msgstr "" -#: ../src/Doc/library/webbrowser.rst:102 +#: library/webbrowser.rst:102 msgid "" "A number of browser types are predefined. This table gives the type names " "that may be passed to the :func:`get` function and the corresponding " "instantiations for the controller classes, all defined in this module." msgstr "" -#: ../src/Doc/library/webbrowser.rst:107 +#: library/webbrowser.rst:107 msgid "Type Name" msgstr "" -#: ../src/Doc/library/webbrowser.rst:107 +#: library/webbrowser.rst:107 msgid "Class Name" msgstr "" -#: ../src/Doc/library/webbrowser.rst:109 +#: library/webbrowser.rst:109 msgid "``'mozilla'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:109 ../src/Doc/library/webbrowser.rst:111 +#: library/webbrowser.rst:109 library/webbrowser.rst:111 msgid ":class:`Mozilla('mozilla')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:111 +#: library/webbrowser.rst:111 msgid "``'firefox'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:113 +#: library/webbrowser.rst:113 msgid "``'netscape'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:113 +#: library/webbrowser.rst:113 msgid ":class:`Mozilla('netscape')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:115 +#: library/webbrowser.rst:115 msgid "``'galeon'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:115 +#: library/webbrowser.rst:115 msgid ":class:`Galeon('galeon')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:117 +#: library/webbrowser.rst:117 msgid "``'epiphany'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:117 +#: library/webbrowser.rst:117 msgid ":class:`Galeon('epiphany')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:119 +#: library/webbrowser.rst:119 msgid "``'skipstone'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:119 +#: library/webbrowser.rst:119 msgid ":class:`BackgroundBrowser('skipstone')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:121 +#: library/webbrowser.rst:121 msgid "``'kfmclient'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:121 ../src/Doc/library/webbrowser.rst:123 -#: ../src/Doc/library/webbrowser.rst:125 +#: library/webbrowser.rst:121 library/webbrowser.rst:123 +#: library/webbrowser.rst:125 msgid ":class:`Konqueror()`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:123 +#: library/webbrowser.rst:123 msgid "``'konqueror'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:125 +#: library/webbrowser.rst:125 msgid "``'kfm'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:127 +#: library/webbrowser.rst:127 msgid "``'mosaic'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:127 +#: library/webbrowser.rst:127 msgid ":class:`BackgroundBrowser('mosaic')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:129 +#: library/webbrowser.rst:129 msgid "``'opera'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:129 +#: library/webbrowser.rst:129 msgid ":class:`Opera()`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:131 +#: library/webbrowser.rst:131 msgid "``'grail'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:131 +#: library/webbrowser.rst:131 msgid ":class:`Grail()`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:133 +#: library/webbrowser.rst:133 msgid "``'links'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:133 +#: library/webbrowser.rst:133 msgid ":class:`GenericBrowser('links')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:135 +#: library/webbrowser.rst:135 msgid "``'elinks'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:135 +#: library/webbrowser.rst:135 msgid ":class:`Elinks('elinks')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:137 +#: library/webbrowser.rst:137 msgid "``'lynx'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:137 +#: library/webbrowser.rst:137 msgid ":class:`GenericBrowser('lynx')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:139 +#: library/webbrowser.rst:139 msgid "``'w3m'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:139 +#: library/webbrowser.rst:139 msgid ":class:`GenericBrowser('w3m')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:141 +#: library/webbrowser.rst:141 msgid "``'windows-default'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:141 +#: library/webbrowser.rst:141 msgid ":class:`WindowsDefault`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:143 +#: library/webbrowser.rst:143 msgid "``'macosx'``" msgstr "" -#: ../src/Doc/library/webbrowser.rst:143 +#: library/webbrowser.rst:143 msgid ":class:`MacOSX('default')`" msgstr "" # e918c424ac3e41c4bb6582d7de02592f -#: ../src/Doc/library/webbrowser.rst:145 +#: library/webbrowser.rst:145 msgid "``'safari'``" msgstr "" # dafdcf4e50ee4458923aca26138a0363 -#: ../src/Doc/library/webbrowser.rst:145 +#: library/webbrowser.rst:145 msgid ":class:`MacOSX('safari')`" msgstr "" -#: ../src/Doc/library/webbrowser.rst:151 +#: library/webbrowser.rst:151 msgid "" "\"Konqueror\" is the file manager for the KDE desktop environment for Unix, " "and only makes sense to use if KDE is running. Some way of reliably " @@ -121746,61 +124710,61 @@ msgid "" "best strategy for running Konqueror." msgstr "" -#: ../src/Doc/library/webbrowser.rst:158 +#: library/webbrowser.rst:158 msgid "Only on Windows platforms." msgstr "" -#: ../src/Doc/library/webbrowser.rst:161 +#: library/webbrowser.rst:161 msgid "Only on Mac OS X platform." msgstr "" -#: ../src/Doc/library/webbrowser.rst:163 +#: library/webbrowser.rst:163 msgid "Here are some simple examples::" msgstr "" -#: ../src/Doc/library/webbrowser.rst:177 +#: library/webbrowser.rst:177 msgid "Browser Controller Objects" msgstr "" -#: ../src/Doc/library/webbrowser.rst:179 +#: library/webbrowser.rst:179 msgid "" "Browser controllers provide these methods which parallel three of the module-" "level convenience functions:" msgstr "" -#: ../src/Doc/library/webbrowser.rst:185 +#: library/webbrowser.rst:185 msgid "" "Display *url* using the browser handled by this controller. If *new* is 1, a " "new browser window is opened if possible. If *new* is 2, a new browser page " "(\"tab\") is opened if possible." msgstr "" -#: ../src/Doc/library/webbrowser.rst:192 +#: library/webbrowser.rst:192 msgid "" "Open *url* in a new window of the browser handled by this controller, if " "possible, otherwise, open *url* in the only browser window. Alias :func:" "`open_new`." msgstr "" -#: ../src/Doc/library/webbrowser.rst:199 +#: library/webbrowser.rst:199 msgid "" "Open *url* in a new page (\"tab\") of the browser handled by this " "controller, if possible, otherwise equivalent to :func:`open_new`." msgstr "" -#: ../src/Doc/library/webbrowser.rst:207 +#: library/webbrowser.rst:207 msgid "" "Executables named here without a full path will be searched in the " "directories given in the :envvar:`PATH` environment variable." msgstr "" # de5d7fe2040549a392e8a187cf71fd28 -#: ../src/Doc/library/whichdb.rst:2 +#: library/whichdb.rst:2 msgid ":mod:`whichdb` --- Guess which DBM module created a database" msgstr "" # 23e92c1b844e481b8f26dea34f502716 -#: ../src/Doc/library/whichdb.rst:8 +#: library/whichdb.rst:8 msgid "" "The :mod:`whichdb` module's only function has been put into the :mod:`dbm` " "module in Python 3. The :term:`2to3` tool will automatically adapt imports " @@ -121808,7 +124772,7 @@ msgid "" msgstr "" # 07779906e8584032a397b8497017e019 -#: ../src/Doc/library/whichdb.rst:13 +#: library/whichdb.rst:13 msgid "" "The single function in this module attempts to guess which of the several " "simple database modules available--\\ :mod:`dbm`, :mod:`gdbm`, or :mod:" @@ -121816,7 +124780,7 @@ msgid "" msgstr "" # aaa8daffd50c4263999a66d9a786b177 -#: ../src/Doc/library/whichdb.rst:20 +#: library/whichdb.rst:20 msgid "" "Returns one of the following values: ``None`` if the file can't be opened " "because it's unreadable or doesn't exist; the empty string (``''``) if the " @@ -121824,28 +124788,28 @@ msgid "" "name, such as ``'dbm'`` or ``'gdbm'``." msgstr "" -#: ../src/Doc/library/windows.rst:5 +#: library/windows.rst:5 msgid "MS Windows Specific Services" msgstr "" -#: ../src/Doc/library/windows.rst:7 +#: library/windows.rst:7 msgid "" "This chapter describes modules that are only available on MS Windows " "platforms." msgstr "" -#: ../src/Doc/library/winsound.rst:3 +#: library/winsound.rst:3 msgid ":mod:`winsound` --- Sound-playing interface for Windows" msgstr "" -#: ../src/Doc/library/winsound.rst:14 +#: library/winsound.rst:14 msgid "" "The :mod:`winsound` module provides access to the basic sound-playing " "machinery provided by Windows platforms. It includes functions and several " "constants." msgstr "" -#: ../src/Doc/library/winsound.rst:20 +#: library/winsound.rst:20 msgid "" "Beep the PC's speaker. The *frequency* parameter specifies frequency, in " "hertz, of the sound, and must be in the range 37 through 32,767. The " @@ -121855,7 +124819,7 @@ msgid "" msgstr "" # 67895f8ffa6c428294cd51c96cf620e4 -#: ../src/Doc/library/winsound.rst:30 +#: library/winsound.rst:30 msgid "" "Call the underlying :c:func:`PlaySound` function from the Platform API. The " "*sound* parameter may be a filename, audio data as a string, or ``None``. " @@ -121866,7 +124830,7 @@ msgid "" msgstr "" # 7c4ea8d3d1ae47909aec7d1d6824360e -#: ../src/Doc/library/winsound.rst:40 +#: library/winsound.rst:40 msgid "" "Call the underlying :c:func:`MessageBeep` function from the Platform API. " "This plays a sound as specified in the registry. The *type* argument " @@ -121877,13 +124841,13 @@ msgid "" "played otherwise." msgstr "" -#: ../src/Doc/library/winsound.rst:52 +#: library/winsound.rst:52 msgid "" "The *sound* parameter is the name of a WAV file. Do not use with :const:" "`SND_ALIAS`." msgstr "" -#: ../src/Doc/library/winsound.rst:58 +#: library/winsound.rst:58 msgid "" "The *sound* parameter is a sound association name from the registry. If the " "registry contains no such name, play the system default sound unless :const:" @@ -121891,125 +124855,125 @@ msgid "" "exc:`RuntimeError`. Do not use with :const:`SND_FILENAME`." msgstr "" -#: ../src/Doc/library/winsound.rst:63 +#: library/winsound.rst:63 msgid "" "All Win32 systems support at least the following; most systems support many " "more:" msgstr "" -#: ../src/Doc/library/winsound.rst:67 +#: library/winsound.rst:67 msgid ":func:`PlaySound` *name*" msgstr "" -#: ../src/Doc/library/winsound.rst:67 +#: library/winsound.rst:67 msgid "Corresponding Control Panel Sound name" msgstr "" -#: ../src/Doc/library/winsound.rst:69 +#: library/winsound.rst:69 msgid "``'SystemAsterisk'``" msgstr "" -#: ../src/Doc/library/winsound.rst:69 +#: library/winsound.rst:69 msgid "Asterisk" msgstr "" -#: ../src/Doc/library/winsound.rst:71 +#: library/winsound.rst:71 msgid "``'SystemExclamation'``" msgstr "" -#: ../src/Doc/library/winsound.rst:71 +#: library/winsound.rst:71 msgid "Exclamation" msgstr "" -#: ../src/Doc/library/winsound.rst:73 +#: library/winsound.rst:73 msgid "``'SystemExit'``" msgstr "" -#: ../src/Doc/library/winsound.rst:73 +#: library/winsound.rst:73 msgid "Exit Windows" msgstr "" -#: ../src/Doc/library/winsound.rst:75 +#: library/winsound.rst:75 msgid "``'SystemHand'``" msgstr "" -#: ../src/Doc/library/winsound.rst:75 +#: library/winsound.rst:75 msgid "Critical Stop" msgstr "" -#: ../src/Doc/library/winsound.rst:77 +#: library/winsound.rst:77 msgid "``'SystemQuestion'``" msgstr "" -#: ../src/Doc/library/winsound.rst:77 +#: library/winsound.rst:77 msgid "Question" msgstr "" -#: ../src/Doc/library/winsound.rst:93 +#: library/winsound.rst:93 msgid "" "Play the sound repeatedly. The :const:`SND_ASYNC` flag must also be used to " "avoid blocking. Cannot be used with :const:`SND_MEMORY`." msgstr "" -#: ../src/Doc/library/winsound.rst:99 +#: library/winsound.rst:99 msgid "" "The *sound* parameter to :func:`PlaySound` is a memory image of a WAV file, " "as a string." msgstr "" -#: ../src/Doc/library/winsound.rst:104 +#: library/winsound.rst:104 msgid "" "This module does not support playing from a memory image asynchronously, so " "a combination of this flag and :const:`SND_ASYNC` will raise :exc:" "`RuntimeError`." msgstr "" -#: ../src/Doc/library/winsound.rst:110 +#: library/winsound.rst:110 msgid "Stop playing all instances of the specified sound." msgstr "" -#: ../src/Doc/library/winsound.rst:114 ../src/Doc/library/winsound.rst:138 +#: library/winsound.rst:114 library/winsound.rst:138 msgid "This flag is not supported on modern Windows platforms." msgstr "" -#: ../src/Doc/library/winsound.rst:119 +#: library/winsound.rst:119 msgid "Return immediately, allowing sounds to play asynchronously." msgstr "" -#: ../src/Doc/library/winsound.rst:124 +#: library/winsound.rst:124 msgid "" "If the specified sound cannot be found, do not play the system default sound." msgstr "" -#: ../src/Doc/library/winsound.rst:129 +#: library/winsound.rst:129 msgid "Do not interrupt sounds currently playing." msgstr "" -#: ../src/Doc/library/winsound.rst:134 +#: library/winsound.rst:134 msgid "Return immediately if the sound driver is busy." msgstr "" -#: ../src/Doc/library/winsound.rst:143 ../src/Doc/library/winsound.rst:163 +#: library/winsound.rst:143 library/winsound.rst:163 msgid "Play the ``SystemDefault`` sound." msgstr "" -#: ../src/Doc/library/winsound.rst:148 +#: library/winsound.rst:148 msgid "Play the ``SystemExclamation`` sound." msgstr "" -#: ../src/Doc/library/winsound.rst:153 +#: library/winsound.rst:153 msgid "Play the ``SystemHand`` sound." msgstr "" -#: ../src/Doc/library/winsound.rst:158 +#: library/winsound.rst:158 msgid "Play the ``SystemQuestion`` sound." msgstr "" -#: ../src/Doc/library/wsgiref.rst:2 +#: library/wsgiref.rst:2 msgid ":mod:`wsgiref` --- WSGI Utilities and Reference Implementation" msgstr "" -#: ../src/Doc/library/wsgiref.rst:12 +#: library/wsgiref.rst:12 msgid "" "The Web Server Gateway Interface (WSGI) is a standard interface between web " "server software and web applications written in Python. Having a standard " @@ -122017,7 +124981,7 @@ msgid "" "number of different web servers." msgstr "" -#: ../src/Doc/library/wsgiref.rst:17 +#: library/wsgiref.rst:17 msgid "" "Only authors of web servers and programming frameworks need to know every " "detail and corner case of the WSGI design. You don't need to understand " @@ -122025,7 +124989,7 @@ msgid "" "application using an existing framework." msgstr "" -#: ../src/Doc/library/wsgiref.rst:22 +#: library/wsgiref.rst:22 msgid "" ":mod:`wsgiref` is a reference implementation of the WSGI specification that " "can be used to add WSGI support to a web server or framework. It provides " @@ -122035,17 +124999,17 @@ msgid "" "applications for conformance to the WSGI specification (:pep:`333`)." msgstr "" -#: ../src/Doc/library/wsgiref.rst:29 +#: library/wsgiref.rst:29 msgid "" "See http://www.wsgi.org for more information about WSGI, and links to " "tutorials and other resources." msgstr "" -#: ../src/Doc/library/wsgiref.rst:36 +#: library/wsgiref.rst:36 msgid ":mod:`wsgiref.util` -- WSGI environment utilities" msgstr "" -#: ../src/Doc/library/wsgiref.rst:42 +#: library/wsgiref.rst:42 msgid "" "This module provides a variety of utility functions for working with WSGI " "environments. A WSGI environment is a dictionary containing HTTP request " @@ -122054,14 +125018,14 @@ msgid "" "please see :pep:`333` for a detailed specification." msgstr "" -#: ../src/Doc/library/wsgiref.rst:51 +#: library/wsgiref.rst:51 msgid "" "Return a guess for whether ``wsgi.url_scheme`` should be \"http\" or \"https" "\", by checking for a ``HTTPS`` environment variable in the *environ* " "dictionary. The return value is a string." msgstr "" -#: ../src/Doc/library/wsgiref.rst:55 +#: library/wsgiref.rst:55 msgid "" "This function is useful when creating a gateway that wraps CGI or a CGI-like " "protocol such as FastCGI. Typically, servers providing such protocols will " @@ -122070,7 +125034,7 @@ msgid "" "value is found, and \"http\" otherwise." msgstr "" -#: ../src/Doc/library/wsgiref.rst:64 +#: library/wsgiref.rst:64 msgid "" "Return the full request URI, optionally including the query string, using " "the algorithm found in the \"URL Reconstruction\" section of :pep:`333`. If " @@ -122078,27 +125042,27 @@ msgid "" "URI." msgstr "" -#: ../src/Doc/library/wsgiref.rst:71 +#: library/wsgiref.rst:71 msgid "" "Similar to :func:`request_uri`, except that the ``PATH_INFO`` and " "``QUERY_STRING`` variables are ignored. The result is the base URI of the " "application object addressed by the request." msgstr "" -#: ../src/Doc/library/wsgiref.rst:78 +#: library/wsgiref.rst:78 msgid "" "Shift a single name from ``PATH_INFO`` to ``SCRIPT_NAME`` and return the " "name. The *environ* dictionary is *modified* in-place; use a copy if you " "need to keep the original ``PATH_INFO`` or ``SCRIPT_NAME`` intact." msgstr "" -#: ../src/Doc/library/wsgiref.rst:82 +#: library/wsgiref.rst:82 msgid "" "If there are no remaining path segments in ``PATH_INFO``, ``None`` is " "returned." msgstr "" -#: ../src/Doc/library/wsgiref.rst:84 +#: library/wsgiref.rst:84 msgid "" "Typically, this routine is used to process each portion of a request URI " "path, for example to treat the path as a series of dictionary keys. This " @@ -122112,7 +125076,7 @@ msgid "" "and ``PATH_INFO`` will change from ``/bar/baz`` to ``/baz``." msgstr "" -#: ../src/Doc/library/wsgiref.rst:95 +#: library/wsgiref.rst:95 msgid "" "When ``PATH_INFO`` is just a \"/\", this routine returns an empty string and " "appends a trailing slash to ``SCRIPT_NAME``, even though empty path segments " @@ -122122,11 +125086,11 @@ msgid "" "using this routine to do object traversal." msgstr "" -#: ../src/Doc/library/wsgiref.rst:105 +#: library/wsgiref.rst:105 msgid "Update *environ* with trivial defaults for testing purposes." msgstr "" -#: ../src/Doc/library/wsgiref.rst:107 +#: library/wsgiref.rst:107 msgid "" "This routine adds various parameters required for WSGI, including " "``HTTP_HOST``, ``SERVER_NAME``, ``SERVER_PORT``, ``REQUEST_METHOD``, " @@ -122135,26 +125099,26 @@ msgid "" "existing settings for these variables." msgstr "" -#: ../src/Doc/library/wsgiref.rst:113 +#: library/wsgiref.rst:113 msgid "" "This routine is intended to make it easier for unit tests of WSGI servers " "and applications to set up dummy environments. It should NOT be used by " "actual WSGI servers or applications, since the data is fake!" msgstr "" -#: ../src/Doc/library/wsgiref.rst:141 +#: library/wsgiref.rst:141 msgid "" "In addition to the environment functions above, the :mod:`wsgiref.util` " "module also provides these miscellaneous utilities:" msgstr "" -#: ../src/Doc/library/wsgiref.rst:147 +#: library/wsgiref.rst:147 msgid "" "Return true if 'header_name' is an HTTP/1.1 \"Hop-by-Hop\" header, as " "defined by :rfc:`2616`." msgstr "" -#: ../src/Doc/library/wsgiref.rst:153 +#: library/wsgiref.rst:153 msgid "" "A wrapper to convert a file-like object to an :term:`iterator`. The " "resulting objects support both :meth:`__getitem__` and :meth:`__iter__` " @@ -122165,24 +125129,24 @@ msgid "" "not resumable." msgstr "" -#: ../src/Doc/library/wsgiref.rst:160 +#: library/wsgiref.rst:160 msgid "" "If *filelike* has a :meth:`close` method, the returned object will also have " "a :meth:`close` method, and it will invoke the *filelike* object's :meth:" "`close` method when called." msgstr "" -#: ../src/Doc/library/wsgiref.rst:179 +#: library/wsgiref.rst:179 msgid ":mod:`wsgiref.headers` -- WSGI response header tools" msgstr "" -#: ../src/Doc/library/wsgiref.rst:185 +#: library/wsgiref.rst:185 msgid "" "This module provides a single class, :class:`Headers`, for convenient " "manipulation of WSGI response headers using a mapping-like interface." msgstr "" -#: ../src/Doc/library/wsgiref.rst:191 +#: library/wsgiref.rst:191 msgid "" "Create a mapping-like object wrapping *headers*, which must be a list of " "header name/value tuples as described in :pep:`333`. Any changes made to " @@ -122191,7 +125155,7 @@ msgid "" msgstr "" # 67f3a586da0248f895a17889b293249c -#: ../src/Doc/library/wsgiref.rst:196 +#: library/wsgiref.rst:196 msgid "" ":class:`Headers` objects support typical mapping operations including :meth:" "`__getitem__`, :meth:`get`, :meth:`__setitem__`, :meth:`setdefault`, :meth:" @@ -122203,7 +125167,7 @@ msgid "" "maintained, with new headers added to the end of the wrapped list." msgstr "" -#: ../src/Doc/library/wsgiref.rst:205 +#: library/wsgiref.rst:205 msgid "" "Unlike a dictionary, :class:`Headers` objects do not raise an error when you " "try to get or delete a key that isn't in the wrapped header list. Getting a " @@ -122211,7 +125175,7 @@ msgid "" "does nothing." msgstr "" -#: ../src/Doc/library/wsgiref.rst:210 +#: library/wsgiref.rst:210 msgid "" ":class:`Headers` objects also support :meth:`keys`, :meth:`values`, and :" "meth:`items` methods. The lists returned by :meth:`keys` and :meth:`items` " @@ -122222,7 +125186,7 @@ msgid "" "list." msgstr "" -#: ../src/Doc/library/wsgiref.rst:217 +#: library/wsgiref.rst:217 msgid "" "Calling ``str()`` on a :class:`Headers` object returns a formatted string " "suitable for transmission as HTTP response headers. Each header is placed " @@ -122231,18 +125195,18 @@ msgid "" "with a blank line." msgstr "" -#: ../src/Doc/library/wsgiref.rst:223 +#: library/wsgiref.rst:223 msgid "" "In addition to their mapping interface and formatting features, :class:" "`Headers` objects also have the following methods for querying and adding " "multi-valued headers, and for adding headers with MIME parameters:" msgstr "" -#: ../src/Doc/library/wsgiref.rst:230 +#: library/wsgiref.rst:230 msgid "Return a list of all the values for the named header." msgstr "" -#: ../src/Doc/library/wsgiref.rst:232 +#: library/wsgiref.rst:232 msgid "" "The returned list will be sorted in the order they appeared in the original " "header list or were added to this instance, and may contain duplicates. Any " @@ -122250,13 +125214,13 @@ msgid "" "no fields exist with the given name, returns an empty list." msgstr "" -#: ../src/Doc/library/wsgiref.rst:240 +#: library/wsgiref.rst:240 msgid "" "Add a (possibly multi-valued) header, with optional MIME parameters " "specified via keyword arguments." msgstr "" -#: ../src/Doc/library/wsgiref.rst:243 +#: library/wsgiref.rst:243 msgid "" "*name* is the header field to add. Keyword arguments can be used to set " "MIME parameters for the header field. Each parameter must be a string or " @@ -122268,16 +125232,16 @@ msgid "" "a value.) Example usage::" msgstr "" -#: ../src/Doc/library/wsgiref.rst:253 +#: library/wsgiref.rst:253 msgid "The above will add a header that looks like this::" msgstr "" -#: ../src/Doc/library/wsgiref.rst:259 +#: library/wsgiref.rst:259 msgid ":mod:`wsgiref.simple_server` -- a simple WSGI HTTP server" msgstr "" # 9121b08be969404e8c2d6c9cf6b6da78 -#: ../src/Doc/library/wsgiref.rst:265 +#: library/wsgiref.rst:265 msgid "" "This module implements a simple HTTP server (based on :mod:`BaseHTTPServer`) " "that serves WSGI applications. Each server instance serves a single WSGI " @@ -122288,7 +125252,7 @@ msgid "" "`wsgiref.util`.)" msgstr "" -#: ../src/Doc/library/wsgiref.rst:276 +#: library/wsgiref.rst:276 msgid "" "Create a new WSGI server listening on *host* and *port*, accepting " "connections for *app*. The return value is an instance of the supplied " @@ -122297,7 +125261,7 @@ msgid "" "pep:`333`." msgstr "" -#: ../src/Doc/library/wsgiref.rst:297 +#: library/wsgiref.rst:297 msgid "" "This function is a small but complete WSGI application that returns a text " "page containing the message \"Hello world!\" and a list of the key/value " @@ -122307,7 +125271,7 @@ msgid "" msgstr "" # dda89e3b9a3c45b7a30065f4d7293039 -#: ../src/Doc/library/wsgiref.rst:306 +#: library/wsgiref.rst:306 msgid "" "Create a :class:`WSGIServer` instance. *server_address* should be a ``(host," "port)`` tuple, and *RequestHandlerClass* should be the subclass of :class:" @@ -122315,14 +125279,14 @@ msgid "" "requests." msgstr "" -#: ../src/Doc/library/wsgiref.rst:311 +#: library/wsgiref.rst:311 msgid "" "You do not normally need to call this constructor, as the :func:" "`make_server` function can handle all the details for you." msgstr "" # 30845b632dda4d1e9ec9e5e96cd29a09 -#: ../src/Doc/library/wsgiref.rst:314 +#: library/wsgiref.rst:314 msgid "" ":class:`WSGIServer` is a subclass of :class:`BaseHTTPServer.HTTPServer`, so " "all of its methods (such as :meth:`serve_forever` and :meth:" @@ -122330,31 +125294,31 @@ msgid "" "WSGI-specific methods:" msgstr "" -#: ../src/Doc/library/wsgiref.rst:321 +#: library/wsgiref.rst:321 msgid "" "Sets the callable *application* as the WSGI application that will receive " "requests." msgstr "" -#: ../src/Doc/library/wsgiref.rst:327 +#: library/wsgiref.rst:327 msgid "Returns the currently-set application callable." msgstr "" -#: ../src/Doc/library/wsgiref.rst:329 +#: library/wsgiref.rst:329 msgid "" "Normally, however, you do not need to use these additional methods, as :meth:" "`set_app` is normally called by :func:`make_server`, and the :meth:`get_app` " "exists mainly for the benefit of request handler instances." msgstr "" -#: ../src/Doc/library/wsgiref.rst:336 +#: library/wsgiref.rst:336 msgid "" "Create an HTTP handler for the given *request* (i.e. a socket), " "*client_address* (a ``(host,port)`` tuple), and *server* (:class:" "`WSGIServer` instance)." msgstr "" -#: ../src/Doc/library/wsgiref.rst:339 +#: library/wsgiref.rst:339 msgid "" "You do not need to create instances of this class directly; they are " "automatically created as needed by :class:`WSGIServer` objects. You can, " @@ -122363,7 +125327,7 @@ msgid "" "subclasses:" msgstr "" -#: ../src/Doc/library/wsgiref.rst:348 +#: library/wsgiref.rst:348 msgid "" "Returns a dictionary containing the WSGI environment for a request. The " "default implementation copies the contents of the :class:`WSGIServer` " @@ -122373,24 +125337,24 @@ msgid "" "variables as specified in :pep:`333`." msgstr "" -#: ../src/Doc/library/wsgiref.rst:358 +#: library/wsgiref.rst:358 msgid "" "Return the object that should be used as the ``wsgi.errors`` stream. The " "default implementation just returns ``sys.stderr``." msgstr "" -#: ../src/Doc/library/wsgiref.rst:364 +#: library/wsgiref.rst:364 msgid "" "Process the HTTP request. The default implementation creates a handler " "instance using a :mod:`wsgiref.handlers` class to implement the actual WSGI " "application interface." msgstr "" -#: ../src/Doc/library/wsgiref.rst:370 +#: library/wsgiref.rst:370 msgid ":mod:`wsgiref.validate` --- WSGI conformance checker" msgstr "" -#: ../src/Doc/library/wsgiref.rst:376 +#: library/wsgiref.rst:376 msgid "" "When creating new WSGI application objects, frameworks, servers, or " "middleware, it can be useful to validate the new code's conformance using :" @@ -122400,7 +125364,7 @@ msgid "" "conformance." msgstr "" -#: ../src/Doc/library/wsgiref.rst:383 +#: library/wsgiref.rst:383 msgid "" "Note that this utility does not guarantee complete :pep:`333` compliance; an " "absence of errors from this module does not necessarily mean that errors do " @@ -122409,13 +125373,13 @@ msgid "" "compliant." msgstr "" -#: ../src/Doc/library/wsgiref.rst:388 +#: library/wsgiref.rst:388 msgid "" "This module is based on the :mod:`paste.lint` module from Ian Bicking's " "\"Python Paste\" library." msgstr "" -#: ../src/Doc/library/wsgiref.rst:394 +#: library/wsgiref.rst:394 msgid "" "Wrap *application* and return a new WSGI application object. The returned " "application will forward all requests to the original *application*, and " @@ -122423,7 +125387,7 @@ msgid "" "conforming to the WSGI specification and to RFC 2616." msgstr "" -#: ../src/Doc/library/wsgiref.rst:399 +#: library/wsgiref.rst:399 msgid "" "Any detected nonconformance results in an :exc:`AssertionError` being " "raised; note, however, that how these errors are handled is server-" @@ -122434,7 +125398,7 @@ msgid "" "stream." msgstr "" -#: ../src/Doc/library/wsgiref.rst:406 +#: library/wsgiref.rst:406 msgid "" "This wrapper may also generate output using the :mod:`warnings` module to " "indicate behaviors that are questionable but which may not actually be " @@ -122444,11 +125408,11 @@ msgid "" "object)." msgstr "" -#: ../src/Doc/library/wsgiref.rst:438 +#: library/wsgiref.rst:438 msgid ":mod:`wsgiref.handlers` -- server/gateway base classes" msgstr "" -#: ../src/Doc/library/wsgiref.rst:444 +#: library/wsgiref.rst:444 msgid "" "This module provides base handler classes for implementing WSGI servers and " "gateways. These base classes handle most of the work of communicating with " @@ -122456,7 +125420,7 @@ msgid "" "with input, output, and error streams." msgstr "" -#: ../src/Doc/library/wsgiref.rst:452 +#: library/wsgiref.rst:452 msgid "" "CGI-based invocation via ``sys.stdin``, ``sys.stdout``, ``sys.stderr`` and " "``os.environ``. This is useful when you have a WSGI application and want to " @@ -122464,7 +125428,7 @@ msgid "" "``app`` is the WSGI application object you wish to invoke." msgstr "" -#: ../src/Doc/library/wsgiref.rst:457 +#: library/wsgiref.rst:457 msgid "" "This class is a subclass of :class:`BaseCGIHandler` that sets ``wsgi." "run_once`` to true, ``wsgi.multithread`` to false, and ``wsgi.multiprocess`` " @@ -122472,7 +125436,7 @@ msgid "" "CGI streams and environment." msgstr "" -#: ../src/Doc/library/wsgiref.rst:465 +#: library/wsgiref.rst:465 msgid "" "Similar to :class:`CGIHandler`, but instead of using the :mod:`sys` and :mod:" "`os` modules, the CGI environment and I/O streams are specified explicitly. " @@ -122481,7 +125445,7 @@ msgid "" "the handler instance." msgstr "" -#: ../src/Doc/library/wsgiref.rst:471 +#: library/wsgiref.rst:471 msgid "" "This class is a subclass of :class:`SimpleHandler` intended for use with " "software other than HTTP \"origin servers\". If you are writing a gateway " @@ -122490,14 +125454,14 @@ msgid "" "this instead of :class:`SimpleHandler`." msgstr "" -#: ../src/Doc/library/wsgiref.rst:480 +#: library/wsgiref.rst:480 msgid "" "Similar to :class:`BaseCGIHandler`, but designed for use with HTTP origin " "servers. If you are writing an HTTP server implementation, you will " -"probably want to subclass this instead of :class:`BaseCGIHandler`" +"probably want to subclass this instead of :class:`BaseCGIHandler`." msgstr "" -#: ../src/Doc/library/wsgiref.rst:484 +#: library/wsgiref.rst:484 msgid "" "This class is a subclass of :class:`BaseHandler`. It overrides the :meth:" "`__init__`, :meth:`get_stdin`, :meth:`get_stderr`, :meth:`add_cgi_vars`, :" @@ -122507,36 +125471,36 @@ msgid "" "and :attr:`environ` attributes." msgstr "" -#: ../src/Doc/library/wsgiref.rst:494 +#: library/wsgiref.rst:494 msgid "" "This is an abstract base class for running WSGI applications. Each instance " "will handle a single HTTP request, although in principle you could create a " "subclass that was reusable for multiple requests." msgstr "" -#: ../src/Doc/library/wsgiref.rst:498 +#: library/wsgiref.rst:498 msgid "" ":class:`BaseHandler` instances have only one method intended for external " "use:" msgstr "" -#: ../src/Doc/library/wsgiref.rst:503 +#: library/wsgiref.rst:503 msgid "Run the specified WSGI application, *app*." msgstr "" -#: ../src/Doc/library/wsgiref.rst:505 +#: library/wsgiref.rst:505 msgid "" "All of the other :class:`BaseHandler` methods are invoked by this method in " "the process of running the application, and thus exist primarily to allow " "customizing the process." msgstr "" -#: ../src/Doc/library/wsgiref.rst:509 +#: library/wsgiref.rst:509 msgid "The following methods MUST be overridden in a subclass:" msgstr "" # ea48d9909bb8458da65b4f7b6cda3b07 -#: ../src/Doc/library/wsgiref.rst:514 +#: library/wsgiref.rst:514 msgid "" "Buffer the string *data* for transmission to the client. It's okay if this " "method actually transmits the data; :class:`BaseHandler` just separates " @@ -122544,31 +125508,31 @@ msgid "" "actually has such a distinction." msgstr "" -#: ../src/Doc/library/wsgiref.rst:522 +#: library/wsgiref.rst:522 msgid "" "Force buffered data to be transmitted to the client. It's okay if this " "method is a no-op (i.e., if :meth:`_write` actually sends the data)." msgstr "" -#: ../src/Doc/library/wsgiref.rst:528 +#: library/wsgiref.rst:528 msgid "" "Return an input stream object suitable for use as the ``wsgi.input`` of the " "request currently being processed." msgstr "" -#: ../src/Doc/library/wsgiref.rst:534 +#: library/wsgiref.rst:534 msgid "" "Return an output stream object suitable for use as the ``wsgi.errors`` of " "the request currently being processed." msgstr "" -#: ../src/Doc/library/wsgiref.rst:540 +#: library/wsgiref.rst:540 msgid "" "Insert CGI variables for the current request into the :attr:`environ` " "attribute." msgstr "" -#: ../src/Doc/library/wsgiref.rst:542 +#: library/wsgiref.rst:542 msgid "" "Here are some other methods and attributes you may wish to override. This " "list is only a summary, however, and does not include every method that can " @@ -122577,32 +125541,32 @@ msgid "" "`BaseHandler` subclass." msgstr "" -#: ../src/Doc/library/wsgiref.rst:548 +#: library/wsgiref.rst:548 msgid "Attributes and methods for customizing the WSGI environment:" msgstr "" -#: ../src/Doc/library/wsgiref.rst:553 +#: library/wsgiref.rst:553 msgid "" "The value to be used for the ``wsgi.multithread`` environment variable. It " "defaults to true in :class:`BaseHandler`, but may have a different default " "(or be set by the constructor) in the other subclasses." msgstr "" -#: ../src/Doc/library/wsgiref.rst:560 +#: library/wsgiref.rst:560 msgid "" "The value to be used for the ``wsgi.multiprocess`` environment variable. It " "defaults to true in :class:`BaseHandler`, but may have a different default " "(or be set by the constructor) in the other subclasses." msgstr "" -#: ../src/Doc/library/wsgiref.rst:567 +#: library/wsgiref.rst:567 msgid "" "The value to be used for the ``wsgi.run_once`` environment variable. It " "defaults to false in :class:`BaseHandler`, but :class:`CGIHandler` sets it " "to true by default." msgstr "" -#: ../src/Doc/library/wsgiref.rst:574 +#: library/wsgiref.rst:574 msgid "" "The default environment variables to be included in every request's WSGI " "environment. By default, this is a copy of ``os.environ`` at the time that :" @@ -122612,7 +125576,7 @@ msgid "" "classes and instances." msgstr "" -#: ../src/Doc/library/wsgiref.rst:584 +#: library/wsgiref.rst:584 msgid "" "If the :attr:`origin_server` attribute is set, this attribute's value is " "used to set the default ``SERVER_SOFTWARE`` WSGI environment variable, and " @@ -122621,7 +125585,7 @@ msgid "" "are not HTTP origin servers." msgstr "" -#: ../src/Doc/library/wsgiref.rst:593 +#: library/wsgiref.rst:593 msgid "" "Return the URL scheme being used for the current request. The default " "implementation uses the :func:`guess_scheme` function from :mod:`wsgiref." @@ -122629,7 +125593,7 @@ msgid "" "the current request's :attr:`environ` variables." msgstr "" -#: ../src/Doc/library/wsgiref.rst:601 +#: library/wsgiref.rst:601 msgid "" "Set the :attr:`environ` attribute to a fully-populated WSGI environment. " "The default implementation uses all of the above methods and attributes, " @@ -122639,11 +125603,11 @@ msgid "" "attribute is a true value and the :attr:`server_software` attribute is set." msgstr "" -#: ../src/Doc/library/wsgiref.rst:608 +#: library/wsgiref.rst:608 msgid "Methods and attributes for customizing exception handling:" msgstr "" -#: ../src/Doc/library/wsgiref.rst:613 +#: library/wsgiref.rst:613 msgid "" "Log the *exc_info* tuple in the server log. *exc_info* is a ``(type, value, " "traceback)`` tuple. The default implementation simply writes the traceback " @@ -122653,33 +125617,33 @@ msgid "" "suitable." msgstr "" -#: ../src/Doc/library/wsgiref.rst:622 +#: library/wsgiref.rst:622 msgid "" "The maximum number of frames to include in tracebacks output by the default :" "meth:`log_exception` method. If ``None``, all frames are included." msgstr "" -#: ../src/Doc/library/wsgiref.rst:628 +#: library/wsgiref.rst:628 msgid "" "This method is a WSGI application to generate an error page for the user. " "It is only invoked if an error occurs before headers are sent to the client." msgstr "" -#: ../src/Doc/library/wsgiref.rst:631 +#: library/wsgiref.rst:631 msgid "" "This method can access the current error information using ``sys." "exc_info()``, and should pass that information to *start_response* when " "calling it (as described in the \"Error Handling\" section of :pep:`333`)." msgstr "" -#: ../src/Doc/library/wsgiref.rst:635 +#: library/wsgiref.rst:635 msgid "" "The default implementation just uses the :attr:`error_status`, :attr:" "`error_headers`, and :attr:`error_body` attributes to generate an output " "page. Subclasses can override this to produce more dynamic error output." msgstr "" -#: ../src/Doc/library/wsgiref.rst:639 +#: library/wsgiref.rst:639 msgid "" "Note, however, that it's not recommended from a security perspective to spit " "out diagnostics to any old user; ideally, you should have to do something " @@ -122687,39 +125651,39 @@ msgid "" "doesn't include any." msgstr "" -#: ../src/Doc/library/wsgiref.rst:647 +#: library/wsgiref.rst:647 msgid "" "The HTTP status used for error responses. This should be a status string as " "defined in :pep:`333`; it defaults to a 500 code and message." msgstr "" -#: ../src/Doc/library/wsgiref.rst:653 +#: library/wsgiref.rst:653 msgid "" "The HTTP headers used for error responses. This should be a list of WSGI " "response headers (``(name, value)`` tuples), as described in :pep:`333`. " "The default list just sets the content type to ``text/plain``." msgstr "" -#: ../src/Doc/library/wsgiref.rst:660 +#: library/wsgiref.rst:660 msgid "" "The error response body. This should be an HTTP response body string. It " "defaults to the plain text, \"A server error occurred. Please contact the " "administrator.\"" msgstr "" -#: ../src/Doc/library/wsgiref.rst:664 +#: library/wsgiref.rst:664 msgid "" "Methods and attributes for :pep:`333`'s \"Optional Platform-Specific File " "Handling\" feature:" msgstr "" -#: ../src/Doc/library/wsgiref.rst:670 +#: library/wsgiref.rst:670 msgid "" "A ``wsgi.file_wrapper`` factory, or ``None``. The default value of this " "attribute is the :class:`FileWrapper` class from :mod:`wsgiref.util`." msgstr "" -#: ../src/Doc/library/wsgiref.rst:676 +#: library/wsgiref.rst:676 msgid "" "Override to implement platform-specific file transmission. This method is " "called only if the application's return value is an instance of the class " @@ -122729,11 +125693,11 @@ msgid "" "of this method just returns a false value." msgstr "" -#: ../src/Doc/library/wsgiref.rst:683 +#: library/wsgiref.rst:683 msgid "Miscellaneous methods and attributes:" msgstr "" -#: ../src/Doc/library/wsgiref.rst:688 +#: library/wsgiref.rst:688 msgid "" "This attribute should be set to a true value if the handler's :meth:`_write` " "and :meth:`_flush` are being used to communicate directly to the client, " @@ -122741,94 +125705,92 @@ msgid "" "special ``Status:`` header." msgstr "" -#: ../src/Doc/library/wsgiref.rst:693 +#: library/wsgiref.rst:693 msgid "" "This attribute's default value is true in :class:`BaseHandler`, but false " "in :class:`BaseCGIHandler` and :class:`CGIHandler`." msgstr "" -#: ../src/Doc/library/wsgiref.rst:699 +#: library/wsgiref.rst:699 msgid "" "If :attr:`origin_server` is true, this string attribute is used to set the " "HTTP version of the response set to the client. It defaults to ``\"1.0\"``." msgstr "" -#: ../src/Doc/library/wsgiref.rst:706 +#: library/wsgiref.rst:706 msgid "This is a working \"Hello World\" WSGI application::" msgstr "" -#: ../src/Doc/library/xdrlib.rst:2 +#: library/xdrlib.rst:2 msgid ":mod:`xdrlib` --- Encode and decode XDR data" msgstr "" # f3b25bca1ac5496daf8f6d9de87668af -#: ../src/Doc/library/xdrlib.rst:12 +#: library/xdrlib.rst:12 msgid "**Source code:** :source:`Lib/xdrlib.py`" msgstr "" -#: ../src/Doc/library/xdrlib.rst:16 +#: library/xdrlib.rst:16 msgid "" "The :mod:`xdrlib` module supports the External Data Representation Standard " "as described in :rfc:`1014`, written by Sun Microsystems, Inc. June 1987. " "It supports most of the data types described in the RFC." msgstr "" -#: ../src/Doc/library/xdrlib.rst:20 +#: library/xdrlib.rst:20 msgid "" "The :mod:`xdrlib` module defines two classes, one for packing variables into " "XDR representation, and another for unpacking from XDR representation. " "There are also two exception classes." msgstr "" -#: ../src/Doc/library/xdrlib.rst:27 +#: library/xdrlib.rst:27 msgid "" ":class:`Packer` is the class for packing data into XDR representation. The :" "class:`Packer` class is instantiated with no arguments." msgstr "" -#: ../src/Doc/library/xdrlib.rst:33 +#: library/xdrlib.rst:33 msgid "" "``Unpacker`` is the complementary class which unpacks XDR data values from a " "string buffer. The input buffer is given as *data*." msgstr "" -# 1c763228846a4a34a90848a2623fe439 -#: ../src/Doc/library/xdrlib.rst:40 -msgid ":rfc:`1014` - XDR: External Data Representation Standard" +#: library/xdrlib.rst:41 +msgid "RFC 1014 - XDR: External Data Representation Standard" msgstr "" -#: ../src/Doc/library/xdrlib.rst:40 +#: library/xdrlib.rst:40 msgid "" "This RFC defined the encoding of data which was XDR at the time this module " "was originally written. It has apparently been obsoleted by :rfc:`1832`." msgstr "" -# 7be509506ad94f3ca54225771ef131e4 -#: ../src/Doc/library/xdrlib.rst:42 -msgid ":rfc:`1832` - XDR: External Data Representation Standard" +#: library/xdrlib.rst:43 +msgid "RFC 1832 - XDR: External Data Representation Standard" msgstr "" -#: ../src/Doc/library/xdrlib.rst:44 +#: library/xdrlib.rst:44 msgid "Newer RFC that provides a revised definition of XDR." msgstr "" -#: ../src/Doc/library/xdrlib.rst:50 +#: library/xdrlib.rst:50 msgid "Packer Objects" msgstr "" -#: ../src/Doc/library/xdrlib.rst:52 +#: library/xdrlib.rst:52 msgid ":class:`Packer` instances have the following methods:" msgstr "" -#: ../src/Doc/library/xdrlib.rst:57 +#: library/xdrlib.rst:57 msgid "Returns the current pack buffer as a string." msgstr "" -#: ../src/Doc/library/xdrlib.rst:62 +#: library/xdrlib.rst:62 msgid "Resets the pack buffer to the empty string." msgstr "" -#: ../src/Doc/library/xdrlib.rst:64 +#: library/xdrlib.rst:64 msgid "" "In general, you can pack any of the most common XDR data types by calling " "the appropriate ``pack_type()`` method. Each method takes a single " @@ -122837,51 +125799,51 @@ msgid "" "`pack_bool`, :meth:`pack_uhyper`, and :meth:`pack_hyper`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:73 +#: library/xdrlib.rst:73 msgid "Packs the single-precision floating point number *value*." msgstr "" -#: ../src/Doc/library/xdrlib.rst:78 +#: library/xdrlib.rst:78 msgid "Packs the double-precision floating point number *value*." msgstr "" -#: ../src/Doc/library/xdrlib.rst:80 +#: library/xdrlib.rst:80 msgid "The following methods support packing strings, bytes, and opaque data:" msgstr "" -#: ../src/Doc/library/xdrlib.rst:85 +#: library/xdrlib.rst:85 msgid "" "Packs a fixed length string, *s*. *n* is the length of the string but it is " "*not* packed into the data buffer. The string is padded with null bytes if " "necessary to guaranteed 4 byte alignment." msgstr "" -#: ../src/Doc/library/xdrlib.rst:92 +#: library/xdrlib.rst:92 msgid "" "Packs a fixed length opaque data stream, similarly to :meth:`pack_fstring`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:97 +#: library/xdrlib.rst:97 msgid "" "Packs a variable length string, *s*. The length of the string is first " "packed as an unsigned integer, then the string data is packed with :meth:" "`pack_fstring`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:104 +#: library/xdrlib.rst:104 msgid "" "Packs a variable length opaque data string, similarly to :meth:`pack_string`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:109 +#: library/xdrlib.rst:109 msgid "Packs a variable length byte stream, similarly to :meth:`pack_string`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:111 +#: library/xdrlib.rst:111 msgid "The following methods support packing arrays and lists:" msgstr "" -#: ../src/Doc/library/xdrlib.rst:116 +#: library/xdrlib.rst:116 msgid "" "Packs a *list* of homogeneous items. This method is useful for lists with " "an indeterminate size; i.e. the size is not available until the entire list " @@ -122891,12 +125853,12 @@ msgid "" "list, an unsigned integer ``0`` is packed." msgstr "" -#: ../src/Doc/library/xdrlib.rst:123 +#: library/xdrlib.rst:123 msgid "" "For example, to pack a list of integers, the code might appear like this::" msgstr "" -#: ../src/Doc/library/xdrlib.rst:132 +#: library/xdrlib.rst:132 msgid "" "Packs a fixed length list (*array*) of homogeneous items. *n* is the length " "of the list; it is *not* packed into the buffer, but a :exc:`ValueError` " @@ -122904,103 +125866,103 @@ msgid "" "*pack_item* is the function used to pack each element." msgstr "" -#: ../src/Doc/library/xdrlib.rst:140 +#: library/xdrlib.rst:140 msgid "" "Packs a variable length *list* of homogeneous items. First, the length of " "the list is packed as an unsigned integer, then each element is packed as " "in :meth:`pack_farray` above." msgstr "" -#: ../src/Doc/library/xdrlib.rst:148 +#: library/xdrlib.rst:148 msgid "Unpacker Objects" msgstr "" -#: ../src/Doc/library/xdrlib.rst:150 +#: library/xdrlib.rst:150 msgid "The :class:`Unpacker` class offers the following methods:" msgstr "" -#: ../src/Doc/library/xdrlib.rst:155 +#: library/xdrlib.rst:155 msgid "Resets the string buffer with the given *data*." msgstr "" -#: ../src/Doc/library/xdrlib.rst:160 +#: library/xdrlib.rst:160 msgid "Returns the current unpack position in the data buffer." msgstr "" -#: ../src/Doc/library/xdrlib.rst:165 +#: library/xdrlib.rst:165 msgid "" "Sets the data buffer unpack position to *position*. You should be careful " "about using :meth:`get_position` and :meth:`set_position`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:171 +#: library/xdrlib.rst:171 msgid "Returns the current unpack data buffer as a string." msgstr "" -#: ../src/Doc/library/xdrlib.rst:176 +#: library/xdrlib.rst:176 msgid "" "Indicates unpack completion. Raises an :exc:`Error` exception if all of the " "data has not been unpacked." msgstr "" -#: ../src/Doc/library/xdrlib.rst:179 +#: library/xdrlib.rst:179 msgid "" "In addition, every data type that can be packed with a :class:`Packer`, can " "be unpacked with an :class:`Unpacker`. Unpacking methods are of the form " "``unpack_type()``, and take no arguments. They return the unpacked object." msgstr "" -#: ../src/Doc/library/xdrlib.rst:186 +#: library/xdrlib.rst:186 msgid "Unpacks a single-precision floating point number." msgstr "" -#: ../src/Doc/library/xdrlib.rst:191 +#: library/xdrlib.rst:191 msgid "" "Unpacks a double-precision floating point number, similarly to :meth:" "`unpack_float`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:194 +#: library/xdrlib.rst:194 msgid "" "In addition, the following methods unpack strings, bytes, and opaque data:" msgstr "" -#: ../src/Doc/library/xdrlib.rst:199 +#: library/xdrlib.rst:199 msgid "" "Unpacks and returns a fixed length string. *n* is the number of characters " "expected. Padding with null bytes to guaranteed 4 byte alignment is assumed." msgstr "" -#: ../src/Doc/library/xdrlib.rst:205 +#: library/xdrlib.rst:205 msgid "" "Unpacks and returns a fixed length opaque data stream, similarly to :meth:" "`unpack_fstring`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:211 +#: library/xdrlib.rst:211 msgid "" "Unpacks and returns a variable length string. The length of the string is " "first unpacked as an unsigned integer, then the string data is unpacked " "with :meth:`unpack_fstring`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:218 +#: library/xdrlib.rst:218 msgid "" "Unpacks and returns a variable length opaque data string, similarly to :meth:" "`unpack_string`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:224 +#: library/xdrlib.rst:224 msgid "" "Unpacks and returns a variable length byte stream, similarly to :meth:" "`unpack_string`." msgstr "" -#: ../src/Doc/library/xdrlib.rst:227 +#: library/xdrlib.rst:227 msgid "The following methods support unpacking arrays and lists:" msgstr "" -#: ../src/Doc/library/xdrlib.rst:232 +#: library/xdrlib.rst:232 msgid "" "Unpacks and returns a list of homogeneous items. The list is unpacked one " "element at a time by first unpacking an unsigned integer flag. If the flag " @@ -123009,53 +125971,53 @@ msgid "" "called to unpack the items." msgstr "" -#: ../src/Doc/library/xdrlib.rst:241 +#: library/xdrlib.rst:241 msgid "" "Unpacks and returns (as a list) a fixed length array of homogeneous items. " "*n* is number of list elements to expect in the buffer. As above, " "*unpack_item* is the function used to unpack each element." msgstr "" -#: ../src/Doc/library/xdrlib.rst:248 +#: library/xdrlib.rst:248 msgid "" "Unpacks and returns a variable length *list* of homogeneous items. First, " "the length of the list is unpacked as an unsigned integer, then each element " "is unpacked as in :meth:`unpack_farray` above." msgstr "" -#: ../src/Doc/library/xdrlib.rst:258 +#: library/xdrlib.rst:258 msgid "Exceptions in this module are coded as class instances:" msgstr "" # fd94986439564e66abd64d60581cd666 -#: ../src/Doc/library/xdrlib.rst:263 +#: library/xdrlib.rst:263 msgid "" "The base exception class. :exc:`Error` has a single public attribute :attr:" "`msg` containing the description of the error." msgstr "" -#: ../src/Doc/library/xdrlib.rst:269 +#: library/xdrlib.rst:269 msgid "" "Class derived from :exc:`Error`. Contains no additional instance variables." msgstr "" -#: ../src/Doc/library/xdrlib.rst:271 +#: library/xdrlib.rst:271 msgid "Here is an example of how you would catch one of these exceptions::" msgstr "" # 2999b9ecfaf94f659070e461fbbc7eb2 -#: ../src/Doc/library/xml.rst:4 +#: library/xml.rst:4 msgid "XML Processing Modules" msgstr "" # 2d143b56355f4b11837a234a72f901e1 -#: ../src/Doc/library/xml.rst:12 +#: library/xml.rst:12 msgid "" "Python's interfaces for processing XML are grouped in the ``xml`` package." msgstr "" # 1afbb3323a584a4aab067bc53b8605ba -#: ../src/Doc/library/xml.rst:16 +#: library/xml.rst:16 msgid "" "The XML modules are not secure against erroneous or maliciously constructed " "data. If you need to parse untrusted or unauthenticated data see :ref:`xml-" @@ -123063,7 +126025,7 @@ msgid "" msgstr "" # 5cc95d54931b4a5d8ef89eb8a4cb8842 -#: ../src/Doc/library/xml.rst:20 +#: library/xml.rst:20 msgid "" "It is important to note that modules in the :mod:`xml` package require that " "there be at least one SAX-compliant XML parser available. The Expat parser " @@ -123072,49 +126034,49 @@ msgid "" msgstr "" # d64a4a4aab084dcd9212283a3670df10 -#: ../src/Doc/library/xml.rst:28 +#: library/xml.rst:28 msgid "The XML handling submodules are:" msgstr "" # bb7608b26c6b416395227d483e63f34e -#: ../src/Doc/library/xml.rst:30 +#: library/xml.rst:30 msgid "" ":mod:`xml.etree.ElementTree`: the ElementTree API, a simple and lightweight " "XML processor" msgstr "" # 11e3424f891240d1be071fad9fd7d254 -#: ../src/Doc/library/xml.rst:35 +#: library/xml.rst:35 msgid ":mod:`xml.dom`: the DOM API definition" msgstr "" # 94830fbae548432db007aa1d04b20fa1 -#: ../src/Doc/library/xml.rst:36 +#: library/xml.rst:36 msgid ":mod:`xml.dom.minidom`: a minimal DOM implementation" msgstr "" # 686618b9bdff4f23b81f0154382590d2 -#: ../src/Doc/library/xml.rst:37 +#: library/xml.rst:37 msgid ":mod:`xml.dom.pulldom`: support for building partial DOM trees" msgstr "" # a79f6b933b6047508c4d30caa5499553 -#: ../src/Doc/library/xml.rst:41 +#: library/xml.rst:41 msgid ":mod:`xml.sax`: SAX2 base classes and convenience functions" msgstr "" # 092a23ba97c347e4bd8ec08f1290380a -#: ../src/Doc/library/xml.rst:42 +#: library/xml.rst:42 msgid ":mod:`xml.parsers.expat`: the Expat parser binding" msgstr "" # e6634385892b473b8254c107bdefa4d9 -#: ../src/Doc/library/xml.rst:48 +#: library/xml.rst:48 msgid "XML vulnerabilities" msgstr "" # 7fd557d669634c8c98093047a7280d78 -#: ../src/Doc/library/xml.rst:50 +#: library/xml.rst:50 msgid "" "The XML processing modules are not secure against maliciously constructed " "data. An attacker can abuse vulnerabilities for e.g. denial of service " @@ -123124,44 +126086,44 @@ msgid "" msgstr "" # 1b82e95292d843eb8f7806812c44ef24 -#: ../src/Doc/library/xml.rst:56 +#: library/xml.rst:56 msgid "" "The following table gives an overview of the known attacks and if the " "various modules are vulnerable to them." msgstr "" # 2f74be69a5b44b78916d7d50021949cb -#: ../src/Doc/library/xml.rst:60 +#: library/xml.rst:60 msgid "kind" msgstr "" # 7678fa1cf65c4a8bbbb8b21383ac5d4b -#: ../src/Doc/library/xml.rst:60 +#: library/xml.rst:60 msgid "sax" msgstr "" # 3c311724963f443fa5aa725f73f55c48 -#: ../src/Doc/library/xml.rst:60 +#: library/xml.rst:60 msgid "etree" msgstr "" # f9169d5291fb4d3caf1d34138865c3d5 -#: ../src/Doc/library/xml.rst:60 +#: library/xml.rst:60 msgid "minidom" msgstr "" # 6aa44d2d32624071b4aa60938b2220e0 -#: ../src/Doc/library/xml.rst:60 +#: library/xml.rst:60 msgid "pulldom" msgstr "" # 642f572dbaa245479cf8693e270feb43 -#: ../src/Doc/library/xml.rst:60 +#: library/xml.rst:60 msgid "xmlrpc" msgstr "" # b354b1e039264993abec42ac7fc5f0a4 -#: ../src/Doc/library/xml.rst:62 +#: library/xml.rst:62 msgid "billion laughs" msgstr "" @@ -123180,41 +126142,40 @@ msgstr "" # 44e39440e8904f4da04afd5a2162934a # b83fd5ecbe5c4bf3b8c5d38a000f08be # be309a32ffb54b0c9c2ffb1016a3f7f5 -#: ../src/Doc/library/xml.rst:62 ../src/Doc/library/xml.rst:63 -#: ../src/Doc/library/xml.rst:64 ../src/Doc/library/xml.rst:65 -#: ../src/Doc/library/xml.rst:66 +#: library/xml.rst:62 library/xml.rst:63 library/xml.rst:64 library/xml.rst:65 +#: library/xml.rst:66 msgid "**Yes**" msgstr "" # e36c62df61fe4d4692ea65411914235b -#: ../src/Doc/library/xml.rst:63 +#: library/xml.rst:63 msgid "quadratic blowup" msgstr "" # b5084d0003d04c1cb6a0b8a3a6b1e4df # fa41237fae4e40be85197f03a1bdb72c -#: ../src/Doc/library/xml.rst:64 ../src/Doc/library/xml.rst:94 +#: library/xml.rst:64 library/xml.rst:95 msgid "external entity expansion" msgstr "" # 21586e7fd92845f7826327635f1cb548 -#: ../src/Doc/library/xml.rst:64 +#: library/xml.rst:64 msgid "No (1)" msgstr "" # 9a4ed72cd5044a2c83896ff579c66d38 -#: ../src/Doc/library/xml.rst:64 +#: library/xml.rst:64 msgid "No (2)" msgstr "" # 88219a58f590469b8e7409fca7b09293 -#: ../src/Doc/library/xml.rst:64 +#: library/xml.rst:64 msgid "No (3)" msgstr "" # 06e9a575bf244474a85789d4cb397cc1 # 8a774a775f774f5c86a77941fb0dbc22 -#: ../src/Doc/library/xml.rst:65 ../src/Doc/library/xml.rst:99 +#: library/xml.rst:65 library/xml.rst:100 msgid "DTD retrieval" msgstr "" @@ -123225,42 +126186,42 @@ msgstr "" # d2fb514bee714efc932923fe3d0210b7 # 1763fcc5de81453cb0e2c6b69a34c79c # 2c8f42a194884207bb8561209ce6fc5f -#: ../src/Doc/library/xml.rst:65 ../src/Doc/library/xml.rst:66 +#: library/xml.rst:65 library/xml.rst:66 msgid "No" msgstr "" # d566281d62dc4d1cb37d7eb9464039f4 # 79ddb585e2074685a593b6ae9c4ac7af -#: ../src/Doc/library/xml.rst:66 ../src/Doc/library/xml.rst:105 +#: library/xml.rst:66 library/xml.rst:106 msgid "decompression bomb" msgstr "" # eff715ee7ded489cbd5488dd54c234b9 -#: ../src/Doc/library/xml.rst:69 +#: library/xml.rst:69 msgid "" ":mod:`xml.etree.ElementTree` doesn't expand external entities and raises a " "ParserError when an entity occurs." msgstr "" # b259641226794f72a13ca3b01afe48b0 -#: ../src/Doc/library/xml.rst:71 +#: library/xml.rst:71 msgid "" ":mod:`xml.dom.minidom` doesn't expand external entities and simply returns " "the unexpanded entity verbatim." msgstr "" # da6ca7976c3846ada318f6d127692bdd -#: ../src/Doc/library/xml.rst:73 +#: library/xml.rst:73 msgid ":mod:`xmlrpclib` doesn't expand external entities and omits them." msgstr "" # 89e6a79140d94246b717a44b584b0fc7 -#: ../src/Doc/library/xml.rst:80 +#: library/xml.rst:81 msgid "billion laughs / exponential entity expansion" msgstr "" # 31a3096499d8466c8551db0a52cfc81a -#: ../src/Doc/library/xml.rst:77 +#: library/xml.rst:77 msgid "" "The `Billion Laughs`_ attack -- also known as exponential entity expansion " "-- uses multiple levels of nested entities. Each entity refers to another " @@ -123270,12 +126231,12 @@ msgid "" msgstr "" # 86ba72db2a21476dae8e3dcb1aef16a0 -#: ../src/Doc/library/xml.rst:87 +#: library/xml.rst:88 msgid "quadratic blowup entity expansion" msgstr "" # c4f6ebc55eb2430bb365394e9fc22c0f -#: ../src/Doc/library/xml.rst:84 +#: library/xml.rst:84 msgid "" "A quadratic blowup attack is similar to a `Billion Laughs`_ attack; it " "abuses entity expansion, too. Instead of nested entities it repeats one " @@ -123285,7 +126246,7 @@ msgid "" msgstr "" # b0567227d6154949904c1c1e00cf99e1 -#: ../src/Doc/library/xml.rst:91 +#: library/xml.rst:91 msgid "" "Entity declarations can contain more than just text for replacement. They " "can also point to external resources by public identifiers or system " @@ -123295,7 +126256,7 @@ msgid "" msgstr "" # 15810113efb14aaba897219f876f3363 -#: ../src/Doc/library/xml.rst:98 +#: library/xml.rst:98 msgid "" "Some XML libraries like Python's :mod:`xml.dom.pulldom` retrieve document " "type definitions from remote or local locations. The feature has similar " @@ -123303,7 +126264,7 @@ msgid "" msgstr "" # 2519718bd9bf4f14a82bfd90ef1611e1 -#: ../src/Doc/library/xml.rst:103 +#: library/xml.rst:103 msgid "" "The issue of decompression bombs (aka `ZIP bomb`_) apply to all XML " "libraries that can parse compressed XML stream like gzipped HTTP streams or " @@ -123312,26 +126273,26 @@ msgid "" msgstr "" # 24679541ecfe4d06acd3b3217717835c -#: ../src/Doc/library/xml.rst:108 +#: library/xml.rst:108 msgid "" "The documentation of `defusedxml`_ on PyPI has further information about all " "known attack vectors with examples and references." msgstr "" # 2b2aa4e1c3644c75addafc164d3dc661 -#: ../src/Doc/library/xml.rst:112 +#: library/xml.rst:112 msgid "defused packages" msgstr "" # 8ed1ff8abc6a44e0a9b3171afe9e1fcb -#: ../src/Doc/library/xml.rst:114 +#: library/xml.rst:114 msgid "" "These external packages are recommended for any code that parses untrusted " "XML data." msgstr "" # b686a3d778f44c369d4ccda0c1f7d079 -#: ../src/Doc/library/xml.rst:117 +#: library/xml.rst:117 msgid "" "`defusedxml`_ is a pure Python package with modified subclasses of all " "stdlib XML parsers that prevent any potentially malicious operation. The " @@ -123340,7 +126301,7 @@ msgid "" msgstr "" # 99efbb591f764b6a945e874efa62d6c4 -#: ../src/Doc/library/xml.rst:122 +#: library/xml.rst:122 msgid "" "`defusedexpat`_ provides a modified libexpat and patched replacement :mod:" "`pyexpat` extension module with countermeasures against entity expansion DoS " @@ -123349,18 +126310,18 @@ msgid "" msgstr "" # 956b0d15191f4d02bd4ff4e57d0c245a -#: ../src/Doc/library/xml.rst:127 +#: library/xml.rst:127 msgid "" "The workarounds and modifications are not included in patch releases as they " "break backward compatibility. After all inline DTD and entity expansion are " "well-defined XML features." msgstr "" -#: ../src/Doc/library/xml.dom.rst:3 +#: library/xml.dom.rst:3 msgid ":mod:`xml.dom` --- The Document Object Model API" msgstr "" -#: ../src/Doc/library/xml.dom.rst:13 +#: library/xml.dom.rst:13 msgid "" "The Document Object Model, or \"DOM,\" is a cross-language API from the " "World Wide Web Consortium (W3C) for accessing and modifying XML documents. " @@ -123369,7 +126330,7 @@ msgid "" "the structure through a set of objects which provided well-known interfaces." msgstr "" -#: ../src/Doc/library/xml.dom.rst:19 +#: library/xml.dom.rst:19 msgid "" "The DOM is extremely useful for random-access applications. SAX only allows " "you a view of one bit of the document at a time. If you are looking at one " @@ -123380,7 +126341,7 @@ msgid "" "you need to look ahead in the XML document, you are just out of luck." msgstr "" -#: ../src/Doc/library/xml.dom.rst:27 +#: library/xml.dom.rst:27 msgid "" "Some applications are simply impossible in an event driven model with no " "access to a tree. Of course you could build some sort of tree yourself in " @@ -123388,14 +126349,14 @@ msgid "" "standard tree representation for XML data." msgstr "" -#: ../src/Doc/library/xml.dom.rst:32 +#: library/xml.dom.rst:32 msgid "" "The Document Object Model is being defined by the W3C in stages, or \"levels" "\" in their terminology. The Python mapping of the API is substantially " "based on the DOM Level 2 recommendation." msgstr "" -#: ../src/Doc/library/xml.dom.rst:51 +#: library/xml.dom.rst:51 msgid "" "DOM applications typically start by parsing some XML into a DOM. How this " "is accomplished is not covered at all by DOM Level 1, and Level 2 provides " @@ -123409,7 +126370,7 @@ msgid "" "reader, but this is not yet available in the Python standard library." msgstr "" -#: ../src/Doc/library/xml.dom.rst:62 +#: library/xml.dom.rst:62 msgid "" "Once you have a DOM document object, you can access the parts of your XML " "document through its properties and methods. These properties are defined " @@ -123417,7 +126378,7 @@ msgid "" "interpretation of the specification in Python." msgstr "" -#: ../src/Doc/library/xml.dom.rst:67 +#: library/xml.dom.rst:67 msgid "" "The specification provided by the W3C defines the DOM API for Java, " "ECMAScript, and OMG IDL. The Python mapping defined here is based in large " @@ -123427,45 +126388,35 @@ msgid "" "mapping requirements." msgstr "" -# 614a0b8c7bde42b68eb539a369df263a -#: ../src/Doc/library/xml.dom.rst:76 -msgid "" -"`Document Object Model (DOM) Level 2 Specification <http://www.w3.org/TR/DOM-" -"Level-2-Core/>`_" +#: library/xml.dom.rst:77 +msgid "Document Object Model (DOM) Level 2 Specification" msgstr "" -#: ../src/Doc/library/xml.dom.rst:77 +#: library/xml.dom.rst:77 msgid "The W3C recommendation upon which the Python DOM API is based." msgstr "" -# 24bb44b5828b46f2ac0bf90786897262 -# fdc57a8b77b64408aa96f0d69a6e904e -#: ../src/Doc/library/xml.dom.rst:79 ../src/Doc/library/xml.dom.minidom.rst:109 -msgid "" -"`Document Object Model (DOM) Level 1 Specification <http://www.w3.org/TR/REC-" -"DOM-Level-1/>`_" +#: library/xml.dom.rst:80 library/xml.dom.minidom.rst:110 +msgid "Document Object Model (DOM) Level 1 Specification" msgstr "" -#: ../src/Doc/library/xml.dom.rst:80 ../src/Doc/library/xml.dom.minidom.rst:111 +#: library/xml.dom.rst:80 library/xml.dom.minidom.rst:111 msgid "The W3C recommendation for the DOM supported by :mod:`xml.dom.minidom`." msgstr "" -# 583eab7959c94adfafa20aea32845894 -#: ../src/Doc/library/xml.dom.rst:81 -msgid "" -"`Python Language Mapping Specification <http://www.omg.org/spec/PYTH/1.2/" -"PDF>`_" +#: library/xml.dom.rst:82 +msgid "Python Language Mapping Specification" msgstr "" -#: ../src/Doc/library/xml.dom.rst:83 +#: library/xml.dom.rst:83 msgid "This specifies the mapping from OMG IDL to Python." msgstr "" -#: ../src/Doc/library/xml.dom.rst:89 +#: library/xml.dom.rst:89 msgid "The :mod:`xml.dom` contains the following functions:" msgstr "" -#: ../src/Doc/library/xml.dom.rst:94 +#: library/xml.dom.rst:94 msgid "" "Register the *factory* function with the name *name*. The factory function " "should return an object which implements the :class:`DOMImplementation` " @@ -123474,7 +126425,7 @@ msgid "" "if that implementation supports some customization)." msgstr "" -#: ../src/Doc/library/xml.dom.rst:103 +#: library/xml.dom.rst:103 msgid "" "Return a suitable DOM implementation. The *name* is either well-known, the " "module name of a DOM implementation, or ``None``. If it is not ``None``, " @@ -123484,7 +126435,7 @@ msgid "" "implementation." msgstr "" -#: ../src/Doc/library/xml.dom.rst:109 +#: library/xml.dom.rst:109 msgid "" "If name is not given, this examines the available implementations to find " "one with the required feature set. If no implementation can be found, raise " @@ -123493,37 +126444,37 @@ msgid "" "available :class:`DOMImplementation` objects." msgstr "" -#: ../src/Doc/library/xml.dom.rst:115 +#: library/xml.dom.rst:115 msgid "Some convenience constants are also provided:" msgstr "" -#: ../src/Doc/library/xml.dom.rst:120 +#: library/xml.dom.rst:120 msgid "" "The value used to indicate that no namespace is associated with a node in " "the DOM. This is typically found as the :attr:`namespaceURI` of a node, or " "used as the *namespaceURI* parameter to a namespaces-specific method." msgstr "" -#: ../src/Doc/library/xml.dom.rst:129 +#: library/xml.dom.rst:129 msgid "" "The namespace URI associated with the reserved prefix ``xml``, as defined by " "`Namespaces in XML <http://www.w3.org/TR/REC-xml-names/>`_ (section 4)." msgstr "" -#: ../src/Doc/library/xml.dom.rst:137 +#: library/xml.dom.rst:137 msgid "" "The namespace URI for namespace declarations, as defined by `Document Object " "Model (DOM) Level 2 Core Specification <http://www.w3.org/TR/DOM-Level-2-" "Core/core.html>`_ (section 1.1.8)." msgstr "" -#: ../src/Doc/library/xml.dom.rst:146 +#: library/xml.dom.rst:146 msgid "" "The URI of the XHTML namespace as defined by `XHTML 1.0: The Extensible " "HyperText Markup Language <http://www.w3.org/TR/xhtml1/>`_ (section 3.1.1)." msgstr "" -#: ../src/Doc/library/xml.dom.rst:151 +#: library/xml.dom.rst:151 msgid "" "In addition, :mod:`xml.dom` contains a base :class:`Node` class and the DOM " "exception classes. The :class:`Node` class provided by this module does not " @@ -123535,162 +126486,162 @@ msgid "" "DOM specifications." msgstr "" -#: ../src/Doc/library/xml.dom.rst:166 +#: library/xml.dom.rst:166 msgid "Objects in the DOM" msgstr "" -#: ../src/Doc/library/xml.dom.rst:168 +#: library/xml.dom.rst:168 msgid "" "The definitive documentation for the DOM is the DOM specification from the " "W3C." msgstr "" -#: ../src/Doc/library/xml.dom.rst:170 +#: library/xml.dom.rst:170 msgid "" "Note that DOM attributes may also be manipulated as nodes instead of as " "simple strings. It is fairly rare that you must do this, however, so this " "usage is not yet documented." msgstr "" -#: ../src/Doc/library/xml.dom.rst:175 +#: library/xml.dom.rst:175 msgid "Interface" msgstr "" -#: ../src/Doc/library/xml.dom.rst:175 +#: library/xml.dom.rst:175 msgid "Section" msgstr "" -#: ../src/Doc/library/xml.dom.rst:177 +#: library/xml.dom.rst:177 msgid ":class:`DOMImplementation`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:177 +#: library/xml.dom.rst:177 msgid ":ref:`dom-implementation-objects`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:177 +#: library/xml.dom.rst:177 msgid "Interface to the underlying implementation." msgstr "" -#: ../src/Doc/library/xml.dom.rst:180 +#: library/xml.dom.rst:180 msgid ":class:`Node`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:180 +#: library/xml.dom.rst:180 msgid ":ref:`dom-node-objects`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:180 +#: library/xml.dom.rst:180 msgid "Base interface for most objects in a document." msgstr "" -#: ../src/Doc/library/xml.dom.rst:183 +#: library/xml.dom.rst:183 msgid ":class:`NodeList`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:183 +#: library/xml.dom.rst:183 msgid ":ref:`dom-nodelist-objects`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:183 +#: library/xml.dom.rst:183 msgid "Interface for a sequence of nodes." msgstr "" -#: ../src/Doc/library/xml.dom.rst:186 +#: library/xml.dom.rst:186 msgid ":class:`DocumentType`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:186 +#: library/xml.dom.rst:186 msgid ":ref:`dom-documenttype-objects`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:186 +#: library/xml.dom.rst:186 msgid "Information about the declarations needed to process a document." msgstr "" -#: ../src/Doc/library/xml.dom.rst:190 +#: library/xml.dom.rst:190 msgid ":class:`Document`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:190 +#: library/xml.dom.rst:190 msgid ":ref:`dom-document-objects`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:190 +#: library/xml.dom.rst:190 msgid "Object which represents an entire document." msgstr "" -#: ../src/Doc/library/xml.dom.rst:193 +#: library/xml.dom.rst:193 msgid ":class:`Element`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:193 +#: library/xml.dom.rst:193 msgid ":ref:`dom-element-objects`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:193 +#: library/xml.dom.rst:193 msgid "Element nodes in the document hierarchy." msgstr "" -#: ../src/Doc/library/xml.dom.rst:196 +#: library/xml.dom.rst:196 msgid ":class:`Attr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:196 +#: library/xml.dom.rst:196 msgid ":ref:`dom-attr-objects`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:196 +#: library/xml.dom.rst:196 msgid "Attribute value nodes on element nodes." msgstr "" -#: ../src/Doc/library/xml.dom.rst:199 +#: library/xml.dom.rst:199 msgid ":class:`Comment`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:199 +#: library/xml.dom.rst:199 msgid ":ref:`dom-comment-objects`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:199 +#: library/xml.dom.rst:199 msgid "Representation of comments in the source document." msgstr "" -#: ../src/Doc/library/xml.dom.rst:202 +#: library/xml.dom.rst:202 msgid ":class:`Text`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:202 +#: library/xml.dom.rst:202 msgid ":ref:`dom-text-objects`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:202 +#: library/xml.dom.rst:202 msgid "Nodes containing textual content from the document." msgstr "" -#: ../src/Doc/library/xml.dom.rst:205 +#: library/xml.dom.rst:205 msgid ":class:`ProcessingInstruction`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:205 +#: library/xml.dom.rst:205 msgid ":ref:`dom-pi-objects`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:205 +#: library/xml.dom.rst:205 msgid "Processing instruction representation." msgstr "" -#: ../src/Doc/library/xml.dom.rst:209 +#: library/xml.dom.rst:209 msgid "" "An additional section describes the exceptions defined for working with the " "DOM in Python." msgstr "" -#: ../src/Doc/library/xml.dom.rst:216 +#: library/xml.dom.rst:216 msgid "DOMImplementation Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:218 +#: library/xml.dom.rst:218 msgid "" "The :class:`DOMImplementation` interface provides a way for applications to " "determine the availability of particular features in the DOM they are using. " @@ -123698,13 +126649,13 @@ msgid "" "`DocumentType` objects using the :class:`DOMImplementation` as well." msgstr "" -#: ../src/Doc/library/xml.dom.rst:226 +#: library/xml.dom.rst:226 msgid "" "Return true if the feature identified by the pair of strings *feature* and " "*version* is implemented." msgstr "" -#: ../src/Doc/library/xml.dom.rst:232 +#: library/xml.dom.rst:232 msgid "" "Return a new :class:`Document` object (the root of the DOM), with a child :" "class:`Element` object having the given *namespaceUri* and *qualifiedName*. " @@ -123714,23 +126665,23 @@ msgid "" "child is to be created." msgstr "" -#: ../src/Doc/library/xml.dom.rst:242 +#: library/xml.dom.rst:242 msgid "" "Return a new :class:`DocumentType` object that encapsulates the given " "*qualifiedName*, *publicId*, and *systemId* strings, representing the " "information contained in an XML document type declaration." msgstr "" -#: ../src/Doc/library/xml.dom.rst:250 +#: library/xml.dom.rst:250 msgid "Node Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:252 +#: library/xml.dom.rst:252 msgid "" "All of the components of an XML document are subclasses of :class:`Node`." msgstr "" -#: ../src/Doc/library/xml.dom.rst:257 +#: library/xml.dom.rst:257 msgid "" "An integer representing the node type. Symbolic constants for the types are " "on the :class:`Node` object: :const:`ELEMENT_NODE`, :const:" @@ -123740,7 +126691,7 @@ msgid "" "This is a read-only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:267 +#: library/xml.dom.rst:267 msgid "" "The parent of the current node, or ``None`` for the document node. The value " "is always a :class:`Node` object or ``None``. For :class:`Element` nodes, " @@ -123749,14 +126700,14 @@ msgid "" "always ``None``. This is a read-only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:276 +#: library/xml.dom.rst:276 msgid "" "A :class:`NamedNodeMap` of attribute objects. Only elements have actual " "values for this; others provide ``None`` for this attribute. This is a read-" "only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:283 +#: library/xml.dom.rst:283 msgid "" "The node that immediately precedes this one with the same parent. For " "instance the element with an end-tag that comes just before the *self* " @@ -123766,49 +126717,49 @@ msgid "" "``None``. This is a read-only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:293 +#: library/xml.dom.rst:293 msgid "" "The node that immediately follows this one with the same parent. See also :" "attr:`previousSibling`. If this is the last child of the parent, this " "attribute will be ``None``. This is a read-only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:300 +#: library/xml.dom.rst:300 msgid "" "A list of nodes contained within this node. This is a read-only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:305 +#: library/xml.dom.rst:305 msgid "" "The first child of the node, if there are any, or ``None``. This is a read-" "only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:311 +#: library/xml.dom.rst:311 msgid "" "The last child of the node, if there are any, or ``None``. This is a read-" "only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:317 +#: library/xml.dom.rst:317 msgid "" "The part of the :attr:`tagName` following the colon if there is one, else " "the entire :attr:`tagName`. The value is a string." msgstr "" -#: ../src/Doc/library/xml.dom.rst:323 +#: library/xml.dom.rst:323 msgid "" "The part of the :attr:`tagName` preceding the colon if there is one, else " -"the empty string. The value is a string, or ``None``" +"the empty string. The value is a string, or ``None``." msgstr "" -#: ../src/Doc/library/xml.dom.rst:329 +#: library/xml.dom.rst:329 msgid "" "The namespace associated with the element name. This will be a string or " "``None``. This is a read-only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:335 +#: library/xml.dom.rst:335 msgid "" "This has a different meaning for each node type; see the DOM specification " "for details. You can always get the information you would get here from " @@ -123818,29 +126769,29 @@ msgid "" "attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:344 +#: library/xml.dom.rst:344 msgid "" "This has a different meaning for each node type; see the DOM specification " "for details. The situation is similar to that with :attr:`nodeName`. The " "value is a string or ``None``." msgstr "" -#: ../src/Doc/library/xml.dom.rst:351 +#: library/xml.dom.rst:351 msgid "Returns true if the node has any attributes." msgstr "" -#: ../src/Doc/library/xml.dom.rst:356 +#: library/xml.dom.rst:356 msgid "Returns true if the node has any child nodes." msgstr "" -#: ../src/Doc/library/xml.dom.rst:361 +#: library/xml.dom.rst:361 msgid "" "Returns true if *other* refers to the same node as this node. This is " "especially useful for DOM implementations which use any sort of proxy " "architecture (because more than one object can refer to the same node)." msgstr "" -#: ../src/Doc/library/xml.dom.rst:367 +#: library/xml.dom.rst:367 msgid "" "This is based on a proposed DOM Level 3 API which is still in the \"working " "draft\" stage, but this particular interface appears uncontroversial. " @@ -123849,14 +126800,14 @@ msgid "" msgstr "" # 91d2032a123b47e78819099afcf0675f -#: ../src/Doc/library/xml.dom.rst:375 +#: library/xml.dom.rst:375 msgid "" "Add a new child node to this node at the end of the list of children, " "returning *newChild*. If the node was already in the tree, it is removed " "first." msgstr "" -#: ../src/Doc/library/xml.dom.rst:382 +#: library/xml.dom.rst:382 msgid "" "Insert a new child node before an existing child. It must be the case that " "*refChild* is a child of this node; if not, :exc:`ValueError` is raised. " @@ -123864,37 +126815,37 @@ msgid "" "the end of the children's list." msgstr "" -#: ../src/Doc/library/xml.dom.rst:390 +#: library/xml.dom.rst:390 msgid "" "Remove a child node. *oldChild* must be a child of this node; if not, :exc:" "`ValueError` is raised. *oldChild* is returned on success. If *oldChild* " "will not be used further, its :meth:`unlink` method should be called." msgstr "" -#: ../src/Doc/library/xml.dom.rst:397 +#: library/xml.dom.rst:397 msgid "" "Replace an existing node with a new node. It must be the case that " "*oldChild* is a child of this node; if not, :exc:`ValueError` is raised." msgstr "" -#: ../src/Doc/library/xml.dom.rst:403 +#: library/xml.dom.rst:403 msgid "" "Join adjacent text nodes so that all stretches of text are stored as single :" "class:`Text` instances. This simplifies processing text from a DOM tree for " "many applications." msgstr "" -#: ../src/Doc/library/xml.dom.rst:412 +#: library/xml.dom.rst:412 msgid "" "Clone this node. Setting *deep* means to clone all child nodes as well. " "This returns the clone." msgstr "" -#: ../src/Doc/library/xml.dom.rst:419 +#: library/xml.dom.rst:419 msgid "NodeList Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:421 +#: library/xml.dom.rst:421 msgid "" "A :class:`NodeList` represents a sequence of nodes. These objects are used " "in two ways in the DOM Core recommendation: the :class:`Element` objects " @@ -123903,25 +126854,25 @@ msgid "" "`Node` return objects with this interface to represent query results." msgstr "" -#: ../src/Doc/library/xml.dom.rst:427 +#: library/xml.dom.rst:427 msgid "" "The DOM Level 2 recommendation defines one method and one attribute for " "these objects:" msgstr "" -#: ../src/Doc/library/xml.dom.rst:433 +#: library/xml.dom.rst:433 msgid "" "Return the *i*'th item from the sequence, if there is one, or ``None``. The " "index *i* is not allowed to be less then zero or greater than or equal to " "the length of the sequence." msgstr "" -#: ../src/Doc/library/xml.dom.rst:440 +#: library/xml.dom.rst:440 msgid "The number of nodes in the sequence." msgstr "" # c0f63a2bc7be42cdbadfe7e4b7ae239c -#: ../src/Doc/library/xml.dom.rst:442 +#: library/xml.dom.rst:442 msgid "" "In addition, the Python DOM interface requires that some additional support " "is provided to allow :class:`NodeList` objects to be used as Python " @@ -123932,18 +126883,18 @@ msgid "" msgstr "" # 0ee57419cdd440be8524032f993b8806 -#: ../src/Doc/library/xml.dom.rst:450 +#: library/xml.dom.rst:450 msgid "" "If a DOM implementation supports modification of the document, the :class:" "`NodeList` implementation must also support the :meth:`~object.__setitem__` " "and :meth:`~object.__delitem__` methods." msgstr "" -#: ../src/Doc/library/xml.dom.rst:458 +#: library/xml.dom.rst:458 msgid "DocumentType Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:460 +#: library/xml.dom.rst:460 msgid "" "Information about the notations and entities declared by a document " "(including the external subset if the parser uses it and can provide the " @@ -123954,38 +126905,38 @@ msgid "" "``None`` instead of an instance of this interface." msgstr "" -#: ../src/Doc/library/xml.dom.rst:468 +#: library/xml.dom.rst:468 msgid "" ":class:`DocumentType` is a specialization of :class:`Node`, and adds the " "following attributes:" msgstr "" -#: ../src/Doc/library/xml.dom.rst:474 +#: library/xml.dom.rst:474 msgid "" "The public identifier for the external subset of the document type " "definition. This will be a string or ``None``." msgstr "" -#: ../src/Doc/library/xml.dom.rst:480 +#: library/xml.dom.rst:480 msgid "" "The system identifier for the external subset of the document type " "definition. This will be a URI as a string, or ``None``." msgstr "" -#: ../src/Doc/library/xml.dom.rst:486 +#: library/xml.dom.rst:486 msgid "" "A string giving the complete internal subset from the document. This does " "not include the brackets which enclose the subset. If the document has no " "internal subset, this should be ``None``." msgstr "" -#: ../src/Doc/library/xml.dom.rst:493 +#: library/xml.dom.rst:493 msgid "" "The name of the root element as given in the ``DOCTYPE`` declaration, if " "present." msgstr "" -#: ../src/Doc/library/xml.dom.rst:499 +#: library/xml.dom.rst:499 msgid "" "This is a :class:`NamedNodeMap` giving the definitions of external entities. " "For entity names defined more than once, only the first definition is " @@ -123994,7 +126945,7 @@ msgid "" "entities are defined." msgstr "" -#: ../src/Doc/library/xml.dom.rst:508 +#: library/xml.dom.rst:508 msgid "" "This is a :class:`NamedNodeMap` giving the definitions of notations. For " "notation names defined more than once, only the first definition is provided " @@ -124003,29 +126954,29 @@ msgid "" "notations are defined." msgstr "" -#: ../src/Doc/library/xml.dom.rst:518 +#: library/xml.dom.rst:518 msgid "Document Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:520 +#: library/xml.dom.rst:520 msgid "" "A :class:`Document` represents an entire XML document, including its " "constituent elements, attributes, processing instructions, comments etc. " "Remember that it inherits properties from :class:`Node`." msgstr "" -#: ../src/Doc/library/xml.dom.rst:527 +#: library/xml.dom.rst:527 msgid "The one and only root element of the document." msgstr "" -#: ../src/Doc/library/xml.dom.rst:532 +#: library/xml.dom.rst:532 msgid "" "Create and return a new element node. The element is not inserted into the " "document when it is created. You need to explicitly insert it with one of " "the other methods such as :meth:`insertBefore` or :meth:`appendChild`." msgstr "" -#: ../src/Doc/library/xml.dom.rst:539 +#: library/xml.dom.rst:539 msgid "" "Create and return a new element with a namespace. The *tagName* may have a " "prefix. The element is not inserted into the document when it is created. " @@ -124033,28 +126984,28 @@ msgid "" "`insertBefore` or :meth:`appendChild`." msgstr "" -#: ../src/Doc/library/xml.dom.rst:547 +#: library/xml.dom.rst:547 msgid "" "Create and return a text node containing the data passed as a parameter. As " "with the other creation methods, this one does not insert the node into the " "tree." msgstr "" -#: ../src/Doc/library/xml.dom.rst:554 +#: library/xml.dom.rst:554 msgid "" "Create and return a comment node containing the data passed as a parameter. " "As with the other creation methods, this one does not insert the node into " "the tree." msgstr "" -#: ../src/Doc/library/xml.dom.rst:561 +#: library/xml.dom.rst:561 msgid "" "Create and return a processing instruction node containing the *target* and " "*data* passed as parameters. As with the other creation methods, this one " "does not insert the node into the tree." msgstr "" -#: ../src/Doc/library/xml.dom.rst:568 +#: library/xml.dom.rst:568 msgid "" "Create and return an attribute node. This method does not associate the " "attribute node with any particular element. You must use :meth:" @@ -124062,7 +127013,7 @@ msgid "" "newly created attribute instance." msgstr "" -#: ../src/Doc/library/xml.dom.rst:576 +#: library/xml.dom.rst:576 msgid "" "Create and return an attribute node with a namespace. The *tagName* may " "have a prefix. This method does not associate the attribute node with any " @@ -124071,96 +127022,95 @@ msgid "" "instance." msgstr "" -#: ../src/Doc/library/xml.dom.rst:584 +#: library/xml.dom.rst:584 msgid "" "Search for all descendants (direct children, children's children, etc.) with " "a particular element type name." msgstr "" -#: ../src/Doc/library/xml.dom.rst:590 +#: library/xml.dom.rst:590 msgid "" "Search for all descendants (direct children, children's children, etc.) with " "a particular namespace URI and localname. The localname is the part of the " "namespace after the prefix." msgstr "" -#: ../src/Doc/library/xml.dom.rst:598 -#: ../src/Doc/library/xml.etree.elementtree.rst:512 +#: library/xml.dom.rst:598 library/xml.etree.elementtree.rst:583 msgid "Element Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:600 +#: library/xml.dom.rst:600 msgid "" ":class:`Element` is a subclass of :class:`Node`, so inherits all the " "attributes of that class." msgstr "" -#: ../src/Doc/library/xml.dom.rst:606 +#: library/xml.dom.rst:606 msgid "" "The element type name. In a namespace-using document it may have colons in " "it. The value is a string." msgstr "" -#: ../src/Doc/library/xml.dom.rst:612 ../src/Doc/library/xml.dom.rst:617 +#: library/xml.dom.rst:612 library/xml.dom.rst:617 msgid "Same as equivalent method in the :class:`Document` class." msgstr "" -#: ../src/Doc/library/xml.dom.rst:622 +#: library/xml.dom.rst:622 msgid "Returns true if the element has an attribute named by *name*." msgstr "" -#: ../src/Doc/library/xml.dom.rst:627 +#: library/xml.dom.rst:627 msgid "" "Returns true if the element has an attribute named by *namespaceURI* and " "*localName*." msgstr "" -#: ../src/Doc/library/xml.dom.rst:633 +#: library/xml.dom.rst:633 msgid "" "Return the value of the attribute named by *name* as a string. If no such " "attribute exists, an empty string is returned, as if the attribute had no " "value." msgstr "" -#: ../src/Doc/library/xml.dom.rst:639 +#: library/xml.dom.rst:639 msgid "Return the :class:`Attr` node for the attribute named by *attrname*." msgstr "" -#: ../src/Doc/library/xml.dom.rst:644 +#: library/xml.dom.rst:644 msgid "" "Return the value of the attribute named by *namespaceURI* and *localName* as " "a string. If no such attribute exists, an empty string is returned, as if " "the attribute had no value." msgstr "" -#: ../src/Doc/library/xml.dom.rst:651 +#: library/xml.dom.rst:651 msgid "" "Return an attribute value as a node, given a *namespaceURI* and *localName*." msgstr "" -#: ../src/Doc/library/xml.dom.rst:656 +#: library/xml.dom.rst:656 msgid "" "Remove an attribute by name. If there is no matching attribute, a :exc:" "`NotFoundErr` is raised." msgstr "" -#: ../src/Doc/library/xml.dom.rst:662 +#: library/xml.dom.rst:662 msgid "" "Remove and return *oldAttr* from the attribute list, if present. If " "*oldAttr* is not present, :exc:`NotFoundErr` is raised." msgstr "" -#: ../src/Doc/library/xml.dom.rst:668 +#: library/xml.dom.rst:668 msgid "" "Remove an attribute by name. Note that it uses a localName, not a qname. " "No exception is raised if there is no matching attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:674 +#: library/xml.dom.rst:674 msgid "Set an attribute value from a string." msgstr "" -#: ../src/Doc/library/xml.dom.rst:679 +#: library/xml.dom.rst:679 msgid "" "Add a new attribute node to the element, replacing an existing attribute if " "necessary if the :attr:`name` attribute matches. If a replacement occurs, " @@ -124168,7 +127118,7 @@ msgid "" "exc:`InuseAttributeErr` will be raised." msgstr "" -#: ../src/Doc/library/xml.dom.rst:687 +#: library/xml.dom.rst:687 msgid "" "Add a new attribute node to the element, replacing an existing attribute if " "necessary if the :attr:`namespaceURI` and :attr:`localName` attributes " @@ -124176,57 +127126,57 @@ msgid "" "*newAttr* is already in use, :exc:`InuseAttributeErr` will be raised." msgstr "" -#: ../src/Doc/library/xml.dom.rst:695 +#: library/xml.dom.rst:695 msgid "" "Set an attribute value from a string, given a *namespaceURI* and a *qname*. " "Note that a qname is the whole attribute name. This is different than above." msgstr "" -#: ../src/Doc/library/xml.dom.rst:702 +#: library/xml.dom.rst:702 msgid "Attr Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:704 +#: library/xml.dom.rst:704 msgid "" ":class:`Attr` inherits from :class:`Node`, so inherits all its attributes." msgstr "" -#: ../src/Doc/library/xml.dom.rst:709 +#: library/xml.dom.rst:709 msgid "" "The attribute name. In a namespace-using document it may include a colon." msgstr "" -#: ../src/Doc/library/xml.dom.rst:715 +#: library/xml.dom.rst:715 msgid "" "The part of the name following the colon if there is one, else the entire " "name. This is a read-only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:722 +#: library/xml.dom.rst:722 msgid "" "The part of the name preceding the colon if there is one, else the empty " "string." msgstr "" -#: ../src/Doc/library/xml.dom.rst:728 +#: library/xml.dom.rst:728 msgid "" "The text value of the attribute. This is a synonym for the :attr:" "`nodeValue` attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:735 +#: library/xml.dom.rst:735 msgid "NamedNodeMap Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:737 +#: library/xml.dom.rst:737 msgid ":class:`NamedNodeMap` does *not* inherit from :class:`Node`." msgstr "" -#: ../src/Doc/library/xml.dom.rst:742 +#: library/xml.dom.rst:742 msgid "The length of the attribute list." msgstr "" -#: ../src/Doc/library/xml.dom.rst:747 +#: library/xml.dom.rst:747 msgid "" "Return an attribute with a particular index. The order you get the " "attributes in is arbitrary but will be consistent for the life of a DOM. " @@ -124234,35 +127184,35 @@ msgid "" "attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:751 +#: library/xml.dom.rst:751 msgid "" "There are also experimental methods that give this class more mapping " "behavior. You can use them or you can use the standardized :meth:" "`getAttribute\\*` family of methods on the :class:`Element` objects." msgstr "" -#: ../src/Doc/library/xml.dom.rst:759 +#: library/xml.dom.rst:759 msgid "Comment Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:761 +#: library/xml.dom.rst:761 msgid "" ":class:`Comment` represents a comment in the XML document. It is a subclass " "of :class:`Node`, but cannot have child nodes." msgstr "" -#: ../src/Doc/library/xml.dom.rst:767 +#: library/xml.dom.rst:767 msgid "" "The content of the comment as a string. The attribute contains all " "characters between the leading ``<!-``\\ ``-`` and trailing ``-``\\ ``->``, " "but does not include them." msgstr "" -#: ../src/Doc/library/xml.dom.rst:775 +#: library/xml.dom.rst:775 msgid "Text and CDATASection Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:777 +#: library/xml.dom.rst:777 msgid "" "The :class:`Text` interface represents text in the XML document. If the " "parser and DOM implementation support the DOM's XML extension, portions of " @@ -124271,17 +127221,17 @@ msgid "" "different values for the :attr:`nodeType` attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:783 +#: library/xml.dom.rst:783 msgid "" "These interfaces extend the :class:`Node` interface. They cannot have child " "nodes." msgstr "" -#: ../src/Doc/library/xml.dom.rst:789 +#: library/xml.dom.rst:789 msgid "The content of the text node as a string." msgstr "" -#: ../src/Doc/library/xml.dom.rst:793 +#: library/xml.dom.rst:793 msgid "" "The use of a :class:`CDATASection` node does not indicate that the node " "represents a complete CDATA marked section, only that the content of the " @@ -124291,29 +127241,29 @@ msgid "" "marked sections." msgstr "" -#: ../src/Doc/library/xml.dom.rst:803 +#: library/xml.dom.rst:803 msgid "ProcessingInstruction Objects" msgstr "" -#: ../src/Doc/library/xml.dom.rst:805 +#: library/xml.dom.rst:805 msgid "" "Represents a processing instruction in the XML document; this inherits from " "the :class:`Node` interface and cannot have child nodes." msgstr "" -#: ../src/Doc/library/xml.dom.rst:811 +#: library/xml.dom.rst:811 msgid "" "The content of the processing instruction up to the first whitespace " "character. This is a read-only attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:817 +#: library/xml.dom.rst:817 msgid "" "The content of the processing instruction following the first whitespace " "character." msgstr "" -#: ../src/Doc/library/xml.dom.rst:828 +#: library/xml.dom.rst:828 msgid "" "The DOM Level 2 recommendation defines a single exception, :exc:" "`DOMException`, and a number of constants that allow applications to " @@ -124322,7 +127272,7 @@ msgid "" "specific exception." msgstr "" -#: ../src/Doc/library/xml.dom.rst:833 +#: library/xml.dom.rst:833 msgid "" "The Python DOM interface provides the constants, but also expands the set of " "exceptions so that a specific exception exists for each of the exception " @@ -124331,44 +127281,44 @@ msgid "" "attr:`code` attribute." msgstr "" -#: ../src/Doc/library/xml.dom.rst:842 +#: library/xml.dom.rst:842 msgid "" "Base exception class used for all specific DOM exceptions. This exception " "class cannot be directly instantiated." msgstr "" -#: ../src/Doc/library/xml.dom.rst:848 +#: library/xml.dom.rst:848 msgid "" "Raised when a specified range of text does not fit into a string. This is " "not known to be used in the Python DOM implementations, but may be received " "from DOM implementations not written in Python." msgstr "" -#: ../src/Doc/library/xml.dom.rst:855 +#: library/xml.dom.rst:855 msgid "" "Raised when an attempt is made to insert a node where the node type is not " "allowed." msgstr "" -#: ../src/Doc/library/xml.dom.rst:861 +#: library/xml.dom.rst:861 msgid "" "Raised when an index or size parameter to a method is negative or exceeds " "the allowed values." msgstr "" -#: ../src/Doc/library/xml.dom.rst:867 +#: library/xml.dom.rst:867 msgid "" "Raised when an attempt is made to insert an :class:`Attr` node that is " "already present elsewhere in the document." msgstr "" -#: ../src/Doc/library/xml.dom.rst:873 +#: library/xml.dom.rst:873 msgid "" "Raised if a parameter or an operation is not supported on the underlying " "object." msgstr "" -#: ../src/Doc/library/xml.dom.rst:878 +#: library/xml.dom.rst:878 msgid "" "This exception is raised when a string parameter contains a character that " "is not permitted in the context it's being used in by the XML 1.0 " @@ -124376,266 +127326,265 @@ msgid "" "with a space in the element type name will cause this error to be raised." msgstr "" -#: ../src/Doc/library/xml.dom.rst:886 +#: library/xml.dom.rst:886 msgid "Raised when an attempt is made to modify the type of a node." msgstr "" -#: ../src/Doc/library/xml.dom.rst:891 +#: library/xml.dom.rst:891 msgid "" "Raised when an attempt is made to use an object that is not defined or is no " "longer usable." msgstr "" -#: ../src/Doc/library/xml.dom.rst:897 +#: library/xml.dom.rst:897 msgid "" "If an attempt is made to change any object in a way that is not permitted " "with regard to the `Namespaces in XML <http://www.w3.org/TR/REC-xml-names/" ">`_ recommendation, this exception is raised." msgstr "" -#: ../src/Doc/library/xml.dom.rst:904 +#: library/xml.dom.rst:904 msgid "" "Exception when a node does not exist in the referenced context. For " "example, :meth:`NamedNodeMap.removeNamedItem` will raise this if the node " "passed in does not exist in the map." msgstr "" -#: ../src/Doc/library/xml.dom.rst:911 +#: library/xml.dom.rst:911 msgid "" "Raised when the implementation does not support the requested type of object " "or operation." msgstr "" -#: ../src/Doc/library/xml.dom.rst:917 +#: library/xml.dom.rst:917 msgid "" "This is raised if data is specified for a node which does not support data." msgstr "" -#: ../src/Doc/library/xml.dom.rst:924 +#: library/xml.dom.rst:924 msgid "" "Raised on attempts to modify an object where modifications are not allowed " "(such as for read-only nodes)." msgstr "" -#: ../src/Doc/library/xml.dom.rst:930 +#: library/xml.dom.rst:930 msgid "Raised when an invalid or illegal string is specified." msgstr "" -#: ../src/Doc/library/xml.dom.rst:937 +#: library/xml.dom.rst:937 msgid "" "Raised when a node is inserted in a different document than it currently " "belongs to, and the implementation does not support migrating the node from " "one document to the other." msgstr "" -#: ../src/Doc/library/xml.dom.rst:941 +#: library/xml.dom.rst:941 msgid "" "The exception codes defined in the DOM recommendation map to the exceptions " "described above according to this table:" msgstr "" -#: ../src/Doc/library/xml.dom.rst:945 +#: library/xml.dom.rst:945 #, fuzzy msgid "Exception" msgstr "Exceptions" -#: ../src/Doc/library/xml.dom.rst:947 +#: library/xml.dom.rst:947 msgid ":const:`DOMSTRING_SIZE_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:947 +#: library/xml.dom.rst:947 msgid ":exc:`DomstringSizeErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:949 +#: library/xml.dom.rst:949 msgid ":const:`HIERARCHY_REQUEST_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:949 +#: library/xml.dom.rst:949 msgid ":exc:`HierarchyRequestErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:951 +#: library/xml.dom.rst:951 msgid ":const:`INDEX_SIZE_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:951 +#: library/xml.dom.rst:951 msgid ":exc:`IndexSizeErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:953 +#: library/xml.dom.rst:953 msgid ":const:`INUSE_ATTRIBUTE_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:953 +#: library/xml.dom.rst:953 msgid ":exc:`InuseAttributeErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:955 +#: library/xml.dom.rst:955 msgid ":const:`INVALID_ACCESS_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:955 +#: library/xml.dom.rst:955 msgid ":exc:`InvalidAccessErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:957 +#: library/xml.dom.rst:957 msgid ":const:`INVALID_CHARACTER_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:957 +#: library/xml.dom.rst:957 msgid ":exc:`InvalidCharacterErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:959 +#: library/xml.dom.rst:959 msgid ":const:`INVALID_MODIFICATION_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:959 +#: library/xml.dom.rst:959 msgid ":exc:`InvalidModificationErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:961 +#: library/xml.dom.rst:961 msgid ":const:`INVALID_STATE_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:961 +#: library/xml.dom.rst:961 msgid ":exc:`InvalidStateErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:963 +#: library/xml.dom.rst:963 msgid ":const:`NAMESPACE_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:963 +#: library/xml.dom.rst:963 msgid ":exc:`NamespaceErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:965 +#: library/xml.dom.rst:965 msgid ":const:`NOT_FOUND_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:965 +#: library/xml.dom.rst:965 msgid ":exc:`NotFoundErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:967 +#: library/xml.dom.rst:967 msgid ":const:`NOT_SUPPORTED_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:967 +#: library/xml.dom.rst:967 msgid ":exc:`NotSupportedErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:969 +#: library/xml.dom.rst:969 msgid ":const:`NO_DATA_ALLOWED_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:969 +#: library/xml.dom.rst:969 msgid ":exc:`NoDataAllowedErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:971 +#: library/xml.dom.rst:971 msgid ":const:`NO_MODIFICATION_ALLOWED_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:971 +#: library/xml.dom.rst:971 msgid ":exc:`NoModificationAllowedErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:973 +#: library/xml.dom.rst:973 msgid ":const:`SYNTAX_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:973 +#: library/xml.dom.rst:973 #, fuzzy msgid ":exc:`SyntaxErr`" msgstr ":exc:`SyntaxError`" -#: ../src/Doc/library/xml.dom.rst:975 +#: library/xml.dom.rst:975 msgid ":const:`WRONG_DOCUMENT_ERR`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:975 +#: library/xml.dom.rst:975 msgid ":exc:`WrongDocumentErr`" msgstr "" -#: ../src/Doc/library/xml.dom.rst:982 +#: library/xml.dom.rst:982 msgid "Conformance" msgstr "" -#: ../src/Doc/library/xml.dom.rst:984 +#: library/xml.dom.rst:984 msgid "" "This section describes the conformance requirements and relationships " "between the Python DOM API, the W3C DOM recommendations, and the OMG IDL " "mapping for Python." msgstr "" -#: ../src/Doc/library/xml.dom.rst:992 +#: library/xml.dom.rst:992 msgid "Type Mapping" msgstr "" -#: ../src/Doc/library/xml.dom.rst:994 +#: library/xml.dom.rst:994 msgid "" "The primitive IDL types used in the DOM specification are mapped to Python " "types according to the following table." msgstr "" -#: ../src/Doc/library/xml.dom.rst:998 +#: library/xml.dom.rst:998 msgid "IDL Type" msgstr "" -#: ../src/Doc/library/xml.dom.rst:1000 +#: library/xml.dom.rst:1000 msgid "``boolean``" msgstr "" -#: ../src/Doc/library/xml.dom.rst:1000 +#: library/xml.dom.rst:1000 msgid "``IntegerType`` (with a value of ``0`` or ``1``)" msgstr "" -#: ../src/Doc/library/xml.dom.rst:1003 +#: library/xml.dom.rst:1003 msgid "``int``" msgstr "" -#: ../src/Doc/library/xml.dom.rst:1003 ../src/Doc/library/xml.dom.rst:1005 -#: ../src/Doc/library/xml.dom.rst:1007 +#: library/xml.dom.rst:1003 library/xml.dom.rst:1005 library/xml.dom.rst:1007 msgid "``IntegerType``" msgstr "" -#: ../src/Doc/library/xml.dom.rst:1005 +#: library/xml.dom.rst:1005 msgid "``long int``" msgstr "" -#: ../src/Doc/library/xml.dom.rst:1007 +#: library/xml.dom.rst:1007 msgid "``unsigned int``" msgstr "" # cd9515e9613745348ccaf544e384eed4 -#: ../src/Doc/library/xml.dom.rst:1010 +#: library/xml.dom.rst:1010 msgid "" "Additionally, the :class:`DOMString` defined in the recommendation is mapped " "to a Python string or Unicode string. Applications should be able to handle " "Unicode whenever a string is returned from the DOM." msgstr "" -#: ../src/Doc/library/xml.dom.rst:1014 +#: library/xml.dom.rst:1014 msgid "" "The IDL ``null`` value is mapped to ``None``, which may be accepted or " "provided by the implementation whenever ``null`` is allowed by the API." msgstr "" -#: ../src/Doc/library/xml.dom.rst:1021 +#: library/xml.dom.rst:1021 msgid "Accessor Methods" msgstr "" -#: ../src/Doc/library/xml.dom.rst:1023 +#: library/xml.dom.rst:1023 msgid "" "The mapping from OMG IDL to Python defines accessor functions for IDL " "``attribute`` declarations in much the way the Java mapping does. Mapping " "the IDL declarations ::" msgstr "" -#: ../src/Doc/library/xml.dom.rst:1030 +#: library/xml.dom.rst:1030 msgid "" "yields three accessor functions: a \"get\" method for :attr:`someValue` (:" "meth:`_get_someValue`), and \"get\" and \"set\" methods for :attr:" @@ -124645,7 +127594,7 @@ msgid "" "required to work, and may raise an :exc:`AttributeError`." msgstr "" -#: ../src/Doc/library/xml.dom.rst:1037 +#: library/xml.dom.rst:1037 msgid "" "The Python DOM API, however, *does* require that normal attribute access " "work. This means that the typical surrogates generated by Python IDL " @@ -124657,7 +127606,7 @@ msgid "" "all DOM implementations." msgstr "" -#: ../src/Doc/library/xml.dom.rst:1046 +#: library/xml.dom.rst:1046 msgid "" "In the Python DOM API, accessor functions are not required. If provided, " "they should take the form defined by the Python IDL mapping, but these " @@ -124666,7 +127615,7 @@ msgid "" "``readonly`` attributes." msgstr "" -#: ../src/Doc/library/xml.dom.rst:1051 +#: library/xml.dom.rst:1051 msgid "" "The IDL definitions do not fully embody the requirements of the W3C DOM API, " "such as the notion of certain objects, such as the return value of :meth:" @@ -124675,45 +127624,44 @@ msgid "" msgstr "" # 9b9ac52981c94d09b5db271424e2b2e3 -#: ../src/Doc/library/xml.dom.minidom.rst:2 +#: library/xml.dom.minidom.rst:2 msgid ":mod:`xml.dom.minidom` --- Minimal DOM implementation" msgstr "" # fd2afd7ab1864080a75d26109a6ac14c -#: ../src/Doc/library/xml.dom.minidom.rst:13 +#: library/xml.dom.minidom.rst:13 msgid "**Source code:** :source:`Lib/xml/dom/minidom.py`" msgstr "" -# 25792d068c3e4e0889d6fb0c66560097 -#: ../src/Doc/library/xml.dom.minidom.rst:17 +#: library/xml.dom.minidom.rst:17 msgid "" ":mod:`xml.dom.minidom` is a minimal implementation of the Document Object " "Model interface, with an API similar to that in other languages. It is " "intended to be simpler than the full DOM and also significantly smaller. " "Users who are not already proficient with the DOM should consider using the :" -"mod:`xml.etree.ElementTree` module for their XML processing instead" +"mod:`xml.etree.ElementTree` module for their XML processing instead." msgstr "" # 07911f3c121545a3b66cbcc80c6e7c03 -#: ../src/Doc/library/xml.dom.minidom.rst:26 +#: library/xml.dom.minidom.rst:26 msgid "" "The :mod:`xml.dom.minidom` module is not secure against maliciously " "constructed data. If you need to parse untrusted or unauthenticated data " "see :ref:`xml-vulnerabilities`." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:31 +#: library/xml.dom.minidom.rst:31 msgid "" "DOM applications typically start by parsing some XML into a DOM. With :mod:" "`xml.dom.minidom`, this is done through the parse functions::" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:43 +#: library/xml.dom.minidom.rst:43 msgid "" "The :func:`parse` function can take either a filename or an open file object." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:48 +#: library/xml.dom.minidom.rst:48 msgid "" "Return a :class:`Document` from the given input. *filename_or_file* may be " "either a file name, or a file-like object. *parser*, if given, must be a " @@ -124722,27 +127670,27 @@ msgid "" "setting an entity resolver) must have been done in advance." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:54 +#: library/xml.dom.minidom.rst:54 msgid "" "If you have XML in a string, you can use the :func:`parseString` function " "instead:" msgstr "" # 87886955b1cf4bab82514e438e3bb591 -#: ../src/Doc/library/xml.dom.minidom.rst:60 +#: library/xml.dom.minidom.rst:60 msgid "" "Return a :class:`Document` that represents the *string*. This method creates " "a :class:`~StringIO.StringIO` object for the string and passes that on to :" "func:`parse`." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:63 +#: library/xml.dom.minidom.rst:63 msgid "" "Both functions return a :class:`Document` object representing the content of " "the document." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:66 +#: library/xml.dom.minidom.rst:66 msgid "" "What the :func:`parse` and :func:`parseString` functions do is connect an " "XML parser with a \"DOM builder\" that can accept parse events from any SAX " @@ -124753,7 +127701,7 @@ msgid "" "themselves." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:73 +#: library/xml.dom.minidom.rst:73 msgid "" "You can also create a :class:`Document` by calling a method on a \"DOM " "Implementation\" object. You can get this object either by calling the :" @@ -124766,7 +127714,7 @@ msgid "" "`Document`, you can add child nodes to it to populate the DOM::" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:92 +#: library/xml.dom.minidom.rst:92 msgid "" "Once you have a DOM document object, you can access the parts of your XML " "document through its properties and methods. These properties are defined " @@ -124775,7 +127723,7 @@ msgid "" "document: the one that holds all others. Here is an example program::" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:101 +#: library/xml.dom.minidom.rst:101 msgid "" "When you are finished with a DOM tree, you may optionally call the :meth:" "`unlink` method to encourage early cleanup of the now-unneeded objects. :" @@ -124785,18 +127733,18 @@ msgid "" "objects in the tree." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:117 +#: library/xml.dom.minidom.rst:117 msgid "DOM Objects" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:119 +#: library/xml.dom.minidom.rst:119 msgid "" "The definition of the DOM API for Python is given as part of the :mod:`xml." "dom` module documentation. This section lists the differences between the " "API and :mod:`xml.dom.minidom`." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:126 +#: library/xml.dom.minidom.rst:126 msgid "" "Break internal references within the DOM so that it will be garbage " "collected on versions of Python without cyclic GC. Even when cyclic GC is " @@ -124806,7 +127754,7 @@ msgid "" "may be called on child nodes to discard children of that node." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:136 +#: library/xml.dom.minidom.rst:136 msgid "" "Write XML to the writer object. The writer should have a :meth:`write` " "method which matches that of the file object interface. The *indent* " @@ -124815,17 +127763,23 @@ msgid "" "*newl* parameter specifies the string to use to terminate newlines." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:142 +#: library/xml.dom.minidom.rst:142 library/xml.dom.minidom.rst:149 msgid "" "For the :class:`Document` node, an additional keyword argument *encoding* " "can be used to specify the encoding field of the XML header." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:156 +#: library/xml.dom.minidom.rst:145 +msgid "" +"The optional keyword parameters *indent*, *addindent*, and *newl* were added " +"to support pretty output." +msgstr "" + +#: library/xml.dom.minidom.rst:156 msgid "Return the XML that the DOM represents as a string." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:158 +#: library/xml.dom.minidom.rst:158 msgid "" "With no argument, the XML header does not specify an encoding, and the " "result is Unicode string if the default encoding cannot represent all " @@ -124833,7 +127787,7 @@ msgid "" "UTF-8 is likely incorrect, since UTF-8 is the default encoding of XML." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:163 +#: library/xml.dom.minidom.rst:163 msgid "" "With an explicit *encoding* [1]_ argument, the result is a byte string in " "the specified encoding. It is recommended that this argument is always " @@ -124842,56 +127796,64 @@ msgid "" "\"utf-8\"." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:174 +#: library/xml.dom.minidom.rst:168 +msgid "the *encoding* argument was introduced; see :meth:`writexml`." +msgstr "" + +#: library/xml.dom.minidom.rst:174 msgid "" "Return a pretty-printed version of the document. *indent* specifies the " "indentation string and defaults to a tabulator; *newl* specifies the string " "emitted at the end of each line and defaults to ``\\n``." msgstr "" +#: library/xml.dom.minidom.rst:180 +msgid "the encoding argument was introduced; see :meth:`writexml`." +msgstr "" + # b9a9ae1848e247df995d6847f9e18b6e -#: ../src/Doc/library/xml.dom.minidom.rst:183 +#: library/xml.dom.minidom.rst:183 msgid "" "The following standard DOM methods have special considerations with :mod:" "`xml.dom.minidom`:" msgstr "" # 365c3083ad35456f88fe4ac99780e879 -#: ../src/Doc/library/xml.dom.minidom.rst:189 +#: library/xml.dom.minidom.rst:189 msgid "" "Although this method was present in the version of :mod:`xml.dom.minidom` " "packaged with Python 2.0, it was seriously broken. This has been corrected " "for subsequent releases." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:197 +#: library/xml.dom.minidom.rst:197 msgid "DOM Example" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:199 +#: library/xml.dom.minidom.rst:199 msgid "" "This example program is a fairly realistic example of a simple program. In " "this particular case, we do not take much advantage of the flexibility of " "the DOM." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:208 +#: library/xml.dom.minidom.rst:208 msgid "minidom and the DOM standard" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:210 +#: library/xml.dom.minidom.rst:210 msgid "" "The :mod:`xml.dom.minidom` module is essentially a DOM 1.0-compatible DOM " "with some DOM 2 features (primarily namespace features)." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:213 +#: library/xml.dom.minidom.rst:213 msgid "" "Usage of the DOM interface in Python is straight-forward. The following " "mapping rules apply:" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:216 +#: library/xml.dom.minidom.rst:216 msgid "" "Interfaces are accessed through instance objects. Applications should not " "instantiate the classes themselves; they should use the creator functions " @@ -124900,14 +127862,14 @@ msgid "" "operations." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:221 +#: library/xml.dom.minidom.rst:221 msgid "" "Operations are used as methods. Since the DOM uses only :keyword:`in` " "parameters, the arguments are passed in normal order (from left to right). " "There are no optional arguments. ``void`` operations return ``None``." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:225 +#: library/xml.dom.minidom.rst:225 msgid "" "IDL attributes map to instance attributes. For compatibility with the OMG " "IDL language mapping for Python, an attribute ``foo`` can also be accessed " @@ -124915,14 +127877,14 @@ msgid "" "``readonly`` attributes must not be changed; this is not enforced at runtime." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:230 +#: library/xml.dom.minidom.rst:230 msgid "" "The types ``short int``, ``unsigned int``, ``unsigned long long``, and " "``boolean`` all map to Python integer objects." msgstr "" # a6df9d5a5ed2440d86dac627f8e121a1 -#: ../src/Doc/library/xml.dom.minidom.rst:233 +#: library/xml.dom.minidom.rst:233 msgid "" "The type ``DOMString`` maps to Python strings. :mod:`xml.dom.minidom` " "supports either byte or Unicode strings, but will normally produce Unicode " @@ -124930,14 +127892,14 @@ msgid "" "have the IDL ``null`` value by the DOM specification from the W3C." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:238 +#: library/xml.dom.minidom.rst:238 msgid "" "``const`` declarations map to variables in their respective scope (e.g. " "``xml.dom.minidom.Node.PROCESSING_INSTRUCTION_NODE``); they must not be " "changed." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:241 +#: library/xml.dom.minidom.rst:241 msgid "" "``DOMException`` is currently not supported in :mod:`xml.dom.minidom`. " "Instead, :mod:`xml.dom.minidom` uses standard Python exceptions such as :exc:" @@ -124945,7 +127907,7 @@ msgid "" msgstr "" # 9d355e7259934a4787e04d8c047e0840 -#: ../src/Doc/library/xml.dom.minidom.rst:245 +#: library/xml.dom.minidom.rst:245 msgid "" ":class:`NodeList` objects are implemented using Python's built-in list type. " "Starting with Python 2.2, these objects provide the interface defined in the " @@ -124954,110 +127916,112 @@ msgid "" "interface defined in the W3C recommendations." msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:251 +#: library/xml.dom.minidom.rst:251 msgid "" "The following interfaces have no implementation in :mod:`xml.dom.minidom`:" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:253 +#: library/xml.dom.minidom.rst:253 msgid ":class:`DOMTimeStamp`" msgstr "" # 7c0e6a0e57274acd8682fd46deffe859 -#: ../src/Doc/library/xml.dom.minidom.rst:255 +#: library/xml.dom.minidom.rst:255 msgid ":class:`DocumentType` (added in Python 2.1)" msgstr "" # bb5b37658cba4a959b41a326da111599 -#: ../src/Doc/library/xml.dom.minidom.rst:257 +#: library/xml.dom.minidom.rst:257 msgid ":class:`DOMImplementation` (added in Python 2.1)" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:259 +#: library/xml.dom.minidom.rst:259 msgid ":class:`CharacterData`" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:261 +#: library/xml.dom.minidom.rst:261 msgid ":class:`CDATASection`" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:263 +#: library/xml.dom.minidom.rst:263 msgid ":class:`Notation`" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:265 +#: library/xml.dom.minidom.rst:265 msgid ":class:`Entity`" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:267 +#: library/xml.dom.minidom.rst:267 msgid ":class:`EntityReference`" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:269 +#: library/xml.dom.minidom.rst:269 msgid ":class:`DocumentFragment`" msgstr "" -#: ../src/Doc/library/xml.dom.minidom.rst:271 +#: library/xml.dom.minidom.rst:271 msgid "" "Most of these reflect information in the XML document that is not of general " "utility to most DOM users." msgstr "" -#: ../src/Doc/library/xml.dom.pulldom.rst:2 +#: library/xml.dom.pulldom.rst:2 msgid ":mod:`xml.dom.pulldom` --- Support for building partial DOM trees" msgstr "" # 0f83c1861b5641f5ab98eeb59b99c8b6 -#: ../src/Doc/library/xml.dom.pulldom.rst:11 +#: library/xml.dom.pulldom.rst:11 msgid "**Source code:** :source:`Lib/xml/dom/pulldom.py`" msgstr "" -#: ../src/Doc/library/xml.dom.pulldom.rst:15 +#: library/xml.dom.pulldom.rst:15 msgid "" ":mod:`xml.dom.pulldom` allows building only selected portions of a Document " "Object Model representation of a document from SAX events." msgstr "" # 102195bab958463b878035a14bb44a03 -#: ../src/Doc/library/xml.dom.pulldom.rst:21 +#: library/xml.dom.pulldom.rst:21 msgid "" "The :mod:`xml.dom.pulldom` module is not secure against maliciously " "constructed data. If you need to parse untrusted or unauthenticated data " "see :ref:`xml-vulnerabilities`." msgstr "" -#: ../src/Doc/library/xml.dom.pulldom.rst:28 -#: ../src/Doc/library/xml.dom.pulldom.rst:38 +#: library/xml.dom.pulldom.rst:28 library/xml.dom.pulldom.rst:38 msgid ":class:`xml.sax.handler.ContentHandler` implementation that ..." msgstr "" -#: ../src/Doc/library/xml.dom.pulldom.rst:33 -#: ../src/Doc/library/xml.dom.pulldom.rst:43 -#: ../src/Doc/library/xml.dom.pulldom.rst:48 -#: ../src/Doc/library/xml.dom.pulldom.rst:68 -#: ../src/Doc/library/xml.dom.pulldom.rst:73 -#: ../src/Doc/library/xml.dom.pulldom.rst:78 +#: library/xml.dom.pulldom.rst:33 library/xml.dom.pulldom.rst:43 +#: library/xml.dom.pulldom.rst:48 library/xml.dom.pulldom.rst:68 +#: library/xml.dom.pulldom.rst:73 library/xml.dom.pulldom.rst:78 msgid "..." msgstr "..." -#: ../src/Doc/library/xml.dom.pulldom.rst:53 +#: library/xml.dom.pulldom.rst:53 msgid "Default value for the *bufsize* parameter to :func:`parse`." msgstr "" -#: ../src/Doc/library/xml.dom.pulldom.rst:63 +#: library/xml.dom.pulldom.rst:55 +msgid "" +"The value of this variable can be changed before calling :func:`parse` and " +"the new value will take effect." +msgstr "" + +#: library/xml.dom.pulldom.rst:63 msgid "DOMEventStream Objects" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:2 +#: library/xml.etree.elementtree.rst:2 msgid ":mod:`xml.etree.ElementTree` --- The ElementTree XML API" msgstr "" # 9b2971de629c4641951fa26bbe000892 -#: ../src/Doc/library/xml.etree.elementtree.rst:11 +#: library/xml.etree.elementtree.rst:11 msgid "**Source code:** :source:`Lib/xml/etree/ElementTree.py`" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:15 +#: library/xml.etree.elementtree.rst:15 msgid "" "The :class:`Element` type is a flexible container object, designed to store " "hierarchical data structures in memory. The type can be described as a " @@ -125065,65 +128029,72 @@ msgid "" msgstr "" # 6b9cd25bc0f644648c1ca0994aaaa8d1 -#: ../src/Doc/library/xml.etree.elementtree.rst:22 +#: library/xml.etree.elementtree.rst:22 msgid "" "The :mod:`xml.etree.ElementTree` module is not secure against maliciously " "constructed data. If you need to parse untrusted or unauthenticated data " "see :ref:`xml-vulnerabilities`." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:27 +#: library/xml.etree.elementtree.rst:27 msgid "Each element has a number of properties associated with it:" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:29 +#: library/xml.etree.elementtree.rst:29 msgid "" "a tag which is a string identifying what kind of data this element " "represents (the element type, in other words)." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:32 +#: library/xml.etree.elementtree.rst:32 msgid "a number of attributes, stored in a Python dictionary." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:34 +#: library/xml.etree.elementtree.rst:34 msgid "a text string." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:36 +#: library/xml.etree.elementtree.rst:36 msgid "an optional tail string." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:38 +#: library/xml.etree.elementtree.rst:38 msgid "a number of child elements, stored in a Python sequence" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:40 +#: library/xml.etree.elementtree.rst:40 msgid "" "To create an element instance, use the :class:`Element` constructor or the :" "func:`SubElement` factory function." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:43 +#: library/xml.etree.elementtree.rst:43 msgid "" "The :class:`ElementTree` class can be used to wrap an element structure, and " "convert it from and to XML." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:46 +#: library/xml.etree.elementtree.rst:46 msgid "" "A C implementation of this API is available as :mod:`xml.etree.cElementTree`." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:48 +#: library/xml.etree.elementtree.rst:48 msgid "" "See http://effbot.org/zone/element-index.htm for tutorials and links to " "other docs. Fredrik Lundh's page is also the location of the development " "version of the xml.etree.ElementTree." msgstr "" +#: library/xml.etree.elementtree.rst:52 +msgid "" +"The ElementTree API is updated to 1.3. For more information, see " +"`Introducing ElementTree 1.3 <http://effbot.org/zone/elementtree-13-intro." +"htm>`_." +msgstr "" + # 10b64d5872fe450a9b167e5e0adcbc91 -#: ../src/Doc/library/xml.etree.elementtree.rst:60 +#: library/xml.etree.elementtree.rst:60 msgid "" "This is a short tutorial for using :mod:`xml.etree.ElementTree` (``ET`` in " "short). The goal is to demonstrate some of the building blocks and basic " @@ -125131,12 +128102,12 @@ msgid "" msgstr "" # 809a917cdf2344d0b228d253720d9c5b -#: ../src/Doc/library/xml.etree.elementtree.rst:65 +#: library/xml.etree.elementtree.rst:65 msgid "XML tree and elements" msgstr "" # 4595d98cb8c548cbafac5b78882d3041 -#: ../src/Doc/library/xml.etree.elementtree.rst:67 +#: library/xml.etree.elementtree.rst:67 msgid "" "XML is an inherently hierarchical data format, and the most natural way to " "represent it is with a tree. ``ET`` has two classes for this purpose - :" @@ -125148,30 +128119,30 @@ msgid "" msgstr "" # 46761eae4e854a88bf60013d0e526405 -#: ../src/Doc/library/xml.etree.elementtree.rst:78 +#: library/xml.etree.elementtree.rst:78 msgid "Parsing XML" msgstr "" # e316c94f98ed4d2bbede6ab3d91e7243 -#: ../src/Doc/library/xml.etree.elementtree.rst:80 +#: library/xml.etree.elementtree.rst:80 msgid "" "We'll be using the following XML document as the sample data for this " "section:" msgstr "" # b04e61f1ce6247b0b8aeae4279813417 -#: ../src/Doc/library/xml.etree.elementtree.rst:108 +#: library/xml.etree.elementtree.rst:108 msgid "" "We have a number of ways to import the data. Reading the file from disk::" msgstr "" # be717ff853df426b8fcb7f579d866ba4 -#: ../src/Doc/library/xml.etree.elementtree.rst:114 +#: library/xml.etree.elementtree.rst:114 msgid "Reading the data from a string::" msgstr "" # ff226cca72d44bd9b9a467ed4b41f952 -#: ../src/Doc/library/xml.etree.elementtree.rst:118 +#: library/xml.etree.elementtree.rst:118 msgid "" ":func:`fromstring` parses XML from a string directly into an :class:" "`Element`, which is the root element of the parsed tree. Other parsing " @@ -125180,28 +128151,28 @@ msgid "" msgstr "" # 500773a1e352411bb912a67942895d76 -#: ../src/Doc/library/xml.etree.elementtree.rst:122 +#: library/xml.etree.elementtree.rst:122 msgid "" "As an :class:`Element`, ``root`` has a tag and a dictionary of attributes::" msgstr "" # b697aa5bc3ab4f0fb815358427fda219 -#: ../src/Doc/library/xml.etree.elementtree.rst:129 +#: library/xml.etree.elementtree.rst:129 msgid "It also has children nodes over which we can iterate::" msgstr "" # eaf79af43e3e4d55907e511c1bda961c -#: ../src/Doc/library/xml.etree.elementtree.rst:138 +#: library/xml.etree.elementtree.rst:138 msgid "Children are nested, and we can access specific child nodes by index::" msgstr "" # 6795be0efa3d47c8b5a7df8f3fd1610f -#: ../src/Doc/library/xml.etree.elementtree.rst:144 +#: library/xml.etree.elementtree.rst:144 msgid "Finding interesting elements" msgstr "" # 123fd1bd16f442b982f17459cd3a4825 -#: ../src/Doc/library/xml.etree.elementtree.rst:146 +#: library/xml.etree.elementtree.rst:146 msgid "" ":class:`Element` has some useful methods that help iterate recursively over " "all the sub-tree below it (its children, their children, and so on). For " @@ -125209,7 +128180,7 @@ msgid "" msgstr "" # b03d9df55db44976a751254a12bd8e61 -#: ../src/Doc/library/xml.etree.elementtree.rst:159 +#: library/xml.etree.elementtree.rst:159 msgid "" ":meth:`Element.findall` finds only elements with a tag which are direct " "children of the current element. :meth:`Element.find` finds the *first* " @@ -125218,26 +128189,26 @@ msgid "" msgstr "" # 6ad4587e190548b58e33b68befdc7e35 -#: ../src/Doc/library/xml.etree.elementtree.rst:173 +#: library/xml.etree.elementtree.rst:173 msgid "" "More sophisticated specification of which elements to look for is possible " "by using :ref:`XPath <elementtree-xpath>`." msgstr "" # 5cd32fc3f1d845519282468bb5523ee4 -#: ../src/Doc/library/xml.etree.elementtree.rst:177 +#: library/xml.etree.elementtree.rst:177 msgid "Modifying an XML File" msgstr "" # 31beda6391dd49278620061021295881 -#: ../src/Doc/library/xml.etree.elementtree.rst:179 +#: library/xml.etree.elementtree.rst:179 msgid "" ":class:`ElementTree` provides a simple way to build XML documents and write " "them to files. The :meth:`ElementTree.write` method serves this purpose." msgstr "" # 0a1d4905ef5240c7bf30179490fc5b25 -#: ../src/Doc/library/xml.etree.elementtree.rst:182 +#: library/xml.etree.elementtree.rst:182 msgid "" "Once created, an :class:`Element` object may be manipulated by directly " "changing its fields (such as :attr:`Element.text`), adding and modifying " @@ -125246,7 +128217,7 @@ msgid "" msgstr "" # f5b1f6fb45af4fd897b747d4aa9c81c2 -#: ../src/Doc/library/xml.etree.elementtree.rst:187 +#: library/xml.etree.elementtree.rst:187 msgid "" "Let's say we want to add one to each country's rank, and add an ``updated`` " "attribute to the rank element::" @@ -125254,49 +128225,85 @@ msgstr "" # 6ccae231366c4d17adad8afc2ac7f097 # 80c968252786482db86534af9e00f76f -#: ../src/Doc/library/xml.etree.elementtree.rst:197 -#: ../src/Doc/library/xml.etree.elementtree.rst:235 +#: library/xml.etree.elementtree.rst:197 library/xml.etree.elementtree.rst:235 msgid "Our XML now looks like this:" msgstr "" # b1905abb9d5e4c4580901e34385e6e1a -#: ../src/Doc/library/xml.etree.elementtree.rst:225 +#: library/xml.etree.elementtree.rst:225 msgid "" "We can remove elements using :meth:`Element.remove`. Let's say we want to " "remove all countries with a rank higher than 50::" msgstr "" # 81311b668ff34bad8f2e0f3f3d5b0891 -#: ../src/Doc/library/xml.etree.elementtree.rst:257 +#: library/xml.etree.elementtree.rst:257 msgid "Building XML documents" msgstr "" # 07d71987e19e48d4982b8d0976a17575 -#: ../src/Doc/library/xml.etree.elementtree.rst:259 +#: library/xml.etree.elementtree.rst:259 msgid "" "The :func:`SubElement` function also provides a convenient way to create new " "sub-elements for a given element::" msgstr "" +#: library/xml.etree.elementtree.rst:270 +msgid "Parsing XML with Namespaces" +msgstr "" + +#: library/xml.etree.elementtree.rst:272 +msgid "" +"If the XML input has `namespaces <https://en.wikipedia.org/wiki/" +"XML_namespace>`__, tags and attributes with prefixes in the form ``prefix:" +"sometag`` get expanded to ``{uri}sometag`` where the *prefix* is replaced by " +"the full *URI*. Also, if there is a `default namespace <http://www.w3.org/" +"TR/2006/REC-xml-names-20060816/#defaulting>`__, that full URI gets prepended " +"to all of the non-prefixed tags." +msgstr "" + +#: library/xml.etree.elementtree.rst:280 +msgid "" +"Here is an XML example that incorporates two namespaces, one with the prefix " +"\"fictional\" and the other serving as the default namespace:" +msgstr "" + +#: library/xml.etree.elementtree.rst:301 +msgid "" +"One way to search and explore this XML example is to manually add the URI to " +"every tag or attribute in the xpath of a :meth:`~Element.find` or :meth:" +"`~Element.findall`::" +msgstr "" + +#: library/xml.etree.elementtree.rst:313 +msgid "" +"A better way to search the namespaced XML example is to create a dictionary " +"with your own prefixes and use those in the search functions::" +msgstr "" + +#: library/xml.etree.elementtree.rst:325 +msgid "These two approaches both output::" +msgstr "" + # 13fbfe15c2634c21b4e8ce6505906430 -#: ../src/Doc/library/xml.etree.elementtree.rst:270 +#: library/xml.etree.elementtree.rst:337 msgid "Additional resources" msgstr "" # 2e70cb0f922740fdacceeccc2bf68c25 -#: ../src/Doc/library/xml.etree.elementtree.rst:272 +#: library/xml.etree.elementtree.rst:339 msgid "" "See http://effbot.org/zone/element-index.htm for tutorials and links to " "other docs." msgstr "" # 12d8e5c6e403494798e3d078fbeb35f0 -#: ../src/Doc/library/xml.etree.elementtree.rst:278 +#: library/xml.etree.elementtree.rst:345 msgid "XPath support" msgstr "" # 2c0e4ec9714347c6825244168c8fa742 -#: ../src/Doc/library/xml.etree.elementtree.rst:280 +#: library/xml.etree.elementtree.rst:347 msgid "" "This module provides limited support for `XPath expressions <http://www.w3." "org/TR/xpath>`_ for locating elements in a tree. The goal is to support a " @@ -125305,7 +128312,7 @@ msgid "" msgstr "" # 167eeed5d7e24ac9bf9577c339fed277 -#: ../src/Doc/library/xml.etree.elementtree.rst:288 +#: library/xml.etree.elementtree.rst:355 msgid "" "Here's an example that demonstrates some of the XPath capabilities of the " "module. We'll be using the ``countrydata`` XML document from the :ref:" @@ -125313,17 +128320,17 @@ msgid "" msgstr "" # 01ded0c86b674918bdc8d36cbf37d565 -#: ../src/Doc/library/xml.etree.elementtree.rst:313 +#: library/xml.etree.elementtree.rst:380 msgid "Supported XPath syntax" msgstr "" # 8cd33d78ede64e079d1b3ba601bb7180 -#: ../src/Doc/library/xml.etree.elementtree.rst:320 +#: library/xml.etree.elementtree.rst:387 msgid "``tag``" msgstr "" # 89ec1f4268a441a2abda1670cada08ce -#: ../src/Doc/library/xml.etree.elementtree.rst:320 +#: library/xml.etree.elementtree.rst:387 msgid "" "Selects all child elements with the given tag. For example, ``spam`` selects " "all child elements named ``spam``, and ``spam/egg`` selects all " @@ -125331,82 +128338,92 @@ msgid "" msgstr "" # a6b5957dd3f849a49c0db2d9699c6b43 -#: ../src/Doc/library/xml.etree.elementtree.rst:326 +#: library/xml.etree.elementtree.rst:393 msgid "" "Selects all child elements. For example, ``*/egg`` selects all " "grandchildren named ``egg``." msgstr "" # 0360ec0ad34a4b4992862d11737b33ef -#: ../src/Doc/library/xml.etree.elementtree.rst:329 +#: library/xml.etree.elementtree.rst:396 msgid "" "Selects the current node. This is mostly useful at the beginning of the " "path, to indicate that it's a relative path." msgstr "" # 1427ff21edcb45ddb7267bdf60954d92 -#: ../src/Doc/library/xml.etree.elementtree.rst:333 +#: library/xml.etree.elementtree.rst:400 msgid "``//``" msgstr "" # 0d0222fbc9ee4543a6dfeb66a7f29fa0 -#: ../src/Doc/library/xml.etree.elementtree.rst:333 +#: library/xml.etree.elementtree.rst:400 msgid "" "Selects all subelements, on all levels beneath the current element. For " "example, ``.//egg`` selects all ``egg`` elements in the entire tree." msgstr "" # 10d3a99778614b4caf5c960cddb38676 -#: ../src/Doc/library/xml.etree.elementtree.rst:337 +#: library/xml.etree.elementtree.rst:404 msgid "``..``" msgstr "" # 451c68024e764d30b0411cb51907a140 -#: ../src/Doc/library/xml.etree.elementtree.rst:337 +#: library/xml.etree.elementtree.rst:404 msgid "Selects the parent element." msgstr "" # 4edfb865cf534392b157095c1811d3c6 -#: ../src/Doc/library/xml.etree.elementtree.rst:339 +#: library/xml.etree.elementtree.rst:406 msgid "``[@attrib]``" msgstr "" # 4274bcf10caa47378a19350921e67369 -#: ../src/Doc/library/xml.etree.elementtree.rst:339 +#: library/xml.etree.elementtree.rst:406 msgid "Selects all elements that have the given attribute." msgstr "" # 17e29896004b48679cce942f860e0493 -#: ../src/Doc/library/xml.etree.elementtree.rst:341 +#: library/xml.etree.elementtree.rst:408 msgid "``[@attrib='value']``" msgstr "" # 92d6dc91b51a401f8c00bfe0d4583ab5 -#: ../src/Doc/library/xml.etree.elementtree.rst:341 +#: library/xml.etree.elementtree.rst:408 msgid "" "Selects all elements for which the given attribute has the given value. The " "value cannot contain quotes." msgstr "" # d47935d5b3c84828b88b530cf62b6123 -#: ../src/Doc/library/xml.etree.elementtree.rst:345 +#: library/xml.etree.elementtree.rst:412 msgid "``[tag]``" msgstr "" # 40a84af30510426eaab2f9333f8d6fc3 -#: ../src/Doc/library/xml.etree.elementtree.rst:345 +#: library/xml.etree.elementtree.rst:412 msgid "" "Selects all elements that have a child named ``tag``. Only immediate " "children are supported." msgstr "" +#: library/xml.etree.elementtree.rst:415 +msgid "``[tag='text']``" +msgstr "" + +#: library/xml.etree.elementtree.rst:415 +msgid "" +"Selects all elements that have a child named ``tag`` whose complete text " +"content, including descendants, equals the given ``text``." +msgstr "" + # 0898fe5b8e5743a7be879231861f1014 -#: ../src/Doc/library/xml.etree.elementtree.rst:348 +#: library/xml.etree.elementtree.rst:419 msgid "``[position]``" msgstr "" # 8e645bd53dfb4f708b67440a4fd99e92 -#: ../src/Doc/library/xml.etree.elementtree.rst:348 +#: library/xml.etree.elementtree.rst:419 msgid "" "Selects all elements that are located at the given position. The position " "can be either an integer (1 is the first position), the expression " @@ -125415,14 +128432,14 @@ msgid "" msgstr "" # ef217d95b4fd4474a7b0305c22ca62c4 -#: ../src/Doc/library/xml.etree.elementtree.rst:355 +#: library/xml.etree.elementtree.rst:426 msgid "" "Predicates (expressions within square brackets) must be preceded by a tag " "name, an asterisk, or another predicate. ``position`` predicates must be " "preceded by a tag name." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:370 +#: library/xml.etree.elementtree.rst:441 msgid "" "Comment element factory. This factory function creates a special element " "that will be serialized as an XML comment by the standard serializer. The " @@ -125431,29 +128448,29 @@ msgid "" "representing a comment." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:379 +#: library/xml.etree.elementtree.rst:450 msgid "" "Writes an element tree or element structure to sys.stdout. This function " "should be used for debugging only." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:382 +#: library/xml.etree.elementtree.rst:453 msgid "" "The exact output format is implementation dependent. In this version, it's " "written as an ordinary XML file." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:385 +#: library/xml.etree.elementtree.rst:456 msgid "*elem* is an element tree or an individual element." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:390 +#: library/xml.etree.elementtree.rst:461 msgid "" "Parses an XML section from a string constant. Same as :func:`XML`. *text* " "is a string containing XML data. Returns an :class:`Element` instance." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:396 +#: library/xml.etree.elementtree.rst:467 msgid "" "Parses an XML document from a sequence of string fragments. *sequence* is a " "list or other sequence containing XML data fragments. *parser* is an " @@ -125461,14 +128478,14 @@ msgid "" "parser is used. Returns an :class:`Element` instance." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:406 +#: library/xml.etree.elementtree.rst:477 msgid "" "Checks if an object appears to be a valid element object. *element* is an " "element instance. Returns a true value if this is an element object." msgstr "" # f0036159107344f5959adf84ec35a4d5 -#: ../src/Doc/library/xml.etree.elementtree.rst:412 +#: library/xml.etree.elementtree.rst:483 msgid "" "Parses an XML section into an element tree incrementally, and reports what's " "going on to the user. *source* is a filename or file object containing XML " @@ -125479,7 +128496,7 @@ msgid "" "``(event, elem)`` pairs." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:422 +#: library/xml.etree.elementtree.rst:493 msgid "" ":func:`iterparse` only guarantees that it has seen the \">\" character of a " "starting tag when it emits a \"start\" event, so the attributes are defined, " @@ -125488,11 +128505,11 @@ msgid "" "present." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:428 +#: library/xml.etree.elementtree.rst:499 msgid "If you need a fully populated element, look for \"end\" events instead." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:433 +#: library/xml.etree.elementtree.rst:504 msgid "" "Parses an XML section into an element tree. *source* is a filename or file " "object containing XML data. *parser* is an optional parser instance. If " @@ -125500,7 +128517,7 @@ msgid "" "class:`ElementTree` instance." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:441 +#: library/xml.etree.elementtree.rst:512 msgid "" "PI element factory. This factory function creates a special element that " "will be serialized as an XML processing instruction. *target* is a string " @@ -125508,7 +128525,7 @@ msgid "" "given. Returns an element instance, representing a processing instruction." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:449 +#: library/xml.etree.elementtree.rst:520 msgid "" "Registers a namespace prefix. The registry is global, and any existing " "mapping for either the given prefix or the namespace URI will be removed. " @@ -125517,13 +128534,13 @@ msgid "" "all possible." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:460 +#: library/xml.etree.elementtree.rst:531 msgid "" "Subelement factory. This function creates an element instance, and appends " "it to an existing element." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:463 +#: library/xml.etree.elementtree.rst:534 msgid "" "The element name, attribute names, and attribute values can be either " "bytestrings or Unicode strings. *parent* is the parent element. *tag* is " @@ -125533,7 +128550,7 @@ msgid "" msgstr "" # 5f12af07b7b34665b9200996d648766a -#: ../src/Doc/library/xml.etree.elementtree.rst:472 +#: library/xml.etree.elementtree.rst:543 msgid "" "Generates a string representation of an XML element, including all " "subelements. *element* is an :class:`Element` instance. *encoding* [1]_ is " @@ -125543,7 +128560,7 @@ msgid "" msgstr "" # 929e81e08824412b8db80549d83a9db2 -#: ../src/Doc/library/xml.etree.elementtree.rst:481 +#: library/xml.etree.elementtree.rst:552 msgid "" "Generates a string representation of an XML element, including all " "subelements. *element* is an :class:`Element` instance. *encoding* [1]_ is " @@ -125554,7 +128571,7 @@ msgid "" "tostring(element)``." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:494 +#: library/xml.etree.elementtree.rst:565 msgid "" "Parses an XML section from a string constant. This function can be used to " "embed \"XML literals\" in Python code. *text* is a string containing XML " @@ -125562,7 +128579,7 @@ msgid "" "class:`XMLParser` parser is used. Returns an :class:`Element` instance." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:502 +#: library/xml.etree.elementtree.rst:573 msgid "" "Parses an XML section from a string constant, and also returns a dictionary " "which maps from element id:s to elements. *text* is a string containing XML " @@ -125571,13 +128588,13 @@ msgid "" "`Element` instance and a dictionary." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:516 +#: library/xml.etree.elementtree.rst:587 msgid "" "Element class. This class defines the Element interface, and provides a " "reference implementation of this interface." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:519 +#: library/xml.etree.elementtree.rst:590 msgid "" "The element name, attribute names, and attribute values can be either " "bytestrings or Unicode strings. *tag* is the element name. *attrib* is an " @@ -125585,30 +128602,42 @@ msgid "" "additional attributes, given as keyword arguments." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:527 +#: library/xml.etree.elementtree.rst:598 msgid "" "A string identifying what kind of data this element represents (the element " "type, in other words)." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:533 +#: library/xml.etree.elementtree.rst:605 msgid "" -"The *text* attribute can be used to hold additional data associated with the " -"element. As the name implies this attribute is usually a string but may be " -"any application-specific object. If the element is created from an XML file " -"the attribute will contain any text found between the element tags." +"These attributes can be used to hold additional data associated with the " +"element. Their values are usually strings but may be any application-" +"specific object. If the element is created from an XML file, the *text* " +"attribute holds either the text between the element's start tag and its " +"first child or end tag, or ``None``, and the *tail* attribute holds either " +"the text between the element's end tag and the next tag, or ``None``. For " +"the XML data" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:542 +#: library/xml.etree.elementtree.rst:617 msgid "" -"The *tail* attribute can be used to hold additional data associated with the " -"element. This attribute is usually a string but may be any application-" -"specific object. If the element is created from an XML file the attribute " -"will contain any text found after the element's end tag and before the next " -"tag." +"the *a* element has ``None`` for both *text* and *tail* attributes, the *b* " +"element has *text* ``\"1\"`` and *tail* ``\"4\"``, the *c* element has " +"*text* ``\"2\"`` and *tail* ``None``, and the *d* element has *text* " +"``None`` and *tail* ``\"3\"``." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:551 +#: library/xml.etree.elementtree.rst:622 +msgid "" +"To collect the inner text of an element, see :meth:`itertext`, for example ``" +"\"\".join(element.itertext())``." +msgstr "" + +#: library/xml.etree.elementtree.rst:625 +msgid "Applications may store arbitrary objects in these attributes." +msgstr "" + +#: library/xml.etree.elementtree.rst:630 msgid "" "A dictionary containing the element's attributes. Note that while the " "*attrib* value is always a real mutable Python dictionary, an ElementTree " @@ -125617,70 +128646,70 @@ msgid "" "implementations, use the dictionary methods below whenever possible." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:557 +#: library/xml.etree.elementtree.rst:636 msgid "The following dictionary-like methods work on the element attributes." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:562 +#: library/xml.etree.elementtree.rst:641 msgid "" "Resets an element. This function removes all subelements, clears all " "attributes, and sets the text and tail attributes to None." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:568 +#: library/xml.etree.elementtree.rst:647 msgid "Gets the element attribute named *key*." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:570 +#: library/xml.etree.elementtree.rst:649 msgid "" "Returns the attribute value, or *default* if the attribute was not found." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:575 +#: library/xml.etree.elementtree.rst:654 msgid "" "Returns the element attributes as a sequence of (name, value) pairs. The " "attributes are returned in an arbitrary order." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:581 +#: library/xml.etree.elementtree.rst:660 msgid "" "Returns the elements attribute names as a list. The names are returned in " "an arbitrary order." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:587 +#: library/xml.etree.elementtree.rst:666 msgid "Set the attribute *key* on the element to *value*." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:589 +#: library/xml.etree.elementtree.rst:668 msgid "The following methods work on the element's children (subelements)." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:594 +#: library/xml.etree.elementtree.rst:673 msgid "" "Adds the element *subelement* to the end of this elements internal list of " "subelements." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:600 +#: library/xml.etree.elementtree.rst:679 msgid "" "Appends *subelements* from a sequence object with zero or more elements. " "Raises :exc:`AssertionError` if a subelement is not a valid object." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:608 +#: library/xml.etree.elementtree.rst:687 msgid "" "Finds the first subelement matching *match*. *match* may be a tag name or " "path. Returns an element instance or ``None``." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:614 +#: library/xml.etree.elementtree.rst:693 msgid "" "Finds all matching subelements, by tag name or path. Returns a list " "containing all matching elements in document order." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:620 +#: library/xml.etree.elementtree.rst:699 msgid "" "Finds text for the first subelement matching *match*. *match* may be a tag " "name or path. Returns the text content of the first matching element, or " @@ -125688,11 +128717,19 @@ msgid "" "text content an empty string is returned." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:640 +#: library/xml.etree.elementtree.rst:707 +msgid "Use ``list(elem)`` or iteration." +msgstr "" + +#: library/xml.etree.elementtree.rst:713 +msgid "Use method :meth:`Element.iter` instead." +msgstr "" + +#: library/xml.etree.elementtree.rst:719 msgid "Inserts a subelement at the given position in this element." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:645 +#: library/xml.etree.elementtree.rst:724 msgid "" "Creates a tree :term:`iterator` with the current element as the root. The " "iterator iterates over this element and all elements below it, in document " @@ -125701,25 +128738,25 @@ msgid "" "structure is modified during iteration, the result is undefined." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:656 +#: library/xml.etree.elementtree.rst:735 msgid "" "Finds all matching subelements, by tag name or path. Returns an iterable " "yielding all matching elements in document order." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:664 +#: library/xml.etree.elementtree.rst:743 msgid "" "Creates a text iterator. The iterator loops over this element and all " "subelements, in document order, and returns all inner text." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:672 +#: library/xml.etree.elementtree.rst:751 msgid "" "Creates a new element object of the same type as this element. Do not call " "this method, use the :func:`SubElement` factory function instead." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:678 +#: library/xml.etree.elementtree.rst:757 msgid "" "Removes *subelement* from the element. Unlike the find\\* methods this " "method compares elements based on the instance identity, not on tag value or " @@ -125727,38 +128764,38 @@ msgid "" msgstr "" # 7071a81d1ae94ef089af9cb9cbc0cba6 -#: ../src/Doc/library/xml.etree.elementtree.rst:682 +#: library/xml.etree.elementtree.rst:761 msgid "" ":class:`Element` objects also support the following sequence type methods " "for working with subelements: :meth:`~object.__delitem__`, :meth:`~object." "__getitem__`, :meth:`~object.__setitem__`, :meth:`~object.__len__`." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:687 +#: library/xml.etree.elementtree.rst:766 msgid "" "Caution: Elements with no subelements will test as ``False``. This behavior " "will change in future versions. Use specific ``len(elem)`` or ``elem is " "None`` test instead. ::" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:703 +#: library/xml.etree.elementtree.rst:782 msgid "ElementTree Objects" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:708 +#: library/xml.etree.elementtree.rst:787 msgid "" "ElementTree wrapper class. This class represents an entire element " "hierarchy, and adds some extra support for serialization to and from " "standard XML." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:712 +#: library/xml.etree.elementtree.rst:791 msgid "" "*element* is the root element. The tree is initialized with the contents of " "the XML *file* if given." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:718 +#: library/xml.etree.elementtree.rst:797 msgid "" "Replaces the root element for this tree. This discards the current contents " "of the tree, and replaces it with the given element. Use with care. " @@ -125766,40 +128803,44 @@ msgid "" msgstr "" # c45f405c3f8c47daa30af378d73e2d0d -#: ../src/Doc/library/xml.etree.elementtree.rst:725 +#: library/xml.etree.elementtree.rst:804 msgid "Same as :meth:`Element.find`, starting at the root of the tree." msgstr "" # 67f2b2869ec4448492bb63e3b2a89d38 -#: ../src/Doc/library/xml.etree.elementtree.rst:730 +#: library/xml.etree.elementtree.rst:809 msgid "Same as :meth:`Element.findall`, starting at the root of the tree." msgstr "" # 7236aa0934164aa28fd94d097a007415 -#: ../src/Doc/library/xml.etree.elementtree.rst:735 +#: library/xml.etree.elementtree.rst:814 msgid "Same as :meth:`Element.findtext`, starting at the root of the tree." msgstr "" +#: library/xml.etree.elementtree.rst:819 +msgid "Use method :meth:`ElementTree.iter` instead." +msgstr "" + # f5282f82614148ba800f9f74b47c09ef -#: ../src/Doc/library/xml.etree.elementtree.rst:746 +#: library/xml.etree.elementtree.rst:825 msgid "Returns the root element for this tree." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:751 +#: library/xml.etree.elementtree.rst:830 msgid "" "Creates and returns a tree iterator for the root element. The iterator " "loops over all elements in this tree, in section order. *tag* is the tag to " -"look for (default is to return all elements)" +"look for (default is to return all elements)." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:758 +#: library/xml.etree.elementtree.rst:837 msgid "" "Finds all matching subelements, by tag name or path. Same as getroot()." "iterfind(match). Returns an iterable yielding all matching elements in " "document order." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:767 +#: library/xml.etree.elementtree.rst:846 msgid "" "Loads an external XML section into this element tree. *source* is a file " "name or file object. *parser* is an optional parser instance. If not " @@ -125808,7 +128849,7 @@ msgid "" msgstr "" # aa320565eaf54593903bf2bc3e141dea -#: ../src/Doc/library/xml.etree.elementtree.rst:776 +#: library/xml.etree.elementtree.rst:855 msgid "" "Writes the element tree to a file, as XML. *file* is a file name, or a file " "object opened for writing. *encoding* [1]_ is the output encoding (default " @@ -125820,21 +128861,21 @@ msgid "" "string." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:785 +#: library/xml.etree.elementtree.rst:864 msgid "This is the XML file that is going to be manipulated::" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:797 +#: library/xml.etree.elementtree.rst:876 msgid "" "Example of changing the attribute \"target\" of every link in first " "paragraph::" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:816 +#: library/xml.etree.elementtree.rst:895 msgid "QName Objects" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:821 +#: library/xml.etree.elementtree.rst:900 msgid "" "QName wrapper. This can be used to wrap a QName attribute value, in order " "to get proper namespace handling on output. *text_or_uri* is a string " @@ -125844,11 +128885,11 @@ msgid "" "class:`QName` instances are opaque." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:832 +#: library/xml.etree.elementtree.rst:911 msgid "TreeBuilder Objects" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:837 +#: library/xml.etree.elementtree.rst:916 msgid "" "Generic element structure builder. This builder converts a sequence of " "start, data, and end method calls to a well-formed element structure. You " @@ -125857,44 +128898,44 @@ msgid "" "to create new :class:`Element` instances when given." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:846 +#: library/xml.etree.elementtree.rst:925 msgid "" "Flushes the builder buffers, and returns the toplevel document element. " "Returns an :class:`Element` instance." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:852 +#: library/xml.etree.elementtree.rst:931 msgid "" "Adds text to the current element. *data* is a string. This should be " "either a bytestring, or a Unicode string." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:858 +#: library/xml.etree.elementtree.rst:937 msgid "" "Closes the current element. *tag* is the element name. Returns the closed " "element." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:864 +#: library/xml.etree.elementtree.rst:943 msgid "" "Opens a new element. *tag* is the element name. *attrs* is a dictionary " "containing element attributes. Returns the opened element." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:868 +#: library/xml.etree.elementtree.rst:947 msgid "" "In addition, a custom :class:`TreeBuilder` object can provide the following " "method:" msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:873 +#: library/xml.etree.elementtree.rst:952 msgid "" "Handles a doctype declaration. *name* is the doctype name. *pubid* is the " "public identifier. *system* is the system identifier. This method does not " "exist on the default :class:`TreeBuilder` class." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:888 +#: library/xml.etree.elementtree.rst:967 msgid "" ":class:`Element` structure builder for XML source data, based on the expat " "parser. *html* are predefined HTML entities. This flag is not supported by " @@ -125904,15 +128945,20 @@ msgid "" "XML file." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:898 +#: library/xml.etree.elementtree.rst:977 msgid "Finishes feeding data to the parser. Returns an element structure." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:910 +#: library/xml.etree.elementtree.rst:982 +msgid "" +"Define the :meth:`TreeBuilder.doctype` method on a custom TreeBuilder target." +msgstr "" + +#: library/xml.etree.elementtree.rst:989 msgid "Feeds data to the parser. *data* is encoded data." msgstr "" -#: ../src/Doc/library/xml.etree.elementtree.rst:912 +#: library/xml.etree.elementtree.rst:991 msgid "" ":meth:`XMLParser.feed` calls *target*\\'s :meth:`start` method for each " "opening tag, its :meth:`end` method for each closing tag, and data is " @@ -125923,7 +128969,7 @@ msgid "" msgstr "" # 1f9b8d2e49d74fadb32e1585f98dc16a -#: ../src/Doc/library/xml.etree.elementtree.rst:954 +#: library/xml.etree.elementtree.rst:1033 msgid "" "The encoding string included in XML output should conform to the appropriate " "standards. For example, \"UTF-8\" is valid, but \"UTF8\" is not. See " @@ -125931,11 +128977,11 @@ msgid "" "iana.org/assignments/character-sets/character-sets.xhtml." msgstr "" -#: ../src/Doc/library/xml.sax.rst:3 +#: library/xml.sax.rst:3 msgid ":mod:`xml.sax` --- Support for SAX2 parsers" msgstr "" -#: ../src/Doc/library/xml.sax.rst:14 +#: library/xml.sax.rst:14 msgid "" "The :mod:`xml.sax` package provides a number of modules which implement the " "Simple API for XML (SAX) interface for Python. The package itself provides " @@ -125944,19 +128990,19 @@ msgid "" msgstr "" # ef792a924009442782712802afd28049 -#: ../src/Doc/library/xml.sax.rst:22 +#: library/xml.sax.rst:22 msgid "" "The :mod:`xml.sax` module is not secure against maliciously constructed " "data. If you need to parse untrusted or unauthenticated data see :ref:`xml-" "vulnerabilities`." msgstr "" -#: ../src/Doc/library/xml.sax.rst:27 +#: library/xml.sax.rst:27 msgid "The convenience functions are:" msgstr "" # 5faa001a8b8247c3b3d17212797098eb -#: ../src/Doc/library/xml.sax.rst:32 +#: library/xml.sax.rst:32 msgid "" "Create and return a SAX :class:`~xml.sax.xmlreader.XMLReader` object. The " "first parser found will be used. If *parser_list* is provided, it must be a " @@ -125966,7 +129012,7 @@ msgid "" msgstr "" # ee5808a2046341a296071edf98cf2fc2 -#: ../src/Doc/library/xml.sax.rst:41 +#: library/xml.sax.rst:41 msgid "" "Create a SAX parser and use it to parse a document. The document, passed in " "as *filename_or_stream*, can be a filename or a file object. The *handler* " @@ -125977,13 +129023,13 @@ msgid "" "passed in." msgstr "" -#: ../src/Doc/library/xml.sax.rst:52 +#: library/xml.sax.rst:52 msgid "" "Similar to :func:`parse`, but parses from a buffer *string* received as a " "parameter." msgstr "" -#: ../src/Doc/library/xml.sax.rst:55 +#: library/xml.sax.rst:55 msgid "" "A typical SAX application uses three kinds of objects: readers, handlers and " "input sources. \"Reader\" in this context is another term for parser, i.e. " @@ -125998,7 +129044,7 @@ msgid "" msgstr "" # 54d1fa2442a94dda8c7e814a99732dd4 -#: ../src/Doc/library/xml.sax.rst:66 +#: library/xml.sax.rst:66 msgid "" "For these objects, only the interfaces are relevant; they are normally not " "instantiated by the application itself. Since Python does not have an " @@ -126014,14 +129060,14 @@ msgid "" "interfaces are described below." msgstr "" -#: ../src/Doc/library/xml.sax.rst:79 +#: library/xml.sax.rst:79 msgid "" "In addition to these classes, :mod:`xml.sax` provides the following " "exception classes." msgstr "" # f6d532ec771747bc85288aea03aa8b29 -#: ../src/Doc/library/xml.sax.rst:85 +#: library/xml.sax.rst:85 msgid "" "Encapsulate an XML error or warning. This class can contain basic error or " "warning information from either the XML parser or the application: it can be " @@ -126032,7 +129078,7 @@ msgid "" "container for information." msgstr "" -#: ../src/Doc/library/xml.sax.rst:93 +#: library/xml.sax.rst:93 msgid "" "When instantiated, *msg* should be a human-readable description of the " "error. The optional *exception* parameter, if given, should be ``None`` or " @@ -126040,12 +129086,12 @@ msgid "" "as information." msgstr "" -#: ../src/Doc/library/xml.sax.rst:97 +#: library/xml.sax.rst:97 msgid "This is the base class for the other SAX exception classes." msgstr "" # 69fd0d319f78403dbf38ac9e6f962e81 -#: ../src/Doc/library/xml.sax.rst:102 +#: library/xml.sax.rst:102 msgid "" "Subclass of :exc:`SAXException` raised on parse errors. Instances of this " "class are passed to the methods of the SAX :class:`~xml.sax.handler." @@ -126055,7 +129101,7 @@ msgid "" msgstr "" # 136adebf66e04698b01d660cd7a7631b -#: ../src/Doc/library/xml.sax.rst:112 +#: library/xml.sax.rst:112 msgid "" "Subclass of :exc:`SAXException` raised when a SAX :class:`~xml.sax.xmlreader." "XMLReader` is confronted with an unrecognized feature or property. SAX " @@ -126063,7 +129109,7 @@ msgid "" msgstr "" # 72db59d9d61b4b819f60c016b5a9f64b -#: ../src/Doc/library/xml.sax.rst:120 +#: library/xml.sax.rst:120 msgid "" "Subclass of :exc:`SAXException` raised when a SAX :class:`~xml.sax.xmlreader." "XMLReader` is asked to enable a feature that is not supported, or to set a " @@ -126071,67 +129117,63 @@ msgid "" "applications and extensions may use this class for similar purposes." msgstr "" -# 601c472b90ca4d47852b8f8aac35e4be -#: ../src/Doc/library/xml.sax.rst:131 -msgid "`SAX: The Simple API for XML <http://www.saxproject.org/>`_" +#: library/xml.sax.rst:132 +msgid "SAX: The Simple API for XML" msgstr "" -#: ../src/Doc/library/xml.sax.rst:130 +#: library/xml.sax.rst:130 msgid "" "This site is the focal point for the definition of the SAX API. It provides " "a Java implementation and online documentation. Links to implementations " "and historical information are also available." msgstr "" -# 0bfa5398d3e64452aadc6c90ee9fc79e -#: ../src/Doc/library/xml.sax.rst:134 -msgid "Module :mod:`xml.sax.handler`" +#: library/xml.sax.rst:135 +msgid "Module xml.sax.handler" msgstr "" -#: ../src/Doc/library/xml.sax.rst:135 +#: library/xml.sax.rst:135 msgid "Definitions of the interfaces for application-provided objects." msgstr "" -# 976fbb95bb6c401e86904269c41db156 -#: ../src/Doc/library/xml.sax.rst:137 -msgid "Module :mod:`xml.sax.saxutils`" +#: library/xml.sax.rst:138 +msgid "Module xml.sax.saxutils" msgstr "" -#: ../src/Doc/library/xml.sax.rst:138 +#: library/xml.sax.rst:138 msgid "Convenience functions for use in SAX applications." msgstr "" -# dcd7af3b488a47388439d3947f7781fb -#: ../src/Doc/library/xml.sax.rst:139 -msgid "Module :mod:`xml.sax.xmlreader`" +#: library/xml.sax.rst:140 +msgid "Module xml.sax.xmlreader" msgstr "" -#: ../src/Doc/library/xml.sax.rst:141 +#: library/xml.sax.rst:141 msgid "Definitions of the interfaces for parser-provided objects." msgstr "" -#: ../src/Doc/library/xml.sax.rst:147 +#: library/xml.sax.rst:147 msgid "SAXException Objects" msgstr "" -#: ../src/Doc/library/xml.sax.rst:149 +#: library/xml.sax.rst:149 msgid "" "The :class:`SAXException` exception class supports the following methods:" msgstr "" -#: ../src/Doc/library/xml.sax.rst:154 +#: library/xml.sax.rst:154 msgid "Return a human-readable message describing the error condition." msgstr "" -#: ../src/Doc/library/xml.sax.rst:159 +#: library/xml.sax.rst:159 msgid "Return an encapsulated exception object, or ``None``." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:3 +#: library/xml.sax.handler.rst:3 msgid ":mod:`xml.sax.handler` --- Base classes for SAX handlers" msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:13 +#: library/xml.sax.handler.rst:13 msgid "" "The SAX API defines four kinds of handlers: content handlers, DTD handlers, " "error handlers, and entity resolvers. Applications normally only need to " @@ -126141,55 +129183,55 @@ msgid "" "mod:`xml.sax.handler`, so that all methods get default implementations." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:23 +#: library/xml.sax.handler.rst:23 msgid "" "This is the main callback interface in SAX, and the one most important to " "applications. The order of events in this interface mirrors the order of the " "information in the document." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:30 +#: library/xml.sax.handler.rst:30 msgid "Handle DTD events." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:32 +#: library/xml.sax.handler.rst:32 msgid "" "This interface specifies only those DTD events required for basic parsing " "(unparsed entities and attributes)." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:38 +#: library/xml.sax.handler.rst:38 msgid "" "Basic interface for resolving entities. If you create an object implementing " "this interface, then register the object with your Parser, the parser will " "call the method in your object to resolve all external entities." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:45 +#: library/xml.sax.handler.rst:45 msgid "" "Interface used by the parser to present error and warning messages to the " "application. The methods of this object control whether errors are " "immediately converted to exceptions or are handled in some other way." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:49 +#: library/xml.sax.handler.rst:49 msgid "" "In addition to these classes, :mod:`xml.sax.handler` provides symbolic " "constants for the feature and property names." msgstr "" # 163066f542574af49316445fdacfecb0 -#: ../src/Doc/library/xml.sax.handler.rst:55 +#: library/xml.sax.handler.rst:55 msgid "value: ``\"http://xml.org/sax/features/namespaces\"``" msgstr "" # 24a61653989540db84a78845257b0c6d -#: ../src/Doc/library/xml.sax.handler.rst:56 +#: library/xml.sax.handler.rst:56 msgid "true: Perform Namespace processing." msgstr "" # 57ac2fddd4ae4cc2b3972d451d9472bd -#: ../src/Doc/library/xml.sax.handler.rst:58 +#: library/xml.sax.handler.rst:58 msgid "" "false: Optionally do not perform Namespace processing (implies namespace-" "prefixes; default)." @@ -126202,209 +129244,205 @@ msgstr "" # a775aa5a515f4159b9c18b49229e9e39 # 53ac762b8b154d9a97c6fafcf549fb2f # 18789c2495b54996a4ef2bed907798d5 -#: ../src/Doc/library/xml.sax.handler.rst:59 -#: ../src/Doc/library/xml.sax.handler.rst:69 -#: ../src/Doc/library/xml.sax.handler.rst:78 -#: ../src/Doc/library/xml.sax.handler.rst:87 -#: ../src/Doc/library/xml.sax.handler.rst:95 -#: ../src/Doc/library/xml.sax.handler.rst:105 -#: ../src/Doc/library/xml.sax.handler.rst:137 +#: library/xml.sax.handler.rst:59 library/xml.sax.handler.rst:69 +#: library/xml.sax.handler.rst:78 library/xml.sax.handler.rst:87 +#: library/xml.sax.handler.rst:95 library/xml.sax.handler.rst:105 +#: library/xml.sax.handler.rst:137 msgid "access: (parsing) read-only; (not parsing) read/write" msgstr "" # b7cd2d47684545c1839e8c31018a5889 -#: ../src/Doc/library/xml.sax.handler.rst:64 +#: library/xml.sax.handler.rst:64 msgid "value: ``\"http://xml.org/sax/features/namespace-prefixes\"``" msgstr "" # fbb235b72e3841a3a7fdc1bda4e5a738 -#: ../src/Doc/library/xml.sax.handler.rst:66 +#: library/xml.sax.handler.rst:66 msgid "" "true: Report the original prefixed names and attributes used for Namespace " "declarations." msgstr "" # 0a97fcd700cc4763b29b60bf54383b05 -#: ../src/Doc/library/xml.sax.handler.rst:68 +#: library/xml.sax.handler.rst:68 msgid "" "false: Do not report attributes used for Namespace declarations, and " "optionally do not report original prefixed names (default)." msgstr "" # d0237381cc6c40ed86baef8986d74d71 -#: ../src/Doc/library/xml.sax.handler.rst:74 +#: library/xml.sax.handler.rst:74 msgid "value: ``\"http://xml.org/sax/features/string-interning\"``" msgstr "" # 136aaaaa7ab4408ba468ae1d2741ab37 -#: ../src/Doc/library/xml.sax.handler.rst:76 +#: library/xml.sax.handler.rst:76 msgid "" "true: All element names, prefixes, attribute names, Namespace URIs, and " "local names are interned using the built-in intern function." msgstr "" # e578ad54de0d4412b4752a921cd027af -#: ../src/Doc/library/xml.sax.handler.rst:77 +#: library/xml.sax.handler.rst:77 msgid "" "false: Names are not necessarily interned, although they may be (default)." msgstr "" # 6ede288f3ec449c692fd98bde8dfbe37 -#: ../src/Doc/library/xml.sax.handler.rst:83 +#: library/xml.sax.handler.rst:83 msgid "value: ``\"http://xml.org/sax/features/validation\"``" msgstr "" # 5e03451055f44c30968a8a948c53f3e1 -#: ../src/Doc/library/xml.sax.handler.rst:85 +#: library/xml.sax.handler.rst:85 msgid "" "true: Report all validation errors (implies external-general-entities and " "external-parameter-entities)." msgstr "" # 99f9453371b34115b640298801413255 -#: ../src/Doc/library/xml.sax.handler.rst:86 +#: library/xml.sax.handler.rst:86 msgid "false: Do not report validation errors." msgstr "" # b54820a7227741c6aaa97bc37a366453 -#: ../src/Doc/library/xml.sax.handler.rst:92 +#: library/xml.sax.handler.rst:92 msgid "value: ``\"http://xml.org/sax/features/external-general-entities\"``" msgstr "" # 1279622c81ad4f0692cc02ab61d788c6 -#: ../src/Doc/library/xml.sax.handler.rst:93 +#: library/xml.sax.handler.rst:93 msgid "true: Include all external general (text) entities." msgstr "" # 3806315eb2674bb98999de6da11c2a4a -#: ../src/Doc/library/xml.sax.handler.rst:94 +#: library/xml.sax.handler.rst:94 msgid "false: Do not include external general entities." msgstr "" # 6bb986fcd8df482f9ad30ed23453020d -#: ../src/Doc/library/xml.sax.handler.rst:100 +#: library/xml.sax.handler.rst:100 msgid "value: ``\"http://xml.org/sax/features/external-parameter-entities\"``" msgstr "" # 4ba0946750064c70aedeecd4e75ec0e0 -#: ../src/Doc/library/xml.sax.handler.rst:102 +#: library/xml.sax.handler.rst:102 msgid "" "true: Include all external parameter entities, including the external DTD " "subset." msgstr "" # 02ca60a9e74b4a50921d49619275cfa4 -#: ../src/Doc/library/xml.sax.handler.rst:104 +#: library/xml.sax.handler.rst:104 msgid "" "false: Do not include any external parameter entities, even the external DTD " "subset." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:110 +#: library/xml.sax.handler.rst:110 msgid "List of all features." msgstr "" # bdff31e578db4bef8f88c6a73cd32c7c -#: ../src/Doc/library/xml.sax.handler.rst:115 +#: library/xml.sax.handler.rst:115 msgid "value: ``\"http://xml.org/sax/properties/lexical-handler\"``" msgstr "" # 46f607feea774b3a9bbdf9df84cee0f2 -#: ../src/Doc/library/xml.sax.handler.rst:116 +#: library/xml.sax.handler.rst:116 msgid "data type: xml.sax.sax2lib.LexicalHandler (not supported in Python 2)" msgstr "" # 213305a5c71e4b07bde84ec7da5d6089 -#: ../src/Doc/library/xml.sax.handler.rst:118 +#: library/xml.sax.handler.rst:118 msgid "" "description: An optional extension handler for lexical events like comments." msgstr "" # 62bd5376729f4651ae21f6986fa5f3fc # c04022271c6b4ff78695bd18ccea3301 -#: ../src/Doc/library/xml.sax.handler.rst:119 -#: ../src/Doc/library/xml.sax.handler.rst:128 +#: library/xml.sax.handler.rst:119 library/xml.sax.handler.rst:128 msgid "access: read/write" msgstr "" # 4e6cc400981e4d76b570125d7ebdfc36 -#: ../src/Doc/library/xml.sax.handler.rst:124 +#: library/xml.sax.handler.rst:124 msgid "value: ``\"http://xml.org/sax/properties/declaration-handler\"``" msgstr "" # 04381718e61941c081951df98e7a230b -#: ../src/Doc/library/xml.sax.handler.rst:125 +#: library/xml.sax.handler.rst:125 msgid "data type: xml.sax.sax2lib.DeclHandler (not supported in Python 2)" msgstr "" # 8b6dd01eb6ae46999271d6273a25487d -#: ../src/Doc/library/xml.sax.handler.rst:127 +#: library/xml.sax.handler.rst:127 msgid "" "description: An optional extension handler for DTD-related events other than " "notations and unparsed entities." msgstr "" # 04aa545f82ec47958331dc8062bd8acf -#: ../src/Doc/library/xml.sax.handler.rst:133 +#: library/xml.sax.handler.rst:133 msgid "value: ``\"http://xml.org/sax/properties/dom-node\"``" msgstr "" # f6aa47785f6a4e7bb58ccca383b94c64 -#: ../src/Doc/library/xml.sax.handler.rst:134 +#: library/xml.sax.handler.rst:134 msgid "data type: org.w3c.dom.Node (not supported in Python 2)" msgstr "" # f68a56d724604d6282df448443678686 -#: ../src/Doc/library/xml.sax.handler.rst:136 +#: library/xml.sax.handler.rst:136 msgid "" "description: When parsing, the current DOM node being visited if this is a " "DOM iterator; when not parsing, the root DOM node for iteration." msgstr "" # cb12e46fd5d94c51b48a6edda2f67687 -#: ../src/Doc/library/xml.sax.handler.rst:142 +#: library/xml.sax.handler.rst:142 msgid "value: ``\"http://xml.org/sax/properties/xml-string\"``" msgstr "" # 2888d34524d246c3a30b09c3f11e92fe -#: ../src/Doc/library/xml.sax.handler.rst:143 +#: library/xml.sax.handler.rst:143 msgid "data type: String" msgstr "" # f1cff061dbec46c4a158906e8a3429c3 -#: ../src/Doc/library/xml.sax.handler.rst:145 +#: library/xml.sax.handler.rst:145 msgid "" "description: The literal string of characters that was the source for the " "current event." msgstr "" # 75318c96b59541caa871a35d8ff29d22 -#: ../src/Doc/library/xml.sax.handler.rst:146 +#: library/xml.sax.handler.rst:146 msgid "access: read-only" msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:151 +#: library/xml.sax.handler.rst:151 msgid "List of all known property names." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:157 +#: library/xml.sax.handler.rst:157 msgid "ContentHandler Objects" msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:159 +#: library/xml.sax.handler.rst:159 msgid "" "Users are expected to subclass :class:`ContentHandler` to support their " "application. The following methods are called by the parser on the " "appropriate events in the input document:" msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:166 +#: library/xml.sax.handler.rst:166 msgid "" "Called by the parser to give the application a locator for locating the " "origin of document events." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:169 +#: library/xml.sax.handler.rst:169 msgid "" "SAX parsers are strongly encouraged (though not absolutely required) to " "supply a locator: if it does so, it must supply the locator to the " @@ -126412,7 +129450,7 @@ msgid "" "in the DocumentHandler interface." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:174 +#: library/xml.sax.handler.rst:174 msgid "" "The locator allows the application to determine the end position of any " "document-related event, even if the parser is not reporting an error. " @@ -126422,28 +129460,28 @@ msgid "" "sufficient for use with a search engine." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:181 +#: library/xml.sax.handler.rst:181 msgid "" "Note that the locator will return correct information only during the " "invocation of the events in this interface. The application should not " "attempt to use it at any other time." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:188 +#: library/xml.sax.handler.rst:188 msgid "Receive notification of the beginning of a document." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:190 +#: library/xml.sax.handler.rst:190 msgid "" "The SAX parser will invoke this method only once, before any other methods " "in this interface or in DTDHandler (except for :meth:`setDocumentLocator`)." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:196 +#: library/xml.sax.handler.rst:196 msgid "Receive notification of the end of a document." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:198 +#: library/xml.sax.handler.rst:198 msgid "" "The SAX parser will invoke this method only once, and it will be the last " "method invoked during the parse. The parser shall not invoke this method " @@ -126451,11 +129489,11 @@ msgid "" "reached the end of input." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:206 +#: library/xml.sax.handler.rst:206 msgid "Begin the scope of a prefix-URI Namespace mapping." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:208 +#: library/xml.sax.handler.rst:208 msgid "" "The information from this event is not necessary for normal Namespace " "processing: the SAX XML reader will automatically replace prefixes for " @@ -126463,7 +129501,7 @@ msgid "" "enabled (the default)." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:213 +#: library/xml.sax.handler.rst:213 msgid "" "There are cases, however, when applications need to use prefixes in " "character data or in attribute values, where they cannot safely be expanded " @@ -126472,7 +129510,7 @@ msgid "" "contexts itself, if necessary." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:221 +#: library/xml.sax.handler.rst:221 msgid "" "Note that :meth:`startPrefixMapping` and :meth:`endPrefixMapping` events are " "not guaranteed to be properly nested relative to each-other: all :meth:" @@ -126482,23 +129520,23 @@ msgid "" "guaranteed." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:231 +#: library/xml.sax.handler.rst:231 msgid "End the scope of a prefix-URI mapping." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:233 +#: library/xml.sax.handler.rst:233 msgid "" "See :meth:`startPrefixMapping` for details. This event will always occur " "after the corresponding :meth:`endElement` event, but the order of :meth:" "`endPrefixMapping` events is not otherwise guaranteed." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:240 +#: library/xml.sax.handler.rst:240 msgid "Signals the start of an element in non-namespace mode." msgstr "" # a1c7ac9cfd2e4889a20db4d45ce75159 -#: ../src/Doc/library/xml.sax.handler.rst:242 +#: library/xml.sax.handler.rst:242 msgid "" "The *name* parameter contains the raw XML 1.0 name of the element type as a " "string and the *attrs* parameter holds an object of the :class:`~xml.sax." @@ -126509,22 +129547,22 @@ msgid "" "`copy` method of the *attrs* object." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:254 +#: library/xml.sax.handler.rst:254 msgid "Signals the end of an element in non-namespace mode." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:256 +#: library/xml.sax.handler.rst:256 msgid "" "The *name* parameter contains the name of the element type, just as with " "the :meth:`startElement` event." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:262 +#: library/xml.sax.handler.rst:262 msgid "Signals the start of an element in namespace mode." msgstr "" # 89094c9e9eaf4bb09efc5392bbda4000 -#: ../src/Doc/library/xml.sax.handler.rst:264 +#: library/xml.sax.handler.rst:264 msgid "" "The *name* parameter contains the name of the element type as a ``(uri, " "localname)`` tuple, the *qname* parameter contains the raw XML 1.0 name used " @@ -126538,27 +129576,27 @@ msgid "" "of the *attrs* object." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:275 +#: library/xml.sax.handler.rst:275 msgid "" "Parsers may set the *qname* parameter to ``None``, unless the " "``feature_namespace_prefixes`` feature is activated." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:281 +#: library/xml.sax.handler.rst:281 msgid "Signals the end of an element in namespace mode." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:283 +#: library/xml.sax.handler.rst:283 msgid "" "The *name* parameter contains the name of the element type, just as with " "the :meth:`startElementNS` method, likewise the *qname* parameter." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:289 +#: library/xml.sax.handler.rst:289 msgid "Receive notification of character data." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:291 +#: library/xml.sax.handler.rst:291 msgid "" "The Parser will call this method to report each chunk of character data. SAX " "parsers may return all contiguous character data in a single chunk, or they " @@ -126568,13 +129606,13 @@ msgid "" msgstr "" # cd8fce5afd26454aab48bbc95a62b3e8 -#: ../src/Doc/library/xml.sax.handler.rst:297 +#: library/xml.sax.handler.rst:297 msgid "" "*content* may be a Unicode string or a byte string; the ``expat`` reader " "module produces always Unicode strings." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:302 +#: library/xml.sax.handler.rst:302 msgid "" "The earlier SAX 1 interface provided by the Python XML Special Interest " "Group used a more Java-like interface for this method. Since most parsers " @@ -126584,11 +129622,11 @@ msgid "" "and *length* parameters." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:311 +#: library/xml.sax.handler.rst:311 msgid "Receive notification of ignorable whitespace in element content." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:313 +#: library/xml.sax.handler.rst:313 msgid "" "Validating Parsers must use this method to report each chunk of ignorable " "whitespace (see the W3C XML 1.0 recommendation, section 2.10): non-" @@ -126596,7 +129634,7 @@ msgid "" "and using content models." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:318 +#: library/xml.sax.handler.rst:318 msgid "" "SAX parsers may return all contiguous whitespace in a single chunk, or they " "may split it into several chunks; however, all of the characters in any " @@ -126604,28 +129642,28 @@ msgid "" "provides useful information." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:326 +#: library/xml.sax.handler.rst:326 msgid "Receive notification of a processing instruction." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:328 +#: library/xml.sax.handler.rst:328 msgid "" "The Parser will invoke this method once for each processing instruction " "found: note that processing instructions may occur before or after the main " "document element." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:332 +#: library/xml.sax.handler.rst:332 msgid "" "A SAX parser should never report an XML declaration (XML 1.0, section 2.8) " "or a text declaration (XML 1.0, section 4.3.1) using this method." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:338 +#: library/xml.sax.handler.rst:338 msgid "Receive notification of a skipped entity." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:340 +#: library/xml.sax.handler.rst:340 msgid "" "The Parser will invoke this method once for each entity skipped. Non-" "validating processors may skip entities if they have not seen the " @@ -126635,39 +129673,39 @@ msgid "" "properties." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:350 +#: library/xml.sax.handler.rst:350 msgid "DTDHandler Objects" msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:352 +#: library/xml.sax.handler.rst:352 msgid ":class:`DTDHandler` instances provide the following methods:" msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:357 +#: library/xml.sax.handler.rst:357 msgid "Handle a notation declaration event." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:362 +#: library/xml.sax.handler.rst:362 msgid "Handle an unparsed entity declaration event." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:368 +#: library/xml.sax.handler.rst:368 msgid "EntityResolver Objects" msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:373 +#: library/xml.sax.handler.rst:373 msgid "" "Resolve the system identifier of an entity and return either the system " "identifier to read from as a string, or an InputSource to read from. The " "default implementation returns *systemId*." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:381 +#: library/xml.sax.handler.rst:381 msgid "ErrorHandler Objects" msgstr "" # 29d3f76f4c09410abf345269c8996253 -#: ../src/Doc/library/xml.sax.handler.rst:383 +#: library/xml.sax.handler.rst:383 msgid "" "Objects with this interface are used to receive error and warning " "information from the :class:`~xml.sax.xmlreader.XMLReader`. If you create " @@ -126680,7 +129718,7 @@ msgid "" "in exception object." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:396 +#: library/xml.sax.handler.rst:396 msgid "" "Called when the parser encounters a recoverable error. If this method does " "not raise an exception, parsing may continue, but further document " @@ -126689,13 +129727,13 @@ msgid "" "document." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:404 +#: library/xml.sax.handler.rst:404 msgid "" "Called when the parser encounters an error it cannot recover from; parsing " "is expected to terminate when this method returns." msgstr "" -#: ../src/Doc/library/xml.sax.handler.rst:410 +#: library/xml.sax.handler.rst:410 msgid "" "Called when the parser presents minor warning information to the " "application. Parsing is expected to continue when this method returns, and " @@ -126703,11 +129741,11 @@ msgid "" "an exception in this method will cause parsing to end." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:3 +#: library/xml.sax.reader.rst:3 msgid ":mod:`xml.sax.xmlreader` --- Interface for XML parsers" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:13 +#: library/xml.sax.reader.rst:13 msgid "" "SAX parsers implement the :class:`XMLReader` interface. They are implemented " "in a Python module, which must provide a function :func:`create_parser`. " @@ -126715,11 +129753,11 @@ msgid "" "to create a new parser object." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:21 +#: library/xml.sax.reader.rst:21 msgid "Base class which can be inherited by SAX parsers." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:26 +#: library/xml.sax.reader.rst:26 msgid "" "In some cases, it is desirable not to parse an input source at once, but to " "feed chunks of the document as they get available. Note that the reader will " @@ -126729,7 +129767,7 @@ msgid "" "desirable." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:32 +#: library/xml.sax.reader.rst:32 msgid "" "When the parser is instantiated it is ready to begin accepting data from the " "feed method immediately. After parsing has been finished with a call to " @@ -126737,20 +129775,20 @@ msgid "" "data, either from feed or using the parse method." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:37 +#: library/xml.sax.reader.rst:37 msgid "" "Note that these methods must *not* be called during parsing, that is, after " "parse has been called and before it returns." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:40 +#: library/xml.sax.reader.rst:40 msgid "" "By default, the class also implements the parse method of the XMLReader " "interface using the feed, close and reset methods of the IncrementalParser " "interface as a convenience to SAX 2.0 driver writers." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:47 +#: library/xml.sax.reader.rst:47 msgid "" "Interface for associating a SAX event with a document location. A locator " "object will return valid results only during calls to DocumentHandler " @@ -126758,33 +129796,33 @@ msgid "" "not available, methods may return ``None``." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:55 +#: library/xml.sax.reader.rst:55 msgid "" "Encapsulation of the information needed by the :class:`XMLReader` to read " "entities." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:58 +#: library/xml.sax.reader.rst:58 msgid "" "This class may include information about the public identifier, system " "identifier, byte stream (possibly with character encoding information) and/" "or the character stream of an entity." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:62 +#: library/xml.sax.reader.rst:62 msgid "" "Applications will create objects of this class for use in the :meth:" "`XMLReader.parse` method and for returning from EntityResolver.resolveEntity." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:66 +#: library/xml.sax.reader.rst:66 msgid "" "An :class:`InputSource` belongs to the application, the :class:`XMLReader` " "is not allowed to modify :class:`InputSource` objects passed to it from the " "application, although it may make copies and modify those." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:73 +#: library/xml.sax.reader.rst:73 msgid "" "This is an implementation of the :class:`Attributes` interface (see section :" "ref:`attributes-objects`). This is a dictionary-like object which " @@ -126795,7 +129833,7 @@ msgid "" "a mapping from attribute names to attribute values." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:84 +#: library/xml.sax.reader.rst:84 msgid "" "Namespace-aware variant of :class:`AttributesImpl`, which will be passed to :" "meth:`startElementNS`. It is derived from :class:`AttributesImpl`, but " @@ -126805,15 +129843,15 @@ msgid "" "`AttributesNS` interface (see section :ref:`attributes-ns-objects`)." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:95 +#: library/xml.sax.reader.rst:95 msgid "XMLReader Objects" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:97 +#: library/xml.sax.reader.rst:97 msgid "The :class:`XMLReader` interface supports the following methods:" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:102 +#: library/xml.sax.reader.rst:102 msgid "" "Process an input source, producing SAX events. The *source* object can be a " "system identifier (a string identifying the input source -- typically a file " @@ -126825,36 +129863,36 @@ msgid "" msgstr "" # 824e0674cd4c49799110c407f703c72a -#: ../src/Doc/library/xml.sax.reader.rst:112 +#: library/xml.sax.reader.rst:112 msgid "Return the current :class:`~xml.sax.handler.ContentHandler`." msgstr "" # 08d74b9137ac478bb4eb19880a04fab5 -#: ../src/Doc/library/xml.sax.reader.rst:117 +#: library/xml.sax.reader.rst:117 msgid "" "Set the current :class:`~xml.sax.handler.ContentHandler`. If no :class:" "`~xml.sax.handler.ContentHandler` is set, content events will be discarded." msgstr "" # 824e0674cd4c49799110c407f703c72a -#: ../src/Doc/library/xml.sax.reader.rst:124 +#: library/xml.sax.reader.rst:124 msgid "Return the current :class:`~xml.sax.handler.DTDHandler`." msgstr "" # c46102c202d8465c801c5933b1fccaa6 -#: ../src/Doc/library/xml.sax.reader.rst:129 +#: library/xml.sax.reader.rst:129 msgid "" "Set the current :class:`~xml.sax.handler.DTDHandler`. If no :class:`~xml." "sax.handler.DTDHandler` is set, DTD events will be discarded." msgstr "" # 2f6537d27f1d4d6fa215cdfd9541ece7 -#: ../src/Doc/library/xml.sax.reader.rst:136 +#: library/xml.sax.reader.rst:136 msgid "Return the current :class:`~xml.sax.handler.EntityResolver`." msgstr "" # e20c073346bd4348a3a55eaec6df0cd0 -#: ../src/Doc/library/xml.sax.reader.rst:141 +#: library/xml.sax.reader.rst:141 msgid "" "Set the current :class:`~xml.sax.handler.EntityResolver`. If no :class:" "`~xml.sax.handler.EntityResolver` is set, attempts to resolve an external " @@ -126863,23 +129901,23 @@ msgid "" msgstr "" # 7d066c45bdae4e37b259b6716b47022c -#: ../src/Doc/library/xml.sax.reader.rst:149 +#: library/xml.sax.reader.rst:149 msgid "Return the current :class:`~xml.sax.handler.ErrorHandler`." msgstr "" # 1f161bb9e0f0408998443b6fc30d1ede -#: ../src/Doc/library/xml.sax.reader.rst:154 +#: library/xml.sax.reader.rst:154 msgid "" "Set the current error handler. If no :class:`~xml.sax.handler.ErrorHandler` " "is set, errors will be raised as exceptions, and warnings will be printed." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:160 +#: library/xml.sax.reader.rst:160 msgid "Allow an application to set the locale for errors and warnings." msgstr "" # 2727cf1e280f4232be5c105a1ffeef4e -#: ../src/Doc/library/xml.sax.reader.rst:162 +#: library/xml.sax.reader.rst:162 msgid "" "SAX parsers are not required to provide localization for errors and " "warnings; if they cannot support the requested locale, however, they must " @@ -126887,179 +129925,179 @@ msgid "" "middle of a parse." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:169 +#: library/xml.sax.reader.rst:169 msgid "" "Return the current setting for feature *featurename*. If the feature is not " "recognized, :exc:`SAXNotRecognizedException` is raised. The well-known " "featurenames are listed in the module :mod:`xml.sax.handler`." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:176 +#: library/xml.sax.reader.rst:176 msgid "" "Set the *featurename* to *value*. If the feature is not recognized, :exc:" "`SAXNotRecognizedException` is raised. If the feature or its setting is not " "supported by the parser, *SAXNotSupportedException* is raised." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:183 +#: library/xml.sax.reader.rst:183 msgid "" "Return the current setting for property *propertyname*. If the property is " "not recognized, a :exc:`SAXNotRecognizedException` is raised. The well-known " "propertynames are listed in the module :mod:`xml.sax.handler`." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:190 +#: library/xml.sax.reader.rst:190 msgid "" "Set the *propertyname* to *value*. If the property is not recognized, :exc:" "`SAXNotRecognizedException` is raised. If the property or its setting is not " "supported by the parser, *SAXNotSupportedException* is raised." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:198 +#: library/xml.sax.reader.rst:198 msgid "IncrementalParser Objects" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:200 +#: library/xml.sax.reader.rst:200 msgid "" "Instances of :class:`IncrementalParser` offer the following additional " "methods:" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:205 +#: library/xml.sax.reader.rst:205 msgid "Process a chunk of *data*." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:210 +#: library/xml.sax.reader.rst:210 msgid "" "Assume the end of the document. That will check well-formedness conditions " "that can be checked only at the end, invoke handlers, and may clean up " "resources allocated during parsing." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:217 +#: library/xml.sax.reader.rst:217 msgid "" "This method is called after close has been called to reset the parser so " "that it is ready to parse new documents. The results of calling parse or " "feed after close without calling reset are undefined." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:225 +#: library/xml.sax.reader.rst:225 msgid "Locator Objects" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:227 +#: library/xml.sax.reader.rst:227 msgid "Instances of :class:`Locator` provide these methods:" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:232 +#: library/xml.sax.reader.rst:232 msgid "Return the column number where the current event ends." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:237 +#: library/xml.sax.reader.rst:237 msgid "Return the line number where the current event ends." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:242 +#: library/xml.sax.reader.rst:242 msgid "Return the public identifier for the current event." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:247 +#: library/xml.sax.reader.rst:247 msgid "Return the system identifier for the current event." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:253 +#: library/xml.sax.reader.rst:253 msgid "InputSource Objects" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:258 +#: library/xml.sax.reader.rst:258 msgid "Sets the public identifier of this :class:`InputSource`." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:263 +#: library/xml.sax.reader.rst:263 msgid "Returns the public identifier of this :class:`InputSource`." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:268 +#: library/xml.sax.reader.rst:268 msgid "Sets the system identifier of this :class:`InputSource`." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:273 +#: library/xml.sax.reader.rst:273 msgid "Returns the system identifier of this :class:`InputSource`." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:278 +#: library/xml.sax.reader.rst:278 msgid "Sets the character encoding of this :class:`InputSource`." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:280 +#: library/xml.sax.reader.rst:280 msgid "" "The encoding must be a string acceptable for an XML encoding declaration " "(see section 4.3.3 of the XML recommendation)." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:283 +#: library/xml.sax.reader.rst:283 msgid "" "The encoding attribute of the :class:`InputSource` is ignored if the :class:" "`InputSource` also contains a character stream." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:289 +#: library/xml.sax.reader.rst:289 msgid "Get the character encoding of this InputSource." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:294 +#: library/xml.sax.reader.rst:294 msgid "" "Set the byte stream (a Python file-like object which does not perform byte-" "to-character conversion) for this input source." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:297 +#: library/xml.sax.reader.rst:297 msgid "" "The SAX parser will ignore this if there is also a character stream " "specified, but it will use a byte stream in preference to opening a URI " "connection itself." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:300 +#: library/xml.sax.reader.rst:300 msgid "" "If the application knows the character encoding of the byte stream, it " "should set it with the setEncoding method." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:306 +#: library/xml.sax.reader.rst:306 msgid "Get the byte stream for this input source." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:308 +#: library/xml.sax.reader.rst:308 msgid "" "The getEncoding method will return the character encoding for this byte " "stream, or None if unknown." msgstr "" # a5a71df9e4a8459d9b272e71341e44af -#: ../src/Doc/library/xml.sax.reader.rst:314 +#: library/xml.sax.reader.rst:314 msgid "" "Set the character stream for this input source. (The stream must be a Python " "1.6 Unicode-wrapped file-like that performs conversion to Unicode strings.)" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:317 +#: library/xml.sax.reader.rst:317 msgid "" "If there is a character stream specified, the SAX parser will ignore any " "byte stream and will not attempt to open a URI connection to the system " "identifier." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:323 +#: library/xml.sax.reader.rst:323 msgid "Get the character stream for this input source." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:329 +#: library/xml.sax.reader.rst:329 msgid "The :class:`Attributes` Interface" msgstr "" # d2dd347878904c62a6990bb9898e66b1 -#: ../src/Doc/library/xml.sax.reader.rst:331 +#: library/xml.sax.reader.rst:331 msgid "" ":class:`Attributes` objects implement a portion of the mapping protocol, " "including the methods :meth:`~collections.Mapping.copy`, :meth:`~collections." @@ -127068,70 +130106,70 @@ msgid "" "Mapping.values`. The following methods are also provided:" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:343 +#: library/xml.sax.reader.rst:343 msgid "Return the number of attributes." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:348 +#: library/xml.sax.reader.rst:348 msgid "Return the names of the attributes." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:353 +#: library/xml.sax.reader.rst:353 msgid "" "Returns the type of the attribute *name*, which is normally ``'CDATA'``." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:358 +#: library/xml.sax.reader.rst:358 msgid "Return the value of attribute *name*." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:367 +#: library/xml.sax.reader.rst:367 msgid "The :class:`AttributesNS` Interface" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:369 +#: library/xml.sax.reader.rst:369 msgid "" "This interface is a subtype of the :class:`Attributes` interface (see " "section :ref:`attributes-objects`). All methods supported by that interface " "are also available on :class:`AttributesNS` objects." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:373 +#: library/xml.sax.reader.rst:373 msgid "The following methods are also available:" msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:378 +#: library/xml.sax.reader.rst:378 msgid "Return the value for a qualified name." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:383 +#: library/xml.sax.reader.rst:383 msgid "Return the ``(namespace, localname)`` pair for a qualified *name*." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:388 +#: library/xml.sax.reader.rst:388 msgid "Return the qualified name for a ``(namespace, localname)`` pair." msgstr "" -#: ../src/Doc/library/xml.sax.reader.rst:393 +#: library/xml.sax.reader.rst:393 msgid "Return the qualified names of all attributes." msgstr "" -#: ../src/Doc/library/xml.sax.utils.rst:3 +#: library/xml.sax.utils.rst:3 msgid ":mod:`xml.sax.saxutils` --- SAX Utilities" msgstr "" -#: ../src/Doc/library/xml.sax.utils.rst:13 +#: library/xml.sax.utils.rst:13 msgid "" "The module :mod:`xml.sax.saxutils` contains a number of classes and " "functions that are commonly useful when creating SAX applications, either in " "direct use, or as base classes." msgstr "" -#: ../src/Doc/library/xml.sax.utils.rst:20 +#: library/xml.sax.utils.rst:20 msgid "Escape ``'&'``, ``'<'``, and ``'>'`` in a string of data." msgstr "" -#: ../src/Doc/library/xml.sax.utils.rst:22 +#: library/xml.sax.utils.rst:22 msgid "" "You can escape other strings of data by passing a dictionary as the optional " "*entities* parameter. The keys and values must all be strings; each key " @@ -127139,11 +130177,11 @@ msgid "" "``'<'`` and ``'>'`` are always escaped, even if *entities* is provided." msgstr "" -#: ../src/Doc/library/xml.sax.utils.rst:30 +#: library/xml.sax.utils.rst:30 msgid "Unescape ``'&amp;'``, ``'&lt;'``, and ``'&gt;'`` in a string of data." msgstr "" -#: ../src/Doc/library/xml.sax.utils.rst:32 +#: library/xml.sax.utils.rst:32 msgid "" "You can unescape other strings of data by passing a dictionary as the " "optional *entities* parameter. The keys and values must all be strings; " @@ -127152,7 +130190,7 @@ msgid "" "provided." msgstr "" -#: ../src/Doc/library/xml.sax.utils.rst:42 +#: library/xml.sax.utils.rst:42 msgid "" "Similar to :func:`escape`, but also prepares *data* to be used as an " "attribute value. The return value is a quoted version of *data* with any " @@ -127164,14 +130202,14 @@ msgid "" "directly as an attribute value::" msgstr "" -#: ../src/Doc/library/xml.sax.utils.rst:54 +#: library/xml.sax.utils.rst:54 msgid "" "This function is useful when generating attribute values for HTML or any " "SGML using the reference concrete syntax." msgstr "" # 04f6cd2cee004a909474435dd161d524 -#: ../src/Doc/library/xml.sax.utils.rst:62 +#: library/xml.sax.utils.rst:62 msgid "" "This class implements the :class:`~xml.sax.handler.ContentHandler` interface " "by writing SAX events back into an XML document. In other words, using an :" @@ -127182,7 +130220,7 @@ msgid "" msgstr "" # 17f7e93d860f483a928cb34c0aacdd5d -#: ../src/Doc/library/xml.sax.utils.rst:72 +#: library/xml.sax.utils.rst:72 msgid "" "This class is designed to sit between an :class:`~xml.sax.xmlreader." "XMLReader` and the client application's event handlers. By default, it does " @@ -127192,7 +130230,7 @@ msgid "" msgstr "" # c65bbb8a89f04c45a1746a2fef6605c7 -#: ../src/Doc/library/xml.sax.utils.rst:82 +#: library/xml.sax.utils.rst:82 msgid "" "This function takes an input source and an optional base URL and returns a " "fully resolved :class:`~xml.sax.xmlreader.InputSource` object ready for " @@ -127203,12 +130241,12 @@ msgid "" msgstr "" # 2bd41a8f28b84dab89b75aa21d02e7f4 -#: ../src/Doc/library/xmlrpclib.rst:2 +#: library/xmlrpclib.rst:2 msgid ":mod:`xmlrpclib` --- XML-RPC client access" msgstr "" # 8878405486394879be7eb08886bccd1c -#: ../src/Doc/library/xmlrpclib.rst:10 +#: library/xmlrpclib.rst:10 msgid "" "The :mod:`xmlrpclib` module has been renamed to :mod:`xmlrpc.client` in " "Python 3. The :term:`2to3` tool will automatically adapt imports when " @@ -127216,11 +130254,11 @@ msgid "" msgstr "" # 1fae162e9ee84e03bc017bfd4cb052f8 -#: ../src/Doc/library/xmlrpclib.rst:20 +#: library/xmlrpclib.rst:20 msgid "**Source code:** :source:`Lib/xmlrpclib.py`" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:24 +#: library/xmlrpclib.rst:24 msgid "" "XML-RPC is a Remote Procedure Call method that uses XML passed via HTTP as a " "transport. With it, a client can call methods with parameters on a remote " @@ -127230,21 +130268,20 @@ msgid "" msgstr "" # cdacc8b689e142478313b401be0149d1 -#: ../src/Doc/library/xmlrpclib.rst:33 +#: library/xmlrpclib.rst:33 msgid "" "The :mod:`xmlrpclib` module is not secure against maliciously constructed " "data. If you need to parse untrusted or unauthenticated data see :ref:`xml-" "vulnerabilities`." msgstr "" -# 1f37ee99964941099eefaa90f4717847 -#: ../src/Doc/library/xmlrpclib.rst:39 +#: library/xmlrpclib.rst:39 msgid "" -"In the case of https URIs, :mod:`xmlrpclib` does not do any verification of " -"the server's certificate." +"For https URIs, :mod:`xmlrpclib` now performs all the necessary certificate " +"and hostname checks by default" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:45 +#: library/xmlrpclib.rst:44 msgid "" "A :class:`ServerProxy` instance is an object that manages communication with " "a remote XML-RPC server. The required first argument is a URI (Uniform " @@ -127263,17 +130300,19 @@ msgid "" "passed to calls." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:60 +#: library/xmlrpclib.rst:59 msgid "" "Both the HTTP and HTTPS transports support the URL syntax extension for HTTP " -"Basic Authentication: ``http://user:pass@host:port/path``. The ``user:" +"Basic Authentication: ``http://user:pass@host:port/path``. The ``user:" "pass`` portion will be base64-encoded as an HTTP 'Authorization' header, and " "sent to the remote server as part of the connection process when invoking an " "XML-RPC method. You only need to use this if the remote server requires a " -"Basic Authentication user and password." +"Basic Authentication user and password. If an HTTPS url is provided, " +"*context* may be :class:`ssl.SSLContext` and configures the SSL settings of " +"the underlying HTTPS connection." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:67 +#: library/xmlrpclib.rst:68 msgid "" "The returned instance is a proxy object with methods that can be used to " "invoke corresponding RPC calls on the remote server. If the remote server " @@ -127282,7 +130321,7 @@ msgid "" "other server-associated metadata." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:73 +#: library/xmlrpclib.rst:74 msgid "" ":class:`ServerProxy` instance methods take Python basic types and objects as " "arguments and return Python basic types and classes. Types that are " @@ -127290,72 +130329,71 @@ msgid "" "(and except where noted, they are unmarshalled as the same Python type):" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:81 +#: library/xmlrpclib.rst:82 msgid ":const:`boolean`" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:81 +#: library/xmlrpclib.rst:82 msgid "The :const:`True` and :const:`False` constants" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:84 +#: library/xmlrpclib.rst:85 msgid ":const:`integers`" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:84 ../src/Doc/library/xmlrpclib.rst:86 -#: ../src/Doc/library/xmlrpclib.rst:88 +#: library/xmlrpclib.rst:85 library/xmlrpclib.rst:87 library/xmlrpclib.rst:89 msgid "Pass in directly" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:86 +#: library/xmlrpclib.rst:87 msgid ":const:`floating-point numbers`" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:88 +#: library/xmlrpclib.rst:89 msgid ":const:`strings`" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:90 +#: library/xmlrpclib.rst:91 msgid ":const:`arrays`" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:90 +#: library/xmlrpclib.rst:91 msgid "" "Any Python sequence type containing conformable elements. Arrays are " "returned as lists" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:94 +#: library/xmlrpclib.rst:95 msgid ":const:`structures`" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:94 +#: library/xmlrpclib.rst:95 msgid "" "A Python dictionary. Keys must be strings, values may be any conformable " "type. Objects of user-defined classes can be passed in; only their " "*__dict__* attribute is transmitted." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:100 +#: library/xmlrpclib.rst:101 msgid ":const:`dates`" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:100 +#: library/xmlrpclib.rst:101 msgid "" "in seconds since the epoch (pass in an instance of the :class:`DateTime` " "class) or a :class:`datetime.datetime` instance." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:104 +#: library/xmlrpclib.rst:105 msgid ":const:`binary data`" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:104 +#: library/xmlrpclib.rst:105 msgid "pass in an instance of the :class:`Binary` wrapper class" msgstr "" # cc97a0708e744484a36cd58ca2c65823 -#: ../src/Doc/library/xmlrpclib.rst:108 +#: library/xmlrpclib.rst:109 msgid "" "This is the full set of data types supported by XML-RPC. Method calls may " "also raise a special :exc:`Fault` instance, used to signal XML-RPC server " @@ -127366,7 +130404,7 @@ msgid "" "marshal instances of such subclasses." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:116 +#: library/xmlrpclib.rst:117 msgid "" "When passing strings, characters special to XML such as ``<``, ``>``, and " "``&`` will be automatically escaped. However, it's the caller's " @@ -127378,60 +130416,71 @@ msgid "" "class described below." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:124 +#: library/xmlrpclib.rst:125 msgid "" ":class:`Server` is retained as an alias for :class:`ServerProxy` for " "backwards compatibility. New code should use :class:`ServerProxy`." msgstr "" -# aea75cdbb8104080afd4f387c2dac439 -#: ../src/Doc/library/xmlrpclib.rst:139 -msgid "`XML-RPC HOWTO <http://www.tldp.org/HOWTO/XML-RPC-HOWTO/index.html>`_" +#: library/xmlrpclib.rst:128 library/xmlrpclib.rst:543 +msgid "The *use_datetime* flag was added." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:139 +#: library/xmlrpclib.rst:131 +msgid "" +"Instances of :term:`new-style class`\\es can be passed in if they have an " +"*__dict__* attribute and don't have a base class that is marshalled in a " +"special way." +msgstr "" + +#: library/xmlrpclib.rst:136 +msgid "Added the *context* argument." +msgstr "" + +#: library/xmlrpclib.rst:144 +msgid "XML-RPC HOWTO" +msgstr "" + +#: library/xmlrpclib.rst:143 msgid "" "A good description of XML-RPC operation and client software in several " "languages. Contains pretty much everything an XML-RPC client developer needs " "to know." msgstr "" -# 7d4a1dce13ad4a37a38d8eabb42ca37f -#: ../src/Doc/library/xmlrpclib.rst:142 -msgid "" -"`XML-RPC Introspection <http://xmlrpc-c.sourceforge.net/introspection.html>`_" -msgstr "" +#: library/xmlrpclib.rst:147 +#, fuzzy +msgid "XML-RPC Introspection" +msgstr "Introduction" -#: ../src/Doc/library/xmlrpclib.rst:143 +#: library/xmlrpclib.rst:147 msgid "Describes the XML-RPC protocol extension for introspection." msgstr "" -# af1bedd50b024ff6b308b380ebacbdd7 -#: ../src/Doc/library/xmlrpclib.rst:145 -msgid "`XML-RPC Specification <http://www.xmlrpc.com/spec>`_" +#: library/xmlrpclib.rst:150 +msgid "XML-RPC Specification" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:146 +#: library/xmlrpclib.rst:150 msgid "The official specification." msgstr "" -# 3263673a5f914e7ba73b082b46474820 -#: ../src/Doc/library/xmlrpclib.rst:150 -msgid "`Unofficial XML-RPC Errata <http://effbot.org/zone/xmlrpc-errata.htm>`_" +#: library/xmlrpclib.rst:155 +msgid "Unofficial XML-RPC Errata" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:149 +#: library/xmlrpclib.rst:153 msgid "" "Fredrik Lundh's \"unofficial errata, intended to clarify certain details in " "the XML-RPC specification, as well as hint at 'best practices' to use when " "designing your own XML-RPC implementations.\"" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:157 +#: library/xmlrpclib.rst:161 msgid "ServerProxy Objects" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:159 +#: library/xmlrpclib.rst:163 msgid "" "A :class:`ServerProxy` instance has a method corresponding to each remote " "procedure call accepted by the XML-RPC server. Calling the method performs " @@ -127442,19 +130491,19 @@ msgid "" msgstr "" # fbc31494da4f49d1a0005866d7511bbf -#: ../src/Doc/library/xmlrpclib.rst:166 +#: library/xmlrpclib.rst:170 msgid "" "Servers that support the XML introspection API support some common methods " "grouped under the reserved :attr:`system` attribute:" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:172 +#: library/xmlrpclib.rst:176 msgid "" "This method returns a list of strings, one for each (non-system) method " "supported by the XML-RPC server." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:178 +#: library/xmlrpclib.rst:182 msgid "" "This method takes one parameter, the name of a method implemented by the XML-" "RPC server. It returns an array of possible signatures for this method. A " @@ -127462,13 +130511,13 @@ msgid "" "of the method, the rest are parameters." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:183 +#: library/xmlrpclib.rst:187 msgid "" "Because multiple signatures (ie. overloading) is permitted, this method " "returns a list of signatures rather than a singleton." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:186 +#: library/xmlrpclib.rst:190 msgid "" "Signatures themselves are restricted to the top level parameters expected by " "a method. For instance if a method expects one array of structs as a " @@ -127477,14 +130526,14 @@ msgid "" "\"string, int, int, int\"." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:191 +#: library/xmlrpclib.rst:195 msgid "" "If no signature is defined for the method, a non-array value is returned. In " "Python this means that the type of the returned value will be something " "other than list." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:198 +#: library/xmlrpclib.rst:202 msgid "" "This method takes one parameter, the name of a method implemented by the XML-" "RPC server. It returns a documentation string describing the use of that " @@ -127493,12 +130542,12 @@ msgid "" msgstr "" # 35925fcc51384831856d527dff5403d8 -#: ../src/Doc/library/xmlrpclib.rst:207 +#: library/xmlrpclib.rst:211 msgid "Boolean Objects" msgstr "Les objets booléens" # a2ef370f23384a7bbd8d8da2bf766fdf -#: ../src/Doc/library/xmlrpclib.rst:209 +#: library/xmlrpclib.rst:213 msgid "" "This class may be initialized from any Python value; the instance returned " "depends only on its truth value. It supports various Python operators " @@ -127507,32 +130556,32 @@ msgid "" msgstr "" # 15571d5bf74a4f5daf0cf96cf9c04848 -#: ../src/Doc/library/xmlrpclib.rst:214 +#: library/xmlrpclib.rst:218 msgid "" "It also has the following method, supported mainly for internal use by the " "unmarshalling code:" msgstr "" # 36215fe3591d4c7b8a3eedb7fb7c6da8 -#: ../src/Doc/library/xmlrpclib.rst:220 +#: library/xmlrpclib.rst:224 msgid "" "Write the XML-RPC encoding of this Boolean item to the out stream object." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:222 ../src/Doc/library/xmlrpclib.rst:267 +#: library/xmlrpclib.rst:226 library/xmlrpclib.rst:271 msgid "A working example follows. The server code::" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:235 ../src/Doc/library/xmlrpclib.rst:282 -#: ../src/Doc/library/xmlrpclib.rst:388 ../src/Doc/library/xmlrpclib.rst:494 +#: library/xmlrpclib.rst:239 library/xmlrpclib.rst:286 +#: library/xmlrpclib.rst:392 library/xmlrpclib.rst:498 msgid "The client code for the preceding server::" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:246 +#: library/xmlrpclib.rst:250 msgid "DateTime Objects" msgstr "Objets DateTime" -#: ../src/Doc/library/xmlrpclib.rst:248 +#: library/xmlrpclib.rst:252 msgid "" "This class may be initialized with seconds since the epoch, a time tuple, an " "ISO 8601 time/date string, or a :class:`datetime.datetime` instance. It has " @@ -127540,57 +130589,57 @@ msgid "" "unmarshalling code:" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:256 +#: library/xmlrpclib.rst:260 msgid "Accept a string as the instance's new time value." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:261 +#: library/xmlrpclib.rst:265 msgid "" "Write the XML-RPC encoding of this :class:`DateTime` item to the *out* " "stream object." msgstr "" # b0f20b4df74b4cffbdf9e272158ee1d4 -#: ../src/Doc/library/xmlrpclib.rst:264 +#: library/xmlrpclib.rst:268 msgid "" "It also supports certain of Python's built-in operators through :meth:" "`__cmp__` and :meth:`__repr__` methods." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:297 +#: library/xmlrpclib.rst:301 msgid "Binary Objects" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:299 +#: library/xmlrpclib.rst:303 msgid "" "This class may be initialized from string data (which may include NULs). The " "primary access to the content of a :class:`Binary` object is provided by an " "attribute:" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:306 +#: library/xmlrpclib.rst:310 msgid "" "The binary data encapsulated by the :class:`Binary` instance. The data is " "provided as an 8-bit string." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:309 +#: library/xmlrpclib.rst:313 msgid "" ":class:`Binary` objects have the following methods, supported mainly for " "internal use by the marshalling/unmarshalling code:" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:315 +#: library/xmlrpclib.rst:319 msgid "Accept a base64 string and decode it as the instance's new data." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:320 +#: library/xmlrpclib.rst:324 msgid "" "Write the XML-RPC base 64 encoding of this binary item to the out stream " "object." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:322 +#: library/xmlrpclib.rst:326 msgid "" "The encoded data will have newlines every 76 characters as per `RFC 2045 " "section 6.8 <http://tools.ietf.org/html/rfc2045#section-6.8>`_, which was " @@ -127598,97 +130647,97 @@ msgid "" msgstr "" # fae1236b19f248b691456353405124ee -#: ../src/Doc/library/xmlrpclib.rst:327 +#: library/xmlrpclib.rst:331 msgid "" "It also supports certain of Python's built-in operators through a :meth:" "`__cmp__` method." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:330 +#: library/xmlrpclib.rst:334 msgid "" "Example usage of the binary objects. We're going to transfer an image over " "XMLRPC::" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:346 +#: library/xmlrpclib.rst:350 msgid "The client gets the image and saves it to a file::" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:357 +#: library/xmlrpclib.rst:361 msgid "Fault Objects" msgstr "" # 83ab6808ff5b44e3b47c907ba759c4e3 -#: ../src/Doc/library/xmlrpclib.rst:359 +#: library/xmlrpclib.rst:363 msgid "" "A :class:`Fault` object encapsulates the content of an XML-RPC fault tag. " "Fault objects have the following attributes:" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:365 +#: library/xmlrpclib.rst:369 msgid "A string indicating the fault type." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:370 +#: library/xmlrpclib.rst:374 msgid "A string containing a diagnostic message associated with the fault." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:372 +#: library/xmlrpclib.rst:376 msgid "" "In the following example we're going to intentionally cause a :exc:`Fault` " "by returning a complex type object. The server code::" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:405 +#: library/xmlrpclib.rst:409 msgid "ProtocolError Objects" msgstr "" # f5fc1a33c7db4618b7271d3f175bd0e8 -#: ../src/Doc/library/xmlrpclib.rst:407 +#: library/xmlrpclib.rst:411 msgid "" "A :class:`ProtocolError` object describes a protocol error in the underlying " "transport layer (such as a 404 'not found' error if the server named by the " "URI does not exist). It has the following attributes:" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:414 +#: library/xmlrpclib.rst:418 msgid "The URI or URL that triggered the error." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:419 +#: library/xmlrpclib.rst:423 msgid "The error code." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:424 +#: library/xmlrpclib.rst:428 msgid "The error message or diagnostic string." msgstr "" # c86b95646bce4a5abdd47a521b01cc63 -#: ../src/Doc/library/xmlrpclib.rst:429 +#: library/xmlrpclib.rst:433 msgid "" "A string containing the headers of the HTTP/HTTPS request that triggered the " "error." msgstr "" # 88e1606678de47dc96a17b3a6f6455b0 -#: ../src/Doc/library/xmlrpclib.rst:432 +#: library/xmlrpclib.rst:436 msgid "" "In the following example we're going to intentionally cause a :exc:" "`ProtocolError` by providing an URI that doesn't point to an XMLRPC server::" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:450 +#: library/xmlrpclib.rst:454 msgid "MultiCall Objects" msgstr "" # a2bf70be65fa47a992efaa8049830822 -#: ../src/Doc/library/xmlrpclib.rst:454 +#: library/xmlrpclib.rst:458 msgid "" "The :class:`MultiCall` object provides a way to encapsulate multiple calls " "to a remote server into a single request [#]_." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:460 +#: library/xmlrpclib.rst:464 msgid "" "Create an object used to boxcar method calls. *server* is the eventual " "target of the call. Calls can be made to the result object, but they will " @@ -127699,22 +130748,22 @@ msgid "" "the individual results." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:468 +#: library/xmlrpclib.rst:472 msgid "A usage example of this class follows. The server code ::" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:510 +#: library/xmlrpclib.rst:514 msgid "Convenience Functions" msgstr "" # faca6da8e4ec48cf9a7c11bce2d2cfcb -#: ../src/Doc/library/xmlrpclib.rst:515 +#: library/xmlrpclib.rst:519 msgid "" "Convert any Python value to one of the XML-RPC Boolean constants, ``True`` " "or ``False``." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:521 +#: library/xmlrpclib.rst:525 msgid "" "Convert *params* into an XML-RPC request. or into a response if " "*methodresponse* is true. *params* can be either a tuple of arguments or an " @@ -127726,7 +130775,7 @@ msgid "" "*allow_none*." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:532 +#: library/xmlrpclib.rst:536 msgid "" "Convert an XML-RPC request or response into Python objects, a ``(params, " "methodname)``. *params* is a tuple of argument; *methodname* is a string, " @@ -127736,42 +130785,42 @@ msgid "" "be presented as :class:`datetime.datetime` objects; this is false by default." msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:546 +#: library/xmlrpclib.rst:550 msgid "Example of Client Usage" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:563 +#: library/xmlrpclib.rst:567 msgid "" "To access an XML-RPC server through a proxy, you need to define a custom " "transport. The following example shows how:" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:591 +#: library/xmlrpclib.rst:595 msgid "Example of Client and Server Usage" msgstr "" -#: ../src/Doc/library/xmlrpclib.rst:593 +#: library/xmlrpclib.rst:597 msgid "See :ref:`simplexmlrpcserver-example`." msgstr "" # 8367c703238348f9983df49650165116 -#: ../src/Doc/library/xmlrpclib.rst:598 +#: library/xmlrpclib.rst:602 msgid "" "This approach has been first presented in `a discussion on xmlrpc.com " "<http://web.archive.org/web/20060624230303/http://www.xmlrpc.com/discuss/" "msgReader$1208?mode=topic>`_." msgstr "" -#: ../src/Doc/library/zipfile.rst:2 +#: library/zipfile.rst:2 msgid ":mod:`zipfile` --- Work with ZIP archives" msgstr "" # 1a430169169046a7aebce51553d9d105 -#: ../src/Doc/library/zipfile.rst:11 +#: library/zipfile.rst:11 msgid "**Source code:** :source:`Lib/zipfile.py`" msgstr "" -#: ../src/Doc/library/zipfile.rst:15 +#: library/zipfile.rst:15 msgid "" "The ZIP file format is a common archive and compression standard. This " "module provides tools to create, read, write, append, and list a ZIP file. " @@ -127781,7 +130830,7 @@ msgid "" msgstr "" # bc58296677cd45fda6e386ee0307ecb7 -#: ../src/Doc/library/zipfile.rst:21 +#: library/zipfile.rst:21 msgid "" "This module does not currently handle multi-disk ZIP files. It can handle " "ZIP files that use the ZIP64 extensions (that is ZIP files that are more " @@ -127790,28 +130839,28 @@ msgid "" "extremely slow as it is implemented in native Python rather than C." msgstr "" -#: ../src/Doc/library/zipfile.rst:32 +#: library/zipfile.rst:32 msgid "The error raised for bad ZIP files (old name: ``zipfile.error``)." msgstr "" -#: ../src/Doc/library/zipfile.rst:37 +#: library/zipfile.rst:37 msgid "" "The error raised when a ZIP file would require ZIP64 functionality but that " "has not been enabled." msgstr "" -#: ../src/Doc/library/zipfile.rst:44 +#: library/zipfile.rst:44 msgid "" "The class for reading and writing ZIP files. See section :ref:`zipfile-" "objects` for constructor details." msgstr "" -#: ../src/Doc/library/zipfile.rst:50 +#: library/zipfile.rst:50 msgid "Class for creating ZIP archives containing Python libraries." msgstr "" # ce01f82c835b4e62a4ab432d750de273 -#: ../src/Doc/library/zipfile.rst:55 +#: library/zipfile.rst:55 msgid "" "Class used to represent information about a member of an archive. Instances " "of this class are returned by the :meth:`.getinfo` and :meth:`.infolist` " @@ -127824,56 +130873,55 @@ msgid "" msgstr "" # a3b8e56cd26e43efb2596b08b4042bf8 -#: ../src/Doc/library/zipfile.rst:67 +#: library/zipfile.rst:67 msgid "" "Returns ``True`` if *filename* is a valid ZIP file based on its magic " "number, otherwise returns ``False``. *filename* may be a file or file-like " "object too." msgstr "" -#: ../src/Doc/library/zipfile.rst:75 +#: library/zipfile.rst:70 +msgid "Support for file and file-like objects." +msgstr "" + +#: library/zipfile.rst:75 msgid "The numeric constant for an uncompressed archive member." msgstr "" # ec829cec942e4b90b0cce0eb6ea7c762 -#: ../src/Doc/library/zipfile.rst:80 +#: library/zipfile.rst:80 msgid "" "The numeric constant for the usual ZIP compression method. This requires " "the :mod:`zlib` module. No other compression methods are currently " "supported." msgstr "" -# 0d3b7a4038674c18a9aaecc8cf63801a -# 3c17b8f69c1e423fb88a240e637ca134 -#: ../src/Doc/library/zipfile.rst:87 ../src/Doc/library/zipimport.rst:41 -msgid "" -"`PKZIP Application Note <http://www.pkware.com/documents/casestudies/APPNOTE." -"TXT>`_" +#: library/zipfile.rst:88 library/zipimport.rst:42 +msgid "PKZIP Application Note" msgstr "" -#: ../src/Doc/library/zipfile.rst:87 ../src/Doc/library/zipimport.rst:41 +#: library/zipfile.rst:87 library/zipimport.rst:41 msgid "" "Documentation on the ZIP file format by Phil Katz, the creator of the format " "and algorithms used." msgstr "" -# e233b0b9066f4c4899bb5d53c16eb609 -#: ../src/Doc/library/zipfile.rst:90 -msgid "`Info-ZIP Home Page <http://www.info-zip.org/>`_" +#: library/zipfile.rst:91 +msgid "Info-ZIP Home Page" msgstr "" -#: ../src/Doc/library/zipfile.rst:91 +#: library/zipfile.rst:91 msgid "" "Information about the Info-ZIP project's ZIP archive programs and " "development libraries." msgstr "" -#: ../src/Doc/library/zipfile.rst:98 +#: library/zipfile.rst:98 msgid "ZipFile Objects" msgstr "" # 0c71f1f889964a9393491cbd1bf5ba07 -#: ../src/Doc/library/zipfile.rst:103 +#: library/zipfile.rst:103 msgid "" "Open a ZIP file, where *file* can be either a path to a file (a string) or a " "file-like object. The *mode* parameter should be ``'r'`` to read an " @@ -127885,8 +130933,12 @@ msgid "" "`python.exe`)." msgstr "" +#: library/zipfile.rst:111 +msgid "If *mode* is ``a`` and the file does not exist at all, it is created." +msgstr "" + # 38377a46b29c4600bece6296b49c0e46 -#: ../src/Doc/library/zipfile.rst:114 +#: library/zipfile.rst:114 msgid "" "*compression* is the ZIP compression method to use when writing the archive, " "and should be :const:`ZIP_STORED` or :const:`ZIP_DEFLATED`; unrecognized " @@ -127901,39 +130953,50 @@ msgid "" "InfoZIP utilities) don't support these extensions." msgstr "" -#: ../src/Doc/library/zipfile.rst:131 +#: library/zipfile.rst:126 +msgid "" +"If the file is created with mode ``'a'`` or ``'w'`` and then :meth:`closed " +"<close>` without adding any files to the archive, the appropriate ZIP " +"structures for an empty archive will be written to the file." +msgstr "" + +#: library/zipfile.rst:131 msgid "" "ZipFile is also a context manager and therefore supports the :keyword:`with` " "statement. In the example, *myzip* is closed after the :keyword:`with` " "statement's suite is finished---even if an exception occurs::" msgstr "" -#: ../src/Doc/library/zipfile.rst:144 +#: library/zipfile.rst:138 +msgid "Added the ability to use :class:`ZipFile` as a context manager." +msgstr "" + +#: library/zipfile.rst:144 msgid "" "Close the archive file. You must call :meth:`close` before exiting your " "program or essential records will not be written." msgstr "" -#: ../src/Doc/library/zipfile.rst:150 +#: library/zipfile.rst:150 msgid "" "Return a :class:`ZipInfo` object with information about the archive member " "*name*. Calling :meth:`getinfo` for a name not currently contained in the " "archive will raise a :exc:`KeyError`." msgstr "" -#: ../src/Doc/library/zipfile.rst:157 +#: library/zipfile.rst:157 msgid "" "Return a list containing a :class:`ZipInfo` object for each member of the " "archive. The objects are in the same order as their entries in the actual " "ZIP file on disk if an existing archive was opened." msgstr "" -#: ../src/Doc/library/zipfile.rst:164 +#: library/zipfile.rst:164 msgid "Return a list of archive members by name." msgstr "" # 03171d2a5f1047f891b4bff9a82e2973 -#: ../src/Doc/library/zipfile.rst:172 +#: library/zipfile.rst:172 msgid "" "Extract a member from the archive as a file-like object (ZipExtFile). *name* " "is the name of the file in the archive, or a :class:`ZipInfo` object. The " @@ -127945,14 +131008,14 @@ msgid "" msgstr "" # d3585380463649ffad271c6ae78d95d7 -#: ../src/Doc/library/zipfile.rst:182 +#: library/zipfile.rst:182 msgid "" "The file-like object is read-only and provides the following methods: :meth:" "`~file.read`, :meth:`~file.readline`, :meth:`~file.readlines`, :meth:" "`__iter__`, :meth:`~object.next`." msgstr "" -#: ../src/Doc/library/zipfile.rst:189 +#: library/zipfile.rst:189 msgid "" "If the ZipFile was created by passing in a file-like object as the first " "argument to the constructor, then the object returned by :meth:`.open` " @@ -127965,14 +131028,14 @@ msgid "" msgstr "" # 9f49e0d88fc34d18843bcd78f52832d9 -#: ../src/Doc/library/zipfile.rst:200 +#: library/zipfile.rst:200 msgid "" "The :meth:`.open`, :meth:`read` and :meth:`extract` methods can take a " "filename or a :class:`ZipInfo` object. You will appreciate this when trying " "to read a ZIP file that contains members with duplicate names." msgstr "" -#: ../src/Doc/library/zipfile.rst:209 +#: library/zipfile.rst:209 msgid "" "Extract a member from the archive to the current working directory; *member* " "must be its full name or a :class:`ZipInfo` object). Its file information " @@ -127981,8 +131044,12 @@ msgid "" "object. *pwd* is the password used for encrypted files." msgstr "" +#: library/zipfile.rst:215 +msgid "Returns the normalized path created (a directory or new file)." +msgstr "" + # 5ae2190807aa48b698a41c13b98b78d1 -#: ../src/Doc/library/zipfile.rst:219 +#: library/zipfile.rst:221 msgid "" "If a member filename is an absolute path, a drive/UNC sharepoint and leading " "(back)slashes will be stripped, e.g.: ``///foo/bar`` becomes ``foo/bar`` on " @@ -127993,7 +131060,7 @@ msgid "" "(``_``)." msgstr "" -#: ../src/Doc/library/zipfile.rst:230 +#: library/zipfile.rst:232 msgid "" "Extract all members from the archive to the current working directory. " "*path* specifies a different directory to extract to. *members* is optional " @@ -128001,15 +131068,19 @@ msgid "" "password used for encrypted files." msgstr "" -#: ../src/Doc/library/zipfile.rst:250 +#: library/zipfile.rst:244 +msgid "The zipfile module attempts to prevent that. See :meth:`extract` note." +msgstr "" + +#: library/zipfile.rst:252 msgid "Print a table of contents for the archive to ``sys.stdout``." msgstr "" -#: ../src/Doc/library/zipfile.rst:255 +#: library/zipfile.rst:257 msgid "Set *pwd* as default password to extract encrypted files." msgstr "" -#: ../src/Doc/library/zipfile.rst:262 +#: library/zipfile.rst:264 msgid "" "Return the bytes of the file *name* in the archive. *name* is the name of " "the file in the archive, or a :class:`ZipInfo` object. The archive must be " @@ -128019,14 +131090,18 @@ msgid "" "`RuntimeError`." msgstr "" -#: ../src/Doc/library/zipfile.rst:274 +#: library/zipfile.rst:270 +msgid "*pwd* was added, and *name* can now be a :class:`ZipInfo` object." +msgstr "" + +#: library/zipfile.rst:276 msgid "" "Read all the files in the archive and check their CRC's and file headers. " "Return the name of the first bad file, or else return ``None``. Calling :" "meth:`testzip` on a closed ZipFile will raise a :exc:`RuntimeError`." msgstr "" -#: ../src/Doc/library/zipfile.rst:281 +#: library/zipfile.rst:283 msgid "" "Write the file named *filename* to the archive, giving it the archive name " "*arcname* (by default, this will be the same as *filename*, but without a " @@ -128038,7 +131113,7 @@ msgid "" "closed ZipFile will raise a :exc:`RuntimeError`." msgstr "" -#: ../src/Doc/library/zipfile.rst:292 +#: library/zipfile.rst:294 msgid "" "There is no official file name encoding for ZIP files. If you have unicode " "file names, you must convert them to byte strings in your desired encoding " @@ -128046,20 +131121,20 @@ msgid "" "encoded in CP437, also known as DOS Latin." msgstr "" -#: ../src/Doc/library/zipfile.rst:299 +#: library/zipfile.rst:301 msgid "" "Archive names should be relative to the archive root, that is, they should " "not start with a path separator." msgstr "" -#: ../src/Doc/library/zipfile.rst:304 +#: library/zipfile.rst:306 msgid "" "If ``arcname`` (or ``filename``, if ``arcname`` is not given) contains a " "null byte, the name of the file in the archive will be truncated at the null " "byte." msgstr "" -#: ../src/Doc/library/zipfile.rst:310 +#: library/zipfile.rst:312 msgid "" "Write the string *bytes* to the archive; *zinfo_or_arcname* is either the " "file name it will be given in the archive, or a :class:`ZipInfo` instance. " @@ -128071,7 +131146,7 @@ msgid "" "exc:`RuntimeError`." msgstr "" -#: ../src/Doc/library/zipfile.rst:318 +#: library/zipfile.rst:320 msgid "" "If given, *compress_type* overrides the value given for the *compression* " "parameter to the constructor for the new entry, or in the *zinfo_or_arcname* " @@ -128079,7 +131154,7 @@ msgid "" msgstr "" # 770cac97c52640eaba6ca04f143bb676 -#: ../src/Doc/library/zipfile.rst:324 +#: library/zipfile.rst:326 msgid "" "When passing a :class:`ZipInfo` instance as the *zinfo_or_arcname* " "parameter, the compression method used will be that specified in the " @@ -128087,11 +131162,15 @@ msgid "" "the :class:`ZipInfo` constructor sets this member to :const:`ZIP_STORED`." msgstr "" -#: ../src/Doc/library/zipfile.rst:332 +#: library/zipfile.rst:331 +msgid "The *compress_type* argument." +msgstr "" + +#: library/zipfile.rst:334 msgid "The following data attributes are also available:" msgstr "" -#: ../src/Doc/library/zipfile.rst:337 +#: library/zipfile.rst:339 msgid "" "The level of debug output to use. This may be set from ``0`` (the default, " "no output) to ``3`` (the most output). Debugging information is written to " @@ -128099,7 +131178,7 @@ msgid "" msgstr "" # 528dfd6e6a5e4c219a87d3f4fcbb1a35 -#: ../src/Doc/library/zipfile.rst:343 +#: library/zipfile.rst:345 msgid "" "The comment text associated with the ZIP file. If assigning a comment to a :" "class:`ZipFile` instance created with mode 'a' or 'w', this should be a " @@ -128107,18 +131186,18 @@ msgid "" "truncated in the written archive when :meth:`.close` is called." msgstr "" -#: ../src/Doc/library/zipfile.rst:351 +#: library/zipfile.rst:353 msgid "PyZipFile Objects" msgstr "" -#: ../src/Doc/library/zipfile.rst:353 +#: library/zipfile.rst:355 msgid "" "The :class:`PyZipFile` constructor takes the same parameters as the :class:" "`ZipFile` constructor. Instances have one method in addition to those of :" "class:`ZipFile` objects." msgstr "" -#: ../src/Doc/library/zipfile.rst:360 +#: library/zipfile.rst:362 msgid "" "Search for files :file:`\\*.py` and add the corresponding file to the " "archive. The corresponding file is a :file:`\\*.pyo` file if available, else " @@ -128135,131 +131214,131 @@ msgid "" "with file names like this::" msgstr "" -#: ../src/Doc/library/zipfile.rst:384 +#: library/zipfile.rst:386 msgid "ZipInfo Objects" msgstr "" # 85a97344e8924c1fa9114feda136d93a -#: ../src/Doc/library/zipfile.rst:386 +#: library/zipfile.rst:388 msgid "" "Instances of the :class:`ZipInfo` class are returned by the :meth:`.getinfo` " "and :meth:`.infolist` methods of :class:`ZipFile` objects. Each object " "stores information about a single member of the ZIP archive." msgstr "" -#: ../src/Doc/library/zipfile.rst:390 +#: library/zipfile.rst:392 msgid "Instances have the following attributes:" msgstr "" -#: ../src/Doc/library/zipfile.rst:395 +#: library/zipfile.rst:397 msgid "Name of the file in the archive." msgstr "" -#: ../src/Doc/library/zipfile.rst:400 +#: library/zipfile.rst:402 msgid "" "The time and date of the last modification to the archive member. This is a " "tuple of six values:" msgstr "" # ef33d5f168654acf8a613e3ad4d4baad -#: ../src/Doc/library/zipfile.rst:406 +#: library/zipfile.rst:408 msgid "Year (>= 1980)" msgstr "" -#: ../src/Doc/library/zipfile.rst:408 +#: library/zipfile.rst:410 msgid "Month (one-based)" msgstr "" -#: ../src/Doc/library/zipfile.rst:410 +#: library/zipfile.rst:412 msgid "Day of month (one-based)" msgstr "" -#: ../src/Doc/library/zipfile.rst:412 +#: library/zipfile.rst:414 msgid "Hours (zero-based)" msgstr "" -#: ../src/Doc/library/zipfile.rst:414 +#: library/zipfile.rst:416 msgid "Minutes (zero-based)" msgstr "" -#: ../src/Doc/library/zipfile.rst:416 +#: library/zipfile.rst:418 msgid "Seconds (zero-based)" msgstr "" # 56a953a5054b4cd28fa58ba5288cf54b -#: ../src/Doc/library/zipfile.rst:421 +#: library/zipfile.rst:423 msgid "The ZIP file format does not support timestamps before 1980." msgstr "" -#: ../src/Doc/library/zipfile.rst:426 +#: library/zipfile.rst:428 msgid "Type of compression for the archive member." msgstr "" -#: ../src/Doc/library/zipfile.rst:431 +#: library/zipfile.rst:433 msgid "Comment for the individual archive member." msgstr "" -#: ../src/Doc/library/zipfile.rst:436 +#: library/zipfile.rst:438 msgid "" "Expansion field data. The `PKZIP Application Note <http://www.pkware.com/" "documents/casestudies/APPNOTE.TXT>`_ contains some comments on the internal " "structure of the data contained in this string." msgstr "" -#: ../src/Doc/library/zipfile.rst:443 +#: library/zipfile.rst:445 msgid "System which created ZIP archive." msgstr "" -#: ../src/Doc/library/zipfile.rst:448 +#: library/zipfile.rst:450 msgid "PKZIP version which created ZIP archive." msgstr "" -#: ../src/Doc/library/zipfile.rst:453 +#: library/zipfile.rst:455 msgid "PKZIP version needed to extract archive." msgstr "" -#: ../src/Doc/library/zipfile.rst:458 +#: library/zipfile.rst:460 msgid "Must be zero." msgstr "" -#: ../src/Doc/library/zipfile.rst:463 +#: library/zipfile.rst:465 msgid "ZIP flag bits." msgstr "" -#: ../src/Doc/library/zipfile.rst:468 +#: library/zipfile.rst:470 msgid "Volume number of file header." msgstr "" -#: ../src/Doc/library/zipfile.rst:473 +#: library/zipfile.rst:475 msgid "Internal attributes." msgstr "" -#: ../src/Doc/library/zipfile.rst:478 +#: library/zipfile.rst:480 msgid "External file attributes." msgstr "" -#: ../src/Doc/library/zipfile.rst:483 +#: library/zipfile.rst:485 msgid "Byte offset to the file header." msgstr "" -#: ../src/Doc/library/zipfile.rst:488 +#: library/zipfile.rst:490 msgid "CRC-32 of the uncompressed file." msgstr "" -#: ../src/Doc/library/zipfile.rst:493 +#: library/zipfile.rst:495 msgid "Size of the compressed data." msgstr "" -#: ../src/Doc/library/zipfile.rst:498 +#: library/zipfile.rst:500 msgid "Size of the uncompressed file." msgstr "" -#: ../src/Doc/library/zipimport.rst:3 +#: library/zipimport.rst:3 msgid ":mod:`zipimport` --- Import modules from Zip archives" msgstr "" # fae38f56702142bb9e5b358b37ae623b -#: ../src/Doc/library/zipimport.rst:12 +#: library/zipimport.rst:12 msgid "" "This module adds the ability to import Python modules (:file:`\\*.py`, :file:" "`\\*.py[co]`) and packages from ZIP-format archives. It is usually not " @@ -128269,7 +131348,7 @@ msgid "" msgstr "" # 885af494bbae4e29b1153fe4ef96a72d -#: ../src/Doc/library/zipimport.rst:18 +#: library/zipimport.rst:18 msgid "" "Typically, :data:`sys.path` is a list of directory names as strings. This " "module also allows an item of :data:`sys.path` to be a string naming a ZIP " @@ -128280,7 +131359,7 @@ msgid "" "archive." msgstr "" -#: ../src/Doc/library/zipimport.rst:25 +#: library/zipimport.rst:25 msgid "" "Any files may be present in the ZIP archive, but only files :file:`.py` and :" "file:`.py[co]` are available for import. ZIP import of dynamic modules (:" @@ -128292,57 +131371,55 @@ msgid "" msgstr "" # ba6b785b67d243b9a030f7ad61261cec -#: ../src/Doc/library/zipimport.rst:32 +#: library/zipimport.rst:32 msgid "" "Using the built-in :func:`reload` function will fail if called on a module " "loaded from a ZIP archive; it is unlikely that :func:`reload` would be " "needed, since this would imply that the ZIP has been altered during runtime." msgstr "" -#: ../src/Doc/library/zipimport.rst:36 +#: library/zipimport.rst:36 msgid "ZIP archives with an archive comment are currently not supported." msgstr "" -# ddbb2e1916144487912b22acc62fb367 -#: ../src/Doc/library/zipimport.rst:46 -msgid ":pep:`273` - Import Modules from Zip Archives" +#: library/zipimport.rst:47 +msgid "PEP 273 - Import Modules from Zip Archives" msgstr "" -#: ../src/Doc/library/zipimport.rst:45 +#: library/zipimport.rst:45 msgid "" "Written by James C. Ahlstrom, who also provided an implementation. Python " "2.3 follows the specification in PEP 273, but uses an implementation written " "by Just van Rossum that uses the import hooks described in PEP 302." msgstr "" -# 3f56162a39794b46a958e144b2a3600c -#: ../src/Doc/library/zipimport.rst:48 -msgid ":pep:`302` - New Import Hooks" +#: library/zipimport.rst:49 +msgid "PEP 302 - New Import Hooks" msgstr "" -#: ../src/Doc/library/zipimport.rst:50 +#: library/zipimport.rst:50 msgid "The PEP to add the import hooks that help this module work." msgstr "" -#: ../src/Doc/library/zipimport.rst:53 +#: library/zipimport.rst:53 msgid "This module defines an exception:" msgstr "" -#: ../src/Doc/library/zipimport.rst:57 +#: library/zipimport.rst:57 msgid "" "Exception raised by zipimporter objects. It's a subclass of :exc:" "`ImportError`, so it can be caught as :exc:`ImportError`, too." msgstr "" -#: ../src/Doc/library/zipimport.rst:64 +#: library/zipimport.rst:64 msgid "zipimporter Objects" msgstr "" -#: ../src/Doc/library/zipimport.rst:66 +#: library/zipimport.rst:66 msgid ":class:`zipimporter` is the class for importing ZIP files." msgstr "" -#: ../src/Doc/library/zipimport.rst:70 +#: library/zipimport.rst:70 msgid "" "Create a new zipimporter instance. *archivepath* must be a path to a ZIP " "file, or to a specific path within a ZIP file. For example, an " @@ -128351,13 +131428,13 @@ msgid "" "exists)." msgstr "" -#: ../src/Doc/library/zipimport.rst:75 +#: library/zipimport.rst:75 msgid "" ":exc:`ZipImportError` is raised if *archivepath* doesn't point to a valid " "ZIP archive." msgstr "" -#: ../src/Doc/library/zipimport.rst:80 +#: library/zipimport.rst:80 msgid "" "Search for a module specified by *fullname*. *fullname* must be the fully " "qualified (dotted) module name. It returns the zipimporter instance itself " @@ -128366,25 +131443,25 @@ msgid "" "protocol." msgstr "" -#: ../src/Doc/library/zipimport.rst:89 +#: library/zipimport.rst:89 msgid "" "Return the code object for the specified module. Raise :exc:`ZipImportError` " "if the module couldn't be found." msgstr "" -#: ../src/Doc/library/zipimport.rst:95 +#: library/zipimport.rst:95 msgid "" "Return the data associated with *pathname*. Raise :exc:`IOError` if the file " "wasn't found." msgstr "" -#: ../src/Doc/library/zipimport.rst:101 +#: library/zipimport.rst:101 msgid "" "Return the value ``__file__`` would be set to if the specified module was " "imported. Raise :exc:`ZipImportError` if the module couldn't be found." msgstr "" -#: ../src/Doc/library/zipimport.rst:110 +#: library/zipimport.rst:110 msgid "" "Return the source code for the specified module. Raise :exc:`ZipImportError` " "if the module couldn't be found, return :const:`None` if the archive does " @@ -128392,49 +131469,49 @@ msgid "" msgstr "" # b406a26ad0804b388f69437de495d471 -#: ../src/Doc/library/zipimport.rst:118 +#: library/zipimport.rst:118 msgid "" "Return ``True`` if the module specified by *fullname* is a package. Raise :" "exc:`ZipImportError` if the module couldn't be found." msgstr "" -#: ../src/Doc/library/zipimport.rst:124 +#: library/zipimport.rst:124 msgid "" "Load the module specified by *fullname*. *fullname* must be the fully " "qualified (dotted) module name. It returns the imported module, or raises :" "exc:`ZipImportError` if it wasn't found." msgstr "" -#: ../src/Doc/library/zipimport.rst:131 +#: library/zipimport.rst:131 msgid "" "The file name of the importer's associated ZIP file, without a possible " "subpath." msgstr "" -#: ../src/Doc/library/zipimport.rst:137 +#: library/zipimport.rst:137 msgid "" "The subpath within the ZIP file where modules are searched. This is the " "empty string for zipimporter objects which point to the root of the ZIP file." msgstr "" -#: ../src/Doc/library/zipimport.rst:141 +#: library/zipimport.rst:141 msgid "" "The :attr:`archive` and :attr:`prefix` attributes, when combined with a " "slash, equal the original *archivepath* argument given to the :class:" "`zipimporter` constructor." msgstr "" -#: ../src/Doc/library/zipimport.rst:151 +#: library/zipimport.rst:151 msgid "" "Here is an example that imports a module from a ZIP archive - note that the :" "mod:`zipimport` module is not explicitly used. ::" msgstr "" -#: ../src/Doc/library/zlib.rst:3 +#: library/zlib.rst:3 msgid ":mod:`zlib` --- Compression compatible with :program:`gzip`" msgstr "" -#: ../src/Doc/library/zlib.rst:10 +#: library/zlib.rst:10 msgid "" "For applications that require data compression, the functions in this module " "allow compression and decompression, using the zlib library. The zlib " @@ -128444,7 +131521,7 @@ msgid "" "using 1.1.4 or later." msgstr "" -#: ../src/Doc/library/zlib.rst:17 +#: library/zlib.rst:17 msgid "" "zlib's functions have many options and often need to be used in a particular " "order. This documentation doesn't attempt to cover all of the permutations; " @@ -128453,21 +131530,21 @@ msgid "" msgstr "" # 4d890163202240c4bc9fb9524d984b57 -#: ../src/Doc/library/zlib.rst:22 +#: library/zlib.rst:22 msgid "For reading and writing ``.gz`` files see the :mod:`gzip` module." msgstr "" -#: ../src/Doc/library/zlib.rst:24 +#: library/zlib.rst:24 msgid "The available exception and functions in this module are:" msgstr "" -#: ../src/Doc/library/zlib.rst:29 +#: library/zlib.rst:29 msgid "Exception raised on compression and decompression errors." msgstr "" -#: ../src/Doc/library/zlib.rst:34 +#: library/zlib.rst:34 msgid "" -"Computes a Adler-32 checksum of *data*. (An Adler-32 checksum is almost as " +"Computes an Adler-32 checksum of *data*. (An Adler-32 checksum is almost as " "reliable as a CRC32 but can be computed much more quickly.) If *value* is " "present, it is used as the starting value of the checksum; otherwise, a " "fixed default value is used. This allows computing a running checksum over " @@ -128479,11 +131556,11 @@ msgstr "" # e8b2842a7d4a401f9708e39f7c955e13 # b8888bd988224dcd8cb40979955a87f0 -#: ../src/Doc/library/zlib.rst:43 ../src/Doc/library/zlib.rst:109 +#: library/zlib.rst:43 library/zlib.rst:109 msgid "This function always returns an integer object." msgstr "" -#: ../src/Doc/library/zlib.rst:46 +#: library/zlib.rst:46 msgid "" "To generate the same numeric value across all Python versions and platforms " "use adler32(data) & 0xffffffff. If you are only using the checksum in " @@ -128491,8 +131568,15 @@ msgid "" "correct 32bit binary representation regardless of sign." msgstr "" +#: library/zlib.rst:52 +msgid "" +"The return value is in the range [-2**31, 2**31-1] regardless of platform. " +"In older versions the value is signed on some platforms and unsigned on " +"others." +msgstr "" + # 2f488032ed0441d29b0ec609d2661c38 -#: ../src/Doc/library/zlib.rst:64 +#: library/zlib.rst:64 msgid "" "Compresses the data in *string*, returning a string contained compressed " "data. *level* is an integer from ``0`` to ``9`` controlling the level of " @@ -128502,7 +131586,7 @@ msgid "" msgstr "" # 9cb449fe4e634c929ba47ebf8a93553a -#: ../src/Doc/library/zlib.rst:73 +#: library/zlib.rst:73 msgid "" "Returns a compression object, to be used for compressing data streams that " "won't fit into memory at once. *level* is an integer from ``0`` to ``9`` " @@ -128512,14 +131596,14 @@ msgid "" msgstr "" # 96b9353d00a749e69771260beba95548 -#: ../src/Doc/library/zlib.rst:79 +#: library/zlib.rst:79 msgid "" "*method* is the compression algorithm. Currently, the only supported value " "is ``DEFLATED``." msgstr "" # 6c880991f573498b8b1cfd3a926f8380 -#: ../src/Doc/library/zlib.rst:82 +#: library/zlib.rst:82 msgid "" "*wbits* is the base two logarithm of the size of the window buffer. This " "should be an integer from ``8`` to ``15``. Higher values give better " @@ -128527,7 +131611,7 @@ msgid "" msgstr "" # 70720658f1c14393ba5b57a1869bb968 -#: ../src/Doc/library/zlib.rst:86 +#: library/zlib.rst:86 msgid "" "*memlevel* controls the amount of memory used for internal compression " "state. Valid values range from ``1`` to ``9``. Higher values using more " @@ -128535,14 +131619,14 @@ msgid "" msgstr "" # c512b9e0997c484ab645f2a5f55ee01b -#: ../src/Doc/library/zlib.rst:90 +#: library/zlib.rst:90 msgid "" "*strategy* is used to tune the compression algorithm. Possible values are " "``Z_DEFAULT_STRATEGY``, ``Z_FILTERED``, and ``Z_HUFFMAN_ONLY``. The default " "is ``Z_DEFAULT_STRATEGY``." msgstr "" -#: ../src/Doc/library/zlib.rst:101 +#: library/zlib.rst:101 msgid "" "Computes a CRC (Cyclic Redundancy Check) checksum of *data*. If *value* is " "present, it is used as the starting value of the checksum; otherwise, a " @@ -128553,7 +131637,14 @@ msgid "" "suitable for use as a general hash algorithm." msgstr "" -#: ../src/Doc/library/zlib.rst:130 +#: library/zlib.rst:118 +msgid "" +"The return value is in the range [-2**31, 2**31-1] regardless of platform. " +"In older versions the value would be signed on some platforms and unsigned " +"on others." +msgstr "" + +#: library/zlib.rst:130 msgid "" "Decompresses the data in *string*, returning a string containing the " "uncompressed data. The *wbits* parameter controls the size of the window " @@ -128562,7 +131653,7 @@ msgid "" "any error occurs." msgstr "" -#: ../src/Doc/library/zlib.rst:136 +#: library/zlib.rst:136 msgid "" "The absolute value of *wbits* is the base two logarithm of the size of the " "history buffer (the \"window size\") used when compressing data. Its " @@ -128576,7 +131667,7 @@ msgid "" msgstr "" # ac7e716e55384c7f9bc83b6aa5fac4a7 -#: ../src/Doc/library/zlib.rst:146 +#: library/zlib.rst:146 msgid "" "*bufsize* is the initial size of the buffer used to hold decompressed data. " "If more space is required, the buffer size will be increased as needed, so " @@ -128584,18 +131675,18 @@ msgid "" "few calls to :c:func:`malloc`. The default size is 16384." msgstr "" -#: ../src/Doc/library/zlib.rst:154 +#: library/zlib.rst:154 msgid "" "Returns a decompression object, to be used for decompressing data streams " "that won't fit into memory at once. The *wbits* parameter controls the size " "of the window buffer." msgstr "" -#: ../src/Doc/library/zlib.rst:158 +#: library/zlib.rst:158 msgid "Compression objects support the following methods:" msgstr "" -#: ../src/Doc/library/zlib.rst:163 +#: library/zlib.rst:163 msgid "" "Compress *string*, returning a string containing compressed data for at " "least part of the data in *string*. This data should be concatenated to the " @@ -128603,7 +131694,7 @@ msgid "" "input may be kept in internal buffers for later processing." msgstr "" -#: ../src/Doc/library/zlib.rst:171 +#: library/zlib.rst:171 msgid "" "All pending input is processed, and a string containing the remaining " "compressed output is returned. *mode* can be selected from the constants :" @@ -128616,18 +131707,18 @@ msgid "" "action is to delete the object." msgstr "" -#: ../src/Doc/library/zlib.rst:184 +#: library/zlib.rst:184 msgid "" "Returns a copy of the compression object. This can be used to efficiently " "compress a set of data that share a common initial prefix." msgstr "" -#: ../src/Doc/library/zlib.rst:189 +#: library/zlib.rst:189 msgid "" "Decompression objects support the following methods, and two attributes:" msgstr "" -#: ../src/Doc/library/zlib.rst:194 +#: library/zlib.rst:194 msgid "" "A string which contains any bytes past the end of the compressed data. That " "is, this remains ``\"\"`` until the last byte that contains compression data " @@ -128635,7 +131726,7 @@ msgid "" "this is ``\"\"``, the empty string." msgstr "" -#: ../src/Doc/library/zlib.rst:199 +#: library/zlib.rst:199 msgid "" "The only way to determine where a string of compressed data ends is by " "actually decompressing it. This means that when compressed data is " @@ -128645,7 +131736,7 @@ msgid "" "is no longer the empty string." msgstr "" -#: ../src/Doc/library/zlib.rst:209 +#: library/zlib.rst:209 msgid "" "A string that contains any data that was not consumed by the last :meth:" "`decompress` call because it exceeded the limit for the uncompressed data " @@ -128654,7 +131745,7 @@ msgid "" "subsequent :meth:`decompress` method call in order to get correct output." msgstr "" -#: ../src/Doc/library/zlib.rst:218 +#: library/zlib.rst:218 msgid "" "Decompress *string*, returning a string containing the uncompressed data " "corresponding to at least part of the data in *string*. This data should be " @@ -128663,9 +131754,9 @@ msgid "" "buffers for later processing." msgstr "" -#: ../src/Doc/library/zlib.rst:224 +#: library/zlib.rst:224 msgid "" -"If the optional parameter *max_length* is supplied then the return value " +"If the optional parameter *max_length* is non-zero then the return value " "will be no longer than *max_length*. This may mean that not all of the " "compressed input can be processed; and unconsumed data will be stored in the " "attribute :attr:`unconsumed_tail`. This string must be passed to a " @@ -128674,7 +131765,7 @@ msgid "" "`unconsumed_tail` is an empty string." msgstr "" -#: ../src/Doc/library/zlib.rst:235 +#: library/zlib.rst:235 msgid "" "All pending input is processed, and a string containing the remaining " "uncompressed output is returned. After calling :meth:`flush`, the :meth:" @@ -128682,47 +131773,51 @@ msgid "" "delete the object." msgstr "" -#: ../src/Doc/library/zlib.rst:240 +#: library/zlib.rst:240 msgid "" "The optional parameter *length* sets the initial size of the output buffer." msgstr "" -#: ../src/Doc/library/zlib.rst:245 +#: library/zlib.rst:245 msgid "" "Returns a copy of the decompression object. This can be used to save the " "state of the decompressor midway through the data stream in order to speed " "up random seeks into the stream at a future point." msgstr "" -# 30c19c32ba964d12807b7a7b6afeddcb -#: ../src/Doc/library/zlib.rst:254 -msgid "Module :mod:`gzip`" -msgstr "" +#: library/zlib.rst:255 +#, fuzzy +msgid "Module gzip" +msgstr "Modules" -#: ../src/Doc/library/zlib.rst:255 +#: library/zlib.rst:255 msgid "Reading and writing :program:`gzip`\\ -format files." msgstr "" # ee390c72b8894323a3f609f0a227c67c -#: ../src/Doc/library/zlib.rst:257 +#: library/zlib.rst:258 msgid "http://www.zlib.net" msgstr "" -#: ../src/Doc/library/zlib.rst:258 +#: library/zlib.rst:258 msgid "The zlib library home page." msgstr "" # 19e88a557a284c908ea55e5f514e95f3 -#: ../src/Doc/library/zlib.rst:260 +#: library/zlib.rst:261 msgid "http://www.zlib.net/manual.html" msgstr "" -#: ../src/Doc/library/zlib.rst:261 +#: library/zlib.rst:261 msgid "" "The zlib manual explains the semantics and usage of the library's many " "functions." msgstr "" +# 28893d70cf3e45eab810c679c6530a44 +#~ msgid "Strings" +#~ msgstr "Les chaînes de caractères" + #~ msgid "" #~ "def greet(name): print \"Hello, {0}!\".format(name) print \"What's " #~ "your name?\" name = raw_input() greet(name)" diff --git a/license.po b/license.po index 9f586e4f..48222035 100644 --- a/license.po +++ b/license.po @@ -7,25 +7,25 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/license.rst:7 +#: license.rst:7 msgid "History and License" msgstr "Histoire et Licence" -#: ../src/Doc/license.rst:11 +#: license.rst:11 msgid "History of the software" msgstr "Histoire du logiciel" -#: ../src/Doc/license.rst:13 +#: license.rst:13 msgid "" "Python was created in the early 1990s by Guido van Rossum at Stichting " "Mathematisch Centrum (CWI, see http://www.cwi.nl/) in the Netherlands as a " @@ -38,7 +38,7 @@ msgstr "" "Python, bien qu'il inclut de nombreuses contributions de la part d'autres " "personnes." -#: ../src/Doc/license.rst:18 +#: license.rst:18 msgid "" "In 1995, Guido continued his work on Python at the Corporation for National " "Research Initiatives (CNRI, see http://www.cnri.reston.va.us/) in Reston, " @@ -48,7 +48,7 @@ msgstr "" "Research Initiatives (CNRI, voir http://www.cnri.reston.va.us/) de Reston, " "en Viriginie, d'où il diffusa plusieurs versions du logiciel." -#: ../src/Doc/license.rst:22 +#: license.rst:22 #, fuzzy msgid "" "In May 2000, Guido and the Python core development team moved to BeOpen.com " @@ -67,7 +67,7 @@ msgstr "" "s'agit d'une organisation à but non lucratif détenant les droits de " "propriété intellectuelle de Python. Zope Corporation en est un sponsor." -#: ../src/Doc/license.rst:30 +#: license.rst:30 #, fuzzy msgid "" "All Python releases are Open Source (see http://opensource.org/ for the Open " @@ -79,156 +79,148 @@ msgstr "" "toutes, des versions de Python ont également été compatible avec la GPL, le " "tableau ci-dessous résume les différentes versions." -#: ../src/Doc/license.rst:35 +#: license.rst:35 msgid "Release" msgstr "Version" -#: ../src/Doc/license.rst:35 +#: license.rst:35 msgid "Derived from" msgstr "Dérivé de" -#: ../src/Doc/license.rst:35 +#: license.rst:35 msgid "Year" msgstr "Année" -#: ../src/Doc/license.rst:35 +#: license.rst:35 msgid "Owner" msgstr "Propriétaire" -#: ../src/Doc/license.rst:35 +#: license.rst:35 #, fuzzy msgid "GPL compatible?" msgstr "Compatible avec la GPL ?" -#: ../src/Doc/license.rst:37 +#: license.rst:37 #, fuzzy msgid "0.9.0 thru 1.2" msgstr "0.9.0 à 1.2" -#: ../src/Doc/license.rst:37 +#: license.rst:37 #, fuzzy msgid "n/a" msgstr "n/a" -#: ../src/Doc/license.rst:37 +#: license.rst:37 msgid "1991-1995" msgstr "1991-1995" -#: ../src/Doc/license.rst:37 +#: license.rst:37 msgid "CWI" msgstr "CWI" -#: ../src/Doc/license.rst:37 ../src/Doc/license.rst:39 -#: ../src/Doc/license.rst:49 ../src/Doc/license.rst:51 -#: ../src/Doc/license.rst:53 ../src/Doc/license.rst:55 -#: ../src/Doc/license.rst:57 +#: license.rst:37 license.rst:39 license.rst:49 license.rst:51 license.rst:53 +#: license.rst:55 license.rst:57 #, fuzzy msgid "yes" msgstr "oui" -#: ../src/Doc/license.rst:39 +#: license.rst:39 #, fuzzy msgid "1.3 thru 1.5.2" msgstr "1.3 à 1.5.2" -#: ../src/Doc/license.rst:39 +#: license.rst:39 msgid "1.2" msgstr "1.2" -#: ../src/Doc/license.rst:39 +#: license.rst:39 msgid "1995-1999" msgstr "1995-1999" -#: ../src/Doc/license.rst:39 ../src/Doc/license.rst:41 -#: ../src/Doc/license.rst:45 +#: license.rst:39 license.rst:41 license.rst:45 msgid "CNRI" msgstr "CNRI" -#: ../src/Doc/license.rst:41 ../src/Doc/license.rst:43 -#: ../src/Doc/license.rst:45 +#: license.rst:41 license.rst:43 license.rst:45 msgid "1.6" msgstr "1.6" -#: ../src/Doc/license.rst:41 +#: license.rst:41 msgid "1.5.2" msgstr "1.5.2" -#: ../src/Doc/license.rst:41 ../src/Doc/license.rst:43 +#: license.rst:41 license.rst:43 msgid "2000" msgstr "2000" -#: ../src/Doc/license.rst:41 ../src/Doc/license.rst:43 -#: ../src/Doc/license.rst:45 ../src/Doc/license.rst:47 +#: license.rst:41 license.rst:43 license.rst:45 license.rst:47 msgid "no" msgstr "non" -#: ../src/Doc/license.rst:43 +#: license.rst:43 msgid "2.0" msgstr "2.0" -#: ../src/Doc/license.rst:43 +#: license.rst:43 msgid "BeOpen.com" msgstr "BeOpen.com" -#: ../src/Doc/license.rst:45 +#: license.rst:45 msgid "1.6.1" msgstr "1.6.1" -#: ../src/Doc/license.rst:45 ../src/Doc/license.rst:47 -#: ../src/Doc/license.rst:49 ../src/Doc/license.rst:51 +#: license.rst:45 license.rst:47 license.rst:49 license.rst:51 msgid "2001" msgstr "2001" -#: ../src/Doc/license.rst:47 +#: license.rst:47 msgid "2.1" msgstr "2.1" -#: ../src/Doc/license.rst:47 ../src/Doc/license.rst:49 +#: license.rst:47 license.rst:49 msgid "2.0+1.6.1" msgstr "2.0+1.6.1" -#: ../src/Doc/license.rst:47 ../src/Doc/license.rst:49 -#: ../src/Doc/license.rst:51 ../src/Doc/license.rst:53 -#: ../src/Doc/license.rst:55 ../src/Doc/license.rst:57 +#: license.rst:47 license.rst:49 license.rst:51 license.rst:53 license.rst:55 +#: license.rst:57 msgid "PSF" msgstr "PSF" -#: ../src/Doc/license.rst:49 +#: license.rst:49 msgid "2.0.1" msgstr "2.0.1" -#: ../src/Doc/license.rst:51 ../src/Doc/license.rst:53 -#: ../src/Doc/license.rst:57 +#: license.rst:51 license.rst:53 license.rst:57 msgid "2.1.1" msgstr "2.1.1" -#: ../src/Doc/license.rst:51 +#: license.rst:51 msgid "2.1+2.0.1" msgstr "2.1+2.0.1" -#: ../src/Doc/license.rst:53 ../src/Doc/license.rst:55 +#: license.rst:53 license.rst:55 msgid "2.1.2" msgstr "2.1.2" -#: ../src/Doc/license.rst:53 ../src/Doc/license.rst:55 +#: license.rst:53 license.rst:55 msgid "2002" msgstr "2002" -#: ../src/Doc/license.rst:55 +#: license.rst:55 msgid "2.1.3" msgstr "2.1.3" # d7f155d50c9843a9b972ebbf4c28b034 -#: ../src/Doc/license.rst:57 +#: license.rst:57 msgid "2.2 and above" msgstr "" -#: ../src/Doc/license.rst:57 +#: license.rst:57 #, fuzzy msgid "2001-now" msgstr "2001" -#: ../src/Doc/license.rst:62 +#: license.rst:62 msgid "" "GPL-compatible doesn't mean that we're distributing Python under the GPL. " "All Python licenses, unlike the GPL, let you distribute a modified version " @@ -243,7 +235,7 @@ msgstr "" "autre logiciel qui est lui, diffusé sous la licence GPL; les licences \"non " "compatible GPL\" ne le peuvent pas." -#: ../src/Doc/license.rst:68 +#: license.rst:68 #, fuzzy msgid "" "Thanks to the many outside volunteers who have worked under Guido's " @@ -252,11 +244,15 @@ msgstr "" "Merci aux nombreux bénévoles qui ont travaillé sous la direction de Guido " "pour rendre ces versions possibles." -#: ../src/Doc/license.rst:73 +#: license.rst:73 msgid "Terms and conditions for accessing or otherwise using Python" msgstr "" -#: ../src/Doc/license.rst:78 +#: license.rst:77 +msgid "PSF LICENSE AGREEMENT FOR PYTHON release" +msgstr "" + +#: license.rst:78 msgid "" "This LICENSE AGREEMENT is between the Python Software Foundation (\"PSF\"), " "and the Individual or Organization (\"Licensee\") accessing and otherwise " @@ -264,20 +260,19 @@ msgid "" "documentation." msgstr "" -# 5a36a2ec1b2f43d4ad43db690702496e -#: ../src/Doc/license.rst:82 +#: license.rst:82 msgid "" "Subject to the terms and conditions of this License Agreement, PSF hereby " "grants Licensee a nonexclusive, royalty-free, world-wide license to " "reproduce, analyze, test, perform and/or display publicly, prepare " "derivative works, distribute, and otherwise use Python |release| alone or in " "any derivative version, provided, however, that PSF's License Agreement and " -"PSF's notice of copyright, i.e., \"Copyright © 2001-2014 Python Software " +"PSF's notice of copyright, i.e., \"Copyright © 2001-2015 Python Software " "Foundation; All Rights Reserved\" are retained in Python |release| alone or " "in any derivative version prepared by Licensee." msgstr "" -#: ../src/Doc/license.rst:91 +#: license.rst:91 msgid "" "In the event Licensee prepares a derivative work that is based on or " "incorporates Python |release| or any part thereof, and wants to make the " @@ -286,7 +281,7 @@ msgid "" "Python |release|." msgstr "" -#: ../src/Doc/license.rst:97 +#: license.rst:97 msgid "" "PSF is making Python |release| available to Licensee on an \"AS IS\" basis. " "PSF MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF " @@ -295,7 +290,7 @@ msgid "" "THE USE OF PYTHON |release| WILL NOT INFRINGE ANY THIRD PARTY RIGHTS." msgstr "" -#: ../src/Doc/license.rst:103 +#: license.rst:103 msgid "" "PSF SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON |release| " "FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF " @@ -303,14 +298,13 @@ msgid "" "DERIVATIVE THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF." msgstr "" -#: ../src/Doc/license.rst:108 ../src/Doc/license.rst:149 -#: ../src/Doc/license.rst:205 +#: license.rst:108 license.rst:149 license.rst:205 msgid "" "This License Agreement will automatically terminate upon a material breach " "of its terms and conditions." msgstr "" -#: ../src/Doc/license.rst:111 +#: license.rst:111 msgid "" "Nothing in this License Agreement shall be deemed to create any relationship " "of agency, partnership, or joint venture between PSF and Licensee. This " @@ -319,13 +313,21 @@ msgid "" "Licensee, or any third party." msgstr "" -#: ../src/Doc/license.rst:117 +#: license.rst:117 msgid "" "By copying, installing or otherwise using Python |release|, Licensee agrees " "to be bound by the terms and conditions of this License Agreement." msgstr "" -#: ../src/Doc/license.rst:126 +#: license.rst:123 +msgid "BEOPEN.COM LICENSE AGREEMENT FOR PYTHON 2.0" +msgstr "" + +#: license.rst:125 +msgid "BEOPEN PYTHON OPEN SOURCE LICENSE AGREEMENT VERSION 1" +msgstr "" + +#: license.rst:126 msgid "" "This LICENSE AGREEMENT is between BeOpen.com (\"BeOpen\"), having an office " "at 160 Saratoga Avenue, Santa Clara, CA 95051, and the Individual or " @@ -333,7 +335,7 @@ msgid "" "source or binary form and its associated documentation (\"the Software\")." msgstr "" -#: ../src/Doc/license.rst:131 +#: license.rst:131 msgid "" "Subject to the terms and conditions of this BeOpen Python License Agreement, " "BeOpen hereby grants Licensee a non-exclusive, royalty-free, world-wide " @@ -344,7 +346,7 @@ msgid "" "prepared by Licensee." msgstr "" -#: ../src/Doc/license.rst:138 +#: license.rst:138 msgid "" "BeOpen is making the Software available to Licensee on an \"AS IS\" basis. " "BEOPEN MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY " @@ -354,7 +356,7 @@ msgid "" "RIGHTS." msgstr "" -#: ../src/Doc/license.rst:144 +#: license.rst:144 msgid "" "BEOPEN SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF THE SOFTWARE " "FOR ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF " @@ -362,7 +364,7 @@ msgid "" "EVEN IF ADVISED OF THE POSSIBILITY THEREOF." msgstr "" -#: ../src/Doc/license.rst:152 +#: license.rst:152 msgid "" "This License Agreement shall be governed by and interpreted in all respects " "by the law of the State of California, excluding conflict of law provisions. " @@ -375,13 +377,17 @@ msgid "" "according to the permissions granted on that web page." msgstr "" -#: ../src/Doc/license.rst:162 +#: license.rst:162 msgid "" "By copying, installing or otherwise using the software, Licensee agrees to " "be bound by the terms and conditions of this License Agreement." msgstr "" -#: ../src/Doc/license.rst:168 +#: license.rst:167 +msgid "CNRI LICENSE AGREEMENT FOR PYTHON 1.6.1" +msgstr "" + +#: license.rst:168 msgid "" "This LICENSE AGREEMENT is between the Corporation for National Research " "Initiatives, having an office at 1895 Preston White Drive, Reston, VA 20191 " @@ -390,7 +396,7 @@ msgid "" "associated documentation." msgstr "" -#: ../src/Doc/license.rst:174 +#: license.rst:174 msgid "" "Subject to the terms and conditions of this License Agreement, CNRI hereby " "grants Licensee a nonexclusive, royalty-free, world-wide license to " @@ -409,7 +415,7 @@ msgid "" "URL: http://hdl.handle.net/1895.22/1013.\"" msgstr "" -#: ../src/Doc/license.rst:189 +#: license.rst:189 msgid "" "In the event Licensee prepares a derivative work that is based on or " "incorporates Python 1.6.1 or any part thereof, and wants to make the " @@ -418,7 +424,7 @@ msgid "" "Python 1.6.1." msgstr "" -#: ../src/Doc/license.rst:194 +#: license.rst:194 msgid "" "CNRI is making Python 1.6.1 available to Licensee on an \"AS IS\" basis. " "CNRI MAKES NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED. BY WAY OF " @@ -427,7 +433,7 @@ msgid "" "THE USE OF PYTHON 1.6.1 WILL NOT INFRINGE ANY THIRD PARTY RIGHTS." msgstr "" -#: ../src/Doc/license.rst:200 +#: license.rst:200 msgid "" "CNRI SHALL NOT BE LIABLE TO LICENSEE OR ANY OTHER USERS OF PYTHON 1.6.1 FOR " "ANY INCIDENTAL, SPECIAL, OR CONSEQUENTIAL DAMAGES OR LOSS AS A RESULT OF " @@ -435,7 +441,7 @@ msgid "" "THEREOF, EVEN IF ADVISED OF THE POSSIBILITY THEREOF." msgstr "" -#: ../src/Doc/license.rst:208 +#: license.rst:208 msgid "" "This License Agreement shall be governed by the federal intellectual " "property law of the United States, including without limitation the federal " @@ -453,20 +459,28 @@ msgid "" "products or services of Licensee, or any third party." msgstr "" -#: ../src/Doc/license.rst:223 +#: license.rst:223 msgid "" "By clicking on the \"ACCEPT\" button where indicated, or by copying, " "installing or otherwise using Python 1.6.1, Licensee agrees to be bound by " "the terms and conditions of this License Agreement." msgstr "" -#: ../src/Doc/license.rst:233 +#: license.rst:230 +msgid "ACCEPT" +msgstr "" + +#: license.rst:232 +msgid "CWI LICENSE AGREEMENT FOR PYTHON 0.9.0 THROUGH 1.2" +msgstr "" + +#: license.rst:233 msgid "" "Copyright © 1991 - 1995, Stichting Mathematisch Centrum Amsterdam, The " "Netherlands. All rights reserved." msgstr "" -#: ../src/Doc/license.rst:236 +#: license.rst:236 msgid "" "Permission to use, copy, modify, and distribute this software and its " "documentation for any purpose and without fee is hereby granted, provided " @@ -477,7 +491,7 @@ msgid "" "software without specific, written prior permission." msgstr "" -#: ../src/Doc/license.rst:244 +#: license.rst:244 msgid "" "STICHTING MATHEMATISCH CENTRUM DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS " "SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, " @@ -488,126 +502,126 @@ msgid "" "PERFORMANCE OF THIS SOFTWARE." msgstr "" -#: ../src/Doc/license.rst:254 +#: license.rst:254 msgid "Licenses and Acknowledgements for Incorporated Software" msgstr "" -#: ../src/Doc/license.rst:256 +#: license.rst:256 msgid "" "This section is an incomplete, but growing list of licenses and " "acknowledgements for third-party software incorporated in the Python " "distribution." msgstr "" -#: ../src/Doc/license.rst:261 +#: license.rst:261 msgid "Mersenne Twister" msgstr "" # fbf1b3f6f8a0432ebd6e7974eb4e7af1 -#: ../src/Doc/license.rst:263 +#: license.rst:263 msgid "" "The :mod:`_random` module includes code based on a download from http://www." "math.sci.hiroshima-u.ac.jp/~m-mat/MT/MT2002/emt19937ar.html. The following " "are the verbatim comments from the original code::" msgstr "" -#: ../src/Doc/license.rst:310 +#: license.rst:310 msgid "Sockets" msgstr "" -#: ../src/Doc/license.rst:312 +#: license.rst:312 msgid "" "The :mod:`socket` module uses the functions, :func:`getaddrinfo`, and :func:" "`getnameinfo`, which are coded in separate source files from the WIDE " "Project, http://www.wide.ad.jp/. ::" msgstr "" -#: ../src/Doc/license.rst:345 +#: license.rst:345 msgid "Floating point exception control" msgstr "" -#: ../src/Doc/license.rst:347 +#: license.rst:347 msgid "The source for the :mod:`fpectl` module includes the following notice::" msgstr "" # e126b6593e3346cdbd89fc77888c00df -#: ../src/Doc/license.rst:387 +#: license.rst:387 msgid "MD5 message digest algorithm" msgstr "" # 9f484bd7cb294985b3fb849f3b53fbb4 -#: ../src/Doc/license.rst:389 +#: license.rst:389 msgid "" "The source code for the :mod:`md5` module contains the following notice::" msgstr "" -#: ../src/Doc/license.rst:437 +#: license.rst:437 msgid "Asynchronous socket services" msgstr "" -#: ../src/Doc/license.rst:439 +#: license.rst:439 msgid "" "The :mod:`asynchat` and :mod:`asyncore` modules contain the following " "notice::" msgstr "" -#: ../src/Doc/license.rst:464 +#: license.rst:464 msgid "Cookie management" msgstr "" # dc73cc23af584fc4b693e2d68143e152 -#: ../src/Doc/license.rst:466 +#: license.rst:466 msgid "The :mod:`Cookie` module contains the following notice::" msgstr "" -#: ../src/Doc/license.rst:492 +#: license.rst:492 msgid "Execution tracing" msgstr "" -#: ../src/Doc/license.rst:494 +#: license.rst:494 msgid "The :mod:`trace` module contains the following notice::" msgstr "" -#: ../src/Doc/license.rst:525 +#: license.rst:525 msgid "UUencode and UUdecode functions" msgstr "" -#: ../src/Doc/license.rst:527 +#: license.rst:527 msgid "The :mod:`uu` module contains the following notice::" msgstr "" -#: ../src/Doc/license.rst:555 +#: license.rst:555 msgid "XML Remote Procedure Calls" msgstr "" # 908bfa552b92416b9ab4a7b264f95e2a -#: ../src/Doc/license.rst:557 +#: license.rst:557 msgid "The :mod:`xmlrpclib` module contains the following notice::" msgstr "" -#: ../src/Doc/license.rst:588 +#: license.rst:588 msgid "test_epoll" msgstr "" -#: ../src/Doc/license.rst:590 +#: license.rst:590 msgid "The :mod:`test_epoll` contains the following notice::" msgstr "" -#: ../src/Doc/license.rst:614 +#: license.rst:614 msgid "Select kqueue" msgstr "" -#: ../src/Doc/license.rst:616 +#: license.rst:616 msgid "" "The :mod:`select` and contains the following notice for the kqueue " "interface::" msgstr "" -#: ../src/Doc/license.rst:644 +#: license.rst:644 msgid "strtod and dtoa" msgstr "" -#: ../src/Doc/license.rst:646 +#: license.rst:646 msgid "" "The file :file:`Python/dtoa.c`, which supplies C functions dtoa and strtod " "for conversion of C doubles to and from strings, is derived from the file of " @@ -617,50 +631,50 @@ msgid "" msgstr "" # 4f91680c5c404807ac02dc81ed5deacc -#: ../src/Doc/license.rst:674 +#: license.rst:674 msgid "OpenSSL" msgstr "" -# a4e3cf98978041caa59e6de7f727d44c -#: ../src/Doc/license.rst:676 +#: license.rst:676 msgid "" "The modules :mod:`hashlib`, :mod:`posix`, :mod:`ssl`, :mod:`crypt` use the " "OpenSSL library for added performance if made available by the operating " -"system. Additionally, the Windows installers for Python include a copy of " -"the OpenSSL libraries, so we include a copy of the OpenSSL license here::" +"system. Additionally, the Windows and Mac OS X installers for Python may " +"include a copy of the OpenSSL libraries, so we include a copy of the OpenSSL " +"license here::" msgstr "" # fdecf041f968424da39c4c6b2b3b4d17 -#: ../src/Doc/license.rst:811 +#: license.rst:811 msgid "expat" msgstr "" # 8f3a1d98481d418793e13b4474663183 -#: ../src/Doc/license.rst:813 +#: license.rst:813 msgid "" "The :mod:`pyexpat` extension is built using an included copy of the expat " "sources unless the build is configured ``--with-system-expat``::" msgstr "" # 27816b870dc442f69a442faea64ec20e -#: ../src/Doc/license.rst:840 +#: license.rst:840 msgid "libffi" msgstr "" # d39fb47aa8654d46a47d4b4c19674b86 -#: ../src/Doc/license.rst:842 +#: license.rst:842 msgid "" "The :mod:`_ctypes` extension is built using an included copy of the libffi " "sources unless the build is configured ``--with-system-libffi``::" msgstr "" # ef8cccf48fcc4f289d27db572ddbbd59 -#: ../src/Doc/license.rst:869 +#: license.rst:869 msgid "zlib" msgstr "" # a8f256df65284ce1b73f7db0a287d3ae -#: ../src/Doc/license.rst:871 +#: license.rst:871 msgid "" "The :mod:`zlib` extension is built using an included copy of the zlib " "sources if the zlib version found on the system is too old to be used for " diff --git a/reference.po b/reference.po index 9be4f432..c0ddc09b 100644 --- a/reference.po +++ b/reference.po @@ -7,21 +7,21 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/reference/compound_stmts.rst:5 +#: reference/compound_stmts.rst:5 msgid "Compound statements" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:9 +#: reference/compound_stmts.rst:9 msgid "" "Compound statements contain (groups of) other statements; they affect or " "control the execution of those other statements in some way. In general, " @@ -30,7 +30,7 @@ msgid "" msgstr "" # 9da08903f5224e81ab634a8c28aa987a -#: ../src/Doc/reference/compound_stmts.rst:14 +#: reference/compound_stmts.rst:14 msgid "" "The :keyword:`if`, :keyword:`while` and :keyword:`for` statements implement " "traditional control flow constructs. :keyword:`try` specifies exception " @@ -39,7 +39,7 @@ msgid "" msgstr "" # b6a3c204a5d047789e5903af799e6c8c -#: ../src/Doc/reference/compound_stmts.rst:23 +#: reference/compound_stmts.rst:23 msgid "" "Compound statements consist of one or more 'clauses.' A clause consists of " "a header and a 'suite.' The clause headers of a particular compound " @@ -55,19 +55,19 @@ msgid "" msgstr "" # ccfb9ce0436742f58aaa3cd78232f2cc -#: ../src/Doc/reference/compound_stmts.rst:36 +#: reference/compound_stmts.rst:36 msgid "" "Also note that the semicolon binds tighter than the colon in this context, " "so that in the following example, either all or none of the :keyword:`print` " "statements are executed::" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:42 +#: reference/compound_stmts.rst:42 msgid "Summarizing:" msgstr "" # de22862241cf46a9849e8b887d4744ee -#: ../src/Doc/reference/compound_stmts.rst:62 +#: reference/compound_stmts.rst:62 msgid "" "Note that statements always end in a ``NEWLINE`` possibly followed by a " "``DEDENT``. Also note that optional continuation clauses always begin with a " @@ -76,22 +76,22 @@ msgid "" "keyword:`if` statements to be indented)." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:68 +#: reference/compound_stmts.rst:68 msgid "" "The formatting of the grammar rules in the following sections places each " "clause on a separate line for clarity." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:77 +#: reference/compound_stmts.rst:77 #, fuzzy msgid "The :keyword:`if` statement" msgstr "L'instruction :keyword:`del`" -#: ../src/Doc/reference/compound_stmts.rst:84 +#: reference/compound_stmts.rst:84 msgid "The :keyword:`if` statement is used for conditional execution:" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:91 +#: reference/compound_stmts.rst:91 msgid "" "It selects exactly one of the suites by evaluating the expressions one by " "one until one is found to be true (see section :ref:`booleans` for the " @@ -101,17 +101,17 @@ msgid "" "is executed." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:101 +#: reference/compound_stmts.rst:101 msgid "The :keyword:`while` statement" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:108 +#: reference/compound_stmts.rst:108 msgid "" "The :keyword:`while` statement is used for repeated execution as long as an " "expression is true:" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:115 +#: reference/compound_stmts.rst:115 msgid "" "This repeatedly tests the expression and, if it is true, executes the first " "suite; if the expression is false (which may be the first time it is tested) " @@ -119,7 +119,7 @@ msgid "" "loop terminates." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:124 +#: reference/compound_stmts.rst:124 msgid "" "A :keyword:`break` statement executed in the first suite terminates the loop " "without executing the :keyword:`else` clause's suite. A :keyword:`continue` " @@ -127,18 +127,18 @@ msgid "" "back to testing the expression." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:133 +#: reference/compound_stmts.rst:133 msgid "The :keyword:`for` statement" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:143 +#: reference/compound_stmts.rst:143 msgid "" "The :keyword:`for` statement is used to iterate over the elements of a " "sequence (such as a string, tuple or list) or other iterable object:" msgstr "" # 0a43449496f5463499b48e5b2a701d20 -#: ../src/Doc/reference/compound_stmts.rst:150 +#: reference/compound_stmts.rst:150 msgid "" "The expression list is evaluated once; it should yield an iterable object. " "An iterator is created for the result of the ``expression_list``. The suite " @@ -150,7 +150,7 @@ msgid "" "and the loop terminates." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:162 +#: reference/compound_stmts.rst:162 msgid "" "A :keyword:`break` statement executed in the first suite terminates the loop " "without executing the :keyword:`else` clause's suite. A :keyword:`continue` " @@ -159,14 +159,14 @@ msgid "" "was no next item." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:168 +#: reference/compound_stmts.rst:168 msgid "" "The suite may assign to the variable(s) in the target list; this does not " "affect the next item assigned to it." msgstr "" # 11e98be08741467b95cfedc1fdba05bd -#: ../src/Doc/reference/compound_stmts.rst:175 +#: reference/compound_stmts.rst:175 msgid "" "The target list is not deleted when the loop is finished, but if the " "sequence is empty, it will not have been assigned to at all by the loop. " @@ -176,7 +176,7 @@ msgid "" msgstr "" # f2ad47f51bc043dab1852110237fdbd0 -#: ../src/Doc/reference/compound_stmts.rst:187 +#: reference/compound_stmts.rst:187 msgid "" "There is a subtlety when the sequence is being modified by the loop (this " "can only occur for mutable sequences, i.e. lists). An internal counter is " @@ -191,18 +191,25 @@ msgid "" "using a slice of the whole sequence, e.g., ::" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:208 +#: reference/compound_stmts.rst:208 msgid "The :keyword:`try` statement" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:215 +#: reference/compound_stmts.rst:215 msgid "" "The :keyword:`try` statement specifies exception handlers and/or cleanup " "code for a group of statements:" msgstr "" +#: reference/compound_stmts.rst:227 +msgid "" +"In previous versions of Python, :keyword:`try`...\\ :keyword:`except`...\\ :" +"keyword:`finally` did not work. :keyword:`try`...\\ :keyword:`except` had to " +"be nested in :keyword:`try`...\\ :keyword:`finally`." +msgstr "" + # 96e5a893bf444eceb5b797c2e3e33323 -#: ../src/Doc/reference/compound_stmts.rst:232 +#: reference/compound_stmts.rst:232 msgid "" "The :keyword:`except` clause(s) specify one or more exception handlers. When " "no exception occurs in the :keyword:`try` clause, no exception handler is " @@ -217,13 +224,13 @@ msgid "" "compatible with the exception." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:243 +#: reference/compound_stmts.rst:243 msgid "" "If no except clause matches the exception, the search for an exception " "handler continues in the surrounding code and on the invocation stack. [#]_" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:246 +#: reference/compound_stmts.rst:246 msgid "" "If the evaluation of an expression in the header of an except clause raises " "an exception, the original search for a handler is canceled and a search " @@ -233,7 +240,7 @@ msgid "" msgstr "" # 39717c7d42164afea18857c4f5eb5491 -#: ../src/Doc/reference/compound_stmts.rst:251 +#: reference/compound_stmts.rst:251 msgid "" "When a matching except clause is found, the exception is assigned to the " "target specified in that except clause, if present, and the except clause's " @@ -245,7 +252,7 @@ msgid "" msgstr "" # 93fd804eac774204aeed3602b22b3e5a -#: ../src/Doc/reference/compound_stmts.rst:266 +#: reference/compound_stmts.rst:266 msgid "" "Before an except clause's suite is executed, details about the exception are " "assigned to three variables in the :mod:`sys` module: ``sys.exc_type`` " @@ -260,7 +267,7 @@ msgid "" "call) when returning from a function that handled an exception." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:284 +#: reference/compound_stmts.rst:284 msgid "" "The optional :keyword:`else` clause is executed if and when control flows " "off the end of the :keyword:`try` clause. [#]_ Exceptions in the :keyword:" @@ -268,7 +275,7 @@ msgid "" msgstr "" # 4b2bc64af26647a2b59cd300a57e8c8c -#: ../src/Doc/reference/compound_stmts.rst:290 +#: reference/compound_stmts.rst:290 msgid "" "If :keyword:`finally` is present, it specifies a 'cleanup' handler. The :" "keyword:`try` clause is executed, including any :keyword:`except` and :" @@ -281,13 +288,13 @@ msgid "" msgstr "" # a456408e32484ed7a9360d2a980341cd -#: ../src/Doc/reference/compound_stmts.rst:308 +#: reference/compound_stmts.rst:308 msgid "" "The exception information is not available to the program during execution " "of the :keyword:`finally` clause." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:316 +#: reference/compound_stmts.rst:316 msgid "" "When a :keyword:`return`, :keyword:`break` or :keyword:`continue` statement " "is executed in the :keyword:`try` suite of a :keyword:`try`...\\ :keyword:" @@ -298,7 +305,7 @@ msgid "" msgstr "" # 09bfd574bc524511928a2d512ad7a339 -#: ../src/Doc/reference/compound_stmts.rst:323 +#: reference/compound_stmts.rst:323 msgid "" "The return value of a function is determined by the last :keyword:`return` " "statement executed. Since the :keyword:`finally` clause always executes, a :" @@ -306,18 +313,18 @@ msgid "" "always be the last one executed::" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:337 +#: reference/compound_stmts.rst:337 msgid "" "Additional information on exceptions can be found in section :ref:" "`exceptions`, and information on using the :keyword:`raise` statement to " "generate exceptions may be found in section :ref:`raise`." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:346 +#: reference/compound_stmts.rst:346 msgid "The :keyword:`with` statement" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:354 +#: reference/compound_stmts.rst:354 msgid "" "The :keyword:`with` statement is used to wrap the execution of a block with " "methods defined by a context manager (see section :ref:`context-managers`). " @@ -325,34 +332,34 @@ msgid "" "`finally` usage patterns to be encapsulated for convenient reuse." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:363 +#: reference/compound_stmts.rst:363 msgid "" "The execution of the :keyword:`with` statement with one \"item\" proceeds as " "follows:" msgstr "" # b7c6cf84fdc14044bceff98a4a84aa5a -#: ../src/Doc/reference/compound_stmts.rst:365 +#: reference/compound_stmts.rst:365 msgid "" "The context expression (the expression given in the :token:`with_item`) is " "evaluated to obtain a context manager." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:368 +#: reference/compound_stmts.rst:368 msgid "The context manager's :meth:`__exit__` is loaded for later use." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:370 +#: reference/compound_stmts.rst:370 msgid "The context manager's :meth:`__enter__` method is invoked." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:372 +#: reference/compound_stmts.rst:372 msgid "" "If a target was included in the :keyword:`with` statement, the return value " "from :meth:`__enter__` is assigned to it." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:377 +#: reference/compound_stmts.rst:377 msgid "" "The :keyword:`with` statement guarantees that if the :meth:`__enter__` " "method returns without an error, then :meth:`__exit__` will always be " @@ -361,12 +368,12 @@ msgid "" "See step 6 below." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:382 +#: reference/compound_stmts.rst:382 msgid "The suite is executed." msgstr "" # b1d4ac3b6ce541bea10a70695d38dbde -#: ../src/Doc/reference/compound_stmts.rst:384 +#: reference/compound_stmts.rst:384 msgid "" "The context manager's :meth:`__exit__` method is invoked. If an exception " "caused the suite to be exited, its type, value, and traceback are passed as " @@ -375,7 +382,7 @@ msgid "" msgstr "" # b626cb96237f4028a6f858ca7e0186bb -#: ../src/Doc/reference/compound_stmts.rst:389 +#: reference/compound_stmts.rst:389 msgid "" "If the suite was exited due to an exception, and the return value from the :" "meth:`__exit__` method was false, the exception is reraised. If the return " @@ -383,56 +390,56 @@ msgid "" "the statement following the :keyword:`with` statement." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:394 +#: reference/compound_stmts.rst:394 msgid "" "If the suite was exited for any reason other than an exception, the return " "value from :meth:`__exit__` is ignored, and execution proceeds at the normal " "location for the kind of exit that was taken." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:398 +#: reference/compound_stmts.rst:398 msgid "" "With more than one item, the context managers are processed as if multiple :" "keyword:`with` statements were nested::" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:404 +#: reference/compound_stmts.rst:404 msgid "is equivalent to ::" msgstr "" # 4567b1c1487546188aa1a6c80695e40a -#: ../src/Doc/reference/compound_stmts.rst:412 +#: reference/compound_stmts.rst:412 msgid "" "In Python 2.5, the :keyword:`with` statement is only allowed when the " "``with_statement`` feature has been enabled. It is always enabled in Python " "2.6." msgstr "" -# 3f31dae7ae0b457180c28ff386d8b377 -# b3c68401b311444e873812eb60267411 -#: ../src/Doc/reference/compound_stmts.rst:421 -#: ../src/Doc/reference/datamodel.rst:2390 -msgid ":pep:`0343` - The \"with\" statement" +#: reference/compound_stmts.rst:416 +msgid "Support for multiple context expressions." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:422 -#: ../src/Doc/reference/datamodel.rst:2391 +#: reference/compound_stmts.rst:422 reference/datamodel.rst:2401 +msgid "PEP 0343 - The \"with\" statement" +msgstr "" + +#: reference/compound_stmts.rst:422 reference/datamodel.rst:2401 msgid "" "The specification, background, and examples for the Python :keyword:`with` " "statement." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:433 +#: reference/compound_stmts.rst:433 msgid "Function definitions" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:443 +#: reference/compound_stmts.rst:443 msgid "" "A function definition defines a user-defined function object (see section :" "ref:`types`):" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:461 +#: reference/compound_stmts.rst:461 msgid "" "A function definition is an executable statement. Its execution binds the " "function name in the current local namespace to a function object (a wrapper " @@ -441,14 +448,14 @@ msgid "" "used when the function is called." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:467 +#: reference/compound_stmts.rst:467 msgid "" "The function definition does not execute the function body; this gets " "executed only when the function is called. [#]_" msgstr "" # 1f43dfddd48243458f87cb3817199d6f -#: ../src/Doc/reference/compound_stmts.rst:473 +#: reference/compound_stmts.rst:473 msgid "" "A function definition may be wrapped by one or more :term:`decorator` " "expressions. Decorator expressions are evaluated when the function is " @@ -460,12 +467,12 @@ msgid "" msgstr "" # e71ea122ac6d4dff8b2ce186ddaed6c2 -#: ../src/Doc/reference/compound_stmts.rst:484 +#: reference/compound_stmts.rst:484 msgid "is equivalent to::" msgstr "" # b3a9ccaa489e4af4bbb883711aff72db -#: ../src/Doc/reference/compound_stmts.rst:493 +#: reference/compound_stmts.rst:493 msgid "" "When one or more top-level :term:`parameters <parameter>` have the form " "*parameter* ``=`` *expression*, the function is said to have \"default " @@ -477,7 +484,7 @@ msgid "" msgstr "" # d8b8c95478ea4a48a13221859fdb3cb8 -#: ../src/Doc/reference/compound_stmts.rst:501 +#: reference/compound_stmts.rst:501 msgid "" "**Default parameter values are evaluated when the function definition is " "executed.** This means that the expression is evaluated once, when the " @@ -491,7 +498,7 @@ msgid "" msgstr "" # 66be6e0f405a4c6ca1c7f8e36fb0841e -#: ../src/Doc/reference/compound_stmts.rst:520 +#: reference/compound_stmts.rst:520 msgid "" "Function call semantics are described in more detail in section :ref:" "`calls`. A function call always assigns values to all parameters mentioned " @@ -504,7 +511,7 @@ msgid "" msgstr "" # 29161efb87ee47c6888bd3d8c0c72e4c -#: ../src/Doc/reference/compound_stmts.rst:530 +#: reference/compound_stmts.rst:530 msgid "" "It is also possible to create anonymous functions (functions not bound to a " "name), for immediate use in expressions. This uses lambda expressions, " @@ -516,7 +523,7 @@ msgid "" "of multiple statements." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:538 +#: reference/compound_stmts.rst:538 msgid "" "**Programmer's note:** Functions are first-class objects. A \"``def``\" " "form executed inside a function definition defines a local function that can " @@ -525,15 +532,15 @@ msgid "" "section :ref:`naming` for details." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:548 +#: reference/compound_stmts.rst:548 msgid "Class definitions" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:560 +#: reference/compound_stmts.rst:560 msgid "A class definition defines a class object (see section :ref:`types`):" msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:567 +#: reference/compound_stmts.rst:567 msgid "" "A class definition is an executable statement. It first evaluates the " "inheritance list, if present. Each item in the inheritance list should " @@ -549,7 +556,7 @@ msgid "" msgstr "" # b91d18ce49bf407d9a57a1b3a43ee422 -#: ../src/Doc/reference/compound_stmts.rst:578 +#: reference/compound_stmts.rst:578 msgid "" "**Programmer's note:** Variables defined in the class definition are class " "variables; they are shared by all instances. To create instance variables, " @@ -562,7 +569,7 @@ msgid "" "variables with different implementation details." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:588 +#: reference/compound_stmts.rst:588 msgid "" "Class definitions, like function definitions, may be wrapped by one or more :" "term:`decorator` expressions. The evaluation rules for the decorator " @@ -570,53 +577,50 @@ msgid "" "object, which is then bound to the class name." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:594 -#: ../src/Doc/reference/datamodel.rst:2499 -#: ../src/Doc/reference/executionmodel.rst:244 -#: ../src/Doc/reference/expressions.rst:1402 -#: ../src/Doc/reference/lexical_analysis.rst:759 -#: ../src/Doc/reference/simple_stmts.rst:1048 +#: reference/compound_stmts.rst:594 reference/datamodel.rst:2509 +#: reference/executionmodel.rst:244 reference/expressions.rst:1402 +#: reference/lexical_analysis.rst:760 reference/simple_stmts.rst:1048 msgid "Footnotes" msgstr "Notes" # a93e0edf24f94b76b62618582bf50dc5 -#: ../src/Doc/reference/compound_stmts.rst:595 +#: reference/compound_stmts.rst:595 msgid "" "The exception is propagated to the invocation stack unless there is a :" "keyword:`finally` clause which happens to raise another exception. That new " "exception causes the old one to be lost." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:599 +#: reference/compound_stmts.rst:599 msgid "" "Currently, control \"flows off the end\" except in the case of an exception " "or the execution of a :keyword:`return`, :keyword:`continue`, or :keyword:" "`break` statement." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:603 +#: reference/compound_stmts.rst:603 msgid "" "A string literal appearing as the first statement in the function body is " "transformed into the function's ``__doc__`` attribute and therefore the " "function's :term:`docstring`." msgstr "" -#: ../src/Doc/reference/compound_stmts.rst:607 +#: reference/compound_stmts.rst:607 msgid "" "A string literal appearing as the first statement in the class body is " "transformed into the namespace's ``__doc__`` item and therefore the class's :" "term:`docstring`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:6 +#: reference/datamodel.rst:6 msgid "Data model" msgstr "" -#: ../src/Doc/reference/datamodel.rst:12 +#: reference/datamodel.rst:12 msgid "Objects, values and types" msgstr "" -#: ../src/Doc/reference/datamodel.rst:18 +#: reference/datamodel.rst:18 msgid "" ":dfn:`Objects` are Python's abstraction for data. All data in a Python " "program is represented by objects or by relations between objects. (In a " @@ -624,7 +628,7 @@ msgid "" "computer,\" code is also represented by objects.)" msgstr "" -#: ../src/Doc/reference/datamodel.rst:32 +#: reference/datamodel.rst:32 msgid "" "Every object has an identity, a type and a value. An object's *identity* " "never changes once it has been created; you may think of it as the object's " @@ -646,7 +650,7 @@ msgid "" "tuples are immutable, while dictionaries and lists are mutable." msgstr "" -#: ../src/Doc/reference/datamodel.rst:55 +#: reference/datamodel.rst:55 msgid "" "Objects are never explicitly destroyed; however, when they become " "unreachable they may be garbage-collected. An implementation is allowed to " @@ -656,7 +660,7 @@ msgid "" msgstr "" # 3ae2fcb9b4d645e8a3f93f03316143d7 -#: ../src/Doc/reference/datamodel.rst:63 +#: reference/datamodel.rst:63 msgid "" "CPython currently uses a reference-counting scheme with (optional) delayed " "detection of cyclically linked garbage, which collects most objects as soon " @@ -668,7 +672,7 @@ msgid "" "always close files)." msgstr "" -#: ../src/Doc/reference/datamodel.rst:72 +#: reference/datamodel.rst:72 msgid "" "Note that the use of the implementation's tracing or debugging facilities " "may keep objects alive that would normally be collectable. Also note that " @@ -677,7 +681,7 @@ msgid "" msgstr "" # 6ba539d835d6465e843badcf37d1fdc7 -#: ../src/Doc/reference/datamodel.rst:77 +#: reference/datamodel.rst:77 msgid "" "Some objects contain references to \"external\" resources such as open files " "or windows. It is understood that these resources are freed when the object " @@ -688,7 +692,7 @@ msgid "" "`finally`' statement provides a convenient way to do this." msgstr "" -#: ../src/Doc/reference/datamodel.rst:87 +#: reference/datamodel.rst:87 msgid "" "Some objects contain references to other objects; these are called " "*containers*. Examples of containers are tuples, lists and dictionaries. " @@ -700,7 +704,7 @@ msgid "" "to a mutable object, its value changes if that mutable object is changed." msgstr "" -#: ../src/Doc/reference/datamodel.rst:96 +#: reference/datamodel.rst:96 msgid "" "Types affect almost all aspects of object behavior. Even the importance of " "object identity is affected in some sense: for immutable types, operations " @@ -713,12 +717,12 @@ msgid "" "assigns the same object to both ``c`` and ``d``.)" msgstr "" -#: ../src/Doc/reference/datamodel.rst:110 +#: reference/datamodel.rst:110 msgid "The standard type hierarchy" msgstr "" # f96ab51c71e84f28bc0433cad66df7ff -#: ../src/Doc/reference/datamodel.rst:119 +#: reference/datamodel.rst:119 msgid "" "Below is a list of the types that are built into Python. Extension modules " "(written in C, Java, or other languages, depending on the implementation) " @@ -727,7 +731,7 @@ msgid "" "integers, etc.)." msgstr "" -#: ../src/Doc/reference/datamodel.rst:129 +#: reference/datamodel.rst:129 msgid "" "Some of the type descriptions below contain a paragraph listing 'special " "attributes.' These are attributes that provide access to the implementation " @@ -736,11 +740,11 @@ msgid "" msgstr "" # 6af85f376d8e4e15991b6e063789595d -#: ../src/Doc/reference/datamodel.rst:138 +#: reference/datamodel.rst:139 msgid "None" msgstr "" -#: ../src/Doc/reference/datamodel.rst:136 +#: reference/datamodel.rst:136 msgid "" "This type has a single value. There is a single object with this value. " "This object is accessed through the built-in name ``None``. It is used to " @@ -749,11 +753,11 @@ msgid "" msgstr "" # 2dbd77a018804c8dae256820666e33f3 -#: ../src/Doc/reference/datamodel.rst:148 +#: reference/datamodel.rst:149 msgid "NotImplemented" msgstr "" -#: ../src/Doc/reference/datamodel.rst:144 +#: reference/datamodel.rst:144 msgid "" "This type has a single value. There is a single object with this value. " "This object is accessed through the built-in name ``NotImplemented``. " @@ -764,12 +768,12 @@ msgid "" msgstr "" # 1617e5bfd452481c80c35729a58e1093 -#: ../src/Doc/reference/datamodel.rst:156 +#: reference/datamodel.rst:157 msgid "Ellipsis" msgstr "" # d58c8f2d968441da9a21a0f495a6e149 -#: ../src/Doc/reference/datamodel.rst:154 +#: reference/datamodel.rst:154 msgid "" "This type has a single value. There is a single object with this value. " "This object is accessed through the built-in name ``Ellipsis``. It is used " @@ -777,12 +781,11 @@ msgid "" "is true." msgstr "" -# b8af4e5c60fa44688d3d98b0d3fe7cea -#: ../src/Doc/reference/datamodel.rst:248 -msgid ":class:`numbers.Number`" +#: reference/datamodel.rst:249 +msgid "numbers.Number" msgstr "" -#: ../src/Doc/reference/datamodel.rst:162 +#: reference/datamodel.rst:162 msgid "" "These are created by numeric literals and returned as results by arithmetic " "operators and arithmetic built-in functions. Numeric objects are immutable; " @@ -791,35 +794,34 @@ msgid "" "numerical representation in computers." msgstr "" -#: ../src/Doc/reference/datamodel.rst:168 +#: reference/datamodel.rst:168 msgid "" "Python distinguishes between integers, floating point numbers, and complex " "numbers:" msgstr "" -# 349d03b8fbac4031b3bc30ab44e943d0 -#: ../src/Doc/reference/datamodel.rst:223 -msgid ":class:`numbers.Integral`" +#: reference/datamodel.rst:224 +msgid "numbers.Integral" msgstr "" -#: ../src/Doc/reference/datamodel.rst:174 +#: reference/datamodel.rst:174 msgid "" "These represent elements from the mathematical set of integers (positive and " "negative)." msgstr "" # 86240d1f7da14296bf3ab9cac3c0e24a -#: ../src/Doc/reference/datamodel.rst:177 +#: reference/datamodel.rst:177 msgid "There are three types of integers:" msgstr "" # 742ea09753804952b3d6e869f59ff560 -#: ../src/Doc/reference/datamodel.rst:191 +#: reference/datamodel.rst:192 msgid "Plain integers" msgstr "" # 343ff6044dce47a8a0d2de4f77788bf8 -#: ../src/Doc/reference/datamodel.rst:184 +#: reference/datamodel.rst:184 msgid "" "These represent numbers in the range -2147483648 through 2147483647. (The " "range may be larger on machines with a larger natural word size, but not " @@ -832,11 +834,11 @@ msgid "" msgstr "" # f039b2d559d349aba644d3a491c2fa79 -#: ../src/Doc/reference/datamodel.rst:200 +#: reference/datamodel.rst:201 msgid "Long integers" msgstr "" -#: ../src/Doc/reference/datamodel.rst:197 +#: reference/datamodel.rst:197 msgid "" "These represent numbers in an unlimited range, subject to available " "(virtual) memory only. For the purpose of shift and mask operations, a " @@ -846,12 +848,12 @@ msgid "" msgstr "" # ea8f62f80180414dafdd52d46a48b236 -#: ../src/Doc/reference/datamodel.rst:213 +#: reference/datamodel.rst:214 msgid "Booleans" msgstr "" # 6825dfac6e554a98a74bc8a0f23ad8e8 -#: ../src/Doc/reference/datamodel.rst:209 +#: reference/datamodel.rst:209 msgid "" "These represent the truth values False and True. The two objects " "representing the values ``False`` and ``True`` are the only Boolean objects. " @@ -862,7 +864,7 @@ msgid "" msgstr "" # d155cd1a106241a9a13ef6e05c99d05b -#: ../src/Doc/reference/datamodel.rst:218 +#: reference/datamodel.rst:218 msgid "" "The rules for integer representation are intended to give the most " "meaningful interpretation of shift and mask operations involving negative " @@ -872,13 +874,12 @@ msgid "" "mixed operands. The switch between domains is transparent to the programmer." msgstr "" -# 3ce6f2d40b7f4510b323d1c9fdf9c34d -#: ../src/Doc/reference/datamodel.rst:238 -msgid ":class:`numbers.Real` (:class:`float`)" +#: reference/datamodel.rst:239 +msgid "numbers.Real (float)" msgstr "" # 7903b962cec34aee8f333e0f2fb4215e -#: ../src/Doc/reference/datamodel.rst:233 +#: reference/datamodel.rst:233 msgid "" "These represent machine-level double precision floating point numbers. You " "are at the mercy of the underlying machine architecture (and C or Java " @@ -889,12 +890,11 @@ msgid "" "complicate the language with two kinds of floating point numbers." msgstr "" -# ffddeabb35854d63ba4d860bad9e2139 -#: ../src/Doc/reference/datamodel.rst:248 -msgid ":class:`numbers.Complex`" +#: reference/datamodel.rst:249 +msgid "numbers.Complex" msgstr "" -#: ../src/Doc/reference/datamodel.rst:246 +#: reference/datamodel.rst:246 msgid "" "These represent complex numbers as a pair of machine-level double precision " "floating point numbers. The same caveats apply as for floating point " @@ -903,11 +903,11 @@ msgid "" msgstr "" # 3c601840a65349a1acf8fe090791a8e5 -#: ../src/Doc/reference/datamodel.rst:385 +#: reference/datamodel.rst:386 msgid "Sequences" msgstr "" -#: ../src/Doc/reference/datamodel.rst:259 +#: reference/datamodel.rst:259 msgid "" "These represent finite ordered sets indexed by non-negative numbers. The " "built-in function :func:`len` returns the number of items of a sequence. " @@ -915,7 +915,7 @@ msgid "" "1, ..., *n*-1. Item *i* of sequence *a* is selected by ``a[i]``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:266 +#: reference/datamodel.rst:266 msgid "" "Sequences also support slicing: ``a[i:j]`` selects all items with index *k* " "such that *i* ``<=`` *k* ``<`` *j*. When used as an expression, a slice is " @@ -923,23 +923,23 @@ msgid "" "so that it starts at 0." msgstr "" -#: ../src/Doc/reference/datamodel.rst:273 +#: reference/datamodel.rst:273 msgid "" "Some sequences also support \"extended slicing\" with a third \"step\" " "parameter: ``a[i:j:k]`` selects all items of *a* with index *x* where ``x = " "i + n*k``, *n* ``>=`` ``0`` and *i* ``<=`` *x* ``<`` *j*." msgstr "" -#: ../src/Doc/reference/datamodel.rst:277 +#: reference/datamodel.rst:277 msgid "Sequences are distinguished according to their mutability:" msgstr "" # cd5bbb030fe14b09ae8240dcf8ad7d1f -#: ../src/Doc/reference/datamodel.rst:351 +#: reference/datamodel.rst:352 msgid "Immutable sequences" msgstr "" -#: ../src/Doc/reference/datamodel.rst:284 +#: reference/datamodel.rst:284 msgid "" "An object of an immutable sequence type cannot change once it is created. " "(If the object contains references to other objects, these other objects may " @@ -947,17 +947,17 @@ msgid "" "referenced by an immutable object cannot change.)" msgstr "" -#: ../src/Doc/reference/datamodel.rst:289 +#: reference/datamodel.rst:289 msgid "The following types are immutable sequences:" msgstr "" # caf3cd5ee98841eda871ef1e84af8f8f -#: ../src/Doc/reference/datamodel.rst:318 +#: reference/datamodel.rst:319 msgid "Strings" msgstr "Les chaînes de caractères" # fe98dae21e724498a7ef39fe727bcca2 -#: ../src/Doc/reference/datamodel.rst:300 +#: reference/datamodel.rst:300 msgid "" "The items of a string are characters. There is no separate character type; " "a character is represented by a string of one item. Characters represent (at " @@ -970,7 +970,7 @@ msgid "" msgstr "" # 5a44d4413891453591c340e32847fd2d -#: ../src/Doc/reference/datamodel.rst:316 +#: reference/datamodel.rst:316 msgid "" "(On systems whose native character set is not ASCII, strings may use EBCDIC " "in their internal representation, provided the functions :func:`chr` and :" @@ -980,12 +980,12 @@ msgid "" msgstr "" # e31c400629384ba1803478767d5a3448 -#: ../src/Doc/reference/datamodel.rst:339 +#: reference/datamodel.rst:340 msgid "Unicode" msgstr "" # cbe04095f79048da9273d47cfe3e7888 -#: ../src/Doc/reference/datamodel.rst:331 +#: reference/datamodel.rst:331 msgid "" "The items of a Unicode object are Unicode code units. A Unicode code unit " "is represented by a Unicode object of one item and can hold either a 16-bit " @@ -1000,11 +1000,11 @@ msgid "" msgstr "" # 9d453b389c094952a60e1145c0159ae5 -#: ../src/Doc/reference/datamodel.rst:351 +#: reference/datamodel.rst:352 msgid "Tuples" msgstr "" -#: ../src/Doc/reference/datamodel.rst:348 +#: reference/datamodel.rst:348 msgid "" "The items of a tuple are arbitrary Python objects. Tuples of two or more " "items are formed by comma-separated lists of expressions. A tuple of one " @@ -1015,27 +1015,27 @@ msgid "" msgstr "" # 1ba7d42f927f4a22aed32ebd336c85b3 -#: ../src/Doc/reference/datamodel.rst:385 +#: reference/datamodel.rst:386 msgid "Mutable sequences" msgstr "" -#: ../src/Doc/reference/datamodel.rst:362 +#: reference/datamodel.rst:362 msgid "" "Mutable sequences can be changed after they are created. The subscription " "and slicing notations can be used as the target of assignment and :keyword:" "`del` (delete) statements." msgstr "" -#: ../src/Doc/reference/datamodel.rst:366 +#: reference/datamodel.rst:366 msgid "There are currently two intrinsic mutable sequence types:" msgstr "" # 1da278a6a29745b3b2a403b4084ebad7 -#: ../src/Doc/reference/datamodel.rst:372 +#: reference/datamodel.rst:373 msgid "Lists" msgstr "Les listes" -#: ../src/Doc/reference/datamodel.rst:371 +#: reference/datamodel.rst:371 msgid "" "The items of a list are arbitrary Python objects. Lists are formed by " "placing a comma-separated list of expressions in square brackets. (Note that " @@ -1043,11 +1043,11 @@ msgid "" msgstr "" # aefdd452318f4aaaadd0560e3ef41a5e -#: ../src/Doc/reference/datamodel.rst:380 +#: reference/datamodel.rst:381 msgid "Byte Arrays" msgstr "" -#: ../src/Doc/reference/datamodel.rst:378 +#: reference/datamodel.rst:378 msgid "" "A bytearray object is a mutable array. They are created by the built-in :" "func:`bytearray` constructor. Aside from being mutable (and hence " @@ -1056,18 +1056,18 @@ msgid "" msgstr "" # 8b4a55cde12d446db9ca143812cd1b55 -#: ../src/Doc/reference/datamodel.rst:385 +#: reference/datamodel.rst:385 msgid "" "The extension module :mod:`array` provides an additional example of a " "mutable sequence type." msgstr "" # 2f7aab895c7d43858d878c1934cde388 -#: ../src/Doc/reference/datamodel.rst:419 +#: reference/datamodel.rst:420 msgid "Set types" msgstr "" -#: ../src/Doc/reference/datamodel.rst:393 +#: reference/datamodel.rst:393 msgid "" "These represent unordered, finite sets of unique, immutable objects. As " "such, they cannot be indexed by any subscript. However, they can be iterated " @@ -1077,7 +1077,7 @@ msgid "" "union, difference, and symmetric difference." msgstr "" -#: ../src/Doc/reference/datamodel.rst:400 +#: reference/datamodel.rst:400 msgid "" "For set elements, the same immutability rules apply as for dictionary keys. " "Note that numeric types obey the normal rules for numeric comparison: if two " @@ -1085,17 +1085,17 @@ msgid "" "contained in a set." msgstr "" -#: ../src/Doc/reference/datamodel.rst:405 +#: reference/datamodel.rst:405 msgid "There are currently two intrinsic set types:" msgstr "" # 2b181f2fd0c9482db2e1860b491fc739 -#: ../src/Doc/reference/datamodel.rst:411 +#: reference/datamodel.rst:412 msgid "Sets" msgstr "Les ensembles" # 42da18eafdeb400cb5ec2db21fd97ebe -#: ../src/Doc/reference/datamodel.rst:410 +#: reference/datamodel.rst:410 msgid "" "These represent a mutable set. They are created by the built-in :func:`set` " "constructor and can be modified afterwards by several methods, such as :meth:" @@ -1103,11 +1103,11 @@ msgid "" msgstr "" # 046b68589a5c4c489295a463240770a6 -#: ../src/Doc/reference/datamodel.rst:419 +#: reference/datamodel.rst:420 msgid "Frozen sets" msgstr "" -#: ../src/Doc/reference/datamodel.rst:417 +#: reference/datamodel.rst:417 msgid "" "These represent an immutable set. They are created by the built-in :func:" "`frozenset` constructor. As a frozenset is immutable and :term:`hashable`, " @@ -1115,11 +1115,11 @@ msgid "" msgstr "" # 50dff33f14f640d89869365269fc8008 -#: ../src/Doc/reference/datamodel.rst:456 +#: reference/datamodel.rst:457 msgid "Mappings" msgstr "" -#: ../src/Doc/reference/datamodel.rst:428 +#: reference/datamodel.rst:428 msgid "" "These represent finite sets of objects indexed by arbitrary index sets. The " "subscript notation ``a[k]`` selects the item indexed by ``k`` from the " @@ -1128,16 +1128,16 @@ msgid "" "returns the number of items in a mapping." msgstr "" -#: ../src/Doc/reference/datamodel.rst:434 +#: reference/datamodel.rst:434 msgid "There is currently a single intrinsic mapping type:" msgstr "" # 1401c1869aff43039fd8375bf7b3d11a -#: ../src/Doc/reference/datamodel.rst:456 +#: reference/datamodel.rst:457 msgid "Dictionaries" msgstr "Dictionnaires" -#: ../src/Doc/reference/datamodel.rst:439 +#: reference/datamodel.rst:439 msgid "" "These represent finite sets of objects indexed by nearly arbitrary values. " "The only types of values not acceptable as keys are values containing lists " @@ -1149,158 +1149,164 @@ msgid "" "interchangeably to index the same dictionary entry." msgstr "" -#: ../src/Doc/reference/datamodel.rst:448 +#: reference/datamodel.rst:448 msgid "" "Dictionaries are mutable; they can be created by the ``{...}`` notation (see " "section :ref:`dict`)." msgstr "" # 4d66cc731118483a9b16adccbb9d8e47 -#: ../src/Doc/reference/datamodel.rst:456 +#: reference/datamodel.rst:456 msgid "" "The extension modules :mod:`dbm`, :mod:`gdbm`, and :mod:`bsddb` provide " "additional examples of mapping types." msgstr "" # 31c6b46636d245fea435cea46f7bd0e6 -#: ../src/Doc/reference/datamodel.rst:725 +#: reference/datamodel.rst:726 msgid "Callable types" msgstr "" -#: ../src/Doc/reference/datamodel.rst:466 +#: reference/datamodel.rst:466 msgid "" "These are the types to which the function call operation (see section :ref:" "`calls`) can be applied:" msgstr "" # 02e3d46b71774a2fb852c08a14010643 -#: ../src/Doc/reference/datamodel.rst:558 +#: reference/datamodel.rst:559 msgid "User-defined functions" msgstr "" -#: ../src/Doc/reference/datamodel.rst:475 +#: reference/datamodel.rst:475 msgid "" "A user-defined function object is created by a function definition (see " "section :ref:`function`). It should be called with an argument list " "containing the same number of items as the function's formal parameter list." msgstr "" -#: ../src/Doc/reference/datamodel.rst:480 +#: reference/datamodel.rst:480 msgid "Special attributes:" msgstr "" -#: ../src/Doc/reference/datamodel.rst:485 +#: reference/datamodel.rst:485 msgid "Attribute" msgstr "" -#: ../src/Doc/reference/datamodel.rst:485 -#: ../src/Doc/reference/lexical_analysis.rst:480 +#: reference/datamodel.rst:485 reference/lexical_analysis.rst:481 msgid "Meaning" msgstr "" # b62fa63a92e24354bc0128a6f5d73acf -#: ../src/Doc/reference/datamodel.rst:487 +#: reference/datamodel.rst:487 msgid ":attr:`__doc__` :attr:`func_doc`" msgstr "" # 1028dc904341499f88ee09ca4974f055 -#: ../src/Doc/reference/datamodel.rst:487 +#: reference/datamodel.rst:487 msgid "The function's documentation string, or ``None`` if unavailable." msgstr "" -#: ../src/Doc/reference/datamodel.rst:487 -#: ../src/Doc/reference/datamodel.rst:491 -#: ../src/Doc/reference/datamodel.rst:494 -#: ../src/Doc/reference/datamodel.rst:498 -#: ../src/Doc/reference/datamodel.rst:504 -#: ../src/Doc/reference/datamodel.rst:514 +#: reference/datamodel.rst:487 reference/datamodel.rst:491 +#: reference/datamodel.rst:494 reference/datamodel.rst:498 +#: reference/datamodel.rst:504 reference/datamodel.rst:514 msgid "Writable" msgstr "" # 46b8efa9351e4d8e92898f3437b71bfe -#: ../src/Doc/reference/datamodel.rst:491 +#: reference/datamodel.rst:491 msgid ":attr:`__name__` :attr:`func_name`" msgstr "" # 38bf27b69ec24e49b5eb63015d7c2c1f -#: ../src/Doc/reference/datamodel.rst:491 +#: reference/datamodel.rst:491 msgid "The function's name." msgstr "" -#: ../src/Doc/reference/datamodel.rst:494 +#: reference/datamodel.rst:494 msgid ":attr:`__module__`" msgstr "" -#: ../src/Doc/reference/datamodel.rst:494 +#: reference/datamodel.rst:494 msgid "" "The name of the module the function was defined in, or ``None`` if " "unavailable." msgstr "" # e8ad68bab28a426ba9c11dc85ef9d6d4 -#: ../src/Doc/reference/datamodel.rst:498 +#: reference/datamodel.rst:498 msgid ":attr:`__defaults__` :attr:`func_defaults`" msgstr "" # abdda76e07234edfa3481cf03251dcc9 -#: ../src/Doc/reference/datamodel.rst:498 +#: reference/datamodel.rst:498 msgid "" "A tuple containing default argument values for those arguments that have " "defaults, or ``None`` if no arguments have a default value." msgstr "" # 46b8efa9351e4d8e92898f3437b71bfe -#: ../src/Doc/reference/datamodel.rst:504 +#: reference/datamodel.rst:504 msgid ":attr:`__code__` :attr:`func_code`" msgstr "" -#: ../src/Doc/reference/datamodel.rst:504 +#: reference/datamodel.rst:504 msgid "The code object representing the compiled function body." msgstr "" # 46b8efa9351e4d8e92898f3437b71bfe -#: ../src/Doc/reference/datamodel.rst:507 +#: reference/datamodel.rst:507 msgid ":attr:`__globals__` :attr:`func_globals`" msgstr "" -#: ../src/Doc/reference/datamodel.rst:507 +#: reference/datamodel.rst:507 msgid "" "A reference to the dictionary that holds the function's global variables --- " "the global namespace of the module in which the function was defined." msgstr "" -#: ../src/Doc/reference/datamodel.rst:507 -#: ../src/Doc/reference/datamodel.rst:518 +#: reference/datamodel.rst:507 reference/datamodel.rst:518 msgid "Read-only" msgstr "" # b62fa63a92e24354bc0128a6f5d73acf -#: ../src/Doc/reference/datamodel.rst:514 +#: reference/datamodel.rst:514 msgid ":attr:`__dict__` :attr:`func_dict`" msgstr "" -#: ../src/Doc/reference/datamodel.rst:514 +#: reference/datamodel.rst:514 msgid "The namespace supporting arbitrary function attributes." msgstr "" # 46b8efa9351e4d8e92898f3437b71bfe -#: ../src/Doc/reference/datamodel.rst:518 +#: reference/datamodel.rst:518 msgid ":attr:`__closure__` :attr:`func_closure`" msgstr "" -#: ../src/Doc/reference/datamodel.rst:518 +#: reference/datamodel.rst:518 msgid "" "``None`` or a tuple of cells that contain bindings for the function's free " "variables." msgstr "" -#: ../src/Doc/reference/datamodel.rst:523 +#: reference/datamodel.rst:523 msgid "" "Most of the attributes labelled \"Writable\" check the type of the assigned " "value." msgstr "" -#: ../src/Doc/reference/datamodel.rst:534 +#: reference/datamodel.rst:525 +msgid "``func_name`` is now writable." +msgstr "" + +#: reference/datamodel.rst:528 +msgid "" +"The double-underscore attributes ``__closure__``, ``__code__``, " +"``__defaults__``, and ``__globals__`` were introduced as aliases for the " +"corresponding ``func_*`` attributes for forwards compatibility with Python 3." +msgstr "" + +#: reference/datamodel.rst:534 msgid "" "Function objects also support getting and setting arbitrary attributes, " "which can be used, for example, to attach metadata to functions. Regular " @@ -1310,26 +1316,26 @@ msgid "" "future.*" msgstr "" -#: ../src/Doc/reference/datamodel.rst:540 +#: reference/datamodel.rst:540 msgid "" "Additional information about a function's definition can be retrieved from " "its code object; see the description of internal types below." msgstr "" # 0a77732349ac48739469393b02917003 -#: ../src/Doc/reference/datamodel.rst:656 +#: reference/datamodel.rst:657 msgid "User-defined methods" msgstr "" # 7894140d93af4decb40ac32fcf4d12b9 -#: ../src/Doc/reference/datamodel.rst:567 +#: reference/datamodel.rst:567 msgid "" "A user-defined method object combines a class, a class instance (or " "``None``) and any callable object (normally a user-defined function)." msgstr "" # d87389e884174e74b1ce15e9445e3a4b -#: ../src/Doc/reference/datamodel.rst:570 +#: reference/datamodel.rst:570 msgid "" "Special read-only attributes: :attr:`im_self` is the class instance object, :" "attr:`im_func` is the function object; :attr:`im_class` is the class of :" @@ -1340,14 +1346,24 @@ msgid "" "defined in, or ``None`` if unavailable." msgstr "" -#: ../src/Doc/reference/datamodel.rst:592 +#: reference/datamodel.rst:578 +msgid ":attr:`im_self` used to refer to the class that defined the method." +msgstr "" + +#: reference/datamodel.rst:581 +msgid "" +"For Python 3 forward-compatibility, :attr:`im_func` is also available as :" +"attr:`__func__`, and :attr:`im_self` as :attr:`__self__`." +msgstr "" + +#: reference/datamodel.rst:592 msgid "" "Methods also support accessing (but not setting) the arbitrary function " "attributes on the underlying function object." msgstr "" # 9b4dcfcb8cef4446931ac7962cd9c3ff -#: ../src/Doc/reference/datamodel.rst:595 +#: reference/datamodel.rst:595 msgid "" "User-defined method objects may be created when getting an attribute of a " "class (perhaps via an instance of that class), if that attribute is a user-" @@ -1359,7 +1375,7 @@ msgid "" msgstr "" # 5e45762ea037488aa1cc9942e02077a1 -#: ../src/Doc/reference/datamodel.rst:608 +#: reference/datamodel.rst:608 msgid "" "When a user-defined method object is created by retrieving a user-defined " "function object from a class, its :attr:`im_self` attribute is ``None`` and " @@ -1372,7 +1388,7 @@ msgid "" msgstr "" # ec13976fe5584d28947b2d1831df39b1 -#: ../src/Doc/reference/datamodel.rst:619 +#: reference/datamodel.rst:619 msgid "" "When a user-defined method object is created by retrieving another method " "object from a class or instance, the behaviour is the same as for a function " @@ -1381,7 +1397,7 @@ msgid "" msgstr "" # 7dba03e4fbbf43a3a0fa10be44f1645b -#: ../src/Doc/reference/datamodel.rst:629 +#: reference/datamodel.rst:629 msgid "" "When a user-defined method object is created by retrieving a class method " "object from a class or instance, its :attr:`im_self` attribute is the class " @@ -1390,7 +1406,7 @@ msgid "" msgstr "" # 4e2966656be4459a9472551f6f609c5a -#: ../src/Doc/reference/datamodel.rst:633 +#: reference/datamodel.rst:633 msgid "" "When an unbound user-defined method object is called, the underlying " "function (:attr:`im_func`) is called, with the restriction that the first " @@ -1399,7 +1415,7 @@ msgid "" msgstr "" # 9a08ebbdcdd148a29beaf3a7e91226db -#: ../src/Doc/reference/datamodel.rst:638 +#: reference/datamodel.rst:638 msgid "" "When a bound user-defined method object is called, the underlying function (:" "attr:`im_func`) is called, inserting the class instance (:attr:`im_self`) in " @@ -1409,7 +1425,7 @@ msgid "" msgstr "" # ab564412158d4273ae9cf14ccd3be8d3 -#: ../src/Doc/reference/datamodel.rst:644 +#: reference/datamodel.rst:644 msgid "" "When a user-defined method object is derived from a class method object, the " "\"class instance\" stored in :attr:`im_self` will actually be the class " @@ -1418,7 +1434,7 @@ msgid "" msgstr "" # c48e11f7c2e14d2998136a64150bbae6 -#: ../src/Doc/reference/datamodel.rst:649 +#: reference/datamodel.rst:649 msgid "" "Note that the transformation from function object to (unbound or bound) " "method object happens each time the attribute is retrieved from the class or " @@ -1432,12 +1448,12 @@ msgid "" msgstr "" # d06649a933304a91bcc1fc562339b36d -#: ../src/Doc/reference/datamodel.rst:672 +#: reference/datamodel.rst:673 msgid "Generator functions" msgstr "" # a13d1397712747fe93b9730c936faedb -#: ../src/Doc/reference/datamodel.rst:664 +#: reference/datamodel.rst:664 msgid "" "A function or method which uses the :keyword:`yield` statement (see section :" "ref:`yield`) is called a :dfn:`generator function`. Such a function, when " @@ -1451,11 +1467,11 @@ msgid "" msgstr "" # a54e20b73e7249eb8e492e40fdc356bc -#: ../src/Doc/reference/datamodel.rst:687 +#: reference/datamodel.rst:688 msgid "Built-in functions" msgstr "" -#: ../src/Doc/reference/datamodel.rst:681 +#: reference/datamodel.rst:681 msgid "" "A built-in function object is a wrapper around a C function. Examples of " "built-in functions are :func:`len` and :func:`math.sin` (:mod:`math` is a " @@ -1468,12 +1484,12 @@ msgid "" msgstr "" # 403a08fff2014365a38ad5bc8b330666 -#: ../src/Doc/reference/datamodel.rst:699 +#: reference/datamodel.rst:700 msgid "Built-in methods" msgstr "" # ae49a031018c4787909d7e961bbef93b -#: ../src/Doc/reference/datamodel.rst:696 +#: reference/datamodel.rst:696 msgid "" "This is really a different disguise of a built-in function, this time " "containing an object passed to the C function as an implicit extra " @@ -1483,12 +1499,12 @@ msgid "" msgstr "" # de168ba2e8e149fe9d762f0a72a740d3 -#: ../src/Doc/reference/datamodel.rst:706 +#: reference/datamodel.rst:707 msgid "Class Types" msgstr "" # 86793d02329d4e868c4ff68c7214f6dd -#: ../src/Doc/reference/datamodel.rst:703 +#: reference/datamodel.rst:703 msgid "" "Class types, or \"new-style classes,\" are callable. These objects normally " "act as factories for new instances of themselves, but variations are " @@ -1498,12 +1514,12 @@ msgid "" msgstr "" # 2baeb2ec4c724ec3957ef90216419266 -#: ../src/Doc/reference/datamodel.rst:720 +#: reference/datamodel.rst:721 msgid "Classic Classes" msgstr "" # 0950f665b5734473a93d5a1fad374876 -#: ../src/Doc/reference/datamodel.rst:717 +#: reference/datamodel.rst:717 msgid "" "Class objects are described below. When a class object is called, a new " "class instance (also described below) is created and returned. This implies " @@ -1514,13 +1530,12 @@ msgstr "" # 4c0a611441684ed4a65195c94fa46f0b # 38b0e10b8a7843cb9c991bea5683c384 -#: ../src/Doc/reference/datamodel.rst:725 -#: ../src/Doc/reference/datamodel.rst:877 +#: reference/datamodel.rst:726 reference/datamodel.rst:878 msgid "Class instances" msgstr "" # fe79bdcd47004b11ab561fc55e193f21 -#: ../src/Doc/reference/datamodel.rst:724 +#: reference/datamodel.rst:724 msgid "" "Class instances are described below. Class instances are callable only when " "the class has a :meth:`__call__` method; ``x(arguments)`` is a shorthand for " @@ -1528,12 +1543,12 @@ msgid "" msgstr "" # 8b81f6145bc44987a6cbf4205bc1f0c8 -#: ../src/Doc/reference/datamodel.rst:768 +#: reference/datamodel.rst:769 msgid "Modules" msgstr "Modules" # 5baaa0830cfc4930a7247f13f0094926 -#: ../src/Doc/reference/datamodel.rst:733 +#: reference/datamodel.rst:733 msgid "" "Modules are imported by the :keyword:`import` statement (see section :ref:" "`import`). A module object has a namespace implemented by a dictionary " @@ -1544,20 +1559,20 @@ msgid "" "the module (since it isn't needed once the initialization is done)." msgstr "" -#: ../src/Doc/reference/datamodel.rst:742 +#: reference/datamodel.rst:742 msgid "" "Attribute assignment updates the module's namespace dictionary, e.g., ``m.x " "= 1`` is equivalent to ``m.__dict__[\"x\"] = 1``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:747 +#: reference/datamodel.rst:747 msgid "" "Special read-only attribute: :attr:`__dict__` is the module's namespace as a " "dictionary object." msgstr "" # 9535f61b76ba466986a636c5e38fd388 -#: ../src/Doc/reference/datamodel.rst:752 +#: reference/datamodel.rst:752 msgid "" "Because of the way CPython clears module dictionaries, the module dictionary " "will be cleared when the module falls out of scope even if the dictionary " @@ -1565,7 +1580,7 @@ msgid "" "module around while using its dictionary directly." msgstr "" -#: ../src/Doc/reference/datamodel.rst:763 +#: reference/datamodel.rst:763 msgid "" "Predefined (writable) attributes: :attr:`__name__` is the module's name; :" "attr:`__doc__` is the module's documentation string, or ``None`` if " @@ -1577,12 +1592,12 @@ msgid "" msgstr "" # dec5c1bb2d844ee0a239a6b253cce479 -#: ../src/Doc/reference/datamodel.rst:831 +#: reference/datamodel.rst:832 msgid "Classes" msgstr "Classes" # ac345d309f4b4dbf8028e36209550b83 -#: ../src/Doc/reference/datamodel.rst:772 +#: reference/datamodel.rst:772 msgid "" "Both class types (new-style classes) and class objects (old-style/classic " "classes) are typically created by class definitions (see section :ref:" @@ -1602,7 +1617,7 @@ msgid "" msgstr "" # cebd236ce29f4d20abb89b837d6296dc -#: ../src/Doc/reference/datamodel.rst:799 +#: reference/datamodel.rst:799 msgid "" "When a class attribute reference (for class :class:`C`, say) would yield a " "user-defined function object or an unbound user-defined method object whose " @@ -1617,20 +1632,20 @@ msgid "" "`__dict__` (note that only new-style classes support descriptors)." msgstr "" -#: ../src/Doc/reference/datamodel.rst:813 +#: reference/datamodel.rst:813 msgid "" "Class attribute assignments update the class's dictionary, never the " "dictionary of a base class." msgstr "" -#: ../src/Doc/reference/datamodel.rst:818 +#: reference/datamodel.rst:818 msgid "" "A class object can be called (see above) to yield a class instance (see " "below)." msgstr "" # 511dec8cb42742be80978908ec4e83f8 -#: ../src/Doc/reference/datamodel.rst:827 +#: reference/datamodel.rst:827 msgid "" "Special attributes: :attr:`__name__` is the class name; :attr:`__module__` " "is the module name in which the class was defined; :attr:`__dict__` is the " @@ -1641,7 +1656,7 @@ msgid "" msgstr "" # 01b8b00399824946950b6e0a4ee21b92 -#: ../src/Doc/reference/datamodel.rst:841 +#: reference/datamodel.rst:841 msgid "" "A class instance is created by calling a class object (see above). A class " "instance has a namespace implemented as a dictionary which is the first " @@ -1662,7 +1677,7 @@ msgid "" "that is called to satisfy the lookup." msgstr "" -#: ../src/Doc/reference/datamodel.rst:860 +#: reference/datamodel.rst:860 msgid "" "Attribute assignments and deletions update the instance's dictionary, never " "a class's dictionary. If the class has a :meth:`__setattr__` or :meth:" @@ -1670,26 +1685,26 @@ msgid "" "dictionary directly." msgstr "" -#: ../src/Doc/reference/datamodel.rst:870 +#: reference/datamodel.rst:870 msgid "" "Class instances can pretend to be numbers, sequences, or mappings if they " "have methods with certain special names. See section :ref:`specialnames`." msgstr "" # f6adef6a193c46049af4d4d1920b001c -#: ../src/Doc/reference/datamodel.rst:877 +#: reference/datamodel.rst:877 msgid "" "Special attributes: :attr:`~object.__dict__` is the attribute dictionary; :" "attr:`~instance.__class__` is the instance's class." msgstr "" # d53dfe109d3847c79384b130cce072ac -#: ../src/Doc/reference/datamodel.rst:900 +#: reference/datamodel.rst:901 msgid "Files" msgstr "" # 1c5c6d93c4af49fcb206b8c914474046 -#: ../src/Doc/reference/datamodel.rst:894 +#: reference/datamodel.rst:894 msgid "" "A file object represents an open file. File objects are created by the :" "func:`open` built-in function, and also by :func:`os.popen`, :func:`os." @@ -1702,11 +1717,11 @@ msgid "" msgstr "" # 55a3c6b48f574bdca1e6bc5ba9677fb5 -#: ../src/Doc/reference/datamodel.rst:1110 +#: reference/datamodel.rst:1111 msgid "Internal types" msgstr "" -#: ../src/Doc/reference/datamodel.rst:908 +#: reference/datamodel.rst:908 msgid "" "A few types used internally by the interpreter are exposed to the user. " "Their definitions may change with future versions of the interpreter, but " @@ -1714,12 +1729,12 @@ msgid "" msgstr "" # eaee202b99024fc4a04d4a87446d8bd7 -#: ../src/Doc/reference/datamodel.rst:977 +#: reference/datamodel.rst:978 #, fuzzy msgid "Code objects" msgstr "Objets Code" -#: ../src/Doc/reference/datamodel.rst:917 +#: reference/datamodel.rst:917 msgid "" "Code objects represent *byte-compiled* executable Python code, or :term:" "`bytecode`. The difference between a code object and a function object is " @@ -1731,7 +1746,7 @@ msgid "" "no references (directly or indirectly) to mutable objects." msgstr "" -#: ../src/Doc/reference/datamodel.rst:942 +#: reference/datamodel.rst:942 msgid "" "Special read-only attributes: :attr:`co_name` gives the function name; :attr:" "`co_argcount` is the number of positional arguments (including arguments " @@ -1752,7 +1767,7 @@ msgid "" "number of flags for the interpreter." msgstr "" -#: ../src/Doc/reference/datamodel.rst:961 +#: reference/datamodel.rst:961 msgid "" "The following flag bits are defined for :attr:`co_flags`: bit ``0x04`` is " "set if the function uses the ``*arguments`` syntax to accept an arbitrary " @@ -1761,7 +1776,7 @@ msgid "" "set if the function is a generator." msgstr "" -#: ../src/Doc/reference/datamodel.rst:967 +#: reference/datamodel.rst:967 msgid "" "Future feature declarations (``from __future__ import division``) also use " "bits in :attr:`co_flags` to indicate whether a code object was compiled with " @@ -1770,29 +1785,29 @@ msgid "" "used in earlier versions of Python." msgstr "" -#: ../src/Doc/reference/datamodel.rst:973 +#: reference/datamodel.rst:973 msgid "Other bits in :attr:`co_flags` are reserved for internal use." msgstr "" -#: ../src/Doc/reference/datamodel.rst:977 +#: reference/datamodel.rst:977 msgid "" "If a code object represents a function, the first item in :attr:`co_consts` " "is the documentation string of the function, or ``None`` if undefined." msgstr "" # af1eff0271274124bb8f8853bc33107c -#: ../src/Doc/reference/datamodel.rst:1019 +#: reference/datamodel.rst:1020 msgid "Frame objects" msgstr "" -#: ../src/Doc/reference/datamodel.rst:985 +#: reference/datamodel.rst:985 msgid "" "Frame objects represent execution frames. They may occur in traceback " "objects (see below)." msgstr "" # be3d2a34f33247e4856f1714b2905d00 -#: ../src/Doc/reference/datamodel.rst:997 +#: reference/datamodel.rst:997 msgid "" "Special read-only attributes: :attr:`f_back` is to the previous stack frame " "(towards the caller), or ``None`` if this is the bottom stack frame; :attr:" @@ -1805,7 +1820,7 @@ msgid "" msgstr "" # c041e16dc50343de99def05fb2c579f7 -#: ../src/Doc/reference/datamodel.rst:1013 +#: reference/datamodel.rst:1013 msgid "" "Special writable attributes: :attr:`f_trace`, if not ``None``, is a function " "called at the start of each source code line (this is used by the " @@ -1819,12 +1834,12 @@ msgid "" msgstr "" # 853b4e93f4b84e1aaf1b12f20a42c778 -#: ../src/Doc/reference/datamodel.rst:1061 +#: reference/datamodel.rst:1062 msgid "Traceback objects" msgstr "" # 4480717a47194341b885c64f9167dcc5 -#: ../src/Doc/reference/datamodel.rst:1035 +#: reference/datamodel.rst:1035 msgid "" "Traceback objects represent a stack trace of an exception. A traceback " "object is created when an exception occurs. When the search for an " @@ -1840,7 +1855,7 @@ msgid "" "made available to the user as ``sys.last_traceback``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1055 +#: reference/datamodel.rst:1055 msgid "" "Special read-only attributes: :attr:`tb_next` is the next level in the stack " "trace (towards the frame where the exception occurred), or ``None`` if there " @@ -1853,12 +1868,12 @@ msgid "" msgstr "" # 99ac9d5a67cf40f69ef4429c229741ca -#: ../src/Doc/reference/datamodel.rst:1092 +#: reference/datamodel.rst:1093 msgid "Slice objects" msgstr "" # 37355ce77bbf4a64b86bb16d8911e325 -#: ../src/Doc/reference/datamodel.rst:1067 +#: reference/datamodel.rst:1067 msgid "" "Slice objects are used to represent slices when *extended slice syntax* is " "used. This is a slice using two colons, or multiple slices or ellipses " @@ -1867,19 +1882,19 @@ msgid "" msgstr "" # 06420b9e10e844b29739c809a8509b2e -#: ../src/Doc/reference/datamodel.rst:1077 +#: reference/datamodel.rst:1077 msgid "" "Special read-only attributes: :attr:`~slice.start` is the lower bound; :attr:" "`~slice.stop` is the upper bound; :attr:`~slice.step` is the step value; " "each is ``None`` if omitted. These attributes can have any type." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1081 +#: reference/datamodel.rst:1081 msgid "Slice objects support one method:" msgstr "" # 839309f9c5e04f518c1d21ce111d19ce -#: ../src/Doc/reference/datamodel.rst:1086 +#: reference/datamodel.rst:1086 msgid "" "This method takes a single integer argument *length* and computes " "information about the extended slice that the slice object would describe if " @@ -1890,11 +1905,11 @@ msgid "" msgstr "" # d896fb9f843b4e58b976e21917dbf786 -#: ../src/Doc/reference/datamodel.rst:1102 +#: reference/datamodel.rst:1103 msgid "Static method objects" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1096 +#: reference/datamodel.rst:1096 msgid "" "Static method objects provide a way of defeating the transformation of " "function objects to method objects described above. A static method object " @@ -1907,11 +1922,11 @@ msgid "" msgstr "" # 3546aa8801ef461cb18fb7ec7ee47246 -#: ../src/Doc/reference/datamodel.rst:1110 +#: reference/datamodel.rst:1111 msgid "Class method objects" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1106 +#: reference/datamodel.rst:1106 msgid "" "A class method object, like a static method object, is a wrapper around " "another object that alters the way in which that object is retrieved from " @@ -1921,19 +1936,19 @@ msgid "" msgstr "" # 2d2e9e0a92f44302a9d55f5d3a4fbd7f -#: ../src/Doc/reference/datamodel.rst:1116 +#: reference/datamodel.rst:1116 msgid "New-style and classic classes" msgstr "" # 464aba22ef074c8684326a27026dcac7 -#: ../src/Doc/reference/datamodel.rst:1118 +#: reference/datamodel.rst:1118 msgid "" "Classes and instances come in two flavors: old-style (or classic) and new-" "style." msgstr "" # ead43b87c3984ef0ade47c214f401004 -#: ../src/Doc/reference/datamodel.rst:1120 +#: reference/datamodel.rst:1120 msgid "" "Up to Python 2.1 the concept of ``class`` was unrelated to the concept of " "``type``, and old-style classes were the only flavor available. For an old-" @@ -1944,7 +1959,7 @@ msgid "" msgstr "" # 49857d7c8a474500a3ad2e3ff9b174b1 -#: ../src/Doc/reference/datamodel.rst:1127 +#: reference/datamodel.rst:1127 msgid "" "New-style classes were introduced in Python 2.2 to unify the concepts of " "``class`` and ``type``. A new-style class is simply a user-defined type, no " @@ -1955,7 +1970,7 @@ msgid "" msgstr "" # b504ee6568ec4e45aaad7cacb029e7a2 -#: ../src/Doc/reference/datamodel.rst:1134 +#: reference/datamodel.rst:1134 msgid "" "The major motivation for introducing new-style classes is to provide a " "unified object model with a full meta-model. It also has a number of " @@ -1964,7 +1979,7 @@ msgid "" msgstr "" # 62d422c0126f4b14a04d4730365e20ee -#: ../src/Doc/reference/datamodel.rst:1139 +#: reference/datamodel.rst:1139 msgid "" "For compatibility reasons, classes are still old-style by default. New-" "style classes are created by specifying another new-style class (i.e. a " @@ -1978,7 +1993,7 @@ msgid "" msgstr "" # 6e31a88eccdf42e6ae9956dc7f04d91f -#: ../src/Doc/reference/datamodel.rst:1149 +#: reference/datamodel.rst:1149 msgid "" "While this manual aims to provide comprehensive coverage of Python's class " "mechanics, it may still be lacking in some areas when it comes to its " @@ -1987,17 +2002,17 @@ msgid "" msgstr "" # ec4f36f5eda64e72ab32717f37fe29ca -#: ../src/Doc/reference/datamodel.rst:1159 +#: reference/datamodel.rst:1159 msgid "" "Old-style classes are removed in Python 3, leaving only new-style classes." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1165 +#: reference/datamodel.rst:1165 msgid "Special method names" msgstr "" # 741683aa1b024c12be5e353b012f20f8 -#: ../src/Doc/reference/datamodel.rst:1171 +#: reference/datamodel.rst:1171 msgid "" "A class can implement certain operations that are invoked by special syntax " "(such as arithmetic operations or subscripting and slicing) by defining " @@ -2013,7 +2028,7 @@ msgid "" msgstr "" # 13953edb87744504a6a2a3f440ba08fa -#: ../src/Doc/reference/datamodel.rst:1182 +#: reference/datamodel.rst:1182 msgid "" "When implementing a class that emulates any built-in type, it is important " "that the emulation only be implemented to the degree that it makes sense for " @@ -2023,11 +2038,11 @@ msgid "" "the W3C's Document Object Model.)" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1193 +#: reference/datamodel.rst:1193 msgid "Basic customization" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1199 +#: reference/datamodel.rst:1199 msgid "" "Called to create a new instance of class *cls*. :meth:`__new__` is a static " "method (special-cased so you need not declare it as such) that takes the " @@ -2037,7 +2052,7 @@ msgid "" "new object instance (usually an instance of *cls*)." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1206 +#: reference/datamodel.rst:1206 msgid "" "Typical implementations create a new instance of the class by invoking the " "superclass's :meth:`__new__` method using ``super(currentclass, cls)." @@ -2045,7 +2060,7 @@ msgid "" "newly-created instance as necessary before returning it." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1211 +#: reference/datamodel.rst:1211 msgid "" "If :meth:`__new__` returns an instance of *cls*, then the new instance's :" "meth:`__init__` method will be invoked like ``__init__(self[, ...])``, where " @@ -2053,13 +2068,13 @@ msgid "" "passed to :meth:`__new__`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1216 +#: reference/datamodel.rst:1216 msgid "" "If :meth:`__new__` does not return an instance of *cls*, then the new " "instance's :meth:`__init__` method will not be invoked." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1219 +#: reference/datamodel.rst:1219 msgid "" ":meth:`__new__` is intended mainly to allow subclasses of immutable types " "(like int, str, or tuple) to customize instance creation. It is also " @@ -2067,18 +2082,25 @@ msgid "" "creation." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1228 +#: reference/datamodel.rst:1228 msgid "" -"Called when the instance is created. The arguments are those passed to the " -"class constructor expression. If a base class has an :meth:`__init__` " -"method, the derived class's :meth:`__init__` method, if any, must explicitly " -"call it to ensure proper initialization of the base class part of the " -"instance; for example: ``BaseClass.__init__(self, [args...])``. As a " -"special constraint on constructors, no value may be returned; doing so will " -"cause a :exc:`TypeError` to be raised at runtime." +"Called after the instance has been created (by :meth:`__new__`), but before " +"it is returned to the caller. The arguments are those passed to the class " +"constructor expression. If a base class has an :meth:`__init__` method, the " +"derived class's :meth:`__init__` method, if any, must explicitly call it to " +"ensure proper initialization of the base class part of the instance; for " +"example: ``BaseClass.__init__(self, [args...])``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1243 +#: reference/datamodel.rst:1235 +msgid "" +"Because :meth:`__new__` and :meth:`__init__` work together in constructing " +"objects (:meth:`__new__` to create it, and :meth:`__init__` to customise " +"it), no non-``None`` value may be returned by :meth:`__init__`; doing so " +"will cause a :exc:`TypeError` to be raised at runtime." +msgstr "" + +#: reference/datamodel.rst:1247 msgid "" "Called when the instance is about to be destroyed. This is also called a " "destructor. If a base class has a :meth:`__del__` method, the derived " @@ -2092,7 +2114,7 @@ msgid "" msgstr "" # 51d154152b194ba79f78ed5891f9d132 -#: ../src/Doc/reference/datamodel.rst:1255 +#: reference/datamodel.rst:1259 msgid "" "``del x`` doesn't directly call ``x.__del__()`` --- the former decrements " "the reference count for ``x`` by one, and the latter is only called when " @@ -2114,7 +2136,7 @@ msgid "" "the cycle detector, particularly the description of the ``garbage`` value." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1277 +#: reference/datamodel.rst:1281 msgid "" "Due to the precarious circumstances under which :meth:`__del__` methods are " "invoked, exceptions that occur during their execution are ignored, and a " @@ -2132,12 +2154,12 @@ msgid "" msgstr "" # c3c48e91fc5447d88d17c444df592578 -#: ../src/Doc/reference/datamodel.rst:1292 +#: reference/datamodel.rst:1296 msgid "See also the :option:`-R` command-line option." msgstr "" # 184b540d42cd46a3a91e7d7f231cb67c -#: ../src/Doc/reference/datamodel.rst:1299 +#: reference/datamodel.rst:1303 msgid "" "Called by the :func:`repr` built-in function and by string conversions " "(reverse quotes) to compute the \"official\" string representation of an " @@ -2150,14 +2172,14 @@ msgid "" "representation of instances of that class is required." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1315 +#: reference/datamodel.rst:1319 msgid "" "This is typically used for debugging, so it is important that the " "representation is information-rich and unambiguous." msgstr "" # ffe2d0a7f02c443aaffd0551d40ce3ac -#: ../src/Doc/reference/datamodel.rst:1325 +#: reference/datamodel.rst:1329 msgid "" "Called by the :func:`str` built-in function and by the :keyword:`print` " "statement to compute the \"informal\" string representation of an object. " @@ -2167,7 +2189,7 @@ msgid "" msgstr "" # 4bad9fb0d17042bfb16b0b321dd77382 -#: ../src/Doc/reference/datamodel.rst:1344 +#: reference/datamodel.rst:1348 msgid "" "These are the so-called \"rich comparison\" methods, and are called for " "comparison operators in preference to :meth:`__cmp__` below. The " @@ -2177,7 +2199,7 @@ msgid "" "calls ``x.__gt__(y)``, and ``x>=y`` calls ``x.__ge__(y)``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1351 +#: reference/datamodel.rst:1355 msgid "" "A rich comparison method may return the singleton ``NotImplemented`` if it " "does not implement the operation for a given pair of arguments. By " @@ -2188,7 +2210,7 @@ msgid "" "result is true or false." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1358 +#: reference/datamodel.rst:1362 msgid "" "There are no implied relationships among the comparison operators. The truth " "of ``x==y`` does not imply that ``x!=y`` is false. Accordingly, when " @@ -2198,7 +2220,7 @@ msgid "" "custom comparison operations and are usable as dictionary keys." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1365 +#: reference/datamodel.rst:1369 msgid "" "There are no swapped-argument versions of these methods (to be used when the " "left argument does not support the operation but the right argument does); " @@ -2207,18 +2229,18 @@ msgid "" "and :meth:`__ne__` are their own reflection." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1371 +#: reference/datamodel.rst:1375 msgid "Arguments to rich comparison methods are never coerced." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1373 +#: reference/datamodel.rst:1377 msgid "" "To automatically generate ordering operations from a single root operation, " "see :func:`functools.total_ordering`." msgstr "" # 89078098bce54694bfcfbf6ac65d0e04 -#: ../src/Doc/reference/datamodel.rst:1382 +#: reference/datamodel.rst:1386 msgid "" "Called by comparison operations if rich comparison (see above) is not " "defined. Should return a negative integer if ``self < other``, zero if " @@ -2231,7 +2253,11 @@ msgid "" "propagated by :meth:`__cmp__` has been removed since Python 1.5.)" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1405 +#: reference/datamodel.rst:1399 +msgid "No longer supported." +msgstr "" + +#: reference/datamodel.rst:1409 msgid "" "Called by built-in function :func:`hash` and for operations on members of " "hashed collections including :class:`set`, :class:`frozenset`, and :class:" @@ -2243,7 +2269,7 @@ msgid "" msgstr "" # d279f990175f44fa81bc90bededd5ed8 -#: ../src/Doc/reference/datamodel.rst:1412 +#: reference/datamodel.rst:1416 msgid "" "If a class does not define a :meth:`__cmp__` or :meth:`__eq__` method it " "should not define a :meth:`__hash__` operation either; if it defines :meth:" @@ -2256,7 +2282,7 @@ msgid "" msgstr "" # 9956494f7d97416c938d995853e1df01 -#: ../src/Doc/reference/datamodel.rst:1421 +#: reference/datamodel.rst:1425 msgid "" "User-defined classes have :meth:`__cmp__` and :meth:`__hash__` methods by " "default; with them, all objects compare unequal (except with themselves) and " @@ -2264,7 +2290,7 @@ msgid "" msgstr "" # 4e1764779537414985c4e7369b110972 -#: ../src/Doc/reference/datamodel.rst:1425 +#: reference/datamodel.rst:1429 msgid "" "Classes which inherit a :meth:`__hash__` method from a parent class but " "change the meaning of :meth:`__cmp__` or :meth:`__eq__` such that the hash " @@ -2279,8 +2305,20 @@ msgid "" "`TypeError`)." msgstr "" +#: reference/datamodel.rst:1441 +msgid "" +":meth:`__hash__` may now also return a long integer object; the 32-bit " +"integer is then derived from the hash of that object." +msgstr "" + +#: reference/datamodel.rst:1445 +msgid "" +":attr:`__hash__` may now be set to :const:`None` to explicitly flag " +"instances of a class as unhashable." +msgstr "" + # e7970cc3bcb44b09a3a5b2f791734cce -#: ../src/Doc/reference/datamodel.rst:1450 +#: reference/datamodel.rst:1454 msgid "" "Called to implement truth value testing and the built-in operation " "``bool()``; should return ``False`` or ``True``, or their integer " @@ -2291,7 +2329,7 @@ msgid "" msgstr "" # 7620a0bd20a64f1fa12acb5ef0a09752 -#: ../src/Doc/reference/datamodel.rst:1462 +#: reference/datamodel.rst:1466 msgid "" "Called to implement :func:`unicode` built-in; should return a Unicode " "object. When this method is not defined, string conversion is attempted, and " @@ -2299,18 +2337,18 @@ msgid "" "default encoding." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1470 +#: reference/datamodel.rst:1474 msgid "Customizing attribute access" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1472 +#: reference/datamodel.rst:1476 msgid "" "The following methods can be defined to customize the meaning of attribute " "access (use of, assignment to, or deletion of ``x.name``) for class " "instances." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1478 +#: reference/datamodel.rst:1482 msgid "" "Called when an attribute lookup has not found the attribute in the usual " "places (i.e. it is not an instance attribute nor is it found in the class " @@ -2320,7 +2358,7 @@ msgid "" msgstr "" # 4317cc06ea1f41ef9f5df61a5bb32a25 -#: ../src/Doc/reference/datamodel.rst:1485 +#: reference/datamodel.rst:1489 msgid "" "Note that if the attribute is found through the normal mechanism, :meth:" "`__getattr__` is not called. (This is an intentional asymmetry between :" @@ -2334,7 +2372,7 @@ msgid "" msgstr "" # 08444342fb2b481886c4ed12e29ee22c -#: ../src/Doc/reference/datamodel.rst:1498 +#: reference/datamodel.rst:1502 msgid "" "Called when an attribute assignment is attempted. This is called instead of " "the normal mechanism (i.e. store the value in the instance dictionary). " @@ -2342,7 +2380,7 @@ msgid "" msgstr "" # a7ac1fb9524845e390c4e023e61efbfb -#: ../src/Doc/reference/datamodel.rst:1504 +#: reference/datamodel.rst:1508 msgid "" "If :meth:`__setattr__` wants to assign to an instance attribute, it should " "not simply execute ``self.name = value`` --- this would cause a recursive " @@ -2353,7 +2391,7 @@ msgid "" "__setattr__(self, name, value)``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1515 +#: reference/datamodel.rst:1519 msgid "" "Like :meth:`__setattr__` but for attribute deletion instead of assignment. " "This should only be implemented if ``del obj.name`` is meaningful for the " @@ -2361,16 +2399,16 @@ msgid "" msgstr "" # 1236f1cae41b42d9927bef9fd00ee0b5 -#: ../src/Doc/reference/datamodel.rst:1522 +#: reference/datamodel.rst:1526 msgid "More attribute access for new-style classes" msgstr "" # 0c64105a26fb462ea3a388b6ee2490b0 -#: ../src/Doc/reference/datamodel.rst:1524 +#: reference/datamodel.rst:1528 msgid "The following methods only apply to new-style classes." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1529 +#: reference/datamodel.rst:1533 msgid "" "Called unconditionally to implement attribute accesses for instances of the " "class. If the class also defines :meth:`__getattr__`, the latter will not be " @@ -2383,19 +2421,19 @@ msgid "" msgstr "" # eb73142efe63406faa42d8f574bece66 -#: ../src/Doc/reference/datamodel.rst:1540 +#: reference/datamodel.rst:1544 msgid "" "This method may still be bypassed when looking up special methods as the " "result of implicit invocation via language syntax or built-in functions. " "See :ref:`new-style-special-lookup`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1548 +#: reference/datamodel.rst:1552 msgid "Implementing Descriptors" msgstr "" # 6cc1116071a2463390cee6cb14744300 -#: ../src/Doc/reference/datamodel.rst:1550 +#: reference/datamodel.rst:1554 msgid "" "The following methods only apply when an instance of the class containing " "the method (a so-called *descriptor* class) appears in an *owner* class (the " @@ -2405,7 +2443,7 @@ msgid "" "owner class' :attr:`__dict__`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1560 +#: reference/datamodel.rst:1564 msgid "" "Called to get the attribute of the owner class (class attribute access) or " "of an instance of that class (instance attribute access). *owner* is always " @@ -2415,22 +2453,22 @@ msgid "" "an :exc:`AttributeError` exception." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1570 +#: reference/datamodel.rst:1574 msgid "" "Called to set the attribute on an instance *instance* of the owner class to " "a new value, *value*." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1576 +#: reference/datamodel.rst:1580 msgid "" "Called to delete the attribute on an instance *instance* of the owner class." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1582 +#: reference/datamodel.rst:1586 msgid "Invoking Descriptors" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1584 +#: reference/datamodel.rst:1588 msgid "" "In general, a descriptor is an object attribute with \"binding behavior\", " "one whose attribute access has been overridden by methods in the descriptor " @@ -2438,7 +2476,7 @@ msgid "" "of those methods are defined for an object, it is said to be a descriptor." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1589 +#: reference/datamodel.rst:1593 msgid "" "The default behavior for attribute access is to get, set, or delete the " "attribute from an object's dictionary. For instance, ``a.x`` has a lookup " @@ -2447,7 +2485,7 @@ msgid "" msgstr "" # 39dc5fdc1a1e401a8af3aa324764053c -#: ../src/Doc/reference/datamodel.rst:1594 +#: reference/datamodel.rst:1598 msgid "" "However, if the looked-up value is an object defining one of the descriptor " "methods, then Python may override the default behavior and invoke the " @@ -2457,54 +2495,54 @@ msgid "" "(ones that subclass :class:`object()` or :class:`type()`)." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1601 +#: reference/datamodel.rst:1605 msgid "" "The starting point for descriptor invocation is a binding, ``a.x``. How the " "arguments are assembled depends on ``a``:" msgstr "" # 791962457fbc46a6819506356b104b7f -#: ../src/Doc/reference/datamodel.rst:1605 +#: reference/datamodel.rst:1610 msgid "Direct Call" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1605 +#: reference/datamodel.rst:1609 msgid "" "The simplest and least common call is when user code directly invokes a " "descriptor method: ``x.__get__(a)``." msgstr "" # 2d6801b131824abc9a483e3ba3917449 -#: ../src/Doc/reference/datamodel.rst:1609 +#: reference/datamodel.rst:1614 msgid "Instance Binding" msgstr "" # 8082ea1c639643539581d7682955af0c -#: ../src/Doc/reference/datamodel.rst:1609 +#: reference/datamodel.rst:1613 msgid "" "If binding to a new-style object instance, ``a.x`` is transformed into the " "call: ``type(a).__dict__['x'].__get__(a, type(a))``." msgstr "" # 8fb2e41704a64ccca3a54c789e8d01fd -#: ../src/Doc/reference/datamodel.rst:1613 +#: reference/datamodel.rst:1618 msgid "Class Binding" msgstr "" # b11f2bbbebc04f8b9beef1693ea40218 -#: ../src/Doc/reference/datamodel.rst:1613 +#: reference/datamodel.rst:1617 msgid "" "If binding to a new-style class, ``A.x`` is transformed into the call: ``A." "__dict__['x'].__get__(None, A)``." msgstr "" # 4e5871e9a56d4456ae25aa9b04c80d74 -#: ../src/Doc/reference/datamodel.rst:1619 +#: reference/datamodel.rst:1624 msgid "Super Binding" msgstr "" # 415b17f3d1df4684bf21da7e6b531d23 -#: ../src/Doc/reference/datamodel.rst:1617 +#: reference/datamodel.rst:1621 msgid "" "If ``a`` is an instance of :class:`super`, then the binding ``super(B, obj)." "m()`` searches ``obj.__class__.__mro__`` for the base class ``A`` " @@ -2512,7 +2550,7 @@ msgid "" "``A.__dict__['m'].__get__(obj, obj.__class__)``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1622 +#: reference/datamodel.rst:1626 msgid "" "For instance bindings, the precedence of descriptor invocation depends on " "the which descriptor methods are defined. A descriptor can define any " @@ -2528,7 +2566,7 @@ msgid "" "contrast, non-data descriptors can be overridden by instances." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1635 +#: reference/datamodel.rst:1639 msgid "" "Python methods (including :func:`staticmethod` and :func:`classmethod`) are " "implemented as non-data descriptors. Accordingly, instances can redefine " @@ -2536,18 +2574,18 @@ msgid "" "that differ from other instances of the same class." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1640 +#: reference/datamodel.rst:1644 msgid "" "The :func:`property` function is implemented as a data descriptor. " "Accordingly, instances cannot override the behavior of a property." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1647 +#: reference/datamodel.rst:1651 msgid "__slots__" msgstr "" # fb9ddb1439534e77970246e402c44d8e -#: ../src/Doc/reference/datamodel.rst:1649 +#: reference/datamodel.rst:1653 msgid "" "By default, instances of both old and new-style classes have a dictionary " "for attribute storage. This wastes space for objects having very few " @@ -2556,7 +2594,7 @@ msgid "" msgstr "" # 16e1e403d60642ceb263bf8e828a0ed9 -#: ../src/Doc/reference/datamodel.rst:1654 +#: reference/datamodel.rst:1658 msgid "" "The default can be overridden by defining *__slots__* in a new-style class " "definition. The *__slots__* declaration takes a sequence of instance " @@ -2566,7 +2604,7 @@ msgid "" msgstr "" # f55365329de84904aa093e85b18f19aa -#: ../src/Doc/reference/datamodel.rst:1662 +#: reference/datamodel.rst:1666 msgid "" "This class variable can be assigned a string, iterable, or sequence of " "strings with variable names used by instances. If defined in a new-style " @@ -2574,18 +2612,18 @@ msgid "" "the automatic creation of *__dict__* and *__weakref__* for each instance." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1669 +#: reference/datamodel.rst:1673 msgid "Notes on using *__slots__*" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1671 +#: reference/datamodel.rst:1675 msgid "" "When inheriting from a class without *__slots__*, the *__dict__* attribute " "of that class will always be accessible, so a *__slots__* definition in the " "subclass is meaningless." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1675 +#: reference/datamodel.rst:1679 msgid "" "Without a *__dict__* variable, instances cannot be assigned new variables " "not listed in the *__slots__* definition. Attempts to assign to an unlisted " @@ -2594,7 +2632,14 @@ msgid "" "the *__slots__* declaration." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1686 +#: reference/datamodel.rst:1685 +msgid "" +"Previously, adding ``'__dict__'`` to the *__slots__* declaration would not " +"enable the assignment of new attributes not specifically listed in the " +"sequence of instance variable names." +msgstr "" + +#: reference/datamodel.rst:1690 msgid "" "Without a *__weakref__* variable for each instance, classes defining " "*__slots__* do not support weak references to its instances. If weak " @@ -2602,7 +2647,13 @@ msgid "" "strings in the *__slots__* declaration." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1695 +#: reference/datamodel.rst:1695 +msgid "" +"Previously, adding ``'__weakref__'`` to the *__slots__* declaration would " +"not enable support for weak references." +msgstr "" + +#: reference/datamodel.rst:1699 msgid "" "*__slots__* are implemented at the class level by creating descriptors (:ref:" "`descriptors`) for each variable name. As a result, class attributes cannot " @@ -2610,14 +2661,14 @@ msgid "" "otherwise, the class attribute would overwrite the descriptor assignment." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1701 +#: reference/datamodel.rst:1705 msgid "" "The action of a *__slots__* declaration is limited to the class where it is " "defined. As a result, subclasses will have a *__dict__* unless they also " "define *__slots__* (which must only contain names of any *additional* slots)." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1705 +#: reference/datamodel.rst:1709 msgid "" "If a class defines a slot also defined in a base class, the instance " "variable defined by the base class slot is inaccessible (except by " @@ -2627,30 +2678,36 @@ msgid "" msgstr "" # dc7b4dd05bab4cd69a788db1d00215f2 -#: ../src/Doc/reference/datamodel.rst:1710 +#: reference/datamodel.rst:1714 msgid "" "Nonempty *__slots__* does not work for classes derived from \"variable-length" "\" built-in types such as :class:`long`, :class:`str` and :class:`tuple`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1713 +#: reference/datamodel.rst:1717 msgid "" "Any non-string iterable may be assigned to *__slots__*. Mappings may also be " "used; however, in the future, special meaning may be assigned to the values " "corresponding to each key." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1717 +#: reference/datamodel.rst:1721 msgid "" "*__class__* assignment works only if both classes have the same *__slots__*." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1727 +#: reference/datamodel.rst:1723 +msgid "" +"Previously, *__class__* assignment raised an error if either new or old " +"class had *__slots__*." +msgstr "" + +#: reference/datamodel.rst:1731 msgid "Customizing class creation" msgstr "" # 8a59853150d2463aa3944ddabf46ae56 -#: ../src/Doc/reference/datamodel.rst:1729 +#: reference/datamodel.rst:1733 msgid "" "By default, new-style classes are constructed using :func:`type`. A class " "definition is read into a separate namespace and the value of class name is " @@ -2658,7 +2715,7 @@ msgid "" msgstr "" # aebc8a2a583f40c485a11857ab0ad224 -#: ../src/Doc/reference/datamodel.rst:1733 +#: reference/datamodel.rst:1737 msgid "" "When the class definition is read, if *__metaclass__* is defined then the " "callable assigned to it will be called instead of :func:`type`. This allows " @@ -2666,17 +2723,17 @@ msgid "" "process:" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1738 +#: reference/datamodel.rst:1742 msgid "Modifying the class dictionary prior to the class being created." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1740 +#: reference/datamodel.rst:1744 msgid "" "Returning an instance of another class -- essentially performing the role of " "a factory function." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1743 +#: reference/datamodel.rst:1747 msgid "" "These steps will have to be performed in the metaclass's :meth:`__new__` " "method -- :meth:`type.__new__` can then be called from this method to create " @@ -2684,7 +2741,7 @@ msgid "" "class dictionary before creating the class::" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1753 +#: reference/datamodel.rst:1757 msgid "" "You can of course also override other class methods (or add new methods); " "for example defining a custom :meth:`__call__` method in the metaclass " @@ -2693,41 +2750,41 @@ msgid "" msgstr "" # 5ee8452a0afe426199b5a089007e2f82 -#: ../src/Doc/reference/datamodel.rst:1760 +#: reference/datamodel.rst:1764 msgid "" "This variable can be any callable accepting arguments for ``name``, " "``bases``, and ``dict``. Upon class creation, the callable is used instead " "of the built-in :func:`type`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1766 +#: reference/datamodel.rst:1770 msgid "" "The appropriate metaclass is determined by the following precedence rules:" msgstr "" # 34368dacf4ab4ef1a8a3b6f9c6d3a634 -#: ../src/Doc/reference/datamodel.rst:1768 +#: reference/datamodel.rst:1772 msgid "If ``dict['__metaclass__']`` exists, it is used." msgstr "" # 5068274d573149b9a7d35afd4931deb6 -#: ../src/Doc/reference/datamodel.rst:1770 +#: reference/datamodel.rst:1774 msgid "" "Otherwise, if there is at least one base class, its metaclass is used (this " "looks for a *__class__* attribute first and if not found, uses its type)." msgstr "" # ba3069311ce94dddb2bb1a5fe9169524 -#: ../src/Doc/reference/datamodel.rst:1773 +#: reference/datamodel.rst:1777 msgid "Otherwise, if a global variable named __metaclass__ exists, it is used." msgstr "" # f728531b488a461ca86e4e6fca2c2739 -#: ../src/Doc/reference/datamodel.rst:1775 +#: reference/datamodel.rst:1779 msgid "Otherwise, the old-style, classic metaclass (types.ClassType) is used." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1777 +#: reference/datamodel.rst:1781 msgid "" "The potential uses for metaclasses are boundless. Some ideas that have been " "explored including logging, interface checking, automatic delegation, " @@ -2735,17 +2792,17 @@ msgid "" "locking/synchronization." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1784 +#: reference/datamodel.rst:1788 msgid "Customizing instance and subclass checks" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1788 +#: reference/datamodel.rst:1792 msgid "" "The following methods are used to override the default behavior of the :func:" "`isinstance` and :func:`issubclass` built-in functions." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1791 +#: reference/datamodel.rst:1795 msgid "" "In particular, the metaclass :class:`abc.ABCMeta` implements these methods " "in order to allow the addition of Abstract Base Classes (ABCs) as \"virtual " @@ -2753,21 +2810,21 @@ msgid "" "other ABCs." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1798 +#: reference/datamodel.rst:1802 msgid "" "Return true if *instance* should be considered a (direct or indirect) " "instance of *class*. If defined, called to implement ``isinstance(instance, " "class)``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1805 +#: reference/datamodel.rst:1809 msgid "" "Return true if *subclass* should be considered a (direct or indirect) " "subclass of *class*. If defined, called to implement ``issubclass(subclass, " "class)``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1810 +#: reference/datamodel.rst:1814 msgid "" "Note that these methods are looked up on the type (metaclass) of a class. " "They cannot be defined as class methods in the actual class. This is " @@ -2775,13 +2832,12 @@ msgid "" "only in this case the instance is itself a class." msgstr "" -# 5409455d49c44f6aa46db229145c95f8 -#: ../src/Doc/reference/datamodel.rst:1820 -msgid ":pep:`3119` - Introducing Abstract Base Classes" +#: reference/datamodel.rst:1825 +msgid "PEP 3119 - Introducing Abstract Base Classes" msgstr "" # 966728cc696b41b9b465d0843a51366f -#: ../src/Doc/reference/datamodel.rst:1818 +#: reference/datamodel.rst:1822 msgid "" "Includes the specification for customizing :func:`isinstance` and :func:" "`issubclass` behavior through :meth:`~class.__instancecheck__` and :meth:" @@ -2790,23 +2846,23 @@ msgid "" "language." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1828 +#: reference/datamodel.rst:1832 msgid "Emulating callable objects" msgstr "" -#: ../src/Doc/reference/datamodel.rst:1835 +#: reference/datamodel.rst:1839 msgid "" "Called when the instance is \"called\" as a function; if this method is " "defined, ``x(arg1, arg2, ...)`` is a shorthand for ``x.__call__(arg1, " "arg2, ...)``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1842 +#: reference/datamodel.rst:1846 msgid "Emulating container types" msgstr "" # 5c9c13b8b36c4566ae602ddb14bb511a -#: ../src/Doc/reference/datamodel.rst:1844 +#: reference/datamodel.rst:1848 msgid "" "The following methods can be defined to implement container objects. " "Containers usually are sequences (such as lists or tuples) or mappings (like " @@ -2843,7 +2899,7 @@ msgid "" msgstr "" # 58d0aa48446e415fabdb2b9bab54c733 -#: ../src/Doc/reference/datamodel.rst:1882 +#: reference/datamodel.rst:1886 msgid "" "Called to implement the built-in function :func:`len`. Should return the " "length of the object, an integer ``>=`` 0. Also, an object that doesn't " @@ -2851,7 +2907,7 @@ msgid "" "zero is considered to be false in a Boolean context." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1892 +#: reference/datamodel.rst:1896 msgid "" "Called to implement evaluation of ``self[key]``. For sequence types, the " "accepted keys should be integers and slice objects. Note that the special " @@ -2863,13 +2919,19 @@ msgid "" "*key* is missing (not in the container), :exc:`KeyError` should be raised." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1903 +#: reference/datamodel.rst:1907 msgid "" ":keyword:`for` loops expect that an :exc:`IndexError` will be raised for " "illegal indexes to allow proper detection of the end of the sequence." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1909 +#: reference/datamodel.rst:1913 +msgid "" +"Called by :class:`dict`\\ .\\ :meth:`__getitem__` to implement ``self[key]`` " +"for dict subclasses when key is not in the dictionary." +msgstr "" + +#: reference/datamodel.rst:1919 msgid "" "Called to implement assignment to ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -2878,7 +2940,7 @@ msgid "" "for improper *key* values as for the :meth:`__getitem__` method." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1918 +#: reference/datamodel.rst:1928 msgid "" "Called to implement deletion of ``self[key]``. Same note as for :meth:" "`__getitem__`. This should only be implemented for mappings if the objects " @@ -2888,7 +2950,7 @@ msgid "" msgstr "" # d776a23300384e969681d261a917d66c -#: ../src/Doc/reference/datamodel.rst:1927 +#: reference/datamodel.rst:1937 msgid "" "This method is called when an iterator is required for a container. This " "method should return a new iterator object that can iterate over all the " @@ -2897,21 +2959,21 @@ msgid "" "`iterkeys`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1932 +#: reference/datamodel.rst:1942 msgid "" "Iterator objects also need to implement this method; they are required to " "return themselves. For more information on iterator objects, see :ref:" "`typeiter`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1938 +#: reference/datamodel.rst:1948 msgid "" "Called (if present) by the :func:`reversed` built-in to implement reverse " "iteration. It should return a new iterator object that iterates over all " "the objects in the container in reverse order." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1942 +#: reference/datamodel.rst:1952 msgid "" "If the :meth:`__reversed__` method is not provided, the :func:`reversed` " "built-in will fall back to using the sequence protocol (:meth:`__len__` and :" @@ -2920,7 +2982,7 @@ msgid "" "more efficient than the one provided by :func:`reversed`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1951 +#: reference/datamodel.rst:1961 msgid "" "The membership test operators (:keyword:`in` and :keyword:`not in`) are " "normally implemented as an iteration through a sequence. However, container " @@ -2928,14 +2990,14 @@ msgid "" "implementation, which also does not require the object be a sequence." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1958 +#: reference/datamodel.rst:1968 msgid "" "Called to implement membership test operators. Should return true if *item* " "is in *self*, false otherwise. For mapping objects, this should consider " "the keys of the mapping rather than the values or the key-item pairs." msgstr "" -#: ../src/Doc/reference/datamodel.rst:1962 +#: reference/datamodel.rst:1972 msgid "" "For objects that don't define :meth:`__contains__`, the membership test " "first tries iteration via :meth:`__iter__`, then the old sequence iteration " @@ -2944,24 +3006,31 @@ msgid "" msgstr "" # 3d7fa5f8988d43cc930418ddbad65e61 -#: ../src/Doc/reference/datamodel.rst:1971 +#: reference/datamodel.rst:1981 msgid "Additional methods for emulation of sequence types" msgstr "" # 9414f18204834e50985ff13a2eee94dd -#: ../src/Doc/reference/datamodel.rst:1973 +#: reference/datamodel.rst:1983 msgid "" "The following optional methods can be defined to further emulate sequence " "objects. Immutable sequences methods should at most only define :meth:" "`__getslice__`; mutable sequences might define all three methods." msgstr "" -# 628f9f9d8fb145fcbad0b145c0032c88 -#: ../src/Doc/reference/datamodel.rst:1986 +#: reference/datamodel.rst:1990 +msgid "" +"Support slice objects as parameters to the :meth:`__getitem__` method. " +"(However, built-in types in CPython currently still implement :meth:" +"`__getslice__`. Therefore, you have to override it in derived classes when " +"implementing slicing.)" +msgstr "" + +#: reference/datamodel.rst:1996 msgid "" "Called to implement evaluation of ``self[i:j]``. The returned object should " "be of the same type as *self*. Note that missing *i* or *j* in the slice " -"expression are replaced by zero or ``sys.maxint``, respectively. If " +"expression are replaced by zero or :attr:`sys.maxsize`, respectively. If " "negative indexes are used in the slice, the length of the sequence is added " "to that index. If the instance does not implement the :meth:`__len__` " "method, an :exc:`AttributeError` is raised. No guarantee is made that " @@ -2972,14 +3041,14 @@ msgid "" msgstr "" # 5dc969ce612f462d86bced1d7f91f5f9 -#: ../src/Doc/reference/datamodel.rst:1999 +#: reference/datamodel.rst:2009 msgid "" "Called to implement assignment to ``self[i:j]``. Same notes for *i* and *j* " "as for :meth:`__getslice__`." msgstr "" # 2ceac16d45764d3db00e8b5a93dd2a23 -#: ../src/Doc/reference/datamodel.rst:2002 +#: reference/datamodel.rst:2012 msgid "" "This method is deprecated. If no :meth:`__setslice__` is found, or for " "extended slicing of the form ``self[i:j:k]``, a slice object is created, and " @@ -2987,7 +3056,7 @@ msgid "" msgstr "" # 539063f8e39c468b916f9e35318c9eee -#: ../src/Doc/reference/datamodel.rst:2009 +#: reference/datamodel.rst:2019 msgid "" "Called to implement deletion of ``self[i:j]``. Same notes for *i* and *j* as " "for :meth:`__getslice__`. This method is deprecated. If no :meth:" @@ -2997,7 +3066,7 @@ msgid "" msgstr "" # 6501ab8964524d77bdbdd0ad77e05882 -#: ../src/Doc/reference/datamodel.rst:2015 +#: reference/datamodel.rst:2025 msgid "" "Notice that these methods are only invoked when a single slice with a single " "colon is used, and the slice method is available. For slice operations " @@ -3007,7 +3076,7 @@ msgid "" msgstr "" # baff99a67aca41c087c9fa9c5a223377 -#: ../src/Doc/reference/datamodel.rst:2021 +#: reference/datamodel.rst:2031 msgid "" "The following example demonstrate how to make your program or module " "compatible with earlier versions of Python (assuming that methods :meth:" @@ -3016,7 +3085,7 @@ msgid "" msgstr "" # 00323b6bef59471c9ccf83f4275743f7 -#: ../src/Doc/reference/datamodel.rst:2046 +#: reference/datamodel.rst:2056 msgid "" "Note the calls to :func:`max`; these are necessary because of the handling " "of negative indices before the :meth:`__\\*slice__` methods are called. " @@ -3032,11 +3101,11 @@ msgid "" "``max(0, i)`` conveniently returns the proper value." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2063 +#: reference/datamodel.rst:2073 msgid "Emulating numeric types" msgstr "" -#: ../src/Doc/reference/datamodel.rst:2065 +#: reference/datamodel.rst:2075 msgid "" "The following methods can be defined to emulate numeric objects. Methods " "corresponding to operations that are not supported by the particular kind of " @@ -3045,7 +3114,7 @@ msgid "" msgstr "" # 4265f19c2e9f44a48f87944096ee370b -#: ../src/Doc/reference/datamodel.rst:2089 +#: reference/datamodel.rst:2099 msgid "" "These methods are called to implement the binary arithmetic operations (``" "+``, ``-``, ``*``, ``//``, ``%``, :func:`divmod`, :func:`pow`, ``**``, " @@ -3059,14 +3128,14 @@ msgid "" "supported." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2099 +#: reference/datamodel.rst:2109 msgid "" "If one of those methods does not support the operation with the supplied " "arguments, it should return ``NotImplemented``." msgstr "" # 44c82acc98d34e6d841a52b50acf8b8f -#: ../src/Doc/reference/datamodel.rst:2106 +#: reference/datamodel.rst:2116 msgid "" "The division operator (``/``) is implemented by these methods. The :meth:" "`__truediv__` method is used when ``__future__.division`` is in effect, " @@ -3076,7 +3145,7 @@ msgid "" msgstr "" # 05791f7a331649bb85b95596fad9c68e -#: ../src/Doc/reference/datamodel.rst:2132 +#: reference/datamodel.rst:2142 msgid "" "These methods are called to implement the binary arithmetic operations (``" "+``, ``-``, ``*``, ``/``, ``%``, :func:`divmod`, :func:`pow`, ``**``, " @@ -3088,13 +3157,13 @@ msgid "" "``x.__sub__(y)`` returns *NotImplemented*." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2143 +#: reference/datamodel.rst:2153 msgid "" "Note that ternary :func:`pow` will not try calling :meth:`__rpow__` (the " "coercion rules would become too complicated)." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2148 +#: reference/datamodel.rst:2158 msgid "" "If the right operand's type is a subclass of the left operand's type and " "that subclass provides the reflected method for the operation, this method " @@ -3102,7 +3171,7 @@ msgid "" "behavior allows subclasses to override their ancestors' operations." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2168 +#: reference/datamodel.rst:2178 msgid "" "These methods are called to implement the augmented arithmetic assignments " "(``+=``, ``-=``, ``*=``, ``/=``, ``//=``, ``%=``, ``**=``, ``<<=``, ``>>=``, " @@ -3116,14 +3185,14 @@ msgid "" "``y.__radd__(x)`` are considered, as with the evaluation of ``x + y``." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2187 +#: reference/datamodel.rst:2197 msgid "" "Called to implement the unary arithmetic operations (``-``, ``+``, :func:" "`abs` and ``~``)." msgstr "" # 8ebc9f0008e8478caaceec22e237d883 -#: ../src/Doc/reference/datamodel.rst:2202 +#: reference/datamodel.rst:2212 msgid "" "Called to implement the built-in functions :func:`complex`, :func:`int`, :" "func:`long`, and :func:`float`. Should return a value of the appropriate " @@ -3131,14 +3200,14 @@ msgid "" msgstr "" # 9654d41c62b340698df01b836c95ca87 -#: ../src/Doc/reference/datamodel.rst:2213 +#: reference/datamodel.rst:2223 msgid "" "Called to implement the built-in functions :func:`oct` and :func:`hex`. " "Should return a string value." msgstr "" # 16f0e452531f40ef826b5652187c80bd -#: ../src/Doc/reference/datamodel.rst:2219 +#: reference/datamodel.rst:2229 msgid "" "Called to implement :func:`operator.index`. Also called whenever Python " "needs an integer object (such as in slicing). Must return an integer (int " @@ -3146,7 +3215,7 @@ msgid "" msgstr "" # 0407a397fd9141d6ad6e574c5111a8c9 -#: ../src/Doc/reference/datamodel.rst:2227 +#: reference/datamodel.rst:2237 msgid "" "Called to implement \"mixed-mode\" numeric arithmetic. Should either return " "a 2-tuple containing *self* and *other* converted to a common numeric type, " @@ -3159,12 +3228,12 @@ msgid "" msgstr "" # a92f5776ccdc4dafbf7e804397d127bb -#: ../src/Doc/reference/datamodel.rst:2240 +#: reference/datamodel.rst:2250 msgid "Coercion rules" msgstr "" # f8c556de1a1e4b00b582dfc467d0fb0c -#: ../src/Doc/reference/datamodel.rst:2242 +#: reference/datamodel.rst:2252 msgid "" "This section used to document the rules for coercion. As the language has " "evolved, the coercion rules have become hard to document precisely; " @@ -3174,14 +3243,14 @@ msgid "" msgstr "" # a97baf0a668f458685ca63b223d11c16 -#: ../src/Doc/reference/datamodel.rst:2250 +#: reference/datamodel.rst:2260 msgid "" "If the left operand of a % operator is a string or Unicode object, no " "coercion takes place and the string formatting operation is invoked instead." msgstr "" # 97af11f293c142adaa05c7ef10070394 -#: ../src/Doc/reference/datamodel.rst:2255 +#: reference/datamodel.rst:2265 msgid "" "It is no longer recommended to define a coercion operation. Mixed-mode " "operations on types that don't define coercion pass the original arguments " @@ -3189,7 +3258,7 @@ msgid "" msgstr "" # 17c58a26ab4a4587bc8ad82757becbf8 -#: ../src/Doc/reference/datamodel.rst:2261 +#: reference/datamodel.rst:2271 msgid "" "New-style classes (those derived from :class:`object`) never invoke the :" "meth:`__coerce__` method in response to a binary operator; the only time :" @@ -3198,14 +3267,14 @@ msgid "" msgstr "" # d05bfdfd62ef4e7d87c05840551ae552 -#: ../src/Doc/reference/datamodel.rst:2268 +#: reference/datamodel.rst:2278 msgid "" "For most intents and purposes, an operator that returns ``NotImplemented`` " "is treated the same as one that is not implemented at all." msgstr "" # ce20b72493b84e9d927eae25e0bbc9a0 -#: ../src/Doc/reference/datamodel.rst:2273 +#: reference/datamodel.rst:2283 msgid "" "Below, :meth:`__op__` and :meth:`__rop__` are used to signify the generic " "method names corresponding to an operator; :meth:`__iop__` is used for the " @@ -3215,7 +3284,7 @@ msgid "" msgstr "" # b84d21055ea64520951c713d188cb7ff -#: ../src/Doc/reference/datamodel.rst:2281 +#: reference/datamodel.rst:2291 msgid "" "For objects *x* and *y*, first ``x.__op__(y)`` is tried. If this is not " "implemented or returns ``NotImplemented``, ``y.__rop__(x)`` is tried. If " @@ -3224,7 +3293,7 @@ msgid "" msgstr "" # 0de15c1e7dea4ebeb56f95c2bb6b19e8 -#: ../src/Doc/reference/datamodel.rst:2288 +#: reference/datamodel.rst:2298 msgid "" "Exception to the previous item: if the left operand is an instance of a " "built-in type or a new-style class, and the right operand is an instance of " @@ -3234,7 +3303,7 @@ msgid "" msgstr "" # cd5ec3fb61e549d4b2abd43e3569e80e -#: ../src/Doc/reference/datamodel.rst:2294 +#: reference/datamodel.rst:2304 msgid "" "This is done so that a subclass can completely override binary operators. " "Otherwise, the left operand's :meth:`__op__` method would always accept the " @@ -3243,7 +3312,7 @@ msgid "" msgstr "" # 6a2b90363c554de59ebb6a0d2d708475 -#: ../src/Doc/reference/datamodel.rst:2301 +#: reference/datamodel.rst:2311 msgid "" "When either operand type defines a coercion, this coercion is called before " "that type's :meth:`__op__` or :meth:`__rop__` method is called, but no " @@ -3253,7 +3322,7 @@ msgid "" msgstr "" # 4e54e239271247129b335391b8e537f7 -#: ../src/Doc/reference/datamodel.rst:2308 +#: reference/datamodel.rst:2318 msgid "" "When an in-place operator (like '``+=``') is used, if the left operand " "implements :meth:`__iop__`, it is invoked without any coercion. When the " @@ -3262,14 +3331,14 @@ msgid "" msgstr "" # 77caaacbd18948928d4383fead02cae5 -#: ../src/Doc/reference/datamodel.rst:2315 +#: reference/datamodel.rst:2325 msgid "" "In ``x + y``, if *x* is a sequence that implements sequence concatenation, " "sequence concatenation is invoked." msgstr "" # 1df27958a51b42a3a913854470eed516 -#: ../src/Doc/reference/datamodel.rst:2320 +#: reference/datamodel.rst:2330 msgid "" "In ``x * y``, if one operand is a sequence that implements sequence " "repetition, and the other is an integer (:class:`int` or :class:`long`), " @@ -3277,7 +3346,7 @@ msgid "" msgstr "" # dbc39f871be5428a8f3e0a0c2a9ce179 -#: ../src/Doc/reference/datamodel.rst:2326 +#: reference/datamodel.rst:2336 msgid "" "Rich comparisons (implemented by methods :meth:`__eq__` and so on) never use " "coercion. Three-way comparison (implemented by :meth:`__cmp__`) does use " @@ -3285,7 +3354,7 @@ msgid "" msgstr "" # 65631189edb64f578e237ea1fe351615 -#: ../src/Doc/reference/datamodel.rst:2332 +#: reference/datamodel.rst:2342 msgid "" "In the current implementation, the built-in numeric types :class:`int`, :" "class:`long`, :class:`float`, and :class:`complex` do not use coercion. All " @@ -3293,11 +3362,17 @@ msgid "" "func:`coerce` function." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2346 +#: reference/datamodel.rst:2349 +msgid "" +"The complex type no longer makes implicit calls to the :meth:`__coerce__` " +"method for mixed-type binary arithmetic operations." +msgstr "" + +#: reference/datamodel.rst:2356 msgid "With Statement Context Managers" msgstr "" -#: ../src/Doc/reference/datamodel.rst:2350 +#: reference/datamodel.rst:2360 msgid "" "A :dfn:`context manager` is an object that defines the runtime context to be " "established when executing a :keyword:`with` statement. The context manager " @@ -3307,32 +3382,32 @@ msgid "" "can also be used by directly invoking their methods." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2361 +#: reference/datamodel.rst:2371 msgid "" "Typical uses of context managers include saving and restoring various kinds " "of global state, locking and unlocking resources, closing opened files, etc." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2364 +#: reference/datamodel.rst:2374 msgid "" "For more information on context managers, see :ref:`typecontextmanager`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2369 +#: reference/datamodel.rst:2379 msgid "" "Enter the runtime context related to this object. The :keyword:`with` " "statement will bind this method's return value to the target(s) specified in " "the :keyword:`as` clause of the statement, if any." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2376 +#: reference/datamodel.rst:2386 msgid "" "Exit the runtime context related to this object. The parameters describe the " "exception that caused the context to be exited. If the context was exited " "without an exception, all three arguments will be :const:`None`." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2380 +#: reference/datamodel.rst:2390 msgid "" "If an exception is supplied, and the method wishes to suppress the exception " "(i.e., prevent it from being propagated), it should return a true value. " @@ -3340,19 +3415,19 @@ msgid "" "method." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2384 +#: reference/datamodel.rst:2394 msgid "" "Note that :meth:`__exit__` methods should not reraise the passed-in " "exception; this is the caller's responsibility." msgstr "" # 692b1a3a88b54eb18ceb185f0e907d31 -#: ../src/Doc/reference/datamodel.rst:2398 +#: reference/datamodel.rst:2408 msgid "Special method lookup for old-style classes" msgstr "" # d0fddf834c964e51b96ca8af880a273b -#: ../src/Doc/reference/datamodel.rst:2400 +#: reference/datamodel.rst:2410 msgid "" "For old-style classes, special methods are always looked up in exactly the " "same way as any other method or attribute. This is the case regardless of " @@ -3361,7 +3436,7 @@ msgid "" msgstr "" # 05100636e81d41ed8e80f9eb97377b23 -#: ../src/Doc/reference/datamodel.rst:2405 +#: reference/datamodel.rst:2415 msgid "" "This behaviour means that special methods may exhibit different behaviour " "for different instances of a single old-style class if the appropriate " @@ -3369,12 +3444,12 @@ msgid "" msgstr "" # 876ddc85b1ef4bbf8e40b4613a1a3c67 -#: ../src/Doc/reference/datamodel.rst:2425 +#: reference/datamodel.rst:2435 msgid "Special method lookup for new-style classes" msgstr "" # ded1504e42af4a3caa8b906da81b44a0 -#: ../src/Doc/reference/datamodel.rst:2427 +#: reference/datamodel.rst:2437 msgid "" "For new-style classes, implicit invocations of special methods are only " "guaranteed to work correctly if defined on an object's type, not in the " @@ -3383,7 +3458,7 @@ msgid "" "style classes)::" msgstr "" -#: ../src/Doc/reference/datamodel.rst:2442 +#: reference/datamodel.rst:2452 msgid "" "The rationale behind this behaviour lies with a number of special methods " "such as :meth:`__hash__` and :meth:`__repr__` that are implemented by all " @@ -3392,21 +3467,21 @@ msgid "" "type object itself::" msgstr "" -#: ../src/Doc/reference/datamodel.rst:2455 +#: reference/datamodel.rst:2465 msgid "" "Incorrectly attempting to invoke an unbound method of a class in this way is " "sometimes referred to as 'metaclass confusion', and is avoided by bypassing " "the instance when looking up special methods::" msgstr "" -#: ../src/Doc/reference/datamodel.rst:2464 +#: reference/datamodel.rst:2474 msgid "" "In addition to bypassing any instance attributes in the interest of " "correctness, implicit special method lookup generally also bypasses the :" "meth:`__getattribute__` method even of the object's metaclass::" msgstr "" -#: ../src/Doc/reference/datamodel.rst:2491 +#: reference/datamodel.rst:2501 msgid "" "Bypassing the :meth:`__getattribute__` machinery in this fashion provides " "significant scope for speed optimisations within the interpreter, at the " @@ -3415,29 +3490,29 @@ msgid "" "invoked by the interpreter)." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2500 +#: reference/datamodel.rst:2510 msgid "" "It *is* possible in some cases to change an object's type, under certain " "controlled conditions. It generally isn't a good idea though, since it can " "lead to some very strange behaviour if it is handled incorrectly." msgstr "" -#: ../src/Doc/reference/datamodel.rst:2504 +#: reference/datamodel.rst:2514 msgid "" "For operands of the same type, it is assumed that if the non-reflected " "method (such as :meth:`__add__`) fails the operation is not supported, which " "is why the reflected method is not called." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:6 +#: reference/executionmodel.rst:6 msgid "Execution model" msgstr "" -#: ../src/Doc/reference/executionmodel.rst:14 +#: reference/executionmodel.rst:14 msgid "Naming and binding" msgstr "" -#: ../src/Doc/reference/executionmodel.rst:25 +#: reference/executionmodel.rst:25 msgid "" ":dfn:`Names` refer to objects. Names are introduced by name binding " "operations. Each occurrence of a name in the program text refers to the :dfn:" @@ -3446,7 +3521,7 @@ msgid "" msgstr "" # cec92eb2e2834fd0b03995a900626586 -#: ../src/Doc/reference/executionmodel.rst:31 +#: reference/executionmodel.rst:31 msgid "" "A :dfn:`block` is a piece of Python program text that is executed as a unit. " "The following are blocks: a module, a function body, and a class definition. " @@ -3460,7 +3535,7 @@ msgid "" "read and evaluated by the built-in function :func:`input` is a code block." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:44 +#: reference/executionmodel.rst:44 msgid "" "A code block is executed in an :dfn:`execution frame`. A frame contains " "some administrative information (used for debugging) and determines where " @@ -3468,7 +3543,7 @@ msgid "" msgstr "" # 23ac712afda940bc871b2ebf5923961a -#: ../src/Doc/reference/executionmodel.rst:50 +#: reference/executionmodel.rst:50 msgid "" "A :dfn:`scope` defines the visibility of a name within a block. If a local " "variable is defined in a block, its scope includes that block. If the " @@ -3480,7 +3555,7 @@ msgid "" "using a function scope. This means that the following will fail::" msgstr "" -#: ../src/Doc/reference/executionmodel.rst:65 +#: reference/executionmodel.rst:65 msgid "" "When a name is used in a code block, it is resolved using the nearest " "enclosing scope. The set of all such scopes visible to a code block is " @@ -3488,7 +3563,7 @@ msgid "" msgstr "" # 93b6b83e3b5342d9abce9bd3f68fb2cc -#: ../src/Doc/reference/executionmodel.rst:71 +#: reference/executionmodel.rst:71 msgid "" "If a name is bound in a block, it is a local variable of that block. If a " "name is bound at the module level, it is a global variable. (The variables " @@ -3496,7 +3571,7 @@ msgid "" "code block but not defined there, it is a :dfn:`free variable`." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:80 +#: reference/executionmodel.rst:80 msgid "" "When a name is not found at all, a :exc:`NameError` exception is raised. If " "the name refers to a local variable that has not been bound, a :exc:" @@ -3505,7 +3580,7 @@ msgid "" msgstr "" # 802f0d5a5f3643f38f936a57b1f813d7 -#: ../src/Doc/reference/executionmodel.rst:87 +#: reference/executionmodel.rst:87 msgid "" "The following constructs bind names: formal parameters to functions, :" "keyword:`import` statements, class and function definitions (these bind the " @@ -3518,7 +3593,7 @@ msgid "" "the module level." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:97 +#: reference/executionmodel.rst:97 msgid "" "A target occurring in a :keyword:`del` statement is also considered bound " "for this purpose (though the actual semantics are to unbind the name). It " @@ -3526,14 +3601,14 @@ msgid "" "compiler will report a :exc:`SyntaxError`." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:102 +#: reference/executionmodel.rst:102 msgid "" "Each assignment or import statement occurs within a block defined by a class " "or function definition or at the module level (the top-level code block)." msgstr "" # f5c5cd32d9eb4772a62141e24ed0158c -#: ../src/Doc/reference/executionmodel.rst:105 +#: reference/executionmodel.rst:105 msgid "" "If a name binding operation occurs anywhere within a code block, all uses of " "the name within the block are treated as references to the current block. " @@ -3545,7 +3620,7 @@ msgid "" msgstr "" # f96027d05740419eb8fc9546f6e9b59e -#: ../src/Doc/reference/executionmodel.rst:112 +#: reference/executionmodel.rst:112 msgid "" "If the global statement occurs within a block, all uses of the name " "specified in the statement refer to the binding of that name in the top-" @@ -3558,7 +3633,7 @@ msgid "" msgstr "" # 3bbf40f1ee6e47459fab23786780946a -#: ../src/Doc/reference/executionmodel.rst:122 +#: reference/executionmodel.rst:122 msgid "" "The builtins namespace associated with the execution of a code block is " "actually found by looking up the name ``__builtins__`` in its global " @@ -3572,7 +3647,7 @@ msgid "" msgstr "" # fc5d705c84024404ad999c572826ad0b -#: ../src/Doc/reference/executionmodel.rst:133 +#: reference/executionmodel.rst:133 msgid "" "Users should not touch ``__builtins__``; it is strictly an implementation " "detail. Users wanting to override values in the builtins namespace should :" @@ -3580,14 +3655,14 @@ msgid "" "attributes appropriately." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:140 +#: reference/executionmodel.rst:140 msgid "" "The namespace for a module is automatically created the first time a module " "is imported. The main module for a script is always called :mod:`__main__`." msgstr "" # 0e16b14a4dfb44339ed0248e5bd28bdd -#: ../src/Doc/reference/executionmodel.rst:143 +#: reference/executionmodel.rst:143 msgid "" "The :keyword:`global` statement has the same scope as a name binding " "operation in the same block. If the nearest enclosing scope for a free " @@ -3596,7 +3671,7 @@ msgid "" msgstr "" # f7fe3ca80d2d46678a74fd7a6e28969b -#: ../src/Doc/reference/executionmodel.rst:147 +#: reference/executionmodel.rst:147 msgid "" "A class definition is an executable statement that may use and define names. " "These references follow the normal rules for name resolution. The namespace " @@ -3604,23 +3679,23 @@ msgid "" "Names defined at the class scope are not visible in methods." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:156 +#: reference/executionmodel.rst:156 msgid "Interaction with dynamic features" msgstr "" -#: ../src/Doc/reference/executionmodel.rst:158 +#: reference/executionmodel.rst:158 msgid "" "There are several cases where Python statements are illegal when used in " "conjunction with nested scopes that contain free variables." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:161 +#: reference/executionmodel.rst:161 msgid "" "If a variable is referenced in an enclosing scope, it is illegal to delete " "the name. An error will be reported at compile time." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:164 +#: reference/executionmodel.rst:164 msgid "" "If the wild card form of import --- ``import *`` --- is used in a function " "and the function contains or is a nested block with free variables, the " @@ -3628,7 +3703,7 @@ msgid "" msgstr "" # 195cf69d11384762ab7cedaef3849a7b -#: ../src/Doc/reference/executionmodel.rst:168 +#: reference/executionmodel.rst:168 msgid "" "If :keyword:`exec` is used in a function and the function contains or is a " "nested block with free variables, the compiler will raise a :exc:" @@ -3638,7 +3713,7 @@ msgid "" msgstr "" # e9eee13480c8427880a83afd2d0b5f18 -#: ../src/Doc/reference/executionmodel.rst:174 +#: reference/executionmodel.rst:174 msgid "" "The :func:`eval`, :func:`execfile`, and :func:`input` functions and the :" "keyword:`exec` statement do not have access to the full environment for " @@ -3650,11 +3725,11 @@ msgid "" "specified, it is used for both." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:187 +#: reference/executionmodel.rst:187 msgid "Exceptions" msgstr "Exceptions" -#: ../src/Doc/reference/executionmodel.rst:198 +#: reference/executionmodel.rst:198 msgid "" "Exceptions are a means of breaking out of the normal flow of control of a " "code block in order to handle errors or other exceptional conditions. An " @@ -3663,7 +3738,7 @@ msgid "" "or indirectly invoked the code block where the error occurred." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:204 +#: reference/executionmodel.rst:204 msgid "" "The Python interpreter raises an exception when it detects a run-time error " "(such as division by zero). A Python program can also explicitly raise an " @@ -3674,7 +3749,7 @@ msgid "" "exception occurred or not in the preceding code." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:214 +#: reference/executionmodel.rst:214 msgid "" "Python uses the \"termination\" model of error handling: an exception " "handler can find out what happened and continue execution at an outer level, " @@ -3683,7 +3758,7 @@ msgid "" msgstr "" # 98f1a55ea95543a3915a419417426286 -#: ../src/Doc/reference/executionmodel.rst:221 +#: reference/executionmodel.rst:221 msgid "" "When an exception is not handled at all, the interpreter terminates " "execution of the program, or returns to its interactive main loop. In " @@ -3691,7 +3766,7 @@ msgid "" "`SystemExit`." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:225 +#: reference/executionmodel.rst:225 msgid "" "Exceptions are identified by class instances. The :keyword:`except` clause " "is selected depending on the class of the instance: it must reference the " @@ -3701,7 +3776,7 @@ msgid "" msgstr "" # 1f209d2d3ab7466889a2f6789ebf6b6d -#: ../src/Doc/reference/executionmodel.rst:230 +#: reference/executionmodel.rst:230 msgid "" "Exceptions can also be identified by strings, in which case the :keyword:" "`except` clause is selected by object identity. An arbitrary value can be " @@ -3709,7 +3784,7 @@ msgid "" msgstr "" # a89d153c5ae444b0b68c1abbf82b57c5 -#: ../src/Doc/reference/executionmodel.rst:236 +#: reference/executionmodel.rst:236 msgid "" "Messages to exceptions are not part of the Python API. Their contents may " "change from one version of Python to the next without warning and should not " @@ -3717,46 +3792,46 @@ msgid "" "interpreter." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:240 +#: reference/executionmodel.rst:240 msgid "" "See also the description of the :keyword:`try` statement in section :ref:" "`try` and :keyword:`raise` statement in section :ref:`raise`." msgstr "" -#: ../src/Doc/reference/executionmodel.rst:245 +#: reference/executionmodel.rst:245 msgid "" "This limitation occurs because the code that is executed by these operations " "is not available at the time the module is compiled." msgstr "" -#: ../src/Doc/reference/expressions.rst:6 +#: reference/expressions.rst:6 msgid "Expressions" msgstr "" -#: ../src/Doc/reference/expressions.rst:10 +#: reference/expressions.rst:10 msgid "" "This chapter explains the meaning of the elements of expressions in Python." msgstr "" -#: ../src/Doc/reference/expressions.rst:14 +#: reference/expressions.rst:14 msgid "" "**Syntax Notes:** In this and the following chapters, extended BNF notation " "will be used to describe syntax, not lexical analysis. When (one " "alternative of) a syntax rule has the form" msgstr "" -#: ../src/Doc/reference/expressions.rst:23 +#: reference/expressions.rst:23 msgid "" "and no semantics are given, the semantics of this form of ``name`` are the " "same as for ``othername``." msgstr "" -#: ../src/Doc/reference/expressions.rst:30 +#: reference/expressions.rst:30 msgid "Arithmetic conversions" msgstr "" # 67c89ed049184ef7815b7c58fae72d3d -#: ../src/Doc/reference/expressions.rst:34 +#: reference/expressions.rst:34 msgid "" "When a description of an arithmetic operator below uses the phrase \"the " "numeric arguments are converted to a common type,\" the arguments are " @@ -3764,42 +3839,42 @@ msgid "" "arguments are standard numeric types, the following coercions are applied:" msgstr "" -#: ../src/Doc/reference/expressions.rst:39 +#: reference/expressions.rst:39 msgid "" "If either argument is a complex number, the other is converted to complex;" msgstr "" -#: ../src/Doc/reference/expressions.rst:41 +#: reference/expressions.rst:41 msgid "" "otherwise, if either argument is a floating point number, the other is " "converted to floating point;" msgstr "" # 2ef4506230dd411885cfa2daf5d0d066 -#: ../src/Doc/reference/expressions.rst:44 +#: reference/expressions.rst:44 msgid "" "otherwise, if either argument is a long integer, the other is converted to " "long integer;" msgstr "" # d74d9a787e0044acaac0eaa9effb1aa0 -#: ../src/Doc/reference/expressions.rst:47 +#: reference/expressions.rst:47 msgid "otherwise, both must be plain integers and no conversion is necessary." msgstr "" # 53cff54d70db4ba8b220f94c518b6edf -#: ../src/Doc/reference/expressions.rst:49 +#: reference/expressions.rst:49 msgid "" "Some additional rules apply for certain operators (e.g., a string left " "argument to the '%' operator). Extensions can define their own coercions." msgstr "" -#: ../src/Doc/reference/expressions.rst:56 +#: reference/expressions.rst:56 msgid "Atoms" msgstr "" # 5c37e06b52af4255891f3d95e85beefd -#: ../src/Doc/reference/expressions.rst:60 +#: reference/expressions.rst:60 msgid "" "Atoms are the most basic elements of expressions. The simplest atoms are " "identifiers or literals. Forms enclosed in reverse quotes or in " @@ -3807,18 +3882,18 @@ msgid "" "atoms. The syntax for atoms is:" msgstr "" -#: ../src/Doc/reference/expressions.rst:75 +#: reference/expressions.rst:75 msgid "Identifiers (Names)" msgstr "" -#: ../src/Doc/reference/expressions.rst:81 +#: reference/expressions.rst:81 msgid "" "An identifier occurring as an atom is a name. See section :ref:" "`identifiers` for lexical definition and section :ref:`naming` for " "documentation of naming and binding." msgstr "" -#: ../src/Doc/reference/expressions.rst:87 +#: reference/expressions.rst:87 msgid "" "When the name is bound to an object, evaluation of the atom yields that " "object. When a name is not bound, an attempt to evaluate it raises a :exc:" @@ -3826,7 +3901,7 @@ msgid "" msgstr "" # 3ccc4d78527a4706bad4729092614920 -#: ../src/Doc/reference/expressions.rst:95 +#: reference/expressions.rst:95 msgid "" "**Private name mangling:** When an identifier that textually occurs in a " "class definition begins with two or more underscore characters and does not " @@ -3842,18 +3917,17 @@ msgid "" "only of underscores, no transformation is done." msgstr "" -#: ../src/Doc/reference/expressions.rst:112 -#: ../src/Doc/reference/lexical_analysis.rst:404 +#: reference/expressions.rst:112 reference/lexical_analysis.rst:405 msgid "Literals" msgstr "" # 6f11d57089434d6ea9dac7a0c4042b0f -#: ../src/Doc/reference/expressions.rst:116 +#: reference/expressions.rst:116 msgid "Python supports string literals and various numeric literals:" msgstr "" # 325dcab25dd3492aa7536e4f7b8d2c48 -#: ../src/Doc/reference/expressions.rst:122 +#: reference/expressions.rst:122 msgid "" "Evaluation of a literal yields an object of the given type (string, integer, " "long integer, floating point number, complex number) with the given value. " @@ -3862,7 +3936,7 @@ msgid "" msgstr "" # b36e60895e204cf699e4a948e5ca1095 -#: ../src/Doc/reference/expressions.rst:131 +#: reference/expressions.rst:131 msgid "" "All literals correspond to immutable data types, and hence the object's " "identity is less important than its value. Multiple evaluations of literals " @@ -3871,30 +3945,30 @@ msgid "" "the same value." msgstr "" -#: ../src/Doc/reference/expressions.rst:141 +#: reference/expressions.rst:141 msgid "Parenthesized forms" msgstr "" -#: ../src/Doc/reference/expressions.rst:145 +#: reference/expressions.rst:145 msgid "" "A parenthesized form is an optional expression list enclosed in parentheses:" msgstr "" -#: ../src/Doc/reference/expressions.rst:150 +#: reference/expressions.rst:150 msgid "" "A parenthesized expression list yields whatever that expression list yields: " "if the list contains at least one comma, it yields a tuple; otherwise, it " "yields the single expression that makes up the expression list." msgstr "" -#: ../src/Doc/reference/expressions.rst:156 +#: reference/expressions.rst:156 msgid "" "An empty pair of parentheses yields an empty tuple object. Since tuples are " "immutable, the rules for literals apply (i.e., two occurrences of the empty " "tuple may or may not yield the same object)." msgstr "" -#: ../src/Doc/reference/expressions.rst:164 +#: reference/expressions.rst:164 msgid "" "Note that tuples are not formed by the parentheses, but rather by use of the " "comma operator. The exception is the empty tuple, for which parentheses " @@ -3902,18 +3976,18 @@ msgid "" "cause ambiguities and allow common typos to pass uncaught." msgstr "" -#: ../src/Doc/reference/expressions.rst:173 +#: reference/expressions.rst:173 msgid "List displays" msgstr "" -#: ../src/Doc/reference/expressions.rst:179 +#: reference/expressions.rst:179 msgid "" "A list display is a possibly empty series of expressions enclosed in square " "brackets:" msgstr "" # 84a73ce884474a4180b3ef89c48471a3 -#: ../src/Doc/reference/expressions.rst:196 +#: reference/expressions.rst:196 msgid "" "A list display yields a new list object. Its contents are specified by " "providing either a list of expressions or a list comprehension. When a " @@ -3929,32 +4003,32 @@ msgid "" msgstr "" # bdebbbb51b0e4f0ca2024296866fa1a8 -#: ../src/Doc/reference/expressions.rst:211 +#: reference/expressions.rst:211 msgid "Displays for sets and dictionaries" msgstr "" # 51fadfc53a0c45aa803b29228ca65696 -#: ../src/Doc/reference/expressions.rst:213 +#: reference/expressions.rst:213 msgid "" "For constructing a set or a dictionary Python provides special syntax called " "\"displays\", each of them in two flavors:" msgstr "" -#: ../src/Doc/reference/expressions.rst:216 +#: reference/expressions.rst:216 msgid "either the container contents are listed explicitly, or" msgstr "" -#: ../src/Doc/reference/expressions.rst:218 +#: reference/expressions.rst:218 msgid "" "they are computed via a set of looping and filtering instructions, called a :" "dfn:`comprehension`." msgstr "" -#: ../src/Doc/reference/expressions.rst:221 +#: reference/expressions.rst:221 msgid "Common syntax elements for comprehensions are:" msgstr "" -#: ../src/Doc/reference/expressions.rst:229 +#: reference/expressions.rst:229 msgid "" "The comprehension consists of a single expression followed by at least one :" "keyword:`for` clause and zero or more :keyword:`for` or :keyword:`if` " @@ -3964,29 +4038,29 @@ msgid "" "to produce an element each time the innermost block is reached." msgstr "" -#: ../src/Doc/reference/expressions.rst:236 +#: reference/expressions.rst:236 msgid "" "Note that the comprehension is executed in a separate scope, so names " "assigned to in the target list don't \"leak\" in the enclosing scope." msgstr "" -#: ../src/Doc/reference/expressions.rst:243 +#: reference/expressions.rst:243 #, fuzzy msgid "Generator expressions" msgstr "Expressions et générateurs" -#: ../src/Doc/reference/expressions.rst:248 +#: reference/expressions.rst:248 msgid "A generator expression is a compact generator notation in parentheses:" msgstr "" -#: ../src/Doc/reference/expressions.rst:253 +#: reference/expressions.rst:253 msgid "" "A generator expression yields a new generator object. Its syntax is the " "same as for comprehensions, except that it is enclosed in parentheses " "instead of brackets or curly braces." msgstr "" -#: ../src/Doc/reference/expressions.rst:257 +#: reference/expressions.rst:257 msgid "" "Variables used in the generator expression are evaluated lazily when the :" "meth:`__next__` method is called for generator object (in the same fashion " @@ -3998,27 +4072,27 @@ msgid "" "range(10) for y in bar(x))``." msgstr "" -#: ../src/Doc/reference/expressions.rst:266 +#: reference/expressions.rst:266 msgid "" "The parentheses can be omitted on calls with only one argument. See " "section :ref:`calls` for the detail." msgstr "" -#: ../src/Doc/reference/expressions.rst:272 +#: reference/expressions.rst:272 msgid "Dictionary displays" msgstr "" -#: ../src/Doc/reference/expressions.rst:278 +#: reference/expressions.rst:278 msgid "" "A dictionary display is a possibly empty series of key/datum pairs enclosed " "in curly braces:" msgstr "" -#: ../src/Doc/reference/expressions.rst:287 +#: reference/expressions.rst:287 msgid "A dictionary display yields a new dictionary object." msgstr "" -#: ../src/Doc/reference/expressions.rst:289 +#: reference/expressions.rst:289 msgid "" "If a comma-separated sequence of key/datum pairs is given, they are " "evaluated from left to right to define the entries of the dictionary: each " @@ -4028,7 +4102,7 @@ msgid "" "last one given." msgstr "" -#: ../src/Doc/reference/expressions.rst:295 +#: reference/expressions.rst:295 msgid "" "A dict comprehension, in contrast to list and set comprehensions, needs two " "expressions separated with a colon followed by the usual \"for\" and \"if\" " @@ -4036,7 +4110,7 @@ msgid "" "are inserted in the new dictionary in the order they are produced." msgstr "" -#: ../src/Doc/reference/expressions.rst:303 +#: reference/expressions.rst:303 msgid "" "Restrictions on the types of the key values are listed earlier in section :" "ref:`types`. (To summarize, the key type should be :term:`hashable`, which " @@ -4045,17 +4119,17 @@ msgid "" "given key value prevails." msgstr "" -#: ../src/Doc/reference/expressions.rst:313 +#: reference/expressions.rst:313 msgid "Set displays" msgstr "" -#: ../src/Doc/reference/expressions.rst:318 +#: reference/expressions.rst:318 msgid "" "A set display is denoted by curly braces and distinguishable from dictionary " "displays by the lack of colons separating keys and values:" msgstr "" -#: ../src/Doc/reference/expressions.rst:324 +#: reference/expressions.rst:324 msgid "" "A set display yields a new mutable set object, the contents being specified " "by either a sequence of expressions or a comprehension. When a comma-" @@ -4065,33 +4139,33 @@ msgid "" "comprehension." msgstr "" -#: ../src/Doc/reference/expressions.rst:330 +#: reference/expressions.rst:330 msgid "" "An empty set cannot be constructed with ``{}``; this literal constructs an " "empty dictionary." msgstr "" # d9d2d52a1cbf497192d6999fab29911b -#: ../src/Doc/reference/expressions.rst:337 +#: reference/expressions.rst:337 msgid "String conversions" msgstr "" # e3a9bac9989f41578be6e0ea26affb38 -#: ../src/Doc/reference/expressions.rst:345 +#: reference/expressions.rst:345 msgid "" "A string conversion is an expression list enclosed in reverse (a.k.a. " "backward) quotes:" msgstr "" # d59e379d54b64b6093043c870bf7dc90 -#: ../src/Doc/reference/expressions.rst:351 +#: reference/expressions.rst:351 msgid "" "A string conversion evaluates the contained expression list and converts the " "resulting object into a string according to rules specific to its type." msgstr "" # 929c11b839b44f95b6ce1370c67f5eba -#: ../src/Doc/reference/expressions.rst:354 +#: reference/expressions.rst:354 msgid "" "If the object is a string, a number, ``None``, or a tuple, list or " "dictionary containing only objects whose type is one of these, the resulting " @@ -4101,14 +4175,14 @@ msgid "" msgstr "" # 99bdcf6d0cd44dea9c6cbc7850efbd8a -#: ../src/Doc/reference/expressions.rst:360 +#: reference/expressions.rst:360 msgid "" "(In particular, converting a string adds quotes around it and converts " "\"funny\" characters to escape sequences that are safe to print.)" msgstr "" # 47507d705e54438ca03bbfd8177f6018 -#: ../src/Doc/reference/expressions.rst:365 +#: reference/expressions.rst:365 msgid "" "Recursive objects (for example, lists or dictionaries that contain a " "reference to themselves, directly or indirectly) use ``...`` to indicate a " @@ -4117,7 +4191,7 @@ msgid "" msgstr "" # faf9fb71858e43d79029e95b39dbac56 -#: ../src/Doc/reference/expressions.rst:374 +#: reference/expressions.rst:374 msgid "" "The built-in function :func:`repr` performs exactly the same conversion in " "its argument as enclosing it in parentheses and reverse quotes does. The " @@ -4125,12 +4199,12 @@ msgid "" "conversion." msgstr "" -#: ../src/Doc/reference/expressions.rst:382 +#: reference/expressions.rst:382 msgid "Yield expressions" msgstr "" # 8274776417fb4a5b9c915fbfe4d781e7 -#: ../src/Doc/reference/expressions.rst:395 +#: reference/expressions.rst:395 msgid "" "The :keyword:`yield` expression is only used when defining a generator " "function, and can only be used in the body of a function definition. Using " @@ -4140,7 +4214,7 @@ msgid "" msgstr "" # a14936cb7de843878fb8847cc1851641 -#: ../src/Doc/reference/expressions.rst:400 +#: reference/expressions.rst:400 msgid "" "When a generator function is called, it returns an iterator known as a " "generator. That generator then controls the execution of a generator " @@ -4157,7 +4231,7 @@ msgid "" msgstr "" # 97715ddd9b414a9d8467685774e3e57e -#: ../src/Doc/reference/expressions.rst:415 +#: reference/expressions.rst:415 msgid "" "All of this makes generator functions quite similar to coroutines; they " "yield multiple times, they have more than one entry point and their " @@ -4167,26 +4241,26 @@ msgid "" msgstr "" # f7e403a1fdfc4774aea8ef5bccd791f5 -#: ../src/Doc/reference/expressions.rst:425 +#: reference/expressions.rst:425 msgid "Generator-iterator methods" msgstr "" # 58d143f990024d358fc30a950510d75f -#: ../src/Doc/reference/expressions.rst:427 +#: reference/expressions.rst:427 msgid "" "This subsection describes the methods of a generator iterator. They can be " "used to control the execution of a generator function." msgstr "" # c091bbb4768b4aed8523c84c4a4432f4 -#: ../src/Doc/reference/expressions.rst:430 +#: reference/expressions.rst:430 msgid "" "Note that calling any of the generator methods below when the generator is " "already executing raises a :exc:`ValueError` exception." msgstr "" # 301fe5977e7f4174809c2fceae4497ee -#: ../src/Doc/reference/expressions.rst:438 +#: reference/expressions.rst:438 msgid "" "Starts the execution of a generator function or resumes it at the last " "executed :keyword:`yield` expression. When a generator function is resumed " @@ -4199,7 +4273,7 @@ msgid "" msgstr "" # d94de07bc9384a5a8f04f4205c40d644 -#: ../src/Doc/reference/expressions.rst:451 +#: reference/expressions.rst:451 msgid "" "Resumes the execution and \"sends\" a value into the generator function. " "The ``value`` argument becomes the result of the current :keyword:`yield` " @@ -4210,7 +4284,7 @@ msgid "" "keyword:`yield` expression that could receive the value." msgstr "" -#: ../src/Doc/reference/expressions.rst:462 +#: reference/expressions.rst:462 msgid "" "Raises an exception of type ``type`` at the point where generator was " "paused, and returns the next value yielded by the generator function. If " @@ -4220,7 +4294,7 @@ msgid "" "to the caller." msgstr "" -#: ../src/Doc/reference/expressions.rst:473 +#: reference/expressions.rst:473 msgid "" "Raises a :exc:`GeneratorExit` at the point where the generator function was " "paused. If the generator function then raises :exc:`StopIteration` (by " @@ -4232,45 +4306,42 @@ msgid "" "normal exit." msgstr "" -#: ../src/Doc/reference/expressions.rst:481 +#: reference/expressions.rst:481 msgid "" "Here is a simple example that demonstrates the behavior of generators and " "generator functions::" msgstr "" -# 20684de4a4514b71a25c128407069512 -# 28b0eb3a499e409f82cb9a6784ed0c24 -#: ../src/Doc/reference/expressions.rst:511 -#: ../src/Doc/reference/simple_stmts.rst:544 -msgid ":pep:`0342` - Coroutines via Enhanced Generators" +#: reference/expressions.rst:512 reference/simple_stmts.rst:545 +msgid "PEP 0342 - Coroutines via Enhanced Generators" msgstr "" -#: ../src/Doc/reference/expressions.rst:512 +#: reference/expressions.rst:512 msgid "" "The proposal to enhance the API and syntax of generators, making them usable " "as simple coroutines." msgstr "" -#: ../src/Doc/reference/expressions.rst:519 +#: reference/expressions.rst:519 msgid "Primaries" msgstr "" -#: ../src/Doc/reference/expressions.rst:523 +#: reference/expressions.rst:523 msgid "" "Primaries represent the most tightly bound operations of the language. Their " "syntax is:" msgstr "" -#: ../src/Doc/reference/expressions.rst:533 +#: reference/expressions.rst:533 msgid "Attribute references" msgstr "" -#: ../src/Doc/reference/expressions.rst:537 +#: reference/expressions.rst:537 msgid "An attribute reference is a primary followed by a period and a name:" msgstr "" # 03c5b9dfb0f14097bafffbd66792a1f5 -#: ../src/Doc/reference/expressions.rst:547 +#: reference/expressions.rst:547 msgid "" "The primary must evaluate to an object of a type that supports attribute " "references, e.g., a module, list, or an instance. This object is then asked " @@ -4280,22 +4351,22 @@ msgid "" "evaluations of the same attribute reference may yield different objects." msgstr "" -#: ../src/Doc/reference/expressions.rst:558 +#: reference/expressions.rst:558 msgid "Subscriptions" msgstr "" -#: ../src/Doc/reference/expressions.rst:571 +#: reference/expressions.rst:571 msgid "" "A subscription selects an item of a sequence (string, tuple or list) or " "mapping (dictionary) object:" msgstr "" # c4ddc614a53347649ef51fcd48e85460 -#: ../src/Doc/reference/expressions.rst:577 +#: reference/expressions.rst:577 msgid "The primary must evaluate to an object of a sequence or mapping type." msgstr "" -#: ../src/Doc/reference/expressions.rst:579 +#: reference/expressions.rst:579 msgid "" "If the primary is a mapping, the expression list must evaluate to an object " "whose value is one of the keys of the mapping, and the subscription selects " @@ -4304,7 +4375,7 @@ msgid "" msgstr "" # cbef82ccd55049a8bc7a40e30b48e420 -#: ../src/Doc/reference/expressions.rst:584 +#: reference/expressions.rst:584 msgid "" "If the primary is a sequence, the expression (list) must evaluate to a plain " "integer. If this value is negative, the length of the sequence is added to " @@ -4314,17 +4385,17 @@ msgid "" "(counting from zero)." msgstr "" -#: ../src/Doc/reference/expressions.rst:595 +#: reference/expressions.rst:595 msgid "" "A string's items are characters. A character is not a separate data type " "but a string of exactly one character." msgstr "" -#: ../src/Doc/reference/expressions.rst:602 +#: reference/expressions.rst:602 msgid "Slicings" msgstr "" -#: ../src/Doc/reference/expressions.rst:614 +#: reference/expressions.rst:614 msgid "" "A slicing selects a range of items in a sequence object (e.g., a string, " "tuple or list). Slicings may be used as expressions or as targets in " @@ -4332,7 +4403,7 @@ msgid "" msgstr "" # 7889acbef05948c6b4130453c66639a6 -#: ../src/Doc/reference/expressions.rst:634 +#: reference/expressions.rst:634 msgid "" "There is ambiguity in the formal syntax here: anything that looks like an " "expression list also looks like a slice list, so any subscription can be " @@ -4346,7 +4417,7 @@ msgid "" msgstr "" # 2edce4df31534a04a071667be001d586 -#: ../src/Doc/reference/expressions.rst:643 +#: reference/expressions.rst:643 msgid "" "The semantics for a simple slicing are as follows. The primary must " "evaluate to a sequence object. The lower and upper bound expressions, if " @@ -4359,7 +4430,7 @@ msgid "" msgstr "" # f6242d8b3ca044edb12f2d1e9c640a7e -#: ../src/Doc/reference/expressions.rst:657 +#: reference/expressions.rst:657 msgid "" "The semantics for an extended slicing are as follows. The primary must " "evaluate to a mapping object, and it is indexed with a key that is " @@ -4375,25 +4446,25 @@ msgid "" "expressions." msgstr "" -#: ../src/Doc/reference/expressions.rst:678 +#: reference/expressions.rst:678 msgid "Calls" msgstr "" # 53eb6238970d4a56b1b199d855596e4a -#: ../src/Doc/reference/expressions.rst:680 +#: reference/expressions.rst:680 msgid "" "A call calls a callable object (e.g., a :term:`function`) with a possibly " "empty series of :term:`arguments <argument>`:" msgstr "" -#: ../src/Doc/reference/expressions.rst:697 +#: reference/expressions.rst:697 msgid "" "A trailing comma may be present after the positional and keyword arguments " "but does not affect the semantics." msgstr "" # a813844f37c64c419d6cdf9dc1706d92 -#: ../src/Doc/reference/expressions.rst:703 +#: reference/expressions.rst:703 msgid "" "The primary must evaluate to a callable object (user-defined functions, " "built-in functions, methods of built-in objects, class objects, methods of " @@ -4403,7 +4474,7 @@ msgid "" "section :ref:`function` for the syntax of formal :term:`parameter` lists." msgstr "" -#: ../src/Doc/reference/expressions.rst:710 +#: reference/expressions.rst:710 msgid "" "If keyword arguments are present, they are first converted to positional " "arguments, as follows. First, a list of unfilled slots is created for the " @@ -4426,7 +4497,7 @@ msgid "" msgstr "" # 9982809b8b8b456fbe25cc9e3b8d6cd6 -#: ../src/Doc/reference/expressions.rst:730 +#: reference/expressions.rst:730 msgid "" "An implementation may provide built-in functions whose positional parameters " "do not have names, even if they are 'named' for the purpose of " @@ -4435,7 +4506,7 @@ msgid "" "`PyArg_ParseTuple` to parse their arguments." msgstr "" -#: ../src/Doc/reference/expressions.rst:736 +#: reference/expressions.rst:736 msgid "" "If there are more positional arguments than there are formal parameter " "slots, a :exc:`TypeError` exception is raised, unless a formal parameter " @@ -4444,7 +4515,7 @@ msgid "" "empty tuple if there were no excess positional arguments)." msgstr "" -#: ../src/Doc/reference/expressions.rst:742 +#: reference/expressions.rst:742 msgid "" "If any keyword argument does not correspond to a formal parameter name, a :" "exc:`TypeError` exception is raised, unless a formal parameter using the " @@ -4455,7 +4526,7 @@ msgid "" msgstr "" # fec2deb16bac4cf8b5bf145485ca01c4 -#: ../src/Doc/reference/expressions.rst:752 +#: reference/expressions.rst:752 msgid "" "If the syntax ``*expression`` appears in the function call, ``expression`` " "must evaluate to an iterable. Elements from this iterable are treated as if " @@ -4465,20 +4536,20 @@ msgid "" "*y1*, ..., *yM*." msgstr "" -#: ../src/Doc/reference/expressions.rst:759 +#: reference/expressions.rst:759 msgid "" "A consequence of this is that although the ``*expression`` syntax may appear " "*after* some keyword arguments, it is processed *before* the keyword " "arguments (and the ``**expression`` argument, if any -- see below). So::" msgstr "" -#: ../src/Doc/reference/expressions.rst:775 +#: reference/expressions.rst:775 msgid "" "It is unusual for both keyword arguments and the ``*expression`` syntax to " "be used in the same call, so in practice this confusion does not arise." msgstr "" -#: ../src/Doc/reference/expressions.rst:781 +#: reference/expressions.rst:781 msgid "" "If the syntax ``**expression`` appears in the function call, ``expression`` " "must evaluate to a mapping, the contents of which are treated as additional " @@ -4488,7 +4559,7 @@ msgid "" msgstr "" # 0aa56d3e89484a619e6db76d21ffc03f -#: ../src/Doc/reference/expressions.rst:786 +#: reference/expressions.rst:786 msgid "" "Formal parameters using the syntax ``*identifier`` or ``**identifier`` " "cannot be used as positional argument slots or as keyword argument names. " @@ -4498,23 +4569,23 @@ msgid "" "usual tuple assignment rules after all other parameter processing is done." msgstr "" -#: ../src/Doc/reference/expressions.rst:793 +#: reference/expressions.rst:793 msgid "" "A call always returns some value, possibly ``None``, unless it raises an " "exception. How this value is computed depends on the type of the callable " "object." msgstr "" -#: ../src/Doc/reference/expressions.rst:797 +#: reference/expressions.rst:797 msgid "If it is---" msgstr "" # 15f21c6a233b4d27ba0f3496d0d69f26 -#: ../src/Doc/reference/expressions.rst:809 +#: reference/expressions.rst:810 msgid "a user-defined function:" msgstr "" -#: ../src/Doc/reference/expressions.rst:806 +#: reference/expressions.rst:806 msgid "" "The code block for the function is executed, passing it the argument list. " "The first thing the code block will do is bind the formal parameters to the " @@ -4524,31 +4595,31 @@ msgid "" msgstr "" # 6f370af1ee9a46a0bb983b3343a977fe -#: ../src/Doc/reference/expressions.rst:823 +#: reference/expressions.rst:824 msgid "a built-in function or method:" msgstr "" -#: ../src/Doc/reference/expressions.rst:823 +#: reference/expressions.rst:823 msgid "" "The result is up to the interpreter; see :ref:`built-in-funcs` for the " "descriptions of built-in functions and methods." msgstr "" # 1a16881c8d8849d6b4aff6723f82a272 -#: ../src/Doc/reference/expressions.rst:830 +#: reference/expressions.rst:831 msgid "a class object:" msgstr "" -#: ../src/Doc/reference/expressions.rst:831 +#: reference/expressions.rst:831 msgid "A new instance of that class is returned." msgstr "" # fc8025f1c4794b858684291a624095e5 -#: ../src/Doc/reference/expressions.rst:840 +#: reference/expressions.rst:841 msgid "a class instance method:" msgstr "" -#: ../src/Doc/reference/expressions.rst:839 +#: reference/expressions.rst:839 msgid "" "The corresponding user-defined function is called, with an argument list " "that is one longer than the argument list of the call: the instance becomes " @@ -4556,27 +4627,27 @@ msgid "" msgstr "" # 95e01195dc8540a7a960984d8e3372c1 -#: ../src/Doc/reference/expressions.rst:849 +#: reference/expressions.rst:850 msgid "a class instance:" msgstr "" -#: ../src/Doc/reference/expressions.rst:848 +#: reference/expressions.rst:848 msgid "" "The class must define a :meth:`__call__` method; the effect is then the same " "as if that method was called." msgstr "" -#: ../src/Doc/reference/expressions.rst:855 +#: reference/expressions.rst:855 msgid "The power operator" msgstr "" -#: ../src/Doc/reference/expressions.rst:857 +#: reference/expressions.rst:857 msgid "" "The power operator binds more tightly than unary operators on its left; it " "binds less tightly than unary operators on its right. The syntax is:" msgstr "" -#: ../src/Doc/reference/expressions.rst:863 +#: reference/expressions.rst:863 msgid "" "Thus, in an unparenthesized sequence of power and unary operators, the " "operators are evaluated from right to left (this does not constrain the " @@ -4584,7 +4655,7 @@ msgid "" msgstr "" # b81e95a295054a1785b72be057f8c117 -#: ../src/Doc/reference/expressions.rst:867 +#: reference/expressions.rst:867 msgid "" "The power operator has the same semantics as the built-in :func:`pow` " "function, when called with two arguments: it yields its left argument raised " @@ -4594,7 +4665,7 @@ msgid "" msgstr "" # 482ffd086a414c7da955b3708d4d01a6 -#: ../src/Doc/reference/expressions.rst:872 +#: reference/expressions.rst:872 msgid "" "With mixed operand types, the coercion rules for binary arithmetic operators " "apply. For int and long int operands, the result has the same type as the " @@ -4607,49 +4678,49 @@ msgid "" msgstr "" # 3a1c84740fe64abaa7a64d9d7057a1fa -#: ../src/Doc/reference/expressions.rst:881 +#: reference/expressions.rst:881 msgid "" "Raising ``0.0`` to a negative power results in a :exc:`ZeroDivisionError`. " "Raising a negative number to a fractional power results in a :exc:" "`ValueError`." msgstr "" -#: ../src/Doc/reference/expressions.rst:888 +#: reference/expressions.rst:888 msgid "Unary arithmetic and bitwise operations" msgstr "" -#: ../src/Doc/reference/expressions.rst:894 +#: reference/expressions.rst:894 msgid "All unary arithmetic and bitwise operations have the same priority:" msgstr "" -#: ../src/Doc/reference/expressions.rst:903 +#: reference/expressions.rst:903 msgid "" "The unary ``-`` (minus) operator yields the negation of its numeric argument." msgstr "" -#: ../src/Doc/reference/expressions.rst:907 +#: reference/expressions.rst:907 msgid "The unary ``+`` (plus) operator yields its numeric argument unchanged." msgstr "" # 8306f081357247d8add29f517bb5f5b1 -#: ../src/Doc/reference/expressions.rst:911 +#: reference/expressions.rst:911 msgid "" "The unary ``~`` (invert) operator yields the bitwise inversion of its plain " "or long integer argument. The bitwise inversion of ``x`` is defined as ``-(x" "+1)``. It only applies to integral numbers." msgstr "" -#: ../src/Doc/reference/expressions.rst:917 +#: reference/expressions.rst:917 msgid "" "In all three cases, if the argument does not have the proper type, a :exc:" "`TypeError` exception is raised." msgstr "" -#: ../src/Doc/reference/expressions.rst:924 +#: reference/expressions.rst:924 msgid "Binary arithmetic operations" msgstr "" -#: ../src/Doc/reference/expressions.rst:928 +#: reference/expressions.rst:928 msgid "" "The binary arithmetic operations have the conventional priority levels. " "Note that some of these operations also apply to certain non-numeric types. " @@ -4658,7 +4729,7 @@ msgid "" msgstr "" # 06ee5dad23f3493795e649a38d29649d -#: ../src/Doc/reference/expressions.rst:940 +#: reference/expressions.rst:940 msgid "" "The ``*`` (multiplication) operator yields the product of its arguments. " "The arguments must either both be numbers, or one argument must be an " @@ -4669,7 +4740,7 @@ msgid "" msgstr "" # 9f701f0990f54b1fae15d256820d2fd4 -#: ../src/Doc/reference/expressions.rst:951 +#: reference/expressions.rst:951 msgid "" "The ``/`` (division) and ``//`` (floor division) operators yield the " "quotient of their arguments. The numeric arguments are first converted to a " @@ -4679,7 +4750,7 @@ msgid "" "exception." msgstr "" -#: ../src/Doc/reference/expressions.rst:959 +#: reference/expressions.rst:959 msgid "" "The ``%`` (modulo) operator yields the remainder from the division of the " "first argument by the second. The numeric arguments are first converted to " @@ -4692,7 +4763,7 @@ msgid "" msgstr "" # 1441d1af143e42c1bbd95ae13e8f8475 -#: ../src/Doc/reference/expressions.rst:968 +#: reference/expressions.rst:968 msgid "" "The integer division and modulo operators are connected by the following " "identity: ``x == (x/y)*y + (x%y)``. Integer division and modulo are also " @@ -4703,7 +4774,7 @@ msgid "" msgstr "" # 1ccccdf8dba343bb82acec7b75c118bd -#: ../src/Doc/reference/expressions.rst:975 +#: reference/expressions.rst:975 msgid "" "In addition to performing the modulo operation on numbers, the ``%`` " "operator is also overloaded by string and unicode objects to perform string " @@ -4712,8 +4783,15 @@ msgid "" "formatting`." msgstr "" +#: reference/expressions.rst:980 +msgid "" +"The floor division operator, the modulo operator, and the :func:`divmod` " +"function are no longer defined for complex numbers. Instead, convert to a " +"floating point number using the :func:`abs` function if appropriate." +msgstr "" + # d3e04f640d19400f832e9dd135373c99 -#: ../src/Doc/reference/expressions.rst:987 +#: reference/expressions.rst:987 msgid "" "The ``+`` (addition) operator yields the sum of its arguments. The arguments " "must either both be numbers or both sequences of the same type. In the " @@ -4721,23 +4799,23 @@ msgid "" "together. In the latter case, the sequences are concatenated." msgstr "" -#: ../src/Doc/reference/expressions.rst:994 +#: reference/expressions.rst:994 msgid "" "The ``-`` (subtraction) operator yields the difference of its arguments. " "The numeric arguments are first converted to a common type." msgstr "" -#: ../src/Doc/reference/expressions.rst:1001 +#: reference/expressions.rst:1001 msgid "Shifting operations" msgstr "" -#: ../src/Doc/reference/expressions.rst:1005 +#: reference/expressions.rst:1005 msgid "" "The shifting operations have lower priority than the arithmetic operations:" msgstr "" # 049f37f00f6d4b6abe25aadd939211bd -#: ../src/Doc/reference/expressions.rst:1010 +#: reference/expressions.rst:1010 msgid "" "These operators accept plain or long integers as arguments. The arguments " "are converted to a common type. They shift the first argument to the left " @@ -4745,37 +4823,37 @@ msgid "" msgstr "" # 2ea8cbb8eeb64b8b99b8613a99e2d8ea -#: ../src/Doc/reference/expressions.rst:1016 +#: reference/expressions.rst:1016 msgid "" "A right shift by *n* bits is defined as division by ``pow(2, n)``. A left " "shift by *n* bits is defined as multiplication with ``pow(2, n)``. Negative " "shift counts raise a :exc:`ValueError` exception." msgstr "" -#: ../src/Doc/reference/expressions.rst:1022 +#: reference/expressions.rst:1022 msgid "" "In the current implementation, the right-hand operand is required to be at " "most :attr:`sys.maxsize`. If the right-hand operand is larger than :attr:" "`sys.maxsize` an :exc:`OverflowError` exception is raised." msgstr "" -#: ../src/Doc/reference/expressions.rst:1029 +#: reference/expressions.rst:1029 msgid "Binary bitwise operations" msgstr "" -#: ../src/Doc/reference/expressions.rst:1033 +#: reference/expressions.rst:1033 msgid "Each of the three bitwise operations has a different priority level:" msgstr "" # 44371a039a8b48c5b98a50b3376a7ab0 -#: ../src/Doc/reference/expressions.rst:1042 +#: reference/expressions.rst:1042 msgid "" "The ``&`` operator yields the bitwise AND of its arguments, which must be " "plain or long integers. The arguments are converted to a common type." msgstr "" # 424d390f37a0457fb826b9713d84f109 -#: ../src/Doc/reference/expressions.rst:1049 +#: reference/expressions.rst:1049 msgid "" "The ``^`` operator yields the bitwise XOR (exclusive OR) of its arguments, " "which must be plain or long integers. The arguments are converted to a " @@ -4783,18 +4861,18 @@ msgid "" msgstr "" # 220631bc70e74155842ee5ca4e19f27f -#: ../src/Doc/reference/expressions.rst:1056 +#: reference/expressions.rst:1056 msgid "" "The ``|`` operator yields the bitwise (inclusive) OR of its arguments, which " "must be plain or long integers. The arguments are converted to a common " "type." msgstr "" -#: ../src/Doc/reference/expressions.rst:1067 +#: reference/expressions.rst:1067 msgid "Comparisons" msgstr "" -#: ../src/Doc/reference/expressions.rst:1073 +#: reference/expressions.rst:1073 msgid "" "Unlike C, all comparison operations in Python have the same priority, which " "is lower than that of any arithmetic, shifting or bitwise operation. Also " @@ -4802,11 +4880,11 @@ msgid "" "conventional in mathematics:" msgstr "" -#: ../src/Doc/reference/expressions.rst:1083 +#: reference/expressions.rst:1083 msgid "Comparisons yield boolean values: ``True`` or ``False``." msgstr "" -#: ../src/Doc/reference/expressions.rst:1087 +#: reference/expressions.rst:1087 msgid "" "Comparisons can be chained arbitrarily, e.g., ``x < y <= z`` is equivalent " "to ``x < y and y <= z``, except that ``y`` is evaluated only once (but in " @@ -4814,7 +4892,7 @@ msgid "" "false)." msgstr "" -#: ../src/Doc/reference/expressions.rst:1091 +#: reference/expressions.rst:1091 msgid "" "Formally, if *a*, *b*, *c*, ..., *y*, *z* are expressions and *op1*, " "*op2*, ..., *opN* are comparison operators, then ``a op1 b op2 c ... y opN " @@ -4822,7 +4900,7 @@ msgid "" "each expression is evaluated at most once." msgstr "" -#: ../src/Doc/reference/expressions.rst:1096 +#: reference/expressions.rst:1096 msgid "" "Note that ``a op1 b op2 c`` doesn't imply any kind of comparison between *a* " "and *c*, so that, e.g., ``x < y > z`` is perfectly legal (though perhaps not " @@ -4830,7 +4908,7 @@ msgid "" msgstr "" # a7fd5b6ca96441cd857aa859db5510b9 -#: ../src/Doc/reference/expressions.rst:1100 +#: reference/expressions.rst:1100 msgid "" "The forms ``<>`` and ``!=`` are equivalent; for consistency with C, ``!=`` " "is preferred; where ``!=`` is mentioned below ``<>`` is also accepted. The " @@ -4838,7 +4916,7 @@ msgid "" msgstr "" # 6520859c7a364cc696c32cc22df12125 -#: ../src/Doc/reference/expressions.rst:1104 +#: reference/expressions.rst:1104 msgid "" "The operators ``<``, ``>``, ``==``, ``>=``, ``<=``, and ``!=`` compare the " "values of two objects. The objects need not have the same type. If both are " @@ -4850,7 +4928,7 @@ msgid "" msgstr "" # 2c05852be671430db3a3c83df196aeab -#: ../src/Doc/reference/expressions.rst:1112 +#: reference/expressions.rst:1112 msgid "" "(This unusual definition of comparison was used to simplify the definition " "of operations like sorting and the :keyword:`in` and :keyword:`not in` " @@ -4858,23 +4936,23 @@ msgid "" "types are likely to change.)" msgstr "" -#: ../src/Doc/reference/expressions.rst:1117 +#: reference/expressions.rst:1117 msgid "Comparison of objects of the same type depends on the type:" msgstr "" -#: ../src/Doc/reference/expressions.rst:1119 +#: reference/expressions.rst:1119 msgid "Numbers are compared arithmetically." msgstr "" # 228417a71cd94ac09c53ac12c2cfdb91 -#: ../src/Doc/reference/expressions.rst:1121 +#: reference/expressions.rst:1121 msgid "" "Strings are compared lexicographically using the numeric equivalents (the " "result of the built-in function :func:`ord`) of their characters. Unicode " "and 8-bit strings are fully interoperable in this behavior. [#]_" msgstr "" -#: ../src/Doc/reference/expressions.rst:1125 +#: reference/expressions.rst:1125 msgid "" "Tuples and lists are compared lexicographically using comparison of " "corresponding elements. This means that to compare equal, each element must " @@ -4883,7 +4961,7 @@ msgid "" msgstr "" # d595063581ec4699afc76b6a1691a8e4 -#: ../src/Doc/reference/expressions.rst:1130 +#: reference/expressions.rst:1130 msgid "" "If not equal, the sequences are ordered the same as their first differing " "elements. For example, ``cmp([1,2,x], [1,2,y])`` returns the same as " @@ -4892,14 +4970,14 @@ msgid "" msgstr "" # 7da25f9a15dd45058f5bbe25daab5ac7 -#: ../src/Doc/reference/expressions.rst:1135 +#: reference/expressions.rst:1135 msgid "" "Mappings (dictionaries) compare equal if and only if their sorted (key, " "value) lists compare equal. [#]_ Outcomes other than equality are resolved " "consistently, but are not otherwise defined. [#]_" msgstr "" -#: ../src/Doc/reference/expressions.rst:1139 +#: reference/expressions.rst:1139 msgid "" "Most other objects of built-in types compare unequal unless they are the " "same object; the choice whether one object is considered smaller or larger " @@ -4908,7 +4986,7 @@ msgid "" msgstr "" # 82879f641bcb4c4481304b85f9a50a79 -#: ../src/Doc/reference/expressions.rst:1146 +#: reference/expressions.rst:1146 msgid "" "The operators :keyword:`in` and :keyword:`not in` test for collection " "membership. ``x in s`` evaluates to true if *x* is a member of the " @@ -4922,14 +5000,14 @@ msgid "" msgstr "" # 17f3c1f97d5148ed990fb624099bef5c -#: ../src/Doc/reference/expressions.rst:1155 +#: reference/expressions.rst:1155 msgid "" "For the list and tuple types, ``x in y`` is true if and only if there exists " "an index *i* such that ``x == y[i]`` is true." msgstr "" # 2c66edd4662e4c7b9359aec5ffc48aff -#: ../src/Doc/reference/expressions.rst:1158 +#: reference/expressions.rst:1158 msgid "" "For the Unicode and string types, ``x in y`` is true if and only if *x* is a " "substring of *y*. An equivalent test is ``y.find(x) != -1``. Note, *x* and " @@ -4938,13 +5016,17 @@ msgid "" "string, so ``\"\" in \"abc\"`` will return ``True``." msgstr "" -#: ../src/Doc/reference/expressions.rst:1167 +#: reference/expressions.rst:1164 +msgid "Previously, *x* was required to be a string of length ``1``." +msgstr "" + +#: reference/expressions.rst:1167 msgid "" "For user-defined classes which define the :meth:`__contains__` method, ``x " "in y`` is true if and only if ``y.__contains__(x)`` is true." msgstr "" -#: ../src/Doc/reference/expressions.rst:1170 +#: reference/expressions.rst:1170 msgid "" "For user-defined classes which do not define :meth:`__contains__` but do " "define :meth:`__iter__`, ``x in y`` is true if some value ``z`` with ``x == " @@ -4953,7 +5035,7 @@ msgid "" msgstr "" # c9710b8034f1494ca8a4f4ee49edadf8 -#: ../src/Doc/reference/expressions.rst:1175 +#: reference/expressions.rst:1175 msgid "" "Lastly, the old-style iteration protocol is tried: if a class defines :meth:" "`__getitem__`, ``x in y`` is true if and only if there is a non-negative " @@ -4962,25 +5044,25 @@ msgid "" "is as if :keyword:`in` raised that exception)." msgstr "" -#: ../src/Doc/reference/expressions.rst:1187 +#: reference/expressions.rst:1187 msgid "" "The operator :keyword:`not in` is defined to have the inverse true value of :" "keyword:`in`." msgstr "" -#: ../src/Doc/reference/expressions.rst:1195 +#: reference/expressions.rst:1195 msgid "" "The operators :keyword:`is` and :keyword:`is not` test for object identity: " "``x is y`` is true if and only if *x* and *y* are the same object. ``x is " "not y`` yields the inverse truth value. [#]_" msgstr "" -#: ../src/Doc/reference/expressions.rst:1206 +#: reference/expressions.rst:1206 msgid "Boolean operations" msgstr "" # 57ab1712b46c4f8db1588584ceb5f69e -#: ../src/Doc/reference/expressions.rst:1217 +#: reference/expressions.rst:1217 msgid "" "In the context of Boolean operations, and also when expressions are used by " "control flow statements, the following values are interpreted as false: " @@ -4990,26 +5072,26 @@ msgid "" "`~object.__nonzero__` special method for a way to change this.)" msgstr "" -#: ../src/Doc/reference/expressions.rst:1226 +#: reference/expressions.rst:1226 msgid "" "The operator :keyword:`not` yields ``True`` if its argument is false, " "``False`` otherwise." msgstr "" -#: ../src/Doc/reference/expressions.rst:1231 +#: reference/expressions.rst:1231 msgid "" "The expression ``x and y`` first evaluates *x*; if *x* is false, its value " "is returned; otherwise, *y* is evaluated and the resulting value is returned." msgstr "" -#: ../src/Doc/reference/expressions.rst:1236 +#: reference/expressions.rst:1236 msgid "" "The expression ``x or y`` first evaluates *x*; if *x* is true, its value is " "returned; otherwise, *y* is evaluated and the resulting value is returned." msgstr "" # 3b2596cf486a4996b2a620d62e7ae571 -#: ../src/Doc/reference/expressions.rst:1239 +#: reference/expressions.rst:1239 msgid "" "(Note that neither :keyword:`and` nor :keyword:`or` restrict the value and " "type they return to ``False`` and ``True``, but rather return the last " @@ -5020,33 +5102,33 @@ msgid "" "as its argument, so e.g., ``not 'foo'`` yields ``False``, not ``''``.)" msgstr "" -#: ../src/Doc/reference/expressions.rst:1249 +#: reference/expressions.rst:1249 msgid "Conditional Expressions" msgstr "" -#: ../src/Doc/reference/expressions.rst:1261 +#: reference/expressions.rst:1261 msgid "" "Conditional expressions (sometimes called a \"ternary operator\") have the " "lowest priority of all Python operations." msgstr "" -#: ../src/Doc/reference/expressions.rst:1264 +#: reference/expressions.rst:1264 msgid "" "The expression ``x if C else y`` first evaluates the condition, *C* (*not* " "*x*); if *C* is true, *x* is evaluated and its value is returned; otherwise, " "*y* is evaluated and its value is returned." msgstr "" -#: ../src/Doc/reference/expressions.rst:1268 +#: reference/expressions.rst:1268 msgid "See :pep:`308` for more details about conditional expressions." msgstr "" -#: ../src/Doc/reference/expressions.rst:1275 +#: reference/expressions.rst:1275 msgid "Lambdas" msgstr "" # 17cc81a0c6274b6ea119506392cf3fa1 -#: ../src/Doc/reference/expressions.rst:1285 +#: reference/expressions.rst:1285 msgid "" "Lambda expressions (sometimes called lambda forms) have the same syntactic " "position as expressions. They are a shorthand to create anonymous " @@ -5055,24 +5137,24 @@ msgid "" msgstr "" # f355a597bf33479aa2062d92c58787dc -#: ../src/Doc/reference/expressions.rst:1293 +#: reference/expressions.rst:1293 msgid "" "See section :ref:`function` for the syntax of parameter lists. Note that " "functions created with lambda expressions cannot contain statements." msgstr "" -#: ../src/Doc/reference/expressions.rst:1300 +#: reference/expressions.rst:1300 msgid "Expression lists" msgstr "" -#: ../src/Doc/reference/expressions.rst:1309 +#: reference/expressions.rst:1309 msgid "" "An expression list containing at least one comma yields a tuple. The length " "of the tuple is the number of expressions in the list. The expressions are " "evaluated from left to right." msgstr "" -#: ../src/Doc/reference/expressions.rst:1315 +#: reference/expressions.rst:1315 msgid "" "The trailing comma is required only to create a single tuple (a.k.a. a " "*singleton*); it is optional in all other cases. A single expression " @@ -5081,31 +5163,31 @@ msgid "" "parentheses: ``()``.)" msgstr "" -#: ../src/Doc/reference/expressions.rst:1325 +#: reference/expressions.rst:1325 msgid "Evaluation order" msgstr "" # 82676faf892345019788544595afce26 -#: ../src/Doc/reference/expressions.rst:1329 +#: reference/expressions.rst:1329 msgid "" "Python evaluates expressions from left to right. Notice that while " "evaluating an assignment, the right-hand side is evaluated before the left-" "hand side." msgstr "" -#: ../src/Doc/reference/expressions.rst:1332 +#: reference/expressions.rst:1332 msgid "" "In the following lines, expressions will be evaluated in the arithmetic " "order of their suffixes::" msgstr "" # 31afa1dd2ec046ebbeadf2a8a84cd4aa -#: ../src/Doc/reference/expressions.rst:1346 +#: reference/expressions.rst:1346 msgid "Operator precedence" msgstr "" # 6bbeab57bf6c4991b718465416feea13 -#: ../src/Doc/reference/expressions.rst:1350 +#: reference/expressions.rst:1350 msgid "" "The following table summarizes the operator precedences in Python, from " "lowest precedence (least binding) to highest precedence (most binding). " @@ -5116,156 +5198,156 @@ msgid "" "`comparisons` --- and exponentiation, which groups from right to left)." msgstr "" -#: ../src/Doc/reference/expressions.rst:1359 +#: reference/expressions.rst:1359 msgid "Operator" msgstr "" -#: ../src/Doc/reference/expressions.rst:1359 +#: reference/expressions.rst:1359 msgid "Description" msgstr "" -#: ../src/Doc/reference/expressions.rst:1361 +#: reference/expressions.rst:1361 msgid ":keyword:`lambda`" msgstr "" -#: ../src/Doc/reference/expressions.rst:1361 +#: reference/expressions.rst:1361 #, fuzzy msgid "Lambda expression" msgstr "Fonctions anonymes" -#: ../src/Doc/reference/expressions.rst:1363 +#: reference/expressions.rst:1363 msgid ":keyword:`if` -- :keyword:`else`" msgstr "" -#: ../src/Doc/reference/expressions.rst:1363 +#: reference/expressions.rst:1363 msgid "Conditional expression" msgstr "" -#: ../src/Doc/reference/expressions.rst:1365 +#: reference/expressions.rst:1365 msgid ":keyword:`or`" msgstr "" -#: ../src/Doc/reference/expressions.rst:1365 +#: reference/expressions.rst:1365 msgid "Boolean OR" msgstr "" -#: ../src/Doc/reference/expressions.rst:1367 +#: reference/expressions.rst:1367 msgid ":keyword:`and`" msgstr "" -#: ../src/Doc/reference/expressions.rst:1367 +#: reference/expressions.rst:1367 msgid "Boolean AND" msgstr "" # 9c83cf1334b94aac9f57eca5b8c0cf7f -#: ../src/Doc/reference/expressions.rst:1369 +#: reference/expressions.rst:1369 msgid ":keyword:`not` ``x``" msgstr "" -#: ../src/Doc/reference/expressions.rst:1369 +#: reference/expressions.rst:1369 msgid "Boolean NOT" msgstr "" # fc22b15cc119477f97fab09b420f4af1 -#: ../src/Doc/reference/expressions.rst:1371 +#: reference/expressions.rst:1371 msgid "" ":keyword:`in`, :keyword:`not in`, :keyword:`is`, :keyword:`is not`, ``<``, " "``<=``, ``>``, ``>=``, ``<>``, ``!=``, ``==``" msgstr "" # 408ef4c5c7e544c8a73e0e559638448e -#: ../src/Doc/reference/expressions.rst:1371 +#: reference/expressions.rst:1371 msgid "Comparisons, including membership tests and identity tests" msgstr "" -#: ../src/Doc/reference/expressions.rst:1375 +#: reference/expressions.rst:1375 msgid "``|``" msgstr "" -#: ../src/Doc/reference/expressions.rst:1375 +#: reference/expressions.rst:1375 msgid "Bitwise OR" msgstr "" -#: ../src/Doc/reference/expressions.rst:1377 +#: reference/expressions.rst:1377 msgid "``^``" msgstr "" -#: ../src/Doc/reference/expressions.rst:1377 +#: reference/expressions.rst:1377 msgid "Bitwise XOR" msgstr "" -#: ../src/Doc/reference/expressions.rst:1379 +#: reference/expressions.rst:1379 msgid "``&``" msgstr "" -#: ../src/Doc/reference/expressions.rst:1379 +#: reference/expressions.rst:1379 msgid "Bitwise AND" msgstr "" -#: ../src/Doc/reference/expressions.rst:1381 +#: reference/expressions.rst:1381 msgid "``<<``, ``>>``" msgstr "" -#: ../src/Doc/reference/expressions.rst:1381 +#: reference/expressions.rst:1381 msgid "Shifts" msgstr "" -#: ../src/Doc/reference/expressions.rst:1383 +#: reference/expressions.rst:1383 msgid "``+``, ``-``" msgstr "" -#: ../src/Doc/reference/expressions.rst:1383 +#: reference/expressions.rst:1383 msgid "Addition and subtraction" msgstr "" -#: ../src/Doc/reference/expressions.rst:1385 +#: reference/expressions.rst:1385 msgid "``*``, ``/``, ``//``, ``%``" msgstr "" # 4decff26a3a24609a6efd997d8b699c1 -#: ../src/Doc/reference/expressions.rst:1385 +#: reference/expressions.rst:1385 msgid "Multiplication, division, remainder [#]_" msgstr "" -#: ../src/Doc/reference/expressions.rst:1388 +#: reference/expressions.rst:1388 msgid "``+x``, ``-x``, ``~x``" msgstr "" -#: ../src/Doc/reference/expressions.rst:1388 +#: reference/expressions.rst:1388 msgid "Positive, negative, bitwise NOT" msgstr "" -#: ../src/Doc/reference/expressions.rst:1390 +#: reference/expressions.rst:1390 msgid "``**``" msgstr "" -#: ../src/Doc/reference/expressions.rst:1390 +#: reference/expressions.rst:1390 msgid "Exponentiation [#]_" msgstr "" -#: ../src/Doc/reference/expressions.rst:1392 +#: reference/expressions.rst:1392 msgid "``x[index]``, ``x[index:index]``, ``x(arguments...)``, ``x.attribute``" msgstr "" -#: ../src/Doc/reference/expressions.rst:1392 +#: reference/expressions.rst:1392 msgid "Subscription, slicing, call, attribute reference" msgstr "" # ae301a72fff947749418f4ffdab0099e -#: ../src/Doc/reference/expressions.rst:1395 +#: reference/expressions.rst:1395 msgid "" "``(expressions...)``, ``[expressions...]``, ``{key: value...}``, " "```expressions...```" msgstr "" # 1b1c179fc70141cfb8a8ad45acbdf57e -#: ../src/Doc/reference/expressions.rst:1395 +#: reference/expressions.rst:1395 msgid "" "Binding or tuple display, list display, dictionary display, string conversion" msgstr "" # d0a7a1ff8e3c40acb8b8feefac868ec6 -#: ../src/Doc/reference/expressions.rst:1403 +#: reference/expressions.rst:1403 msgid "" "In Python 2.3 and later releases, a list comprehension \"leaks\" the control " "variables of each ``for`` it contains into the containing scope. However, " @@ -5273,7 +5355,7 @@ msgid "" msgstr "" # 148849a0d81841f684388564cdf7139e -#: ../src/Doc/reference/expressions.rst:1407 +#: reference/expressions.rst:1407 msgid "" "While ``abs(x%y) < abs(y)`` is true mathematically, for floats it may not be " "true numerically due to roundoff. For example, and assuming a platform on " @@ -5286,7 +5368,7 @@ msgid "" msgstr "" # 8f76793fd29f4a91b61768bc803baa41 -#: ../src/Doc/reference/expressions.rst:1416 +#: reference/expressions.rst:1416 msgid "" "If x is very close to an exact integer multiple of y, it's possible for " "``floor(x/y)`` to be one larger than ``(x-x%y)/y`` due to rounding. In such " @@ -5295,7 +5377,7 @@ msgid "" msgstr "" # 40de22f4d78e4e7aa23a86ae5d7afd73 -#: ../src/Doc/reference/expressions.rst:1421 +#: reference/expressions.rst:1421 msgid "" "While comparisons between unicode strings make sense at the byte level, they " "may be counter-intuitive to users. For example, the strings ``u\"\\u00C7\"`` " @@ -5305,13 +5387,13 @@ msgid "" "`unicodedata.normalize`." msgstr "" -#: ../src/Doc/reference/expressions.rst:1428 +#: reference/expressions.rst:1428 msgid "" "The implementation computes this efficiently, without constructing lists or " "sorting." msgstr "" -#: ../src/Doc/reference/expressions.rst:1431 +#: reference/expressions.rst:1431 msgid "" "Earlier versions of Python used lexicographic comparison of the sorted (key, " "value) lists, but this was very expensive for the common case of comparing " @@ -5320,7 +5402,7 @@ msgid "" "to test a dictionary for emptiness by comparing it to ``{}``." msgstr "" -#: ../src/Doc/reference/expressions.rst:1437 +#: reference/expressions.rst:1437 msgid "" "Due to automatic garbage-collection, free lists, and the dynamic nature of " "descriptors, you may notice seemingly unusual behaviour in certain uses of " @@ -5329,33 +5411,33 @@ msgid "" msgstr "" # 39f30010c83140ad91134fe4d37e0702 -#: ../src/Doc/reference/expressions.rst:1442 +#: reference/expressions.rst:1442 msgid "" "The ``%`` operator is also used for string formatting; the same precedence " "applies." msgstr "" -#: ../src/Doc/reference/expressions.rst:1445 +#: reference/expressions.rst:1445 msgid "" "The power operator ``**`` binds less tightly than an arithmetic or bitwise " "unary operator on its right, that is, ``2**-1`` is ``0.5``." msgstr "" -#: ../src/Doc/reference/grammar.rst:2 +#: reference/grammar.rst:2 msgid "Full Grammar specification" msgstr "" -#: ../src/Doc/reference/grammar.rst:4 +#: reference/grammar.rst:4 msgid "" "This is the full Python grammar, as it is read by the parser generator and " "used to parse Python source files:" msgstr "" -#: ../src/Doc/reference/index.rst:5 +#: reference/index.rst:5 msgid "The Python Language Reference" msgstr "" -#: ../src/Doc/reference/index.rst:7 +#: reference/index.rst:7 msgid "" "This reference manual describes the syntax and \"core semantics\" of the " "language. It is terse, but attempts to be exact and complete. The semantics " @@ -5367,17 +5449,17 @@ msgid "" "index` describes the interfaces available to C/C++ programmers in detail." msgstr "" -#: ../src/Doc/reference/introduction.rst:6 +#: reference/introduction.rst:6 msgid "Introduction" msgstr "Introduction" -#: ../src/Doc/reference/introduction.rst:8 +#: reference/introduction.rst:8 msgid "" "This reference manual describes the Python programming language. It is not " "intended as a tutorial." msgstr "" -#: ../src/Doc/reference/introduction.rst:11 +#: reference/introduction.rst:11 msgid "" "While I am trying to be as precise as possible, I chose to use English " "rather than formal specifications for everything except syntax and lexical " @@ -5393,7 +5475,7 @@ msgid "" msgstr "" # 29dca23c5a5e4e2abf264d12c1106f61 -#: ../src/Doc/reference/introduction.rst:23 +#: reference/introduction.rst:23 msgid "" "It is dangerous to add too many implementation details to a language " "reference document --- the implementation may change, and other " @@ -5405,7 +5487,7 @@ msgid "" "\" sprinkled throughout the text." msgstr "" -#: ../src/Doc/reference/introduction.rst:31 +#: reference/introduction.rst:31 msgid "" "Every Python implementation comes with a number of built-in and standard " "modules. These are documented in :ref:`library-index`. A few built-in " @@ -5413,38 +5495,38 @@ msgid "" "language definition." msgstr "" -#: ../src/Doc/reference/introduction.rst:40 +#: reference/introduction.rst:40 msgid "Alternate Implementations" msgstr "" -#: ../src/Doc/reference/introduction.rst:42 +#: reference/introduction.rst:42 msgid "" "Though there is one Python implementation which is by far the most popular, " "there are some alternate implementations which are of particular interest to " "different audiences." msgstr "" -#: ../src/Doc/reference/introduction.rst:46 +#: reference/introduction.rst:46 msgid "Known implementations include:" msgstr "" # 77b83c95da9e480c8fdf9b1e550bc199 -#: ../src/Doc/reference/introduction.rst:49 +#: reference/introduction.rst:50 msgid "CPython" msgstr "CPython" -#: ../src/Doc/reference/introduction.rst:49 +#: reference/introduction.rst:49 msgid "" "This is the original and most-maintained implementation of Python, written " "in C. New language features generally appear here first." msgstr "" # a38ae54a5a0b4611aa173138c3c66940 -#: ../src/Doc/reference/introduction.rst:55 +#: reference/introduction.rst:56 msgid "Jython" msgstr "" -#: ../src/Doc/reference/introduction.rst:53 +#: reference/introduction.rst:53 msgid "" "Python implemented in Java. This implementation can be used as a scripting " "language for Java applications, or can be used to create applications using " @@ -5454,11 +5536,11 @@ msgid "" msgstr "" # 511d8df24d5546c099149e5c4151b455 -#: ../src/Doc/reference/introduction.rst:61 +#: reference/introduction.rst:62 msgid "Python for .NET" msgstr "" -#: ../src/Doc/reference/introduction.rst:59 +#: reference/introduction.rst:59 msgid "" "This implementation actually uses the CPython implementation, but is a " "managed .NET application and makes .NET libraries available. It was created " @@ -5467,12 +5549,12 @@ msgid "" msgstr "" # 462f86eff1d74618a1c16a2047179140 -#: ../src/Doc/reference/introduction.rst:67 +#: reference/introduction.rst:68 msgid "IronPython" msgstr "" # f84b9364bcfb4dbb90009df68237f8ef -#: ../src/Doc/reference/introduction.rst:65 +#: reference/introduction.rst:65 msgid "" "An alternate Python for .NET. Unlike Python.NET, this is a complete Python " "implementation that generates IL, and compiles Python code directly to .NET " @@ -5481,11 +5563,11 @@ msgid "" msgstr "" # fa8c8c5bea09451c980720c6c75809d8 -#: ../src/Doc/reference/introduction.rst:75 +#: reference/introduction.rst:76 msgid "PyPy" msgstr "" -#: ../src/Doc/reference/introduction.rst:71 +#: reference/introduction.rst:71 msgid "" "An implementation of Python written completely in Python. It supports " "several advanced features not found in other implementations like stackless " @@ -5496,7 +5578,7 @@ msgid "" ">`_." msgstr "" -#: ../src/Doc/reference/introduction.rst:78 +#: reference/introduction.rst:78 msgid "" "Each of these implementations varies in some way from the language as " "documented in this manual, or introduces specific information beyond what's " @@ -5505,17 +5587,17 @@ msgid "" "know about the specific implementation you're using." msgstr "" -#: ../src/Doc/reference/introduction.rst:88 +#: reference/introduction.rst:88 msgid "Notation" msgstr "" -#: ../src/Doc/reference/introduction.rst:96 +#: reference/introduction.rst:96 msgid "" "The descriptions of lexical analysis and syntax use a modified BNF grammar " "notation. This uses the following style of definition:" msgstr "" -#: ../src/Doc/reference/introduction.rst:103 +#: reference/introduction.rst:103 msgid "" "The first line says that a ``name`` is an ``lc_letter`` followed by a " "sequence of zero or more ``lc_letter``\\ s and underscores. An " @@ -5524,7 +5606,7 @@ msgid "" "and grammar rules in this document.)" msgstr "" -#: ../src/Doc/reference/introduction.rst:108 +#: reference/introduction.rst:108 msgid "" "Each rule begins with a name (which is the name defined by the rule) and ``::" "=``. A vertical bar (``|``) is used to separate alternatives; it is the " @@ -5539,7 +5621,7 @@ msgid "" "line after the first beginning with a vertical bar." msgstr "" -#: ../src/Doc/reference/introduction.rst:124 +#: reference/introduction.rst:124 msgid "" "In lexical definitions (as the example above), two more conventions are " "used: Two literal characters separated by three dots mean a choice of any " @@ -5549,7 +5631,7 @@ msgid "" "'control character' if needed." msgstr "" -#: ../src/Doc/reference/introduction.rst:131 +#: reference/introduction.rst:131 msgid "" "Even though the notation used is almost the same, there is a big difference " "between the meaning of lexical and syntactic definitions: a lexical " @@ -5560,11 +5642,11 @@ msgid "" "definitions." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:6 +#: reference/lexical_analysis.rst:6 msgid "Lexical analysis" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:13 +#: reference/lexical_analysis.rst:13 msgid "" "A Python program is read by a *parser*. Input to the parser is a stream of " "*tokens*, generated by the *lexical analyzer*. This chapter describes how " @@ -5572,12 +5654,18 @@ msgid "" msgstr "" # 63fd58ad802d430a9cc2359956f6eae5 -#: ../src/Doc/reference/lexical_analysis.rst:17 +#: reference/lexical_analysis.rst:17 msgid "Python uses the 7-bit ASCII character set for program text." msgstr "" +#: reference/lexical_analysis.rst:19 +msgid "" +"An encoding declaration can be used to indicate that string literals and " +"comments use an encoding different from ASCII." +msgstr "" + # dda2b148686c410196d5e63f494ebf7f -#: ../src/Doc/reference/lexical_analysis.rst:23 +#: reference/lexical_analysis.rst:23 msgid "" "For compatibility with older versions, Python only warns if it finds 8-bit " "characters; those warnings should be corrected by either declaring an " @@ -5586,14 +5674,14 @@ msgid "" msgstr "" # 80d9d7dbf50c493ba51f28ea38336fed -#: ../src/Doc/reference/lexical_analysis.rst:28 +#: reference/lexical_analysis.rst:28 msgid "" "The run-time character set depends on the I/O devices connected to the " "program but is generally a superset of ASCII." msgstr "" # 45ce115f4fe34e9cb2185afdb98a6093 -#: ../src/Doc/reference/lexical_analysis.rst:31 +#: reference/lexical_analysis.rst:31 msgid "" "**Future compatibility note:** It may be tempting to assume that the " "character set for 8-bit characters is ISO Latin-1 (an ASCII superset that " @@ -5606,19 +5694,19 @@ msgid "" "This applies both to the source character set and the run-time character set." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:45 +#: reference/lexical_analysis.rst:45 msgid "Line structure" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:49 +#: reference/lexical_analysis.rst:49 msgid "A Python program is divided into a number of *logical lines*." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:55 +#: reference/lexical_analysis.rst:55 msgid "Logical lines" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:63 +#: reference/lexical_analysis.rst:63 msgid "" "The end of a logical line is represented by the token NEWLINE. Statements " "cannot cross logical line boundaries except where NEWLINE is allowed by the " @@ -5627,11 +5715,11 @@ msgid "" "implicit *line joining* rules." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:73 +#: reference/lexical_analysis.rst:73 msgid "Physical lines" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:75 +#: reference/lexical_analysis.rst:75 msgid "" "A physical line is a sequence of characters terminated by an end-of-line " "sequence. In source files, any of the standard platform line termination " @@ -5641,18 +5729,18 @@ msgid "" "forms can be used equally, regardless of platform." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:82 +#: reference/lexical_analysis.rst:82 msgid "" "When embedding Python, source code strings should be passed to Python APIs " "using the standard C conventions for newline characters (the ``\\n`` " "character, representing ASCII LF, is the line terminator)." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:90 +#: reference/lexical_analysis.rst:90 msgid "Comments" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:96 +#: reference/lexical_analysis.rst:96 msgid "" "A comment starts with a hash character (``#``) that is not part of a string " "literal, and ends at the end of the physical line. A comment signifies the " @@ -5660,25 +5748,26 @@ msgid "" "Comments are ignored by the syntax; they are not tokens." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:105 +#: reference/lexical_analysis.rst:105 msgid "Encoding declarations" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:109 +#: reference/lexical_analysis.rst:109 msgid "" "If a comment in the first or second line of the Python script matches the " "regular expression ``coding[=:]\\s*([-\\w.]+)``, this comment is processed " "as an encoding declaration; the first group of this expression names the " -"encoding of the source code file. The recommended forms of this expression " -"are ::" +"encoding of the source code file. The encoding declaration must appear on a " +"line of its own. If it is the second line, the first line must also be a " +"comment-only line. The recommended forms of an encoding expression are ::" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:116 +#: reference/lexical_analysis.rst:118 msgid "which is recognized also by GNU Emacs, and ::" msgstr "" # aea26c5f02d54dbe9c46b447debce496 -#: ../src/Doc/reference/lexical_analysis.rst:120 +#: reference/lexical_analysis.rst:122 msgid "" "which is recognized by Bram Moolenaar's VIM. In addition, if the first bytes " "of the file are the UTF-8 byte-order mark (``'\\xef\\xbb\\xbf'``), the " @@ -5686,22 +5775,20 @@ msgid "" "Microsoft's :program:`notepad`)." msgstr "" -# 3d5b65a1b05a4720a129db269150ce9e -#: ../src/Doc/reference/lexical_analysis.rst:125 +#: reference/lexical_analysis.rst:127 msgid "" "If an encoding is declared, the encoding name must be recognized by Python. " "The encoding is used for all lexical analysis, in particular to find the end " "of a string, and to interpret the contents of Unicode literals. String " "literals are converted to Unicode for syntactical analysis, then converted " -"back to their original encoding before interpretation starts. The encoding " -"declaration must appear on a line of its own." +"back to their original encoding before interpretation starts." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:138 +#: reference/lexical_analysis.rst:139 msgid "Explicit line joining" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:146 +#: reference/lexical_analysis.rst:147 msgid "" "Two or more physical lines may be joined into logical lines using backslash " "characters (``\\``), as follows: when a physical line ends in a backslash " @@ -5710,7 +5797,7 @@ msgid "" "following end-of-line character. For example::" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:157 +#: reference/lexical_analysis.rst:158 msgid "" "A line ending in a backslash cannot carry a comment. A backslash does not " "continue a comment. A backslash does not continue a token except for string " @@ -5719,17 +5806,17 @@ msgid "" "line outside a string literal." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:167 +#: reference/lexical_analysis.rst:168 msgid "Implicit line joining" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:169 +#: reference/lexical_analysis.rst:170 msgid "" "Expressions in parentheses, square brackets or curly braces can be split " "over more than one physical line without using backslashes. For example::" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:177 +#: reference/lexical_analysis.rst:178 msgid "" "Implicitly continued lines can carry comments. The indentation of the " "continuation lines is not important. Blank continuation lines are allowed. " @@ -5738,12 +5825,12 @@ msgid "" "that case they cannot carry comments." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:187 +#: reference/lexical_analysis.rst:188 msgid "Blank lines" msgstr "" # c305b60f8ac94b5aae288ef9f69b8237 -#: ../src/Doc/reference/lexical_analysis.rst:191 +#: reference/lexical_analysis.rst:192 msgid "" "A logical line that contains only spaces, tabs, formfeeds and possibly a " "comment, is ignored (i.e., no NEWLINE token is generated). During " @@ -5753,11 +5840,11 @@ msgid "" "not even whitespace or a comment) terminates a multi-line statement." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:202 +#: reference/lexical_analysis.rst:203 msgid "Indentation" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:213 +#: reference/lexical_analysis.rst:214 msgid "" "Leading whitespace (spaces and tabs) at the beginning of a logical line is " "used to compute the indentation level of the line, which in turn is used to " @@ -5765,7 +5852,7 @@ msgid "" msgstr "" # 3e9f97cc4bb54549b2ed0824ce411e08 -#: ../src/Doc/reference/lexical_analysis.rst:217 +#: reference/lexical_analysis.rst:218 msgid "" "First, tabs are replaced (from left to right) by one to eight spaces such " "that the total number of characters up to and including the replacement is a " @@ -5776,7 +5863,7 @@ msgid "" "backslash determines the indentation." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:225 +#: reference/lexical_analysis.rst:226 msgid "" "**Cross-platform compatibility note:** because of the nature of text editors " "on non-UNIX platforms, it is unwise to use a mixture of spaces and tabs for " @@ -5784,7 +5871,7 @@ msgid "" "different platforms may explicitly limit the maximum indentation level." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:230 +#: reference/lexical_analysis.rst:231 msgid "" "A formfeed character may be present at the start of the line; it will be " "ignored for the indentation calculations above. Formfeed characters " @@ -5792,13 +5879,13 @@ msgid "" "instance, they may reset the space count to zero)." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:239 +#: reference/lexical_analysis.rst:240 msgid "" "The indentation levels of consecutive lines are used to generate INDENT and " "DEDENT tokens, using a stack, as follows." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:242 +#: reference/lexical_analysis.rst:243 msgid "" "Before the first line of the file is read, a single zero is pushed on the " "stack; this will never be popped off again. The numbers pushed on the stack " @@ -5812,28 +5899,28 @@ msgid "" "number remaining on the stack that is larger than zero." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:253 +#: reference/lexical_analysis.rst:254 msgid "" "Here is an example of a correctly (though confusingly) indented piece of " "Python code::" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:268 +#: reference/lexical_analysis.rst:269 msgid "The following example shows various indentation errors::" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:278 +#: reference/lexical_analysis.rst:279 msgid "" "(Actually, the first three errors are detected by the parser; only the last " "error is found by the lexical analyzer --- the indentation of ``return r`` " "does not match a level popped off the stack.)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:286 +#: reference/lexical_analysis.rst:287 msgid "Whitespace between tokens" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:288 +#: reference/lexical_analysis.rst:289 msgid "" "Except at the beginning of a logical line or in string literals, the " "whitespace characters space, tab and formfeed can be used interchangeably to " @@ -5842,11 +5929,11 @@ msgid "" "is one token, but a b is two tokens)." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:298 +#: reference/lexical_analysis.rst:299 msgid "Other tokens" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:300 +#: reference/lexical_analysis.rst:301 msgid "" "Besides NEWLINE, INDENT and DEDENT, the following categories of tokens " "exist: *identifiers*, *keywords*, *literals*, *operators*, and *delimiters*. " @@ -5856,50 +5943,66 @@ msgid "" "from left to right." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:310 +#: reference/lexical_analysis.rst:311 msgid "Identifiers and keywords" msgstr "" # 0e89a04a2d744136a6b8857ccb040b67 -#: ../src/Doc/reference/lexical_analysis.rst:316 +#: reference/lexical_analysis.rst:317 msgid "" "Identifiers (also referred to as *names*) are described by the following " "lexical definitions:" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:326 +#: reference/lexical_analysis.rst:327 msgid "Identifiers are unlimited in length. Case is significant." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:332 +#: reference/lexical_analysis.rst:333 msgid "Keywords" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:338 +#: reference/lexical_analysis.rst:339 msgid "" "The following identifiers are used as reserved words, or *keywords* of the " "language, and cannot be used as ordinary identifiers. They must be spelled " "exactly as written here:" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:368 +#: reference/lexical_analysis.rst:353 +msgid "" +":const:`None` became a constant and is now recognized by the compiler as a " +"name for the built-in object :const:`None`. Although it is not a keyword, " +"you cannot assign a different object to it." +msgstr "" + +#: reference/lexical_analysis.rst:358 +msgid "" +"Using :keyword:`as` and :keyword:`with` as identifiers triggers a warning. " +"To use them as keywords, enable the ``with_statement`` future feature ." +msgstr "" + +#: reference/lexical_analysis.rst:362 +msgid ":keyword:`as` and :keyword:`with` are full keywords." +msgstr "" + +#: reference/lexical_analysis.rst:369 msgid "Reserved classes of identifiers" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:370 +#: reference/lexical_analysis.rst:371 msgid "" "Certain classes of identifiers (besides keywords) have special meanings. " "These classes are identified by the patterns of leading and trailing " "underscore characters:" msgstr "" -# ffc2f0fe74f84a19bb74d52661a2cdd1 -#: ../src/Doc/reference/lexical_analysis.rst:383 -msgid "``_*``" +#: reference/lexical_analysis.rst:385 +msgid "_*" msgstr "" # ea31b639c6b141e59ceea7a3878b33bf -#: ../src/Doc/reference/lexical_analysis.rst:375 +#: reference/lexical_analysis.rst:376 msgid "" "Not imported by ``from module import *``. The special identifier ``_`` is " "used in the interactive interpreter to store the result of the last " @@ -5908,20 +6011,19 @@ msgid "" "section :ref:`import`." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:382 +#: reference/lexical_analysis.rst:383 msgid "" "The name ``_`` is often used in conjunction with internationalization; refer " "to the documentation for the :mod:`gettext` module for more information on " "this convention." msgstr "" -# 826eeb36340146b79735de5584fdbd76 -#: ../src/Doc/reference/lexical_analysis.rst:391 -msgid "``__*__``" +#: reference/lexical_analysis.rst:393 +msgid "__*__" msgstr "" # 1d79d9c82a864c22974d73858a7d156c -#: ../src/Doc/reference/lexical_analysis.rst:387 +#: reference/lexical_analysis.rst:388 msgid "" "System-defined names. These names are defined by the interpreter and its " "implementation (including the standard library). Current system names are " @@ -5931,12 +6033,11 @@ msgid "" "subject to breakage without warning." msgstr "" -# 7957f5a31edf45909938e9243889694f -#: ../src/Doc/reference/lexical_analysis.rst:398 -msgid "``__*``" +#: reference/lexical_analysis.rst:400 +msgid "__*" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:395 +#: reference/lexical_analysis.rst:396 msgid "" "Class-private names. Names in this category, when used within the context " "of a class definition, are re-written to use a mangled form to help avoid " @@ -5944,21 +6045,21 @@ msgid "" "section :ref:`atom-identifiers`." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:410 +#: reference/lexical_analysis.rst:411 msgid "Literals are notations for constant values of some built-in types." msgstr "" # f87643df873b4e719e0e0215a34a40d3 -#: ../src/Doc/reference/lexical_analysis.rst:416 +#: reference/lexical_analysis.rst:417 msgid "String literals" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:420 +#: reference/lexical_analysis.rst:421 msgid "String literals are described by the following lexical definitions:" msgstr "" # 81b0f32f020c45f5a27dc5a07402a952 -#: ../src/Doc/reference/lexical_analysis.rst:437 +#: reference/lexical_analysis.rst:438 msgid "" "One syntactic restriction not indicated by these productions is that " "whitespace is not allowed between the :token:`stringprefix` and the rest of " @@ -5968,7 +6069,7 @@ msgid "" msgstr "" # df5486d1ff5a4de78dc172b7d7cd83e4 -#: ../src/Doc/reference/lexical_analysis.rst:449 +#: reference/lexical_analysis.rst:450 msgid "" "In plain English: String literals can be enclosed in matching single quotes " "(``'``) or double quotes (``\"``). They can also be enclosed in matching " @@ -5987,7 +6088,7 @@ msgid "" "2to3). A ``'u'`` or ``'b'`` prefix may be followed by an ``'r'`` prefix." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:465 +#: reference/lexical_analysis.rst:466 msgid "" "In triple-quoted strings, unescaped newlines and quotes are allowed (and are " "retained), except that three unescaped quotes in a row terminate the " @@ -5995,202 +6096,202 @@ msgid "" "``'`` or ``\"``.)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:475 +#: reference/lexical_analysis.rst:476 msgid "" "Unless an ``'r'`` or ``'R'`` prefix is present, escape sequences in strings " "are interpreted according to rules similar to those used by Standard C. The " "recognized escape sequences are:" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:480 +#: reference/lexical_analysis.rst:481 msgid "Escape Sequence" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:480 +#: reference/lexical_analysis.rst:481 msgid "Notes" msgstr "Notes" -#: ../src/Doc/reference/lexical_analysis.rst:482 +#: reference/lexical_analysis.rst:483 msgid "``\\newline``" msgstr "" # 4d77d6a17a43478eae37e086912887ef -#: ../src/Doc/reference/lexical_analysis.rst:482 +#: reference/lexical_analysis.rst:483 msgid "Ignored" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:484 +#: reference/lexical_analysis.rst:485 msgid "``\\\\``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:484 +#: reference/lexical_analysis.rst:485 msgid "Backslash (``\\``)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:486 +#: reference/lexical_analysis.rst:487 msgid "``\\'``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:486 +#: reference/lexical_analysis.rst:487 msgid "Single quote (``'``)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:488 +#: reference/lexical_analysis.rst:489 msgid "``\\\"``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:488 +#: reference/lexical_analysis.rst:489 msgid "Double quote (``\"``)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:490 +#: reference/lexical_analysis.rst:491 msgid "``\\a``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:490 +#: reference/lexical_analysis.rst:491 msgid "ASCII Bell (BEL)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:492 +#: reference/lexical_analysis.rst:493 msgid "``\\b``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:492 +#: reference/lexical_analysis.rst:493 msgid "ASCII Backspace (BS)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:494 +#: reference/lexical_analysis.rst:495 msgid "``\\f``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:494 +#: reference/lexical_analysis.rst:495 msgid "ASCII Formfeed (FF)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:496 +#: reference/lexical_analysis.rst:497 msgid "``\\n``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:496 +#: reference/lexical_analysis.rst:497 msgid "ASCII Linefeed (LF)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:498 +#: reference/lexical_analysis.rst:499 msgid "``\\N{name}``" msgstr "" # ed403b9f46e14ece94b4a4409fe0cbf4 -#: ../src/Doc/reference/lexical_analysis.rst:498 +#: reference/lexical_analysis.rst:499 msgid "Character named *name* in the Unicode database (Unicode only)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:501 +#: reference/lexical_analysis.rst:502 msgid "``\\r``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:501 +#: reference/lexical_analysis.rst:502 msgid "ASCII Carriage Return (CR)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:503 +#: reference/lexical_analysis.rst:504 msgid "``\\t``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:503 +#: reference/lexical_analysis.rst:504 msgid "ASCII Horizontal Tab (TAB)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:505 +#: reference/lexical_analysis.rst:506 msgid "``\\uxxxx``" msgstr "" # d4e61f7347994b96a930634911f5f90b -#: ../src/Doc/reference/lexical_analysis.rst:505 +#: reference/lexical_analysis.rst:506 msgid "Character with 16-bit hex value *xxxx* (Unicode only)" msgstr "" # 7f7b74fc82e04ed4b7531779cba7d733 -#: ../src/Doc/reference/lexical_analysis.rst:505 +#: reference/lexical_analysis.rst:506 msgid "\\(1)" msgstr "\\(1)" -#: ../src/Doc/reference/lexical_analysis.rst:508 +#: reference/lexical_analysis.rst:509 msgid "``\\Uxxxxxxxx``" msgstr "" # 72bdb8a509774a248dbcf0dccd2ba895 -#: ../src/Doc/reference/lexical_analysis.rst:508 +#: reference/lexical_analysis.rst:509 msgid "Character with 32-bit hex value *xxxxxxxx* (Unicode only)" msgstr "" # f0cc2cdabe7a4216b64cfb861a0eb67d -#: ../src/Doc/reference/lexical_analysis.rst:508 +#: reference/lexical_analysis.rst:509 msgid "\\(2)" msgstr "\\(2)" -#: ../src/Doc/reference/lexical_analysis.rst:511 +#: reference/lexical_analysis.rst:512 msgid "``\\v``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:511 +#: reference/lexical_analysis.rst:512 msgid "ASCII Vertical Tab (VT)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:513 +#: reference/lexical_analysis.rst:514 msgid "``\\ooo``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:513 +#: reference/lexical_analysis.rst:514 msgid "Character with octal value *ooo*" msgstr "" # aea494cfe25f4c02a6513c70e244a0d5 -#: ../src/Doc/reference/lexical_analysis.rst:513 +#: reference/lexical_analysis.rst:514 msgid "(3,5)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:516 +#: reference/lexical_analysis.rst:517 msgid "``\\xhh``" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:516 +#: reference/lexical_analysis.rst:517 msgid "Character with hex value *hh*" msgstr "" # 724d83e2daa54f7d9cdfd6cf16932a6b -#: ../src/Doc/reference/lexical_analysis.rst:516 +#: reference/lexical_analysis.rst:517 msgid "(4,5)" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:521 +#: reference/lexical_analysis.rst:522 msgid "Notes:" msgstr "Notes : " # a70967448efa4a798635cd945d0413b5 -#: ../src/Doc/reference/lexical_analysis.rst:524 +#: reference/lexical_analysis.rst:525 msgid "" "Individual code units which form parts of a surrogate pair can be encoded " "using this escape sequence." msgstr "" # 2274e61c50d643e4a057896b39b5392d -#: ../src/Doc/reference/lexical_analysis.rst:528 +#: reference/lexical_analysis.rst:529 msgid "" "Any Unicode character can be encoded this way, but characters outside the " "Basic Multilingual Plane (BMP) will be encoded using a surrogate pair if " "Python is compiled to use 16-bit code units (the default)." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:533 +#: reference/lexical_analysis.rst:534 msgid "As in Standard C, up to three octal digits are accepted." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:536 +#: reference/lexical_analysis.rst:537 msgid "Unlike in Standard C, exactly two hex digits are required." msgstr "" # c562272031604ce7846cfaa72b57e53d -#: ../src/Doc/reference/lexical_analysis.rst:539 +#: reference/lexical_analysis.rst:540 msgid "" "In a string literal, hexadecimal and octal escapes denote the byte with the " "given value; it is not necessary that the byte encodes a character in the " @@ -6199,7 +6300,7 @@ msgid "" msgstr "" # 37834ad46b5b4ee59f30a42aa000e431 -#: ../src/Doc/reference/lexical_analysis.rst:546 +#: reference/lexical_analysis.rst:547 msgid "" "Unlike Standard C, all unrecognized escape sequences are left in the string " "unchanged, i.e., *the backslash is left in the string*. (This behavior is " @@ -6211,7 +6312,7 @@ msgid "" msgstr "" # 9a687abe55404e9db2254e908f8297d5 -#: ../src/Doc/reference/lexical_analysis.rst:553 +#: reference/lexical_analysis.rst:554 msgid "" "When an ``'r'`` or ``'R'`` prefix is present, a character following a " "backslash is included in the string without change, and *all backslashes are " @@ -6228,7 +6329,7 @@ msgid "" msgstr "" # 85b7b6ec93944e388e05375ffc261670 -#: ../src/Doc/reference/lexical_analysis.rst:566 +#: reference/lexical_analysis.rst:567 msgid "" "When an ``'r'`` or ``'R'`` prefix is used in conjunction with a ``'u'`` or " "``'U'`` prefix, then the ``\\uXXXX`` and ``\\UXXXXXXXX`` escape sequences " @@ -6240,12 +6341,12 @@ msgid "" "only recognized when there are an odd number of backslashes." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:579 +#: reference/lexical_analysis.rst:580 msgid "String literal concatenation" msgstr "" # 8f4fe024a66c4ff38450b2af60534fac -#: ../src/Doc/reference/lexical_analysis.rst:581 +#: reference/lexical_analysis.rst:582 msgid "" "Multiple adjacent string literals (delimited by whitespace), possibly using " "different quoting conventions, are allowed, and their meaning is the same as " @@ -6255,7 +6356,7 @@ msgid "" "even to add comments to parts of strings, for example::" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:592 +#: reference/lexical_analysis.rst:593 msgid "" "Note that this feature is defined at the syntactical level, but implemented " "at compile time. The '+' operator must be used to concatenate string " @@ -6264,12 +6365,12 @@ msgid "" "triple quoted strings)." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:601 +#: reference/lexical_analysis.rst:602 msgid "Numeric literals" msgstr "" # b1ca99ce19b44661ac2c1fa9336cf51f -#: ../src/Doc/reference/lexical_analysis.rst:617 +#: reference/lexical_analysis.rst:618 msgid "" "There are four types of numeric literals: plain integers, long integers, " "floating point numbers, and imaginary numbers. There are no complex " @@ -6277,7 +6378,7 @@ msgid "" "imaginary number)." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:621 +#: reference/lexical_analysis.rst:622 msgid "" "Note that numeric literals do not include a sign; a phrase like ``-1`` is " "actually an expression composed of the unary operator '``-``' and the " @@ -6285,19 +6386,19 @@ msgid "" msgstr "" # 2630a70d118e4304882901ea0b40dc70 -#: ../src/Doc/reference/lexical_analysis.rst:629 +#: reference/lexical_analysis.rst:630 msgid "Integer and long integer literals" msgstr "" # d63a46fd72e646feb3ecac87055de7a8 -#: ../src/Doc/reference/lexical_analysis.rst:631 +#: reference/lexical_analysis.rst:632 msgid "" "Integer and long integer literals are described by the following lexical " "definitions:" msgstr "" # 207bd3c36bf2442e8b8cef52ca85be2d -#: ../src/Doc/reference/lexical_analysis.rst:646 +#: reference/lexical_analysis.rst:647 msgid "" "Although both lower case ``'l'`` and upper case ``'L'`` are allowed as " "suffix for long integers, it is strongly recommended to always use ``'L'``, " @@ -6305,7 +6406,7 @@ msgid "" msgstr "" # db00372895a94badbde0a7e05eb8a465 -#: ../src/Doc/reference/lexical_analysis.rst:650 +#: reference/lexical_analysis.rst:651 msgid "" "Plain integer literals that are above the largest representable plain " "integer (e.g., 2147483647 when using 32-bit arithmetic) are accepted as if " @@ -6314,23 +6415,23 @@ msgid "" msgstr "" # c74f962ce1d847efabe2c3becb1afab5 -#: ../src/Doc/reference/lexical_analysis.rst:655 +#: reference/lexical_analysis.rst:656 msgid "" "Some examples of plain integer literals (first row) and long integer " "literals (second and third rows)::" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:666 +#: reference/lexical_analysis.rst:667 msgid "Floating point literals" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:668 +#: reference/lexical_analysis.rst:669 msgid "" "Floating point literals are described by the following lexical definitions:" msgstr "" # 5484f9ee6bde46f991385b6c7fe70e70 -#: ../src/Doc/reference/lexical_analysis.rst:678 +#: reference/lexical_analysis.rst:679 msgid "" "Note that the integer and exponent parts of floating point numbers can look " "like octal integers, but are interpreted using radix 10. For example, " @@ -6339,22 +6440,22 @@ msgid "" "of floating point literals::" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:686 +#: reference/lexical_analysis.rst:687 msgid "" "Note that numeric literals do not include a sign; a phrase like ``-1`` is " "actually an expression composed of the unary operator ``-`` and the literal " "``1``." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:694 +#: reference/lexical_analysis.rst:695 msgid "Imaginary literals" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:696 +#: reference/lexical_analysis.rst:697 msgid "Imaginary literals are described by the following lexical definitions:" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:701 +#: reference/lexical_analysis.rst:702 msgid "" "An imaginary literal yields a complex number with a real part of 0.0. " "Complex numbers are represented as a pair of floating point numbers and have " @@ -6363,31 +6464,31 @@ msgid "" "Some examples of imaginary literals::" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:713 +#: reference/lexical_analysis.rst:714 msgid "Operators" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:717 +#: reference/lexical_analysis.rst:718 msgid "The following tokens are operators::" msgstr "" # 057b9f62aeca41fcb31bf75e65a03a93 -#: ../src/Doc/reference/lexical_analysis.rst:723 +#: reference/lexical_analysis.rst:724 msgid "" "The comparison operators ``<>`` and ``!=`` are alternate spellings of the " "same operator. ``!=`` is the preferred spelling; ``<>`` is obsolescent." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:730 +#: reference/lexical_analysis.rst:731 msgid "Delimiters" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:734 +#: reference/lexical_analysis.rst:735 msgid "The following tokens serve as delimiters in the grammar::" msgstr "" # 30485b65400b4fd786a9a4cf3ba3f038 -#: ../src/Doc/reference/lexical_analysis.rst:741 +#: reference/lexical_analysis.rst:742 msgid "" "The period can also occur in floating-point and imaginary literals. A " "sequence of three periods has a special meaning as an ellipsis in slices. " @@ -6395,20 +6496,20 @@ msgid "" "lexically as delimiters, but also perform an operation." msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:746 +#: reference/lexical_analysis.rst:747 msgid "" "The following printing ASCII characters have special meaning as part of " "other tokens or are otherwise significant to the lexical analyzer::" msgstr "" -#: ../src/Doc/reference/lexical_analysis.rst:753 +#: reference/lexical_analysis.rst:754 msgid "" "The following printing ASCII characters are not used in Python. Their " "occurrence outside string literals and comments is an unconditional error::" msgstr "" # d6a8ef39a0874fe79851fe442b5c962c -#: ../src/Doc/reference/lexical_analysis.rst:760 +#: reference/lexical_analysis.rst:761 msgid "" "In versions of Python prior to 2.4, octal and hexadecimal literals in the " "range just above the largest representable plain integer but below the " @@ -6417,22 +6518,22 @@ msgid "" "4294967296 from their unsigned value." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:6 +#: reference/simple_stmts.rst:6 msgid "Simple statements" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:10 +#: reference/simple_stmts.rst:10 msgid "" "Simple statements are comprised within a single logical line. Several simple " "statements may occur on a single line separated by semicolons. The syntax " "for simple statements is:" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:35 +#: reference/simple_stmts.rst:35 msgid "Expression statements" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:41 +#: reference/simple_stmts.rst:41 msgid "" "Expression statements are used (mostly interactively) to compute and write a " "value, or (usually) to call a procedure (a function that returns no " @@ -6441,14 +6542,14 @@ msgid "" "syntax for an expression statement is:" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:50 +#: reference/simple_stmts.rst:50 msgid "" "An expression statement evaluates the expression list (which may be a single " "expression)." msgstr "" # 815bce7af9f1499b922f5769e2ae92e4 -#: ../src/Doc/reference/simple_stmts.rst:62 +#: reference/simple_stmts.rst:62 msgid "" "In interactive mode, if the value is not ``None``, it is converted to a " "string using the built-in :func:`repr` function and the resulting string is " @@ -6457,24 +6558,23 @@ msgid "" "calls do not cause any output.)" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:72 +#: reference/simple_stmts.rst:72 msgid "Assignment statements" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:82 +#: reference/simple_stmts.rst:82 msgid "" "Assignment statements are used to (re)bind names to values and to modify " "attributes or items of mutable objects:" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:95 -#: ../src/Doc/reference/simple_stmts.rst:267 +#: reference/simple_stmts.rst:95 reference/simple_stmts.rst:267 msgid "" "(See section :ref:`primaries` for the syntax definitions for the last three " "symbols.)" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:100 +#: reference/simple_stmts.rst:100 msgid "" "An assignment statement evaluates the expression list (remember that this " "can be a single expression or a comma-separated list, the latter yielding a " @@ -6482,7 +6582,7 @@ msgid "" "from left to right." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:109 +#: reference/simple_stmts.rst:109 msgid "" "Assignment is defined recursively depending on the form of the target " "(list). When a target is part of a mutable object (an attribute reference, " @@ -6494,18 +6594,18 @@ msgid "" msgstr "" # 346b19a2de8b42ea817ce8797e20db6f -#: ../src/Doc/reference/simple_stmts.rst:118 +#: reference/simple_stmts.rst:118 msgid "" "Assignment of an object to a target list is recursively defined as follows." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:120 +#: reference/simple_stmts.rst:120 msgid "" "If the target list is a single target: The object is assigned to that target." msgstr "" # 97512ef2abc1447786873687a71e6e57 -#: ../src/Doc/reference/simple_stmts.rst:122 +#: reference/simple_stmts.rst:122 msgid "" "If the target list is a comma-separated list of targets: The object must be " "an iterable with the same number of items as there are targets in the target " @@ -6513,36 +6613,36 @@ msgid "" "targets." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:126 +#: reference/simple_stmts.rst:126 msgid "" "Assignment of an object to a single target is recursively defined as follows." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:128 +#: reference/simple_stmts.rst:128 msgid "If the target is an identifier (name):" msgstr "" # b1bbe196bc2b47fd905c9f189830eb33 -#: ../src/Doc/reference/simple_stmts.rst:132 +#: reference/simple_stmts.rst:132 msgid "" "If the name does not occur in a :keyword:`global` statement in the current " "code block: the name is bound to the object in the current local namespace." msgstr "" # b5610ab76d364721ab1701d10c02dfb2 -#: ../src/Doc/reference/simple_stmts.rst:135 +#: reference/simple_stmts.rst:135 msgid "" "Otherwise: the name is bound to the object in the current global namespace." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:139 +#: reference/simple_stmts.rst:139 msgid "" "The name is rebound if it was already bound. This may cause the reference " "count for the object previously bound to the name to reach zero, causing the " "object to be deallocated and its destructor (if it has one) to be called." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:143 +#: reference/simple_stmts.rst:143 msgid "" "If the target is a target list enclosed in parentheses or in square " "brackets: The object must be an iterable with the same number of items as " @@ -6550,7 +6650,7 @@ msgid "" "to right, to the corresponding targets." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:150 +#: reference/simple_stmts.rst:150 msgid "" "If the target is an attribute reference: The primary expression in the " "reference is evaluated. It should yield an object with assignable " @@ -6560,7 +6660,7 @@ msgid "" "necessarily :exc:`AttributeError`)." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:159 +#: reference/simple_stmts.rst:159 msgid "" "Note: If the object is a class instance and the attribute reference occurs " "on both sides of the assignment operator, the RHS expression, ``a.x`` can " @@ -6572,14 +6672,14 @@ msgid "" "of the assignment::" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:173 +#: reference/simple_stmts.rst:173 msgid "" "This description does not necessarily apply to descriptor attributes, such " "as properties created with :func:`property`." msgstr "" # 64a187abc5d14cd891ab263a98347bd7 -#: ../src/Doc/reference/simple_stmts.rst:180 +#: reference/simple_stmts.rst:180 msgid "" "If the target is a subscription: The primary expression in the reference is " "evaluated. It should yield either a mutable sequence object (such as a " @@ -6588,7 +6688,7 @@ msgid "" msgstr "" # 36d9da23aa454c0ca2592f602aeed83e -#: ../src/Doc/reference/simple_stmts.rst:189 +#: reference/simple_stmts.rst:189 msgid "" "If the primary is a mutable sequence object (such as a list), the subscript " "must yield a plain integer. If it is negative, the sequence's length is " @@ -6599,7 +6699,7 @@ msgid "" "items to a list)." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:200 +#: reference/simple_stmts.rst:200 msgid "" "If the primary is a mapping object (such as a dictionary), the subscript " "must have a type compatible with the mapping's key type, and the mapping is " @@ -6610,7 +6710,7 @@ msgid "" msgstr "" # 3bd533bffaa641e6ad8a4a1e3c03ce71 -#: ../src/Doc/reference/simple_stmts.rst:208 +#: reference/simple_stmts.rst:208 msgid "" "If the target is a slicing: The primary expression in the reference is " "evaluated. It should yield a mutable sequence object (such as a list). The " @@ -6625,14 +6725,14 @@ msgid "" "changing the length of the target sequence, if the object allows it." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:222 +#: reference/simple_stmts.rst:222 msgid "" "In the current implementation, the syntax for targets is taken to be the " "same as for expressions, and invalid syntax is rejected during the code " "generation phase, causing less detailed error messages." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:226 +#: reference/simple_stmts.rst:226 msgid "" "WARNING: Although the definition of assignment implies that overlaps between " "the left-hand side and the right-hand side are 'safe' (for example ``a, b = " @@ -6641,17 +6741,17 @@ msgid "" "2]``::" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:240 +#: reference/simple_stmts.rst:240 msgid "Augmented assignment statements" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:258 +#: reference/simple_stmts.rst:258 msgid "" "Augmented assignment is the combination, in a single statement, of a binary " "operation and an assignment statement:" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:270 +#: reference/simple_stmts.rst:270 msgid "" "An augmented assignment evaluates the target (which, unlike normal " "assignment statements, cannot be an unpacking) and the expression list, " @@ -6660,7 +6760,7 @@ msgid "" "evaluated once." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:275 +#: reference/simple_stmts.rst:275 msgid "" "An augmented assignment expression like ``x += 1`` can be rewritten as ``x = " "x + 1`` to achieve a similar, but not exactly equal effect. In the augmented " @@ -6669,7 +6769,7 @@ msgid "" "object and assigning that to the target, the old object is modified instead." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:281 +#: reference/simple_stmts.rst:281 msgid "" "With the exception of assigning to tuples and multiple targets in a single " "statement, the assignment done by augmented assignment statements is handled " @@ -6678,33 +6778,33 @@ msgid "" "assignment is the same as the normal binary operations." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:287 +#: reference/simple_stmts.rst:287 msgid "" "For targets which are attribute references, the same :ref:`caveat about " "class and instance attributes <attr-target-note>` applies as for regular " "assignments." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:294 +#: reference/simple_stmts.rst:294 msgid "The :keyword:`assert` statement" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:300 +#: reference/simple_stmts.rst:300 msgid "" "Assert statements are a convenient way to insert debugging assertions into a " "program:" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:306 +#: reference/simple_stmts.rst:306 msgid "The simple form, ``assert expression``, is equivalent to ::" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:311 +#: reference/simple_stmts.rst:311 msgid "" "The extended form, ``assert expression1, expression2``, is equivalent to ::" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:320 +#: reference/simple_stmts.rst:320 msgid "" "These equivalences assume that :const:`__debug__` and :exc:`AssertionError` " "refer to the built-in variables with those names. In the current " @@ -6716,42 +6816,42 @@ msgid "" "error message; it will be displayed as part of the stack trace." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:329 +#: reference/simple_stmts.rst:329 msgid "" "Assignments to :const:`__debug__` are illegal. The value for the built-in " "variable is determined when the interpreter starts." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:336 +#: reference/simple_stmts.rst:336 msgid "The :keyword:`pass` statement" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:345 +#: reference/simple_stmts.rst:345 msgid "" ":keyword:`pass` is a null operation --- when it is executed, nothing " "happens. It is useful as a placeholder when a statement is required " "syntactically, but no code needs to be executed, for example::" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:357 +#: reference/simple_stmts.rst:357 msgid "The :keyword:`del` statement" msgstr "L'instruction :keyword:`del`" # 184528231d394424ac43191e923ac751 -#: ../src/Doc/reference/simple_stmts.rst:367 +#: reference/simple_stmts.rst:367 msgid "" "Deletion is recursively defined very similar to the way assignment is " "defined. Rather than spelling it out in full details, here are some hints." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:370 +#: reference/simple_stmts.rst:370 msgid "" "Deletion of a target list recursively deletes each target, from left to " "right." msgstr "" # 6e3068ab71c14de0a4c98aa331976336 -#: ../src/Doc/reference/simple_stmts.rst:376 +#: reference/simple_stmts.rst:376 msgid "" "Deletion of a name removes the binding of that name from the local or " "global namespace, depending on whether the name occurs in a :keyword:" @@ -6759,13 +6859,13 @@ msgid "" "`NameError` exception will be raised." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:383 +#: reference/simple_stmts.rst:383 msgid "" "It is illegal to delete a name from the local namespace if it occurs as a " "free variable in a nested block." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:388 +#: reference/simple_stmts.rst:388 msgid "" "Deletion of attribute references, subscriptions and slicings is passed to " "the primary object involved; deletion of a slicing is in general equivalent " @@ -6774,12 +6874,12 @@ msgid "" msgstr "" # 624653a6473843729076c0ba551740b3 -#: ../src/Doc/reference/simple_stmts.rst:397 +#: reference/simple_stmts.rst:397 msgid "The :keyword:`print` statement" msgstr "" # bec14bfcfef74e3a917dababa9753fb2 -#: ../src/Doc/reference/simple_stmts.rst:405 +#: reference/simple_stmts.rst:405 msgid "" ":keyword:`print` evaluates each expression in turn and writes the resulting " "object to standard output (see below). If an object is not a string, it is " @@ -6795,7 +6895,7 @@ msgid "" msgstr "" # 2ae9bd41f5e24534941ec85d30981ce6 -#: ../src/Doc/reference/simple_stmts.rst:419 +#: reference/simple_stmts.rst:419 msgid "" "Objects which act like file objects but which are not the built-in file " "objects often do not properly emulate this aspect of the file object's " @@ -6803,7 +6903,7 @@ msgid "" msgstr "" # 4a0e5f8f330340f69e446385872a0a4a -#: ../src/Doc/reference/simple_stmts.rst:429 +#: reference/simple_stmts.rst:429 msgid "" "A ``'\\n'`` character is written at the end, unless the :keyword:`print` " "statement ends with a comma. This is the only action if the statement " @@ -6811,7 +6911,7 @@ msgid "" msgstr "" # 20a1d0b9c2794208938ad70a1dbd88d0 -#: ../src/Doc/reference/simple_stmts.rst:439 +#: reference/simple_stmts.rst:439 msgid "" "Standard output is defined as the file object named ``stdout`` in the built-" "in module :mod:`sys`. If no such object exists, or if it does not have a :" @@ -6819,7 +6919,7 @@ msgid "" msgstr "" # 2821892f2ef5483695ff7532d7bc348b -#: ../src/Doc/reference/simple_stmts.rst:445 +#: reference/simple_stmts.rst:445 msgid "" ":keyword:`print` also has an extended form, defined by the second portion of " "the syntax described above. This form is sometimes referred to as \":keyword:" @@ -6830,36 +6930,36 @@ msgid "" "evaluates to ``None``, then ``sys.stdout`` is used as the file for output." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:457 +#: reference/simple_stmts.rst:457 msgid "The :keyword:`return` statement" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:467 +#: reference/simple_stmts.rst:467 msgid "" ":keyword:`return` may only occur syntactically nested in a function " "definition, not within a nested class definition." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:470 +#: reference/simple_stmts.rst:470 msgid "" "If an expression list is present, it is evaluated, else ``None`` is " "substituted." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:472 +#: reference/simple_stmts.rst:472 msgid "" ":keyword:`return` leaves the current function call with the expression list " "(or ``None``) as return value." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:477 +#: reference/simple_stmts.rst:477 msgid "" "When :keyword:`return` passes control out of a :keyword:`try` statement with " "a :keyword:`finally` clause, that :keyword:`finally` clause is executed " "before really leaving the function." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:481 +#: reference/simple_stmts.rst:481 msgid "" "In a generator function, the :keyword:`return` statement is not allowed to " "include an :token:`expression_list`. In that context, a bare :keyword:" @@ -6867,13 +6967,13 @@ msgid "" "`StopIteration` to be raised." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:490 +#: reference/simple_stmts.rst:490 #, fuzzy msgid "The :keyword:`yield` statement" msgstr "L'instruction :keyword:`del`" # bcdc02c86d514f3188d2f0139eabd971 -#: ../src/Doc/reference/simple_stmts.rst:502 +#: reference/simple_stmts.rst:502 msgid "" "The :keyword:`yield` statement is only used when defining a generator " "function, and is only used in the body of the generator function. Using a :" @@ -6882,7 +6982,7 @@ msgid "" msgstr "" # aa1478dd11054df59c5cbff32f07f681 -#: ../src/Doc/reference/simple_stmts.rst:507 +#: reference/simple_stmts.rst:507 msgid "" "When a generator function is called, it returns an iterator known as a " "generator iterator, or more commonly, a generator. The body of the " @@ -6891,7 +6991,7 @@ msgid "" msgstr "" # fb721c7c618b435eb46d81310d06fd9d -#: ../src/Doc/reference/simple_stmts.rst:512 +#: reference/simple_stmts.rst:512 msgid "" "When a :keyword:`yield` statement is executed, the state of the generator is " "frozen and the value of :token:`expression_list` is returned to :meth:" @@ -6904,7 +7004,7 @@ msgid "" msgstr "" # b5e7917c506b421c86474e0a999fb2ec -#: ../src/Doc/reference/simple_stmts.rst:520 +#: reference/simple_stmts.rst:520 msgid "" "As of Python version 2.5, the :keyword:`yield` statement is now allowed in " "the :keyword:`try` clause of a :keyword:`try` ... :keyword:`finally` " @@ -6915,44 +7015,43 @@ msgid "" msgstr "" # c740e01c103b496bbe804462e721de10 -#: ../src/Doc/reference/simple_stmts.rst:527 +#: reference/simple_stmts.rst:527 msgid "" "For full details of :keyword:`yield` semantics, refer to the :ref:" "`yieldexpr` section." msgstr "" # d862c2c1169f4b788dbc8ac06825b29e -#: ../src/Doc/reference/simple_stmts.rst:532 +#: reference/simple_stmts.rst:532 msgid "" "In Python 2.2, the :keyword:`yield` statement was only allowed when the " "``generators`` feature has been enabled. This ``__future__`` import " "statement was used to enable the feature::" msgstr "" -# 46fe4373d01d4cc7a5900cc626613861 -#: ../src/Doc/reference/simple_stmts.rst:541 -msgid ":pep:`0255` - Simple Generators" +#: reference/simple_stmts.rst:542 +msgid "PEP 0255 - Simple Generators" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:542 +#: reference/simple_stmts.rst:542 msgid "" "The proposal for adding generators and the :keyword:`yield` statement to " "Python." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:545 +#: reference/simple_stmts.rst:545 msgid "" "The proposal that, among other generator enhancements, proposed allowing :" "keyword:`yield` to appear inside a :keyword:`try` ... :keyword:`finally` " "block." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:552 +#: reference/simple_stmts.rst:552 msgid "The :keyword:`raise` statement" msgstr "" # 294492b6f991484d99a81c79e11dddce -#: ../src/Doc/reference/simple_stmts.rst:562 +#: reference/simple_stmts.rst:562 msgid "" "If no expressions are present, :keyword:`raise` re-raises the last exception " "that was active in the current scope. If no exception is active in the " @@ -6962,7 +7061,7 @@ msgid "" msgstr "" # 00f41af04f9442158afa901ade820a1e -#: ../src/Doc/reference/simple_stmts.rst:567 +#: reference/simple_stmts.rst:567 msgid "" "Otherwise, :keyword:`raise` evaluates the expressions to get three objects, " "using ``None`` as the value of omitted expressions. The first two objects " @@ -6970,7 +7069,7 @@ msgid "" msgstr "" # e1a83dad3692439abdce252c38051934 -#: ../src/Doc/reference/simple_stmts.rst:571 +#: reference/simple_stmts.rst:571 msgid "" "If the first object is an instance, the type of the exception is the class " "of the instance, the instance itself is the value, and the second object " @@ -6978,7 +7077,7 @@ msgid "" msgstr "" # 555fb88c41b64766a0c9b28a9dbd94b7 -#: ../src/Doc/reference/simple_stmts.rst:575 +#: reference/simple_stmts.rst:575 msgid "" "If the first object is a class, it becomes the type of the exception. The " "second object is used to determine the exception value: If it is an instance " @@ -6990,7 +7089,7 @@ msgid "" msgstr "" # 73a2a3e7a1cd4e09ada3824dd34fc258 -#: ../src/Doc/reference/simple_stmts.rst:585 +#: reference/simple_stmts.rst:585 msgid "" "If a third object is present and not ``None``, it must be a traceback object " "(see section :ref:`types`), and it is substituted instead of the current " @@ -7002,48 +7101,48 @@ msgid "" "the most recently active exception in the current scope." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:594 +#: reference/simple_stmts.rst:594 msgid "" "Additional information on exceptions can be found in section :ref:" "`exceptions`, and information about handling exceptions is in section :ref:" "`try`." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:601 +#: reference/simple_stmts.rst:601 msgid "The :keyword:`break` statement" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:612 +#: reference/simple_stmts.rst:612 msgid "" ":keyword:`break` may only occur syntactically nested in a :keyword:`for` or :" "keyword:`while` loop, but not nested in a function or class definition " "within that loop." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:618 +#: reference/simple_stmts.rst:618 msgid "" "It terminates the nearest enclosing loop, skipping the optional :keyword:" "`else` clause if the loop has one." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:623 +#: reference/simple_stmts.rst:623 msgid "" "If a :keyword:`for` loop is terminated by :keyword:`break`, the loop control " "target keeps its current value." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:628 +#: reference/simple_stmts.rst:628 msgid "" "When :keyword:`break` passes control out of a :keyword:`try` statement with " "a :keyword:`finally` clause, that :keyword:`finally` clause is executed " "before really leaving the loop." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:636 +#: reference/simple_stmts.rst:636 msgid "The :keyword:`continue` statement" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:648 +#: reference/simple_stmts.rst:648 msgid "" ":keyword:`continue` may only occur syntactically nested in a :keyword:`for` " "or :keyword:`while` loop, but not nested in a function or class definition " @@ -7051,19 +7150,19 @@ msgid "" "cycle of the nearest enclosing loop." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:653 +#: reference/simple_stmts.rst:653 msgid "" "When :keyword:`continue` passes control out of a :keyword:`try` statement " "with a :keyword:`finally` clause, that :keyword:`finally` clause is executed " "before really starting the next loop cycle." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:662 +#: reference/simple_stmts.rst:662 msgid "The :keyword:`import` statement" msgstr "" # 85c8678938d7458fb0277678d754fb94 -#: ../src/Doc/reference/simple_stmts.rst:682 +#: reference/simple_stmts.rst:682 msgid "" "Import statements are executed in two steps: (1) find a module, and " "initialize it if necessary; (2) define a name or names in the local " @@ -7075,7 +7174,7 @@ msgid "" msgstr "" # a475df7b032a43829b40176011e04fdd -#: ../src/Doc/reference/simple_stmts.rst:693 +#: reference/simple_stmts.rst:693 msgid "" "To understand how step (1) occurs, one must first understand how Python " "handles hierarchical naming of modules. To help organize modules and provide " @@ -7086,7 +7185,7 @@ msgid "" msgstr "" # a7595c8eeae14dd89312f8aa13ba019c -#: ../src/Doc/reference/simple_stmts.rst:703 +#: reference/simple_stmts.rst:703 msgid "" "Once the name of the module is known (unless otherwise specified, the term " "\"module\" will refer to both packages and modules), searching for the " @@ -7096,7 +7195,7 @@ msgid "" msgstr "" # 9201e02028e94f5d8a5f8e2a8eb04e87 -#: ../src/Doc/reference/simple_stmts.rst:715 +#: reference/simple_stmts.rst:715 msgid "" "If the module is not found in the cache, then :data:`sys.meta_path` is " "searched (the specification for :data:`sys.meta_path` can be found in :pep:" @@ -7110,7 +7209,7 @@ msgid "" "the module it returns a :term:`loader` (discussed later) or returns ``None``." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:731 +#: reference/simple_stmts.rst:731 msgid "" "If none of the finders on :data:`sys.meta_path` are able to find the module " "then some implicitly defined finders are queried. Implementations of Python " @@ -7119,7 +7218,7 @@ msgid "" "path_importer_cache`, and :data:`sys.path`." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:737 +#: reference/simple_stmts.rst:737 msgid "" "The implicit finder searches for the requested module in the \"paths\" " "specified in one of two places (\"paths\" do not have to be file system " @@ -7131,7 +7230,7 @@ msgid "" msgstr "" # 1c9325d8c6884032b46582044e7bea0b -#: ../src/Doc/reference/simple_stmts.rst:744 +#: reference/simple_stmts.rst:744 msgid "" "Once the source of paths is chosen it is iterated over to find a finder that " "can handle that path. The dict at :data:`sys.path_importer_cache` caches " @@ -7147,7 +7246,7 @@ msgid "" "``None`` is placed in the cache for the path." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:762 +#: reference/simple_stmts.rst:762 msgid "" "If no finder can find the module then :exc:`ImportError` is raised. " "Otherwise some finder returned a loader whose :meth:`load_module` method is " @@ -7163,7 +7262,7 @@ msgid "" "in :data:`sys.modules` it is left in the dict." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:782 +#: reference/simple_stmts.rst:782 msgid "" "The loader must set several attributes on the module. :data:`__name__` is to " "be set to the name of the module. :data:`__file__` is to be the \"path\" to " @@ -7178,19 +7277,19 @@ msgid "" "module." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:797 +#: reference/simple_stmts.rst:797 msgid "" "If an error occurs during loading then the loader raises :exc:`ImportError` " "if some other exception is not already being propagated. Otherwise the " "loader returns the module that was loaded and initialized." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:801 +#: reference/simple_stmts.rst:801 msgid "" "When step (1) finishes without raising an exception, step (2) can begin." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:803 +#: reference/simple_stmts.rst:803 msgid "" "The first form of :keyword:`import` statement binds the module name in the " "local namespace to the module object, and then goes on to import the next " @@ -7198,7 +7297,7 @@ msgid "" "name following :keyword:`as` is used as the local name for the module." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:812 +#: reference/simple_stmts.rst:812 msgid "" "The :keyword:`from` form does not bind the module name: it goes through the " "list of identifiers, looks each one of them up in the module found in step " @@ -7210,7 +7309,7 @@ msgid "" "local namespace of the :keyword:`import` statement.." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:823 +#: reference/simple_stmts.rst:823 msgid "" "The *public names* defined by a module are determined by checking the " "module's namespace for a variable named ``__all__``; if defined, it must be " @@ -7224,7 +7323,7 @@ msgid "" msgstr "" # b49e2185a01a4c45959c9d367d4ce25f -#: ../src/Doc/reference/simple_stmts.rst:833 +#: reference/simple_stmts.rst:833 msgid "" "The :keyword:`from` form with ``*`` may only occur in a module scope. If " "the wild card form of import --- ``import *`` --- is used in a function and " @@ -7233,7 +7332,7 @@ msgid "" msgstr "" # b949da19675841da823c36c880259d5b -#: ../src/Doc/reference/simple_stmts.rst:841 +#: reference/simple_stmts.rst:841 msgid "" "When specifying what module to import you do not have to specify the " "absolute name of the module. When a module or package is contained within " @@ -7250,17 +7349,17 @@ msgid "" "within :pep:`328`." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:854 +#: reference/simple_stmts.rst:854 msgid "" ":func:`importlib.import_module` is provided to support applications that " "determine which modules need to be loaded dynamically." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:861 +#: reference/simple_stmts.rst:861 msgid "Future statements" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:865 +#: reference/simple_stmts.rst:865 msgid "" "A :dfn:`future statement` is a directive to the compiler that a particular " "module should be compiled using syntax or semantics that will be available " @@ -7270,30 +7369,30 @@ msgid "" "basis before the release in which the feature becomes standard." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:880 +#: reference/simple_stmts.rst:880 msgid "" "A future statement must appear near the top of the module. The only lines " "that can appear before a future statement are:" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:883 +#: reference/simple_stmts.rst:883 msgid "the module docstring (if any)," msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:884 +#: reference/simple_stmts.rst:884 msgid "comments," msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:885 +#: reference/simple_stmts.rst:885 msgid "blank lines, and" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:886 +#: reference/simple_stmts.rst:886 msgid "other future statements." msgstr "" # dca93962c9a54490bf61e9f347fd31a8 -#: ../src/Doc/reference/simple_stmts.rst:888 +#: reference/simple_stmts.rst:888 msgid "" "The features recognized by Python 2.6 are ``unicode_literals``, " "``print_function``, ``absolute_import``, ``division``, ``generators``, " @@ -7302,7 +7401,7 @@ msgid "" "and above because they are always enabled." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:894 +#: reference/simple_stmts.rst:894 msgid "" "A future statement is recognized and treated specially at compile time: " "Changes to the semantics of core constructs are often implemented by " @@ -7312,38 +7411,38 @@ msgid "" "cannot be pushed off until runtime." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:901 +#: reference/simple_stmts.rst:901 msgid "" "For any given release, the compiler knows which feature names have been " "defined, and raises a compile-time error if a future statement contains a " "feature not known to it." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:905 +#: reference/simple_stmts.rst:905 msgid "" "The direct runtime semantics are the same as for any import statement: there " "is a standard module :mod:`__future__`, described later, and it will be " "imported in the usual way at the time the future statement is executed." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:909 +#: reference/simple_stmts.rst:909 msgid "" "The interesting runtime semantics depend on the specific feature enabled by " "the future statement." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:912 +#: reference/simple_stmts.rst:912 msgid "Note that there is nothing special about the statement::" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:916 +#: reference/simple_stmts.rst:916 msgid "" "That is not a future statement; it's an ordinary import statement with no " "special semantics or syntax restrictions." msgstr "" # 9a2cb21deb6a4b1bb51f9fc9de8d4fc5 -#: ../src/Doc/reference/simple_stmts.rst:919 +#: reference/simple_stmts.rst:919 msgid "" "Code compiled by an :keyword:`exec` statement or calls to the built-in " "functions :func:`compile` and :func:`execfile` that occur in a module :mod:" @@ -7353,7 +7452,7 @@ msgid "" "the documentation of that function for details." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:926 +#: reference/simple_stmts.rst:926 msgid "" "A future statement typed at an interactive interpreter prompt will take " "effect for the rest of the interpreter session. If an interpreter is " @@ -7362,20 +7461,19 @@ msgid "" "interactive session started after the script is executed." msgstr "" -# ecb182bb1b3f42eea4bcc4de576bc240 -#: ../src/Doc/reference/simple_stmts.rst:933 -msgid ":pep:`236` - Back to the __future__" +#: reference/simple_stmts.rst:934 +msgid "PEP 236 - Back to the __future__" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:935 +#: reference/simple_stmts.rst:935 msgid "The original proposal for the __future__ mechanism." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:941 +#: reference/simple_stmts.rst:941 msgid "The :keyword:`global` statement" msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:950 +#: reference/simple_stmts.rst:950 msgid "" "The :keyword:`global` statement is a declaration which holds for the entire " "current code block. It means that the listed identifiers are to be " @@ -7384,20 +7482,20 @@ msgid "" "globals without being declared global." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:956 +#: reference/simple_stmts.rst:956 msgid "" "Names listed in a :keyword:`global` statement must not be used in the same " "code block textually preceding that :keyword:`global` statement." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:959 +#: reference/simple_stmts.rst:959 msgid "" "Names listed in a :keyword:`global` statement must not be defined as formal " "parameters or in a :keyword:`for` loop control target, :keyword:`class` " "definition, function definition, or :keyword:`import` statement." msgstr "" -#: ../src/Doc/reference/simple_stmts.rst:965 +#: reference/simple_stmts.rst:965 msgid "" "The current implementation does not enforce the latter two restrictions, but " "programs should not abuse this freedom, as future implementations may " @@ -7405,7 +7503,7 @@ msgid "" msgstr "" # cfa7adcf3b084e9e911d894bc8570fe6 -#: ../src/Doc/reference/simple_stmts.rst:975 +#: reference/simple_stmts.rst:975 msgid "" "**Programmer's note:** the :keyword:`global` is a directive to the parser. " "It applies only to code parsed at the same time as the :keyword:`global` " @@ -7418,13 +7516,13 @@ msgid "" msgstr "" # ce19ec2baee441e5a0e930b941c75ad3 -#: ../src/Doc/reference/simple_stmts.rst:988 +#: reference/simple_stmts.rst:988 #, fuzzy msgid "The :keyword:`exec` statement" msgstr "L'instruction :keyword:`del`" # 3b8f81ac47ac4f0cb303096984c6c5d3 -#: ../src/Doc/reference/simple_stmts.rst:995 +#: reference/simple_stmts.rst:995 msgid "" "This statement supports dynamic execution of Python code. The first " "expression should evaluate to either a Unicode string, a *Latin-1* encoded " @@ -7440,7 +7538,7 @@ msgid "" msgstr "" # f0828d0af701479fab300daddedd635d -#: ../src/Doc/reference/simple_stmts.rst:1007 +#: reference/simple_stmts.rst:1007 msgid "" "In all cases, if the optional parts are omitted, the code is executed in the " "current scope. If only the first expression after ``in`` is specified, it " @@ -7453,7 +7551,7 @@ msgid "" msgstr "" # 1cff2ae708b0433a9a8044ce64b39161 -#: ../src/Doc/reference/simple_stmts.rst:1016 +#: reference/simple_stmts.rst:1016 msgid "" "The first expression may also be a tuple of length 2 or 3. In this case, " "the optional parts must be omitted. The form ``exec(expr, globals)`` is " @@ -7463,8 +7561,12 @@ msgid "" "function rather than a statement." msgstr "" +#: reference/simple_stmts.rst:1023 +msgid "Formerly, *locals* was required to be a dictionary." +msgstr "" + # ebbde66720cc45048971fc5b8015c0e4 -#: ../src/Doc/reference/simple_stmts.rst:1030 +#: reference/simple_stmts.rst:1030 msgid "" "As a side effect, an implementation may insert additional keys into the " "dictionaries given besides those corresponding to variable names set by the " @@ -7474,7 +7576,7 @@ msgid "" msgstr "" # b456d3574ec64cf2be1ebe2020fb3965 -#: ../src/Doc/reference/simple_stmts.rst:1041 +#: reference/simple_stmts.rst:1041 msgid "" "**Programmer's hints:** dynamic evaluation of expressions is supported by " "the built-in function :func:`eval`. The built-in functions :func:`globals` " @@ -7483,18 +7585,18 @@ msgid "" msgstr "" # 08f09bb71682460cb2234c2f7b4da781 -#: ../src/Doc/reference/simple_stmts.rst:1049 +#: reference/simple_stmts.rst:1049 msgid "" "Note that the parser only accepts the Unix-style end of line convention. If " "you are reading the code from a file, make sure to use :term:`universal " "newlines` mode to convert Windows or Mac-style newlines." msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:6 +#: reference/toplevel_components.rst:6 msgid "Top-level components" msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:10 +#: reference/toplevel_components.rst:10 msgid "" "The Python interpreter can get its input from a number of sources: from a " "script passed to it as standard input or as program argument, typed in " @@ -7502,12 +7604,12 @@ msgid "" "syntax used in these cases." msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:19 +#: reference/toplevel_components.rst:19 msgid "Complete Python programs" msgstr "" # d1c8455486434f9b9964ee786f501ab7 -#: ../src/Doc/reference/toplevel_components.rst:28 +#: reference/toplevel_components.rst:28 msgid "" "While a language specification need not prescribe how the language " "interpreter is invoked, it is useful to have a notion of a complete Python " @@ -7519,13 +7621,13 @@ msgid "" "for execution of the complete program." msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:36 +#: reference/toplevel_components.rst:36 msgid "" "The syntax for a complete Python program is that for file input, described " "in the next section." msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:43 +#: reference/toplevel_components.rst:43 msgid "" "The interpreter may also be invoked in interactive mode; in this case, it " "does not read and execute a complete program but reads and executes one " @@ -7535,7 +7637,7 @@ msgid "" msgstr "" # ad5e8a8243604331aef323bcf81d67d1 -#: ../src/Doc/reference/toplevel_components.rst:54 +#: reference/toplevel_components.rst:54 msgid "" "Under Unix, a complete program can be passed to the interpreter in three " "forms: with the :option:`-c` *string* command line option, as a file passed " @@ -7544,63 +7646,63 @@ msgid "" "otherwise, it executes the file as a complete program." msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:64 +#: reference/toplevel_components.rst:64 msgid "File input" msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:66 +#: reference/toplevel_components.rst:66 msgid "All input read from non-interactive files has the same form:" msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:71 +#: reference/toplevel_components.rst:71 msgid "This syntax is used in the following situations:" msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:73 +#: reference/toplevel_components.rst:73 msgid "when parsing a complete Python program (from a file or from a string);" msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:75 +#: reference/toplevel_components.rst:75 msgid "when parsing a module;" msgstr "" # dae3dd994512469cbfc696b1cedb8206 -#: ../src/Doc/reference/toplevel_components.rst:77 +#: reference/toplevel_components.rst:77 msgid "when parsing a string passed to the :keyword:`exec` statement;" msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:83 +#: reference/toplevel_components.rst:83 msgid "Interactive input" msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:85 +#: reference/toplevel_components.rst:85 msgid "Input in interactive mode is parsed using the following grammar:" msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:90 +#: reference/toplevel_components.rst:90 msgid "" "Note that a (top-level) compound statement must be followed by a blank line " "in interactive mode; this is needed to help the parser detect the end of the " "input." msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:97 +#: reference/toplevel_components.rst:97 msgid "Expression input" msgstr "" -#: ../src/Doc/reference/toplevel_components.rst:103 +#: reference/toplevel_components.rst:103 msgid "" "There are two forms of expression input. Both ignore leading whitespace. " "The string argument to :func:`eval` must have the following form:" msgstr "" # 7da246dc67d4478b90a848b57cd078ed -#: ../src/Doc/reference/toplevel_components.rst:111 +#: reference/toplevel_components.rst:111 msgid "The input line read by :func:`input` must have the following form:" msgstr "" # 0cfe333226794ecea48e35bb0f2849ee -#: ../src/Doc/reference/toplevel_components.rst:123 +#: reference/toplevel_components.rst:123 msgid "" "Note: to read 'raw' input line without interpretation, you can use the built-" "in function :func:`raw_input` or the :meth:`readline` method of file objects." diff --git a/sphinx.po b/sphinx.po new file mode 100644 index 00000000..5044cd86 --- /dev/null +++ b/sphinx.po @@ -0,0 +1,21 @@ +# SOME DESCRIPTIVE TITLE. +# Copyright (C) 1990-2015, Python Software Foundation +# This file is distributed under the same license as the Python package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: Python 2.7\n" +"Report-Msgid-Bugs-To: \n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#: tools/templates/layout.html:44 +msgid "This Page" +msgstr "" diff --git a/tutorial.po b/tutorial.po index a254f325..297b28e5 100644 --- a/tutorial.po +++ b/tutorial.po @@ -7,30 +7,30 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-17 04:01\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" # 3056ef50444249728d9f473af9927a6b -#: ../src/Doc/tutorial/appendix.rst:5 +#: tutorial/appendix.rst:5 msgid "Appendix" msgstr "Annexe" -#: ../src/Doc/tutorial/appendix.rst:11 ../src/Doc/tutorial/interpreter.rst:87 +#: tutorial/appendix.rst:11 tutorial/interpreter.rst:89 msgid "Interactive Mode" msgstr "Mode interactif" -#: ../src/Doc/tutorial/appendix.rst:16 +#: tutorial/appendix.rst:16 msgid "Error Handling" msgstr "Gestion des erreurs" -#: ../src/Doc/tutorial/appendix.rst:18 +#: tutorial/appendix.rst:18 msgid "" "When an error occurs, the interpreter prints an error message and a stack " "trace. In interactive mode, it then returns to the primary prompt; when " @@ -54,13 +54,14 @@ msgstr "" "sortie d'erreur standard; les sorties normales issues des commandes " "exécutées sont écrites sur la sortie standard." -#: ../src/Doc/tutorial/appendix.rst:28 +#: tutorial/appendix.rst:28 +#, fuzzy msgid "" -"Typing the interrupt character (usually Control-C or DEL) to the primary or " -"secondary prompt cancels the input and returns to the primary prompt. [#]_ " -"Typing an interrupt while a command is executing raises the :exc:" -"`KeyboardInterrupt` exception, which may be handled by a :keyword:`try` " -"statement." +"Typing the interrupt character (usually :kbd:`Control-C` or :kbd:`Delete`) " +"to the primary or secondary prompt cancels the input and returns to the " +"primary prompt. [#]_ Typing an interrupt while a command is executing raises " +"the :exc:`KeyboardInterrupt` exception, which may be handled by a :keyword:" +"`try` statement." msgstr "" "Taper le caractère d'interruption (généralement :kbd:`Ctrl+C` ou :kbd:" "`Supprimer`) au niveau de l'invite de commande primaire annule l'entrée et " @@ -68,11 +69,11 @@ msgstr "" "s'exécute lève une exception :exc:`KeyboardInterrupt` qui peut être gérée " "par une instruction :keyword:`try`." -#: ../src/Doc/tutorial/appendix.rst:38 +#: tutorial/appendix.rst:38 msgid "Executable Python Scripts" msgstr "Scripts Python exécutables" -#: ../src/Doc/tutorial/appendix.rst:40 +#: tutorial/appendix.rst:40 msgid "" "On BSD'ish Unix systems, Python scripts can be made directly executable, " "like shell scripts, by putting the line ::" @@ -80,7 +81,7 @@ msgstr "" "Sur les systèmes Unix, un script Python peut être rendu directement " "exécutable comme un script shell en ajoutant la ligne ::" -#: ../src/Doc/tutorial/appendix.rst:45 +#: tutorial/appendix.rst:45 msgid "" "(assuming that the interpreter is on the user's :envvar:`PATH`) at the " "beginning of the script and giving the file an executable mode. The ``#!`` " @@ -96,7 +97,7 @@ msgstr "" "Unix (``'\\n'``) et pas de type Windows (``'\\r\\n'``). Notez que le " "caractère dièse, ``'#'``, est utilisé pour initier un commentaire en Python." -#: ../src/Doc/tutorial/appendix.rst:52 +#: tutorial/appendix.rst:52 #, fuzzy msgid "" "The script can be given an executable mode, or permission, using the :" @@ -104,7 +105,7 @@ msgid "" msgstr "" "Un script peut être rendu utilisable en utilisant la commande `chmod` ::" -#: ../src/Doc/tutorial/appendix.rst:59 +#: tutorial/appendix.rst:59 msgid "" "On Windows systems, there is no notion of an \"executable mode\". The " "Python installer automatically associates ``.py`` files with ``python.exe`` " @@ -118,11 +119,11 @@ msgstr "" "script. L'extension peut aussi être ``.pyw``, dans ce cas, la console " "n'apparait pas." -#: ../src/Doc/tutorial/appendix.rst:69 +#: tutorial/appendix.rst:69 msgid "The Interactive Startup File" msgstr "La configuration du mode interactif" -#: ../src/Doc/tutorial/appendix.rst:71 +#: tutorial/appendix.rst:71 msgid "" "When you use Python interactively, it is frequently handy to have some " "standard commands executed every time the interpreter is started. You can " @@ -136,7 +137,7 @@ msgstr "" "contenant les instructions à exécuter, à la même manière du :file:`.profile` " "dans un shell Unix." -#: ../src/Doc/tutorial/appendix.rst:77 +#: tutorial/appendix.rst:77 msgid "" "This file is only read in interactive sessions, not when Python reads " "commands from a script, and not when :file:`/dev/tty` is given as the " @@ -156,7 +157,7 @@ msgstr "" "``sys.ps2``." # 15ff626517a34a5aaf58d2f6f7b8b373 -#: ../src/Doc/tutorial/appendix.rst:85 +#: tutorial/appendix.rst:85 msgid "" "If you want to read an additional start-up file from the current directory, " "you can program this in the global start-up file using code like ``if os." @@ -171,12 +172,12 @@ msgstr "" "explicitement." # d6945345e3fe4669981e2966a757ef2f -#: ../src/Doc/tutorial/appendix.rst:102 +#: tutorial/appendix.rst:102 msgid "The Customization Modules" msgstr "Les modules de Personnalisation" # 5758a6756cb943b0aabe08600151d751 -#: ../src/Doc/tutorial/appendix.rst:104 +#: tutorial/appendix.rst:104 msgid "" "Python provides two hooks to let you customize it: :mod:`sitecustomize` and :" "mod:`usercustomize`. To see how it works, you need first to find the " @@ -189,7 +190,7 @@ msgstr "" "Démarrez Python et exécutez : code::" # 07d2ef1091ac4086815e9ea6e57edd26 -#: ../src/Doc/tutorial/appendix.rst:112 +#: tutorial/appendix.rst:112 msgid "" "Now you can create a file named :file:`usercustomize.py` in that directory " "and put anything you want in it. It will affect every invocation of Python, " @@ -202,7 +203,7 @@ msgstr "" "désactive l'import automatique." # 83a462362bb84a31bd2553bd13c41e2e -#: ../src/Doc/tutorial/appendix.rst:116 +#: tutorial/appendix.rst:116 msgid "" ":mod:`sitecustomize` works in the same way, but is typically created by an " "administrator of the computer in the global site-packages directory, and is " @@ -214,23 +215,22 @@ msgstr "" "Il est importé avant :mod:`usercustomize`. Pour plus de détails, consultez " "la documentation de :mod:`site`." -#: ../src/Doc/tutorial/appendix.rst:123 ../src/Doc/tutorial/classes.rst:899 -#: ../src/Doc/tutorial/controlflow.rst:674 -#: ../src/Doc/tutorial/datastructures.rst:759 -#: ../src/Doc/tutorial/interactive.rst:166 -#: ../src/Doc/tutorial/introduction.rst:630 ../src/Doc/tutorial/modules.rst:554 +#: tutorial/appendix.rst:123 tutorial/classes.rst:899 +#: tutorial/controlflow.rst:674 tutorial/datastructures.rst:759 +#: tutorial/interactive.rst:166 tutorial/introduction.rst:630 +#: tutorial/modules.rst:554 msgid "Footnotes" msgstr "Notes" -#: ../src/Doc/tutorial/appendix.rst:124 +#: tutorial/appendix.rst:124 msgid "A problem with the GNU Readline package may prevent this." msgstr "Un problème avec GNU Readline peut l'en empêcher." -#: ../src/Doc/tutorial/appetite.rst:5 +#: tutorial/appetite.rst:5 msgid "Whetting Your Appetite" msgstr "Mise en bouche" -#: ../src/Doc/tutorial/appetite.rst:7 +#: tutorial/appetite.rst:7 msgid "" "If you do much work on computers, eventually you find that there's some task " "you'd like to automate. For example, you may wish to perform a search-and-" @@ -245,7 +245,7 @@ msgstr "" "sophistiquée. Peut-être avez-vous besoin de créer une petite base de données " "ou une application graphique, ou un simple jeu." -#: ../src/Doc/tutorial/appetite.rst:13 +#: tutorial/appetite.rst:13 msgid "" "If you're a professional software developer, you may have to work with " "several C/C++/Java libraries but find the usual write/compile/test/re-" @@ -263,11 +263,11 @@ msgstr "" "vous ne voulez pas concevoir ni implémenter un nouveau langage pour votre " "application." -#: ../src/Doc/tutorial/appetite.rst:20 +#: tutorial/appetite.rst:20 msgid "Python is just the language for you." msgstr "Python est le langage parfait pour vous." -#: ../src/Doc/tutorial/appetite.rst:22 +#: tutorial/appetite.rst:22 msgid "" "You could write a Unix shell script or Windows batch files for some of these " "tasks, but shell scripts are best at moving around files and changing text " @@ -285,7 +285,7 @@ msgstr "" "il est disponible sous Windows, Mac OS X et Unix, et il vous aidera à " "terminer plus rapidement votre travail." -#: ../src/Doc/tutorial/appetite.rst:29 +#: tutorial/appetite.rst:29 msgid "" "Python is simple to use, but it is a real programming language, offering " "much more structure and support for large programs than shell scripts or " @@ -307,7 +307,7 @@ msgstr "" "Pourtant, de nombreuses choses sont au moins aussi faciles en Python que " "dans ces langages." -#: ../src/Doc/tutorial/appetite.rst:37 +#: tutorial/appetite.rst:37 msgid "" "Python allows you to split your program into modules that can be reused in " "other Python programs. It comes with a large collection of standard modules " @@ -324,7 +324,7 @@ msgstr "" "système, les sockets, et même des accès aux outils comme Tk pour créer des " "interfaces graphiques." -#: ../src/Doc/tutorial/appetite.rst:44 +#: tutorial/appetite.rst:44 msgid "" "Python is an interpreted language, which can save you considerable time " "during program development because no compilation and linking is necessary. " @@ -341,7 +341,7 @@ msgstr "" "des fonctions lors d'un développement incrémental. Il constitue aussi une " "calculatrice de bureau pratique." -#: ../src/Doc/tutorial/appetite.rst:50 +#: tutorial/appetite.rst:50 msgid "" "Python enables programs to be written compactly and readably. Programs " "written in Python are typically much shorter than equivalent C, C++, or " @@ -351,7 +351,7 @@ msgstr "" "écrits en Python sont généralement beaucoup plus court que l'équivalent en " "C, C++, ou Java, pour plusieurs raisons :" -#: ../src/Doc/tutorial/appetite.rst:54 +#: tutorial/appetite.rst:54 msgid "" "the high-level data types allow you to express complex operations in a " "single statement;" @@ -359,7 +359,7 @@ msgstr "" "les types de données de haut niveau vous permettent d'exprimer des " "opérations complexes en une seule instruction ;" -#: ../src/Doc/tutorial/appetite.rst:57 +#: tutorial/appetite.rst:57 msgid "" "statement grouping is done by indentation instead of beginning and ending " "brackets;" @@ -367,11 +367,11 @@ msgstr "" "les instructions sont regroupées entre elles grâce à l'indentation, plutôt " "que par l'utilisation d'accolades ;" -#: ../src/Doc/tutorial/appetite.rst:60 +#: tutorial/appetite.rst:60 msgid "no variable or argument declarations are necessary." msgstr "aucune déclaration de variable ou d'argument n'est nécessaire." -#: ../src/Doc/tutorial/appetite.rst:62 +#: tutorial/appetite.rst:62 msgid "" "Python is *extensible*: if you know how to program in C it is easy to add a " "new built-in function or module to the interpreter, either to perform " @@ -391,7 +391,7 @@ msgstr "" "l'utiliser comme un langage d'extensions ou de commandes pour cette " "application." -#: ../src/Doc/tutorial/appetite.rst:70 +#: tutorial/appetite.rst:70 msgid "" "By the way, the language is named after the BBC show \"Monty Python's Flying " "Circus\" and has nothing to do with reptiles. Making references to Monty " @@ -402,7 +402,7 @@ msgstr "" "référence aux sketchs des Monty Python dans de la documentation n'est pas " "seulement permis, c'est encouragé !" -#: ../src/Doc/tutorial/appetite.rst:74 +#: tutorial/appetite.rst:74 msgid "" "Now that you are all excited about Python, you'll want to examine it in some " "more detail. Since the best way to learn a language is to use it, the " @@ -413,7 +413,7 @@ msgstr "" "de l'utiliser, le tutoriel vous invite à jouer avec l'interpréteur pendant " "la lecture." -#: ../src/Doc/tutorial/appetite.rst:78 +#: tutorial/appetite.rst:78 msgid "" "In the next chapter, the mechanics of using the interpreter are explained. " "This is rather mundane information, but essential for trying out the " @@ -423,7 +423,7 @@ msgstr "" "l'interpréteur. Ce n'est pas la section la plus passionnante, mais c'est un " "passage obligé pour tester les exemples montrés plus loin." -#: ../src/Doc/tutorial/appetite.rst:82 +#: tutorial/appetite.rst:82 msgid "" "The rest of the tutorial introduces various features of the Python language " "and system through examples, beginning with simple expressions, statements " @@ -435,11 +435,11 @@ msgstr "" "instructions ou types de données, jusqu'aux fonctions et modules, pour " "finalement aborder des concepts avancés comme les exceptions et les classes." -#: ../src/Doc/tutorial/classes.rst:5 +#: tutorial/classes.rst:5 msgid "Classes" msgstr "Classes" -#: ../src/Doc/tutorial/classes.rst:7 +#: tutorial/classes.rst:7 msgid "" "Compared with other programming languages, Python's class mechanism adds " "classes with a minimum of new syntax and semantics. It is a mixture of the " @@ -465,7 +465,7 @@ msgstr "" "classe de base portant le même nom. Les objets peuvent contenir un nombre " "arbitraire de données." -#: ../src/Doc/tutorial/classes.rst:17 +#: tutorial/classes.rst:17 msgid "" "In C++ terminology, normally class members (including the data members) are " "*public* (except see below :ref:`tut-private`), and all member functions are " @@ -492,7 +492,7 @@ msgstr "" "des opérateurs de base avec une syntaxe spéciale (opérateurs arithmétiques, " "sous-indiçage, etc.) peuvent être redéfinis pour les instances de classes." -#: ../src/Doc/tutorial/classes.rst:28 +#: tutorial/classes.rst:28 msgid "" "(Lacking universally accepted terminology to talk about classes, I will make " "occasional use of Smalltalk and C++ terms. I would use Modula-3 terms, " @@ -505,11 +505,11 @@ msgstr "" "objet est plus proche de celle de Python que de C++, mais il est probable " "que seul un petit nombre de lecteurs soit susceptibles de les connaître.)" -#: ../src/Doc/tutorial/classes.rst:37 +#: tutorial/classes.rst:37 msgid "A Word About Names and Objects" msgstr "Quelques mots au sujet des noms et objets" -#: ../src/Doc/tutorial/classes.rst:39 +#: tutorial/classes.rst:39 msgid "" "Objects have individuality, and multiple names (in multiple scopes) can be " "bound to the same object. This is known as aliasing in other languages. " @@ -540,11 +540,11 @@ msgstr "" "le besoin d'avoir deux mécanismes de transmission d'arguments comme en " "Pascal." -#: ../src/Doc/tutorial/classes.rst:55 +#: tutorial/classes.rst:55 msgid "Python Scopes and Namespaces" msgstr "Portées et espaces de noms en Python" -#: ../src/Doc/tutorial/classes.rst:57 +#: tutorial/classes.rst:57 msgid "" "Before introducing classes, I first have to tell you something about " "Python's scope rules. Class definitions play some neat tricks with " @@ -558,11 +558,11 @@ msgstr "" "espaces de noms fonctionnent. Soit dit en passant, toute connaissance sur ce " "sujet est aussi utile aux développeurs Python expérimentés." -#: ../src/Doc/tutorial/classes.rst:63 +#: tutorial/classes.rst:63 msgid "Let's begin with some definitions." msgstr "Tout d'abord, quelques définitions." -#: ../src/Doc/tutorial/classes.rst:65 +#: tutorial/classes.rst:65 msgid "" "A *namespace* is a mapping from names to objects. Most namespaces are " "currently implemented as Python dictionaries, but that's normally not " @@ -590,7 +590,7 @@ msgstr "" "``maximize`` sans qu'il y ait de confusion. Les utilisateurs des modules " "doivent préfixer le nom de la fonction avec celui du module." -#: ../src/Doc/tutorial/classes.rst:76 +#: tutorial/classes.rst:76 msgid "" "By the way, I use the word *attribute* for any name following a dot --- for " "example, in the expression ``z.real``, ``real`` is an attribute of the " @@ -609,7 +609,7 @@ msgstr "" "entre les attributs du module et les noms globaux définis dans le module : " "ils partagent le même espace de noms ! [#]_" -#: ../src/Doc/tutorial/classes.rst:84 +#: tutorial/classes.rst:84 msgid "" "Attributes may be read-only or writable. In the latter case, assignment to " "attributes is possible. Module attributes are writable: you can write " @@ -624,7 +624,7 @@ msgstr "" "keyword:`del`. Par exemple, ``del modname.the_answer`` supprime l'attribut :" "attr:`the_answer` de l'objet nommé ``modname``." -#: ../src/Doc/tutorial/classes.rst:90 +#: tutorial/classes.rst:90 msgid "" "Namespaces are created at different moments and have different lifetimes. " "The namespace containing the built-in names is created when the Python " @@ -647,7 +647,7 @@ msgstr "" "`__main__`, de façon qu'elles possèdent leur propre espace de noms. (les " "primitives vivent elles-mêmes dans un module, appelé :mod:`builtins`.)" -#: ../src/Doc/tutorial/classes.rst:100 +#: tutorial/classes.rst:100 msgid "" "The local namespace for a function is created when the function is called, " "and deleted when the function returns or raises an exception that is not " @@ -661,7 +661,7 @@ msgstr "" "se passe réellement). Bien sûr, des invocations récursives ont chacune leur " "propre espace de noms." -#: ../src/Doc/tutorial/classes.rst:106 +#: tutorial/classes.rst:106 msgid "" "A *scope* is a textual region of a Python program where a namespace is " "directly accessible. \"Directly accessible\" here means that an unqualified " @@ -671,7 +671,7 @@ msgstr "" "noms est directement accessible. « Directement accessible » signifie ici " "qu'une référence non qualifée à un nom sera recherchée dans l'espace de noms." -#: ../src/Doc/tutorial/classes.rst:110 +#: tutorial/classes.rst:110 msgid "" "Although scopes are determined statically, they are used dynamically. At any " "time during execution, there are at least three nested scopes whose " @@ -682,13 +682,13 @@ msgstr "" "a au minimum trois portées imbriquées dont les espaces de noms sont " "directement accessibles :" -#: ../src/Doc/tutorial/classes.rst:114 +#: tutorial/classes.rst:114 msgid "the innermost scope, which is searched first, contains the local names" msgstr "" "La portée la plus au centre, celle qui est consultée en premier, contient " "les noms locaux" -#: ../src/Doc/tutorial/classes.rst:115 +#: tutorial/classes.rst:115 msgid "" "the scopes of any enclosing functions, which are searched starting with the " "nearest enclosing scope, contains non-local, but also non-global names" @@ -697,11 +697,11 @@ msgstr "" "avec la portée englobante la plus proche, contiennent des noms non-locaux " "mais aussi non-globaux" -#: ../src/Doc/tutorial/classes.rst:117 +#: tutorial/classes.rst:117 msgid "the next-to-last scope contains the current module's global names" msgstr "l'avant dernière portée contient les noms globaux du module courant" -#: ../src/Doc/tutorial/classes.rst:118 +#: tutorial/classes.rst:118 msgid "" "the outermost scope (searched last) is the namespace containing built-in " "names" @@ -709,7 +709,7 @@ msgstr "" "la portée englobante, consultée en dernier, est l'espace de noms contenant " "les primitives" -#: ../src/Doc/tutorial/classes.rst:120 +#: tutorial/classes.rst:120 msgid "" "If a name is declared global, then all references and assignments go " "directly to the middle scope containing the module's global names. " @@ -727,7 +727,7 @@ msgstr "" "*nouvelle* variable locale dans la portée la plus au centre, en laissant " "inchangée la variable du même nom dans la portée englobante)." -#: ../src/Doc/tutorial/classes.rst:126 +#: tutorial/classes.rst:126 msgid "" "Usually, the local scope references the local names of the (textually) " "current function. Outside functions, the local scope references the same " @@ -739,7 +739,7 @@ msgstr "" "de noms que la portée globale : l'espace de noms du module. Les définitions " "de classes créent un nouvel espace de noms dans la portée locale." -#: ../src/Doc/tutorial/classes.rst:131 +#: tutorial/classes.rst:131 msgid "" "It is important to realize that scopes are determined textually: the global " "scope of a function defined in a module is that module's namespace, no " @@ -758,7 +758,7 @@ msgstr "" "se baser sur une résolution dynamique ! (En réalité, les variables locales " "sont déjà déterminées de manière statique)." -#: ../src/Doc/tutorial/classes.rst:139 +#: tutorial/classes.rst:139 msgid "" "A special quirk of Python is that -- if no :keyword:`global` statement is in " "effect -- assignments to names always go into the innermost scope. " @@ -780,11 +780,11 @@ msgstr "" "les instructions keyword:`import` et les définitions de fonctions effectuent " "une liaison du module ou du nom de fonction dans la portée locale." -#: ../src/Doc/tutorial/classes.rst:153 +#: tutorial/classes.rst:153 msgid "A First Look at Classes" msgstr "Une première approche des classes" -#: ../src/Doc/tutorial/classes.rst:155 +#: tutorial/classes.rst:155 msgid "" "Classes introduce a little bit of new syntax, three new object types, and " "some new semantics." @@ -792,15 +792,15 @@ msgstr "" "Le concept de classes introduit quelques nouveau éléments de syntaxe, trois " "nouveaux types d'objets ainsi que de nouveaux éléments de sémantique" -#: ../src/Doc/tutorial/classes.rst:162 +#: tutorial/classes.rst:162 msgid "Class Definition Syntax" msgstr "Syntaxe de définition des classes" -#: ../src/Doc/tutorial/classes.rst:164 +#: tutorial/classes.rst:164 msgid "The simplest form of class definition looks like this::" msgstr "La forme la plus simple de définition de classe ressemble à ceci ::" -#: ../src/Doc/tutorial/classes.rst:173 +#: tutorial/classes.rst:173 msgid "" "Class definitions, like function definitions (:keyword:`def` statements) " "must be executed before they have any effect. (You could conceivably place " @@ -813,7 +813,7 @@ msgstr "" "instruction conditionnelle :keyword:`if` ou encore à l'intérieur d'une " "fonction.)" -#: ../src/Doc/tutorial/classes.rst:177 +#: tutorial/classes.rst:177 msgid "" "In practice, the statements inside a class definition will usually be " "function definitions, but other statements are allowed, and sometimes useful " @@ -828,7 +828,7 @@ msgstr "" "particulière de liste d'arguments, dictée par les conventions d'appel aux " "méthodes --- À nouveau, tout ceci sera expliqué plus tard." -#: ../src/Doc/tutorial/classes.rst:183 +#: tutorial/classes.rst:183 msgid "" "When a class definition is entered, a new namespace is created, and used as " "the local scope --- thus, all assignments to local variables go into this " @@ -840,7 +840,7 @@ msgstr "" "entrent dans ce nouvel espace de noms. En particulier, les définitions de " "fonctions y lient le nom de la nouvelle fonction." -#: ../src/Doc/tutorial/classes.rst:188 +#: tutorial/classes.rst:188 msgid "" "When a class definition is left normally (via the end), a *class object* is " "created. This is basically a wrapper around the contents of the namespace " @@ -858,11 +858,11 @@ msgstr "" "est lié ici au nom de classe donné dans l'en-tête de définition de classe (:" "class:`NomDeLaClasse` dans l'exemple)." -#: ../src/Doc/tutorial/classes.rst:200 +#: tutorial/classes.rst:200 msgid "Class Objects" msgstr "Les objets classe" -#: ../src/Doc/tutorial/classes.rst:202 +#: tutorial/classes.rst:202 msgid "" "Class objects support two kinds of operations: attribute references and " "instantiation." @@ -870,7 +870,7 @@ msgstr "" "Les objets classes prennent en charge deux types d'opérations : des " "références à des attributs et l'instanciation." -#: ../src/Doc/tutorial/classes.rst:205 +#: tutorial/classes.rst:205 msgid "" "*Attribute references* use the standard syntax used for all attribute " "references in Python: ``obj.name``. Valid attribute names are all the names " @@ -884,7 +884,7 @@ msgstr "" "classe ressemble à ceci ::" # docstring doit il rester en anglais ou être traduit ? -#: ../src/Doc/tutorial/classes.rst:216 +#: tutorial/classes.rst:216 msgid "" "then ``MyClass.i`` and ``MyClass.f`` are valid attribute references, " "returning an integer and a function object, respectively. Class attributes " @@ -899,7 +899,7 @@ msgstr "" "est aussi un attribut valide, renvoyant la docstring appartenant à la " "classe : ``\"Une simple classe d'exemple\"``." -#: ../src/Doc/tutorial/classes.rst:222 +#: tutorial/classes.rst:222 msgid "" "Class *instantiation* uses function notation. Just pretend that the class " "object is a parameterless function that returns a new instance of the class. " @@ -910,7 +910,7 @@ msgstr "" "une nouvelle instance de la classe. Par exemple (en considérant la classe " "définie ci-dessus) ::" -#: ../src/Doc/tutorial/classes.rst:228 +#: tutorial/classes.rst:228 msgid "" "creates a new *instance* of the class and assigns this object to the local " "variable ``x``." @@ -918,7 +918,7 @@ msgstr "" "crée une nouvelle *instance* de la classe et affecte cet objet à la variable " "locale ``x``." -#: ../src/Doc/tutorial/classes.rst:231 +#: tutorial/classes.rst:231 msgid "" "The instantiation operation (\"calling\" a class object) creates an empty " "object. Many classes like to create objects with instances customized to a " @@ -931,7 +931,7 @@ msgstr "" "classe peut définir une méthode spéciale nommée: meth:`__init__`, comme " "ceci ::" -#: ../src/Doc/tutorial/classes.rst:239 +#: tutorial/classes.rst:239 msgid "" "When a class defines an :meth:`__init__` method, class instantiation " "automatically invokes :meth:`__init__` for the newly-created class " @@ -943,7 +943,7 @@ msgstr "" "la classe. Donc, dans cet exemple, l'initialisation d'une nouvelle instance " "peut être obtenue par ::" -#: ../src/Doc/tutorial/classes.rst:245 +#: tutorial/classes.rst:245 msgid "" "Of course, the :meth:`__init__` method may have arguments for greater " "flexibility. In that case, arguments given to the class instantiation " @@ -953,11 +953,11 @@ msgstr "" "grande flexibilité. Dans ce cas, les arguments donnés à l'opérateur " "d'instanciation de classe sont transmis à :meth:`__init__`. Par exemple, ::" -#: ../src/Doc/tutorial/classes.rst:262 +#: tutorial/classes.rst:262 msgid "Instance Objects" msgstr "Objets instance" -#: ../src/Doc/tutorial/classes.rst:264 +#: tutorial/classes.rst:264 msgid "" "Now what can we do with instance objects? The only operations understood by " "instance objects are attribute references. There are two kinds of valid " @@ -968,7 +968,7 @@ msgstr "" "d'attributs. Il y a deux sortes de noms d'attributs valides, les attributs " "données et les méthodes." -#: ../src/Doc/tutorial/classes.rst:268 +#: tutorial/classes.rst:268 msgid "" "*data attributes* correspond to \"instance variables\" in Smalltalk, and to " "\"data members\" in C++. Data attributes need not be declared; like local " @@ -984,7 +984,7 @@ msgstr "" "l'instance de :class:`MaClasse` créée ci-dessus, le code suivant affiche la " "valeur ``16 ``, sans laisser de traces ::" -#: ../src/Doc/tutorial/classes.rst:280 +#: tutorial/classes.rst:280 msgid "" "The other kind of instance attribute reference is a *method*. A method is a " "function that \"belongs to\" an object. (In Python, the term method is not " @@ -1003,7 +1003,7 @@ msgstr "" "allons utiliser le terme de méthode exclusivement en référence à des " "méthodes d'objets instances de classe)." -#: ../src/Doc/tutorial/classes.rst:289 +#: tutorial/classes.rst:289 msgid "" "Valid method names of an instance object depend on its class. By " "definition, all attributes of a class that are function objects define " @@ -1020,15 +1020,15 @@ msgstr "" "Attention cependant, ``x.f`` n'est pas la même chose que ``MaClasse.f`` --- " "Il s'agit d'un *objet méthode*, pas d'un objet fonction." -#: ../src/Doc/tutorial/classes.rst:300 +#: tutorial/classes.rst:300 msgid "Method Objects" msgstr "Les objets méthode" -#: ../src/Doc/tutorial/classes.rst:302 +#: tutorial/classes.rst:302 msgid "Usually, a method is called right after it is bound::" msgstr "Le plus souvent, une méthode est appelée juste après avoir été liée::" -#: ../src/Doc/tutorial/classes.rst:306 +#: tutorial/classes.rst:306 msgid "" "In the :class:`MyClass` example, this will return the string ``'hello " "world'``. However, it is not necessary to call a method right away: ``x.f`` " @@ -1040,11 +1040,11 @@ msgstr "" "méthode directement: ``x.f`` est un objet méthode, il peut être gardé de " "coté et être appelé plus tard. Par exemple::" -#: ../src/Doc/tutorial/classes.rst:314 +#: tutorial/classes.rst:314 msgid "will continue to print ``hello world`` until the end of time." msgstr "va afficher ``hello world`` jusqu'à la fin des temps." -#: ../src/Doc/tutorial/classes.rst:316 +#: tutorial/classes.rst:316 msgid "" "What exactly happens when a method is called? You may have noticed that ``x." "f()`` was called without an argument above, even though the function " @@ -1060,7 +1060,7 @@ msgstr "" "exception lorsqu'une fonction qui requiert un argument est appelée sans -- " "même si l'argument n'est pas utilisé..." -#: ../src/Doc/tutorial/classes.rst:322 +#: tutorial/classes.rst:322 msgid "" "Actually, you may have guessed the answer: the special thing about methods " "is that the object is passed as the first argument of the function. In our " @@ -1077,7 +1077,7 @@ msgstr "" "cette liste d'arguments modulo l'insertion de l'objet de la méthode avant le " "premier argument." -#: ../src/Doc/tutorial/classes.rst:329 +#: tutorial/classes.rst:329 msgid "" "If you still don't understand how methods work, a look at the implementation " "can perhaps clarify matters. When an instance attribute is referenced that " @@ -1101,12 +1101,12 @@ msgstr "" "avec cette nouvelle liste d'arguments." # ab1bfdd3fee34318aab4be64886cf45e -#: ../src/Doc/tutorial/classes.rst:343 +#: tutorial/classes.rst:343 msgid "Class and Instance Variables" msgstr "Classes et variables d'instance" # ecf91e018fbd48369aa4d90ce00dd2d0 -#: ../src/Doc/tutorial/classes.rst:345 +#: tutorial/classes.rst:345 msgid "" "Generally speaking, instance variables are for data unique to each instance " "and class variables are for attributes and methods shared by all instances " @@ -1117,7 +1117,7 @@ msgstr "" "attributs et méthodes communes à toutes les instances de la classe::" # 48f32152a9ce4d4fa5a1d6d5a99d8914 -#: ../src/Doc/tutorial/classes.rst:367 +#: tutorial/classes.rst:367 msgid "" "As discussed in :ref:`tut-object`, shared data can have possibly surprising " "effects with involving :term:`mutable` objects such as lists and " @@ -1132,17 +1132,17 @@ msgstr "" "les instances de *Dog*::" # 63436e0b027b42da8f8045c439d6cddb -#: ../src/Doc/tutorial/classes.rst:390 +#: tutorial/classes.rst:390 msgid "Correct design of the class should use an instance variable instead::" msgstr "" "Une conception correcte de la classe serait d'utiliser une variable " "d'instance à la place : :" -#: ../src/Doc/tutorial/classes.rst:414 +#: tutorial/classes.rst:414 msgid "Random Remarks" msgstr "Remarques diverses" -#: ../src/Doc/tutorial/classes.rst:418 +#: tutorial/classes.rst:418 msgid "" "Data attributes override method attributes with the same name; to avoid " "accidental name conflicts, which may cause hard-to-find bugs in large " @@ -1161,7 +1161,7 @@ msgstr "" "juste la caractère souligné), ou l'utilisation de verbes pour les méthodes " "et de noms pour les attributs de données." -#: ../src/Doc/tutorial/classes.rst:425 +#: tutorial/classes.rst:425 msgid "" "Data attributes may be referenced by methods as well as by ordinary users " "(\"clients\") of an object. In other words, classes are not usable to " @@ -1180,7 +1180,7 @@ msgstr "" "d'implémentation et contrôler l'accès à un objet si nécessaire ; ceci peut " "être utilisé par des extensions de Python écrites en C)." -#: ../src/Doc/tutorial/classes.rst:433 +#: tutorial/classes.rst:433 msgid "" "Clients should use data attributes with care --- clients may mess up " "invariants maintained by the methods by stamping on their data attributes. " @@ -1196,7 +1196,7 @@ msgstr "" "conflit --- aussi, adopter une convention de nommage peut éviter bien des " "problèmes." -#: ../src/Doc/tutorial/classes.rst:439 +#: tutorial/classes.rst:439 msgid "" "There is no shorthand for referencing data attributes (or other methods!) " "from within methods. I find that this actually increases the readability of " @@ -1209,7 +1209,7 @@ msgstr "" "variables locales et variables d'instances quand on regarde le code d'une " "méthode." -#: ../src/Doc/tutorial/classes.rst:444 +#: tutorial/classes.rst:444 msgid "" "Often, the first argument of a method is called ``self``. This is nothing " "more than a convention: the name ``self`` has absolutely no special meaning " @@ -1225,7 +1225,7 @@ msgstr "" "est aussi possible qu'un programme qui fasse l'introspection de classes " "repose sur une telle convention." -#: ../src/Doc/tutorial/classes.rst:450 +#: tutorial/classes.rst:450 msgid "" "Any function object that is a class attribute defines a method for instances " "of that class. It is not necessary that the function definition is " @@ -1238,7 +1238,7 @@ msgstr "" "possible d'affecter un objet fonction à une variable locale de la classe. " "Par exemple ::" -#: ../src/Doc/tutorial/classes.rst:465 +#: tutorial/classes.rst:465 msgid "" "Now ``f``, ``g`` and ``h`` are all attributes of class :class:`C` that refer " "to function objects, and consequently they are all methods of instances of :" @@ -1251,7 +1251,7 @@ msgstr "" "à ``g``. Remarquez qu'en pratique, ceci ne sert qu'à embrouiller le lecteur " "d'un programme." -#: ../src/Doc/tutorial/classes.rst:470 +#: tutorial/classes.rst:470 msgid "" "Methods may call other methods by using method attributes of the ``self`` " "argument::" @@ -1259,7 +1259,7 @@ msgstr "" "Les méthodes peuvent appeler d'autres méthodes en utilisant des méthodes qui " "sont des attributs de l'argument ``self`` ::" -#: ../src/Doc/tutorial/classes.rst:482 +#: tutorial/classes.rst:482 msgid "" "Methods may reference global names in the same way as ordinary functions. " "The global scope associated with a method is the module containing its " @@ -1283,7 +1283,7 @@ msgstr "" "définie dans cette portée globale, et dans la section suivante, nous verrons " "de bonnes raisons pour qu'une méthode référence sa propre classe." -#: ../src/Doc/tutorial/classes.rst:492 +#: tutorial/classes.rst:492 msgid "" "Each value is an object, and therefore has a *class* (also called its " "*type*). It is stored as ``object.__class__``." @@ -1291,11 +1291,11 @@ msgstr "" "Toute valeur est un objet, et a donc une *classe* (appelé aussi son *type*). " "Elle est stockée dans ``objet.__class__``." -#: ../src/Doc/tutorial/classes.rst:499 +#: tutorial/classes.rst:499 msgid "Inheritance" msgstr "L'héritage" -#: ../src/Doc/tutorial/classes.rst:501 +#: tutorial/classes.rst:501 msgid "" "Of course, a language feature would not be worthy of the name \"class\" " "without supporting inheritance. The syntax for a derived class definition " @@ -1304,7 +1304,7 @@ msgstr "" "Bien sûr, ce terme de «classe» ne serait pas utilisé s'il n'y avait pas " "l'héritage. La syntaxe pour définir une sous-classe ressemble à ceci ::" -#: ../src/Doc/tutorial/classes.rst:512 +#: tutorial/classes.rst:512 msgid "" "The name :class:`BaseClassName` must be defined in a scope containing the " "derived class definition. In place of a base class name, other arbitrary " @@ -1316,7 +1316,7 @@ msgstr "" "expression est aussi autorisée. Ceci peut être utile, par exemple, lorsque " "la classe est définie dans un autre module ::" -#: ../src/Doc/tutorial/classes.rst:519 +#: tutorial/classes.rst:519 msgid "" "Execution of a derived class definition proceeds the same as for a base " "class. When the class object is constructed, the base class is remembered. " @@ -1332,7 +1332,7 @@ msgstr "" "procède en regardant dans la classe de base. Cette règle est appliquée " "récursivement si la classe de base est elle-même dérivée d'une autre classe." -#: ../src/Doc/tutorial/classes.rst:525 +#: tutorial/classes.rst:525 msgid "" "There's nothing special about instantiation of derived classes: " "``DerivedClassName()`` creates a new instance of the class. Method " @@ -1347,7 +1347,7 @@ msgstr "" "si nécessaire, et la référence de méthode est valide si cela conduit à une " "fonction." -#: ../src/Doc/tutorial/classes.rst:531 +#: tutorial/classes.rst:531 msgid "" "Derived classes may override methods of their base classes. Because methods " "have no special privileges when calling other methods of the same object, a " @@ -1362,7 +1362,7 @@ msgstr "" "appeler une méthode d'une classe dérivée qui la surcharge (pour les " "programmeurs C++ : toutes les méthodes de Python sont en effet ``virtual``)." -#: ../src/Doc/tutorial/classes.rst:537 +#: tutorial/classes.rst:537 msgid "" "An overriding method in a derived class may in fact want to extend rather " "than simply replace the base class method of the same name. There is a " @@ -1379,11 +1379,11 @@ msgstr "" "ceci ne fonctionne que si la classe de base est accessible en tant que " "``ClasseDeBase`` dans la portée globale)." -#: ../src/Doc/tutorial/classes.rst:544 +#: tutorial/classes.rst:544 msgid "Python has two built-in functions that work with inheritance:" msgstr "Python a deux fonctions primitives qui gèrent l'héritage :" -#: ../src/Doc/tutorial/classes.rst:546 +#: tutorial/classes.rst:546 msgid "" "Use :func:`isinstance` to check an instance's type: ``isinstance(obj, int)`` " "will be ``True`` only if ``obj.__class__`` is :class:`int` or some class " @@ -1394,7 +1394,7 @@ msgstr "" "est égal à :class:`int` ou à une autre classe dérivée de :class:`int`." # 9eda01c71f1b43b2a9f80582775b12b2 -#: ../src/Doc/tutorial/classes.rst:550 +#: tutorial/classes.rst:550 msgid "" "Use :func:`issubclass` to check class inheritance: ``issubclass(bool, int)`` " "is ``True`` since :class:`bool` is a subclass of :class:`int`. However, " @@ -1408,11 +1408,11 @@ msgstr "" "renvoie ``False`` car :class:`unicode` n'est pas une sous-classe de :class:" "`str` (ils partagent seulement un ancêtre commun, :class:`basestring`)." -#: ../src/Doc/tutorial/classes.rst:561 +#: tutorial/classes.rst:561 msgid "Multiple Inheritance" msgstr "L'héritage multiple" -#: ../src/Doc/tutorial/classes.rst:563 +#: tutorial/classes.rst:563 msgid "" "Python supports a limited form of multiple inheritance as well. A class " "definition with multiple base classes looks like this::" @@ -1420,7 +1420,7 @@ msgstr "" "Python propose également une forme d'héritage multiple. Une définition de " "classe ayant plusieurs classes de base ressemble à ::" -#: ../src/Doc/tutorial/classes.rst:573 +#: tutorial/classes.rst:573 msgid "" "For old-style classes, the only rule is depth-first, left-to-right. Thus, " "if an attribute is not found in :class:`DerivedClassName`, it is searched " @@ -1436,7 +1436,7 @@ msgstr "" "ainsi de suite." # 0bd332ed666e47d1b82a9aa6ea6a3afe -#: ../src/Doc/tutorial/classes.rst:578 +#: tutorial/classes.rst:578 msgid "" "(To some people breadth first --- searching :class:`Base2` and :class:" "`Base3` before the base classes of :class:`Base1` --- looks more natural. " @@ -1457,7 +1457,7 @@ msgstr "" "et des attributs hérités de :class:`Base1`)." # 065cbbda1701441f9d8f176d380ca4bf -#: ../src/Doc/tutorial/classes.rst:586 +#: tutorial/classes.rst:586 msgid "" "For :term:`new-style class`\\es, the method resolution order changes " "dynamically to support cooperative calls to :func:`super`. This approach is " @@ -1472,7 +1472,7 @@ msgstr "" "\" que l'on trouve dans les langages ne gérant que l'héritage simple." # d37280ea9d7743f686abf8f1e1859425 -#: ../src/Doc/tutorial/classes.rst:591 +#: tutorial/classes.rst:591 #, fuzzy msgid "" "With new-style classes, dynamic ordering is necessary because all cases of " @@ -1506,11 +1506,11 @@ msgstr "" "mro/." # 0d63701d735e45d6b0ed3f46e2ff0bea -#: ../src/Doc/tutorial/classes.rst:609 +#: tutorial/classes.rst:609 msgid "Private Variables and Class-local References" msgstr "Variables privées et références locales aux classes" -#: ../src/Doc/tutorial/classes.rst:611 +#: tutorial/classes.rst:611 msgid "" "\"Private\" instance variables that cannot be accessed except from inside an " "object don't exist in Python. However, there is a convention that is " @@ -1527,7 +1527,7 @@ msgstr "" "être considéré comme un détail d'implémentation pouvant faire l'objet de " "modification futures sans préavis." -#: ../src/Doc/tutorial/classes.rst:618 +#: tutorial/classes.rst:618 msgid "" "Since there is a valid use-case for class-private members (namely to avoid " "name clashes of names with names defined by subclasses), there is limited " @@ -1551,7 +1551,7 @@ msgstr "" # 76822657f61145529176860bfd786541 # Une définition en français pour le "name mangling", littéralement # "bricolage" ?? -#: ../src/Doc/tutorial/classes.rst:627 +#: tutorial/classes.rst:627 msgid "" "Name mangling is helpful for letting subclasses override methods without " "breaking intraclass method calls. For example::" @@ -1560,7 +1560,7 @@ msgstr "" "surcharger des méthodes sans interrompre les appels de méthodes intra-" "classes. Par exemple ::" -#: ../src/Doc/tutorial/classes.rst:649 +#: tutorial/classes.rst:649 msgid "" "Note that the mangling rules are designed mostly to avoid accidents; it " "still is possible to access or modify a variable that is considered " @@ -1573,7 +1573,7 @@ msgstr "" "sein du débogueur." # 9412d7da01ba4f1c94661f38b627ccda -#: ../src/Doc/tutorial/classes.rst:653 +#: tutorial/classes.rst:653 msgid "" "Notice that code passed to ``exec``, ``eval()`` or ``execfile()`` does not " "consider the classname of the invoking class to be the current class; this " @@ -1589,11 +1589,11 @@ msgstr "" "mêmes restrictions s'appliquent à ``getattr()``, ``setattr()`` et " "``delattr()``, ainsi qu'aux références directes à ``__dict__``." -#: ../src/Doc/tutorial/classes.rst:664 +#: tutorial/classes.rst:664 msgid "Odds and Ends" msgstr "Trucs et astuces" -#: ../src/Doc/tutorial/classes.rst:666 +#: tutorial/classes.rst:666 msgid "" "Sometimes it is useful to have a data type similar to the Pascal \"record\" " "or C \"struct\", bundling together a few named data items. An empty class " @@ -1603,7 +1603,7 @@ msgstr "" "Pascal ou au \"struct\" du C, qui regroupent ensemble quelques attributs " "nommés. La définition d'une classe vide remplit parfaitement ce besoin ::" -#: ../src/Doc/tutorial/classes.rst:680 +#: tutorial/classes.rst:680 #, fuzzy msgid "" "A piece of Python code that expects a particular abstract data type can " @@ -1621,7 +1621,7 @@ msgstr "" "caractères à la place, et lui passer une instance comme argument." # 7ebc85600b7944a29e6e12ecc0f45219 -#: ../src/Doc/tutorial/classes.rst:691 +#: tutorial/classes.rst:691 msgid "" "Instance method objects have attributes, too: ``m.im_self`` is the instance " "object with the method :meth:`m`, and ``m.im_func`` is the function object " @@ -1631,11 +1631,11 @@ msgstr "" "est l'instance d'objet avec la méthode :meth:`m`, et ``m.im_func`` est " "l'objet fonction correspondant à la méthode." -#: ../src/Doc/tutorial/classes.rst:699 +#: tutorial/classes.rst:699 msgid "Exceptions Are Classes Too" msgstr "Les exceptions sont aussi des classes" -#: ../src/Doc/tutorial/classes.rst:701 +#: tutorial/classes.rst:701 msgid "" "User-defined exceptions are identified by classes as well. Using this " "mechanism it is possible to create extensible hierarchies of exceptions." @@ -1644,7 +1644,7 @@ msgstr "" "classes. En utilisant ce mécanisme, il est possible de créer des hiérarchies " "d'exceptions extensibles." -#: ../src/Doc/tutorial/classes.rst:704 +#: tutorial/classes.rst:704 msgid "" "There are two new valid (semantic) forms for the :keyword:`raise` statement::" msgstr "" @@ -1652,7 +1652,7 @@ msgstr "" "`raise` ::" # 8f5815c4d349473a91655b663f163fb7 -#: ../src/Doc/tutorial/classes.rst:710 +#: tutorial/classes.rst:710 msgid "" "In the first form, ``instance`` must be an instance of :class:`Class` or of " "a class derived from it. The second form is a shorthand for::" @@ -1660,7 +1660,7 @@ msgstr "" "Dans la première forme, ``instance`` doit être une instance de :class:" "`Class` ou d'une classe dérivée. La seconde forme est un raccourci pour ::" -#: ../src/Doc/tutorial/classes.rst:715 +#: tutorial/classes.rst:715 msgid "" "A class in an :keyword:`except` clause is compatible with an exception if it " "is the same class or a base class thereof (but not the other way around --- " @@ -1673,7 +1673,7 @@ msgstr "" "dérivée n'est pas compatible avec une classe de base.) Par exemple, le code " "suivant imprimera B, C et D dans cet ordre ::" -#: ../src/Doc/tutorial/classes.rst:737 +#: tutorial/classes.rst:737 msgid "" "Note that if the except clauses were reversed (with ``except B`` first), it " "would have printed B, B, B --- the first matching except clause is triggered." @@ -1682,7 +1682,7 @@ msgstr "" "premier), il aurait imprimé B, B, B --- la première clause except " "correspondante étant déclenchée." -#: ../src/Doc/tutorial/classes.rst:740 +#: tutorial/classes.rst:740 msgid "" "When an error message is printed for an unhandled exception, the exception's " "class name is printed, then a colon and a space, and finally the instance " @@ -1692,11 +1692,11 @@ msgstr "" "classe de l'exception est indiquée, suivie de deux points, d'un espace et de " "l'instance convertie en chaîne de caractères via la fonction :func:`str`." -#: ../src/Doc/tutorial/classes.rst:748 +#: tutorial/classes.rst:748 msgid "Iterators" msgstr "Itérateurs" -#: ../src/Doc/tutorial/classes.rst:750 +#: tutorial/classes.rst:750 msgid "" "By now you have probably noticed that most container objects can be looped " "over using a :keyword:`for` statement::" @@ -1705,7 +1705,7 @@ msgstr "" "plupart des objets conteneurs en utilisant une instruction :keyword:`for` ::" # 6aba6be73fbf4173bdf405faaa3f4fbf -#: ../src/Doc/tutorial/classes.rst:764 +#: tutorial/classes.rst:764 #, fuzzy msgid "" "This style of access is clear, concise, and convenient. The use of " @@ -1727,7 +1727,7 @@ msgstr "" "cela fonctionne ::" # 3b3fcc0b4bdf44b59d3a21fe85f65bae -#: ../src/Doc/tutorial/classes.rst:789 +#: tutorial/classes.rst:789 #, fuzzy msgid "" "Having seen the mechanics behind the iterator protocol, it is easy to add " @@ -1742,12 +1742,12 @@ msgstr "" "la classe définit elle-même la méthode :meth:`next`, alors :meth:`__iter__` " "peut simplement renvoyer ``self`` ::" -#: ../src/Doc/tutorial/classes.rst:824 +#: tutorial/classes.rst:824 msgid "Generators" msgstr "Générateurs" # b93a03d2e68d4a60aa58eb2165d2ff9d -#: ../src/Doc/tutorial/classes.rst:826 +#: tutorial/classes.rst:826 #, fuzzy msgid "" ":term:`Generator`\\s are a simple and powerful tool for creating iterators. " @@ -1766,7 +1766,7 @@ msgstr "" "simples à créer ::" # 3d70dcf3a7024e698039ee6bdaf21102 -#: ../src/Doc/tutorial/classes.rst:847 +#: tutorial/classes.rst:847 #, fuzzy msgid "" "Anything that can be done with generators can also be done with class-based " @@ -1779,7 +1779,7 @@ msgstr "" "précédent. Si qui fait que les générateurs sont si compacts est que les " "méthodes :meth:`__iter__` et :meth:`next` sont créées automatiquement." -#: ../src/Doc/tutorial/classes.rst:852 +#: tutorial/classes.rst:852 msgid "" "Another key feature is that the local variables and execution state are " "automatically saved between calls. This made the function easier to write " @@ -1792,7 +1792,7 @@ msgstr "" "beaucoup plus lisible qu'avec une approche utilisant des variables " "d'instance telles que ``self.index`` et ``self.data``." -#: ../src/Doc/tutorial/classes.rst:857 +#: tutorial/classes.rst:857 msgid "" "In addition to automatic method creation and saving program state, when " "generators terminate, they automatically raise :exc:`StopIteration`. In " @@ -1805,11 +1805,11 @@ msgstr "" "fonctionnalités rendent très simple la création d'itérateurs sans plus " "d'effort que l'écriture d'une fonction classique." -#: ../src/Doc/tutorial/classes.rst:866 +#: tutorial/classes.rst:866 msgid "Generator Expressions" msgstr "Expressions et générateurs" -#: ../src/Doc/tutorial/classes.rst:868 +#: tutorial/classes.rst:868 msgid "" "Some simple generators can be coded succinctly as expressions using a syntax " "similar to list comprehensions but with parentheses instead of brackets. " @@ -1826,11 +1826,11 @@ msgstr "" "définitions complètes de générateurs, et ont tendance à être plus économes " "en mémoire que leur équivalent en compréhension de listes." -#: ../src/Doc/tutorial/classes.rst:875 +#: tutorial/classes.rst:875 msgid "Examples::" msgstr "Exemples ::" -#: ../src/Doc/tutorial/classes.rst:900 +#: tutorial/classes.rst:900 msgid "" "Except for one thing. Module objects have a secret read-only attribute " "called :attr:`__dict__` which returns the dictionary used to implement the " @@ -1846,11 +1846,11 @@ msgstr "" "l'abstraction de l'implémentation des espaces de noms, et ne doit être " "restreinte qu'à des choses comme des debogueurs post-mortem." -#: ../src/Doc/tutorial/controlflow.rst:5 +#: tutorial/controlflow.rst:5 msgid "More Control Flow Tools" msgstr "D'autres outils de contrôle de flux" -#: ../src/Doc/tutorial/controlflow.rst:7 +#: tutorial/controlflow.rst:7 msgid "" "Besides the :keyword:`while` statement just introduced, Python knows the " "usual control flow statements known from other languages, with some twists." @@ -1859,18 +1859,18 @@ msgstr "" "dispose des instructions de contrôle de flux classiques que l'on trouve dans " "d'autres langages, mais toujours avec ses propres tournures." -#: ../src/Doc/tutorial/controlflow.rst:14 +#: tutorial/controlflow.rst:14 msgid ":keyword:`if` Statements" msgstr "L'instruction :keyword:`if`" -#: ../src/Doc/tutorial/controlflow.rst:16 +#: tutorial/controlflow.rst:16 msgid "" "Perhaps the most well-known statement type is the :keyword:`if` statement. " "For example::" msgstr "" "L'instruction :keyword:`if` est sans doute la plus connue. Par exemple ::" -#: ../src/Doc/tutorial/controlflow.rst:33 +#: tutorial/controlflow.rst:33 msgid "" "There can be zero or more :keyword:`elif` parts, and the :keyword:`else` " "part is optional. The keyword ':keyword:`elif`' is short for 'else if', and " @@ -1885,11 +1885,11 @@ msgstr "" "ailleurs équivalente aux instructions ``switch`` ou ``case`` disponibles " "dans d'autres langages." -#: ../src/Doc/tutorial/controlflow.rst:43 +#: tutorial/controlflow.rst:43 msgid ":keyword:`for` Statements" msgstr "L'instruction :keyword:`for`" -#: ../src/Doc/tutorial/controlflow.rst:49 +#: tutorial/controlflow.rst:49 msgid "" "The :keyword:`for` statement in Python differs a bit from what you may be " "used to in C or Pascal. Rather than always iterating over an arithmetic " @@ -1909,7 +1909,7 @@ msgstr "" "Par exemple (sans jeu de mots) :" # 8161ee2d167d4d359706f1ee40a4eee8 -#: ../src/Doc/tutorial/controlflow.rst:70 +#: tutorial/controlflow.rst:70 msgid "" "If you need to modify the sequence you are iterating over while inside the " "loop (for example to duplicate selected items), it is recommended that you " @@ -1922,12 +1922,12 @@ msgstr "" "celle-ci n'étant pas implicite. La notation \"par tranches\" rend cette " "opération particulièrement simple ::" -#: ../src/Doc/tutorial/controlflow.rst:86 +#: tutorial/controlflow.rst:86 msgid "The :func:`range` Function" msgstr "La fonction :func:`range`" # e970ab346e7c42babe10861bae0a2397 -#: ../src/Doc/tutorial/controlflow.rst:88 +#: tutorial/controlflow.rst:88 msgid "" "If you do need to iterate over a sequence of numbers, the built-in function :" "func:`range` comes in handy. It generates lists containing arithmetic " @@ -1938,7 +1938,7 @@ msgstr "" "progression arithmétique ::" # fe8625ff049a4316af3f2de7977238a9 -#: ../src/Doc/tutorial/controlflow.rst:95 +#: tutorial/controlflow.rst:95 msgid "" "The given end point is never part of the generated list; ``range(10)`` " "generates a list of 10 values, the legal indices for items of a sequence of " @@ -1952,7 +1952,7 @@ msgstr "" "valeur d'incrément différente(s) (y compris négative pour cette dernière, " "que l'on appelle également parfois le 'pas') ::" -#: ../src/Doc/tutorial/controlflow.rst:107 +#: tutorial/controlflow.rst:107 msgid "" "To iterate over the indices of a sequence, you can combine :func:`range` " "and :func:`len` as follows::" @@ -1960,7 +1960,7 @@ msgstr "" "Pour itérer sur les indices d'une séquence, on peut combiner les fonctions :" "func:`range` et :func:`len` ::" -#: ../src/Doc/tutorial/controlflow.rst:120 +#: tutorial/controlflow.rst:120 msgid "" "In most such cases, however, it is convenient to use the :func:`enumerate` " "function, see :ref:`tut-loopidioms`." @@ -1968,7 +1968,7 @@ msgstr "" "Cependant, dans la plupart des cas, il est plus pratique d'utiliser la " "fonction :func:`enumerate`. Voyez pour cela :ref:`tut-loopidioms`." -#: ../src/Doc/tutorial/controlflow.rst:127 +#: tutorial/controlflow.rst:127 msgid "" ":keyword:`break` and :keyword:`continue` Statements, and :keyword:`else` " "Clauses on Loops" @@ -1976,7 +1976,7 @@ msgstr "" "Les instructions :keyword:`break` et :keyword:`continue`, et les clauses :" "keyword:`else` au sein des boucles" -#: ../src/Doc/tutorial/controlflow.rst:129 +#: tutorial/controlflow.rst:129 msgid "" "The :keyword:`break` statement, like in C, breaks out of the smallest " "enclosing :keyword:`for` or :keyword:`while` loop." @@ -1984,7 +1984,7 @@ msgstr "" "L'instruction :keyword:`break`, comme en C, interrompt la boucle :keyword:" "`for` ou :keyword:`while` la plus imbriquée." -#: ../src/Doc/tutorial/controlflow.rst:132 +#: tutorial/controlflow.rst:132 msgid "" "Loop statements may have an ``else`` clause; it is executed when the loop " "terminates through exhaustion of the list (with :keyword:`for`) or when the " @@ -2000,7 +2000,7 @@ msgstr "" "effectue une recherche de nombres premiers, en est une démonstration ::" # c8cd94a1717f4d558d3e14aba3c8df90 -#: ../src/Doc/tutorial/controlflow.rst:156 +#: tutorial/controlflow.rst:156 msgid "" "(Yes, this is the correct code. Look closely: the ``else`` clause belongs " "to the :keyword:`for` loop, **not** the :keyword:`if` statement.)" @@ -2010,7 +2010,7 @@ msgstr "" "keyword:`if`.)" # 6d4b3d8e32a34b8a994523658f8824df -#: ../src/Doc/tutorial/controlflow.rst:159 +#: tutorial/controlflow.rst:159 msgid "" "When used with a loop, the ``else`` clause has more in common with the " "``else`` clause of a :keyword:`try` statement than it does that of :keyword:" @@ -2028,7 +2028,7 @@ msgstr "" "exceptions, consultez :ref:`tut-handling`." # 34627fe2528c4c689db6fab5cd77d971 -#: ../src/Doc/tutorial/controlflow.rst:166 +#: tutorial/controlflow.rst:166 msgid "" "The :keyword:`continue` statement, also borrowed from C, continues with the " "next iteration of the loop::" @@ -2036,11 +2036,11 @@ msgstr "" "L'instruction :keyword:`continue`, également empruntée au C, fait passer la " "boucle à son itération suivante ::" -#: ../src/Doc/tutorial/controlflow.rst:187 +#: tutorial/controlflow.rst:187 msgid ":keyword:`pass` Statements" msgstr "L'instruction :keyword:`pass`" -#: ../src/Doc/tutorial/controlflow.rst:189 +#: tutorial/controlflow.rst:189 msgid "" "The :keyword:`pass` statement does nothing. It can be used when a statement " "is required syntactically but the program requires no action. For example::" @@ -2049,12 +2049,12 @@ msgstr "" "lorsqu'une instruction est nécessaire pour fournir une syntaxe correcte, " "mais qu'aucune action ne doit être effectuée. Par exemple ::" -#: ../src/Doc/tutorial/controlflow.rst:196 +#: tutorial/controlflow.rst:196 msgid "This is commonly used for creating minimal classes::" msgstr "" "On utilise couramment cette instruction pour créer des classes minimales ::" -#: ../src/Doc/tutorial/controlflow.rst:202 +#: tutorial/controlflow.rst:202 msgid "" "Another place :keyword:`pass` can be used is as a place-holder for a " "function or conditional body when you are working on new code, allowing you " @@ -2066,11 +2066,11 @@ msgstr "" "permettant ainsi de construire votre code à un niveau plus abstrait. " "L'instruction :keyword:`pass` est alors ignorée silencieusement ::" -#: ../src/Doc/tutorial/controlflow.rst:213 +#: tutorial/controlflow.rst:213 msgid "Defining Functions" msgstr "Définir des fonctions" -#: ../src/Doc/tutorial/controlflow.rst:215 +#: tutorial/controlflow.rst:215 msgid "" "We can create a function that writes the Fibonacci series to an arbitrary " "boundary::" @@ -2078,7 +2078,7 @@ msgstr "" "On peut créer une fonction qui écrit la suite de Fibonacci jusqu'à une " "limite imposée ::" -#: ../src/Doc/tutorial/controlflow.rst:234 +#: tutorial/controlflow.rst:234 msgid "" "The keyword :keyword:`def` introduces a function *definition*. It must be " "followed by the function name and the parenthesized list of formal " @@ -2090,7 +2090,7 @@ msgstr "" "paramètres. L'instruction qui constitue le corps de la fonction débute à la " "ligne suivante, et doit être indentée." -#: ../src/Doc/tutorial/controlflow.rst:239 +#: tutorial/controlflow.rst:239 msgid "" "The first statement of the function body can optionally be a string literal; " "this string literal is the function's documentation string, or :dfn:" @@ -2109,7 +2109,7 @@ msgstr "" "naviguer de façon interactive dans le code ; prenez-en l'habitude, c'est une " "bonne habitude que de documenter le code que vous écrivez !" -#: ../src/Doc/tutorial/controlflow.rst:246 +#: tutorial/controlflow.rst:246 msgid "" "The *execution* of a function introduces a new symbol table used for the " "local variables of the function. More precisely, all variable assignments " @@ -2131,7 +2131,7 @@ msgstr "" "(sauf en utilisant une instruction :keyword:`global`), bien qu'elles " "puissent être référencées." -#: ../src/Doc/tutorial/controlflow.rst:255 +#: tutorial/controlflow.rst:255 msgid "" "The actual parameters (arguments) to a function call are introduced in the " "local symbol table of the called function when it is called; thus, arguments " @@ -2146,7 +2146,7 @@ msgstr "" "même. [#]_ Lorsqu'une fonction appelle une autre fonction, une nouvelle " "table de symboles locale est créée pour cet appel." -#: ../src/Doc/tutorial/controlflow.rst:261 +#: tutorial/controlflow.rst:261 msgid "" "A function definition introduces the function name in the current symbol " "table. The value of the function name has a type that is recognized by the " @@ -2161,7 +2161,7 @@ msgstr "" "une fonction. Ceci fournit un mécanisme de renommage général ::" # d0c90ca9530a40adbb720f8a235bd80d -#: ../src/Doc/tutorial/controlflow.rst:273 +#: tutorial/controlflow.rst:273 msgid "" "Coming from other languages, you might object that ``fib`` is not a function " "but a procedure since it doesn't return a value. In fact, even functions " @@ -2179,7 +2179,7 @@ msgstr "" "l'interpréteur lorsqu'il s'agit de la seule value écrite. Vous pouvez le " "voir si vous y tenez vraiment en utilisant :keyword:`print` ::" -#: ../src/Doc/tutorial/controlflow.rst:284 +#: tutorial/controlflow.rst:284 msgid "" "It is simple to write a function that returns a list of the numbers of the " "Fibonacci series, instead of printing it::" @@ -2187,13 +2187,13 @@ msgstr "" "Il est facile d'écrire une fonction qui renvoie une liste de la série de " "Fibonacci au lieu de l'imprimer ::" -#: ../src/Doc/tutorial/controlflow.rst:300 +#: tutorial/controlflow.rst:300 msgid "This example, as usual, demonstrates some new Python features:" msgstr "" "Cet exemple, comme d'habitude, illustre de nouvelles fonctionnalités de " "Python :" -#: ../src/Doc/tutorial/controlflow.rst:302 +#: tutorial/controlflow.rst:302 msgid "" "The :keyword:`return` statement returns with a value from a function. :" "keyword:`return` without an expression argument returns ``None``. Falling " @@ -2204,7 +2204,7 @@ msgstr "" "``None``. Arriver à la fin d'une fonction sans instruction :keyword:`return` " "renvoie également ``None``." -#: ../src/Doc/tutorial/controlflow.rst:306 +#: tutorial/controlflow.rst:306 msgid "" "The statement ``result.append(a)`` calls a *method* of the list object " "``result``. A method is a function that 'belongs' to an object and is named " @@ -2230,11 +2230,11 @@ msgstr "" "cet exemple, elle est l'équivalent de ``result = result + [a]``, mais elle " "est plus efficace." -#: ../src/Doc/tutorial/controlflow.rst:321 +#: tutorial/controlflow.rst:321 msgid "More on Defining Functions" msgstr "D'avantage sur la définition des fonctions" -#: ../src/Doc/tutorial/controlflow.rst:323 +#: tutorial/controlflow.rst:323 msgid "" "It is also possible to define functions with a variable number of arguments. " "There are three forms, which can be combined." @@ -2242,11 +2242,11 @@ msgstr "" "Il est également possible de définir des fonctions avec un nombre variable " "d'arguments. Trois syntaxes peuvent être utilisées, éventuellement combinées." -#: ../src/Doc/tutorial/controlflow.rst:330 +#: tutorial/controlflow.rst:330 msgid "Default Argument Values" msgstr "Valeur par défaut des arguments" -#: ../src/Doc/tutorial/controlflow.rst:332 +#: tutorial/controlflow.rst:332 msgid "" "The most useful form is to specify a default value for one or more " "arguments. This creates a function that can be called with fewer arguments " @@ -2256,18 +2256,18 @@ msgstr "" "certains arguments. Ceci crée une fonction qui pourra être appelée avec " "moins d'arguments que ceux présents dans sa définition. Par exemple ::" -#: ../src/Doc/tutorial/controlflow.rst:348 +#: tutorial/controlflow.rst:348 msgid "This function can be called in several ways:" msgstr "Cette fonction peut être appelée de plusieurs façons :" -#: ../src/Doc/tutorial/controlflow.rst:350 +#: tutorial/controlflow.rst:350 msgid "" "giving only the mandatory argument: ``ask_ok('Do you really want to quit?')``" msgstr "" "en ne fournissant que les arguments obligatoires : ``ask_ok('Voulez-vous " "vraiment quitter ?')``" -#: ../src/Doc/tutorial/controlflow.rst:352 +#: tutorial/controlflow.rst:352 msgid "" "giving one of the optional arguments: ``ask_ok('OK to overwrite the file?', " "2)``" @@ -2275,7 +2275,7 @@ msgstr "" "en fournissant une partie des arguments facultatifs : ``ask_ok('OK pour " "écraser le fichier ?', 2)``" -#: ../src/Doc/tutorial/controlflow.rst:354 +#: tutorial/controlflow.rst:354 msgid "" "or even giving all arguments: ``ask_ok('OK to overwrite the file?', 2, 'Come " "on, only yes or no!')``" @@ -2283,7 +2283,7 @@ msgstr "" "en fournissant tous les arguments : ``ask_ok('OK pour écraser le fichier ?', " "2, 'Allez, seulement oui ou non !')``" -#: ../src/Doc/tutorial/controlflow.rst:357 +#: tutorial/controlflow.rst:357 msgid "" "This example also introduces the :keyword:`in` keyword. This tests whether " "or not a sequence contains a certain value." @@ -2291,7 +2291,7 @@ msgstr "" "Cet exemple présente également le mot-clé :keyword:`in`. Celui-ci permet de " "tester si une séquence contient une certaine valeur." -#: ../src/Doc/tutorial/controlflow.rst:360 +#: tutorial/controlflow.rst:360 msgid "" "The default values are evaluated at the point of function definition in the " "*defining* scope, so that ::" @@ -2299,11 +2299,11 @@ msgstr "" "Les valeurs par défaut sont évaluées lors de la définition de la fonction " "dans la portée de *définition*, de telle sorte que ::" -#: ../src/Doc/tutorial/controlflow.rst:371 +#: tutorial/controlflow.rst:371 msgid "will print ``5``." msgstr "imprimera ``5``." -#: ../src/Doc/tutorial/controlflow.rst:373 +#: tutorial/controlflow.rst:373 msgid "" "**Important warning:** The default value is evaluated only once. This makes " "a difference when the default is a mutable object such as a list, " @@ -2316,11 +2316,11 @@ msgstr "" "plupart des classes. Par exemple, la fonction suivante accumule les " "arguments qui lui sont passés au fil des appels successifs ::" -#: ../src/Doc/tutorial/controlflow.rst:386 +#: tutorial/controlflow.rst:386 msgid "This will print ::" msgstr "Ceci imprimera ::" -#: ../src/Doc/tutorial/controlflow.rst:392 +#: tutorial/controlflow.rst:392 msgid "" "If you don't want the default to be shared between subsequent calls, you can " "write the function like this instead::" @@ -2328,12 +2328,12 @@ msgstr "" "Si vous ne voulez pas que cette valeur par défaut soit partagée entre des " "appels successifs, vous pouvez écrire la fonction de cette façon ::" -#: ../src/Doc/tutorial/controlflow.rst:405 +#: tutorial/controlflow.rst:405 msgid "Keyword Arguments" msgstr "Les arguments nommés" # e2d74c8fda244844a959da21ed55e0ae -#: ../src/Doc/tutorial/controlflow.rst:407 +#: tutorial/controlflow.rst:407 msgid "" "Functions can also be called using :term:`keyword arguments <keyword " "argument>` of the form ``kwarg=value``. For instance, the following " @@ -2344,7 +2344,7 @@ msgstr "" "exemple, la fonction suivante ::" # c811328e6e694919804103594d1803a0 -#: ../src/Doc/tutorial/controlflow.rst:416 +#: tutorial/controlflow.rst:416 msgid "" "accepts one required argument (``voltage``) and three optional arguments " "(``state``, ``action``, and ``type``). This function can be called in any " @@ -2355,12 +2355,12 @@ msgstr "" "n'importe laquelle des façons suivantes ::" # 6437527f4e804c17878478bff4cab807 -#: ../src/Doc/tutorial/controlflow.rst:427 +#: tutorial/controlflow.rst:427 msgid "but all the following calls would be invalid::" msgstr "mais tous les appels qui suivent sont incorrects ::" # 5665e42f479a44bcbf868c659ab8d3f0 -#: ../src/Doc/tutorial/controlflow.rst:434 +#: tutorial/controlflow.rst:434 msgid "" "In a function call, keyword arguments must follow positional arguments. All " "the keyword arguments passed must match one of the arguments accepted by the " @@ -2379,7 +2379,7 @@ msgstr "" "recevoir une valeur plus d'une fois, comme l'illustre cet exemple incorrect " "du fait de cette restriction ::" -#: ../src/Doc/tutorial/controlflow.rst:450 +#: tutorial/controlflow.rst:450 msgid "" "When a final formal parameter of the form ``**name`` is present, it receives " "a dictionary (see :ref:`typesmapping`) containing all keyword arguments " @@ -2398,15 +2398,15 @@ msgstr "" "présent avant ``**name``). Par exemple, si vous définissez une fonction " "comme ceci :" -#: ../src/Doc/tutorial/controlflow.rst:468 +#: tutorial/controlflow.rst:468 msgid "It could be called like this::" msgstr "Elle pourrait être appelée comme ceci ::" -#: ../src/Doc/tutorial/controlflow.rst:476 +#: tutorial/controlflow.rst:476 msgid "and of course it would print::" msgstr "et imprimera alors ::" -#: ../src/Doc/tutorial/controlflow.rst:487 +#: tutorial/controlflow.rst:487 msgid "" "Note that the list of keyword argument names is created by sorting the " "result of the keywords dictionary's ``keys()`` method before printing its " @@ -2418,11 +2418,11 @@ msgstr "" "celà n'est pas fait, l'ordre dans lequel les arguments sont imprimée n'est " "pas défini." -#: ../src/Doc/tutorial/controlflow.rst:494 +#: tutorial/controlflow.rst:494 msgid "Arbitrary Argument Lists" msgstr "Listes d'arguments arbitraires" -#: ../src/Doc/tutorial/controlflow.rst:499 +#: tutorial/controlflow.rst:499 msgid "" "Finally, the least frequently used option is to specify that a function can " "be called with an arbitrary number of arguments. These arguments will be " @@ -2435,11 +2435,11 @@ msgstr "" "nombre variable d'arguments, zéro arguments normaux ou plus peuvent " "apparaître ::" -#: ../src/Doc/tutorial/controlflow.rst:511 +#: tutorial/controlflow.rst:511 msgid "Unpacking Argument Lists" msgstr "Séparation des listes d'arguments" -#: ../src/Doc/tutorial/controlflow.rst:513 +#: tutorial/controlflow.rst:513 msgid "" "The reverse situation occurs when the arguments are already in a list or " "tuple but need to be unpacked for a function call requiring separate " @@ -2456,7 +2456,7 @@ msgstr "" "l'opérateur ``*`` pour séparer les arguments présents dans une liste ou un " "tuple ::" -#: ../src/Doc/tutorial/controlflow.rst:529 +#: tutorial/controlflow.rst:529 msgid "" "In the same fashion, dictionaries can deliver keyword arguments with the " "``**``\\ -operator::" @@ -2464,12 +2464,12 @@ msgstr "" "De la même façon, les dictionnaires peuvent fournir des arguments nommés en " "utilisant l'opérateur ``**`` ::" -#: ../src/Doc/tutorial/controlflow.rst:545 +#: tutorial/controlflow.rst:545 #, fuzzy msgid "Lambda Expressions" msgstr "Expressions et générateurs" -#: ../src/Doc/tutorial/controlflow.rst:547 +#: tutorial/controlflow.rst:547 #, fuzzy msgid "" "Small anonymous functions can be created with the :keyword:`lambda` keyword. " @@ -2491,7 +2491,7 @@ msgstr "" "fonctions lambda peuvent référencer des variables de la portée englobante ::" # 0a4906b6ec174baa951d833f5937c01b -#: ../src/Doc/tutorial/controlflow.rst:564 +#: tutorial/controlflow.rst:564 msgid "" "The above example uses a lambda expression to return a function. Another " "use is to pass a small function as an argument::" @@ -2500,12 +2500,12 @@ msgstr "" "Un aute usage typique est de donner une fonction minimaliste directement en " "temps que paramètre::" -#: ../src/Doc/tutorial/controlflow.rst:576 +#: tutorial/controlflow.rst:576 msgid "Documentation Strings" msgstr "Chaînes de documentation" # 41dfd2967219444194cfcf734c8325c6 -#: ../src/Doc/tutorial/controlflow.rst:583 +#: tutorial/controlflow.rst:583 msgid "" "There are emerging conventions about the content and formatting of " "documentation strings." @@ -2513,7 +2513,7 @@ msgstr "" "Il existe des conventions émergeantes concernant le contenu et le format des " "chaînes de documentation." -#: ../src/Doc/tutorial/controlflow.rst:586 +#: tutorial/controlflow.rst:586 msgid "" "The first line should always be a short, concise summary of the object's " "purpose. For brevity, it should not explicitly state the object's name or " @@ -2527,7 +2527,7 @@ msgstr "" "nom est un verbe qui décrit une opération). Cette ligne devrait commencer " "avec une majuscule et se terminer par un point." -#: ../src/Doc/tutorial/controlflow.rst:592 +#: tutorial/controlflow.rst:592 msgid "" "If there are more lines in the documentation string, the second line should " "be blank, visually separating the summary from the rest of the description. " @@ -2539,7 +2539,7 @@ msgstr "" "Les autres lignes peuvent alors constituer un ou plusieurs paragraphes " "décrivant le mode d'utilisation de l'objet, ses effets de bord, etc." -#: ../src/Doc/tutorial/controlflow.rst:597 +#: tutorial/controlflow.rst:597 msgid "" "The Python parser does not strip indentation from multi-line string literals " "in Python, so tools that process documentation have to strip indentation if " @@ -2567,15 +2567,15 @@ msgstr "" "début de ligne doivent être supprimés. L'équivalent des espaces doit être " "testé après expansion des tabulations (normalement remplacés par 4 espaces)." -#: ../src/Doc/tutorial/controlflow.rst:609 +#: tutorial/controlflow.rst:609 msgid "Here is an example of a multi-line docstring::" msgstr "Voici un exemple de chaîne de documentation multi-lignes ::" -#: ../src/Doc/tutorial/controlflow.rst:627 +#: tutorial/controlflow.rst:627 msgid "Intermezzo: Coding Style" msgstr "Un style de codage : Intermezzo" -#: ../src/Doc/tutorial/controlflow.rst:632 +#: tutorial/controlflow.rst:632 msgid "" "Now that you are about to write longer, more complex pieces of Python, it is " "a good time to talk about *coding style*. Most languages can be written (or " @@ -2590,7 +2590,7 @@ msgstr "" "votre code plus facile aux autres est toujours une bonne idée, et adopter un " "bon style de codage peut énormément vous y aider." -#: ../src/Doc/tutorial/controlflow.rst:638 +#: tutorial/controlflow.rst:638 msgid "" "For Python, :pep:`8` has emerged as the style guide that most projects " "adhere to; it promotes a very readable and eye-pleasing coding style. Every " @@ -2602,11 +2602,11 @@ msgstr "" "agréable à l'oeil. Chaque développeur Python devrait donc la lire et s'en " "inspirer autant que possible ; voici ses principaux points notables :" -#: ../src/Doc/tutorial/controlflow.rst:643 +#: tutorial/controlflow.rst:643 msgid "Use 4-space indentation, and no tabs." msgstr "Utilisez des indentations de 4 espaces, et pas de tabulation." -#: ../src/Doc/tutorial/controlflow.rst:645 +#: tutorial/controlflow.rst:645 msgid "" "4 spaces are a good compromise between small indentation (allows greater " "nesting depth) and large indentation (easier to read). Tabs introduce " @@ -2617,13 +2617,13 @@ msgstr "" "le code plus facile à lire). Les tabulations introduisent de la confusion, " "et doivent être proscrites autant que possible." -#: ../src/Doc/tutorial/controlflow.rst:649 +#: tutorial/controlflow.rst:649 msgid "Wrap lines so that they don't exceed 79 characters." msgstr "" "Faites des retours à la ligne, de telle sorte qu'elles n'excèdent pas 79 " "caractères." -#: ../src/Doc/tutorial/controlflow.rst:651 +#: tutorial/controlflow.rst:651 msgid "" "This helps users with small displays and makes it possible to have several " "code files side-by-side on larger displays." @@ -2631,7 +2631,7 @@ msgstr "" "Ceci aide les utilisateurs ne disposant que de petits écrans, et permet sur " "de plus grands de disposer plusieurs fichiers côte à côte sans difficulté." -#: ../src/Doc/tutorial/controlflow.rst:654 +#: tutorial/controlflow.rst:654 msgid "" "Use blank lines to separate functions and classes, and larger blocks of code " "inside functions." @@ -2639,16 +2639,16 @@ msgstr "" "Utilisez des lignes vides pour séparer les fonctions et les classes, ou pour " "scinder de gros blocs de code à l'intérieur de fonctions." -#: ../src/Doc/tutorial/controlflow.rst:657 +#: tutorial/controlflow.rst:657 msgid "When possible, put comments on a line of their own." msgstr "" "Lorsque c'est possible, placez les commentaires sur leur propres lignes." -#: ../src/Doc/tutorial/controlflow.rst:659 +#: tutorial/controlflow.rst:659 msgid "Use docstrings." msgstr "Utilisez les chaînes de documentation" -#: ../src/Doc/tutorial/controlflow.rst:661 +#: tutorial/controlflow.rst:661 msgid "" "Use spaces around operators and after commas, but not directly inside " "bracketing constructs: ``a = f(1, 2) + g(3, 4)``." @@ -2656,7 +2656,7 @@ msgstr "" "Utilisez des espaces autour des opérateurs et après les virgules, mais pas " "directement à l'intérieur des parenthèses : ``a = f(1, 2) + g(3, 4)``." -#: ../src/Doc/tutorial/controlflow.rst:664 +#: tutorial/controlflow.rst:664 msgid "" "Name your classes and functions consistently; the convention is to use " "``CamelCase`` for classes and ``lower_case_with_underscores`` for functions " @@ -2670,7 +2670,7 @@ msgstr "" "`tut-firstclasses` pour en savoir plus sur les classes et les méthodes)." # 82cc90f14beb4e74801836b553a5595f -#: ../src/Doc/tutorial/controlflow.rst:669 +#: tutorial/controlflow.rst:669 msgid "" "Don't use fancy encodings if your code is meant to be used in international " "environments. Plain ASCII works best in any case." @@ -2679,7 +2679,7 @@ msgstr "" "utilisé dans des environnements internationaux. L'ASCII est encore ce qui " "marche le mieux dans la plupart des cas." -#: ../src/Doc/tutorial/controlflow.rst:675 +#: tutorial/controlflow.rst:675 msgid "" "Actually, *call by object reference* would be a better description, since if " "a mutable object is passed, the caller will see any changes the callee makes " @@ -2690,11 +2690,11 @@ msgstr "" "l'appelant verra toutes les modifications qui lui auront été apportées par " "l'appelé (insertion d'éléments dans une liste...)." -#: ../src/Doc/tutorial/datastructures.rst:5 +#: tutorial/datastructures.rst:5 msgid "Data Structures" msgstr "Structures de données" -#: ../src/Doc/tutorial/datastructures.rst:7 +#: tutorial/datastructures.rst:7 msgid "" "This chapter describes some things you've learned about already in more " "detail, and adds some new things as well." @@ -2702,11 +2702,11 @@ msgstr "" "Ce chapitre reprend plus en détail quelques point déjà décrits précédemment, " "et introduit également de nouvelles notions." -#: ../src/Doc/tutorial/datastructures.rst:14 +#: tutorial/datastructures.rst:14 msgid "More on Lists" msgstr "Compléments sur les listes" -#: ../src/Doc/tutorial/datastructures.rst:16 +#: tutorial/datastructures.rst:16 msgid "" "The list data type has some more methods. Here are all of the methods of " "list objects:" @@ -2714,12 +2714,12 @@ msgstr "" "Le type liste dispose de méthodes supplémentaires. Voici la liste complète " "des méthodes des objets de type liste :" -#: ../src/Doc/tutorial/datastructures.rst:23 +#: tutorial/datastructures.rst:23 msgid "Add an item to the end of the list; equivalent to ``a[len(a):] = [x]``." msgstr "" "Ajoute un élément à la fin de la liste ; équivalent à ``a[len(a):] = [x]``." -#: ../src/Doc/tutorial/datastructures.rst:29 +#: tutorial/datastructures.rst:29 msgid "" "Extend the list by appending all the items in the given list; equivalent to " "``a[len(a):] = L``." @@ -2727,7 +2727,7 @@ msgstr "" "Étend la liste en y ajoutant tous les éléments de la liste fournie ; " "équivalent à ``a[len(a):] = L``." -#: ../src/Doc/tutorial/datastructures.rst:36 +#: tutorial/datastructures.rst:36 msgid "" "Insert an item at a given position. The first argument is the index of the " "element before which to insert, so ``a.insert(0, x)`` inserts at the front " @@ -2738,7 +2738,7 @@ msgstr "" "donc ``a.insert(0, x)`` insère l'élément en tête de la liste, et ``a." "insert(len(a), x)`` est équivalent à ``a.append(x)``." -#: ../src/Doc/tutorial/datastructures.rst:44 +#: tutorial/datastructures.rst:44 msgid "" "Remove the first item from the list whose value is *x*. It is an error if " "there is no such item." @@ -2746,7 +2746,7 @@ msgstr "" "Supprime de la liste le premier élément dont la valeur est *x*. Une " "exception est levée s'il existe aucun élément avec cette valeur." -#: ../src/Doc/tutorial/datastructures.rst:51 +#: tutorial/datastructures.rst:51 msgid "" "Remove the item at the given position in the list, and return it. If no " "index is specified, ``a.pop()`` removes and returns the last item in the " @@ -2762,7 +2762,7 @@ msgstr "" "devez placer des crochets dans votre code ! Vous retrouverez cette notation " "fréquemment dans le Guide de Référence de la Bibliothèque Python)." -#: ../src/Doc/tutorial/datastructures.rst:61 +#: tutorial/datastructures.rst:61 msgid "" "Return the index in the list of the first item whose value is *x*. It is an " "error if there is no such item." @@ -2770,12 +2770,12 @@ msgstr "" "Retourne la position du premier élément de la liste ayant la valeur *x*. Une " "exception est levée s'il n'existe aucun élément avec cette valeur." -#: ../src/Doc/tutorial/datastructures.rst:68 +#: tutorial/datastructures.rst:68 msgid "Return the number of times *x* appears in the list." msgstr "Retourne le nombre d'éléments ayant la valeur *x* dans la liste." # 6dc59ed94c2c47c3962f20b08b0eaf50 -#: ../src/Doc/tutorial/datastructures.rst:74 +#: tutorial/datastructures.rst:74 msgid "" "Sort the items of the list in place (the arguments can be used for sort " "customization, see :func:`sorted` for their explanation)." @@ -2783,16 +2783,16 @@ msgstr "" "Trie les éléments sur place, (les arguments peuvent personaliser le tri, " "voir :func:`sorted` pour leur explication)." -#: ../src/Doc/tutorial/datastructures.rst:81 +#: tutorial/datastructures.rst:81 msgid "Reverse the elements of the list, in place." msgstr "Inverse l'ordre des éléments de la liste, en place." -#: ../src/Doc/tutorial/datastructures.rst:83 +#: tutorial/datastructures.rst:83 msgid "An example that uses most of the list methods::" msgstr "L'exemple suivant utilise la plupart des méthodes des listes ::" # 9cff5f781f524707b2580a69eb21e165 -#: ../src/Doc/tutorial/datastructures.rst:108 +#: tutorial/datastructures.rst:108 msgid "" "You might have noticed that methods like ``insert``, ``remove`` or ``sort`` " "that only modify the list have no return value printed -- they return the " @@ -2804,11 +2804,11 @@ msgstr "" "de valeur mais ``None``. [1]_ C'est un principe respecté par toutes les " "structures de données variables en Python." -#: ../src/Doc/tutorial/datastructures.rst:117 +#: tutorial/datastructures.rst:117 msgid "Using Lists as Stacks" msgstr "Utiliser les listes comme des piles" -#: ../src/Doc/tutorial/datastructures.rst:122 +#: tutorial/datastructures.rst:122 msgid "" "The list methods make it very easy to use a list as a stack, where the last " "element added is the first element retrieved (\"last-in, first-out\"). To " @@ -2823,11 +2823,11 @@ msgstr "" "l'objet au sommet de la pile, utilisez la méthode :meth:`pop`, sans " "indicateur de position. Par exemple ::" -#: ../src/Doc/tutorial/datastructures.rst:147 +#: tutorial/datastructures.rst:147 msgid "Using Lists as Queues" msgstr "Utiliser les listes comme des files" -#: ../src/Doc/tutorial/datastructures.rst:151 +#: tutorial/datastructures.rst:151 msgid "" "It is also possible to use a list as a queue, where the first element added " "is the first element retrieved (\"first-in, first-out\"); however, lists are " @@ -2843,7 +2843,7 @@ msgstr "" "début de liste sont lentes (car tous les autres éléments doivent être " "décalés d'une position)." -#: ../src/Doc/tutorial/datastructures.rst:157 +#: tutorial/datastructures.rst:157 msgid "" "To implement a queue, use :class:`collections.deque` which was designed to " "have fast appends and pops from both ends. For example::" @@ -2853,12 +2853,12 @@ msgstr "" "rapides aux deux extrémités. Par exemple ::" # f37a954339024319a4a38dcc87019274 -#: ../src/Doc/tutorial/datastructures.rst:175 +#: tutorial/datastructures.rst:175 msgid "Functional Programming Tools" msgstr "Outils de programmation fonctionnelle" # 8ec920989c304fb3b1e7bc3ba16cc69d -#: ../src/Doc/tutorial/datastructures.rst:177 +#: tutorial/datastructures.rst:177 msgid "" "There are three built-in functions that are very useful when used with " "lists: :func:`filter`, :func:`map`, and :func:`reduce`." @@ -2867,14 +2867,14 @@ msgstr "" "utilisées avec des listes : :func:`filter`, :func:`map` et :func:`reduce`." # bd57b7606e0443a0ab47c23c055f820e -#: ../src/Doc/tutorial/datastructures.rst:180 +#: tutorial/datastructures.rst:180 #, fuzzy msgid "" "``filter(function, sequence)`` returns a sequence consisting of those items " "from the sequence for which ``function(item)`` is true. If *sequence* is a :" -"class:`string` or :class:`tuple`, the result will be of the same type; " -"otherwise, it is always a :class:`list`. For example, to compute a sequence " -"of numbers divisible by 3 or 5::" +"class:`str`, :class:`unicode` or :class:`tuple`, the result will be of the " +"same type; otherwise, it is always a :class:`list`. For example, to compute " +"a sequence of numbers divisible by 3 or 5::" msgstr "" "``filter(function, sequence)`` retourne une séquence composée des éléments " "de la séquence initiale pour lesquels la fonction ``function(item)`` est " @@ -2884,7 +2884,7 @@ msgstr "" "par 3 ::" # 5f5a7fc45a614c2891bf0573e3d5c5e9 -#: ../src/Doc/tutorial/datastructures.rst:191 +#: tutorial/datastructures.rst:191 msgid "" "``map(function, sequence)`` calls ``function(item)`` for each of the " "sequence's items and returns a list of the return values. For example, to " @@ -2895,7 +2895,7 @@ msgstr "" "exemple, pour calculer des cubes ::" # c1de3d96a00b489784f899a7fc376b1f -#: ../src/Doc/tutorial/datastructures.rst:200 +#: tutorial/datastructures.rst:200 msgid "" "More than one sequence may be passed; the function must then have as many " "arguments as there are sequences and is called with the corresponding item " @@ -2908,7 +2908,7 @@ msgstr "" "séquences sont plus courtes que d'autres)." # 8240028754784e7a84b5be66fa08f0ba -#: ../src/Doc/tutorial/datastructures.rst:211 +#: tutorial/datastructures.rst:211 msgid "" "``reduce(function, sequence)`` returns a single value constructed by calling " "the binary function *function* on the first two items of the sequence, then " @@ -2921,7 +2921,7 @@ msgstr "" "ainsi de suite. Par exemple, pour calculer la somme des nombres de 1 à 10 ::" # cb31dca23a5d44aa970a94dab6c09da5 -#: ../src/Doc/tutorial/datastructures.rst:221 +#: tutorial/datastructures.rst:221 msgid "" "If there's only one item in the sequence, its value is returned; if the " "sequence is empty, an exception is raised." @@ -2930,7 +2930,7 @@ msgstr "" "la séquence est vide, une exception est levée." # 67aeb633f3264986a2f5c0fad841946c -#: ../src/Doc/tutorial/datastructures.rst:224 +#: tutorial/datastructures.rst:224 msgid "" "A third argument can be passed to indicate the starting value. In this case " "the starting value is returned for an empty sequence, and the function is " @@ -2944,7 +2944,7 @@ msgstr "" "l'élément suivant, et ainsi de suite. Par exemple ::" # 4c945638e9fd442d8f09748ac20cbc27 -#: ../src/Doc/tutorial/datastructures.rst:238 +#: tutorial/datastructures.rst:238 msgid "" "Don't use this example's definition of :func:`sum`: since summing numbers is " "such a common need, a built-in function ``sum(sequence)`` is already " @@ -2954,12 +2954,12 @@ msgstr "" "des sommes de nombres est un besoin tellement courant qu'il existe une " "fonction native ``sum(sequence)`` qui fait exactement la même chose." -#: ../src/Doc/tutorial/datastructures.rst:245 +#: tutorial/datastructures.rst:245 msgid "List Comprehensions" msgstr "Compréhensions de listes" # bacb848669ad4fa9abb4a3d77791f4c2 -#: ../src/Doc/tutorial/datastructures.rst:247 +#: tutorial/datastructures.rst:247 msgid "" "List comprehensions provide a concise way to create lists. Common " "applications are to make new lists where each element is the result of some " @@ -2973,18 +2973,18 @@ msgstr "" "éléments satisfaisant une condition spécifique." # 037f4e076d664f8389360ada349255eb -#: ../src/Doc/tutorial/datastructures.rst:252 +#: tutorial/datastructures.rst:252 msgid "For example, assume we want to create a list of squares, like::" msgstr "" "Par exemple, supposons que l'on veuille créer une liste de carrés, comme ::" # f1ecaf420bcc491cb856a1f05ad37538 -#: ../src/Doc/tutorial/datastructures.rst:261 +#: tutorial/datastructures.rst:261 msgid "We can obtain the same result with::" msgstr "On peut obtenir le même résultat avec ::" # d14333f8fdc241f09c158e509605a7f3 -#: ../src/Doc/tutorial/datastructures.rst:265 +#: tutorial/datastructures.rst:265 msgid "" "This is also equivalent to ``squares = map(lambda x: x**2, range(10))``, but " "it's more concise and readable." @@ -2993,7 +2993,7 @@ msgstr "" "range(10))``, mais en plus concis et plus lisible." # 3467ea01b37a4111a1dc155df11cf9f1 -#: ../src/Doc/tutorial/datastructures.rst:268 +#: tutorial/datastructures.rst:268 msgid "" "A list comprehension consists of brackets containing an expression followed " "by a :keyword:`for` clause, then zero or more :keyword:`for` or :keyword:" @@ -3010,12 +3010,12 @@ msgstr "" "combine les éléments de deux listes s'ils ne sont pas égaux ::" # d67d99a05bc540d09311203640400abd -#: ../src/Doc/tutorial/datastructures.rst:278 +#: tutorial/datastructures.rst:278 msgid "and it's equivalent to:" msgstr "et c'est équivaent à ::" # c6f54fd8b04e497dbf2f03edaa0abc9e -#: ../src/Doc/tutorial/datastructures.rst:289 +#: tutorial/datastructures.rst:289 msgid "" "Note how the order of the :keyword:`for` and :keyword:`if` statements is the " "same in both these snippets." @@ -3024,7 +3024,7 @@ msgstr "" "même dans ces différents extraits de code." # d653b9fb2b45432d9e5e67ee70fbecd9 -#: ../src/Doc/tutorial/datastructures.rst:292 +#: tutorial/datastructures.rst:292 msgid "" "If the expression is a tuple (e.g. the ``(x, y)`` in the previous example), " "it must be parenthesized. ::" @@ -3033,19 +3033,19 @@ msgstr "" "elle doit être entourée par des parenthèses ::" # 6519493b0333463c9e8d314fd4c1af4c -#: ../src/Doc/tutorial/datastructures.rst:323 +#: tutorial/datastructures.rst:323 msgid "" "List comprehensions can contain complex expressions and nested functions::" msgstr "" "Les compréhensions de listes peuvent contenir des expressions complexes et " "des fonctions imbriquées ::" -#: ../src/Doc/tutorial/datastructures.rst:331 +#: tutorial/datastructures.rst:331 msgid "Nested List Comprehensions" msgstr "Compréhensions de listes imbriquées" # 362a977414e741d3b6464df3bf5c11ce -#: ../src/Doc/tutorial/datastructures.rst:333 +#: tutorial/datastructures.rst:333 msgid "" "The initial expression in a list comprehension can be any arbitrary " "expression, including another list comprehension." @@ -3054,7 +3054,7 @@ msgstr "" "quelle expression, y compris une autre compréhension de liste." # a88f2fa3f41144bfbd62a2693612ceb1 -#: ../src/Doc/tutorial/datastructures.rst:336 +#: tutorial/datastructures.rst:336 msgid "" "Consider the following example of a 3x4 matrix implemented as a list of 3 " "lists of length 4::" @@ -3063,13 +3063,13 @@ msgstr "" "listes de 4 éléments ::" # badd753c026841c9a79115aa2de84eab -#: ../src/Doc/tutorial/datastructures.rst:345 +#: tutorial/datastructures.rst:345 msgid "The following list comprehension will transpose rows and columns::" msgstr "" "Cette compréhension de liste va transposer les lignes et les colonnes ::" # 5661198254ed47449d72c22038e9f2b9 -#: ../src/Doc/tutorial/datastructures.rst:350 +#: tutorial/datastructures.rst:350 msgid "" "As we saw in the previous section, the nested listcomp is evaluated in the " "context of the :keyword:`for` that follows it, so this example is equivalent " @@ -3080,12 +3080,12 @@ msgstr "" "la suit, donc cet exemple est équivalent à ::" # 294e46c6a9bf43abbb25bdbab77ecfac -#: ../src/Doc/tutorial/datastructures.rst:361 +#: tutorial/datastructures.rst:361 msgid "which, in turn, is the same as::" msgstr "lequel à son tour est équivalent à ::" # 6eb39f5c7cee4c69bcdce5003c9dc1d9 -#: ../src/Doc/tutorial/datastructures.rst:375 +#: tutorial/datastructures.rst:375 msgid "" "In the real world, you should prefer built-in functions to complex flow " "statements. The :func:`zip` function would do a great job for this use case::" @@ -3094,17 +3094,17 @@ msgstr "" "natives plutôt que des instructions de contrôle de flux complexes. La " "fonction :func:`zip` ferait dans ce cas un excellent travail ::" -#: ../src/Doc/tutorial/datastructures.rst:381 +#: tutorial/datastructures.rst:381 msgid "" "See :ref:`tut-unpacking-arguments` for details on the asterisk in this line." msgstr "" "Voyez :ref:`tut-unpacking-arguments` pour plus de détails sur cette ligne." -#: ../src/Doc/tutorial/datastructures.rst:386 +#: tutorial/datastructures.rst:386 msgid "The :keyword:`del` statement" msgstr "L'instruction :keyword:`del`" -#: ../src/Doc/tutorial/datastructures.rst:388 +#: tutorial/datastructures.rst:388 msgid "" "There is a way to remove an item from a list given its index instead of its " "value: the :keyword:`del` statement. This differs from the :meth:`pop` " @@ -3119,12 +3119,12 @@ msgstr "" "ou la vider complètement (ce que nous avions fait auparavent en affectant " "une liste vide à la tranche). Par exemple ::" -#: ../src/Doc/tutorial/datastructures.rst:405 +#: tutorial/datastructures.rst:405 msgid ":keyword:`del` can also be used to delete entire variables::" msgstr "" ":keyword:`del` peut aussi être utilisée pour supprimer des variables ::" -#: ../src/Doc/tutorial/datastructures.rst:409 +#: tutorial/datastructures.rst:409 msgid "" "Referencing the name ``a`` hereafter is an error (at least until another " "value is assigned to it). We'll find other uses for :keyword:`del` later." @@ -3133,11 +3133,11 @@ msgstr "" "qu'une autre valeur lui soit affectée). Vous trouverez d'autres utilisations " "de la fonction :keyword:`del` plus tard." -#: ../src/Doc/tutorial/datastructures.rst:416 +#: tutorial/datastructures.rst:416 msgid "Tuples and Sequences" msgstr "Tuples et séquences" -#: ../src/Doc/tutorial/datastructures.rst:418 +#: tutorial/datastructures.rst:418 msgid "" "We saw that lists and strings have many common properties, such as indexing " "and slicing operations. They are two examples of *sequence* data types " @@ -3152,7 +3152,7 @@ msgstr "" "être ajoutés. Il existe également un autre type standard de séquence : le " "*tuple*." -#: ../src/Doc/tutorial/datastructures.rst:424 +#: tutorial/datastructures.rst:424 msgid "" "A tuple consists of a number of values separated by commas, for instance::" msgstr "" @@ -3160,7 +3160,7 @@ msgstr "" "par exemple ::" # a5badcce7c75451982575cc784cb15da -#: ../src/Doc/tutorial/datastructures.rst:446 +#: tutorial/datastructures.rst:446 msgid "" "As you see, on output tuples are always enclosed in parentheses, so that " "nested tuples are interpreted correctly; they may be input with or without " @@ -3178,7 +3178,7 @@ msgstr "" "tuples contenant des objets mutables, comme des listes." # b6c3a9f8bf504d2383860d62b9823a5a -#: ../src/Doc/tutorial/datastructures.rst:453 +#: tutorial/datastructures.rst:453 msgid "" "Though tuples may seem similar to lists, they are often used in different " "situations and for different purposes. Tuples are :term:`immutable`, and " @@ -3197,7 +3197,7 @@ msgstr "" "<mutable>`, et contiennent des éléments homogènes qui sont accédés par " "itération sur la liste." -#: ../src/Doc/tutorial/datastructures.rst:461 +#: tutorial/datastructures.rst:461 msgid "" "A special problem is the construction of tuples containing 0 or 1 items: the " "syntax has some extra quirks to accommodate these. Empty tuples are " @@ -3212,7 +3212,7 @@ msgstr "" "valeur par une virgule (il n'est pas suffisant de placer cette valeur entre " "parenthèses). Pas très joli, mais efficace. Par exemple ::" -#: ../src/Doc/tutorial/datastructures.rst:476 +#: tutorial/datastructures.rst:476 msgid "" "The statement ``t = 12345, 54321, 'hello!'`` is an example of *tuple " "packing*: the values ``12345``, ``54321`` and ``'hello!'`` are packed " @@ -3223,7 +3223,7 @@ msgstr "" "ensemble dans un tuple. L'opération inverse est aussi possible ::" # bee7de83217d467eba7a079c65b7ad5d -#: ../src/Doc/tutorial/datastructures.rst:482 +#: tutorial/datastructures.rst:482 msgid "" "This is called, appropriately enough, *sequence unpacking* and works for any " "sequence on the right-hand side. Sequence unpacking requires the list of " @@ -3238,11 +3238,11 @@ msgstr "" "est juste une combinaison entre un emballage de tuple et un déballage de " "séquence." -#: ../src/Doc/tutorial/datastructures.rst:492 +#: tutorial/datastructures.rst:492 msgid "Sets" msgstr "Les ensembles" -#: ../src/Doc/tutorial/datastructures.rst:494 +#: tutorial/datastructures.rst:494 msgid "" "Python also includes a data type for *sets*. A set is an unordered " "collection with no duplicate elements. Basic uses include membership " @@ -3257,7 +3257,7 @@ msgstr "" "comme les unions, intersections, différences et différences symétriques." # da01767b1479416bba017b6990483d52 -#: ../src/Doc/tutorial/datastructures.rst:499 +#: tutorial/datastructures.rst:499 msgid "" "Curly braces or the :func:`set` function can be used to create sets. Note: " "to create an empty set you have to use ``set()``, not ``{}``; the latter " @@ -3268,12 +3268,12 @@ msgstr "" "des ensembles. Notez que pour créer un ensemble vide, ``{}`` ne " "fonctionne pas, cela créé un dictionnaire vide. Utilisez plutôt ``set()``." -#: ../src/Doc/tutorial/datastructures.rst:503 +#: tutorial/datastructures.rst:503 msgid "Here is a brief demonstration::" msgstr "Voici une brève démonstration ::" # a95edf151888454c84702a1853e2ab22 -#: ../src/Doc/tutorial/datastructures.rst:529 +#: tutorial/datastructures.rst:529 msgid "" "Similarly to :ref:`list comprehensions <tut-listcomps>`, set comprehensions " "are also supported::" @@ -3281,11 +3281,11 @@ msgstr "" "Tout comme les :ref:`comprehensions de listes <tut-listcomps>`, il est " "possibled'écrire des comprehensions d'ensembles ::" -#: ../src/Doc/tutorial/datastructures.rst:540 +#: tutorial/datastructures.rst:540 msgid "Dictionaries" msgstr "Dictionnaires" -#: ../src/Doc/tutorial/datastructures.rst:542 +#: tutorial/datastructures.rst:542 msgid "" "Another useful data type built into Python is the *dictionary* (see :ref:" "`typesmapping`). Dictionaries are sometimes found in other languages as " @@ -3312,7 +3312,7 @@ msgstr "" "affectations par position, par tranches ou via des méthodes comme :meth:" "`append` ou :meth:`extend`." -#: ../src/Doc/tutorial/datastructures.rst:553 +#: tutorial/datastructures.rst:553 msgid "" "It is best to think of a dictionary as an unordered set of *key: value* " "pairs, with the requirement that the keys are unique (within one " @@ -3329,7 +3329,7 @@ msgstr "" "dictionnaire ; c'est également de cette façon que les dictionnaires sont " "affichés en sortie." -#: ../src/Doc/tutorial/datastructures.rst:559 +#: tutorial/datastructures.rst:559 msgid "" "The main operations on a dictionary are storing a value with some key and " "extracting the value given the key. It is also possible to delete a key:" @@ -3345,7 +3345,7 @@ msgstr "" "une valeur associée à une clé qui n'existe pas, une exception est levée." # a554aa7680394a23a6e1b29ad07b5253 -#: ../src/Doc/tutorial/datastructures.rst:565 +#: tutorial/datastructures.rst:565 msgid "" "The :meth:`keys` method of a dictionary object returns a list of all the " "keys used in the dictionary, in arbitrary order (if you want it sorted, just " @@ -3358,12 +3358,12 @@ msgstr "" "tester si une clé est dans le dictionnaire, utilisez le mot-clé :keyword:" "`in`." -#: ../src/Doc/tutorial/datastructures.rst:570 +#: tutorial/datastructures.rst:570 msgid "Here is a small example using a dictionary::" msgstr "Voici un petit exemple utilisant un dictionnaire ::" # da517bdab6f24e778cac08736d919390 -#: ../src/Doc/tutorial/datastructures.rst:587 +#: tutorial/datastructures.rst:587 #, fuzzy msgid "" "The :func:`dict` constructor builds dictionaries directly from sequences of " @@ -3375,7 +3375,7 @@ msgstr "" "fournir la liste des clés-valeurs sous une forme compacte ::" # 098a1063baa44926bfd63f941681c98f -#: ../src/Doc/tutorial/datastructures.rst:593 +#: tutorial/datastructures.rst:593 msgid "" "In addition, dict comprehensions can be used to create dictionaries from " "arbitrary key and value expressions::" @@ -3383,7 +3383,7 @@ msgstr "" "De plus, il est possible de créer des dictionnaires par compréhension depuis " "un jeu de clef et valeurs ::" -#: ../src/Doc/tutorial/datastructures.rst:599 +#: tutorial/datastructures.rst:599 msgid "" "When the keys are simple strings, it is sometimes easier to specify pairs " "using keyword arguments::" @@ -3391,11 +3391,11 @@ msgstr "" "Lorsque les clés sont de simples chaînes de caractères, il est parfois plus " "facile de spécifier les paires en utilisant des paramètres nommés ::" -#: ../src/Doc/tutorial/datastructures.rst:609 +#: tutorial/datastructures.rst:609 msgid "Looping Techniques" msgstr "Techniques de boucles" -#: ../src/Doc/tutorial/datastructures.rst:611 +#: tutorial/datastructures.rst:611 msgid "" "When looping through a sequence, the position index and corresponding value " "can be retrieved at the same time using the :func:`enumerate` function. ::" @@ -3404,7 +3404,7 @@ msgstr "" "correspondante peuvent être récupérées en même temps en utilisant la " "fonction :func:`enumerate`." -#: ../src/Doc/tutorial/datastructures.rst:621 +#: tutorial/datastructures.rst:621 msgid "" "To loop over two or more sequences at the same time, the entries can be " "paired with the :func:`zip` function. ::" @@ -3412,7 +3412,7 @@ msgstr "" "Pour faire des boucles sur deux séquences ou plus en même temps, les " "éléments peuvent être associés par la fonction :func:`zip` ::" -#: ../src/Doc/tutorial/datastructures.rst:633 +#: tutorial/datastructures.rst:633 msgid "" "To loop over a sequence in reverse, first specify the sequence in a forward " "direction and then call the :func:`reversed` function. ::" @@ -3421,7 +3421,7 @@ msgstr "" "séquence dans son ordre normal, puis appliquez la fonction :func:" "`reversed` ::" -#: ../src/Doc/tutorial/datastructures.rst:645 +#: tutorial/datastructures.rst:645 msgid "" "To loop over a sequence in sorted order, use the :func:`sorted` function " "which returns a new sorted list while leaving the source unaltered. ::" @@ -3430,7 +3430,7 @@ msgstr "" "`sorted`, qui renvoie une nouvelle liste triée sans altérer la source ::" # a1e578bf4b954f29a28fc5bb96bfe66a -#: ../src/Doc/tutorial/datastructures.rst:657 +#: tutorial/datastructures.rst:657 msgid "" "When looping through dictionaries, the key and corresponding value can be " "retrieved at the same time using the :meth:`iteritems` method. ::" @@ -3439,25 +3439,17 @@ msgstr "" "valeurs peuvent être récupérées en même temps en utilisant la méthode :meth:" "`iteritems` ::" -# ce8381976b434e66b7c5471cd5d43209 -#: ../src/Doc/tutorial/datastructures.rst:667 +#: tutorial/datastructures.rst:667 msgid "" -"To change a sequence you are iterating over while inside the loop (for " -"example to duplicate certain items), it is recommended that you first make a " -"copy. Looping over a sequence does not implicitly make a copy. The slice " -"notation makes this especially convenient::" +"It is sometimes tempting to change a list while you are looping over it; " +"however, it is often simpler and safer to create a new list instead. ::" msgstr "" -"Si vous devez modifier une séquence sur laquelle vous êtes en train de faire " -"une boucle (par exemple pour dupliquer ou supprimer certains éléments), il " -"est recommandé de commencer par en faire une copie. Celle-ci n'est pas " -"implicite lorsque vous faites une boucle sur une séquence. La notation par " -"tranches rend cette opération particulièrement pratique ::" -#: ../src/Doc/tutorial/datastructures.rst:684 +#: tutorial/datastructures.rst:684 msgid "More on Conditions" msgstr "Plus d'informations sur les conditions" -#: ../src/Doc/tutorial/datastructures.rst:686 +#: tutorial/datastructures.rst:686 msgid "" "The conditions used in ``while`` and ``if`` statements can contain any " "operators, not just comparisons." @@ -3465,7 +3457,7 @@ msgstr "" "Les conditions utilisées dans une instruction ``while`` ou ``if`` peuvent " "contenir n'importe quel opérateur, pas seulement des comparaisons." -#: ../src/Doc/tutorial/datastructures.rst:689 +#: tutorial/datastructures.rst:689 msgid "" "The comparison operators ``in`` and ``not in`` check whether a value occurs " "(does not occur) in a sequence. The operators ``is`` and ``is not`` compare " @@ -3480,7 +3472,7 @@ msgstr "" "comparaison ont la même priorité, qui est plus faible que celle des " "opérateurs numériques." -#: ../src/Doc/tutorial/datastructures.rst:695 +#: tutorial/datastructures.rst:695 msgid "" "Comparisons can be chained. For example, ``a < b == c`` tests whether ``a`` " "is less than ``b`` and moreover ``b`` equals ``c``." @@ -3489,7 +3481,7 @@ msgstr "" "si ``a`` est inférieur ou égal à ``b`` et par ailleurs si ``b`` est égal à " "``c``." -#: ../src/Doc/tutorial/datastructures.rst:698 +#: tutorial/datastructures.rst:698 msgid "" "Comparisons may be combined using the Boolean operators ``and`` and ``or``, " "and the outcome of a comparison (or of any other Boolean expression) may be " @@ -3507,7 +3499,7 @@ msgstr "" "Comme toujours, des parenthèses peuvent être utilisées pour exprimer " "l'instruction désirée." -#: ../src/Doc/tutorial/datastructures.rst:705 +#: tutorial/datastructures.rst:705 msgid "" "The Boolean operators ``and`` and ``or`` are so-called *short-circuit* " "operators: their arguments are evaluated from left to right, and evaluation " @@ -3524,7 +3516,7 @@ msgstr "" "tant que booléen, la valeur de retour d'un opérateur en circuit court est " "celle du dernier argument évalué." -#: ../src/Doc/tutorial/datastructures.rst:712 +#: tutorial/datastructures.rst:712 msgid "" "It is possible to assign the result of a comparison or other Boolean " "expression to a variable. For example, ::" @@ -3532,7 +3524,7 @@ msgstr "" "Il est possible d'affecter le résultat d'une comparaison ou d'une autre " "expression booléenne à une variable. Par exemple ::" -#: ../src/Doc/tutorial/datastructures.rst:720 +#: tutorial/datastructures.rst:720 msgid "" "Note that in Python, unlike C, assignment cannot occur inside expressions. C " "programmers may grumble about this, but it avoids a common class of problems " @@ -3545,12 +3537,12 @@ msgstr "" "en C, lorsque l'expression ``=`` est placée alors qu'une expression ``==`` " "était attendue." -#: ../src/Doc/tutorial/datastructures.rst:729 +#: tutorial/datastructures.rst:729 msgid "Comparing Sequences and Other Types" msgstr "Comparer des séquences avec d'autres types" # 41977cc17fef443ea5ee4eb2acbc42b4 -#: ../src/Doc/tutorial/datastructures.rst:731 +#: tutorial/datastructures.rst:731 msgid "" "Sequence objects may be compared to other objects with the same sequence " "type. The comparison uses *lexicographical* ordering: first the first two " @@ -3580,7 +3572,7 @@ msgstr "" "séquences de même type ::" # f6a8739089604c31b9a69729e466dbd3 -#: ../src/Doc/tutorial/datastructures.rst:751 +#: tutorial/datastructures.rst:751 msgid "" "Note that comparing objects of different types is legal. The outcome is " "deterministic but arbitrary: the types are ordered by their name. Thus, a " @@ -3596,7 +3588,7 @@ msgstr "" "numérique, donc 0 est égal à 0.0, etc." # 9443e810e7df404caf028d0caea7657d -#: ../src/Doc/tutorial/datastructures.rst:760 +#: tutorial/datastructures.rst:760 msgid "" "The rules for comparing objects of different types should not be relied " "upon; they may change in a future version of the language." @@ -3605,11 +3597,11 @@ msgstr "" "considérées comme fiables ; elles peuvent être amenées à changer dans une " "future version du langage." -#: ../src/Doc/tutorial/errors.rst:5 +#: tutorial/errors.rst:5 msgid "Errors and Exceptions" msgstr "Erreurs et exceptions" -#: ../src/Doc/tutorial/errors.rst:7 +#: tutorial/errors.rst:7 msgid "" "Until now error messages haven't been more than mentioned, but if you have " "tried out the examples you have probably seen some. There are (at least) " @@ -3620,11 +3612,11 @@ msgstr "" "cela. En fait, il y a au moins deux types d'erreurs à distinguer : les " "*erreurs de syntaxe* et les *exceptions*." -#: ../src/Doc/tutorial/errors.rst:15 +#: tutorial/errors.rst:15 msgid "Syntax Errors" msgstr "Les erreurs de syntaxe" -#: ../src/Doc/tutorial/errors.rst:17 +#: tutorial/errors.rst:17 msgid "" "Syntax errors, also known as parsing errors, are perhaps the most common " "kind of complaint you get while you are still learning Python::" @@ -3634,7 +3626,7 @@ msgstr "" "phase d'apprentissage de Python ::" # 137385ef98c047a296ca35d560a94016 -#: ../src/Doc/tutorial/errors.rst:26 +#: tutorial/errors.rst:26 msgid "" "The parser repeats the offending line and displays a little 'arrow' pointing " "at the earliest point in the line where the error was detected. The error " @@ -3651,11 +3643,11 @@ msgstr "" "permettre de localiser facilement l'erreur lorsque le code provient d'un " "script." -#: ../src/Doc/tutorial/errors.rst:37 +#: tutorial/errors.rst:37 msgid "Exceptions" msgstr "Les exceptions" -#: ../src/Doc/tutorial/errors.rst:39 +#: tutorial/errors.rst:39 msgid "" "Even if a statement or expression is syntactically correct, it may cause an " "error when an attempt is made to execute it. Errors detected during " @@ -3671,7 +3663,7 @@ msgstr "" "des exceptions toutefois ne sont pas prises en charge par les programmes, ce " "qui génère des messages d'erreurs comme celui-ci ::" -#: ../src/Doc/tutorial/errors.rst:58 +#: tutorial/errors.rst:58 msgid "" "The last line of the error message indicates what happened. Exceptions come " "in different types, and the type is printed as part of the message: the " @@ -3692,7 +3684,7 @@ msgstr "" "pratique). Les noms des exceptions standards sont des identifiants natifs " "(pas des mots réservés)." -#: ../src/Doc/tutorial/errors.rst:66 +#: tutorial/errors.rst:66 msgid "" "The rest of the line provides detail based on the type of exception and what " "caused it." @@ -3700,7 +3692,7 @@ msgstr "" "Le reste de la ligne fournit plus de détails en fonction du type de " "l'exception et de ce qui l'a causé." -#: ../src/Doc/tutorial/errors.rst:69 +#: tutorial/errors.rst:69 msgid "" "The preceding part of the error message shows the context where the " "exception happened, in the form of a stack traceback. In general it contains " @@ -3712,18 +3704,18 @@ msgstr "" "En général, celle-ci contient les lignes du code source ; toutefois, les " "lignes lues à partir de l'entrée standard ne seront pas affichées." -#: ../src/Doc/tutorial/errors.rst:74 +#: tutorial/errors.rst:74 msgid "" ":ref:`bltin-exceptions` lists the built-in exceptions and their meanings." msgstr "" "Vous trouverez dans :ref:`bltin-exceptions` la liste des exceptions natives " "et leur signification." -#: ../src/Doc/tutorial/errors.rst:80 +#: tutorial/errors.rst:80 msgid "Handling Exceptions" msgstr "Gestion des exceptions" -#: ../src/Doc/tutorial/errors.rst:82 +#: tutorial/errors.rst:82 msgid "" "It is possible to write programs that handle selected exceptions. Look at " "the following example, which asks the user for input until a valid integer " @@ -3740,11 +3732,11 @@ msgstr "" "générée par l'utilisateur est signalée en levant l'exception :exc:" "`KeyboardInterrupt`." -#: ../src/Doc/tutorial/errors.rst:96 +#: tutorial/errors.rst:96 msgid "The :keyword:`try` statement works as follows." msgstr "L'instruction :keyword:`try` fonctionne comme ceci." -#: ../src/Doc/tutorial/errors.rst:98 +#: tutorial/errors.rst:98 msgid "" "First, the *try clause* (the statement(s) between the :keyword:`try` and :" "keyword:`except` keywords) is executed." @@ -3752,7 +3744,7 @@ msgstr "" "Premièrement, la *clause try* (instruction(s) placée(s) entre les mots-clés :" "keyword:`try` et :keyword:`except`) est exécutée." -#: ../src/Doc/tutorial/errors.rst:101 +#: tutorial/errors.rst:101 msgid "" "If no exception occurs, the *except clause* is skipped and execution of the :" "keyword:`try` statement is finished." @@ -3760,7 +3752,7 @@ msgstr "" "Si aucune exception n'intervient, la *clause except* est sautée et " "l'exécution de l'instruction :keyword:`try` est terminée." -#: ../src/Doc/tutorial/errors.rst:104 +#: tutorial/errors.rst:104 msgid "" "If an exception occurs during execution of the try clause, the rest of the " "clause is skipped. Then if its type matches the exception named after the :" @@ -3773,7 +3765,7 @@ msgstr "" "correspondante est exécutée, puis l'exécution continue après l'instruction :" "keyword:`try`." -#: ../src/Doc/tutorial/errors.rst:109 +#: tutorial/errors.rst:109 msgid "" "If an exception occurs which does not match the exception named in the " "except clause, it is passed on to outer :keyword:`try` statements; if no " @@ -3786,7 +3778,7 @@ msgstr "" "s'agit d'une *exception non gérée* et l'exécution s'arrête avec un message " "comme indiqué ci-dessus." -#: ../src/Doc/tutorial/errors.rst:114 +#: tutorial/errors.rst:114 msgid "" "A :keyword:`try` statement may have more than one except clause, to specify " "handlers for different exceptions. At most one handler will be executed. " @@ -3803,7 +3795,7 @@ msgstr "" "entre parenthèses, comme dans cet exemple ::" # 27502966a9b0494b8e62e5b731c29743 -#: ../src/Doc/tutorial/errors.rst:123 +#: tutorial/errors.rst:123 msgid "" "Note that the parentheses around this tuple are required, because ``except " "ValueError, e:`` was the syntax used for what is normally written as " @@ -3822,7 +3814,7 @@ msgstr "" "mais de ``except RuntimeError as TypeError:``, ce qui n'est pas ce que l'on " "souhaite." -#: ../src/Doc/tutorial/errors.rst:131 +#: tutorial/errors.rst:131 msgid "" "The last except clause may omit the exception name(s), to serve as a " "wildcard. Use this with extreme caution, since it is easy to mask a real " @@ -3837,7 +3829,7 @@ msgstr "" "de re-lever l'exception (en permettant à un appelant de prendre également en " "charge l'exception) ::" -#: ../src/Doc/tutorial/errors.rst:150 +#: tutorial/errors.rst:150 msgid "" "The :keyword:`try` ... :keyword:`except` statement has an optional *else " "clause*, which, when present, must follow all except clauses. It is useful " @@ -3849,7 +3841,7 @@ msgstr "" "clauses except. Elle est utile pour du code qui doit être exécuté " "lorsqu'aucune exception n'a été levée par la clause try. Par exemple ::" -#: ../src/Doc/tutorial/errors.rst:164 +#: tutorial/errors.rst:164 msgid "" "The use of the :keyword:`else` clause is better than adding additional code " "to the :keyword:`try` clause because it avoids accidentally catching an " @@ -3861,7 +3853,7 @@ msgstr "" "une exception qui n'a pas été levée par le code initialement protégé par " "l'instruction :keyword:`try` ... :keyword:`except`." -#: ../src/Doc/tutorial/errors.rst:169 +#: tutorial/errors.rst:169 msgid "" "When an exception occurs, it may have an associated value, also known as the " "exception's *argument*. The presence and type of the argument depend on the " @@ -3872,7 +3864,7 @@ msgstr "" "et son type dépendent du type de l'exception." # 3855bca41cb3406db419bd42ce816d50 -#: ../src/Doc/tutorial/errors.rst:173 +#: tutorial/errors.rst:173 msgid "" "The except clause may specify a variable after the exception name (or " "tuple). The variable is bound to an exception instance with the arguments " @@ -3888,7 +3880,7 @@ msgstr "" "``.args``." # 9bff2f04b9604cb88961036a1dd56433 -#: ../src/Doc/tutorial/errors.rst:179 +#: tutorial/errors.rst:179 msgid "" "One may also instantiate an exception first before raising it and add any " "attributes to it as desired. ::" @@ -3897,7 +3889,7 @@ msgstr "" "nécessaire avant de la déclencher ::" # 1f3feaf7ef4c4dc59fef2b8afae9b8a2 -#: ../src/Doc/tutorial/errors.rst:198 +#: tutorial/errors.rst:198 msgid "" "If an exception has an argument, it is printed as the last part ('detail') " "of the message for unhandled exceptions." @@ -3905,7 +3897,7 @@ msgstr "" "Si une exception a un argument, il est imprimé dans la dernière partie " "('detail') du message des exceptions non gérées." -#: ../src/Doc/tutorial/errors.rst:201 +#: tutorial/errors.rst:201 msgid "" "Exception handlers don't just handle exceptions if they occur immediately in " "the try clause, but also if they occur inside functions that are called " @@ -3916,11 +3908,11 @@ msgstr "" "levées au sein de fonctions appelées (parfois indirectement) dans la clause " "try. Par exemple ::" -#: ../src/Doc/tutorial/errors.rst:219 +#: tutorial/errors.rst:219 msgid "Raising Exceptions" msgstr "Déclencher des exceptions" -#: ../src/Doc/tutorial/errors.rst:221 +#: tutorial/errors.rst:221 msgid "" "The :keyword:`raise` statement allows the programmer to force a specified " "exception to occur. For example::" @@ -3928,7 +3920,7 @@ msgstr "" "L'instruction :keyword:`raise` permet au programmeur de déclencher une " "exception spécifique. Par exemple ::" -#: ../src/Doc/tutorial/errors.rst:229 +#: tutorial/errors.rst:229 msgid "" "The sole argument to :keyword:`raise` indicates the exception to be raised. " "This must be either an exception instance or an exception class (a class " @@ -3938,7 +3930,7 @@ msgstr "" "peut être soit une instance d'exception, soit une classe d'exception (une " "classe dérivée de :class:`Exception`)." -#: ../src/Doc/tutorial/errors.rst:233 +#: tutorial/errors.rst:233 msgid "" "If you need to determine whether an exception was raised but don't intend to " "handle it, a simpler form of the :keyword:`raise` statement allows you to re-" @@ -3948,11 +3940,11 @@ msgstr "" "prendre en charge, une forme plus simple de l'instruction :keyword:`raise` " "permet de re-déclencher l'exception ::" -#: ../src/Doc/tutorial/errors.rst:252 +#: tutorial/errors.rst:252 msgid "User-defined Exceptions" msgstr "Exceptions définies par l'utilisateur" -#: ../src/Doc/tutorial/errors.rst:254 +#: tutorial/errors.rst:254 msgid "" "Programs may name their own exceptions by creating a new exception class " "(see :ref:`tut-classes` for more about Python classes). Exceptions should " @@ -3964,7 +3956,7 @@ msgstr "" "exceptions doivent typiquement être dérivées de la classe :exc:`Exception`, " "directement ou indirectement. Par exemple ::" -#: ../src/Doc/tutorial/errors.rst:276 +#: tutorial/errors.rst:276 msgid "" "In this example, the default :meth:`__init__` of :class:`Exception` has been " "overridden. The new behavior simply creates the *value* attribute. This " @@ -3975,7 +3967,7 @@ msgstr "" "l'attribut *value*. Ceci remplace le comportement par défaut qui crée " "l'attribut *args*." -#: ../src/Doc/tutorial/errors.rst:280 +#: tutorial/errors.rst:280 msgid "" "Exception classes can be defined which do anything any other class can do, " "but are usually kept simple, often only offering a number of attributes that " @@ -3994,7 +3986,7 @@ msgstr "" "exceptions définies dans ce module, et de créer des sous-classes spécifiques " "d'exceptions pour les différentes conditions d'erreurs ::" -#: ../src/Doc/tutorial/errors.rst:318 +#: tutorial/errors.rst:318 msgid "" "Most exceptions are defined with names that end in \"Error,\" similar to the " "naming of the standard exceptions." @@ -4002,7 +3994,7 @@ msgstr "" "La plupart des exceptions sont définies avec des noms qui se terminent par " "\"Error\", comme pour les exceptions standards." -#: ../src/Doc/tutorial/errors.rst:321 +#: tutorial/errors.rst:321 msgid "" "Many standard modules define their own exceptions to report errors that may " "occur in functions they define. More information on classes is presented in " @@ -4013,11 +4005,11 @@ msgstr "" "définissent. Plus d'informations sur les classes sont présentées dans le " "chapitre :ref:`tut-classes`." -#: ../src/Doc/tutorial/errors.rst:329 +#: tutorial/errors.rst:329 msgid "Defining Clean-up Actions" msgstr "Définition d'actions de nettoyage" -#: ../src/Doc/tutorial/errors.rst:331 +#: tutorial/errors.rst:331 msgid "" "The :keyword:`try` statement has another optional clause which is intended " "to define clean-up actions that must be executed under all circumstances. " @@ -4028,7 +4020,7 @@ msgstr "" "circonstances. Par exemple ::" # c7f7bd06fdcb44f6af089f25280ca0e6 -#: ../src/Doc/tutorial/errors.rst:345 +#: tutorial/errors.rst:345 msgid "" "A *finally clause* is always executed before leaving the :keyword:`try` " "statement, whether an exception has occurred or not. When an exception has " @@ -4054,7 +4046,7 @@ msgstr "" "et :keyword:`finally` dans la même instruction :keyword:`try` nécessite au " "moins Python 2.5) ::" -#: ../src/Doc/tutorial/errors.rst:379 +#: tutorial/errors.rst:379 msgid "" "As you can see, the :keyword:`finally` clause is executed in any event. " "The :exc:`TypeError` raised by dividing two strings is not handled by the :" @@ -4067,7 +4059,7 @@ msgstr "" "`except` et est donc re-déclenchée après que la clause :keyword:`finally` " "ait été exécutée." -#: ../src/Doc/tutorial/errors.rst:384 +#: tutorial/errors.rst:384 msgid "" "In real world applications, the :keyword:`finally` clause is useful for " "releasing external resources (such as files or network connections), " @@ -4077,11 +4069,11 @@ msgstr "" "utile pour libérer des ressources externes (telles que des fichiers ou des " "connections réseau), que l'utilisation de ces ressources ait réussi ou non." -#: ../src/Doc/tutorial/errors.rst:392 +#: tutorial/errors.rst:392 msgid "Predefined Clean-up Actions" msgstr "Actions de nettoyage prédéfinies" -#: ../src/Doc/tutorial/errors.rst:394 +#: tutorial/errors.rst:394 msgid "" "Some objects define standard clean-up actions to be undertaken when the " "object is no longer needed, regardless of whether or not the operation using " @@ -4094,7 +4086,7 @@ msgstr "" "suivant, qui tente d'ouvrir un fichier et d'afficher son contenu à l'écran ::" # 3e128929b44e4ce8a471c6bfe6295a5d -#: ../src/Doc/tutorial/errors.rst:402 +#: tutorial/errors.rst:402 msgid "" "The problem with this code is that it leaves the file open for an " "indeterminate amount of time after the code has finished executing. This is " @@ -4111,7 +4103,7 @@ msgstr "" "nettoyés rapidement et correctement ::" # fa61bd22ee7f41deb8a86ef987c0432e -#: ../src/Doc/tutorial/errors.rst:412 +#: tutorial/errors.rst:412 msgid "" "After the statement is executed, the file *f* is always closed, even if a " "problem was encountered while processing the lines. Other objects which " @@ -4123,11 +4115,11 @@ msgstr "" "objets qui fournissent des actions de nettoyage prédéfinies l'indiquent dans " "leur documentation." -#: ../src/Doc/tutorial/floatingpoint.rst:5 +#: tutorial/floatingpoint.rst:5 msgid "Floating Point Arithmetic: Issues and Limitations" msgstr "Arithmétique en Nombre à Virgule Flottante : Problèmes et Limites" -#: ../src/Doc/tutorial/floatingpoint.rst:10 +#: tutorial/floatingpoint.rst:10 msgid "" "Floating-point numbers are represented in computer hardware as base 2 " "(binary) fractions. For example, the decimal fraction ::" @@ -4135,14 +4127,14 @@ msgstr "" "Les nombres à virgule flottante sont représentés, au niveau matériel, en " "fractions de nombres binaires (base 2). Par exemple, la fraction décimale ::" -#: ../src/Doc/tutorial/floatingpoint.rst:15 +#: tutorial/floatingpoint.rst:15 msgid "" "has value 1/10 + 2/100 + 5/1000, and in the same way the binary fraction ::" msgstr "" "a la valeur 1/10 + 2/100 + 5/1000, et de la même manière, la fraction " "binaire ::" -#: ../src/Doc/tutorial/floatingpoint.rst:19 +#: tutorial/floatingpoint.rst:19 msgid "" "has value 0/2 + 0/4 + 1/8. These two fractions have identical values, the " "only real difference being that the first is written in base 10 fractional " @@ -4152,7 +4144,7 @@ msgstr "" "seule différence est que la première est une fraction décimale, la seconde " "binaire." -#: ../src/Doc/tutorial/floatingpoint.rst:23 +#: tutorial/floatingpoint.rst:23 msgid "" "Unfortunately, most decimal fractions cannot be represented exactly as " "binary fractions. A consequence is that, in general, the decimal floating-" @@ -4164,7 +4156,7 @@ msgstr "" "nombres à virgule flottante que vous donnez sont seulement approximés en " "fraction binaire pour être stocké dans la machine." -#: ../src/Doc/tutorial/floatingpoint.rst:28 +#: tutorial/floatingpoint.rst:28 msgid "" "The problem is easier to understand at first in base 10. Consider the " "fraction 1/3. You can approximate that as a base 10 fraction::" @@ -4172,12 +4164,11 @@ msgstr "" "Le problème est plus simple à aborder en base 10. Prenons par exemple, la " "fraction 1/3. Vous pouvez l'approximer en une fraction décimale::" -#: ../src/Doc/tutorial/floatingpoint.rst:33 -#: ../src/Doc/tutorial/floatingpoint.rst:37 +#: tutorial/floatingpoint.rst:33 tutorial/floatingpoint.rst:37 msgid "or, better, ::" msgstr "ou, mieux, ::" -#: ../src/Doc/tutorial/floatingpoint.rst:41 +#: tutorial/floatingpoint.rst:41 msgid "" "and so on. No matter how many digits you're willing to write down, the " "result will never be exactly 1/3, but will be an increasingly better " @@ -4187,7 +4178,7 @@ msgstr "" "sera jamais exactement 1/3, mais une estimation s'en approchant toujours " "mieux." -#: ../src/Doc/tutorial/floatingpoint.rst:45 +#: tutorial/floatingpoint.rst:45 msgid "" "In the same way, no matter how many base 2 digits you're willing to use, the " "decimal value 0.1 cannot be represented exactly as a base 2 fraction. In " @@ -4198,14 +4189,14 @@ msgstr "" "fraction binaire. En base 2, 1/10 est le nombre périodique suivant ::" # 585f9afa498948edb520ddba73906b61 -#: ../src/Doc/tutorial/floatingpoint.rst:51 +#: tutorial/floatingpoint.rst:51 msgid "Stop at any finite number of bits, and you get an approximation." msgstr "" "Arrêtez à n'importe quelle quantité finie de bits, et vous obtiendez une " "approximation." # a3e931a40eb6454aaf8258fe6dcc2c2a -#: ../src/Doc/tutorial/floatingpoint.rst:53 +#: tutorial/floatingpoint.rst:53 msgid "" "On a typical machine running Python, there are 53 bits of precision " "available for a Python float, so the value stored internally when you enter " @@ -4216,12 +4207,12 @@ msgstr "" "nombre décimal ``0.1`` est la fraction binaire ::" # b19de5faee084120b720b24ac015d415 -#: ../src/Doc/tutorial/floatingpoint.rst:59 +#: tutorial/floatingpoint.rst:59 msgid "which is close to, but not exactly equal to, 1/10." msgstr "qui est proche, mais pas exactement égale, à 1/10." # 8933cbcb05124de785ee6c7fe3365adb -#: ../src/Doc/tutorial/floatingpoint.rst:61 +#: tutorial/floatingpoint.rst:61 msgid "" "It's easy to forget that the stored value is an approximation to the " "original decimal fraction, because of the way that floats are displayed at " @@ -4236,7 +4227,7 @@ msgstr "" "de la valeur stockée en binaire. Si Python devait afficher la vraie valeur " "décimale de l'approximation binaire stockée pour 0.1, il afficherait ::" -#: ../src/Doc/tutorial/floatingpoint.rst:71 +#: tutorial/floatingpoint.rst:71 msgid "" "That is more digits than most people find useful, so Python keeps the number " "of digits manageable by displaying a rounded value instead ::" @@ -4245,7 +4236,7 @@ msgstr "" "arrondie afin d'améliorer la lisibilité ::" # 5e4f51ce66ca42769953b535fc42cc18 -#: ../src/Doc/tutorial/floatingpoint.rst:77 +#: tutorial/floatingpoint.rst:77 msgid "" "It's important to realize that this is, in a real sense, an illusion: the " "value in the machine is not exactly 1/10, you're simply rounding the " @@ -4257,7 +4248,7 @@ msgstr "" "valeur stockée est arrondie. Ceci devient évident dès que vous effectuez des " "opérations arithmétiques avec ces valeurs ::" -#: ../src/Doc/tutorial/floatingpoint.rst:85 +#: tutorial/floatingpoint.rst:85 msgid "" "Note that this is in the very nature of binary floating-point: this is not a " "bug in Python, and it is not a bug in your code either. You'll see the same " @@ -4273,7 +4264,7 @@ msgstr "" "différence par défaut, ou pas dans tous les modes d'affichage)." # e5c2f7d498224bb3b5219ca6b49574e9 -#: ../src/Doc/tutorial/floatingpoint.rst:91 +#: tutorial/floatingpoint.rst:91 msgid "" "Other surprises follow from this one. For example, if you try to round the " "value 2.675 to two decimal places, you get this ::" @@ -4282,7 +4273,7 @@ msgstr "" "d'arrondir la valeur 2.675 à deux décimales, vous obtiendrez ::" # b6492664b1a14c72aa3e3152d4802419 -#: ../src/Doc/tutorial/floatingpoint.rst:97 +#: tutorial/floatingpoint.rst:97 msgid "" "The documentation for the built-in :func:`round` function says that it " "rounds to the nearest value, rounding ties away from zero. Since the " @@ -4300,7 +4291,7 @@ msgstr "" "est stockée par une approximation dont la valeur exacte est ::" # b6ad3e1f39374a2492515e10f77134d6 -#: ../src/Doc/tutorial/floatingpoint.rst:106 +#: tutorial/floatingpoint.rst:106 msgid "" "Since this approximation is slightly closer to 2.67 than to 2.68, it's " "rounded down." @@ -4309,7 +4300,7 @@ msgstr "" "l'arrondi se fait vers le bas." # 3683a07c343348568f95d1964fd2a7b7 -#: ../src/Doc/tutorial/floatingpoint.rst:109 +#: tutorial/floatingpoint.rst:109 msgid "" "If you're in a situation where you care which way your decimal halfway-cases " "are rounded, you should consider using the :mod:`decimal` module. " @@ -4322,7 +4313,7 @@ msgstr "" "pratique de \"voir\" la valeur exacte stockée pour n'importe quel flottant." # 41ea13ad53d44bb28b904415c1ea2417 -#: ../src/Doc/tutorial/floatingpoint.rst:118 +#: tutorial/floatingpoint.rst:118 msgid "" "Another consequence is that since 0.1 is not exactly 1/10, summing ten " "values of 0.1 may not yield exactly 1.0, either::" @@ -4330,7 +4321,7 @@ msgstr "" "Une autre conséquence du fait que 0.1 n'est pas exactement stocké 1/10 est " "que la somme de dix valeurs de 0.1 ne donne pas 1.0 non plus ::" -#: ../src/Doc/tutorial/floatingpoint.rst:128 +#: tutorial/floatingpoint.rst:128 msgid "" "Binary floating-point arithmetic holds many surprises like this. The " "problem with \"0.1\" is explained in precise detail below, in the " @@ -4345,7 +4336,7 @@ msgstr "" "complète de ce genre de surprises." # 87e3aaf0e7e2477fb17072c49a0e5058 -#: ../src/Doc/tutorial/floatingpoint.rst:133 +#: tutorial/floatingpoint.rst:133 msgid "" "As that says near the end, \"there are no easy answers.\" Still, don't be " "unduly wary of floating-point! The errors in Python float operations are " @@ -4365,7 +4356,7 @@ msgstr "" "souffrir d'une nouvelle erreur." # 0d5b6ba08bee41ae81e33306aca23343 -#: ../src/Doc/tutorial/floatingpoint.rst:140 +#: tutorial/floatingpoint.rst:140 msgid "" "While pathological cases do exist, for most casual use of floating-point " "arithmetic you'll see the result you expect in the end if you simply round " @@ -4380,11 +4371,11 @@ msgstr "" "dans :ref:`formatstrings` les spécifications de formattage de la méthode :" "meth:`str.format`" -#: ../src/Doc/tutorial/floatingpoint.rst:150 +#: tutorial/floatingpoint.rst:150 msgid "Representation Error" msgstr "Erreurs de représentation" -#: ../src/Doc/tutorial/floatingpoint.rst:152 +#: tutorial/floatingpoint.rst:152 msgid "" "This section explains the \"0.1\" example in detail, and shows how you can " "perform an exact analysis of cases like this yourself. Basic familiarity " @@ -4396,7 +4387,7 @@ msgstr "" "nombres flottants." # e9ea0a68b7bf4ca098eb417f0ed61ccb -#: ../src/Doc/tutorial/floatingpoint.rst:156 +#: tutorial/floatingpoint.rst:156 msgid "" ":dfn:`Representation error` refers to the fact that some (most, actually) " "decimal fractions cannot be represented exactly as binary (base 2) " @@ -4411,7 +4402,7 @@ msgstr "" "décimal::" # be0b2bc761654882a6612a05f3ceb463 -#: ../src/Doc/tutorial/floatingpoint.rst:164 +#: tutorial/floatingpoint.rst:164 msgid "" "Why is that? 1/10 and 2/10 are not exactly representable as a binary " "fraction. Almost all machines today (July 2010) use IEEE-754 floating point " @@ -4431,11 +4422,11 @@ msgstr "" "possible de la forme *J*/2**\\ *N* avec *J* un nombre entier d'exactement 53 " "bits. Réecrire ::" -#: ../src/Doc/tutorial/floatingpoint.rst:173 +#: tutorial/floatingpoint.rst:173 msgid "as ::" msgstr "en ::" -#: ../src/Doc/tutorial/floatingpoint.rst:177 +#: tutorial/floatingpoint.rst:177 msgid "" "and recalling that *J* has exactly 53 bits (is ``>= 2**52`` but ``< " "2**53``), the best value for *N* is 56::" @@ -4444,7 +4435,7 @@ msgstr "" "2**53``), la meilleur valeur possible pour *N* est 56::" # 2e98f1c2739a481cbe0243853a3217af -#: ../src/Doc/tutorial/floatingpoint.rst:187 +#: tutorial/floatingpoint.rst:187 msgid "" "That is, 56 is the only value for *N* that leaves *J* with exactly 53 bits. " "The best possible value for *J* is then that quotient rounded::" @@ -4453,7 +4444,7 @@ msgstr "" "pour *J*. La meilleure valeur possible pour *J* est donc ce quotient, " "arrondi::" -#: ../src/Doc/tutorial/floatingpoint.rst:194 +#: tutorial/floatingpoint.rst:194 msgid "" "Since the remainder is more than half of 10, the best approximation is " "obtained by rounding up::" @@ -4462,7 +4453,7 @@ msgstr "" "approximation est obtenue en arrondissant par le haut:" # 2e0305eb55864b539f378f91726a0131 -#: ../src/Doc/tutorial/floatingpoint.rst:200 +#: tutorial/floatingpoint.rst:200 msgid "" "Therefore the best possible approximation to 1/10 in 754 double precision is " "that over 2\\*\\*56, or ::" @@ -4470,7 +4461,7 @@ msgstr "" "Par conséquent la meilleure approximation possible pour 1/10 en \"IEEE-754 " "double precision\" est cette au desus de 2\\*\\*56, soit ::" -#: ../src/Doc/tutorial/floatingpoint.rst:205 +#: tutorial/floatingpoint.rst:205 msgid "" "Note that since we rounded up, this is actually a little bit larger than " "1/10; if we had not rounded up, the quotient would have been a little bit " @@ -4481,7 +4472,7 @@ msgstr "" "haut, le quotient aurait été légèrement plus petit que 1/10. Mais dans aucun " "cas il ne vaut *exactement* 1/10 !" -#: ../src/Doc/tutorial/floatingpoint.rst:209 +#: tutorial/floatingpoint.rst:209 msgid "" "So the computer never \"sees\" 1/10: what it sees is the exact fraction " "given above, the best 754 double approximation it can get::" @@ -4491,7 +4482,7 @@ msgstr "" "virgule flottante double précision de l'\"IEEE-754\"" # 387b544ab4cc483783898ef3a17eb2ff -#: ../src/Doc/tutorial/floatingpoint.rst:215 +#: tutorial/floatingpoint.rst:215 msgid "" "If we multiply that fraction by 10\\*\\*30, we can see the (truncated) value " "of its 30 most significant decimal digits::" @@ -4500,7 +4491,7 @@ msgstr "" "de ses 30 décimales de poid fort." # 956b2754e34c462ab54d636a54cbbda9 -#: ../src/Doc/tutorial/floatingpoint.rst:221 +#: tutorial/floatingpoint.rst:221 msgid "" "meaning that the exact number stored in the computer is approximately equal " "to the decimal value 0.100000000000000005551115123125. In versions prior to " @@ -4518,11 +4509,11 @@ msgstr "" "courte possible tout en redonnant exactement la même représentation une fois " "reconverti en binaire, affichant simplement '0.1'." -#: ../src/Doc/tutorial/index.rst:5 +#: tutorial/index.rst:5 msgid "The Python Tutorial" msgstr "Le tutoriel python" -#: ../src/Doc/tutorial/index.rst:7 +#: tutorial/index.rst:7 msgid "" "Python is an easy to learn, powerful programming language. It has efficient " "high-level data structures and a simple but effective approach to object-" @@ -4537,7 +4528,7 @@ msgstr "" "un langage idéal pour l'écriture de scripts et le développement rapide " "d'applications dans de nombreux domaines et sur de nombreuses plateformes." -#: ../src/Doc/tutorial/index.rst:13 +#: tutorial/index.rst:13 #, fuzzy msgid "" "The Python interpreter and the extensive standard library are freely " @@ -4553,7 +4544,7 @@ msgstr "" "des modules, des programmes et des outils tiers ainsi que vers de la " "documentation supplémentaire." -#: ../src/Doc/tutorial/index.rst:19 +#: tutorial/index.rst:19 msgid "" "The Python interpreter is easily extended with new functions and data types " "implemented in C or C++ (or other languages callable from C). Python is also " @@ -4564,7 +4555,7 @@ msgstr "" "depuis le C). Python est également adapté comme langage d'extension pour " "personnaliser des applications." -#: ../src/Doc/tutorial/index.rst:23 +#: tutorial/index.rst:23 msgid "" "This tutorial introduces the reader informally to the basic concepts and " "features of the Python language and system. It helps to have a Python " @@ -4577,7 +4568,7 @@ msgstr "" "cas pratiques. Les exemples étant indépendants, le tutoriel est adapté à une " "lecture hors ligne." -#: ../src/Doc/tutorial/index.rst:28 +#: tutorial/index.rst:28 msgid "" "For a description of standard objects and modules, see :ref:`library-" "index`. :ref:`reference-index` gives a more formal definition of the " @@ -4590,7 +4581,7 @@ msgstr "" "ref:`extending-index` et :ref:`c-api-index`. Des livres sont également " "disponibles qui couvrent Python dans le détail." -#: ../src/Doc/tutorial/index.rst:33 +#: tutorial/index.rst:33 msgid "" "This tutorial does not attempt to be comprehensive and cover every single " "feature, or even every commonly used feature. Instead, it introduces many of " @@ -4608,15 +4599,15 @@ msgstr "" "d'avantage sur les modules de la bibliothèque Python décrits dans :ref:" "`library-index`." -#: ../src/Doc/tutorial/index.rst:40 +#: tutorial/index.rst:40 msgid "The :ref:`glossary` is also worth going through." msgstr "Pensez aussi à consulter le :ref:`glossary`." -#: ../src/Doc/tutorial/inputoutput.rst:5 +#: tutorial/inputoutput.rst:5 msgid "Input and Output" msgstr "Les entrées/sorties" -#: ../src/Doc/tutorial/inputoutput.rst:7 +#: tutorial/inputoutput.rst:7 msgid "" "There are several ways to present the output of a program; data can be " "printed in a human-readable form, or written to a file for future use. This " @@ -4627,12 +4618,12 @@ msgstr "" "sauvegardées dans un fichier pour une utilisation future. Ce chapitre " "présentera donc diverses possibilités." -#: ../src/Doc/tutorial/inputoutput.rst:15 +#: tutorial/inputoutput.rst:15 msgid "Fancier Output Formatting" msgstr "Formatage de données" # 3028974fd106477a98b3edd53c6e934c -#: ../src/Doc/tutorial/inputoutput.rst:17 +#: tutorial/inputoutput.rst:17 msgid "" "So far we've encountered two ways of writing values: *expression statements* " "and the :keyword:`print` statement. (A third way is using the :meth:`write` " @@ -4647,7 +4638,7 @@ msgstr "" "en savoir plus.)" # 4f0a1c8e63414433ad1247d6a3397a54 -#: ../src/Doc/tutorial/inputoutput.rst:22 +#: tutorial/inputoutput.rst:22 msgid "" "Often you'll want more control over the formatting of your output than " "simply printing space-separated values. There are two ways to format your " @@ -4669,7 +4660,7 @@ msgstr "" "meth:`format`." # ca5251e779794352a357fb6d45e792c4 -#: ../src/Doc/tutorial/inputoutput.rst:30 +#: tutorial/inputoutput.rst:30 msgid "" "The :mod:`string` module contains a :class:`~string.Template` class which " "offers yet another way to substitute values into strings." @@ -4678,7 +4669,7 @@ msgstr "" "offre encore une autre façon de remplacer des valeurs au sein de chaînes de " "caractères." -#: ../src/Doc/tutorial/inputoutput.rst:33 +#: tutorial/inputoutput.rst:33 msgid "" "One question remains, of course: how do you convert values to strings? " "Luckily, Python has ways to convert any value to a string: pass it to the :" @@ -4690,7 +4681,7 @@ msgstr "" "func:`str`." # 588f2644f358422b905e034d7e0ef059 -#: ../src/Doc/tutorial/inputoutput.rst:37 +#: tutorial/inputoutput.rst:37 msgid "" "The :func:`str` function is meant to return representations of values which " "are fairly human-readable, while :func:`repr` is meant to generate " @@ -4713,17 +4704,16 @@ msgstr "" "deux fonctions. Les chaînes de caractères et les nombres à virgule " "flottante, en revanche, ont deux représentations distinctes." -#: ../src/Doc/tutorial/inputoutput.rst:46 -#: ../src/Doc/tutorial/introduction.rst:22 +#: tutorial/inputoutput.rst:46 tutorial/introduction.rst:22 msgid "Some examples::" msgstr "Quelques exemples ::" -#: ../src/Doc/tutorial/inputoutput.rst:71 +#: tutorial/inputoutput.rst:71 msgid "Here are two ways to write a table of squares and cubes::" msgstr "Voici deux façons d'écrire une table de carrés et de cubes ::" # 0c685c72e1ab4135b590a4b3a75395dc -#: ../src/Doc/tutorial/inputoutput.rst:103 +#: tutorial/inputoutput.rst:103 msgid "" "(Note that in the first example, one space between each column was added by " "the way :keyword:`print` works: it always adds spaces between its arguments.)" @@ -4733,7 +4723,7 @@ msgstr "" "des espaces entre ses arguments.)" # e9c272eb28c244f19113ee5315437b51 -#: ../src/Doc/tutorial/inputoutput.rst:106 +#: tutorial/inputoutput.rst:106 msgid "" "This example demonstrates the :meth:`str.rjust` method of string objects, " "which right-justifies a string in a field of a given width by padding it " @@ -4757,7 +4747,7 @@ msgstr "" "toujours utiliser une tranche, comme dans ``x.ljust(n)[:n]``)." # 89a84b85112846d4b95a173d0f535c99 -#: ../src/Doc/tutorial/inputoutput.rst:116 +#: tutorial/inputoutput.rst:116 msgid "" "There is another method, :meth:`str.zfill`, which pads a numeric string on " "the left with zeros. It understands about plus and minus signs::" @@ -4765,13 +4755,13 @@ msgstr "" "Il existe une autre méthode, :meth:`str.zfill`, qui comble une chaîne " "numérique à gauche avec des zéros. Elle comprend les signes plus et moins ::" -#: ../src/Doc/tutorial/inputoutput.rst:126 +#: tutorial/inputoutput.rst:126 msgid "Basic usage of the :meth:`str.format` method looks like this::" msgstr "" "L'utilisation de base de la méthode :meth:`str.format` ressemble à cela ::" # 1e61c1b7493e41ea8ba7032cf978617c -#: ../src/Doc/tutorial/inputoutput.rst:131 +#: tutorial/inputoutput.rst:131 msgid "" "The brackets and characters within them (called format fields) are replaced " "with the objects passed into the :meth:`str.format` method. A number in the " @@ -4784,7 +4774,7 @@ msgstr "" "l'objet passé à la méthode :meth:`str.format` ::" # 8aeeda4a340947aa83e9ec64db9a40f2 -#: ../src/Doc/tutorial/inputoutput.rst:141 +#: tutorial/inputoutput.rst:141 msgid "" "If keyword arguments are used in the :meth:`str.format` method, their values " "are referred to by using the name of the argument. ::" @@ -4792,13 +4782,13 @@ msgstr "" "Si des arguments nommés sont utilisés dans la méthode :meth:`str.format`, " "leurs valeurs sont utilisées en se basant sur le nom des arguments ::" -#: ../src/Doc/tutorial/inputoutput.rst:148 +#: tutorial/inputoutput.rst:148 msgid "Positional and keyword arguments can be arbitrarily combined::" msgstr "" "Les arguments positionnés et nommés peuvent être combinés arbitrairement ::" # d68785b3547d4ceea462a3cf386fdf0b -#: ../src/Doc/tutorial/inputoutput.rst:154 +#: tutorial/inputoutput.rst:154 msgid "" "``'!s'`` (apply :func:`str`) and ``'!r'`` (apply :func:`repr`) can be used " "to convert the value before it is formatted. ::" @@ -4807,7 +4797,7 @@ msgstr "" "peuvent être utilisées pour convertir les valeurs avant leur formatage ::" # 5aaef826c29848228e82d92b68e3ed8c -#: ../src/Doc/tutorial/inputoutput.rst:163 +#: tutorial/inputoutput.rst:163 msgid "" "An optional ``':'`` and format specifier can follow the field name. This " "allows greater control over how the value is formatted. The following " @@ -4818,7 +4808,7 @@ msgstr "" "façon dont les valeurs sont formatées. L'exemple suivant arrondit Pi à trois " "décimales ::" -#: ../src/Doc/tutorial/inputoutput.rst:171 +#: tutorial/inputoutput.rst:171 msgid "" "Passing an integer after the ``':'`` will cause that field to be a minimum " "number of characters wide. This is useful for making tables pretty. ::" @@ -4826,7 +4816,7 @@ msgstr "" "Indiquer un entier après le ``':'`` indique la largeur minimale de ce champ " "en nombre de caractères. C'est utile pour faire de jolis tableaux ::" -#: ../src/Doc/tutorial/inputoutput.rst:182 +#: tutorial/inputoutput.rst:182 msgid "" "If you have a really long format string that you don't want to split up, it " "would be nice if you could reference the variables to be formatted by name " @@ -4839,7 +4829,7 @@ msgstr "" "passant un dictionnaire et en utilisant des crochets ``'[]'`` pour accéder " "aux clés ::" -#: ../src/Doc/tutorial/inputoutput.rst:192 +#: tutorial/inputoutput.rst:192 msgid "" "This could also be done by passing the table as keyword arguments with the " "'**' notation. ::" @@ -4848,7 +4838,7 @@ msgstr "" "nommés en utilisant la notation '**' ::" # c99b63c3b0fd4e268a3c7987e17a775c -#: ../src/Doc/tutorial/inputoutput.rst:199 +#: tutorial/inputoutput.rst:199 msgid "" "This is particularly useful in combination with the built-in function :func:" "`vars`, which returns a dictionary containing all local variables." @@ -4856,7 +4846,7 @@ msgstr "" "C'est particulièrement utile en combinaison avec la fonction native :func:" "`vars`, qui retourne un dictionnaire contenant toutes les variables locales." -#: ../src/Doc/tutorial/inputoutput.rst:202 +#: tutorial/inputoutput.rst:202 msgid "" "For a complete overview of string formatting with :meth:`str.format`, see :" "ref:`formatstrings`." @@ -4864,12 +4854,12 @@ msgstr "" "Pour avoir une vue complète du formatage des chaînes de caractères avec la " "méthode :meth:`str.format`, voyez : :ref:`formatstrings`." -#: ../src/Doc/tutorial/inputoutput.rst:207 +#: tutorial/inputoutput.rst:207 msgid "Old string formatting" msgstr "Anciennes méthodes de formatage de chaînes" # 5f6042e30fbb4813bd0d41dcf6ef2022 -#: ../src/Doc/tutorial/inputoutput.rst:209 +#: tutorial/inputoutput.rst:209 msgid "" "The ``%`` operator can also be used for string formatting. It interprets the " "left argument much like a :c:func:`sprintf`\\ -style format string to be " @@ -4882,16 +4872,16 @@ msgstr "" "la chaîne résultant de cette opération de formatage. Par exemple ::" # a470a92caf504e9e9abdf08789ab9890 -#: ../src/Doc/tutorial/inputoutput.rst:218 +#: tutorial/inputoutput.rst:218 msgid "More information can be found in the :ref:`string-formatting` section." msgstr "" "Vous trouverez plus d'informations dans la section :ref:`string-formatting`." -#: ../src/Doc/tutorial/inputoutput.rst:224 +#: tutorial/inputoutput.rst:224 msgid "Reading and Writing Files" msgstr "Lecture et écriture de fichiers" -#: ../src/Doc/tutorial/inputoutput.rst:230 +#: tutorial/inputoutput.rst:230 msgid "" ":func:`open` returns a file object, and is most commonly used with two " "arguments: ``open(filename, mode)``." @@ -4899,7 +4889,7 @@ msgstr "" ":func:`open` retourne un objet fichier, et est le plus souvent utilisé avec " "deux arguments : ``open(filename, mode)``." -#: ../src/Doc/tutorial/inputoutput.rst:239 +#: tutorial/inputoutput.rst:239 msgid "" "The first argument is a string containing the filename. The second argument " "is another string containing a few characters describing the way in which " @@ -4920,7 +4910,7 @@ msgstr "" "écriture. L'argument *mode* est optionnel ; sa valeur par défaut est ``'r'``." # 9ff01378e50d4134a460523dad57e264 -#: ../src/Doc/tutorial/inputoutput.rst:248 +#: tutorial/inputoutput.rst:248 msgid "" "On Windows, ``'b'`` appended to the mode opens the file in binary mode, so " "there are also modes like ``'rb'``, ``'wb'``, and ``'r+b'``. Python on " @@ -4946,11 +4936,11 @@ msgstr "" "pouvez l'utiliser pour tous les fichiers binaires pour que votre code soit " "indépendant de la plate-forme." -#: ../src/Doc/tutorial/inputoutput.rst:262 +#: tutorial/inputoutput.rst:262 msgid "Methods of File Objects" msgstr "Méthodes des objets fichiers" -#: ../src/Doc/tutorial/inputoutput.rst:264 +#: tutorial/inputoutput.rst:264 msgid "" "The rest of the examples in this section will assume that a file object " "called ``f`` has already been created." @@ -4959,7 +4949,7 @@ msgstr "" "appelé ``f`` a déjà été créé." # 2a8f9b43ebde48819bcb8e6362c55669 -#: ../src/Doc/tutorial/inputoutput.rst:267 +#: tutorial/inputoutput.rst:267 msgid "" "To read a file's contents, call ``f.read(size)``, which reads some quantity " "of data and returns it as a string. *size* is an optional numeric " @@ -4978,7 +4968,7 @@ msgstr "" "du fichier est atteinte, ``f.read()`` renvoie une chaîne vide (``\"\"``) ::" # 1e6e90d979e44728babc12e0982b6fc4 -#: ../src/Doc/tutorial/inputoutput.rst:280 +#: tutorial/inputoutput.rst:280 msgid "" "``f.readline()`` reads a single line from the file; a newline character (``" "\\n``) is left at the end of the string, and is only omitted on the last " @@ -4995,7 +4985,7 @@ msgstr "" "atteinte, alors qu'une ligne vide est représentée par ``'\\n'``, une chaîne " "de caractères ne contenant qu'une fin de ligne ::" -#: ../src/Doc/tutorial/inputoutput.rst:294 +#: tutorial/inputoutput.rst:294 #, fuzzy msgid "" "For reading lines from a file, you can loop over the file object. This is " @@ -5006,7 +4996,7 @@ msgstr "" "donne un code plus simple ::" # c9d2cb570f624080832cb1c22091174a -#: ../src/Doc/tutorial/inputoutput.rst:303 +#: tutorial/inputoutput.rst:303 msgid "" "If you want to read all the lines of a file in a list you can also use " "``list(f)`` or ``f.readlines()``." @@ -5015,7 +5005,7 @@ msgstr "" "``list(f)`` ou ``f.readlines()``." # 0ead0c7ac8ca40f7bb963339561c47e9 -#: ../src/Doc/tutorial/inputoutput.rst:306 +#: tutorial/inputoutput.rst:306 msgid "" "``f.write(string)`` writes the contents of *string* to the file, returning " "``None``. ::" @@ -5023,7 +5013,7 @@ msgstr "" "``f.write(string)`` écrit le contenu de *string* dans le fichier, et renvoie " "``None`` ::" -#: ../src/Doc/tutorial/inputoutput.rst:311 +#: tutorial/inputoutput.rst:311 msgid "" "To write something other than a string, it needs to be converted to a string " "first::" @@ -5031,7 +5021,7 @@ msgstr "" "Pour écrire autre chose qu'une chaîne, il faut commencer par la convertir en " "chaîne ::" -#: ../src/Doc/tutorial/inputoutput.rst:318 +#: tutorial/inputoutput.rst:318 msgid "" "``f.tell()`` returns an integer giving the file object's current position in " "the file, measured in bytes from the beginning of the file. To change the " @@ -5051,7 +5041,7 @@ msgstr "" "*from_what* peut être omis et sa valeur par défaut est 0, utilisant le début " "du fichier comme point de référence ::" -#: ../src/Doc/tutorial/inputoutput.rst:336 +#: tutorial/inputoutput.rst:336 msgid "" "When you're done with a file, call ``f.close()`` to close it and free up any " "system resources taken up by the open file. After calling ``f.close()``, " @@ -5062,7 +5052,7 @@ msgstr "" "l'appel de ``f.close()``, toute tentative d'utilisation de l'objet fichier " "échouera systématiquement ::" -#: ../src/Doc/tutorial/inputoutput.rst:346 +#: tutorial/inputoutput.rst:346 msgid "" "It is good practice to use the :keyword:`with` keyword when dealing with " "file objects. This has the advantage that the file is properly closed after " @@ -5076,7 +5066,7 @@ msgstr "" "beaucoup plus court que d'utiliser l'équivalent avec des blocs :keyword:`try`" "\\ - \\ :keyword:`finally` ::" -#: ../src/Doc/tutorial/inputoutput.rst:356 +#: tutorial/inputoutput.rst:356 msgid "" "File objects have some additional methods, such as :meth:`~file.isatty` and :" "meth:`~file.truncate` which are less frequently used; consult the Library " @@ -5088,11 +5078,11 @@ msgstr "" "complet des objets fichiers." # c0fc908435b34686b8e3d1c331dca304 -#: ../src/Doc/tutorial/inputoutput.rst:364 +#: tutorial/inputoutput.rst:364 msgid "Saving structured data with :mod:`json`" msgstr "Sauvegarder des données structurées avec le module :mod:`json`" -#: ../src/Doc/tutorial/inputoutput.rst:368 +#: tutorial/inputoutput.rst:368 #, fuzzy msgid "" "Strings can easily be written to and read from a file. Numbers take a bit " @@ -5110,7 +5100,7 @@ msgstr "" "des types de données plus complexes comme des listes, des dictionnaires ou " "des instances de classes, les choses se compliquent beaucoup plus." -#: ../src/Doc/tutorial/inputoutput.rst:375 +#: tutorial/inputoutput.rst:375 #, fuzzy msgid "" "Rather than having users constantly writing and debugging code to save " @@ -5135,7 +5125,7 @@ msgstr "" "une machine distante." # e1b89b3bc75f412c8dd35d6ef0fa5bc0 -#: ../src/Doc/tutorial/inputoutput.rst:386 +#: tutorial/inputoutput.rst:386 msgid "" "The JSON format is commonly used by modern applications to allow for data " "exchange. Many programmers are already familiar with it, which makes it a " @@ -5145,7 +5135,7 @@ msgstr "" "échanger des données. Beaucoup de développeurs sont déjà familier avec le " "JSON, en faisant un format de prédilection pour l'interopérabilité." -#: ../src/Doc/tutorial/inputoutput.rst:390 +#: tutorial/inputoutput.rst:390 #, fuzzy msgid "" "If you have an object ``x``, you can view its JSON string representation " @@ -5156,7 +5146,7 @@ msgstr "" "de code ::" # 1f4e44bb05df474ba9c35c7674143147 -#: ../src/Doc/tutorial/inputoutput.rst:396 +#: tutorial/inputoutput.rst:396 #, fuzzy msgid "" "Another variant of the :func:`~json.dumps` function, called :func:`~json." @@ -5167,7 +5157,7 @@ msgstr "" "sérialise simplement l'objet donné vers un fichier. Donc si ``f`` est un :" "term:`fichier texte` ouvert en écriture, il devient possible de faire ::" -#: ../src/Doc/tutorial/inputoutput.rst:402 +#: tutorial/inputoutput.rst:402 #, fuzzy msgid "" "To decode the object again, if ``f`` is a :term:`file object` which has been " @@ -5177,7 +5167,7 @@ msgstr "" "en lecture ::" # 334875c8946c46c6b368aa91dfaab56a -#: ../src/Doc/tutorial/inputoutput.rst:407 +#: tutorial/inputoutput.rst:407 msgid "" "This simple serialization technique can handle lists and dictionaries, but " "serializing arbitrary class instances in JSON requires a bit of extra " @@ -5189,13 +5179,13 @@ msgstr "" "plus de travail. La documentation du module :mod:`json` explique comment " "faire." -#: ../src/Doc/tutorial/inputoutput.rst:413 +#: tutorial/inputoutput.rst:413 #, fuzzy msgid ":mod:`pickle` - the pickle module" msgstr "Le module :mod:`pickle`" # cb6f98c360cb46e4af9277ca15e4db4b -#: ../src/Doc/tutorial/inputoutput.rst:415 +#: tutorial/inputoutput.rst:415 msgid "" "Contrary to :ref:`JSON <tut-json>`, *pickle* is a protocol which allows the " "serialization of arbitrarily complex Python objects. As such, it is " @@ -5211,11 +5201,11 @@ msgstr "" "format pickle provenant d'une source malveillante et particulièrement habile " "pourrait mener exécuter du code arbitraire." -#: ../src/Doc/tutorial/interactive.rst:5 +#: tutorial/interactive.rst:5 msgid "Interactive Input Editing and History Substitution" msgstr "Édition interactive des entrées et substitution d'historique" -#: ../src/Doc/tutorial/interactive.rst:7 +#: tutorial/interactive.rst:7 msgid "" "Some versions of the Python interpreter support editing of the current input " "line and history substitution, similar to facilities found in the Korn shell " @@ -5235,7 +5225,7 @@ msgstr "" "décrits ici sont disponibles en option sous les versions Unix et Cygwin de " "l'interpréteur." -#: ../src/Doc/tutorial/interactive.rst:15 +#: tutorial/interactive.rst:15 msgid "" "This chapter does *not* document the editing facilities of Mark Hammond's " "PythonWin package or the Tk-based environment, IDLE, distributed with " @@ -5248,11 +5238,11 @@ msgstr "" "des fenêtres DOS sous NT ou d'autres variétés de Windows est encore une " "autre histoire." -#: ../src/Doc/tutorial/interactive.rst:24 +#: tutorial/interactive.rst:24 msgid "Line Editing" msgstr "Édition de ligne" -#: ../src/Doc/tutorial/interactive.rst:26 +#: tutorial/interactive.rst:26 msgid "" "If supported, input line editing is active whenever the interpreter prints a " "primary or secondary prompt. The current line can be edited using the " @@ -5277,11 +5267,11 @@ msgstr "" "tiret bas` annule la dernière modification ; cette commande peut être " "répétée pour cumuler ses effets." -#: ../src/Doc/tutorial/interactive.rst:41 +#: tutorial/interactive.rst:41 msgid "History Substitution" msgstr "Substitution d'historique" -#: ../src/Doc/tutorial/interactive.rst:43 +#: tutorial/interactive.rst:43 msgid "" "History substitution works as follows. All non-empty input lines issued are " "saved in a history buffer, and when a new prompt is given you are positioned " @@ -5302,11 +5292,11 @@ msgstr "" "envoie la ligne en cours à l'interpréteur. :kbd:`C-R` démarre une recherche " "incrémentale en arrière ; :kbd:`C-S` démarre une recherche en avant." -#: ../src/Doc/tutorial/interactive.rst:56 +#: tutorial/interactive.rst:56 msgid "Key Bindings" msgstr "Raccourcis clavier" -#: ../src/Doc/tutorial/interactive.rst:58 +#: tutorial/interactive.rst:58 msgid "" "The key bindings and some other parameters of the Readline library can be " "customized by placing commands in an initialization file called :file:`~/." @@ -5317,19 +5307,19 @@ msgstr "" "fichier d'initialisation appelé :file:`~/.inputrc`. Les raccourcis sont de " "la forme ::" -#: ../src/Doc/tutorial/interactive.rst:64 +#: tutorial/interactive.rst:64 msgid "or ::" msgstr "ou ::" -#: ../src/Doc/tutorial/interactive.rst:68 +#: tutorial/interactive.rst:68 msgid "and options can be set with ::" msgstr "et les options peuvent être définies avec ::" -#: ../src/Doc/tutorial/interactive.rst:72 +#: tutorial/interactive.rst:72 msgid "For example::" msgstr "Par exemple ::" -#: ../src/Doc/tutorial/interactive.rst:85 +#: tutorial/interactive.rst:85 msgid "" "Note that the default binding for :kbd:`Tab` in Python is to insert a :kbd:" "`Tab` character instead of Readline's default filename completion function. " @@ -5340,7 +5330,7 @@ msgstr "" "complétion des noms de fichiers de la bibliothèque Readline. Si vous y " "tenez, vous pouvez surcharger ce comportement en indiquant ::" -#: ../src/Doc/tutorial/interactive.rst:91 +#: tutorial/interactive.rst:91 msgid "" "in your :file:`~/.inputrc`. (Of course, this makes it harder to type " "indented continuation lines if you're accustomed to using :kbd:`Tab` for " @@ -5350,7 +5340,7 @@ msgstr "" "difficile d'entrer des lignes de continuation indentées si vous êtes habitué " "à utiliser :kbd:`Tab` dans ce but)." -#: ../src/Doc/tutorial/interactive.rst:98 +#: tutorial/interactive.rst:98 msgid "" "Automatic completion of variable and module names is optionally available. " "To enable it in the interpreter's interactive mode, add the following to " @@ -5361,7 +5351,7 @@ msgstr "" "l'interpréteur, ajoutez les lignes suivantes à votre fichier de démarrage : " "[#]_ ::" -#: ../src/Doc/tutorial/interactive.rst:105 +#: tutorial/interactive.rst:105 msgid "" "This binds the :kbd:`Tab` key to the completion function, so hitting the :" "kbd:`Tab` key twice suggests completions; it looks at Python statement " @@ -5381,7 +5371,7 @@ msgstr "" "partie du code de l'application si un objet disposant d'une méthode :meth:" "`__getattr__` fait partie de l'expression." -#: ../src/Doc/tutorial/interactive.rst:113 +#: tutorial/interactive.rst:113 msgid "" "A more capable startup file might look like this example. Note that this " "deletes the names it creates once they are no longer needed; this is done " @@ -5400,11 +5390,11 @@ msgstr "" "que :mod:`os`, qui s'avère nécessaire dans la plupart des sessions avec " "l'interpréteur." -#: ../src/Doc/tutorial/interactive.rst:149 +#: tutorial/interactive.rst:149 msgid "Alternatives to the Interactive Interpreter" msgstr "Alternatives à l'interpréteur interactif" -#: ../src/Doc/tutorial/interactive.rst:151 +#: tutorial/interactive.rst:151 msgid "" "This facility is an enormous step forward compared to earlier versions of " "the interpreter; however, some wishes are left: It would be nice if the " @@ -5422,7 +5412,7 @@ msgstr "" "correspondances de parenthèses, de guillemets..., serait également utile." # fe2adb8ab2894fa58e38a0a9e9e22c21 -#: ../src/Doc/tutorial/interactive.rst:158 +#: tutorial/interactive.rst:158 msgid "" "One alternative enhanced interactive interpreter that has been around for " "quite some time is IPython_, which features tab completion, object " @@ -5438,7 +5428,7 @@ msgstr "" "bpython_." # 4e8a30bcc9b34e4e8be51474820e2db6 -#: ../src/Doc/tutorial/interactive.rst:167 +#: tutorial/interactive.rst:167 msgid "" "Python will execute the contents of a file identified by the :envvar:" "`PYTHONSTARTUP` environment variable when you start an interactive " @@ -5450,16 +5440,16 @@ msgstr "" "interpréteur interactif. Pour personnaliser Python y compris en mode non " "interactif, consultez :ref:`tut-customize`." -#: ../src/Doc/tutorial/interpreter.rst:5 +#: tutorial/interpreter.rst:5 msgid "Using the Python Interpreter" msgstr "Utiliser l'interpréteur Python" -#: ../src/Doc/tutorial/interpreter.rst:11 +#: tutorial/interpreter.rst:11 msgid "Invoking the Interpreter" msgstr "Invoquer l'interpréteur" # 1fe8d6c4d9b34bf591bf05002c64109c -#: ../src/Doc/tutorial/interpreter.rst:13 +#: tutorial/interpreter.rst:13 msgid "" "The Python interpreter is usually installed as :file:`/usr/local/bin/python` " "on those machines where it is available; putting :file:`/usr/local/bin` in " @@ -5472,7 +5462,7 @@ msgstr "" "lancer l'interpréteur Python en tapant la commande ::" # e074012e6a55498fad926d939d5ce0f7 -#: ../src/Doc/tutorial/interpreter.rst:19 +#: tutorial/interpreter.rst:19 msgid "" "to the shell. Since the choice of the directory where the interpreter lives " "is an installation option, other places are possible; check with your local " @@ -5485,7 +5475,7 @@ msgstr "" "local/python` est une localisation courante.)" # 9d462e2928f341308d62bcd4963089f4 -#: ../src/Doc/tutorial/interpreter.rst:24 +#: tutorial/interpreter.rst:24 msgid "" "On Windows machines, the Python installation is usually placed in :file:`C:\\" "\\Python27`, though you can change this when you're running the installer. " @@ -5498,7 +5488,7 @@ msgstr "" "recherche, vous pouvez taper la commande suivante dans votre émulateur de " "terminal DOS ::" -#: ../src/Doc/tutorial/interpreter.rst:31 +#: tutorial/interpreter.rst:31 msgid "" "Typing an end-of-file character (:kbd:`Control-D` on Unix, :kbd:`Control-Z` " "on Windows) at the primary prompt causes the interpreter to exit with a zero " @@ -5510,14 +5500,15 @@ msgstr "" "de l'interpréteur avec un statut d'erreur nul. Si cela ne fonctionne pas, " "vous pouvez fermer l'interpréteur en tapant la commande ``quit()``." -#: ../src/Doc/tutorial/interpreter.rst:36 +#: tutorial/interpreter.rst:36 +#, fuzzy msgid "" "The interpreter's line-editing features usually aren't very sophisticated. " "On Unix, whoever installed the interpreter may have enabled support for the " "GNU readline library, which adds more elaborate interactive editing and " "history features. Perhaps the quickest check to see whether command line " -"editing is supported is typing Control-P to the first Python prompt you " -"get. If it beeps, you have command line editing; see Appendix :ref:`tut-" +"editing is supported is typing :kbd:`Control-P` to the first Python prompt " +"you get. If it beeps, you have command line editing; see Appendix :ref:`tut-" "interacting` for an introduction to the keys. If nothing appears to happen, " "or if ``^P`` is echoed, command line editing isn't available; you'll only be " "able to use backspace to remove characters from the current line." @@ -5535,7 +5526,7 @@ msgstr "" "vous serez seulement en mesure d'utiliser la touche retour arrière pour " "supprimer des caractères de la ligne courante." -#: ../src/Doc/tutorial/interpreter.rst:46 +#: tutorial/interpreter.rst:46 msgid "" "The interpreter operates somewhat like the Unix shell: when called with " "standard input connected to a tty device, it reads and executes commands " @@ -5548,7 +5539,7 @@ msgstr "" "fichier en argument ou avec un fichier comme entrée standard, il lit et " "exécute un *script* depuis ce fichier." -#: ../src/Doc/tutorial/interpreter.rst:51 +#: tutorial/interpreter.rst:51 msgid "" "A second way of starting the interpreter is ``python -c command [arg] ...``, " "which executes the statement(s) in *command*, analogous to the shell's :" @@ -5563,7 +5554,7 @@ msgstr "" "shell, il est généralement conseillé de mettre *commande* entre guillemets " "simples." -#: ../src/Doc/tutorial/interpreter.rst:57 +#: tutorial/interpreter.rst:57 msgid "" "Some Python modules are also useful as scripts. These can be invoked using " "``python -m module [arg] ...``, which executes the source file for *module* " @@ -5575,7 +5566,7 @@ msgstr "" "commande." # 3cbdf83437db4943ba9c24f111feb698 -#: ../src/Doc/tutorial/interpreter.rst:61 +#: tutorial/interpreter.rst:61 msgid "" "When a script file is used, it is sometimes useful to be able to run the " "script and enter interactive mode afterwards. This can be done by passing :" @@ -5585,12 +5576,16 @@ msgstr "" "lancer le script puis d'entrer dans le mode interactif après coup. Cela est " "possible en passant :option:`-i` avant le script." -#: ../src/Doc/tutorial/interpreter.rst:69 +#: tutorial/interpreter.rst:65 +msgid "All command-line options are described in :ref:`using-on-general`." +msgstr "" + +#: tutorial/interpreter.rst:71 msgid "Argument Passing" msgstr "Passage d'arguments" # cf63c591cb9a4616a61a495bd06cf8af -#: ../src/Doc/tutorial/interpreter.rst:71 +#: tutorial/interpreter.rst:73 msgid "" "When known to the interpreter, the script name and additional arguments " "thereafter are turned into a list of strings and assigned to the ``argv`` " @@ -5618,7 +5613,7 @@ msgstr "" "comme options de l'interpréteur Python mais laissées dans ``sys.argv`` pour " "être utilisée par le module ou la commande." -#: ../src/Doc/tutorial/interpreter.rst:89 +#: tutorial/interpreter.rst:91 msgid "" "When commands are read from a tty, the interpreter is said to be in " "*interactive mode*. In this mode it prompts for the next command with the " @@ -5636,7 +5631,7 @@ msgstr "" "version et une mention de *copyright* avant d'afficher le premier invite de " "commande ::" -#: ../src/Doc/tutorial/interpreter.rst:101 +#: tutorial/interpreter.rst:103 msgid "" "Continuation lines are needed when entering a multi-line construct. As an " "example, take a look at this :keyword:`if` statement::" @@ -5645,21 +5640,21 @@ msgstr "" "multi-lignes. Par exemple, regardez cette instruction :keyword:`if` ::" # 1d814a4f499e49cd906e688ac4990345 -#: ../src/Doc/tutorial/interpreter.rst:111 +#: tutorial/interpreter.rst:113 msgid "For more on interactive mode, see :ref:`tut-interac`." msgstr "" "Pour plus d'informations sur le mode interactif, voir :ref:`tut-interac`." -#: ../src/Doc/tutorial/interpreter.rst:117 +#: tutorial/interpreter.rst:119 msgid "The Interpreter and Its Environment" msgstr "L'interpréteur et son environnement" -#: ../src/Doc/tutorial/interpreter.rst:123 +#: tutorial/interpreter.rst:125 msgid "Source Code Encoding" msgstr "Encodage du code source" # 5b068a5d06ac42b8bf82ceb101a1e483 -#: ../src/Doc/tutorial/interpreter.rst:125 +#: tutorial/interpreter.rst:127 msgid "" "It is possible to use encodings different than ASCII in Python source files. " "The best way to do it is to put one more special comment line right after " @@ -5671,7 +5666,7 @@ msgstr "" "fichier source::" # 168d80cdf66a411d9af2e4d90f8b5fdf -#: ../src/Doc/tutorial/interpreter.rst:132 +#: tutorial/interpreter.rst:134 msgid "" "With that declaration, all characters in the source file will be treated as " "having the encoding *encoding*, and it will be possible to directly write " @@ -5686,13 +5681,13 @@ msgstr "" "bibliothèque Python dans la partie à propos de :mod:`codecs`." # 136855779690415a8c5aac7ceb545218 -#: ../src/Doc/tutorial/interpreter.rst:138 +#: tutorial/interpreter.rst:140 #, fuzzy msgid "" "For example, to write Unicode literals including the Euro currency symbol, " "the ISO-8859-15 encoding can be used, with the Euro symbol having the " "ordinal value 164. This script, when saved in the ISO-8859-15 encoding, " -"will print the value 8364 (the Unicode codepoint corresponding to the Euro " +"will print the value 8364 (the Unicode code point corresponding to the Euro " "symbol) and then exit::" msgstr "" "Par exemple, l'encodage ISO-8859-15 peut être utilisé pour écrire le " @@ -5701,7 +5696,7 @@ msgstr "" "code Unicode correspondant au symbole Euro) et se termine ::" # f6dd13cd8acb47b1b663b044df22ddf5 -#: ../src/Doc/tutorial/interpreter.rst:148 +#: tutorial/interpreter.rst:150 msgid "" "If your editor supports saving files as ``UTF-8`` with a UTF-8 *byte order " "mark* (aka BOM), you can use that instead of an encoding declaration. IDLE " @@ -5712,7 +5707,7 @@ msgid "" msgstr "" # 54d62eeac9bc4555818501cd2d0d843d -#: ../src/Doc/tutorial/interpreter.rst:155 +#: tutorial/interpreter.rst:157 msgid "" "By using UTF-8 (either through the signature or an encoding declaration), " "characters of most languages in the world can be used simultaneously in " @@ -5722,11 +5717,11 @@ msgid "" "the characters in the file." msgstr "" -#: ../src/Doc/tutorial/introduction.rst:5 +#: tutorial/introduction.rst:5 msgid "An Informal Introduction to Python" msgstr "Introduction informelle à Python" -#: ../src/Doc/tutorial/introduction.rst:7 +#: tutorial/introduction.rst:7 #, fuzzy msgid "" "In the following examples, input and output are distinguished by the " @@ -5744,7 +5739,7 @@ msgstr "" "ligne dans un exemple indique que vous devez entrer une ligne vide ; ceci " "est utilisé pour terminer une commande multi-lignes." -#: ../src/Doc/tutorial/introduction.rst:14 +#: tutorial/introduction.rst:14 msgid "" "Many of the examples in this manual, even those entered at the interactive " "prompt, include comments. Comments in Python start with the hash character, " @@ -5764,11 +5759,11 @@ msgstr "" "le code et ne sont pas interprétés par Python, ils peuvent être ignorés " "lorsque vous tapez les exemples." -#: ../src/Doc/tutorial/introduction.rst:33 +#: tutorial/introduction.rst:33 msgid "Using Python as a Calculator" msgstr "Utiliser Python comme une calculatrice" -#: ../src/Doc/tutorial/introduction.rst:35 +#: tutorial/introduction.rst:35 msgid "" "Let's try some simple Python commands. Start the interpreter and wait for " "the primary prompt, ``>>>``. (It shouldn't take long.)" @@ -5776,11 +5771,11 @@ msgstr "" "Essayons quelques commandes Python simples. Démarrez l'interpréteur et " "attendez l'invite primaire, ``>>>``. Ça ne devrait pas être long." -#: ../src/Doc/tutorial/introduction.rst:42 +#: tutorial/introduction.rst:42 msgid "Numbers" msgstr "Les nombres" -#: ../src/Doc/tutorial/introduction.rst:44 +#: tutorial/introduction.rst:44 #, fuzzy msgid "" "The interpreter acts as a simple calculator: you can type an expression at " @@ -5796,7 +5791,7 @@ msgstr "" "être utilisées pour faire des regroupements. Par exemple ::" # 7b9b56f9e273421eb20e67d6bde63dbd -#: ../src/Doc/tutorial/introduction.rst:59 +#: tutorial/introduction.rst:59 msgid "" "The integer numbers (e.g. ``2``, ``4``, ``20``) have type :class:`int`, the " "ones with a fractional part (e.g. ``5.0``, ``1.6``) have type :class:" @@ -5808,7 +5803,7 @@ msgstr "" "tutoriel." # 659e965541a646aab63e6d711725f32d -#: ../src/Doc/tutorial/introduction.rst:63 +#: tutorial/introduction.rst:63 msgid "" "The return type of a division (``/``) operation depends on its operands. If " "both operands are of type :class:`int`, :term:`floor division` is performed " @@ -5819,7 +5814,7 @@ msgid "" msgstr "" # 488914a0ef4a4523ad455e804719d93c -#: ../src/Doc/tutorial/introduction.rst:81 +#: tutorial/introduction.rst:81 msgid "" "With Python, it is possible to use the ``**`` operator to calculate powers " "[#]_::" @@ -5827,7 +5822,7 @@ msgstr "" "Avec Python il est possible de calculer des puissances avec l'opérateur " "``**`` [#]_ ::" -#: ../src/Doc/tutorial/introduction.rst:88 +#: tutorial/introduction.rst:88 #, fuzzy msgid "" "The equal sign (``=``) is used to assign a value to a variable. Afterwards, " @@ -5836,7 +5831,7 @@ msgstr "" "Le signe égal (``'='``) est utilisé pour affecter une valeur à une variable. " "Après cela, aucun résultat n'est affiché avant l'invite suivante ::" -#: ../src/Doc/tutorial/introduction.rst:96 +#: tutorial/introduction.rst:96 #, fuzzy msgid "" "If a variable is not \"defined\" (assigned a value), trying to use it will " @@ -5845,7 +5840,7 @@ msgstr "" "Les variables doivent être \"définies\" (une valeur doit leur être affectée) " "pour qu'elles puissent être utilisées, sans quoi une erreur interviendra ::" -#: ../src/Doc/tutorial/introduction.rst:104 +#: tutorial/introduction.rst:104 msgid "" "There is full support for floating point; operators with mixed type operands " "convert the integer operand to floating point::" @@ -5854,7 +5849,7 @@ msgstr "" "avec des types d'opérandes mélangés convertissent l'opérande entier en " "virgule flottante ::" -#: ../src/Doc/tutorial/introduction.rst:112 +#: tutorial/introduction.rst:112 msgid "" "In interactive mode, the last printed expression is assigned to the variable " "``_``. This means that when you are using Python as a desk calculator, it " @@ -5865,7 +5860,7 @@ msgstr "" "calculatrice, il est parfois plus simple de continuer des calculs, par " "exemple ::" -#: ../src/Doc/tutorial/introduction.rst:125 +#: tutorial/introduction.rst:125 msgid "" "This variable should be treated as read-only by the user. Don't explicitly " "assign a value to it --- you would create an independent local variable with " @@ -5877,7 +5872,7 @@ msgstr "" "variable native et son fonctionnement magique." # 19a0a69a362f45c19ef8d6d6a29e0465 -#: ../src/Doc/tutorial/introduction.rst:129 +#: tutorial/introduction.rst:129 msgid "" "In addition to :class:`int` and :class:`float`, Python supports other types " "of numbers, such as :class:`~decimal.Decimal` and :class:`~fractions." @@ -5890,11 +5885,11 @@ msgstr "" "les :ref:`nombre complexes <typesnumeric>`, en utilisant le suffixe ``j`` ou " "``J`` pour indiquer la partie imaginaire (tel que: ``3+5j``)." -#: ../src/Doc/tutorial/introduction.rst:139 +#: tutorial/introduction.rst:139 msgid "Strings" msgstr "Les chaînes de caractères" -#: ../src/Doc/tutorial/introduction.rst:141 +#: tutorial/introduction.rst:141 #, fuzzy msgid "" "Besides numbers, Python can also manipulate strings, which can be expressed " @@ -5907,7 +5902,7 @@ msgstr "" "écrites entre apostrophes ou entre guillemets." # 9c733fd1348b4d048794c552b36f40fe -#: ../src/Doc/tutorial/introduction.rst:159 +#: tutorial/introduction.rst:159 #, fuzzy msgid "" "In the interactive interpreter, the output string is enclosed in quotes and " @@ -5927,7 +5922,7 @@ msgstr "" "guillemets simples." # 19c1122b24cf49138e4523f22314bff9 -#: ../src/Doc/tutorial/introduction.rst:179 +#: tutorial/introduction.rst:179 msgid "" "If you don't want characters prefaced by ``\\`` to be interpreted as special " "characters, you can use *raw strings* by adding an ``r`` before the first " @@ -5938,7 +5933,7 @@ msgstr "" "préfixant la chaîne d'un ``r`` ::" # c62f03c744a64be280c22a78c455a790 -#: ../src/Doc/tutorial/introduction.rst:189 +#: tutorial/introduction.rst:189 msgid "" "String literals can span multiple lines. One way is using triple-quotes: ``" "\"\"\"...\"\"\"`` or ``'''...'''``. End of lines are automatically included " @@ -5952,7 +5947,7 @@ msgstr "" "suivant ::" # 11daeac1da4f4f93ae387aad6a042560 -#: ../src/Doc/tutorial/introduction.rst:200 +#: tutorial/introduction.rst:200 msgid "" "produces the following output (note that the initial newline is not " "included):" @@ -5960,7 +5955,7 @@ msgstr "" "produit l'affichage suivant (notez que le premier retour à la ligne n'est " "pas inclus) :" -#: ../src/Doc/tutorial/introduction.rst:208 +#: tutorial/introduction.rst:208 msgid "" "Strings can be concatenated (glued together) with the ``+`` operator, and " "repeated with ``*``::" @@ -5969,7 +5964,7 @@ msgstr "" "+``, et répétées avec l'opérateur ``*``::" # 15608e4291844e01803013d0842e63bf -#: ../src/Doc/tutorial/introduction.rst:215 +#: tutorial/introduction.rst:215 msgid "" "Two or more *string literals* (i.e. the ones enclosed between quotes) next " "to each other are automatically concatenated. ::" @@ -5978,7 +5973,7 @@ msgstr "" "guillemets), côte à côte, sont automatiquement concaténées. ::" # 19c4cdfc11354a0ba24e43dc7e257efb -#: ../src/Doc/tutorial/introduction.rst:221 +#: tutorial/introduction.rst:221 msgid "" "This only works with two literals though, not with variables or expressions::" msgstr "" @@ -5986,7 +5981,7 @@ msgstr "" "variables ni les expressions ::" # b4fabb6326ca4278b57d37982f33c928 -#: ../src/Doc/tutorial/introduction.rst:231 +#: tutorial/introduction.rst:231 msgid "" "If you want to concatenate variables or a variable and a literal, use ``+``::" msgstr "" @@ -5994,7 +5989,7 @@ msgstr "" "utilisez l'opérateur ``+``::" # 4da7e6d1dc5940b69c55b49bd22ca20e -#: ../src/Doc/tutorial/introduction.rst:236 +#: tutorial/introduction.rst:236 msgid "" "This feature is particularly useful when you want to break long strings::" msgstr "" @@ -6002,7 +5997,7 @@ msgstr "" "longues ::" # 81b99e3ed45148568543d7906b031fef -#: ../src/Doc/tutorial/introduction.rst:243 +#: tutorial/introduction.rst:243 #, fuzzy msgid "" "Strings can be *indexed* (subscripted), with the first character having " @@ -6015,7 +6010,7 @@ msgstr "" "Comme dans Icon, des sous-chaînes peuvent être spécifiées via une *notation " "par tranches* : deux indices séparés par deux points ::" -#: ../src/Doc/tutorial/introduction.rst:253 +#: tutorial/introduction.rst:253 #, fuzzy msgid "" "Indices may also be negative numbers, to start counting from the right::" @@ -6024,12 +6019,12 @@ msgstr "" "partant de la droite. Par exemple ::" # 2396721f786f406abc44eac947210655 -#: ../src/Doc/tutorial/introduction.rst:262 +#: tutorial/introduction.rst:262 msgid "Note that since -0 is the same as 0, negative indices start from -1." msgstr "Notez que puisque -0 égal 0, les indices négatifs commencent par -1." # 9a6822d665b84ab3a5d38055c73bb077 -#: ../src/Doc/tutorial/introduction.rst:264 +#: tutorial/introduction.rst:264 #, fuzzy msgid "" "In addition to indexing, *slicing* is also supported. While indexing is " @@ -6041,7 +6036,7 @@ msgstr "" "caractère, alors que la *trancher* permet d'obtenir une sous-chaïne ::" # b7c539be3f7b473d81fc2321525dd5e7 -#: ../src/Doc/tutorial/introduction.rst:272 +#: tutorial/introduction.rst:272 msgid "" "Note how the start is always included, and the end always excluded. This " "makes sure that ``s[:i] + s[i:]`` is always equal to ``s``::" @@ -6049,7 +6044,7 @@ msgstr "" "Notez que le début est toujours inclus et la fin toujours exclue. Cela " "assure que ``s[:i] + s[i:]``est toujours égal à ``s`` ::" -#: ../src/Doc/tutorial/introduction.rst:280 +#: tutorial/introduction.rst:280 msgid "" "Slice indices have useful defaults; an omitted first index defaults to zero, " "an omitted second index defaults to the size of the string being sliced. ::" @@ -6058,7 +6053,7 @@ msgstr "" "indice lorsqu'il est omis équivaut à zéro, le second à la taille de la " "chaîne de caractères ::" -#: ../src/Doc/tutorial/introduction.rst:290 +#: tutorial/introduction.rst:290 msgid "" "One way to remember how slices work is to think of the indices as pointing " "*between* characters, with the left edge of the first character numbered 0. " @@ -6070,7 +6065,7 @@ msgstr "" "caractère ayant la position 0. Le côté droit du dernier caractère d'une " "chaîne de *n* caractères a alors pour indice *n*, par exemple ::" -#: ../src/Doc/tutorial/introduction.rst:301 +#: tutorial/introduction.rst:301 #, fuzzy msgid "" "The first row of numbers gives the position of the indices 0...6 in the " @@ -6083,7 +6078,7 @@ msgstr "" "de *i* à *j* est constituée de tous les caractères situés entre les bords " "libellés *i* et *j*, respectivement." -#: ../src/Doc/tutorial/introduction.rst:306 +#: tutorial/introduction.rst:306 msgid "" "For non-negative indices, the length of a slice is the difference of the " "indices, if both are within bounds. For example, the length of " @@ -6094,13 +6089,13 @@ msgstr "" "de ``word[1:3]`` est 2." # f740872fc6ac484ca5465bdb0819ee73 -#: ../src/Doc/tutorial/introduction.rst:310 +#: tutorial/introduction.rst:310 #, fuzzy msgid "Attempting to use a index that is too large will result in an error::" msgstr "Utiliser un indice trop grand générera une erreur ::" # b8602220b26e4c1a9f6ffb179188e2f0 -#: ../src/Doc/tutorial/introduction.rst:317 +#: tutorial/introduction.rst:317 msgid "" "However, out of range slice indexes are handled gracefully when used for " "slicing::" @@ -6108,7 +6103,7 @@ msgstr "" "Cependant, les indices hors bornes sont gérés silencieusement lorsqu'ils " "sont utilisés dans des tranches ::" -#: ../src/Doc/tutorial/introduction.rst:325 +#: tutorial/introduction.rst:325 #, fuzzy msgid "" "Python strings cannot be changed --- they are :term:`immutable`. Therefore, " @@ -6119,22 +6114,21 @@ msgstr "" "chaîne produit une erreur ::" # e6f19742421b4743a89d8785cf57573e -#: ../src/Doc/tutorial/introduction.rst:335 +#: tutorial/introduction.rst:335 msgid "If you need a different string, you should create a new one::" msgstr "" "Si vous avez besoin d'une chaîne différente, vous devez en créer une autre ::" -#: ../src/Doc/tutorial/introduction.rst:342 +#: tutorial/introduction.rst:342 msgid "The built-in function :func:`len` returns the length of a string::" msgstr "La fonction native :func:`len` renvoie la longue d'une chaîne ::" -# 0eb2c14eac424a05af3c5dd19732a132 -#: ../src/Doc/tutorial/introduction.rst:353 -msgid ":ref:`typesseq`" +#: tutorial/introduction.rst:354 +msgid "typesseq" msgstr "" # dc94a4264e3a4a0fa21b4f0848b59ea8 -#: ../src/Doc/tutorial/introduction.rst:352 +#: tutorial/introduction.rst:352 msgid "" "Strings, and the Unicode strings described in the next section, are examples " "of *sequence types*, and support the common operations supported by such " @@ -6144,13 +6138,12 @@ msgstr "" "section, sont des exemples de *types de séquences*, et supportent donc les " "opérations classiques prises en charge par ces types." -# 33023ea434814001bef16f2efe37b113 -#: ../src/Doc/tutorial/introduction.rst:357 -msgid ":ref:`string-methods`" +#: tutorial/introduction.rst:358 +msgid "string-methods" msgstr "" # 0e3c9c88390d40f8b435ceca2e3e5fa2 -#: ../src/Doc/tutorial/introduction.rst:357 +#: tutorial/introduction.rst:357 msgid "" "Both strings and Unicode strings support a large number of methods for basic " "transformations and searching." @@ -6158,24 +6151,24 @@ msgstr "" "Aussi bien les chaînes de caractères que les chaînes Unicode supportent un " "large éventail de méthodes de transformations basiques et de recherche." -#: ../src/Doc/tutorial/introduction.rst:361 +#: tutorial/introduction.rst:362 #, fuzzy -msgid ":ref:`new-string-formatting`" +msgid "new-string-formatting" msgstr "Anciennes méthodes de formatage de chaînes" -#: ../src/Doc/tutorial/introduction.rst:361 +#: tutorial/introduction.rst:361 msgid "" "Information about string formatting with :meth:`str.format` is described " "here." msgstr "" "Le formatage des chaînes avec la méthode :meth:`str.format` est décrit ici." -#: ../src/Doc/tutorial/introduction.rst:364 +#: tutorial/introduction.rst:365 #, fuzzy -msgid ":ref:`string-formatting`" +msgid "string-formatting" msgstr "Anciennes méthodes de formatage de chaînes" -#: ../src/Doc/tutorial/introduction.rst:365 +#: tutorial/introduction.rst:365 msgid "" "The old formatting operations invoked when strings and Unicode strings are " "the left operand of the ``%`` operator are described in more detail here." @@ -6185,12 +6178,12 @@ msgstr "" "l'opérateur ``%`` sont décrites plus en détail ici." # e9f5c7de8cd043048a81c59a606bda57 -#: ../src/Doc/tutorial/introduction.rst:372 +#: tutorial/introduction.rst:372 msgid "Unicode Strings" msgstr "Chaînes Unicode" # ff4a88fc4dbf4203a1963c8e8042a016 -#: ../src/Doc/tutorial/introduction.rst:377 +#: tutorial/introduction.rst:377 msgid "" "Starting with Python 2.0 a new data type for storing text data is available " "to the programmer: the Unicode object. It can be used to store and " @@ -6203,7 +6196,7 @@ msgstr "" "et s'intègre très bien avec les types de chaînes de caractères existant, en " "fournissant une conversion automatique lorsque c'est nécessaire." -#: ../src/Doc/tutorial/introduction.rst:382 +#: tutorial/introduction.rst:382 msgid "" "Unicode has the advantage of providing one ordinal for every character in " "every script used in modern and ancient texts. Previously, there were only " @@ -6224,7 +6217,7 @@ msgstr "" "page de code unique pour tous les scripts." # 9c768ff79bed4b06873ef02799f68dee -#: ../src/Doc/tutorial/introduction.rst:390 +#: tutorial/introduction.rst:390 msgid "" "Creating Unicode strings in Python is just as simple as creating normal " "strings::" @@ -6233,7 +6226,7 @@ msgstr "" "chaînes de caractères normales ::" # 49929afe29c94cd38e866dcbb014004e -#: ../src/Doc/tutorial/introduction.rst:396 +#: tutorial/introduction.rst:396 msgid "" "The small ``'u'`` in front of the quote indicates that a Unicode string is " "supposed to be created. If you want to include special characters in the " @@ -6245,7 +6238,7 @@ msgstr "" "chaîne, vous pouvez le faire en utilisant l'encodage Python d'échappement " "des caractères Unicode. Comme dans cet exemple ::" -#: ../src/Doc/tutorial/introduction.rst:404 +#: tutorial/introduction.rst:404 msgid "" "The escape sequence ``\\u0020`` indicates to insert the Unicode character " "with the ordinal value 0x0020 (the space character) at the given position." @@ -6253,7 +6246,7 @@ msgstr "" "La séquence d'échappement ``\\u0020`` indique d'insérer le caractère Unicode " "de valeur ordinale 0x0020 (un espace) à la position indiquée." -#: ../src/Doc/tutorial/introduction.rst:407 +#: tutorial/introduction.rst:407 msgid "" "Other characters are interpreted by using their respective ordinal values " "directly as Unicode ordinals. If you have literal strings in the standard " @@ -6268,7 +6261,7 @@ msgstr "" "soient les mêmes que ceux de l'encodage Latin-1." # e704dbdcc7b84d5fa5187b18e3df045b -#: ../src/Doc/tutorial/introduction.rst:413 +#: tutorial/introduction.rst:413 msgid "" "For experts, there is also a raw mode just like the one for normal strings. " "You have to prefix the opening quote with 'ur' to have Python use the *Raw-" @@ -6283,7 +6276,7 @@ msgstr "" "un nombre impair d'antislashs devant le petit 'u' ::" # f7d8ba88d48343f1bc5e81982b1faf00 -#: ../src/Doc/tutorial/introduction.rst:424 +#: tutorial/introduction.rst:424 msgid "" "The raw mode is most useful when you have to enter lots of backslashes, as " "can be necessary in regular expressions." @@ -6292,7 +6285,7 @@ msgstr "" "antislashs, comme il peut être nécessaire de le faire dans des expressions " "rationnelles." -#: ../src/Doc/tutorial/introduction.rst:427 +#: tutorial/introduction.rst:427 msgid "" "Apart from these standard encodings, Python provides a whole set of other " "ways of creating Unicode strings on the basis of a known encoding." @@ -6301,7 +6294,7 @@ msgstr "" "créer des chaînes Unicode sur la base d'un encodage connu." # 6b911ea5f8a24a2a8531621f77f2b074 -#: ../src/Doc/tutorial/introduction.rst:432 +#: tutorial/introduction.rst:432 msgid "" "The built-in function :func:`unicode` provides access to all registered " "Unicode codecs (COders and DECoders). Some of the more well known encodings " @@ -6324,7 +6317,7 @@ msgstr "" "func:`str`, une conversion s'effectue en utilisant cet encodage par défaut ::" # 8b0b7540567140749bbd4a088d41db0b -#: ../src/Doc/tutorial/introduction.rst:452 +#: tutorial/introduction.rst:452 msgid "" "To convert a Unicode string into an 8-bit string using a specific encoding, " "Unicode objects provide an :func:`encode` method that takes one argument, " @@ -6336,7 +6329,7 @@ msgstr "" "noms d'encodages en minuscules sont préférés ::" # 88ffe7f4fb0340b290b1ce47aced804e -#: ../src/Doc/tutorial/introduction.rst:459 +#: tutorial/introduction.rst:459 msgid "" "If you have data in a specific encoding and want to produce a corresponding " "Unicode string from it, you can use the :func:`unicode` function with the " @@ -6346,11 +6339,11 @@ msgstr "" "chaîne Unicode correspondante, vous pouvez utiliser la fonction :func:" "`unicode` en fournissant le nom de l'encodage comme second argument ::" -#: ../src/Doc/tutorial/introduction.rst:470 +#: tutorial/introduction.rst:470 msgid "Lists" msgstr "Les listes" -#: ../src/Doc/tutorial/introduction.rst:472 +#: tutorial/introduction.rst:472 #, fuzzy msgid "" "Python knows a number of *compound* data types, used to group together other " @@ -6365,7 +6358,7 @@ msgstr "" "tous du même type ::" # 81098069b1194a0187318b856300bed8 -#: ../src/Doc/tutorial/introduction.rst:481 +#: tutorial/introduction.rst:481 msgid "" "Like strings (and all other built-in :term:`sequence` type), lists can be " "indexed and sliced::" @@ -6373,7 +6366,7 @@ msgstr "" "Comme les chaînes de caractères (et toute autre types de :term:`sequence`), " "les listes peuvent être indicées et découpées ::" -#: ../src/Doc/tutorial/introduction.rst:491 +#: tutorial/introduction.rst:491 #, fuzzy msgid "" "All slice operations return a new list containing the requested elements. " @@ -6385,12 +6378,12 @@ msgstr "" "copie superficielle de la liste *a* ::" # f7fe9f98c794433782fc91cb7e94bf90 -#: ../src/Doc/tutorial/introduction.rst:497 +#: tutorial/introduction.rst:497 #, fuzzy msgid "Lists also supports operations like concatenation::" msgstr "Les listes gèrent aussi les opérations comme les concaténations ::" -#: ../src/Doc/tutorial/introduction.rst:502 +#: tutorial/introduction.rst:502 #, fuzzy msgid "" "Unlike strings, which are :term:`immutable`, lists are a :term:`mutable` " @@ -6400,7 +6393,7 @@ msgstr "" "modifier un élément d'une liste ::" # 48a20ff5d1ce4fbf8027ba7b65a64c9b -#: ../src/Doc/tutorial/introduction.rst:512 +#: tutorial/introduction.rst:512 msgid "" "You can also add new items at the end of the list, by using the :meth:`~list." "append` *method* (we will see more about methods later)::" @@ -6409,7 +6402,7 @@ msgstr "" "avec la méthode :meth:`~list.append`. (Les méthodes seront abordées plus " "tard) ::" -#: ../src/Doc/tutorial/introduction.rst:520 +#: tutorial/introduction.rst:520 msgid "" "Assignment to slices is also possible, and this can even change the size of " "the list or clear it entirely::" @@ -6417,11 +6410,11 @@ msgstr "" "Des affectations de tranches sont également possibles, ce qui peut même " "modifier la taille de la liste ou la vider complètement ::" -#: ../src/Doc/tutorial/introduction.rst:539 +#: tutorial/introduction.rst:539 msgid "The built-in function :func:`len` also applies to lists::" msgstr "La primitive :func:`len` s'applique aussi aux listes ::" -#: ../src/Doc/tutorial/introduction.rst:545 +#: tutorial/introduction.rst:545 msgid "" "It is possible to nest lists (create lists containing other lists), for " "example::" @@ -6429,11 +6422,11 @@ msgstr "" "Il est possible d'imbriquer des listes (de créer des listes contenant " "d'autres listes), par exemple ::" -#: ../src/Doc/tutorial/introduction.rst:561 +#: tutorial/introduction.rst:561 msgid "First Steps Towards Programming" msgstr "Premiers pas vers la programmation" -#: ../src/Doc/tutorial/introduction.rst:563 +#: tutorial/introduction.rst:563 msgid "" "Of course, we can use Python for more complicated tasks than adding two and " "two together. For instance, we can write an initial sub-sequence of the " @@ -6443,11 +6436,11 @@ msgstr "" "d'additionner deux et deux. Par exemple, on peut écrire une sous-séquence " "initiale de la suite de Fibonacci comme ceci ::" -#: ../src/Doc/tutorial/introduction.rst:581 +#: tutorial/introduction.rst:581 msgid "This example introduces several new features." msgstr "Cet exemple introduit plusieurs nouvelles fonctionnalités." -#: ../src/Doc/tutorial/introduction.rst:583 +#: tutorial/introduction.rst:583 msgid "" "The first line contains a *multiple assignment*: the variables ``a`` and " "``b`` simultaneously get the new values 0 and 1. On the last line this is " @@ -6462,7 +6455,7 @@ msgstr "" "avant que les affectations ne soient effectuées. Ces expressions en partie " "droite sont toujours évaluées de la gauche vers la droite." -#: ../src/Doc/tutorial/introduction.rst:589 +#: tutorial/introduction.rst:589 msgid "" "The :keyword:`while` loop executes as long as the condition (here: ``b < " "10``) remains true. In Python, like in C, any non-zero integer value is " @@ -6484,7 +6477,7 @@ msgstr "" "=`` (non égal)." # c3ffd8600fb6465eb41e1b71ee58a106 -#: ../src/Doc/tutorial/introduction.rst:598 +#: tutorial/introduction.rst:598 msgid "" "The *body* of the loop is *indented*: indentation is Python's way of " "grouping statements. At the interactive prompt, you have to type a tab or " @@ -6507,7 +6500,7 @@ msgstr "" "l'intérieur d'un bloc doivent être indentées au même niveau." # 77dfda61249149ebbff3415dc7f626c0 -#: ../src/Doc/tutorial/introduction.rst:607 +#: tutorial/introduction.rst:607 msgid "" "The :keyword:`print` statement writes the value of the expression(s) it is " "given. It differs from just writing the expression you want to write (as we " @@ -6524,12 +6517,12 @@ msgstr "" "facilement formater les choses, comme ceci ::" # f1fa0b0caa934963ad37b6df950d1d60 -#: ../src/Doc/tutorial/introduction.rst:617 +#: tutorial/introduction.rst:617 msgid "A trailing comma avoids the newline after the output::" msgstr "Une virgule à la fin de l'instruction supprime le saut de ligne ::" # 9af5f173627d4c51a46b129d40db499d -#: ../src/Doc/tutorial/introduction.rst:626 +#: tutorial/introduction.rst:626 msgid "" "Note that the interpreter inserts a newline before it prints the next prompt " "if the last line was not completed." @@ -6538,7 +6531,7 @@ msgstr "" "suivante si la dernière ligne n'était pas complète." # 18b4eeae89f74e5986a556177ba9f3a6 -#: ../src/Doc/tutorial/introduction.rst:631 +#: tutorial/introduction.rst:631 msgid "" "Since ``**`` has higher precedence than ``-``, ``-3**2`` will be interpreted " "as ``-(3**2)`` and thus result in ``-9``. To avoid this and get ``9``, you " @@ -6549,7 +6542,7 @@ msgstr "" "des parenthèses : ``(-3) ** 2``." # 986c20e64eda48919db6dac30f3acab2 -#: ../src/Doc/tutorial/introduction.rst:635 +#: tutorial/introduction.rst:635 msgid "" "Unlike other languages, special characters such as ``\\n`` have the same " "meaning with both single (``'...'``) and double (``\"...\"``) quotes. The " @@ -6561,11 +6554,11 @@ msgstr "" "(`'...'`). La seule différence est que dans une chaîne entre guillemets il " "n'est pas nécessaire de protéger les guillemets simples et vice-versa." -#: ../src/Doc/tutorial/modules.rst:5 +#: tutorial/modules.rst:5 msgid "Modules" msgstr "Modules" -#: ../src/Doc/tutorial/modules.rst:7 +#: tutorial/modules.rst:7 msgid "" "If you quit from the Python interpreter and enter it again, the definitions " "you have made (functions and variables) are lost. Therefore, if you want to " @@ -6585,7 +6578,7 @@ msgstr "" "et vous trouverez aussi pratique de réutiliser des fonctions écrites pour un " "programme dans un autre sans avoir à les copier." -#: ../src/Doc/tutorial/modules.rst:16 +#: tutorial/modules.rst:16 msgid "" "To support this, Python has a way to put definitions in a file and use them " "in a script or in an interactive instance of the interpreter. Such a file is " @@ -6600,7 +6593,7 @@ msgstr "" "qui contiens vous variables et définitions lors de l'exécution d'un script " "ou en mode interactif)." -#: ../src/Doc/tutorial/modules.rst:22 +#: tutorial/modules.rst:22 msgid "" "A module is a file containing Python definitions and statements. The file " "name is the module name with the suffix :file:`.py` appended. Within a " @@ -6615,7 +6608,7 @@ msgstr "" "``__name__``. Par exemple, prenez votre éditeur favori et créez un fichier :" "file:`fibo.py` contenant ::" -#: ../src/Doc/tutorial/modules.rst:44 +#: tutorial/modules.rst:44 msgid "" "Now enter the Python interpreter and import this module with the following " "command::" @@ -6623,7 +6616,7 @@ msgstr "" "Maintenant, en étant dans le même dossier, ouvrez un interpréteur et " "importez le module en tapant ::" -#: ../src/Doc/tutorial/modules.rst:49 +#: tutorial/modules.rst:49 msgid "" "This does not enter the names of the functions defined in ``fibo`` directly " "in the current symbol table; it only enters the module name ``fibo`` there. " @@ -6633,19 +6626,19 @@ msgstr "" "dans la table des symboles courante, mais y ajoute simplement ``fibo``. Vous " "pouvez donc appeler les fonctions via le nom du module ::" -#: ../src/Doc/tutorial/modules.rst:60 +#: tutorial/modules.rst:60 msgid "" "If you intend to use a function often you can assign it to a local name::" msgstr "" "Si vous avez l'intention d'utiliser une fonction souvent, il est possible de " "lui assigner un nom local ::" -#: ../src/Doc/tutorial/modules.rst:70 +#: tutorial/modules.rst:70 msgid "More on Modules" msgstr "Les modules en détails" # 68120fe1cf1e43d2b26b0e1e3af197bb -#: ../src/Doc/tutorial/modules.rst:72 +#: tutorial/modules.rst:72 msgid "" "A module can contain executable statements as well as function definitions. " "These statements are intended to initialize the module. They are executed " @@ -6658,7 +6651,7 @@ msgstr "" "un ``import``. [#]_ (Elles sont aussi exécutées lorsque le fichier est " "exécuté en temps que script.)" -#: ../src/Doc/tutorial/modules.rst:77 +#: tutorial/modules.rst:77 msgid "" "Each module has its own private symbol table, which is used as the global " "symbol table by all functions defined in the module. Thus, the author of a " @@ -6675,7 +6668,7 @@ msgstr "" "vous pouvez modifier une variable globale d'un module avec la même notation " "que pour accéder aux fonctions : ``modname.itemname``." -#: ../src/Doc/tutorial/modules.rst:84 +#: tutorial/modules.rst:84 msgid "" "Modules can import other modules. It is customary but not required to place " "all :keyword:`import` statements at the beginning of a module (or script, " @@ -6687,7 +6680,7 @@ msgstr "" "script). Les noms des module importés sont insérés dans la table des " "symboles globaux du module qui importe." -#: ../src/Doc/tutorial/modules.rst:89 +#: tutorial/modules.rst:89 msgid "" "There is a variant of the :keyword:`import` statement that imports names " "from a module directly into the importing module's symbol table. For " @@ -6697,7 +6690,7 @@ msgstr "" "noms d'un module directement dans la table de symboles du module qui " "l'importe, par exemple ::" -#: ../src/Doc/tutorial/modules.rst:96 +#: tutorial/modules.rst:96 msgid "" "This does not introduce the module name from which the imports are taken in " "the local symbol table (so in the example, ``fibo`` is not defined)." @@ -6706,19 +6699,19 @@ msgstr "" "récupérées dans la table locale de symboles (dans cet exemple, ``fibo`` " "n'est pas défini)." -#: ../src/Doc/tutorial/modules.rst:99 +#: tutorial/modules.rst:99 msgid "There is even a variant to import all names that a module defines::" msgstr "" "Il existe même une variation permettant d'importer tous les noms qu'un " "module définit ::" # a576f929fa4b4f03a5ecc568fbc39da4 -#: ../src/Doc/tutorial/modules.rst:105 +#: tutorial/modules.rst:105 msgid "" "This imports all names except those beginning with an underscore (``_``)." msgstr "" -#: ../src/Doc/tutorial/modules.rst:107 +#: tutorial/modules.rst:107 msgid "" "Note that in general the practice of importing ``*`` from a module or " "package is frowned upon, since it often causes poorly readable code. " @@ -6730,7 +6723,7 @@ msgstr "" "mode interactif." # 43ceb255506f40879d48e04284318f2b -#: ../src/Doc/tutorial/modules.rst:113 +#: tutorial/modules.rst:113 #, fuzzy msgid "" "For efficiency reasons, each module is only imported once per interpreter " @@ -6744,15 +6737,15 @@ msgstr "" "utilisant :func:`imp.reload`, par exemple : ``import imp; imp." "reload(modulename)``." -#: ../src/Doc/tutorial/modules.rst:122 +#: tutorial/modules.rst:122 msgid "Executing modules as scripts" msgstr "Exécuter des modules comme des scripts" -#: ../src/Doc/tutorial/modules.rst:124 +#: tutorial/modules.rst:124 msgid "When you run a Python module with ::" msgstr "Lorsque vous exécutez un module Python avec ::" -#: ../src/Doc/tutorial/modules.rst:128 +#: tutorial/modules.rst:128 msgid "" "the code in the module will be executed, just as if you imported it, but " "with the ``__name__`` set to ``\"__main__\"``. That means that by adding " @@ -6762,7 +6755,7 @@ msgstr "" "``__name__`` vaudra ``\"__main__\"``. Donc en ajoutant ces lignes à la fin " "du module ::" -#: ../src/Doc/tutorial/modules.rst:136 +#: tutorial/modules.rst:136 msgid "" "you can make the file usable as a script as well as an importable module, " "because the code that parses the command line only runs if the module is " @@ -6772,11 +6765,11 @@ msgstr "" "temps que module, puisque le code qui lis les paramètres de la ligne de " "commande n'est exécuté que si le module est le fichier principal ::" -#: ../src/Doc/tutorial/modules.rst:143 +#: tutorial/modules.rst:143 msgid "If the module is imported, the code is not run::" msgstr "Si le fichier est importé, le code n'est pas exécuté ::" -#: ../src/Doc/tutorial/modules.rst:148 +#: tutorial/modules.rst:148 msgid "" "This is often used either to provide a convenient user interface to a " "module, or for testing purposes (running the module as a script executes a " @@ -6786,12 +6779,12 @@ msgstr "" "un module, soit pour lancer les tests sur le module (où exécuter le module " "en temps que script lance les tests)." -#: ../src/Doc/tutorial/modules.rst:155 +#: tutorial/modules.rst:155 msgid "The Module Search Path" msgstr "Les dossiers de recherche de modules" # 7eb1de98727b457bb47241fe0f9a3c7a -#: ../src/Doc/tutorial/modules.rst:159 +#: tutorial/modules.rst:159 msgid "" "When a module named :mod:`spam` is imported, the interpreter first searches " "for a built-in module with that name. If not found, it then searches for a " @@ -6805,12 +6798,12 @@ msgstr "" "à ::" # 2cfb18e596454d35aba4942f36ffb217 -#: ../src/Doc/tutorial/modules.rst:164 +#: tutorial/modules.rst:164 msgid "the directory containing the input script (or the current directory)." msgstr "" # 92b653933f904f2ba5db5eeb5106e97d -#: ../src/Doc/tutorial/modules.rst:165 +#: tutorial/modules.rst:165 msgid "" ":envvar:`PYTHONPATH` (a list of directory names, with the same syntax as the " "shell variable :envvar:`PATH`)." @@ -6819,12 +6812,12 @@ msgstr "" "la variable shell :envvar:`PATH`)." # 5f64433feec849c99a5c0234fbe44b86 -#: ../src/Doc/tutorial/modules.rst:167 +#: tutorial/modules.rst:167 msgid "the installation-dependent default." msgstr "" # 06804f6bce114936a931a03ac145ec9a -#: ../src/Doc/tutorial/modules.rst:169 +#: tutorial/modules.rst:169 msgid "" "After initialization, Python programs can modify :data:`sys.path`. The " "directory containing the script being run is placed at the beginning of the " @@ -6840,11 +6833,11 @@ msgstr "" "chargé à sa place. C'est une erreur typique, à moins que ce soit voulu. " "Voir :ref:`tut-standardmodules` pour plus d'informations." -#: ../src/Doc/tutorial/modules.rst:178 +#: tutorial/modules.rst:178 msgid "\"Compiled\" Python files" msgstr "Fichiers Python \"compilés\"" -#: ../src/Doc/tutorial/modules.rst:180 +#: tutorial/modules.rst:180 msgid "" "As an important speed-up of the start-up time for short programs that use a " "lot of standard modules, if a file called :file:`spam.pyc` exists in the " @@ -6855,7 +6848,7 @@ msgid "" "ignored if these don't match." msgstr "" -#: ../src/Doc/tutorial/modules.rst:187 +#: tutorial/modules.rst:187 msgid "" "Normally, you don't need to do anything to create the :file:`spam.pyc` file. " "Whenever :file:`spam.py` is successfully compiled, an attempt is made to " @@ -6867,11 +6860,11 @@ msgid "" "different architectures." msgstr "" -#: ../src/Doc/tutorial/modules.rst:195 +#: tutorial/modules.rst:195 msgid "Some tips for experts:" msgstr "Astuces pour les experts :" -#: ../src/Doc/tutorial/modules.rst:197 +#: tutorial/modules.rst:197 msgid "" "When the Python interpreter is invoked with the :option:`-O` flag, optimized " "code is generated and stored in :file:`.pyo` files. The optimizer currently " @@ -6880,7 +6873,7 @@ msgid "" "ignored and ``.py`` files are compiled to optimized bytecode." msgstr "" -#: ../src/Doc/tutorial/modules.rst:203 +#: tutorial/modules.rst:203 msgid "" "Passing two :option:`-O` flags to the Python interpreter (:option:`-OO`) " "will cause the bytecode compiler to perform optimizations that could in some " @@ -6890,7 +6883,7 @@ msgid "" "should only use this option if you know what you're doing." msgstr "" -#: ../src/Doc/tutorial/modules.rst:210 +#: tutorial/modules.rst:210 msgid "" "A program doesn't run any faster when it is read from a :file:`.pyc` or :" "file:`.pyo` file than when it is read from a :file:`.py` file; the only " @@ -6898,7 +6891,7 @@ msgid "" "with which they are loaded." msgstr "" -#: ../src/Doc/tutorial/modules.rst:215 +#: tutorial/modules.rst:215 msgid "" "When a script is run by giving its name on the command line, the bytecode " "for the script is never written to a :file:`.pyc` or :file:`.pyo` file. " @@ -6908,7 +6901,7 @@ msgid "" "the command line." msgstr "" -#: ../src/Doc/tutorial/modules.rst:222 +#: tutorial/modules.rst:222 msgid "" "It is possible to have a file called :file:`spam.pyc` (or :file:`spam.pyo` " "when :option:`-O` is used) without a file :file:`spam.py` for the same " @@ -6916,7 +6909,7 @@ msgid "" "that is moderately hard to reverse engineer." msgstr "" -#: ../src/Doc/tutorial/modules.rst:229 +#: tutorial/modules.rst:229 #, fuzzy msgid "" "The module :mod:`compileall` can create :file:`.pyc` files (or :file:`.pyo` " @@ -6925,12 +6918,12 @@ msgstr "" "Le module :mod:`compileall` permet de compiler tous les modules d'un dossier " "(et accepte aussi le paramètre :option:`-O`)." -#: ../src/Doc/tutorial/modules.rst:236 +#: tutorial/modules.rst:236 msgid "Standard Modules" msgstr "Modules standards" # 0572f328979e445b8f24801a89a1e2b0 -#: ../src/Doc/tutorial/modules.rst:240 +#: tutorial/modules.rst:240 msgid "" "Python comes with a library of standard modules, described in a separate " "document, the Python Library Reference (\"Library Reference\" hereafter). " @@ -6956,7 +6949,7 @@ msgstr "" "dans tous les interpréteurs Python. Les variables ``sys.ps1`` et ``sys.ps2`` " "définissent les chaînes d'invites principales et secondaires ::" -#: ../src/Doc/tutorial/modules.rst:263 +#: tutorial/modules.rst:263 msgid "" "These two variables are only defined if the interpreter is in interactive " "mode." @@ -6964,7 +6957,7 @@ msgstr "" "Ces deux variables ne sont définies que si l'interpréteur est en mode " "interactif." -#: ../src/Doc/tutorial/modules.rst:265 +#: tutorial/modules.rst:265 msgid "" "The variable ``sys.path`` is a list of strings that determines the " "interpreter's search path for modules. It is initialized to a default path " @@ -6979,11 +6972,11 @@ msgstr "" "``sys.path`` est modifiable en utilisant les opérations habituelles des " "listes ::" -#: ../src/Doc/tutorial/modules.rst:278 +#: tutorial/modules.rst:278 msgid "The :func:`dir` Function" msgstr "La fonction :func:`dir`" -#: ../src/Doc/tutorial/modules.rst:280 +#: tutorial/modules.rst:280 msgid "" "The built-in function :func:`dir` is used to find out which names a module " "defines. It returns a sorted list of strings::" @@ -6991,12 +6984,12 @@ msgstr "" "La fonction interne :func:`dir` est utilisée pour trouver quels noms sont " "définies par un module. Elle donne une liste triée de chaînes :;" -#: ../src/Doc/tutorial/modules.rst:303 +#: tutorial/modules.rst:303 msgid "" "Without arguments, :func:`dir` lists the names you have defined currently::" msgstr "Sans paramètres, :func:`dir` listes les noms actuellement définis ::" -#: ../src/Doc/tutorial/modules.rst:311 +#: tutorial/modules.rst:311 msgid "" "Note that it lists all types of names: variables, modules, functions, etc." msgstr "" @@ -7004,7 +6997,7 @@ msgstr "" "etc." # 38ddad117ec74e9885481c252bed3daf -#: ../src/Doc/tutorial/modules.rst:315 +#: tutorial/modules.rst:315 #, fuzzy msgid "" ":func:`dir` does not list the names of built-in functions and variables. If " @@ -7014,11 +7007,11 @@ msgstr "" ":func:`dir` ne liste ni les fonctions primitives ni les variables internes. " "Si vous voulez les lister, ils sont définis dans le module :mod:`builtins` ::" -#: ../src/Doc/tutorial/modules.rst:352 +#: tutorial/modules.rst:352 msgid "Packages" msgstr "Les paquets" -#: ../src/Doc/tutorial/modules.rst:354 +#: tutorial/modules.rst:354 msgid "" "Packages are a way of structuring Python's module namespace by using " "\"dotted module names\". For example, the module name :mod:`A.B` designates " @@ -7038,7 +7031,7 @@ msgstr "" "\" d'avoir à se soucier des noms des modules des autres." # 0c3e2b19ba7c46b3a367e0649f5bcace -#: ../src/Doc/tutorial/modules.rst:362 +#: tutorial/modules.rst:362 msgid "" "Suppose you want to design a collection of modules (a \"package\") for the " "uniform handling of sound files and sound data. There are many different " @@ -7065,7 +7058,7 @@ msgstr "" "Voici une structure possible pour votre paquet (exprimée comme un système de " "fichier, hierarchiquement) :" -#: ../src/Doc/tutorial/modules.rst:399 +#: tutorial/modules.rst:399 msgid "" "When importing the package, Python searches through the directories on ``sys." "path`` looking for the package subdirectory." @@ -7073,7 +7066,7 @@ msgstr "" "Lorsqu'il importe des paquets, Python cherche dans chaque dossiers de ``sys." "path``, à la recherche du dossier du paquet." -#: ../src/Doc/tutorial/modules.rst:402 +#: tutorial/modules.rst:402 msgid "" "The :file:`__init__.py` files are required to make Python treat the " "directories as containing packages; this is done to prevent directories with " @@ -7091,7 +7084,7 @@ msgstr "" "d'initialisation pour son paquet ou configurer la variable ``__all__`` " "(documentée plus loin)." -#: ../src/Doc/tutorial/modules.rst:409 +#: tutorial/modules.rst:409 msgid "" "Users of the package can import individual modules from the package, for " "example::" @@ -7099,7 +7092,7 @@ msgstr "" "Les utilisateurs d'un module peuvent importer ses modules individuellement, " "par exemple ::" -#: ../src/Doc/tutorial/modules.rst:414 +#: tutorial/modules.rst:414 msgid "" "This loads the submodule :mod:`sound.effects.echo`. It must be referenced " "with its full name. ::" @@ -7107,11 +7100,11 @@ msgstr "" "Chargera le sous-module :mod:`sound.effects.echo`. Il dit être référencé par " "son nom complet. ::" -#: ../src/Doc/tutorial/modules.rst:419 +#: tutorial/modules.rst:419 msgid "An alternative way of importing the submodule is::" msgstr "Une autre manière d'importer des sous-modules est ::" -#: ../src/Doc/tutorial/modules.rst:423 +#: tutorial/modules.rst:423 msgid "" "This also loads the submodule :mod:`echo`, and makes it available without " "its package prefix, so it can be used as follows::" @@ -7119,7 +7112,7 @@ msgstr "" "Chargera aussi le sous-module :mod:`echo`, et le rendra disponible dans le " "préfixe du paquet, il peut donc être utilisé comme ça ::" -#: ../src/Doc/tutorial/modules.rst:428 +#: tutorial/modules.rst:428 msgid "" "Yet another variation is to import the desired function or variable " "directly::" @@ -7127,7 +7120,7 @@ msgstr "" "Une autre méthode consisterait à importer la fonction ou variable désirée " "directement ::" -#: ../src/Doc/tutorial/modules.rst:432 +#: tutorial/modules.rst:432 msgid "" "Again, this loads the submodule :mod:`echo`, but this makes its function :" "func:`echofilter` directly available::" @@ -7135,7 +7128,7 @@ msgstr "" "Le sous-module :mod:`echo` est toujours chargé, mais ici la fonction :func:" "`echofilter` est disponible directement ::" -#: ../src/Doc/tutorial/modules.rst:437 +#: tutorial/modules.rst:437 msgid "" "Note that when using ``from package import item``, the item can be either a " "submodule (or subpackage) of the package, or some other name defined in the " @@ -7151,7 +7144,7 @@ msgstr "" "ne l'est pas, elle cherche à charger un module, et si elle n'y arrive pas, " "une exception `ImportError` est levée." -#: ../src/Doc/tutorial/modules.rst:444 +#: tutorial/modules.rst:444 msgid "" "Contrarily, when using syntax like ``import item.subitem.subsubitem``, each " "item except for the last must be a package; the last item can be a module or " @@ -7163,11 +7156,11 @@ msgstr "" "dernier ``item`` peut être un module ou un paquet, mais ne peut être ni une " "fonction, ni une classe, ni une variable défini dans l'élément précédent." -#: ../src/Doc/tutorial/modules.rst:453 +#: tutorial/modules.rst:453 msgid "Importing \\* From a Package" msgstr "Importer \\* depuis un paquet" -#: ../src/Doc/tutorial/modules.rst:457 +#: tutorial/modules.rst:457 msgid "" "Now what happens when the user writes ``from sound.effects import *``? " "Ideally, one would hope that this somehow goes out to the filesystem, finds " @@ -7183,7 +7176,7 @@ msgstr "" "module est importé explicitement." # 8f1258abef7b47319a5ab764ae9e7512 -#: ../src/Doc/tutorial/modules.rst:463 +#: tutorial/modules.rst:463 msgid "" "The only solution is for the package author to provide an explicit index of " "the package. The :keyword:`import` statement uses the following convention: " @@ -7205,7 +7198,7 @@ msgstr "" "décider de ne pas autoriser d'importer ``*`` de leur paquet. Par exemple, le " "fichier :file:`sound/effects/__init__.py` peut contenir le code suivant ::" -#: ../src/Doc/tutorial/modules.rst:475 +#: tutorial/modules.rst:475 msgid "" "This would mean that ``from sound.effects import *`` would import the three " "named submodules of the :mod:`sound` package." @@ -7213,7 +7206,7 @@ msgstr "" "Cela signifierai que ``from sound.effects import *`` importait les trois " "sous-modules du paquet :mod:`sound`." -#: ../src/Doc/tutorial/modules.rst:478 +#: tutorial/modules.rst:478 msgid "" "If ``__all__`` is not defined, the statement ``from sound.effects import *`` " "does *not* import all submodules from the package :mod:`sound.effects` into " @@ -7235,7 +7228,7 @@ msgstr "" "modules du paquet ayant été chargés explicitement par une instruction :" "keyword:`import`. Typiquement ::" -#: ../src/Doc/tutorial/modules.rst:491 +#: tutorial/modules.rst:491 msgid "" "In this example, the :mod:`echo` and :mod:`surround` modules are imported in " "the current namespace because they are defined in the :mod:`sound.effects` " @@ -7247,7 +7240,7 @@ msgstr "" "qu'ils sont définis dans le paquet :mod:`sound.effects`. (Cela fonctionne " "lorsque ``__all__`` est défini.)" -#: ../src/Doc/tutorial/modules.rst:496 +#: tutorial/modules.rst:496 msgid "" "Although certain modules are designed to export only names that follow " "certain patterns when you use ``import *``, it is still considered bad " @@ -7257,7 +7250,7 @@ msgstr "" "respectant une certaine structure lorsque ``import *`` est utilisé, ``import " "*`` reste considéré comme une mauvaise pratique." -#: ../src/Doc/tutorial/modules.rst:500 +#: tutorial/modules.rst:500 msgid "" "Remember, there is nothing wrong with using ``from Package import " "specific_submodule``! In fact, this is the recommended notation unless the " @@ -7269,12 +7262,12 @@ msgstr "" "le module qui fait les imports ai besoin de sous-modules ayant le même nom " "mais provenant se paquets différents." -#: ../src/Doc/tutorial/modules.rst:507 +#: tutorial/modules.rst:507 msgid "Intra-package References" msgstr "Références internes dans un paquet" # 20ba5d3273454eefa50529336214baa5 -#: ../src/Doc/tutorial/modules.rst:509 +#: tutorial/modules.rst:509 msgid "" "The submodules often need to refer to each other. For example, the :mod:" "`surround` module might use the :mod:`echo` module. In fact, such " @@ -7287,7 +7280,7 @@ msgid "" "name." msgstr "" -#: ../src/Doc/tutorial/modules.rst:518 +#: tutorial/modules.rst:518 msgid "" "When packages are structured into subpackages (as with the :mod:`sound` " "package in the example), you can use absolute imports to refer to submodules " @@ -7302,7 +7295,7 @@ msgstr "" "utiliser ``from sound.effects import echo``." # 82c84536e5f94eb8ad4f365cde80af40 -#: ../src/Doc/tutorial/modules.rst:524 +#: tutorial/modules.rst:524 msgid "" "Starting with Python 2.5, in addition to the implicit relative imports " "described above, you can write explicit relative imports with the ``from " @@ -7313,7 +7306,7 @@ msgid "" msgstr "" # 0a545e217ccb4074a3817733279c812b -#: ../src/Doc/tutorial/modules.rst:534 +#: tutorial/modules.rst:534 #, fuzzy msgid "" "Note that both explicit and implicit relative imports are based on the name " @@ -7326,11 +7319,11 @@ msgstr "" "par le module principal d'une application ne peuvent être importées que par " "des imports absolus." -#: ../src/Doc/tutorial/modules.rst:541 +#: tutorial/modules.rst:541 msgid "Packages in Multiple Directories" msgstr "Paquets dans plusieurs dossiers" -#: ../src/Doc/tutorial/modules.rst:543 +#: tutorial/modules.rst:543 msgid "" "Packages support one more special attribute, :attr:`__path__`. This is " "initialized to be a list containing the name of the directory holding the " @@ -7344,7 +7337,7 @@ msgstr "" "être modifiée, altérant ainsi les futures recherches de modules et sous-" "paquets contenus dans le paquet." -#: ../src/Doc/tutorial/modules.rst:549 +#: tutorial/modules.rst:549 msgid "" "While this feature is not often needed, it can be used to extend the set of " "modules found in a package." @@ -7353,7 +7346,7 @@ msgstr "" "élargir la liste des modules trouvés dans un paquet." # 718bdfb2db00454588feb7477e850abf -#: ../src/Doc/tutorial/modules.rst:555 +#: tutorial/modules.rst:555 msgid "" "In fact function definitions are also 'statements' that are 'executed'; the " "execution of a module-level function definition enters the function name in " @@ -7363,15 +7356,15 @@ msgstr "" "sont l'exécution enregistre le nom de la fonction dans la table des symboles " "globaux du module." -#: ../src/Doc/tutorial/stdlib.rst:5 +#: tutorial/stdlib.rst:5 msgid "Brief Tour of the Standard Library" msgstr "Survol de la Bibliothèque Standard" -#: ../src/Doc/tutorial/stdlib.rst:11 +#: tutorial/stdlib.rst:11 msgid "Operating System Interface" msgstr "Interface avec le Système d'Exploitation" -#: ../src/Doc/tutorial/stdlib.rst:13 +#: tutorial/stdlib.rst:13 msgid "" "The :mod:`os` module provides dozens of functions for interacting with the " "operating system::" @@ -7379,7 +7372,7 @@ msgstr "" "Le modules :mod:`os` propose pléthore fonctions pour interagir avec le " "système d'exploitation ::" -#: ../src/Doc/tutorial/stdlib.rst:23 +#: tutorial/stdlib.rst:23 msgid "" "Be sure to use the ``import os`` style instead of ``from os import *``. " "This will keep :func:`os.open` from shadowing the built-in :func:`open` " @@ -7389,7 +7382,7 @@ msgstr "" "quoi :func:`os.open` cacherait la primitive :func:`open`, qui fonctionne " "différemment." -#: ../src/Doc/tutorial/stdlib.rst:29 +#: tutorial/stdlib.rst:29 msgid "" "The built-in :func:`dir` and :func:`help` functions are useful as " "interactive aids for working with large modules like :mod:`os`::" @@ -7397,7 +7390,7 @@ msgstr "" "Les primitives :func:`dir` et :func:`help` sont des outils utiles lorsque " "vous travaillez en mode interactif avez des gros modules comme :mod:`os` ::" -#: ../src/Doc/tutorial/stdlib.rst:38 +#: tutorial/stdlib.rst:38 msgid "" "For daily file and directory management tasks, the :mod:`shutil` module " "provides a higher level interface that is easier to use::" @@ -7405,11 +7398,11 @@ msgstr "" "Pour la gestion des fichiers et dossiers, le module :mod:`shutil` expose une " "interface plus abstraite et plus facile à utiliser ::" -#: ../src/Doc/tutorial/stdlib.rst:49 +#: tutorial/stdlib.rst:49 msgid "File Wildcards" msgstr "Jokers sur les noms de Fichiers" -#: ../src/Doc/tutorial/stdlib.rst:51 +#: tutorial/stdlib.rst:51 msgid "" "The :mod:`glob` module provides a function for making file lists from " "directory wildcard searches::" @@ -7417,11 +7410,11 @@ msgstr "" "Le module :mod:`glob` fournit une fonction pour construire des listes de " "fichiers à partir de motifs ::" -#: ../src/Doc/tutorial/stdlib.rst:62 +#: tutorial/stdlib.rst:62 msgid "Command Line Arguments" msgstr "Paramètres en ligne de Commande" -#: ../src/Doc/tutorial/stdlib.rst:64 +#: tutorial/stdlib.rst:64 msgid "" "Common utility scripts often need to process command line arguments. These " "arguments are stored in the :mod:`sys` module's *argv* attribute as a list. " @@ -7434,7 +7427,7 @@ msgstr "" "l'affichage suivant vient de l'exécution de ``python demo.py one two three`` " "depuis la ligne de commande ::" -#: ../src/Doc/tutorial/stdlib.rst:73 +#: tutorial/stdlib.rst:73 msgid "" "The :mod:`getopt` module processes *sys.argv* using the conventions of the " "Unix :func:`getopt` function. More powerful and flexible command line " @@ -7445,11 +7438,11 @@ msgstr "" "des paramètres de la ligne de commande plus flexibles et avancés sont " "disponibles dnas le module :mod:`argparse`." -#: ../src/Doc/tutorial/stdlib.rst:81 +#: tutorial/stdlib.rst:81 msgid "Error Output Redirection and Program Termination" msgstr "Redirection de la sortie d'erreur et fin d'exécution" -#: ../src/Doc/tutorial/stdlib.rst:83 +#: tutorial/stdlib.rst:83 msgid "" "The :mod:`sys` module also has attributes for *stdin*, *stdout*, and " "*stderr*. The latter is useful for emitting warnings and error messages to " @@ -7459,16 +7452,16 @@ msgstr "" "*stderr*. Ce dernier est utile pour émettre des messages d'avertissement ou " "d'erreur qui restent visibles même si *stdout* est redirigé ::" -#: ../src/Doc/tutorial/stdlib.rst:90 +#: tutorial/stdlib.rst:90 msgid "The most direct way to terminate a script is to use ``sys.exit()``." msgstr "" "Le moyen le plus direct de terminer un script est d'utiliser ``sys.exit()``." -#: ../src/Doc/tutorial/stdlib.rst:96 +#: tutorial/stdlib.rst:96 msgid "String Pattern Matching" msgstr "Recherche de motifs dans les Chaînes" -#: ../src/Doc/tutorial/stdlib.rst:98 +#: tutorial/stdlib.rst:98 msgid "" "The :mod:`re` module provides regular expression tools for advanced string " "processing. For complex matching and manipulation, regular expressions offer " @@ -7480,7 +7473,7 @@ msgstr "" "motifs complexes, ou effectuer des remplacements complexes dans les " "chaînes ::" -#: ../src/Doc/tutorial/stdlib.rst:108 +#: tutorial/stdlib.rst:108 msgid "" "When only simple capabilities are needed, string methods are preferred " "because they are easier to read and debug::" @@ -7488,11 +7481,11 @@ msgstr "" "Lorsque les opérations sont simples, il est préférable d'utiliser les " "méthodes des chaînes, elles sont plus lisibles et plus facile à débugger ::" -#: ../src/Doc/tutorial/stdlib.rst:118 +#: tutorial/stdlib.rst:118 msgid "Mathematics" msgstr "Mathématiques" -#: ../src/Doc/tutorial/stdlib.rst:120 +#: tutorial/stdlib.rst:120 msgid "" "The :mod:`math` module gives access to the underlying C library functions " "for floating point math::" @@ -7500,18 +7493,18 @@ msgstr "" "Le module :mod:`math` expose des fonctions d'opération sur les \"float* de " "la bibliothèque C ::" -#: ../src/Doc/tutorial/stdlib.rst:129 +#: tutorial/stdlib.rst:129 msgid "The :mod:`random` module provides tools for making random selections::" msgstr "" "Le module :mod:`random` offre des outils pour faire des sélections " "aléatoires ::" -#: ../src/Doc/tutorial/stdlib.rst:145 +#: tutorial/stdlib.rst:145 msgid "Internet Access" msgstr "Accès à internet" # 621033cc072a4a8da88740058de8f289 -#: ../src/Doc/tutorial/stdlib.rst:147 +#: tutorial/stdlib.rst:147 #, fuzzy msgid "" "There are a number of modules for accessing the internet and processing " @@ -7523,17 +7516,17 @@ msgstr "" "`urllib.request`, qui permet de télécharger à partir d'une URL, et :mod:" "`smtplib` pour envoyer des emails ::" -#: ../src/Doc/tutorial/stdlib.rst:168 +#: tutorial/stdlib.rst:168 msgid "(Note that the second example needs a mailserver running on localhost.)" msgstr "" "(Notez que le deuxième exemple a besoin d'un serveur mail tournant " "localement.)" -#: ../src/Doc/tutorial/stdlib.rst:174 +#: tutorial/stdlib.rst:174 msgid "Dates and Times" msgstr "Dates et heures" -#: ../src/Doc/tutorial/stdlib.rst:176 +#: tutorial/stdlib.rst:176 msgid "" "The :mod:`datetime` module supplies classes for manipulating dates and times " "in both simple and complex ways. While date and time arithmetic is " @@ -7547,11 +7540,11 @@ msgstr "" "l'accès aux propriétés, le formatage et la manipulation. Le module gère " "aussi les objets conscients des fuseaux horaires ::" -#: ../src/Doc/tutorial/stdlib.rst:200 +#: tutorial/stdlib.rst:200 msgid "Data Compression" msgstr "Compression de donnée" -#: ../src/Doc/tutorial/stdlib.rst:202 +#: tutorial/stdlib.rst:202 #, fuzzy msgid "" "Common data archiving and compression formats are directly supported by " @@ -7562,11 +7555,11 @@ msgstr "" "gérés par les modules :mod:`zlib`, :mod:`gzip`, :mod:`bz2`, :mod:`lzma`, :" "mod:`zipfile`, et :mod:`tarfile` ::" -#: ../src/Doc/tutorial/stdlib.rst:222 +#: tutorial/stdlib.rst:222 msgid "Performance Measurement" msgstr "Mesure des Performances" -#: ../src/Doc/tutorial/stdlib.rst:224 +#: tutorial/stdlib.rst:224 msgid "" "Some Python users develop a deep interest in knowing the relative " "performance of different approaches to the same problem. Python provides a " @@ -7576,7 +7569,7 @@ msgstr "" "performances de différentes approches d'un même problème. Python propose un " "outil de mesure répondant simplement à ces questions." -#: ../src/Doc/tutorial/stdlib.rst:228 +#: tutorial/stdlib.rst:228 msgid "" "For example, it may be tempting to use the tuple packing and unpacking " "feature instead of the traditional approach to swapping arguments. The :mod:" @@ -7587,7 +7580,7 @@ msgstr "" "traditionnelle. Le module :mod:`timeit` montre simplement laquelle est la " "plus efficace ::" -#: ../src/Doc/tutorial/stdlib.rst:238 +#: tutorial/stdlib.rst:238 msgid "" "In contrast to :mod:`timeit`'s fine level of granularity, the :mod:`profile` " "and :mod:`pstats` modules provide tools for identifying time critical " @@ -7597,11 +7590,11 @@ msgstr "" "`pstats` fournissent des outils permettant d'identifier les parties les plus " "gourmandes en temps d'exécution dans des volumes de code plus grands." -#: ../src/Doc/tutorial/stdlib.rst:246 +#: tutorial/stdlib.rst:246 msgid "Quality Control" msgstr "Contrôle Qualité" -#: ../src/Doc/tutorial/stdlib.rst:248 +#: tutorial/stdlib.rst:248 msgid "" "One approach for developing high quality software is to write tests for each " "function as it is developed and to run those tests frequently during the " @@ -7612,7 +7605,7 @@ msgstr "" "développement, et d'exécuter ces tests fréquemment lors du processus de " "développement." -#: ../src/Doc/tutorial/stdlib.rst:252 +#: tutorial/stdlib.rst:252 msgid "" "The :mod:`doctest` module provides a tool for scanning a module and " "validating tests embedded in a program's docstrings. Test construction is " @@ -7626,7 +7619,7 @@ msgstr "" "résultat depuis le mode interactif. Cela améliore la documentation en " "fournissant des exemples tout en prouvant qu'ils sont justes ::" -#: ../src/Doc/tutorial/stdlib.rst:270 +#: tutorial/stdlib.rst:270 msgid "" "The :mod:`unittest` module is not as effortless as the :mod:`doctest` " "module, but it allows a more comprehensive set of tests to be maintained in " @@ -7636,11 +7629,11 @@ msgstr "" "il permet de construire un jeu de tests plus complet, maintenable, et " "compréhensible dans un fichier séparé ::" -#: ../src/Doc/tutorial/stdlib.rst:292 +#: tutorial/stdlib.rst:292 msgid "Batteries Included" msgstr "Piles Fournies" -#: ../src/Doc/tutorial/stdlib.rst:294 +#: tutorial/stdlib.rst:294 msgid "" "Python has a \"batteries included\" philosophy. This is best seen through " "the sophisticated and robust capabilities of its larger packages. For " @@ -7651,14 +7644,14 @@ msgstr "" "Par exemple:" # 1f0e345bae7b4a83861dd3cfabcc8448 -#: ../src/Doc/tutorial/stdlib.rst:297 +#: tutorial/stdlib.rst:297 msgid "" "The :mod:`xmlrpclib` and :mod:`SimpleXMLRPCServer` modules make implementing " "remote procedure calls into an almost trivial task. Despite the modules " "names, no direct knowledge or handling of XML is needed." msgstr "" -#: ../src/Doc/tutorial/stdlib.rst:301 +#: tutorial/stdlib.rst:301 msgid "" "The :mod:`email` package is a library for managing email messages, including " "MIME and other RFC 2822-based message documents. Unlike :mod:`smtplib` and :" @@ -7674,7 +7667,7 @@ msgstr "" "des structures de messages complexes (comprenant des pièces jointes), ou " "implémenter des encodages et protocoles." -#: ../src/Doc/tutorial/stdlib.rst:308 +#: tutorial/stdlib.rst:308 msgid "" "The :mod:`xml.dom` and :mod:`xml.sax` packages provide robust support for " "parsing this popular data interchange format. Likewise, the :mod:`csv` " @@ -7683,7 +7676,7 @@ msgid "" "between Python applications and other tools." msgstr "" -#: ../src/Doc/tutorial/stdlib.rst:314 +#: tutorial/stdlib.rst:314 msgid "" "Internationalization is supported by a number of modules including :mod:" "`gettext`, :mod:`locale`, and the :mod:`codecs` package." @@ -7691,11 +7684,11 @@ msgstr "" "L'internationalisation est possible grâce à moulte paquets, comme :mod:" "`gettext`, :mod:`locale`, ou :mod:`codecs`." -#: ../src/Doc/tutorial/stdlib2.rst:5 +#: tutorial/stdlib2.rst:5 msgid "Brief Tour of the Standard Library -- Part II" msgstr "Rapide tour de la Bibliothèque Standard -- Deuxième partie" -#: ../src/Doc/tutorial/stdlib2.rst:7 +#: tutorial/stdlib2.rst:7 msgid "" "This second tour covers more advanced modules that support professional " "programming needs. These modules rarely occur in small scripts." @@ -7703,12 +7696,12 @@ msgstr "" "Cette seconde visite vous fera découvrir des modules d'un usage plus " "professionnel. Ces modules sont rarement nécessaires dans de petits scripts." -#: ../src/Doc/tutorial/stdlib2.rst:14 +#: tutorial/stdlib2.rst:14 msgid "Output Formatting" msgstr "Formatage" # 20922d986c434cb78ddac80e1a60633b -#: ../src/Doc/tutorial/stdlib2.rst:16 +#: tutorial/stdlib2.rst:16 #, fuzzy msgid "" "The :mod:`repr` module provides a version of :func:`repr` customized for " @@ -7718,7 +7711,7 @@ msgstr "" "spécialisée dans l'affichage concis de conteneurs volumineux ou fortement " "imbriqués ::" -#: ../src/Doc/tutorial/stdlib2.rst:23 +#: tutorial/stdlib2.rst:23 msgid "" "The :mod:`pprint` module offers more sophisticated control over printing " "both built-in and user defined objects in a way that is readable by the " @@ -7731,7 +7724,7 @@ msgstr "" "est séparé sur plusieurs lignes et indenté pour rendre la structure plus " "visible ::" -#: ../src/Doc/tutorial/stdlib2.rst:39 +#: tutorial/stdlib2.rst:39 msgid "" "The :mod:`textwrap` module formats paragraphs of text to fit a given screen " "width::" @@ -7739,7 +7732,7 @@ msgstr "" "Le module :mod:`textwrap` formatte des paragraphes de texte pour tenir sur " "un écran d'une largeur donnée ::" -#: ../src/Doc/tutorial/stdlib2.rst:53 +#: tutorial/stdlib2.rst:53 msgid "" "The :mod:`locale` module accesses a database of culture specific data " "formats. The grouping attribute of locale's format function provides a " @@ -7749,12 +7742,12 @@ msgstr "" "spécifique à chaque région. L'attribut ``grouping`` de la fonction de " "formattage permet de formater directement des nombres avec un séparateur ::" -#: ../src/Doc/tutorial/stdlib2.rst:72 +#: tutorial/stdlib2.rst:72 msgid "Templating" msgstr "Gabarits (Templates)" # dc541a6f18e54caaa2101a76a6b5d13e -#: ../src/Doc/tutorial/stdlib2.rst:74 +#: tutorial/stdlib2.rst:74 msgid "" "The :mod:`string` module includes a versatile :class:`~string.Template` " "class with a simplified syntax suitable for editing by end-users. This " @@ -7767,7 +7760,7 @@ msgstr "" "développeurs. Cela permet donc à vous utilisateurs de personnaliser leur " "application sans la modifier." -#: ../src/Doc/tutorial/stdlib2.rst:78 +#: tutorial/stdlib2.rst:78 msgid "" "The format uses placeholder names formed by ``$`` with valid Python " "identifiers (alphanumeric characters and underscores). Surrounding the " @@ -7782,7 +7775,7 @@ msgstr "" "$``." # 0f345ca7b4ad4fcfbe5c7bc89e145880 -#: ../src/Doc/tutorial/stdlib2.rst:88 +#: tutorial/stdlib2.rst:88 msgid "" "The :meth:`~string.Template.substitute` method raises a :exc:`KeyError` when " "a placeholder is not supplied in a dictionary or a keyword argument. For " @@ -7797,7 +7790,7 @@ msgstr "" "safe_substitute` est plus appropriée car elle laissera tel quel les " "marqueurs manquants ::" -#: ../src/Doc/tutorial/stdlib2.rst:103 +#: tutorial/stdlib2.rst:103 msgid "" "Template subclasses can specify a custom delimiter. For example, a batch " "renaming utility for a photo browser may elect to use percent signs for " @@ -7809,7 +7802,7 @@ msgstr "" "symbole pourcent comme marqueur pour, par exemple, la date actuelle, le " "numéro de l'image, ou son format ::" -#: ../src/Doc/tutorial/stdlib2.rst:125 +#: tutorial/stdlib2.rst:125 msgid "" "Another application for templating is separating program logic from the " "details of multiple output formats. This makes it possible to substitute " @@ -7819,12 +7812,12 @@ msgstr "" "les détails spécifiques à chaque format de sortie. Il est possible de " "générer de cette manière des fichiers XML, texte, HTML, ..." -#: ../src/Doc/tutorial/stdlib2.rst:133 +#: tutorial/stdlib2.rst:133 msgid "Working with Binary Data Record Layouts" msgstr "Travailler avec des données binaires" # ecdb9e781e96479390eae1e533a9729e -#: ../src/Doc/tutorial/stdlib2.rst:135 +#: tutorial/stdlib2.rst:135 msgid "" "The :mod:`struct` module provides :func:`~struct.pack` and :func:`~struct." "unpack` functions for working with variable length binary record formats. " @@ -7841,11 +7834,11 @@ msgstr "" "et quatre octets. Le ``\"<\"`` indique qu'ils ont une taille standard et " "dans le style petit-boutiste." -#: ../src/Doc/tutorial/stdlib2.rst:164 +#: tutorial/stdlib2.rst:164 msgid "Multi-threading" msgstr "Threads" -#: ../src/Doc/tutorial/stdlib2.rst:166 +#: tutorial/stdlib2.rst:166 msgid "" "Threading is a technique for decoupling tasks which are not sequentially " "dependent. Threads can be used to improve the responsiveness of " @@ -7860,7 +7853,7 @@ msgstr "" "usage typique est de séparer sur deux threads distincts les I/O (entrées / " "sorties) et le calcul." -#: ../src/Doc/tutorial/stdlib2.rst:171 +#: tutorial/stdlib2.rst:171 msgid "" "The following code shows how the high level :mod:`threading` module can run " "tasks in background while the main program continues to run::" @@ -7869,7 +7862,7 @@ msgstr "" "exécutant des tâches en arrière plan pendant que le programme principal " "continue de s'exécuter ::" -#: ../src/Doc/tutorial/stdlib2.rst:194 +#: tutorial/stdlib2.rst:194 msgid "" "The principal challenge of multi-threaded applications is coordinating " "threads that share data or other resources. To that end, the threading " @@ -7883,7 +7876,7 @@ msgstr "" "conditionnelles (condition variables), et les sémaphores." # 5b0b88c3eb2844fa903eb3e3ff72d79b -#: ../src/Doc/tutorial/stdlib2.rst:199 +#: tutorial/stdlib2.rst:199 #, fuzzy msgid "" "While those tools are powerful, minor design errors can result in problems " @@ -7902,11 +7895,11 @@ msgstr "" "`~queue.Queue` pour leurs communication et coordination entre threads sont " "plus simples à concevoir, plus lisible, et plus fiables." -#: ../src/Doc/tutorial/stdlib2.rst:210 +#: tutorial/stdlib2.rst:210 msgid "Logging" msgstr "Journalisation" -#: ../src/Doc/tutorial/stdlib2.rst:212 +#: tutorial/stdlib2.rst:212 msgid "" "The :mod:`logging` module offers a full featured and flexible logging " "system. At its simplest, log messages are sent to a file or to ``sys." @@ -7917,12 +7910,12 @@ msgstr "" "un fichier ou sur ``sys.stderr`` ::" # 5d44183c6fb0489091fbd795f42c8dab -#: ../src/Doc/tutorial/stdlib2.rst:222 +#: tutorial/stdlib2.rst:222 msgid "This produces the following output:" msgstr "Produisant l'affichage suivant :" # 4451a96b39044ca9a34bfc37d5e15a2d -#: ../src/Doc/tutorial/stdlib2.rst:230 +#: tutorial/stdlib2.rst:230 msgid "" "By default, informational and debugging messages are suppressed and the " "output is sent to standard error. Other output options include routing " @@ -7939,7 +7932,7 @@ msgstr "" "`~logging.INFO`, :const:`~logging.WARNING`, :const:`~logging.ERROR`, et :" "const:`~logging.CRITICAL`." -#: ../src/Doc/tutorial/stdlib2.rst:237 +#: tutorial/stdlib2.rst:237 msgid "" "The logging system can be configured directly from Python or can be loaded " "from a user editable configuration file for customized logging without " @@ -7948,11 +7941,11 @@ msgstr "" "depuis un fichier de configuration, permettant de personnaliser le log sans " "modifier l'application." -#: ../src/Doc/tutorial/stdlib2.rst:245 +#: tutorial/stdlib2.rst:245 msgid "Weak References" msgstr "Références faibles" -#: ../src/Doc/tutorial/stdlib2.rst:247 +#: tutorial/stdlib2.rst:247 msgid "" "Python does automatic memory management (reference counting for most objects " "and :term:`garbage collection` to eliminate cycles). The memory is freed " @@ -7963,7 +7956,7 @@ msgstr "" "pour éliminer les cycles). La mémoire est libérée rapidement lorsque sa " "dernière référence est perdue." -#: ../src/Doc/tutorial/stdlib2.rst:251 +#: tutorial/stdlib2.rst:251 msgid "" "This approach works fine for most applications but occasionally there is a " "need to track objects only as long as they are being used by something else. " @@ -7984,11 +7977,11 @@ msgstr "" "(callback) est appelée. Un exemple typique est le cache d'objets coûteux à " "créer ::" -#: ../src/Doc/tutorial/stdlib2.rst:286 +#: tutorial/stdlib2.rst:286 msgid "Tools for Working with Lists" msgstr "Outils pour travailler avec des listes" -#: ../src/Doc/tutorial/stdlib2.rst:288 +#: tutorial/stdlib2.rst:288 msgid "" "Many data structure needs can be met with the built-in list type. However, " "sometimes there is a need for alternative implementations with different " @@ -7999,7 +7992,7 @@ msgstr "" "ayant des caractéristiques différentes, typiquement en terme de performance." # 8151b144d69d4e5b923a9b04e58f445a -#: ../src/Doc/tutorial/stdlib2.rst:292 +#: tutorial/stdlib2.rst:292 msgid "" "The :mod:`array` module provides an :class:`~array.array()` object that is " "like a list that stores only homogeneous data and stores it more compactly. " @@ -8014,7 +8007,7 @@ msgstr "" "comme l'aurais fait une liste classique ::" # 88ac3346818c4236a3a4fcd5b0a7f3b0 -#: ../src/Doc/tutorial/stdlib2.rst:305 +#: tutorial/stdlib2.rst:305 msgid "" "The :mod:`collections` module provides a :class:`~collections.deque()` " "object that is like a list with faster appends and pops from the left side " @@ -8027,7 +8020,7 @@ msgstr "" "milieu. C'est objets sont particulièrement adaptés pour construire des " "queues ou des algorithme de parcours d'arbre en largeur ::" -#: ../src/Doc/tutorial/stdlib2.rst:326 +#: tutorial/stdlib2.rst:326 msgid "" "In addition to alternative list implementations, the library also offers " "other tools such as the :mod:`bisect` module with functions for manipulating " @@ -8037,7 +8030,7 @@ msgstr "" "bibliothèque fournit des outils tels que :mod:`bisect`, un module contenant " "des fonctions de manipulation de listes triées ::" -#: ../src/Doc/tutorial/stdlib2.rst:336 +#: tutorial/stdlib2.rst:336 msgid "" "The :mod:`heapq` module provides functions for implementing heaps based on " "regular lists. The lowest valued entry is always kept at position zero. " @@ -8049,12 +8042,12 @@ msgstr "" "(indice 0). C'est utile dans les cas où l'application souvent besoin de " "trouver l'élément le plus petit sans trier entièrement la liste ::" -#: ../src/Doc/tutorial/stdlib2.rst:352 +#: tutorial/stdlib2.rst:352 msgid "Decimal Floating Point Arithmetic" msgstr "Arithmétique décimale à Virgule Flottante" # 1310d96aa0b3487a80a410ced6503e4e -#: ../src/Doc/tutorial/stdlib2.rst:354 +#: tutorial/stdlib2.rst:354 msgid "" "The :mod:`decimal` module offers a :class:`~decimal.Decimal` datatype for " "decimal floating point arithmetic. Compared to the built-in :class:`float` " @@ -8065,7 +8058,7 @@ msgstr "" "flottante. Par rapport à la classe native :class:`float`, elle est " "particulièrement utile pour" -#: ../src/Doc/tutorial/stdlib2.rst:358 +#: tutorial/stdlib2.rst:358 msgid "" "financial applications and other uses which require exact decimal " "representation," @@ -8073,21 +8066,21 @@ msgstr "" "les application traitant de finance est autres usages nécessitant une " "représentation décimale exacte," -#: ../src/Doc/tutorial/stdlib2.rst:360 +#: tutorial/stdlib2.rst:360 msgid "control over precision," msgstr "contrôle sur la précision, " -#: ../src/Doc/tutorial/stdlib2.rst:361 +#: tutorial/stdlib2.rst:361 msgid "control over rounding to meet legal or regulatory requirements," msgstr "" "contrôle sur les arrondis pour correspondre aux obligations légales ou du " "régulateur," -#: ../src/Doc/tutorial/stdlib2.rst:362 +#: tutorial/stdlib2.rst:362 msgid "tracking of significant decimal places, or" msgstr "suivre les décimales significatives, ou" -#: ../src/Doc/tutorial/stdlib2.rst:363 +#: tutorial/stdlib2.rst:363 msgid "" "applications where the user expects the results to match calculations done " "by hand." @@ -8095,7 +8088,7 @@ msgstr "" "les applications avec lesquelles l'utilisateur attend des résultats " "identiques aux calculs faits à la main." -#: ../src/Doc/tutorial/stdlib2.rst:366 +#: tutorial/stdlib2.rst:366 msgid "" "For example, calculating a 5% tax on a 70 cent phone charge gives different " "results in decimal floating point and binary floating point. The difference " @@ -8107,7 +8100,7 @@ msgstr "" "près ::" # ef886201e784491dbacb38684b1c056d -#: ../src/Doc/tutorial/stdlib2.rst:379 +#: tutorial/stdlib2.rst:379 msgid "" "The :class:`~decimal.Decimal` result keeps a trailing zero, automatically " "inferring four place significance from multiplicands with two place " @@ -8124,7 +8117,7 @@ msgstr "" "quantités décimales." # c19c2c8bbcf94f47b5e5b98d181ffbcf -#: ../src/Doc/tutorial/stdlib2.rst:385 +#: tutorial/stdlib2.rst:385 msgid "" "Exact representation enables the :class:`~decimal.Decimal` class to perform " "modulo calculations and equality tests that are unsuitable for binary " @@ -8134,7 +8127,7 @@ msgstr "" "faire des calculs du modulo ou des tests d'égalité qui ne seraient pas " "possibles avec des virgules flottantes binaires ::" -#: ../src/Doc/tutorial/stdlib2.rst:399 +#: tutorial/stdlib2.rst:399 msgid "" "The :mod:`decimal` module provides arithmetic with as much precision as " "needed::" @@ -8142,11 +8135,11 @@ msgstr "" "Le module :mod:`decimal` permet de faire des calculs avec autant de " "précision que nécessaire ::" -#: ../src/Doc/tutorial/whatnow.rst:5 +#: tutorial/whatnow.rst:5 msgid "What Now?" msgstr "Et Maintenant ?" -#: ../src/Doc/tutorial/whatnow.rst:7 +#: tutorial/whatnow.rst:7 msgid "" "Reading this tutorial has probably reinforced your interest in using Python " "--- you should be eager to apply Python to solving your real-world problems. " @@ -8156,7 +8149,7 @@ msgstr "" "l'utiliser pour résoudre des vrais problèmes. Ou devriez vous aller pour en " "apprendre plus ?" -#: ../src/Doc/tutorial/whatnow.rst:11 +#: tutorial/whatnow.rst:11 msgid "" "This tutorial is part of Python's documentation set. Some other documents " "in the set are:" @@ -8164,11 +8157,11 @@ msgstr "" "Ce tutoriel fait partie de la documentation de Python, mais la documentation " "de Python est vaste ::" -#: ../src/Doc/tutorial/whatnow.rst:14 +#: tutorial/whatnow.rst:14 msgid ":ref:`library-index`:" msgstr ":ref:`library-index`:" -#: ../src/Doc/tutorial/whatnow.rst:16 +#: tutorial/whatnow.rst:16 msgid "" "You should browse through this manual, which gives complete (though terse) " "reference material about types, functions, and the modules in the standard " @@ -8187,7 +8180,7 @@ msgstr "" "et plein d'autres tâches. Vous balader dans la documentation de la " "bibliothèque vous donnera une idée de ce qui est disponnible." -#: ../src/Doc/tutorial/whatnow.rst:24 +#: tutorial/whatnow.rst:24 #, fuzzy msgid "" ":ref:`install-index` explains how to install external modules written by " @@ -8196,7 +8189,7 @@ msgstr "" ":ref:`installing-index` explique comment installer des paquets écrits par " "d'autres utilisateurs de Python." -#: ../src/Doc/tutorial/whatnow.rst:27 +#: tutorial/whatnow.rst:27 msgid "" ":ref:`reference-index`: A detailed explanation of Python's syntax and " "semantics. It's heavy reading, but is useful as a complete guide to the " @@ -8206,12 +8199,12 @@ msgstr "" "sémantique de Python. C'est une lecture fastidieuse, mais qui a sa place " "dans une documentation exhaustive." -#: ../src/Doc/tutorial/whatnow.rst:31 +#: tutorial/whatnow.rst:31 msgid "More Python resources:" msgstr "D'autres ressources:" # d10cebd2bc97492488f5f335751d7f9f -#: ../src/Doc/tutorial/whatnow.rst:33 +#: tutorial/whatnow.rst:33 msgid "" "https://www.python.org: The major Python Web site. It contains code, " "documentation, and pointers to Python-related pages around the Web. This " @@ -8227,7 +8220,7 @@ msgstr "" "dépend d'où vous vous situez." # ef4dce91b88f4be895ce894dae4c3ac1 -#: ../src/Doc/tutorial/whatnow.rst:39 +#: tutorial/whatnow.rst:39 msgid "https://docs.python.org: Fast access to Python's documentation." msgstr "" "https://docs.python.org: Un accès rapide à la documentation de Python en " @@ -8235,7 +8228,7 @@ msgstr "" "org/doc/python)" # 1bc5b0b2722b4b73a301218b55c823a9 -#: ../src/Doc/tutorial/whatnow.rst:41 +#: tutorial/whatnow.rst:41 msgid "" "https://pypi.python.org/pypi: The Python Package Index, previously also " "nicknamed the Cheese Shop, is an index of user-created Python modules that " @@ -8250,7 +8243,7 @@ msgstr "" "le trouver." # c5c8fa10010b4c049a4cc8e3ef708395 -#: ../src/Doc/tutorial/whatnow.rst:46 +#: tutorial/whatnow.rst:46 msgid "" "http://code.activestate.com/recipes/langs/python/: The Python Cookbook is a " "sizable collection of code examples, larger modules, and useful scripts. " @@ -8263,7 +8256,7 @@ msgstr "" "livre appelé \"Python Cookbook\" (O'Reilly & Associates, ISBN 0-596-00797-3.)" # fba35de8bfaa4de4990c57775317239c -#: ../src/Doc/tutorial/whatnow.rst:51 +#: tutorial/whatnow.rst:51 msgid "" "For Python-related questions and problem reports, you can post to the " "newsgroup :newsgroup:`comp.lang.python`, or send them to the mailing list at " @@ -8278,6 +8271,23 @@ msgid "" "for your problem." msgstr "" +# ce8381976b434e66b7c5471cd5d43209 +#~ msgid "" +#~ "To change a sequence you are iterating over while inside the loop (for " +#~ "example to duplicate certain items), it is recommended that you first " +#~ "make a copy. Looping over a sequence does not implicitly make a copy. " +#~ "The slice notation makes this especially convenient::" +#~ msgstr "" +#~ "Si vous devez modifier une séquence sur laquelle vous êtes en train de " +#~ "faire une boucle (par exemple pour dupliquer ou supprimer certains " +#~ "éléments), il est recommandé de commencer par en faire une copie. Celle-" +#~ "ci n'est pas implicite lorsque vous faites une boucle sur une séquence. " +#~ "La notation par tranches rend cette opération particulièrement pratique ::" + +#, fuzzy +#~ msgid ":ref:`string-formatting`" +#~ msgstr "Anciennes méthodes de formatage de chaînes" + #~ msgid "A value can be assigned to several variables simultaneously::" #~ msgstr "" #~ "Une valeur peut être affectée à plusieurs variables simultanément ::" diff --git a/using.po b/using.po index c8bf368d..632095b7 100644 --- a/using.po +++ b/using.po @@ -7,21 +7,21 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-03 09:23\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/using/cmdline.rst:9 +#: using/cmdline.rst:9 msgid "Command line and environment" msgstr "Ligne de commande et environnement" -#: ../src/Doc/using/cmdline.rst:11 +#: using/cmdline.rst:11 msgid "" "The CPython interpreter scans the command line and the environment for " "various settings." @@ -31,7 +31,7 @@ msgstr "" # We’re speaking about the command line of other Python implementations, not # other implementatons of command lines. -#: ../src/Doc/using/cmdline.rst:16 +#: using/cmdline.rst:16 msgid "" "Other implementations' command line schemes may differ. See :ref:" "`implementations` for further resources." @@ -39,28 +39,28 @@ msgstr "" "Le format des lignes de commandes utilisées par d'autres implémentations " "peut être différent. Voir :ref:`implementations` pour plus d'informations." -#: ../src/Doc/using/cmdline.rst:23 +#: using/cmdline.rst:23 msgid "Command line" msgstr "Ligne de commande" -#: ../src/Doc/using/cmdline.rst:25 +#: using/cmdline.rst:25 msgid "When invoking Python, you may specify any of these options::" msgstr "" "Quand vous invoquez Python, vous pouvez spécifier n’importe laquelle de ces " "options :" -#: ../src/Doc/using/cmdline.rst:29 +#: using/cmdline.rst:29 msgid "" "The most common use case is, of course, a simple invocation of a script::" msgstr "" "Le cas d'utilisation le plus courant est, bien entendu, la simple invocation " "d'un script ::" -#: ../src/Doc/using/cmdline.rst:37 +#: using/cmdline.rst:37 msgid "Interface options" msgstr "Options de l'interface" -#: ../src/Doc/using/cmdline.rst:39 +#: using/cmdline.rst:39 msgid "" "The interpreter interface resembles that of the UNIX shell, but provides " "some additional methods of invocation:" @@ -68,18 +68,20 @@ msgstr "" "L'interface de l’interpréteur ressemble à celle du shell UNIX, mais fournit " "quelques méthodes d'invocation supplémentaires :" -#: ../src/Doc/using/cmdline.rst:42 +#: using/cmdline.rst:42 +#, fuzzy msgid "" "When called with standard input connected to a tty device, it prompts for " "commands and executes them until an EOF (an end-of-file character, you can " -"produce that with *Ctrl-D* on UNIX or *Ctrl-Z, Enter* on Windows) is read." +"produce that with :kbd:`Ctrl-D` on UNIX or :kbd:`Ctrl-Z, Enter` on Windows) " +"is read." msgstr "" "Quand l'interpréteur est appelé avec l'entrée standard connectée à un " "périphérique tty, il lit les lignes de commande et les exécute jusqu'à ce " "qu'un caractère EOF (un caractère fin de fichier, que vous pouvez produire " "avec *Ctrl-D* sous UNIX ou *Ctrl-Z, Entrée* sous Windows) soit lu." -#: ../src/Doc/using/cmdline.rst:45 +#: using/cmdline.rst:45 msgid "" "When called with a file name argument or with a file as standard input, it " "reads and executes a script from that file." @@ -88,7 +90,7 @@ msgstr "" "fichier ou avec un fichier comme entrée standard, il lit et exécute le " "script contenu dans ce fichier." -#: ../src/Doc/using/cmdline.rst:47 +#: using/cmdline.rst:47 msgid "" "When called with a directory name argument, it reads and executes an " "appropriately named script from that directory." @@ -97,7 +99,7 @@ msgstr "" "répertoire, il lit et exécute un script nommé d’une certaine façon depuis ce " "répertoire." -#: ../src/Doc/using/cmdline.rst:49 +#: using/cmdline.rst:49 msgid "" "When called with ``-c command``, it executes the Python statement(s) given " "as *command*. Here *command* may contain multiple statements separated by " @@ -108,7 +110,7 @@ msgstr "" "contenir plusieurs instructions séparées par des fins de ligne. Les blancs " "en début de ligne ne sont pas ignorés dans les instructions Python !" -#: ../src/Doc/using/cmdline.rst:52 +#: using/cmdline.rst:52 msgid "" "When called with ``-m module-name``, the given module is located on the " "Python module path and executed as a script." @@ -117,13 +119,13 @@ msgstr "" "module donné est recherché dans le chemin des modules Python et est exécuté " "en tant que script." -#: ../src/Doc/using/cmdline.rst:55 +#: using/cmdline.rst:55 msgid "" "In non-interactive mode, the entire input is parsed before it is executed." msgstr "" "En mode non-interactif, toute l’entrée est analysée avant d’être exécutée. " -#: ../src/Doc/using/cmdline.rst:57 +#: using/cmdline.rst:57 msgid "" "An interface option terminates the list of options consumed by the " "interpreter, all consecutive arguments will end up in :data:`sys.argv` -- " @@ -135,7 +137,7 @@ msgstr "" "que le premier élément, à l'indice zéro (``sys.argv|0]``), est une chaîne de " "caractères indiquant la source du programme." -#: ../src/Doc/using/cmdline.rst:64 +#: using/cmdline.rst:64 #, fuzzy msgid "" "Execute the Python code in *command*. *command* can be one or more " @@ -146,7 +148,7 @@ msgstr "" "plusieurs instructions, séparées par des fins de ligne, avec des blancs en " "début de ligne qui ne sont pas ignorés, comme dans le code d’un module." -#: ../src/Doc/using/cmdline.rst:68 +#: using/cmdline.rst:68 msgid "" "If this option is given, the first element of :data:`sys.argv` will be ``\"-c" "\"`` and the current directory will be added to the start of :data:`sys." @@ -158,7 +160,7 @@ msgstr "" "(permettant aux modules de ce répertoire d'être importé comme des modules de " "premier niveau)." -#: ../src/Doc/using/cmdline.rst:76 +#: using/cmdline.rst:76 msgid "" "Search :data:`sys.path` for the named module and execute its contents as " "the :mod:`__main__` module." @@ -166,7 +168,7 @@ msgstr "" "Parcourir :data:`sys.path` à la recherche du module donné et exécuter son " "contenu en tant que module :mod:`__main__`." -#: ../src/Doc/using/cmdline.rst:79 +#: using/cmdline.rst:79 msgid "" "Since the argument is a *module* name, you must not give a file extension " "(``.py``). The ``module-name`` should be a valid Python module name, but " @@ -178,7 +180,7 @@ msgstr "" "Python valide, mais l'implémentation n’est pas tenue de le vérifier (par " "exemple, l'utilisation d'un trait d'union peut être autorisée)." -#: ../src/Doc/using/cmdline.rst:84 +#: using/cmdline.rst:84 msgid "" "Package names are also permitted. When a package name is supplied instead of " "a normal module, the interpreter will execute ``<pkg>.__main__`` as the main " @@ -192,7 +194,7 @@ msgstr "" "un répertoire on un fichier zip donné à l'interpréteur comme argument à " "exécuter." -#: ../src/Doc/using/cmdline.rst:92 +#: using/cmdline.rst:92 msgid "" "This option cannot be used with built-in modules and extension modules " "written in C, since they do not have Python module files. However, it can " @@ -205,7 +207,7 @@ msgstr "" "pour les modules pré-complilés, même si le fichier source original n'est pas " "disponible." -#: ../src/Doc/using/cmdline.rst:97 +#: using/cmdline.rst:97 msgid "" "If this option is given, the first element of :data:`sys.argv` will be the " "full path to the module file. As with the :option:`-c` option, the current " @@ -215,7 +217,7 @@ msgstr "" "chemin complet d'accès au fichier du module. Comme pour l'option :option:`-" "c`, le répertoire courant sera ajouté au début de :data:`sys.path`." -#: ../src/Doc/using/cmdline.rst:101 +#: using/cmdline.rst:101 msgid "" "Many standard library modules contain code that is invoked on their " "execution as a script. An example is the :mod:`timeit` module::" @@ -224,11 +226,30 @@ msgstr "" "invoqué quand ils sont exécutés comme scripts. Un exemple est le module :mod:" "`timeit`\\ ::" -#: ../src/Doc/using/cmdline.rst:111 +#: using/cmdline.rst:109 +msgid "runpy.run_module()" +msgstr "" + +#: using/cmdline.rst:109 using/cmdline.rst:135 +msgid "Equivalent functionality directly available to Python code" +msgstr "" + +#: using/cmdline.rst:111 msgid ":pep:`338` -- Executing modules as scripts" msgstr ":pep:`338` -- Exécuter des modules en tant que scripts" -#: ../src/Doc/using/cmdline.rst:126 +#: using/cmdline.rst:115 +msgid "The named module can now be located inside a package." +msgstr "" + +#: using/cmdline.rst:118 +msgid "" +"Supply the package name to run a ``__main__`` submodule. sys.argv[0] is now " +"set to ``\"-m\"`` while searching for the module (it was previously " +"incorrectly set to ``\"-c\"``)" +msgstr "" + +#: using/cmdline.rst:126 msgid "" "Read commands from standard input (:data:`sys.stdin`). If standard input is " "a terminal, :option:`-i` is implied." @@ -236,7 +257,7 @@ msgstr "" "Lit les commandes depuis l'entrée standard (:data:`sys.stdin`). Si l'entrée " "standard est un terminal, l':option:`-i` est activée implicitement." -#: ../src/Doc/using/cmdline.rst:129 +#: using/cmdline.rst:129 #, fuzzy msgid "" "If this option is given, the first element of :data:`sys.argv` will be ``\"-" @@ -246,7 +267,11 @@ msgstr "" "Si cette option est donnée, le premier élément de :data:`sys.argv` sera ``\"-" "\"`` et le répertoire courant sera ajouté au début de :data:`sys.path`." -#: ../src/Doc/using/cmdline.rst:136 +#: using/cmdline.rst:134 +msgid "runpy.run_path()" +msgstr "" + +#: using/cmdline.rst:140 msgid "" "Execute the Python code contained in *script*, which must be a filesystem " "path (absolute or relative) referring to either a Python file, a directory " @@ -258,7 +283,7 @@ msgstr "" "un répertoire contenant un fichier ``__main__.py`` ou à un fichier zip " "contenant un fichier ``__main__.py``." -#: ../src/Doc/using/cmdline.rst:141 +#: using/cmdline.rst:145 msgid "" "If this option is given, the first element of :data:`sys.argv` will be the " "script name as given on the command line." @@ -266,7 +291,7 @@ msgstr "" "Si cette option est donnée, le premier élément de :data:`sys.argv` sera le " "nom du script comme donné sur la ligne de commande." -#: ../src/Doc/using/cmdline.rst:144 +#: using/cmdline.rst:148 #, fuzzy msgid "" "If the script name refers directly to a Python file, the directory " @@ -277,7 +302,7 @@ msgstr "" "contenant ce fichier est ajouté au début de :data:`sys.path`, et le fichier " "est exécuté en tant que module :mod:`__main__`." -#: ../src/Doc/using/cmdline.rst:148 +#: using/cmdline.rst:152 #, fuzzy msgid "" "If the script name refers to a directory or zipfile, the script name is " @@ -288,7 +313,13 @@ msgstr "" "du script est ajouté au début de :data:`sys.path` et le fichier ``__main__." "py`` à cet endroit est exécuté en tant que module :mod:`__main__`." -#: ../src/Doc/using/cmdline.rst:156 +#: using/cmdline.rst:156 +msgid "" +"Directories and zipfiles containing a ``__main__.py`` file at the top level " +"are now considered valid Python scripts." +msgstr "" + +#: using/cmdline.rst:160 #, fuzzy msgid "" "If no interface option is given, :option:`-i` is implied, ``sys.argv[0]`` is " @@ -299,29 +330,41 @@ msgstr "" "argv[0]`` est une chaine vide (``\"\"``) et le répertoire courant sera " "ajouté au début de :data:`sys.path`." -#: ../src/Doc/using/cmdline.rst:164 +#: using/cmdline.rst:164 +msgid ":ref:`tut-invoking`" +msgstr "" + +#: using/cmdline.rst:168 #, fuzzy msgid "Generic options" msgstr "Options génériques" -#: ../src/Doc/using/cmdline.rst:170 +#: using/cmdline.rst:174 #, fuzzy msgid "Print a short description of all command line options." msgstr "" "Affiche une brève description de toutes les options de ligne de commande." -#: ../src/Doc/using/cmdline.rst:179 +#: using/cmdline.rst:176 +msgid "The ``--help`` variant." +msgstr "" + +#: using/cmdline.rst:183 #, fuzzy msgid "Print the Python version number and exit. Example output could be::" msgstr "" "Imprimer le numéro de version de Python et termine. Exemple de sortie ::" -#: ../src/Doc/using/cmdline.rst:188 +#: using/cmdline.rst:187 +msgid "The ``--version`` variant." +msgstr "" + +#: using/cmdline.rst:192 #, fuzzy msgid "Miscellaneous options" msgstr "Options diverses" -#: ../src/Doc/using/cmdline.rst:192 +#: using/cmdline.rst:196 msgid "" "If given, Python won't try to write ``.pyc`` or ``.pyo`` files on the import " "of source modules. See also :envvar:`PYTHONDONTWRITEBYTECODE`." @@ -330,7 +373,7 @@ msgstr "" "l'importation des modules source. Voir aussi :envvar:" "`PYTHONDONTWRITEBYTECODE`." -#: ../src/Doc/using/cmdline.rst:200 +#: using/cmdline.rst:204 msgid "" "Turn on parser debugging output (for wizards only, depending on compilation " "options). See also :envvar:`PYTHONDEBUG`." @@ -338,7 +381,7 @@ msgstr "" "Activer la sortie de l'analyseur de débogage (pour les magiciens uniquement, " "en fonction des options de compilation). Voir aussi :envvar:`PYTHONDEBUG`." -#: ../src/Doc/using/cmdline.rst:206 +#: using/cmdline.rst:210 msgid "" "Ignore all :envvar:`PYTHON*` environment variables, e.g. :envvar:" "`PYTHONPATH` and :envvar:`PYTHONHOME`, that might be set." @@ -347,7 +390,7 @@ msgstr "" "exemple, :envvar:`PYTHONPATH` et :envvar:`PYTHONHOME`, qui pourraient être " "définies." -#: ../src/Doc/using/cmdline.rst:214 +#: using/cmdline.rst:218 msgid "" "When a script is passed as first argument or the :option:`-c` option is " "used, enter interactive mode after executing the script or the command, even " @@ -359,7 +402,7 @@ msgstr "" "la commande, même lorsque :data:`sys.stdin` ne semble pas être un terminal. " "Le fichier :envvar:`PYTHONSTARTUP` n'est pas lu." -#: ../src/Doc/using/cmdline.rst:219 +#: using/cmdline.rst:223 msgid "" "This can be useful to inspect global variables or a stack trace when a " "script raises an exception. See also :envvar:`PYTHONINSPECT`." @@ -368,7 +411,7 @@ msgstr "" "pile lorsque le script lève une exception. Voir aussi :envvar:" "`PYTHONINSPECT`." -#: ../src/Doc/using/cmdline.rst:225 +#: using/cmdline.rst:229 msgid "" "Turn on basic optimizations. This changes the filename extension for " "compiled (:term:`bytecode`) files from ``.pyc`` to ``.pyo``. See also :" @@ -378,66 +421,70 @@ msgstr "" "les fichiers compilés (:term:`bytecode`) de ``.pyc`` à ``.pyo``. Voir aussi :" "envvar:`PYTHONOPTIMIZE`." -#: ../src/Doc/using/cmdline.rst:232 +#: using/cmdline.rst:236 msgid "Discard docstrings in addition to the :option:`-O` optimizations." msgstr "" "Supprimer les docstrings en plus des optimisations réalisés par :option:`-O`." # 94c6c2637084497d9ab83151b8b52614 -#: ../src/Doc/using/cmdline.rst:237 +#: using/cmdline.rst:241 msgid "Division control. The argument must be one of the following:" msgstr "" -# 1e40126fc0494661ada9a27a891f3eb6 -#: ../src/Doc/using/cmdline.rst:238 -msgid "``old``" +#: using/cmdline.rst:243 +msgid "old" msgstr "" # 37484c1f109c4378b76e4e098b1e7367 -#: ../src/Doc/using/cmdline.rst:240 +#: using/cmdline.rst:244 msgid "division of int/int and long/long return an int or long (*default*)" msgstr "" -# 3430acd23a75433cbef671ed2138bfd2 -#: ../src/Doc/using/cmdline.rst:241 -msgid "``new``" +#: using/cmdline.rst:246 +msgid "new" msgstr "" # a37c3c602a824895b51fe5daaddd064a -#: ../src/Doc/using/cmdline.rst:242 +#: using/cmdline.rst:246 msgid "" "new division semantics, i.e. division of int/int and long/long returns a " "float" msgstr "" -# 8dadd32ab56d4bfe845094df1dd83b7e -#: ../src/Doc/using/cmdline.rst:243 -msgid "``warn``" +#: using/cmdline.rst:248 +msgid "warn" msgstr "" # 7e2e6d7338a44ef498170057b98b4b60 -#: ../src/Doc/using/cmdline.rst:245 +#: using/cmdline.rst:249 msgid "old division semantics with a warning for int/int and long/long" msgstr "" -# 54fa2cface2d440f864bb690a921b008 -#: ../src/Doc/using/cmdline.rst:246 -msgid "``warnall``" +#: using/cmdline.rst:251 +msgid "warnall" msgstr "" # 761a287edda34f5681035898c8a994ec -#: ../src/Doc/using/cmdline.rst:247 +#: using/cmdline.rst:251 msgid "" "old division semantics with a warning for all uses of the division operator" msgstr "" -#: ../src/Doc/using/cmdline.rst:253 +#: using/cmdline.rst:255 +msgid "Tools/scripts/fixdiv.py" +msgstr "" + +#: using/cmdline.rst:255 +msgid "for a use of ``warnall``" +msgstr "" + +#: using/cmdline.rst:257 #, fuzzy msgid ":pep:`238` -- Changing the division operator" msgstr ":pep:`230` -- Gestion des alertes" # 1c4b5fb66fd44155b1751babd4400d0e -#: ../src/Doc/using/cmdline.rst:258 +#: using/cmdline.rst:262 msgid "" "Turn on hash randomization, so that the :meth:`__hash__` values of str, " "bytes and datetime objects are \"salted\" with an unpredictable random " @@ -446,7 +493,7 @@ msgid "" msgstr "" # c09e07790ee84698a0c8b001e413833c -#: ../src/Doc/using/cmdline.rst:263 +#: using/cmdline.rst:267 msgid "" "This is intended to provide protection against a denial-of-service caused by " "carefully-chosen inputs that exploit the worst case performance of a dict " @@ -455,7 +502,7 @@ msgid "" msgstr "" # 733490d631a140b199953586435aa188 -#: ../src/Doc/using/cmdline.rst:268 +#: using/cmdline.rst:272 msgid "" "Changing hash values affects the order in which keys are retrieved from a " "dict. Although Python has never made guarantees about this ordering (and it " @@ -464,27 +511,26 @@ msgid "" "disabled by default." msgstr "" -#: ../src/Doc/using/cmdline.rst:274 +#: using/cmdline.rst:278 #, fuzzy msgid "See also :envvar:`PYTHONHASHSEED`." msgstr "Voir aussi :envvar:`PYTHONUNBUFFERED`." # I’m creating terminology here; where’s the mailing list to discuss such # stuff? -#: ../src/Doc/using/cmdline.rst:281 +#: using/cmdline.rst:285 #, fuzzy msgid "" "Don't add the :data:`user site-packages directory <site.USER_SITE>` to :data:" "`sys.path`." msgstr "Ne pas ajouter le répertoire spécifique de l’utilisateur à sys.path" -#: ../src/Doc/using/cmdline.rst:288 ../src/Doc/using/cmdline.rst:582 -#: ../src/Doc/using/cmdline.rst:596 +#: using/cmdline.rst:292 using/cmdline.rst:586 using/cmdline.rst:600 #, fuzzy msgid ":pep:`370` -- Per user site-packages directory" msgstr ":pep:`370` -- Répertoire site-packages par utilisateur " -#: ../src/Doc/using/cmdline.rst:293 +#: using/cmdline.rst:297 msgid "" "Disable the import of the module :mod:`site` and the site-dependent " "manipulations of :data:`sys.path` that it entails." @@ -492,7 +538,7 @@ msgstr "" "Désactiver l’importation du module :mod:`site` et les modifications de :data:" "`sys.path` spécifiques au site qu’elle implique." -#: ../src/Doc/using/cmdline.rst:299 +#: using/cmdline.rst:303 #, fuzzy msgid "" "Issue a warning when a source file mixes tabs and spaces for indentation in " @@ -503,14 +549,14 @@ msgstr "" "une erreur lorsque l'option est donné deux fois (:option:`-bb`)." # 3c7b9588e6c8480182b0b8f9624f3bee -#: ../src/Doc/using/cmdline.rst:306 +#: using/cmdline.rst:310 msgid "" "Force stdin, stdout and stderr to be totally unbuffered. On systems where " "it matters, also put stdin, stdout and stderr in binary mode." msgstr "" # 8744c14714224b76a4458f10ca6a8b6f -#: ../src/Doc/using/cmdline.rst:309 +#: using/cmdline.rst:313 msgid "" "Note that there is internal buffering in :meth:`file.readlines` and :ref:" "`bltin-file-objects` (``for line in sys.stdin``) which is not influenced by " @@ -518,11 +564,11 @@ msgid "" "readline` inside a ``while 1:`` loop." msgstr "" -#: ../src/Doc/using/cmdline.rst:314 +#: using/cmdline.rst:318 msgid "See also :envvar:`PYTHONUNBUFFERED`." msgstr "Voir aussi :envvar:`PYTHONUNBUFFERED`." -#: ../src/Doc/using/cmdline.rst:319 +#: using/cmdline.rst:323 msgid "" "Print a message each time a module is initialized, showing the place " "(filename or built-in module) from which it is loaded. When given twice (:" @@ -531,14 +577,14 @@ msgid "" "exit. See also :envvar:`PYTHONVERBOSE`." msgstr "" -#: ../src/Doc/using/cmdline.rst:328 +#: using/cmdline.rst:332 msgid "" "Warning control. Python's warning machinery by default prints warning " "messages to :data:`sys.stderr`. A typical warning message has the following " "form::" msgstr "" -#: ../src/Doc/using/cmdline.rst:334 +#: using/cmdline.rst:338 #, fuzzy msgid "" "By default, each warning is printed once for each source line where it " @@ -548,7 +594,7 @@ msgstr "" "source où elle se trouve. Cette option définit la fréquence d'affichage des " "avertissements." -#: ../src/Doc/using/cmdline.rst:337 +#: using/cmdline.rst:341 msgid "" "Multiple :option:`-W` options may be given; when a warning matches more than " "one option, the action for the last matching option is performed. Invalid :" @@ -557,19 +603,19 @@ msgid "" msgstr "" # 1fa3546b6b7143e0b6cd96bd12176331 -#: ../src/Doc/using/cmdline.rst:342 +#: using/cmdline.rst:346 msgid "" "Starting from Python 2.7, :exc:`DeprecationWarning` and its descendants are " "ignored by default. The :option:`-Wd` option can be used to re-enable them." msgstr "" -#: ../src/Doc/using/cmdline.rst:346 +#: using/cmdline.rst:350 msgid "" "Warnings can also be controlled from within a Python program using the :mod:" "`warnings` module." msgstr "" -#: ../src/Doc/using/cmdline.rst:349 +#: using/cmdline.rst:353 #, fuzzy msgid "" "The simplest form of argument is one of the following action strings (or a " @@ -578,33 +624,30 @@ msgstr "" "La forme la plus simple de l'argument est l'une des chaînes d'action " "suivante (ou une abréviation unique):" -# ef1c43473fcc4910b0ac780f07042fe6 -#: ../src/Doc/using/cmdline.rst:351 -msgid "``ignore``" +#: using/cmdline.rst:356 +msgid "ignore" msgstr "" -#: ../src/Doc/using/cmdline.rst:353 +#: using/cmdline.rst:357 #, fuzzy msgid "Ignore all warnings." msgstr "Ignorer tous les avertissements." -# 4765c4e6d8b541afac745383088c4dea -#: ../src/Doc/using/cmdline.rst:354 -msgid "``default``" +#: using/cmdline.rst:359 +msgid "default" msgstr "" -#: ../src/Doc/using/cmdline.rst:355 +#: using/cmdline.rst:359 msgid "" "Explicitly request the default behavior (printing each warning once per " "source line)." msgstr "" -# 4571161d17224831afc7b0f01f901eb2 -#: ../src/Doc/using/cmdline.rst:358 -msgid "``all``" +#: using/cmdline.rst:363 +msgid "all" msgstr "" -#: ../src/Doc/using/cmdline.rst:358 +#: using/cmdline.rst:362 #, fuzzy msgid "" "Print a warning each time it occurs (this may generate many messages if a " @@ -615,46 +658,43 @@ msgstr "" "beaucoup de messages si l'avertissement est déclenchée à plusieurs reprises " "pour la ligne du même source, comme à l'intérieur d'une boucle)." -# a473fcb6ce434a39bba0cbdaf435fe16 -#: ../src/Doc/using/cmdline.rst:360 -msgid "``module``" +#: using/cmdline.rst:365 +msgid "module" msgstr "" -#: ../src/Doc/using/cmdline.rst:362 +#: using/cmdline.rst:366 #, fuzzy msgid "Print each warning only the first time it occurs in each module." msgstr "" "Affiche chaque avertissement uniquement la première fois qu'il apparaît dans " "chaque module." -# 7ec2df586e9d4113a28c445dbbc19f51 -#: ../src/Doc/using/cmdline.rst:362 -msgid "``once``" +#: using/cmdline.rst:367 +msgid "once" msgstr "" -#: ../src/Doc/using/cmdline.rst:364 +#: using/cmdline.rst:368 #, fuzzy msgid "Print each warning only the first time it occurs in the program." msgstr "" "Affiche chaque avertissement uniquement la première fois qu'il apparaît dans " "le programme." -# 39c94bdc9cbf48548d087f2fc0098412 -#: ../src/Doc/using/cmdline.rst:365 -msgid "``error``" +#: using/cmdline.rst:370 +msgid "error" msgstr "" -#: ../src/Doc/using/cmdline.rst:366 +#: using/cmdline.rst:370 #, fuzzy msgid "Raise an exception instead of printing a warning message." msgstr "Déclenche une exception au lieu d'afficher un message d'avertissement." -#: ../src/Doc/using/cmdline.rst:368 +#: using/cmdline.rst:372 #, fuzzy msgid "The full form of argument is::" msgstr "La forme complète de l'argument est le suivant::" -#: ../src/Doc/using/cmdline.rst:372 +#: using/cmdline.rst:376 #, fuzzy msgid "" "Here, *action* is as explained above but only applies to messages that match " @@ -681,45 +721,49 @@ msgstr "" "correspond au numéro de ligne, où zéro correspond à n'importe quel numéro de " "ligne et correspond donc à l'option par défaut." -#: ../src/Doc/using/cmdline.rst:386 +#: using/cmdline.rst:388 +msgid ":mod:`warnings` -- the warnings module" +msgstr "" + +#: using/cmdline.rst:390 msgid ":pep:`230` -- Warning framework" msgstr ":pep:`230` -- Gestion des alertes" -#: ../src/Doc/using/cmdline.rst:388 +#: using/cmdline.rst:392 msgid ":envvar:`PYTHONWARNINGS`" msgstr "" -#: ../src/Doc/using/cmdline.rst:393 +#: using/cmdline.rst:397 msgid "" "Skip the first line of the source, allowing use of non-Unix forms of ``#!" "cmd``. This is intended for a DOS specific hack only." msgstr "" -#: ../src/Doc/using/cmdline.rst:396 +#: using/cmdline.rst:400 #, fuzzy msgid "The line numbers in error messages will be off by one." msgstr "" "Les numéros de ligne dans les messages d'erreur seront désactivés un par un." # 16d31aead63946b8a0d575367dc8770c -#: ../src/Doc/using/cmdline.rst:400 +#: using/cmdline.rst:404 msgid "" "Warn about Python 3.x possible incompatibilities by emitting a :exc:" "`DeprecationWarning` for features that are removed or significantly changed " "in Python 3." msgstr "" -#: ../src/Doc/using/cmdline.rst:407 +#: using/cmdline.rst:411 msgid "Options you shouldn't use" msgstr "Options que vous ne devriez pas utiliser" -#: ../src/Doc/using/cmdline.rst:411 +#: using/cmdline.rst:415 #, fuzzy msgid "Reserved for use by Jython_." msgstr "Utilisation réservée à Jython_." # ba6096add9df45259bbb1575b33f3ba6 -#: ../src/Doc/using/cmdline.rst:417 +#: using/cmdline.rst:421 msgid "" "Turns all string literals into unicodes globally. Do not be tempted to use " "this option as it will probably break your world. It also produces ``.pyc`` " @@ -728,22 +772,22 @@ msgid "" msgstr "" # 394bf96946ad4fd99939122b721737f8 -#: ../src/Doc/using/cmdline.rst:424 +#: using/cmdline.rst:428 msgid "at the top of the file. See :mod:`__future__` for details." msgstr "" -#: ../src/Doc/using/cmdline.rst:428 +#: using/cmdline.rst:432 msgid "" "Reserved for alternative implementations of Python to use for their own " "purposes." msgstr "" -#: ../src/Doc/using/cmdline.rst:434 +#: using/cmdline.rst:438 msgid "Environment variables" msgstr "Variables d'environnement" # 19254a82e1564d93ab7b6e6863669d0a -#: ../src/Doc/using/cmdline.rst:436 +#: using/cmdline.rst:440 msgid "" "These environment variables influence Python's behavior, they are processed " "before the command-line switches other than -E. It is customary that " @@ -751,7 +795,7 @@ msgid "" "conflict." msgstr "" -#: ../src/Doc/using/cmdline.rst:443 +#: using/cmdline.rst:447 msgid "" "Change the location of the standard Python libraries. By default, the " "libraries are searched in :file:`{prefix}/lib/python{version}` and :file:" @@ -760,14 +804,14 @@ msgid "" "file:`/usr/local`." msgstr "" -#: ../src/Doc/using/cmdline.rst:449 +#: using/cmdline.rst:453 msgid "" "When :envvar:`PYTHONHOME` is set to a single directory, its value replaces " "both :file:`{prefix}` and :file:`{exec_prefix}`. To specify different " "values for these, set :envvar:`PYTHONHOME` to :file:`{prefix}:{exec_prefix}`." msgstr "" -#: ../src/Doc/using/cmdline.rst:456 +#: using/cmdline.rst:460 msgid "" "Augment the default search path for module files. The format is the same as " "the shell's :envvar:`PATH`: one or more directory pathnames separated by :" @@ -775,21 +819,21 @@ msgid "" "existent directories are silently ignored." msgstr "" -#: ../src/Doc/using/cmdline.rst:461 +#: using/cmdline.rst:465 msgid "" "In addition to normal directories, individual :envvar:`PYTHONPATH` entries " "may refer to zipfiles containing pure Python modules (in either source or " "compiled form). Extension modules cannot be imported from zipfiles." msgstr "" -#: ../src/Doc/using/cmdline.rst:465 +#: using/cmdline.rst:469 msgid "" "The default search path is installation dependent, but generally begins " "with :file:`{prefix}/lib/python{version}` (see :envvar:`PYTHONHOME` above). " "It is *always* appended to :envvar:`PYTHONPATH`." msgstr "" -#: ../src/Doc/using/cmdline.rst:469 +#: using/cmdline.rst:473 msgid "" "An additional directory will be inserted in the search path in front of :" "envvar:`PYTHONPATH` as described above under :ref:`using-on-interface-" @@ -797,7 +841,7 @@ msgid "" "the variable :data:`sys.path`." msgstr "" -#: ../src/Doc/using/cmdline.rst:477 +#: using/cmdline.rst:481 msgid "" "If this is the name of a readable file, the Python commands in that file are " "executed before the first prompt is displayed in interactive mode. The file " @@ -807,7 +851,7 @@ msgid "" "and :data:`sys.ps2` in this file." msgstr "" -#: ../src/Doc/using/cmdline.rst:487 +#: using/cmdline.rst:491 msgid "" "Set this to a non-empty string to cause the :mod:`time` module to require " "dates specified as strings to include 4-digit years, otherwise 2-digit years " @@ -815,39 +859,39 @@ msgid "" "documentation." msgstr "" -#: ../src/Doc/using/cmdline.rst:495 +#: using/cmdline.rst:499 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-O` option. If set to an integer, it is equivalent to specifying :" "option:`-O` multiple times." msgstr "" -#: ../src/Doc/using/cmdline.rst:502 +#: using/cmdline.rst:506 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-d` option. If set to an integer, it is equivalent to specifying :" "option:`-d` multiple times." msgstr "" -#: ../src/Doc/using/cmdline.rst:509 +#: using/cmdline.rst:513 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-i` option." msgstr "" -#: ../src/Doc/using/cmdline.rst:512 +#: using/cmdline.rst:516 msgid "" "This variable can also be modified by Python code using :data:`os.environ` " "to force inspect mode on program termination." msgstr "" -#: ../src/Doc/using/cmdline.rst:518 +#: using/cmdline.rst:522 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-u` option." msgstr "" -#: ../src/Doc/using/cmdline.rst:524 +#: using/cmdline.rst:528 msgid "" "If this is set to a non-empty string it is equivalent to specifying the :" "option:`-v` option. If set to an integer, it is equivalent to specifying :" @@ -855,13 +899,13 @@ msgid "" msgstr "" # c2aaa1d2cdb84e188d6232c9a151305d -#: ../src/Doc/using/cmdline.rst:531 +#: using/cmdline.rst:535 msgid "" "If this is set, Python ignores case in :keyword:`import` statements. This " "only works on Windows, OS X, OS/2, and RiscOS." msgstr "" -#: ../src/Doc/using/cmdline.rst:537 +#: using/cmdline.rst:541 #, fuzzy msgid "" "If this is set, Python won't try to write ``.pyc`` or ``.pyo`` files on the " @@ -873,7 +917,7 @@ msgstr "" "`PYTHONDONTWRITEBYTECODE`." # 35d2f0e8b80e4fe5a1bbc71bbffeab84 -#: ../src/Doc/using/cmdline.rst:545 +#: using/cmdline.rst:549 msgid "" "If this variable is set to ``random``, the effect is the same as specifying " "the :option:`-R` option: a random value is used to seed the hashes of str, " @@ -881,7 +925,7 @@ msgid "" msgstr "" # 41745b6e056d4ab7a5181bd73b3cea2d -#: ../src/Doc/using/cmdline.rst:549 +#: using/cmdline.rst:553 msgid "" "If :envvar:`PYTHONHASHSEED` is set to an integer value, it is used as a " "fixed seed for generating the hash() of the types covered by the hash " @@ -889,7 +933,7 @@ msgid "" msgstr "" # 1fda512382bc4de880e82cc4acec0819 -#: ../src/Doc/using/cmdline.rst:553 +#: using/cmdline.rst:557 msgid "" "Its purpose is to allow repeatable hashing, such as for selftests for the " "interpreter itself, or to allow a cluster of python processes to share hash " @@ -897,14 +941,14 @@ msgid "" msgstr "" # f8d510c44bf04e98a502e57ad8c83c67 -#: ../src/Doc/using/cmdline.rst:557 +#: using/cmdline.rst:561 msgid "" "The integer must be a decimal number in the range [0,4294967295]. Specifying " "the value 0 will lead to the same hash values as when hash randomization is " "disabled." msgstr "" -#: ../src/Doc/using/cmdline.rst:566 +#: using/cmdline.rst:570 msgid "" "Overrides the encoding used for stdin/stdout/stderr, in the syntax " "``encodingname:errorhandler``. The ``:errorhandler`` part is optional and " @@ -912,14 +956,14 @@ msgid "" msgstr "" # 9dfcee31ea7649f08697696fc07c173c -#: ../src/Doc/using/cmdline.rst:575 +#: using/cmdline.rst:579 msgid "" "If this is set, Python won't add the :data:`user site-packages directory " "<site.USER_SITE>` to :data:`sys.path`." msgstr "" # 442082906a77463ea4e57b10f16f2123 -#: ../src/Doc/using/cmdline.rst:587 +#: using/cmdline.rst:591 msgid "" "Defines the :data:`user base directory <site.USER_BASE>`, which is used to " "compute the path of the :data:`user site-packages directory <site." @@ -927,67 +971,71 @@ msgid "" "for ``python setup.py install --user``." msgstr "" -#: ../src/Doc/using/cmdline.rst:601 +#: using/cmdline.rst:605 msgid "" "If this environment variable is set, ``sys.argv[0]`` will be set to its " "value instead of the value got through the C runtime. Only works on Mac OS " "X." msgstr "" -#: ../src/Doc/using/cmdline.rst:607 +#: using/cmdline.rst:611 msgid "" "This is equivalent to the :option:`-W` option. If set to a comma separated " "string, it is equivalent to specifying :option:`-W` multiple times." msgstr "" -#: ../src/Doc/using/cmdline.rst:613 +#: using/cmdline.rst:617 msgid "Debug-mode variables" msgstr "" # 39751a2d43d442baa3c22af05ce21c61 -#: ../src/Doc/using/cmdline.rst:615 +#: using/cmdline.rst:619 msgid "" "Setting these variables only has an effect in a debug build of Python, that " "is, if Python was configured with the ``--with-pydebug`` build option." msgstr "" -#: ../src/Doc/using/cmdline.rst:620 +#: using/cmdline.rst:624 msgid "If set, Python will print threading debug info." msgstr "" -#: ../src/Doc/using/cmdline.rst:627 +#: using/cmdline.rst:626 +msgid "Previously, this variable was called ``THREADDEBUG``." +msgstr "" + +#: using/cmdline.rst:631 msgid "" "If set, Python will dump objects and reference counts still alive after " "shutting down the interpreter." msgstr "" -#: ../src/Doc/using/cmdline.rst:633 +#: using/cmdline.rst:637 msgid "" "If set, Python will print memory allocation statistics every time a new " "object arena is created, and on shutdown." msgstr "" # cc6cf10288e14cac87acf1f21eab2c34 -#: ../src/Doc/using/index.rst:5 +#: using/index.rst:5 msgid "Python Setup and Usage" msgstr "Installation et Utilisation de Python [en]" -#: ../src/Doc/using/index.rst:8 +#: using/index.rst:8 msgid "" "This part of the documentation is devoted to general information on the " "setup of the Python environment on different platform, the invocation of the " "interpreter and things that make working with Python easier." msgstr "" -#: ../src/Doc/using/mac.rst:6 +#: using/mac.rst:6 msgid "Using Python on a Macintosh" msgstr "" -#: ../src/Doc/using/mac.rst:8 +#: using/mac.rst:8 msgid "Bob Savage <bobsavage@mac.com>" msgstr "" -#: ../src/Doc/using/mac.rst:11 +#: using/mac.rst:11 msgid "" "Python on a Macintosh running Mac OS X is in principle very similar to " "Python on any other Unix platform, but there are a number of additional " @@ -995,13 +1043,13 @@ msgid "" msgstr "" # f38f1d9a53374397a0671624c6c8769b -#: ../src/Doc/using/mac.rst:15 +#: using/mac.rst:15 msgid "" "The Mac-specific modules are documented in :ref:`mac-specific-services`." msgstr "" # f1a1bd88f7584b7489fc5c9657adda2b -#: ../src/Doc/using/mac.rst:17 +#: using/mac.rst:17 msgid "" "Python on Mac OS 9 or earlier can be quite different from Python on Unix or " "Windows, but is beyond the scope of this manual, as that platform is no " @@ -1010,12 +1058,12 @@ msgid "" "documentation." msgstr "" -#: ../src/Doc/using/mac.rst:26 +#: using/mac.rst:26 msgid "Getting and Installing MacPython" msgstr "" # f5664d366ade4410be0459a42855a126 -#: ../src/Doc/using/mac.rst:28 +#: using/mac.rst:28 msgid "" "Mac OS X 10.8 comes with Python 2.7 pre-installed by Apple. If you wish, " "you are invited to install the most recent version of Python from the Python " @@ -1024,12 +1072,12 @@ msgid "" "available there." msgstr "" -#: ../src/Doc/using/mac.rst:33 +#: using/mac.rst:33 msgid "What you get after installing is a number of things:" msgstr "" # 2bb67a78acb544d1bb27fc4716d24f30 -#: ../src/Doc/using/mac.rst:35 +#: using/mac.rst:35 msgid "" "A :file:`MacPython 2.7` folder in your :file:`Applications` folder. In here " "you find IDLE, the development environment that is a standard part of " @@ -1038,7 +1086,7 @@ msgid "" "you to package Python scripts as standalone applications on your system." msgstr "" -#: ../src/Doc/using/mac.rst:41 +#: using/mac.rst:41 msgid "" "A framework :file:`/Library/Frameworks/Python.framework`, which includes the " "Python executable and libraries. The installer adds this location to your " @@ -1046,7 +1094,7 @@ msgid "" "things. A symlink to the Python executable is placed in /usr/local/bin/." msgstr "" -#: ../src/Doc/using/mac.rst:46 +#: using/mac.rst:46 msgid "" "The Apple-provided build of Python is installed in :file:`/System/Library/" "Frameworks/Python.framework` and :file:`/usr/bin/python`, respectively. You " @@ -1057,24 +1105,24 @@ msgid "" "important that your paths and usages are consistent with what you want to do." msgstr "" -#: ../src/Doc/using/mac.rst:54 +#: using/mac.rst:54 msgid "" "IDLE includes a help menu that allows you to access Python documentation. If " "you are completely new to Python you should start reading the tutorial " "introduction in that document." msgstr "" -#: ../src/Doc/using/mac.rst:58 +#: using/mac.rst:58 msgid "" "If you are familiar with Python on other Unix platforms you should read the " "section on running Python scripts from the Unix shell." msgstr "" -#: ../src/Doc/using/mac.rst:63 +#: using/mac.rst:63 msgid "How to run a Python script" msgstr "" -#: ../src/Doc/using/mac.rst:65 +#: using/mac.rst:65 msgid "" "Your best way to get started with Python on Mac OS X is through the IDLE " "integrated development environment, see section :ref:`ide` and use the Help " @@ -1082,7 +1130,7 @@ msgid "" msgstr "" # a717b57af2d543b3a80072ece2689be2 -#: ../src/Doc/using/mac.rst:69 +#: using/mac.rst:69 msgid "" "If you want to run Python scripts from the Terminal window command line or " "from the Finder you first need an editor to create your script. Mac OS X " @@ -1095,21 +1143,21 @@ msgid "" "org/)." msgstr "" -#: ../src/Doc/using/mac.rst:79 +#: using/mac.rst:79 msgid "" "To run your script from the Terminal window you must make sure that :file:`/" "usr/local/bin` is in your shell search path." msgstr "" -#: ../src/Doc/using/mac.rst:82 +#: using/mac.rst:82 msgid "To run your script from the Finder you have two options:" msgstr "" -#: ../src/Doc/using/mac.rst:84 +#: using/mac.rst:84 msgid "Drag it to :program:`PythonLauncher`" msgstr "" -#: ../src/Doc/using/mac.rst:86 +#: using/mac.rst:86 msgid "" "Select :program:`PythonLauncher` as the default application to open your " "script (or any .py script) through the finder Info window and double-click " @@ -1118,11 +1166,11 @@ msgid "" "invocation, or use its Preferences menu to change things globally." msgstr "" -#: ../src/Doc/using/mac.rst:96 +#: using/mac.rst:96 msgid "Running scripts with a GUI" msgstr "" -#: ../src/Doc/using/mac.rst:98 +#: using/mac.rst:98 msgid "" "With older versions of Python, there is one Mac OS X quirk that you need to " "be aware of: programs that talk to the Aqua window manager (in other words, " @@ -1131,75 +1179,75 @@ msgid "" msgstr "" # 67a70dbb0b3147e98cfa5b245562a105 -#: ../src/Doc/using/mac.rst:103 +#: using/mac.rst:103 msgid "" "With Python 2.7, you can use either :program:`python` or :program:`pythonw`." msgstr "" -#: ../src/Doc/using/mac.rst:107 +#: using/mac.rst:107 msgid "Configuration" msgstr "" -#: ../src/Doc/using/mac.rst:109 +#: using/mac.rst:109 msgid "" "Python on OS X honors all standard Unix environment variables such as :" "envvar:`PYTHONPATH`, but setting these variables for programs started from " "the Finder is non-standard as the Finder does not read your :file:`.profile` " -"or :file:`.cshrc` at startup. You need to create a file :file:`~ /.MacOSX/" +"or :file:`.cshrc` at startup. You need to create a file :file:`~/.MacOSX/" "environment.plist`. See Apple's Technical Document QA1067 for details." msgstr "" -#: ../src/Doc/using/mac.rst:115 +#: using/mac.rst:116 msgid "" "For more information on installation Python packages in MacPython, see " "section :ref:`mac-package-manager`." msgstr "" -#: ../src/Doc/using/mac.rst:122 +#: using/mac.rst:123 msgid "The IDE" msgstr "" # cfc128737ea9451fbaff794e73d40a51 -#: ../src/Doc/using/mac.rst:124 +#: using/mac.rst:125 msgid "" "MacPython ships with the standard IDLE development environment. A good " "introduction to using IDLE can be found at https://hkn.eecs.berkeley.edu/" "~dyoo/python/idle_intro/index.html." msgstr "" -#: ../src/Doc/using/mac.rst:132 +#: using/mac.rst:133 msgid "Installing Additional Python Packages" msgstr "" -#: ../src/Doc/using/mac.rst:134 +#: using/mac.rst:135 msgid "There are several methods to install additional Python packages:" msgstr "" -#: ../src/Doc/using/mac.rst:136 +#: using/mac.rst:137 msgid "" "Packages can be installed via the standard Python distutils mode (``python " "setup.py install``)." msgstr "" # f0b0de374bd24a5986a60ae03942bab2 -#: ../src/Doc/using/mac.rst:139 +#: using/mac.rst:140 msgid "" "Many packages can also be installed via the :program:`setuptools` extension " "or :program:`pip` wrapper, see https://pip.pypa.io/." msgstr "" -#: ../src/Doc/using/mac.rst:144 +#: using/mac.rst:145 msgid "GUI Programming on the Mac" msgstr "" -#: ../src/Doc/using/mac.rst:146 +#: using/mac.rst:147 msgid "" "There are several options for building GUI applications on the Mac with " "Python." msgstr "" # 890778cded3f4375b2fa0b0e281e8fd3 -#: ../src/Doc/using/mac.rst:148 +#: using/mac.rst:149 msgid "" "*PyObjC* is a Python binding to Apple's Objective-C/Cocoa framework, which " "is the foundation of most modern Mac development. Information on PyObjC is " @@ -1207,7 +1255,7 @@ msgid "" msgstr "" # d7538b8f74b5491586d51b0814ee6a4c -#: ../src/Doc/using/mac.rst:152 +#: using/mac.rst:153 msgid "" "The standard Python GUI toolkit is :mod:`Tkinter`, based on the cross-" "platform Tk toolkit (http://www.tcl.tk). An Aqua-native version of Tk is " @@ -1215,26 +1263,26 @@ msgid "" "installed from http://www.activestate.com; it can also be built from source." msgstr "" -#: ../src/Doc/using/mac.rst:157 +#: using/mac.rst:158 msgid "" "*wxPython* is another popular cross-platform GUI toolkit that runs natively " "on Mac OS X. Packages and documentation are available from http://www." "wxpython.org." msgstr "" -#: ../src/Doc/using/mac.rst:160 +#: using/mac.rst:161 msgid "" "*PyQt* is another popular cross-platform GUI toolkit that runs natively on " "Mac OS X. More information can be found at http://www.riverbankcomputing.co." "uk/software/pyqt/intro." msgstr "" -#: ../src/Doc/using/mac.rst:166 +#: using/mac.rst:167 msgid "Distributing Python Applications on the Mac" msgstr "" # cbbebb6a9fe94643b7347ac3d3c5383a -#: ../src/Doc/using/mac.rst:168 +#: using/mac.rst:169 msgid "" "The \"Build Applet\" tool that is placed in the MacPython 2.7 folder is fine " "for packaging small Python scripts on your own machine to run as a standard " @@ -1242,51 +1290,51 @@ msgid "" "Python applications to other users." msgstr "" -#: ../src/Doc/using/mac.rst:173 +#: using/mac.rst:174 msgid "" "The standard tool for deploying standalone Python applications on the Mac " "is :program:`py2app`. More information on installing and using py2app can be " "found at http://undefined.org/python/#py2app." msgstr "" -#: ../src/Doc/using/mac.rst:179 +#: using/mac.rst:180 #, fuzzy msgid "Other Resources" msgstr "Autres ressources" -#: ../src/Doc/using/mac.rst:181 +#: using/mac.rst:182 msgid "" "The MacPython mailing list is an excellent support resource for Python users " "and developers on the Mac:" msgstr "" # 867821e24847447fbc312d3270f53b58 -#: ../src/Doc/using/mac.rst:184 +#: using/mac.rst:185 msgid "https://www.python.org/community/sigs/current/pythonmac-sig/" msgstr "" -#: ../src/Doc/using/mac.rst:186 +#: using/mac.rst:187 msgid "Another useful resource is the MacPython wiki:" msgstr "" # 9905de065c914eef955c7940588100b3 -#: ../src/Doc/using/mac.rst:188 +#: using/mac.rst:189 msgid "https://wiki.python.org/moin/MacPython" msgstr "" -#: ../src/Doc/using/unix.rst:7 +#: using/unix.rst:7 msgid "Using Python on Unix platforms" msgstr "" -#: ../src/Doc/using/unix.rst:13 +#: using/unix.rst:13 msgid "Getting and installing the latest version of Python" msgstr "" -#: ../src/Doc/using/unix.rst:16 +#: using/unix.rst:16 msgid "On Linux" msgstr "" -#: ../src/Doc/using/unix.rst:18 +#: using/unix.rst:18 msgid "" "Python comes preinstalled on most Linux distributions, and is available as a " "package on all others. However there are certain features you might want to " @@ -1294,7 +1342,7 @@ msgid "" "the latest version of Python from source." msgstr "" -#: ../src/Doc/using/unix.rst:23 +#: using/unix.rst:23 msgid "" "In the event that Python doesn't come preinstalled and isn't in the " "repositories as well, you can easily make packages for your own distro. " @@ -1302,77 +1350,77 @@ msgid "" msgstr "" # 8f759981a33241a8856ff76020ae9fd3 -#: ../src/Doc/using/unix.rst:28 +#: using/unix.rst:29 msgid "http://www.debian.org/doc/manuals/maint-guide/first.en.html" msgstr "" -#: ../src/Doc/using/unix.rst:30 +#: using/unix.rst:30 msgid "for Debian users" msgstr "" # 3b6cc98f8a1847288b44b54c4cac4563 -#: ../src/Doc/using/unix.rst:30 +#: using/unix.rst:31 msgid "http://en.opensuse.org/Portal:Packaging" msgstr "" -#: ../src/Doc/using/unix.rst:32 +#: using/unix.rst:32 msgid "for OpenSuse users" msgstr "" # 591d73c27d224ba99486ee7e7eff14f1 -#: ../src/Doc/using/unix.rst:32 +#: using/unix.rst:33 msgid "" "http://docs.fedoraproject.org/en-US/Fedora_Draft_Documentation/0.1/html/" "RPM_Guide/ch-creating-rpms.html" msgstr "" -#: ../src/Doc/using/unix.rst:34 +#: using/unix.rst:34 msgid "for Fedora users" msgstr "" # 0f86ca59fe284705b93f31065f103fb4 -#: ../src/Doc/using/unix.rst:34 +#: using/unix.rst:35 msgid "http://www.slackbook.org/html/package-management-making-packages.html" msgstr "" -#: ../src/Doc/using/unix.rst:36 +#: using/unix.rst:36 msgid "for Slackware users" msgstr "" -#: ../src/Doc/using/unix.rst:40 +#: using/unix.rst:40 msgid "On FreeBSD and OpenBSD" msgstr "" -#: ../src/Doc/using/unix.rst:42 +#: using/unix.rst:42 msgid "FreeBSD users, to add the package use::" msgstr "" -#: ../src/Doc/using/unix.rst:46 +#: using/unix.rst:46 msgid "OpenBSD users use::" msgstr "" -#: ../src/Doc/using/unix.rst:50 +#: using/unix.rst:50 msgid "For example i386 users get the 2.5.1 version of Python using::" msgstr "" -#: ../src/Doc/using/unix.rst:56 +#: using/unix.rst:56 msgid "On OpenSolaris" msgstr "" # 2f9a91b90b664179bd2161e47ab8f486 -#: ../src/Doc/using/unix.rst:58 +#: using/unix.rst:58 msgid "" "You can get Python from `OpenCSW <http://www.opencsw.org/>`_. Various " "versions of Python are available and can be installed with e.g. ``pkgutil -i " "python27``." msgstr "" -#: ../src/Doc/using/unix.rst:63 +#: using/unix.rst:65 msgid "Building Python" msgstr "" # 2c320671df9942cebf20bc9a86877799 -#: ../src/Doc/using/unix.rst:65 +#: using/unix.rst:67 msgid "" "If you want to compile CPython yourself, first thing you should do is get " "the `source <https://www.python.org/download/source/>`_. You can download " @@ -1382,30 +1430,30 @@ msgid "" msgstr "" # b2192a91254d464fae045f022b4605a9 -#: ../src/Doc/using/unix.rst:71 +#: using/unix.rst:73 msgid "The build process consists in the usual ::" msgstr "" # aa42dab208874460927c5a1cdc81de9a -#: ../src/Doc/using/unix.rst:77 +#: using/unix.rst:79 msgid "" "invocations. Configuration options and caveats for specific Unix platforms " "are extensively documented in the :source:`README` file in the root of the " "Python source tree." msgstr "" -#: ../src/Doc/using/unix.rst:83 +#: using/unix.rst:85 msgid "" "``make install`` can overwrite or masquerade the :file:`python` binary. " "``make altinstall`` is therefore recommended instead of ``make install`` " "since it only installs :file:`{exec_prefix}/bin/python{version}`." msgstr "" -#: ../src/Doc/using/unix.rst:89 +#: using/unix.rst:91 msgid "Python-related paths and files" msgstr "" -#: ../src/Doc/using/unix.rst:91 +#: using/unix.rst:93 msgid "" "These are subject to difference depending on local installation " "conventions; :envvar:`prefix` (``${prefix}``) and :envvar:`exec_prefix` (``" @@ -1413,137 +1461,137 @@ msgid "" "for GNU software; they may be the same." msgstr "" -#: ../src/Doc/using/unix.rst:96 +#: using/unix.rst:98 msgid "" "For example, on most Linux systems, the default for both is :file:`/usr`." msgstr "" -#: ../src/Doc/using/unix.rst:99 +#: using/unix.rst:101 msgid "File/directory" msgstr "" -#: ../src/Doc/using/unix.rst:99 +#: using/unix.rst:101 msgid "Meaning" msgstr "" -#: ../src/Doc/using/unix.rst:101 +#: using/unix.rst:103 msgid ":file:`{exec_prefix}/bin/python`" msgstr "" -#: ../src/Doc/using/unix.rst:101 +#: using/unix.rst:103 msgid "Recommended location of the interpreter." msgstr "" -#: ../src/Doc/using/unix.rst:103 +#: using/unix.rst:105 msgid "" ":file:`{prefix}/lib/python{version}`, :file:`{exec_prefix}/lib/" "python{version}`" msgstr "" -#: ../src/Doc/using/unix.rst:103 +#: using/unix.rst:105 msgid "" "Recommended locations of the directories containing the standard modules." msgstr "" -#: ../src/Doc/using/unix.rst:106 +#: using/unix.rst:108 msgid "" ":file:`{prefix}/include/python{version}`, :file:`{exec_prefix}/include/" "python{version}`" msgstr "" -#: ../src/Doc/using/unix.rst:106 +#: using/unix.rst:108 msgid "" "Recommended locations of the directories containing the include files needed " "for developing Python extensions and embedding the interpreter." msgstr "" -#: ../src/Doc/using/unix.rst:111 +#: using/unix.rst:113 msgid ":file:`~/.pythonrc.py`" msgstr "" -#: ../src/Doc/using/unix.rst:111 +#: using/unix.rst:113 msgid "" "User-specific initialization file loaded by the user module; not used by " "default or by most applications." msgstr "" -#: ../src/Doc/using/unix.rst:118 +#: using/unix.rst:120 msgid "Miscellaneous" msgstr "" -#: ../src/Doc/using/unix.rst:120 +#: using/unix.rst:122 msgid "" "To easily use Python scripts on Unix, you need to make them executable, e.g. " "with ::" msgstr "" -#: ../src/Doc/using/unix.rst:125 +#: using/unix.rst:127 msgid "" "and put an appropriate Shebang line at the top of the script. A good choice " "is usually ::" msgstr "" -#: ../src/Doc/using/unix.rst:130 +#: using/unix.rst:132 msgid "" "which searches for the Python interpreter in the whole :envvar:`PATH`. " "However, some Unices may not have the :program:`env` command, so you may " "need to hardcode ``/usr/bin/python`` as the interpreter path." msgstr "" -#: ../src/Doc/using/unix.rst:134 +#: using/unix.rst:136 msgid "" "To use shell commands in your Python scripts, look at the :mod:`subprocess` " "module." msgstr "" -#: ../src/Doc/using/unix.rst:138 +#: using/unix.rst:140 msgid "Editors" msgstr "" -#: ../src/Doc/using/unix.rst:140 +#: using/unix.rst:142 msgid "" "Vim and Emacs are excellent editors which support Python very well. For " "more information on how to code in Python in these editors, look at:" msgstr "" -#: ../src/Doc/using/unix.rst:143 +#: using/unix.rst:145 msgid "http://www.vim.org/scripts/script.php?script_id=790" msgstr "" -#: ../src/Doc/using/unix.rst:144 +#: using/unix.rst:146 msgid "http://sourceforge.net/projects/python-mode" msgstr "" # 868d7c50647640dc964f4f77ccb8ad7e -#: ../src/Doc/using/unix.rst:146 +#: using/unix.rst:148 msgid "" "Geany is an excellent IDE with support for a lot of languages. For more " "information, read: http://www.geany.org/" msgstr "" # cff802ec1a6c4d1fa14da5409e23e425 -#: ../src/Doc/using/unix.rst:149 +#: using/unix.rst:151 msgid "" "Komodo edit is another extremely good IDE. It also has support for a lot of " "languages. For more information, read http://komodoide.com/." msgstr "" -#: ../src/Doc/using/windows.rst:7 +#: using/windows.rst:7 msgid "Using Python on Windows" msgstr "" -#: ../src/Doc/using/windows.rst:11 +#: using/windows.rst:11 msgid "" "This document aims to give an overview of Windows-specific behaviour you " "should know about when using Python on Microsoft Windows." msgstr "" -#: ../src/Doc/using/windows.rst:16 +#: using/windows.rst:16 msgid "Installing Python" msgstr "" # dd7af41aef1d4a2d971754f07bba259a -#: ../src/Doc/using/windows.rst:18 +#: using/windows.rst:18 msgid "" "Unlike most Unix systems and services, Windows does not require Python " "natively and thus does not pre-install a version of Python. However, the " @@ -1551,7 +1599,7 @@ msgid "" "`release <https://www.python.org/download/releases/>`_ for many years." msgstr "" -#: ../src/Doc/using/windows.rst:23 +#: using/windows.rst:23 msgid "" "With ongoing development of Python, some platforms that used to be supported " "earlier are no longer supported (due to the lack of users or developers). " @@ -1559,13 +1607,13 @@ msgid "" msgstr "" # 03b0e2cf4d3f49a0a07428fd0ca073f7 -#: ../src/Doc/using/windows.rst:27 +#: using/windows.rst:27 msgid "" "DOS and Windows 3.x are deprecated since Python 2.0 and code specific to " "these systems was removed in Python 2.1." msgstr "" -#: ../src/Doc/using/windows.rst:29 +#: using/windows.rst:29 msgid "" "Up to 2.5, Python was still compatible with Windows 95, 98 and ME (but " "already raised a deprecation warning on installation). For Python 2.6 (and " @@ -1573,12 +1621,12 @@ msgid "" "expected to work on the Windows NT family." msgstr "" -#: ../src/Doc/using/windows.rst:33 +#: using/windows.rst:33 msgid "`Windows CE <http://pythonce.sourceforge.net/>`_ is still supported." msgstr "" # 294475a3693343fdb5b146367f163af5 -#: ../src/Doc/using/windows.rst:34 +#: using/windows.rst:34 msgid "" "The `Cygwin <http://cygwin.com/>`_ installer offers to install the Python " "interpreter as well (cf. `Cygwin package source <ftp://ftp.uni-erlangen.de/" @@ -1587,102 +1635,93 @@ msgid "" msgstr "" # d430b2fdf8224e589804bad92d7c2f23 -#: ../src/Doc/using/windows.rst:40 +#: using/windows.rst:40 msgid "" "See `Python for Windows (and DOS) <https://www.python.org/download/windows/" ">`_ for detailed information about platforms with precompiled installers." msgstr "" -# 67507a1f2fbb40689b4c2dc99ac45ea9 -#: ../src/Doc/using/windows.rst:46 -msgid "" -"`Python on XP <http://www.richarddooling.com/index.php/2006/03/14/python-on-" -"xp-7-minutes-to-hello-world/>`_" -msgstr "" +#: using/windows.rst:47 +#, fuzzy +msgid "Python on XP" +msgstr "Python 3.0" -#: ../src/Doc/using/windows.rst:46 +#: using/windows.rst:46 msgid "\"7 Minutes to \"Hello World!\"\" by Richard Dooling, 2006" msgstr "" -# 97deea0cbd5c40389392d2a917fcde71 -#: ../src/Doc/using/windows.rst:52 -msgid "" -"`Installing on Windows <http://www.diveintopython.net/installing_python/" -"windows.html>`_" -msgstr "" +#: using/windows.rst:53 +#, fuzzy +msgid "Installing on Windows" +msgstr "Compiler Python sous Windows" # c939bd24a856462087e19ea1c23e5cae -#: ../src/Doc/using/windows.rst:50 +#: using/windows.rst:50 msgid "" "in \"`Dive into Python: Python from novice to pro <http://www.diveintopython." "net/>`_\" by Mark Pilgrim, 2004, ISBN 1-59059-356-1" msgstr "" -# 4a094d4cf29d46f383870fb0ee107042 -#: ../src/Doc/using/windows.rst:56 -msgid "" -"`For Windows users <http://www.swaroopch.com/notes/python/#install_windows>`_" +#: using/windows.rst:57 +msgid "For Windows users" msgstr "" # 1a7937a12a6d4d0294b38c6fc0d28e27 -#: ../src/Doc/using/windows.rst:56 +#: using/windows.rst:56 msgid "" "in \"Installing Python\" in \"`A Byte of Python <http://www.swaroopch.com/" "notes/python/>`_\" by Swaroop C H, 2003" msgstr "" -#: ../src/Doc/using/windows.rst:62 +#: using/windows.rst:62 msgid "Alternative bundles" msgstr "" -#: ../src/Doc/using/windows.rst:64 +#: using/windows.rst:64 msgid "" "Besides the standard CPython distribution, there are modified packages " "including additional functionality. The following is a list of popular " "versions and their key features:" msgstr "" -# 68d9b159c4954f639197a165a4a526ea -#: ../src/Doc/using/windows.rst:68 -msgid "`ActivePython <http://www.activestate.com/Products/activepython/>`_" +#: using/windows.rst:69 +msgid "ActivePython" msgstr "" -#: ../src/Doc/using/windows.rst:69 +#: using/windows.rst:69 msgid "Installer with multi-platform compatibility, documentation, PyWin32" msgstr "" -# cbde254564934ae081fb6ba184548b23 -#: ../src/Doc/using/windows.rst:72 -msgid "" -"`Enthought Python Distribution <https://www.enthought.com/products/epd/>`_" +#: using/windows.rst:73 +msgid "Enthought Python Distribution" msgstr "" -#: ../src/Doc/using/windows.rst:72 +#: using/windows.rst:72 msgid "" "Popular modules (such as PyWin32) with their respective documentation, tool " "suite for building extensible Python applications" msgstr "" -#: ../src/Doc/using/windows.rst:75 +#: using/windows.rst:75 msgid "" "Notice that these packages are likely to install *older* versions of Python." msgstr "" -#: ../src/Doc/using/windows.rst:80 +#: using/windows.rst:80 msgid "Configuring Python" msgstr "" -#: ../src/Doc/using/windows.rst:82 +#: using/windows.rst:82 msgid "" "In order to run Python flawlessly, you might have to change certain " "environment settings in Windows." msgstr "" -#: ../src/Doc/using/windows.rst:89 +#: using/windows.rst:89 msgid "Excursus: Setting environment variables" msgstr "" -#: ../src/Doc/using/windows.rst:91 +#: using/windows.rst:91 msgid "" "Windows has a built-in dialog for changing environment variables (following " "guide applies to XP classical view): Right-click the icon for your machine " @@ -1691,79 +1730,79 @@ msgid "" "and click the :guilabel:`Environment Variables` button." msgstr "" -#: ../src/Doc/using/windows.rst:97 +#: using/windows.rst:97 msgid "In short, your path is:" msgstr "" -#: ../src/Doc/using/windows.rst:99 +#: using/windows.rst:99 msgid "" ":menuselection:`My Computer --> Properties --> Advanced --> Environment " "Variables`" msgstr "" -#: ../src/Doc/using/windows.rst:104 +#: using/windows.rst:104 msgid "" "In this dialog, you can add or modify User and System variables. To change " "System variables, you need non-restricted access to your machine (i.e. " "Administrator rights)." msgstr "" -#: ../src/Doc/using/windows.rst:108 +#: using/windows.rst:108 msgid "" "Another way of adding variables to your environment is using the :command:" "`set` command::" msgstr "" -#: ../src/Doc/using/windows.rst:113 +#: using/windows.rst:113 msgid "" "To make this setting permanent, you could add the corresponding command line " "to your :file:`autoexec.bat`. :program:`msconfig` is a graphical interface " "to this file." msgstr "" -#: ../src/Doc/using/windows.rst:117 +#: using/windows.rst:117 msgid "" "Viewing environment variables can also be done more straight-forward: The " "command prompt will expand strings wrapped into percent signs automatically::" msgstr "" -#: ../src/Doc/using/windows.rst:122 +#: using/windows.rst:122 msgid "Consult :command:`set /?` for details on this behaviour." msgstr "" # f27a39988dce4915a7680111e321c4ad -#: ../src/Doc/using/windows.rst:126 +#: using/windows.rst:127 msgid "http://support.microsoft.com/kb/100843" msgstr "" -#: ../src/Doc/using/windows.rst:127 +#: using/windows.rst:127 msgid "Environment variables in Windows NT" msgstr "" # ceb27994c13f488496bdd49ee26e1403 -#: ../src/Doc/using/windows.rst:129 +#: using/windows.rst:130 msgid "http://support.microsoft.com/kb/310519" msgstr "" -#: ../src/Doc/using/windows.rst:130 +#: using/windows.rst:130 msgid "How To Manage Environment Variables in Windows XP" msgstr "Comment gérer les variables d'environnement sous Windows XP" # 38b6a251eda149c990482bc41456e844 -#: ../src/Doc/using/windows.rst:131 +#: using/windows.rst:132 msgid "http://www.chem.gla.ac.uk/~louis/software/faq/q1.html" msgstr "" -#: ../src/Doc/using/windows.rst:133 +#: using/windows.rst:133 msgid "Setting Environment variables, Louis J. Farrugia" msgstr "Définir les variables d'environnement, Louis J. Farrugia" -#: ../src/Doc/using/windows.rst:137 +#: using/windows.rst:137 #, fuzzy msgid "Finding the Python executable" msgstr "Trouver l'exécutable Python" -#: ../src/Doc/using/windows.rst:139 +#: using/windows.rst:139 msgid "" "Besides using the automatically created start menu entry for the Python " "interpreter, you might want to start Python in the DOS prompt. To make this " @@ -1773,18 +1812,18 @@ msgid "" "two entries are Windows' default)::" msgstr "" -#: ../src/Doc/using/windows.rst:148 +#: using/windows.rst:148 msgid "" "Typing :command:`python` on your command prompt will now fire up the Python " "interpreter. Thus, you can also execute your scripts with command line " "options, see :ref:`using-on-cmdline` documentation." msgstr "" -#: ../src/Doc/using/windows.rst:154 +#: using/windows.rst:154 msgid "Finding modules" msgstr "" -#: ../src/Doc/using/windows.rst:156 +#: using/windows.rst:156 msgid "" "Python usually stores its library (and thereby your site-packages folder) in " "the installation directory. So, if you had installed Python to :file:`C:\\" @@ -1794,19 +1833,19 @@ msgid "" msgstr "" # 5ce8cfccfd0f44bda111f684ac7327cc -#: ../src/Doc/using/windows.rst:162 +#: using/windows.rst:162 msgid "This is how :data:`sys.path` is populated on Windows:" msgstr "" # fe49b0aeeafb42278c433024490a1ffc -#: ../src/Doc/using/windows.rst:164 +#: using/windows.rst:164 msgid "" "An empty entry is added at the start, which corresponds to the current " "directory." msgstr "" # dbfbb2619a08466d9b20d9f2936f0856 -#: ../src/Doc/using/windows.rst:167 +#: using/windows.rst:167 msgid "" "If the environment variable :envvar:`PYTHONPATH` exists, as described in :" "ref:`using-on-envvars`, its entries are added next. Note that on Windows, " @@ -1815,7 +1854,7 @@ msgid "" msgstr "" # 641ef8611f9a48b1a37c996e041969fe -#: ../src/Doc/using/windows.rst:172 +#: using/windows.rst:172 msgid "" "Additional \"application paths\" can be added in the registry as subkeys of :" "samp:`\\\\SOFTWARE\\\\Python\\\\PythonCore\\\\{version}\\\\PythonPath` under " @@ -1826,7 +1865,7 @@ msgid "" msgstr "" # 3cac81246ad74a92839bfdef1f7b7fa8 -#: ../src/Doc/using/windows.rst:179 +#: using/windows.rst:179 msgid "" "If the environment variable :envvar:`PYTHONHOME` is set, it is assumed as " "\"Python Home\". Otherwise, the path of the main Python executable is used " @@ -1838,7 +1877,7 @@ msgid "" msgstr "" # 1833a089d70047009f7f3796503b3633 -#: ../src/Doc/using/windows.rst:186 +#: using/windows.rst:186 msgid "" "If the Python Home cannot be located, no :envvar:`PYTHONPATH` is specified " "in the environment, and no registry entries can be found, a default path " @@ -1846,12 +1885,12 @@ msgid "" msgstr "" # 5476dc9169b24f9bb6eea71e72cfcbdd -#: ../src/Doc/using/windows.rst:190 +#: using/windows.rst:190 msgid "The end result of all this is:" msgstr "" # 4f0c01f99cf84cf5bc940b2a1722a183 -#: ../src/Doc/using/windows.rst:192 +#: using/windows.rst:192 msgid "" "When running :file:`python.exe`, or any other .exe in the main Python " "directory (either an installed version, or directly from the PCbuild " @@ -1860,7 +1899,7 @@ msgid "" msgstr "" # 50ea23f74be043c995a590392a2b3b05 -#: ../src/Doc/using/windows.rst:197 +#: using/windows.rst:197 msgid "" "When Python is hosted in another .exe (different directory, embedded via " "COM, etc), the \"Python Home\" will not be deduced, so the core path from " @@ -1869,18 +1908,18 @@ msgid "" msgstr "" # 8c6cd36c521d4271996308a41608b540 -#: ../src/Doc/using/windows.rst:201 +#: using/windows.rst:201 msgid "" "If Python can't find its home and there is no registry (eg, frozen .exe, " "some very strange installation setup) you get a path with some default, but " "relative, paths." msgstr "" -#: ../src/Doc/using/windows.rst:207 +#: using/windows.rst:207 msgid "Executing scripts" msgstr "" -#: ../src/Doc/using/windows.rst:209 +#: using/windows.rst:209 msgid "" "Python scripts (files with the extension ``.py``) will be executed by :" "program:`python.exe` by default. This executable opens a terminal, which " @@ -1891,47 +1930,47 @@ msgid "" "the terminal window on startup." msgstr "" -#: ../src/Doc/using/windows.rst:217 +#: using/windows.rst:217 msgid "" "You can also make all ``.py`` scripts execute with :program:`pythonw.exe`, " "setting this through the usual facilities, for example (might require " "administrative rights):" msgstr "" -#: ../src/Doc/using/windows.rst:221 +#: using/windows.rst:221 msgid "Launch a command prompt." msgstr "" -#: ../src/Doc/using/windows.rst:222 +#: using/windows.rst:222 msgid "Associate the correct file group with ``.py`` scripts::" msgstr "" -#: ../src/Doc/using/windows.rst:226 +#: using/windows.rst:226 msgid "Redirect all Python files to the new executable::" msgstr "" -#: ../src/Doc/using/windows.rst:232 +#: using/windows.rst:232 msgid "Additional modules" msgstr "" -#: ../src/Doc/using/windows.rst:234 +#: using/windows.rst:234 msgid "" "Even though Python aims to be portable among all platforms, there are " "features that are unique to Windows. A couple of modules, both in the " "standard library and external, and snippets exist to use these features." msgstr "" -#: ../src/Doc/using/windows.rst:238 +#: using/windows.rst:238 msgid "" "The Windows-specific standard modules are documented in :ref:`mswin-specific-" "services`." msgstr "" -#: ../src/Doc/using/windows.rst:243 +#: using/windows.rst:243 msgid "PyWin32" msgstr "PyWin32" -#: ../src/Doc/using/windows.rst:245 +#: using/windows.rst:245 msgid "" "The `PyWin32 <http://python.net/crew/mhammond/win32/>`_ module by Mark " "Hammond is a collection of modules for advanced Windows-specific support. " @@ -1941,25 +1980,25 @@ msgstr "" "Hammond est une collection de modules pour un support avancé spécifique à " "Windows. Cela inclut les services pour :" -#: ../src/Doc/using/windows.rst:249 +#: using/windows.rst:249 msgid "`Component Object Model <http://www.microsoft.com/com/>`_ (COM)" msgstr "`Component Object Model <http://www.microsoft.com/com/>`_ (COM)" -#: ../src/Doc/using/windows.rst:250 +#: using/windows.rst:250 msgid "Win32 API calls" msgstr "Appels à l'API Win32" -#: ../src/Doc/using/windows.rst:251 +#: using/windows.rst:251 #, fuzzy msgid "Registry" msgstr "Registre" -#: ../src/Doc/using/windows.rst:252 +#: using/windows.rst:252 #, fuzzy msgid "Event log" msgstr "journal d'événement" -#: ../src/Doc/using/windows.rst:253 +#: using/windows.rst:253 msgid "" "`Microsoft Foundation Classes <http://msdn.microsoft.com/en-us/library/" "fe1cf721%28VS.80%29.aspx>`_ (MFC) user interfaces" @@ -1967,7 +2006,7 @@ msgstr "" "`Microsoft Foundation Classes <http://msdn.microsoft.com/en-us/library/" "fe1cf721%28VS.80%29.aspx>`_ (MFC) interfaces utilisateur" -#: ../src/Doc/using/windows.rst:256 +#: using/windows.rst:256 #, fuzzy msgid "" "`PythonWin <http://web.archive.org/web/20060524042422/ https://www.python." @@ -1978,30 +2017,29 @@ msgstr "" "windows/pythonwin/>`_ est une exemple d'application MFC livrée avec PyWin32. " "Il s'agit d'un IDE embarqué avec débogueur intégré." -# 100f9662fe0e4c64875ef88306b703ac -#: ../src/Doc/using/windows.rst:262 -msgid "" -"`Win32 How Do I...? <http://timgolden.me.uk/python/win32_how_do_i.html>`_" +#: using/windows.rst:263 +msgid "Win32 How Do I...?" msgstr "" -#: ../src/Doc/using/windows.rst:263 +#: using/windows.rst:263 msgid "by Tim Golden" msgstr "par Tim Golden" -# 3560553e94c24696bccac62e239c4e0a -#: ../src/Doc/using/windows.rst:264 -msgid "`Python and COM <http://www.boddie.org.uk/python/COM.html>`_" -msgstr "" +# cc6cf10288e14cac87acf1f21eab2c34 +#: using/windows.rst:265 +#, fuzzy +msgid "Python and COM" +msgstr "Installation et Utilisation de Python [en]" -#: ../src/Doc/using/windows.rst:266 +#: using/windows.rst:266 msgid "by David and Paul Boddie" msgstr "par David et Paul Boddie" -#: ../src/Doc/using/windows.rst:270 +#: using/windows.rst:270 msgid "Py2exe" msgstr "Py2exe" -#: ../src/Doc/using/windows.rst:272 +#: using/windows.rst:272 msgid "" "`Py2exe <http://www.py2exe.org/>`_ is a :mod:`distutils` extension (see :ref:" "`extending-distutils`) which wraps Python scripts into executable Windows " @@ -2009,29 +2047,29 @@ msgid "" "distribute your application without requiring your users to install Python." msgstr "" -#: ../src/Doc/using/windows.rst:279 +#: using/windows.rst:279 msgid "WConio" msgstr "WConio" -#: ../src/Doc/using/windows.rst:281 +#: using/windows.rst:281 msgid "" "Since Python's advanced terminal handling layer, :mod:`curses`, is " "restricted to Unix-like systems, there is a library exclusive to Windows as " "well: Windows Console I/O for Python." msgstr "" -#: ../src/Doc/using/windows.rst:285 +#: using/windows.rst:285 msgid "" "`WConio <http://newcenturycomputers.net/projects/wconio.html>`_ is a wrapper " "for Turbo-C's :file:`CONIO.H`, used to create text user interfaces." msgstr "" -#: ../src/Doc/using/windows.rst:291 +#: using/windows.rst:291 msgid "Compiling Python on Windows" msgstr "Compiler Python sous Windows" # f47c443be75942f8bd6ee385b72616a0 -#: ../src/Doc/using/windows.rst:293 +#: using/windows.rst:293 msgid "" "If you want to compile CPython yourself, first thing you should do is get " "the `source <https://www.python.org/download/source/>`_. You can download " @@ -2039,128 +2077,119 @@ msgid "" "docs.python.org/devguide/setup.html#getting-the-source-code>`_." msgstr "" -#: ../src/Doc/using/windows.rst:298 +#: using/windows.rst:298 msgid "" "For Microsoft Visual C++, which is the compiler with which official Python " "releases are built, the source tree contains solutions/project files. View " "the :file:`readme.txt` in their respective directories:" msgstr "" -#: ../src/Doc/using/windows.rst:303 +#: using/windows.rst:303 msgid "Directory" msgstr "Répertoire" -#: ../src/Doc/using/windows.rst:303 +#: using/windows.rst:303 msgid "MSVC version" msgstr "version de MSVC" -#: ../src/Doc/using/windows.rst:303 +#: using/windows.rst:303 msgid "Visual Studio version" msgstr "Version de Visual Studio" -#: ../src/Doc/using/windows.rst:305 +#: using/windows.rst:305 msgid ":file:`PC/VC6/`" msgstr ":file:`PC/VC6/`" -#: ../src/Doc/using/windows.rst:305 +#: using/windows.rst:305 msgid "6.0" msgstr "6.0" -#: ../src/Doc/using/windows.rst:305 +#: using/windows.rst:305 msgid "97" msgstr "97" -#: ../src/Doc/using/windows.rst:307 +#: using/windows.rst:307 msgid ":file:`PC/VS7.1/`" msgstr ":file:`PC/VS7.1/`" -#: ../src/Doc/using/windows.rst:307 +#: using/windows.rst:307 msgid "7.1" msgstr "7.1" -#: ../src/Doc/using/windows.rst:307 +#: using/windows.rst:307 msgid "2003" msgstr "2003" -#: ../src/Doc/using/windows.rst:309 +#: using/windows.rst:309 msgid ":file:`PC/VS8.0/`" msgstr ":file:`PC/VS8.0/`" -#: ../src/Doc/using/windows.rst:309 +#: using/windows.rst:309 msgid "8.0" msgstr "8.0" -#: ../src/Doc/using/windows.rst:309 +#: using/windows.rst:309 msgid "2005" msgstr "2005" -#: ../src/Doc/using/windows.rst:311 +#: using/windows.rst:311 msgid ":file:`PCbuild/`" msgstr ":file:`PCbuild/`" -#: ../src/Doc/using/windows.rst:311 +#: using/windows.rst:311 msgid "9.0" msgstr "9.0" -#: ../src/Doc/using/windows.rst:311 +#: using/windows.rst:311 msgid "2008" msgstr "2008" -#: ../src/Doc/using/windows.rst:314 +#: using/windows.rst:314 msgid "" "Note that not all of these build directories are fully supported. Read the " "release notes to see which compiler version the official releases for your " "version are built with." msgstr "" -#: ../src/Doc/using/windows.rst:318 +#: using/windows.rst:318 msgid "" "Check :file:`PC/readme.txt` for general information on the build process." msgstr "" "Vérifiez :file:`PC/readme.txt` pour des informations générales sur le " "processus de construction." -#: ../src/Doc/using/windows.rst:321 +#: using/windows.rst:321 msgid "For extension modules, consult :ref:`building-on-windows`." msgstr "" -# f5c5256cfc284cc28938c292fdf5de56 -#: ../src/Doc/using/windows.rst:327 -msgid "" -"`Python + Windows + distutils + SWIG + gcc MinGW <http://sebsauvage.net/" -"python/mingw.html>`_" +#: using/windows.rst:328 +msgid "Python + Windows + distutils + SWIG + gcc MinGW" msgstr "" -#: ../src/Doc/using/windows.rst:326 +#: using/windows.rst:326 msgid "" "or \"Creating Python extensions in C/C++ with SWIG and compiling them with " "MinGW gcc under Windows\" or \"Installing Python extension with distutils " "and without Microsoft Visual C++\" by Sébastien Sauvage, 2003" msgstr "" -# 20de9169858245b3a25788a49de8a8a4 -#: ../src/Doc/using/windows.rst:329 -msgid "" -"`MingW -- Python extensions <http://oldwiki.mingw.org/index.php/Python" -"%20extensions>`_" +#: using/windows.rst:330 +msgid "MingW -- Python extensions" msgstr "" -#: ../src/Doc/using/windows.rst:331 +#: using/windows.rst:331 msgid "by Trent Apted et al, 2007" msgstr "par Trent Apted et al, 2007" -#: ../src/Doc/using/windows.rst:335 +#: using/windows.rst:335 msgid "Other resources" msgstr "Autres ressources" -# f8673276b4cc47d9a06380c1887438c4 -#: ../src/Doc/using/windows.rst:341 -msgid "" -"`Python Programming On Win32 <http://shop.oreilly.com/product/9781565926219." -"do>`_" +#: using/windows.rst:342 +msgid "Python Programming On Win32" msgstr "" -#: ../src/Doc/using/windows.rst:340 +#: using/windows.rst:340 msgid "" "\"Help for Windows Programmers\" by Mark Hammond and Andy Robinson, O'Reilly " "Media, 2000, ISBN 1-56592-621-8" @@ -2168,14 +2197,12 @@ msgstr "" "\"Help for Windows Programmers\" de Mark Hammond et Andy Robinson, O'Reilly " "Media, 2000, ISBN 1-56592-621-8" -# 837cd4194e3b4c33b0b2e4009a23e3fb -#: ../src/Doc/using/windows.rst:343 -msgid "" -"`A Python for Windows Tutorial <http://www.imladris.com/Scripts/" -"PythonForWindows.html>`_" -msgstr "" +#: using/windows.rst:344 +#, fuzzy +msgid "A Python for Windows Tutorial" +msgstr "Compiler Python sous Windows" -#: ../src/Doc/using/windows.rst:345 +#: using/windows.rst:345 msgid "by Amanda Birmingham, 2004" msgstr "par Amanda Birmingham, 2004" @@ -2204,10 +2231,6 @@ msgstr "par Amanda Birmingham, 2004" #~ msgid "See also" #~ msgstr "Voir aussi" -#, fuzzy -#~ msgid "Python 3.0" -#~ msgstr "Python 3.0" - #, fuzzy #~ msgid "" #~ "Force the binary layer of the stdin, stdout and stderr streams (which is " diff --git a/whatsnew.po b/whatsnew.po index b459ee50..cb47093a 100644 --- a/whatsnew.po +++ b/whatsnew.po @@ -7,30 +7,29 @@ msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "Report-Msgid-Bugs-To: \n" -"POT-Creation-Date: 2014-11-17 04:01\n" +"POT-Creation-Date: 2015-12-22 00:51+0100\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" "Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" -"Language: \n" "X-Generator: Translate Toolkit 1.7.0\n" -#: ../src/Doc/whatsnew/2.0.rst:3 +#: whatsnew/2.0.rst:3 msgid "What's New in Python 2.0" msgstr "Nouveautés de Python 2.0" -#: ../src/Doc/whatsnew/2.0.rst:5 +#: whatsnew/2.0.rst:5 msgid "A.M. Kuchling and Moshe Zadka" msgstr "A.M. Kuchling et Moshe Zadka" -#: ../src/Doc/whatsnew/2.0.rst:13 ../src/Doc/whatsnew/2.1.rst:13 -#: ../src/Doc/whatsnew/2.2.rst:13 +#: whatsnew/2.0.rst:13 whatsnew/2.1.rst:13 whatsnew/2.2.rst:13 msgid "Introduction" msgstr "Introduction" -#: ../src/Doc/whatsnew/2.0.rst:15 +#: whatsnew/2.0.rst:15 #, fuzzy msgid "" "A new release of Python, version 2.0, was released on October 16, 2000. This " @@ -43,7 +42,7 @@ msgstr "" "cette version, met en évidence d'autres changements utiles, et souligne " "quelques incompatibilités qui peuvent nécessiter la réécriture du code." -#: ../src/Doc/whatsnew/2.0.rst:20 +#: whatsnew/2.0.rst:20 #, fuzzy msgid "" "Python's development never completely stops between releases, and a steady " @@ -66,12 +65,12 @@ msgstr "" "payés pour passer leurs journées à corriger les bugs, mais aussi en raison " "de l'amélioration de la communication résultant du passage à SourceForge." -#: ../src/Doc/whatsnew/2.0.rst:33 +#: whatsnew/2.0.rst:33 #, fuzzy msgid "What About Python 1.6?" msgstr "A propos de Python 1.6" -#: ../src/Doc/whatsnew/2.0.rst:35 +#: whatsnew/2.0.rst:35 msgid "" "Python 1.6 can be thought of as the Contractual Obligations Python release. " "After the core development team left CNRI in May 2000, CNRI requested that a " @@ -83,7 +82,7 @@ msgid "" "2.0. 1.6 is therefore part of Python's evolution, and not a side branch." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:44 +#: whatsnew/2.0.rst:44 msgid "" "So, should you take much interest in Python 1.6? Probably not. The " "1.6final and 2.0beta1 releases were made on the same day (September 5, " @@ -95,11 +94,11 @@ msgid "" "only in 2.0, because a lot of work was done between May and September." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:57 +#: whatsnew/2.0.rst:57 msgid "New Development Process" msgstr "Nouveau processus de développement" -#: ../src/Doc/whatsnew/2.0.rst:59 +#: whatsnew/2.0.rst:59 msgid "" "The most important change in Python 2.0 may not be to the code at all, but " "to how Python is developed: in May 2000 the Python developers began using " @@ -110,7 +109,7 @@ msgid "" "projects/python/." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:66 +#: whatsnew/2.0.rst:66 msgid "" "The most important of the services now hosted at SourceForge is the Python " "CVS tree, the version-controlled repository containing the source code for " @@ -130,7 +129,7 @@ msgid "" "the time and effort needed\" and it would never have gotten done." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:83 +#: whatsnew/2.0.rst:83 msgid "" "The shift to using SourceForge's services has resulted in a remarkable " "increase in the speed of development. Patches now get submitted, commented " @@ -145,7 +144,7 @@ msgid "" "wrote an HTML screen-scraper that sends more useful messages." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:95 +#: whatsnew/2.0.rst:95 msgid "" "The ease of adding code caused a few initial growing pains, such as code was " "checked in before it was ready or without getting clear agreement from the " @@ -160,7 +159,7 @@ msgid "" "if the community disagrees with him." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:106 +#: whatsnew/2.0.rst:106 msgid "" "Producing an actual patch is the last step in adding a new feature, and is " "usually easy compared to the earlier task of coming up with a good design. " @@ -174,7 +173,7 @@ msgid "" "1, \"PEP Purpose and Guidelines\":" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:120 +#: whatsnew/2.0.rst:120 msgid "" "PEP stands for Python Enhancement Proposal. A PEP is a design document " "providing information to the Python community, or describing a new feature " @@ -182,7 +181,7 @@ msgid "" "feature and a rationale for the feature." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:125 +#: whatsnew/2.0.rst:125 msgid "" "We intend PEPs to be the primary mechanisms for proposing new features, for " "collecting community input on an issue, and for documenting the design " @@ -191,7 +190,7 @@ msgid "" msgstr "" # 705ef47c2c6e4331b49fb92b63efc6bd -#: ../src/Doc/whatsnew/2.0.rst:130 +#: whatsnew/2.0.rst:130 msgid "" "Read the rest of PEP 1 for the details of the PEP editorial process, style, " "and format. PEPs are kept in the Python CVS tree on SourceForge, though " @@ -201,11 +200,11 @@ msgid "" "\"Elementwise/Objectwise Operators\"." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:141 +#: whatsnew/2.0.rst:141 msgid "Unicode" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:143 +#: whatsnew/2.0.rst:143 msgid "" "The largest new feature in Python 2.0 is a new fundamental data type: " "Unicode strings. Unicode uses 16-bit numbers to represent characters " @@ -213,7 +212,7 @@ msgid "" "characters can be supported." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:148 +#: whatsnew/2.0.rst:148 msgid "" "The final interface for Unicode support was arrived at through countless " "often- stormy discussions on the python-dev mailing list, and mostly " @@ -223,7 +222,7 @@ msgid "" "will simply cover the most significant points about the Unicode interfaces." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:155 +#: whatsnew/2.0.rst:155 msgid "" "In Python source code, Unicode strings are written as ``u\"string\"``. " "Arbitrary Unicode characters can be written using a new escape sequence, ``" @@ -232,7 +231,7 @@ msgid "" "can be used for characters up to U+01FF, which is represented by ``\\777``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:161 +#: whatsnew/2.0.rst:161 msgid "" "Unicode strings, just like regular strings, are an immutable sequence type. " "They can be indexed and sliced, but not modified in place. Unicode strings " @@ -246,31 +245,31 @@ msgid "" "function in a customised version of :file:`site.py`." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:172 +#: whatsnew/2.0.rst:172 msgid "" "Combining 8-bit and Unicode strings always coerces to Unicode, using the " "default ASCII encoding; the result of ``'a' + u'bc'`` is ``u'abc'``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:175 +#: whatsnew/2.0.rst:175 msgid "" "New built-in functions have been added, and existing built-ins modified to " "support Unicode:" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:178 +#: whatsnew/2.0.rst:178 msgid "" "``unichr(ch)`` returns a Unicode string 1 character long, containing the " "character *ch*." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:181 +#: whatsnew/2.0.rst:181 msgid "" "``ord(u)``, where *u* is a 1-character regular or Unicode string, returns " "the number of the character as an integer." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:184 +#: whatsnew/2.0.rst:184 msgid "" "``unicode(string [, encoding] [, errors] )`` creates a Unicode string from " "an 8-bit string. ``encoding`` is a string naming the encoding to use. The " @@ -281,7 +280,7 @@ msgid "" "replacement character, in case of any problems." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:192 +#: whatsnew/2.0.rst:192 msgid "" "The :keyword:`exec` statement, and various built-ins such as ``eval()``, " "``getattr()``, and ``setattr()`` will also accept Unicode strings as well as " @@ -290,7 +289,7 @@ msgid "" "accept Unicode strings at all, please report it as a bug.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:198 +#: whatsnew/2.0.rst:198 msgid "" "A new module, :mod:`unicodedata`, provides an interface to Unicode character " "properties. For example, ``unicodedata.category(u'A')`` returns the 2-" @@ -299,7 +298,7 @@ msgid "" "meaning that U+0660 is an Arabic number." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:204 +#: whatsnew/2.0.rst:204 msgid "" "The :mod:`codecs` module contains functions to look up existing encodings " "and register new ones. Unless you want to implement a new encoding, you'll " @@ -308,7 +307,7 @@ msgid "" "stream_writer)``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:209 +#: whatsnew/2.0.rst:209 msgid "" "*encode_func* is a function that takes a Unicode string, and returns a 2-" "tuple ``(string, length)``. *string* is an 8-bit string containing a " @@ -317,7 +316,7 @@ msgid "" "converted." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:214 +#: whatsnew/2.0.rst:214 msgid "" "*decode_func* is the opposite of *encode_func*, taking an 8-bit string and " "returning a 2-tuple ``(ustring, length)``, consisting of the resulting " @@ -325,7 +324,7 @@ msgid "" "bit string was consumed." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:219 +#: whatsnew/2.0.rst:219 msgid "" "*stream_reader* is a class that supports decoding input from a stream. " "*stream_reader(file_obj)* returns an object that supports the :meth:`read`, :" @@ -333,7 +332,7 @@ msgid "" "translate from the given encoding and return Unicode strings." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:224 +#: whatsnew/2.0.rst:224 msgid "" "*stream_writer*, similarly, is a class that supports encoding output to a " "stream. *stream_writer(file_obj)* returns an object that supports the :meth:" @@ -341,24 +340,24 @@ msgid "" "strings, translating them to the given encoding on output." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:229 +#: whatsnew/2.0.rst:229 msgid "" "For example, the following code writes a Unicode string into a file, " "encoding it as UTF-8::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:243 +#: whatsnew/2.0.rst:243 msgid "The following code would then read UTF-8 input from the file::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:249 +#: whatsnew/2.0.rst:249 msgid "" "Unicode-aware regular expressions are available through the :mod:`re` " "module, which has a new underlying implementation called SRE written by " "Fredrik Lundh of Secret Labs AB." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:253 +#: whatsnew/2.0.rst:253 msgid "" "A ``-U`` command line option was added which causes the Python compiler to " "interpret all string literals as Unicode string literals. This is intended " @@ -367,11 +366,11 @@ msgid "" "Unicode strings." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:262 +#: whatsnew/2.0.rst:262 msgid "List Comprehensions" msgstr "Compréhensions de listes" -#: ../src/Doc/whatsnew/2.0.rst:264 +#: whatsnew/2.0.rst:264 msgid "" "Lists are a workhorse data type in Python, and many programs manipulate a " "list at some point. Two common operations on lists are to loop over them, " @@ -381,7 +380,7 @@ msgid "" "strip off trailing whitespace from each line." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:271 +#: whatsnew/2.0.rst:271 msgid "" "The existing :func:`map` and :func:`filter` functions can be used for this " "purpose, but they require a function as one of their arguments. This is " @@ -393,18 +392,18 @@ msgid "" "substring. You could write the following to do it::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:286 +#: whatsnew/2.0.rst:286 msgid "" "Because of Python's scoping rules, a default argument is used so that the " "anonymous function created by the :keyword:`lambda` statement knows what " "substring is being searched for. List comprehensions make this cleaner::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:292 +#: whatsnew/2.0.rst:292 msgid "List comprehensions have the form::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:299 +#: whatsnew/2.0.rst:299 msgid "" "The :keyword:`for`...\\ :keyword:`in` clauses contain the sequences to be " "iterated over. The sequences do not have to be the same length, because " @@ -415,13 +414,13 @@ msgid "" "and added to the result if *condition* is true." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:307 +#: whatsnew/2.0.rst:307 msgid "" "To make the semantics very clear, a list comprehension is equivalent to the " "following Python code::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:319 +#: whatsnew/2.0.rst:319 msgid "" "This means that when there are multiple :keyword:`for`...\\ :keyword:`in` " "clauses, the resulting list will be equal to the product of the lengths of " @@ -429,14 +428,14 @@ msgid "" "elements long::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:330 +#: whatsnew/2.0.rst:330 msgid "" "To avoid introducing an ambiguity into Python's grammar, if *expression* is " "creating a tuple, it must be surrounded with parentheses. The first list " "comprehension below is a syntax error, while the second one is correct::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:339 +#: whatsnew/2.0.rst:339 msgid "" "The idea of list comprehensions originally comes from the functional " "programming language Haskell (http://www.haskell.org). Greg Ewing argued " @@ -445,11 +444,11 @@ msgid "" "on the python-dev mailing list and kept up-to-date by Skip Montanaro." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:349 +#: whatsnew/2.0.rst:349 msgid "Augmented Assignment" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:351 +#: whatsnew/2.0.rst:351 msgid "" "Augmented assignment operators, another long-requested feature, have been " "added to Python 2.0. Augmented assignment operators include ``+=``, ``-=``, " @@ -458,7 +457,7 @@ msgid "" "= a + 2``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:356 +#: whatsnew/2.0.rst:356 msgid "" "The full list of supported assignment operators is ``+=``, ``-=``, ``*=``, " "``/=``, ``%=``, ``**=``, ``&=``, ``|=``, ``^=``, ``>>=``, and ``<<=``. " @@ -468,7 +467,7 @@ msgid "" "create a new instance with an incremented value." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:377 +#: whatsnew/2.0.rst:377 msgid "" "The :meth:`__iadd__` special method is called with the value of the " "increment, and should return a new instance with an appropriately modified " @@ -476,7 +475,7 @@ msgid "" "left-hand side." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:381 +#: whatsnew/2.0.rst:381 msgid "" "Augmented assignment operators were first introduced in the C programming " "language, and most C-derived languages, such as :program:`awk`, C++, Java, " @@ -484,11 +483,11 @@ msgid "" "implemented by Thomas Wouters." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:390 +#: whatsnew/2.0.rst:390 msgid "String Methods" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:392 +#: whatsnew/2.0.rst:392 msgid "" "Until now string-manipulation functionality was in the :mod:`string` module, " "which was usually a front-end for the :mod:`strop` module written in C. The " @@ -499,14 +498,14 @@ msgid "" "correspondingly complicated code." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:400 +#: whatsnew/2.0.rst:400 msgid "" "Instead, Python 2.0 pushes the problem onto the string type, making string " "manipulation functionality available through methods on both 8-bit strings " "and Unicode strings. ::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:411 +#: whatsnew/2.0.rst:411 msgid "" "One thing that hasn't changed, a noteworthy April Fools' joke " "notwithstanding, is that Python strings are immutable. Thus, the string " @@ -514,13 +513,13 @@ msgid "" "operate." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:415 +#: whatsnew/2.0.rst:415 msgid "" "The old :mod:`string` module is still around for backwards compatibility, " "but it mostly acts as a front-end to the new string methods." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:418 +#: whatsnew/2.0.rst:418 msgid "" "Two methods which have no parallel in pre-2.0 versions, although they did " "exist in JPython for quite some time, are :meth:`startswith` and :meth:" @@ -528,7 +527,7 @@ msgid "" "``s.endswith(t)`` is equivalent to ``s[-len(t):] == t``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:423 +#: whatsnew/2.0.rst:423 msgid "" "One other method which deserves special mention is :meth:`join`. The :meth:" "`join` method of a string receives one parameter, a sequence of strings, and " @@ -537,11 +536,11 @@ msgid "" "equivalent to the old ``string.join(seq, s)``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:433 +#: whatsnew/2.0.rst:433 msgid "Garbage Collection of Cycles" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:435 +#: whatsnew/2.0.rst:435 msgid "" "The C implementation of Python uses reference counting to implement garbage " "collection. Every Python object maintains a count of the number of " @@ -551,7 +550,7 @@ msgid "" "access it, and if the count is zero, no references exist any longer." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:442 +#: whatsnew/2.0.rst:442 msgid "" "Reference counting has some pleasant properties: it's easy to understand and " "implement, and the resulting implementation is portable, fairly fast, and " @@ -561,20 +560,20 @@ msgid "" "leak. This happens when there are cycles of references." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:449 +#: whatsnew/2.0.rst:449 msgid "" "Consider the simplest possible cycle, a class instance which has a " "reference to itself::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:455 +#: whatsnew/2.0.rst:455 msgid "" "After the above two lines of code have been executed, the reference count of " "``instance`` is 2; one reference is from the variable named ``'instance'``, " "and the other is from the ``myself`` attribute of the instance." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:459 +#: whatsnew/2.0.rst:459 msgid "" "If the next line of code is ``del instance``, what happens? The reference " "count of ``instance`` is decreased by 1, so it has a reference count of 1; " @@ -584,7 +583,7 @@ msgid "" "causing all of the objects to be leaked." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:466 +#: whatsnew/2.0.rst:466 msgid "" "Python 2.0 fixes this problem by periodically executing a cycle detection " "algorithm which looks for inaccessible cycles and deletes the objects " @@ -593,7 +592,7 @@ msgid "" "parameters." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:471 +#: whatsnew/2.0.rst:471 msgid "" "Running the cycle detection algorithm takes some time, and therefore will " "result in some additional overhead. It is hoped that after we've gotten " @@ -607,7 +606,7 @@ msgid "" "the :program:`configure` script." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:482 +#: whatsnew/2.0.rst:482 msgid "" "Several people tackled this problem and contributed to a solution. An early " "implementation of the cycle detection approach was written by Toby Kelsey. " @@ -620,22 +619,22 @@ msgid "" "again\"." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:495 +#: whatsnew/2.0.rst:495 msgid "Other Core Changes" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:497 +#: whatsnew/2.0.rst:497 msgid "" "Various minor changes have been made to Python's syntax and built-in " "functions. None of the changes are very far-reaching, but they're handy " "conveniences." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:502 +#: whatsnew/2.0.rst:502 msgid "Minor Language Changes" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:504 +#: whatsnew/2.0.rst:504 msgid "" "A new syntax makes it more convenient to call a given function with a tuple " "of arguments and/or a dictionary of keyword arguments. In Python 1.5 and " @@ -647,7 +646,7 @@ msgid "" "the syntax for defining functions::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:518 +#: whatsnew/2.0.rst:518 msgid "" "The :keyword:`print` statement can now have its output directed to a file-" "like object by following the :keyword:`print` with ``>> file``, similar to " @@ -658,14 +657,14 @@ msgid "" "to standard error, it's much easier to write this::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:528 +#: whatsnew/2.0.rst:528 msgid "" "Modules can now be renamed on importing them, using the syntax ``import " "module as name`` or ``from module import name as othername``. The patch was " "submitted by Thomas Wouters." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:532 +#: whatsnew/2.0.rst:532 msgid "" "A new format style is available when using the ``%`` operator; '%r' will " "insert the :func:`repr` of its argument. This was also added from symmetry " @@ -674,7 +673,7 @@ msgid "" "('abc', 'abc')`` returns a string containing ``'abc' abc``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:538 +#: whatsnew/2.0.rst:538 msgid "" "Previously there was no way to implement a class that overrode Python's " "built-in :keyword:`in` operator and implemented a custom version. ``obj in " @@ -687,7 +686,7 @@ msgid "" "new slot in the sequence protocol." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:547 +#: whatsnew/2.0.rst:547 msgid "" "Earlier versions of Python used a recursive algorithm for deleting objects. " "Deeply nested data structures could cause the interpreter to fill up the C " @@ -697,7 +696,7 @@ msgid "" "useful result instead. For example, after this code::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:559 +#: whatsnew/2.0.rst:559 msgid "" "The comparison ``a==b`` returns true, because the two recursive data " "structures are isomorphic. See the thread \"trashcan and PR#7\" in the April " @@ -709,7 +708,7 @@ msgid "" "the resulting exception would simply be silently swallowed." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:571 +#: whatsnew/2.0.rst:571 msgid "" "Work has been done on porting Python to 64-bit Windows on the Itanium " "processor, mostly by Trent Mick of ActiveState. (Confusingly, ``sys." @@ -719,7 +718,7 @@ msgid "" "net/ for more information." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:577 +#: whatsnew/2.0.rst:577 msgid "" "Another new platform is Darwin/MacOS X; initial support for it is in Python " "2.0. Dynamic loading works, if you specify \"configure --with-dyld --with-" @@ -727,7 +726,7 @@ msgid "" "instructions." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:581 +#: whatsnew/2.0.rst:581 msgid "" "An attempt has been made to alleviate one of Python's warts, the often-" "confusing :exc:`NameError` exception when code refers to a local variable " @@ -739,18 +738,18 @@ msgid "" "`NameError` to be raised should still work. ::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:595 +#: whatsnew/2.0.rst:595 msgid "" "Two new exceptions, :exc:`TabError` and :exc:`IndentationError`, have been " "introduced. They're both subclasses of :exc:`SyntaxError`, and are raised " "when Python code is found to be improperly indented." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:601 +#: whatsnew/2.0.rst:601 msgid "Changes to Built-in Functions" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:603 +#: whatsnew/2.0.rst:603 msgid "" "A new built-in, :func:`zip(seq1, seq2, ...)`, has been added. :func:`zip` " "returns a list of tuples where each tuple contains the i-th element from " @@ -760,7 +759,7 @@ msgid "" "truncates the returned list to the length of the shortest argument sequence." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:610 +#: whatsnew/2.0.rst:610 msgid "" "The :func:`int` and :func:`long` functions now accept an optional \"base\" " "parameter when the first argument is a string. ``int('123', 10)`` returns " @@ -769,7 +768,7 @@ msgid "" "explicit base\"." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:616 +#: whatsnew/2.0.rst:616 msgid "" "A new variable holding more detailed version information has been added to " "the :mod:`sys` module. ``sys.version_info`` is a tuple ``(major, minor, " @@ -778,7 +777,7 @@ msgid "" "as ``\"alpha\"``, ``\"beta\"``, or ``\"final\"`` for a final release." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:622 +#: whatsnew/2.0.rst:622 msgid "" "Dictionaries have an odd new method, :meth:`setdefault(key, default)`, which " "behaves similarly to the existing :meth:`get` method. However, if the key " @@ -787,12 +786,12 @@ msgid "" "*key*. Thus, the following lines of code::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:633 +#: whatsnew/2.0.rst:633 msgid "" "can be reduced to a single ``return dict.setdefault(key, [])`` statement." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:635 +#: whatsnew/2.0.rst:635 msgid "" "The interpreter sets a maximum recursion depth in order to catch runaway " "recursion before filling the C stack and causing a core dump or GPF.. " @@ -803,11 +802,11 @@ msgid "" "a new script, :file:`Misc/find_recursionlimit.py`." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:647 +#: whatsnew/2.0.rst:647 msgid "Porting to 2.0" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:649 +#: whatsnew/2.0.rst:649 msgid "" "New Python releases try hard to be compatible with previous releases, and " "the record has been pretty good. However, some changes are considered " @@ -818,7 +817,7 @@ msgid "" msgstr "" # 97a8de02cb07493fbfa1a76d679dbdcc -#: ../src/Doc/whatsnew/2.0.rst:656 +#: whatsnew/2.0.rst:656 msgid "" "The change which will probably break the most code is tightening up the " "arguments accepted by some methods. Some methods would take multiple " @@ -831,7 +830,7 @@ msgid "" "``L.append( (1,2) )``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:665 +#: whatsnew/2.0.rst:665 msgid "" "The earlier versions of these methods were more forgiving because they used " "an old function in Python's C interface to parse their arguments; 2.0 " @@ -843,7 +842,7 @@ msgid "" "this isn't recommended." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:673 +#: whatsnew/2.0.rst:673 msgid "" "Some of the functions in the :mod:`socket` module are still forgiving in " "this way. For example, :func:`socket.connect( ('hostname', 25) )` is the " @@ -858,7 +857,7 @@ msgid "" "again in a future Python version." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:684 +#: whatsnew/2.0.rst:684 msgid "" "The ``\\x`` escape in string literals now takes exactly 2 hex digits. " "Previously it would consume all the hex digits following the 'x' and take " @@ -866,7 +865,7 @@ msgid "" "\\x56``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:688 +#: whatsnew/2.0.rst:688 msgid "" "The :exc:`AttributeError` and :exc:`NameError` exceptions have a more " "friendly error message, whose text will be something like ``'Spam' instance " @@ -875,7 +874,7 @@ msgid "" "to take advantage of this fact will break in 2.0." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:694 +#: whatsnew/2.0.rst:694 msgid "" "Some work has been done to make integers and long integers a bit more " "interchangeable. In 1.5.2, large-file support was added for Solaris, to " @@ -892,7 +891,7 @@ msgid "" "2L**64`` will produce the string ``18446744073709551616``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:708 +#: whatsnew/2.0.rst:708 msgid "" "The subtlest long integer change of all is that the :func:`str` of a long " "integer no longer has a trailing 'L' character, though :func:`repr` still " @@ -903,7 +902,7 @@ msgid "" "the final digit." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:716 +#: whatsnew/2.0.rst:716 msgid "" "Taking the :func:`repr` of a float now uses a different formatting precision " "than :func:`str`. :func:`repr` uses ``%.17g`` format string for C's :func:" @@ -914,7 +913,7 @@ msgid "" "``'8.1'``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:724 +#: whatsnew/2.0.rst:724 msgid "" "The ``-X`` command-line option, which turned all standard exceptions into " "strings instead of classes, has been removed; the standard exceptions will " @@ -923,11 +922,11 @@ msgid "" "Barry Warsaw and Fredrik Lundh." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:740 +#: whatsnew/2.0.rst:740 msgid "Extending/Embedding Changes" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:742 +#: whatsnew/2.0.rst:742 msgid "" "Some of the changes are under the covers, and will only be apparent to " "people writing C extension modules or embedding a Python interpreter in a " @@ -935,7 +934,7 @@ msgid "" "safely skip this section." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:747 +#: whatsnew/2.0.rst:747 msgid "" "The version number of the Python C API was incremented, so C extensions " "compiled for 1.5.2 must be recompiled in order to work with 2.0. On " @@ -944,7 +943,7 @@ msgid "" "exception and the import will fail." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:753 +#: whatsnew/2.0.rst:753 msgid "" "Users of Jim Fulton's ExtensionClass module will be pleased to find out that " "hooks have been added so that ExtensionClasses are now supported by :func:" @@ -953,7 +952,7 @@ msgid "" "use the more natural ``if isinstance(obj, myExtensionClass)``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:759 +#: whatsnew/2.0.rst:759 msgid "" "The :file:`Python/importdl.c` file, which was a mass of #ifdefs to support " "dynamic loading on many different platforms, was cleaned up and reorganised " @@ -964,7 +963,7 @@ msgid "" "into a single file, :file:`Include/pyport.h`." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:767 +#: whatsnew/2.0.rst:767 msgid "" "Vladimir Marangozov's long-awaited malloc restructuring was completed, to " "make it easy to have the Python interpreter use a custom allocator instead " @@ -974,7 +973,7 @@ msgid "" "archives of the 'patches' and 'python-dev' lists at python.org." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:774 +#: whatsnew/2.0.rst:774 msgid "" "Recent versions of the GUSI development environment for MacOS support POSIX " "threads. Therefore, Python's POSIX threading support now works on the " @@ -982,7 +981,7 @@ msgid "" "also contributed." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:779 +#: whatsnew/2.0.rst:779 msgid "" "Threading support on Windows was enhanced, too. Windows supports thread " "locks that use kernel objects only in case of contention; in the common case " @@ -992,14 +991,14 @@ msgid "" "These improvements were contributed by Yakov Markovitch." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:786 +#: whatsnew/2.0.rst:786 msgid "" "Python 2.0's source now uses only ANSI C prototypes, so compiling Python now " "requires an ANSI C compiler, and can no longer be done using a compiler that " "only supports K&R C." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:790 +#: whatsnew/2.0.rst:790 msgid "" "Previously the Python virtual machine used 16-bit numbers in its bytecode, " "limiting the size of source files. In particular, this affected the maximum " @@ -1008,7 +1007,7 @@ msgid "" "Charles G. Waldman raises the limit from ``2^16`` to ``2^{32}``." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:796 +#: whatsnew/2.0.rst:796 msgid "" "Three new convenience functions intended for adding constants to a module's " "dictionary at module initialization time were added: :func:" @@ -1019,17 +1018,17 @@ msgid "" "argument is, respectively, a Python object, a C long, or a C string." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:804 +#: whatsnew/2.0.rst:804 msgid "" "A wrapper API was added for Unix-style signal handlers. :func:`PyOS_getsig` " "gets a signal handler and :func:`PyOS_setsig` will set a new handler." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:811 +#: whatsnew/2.0.rst:811 msgid "Distutils: Making Modules Easy to Install" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:813 +#: whatsnew/2.0.rst:813 msgid "" "Before Python 2.0, installing modules was a tedious affair -- there was no " "way to figure out automatically where Python is installed, or what compiler " @@ -1041,7 +1040,7 @@ msgid "" "something of a chore." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:821 +#: whatsnew/2.0.rst:821 msgid "" "The SIG for distribution utilities, shepherded by Greg Ward, has created the " "Distutils, a system to make package installation much easier. They form " @@ -1057,26 +1056,26 @@ msgid "" "directories, and more." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:833 +#: whatsnew/2.0.rst:833 msgid "" "In order to use the Distutils, you need to write a :file:`setup.py` script. " "For the simple case, when the software contains only .py files, a minimal :" "file:`setup.py` can be just a few lines long::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:841 +#: whatsnew/2.0.rst:841 msgid "" "The :file:`setup.py` file isn't much more complicated if the software " "consists of a few packages::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:848 +#: whatsnew/2.0.rst:848 msgid "" "A C extension can be the most complicated case; here's an example taken from " "the PyXML package::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:864 +#: whatsnew/2.0.rst:864 msgid "" "The Distutils can also take care of creating source and binary " "distributions. The \"sdist\" command, run by \"``python setup.py sdist``', " @@ -1088,17 +1087,17 @@ msgid "" "are in various stages of development." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:873 +#: whatsnew/2.0.rst:873 msgid "" "All this is documented in a new manual, *Distributing Python Modules*, that " "joins the basic set of Python documentation." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:880 +#: whatsnew/2.0.rst:880 msgid "XML Modules" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:882 +#: whatsnew/2.0.rst:882 msgid "" "Python 1.5.2 included a simple XML parser in the form of the :mod:`xmllib` " "module, contributed by Sjoerd Mullender. Since 1.5.2's release, two " @@ -1113,11 +1112,11 @@ msgid "" "also working on improved documentation." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:896 +#: whatsnew/2.0.rst:896 msgid "SAX2 Support" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:898 +#: whatsnew/2.0.rst:898 msgid "" "SAX defines an event-driven interface for parsing XML. To use SAX, you must " "write a SAX handler class. Handler classes inherit from various classes " @@ -1128,7 +1127,7 @@ msgid "" "character data, and so forth." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:906 +#: whatsnew/2.0.rst:906 msgid "" "The advantage of the event-driven approach is that the whole document " "doesn't have to be resident in memory at any one time, which matters if you " @@ -1137,24 +1136,24 @@ msgid "" "structure in some elaborate way." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:912 +#: whatsnew/2.0.rst:912 msgid "" "For example, this little example program defines a handler that prints a " "message for every starting and ending tag, and then parses the file :file:" "`hamlet.xml` using it::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:935 +#: whatsnew/2.0.rst:935 msgid "" "For more information, consult the Python documentation, or the XML HOWTO at " "http://pyxml.sourceforge.net/topics/howto/xml-howto.html." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:940 +#: whatsnew/2.0.rst:940 msgid "DOM Support" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:942 +#: whatsnew/2.0.rst:942 msgid "" "The Document Object Model is a tree-based representation for an XML " "document. A top-level :class:`Document` instance is the root of the tree, " @@ -1166,7 +1165,7 @@ msgid "" "back into XML." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:950 +#: whatsnew/2.0.rst:950 msgid "" "The DOM is useful for modifying XML documents, because you can create a DOM " "tree, modify it by adding new nodes or rearranging subtrees, and then " @@ -1176,7 +1175,7 @@ msgid "" "file." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:956 +#: whatsnew/2.0.rst:956 msgid "" "The DOM implementation included with Python lives in the :mod:`xml.dom." "minidom` module. It's a lightweight implementation of the Level 1 DOM with " @@ -1184,7 +1183,7 @@ msgid "" "convenience functions are provided for generating a DOM tree::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:964 +#: whatsnew/2.0.rst:964 msgid "" "``doc`` is a :class:`Document` instance. :class:`Document`, like all the " "other DOM classes such as :class:`Element` and :class:`Text`, is a subclass " @@ -1196,29 +1195,29 @@ msgid "" "given tag name. Continuing from the previous 2-line example::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:977 +#: whatsnew/2.0.rst:977 msgid "For the *Hamlet* XML file, the above few lines output::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:982 +#: whatsnew/2.0.rst:982 msgid "" "The root element of the document is available as ``doc.documentElement``, " "and its children can be easily modified by deleting, adding, or removing " "nodes::" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:997 +#: whatsnew/2.0.rst:997 msgid "" "Again, I will refer you to the Python documentation for a complete listing " "of the different :class:`Node` classes and their various methods." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1002 +#: whatsnew/2.0.rst:1002 msgid "Relationship to PyXML" msgstr "" # 0a379dc17e784e2a8ec0eac510412cb9 -#: ../src/Doc/whatsnew/2.0.rst:1004 +#: whatsnew/2.0.rst:1004 msgid "" "The XML Special Interest Group has been working on XML-related Python code " "for a while. Its code distribution, called PyXML, is available from the " @@ -1228,7 +1227,7 @@ msgid "" "compatibility with the 2.0 :mod:`xml` package." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1010 +#: whatsnew/2.0.rst:1010 msgid "" "The answer is that Python 2.0's :mod:`xml` package isn't compatible with " "PyXML, but can be made compatible by installing a recent version PyXML. " @@ -1240,23 +1239,23 @@ msgid "" "features. Some of the additional features in PyXML include:" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1019 +#: whatsnew/2.0.rst:1019 msgid "4DOM, a full DOM implementation from FourThought, Inc." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1021 +#: whatsnew/2.0.rst:1021 msgid "The xmlproc validating parser, written by Lars Marius Garshol." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1023 +#: whatsnew/2.0.rst:1023 msgid "The :mod:`sgmlop` parser accelerator module, written by Fredrik Lundh." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1029 +#: whatsnew/2.0.rst:1029 msgid "Module changes" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1031 +#: whatsnew/2.0.rst:1031 msgid "" "Lots of improvements and bugfixes were made to Python's extensive standard " "library; some of the affected modules include :mod:`readline`, :mod:" @@ -1266,7 +1265,7 @@ msgid "" "details." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1037 +#: whatsnew/2.0.rst:1037 msgid "" "Brian Gallew contributed OpenSSL support for the :mod:`socket` module. " "OpenSSL is an implementation of the Secure Socket Layer, which encrypts the " @@ -1278,7 +1277,7 @@ msgid "" "though no one has implemented FTP or SMTP over SSL." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1046 +#: whatsnew/2.0.rst:1046 msgid "" "The :mod:`httplib` module has been rewritten by Greg Stein to support " "HTTP/1.1. Backward compatibility with the 1.5 version of :mod:`httplib` is " @@ -1286,7 +1285,7 @@ msgid "" "rewriting code to use a different set of interfaces." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1051 +#: whatsnew/2.0.rst:1051 msgid "" "The :mod:`Tkinter` module now supports Tcl/Tk version 8.1, 8.2, or 8.3, and " "support for the older 7.x versions has been dropped. The Tkinter module now " @@ -1295,7 +1294,7 @@ msgid "" "``create_polygon`` much faster, especially when using lots of coordinates." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1057 +#: whatsnew/2.0.rst:1057 msgid "" "The :mod:`curses` module has been greatly extended, starting from Oliver " "Andrich's enhanced version, to provide many additional functions from " @@ -1305,7 +1304,7 @@ msgid "" "currently maintained OSes that fall into this category." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1064 +#: whatsnew/2.0.rst:1064 msgid "" "As mentioned in the earlier discussion of 2.0's Unicode support, the " "underlying implementation of the regular expressions provided by the :mod:" @@ -1314,18 +1313,18 @@ msgid "" "against both 8-bit strings and Unicode strings." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1074 +#: whatsnew/2.0.rst:1074 msgid "New modules" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1076 +#: whatsnew/2.0.rst:1076 msgid "" "A number of new modules were added. We'll simply list them with brief " "descriptions; consult the 2.0 documentation for the details of a particular " "module." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1080 +#: whatsnew/2.0.rst:1080 msgid "" ":mod:`atexit`: For registering functions to be called before the Python " "interpreter exits. Code that currently sets ``sys.exitfunc`` directly should " @@ -1334,20 +1333,20 @@ msgid "" "(Contributed by Skip Montanaro.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1086 +#: whatsnew/2.0.rst:1086 msgid "" ":mod:`codecs`, :mod:`encodings`, :mod:`unicodedata`: Added as part of the " "new Unicode support." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1089 +#: whatsnew/2.0.rst:1089 msgid "" ":mod:`filecmp`: Supersedes the old :mod:`cmp`, :mod:`cmpcache` and :mod:" "`dircmp` modules, which have now become deprecated. (Contributed by Gordon " "MacMillan and Moshe Zadka.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1093 +#: whatsnew/2.0.rst:1093 msgid "" ":mod:`gettext`: This module provides internationalization (I18N) and " "localization (L10N) support for Python programs by providing an interface to " @@ -1356,14 +1355,14 @@ msgid "" "Henstridge.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1098 +#: whatsnew/2.0.rst:1098 msgid "" ":mod:`linuxaudiodev`: Support for the :file:`/dev/audio` device on Linux, a " "twin to the existing :mod:`sunaudiodev` module. (Contributed by Peter Bosch, " "with fixes by Jeremy Hylton.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1102 +#: whatsnew/2.0.rst:1102 msgid "" ":mod:`mmap`: An interface to memory-mapped files on both Windows and Unix. " "A file's contents can be mapped directly into memory, at which point it " @@ -1373,13 +1372,13 @@ msgid "" "M. Kuchling.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1108 +#: whatsnew/2.0.rst:1108 msgid "" ":mod:`pyexpat`: An interface to the Expat XML parser. (Contributed by Paul " "Prescod.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1111 +#: whatsnew/2.0.rst:1111 msgid "" ":mod:`robotparser`: Parse a :file:`robots.txt` file, which is used for " "writing Web spiders that politely avoid certain areas of a Web site. The " @@ -1388,19 +1387,19 @@ msgid "" "given URL. (Contributed by Skip Montanaro.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1117 +#: whatsnew/2.0.rst:1117 msgid "" ":mod:`tabnanny`: A module/script to check Python source code for ambiguous " "indentation. (Contributed by Tim Peters.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1120 +#: whatsnew/2.0.rst:1120 msgid "" ":mod:`UserString`: A base class useful for deriving objects that behave like " "strings." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1123 +#: whatsnew/2.0.rst:1123 msgid "" ":mod:`webbrowser`: A module that provides a platform independent way to " "launch a web browser on a specific URL. For each platform, various browsers " @@ -1412,7 +1411,7 @@ msgid "" "Fred.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1132 +#: whatsnew/2.0.rst:1132 msgid "" ":mod:`_winreg`: An interface to the Windows registry. :mod:`_winreg` is an " "adaptation of functions that have been part of PythonWin since 1995, but has " @@ -1420,7 +1419,7 @@ msgid "" "mod:`_winreg` was written by Bill Tutt and Mark Hammond." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1137 +#: whatsnew/2.0.rst:1137 msgid "" ":mod:`zipfile`: A module for reading and writing ZIP-format archives. These " "are archives produced by :program:`PKZIP` on DOS/Windows or :program:`zip` " @@ -1428,7 +1427,7 @@ msgid "" "supported by the :mod:`gzip` module) (Contributed by James C. Ahlstrom.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1142 +#: whatsnew/2.0.rst:1142 msgid "" ":mod:`imputil`: A module that provides a simpler way for writing customised " "import hooks, in comparison to the existing :mod:`ihooks` module. " @@ -1436,70 +1435,70 @@ msgid "" "way.)" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1150 +#: whatsnew/2.0.rst:1150 msgid "IDLE Improvements" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1152 +#: whatsnew/2.0.rst:1152 msgid "" "IDLE is the official Python cross-platform IDE, written using Tkinter. " "Python 2.0 includes IDLE 0.6, which adds a number of new features and " "improvements. A partial list:" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1156 +#: whatsnew/2.0.rst:1156 msgid "" "UI improvements and optimizations, especially in the area of syntax " "highlighting and auto-indentation." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1159 +#: whatsnew/2.0.rst:1159 msgid "" "The class browser now shows more information, such as the top level " "functions in a module." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1162 +#: whatsnew/2.0.rst:1162 msgid "" "Tab width is now a user settable option. When opening an existing Python " "file, IDLE automatically detects the indentation conventions, and adapts." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1165 +#: whatsnew/2.0.rst:1165 msgid "" "There is now support for calling browsers on various platforms, used to open " "the Python documentation in a browser." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1168 +#: whatsnew/2.0.rst:1168 msgid "" "IDLE now has a command line, which is largely similar to the vanilla Python " "interpreter." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1171 +#: whatsnew/2.0.rst:1171 msgid "Call tips were added in many places." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1173 +#: whatsnew/2.0.rst:1173 msgid "IDLE can now be installed as a package." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1175 +#: whatsnew/2.0.rst:1175 msgid "In the editor window, there is now a line/column bar at the bottom." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1177 +#: whatsnew/2.0.rst:1177 msgid "" -"Three new keystroke commands: Check module (Alt-F5), Import module (F5) and " -"Run script (Ctrl-F5)." +"Three new keystroke commands: Check module (:kbd:`Alt-F5`), Import module (:" +"kbd:`F5`) and Run script (:kbd:`Ctrl-F5`)." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1184 +#: whatsnew/2.0.rst:1184 msgid "Deleted and Deprecated Modules" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1186 +#: whatsnew/2.0.rst:1186 msgid "" "A few modules have been dropped because they're obsolete, or because there " "are now better ways to do the same thing. The :mod:`stdwin` module is gone; " @@ -1507,7 +1506,7 @@ msgid "" "developed." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1190 +#: whatsnew/2.0.rst:1190 msgid "" "A number of modules have been moved to the :file:`lib-old` subdirectory: :" "mod:`cmp`, :mod:`cmpcache`, :mod:`dircmp`, :mod:`dump`, :mod:`find`, :mod:" @@ -1517,14 +1516,13 @@ msgid "" "them back, but you're encouraged to update any code that uses these modules." msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1199 ../src/Doc/whatsnew/2.1.rst:789 -#: ../src/Doc/whatsnew/2.2.rst:1260 ../src/Doc/whatsnew/2.3.rst:2071 -#: ../src/Doc/whatsnew/2.4.rst:1557 ../src/Doc/whatsnew/2.5.rst:2280 -#: ../src/Doc/whatsnew/2.6.rst:3304 ../src/Doc/whatsnew/2.7.rst:2650 +#: whatsnew/2.0.rst:1199 whatsnew/2.1.rst:789 whatsnew/2.2.rst:1260 +#: whatsnew/2.3.rst:2071 whatsnew/2.4.rst:1557 whatsnew/2.5.rst:2280 +#: whatsnew/2.6.rst:3304 whatsnew/2.7.rst:2678 msgid "Acknowledgements" msgstr "" -#: ../src/Doc/whatsnew/2.0.rst:1201 +#: whatsnew/2.0.rst:1201 msgid "" "The authors would like to thank the following people for offering " "suggestions on various drafts of this article: David Bolen, Mark Hammond, " @@ -1533,18 +1531,17 @@ msgid "" "Schemenauer, and Russ Schmidt." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:3 +#: whatsnew/2.1.rst:3 #, fuzzy msgid "What's New in Python 2.1" msgstr "Nouveautés de Python 2.0" -#: ../src/Doc/whatsnew/2.1.rst:5 ../src/Doc/whatsnew/2.2.rst:5 -#: ../src/Doc/whatsnew/2.3.rst:5 ../src/Doc/whatsnew/2.4.rst:5 -#: ../src/Doc/whatsnew/2.5.rst:5 +#: whatsnew/2.1.rst:5 whatsnew/2.2.rst:5 whatsnew/2.3.rst:5 whatsnew/2.4.rst:5 +#: whatsnew/2.5.rst:5 msgid "A.M. Kuchling" msgstr "A.M. Kuchling" -#: ../src/Doc/whatsnew/2.1.rst:15 +#: whatsnew/2.1.rst:15 msgid "" "This article explains the new features in Python 2.1. While there aren't as " "many changes in 2.1 as there were in Python 2.0, there are still some " @@ -1558,7 +1555,7 @@ msgid "" "particularly interests you." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:25 +#: whatsnew/2.1.rst:25 msgid "" "One recent goal of the Python development team has been to accelerate the " "pace of new releases, with a new release coming every 6 to 9 months. 2.1 is " @@ -1566,15 +1563,15 @@ msgid "" "appearing in January, 3 months after the final version of 2.0 was released." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:30 +#: whatsnew/2.1.rst:30 msgid "The final release of Python 2.1 was made on April 17, 2001." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:36 ../src/Doc/whatsnew/2.2.rst:839 +#: whatsnew/2.1.rst:36 whatsnew/2.2.rst:839 msgid "PEP 227: Nested Scopes" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:38 +#: whatsnew/2.1.rst:38 msgid "" "The largest change in Python 2.1 is to Python's scoping rules. In Python " "2.0, at any given time there are at most three namespaces used to look up " @@ -1583,7 +1580,7 @@ msgid "" "example, a nested recursive function definition doesn't work::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:51 ../src/Doc/whatsnew/2.2.rst:862 +#: whatsnew/2.1.rst:51 whatsnew/2.2.rst:862 msgid "" "The function :func:`g` will always raise a :exc:`NameError` exception, " "because the binding of the name ``g`` isn't in either its local namespace or " @@ -1595,13 +1592,13 @@ msgid "" "arguments. ::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:65 ../src/Doc/whatsnew/2.2.rst:876 +#: whatsnew/2.1.rst:65 whatsnew/2.2.rst:876 msgid "" "The readability of Python code written in a strongly functional style " "suffers greatly as a result." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:68 +#: whatsnew/2.1.rst:68 msgid "" "The most significant change to Python 2.1 is that static scoping has been " "added to the language to fix this problem. As a first effect, the " @@ -1613,7 +1610,7 @@ msgid "" "rules, and a dissection of the implementation, can be found in the PEP." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:77 ../src/Doc/whatsnew/2.2.rst:888 +#: whatsnew/2.1.rst:77 whatsnew/2.2.rst:888 msgid "" "This change may cause some compatibility problems for code where the same " "variable name is used both at the module level and as a local variable " @@ -1622,7 +1619,7 @@ msgid "" "read in the first place." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:83 ../src/Doc/whatsnew/2.2.rst:894 +#: whatsnew/2.1.rst:83 whatsnew/2.2.rst:894 msgid "" "One side effect of the change is that the ``from module import *`` and :" "keyword:`exec` statements have been made illegal inside a function scope " @@ -1639,25 +1636,25 @@ msgid "" "exception." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:96 ../src/Doc/whatsnew/2.2.rst:907 +#: whatsnew/2.1.rst:96 whatsnew/2.2.rst:907 msgid "To make the preceding explanation a bit clearer, here's an example::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:105 ../src/Doc/whatsnew/2.2.rst:916 +#: whatsnew/2.1.rst:105 whatsnew/2.2.rst:916 msgid "" "Line 4 containing the :keyword:`exec` statement is a syntax error, since :" "keyword:`exec` would define a new local variable named ``x`` whose value " "should be accessed by :func:`g`." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:109 ../src/Doc/whatsnew/2.2.rst:920 +#: whatsnew/2.1.rst:109 whatsnew/2.2.rst:920 msgid "" "This shouldn't be much of a limitation, since :keyword:`exec` is rarely used " "in most Python code (and when it is used, it's often a sign of a poor design " "anyway)." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:113 +#: whatsnew/2.1.rst:113 msgid "" "Compatibility concerns have led to nested scopes being introduced gradually; " "in Python 2.1, they aren't enabled by default, but can be turned on within a " @@ -1670,20 +1667,20 @@ msgstr "" # d027fc4aa5274049bf8ac7f82f843e9d # 586aceac72fb40a0b26bce3d05a1e413 -#: ../src/Doc/whatsnew/2.1.rst:122 ../src/Doc/whatsnew/2.2.rst:926 +#: whatsnew/2.1.rst:123 whatsnew/2.2.rst:927 #, fuzzy -msgid ":pep:`227` - Statically Nested Scopes" +msgid "PEP 227 - Statically Nested Scopes" msgstr ":pep:`227`: *Statically Nested Scopes*" -#: ../src/Doc/whatsnew/2.1.rst:124 ../src/Doc/whatsnew/2.2.rst:928 +#: whatsnew/2.1.rst:124 whatsnew/2.2.rst:928 msgid "Written and implemented by Jeremy Hylton." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:130 +#: whatsnew/2.1.rst:130 msgid "PEP 236: __future__ Directives" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:132 +#: whatsnew/2.1.rst:132 msgid "" "The reaction to nested scopes was widespread concern about the dangers of " "breaking code with the 2.1 release, and it was strong enough to make the " @@ -1692,14 +1689,14 @@ msgid "" "that will become compulsory in release N+1." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:138 +#: whatsnew/2.1.rst:138 msgid "" "The syntax uses a ``from...import`` statement using the reserved module " "name :mod:`__future__`. Nested scopes can be enabled by the following " "statement::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:143 +#: whatsnew/2.1.rst:143 msgid "" "While it looks like a normal :keyword:`import` statement, it's not; there " "are strict rules on where such a future statement can be put. They can only " @@ -1709,20 +1706,19 @@ msgid "" "must precede any statement that will result in bytecodes being produced." msgstr "" -# 0ac3098651244dd4aa121ea4368c926b -#: ../src/Doc/whatsnew/2.1.rst:152 -msgid ":pep:`236` - Back to the :mod:`__future__`" +#: whatsnew/2.1.rst:153 +msgid "PEP 236 - Back to the __future__" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:154 +#: whatsnew/2.1.rst:154 msgid "Written by Tim Peters, and primarily implemented by Jeremy Hylton." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:160 +#: whatsnew/2.1.rst:160 msgid "PEP 207: Rich Comparisons" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:162 +#: whatsnew/2.1.rst:162 msgid "" "In earlier versions, Python's support for implementing comparisons on user- " "defined classes and extension types was quite simple. Classes could " @@ -1738,7 +1734,7 @@ msgid "" "error." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:174 +#: whatsnew/2.1.rst:174 msgid "" "In Python 2.1, rich comparisons were added in order to support this need. " "Python classes can now individually overload each of the ``<``, ``<=``, " @@ -1746,70 +1742,70 @@ msgid "" "are:" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:179 ../src/Doc/whatsnew/2.5.rst:1807 +#: whatsnew/2.1.rst:179 whatsnew/2.5.rst:1807 msgid "Operation" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:179 +#: whatsnew/2.1.rst:179 msgid "Method name" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:181 +#: whatsnew/2.1.rst:181 msgid "``<``" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:181 +#: whatsnew/2.1.rst:181 msgid ":meth:`__lt__`" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:183 +#: whatsnew/2.1.rst:183 msgid "``<=``" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:183 +#: whatsnew/2.1.rst:183 msgid ":meth:`__le__`" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:185 +#: whatsnew/2.1.rst:185 msgid "``>``" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:185 +#: whatsnew/2.1.rst:185 msgid ":meth:`__gt__`" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:187 +#: whatsnew/2.1.rst:187 msgid "``>=``" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:187 +#: whatsnew/2.1.rst:187 msgid ":meth:`__ge__`" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:189 +#: whatsnew/2.1.rst:189 msgid "``==``" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:189 +#: whatsnew/2.1.rst:189 msgid ":meth:`__eq__`" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:191 +#: whatsnew/2.1.rst:191 msgid "``!=``" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:191 +#: whatsnew/2.1.rst:191 msgid ":meth:`__ne__`" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:194 +#: whatsnew/2.1.rst:194 msgid "" "(The magic methods are named after the corresponding Fortran operators ``.LT." "``. ``.LE.``, &c. Numeric programmers are almost certainly quite familiar " "with these names and will find them easy to remember.)" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:198 +#: whatsnew/2.1.rst:198 msgid "" "Each of these magic methods is of the form ``method(self, other)``, where " "``self`` will be the object on the left-hand side of the operator, while " @@ -1817,7 +1813,7 @@ msgid "" "expression ``A < B`` will cause ``A.__lt__(B)`` to be called." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:203 +#: whatsnew/2.1.rst:203 msgid "" "Each of these magic methods can return anything at all: a Boolean, a matrix, " "a list, or any other Python object. Alternatively they can raise an " @@ -1825,7 +1821,7 @@ msgid "" "meaningless." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:207 +#: whatsnew/2.1.rst:207 msgid "" "The built-in :func:`cmp(A,B)` function can use the rich comparison " "machinery, and now accepts an optional argument specifying which comparison " @@ -1836,7 +1832,7 @@ msgid "" "and can return any Python object." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:214 +#: whatsnew/2.1.rst:214 msgid "" "There are also corresponding changes of interest to C programmers; there's a " "new slot ``tp_richcmp`` in type objects and an API for performing a given " @@ -1844,22 +1840,21 @@ msgid "" "207, or to 2.1's C API documentation, for the full list of related functions." msgstr "" -# 8310c515b99d402493662d62d2ffd48a -#: ../src/Doc/whatsnew/2.1.rst:222 -msgid ":pep:`207` - Rich Comparisions" +#: whatsnew/2.1.rst:223 +msgid "PEP 207 - Rich Comparisions" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:223 +#: whatsnew/2.1.rst:223 msgid "" "Written by Guido van Rossum, heavily based on earlier work by David Ascher, " "and implemented by Guido van Rossum." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:230 +#: whatsnew/2.1.rst:230 msgid "PEP 230: Warning Framework" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:232 +#: whatsnew/2.1.rst:232 msgid "" "Over its 10 years of existence, Python has accumulated a certain number of " "obsolete modules and features along the way. It's difficult to know when a " @@ -1872,7 +1867,7 @@ msgid "" "a full release cycle to remove uses of the old feature." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:242 +#: whatsnew/2.1.rst:242 msgid "" "Python 2.1 adds the warning framework to be used in this scheme. It adds a :" "mod:`warnings` module that provide functions to issue warnings, and to " @@ -1881,23 +1876,23 @@ msgid "" "wish to support." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:248 +#: whatsnew/2.1.rst:248 msgid "" "For example, in Python 2.1 the :mod:`regex` module is deprecated, so " "importing it causes a warning to be printed::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:256 +#: whatsnew/2.1.rst:256 msgid "Warnings can be issued by calling the :func:`warnings.warn` function::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:260 +#: whatsnew/2.1.rst:260 msgid "" "The first parameter is the warning message; an additional optional " "parameters can be used to specify a particular warning category." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:263 +#: whatsnew/2.1.rst:263 msgid "" "Filters can be added to disable certain warnings; a regular expression " "pattern can be applied to the message or to the module name in order to " @@ -1906,7 +1901,7 @@ msgid "" "`re` module right now. The warning can be suppressed by calling ::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:275 +#: whatsnew/2.1.rst:275 msgid "" "This adds a filter that will apply only to warnings of the class :class:" "`DeprecationWarning` triggered in the :mod:`__main__` module, and applies a " @@ -1917,18 +1912,17 @@ msgid "" "(unless the exceptions are caught in the usual way, of course)." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:283 +#: whatsnew/2.1.rst:283 msgid "" "Functions were also added to Python's C API for issuing warnings; refer to " "PEP 230 or to Python's API documentation for the details." msgstr "" -# 2a808a0c1b544575af469cd78f9c1a6c -#: ../src/Doc/whatsnew/2.1.rst:292 -msgid ":pep:`5` - Guidelines for Language Evolution" +#: whatsnew/2.1.rst:293 +msgid "PEP 5 - Guidelines for Language Evolution" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:290 +#: whatsnew/2.1.rst:290 msgid "" "Written by Paul Prescod, to specify procedures to be followed when removing " "old features from Python. The policy described in this PEP hasn't been " @@ -1937,20 +1931,20 @@ msgid "" msgstr "" # 0a8b0defb9e54319bc7e4d67f38bf092 -#: ../src/Doc/whatsnew/2.1.rst:294 +#: whatsnew/2.1.rst:295 #, fuzzy -msgid ":pep:`230` - Warning Framework" +msgid "PEP 230 - Warning Framework" msgstr ":pep:`230` -- Gestion des alertes" -#: ../src/Doc/whatsnew/2.1.rst:296 +#: whatsnew/2.1.rst:296 msgid "Written and implemented by Guido van Rossum." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:302 +#: whatsnew/2.1.rst:302 msgid "PEP 229: New Build System" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:304 +#: whatsnew/2.1.rst:304 msgid "" "When compiling Python, the user had to go in and edit the :file:`Modules/" "Setup` file in order to enable various additional modules; the default set " @@ -1960,7 +1954,7 @@ msgid "" "they could." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:310 +#: whatsnew/2.1.rst:310 msgid "" "Python 2.0 added the Distutils, a set of modules for distributing and " "installing extensions. In Python 2.1, the Distutils are used to compile " @@ -1969,7 +1963,7 @@ msgid "" "installations easier and more featureful." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:316 +#: whatsnew/2.1.rst:316 msgid "" "Instead of having to edit the :file:`Modules/Setup` file in order to enable " "modules, a :file:`setup.py` script in the top directory of the Python source " @@ -1981,7 +1975,7 @@ msgid "" "line flags or libraries that are required for a specific platform." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:325 +#: whatsnew/2.1.rst:325 msgid "" "In another far-reaching change to the build mechanism, Neil Schemenauer " "restructured things so Python now uses a single makefile that isn't " @@ -1991,26 +1985,25 @@ msgid "" "the Makefiles clearer and simpler." msgstr "" -# 97d05992caf3405e8e22b9c1cb54a2e6 -#: ../src/Doc/whatsnew/2.1.rst:334 -msgid ":pep:`229` - Using Distutils to Build Python" +#: whatsnew/2.1.rst:335 +msgid "PEP 229 - Using Distutils to Build Python" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:336 ../src/Doc/whatsnew/2.1.rst:571 +#: whatsnew/2.1.rst:336 whatsnew/2.1.rst:571 msgid "Written and implemented by A.M. Kuchling." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:342 +#: whatsnew/2.1.rst:342 msgid "PEP 205: Weak References" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:344 +#: whatsnew/2.1.rst:344 msgid "" "Weak references, available through the :mod:`weakref` module, are a minor " "but useful new data type in the Python programmer's toolbox." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:347 +#: whatsnew/2.1.rst:347 msgid "" "Storing a reference to an object (say, in a dictionary or a list) has the " "side effect of keeping that object alive forever. There are a few specific " @@ -2019,14 +2012,14 @@ msgid "" "trees." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:352 +#: whatsnew/2.1.rst:352 msgid "" "For example, consider a memoizing function that caches the results of " "another function :func:`f(x)` by storing the function's argument and its " "result in a dictionary::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:368 +#: whatsnew/2.1.rst:368 msgid "" "This version works for simple things such as integers, but it has a side " "effect; the ``_cache`` dictionary holds a reference to the return values, so " @@ -2035,7 +2028,7 @@ msgid "" "or a data structure that takes up a lot of memory, this can be a problem." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:374 +#: whatsnew/2.1.rst:374 msgid "" "Weak references provide a way to implement a cache that won't keep objects " "alive beyond their time. If an object is only accessible through weak " @@ -2047,13 +2040,13 @@ msgid "" "``None`` if the object no longer exists." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:382 +#: whatsnew/2.1.rst:382 msgid "" "This makes it possible to write a :func:`memoize` function whose cache " "doesn't keep objects alive, by storing weak references in the cache. ::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:400 +#: whatsnew/2.1.rst:400 msgid "" "The :mod:`weakref` module also allows creating proxy objects which behave " "like weak references --- an object referenced only by proxy objects is " @@ -2064,20 +2057,19 @@ msgid "" "raised. ::" msgstr "" -# e57485a7360c4b1988dbe9bdee02146c -#: ../src/Doc/whatsnew/2.1.rst:415 -msgid ":pep:`205` - Weak References" +#: whatsnew/2.1.rst:416 +msgid "PEP 205 - Weak References" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:417 +#: whatsnew/2.1.rst:417 msgid "Written and implemented by Fred L. Drake, Jr." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:423 +#: whatsnew/2.1.rst:423 msgid "PEP 232: Function Attributes" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:425 +#: whatsnew/2.1.rst:425 msgid "" "In Python 2.1, functions can now have arbitrary information attached to " "them. People were often using docstrings to hold information about functions " @@ -2091,13 +2083,13 @@ msgid "" "use in Zope." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:435 +#: whatsnew/2.1.rst:435 msgid "" "Arbitrary attributes can now be set and retrieved on functions using the " "regular Python syntax::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:444 +#: whatsnew/2.1.rst:444 msgid "" "The dictionary containing attributes can be accessed as the function's :attr:" "`__dict__`. Unlike the :attr:`__dict__` attribute of class instances, in " @@ -2107,20 +2099,19 @@ msgid "" "random object that behaves like a mapping." msgstr "" -# 8abd0713478b4753b8dff0432d4e5223 -#: ../src/Doc/whatsnew/2.1.rst:453 -msgid ":pep:`232` - Function Attributes" +#: whatsnew/2.1.rst:454 +msgid "PEP 232 - Function Attributes" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:455 +#: whatsnew/2.1.rst:455 msgid "Written and implemented by Barry Warsaw." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:461 +#: whatsnew/2.1.rst:461 msgid "PEP 235: Importing Modules on Case-Insensitive Platforms" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:463 +#: whatsnew/2.1.rst:463 msgid "" "Some operating systems have filesystems that are case-insensitive, MacOS and " "Windows being the primary examples; on these systems, it's impossible to " @@ -2128,7 +2119,7 @@ msgid "" "store the file's name in its original case (they're case-preserving, too)." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:468 +#: whatsnew/2.1.rst:468 msgid "" "In Python 2.1, the :keyword:`import` statement will work to simulate case- " "sensitivity on case-insensitive platforms. Python will now search for the " @@ -2138,11 +2129,11 @@ msgid "" "`PYTHONCASEOK` environment variable before starting the Python interpreter." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:479 +#: whatsnew/2.1.rst:479 msgid "PEP 217: Interactive Display Hook" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:481 +#: whatsnew/2.1.rst:481 msgid "" "When using the Python interpreter interactively, the output of commands is " "displayed using the built-in :func:`repr` function. In Python 2.1, the " @@ -2151,27 +2142,26 @@ msgid "" "pretty- printing function::" msgstr "" -# 3c6ec165a4d54f67bfdee682e60a4032 -#: ../src/Doc/whatsnew/2.1.rst:501 -msgid ":pep:`217` - Display Hook for Interactive Use" +#: whatsnew/2.1.rst:502 +msgid "PEP 217 - Display Hook for Interactive Use" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:503 +#: whatsnew/2.1.rst:503 msgid "Written and implemented by Moshe Zadka." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:509 +#: whatsnew/2.1.rst:509 msgid "PEP 208: New Coercion Model" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:511 +#: whatsnew/2.1.rst:511 msgid "" "How numeric coercion is done at the C level was significantly modified. " "This will only affect the authors of C extensions to Python, allowing them " "more flexibility in writing extension types that support numeric operations." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:515 +#: whatsnew/2.1.rst:515 msgid "" "Extension types can now set the type flag ``Py_TPFLAGS_CHECKTYPES`` in their " "``PyTypeObject`` structure to indicate that they support the new coercion " @@ -2189,23 +2179,22 @@ msgid "" "object's numeric methods)." msgstr "" -# 55dd10f8b92646df8432f31d16a1bd95 -#: ../src/Doc/whatsnew/2.1.rst:533 -msgid ":pep:`208` - Reworking the Coercion Model" +#: whatsnew/2.1.rst:534 +msgid "PEP 208 - Reworking the Coercion Model" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:533 +#: whatsnew/2.1.rst:533 msgid "" "Written and implemented by Neil Schemenauer, heavily based upon earlier work " "by Marc-André Lemburg. Read this to understand the fine points of how " "numeric operations will now be processed at the C level." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:541 +#: whatsnew/2.1.rst:541 msgid "PEP 241: Metadata in Python Packages" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:543 +#: whatsnew/2.1.rst:543 msgid "" "A common complaint from Python users is that there's no single catalog of " "all the Python modules in existence. T. Middleton's Vaults of Parnassus at " @@ -2214,7 +2203,7 @@ msgid "" msgstr "" # fd8cede95806481994f69e5938903c0f -#: ../src/Doc/whatsnew/2.1.rst:548 +#: whatsnew/2.1.rst:548 msgid "" "As a first small step toward fixing the problem, Python software packaged " "using the Distutils :command:`sdist` command will include a file named :file:" @@ -2231,7 +2220,7 @@ msgid "" msgstr "" # 73c046415e98401db54db638886142aa -#: ../src/Doc/whatsnew/2.1.rst:561 +#: whatsnew/2.1.rst:561 msgid "" "You can start creating packages containing :file:`PKG-INFO` even if you're " "not using Python 2.1, since a new release of the Distutils will be made for " @@ -2241,28 +2230,26 @@ msgid "" "python.org/sigs/distutils-sig/." msgstr "" -# 5c6f99707ecf4ea09ea3795b6ec4f0ed -#: ../src/Doc/whatsnew/2.1.rst:570 -msgid ":pep:`241` - Metadata for Python Software Packages" +#: whatsnew/2.1.rst:571 +msgid "PEP 241 - Metadata for Python Software Packages" msgstr "" -# 35ca7fdd774e4d5d85332286b60a232d -#: ../src/Doc/whatsnew/2.1.rst:573 -msgid ":pep:`243` - Module Repository Upload Mechanism" +#: whatsnew/2.1.rst:574 +msgid "PEP 243 - Module Repository Upload Mechanism" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:574 +#: whatsnew/2.1.rst:574 msgid "" "Written by Sean Reifschneider, this draft PEP describes a proposed mechanism " "for uploading Python packages to a central server." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:581 ../src/Doc/whatsnew/2.2.rst:934 -#: ../src/Doc/whatsnew/2.6.rst:1779 ../src/Doc/whatsnew/2.7.rst:1010 +#: whatsnew/2.1.rst:581 whatsnew/2.2.rst:934 whatsnew/2.6.rst:1779 +#: whatsnew/2.7.rst:1010 msgid "New and Improved Modules" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:583 +#: whatsnew/2.1.rst:583 msgid "" "Ka-Ping Yee contributed two new modules: :mod:`inspect.py`, a module for " "getting information about live Python code, and :mod:`pydoc.py`, a module " @@ -2272,13 +2259,13 @@ msgid "" "name. For example, ``pydoc xml.dom`` displays the following::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:605 +#: whatsnew/2.1.rst:605 msgid "" ":file:`pydoc` also includes a Tk-based interactive help browser. :file:" "`pydoc` quickly becomes addictive; try it out!" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:608 +#: whatsnew/2.1.rst:608 msgid "" "Two different modules for unit testing were added to the standard library. " "The :mod:`doctest` module, contributed by Tim Peters, provides a testing " @@ -2289,7 +2276,7 @@ msgid "" "sourceforge.net/ for more information about PyUnit." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:616 +#: whatsnew/2.1.rst:616 msgid "" "The :mod:`difflib` module contains a class, :class:`SequenceMatcher`, which " "compares two sequences and computes the changes required to transform one " @@ -2299,7 +2286,7 @@ msgid "" "script." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:622 +#: whatsnew/2.1.rst:622 msgid "" ":mod:`curses.panel`, a wrapper for the panel library, part of ncurses and of " "SYSV curses, was contributed by Thomas Gellekum. The panel library provides " @@ -2308,7 +2295,7 @@ msgid "" "overlap and which sections are visible." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:628 +#: whatsnew/2.1.rst:628 msgid "" "The PyXML package has gone through a few releases since Python 2.0, and " "Python 2.1 includes an updated version of the :mod:`xml` package. Some of " @@ -2317,7 +2304,7 @@ msgid "" "Python, and various bugfixes for SAX, DOM, and the :mod:`minidom` module." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:634 +#: whatsnew/2.1.rst:634 msgid "" "Ping also contributed another hook for handling uncaught exceptions. :func:" "`sys.excepthook` can be set to a callable object. When an exception isn't " @@ -2329,7 +2316,7 @@ msgid "" "each frame." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:642 +#: whatsnew/2.1.rst:642 msgid "" "Various functions in the :mod:`time` module, such as :func:`asctime` and :" "func:`localtime`, require a floating point argument containing the time in " @@ -2341,11 +2328,11 @@ msgid "" "``time.asctime(time.localtime(time.time()))`` that was previously required." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:651 +#: whatsnew/2.1.rst:651 msgid "This change was proposed and implemented by Thomas Wouters." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:653 +#: whatsnew/2.1.rst:653 msgid "" "The :mod:`ftplib` module now defaults to retrieving files in passive mode, " "because passive mode is more likely to work from behind a firewall. This " @@ -2357,20 +2344,20 @@ msgid "" "`set_pasv(0)` on FTP objects to disable passive mode." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:662 +#: whatsnew/2.1.rst:662 msgid "" "Support for raw socket access has been added to the :mod:`socket` module, " "contributed by Grant Edwards." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:665 +#: whatsnew/2.1.rst:665 msgid "" "The :mod:`pstats` module now contains a simple interactive statistics " "browser for displaying timing profiles for Python programs, invoked when the " "module is run as a script. Contributed by Eric S. Raymond." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:669 +#: whatsnew/2.1.rst:669 msgid "" "A new implementation-dependent function, :func:`sys._getframe([depth])`, has " "been added to return a given frame object from the current call stack. :func:" @@ -2380,19 +2367,19 @@ msgid "" "_getframe(1)`` returns the caller's frame object." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:676 +#: whatsnew/2.1.rst:676 msgid "" "This function is only present in CPython, not in Jython or the .NET " "implementation. Use it for debugging, and resist the temptation to put it " "into production code." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:684 ../src/Doc/whatsnew/2.2.rst:1129 -#: ../src/Doc/whatsnew/2.3.rst:1960 ../src/Doc/whatsnew/2.7.rst:2353 +#: whatsnew/2.1.rst:684 whatsnew/2.2.rst:1129 whatsnew/2.3.rst:1960 +#: whatsnew/2.7.rst:2353 msgid "Other Changes and Fixes" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:686 +#: whatsnew/2.1.rst:686 msgid "" "There were relatively few smaller changes made in Python 2.1 due to the " "shorter release cycle. A search through the CVS change logs turns up 117 " @@ -2400,7 +2387,7 @@ msgid "" "underestimates. Some of the more notable changes are:" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:691 +#: whatsnew/2.1.rst:691 msgid "" "A specialized object allocator is now optionally available, that should be " "faster than the system :func:`malloc` and have less memory overhead. The " @@ -2411,7 +2398,7 @@ msgid "" "details." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:698 +#: whatsnew/2.1.rst:698 msgid "" "Authors of C extension modules should test their code with the object " "allocator enabled, because some incorrect code may break, causing core dumps " @@ -2427,11 +2414,11 @@ msgid "" "doubtless there are more third-party modules that will have the same problem." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:711 +#: whatsnew/2.1.rst:711 msgid "The object allocator was contributed by Vladimir Marangozov." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:713 +#: whatsnew/2.1.rst:713 msgid "" "The speed of line-oriented file I/O has been improved because people often " "complain about its lack of speed, and because it's often been used as a " @@ -2443,7 +2430,7 @@ msgid "" "this change, motivated by a discussion in comp.lang.python." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:722 +#: whatsnew/2.1.rst:722 msgid "" "A new module and method for file objects was also added, contributed by Jeff " "Epler. The new method, :meth:`xreadlines`, is similar to the existing :func:" @@ -2454,13 +2441,13 @@ msgid "" msgstr "" # 83d76a307b8b41fd8673f3d85dbce5ed -#: ../src/Doc/whatsnew/2.1.rst:733 +#: whatsnew/2.1.rst:733 msgid "" "For a fuller discussion of the line I/O changes, see the python-dev summary " "for January 1-15, 2001 at https://www.python.org/dev/summary/2001-01-1/." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:736 +#: whatsnew/2.1.rst:736 msgid "" "A new method, :meth:`popitem`, was added to dictionaries to enable " "destructively iterating through the contents of a dictionary; this can be " @@ -2471,7 +2458,7 @@ msgid "" "suggestion and preliminary patch by Moshe Zadka." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:744 +#: whatsnew/2.1.rst:744 msgid "" "Modules can now control which names are imported when ``from module import " "*`` is used, by defining an ``__all__`` attribute containing a list of names " @@ -2481,14 +2468,14 @@ msgid "" "the public names in ``__all__``::" msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:754 +#: whatsnew/2.1.rst:754 msgid "" "A stricter version of this patch was first suggested and implemented by Ben " "Wolfson, but after some python-dev discussion, a weaker final version was " "checked in." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:758 +#: whatsnew/2.1.rst:758 msgid "" "Applying :func:`repr` to strings previously used octal escapes for non-" "printable characters; for example, a newline was ``'\\012'``. This was a " @@ -2498,14 +2485,14 @@ msgid "" "characters, and implemented this new formatting." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:765 +#: whatsnew/2.1.rst:765 msgid "" "Syntax errors detected at compile-time can now raise exceptions containing " "the filename and line number of the error, a pleasant side effect of the " "compiler reorganization done by Jeremy Hylton." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:769 +#: whatsnew/2.1.rst:769 msgid "" "C extensions which import other modules have been changed to use :func:" "`PyImport_ImportModule`, which means that they will use any import hooks " @@ -2513,27 +2500,27 @@ msgid "" "extensions that need to import some other module from C code." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:774 +#: whatsnew/2.1.rst:774 msgid "" "The size of the Unicode character database was shrunk by another 340K thanks " "to Fredrik Lundh." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:777 +#: whatsnew/2.1.rst:777 msgid "" "Some new ports were contributed: MacOS X (by Steven Majewski), Cygwin (by " "Jason Tishler); RISCOS (by Dietmar Schwertberger); Unixware 7 (by Billy G. " "Allie)." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:781 +#: whatsnew/2.1.rst:781 msgid "" "And there's the usual list of minor bugfixes, minor memory leaks, docstring " "edits, and other tweaks, too lengthy to be worth itemizing; see the CVS logs " "for the full details if you want them." msgstr "" -#: ../src/Doc/whatsnew/2.1.rst:791 +#: whatsnew/2.1.rst:791 msgid "" "The author would like to thank the following people for offering suggestions " "on various drafts of this article: Graeme Cross, David Goodger, Jay Graves, " @@ -2541,19 +2528,19 @@ msgid "" "Wouters." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:3 +#: whatsnew/2.2.rst:3 #, fuzzy msgid "What's New in Python 2.2" msgstr "Nouveautés de Python 2.0" -#: ../src/Doc/whatsnew/2.2.rst:15 +#: whatsnew/2.2.rst:15 msgid "" "This article explains the new features in Python 2.2.2, released on October " "14, 2002. Python 2.2.2 is a bugfix release of Python 2.2, originally " "released on December 21, 2001." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:19 +#: whatsnew/2.2.rst:19 msgid "" "Python 2.2 can be thought of as the \"cleanup release\". There are some " "features such as generators and iterators that are completely new, but most " @@ -2562,7 +2549,7 @@ msgid "" msgstr "" # 1b3eb52a0f6e47c792cc53894116a12e -#: ../src/Doc/whatsnew/2.2.rst:24 +#: whatsnew/2.2.rst:24 msgid "" "This article doesn't attempt to provide a complete specification of the new " "features, but instead provides a convenient overview. For full details, you " @@ -2573,11 +2560,11 @@ msgid "" "for a change, refer to the PEP for a particular new feature." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:43 +#: whatsnew/2.2.rst:43 msgid "PEPs 252 and 253: Type and Class Changes" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:45 +#: whatsnew/2.2.rst:45 msgid "" "The largest and most far-reaching changes in Python 2.2 are to Python's " "model of objects and classes. The changes should be backward compatible, so " @@ -2587,7 +2574,7 @@ msgid "" "the changes and offer some comments." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:52 +#: whatsnew/2.2.rst:52 msgid "" "A long time ago I wrote a Web page listing flaws in Python's design. One of " "the most significant flaws was that it's impossible to subclass Python types " @@ -2599,25 +2586,25 @@ msgid "" "a :class:`UserList` instance." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:61 +#: whatsnew/2.2.rst:61 msgid "" "Python 2.2 fixes this, and in the process adds some exciting new " "capabilities. A brief summary:" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:64 +#: whatsnew/2.2.rst:64 msgid "" "You can subclass built-in types such as lists and even integers, and your " "subclasses should work in every place that requires the original type." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:67 +#: whatsnew/2.2.rst:67 msgid "" "It's now possible to define static and class methods, in addition to the " "instance methods available in previous versions of Python." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:70 +#: whatsnew/2.2.rst:70 msgid "" "It's also possible to automatically call methods on accessing or setting an " "instance attribute by using a new mechanism called :dfn:`properties`. Many " @@ -2626,14 +2613,14 @@ msgid "" "attributes can now have docstrings, too." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:76 +#: whatsnew/2.2.rst:76 msgid "" "The list of legal attributes for an instance can be limited to a particular " "set using :dfn:`slots`, making it possible to safeguard against typos and " "perhaps make more optimizations possible in future versions of Python." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:80 +#: whatsnew/2.2.rst:80 msgid "" "Some users have voiced concern about all these changes. Sure, they say, the " "new features are neat and lend themselves to all sorts of tricks that " @@ -2643,7 +2630,7 @@ msgid "" "lost." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:86 +#: whatsnew/2.2.rst:86 msgid "" "Personally, I think there's no need to worry. Many of the new features are " "quite esoteric, and you can write a lot of Python code without ever needed " @@ -2654,7 +2641,7 @@ msgid "" "that's all for the better." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:93 +#: whatsnew/2.2.rst:93 msgid "" "I'm not going to attempt to cover every single corner case and small change " "that were required to make the new features work. Instead this section will " @@ -2663,11 +2650,11 @@ msgid "" "model." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:100 +#: whatsnew/2.2.rst:100 msgid "Old and New Classes" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:102 +#: whatsnew/2.2.rst:102 msgid "" "First, you should know that Python 2.2 really has two kinds of classes: " "classic or old-style classes, and new-style classes. The old-style class " @@ -2677,7 +2664,7 @@ msgid "" "style classes will be dropped, possibly in Python 3.0." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:109 +#: whatsnew/2.2.rst:109 msgid "" "So how do you define a new-style class? You do it by subclassing an " "existing new-style class. Most of Python's built-in types, such as " @@ -2687,7 +2674,7 @@ msgid "" "subclass :class:`object`::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:121 +#: whatsnew/2.2.rst:121 msgid "" "This means that :keyword:`class` statements that don't have any base classes " "are always classic classes in Python 2.2. (Actually you can also change " @@ -2696,7 +2683,7 @@ msgid "" "`object`.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:126 +#: whatsnew/2.2.rst:126 msgid "" "The type objects for the built-in types are available as built-ins, named " "using a clever trick. Python has always had built-in functions named :func:" @@ -2704,14 +2691,14 @@ msgid "" "more, but type objects that behave as factories when called. ::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:136 +#: whatsnew/2.2.rst:136 msgid "" "To make the set of types complete, new type objects such as :func:`dict` " "and :func:`file` have been added. Here's a more interesting example, adding " "a :meth:`lock` method to file objects::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:146 +#: whatsnew/2.2.rst:146 msgid "" "The now-obsolete :mod:`posixfile` module contained a class that emulated all " "of a file object's methods and also added a :meth:`lock` method, but this " @@ -2719,11 +2706,11 @@ msgid "" "file, something which is possible with our new :class:`LockableFile`." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:153 +#: whatsnew/2.2.rst:153 msgid "Descriptors" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:155 +#: whatsnew/2.2.rst:155 msgid "" "In previous versions of Python, there was no consistent way to discover what " "attributes and methods were supported by an object. There were some informal " @@ -2735,7 +2722,7 @@ msgid "" "inaccurate." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:163 +#: whatsnew/2.2.rst:163 msgid "" "The one big idea underlying the new class model is that an API for " "describing the attributes of an object using :dfn:`descriptors` has been " @@ -2744,43 +2731,43 @@ msgid "" "methods become possible, as well as more exotic constructs." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:169 +#: whatsnew/2.2.rst:169 msgid "" "Attribute descriptors are objects that live inside class objects, and have a " "few attributes of their own:" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:172 +#: whatsnew/2.2.rst:172 msgid ":attr:`__name__` is the attribute's name." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:174 +#: whatsnew/2.2.rst:174 msgid ":attr:`__doc__` is the attribute's docstring." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:176 +#: whatsnew/2.2.rst:176 msgid "" ":meth:`__get__(object)` is a method that retrieves the attribute value from " "*object*." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:179 +#: whatsnew/2.2.rst:179 msgid "" ":meth:`__set__(object, value)` sets the attribute on *object* to *value*." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:181 +#: whatsnew/2.2.rst:181 msgid "" ":meth:`__delete__(object, value)` deletes the *value* attribute of *object*." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:183 +#: whatsnew/2.2.rst:183 msgid "" "For example, when you write ``obj.x``, the steps that Python actually " "performs are::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:189 +#: whatsnew/2.2.rst:189 msgid "" "For methods, :meth:`descriptor.__get__` returns a temporary object that's " "callable, and wraps up the instance and the method to be called on it. This " @@ -2792,7 +2779,7 @@ msgid "" "Static and class methods are defined like this::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:207 +#: whatsnew/2.2.rst:207 msgid "" "The :func:`staticmethod` function takes the function :func:`f`, and returns " "it wrapped up in a descriptor so it can be stored in the class object. You " @@ -2801,7 +2788,7 @@ msgid "" "has been defined yet; that's been left for future versions of Python." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:213 +#: whatsnew/2.2.rst:213 msgid "" "More new features, such as slots and properties, are also implemented as new " "kinds of descriptors, and it's not difficult to write a descriptor class " @@ -2811,7 +2798,7 @@ msgid "" "defined like this::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:235 +#: whatsnew/2.2.rst:235 msgid "" "Note that a person using the new :func:`eiffelmethod` doesn't have to " "understand anything about descriptors. This is why I think the new features " @@ -2821,18 +2808,18 @@ msgid "" "resulting libraries and ignore the implementation details." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:244 +#: whatsnew/2.2.rst:244 msgid "Multiple Inheritance: The Diamond Rule" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:246 +#: whatsnew/2.2.rst:246 msgid "" "Multiple inheritance has also been made more useful through changing the " "rules under which names are resolved. Consider this set of classes (diagram " "taken from :pep:`253` by Guido van Rossum)::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:264 +#: whatsnew/2.2.rst:264 msgid "" "The lookup rule for classic classes is simple but not very smart; the base " "classes are searched depth-first, going from left to right. A reference to :" @@ -2843,7 +2830,7 @@ msgid "" "calling it will result in that state never getting saved." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:272 +#: whatsnew/2.2.rst:272 msgid "" "New-style classes follow a different algorithm that's a bit more complicated " "to explain, but does the right thing in this situation. (Note that Python " @@ -2852,7 +2839,7 @@ msgid "" "graphs.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:277 +#: whatsnew/2.2.rst:277 msgid "" "List all the base classes, following the classic lookup rule and include a " "class multiple times if it's visited repeatedly. In the above example, the " @@ -2860,7 +2847,7 @@ msgid "" "class:`A`]." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:282 +#: whatsnew/2.2.rst:282 msgid "" "Scan the list for duplicated classes. If any are found, remove all but one " "occurrence, leaving the *last* one in the list. In the above example, the " @@ -2868,7 +2855,7 @@ msgid "" "duplicates." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:287 +#: whatsnew/2.2.rst:287 msgid "" "Following this rule, referring to :meth:`D.save` will return :meth:`C.save`, " "which is the behaviour we're after. This lookup rule is the same as the one " @@ -2880,18 +2867,18 @@ msgid "" "example, :class:`D`'s :meth:`save` method would look like this::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:303 +#: whatsnew/2.2.rst:303 msgid "" ":func:`super` can also return unbound superclass objects when called as :" "func:`super(class)` or :func:`super(class1, class2)`, but this probably " "won't often be useful." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:309 +#: whatsnew/2.2.rst:309 msgid "Attribute Access" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:311 +#: whatsnew/2.2.rst:311 msgid "" "A fair number of sophisticated Python classes define hooks for attribute " "access using :meth:`__getattr__`; most commonly this is done for " @@ -2900,7 +2887,7 @@ msgid "" "get_parent``. Python 2.2 adds some new ways of controlling attribute access." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:317 +#: whatsnew/2.2.rst:317 msgid "" "First, :meth:`__getattr__(attr_name)` is still supported by new-style " "classes, and nothing about it has changed. As before, it will be called " @@ -2908,7 +2895,7 @@ msgid "" "is found in the instance's dictionary." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:322 +#: whatsnew/2.2.rst:322 msgid "" "New-style classes also support a new method, :meth:" "`__getattribute__(attr_name)`. The difference between the two methods is " @@ -2917,7 +2904,7 @@ msgid "" "found in the instance's dictionary." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:328 +#: whatsnew/2.2.rst:328 msgid "" "However, Python 2.2's support for :dfn:`properties` will often be a simpler " "way to trap attribute references. Writing a :meth:`__getattr__` method is " @@ -2929,7 +2916,7 @@ msgid "" "a function on every attribute access results in a sizable performance loss." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:337 +#: whatsnew/2.2.rst:337 msgid "" ":class:`property` is a new built-in type that packages up three functions " "that get, set, or delete an attribute, and a docstring. For example, if you " @@ -2937,7 +2924,7 @@ msgid "" "you could write::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:357 +#: whatsnew/2.2.rst:357 msgid "" "That is certainly clearer and easier to write than a pair of :meth:" "`__getattr__`/:meth:`__setattr__` methods that check for the :attr:`size` " @@ -2947,7 +2934,7 @@ msgid "" "other attributes run at their usual speed." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:364 +#: whatsnew/2.2.rst:364 msgid "" "Finally, it's possible to constrain the list of attributes that can be " "referenced on an object using the new :attr:`__slots__` class attribute. " @@ -2958,17 +2945,17 @@ msgid "" "this clear::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:385 +#: whatsnew/2.2.rst:385 msgid "" "Note how you get an :exc:`AttributeError` on the attempt to assign to an " "attribute not listed in :attr:`__slots__`." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:392 +#: whatsnew/2.2.rst:392 msgid "Related Links" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:394 +#: whatsnew/2.2.rst:394 msgid "" "This section has just been a quick overview of the new features, giving " "enough of an explanation to start you programming, but many details have " @@ -2977,7 +2964,7 @@ msgid "" msgstr "" # a6511ea8abed4ddbbda273708c468661 -#: ../src/Doc/whatsnew/2.2.rst:398 +#: whatsnew/2.2.rst:398 msgid "" "https://www.python.org/2.2/descrintro.html is a lengthy tutorial " "introduction to the descriptor features, written by Guido van Rossum. If my " @@ -2986,7 +2973,7 @@ msgid "" "quite easy to read." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:403 +#: whatsnew/2.2.rst:403 msgid "" "Next, there are two relevant PEPs, :pep:`252` and :pep:`253`. :pep:`252` is " "titled \"Making Types Look More Like Classes\", and covers the descriptor " @@ -2998,7 +2985,7 @@ msgid "" "substantial assistance from the rest of the Zope Corp. team." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:412 +#: whatsnew/2.2.rst:412 msgid "" "Finally, there's the ultimate authority: the source code. Most of the " "machinery for the type handling is in :file:`Objects/typeobject.c`, but you " @@ -3006,24 +2993,24 @@ msgid "" "including posting a question to python-list or python-dev." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:421 +#: whatsnew/2.2.rst:421 msgid "PEP 234: Iterators" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:423 +#: whatsnew/2.2.rst:423 msgid "" "Another significant addition to 2.2 is an iteration interface at both the C " "and Python levels. Objects can define how they can be looped over by " "callers." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:426 +#: whatsnew/2.2.rst:426 msgid "" "In Python versions up to 2.1, the usual way to make ``for item in obj`` work " "is to define a :meth:`__getitem__` method that looks something like this::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:432 +#: whatsnew/2.2.rst:432 msgid "" ":meth:`__getitem__` is more properly used to define an indexing operation on " "an object so that you can write ``obj[5]`` to retrieve the sixth element. " @@ -3036,7 +3023,7 @@ msgid "" "the sixth element will work, though it really should." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:442 +#: whatsnew/2.2.rst:442 msgid "" "In Python 2.2, iteration can be implemented separately, and :meth:" "`__getitem__` methods can be limited to classes that really do support " @@ -3048,7 +3035,7 @@ msgid "" msgstr "" # 7b7989094d354beeab0ba4a3515646f3 -#: ../src/Doc/whatsnew/2.2.rst:450 +#: whatsnew/2.2.rst:450 msgid "" "Python classes can define an :meth:`__iter__` method, which should create " "and return a new iterator for the object; if the object is its own iterator, " @@ -3059,7 +3046,7 @@ msgid "" "`~PyTypeObject.tp_iternext` function." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:457 +#: whatsnew/2.2.rst:457 msgid "" "So, after all this, what do iterators actually do? They have one required " "method, :meth:`next`, which takes no arguments and returns the next value. " @@ -3068,7 +3055,7 @@ msgid "" msgstr "" # 04854cb943c9489e981393c6c0503d83 -#: ../src/Doc/whatsnew/2.2.rst:478 +#: whatsnew/2.2.rst:478 msgid "" "In 2.2, Python's :keyword:`for` statement no longer expects a sequence; it " "expects something for which :func:`iter` will return an iterator. For " @@ -3080,14 +3067,14 @@ msgid "" "this::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:492 +#: whatsnew/2.2.rst:492 msgid "" "Iterator support has been added to some of Python's basic types. Calling :" "func:`iter` on a dictionary will return an iterator which loops over its " "keys::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:512 +#: whatsnew/2.2.rst:512 msgid "" "That's just the default behaviour. If you want to iterate over keys, " "values, or key/value pairs, you can explicitly call the :meth:`iterkeys`, :" @@ -3096,14 +3083,14 @@ msgid "" "dictionaries, so ``key in dict`` is now equivalent to ``dict.has_key(key)``." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:518 +#: whatsnew/2.2.rst:518 msgid "" "Files also provide an iterator, which calls the :meth:`readline` method " "until there are no more lines in the file. This means you can now read each " "line of a file using code like this::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:526 +#: whatsnew/2.2.rst:526 msgid "" "Note that you can only go forward in an iterator; there's no way to get the " "previous element, reset the iterator, or make a copy of it. An iterator " @@ -3111,28 +3098,27 @@ msgid "" "only requires a :meth:`next` method." msgstr "" -# da4826c3821d4840b3e7f12907ef3f2f -#: ../src/Doc/whatsnew/2.2.rst:534 -msgid ":pep:`234` - Iterators" +#: whatsnew/2.2.rst:535 +msgid "PEP 234 - Iterators" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:535 +#: whatsnew/2.2.rst:535 msgid "" "Written by Ka-Ping Yee and GvR; implemented by the Python Labs crew, mostly " "by GvR and Tim Peters." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:542 ../src/Doc/whatsnew/2.3.rst:126 +#: whatsnew/2.2.rst:542 whatsnew/2.3.rst:126 msgid "PEP 255: Simple Generators" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:544 +#: whatsnew/2.2.rst:544 msgid "" "Generators are another new feature, one that interacts with the introduction " "of iterators." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:547 +#: whatsnew/2.2.rst:547 msgid "" "You're doubtless familiar with how function calls work in Python or C. When " "you call a function, it gets a private namespace where its local variables " @@ -3145,11 +3131,11 @@ msgid "" "functions." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:556 ../src/Doc/whatsnew/2.3.rst:145 +#: whatsnew/2.2.rst:556 whatsnew/2.3.rst:145 msgid "Here's the simplest example of a generator function::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:562 +#: whatsnew/2.2.rst:562 msgid "" "A new keyword, :keyword:`yield`, was introduced for generators. Any " "function containing a :keyword:`yield` statement is a generator function; " @@ -3160,7 +3146,7 @@ msgid "" "Python 2.3 this statement will become unnecessary." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:570 +#: whatsnew/2.2.rst:570 msgid "" "When you call a generator function, it doesn't return a single value; " "instead it returns a generator object that supports the iterator protocol. " @@ -3176,17 +3162,17 @@ msgid "" "explanation of the interaction between :keyword:`yield` and exceptions.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:583 ../src/Doc/whatsnew/2.3.rst:169 +#: whatsnew/2.2.rst:583 whatsnew/2.3.rst:169 msgid "Here's a sample usage of the :func:`generate_ints` generator::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:600 ../src/Doc/whatsnew/2.3.rst:186 +#: whatsnew/2.2.rst:600 whatsnew/2.3.rst:186 msgid "" "You could equally write ``for i in generate_ints(5)``, or ``a,b,c = " "generate_ints(3)``." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:603 ../src/Doc/whatsnew/2.3.rst:189 +#: whatsnew/2.2.rst:603 whatsnew/2.3.rst:189 msgid "" "Inside a generator function, the :keyword:`return` statement can only be " "used without a value, and signals the end of the procession of values; " @@ -3197,7 +3183,7 @@ msgid "" "execution fall off the bottom of the function." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:611 ../src/Doc/whatsnew/2.3.rst:197 +#: whatsnew/2.2.rst:611 whatsnew/2.3.rst:197 msgid "" "You could achieve the effect of generators manually by writing your own " "class and storing all the local variables of the generator as instance " @@ -3210,7 +3196,7 @@ msgid "" "recursively. ::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:629 ../src/Doc/whatsnew/2.3.rst:215 +#: whatsnew/2.2.rst:629 whatsnew/2.3.rst:215 msgid "" "Two other examples in :file:`Lib/test/test_generators.py` produce solutions " "for the N-Queens problem (placing $N$ queens on an $NxN$ chess board so that " @@ -3219,7 +3205,7 @@ msgid "" "twice)." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:634 ../src/Doc/whatsnew/2.3.rst:220 +#: whatsnew/2.2.rst:634 whatsnew/2.3.rst:220 msgid "" "The idea of generators comes from other programming languages, especially " "Icon (http://www.cs.arizona.edu/icon/), where the idea of generators is " @@ -3229,7 +3215,7 @@ msgid "" "this looks like::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:644 ../src/Doc/whatsnew/2.3.rst:230 +#: whatsnew/2.2.rst:644 whatsnew/2.3.rst:230 msgid "" "In Icon the :func:`find` function returns the indexes at which the substring " "\"or\" is found: 3, 23, 33. In the :keyword:`if` statement, ``i`` is first " @@ -3238,7 +3224,7 @@ msgid "" "comparison now succeeds, and the code prints the value 23 to the screen." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:650 +#: whatsnew/2.2.rst:650 msgid "" "Python doesn't go nearly as far as Icon in adopting generators as a central " "concept. Generators are considered a new part of the core Python language, " @@ -3249,24 +3235,22 @@ msgid "" "other functions or stored in a data structure." msgstr "" -# e9b970fdade04e638b157566891868b0 -# 23a1158da5ab4a319487ff725279a8b0 -#: ../src/Doc/whatsnew/2.2.rst:661 ../src/Doc/whatsnew/2.3.rst:247 -msgid ":pep:`255` - Simple Generators" +#: whatsnew/2.2.rst:662 whatsnew/2.3.rst:248 +msgid "PEP 255 - Simple Generators" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:662 ../src/Doc/whatsnew/2.3.rst:248 +#: whatsnew/2.2.rst:662 whatsnew/2.3.rst:248 msgid "" "Written by Neil Schemenauer, Tim Peters, Magnus Lie Hetland. Implemented " "mostly by Neil Schemenauer and Tim Peters, with other fixes from the Python " "Labs crew." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:669 ../src/Doc/whatsnew/2.4.rst:90 +#: whatsnew/2.2.rst:669 whatsnew/2.4.rst:90 msgid "PEP 237: Unifying Long Integers and Integers" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:671 +#: whatsnew/2.2.rst:671 msgid "" "In recent versions, the distinction between regular integers, which are 32-" "bit values on most machines, and long integers, which can be of arbitrary " @@ -3279,7 +3263,7 @@ msgid "" "exception with the message 'slice index must be int'." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:681 +#: whatsnew/2.2.rst:681 msgid "" "Python 2.2 will shift values from short to long integers as required. The " "'L' suffix is no longer needed to indicate a long integer literal, as now " @@ -3290,30 +3274,28 @@ msgid "" "result. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:694 +#: whatsnew/2.2.rst:694 msgid "" "In most cases, integers and long integers will now be treated identically. " "You can still distinguish them with the :func:`type` built-in function, but " "that's rarely needed." msgstr "" -# 50e4d1629ec14573b38c7c856e43b67e -# 3f5bf40c9f7346cdb97ff85a78f1fc99 -#: ../src/Doc/whatsnew/2.2.rst:701 ../src/Doc/whatsnew/2.4.rst:107 -msgid ":pep:`237` - Unifying Long Integers and Integers" +#: whatsnew/2.2.rst:702 whatsnew/2.4.rst:108 +msgid "PEP 237 - Unifying Long Integers and Integers" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:702 +#: whatsnew/2.2.rst:702 msgid "" "Written by Moshe Zadka and Guido van Rossum. Implemented mostly by Guido " "van Rossum." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:709 +#: whatsnew/2.2.rst:709 msgid "PEP 238: Changing the Division Operator" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:711 +#: whatsnew/2.2.rst:711 msgid "" "The most controversial change in Python 2.2 heralds the start of an effort " "to fix an old design flaw that's been in Python from the beginning. " @@ -3326,7 +3308,7 @@ msgid "" "difficult to determine the possible types of the operands." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:721 +#: whatsnew/2.2.rst:721 msgid "" "(The controversy is over whether this is *really* a design flaw, and whether " "it's worth breaking existing code to fix this. It's caused endless " @@ -3336,14 +3318,14 @@ msgid "" "Read :pep:`238` for a summary of arguments and counter-arguments.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:728 +#: whatsnew/2.2.rst:728 msgid "" "Because this change might break code, it's being introduced very gradually. " "Python 2.2 begins the transition, but the switch won't be complete until " "Python 3.0." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:732 +#: whatsnew/2.2.rst:732 msgid "" "First, I'll borrow some terminology from :pep:`238`. \"True division\" is " "the division that most non-programmers are familiar with: 3/2 is 1.5, 1/4 is " @@ -3355,11 +3337,11 @@ msgid "" "the operands is a floating-point number." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:740 +#: whatsnew/2.2.rst:740 msgid "Here are the changes 2.2 introduces:" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:742 +#: whatsnew/2.2.rst:742 msgid "" "A new operator, ``//``, is the floor division operator. (Yes, we know it " "looks like C++'s comment symbol.) ``//`` *always* performs floor division " @@ -3367,13 +3349,13 @@ msgid "" "``1.0 // 2.0`` is also 0.0." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:747 +#: whatsnew/2.2.rst:747 msgid "" "``//`` is always available in Python 2.2; you don't need to enable it using " "a ``__future__`` statement." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:750 +#: whatsnew/2.2.rst:750 msgid "" "By including a ``from __future__ import division`` in a module, the ``/`` " "operator will be changed to return the result of true division, so ``1/2`` " @@ -3382,7 +3364,7 @@ msgid "" msgstr "" # 542987ce4aec475ca712794d1bb781a1 -#: ../src/Doc/whatsnew/2.2.rst:755 +#: whatsnew/2.2.rst:755 msgid "" "Classes can define methods called :meth:`__truediv__` and :meth:" "`__floordiv__` to overload the two division operators. At the C level, " @@ -3390,7 +3372,7 @@ msgid "" "types can define the two operators." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:760 +#: whatsnew/2.2.rst:760 msgid "" "Python 2.2 supports some command-line arguments for testing whether code " "will works with the changed division semantics. Running python with :option:" @@ -3400,22 +3382,21 @@ msgid "" "without a warning; the warning will be turned on by default in Python 2.3." msgstr "" -# f396a8db59c04d5f800eb7f053ca198d -#: ../src/Doc/whatsnew/2.2.rst:769 -msgid ":pep:`238` - Changing the Division Operator" +#: whatsnew/2.2.rst:770 +msgid "PEP 238 - Changing the Division Operator" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:771 +#: whatsnew/2.2.rst:771 msgid "" "Written by Moshe Zadka and Guido van Rossum. Implemented by Guido van " "Rossum.." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:777 +#: whatsnew/2.2.rst:777 msgid "Unicode Changes" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:779 +#: whatsnew/2.2.rst:779 msgid "" "Python's Unicode support has been enhanced a bit in 2.2. Unicode strings " "are usually stored as UCS-2, as 16-bit unsigned integers. Python 2.2 can " @@ -3425,7 +3406,7 @@ msgid "" "completely disable Unicode support.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:786 +#: whatsnew/2.2.rst:786 msgid "" "When built to use UCS-4 (a \"wide Python\"), the interpreter can natively " "handle Unicode characters from U+000000 to U+110000, so the range of legal " @@ -3436,7 +3417,7 @@ msgid "" "characters\"; consult it for further details." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:794 +#: whatsnew/2.2.rst:794 msgid "" "Another change is simpler to explain. Since their introduction, Unicode " "strings have supported an :meth:`encode` method to convert the string to a " @@ -3447,36 +3428,35 @@ msgid "" "codec." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:801 +#: whatsnew/2.2.rst:801 msgid "" "Using this new feature, codecs have been added for tasks not directly " "related to Unicode. For example, codecs have been added for uu-encoding, " "MIME's base64 encoding, and compression with the :mod:`zlib` module::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:822 +#: whatsnew/2.2.rst:822 msgid "" "To convert a class instance to Unicode, a :meth:`__unicode__` method can be " "defined by a class, analogous to :meth:`__str__`." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:825 +#: whatsnew/2.2.rst:825 msgid "" ":meth:`encode`, :meth:`decode`, and :meth:`__unicode__` were implemented by " "Marc-André Lemburg. The changes to support using UCS-4 internally were " "implemented by Fredrik Lundh and Martin von Löwis." msgstr "" -# 2e0d71902bc7484a949a945a54fa541e -#: ../src/Doc/whatsnew/2.2.rst:831 -msgid ":pep:`261` - Support for 'wide' Unicode characters" +#: whatsnew/2.2.rst:832 +msgid "PEP 261 - Support for 'wide' Unicode characters" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:833 +#: whatsnew/2.2.rst:833 msgid "Written by Paul Prescod." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:841 +#: whatsnew/2.2.rst:841 msgid "" "In Python 2.1, statically nested scopes were added as an optional feature, " "to be enabled by a ``from __future__ import nested_scopes`` directive. In " @@ -3486,7 +3466,7 @@ msgid "" "2.1 came out, you can skip the rest of this section." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:848 +#: whatsnew/2.2.rst:848 msgid "" "The largest change introduced in Python 2.1, and made complete in 2.2, is to " "Python's scoping rules. In Python 2.0, at any given time there are at most " @@ -3496,7 +3476,7 @@ msgid "" "definition doesn't work::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:879 +#: whatsnew/2.2.rst:879 msgid "" "The most significant change to Python 2.2 is that static scoping has been " "added to the language to fix this problem. As a first effect, the " @@ -3508,7 +3488,7 @@ msgid "" "rules, and a dissection of the implementation, can be found in the PEP." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:936 +#: whatsnew/2.2.rst:936 msgid "" "The :mod:`xmlrpclib` module was contributed to the standard library by " "Fredrik Lundh, providing support for writing XML-RPC clients. XML-RPC is a " @@ -3517,20 +3497,20 @@ msgid "" "O'Reilly Network, and then lists the recent headlines for one channel::" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:959 +#: whatsnew/2.2.rst:959 msgid "" "The :mod:`SimpleXMLRPCServer` module makes it easy to create straightforward " "XML-RPC servers. See http://www.xmlrpc.com/ for more information about XML-" "RPC." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:962 +#: whatsnew/2.2.rst:962 msgid "" "The new :mod:`hmac` module implements the HMAC algorithm described by :rfc:" "`2104`. (Contributed by Gerhard Häring.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:965 +#: whatsnew/2.2.rst:965 msgid "" "Several functions that originally returned lengthy tuples now return pseudo- " "sequences that still behave like tuples but also have mnemonic attributes " @@ -3540,7 +3520,7 @@ msgid "" "in the :mod:`time` module." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:972 +#: whatsnew/2.2.rst:972 msgid "" "For example, to obtain a file's size using the old tuples, you'd end up " "writing something like ``file_size = os.stat(filename)[stat.ST_SIZE]``, but " @@ -3548,18 +3528,18 @@ msgid "" "st_size``." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:976 +#: whatsnew/2.2.rst:976 msgid "The original patch for this feature was contributed by Nick Mathewson." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:978 +#: whatsnew/2.2.rst:978 msgid "" "The Python profiler has been extensively reworked and various errors in its " "output have been corrected. (Contributed by Fred L. Drake, Jr. and Tim " "Peters.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:981 +#: whatsnew/2.2.rst:981 msgid "" "The :mod:`socket` module can be compiled to support IPv6; specify the :" "option:`--enable-ipv6` option to Python's configure script. (Contributed by " @@ -3567,7 +3547,7 @@ msgid "" msgstr "" # ca2b8899363b4c50ad112c550014c025 -#: ../src/Doc/whatsnew/2.2.rst:985 +#: whatsnew/2.2.rst:985 msgid "" "Two new format characters were added to the :mod:`struct` module for 64-bit " "integers on platforms that support the C :c:type:`long long` type. ``q`` is " @@ -3575,7 +3555,7 @@ msgid "" "returned in Python's long integer type. (Contributed by Tim Peters.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:990 +#: whatsnew/2.2.rst:990 msgid "" "In the interpreter's interactive mode, there's a new built-in function :func:" "`help` that uses the :mod:`pydoc` module introduced in Python 2.1 to provide " @@ -3586,7 +3566,7 @@ msgid "" "`pydoc` module.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:998 +#: whatsnew/2.2.rst:998 msgid "" "Various bugfixes and performance improvements have been made to the SRE " "engine underlying the :mod:`re` module. For example, the :func:`re.sub` " @@ -3597,7 +3577,7 @@ msgid "" "Fredrik Lundh. The BIGCHARSET patch was contributed by Martin von Löwis.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1006 +#: whatsnew/2.2.rst:1006 msgid "" "The :mod:`smtplib` module now supports :rfc:`2487`, \"Secure SMTP over TLS" "\", so it's now possible to encrypt the SMTP traffic between a Python " @@ -3605,7 +3585,7 @@ msgid "" "also supports SMTP authentication. (Contributed by Gerhard Häring.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1011 +#: whatsnew/2.2.rst:1011 msgid "" "The :mod:`imaplib` module, maintained by Piers Lauder, has support for " "several new extensions: the NAMESPACE extension defined in :rfc:`2342`, " @@ -3613,7 +3593,7 @@ msgid "" "Pelletier.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1015 +#: whatsnew/2.2.rst:1015 msgid "" "The :mod:`rfc822` module's parsing of email addresses is now compliant with :" "rfc:`2822`, an update to :rfc:`822`. (The module's name is *not* going to " @@ -3622,7 +3602,7 @@ msgid "" "Warsaw, and arising out of his work on Mailman.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1021 +#: whatsnew/2.2.rst:1021 msgid "" "The :mod:`difflib` module now contains a new :class:`Differ` class for " "producing human-readable lists of changes (a \"delta\") between two " @@ -3633,7 +3613,7 @@ msgid "" "the generatorization.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1028 +#: whatsnew/2.2.rst:1028 msgid "" "New constants :const:`ascii_letters`, :const:`ascii_lowercase`, and :const:" "`ascii_uppercase` were added to the :mod:`string` module. There were " @@ -3645,25 +3625,25 @@ msgid "" "fixed by Fred L. Drake, Jr.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1037 +#: whatsnew/2.2.rst:1037 msgid "" "The :mod:`mimetypes` module now makes it easier to use alternative MIME-type " "databases by the addition of a :class:`MimeTypes` class, which takes a list " "of filenames to be parsed. (Contributed by Fred L. Drake, Jr.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1041 +#: whatsnew/2.2.rst:1041 msgid "" "A :class:`Timer` class was added to the :mod:`threading` module that allows " "scheduling an activity to happen at some future time. (Contributed by " "Itamar Shtull-Trauring.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1049 +#: whatsnew/2.2.rst:1049 msgid "Interpreter Changes and Fixes" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1051 +#: whatsnew/2.2.rst:1051 msgid "" "Some of the changes only affect people who deal with the Python interpreter " "at the C level because they're writing Python extension modules, embedding " @@ -3673,7 +3653,7 @@ msgid "" msgstr "" # 662ef75078da45af982a76152dd878bd -#: ../src/Doc/whatsnew/2.2.rst:1056 +#: whatsnew/2.2.rst:1056 msgid "" "Profiling and tracing functions can now be implemented in C, which can " "operate at much higher speeds than Python-based functions and should reduce " @@ -3686,7 +3666,7 @@ msgid "" msgstr "" # 610d706f74894d73ab10cd5f280695b1 -#: ../src/Doc/whatsnew/2.2.rst:1065 +#: whatsnew/2.2.rst:1065 msgid "" "Another low-level API, primarily of interest to implementors of Python " "debuggers and development tools, was added. :c:func:" @@ -3697,7 +3677,7 @@ msgid "" "David Beazley.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1072 +#: whatsnew/2.2.rst:1072 msgid "" "The C-level interface to the garbage collector has been changed to make it " "easier to write extension types that support garbage collection and to debug " @@ -3708,50 +3688,47 @@ msgid "" "priority." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1079 +#: whatsnew/2.2.rst:1079 msgid "" "To upgrade an extension module to the new API, perform the following steps:" msgstr "" # 76d2e3f9fef44a27815199143ed81800 -#: ../src/Doc/whatsnew/2.2.rst:1081 +#: whatsnew/2.2.rst:1081 msgid "Rename :c:func:`Py_TPFLAGS_GC` to :c:func:`PyTPFLAGS_HAVE_GC`." msgstr "" -# e37a0b9fd11f4544853a1d1e1e6ed199 -#: ../src/Doc/whatsnew/2.2.rst:1083 -msgid "" -"Use :c:func:`PyObject_GC_New` or :c:func:`PyObject_GC_NewVar` to allocate" +#: whatsnew/2.2.rst:1084 +msgid "Use PyObject_GC_New() or PyObject_GC_NewVar() to allocate" msgstr "" # 47a7e05176ea4aa991508d7edc335eb5 -#: ../src/Doc/whatsnew/2.2.rst:1084 +#: whatsnew/2.2.rst:1084 msgid "objects, and :c:func:`PyObject_GC_Del` to deallocate them." msgstr "" -# 4a9c585bea85475394ce3813e74a1360 -#: ../src/Doc/whatsnew/2.2.rst:1086 -msgid "Rename :c:func:`PyObject_GC_Init` to :c:func:`PyObject_GC_Track` and" +#: whatsnew/2.2.rst:1087 +msgid "Rename PyObject_GC_Init() to PyObject_GC_Track() and" msgstr "" # 802f896513a94c1b82f983f4d68dba44 -#: ../src/Doc/whatsnew/2.2.rst:1087 +#: whatsnew/2.2.rst:1087 msgid ":c:func:`PyObject_GC_Fini` to :c:func:`PyObject_GC_UnTrack`." msgstr "" # 65db9ed80927491aa00b12fba60c46f1 -#: ../src/Doc/whatsnew/2.2.rst:1089 +#: whatsnew/2.2.rst:1089 msgid "Remove :c:func:`PyGC_HEAD_SIZE` from object size calculations." msgstr "" # 101f369b5d994e36adc0efb37c120957 -#: ../src/Doc/whatsnew/2.2.rst:1091 +#: whatsnew/2.2.rst:1091 msgid "" "Remove calls to :c:func:`PyObject_AS_GC` and :c:func:`PyObject_FROM_GC`." msgstr "" # 329a53540ac948f18ae6cfbeeeb03df6 -#: ../src/Doc/whatsnew/2.2.rst:1093 +#: whatsnew/2.2.rst:1093 msgid "" "A new ``et`` format sequence was added to :c:func:`PyArg_ParseTuple`; ``et`` " "takes both a parameter and an encoding name, and converts the parameter to " @@ -3764,7 +3741,7 @@ msgid "" msgstr "" # 0e4b7c2bc4b24fdcbcbeee0c64e039d5 -#: ../src/Doc/whatsnew/2.2.rst:1102 +#: whatsnew/2.2.rst:1102 msgid "" "A different argument parsing function, :c:func:`PyArg_UnpackTuple`, has been " "added that's simpler and presumably faster. Instead of specifying a format " @@ -3773,7 +3750,7 @@ msgid "" "be filled in with argument values." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1108 +#: whatsnew/2.2.rst:1108 msgid "" "Two new flags :const:`METH_NOARGS` and :const:`METH_O` are available in " "method definition tables to simplify implementation of methods with no " @@ -3784,7 +3761,7 @@ msgid "" msgstr "" # 2e32c7b2c1be40d985807373d1042cca -#: ../src/Doc/whatsnew/2.2.rst:1114 +#: whatsnew/2.2.rst:1114 msgid "" "Two new wrapper functions, :c:func:`PyOS_snprintf` and :c:func:" "`PyOS_vsnprintf` were added to provide cross-platform implementations for " @@ -3795,7 +3772,7 @@ msgid "" msgstr "" # d59cee52825f44949effe9ac39089ff4 -#: ../src/Doc/whatsnew/2.2.rst:1121 +#: whatsnew/2.2.rst:1121 msgid "" "The :c:func:`_PyTuple_Resize` function has lost an unused parameter, so now " "it takes 2 parameters instead of 3. The third argument was never used, and " @@ -3803,7 +3780,7 @@ msgid "" "2.2." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1131 +#: whatsnew/2.2.rst:1131 msgid "" "As usual there were a bunch of other improvements and bugfixes scattered " "throughout the source tree. A search through the CVS change logs finds " @@ -3812,18 +3789,18 @@ msgid "" "and fixed 82 bugs. These figures are likely to be underestimates." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1137 ../src/Doc/whatsnew/2.3.rst:1967 +#: whatsnew/2.2.rst:1137 whatsnew/2.3.rst:1967 msgid "Some of the more notable changes are:" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1139 +#: whatsnew/2.2.rst:1139 msgid "" "The code for the MacOS port for Python, maintained by Jack Jansen, is now " "kept in the main Python CVS tree, and many changes have been made to support " "MacOS X." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1142 +#: whatsnew/2.2.rst:1142 msgid "" "The most significant change is the ability to build Python as a framework, " "enabled by supplying the :option:`--enable-framework` option to the " @@ -3837,7 +3814,7 @@ msgid "" "OSA scripting language and much more.\"" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1153 +#: whatsnew/2.2.rst:1153 msgid "" "Most of the MacPython toolbox modules, which interface to MacOS APIs such as " "windowing, QuickTime, scripting, etc. have been ported to OS X, but they've " @@ -3845,14 +3822,14 @@ msgid "" "with these modules can uncomment them manually." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1176 +#: whatsnew/2.2.rst:1176 msgid "" "Keyword arguments passed to built-in functions that don't take them now " "cause a :exc:`TypeError` exception to be raised, with the message " "\"*function* takes no keyword arguments\"." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1180 +#: whatsnew/2.2.rst:1180 msgid "" "Weak references, added in Python 2.1 as an extension module, are now part of " "the core because they're used in the implementation of new-style classes. " @@ -3860,14 +3837,14 @@ msgid "" "`weakref` module to become a built-in exception." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1185 +#: whatsnew/2.2.rst:1185 msgid "" "A new script, :file:`Tools/scripts/cleanfuture.py` by Tim Peters, " "automatically removes obsolete ``__future__`` statements from Python source " "code." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1189 +#: whatsnew/2.2.rst:1189 msgid "" "An additional *flags* argument has been added to the built-in function :func:" "`compile`, so the behaviour of ``__future__`` statements can now be " @@ -3876,7 +3853,7 @@ msgid "" "(Contributed by Michael Hudson.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1195 +#: whatsnew/2.2.rst:1195 msgid "" "The new license introduced with Python 1.6 wasn't GPL-compatible. This is " "fixed by some minor textual changes to the 2.2 license, so it's now legal to " @@ -3886,7 +3863,7 @@ msgid "" "to the Python 2.0.1 and 2.1.1 releases." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1202 +#: whatsnew/2.2.rst:1202 msgid "" "When presented with a Unicode filename on Windows, Python will now convert " "it to an MBCS encoded string, as used by the Microsoft file APIs. As MBCS " @@ -3897,19 +3874,19 @@ msgid "" "Lemburg. Unix support was added by Martin von Löwis.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1210 +#: whatsnew/2.2.rst:1210 msgid "" "Large file support is now enabled on Windows. (Contributed by Tim Peters.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1212 +#: whatsnew/2.2.rst:1212 msgid "" "The :file:`Tools/scripts/ftpmirror.py` script now parses a :file:`.netrc` " "file, if you have one. (Contributed by Mike Romberg.)" msgstr "" # 6548f20ef6194efe88649daa6b5ff54c -#: ../src/Doc/whatsnew/2.2.rst:1215 +#: whatsnew/2.2.rst:1215 msgid "" "Some features of the object returned by the :func:`xrange` function are now " "deprecated, and trigger warnings when they're accessed; they'll disappear in " @@ -3921,7 +3898,7 @@ msgid "" "to the :c:func:`PyRange_New` function, ``repeat``, has also been deprecated." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1224 +#: whatsnew/2.2.rst:1224 msgid "" "There were a bunch of patches to the dictionary implementation, mostly to " "fix potential core dumps if a dictionary contains objects that sneakily " @@ -3931,14 +3908,14 @@ msgid "" "case, and round and round it went." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1231 +#: whatsnew/2.2.rst:1231 msgid "" "On Windows, Python can now be compiled with Borland C thanks to a number of " "patches contributed by Stephen Hansen, though the result isn't fully " "functional yet. (But this *is* progress...)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1235 +#: whatsnew/2.2.rst:1235 msgid "" "Another Windows enhancement: Wise Solutions generously offered PythonLabs " "use of their InstallerMaster 8.1 system. Earlier PythonLabs Windows " @@ -3946,7 +3923,7 @@ msgid "" "up by Tim Peters.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1239 +#: whatsnew/2.2.rst:1239 msgid "" "Files ending in ``.pyw`` can now be imported on Windows. ``.pyw`` is a " "Windows-only thing, used to indicate that a script needs to be run using " @@ -3957,7 +3934,7 @@ msgid "" msgstr "" # 54ebe9e2f17d4af38f80d8c8f91897a3 -#: ../src/Doc/whatsnew/2.2.rst:1245 +#: whatsnew/2.2.rst:1245 msgid "" "On platforms where Python uses the C :c:func:`dlopen` function to load " "extension modules, it's now possible to set the flags used by :c:func:" @@ -3965,7 +3942,7 @@ msgid "" "functions. (Contributed by Bram Stolk.)" msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1250 +#: whatsnew/2.2.rst:1250 msgid "" "The :func:`pow` built-in function no longer supports 3 arguments when " "floating-point numbers are supplied. ``pow(x, y, z)`` returns ``(x**y) % " @@ -3974,7 +3951,7 @@ msgid "" "``pow(2.0, 8.0, 7.0)`` will now raise a :exc:`TypeError` exception." msgstr "" -#: ../src/Doc/whatsnew/2.2.rst:1262 +#: whatsnew/2.2.rst:1262 msgid "" "The author would like to thank the following people for offering " "suggestions, corrections and assistance with various drafts of this article: " @@ -3986,18 +3963,18 @@ msgid "" "Rossum, Greg Ward, Edward Welbourne." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:3 +#: whatsnew/2.3.rst:3 #, fuzzy msgid "What's New in Python 2.3" msgstr "Nouveautés de Python 2.0" -#: ../src/Doc/whatsnew/2.3.rst:11 +#: whatsnew/2.3.rst:11 msgid "" "This article explains the new features in Python 2.3. Python 2.3 was " "released on July 29, 2003." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:14 +#: whatsnew/2.3.rst:14 msgid "" "The main themes for Python 2.3 are polishing some of the features added in " "2.2, adding various small but useful enhancements to the core language, and " @@ -4009,7 +3986,7 @@ msgid "" "substring searches (e.g. ``\"ab\" in \"abc\"`` returns :const:`True`)." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:23 +#: whatsnew/2.3.rst:23 msgid "" "Some of the many new library features include Boolean, set, heap, and date/" "time data types, the ability to import modules from ZIP-format archives, " @@ -4019,7 +3996,7 @@ msgid "" "new and enhanced modules is lengthy." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:30 +#: whatsnew/2.3.rst:30 msgid "" "This article doesn't attempt to provide a complete specification of the new " "features, but instead provides a convenient overview. For full details, you " @@ -4029,11 +4006,11 @@ msgid "" "particular new feature." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:41 +#: whatsnew/2.3.rst:41 msgid "PEP 218: A Standard Set Datatype" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:43 +#: whatsnew/2.3.rst:43 msgid "" "The new :mod:`sets` module contains an implementation of a set datatype. " "The :class:`Set` class is for mutable sets, sets that can have members added " @@ -4043,11 +4020,11 @@ msgid "" "within a set must be hashable." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:50 +#: whatsnew/2.3.rst:50 msgid "Here's a simple example::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:66 +#: whatsnew/2.3.rst:66 msgid "" "The union and intersection of sets can be computed with the :meth:`union` " "and :meth:`intersection` methods; an alternative notation uses the bitwise " @@ -4055,7 +4032,7 @@ msgid "" "methods, :meth:`union_update` and :meth:`intersection_update`. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:86 +#: whatsnew/2.3.rst:86 msgid "" "It's also possible to take the symmetric difference of two sets. This is " "the set of all elements in the union that aren't in the intersection. " @@ -4065,25 +4042,23 @@ msgid "" "`symmetric_difference_update`. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:100 +#: whatsnew/2.3.rst:100 msgid "" "There are also :meth:`issubset` and :meth:`issuperset` methods for checking " "whether one set is a subset or superset of another::" msgstr "" -# 604b3b4bcd844c668b95e251f997a68c -# 11e6a4ca065d42759a448502eb06b5ef -#: ../src/Doc/whatsnew/2.3.rst:116 ../src/Doc/whatsnew/2.4.rst:82 -msgid ":pep:`218` - Adding a Built-In Set Object Type" +#: whatsnew/2.3.rst:117 whatsnew/2.4.rst:83 +msgid "PEP 218 - Adding a Built-In Set Object Type" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:117 +#: whatsnew/2.3.rst:117 msgid "" "PEP written by Greg V. Wilson. Implemented by Greg V. Wilson, Alex Martelli, " "and GvR." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:128 +#: whatsnew/2.3.rst:128 msgid "" "In Python 2.2, generators were added as an optional feature, to be enabled " "by a ``from __future__ import generators`` directive. In 2.3 generators no " @@ -4094,7 +4069,7 @@ msgid "" "the rest of this section." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:136 +#: whatsnew/2.3.rst:136 msgid "" "You're doubtless familiar with how function calls work in Python or C. When " "you call a function, it gets a private namespace where its local variables " @@ -4107,7 +4082,7 @@ msgid "" "functions." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:151 +#: whatsnew/2.3.rst:151 msgid "" "A new keyword, :keyword:`yield`, was introduced for generators. Any " "function containing a :keyword:`yield` statement is a generator function; " @@ -4115,7 +4090,7 @@ msgid "" "specially as a result." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:156 +#: whatsnew/2.3.rst:156 msgid "" "When you call a generator function, it doesn't return a single value; " "instead it returns a generator object that supports the iterator protocol. " @@ -4131,7 +4106,7 @@ msgid "" "explanation of the interaction between :keyword:`yield` and exceptions.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:236 +#: whatsnew/2.3.rst:236 msgid "" "Python doesn't go nearly as far as Icon in adopting generators as a central " "concept. Generators are considered part of the core Python language, but " @@ -4142,11 +4117,11 @@ msgid "" "functions or stored in a data structure." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:257 +#: whatsnew/2.3.rst:257 msgid "PEP 263: Source Code Encodings" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:259 +#: whatsnew/2.3.rst:259 msgid "" "Python source files can now be declared as being in different character set " "encodings. Encodings are declared by including a specially formatted " @@ -4154,7 +4129,7 @@ msgid "" "UTF-8 file can be declared with::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:267 +#: whatsnew/2.3.rst:267 msgid "" "Without such an encoding declaration, the default encoding used is 7-bit " "ASCII. Executing or importing modules that contain string literals with 8-" @@ -4163,7 +4138,7 @@ msgid "" "syntax error." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:273 +#: whatsnew/2.3.rst:273 msgid "" "The encoding declaration only affects Unicode string literals, which will be " "converted to Unicode using the specified encoding. Note that Python " @@ -4171,22 +4146,21 @@ msgid "" "variable names that use characters outside of the usual alphanumerics." msgstr "" -# 87105120b9b04b08aeb7070f9bd4eddd -#: ../src/Doc/whatsnew/2.3.rst:281 -msgid ":pep:`263` - Defining Python Source Code Encodings" +#: whatsnew/2.3.rst:282 +msgid "PEP 263 - Defining Python Source Code Encodings" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:282 +#: whatsnew/2.3.rst:282 msgid "" "Written by Marc-André Lemburg and Martin von Löwis; implemented by Suzuki " "Hisao and Martin von Löwis." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:289 +#: whatsnew/2.3.rst:289 msgid "PEP 273: Importing Modules from ZIP Archives" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:291 +#: whatsnew/2.3.rst:291 msgid "" "The new :mod:`zipimport` module adds support for importing modules from a " "ZIP- format archive. You don't need to import the module explicitly; it " @@ -4194,7 +4168,7 @@ msgid "" "path``. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:312 +#: whatsnew/2.3.rst:312 msgid "" "An entry in ``sys.path`` can now be the filename of a ZIP archive. The ZIP " "archive can contain any kind of files, but only files named :file:`\\*.py`, :" @@ -4204,19 +4178,18 @@ msgid "" "archive doesn't contain :file:`\\*.pyc` files, importing may be rather slow." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:319 +#: whatsnew/2.3.rst:319 msgid "" "A path within the archive can also be specified to only import from a " "subdirectory; for example, the path :file:`/tmp/example.zip/lib/` would only " "import from the :file:`lib/` subdirectory within the archive." msgstr "" -# ab4efd1d85b541e5850ddd4331e86888 -#: ../src/Doc/whatsnew/2.3.rst:328 -msgid ":pep:`273` - Import Modules from Zip Archives" +#: whatsnew/2.3.rst:329 +msgid "PEP 273 - Import Modules from Zip Archives" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:327 +#: whatsnew/2.3.rst:327 msgid "" "Written by James C. Ahlstrom, who also provided an implementation. Python " "2.3 follows the specification in :pep:`273`, but uses an implementation " @@ -4225,18 +4198,18 @@ msgid "" "hooks." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:336 +#: whatsnew/2.3.rst:336 msgid "PEP 277: Unicode file name support for Windows NT" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:338 +#: whatsnew/2.3.rst:338 msgid "" "On Windows NT, 2000, and XP, the system stores file names as Unicode " "strings. Traditionally, Python has represented file names as byte strings, " "which is inadequate because it renders some file names inaccessible." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:342 +#: whatsnew/2.3.rst:342 msgid "" "Python now allows using arbitrary Unicode strings (within the limitations of " "the file system) for all functions that expect file names, most notably the :" @@ -4245,13 +4218,13 @@ msgid "" "func:`os.getcwdu`, returns the current directory as a Unicode string." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:348 +#: whatsnew/2.3.rst:348 msgid "" "Byte strings still work as file names, and on Windows Python will " "transparently convert them to Unicode using the ``mbcs`` encoding." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:351 +#: whatsnew/2.3.rst:351 msgid "" "Other systems also allow Unicode strings as file names but convert them to " "byte strings before passing them to the system, which can cause a :exc:" @@ -4260,26 +4233,25 @@ msgid "" "supports_unicode_filenames`, a Boolean value." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:357 +#: whatsnew/2.3.rst:357 msgid "Under MacOS, :func:`os.listdir` may now return Unicode filenames." msgstr "" -# 610fef83566448148cedead9029ac616 -#: ../src/Doc/whatsnew/2.3.rst:362 -msgid ":pep:`277` - Unicode file name support for Windows NT" +#: whatsnew/2.3.rst:363 +msgid "PEP 277 - Unicode file name support for Windows NT" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:363 +#: whatsnew/2.3.rst:363 msgid "" "Written by Neil Hodgson; implemented by Neil Hodgson, Martin von Löwis, and " "Mark Hammond." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:373 +#: whatsnew/2.3.rst:373 msgid "PEP 278: Universal Newline Support" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:375 +#: whatsnew/2.3.rst:375 msgid "" "The three major operating systems used today are Microsoft Windows, Apple's " "Macintosh OS, and the various Unix derivatives. A minor irritation of " @@ -4291,7 +4263,7 @@ msgid "" msgstr "" # 50aeb53f8c64462dad7176949cb09f35 -#: ../src/Doc/whatsnew/2.3.rst:382 +#: whatsnew/2.3.rst:382 msgid "" "Python's file objects can now support end of line conventions other than the " "one followed by the platform on which Python is running. Opening a file with " @@ -4301,7 +4273,7 @@ msgid "" "methods such as :meth:`read` and :meth:`readline`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:389 +#: whatsnew/2.3.rst:389 msgid "" "Universal newline support is also used when importing modules and when " "executing a file with the :func:`execfile` function. This means that Python " @@ -4309,27 +4281,26 @@ msgid "" "convert the line-endings." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:394 +#: whatsnew/2.3.rst:394 msgid "" "This feature can be disabled when compiling Python by specifying the :option:" "`--without-universal-newlines` switch when running Python's :program:" "`configure` script." msgstr "" -# bdc88e9c637544f98742013e850ae401 -#: ../src/Doc/whatsnew/2.3.rst:400 -msgid ":pep:`278` - Universal Newline Support" +#: whatsnew/2.3.rst:401 +msgid "PEP 278 - Universal Newline Support" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:402 +#: whatsnew/2.3.rst:402 msgid "Written and implemented by Jack Jansen." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:410 +#: whatsnew/2.3.rst:410 msgid "PEP 279: enumerate()" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:412 +#: whatsnew/2.3.rst:412 msgid "" "A new built-in function, :func:`enumerate`, will make certain loops a bit " "clearer. ``enumerate(thing)``, where *thing* is either an iterator or a " @@ -4337,28 +4308,27 @@ msgid "" "thing[1])``, ``(2, thing[2])``, and so forth." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:417 +#: whatsnew/2.3.rst:417 msgid "A common idiom to change every element of a list looks like this::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:424 +#: whatsnew/2.3.rst:424 msgid "This can be rewritten using :func:`enumerate` as::" msgstr "" -# 1d98608f86004c12b0eca363b9511dd6 -#: ../src/Doc/whatsnew/2.3.rst:432 -msgid ":pep:`279` - The enumerate() built-in function" +#: whatsnew/2.3.rst:433 +msgid "PEP 279 - The enumerate() built-in function" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:434 +#: whatsnew/2.3.rst:434 msgid "Written and implemented by Raymond D. Hettinger." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:440 +#: whatsnew/2.3.rst:440 msgid "PEP 282: The logging Package" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:442 +#: whatsnew/2.3.rst:442 msgid "" "A standard package for writing logs, :mod:`logging`, has been added to " "Python 2.3. It provides a powerful and flexible mechanism for generating " @@ -4370,7 +4340,7 @@ msgid "" "possible to write your own handler classes." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:451 +#: whatsnew/2.3.rst:451 msgid "" "The :class:`Logger` class is the primary class. Most application code will " "deal with one or more :class:`Logger` objects, each one used by a particular " @@ -4385,19 +4355,18 @@ msgid "" "the parent of all other loggers." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:462 +#: whatsnew/2.3.rst:462 msgid "" "For simple uses, the :mod:`logging` package contains some convenience " "functions that always use the root log::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:473 ../src/Doc/whatsnew/2.3.rst:498 -#: ../src/Doc/whatsnew/2.6.rst:638 +#: whatsnew/2.3.rst:473 whatsnew/2.3.rst:498 whatsnew/2.6.rst:638 #, fuzzy msgid "This produces the following output::" msgstr "Produisant l'affichage suivant :" -#: ../src/Doc/whatsnew/2.3.rst:479 +#: whatsnew/2.3.rst:479 msgid "" "In the default configuration, informational and debugging messages are " "suppressed and the output is sent to standard error. You can enable the " @@ -4405,21 +4374,21 @@ msgid "" "`setLevel` method on the root logger." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:484 +#: whatsnew/2.3.rst:484 msgid "" "Notice the :func:`warning` call's use of string formatting operators; all of " "the functions for logging messages take the arguments ``(msg, arg1, " "arg2, ...)`` and log the string resulting from ``msg % (arg1, arg2, ...)``." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:488 +#: whatsnew/2.3.rst:488 msgid "" "There's also an :func:`exception` function that records the most recent " "traceback. Any of the other functions will also record the traceback if you " "specify a true value for the keyword argument *exc_info*. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:506 +#: whatsnew/2.3.rst:506 msgid "" "Slightly more advanced programs will use a logger other than the root " "logger. The :func:`getLogger(name)` function is used to get a particular " @@ -4427,7 +4396,7 @@ msgid "" "the root logger. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:517 +#: whatsnew/2.3.rst:517 msgid "" "Log records are usually propagated up the hierarchy, so a message logged to " "``server.auth`` is also seen by ``server`` and ``root``, but a :class:" @@ -4435,7 +4404,7 @@ msgid "" "const:`False`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:521 +#: whatsnew/2.3.rst:521 msgid "" "There are more classes provided by the :mod:`logging` package that can be " "customized. When a :class:`Logger` instance is told to log a message, it " @@ -4448,7 +4417,7 @@ msgid "" "own specially-written classes." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:531 +#: whatsnew/2.3.rst:531 msgid "" "With all of these features the :mod:`logging` package should provide enough " "flexibility for even the most complicated applications. This is only an " @@ -4457,20 +4426,19 @@ msgid "" "helpful." msgstr "" -# f3b37dd75b2447f981ace77b4440ac4f -#: ../src/Doc/whatsnew/2.3.rst:538 -msgid ":pep:`282` - A Logging System" +#: whatsnew/2.3.rst:539 +msgid "PEP 282 - A Logging System" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:540 +#: whatsnew/2.3.rst:540 msgid "Written by Vinay Sajip and Trent Mick; implemented by Vinay Sajip." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:548 +#: whatsnew/2.3.rst:548 msgid "PEP 285: A Boolean Type" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:550 +#: whatsnew/2.3.rst:550 msgid "" "A Boolean type was added to Python 2.3. Two new constants were added to " "the :mod:`__builtin__` module, :const:`True` and :const:`False`. (:const:" @@ -4479,20 +4447,20 @@ msgid "" "and aren't a different type.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:556 +#: whatsnew/2.3.rst:556 msgid "" "The type object for this new type is named :class:`bool`; the constructor " "for it takes any Python value and converts it to :const:`True` or :const:" "`False`. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:568 +#: whatsnew/2.3.rst:568 msgid "" "Most of the standard library modules and built-in functions have been " "changed to return Booleans. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:579 +#: whatsnew/2.3.rst:579 msgid "" "Python's Booleans were added with the primary goal of making code clearer. " "For example, if you're reading a function and encounter the statement " @@ -4502,7 +4470,7 @@ msgid "" "is quite clear." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:585 +#: whatsnew/2.3.rst:585 msgid "" "Python's Booleans were *not* added for the sake of strict type-checking. A " "very strict language such as Pascal would also prevent you performing " @@ -4515,7 +4483,7 @@ msgid "" "still works. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:603 +#: whatsnew/2.3.rst:603 msgid "" "To sum up :const:`True` and :const:`False` in a sentence: they're " "alternative ways to spell the integer values 1 and 0, with the single " @@ -4523,20 +4491,19 @@ msgid "" "and ``'False'`` instead of ``'1'`` and ``'0'``." msgstr "" -# 9ddd0fbf24fd45c1ae4fbe8bcfa4c4eb -#: ../src/Doc/whatsnew/2.3.rst:610 -msgid ":pep:`285` - Adding a bool type" +#: whatsnew/2.3.rst:611 +msgid "PEP 285 - Adding a bool type" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:612 +#: whatsnew/2.3.rst:612 msgid "Written and implemented by GvR." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:618 +#: whatsnew/2.3.rst:618 msgid "PEP 293: Codec Error Handling Callbacks" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:620 +#: whatsnew/2.3.rst:620 msgid "" "When encoding a Unicode string into a byte string, unencodable characters " "may be encountered. So far, Python has allowed specifying the error " @@ -4548,7 +4515,7 @@ msgid "" "converted string." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:628 +#: whatsnew/2.3.rst:628 msgid "" "Python now has a flexible framework to add different processing strategies. " "New error handlers can be added with :func:`codecs.register_error`, and " @@ -4560,34 +4527,33 @@ msgid "" "replacement string." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:636 +#: whatsnew/2.3.rst:636 msgid "" "Two additional error handlers have been implemented using this framework: " "\"backslashreplace\" uses Python backslash quoting to represent unencodable " "characters and \"xmlcharrefreplace\" emits XML character references." msgstr "" -# 51fe618a138a46e38b3c0db64cca6943 -#: ../src/Doc/whatsnew/2.3.rst:642 -msgid ":pep:`293` - Codec Error Handling Callbacks" +#: whatsnew/2.3.rst:643 +msgid "PEP 293 - Codec Error Handling Callbacks" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:644 +#: whatsnew/2.3.rst:644 msgid "Written and implemented by Walter Dörwald." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:652 +#: whatsnew/2.3.rst:652 msgid "PEP 301: Package Index and Metadata for Distutils" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:654 +#: whatsnew/2.3.rst:654 msgid "" "Support for the long-requested Python catalog makes its first appearance in " "2.3." msgstr "" # a0506e84af164b049d52c35bd7d12336 -#: ../src/Doc/whatsnew/2.3.rst:656 +#: whatsnew/2.3.rst:656 msgid "" "The heart of the catalog is the new Distutils :command:`register` command. " "Running ``python setup.py register`` will collect the metadata describing a " @@ -4596,7 +4562,7 @@ msgid "" "https://pypi.python.org/pypi." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:662 +#: whatsnew/2.3.rst:662 msgid "" "To make the catalog a bit more useful, a new optional *classifiers* keyword " "argument has been added to the Distutils :func:`setup` function. A list of " @@ -4604,32 +4570,31 @@ msgid "" "classify the software." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:667 +#: whatsnew/2.3.rst:667 msgid "" "Here's an example :file:`setup.py` with classifiers, written to be " "compatible with older versions of the Distutils::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:686 +#: whatsnew/2.3.rst:686 msgid "" "The full list of classifiers can be obtained by running ``python setup.py " "register --list-classifiers``." msgstr "" -# dfc0381a3fb547379def8eb100921a2a -#: ../src/Doc/whatsnew/2.3.rst:691 -msgid ":pep:`301` - Package Index and Metadata for Distutils" +#: whatsnew/2.3.rst:692 +msgid "PEP 301 - Package Index and Metadata for Distutils" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:693 +#: whatsnew/2.3.rst:693 msgid "Written and implemented by Richard Jones." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:701 +#: whatsnew/2.3.rst:701 msgid "PEP 302: New Import Hooks" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:703 +#: whatsnew/2.3.rst:703 msgid "" "While it's been possible to write custom import hooks ever since the :mod:" "`ihooks` module was introduced in Python 1.3, no one has ever been really " @@ -4639,14 +4604,14 @@ msgid "" "none of them were easily usable from C code." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:710 +#: whatsnew/2.3.rst:710 msgid "" ":pep:`302` borrows ideas from its predecessors, especially from Gordon " "McMillan's :mod:`iu` module. Three new items are added to the :mod:`sys` " "module:" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:714 +#: whatsnew/2.3.rst:714 msgid "" "``sys.path_hooks`` is a list of callable objects; most often they'll be " "classes. Each callable takes a string containing a path and either returns " @@ -4654,13 +4619,13 @@ msgid "" "`ImportError` exception if it can't handle this path." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:719 +#: whatsnew/2.3.rst:719 msgid "" "``sys.path_importer_cache`` caches importer objects for each path, so ``sys." "path_hooks`` will only need to be traversed once for each path." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:722 +#: whatsnew/2.3.rst:722 msgid "" "``sys.meta_path`` is a list of importer objects that will be traversed " "before ``sys.path`` is checked. This list is initially empty, but user code " @@ -4668,7 +4633,7 @@ msgid "" "imported by an object added to this list." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:727 +#: whatsnew/2.3.rst:727 msgid "" "Importer objects must have a single method, :meth:`find_module(fullname, " "path=None)`. *fullname* will be a module or package name, e.g. ``string`` " @@ -4677,57 +4642,56 @@ msgid "" "the corresponding module object." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:733 +#: whatsnew/2.3.rst:733 msgid "" "Pseudo-code for Python's new import logic, therefore, looks something like " "this (simplified a bit; see :pep:`302` for the full details)::" msgstr "" -# c5b98885f39540dfaae7f2f0d5f7a98b -#: ../src/Doc/whatsnew/2.3.rst:757 -msgid ":pep:`302` - New Import Hooks" +#: whatsnew/2.3.rst:758 +msgid "PEP 302 - New Import Hooks" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:759 +#: whatsnew/2.3.rst:759 msgid "" "Written by Just van Rossum and Paul Moore. Implemented by Just van Rossum." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:767 +#: whatsnew/2.3.rst:767 msgid "PEP 305: Comma-separated Files" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:769 +#: whatsnew/2.3.rst:769 msgid "" "Comma-separated files are a format frequently used for exporting data from " "databases and spreadsheets. Python 2.3 adds a parser for comma-separated " "files." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:772 +#: whatsnew/2.3.rst:772 msgid "Comma-separated format is deceptively simple at first glance::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:776 +#: whatsnew/2.3.rst:776 msgid "" "Read a line and call ``line.split(',')``: what could be simpler? But toss in " "string data that can contain commas, and things get more complicated::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:781 +#: whatsnew/2.3.rst:781 msgid "" "A big ugly regular expression can parse this, but using the new :mod:`csv` " "package is much simpler::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:791 +#: whatsnew/2.3.rst:791 msgid "" "The :func:`reader` function takes a number of different options. The field " "separator isn't limited to the comma and can be changed to any character, " "and so can the quoting and line-ending characters." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:795 +#: whatsnew/2.3.rst:795 msgid "" "Different dialects of comma-separated files can be defined and registered; " "currently there are two dialects, both used by Microsoft Excel. A separate :" @@ -4735,22 +4699,21 @@ msgid "" "succession of tuples or lists, quoting strings that contain the delimiter." msgstr "" -# 4b1e93a4f1d3443d8c93be195dad437a -#: ../src/Doc/whatsnew/2.3.rst:803 -msgid ":pep:`305` - CSV File API" +#: whatsnew/2.3.rst:804 +msgid "PEP 305 - CSV File API" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:804 +#: whatsnew/2.3.rst:804 msgid "" "Written and implemented by Kevin Altis, Dave Cole, Andrew McNamara, Skip " "Montanaro, Cliff Wells." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:813 +#: whatsnew/2.3.rst:813 msgid "PEP 307: Pickle Enhancements" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:815 +#: whatsnew/2.3.rst:815 msgid "" "The :mod:`pickle` and :mod:`cPickle` modules received some attention during " "the 2.3 development cycle. In 2.2, new-style classes could be pickled " @@ -4759,7 +4722,7 @@ msgid "" "three times longer than that for a classic class." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:821 +#: whatsnew/2.3.rst:821 msgid "" "The solution was to invent a new pickle protocol. The :func:`pickle.dumps` " "function has supported a text-or-binary flag for a long time. In 2.3, this " @@ -4769,7 +4732,7 @@ msgid "" "select the fanciest protocol available." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:828 +#: whatsnew/2.3.rst:828 msgid "" "Unpickling is no longer considered a safe operation. 2.2's :mod:`pickle` " "provided hooks for trying to prevent unsafe classes from being unpickled " @@ -4778,7 +4741,7 @@ msgid "" "You should not unpickle untrusted data in any version of Python." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:834 +#: whatsnew/2.3.rst:834 msgid "" "To reduce the pickling overhead for new-style classes, a new interface for " "customizing pickling was added using three special methods: :meth:" @@ -4786,7 +4749,7 @@ msgid "" "pep:`307` for the full semantics of these methods." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:839 +#: whatsnew/2.3.rst:839 msgid "" "As a way to compress pickles yet further, it's now possible to use integer " "codes instead of long strings to identify pickled classes. The Python " @@ -4794,20 +4757,19 @@ msgid "" "a range of codes for private use. Currently no codes have been specified." msgstr "" -# 7565ca9433644774ad46f41a5c80afc0 -#: ../src/Doc/whatsnew/2.3.rst:846 -msgid ":pep:`307` - Extensions to the pickle protocol" +#: whatsnew/2.3.rst:847 +msgid "PEP 307 - Extensions to the pickle protocol" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:848 +#: whatsnew/2.3.rst:848 msgid "Written and implemented by Guido van Rossum and Tim Peters." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:856 +#: whatsnew/2.3.rst:856 msgid "Extended Slices" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:858 +#: whatsnew/2.3.rst:858 msgid "" "Ever since Python 1.4, the slicing syntax has supported an optional third " "\"step\" or \"stride\" argument. For example, these are all legal Python " @@ -4818,22 +4780,22 @@ msgid "" "if you tried it. Michael Hudson contributed a patch to fix this shortcoming." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:866 +#: whatsnew/2.3.rst:866 msgid "" "For example, you can now easily extract the elements of a list that have " "even indexes::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:873 +#: whatsnew/2.3.rst:873 msgid "" "Negative values also work to make a copy of the same list in reverse order::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:878 +#: whatsnew/2.3.rst:878 msgid "This also works for tuples, arrays, and strings::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:886 +#: whatsnew/2.3.rst:886 msgid "" "If you have a mutable sequence such as a list or an array you can assign to " "or delete an extended slice, but there are some differences between " @@ -4841,28 +4803,28 @@ msgid "" "can be used to change the length of the sequence::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:898 +#: whatsnew/2.3.rst:898 msgid "" "Extended slices aren't this flexible. When assigning to an extended slice, " "the list on the right hand side of the statement must contain the same " "number of items as the slice it is replacing::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:915 +#: whatsnew/2.3.rst:915 msgid "Deletion is more straightforward::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:926 +#: whatsnew/2.3.rst:926 msgid "" "One can also now pass slice objects to the :meth:`__getitem__` methods of " "the built-in sequences::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:932 +#: whatsnew/2.3.rst:932 msgid "Or use slice objects directly in subscripts::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:937 +#: whatsnew/2.3.rst:937 msgid "" "To simplify implementing sequences that support extended slicing, slice " "objects now have a method :meth:`indices(length)` which, given the length of " @@ -4873,7 +4835,7 @@ msgid "" "used like this::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:955 +#: whatsnew/2.3.rst:955 msgid "" "From this example you can also see that the built-in :class:`slice` object " "is now the type object for the slice type, and is no longer a function. " @@ -4881,38 +4843,37 @@ msgid "" "underwent the same change." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:964 ../src/Doc/whatsnew/2.4.rst:774 -#: ../src/Doc/whatsnew/2.5.rst:973 ../src/Doc/whatsnew/2.6.rst:1481 -#: ../src/Doc/whatsnew/2.7.rst:663 +#: whatsnew/2.3.rst:964 whatsnew/2.4.rst:774 whatsnew/2.5.rst:973 +#: whatsnew/2.6.rst:1481 whatsnew/2.7.rst:663 msgid "Other Language Changes" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:966 +#: whatsnew/2.3.rst:966 msgid "" "Here are all of the changes that Python 2.3 makes to the core Python " "language." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:968 +#: whatsnew/2.3.rst:968 msgid "" "The :keyword:`yield` statement is now always a keyword, as described in " "section :ref:`section-generators` of this document." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:971 +#: whatsnew/2.3.rst:971 msgid "" "A new built-in function :func:`enumerate` was added, as described in " "section :ref:`section-enumerate` of this document." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:974 +#: whatsnew/2.3.rst:974 msgid "" "Two new constants, :const:`True` and :const:`False` were added along with " "the built-in :class:`bool` type, as described in section :ref:`section-bool` " "of this document." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:978 +#: whatsnew/2.3.rst:978 msgid "" "The :func:`int` type constructor will now return a long integer instead of " "raising an :exc:`OverflowError` when a string or floating-point number is " @@ -4921,13 +4882,13 @@ msgid "" "to cause problems in practice." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:984 +#: whatsnew/2.3.rst:984 msgid "" "Built-in types now support the extended slicing syntax, as described in " "section :ref:`section-slices` of this document." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:987 +#: whatsnew/2.3.rst:987 msgid "" "A new built-in function, :func:`sum(iterable, start=0)`, adds up the " "numeric items in the iterable object and returns their sum. :func:`sum` " @@ -4935,7 +4896,7 @@ msgid "" "of strings. (Contributed by Alex Martelli.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:992 +#: whatsnew/2.3.rst:992 msgid "" "``list.insert(pos, value)`` used to insert *value* at the front of the list " "when *pos* was negative. The behaviour has now been changed to be " @@ -4943,14 +4904,14 @@ msgid "" "inserted before the last element, and so forth." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:997 +#: whatsnew/2.3.rst:997 msgid "" "``list.index(value)``, which searches for *value* within the list and " "returns its index, now takes optional *start* and *stop* arguments to limit " "the search to only part of the list." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1001 +#: whatsnew/2.3.rst:1001 msgid "" "Dictionaries have a new method, :meth:`pop(key[, *default*])`, that returns " "the value corresponding to *key* and removes that key/value pair from the " @@ -4958,28 +4919,28 @@ msgid "" "is returned if it's specified and :exc:`KeyError` raised if it isn't. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1023 +#: whatsnew/2.3.rst:1023 msgid "" "There's also a new class method, :meth:`dict.fromkeys(iterable, value)`, " "that creates a dictionary with keys taken from the supplied iterator " "*iterable* and all values set to *value*, defaulting to ``None``." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1027 +#: whatsnew/2.3.rst:1027 msgid "(Patches contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1029 +#: whatsnew/2.3.rst:1029 msgid "" "Also, the :func:`dict` constructor now accepts keyword arguments to simplify " "creating small dictionaries::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1035 +#: whatsnew/2.3.rst:1035 msgid "(Contributed by Just van Rossum.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1037 +#: whatsnew/2.3.rst:1037 msgid "" "The :keyword:`assert` statement no longer checks the ``__debug__`` flag, so " "you can no longer disable assertions by assigning to ``__debug__``. Running " @@ -4987,7 +4948,7 @@ msgid "" "execute any assertions." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1042 +#: whatsnew/2.3.rst:1042 msgid "" "Most type objects are now callable, so you can use them to create new " "objects such as functions, classes, and modules. (This means that the :mod:" @@ -4996,7 +4957,7 @@ msgid "" "you can create a new module object with the following code:" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1057 +#: whatsnew/2.3.rst:1057 msgid "" "A new warning, :exc:`PendingDeprecationWarning` was added to indicate " "features which are in the process of being deprecated. The warning will " @@ -5006,21 +4967,21 @@ msgid "" "filterwarnings`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1063 +#: whatsnew/2.3.rst:1063 msgid "" "The process of deprecating string-based exceptions, as in ``raise \"Error " "occurred\"``, has begun. Raising a string will now trigger :exc:" "`PendingDeprecationWarning`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1067 +#: whatsnew/2.3.rst:1067 msgid "" "Using ``None`` as a variable name will now result in a :exc:`SyntaxWarning` " "warning. In a future version of Python, ``None`` may finally become a " "keyword." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1070 +#: whatsnew/2.3.rst:1070 msgid "" "The :meth:`xreadlines` method of file objects, introduced in Python 2.1, is " "no longer necessary because files now behave as their own iterator. :meth:" @@ -5032,7 +4993,7 @@ msgid "" msgstr "" # 43036fa0ad6a4af28c7cf3818513db8a -#: ../src/Doc/whatsnew/2.3.rst:1078 +#: whatsnew/2.3.rst:1078 msgid "" "The method resolution order used by new-style classes has changed, though " "you'll only notice the difference if you have a really complicated " @@ -5048,7 +5009,7 @@ msgid "" "problem and also implemented the fix by coding the C3 algorithm." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1091 +#: whatsnew/2.3.rst:1091 msgid "" "Python runs multithreaded programs by switching between threads after " "executing N bytecodes. The default value for N has been increased from 10 " @@ -5059,7 +5020,7 @@ msgid "" "with the new :func:`sys.getcheckinterval` function." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1099 +#: whatsnew/2.3.rst:1099 msgid "" "One minor but far-reaching change is that the names of extension types " "defined by the modules included with Python now contain the module and a " @@ -5067,11 +5028,11 @@ msgid "" "created a socket and printed its :attr:`__class__`, you'd get this output::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1108 +#: whatsnew/2.3.rst:1108 msgid "In 2.3, you get this::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1113 +#: whatsnew/2.3.rst:1113 msgid "" "One of the noted incompatibilities between old- and new-style classes has " "been removed: you can now assign to the :attr:`__name__` and :attr:" @@ -5080,11 +5041,11 @@ msgid "" "to assigning to an instance's :attr:`__class__` attribute." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1123 +#: whatsnew/2.3.rst:1123 msgid "String Changes" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1125 +#: whatsnew/2.3.rst:1125 msgid "" "The :keyword:`in` operator now works differently for strings. Previously, " "when evaluating ``X in Y`` where *X* and *Y* are strings, *X* could only be " @@ -5093,30 +5054,30 @@ msgid "" "*X* is the empty string, the result is always :const:`True`. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1138 +#: whatsnew/2.3.rst:1138 msgid "" "Note that this doesn't tell you where the substring starts; if you need that " "information, use the :meth:`find` string method." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1141 +#: whatsnew/2.3.rst:1141 msgid "" "The :meth:`strip`, :meth:`lstrip`, and :meth:`rstrip` string methods now " "have an optional argument for specifying the characters to strip. The " "default is still to remove all whitespace characters::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1155 +#: whatsnew/2.3.rst:1155 msgid "(Suggested by Simon Brunning and implemented by Walter Dörwald.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1157 +#: whatsnew/2.3.rst:1157 msgid "" "The :meth:`startswith` and :meth:`endswith` string methods now accept " "negative numbers for the *start* and *end* parameters." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1160 +#: whatsnew/2.3.rst:1160 msgid "" "Another new string method is :meth:`zfill`, originally a function in the :" "mod:`string` module. :meth:`zfill` pads a numeric string with zeros on the " @@ -5124,11 +5085,11 @@ msgid "" "more flexible and powerful than :meth:`zfill`. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1172 +#: whatsnew/2.3.rst:1172 msgid "(Contributed by Walter Dörwald.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1174 +#: whatsnew/2.3.rst:1174 msgid "" "A new type object, :class:`basestring`, has been added. Both 8-bit strings " "and Unicode strings inherit from this type, so ``isinstance(obj, " @@ -5136,32 +5097,31 @@ msgid "" "completely abstract type, so you can't create :class:`basestring` instances." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1179 +#: whatsnew/2.3.rst:1179 msgid "" "Interned strings are no longer immortal and will now be garbage-collected in " "the usual way when the only reference to them is from the internal " "dictionary of interned strings. (Implemented by Oren Tirosh.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1187 ../src/Doc/whatsnew/2.4.rst:933 -#: ../src/Doc/whatsnew/2.5.rst:1138 ../src/Doc/whatsnew/2.6.rst:1689 -#: ../src/Doc/whatsnew/2.7.rst:913 +#: whatsnew/2.3.rst:1187 whatsnew/2.4.rst:933 whatsnew/2.5.rst:1138 +#: whatsnew/2.6.rst:1689 whatsnew/2.7.rst:913 msgid "Optimizations" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1189 +#: whatsnew/2.3.rst:1189 msgid "" "The creation of new-style class instances has been made much faster; they're " "now faster than classic classes!" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1192 +#: whatsnew/2.3.rst:1192 msgid "" "The :meth:`sort` method of list objects has been extensively rewritten by " "Tim Peters, and the implementation is significantly faster." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1195 +#: whatsnew/2.3.rst:1195 msgid "" "Multiplication of large long integers is now much faster thanks to an " "implementation of Karatsuba multiplication, an algorithm that scales better " @@ -5171,21 +5131,21 @@ msgid "" msgstr "" # 54ce6b34dadf4c1ea783fe916755dff8 -#: ../src/Doc/whatsnew/2.3.rst:1200 +#: whatsnew/2.3.rst:1200 msgid "" "The ``SET_LINENO`` opcode is now gone. This may provide a small speed " "increase, depending on your compiler's idiosyncrasies. See section :ref:" "`section-other` for a longer explanation. (Removed by Michael Hudson.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1204 +#: whatsnew/2.3.rst:1204 msgid "" ":func:`xrange` objects now have their own iterator, making ``for i in " "xrange(n)`` slightly faster than ``for i in range(n)``. (Patch by Raymond " "Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1208 +#: whatsnew/2.3.rst:1208 msgid "" "A number of small rearrangements have been made in various hotspots to " "improve performance, such as inlining a function or removing some code. " @@ -5193,17 +5153,17 @@ msgid "" "changes.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1212 +#: whatsnew/2.3.rst:1212 msgid "" "The net result of the 2.3 optimizations is that Python 2.3 runs the pystone " "benchmark around 25% faster than Python 2.2." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1219 ../src/Doc/whatsnew/2.4.rst:990 +#: whatsnew/2.3.rst:1219 whatsnew/2.4.rst:990 msgid "New, Improved, and Deprecated Modules" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1221 ../src/Doc/whatsnew/2.4.rst:992 +#: whatsnew/2.3.rst:1221 whatsnew/2.4.rst:992 msgid "" "As usual, Python's standard library received a number of enhancements and " "bug fixes. Here's a partial list of the most notable changes, sorted " @@ -5212,7 +5172,7 @@ msgid "" "logs for all the details." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1226 +#: whatsnew/2.3.rst:1226 msgid "" "The :mod:`array` module now supports arrays of Unicode characters using the " "``'u'`` format character. Arrays also now support using the ``+=`` " @@ -5220,14 +5180,14 @@ msgid "" "assignment operator to repeat an array. (Contributed by Jason Orendorff.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1231 +#: whatsnew/2.3.rst:1231 msgid "" "The :mod:`bsddb` module has been replaced by version 4.1.6 of the `PyBSDDB " "<http://pybsddb.sourceforge.net>`_ package, providing a more complete " "interface to the transactional features of the BerkeleyDB library." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1235 +#: whatsnew/2.3.rst:1235 msgid "" "The old version of the module has been renamed to :mod:`bsddb185` and is no " "longer built automatically; you'll have to edit :file:`Modules/Setup` to " @@ -5243,20 +5203,20 @@ msgid "" "statements to import it as :mod:`bsddb`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1247 +#: whatsnew/2.3.rst:1247 msgid "" "The new :mod:`bz2` module is an interface to the bz2 data compression " "library. bz2-compressed data is usually smaller than corresponding :mod:" "`zlib`\\ -compressed data. (Contributed by Gustavo Niemeyer.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1251 +#: whatsnew/2.3.rst:1251 msgid "" "A set of standard date/time types has been added in the new :mod:`datetime` " "module. See the following section for more details." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1254 +#: whatsnew/2.3.rst:1254 msgid "" "The Distutils :class:`Extension` class now supports an extra constructor " "argument named *depends* for listing additional source files that an " @@ -5266,13 +5226,13 @@ msgid "" "`Extension` object like this::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1265 +#: whatsnew/2.3.rst:1265 msgid "" "Modifying :file:`sample.h` would then cause the module to be recompiled. " "(Contributed by Jeremy Hylton.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1268 +#: whatsnew/2.3.rst:1268 msgid "" "Other minor changes to Distutils: it now checks for the :envvar:`CC`, :" "envvar:`CFLAGS`, :envvar:`CPP`, :envvar:`LDFLAGS`, and :envvar:`CPPFLAGS` " @@ -5280,7 +5240,7 @@ msgid "" "configuration (contributed by Robert Weber)." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1273 +#: whatsnew/2.3.rst:1273 msgid "" "Previously the :mod:`doctest` module would only search the docstrings of " "public methods and functions for test cases, but it now also examines " @@ -5288,13 +5248,13 @@ msgid "" "`unittest.TestSuite` object from a set of :mod:`doctest` tests." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1278 +#: whatsnew/2.3.rst:1278 msgid "" "The new :func:`gc.get_referents(object)` function returns a list of all the " "objects referenced by *object*." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1281 +#: whatsnew/2.3.rst:1281 msgid "" "The :mod:`getopt` module gained a new function, :func:`gnu_getopt`, that " "supports the same arguments as the existing :func:`getopt` function but uses " @@ -5304,21 +5264,21 @@ msgid "" "For example::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1292 +#: whatsnew/2.3.rst:1292 msgid "(Contributed by Peter Åstrand.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1294 +#: whatsnew/2.3.rst:1294 msgid "" "The :mod:`grp`, :mod:`pwd`, and :mod:`resource` modules now return enhanced " "tuples::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1302 +#: whatsnew/2.3.rst:1302 msgid "The :mod:`gzip` module can now handle files exceeding 2 GiB." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1304 +#: whatsnew/2.3.rst:1304 msgid "" "The new :mod:`heapq` module contains an implementation of a heap queue " "algorithm. A heap is an array-like data structure that keeps items in a " @@ -5329,7 +5289,7 @@ msgid "" "information about the priority queue data structure.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1312 +#: whatsnew/2.3.rst:1312 msgid "" "The :mod:`heapq` module provides :func:`heappush` and :func:`heappop` " "functions for adding and removing items while maintaining the heap property " @@ -5337,12 +5297,12 @@ msgid "" "uses a Python list::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1330 +#: whatsnew/2.3.rst:1330 msgid "(Contributed by Kevin O'Connor.)" msgstr "" # 2a01baddc34c4e20a502a5f67bb1cce0 -#: ../src/Doc/whatsnew/2.3.rst:1332 +#: whatsnew/2.3.rst:1332 msgid "" "The IDLE integrated development environment has been updated using the code " "from the IDLEfork project (http://idlefork.sourceforge.net). The most " @@ -5352,13 +5312,13 @@ msgid "" "as the :mod:`idlelib` package." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1338 +#: whatsnew/2.3.rst:1338 msgid "" "The :mod:`imaplib` module now supports IMAP over SSL. (Contributed by Piers " "Lauder and Tino Lange.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1341 +#: whatsnew/2.3.rst:1341 msgid "" "The :mod:`itertools` contains a number of useful functions for use with " "iterators, inspired by various functions provided by the ML and Haskell " @@ -5370,7 +5330,7 @@ msgid "" "Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1350 +#: whatsnew/2.3.rst:1350 msgid "" "Two new functions in the :mod:`math` module, :func:`degrees(rads)` and :func:" "`radians(degs)`, convert between radians and degrees. Other functions in " @@ -5381,7 +5341,7 @@ msgid "" "Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1357 +#: whatsnew/2.3.rst:1357 msgid "" "Several new POSIX functions (:func:`getpgid`, :func:`killpg`, :func:" "`lchown`, :func:`loadavg`, :func:`major`, :func:`makedev`, :func:`minor`, " @@ -5390,14 +5350,14 @@ msgid "" "S. Otkidach.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1363 +#: whatsnew/2.3.rst:1363 msgid "" "In the :mod:`os` module, the :func:`\\*stat` family of functions can now " "report fractions of a second in a timestamp. Such time stamps are " "represented as floats, similar to the value returned by :func:`time.time`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1367 +#: whatsnew/2.3.rst:1367 msgid "" "During testing, it was found that some applications will break if time " "stamps are floats. For compatibility, when using the tuple interface of " @@ -5407,11 +5367,11 @@ msgid "" "invoked to enable float return values::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1380 +#: whatsnew/2.3.rst:1380 msgid "In Python 2.4, the default will change to always returning floats." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1382 +#: whatsnew/2.3.rst:1382 msgid "" "Application developers should enable this feature only if all their " "libraries work properly when confronted with floating point time stamps, or " @@ -5419,7 +5379,7 @@ msgid "" "application level instead of trying to enable it on a per-use basis." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1387 +#: whatsnew/2.3.rst:1387 msgid "" "The :mod:`optparse` module contains a new parser for command-line arguments " "that can convert option values to a particular Python type and will " @@ -5427,7 +5387,7 @@ msgid "" "details." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1392 +#: whatsnew/2.3.rst:1392 msgid "" "The old and never-documented :mod:`linuxaudiodev` module has been " "deprecated, and a new version named :mod:`ossaudiodev` has been added. The " @@ -5436,7 +5396,7 @@ msgid "" "date in various ways. (Contributed by Greg Ward and Nicholas FitzRoy-Dale.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1398 +#: whatsnew/2.3.rst:1398 msgid "" "The new :mod:`platform` module contains a number of functions that try to " "determine various properties of the platform you're running on. There are " @@ -5444,7 +5404,7 @@ msgid "" "and even the Linux distribution version. (Contributed by Marc-André Lemburg.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1403 +#: whatsnew/2.3.rst:1403 msgid "" "The parser objects provided by the :mod:`pyexpat` module can now optionally " "buffer character data, resulting in fewer calls to your character data " @@ -5452,7 +5412,7 @@ msgid "" "`buffer_text` attribute to :const:`True` will enable buffering." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1408 +#: whatsnew/2.3.rst:1408 msgid "" "The :func:`sample(population, k)` function was added to the :mod:`random` " "module. *population* is a sequence or :class:`xrange` object containing the " @@ -5461,25 +5421,25 @@ msgid "" "``len(population)``. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1430 +#: whatsnew/2.3.rst:1430 msgid "" "The :mod:`random` module now uses a new algorithm, the Mersenne Twister, " "implemented in C. It's faster and more extensively studied than the " "previous algorithm." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1434 +#: whatsnew/2.3.rst:1434 msgid "(All changes contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1436 +#: whatsnew/2.3.rst:1436 msgid "" "The :mod:`readline` module also gained a number of new functions: :func:" "`get_history_item`, :func:`get_current_history_length`, and :func:" "`redisplay`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1440 +#: whatsnew/2.3.rst:1440 msgid "" "The :mod:`rexec` and :mod:`Bastion` modules have been declared dead, and " "attempts to import them will fail with a :exc:`RuntimeError`. New-style " @@ -5489,34 +5449,34 @@ msgid "" "to use something else." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1446 +#: whatsnew/2.3.rst:1446 msgid "" "(Sticking with Python 2.2 or 2.1 will not make your applications any safer " "because there are known bugs in the :mod:`rexec` module in those versions. " "To repeat: if you're using :mod:`rexec`, stop using it immediately.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1450 +#: whatsnew/2.3.rst:1450 msgid "" "The :mod:`rotor` module has been deprecated because the algorithm it uses " "for encryption is not believed to be secure. If you need encryption, use " "one of the several AES Python modules that are available separately." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1454 +#: whatsnew/2.3.rst:1454 msgid "" "The :mod:`shutil` module gained a :func:`move(src, dest)` function that " "recursively moves a file or directory to a new location." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1457 +#: whatsnew/2.3.rst:1457 msgid "" "Support for more advanced POSIX signal handling was added to the :mod:" "`signal` but then removed again as it proved impossible to make it work " "reliably across platforms." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1461 +#: whatsnew/2.3.rst:1461 msgid "" "The :mod:`socket` module now supports timeouts. You can call the :meth:" "`settimeout(t)` method on a socket object to set a timeout of *t* seconds. " @@ -5524,7 +5484,7 @@ msgid "" "will abort and raise a :exc:`socket.timeout` exception." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1466 +#: whatsnew/2.3.rst:1466 msgid "" "The original timeout implementation was by Tim O'Malley. Michael Gilfix " "integrated it into the Python :mod:`socket` module and shepherded it through " @@ -5533,26 +5493,26 @@ msgid "" "in action.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1472 +#: whatsnew/2.3.rst:1472 msgid "" "On Windows, the :mod:`socket` module now ships with Secure Sockets Layer " "(SSL) support." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1475 +#: whatsnew/2.3.rst:1475 msgid "" "The value of the C :const:`PYTHON_API_VERSION` macro is now exposed at the " "Python level as ``sys.api_version``. The current exception can be cleared " "by calling the new :func:`sys.exc_clear` function." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1479 +#: whatsnew/2.3.rst:1479 msgid "" "The new :mod:`tarfile` module allows reading from and writing to :program:" "`tar`\\ -format archive files. (Contributed by Lars Gustäbel.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1482 +#: whatsnew/2.3.rst:1482 msgid "" "The new :mod:`textwrap` module contains functions for wrapping strings " "containing paragraphs of text. The :func:`wrap(text, width)` function takes " @@ -5563,7 +5523,7 @@ msgid "" "example::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1504 +#: whatsnew/2.3.rst:1504 msgid "" "The module also contains a :class:`TextWrapper` class that actually " "implements the text wrapping strategy. Both the :class:`TextWrapper` class " @@ -5572,7 +5532,7 @@ msgid "" "module's documentation for details. (Contributed by Greg Ward.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1510 +#: whatsnew/2.3.rst:1510 msgid "" "The :mod:`thread` and :mod:`threading` modules now have companion modules, :" "mod:`dummy_thread` and :mod:`dummy_threading`, that provide a do-nothing " @@ -5582,7 +5542,7 @@ msgid "" "code at the top::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1522 +#: whatsnew/2.3.rst:1522 msgid "" "In this example, :mod:`_threading` is used as the module name to make it " "clear that the module being used is not necessarily the actual :mod:" @@ -5593,7 +5553,7 @@ msgid "" "another thread to return or to do something will simply hang forever." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1530 +#: whatsnew/2.3.rst:1530 msgid "" "The :mod:`time` module's :func:`strptime` function has long been an " "annoyance because it uses the platform C library's :func:`strptime` " @@ -5602,7 +5562,7 @@ msgid "" "and should behave identically on all platforms." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1536 +#: whatsnew/2.3.rst:1536 msgid "" "The new :mod:`timeit` module helps measure how long snippets of Python code " "take to execute. The :file:`timeit.py` file can be run directly from the " @@ -5612,14 +5572,14 @@ msgid "" "it or by using the :func:`unicode` function::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1556 +#: whatsnew/2.3.rst:1556 msgid "" "The :mod:`Tix` module has received various bug fixes and updates for the " "current version of the Tix package." msgstr "" # e796ed197479444a834a668530a4c907 -#: ../src/Doc/whatsnew/2.3.rst:1559 +#: whatsnew/2.3.rst:1559 msgid "" "The :mod:`Tkinter` module now works with a thread-enabled version of Tcl. " "Tcl's threading model requires that widgets only be accessed from the thread " @@ -5634,7 +5594,7 @@ msgid "" "(Implemented by Martin von Löwis.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1570 +#: whatsnew/2.3.rst:1570 msgid "" "Calling Tcl methods through :mod:`_tkinter` no longer returns only strings. " "Instead, if Tcl returns other objects those objects are converted to their " @@ -5643,7 +5603,7 @@ msgid "" "controlled through the :meth:`wantobjects` method of :class:`tkapp` objects." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1576 +#: whatsnew/2.3.rst:1576 msgid "" "When using :mod:`_tkinter` through the :mod:`Tkinter` module (as most " "Tkinter applications will), this feature is always activated. It should not " @@ -5651,18 +5611,18 @@ msgid "" "results to Python types where possible." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1581 +#: whatsnew/2.3.rst:1581 msgid "" "If any incompatibilities are found, the old behavior can be restored by " "setting the :attr:`wantobjects` variable in the :mod:`Tkinter` module to " "false before creating the first :class:`tkapp` object. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1588 +#: whatsnew/2.3.rst:1588 msgid "Any breakage caused by this change should be reported as a bug." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1590 +#: whatsnew/2.3.rst:1590 msgid "" "The :mod:`UserDict` module has a new :class:`DictMixin` class which defines " "all dictionary methods for classes that already have a minimum mapping " @@ -5671,29 +5631,27 @@ msgid "" "module." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1596 +#: whatsnew/2.3.rst:1596 msgid "" "Adding the mix-in as a superclass provides the full dictionary interface " "whenever the class defines :meth:`__getitem__`, :meth:`__setitem__`, :meth:" "`__delitem__`, and :meth:`keys`. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1637 ../src/Doc/whatsnew/2.4.rst:891 -#: ../src/Doc/whatsnew/2.4.rst:919 ../src/Doc/whatsnew/2.4.rst:1212 -#: ../src/Doc/whatsnew/2.5.rst:1372 ../src/Doc/whatsnew/2.5.rst:1381 -#: ../src/Doc/whatsnew/2.6.rst:1592 ../src/Doc/whatsnew/2.6.rst:1876 -#: ../src/Doc/whatsnew/2.6.rst:1897 +#: whatsnew/2.3.rst:1637 whatsnew/2.4.rst:891 whatsnew/2.4.rst:919 +#: whatsnew/2.4.rst:1212 whatsnew/2.5.rst:1372 whatsnew/2.5.rst:1381 +#: whatsnew/2.6.rst:1592 whatsnew/2.6.rst:1876 whatsnew/2.6.rst:1897 msgid "(Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1639 +#: whatsnew/2.3.rst:1639 msgid "" "The DOM implementation in :mod:`xml.dom.minidom` can now generate XML output " "in a particular encoding by providing an optional encoding argument to the :" "meth:`toxml` and :meth:`toprettyxml` methods of DOM nodes." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1643 +#: whatsnew/2.3.rst:1643 msgid "" "The :mod:`xmlrpclib` module now supports an XML-RPC extension for handling " "nil data values such as Python's ``None``. Nil values are always supported " @@ -5702,7 +5660,7 @@ msgid "" "creating a :class:`Marshaller` instance." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1649 +#: whatsnew/2.3.rst:1649 msgid "" "The new :mod:`DocXMLRPCServer` module allows writing self-documenting XML-" "RPC servers. Run it in demo mode (as a program) to see it in action. " @@ -5711,14 +5669,14 @@ msgid "" "methods. (Contributed by Brian Quinlan.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1655 +#: whatsnew/2.3.rst:1655 msgid "" "Support for internationalized domain names (RFCs 3454, 3490, 3491, and 3492) " "has been added. The \"idna\" encoding can be used to convert between a " "Unicode domain name and the ASCII-compatible encoding (ACE) of that name. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1662 +#: whatsnew/2.3.rst:1662 msgid "" "The :mod:`socket` module has also been extended to transparently convert " "Unicode hostnames to the ACE version before passing them to the C library. " @@ -5729,24 +5687,24 @@ msgid "" "URL is ASCII only." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1670 +#: whatsnew/2.3.rst:1670 msgid "" "To implement this change, the :mod:`stringprep` module, the " "``mkstringprep`` tool and the ``punycode`` encoding have been added." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1677 +#: whatsnew/2.3.rst:1677 msgid "Date/Time Type" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1679 +#: whatsnew/2.3.rst:1679 msgid "" "Date and time types suitable for expressing timestamps were added as the :" "mod:`datetime` module. The types don't support different calendars or many " "fancy features, and just stick to the basics of representing time." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1683 +#: whatsnew/2.3.rst:1683 msgid "" "The three primary types are: :class:`date`, representing a day, month, and " "year; :class:`time`, consisting of hour, minute, and second; and :class:" @@ -5756,7 +5714,7 @@ msgid "" "by classes inheriting from the abstract :class:`tzinfo` class." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1690 +#: whatsnew/2.3.rst:1690 msgid "" "You can create instances of :class:`date` and :class:`time` by either " "supplying keyword arguments to the appropriate constructor, e.g. ``datetime." @@ -5765,19 +5723,19 @@ msgid "" "current local date." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1696 +#: whatsnew/2.3.rst:1696 msgid "" "Once created, instances of the date/time classes are all immutable. There " "are a number of methods for producing formatted strings from objects::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1708 +#: whatsnew/2.3.rst:1708 msgid "" "The :meth:`replace` method allows modifying one or more fields of a :class:" "`date` or :class:`datetime` instance, returning a new instance::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1718 +#: whatsnew/2.3.rst:1718 msgid "" "Instances can be compared, hashed, and converted to strings (the result is " "the same as that of :meth:`isoformat`). :class:`date` and :class:`datetime` " @@ -5787,17 +5745,17 @@ msgid "" "`datetime`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1725 +#: whatsnew/2.3.rst:1725 msgid "" "For more information, refer to the module's reference documentation. " "(Contributed by Tim Peters.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1732 +#: whatsnew/2.3.rst:1732 msgid "The optparse Module" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1734 +#: whatsnew/2.3.rst:1734 msgid "" "The :mod:`getopt` module provides simple parsing of command-line arguments. " "The new :mod:`optparse` module (originally named Optik) provides more " @@ -5806,51 +5764,51 @@ msgid "" "different actions for different options." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1740 +#: whatsnew/2.3.rst:1740 msgid "" "You start by creating an instance of :class:`OptionParser` and telling it " "what your program's options are. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1754 +#: whatsnew/2.3.rst:1754 msgid "" "Parsing a command line is then done by calling the :meth:`parse_args` " "method. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1760 +#: whatsnew/2.3.rst:1760 msgid "" "This returns an object containing all of the option values, and a list of " "strings containing the remaining arguments." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1763 +#: whatsnew/2.3.rst:1763 msgid "" "Invoking the script with the various arguments now works as you'd expect it " "to. Note that the length argument is automatically converted to an " "integer. ::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1774 +#: whatsnew/2.3.rst:1774 msgid "The help message is automatically generated for you::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1787 +#: whatsnew/2.3.rst:1787 msgid "See the module's documentation for more details." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1790 +#: whatsnew/2.3.rst:1790 msgid "" "Optik was written by Greg Ward, with suggestions from the readers of the " "Getopt SIG." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1799 +#: whatsnew/2.3.rst:1799 msgid "Pymalloc: A Specialized Object Allocator" msgstr "" # 7d99a991aa4e47009bacde9e7ab51520 -#: ../src/Doc/whatsnew/2.3.rst:1801 +#: whatsnew/2.3.rst:1801 msgid "" "Pymalloc, a specialized object allocator written by Vladimir Marangozov, was " "a feature added to Python 2.1. Pymalloc is intended to be faster than the " @@ -5860,7 +5818,7 @@ msgid "" "requests from these pools." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1807 +#: whatsnew/2.3.rst:1807 msgid "" "In 2.1 and 2.2, pymalloc was an experimental feature and wasn't enabled by " "default; you had to explicitly enable it when compiling Python by providing " @@ -5869,7 +5827,7 @@ msgid "" "you'll have to supply :option:`--without-pymalloc` to disable it." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1813 +#: whatsnew/2.3.rst:1813 msgid "" "This change is transparent to code written in Python; however, pymalloc may " "expose bugs in C extensions. Authors of C extension modules should test " @@ -5878,7 +5836,7 @@ msgid "" msgstr "" # 4f64634a72ae4c45b05a19ad8dbb1f9b -#: ../src/Doc/whatsnew/2.3.rst:1818 +#: whatsnew/2.3.rst:1818 msgid "" "There's one particularly common error that causes problems. There are a " "number of memory allocation functions in Python's C API that have previously " @@ -5893,7 +5851,7 @@ msgid "" "are more third-party modules that will have the same problem." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1830 +#: whatsnew/2.3.rst:1830 msgid "" "As part of this change, the confusing multiple interfaces for allocating " "memory have been consolidated down into two API families. Memory allocated " @@ -5903,7 +5861,7 @@ msgid "" msgstr "" # b5946ae9d768455f91fa76a1871ade1c -#: ../src/Doc/whatsnew/2.3.rst:1836 +#: whatsnew/2.3.rst:1836 msgid "" "To allocate and free an undistinguished chunk of memory use the \"raw memory" "\" family: :c:func:`PyMem_Malloc`, :c:func:`PyMem_Realloc`, and :c:func:" @@ -5911,7 +5869,7 @@ msgid "" msgstr "" # e1af3f7b04ca46b2933b84aa61f9ee00 -#: ../src/Doc/whatsnew/2.3.rst:1839 +#: whatsnew/2.3.rst:1839 msgid "" "The \"object memory\" family is the interface to the pymalloc facility " "described above and is biased towards a large number of \"small\" " @@ -5920,13 +5878,13 @@ msgid "" msgstr "" # e70b33e0ca2f452ca85a2017b9ae972c -#: ../src/Doc/whatsnew/2.3.rst:1843 +#: whatsnew/2.3.rst:1843 msgid "" "To allocate and free Python objects, use the \"object\" family :c:func:" "`PyObject_New`, :c:func:`PyObject_NewVar`, and :c:func:`PyObject_Del`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1846 +#: whatsnew/2.3.rst:1846 msgid "" "Thanks to lots of work by Tim Peters, pymalloc in 2.3 also provides " "debugging features to catch memory overwrites and doubled frees in both " @@ -5935,7 +5893,7 @@ msgid "" "`configure` with :option:`--with-pydebug`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1852 +#: whatsnew/2.3.rst:1852 msgid "" "To aid extension writers, a header file :file:`Misc/pymemcompat.h` is " "distributed with the source to Python 2.3 that allows Python extensions to " @@ -5945,29 +5903,28 @@ msgid "" msgstr "" # b82b80b147a145d4bb3e9a6eb7eee76c -#: ../src/Doc/whatsnew/2.3.rst:1862 +#: whatsnew/2.3.rst:1863 msgid "https://svn.python.org/view/python/trunk/Objects/obmalloc.c" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1862 +#: whatsnew/2.3.rst:1862 msgid "" "For the full details of the pymalloc implementation, see the comments at the " "top of the file :file:`Objects/obmalloc.c` in the Python source code. The " "above link points to the file within the python.org SVN browser." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1870 ../src/Doc/whatsnew/2.4.rst:1446 -#: ../src/Doc/whatsnew/2.5.rst:2079 ../src/Doc/whatsnew/2.6.rst:2975 -#: ../src/Doc/whatsnew/2.7.rst:2076 +#: whatsnew/2.3.rst:1870 whatsnew/2.4.rst:1446 whatsnew/2.5.rst:2079 +#: whatsnew/2.6.rst:2975 whatsnew/2.7.rst:2076 msgid "Build and C API Changes" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1872 ../src/Doc/whatsnew/2.5.rst:2081 -#: ../src/Doc/whatsnew/2.6.rst:2977 ../src/Doc/whatsnew/2.7.rst:2078 +#: whatsnew/2.3.rst:1872 whatsnew/2.5.rst:2081 whatsnew/2.6.rst:2977 +#: whatsnew/2.7.rst:2078 msgid "Changes to Python's build process and to the C API include:" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1874 +#: whatsnew/2.3.rst:1874 msgid "" "The cycle detection implementation used by the garbage collection has proven " "to be stable, so it's now been made mandatory. You can no longer compile " @@ -5975,7 +5932,7 @@ msgid "" "`configure` has been removed." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1879 +#: whatsnew/2.3.rst:1879 msgid "" "Python can now optionally be built as a shared library (:file:`libpython2.3." "so`) by supplying :option:`--enable-shared` when running Python's :program:" @@ -5983,7 +5940,7 @@ msgid "" msgstr "" # f3929df21488456fb73c115da52d272a -#: ../src/Doc/whatsnew/2.3.rst:1883 +#: whatsnew/2.3.rst:1883 msgid "" "The :c:macro:`DL_EXPORT` and :c:macro:`DL_IMPORT` macros are now deprecated. " "Initialization functions for Python extension modules should now be declared " @@ -5991,7 +5948,7 @@ msgid "" "generally use the :c:macro:`PyAPI_FUNC` and :c:macro:`PyAPI_DATA` macros." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1888 +#: whatsnew/2.3.rst:1888 msgid "" "The interpreter can be compiled without any docstrings for the built-in " "functions and modules by supplying :option:`--without-doc-strings` to the :" @@ -6001,7 +5958,7 @@ msgid "" msgstr "" # f3fa68dce59440aca87a07e65bb78d38 -#: ../src/Doc/whatsnew/2.3.rst:1894 +#: whatsnew/2.3.rst:1894 msgid "" "The :c:func:`PyArg_NoArgs` macro is now deprecated, and code that uses it " "should be changed. For Python 2.2 and later, the method definition table " @@ -6013,7 +5970,7 @@ msgid "" msgstr "" # 396f9ba7c2694dec9fab3ff0c42425df -#: ../src/Doc/whatsnew/2.3.rst:1901 +#: whatsnew/2.3.rst:1901 msgid "" ":c:func:`PyArg_ParseTuple` accepts new format characters for various sizes " "of unsigned integers: ``B`` for :c:type:`unsigned char`, ``H`` for :c:type:" @@ -6022,13 +5979,13 @@ msgid "" msgstr "" # b600648f9bdc4af6941215378c6be113 -#: ../src/Doc/whatsnew/2.3.rst:1906 +#: whatsnew/2.3.rst:1906 msgid "" "A new function, :c:func:`PyObject_DelItemString(mapping, char \\*key)` was " "added as shorthand for ``PyObject_DelItem(mapping, PyString_New(key))``." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1909 +#: whatsnew/2.3.rst:1909 msgid "" "File objects now manage their internal string buffer differently, increasing " "it exponentially when needed. This results in the benchmark tests in :file:" @@ -6037,20 +5994,20 @@ msgid "" msgstr "" # 2c50550c666f40899a93278d01910405 -#: ../src/Doc/whatsnew/2.3.rst:1914 +#: whatsnew/2.3.rst:1914 msgid "" "It's now possible to define class and static methods for a C extension type " "by setting either the :const:`METH_CLASS` or :const:`METH_STATIC` flags in a " "method's :c:type:`PyMethodDef` structure." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1918 +#: whatsnew/2.3.rst:1918 msgid "" "Python now includes a copy of the Expat XML parser's source code, removing " "any dependence on a system version or local installation of Expat." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1921 +#: whatsnew/2.3.rst:1921 msgid "" "If you dynamically allocate type objects in your extension, you should be " "aware of a change in the rules relating to the :attr:`__module__` and :attr:" @@ -6061,12 +6018,11 @@ msgid "" "the source." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1932 ../src/Doc/whatsnew/2.4.rst:1499 -#: ../src/Doc/whatsnew/2.5.rst:2207 +#: whatsnew/2.3.rst:1932 whatsnew/2.4.rst:1499 whatsnew/2.5.rst:2207 msgid "Port-Specific Changes" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1934 +#: whatsnew/2.3.rst:1934 msgid "" "Support for a port to IBM's OS/2 using the EMX runtime environment was " "merged into the main Python source tree. EMX is a POSIX emulation layer " @@ -6078,7 +6034,7 @@ msgid "" "the integration of the EMX port into CVS. (Contributed by Andrew MacIntyre.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1943 +#: whatsnew/2.3.rst:1943 msgid "" "On MacOS, most toolbox modules have been weaklinked to improve backward " "compatibility. This means that modules will no longer fail to load if a " @@ -6086,20 +6042,20 @@ msgid "" "missing routine will raise an exception. (Contributed by Jack Jansen.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1948 +#: whatsnew/2.3.rst:1948 msgid "" "The RPM spec files, found in the :file:`Misc/RPM/` directory in the Python " "source distribution, were updated for 2.3. (Contributed by Sean " "Reifschneider.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1951 +#: whatsnew/2.3.rst:1951 msgid "" "Other new platforms now supported by Python include AtheOS (http://www." "atheos.cx/), GNU/Hurd, and OpenVMS." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1962 +#: whatsnew/2.3.rst:1962 msgid "" "As usual, there were a bunch of other improvements and bugfixes scattered " "throughout the source tree. A search through the CVS change logs finds " @@ -6107,7 +6063,7 @@ msgid "" "2.3. Both figures are likely to be underestimates." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1969 +#: whatsnew/2.3.rst:1969 msgid "" "If the :envvar:`PYTHONINSPECT` environment variable is set, the Python " "interpreter will enter the interactive prompt after running a Python " @@ -6116,7 +6072,7 @@ msgid "" "can be set by the Python program as part of its execution." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1975 +#: whatsnew/2.3.rst:1975 msgid "" "The :file:`regrtest.py` script now provides a way to allow \"all resources " "except *foo*.\" A resource name passed to the :option:`-u` option can now " @@ -6125,13 +6081,13 @@ msgid "" "all resources except ``bsddb``." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1981 +#: whatsnew/2.3.rst:1981 msgid "" "The tools used to build the documentation now work under Cygwin as well as " "Unix." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1984 +#: whatsnew/2.3.rst:1984 msgid "" "The ``SET_LINENO`` opcode has been removed. Back in the mists of time, this " "opcode was needed to produce line numbers in tracebacks and support trace " @@ -6142,13 +6098,13 @@ msgid "" "``SET_LINENO`` entirely." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1992 +#: whatsnew/2.3.rst:1992 msgid "" "It would be difficult to detect any resulting difference from Python code, " "apart from a slight speed up when Python is run without :option:`-O`." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:1995 +#: whatsnew/2.3.rst:1995 msgid "" "C extensions that access the :attr:`f_lineno` field of frame objects should " "instead call ``PyCode_Addr2Line(f->f_code, f->f_lasti)``. This will have the " @@ -6156,7 +6112,7 @@ msgid "" "earlier versions of Python." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2000 +#: whatsnew/2.3.rst:2000 msgid "" "A nifty new feature is that trace functions can now assign to the :attr:" "`f_lineno` attribute of frame objects, changing the line that will be " @@ -6164,45 +6120,44 @@ msgid "" "taking advantage of this new feature. (Implemented by Richie Hindle.)" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2009 +#: whatsnew/2.3.rst:2009 #, fuzzy msgid "Porting to Python 2.3" msgstr "Portage vers Python 3.2" -#: ../src/Doc/whatsnew/2.3.rst:2011 ../src/Doc/whatsnew/2.4.rst:1510 -#: ../src/Doc/whatsnew/2.5.rst:2229 +#: whatsnew/2.3.rst:2011 whatsnew/2.4.rst:1510 whatsnew/2.5.rst:2229 msgid "" "This section lists previously described changes that may require changes to " "your code:" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2014 +#: whatsnew/2.3.rst:2014 msgid "" ":keyword:`yield` is now always a keyword; if it's used as a variable name in " "your code, a different name must be chosen." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2017 +#: whatsnew/2.3.rst:2017 msgid "" "For strings *X* and *Y*, ``X in Y`` now works if *X* is more than one " "character long." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2020 +#: whatsnew/2.3.rst:2020 msgid "" "The :func:`int` type constructor will now return a long integer instead of " "raising an :exc:`OverflowError` when a string or floating-point number is " "too large to fit into an integer." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2024 +#: whatsnew/2.3.rst:2024 msgid "" "If you have Unicode strings that contain 8-bit characters, you must declare " "the file's encoding (UTF-8, Latin-1, or whatever) by adding a comment to the " "top of the file. See section :ref:`section-encodings` for more information." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2028 +#: whatsnew/2.3.rst:2028 msgid "" "Calling Tcl methods through :mod:`_tkinter` no longer returns only strings. " "Instead, if Tcl returns other objects those objects are converted to their " @@ -6210,14 +6165,14 @@ msgid "" "Tcl_Obj` object if no Python equivalent exists." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2033 +#: whatsnew/2.3.rst:2033 msgid "" "Large octal and hex literals such as ``0xffffffff`` now trigger a :exc:" "`FutureWarning`. Currently they're stored as 32-bit numbers and result in a " "negative value, but in Python 2.4 they'll become positive long integers." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2037 +#: whatsnew/2.3.rst:2037 msgid "" "There are a few ways to fix this warning. If you really need a positive " "number, just add an ``L`` to the end of the literal. If you're trying to " @@ -6227,11 +6182,11 @@ msgid "" "top bit (bit 31), you could write ``0xffffffffL &~(1L<<31)``." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2044 +#: whatsnew/2.3.rst:2044 msgid "You can no longer disable assertions by assigning to ``__debug__``." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2046 +#: whatsnew/2.3.rst:2046 msgid "" "The Distutils :func:`setup` function has gained various new keyword " "arguments such as *depends*. Old versions of the Distutils will abort if " @@ -6240,19 +6195,19 @@ msgid "" "uses the new keywords with a version of the Distutils that supports them::" msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2059 +#: whatsnew/2.3.rst:2059 msgid "" "Using ``None`` as a variable name will now result in a :exc:`SyntaxWarning` " "warning." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2062 +#: whatsnew/2.3.rst:2062 msgid "" "Names of extension types defined by the modules included with Python now " "contain the module and a ``'.'`` in front of the type name." msgstr "" -#: ../src/Doc/whatsnew/2.3.rst:2073 +#: whatsnew/2.3.rst:2073 msgid "" "The author would like to thank the following people for offering " "suggestions, corrections and assistance with various drafts of this article: " @@ -6264,18 +6219,18 @@ msgid "" "Schemenauer, Roman Suzi, Jason Tishler, Just van Rossum." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:3 +#: whatsnew/2.4.rst:3 #, fuzzy msgid "What's New in Python 2.4" msgstr "Nouveautés de Python 2.0" -#: ../src/Doc/whatsnew/2.4.rst:14 +#: whatsnew/2.4.rst:14 msgid "" "This article explains the new features in Python 2.4.1, released on March " "30, 2005." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:17 +#: whatsnew/2.4.rst:17 msgid "" "Python 2.4 is a medium-sized release. It doesn't introduce as many changes " "as the radical Python 2.2, but introduces more features than the " @@ -6284,14 +6239,14 @@ msgid "" "standard library." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:22 +#: whatsnew/2.4.rst:22 msgid "" "According to the CVS change logs, there were 481 patches applied and 502 " "bugs fixed between Python 2.3 and 2.4. Both figures are likely to be " "underestimates." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:25 +#: whatsnew/2.4.rst:25 msgid "" "This article doesn't attempt to provide a complete specification of every " "single new feature, but instead provides a brief introduction to each " @@ -6301,11 +6256,11 @@ msgid "" "explanations of the implementation and design rationale." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:36 +#: whatsnew/2.4.rst:36 msgid "PEP 218: Built-In Set Objects" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:38 +#: whatsnew/2.4.rst:38 msgid "" "Python 2.3 introduced the :mod:`sets` module. C implementations of set data " "types have now been added to the Python core as two new built-in types, :" @@ -6315,27 +6270,27 @@ msgid "" "differences, and symmetric differences. ::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:71 +#: whatsnew/2.4.rst:71 msgid "" "The :func:`frozenset` type is an immutable version of :func:`set`. Since it " "is immutable and hashable, it may be used as a dictionary key or as a member " "of another set." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:75 +#: whatsnew/2.4.rst:75 msgid "" "The :mod:`sets` module remains in the standard library, and may be useful if " "you wish to subclass the :class:`Set` or :class:`ImmutableSet` classes. " "There are currently no plans to deprecate the module." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:83 +#: whatsnew/2.4.rst:83 msgid "" "Originally proposed by Greg Wilson and ultimately implemented by Raymond " "Hettinger." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:92 +#: whatsnew/2.4.rst:92 msgid "" "The lengthy transition process for this PEP, begun in Python 2.2, takes " "another step forward in Python 2.4. In 2.3, certain integer operations that " @@ -6345,7 +6300,7 @@ msgid "" "warning and instead produce a different result that's usually a long integer." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:99 +#: whatsnew/2.4.rst:99 msgid "" "The problematic expressions are primarily left shifts and lengthy " "hexadecimal and octal constants. For example, ``2 << 32`` results in a " @@ -6353,17 +6308,17 @@ msgid "" "expression now returns the correct answer, 8589934592." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:108 +#: whatsnew/2.4.rst:108 msgid "" "Original PEP written by Moshe Zadka and GvR. The changes for 2.4 were " "implemented by Kalle Svensson." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:115 +#: whatsnew/2.4.rst:115 msgid "PEP 289: Generator Expressions" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:117 +#: whatsnew/2.4.rst:117 msgid "" "The iterator feature introduced in Python 2.2 and the :mod:`itertools` " "module make it easier to write programs that loop through large data sets " @@ -6375,25 +6330,25 @@ msgid "" "natural to write something like::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:129 +#: whatsnew/2.4.rst:129 msgid "instead of ::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:136 +#: whatsnew/2.4.rst:136 msgid "" "The first form is more concise and perhaps more readable, but if you're " "dealing with a large number of link objects you'd have to write the second " "form to avoid having all link objects in memory at the same time." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:140 +#: whatsnew/2.4.rst:140 msgid "" "Generator expressions work similarly to list comprehensions but don't " "materialize the entire list; instead they create a generator that will " "return elements one by one. The above example could be written as::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:148 +#: whatsnew/2.4.rst:148 msgid "" "Generator expressions always have to be written inside parentheses, as in " "the above example. The parentheses signalling a function call also count, " @@ -6401,7 +6356,7 @@ msgid "" "function you could write::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:155 +#: whatsnew/2.4.rst:155 msgid "" "Generator expressions differ from list comprehensions in various small ways. " "Most notably, the loop variable (*obj* in the above example) is not " @@ -6411,33 +6366,32 @@ msgid "" "respect." msgstr "" -# ae39302fad754779bdbd30cbf558f66d -#: ../src/Doc/whatsnew/2.4.rst:164 -msgid ":pep:`289` - Generator Expressions" +#: whatsnew/2.4.rst:165 +msgid "PEP 289 - Generator Expressions" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:165 +#: whatsnew/2.4.rst:165 msgid "" "Proposed by Raymond Hettinger and implemented by Jiwon Seo with early " "efforts steered by Hye-Shik Chang." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:172 +#: whatsnew/2.4.rst:172 msgid "PEP 292: Simpler String Substitutions" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:174 +#: whatsnew/2.4.rst:174 msgid "" "Some new classes in the standard library provide an alternative mechanism " "for substituting variables into strings; this style of substitution may be " "better for applications where untrained users need to edit templates." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:178 +#: whatsnew/2.4.rst:178 msgid "The usual way of substituting variables by name is the ``%`` operator::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:183 +#: whatsnew/2.4.rst:183 msgid "" "When writing the template string, it can be easy to forget the ``i`` or " "``s`` after the closing parenthesis. This isn't a big problem if the " @@ -6450,33 +6404,32 @@ msgid "" "feedback to them." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:192 +#: whatsnew/2.4.rst:192 msgid "" "PEP 292 adds a :class:`Template` class to the :mod:`string` module that uses " "``$`` to indicate a substitution::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:200 +#: whatsnew/2.4.rst:200 msgid "" "If a key is missing from the dictionary, the :meth:`substitute` method will " "raise a :exc:`KeyError`. There's also a :meth:`safe_substitute` method that " "ignores missing keys::" msgstr "" -# ab9e463b5d424e519905eb5d84560906 -#: ../src/Doc/whatsnew/2.4.rst:210 -msgid ":pep:`292` - Simpler String Substitutions" +#: whatsnew/2.4.rst:211 +msgid "PEP 292 - Simpler String Substitutions" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:212 +#: whatsnew/2.4.rst:212 msgid "Written and implemented by Barry Warsaw." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:218 +#: whatsnew/2.4.rst:218 msgid "PEP 318: Decorators for Functions and Methods" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:220 +#: whatsnew/2.4.rst:220 msgid "" "Python 2.2 extended Python's object model by adding static methods and class " "methods, but it didn't extend Python's syntax to provide any new way of " @@ -6486,13 +6439,13 @@ msgid "" "function as a method of the new type. Your code would look like this::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:233 +#: whatsnew/2.4.rst:233 msgid "" "If the method was very long, it would be easy to miss or forget the :func:" "`classmethod` invocation after the function body." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:236 +#: whatsnew/2.4.rst:236 msgid "" "The intention was always to add some syntax to make such definitions more " "readable, but at the time of 2.2's release a good syntax was not obvious. " @@ -6501,7 +6454,7 @@ msgid "" "need." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:241 +#: whatsnew/2.4.rst:241 msgid "" "The new feature is called \"function decorators\". The name comes from the " "idea that :func:`classmethod`, :func:`staticmethod`, and friends are storing " @@ -6509,23 +6462,23 @@ msgid "" "with more details." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:246 +#: whatsnew/2.4.rst:246 msgid "" "The notation borrows from Java and uses the ``'@'`` character as an " "indicator. Using the new syntax, the example above would be written::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:256 +#: whatsnew/2.4.rst:256 msgid "" "The ``@classmethod`` is shorthand for the ``meth=classmethod(meth)`` " "assignment. More generally, if you have the following::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:265 +#: whatsnew/2.4.rst:265 msgid "It's equivalent to the following pre-decorator code::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:270 +#: whatsnew/2.4.rst:270 msgid "" "Decorators must come on the line before a function definition, one decorator " "per line, and can't be on the same line as the def statement, meaning that " @@ -6534,7 +6487,7 @@ msgid "" "definitions." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:275 +#: whatsnew/2.4.rst:275 msgid "" "A decorator is just a function that takes the function to be decorated as an " "argument and returns either the same function or some new object. The " @@ -6544,19 +6497,19 @@ msgid "" "the function object::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:295 +#: whatsnew/2.4.rst:295 msgid "" "As a slightly more realistic example, the following decorator checks that " "the supplied argument is an integer::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:313 +#: whatsnew/2.4.rst:313 msgid "" "An example in :pep:`318` contains a fancier version of this idea that lets " "you both specify the required type and check the returned type." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:316 +#: whatsnew/2.4.rst:316 msgid "" "Decorator functions can take arguments. If arguments are supplied, your " "decorator function is called with only those arguments and must return a new " @@ -6565,12 +6518,12 @@ msgid "" "becomes::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:325 +#: whatsnew/2.4.rst:325 msgid "" "Getting this right can be slightly brain-bending, but it's not too difficult." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:327 +#: whatsnew/2.4.rst:327 msgid "" "A small related change makes the :attr:`func_name` attribute of functions " "writable. This attribute is used to display function names in tracebacks, " @@ -6578,12 +6531,11 @@ msgid "" "and returned." msgstr "" -# 2c51a80040a941579e0355fb8becc327 -#: ../src/Doc/whatsnew/2.4.rst:337 -msgid ":pep:`318` - Decorators for Functions, Methods and Classes" +#: whatsnew/2.4.rst:338 +msgid "PEP 318 - Decorators for Functions, Methods and Classes" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:336 +#: whatsnew/2.4.rst:336 msgid "" "Written by Kevin D. Smith, Jim Jewett, and Skip Montanaro. Several people " "wrote patches implementing function decorators, but the one that was " @@ -6591,52 +6543,51 @@ msgid "" msgstr "" # e8f01f28d2db4e48ae8d613d93ade250 -#: ../src/Doc/whatsnew/2.4.rst:339 +#: whatsnew/2.4.rst:340 msgid "https://www.python.org/moin/PythonDecoratorLibrary" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:341 +#: whatsnew/2.4.rst:341 msgid "This Wiki page contains several examples of decorators." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:347 +#: whatsnew/2.4.rst:347 msgid "PEP 322: Reverse Iteration" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:349 +#: whatsnew/2.4.rst:349 msgid "" "A new built-in function, :func:`reversed(seq)`, takes a sequence and returns " "an iterator that loops over the elements of the sequence in reverse " "order. ::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:359 +#: whatsnew/2.4.rst:359 msgid "" "Compared to extended slicing, such as ``range(1,4)[::-1]``, :func:`reversed` " "is easier to read, runs faster, and uses substantially less memory." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:362 +#: whatsnew/2.4.rst:362 msgid "" "Note that :func:`reversed` only accepts sequences, not arbitrary iterators. " "If you want to reverse an iterator, first convert it to a list with :func:" "`list`. ::" msgstr "" -# 4025443dbc81438d8b03171fd3cf7890 -#: ../src/Doc/whatsnew/2.4.rst:375 -msgid ":pep:`322` - Reverse Iteration" +#: whatsnew/2.4.rst:376 +msgid "PEP 322 - Reverse Iteration" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:377 +#: whatsnew/2.4.rst:377 msgid "Written and implemented by Raymond Hettinger." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:383 +#: whatsnew/2.4.rst:383 msgid "PEP 324: New subprocess Module" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:385 +#: whatsnew/2.4.rst:385 msgid "" "The standard library provides a number of ways to execute a subprocess, " "offering different features and different levels of complexity. :func:`os." @@ -6648,14 +6599,14 @@ msgid "" "providing a unified interface that offers all the features you might need." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:394 +#: whatsnew/2.4.rst:394 msgid "" "Instead of :mod:`popen2`'s collection of classes, :mod:`subprocess` contains " "a single class called :class:`Popen` whose constructor supports a number of " "different keyword arguments. ::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:404 +#: whatsnew/2.4.rst:404 msgid "" "*args* is commonly a sequence of strings that will be the arguments to the " "program executed as the subprocess. (If the *shell* argument is true, " @@ -6663,7 +6614,7 @@ msgid "" "interpretation, just as :func:`os.system` does.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:409 +#: whatsnew/2.4.rst:409 msgid "" "*stdin*, *stdout*, and *stderr* specify what the subprocess's input, output, " "and error streams will be. You can provide a file object or a file " @@ -6671,39 +6622,39 @@ msgid "" "between the subprocess and the parent." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:417 +#: whatsnew/2.4.rst:417 msgid "The constructor has a number of handy options:" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:419 +#: whatsnew/2.4.rst:419 msgid "" "*close_fds* requests that all file descriptors be closed before running the " "subprocess." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:422 +#: whatsnew/2.4.rst:422 msgid "" "*cwd* specifies the working directory in which the subprocess will be " "executed (defaulting to whatever the parent's working directory is)." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:425 +#: whatsnew/2.4.rst:425 msgid "*env* is a dictionary specifying environment variables." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:427 +#: whatsnew/2.4.rst:427 msgid "" "*preexec_fn* is a function that gets called before the child is started." msgstr "" # 459672945e8e4e059eb082756d8171a4 -#: ../src/Doc/whatsnew/2.4.rst:429 +#: whatsnew/2.4.rst:429 msgid "" "*universal_newlines* opens the child's input and output using Python's :term:" "`universal newlines` feature." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:432 +#: whatsnew/2.4.rst:432 msgid "" "Once you've created the :class:`Popen` instance, you can call its :meth:" "`wait` method to pause until the subprocess has exited, :meth:`poll` to " @@ -6714,7 +6665,7 @@ msgid "" "stderr_data)``." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:439 +#: whatsnew/2.4.rst:439 msgid "" ":func:`call` is a shortcut that passes its arguments along to the :class:" "`Popen` constructor, waits for the command to complete, and returns the " @@ -6722,37 +6673,36 @@ msgid "" "system`::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:451 +#: whatsnew/2.4.rst:451 msgid "" "The command is invoked without use of the shell. If you really do want to " "use the shell, you can add ``shell=True`` as a keyword argument and provide " "a string instead of a sequence::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:457 +#: whatsnew/2.4.rst:457 msgid "" "The PEP takes various examples of shell and Python code and shows how they'd " "be translated into Python code that uses :mod:`subprocess`. Reading this " "section of the PEP is highly recommended." msgstr "" -# 8fad50f2c1a54a05b762fc849151b13f -#: ../src/Doc/whatsnew/2.4.rst:464 -msgid ":pep:`324` - subprocess - New process module" +#: whatsnew/2.4.rst:465 +msgid "PEP 324 - subprocess - New process module" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:465 +#: whatsnew/2.4.rst:465 msgid "" "Written and implemented by Peter Åstrand, with assistance from Fredrik Lundh " "and others." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:472 +#: whatsnew/2.4.rst:472 msgid "PEP 327: Decimal Data Type" msgstr "" # d2c30993d59c4cc6b854b94d665b7dc7 -#: ../src/Doc/whatsnew/2.4.rst:474 +#: whatsnew/2.4.rst:474 msgid "" "Python has always supported floating-point (FP) numbers, based on the " "underlying C :c:type:`double` type, as a data type. However, while most " @@ -6762,34 +6712,34 @@ msgid "" "these fractions accurately, up to a user-specified precision limit." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:483 +#: whatsnew/2.4.rst:483 msgid "Why is Decimal needed?" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:485 +#: whatsnew/2.4.rst:485 msgid "" "The limitations arise from the representation used for floating-point " "numbers. FP numbers are made up of three components:" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:488 +#: whatsnew/2.4.rst:488 msgid "The sign, which is positive or negative." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:490 +#: whatsnew/2.4.rst:490 msgid "" "The mantissa, which is a single-digit binary number followed by a " "fractional part. For example, ``1.01`` in base-2 notation is ``1 + 0/2 + " "1/4``, or 1.25 in decimal notation." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:494 +#: whatsnew/2.4.rst:494 msgid "" "The exponent, which tells where the decimal point is located in the number " "represented." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:497 +#: whatsnew/2.4.rst:497 msgid "" "For example, the number 1.25 has positive sign, a mantissa value of 1.01 (in " "binary), and an exponent of 0 (the decimal point doesn't need to be " @@ -6799,7 +6749,7 @@ msgid "" msgstr "" # 05d6091fe53448f79a8be60eb9dcadb0 -#: ../src/Doc/whatsnew/2.4.rst:503 +#: whatsnew/2.4.rst:503 msgid "" "Modern systems usually provide floating-point support that conforms to a " "standard called IEEE 754. C's :c:type:`double` type is usually implemented " @@ -6814,11 +6764,11 @@ msgid "" "after 52 digits, so the representation is slightly inaccurate." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:515 +#: whatsnew/2.4.rst:515 msgid "Sometimes you can see this inaccuracy when the number is printed::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:520 +#: whatsnew/2.4.rst:520 msgid "" "The inaccuracy isn't always visible when you print the number because the FP-" "to- decimal-string conversion is provided by the C library, and most C " @@ -6827,7 +6777,7 @@ msgid "" "the error." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:525 +#: whatsnew/2.4.rst:525 msgid "" "For many applications this doesn't matter. If I'm plotting points and " "displaying them on my monitor, the difference between 1.1 and " @@ -6838,15 +6788,15 @@ msgid "" "own custom arithmetic routines." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:533 +#: whatsnew/2.4.rst:533 msgid "Hence, the :class:`Decimal` type was created." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:537 +#: whatsnew/2.4.rst:537 msgid "The :class:`Decimal` type" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:539 +#: whatsnew/2.4.rst:539 msgid "" "A new module, :mod:`decimal`, was added to Python's standard library. It " "contains two classes, :class:`Decimal` and :class:`Context`. :class:" @@ -6855,7 +6805,7 @@ msgid "" "mode." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:544 +#: whatsnew/2.4.rst:544 msgid "" ":class:`Decimal` instances are immutable, like regular Python integers and " "FP numbers; once it's been created, you can't change the value an instance " @@ -6863,19 +6813,19 @@ msgid "" "strings::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:555 +#: whatsnew/2.4.rst:555 msgid "" "You can also provide tuples containing the sign, the mantissa represented " "as a tuple of decimal digits, and the exponent::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:561 +#: whatsnew/2.4.rst:561 msgid "" "Cautionary note: the sign bit is a Boolean value, so 0 is positive and 1 is " "negative." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:564 +#: whatsnew/2.4.rst:564 msgid "" "Converting from floating-point numbers poses a bit of a problem: should the " "FP number representing 1.1 turn into the decimal number for exactly 1.1, or " @@ -6885,20 +6835,20 @@ msgid "" "and pass the string to the :class:`Decimal` constructor::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:577 +#: whatsnew/2.4.rst:577 msgid "" "Once you have :class:`Decimal` instances, you can perform the usual " "mathematical operations on them. One limitation: exponentiation requires an " "integer exponent::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:598 +#: whatsnew/2.4.rst:598 msgid "" "You can combine :class:`Decimal` instances with integers, but not with " "floating- point numbers::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:609 +#: whatsnew/2.4.rst:609 msgid "" ":class:`Decimal` numbers can be used with the :mod:`math` and :mod:`cmath` " "modules, but note that they'll be immediately converted to floating-point " @@ -6907,35 +6857,35 @@ msgid "" "number and not a :class:`Decimal`. ::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:622 +#: whatsnew/2.4.rst:622 msgid "" ":class:`Decimal` instances have a :meth:`sqrt` method that returns a :class:" "`Decimal`, but if you need other things such as trigonometric functions " "you'll have to implement them. ::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:631 +#: whatsnew/2.4.rst:631 msgid "The :class:`Context` type" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:633 +#: whatsnew/2.4.rst:633 msgid "" "Instances of the :class:`Context` class encapsulate several settings for " "decimal operations:" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:636 +#: whatsnew/2.4.rst:636 msgid ":attr:`prec` is the precision, the number of decimal places." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:638 +#: whatsnew/2.4.rst:638 msgid "" ":attr:`rounding` specifies the rounding mode. The :mod:`decimal` module has " "constants for the various possibilities: :const:`ROUND_DOWN`, :const:" "`ROUND_CEILING`, :const:`ROUND_HALF_EVEN`, and various others." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:642 +#: whatsnew/2.4.rst:642 msgid "" ":attr:`traps` is a dictionary specifying what happens on encountering " "certain error conditions: either an exception is raised or a value is " @@ -6943,7 +6893,7 @@ msgid "" "precision, and overflow." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:647 +#: whatsnew/2.4.rst:647 msgid "" "There's a thread-local default context available by calling :func:" "`getcontext`; you can change the properties of this context to alter the " @@ -6951,53 +6901,52 @@ msgid "" "the effect of changing the precision of the default context::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:660 +#: whatsnew/2.4.rst:660 msgid "" "The default action for error conditions is selectable; the module can either " "return a special value such as infinity or not-a-number, or exceptions can " "be raised::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:673 +#: whatsnew/2.4.rst:673 msgid "" "The :class:`Context` instance also has various methods for formatting " "numbers such as :meth:`to_eng_string` and :meth:`to_sci_string`." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:676 +#: whatsnew/2.4.rst:676 msgid "" "For more information, see the documentation for the :mod:`decimal` module, " "which includes a quick-start tutorial and a reference." msgstr "" -# 299e5b71e1ca43eb89bba06fb1fe72f2 -#: ../src/Doc/whatsnew/2.4.rst:683 -msgid ":pep:`327` - Decimal Data Type" +#: whatsnew/2.4.rst:684 +msgid "PEP 327 - Decimal Data Type" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:683 +#: whatsnew/2.4.rst:683 msgid "" "Written by Facundo Batista and implemented by Facundo Batista, Eric Price, " "Raymond Hettinger, Aahz, and Tim Peters." msgstr "" # 733c07fc0c224231abc5d275cee01005 -#: ../src/Doc/whatsnew/2.4.rst:687 +#: whatsnew/2.4.rst:688 msgid "http://www.lahey.com/float.htm" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:687 +#: whatsnew/2.4.rst:687 msgid "" "The article uses Fortran code to illustrate many of the problems that " "floating- point inaccuracy can cause." msgstr "" # 7d5e0dd8593f47d195990ecfcd653941 -#: ../src/Doc/whatsnew/2.4.rst:691 +#: whatsnew/2.4.rst:692 msgid "http://www2.hursley.ibm.com/decimal/" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:691 +#: whatsnew/2.4.rst:691 msgid "" "A description of a decimal-based representation. This representation is " "being proposed as a standard, and underlies the new Python decimal type. " @@ -7005,11 +6954,11 @@ msgid "" "language." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:699 +#: whatsnew/2.4.rst:699 msgid "PEP 328: Multi-line Imports" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:701 +#: whatsnew/2.4.rst:701 msgid "" "One language change is a small syntactic tweak aimed at making it easier to " "import many names from a module. In a ``from module import names`` " @@ -7018,14 +6967,14 @@ msgid "" "module, or you can use backslashes to escape the line endings like this::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:712 +#: whatsnew/2.4.rst:712 msgid "" "The syntactic change in Python 2.4 simply allows putting the names within " "parentheses. Python ignores newlines within a parenthesized expression, so " "the backslashes are no longer needed::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:721 +#: whatsnew/2.4.rst:721 msgid "" "The PEP also proposes that all :keyword:`import` statements be absolute " "imports, with a leading ``.`` character to indicate a relative import. This " @@ -7033,22 +6982,20 @@ msgid "" "Python 2.5." msgstr "" -# 8ae0c81ef6a14a4a8ec0613142da5276 -# d0822458723f4803bc5eedd5826af4e7 -#: ../src/Doc/whatsnew/2.4.rst:727 ../src/Doc/whatsnew/2.5.rst:330 -msgid ":pep:`328` - Imports: Multi-Line and Absolute/Relative" +#: whatsnew/2.4.rst:728 whatsnew/2.5.rst:331 +msgid "PEP 328 - Imports: Multi-Line and Absolute/Relative" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:729 +#: whatsnew/2.4.rst:729 msgid "Written by Aahz. Multi-line imports were implemented by Dima Dorfman." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:735 +#: whatsnew/2.4.rst:735 msgid "PEP 331: Locale-Independent Float/String Conversions" msgstr "" # 85a83f3f26c9478bbfa7ed28c42aef20 -#: ../src/Doc/whatsnew/2.4.rst:737 +#: whatsnew/2.4.rst:737 msgid "" "The :mod:`locale` modules lets Python software select various conversions " "and display conventions that are localized to a particular country or " @@ -7058,7 +7005,7 @@ msgid "" "code was using the C library's :c:func:`atof` function." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:744 +#: whatsnew/2.4.rst:744 msgid "" "Not setting the numeric locale caused trouble for extensions that used " "third- party C libraries, however, because they wouldn't have the correct " @@ -7066,27 +7013,27 @@ msgid "" "weren't displaying numbers in the current locale." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:749 +#: whatsnew/2.4.rst:749 msgid "" "The solution described in the PEP is to add three new functions to the " "Python API that perform ASCII-only conversions, ignoring the locale setting:" msgstr "" # 13083cd0740e4b6bbec54b46ce67209b -#: ../src/Doc/whatsnew/2.4.rst:752 +#: whatsnew/2.4.rst:752 msgid "" ":c:func:`PyOS_ascii_strtod(str, ptr)` and :c:func:`PyOS_ascii_atof(str, " "ptr)` both convert a string to a C :c:type:`double`." msgstr "" # 871980f609ad4f70b4db062dd34a7a55 -#: ../src/Doc/whatsnew/2.4.rst:755 +#: whatsnew/2.4.rst:755 msgid "" ":c:func:`PyOS_ascii_formatd(buffer, buf_len, format, d)` converts a :c:type:" "`double` to an ASCII string." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:758 +#: whatsnew/2.4.rst:758 msgid "" "The code for these functions came from the GLib library (http://library." "gnome.org/devel/glib/stable/), whose developers kindly relicensed the " @@ -7095,76 +7042,75 @@ msgid "" "such as GTK+ produce the correct results." msgstr "" -# 2cd9f7b3734f479692f864d11fa6d2a0 -#: ../src/Doc/whatsnew/2.4.rst:766 -msgid ":pep:`331` - Locale-Independent Float/String Conversions" +#: whatsnew/2.4.rst:767 +msgid "PEP 331 - Locale-Independent Float/String Conversions" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:768 +#: whatsnew/2.4.rst:768 msgid "Written by Christian R. Reis, and implemented by Gustavo Carneiro." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:776 +#: whatsnew/2.4.rst:776 msgid "" "Here are all of the changes that Python 2.4 makes to the core Python " "language." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:778 +#: whatsnew/2.4.rst:778 msgid "Decorators for functions and methods were added (:pep:`318`)." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:780 +#: whatsnew/2.4.rst:780 msgid "" "Built-in :func:`set` and :func:`frozenset` types were added (:pep:`218`). " "Other new built-ins include the :func:`reversed(seq)` function (:pep:`322`)." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:783 +#: whatsnew/2.4.rst:783 msgid "Generator expressions were added (:pep:`289`)." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:785 +#: whatsnew/2.4.rst:785 msgid "" "Certain numeric expressions no longer return values restricted to 32 or 64 " "bits (:pep:`237`)." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:788 +#: whatsnew/2.4.rst:788 msgid "" "You can now put parentheses around the list of names in a ``from module " "import names`` statement (:pep:`328`)." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:791 +#: whatsnew/2.4.rst:791 msgid "" "The :meth:`dict.update` method now accepts the same argument forms as the :" "class:`dict` constructor. This includes any mapping, any iterable of key/" "value pairs, and keyword arguments. (Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:795 +#: whatsnew/2.4.rst:795 msgid "" "The string methods :meth:`ljust`, :meth:`rjust`, and :meth:`center` now take " "an optional argument for specifying a fill character other than a space. " "(Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:799 +#: whatsnew/2.4.rst:799 msgid "" "Strings also gained an :meth:`rsplit` method that works like the :meth:" "`split` method but splits from the end of the string. (Contributed by Sean " "Reifschneider.) ::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:808 +#: whatsnew/2.4.rst:808 msgid "" "Three keyword parameters, *cmp*, *key*, and *reverse*, were added to the :" "meth:`sort` method of lists. These parameters make some common usages of :" "meth:`sort` simpler. All of these parameters are optional." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:812 +#: whatsnew/2.4.rst:812 msgid "" "For the *cmp* parameter, the value should be a comparison function that " "takes two parameters and returns -1, 0, or +1 depending on how the " @@ -7173,14 +7119,14 @@ msgid "" "`sort`." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:817 +#: whatsnew/2.4.rst:817 msgid "" "*key* should be a single-parameter function that takes a list element and " "returns a comparison key for the element. The list is then sorted using the " "comparison keys. The following example sorts a list case-insensitively::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:834 +#: whatsnew/2.4.rst:834 msgid "" "The last example, which uses the *cmp* parameter, is the old way to perform " "a case-insensitive sort. It works but is slower than using a *key* " @@ -7189,7 +7135,7 @@ msgid "" "*key* saves on invocations of the :meth:`lower` method." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:840 +#: whatsnew/2.4.rst:840 msgid "" "For simple key functions and comparison functions, it is often possible to " "avoid a :keyword:`lambda` expression by using an unbound method instead. " @@ -7197,14 +7143,14 @@ msgid "" msgstr "" # bec815d9eb0c4495ad414f09eb42fa3e -#: ../src/Doc/whatsnew/2.4.rst:848 +#: whatsnew/2.4.rst:848 msgid "" "Finally, the *reverse* parameter takes a Boolean value. If the value is " "true, the list will be sorted into reverse order. Instead of ``L.sort(); L." "reverse()``, you can now write ``L.sort(reverse=True)``." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:852 +#: whatsnew/2.4.rst:852 msgid "" "The results of sorting are now guaranteed to be stable. This means that two " "entries with equal keys will be returned in the same order as they were " @@ -7213,36 +7159,36 @@ msgid "" "age are in name-sorted order." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:858 +#: whatsnew/2.4.rst:858 msgid "(All changes to :meth:`sort` contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:860 +#: whatsnew/2.4.rst:860 msgid "" "There is a new built-in function :func:`sorted(iterable)` that works like " "the in-place :meth:`list.sort` method but can be used in expressions. The " "differences are:" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:864 +#: whatsnew/2.4.rst:864 msgid "the input may be any iterable;" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:866 +#: whatsnew/2.4.rst:866 msgid "a newly formed copy is sorted, leaving the original intact; and" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:868 +#: whatsnew/2.4.rst:868 msgid "the expression returns the new sorted copy" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:893 ../src/Doc/whatsnew/2.4.rst:1517 +#: whatsnew/2.4.rst:893 whatsnew/2.4.rst:1517 msgid "" "Integer operations will no longer trigger an :exc:`OverflowWarning`. The :" "exc:`OverflowWarning` warning will disappear in Python 2.5." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:896 +#: whatsnew/2.4.rst:896 msgid "" "The interpreter gained a new switch, :option:`-m`, that takes a name, " "searches for the corresponding module on ``sys.path``, and runs the module " @@ -7250,7 +7196,7 @@ msgid "" "-m profile``. (Contributed by Nick Coghlan.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:901 +#: whatsnew/2.4.rst:901 msgid "" "The :func:`eval(expr, globals, locals)` and :func:`execfile(filename, " "globals, locals)` functions and the :keyword:`exec` statement now accept any " @@ -7258,7 +7204,7 @@ msgid "" "regular Python dictionary. (Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:906 +#: whatsnew/2.4.rst:906 msgid "" "The :func:`zip` built-in function and :func:`itertools.izip` now return an " "empty list if called with no arguments. Previously they raised a :exc:" @@ -7266,7 +7212,7 @@ msgid "" "length argument lists::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:921 +#: whatsnew/2.4.rst:921 msgid "" "Encountering a failure while importing a module no longer leaves a " "partially- initialized module object in ``sys.modules``. The incomplete " @@ -7274,13 +7220,13 @@ msgid "" "succeeding, leading to confusing errors. (Fixed by Tim Peters.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:926 +#: whatsnew/2.4.rst:926 msgid "" ":const:`None` is now a constant; code that binds a new value to the name " "``None`` is now a syntax error. (Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:935 +#: whatsnew/2.4.rst:935 msgid "" "The inner loops for list and tuple slicing were optimized and now run about " "one-third faster. The inner loops for dictionaries were also optimized, " @@ -7290,7 +7236,7 @@ msgid "" msgstr "" # 25d6374f33f542f6bae0bad3730f28d7 -#: ../src/Doc/whatsnew/2.4.rst:941 +#: whatsnew/2.4.rst:941 msgid "" "The machinery for growing and shrinking lists was optimized for speed and " "for space efficiency. Appending and popping from lists now runs faster due " @@ -7300,7 +7246,7 @@ msgid "" "before extending the base list. (Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:948 +#: whatsnew/2.4.rst:948 msgid "" ":func:`list`, :func:`tuple`, :func:`map`, :func:`filter`, and :func:`zip` " "now run several times faster with non-sequence arguments that supply a :meth:" @@ -7308,7 +7254,7 @@ msgid "" msgstr "" # f4ce73505c3948bca638dc0268199532 -#: ../src/Doc/whatsnew/2.4.rst:952 +#: whatsnew/2.4.rst:952 msgid "" "The methods :meth:`list.__getitem__`, :meth:`dict.__getitem__`, and :meth:" "`dict.__contains__` are now implemented as :class:`method_descriptor` " @@ -7318,21 +7264,21 @@ msgid "" "by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:959 +#: whatsnew/2.4.rst:959 msgid "" "Added a new opcode, ``LIST_APPEND``, that simplifies the generated bytecode " "for list comprehensions and speeds them up by about a third. (Contributed " "by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:963 +#: whatsnew/2.4.rst:963 msgid "" "The peephole bytecode optimizer has been improved to produce shorter, " "faster bytecode; remarkably, the resulting bytecode is more readable. " "(Enhanced by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:967 +#: whatsnew/2.4.rst:967 msgid "" "String concatenations in statements of the form ``s = s + \"abc\"`` and ``s " "+= \"abc\"`` are now performed more efficiently in certain circumstances. " @@ -7342,7 +7288,7 @@ msgid "" "number of strings together. (Contributed by Armin Rigo.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:974 +#: whatsnew/2.4.rst:974 msgid "" "The net result of the 2.4 optimizations is that Python 2.4 runs the pystone " "benchmark around 5% faster than Python 2.3 and 35% faster than Python 2.2. " @@ -7351,62 +7297,62 @@ msgid "" "greater or smaller benefits from Python 2.4.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:997 +#: whatsnew/2.4.rst:997 msgid "" "The :mod:`asyncore` module's :func:`loop` function now has a *count* " "parameter that lets you perform a limited number of passes through the " "polling loop. The default is still to loop forever." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1001 +#: whatsnew/2.4.rst:1001 msgid "" "The :mod:`base64` module now has more complete RFC 3548 support for Base64, " "Base32, and Base16 encoding and decoding, including optional case folding " "and optional alternative alphabets. (Contributed by Barry Warsaw.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1005 +#: whatsnew/2.4.rst:1005 msgid "" "The :mod:`bisect` module now has an underlying C implementation for improved " "performance. (Contributed by Dmitry Vasiliev.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1008 +#: whatsnew/2.4.rst:1008 msgid "" "The CJKCodecs collections of East Asian codecs, maintained by Hye-Shik " "Chang, was integrated into 2.4. The new encodings are:" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1011 +#: whatsnew/2.4.rst:1011 msgid "Chinese (PRC): gb2312, gbk, gb18030, big5hkscs, hz" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1013 +#: whatsnew/2.4.rst:1013 msgid "Chinese (ROC): big5, cp950" msgstr "" # db893a32a5cc4293b9895cb29526ecaa -#: ../src/Doc/whatsnew/2.4.rst:1016 +#: whatsnew/2.4.rst:1017 msgid "Japanese: cp932, euc-jis-2004, euc-jp, euc-jisx0213, iso-2022-jp," msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1016 +#: whatsnew/2.4.rst:1016 msgid "" "iso-2022-jp-1, iso-2022-jp-2, iso-2022-jp-3, iso-2022-jp-ext, iso-2022-" "jp-2004, shift-jis, shift-jisx0213, shift-jis-2004" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1019 +#: whatsnew/2.4.rst:1019 msgid "Korean: cp949, euc-kr, johab, iso-2022-kr" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1021 +#: whatsnew/2.4.rst:1021 msgid "" "Some other new encodings were added: HP Roman8, ISO_8859-11, ISO_8859-16, " "PCTP-154, and TIS-620." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1024 +#: whatsnew/2.4.rst:1024 msgid "" "The UTF-8 and UTF-16 codecs now cope better with receiving partial input. " "Previously the :class:`StreamReader` class would try to read more data, " @@ -7415,7 +7361,7 @@ msgid "" "decoding where previous ones left off. (Implemented by Walter Dörwald.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1030 +#: whatsnew/2.4.rst:1030 msgid "" "There is a new :mod:`collections` module for various specialized collection " "datatypes. Currently it contains just one type, :class:`deque`, a double- " @@ -7423,14 +7369,14 @@ msgid "" "either end::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1050 +#: whatsnew/2.4.rst:1050 msgid "" "Several modules, such as the :mod:`Queue` and :mod:`threading` modules, now " "take advantage of :class:`collections.deque` for improved performance. " "(Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1054 +#: whatsnew/2.4.rst:1054 msgid "" "The :mod:`ConfigParser` classes have been enhanced slightly. The :meth:" "`read` method now returns a list of the files that were successfully parsed, " @@ -7439,7 +7385,7 @@ msgid "" "Goodger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1059 +#: whatsnew/2.4.rst:1059 msgid "" "The :mod:`curses` module now supports the ncurses extension :func:" "`use_default_colors`. On platforms where the terminal supports " @@ -7447,7 +7393,7 @@ msgid "" "(Contributed by Jörg Lehmann.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1064 +#: whatsnew/2.4.rst:1064 msgid "" "The :mod:`difflib` module now includes an :class:`HtmlDiff` class that " "creates an HTML table showing a side by side comparison of two versions of a " @@ -7455,7 +7401,7 @@ msgid "" msgstr "" # df9192468fc846f49666919701218ded -#: ../src/Doc/whatsnew/2.4.rst:1068 +#: whatsnew/2.4.rst:1068 msgid "" "The :mod:`email` package was updated to version 3.0, which dropped various " "deprecated APIs and removes support for Python versions earlier than 2.3. " @@ -7467,7 +7413,7 @@ msgid "" "Barry Warsaw, Thomas Wouters, and others.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1077 +#: whatsnew/2.4.rst:1077 msgid "" "The :mod:`heapq` module has been converted to C. The resulting tenfold " "improvement in speed makes the module suitable for handling high volumes of " @@ -7477,7 +7423,7 @@ msgid "" "Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1083 +#: whatsnew/2.4.rst:1083 msgid "" "The :mod:`httplib` module now contains constants for HTTP status codes " "defined in various HTTP-related RFC documents. Constants have names such " @@ -7486,14 +7432,14 @@ msgid "" "Eland.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1089 +#: whatsnew/2.4.rst:1089 msgid "" "The :mod:`imaplib` module now supports IMAP's THREAD command (contributed by " "Yves Dionne) and new :meth:`deleteacl` and :meth:`myrights` methods " "(contributed by Arnaud Mazin)." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1093 +#: whatsnew/2.4.rst:1093 msgid "" "The :mod:`itertools` module gained a :func:`groupby(iterable[, *func*])` " "function. *iterable* is something that can be iterated over to return a " @@ -7504,32 +7450,32 @@ msgid "" "containing the key value and an iterator over the subsequence." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1101 +#: whatsnew/2.4.rst:1101 msgid "" "Here's an example to make this clearer. The *key* function simply returns " "whether a number is even or odd, so the result of :func:`groupby` is to " "return consecutive runs of odd or even numbers. ::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1117 +#: whatsnew/2.4.rst:1117 msgid "" ":func:`groupby` is typically used with sorted input. The logic for :func:" "`groupby` is similar to the Unix ``uniq`` filter which makes it handy for " "eliminating, counting, or identifying duplicate elements::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1140 +#: whatsnew/2.4.rst:1140 msgid "(Contributed by Hye-Shik Chang.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1142 +#: whatsnew/2.4.rst:1142 msgid "" ":mod:`itertools` also gained a function named :func:`tee(iterator, N)` that " "returns *N* independent iterators that replicate *iterator*. If *N* is " "omitted, the default is 2. ::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1155 +#: whatsnew/2.4.rst:1155 msgid "" "Note that :func:`tee` has to keep copies of the values returned by the " "iterator; in the worst case, it may need to keep all of them. This should " @@ -7541,7 +7487,7 @@ msgid "" "Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1164 +#: whatsnew/2.4.rst:1164 msgid "" "A number of functions were added to the :mod:`locale` module, such as :func:" "`bind_textdomain_codeset` to specify a particular encoding and a family of :" @@ -7549,7 +7495,7 @@ msgid "" "(Contributed by Gustavo Niemeyer.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1169 +#: whatsnew/2.4.rst:1169 msgid "" "Some keyword arguments were added to the :mod:`logging` package's :func:" "`basicConfig` function to simplify log configuration. The default behavior " @@ -7558,7 +7504,7 @@ msgid "" "logging level. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1180 +#: whatsnew/2.4.rst:1180 msgid "" "Other additions to the :mod:`logging` package include a :meth:`log(level, " "msg)` convenience method, as well as a :class:`TimedRotatingFileHandler` " @@ -7568,11 +7514,11 @@ msgid "" "class that can be used to implement other rotating handlers." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1187 +#: whatsnew/2.4.rst:1187 msgid "(Changes implemented by Vinay Sajip.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1189 +#: whatsnew/2.4.rst:1189 msgid "" "The :mod:`marshal` module now shares interned strings on unpacking a data " "structure. This may shrink the size of certain pickle strings, but the " @@ -7580,14 +7526,14 @@ msgid "" "(Contributed by Martin von Löwis.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1194 +#: whatsnew/2.4.rst:1194 msgid "" "The :mod:`nntplib` module's :class:`NNTP` class gained :meth:`description` " "and :meth:`descriptions` methods to retrieve newsgroup descriptions for a " "single group or for a range of groups. (Contributed by Jürgen A. Erhard.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1198 +#: whatsnew/2.4.rst:1198 msgid "" "Two new functions were added to the :mod:`operator` module, :func:" "`attrgetter(attr)` and :func:`itemgetter(index)`. Both functions return " @@ -7596,7 +7542,7 @@ msgid "" "`map` or :func:`sorted`. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1214 +#: whatsnew/2.4.rst:1214 msgid "" "The :mod:`optparse` module was updated in various ways. The module now " "passes its messages through :func:`gettext.gettext`, making it possible to " @@ -7605,7 +7551,7 @@ msgid "" "option's default value. (Contributed by Greg Ward.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1220 +#: whatsnew/2.4.rst:1220 msgid "" "The long-term plan is to deprecate the :mod:`rfc822` module in some future " "Python release in favor of the :mod:`email` package. To this end, the :func:" @@ -7614,7 +7560,7 @@ msgid "" "processing code with this in mind. (Change implemented by Anthony Baxter.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1226 +#: whatsnew/2.4.rst:1226 msgid "" "A new :func:`urandom(n)` function was added to the :mod:`os` module, " "returning a string containing *n* bytes of random data. This function " @@ -7623,7 +7569,7 @@ msgid "" "Perrin.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1231 +#: whatsnew/2.4.rst:1231 msgid "" "Another new function: :func:`os.path.lexists(path)` returns true if the " "file specified by *path* exists, whether or not it's a symbolic link. This " @@ -7632,25 +7578,25 @@ msgid "" "doesn't exist. (Contributed by Beni Cherniavsky.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1237 +#: whatsnew/2.4.rst:1237 msgid "" "A new :func:`getsid` function was added to the :mod:`posix` module that " "underlies the :mod:`os` module. (Contributed by J. Raynor.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1240 +#: whatsnew/2.4.rst:1240 msgid "" "The :mod:`poplib` module now supports POP over SSL. (Contributed by Hector " "Urtubia.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1243 +#: whatsnew/2.4.rst:1243 msgid "" "The :mod:`profile` module can now profile C extension functions. " "(Contributed by Nick Bastin.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1246 +#: whatsnew/2.4.rst:1246 msgid "" "The :mod:`random` module has a new method called :meth:`getrandbits(N)` that " "returns a long integer *N* bits in length. The existing :meth:`randrange` " @@ -7659,7 +7605,7 @@ msgid "" "Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1252 +#: whatsnew/2.4.rst:1252 msgid "" "The regular expression language accepted by the :mod:`re` module was " "extended with simple conditional expressions, written as ``(?(group)A|B)``. " @@ -7670,7 +7616,7 @@ msgid "" "Gustavo Niemeyer.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1259 +#: whatsnew/2.4.rst:1259 msgid "" "The :mod:`re` module is also no longer recursive, thanks to a massive amount " "of work by Gustavo Niemeyer. In a recursive regular expression engine, " @@ -7684,7 +7630,7 @@ msgid "" "problems." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1269 +#: whatsnew/2.4.rst:1269 msgid "" "The :mod:`signal` module now performs tighter error-checking on the " "parameters to the :func:`signal.signal` function. For example, you can't " @@ -7693,7 +7639,7 @@ msgid "" "exception." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1274 +#: whatsnew/2.4.rst:1274 msgid "" "Two new functions were added to the :mod:`socket` module. :func:`socketpair` " "returns a pair of connected sockets and :func:`getservbyport(port)` looks up " @@ -7701,7 +7647,7 @@ msgid "" "Barry Warsaw.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1279 +#: whatsnew/2.4.rst:1279 msgid "" "The :func:`sys.exitfunc` function has been deprecated. Code should be using " "the existing :mod:`atexit` module, which correctly handles calling multiple " @@ -7709,34 +7655,34 @@ msgid "" "internal interface, accessed only by :mod:`atexit`." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1284 +#: whatsnew/2.4.rst:1284 msgid "" "The :mod:`tarfile` module now generates GNU-format tar files by default. " "(Contributed by Lars Gustaebel.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1287 +#: whatsnew/2.4.rst:1287 msgid "" "The :mod:`threading` module now has an elegantly simple way to support " "thread-local data. The module contains a :class:`local` class whose " "attribute values are local to different threads. ::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1297 +#: whatsnew/2.4.rst:1297 msgid "" "Other threads can assign and retrieve their own values for the :attr:" "`number` and :attr:`url` attributes. You can subclass :class:`local` to " "initialize attributes or to add methods. (Contributed by Jim Fulton.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1301 +#: whatsnew/2.4.rst:1301 msgid "" "The :mod:`timeit` module now automatically disables periodic garbage " "collection during the timing loop. This change makes consecutive timings " "more comparable. (Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1305 +#: whatsnew/2.4.rst:1305 msgid "" "The :mod:`weakref` module now supports a wider variety of objects including " "Python functions, class instances, sets, frozensets, deques, arrays, files, " @@ -7744,24 +7690,24 @@ msgid "" "Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1310 +#: whatsnew/2.4.rst:1310 msgid "" "The :mod:`xmlrpclib` module now supports a multi-call extension for " "transmitting multiple XML-RPC calls in a single HTTP operation. (Contributed " "by Brian Quinlan.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1314 +#: whatsnew/2.4.rst:1314 msgid "" "The :mod:`mpz`, :mod:`rotor`, and :mod:`xreadlines` modules have been " "removed." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1323 +#: whatsnew/2.4.rst:1323 msgid "cookielib" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1325 +#: whatsnew/2.4.rst:1325 msgid "" "The :mod:`cookielib` library supports client-side handling for HTTP cookies, " "mirroring the :mod:`Cookie` module's server-side cookie support. Cookies are " @@ -7771,7 +7717,7 @@ msgid "" "cookies are accepted or not." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1332 +#: whatsnew/2.4.rst:1332 msgid "" "In order to store cookies across sessions, two implementations of cookie " "jars are provided: one that stores cookies in the Netscape format so " @@ -7779,21 +7725,21 @@ msgid "" "cookies in the same format as the Perl libwww library." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1337 +#: whatsnew/2.4.rst:1337 msgid "" ":mod:`urllib2` has been changed to interact with :mod:`cookielib`: :class:" "`HTTPCookieProcessor` manages a cookie jar that is used when accessing URLs." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1341 +#: whatsnew/2.4.rst:1341 msgid "This module was contributed by John J. Lee." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1347 +#: whatsnew/2.4.rst:1347 msgid "doctest" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1349 +#: whatsnew/2.4.rst:1349 msgid "" "The :mod:`doctest` module underwent considerable refactoring thanks to " "Edward Loper and Tim Peters. Testing can still be as simple as running :" @@ -7801,23 +7747,23 @@ msgid "" "operation in various ways" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1354 +#: whatsnew/2.4.rst:1354 msgid "" "The new :class:`DocTestFinder` class extracts the tests from a given " "object's docstrings::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1370 +#: whatsnew/2.4.rst:1370 msgid "" "The new :class:`DocTestRunner` class then runs individual tests and can " "produce a summary of the results::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1379 +#: whatsnew/2.4.rst:1379 msgid "The above example produces the following output::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1387 +#: whatsnew/2.4.rst:1387 msgid "" ":class:`DocTestRunner` uses an instance of the :class:`OutputChecker` class " "to compare the expected output with the actual output. This class takes a " @@ -7825,7 +7771,7 @@ msgid "" "also write a completely new subclass of :class:`OutputChecker`." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1392 +#: whatsnew/2.4.rst:1392 msgid "" "The default output checker provides a number of handy features. For example, " "with the :const:`doctest.ELLIPSIS` option flag, an ellipsis (``...``) in the " @@ -7833,11 +7779,11 @@ msgid "" "outputs that vary in minor ways::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1403 +#: whatsnew/2.4.rst:1403 msgid "Another special string, ``<BLANKLINE>``, matches a blank line::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1411 +#: whatsnew/2.4.rst:1411 msgid "" "Another new capability is producing a diff-style display of the output by " "specifying the :const:`doctest.REPORT_UDIFF` (unified diffs), :const:" @@ -7845,18 +7791,18 @@ msgid "" "(delta-style) option flags. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1427 +#: whatsnew/2.4.rst:1427 msgid "" "Running the above function's tests with :const:`doctest.REPORT_UDIFF` " "specified, you get the following output::" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1448 +#: whatsnew/2.4.rst:1448 msgid "Some of the changes to Python's build process and to the C API are:" msgstr "" # f2e0ebe52e004c74af69a809500de003 -#: ../src/Doc/whatsnew/2.4.rst:1450 +#: whatsnew/2.4.rst:1450 msgid "" "Three new convenience macros were added for common return values from " "extension functions: :c:macro:`Py_RETURN_NONE`, :c:macro:`Py_RETURN_TRUE`, " @@ -7864,14 +7810,14 @@ msgid "" msgstr "" # 4ad7e5311ae34dfe80c4cdc9de6c87a3 -#: ../src/Doc/whatsnew/2.4.rst:1454 +#: whatsnew/2.4.rst:1454 msgid "" "Another new macro, :c:macro:`Py_CLEAR(obj)`, decreases the reference count " "of *obj* and sets *obj* to the null pointer. (Contributed by Jim Fulton.)" msgstr "" # 568de825d8ab40c49844090664457ce2 -#: ../src/Doc/whatsnew/2.4.rst:1457 +#: whatsnew/2.4.rst:1457 msgid "" "A new function, :c:func:`PyTuple_Pack(N, obj1, obj2, ..., objN)`, constructs " "tuples from a variable length argument list of Python objects. (Contributed " @@ -7879,7 +7825,7 @@ msgid "" msgstr "" # 033885125405485e82789549d08d09f6 -#: ../src/Doc/whatsnew/2.4.rst:1461 +#: whatsnew/2.4.rst:1461 msgid "" "A new function, :c:func:`PyDict_Contains(d, k)`, implements fast dictionary " "lookups without masking exceptions raised during the look-up process. " @@ -7887,14 +7833,14 @@ msgid "" msgstr "" # 609750f0a33a4cdd999fefac1f9a3903 -#: ../src/Doc/whatsnew/2.4.rst:1465 +#: whatsnew/2.4.rst:1465 msgid "" "The :c:macro:`Py_IS_NAN(X)` macro returns 1 if its float or double argument " "*X* is a NaN. (Contributed by Tim Peters.)" msgstr "" # 09b9c6ca13eb433f97dada7cd2483393 -#: ../src/Doc/whatsnew/2.4.rst:1468 +#: whatsnew/2.4.rst:1468 msgid "" "C code can avoid unnecessary locking by using the new :c:func:" "`PyEval_ThreadsInitialized` function to tell if any thread operations have " @@ -7903,7 +7849,7 @@ msgid "" msgstr "" # dae9abb742544270b2a6f9f347d7856c -#: ../src/Doc/whatsnew/2.4.rst:1473 +#: whatsnew/2.4.rst:1473 msgid "" "A new function, :c:func:`PyArg_VaParseTupleAndKeywords`, is the same as :c:" "func:`PyArg_ParseTupleAndKeywords` but takes a :c:type:`va_list` instead of " @@ -7911,7 +7857,7 @@ msgid "" msgstr "" # c31784e594d246ada984382556f94411 -#: ../src/Doc/whatsnew/2.4.rst:1477 +#: whatsnew/2.4.rst:1477 msgid "" "A new method flag, :const:`METH_COEXISTS`, allows a function defined in " "slots to co-exist with a :c:type:`PyCFunction` having the same name. This " @@ -7919,7 +7865,7 @@ msgid "" "(Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1482 +#: whatsnew/2.4.rst:1482 msgid "" "Python can now be built with additional profiling for the interpreter " "itself, intended as an aid to people developing the Python core. Providing :" @@ -7933,38 +7879,38 @@ msgid "" msgstr "" # 94ad83dc5f2240fba4e6e8df3c7dcada -#: ../src/Doc/whatsnew/2.4.rst:1492 +#: whatsnew/2.4.rst:1492 msgid "" "The :c:type:`tracebackobject` type has been renamed to :c:type:" "`PyTracebackObject`." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1501 +#: whatsnew/2.4.rst:1501 msgid "" "The Windows port now builds under MSVC++ 7.1 as well as version 6. " "(Contributed by Martin von Löwis.)" msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1508 +#: whatsnew/2.4.rst:1508 #, fuzzy msgid "Porting to Python 2.4" msgstr "Portage vers Python 3.2" -#: ../src/Doc/whatsnew/2.4.rst:1513 +#: whatsnew/2.4.rst:1513 msgid "" "Left shifts and hexadecimal/octal constants that are too large no longer " "trigger a :exc:`FutureWarning` and return a value limited to 32 or 64 bits; " "instead they return a long integer." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1520 +#: whatsnew/2.4.rst:1520 msgid "" "The :func:`zip` built-in function and :func:`itertools.izip` now return an " "empty list instead of raising a :exc:`TypeError` exception if called with no " "arguments." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1524 +#: whatsnew/2.4.rst:1524 msgid "" "You can no longer compare the :class:`date` and :class:`datetime` instances " "provided by the :mod:`datetime` module. Two instances of different classes " @@ -7972,43 +7918,43 @@ msgid "" "raise a :exc:`TypeError`." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1529 +#: whatsnew/2.4.rst:1529 msgid "" ":func:`dircache.listdir` now passes exceptions to the caller instead of " "returning empty lists." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1532 +#: whatsnew/2.4.rst:1532 msgid "" ":func:`LexicalHandler.startDTD` used to receive the public and system IDs in " "the wrong order. This has been corrected; applications relying on the wrong " "order need to be fixed." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1536 +#: whatsnew/2.4.rst:1536 msgid "" ":func:`fcntl.ioctl` now warns if the *mutate* argument is omitted and " "relevant." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1539 +#: whatsnew/2.4.rst:1539 msgid "" "The :mod:`tarfile` module now generates GNU-format tar files by default." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1541 +#: whatsnew/2.4.rst:1541 msgid "" "Encountering a failure while importing a module no longer leaves a " "partially- initialized module object in ``sys.modules``." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1544 +#: whatsnew/2.4.rst:1544 msgid "" ":const:`None` is now a constant; code that binds a new value to the name " "``None`` is now a syntax error." msgstr "" -#: ../src/Doc/whatsnew/2.4.rst:1547 +#: whatsnew/2.4.rst:1547 msgid "" "The :func:`signals.signal` function now raises a :exc:`RuntimeError` " "exception for certain illegal values; previously these errors would pass " @@ -8017,7 +7963,7 @@ msgid "" msgstr "" # 7a25fd14be4d4ddfa0739f47b4ed71e3 -#: ../src/Doc/whatsnew/2.4.rst:1559 +#: whatsnew/2.4.rst:1559 msgid "" "The author would like to thank the following people for offering " "suggestions, corrections and assistance with various drafts of this article: " @@ -8025,19 +7971,19 @@ msgid "" "Hamish Lawson, Fredrik Lundh, Sean Reifschneider, Sadruddin Rejeb." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:3 +#: whatsnew/2.5.rst:3 #, fuzzy msgid "What's New in Python 2.5" msgstr "Nouveautés de Python 2.0" -#: ../src/Doc/whatsnew/2.5.rst:12 +#: whatsnew/2.5.rst:12 msgid "" "This article explains the new features in Python 2.5. The final release of " "Python 2.5 is scheduled for August 2006; :pep:`356` describes the planned " "release schedule." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:16 +#: whatsnew/2.5.rst:16 msgid "" "The changes in Python 2.5 are an interesting mix of language and library " "improvements. The library enhancements will be more important to Python's " @@ -8047,7 +7993,7 @@ msgid "" "calling C functions." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:23 +#: whatsnew/2.5.rst:23 msgid "" "The language changes are of middling significance. Some pleasant new " "features were added, but most of them aren't features that you'll use every " @@ -8062,7 +8008,7 @@ msgid "" "modifications to Python's semantics." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:34 +#: whatsnew/2.5.rst:34 msgid "" "As well as the language and library additions, other improvements and " "bugfixes were made throughout the source tree. A search through the SVN " @@ -8071,7 +8017,7 @@ msgid "" msgstr "" # 3d655397a96646ad9c5ebe79795dc4da -#: ../src/Doc/whatsnew/2.5.rst:39 +#: whatsnew/2.5.rst:39 msgid "" "This article doesn't try to be a complete specification of the new features; " "instead changes are briefly introduced using helpful examples. For full " @@ -8081,17 +8027,17 @@ msgid "" "feature." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:45 +#: whatsnew/2.5.rst:45 msgid "" "Comments, suggestions, and error reports for this document are welcome; " "please e-mail them to the author or open a bug in the Python bug tracker." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:54 +#: whatsnew/2.5.rst:54 msgid "PEP 308: Conditional Expressions" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:56 +#: whatsnew/2.5.rst:56 msgid "" "For a long time, people have been requesting a way to write conditional " "expressions, which are expressions that return value A or value B depending " @@ -8100,7 +8046,7 @@ msgid "" "following::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:66 +#: whatsnew/2.5.rst:66 msgid "" "There have been endless tedious discussions of syntax on both python-dev and " "comp.lang.python. A vote was even held that found the majority of voters " @@ -8109,11 +8055,11 @@ msgid "" "false_v``, ``if cond then true_v else false_v``, and 16 other variations." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:72 +#: whatsnew/2.5.rst:72 msgid "Guido van Rossum eventually chose a surprising syntax::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:76 +#: whatsnew/2.5.rst:76 msgid "" "Evaluation is still lazy as in existing Boolean expressions, so the order of " "evaluation jumps around a bit. The *condition* expression in the middle is " @@ -8122,7 +8068,7 @@ msgid "" "evaluated when the condition is false." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:82 +#: whatsnew/2.5.rst:82 msgid "" "This syntax may seem strange and backwards; why does the condition go in the " "*middle* of the expression, and not in the front as in C's ``c ? x : y``? " @@ -8134,7 +8080,7 @@ msgid "" "bit more obvious::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:92 +#: whatsnew/2.5.rst:92 msgid "" "I read the above statement as meaning \"here *contents* is usually assigned " "a value of ``doc+'\\n'``; sometimes *doc* is empty, in which special case " @@ -8142,7 +8088,7 @@ msgid "" "very often where there isn't a clear common and uncommon case." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:97 +#: whatsnew/2.5.rst:97 msgid "" "There was some discussion of whether the language should require surrounding " "conditional expressions with parentheses. The decision was made to *not* " @@ -8150,7 +8096,7 @@ msgid "" "style I think you should always use them. Consider these two statements::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:108 +#: whatsnew/2.5.rst:108 msgid "" "In the first version, I think a reader's eye might group the statement into " "'level = 1', 'if logging', 'else 0', and think that the condition decides " @@ -8159,7 +8105,7 @@ msgid "" "always performed and the choice is being made between two values." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:114 +#: whatsnew/2.5.rst:114 msgid "" "Another reason for including the brackets: a few odd combinations of list " "comprehensions and lambdas could look like incorrect conditional " @@ -8167,28 +8113,27 @@ msgid "" "around your conditional expressions, you won't run into this case." msgstr "" -# 44df6b868c2b45c8801bd887744d5ac6 -#: ../src/Doc/whatsnew/2.5.rst:122 -msgid ":pep:`308` - Conditional Expressions" +#: whatsnew/2.5.rst:123 +msgid "PEP 308 - Conditional Expressions" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:123 +#: whatsnew/2.5.rst:123 msgid "" "PEP written by Guido van Rossum and Raymond D. Hettinger; implemented by " "Thomas Wouters." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:132 +#: whatsnew/2.5.rst:132 msgid "PEP 309: Partial Function Application" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:134 +#: whatsnew/2.5.rst:134 msgid "" "The :mod:`functools` module is intended to contain tools for functional-" "style programming." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:137 +#: whatsnew/2.5.rst:137 msgid "" "One useful tool in this module is the :func:`partial` function. For programs " "written in a functional style, you'll sometimes want to construct variants " @@ -8198,18 +8143,18 @@ msgid "" "function application\"." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:144 +#: whatsnew/2.5.rst:144 msgid "" ":func:`partial` takes the arguments ``(function, arg1, arg2, ... " "kwarg1=value1, kwarg2=value2)``. The resulting object is callable, so you " "can just call it to invoke *function* with the filled-in arguments." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:148 +#: whatsnew/2.5.rst:148 msgid "Here's a small but realistic example::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:160 +#: whatsnew/2.5.rst:160 msgid "" "Here's another example, from a program that uses PyGTK. Here a context- " "sensitive pop-up menu is being constructed dynamically. The callback " @@ -8217,7 +8162,7 @@ msgid "" "`open_item` method, where the first argument has been provided. ::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:173 +#: whatsnew/2.5.rst:173 msgid "" "Another function in the :mod:`functools` module is the :func:" "`update_wrapper(wrapper, wrapped)` function that helps you write well- " @@ -8226,29 +8171,28 @@ msgid "" "wrapped function are easier to understand. For example, you might write::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:186 +#: whatsnew/2.5.rst:186 msgid "" ":func:`wraps` is a decorator that can be used inside your own decorators to " "copy the wrapped function's information. An alternate version of the " "previous example would be::" msgstr "" -# b9f178c3add74836a40f5068125026b3 -#: ../src/Doc/whatsnew/2.5.rst:200 -msgid ":pep:`309` - Partial Function Application" +#: whatsnew/2.5.rst:201 +msgid "PEP 309 - Partial Function Application" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:201 +#: whatsnew/2.5.rst:201 msgid "" "PEP proposed and written by Peter Harris; implemented by Hye-Shik Chang and " "Nick Coghlan, with adaptations by Raymond Hettinger." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:210 +#: whatsnew/2.5.rst:210 msgid "PEP 314: Metadata for Python Software Packages v1.1" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:212 +#: whatsnew/2.5.rst:212 msgid "" "Some simple dependency support was added to Distutils. The :func:`setup` " "function now has ``requires``, ``provides``, and ``obsoletes`` keyword " @@ -8257,7 +8201,7 @@ msgid "" "file." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:217 +#: whatsnew/2.5.rst:217 msgid "" "Another new keyword parameter is ``download_url``, which should be set to a " "URL for the package's source code. This means it's now possible to look up " @@ -8266,14 +8210,14 @@ msgid "" msgstr "" # 4f73b69675e440e9891cd4b9921e5bc6 -#: ../src/Doc/whatsnew/2.5.rst:231 +#: whatsnew/2.5.rst:231 msgid "" "Another new enhancement to the Python package index at https://pypi.python." "org is storing source and binary archives for a package. The new :command:" "`upload` Distutils command will upload a package to the repository." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:236 +#: whatsnew/2.5.rst:236 msgid "" "Before a package can be uploaded, you must be able to build a distribution " "using the :command:`sdist` Distutils command. Once that works, you can run " @@ -8282,34 +8226,33 @@ msgid "" "and :option:`--identity` options." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:242 +#: whatsnew/2.5.rst:242 msgid "" "Package uploading was implemented by Martin von Löwis and Richard Jones." msgstr "" -# 9cf9f1f0f5a747708d4f090e1cb5429f -#: ../src/Doc/whatsnew/2.5.rst:247 -msgid ":pep:`314` - Metadata for Python Software Packages v1.1" +#: whatsnew/2.5.rst:248 +msgid "PEP 314 - Metadata for Python Software Packages v1.1" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:248 +#: whatsnew/2.5.rst:248 msgid "" "PEP proposed and written by A.M. Kuchling, Richard Jones, and Fred Drake; " "implemented by Richard Jones and Fred Drake." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:257 +#: whatsnew/2.5.rst:257 msgid "PEP 328: Absolute and Relative Imports" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:259 +#: whatsnew/2.5.rst:259 msgid "" "The simpler part of PEP 328 was implemented in Python 2.4: parentheses could " "now be used to enclose the names imported from a module using the ``from ... " "import ...`` statement, making it easier to import many different names." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:263 +#: whatsnew/2.5.rst:263 msgid "" "The more complicated part has been implemented in Python 2.5: importing a " "module can be specified to use absolute or package-relative imports. The " @@ -8317,17 +8260,17 @@ msgid "" "versions of Python." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:267 +#: whatsnew/2.5.rst:267 msgid "Let's say you have a package directory like this::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:274 +#: whatsnew/2.5.rst:274 msgid "" "This defines a package named :mod:`pkg` containing the :mod:`pkg.main` and :" "mod:`pkg.string` submodules." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:277 +#: whatsnew/2.5.rst:277 msgid "" "Consider the code in the :file:`main.py` module. What happens if it " "executes the statement ``import string``? In Python 2.4 and earlier, it " @@ -8338,7 +8281,7 @@ msgid "" msgstr "" # 3a91520103784786acd1a36e83f77dbc -#: ../src/Doc/whatsnew/2.5.rst:284 +#: whatsnew/2.5.rst:284 msgid "" "That's fine if :mod:`pkg.string` was what you wanted. But what if you " "wanted Python's standard :mod:`string` module? There's no clean way to " @@ -8349,7 +8292,7 @@ msgid "" "that package isn't available on all Python installations." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:292 +#: whatsnew/2.5.rst:292 msgid "" "Reading code which relies on relative imports is also less clear, because a " "reader may be confused about which module, :mod:`string` or :mod:`pkg." @@ -8359,7 +8302,7 @@ msgid "" "used for a new module added in a future version of Python." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:299 +#: whatsnew/2.5.rst:299 msgid "" "In Python 2.5, you can switch :keyword:`import`'s behaviour to absolute " "imports using a ``from __future__ import absolute_import`` directive. This " @@ -8370,13 +8313,13 @@ msgid "" "preferable to begin writing ``from pkg import string`` in your code." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:307 +#: whatsnew/2.5.rst:307 msgid "" "Relative imports are still possible by adding a leading period to the " "module name when using the ``from ... import`` form::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:315 +#: whatsnew/2.5.rst:315 msgid "" "This imports the :mod:`string` module relative to the current package, so " "in :mod:`pkg.main` this will import *name1* and *name2* from :mod:`pkg." @@ -8385,31 +8328,31 @@ msgid "" "C` module can do::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:324 +#: whatsnew/2.5.rst:324 msgid "" "Leading periods cannot be used with the ``import modname`` form of the " "import statement, only the ``from ... import`` form." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:331 +#: whatsnew/2.5.rst:331 msgid "PEP written by Aahz; implemented by Thomas Wouters." msgstr "" # 4450c6e258ae466f9a5f4ccec97826cf -#: ../src/Doc/whatsnew/2.5.rst:332 +#: whatsnew/2.5.rst:333 msgid "http://codespeak.net/py/current/doc/index.html" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:334 +#: whatsnew/2.5.rst:334 msgid "" "The py library by Holger Krekel, which contains the :mod:`py.std` package." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:342 +#: whatsnew/2.5.rst:342 msgid "PEP 338: Executing Modules as Scripts" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:344 +#: whatsnew/2.5.rst:344 msgid "" "The :option:`-m` switch added in Python 2.4 to execute a module as a script " "gained a few more abilities. Instead of being implemented in C code inside " @@ -8417,7 +8360,7 @@ msgid "" "module, :mod:`runpy`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:349 +#: whatsnew/2.5.rst:349 msgid "" "The :mod:`runpy` module implements a more sophisticated import mechanism so " "that it's now possible to run modules in a package such as :mod:`pychecker." @@ -8428,20 +8371,20 @@ msgid "" msgstr "" # 9f099ecb8fab495aa0a4129a408eeb63 -#: ../src/Doc/whatsnew/2.5.rst:358 +#: whatsnew/2.5.rst:359 #, fuzzy -msgid ":pep:`338` - Executing modules as scripts" +msgid "PEP 338 - Executing modules as scripts" msgstr ":pep:`338` -- Exécuter des modules en tant que scripts" -#: ../src/Doc/whatsnew/2.5.rst:360 +#: whatsnew/2.5.rst:360 msgid "PEP written and implemented by Nick Coghlan." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:368 +#: whatsnew/2.5.rst:368 msgid "PEP 341: Unified try/except/finally" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:370 +#: whatsnew/2.5.rst:370 msgid "" "Until Python 2.5, the :keyword:`try` statement came in two flavours. You " "could use a :keyword:`finally` block to ensure that code is always executed, " @@ -8452,7 +8395,7 @@ msgid "" "should be." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:377 +#: whatsnew/2.5.rst:377 msgid "" "Guido van Rossum spent some time working with Java, which does support the " "equivalent of combining :keyword:`except` blocks and a :keyword:`finally` " @@ -8460,7 +8403,7 @@ msgid "" "you can now write::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:393 +#: whatsnew/2.5.rst:393 msgid "" "The code in *block-1* is executed. If the code raises an exception, the " "various :keyword:`except` blocks are tested: if the exception is of class :" @@ -8469,7 +8412,7 @@ msgid "" "is raised, the *else-block* is executed." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:399 +#: whatsnew/2.5.rst:399 msgid "" "No matter what happened previously, the *final-block* is executed once the " "code block is complete and any raised exceptions handled. Even if there's an " @@ -8477,20 +8420,19 @@ msgid "" "raised, the code in the *final-block* is still run." msgstr "" -# f8852f7480274b9099906e5ca5a41d8b -#: ../src/Doc/whatsnew/2.5.rst:406 -msgid ":pep:`341` - Unifying try-except and try-finally" +#: whatsnew/2.5.rst:407 +msgid "PEP 341 - Unifying try-except and try-finally" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:408 +#: whatsnew/2.5.rst:408 msgid "PEP written by Georg Brandl; implementation by Thomas Lee." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:416 +#: whatsnew/2.5.rst:416 msgid "PEP 342: New Generator Features" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:418 +#: whatsnew/2.5.rst:418 msgid "" "Python 2.5 adds a simple way to pass values *into* a generator. As " "introduced in Python 2.3, generators only produce output; once a generator's " @@ -8502,11 +8444,11 @@ msgid "" "callers then modify." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:426 +#: whatsnew/2.5.rst:426 msgid "To refresh your memory of basic generators, here's a simple example::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:434 +#: whatsnew/2.5.rst:434 msgid "" "When you call ``counter(10)``, the result is an iterator that returns the " "values from 0 up to 9. On encountering the :keyword:`yield` statement, the " @@ -8516,14 +8458,14 @@ msgid "" "statement." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:440 +#: whatsnew/2.5.rst:440 msgid "" "In Python 2.3, :keyword:`yield` was a statement; it didn't return any " "value. In 2.5, :keyword:`yield` is now an expression, returning a value " "that can be assigned to a variable or otherwise operated on::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:446 +#: whatsnew/2.5.rst:446 msgid "" "I recommend that you always put parentheses around a :keyword:`yield` " "expression when you're doing something with the returned value, as in the " @@ -8531,7 +8473,7 @@ msgid "" "always add them instead of having to remember when they're needed." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:451 +#: whatsnew/2.5.rst:451 msgid "" "(:pep:`342` explains the exact rules, which are that a :keyword:`yield`\\ -" "expression must always be parenthesized except when it occurs at the top-" @@ -8540,7 +8482,7 @@ msgid "" "operation, as in ``val = (yield i) + 12``.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:457 +#: whatsnew/2.5.rst:457 msgid "" "Values are sent into a generator by calling its :meth:`send(value)` method. " "The generator's code is then resumed and the :keyword:`yield` expression " @@ -8548,17 +8490,17 @@ msgid "" "called, the :keyword:`yield` returns :const:`None`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:462 +#: whatsnew/2.5.rst:462 msgid "" "Here's the previous example, modified to allow changing the value of the " "internal counter. ::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:475 +#: whatsnew/2.5.rst:475 msgid "And here's an example of changing the counter::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:492 +#: whatsnew/2.5.rst:492 msgid "" ":keyword:`yield` will usually return :const:`None`, so you should always " "check for this case. Don't just use its value in expressions unless you're " @@ -8566,19 +8508,19 @@ msgid "" "your generator function." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:497 +#: whatsnew/2.5.rst:497 msgid "" "In addition to :meth:`send`, there are two other new methods on generators:" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:499 +#: whatsnew/2.5.rst:499 msgid "" ":meth:`throw(type, value=None, traceback=None)` is used to raise an " "exception inside the generator; the exception is raised by the :keyword:" "`yield` expression where the generator's execution is paused." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:503 +#: whatsnew/2.5.rst:503 msgid "" ":meth:`close` raises a new :exc:`GeneratorExit` exception inside the " "generator to terminate the iteration. On receiving this exception, the " @@ -8590,20 +8532,20 @@ msgid "" "generator is garbage-collected." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:511 +#: whatsnew/2.5.rst:511 msgid "" "If you need to run cleanup code when a :exc:`GeneratorExit` occurs, I " "suggest using a ``try: ... finally:`` suite instead of catching :exc:" "`GeneratorExit`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:514 +#: whatsnew/2.5.rst:514 msgid "" "The cumulative effect of these changes is to turn generators from one-way " "producers of information into both producers and consumers." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:517 +#: whatsnew/2.5.rst:517 msgid "" "Generators also become *coroutines*, a more generalized form of subroutines. " "Subroutines are entered at one point and exited at another point (the top of " @@ -8613,7 +8555,7 @@ msgid "" "effectively in Python." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:523 +#: whatsnew/2.5.rst:523 msgid "" "The addition of the :meth:`close` method has one side effect that isn't " "obvious. :meth:`close` is called when a generator is garbage-collected, so " @@ -8628,7 +8570,7 @@ msgid "" "PEP 343. I'll look at this new statement in the following section." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:535 +#: whatsnew/2.5.rst:535 msgid "" "Another even more esoteric effect of this change: previously, the :attr:" "`gi_frame` attribute of a generator was always a frame object. It's now " @@ -8636,48 +8578,47 @@ msgid "" "exhausted." msgstr "" -# bc9de8dd8258432b8ed1855a762f2bf5 -#: ../src/Doc/whatsnew/2.5.rst:547 -msgid ":pep:`342` - Coroutines via Enhanced Generators" +#: whatsnew/2.5.rst:548 +msgid "PEP 342 - Coroutines via Enhanced Generators" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:544 +#: whatsnew/2.5.rst:544 msgid "" "PEP written by Guido van Rossum and Phillip J. Eby; implemented by Phillip " "J. Eby. Includes examples of some fancier uses of generators as coroutines." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:547 +#: whatsnew/2.5.rst:547 msgid "" "Earlier versions of these features were proposed in :pep:`288` by Raymond " "Hettinger and :pep:`325` by Samuele Pedroni." msgstr "" # a340fd7953dc4254a77bc4debe98858c -#: ../src/Doc/whatsnew/2.5.rst:550 +#: whatsnew/2.5.rst:551 msgid "http://en.wikipedia.org/wiki/Coroutine" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:551 +#: whatsnew/2.5.rst:551 msgid "The Wikipedia entry for coroutines." msgstr "" # 1e4cac8826054eac87902eff631e23ab -#: ../src/Doc/whatsnew/2.5.rst:552 +#: whatsnew/2.5.rst:553 msgid "http://www.sidhe.org/~dan/blog/archives/000178.html" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:554 +#: whatsnew/2.5.rst:554 msgid "" "An explanation of coroutines from a Perl point of view, written by Dan " "Sugalski." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:562 ../src/Doc/whatsnew/2.6.rst:244 +#: whatsnew/2.5.rst:562 whatsnew/2.6.rst:244 msgid "PEP 343: The 'with' statement" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:564 ../src/Doc/whatsnew/2.6.rst:255 +#: whatsnew/2.5.rst:564 whatsnew/2.6.rst:255 msgid "" "The ':keyword:`with`' statement clarifies code that previously would use " "``try...finally`` blocks to ensure that clean-up code is executed. In this " @@ -8686,20 +8627,20 @@ msgid "" "objects for use with this statement." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:570 +#: whatsnew/2.5.rst:570 msgid "" "The ':keyword:`with`' statement is a new control-flow structure whose basic " "structure is::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:576 +#: whatsnew/2.5.rst:576 msgid "" "The expression is evaluated, and it should result in an object that supports " "the context management protocol (that is, has :meth:`__enter__` and :meth:" "`__exit__` methods." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:580 ../src/Doc/whatsnew/2.6.rst:271 +#: whatsnew/2.5.rst:580 whatsnew/2.6.rst:271 msgid "" "The object's :meth:`__enter__` is called before *with-block* is executed and " "therefore can run set-up code. It also may return a value that is bound to " @@ -8707,67 +8648,67 @@ msgid "" "assigned the result of *expression*.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:585 ../src/Doc/whatsnew/2.6.rst:276 +#: whatsnew/2.5.rst:585 whatsnew/2.6.rst:276 msgid "" "After execution of the *with-block* is finished, the object's :meth:" "`__exit__` method is called, even if the block raised an exception, and can " "therefore run clean-up code." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:589 +#: whatsnew/2.5.rst:589 msgid "" "To enable the statement in Python 2.5, you need to add the following " "directive to your module::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:594 +#: whatsnew/2.5.rst:594 msgid "The statement will always be enabled in Python 2.6." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:596 ../src/Doc/whatsnew/2.6.rst:280 +#: whatsnew/2.5.rst:596 whatsnew/2.6.rst:280 msgid "" "Some standard Python objects now support the context management protocol and " "can be used with the ':keyword:`with`' statement. File objects are one " "example::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:604 ../src/Doc/whatsnew/2.6.rst:288 +#: whatsnew/2.5.rst:604 whatsnew/2.6.rst:288 msgid "" "After this statement has executed, the file object in *f* will have been " "automatically closed, even if the :keyword:`for` loop raised an exception " "part- way through the block." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:610 ../src/Doc/whatsnew/2.6.rst:294 +#: whatsnew/2.5.rst:610 whatsnew/2.6.rst:294 msgid "" "In this case, *f* is the same object created by :func:`open`, because :meth:" "`file.__enter__` returns *self*." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:613 ../src/Doc/whatsnew/2.6.rst:297 +#: whatsnew/2.5.rst:613 whatsnew/2.6.rst:297 msgid "" "The :mod:`threading` module's locks and condition variables also support " "the ':keyword:`with`' statement::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:621 ../src/Doc/whatsnew/2.6.rst:305 +#: whatsnew/2.5.rst:621 whatsnew/2.6.rst:305 msgid "" "The lock is acquired before the block is executed and always released once " "the block is complete." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:624 +#: whatsnew/2.5.rst:624 msgid "" "The new :func:`localcontext` function in the :mod:`decimal` module makes it " "easy to save and restore the current decimal context, which encapsulates the " "desired precision and rounding characteristics for computations::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:643 ../src/Doc/whatsnew/2.6.rst:327 +#: whatsnew/2.5.rst:643 whatsnew/2.6.rst:327 msgid "Writing Context Managers" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:645 ../src/Doc/whatsnew/2.6.rst:329 +#: whatsnew/2.5.rst:645 whatsnew/2.6.rst:329 msgid "" "Under the hood, the ':keyword:`with`' statement is fairly complicated. Most " "people will only use ':keyword:`with`' in company with existing objects and " @@ -8776,29 +8717,29 @@ msgid "" "the underlying implementation and should keep reading." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:651 ../src/Doc/whatsnew/2.6.rst:335 +#: whatsnew/2.5.rst:651 whatsnew/2.6.rst:335 msgid "A high-level explanation of the context management protocol is:" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:653 ../src/Doc/whatsnew/2.6.rst:337 +#: whatsnew/2.5.rst:653 whatsnew/2.6.rst:337 msgid "" "The expression is evaluated and should result in an object called a " "\"context manager\". The context manager must have :meth:`__enter__` and :" "meth:`__exit__` methods." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:657 +#: whatsnew/2.5.rst:657 msgid "" "The context manager's :meth:`__enter__` method is called. The value " "returned is assigned to *VAR*. If no ``'as VAR'`` clause is present, the " "value is simply discarded." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:661 ../src/Doc/whatsnew/2.6.rst:345 +#: whatsnew/2.5.rst:661 whatsnew/2.6.rst:345 msgid "The code in *BLOCK* is executed." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:663 +#: whatsnew/2.5.rst:663 msgid "" "If *BLOCK* raises an exception, the :meth:`__exit__(type, value, traceback)` " "is called with the exception details, the same values returned by :func:`sys." @@ -8809,19 +8750,19 @@ msgid "" "will never realize anything went wrong." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:671 ../src/Doc/whatsnew/2.6.rst:356 +#: whatsnew/2.5.rst:671 whatsnew/2.6.rst:356 msgid "" "If *BLOCK* didn't raise an exception, the :meth:`__exit__` method is still " "called, but *type*, *value*, and *traceback* are all ``None``." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:674 ../src/Doc/whatsnew/2.6.rst:359 +#: whatsnew/2.5.rst:674 whatsnew/2.6.rst:359 msgid "" "Let's think through an example. I won't present detailed code but will only " "sketch the methods necessary for a database that supports transactions." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:677 ../src/Doc/whatsnew/2.6.rst:362 +#: whatsnew/2.5.rst:677 whatsnew/2.6.rst:362 msgid "" "(For people unfamiliar with database terminology: a set of changes to the " "database are grouped into a transaction. Transactions can be either " @@ -8830,20 +8771,20 @@ msgid "" "unchanged. See any database textbook for more information.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:683 ../src/Doc/whatsnew/2.6.rst:368 +#: whatsnew/2.5.rst:683 whatsnew/2.6.rst:368 msgid "" "Let's assume there's an object representing a database connection. Our goal " "will be to let the user write code like this::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:692 ../src/Doc/whatsnew/2.6.rst:377 +#: whatsnew/2.5.rst:692 whatsnew/2.6.rst:377 msgid "" "The transaction should be committed if the code in the block runs flawlessly " "or rolled back if there's an exception. Here's the basic interface for :" "class:`DatabaseConnection` that I'll assume::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:705 ../src/Doc/whatsnew/2.6.rst:390 +#: whatsnew/2.5.rst:705 whatsnew/2.6.rst:390 msgid "" "The :meth:`__enter__` method is pretty easy, having only to start a new " "transaction. For this application the resulting cursor object would be a " @@ -8852,7 +8793,7 @@ msgid "" "variable name. ::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:717 ../src/Doc/whatsnew/2.6.rst:402 +#: whatsnew/2.5.rst:717 whatsnew/2.6.rst:402 msgid "" "The :meth:`__exit__` method is the most complicated because it's where most " "of the work has to be done. The method has to check if an exception " @@ -8860,7 +8801,7 @@ msgid "" "transaction is rolled back if there was an exception." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:722 ../src/Doc/whatsnew/2.6.rst:407 +#: whatsnew/2.5.rst:722 whatsnew/2.6.rst:407 msgid "" "In the code below, execution will just fall off the end of the function, " "returning the default value of ``None``. ``None`` is false, so the " @@ -8868,18 +8809,18 @@ msgid "" "explicit and add a :keyword:`return` statement at the marked location. ::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:742 ../src/Doc/whatsnew/2.6.rst:427 +#: whatsnew/2.5.rst:742 whatsnew/2.6.rst:427 msgid "The contextlib module" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:744 +#: whatsnew/2.5.rst:744 msgid "" "The new :mod:`contextlib` module provides some functions and a decorator " "that are useful for writing objects for use with the ':keyword:`with`' " "statement." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:747 ../src/Doc/whatsnew/2.6.rst:432 +#: whatsnew/2.5.rst:747 whatsnew/2.6.rst:432 msgid "" "The decorator is called :func:`contextmanager`, and lets you write a single " "generator function instead of defining a new class. The generator should " @@ -8892,13 +8833,13 @@ msgid "" "statement." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:756 +#: whatsnew/2.5.rst:756 msgid "" "Our database example from the previous section could be written using this " "decorator as::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:776 +#: whatsnew/2.5.rst:776 msgid "" "The :mod:`contextlib` module also has a :func:`nested(mgr1, mgr2, ...)` " "function that combines a number of context managers so you don't need to " @@ -8907,20 +8848,18 @@ msgid "" "thread lock::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:785 +#: whatsnew/2.5.rst:785 msgid "" "Finally, the :func:`closing(object)` function returns *object* so that it " "can be bound to a variable, and calls ``object.close`` at the end of the " "block. ::" msgstr "" -# e053e0436b02480ca14a6934d94b391b -# 19cf1dc4e704498a854dc657dc843de2 -#: ../src/Doc/whatsnew/2.5.rst:801 ../src/Doc/whatsnew/2.6.rst:487 -msgid ":pep:`343` - The \"with\" statement" +#: whatsnew/2.5.rst:802 whatsnew/2.6.rst:488 +msgid "PEP 343 - The \"with\" statement" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:799 ../src/Doc/whatsnew/2.6.rst:485 +#: whatsnew/2.5.rst:799 whatsnew/2.6.rst:485 msgid "" "PEP written by Guido van Rossum and Nick Coghlan; implemented by Mike Bland, " "Guido van Rossum, and Neal Norwitz. The PEP shows the code generated for a " @@ -8928,15 +8867,15 @@ msgid "" "statement works." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:804 ../src/Doc/whatsnew/2.6.rst:490 +#: whatsnew/2.5.rst:804 whatsnew/2.6.rst:490 msgid "The documentation for the :mod:`contextlib` module." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:812 +#: whatsnew/2.5.rst:812 msgid "PEP 352: Exceptions as New-Style Classes" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:814 +#: whatsnew/2.5.rst:814 msgid "" "Exception classes can now be new-style classes, not just classic classes, " "and the built-in :exc:`Exception` class and all the standard built-in " @@ -8944,24 +8883,24 @@ msgid "" "classes." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:818 +#: whatsnew/2.5.rst:818 msgid "" "The inheritance hierarchy for exceptions has been rearranged a bit. In 2.5, " "the inheritance relationships are::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:827 +#: whatsnew/2.5.rst:827 msgid "" "This rearrangement was done because people often want to catch all " "exceptions that indicate program errors. :exc:`KeyboardInterrupt` and :exc:" "`SystemExit` aren't errors, though, and usually represent an explicit action " -"such as the user hitting Control-C or code calling :func:`sys.exit`. A bare " -"``except:`` will catch all exceptions, so you commonly need to list :exc:" -"`KeyboardInterrupt` and :exc:`SystemExit` in order to re-raise them. The " -"usual pattern is::" +"such as the user hitting :kbd:`Control-C` or code calling :func:`sys.exit`. " +"A bare ``except:`` will catch all exceptions, so you commonly need to list :" +"exc:`KeyboardInterrupt` and :exc:`SystemExit` in order to re-raise them. " +"The usual pattern is::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:842 +#: whatsnew/2.5.rst:842 msgid "" "In Python 2.5, you can now write ``except Exception`` to achieve the same " "result, catching all the exceptions that usually indicate errors but " @@ -8969,7 +8908,7 @@ msgid "" "previous versions, a bare ``except:`` still catches all exceptions." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:847 +#: whatsnew/2.5.rst:847 msgid "" "The goal for Python 3.0 is to require any class raised as an exception to " "derive from :exc:`BaseException` or some descendant of :exc:`BaseException`, " @@ -8980,30 +8919,29 @@ msgid "" "hasn't decided whether to do this or not." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:855 +#: whatsnew/2.5.rst:855 msgid "" "Raising of strings as exceptions, as in the statement ``raise \"Error " "occurred\"``, is deprecated in Python 2.5 and will trigger a warning. The " "aim is to be able to remove the string-exception feature in a few releases." msgstr "" -# 830b836fa7d14a6dbcf462dfa9619f5f -#: ../src/Doc/whatsnew/2.5.rst:861 -msgid ":pep:`352` - Required Superclass for Exceptions" +#: whatsnew/2.5.rst:862 +msgid "PEP 352 - Required Superclass for Exceptions" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:863 +#: whatsnew/2.5.rst:863 msgid "" "PEP written by Brett Cannon and Guido van Rossum; implemented by Brett " "Cannon." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:871 +#: whatsnew/2.5.rst:871 msgid "PEP 353: Using ssize_t as the index type" msgstr "" # 71b5443da628447f95d10236438b9bb9 -#: ../src/Doc/whatsnew/2.5.rst:873 +#: whatsnew/2.5.rst:873 msgid "" "A wide-ranging change to Python's C API, using a new :c:type:`Py_ssize_t` " "type definition instead of :c:type:`int`, will permit the interpreter to " @@ -9012,7 +8950,7 @@ msgid "" msgstr "" # c1e23fdb99ed40b08e77ceb44266dcd6 -#: ../src/Doc/whatsnew/2.5.rst:878 +#: whatsnew/2.5.rst:878 msgid "" "Various pieces of the Python interpreter used C's :c:type:`int` type to " "store sizes or counts; for example, the number of items in a list or tuple " @@ -9025,7 +8963,7 @@ msgid "" msgstr "" # 5f7d94474eb2447e9a4cc3a4ed35e666 -#: ../src/Doc/whatsnew/2.5.rst:887 +#: whatsnew/2.5.rst:887 msgid "" "A limit of 2147483647 items doesn't really matter on a 32-bit platform " "because you'll run out of memory before hitting the length limit. Each list " @@ -9035,7 +8973,7 @@ msgid "" msgstr "" # f16f78bdeebe45f19b44744f17c7beec -#: ../src/Doc/whatsnew/2.5.rst:893 +#: whatsnew/2.5.rst:893 msgid "" "It's possible to address that much memory on a 64-bit platform, however. " "The pointers for a list that size would only require 16 GiB of space, so " @@ -9049,7 +8987,7 @@ msgid "" msgstr "" # 916257bfcbba4a7a8a40bd01d6928ea1 -#: ../src/Doc/whatsnew/2.5.rst:903 +#: whatsnew/2.5.rst:903 msgid "" "This change most strongly affects authors of C extension modules. Python " "strings and container types such as lists and tuples now use :c:type:" @@ -9059,7 +8997,7 @@ msgid "" msgstr "" # 09b5e20c7fff4d7faeb237aa4b58f34a -#: ../src/Doc/whatsnew/2.5.rst:909 +#: whatsnew/2.5.rst:909 msgid "" "The :c:func:`PyArg_ParseTuple` and :c:func:`Py_BuildValue` functions have a " "new conversion code, ``n``, for :c:type:`Py_ssize_t`. :c:func:" @@ -9068,26 +9006,25 @@ msgid "" "including :file:`Python.h` to make them return :c:type:`Py_ssize_t`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:915 +#: whatsnew/2.5.rst:915 msgid "" ":pep:`353` has a section on conversion guidelines that extension authors " "should read to learn about supporting 64-bit platforms." msgstr "" -# ef59a94a89ef476e92447af5649aa9eb -#: ../src/Doc/whatsnew/2.5.rst:920 -msgid ":pep:`353` - Using ssize_t as the index type" +#: whatsnew/2.5.rst:921 +msgid "PEP 353 - Using ssize_t as the index type" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:922 +#: whatsnew/2.5.rst:922 msgid "PEP written and implemented by Martin von Löwis." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:930 +#: whatsnew/2.5.rst:930 msgid "PEP 357: The '__index__' method" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:932 +#: whatsnew/2.5.rst:932 msgid "" "The NumPy developers had a problem that could only be solved by adding a new " "special method, :meth:`__index__`. When using slice notation, as in " @@ -9098,7 +9035,7 @@ msgid "" "could be used as slice indexes." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:940 +#: whatsnew/2.5.rst:940 msgid "" "Slicing can't just use the existing :meth:`__int__` method because that " "method is also used to implement coercion to integers. If slicing used :" @@ -9106,14 +9043,14 @@ msgid "" "and that's clearly an undesirable behaviour." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:945 +#: whatsnew/2.5.rst:945 msgid "" "Instead, a new special method called :meth:`__index__` was added. It takes " "no arguments and returns an integer giving the slice index to use. For " "example::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:952 +#: whatsnew/2.5.rst:952 msgid "" "The return value must be either a Python integer or long integer. The " "interpreter will check that the type returned is correct, and raises a :exc:" @@ -9121,7 +9058,7 @@ msgid "" msgstr "" # c6fbe1c41df84f7e9fe66727428e6662 -#: ../src/Doc/whatsnew/2.5.rst:956 +#: whatsnew/2.5.rst:956 msgid "" "A corresponding :attr:`nb_index` slot was added to the C-level :c:type:" "`PyNumberMethods` structure to let C extensions implement this protocol. :c:" @@ -9129,22 +9066,21 @@ msgid "" "`__index__` function and retrieve its result." msgstr "" -# e988ae9b4dbc4faca8d66d99621e4ba6 -#: ../src/Doc/whatsnew/2.5.rst:963 -msgid ":pep:`357` - Allowing Any Object to be Used for Slicing" +#: whatsnew/2.5.rst:964 +msgid "PEP 357 - Allowing Any Object to be Used for Slicing" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:965 +#: whatsnew/2.5.rst:965 msgid "PEP written and implemented by Travis Oliphant." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:975 +#: whatsnew/2.5.rst:975 msgid "" "Here are all of the changes that Python 2.5 makes to the core Python " "language." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:977 +#: whatsnew/2.5.rst:977 msgid "" "The :class:`dict` type has a new hook for letting subclasses provide a " "default value when a key isn't contained in the dictionary. When a key isn't " @@ -9154,13 +9090,13 @@ msgid "" "returns zero for any missing key::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:992 +#: whatsnew/2.5.rst:992 msgid "" "Both 8-bit and Unicode strings have new :meth:`partition(sep)` and :meth:" "`rpartition(sep)` methods that simplify a common use case." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:995 +#: whatsnew/2.5.rst:995 msgid "" "The :meth:`find(S)` method is often used to get an index which is then used " "to slice the string and obtain the pieces that are before and after the " @@ -9173,26 +9109,26 @@ msgid "" "stands for 'reverse'." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1004 +#: whatsnew/2.5.rst:1004 msgid "Some examples::" msgstr "Quelques exemples ::" -#: ../src/Doc/whatsnew/2.5.rst:1017 +#: whatsnew/2.5.rst:1017 msgid "" "(Implemented by Fredrik Lundh following a suggestion by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1019 +#: whatsnew/2.5.rst:1019 msgid "" "The :meth:`startswith` and :meth:`endswith` methods of string types now " "accept tuples of strings to check for. ::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1025 +#: whatsnew/2.5.rst:1025 msgid "(Implemented by Georg Brandl following a suggestion by Tom Lynn.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1029 +#: whatsnew/2.5.rst:1029 msgid "" "The :func:`min` and :func:`max` built-in functions gained a ``key`` keyword " "parameter analogous to the ``key`` argument for :meth:`sort`. This " @@ -9202,11 +9138,11 @@ msgid "" "find the longest string in a list, you can do::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1042 +#: whatsnew/2.5.rst:1042 msgid "(Contributed by Steven Bethard and Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1044 +#: whatsnew/2.5.rst:1044 msgid "" "Two new built-in functions, :func:`any` and :func:`all`, evaluate whether an " "iterator contains any true or false values. :func:`any` returns :const:" @@ -9216,7 +9152,7 @@ msgid "" "Rossum, and implemented by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1051 +#: whatsnew/2.5.rst:1051 msgid "" "The result of a class's :meth:`__hash__` method can now be either a long " "integer or a regular integer. If a long integer is returned, the hash of " @@ -9226,7 +9162,7 @@ msgid "" "meth:`__hash__` methods (though this is discouraged)." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1060 +#: whatsnew/2.5.rst:1060 msgid "" "ASCII is now the default encoding for modules. It's now a syntax error if " "a module contains string literals with 8-bit characters but doesn't have an " @@ -9235,7 +9171,7 @@ msgid "" "you might add a line like this near the top of the source file::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1068 +#: whatsnew/2.5.rst:1068 msgid "" "A new warning, :class:`UnicodeWarning`, is triggered when you attempt to " "compare a Unicode string and an 8-bit string that can't be converted to " @@ -9243,7 +9179,7 @@ msgid "" "false::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1080 +#: whatsnew/2.5.rst:1080 msgid "" "Previously this would raise a :class:`UnicodeDecodeError` exception, but in " "2.5 this could result in puzzling problems when accessing a dictionary. If " @@ -9253,18 +9189,18 @@ msgid "" "in :file:`dictobject.c` that implements dictionaries." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1087 +#: whatsnew/2.5.rst:1087 msgid "" "Raising an exception for such a comparison is strictly correct, but the " "change might have broken code, so instead :class:`UnicodeWarning` was " "introduced." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1090 +#: whatsnew/2.5.rst:1090 msgid "(Implemented by Marc-André Lemburg.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1092 +#: whatsnew/2.5.rst:1092 msgid "" "One error that Python programmers sometimes make is forgetting to include " "an :file:`__init__.py` module in a package directory. Debugging this mistake " @@ -9277,28 +9213,28 @@ msgid "" "by Thomas Wouters.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1101 +#: whatsnew/2.5.rst:1101 msgid "" "The list of base classes in a class definition can now be empty. As an " "example, this is now legal::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1107 +#: whatsnew/2.5.rst:1107 msgid "(Implemented by Brett Cannon.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1115 +#: whatsnew/2.5.rst:1115 msgid "Interactive Interpreter Changes" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1117 +#: whatsnew/2.5.rst:1117 msgid "" "In the interactive interpreter, ``quit`` and ``exit`` have long been " "strings so that new users get a somewhat helpful message when they try to " "quit::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1123 +#: whatsnew/2.5.rst:1123 msgid "" "In Python 2.5, ``quit`` and ``exit`` are now objects that still produce " "string representations of themselves, but are also callable. Newbies who try " @@ -9306,14 +9242,14 @@ msgid "" "(Implemented by Georg Brandl.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1128 +#: whatsnew/2.5.rst:1128 msgid "" "The Python executable now accepts the standard long options :option:`--" "help` and :option:`--version`; on Windows, it also accepts the :option:`/?` " "option for displaying a help message. (Implemented by Georg Brandl.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1140 +#: whatsnew/2.5.rst:1140 msgid "" "Several of the optimizations were developed at the NeedForSpeed sprint, an " "event held in Reykjavik, Iceland, from May 21--28 2006. The sprint focused " @@ -9322,7 +9258,7 @@ msgid "" "sprint are specially marked in the following list." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1146 +#: whatsnew/2.5.rst:1146 msgid "" "When they were introduced in Python 2.4, the built-in :class:`set` and :" "class:`frozenset` types were built on top of Python's dictionary type. In " @@ -9331,7 +9267,7 @@ msgid "" "(Implemented by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1152 +#: whatsnew/2.5.rst:1152 msgid "" "The speed of some Unicode operations, such as finding substrings, string " "splitting, and character map encoding and decoding, has been improved. " @@ -9340,7 +9276,7 @@ msgid "" "Walter Dörwald and Martin von Löwis.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1160 +#: whatsnew/2.5.rst:1160 msgid "" "The :func:`long(str, base)` function is now faster on long digit strings " "because fewer intermediate results are calculated. The peak is for strings " @@ -9348,7 +9284,7 @@ msgid "" "(Contributed by Alan McIntyre and committed at the NeedForSpeed sprint.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1167 +#: whatsnew/2.5.rst:1167 msgid "" "It's now illegal to mix iterating over a file with ``for line in file`` and " "calling the file object's :meth:`read`/:meth:`readline`/:meth:`readlines` " @@ -9359,7 +9295,7 @@ msgid "" "method. (Implemented by Thomas Wouters.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1177 +#: whatsnew/2.5.rst:1177 msgid "" "The :mod:`struct` module now compiles structure format strings into an " "internal representation and caches this representation, yielding a 20% " @@ -9367,14 +9303,14 @@ msgid "" msgstr "" # d5120248c614478b9025911bdca63df6 -#: ../src/Doc/whatsnew/2.5.rst:1181 +#: whatsnew/2.5.rst:1181 msgid "" "The :mod:`re` module got a 1 or 2% speedup by switching to Python's " "allocator functions instead of the system's :c:func:`malloc` and :c:func:" "`free`. (Contributed by Jack Diederich at the NeedForSpeed sprint.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1185 +#: whatsnew/2.5.rst:1185 msgid "" "The code generator's peephole optimizer now performs simple constant folding " "in expressions. If you write something like ``a = 2+3``, the code generator " @@ -9382,7 +9318,7 @@ msgid "" "(Proposed and implemented by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1190 +#: whatsnew/2.5.rst:1190 msgid "" "Function calls are now faster because code objects now keep the most " "recently finished frame (a \"zombie frame\") in an internal field of the " @@ -9393,7 +9329,7 @@ msgid "" "Neal Norwitz.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1200 +#: whatsnew/2.5.rst:1200 msgid "" "Python's built-in exceptions are now new-style classes, a change that speeds " "up instantiation considerably. Exception handling in Python 2.5 is " @@ -9402,18 +9338,18 @@ msgid "" msgstr "" # 15a44b60eae44bde9404c7521ce64476 -#: ../src/Doc/whatsnew/2.5.rst:1205 +#: whatsnew/2.5.rst:1205 msgid "" "Importing now caches the paths tried, recording whether they exist or not " "so that the interpreter makes fewer :c:func:`open` and :c:func:`stat` calls " "on startup. (Contributed by Martin von Löwis and Georg Brandl.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1217 +#: whatsnew/2.5.rst:1217 msgid "New, Improved, and Removed Modules" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1219 +#: whatsnew/2.5.rst:1219 msgid "" "The standard library received many enhancements and bug fixes in Python 2.5. " "Here's a partial list of the most notable changes, sorted alphabetically by " @@ -9422,13 +9358,13 @@ msgid "" "details." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1224 +#: whatsnew/2.5.rst:1224 msgid "" "The :mod:`audioop` module now supports the a-LAW encoding, and the code for " "u-LAW encoding has been improved. (Contributed by Lars Immisch.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1227 +#: whatsnew/2.5.rst:1227 msgid "" "The :mod:`codecs` module gained support for incremental codecs. The :func:" "`codec.lookup` function now returns a :class:`CodecInfo` instance instead of " @@ -9442,7 +9378,7 @@ msgid "" "Dörwald.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1239 +#: whatsnew/2.5.rst:1239 msgid "" "The :mod:`collections` module gained a new type, :class:`defaultdict`, that " "subclasses the standard :class:`dict` type. The new type mostly behaves " @@ -9450,7 +9386,7 @@ msgid "" "automatically adding it to the dictionary for the requested key value." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1244 +#: whatsnew/2.5.rst:1244 msgid "" "The first argument to :class:`defaultdict`'s constructor is a factory " "function that gets called whenever a key is requested but not found. This " @@ -9459,15 +9395,15 @@ msgid "" "make an index of words based on their initial letter like this::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1260 +#: whatsnew/2.5.rst:1260 msgid "Printing ``index`` results in the following output::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1268 +#: whatsnew/2.5.rst:1268 msgid "(Contributed by Guido van Rossum.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1270 +#: whatsnew/2.5.rst:1270 msgid "" "The :class:`deque` double-ended queue type supplied by the :mod:" "`collections` module now has a :meth:`remove(value)` method that removes the " @@ -9475,14 +9411,14 @@ msgid "" "value isn't found. (Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1275 +#: whatsnew/2.5.rst:1275 msgid "" "New module: The :mod:`contextlib` module contains helper functions for use " "with the new ':keyword:`with`' statement. See section :ref:`contextlibmod` " "for more about this module." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1279 +#: whatsnew/2.5.rst:1279 msgid "" "New module: The :mod:`cProfile` module is a C implementation of the " "existing :mod:`profile` module that has much lower overhead. The module's " @@ -9493,7 +9429,7 @@ msgid "" "future versions of Python. (Contributed by Armin Rigo.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1287 +#: whatsnew/2.5.rst:1287 msgid "" "Also, the :mod:`pstats` module for analyzing the data measured by the " "profiler now supports directing the output to any file object by supplying a " @@ -9501,7 +9437,7 @@ msgid "" "Montanaro.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1291 +#: whatsnew/2.5.rst:1291 msgid "" "The :mod:`csv` module, which parses files in comma-separated value format, " "received several enhancements and a number of bugfixes. You can now set the " @@ -9513,7 +9449,7 @@ msgid "" "not the same as the number of records read." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1300 +#: whatsnew/2.5.rst:1300 msgid "" "The CSV parser is now stricter about multi-line quoted fields. Previously, " "if a line ended within a quoted field without a terminating newline " @@ -9525,11 +9461,11 @@ msgid "" "preserves the newline characters." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1308 +#: whatsnew/2.5.rst:1308 msgid "(Contributed by Skip Montanaro and Andrew McNamara.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1310 +#: whatsnew/2.5.rst:1310 msgid "" "The :class:`datetime` class in the :mod:`datetime` module now has a :meth:" "`strptime(string, format)` method for parsing date strings, contributed by " @@ -9537,7 +9473,7 @@ msgid "" "and :func:`time.strftime`::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1320 +#: whatsnew/2.5.rst:1320 msgid "" "The :meth:`SequenceMatcher.get_matching_blocks` method in the :mod:`difflib` " "module now guarantees to return a minimal list of blocks describing matching " @@ -9545,14 +9481,14 @@ msgid "" "matching elements into two list entries. (Enhancement by Tim Peters.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1325 +#: whatsnew/2.5.rst:1325 msgid "" "The :mod:`doctest` module gained a ``SKIP`` option that keeps an example " "from being executed at all. This is intended for code snippets that are " "usage examples intended for the reader and aren't actually test cases." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1329 +#: whatsnew/2.5.rst:1329 msgid "" "An *encoding* parameter was added to the :func:`testfile` function and the :" "class:`DocFileSuite` class to specify the file's encoding. This makes it " @@ -9560,14 +9496,14 @@ msgid "" "(Contributed by Bjorn Tillenius.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1336 +#: whatsnew/2.5.rst:1336 msgid "" "The :mod:`email` package has been updated to version 4.0. (Contributed by " "Barry Warsaw.)" msgstr "" # d89738fcfb01402488338d9950a4ab82 -#: ../src/Doc/whatsnew/2.5.rst:1344 +#: whatsnew/2.5.rst:1344 msgid "" "The :mod:`fileinput` module was made more flexible. Unicode filenames are " "now supported, and a *mode* parameter that defaults to ``\"r\"`` was added " @@ -9579,7 +9515,7 @@ msgid "" "(Contributed by Georg Brandl.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1353 +#: whatsnew/2.5.rst:1353 msgid "" "In the :mod:`gc` module, the new :func:`get_count` function returns a 3-" "tuple containing the current collection counts for the three GC " @@ -9590,7 +9526,7 @@ msgid "" "(Contributed by Barry Warsaw.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1360 +#: whatsnew/2.5.rst:1360 msgid "" "The :func:`nsmallest` and :func:`nlargest` functions in the :mod:`heapq` " "module now support a ``key`` keyword parameter similar to the one provided " @@ -9598,20 +9534,20 @@ msgid "" "example::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1374 +#: whatsnew/2.5.rst:1374 msgid "" "The :func:`itertools.islice` function now accepts ``None`` for the start and " "step arguments. This makes it more compatible with the attributes of slice " "objects, so that you can now write the following::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1383 +#: whatsnew/2.5.rst:1383 msgid "" "The :func:`format` function in the :mod:`locale` module has been modified " "and two new functions were added, :func:`format_string` and :func:`currency`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1386 +#: whatsnew/2.5.rst:1386 msgid "" "The :func:`format` function's *val* parameter could previously be a string " "as long as no more than one %char specifier appeared; now the parameter must " @@ -9621,24 +9557,24 @@ msgid "" "of three digits." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1392 +#: whatsnew/2.5.rst:1392 msgid "" "To format strings with multiple %char specifiers, use the new :func:" "`format_string` function that works like :func:`format` but also supports " "mixing %char specifiers with arbitrary text." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1396 +#: whatsnew/2.5.rst:1396 msgid "" "A new :func:`currency` function was also added that formats a number " "according to the current locale's settings." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1399 +#: whatsnew/2.5.rst:1399 msgid "(Contributed by Georg Brandl.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1403 +#: whatsnew/2.5.rst:1403 msgid "" "The :mod:`mailbox` module underwent a massive rewrite to add the capability " "to modify mailboxes in addition to reading them. A new set of classes that " @@ -9649,27 +9585,27 @@ msgid "" "into an mbox-format one::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1421 +#: whatsnew/2.5.rst:1421 msgid "" "(Contributed by Gregory K. Johnson. Funding was provided by Google's 2005 " "Summer of Code.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1424 +#: whatsnew/2.5.rst:1424 msgid "" "New module: the :mod:`msilib` module allows creating Microsoft Installer :" "file:`.msi` files and CAB files. Some support for reading the :file:`.msi` " "database is also included. (Contributed by Martin von Löwis.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1428 +#: whatsnew/2.5.rst:1428 msgid "" "The :mod:`nis` module now supports accessing domains other than the system " "default domain by supplying a *domain* argument to the :func:`nis.match` " "and :func:`nis.maps` functions. (Contributed by Ben Bell.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1432 +#: whatsnew/2.5.rst:1432 msgid "" "The :mod:`operator` module's :func:`itemgetter` and :func:`attrgetter` " "functions now support multiple fields. A call such as ``operator." @@ -9679,7 +9615,7 @@ msgid "" "fields. (Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1439 +#: whatsnew/2.5.rst:1439 msgid "" "The :mod:`optparse` module was updated to version 1.5.1 of the Optik " "library. The :class:`OptionParser` class gained an :attr:`epilog` attribute, " @@ -9688,7 +9624,7 @@ msgid "" "Ward.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1444 +#: whatsnew/2.5.rst:1444 msgid "" "The :mod:`os` module underwent several changes. The :attr:" "`stat_float_times` variable now defaults to true, meaning that :func:`os." @@ -9697,7 +9633,7 @@ msgid "" "second; not all systems support such precision.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1450 +#: whatsnew/2.5.rst:1450 msgid "" "Constants named :attr:`os.SEEK_SET`, :attr:`os.SEEK_CUR`, and :attr:`os." "SEEK_END` have been added; these are the parameters to the :func:`os.lseek` " @@ -9705,7 +9641,7 @@ msgid "" "`os.O_EXLOCK`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1455 +#: whatsnew/2.5.rst:1455 msgid "" "Two new functions, :func:`wait3` and :func:`wait4`, were added. They're " "similar the :func:`waitpid` function which waits for a child process to exit " @@ -9718,7 +9654,7 @@ msgid "" msgstr "" # e1750dab488d44e3b9a4374c8405db10 -#: ../src/Doc/whatsnew/2.5.rst:1464 +#: whatsnew/2.5.rst:1464 msgid "" "On FreeBSD, the :func:`os.stat` function now returns times with nanosecond " "resolution, and the returned object now has :attr:`st_gen` and :attr:" @@ -9726,7 +9662,7 @@ msgid "" "platform supports it. (Contributed by Antti Louko and Diego Pettenò.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1471 +#: whatsnew/2.5.rst:1471 msgid "" "The Python debugger provided by the :mod:`pdb` module can now store lists of " "commands to execute when a breakpoint is reached and execution stops. Once " @@ -9736,7 +9672,7 @@ msgid "" "``next``. (Contributed by Grégoire Dooms.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1480 +#: whatsnew/2.5.rst:1480 msgid "" "The :mod:`pickle` and :mod:`cPickle` modules no longer accept a return value " "of ``None`` from the :meth:`__reduce__` method; the method must return a " @@ -9744,14 +9680,14 @@ msgid "" "in Python 2.4, so this completes the removal of the feature." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1485 +#: whatsnew/2.5.rst:1485 msgid "" "The :mod:`pkgutil` module, containing various utility functions for finding " "packages, was enhanced to support PEP 302's import hooks and now also works " "for packages stored in ZIP-format archives. (Contributed by Phillip J. Eby.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1489 +#: whatsnew/2.5.rst:1489 msgid "" "The pybench benchmark suite by Marc-André Lemburg is now included in the :" "file:`Tools/pybench` directory. The pybench suite is an improvement on the " @@ -9762,13 +9698,13 @@ msgid "" "reducing the result to a single number as :file:`pystone.py` does." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1497 +#: whatsnew/2.5.rst:1497 msgid "" "The :mod:`pyexpat` module now uses version 2.0 of the Expat parser. " "(Contributed by Trent Mick.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1500 +#: whatsnew/2.5.rst:1500 msgid "" "The :class:`Queue` class provided by the :mod:`Queue` module gained two new " "methods. :meth:`join` blocks until all items in the queue have been " @@ -9778,14 +9714,14 @@ msgid "" "Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1506 +#: whatsnew/2.5.rst:1506 msgid "" "The old :mod:`regex` and :mod:`regsub` modules, which have been deprecated " "ever since Python 2.0, have finally been deleted. Other deleted modules: :" "mod:`statcache`, :mod:`tzparse`, :mod:`whrandom`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1510 +#: whatsnew/2.5.rst:1510 msgid "" "Also deleted: the :file:`lib-old` directory, which includes ancient modules " "such as :mod:`dircmp` and :mod:`ni`, was removed. :file:`lib-old` wasn't on " @@ -9793,14 +9729,14 @@ msgid "" "directory to ``sys.path``, this removal shouldn't affect your code." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1515 +#: whatsnew/2.5.rst:1515 msgid "" "The :mod:`rlcompleter` module is no longer dependent on importing the :mod:" "`readline` module and therefore now works on non-Unix platforms. (Patch from " "Robert Kiendl.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1521 +#: whatsnew/2.5.rst:1521 msgid "" "The :mod:`SimpleXMLRPCServer` and :mod:`DocXMLRPCServer` classes now have " "a :attr:`rpc_paths` attribute that constrains XML-RPC operations to a " @@ -9809,7 +9745,7 @@ msgid "" "this path checking." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1528 +#: whatsnew/2.5.rst:1528 msgid "" "The :mod:`socket` module now supports :const:`AF_NETLINK` sockets on Linux, " "thanks to a patch from Philippe Biondi. Netlink sockets are a Linux-" @@ -9819,7 +9755,7 @@ msgid "" "represented as a tuple of 2 integers, ``(pid, group_mask)``." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1535 +#: whatsnew/2.5.rst:1535 msgid "" "Two new methods on socket objects, :meth:`recv_into(buffer)` and :meth:" "`recvfrom_into(buffer)`, store the received data in an object that supports " @@ -9827,20 +9763,20 @@ msgid "" "you can put the data directly into an array or a memory-mapped file." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1540 +#: whatsnew/2.5.rst:1540 msgid "" "Socket objects also gained :meth:`getfamily`, :meth:`gettype`, and :meth:" "`getproto` accessor methods to retrieve the family, type, and protocol " "values for the socket." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1544 +#: whatsnew/2.5.rst:1544 msgid "" "New module: the :mod:`spwd` module provides functions for accessing the " "shadow password database on systems that support shadow passwords." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1547 +#: whatsnew/2.5.rst:1547 msgid "" "The :mod:`struct` is now faster because it compiles format strings into :" "class:`Struct` objects with :meth:`pack` and :meth:`unpack` methods. This " @@ -9850,7 +9786,7 @@ msgid "" "them. Or you can use :class:`Struct` instances directly::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1559 +#: whatsnew/2.5.rst:1559 msgid "" "You can also pack and unpack data to and from buffer objects directly using " "the :meth:`pack_into(buffer, offset, v1, v2, ...)` and :meth:" @@ -9858,14 +9794,14 @@ msgid "" "into an array or a memory- mapped file." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1564 +#: whatsnew/2.5.rst:1564 msgid "" "(:class:`Struct` objects were implemented by Bob Ippolito at the " "NeedForSpeed sprint. Support for buffer objects was added by Martin Blais, " "also at the NeedForSpeed sprint.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1568 +#: whatsnew/2.5.rst:1568 msgid "" "The Python developers switched from CVS to Subversion during the 2.5 " "development process. Information about the exact build version is available " @@ -9875,7 +9811,7 @@ msgid "" msgstr "" # b9db240cbceb4310a219ac67963ce3cf -#: ../src/Doc/whatsnew/2.5.rst:1574 +#: whatsnew/2.5.rst:1574 msgid "" "This information is also available to C extensions via the :c:func:" "`Py_GetBuildInfo` function that returns a string of build information like " @@ -9883,7 +9819,7 @@ msgid "" "Barry Warsaw.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1579 +#: whatsnew/2.5.rst:1579 msgid "" "Another new function, :func:`sys._current_frames`, returns the current stack " "frames for all running threads as a dictionary mapping thread identifiers to " @@ -9891,7 +9827,7 @@ msgid "" "function is called. (Contributed by Tim Peters.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1584 +#: whatsnew/2.5.rst:1584 msgid "" "The :class:`TarFile` class in the :mod:`tarfile` module now has an :meth:" "`extractall` method that extracts all members from the archive into the " @@ -9900,13 +9836,13 @@ msgid "" "members." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1589 +#: whatsnew/2.5.rst:1589 msgid "" "The compression used for a tarfile opened in stream mode can now be " "autodetected using the mode ``'r|*'``. (Contributed by Lars Gustäbel.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1594 +#: whatsnew/2.5.rst:1594 msgid "" "The :mod:`threading` module now lets you set the stack size used when new " "threads are created. The :func:`stack_size([*size*])` function returns the " @@ -9915,14 +9851,14 @@ msgid "" "Windows, POSIX threading, and OS/2 all do. (Contributed by Andrew MacIntyre.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1602 +#: whatsnew/2.5.rst:1602 msgid "" "The :mod:`unicodedata` module has been updated to use version 4.1.0 of the " "Unicode character database. Version 3.2.0 is required by some " "specifications, so it's still available as :attr:`unicodedata.ucd_3_2_0`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1606 +#: whatsnew/2.5.rst:1606 msgid "" "New module: the :mod:`uuid` module generates universally unique " "identifiers (UUIDs) according to :rfc:`4122`. The RFC defines several " @@ -9934,11 +9870,11 @@ msgid "" "module.) ::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1631 +#: whatsnew/2.5.rst:1631 msgid "(Contributed by Ka-Ping Yee.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1633 +#: whatsnew/2.5.rst:1633 msgid "" "The :mod:`weakref` module's :class:`WeakKeyDictionary` and :class:" "`WeakValueDictionary` types gained new methods for iterating over the weak " @@ -9948,7 +9884,7 @@ msgid "" "`WeakValueDictionary`. (Contributed by Fred L. Drake, Jr.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1640 +#: whatsnew/2.5.rst:1640 msgid "" "The :mod:`webbrowser` module received a number of enhancements. It's now " "usable as a script with ``python -m webbrowser``, taking a URL as the " @@ -9962,7 +9898,7 @@ msgid "" "by Oleg Broytmann and Georg Brandl.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1652 +#: whatsnew/2.5.rst:1652 msgid "" "The :mod:`xmlrpclib` module now supports returning :class:`datetime` " "objects for the XML-RPC date type. Supply ``use_datetime=True`` to the :" @@ -9970,14 +9906,14 @@ msgid "" "feature. (Contributed by Skip Montanaro.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1659 +#: whatsnew/2.5.rst:1659 msgid "" "The :mod:`zipfile` module now supports the ZIP64 version of the format, " "meaning that a .zip archive can now be larger than 4 GiB and can contain " "individual files larger than 4 GiB. (Contributed by Ronald Oussoren.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1665 +#: whatsnew/2.5.rst:1665 msgid "" "The :mod:`zlib` module's :class:`Compress` and :class:`Decompress` objects " "now support a :meth:`copy` method that makes a copy of the object's " @@ -9985,11 +9921,11 @@ msgid "" "object. (Contributed by Chris AtLee.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1678 +#: whatsnew/2.5.rst:1678 msgid "The ctypes package" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1680 +#: whatsnew/2.5.rst:1680 msgid "" "The :mod:`ctypes` package, written by Thomas Heller, has been added to the " "standard library. :mod:`ctypes` lets you call arbitrary functions in " @@ -9998,7 +9934,7 @@ msgid "" "functions in them. The :mod:`ctypes` package is much fancier." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1686 +#: whatsnew/2.5.rst:1686 msgid "" "To load a shared library or DLL, you must create an instance of the :class:" "`CDLL` class and provide the name or path of the shared library or DLL. Once " @@ -10007,7 +9943,7 @@ msgid "" msgstr "" # 3d3bce29060846168b4a200db19ed169 -#: ../src/Doc/whatsnew/2.5.rst:1696 +#: whatsnew/2.5.rst:1696 msgid "" "Type constructors for the various C types are provided: :func:`c_int`, :func:" "`c_float`, :func:`c_double`, :func:`c_char_p` (equivalent to :c:type:`char " @@ -10019,7 +9955,7 @@ msgid "" "interpreter crashing with a segmentation fault.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1705 +#: whatsnew/2.5.rst:1705 msgid "" "You shouldn't use :func:`c_char_p` with a Python string when the C function " "will be modifying the memory area, because Python strings are supposed to " @@ -10027,14 +9963,14 @@ msgid "" "modifiable memory area, use :func:`create_string_buffer`::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1714 +#: whatsnew/2.5.rst:1714 msgid "" "C functions are assumed to return integers, but you can set the :attr:" "`restype` attribute of the function object to change this::" msgstr "" # 8853e016c7e5459e995d54f0a4cf52c2 -#: ../src/Doc/whatsnew/2.5.rst:1723 +#: whatsnew/2.5.rst:1723 msgid "" ":mod:`ctypes` also provides a wrapper for Python's C API as the ``ctypes." "pythonapi`` object. This object does *not* release the global interpreter " @@ -10044,13 +9980,13 @@ msgid "" "usage::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1736 +#: whatsnew/2.5.rst:1736 msgid "" "Don't forget to use :class:`py_object()`; if it's omitted you end up with a " "segmentation fault." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1739 +#: whatsnew/2.5.rst:1739 msgid "" ":mod:`ctypes` has been around for a while, but people still write and " "distribution hand-coded extension modules because you can't rely on :mod:" @@ -10060,23 +9996,23 @@ msgid "" msgstr "" # 436556085e924974bcb0ead093117018 -#: ../src/Doc/whatsnew/2.5.rst:1748 +#: whatsnew/2.5.rst:1749 msgid "http://starship.python.net/crew/theller/ctypes/" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1749 +#: whatsnew/2.5.rst:1749 msgid "The ctypes web page, with a tutorial, reference, and FAQ." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1751 +#: whatsnew/2.5.rst:1751 msgid "The documentation for the :mod:`ctypes` module." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1759 +#: whatsnew/2.5.rst:1759 msgid "The ElementTree package" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1761 +#: whatsnew/2.5.rst:1761 msgid "" "A subset of Fredrik Lundh's ElementTree library for processing XML has been " "added to the standard library as :mod:`xml.etree`. The available modules " @@ -10085,7 +10021,7 @@ msgid "" "included." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1767 +#: whatsnew/2.5.rst:1767 msgid "" "The rest of this section will provide a brief overview of using ElementTree. " "Full documentation for ElementTree is available at http://effbot.org/zone/" @@ -10093,7 +10029,7 @@ msgid "" msgstr "" # 87602d6122a24ba0ab962019a7200afa -#: ../src/Doc/whatsnew/2.5.rst:1771 +#: whatsnew/2.5.rst:1771 msgid "" "ElementTree represents an XML document as a tree of element nodes. The text " "content of the document is stored as the :attr:`text` and :attr:`tail` " @@ -10102,20 +10038,20 @@ msgid "" "node, including :class:`TextNode`.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1777 +#: whatsnew/2.5.rst:1777 msgid "" "The most commonly used parsing function is :func:`parse`, that takes either " "a string (assumed to contain a filename) or a file-like object and returns " "an :class:`ElementTree` instance::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1789 +#: whatsnew/2.5.rst:1789 msgid "" "Once you have an :class:`ElementTree` instance, you can call its :meth:" "`getroot` method to get the root :class:`Element` node." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1792 +#: whatsnew/2.5.rst:1792 msgid "" "There's also an :func:`XML` function that takes a string literal and returns " "an :class:`Element` node (not an :class:`ElementTree`). This function " @@ -10123,128 +10059,128 @@ msgid "" "convenience of an XML literal::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1802 +#: whatsnew/2.5.rst:1802 msgid "" "Each XML element supports some dictionary-like and some list-like access " "methods. Dictionary-like operations are used to access attribute values, " "and list-like operations are used to access child nodes." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1807 +#: whatsnew/2.5.rst:1807 msgid "Result" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1809 +#: whatsnew/2.5.rst:1809 msgid "``elem[n]``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1809 +#: whatsnew/2.5.rst:1809 msgid "Returns n'th child element." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1811 +#: whatsnew/2.5.rst:1811 msgid "``elem[m:n]``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1811 +#: whatsnew/2.5.rst:1811 msgid "Returns list of m'th through n'th child elements." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1814 +#: whatsnew/2.5.rst:1814 msgid "``len(elem)``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1814 +#: whatsnew/2.5.rst:1814 msgid "Returns number of child elements." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1816 +#: whatsnew/2.5.rst:1816 msgid "``list(elem)``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1816 +#: whatsnew/2.5.rst:1816 msgid "Returns list of child elements." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1818 +#: whatsnew/2.5.rst:1818 msgid "``elem.append(elem2)``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1818 +#: whatsnew/2.5.rst:1818 msgid "Adds *elem2* as a child." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1820 +#: whatsnew/2.5.rst:1820 msgid "``elem.insert(index, elem2)``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1820 +#: whatsnew/2.5.rst:1820 msgid "Inserts *elem2* at the specified location." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1822 +#: whatsnew/2.5.rst:1822 msgid "``del elem[n]``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1822 +#: whatsnew/2.5.rst:1822 msgid "Deletes n'th child element." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1824 +#: whatsnew/2.5.rst:1824 msgid "``elem.keys()``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1824 +#: whatsnew/2.5.rst:1824 msgid "Returns list of attribute names." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1826 +#: whatsnew/2.5.rst:1826 msgid "``elem.get(name)``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1826 +#: whatsnew/2.5.rst:1826 msgid "Returns value of attribute *name*." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1828 +#: whatsnew/2.5.rst:1828 msgid "``elem.set(name, value)``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1828 +#: whatsnew/2.5.rst:1828 msgid "Sets new value for attribute *name*." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1830 +#: whatsnew/2.5.rst:1830 msgid "``elem.attrib``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1830 +#: whatsnew/2.5.rst:1830 msgid "Retrieves the dictionary containing attributes." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1833 +#: whatsnew/2.5.rst:1833 msgid "``del elem.attrib[name]``" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1833 +#: whatsnew/2.5.rst:1833 msgid "Deletes attribute *name*." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1836 +#: whatsnew/2.5.rst:1836 msgid "" "Comments and processing instructions are also represented as :class:" "`Element` nodes. To check if a node is a comment or processing " "instructions::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1844 +#: whatsnew/2.5.rst:1844 msgid "" "To generate XML output, you should call the :meth:`ElementTree.write` " "method. Like :func:`parse`, it can take either a string or a file-like " "object::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1854 +#: whatsnew/2.5.rst:1854 msgid "" "(Caution: the default encoding used for output is ASCII. For general XML " "work, where an element's name may contain arbitrary Unicode characters, " @@ -10254,26 +10190,26 @@ msgid "" "handle any Unicode character.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1861 +#: whatsnew/2.5.rst:1861 msgid "" "This section is only a partial description of the ElementTree interfaces. " "Please read the package's official documentation for more details." msgstr "" # e5456267b8bb4926aeb8a5e742e5ba19 -#: ../src/Doc/whatsnew/2.5.rst:1866 +#: whatsnew/2.5.rst:1867 msgid "http://effbot.org/zone/element-index.htm" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1868 +#: whatsnew/2.5.rst:1868 msgid "Official documentation for ElementTree." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1876 +#: whatsnew/2.5.rst:1876 msgid "The hashlib package" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1878 +#: whatsnew/2.5.rst:1878 msgid "" "A new :mod:`hashlib` module, written by Gregory P. Smith, has been added to " "replace the :mod:`md5` and :mod:`sha` modules. :mod:`hashlib` adds support " @@ -10282,7 +10218,7 @@ msgid "" "implementations of algorithms." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1884 +#: whatsnew/2.5.rst:1884 msgid "" "The old :mod:`md5` and :mod:`sha` modules still exist as wrappers around " "hashlib to preserve backwards compatibility. The new module's interface is " @@ -10291,7 +10227,7 @@ msgid "" "hashing objects are named differently. ::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1913 +#: whatsnew/2.5.rst:1913 msgid "" "Once a hash object has been created, its methods are the same as before: :" "meth:`update(string)` hashes the specified string into the current digest " @@ -10300,22 +10236,22 @@ msgid "" "hashing object with the same digest state." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1922 +#: whatsnew/2.5.rst:1922 msgid "The documentation for the :mod:`hashlib` module." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1930 +#: whatsnew/2.5.rst:1930 msgid "The sqlite3 package" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1932 +#: whatsnew/2.5.rst:1932 msgid "" "The pysqlite module (http://www.pysqlite.org), a wrapper for the SQLite " "embedded database, has been added to the standard library under the package " "name :mod:`sqlite3`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1936 +#: whatsnew/2.5.rst:1936 msgid "" "SQLite is a C library that provides a lightweight disk-based database that " "doesn't require a separate server process and allows accessing the database " @@ -10325,13 +10261,13 @@ msgid "" "PostgreSQL or Oracle." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1943 +#: whatsnew/2.5.rst:1943 msgid "" "pysqlite was written by Gerhard Häring and provides a SQL interface " "compliant with the DB-API 2.0 specification described by :pep:`249`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1946 +#: whatsnew/2.5.rst:1946 msgid "" "If you're compiling the Python source yourself, note that the source tree " "doesn't include the SQLite code, only the wrapper module. You'll need to " @@ -10340,26 +10276,26 @@ msgid "" "available." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1951 +#: whatsnew/2.5.rst:1951 msgid "" "To use the module, you must first create a :class:`Connection` object that " "represents the database. Here the data will be stored in the :file:`/tmp/" "example` file::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1957 +#: whatsnew/2.5.rst:1957 msgid "" "You can also supply the special name ``:memory:`` to create a database in " "RAM." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1959 +#: whatsnew/2.5.rst:1959 msgid "" "Once you have a :class:`Connection`, you can create a :class:`Cursor` " "object and call its :meth:`execute` method to perform SQL commands::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1973 +#: whatsnew/2.5.rst:1973 msgid "" "Usually your SQL operations will need to use values from Python variables. " "You shouldn't assemble your query using Python's string operations because " @@ -10367,7 +10303,7 @@ msgid "" "attack." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1977 +#: whatsnew/2.5.rst:1977 msgid "" "Instead, use the DB-API's parameter substitution. Put ``?`` as a " "placeholder wherever you want to use a value, and then provide a tuple of " @@ -10376,7 +10312,7 @@ msgid "" "``:1``.) For example::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:1997 +#: whatsnew/2.5.rst:1997 msgid "" "To retrieve data after executing a SELECT statement, you can either treat " "the cursor as an iterator, call the cursor's :meth:`fetchone` method to " @@ -10384,54 +10320,53 @@ msgid "" "the matching rows." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2002 +#: whatsnew/2.5.rst:2002 msgid "This example uses the iterator form::" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2015 +#: whatsnew/2.5.rst:2015 msgid "" "For more information about the SQL dialect supported by SQLite, see http://" "www.sqlite.org." msgstr "" # 28bd56b521c643379873d250bce3185c -#: ../src/Doc/whatsnew/2.5.rst:2021 +#: whatsnew/2.5.rst:2022 msgid "http://www.pysqlite.org" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2022 +#: whatsnew/2.5.rst:2022 msgid "The pysqlite web page." msgstr "" # c7b6fbf1cd804fecaaec1ccffb03ed54 -#: ../src/Doc/whatsnew/2.5.rst:2025 +#: whatsnew/2.5.rst:2026 msgid "http://www.sqlite.org" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2025 +#: whatsnew/2.5.rst:2025 msgid "" "The SQLite web page; the documentation describes the syntax and the " "available data types for the supported SQL dialect." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2028 +#: whatsnew/2.5.rst:2028 msgid "The documentation for the :mod:`sqlite3` module." msgstr "" -# 600a74cd6fae439aa4359e637b6ca3e2 -#: ../src/Doc/whatsnew/2.5.rst:2029 -msgid ":pep:`249` - Database API Specification 2.0" +#: whatsnew/2.5.rst:2030 +msgid "PEP 249 - Database API Specification 2.0" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2031 +#: whatsnew/2.5.rst:2031 msgid "PEP written by Marc-André Lemburg." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2039 +#: whatsnew/2.5.rst:2039 msgid "The wsgiref package" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2041 +#: whatsnew/2.5.rst:2041 msgid "" "The Web Server Gateway Interface (WSGI) v1.0 defines a standard interface " "between web servers and Python web applications and is described in :pep:" @@ -10439,7 +10374,7 @@ msgid "" "specification." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2048 +#: whatsnew/2.5.rst:2048 msgid "" "The package includes a basic HTTP server that will run a WSGI application; " "this server is useful for debugging but isn't intended for production use. " @@ -10447,31 +10382,30 @@ msgid "" msgstr "" # 408323c9907b4d0a9b95c8b61d85c287 -#: ../src/Doc/whatsnew/2.5.rst:2067 +#: whatsnew/2.5.rst:2068 msgid "http://www.wsgi.org" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2068 +#: whatsnew/2.5.rst:2068 msgid "A central web site for WSGI-related resources." msgstr "" -# bb3e825577ea481c9cc484c15fa7f96b -#: ../src/Doc/whatsnew/2.5.rst:2069 -msgid ":pep:`333` - Python Web Server Gateway Interface v1.0" +#: whatsnew/2.5.rst:2070 +msgid "PEP 333 - Python Web Server Gateway Interface v1.0" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2071 +#: whatsnew/2.5.rst:2071 msgid "PEP written by Phillip J. Eby." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2083 +#: whatsnew/2.5.rst:2083 msgid "" "The Python source tree was converted from CVS to Subversion, in a complex " "migration procedure that was supervised and flawlessly carried out by Martin " "von Löwis. The procedure was developed as :pep:`347`." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2087 +#: whatsnew/2.5.rst:2087 msgid "" "Coverity, a company that markets a source code analysis tool called Prevent, " "provided the results of their examination of the Python source code. The " @@ -10481,7 +10415,7 @@ msgid "" msgstr "" # be7c9b816d234f39a2b3ac047aa80625 -#: ../src/Doc/whatsnew/2.5.rst:2093 +#: whatsnew/2.5.rst:2093 msgid "" "The largest change to the C API came from :pep:`353`, which modifies the " "interpreter to use a :c:type:`Py_ssize_t` type definition instead of :c:type:" @@ -10489,7 +10423,7 @@ msgid "" "change." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2098 +#: whatsnew/2.5.rst:2098 msgid "" "The design of the bytecode compiler has changed a great deal, no longer " "generating bytecode by traversing the parse tree. Instead the parse tree is " @@ -10497,7 +10431,7 @@ msgid "" "syntax tree that's traversed to produce the bytecode." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2103 +#: whatsnew/2.5.rst:2103 msgid "" "It's possible for Python code to obtain AST objects by using the :func:" "`compile` built-in and specifying ``_ast.PyCF_ONLY_AST`` as the value of " @@ -10505,7 +10439,7 @@ msgid "" msgstr "" # 16fa4d6331f64b3fa184bb38e3a4630a -#: ../src/Doc/whatsnew/2.5.rst:2116 +#: whatsnew/2.5.rst:2116 msgid "" "No official documentation has been written for the AST code yet, but :pep:" "`339` discusses the design. To start learning about the code, read the " @@ -10519,7 +10453,7 @@ msgid "" "questions on python-dev." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2126 +#: whatsnew/2.5.rst:2126 msgid "" "The AST code was developed under Jeremy Hylton's management, and implemented " "by (in alphabetical order) Brett Cannon, Nick Coghlan, Grant Edwards, John " @@ -10528,7 +10462,7 @@ msgid "" "such as PyCon." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2135 +#: whatsnew/2.5.rst:2135 msgid "" "Evan Jones's patch to obmalloc, first described in a talk at PyCon DC 2005, " "was applied. Python 2.4 allocated small objects in 256K-sized arenas, but " @@ -10540,7 +10474,7 @@ msgid "" msgstr "" # 8ea529d07a2c41d88cf8c41ec9cdbfe7 -#: ../src/Doc/whatsnew/2.5.rst:2143 +#: whatsnew/2.5.rst:2143 msgid "" "Note that this change means extension modules must be more careful when " "allocating memory. Python's API has many different functions for allocating " @@ -10552,7 +10486,7 @@ msgid "" msgstr "" # 5dd3ab361b1c4b729f37537fa09a3440 -#: ../src/Doc/whatsnew/2.5.rst:2151 +#: whatsnew/2.5.rst:2151 msgid "" "Previously these different families all reduced to the platform's :c:func:" "`malloc` and :c:func:`free` functions. This meant it didn't matter if you " @@ -10564,7 +10498,7 @@ msgid "" msgstr "" # a614c73637b24c21b6c35647199cca66 -#: ../src/Doc/whatsnew/2.5.rst:2158 +#: whatsnew/2.5.rst:2158 msgid "" "The built-in set types now have an official C API. Call :c:func:`PySet_New` " "and :c:func:`PyFrozenSet_New` to create a new set, :c:func:`PySet_Add` and :" @@ -10574,7 +10508,7 @@ msgid "" msgstr "" # a10c13ff90804ac9a25e7484b276440f -#: ../src/Doc/whatsnew/2.5.rst:2164 +#: whatsnew/2.5.rst:2164 msgid "" "C code can now obtain information about the exact revision of the Python " "interpreter by calling the :c:func:`Py_GetBuildInfo` function that returns " @@ -10583,7 +10517,7 @@ msgid "" msgstr "" # f265896c16084a17a80c42d29225c5cc -#: ../src/Doc/whatsnew/2.5.rst:2169 +#: whatsnew/2.5.rst:2169 msgid "" "Two new macros can be used to indicate C functions that are local to the " "current file so that a faster calling convention can be used. :c:func:" @@ -10597,14 +10531,14 @@ msgid "" msgstr "" # c44153dc025143f69cf9ef610a172c31 -#: ../src/Doc/whatsnew/2.5.rst:2180 +#: whatsnew/2.5.rst:2180 msgid "" ":c:func:`PyErr_NewException(name, base, dict)` can now accept a tuple of " "base classes as its *base* argument. (Contributed by Georg Brandl.)" msgstr "" # 9a44d20f34024a9481f4403ac3126174 -#: ../src/Doc/whatsnew/2.5.rst:2183 +#: whatsnew/2.5.rst:2183 msgid "" "The :c:func:`PyErr_Warn` function for issuing warnings is now deprecated in " "favour of :c:func:`PyErr_WarnEx(category, message, stacklevel)` which lets " @@ -10613,7 +10547,7 @@ msgid "" "2 is the function above that, and so forth. (Added by Neal Norwitz.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2189 +#: whatsnew/2.5.rst:2189 msgid "" "The CPython interpreter is still written in C, but the code can now be " "compiled with a C++ compiler without errors. (Implemented by Anthony " @@ -10621,7 +10555,7 @@ msgid "" msgstr "" # 5e6709ad2ebe41b385b59b26197b149d -#: ../src/Doc/whatsnew/2.5.rst:2193 +#: whatsnew/2.5.rst:2193 msgid "" "The :c:func:`PyRange_New` function was removed. It was never documented, " "never used in the core code, and had dangerously lax error checking. In the " @@ -10630,13 +10564,13 @@ msgid "" msgstr "" # c13516f772bd43edb3fa1dd45a802057 -#: ../src/Doc/whatsnew/2.5.rst:2209 +#: whatsnew/2.5.rst:2209 msgid "" "MacOS X (10.3 and higher): dynamic loading of modules now uses the :c:func:" "`dlopen` function instead of MacOS-specific functions." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2212 +#: whatsnew/2.5.rst:2212 msgid "" "MacOS X: an :option:`--enable-universalsdk` switch was added to the :program:" "`configure` script that compiles the interpreter as a universal binary able " @@ -10644,19 +10578,19 @@ msgid "" "Oussoren; :issue:`2573`.)" msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2217 +#: whatsnew/2.5.rst:2217 msgid "" "Windows: :file:`.dll` is no longer supported as a filename extension for " "extension modules. :file:`.pyd` is now the only filename extension that " "will be searched for." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2227 +#: whatsnew/2.5.rst:2227 #, fuzzy msgid "Porting to Python 2.5" msgstr "Portage vers Python 3.2" -#: ../src/Doc/whatsnew/2.5.rst:2232 +#: whatsnew/2.5.rst:2232 msgid "" "ASCII is now the default encoding for modules. It's now a syntax error if " "a module contains string literals with 8-bit characters but doesn't have an " @@ -10664,14 +10598,14 @@ msgid "" "error." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2237 +#: whatsnew/2.5.rst:2237 msgid "" "Previously, the :attr:`gi_frame` attribute of a generator was always a frame " "object. Because of the :pep:`342` changes described in section :ref:" "`pep-342`, it's now possible for :attr:`gi_frame` to be ``None``." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2241 +#: whatsnew/2.5.rst:2241 msgid "" "A new warning, :class:`UnicodeWarning`, is triggered when you attempt to " "compare a Unicode string and an 8-bit string that can't be converted to " @@ -10679,7 +10613,7 @@ msgid "" "raise a :class:`UnicodeDecodeError` exception." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2246 +#: whatsnew/2.5.rst:2246 msgid "" "Library: the :mod:`csv` module is now stricter about multi-line quoted " "fields. If your files contain newlines embedded within fields, the input " @@ -10687,7 +10621,7 @@ msgid "" "characters." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2250 +#: whatsnew/2.5.rst:2250 msgid "" "Library: the :mod:`locale` module's :func:`format` function's would " "previously accept any string as long as no more than one %char specifier " @@ -10695,7 +10629,7 @@ msgid "" "with no surrounding text." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2255 +#: whatsnew/2.5.rst:2255 msgid "" "Library: The :mod:`pickle` and :mod:`cPickle` modules no longer accept a " "return value of ``None`` from the :meth:`__reduce__` method; the method must " @@ -10703,7 +10637,7 @@ msgid "" "deprecated *bin* keyword parameter." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2260 +#: whatsnew/2.5.rst:2260 msgid "" "Library: The :mod:`SimpleXMLRPCServer` and :mod:`DocXMLRPCServer` classes " "now have a :attr:`rpc_paths` attribute that constrains XML-RPC operations to " @@ -10713,7 +10647,7 @@ msgid "" msgstr "" # 1a41165f43b64ba89028c1e74dce4e66 -#: ../src/Doc/whatsnew/2.5.rst:2266 +#: whatsnew/2.5.rst:2266 msgid "" "C API: Many functions now use :c:type:`Py_ssize_t` instead of :c:type:`int` " "to allow processing more data on 64-bit machines. Extension code may need " @@ -10722,7 +10656,7 @@ msgid "" msgstr "" # c1b1ba3ca0544ca4994e3f8508cb6413 -#: ../src/Doc/whatsnew/2.5.rst:2271 +#: whatsnew/2.5.rst:2271 msgid "" "C API: The obmalloc changes mean that you must be careful to not mix usage " "of the :c:func:`PyMem_\\*` and :c:func:`PyObject_\\*` families of functions. " @@ -10730,7 +10664,7 @@ msgid "" "the corresponding family's :c:func:`\\*_Free` function." msgstr "" -#: ../src/Doc/whatsnew/2.5.rst:2282 +#: whatsnew/2.5.rst:2282 msgid "" "The author would like to thank the following people for offering " "suggestions, corrections and assistance with various drafts of this article: " @@ -10741,22 +10675,22 @@ msgid "" "Wouters." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3 +#: whatsnew/2.6.rst:3 #, fuzzy msgid "What's New in Python 2.6" msgstr "Nouveautés de Python 2.0" -#: ../src/Doc/whatsnew/2.6.rst:7 ../src/Doc/whatsnew/2.7.rst:5 +#: whatsnew/2.6.rst:7 whatsnew/2.7.rst:5 msgid "A.M. Kuchling (amk at amk.ca)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:50 +#: whatsnew/2.6.rst:50 msgid "" "This article explains the new features in Python 2.6, released on October 1 " "2008. The release schedule is described in :pep:`361`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:53 +#: whatsnew/2.6.rst:53 msgid "" "The major theme of Python 2.6 is preparing the migration path to Python 3.0, " "a major redesign of the language. Whenever possible, Python 2.6 " @@ -10767,14 +10701,14 @@ msgid "" "`-3` switch to warn about usages that will become unsupported in 3.0." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:62 +#: whatsnew/2.6.rst:62 msgid "" "Some significant new packages have been added to the standard library, such " "as the :mod:`multiprocessing` and :mod:`json` modules, but there aren't many " "new features that aren't related to Python 3.0 in some way." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:67 +#: whatsnew/2.6.rst:67 msgid "" "Python 2.6 also sees a number of improvements and bugfixes throughout the " "source. A search through the change logs finds there were 259 patches " @@ -10782,7 +10716,7 @@ msgid "" "likely to be underestimates." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:72 +#: whatsnew/2.6.rst:72 msgid "" "This article doesn't attempt to provide a complete specification of the new " "features, but instead provides a convenient overview. For full details, you " @@ -10792,18 +10726,18 @@ msgid "" "the bug/patch item for each change." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:88 +#: whatsnew/2.6.rst:88 msgid "Python 3.0" msgstr "Python 3.0" -#: ../src/Doc/whatsnew/2.6.rst:90 +#: whatsnew/2.6.rst:90 msgid "" "The development cycle for Python versions 2.6 and 3.0 was synchronized, with " "the alpha and beta releases for both versions being made on the same days. " "The development of 3.0 has influenced many features in 2.6." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:95 +#: whatsnew/2.6.rst:95 msgid "" "Python 3.0 is a far-ranging redesign of Python that breaks compatibility " "with the 2.x series. This means that existing Python code will need some " @@ -10814,22 +10748,22 @@ msgid "" "derived features are:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:104 +#: whatsnew/2.6.rst:104 msgid "" "A :meth:`__complex__` method for converting objects to a complex number." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:105 +#: whatsnew/2.6.rst:105 msgid "Alternate syntax for catching exceptions: ``except TypeError as exc``." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:106 +#: whatsnew/2.6.rst:106 msgid "" "The addition of :func:`functools.reduce` as a synonym for the built-in :func:" "`reduce` function." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:109 +#: whatsnew/2.6.rst:109 msgid "" "Python 3.0 adds several new built-in functions and changes the semantics of " "some existing builtins. Functions that are new in 3.0 such as :func:`bin` " @@ -10840,7 +10774,7 @@ msgid "" msgstr "" # fc2b4510b4a54f74af5d89342e3260cb -#: ../src/Doc/whatsnew/2.6.rst:117 +#: whatsnew/2.6.rst:117 msgid "" "A new command-line switch, :option:`-3`, enables warnings about features " "that will be removed in Python 3.0. You can run code with this switch to " @@ -10849,7 +10783,7 @@ msgid "" "py3kwarning`, and to C extension code as :c:data:`Py_Py3kWarningFlag`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:126 +#: whatsnew/2.6.rst:126 msgid "" "The 3xxx series of PEPs, which contains proposals for Python 3.0. :pep:" "`3000` describes the development process for Python 3.0. Start with :pep:" @@ -10857,11 +10791,11 @@ msgid "" "higher-numbered PEPS that propose specific features." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:134 +#: whatsnew/2.6.rst:134 msgid "Changes to the Development Process" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:136 +#: whatsnew/2.6.rst:136 msgid "" "While 2.6 was being developed, the Python development process underwent two " "significant changes: we switched from SourceForge's issue tracker to a " @@ -10869,11 +10803,11 @@ msgid "" "LaTeX to reStructuredText." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:143 +#: whatsnew/2.6.rst:143 msgid "New Issue Tracker: Roundup" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:145 +#: whatsnew/2.6.rst:145 msgid "" "For a long time, the Python developers had been growing increasingly annoyed " "by SourceForge's bug tracker. SourceForge's hosted solution doesn't permit " @@ -10881,7 +10815,7 @@ msgid "" "cycle of issues." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:150 +#: whatsnew/2.6.rst:150 msgid "" "The infrastructure committee of the Python Software Foundation therefore " "posted a call for issue trackers, asking volunteers to set up different " @@ -10896,7 +10830,7 @@ msgid "" msgstr "" # 5d3b5e5e4f0644e99aa2dc801015f475 -#: ../src/Doc/whatsnew/2.6.rst:164 +#: whatsnew/2.6.rst:164 msgid "" "After posting a call for volunteers, a new Roundup installation was set up " "at https://bugs.python.org. One installation of Roundup can host multiple " @@ -10906,7 +10840,7 @@ msgid "" "item for each change." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:172 +#: whatsnew/2.6.rst:172 msgid "" "Hosting of the Python bug tracker is kindly provided by `Upfront Systems " "<http://www.upfrontsystems.co.za/>`__ of Stellenbosch, South Africa. Martin " @@ -10917,46 +10851,46 @@ msgid "" msgstr "" # eab68856fd3c449dac2be43770897fc3 -#: ../src/Doc/whatsnew/2.6.rst:182 +#: whatsnew/2.6.rst:183 msgid "https://bugs.python.org" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:183 +#: whatsnew/2.6.rst:183 msgid "The Python bug tracker." msgstr "" # 357cae7398a04266ad88d3e3bf9f4da8 -#: ../src/Doc/whatsnew/2.6.rst:185 +#: whatsnew/2.6.rst:186 msgid "http://bugs.jython.org:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:186 +#: whatsnew/2.6.rst:186 msgid "The Jython bug tracker." msgstr "" # c2e5487be1e446dba854c029923c7aa9 -#: ../src/Doc/whatsnew/2.6.rst:188 +#: whatsnew/2.6.rst:189 msgid "http://roundup.sourceforge.net/" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:189 +#: whatsnew/2.6.rst:189 msgid "Roundup downloads and documentation." msgstr "" # 6f10dc51f6e5404698e588a7c727432e -#: ../src/Doc/whatsnew/2.6.rst:190 +#: whatsnew/2.6.rst:191 msgid "http://svn.python.org/view/tracker/importer/" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:192 +#: whatsnew/2.6.rst:192 msgid "Martin von Loewis's conversion scripts." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:195 +#: whatsnew/2.6.rst:195 msgid "New Documentation Format: reStructuredText Using Sphinx" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:197 +#: whatsnew/2.6.rst:197 msgid "" "The Python documentation was written using LaTeX since the project started " "around 1989. In the 1980s and early 1990s, most documentation was printed " @@ -10965,7 +10899,7 @@ msgid "" "once the basic rules of the markup were learned." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:204 +#: whatsnew/2.6.rst:204 msgid "" "Today LaTeX is still used for writing publications destined for printing, " "but the landscape for programming tools has shifted. We no longer print out " @@ -10978,14 +10912,14 @@ msgid "" "and no one ever committed the time required to finish the job." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:215 +#: whatsnew/2.6.rst:215 msgid "" "During the 2.6 development cycle, Georg Brandl put a lot of effort into " "building a new toolchain for processing the documentation. The resulting " "package is called Sphinx, and is available from http://sphinx.pocoo.org/." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:220 +#: whatsnew/2.6.rst:220 msgid "" "Sphinx concentrates on HTML output, producing attractively styled and modern " "HTML; printed output is still supported through conversion to LaTeX. The " @@ -10994,42 +10928,39 @@ msgid "" msgstr "" # abd8b71b55244f43be28272c7109c5cb -#: ../src/Doc/whatsnew/2.6.rst:226 +#: whatsnew/2.6.rst:226 msgid "" "Sphinx is a standalone package that can be used for writing, and almost two " "dozen other projects (`listed on the Sphinx web site <http://sphinx-doc.org/" "examples.html>`__) have adopted Sphinx as their documentation tool." msgstr "" -# d0af77b8e20b48b5b1283ba07b12d040 -#: ../src/Doc/whatsnew/2.6.rst:233 -msgid "" -"`Documenting Python <https://docs.python.org/devguide/documenting.html>`__" -msgstr "" +#: whatsnew/2.6.rst:234 +#, fuzzy +msgid "Documenting Python" +msgstr "Portage vers Python 3.2" -#: ../src/Doc/whatsnew/2.6.rst:234 +#: whatsnew/2.6.rst:234 msgid "Describes how to write for Python's documentation." msgstr "" -# fb491a6bc2b7466c93968451ed450809 -#: ../src/Doc/whatsnew/2.6.rst:236 -msgid "`Sphinx <http://sphinx-doc.org/>`__" +#: whatsnew/2.6.rst:237 +msgid "Sphinx" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:237 +#: whatsnew/2.6.rst:237 msgid "Documentation and code for the Sphinx toolchain." msgstr "" -# a7c0dc5d5c194ed487dc221ca847d717 -#: ../src/Doc/whatsnew/2.6.rst:238 -msgid "`Docutils <http://docutils.sourceforge.net>`__" +#: whatsnew/2.6.rst:239 +msgid "Docutils" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:240 +#: whatsnew/2.6.rst:240 msgid "The underlying reStructuredText parser and toolset." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:246 +#: whatsnew/2.6.rst:246 msgid "" "The previous version, Python 2.5, added the ':keyword:`with`' statement as " "an optional feature, to be enabled by a ``from __future__ import " @@ -11040,34 +10971,34 @@ msgid "" "`with`' statement from Python 2.5, you can skip this section." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:261 +#: whatsnew/2.6.rst:261 msgid "" "The ':keyword:`with`' statement is a control-flow structure whose basic " "structure is::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:267 +#: whatsnew/2.6.rst:267 msgid "" "The expression is evaluated, and it should result in an object that supports " "the context management protocol (that is, has :meth:`__enter__` and :meth:" "`__exit__` methods)." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:308 +#: whatsnew/2.6.rst:308 msgid "" "The :func:`localcontext` function in the :mod:`decimal` module makes it easy " "to save and restore the current decimal context, which encapsulates the " "desired precision and rounding characteristics for computations::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:341 +#: whatsnew/2.6.rst:341 msgid "" "The context manager's :meth:`__enter__` method is called. The value " "returned is assigned to *VAR*. If no ``as VAR`` clause is present, the " "value is simply discarded." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:347 +#: whatsnew/2.6.rst:347 msgid "" "If *BLOCK* raises an exception, the context manager's :meth:`__exit__` " "method is called with three arguments, the exception details (``type, value, " @@ -11080,19 +11011,19 @@ msgid "" "wrong." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:429 +#: whatsnew/2.6.rst:429 msgid "" "The :mod:`contextlib` module provides some functions and a decorator that " "are useful when writing objects for use with the ':keyword:`with`' statement." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:441 +#: whatsnew/2.6.rst:441 msgid "" "Using this decorator, our database example from the previous section could " "be written as::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:461 +#: whatsnew/2.6.rst:461 msgid "" "The :mod:`contextlib` module also has a ``nested(mgr1, mgr2, ...)`` function " "that combines a number of context managers so you don't need to write nested " @@ -11100,32 +11031,32 @@ msgid "" "statement both starts a database transaction and acquires a thread lock::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:470 +#: whatsnew/2.6.rst:470 msgid "" "Finally, the :func:`closing` function returns its argument so that it can be " "bound to a variable, and calls the argument's ``.close()`` method at the end " "of the block. ::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:497 +#: whatsnew/2.6.rst:497 msgid "PEP 366: Explicit Relative Imports From a Main Module" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:499 +#: whatsnew/2.6.rst:499 msgid "" "Python's :option:`-m` switch allows running a module as a script. When you " "ran a module that was located inside a package, relative imports didn't work " "correctly." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:503 +#: whatsnew/2.6.rst:503 msgid "" "The fix for Python 2.6 adds a :attr:`__package__` attribute to modules. " "When this attribute is present, relative imports will be relative to the " "value of this attribute instead of the :attr:`__name__` attribute." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:508 +#: whatsnew/2.6.rst:508 msgid "" "PEP 302-style importers can then set :attr:`__package__` as necessary. The :" "mod:`runpy` module that implements the :option:`-m` switch now does this, so " @@ -11133,11 +11064,11 @@ msgid "" "package." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:518 +#: whatsnew/2.6.rst:518 msgid "PEP 370: Per-user ``site-packages`` Directory" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:520 +#: whatsnew/2.6.rst:520 msgid "" "When you run Python, the module search path ``sys.path`` usually includes a " "directory whose path ends in ``\"site-packages\"``. This directory is " @@ -11145,28 +11076,28 @@ msgid "" "machine or a particular site installation." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:525 +#: whatsnew/2.6.rst:525 msgid "" "Python 2.6 introduces a convention for user-specific site directories. The " "directory varies depending on the platform:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:528 +#: whatsnew/2.6.rst:528 msgid "Unix and Mac OS X: :file:`~/.local/`" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:529 +#: whatsnew/2.6.rst:529 msgid "Windows: :file:`%APPDATA%/Python`" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:531 +#: whatsnew/2.6.rst:531 msgid "" "Within this directory, there will be version-specific subdirectories, such " "as :file:`lib/python2.6/site-packages` on Unix/Mac OS and :file:`Python26/" "site-packages` on Windows." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:535 +#: whatsnew/2.6.rst:535 msgid "" "If you don't like the default directory, it can be overridden by an " "environment variable. :envvar:`PYTHONUSERBASE` sets the root directory used " @@ -11176,27 +11107,27 @@ msgid "" "file for your Python installation." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:542 +#: whatsnew/2.6.rst:542 msgid "" "The feature can be disabled entirely by running Python with the :option:`-s` " "option or setting the :envvar:`PYTHONNOUSERSITE` environment variable." msgstr "" # 6227bdbf32ad47d8abca9cded5ad5789 -#: ../src/Doc/whatsnew/2.6.rst:547 +#: whatsnew/2.6.rst:548 #, fuzzy -msgid ":pep:`370` - Per-user ``site-packages`` Directory" +msgid "PEP 370 - Per-user site-packages Directory" msgstr ":pep:`370` -- Répertoire site-packages par utilisateur " -#: ../src/Doc/whatsnew/2.6.rst:549 +#: whatsnew/2.6.rst:549 msgid "PEP written and implemented by Christian Heimes." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:557 +#: whatsnew/2.6.rst:557 msgid "PEP 371: The ``multiprocessing`` Package" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:559 +#: whatsnew/2.6.rst:559 msgid "" "The new :mod:`multiprocessing` package lets Python programs create new " "processes that will perform a computation and return a result to the " @@ -11205,7 +11136,7 @@ msgid "" "share simple arrays of data." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:565 +#: whatsnew/2.6.rst:565 msgid "" "The :mod:`multiprocessing` module started out as an exact emulation of the :" "mod:`threading` module using processes instead of threads. That goal was " @@ -11217,7 +11148,7 @@ msgid "" "still running and the :meth:`join` method to wait for the process to exit." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:575 +#: whatsnew/2.6.rst:575 msgid "" "Here's a simple example where the subprocess will calculate a factorial. " "The function doing the calculation is written strangely so that it takes " @@ -11225,7 +11156,7 @@ msgid "" msgstr "" # f7f62ecdf6154fd198b1a3c30e59c924 -#: ../src/Doc/whatsnew/2.6.rst:612 +#: whatsnew/2.6.rst:612 msgid "" "A :class:`Queue` is used to communicate the result of the factorial. The :" "class:`Queue` object is stored in a global variable. The child process will " @@ -11235,7 +11166,7 @@ msgid "" "would be unaffected, and vice versa.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:620 +#: whatsnew/2.6.rst:620 msgid "" "Two other classes, :class:`Pool` and :class:`Manager`, provide higher-level " "interfaces. :class:`Pool` will create a fixed number of worker processes, " @@ -11246,7 +11177,7 @@ msgid "" "results::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:647 +#: whatsnew/2.6.rst:647 msgid "" "The other high-level interface, the :class:`Manager` class, creates a " "separate server process that can hold master copies of Python data " @@ -11259,55 +11190,54 @@ msgid "" "create shared locks.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:691 +#: whatsnew/2.6.rst:691 msgid "This will produce the output::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:702 +#: whatsnew/2.6.rst:702 msgid "The documentation for the :mod:`multiprocessing` module." msgstr "" -# 54dc6f0236254da5a723129f240b3978 -#: ../src/Doc/whatsnew/2.6.rst:704 -msgid ":pep:`371` - Addition of the multiprocessing package" +#: whatsnew/2.6.rst:705 +msgid "PEP 371 - Addition of the multiprocessing package" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:705 +#: whatsnew/2.6.rst:705 msgid "" "PEP written by Jesse Noller and Richard Oudkerk; implemented by Richard " "Oudkerk and Jesse Noller." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:714 +#: whatsnew/2.6.rst:714 msgid "PEP 3101: Advanced String Formatting" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:716 +#: whatsnew/2.6.rst:716 msgid "" "In Python 3.0, the `%` operator is supplemented by a more powerful string " "formatting method, :meth:`format`. Support for the :meth:`str.format` " "method has been backported to Python 2.6." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:720 +#: whatsnew/2.6.rst:720 msgid "" "In 2.6, both 8-bit and Unicode strings have a `.format()` method that treats " "the string as a template and takes the arguments to be formatted. The " "formatting template uses curly brackets (`{`, `}`) as special characters::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:733 +#: whatsnew/2.6.rst:733 msgid "Curly brackets can be escaped by doubling them::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:738 +#: whatsnew/2.6.rst:738 msgid "" "Field names can be integers indicating positional arguments, such as ``{0}" "``, ``{1}``, etc. or names of keyword arguments. You can also supply " "compound field names that read attributes or access dictionary keys::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:752 +#: whatsnew/2.6.rst:752 msgid "" "Note that when using dictionary-style notation such as ``[.mp4]``, you don't " "need to put any quotation marks around the string; it will look up the value " @@ -11316,253 +11246,251 @@ msgid "" "inside a format string." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:758 +#: whatsnew/2.6.rst:758 msgid "" "So far we've shown how to specify which field to substitute into the " "resulting string. The precise formatting used is also controllable by " "adding a colon followed by a format specifier. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:772 +#: whatsnew/2.6.rst:772 msgid "Format specifiers can reference other fields through nesting::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:782 +#: whatsnew/2.6.rst:782 msgid "The alignment of a field within the desired width can be specified:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:785 +#: whatsnew/2.6.rst:785 msgid "Character" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:785 +#: whatsnew/2.6.rst:785 msgid "Effect" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:787 +#: whatsnew/2.6.rst:787 msgid "< (default)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:787 +#: whatsnew/2.6.rst:787 msgid "Left-align" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:788 +#: whatsnew/2.6.rst:788 msgid ">" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:788 +#: whatsnew/2.6.rst:788 msgid "Right-align" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:789 +#: whatsnew/2.6.rst:789 msgid "^" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:789 +#: whatsnew/2.6.rst:789 msgid "Center" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:790 +#: whatsnew/2.6.rst:790 msgid "=" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:790 +#: whatsnew/2.6.rst:790 msgid "(For numeric types only) Pad after the sign." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:793 +#: whatsnew/2.6.rst:793 msgid "" "Format specifiers can also include a presentation type, which controls how " "the value is formatted. For example, floating-point numbers can be " "formatted as a general number or in exponential notation::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:802 +#: whatsnew/2.6.rst:802 msgid "" "A variety of presentation types are available. Consult the 2.6 " "documentation for a :ref:`complete list <formatstrings>`; here's a sample:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:806 +#: whatsnew/2.6.rst:806 msgid "``b``" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:806 +#: whatsnew/2.6.rst:806 msgid "Binary. Outputs the number in base 2." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:807 +#: whatsnew/2.6.rst:807 msgid "``c``" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:807 +#: whatsnew/2.6.rst:807 msgid "" "Character. Converts the integer to the corresponding Unicode character " "before printing." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:809 +#: whatsnew/2.6.rst:809 msgid "``d``" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:809 +#: whatsnew/2.6.rst:809 msgid "Decimal Integer. Outputs the number in base 10." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:810 +#: whatsnew/2.6.rst:810 msgid "``o``" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:810 +#: whatsnew/2.6.rst:810 msgid "Octal format. Outputs the number in base 8." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:811 +#: whatsnew/2.6.rst:811 msgid "``x``" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:811 +#: whatsnew/2.6.rst:811 msgid "" "Hex format. Outputs the number in base 16, using lower-case letters for the " "digits above 9." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:813 +#: whatsnew/2.6.rst:813 msgid "``e``" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:813 +#: whatsnew/2.6.rst:813 msgid "" "Exponent notation. Prints the number in scientific notation using the letter " "'e' to indicate the exponent." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:815 +#: whatsnew/2.6.rst:815 msgid "``g``" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:815 +#: whatsnew/2.6.rst:815 msgid "" "General format. This prints the number as a fixed-point number, unless the " "number is too large, in which case it switches to 'e' exponent notation." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:818 +#: whatsnew/2.6.rst:818 msgid "``n``" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:818 +#: whatsnew/2.6.rst:818 msgid "" "Number. This is the same as 'g' (for floats) or 'd' (for integers), except " "that it uses the current locale setting to insert the appropriate number " "separator characters." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:821 +#: whatsnew/2.6.rst:821 msgid "``%``" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:821 +#: whatsnew/2.6.rst:821 msgid "" "Percentage. Multiplies the number by 100 and displays in fixed ('f') format, " "followed by a percent sign." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:825 +#: whatsnew/2.6.rst:825 msgid "" "Classes and types can define a :meth:`__format__` method to control how " "they're formatted. It receives a single argument, the format specifier::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:834 +#: whatsnew/2.6.rst:834 msgid "" "There's also a :func:`format` builtin that will format a single value. It " "calls the type's :meth:`__format__` method with the provided specifier::" msgstr "" -# 806885e619f3491eac6432870993fd2a -#: ../src/Doc/whatsnew/2.6.rst:844 -msgid ":ref:`formatstrings`" +#: whatsnew/2.6.rst:845 +msgid "formatstrings" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:845 +#: whatsnew/2.6.rst:845 msgid "The reference documentation for format fields." msgstr "" -# b88646abfbd043298a0fc75430a1edf9 -#: ../src/Doc/whatsnew/2.6.rst:846 -msgid ":pep:`3101` - Advanced String Formatting" +#: whatsnew/2.6.rst:847 +msgid "PEP 3101 - Advanced String Formatting" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:848 +#: whatsnew/2.6.rst:848 msgid "PEP written by Talin. Implemented by Eric Smith." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:855 +#: whatsnew/2.6.rst:855 msgid "PEP 3105: ``print`` As a Function" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:857 +#: whatsnew/2.6.rst:857 msgid "" "The ``print`` statement becomes the :func:`print` function in Python 3.0. " "Making :func:`print` a function makes it possible to replace the function by " "doing ``def print(...)`` or importing a new function from somewhere else." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:861 +#: whatsnew/2.6.rst:861 msgid "" "Python 2.6 has a ``__future__`` import that removes ``print`` as language " "syntax, letting you use the functional form instead. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:867 +#: whatsnew/2.6.rst:867 msgid "The signature of the new function is::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:872 +#: whatsnew/2.6.rst:872 msgid "The parameters are:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:874 +#: whatsnew/2.6.rst:874 msgid "*args*: positional arguments whose values will be printed out." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:875 +#: whatsnew/2.6.rst:875 msgid "*sep*: the separator, which will be printed between arguments." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:876 +#: whatsnew/2.6.rst:876 msgid "" "*end*: the ending text, which will be printed after all of the arguments " "have been output." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:878 +#: whatsnew/2.6.rst:878 msgid "*file*: the file object to which the output will be sent." msgstr "" # 73d1840370b041fa9a4e57ad321e7042 -#: ../src/Doc/whatsnew/2.6.rst:881 +#: whatsnew/2.6.rst:882 #, fuzzy -msgid ":pep:`3105` - Make print a function" +msgid "PEP 3105 - Make print a function" msgstr ":pep:`3105`: *Make print a function*" -#: ../src/Doc/whatsnew/2.6.rst:883 +#: whatsnew/2.6.rst:883 msgid "PEP written by Georg Brandl." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:890 +#: whatsnew/2.6.rst:890 msgid "PEP 3110: Exception-Handling Changes" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:892 +#: whatsnew/2.6.rst:892 msgid "" "One error that Python programmers occasionally make is writing the following " "code::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:900 +#: whatsnew/2.6.rst:900 msgid "" "The author is probably trying to catch both :exc:`TypeError` and :exc:" "`ValueError` exceptions, but this code actually does something different: it " @@ -11571,21 +11499,21 @@ msgid "" "caught at all. The correct code specifies a tuple of exceptions::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:912 +#: whatsnew/2.6.rst:912 msgid "" "This error happens because the use of the comma here is ambiguous: does it " "indicate two different nodes in the parse tree, or a single node that's a " "tuple?" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:916 +#: whatsnew/2.6.rst:916 msgid "" "Python 3.0 makes this unambiguous by replacing the comma with the word \"as" "\". To catch an exception and store the exception object in the variable " "``exc``, you must write::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:925 +#: whatsnew/2.6.rst:925 msgid "" "Python 3.0 will only support the use of \"as\", and therefore interprets the " "first example as catching two different exceptions. Python 2.6 supports " @@ -11594,20 +11522,19 @@ msgid "" "be executed with 2.6." msgstr "" -# 451316b09876443d9ee9f74ee2ecc086 -#: ../src/Doc/whatsnew/2.6.rst:932 -msgid ":pep:`3110` - Catching Exceptions in Python 3000" +#: whatsnew/2.6.rst:933 +msgid "PEP 3110 - Catching Exceptions in Python 3000" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:934 +#: whatsnew/2.6.rst:934 msgid "PEP written and implemented by Collin Winter." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:941 +#: whatsnew/2.6.rst:941 msgid "PEP 3112: Byte Literals" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:943 +#: whatsnew/2.6.rst:943 msgid "" "Python 3.0 adopts Unicode as the language's fundamental string type and " "denotes 8-bit literals differently, either as ``b'string'`` or using a :" @@ -11616,7 +11543,7 @@ msgid "" "``b''`` notation." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:950 +#: whatsnew/2.6.rst:950 msgid "" "The 2.6 :class:`str` differs from 3.0's :class:`bytes` type in various ways; " "most notably, the constructor is completely different. In 3.0, ``bytes([65, " @@ -11625,7 +11552,7 @@ msgid "" "func:`str` of the list." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:956 +#: whatsnew/2.6.rst:956 msgid "" "The primary use of :class:`bytes` in 2.6 will be to write tests of object " "type such as ``isinstance(x, bytes)``. This will help the 2to3 converter, " @@ -11635,7 +11562,7 @@ msgid "" "be correct in Python 3.0." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:963 +#: whatsnew/2.6.rst:963 msgid "" "There's also a ``__future__`` import that causes all string literals to " "become Unicode strings. This means that ``\\u`` escape sequences can be " @@ -11643,7 +11570,7 @@ msgid "" msgstr "" # 20105baec2394d19b09f76742fc3fd3f -#: ../src/Doc/whatsnew/2.6.rst:975 +#: whatsnew/2.6.rst:975 msgid "" "At the C level, Python 3.0 will rename the existing 8-bit string type, " "called :c:type:`PyStringObject` in Python 2.x, to :c:type:`PyBytesObject`. " @@ -11653,13 +11580,13 @@ msgid "" "with strings." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:982 +#: whatsnew/2.6.rst:982 msgid "" "Instances of the :class:`bytes` type are immutable just as strings are. A " "new :class:`bytearray` type stores a mutable sequence of bytes::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:997 +#: whatsnew/2.6.rst:997 msgid "" "Byte arrays support most of the methods of string types, such as :meth:" "`startswith`/:meth:`endswith`, :meth:`find`/:meth:`rfind`, and some of the " @@ -11667,26 +11594,25 @@ msgid "" msgstr "" # f54b18ea8c6b4acfb00f8f4472e79ce0 -#: ../src/Doc/whatsnew/2.6.rst:1010 +#: whatsnew/2.6.rst:1010 msgid "" "There's also a corresponding C API, with :c:func:`PyByteArray_FromObject`, :" "c:func:`PyByteArray_FromStringAndSize`, and various other functions." msgstr "" -# 618beab47a0a42d0a4ed548ed0c6a600 -#: ../src/Doc/whatsnew/2.6.rst:1016 -msgid ":pep:`3112` - Bytes literals in Python 3000" +#: whatsnew/2.6.rst:1017 +msgid "PEP 3112 - Bytes literals in Python 3000" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1018 +#: whatsnew/2.6.rst:1018 msgid "PEP written by Jason Orendorff; backported to 2.6 by Christian Heimes." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1025 +#: whatsnew/2.6.rst:1025 msgid "PEP 3116: New I/O Library" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1027 +#: whatsnew/2.6.rst:1027 msgid "" "Python's built-in file objects support a number of methods, but file-like " "objects don't necessarily support all of them. Objects that imitate files " @@ -11696,13 +11622,13 @@ msgid "" "from the fundamental read and write operations." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1035 +#: whatsnew/2.6.rst:1035 msgid "" "There are three levels of abstract base classes provided by the :mod:`io` " "module:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1038 +#: whatsnew/2.6.rst:1038 msgid "" ":class:`RawIOBase` defines raw I/O operations: :meth:`read`, :meth:" "`readinto`, :meth:`write`, :meth:`seek`, :meth:`tell`, :meth:`truncate`, " @@ -11712,13 +11638,13 @@ msgid "" "allow." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1046 +#: whatsnew/2.6.rst:1046 msgid "" "Python 3.0 has concrete implementations of this class for files and sockets, " "but Python 2.6 hasn't restructured its file and socket objects in this way." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1052 +#: whatsnew/2.6.rst:1052 msgid "" ":class:`BufferedIOBase` is an abstract base class that buffers data in " "memory to reduce the number of system calls used, making I/O processing more " @@ -11726,7 +11652,7 @@ msgid "" "attr:`raw` attribute holding the underlying raw object." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1058 +#: whatsnew/2.6.rst:1058 msgid "" "There are five concrete classes implementing this ABC. :class:" "`BufferedWriter` and :class:`BufferedReader` are for objects that support " @@ -11739,7 +11665,7 @@ msgid "" msgstr "" # 6ca5d9cd157042728d0ec3808d195ffd -#: ../src/Doc/whatsnew/2.6.rst:1071 +#: whatsnew/2.6.rst:1071 msgid "" ":class:`TextIOBase`: Provides functions for reading and writing strings " "(remember, strings will be Unicode in Python 3.0), and supporting :term:" @@ -11747,7 +11673,7 @@ msgid "" "method and supports iteration upon objects." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1077 +#: whatsnew/2.6.rst:1077 msgid "" "There are two concrete implementations. :class:`TextIOWrapper` wraps a " "buffered I/O object, supporting all of the methods for text I/O and adding " @@ -11756,7 +11682,7 @@ msgid "" "to disk." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1083 +#: whatsnew/2.6.rst:1083 msgid "" "(In Python 2.6, :class:`io.StringIO` is implemented in pure Python, so it's " "pretty slow. You should therefore stick with the existing :mod:`StringIO` " @@ -11765,7 +11691,7 @@ msgid "" "will be backported to the 2.x releases.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1089 +#: whatsnew/2.6.rst:1089 msgid "" "In Python 2.6, the underlying implementations haven't been restructured to " "build on top of the :mod:`io` module's classes. The module is being " @@ -11774,23 +11700,22 @@ msgid "" "buffering and text I/O." msgstr "" -# f083df6fb6914c19bee80d67e631dca7 -#: ../src/Doc/whatsnew/2.6.rst:1098 -msgid ":pep:`3116` - New I/O" +#: whatsnew/2.6.rst:1099 +msgid "PEP 3116 - New I/O" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1098 +#: whatsnew/2.6.rst:1098 msgid "" "PEP written by Daniel Stutzbach, Mike Verdone, and Guido van Rossum. Code by " "Guido van Rossum, Georg Brandl, Walter Doerwald, Jeremy Hylton, Martin von " "Loewis, Tony Lownds, and others." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1107 +#: whatsnew/2.6.rst:1107 msgid "PEP 3118: Revised Buffer Protocol" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1109 +#: whatsnew/2.6.rst:1109 msgid "" "The buffer protocol is a C-level API that lets Python types exchange " "pointers into their internal representations. A memory-mapped file can be " @@ -11799,7 +11724,7 @@ msgid "" "searched." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1115 +#: whatsnew/2.6.rst:1115 msgid "" "The primary users of the buffer protocol are numeric-processing packages " "such as NumPy, which expose the internal representation of arrays so that " @@ -11809,7 +11734,7 @@ msgid "" "the shape of an array or locking a memory region." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1122 +#: whatsnew/2.6.rst:1122 msgid "" "The most important new C API function is ``PyObject_GetBuffer(PyObject *obj, " "Py_buffer *view, int flags)``, which takes an object and a set of flags, and " @@ -11821,22 +11746,22 @@ msgid "" msgstr "" # 588a2e47fdec43279632deced0efde1a -#: ../src/Doc/whatsnew/2.6.rst:1134 +#: whatsnew/2.6.rst:1134 msgid "" "The *flags* argument to :c:func:`PyObject_GetBuffer` specifies constraints " "upon the memory returned. Some examples are:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1137 +#: whatsnew/2.6.rst:1137 msgid ":const:`PyBUF_WRITABLE` indicates that the memory must be writable." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1139 +#: whatsnew/2.6.rst:1139 msgid "" ":const:`PyBUF_LOCK` requests a read-only or exclusive lock on the memory." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1141 +#: whatsnew/2.6.rst:1141 msgid "" ":const:`PyBUF_C_CONTIGUOUS` and :const:`PyBUF_F_CONTIGUOUS` requests a C-" "contiguous (last dimension varies the fastest) or Fortran-contiguous (first " @@ -11844,28 +11769,27 @@ msgid "" msgstr "" # 0a0a5a2e9f114b4a939fa41bb01b8769 -#: ../src/Doc/whatsnew/2.6.rst:1145 +#: whatsnew/2.6.rst:1145 msgid "" "Two new argument codes for :c:func:`PyArg_ParseTuple`, ``s*`` and ``z*``, " "return locked buffer objects for a parameter." msgstr "" -# 6396f87545d4407cbf745bdfb1af0ab5 -#: ../src/Doc/whatsnew/2.6.rst:1150 -msgid ":pep:`3118` - Revising the buffer protocol" +#: whatsnew/2.6.rst:1151 +msgid "PEP 3118 - Revising the buffer protocol" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1151 +#: whatsnew/2.6.rst:1151 msgid "" "PEP written by Travis Oliphant and Carl Banks; implemented by Travis " "Oliphant." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1160 +#: whatsnew/2.6.rst:1160 msgid "PEP 3119: Abstract Base Classes" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1162 +#: whatsnew/2.6.rst:1162 msgid "" "Some object-oriented languages such as Java support interfaces, declaring " "that a class has a given set of methods or supports a given access " @@ -11877,7 +11801,7 @@ msgid "" "versions of Python will probably add more ABCs." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1172 +#: whatsnew/2.6.rst:1172 msgid "" "Let's say you have a particular class and wish to know whether it supports " "dictionary-style access. The phrase \"dictionary-style\" is vague, however. " @@ -11888,7 +11812,7 @@ msgid "" "`update`? Iterating over the object with :func:`iter`?" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1180 +#: whatsnew/2.6.rst:1180 msgid "" "The Python 2.6 :mod:`collections` module includes a number of different ABCs " "that represent these distinctions. :class:`Iterable` indicates that a class " @@ -11899,20 +11823,20 @@ msgid "" "`MutableMapping` ABC." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1189 +#: whatsnew/2.6.rst:1189 msgid "" "You can derive your own classes from a particular ABC to indicate they " "support that ABC's interface::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1198 +#: whatsnew/2.6.rst:1198 msgid "" "Alternatively, you could write the class without deriving from the desired " "ABC and instead register the class by calling the ABC's :meth:`register` " "method::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1209 +#: whatsnew/2.6.rst:1209 msgid "" "For classes that you write, deriving from the ABC is probably clearer. The :" "meth:`register` method is useful when you've written a new ABC that can " @@ -11921,20 +11845,20 @@ msgid "" "`PrintableType` ABC, it's legal to do::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1221 +#: whatsnew/2.6.rst:1221 msgid "" "Classes should obey the semantics specified by an ABC, but Python can't " "check this; it's up to the class author to understand the ABC's requirements " "and to implement the code accordingly." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1225 +#: whatsnew/2.6.rst:1225 msgid "" "To check whether an object supports a particular interface, you can now " "write::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1232 +#: whatsnew/2.6.rst:1232 msgid "" "Don't feel that you must now begin writing lots of checks as in the above " "example. Python has a strong tradition of duck-typing, where explicit type-" @@ -11944,13 +11868,13 @@ msgid "" "necessary." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1239 +#: whatsnew/2.6.rst:1239 msgid "" "You can write your own ABCs by using ``abc.ABCMeta`` as the metaclass in a " "class definition::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1260 +#: whatsnew/2.6.rst:1260 msgid "" "In the :class:`Drawable` ABC above, the :meth:`draw_doubled` method renders " "the object at twice its size and can be implemented in terms of other " @@ -11960,7 +11884,7 @@ msgid "" "necessary, though; the ABC can't provide a useful generic implementation." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1268 +#: whatsnew/2.6.rst:1268 msgid "" "You can apply the ``@abstractmethod`` decorator to methods such as :meth:" "`draw` that must be implemented; Python will then raise an exception for " @@ -11969,52 +11893,51 @@ msgid "" "method::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1283 +#: whatsnew/2.6.rst:1283 msgid "" "Abstract data attributes can be declared using the ``@abstractproperty`` " "decorator::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1293 +#: whatsnew/2.6.rst:1293 msgid "Subclasses must then define a :meth:`readonly` property." msgstr "" -# 66e36f0ccbbe42528e6619d58b3a71ab -#: ../src/Doc/whatsnew/2.6.rst:1298 -msgid ":pep:`3119` - Introducing Abstract Base Classes" +#: whatsnew/2.6.rst:1299 +msgid "PEP 3119 - Introducing Abstract Base Classes" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1298 +#: whatsnew/2.6.rst:1298 msgid "" "PEP written by Guido van Rossum and Talin. Implemented by Guido van Rossum. " "Backported to 2.6 by Benjamin Aranguren, with Alex Martelli." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1307 +#: whatsnew/2.6.rst:1307 msgid "PEP 3127: Integer Literal Support and Syntax" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1309 +#: whatsnew/2.6.rst:1309 msgid "" "Python 3.0 changes the syntax for octal (base-8) integer literals, prefixing " "them with \"0o\" or \"0O\" instead of a leading zero, and adds support for " "binary (base-2) integer literals, signalled by a \"0b\" or \"0B\" prefix." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1314 +#: whatsnew/2.6.rst:1314 msgid "" "Python 2.6 doesn't drop support for a leading 0 signalling an octal number, " "but it does add support for \"0o\" and \"0b\"::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1322 +#: whatsnew/2.6.rst:1322 msgid "" "The :func:`oct` builtin still returns numbers prefixed with a leading zero, " "and a new :func:`bin` builtin returns the binary representation for a " "number::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1333 +#: whatsnew/2.6.rst:1333 msgid "" "The :func:`int` and :func:`long` builtins will now accept the \"0o\" and \"0b" "\" prefixes when base-8 or base-2 are requested, or when the *base* argument " @@ -12022,57 +11945,55 @@ msgid "" "string)::" msgstr "" -# 7c5bfcf3e1cf47129830156f9830d481 -#: ../src/Doc/whatsnew/2.6.rst:1350 -msgid ":pep:`3127` - Integer Literal Support and Syntax" +#: whatsnew/2.6.rst:1351 +msgid "PEP 3127 - Integer Literal Support and Syntax" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1351 +#: whatsnew/2.6.rst:1351 msgid "PEP written by Patrick Maupin; backported to 2.6 by Eric Smith." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1359 +#: whatsnew/2.6.rst:1359 msgid "PEP 3129: Class Decorators" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1361 +#: whatsnew/2.6.rst:1361 msgid "" "Decorators have been extended from functions to classes. It's now legal to " "write::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1369 +#: whatsnew/2.6.rst:1369 msgid "This is equivalent to::" msgstr "" -# 19fd510ca7f0495592e375291f4dec94 -#: ../src/Doc/whatsnew/2.6.rst:1377 -msgid ":pep:`3129` - Class Decorators" +#: whatsnew/2.6.rst:1378 +msgid "PEP 3129 - Class Decorators" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1379 +#: whatsnew/2.6.rst:1379 msgid "PEP written by Collin Winter." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1386 +#: whatsnew/2.6.rst:1386 msgid "PEP 3141: A Type Hierarchy for Numbers" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1388 +#: whatsnew/2.6.rst:1388 msgid "" "Python 3.0 adds several abstract base classes for numeric types inspired by " "Scheme's numeric tower. These classes were backported to 2.6 as the :mod:" "`numbers` module." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1392 +#: whatsnew/2.6.rst:1392 msgid "" "The most general ABC is :class:`Number`. It defines no operations at all, " "and only exists to allow checking if an object is a number by doing " "``isinstance(obj, Number)``." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1396 +#: whatsnew/2.6.rst:1396 msgid "" ":class:`Complex` is a subclass of :class:`Number`. Complex numbers can " "undergo the basic operations of addition, subtraction, multiplication, " @@ -12081,14 +12002,14 @@ msgid "" "implementation of :class:`Complex`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1402 +#: whatsnew/2.6.rst:1402 msgid "" ":class:`Real` further derives from :class:`Complex`, and adds operations " "that only work on real numbers: :func:`floor`, :func:`trunc`, rounding, " "taking the remainder mod N, floor division, and comparisons." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1407 +#: whatsnew/2.6.rst:1407 msgid "" ":class:`Rational` numbers derive from :class:`Real`, have :attr:`numerator` " "and :attr:`denominator` properties, and can be converted to floats. Python " @@ -12097,7 +12018,7 @@ msgid "" "`Rational` to avoid a name clash with :class:`numbers.Rational`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1414 +#: whatsnew/2.6.rst:1414 msgid "" ":class:`Integral` numbers derive from :class:`Rational`, and can be shifted " "left and right with ``<<`` and ``>>``, combined using bitwise operations " @@ -12105,7 +12026,7 @@ msgid "" "boundaries." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1419 +#: whatsnew/2.6.rst:1419 msgid "" "In Python 3.0, the PEP slightly redefines the existing builtins :func:" "`round`, :func:`math.floor`, :func:`math.ceil`, and adds a new one, :func:" @@ -12114,32 +12035,31 @@ msgid "" "the function's argument and zero." msgstr "" -# f73074f903ad43d5b4518650b650e062 -#: ../src/Doc/whatsnew/2.6.rst:1427 -msgid ":pep:`3141` - A Type Hierarchy for Numbers" +#: whatsnew/2.6.rst:1428 +msgid "PEP 3141 - A Type Hierarchy for Numbers" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1428 +#: whatsnew/2.6.rst:1428 msgid "PEP written by Jeffrey Yasskin." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1430 +#: whatsnew/2.6.rst:1430 msgid "" "`Scheme's numerical tower <http://www.gnu.org/software/guile/manual/" "html_node/Numerical-Tower.html#Numerical-Tower>`__, from the Guile manual." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1432 +#: whatsnew/2.6.rst:1432 msgid "" "`Scheme's number datatypes <http://schemers.org/Documents/Standards/R5RS/" "HTML/r5rs-Z-H-9.html#%_sec_6.2>`__ from the R5RS Scheme specification." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1436 +#: whatsnew/2.6.rst:1436 msgid "The :mod:`fractions` Module" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1438 +#: whatsnew/2.6.rst:1438 msgid "" "To fill out the hierarchy of numeric types, the :mod:`fractions` module " "provides a rational-number class. Rational numbers store their values as a " @@ -12147,38 +12067,38 @@ msgid "" "numbers such as ``2/3`` that floating-point numbers can only approximate." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1444 +#: whatsnew/2.6.rst:1444 msgid "" "The :class:`Fraction` constructor takes two :class:`Integral` values that " "will be the numerator and denominator of the resulting fraction. ::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1457 +#: whatsnew/2.6.rst:1457 msgid "" "For converting floating-point numbers to rationals, the float type now has " "an :meth:`as_integer_ratio()` method that returns the numerator and " "denominator for a fraction that evaluates to the same floating-point value::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1469 +#: whatsnew/2.6.rst:1469 msgid "" "Note that values that can only be approximated by floating-point numbers, " "such as 1./3, are not simplified to the number being approximated; the " "fraction attempts to match the floating-point value **exactly**." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1474 +#: whatsnew/2.6.rst:1474 msgid "" "The :mod:`fractions` module is based upon an implementation by Sjoerd " "Mullender that was in Python's :file:`Demo/classes/` directory for a long " "time. This implementation was significantly updated by Jeffrey Yasskin." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1483 ../src/Doc/whatsnew/2.7.rst:665 +#: whatsnew/2.6.rst:1483 whatsnew/2.7.rst:665 msgid "Some smaller changes made to the core Python language are:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1485 +#: whatsnew/2.6.rst:1485 msgid "" "Directories and zip archives containing a :file:`__main__.py` file can now " "be executed directly by passing their name to the interpreter. The directory " @@ -12187,7 +12107,7 @@ msgid "" "J. Eby and Nick Coghlan; :issue:`1739468`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1492 +#: whatsnew/2.6.rst:1492 msgid "" "The :func:`hasattr` function was catching and ignoring all errors, under the " "assumption that they meant a :meth:`__getattr__` method was failing somehow " @@ -12198,31 +12118,31 @@ msgid "" "`2196`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1500 +#: whatsnew/2.6.rst:1500 msgid "" "When calling a function using the ``**`` syntax to provide keyword " "arguments, you are no longer required to use a Python dictionary; any " "mapping will now work::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1513 +#: whatsnew/2.6.rst:1513 #, fuzzy msgid "(Contributed by Alexander Belopolsky; :issue:`1686487`.)" msgstr "(Contribution par Antoine Pitrou; :issue:`3001`.)" -#: ../src/Doc/whatsnew/2.6.rst:1515 +#: whatsnew/2.6.rst:1515 msgid "" "It's also become legal to provide keyword arguments after a ``*args`` " "argument to a function call. ::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1524 +#: whatsnew/2.6.rst:1524 msgid "" "Previously this would have been a syntax error. (Contributed by Amaury " "Forgeot d'Arc; :issue:`3473`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1527 +#: whatsnew/2.6.rst:1527 msgid "" "A new builtin, ``next(iterator, [default])`` returns the next item from the " "specified iterator. If the *default* argument is supplied, it will be " @@ -12230,17 +12150,17 @@ msgid "" "`StopIteration` exception will be raised. (Backported in :issue:`2719`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1533 +#: whatsnew/2.6.rst:1533 msgid "" "Tuples now have :meth:`index` and :meth:`count` methods matching the list " "type's :meth:`index` and :meth:`count` methods::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1542 +#: whatsnew/2.6.rst:1542 msgid "(Contributed by Raymond Hettinger)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1544 +#: whatsnew/2.6.rst:1544 msgid "" "The built-in types now have improved support for extended slicing syntax, " "accepting various combinations of ``(start, stop, step)``. Previously, the " @@ -12248,7 +12168,7 @@ msgid "" "Thomas Wouters.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1551 +#: whatsnew/2.6.rst:1551 msgid "" "Properties now have three attributes, :attr:`getter`, :attr:`setter` and :" "attr:`deleter`, that are decorators providing useful shortcuts for adding a " @@ -12256,14 +12176,14 @@ msgid "" "them like this::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1578 +#: whatsnew/2.6.rst:1578 msgid "" "Several methods of the built-in set types now accept multiple iterables: :" "meth:`intersection`, :meth:`intersection_update`, :meth:`union`, :meth:" "`update`, :meth:`difference` and :meth:`difference_update`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1594 +#: whatsnew/2.6.rst:1594 msgid "" "Many floating-point features were added. The :func:`float` function will " "now turn the string ``nan`` into an IEEE 754 Not A Number value, and ``" @@ -12272,14 +12192,14 @@ msgid "" "`1635`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1600 +#: whatsnew/2.6.rst:1600 msgid "" "Other functions in the :mod:`math` module, :func:`isinf` and :func:`isnan`, " "return true if their floating-point argument is infinite or Not A Number. (:" "issue:`1640`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1604 +#: whatsnew/2.6.rst:1604 msgid "" "Conversion functions were added to convert floating-point numbers into " "hexadecimal strings (:issue:`3008`). These functions convert floats to and " @@ -12289,7 +12209,7 @@ msgid "" "converts a string back into a number::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1621 +#: whatsnew/2.6.rst:1621 msgid "" "A numerical nicety: when creating a complex number from two floats on " "systems that support signed zeros (-0 and +0), the :func:`complex` " @@ -12297,7 +12217,7 @@ msgid "" "Dickinson; :issue:`1507`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1626 +#: whatsnew/2.6.rst:1626 msgid "" "Classes that inherit a :meth:`__hash__` method from a parent class can set " "``__hash__ = None`` to indicate that the class isn't hashable. This will " @@ -12306,7 +12226,7 @@ msgid "" msgstr "" # 95d44d20bc4341a892d1200ba5ef0e05 -#: ../src/Doc/whatsnew/2.6.rst:1632 +#: whatsnew/2.6.rst:1632 msgid "" "You should do this when you've defined a :meth:`__cmp__` or :meth:`__eq__` " "method that compares objects by their value rather than by identity. All " @@ -12318,7 +12238,7 @@ msgid "" "d'Arc; :issue:`2235`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1642 +#: whatsnew/2.6.rst:1642 msgid "" "The :exc:`GeneratorExit` exception now subclasses :exc:`BaseException` " "instead of :exc:`Exception`. This means that an exception handler that does " @@ -12326,20 +12246,20 @@ msgid "" "(Contributed by Chad Austin; :issue:`1537`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1648 +#: whatsnew/2.6.rst:1648 msgid "" "Generator objects now have a :attr:`gi_code` attribute that refers to the " "original code object backing the generator. (Contributed by Collin Winter; :" "issue:`1473257`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1652 +#: whatsnew/2.6.rst:1652 msgid "" "The :func:`compile` built-in function now accepts keyword arguments as well " "as positional parameters. (Contributed by Thomas Wouters; :issue:`1444529`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1656 +#: whatsnew/2.6.rst:1656 msgid "" "The :func:`complex` constructor now accepts strings containing parenthesized " "complex numbers, meaning that ``complex(repr(cplx))`` will now round-trip " @@ -12347,7 +12267,7 @@ msgid "" "issue:`1491866`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1661 +#: whatsnew/2.6.rst:1661 msgid "" "The string :meth:`translate` method now accepts ``None`` as the translation " "table parameter, which is treated as the identity transformation. This " @@ -12356,7 +12276,7 @@ msgid "" "`1193128`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1667 +#: whatsnew/2.6.rst:1667 msgid "" "The built-in :func:`dir` function now checks for a :meth:`__dir__` method on " "the objects it receives. This method must return a list of strings " @@ -12366,7 +12286,7 @@ msgid "" "pseudo-attributes they will honor. (:issue:`1591665`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1675 +#: whatsnew/2.6.rst:1675 msgid "" "Instance method objects have new attributes for the object and function " "comprising the method; the new synonym for :attr:`im_self` is :attr:" @@ -12374,7 +12294,7 @@ msgid "" "old names are still supported in Python 2.6, but are gone in 3.0." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1680 +#: whatsnew/2.6.rst:1680 msgid "" "An obscure change: when you use the :func:`locals` function inside a :" "keyword:`class` statement, the resulting dictionary no longer returns free " @@ -12382,7 +12302,7 @@ msgid "" "keyword:`class` statement that aren't attributes of the class.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1691 +#: whatsnew/2.6.rst:1691 msgid "" "The :mod:`warnings` module has been rewritten in C. This makes it possible " "to invoke warnings from the parser, and may also make the interpreter's " @@ -12390,7 +12310,7 @@ msgid "" "`1631171`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1696 +#: whatsnew/2.6.rst:1696 msgid "" "Type objects now have a cache of methods that can reduce the work required " "to find the correct method implementation for a particular class; once " @@ -12402,7 +12322,7 @@ msgid "" msgstr "" # d3925186e2da4ff0b5abe8b00f82d7fd -#: ../src/Doc/whatsnew/2.6.rst:1706 +#: whatsnew/2.6.rst:1706 msgid "" "By default, this change is only applied to types that are included with the " "Python core. Extension modules may not necessarily be compatible with this " @@ -12414,7 +12334,7 @@ msgid "" "interpreter to determine that. See :issue:`1878` for some discussion.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1717 +#: whatsnew/2.6.rst:1717 msgid "" "Function calls that use keyword arguments are significantly faster by doing " "a quick pointer comparison, usually saving the time of a full string " @@ -12422,21 +12342,21 @@ msgid "" "implementation by Antoine Pitrou; :issue:`1819`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1722 +#: whatsnew/2.6.rst:1722 msgid "" "All of the functions in the :mod:`struct` module have been rewritten in C, " "thanks to work at the Need For Speed sprint. (Contributed by Raymond " "Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1726 +#: whatsnew/2.6.rst:1726 msgid "" "Some of the standard built-in types now set a bit in their type objects. " "This speeds up checking whether an object is a subclass of one of these " "types. (Contributed by Neal Norwitz.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1730 +#: whatsnew/2.6.rst:1730 msgid "" "Unicode strings now use faster code for detecting whitespace and line " "breaks; this speeds up the :meth:`split` method by about 25% and :meth:" @@ -12444,24 +12364,24 @@ msgid "" "reduced by using pymalloc for the Unicode string's data." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1736 +#: whatsnew/2.6.rst:1736 msgid "" "The ``with`` statement now stores the :meth:`__exit__` method on the stack, " "producing a small speedup. (Implemented by Jeffrey Yasskin.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1739 +#: whatsnew/2.6.rst:1739 msgid "" "To reduce memory usage, the garbage collector will now clear internal free " "lists when garbage-collecting the highest generation of objects. This may " "return memory to the operating system sooner." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1748 ../src/Doc/whatsnew/2.7.rst:892 +#: whatsnew/2.6.rst:1748 whatsnew/2.7.rst:892 msgid "Interpreter Changes" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1750 +#: whatsnew/2.6.rst:1750 msgid "" "Two command-line options have been reserved for use by other Python " "implementations. The :option:`-J` switch has been reserved for use by " @@ -12472,7 +12392,7 @@ msgid "" "the option isn't currently used." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1758 +#: whatsnew/2.6.rst:1758 msgid "" "Python can now be prevented from writing :file:`.pyc` or :file:`.pyo` files " "by supplying the :option:`-B` switch to the Python interpreter, or by " @@ -12483,7 +12403,7 @@ msgid "" "and Georg Brandl.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1766 +#: whatsnew/2.6.rst:1766 msgid "" "The encoding used for standard input, output, and standard error can be " "specified by setting the :envvar:`PYTHONIOENCODING` environment variable " @@ -12495,7 +12415,7 @@ msgid "" "\"replace\". (Contributed by Martin von Loewis.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1781 ../src/Doc/whatsnew/2.7.rst:1012 +#: whatsnew/2.6.rst:1781 whatsnew/2.7.rst:1012 msgid "" "As in every release, Python's standard library received a number of " "enhancements and bug fixes. Here's a partial list of the most notable " @@ -12504,14 +12424,14 @@ msgid "" "the Subversion logs for all the details." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1787 +#: whatsnew/2.6.rst:1787 msgid "" "The :mod:`asyncore` and :mod:`asynchat` modules are being actively " "maintained again, and a number of patches and bugfixes were applied. " "(Maintained by Josiah Carlson; see :issue:`1736190` for one patch.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1792 +#: whatsnew/2.6.rst:1792 msgid "" "The :mod:`bsddb` module also has a new maintainer, Jesús Cea Avion, and the " "package is now available as a standalone package. The web page for the " @@ -12521,14 +12441,14 @@ msgid "" "frequent than Python's." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1800 +#: whatsnew/2.6.rst:1800 msgid "" "The :mod:`bsddb.dbshelve` module now uses the highest pickling protocol " "available, instead of restricting itself to protocol 1. (Contributed by W. " "Barnes.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1804 +#: whatsnew/2.6.rst:1804 msgid "" "The :mod:`cgi` module will now read variables from the query string of an " "HTTP POST request. This makes it possible to use form actions with URLs " @@ -12536,7 +12456,7 @@ msgid "" "(Contributed by Alexandre Fiori and Nubis; :issue:`1817`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1810 +#: whatsnew/2.6.rst:1810 msgid "" "The :func:`parse_qs` and :func:`parse_qsl` functions have been relocated " "from the :mod:`cgi` module to the :mod:`urlparse` module. The versions still " @@ -12544,43 +12464,43 @@ msgid "" "`PendingDeprecationWarning` messages in 2.6 (:issue:`600362`)." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1816 +#: whatsnew/2.6.rst:1816 msgid "" "The :mod:`cmath` module underwent extensive revision, contributed by Mark " "Dickinson and Christian Heimes. Five new functions were added:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1820 +#: whatsnew/2.6.rst:1820 msgid "" ":func:`polar` converts a complex number to polar form, returning the modulus " "and argument of the complex number." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1823 +#: whatsnew/2.6.rst:1823 msgid "" ":func:`rect` does the opposite, turning a modulus, argument pair back into " "the corresponding complex number." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1826 +#: whatsnew/2.6.rst:1826 msgid "" ":func:`phase` returns the argument (also called the angle) of a complex " "number." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1829 +#: whatsnew/2.6.rst:1829 msgid "" ":func:`isnan` returns True if either the real or imaginary part of its " "argument is a NaN." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1832 +#: whatsnew/2.6.rst:1832 msgid "" ":func:`isinf` returns True if either the real or imaginary part of its " "argument is infinite." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1835 +#: whatsnew/2.6.rst:1835 msgid "" "The revisions also improved the numerical soundness of the :mod:`cmath` " "module. For all functions, the real and imaginary parts of the results are " @@ -12589,20 +12509,20 @@ msgid "" "`atanh`: and :func:`atan` have also been corrected." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1842 +#: whatsnew/2.6.rst:1842 msgid "" "The tests for the module have been greatly expanded; nearly 2000 new test " "cases exercise the algebraic functions." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1845 +#: whatsnew/2.6.rst:1845 msgid "" "On IEEE 754 platforms, the :mod:`cmath` module now handles IEEE 754 special " "values and floating-point exceptions in a manner consistent with Annex 'G' " "of the C99 standard." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1849 +#: whatsnew/2.6.rst:1849 msgid "" "A new data type in the :mod:`collections` module: :class:" "`namedtuple(typename, fieldnames)` is a factory function that creates " @@ -12610,7 +12530,7 @@ msgid "" "as index. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1871 +#: whatsnew/2.6.rst:1871 msgid "" "Several places in the standard library that returned tuples have been " "modified to return :class:`namedtuple` instances. For example, the :meth:" @@ -12618,7 +12538,7 @@ msgid "" "`digits`, and :attr:`exponent` fields." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1878 +#: whatsnew/2.6.rst:1878 msgid "" "Another change to the :mod:`collections` module is that the :class:`deque` " "type now supports an optional *maxlen* parameter; if supplied, the deque's " @@ -12626,7 +12546,7 @@ msgid "" "to a full deque causes old items to be discarded." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1899 +#: whatsnew/2.6.rst:1899 msgid "" "The :mod:`Cookie` module's :class:`Morsel` objects now support an :attr:" "`httponly` attribute. In some browsers. cookies with this attribute set " @@ -12634,14 +12554,14 @@ msgid "" "Schnell; :issue:`1638033`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1904 +#: whatsnew/2.6.rst:1904 msgid "" "A new window method in the :mod:`curses` module, :meth:`chgat`, changes the " "display attributes for a certain number of characters on a single line. " "(Contributed by Fabian Kreutz.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1914 +#: whatsnew/2.6.rst:1914 msgid "" "The :class:`Textbox` class in the :mod:`curses.textpad` module now supports " "editing in insert mode as well as overwrite mode. Insert mode is enabled by " @@ -12649,7 +12569,7 @@ msgid "" "class:`Textbox` instance." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1919 +#: whatsnew/2.6.rst:1919 msgid "" "The :mod:`datetime` module's :meth:`strftime` methods now support a ``%f`` " "format code that expands to the number of microseconds in the object, zero-" @@ -12657,7 +12577,7 @@ msgid "" "`1158`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1924 +#: whatsnew/2.6.rst:1924 msgid "" "The :mod:`decimal` module was updated to version 1.66 of `the General " "Decimal Specification <http://www2.hursley.ibm.com/decimal/decarith." @@ -12665,26 +12585,26 @@ msgid "" "functions such as :meth:`exp` and :meth:`log10`::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1936 +#: whatsnew/2.6.rst:1936 msgid "" "The :meth:`as_tuple` method of :class:`Decimal` objects now returns a named " "tuple with :attr:`sign`, :attr:`digits`, and :attr:`exponent` fields." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1939 +#: whatsnew/2.6.rst:1939 msgid "" "(Implemented by Facundo Batista and Mark Dickinson. Named tuple support " "added by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1942 +#: whatsnew/2.6.rst:1942 msgid "" "The :mod:`difflib` module's :class:`SequenceMatcher` class now returns named " "tuples representing matches, with :attr:`a`, :attr:`b`, and :attr:`size` " "attributes. (Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1947 +#: whatsnew/2.6.rst:1947 msgid "" "An optional ``timeout`` parameter, specifying a timeout measured in seconds, " "was added to the :class:`ftplib.FTP` class constructor as well as the :meth:" @@ -12694,7 +12614,7 @@ msgid "" "data has been sent. (Contributed by Phil Schwartz; :issue:`1221598`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1955 +#: whatsnew/2.6.rst:1955 msgid "" "The :func:`reduce` built-in function is also available in the :mod:" "`functools` module. In Python 3.0, the builtin has been dropped and :func:" @@ -12703,7 +12623,7 @@ msgid "" "issue:`1739906`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1961 +#: whatsnew/2.6.rst:1961 msgid "" "When possible, the :mod:`getpass` module will now use :file:`/dev/tty` to " "print a prompt message and read the password, falling back to standard error " @@ -12712,14 +12632,14 @@ msgid "" "P. Smith.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1967 +#: whatsnew/2.6.rst:1967 msgid "" "The :func:`glob.glob` function can now return Unicode filenames if a Unicode " "path was used and Unicode filenames are matched within the directory. (:" "issue:`1001604`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1971 +#: whatsnew/2.6.rst:1971 msgid "" "A new function in the :mod:`heapq` module, ``merge(iter1, iter2, ...)``, " "takes any number of iterables returning data in sorted order, and returns a " @@ -12727,14 +12647,14 @@ msgid "" "order. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1979 +#: whatsnew/2.6.rst:1979 msgid "" "Another new function, ``heappushpop(heap, item)``, pushes *item* onto " "*heap*, then pops off and returns the smallest item. This is more efficient " "than making a call to :func:`heappush` and then :func:`heappop`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1984 +#: whatsnew/2.6.rst:1984 msgid "" ":mod:`heapq` is now implemented to only use less-than comparison, instead of " "the less-than-or-equal comparison it previously used. This makes :mod:" @@ -12742,14 +12662,14 @@ msgid "" "by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1990 +#: whatsnew/2.6.rst:1990 msgid "" "An optional ``timeout`` parameter, specifying a timeout measured in seconds, " "was added to the :class:`httplib.HTTPConnection` and :class:" "`HTTPSConnection` class constructors. (Added by Facundo Batista.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:1995 +#: whatsnew/2.6.rst:1995 msgid "" "Most of the :mod:`inspect` module's functions, such as :func:`getmoduleinfo` " "and :func:`getargs`, now return named tuples. In addition to behaving like " @@ -12757,55 +12677,55 @@ msgid "" "attributes. (Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2001 +#: whatsnew/2.6.rst:2001 msgid "" "Some new functions in the module include :func:`isgenerator`, :func:" "`isgeneratorfunction`, and :func:`isabstract`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2005 +#: whatsnew/2.6.rst:2005 msgid "The :mod:`itertools` module gained several new functions." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2007 +#: whatsnew/2.6.rst:2007 msgid "" "``izip_longest(iter1, iter2, ...[, fillvalue])`` makes tuples from each of " "the elements; if some of the iterables are shorter than others, the missing " "values are set to *fillvalue*. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2014 +#: whatsnew/2.6.rst:2014 msgid "" "``product(iter1, iter2, ..., [repeat=N])`` returns the Cartesian product of " "the supplied iterables, a set of tuples containing every possible " "combination of the elements returned from each iterable. ::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2023 +#: whatsnew/2.6.rst:2023 msgid "" "The optional *repeat* keyword argument is used for taking the product of an " "iterable or a set of iterables with themselves, repeated *N* times. With a " "single iterable argument, *N*-tuples are returned::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2032 +#: whatsnew/2.6.rst:2032 msgid "With two iterables, *2N*-tuples are returned. ::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2040 +#: whatsnew/2.6.rst:2040 msgid "" "``combinations(iterable, r)`` returns sub-sequences of length *r* from the " "elements of *iterable*. ::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2051 +#: whatsnew/2.6.rst:2051 msgid "" "``permutations(iter[, r])`` returns all the permutations of length *r* of " "the iterable's elements. If *r* is not specified, it will default to the " "number of elements produced by the iterable. ::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2061 +#: whatsnew/2.6.rst:2061 msgid "" "``itertools.chain(*iterables)`` is an existing function in :mod:`itertools` " "that gained a new constructor in Python 2.6. ``itertools.chain." @@ -12814,11 +12734,11 @@ msgid "" "iterable, then all the elements of the second, and so on. ::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2071 +#: whatsnew/2.6.rst:2071 msgid "(All contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2073 +#: whatsnew/2.6.rst:2073 msgid "" "The :mod:`logging` module's :class:`FileHandler` class and its subclasses :" "class:`WatchedFileHandler`, :class:`RotatingFileHandler`, and :class:" @@ -12827,68 +12747,68 @@ msgid "" "the first :meth:`emit` call is made. (Contributed by Vinay Sajip.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2080 +#: whatsnew/2.6.rst:2080 msgid "" ":class:`TimedRotatingFileHandler` also has a *utc* constructor parameter. " "If the argument is true, UTC time will be used in determining when midnight " "occurs and in generating filenames; otherwise local time will be used." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2085 +#: whatsnew/2.6.rst:2085 msgid "Several new functions were added to the :mod:`math` module:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2087 +#: whatsnew/2.6.rst:2087 msgid "" ":func:`~math.isinf` and :func:`~math.isnan` determine whether a given float " "is a (positive or negative) infinity or a NaN (Not a Number), respectively." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2090 +#: whatsnew/2.6.rst:2090 msgid "" ":func:`~math.copysign` copies the sign bit of an IEEE 754 number, returning " "the absolute value of *x* combined with the sign bit of *y*. For example, " "``math.copysign(1, -0.0)`` returns -1.0. (Contributed by Christian Heimes.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2095 +#: whatsnew/2.6.rst:2095 msgid "" ":func:`~math.factorial` computes the factorial of a number. (Contributed by " "Raymond Hettinger; :issue:`2138`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2098 +#: whatsnew/2.6.rst:2098 msgid "" ":func:`~math.fsum` adds up the stream of numbers from an iterable, and is " "careful to avoid loss of precision through using partial sums. (Contributed " "by Jean Brouwers, Raymond Hettinger, and Mark Dickinson; :issue:`2819`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2103 +#: whatsnew/2.6.rst:2103 msgid "" ":func:`~math.acosh`, :func:`~math.asinh` and :func:`~math.atanh` compute the " "inverse hyperbolic functions." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2106 +#: whatsnew/2.6.rst:2106 msgid ":func:`~math.log1p` returns the natural logarithm of *1+x* (base *e*)." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2109 +#: whatsnew/2.6.rst:2109 msgid "" ":func:`trunc` rounds a number toward zero, returning the closest :class:" "`Integral` that's between the function's argument and zero. Added as part of " "the backport of `PEP 3141's type hierarchy for numbers <#pep-3141>`__." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2114 +#: whatsnew/2.6.rst:2114 msgid "" "The :mod:`math` module has been improved to give more consistent behaviour " "across platforms, especially with respect to handling of floating-point " "exceptions and IEEE 754 special values." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2118 +#: whatsnew/2.6.rst:2118 msgid "" "Whenever possible, the module follows the recommendations of the C99 " "standard about 754's special values. For example, ``sqrt(-1.)`` should now " @@ -12900,11 +12820,11 @@ msgid "" "`OverflowError`. (See :issue:`711019` and :issue:`1640`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2128 +#: whatsnew/2.6.rst:2128 msgid "(Contributed by Christian Heimes and Mark Dickinson.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2130 +#: whatsnew/2.6.rst:2130 msgid "" ":class:`mmap` objects now have a :meth:`rfind` method that searches for a " "substring beginning at the end of the string and searching backwards. The :" @@ -12912,28 +12832,28 @@ msgid "" "to stop searching. (Contributed by John Lenton.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2136 +#: whatsnew/2.6.rst:2136 msgid "" "The :mod:`operator` module gained a :func:`methodcaller` function that takes " "a name and an optional set of arguments, returning a callable that will call " "the named function on any arguments passed to it. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2146 +#: whatsnew/2.6.rst:2146 msgid "(Contributed by Georg Brandl, after a suggestion by Gregory Petrosyan.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2148 +#: whatsnew/2.6.rst:2148 msgid "" "The :func:`attrgetter` function now accepts dotted names and performs the " "corresponding attribute lookups::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2158 +#: whatsnew/2.6.rst:2158 msgid "(Contributed by Georg Brandl, after a suggestion by Barry Warsaw.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2160 +#: whatsnew/2.6.rst:2160 msgid "" "The :mod:`os` module now wraps several new system calls. ``fchmod(fd, " "mode)`` and ``fchown(fd, uid, gid)`` change the mode and ownership of an " @@ -12941,7 +12861,7 @@ msgid "" "(Contributed by Georg Brandl and Christian Heimes.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2166 +#: whatsnew/2.6.rst:2166 msgid "" ":func:`chflags` and :func:`lchflags` are wrappers for the corresponding " "system calls (where they're available), changing the flags set on a file. " @@ -12951,7 +12871,7 @@ msgid "" "the file. (Contributed by M. Levinson.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2174 +#: whatsnew/2.6.rst:2174 msgid "" "``os.closerange(low, high)`` efficiently closes all file descriptors from " "*low* to *high*, ignoring any errors and not including *high* itself. This " @@ -12959,14 +12879,14 @@ msgid "" "processes faster. (Contributed by Georg Brandl; :issue:`1663329`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2179 +#: whatsnew/2.6.rst:2179 msgid "" "The ``os.environ`` object's :meth:`clear` method will now unset the " "environment variables using :func:`os.unsetenv` in addition to clearing the " "object's keys. (Contributed by Martin Horcicka; :issue:`1181`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2183 +#: whatsnew/2.6.rst:2183 msgid "" "The :func:`os.walk` function now has a ``followlinks`` parameter. If set to " "True, it will follow symlinks pointing to directories and visit the " @@ -12975,7 +12895,7 @@ msgid "" "if there's a symlink that points to a parent directory. (:issue:`1273829`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2190 +#: whatsnew/2.6.rst:2190 msgid "" "In the :mod:`os.path` module, the :func:`splitext` function has been changed " "to not split on leading period characters. This produces better results when " @@ -12984,7 +12904,7 @@ msgid "" "`1115886`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2197 +#: whatsnew/2.6.rst:2197 msgid "" "A new function, ``os.path.relpath(path, start='.')``, returns a relative " "path from the ``start`` path, if it's supplied, or from the current working " @@ -12992,14 +12912,14 @@ msgid "" "issue:`1339796`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2202 +#: whatsnew/2.6.rst:2202 msgid "" "On Windows, :func:`os.path.expandvars` will now expand environment variables " "given in the form \"%var%\", and \"~user\" will be expanded into the user's " "home directory path. (Contributed by Josiah Carlson; :issue:`957650`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2207 +#: whatsnew/2.6.rst:2207 msgid "" "The Python debugger provided by the :mod:`pdb` module gained a new command: " "\"run\" restarts the Python program being debugged and can optionally take " @@ -13007,14 +12927,14 @@ msgid "" "Bernstein; :issue:`1393667`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2212 +#: whatsnew/2.6.rst:2212 msgid "" "The :func:`pdb.post_mortem` function, used to begin debugging a traceback, " "will now use the traceback returned by :func:`sys.exc_info` if no traceback " "is supplied. (Contributed by Facundo Batista; :issue:`1106316`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2217 +#: whatsnew/2.6.rst:2217 msgid "" "The :mod:`pickletools` module now has an :func:`optimize` function that " "takes a string containing a pickle and removes some unused opcodes, " @@ -13022,25 +12942,25 @@ msgid "" "(Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2222 +#: whatsnew/2.6.rst:2222 msgid "" "A :func:`get_data` function was added to the :mod:`pkgutil` module that " "returns the contents of resource files included with an installed Python " "package. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2237 +#: whatsnew/2.6.rst:2237 msgid "(Contributed by Paul Moore; :issue:`2439`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2239 +#: whatsnew/2.6.rst:2239 msgid "" "The :mod:`pyexpat` module's :class:`Parser` objects now allow setting their :" "attr:`buffer_size` attribute to change the size of the buffer used to hold " "character data. (Contributed by Achim Gaedke; :issue:`1137`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2244 +#: whatsnew/2.6.rst:2244 msgid "" "The :mod:`Queue` module now provides queue variants that retrieve entries in " "different orders. The :class:`PriorityQueue` class stores queued items in a " @@ -13049,7 +12969,7 @@ msgid "" "(Contributed by Raymond Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2251 +#: whatsnew/2.6.rst:2251 msgid "" "The :mod:`random` module's :class:`Random` objects can now be pickled on a " "32-bit system and unpickled on a 64-bit system, and vice versa. " @@ -13058,7 +12978,7 @@ msgid "" "(Contributed by Shawn Ligocki; :issue:`1727780`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2258 +#: whatsnew/2.6.rst:2258 msgid "" "The new ``triangular(low, high, mode)`` function returns random numbers " "following a triangular distribution. The returned values are between *low* " @@ -13067,14 +12987,14 @@ msgid "" "der Laan and Raymond Hettinger; :issue:`1681432`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2265 +#: whatsnew/2.6.rst:2265 msgid "" "Long regular expression searches carried out by the :mod:`re` module will " "check for signals being delivered, so time-consuming searches can now be " "interrupted. (Contributed by Josh Hoyt and Ralf Schmitt; :issue:`846388`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2270 +#: whatsnew/2.6.rst:2270 msgid "" "The regular expression module is implemented by compiling bytecodes for a " "tiny regex-specific virtual machine. Untrusted code could create malicious " @@ -13083,14 +13003,14 @@ msgid "" "for Google App Engine; :issue:`3487`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2277 +#: whatsnew/2.6.rst:2277 msgid "" "The :mod:`rlcompleter` module's :meth:`Completer.complete()` method will now " "ignore exceptions triggered while evaluating a name. (Fixed by Lorenz " "Quack; :issue:`2250`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2281 +#: whatsnew/2.6.rst:2281 msgid "" "The :mod:`sched` module's :class:`scheduler` instances now have a read-only :" "attr:`queue` attribute that returns the contents of the scheduler's queue, " @@ -13099,7 +13019,7 @@ msgid "" msgstr "" # ebb06c8495b94e83b283eb509808a501 -#: ../src/Doc/whatsnew/2.6.rst:2287 +#: whatsnew/2.6.rst:2287 msgid "" "The :mod:`select` module now has wrapper functions for the Linux :c:func:" "`epoll` and BSD :c:func:`kqueue` system calls. :meth:`modify` method was " @@ -13109,7 +13029,7 @@ msgid "" "Heimes; :issue:`1657`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2295 +#: whatsnew/2.6.rst:2295 msgid "" "The :func:`shutil.copytree` function now has an optional *ignore* argument " "that takes a callable object. This callable will receive each directory " @@ -13117,7 +13037,7 @@ msgid "" "that will be ignored, not copied." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2300 +#: whatsnew/2.6.rst:2300 msgid "" "The :mod:`shutil` module also provides an :func:`ignore_patterns` function " "for use with this new parameter. :func:`ignore_patterns` takes an arbitrary " @@ -13127,13 +13047,13 @@ msgid "" "Emacs backup files, which have names ending with '~'::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2311 +#: whatsnew/2.6.rst:2311 #, fuzzy msgid "(Contributed by Tarek Ziadé; :issue:`2663`.)" msgstr "(Contribution par Antoine Pitrou; :issue:`3001`.)" # 86357277da31404ba443c4b4225a7733 -#: ../src/Doc/whatsnew/2.6.rst:2313 +#: whatsnew/2.6.rst:2313 msgid "" "Integrating signal handling with GUI handling event loops like those used by " "Tkinter or GTk+ has long been a problem; most software ends up polling, " @@ -13146,7 +13066,7 @@ msgid "" msgstr "" # 9b70eaeda526450096bafddc61f4c75d -#: ../src/Doc/whatsnew/2.6.rst:2323 +#: whatsnew/2.6.rst:2323 msgid "" "Event loops will use this by opening a pipe to create two descriptors, one " "for reading and one for writing. The writable descriptor will be passed to :" @@ -13156,18 +13076,18 @@ msgid "" "loop will be woken up, avoiding the need to poll." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2331 +#: whatsnew/2.6.rst:2331 msgid "(Contributed by Adam Olsen; :issue:`1583`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2333 +#: whatsnew/2.6.rst:2333 msgid "" "The :func:`siginterrupt` function is now available from Python code, and " "allows changing whether signals can interrupt system calls or not. " "(Contributed by Ralf Schmitt.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2337 +#: whatsnew/2.6.rst:2337 msgid "" "The :func:`setitimer` and :func:`getitimer` functions have also been added " "(where they're available). :func:`setitimer` allows setting interval timers " @@ -13176,7 +13096,7 @@ msgid "" "+system time. (Contributed by Guilherme Polo; :issue:`2240`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2344 +#: whatsnew/2.6.rst:2344 msgid "" "The :mod:`smtplib` module now supports SMTP over SSL thanks to the addition " "of the :class:`SMTP_SSL` class. This class supports an interface identical " @@ -13186,7 +13106,7 @@ msgid "" "seconds. (Contributed by Facundo Batista.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2352 +#: whatsnew/2.6.rst:2352 msgid "" "An implementation of the LMTP protocol (:rfc:`2033`) was also added to the " "module. LMTP is used in place of SMTP when transferring e-mail between " @@ -13194,7 +13114,7 @@ msgid "" "issue:`957003`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2357 +#: whatsnew/2.6.rst:2357 msgid "" ":meth:`SMTP.starttls` now complies with :rfc:`3207` and forgets any " "knowledge obtained from the server not obtained from the TLS negotiation " @@ -13202,7 +13122,7 @@ msgid "" msgstr "" # 1865ce388a63489fabeedeb71416c2d6 -#: ../src/Doc/whatsnew/2.6.rst:2362 +#: whatsnew/2.6.rst:2362 msgid "" "The :mod:`socket` module now supports TIPC (http://tipc.sourceforge.net/), a " "high-performance non-IP-based protocol designed for use in clustered " @@ -13210,7 +13130,7 @@ msgid "" "Bertogli; :issue:`1646`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2367 +#: whatsnew/2.6.rst:2367 msgid "" "A new function, :func:`create_connection`, takes an address and connects to " "it using an optional timeout value, returning the connected socket object. " @@ -13220,7 +13140,7 @@ msgid "" "make your code work with IPv6." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2375 +#: whatsnew/2.6.rst:2375 msgid "" "The base classes in the :mod:`SocketServer` module now support calling a :" "meth:`handle_timeout` method after a span of inactivity specified by the " @@ -13231,21 +13151,21 @@ msgid "" "`742598`, :issue:`1193577`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2384 +#: whatsnew/2.6.rst:2384 msgid "" "The :mod:`sqlite3` module, maintained by Gerhard Haering, has been updated " "from version 2.3.2 in Python 2.5 to version 2.4.1." msgstr "" # 90f7592f51c6421d8b599b083149869c -#: ../src/Doc/whatsnew/2.6.rst:2388 +#: whatsnew/2.6.rst:2388 msgid "" "The :mod:`struct` module now supports the C99 :c:type:`_Bool` type, using " "the format character ``'?'``. (Contributed by David Remahl.)" msgstr "" # 67df9e0ee30b49ada2d5839c045faf17 -#: ../src/Doc/whatsnew/2.6.rst:2392 +#: whatsnew/2.6.rst:2392 msgid "" "The :class:`Popen` objects provided by the :mod:`subprocess` module now " "have :meth:`terminate`, :meth:`kill`, and :meth:`send_signal` methods. On " @@ -13254,7 +13174,7 @@ msgid "" "`TerminateProcess`. (Contributed by Christian Heimes.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2399 +#: whatsnew/2.6.rst:2399 msgid "" "A new variable in the :mod:`sys` module, :attr:`float_info`, is an object " "containing information derived from the :file:`float.h` file about the " @@ -13264,7 +13184,7 @@ msgid "" "several others. (Contributed by Christian Heimes; :issue:`1534`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2407 +#: whatsnew/2.6.rst:2407 msgid "" "Another new variable, :attr:`dont_write_bytecode`, controls whether Python " "writes any :file:`.pyc` or :file:`.pyo` files on importing a module. If this " @@ -13276,7 +13196,7 @@ msgid "" "written or not. (Contributed by Neal Norwitz and Georg Brandl.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2418 +#: whatsnew/2.6.rst:2418 msgid "" "Information about the command-line arguments supplied to the Python " "interpreter is available by reading attributes of a named tuple available as " @@ -13285,7 +13205,7 @@ msgid "" "These attributes are all read-only. (Contributed by Christian Heimes.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2426 +#: whatsnew/2.6.rst:2426 msgid "" "A new function, :func:`getsizeof`, takes a Python object and returns the " "amount of memory used by the object, measured in bytes. Built-in objects " @@ -13294,14 +13214,14 @@ msgid "" "Schuppenies; :issue:`2898`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2433 +#: whatsnew/2.6.rst:2433 msgid "" "It's now possible to determine the current profiler and tracer functions by " "calling :func:`sys.getprofile` and :func:`sys.gettrace`. (Contributed by " "Georg Brandl; :issue:`1648`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2437 +#: whatsnew/2.6.rst:2437 msgid "" "The :mod:`tarfile` module now supports POSIX.1-2001 (pax) tarfiles in " "addition to the POSIX.1-1988 (ustar) and GNU tar formats that were already " @@ -13309,7 +13229,7 @@ msgid "" "to open a file using a different format::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2445 +#: whatsnew/2.6.rst:2445 msgid "" "The new ``encoding`` and ``errors`` parameters specify an encoding and an " "error handling scheme for character conversions. ``'strict'``, " @@ -13319,7 +13239,7 @@ msgid "" "PAX format supports Unicode filenames, defaulting to UTF-8 encoding.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2453 +#: whatsnew/2.6.rst:2453 msgid "" "The :meth:`TarFile.add` method now accepts an ``exclude`` argument that's a " "function that can be used to exclude certain filenames from an archive. The " @@ -13329,18 +13249,18 @@ msgid "" "added directories." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2461 +#: whatsnew/2.6.rst:2461 msgid "(All changes contributed by Lars Gustäbel)." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2463 +#: whatsnew/2.6.rst:2463 msgid "" "An optional ``timeout`` parameter was added to the :class:`telnetlib.Telnet` " "class constructor, specifying a timeout measured in seconds. (Added by " "Facundo Batista.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2467 +#: whatsnew/2.6.rst:2467 msgid "" "The :class:`tempfile.NamedTemporaryFile` class usually deletes the temporary " "file it created when the file is closed. This behaviour can now be changed " @@ -13348,7 +13268,7 @@ msgid "" "Miller; :issue:`1537850`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2472 +#: whatsnew/2.6.rst:2472 msgid "" "A new class, :class:`SpooledTemporaryFile`, behaves like a temporary file " "but stores its data in memory until a maximum size is exceeded. On reaching " @@ -13356,7 +13276,7 @@ msgid "" "(Contributed by Dustin J. Mitchell.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2477 +#: whatsnew/2.6.rst:2477 msgid "" "The :class:`NamedTemporaryFile` and :class:`SpooledTemporaryFile` classes " "both work as context managers, so you can write ``with tempfile." @@ -13364,7 +13284,7 @@ msgid "" "issue:`2021`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2482 +#: whatsnew/2.6.rst:2482 msgid "" "The :mod:`test.test_support` module gained a number of context managers " "useful for writing tests. :func:`EnvironmentVarGuard` is a context manager " @@ -13372,7 +13292,7 @@ msgid "" "them to their old values." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2488 +#: whatsnew/2.6.rst:2488 msgid "" "Another context manager, :class:`TransientResource`, can surround calls to " "resources that may or may not be available; it will catch and ignore a " @@ -13380,29 +13300,29 @@ msgid "" "certain failures when connecting to an external web site::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2499 +#: whatsnew/2.6.rst:2499 msgid "" "Finally, :func:`check_warnings` resets the :mod:`warning` module's warning " "filters and returns an object that will record all warning messages " "triggered (:issue:`3781`)::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2509 +#: whatsnew/2.6.rst:2509 msgid "(Contributed by Brett Cannon.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2511 +#: whatsnew/2.6.rst:2511 msgid "" "The :mod:`textwrap` module can now preserve existing whitespace at the " "beginnings and ends of the newly-created lines by specifying " "``drop_whitespace=False`` as an argument::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2530 +#: whatsnew/2.6.rst:2530 msgid "(Contributed by Dwayne Bailey; :issue:`1581073`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2532 +#: whatsnew/2.6.rst:2532 msgid "" "The :mod:`threading` module API is being changed to use properties such as :" "attr:`daemon` instead of :meth:`setDaemon` and :meth:`isDaemon` methods, and " @@ -13415,14 +13335,14 @@ msgid "" "Peterson.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2543 +#: whatsnew/2.6.rst:2543 msgid "" "The :mod:`threading` module's :class:`Thread` objects gained an :attr:" "`ident` property that returns the thread's identifier, a nonzero integer. " "(Contributed by Gregory P. Smith; :issue:`2871`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2548 +#: whatsnew/2.6.rst:2548 msgid "" "The :mod:`timeit` module now accepts callables as well as strings for the " "statement being timed and for the setup code. Two convenience functions were " @@ -13432,62 +13352,62 @@ msgid "" "issue:`1533909`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2557 +#: whatsnew/2.6.rst:2557 msgid "" "The :mod:`Tkinter` module now accepts lists and tuples for options, " "separating the elements by spaces before passing the resulting value to Tcl/" "Tk. (Contributed by Guilherme Polo; :issue:`2906`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2562 +#: whatsnew/2.6.rst:2562 msgid "" "The :mod:`turtle` module for turtle graphics was greatly enhanced by Gregor " "Lingl. New features in the module include:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2565 +#: whatsnew/2.6.rst:2565 msgid "Better animation of turtle movement and rotation." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2566 +#: whatsnew/2.6.rst:2566 msgid "" "Control over turtle movement using the new :meth:`delay`, :meth:`tracer`, " "and :meth:`speed` methods." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2568 +#: whatsnew/2.6.rst:2568 msgid "" "The ability to set new shapes for the turtle, and to define a new coordinate " "system." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2570 +#: whatsnew/2.6.rst:2570 msgid "Turtles now have an :meth:`undo()` method that can roll back actions." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2571 +#: whatsnew/2.6.rst:2571 msgid "" "Simple support for reacting to input events such as mouse and keyboard " "activity, making it possible to write simple games." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2573 +#: whatsnew/2.6.rst:2573 msgid "" "A :file:`turtle.cfg` file can be used to customize the starting appearance " "of the turtle's screen." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2575 +#: whatsnew/2.6.rst:2575 msgid "" "The module's docstrings can be replaced by new docstrings that have been " "translated into another language." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2578 +#: whatsnew/2.6.rst:2578 msgid "(:issue:`1513695`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2580 +#: whatsnew/2.6.rst:2580 msgid "" "An optional ``timeout`` parameter was added to the :func:`urllib.urlopen` " "function and the :class:`urllib.ftpwrapper` class constructor, as well as " @@ -13495,17 +13415,17 @@ msgid "" "measured in seconds. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2593 +#: whatsnew/2.6.rst:2593 msgid "(Added by Facundo Batista.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2595 +#: whatsnew/2.6.rst:2595 msgid "" "The Unicode database provided by the :mod:`unicodedata` module has been " "updated to version 5.1.0. (Updated by Martin von Loewis; :issue:`3811`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2599 +#: whatsnew/2.6.rst:2599 msgid "" "The :mod:`warnings` module's :func:`formatwarning` and :func:`showwarning` " "gained an optional *line* argument that can be used to supply the line of " @@ -13513,14 +13433,14 @@ msgid "" "of the :mod:`warnings` module in C code.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2604 +#: whatsnew/2.6.rst:2604 msgid "" "A new function, :func:`catch_warnings`, is a context manager intended for " "testing purposes that lets you temporarily modify the warning filters and " "then restore their original values (:issue:`3781`)." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2608 +#: whatsnew/2.6.rst:2608 msgid "" "The XML-RPC :class:`SimpleXMLRPCServer` and :class:`DocXMLRPCServer` classes " "can now be prevented from immediately opening and binding to their socket by " @@ -13531,7 +13451,7 @@ msgid "" "Peter Parente; :issue:`1599845`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2617 +#: whatsnew/2.6.rst:2617 msgid "" ":class:`SimpleXMLRPCServer` also has a :attr:`_send_traceback_header` " "attribute; if true, the exception and formatted traceback are returned as " @@ -13542,7 +13462,7 @@ msgid "" "Code 2007.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2625 +#: whatsnew/2.6.rst:2625 msgid "" "The :mod:`xmlrpclib` module no longer automatically converts :class:" "`datetime.date` and :class:`datetime.time` to the :class:`xmlrpclib." @@ -13554,18 +13474,18 @@ msgid "" "Riku Lindblad; :issue:`2985`)." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2635 +#: whatsnew/2.6.rst:2635 msgid "" "The :mod:`zipfile` module's :class:`ZipFile` class now has :meth:`extract` " "and :meth:`extractall` methods that will unpack a single file or all the " "files in the archive to the current directory, or to a specified directory::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2649 +#: whatsnew/2.6.rst:2649 msgid "(Contributed by Alan McIntyre; :issue:`467924`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2651 +#: whatsnew/2.6.rst:2651 msgid "" "The :meth:`open`, :meth:`read` and :meth:`extract` methods can now take " "either a filename or a :class:`ZipInfo` object. This is useful when an " @@ -13573,17 +13493,17 @@ msgid "" "Horler; :issue:`1775025`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2656 +#: whatsnew/2.6.rst:2656 msgid "" "Finally, :mod:`zipfile` now supports using Unicode filenames for archived " "files. (Contributed by Alexey Borzenkov; :issue:`1734346`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2663 +#: whatsnew/2.6.rst:2663 msgid "The :mod:`ast` module" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2665 +#: whatsnew/2.6.rst:2665 msgid "" "The :mod:`ast` module provides an Abstract Syntax Tree representation of " "Python code, and Armin Ronacher contributed a set of helper functions that " @@ -13591,17 +13511,17 @@ msgid "" "packages, code analyzers, and similar tools that process Python code." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2672 +#: whatsnew/2.6.rst:2672 msgid "" "The :func:`parse` function takes an expression and returns an AST. The :func:" "`dump` function outputs a representation of a tree, suitable for debugging::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2686 +#: whatsnew/2.6.rst:2686 msgid "This outputs a deeply nested tree::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2719 +#: whatsnew/2.6.rst:2719 msgid "" "The :func:`literal_eval` method takes a string or an AST representing a " "literal expression, parses and evaluates it, and returns the resulting " @@ -13611,18 +13531,18 @@ msgid "" "an :func:`eval` call, :func:`literal_eval` will handle it safely::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2735 +#: whatsnew/2.6.rst:2735 msgid "" "The module also includes :class:`NodeVisitor` and :class:`NodeTransformer` " "classes for traversing and modifying an AST, and functions for common " "transformations such as changing line numbers." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2743 +#: whatsnew/2.6.rst:2743 msgid "The :mod:`future_builtins` module" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2745 +#: whatsnew/2.6.rst:2745 msgid "" "Python 3.0 makes many changes to the repertoire of built-in functions, and " "most of the changes can't be introduced in the Python 2.x series because " @@ -13631,24 +13551,24 @@ msgid "" "compatible code." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2752 +#: whatsnew/2.6.rst:2752 msgid "The functions in this module currently include:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2754 +#: whatsnew/2.6.rst:2754 msgid "" "``ascii(obj)``: equivalent to :func:`repr`. In Python 3.0, :func:`repr` " "will return a Unicode string, while :func:`ascii` will return a pure ASCII " "bytestring." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2758 +#: whatsnew/2.6.rst:2758 msgid "" "``filter(predicate, iterable)``, ``map(func, iterable1, ...)``: the 3.0 " "versions return iterators, unlike the 2.x builtins which return lists." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2762 +#: whatsnew/2.6.rst:2762 msgid "" "``hex(value)``, ``oct(value)``: instead of calling the :meth:`__hex__` or :" "meth:`__oct__` methods, these versions will call the :meth:`__index__` " @@ -13656,11 +13576,11 @@ msgid "" "the new ``0o`` notation for its result." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2771 +#: whatsnew/2.6.rst:2771 msgid "The :mod:`json` module: JavaScript Object Notation" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2773 +#: whatsnew/2.6.rst:2773 msgid "" "The new :mod:`json` module supports the encoding and decoding of Python " "types in JSON (Javascript Object Notation). JSON is a lightweight " @@ -13668,34 +13588,34 @@ msgid "" "about JSON, see http://www.json.org." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2778 +#: whatsnew/2.6.rst:2778 msgid "" ":mod:`json` comes with support for decoding and encoding most built-in " "Python types. The following example encodes and decodes a dictionary::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2789 +#: whatsnew/2.6.rst:2789 msgid "" "It's also possible to write your own decoders and encoders to support more " "types. Pretty-printing of the JSON strings is also supported." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2792 +#: whatsnew/2.6.rst:2792 msgid ":mod:`json` (originally called simplejson) was written by Bob Ippolito." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2799 +#: whatsnew/2.6.rst:2799 msgid "The :mod:`plistlib` module: A Property-List Parser" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2801 +#: whatsnew/2.6.rst:2801 msgid "" "The ``.plist`` format is commonly used on Mac OS X to store basic data types " "(numbers, strings, lists, and dictionaries) by serializing them into an XML-" "based format. It resembles the XML-RPC serialization of data types." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2806 +#: whatsnew/2.6.rst:2806 msgid "" "Despite being primarily used on Mac OS X, the format has nothing Mac-" "specific about it and the Python implementation works on any platform that " @@ -13703,33 +13623,33 @@ msgid "" "standard library." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2811 +#: whatsnew/2.6.rst:2811 msgid "Using the module is simple::" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2838 +#: whatsnew/2.6.rst:2838 msgid "ctypes Enhancements" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2840 +#: whatsnew/2.6.rst:2840 msgid "" "Thomas Heller continued to maintain and enhance the :mod:`ctypes` module." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2843 +#: whatsnew/2.6.rst:2843 msgid "" ":mod:`ctypes` now supports a :class:`c_bool` datatype that represents the " "C99 ``bool`` type. (Contributed by David Remahl; :issue:`1649190`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2847 +#: whatsnew/2.6.rst:2847 msgid "" "The :mod:`ctypes` string, buffer and array types have improved support for " "extended slicing syntax, where various combinations of ``(start, stop, " "step)`` are supplied. (Implemented by Thomas Wouters.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2854 +#: whatsnew/2.6.rst:2854 msgid "" "All :mod:`ctypes` data types now support :meth:`from_buffer` and :meth:" "`from_buffer_copy` methods that create a ctypes instance based on a provided " @@ -13737,14 +13657,14 @@ msgid "" "while :meth:`from_buffer` will share the same memory area." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2861 +#: whatsnew/2.6.rst:2861 msgid "" "A new calling convention tells :mod:`ctypes` to clear the ``errno`` or Win32 " "LastError variables at the outset of each wrapped call. (Implemented by " "Thomas Heller; :issue:`1798`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2865 +#: whatsnew/2.6.rst:2865 msgid "" "You can now retrieve the Unix ``errno`` variable after a function call. " "When creating a wrapped function, you can supply ``use_errno=True`` as a " @@ -13753,7 +13673,7 @@ msgid "" "error value." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2871 +#: whatsnew/2.6.rst:2871 msgid "" "The Win32 LastError variable is similarly supported by the :func:`DLL`, :" "func:`OleDLL`, and :func:`WinDLL` functions. You supply " @@ -13761,18 +13681,18 @@ msgid "" "level methods :meth:`set_last_error` and :meth:`get_last_error`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2877 +#: whatsnew/2.6.rst:2877 msgid "" "The :func:`byref` function, used to retrieve a pointer to a ctypes instance, " "now has an optional *offset* parameter that is a byte count that will be " "added to the returned pointer." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2884 +#: whatsnew/2.6.rst:2884 msgid "Improved SSL Support" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2886 +#: whatsnew/2.6.rst:2886 msgid "" "Bill Janssen made extensive improvements to Python 2.6's support for the " "Secure Sockets Layer by adding a new module, :mod:`ssl`, that's built atop " @@ -13783,7 +13703,7 @@ msgid "" "removed and continues to work, though it will be removed in Python 3.0." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2895 +#: whatsnew/2.6.rst:2895 msgid "" "To use the new module, you must first create a TCP connection in the usual " "way and then pass it to the :func:`ssl.wrap_socket` function. It's possible " @@ -13791,35 +13711,35 @@ msgid "" "by calling the :meth:`getpeercert` method." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2902 +#: whatsnew/2.6.rst:2902 msgid "The documentation for the :mod:`ssl` module." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2907 +#: whatsnew/2.6.rst:2907 msgid "Deprecations and Removals" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2909 ../src/Doc/whatsnew/2.6.rst:3237 +#: whatsnew/2.6.rst:2909 whatsnew/2.6.rst:3237 msgid "" "String exceptions have been removed. Attempting to use them raises a :exc:" "`TypeError`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2912 +#: whatsnew/2.6.rst:2912 msgid "" "Changes to the :class:`Exception` interface as dictated by :pep:`352` " "continue to be made. For 2.6, the :attr:`message` attribute is being " "deprecated in favor of the :attr:`args` attribute." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2917 +#: whatsnew/2.6.rst:2917 msgid "" "(3.0-warning mode) Python 3.0 will feature a reorganized standard library " "that will drop many outdated modules and rename others. Python 2.6 running " "in 3.0-warning mode will warn about these modules when they are imported." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2922 +#: whatsnew/2.6.rst:2922 msgid "" "The list of deprecated modules is: :mod:`audiodev`, :mod:`bgenlocations`, :" "mod:`buildtools`, :mod:`bundlebuilder`, :mod:`Canvas`, :mod:`compiler`, :mod:" @@ -13829,66 +13749,66 @@ msgid "" "`statvfs`, :mod:`sunaudiodev`, :mod:`test.testall`, and :mod:`toaiff`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2947 +#: whatsnew/2.6.rst:2947 msgid "The :mod:`gopherlib` module has been removed." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2949 +#: whatsnew/2.6.rst:2949 msgid "" "The :mod:`MimeWriter` module and :mod:`mimify` module have been deprecated; " "use the :mod:`email` package instead." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2953 +#: whatsnew/2.6.rst:2953 msgid "" "The :mod:`md5` module has been deprecated; use the :mod:`hashlib` module " "instead." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2956 +#: whatsnew/2.6.rst:2956 msgid "" "The :mod:`posixfile` module has been deprecated; :func:`fcntl.lockf` " "provides better locking." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2959 +#: whatsnew/2.6.rst:2959 msgid "" "The :mod:`popen2` module has been deprecated; use the :mod:`subprocess` " "module." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2962 +#: whatsnew/2.6.rst:2962 msgid "The :mod:`rgbimg` module has been removed." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2964 +#: whatsnew/2.6.rst:2964 msgid "" "The :mod:`sets` module has been deprecated; it's better to use the built-in :" "class:`set` and :class:`frozenset` types." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2967 +#: whatsnew/2.6.rst:2967 msgid "" "The :mod:`sha` module has been deprecated; use the :mod:`hashlib` module " "instead." msgstr "" # cc38f69b537542d3b009dcdbcd217905 -#: ../src/Doc/whatsnew/2.6.rst:2979 +#: whatsnew/2.6.rst:2979 msgid "" "Python now must be compiled with C89 compilers (after 19 years!). This " "means that the Python source tree has dropped its own implementations of :c:" "func:`memmove` and :c:func:`strerror`, which are in the C89 standard library." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2984 +#: whatsnew/2.6.rst:2984 msgid "" "Python 2.6 can be built with Microsoft Visual Studio 2008 (version 9.0), and " "this is the new default compiler. See the :file:`PCbuild` directory for the " "build files. (Implemented by Christian Heimes.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2989 +#: whatsnew/2.6.rst:2989 msgid "" "On Mac OS X, Python 2.6 can be compiled as a 4-way universal build. The :" "program:`configure` script can take a :option:`--with-universal-archs=[32-" @@ -13897,7 +13817,7 @@ msgid "" "(Contributed by Ronald Oussoren.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:2996 +#: whatsnew/2.6.rst:2996 msgid "" "The BerkeleyDB module now has a C API object, available as ``bsddb.db." "api``. This object can be used by other C extensions that wish to use the :" @@ -13905,7 +13825,7 @@ msgid "" msgstr "" # cdf4a2a94ad44b7ab2343a983e697fbe -#: ../src/Doc/whatsnew/2.6.rst:3001 +#: whatsnew/2.6.rst:3001 msgid "" "The new buffer interface, previously described in `the PEP 3118 section " "<#pep-3118-revised-buffer-protocol>`__, adds :c:func:`PyObject_GetBuffer` " @@ -13913,7 +13833,7 @@ msgid "" msgstr "" # d8b19ee8969e49c28aa981090605a928 -#: ../src/Doc/whatsnew/2.6.rst:3006 +#: whatsnew/2.6.rst:3006 msgid "" "Python's use of the C stdio library is now thread-safe, or at least as " "thread-safe as the underlying library is. A long-standing potential bug " @@ -13929,7 +13849,7 @@ msgid "" msgstr "" # a99be85f0aca44eab799a3dfaba899c4 -#: ../src/Doc/whatsnew/2.6.rst:3019 +#: whatsnew/2.6.rst:3019 msgid "" "Importing modules simultaneously in two different threads no longer " "deadlocks; it will now raise an :exc:`ImportError`. A new API function, :c:" @@ -13940,7 +13860,7 @@ msgid "" msgstr "" # 2f30a14d040e4bc5a7a94d1e88654f47 -#: ../src/Doc/whatsnew/2.6.rst:3027 +#: whatsnew/2.6.rst:3027 msgid "" "Several functions return information about the platform's floating-point " "support. :c:func:`PyFloat_GetMax` returns the maximum representable " @@ -13953,7 +13873,7 @@ msgid "" msgstr "" # b99e3ac8567343b0b2b79dba8ada1e25 -#: ../src/Doc/whatsnew/2.6.rst:3038 +#: whatsnew/2.6.rst:3038 msgid "" "C functions and methods that use :c:func:`PyComplex_AsCComplex` will now " "accept arguments that have a :meth:`__complex__` method. In particular, the " @@ -13962,7 +13882,7 @@ msgid "" "Dickinson; :issue:`1675423`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3045 +#: whatsnew/2.6.rst:3045 msgid "" "Python's C API now includes two functions for case-insensitive string " "comparisons, ``PyOS_stricmp(char*, char*)`` and ``PyOS_strnicmp(char*, " @@ -13970,7 +13890,7 @@ msgid "" msgstr "" # c1b855820de349878d93de57f89adc23 -#: ../src/Doc/whatsnew/2.6.rst:3050 +#: whatsnew/2.6.rst:3050 msgid "" "Many C extensions define their own little macro for adding integers and " "strings to the module's dictionary in the ``init*`` function. Python 2.6 " @@ -13980,7 +13900,7 @@ msgid "" msgstr "" # 75baa71c7eb84b46a2d50d2d59727600 -#: ../src/Doc/whatsnew/2.6.rst:3057 +#: whatsnew/2.6.rst:3057 msgid "" "Some macros were renamed in both 3.0 and 2.6 to make it clearer that they " "are macros, not functions. :c:macro:`Py_Size()` became :c:macro:" @@ -13989,14 +13909,14 @@ msgid "" "available in Python 2.6 for backward compatibility. (:issue:`1629`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3066 +#: whatsnew/2.6.rst:3066 msgid "" "Distutils now places C extensions it builds in a different directory when " "running on a debug version of Python. (Contributed by Collin Winter; :issue:" "`1530959`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3070 +#: whatsnew/2.6.rst:3070 msgid "" "Several basic data types, such as integers and strings, maintain internal " "free lists of objects that can be re-used. The data structures for these " @@ -14005,7 +13925,7 @@ msgid "" "``Py<typename>_MAXFREELIST`` is always defined." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3077 +#: whatsnew/2.6.rst:3077 msgid "" "A new Makefile target, \"make patchcheck\", prepares the Python source tree " "for making a patch: it fixes trailing whitespace in all modified ``.py`` " @@ -14014,7 +13934,7 @@ msgid "" "(Contributed by Brett Cannon.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3084 +#: whatsnew/2.6.rst:3084 msgid "" "Another new target, \"make profile-opt\", compiles a Python binary using " "GCC's profile-guided optimization. It compiles Python with profiling " @@ -14023,17 +13943,17 @@ msgid "" "Smith.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3093 ../src/Doc/whatsnew/2.7.rst:2299 +#: whatsnew/2.6.rst:3093 whatsnew/2.7.rst:2299 msgid "Port-Specific Changes: Windows" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3095 +#: whatsnew/2.6.rst:3095 msgid "" "The support for Windows 95, 98, ME and NT4 has been dropped. Python 2.6 " "requires at least Windows 2000 SP4." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3098 +#: whatsnew/2.6.rst:3098 msgid "" "The new default compiler on Windows is Visual Studio 2008 (version 9.0). The " "build directories for Visual Studio 2003 (version 7.1) and 2005 (version " @@ -14044,7 +13964,7 @@ msgid "" "Martin von Loewis.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3106 +#: whatsnew/2.6.rst:3106 msgid "" "The :mod:`msvcrt` module now supports both the normal and wide char variants " "of the console I/O API. The :func:`getwch` function reads a keypress and " @@ -14053,7 +13973,7 @@ msgid "" "(Contributed by Christian Heimes.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3113 +#: whatsnew/2.6.rst:3113 msgid "" ":func:`os.path.expandvars` will now expand environment variables in the form " "\"%var%\", and \"~user\" will be expanded into the user's home directory " @@ -14061,13 +13981,13 @@ msgid "" msgstr "" # 04babcb9bacc410f815f8ebac76c0838 -#: ../src/Doc/whatsnew/2.6.rst:3117 +#: whatsnew/2.6.rst:3117 msgid "" "The :mod:`socket` module's socket objects now have an :meth:`ioctl` method " "that provides a limited interface to the :c:func:`WSAIoctl` system interface." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3121 +#: whatsnew/2.6.rst:3121 msgid "" "The :mod:`_winreg` module now has a function, :func:" "`ExpandEnvironmentStrings`, that expands environment variable references " @@ -14076,7 +13996,7 @@ msgid "" "`with` statements. (Contributed by Christian Heimes.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3128 +#: whatsnew/2.6.rst:3128 msgid "" ":mod:`_winreg` also has better support for x64 systems, exposing the :func:" "`DisableReflectionKey`, :func:`EnableReflectionKey`, and :func:" @@ -14084,32 +14004,32 @@ msgid "" "for 32-bit processes running on 64-bit systems. (:issue:`1753245`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3134 +#: whatsnew/2.6.rst:3134 msgid "" "The :mod:`msilib` module's :class:`Record` object gained :meth:`GetInteger` " "and :meth:`GetString` methods that return field values as an integer or a " "string. (Contributed by Floris Bruynooghe; :issue:`2125`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3142 ../src/Doc/whatsnew/2.7.rst:2337 +#: whatsnew/2.6.rst:3142 whatsnew/2.7.rst:2337 msgid "Port-Specific Changes: Mac OS X" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3144 +#: whatsnew/2.6.rst:3144 msgid "" "When compiling a framework build of Python, you can now specify the " "framework name to be used by providing the :option:`--with-framework-name=` " "option to the :program:`configure` script." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3149 +#: whatsnew/2.6.rst:3149 msgid "" "The :mod:`macfs` module has been removed. This in turn required the :func:" "`macostools.touched` function to be removed because it depended on the :mod:" "`macfs` module. (:issue:`1490190`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3153 +#: whatsnew/2.6.rst:3153 msgid "" "Many other Mac OS modules have been deprecated and will removed in Python " "3.0: :mod:`_builtinSuites`, :mod:`aepack`, :mod:`aetools`, :mod:`aetypes`, :" @@ -14124,11 +14044,11 @@ msgid "" "`terminalcommand`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3196 +#: whatsnew/2.6.rst:3196 msgid "Port-Specific Changes: IRIX" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3198 +#: whatsnew/2.6.rst:3198 msgid "" "A number of old IRIX-specific modules were deprecated and will be removed in " "Python 3.0: :mod:`al` and :mod:`AL`, :mod:`cd`, :mod:`cddb`, :mod:" @@ -14139,31 +14059,31 @@ msgid "" "`videoreader`, and :mod:`WAIT`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3228 +#: whatsnew/2.6.rst:3228 #, fuzzy msgid "Porting to Python 2.6" msgstr "Portage vers Python 3.2" -#: ../src/Doc/whatsnew/2.6.rst:3230 ../src/Doc/whatsnew/2.7.rst:2399 +#: whatsnew/2.6.rst:3230 whatsnew/2.7.rst:2399 msgid "" "This section lists previously described changes and other bugfixes that may " "require changes to your code:" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3233 +#: whatsnew/2.6.rst:3233 msgid "" "Classes that aren't supposed to be hashable should set ``__hash__ = None`` " "in their definitions to indicate the fact." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3240 +#: whatsnew/2.6.rst:3240 msgid "" "The :meth:`__init__` method of :class:`collections.deque` now clears any " "existing contents of the deque before adding elements from the iterable. " "This change makes the behavior match ``list.__init__()``." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3245 +#: whatsnew/2.6.rst:3245 msgid "" ":meth:`object.__init__` previously accepted arbitrary arguments and keyword " "arguments, ignoring them. In Python 2.6, this is no longer allowed and will " @@ -14172,7 +14092,7 @@ msgid "" "through using :func:`super`). See :issue:`1683368` for discussion." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3252 +#: whatsnew/2.6.rst:3252 msgid "" "The :class:`Decimal` constructor now accepts leading and trailing whitespace " "when passed a string. Previously it would raise an :exc:`InvalidOperation` " @@ -14181,7 +14101,7 @@ msgid "" "`ConversionSyntax` exception." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3259 +#: whatsnew/2.6.rst:3259 msgid "" "Due to an implementation accident, if you passed a file path to the built-" "in :func:`__import__` function, it would actually import the specified " @@ -14190,7 +14110,7 @@ msgid "" msgstr "" # a19d25b087a14368ad1d8b46083bf753 -#: ../src/Doc/whatsnew/2.6.rst:3265 +#: whatsnew/2.6.rst:3265 msgid "" "C API: the :c:func:`PyImport_Import` and :c:func:`PyImport_ImportModule` " "functions now default to absolute imports, not relative imports. This will " @@ -14198,13 +14118,13 @@ msgid "" msgstr "" # c2afc431ad67493499130c6d698739ac -#: ../src/Doc/whatsnew/2.6.rst:3269 +#: whatsnew/2.6.rst:3269 msgid "" "C API: extension data types that shouldn't be hashable should define their " "``tp_hash`` slot to :c:func:`PyObject_HashNotImplemented`." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3273 +#: whatsnew/2.6.rst:3273 msgid "" "The :mod:`socket` module exception :exc:`socket.error` now inherits from :" "exc:`IOError`. Previously it wasn't a subclass of :exc:`StandardError` but " @@ -14212,7 +14132,7 @@ msgid "" "`1706815`.)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3278 +#: whatsnew/2.6.rst:3278 msgid "" "The :mod:`xmlrpclib` module no longer automatically converts :class:" "`datetime.date` and :class:`datetime.time` to the :class:`xmlrpclib." @@ -14221,28 +14141,28 @@ msgid "" "and :class:`time` instances. (:issue:`1330538`)" msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3285 +#: whatsnew/2.6.rst:3285 msgid "" "(3.0-warning mode) The :class:`Exception` class now warns when accessed " "using slicing or index access; having :class:`Exception` behave like a tuple " "is being phased out." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3289 +#: whatsnew/2.6.rst:3289 msgid "" "(3.0-warning mode) inequality comparisons between two dictionaries or two " "objects that don't implement comparison methods are reported as warnings. " "``dict1 == dict2`` still works, but ``dict1 < dict2`` is being phased out." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3294 +#: whatsnew/2.6.rst:3294 msgid "" "Comparisons between cells, which are an implementation detail of Python's " "scoping rules, also cause warnings because such comparisons are forbidden " "entirely in 3.0." msgstr "" -#: ../src/Doc/whatsnew/2.6.rst:3306 +#: whatsnew/2.6.rst:3306 msgid "" "The author would like to thank the following people for offering " "suggestions, corrections and assistance with various drafts of this article: " @@ -14250,20 +14170,20 @@ msgid "" "Johnson, Chris Lambacher, Martin Michlmayr, Antoine Pitrou, Brian Warner." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:3 +#: whatsnew/2.7.rst:3 #, fuzzy msgid "What's New in Python 2.7" msgstr "Nouveautés de Python 2.0" # 486930ef6f9c4f0abe7d40c5d844a25f -#: ../src/Doc/whatsnew/2.7.rst:52 +#: whatsnew/2.7.rst:52 msgid "" "This article explains the new features in Python 2.7. Python 2.7 was " "released on July 3, 2010." msgstr "" # d9e34d363f254dd9a82909f60792df54 -#: ../src/Doc/whatsnew/2.7.rst:55 +#: whatsnew/2.7.rst:55 msgid "" "Numeric handling has been improved in many ways, for both floating-point " "numbers and for the :class:`~decimal.Decimal` class. There are some useful " @@ -14274,7 +14194,7 @@ msgid "" "other improvements." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:63 +#: whatsnew/2.7.rst:63 msgid "" "Python 2.7 is planned to be the last of the 2.x releases, so we worked on " "making it a good release for the long term. To help with porting to Python " @@ -14282,7 +14202,7 @@ msgid "" msgstr "" # 76f16953e73340d5bd2a09a6e63f461d -#: ../src/Doc/whatsnew/2.7.rst:68 +#: whatsnew/2.7.rst:68 msgid "" "This article doesn't attempt to provide a complete specification of the new " "features, but instead provides a convenient overview. For full details, you " @@ -14293,12 +14213,12 @@ msgid "" "in Python\" links to the bug/patch item for each change." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:80 +#: whatsnew/2.7.rst:80 msgid "The Future for Python 2.x" msgstr "" # 0fd737fb6af04b5b875510b6e6ed23fd -#: ../src/Doc/whatsnew/2.7.rst:82 +#: whatsnew/2.7.rst:82 msgid "" "Python 2.7 is the last major release in the 2.x series, as the Python " "maintainers have shifted the focus of their new feature development efforts " @@ -14309,7 +14229,7 @@ msgid "" msgstr "" # 3135281466114e9db0d9f5eb548cab55 -#: ../src/Doc/whatsnew/2.7.rst:89 +#: whatsnew/2.7.rst:89 msgid "" "However, while there is a large common subset between Python 2.7 and Python " "3, and many of the changes involved in migrating to that common subset, or " @@ -14320,7 +14240,7 @@ msgid "" msgstr "" # 0d7f00f5ff544a1192b3dfb7264090fe -#: ../src/Doc/whatsnew/2.7.rst:96 +#: whatsnew/2.7.rst:96 msgid "" "This means that Python 2.7 will remain in place for a long time, providing a " "stable and supported base platform for production systems that have not yet " @@ -14329,12 +14249,12 @@ msgid "" msgstr "" # 30ec41b0b5774c04b29ad2b79a049557 -#: ../src/Doc/whatsnew/2.7.rst:101 +#: whatsnew/2.7.rst:101 msgid "Some key consequences of the long-term significance of 2.7 are:" msgstr "" # f8a215805a5743538002e7c9fae1fca7 -#: ../src/Doc/whatsnew/2.7.rst:103 +#: whatsnew/2.7.rst:103 msgid "" "As noted above, the 2.7 release has a much longer period of maintenance when " "compared to earlier 2.x versions. Python 2.7 is currently expected to remain " @@ -14344,7 +14264,7 @@ msgid "" msgstr "" # 970524919a5c44f2b6a727094e4ec76f -#: ../src/Doc/whatsnew/2.7.rst:109 +#: whatsnew/2.7.rst:109 msgid "" "As the Python 2.7 standard library ages, making effective use of the Python " "Package Index (either directly or via a redistributor) becomes more " @@ -14358,7 +14278,7 @@ msgid "" msgstr "" # 3bfc5da850444aa28a0f867dd445fb39 -#: ../src/Doc/whatsnew/2.7.rst:119 +#: whatsnew/2.7.rst:119 msgid "" "While the preferred approach to enhancing Python 2 is now the publication of " "new packages on the Python Package Index, this approach doesn't necessarily " @@ -14372,7 +14292,7 @@ msgid "" msgstr "" # 1aff3e115fed4f248ae9b18c1743c31e -#: ../src/Doc/whatsnew/2.7.rst:129 +#: whatsnew/2.7.rst:129 msgid "" "For projects wishing to migrate from Python 2 to Python 3, or for library " "and framework developers wishing to support users on both Python 2 and " @@ -14382,12 +14302,12 @@ msgid "" msgstr "" # a5099d4a9a204342823ae2d1d6837fa4 -#: ../src/Doc/whatsnew/2.7.rst:137 +#: whatsnew/2.7.rst:137 msgid "Changes to the Handling of Deprecation Warnings" msgstr "" # dc290132d64c49a6a391688e014a66ba -#: ../src/Doc/whatsnew/2.7.rst:139 +#: whatsnew/2.7.rst:139 msgid "" "For Python 2.7, a policy decision was made to silence warnings only of " "interest to developers by default. :exc:`DeprecationWarning` and its " @@ -14397,14 +14317,14 @@ msgid "" "out in :issue:`7319`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:146 +#: whatsnew/2.7.rst:146 msgid "" "In previous releases, :exc:`DeprecationWarning` messages were enabled by " "default, providing Python developers with a clear indication of where their " "code may break in a future major version of Python." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:151 +#: whatsnew/2.7.rst:151 msgid "" "However, there are increasingly many users of Python-based applications who " "are not directly involved in the development of those applications. :exc:" @@ -14414,7 +14334,7 @@ msgid "" msgstr "" # 44a74749b1cd40c582fe08fea5dcc88c -#: ../src/Doc/whatsnew/2.7.rst:158 +#: whatsnew/2.7.rst:158 msgid "" "You can re-enable display of :exc:`DeprecationWarning` messages by running " "Python with the :option:`-Wdefault <-W>` (short form: :option:`-Wd <-W>`) " @@ -14424,64 +14344,64 @@ msgid "" msgstr "" # c0a4c74257dc49fda816116389db66b7 -#: ../src/Doc/whatsnew/2.7.rst:165 +#: whatsnew/2.7.rst:165 msgid "" "The ``unittest`` module also automatically reenables deprecation warnings " "when running tests." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:170 +#: whatsnew/2.7.rst:170 msgid "Python 3.1 Features" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:172 +#: whatsnew/2.7.rst:172 msgid "" "Much as Python 2.6 incorporated features from Python 3.0, version 2.7 " "incorporates some of the new features in Python 3.1. The 2.x series " "continues to provide tools for migrating to the 3.x series." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:177 +#: whatsnew/2.7.rst:177 msgid "A partial list of 3.1 features that were backported to 2.7:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:179 +#: whatsnew/2.7.rst:179 msgid "The syntax for set literals (``{1,2,3}`` is a mutable set)." msgstr "" # 06803aa803544424bc4e85556504fa87 -#: ../src/Doc/whatsnew/2.7.rst:180 +#: whatsnew/2.7.rst:180 msgid "Dictionary and set comprehensions (``{i: i*2 for i in range(3)}``)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:181 +#: whatsnew/2.7.rst:181 msgid "Multiple context managers in a single :keyword:`with` statement." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:182 +#: whatsnew/2.7.rst:182 msgid "A new version of the :mod:`io` library, rewritten in C for performance." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:183 +#: whatsnew/2.7.rst:183 msgid "The ordered-dictionary type described in :ref:`pep-0372`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:184 +#: whatsnew/2.7.rst:184 msgid "The new ``\",\"`` format specifier described in :ref:`pep-0378`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:185 +#: whatsnew/2.7.rst:185 msgid "The :class:`memoryview` object." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:186 +#: whatsnew/2.7.rst:186 msgid "" "A small subset of the :mod:`importlib` module, `described below <#importlib-" "section>`__." msgstr "" # 09dc1b9e535a4cda8a47872e19bf60f7 -#: ../src/Doc/whatsnew/2.7.rst:188 +#: whatsnew/2.7.rst:188 msgid "" "The :func:`repr` of a float ``x`` is shorter in many cases: it's now based " "on the shortest decimal string that's guaranteed to round back to ``x``. As " @@ -14490,46 +14410,46 @@ msgid "" msgstr "" # 754091649c754e5aba6575c8121de58d -#: ../src/Doc/whatsnew/2.7.rst:192 +#: whatsnew/2.7.rst:192 msgid "" "Float-to-string and string-to-float conversions are correctly rounded. The :" "func:`round` function is also now correctly rounded." msgstr "" # 1b44809531e446d6a5ca648852287ee7 -#: ../src/Doc/whatsnew/2.7.rst:194 +#: whatsnew/2.7.rst:194 msgid "" "The :c:type:`PyCapsule` type, used to provide a C API for extension modules." msgstr "" # ea84532b53414f61b43e56e5919c3467 -#: ../src/Doc/whatsnew/2.7.rst:195 +#: whatsnew/2.7.rst:195 msgid "The :c:func:`PyLong_AsLongAndOverflow` C API function." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:197 +#: whatsnew/2.7.rst:197 msgid "Other new Python3-mode warnings include:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:199 +#: whatsnew/2.7.rst:199 msgid "" ":func:`operator.isCallable` and :func:`operator.sequenceIncludes`, which are " "not supported in 3.x, now trigger warnings." msgstr "" # 4670c73ef4104a689b4d587ba20facc1 -#: ../src/Doc/whatsnew/2.7.rst:201 +#: whatsnew/2.7.rst:201 msgid "" "The :option:`-3` switch now automatically enables the :option:`-Qwarn <-Q>` " "switch that causes warnings about using classic division with integers and " "long integers." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:214 +#: whatsnew/2.7.rst:214 msgid "PEP 372: Adding an Ordered Dictionary to collections" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:216 +#: whatsnew/2.7.rst:216 msgid "" "Regular Python dictionaries iterate over key/value pairs in arbitrary order. " "Over the years, a number of authors have written alternative implementations " @@ -14538,43 +14458,43 @@ msgid "" "`~collections.OrderedDict` class in the :mod:`collections` module." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:222 +#: whatsnew/2.7.rst:222 msgid "" "The :class:`~collections.OrderedDict` API provides the same interface as " "regular dictionaries but iterates over keys and values in a guaranteed order " "depending on when a key was first inserted::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:233 +#: whatsnew/2.7.rst:233 msgid "" "If a new entry overwrites an existing entry, the original insertion position " "is left unchanged::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:240 +#: whatsnew/2.7.rst:240 msgid "Deleting an entry and reinserting it will move it to the end::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:247 +#: whatsnew/2.7.rst:247 msgid "" "The :meth:`~collections.OrderedDict.popitem` method has an optional *last* " "argument that defaults to True. If *last* is True, the most recently added " "key is returned and removed; if it's False, the oldest key is selected::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:262 +#: whatsnew/2.7.rst:262 msgid "" "Comparing two ordered dictionaries checks both the keys and values, and " "requires that the insertion order was the same::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:278 +#: whatsnew/2.7.rst:278 msgid "" "Comparing an :class:`~collections.OrderedDict` with a regular dictionary " "ignores the insertion order and just compares the keys and values." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:281 +#: whatsnew/2.7.rst:281 msgid "" "How does the :class:`~collections.OrderedDict` work? It maintains a doubly-" "linked list of keys, appending new keys to the list as they're inserted. A " @@ -14582,28 +14502,28 @@ msgid "" "doesn't have to traverse the entire linked list and therefore remains O(1)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:287 +#: whatsnew/2.7.rst:287 msgid "" "The standard library now supports use of ordered dictionaries in several " "modules." msgstr "" # 29176d01d12b4ea7b1e60abf7336c543 -#: ../src/Doc/whatsnew/2.7.rst:290 +#: whatsnew/2.7.rst:290 msgid "" "The :mod:`ConfigParser` module uses them by default, meaning that " "configuration files can now be read, modified, and then written back in " "their original order." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:294 +#: whatsnew/2.7.rst:294 msgid "" "The :meth:`~collections.somenamedtuple._asdict()` method for :func:" "`collections.namedtuple` now returns an ordered dictionary with the values " "appearing in the same order as the underlying tuple indices." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:298 +#: whatsnew/2.7.rst:298 msgid "" "The :mod:`json` module's :class:`~json.JSONDecoder` class constructor was " "extended with an *object_pairs_hook* parameter to allow :class:`OrderedDict` " @@ -14611,29 +14531,28 @@ msgid "" "tools like `PyYAML <http://pyyaml.org/>`_." msgstr "" -# 26736a02e228461eb4bfa7d548d4ef60 -#: ../src/Doc/whatsnew/2.7.rst:306 -msgid ":pep:`372` - Adding an ordered dictionary to collections" +#: whatsnew/2.7.rst:307 +msgid "PEP 372 - Adding an ordered dictionary to collections" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:307 +#: whatsnew/2.7.rst:307 msgid "" "PEP written by Armin Ronacher and Raymond Hettinger; implemented by Raymond " "Hettinger." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:313 +#: whatsnew/2.7.rst:313 msgid "PEP 378: Format Specifier for Thousands Separator" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:315 +#: whatsnew/2.7.rst:315 msgid "" "To make program output more readable, it can be useful to add separators to " "large numbers, rendering them as 18,446,744,073,709,551,616 instead of " "18446744073709551616." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:319 +#: whatsnew/2.7.rst:319 msgid "" "The fully general solution for doing this is the :mod:`locale` module, which " "can use different separators (\",\" in North America, \".\" in Europe) and " @@ -14642,18 +14561,18 @@ msgid "" "producing output for different locales." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:325 +#: whatsnew/2.7.rst:325 msgid "" "Therefore, a simple comma-grouping mechanism has been added to the mini-" "language used by the :meth:`str.format` method. When formatting a floating-" "point number, simply include a comma between the width and the precision::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:333 +#: whatsnew/2.7.rst:333 msgid "When formatting an integer, include the comma after the width:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:338 +#: whatsnew/2.7.rst:338 msgid "" "This mechanism is not adaptable at all; commas are always used as the " "separator and the grouping is always into three-digit groups. The comma-" @@ -14661,27 +14580,26 @@ msgid "" "easier to use." msgstr "" -# c54475c586c34cbd9520b29e5b5784df -#: ../src/Doc/whatsnew/2.7.rst:344 -msgid ":pep:`378` - Format Specifier for Thousands Separator" +#: whatsnew/2.7.rst:345 +msgid "PEP 378 - Format Specifier for Thousands Separator" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:346 +#: whatsnew/2.7.rst:346 msgid "PEP written by Raymond Hettinger; implemented by Eric Smith." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:349 +#: whatsnew/2.7.rst:349 msgid "PEP 389: The argparse Module for Parsing Command Lines" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:351 +#: whatsnew/2.7.rst:351 msgid "" "The :mod:`argparse` module for parsing command-line arguments was added as a " "more powerful replacement for the :mod:`optparse` module." msgstr "" # 445dd6ecd4144a319a53acc662e1e43f -#: ../src/Doc/whatsnew/2.7.rst:355 +#: whatsnew/2.7.rst:355 msgid "" "This means Python now supports three different modules for parsing command-" "line arguments: :mod:`getopt`, :mod:`optparse`, and :mod:`argparse`. The :" @@ -14694,30 +14612,30 @@ msgid "" "rejected as too messy and difficult.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:366 +#: whatsnew/2.7.rst:366 msgid "" "In short, if you're writing a new script and don't need to worry about " "compatibility with earlier versions of Python, use :mod:`argparse` instead " "of :mod:`optparse`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:370 +#: whatsnew/2.7.rst:370 msgid "Here's an example::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:393 +#: whatsnew/2.7.rst:393 msgid "" "Unless you override it, :option:`-h` and :option:`--help` switches are " "automatically added, and produce neatly formatted output::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:410 +#: whatsnew/2.7.rst:410 msgid "" "As with :mod:`optparse`, the command-line switches and arguments are " "returned as an object with attributes named by the *dest* parameters::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:425 +#: whatsnew/2.7.rst:425 msgid "" ":mod:`argparse` has much fancier validation than :mod:`optparse`; you can " "specify an exact number of arguments as an integer, 0 or more arguments by " @@ -14729,41 +14647,38 @@ msgid "" "``'-'`` means standard input or output." msgstr "" -# 5ed6385118c747039b0c4ab71a6f166b -#: ../src/Doc/whatsnew/2.7.rst:437 -msgid ":mod:`argparse` documentation" +#: whatsnew/2.7.rst:438 +msgid "argparse documentation" msgstr "" # 65dcc4cafab24c93bf812c68dd25565a -#: ../src/Doc/whatsnew/2.7.rst:438 +#: whatsnew/2.7.rst:438 msgid "The documentation page of the argparse module." msgstr "" -# afbf8b937fdd48bca64f66763049e0b7 -#: ../src/Doc/whatsnew/2.7.rst:441 -msgid ":ref:`argparse-from-optparse`" +#: whatsnew/2.7.rst:442 +msgid "argparse-from-optparse" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:441 +#: whatsnew/2.7.rst:441 msgid "" "Part of the Python documentation, describing how to convert code that uses :" "mod:`optparse`." msgstr "" -# 3aaf011e14184676a6c054c07112f2b2 -#: ../src/Doc/whatsnew/2.7.rst:443 -msgid ":pep:`389` - argparse - New Command Line Parsing Module" +#: whatsnew/2.7.rst:444 +msgid "PEP 389 - argparse - New Command Line Parsing Module" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:445 +#: whatsnew/2.7.rst:445 msgid "PEP written and implemented by Steven Bethard." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:448 +#: whatsnew/2.7.rst:448 msgid "PEP 391: Dictionary-Based Configuration For Logging" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:450 +#: whatsnew/2.7.rst:450 msgid "" "The :mod:`logging` module is very flexible; applications can define a tree " "of logging subsystems, and each logger in this tree can filter out certain " @@ -14772,7 +14687,7 @@ msgid "" msgstr "" # 63080229107c497fb3ee4944dc691876 -#: ../src/Doc/whatsnew/2.7.rst:455 +#: whatsnew/2.7.rst:455 msgid "" "All this flexibility can require a lot of configuration. You can write " "Python statements to create objects and set their properties, but a complex " @@ -14783,7 +14698,7 @@ msgid "" msgstr "" # 608a8b73f2b948f19ad458c910567d3b -#: ../src/Doc/whatsnew/2.7.rst:462 +#: whatsnew/2.7.rst:462 msgid "" "Python 2.7 adds a :func:`~logging.dictConfig` function that uses a " "dictionary to configure logging. There are many ways to produce a " @@ -14793,7 +14708,7 @@ msgid "" msgstr "" # 17302177cedd47a898d2621fbc53d11b -#: ../src/Doc/whatsnew/2.7.rst:468 +#: whatsnew/2.7.rst:468 msgid "" "The following example configures two loggers, the root logger and a logger " "named \"network\". Messages sent to the root logger will be sent to the " @@ -14802,13 +14717,13 @@ msgid "" "log reaches 1MB." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:518 +#: whatsnew/2.7.rst:518 msgid "" "Three smaller enhancements to the :mod:`logging` module, all implemented by " "Vinay Sajip, are:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:523 +#: whatsnew/2.7.rst:523 msgid "" "The :class:`~logging.handlers.SysLogHandler` class now supports syslogging " "over TCP. The constructor has a *socktype* parameter giving the type of " @@ -14817,7 +14732,7 @@ msgid "" msgstr "" # 50b55474541b491fbadd97ccda8565ca -#: ../src/Doc/whatsnew/2.7.rst:529 +#: whatsnew/2.7.rst:529 msgid "" ":class:`~logging.Logger` instances gained a :meth:`~logging.Logger.getChild` " "method that retrieves a descendant logger using a relative path. For " @@ -14827,28 +14742,27 @@ msgid "" msgstr "" # 615bdb031e4c454baae7d69d68ef18e3 -#: ../src/Doc/whatsnew/2.7.rst:535 +#: whatsnew/2.7.rst:535 msgid "" "The :class:`~logging.LoggerAdapter` class gained a :meth:`~logging." "LoggerAdapter.isEnabledFor` method that takes a *level* and returns whether " "the underlying logger would process a message of that level of importance." msgstr "" -# 1c3048ec8b96441aaac5b88c14eab09a -#: ../src/Doc/whatsnew/2.7.rst:543 -msgid ":pep:`391` - Dictionary-Based Configuration For Logging" +#: whatsnew/2.7.rst:544 +msgid "PEP 391 - Dictionary-Based Configuration For Logging" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:545 +#: whatsnew/2.7.rst:545 msgid "PEP written and implemented by Vinay Sajip." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:548 +#: whatsnew/2.7.rst:548 msgid "PEP 3106: Dictionary Views" msgstr "" # c3cbfe42b58748f4b2ce92711f920579 -#: ../src/Doc/whatsnew/2.7.rst:550 +#: whatsnew/2.7.rst:550 msgid "" "The dictionary methods :meth:`~dict.keys`, :meth:`~dict.values`, and :meth:" "`~dict.items` are different in Python 3.x. They return an object called a :" @@ -14856,7 +14770,7 @@ msgid "" msgstr "" # 6de61752ed6f4357a3f58258c38f22c5 -#: ../src/Doc/whatsnew/2.7.rst:554 +#: whatsnew/2.7.rst:554 msgid "" "It's not possible to change the return values of :meth:`~dict.keys`, :meth:" "`~dict.values`, and :meth:`~dict.items` in Python 2.7 because too much code " @@ -14864,77 +14778,75 @@ msgid "" "`~dict.viewkeys`, :meth:`~dict.viewvalues`, and :meth:`~dict.viewitems`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:568 +#: whatsnew/2.7.rst:568 msgid "" "Views can be iterated over, but the key and item views also behave like " "sets. The ``&`` operator performs intersection, and ``|`` performs a union::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:579 +#: whatsnew/2.7.rst:579 msgid "" "The view keeps track of the dictionary and its contents change as the " "dictionary is modified::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:589 +#: whatsnew/2.7.rst:589 msgid "" "However, note that you can't add or remove keys while you're iterating over " "the view::" msgstr "" # acf0a68fe1134543952389c0b83fd1b2 -#: ../src/Doc/whatsnew/2.7.rst:599 +#: whatsnew/2.7.rst:599 msgid "" "You can use the view methods in Python 2.x code, and the 2to3 converter will " "change them to the standard :meth:`~dict.keys`, :meth:`~dict.values`, and :" "meth:`~dict.items` methods." msgstr "" -# 3a5c880bbce14113aefe7186cceb2a3b -#: ../src/Doc/whatsnew/2.7.rst:605 -msgid ":pep:`3106` - Revamping dict.keys(), .values() and .items()" +#: whatsnew/2.7.rst:606 +msgid "PEP 3106 - Revamping dict.keys(), .values() and .items()" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:606 +#: whatsnew/2.7.rst:606 msgid "" "PEP written by Guido van Rossum. Backported to 2.7 by Alexandre Vassalotti; :" "issue:`1967`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:611 +#: whatsnew/2.7.rst:611 msgid "PEP 3137: The memoryview Object" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:613 +#: whatsnew/2.7.rst:613 msgid "" "The :class:`memoryview` object provides a view of another object's memory " "content that matches the :class:`bytes` type's interface." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:628 +#: whatsnew/2.7.rst:628 msgid "" "The content of the view can be converted to a string of bytes or a list of " "integers:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:637 +#: whatsnew/2.7.rst:637 msgid "" ":class:`memoryview` objects allow modifying the underlying object if it's a " "mutable object." msgstr "" -# 133348b32b1d4f21a3adfcd4e7e26849 -#: ../src/Doc/whatsnew/2.7.rst:656 -msgid ":pep:`3137` - Immutable Bytes and Mutable Buffer" +#: whatsnew/2.7.rst:657 +msgid "PEP 3137 - Immutable Bytes and Mutable Buffer" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:656 +#: whatsnew/2.7.rst:656 msgid "" "PEP written by Guido van Rossum. Implemented by Travis Oliphant, Antoine " "Pitrou and others. Backported to 2.7 by Antoine Pitrou; :issue:`2396`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:667 +#: whatsnew/2.7.rst:667 msgid "" "The syntax for set literals has been backported from Python 3.x. Curly " "brackets are used to surround the contents of the resulting mutable set; set " @@ -14943,46 +14855,46 @@ msgid "" "an empty set." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:681 +#: whatsnew/2.7.rst:681 msgid "Backported by Alexandre Vassalotti; :issue:`2335`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:683 +#: whatsnew/2.7.rst:683 msgid "" "Dictionary and set comprehensions are another feature backported from 3.x, " "generalizing list/generator comprehensions to use the literal syntax for " "sets and dictionaries." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:692 +#: whatsnew/2.7.rst:692 msgid "Backported by Alexandre Vassalotti; :issue:`2333`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:694 +#: whatsnew/2.7.rst:694 msgid "" "The :keyword:`with` statement can now use multiple context managers in one " "statement. Context managers are processed from left to right and each one " "is treated as beginning a new :keyword:`with` statement. This means that::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:702 +#: whatsnew/2.7.rst:702 msgid "is equivalent to::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:708 +#: whatsnew/2.7.rst:708 msgid "" "The :func:`contextlib.nested` function provides a very similar function, so " "it's no longer necessary and has been deprecated." msgstr "" # f242a9b2f2a34208805e30eb054164e3 -#: ../src/Doc/whatsnew/2.7.rst:711 +#: whatsnew/2.7.rst:711 msgid "" "(Proposed in https://codereview.appspot.com/53094; implemented by Georg " "Brandl.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:714 +#: whatsnew/2.7.rst:714 msgid "" "Conversions between floating-point numbers and strings are now correctly " "rounded on most platforms. These conversions occur in many different " @@ -14993,7 +14905,7 @@ msgid "" "Python code; and :class:`~decimal.Decimal`-to-float conversion." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:726 +#: whatsnew/2.7.rst:726 msgid "" "Related to this, the :func:`repr` of a floating-point number *x* now returns " "a result based on the shortest decimal string that's guaranteed to round " @@ -15001,7 +14913,7 @@ msgid "" "Previously it gave a string based on rounding x to 17 decimal digits." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:734 +#: whatsnew/2.7.rst:734 msgid "" "The rounding library responsible for this improvement works on Windows and " "on Unix platforms using the gcc, icc, or suncc compilers. There may be a " @@ -15011,13 +14923,13 @@ msgid "" "``short`` if the new code is in use and ``legacy`` if it isn't." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:742 +#: whatsnew/2.7.rst:742 msgid "" "Implemented by Eric Smith and Mark Dickinson, using David Gay's :file:`dtoa." "c` library; :issue:`7117`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:745 +#: whatsnew/2.7.rst:745 msgid "" "Conversions from long integers and regular integers to floating point now " "round differently, returning the floating-point number closest to the " @@ -15027,37 +14939,37 @@ msgid "" "following::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:758 +#: whatsnew/2.7.rst:758 msgid "" "Python 2.7's floating-point result is larger, but much closer to the true " "value::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:767 +#: whatsnew/2.7.rst:767 msgid "(Implemented by Mark Dickinson; :issue:`3166`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:769 +#: whatsnew/2.7.rst:769 msgid "" "Integer division is also more accurate in its rounding behaviours. (Also " "implemented by Mark Dickinson; :issue:`1811`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:772 +#: whatsnew/2.7.rst:772 msgid "" "Implicit coercion for complex numbers has been removed; the interpreter will " "no longer ever attempt to call a :meth:`__coerce__` method on complex " "objects. (Removed by Meador Inge and Mark Dickinson; :issue:`5211`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:776 +#: whatsnew/2.7.rst:776 msgid "" "The :meth:`str.format` method now supports automatic numbering of the " "replacement fields. This makes using :meth:`str.format` more closely " "resemble using ``%s`` formatting::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:785 +#: whatsnew/2.7.rst:785 msgid "" "The auto-numbering takes the fields from left to right, so the first ``{...}" "`` specifier will use the first argument to :meth:`str.format`, the next " @@ -15067,7 +14979,7 @@ msgid "" "as in the second example above. (Contributed by Eric Smith; :issue:`5237`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:792 +#: whatsnew/2.7.rst:792 msgid "" "Complex numbers now correctly support usage with :func:`format`, and default " "to being right-aligned. Specifying a precision or comma-separation applies " @@ -15076,14 +14988,14 @@ msgid "" "output. (Contributed by Eric Smith; :issue:`1588` and :issue:`7988`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:799 +#: whatsnew/2.7.rst:799 msgid "" "The 'F' format code now always formats its output using uppercase " "characters, so it will now produce 'INF' and 'NAN'. (Contributed by Eric " "Smith; :issue:`3382`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:803 +#: whatsnew/2.7.rst:803 msgid "" "A low-level change: the :meth:`object.__format__` method now triggers a :exc:" "`PendingDeprecationWarning` if it's passed a format string, because the :" @@ -15095,18 +15007,18 @@ msgid "" "applied in some object-specific way. (Fixed by Eric Smith; :issue:`7994`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:813 +#: whatsnew/2.7.rst:813 msgid "" "The :func:`int` and :func:`long` types gained a ``bit_length`` method that " "returns the number of bits necessary to represent its argument in binary::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:828 +#: whatsnew/2.7.rst:828 msgid "(Contributed by Fredrik Johansson and Victor Stinner; :issue:`3439`.)" msgstr "" # 336ab7fe57d54f0189837aef68d85d98 -#: ../src/Doc/whatsnew/2.7.rst:830 +#: whatsnew/2.7.rst:830 msgid "" "The :keyword:`import` statement will no longer try an absolute import if a " "relative import (e.g. ``from .os import sep``) fails. This fixes a bug, but " @@ -15114,21 +15026,21 @@ msgid "" "working by accident. (Fixed by Meador Inge; :issue:`7902`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:836 +#: whatsnew/2.7.rst:836 msgid "" "It's now possible for a subclass of the built-in :class:`unicode` type to " "override the :meth:`__unicode__` method. (Implemented by Victor Stinner; :" "issue:`1583863`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:840 +#: whatsnew/2.7.rst:840 msgid "" "The :class:`bytearray` type's :meth:`~bytearray.translate` method now " "accepts ``None`` as its first argument. (Fixed by Georg Brandl; :issue:" "`4759`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:846 +#: whatsnew/2.7.rst:846 msgid "" "When using ``@classmethod`` and ``@staticmethod`` to wrap methods as class " "or static methods, the wrapper object now exposes the wrapped function as " @@ -15136,14 +15048,14 @@ msgid "" "after a suggestion by George Sakkis; :issue:`5982`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:852 ../src/Doc/whatsnew/2.7.rst:2424 +#: whatsnew/2.7.rst:852 whatsnew/2.7.rst:2424 msgid "" "When a restricted set of attributes were set using ``__slots__``, deleting " "an unset attribute would not raise :exc:`AttributeError` as you would " "expect. Fixed by Benjamin Peterson; :issue:`7604`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:856 +#: whatsnew/2.7.rst:856 msgid "" "Two new encodings are now supported: \"cp720\", used primarily for Arabic " "text; and \"cp858\", a variant of CP 850 that adds the euro symbol. (CP720 " @@ -15151,7 +15063,7 @@ msgid "" "`1616979`; CP858 contributed by Tim Hatch in :issue:`8016`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:862 +#: whatsnew/2.7.rst:862 msgid "" "The :class:`file` object will now set the :attr:`filename` attribute on the :" "exc:`IOError` exception when trying to open a directory on POSIX platforms " @@ -15160,7 +15072,7 @@ msgid "" "to catch and report the error (fixed by Stefan Krah; :issue:`5677`)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:869 +#: whatsnew/2.7.rst:869 msgid "" "The Python tokenizer now translates line endings itself, so the :func:" "`compile` built-in function now accepts code using any line-ending " @@ -15168,7 +15080,7 @@ msgid "" "newline." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:874 +#: whatsnew/2.7.rst:874 msgid "" "Extra parentheses in function definitions are illegal in Python 3.x, meaning " "that you get a syntax error from ``def f((x)): pass``. In Python3-warning " @@ -15176,21 +15088,21 @@ msgid "" "Lingard; :issue:`7362`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:879 +#: whatsnew/2.7.rst:879 msgid "" "It's now possible to create weak references to old-style class objects. New-" "style classes were always weak-referenceable. (Fixed by Antoine Pitrou; :" "issue:`8268`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:883 +#: whatsnew/2.7.rst:883 msgid "" "When a module object is garbage-collected, the module's dictionary is now " "only cleared if no one else is holding a reference to the dictionary (:issue:" "`7140`)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:894 +#: whatsnew/2.7.rst:894 msgid "" "A new environment variable, :envvar:`PYTHONWARNINGS`, allows controlling " "warnings. It should be set to a string containing warning settings, " @@ -15198,7 +15110,7 @@ msgid "" "(Contributed by Brian Curtin; :issue:`7301`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:900 +#: whatsnew/2.7.rst:900 msgid "" "For example, the following setting will print warnings every time they " "occur, but turn warnings from the :mod:`Cookie` module into an error. (The " @@ -15206,18 +15118,18 @@ msgid "" "systems and shells.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:915 +#: whatsnew/2.7.rst:915 msgid "Several performance enhancements have been added:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:917 +#: whatsnew/2.7.rst:917 msgid "" "A new opcode was added to perform the initial setup for :keyword:`with` " "statements, looking up the :meth:`__enter__` and :meth:`__exit__` methods. " "(Contributed by Benjamin Peterson.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:921 +#: whatsnew/2.7.rst:921 msgid "" "The garbage collector now performs better for one common usage pattern: when " "many objects are being allocated without deallocating any of them. This " @@ -15230,7 +15142,7 @@ msgid "" "implemented by Antoine Pitrou; :issue:`4074`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:932 +#: whatsnew/2.7.rst:932 msgid "" "The garbage collector tries to avoid tracking simple containers which can't " "be part of a cycle. In Python 2.7, this is now true for tuples and dicts " @@ -15241,7 +15153,7 @@ msgid "" "Pitrou; :issue:`4688`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:941 +#: whatsnew/2.7.rst:941 msgid "" "Long integers are now stored internally either in base 2**15 or in base " "2**30, the base being determined at build time. Previously, they were " @@ -15253,7 +15165,7 @@ msgid "" "default." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:950 +#: whatsnew/2.7.rst:950 msgid "" "Apart from the performance improvements this change should be invisible to " "end users, with one exception: for testing and debugging purposes there's a " @@ -15262,19 +15174,19 @@ msgid "" "of the C type used to store each digit::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:961 +#: whatsnew/2.7.rst:961 #, fuzzy msgid "(Contributed by Mark Dickinson; :issue:`4258`.)" msgstr "(Contribution par Antoine Pitrou; :issue:`3001`.)" -#: ../src/Doc/whatsnew/2.7.rst:963 +#: whatsnew/2.7.rst:963 msgid "" "Another set of changes made long objects a few bytes smaller: 2 bytes " "smaller on 32-bit systems and 6 bytes on 64-bit. (Contributed by Mark " "Dickinson; :issue:`5260`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:967 +#: whatsnew/2.7.rst:967 msgid "" "The division algorithm for long integers has been made faster by tightening " "the inner loop, doing shifts instead of multiplications, and fixing an " @@ -15284,7 +15196,7 @@ msgid "" "faster (initial patch by Gregory Smith; :issue:`1087418`)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:976 +#: whatsnew/2.7.rst:976 msgid "" "The implementation of ``%`` checks for the left-side operand being a Python " "string and special-cases it; this results in a 1-3% performance increase for " @@ -15292,21 +15204,21 @@ msgid "" "libraries. (Implemented by Collin Winter; :issue:`5176`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:982 +#: whatsnew/2.7.rst:982 msgid "" "List comprehensions with an ``if`` condition are compiled into faster " "bytecode. (Patch by Antoine Pitrou, back-ported to 2.7 by Jeffrey Yasskin; :" "issue:`4715`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:986 +#: whatsnew/2.7.rst:986 msgid "" "Converting an integer or long integer to a decimal string was made faster by " "special-casing base 10 instead of using a generalized conversion function " "that supports arbitrary bases. (Patch by Gawain Bolton; :issue:`6713`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:991 +#: whatsnew/2.7.rst:991 msgid "" "The :meth:`split`, :meth:`replace`, :meth:`rindex`, :meth:`rpartition`, and :" "meth:`rsplit` methods of string-like types (strings, Unicode strings, and :" @@ -15315,20 +15227,20 @@ msgid "" "10. (Added by Florent Xicluna; :issue:`7462` and :issue:`7622`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:998 +#: whatsnew/2.7.rst:998 msgid "" "The :mod:`pickle` and :mod:`cPickle` modules now automatically intern the " "strings used for attribute names, reducing memory usage of the objects " "resulting from unpickling. (Contributed by Jake McGuire; :issue:`5084`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1003 +#: whatsnew/2.7.rst:1003 msgid "" "The :mod:`cPickle` module now special-cases dictionaries, nearly halving the " "time required to pickle them. (Contributed by Collin Winter; :issue:`5670`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1018 +#: whatsnew/2.7.rst:1018 msgid "" "The :mod:`bdb` module's base debugging class :class:`~bdb.Bdb` gained a " "feature for skipping modules. The constructor now takes an iterable " @@ -15338,14 +15250,14 @@ msgid "" "`5142`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1026 +#: whatsnew/2.7.rst:1026 msgid "" "The :mod:`binascii` module now supports the buffer API, so it can be used " "with :class:`memoryview` instances and other similar buffer objects. " "(Backported from 3.x by Florent Xicluna; :issue:`7703`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1030 +#: whatsnew/2.7.rst:1030 msgid "" "Updated module: the :mod:`bsddb` module has been updated from 4.7.2devel9 to " "version 4.8.4 of `the pybsddb package <http://www.jcea.es/programacion/" @@ -15355,14 +15267,14 @@ msgid "" "read at http://hg.jcea.es/pybsddb/file/tip/ChangeLog.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1038 +#: whatsnew/2.7.rst:1038 msgid "" "The :mod:`bz2` module's :class:`~bz2.BZ2File` now supports the context " "management protocol, so you can write ``with bz2.BZ2File(...) as f:``. " "(Contributed by Hagen Fürstenau; :issue:`3860`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1042 +#: whatsnew/2.7.rst:1042 msgid "" "New class: the :class:`~collections.Counter` class in the :mod:`collections` " "module is useful for tallying data. :class:`~collections.Counter` instances " @@ -15370,7 +15282,7 @@ msgid "" "raising a :exc:`KeyError`:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1064 +#: whatsnew/2.7.rst:1064 msgid "" "There are three additional :class:`~collections.Counter` methods. :meth:" "`~collections.Counter.most_common` returns the N most common elements and " @@ -15381,18 +15293,18 @@ msgid "" "another :class:`Counter`, the counts are subtracted. ::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1087 +#: whatsnew/2.7.rst:1087 msgid "Contributed by Raymond Hettinger; :issue:`1696199`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1091 +#: whatsnew/2.7.rst:1091 msgid "" "New class: :class:`~collections.OrderedDict` is described in the earlier " "section :ref:`pep-0372`." msgstr "" # 547cb69002064e1d94f637ac6aa69e41 -#: ../src/Doc/whatsnew/2.7.rst:1094 +#: whatsnew/2.7.rst:1094 msgid "" "New method: The :class:`~collections.deque` data type now has a :meth:" "`~collections.deque.count` method that returns the number of contained " @@ -15403,7 +15315,7 @@ msgid "" "Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1102 +#: whatsnew/2.7.rst:1102 msgid "" "The :class:`~collections.namedtuple` class now has an optional *rename* " "parameter. If *rename* is true, field names that are invalid because they've " @@ -15411,30 +15323,30 @@ msgid "" "names that are derived from the field's position within the list of fields:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1113 +#: whatsnew/2.7.rst:1113 msgid "(Added by Raymond Hettinger; :issue:`1818`.)" msgstr "" # a85f3a96e9a647e7b9b42ca0199f154f -#: ../src/Doc/whatsnew/2.7.rst:1115 +#: whatsnew/2.7.rst:1115 msgid "" "Finally, the :class:`~collections.Mapping` abstract base class now returns :" "const:`NotImplemented` if a mapping is compared to another type that isn't " "a :class:`Mapping`. (Fixed by Daniel Stutzbach; :issue:`8729`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1120 +#: whatsnew/2.7.rst:1120 msgid "" "Constructors for the parsing classes in the :mod:`ConfigParser` module now " -"take a *allow_no_value* parameter, defaulting to false; if true, options " +"take an *allow_no_value* parameter, defaulting to false; if true, options " "without values will be allowed. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1142 +#: whatsnew/2.7.rst:1142 msgid "(Contributed by Mats Kindahl; :issue:`7005`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1144 +#: whatsnew/2.7.rst:1144 msgid "" "Deprecated function: :func:`contextlib.nested`, which allows handling more " "than one context manager with a single :keyword:`with` statement, has been " @@ -15442,20 +15354,20 @@ msgid "" "context managers." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1149 +#: whatsnew/2.7.rst:1149 msgid "" "The :mod:`cookielib` module now ignores cookies that have an invalid version " "field, one that doesn't contain an integer value. (Fixed by John J. Lee; :" "issue:`3924`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1153 +#: whatsnew/2.7.rst:1153 msgid "" "The :mod:`copy` module's :func:`~copy.deepcopy` function will now correctly " "copy bound instance methods. (Implemented by Robert Collins; :issue:`1515`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1157 +#: whatsnew/2.7.rst:1157 msgid "" "The :mod:`ctypes` module now always converts ``None`` to a C NULL pointer " "for arguments declared as pointers. (Changed by Thomas Heller; :issue:" @@ -15464,7 +15376,7 @@ msgid "" "platforms. (Updated by Matthias Klose; :issue:`8142`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1164 +#: whatsnew/2.7.rst:1164 msgid "" "New method: the :mod:`datetime` module's :class:`~datetime.timedelta` class " "gained a :meth:`~datetime.timedelta.total_seconds` method that returns the " @@ -15472,7 +15384,7 @@ msgid "" "`5788`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1168 +#: whatsnew/2.7.rst:1168 msgid "" "New method: the :class:`~decimal.Decimal` class gained a :meth:`~decimal." "Decimal.from_float` class method that performs an exact conversion of a " @@ -15486,7 +15398,7 @@ msgid "" msgstr "" # 59c6ac1cf7be477cab84ac2ce58975bb -#: ../src/Doc/whatsnew/2.7.rst:1179 +#: whatsnew/2.7.rst:1179 msgid "" "Comparing instances of :class:`~decimal.Decimal` with floating-point numbers " "now produces sensible results based on the numeric values of the operands. " @@ -15498,7 +15410,7 @@ msgid "" "Dickinson; :issue:`2531`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1188 +#: whatsnew/2.7.rst:1188 msgid "" "The constructor for :class:`~decimal.Decimal` now accepts floating-point " "numbers (added by Raymond Hettinger; :issue:`8257`) and non-European Unicode " @@ -15506,7 +15418,7 @@ msgid "" "issue:`6595`)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1193 +#: whatsnew/2.7.rst:1193 msgid "" "Most of the methods of the :class:`~decimal.Context` class now accept " "integers as well as :class:`~decimal.Decimal` instances; the only exceptions " @@ -15514,7 +15426,7 @@ msgid "" "is_canonical` methods. (Patch by Juan José Conti; :issue:`7633`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1198 +#: whatsnew/2.7.rst:1198 msgid "" "When using :class:`~decimal.Decimal` instances with a string's :meth:`~str." "format` method, the default alignment was previously left-alignment. This " @@ -15522,7 +15434,7 @@ msgid "" "types. (Changed by Mark Dickinson; :issue:`6857`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1203 +#: whatsnew/2.7.rst:1203 msgid "" "Comparisons involving a signaling NaN value (or ``sNAN``) now signal :const:" "`InvalidOperation` instead of silently returning a true or false value " @@ -15530,7 +15442,7 @@ msgid "" "hashable. (Fixed by Mark Dickinson; :issue:`7279`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1209 +#: whatsnew/2.7.rst:1209 msgid "" "The :mod:`difflib` module now produces output that is more compatible with " "modern :command:`diff`/:command:`patch` tools through one small change, " @@ -15538,7 +15450,7 @@ msgid "" "the filename. (Fixed by Anatoly Techtonik; :issue:`7585`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1215 +#: whatsnew/2.7.rst:1215 msgid "" "The Distutils ``sdist`` command now always regenerates the :file:`MANIFEST` " "file, since even if the :file:`MANIFEST.in` or :file:`setup.py` files " @@ -15546,14 +15458,14 @@ msgid "" "should be included. (Fixed by Tarek Ziadé; :issue:`8688`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1221 +#: whatsnew/2.7.rst:1221 msgid "" "The :mod:`doctest` module's :const:`IGNORE_EXCEPTION_DETAIL` flag will now " "ignore the name of the module containing the exception being tested. (Patch " "by Lennart Regebro; :issue:`7490`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1225 +#: whatsnew/2.7.rst:1225 msgid "" "The :mod:`email` module's :class:`~email.message.Message` class will now " "accept a Unicode-valued payload, automatically converting the payload to the " @@ -15561,7 +15473,7 @@ msgid "" "issue:`1368247`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1230 +#: whatsnew/2.7.rst:1230 msgid "" "The :class:`~fractions.Fraction` class now accepts a single float or :class:" "`~decimal.Decimal` instance, or two rational numbers, as arguments to its " @@ -15570,14 +15482,14 @@ msgid "" msgstr "" # b290216926fe41ae9561bf5d57aac712 -#: ../src/Doc/whatsnew/2.7.rst:1236 +#: whatsnew/2.7.rst:1236 msgid "" "Ordering comparisons (``<``, ``<=``, ``>``, ``>=``) between fractions and " "complex numbers now raise a :exc:`TypeError`. This fixes an oversight, " "making the :class:`~fractions.Fraction` match the other numeric types." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1243 +#: whatsnew/2.7.rst:1243 msgid "" "New class: :class:`~ftplib.FTP_TLS` in the :mod:`ftplib` module provides " "secure FTP connections using TLS encapsulation of authentication as well as " @@ -15585,7 +15497,7 @@ msgid "" "issue:`2054`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1249 +#: whatsnew/2.7.rst:1249 msgid "" "The :meth:`~ftplib.FTP.storbinary` method for binary uploads can now restart " "uploads thanks to an added *rest* parameter (patch by Pablo Mouzo; :issue:" @@ -15593,7 +15505,7 @@ msgid "" msgstr "" # d11eef387aae45de9976bce0674df2bb -#: ../src/Doc/whatsnew/2.7.rst:1253 +#: whatsnew/2.7.rst:1253 msgid "" "New class decorator: :func:`~functools.total_ordering` in the :mod:" "`functools` module takes a class that defines an :meth:`__eq__` method and " @@ -15604,7 +15516,7 @@ msgid "" msgstr "" # 4433348cb6aa411b8da223a529f5316c -#: ../src/Doc/whatsnew/2.7.rst:1261 +#: whatsnew/2.7.rst:1261 msgid "" "New function: :func:`~functools.cmp_to_key` will take an old-style " "comparison function that expects two arguments and return a new callable " @@ -15614,14 +15526,14 @@ msgid "" "Hettinger.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1268 +#: whatsnew/2.7.rst:1268 msgid "" "New function: the :mod:`gc` module's :func:`~gc.is_tracked` returns true if " "a given instance is tracked by the garbage collector, false otherwise. " "(Contributed by Antoine Pitrou; :issue:`4688`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1272 +#: whatsnew/2.7.rst:1272 msgid "" "The :mod:`gzip` module's :class:`~gzip.GzipFile` now supports the context " "management protocol, so you can write ``with gzip.GzipFile(...) as f:`` " @@ -15633,14 +15545,14 @@ msgid "" "(Contributed by Jacques Frechet; :issue:`4272`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1282 +#: whatsnew/2.7.rst:1282 msgid "" "Files in gzip format can be padded with trailing zero bytes; the :mod:`gzip` " "module will now consume these trailing bytes. (Fixed by Tadek Pietraszek " "and Brian Curtin; :issue:`2846`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1286 +#: whatsnew/2.7.rst:1286 msgid "" "New attribute: the :mod:`hashlib` module now has an :attr:`~hashlib.hashlib." "algorithms` attribute containing a tuple naming the supported algorithms. In " @@ -15648,14 +15560,14 @@ msgid "" "'sha256', 'sha384', 'sha512')``. (Contributed by Carl Chenet; :issue:`7418`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1292 +#: whatsnew/2.7.rst:1292 msgid "" "The default :class:`~httplib.HTTPResponse` class used by the :mod:`httplib` " "module now supports buffering, resulting in much faster reading of HTTP " "responses. (Contributed by Kristján Valur Jónsson; :issue:`4879`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1296 +#: whatsnew/2.7.rst:1296 msgid "" "The :class:`~httplib.HTTPConnection` and :class:`~httplib.HTTPSConnection` " "classes now support a *source_address* parameter, a ``(host, port)`` 2-tuple " @@ -15663,7 +15575,7 @@ msgid "" "by Eldon Ziegler; :issue:`3972`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1301 +#: whatsnew/2.7.rst:1301 msgid "" "The :mod:`ihooks` module now supports relative imports. Note that :mod:" "`ihooks` is an older module for customizing imports, superseded by the :mod:" @@ -15671,13 +15583,13 @@ msgid "" "Schemenauer.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1308 +#: whatsnew/2.7.rst:1308 msgid "" "The :mod:`imaplib` module now supports IPv6 addresses. (Contributed by Derek " "Morr; :issue:`1655`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1311 +#: whatsnew/2.7.rst:1311 msgid "" "New function: the :mod:`inspect` module's :func:`~inspect.getcallargs` takes " "a callable and its positional and keyword arguments, and figures out which " @@ -15685,11 +15597,11 @@ msgid "" "dictionary mapping argument names to their values. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1328 +#: whatsnew/2.7.rst:1328 msgid "Contributed by George Sakkis; :issue:`3135`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1330 +#: whatsnew/2.7.rst:1330 msgid "" "Updated module: The :mod:`io` library has been upgraded to the version " "shipped with Python 3.1. For 3.1, the I/O library was entirely rewritten in " @@ -15697,14 +15609,14 @@ msgid "" "original Python version was renamed to the :mod:`_pyio` module." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1335 +#: whatsnew/2.7.rst:1335 msgid "" "One minor resulting change: the :class:`io.TextIOBase` class now has an :" "attr:`errors` attribute giving the error setting used for encoding and " "decoding errors (one of ``'strict'``, ``'replace'``, ``'ignore'``)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1340 +#: whatsnew/2.7.rst:1340 msgid "" "The :class:`io.FileIO` class now raises an :exc:`OSError` when passed an " "invalid file descriptor. (Implemented by Benjamin Peterson; :issue:" @@ -15713,14 +15625,14 @@ msgid "" "file. (Fixed by Pascal Chambon; :issue:`6939`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1346 +#: whatsnew/2.7.rst:1346 msgid "" "New function: ``itertools.compress(data, selectors)`` takes two iterators. " "Elements of *data* are returned if the corresponding value in *selectors* is " "true::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1355 +#: whatsnew/2.7.rst:1355 msgid "" "New function: ``itertools.combinations_with_replacement(iter, r)`` returns " "all the possible *r*-length combinations of elements from the iterable " @@ -15728,13 +15640,13 @@ msgid "" "repeated in the generated combinations::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1364 +#: whatsnew/2.7.rst:1364 msgid "" "Note that elements are treated as unique depending on their position in the " "input, not their actual values." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1367 +#: whatsnew/2.7.rst:1367 msgid "" "The :func:`itertools.count` function now has a *step* argument that allows " "incrementing by values other than 1. :func:`~itertools.count` also now " @@ -15743,7 +15655,7 @@ msgid "" "issue:`5032`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1373 +#: whatsnew/2.7.rst:1373 msgid "" ":func:`itertools.combinations` and :func:`itertools.product` previously " "raised :exc:`ValueError` for values of *r* larger than the input iterable. " @@ -15751,14 +15663,14 @@ msgid "" "iterator. (Fixed by Raymond Hettinger; :issue:`4816`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1378 +#: whatsnew/2.7.rst:1378 msgid "" "Updated module: The :mod:`json` module was upgraded to version 2.0.9 of the " "simplejson package, which includes a C extension that makes encoding and " "decoding faster. (Contributed by Bob Ippolito; :issue:`4136`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1383 +#: whatsnew/2.7.rst:1383 msgid "" "To support the new :class:`collections.OrderedDict` type, :func:`json.load` " "now has an optional *object_pairs_hook* parameter that will be called with " @@ -15767,7 +15679,7 @@ msgid "" msgstr "" # de7384bd02bd4a6ca8611c5f7e76de9e -#: ../src/Doc/whatsnew/2.7.rst:1388 +#: whatsnew/2.7.rst:1388 msgid "" "The :mod:`mailbox` module's :class:`~mailbox.Maildir` class now records the " "timestamp on the directories it reads, and only re-reads them if the " @@ -15776,7 +15688,7 @@ msgid "" "Pitrou; :issue:`1607951`, :issue:`6896`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1394 +#: whatsnew/2.7.rst:1394 msgid "" "New functions: the :mod:`math` module gained :func:`~math.erf` and :func:" "`~math.erfc` for the error function and the complementary error function, :" @@ -15787,7 +15699,7 @@ msgid "" "`3366`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1402 +#: whatsnew/2.7.rst:1402 msgid "" "The :mod:`multiprocessing` module's :class:`Manager*` classes can now be " "passed a callable that will be called whenever a subprocess is started, " @@ -15795,7 +15707,7 @@ msgid "" "(Contributed by lekma; :issue:`5585`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1408 +#: whatsnew/2.7.rst:1408 msgid "" "The :class:`~multiprocessing.Pool` class, which controls a pool of worker " "processes, now has an optional *maxtasksperchild* parameter. Worker " @@ -15805,13 +15717,13 @@ msgid "" "worker to become very large. (Contributed by Charles Cazabon; :issue:`6963`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1416 +#: whatsnew/2.7.rst:1416 msgid "" "The :mod:`nntplib` module now supports IPv6 addresses. (Contributed by Derek " "Morr; :issue:`1664`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1419 +#: whatsnew/2.7.rst:1419 msgid "" "New functions: the :mod:`os` module wraps the following POSIX system calls: :" "func:`~os.getresgid` and :func:`~os.getresuid`, which return the real, " @@ -15822,14 +15734,14 @@ msgid "" "`6508`. Support for initgroups added by Jean-Paul Calderone; :issue:`7333`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1429 +#: whatsnew/2.7.rst:1429 msgid "" "The :func:`os.fork` function now re-initializes the import lock in the child " "process; this fixes problems on Solaris when :func:`~os.fork` is called from " "a thread. (Fixed by Zsolt Cserna; :issue:`7242`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1433 +#: whatsnew/2.7.rst:1433 msgid "" "In the :mod:`os.path` module, the :func:`~os.path.normpath` and :func:`~os." "path.abspath` functions now preserve Unicode; if their input path is a " @@ -15838,14 +15750,14 @@ msgid "" "fixed by Ezio Melotti in :issue:`3426`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1439 +#: whatsnew/2.7.rst:1439 msgid "" "The :mod:`pydoc` module now has help for the various symbols that Python " "uses. You can now do ``help('<<')`` or ``help('@')``, for example. " "(Contributed by David Laban; :issue:`4739`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1443 +#: whatsnew/2.7.rst:1443 msgid "" "The :mod:`re` module's :func:`~re.split`, :func:`~re.sub`, and :func:`~re." "subn` now accept an optional *flags* argument, for consistency with the " @@ -15853,7 +15765,7 @@ msgid "" msgstr "" # 078fe0731dd24fbd8873c1c425194573 -#: ../src/Doc/whatsnew/2.7.rst:1447 +#: whatsnew/2.7.rst:1447 msgid "" "New function: :func:`~runpy.run_path` in the :mod:`runpy` module will " "execute the code at a provided *path* argument. *path* can be the path of a " @@ -15868,7 +15780,7 @@ msgid "" "processes an explicit path name. (Added by Nick Coghlan; :issue:`6816`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1461 +#: whatsnew/2.7.rst:1461 msgid "" "New function: in the :mod:`shutil` module, :func:`~shutil.make_archive` " "takes a filename, archive type (zip or tar-format), and a directory path, " @@ -15876,7 +15788,7 @@ msgid "" "Ziadé.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1466 +#: whatsnew/2.7.rst:1466 msgid "" ":mod:`shutil`'s :func:`~shutil.copyfile` and :func:`~shutil.copytree` " "functions now raise a :exc:`~shutil.SpecialFileError` exception when asked " @@ -15885,7 +15797,7 @@ msgid "" "indefinitely. (Fixed by Antoine Pitrou; :issue:`3002`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1472 +#: whatsnew/2.7.rst:1472 msgid "" "The :mod:`signal` module no longer re-installs the signal handler unless " "this is truly necessary, which fixes a bug that could make it impossible to " @@ -15893,7 +15805,7 @@ msgid "" "`8354`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1477 +#: whatsnew/2.7.rst:1477 msgid "" "New functions: in the :mod:`site` module, three new functions return various " "site- and user-specific paths. :func:`~site.getsitepackages` returns a list " @@ -15904,7 +15816,7 @@ msgid "" "store data. (Contributed by Tarek Ziadé; :issue:`6693`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1488 +#: whatsnew/2.7.rst:1488 msgid "" "The :mod:`site` module now reports exceptions occurring when the :mod:" "`sitecustomize` module is imported, and will no longer catch and swallow " @@ -15912,14 +15824,14 @@ msgid "" "`3137`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1493 +#: whatsnew/2.7.rst:1493 msgid "" "The :func:`~socket.create_connection` function gained a *source_address* " "parameter, a ``(host, port)`` 2-tuple giving the source address that will be " "used for the connection. (Contributed by Eldon Ziegler; :issue:`3972`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1498 +#: whatsnew/2.7.rst:1498 msgid "" "The :meth:`~socket.socket.recv_into` and :meth:`~socket.socket." "recvfrom_into` methods will now write into objects that support the buffer " @@ -15928,7 +15840,7 @@ msgid "" msgstr "" # 8e18dbe840534dffb551e63fad7982f5 -#: ../src/Doc/whatsnew/2.7.rst:1503 +#: whatsnew/2.7.rst:1503 msgid "" "The :mod:`SocketServer` module's :class:`~SocketServer.TCPServer` class now " "supports socket timeouts and disabling the Nagle algorithm. The :attr:" @@ -15943,7 +15855,7 @@ msgid "" "`6192` and :issue:`6267`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1515 +#: whatsnew/2.7.rst:1515 msgid "" "Updated module: the :mod:`sqlite3` module has been updated to version 2.6.0 " "of the `pysqlite package <http://code.google.com/p/pysqlite/>`__. Version " @@ -15955,7 +15867,7 @@ msgid "" msgstr "" # 6b4571f302574564935c99fd6fef589e -#: ../src/Doc/whatsnew/2.7.rst:1522 +#: whatsnew/2.7.rst:1522 msgid "" "The :mod:`ssl` module's :class:`~ssl.SSLSocket` objects now support the " "buffer API, which fixed a test suite failure (fix by Antoine Pitrou; :issue:" @@ -15964,7 +15876,7 @@ msgid "" "that trigger an SSL renegotiation (fix by Antoine Pitrou; :issue:`8222`)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1529 +#: whatsnew/2.7.rst:1529 msgid "" "The :func:`ssl.wrap_socket` constructor function now takes a *ciphers* " "argument that's a string listing the encryption algorithms to be allowed; " @@ -15973,7 +15885,7 @@ msgid "" "Antoine Pitrou; :issue:`8322`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1536 +#: whatsnew/2.7.rst:1536 msgid "" "Another change makes the extension load all of OpenSSL's ciphers and digest " "algorithms so that they're all available. Some SSL certificates couldn't be " @@ -15981,7 +15893,7 @@ msgid "" "Kosata, and fixed by Antoine Pitrou; :issue:`8484`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1542 +#: whatsnew/2.7.rst:1542 msgid "" "The version of OpenSSL being used is now available as the module attributes :" "data:`ssl.OPENSSL_VERSION` (a string), :data:`ssl.OPENSSL_VERSION_INFO` (a 5-" @@ -15989,7 +15901,7 @@ msgid "" "Antoine Pitrou; :issue:`8321`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1548 +#: whatsnew/2.7.rst:1548 msgid "" "The :mod:`struct` module will no longer silently ignore overflow errors when " "a value is too large for a particular integer format code (one of " @@ -16000,7 +15912,7 @@ msgid "" "(Changed by Mark Dickinson; :issue:`8300`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1557 +#: whatsnew/2.7.rst:1557 msgid "" "New function: the :mod:`subprocess` module's :func:`~subprocess." "check_output` runs a command with a specified set of arguments and returns " @@ -16008,11 +15920,11 @@ msgid "" "raises a :exc:`~subprocess.CalledProcessError` exception otherwise." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1572 +#: whatsnew/2.7.rst:1572 msgid "(Contributed by Gregory P. Smith.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1574 +#: whatsnew/2.7.rst:1574 msgid "" "The :mod:`subprocess` module will now retry its internal system calls on " "receiving an :const:`EINTR` signal. (Reported by several people; final " @@ -16020,7 +15932,7 @@ msgid "" msgstr "" # 74c3cf63d88a4c6886c43b4a1d15eef0 -#: ../src/Doc/whatsnew/2.7.rst:1578 +#: whatsnew/2.7.rst:1578 msgid "" "New function: :func:`~symtable.Symbol.is_declared_global` in the :mod:" "`symtable` module returns true for variables that are explicitly declared to " @@ -16028,21 +15940,21 @@ msgid "" "Hylton.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1583 ../src/Doc/whatsnew/2.7.rst:2458 +#: whatsnew/2.7.rst:1583 whatsnew/2.7.rst:2458 msgid "" "The :mod:`syslog` module will now use the value of ``sys.argv[0]`` as the " "identifier instead of the previous default value of ``'python'``. (Changed " "by Sean Reifschneider; :issue:`8451`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1587 +#: whatsnew/2.7.rst:1587 msgid "" "The ``sys.version_info`` value is now a named tuple, with attributes named :" "attr:`major`, :attr:`minor`, :attr:`micro`, :attr:`releaselevel`, and :attr:" "`serial`. (Contributed by Ross Light; :issue:`4285`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1592 +#: whatsnew/2.7.rst:1592 msgid "" ":func:`sys.getwindowsversion` also returns a named tuple, with attributes " "named :attr:`major`, :attr:`minor`, :attr:`build`, :attr:`platform`, :attr:" @@ -16051,7 +15963,7 @@ msgid "" "issue:`7766`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1598 ../src/Doc/whatsnew/2.7.rst:2462 +#: whatsnew/2.7.rst:1598 whatsnew/2.7.rst:2462 msgid "" "The :mod:`tarfile` module's default error handling has changed, to no longer " "suppress fatal errors. The default error level was previously 0, which " @@ -16062,7 +15974,7 @@ msgid "" msgstr "" # 45bc9adc9d604351b4d64928bc77127c -#: ../src/Doc/whatsnew/2.7.rst:1606 +#: whatsnew/2.7.rst:1606 msgid "" ":mod:`tarfile` now supports filtering the :class:`~tarfile.TarInfo` objects " "being added to a tar file. When you call :meth:`~tarfile.TarFile.add`, you " @@ -16076,7 +15988,7 @@ msgid "" "issue:`7232`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1618 +#: whatsnew/2.7.rst:1618 msgid "" "The :meth:`~threading.Event.wait` method of the :class:`threading.Event` " "class now returns the internal flag on exit. This means the method will " @@ -16086,7 +15998,7 @@ msgid "" "Tim Lesher; :issue:`1674032`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1625 +#: whatsnew/2.7.rst:1625 msgid "" "The Unicode database provided by the :mod:`unicodedata` module is now used " "internally to determine which characters are numeric, whitespace, or " @@ -16096,7 +16008,7 @@ msgid "" "Florent Xicluna; :issue:`8024`)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1633 ../src/Doc/whatsnew/2.7.rst:2470 +#: whatsnew/2.7.rst:1633 whatsnew/2.7.rst:2470 msgid "" "The :mod:`urlparse` module's :func:`~urlparse.urlsplit` now handles unknown " "URL schemes in a fashion compliant with :rfc:`3986`: if the URL is of the " @@ -16106,23 +16018,23 @@ msgid "" "For example, Python 2.6.4 or 2.5 will return the following:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1645 ../src/Doc/whatsnew/2.7.rst:2482 +#: whatsnew/2.7.rst:1645 whatsnew/2.7.rst:2482 msgid "Python 2.7 (and Python 2.6.5) will return:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1651 ../src/Doc/whatsnew/2.7.rst:2488 +#: whatsnew/2.7.rst:1651 whatsnew/2.7.rst:2488 msgid "" "(Python 2.7 actually produces slightly different output, since it returns a " "named tuple instead of a standard tuple.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1654 +#: whatsnew/2.7.rst:1654 msgid "" "The :mod:`urlparse` module also supports IPv6 literal addresses as defined " "by :rfc:`2732` (contributed by Senthil Kumaran; :issue:`2987`). ::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1661 +#: whatsnew/2.7.rst:1661 msgid "" "New class: the :class:`~weakref.WeakSet` class in the :mod:`weakref` module " "is a set that only holds weak references to its elements; elements will be " @@ -16131,7 +16043,7 @@ msgid "" "Michael Foord.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1667 +#: whatsnew/2.7.rst:1667 msgid "" "The ElementTree library, :mod:`xml.etree`, no longer escapes ampersands and " "angle brackets when outputting an XML processing instruction (which looks " @@ -16139,7 +16051,7 @@ msgid "" "``<!-- comment -->``). (Patch by Neil Muller; :issue:`2746`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1673 +#: whatsnew/2.7.rst:1673 msgid "" "The XML-RPC client and server, provided by the :mod:`xmlrpclib` and :mod:" "`SimpleXMLRPCServer` modules, have improved performance by supporting " @@ -16150,14 +16062,14 @@ msgid "" "(Contributed by Kristján Valur Jónsson; :issue:`6267`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1682 +#: whatsnew/2.7.rst:1682 msgid "" "The :mod:`zipfile` module's :class:`~zipfile.ZipFile` now supports the " "context management protocol, so you can write ``with zipfile.ZipFile(...) as " "f:``. (Contributed by Brian Curtin; :issue:`5511`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1686 +#: whatsnew/2.7.rst:1686 msgid "" ":mod:`zipfile` now also supports archiving empty directories and extracts " "them correctly. (Fixed by Kuba Wieczorek; :issue:`4710`.) Reading files out " @@ -16166,14 +16078,14 @@ msgid "" "Aides; :issue:`7610`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1692 +#: whatsnew/2.7.rst:1692 msgid "" "The :func:`~zipfile.is_zipfile` function now accepts a file object, in " "addition to the path names accepted in earlier versions. (Contributed by " "Gabriel Genellina; :issue:`4756`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1696 +#: whatsnew/2.7.rst:1696 msgid "" "The :meth:`~zipfile.ZipFile.writestr` method now has an optional " "*compress_type* parameter that lets you override the default compression " @@ -16181,11 +16093,11 @@ msgid "" "by Ronald Oussoren; :issue:`6003`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1709 +#: whatsnew/2.7.rst:1709 msgid "New module: importlib" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1711 +#: whatsnew/2.7.rst:1711 msgid "" "Python 3.1 includes the :mod:`importlib` package, a re-implementation of the " "logic underlying Python's :keyword:`import` statement. :mod:`importlib` is " @@ -16196,7 +16108,7 @@ msgid "" "import_module`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1719 +#: whatsnew/2.7.rst:1719 msgid "" "``import_module(name, package=None)`` imports a module. *name* is a string " "containing the module or package's name. It's possible to do relative " @@ -16207,21 +16119,21 @@ msgid "" "imported module into ``sys.modules`` and returns the module object." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1728 +#: whatsnew/2.7.rst:1728 msgid "Here are some examples::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1739 +#: whatsnew/2.7.rst:1739 msgid "" ":mod:`importlib` was implemented by Brett Cannon and introduced in Python " "3.1." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1744 +#: whatsnew/2.7.rst:1744 msgid "New module: sysconfig" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1746 +#: whatsnew/2.7.rst:1746 msgid "" "The :mod:`sysconfig` module has been pulled out of the Distutils package, " "becoming a new top-level module in its own right. :mod:`sysconfig` provides " @@ -16230,44 +16142,44 @@ msgid "" "running from its source directory." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1753 +#: whatsnew/2.7.rst:1753 msgid "Some of the functions in the module are:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1755 +#: whatsnew/2.7.rst:1755 msgid "" ":func:`~sysconfig.get_config_var` returns variables from Python's Makefile " "and the :file:`pyconfig.h` file." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1757 +#: whatsnew/2.7.rst:1757 msgid "" ":func:`~sysconfig.get_config_vars` returns a dictionary containing all of " "the configuration variables." msgstr "" # 823e05961c114f5394b7bb494324798a -#: ../src/Doc/whatsnew/2.7.rst:1759 +#: whatsnew/2.7.rst:1759 msgid "" ":func:`~sysconfig.get_path` returns the configured path for a particular " "type of module: the standard library, site-specific modules, platform-" "specific modules, etc." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1762 +#: whatsnew/2.7.rst:1762 msgid "" ":func:`~sysconfig.is_python_build` returns true if you're running a binary " "from a Python source tree, and false otherwise." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1765 +#: whatsnew/2.7.rst:1765 msgid "" "Consult the :mod:`sysconfig` documentation for more details and for a " "complete list of functions." msgstr "" # 6f9330d8425b4260b43dbb83ddde891c -#: ../src/Doc/whatsnew/2.7.rst:1768 +#: whatsnew/2.7.rst:1768 msgid "" "The Distutils package and :mod:`sysconfig` are now maintained by Tarek " "Ziadé, who has also started a Distutils2 package (source repository at " @@ -16275,11 +16187,11 @@ msgid "" "of Distutils." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1775 +#: whatsnew/2.7.rst:1775 msgid "ttk: Themed Widgets for Tk" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1777 +#: whatsnew/2.7.rst:1777 msgid "" "Tcl/Tk 8.5 includes a set of themed widgets that re-implement basic Tk " "widgets but have a more customizable appearance and can therefore more " @@ -16288,7 +16200,7 @@ msgid "" "added to Tcl/Tck release 8.5." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1783 +#: whatsnew/2.7.rst:1783 msgid "" "To learn more, read the :mod:`ttk` module documentation. You may also wish " "to read the Tcl/Tk manual page describing the Ttk theme engine, available at " @@ -16297,7 +16209,7 @@ msgid "" "Screenshots." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1790 +#: whatsnew/2.7.rst:1790 msgid "" "The :mod:`ttk` module was written by Guilherme Polo and added in :issue:" "`2983`. An alternate version called ``Tile.py``, written by Martin Franklin " @@ -16305,12 +16217,12 @@ msgid "" "but the authors argued that Guilherme Polo's work was more comprehensive." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1800 +#: whatsnew/2.7.rst:1800 msgid "Updated module: unittest" msgstr "" # 861b7f15d5774f78803f4e043bb8b371 -#: ../src/Doc/whatsnew/2.7.rst:1802 +#: whatsnew/2.7.rst:1802 msgid "" "The :mod:`unittest` module was greatly enhanced; many new features were " "added. Most of these features were implemented by Michael Foord, unless " @@ -16319,7 +16231,7 @@ msgid "" "`unittest2` package, from https://pypi.python.org/pypi/unittest2." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1809 +#: whatsnew/2.7.rst:1809 msgid "" "When used from the command line, the module can automatically discover " "tests. It's not as fancy as `py.test <http://pytest.org>`__ or `nose " @@ -16329,25 +16241,25 @@ msgid "" "files named ``test*.py``::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1818 +#: whatsnew/2.7.rst:1818 msgid "" "Consult the :mod:`unittest` module documentation for more details. " "(Developed in :issue:`6001`.)" msgstr "" # 78868bb9b9d444a688756a0586e6ecf7 -#: ../src/Doc/whatsnew/2.7.rst:1821 +#: whatsnew/2.7.rst:1821 msgid "The :func:`~unittest.main` function supports some other new options:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1823 +#: whatsnew/2.7.rst:1823 msgid "" ":option:`-b` or :option:`--buffer` will buffer the standard output and " "standard error streams during each test. If the test passes, any resulting " "output will be discarded; on failure, the buffered output will be displayed." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1828 +#: whatsnew/2.7.rst:1828 msgid "" ":option:`-c` or :option:`--catch` will cause the control-C interrupt to be " "handled more gracefully. Instead of interrupting the test process " @@ -16357,7 +16269,7 @@ msgid "" msgstr "" # ff0ad627767342339682e47de6da68ce -#: ../src/Doc/whatsnew/2.7.rst:1835 +#: whatsnew/2.7.rst:1835 msgid "" "This control-C handler tries to avoid causing problems when the code being " "tested or the tests being run have defined a signal handler of their own, by " @@ -16367,27 +16279,27 @@ msgid "" "disabled." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1842 +#: whatsnew/2.7.rst:1842 msgid "" ":option:`-f` or :option:`--failfast` makes test execution stop immediately " "when a test fails instead of continuing to execute further tests. " "(Suggested by Cliff Dyer and implemented by Michael Foord; :issue:`8074`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1847 +#: whatsnew/2.7.rst:1847 msgid "" "The progress messages now show 'x' for expected failures and 'u' for " "unexpected successes when run in verbose mode. (Contributed by Benjamin " "Peterson.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1851 +#: whatsnew/2.7.rst:1851 msgid "" "Test cases can raise the :exc:`~unittest.SkipTest` exception to skip a test " "(:issue:`1034053`)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1854 +#: whatsnew/2.7.rst:1854 msgid "" "The error messages for :meth:`~unittest.TestCase.assertEqual`, :meth:" "`~unittest.TestCase.assertTrue`, and :meth:`~unittest.TestCase.assertFalse` " @@ -16398,18 +16310,18 @@ msgid "" "`5663`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1861 +#: whatsnew/2.7.rst:1861 msgid "" "The :meth:`~unittest.TestCase.assertRaises` method now returns a context " "handler when called without providing a callable object to run. For " "example, you can write this::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1868 +#: whatsnew/2.7.rst:1868 msgid "(Implemented by Antoine Pitrou; :issue:`4444`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1872 +#: whatsnew/2.7.rst:1872 msgid "" "Module- and class-level setup and teardown fixtures are now supported. " "Modules can contain :func:`~unittest.setUpModule` and :func:`~unittest." @@ -16420,7 +16332,7 @@ msgid "" "case in a different module or class." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1880 +#: whatsnew/2.7.rst:1880 msgid "" "The methods :meth:`~unittest.TestCase.addCleanup` and :meth:`~unittest." "TestCase.doCleanups` were added. :meth:`~unittest.TestCase.addCleanup` lets " @@ -16430,7 +16342,7 @@ msgid "" "simpler resource allocation and deallocation during tests (:issue:`5679`)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1888 +#: whatsnew/2.7.rst:1888 msgid "" "A number of new methods were added that provide more specialized tests. " "Many of these methods were written by Google engineers for use in their test " @@ -16438,21 +16350,21 @@ msgid "" "Python's version of :mod:`unittest`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1893 +#: whatsnew/2.7.rst:1893 msgid "" ":meth:`~unittest.TestCase.assertIsNone` and :meth:`~unittest.TestCase." "assertIsNotNone` take one expression and verify that the result is or is not " "``None``." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1896 +#: whatsnew/2.7.rst:1896 msgid "" ":meth:`~unittest.TestCase.assertIs` and :meth:`~unittest.TestCase." "assertIsNot` take two values and check whether the two values evaluate to " "the same object or not. (Added by Michael Foord; :issue:`2578`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1900 +#: whatsnew/2.7.rst:1900 msgid "" ":meth:`~unittest.TestCase.assertIsInstance` and :meth:`~unittest.TestCase." "assertNotIsInstance` check whether the resulting object is an instance of a " @@ -16460,14 +16372,14 @@ msgid "" "issue:`7031`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1905 +#: whatsnew/2.7.rst:1905 msgid "" ":meth:`~unittest.TestCase.assertGreater`, :meth:`~unittest.TestCase." "assertGreaterEqual`, :meth:`~unittest.TestCase.assertLess`, and :meth:" "`~unittest.TestCase.assertLessEqual` compare two quantities." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1909 +#: whatsnew/2.7.rst:1909 msgid "" ":meth:`~unittest.TestCase.assertMultiLineEqual` compares two strings, and if " "they're not equal, displays a helpful comparison that highlights the " @@ -16475,7 +16387,7 @@ msgid "" "Unicode strings are compared with :meth:`~unittest.TestCase.assertEqual`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1914 +#: whatsnew/2.7.rst:1914 msgid "" ":meth:`~unittest.TestCase.assertRegexpMatches` and :meth:`~unittest.TestCase." "assertNotRegexpMatches` checks whether the first argument is a string " @@ -16483,32 +16395,32 @@ msgid "" "argument (:issue:`8038`)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1919 +#: whatsnew/2.7.rst:1919 msgid "" ":meth:`~unittest.TestCase.assertRaisesRegexp` checks whether a particular " "exception is raised, and then also checks that the string representation of " "the exception matches the provided regular expression." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1923 +#: whatsnew/2.7.rst:1923 msgid "" ":meth:`~unittest.TestCase.assertIn` and :meth:`~unittest.TestCase." "assertNotIn` tests whether *first* is or is not in *second*." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1926 +#: whatsnew/2.7.rst:1926 msgid "" ":meth:`~unittest.TestCase.assertItemsEqual` tests whether two provided " "sequences contain the same elements." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1929 +#: whatsnew/2.7.rst:1929 msgid "" ":meth:`~unittest.TestCase.assertSetEqual` compares whether two sets are " "equal, and only reports the differences between the sets in case of error." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1932 +#: whatsnew/2.7.rst:1932 msgid "" "Similarly, :meth:`~unittest.TestCase.assertListEqual` and :meth:`~unittest." "TestCase.assertTupleEqual` compare the specified types and explain any " @@ -16519,7 +16431,7 @@ msgid "" "both sequences are of a particular type." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1940 +#: whatsnew/2.7.rst:1940 msgid "" ":meth:`~unittest.TestCase.assertDictEqual` compares two dictionaries and " "reports the differences; it's now used by default when you compare two " @@ -16528,7 +16440,7 @@ msgid "" "in *first* are found in *second*." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1945 +#: whatsnew/2.7.rst:1945 msgid "" ":meth:`~unittest.TestCase.assertAlmostEqual` and :meth:`~unittest.TestCase." "assertNotAlmostEqual` test whether *first* and *second* are approximately " @@ -16537,14 +16449,14 @@ msgid "" "require the difference to be smaller than a supplied *delta* value." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1951 +#: whatsnew/2.7.rst:1951 msgid "" ":meth:`~unittest.TestLoader.loadTestsFromName` properly honors the :attr:" "`~unittest.TestLoader.suiteClass` attribute of the :class:`~unittest." "TestLoader`. (Fixed by Mark Roddy; :issue:`6866`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1955 +#: whatsnew/2.7.rst:1955 msgid "" "A new hook lets you extend the :meth:`~unittest.TestCase.assertEqual` method " "to handle new data types. The :meth:`~unittest.TestCase." @@ -16557,7 +16469,7 @@ msgid "" msgstr "" # a0e752d84ff042358209ac6e7e525f62 -#: ../src/Doc/whatsnew/2.7.rst:1964 +#: whatsnew/2.7.rst:1964 msgid "" ":func:`unittest.main` now takes an optional ``exit`` argument. If False, :" "func:`~unittest.main` doesn't call :func:`sys.exit`, allowing :func:" @@ -16565,7 +16477,7 @@ msgid "" "by J. Pablo Fernández; :issue:`3379`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1969 +#: whatsnew/2.7.rst:1969 msgid "" ":class:`~unittest.TestResult` has new :meth:`~unittest.TestResult." "startTestRun` and :meth:`~unittest.TestResult.stopTestRun` methods that are " @@ -16573,7 +16485,7 @@ msgid "" "Collins; :issue:`5728`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1973 +#: whatsnew/2.7.rst:1973 msgid "" "With all these changes, the :file:`unittest.py` was becoming awkwardly " "large, so the module was turned into a package and the code split into " @@ -16582,35 +16494,35 @@ msgid "" msgstr "" # 2fb039e038d142ae9839f7cc448016ec -#: ../src/Doc/whatsnew/2.7.rst:1980 +#: whatsnew/2.7.rst:1981 msgid "http://www.voidspace.org.uk/python/articles/unittest2.shtml" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1981 +#: whatsnew/2.7.rst:1981 msgid "" "Describes the new features, how to use them, and the rationale for various " "design decisions. (By Michael Foord.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1987 +#: whatsnew/2.7.rst:1987 msgid "Updated module: ElementTree 1.3" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1989 +#: whatsnew/2.7.rst:1989 msgid "" "The version of the ElementTree library included with Python was updated to " "version 1.3. Some of the new features are:" msgstr "" # 97339ec2f63e4886a6eaa36631811dca -#: ../src/Doc/whatsnew/2.7.rst:1992 +#: whatsnew/2.7.rst:1992 msgid "" "The various parsing functions now take a *parser* keyword argument giving " "an :class:`~xml.etree.ElementTree.XMLParser` instance that will be used. " "This makes it possible to override the file's internal encoding::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:1999 +#: whatsnew/2.7.rst:1999 msgid "" "Errors in parsing XML now raise a :exc:`ParseError` exception, whose " "instances have a :attr:`position` attribute containing a (*line*, *column*) " @@ -16618,7 +16530,7 @@ msgid "" msgstr "" # 94aeab6169434e9bb24ee45e546a9e3f -#: ../src/Doc/whatsnew/2.7.rst:2003 +#: whatsnew/2.7.rst:2003 msgid "" "ElementTree's code for converting trees to a string has been significantly " "reworked, making it roughly twice as fast in many cases. The :meth:" @@ -16633,7 +16545,7 @@ msgid "" msgstr "" # 9f1136f8c75a4730bbb46bf1d3912723 -#: ../src/Doc/whatsnew/2.7.rst:2015 +#: whatsnew/2.7.rst:2015 msgid "" "Namespace handling has also been improved. All ``xmlns:<whatever>`` " "declarations are now output on the root element, not scattered throughout " @@ -16644,7 +16556,7 @@ msgid "" msgstr "" # 0c3f032fece84fbd83c663737aa41a93 -#: ../src/Doc/whatsnew/2.7.rst:2023 +#: whatsnew/2.7.rst:2023 msgid "" "New :class:`~xml.etree.ElementTree.Element` method: :meth:`~xml.etree." "ElementTree.Element.extend` appends the items from a sequence to the " @@ -16653,7 +16565,7 @@ msgid "" msgstr "" # 8dec8f1741604715a0ef50181b59dc2b -#: ../src/Doc/whatsnew/2.7.rst:2040 +#: whatsnew/2.7.rst:2040 msgid "" "New :class:`Element` method: :meth:`~xml.etree.ElementTree.Element.iter` " "yields the children of the element as a generator. It's also possible to " @@ -16663,13 +16575,13 @@ msgid "" msgstr "" # a65c479231544089bdeffdd61a0a3da4 -#: ../src/Doc/whatsnew/2.7.rst:2047 +#: whatsnew/2.7.rst:2047 msgid "" "New :class:`Element` method: :meth:`~xml.etree.ElementTree.Element.itertext` " "yields all chunks of text that are descendants of the element. For example::" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2058 +#: whatsnew/2.7.rst:2058 msgid "" "Deprecated: using an element as a Boolean (i.e., ``if elem:``) would return " "true if the element had any children, or false if there were no children. " @@ -16679,7 +16591,7 @@ msgid "" "number of children, or ``elem is not None``." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2066 +#: whatsnew/2.7.rst:2066 msgid "" "Fredrik Lundh develops ElementTree and produced the 1.3 version; you can " "read his article describing 1.3 at http://effbot.org/zone/elementtree-13-" @@ -16687,7 +16599,7 @@ msgid "" "discussions on python-dev and in :issue:`6472`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2080 +#: whatsnew/2.7.rst:2080 msgid "" "The latest release of the GNU Debugger, GDB 7, can be `scripted using Python " "<http://sourceware.org/gdb/current/onlinedocs/gdb/Python.html>`__. When you " @@ -16700,7 +16612,7 @@ msgid "" "Python stack trace. (Added as a result of :issue:`8032`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2092 +#: whatsnew/2.7.rst:2092 msgid "" "If you use the :file:`.gdbinit` file provided with Python, the \"pyo\" macro " "in the 2.7 version now works correctly when the thread being debugged " @@ -16709,7 +16621,7 @@ msgid "" msgstr "" # 4031db26c55246a78d33aab861ae67a4 -#: ../src/Doc/whatsnew/2.7.rst:2097 +#: whatsnew/2.7.rst:2097 msgid "" ":c:func:`Py_AddPendingCall` is now thread-safe, letting any worker thread " "submit notifications to the main Python thread. This is particularly useful " @@ -16718,7 +16630,7 @@ msgid "" msgstr "" # 68a30205095d4b5cb2fdc7acecad276e -#: ../src/Doc/whatsnew/2.7.rst:2102 +#: whatsnew/2.7.rst:2102 msgid "" "New function: :c:func:`PyCode_NewEmpty` creates an empty code object; only " "the filename, function name, and first line number are required. This is " @@ -16728,7 +16640,7 @@ msgid "" msgstr "" # e6eada9609f64bbbbae32947543b96c6 -#: ../src/Doc/whatsnew/2.7.rst:2109 +#: whatsnew/2.7.rst:2109 msgid "" "New function: :c:func:`PyErr_NewExceptionWithDoc` creates a new exception " "class, just as the existing :c:func:`PyErr_NewException` does, but takes an " @@ -16737,7 +16649,7 @@ msgid "" msgstr "" # 93e56a50123b4232a4c5239301fe1a2b -#: ../src/Doc/whatsnew/2.7.rst:2115 +#: whatsnew/2.7.rst:2115 msgid "" "New function: :c:func:`PyFrame_GetLineNumber` takes a frame object and " "returns the line number that the frame is currently executing. Previously " @@ -16747,7 +16659,7 @@ msgid "" msgstr "" # 70900fc08d214463a1f82f9cc236c755 -#: ../src/Doc/whatsnew/2.7.rst:2121 +#: whatsnew/2.7.rst:2121 msgid "" "New functions: :c:func:`PyLong_AsLongAndOverflow` and :c:func:" "`PyLong_AsLongLongAndOverflow` approximates a Python long integer as a C :c:" @@ -16757,7 +16669,7 @@ msgid "" msgstr "" # a770df269bd0499ba21196c790390d0d -#: ../src/Doc/whatsnew/2.7.rst:2128 +#: whatsnew/2.7.rst:2128 msgid "" "New function: stemming from the rewrite of string-to-float conversion, a " "new :c:func:`PyOS_string_to_double` function was added. The old :c:func:" @@ -16766,7 +16678,7 @@ msgid "" msgstr "" # b2f22fda00694947b376ef96d2fcb14c -#: ../src/Doc/whatsnew/2.7.rst:2133 +#: whatsnew/2.7.rst:2133 msgid "" "New function: :c:func:`PySys_SetArgvEx` sets the value of ``sys.argv`` and " "can optionally update ``sys.path`` to include the directory containing the " @@ -16775,7 +16687,7 @@ msgid "" msgstr "" # bc9e033180884b9f9b643eae7fa62818 -#: ../src/Doc/whatsnew/2.7.rst:2138 +#: whatsnew/2.7.rst:2138 msgid "" "This function was added to close a security hole for applications that embed " "Python. The old function, :c:func:`PySys_SetArgv`, would always update " @@ -16787,7 +16699,7 @@ msgid "" msgstr "" # d1ada15796bb4a9791f87f19308ab2d1 -#: ../src/Doc/whatsnew/2.7.rst:2146 +#: whatsnew/2.7.rst:2146 msgid "" "If you maintain a C/C++ application that embeds Python, check whether you're " "calling :c:func:`PySys_SetArgv` and carefully consider whether the " @@ -16795,7 +16707,7 @@ msgid "" "to false." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2151 +#: whatsnew/2.7.rst:2151 msgid "" "Security issue reported as `CVE-2008-5983 <http://cve.mitre.org/cgi-bin/" "cvename.cgi?name=CVE-2008-5983>`_; discussed in :issue:`5753`, and fixed by " @@ -16803,7 +16715,7 @@ msgid "" msgstr "" # 5dc133cf449a48e78b8084a6869e6163 -#: ../src/Doc/whatsnew/2.7.rst:2155 +#: whatsnew/2.7.rst:2155 msgid "" "New macros: the Python header files now define the following macros: :c:" "macro:`Py_ISALNUM`, :c:macro:`Py_ISALPHA`, :c:macro:`Py_ISDIGIT`, :c:macro:" @@ -16816,7 +16728,7 @@ msgid "" msgstr "" # d4c9d09dcab9415e8f304e84ff35c035 -#: ../src/Doc/whatsnew/2.7.rst:2173 +#: whatsnew/2.7.rst:2173 msgid "" "Removed function: :c:macro:`PyEval_CallObject` is now only available as a " "macro. A function version was being kept around to preserve ABI linking " @@ -16825,7 +16737,7 @@ msgid "" msgstr "" # 1d74ed9bb79b42a2aee879611aeec43e -#: ../src/Doc/whatsnew/2.7.rst:2178 +#: whatsnew/2.7.rst:2178 msgid "" "New format codes: the :c:func:`PyFormat_FromString`, :c:func:" "`PyFormat_FromStringV`, and :c:func:`PyErr_Format` functions now accept ``" @@ -16833,7 +16745,7 @@ msgid "" "types. (Contributed by Mark Dickinson; :issue:`7228`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2184 +#: whatsnew/2.7.rst:2184 msgid "" "The complicated interaction between threads and process forking has been " "changed. Previously, the child process created by :func:`os.fork` might " @@ -16846,7 +16758,7 @@ msgid "" msgstr "" # 6660957ee96241ba8dd3061f1cdb5d0b -#: ../src/Doc/whatsnew/2.7.rst:2194 +#: whatsnew/2.7.rst:2194 msgid "" "Python 2.7 acquires the import lock before performing an :func:`os.fork`, " "and will also clean up any locks created using the :mod:`threading` module. " @@ -16854,12 +16766,12 @@ msgid "" "themselves, will not benefit from this clean-up." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2200 +#: whatsnew/2.7.rst:2200 msgid "(Fixed by Thomas Wouters; :issue:`1590864`.)" msgstr "" # fdc9f35fcfc244e78ed2576c474ac487 -#: ../src/Doc/whatsnew/2.7.rst:2202 +#: whatsnew/2.7.rst:2202 msgid "" "The :c:func:`Py_Finalize` function now calls the internal :func:`threading." "_shutdown` function; this prevents some exceptions from being raised when an " @@ -16867,27 +16779,27 @@ msgid "" msgstr "" # 31e23f5a3d61462db7142880c02c8cdf -#: ../src/Doc/whatsnew/2.7.rst:2207 +#: whatsnew/2.7.rst:2207 msgid "" "When using the :c:type:`PyMemberDef` structure to define attributes of a " "type, Python will no longer let you try to delete or set a :const:" "`T_STRING_INPLACE` attribute." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2213 +#: whatsnew/2.7.rst:2213 msgid "" "Global symbols defined by the :mod:`ctypes` module are now prefixed with " "``Py``, or with ``_ctypes``. (Implemented by Thomas Heller; :issue:`3102`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2217 +#: whatsnew/2.7.rst:2217 msgid "" "New configure option: the :option:`--with-system-expat` switch allows " "building the :mod:`pyexpat` module to use the system Expat library. " "(Contributed by Arfrever Frehtes Taifersar Arahesis; :issue:`7609`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2221 +#: whatsnew/2.7.rst:2221 msgid "" "New configure option: the :option:`--with-valgrind` option will now disable " "the pymalloc allocator, which is difficult for the Valgrind memory-error " @@ -16896,7 +16808,7 @@ msgid "" "issue:`2422`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2228 +#: whatsnew/2.7.rst:2228 msgid "" "New configure option: you can now supply an empty string to :option:`--with-" "dbmliborder=` in order to disable all of the various DBM modules. (Added by " @@ -16904,7 +16816,7 @@ msgid "" msgstr "" # 3754033b8fbb4ebc8d29de8835b8ad7e -#: ../src/Doc/whatsnew/2.7.rst:2233 +#: whatsnew/2.7.rst:2233 msgid "" "The :program:`configure` script now checks for floating-point rounding bugs " "on certain 32-bit Intel chips and defines a :c:macro:`X87_DOUBLE_ROUNDING` " @@ -16913,31 +16825,31 @@ msgid "" "`2937`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2239 +#: whatsnew/2.7.rst:2239 msgid "" ":program:`configure` also now sets a :envvar:`LDCXXSHARED` Makefile variable " "for supporting C++ linking. (Contributed by Arfrever Frehtes Taifersar " "Arahesis; :issue:`1222585`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2243 +#: whatsnew/2.7.rst:2243 msgid "" "The build process now creates the necessary files for pkg-config support. " "(Contributed by Clinton Roy; :issue:`3585`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2246 +#: whatsnew/2.7.rst:2246 msgid "" "The build process now supports Subversion 1.7. (Contributed by Arfrever " "Frehtes Taifersar Arahesis; :issue:`6094`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2253 +#: whatsnew/2.7.rst:2253 msgid "Capsules" msgstr "Capsules" # 448b963908564c1e832dd9677ecce54b -#: ../src/Doc/whatsnew/2.7.rst:2255 +#: whatsnew/2.7.rst:2255 msgid "" "Python 3.1 adds a new C datatype, :c:type:`PyCapsule`, for providing a C API " "to an extension module. A capsule is essentially the holder of a C ``void " @@ -16950,7 +16862,7 @@ msgid "" msgstr "" # 55650eabd29a4038865bc5c844e98456 -#: ../src/Doc/whatsnew/2.7.rst:2264 +#: whatsnew/2.7.rst:2264 msgid "" "There is an existing data type already used for this, :c:type:`PyCObject`, " "but it doesn't provide type safety. Evil code written in pure Python could " @@ -16960,7 +16872,7 @@ msgid "" msgstr "" # 36af2d2631484f5c8b7fa9b437829739 -#: ../src/Doc/whatsnew/2.7.rst:2280 +#: whatsnew/2.7.rst:2280 msgid "" "You are assured that ``vtable`` points to whatever you're expecting. If a " "different capsule was passed in, :c:func:`PyCapsule_IsValid` would detect " @@ -16969,7 +16881,7 @@ msgid "" msgstr "" # 128a31379d20442f9e13d7dff5c60768 -#: ../src/Doc/whatsnew/2.7.rst:2285 +#: whatsnew/2.7.rst:2285 msgid "" "Python 2.7 now uses capsules internally to provide various extension-module " "APIs, but the :c:func:`PyCObject_AsVoidPtr` was modified to handle capsules, " @@ -16978,13 +16890,13 @@ msgid "" "`PendingDeprecationWarning`, which is silent by default." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2292 +#: whatsnew/2.7.rst:2292 msgid "" "Implemented in Python 3.1 and backported to 2.7 by Larry Hastings; discussed " "in :issue:`5630`." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2301 +#: whatsnew/2.7.rst:2301 msgid "" "The :mod:`msvcrt` module now contains some constants from the :file:" "`crtassem.h` header file: :data:`CRT_ASSEMBLY_VERSION`, :data:" @@ -16993,7 +16905,7 @@ msgid "" msgstr "" # 764a2735eabc42c69ee15e6d7870bcee -#: ../src/Doc/whatsnew/2.7.rst:2308 +#: whatsnew/2.7.rst:2308 msgid "" "The :mod:`_winreg` module for accessing the registry now implements the :" "func:`~_winreg.CreateKeyEx` and :func:`~_winreg.DeleteKeyEx` functions, " @@ -17004,36 +16916,36 @@ msgid "" msgstr "" # f60ce873118446959a555fd0e0aaeb1f -#: ../src/Doc/whatsnew/2.7.rst:2316 +#: whatsnew/2.7.rst:2316 msgid "" "The new :c:func:`_beginthreadex` API is used to start threads, and the " "native thread-local storage functions are now used. (Contributed by Kristján " "Valur Jónsson; :issue:`3582`.)" msgstr "" -# dbd1e309b98b451caf6cab669f975ec0 -#: ../src/Doc/whatsnew/2.7.rst:2320 +#: whatsnew/2.7.rst:2320 msgid "" "The :func:`os.kill` function now works on Windows. The signal value can be " "the constants :const:`CTRL_C_EVENT`, :const:`CTRL_BREAK_EVENT`, or any " -"integer. The first two constants will send Control-C and Control-Break " -"keystroke events to subprocesses; any other value will use the :c:func:" -"`TerminateProcess` API. (Contributed by Miki Tebeka; :issue:`1220212`.)" +"integer. The first two constants will send :kbd:`Control-C` and :kbd:" +"`Control-Break` keystroke events to subprocesses; any other value will use " +"the :c:func:`TerminateProcess` API. (Contributed by Miki Tebeka; :issue:" +"`1220212`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2327 +#: whatsnew/2.7.rst:2327 msgid "" "The :func:`os.listdir` function now correctly fails for an empty path. " "(Fixed by Hirokazu Yamamoto; :issue:`5913`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2330 +#: whatsnew/2.7.rst:2330 msgid "" "The :mod:`mimelib` module will now read the MIME database from the Windows " "registry when initializing. (Patch by Gabriel Genellina; :issue:`4969`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2339 +#: whatsnew/2.7.rst:2339 msgid "" "The path ``/Library/Python/2.7/site-packages`` is now appended to ``sys." "path``, in order to share added packages between the system installation and " @@ -17041,11 +16953,11 @@ msgid "" "issue:`4865`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2345 +#: whatsnew/2.7.rst:2345 msgid "Port-Specific Changes: FreeBSD" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2347 +#: whatsnew/2.7.rst:2347 msgid "" "FreeBSD 7.1's :const:`SO_SETFIB` constant, used with :func:`~socket." "getsockopt`/:func:`~socket.setsockopt` to select an alternate routing table, " @@ -17053,7 +16965,7 @@ msgid "" "issue:`8235`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2355 +#: whatsnew/2.7.rst:2355 msgid "" "Two benchmark scripts, :file:`iobench` and :file:`ccbench`, were added to " "the :file:`Tools` directory. :file:`iobench` measures the speed of the " @@ -17063,13 +16975,13 @@ msgid "" "bandwidth when performing several tasks using a varying number of threads." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2363 +#: whatsnew/2.7.rst:2363 msgid "" "The :file:`Tools/i18n/msgfmt.py` script now understands plural forms in :" "file:`.po` files. (Fixed by Martin von Löwis; :issue:`5464`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2367 +#: whatsnew/2.7.rst:2367 msgid "" "When importing a module from a :file:`.pyc` or :file:`.pyo` file with an " "existing :file:`.py` counterpart, the :attr:`co_filename` attributes of the " @@ -17079,7 +16991,7 @@ msgid "" "Calderone; :issue:`1180193`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2374 +#: whatsnew/2.7.rst:2374 msgid "" "The :file:`regrtest.py` script now takes a :option:`--randseed=` switch that " "takes an integer that will be used as the random seed for the :option:`-r` " @@ -17087,7 +16999,7 @@ msgid "" "reports the seed that was used (Added by Collin Winter.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2380 +#: whatsnew/2.7.rst:2380 msgid "" "Another :file:`regrtest.py` switch is :option:`-j`, which takes an integer " "specifying how many tests run in parallel. This allows reducing the total " @@ -17098,26 +17010,26 @@ msgid "" "fail. (Added by Antoine Pitrou; :issue:`7312`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2389 +#: whatsnew/2.7.rst:2389 msgid "" "When executed as a script, the :file:`py_compile.py` module now accepts " "``'-'`` as an argument, which will read standard input for the list of " "filenames to be compiled. (Contributed by Piotr Ożarowski; :issue:`8233`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2397 +#: whatsnew/2.7.rst:2397 #, fuzzy msgid "Porting to Python 2.7" msgstr "Portage vers Python 3.2" -#: ../src/Doc/whatsnew/2.7.rst:2402 +#: whatsnew/2.7.rst:2402 msgid "" "The :func:`range` function processes its arguments more consistently; it " "will now call :meth:`__int__` on non-float, non-integer arguments that are " "supplied to it. (Fixed by Alexander Belopolsky; :issue:`1533`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2407 +#: whatsnew/2.7.rst:2407 msgid "" "The string :meth:`format` method changed the default precision used for " "floating-point and complex numbers from 6 decimal places to 12, which " @@ -17125,7 +17037,7 @@ msgid "" "`5920`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2412 +#: whatsnew/2.7.rst:2412 msgid "" "Because of an optimization for the :keyword:`with` statement, the special " "methods :meth:`__enter__` and :meth:`__exit__` must belong to the object's " @@ -17134,7 +17046,7 @@ msgid "" "types. (:issue:`6101`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2418 +#: whatsnew/2.7.rst:2418 msgid "" "Due to a bug in Python 2.6, the *exc_value* parameter to :meth:`__exit__` " "methods was often the string representation of the exception, not an " @@ -17142,12 +17054,12 @@ msgid "" "expected. (Fixed by Florent Xicluna; :issue:`7853`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2428 +#: whatsnew/2.7.rst:2428 msgid "In the standard library:" msgstr "" # 2f073667b03d4d9388fcce671daf4f42 -#: ../src/Doc/whatsnew/2.7.rst:2430 +#: whatsnew/2.7.rst:2430 msgid "" "Operations with :class:`~datetime.datetime` instances that resulted in a " "year falling outside the supported range didn't always raise :exc:" @@ -17157,7 +17069,7 @@ msgid "" msgstr "" # 43f98c8d96834680a070dc6eb7e8470b -#: ../src/Doc/whatsnew/2.7.rst:2436 +#: whatsnew/2.7.rst:2436 msgid "" "When using :class:`~decimal.Decimal` instances with a string's :meth:" "`format` method, the default alignment was previously left-alignment. This " @@ -17166,7 +17078,7 @@ msgid "" msgstr "" # be53b3d77873484caeb9eaf696078f6f -#: ../src/Doc/whatsnew/2.7.rst:2442 +#: whatsnew/2.7.rst:2442 msgid "" "Comparisons involving a signaling NaN value (or ``sNAN``) now signal :const:" "`~decimal.InvalidOperation` instead of silently returning a true or false " @@ -17174,7 +17086,7 @@ msgid "" "are now hashable. (Fixed by Mark Dickinson; :issue:`7279`.)" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2448 +#: whatsnew/2.7.rst:2448 msgid "" "The ElementTree library, :mod:`xml.etree`, no longer escapes ampersands and " "angle brackets when outputting an XML processing instruction (which looks " @@ -17183,18 +17095,18 @@ msgid "" msgstr "" # ad89c1d41efb4cd3beb37ab4f27611ec -#: ../src/Doc/whatsnew/2.7.rst:2454 +#: whatsnew/2.7.rst:2454 msgid "" "The :meth:`~StringIO.StringIO.readline` method of :class:`~StringIO." "StringIO` objects now does nothing when a negative length is requested, as " "other file-like objects do. (:issue:`7348`)." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2491 +#: whatsnew/2.7.rst:2491 msgid "For C extensions:" msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2493 +#: whatsnew/2.7.rst:2493 msgid "" "C extensions that use integer format codes with the ``PyArg_Parse*`` family " "of functions will now raise a :exc:`TypeError` exception instead of " @@ -17202,19 +17114,19 @@ msgid "" msgstr "" # 29096e1aced3447e8f4192c8467d5b4d -#: ../src/Doc/whatsnew/2.7.rst:2497 +#: whatsnew/2.7.rst:2497 msgid "" "Use the new :c:func:`PyOS_string_to_double` function instead of the old :c:" "func:`PyOS_ascii_strtod` and :c:func:`PyOS_ascii_atof` functions, which are " "now deprecated." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2501 +#: whatsnew/2.7.rst:2501 msgid "For applications that embed Python:" msgstr "" # 0717a82a83a64e259cf80692ca1f6c2d -#: ../src/Doc/whatsnew/2.7.rst:2503 +#: whatsnew/2.7.rst:2503 msgid "" "The :c:func:`PySys_SetArgvEx` function was added, letting applications close " "a security hole when the existing :c:func:`PySys_SetArgv` function was " @@ -17224,12 +17136,12 @@ msgid "" msgstr "" # 96d229a67fb7400289da84a25235bd17 -#: ../src/Doc/whatsnew/2.7.rst:2516 +#: whatsnew/2.7.rst:2516 msgid "New Features Added to Python 2.7 Maintenance Releases" msgstr "" # 5679683e30294b7bbea3812ba1f3d002 -#: ../src/Doc/whatsnew/2.7.rst:2518 +#: whatsnew/2.7.rst:2518 msgid "" "New features may be added to Python 2.7 maintenance releases when the " "situation genuinely calls for it. Any such additions must go through the " @@ -17239,7 +17151,7 @@ msgid "" msgstr "" # a5f6c5013bf44c74a3ff7f7203c5cb61 -#: ../src/Doc/whatsnew/2.7.rst:2524 +#: whatsnew/2.7.rst:2524 msgid "" "In addition to the specific proposals listed below, there is a general " "exemption allowing new ``-3`` warnings to be added in any Python 2.7 " @@ -17247,12 +17159,12 @@ msgid "" msgstr "" # 469ff7b7a0574ac4aa84d62fb50de430 -#: ../src/Doc/whatsnew/2.7.rst:2530 +#: whatsnew/2.7.rst:2530 msgid "PEP 434: IDLE Enhancement Exception for All Branches" msgstr "" # 643c268efc0d4d9ebd6fad6dc47eff55 -#: ../src/Doc/whatsnew/2.7.rst:2532 +#: whatsnew/2.7.rst:2532 msgid "" ":pep:`434` describes a general exemption for changes made to the IDLE " "development environment shipped along with Python. This exemption makes it " @@ -17261,19 +17173,19 @@ msgid "" msgstr "" # 65e80a1d9275457999b1876d677c7110 -#: ../src/Doc/whatsnew/2.7.rst:2537 +#: whatsnew/2.7.rst:2537 msgid "" "For details of any IDLE changes, refer to the NEWS file for the specific " "release." msgstr "" # b6a873696a2249fbbeb53cfb555bcd59 -#: ../src/Doc/whatsnew/2.7.rst:2542 +#: whatsnew/2.7.rst:2542 msgid "PEP 466: Network Security Enhancements for Python 2.7" msgstr "" # 3190ad3bfad841e7b19ab9321474b2b5 -#: ../src/Doc/whatsnew/2.7.rst:2544 +#: whatsnew/2.7.rst:2544 msgid "" ":pep:`466` describes a number of network security enhancement proposals that " "have been approved for inclusion in Python 2.7 maintenance releases, with " @@ -17281,12 +17193,12 @@ msgid "" msgstr "" # 9ac886b6388c4af4bc1b980b9112b7e4 -#: ../src/Doc/whatsnew/2.7.rst:2548 +#: whatsnew/2.7.rst:2548 msgid ":pep:`466` related features added in Python 2.7.7:" msgstr "" # 4031db26c55246a78d33aab861ae67a4 -#: ../src/Doc/whatsnew/2.7.rst:2550 +#: whatsnew/2.7.rst:2550 msgid "" ":func:`hmac.compare_digest` was backported from Python 3 to make a timing " "attack resistant comparison operation available to Python 2 applications. " @@ -17294,19 +17206,19 @@ msgid "" msgstr "" # 3d7be57d3e354312aeb6061e45749a3b -#: ../src/Doc/whatsnew/2.7.rst:2554 +#: whatsnew/2.7.rst:2554 msgid "" "OpenSSL 1.0.1g was upgraded in the official Windows installers published on " "python.org. (Contributed by Zachary Ware; :issue:`21462`.)" msgstr "" # 3fd8e63edeb04d13a1bf31abc1e8d9bf -#: ../src/Doc/whatsnew/2.7.rst:2557 +#: whatsnew/2.7.rst:2557 msgid ":pep:`466` related features added in Python 2.7.8:" msgstr "" # 4031db26c55246a78d33aab861ae67a4 -#: ../src/Doc/whatsnew/2.7.rst:2559 +#: whatsnew/2.7.rst:2559 msgid "" ":func:`hashlib.pbkdf2_hmac` was backported from Python 3 to make a hashing " "algorithm suitable for secure password storage broadly available to Python 2 " @@ -17314,19 +17226,19 @@ msgid "" msgstr "" # 3d7be57d3e354312aeb6061e45749a3b -#: ../src/Doc/whatsnew/2.7.rst:2563 +#: whatsnew/2.7.rst:2563 msgid "" "OpenSSL 1.0.1h was upgraded for the official Windows installers published on " "python.org. (contributed by Zachary Ware in :issue:`21671` for CVE-2014-0224)" msgstr "" # 21b97f764322446896bf230ff16f90ff -#: ../src/Doc/whatsnew/2.7.rst:2566 +#: whatsnew/2.7.rst:2566 msgid ":pep:`466` related features added in Python 2.7.9:" msgstr "" # 92950005069645dea47fa5fe77f0d2c1 -#: ../src/Doc/whatsnew/2.7.rst:2568 +#: whatsnew/2.7.rst:2568 msgid "" "Most of Python 3.4's :mod:`ssl` module was backported. This means :mod:`ssl` " "now supports Server Name Indication, TLS1.x settings, access to the platform " @@ -17335,14 +17247,14 @@ msgid "" msgstr "" # 700975765eb84b91a128068d49c163e3 -#: ../src/Doc/whatsnew/2.7.rst:2573 +#: whatsnew/2.7.rst:2573 msgid "" "Refer to the \"Version added: 2.7.9\" notes in the module documentation for " "specific details." msgstr "" # 4031db26c55246a78d33aab861ae67a4 -#: ../src/Doc/whatsnew/2.7.rst:2576 +#: whatsnew/2.7.rst:2576 msgid "" ":func:`os.urandom` was changed to cache a file descriptor to ``/dev/" "urandom`` instead of reopening ``/dev/urandom`` on every call. (Contributed " @@ -17350,7 +17262,7 @@ msgid "" msgstr "" # f64ff06c11504bf0bb1841aec60799da -#: ../src/Doc/whatsnew/2.7.rst:2580 +#: whatsnew/2.7.rst:2580 msgid "" ":data:`hashlib.algorithms_guaranteed` and :data:`hashlib." "algorithms_available` were backported from Python 3 to make it easier for " @@ -17359,12 +17271,12 @@ msgid "" msgstr "" # 58ed34f206ad4bc48708dbe4b0e1bb83 -#: ../src/Doc/whatsnew/2.7.rst:2587 +#: whatsnew/2.7.rst:2587 msgid "PEP 477: Backport ensurepip (PEP 453) to Python 2.7" msgstr "" # 32cbad7a8bc9422eb5495c45a97b787d -#: ../src/Doc/whatsnew/2.7.rst:2589 +#: whatsnew/2.7.rst:2589 msgid "" ":pep:`477` approves the inclusion of the :pep:`453` ensurepip module and the " "improved documentation that was enabled by it in the Python 2.7 maintenance " @@ -17372,12 +17284,12 @@ msgid "" msgstr "" # 61cf6e2a20754a9a9290ad80d5c2d7b3 -#: ../src/Doc/whatsnew/2.7.rst:2595 +#: whatsnew/2.7.rst:2595 msgid "Bootstrapping pip By Default" msgstr "" # 21483effcf02471bb0f67feacaf0033d -#: ../src/Doc/whatsnew/2.7.rst:2597 +#: whatsnew/2.7.rst:2597 msgid "" "The new :mod:`ensurepip` module (defined in :pep:`453`) provides a standard " "cross-platform mechanism to bootstrap the pip installer into Python " @@ -17388,15 +17300,23 @@ msgid "" msgstr "" # 99e970ac7a1047229e25c19046d5db39 -#: ../src/Doc/whatsnew/2.7.rst:2604 +#: whatsnew/2.7.rst:2604 msgid "" "By default, the commands ``pip``, ``pipX`` and ``pipX.Y`` will be installed " "on all platforms (where X.Y stands for the version of the Python " "installation), along with the ``pip`` Python package and its dependencies." msgstr "" +#: whatsnew/2.7.rst:2608 +msgid "" +"For CPython :ref:`source builds on POSIX systems <building-python-on-unix>`, " +"the ``make install`` and ``make altinstall`` commands do not bootstrap " +"``pip`` by default. This behaviour can be controlled through configure " +"options, and overridden through Makefile options." +msgstr "" + # b887c6a58ef642cb8e0acc09317670b4 -#: ../src/Doc/whatsnew/2.7.rst:2608 +#: whatsnew/2.7.rst:2613 msgid "" "On Windows and Mac OS X, the CPython installers now default to installing " "``pip`` along with CPython itself (users may opt out of installing it during " @@ -17407,7 +17327,7 @@ msgid "" msgstr "" # 93690cd816d54e8bb9807e74122d9ab7 -#: ../src/Doc/whatsnew/2.7.rst:2615 +#: whatsnew/2.7.rst:2620 msgid "" "As `discussed in the PEP`__, platform packagers may choose not to install " "these commands by default, as long as, when invoked, they provide clear and " @@ -17416,12 +17336,12 @@ msgid "" msgstr "" # 8d82ba88da14450d8337cd115310e840 -#: ../src/Doc/whatsnew/2.7.rst:2624 +#: whatsnew/2.7.rst:2629 msgid "Documentation Changes" msgstr "" # 7bf58dda316c463db5efc35d9893ad11 -#: ../src/Doc/whatsnew/2.7.rst:2626 +#: whatsnew/2.7.rst:2631 msgid "" "As part of this change, the :ref:`installing-index` and :ref:`distributing-" "index` sections of the documentation have been completely redesigned as " @@ -17432,26 +17352,45 @@ msgid "" msgstr "" # 8362a5561e48482f982933080b66d967 -#: ../src/Doc/whatsnew/2.7.rst:2634 +#: whatsnew/2.7.rst:2639 msgid "" "However, as this migration is currently still incomplete, the legacy " "versions of those guides remaining available as :ref:`install-index` and :" "ref:`distutils-index`." msgstr "" -# 7953824aa55942fa8f4fb767bb2ad58c -#: ../src/Doc/whatsnew/2.7.rst:2640 -msgid ":pep:`453` -- Explicit bootstrapping of pip in Python installations" +#: whatsnew/2.7.rst:2646 +msgid "PEP 453 -- Explicit bootstrapping of pip in Python installations" msgstr "" # dbec30431d6246f29c40bbe2bb287065 -#: ../src/Doc/whatsnew/2.7.rst:2641 +#: whatsnew/2.7.rst:2646 msgid "" "PEP written by Donald Stufft and Nick Coghlan, implemented by Donald Stufft, " "Nick Coghlan, Martin von Löwis and Ned Deily." msgstr "" -#: ../src/Doc/whatsnew/2.7.rst:2652 +#: whatsnew/2.7.rst:2650 +msgid "" +"PEP 476: Enabling certificate verification by default for stdlib http clients" +msgstr "" + +#: whatsnew/2.7.rst:2652 +msgid "" +":mod:`httplib` and modules which use it, such as :mod:`urllib2` and :mod:" +"`xmlrpclib`, will now verify that the server presents a certificate which is " +"signed by a CA in the platform trust store and whose hostname matches the " +"hostname being requested by default, significantly improving security for " +"many applications." +msgstr "" + +#: whatsnew/2.7.rst:2658 +msgid "" +"For applications which require the old previous behavior, they can pass an " +"alternate context::" +msgstr "" + +#: whatsnew/2.7.rst:2680 msgid "" "The author would like to thank the following people for offering " "suggestions, corrections and assistance with various drafts of this article: " @@ -17459,11 +17398,11 @@ msgid "" "Walker." msgstr "" -#: ../src/Doc/whatsnew/index.rst:5 +#: whatsnew/index.rst:5 msgid "What's New in Python" msgstr "Quoi de neuf dans Python" -#: ../src/Doc/whatsnew/index.rst:7 +#: whatsnew/index.rst:7 msgid "" "The \"What's New in Python\" series of essays takes tours through the most " "important changes between major Python versions. They are a \"must read\" "