From d19e206cc83570d9f6490b5b7477c1ecf26cf0ed Mon Sep 17 00:00:00 2001
From: claudia <cmncri@ibmb.csic.es>
Date: Tue, 5 May 2020 22:37:47 +0200
Subject: [PATCH 01/11] started translation of library/functions.po
---
library/functions.po | 147 +++++++++++++++++++++++++++----------------
1 file changed, 92 insertions(+), 55 deletions(-)
diff --git a/library/functions.po b/library/functions.po
index 1db875a50c..f73cedfc25 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -1,219 +1,224 @@
# Copyright (C) 2001-2020, Python Software Foundation
# This file is distributed under the same license as the Python package.
-# Maintained by the python-doc-es workteam.
+# Maintained by the python-doc-es workteam.
# docs-es@python.org / https://mail.python.org/mailman3/lists/docs-es.python.org/
# Check https://github.com/PyCampES/python-docs-es/blob/3.7/TRANSLATORS to get the list of volunteers
#
-#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-05-06 11:59-0400\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es.python.org)\n"
+"PO-Revision-Date: 2020-05-05 22:35+0200\n"
+"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
+"python.org)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+"Last-Translator: \n"
+"Language: es\n"
+"X-Generator: Poedit 2.3\n"
#: ../Doc/library/functions.rst:5 ../Doc/library/functions.rst:11
msgid "Built-in Functions"
-msgstr ""
+msgstr "Funciones Built-in"
#: ../Doc/library/functions.rst:7
msgid ""
"The Python interpreter has a number of functions and types built into it "
"that are always available. They are listed here in alphabetical order."
msgstr ""
+"El intérprete de Python tiene una serie de funciones y tipos incluidos en él "
+"que están siempre disponibles. Están listados aquí en orden alfabético. "
#: ../Doc/library/functions.rst:13
msgid ":func:`abs`"
-msgstr ""
+msgstr ":func:`abs`"
#: ../Doc/library/functions.rst:13
msgid ":func:`delattr`"
-msgstr ""
+msgstr ":func:`delattr`"
#: ../Doc/library/functions.rst:13
msgid ":func:`hash`"
-msgstr ""
+msgstr ":func:`hash`"
#: ../Doc/library/functions.rst:13
msgid "|func-memoryview|_"
-msgstr ""
+msgstr "|func-memoryview|_"
#: ../Doc/library/functions.rst:13
msgid "|func-set|_"
-msgstr ""
+msgstr "|func-set|_"
#: ../Doc/library/functions.rst:14
msgid ":func:`all`"
-msgstr ""
+msgstr ":func:`all`"
#: ../Doc/library/functions.rst:14
msgid "|func-dict|_"
-msgstr ""
+msgstr "|func-dict|_"
#: ../Doc/library/functions.rst:14
msgid ":func:`help`"
-msgstr ""
+msgstr ":func:`help`"
#: ../Doc/library/functions.rst:14
msgid ":func:`min`"
-msgstr ""
+msgstr ":func:`min`"
#: ../Doc/library/functions.rst:14
msgid ":func:`setattr`"
-msgstr ""
+msgstr ":func:`setattr`"
#: ../Doc/library/functions.rst:15
msgid ":func:`any`"
-msgstr ""
+msgstr ":func:`any`"
#: ../Doc/library/functions.rst:15
msgid ":func:`dir`"
-msgstr ""
+msgstr ":func:`any`"
#: ../Doc/library/functions.rst:15
msgid ":func:`hex`"
-msgstr ""
+msgstr ":func:`hex`"
#: ../Doc/library/functions.rst:15
msgid ":func:`next`"
-msgstr ""
+msgstr ":func:`next`"
#: ../Doc/library/functions.rst:15
msgid ":func:`slice`"
-msgstr ""
+msgstr ":func:`slice`"
#: ../Doc/library/functions.rst:16
msgid ":func:`ascii`"
-msgstr ""
+msgstr ":func:`ascii`"
#: ../Doc/library/functions.rst:16
msgid ":func:`divmod`"
-msgstr ""
+msgstr ":func:`divmod`"
#: ../Doc/library/functions.rst:16
msgid ":func:`id`"
-msgstr ""
+msgstr ":func:`id`"
#: ../Doc/library/functions.rst:16
msgid ":func:`object`"
-msgstr ""
+msgstr ":func:`object`"
#: ../Doc/library/functions.rst:16
msgid ":func:`sorted`"
-msgstr ""
+msgstr ":func:`sorted`"
#: ../Doc/library/functions.rst:17
msgid ":func:`bin`"
-msgstr ""
+msgstr ":func:`bin`"
#: ../Doc/library/functions.rst:17
msgid ":func:`enumerate`"
-msgstr ""
+msgstr ":func:`enumerate`"
#: ../Doc/library/functions.rst:17
msgid ":func:`input`"
-msgstr ""
+msgstr ":func:`input`"
#: ../Doc/library/functions.rst:17
msgid ":func:`oct`"
-msgstr ""
+msgstr ":func:`oct`"
#: ../Doc/library/functions.rst:17
msgid ":func:`staticmethod`"
-msgstr ""
+msgstr ":func:`staticmethod`"
#: ../Doc/library/functions.rst:18
msgid ":func:`bool`"
-msgstr ""
+msgstr ":func:`bool`"
#: ../Doc/library/functions.rst:18
msgid ":func:`eval`"
-msgstr ""
+msgstr ":func:`eval`"
#: ../Doc/library/functions.rst:18
msgid ":func:`int`"
-msgstr ""
+msgstr ":func:`int`"
#: ../Doc/library/functions.rst:18
msgid ":func:`open`"
-msgstr ""
+msgstr ":func:`open`"
#: ../Doc/library/functions.rst:18
msgid "|func-str|_"
-msgstr ""
+msgstr "|func-str|_"
#: ../Doc/library/functions.rst:19
msgid ":func:`breakpoint`"
-msgstr ""
+msgstr ":func:`breakpoint`"
#: ../Doc/library/functions.rst:19
msgid ":func:`exec`"
-msgstr ""
+msgstr ":func:`exec`"
#: ../Doc/library/functions.rst:19
msgid ":func:`isinstance`"
-msgstr ""
+msgstr ":func:`isinstance`"
#: ../Doc/library/functions.rst:19
msgid ":func:`ord`"
-msgstr ""
+msgstr ":func:`ord`"
#: ../Doc/library/functions.rst:19
msgid ":func:`sum`"
-msgstr ""
+msgstr ":func:`sum`"
#: ../Doc/library/functions.rst:20
msgid "|func-bytearray|_"
-msgstr ""
+msgstr "|func-bytearray|_"
#: ../Doc/library/functions.rst:20
msgid ":func:`filter`"
-msgstr ""
+msgstr ":func:`filter`"
#: ../Doc/library/functions.rst:20
msgid ":func:`issubclass`"
-msgstr ""
+msgstr ":func:`issubclass`"
#: ../Doc/library/functions.rst:20
msgid ":func:`pow`"
-msgstr ""
+msgstr ":func:`pow`"
#: ../Doc/library/functions.rst:20
msgid ":func:`super`"
-msgstr ""
+msgstr ":func:`super`"
#: ../Doc/library/functions.rst:21
msgid "|func-bytes|_"
-msgstr ""
+msgstr "|func-bytes|_"
#: ../Doc/library/functions.rst:21
msgid ":func:`float`"
-msgstr ""
+msgstr ":func:`float`"
#: ../Doc/library/functions.rst:21
msgid ":func:`iter`"
-msgstr ""
+msgstr ":func:`iter`"
#: ../Doc/library/functions.rst:21
msgid ":func:`print`"
-msgstr ""
+msgstr ":func:`print`"
#: ../Doc/library/functions.rst:21
msgid "|func-tuple|_"
-msgstr ""
+msgstr "|func-tuple|_"
#: ../Doc/library/functions.rst:22
msgid ":func:`callable`"
-msgstr ""
+msgstr ":func:`callable`"
#: ../Doc/library/functions.rst:22
msgid ":func:`format`"
-msgstr ""
+msgstr ":func:`format`"
#: ../Doc/library/functions.rst:22
msgid ":func:`len`"
@@ -309,18 +314,25 @@ msgid ""
"floating point number. If the argument is a complex number, its magnitude "
"is returned."
msgstr ""
+"Devuelve el valor absoluto de un número. El argumento puede ser un número "
+"entero o de punto flotante. Si el argumento es un número complejo, devuelve "
+"su magnitud."
#: ../Doc/library/functions.rst:52
msgid ""
"Return ``True`` if all elements of the *iterable* are true (or if the "
"iterable is empty). Equivalent to::"
msgstr ""
+"Devuelve ``True`` si todos los elementos del *iterable* son verdaderos (o "
+"si el iterable está vacío). Equivalente a::"
#: ../Doc/library/functions.rst:64
msgid ""
"Return ``True`` if any element of the *iterable* is true. If the iterable "
"is empty, return ``False``. Equivalent to::"
msgstr ""
+"Devuelve ``True`` si un elemento cualquiera del *iterable* es verdadero. Si "
+"el iteradle está vacío, devuelve ``False``. Equivalente a::"
#: ../Doc/library/functions.rst:76
msgid ""
@@ -329,6 +341,10 @@ msgid ""
"`repr` using ``\\x``, ``\\u`` or ``\\U`` escapes. This generates a string "
"similar to that returned by :func:`repr` in Python 2."
msgstr ""
+"Como :func:`repr`, devuelve una cadena que contiene una representación "
+"imprimible de un objeto, pero que escapa los caracteres no-ASCII que :func:"
+"`repr` devuelve usando ``\\x``, ``\\u`` or ``\\U``. Esto genera una cadena "
+"similar a la devuelta por :func:`repr` en Python 2."
#: ../Doc/library/functions.rst:84
msgid ""
@@ -337,16 +353,22 @@ msgid ""
"object, it has to define an :meth:`__index__` method that returns an "
"integer. Some examples:"
msgstr ""
+"Convierte un número entero a una cadena binaria con prefijo “0b”. El "
+"resultado es una expresión de Python válida. Si *x* no es un objeto de "
+"clase :class:`int` en Python, tiene que definir un método :meth:"
+"`__index__` que devuelva un entero. Algunos ejemplos:"
#: ../Doc/library/functions.rst:94
msgid ""
"If prefix \"0b\" is desired or not, you can use either of the following ways."
msgstr ""
+"Según se desee o no el prefijo “0b”, se puede usar uno u otro de las "
+"siguientes maneras:"
#: ../Doc/library/functions.rst:101 ../Doc/library/functions.rst:703
#: ../Doc/library/functions.rst:963
msgid "See also :func:`format` for more information."
-msgstr ""
+msgstr "Veáse también :func:`format` para más información."
#: ../Doc/library/functions.rst:106
msgid ""
@@ -357,11 +379,17 @@ msgid ""
"It cannot be subclassed further. Its only instances are ``False`` and "
"``True`` (see :ref:`bltin-boolean-values`)."
msgstr ""
+"Devuelve un booleano, es decir, o bien ``True`` o ``False``. *x* es "
+"convertido usando el estándar :ref:`truth testing procedure <truth>`. Si *x* "
+"es falso o omitido, devuelve ``False``; en caso contrario devuelve "
+"``True``. La clase :class:`bool` es una subclase de :class:`int` (véase :"
+"ref:`typesnumeric`). De ella no pueden derivarse más subclases. Sus únicas "
+"instancias son ``False`` y ``True`` (véase :ref:`bltin-boolean-values`)."
#: ../Doc/library/functions.rst:115 ../Doc/library/functions.rst:581
#: ../Doc/library/functions.rst:774
msgid "*x* is now a positional-only parameter."
-msgstr ""
+msgstr "*x* es ahora un argumento solo de posición."
#: ../Doc/library/functions.rst:120
msgid ""
@@ -374,6 +402,15 @@ msgid ""
"other function and :func:`breakpoint` will automatically call that, allowing "
"you to drop into the debugger of choice."
msgstr ""
+"Esta función te lleva al depurador en el sitio donde se produce la llamada. "
+"Específicamente, llama a :func:`sys.breakpointhook`, pasando ``args`` y "
+"``kws`` directamente. Por defecto, ``sys.breakpointhook()`` llama a :func:"
+"`pdb.set_trace()` sin esperar argumentos. En este caso, es puramente una "
+"función de conveniencia para evitar el importe explícito de :mod:`pdb` o "
+"tener que escribir tanto código para entrar al depurador. Sin embargo, :func:"
+"`sys.breakpointhook` puede ser configurado a otra función y :func:"
+"`breakpoint` llamará automáticamente a esta, permitiendo entrar al depurador "
+"elegido."
#: ../Doc/library/functions.rst:136
msgid ""
From f5ab8dcbcd829c76b8c8873172f946a68ba5d2a4 Mon Sep 17 00:00:00 2001
From: claudia <cmncri@ibmb.csic.es>
Date: Thu, 7 May 2020 10:04:22 +0200
Subject: [PATCH 02/11] a couple of changes only, checking if build is done
---
library/functions.po | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/library/functions.po b/library/functions.po
index f73cedfc25..61a6a7b7a6 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -9,7 +9,7 @@ msgstr ""
"Project-Id-Version: Python 3.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-05-06 11:59-0400\n"
-"PO-Revision-Date: 2020-05-05 22:35+0200\n"
+"PO-Revision-Date: 2020-05-07 10:04+0200\n"
"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
"python.org)\n"
"MIME-Version: 1.0\n"
@@ -690,7 +690,7 @@ 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 ""
+msgstr "Sin argumentos, devuelve la lista de nombres en el ámbito local."
#: ../Doc/library/functions.rst:343
msgid ""
From d81d20e09868999efe28c01ba898e6ed011217ce Mon Sep 17 00:00:00 2001
From: claudia <cmncri@ibmb.csic.es>
Date: Thu, 7 May 2020 10:23:47 +0200
Subject: [PATCH 03/11] last commit in 3.7 for functions.po
---
library/functions.po | 20 ++++++++++++++++----
1 file changed, 16 insertions(+), 4 deletions(-)
diff --git a/library/functions.po b/library/functions.po
index 61a6a7b7a6..4c3e1d9a50 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -9,7 +9,7 @@ msgstr ""
"Project-Id-Version: Python 3.7\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2019-05-06 11:59-0400\n"
-"PO-Revision-Date: 2020-05-07 10:04+0200\n"
+"PO-Revision-Date: 2020-05-07 10:23+0200\n"
"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
"python.org)\n"
"MIME-Version: 1.0\n"
@@ -30,7 +30,7 @@ msgid ""
"that are always available. They are listed here in alphabetical order."
msgstr ""
"El intérprete de Python tiene una serie de funciones y tipos incluidos en él "
-"que están siempre disponibles. Están listados aquí en orden alfabético. "
+"que están siempre disponibles. Están listados aquí en orden alfabético."
#: ../Doc/library/functions.rst:13
msgid ":func:`abs`"
@@ -363,7 +363,7 @@ msgid ""
"If prefix \"0b\" is desired or not, you can use either of the following ways."
msgstr ""
"Según se desee o no el prefijo “0b”, se puede usar uno u otro de las "
-"siguientes maneras:"
+"siguientes maneras."
#: ../Doc/library/functions.rst:101 ../Doc/library/functions.rst:703
#: ../Doc/library/functions.rst:963
@@ -690,7 +690,9 @@ 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 "Sin argumentos, devuelve la lista de nombres en el ámbito local."
+msgstr ""
+"Sin argumentos, devuelve la lista de nombres en el ámbito local. Con un "
+"argumento, intenta devolver una lista de atributos válidos para ese objeto."
#: ../Doc/library/functions.rst:343
msgid ""
@@ -699,6 +701,11 @@ msgid ""
"custom :func:`__getattr__` or :func:`__getattribute__` function to customize "
"the way :func:`dir` reports their attributes."
msgstr ""
+"Si el objeto tiene un método llamado :meth:`__dir__`, éste será llamado y "
+"debe devolver la lista de atributos. Esto permite que los objetos que "
+"implementan una función personalizada :func:`__getattr__` o :func:"
+"`__getattribute__` puedan decidir la manera en la que :func:`dir` reporta "
+"sus atributos."
#: ../Doc/library/functions.rst:348
msgid ""
@@ -708,6 +715,11 @@ msgid ""
"complete, and may be inaccurate when the object has a custom :func:"
"`__getattr__`."
msgstr ""
+"Si el objeto no provee de un método :meth:`__dir__`, la función intenta "
+"obtener la información del atributo :attr:`~object.__dict__` del objeto, si "
+"está definido, y de su objeto type. La lista resultante no está "
+"necesariamente completa, y puede ser inexacta cuando el objeto tiene una "
+"función :func:`__getattr__` implementada."
#: ../Doc/library/functions.rst:353
msgid ""
From 93845a0cd0494c1d04a36e6ec1d531a8bd16c03a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Claudia=20Mill=C3=A1n?= <cmncri@ibmb.csic.es>
Date: Thu, 7 May 2020 14:22:21 +0200
Subject: [PATCH 04/11] Update library/functions.po
added escape to the normal comillas
Co-authored-by: Manuel Kaufmann <humitos@gmail.com>
---
library/functions.po | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/library/functions.po b/library/functions.po
index 4c3e1d9a50..e7fc050204 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -353,7 +353,7 @@ msgid ""
"object, it has to define an :meth:`__index__` method that returns an "
"integer. Some examples:"
msgstr ""
-"Convierte un número entero a una cadena binaria con prefijo “0b”. El "
+"Convierte un número entero a una cadena binaria con prefijo \"0b\". El "
"resultado es una expresión de Python válida. Si *x* no es un objeto de "
"clase :class:`int` en Python, tiene que definir un método :meth:"
"`__index__` que devuelva un entero. Algunos ejemplos:"
From 9dcaf5488baa27d18a0729eee8560535deaea561 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Claudia=20Mill=C3=A1n?= <cmncri@ibmb.csic.es>
Date: Thu, 7 May 2020 14:23:16 +0200
Subject: [PATCH 05/11] Update library/functions.po
idem comillas correctamente escapadas ahora
Co-authored-by: Manuel Kaufmann <humitos@gmail.com>
---
library/functions.po | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/library/functions.po b/library/functions.po
index e7fc050204..dc7683eeb1 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -362,7 +362,7 @@ msgstr ""
msgid ""
"If prefix \"0b\" is desired or not, you can use either of the following ways."
msgstr ""
-"Según se desee o no el prefijo “0b”, se puede usar uno u otro de las "
+"Según se desee o no el prefijo \"0b\", se puede usar uno u otro de las "
"siguientes maneras."
#: ../Doc/library/functions.rst:101 ../Doc/library/functions.rst:703
From 6fb62d10b0f28be25d850ccd277173b6588258d5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Claudia=20Mill=C3=A1n?= <cmncri@ibmb.csic.es>
Date: Thu, 7 May 2020 14:24:11 +0200
Subject: [PATCH 06/11] Update library/functions.po
Co-authored-by: Manuel Kaufmann <humitos@gmail.com>
---
library/functions.po | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/library/functions.po b/library/functions.po
index dc7683eeb1..32d1047298 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -381,7 +381,7 @@ msgid ""
msgstr ""
"Devuelve un booleano, es decir, o bien ``True`` o ``False``. *x* es "
"convertido usando el estándar :ref:`truth testing procedure <truth>`. Si *x* "
-"es falso o omitido, devuelve ``False``; en caso contrario devuelve "
+"es falso u omitido, devuelve ``False``; en caso contrario devuelve "
"``True``. La clase :class:`bool` es una subclase de :class:`int` (véase :"
"ref:`typesnumeric`). De ella no pueden derivarse más subclases. Sus únicas "
"instancias son ``False`` y ``True`` (véase :ref:`bltin-boolean-values`)."
From b136ac19fb55291887847ebbce0af37044326db7 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Claudia=20Mill=C3=A1n?= <cmncri@ibmb.csic.es>
Date: Thu, 7 May 2020 14:24:31 +0200
Subject: [PATCH 07/11] Update library/functions.po
Co-authored-by: Manuel Kaufmann <humitos@gmail.com>
---
library/functions.po | 1 -
1 file changed, 1 deletion(-)
diff --git a/library/functions.po b/library/functions.po
index 32d1047298..db0ac51fd2 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -11,7 +11,6 @@ msgstr ""
"POT-Creation-Date: 2019-05-06 11:59-0400\n"
"PO-Revision-Date: 2020-05-07 10:23+0200\n"
"Language-Team: python-doc-es (https://mail.python.org/mailman3/lists/docs-es."
-"python.org)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
From f5e2888ee20d5d5a017bc423fe434854d032f089 Mon Sep 17 00:00:00 2001
From: Manuel Kaufmann <humitos@gmail.com>
Date: Thu, 7 May 2020 14:46:20 +0200
Subject: [PATCH 08/11] Update functions.po from 3.7
---
library/functions.po | 2410 ++++++++++++++++++++++++------------------
1 file changed, 1401 insertions(+), 1009 deletions(-)
diff --git a/library/functions.po b/library/functions.po
index 9db503676e..51a6601c20 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -10,18 +10,19 @@ msgid ""
msgstr ""
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2019-05-06 11:59-0400\n"
+"POT-Creation-Date: 2020-05-07 14:37+0200\n"
"PO-Revision-Date: 2020-05-07 10:23+0200\n"
-"Language-Team: python-doc-es"
-"MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"Last-Translator: \n"
"Language: es\n"
-"X-Generator: Poedit 2.3\n"
+"Language-Team: python-doc-esMIME-Version: 1.0\n"
+"Plural-Forms: nplurals=2; plural=(n != 1)\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=utf-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Generated-By: Babel 2.8.0\n"
-#: ../Doc/library/functions.rst:5 ../Doc/library/functions.rst:11
+#: ../Doc/library/functions.rst:5
+#: ../Doc/library/functions.rst:11
msgid "Built-in Functions"
msgstr "Funciones Built-in"
@@ -30,8 +31,9 @@ msgid ""
"The Python interpreter has a number of functions and types built into it "
"that are always available. They are listed here in alphabetical order."
msgstr ""
-"El intérprete de Python tiene una serie de funciones y tipos incluidos en él "
-"que están siempre disponibles. Están listados aquí en orden alfabético."
+"El intérprete de Python tiene una serie de funciones y tipos incluidos en"
+" él que están siempre disponibles. Están listados aquí en orden "
+"alfabético."
#: ../Doc/library/functions.rst:13
msgid ":func:`abs`"
@@ -310,44 +312,46 @@ msgid ":func:`round`"
msgstr ""
#: ../Doc/library/functions.rst:45
+#, fuzzy
msgid ""
-"Return the absolute value of a number. The argument may be an integer or a "
-"floating point number. If the argument is a complex number, its magnitude "
-"is returned."
+"Return the absolute value of a number. The argument may be an integer or"
+" a floating point number. If the argument is a complex number, its "
+"magnitude is returned. If *x* defines :meth:`__abs__`, ``abs(x)`` returns"
+" ``x.__abs__()``."
msgstr ""
-"Devuelve el valor absoluto de un número. El argumento puede ser un número "
-"entero o de punto flotante. Si el argumento es un número complejo, devuelve "
-"su magnitud."
+"Devuelve el valor absoluto de un número. El argumento puede ser un número"
+" entero o de punto flotante. Si el argumento es un número complejo, "
+"devuelve su magnitud."
-#: ../Doc/library/functions.rst:52
+#: ../Doc/library/functions.rst:53
msgid ""
"Return ``True`` if all elements of the *iterable* are true (or if the "
"iterable is empty). Equivalent to::"
msgstr ""
-"Devuelve ``True`` si todos los elementos del *iterable* son verdaderos (o "
-"si el iterable está vacío). Equivalente a::"
+"Devuelve ``True`` si todos los elementos del *iterable* son verdaderos "
+"(o si el iterable está vacío). Equivalente a::"
-#: ../Doc/library/functions.rst:64
+#: ../Doc/library/functions.rst:65
msgid ""
-"Return ``True`` if any element of the *iterable* is true. If the iterable "
-"is empty, return ``False``. Equivalent to::"
+"Return ``True`` if any element of the *iterable* is true. If the "
+"iterable is empty, return ``False``. Equivalent to::"
msgstr ""
-"Devuelve ``True`` si un elemento cualquiera del *iterable* es verdadero. Si "
-"el iteradle está vacío, devuelve ``False``. Equivalente a::"
+"Devuelve ``True`` si un elemento cualquiera del *iterable* es verdadero."
+" Si el iteradle está vacío, devuelve ``False``. Equivalente a::"
-#: ../Doc/library/functions.rst:76
+#: ../Doc/library/functions.rst:77
msgid ""
-"As :func:`repr`, return a string containing a printable representation of an "
-"object, but escape the non-ASCII characters in the string returned by :func:"
-"`repr` using ``\\x``, ``\\u`` or ``\\U`` escapes. This generates a string "
-"similar to that returned by :func:`repr` in Python 2."
+"As :func:`repr`, return a string containing a printable representation of"
+" an object, but escape the non-ASCII characters in the string returned by"
+" :func:`repr` using ``\\x``, ``\\u`` or ``\\U`` escapes. This generates "
+"a string similar to that returned by :func:`repr` in Python 2."
msgstr ""
"Como :func:`repr`, devuelve una cadena que contiene una representación "
-"imprimible de un objeto, pero que escapa los caracteres no-ASCII que :func:"
-"`repr` devuelve usando ``\\x``, ``\\u`` or ``\\U``. Esto genera una cadena "
-"similar a la devuelta por :func:`repr` en Python 2."
+"imprimible de un objeto, pero que escapa los caracteres no-ASCII que "
+":func:`repr` devuelve usando ``\\x``, ``\\u`` or ``\\U``. Esto genera "
+"una cadena similar a la devuelta por :func:`repr` en Python 2."
-#: ../Doc/library/functions.rst:84
+#: ../Doc/library/functions.rst:85
msgid ""
"Convert an integer number to a binary string prefixed with \"0b\". The "
"result is a valid Python expression. If *x* is not a Python :class:`int` "
@@ -356,964 +360,1102 @@ msgid ""
msgstr ""
"Convierte un número entero a una cadena binaria con prefijo \"0b\". El "
"resultado es una expresión de Python válida. Si *x* no es un objeto de "
-"clase :class:`int` en Python, tiene que definir un método :meth:"
-"`__index__` que devuelva un entero. Algunos ejemplos:"
+"clase :class:`int` en Python, tiene que definir un método "
+":meth:`__index__` que devuelva un entero. Algunos ejemplos:"
-#: ../Doc/library/functions.rst:94
+#: ../Doc/library/functions.rst:95
msgid ""
-"If prefix \"0b\" is desired or not, you can use either of the following ways."
+"If prefix \"0b\" is desired or not, you can use either of the following "
+"ways."
msgstr ""
"Según se desee o no el prefijo \"0b\", se puede usar uno u otro de las "
"siguientes maneras."
-#: ../Doc/library/functions.rst:101 ../Doc/library/functions.rst:703
-#: ../Doc/library/functions.rst:963
+#: ../Doc/library/functions.rst:102
+#: ../Doc/library/functions.rst:750
+#: ../Doc/library/functions.rst:1030
msgid "See also :func:`format` for more information."
msgstr "Veáse también :func:`format` para más información."
-#: ../Doc/library/functions.rst:106
+#: ../Doc/library/functions.rst:107
msgid ""
-"Return a Boolean value, i.e. one of ``True`` or ``False``. *x* is converted "
-"using the standard :ref:`truth testing procedure <truth>`. If *x* is false "
-"or omitted, this returns ``False``; otherwise it returns ``True``. The :"
-"class:`bool` class is a subclass of :class:`int` (see :ref:`typesnumeric`). "
-"It cannot be subclassed further. Its only instances are ``False`` and "
-"``True`` (see :ref:`bltin-boolean-values`)."
+"Return a Boolean value, i.e. one of ``True`` or ``False``. *x* is "
+"converted using the standard :ref:`truth testing procedure <truth>`. If "
+"*x* is false or omitted, this returns ``False``; otherwise it returns "
+"``True``. The :class:`bool` class is a subclass of :class:`int` (see "
+":ref:`typesnumeric`). It cannot be subclassed further. Its only "
+"instances are ``False`` and ``True`` (see :ref:`bltin-boolean-values`)."
msgstr ""
"Devuelve un booleano, es decir, o bien ``True`` o ``False``. *x* es "
-"convertido usando el estándar :ref:`truth testing procedure <truth>`. Si *x* "
-"es falso u omitido, devuelve ``False``; en caso contrario devuelve "
-"``True``. La clase :class:`bool` es una subclase de :class:`int` (véase :"
-"ref:`typesnumeric`). De ella no pueden derivarse más subclases. Sus únicas "
-"instancias son ``False`` y ``True`` (véase :ref:`bltin-boolean-values`)."
-
-#: ../Doc/library/functions.rst:115 ../Doc/library/functions.rst:581
-#: ../Doc/library/functions.rst:774
+"convertido usando el estándar :ref:`truth testing procedure <truth>`. Si "
+"*x* es falso u omitido, devuelve ``False``; en caso contrario devuelve "
+"``True``. La clase :class:`bool` es una subclase de :class:`int` (véase"
+" :ref:`typesnumeric`). De ella no pueden derivarse más subclases. Sus "
+"únicas instancias son ``False`` y ``True`` (véase :ref:`bltin-boolean-"
+"values`)."
+
+#: ../Doc/library/functions.rst:116
+#: ../Doc/library/functions.rst:625
+#: ../Doc/library/functions.rst:832
msgid "*x* is now a positional-only parameter."
msgstr "*x* es ahora un argumento solo de posición."
-#: ../Doc/library/functions.rst:120
-msgid ""
-"This function drops you into the debugger at the call site. Specifically, "
-"it calls :func:`sys.breakpointhook`, passing ``args`` and ``kws`` straight "
-"through. By default, ``sys.breakpointhook()`` calls :func:`pdb.set_trace()` "
-"expecting no arguments. In this case, it is purely a convenience function "
-"so you don't have to explicitly import :mod:`pdb` or type as much code to "
-"enter the debugger. However, :func:`sys.breakpointhook` can be set to some "
-"other function and :func:`breakpoint` will automatically call that, allowing "
-"you to drop into the debugger of choice."
-msgstr ""
-"Esta función te lleva al depurador en el sitio donde se produce la llamada. "
-"Específicamente, llama a :func:`sys.breakpointhook`, pasando ``args`` y "
-"``kws`` directamente. Por defecto, ``sys.breakpointhook()`` llama a :func:"
-"`pdb.set_trace()` sin esperar argumentos. En este caso, es puramente una "
-"función de conveniencia para evitar el importe explícito de :mod:`pdb` o "
-"tener que escribir tanto código para entrar al depurador. Sin embargo, :func:"
-"`sys.breakpointhook` puede ser configurado a otra función y :func:"
-"`breakpoint` llamará automáticamente a esta, permitiendo entrar al depurador "
-"elegido."
-
-#: ../Doc/library/functions.rst:136
+#: ../Doc/library/functions.rst:121
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 "
-"methods of mutable sequences, described in :ref:`typesseq-mutable`, as well "
-"as most methods that the :class:`bytes` type has, see :ref:`bytes-methods`."
+"This function drops you into the debugger at the call site. "
+"Specifically, it calls :func:`sys.breakpointhook`, passing ``args`` and "
+"``kws`` straight through. By default, ``sys.breakpointhook()`` calls "
+":func:`pdb.set_trace()` expecting no arguments. In this case, it is "
+"purely a convenience function so you don't have to explicitly import "
+":mod:`pdb` or type as much code to enter the debugger. However, "
+":func:`sys.breakpointhook` can be set to some other function and "
+":func:`breakpoint` will automatically call that, allowing you to drop "
+"into the debugger of choice."
msgstr ""
+"Esta función te lleva al depurador en el sitio donde se produce la "
+"llamada. Específicamente, llama a :func:`sys.breakpointhook`, pasando "
+"``args`` y ``kws`` directamente. Por defecto, ``sys.breakpointhook()`` "
+"llama a :func:`pdb.set_trace()` sin esperar argumentos. En este caso, es"
+" puramente una función de conveniencia para evitar el importe explícito "
+"de :mod:`pdb` o tener que escribir tanto código para entrar al depurador."
+" Sin embargo, :func:`sys.breakpointhook` puede ser configurado a otra "
+"función y :func:`breakpoint` llamará automáticamente a esta, permitiendo "
+"entrar al depurador elegido."
-#: ../Doc/library/functions.rst:141
+#: ../Doc/library/functions.rst:132
msgid ""
-"The optional *source* parameter can be used to initialize the array in a few "
-"different ways:"
+"Raises an :ref:`auditing event <auditing>` ``builtins.breakpoint`` with "
+"argument ``breakpointhook``."
+msgstr ""
+
+#: ../Doc/library/functions.rst:139
+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"
+" methods of mutable sequences, described in :ref:`typesseq-mutable`, as "
+"well as most methods that the :class:`bytes` type has, see :ref:`bytes-"
+"methods`."
msgstr ""
#: ../Doc/library/functions.rst:144
msgid ""
-"If it is a *string*, you must also give the *encoding* (and optionally, "
-"*errors*) parameters; :func:`bytearray` then converts the string to bytes "
-"using :meth:`str.encode`."
+"The optional *source* parameter can be used to initialize the array in a "
+"few different ways:"
msgstr ""
-#: ../Doc/library/functions.rst:148
+#: ../Doc/library/functions.rst:147
msgid ""
-"If it is an *integer*, the array will have that size and will be initialized "
-"with null bytes."
+"If it is a *string*, you must also give the *encoding* (and optionally, "
+"*errors*) parameters; :func:`bytearray` then converts the string to bytes"
+" using :meth:`str.encode`."
msgstr ""
#: ../Doc/library/functions.rst:151
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."
+"If it is an *integer*, the array will have that size and will be "
+"initialized with null bytes."
msgstr ""
#: ../Doc/library/functions.rst:154
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."
+"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 ""
#: ../Doc/library/functions.rst:157
+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 ""
+
+#: ../Doc/library/functions.rst:160
msgid "Without an argument, an array of size 0 is created."
msgstr ""
-#: ../Doc/library/functions.rst:159
+#: ../Doc/library/functions.rst:162
msgid "See also :ref:`binaryseq` and :ref:`typebytearray`."
msgstr ""
-#: ../Doc/library/functions.rst:166
+#: ../Doc/library/functions.rst:169
msgid ""
-"Return a new \"bytes\" object, which is an immutable sequence of integers in "
-"the range ``0 <= x < 256``. :class:`bytes` is an immutable version of :"
-"class:`bytearray` -- it has the same non-mutating methods and the same "
-"indexing and slicing behavior."
+"Return a new \"bytes\" object, which is an immutable sequence of integers"
+" in the range ``0 <= x < 256``. :class:`bytes` is an immutable version "
+"of :class:`bytearray` -- it has the same non-mutating methods and the "
+"same indexing and slicing behavior."
msgstr ""
-#: ../Doc/library/functions.rst:171
+#: ../Doc/library/functions.rst:174
msgid ""
-"Accordingly, constructor arguments are interpreted as for :func:`bytearray`."
+"Accordingly, constructor arguments are interpreted as for "
+":func:`bytearray`."
msgstr ""
-#: ../Doc/library/functions.rst:173
+#: ../Doc/library/functions.rst:176
msgid "Bytes objects can also be created with literals, see :ref:`strings`."
msgstr ""
-#: ../Doc/library/functions.rst:175
+#: ../Doc/library/functions.rst:178
msgid "See also :ref:`binaryseq`, :ref:`typebytes`, and :ref:`bytes-methods`."
msgstr ""
-#: ../Doc/library/functions.rst:180
+#: ../Doc/library/functions.rst:183
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 "
-"fails, but if it is false, calling *object* will never succeed. Note that "
-"classes are callable (calling a class returns a new instance); instances are "
-"callable if their class has a :meth:`__call__` method."
+"Return :const:`True` if the *object* argument appears callable, "
+":const:`False` if not. If this returns ``True``, it is still possible "
+"that a call fails, but if it is ``False``, calling *object* will never "
+"succeed. Note that classes are callable (calling a class returns a new "
+"instance); instances are callable if their class has a :meth:`__call__` "
+"method."
msgstr ""
-#: ../Doc/library/functions.rst:186
+#: ../Doc/library/functions.rst:189
msgid ""
"This function was first removed in Python 3.0 and then brought back in "
"Python 3.2."
msgstr ""
-#: ../Doc/library/functions.rst:193
+#: ../Doc/library/functions.rst:196
msgid ""
-"Return the string representing a character whose Unicode code point is the "
-"integer *i*. For example, ``chr(97)`` returns the string ``'a'``, while "
-"``chr(8364)`` returns the string ``'€'``. This is the inverse of :func:`ord`."
+"Return the string representing a character whose Unicode code point is "
+"the integer *i*. For example, ``chr(97)`` returns the string ``'a'``, "
+"while ``chr(8364)`` returns the string ``'€'``. This is the inverse of "
+":func:`ord`."
msgstr ""
-#: ../Doc/library/functions.rst:197
+#: ../Doc/library/functions.rst:200
msgid ""
-"The valid range for the argument is from 0 through 1,114,111 (0x10FFFF in "
-"base 16). :exc:`ValueError` will be raised if *i* is outside that range."
+"The valid range for the argument is from 0 through 1,114,111 (0x10FFFF in"
+" base 16). :exc:`ValueError` will be raised if *i* is outside that "
+"range."
msgstr ""
-#: ../Doc/library/functions.rst:203
+#: ../Doc/library/functions.rst:206
msgid "Transform a method into a class method."
msgstr ""
-#: ../Doc/library/functions.rst:205
+#: ../Doc/library/functions.rst:208
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::"
+"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 ""
-#: ../Doc/library/functions.rst:213
+#: ../Doc/library/functions.rst:216
msgid ""
-"The ``@classmethod`` form is a function :term:`decorator` -- see :ref:"
-"`function` for details."
+"The ``@classmethod`` form is a function :term:`decorator` -- see "
+":ref:`function` for details."
msgstr ""
-#: ../Doc/library/functions.rst:216
+#: ../Doc/library/functions.rst:219
msgid ""
-"A class method 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 class method is called for a derived class, the derived class "
-"object is passed as the implied first argument."
+"A class method 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 class method is called for a derived class, the derived "
+"class object is passed as the implied first argument."
msgstr ""
-#: ../Doc/library/functions.rst:221
+#: ../Doc/library/functions.rst:224
msgid ""
"Class methods are different than C++ or Java static methods. If you want "
"those, see :func:`staticmethod`."
msgstr ""
-#: ../Doc/library/functions.rst:224
+#: ../Doc/library/functions.rst:227
msgid "For more information on class methods, see :ref:`types`."
msgstr ""
-#: ../Doc/library/functions.rst:229
+#: ../Doc/library/functions.rst:232
msgid ""
"Compile the *source* into a code or AST object. Code objects can be "
-"executed by :func:`exec` or :func:`eval`. *source* can either be a normal "
-"string, a byte string, or an AST object. Refer to the :mod:`ast` module "
-"documentation for information on how to work with AST objects."
+"executed by :func:`exec` or :func:`eval`. *source* can either be a "
+"normal string, a byte string, or an AST object. Refer to the :mod:`ast` "
+"module documentation for information on how to work with AST objects."
msgstr ""
-#: ../Doc/library/functions.rst:234
+#: ../Doc/library/functions.rst:237
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 (``'<string>'`` "
-"is commonly used)."
+"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 "
+"(``'<string>'`` is commonly used)."
msgstr ""
-#: ../Doc/library/functions.rst:238
+#: ../Doc/library/functions.rst:241
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 "
-"it consists of a single expression, or ``'single'`` if it consists of a "
-"single interactive statement (in the latter case, expression statements that "
-"evaluate to something other than ``None`` will be printed)."
+"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 it consists of a single expression, or ``'single'`` if it "
+"consists of a single interactive statement (in the latter case, "
+"expression statements that evaluate to something other than ``None`` will"
+" be printed)."
msgstr ""
-#: ../Doc/library/functions.rst:244
+#: ../Doc/library/functions.rst:247
msgid ""
-"The optional arguments *flags* and *dont_inherit* control which :ref:`future "
-"statements <future>` affect the compilation of *source*. If neither is "
-"present (or both are zero) the code is compiled with those future statements "
-"that are in effect in the code that is calling :func:`compile`. If the "
-"*flags* argument is given and *dont_inherit* is not (or is zero) then the "
-"future statements specified by the *flags* argument are used in addition to "
-"those that would be used anyway. If *dont_inherit* is a non-zero integer "
-"then the *flags* argument is it -- the future statements in effect around "
-"the call to compile are ignored."
+"The optional arguments *flags* and *dont_inherit* control which "
+":ref:`future statements <future>` affect the compilation of *source*. If"
+" neither is present (or both are zero) the code is compiled with those "
+"future statements that are in effect in the code that is calling "
+":func:`compile`. If the *flags* argument is given and *dont_inherit* is "
+"not (or is zero) then the future statements specified by the *flags* "
+"argument are used in addition to those that would be used anyway. If "
+"*dont_inherit* is a non-zero integer then the *flags* argument is it -- "
+"the future statements in effect around the call to compile are ignored."
msgstr ""
-#: ../Doc/library/functions.rst:254
+#: ../Doc/library/functions.rst:257
msgid ""
-"Future statements are specified by bits which can be bitwise ORed together "
-"to specify multiple statements. The bitfield required to specify a given "
-"feature can be found as the :attr:`~__future__._Feature.compiler_flag` "
-"attribute on the :class:`~__future__._Feature` instance in the :mod:"
-"`__future__` module."
+"Future statements are specified by bits which can be bitwise ORed "
+"together to specify multiple statements. The bitfield required to "
+"specify a given feature can be found as the "
+":attr:`~__future__._Feature.compiler_flag` attribute on the "
+":class:`~__future__._Feature` instance in the :mod:`__future__` module."
msgstr ""
-#: ../Doc/library/functions.rst:259
+#: ../Doc/library/functions.rst:262
msgid ""
-"The argument *optimize* specifies the optimization level of the compiler; "
-"the default value of ``-1`` selects the optimization level of the "
-"interpreter as given by :option:`-O` options. Explicit levels are ``0`` (no "
-"optimization; ``__debug__`` is true), ``1`` (asserts are removed, "
-"``__debug__`` is false) or ``2`` (docstrings are removed too)."
+"The optional argument *flags* also controls whether the compiled source "
+"is allowed to contain top-level ``await``, ``async for`` and ``async "
+"with``. When the bit ``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` is set, the "
+"return code object has ``CO_COROUTINE`` set in ``co_code``, and can be "
+"interactively executed via ``await eval(code_object)``."
msgstr ""
-#: ../Doc/library/functions.rst:265
+#: ../Doc/library/functions.rst:268
msgid ""
-"This function raises :exc:`SyntaxError` if the compiled source is invalid, "
-"and :exc:`ValueError` if the source contains null bytes."
+"The argument *optimize* specifies the optimization level of the compiler;"
+" the default value of ``-1`` selects the optimization level of the "
+"interpreter as given by :option:`-O` options. Explicit levels are ``0`` "
+"(no optimization; ``__debug__`` is true), ``1`` (asserts are removed, "
+"``__debug__`` is false) or ``2`` (docstrings are removed too)."
msgstr ""
-#: ../Doc/library/functions.rst:268
+#: ../Doc/library/functions.rst:274
msgid ""
-"If you want to parse Python code into its AST representation, see :func:`ast."
-"parse`."
+"This function raises :exc:`SyntaxError` if the compiled source is "
+"invalid, and :exc:`ValueError` if the source contains null bytes."
msgstr ""
-#: ../Doc/library/functions.rst:273
+#: ../Doc/library/functions.rst:277
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 "
-"to facilitate detection of incomplete and complete statements in the :mod:"
-"`code` module."
+"If you want to parse Python code into its AST representation, see "
+":func:`ast.parse`."
msgstr ""
-#: ../Doc/library/functions.rst:280
msgid ""
-"It is possible to crash the Python interpreter with a sufficiently large/"
-"complex string when compiling to an AST object due to stack depth "
-"limitations in Python's AST compiler."
+"Raises an :ref:`auditing event <auditing>` ``compile`` with arguments "
+"``source``, ``filename``."
msgstr ""
-#: ../Doc/library/functions.rst:284
+#: ../Doc/library/functions.rst:282
msgid ""
-"Allowed use of Windows and Mac newlines. Also input in ``'exec'`` mode does "
-"not have to end in a newline anymore. Added the *optimize* parameter."
+"Raises an :ref:`auditing event <auditing>` ``compile`` with arguments "
+"``source`` and ``filename``. This event may also be raised by implicit "
+"compilation."
msgstr ""
#: ../Doc/library/functions.rst:288
msgid ""
-"Previously, :exc:`TypeError` was raised when null bytes were encountered in "
-"*source*."
+"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 to facilitate detection of incomplete and complete "
+"statements in the :mod:`code` module."
msgstr ""
#: ../Doc/library/functions.rst:295
msgid ""
+"It is possible to crash the Python interpreter with a sufficiently "
+"large/complex string when compiling to an AST object due to stack depth "
+"limitations in Python's AST compiler."
+msgstr ""
+
+#: ../Doc/library/functions.rst:299
+msgid ""
+"Allowed use of Windows and Mac newlines. Also input in ``'exec'`` mode "
+"does not have to end in a newline anymore. Added the *optimize* "
+"parameter."
+msgstr ""
+
+#: ../Doc/library/functions.rst:303
+msgid ""
+"Previously, :exc:`TypeError` was raised when null bytes were encountered "
+"in *source*."
+msgstr ""
+
+#: ../Doc/library/functions.rst:307
+msgid ""
+"``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` can now be passed in flags to enable "
+"support for top-level ``await``, ``async for``, and ``async with``."
+msgstr ""
+
+#: ../Doc/library/functions.rst:314
+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. "
-"Each argument may be any numeric type (including complex). If *imag* is "
-"omitted, it defaults to zero and the constructor serves as a numeric "
-"conversion like :class:`int` and :class:`float`. If both arguments are "
-"omitted, returns ``0j``."
+"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. Each argument may be any numeric type (including complex). If "
+"*imag* is omitted, it defaults to zero and the constructor serves as a "
+"numeric conversion like :class:`int` and :class:`float`. If both "
+"arguments are omitted, returns ``0j``."
msgstr ""
-#: ../Doc/library/functions.rst:306
+#: ../Doc/library/functions.rst:323
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`."
+"For a general Python object ``x``, ``complex(x)`` delegates to "
+"``x.__complex__()``. If ``__complex__()`` is not defined then it falls "
+"back to :meth:`__float__`. If ``__float__()`` is not defined then it "
+"falls back to :meth:`__index__`."
msgstr ""
-#: ../Doc/library/functions.rst:311
+#: ../Doc/library/functions.rst:330
+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 ""
+
+#: ../Doc/library/functions.rst:335
msgid "The complex type is described in :ref:`typesnumeric`."
msgstr ""
-#: ../Doc/library/functions.rst:313 ../Doc/library/functions.rst:578
-#: ../Doc/library/functions.rst:771
+#: ../Doc/library/functions.rst:337
+#: ../Doc/library/functions.rst:622
+#: ../Doc/library/functions.rst:829
msgid "Grouping digits with underscores as in code literals is allowed."
msgstr ""
-#: ../Doc/library/functions.rst:319
+#: ../Doc/library/functions.rst:340
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 "
-"function deletes the named attribute, provided the object allows it. For "
-"example, ``delattr(x, 'foobar')`` is equivalent to ``del x.foobar``."
+"Falls back to :meth:`__index__` if :meth:`__complex__` and "
+":meth:`__float__` are not defined."
msgstr ""
-#: ../Doc/library/functions.rst:331
+#: ../Doc/library/functions.rst:347
msgid ""
-"Create a new dictionary. The :class:`dict` object is the dictionary class. "
-"See :class:`dict` and :ref:`typesmapping` for documentation about this class."
+"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 function deletes the named attribute, provided the object allows "
+"it. For example, ``delattr(x, 'foobar')`` is equivalent to ``del "
+"x.foobar``."
msgstr ""
-#: ../Doc/library/functions.rst:334
+#: ../Doc/library/functions.rst:359
msgid ""
-"For other containers see the built-in :class:`list`, :class:`set`, and :"
-"class:`tuple` classes, as well as the :mod:`collections` module."
+"Create a new dictionary. The :class:`dict` object is the dictionary "
+"class. See :class:`dict` and :ref:`typesmapping` for documentation about "
+"this class."
msgstr ""
-#: ../Doc/library/functions.rst:340
+#: ../Doc/library/functions.rst:362
+msgid ""
+"For other containers see the built-in :class:`list`, :class:`set`, and "
+":class:`tuple` classes, as well as the :mod:`collections` module."
+msgstr ""
+
+#: ../Doc/library/functions.rst:368
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 ""
"Sin argumentos, devuelve la lista de nombres en el ámbito local. Con un "
-"argumento, intenta devolver una lista de atributos válidos para ese objeto."
+"argumento, intenta devolver una lista de atributos válidos para ese "
+"objeto."
-#: ../Doc/library/functions.rst:343
+#: ../Doc/library/functions.rst:371
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 "
-"custom :func:`__getattr__` or :func:`__getattribute__` function to customize "
-"the way :func:`dir` reports their attributes."
+"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 custom :func:`__getattr__` or :func:`__getattribute__` "
+"function to customize the way :func:`dir` reports their attributes."
msgstr ""
-"Si el objeto tiene un método llamado :meth:`__dir__`, éste será llamado y "
-"debe devolver la lista de atributos. Esto permite que los objetos que "
-"implementan una función personalizada :func:`__getattr__` o :func:"
-"`__getattribute__` puedan decidir la manera en la que :func:`dir` reporta "
-"sus atributos."
+"Si el objeto tiene un método llamado :meth:`__dir__`, éste será llamado y"
+" debe devolver la lista de atributos. Esto permite que los objetos que "
+"implementan una función personalizada :func:`__getattr__` o "
+":func:`__getattribute__` puedan decidir la manera en la que :func:`dir` "
+"reporta sus atributos."
-#: ../Doc/library/functions.rst:348
+#: ../Doc/library/functions.rst:376
msgid ""
-"If the object does not provide :meth:`__dir__`, the function tries its best "
-"to gather information from the object's :attr:`~object.__dict__` attribute, "
-"if defined, and from its type object. The resulting list is not necessarily "
-"complete, and may be inaccurate when the object has a custom :func:"
-"`__getattr__`."
+"If the object does not provide :meth:`__dir__`, the function tries its "
+"best to gather information from the object's :attr:`~object.__dict__` "
+"attribute, if defined, and from its type object. The resulting list is "
+"not necessarily complete, and may be inaccurate when the object has a "
+"custom :func:`__getattr__`."
msgstr ""
"Si el objeto no provee de un método :meth:`__dir__`, la función intenta "
-"obtener la información del atributo :attr:`~object.__dict__` del objeto, si "
-"está definido, y de su objeto type. La lista resultante no está "
+"obtener la información del atributo :attr:`~object.__dict__` del objeto,"
+" si está definido, y de su objeto type. La lista resultante no está "
"necesariamente completa, y puede ser inexacta cuando el objeto tiene una "
"función :func:`__getattr__` implementada."
-#: ../Doc/library/functions.rst:353
+#: ../Doc/library/functions.rst:381
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:"
+"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 ""
-#: ../Doc/library/functions.rst:357
+#: ../Doc/library/functions.rst:385
msgid ""
"If the object is a module object, the list contains the names of the "
"module's attributes."
msgstr ""
-#: ../Doc/library/functions.rst:360
+#: ../Doc/library/functions.rst:388
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."
+"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 ""
-#: ../Doc/library/functions.rst:363
+#: ../Doc/library/functions.rst:391
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."
+"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 ""
-#: ../Doc/library/functions.rst:367
+#: ../Doc/library/functions.rst:395
msgid "The resulting list is sorted alphabetically. For example:"
msgstr ""
-#: ../Doc/library/functions.rst:386
+#: ../Doc/library/functions.rst:414
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 "
-"it tries to supply a rigorously or consistently defined set of names, and "
-"its detailed behavior may change across releases. For example, metaclass "
-"attributes are not in the result list when the argument is a class."
+"interactive prompt, it tries to supply an interesting set of names more "
+"than it tries to supply a rigorously or consistently defined set of "
+"names, and its detailed behavior may change across releases. For "
+"example, metaclass attributes are not in the result list when the "
+"argument is a class."
msgstr ""
-#: ../Doc/library/functions.rst:396
+#: ../Doc/library/functions.rst:424
msgid ""
"Take two (non complex) numbers as arguments and return a pair of numbers "
"consisting of their quotient and remainder when using integer division. "
-"With mixed operand types, the rules for binary arithmetic operators apply. "
-"For integers, the result is the same as ``(a // b, a % b)``. For floating "
-"point numbers the result is ``(q, a % b)``, where *q* is usually ``math."
-"floor(a / b)`` but may be 1 less than that. In any case ``q * b + a % b`` "
-"is very close to *a*, if ``a % b`` is non-zero it has the same sign as *b*, "
-"and ``0 <= abs(a % b) < abs(b)``."
+"With mixed operand types, the rules for binary arithmetic operators "
+"apply. For integers, the result is the same as ``(a // b, a % b)``. For "
+"floating point numbers the result is ``(q, a % b)``, where *q* is usually"
+" ``math.floor(a / b)`` but may be 1 less than that. In any case ``q * b "
+"+ a % b`` is very close to *a*, if ``a % b`` is non-zero it has the same "
+"sign as *b*, and ``0 <= abs(a % b) < abs(b)``."
msgstr ""
-#: ../Doc/library/functions.rst:408
+#: ../Doc/library/functions.rst:436
msgid ""
-"Return an enumerate object. *iterable* must be a sequence, an :term:"
-"`iterator`, or some other object which supports iteration. The :meth:"
-"`~iterator.__next__` method of the iterator returned by :func:`enumerate` "
-"returns a tuple containing a count (from *start* which defaults to 0) and "
-"the values obtained from iterating over *iterable*."
+"Return an enumerate object. *iterable* must be a sequence, an "
+":term:`iterator`, or some other object which supports iteration. The "
+":meth:`~iterator.__next__` method of the iterator returned by "
+":func:`enumerate` returns a tuple containing a count (from *start* which "
+"defaults to 0) and the values obtained from iterating over *iterable*."
msgstr ""
-#: ../Doc/library/functions.rst:420
+#: ../Doc/library/functions.rst:448
msgid "Equivalent to::"
msgstr ""
-#: ../Doc/library/functions.rst:431
+#: ../Doc/library/functions.rst:459
msgid ""
-"The arguments are a string and optional globals and locals. If provided, "
-"*globals* must be a dictionary. If provided, *locals* can be any mapping "
-"object."
+"The arguments are a string and optional globals and locals. If provided,"
+" *globals* must be a dictionary. If provided, *locals* can be any "
+"mapping object."
msgstr ""
-#: ../Doc/library/functions.rst:435
+#: ../Doc/library/functions.rst:463
msgid ""
"The *expression* argument is parsed and evaluated as a Python expression "
-"(technically speaking, a condition list) using the *globals* and *locals* "
-"dictionaries as global and local namespace. If the *globals* dictionary is "
-"present and does not contain a value for the key ``__builtins__``, a "
+"(technically speaking, a condition list) using the *globals* and *locals*"
+" dictionaries as global and local namespace. If the *globals* dictionary"
+" is present and does not contain a value for the key ``__builtins__``, a "
"reference to the dictionary of the built-in module :mod:`builtins` is "
-"inserted under that key before *expression* is parsed. This means that "
-"*expression* normally has full access to the standard :mod:`builtins` module "
-"and restricted environments are propagated. If the *locals* dictionary is "
-"omitted it defaults to the *globals* dictionary. If both dictionaries are "
-"omitted, the expression is executed in the environment where :func:`eval` is "
-"called. The return value is the result of the evaluated expression. Syntax "
-"errors are reported as exceptions. Example:"
+"inserted under that key before *expression* is parsed. This means that "
+"*expression* normally has full access to the standard :mod:`builtins` "
+"module and restricted environments are propagated. If the *locals* "
+"dictionary is omitted it defaults to the *globals* dictionary. If both "
+"dictionaries are omitted, the expression is executed with the *globals* "
+"and *locals* in the environment where :func:`eval` is called. Note, "
+"*eval()* does not have access to the :term:`nested scopes <nested scope>`"
+" (non-locals) in the enclosing environment."
+msgstr ""
+
+#: ../Doc/library/functions.rst:477
+msgid ""
+"The return value is the result of the evaluated expression. Syntax errors"
+" are reported as exceptions. Example:"
msgstr ""
-#: ../Doc/library/functions.rst:452
+#: ../Doc/library/functions.rst:484
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 "
-"of a string. If the code object has been compiled with ``'exec'`` as the "
-"*mode* argument, :func:`eval`\\'s return value will be ``None``."
+"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 of a string. If the code object has been compiled with "
+"``'exec'`` as the *mode* argument, :func:`eval`\\'s return value will be "
+"``None``."
msgstr ""
-#: ../Doc/library/functions.rst:457
+#: ../Doc/library/functions.rst:489
msgid ""
"Hints: dynamic execution of statements is supported by the :func:`exec` "
"function. The :func:`globals` and :func:`locals` functions returns the "
-"current global and local dictionary, respectively, which may be useful to "
-"pass around for use by :func:`eval` or :func:`exec`."
+"current global and local dictionary, respectively, which may be useful to"
+" pass around for use by :func:`eval` or :func:`exec`."
+msgstr ""
+
+#: ../Doc/library/functions.rst:494
+msgid ""
+"See :func:`ast.literal_eval` for a function that can safely evaluate "
+"strings with expressions containing only literals."
+msgstr ""
+
+msgid ""
+"Raises an :ref:`auditing event <auditing>` ``exec`` with argument "
+"``code_object``."
msgstr ""
-#: ../Doc/library/functions.rst:462
+#: ../Doc/library/functions.rst:499
+#: ../Doc/library/functions.rst:534
msgid ""
-"See :func:`ast.literal_eval` for a function that can safely evaluate strings "
-"with expressions containing only literals."
+"Raises an :ref:`auditing event <auditing>` ``exec`` with the code object "
+"as the argument. Code compilation events may also be raised."
msgstr ""
-#: ../Doc/library/functions.rst:469
+#: ../Doc/library/functions.rst:506
msgid ""
-"This function supports dynamic execution of Python code. *object* must be "
-"either a string or a code object. If it is a string, the string is parsed "
-"as a suite of Python statements which is then executed (unless a syntax "
-"error occurs). [#]_ If it is a code object, it is simply executed. In all "
-"cases, the code that's executed is expected to be valid as file input (see "
-"the section \"File input\" in the Reference Manual). Be aware that the :"
-"keyword:`return` and :keyword:`yield` statements may not be used outside of "
-"function definitions even within the context of code passed to the :func:"
-"`exec` function. The return value is ``None``."
+"This function supports dynamic execution of Python code. *object* must be"
+" either a string or a code object. If it is a string, the string is "
+"parsed as a suite of Python statements which is then executed (unless a "
+"syntax error occurs). [#]_ If it is a code object, it is simply executed."
+" In all cases, the code that's executed is expected to be valid as file "
+"input (see the section \"File input\" in the Reference Manual). Be aware "
+"that the :keyword:`return` and :keyword:`yield` statements may not be "
+"used outside of function definitions even within the context of code "
+"passed to the :func:`exec` function. The return value is ``None``."
msgstr ""
-#: ../Doc/library/functions.rst:479
+#: ../Doc/library/functions.rst:516
msgid ""
-"In all cases, if the optional parts are omitted, the code is executed in the "
-"current scope. If only *globals* is provided, it must be a dictionary, "
-"which will be used for both the global and the local variables. If "
-"*globals* and *locals* are given, they are used for the global and local "
-"variables, respectively. If provided, *locals* can be any mapping object. "
-"Remember that at module level, globals and locals are the same dictionary. "
-"If exec gets two separate objects as *globals* and *locals*, the code will "
-"be executed as if it were embedded in a class definition."
+"In all cases, if the optional parts are omitted, the code is executed in "
+"the current scope. If only *globals* is provided, it must be a "
+"dictionary (and not a subclass of dictionary), which will be used for "
+"both the global and the local variables. If *globals* and *locals* are "
+"given, they are used for the global and local variables, respectively. "
+"If provided, *locals* can be any mapping object. Remember that at module"
+" level, globals and locals are the same dictionary. If exec gets two "
+"separate objects as *globals* and *locals*, the code will be executed as "
+"if it were embedded in a class definition."
msgstr ""
-#: ../Doc/library/functions.rst:488
+#: ../Doc/library/functions.rst:526
msgid ""
"If the *globals* dictionary does not contain a value for the key "
-"``__builtins__``, a reference to the dictionary of the built-in module :mod:"
-"`builtins` is inserted under that key. That way you can control what "
-"builtins are available to the executed code by inserting your own "
-"``__builtins__`` dictionary into *globals* before passing it to :func:`exec`."
+"``__builtins__``, a reference to the dictionary of the built-in module "
+":mod:`builtins` is inserted under that key. That way you can control "
+"what builtins are available to the executed code by inserting your own "
+"``__builtins__`` dictionary into *globals* before passing it to "
+":func:`exec`."
msgstr ""
-#: ../Doc/library/functions.rst:496
+#: ../Doc/library/functions.rst:539
msgid ""
-"The built-in functions :func:`globals` and :func:`locals` return the current "
-"global and local dictionary, respectively, which may be useful to pass "
-"around for use as the second and third argument to :func:`exec`."
+"The built-in functions :func:`globals` and :func:`locals` return the "
+"current global and local dictionary, respectively, which may be useful to"
+" pass around for use as the second and third argument to :func:`exec`."
msgstr ""
-#: ../Doc/library/functions.rst:502
+#: ../Doc/library/functions.rst:545
msgid ""
"The default *locals* act as described for function :func:`locals` below: "
-"modifications to the default *locals* dictionary should not be attempted. "
-"Pass an explicit *locals* dictionary if you need to see effects of the code "
-"on *locals* after function :func:`exec` returns."
+"modifications to the default *locals* dictionary should not be attempted."
+" Pass an explicit *locals* dictionary if you need to see effects of the "
+"code on *locals* after function :func:`exec` returns."
msgstr ""
-#: ../Doc/library/functions.rst:510
+#: ../Doc/library/functions.rst:553
msgid ""
-"Construct an iterator from those elements of *iterable* for which *function* "
-"returns true. *iterable* may be either a sequence, a container which "
-"supports iteration, or an iterator. If *function* is ``None``, the identity "
-"function is assumed, that is, all elements of *iterable* that are false are "
-"removed."
+"Construct an iterator from those elements of *iterable* for which "
+"*function* returns true. *iterable* may be either a sequence, a "
+"container which supports iteration, or an iterator. If *function* is "
+"``None``, the identity function is assumed, that is, all elements of "
+"*iterable* that are false are removed."
msgstr ""
-#: ../Doc/library/functions.rst:516
+#: ../Doc/library/functions.rst:559
msgid ""
"Note that ``filter(function, iterable)`` is equivalent to the generator "
-"expression ``(item for item in iterable if function(item))`` if function is "
-"not ``None`` and ``(item for item in iterable if item)`` if function is "
-"``None``."
+"expression ``(item for item in iterable if function(item))`` if function "
+"is not ``None`` and ``(item for item in iterable if item)`` if function "
+"is ``None``."
msgstr ""
-#: ../Doc/library/functions.rst:521
+#: ../Doc/library/functions.rst:564
msgid ""
"See :func:`itertools.filterfalse` for the complementary function that "
"returns elements of *iterable* for which *function* returns false."
msgstr ""
-#: ../Doc/library/functions.rst:531
+#: ../Doc/library/functions.rst:574
msgid "Return a floating point number constructed from a number or string *x*."
msgstr ""
-#: ../Doc/library/functions.rst:533
+#: ../Doc/library/functions.rst:576
msgid ""
-"If the argument is a string, it should contain a decimal number, optionally "
-"preceded by a sign, and optionally embedded in whitespace. The optional "
-"sign may be ``'+'`` or ``'-'``; a ``'+'`` sign has no effect on the value "
-"produced. The argument may also be a string representing a NaN (not-a-"
-"number), or a positive or negative infinity. More precisely, the input must "
-"conform to the following grammar after leading and trailing whitespace "
-"characters are removed:"
+"If the argument is a string, it should contain a decimal number, "
+"optionally preceded by a sign, and optionally embedded in whitespace. "
+"The optional sign may be ``'+'`` or ``'-'``; a ``'+'`` sign has no effect"
+" on the value produced. The argument may also be a string representing a"
+" NaN (not-a-number), or a positive or negative infinity. More precisely,"
+" the input must conform to the following grammar after leading and "
+"trailing whitespace characters are removed:"
msgstr ""
-#: ../Doc/library/functions.rst:548
+#: ../Doc/library/functions.rst:591
msgid ""
"Here ``floatnumber`` is the form of a Python floating-point literal, "
"described in :ref:`floating`. Case is not significant, so, for example, "
-"\"inf\", \"Inf\", \"INFINITY\" and \"iNfINity\" are all acceptable spellings "
-"for positive infinity."
+"\"inf\", \"Inf\", \"INFINITY\" and \"iNfINity\" are all acceptable "
+"spellings for positive infinity."
msgstr ""
-#: ../Doc/library/functions.rst:553
+#: ../Doc/library/functions.rst:596
msgid ""
"Otherwise, if the argument is an integer or a floating point number, a "
-"floating point number with the same value (within Python's floating point "
-"precision) is returned. If the argument is outside the range of a Python "
-"float, an :exc:`OverflowError` will be raised."
+"floating point number with the same value (within Python's floating point"
+" precision) is returned. If the argument is outside the range of a "
+"Python float, an :exc:`OverflowError` will be raised."
msgstr ""
-#: ../Doc/library/functions.rst:558
+#: ../Doc/library/functions.rst:601
msgid ""
-"For a general Python object ``x``, ``float(x)`` delegates to ``x."
-"__float__()``."
+"For a general Python object ``x``, ``float(x)`` delegates to "
+"``x.__float__()``. If ``__float__()`` is not defined then it falls back "
+"to :meth:`__index__`."
msgstr ""
-#: ../Doc/library/functions.rst:561
+#: ../Doc/library/functions.rst:605
msgid "If no argument is given, ``0.0`` is returned."
msgstr ""
-#: ../Doc/library/functions.rst:563
+#: ../Doc/library/functions.rst:607
msgid "Examples::"
msgstr ""
-#: ../Doc/library/functions.rst:576
+#: ../Doc/library/functions.rst:620
msgid "The float type is described in :ref:`typesnumeric`."
msgstr ""
-#: ../Doc/library/functions.rst:591
+#: ../Doc/library/functions.rst:628
+msgid "Falls back to :meth:`__index__` if :meth:`__float__` is not defined."
+msgstr ""
+
+#: ../Doc/library/functions.rst:638
msgid ""
"Convert a *value* to a \"formatted\" representation, as controlled by "
-"*format_spec*. The interpretation of *format_spec* will depend on the type "
-"of the *value* argument, however there is a standard formatting syntax that "
-"is used by most built-in types: :ref:`formatspec`."
+"*format_spec*. The interpretation of *format_spec* will depend on the "
+"type of the *value* argument, however there is a standard formatting "
+"syntax that is used by most built-in types: :ref:`formatspec`."
msgstr ""
-#: ../Doc/library/functions.rst:596
+#: ../Doc/library/functions.rst:643
msgid ""
-"The default *format_spec* is an empty string which usually gives the same "
-"effect as calling :func:`str(value) <str>`."
+"The default *format_spec* is an empty string which usually gives the same"
+" effect as calling :func:`str(value) <str>`."
msgstr ""
-#: ../Doc/library/functions.rst:599
+#: ../Doc/library/functions.rst:646
msgid ""
-"A call to ``format(value, format_spec)`` is translated to ``type(value)."
-"__format__(value, format_spec)`` which bypasses the instance dictionary when "
-"searching for the value's :meth:`__format__` method. A :exc:`TypeError` "
-"exception is raised if the method search reaches :mod:`object` and the "
-"*format_spec* is non-empty, or if either the *format_spec* or the return "
-"value are not strings."
+"A call to ``format(value, format_spec)`` is translated to "
+"``type(value).__format__(value, format_spec)`` which bypasses the "
+"instance dictionary when searching for the value's :meth:`__format__` "
+"method. A :exc:`TypeError` exception is raised if the method search "
+"reaches :mod:`object` and the *format_spec* is non-empty, or if either "
+"the *format_spec* or the return value are not strings."
msgstr ""
-#: ../Doc/library/functions.rst:606
+#: ../Doc/library/functions.rst:653
msgid ""
"``object().__format__(format_spec)`` raises :exc:`TypeError` if "
"*format_spec* is not an empty string."
msgstr ""
-#: ../Doc/library/functions.rst:615
+#: ../Doc/library/functions.rst:662
msgid ""
-"Return a new :class:`frozenset` object, optionally with elements taken from "
-"*iterable*. ``frozenset`` is a built-in class. See :class:`frozenset` and :"
-"ref:`types-set` for documentation about this class."
+"Return a new :class:`frozenset` object, optionally with elements taken "
+"from *iterable*. ``frozenset`` is a built-in class. See "
+":class:`frozenset` and :ref:`types-set` for documentation about this "
+"class."
msgstr ""
-#: ../Doc/library/functions.rst:619
+#: ../Doc/library/functions.rst:666
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."
+"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 ""
-#: ../Doc/library/functions.rst:626
+#: ../Doc/library/functions.rst:673
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 "
"result is the value of that attribute. For example, ``getattr(x, "
-"'foobar')`` is equivalent to ``x.foobar``. If the named attribute does not "
-"exist, *default* is returned if provided, otherwise :exc:`AttributeError` is "
-"raised."
+"'foobar')`` is equivalent to ``x.foobar``. If the named attribute does "
+"not exist, *default* is returned if provided, otherwise "
+":exc:`AttributeError` is raised."
msgstr ""
-#: ../Doc/library/functions.rst:635
+#: ../Doc/library/functions.rst:682
msgid ""
-"Return a dictionary representing the current global symbol table. This is "
-"always the dictionary of the current module (inside a function or method, "
-"this is the module where it is defined, not the module from which it is "
-"called)."
+"Return a dictionary representing the current global symbol table. This is"
+" always the dictionary of the current module (inside a function or "
+"method, this is the module where it is defined, not the module from which"
+" it is called)."
msgstr ""
-#: ../Doc/library/functions.rst:642
+#: ../Doc/library/functions.rst:689
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. "
-"(This is implemented by calling ``getattr(object, name)`` and seeing whether "
-"it raises an :exc:`AttributeError` or not.)"
+"(This is implemented by calling ``getattr(object, name)`` and seeing "
+"whether it raises an :exc:`AttributeError` or not.)"
msgstr ""
-#: ../Doc/library/functions.rst:650
+#: ../Doc/library/functions.rst:697
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 "
"dictionary lookup. Numeric values that compare equal have the same hash "
-"value (even if they are of different types, as is the case for 1 and 1.0)."
+"value (even if they are of different types, as is the case for 1 and "
+"1.0)."
msgstr ""
-#: ../Doc/library/functions.rst:657
+#: ../Doc/library/functions.rst:704
msgid ""
"For objects with custom :meth:`__hash__` methods, note that :func:`hash` "
-"truncates the return value based on the bit width of the host machine. See :"
-"meth:`__hash__` for details."
+"truncates the return value based on the bit width of the host machine. "
+"See :meth:`__hash__` for details."
msgstr ""
-#: ../Doc/library/functions.rst:663
+#: ../Doc/library/functions.rst:710
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 "
-"interpreter console. If the argument is a string, then the string is looked "
-"up as the name of a module, function, class, method, keyword, or "
-"documentation topic, and a help page is printed on the console. If the "
-"argument is any other kind of object, a help page on the object is generated."
+"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 interpreter console. If the argument is a string, then the"
+" string is looked up as the name of a module, function, class, method, "
+"keyword, or documentation topic, and a help page is printed on the "
+"console. If the argument is any other kind of object, a help page on the"
+" object is generated."
msgstr ""
-#: ../Doc/library/functions.rst:670
+#: ../Doc/library/functions.rst:717
msgid ""
-"Note that if a slash(/) appears in the parameter list of a function, when "
-"invoking :func:`help`, it means that the parameters prior to the slash are "
-"positional-only. For more info, see :ref:`the FAQ entry on positional-only "
-"parameters <faq-positional-only-arguments>`."
+"Note that if a slash(/) appears in the parameter list of a function, when"
+" invoking :func:`help`, it means that the parameters prior to the slash "
+"are positional-only. For more info, see :ref:`the FAQ entry on "
+"positional-only parameters <faq-positional-only-arguments>`."
msgstr ""
-#: ../Doc/library/functions.rst:675
+#: ../Doc/library/functions.rst:722
msgid ""
-"This function is added to the built-in namespace by the :mod:`site` module."
+"This function is added to the built-in namespace by the :mod:`site` "
+"module."
msgstr ""
-#: ../Doc/library/functions.rst:677
+#: ../Doc/library/functions.rst:724
msgid ""
-"Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures "
-"for callables are now more comprehensive and consistent."
+"Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported "
+"signatures for callables are now more comprehensive and consistent."
msgstr ""
-#: ../Doc/library/functions.rst:684
+#: ../Doc/library/functions.rst:731
msgid ""
-"Convert an integer number to a lowercase hexadecimal string prefixed with "
-"\"0x\". If *x* is not a Python :class:`int` object, it has to define an :"
-"meth:`__index__` method that returns an integer. Some examples:"
+"Convert an integer number to a lowercase hexadecimal string prefixed with"
+" \"0x\". If *x* is not a Python :class:`int` object, it has to define an "
+":meth:`__index__` method that returns an integer. Some examples:"
msgstr ""
-#: ../Doc/library/functions.rst:693
+#: ../Doc/library/functions.rst:740
msgid ""
"If you want to convert an integer number to an uppercase or lower "
-"hexadecimal string with prefix or not, you can use either of the following "
-"ways:"
+"hexadecimal string with prefix or not, you can use either of the "
+"following ways:"
msgstr ""
-#: ../Doc/library/functions.rst:705
+#: ../Doc/library/functions.rst:752
msgid ""
-"See also :func:`int` for converting a hexadecimal string to an integer using "
-"a base of 16."
+"See also :func:`int` for converting a hexadecimal string to an integer "
+"using a base of 16."
msgstr ""
-#: ../Doc/library/functions.rst:710
+#: ../Doc/library/functions.rst:757
msgid ""
-"To obtain a hexadecimal string representation for a float, use the :meth:"
-"`float.hex` method."
+"To obtain a hexadecimal string representation for a float, use the "
+":meth:`float.hex` method."
msgstr ""
-#: ../Doc/library/functions.rst:716
+#: ../Doc/library/functions.rst:763
msgid ""
"Return the \"identity\" of an object. This is an integer which is "
-"guaranteed to be unique and constant for this object during its lifetime. "
-"Two objects with non-overlapping lifetimes may have the same :func:`id` "
+"guaranteed to be unique and constant for this object during its lifetime."
+" Two objects with non-overlapping lifetimes may have the same :func:`id` "
"value."
msgstr ""
-#: ../Doc/library/functions.rst:726
+#: ../Doc/library/functions.rst:773
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, "
-"converts it to a string (stripping a trailing newline), and returns that. "
-"When EOF is read, :exc:`EOFError` is raised. Example::"
+"converts it to a string (stripping a trailing newline), and returns that."
+" When EOF is read, :exc:`EOFError` is raised. Example::"
msgstr ""
-#: ../Doc/library/functions.rst:736
+#: ../Doc/library/functions.rst:783
msgid ""
-"If the :mod:`readline` module was loaded, then :func:`input` will use it to "
-"provide elaborate line editing and history features."
+"If the :mod:`readline` module was loaded, then :func:`input` will use it "
+"to provide elaborate line editing and history features."
msgstr ""
-#: ../Doc/library/functions.rst:743
msgid ""
-"Return an integer object constructed from a number or string *x*, or return "
-"``0`` if no arguments are given. If *x* defines :meth:`__int__`, ``int(x)`` "
-"returns ``x.__int__()``. If *x* defines :meth:`__trunc__`, it returns ``x."
-"__trunc__()``. For floating point numbers, this truncates towards zero."
+"Raises an :ref:`auditing event <auditing>` ``builtins.input`` with "
+"argument ``prompt``."
msgstr ""
-#: ../Doc/library/functions.rst:749
+#: ../Doc/library/functions.rst:788
msgid ""
-"If *x* is not a number or if *base* is given, then *x* must be a string, :"
-"class:`bytes`, or :class:`bytearray` instance representing an :ref:`integer "
-"literal <integers>` in radix *base*. Optionally, the literal can be "
-"preceded by ``+`` or ``-`` (with no space in between) and surrounded by "
-"whitespace. A base-n literal consists of the digits 0 to n-1, with ``a`` to "
-"``z`` (or ``A`` to ``Z``) having values 10 to 35. The default *base* is 10. "
-"The allowed values are 0 and 2--36. Base-2, -8, and -16 literals can be "
-"optionally prefixed with ``0b``/``0B``, ``0o``/``0O``, or ``0x``/``0X``, as "
-"with integer literals in code. Base 0 means to interpret exactly as a code "
-"literal, so that the actual base is 2, 8, 10, or 16, and so that "
-"``int('010', 0)`` is not legal, while ``int('010')`` is, as well as "
-"``int('010', 8)``."
+"Raises an :ref:`auditing event <auditing>` ``builtins.input`` with "
+"argument ``prompt`` before reading input"
msgstr ""
-#: ../Doc/library/functions.rst:762
-msgid "The integer type is described in :ref:`typesnumeric`."
+msgid ""
+"Raises an :ref:`auditing event <auditing>` ``builtins.input/result`` with"
+" argument ``result``."
+msgstr ""
+
+#: ../Doc/library/functions.rst:793
+msgid ""
+"Raises an auditing event ``builtins.input/result`` with the result after "
+"successfully reading input."
msgstr ""
-#: ../Doc/library/functions.rst:764
+#: ../Doc/library/functions.rst:800
msgid ""
-"If *base* is not an instance of :class:`int` and the *base* object has a :"
-"meth:`base.__index__ <object.__index__>` method, that method is called to "
-"obtain an integer for the base. Previous versions used :meth:`base.__int__ "
-"<object.__int__>` instead of :meth:`base.__index__ <object.__index__>`."
+"Return an integer object constructed from a number or string *x*, or "
+"return ``0`` if no arguments are given. If *x* defines :meth:`__int__`, "
+"``int(x)`` returns ``x.__int__()``. If *x* defines :meth:`__index__`, it"
+" returns ``x.__index__()``. If *x* defines :meth:`__trunc__`, it returns"
+" ``x.__trunc__()``. For floating point numbers, this truncates towards "
+"zero."
msgstr ""
-#: ../Doc/library/functions.rst:780
+#: ../Doc/library/functions.rst:807
msgid ""
-"Return true if the *object* argument is an instance of the *classinfo* "
-"argument, or of a (direct, indirect or :term:`virtual <abstract base "
-"class>`) subclass thereof. If *object* is not an object of the given type, "
-"the function always returns false. If *classinfo* is a tuple of type objects "
-"(or recursively, other such tuples), return true if *object* is an instance "
-"of any of the types. If *classinfo* is not a type or tuple of types and such "
-"tuples, a :exc:`TypeError` exception is raised."
+"If *x* is not a number or if *base* is given, then *x* must be a string, "
+":class:`bytes`, or :class:`bytearray` instance representing an "
+":ref:`integer literal <integers>` in radix *base*. Optionally, the "
+"literal can be preceded by ``+`` or ``-`` (with no space in between) and "
+"surrounded by whitespace. A base-n literal consists of the digits 0 to "
+"n-1, with ``a`` to ``z`` (or ``A`` to ``Z``) having values 10 to 35. The"
+" default *base* is 10. The allowed values are 0 and 2--36. Base-2, -8, "
+"and -16 literals can be optionally prefixed with ``0b``/``0B``, "
+"``0o``/``0O``, or ``0x``/``0X``, as with integer literals in code. Base "
+"0 means to interpret exactly as a code literal, so that the actual base "
+"is 2, 8, 10, or 16, and so that ``int('010', 0)`` is not legal, while "
+"``int('010')`` is, as well as ``int('010', 8)``."
msgstr ""
-#: ../Doc/library/functions.rst:792
+#: ../Doc/library/functions.rst:820
+msgid "The integer type is described in :ref:`typesnumeric`."
+msgstr ""
+
+#: ../Doc/library/functions.rst:822
msgid ""
-"Return true if *class* is a subclass (direct, indirect or :term:`virtual "
-"<abstract base class>`) of *classinfo*. A class is considered a subclass of "
-"itself. *classinfo* may be a tuple of class objects, in which case every "
-"entry in *classinfo* will be checked. In any other case, a :exc:`TypeError` "
+"If *base* is not an instance of :class:`int` and the *base* object has a "
+":meth:`base.__index__ <object.__index__>` method, that method is called "
+"to obtain an integer for the base. Previous versions used "
+":meth:`base.__int__ <object.__int__>` instead of :meth:`base.__index__ "
+"<object.__index__>`."
+msgstr ""
+
+#: ../Doc/library/functions.rst:835
+msgid "Falls back to :meth:`__index__` if :meth:`__int__` is not defined."
+msgstr ""
+
+#: ../Doc/library/functions.rst:841
+msgid ""
+"Return ``True`` if the *object* argument is an instance of the "
+"*classinfo* argument, or of a (direct, indirect or :term:`virtual "
+"<abstract base class>`) subclass thereof. If *object* is not an object "
+"of the given type, the function always returns ``False``. If *classinfo* "
+"is a tuple of type objects (or recursively, other such tuples), return "
+"``True`` if *object* is an instance of any of the types. If *classinfo* "
+"is not a type or tuple of types and such tuples, a :exc:`TypeError` "
"exception is raised."
msgstr ""
-#: ../Doc/library/functions.rst:801
+#: ../Doc/library/functions.rst:853
+msgid ""
+"Return ``True`` if *class* is a subclass (direct, indirect or "
+":term:`virtual <abstract base class>`) of *classinfo*. A class is "
+"considered a subclass of itself. *classinfo* may be a tuple of class "
+"objects, in which case every entry in *classinfo* will be checked. In any"
+" other case, a :exc:`TypeError` exception is raised."
+msgstr ""
+
+#: ../Doc/library/functions.rst:862
msgid ""
-"Return an :term:`iterator` object. The first argument is interpreted very "
-"differently depending on the presence of the second argument. Without a "
-"second argument, *object* must be a collection object which supports the "
-"iteration protocol (the :meth:`__iter__` method), or it must support the "
-"sequence protocol (the :meth:`__getitem__` method with integer arguments "
-"starting at ``0``). If it does not support either of those protocols, :exc:"
-"`TypeError` is raised. If the second argument, *sentinel*, is given, then "
-"*object* must be a callable object. The iterator created in this case will "
-"call *object* with no arguments for each call to its :meth:`~iterator."
-"__next__` method; if the value returned is equal to *sentinel*, :exc:"
-"`StopIteration` will be raised, otherwise the value will be returned."
+"Return an :term:`iterator` object. The first argument is interpreted "
+"very differently depending on the presence of the second argument. "
+"Without a second argument, *object* must be a collection object which "
+"supports the iteration protocol (the :meth:`__iter__` method), or it must"
+" support the sequence protocol (the :meth:`__getitem__` method with "
+"integer arguments starting at ``0``). If it does not support either of "
+"those protocols, :exc:`TypeError` is raised. If the second argument, "
+"*sentinel*, is given, then *object* must be a callable object. The "
+"iterator created in this case will call *object* with no arguments for "
+"each call to its :meth:`~iterator.__next__` method; if the value returned"
+" is equal to *sentinel*, :exc:`StopIteration` will be raised, otherwise "
+"the value will be returned."
msgstr ""
-#: ../Doc/library/functions.rst:814
+#: ../Doc/library/functions.rst:875
msgid "See also :ref:`typeiter`."
msgstr ""
-#: ../Doc/library/functions.rst:816
+#: ../Doc/library/functions.rst:877
msgid ""
"One useful application of the second form of :func:`iter` is to build a "
-"block-reader. For example, reading fixed-width blocks from a binary database "
-"file until the end of file is reached::"
+"block-reader. For example, reading fixed-width blocks from a binary "
+"database file until the end of file is reached::"
msgstr ""
-#: ../Doc/library/functions.rst:828
+#: ../Doc/library/functions.rst:889
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 "
-"(such as a dictionary, set, or frozen set)."
+"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 (such as a dictionary, set, or frozen set)."
msgstr ""
-#: ../Doc/library/functions.rst:837
+#: ../Doc/library/functions.rst:898
msgid ""
-"Rather than being a function, :class:`list` is actually a mutable sequence "
-"type, as documented in :ref:`typesseq-list` and :ref:`typesseq`."
+"Rather than being a function, :class:`list` is actually a mutable "
+"sequence type, as documented in :ref:`typesseq-list` and :ref:`typesseq`."
msgstr ""
-#: ../Doc/library/functions.rst:843
+#: ../Doc/library/functions.rst:904
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. Note that at the module level, :func:"
-"`locals` and :func:`globals` are the same dictionary."
+"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. Note that at the module level,"
+" :func:`locals` and :func:`globals` are the same dictionary."
msgstr ""
-#: ../Doc/library/functions.rst:849
+#: ../Doc/library/functions.rst:910
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 ""
-#: ../Doc/library/functions.rst:854
+#: ../Doc/library/functions.rst:915
msgid ""
"Return an iterator that applies *function* to every item of *iterable*, "
"yielding the results. If additional *iterable* arguments are passed, "
-"*function* must take that many arguments and is applied to the items from "
-"all iterables in parallel. With multiple iterables, the iterator stops when "
-"the shortest iterable is exhausted. For cases where the function inputs are "
-"already arranged into argument tuples, see :func:`itertools.starmap`\\."
+"*function* must take that many arguments and is applied to the items from"
+" all iterables in parallel. With multiple iterables, the iterator stops "
+"when the shortest iterable is exhausted. For cases where the function "
+"inputs are already arranged into argument tuples, see "
+":func:`itertools.starmap`\\."
msgstr ""
-#: ../Doc/library/functions.rst:865
+#: ../Doc/library/functions.rst:926
msgid ""
"Return the largest item in an iterable or the largest of two or more "
"arguments."
msgstr ""
-#: ../Doc/library/functions.rst:868
+#: ../Doc/library/functions.rst:929
msgid ""
-"If one positional argument is provided, it should be an :term:`iterable`. "
-"The largest item in the iterable is returned. If two or more positional "
-"arguments are provided, the largest of the positional arguments is returned."
+"If one positional argument is provided, it should be an :term:`iterable`."
+" The largest item in the iterable is returned. If two or more positional"
+" arguments are provided, the largest of the positional arguments is "
+"returned."
msgstr ""
-#: ../Doc/library/functions.rst:873 ../Doc/library/functions.rst:907
+#: ../Doc/library/functions.rst:934
+#: ../Doc/library/functions.rst:971
msgid ""
-"There are two optional keyword-only arguments. The *key* argument specifies "
-"a one-argument ordering function like that used for :meth:`list.sort`. The "
-"*default* argument specifies an object to return if the provided iterable is "
-"empty. If the iterable is empty and *default* is not provided, a :exc:"
-"`ValueError` is raised."
+"There are two optional keyword-only arguments. The *key* argument "
+"specifies a one-argument ordering function like that used for "
+":meth:`list.sort`. The *default* argument specifies an object to return "
+"if the provided iterable is empty. If the iterable is empty and *default*"
+" is not provided, a :exc:`ValueError` is raised."
msgstr ""
-#: ../Doc/library/functions.rst:879
+#: ../Doc/library/functions.rst:940
msgid ""
"If multiple items are maximal, the function returns the first one "
-"encountered. This is consistent with other sort-stability preserving tools "
-"such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and ``heapq."
-"nlargest(1, iterable, key=keyfunc)``."
+"encountered. This is consistent with other sort-stability preserving "
+"tools such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and "
+"``heapq.nlargest(1, iterable, key=keyfunc)``."
msgstr ""
-#: ../Doc/library/functions.rst:884 ../Doc/library/functions.rst:918
+#: ../Doc/library/functions.rst:945
+#: ../Doc/library/functions.rst:982
msgid "The *default* keyword-only argument."
msgstr ""
-#: ../Doc/library/functions.rst:892
+#: ../Doc/library/functions.rst:948
+#: ../Doc/library/functions.rst:985
+msgid "The *key* can be ``None``."
+msgstr ""
+
+#: ../Doc/library/functions.rst:956
msgid ""
-"Return a \"memory view\" object created from the given argument. See :ref:"
-"`typememoryview` for more information."
+"Return a \"memory view\" object created from the given argument. See "
+":ref:`typememoryview` for more information."
msgstr ""
-#: ../Doc/library/functions.rst:899
+#: ../Doc/library/functions.rst:963
msgid ""
"Return the smallest item in an iterable or the smallest of two or more "
"arguments."
msgstr ""
-#: ../Doc/library/functions.rst:902
+#: ../Doc/library/functions.rst:966
msgid ""
-"If one positional argument is provided, it should be an :term:`iterable`. "
-"The smallest item in the iterable is returned. If two or more positional "
-"arguments are provided, the smallest of the positional arguments is returned."
+"If one positional argument is provided, it should be an :term:`iterable`."
+" The smallest item in the iterable is returned. If two or more "
+"positional arguments are provided, the smallest of the positional "
+"arguments is returned."
msgstr ""
-#: ../Doc/library/functions.rst:913
+#: ../Doc/library/functions.rst:977
msgid ""
"If multiple items are minimal, the function returns the first one "
-"encountered. This is consistent with other sort-stability preserving tools "
-"such as ``sorted(iterable, key=keyfunc)[0]`` and ``heapq.nsmallest(1, "
-"iterable, key=keyfunc)``."
+"encountered. This is consistent with other sort-stability preserving "
+"tools such as ``sorted(iterable, key=keyfunc)[0]`` and "
+"``heapq.nsmallest(1, iterable, key=keyfunc)``."
msgstr ""
-#: ../Doc/library/functions.rst:924
+#: ../Doc/library/functions.rst:991
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 "
-"exhausted, otherwise :exc:`StopIteration` is raised."
+"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 exhausted, otherwise :exc:`StopIteration` is raised."
msgstr ""
-#: ../Doc/library/functions.rst:931
+#: ../Doc/library/functions.rst:998
msgid ""
-"Return a new featureless object. :class:`object` is a base for all classes. "
-"It has the methods that are common to all instances of Python classes. This "
-"function does not accept any arguments."
+"Return a new featureless object. :class:`object` is a base for all "
+"classes. It has the methods that are common to all instances of Python "
+"classes. This function does not accept any arguments."
msgstr ""
-#: ../Doc/library/functions.rst:937
+#: ../Doc/library/functions.rst:1004
msgid ""
":class:`object` does *not* have a :attr:`~object.__dict__`, so you can't "
"assign arbitrary attributes to an instance of the :class:`object` class."
msgstr ""
-#: ../Doc/library/functions.rst:943
+#: ../Doc/library/functions.rst:1010
msgid ""
"Convert an integer number to an octal string prefixed with \"0o\". The "
"result is a valid Python expression. If *x* is not a Python :class:`int` "
@@ -1321,944 +1463,1194 @@ msgid ""
"integer. For example:"
msgstr ""
-#: ../Doc/library/functions.rst:953
+#: ../Doc/library/functions.rst:1020
msgid ""
-"If you want to convert an integer number to octal string either with prefix "
-"\"0o\" or not, you can use either of the following ways."
+"If you want to convert an integer number to octal string either with "
+"prefix \"0o\" or not, you can use either of the following ways."
msgstr ""
-#: ../Doc/library/functions.rst:970
+#: ../Doc/library/functions.rst:1037
msgid ""
"Open *file* and return a corresponding :term:`file object`. If the file "
"cannot be opened, an :exc:`OSError` is raised."
msgstr ""
-#: ../Doc/library/functions.rst:973
+#: ../Doc/library/functions.rst:1040
msgid ""
"*file* is a :term:`path-like object` giving the pathname (absolute or "
-"relative to the current working directory) of the file to be opened or an "
-"integer file descriptor of the file to be wrapped. (If a file descriptor is "
-"given, it is closed when the returned I/O object is closed, unless *closefd* "
-"is set to ``False``.)"
+"relative to the current working directory) of the file to be opened or an"
+" integer file descriptor of the file to be wrapped. (If a file "
+"descriptor is given, it is closed when the returned I/O object is closed,"
+" unless *closefd* is set to ``False``.)"
msgstr ""
-#: ../Doc/library/functions.rst:979
+#: ../Doc/library/functions.rst:1046
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. "
-"Other common values are ``'w'`` for writing (truncating the file if it "
-"already exists), ``'x'`` for exclusive creation and ``'a'`` for appending "
-"(which on *some* Unix systems, means that *all* writes append to the end of "
-"the file regardless of the current seek position). In text mode, if "
-"*encoding* is not specified the encoding used is platform dependent: "
-"``locale.getpreferredencoding(False)`` is called to get the current locale "
-"encoding. (For reading and writing raw bytes use binary mode and leave "
-"*encoding* unspecified.) The available modes are:"
+"*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. Other common values are ``'w'`` for writing (truncating the file if"
+" it already exists), ``'x'`` for exclusive creation and ``'a'`` for "
+"appending (which on *some* Unix systems, means that *all* writes append "
+"to the end of the file regardless of the current seek position). In text"
+" mode, if *encoding* is not specified the encoding used is platform "
+"dependent: ``locale.getpreferredencoding(False)`` is called to get the "
+"current locale encoding. (For reading and writing raw bytes use binary "
+"mode and leave *encoding* unspecified.) The available modes are:"
msgstr ""
-#: ../Doc/library/functions.rst:996
+#: ../Doc/library/functions.rst:1063
msgid "Character"
msgstr ""
-#: ../Doc/library/functions.rst:996
+#: ../Doc/library/functions.rst:1063
msgid "Meaning"
msgstr ""
-#: ../Doc/library/functions.rst:998
+#: ../Doc/library/functions.rst:1065
msgid "``'r'``"
msgstr ""
-#: ../Doc/library/functions.rst:998
+#: ../Doc/library/functions.rst:1065
msgid "open for reading (default)"
msgstr ""
-#: ../Doc/library/functions.rst:999
+#: ../Doc/library/functions.rst:1066
msgid "``'w'``"
msgstr ""
-#: ../Doc/library/functions.rst:999
+#: ../Doc/library/functions.rst:1066
msgid "open for writing, truncating the file first"
msgstr ""
-#: ../Doc/library/functions.rst:1000
+#: ../Doc/library/functions.rst:1067
msgid "``'x'``"
msgstr ""
-#: ../Doc/library/functions.rst:1000
+#: ../Doc/library/functions.rst:1067
msgid "open for exclusive creation, failing if the file already exists"
msgstr ""
-#: ../Doc/library/functions.rst:1001
+#: ../Doc/library/functions.rst:1068
msgid "``'a'``"
msgstr ""
-#: ../Doc/library/functions.rst:1001
+#: ../Doc/library/functions.rst:1068
msgid "open for writing, appending to the end of the file if it exists"
msgstr ""
-#: ../Doc/library/functions.rst:1002
+#: ../Doc/library/functions.rst:1069
msgid "``'b'``"
msgstr ""
-#: ../Doc/library/functions.rst:1002
+#: ../Doc/library/functions.rst:1069
msgid "binary mode"
msgstr ""
-#: ../Doc/library/functions.rst:1003
+#: ../Doc/library/functions.rst:1070
msgid "``'t'``"
msgstr ""
-#: ../Doc/library/functions.rst:1003
+#: ../Doc/library/functions.rst:1070
msgid "text mode (default)"
msgstr ""
-#: ../Doc/library/functions.rst:1004
+#: ../Doc/library/functions.rst:1071
msgid "``'+'``"
msgstr ""
-#: ../Doc/library/functions.rst:1004
-msgid "open a disk file for updating (reading and writing)"
+#: ../Doc/library/functions.rst:1071
+msgid "open for updating (reading and writing)"
msgstr ""
-#: ../Doc/library/functions.rst:1007
+#: ../Doc/library/functions.rst:1074
msgid ""
-"The default mode is ``'r'`` (open for reading text, synonym of ``'rt'``). "
-"For binary read-write access, the mode ``'w+b'`` opens and truncates the "
-"file to 0 bytes. ``'r+b'`` opens the file without truncation."
+"The default mode is ``'r'`` (open for reading text, synonym of ``'rt'``)."
+" Modes ``'w+'`` and ``'w+b'`` open and truncate the file. Modes ``'r+'``"
+" and ``'r+b'`` open the file with no truncation."
msgstr ""
-#: ../Doc/library/functions.rst:1011
+#: ../Doc/library/functions.rst:1078
msgid ""
-"As mentioned in the :ref:`io-overview`, Python distinguishes between binary "
-"and text I/O. Files opened in binary mode (including ``'b'`` in the *mode* "
-"argument) return contents as :class:`bytes` objects without any decoding. "
-"In text mode (the default, or when ``'t'`` is included in the *mode* "
-"argument), the contents of the file are returned as :class:`str`, the bytes "
-"having been first decoded using a platform-dependent encoding or using the "
-"specified *encoding* if given."
+"As mentioned in the :ref:`io-overview`, Python distinguishes between "
+"binary and text I/O. Files opened in binary mode (including ``'b'`` in "
+"the *mode* argument) return contents as :class:`bytes` objects without "
+"any decoding. In text mode (the default, or when ``'t'`` is included in "
+"the *mode* argument), the contents of the file are returned as "
+":class:`str`, the bytes having been first decoded using a platform-"
+"dependent encoding or using the specified *encoding* if given."
msgstr ""
-#: ../Doc/library/functions.rst:1019
+#: ../Doc/library/functions.rst:1086
msgid ""
-"There is an additional mode character permitted, ``'U'``, which no longer "
-"has any effect, and is considered deprecated. It previously enabled :term:"
-"`universal newlines` in text mode, which became the default behaviour in "
-"Python 3.0. Refer to the documentation of the :ref:`newline <open-newline-"
-"parameter>` parameter for further details."
+"There is an additional mode character permitted, ``'U'``, which no longer"
+" has any effect, and is considered deprecated. It previously enabled "
+":term:`universal newlines` in text mode, which became the default "
+"behaviour in Python 3.0. Refer to the documentation of the :ref:`newline "
+"<open-newline-parameter>` parameter for further details."
msgstr ""
-#: ../Doc/library/functions.rst:1027
+#: ../Doc/library/functions.rst:1094
msgid ""
-"Python doesn't depend on the underlying operating system's notion of text "
-"files; all the processing is done by Python itself, and is therefore "
+"Python doesn't depend on the underlying operating system's notion of text"
+" files; all the processing is done by Python itself, and is therefore "
"platform-independent."
msgstr ""
-#: ../Doc/library/functions.rst:1031
+#: ../Doc/library/functions.rst:1098
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 "
-"buffering (only usable in text mode), and an integer > 1 to indicate the "
-"size in bytes of a fixed-size chunk buffer. When no *buffering* argument is "
-"given, the default buffering policy works as follows:"
+"*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 buffering (only usable in text mode), and an integer > 1 to "
+"indicate the size in bytes of a fixed-size chunk buffer. When no "
+"*buffering* argument is given, the default buffering policy works as "
+"follows:"
msgstr ""
-#: ../Doc/library/functions.rst:1037
+#: ../Doc/library/functions.rst:1104
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 "
-"size\" and falling back on :attr:`io.DEFAULT_BUFFER_SIZE`. On many systems, "
-"the buffer will typically be 4096 or 8192 bytes long."
+"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 size\" and falling back on :attr:`io.DEFAULT_BUFFER_SIZE`. On "
+"many systems, the buffer will typically be 4096 or 8192 bytes long."
msgstr ""
-#: ../Doc/library/functions.rst:1042
+#: ../Doc/library/functions.rst:1109
msgid ""
"\"Interactive\" text files (files for which :meth:`~io.IOBase.isatty` "
"returns ``True``) use line buffering. Other text files use the policy "
"described above for binary files."
msgstr ""
-#: ../Doc/library/functions.rst:1046
+#: ../Doc/library/functions.rst:1113
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 "
-"dependent (whatever :func:`locale.getpreferredencoding` returns), but any :"
-"term:`text encoding` supported by Python can be used. See the :mod:`codecs` "
-"module for the list of supported encodings."
+"*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"
+" dependent (whatever :func:`locale.getpreferredencoding` returns), but "
+"any :term:`text encoding` supported by Python can be used. See the "
+":mod:`codecs` module for the list of supported encodings."
msgstr ""
-#: ../Doc/library/functions.rst:1053
+#: ../Doc/library/functions.rst:1120
msgid ""
"*errors* is an optional string that specifies how encoding and decoding "
-"errors are to be handled—this cannot be used in binary mode. A variety of "
-"standard error handlers are available (listed under :ref:`error-handlers`), "
-"though any error handling name that has been registered with :func:`codecs."
-"register_error` is also valid. The standard names include:"
+"errors are to be handled—this cannot be used in binary mode. A variety of"
+" standard error handlers are available (listed under :ref:`error-"
+"handlers`), though any error handling name that has been registered with "
+":func:`codecs.register_error` is also valid. The standard names include:"
msgstr ""
-#: ../Doc/library/functions.rst:1061
+#: ../Doc/library/functions.rst:1128
msgid ""
-"``'strict'`` to raise a :exc:`ValueError` exception if there is an encoding "
-"error. The default value of ``None`` has the same effect."
+"``'strict'`` to raise a :exc:`ValueError` exception if there is an "
+"encoding error. The default value of ``None`` has the same effect."
msgstr ""
-#: ../Doc/library/functions.rst:1065
+#: ../Doc/library/functions.rst:1132
msgid ""
-"``'ignore'`` ignores errors. Note that ignoring encoding errors can lead to "
-"data loss."
+"``'ignore'`` ignores errors. Note that ignoring encoding errors can lead"
+" to data loss."
msgstr ""
-#: ../Doc/library/functions.rst:1068
+#: ../Doc/library/functions.rst:1135
msgid ""
-"``'replace'`` causes a replacement marker (such as ``'?'``) to be inserted "
-"where there is malformed data."
+"``'replace'`` causes a replacement marker (such as ``'?'``) to be "
+"inserted where there is malformed data."
msgstr ""
-#: ../Doc/library/functions.rst:1071
+#: ../Doc/library/functions.rst:1138
msgid ""
-"``'surrogateescape'`` will represent any incorrect bytes as code points in "
-"the Unicode Private Use Area ranging from U+DC80 to U+DCFF. These private "
-"code points will then be turned back into the same bytes when the "
-"``surrogateescape`` error handler is used when writing data. This is useful "
-"for processing files in an unknown encoding."
+"``'surrogateescape'`` will represent any incorrect bytes as code points "
+"in the Unicode Private Use Area ranging from U+DC80 to U+DCFF. These "
+"private code points will then be turned back into the same bytes when the"
+" ``surrogateescape`` error handler is used when writing data. This is "
+"useful for processing files in an unknown encoding."
msgstr ""
-#: ../Doc/library/functions.rst:1078
+#: ../Doc/library/functions.rst:1145
msgid ""
-"``'xmlcharrefreplace'`` is only supported when writing to a file. Characters "
-"not supported by the encoding are replaced with the appropriate XML "
-"character reference ``&#nnn;``."
+"``'xmlcharrefreplace'`` is only supported when writing to a file. "
+"Characters not supported by the encoding are replaced with the "
+"appropriate XML character reference ``&#nnn;``."
msgstr ""
-#: ../Doc/library/functions.rst:1082
+#: ../Doc/library/functions.rst:1149
msgid ""
"``'backslashreplace'`` replaces malformed data by Python's backslashed "
"escape sequences."
msgstr ""
-#: ../Doc/library/functions.rst:1085
+#: ../Doc/library/functions.rst:1152
msgid ""
-"``'namereplace'`` (also only supported when writing) replaces unsupported "
-"characters with ``\\N{...}`` escape sequences."
+"``'namereplace'`` (also only supported when writing) replaces unsupported"
+" characters with ``\\N{...}`` escape sequences."
msgstr ""
-#: ../Doc/library/functions.rst:1093
+#: ../Doc/library/functions.rst:1160
msgid ""
"*newline* controls how :term:`universal newlines` mode works (it only "
-"applies to text mode). It can be ``None``, ``''``, ``'\\n'``, ``'\\r'``, "
-"and ``'\\r\\n'``. It works as follows:"
+"applies to text mode). It can be ``None``, ``''``, ``'\\n'``, ``'\\r'``,"
+" and ``'\\r\\n'``. It works as follows:"
msgstr ""
-#: ../Doc/library/functions.rst:1097
+#: ../Doc/library/functions.rst:1164
msgid ""
"When reading input from the stream, if *newline* is ``None``, universal "
"newlines mode is enabled. Lines in the input can end in ``'\\n'``, "
-"``'\\r'``, or ``'\\r\\n'``, and these are translated into ``'\\n'`` before "
-"being returned to the caller. If it is ``''``, universal newlines mode is "
-"enabled, but line endings are returned to the caller untranslated. If it "
-"has any of the other legal values, input lines are only terminated by the "
-"given string, and the line ending is returned to the caller untranslated."
+"``'\\r'``, or ``'\\r\\n'``, and these are translated into ``'\\n'`` "
+"before being returned to the caller. If it is ``''``, universal newlines"
+" mode is enabled, but line endings are returned to the caller "
+"untranslated. If it has any of the other legal values, input lines are "
+"only terminated by the given string, and the line ending is returned to "
+"the caller untranslated."
msgstr ""
-#: ../Doc/library/functions.rst:1105
+#: ../Doc/library/functions.rst:1172
msgid ""
-"When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` "
-"characters written are translated to the system default line separator, :"
-"data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no translation "
-"takes place. If *newline* is any of the other legal values, any ``'\\n'`` "
-"characters written are translated to the given string."
+"When writing output to the stream, if *newline* is ``None``, any "
+"``'\\n'`` characters written are translated to the system default line "
+"separator, :data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no "
+"translation takes place. If *newline* is any of the other legal values, "
+"any ``'\\n'`` characters written are translated to the given string."
msgstr ""
-#: ../Doc/library/functions.rst:1111
+#: ../Doc/library/functions.rst:1178
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 "
-"closed. If a filename is given *closefd* must be ``True`` (the default) "
-"otherwise an error will be raised."
+"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 closed. If a filename is given *closefd* must be ``True`` (the "
+"default) otherwise an error will be raised."
msgstr ""
-#: ../Doc/library/functions.rst:1116
+#: ../Doc/library/functions.rst:1183
msgid ""
"A custom opener can be used by passing a callable as *opener*. The "
-"underlying file descriptor for the file object is then obtained by calling "
-"*opener* with (*file*, *flags*). *opener* must return an open file "
-"descriptor (passing :mod:`os.open` as *opener* results in functionality "
-"similar to passing ``None``)."
+"underlying file descriptor for the file object is then obtained by "
+"calling *opener* with (*file*, *flags*). *opener* must return an open "
+"file descriptor (passing :mod:`os.open` as *opener* results in "
+"functionality similar to passing ``None``)."
msgstr ""
-#: ../Doc/library/functions.rst:1122
+#: ../Doc/library/functions.rst:1189
msgid "The newly created file is :ref:`non-inheritable <fd_inheritance>`."
msgstr ""
-#: ../Doc/library/functions.rst:1124
+#: ../Doc/library/functions.rst:1191
msgid ""
-"The following example uses the :ref:`dir_fd <dir_fd>` parameter of the :func:"
-"`os.open` function to open a file relative to a given directory::"
+"The following example uses the :ref:`dir_fd <dir_fd>` parameter of the "
+":func:`os.open` function to open a file relative to a given directory::"
msgstr ""
-#: ../Doc/library/functions.rst:1137
+#: ../Doc/library/functions.rst:1204
msgid ""
"The type of :term:`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 (``'w'``, ``'r'``, ``'wt'``, ``'rt'``, etc.), it returns a subclass of :"
-"class:`io.TextIOBase` (specifically :class:`io.TextIOWrapper`). When used "
-"to open a file in a binary mode with buffering, the returned class is a "
-"subclass of :class:`io.BufferedIOBase`. The exact class varies: in read "
-"binary mode, it returns an :class:`io.BufferedReader`; in write binary and "
-"append binary modes, it returns an :class:`io.BufferedWriter`, and in read/"
-"write mode, it returns an :class:`io.BufferedRandom`. When buffering is "
-"disabled, the raw stream, a subclass of :class:`io.RawIOBase`, :class:`io."
-"FileIO`, is returned."
+"mode (``'w'``, ``'r'``, ``'wt'``, ``'rt'``, etc.), it returns a subclass "
+"of :class:`io.TextIOBase` (specifically :class:`io.TextIOWrapper`). When"
+" used to open a file in a binary mode with buffering, the returned class "
+"is a subclass of :class:`io.BufferedIOBase`. The exact class varies: in "
+"read binary mode, it returns an :class:`io.BufferedReader`; in write "
+"binary and append binary modes, it returns an :class:`io.BufferedWriter`,"
+" and in read/write mode, it returns an :class:`io.BufferedRandom`. When "
+"buffering is disabled, the raw stream, a subclass of "
+":class:`io.RawIOBase`, :class:`io.FileIO`, is returned."
msgstr ""
-#: ../Doc/library/functions.rst:1158
+#: ../Doc/library/functions.rst:1225
msgid ""
"See also the file handling modules, such as, :mod:`fileinput`, :mod:`io` "
-"(where :func:`open` is declared), :mod:`os`, :mod:`os.path`, :mod:"
-"`tempfile`, and :mod:`shutil`."
+"(where :func:`open` is declared), :mod:`os`, :mod:`os.path`, "
+":mod:`tempfile`, and :mod:`shutil`."
+msgstr ""
+
+#: ../Doc/library/functions.rst:1230
+msgid ""
+"Raises an :ref:`auditing event <auditing>` ``open`` with arguments "
+"``file``, ``mode``, ``flags``."
+msgstr ""
+
+#: ../Doc/library/functions.rst:1231
+msgid ""
+"The ``mode`` and ``flags`` arguments may have been modified or inferred "
+"from the original call."
msgstr ""
-#: ../Doc/library/functions.rst:1165
+#: ../Doc/library/functions.rst:1237
msgid "The *opener* parameter was added."
msgstr ""
-#: ../Doc/library/functions.rst:1166
+#: ../Doc/library/functions.rst:1238
msgid "The ``'x'`` mode was added."
msgstr ""
-#: ../Doc/library/functions.rst:1167
+#: ../Doc/library/functions.rst:1239
msgid ":exc:`IOError` used to be raised, it is now an alias of :exc:`OSError`."
msgstr ""
-#: ../Doc/library/functions.rst:1168
+#: ../Doc/library/functions.rst:1240
msgid ""
":exc:`FileExistsError` is now raised if the file opened in exclusive "
"creation mode (``'x'``) already exists."
msgstr ""
-#: ../Doc/library/functions.rst:1174
+#: ../Doc/library/functions.rst:1246
msgid "The file is now non-inheritable."
msgstr ""
-#: ../Doc/library/functions.rst:1178
+#: ../Doc/library/functions.rst:1250
msgid "The ``'U'`` mode."
msgstr ""
-#: ../Doc/library/functions.rst:1183
+#: ../Doc/library/functions.rst:1255
msgid ""
-"If the system call is interrupted and the signal handler does not raise an "
-"exception, the function now retries the system call instead of raising an :"
-"exc:`InterruptedError` exception (see :pep:`475` for the rationale)."
+"If the system call is interrupted and the signal handler does not raise "
+"an exception, the function now retries the system call instead of raising"
+" an :exc:`InterruptedError` exception (see :pep:`475` for the rationale)."
msgstr ""
-#: ../Doc/library/functions.rst:1186
+#: ../Doc/library/functions.rst:1258
msgid "The ``'namereplace'`` error handler was added."
msgstr ""
-#: ../Doc/library/functions.rst:1191
+#: ../Doc/library/functions.rst:1263
msgid "Support added to accept objects implementing :class:`os.PathLike`."
msgstr ""
-#: ../Doc/library/functions.rst:1192
+#: ../Doc/library/functions.rst:1264
msgid ""
-"On Windows, opening a console buffer may return a subclass of :class:`io."
-"RawIOBase` other than :class:`io.FileIO`."
+"On Windows, opening a console buffer may return a subclass of "
+":class:`io.RawIOBase` other than :class:`io.FileIO`."
msgstr ""
-#: ../Doc/library/functions.rst:1197
+#: ../Doc/library/functions.rst:1269
msgid ""
"Given a string representing one Unicode character, return an integer "
"representing the Unicode code point of that character. For example, "
-"``ord('a')`` returns the integer ``97`` and ``ord('€')`` (Euro sign) returns "
-"``8364``. This is the inverse of :func:`chr`."
+"``ord('a')`` returns the integer ``97`` and ``ord('€')`` (Euro sign) "
+"returns ``8364``. This is the inverse of :func:`chr`."
msgstr ""
-#: ../Doc/library/functions.rst:1205
+#: ../Doc/library/functions.rst:1277
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-"
-"argument form ``pow(x, y)`` is equivalent to using the power operator: "
-"``x**y``."
+"Return *base* to the power *exp*; if *mod* is present, return *base* to "
+"the power *exp*, modulo *mod* (computed more efficiently than ``pow(base,"
+" exp) % mod``). The two-argument form ``pow(base, exp)`` is equivalent to"
+" using the power operator: ``base**exp``."
msgstr ""
-#: ../Doc/library/functions.rst:1209
+#: ../Doc/library/functions.rst:1282
msgid ""
"The arguments must have numeric types. With mixed operand types, the "
"coercion rules for binary arithmetic operators apply. For :class:`int` "
"operands, the result has the same type as the operands (after coercion) "
"unless the second argument is negative; in that case, all arguments are "
-"converted to float and a float result is delivered. For example, ``10**2`` "
-"returns ``100``, but ``10**-2`` returns ``0.01``. If the second argument is "
-"negative, the third argument must be omitted. If *z* is present, *x* and "
-"*y* must be of integer types, and *y* must be non-negative."
+"converted to float and a float result is delivered. For example, "
+"``10**2`` returns ``100``, but ``10**-2`` returns ``0.01``."
msgstr ""
-#: ../Doc/library/functions.rst:1221
+#: ../Doc/library/functions.rst:1289
msgid ""
-"Print *objects* to the text stream *file*, separated by *sep* and followed "
-"by *end*. *sep*, *end*, *file* and *flush*, if present, must be given as "
-"keyword arguments."
+"For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* "
+"must also be of integer type and *mod* must be nonzero. If *mod* is "
+"present and *exp* is negative, *base* must be relatively prime to *mod*. "
+"In that case, ``pow(inv_base, -exp, mod)`` is returned, where *inv_base* "
+"is an inverse to *base* modulo *mod*."
msgstr ""
-#: ../Doc/library/functions.rst:1225
+#: ../Doc/library/functions.rst:1295
+msgid "Here's an example of computing an inverse for ``38`` modulo ``97``::"
+msgstr ""
+
+#: ../Doc/library/functions.rst:1302
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* "
-"and *end* must be strings; they can also be ``None``, which means to use the "
-"default values. If no *objects* are given, :func:`print` will just write "
-"*end*."
+"For :class:`int` operands, the three-argument form of ``pow`` now allows "
+"the second argument to be negative, permitting computation of modular "
+"inverses."
msgstr ""
-#: ../Doc/library/functions.rst:1231
+#: ../Doc/library/functions.rst:1307
+msgid ""
+"Allow keyword arguments. Formerly, only positional arguments were "
+"supported."
+msgstr ""
+
+#: ../Doc/library/functions.rst:1314
+msgid ""
+"Print *objects* to the text stream *file*, separated by *sep* and "
+"followed by *end*. *sep*, *end*, *file* and *flush*, if present, must be"
+" given as keyword arguments."
+msgstr ""
+
+#: ../Doc/library/functions.rst:1318
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. Since printed "
-"arguments are converted to text strings, :func:`print` cannot be used with "
-"binary mode file objects. For these, use ``file.write(...)`` instead."
+"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* and *end* must be strings; they can also be ``None``, which "
+"means to use the default values. If no *objects* are given, "
+":func:`print` will just write *end*."
msgstr ""
-#: ../Doc/library/functions.rst:1236
+#: ../Doc/library/functions.rst:1324
+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. Since "
+"printed arguments are converted to text strings, :func:`print` cannot be "
+"used with binary mode file objects. For these, use ``file.write(...)`` "
+"instead."
+msgstr ""
+
+#: ../Doc/library/functions.rst:1329
msgid ""
"Whether output is buffered is usually determined by *file*, but if the "
"*flush* keyword argument is true, the stream is forcibly flushed."
msgstr ""
-#: ../Doc/library/functions.rst:1239
+#: ../Doc/library/functions.rst:1332
msgid "Added the *flush* keyword argument."
msgstr ""
-#: ../Doc/library/functions.rst:1245
+#: ../Doc/library/functions.rst:1338
msgid "Return a property attribute."
msgstr ""
-#: ../Doc/library/functions.rst:1247
+#: ../Doc/library/functions.rst:1340
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 "
-"attribute value. And *doc* creates a docstring for the attribute."
+"*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 attribute value. And *doc* creates a docstring for the "
+"attribute."
msgstr ""
-#: ../Doc/library/functions.rst:1251
+#: ../Doc/library/functions.rst:1344
msgid "A typical use is to define a managed attribute ``x``::"
msgstr ""
-#: ../Doc/library/functions.rst:1268
+#: ../Doc/library/functions.rst:1361
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 ""
-#: ../Doc/library/functions.rst:1271
+#: ../Doc/library/functions.rst:1364
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 "
-"possible to create read-only properties easily using :func:`property` as a :"
-"term:`decorator`::"
+"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 possible to create read-only properties easily using "
+":func:`property` as a :term:`decorator`::"
msgstr ""
-#: ../Doc/library/functions.rst:1284
+#: ../Doc/library/functions.rst:1377
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 "
-"for *voltage* to \"Get the current voltage.\""
+"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 for *voltage* to \"Get the current voltage.\""
msgstr ""
-#: ../Doc/library/functions.rst:1288
+#: ../Doc/library/functions.rst:1381
msgid ""
-"A property object has :attr:`~property.getter`, :attr:`~property.setter`, "
-"and :attr:`~property.deleter` methods usable as decorators that create a "
-"copy of the property with the corresponding accessor function set to the "
-"decorated function. This is best explained with an example::"
+"A property object has :attr:`~property.getter`, :attr:`~property.setter`,"
+" and :attr:`~property.deleter` methods usable as decorators that create a"
+" copy of the property with the corresponding accessor function set to the"
+" decorated function. This is best explained with an example::"
msgstr ""
-#: ../Doc/library/functions.rst:1310
+#: ../Doc/library/functions.rst:1403
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 "
-"case.)"
+"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 case.)"
msgstr ""
-#: ../Doc/library/functions.rst:1314
+#: ../Doc/library/functions.rst:1407
msgid ""
-"The returned property object also has the attributes ``fget``, ``fset``, and "
-"``fdel`` corresponding to the constructor arguments."
+"The returned property object also has the attributes ``fget``, ``fset``, "
+"and ``fdel`` corresponding to the constructor arguments."
msgstr ""
-#: ../Doc/library/functions.rst:1317
+#: ../Doc/library/functions.rst:1410
msgid "The docstrings of property objects are now writeable."
msgstr ""
-#: ../Doc/library/functions.rst:1326
+#: ../Doc/library/functions.rst:1419
msgid ""
"Rather than being a function, :class:`range` is actually an immutable "
-"sequence type, as documented in :ref:`typesseq-range` and :ref:`typesseq`."
+"sequence type, as documented in :ref:`typesseq-range` and "
+":ref:`typesseq`."
msgstr ""
-#: ../Doc/library/functions.rst:1332
+#: ../Doc/library/functions.rst:1425
msgid ""
"Return a string containing a printable representation of an object. For "
"many types, this function makes an attempt to return a string that would "
-"yield an object with the same value when passed to :func:`eval`, otherwise "
-"the representation is a string enclosed in angle brackets that contains the "
-"name of the type of the object together with additional information often "
-"including the name and address of the object. A class can control what this "
-"function returns for its instances by defining a :meth:`__repr__` method."
+"yield an object with the same value when passed to :func:`eval`, "
+"otherwise the representation is a string enclosed in angle brackets that "
+"contains the name of the type of the object together with additional "
+"information often including the name and address of the object. A class "
+"can control what this function returns for its instances by defining a "
+":meth:`__repr__` method."
msgstr ""
-#: ../Doc/library/functions.rst:1343
+#: ../Doc/library/functions.rst:1436
msgid ""
-"Return a reverse :term:`iterator`. *seq* must be an object which has a :"
-"meth:`__reversed__` method or supports the sequence protocol (the :meth:"
-"`__len__` method and the :meth:`__getitem__` method with integer arguments "
-"starting at ``0``)."
+"Return a reverse :term:`iterator`. *seq* must be an object which has a "
+":meth:`__reversed__` method or supports the sequence protocol (the "
+":meth:`__len__` method and the :meth:`__getitem__` method with integer "
+"arguments starting at ``0``)."
msgstr ""
-#: ../Doc/library/functions.rst:1351
+#: ../Doc/library/functions.rst:1444
msgid ""
-"Return *number* rounded to *ndigits* precision after the decimal point. If "
-"*ndigits* is omitted or is ``None``, it returns the nearest integer to its "
-"input."
+"Return *number* rounded to *ndigits* precision after the decimal point. "
+"If *ndigits* is omitted or is ``None``, it returns the nearest integer to"
+" its input."
msgstr ""
-#: ../Doc/library/functions.rst:1355
+#: ../Doc/library/functions.rst:1448
msgid ""
-"For the built-in types supporting :func:`round`, values are rounded to the "
-"closest multiple of 10 to the power minus *ndigits*; if two multiples are "
-"equally close, rounding is done toward the even choice (so, for example, "
-"both ``round(0.5)`` and ``round(-0.5)`` are ``0``, and ``round(1.5)`` is "
-"``2``). Any integer value is valid for *ndigits* (positive, zero, or "
-"negative). The return value is an integer if *ndigits* is omitted or "
-"``None``. Otherwise the return value has the same type as *number*."
+"For the built-in types supporting :func:`round`, values are rounded to "
+"the closest multiple of 10 to the power minus *ndigits*; if two multiples"
+" are equally close, rounding is done toward the even choice (so, for "
+"example, both ``round(0.5)`` and ``round(-0.5)`` are ``0``, and "
+"``round(1.5)`` is ``2``). Any integer value is valid for *ndigits* "
+"(positive, zero, or negative). The return value is an integer if "
+"*ndigits* is omitted or ``None``. Otherwise the return value has the same"
+" type as *number*."
msgstr ""
-#: ../Doc/library/functions.rst:1364
+#: ../Doc/library/functions.rst:1457
msgid ""
-"For a general Python object ``number``, ``round`` delegates to ``number."
-"__round__``."
+"For a general Python object ``number``, ``round`` delegates to "
+"``number.__round__``."
msgstr ""
-#: ../Doc/library/functions.rst:1369
+#: ../Doc/library/functions.rst:1462
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 "
-"not a bug: it's a result of the fact that most decimal fractions can't be "
-"represented exactly as a float. See :ref:`tut-fp-issues` for more "
-"information."
+"``round(2.675, 2)`` gives ``2.67`` instead of the expected ``2.68``. This"
+" is not a bug: it's a result of the fact that most decimal fractions "
+"can't be represented exactly as a float. See :ref:`tut-fp-issues` for "
+"more information."
msgstr ""
-#: ../Doc/library/functions.rst:1380
+#: ../Doc/library/functions.rst:1473
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-"
-"set` for documentation about this class."
+"*iterable*. ``set`` is a built-in class. See :class:`set` and :ref"
+":`types-set` for documentation about this class."
msgstr ""
-#: ../Doc/library/functions.rst:1384
+#: ../Doc/library/functions.rst:1477
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."
+"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 ""
-#: ../Doc/library/functions.rst:1391
+#: ../Doc/library/functions.rst:1484
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 "
-"a new attribute. The function assigns the value to the attribute, provided "
-"the object allows it. For example, ``setattr(x, 'foobar', 123)`` is "
-"equivalent to ``x.foobar = 123``."
+"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 a new attribute. The function assigns the value to the "
+"attribute, provided the object allows it. For example, ``setattr(x, "
+"'foobar', 123)`` is equivalent to ``x.foobar = 123``."
msgstr ""
-#: ../Doc/library/functions.rst:1403
+#: ../Doc/library/functions.rst:1496
msgid ""
-"Return a :term:`slice` object representing the set of indices specified by "
-"``range(start, stop, step)``. The *start* and *step* arguments default to "
-"``None``. Slice objects have read-only data attributes :attr:`~slice."
-"start`, :attr:`~slice.stop` and :attr:`~slice.step` which merely return the "
-"argument values (or their default). They have no other explicit "
-"functionality; however they are used by Numerical Python and other third "
-"party extensions. Slice objects are also generated when extended indexing "
-"syntax is used. For example: ``a[start:stop:step]`` or ``a[start:stop, "
-"i]``. See :func:`itertools.islice` for an alternate version that returns an "
-"iterator."
+"Return a :term:`slice` object representing the set of indices specified "
+"by ``range(start, stop, step)``. The *start* and *step* arguments "
+"default to ``None``. Slice objects have read-only data attributes "
+":attr:`~slice.start`, :attr:`~slice.stop` and :attr:`~slice.step` which "
+"merely return the argument values (or their default). They have no other"
+" explicit functionality; however they are used by Numerical Python and "
+"other third party extensions. Slice objects are also generated when "
+"extended indexing syntax is used. For example: ``a[start:stop:step]`` or"
+" ``a[start:stop, i]``. See :func:`itertools.islice` for an alternate "
+"version that returns an iterator."
msgstr ""
-#: ../Doc/library/functions.rst:1416
+#: ../Doc/library/functions.rst:1509
msgid "Return a new sorted list from the items in *iterable*."
msgstr ""
-#: ../Doc/library/functions.rst:1418
-msgid ""
-"Has two optional arguments which must be specified as keyword arguments."
+#: ../Doc/library/functions.rst:1511
+msgid "Has two optional arguments which must be specified as keyword arguments."
msgstr ""
-#: ../Doc/library/functions.rst:1420
+#: ../Doc/library/functions.rst:1513
msgid ""
"*key* specifies a function of one argument that is used to extract a "
-"comparison key from each element in *iterable* (for example, ``key=str."
-"lower``). The default value is ``None`` (compare the elements directly)."
+"comparison key from each element in *iterable* (for example, "
+"``key=str.lower``). The default value is ``None`` (compare the elements "
+"directly)."
msgstr ""
-#: ../Doc/library/functions.rst:1424
+#: ../Doc/library/functions.rst:1517
msgid ""
-"*reverse* is a boolean value. If set to ``True``, then the list elements "
-"are sorted as if each comparison were reversed."
+"*reverse* is a boolean value. If set to ``True``, then the list elements"
+" are sorted as if each comparison were reversed."
msgstr ""
-#: ../Doc/library/functions.rst:1427
+#: ../Doc/library/functions.rst:1520
msgid ""
-"Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function to a "
-"*key* function."
+"Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function "
+"to a *key* function."
msgstr ""
-#: ../Doc/library/functions.rst:1430
+#: ../Doc/library/functions.rst:1523
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 "
-"compare equal --- this is helpful for sorting in multiple passes (for "
-"example, sort by department, then by salary grade)."
+"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 compare equal --- this is helpful for sorting in multiple passes "
+"(for example, sort by department, then by salary grade)."
msgstr ""
-#: ../Doc/library/functions.rst:1435
+#: ../Doc/library/functions.rst:1528
msgid ""
-"For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`."
+"For sorting examples and a brief sorting tutorial, see "
+":ref:`sortinghowto`."
msgstr ""
-#: ../Doc/library/functions.rst:1439
+#: ../Doc/library/functions.rst:1532
msgid "Transform a method into a static method."
msgstr ""
-#: ../Doc/library/functions.rst:1441
+#: ../Doc/library/functions.rst:1534
msgid ""
-"A static method does not receive an implicit first argument. To declare a "
-"static method, use this idiom::"
+"A static method does not receive an implicit first argument. To declare a"
+" static method, use this idiom::"
msgstr ""
-#: ../Doc/library/functions.rst:1448
+#: ../Doc/library/functions.rst:1541
msgid ""
-"The ``@staticmethod`` form is a function :term:`decorator` -- see :ref:"
-"`function` for details."
+"The ``@staticmethod`` form is a function :term:`decorator` -- see "
+":ref:`function` for details."
msgstr ""
-#: ../Doc/library/functions.rst:1451
+#: ../Doc/library/functions.rst:1544
msgid ""
-"A static method can be called either on the class (such as ``C.f()``) or on "
-"an instance (such as ``C().f()``)."
+"A static method can be called either on the class (such as ``C.f()``) or "
+"on an instance (such as ``C().f()``)."
msgstr ""
-#: ../Doc/library/functions.rst:1454
+#: ../Doc/library/functions.rst:1547
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."
+"see :func:`classmethod` for a variant that is useful for creating "
+"alternate class constructors."
msgstr ""
-#: ../Doc/library/functions.rst:1458
+#: ../Doc/library/functions.rst:1551
msgid ""
"Like all decorators, it is also possible to call ``staticmethod`` as a "
-"regular function and do something with its result. This is needed in some "
-"cases where you need a reference to a function from a class body and you "
-"want to avoid the automatic transformation to instance method. For these "
-"cases, use this idiom::"
+"regular function and do something with its result. This is needed in "
+"some cases where you need a reference to a function from a class body and"
+" you want to avoid the automatic transformation to instance method. For "
+"these cases, use this idiom::"
msgstr ""
-#: ../Doc/library/functions.rst:1467
+#: ../Doc/library/functions.rst:1560
msgid "For more information on static methods, see :ref:`types`."
msgstr ""
-#: ../Doc/library/functions.rst:1478
-msgid ""
-"Return a :class:`str` version of *object*. See :func:`str` for details."
+#: ../Doc/library/functions.rst:1571
+msgid "Return a :class:`str` version of *object*. See :func:`str` for details."
msgstr ""
-#: ../Doc/library/functions.rst:1480
+#: ../Doc/library/functions.rst:1573
msgid ""
-"``str`` is the built-in string :term:`class`. For general information about "
-"strings, see :ref:`textseq`."
+"``str`` is the built-in string :term:`class`. For general information "
+"about strings, see :ref:`textseq`."
msgstr ""
-#: ../Doc/library/functions.rst:1486
+#: ../Doc/library/functions.rst:1579
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 "
-"numbers, and the start value is not allowed to be a string."
+"Sums *start* and the items of an *iterable* from left to right and "
+"returns the total. The *iterable*'s items are normally numbers, and the "
+"start value is not allowed to be a string."
msgstr ""
-#: ../Doc/library/functions.rst:1490
+#: ../Doc/library/functions.rst:1583
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 ``''."
-"join(sequence)``. To add floating point values with extended precision, "
-"see :func:`math.fsum`\\. To concatenate a series of iterables, consider "
-"using :func:`itertools.chain`."
+"preferred, fast way to concatenate a sequence of strings is by calling "
+"``''.join(sequence)``. To add floating point values with extended "
+"precision, see :func:`math.fsum`\\. To concatenate a series of "
+"iterables, consider using :func:`itertools.chain`."
+msgstr ""
+
+#: ../Doc/library/functions.rst:1589
+msgid "The *start* parameter can be specified as a keyword argument."
msgstr ""
-#: ../Doc/library/functions.rst:1498
+#: ../Doc/library/functions.rst:1594
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 "
-"been overridden in a class. The search order is same as that used by :func:"
-"`getattr` except that the *type* itself is skipped."
+"class of *type*. This is useful for accessing inherited methods that "
+"have been overridden in a class."
msgstr ""
-#: ../Doc/library/functions.rst:1503
+#: ../Doc/library/functions.rst:1598
msgid ""
-"The :attr:`~class.__mro__` attribute of the *type* lists the method "
-"resolution search order used by both :func:`getattr` and :func:`super`. The "
-"attribute is dynamic and can change whenever the inheritance hierarchy is "
-"updated."
+"The *object-or-type* determines the :term:`method resolution order` to be"
+" searched. The search starts from the class right after the *type*."
msgstr ""
-#: ../Doc/library/functions.rst:1508
+#: ../Doc/library/functions.rst:1602
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. "
-"If the second argument is a type, ``issubclass(type2, type)`` must be true "
-"(this is useful for classmethods)."
+"For example, if :attr:`~class.__mro__` of *object-or-type* is ``D -> B ->"
+" C -> A -> object`` and the value of *type* is ``B``, then :func:`super` "
+"searches ``C -> A -> object``."
msgstr ""
-#: ../Doc/library/functions.rst:1513
+#: ../Doc/library/functions.rst:1606
+msgid ""
+"The :attr:`~class.__mro__` attribute of the *object-or-type* lists the "
+"method resolution search order used by both :func:`getattr` and "
+":func:`super`. The attribute is dynamic and can change whenever the "
+"inheritance hierarchy is updated."
+msgstr ""
+
+#: ../Doc/library/functions.rst:1611
+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. If the second argument is a type, ``issubclass(type2, type)`` must"
+" be true (this is useful for classmethods)."
+msgstr ""
+
+#: ../Doc/library/functions.rst:1616
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 "
-"naming them explicitly, thus making the code more maintainable. This use "
-"closely parallels the use of *super* in other programming languages."
+"single inheritance, *super* can be used to refer to parent classes "
+"without naming them explicitly, thus making the code more maintainable. "
+"This use closely parallels the use of *super* in other programming "
+"languages."
msgstr ""
-#: ../Doc/library/functions.rst:1518
+#: ../Doc/library/functions.rst:1621
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 "
-"found in statically compiled languages or languages that only support single "
-"inheritance. This makes it possible to implement \"diamond diagrams\" where "
-"multiple base classes implement the same method. Good design dictates that "
-"this method have the same calling signature in every case (because the order "
-"of calls is determined at runtime, because that order adapts to changes in "
-"the class hierarchy, and because that order can include sibling classes that "
-"are unknown prior to runtime)."
+"dynamic execution environment. This use case is unique to Python and is "
+"not found in statically compiled languages or languages that only support"
+" single inheritance. This makes it possible to implement \"diamond "
+"diagrams\" where multiple base classes implement the same method. Good "
+"design dictates that this method have the same calling signature in every"
+" case (because the order of calls is determined at runtime, because that "
+"order adapts to changes in the class hierarchy, and because that order "
+"can include sibling classes that are unknown prior to runtime)."
msgstr ""
-#: ../Doc/library/functions.rst:1528
+#: ../Doc/library/functions.rst:1631
msgid "For both use cases, a typical superclass call looks like this::"
msgstr ""
-#: ../Doc/library/functions.rst:1535
+#: ../Doc/library/functions.rst:1638
+msgid ""
+"In addition to method lookups, :func:`super` also works for attribute "
+"lookups. One possible use case for this is calling :term:`descriptors "
+"<descriptor>` in a parent or sibling class."
+msgstr ""
+
+#: ../Doc/library/functions.rst:1642
msgid ""
-"Note that :func:`super` is implemented as part of the binding process for "
-"explicit dotted attribute lookups such as ``super().__getitem__(name)``. It "
-"does so by implementing its own :meth:`__getattribute__` method for "
-"searching classes in a predictable order that supports cooperative multiple "
-"inheritance. Accordingly, :func:`super` is undefined for implicit lookups "
-"using statements or operators such as ``super()[name]``."
+"Note that :func:`super` is implemented as part of the binding process for"
+" explicit dotted attribute lookups such as ``super().__getitem__(name)``."
+" It does so by implementing its own :meth:`__getattribute__` method for "
+"searching classes in a predictable order that supports cooperative "
+"multiple inheritance. Accordingly, :func:`super` is undefined for "
+"implicit lookups using statements or operators such as ``super()[name]``."
msgstr ""
-#: ../Doc/library/functions.rst:1542
+#: ../Doc/library/functions.rst:1649
msgid ""
"Also note that, aside from the zero argument form, :func:`super` is not "
"limited to use inside methods. The two argument form specifies the "
-"arguments exactly and makes the appropriate references. The zero argument "
-"form only works inside a class definition, as the compiler fills in the "
-"necessary details to correctly retrieve the class being defined, as well as "
-"accessing the current instance for ordinary methods."
+"arguments exactly and makes the appropriate references. The zero "
+"argument form only works inside a class definition, as the compiler fills"
+" in the necessary details to correctly retrieve the class being defined, "
+"as well as accessing the current instance for ordinary methods."
msgstr ""
-#: ../Doc/library/functions.rst:1549
+#: ../Doc/library/functions.rst:1656
msgid ""
-"For practical suggestions on how to design cooperative classes using :func:"
-"`super`, see `guide to using super() <https://rhettinger.wordpress."
-"com/2011/05/26/super-considered-super/>`_."
+"For practical suggestions on how to design cooperative classes using "
+":func:`super`, see `guide to using super() "
+"<https://rhettinger.wordpress.com/2011/05/26/super-considered-super/>`_."
msgstr ""
-#: ../Doc/library/functions.rst:1558
+#: ../Doc/library/functions.rst:1665
msgid ""
"Rather than being a function, :class:`tuple` is actually an immutable "
-"sequence type, as documented in :ref:`typesseq-tuple` and :ref:`typesseq`."
+"sequence type, as documented in :ref:`typesseq-tuple` and "
+":ref:`typesseq`."
msgstr ""
-#: ../Doc/library/functions.rst:1567
+#: ../Doc/library/functions.rst:1674
msgid ""
-"With one argument, return the type of an *object*. The return value is a "
-"type object and generally the same object as returned by :attr:`object."
-"__class__ <instance.__class__>`."
+"With one argument, return the type of an *object*. The return value is a"
+" type object and generally the same object as returned by "
+":attr:`object.__class__ <instance.__class__>`."
msgstr ""
-#: ../Doc/library/functions.rst:1571
+#: ../Doc/library/functions.rst:1678
msgid ""
-"The :func:`isinstance` built-in function is recommended for testing the type "
-"of an object, because it takes subclasses into account."
+"The :func:`isinstance` built-in function is recommended for testing the "
+"type of an object, because it takes subclasses into account."
msgstr ""
-#: ../Doc/library/functions.rst:1575
+#: ../Doc/library/functions.rst:1682
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 "
"class name and becomes the :attr:`~definition.__name__` attribute; the "
-"*bases* tuple itemizes the base classes and becomes the :attr:`~class."
-"__bases__` attribute; and the *dict* dictionary is the namespace containing "
-"definitions for class body and is copied to a standard dictionary to become "
-"the :attr:`~object.__dict__` attribute. For example, the following two "
-"statements create identical :class:`type` objects:"
+"*bases* tuple itemizes the base classes and becomes the "
+":attr:`~class.__bases__` attribute; and the *dict* dictionary is the "
+"namespace containing definitions for class body and is copied to a "
+"standard dictionary to become the :attr:`~object.__dict__` attribute. "
+"For example, the following two statements create identical :class:`type` "
+"objects:"
msgstr ""
-#: ../Doc/library/functions.rst:1589
+#: ../Doc/library/functions.rst:1696
msgid "See also :ref:`bltin-type-objects`."
msgstr ""
-#: ../Doc/library/functions.rst:1591
+#: ../Doc/library/functions.rst:1698
msgid ""
"Subclasses of :class:`type` which don't override ``type.__new__`` may no "
"longer use the one-argument form to get the type of an object."
msgstr ""
-#: ../Doc/library/functions.rst:1597
+#: ../Doc/library/functions.rst:1704
msgid ""
-"Return the :attr:`~object.__dict__` attribute for a module, class, instance, "
-"or any other object with a :attr:`~object.__dict__` attribute."
+"Return the :attr:`~object.__dict__` attribute for a module, class, "
+"instance, or any other object with a :attr:`~object.__dict__` attribute."
msgstr ""
-#: ../Doc/library/functions.rst:1600
+#: ../Doc/library/functions.rst:1707
msgid ""
-"Objects such as modules and instances have an updateable :attr:`~object."
-"__dict__` attribute; however, other objects may have write restrictions on "
-"their :attr:`~object.__dict__` attributes (for example, classes use a :class:"
-"`types.MappingProxyType` to prevent direct dictionary updates)."
+"Objects such as modules and instances have an updateable "
+":attr:`~object.__dict__` attribute; however, other objects may have write"
+" restrictions on their :attr:`~object.__dict__` attributes (for example, "
+"classes use a :class:`types.MappingProxyType` to prevent direct "
+"dictionary updates)."
msgstr ""
-#: ../Doc/library/functions.rst:1605
+#: ../Doc/library/functions.rst:1712
msgid ""
"Without an argument, :func:`vars` acts like :func:`locals`. Note, the "
"locals dictionary is only useful for reads since updates to the locals "
"dictionary are ignored."
msgstr ""
-#: ../Doc/library/functions.rst:1612
+#: ../Doc/library/functions.rst:1719
msgid "Make an iterator that aggregates elements from each of the iterables."
msgstr ""
-#: ../Doc/library/functions.rst:1614
+#: ../Doc/library/functions.rst:1721
msgid ""
-"Returns an iterator of tuples, where the *i*-th tuple contains the *i*-th "
-"element from each of the argument sequences or iterables. The iterator "
-"stops when the shortest input iterable is exhausted. With a single iterable "
-"argument, it returns an iterator of 1-tuples. With no arguments, it returns "
-"an empty iterator. Equivalent to::"
+"Returns an iterator of tuples, where the *i*-th tuple contains the *i*-th"
+" element from each of the argument sequences or iterables. The iterator "
+"stops when the shortest input iterable is exhausted. With a single "
+"iterable argument, it returns an iterator of 1-tuples. With no "
+"arguments, it returns an empty iterator. Equivalent to::"
msgstr ""
-#: ../Doc/library/functions.rst:1633
+#: ../Doc/library/functions.rst:1740
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)``. This repeats the *same* iterator ``n`` times "
-"so that each output tuple has the result of ``n`` calls to the iterator. "
-"This has the effect of dividing the input into n-length chunks."
+"makes possible an idiom for clustering a data series into n-length groups"
+" using ``zip(*[iter(s)]*n)``. This repeats the *same* iterator ``n`` "
+"times so that each output tuple has the result of ``n`` calls to the "
+"iterator. This has the effect of dividing the input into n-length chunks."
msgstr ""
-#: ../Doc/library/functions.rst:1639
+#: ../Doc/library/functions.rst:1746
msgid ""
-":func:`zip` 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:`itertools.zip_longest` instead."
+":func:`zip` 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:`itertools.zip_longest` instead."
msgstr ""
-#: ../Doc/library/functions.rst:1643
+#: ../Doc/library/functions.rst:1750
msgid ""
-":func:`zip` in conjunction with the ``*`` operator can be used to unzip a "
-"list::"
+":func:`zip` in conjunction with the ``*`` operator can be used to unzip a"
+" list::"
msgstr ""
-#: ../Doc/library/functions.rst:1664
+#: ../Doc/library/functions.rst:1771
msgid ""
"This is an advanced function that is not needed in everyday Python "
"programming, unlike :func:`importlib.import_module`."
msgstr ""
-#: ../Doc/library/functions.rst:1667
+#: ../Doc/library/functions.rst:1774
msgid ""
"This function is invoked by the :keyword:`import` statement. It can be "
"replaced (by importing the :mod:`builtins` module and assigning to "
-"``builtins.__import__``) in order to change semantics of the :keyword:`!"
-"import` statement, but doing so is **strongly** discouraged as it is usually "
-"simpler to use import hooks (see :pep:`302`) to attain the same goals and "
-"does not cause issues with code which assumes the default import "
-"implementation is in use. Direct use of :func:`__import__` is also "
-"discouraged in favor of :func:`importlib.import_module`."
+"``builtins.__import__``) in order to change semantics of the "
+":keyword:`!import` statement, but doing so is **strongly** discouraged as"
+" it is usually simpler to use import hooks (see :pep:`302`) to attain the"
+" same goals and does not cause issues with code which assumes the default"
+" import implementation is in use. Direct use of :func:`__import__` is "
+"also discouraged in favor of :func:`importlib.import_module`."
msgstr ""
-#: ../Doc/library/functions.rst:1676
+#: ../Doc/library/functions.rst:1783
msgid ""
"The function imports the module *name*, potentially using the given "
-"*globals* and *locals* to determine how to interpret the name in a package "
-"context. The *fromlist* gives the names of objects or submodules that should "
-"be imported from the module given by *name*. The standard implementation "
-"does not use its *locals* argument at all, and uses its *globals* only to "
-"determine the package context of the :keyword:`import` statement."
+"*globals* and *locals* to determine how to interpret the name in a "
+"package context. The *fromlist* gives the names of objects or submodules "
+"that should be imported from the module given by *name*. The standard "
+"implementation does not use its *locals* argument at all, and uses its "
+"*globals* only to determine the package context of the :keyword:`import` "
+"statement."
msgstr ""
-#: ../Doc/library/functions.rst:1683
+#: ../Doc/library/functions.rst:1790
msgid ""
-"*level* specifies whether to use absolute or relative imports. ``0`` (the "
-"default) means only perform absolute imports. Positive values for *level* "
-"indicate the number of parent directories to search relative to the "
-"directory of the module calling :func:`__import__` (see :pep:`328` for the "
-"details)."
+"*level* specifies whether to use absolute or relative imports. ``0`` (the"
+" default) means only perform absolute imports. Positive values for "
+"*level* indicate the number of parent directories to search relative to "
+"the directory of the module calling :func:`__import__` (see :pep:`328` "
+"for the details)."
msgstr ""
-#: ../Doc/library/functions.rst:1689
+#: ../Doc/library/functions.rst:1796
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 "
-"module named by *name*. However, when a non-empty *fromlist* argument is "
-"given, the module named by *name* is returned."
+"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 module named by *name*. However, when a non-empty *fromlist* "
+"argument is given, the module named by *name* is returned."
msgstr ""
-#: ../Doc/library/functions.rst:1694
+#: ../Doc/library/functions.rst:1801
msgid ""
-"For example, the statement ``import spam`` results in bytecode resembling "
-"the following code::"
+"For example, the statement ``import spam`` results in bytecode resembling"
+" the following code::"
msgstr ""
-#: ../Doc/library/functions.rst:1699
+#: ../Doc/library/functions.rst:1806
msgid "The statement ``import spam.ham`` results in this call::"
msgstr ""
-#: ../Doc/library/functions.rst:1703
+#: ../Doc/library/functions.rst:1810
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."
+"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 ""
-#: ../Doc/library/functions.rst:1706
+#: ../Doc/library/functions.rst:1813
msgid ""
"On the other hand, the statement ``from spam.ham import eggs, sausage as "
"saus`` results in ::"
msgstr ""
-#: ../Doc/library/functions.rst:1713
+#: ../Doc/library/functions.rst:1820
msgid ""
"Here, the ``spam.ham`` module is returned from :func:`__import__`. From "
"this object, the names to import are retrieved and assigned to their "
"respective names."
msgstr ""
-#: ../Doc/library/functions.rst:1717
+#: ../Doc/library/functions.rst:1824
msgid ""
"If you simply want to import a module (potentially within a package) by "
"name, use :func:`importlib.import_module`."
msgstr ""
-#: ../Doc/library/functions.rst:1720
+#: ../Doc/library/functions.rst:1827
msgid ""
-"Negative values for *level* are no longer supported (which also changes the "
-"default value to 0)."
+"Negative values for *level* are no longer supported (which also changes "
+"the default value to 0)."
msgstr ""
-#: ../Doc/library/functions.rst:1726
+#: ../Doc/library/functions.rst:1833
msgid "Footnotes"
msgstr ""
-#: ../Doc/library/functions.rst:1727
-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 newline conversion "
-"mode to convert Windows or Mac-style newlines."
-msgstr ""
+#: ../Doc/library/functions.rst:1834
+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 newline "
+"conversion mode to convert Windows or Mac-style newlines."
+msgstr ""
+
+#~ 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 "
+#~ "fails, but if it is false, calling"
+#~ " *object* will never succeed. Note "
+#~ "that classes are callable (calling a "
+#~ "class returns a new instance); instances"
+#~ " are callable if their class has "
+#~ "a :meth:`__call__` method."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The *expression* argument is parsed and"
+#~ " evaluated as a Python expression "
+#~ "(technically speaking, a condition list) "
+#~ "using the *globals* and *locals* "
+#~ "dictionaries as global and local "
+#~ "namespace. If the *globals* dictionary "
+#~ "is present and does not contain a"
+#~ " value for the key ``__builtins__``, "
+#~ "a reference to the dictionary of "
+#~ "the built-in module :mod:`builtins` is"
+#~ " inserted under that key before "
+#~ "*expression* is parsed. This means that"
+#~ " *expression* normally has full access "
+#~ "to the standard :mod:`builtins` module "
+#~ "and restricted environments are propagated."
+#~ " If the *locals* dictionary is "
+#~ "omitted it defaults to the *globals* "
+#~ "dictionary. If both dictionaries are "
+#~ "omitted, the expression is executed in"
+#~ " the environment where :func:`eval` is "
+#~ "called. The return value is the "
+#~ "result of the evaluated expression. "
+#~ "Syntax errors are reported as "
+#~ "exceptions. Example:"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "In all cases, if the optional "
+#~ "parts are omitted, the code is "
+#~ "executed in the current scope. If "
+#~ "only *globals* is provided, it must "
+#~ "be a dictionary, which will be "
+#~ "used for both the global and the"
+#~ " local variables. If *globals* and "
+#~ "*locals* are given, they are used "
+#~ "for the global and local variables, "
+#~ "respectively. If provided, *locals* can "
+#~ "be any mapping object. Remember that"
+#~ " at module level, globals and locals"
+#~ " are the same dictionary. If exec "
+#~ "gets two separate objects as *globals*"
+#~ " and *locals*, the code will be "
+#~ "executed as if it were embedded in"
+#~ " a class definition."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "For a general Python object ``x``, "
+#~ "``float(x)`` delegates to ``x.__float__()``."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Return an integer object constructed "
+#~ "from a number or string *x*, or"
+#~ " return ``0`` if no arguments are "
+#~ "given. If *x* defines :meth:`__int__`, "
+#~ "``int(x)`` returns ``x.__int__()``. If *x*"
+#~ " defines :meth:`__trunc__`, it returns "
+#~ "``x.__trunc__()``. For floating point numbers,"
+#~ " this truncates towards zero."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Return true if the *object* argument "
+#~ "is an instance of the *classinfo* "
+#~ "argument, or of a (direct, indirect "
+#~ "or :term:`virtual <abstract base class>`) "
+#~ "subclass thereof. If *object* is not"
+#~ " an object of the given type, "
+#~ "the function always returns false. If"
+#~ " *classinfo* is a tuple of type "
+#~ "objects (or recursively, other such "
+#~ "tuples), return true if *object* is "
+#~ "an instance of any of the types."
+#~ " If *classinfo* is not a type "
+#~ "or tuple of types and such tuples,"
+#~ " a :exc:`TypeError` exception is raised."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "Return true if *class* is a "
+#~ "subclass (direct, indirect or :term:`virtual"
+#~ " <abstract base class>`) of *classinfo*."
+#~ " A class is considered a subclass"
+#~ " of itself. *classinfo* may be a "
+#~ "tuple of class objects, in which "
+#~ "case every entry in *classinfo* will "
+#~ "be checked. In any other case, a"
+#~ " :exc:`TypeError` exception is raised."
+#~ msgstr ""
+
+#~ msgid "open a disk file for updating (reading and writing)"
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The default mode is ``'r'`` (open "
+#~ "for reading text, synonym of ``'rt'``)."
+#~ " For binary read-write access, the"
+#~ " mode ``'w+b'`` opens and truncates "
+#~ "the file to 0 bytes. ``'r+b'`` "
+#~ "opens the file without truncation."
+#~ msgstr ""
+
+#~ 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-argument form ``pow(x, "
+#~ "y)`` is equivalent to using the "
+#~ "power operator: ``x**y``."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The arguments must have numeric types."
+#~ " With mixed operand types, the "
+#~ "coercion rules for binary arithmetic "
+#~ "operators apply. For :class:`int` operands,"
+#~ " the result has the same type "
+#~ "as the operands (after coercion) unless"
+#~ " the second argument is negative; in"
+#~ " that case, all arguments are "
+#~ "converted to float and a float "
+#~ "result is delivered. For example, "
+#~ "``10**2`` returns ``100``, but ``10**-2`` "
+#~ "returns ``0.01``. If the second "
+#~ "argument is negative, the third argument"
+#~ " must be omitted. If *z* is "
+#~ "present, *x* and *y* must be of"
+#~ " integer types, and *y* must be "
+#~ "non-negative."
+#~ msgstr ""
+
+#~ 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 numbers, and the start value"
+#~ " is not allowed to be a string."
+#~ msgstr ""
+
+#~ 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 been overridden in a "
+#~ "class. The search order is same as"
+#~ " that used by :func:`getattr` except "
+#~ "that the *type* itself is skipped."
+#~ msgstr ""
+
+#~ msgid ""
+#~ "The :attr:`~class.__mro__` attribute of the"
+#~ " *type* lists the method resolution "
+#~ "search order used by both "
+#~ ":func:`getattr` and :func:`super`. The "
+#~ "attribute is dynamic and can change "
+#~ "whenever the inheritance hierarchy is "
+#~ "updated."
+#~ msgstr ""
+
From f4880e7e03ea82436a2cceea1d7f5449fef3dc69 Mon Sep 17 00:00:00 2001
From: Manuel Kaufmann <humitos@gmail.com>
Date: Thu, 7 May 2020 14:49:29 +0200
Subject: [PATCH 09/11] Wrapped :)
---
library/functions.po | 1771 ++++++++++++++++++------------------------
1 file changed, 770 insertions(+), 1001 deletions(-)
diff --git a/library/functions.po b/library/functions.po
index 51a6601c20..5006b2a381 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -21,8 +21,7 @@ msgstr ""
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.8.0\n"
-#: ../Doc/library/functions.rst:5
-#: ../Doc/library/functions.rst:11
+#: ../Doc/library/functions.rst:5 ../Doc/library/functions.rst:11
msgid "Built-in Functions"
msgstr "Funciones Built-in"
@@ -31,9 +30,8 @@ msgid ""
"The Python interpreter has a number of functions and types built into it "
"that are always available. They are listed here in alphabetical order."
msgstr ""
-"El intérprete de Python tiene una serie de funciones y tipos incluidos en"
-" él que están siempre disponibles. Están listados aquí en orden "
-"alfabético."
+"El intérprete de Python tiene una serie de funciones y tipos incluidos en él "
+"que están siempre disponibles. Están listados aquí en orden alfabético."
#: ../Doc/library/functions.rst:13
msgid ":func:`abs`"
@@ -314,42 +312,42 @@ msgstr ""
#: ../Doc/library/functions.rst:45
#, fuzzy
msgid ""
-"Return the absolute value of a number. The argument may be an integer or"
-" a floating point number. If the argument is a complex number, its "
-"magnitude is returned. If *x* defines :meth:`__abs__`, ``abs(x)`` returns"
-" ``x.__abs__()``."
+"Return the absolute value of a number. The argument may be an integer or a "
+"floating point number. If the argument is a complex number, its magnitude "
+"is returned. If *x* defines :meth:`__abs__`, ``abs(x)`` returns ``x."
+"__abs__()``."
msgstr ""
-"Devuelve el valor absoluto de un número. El argumento puede ser un número"
-" entero o de punto flotante. Si el argumento es un número complejo, "
-"devuelve su magnitud."
+"Devuelve el valor absoluto de un número. El argumento puede ser un número "
+"entero o de punto flotante. Si el argumento es un número complejo, devuelve "
+"su magnitud."
#: ../Doc/library/functions.rst:53
msgid ""
"Return ``True`` if all elements of the *iterable* are true (or if the "
"iterable is empty). Equivalent to::"
msgstr ""
-"Devuelve ``True`` si todos los elementos del *iterable* son verdaderos "
-"(o si el iterable está vacío). Equivalente a::"
+"Devuelve ``True`` si todos los elementos del *iterable* son verdaderos (o "
+"si el iterable está vacío). Equivalente a::"
#: ../Doc/library/functions.rst:65
msgid ""
-"Return ``True`` if any element of the *iterable* is true. If the "
-"iterable is empty, return ``False``. Equivalent to::"
+"Return ``True`` if any element of the *iterable* is true. If the iterable "
+"is empty, return ``False``. Equivalent to::"
msgstr ""
-"Devuelve ``True`` si un elemento cualquiera del *iterable* es verdadero."
-" Si el iteradle está vacío, devuelve ``False``. Equivalente a::"
+"Devuelve ``True`` si un elemento cualquiera del *iterable* es verdadero. Si "
+"el iteradle está vacío, devuelve ``False``. Equivalente a::"
#: ../Doc/library/functions.rst:77
msgid ""
-"As :func:`repr`, return a string containing a printable representation of"
-" an object, but escape the non-ASCII characters in the string returned by"
-" :func:`repr` using ``\\x``, ``\\u`` or ``\\U`` escapes. This generates "
-"a string similar to that returned by :func:`repr` in Python 2."
+"As :func:`repr`, return a string containing a printable representation of an "
+"object, but escape the non-ASCII characters in the string returned by :func:"
+"`repr` using ``\\x``, ``\\u`` or ``\\U`` escapes. This generates a string "
+"similar to that returned by :func:`repr` in Python 2."
msgstr ""
"Como :func:`repr`, devuelve una cadena que contiene una representación "
-"imprimible de un objeto, pero que escapa los caracteres no-ASCII que "
-":func:`repr` devuelve usando ``\\x``, ``\\u`` or ``\\U``. Esto genera "
-"una cadena similar a la devuelta por :func:`repr` en Python 2."
+"imprimible de un objeto, pero que escapa los caracteres no-ASCII que :func:"
+"`repr` devuelve usando ``\\x``, ``\\u`` or ``\\U``. Esto genera una cadena "
+"similar a la devuelta por :func:`repr` en Python 2."
#: ../Doc/library/functions.rst:85
msgid ""
@@ -360,67 +358,62 @@ msgid ""
msgstr ""
"Convierte un número entero a una cadena binaria con prefijo \"0b\". El "
"resultado es una expresión de Python válida. Si *x* no es un objeto de "
-"clase :class:`int` en Python, tiene que definir un método "
-":meth:`__index__` que devuelva un entero. Algunos ejemplos:"
+"clase :class:`int` en Python, tiene que definir un método :meth:"
+"`__index__` que devuelva un entero. Algunos ejemplos:"
#: ../Doc/library/functions.rst:95
msgid ""
-"If prefix \"0b\" is desired or not, you can use either of the following "
-"ways."
+"If prefix \"0b\" is desired or not, you can use either of the following ways."
msgstr ""
"Según se desee o no el prefijo \"0b\", se puede usar uno u otro de las "
"siguientes maneras."
-#: ../Doc/library/functions.rst:102
-#: ../Doc/library/functions.rst:750
+#: ../Doc/library/functions.rst:102 ../Doc/library/functions.rst:750
#: ../Doc/library/functions.rst:1030
msgid "See also :func:`format` for more information."
msgstr "Veáse también :func:`format` para más información."
#: ../Doc/library/functions.rst:107
msgid ""
-"Return a Boolean value, i.e. one of ``True`` or ``False``. *x* is "
-"converted using the standard :ref:`truth testing procedure <truth>`. If "
-"*x* is false or omitted, this returns ``False``; otherwise it returns "
-"``True``. The :class:`bool` class is a subclass of :class:`int` (see "
-":ref:`typesnumeric`). It cannot be subclassed further. Its only "
-"instances are ``False`` and ``True`` (see :ref:`bltin-boolean-values`)."
+"Return a Boolean value, i.e. one of ``True`` or ``False``. *x* is converted "
+"using the standard :ref:`truth testing procedure <truth>`. If *x* is false "
+"or omitted, this returns ``False``; otherwise it returns ``True``. The :"
+"class:`bool` class is a subclass of :class:`int` (see :ref:`typesnumeric`). "
+"It cannot be subclassed further. Its only instances are ``False`` and "
+"``True`` (see :ref:`bltin-boolean-values`)."
msgstr ""
"Devuelve un booleano, es decir, o bien ``True`` o ``False``. *x* es "
-"convertido usando el estándar :ref:`truth testing procedure <truth>`. Si "
-"*x* es falso u omitido, devuelve ``False``; en caso contrario devuelve "
-"``True``. La clase :class:`bool` es una subclase de :class:`int` (véase"
-" :ref:`typesnumeric`). De ella no pueden derivarse más subclases. Sus "
-"únicas instancias son ``False`` y ``True`` (véase :ref:`bltin-boolean-"
-"values`)."
-
-#: ../Doc/library/functions.rst:116
-#: ../Doc/library/functions.rst:625
+"convertido usando el estándar :ref:`truth testing procedure <truth>`. Si *x* "
+"es falso u omitido, devuelve ``False``; en caso contrario devuelve "
+"``True``. La clase :class:`bool` es una subclase de :class:`int` (véase :"
+"ref:`typesnumeric`). De ella no pueden derivarse más subclases. Sus únicas "
+"instancias son ``False`` y ``True`` (véase :ref:`bltin-boolean-values`)."
+
+#: ../Doc/library/functions.rst:116 ../Doc/library/functions.rst:625
#: ../Doc/library/functions.rst:832
msgid "*x* is now a positional-only parameter."
msgstr "*x* es ahora un argumento solo de posición."
#: ../Doc/library/functions.rst:121
msgid ""
-"This function drops you into the debugger at the call site. "
-"Specifically, it calls :func:`sys.breakpointhook`, passing ``args`` and "
-"``kws`` straight through. By default, ``sys.breakpointhook()`` calls "
-":func:`pdb.set_trace()` expecting no arguments. In this case, it is "
-"purely a convenience function so you don't have to explicitly import "
-":mod:`pdb` or type as much code to enter the debugger. However, "
-":func:`sys.breakpointhook` can be set to some other function and "
-":func:`breakpoint` will automatically call that, allowing you to drop "
-"into the debugger of choice."
-msgstr ""
-"Esta función te lleva al depurador en el sitio donde se produce la "
-"llamada. Específicamente, llama a :func:`sys.breakpointhook`, pasando "
-"``args`` y ``kws`` directamente. Por defecto, ``sys.breakpointhook()`` "
-"llama a :func:`pdb.set_trace()` sin esperar argumentos. En este caso, es"
-" puramente una función de conveniencia para evitar el importe explícito "
-"de :mod:`pdb` o tener que escribir tanto código para entrar al depurador."
-" Sin embargo, :func:`sys.breakpointhook` puede ser configurado a otra "
-"función y :func:`breakpoint` llamará automáticamente a esta, permitiendo "
-"entrar al depurador elegido."
+"This function drops you into the debugger at the call site. Specifically, "
+"it calls :func:`sys.breakpointhook`, passing ``args`` and ``kws`` straight "
+"through. By default, ``sys.breakpointhook()`` calls :func:`pdb.set_trace()` "
+"expecting no arguments. In this case, it is purely a convenience function "
+"so you don't have to explicitly import :mod:`pdb` or type as much code to "
+"enter the debugger. However, :func:`sys.breakpointhook` can be set to some "
+"other function and :func:`breakpoint` will automatically call that, allowing "
+"you to drop into the debugger of choice."
+msgstr ""
+"Esta función te lleva al depurador en el sitio donde se produce la llamada. "
+"Específicamente, llama a :func:`sys.breakpointhook`, pasando ``args`` y "
+"``kws`` directamente. Por defecto, ``sys.breakpointhook()`` llama a :func:"
+"`pdb.set_trace()` sin esperar argumentos. En este caso, es puramente una "
+"función de conveniencia para evitar el importe explícito de :mod:`pdb` o "
+"tener que escribir tanto código para entrar al depurador. Sin embargo, :func:"
+"`sys.breakpointhook` puede ser configurado a otra función y :func:"
+"`breakpoint` llamará automáticamente a esta, permitiendo entrar al depurador "
+"elegido."
#: ../Doc/library/functions.rst:132
msgid ""
@@ -431,41 +424,40 @@ msgstr ""
#: ../Doc/library/functions.rst:139
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"
-" methods of mutable sequences, described in :ref:`typesseq-mutable`, as "
-"well as most methods that the :class:`bytes` type has, see :ref:`bytes-"
-"methods`."
+"sequence of integers in the range 0 <= x < 256. It has most of the usual "
+"methods of mutable sequences, described in :ref:`typesseq-mutable`, as well "
+"as most methods that the :class:`bytes` type has, see :ref:`bytes-methods`."
msgstr ""
#: ../Doc/library/functions.rst:144
msgid ""
-"The optional *source* parameter can be used to initialize the array in a "
-"few different ways:"
+"The optional *source* parameter can be used to initialize the array in a few "
+"different ways:"
msgstr ""
#: ../Doc/library/functions.rst:147
msgid ""
"If it is a *string*, you must also give the *encoding* (and optionally, "
-"*errors*) parameters; :func:`bytearray` then converts the string to bytes"
-" using :meth:`str.encode`."
+"*errors*) parameters; :func:`bytearray` then converts the string to bytes "
+"using :meth:`str.encode`."
msgstr ""
#: ../Doc/library/functions.rst:151
msgid ""
-"If it is an *integer*, the array will have that size and will be "
-"initialized with null bytes."
+"If it is an *integer*, the array will have that size and will be initialized "
+"with null bytes."
msgstr ""
#: ../Doc/library/functions.rst:154
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."
+"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 ""
#: ../Doc/library/functions.rst:157
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."
+"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 ""
#: ../Doc/library/functions.rst:160
@@ -478,16 +470,15 @@ msgstr ""
#: ../Doc/library/functions.rst:169
msgid ""
-"Return a new \"bytes\" object, which is an immutable sequence of integers"
-" in the range ``0 <= x < 256``. :class:`bytes` is an immutable version "
-"of :class:`bytearray` -- it has the same non-mutating methods and the "
-"same indexing and slicing behavior."
+"Return a new \"bytes\" object, which is an immutable sequence of integers in "
+"the range ``0 <= x < 256``. :class:`bytes` is an immutable version of :"
+"class:`bytearray` -- it has the same non-mutating methods and the same "
+"indexing and slicing behavior."
msgstr ""
#: ../Doc/library/functions.rst:174
msgid ""
-"Accordingly, constructor arguments are interpreted as for "
-":func:`bytearray`."
+"Accordingly, constructor arguments are interpreted as for :func:`bytearray`."
msgstr ""
#: ../Doc/library/functions.rst:176
@@ -500,12 +491,11 @@ msgstr ""
#: ../Doc/library/functions.rst:183
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 fails, but if it is ``False``, calling *object* will never "
-"succeed. Note that classes are callable (calling a class returns a new "
-"instance); instances are callable if their class has a :meth:`__call__` "
-"method."
+"Return :const:`True` if the *object* argument appears callable, :const:"
+"`False` if not. If this returns ``True``, it is still possible that a call "
+"fails, but if it is ``False``, calling *object* will never succeed. Note "
+"that classes are callable (calling a class returns a new instance); "
+"instances are callable if their class has a :meth:`__call__` method."
msgstr ""
#: ../Doc/library/functions.rst:189
@@ -516,17 +506,15 @@ msgstr ""
#: ../Doc/library/functions.rst:196
msgid ""
-"Return the string representing a character whose Unicode code point is "
-"the integer *i*. For example, ``chr(97)`` returns the string ``'a'``, "
-"while ``chr(8364)`` returns the string ``'€'``. This is the inverse of "
-":func:`ord`."
+"Return the string representing a character whose Unicode code point is the "
+"integer *i*. For example, ``chr(97)`` returns the string ``'a'``, while "
+"``chr(8364)`` returns the string ``'€'``. This is the inverse of :func:`ord`."
msgstr ""
#: ../Doc/library/functions.rst:200
msgid ""
-"The valid range for the argument is from 0 through 1,114,111 (0x10FFFF in"
-" base 16). :exc:`ValueError` will be raised if *i* is outside that "
-"range."
+"The valid range for the argument is from 0 through 1,114,111 (0x10FFFF in "
+"base 16). :exc:`ValueError` will be raised if *i* is outside that range."
msgstr ""
#: ../Doc/library/functions.rst:206
@@ -535,23 +523,23 @@ msgstr ""
#: ../Doc/library/functions.rst:208
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::"
+"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 ""
#: ../Doc/library/functions.rst:216
msgid ""
-"The ``@classmethod`` form is a function :term:`decorator` -- see "
-":ref:`function` for details."
+"The ``@classmethod`` form is a function :term:`decorator` -- see :ref:"
+"`function` for details."
msgstr ""
#: ../Doc/library/functions.rst:219
msgid ""
-"A class method 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 class method is called for a derived class, the derived "
-"class object is passed as the implied first argument."
+"A class method 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 class method is called for a derived class, the derived class "
+"object is passed as the implied first argument."
msgstr ""
#: ../Doc/library/functions.rst:224
@@ -567,78 +555,77 @@ msgstr ""
#: ../Doc/library/functions.rst:232
msgid ""
"Compile the *source* into a code or AST object. Code objects can be "
-"executed by :func:`exec` or :func:`eval`. *source* can either be a "
-"normal string, a byte string, or an AST object. Refer to the :mod:`ast` "
-"module documentation for information on how to work with AST objects."
+"executed by :func:`exec` or :func:`eval`. *source* can either be a normal "
+"string, a byte string, or an AST object. Refer to the :mod:`ast` module "
+"documentation for information on how to work with AST objects."
msgstr ""
#: ../Doc/library/functions.rst:237
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 "
-"(``'<string>'`` is commonly used)."
+"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 (``'<string>'`` "
+"is commonly used)."
msgstr ""
#: ../Doc/library/functions.rst:241
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 it consists of a single expression, or ``'single'`` if it "
-"consists of a single interactive statement (in the latter case, "
-"expression statements that evaluate to something other than ``None`` will"
-" be printed)."
+"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 "
+"it consists of a single expression, or ``'single'`` if it consists of a "
+"single interactive statement (in the latter case, expression statements that "
+"evaluate to something other than ``None`` will be printed)."
msgstr ""
#: ../Doc/library/functions.rst:247
msgid ""
-"The optional arguments *flags* and *dont_inherit* control which "
-":ref:`future statements <future>` affect the compilation of *source*. If"
-" neither is present (or both are zero) the code is compiled with those "
-"future statements that are in effect in the code that is calling "
-":func:`compile`. If the *flags* argument is given and *dont_inherit* is "
-"not (or is zero) then the future statements specified by the *flags* "
-"argument are used in addition to those that would be used anyway. If "
-"*dont_inherit* is a non-zero integer then the *flags* argument is it -- "
-"the future statements in effect around the call to compile are ignored."
+"The optional arguments *flags* and *dont_inherit* control which :ref:`future "
+"statements <future>` affect the compilation of *source*. If neither is "
+"present (or both are zero) the code is compiled with those future statements "
+"that are in effect in the code that is calling :func:`compile`. If the "
+"*flags* argument is given and *dont_inherit* is not (or is zero) then the "
+"future statements specified by the *flags* argument are used in addition to "
+"those that would be used anyway. If *dont_inherit* is a non-zero integer "
+"then the *flags* argument is it -- the future statements in effect around "
+"the call to compile are ignored."
msgstr ""
#: ../Doc/library/functions.rst:257
msgid ""
-"Future statements are specified by bits which can be bitwise ORed "
-"together to specify multiple statements. The bitfield required to "
-"specify a given feature can be found as the "
-":attr:`~__future__._Feature.compiler_flag` attribute on the "
-":class:`~__future__._Feature` instance in the :mod:`__future__` module."
+"Future statements are specified by bits which can be bitwise ORed together "
+"to specify multiple statements. The bitfield required to specify a given "
+"feature can be found as the :attr:`~__future__._Feature.compiler_flag` "
+"attribute on the :class:`~__future__._Feature` instance in the :mod:"
+"`__future__` module."
msgstr ""
#: ../Doc/library/functions.rst:262
msgid ""
-"The optional argument *flags* also controls whether the compiled source "
-"is allowed to contain top-level ``await``, ``async for`` and ``async "
-"with``. When the bit ``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` is set, the "
-"return code object has ``CO_COROUTINE`` set in ``co_code``, and can be "
-"interactively executed via ``await eval(code_object)``."
+"The optional argument *flags* also controls whether the compiled source is "
+"allowed to contain top-level ``await``, ``async for`` and ``async with``. "
+"When the bit ``ast.PyCF_ALLOW_TOP_LEVEL_AWAIT`` is set, the return code "
+"object has ``CO_COROUTINE`` set in ``co_code``, and can be interactively "
+"executed via ``await eval(code_object)``."
msgstr ""
#: ../Doc/library/functions.rst:268
msgid ""
-"The argument *optimize* specifies the optimization level of the compiler;"
-" the default value of ``-1`` selects the optimization level of the "
-"interpreter as given by :option:`-O` options. Explicit levels are ``0`` "
-"(no optimization; ``__debug__`` is true), ``1`` (asserts are removed, "
+"The argument *optimize* specifies the optimization level of the compiler; "
+"the default value of ``-1`` selects the optimization level of the "
+"interpreter as given by :option:`-O` options. Explicit levels are ``0`` (no "
+"optimization; ``__debug__`` is true), ``1`` (asserts are removed, "
"``__debug__`` is false) or ``2`` (docstrings are removed too)."
msgstr ""
#: ../Doc/library/functions.rst:274
msgid ""
-"This function raises :exc:`SyntaxError` if the compiled source is "
-"invalid, and :exc:`ValueError` if the source contains null bytes."
+"This function raises :exc:`SyntaxError` if the compiled source is invalid, "
+"and :exc:`ValueError` if the source contains null bytes."
msgstr ""
#: ../Doc/library/functions.rst:277
msgid ""
-"If you want to parse Python code into its AST representation, see "
-":func:`ast.parse`."
+"If you want to parse Python code into its AST representation, see :func:`ast."
+"parse`."
msgstr ""
msgid ""
@@ -655,30 +642,29 @@ msgstr ""
#: ../Doc/library/functions.rst:288
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 to facilitate detection of incomplete and complete "
-"statements in the :mod:`code` module."
+"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 "
+"to facilitate detection of incomplete and complete statements in the :mod:"
+"`code` module."
msgstr ""
#: ../Doc/library/functions.rst:295
msgid ""
-"It is possible to crash the Python interpreter with a sufficiently "
-"large/complex string when compiling to an AST object due to stack depth "
+"It is possible to crash the Python interpreter with a sufficiently large/"
+"complex string when compiling to an AST object due to stack depth "
"limitations in Python's AST compiler."
msgstr ""
#: ../Doc/library/functions.rst:299
msgid ""
-"Allowed use of Windows and Mac newlines. Also input in ``'exec'`` mode "
-"does not have to end in a newline anymore. Added the *optimize* "
-"parameter."
+"Allowed use of Windows and Mac newlines. Also input in ``'exec'`` mode does "
+"not have to end in a newline anymore. Added the *optimize* parameter."
msgstr ""
#: ../Doc/library/functions.rst:303
msgid ""
-"Previously, :exc:`TypeError` was raised when null bytes were encountered "
-"in *source*."
+"Previously, :exc:`TypeError` was raised when null bytes were encountered in "
+"*source*."
msgstr ""
#: ../Doc/library/functions.rst:307
@@ -690,67 +676,63 @@ msgstr ""
#: ../Doc/library/functions.rst:314
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. Each argument may be any numeric type (including complex). If "
-"*imag* is omitted, it defaults to zero and the constructor serves as a "
-"numeric conversion like :class:`int` and :class:`float`. If both "
-"arguments are omitted, returns ``0j``."
+"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. "
+"Each argument may be any numeric type (including complex). If *imag* is "
+"omitted, it defaults to zero and the constructor serves as a numeric "
+"conversion like :class:`int` and :class:`float`. If both arguments are "
+"omitted, returns ``0j``."
msgstr ""
#: ../Doc/library/functions.rst:323
msgid ""
-"For a general Python object ``x``, ``complex(x)`` delegates to "
-"``x.__complex__()``. If ``__complex__()`` is not defined then it falls "
-"back to :meth:`__float__`. If ``__float__()`` is not defined then it "
-"falls back to :meth:`__index__`."
+"For a general Python object ``x``, ``complex(x)`` delegates to ``x."
+"__complex__()``. If ``__complex__()`` is not defined then it falls back to :"
+"meth:`__float__`. If ``__float__()`` is not defined then it falls back to :"
+"meth:`__index__`."
msgstr ""
#: ../Doc/library/functions.rst:330
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`."
+"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 ""
#: ../Doc/library/functions.rst:335
msgid "The complex type is described in :ref:`typesnumeric`."
msgstr ""
-#: ../Doc/library/functions.rst:337
-#: ../Doc/library/functions.rst:622
+#: ../Doc/library/functions.rst:337 ../Doc/library/functions.rst:622
#: ../Doc/library/functions.rst:829
msgid "Grouping digits with underscores as in code literals is allowed."
msgstr ""
#: ../Doc/library/functions.rst:340
msgid ""
-"Falls back to :meth:`__index__` if :meth:`__complex__` and "
-":meth:`__float__` are not defined."
+"Falls back to :meth:`__index__` if :meth:`__complex__` and :meth:`__float__` "
+"are not defined."
msgstr ""
#: ../Doc/library/functions.rst:347
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 function deletes the named attribute, provided the object allows "
-"it. For example, ``delattr(x, 'foobar')`` is equivalent to ``del "
-"x.foobar``."
+"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 "
+"function deletes the named attribute, provided the object allows it. For "
+"example, ``delattr(x, 'foobar')`` is equivalent to ``del x.foobar``."
msgstr ""
#: ../Doc/library/functions.rst:359
msgid ""
-"Create a new dictionary. The :class:`dict` object is the dictionary "
-"class. See :class:`dict` and :ref:`typesmapping` for documentation about "
-"this class."
+"Create a new dictionary. The :class:`dict` object is the dictionary class. "
+"See :class:`dict` and :ref:`typesmapping` for documentation about this class."
msgstr ""
#: ../Doc/library/functions.rst:362
msgid ""
-"For other containers see the built-in :class:`list`, :class:`set`, and "
-":class:`tuple` classes, as well as the :mod:`collections` module."
+"For other containers see the built-in :class:`list`, :class:`set`, and :"
+"class:`tuple` classes, as well as the :mod:`collections` module."
msgstr ""
#: ../Doc/library/functions.rst:368
@@ -760,41 +742,40 @@ msgid ""
"object."
msgstr ""
"Sin argumentos, devuelve la lista de nombres en el ámbito local. Con un "
-"argumento, intenta devolver una lista de atributos válidos para ese "
-"objeto."
+"argumento, intenta devolver una lista de atributos válidos para ese objeto."
#: ../Doc/library/functions.rst:371
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 custom :func:`__getattr__` or :func:`__getattribute__` "
-"function to customize the way :func:`dir` reports their attributes."
+"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 "
+"custom :func:`__getattr__` or :func:`__getattribute__` function to customize "
+"the way :func:`dir` reports their attributes."
msgstr ""
-"Si el objeto tiene un método llamado :meth:`__dir__`, éste será llamado y"
-" debe devolver la lista de atributos. Esto permite que los objetos que "
-"implementan una función personalizada :func:`__getattr__` o "
-":func:`__getattribute__` puedan decidir la manera en la que :func:`dir` "
-"reporta sus atributos."
+"Si el objeto tiene un método llamado :meth:`__dir__`, éste será llamado y "
+"debe devolver la lista de atributos. Esto permite que los objetos que "
+"implementan una función personalizada :func:`__getattr__` o :func:"
+"`__getattribute__` puedan decidir la manera en la que :func:`dir` reporta "
+"sus atributos."
#: ../Doc/library/functions.rst:376
msgid ""
-"If the object does not provide :meth:`__dir__`, the function tries its "
-"best to gather information from the object's :attr:`~object.__dict__` "
-"attribute, if defined, and from its type object. The resulting list is "
-"not necessarily complete, and may be inaccurate when the object has a "
-"custom :func:`__getattr__`."
+"If the object does not provide :meth:`__dir__`, the function tries its best "
+"to gather information from the object's :attr:`~object.__dict__` attribute, "
+"if defined, and from its type object. The resulting list is not necessarily "
+"complete, and may be inaccurate when the object has a custom :func:"
+"`__getattr__`."
msgstr ""
"Si el objeto no provee de un método :meth:`__dir__`, la función intenta "
-"obtener la información del atributo :attr:`~object.__dict__` del objeto,"
-" si está definido, y de su objeto type. La lista resultante no está "
+"obtener la información del atributo :attr:`~object.__dict__` del objeto, si "
+"está definido, y de su objeto type. La lista resultante no está "
"necesariamente completa, y puede ser inexacta cuando el objeto tiene una "
"función :func:`__getattr__` implementada."
#: ../Doc/library/functions.rst:381
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:"
+"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 ""
#: ../Doc/library/functions.rst:385
@@ -805,15 +786,15 @@ msgstr ""
#: ../Doc/library/functions.rst:388
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."
+"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 ""
#: ../Doc/library/functions.rst:391
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."
+"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 ""
#: ../Doc/library/functions.rst:395
@@ -823,32 +804,31 @@ msgstr ""
#: ../Doc/library/functions.rst:414
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 it tries to supply a rigorously or consistently defined set of "
-"names, and its detailed behavior may change across releases. For "
-"example, metaclass attributes are not in the result list when the "
-"argument is a class."
+"interactive prompt, it tries to supply an interesting set of names more than "
+"it tries to supply a rigorously or consistently defined set of names, and "
+"its detailed behavior may change across releases. For example, metaclass "
+"attributes are not in the result list when the argument is a class."
msgstr ""
#: ../Doc/library/functions.rst:424
msgid ""
"Take two (non complex) numbers as arguments and return a pair of numbers "
"consisting of their quotient and remainder when using integer division. "
-"With mixed operand types, the rules for binary arithmetic operators "
-"apply. For integers, the result is the same as ``(a // b, a % b)``. For "
-"floating point numbers the result is ``(q, a % b)``, where *q* is usually"
-" ``math.floor(a / b)`` but may be 1 less than that. In any case ``q * b "
-"+ a % b`` is very close to *a*, if ``a % b`` is non-zero it has the same "
-"sign as *b*, and ``0 <= abs(a % b) < abs(b)``."
+"With mixed operand types, the rules for binary arithmetic operators apply. "
+"For integers, the result is the same as ``(a // b, a % b)``. For floating "
+"point numbers the result is ``(q, a % b)``, where *q* is usually ``math."
+"floor(a / b)`` but may be 1 less than that. In any case ``q * b + a % b`` "
+"is very close to *a*, if ``a % b`` is non-zero it has the same sign as *b*, "
+"and ``0 <= abs(a % b) < abs(b)``."
msgstr ""
#: ../Doc/library/functions.rst:436
msgid ""
-"Return an enumerate object. *iterable* must be a sequence, an "
-":term:`iterator`, or some other object which supports iteration. The "
-":meth:`~iterator.__next__` method of the iterator returned by "
-":func:`enumerate` returns a tuple containing a count (from *start* which "
-"defaults to 0) and the values obtained from iterating over *iterable*."
+"Return an enumerate object. *iterable* must be a sequence, an :term:"
+"`iterator`, or some other object which supports iteration. The :meth:"
+"`~iterator.__next__` method of the iterator returned by :func:`enumerate` "
+"returns a tuple containing a count (from *start* which defaults to 0) and "
+"the values obtained from iterating over *iterable*."
msgstr ""
#: ../Doc/library/functions.rst:448
@@ -857,55 +837,54 @@ msgstr ""
#: ../Doc/library/functions.rst:459
msgid ""
-"The arguments are a string and optional globals and locals. If provided,"
-" *globals* must be a dictionary. If provided, *locals* can be any "
-"mapping object."
+"The arguments are a string and optional globals and locals. If provided, "
+"*globals* must be a dictionary. If provided, *locals* can be any mapping "
+"object."
msgstr ""
#: ../Doc/library/functions.rst:463
msgid ""
"The *expression* argument is parsed and evaluated as a Python expression "
-"(technically speaking, a condition list) using the *globals* and *locals*"
-" dictionaries as global and local namespace. If the *globals* dictionary"
-" is present and does not contain a value for the key ``__builtins__``, a "
+"(technically speaking, a condition list) using the *globals* and *locals* "
+"dictionaries as global and local namespace. If the *globals* dictionary is "
+"present and does not contain a value for the key ``__builtins__``, a "
"reference to the dictionary of the built-in module :mod:`builtins` is "
"inserted under that key before *expression* is parsed. This means that "
-"*expression* normally has full access to the standard :mod:`builtins` "
-"module and restricted environments are propagated. If the *locals* "
-"dictionary is omitted it defaults to the *globals* dictionary. If both "
-"dictionaries are omitted, the expression is executed with the *globals* "
-"and *locals* in the environment where :func:`eval` is called. Note, "
-"*eval()* does not have access to the :term:`nested scopes <nested scope>`"
-" (non-locals) in the enclosing environment."
+"*expression* normally has full access to the standard :mod:`builtins` module "
+"and restricted environments are propagated. If the *locals* dictionary is "
+"omitted it defaults to the *globals* dictionary. If both dictionaries are "
+"omitted, the expression is executed with the *globals* and *locals* in the "
+"environment where :func:`eval` is called. Note, *eval()* does not have "
+"access to the :term:`nested scopes <nested scope>` (non-locals) in the "
+"enclosing environment."
msgstr ""
#: ../Doc/library/functions.rst:477
msgid ""
-"The return value is the result of the evaluated expression. Syntax errors"
-" are reported as exceptions. Example:"
+"The return value is the result of the evaluated expression. Syntax errors "
+"are reported as exceptions. Example:"
msgstr ""
#: ../Doc/library/functions.rst:484
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 of a string. If the code object has been compiled with "
-"``'exec'`` as the *mode* argument, :func:`eval`\\'s return value will be "
-"``None``."
+"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 "
+"of a string. If the code object has been compiled with ``'exec'`` as the "
+"*mode* argument, :func:`eval`\\'s return value will be ``None``."
msgstr ""
#: ../Doc/library/functions.rst:489
msgid ""
"Hints: dynamic execution of statements is supported by the :func:`exec` "
"function. The :func:`globals` and :func:`locals` functions returns the "
-"current global and local dictionary, respectively, which may be useful to"
-" pass around for use by :func:`eval` or :func:`exec`."
+"current global and local dictionary, respectively, which may be useful to "
+"pass around for use by :func:`eval` or :func:`exec`."
msgstr ""
#: ../Doc/library/functions.rst:494
msgid ""
-"See :func:`ast.literal_eval` for a function that can safely evaluate "
-"strings with expressions containing only literals."
+"See :func:`ast.literal_eval` for a function that can safely evaluate strings "
+"with expressions containing only literals."
msgstr ""
msgid ""
@@ -913,79 +892,77 @@ msgid ""
"``code_object``."
msgstr ""
-#: ../Doc/library/functions.rst:499
-#: ../Doc/library/functions.rst:534
+#: ../Doc/library/functions.rst:499 ../Doc/library/functions.rst:534
msgid ""
-"Raises an :ref:`auditing event <auditing>` ``exec`` with the code object "
-"as the argument. Code compilation events may also be raised."
+"Raises an :ref:`auditing event <auditing>` ``exec`` with the code object as "
+"the argument. Code compilation events may also be raised."
msgstr ""
#: ../Doc/library/functions.rst:506
msgid ""
-"This function supports dynamic execution of Python code. *object* must be"
-" either a string or a code object. If it is a string, the string is "
-"parsed as a suite of Python statements which is then executed (unless a "
-"syntax error occurs). [#]_ If it is a code object, it is simply executed."
-" In all cases, the code that's executed is expected to be valid as file "
-"input (see the section \"File input\" in the Reference Manual). Be aware "
-"that the :keyword:`return` and :keyword:`yield` statements may not be "
-"used outside of function definitions even within the context of code "
-"passed to the :func:`exec` function. The return value is ``None``."
+"This function supports dynamic execution of Python code. *object* must be "
+"either a string or a code object. If it is a string, the string is parsed "
+"as a suite of Python statements which is then executed (unless a syntax "
+"error occurs). [#]_ If it is a code object, it is simply executed. In all "
+"cases, the code that's executed is expected to be valid as file input (see "
+"the section \"File input\" in the Reference Manual). Be aware that the :"
+"keyword:`return` and :keyword:`yield` statements may not be used outside of "
+"function definitions even within the context of code passed to the :func:"
+"`exec` function. The return value is ``None``."
msgstr ""
#: ../Doc/library/functions.rst:516
msgid ""
-"In all cases, if the optional parts are omitted, the code is executed in "
-"the current scope. If only *globals* is provided, it must be a "
-"dictionary (and not a subclass of dictionary), which will be used for "
-"both the global and the local variables. If *globals* and *locals* are "
-"given, they are used for the global and local variables, respectively. "
-"If provided, *locals* can be any mapping object. Remember that at module"
-" level, globals and locals are the same dictionary. If exec gets two "
-"separate objects as *globals* and *locals*, the code will be executed as "
-"if it were embedded in a class definition."
+"In all cases, if the optional parts are omitted, the code is executed in the "
+"current scope. If only *globals* is provided, it must be a dictionary (and "
+"not a subclass of dictionary), which will be used for both the global and "
+"the local variables. If *globals* and *locals* are given, they are used for "
+"the global and local variables, respectively. If provided, *locals* can be "
+"any mapping object. Remember that at module level, globals and locals are "
+"the same dictionary. If exec gets two separate objects as *globals* and "
+"*locals*, the code will be executed as if it were embedded in a class "
+"definition."
msgstr ""
#: ../Doc/library/functions.rst:526
msgid ""
"If the *globals* dictionary does not contain a value for the key "
-"``__builtins__``, a reference to the dictionary of the built-in module "
-":mod:`builtins` is inserted under that key. That way you can control "
-"what builtins are available to the executed code by inserting your own "
-"``__builtins__`` dictionary into *globals* before passing it to "
-":func:`exec`."
+"``__builtins__``, a reference to the dictionary of the built-in module :mod:"
+"`builtins` is inserted under that key. That way you can control what "
+"builtins are available to the executed code by inserting your own "
+"``__builtins__`` dictionary into *globals* before passing it to :func:`exec`."
msgstr ""
#: ../Doc/library/functions.rst:539
msgid ""
-"The built-in functions :func:`globals` and :func:`locals` return the "
-"current global and local dictionary, respectively, which may be useful to"
-" pass around for use as the second and third argument to :func:`exec`."
+"The built-in functions :func:`globals` and :func:`locals` return the current "
+"global and local dictionary, respectively, which may be useful to pass "
+"around for use as the second and third argument to :func:`exec`."
msgstr ""
#: ../Doc/library/functions.rst:545
msgid ""
"The default *locals* act as described for function :func:`locals` below: "
-"modifications to the default *locals* dictionary should not be attempted."
-" Pass an explicit *locals* dictionary if you need to see effects of the "
-"code on *locals* after function :func:`exec` returns."
+"modifications to the default *locals* dictionary should not be attempted. "
+"Pass an explicit *locals* dictionary if you need to see effects of the code "
+"on *locals* after function :func:`exec` returns."
msgstr ""
#: ../Doc/library/functions.rst:553
msgid ""
-"Construct an iterator from those elements of *iterable* for which "
-"*function* returns true. *iterable* may be either a sequence, a "
-"container which supports iteration, or an iterator. If *function* is "
-"``None``, the identity function is assumed, that is, all elements of "
-"*iterable* that are false are removed."
+"Construct an iterator from those elements of *iterable* for which *function* "
+"returns true. *iterable* may be either a sequence, a container which "
+"supports iteration, or an iterator. If *function* is ``None``, the identity "
+"function is assumed, that is, all elements of *iterable* that are false are "
+"removed."
msgstr ""
#: ../Doc/library/functions.rst:559
msgid ""
"Note that ``filter(function, iterable)`` is equivalent to the generator "
-"expression ``(item for item in iterable if function(item))`` if function "
-"is not ``None`` and ``(item for item in iterable if item)`` if function "
-"is ``None``."
+"expression ``(item for item in iterable if function(item))`` if function is "
+"not ``None`` and ``(item for item in iterable if item)`` if function is "
+"``None``."
msgstr ""
#: ../Doc/library/functions.rst:564
@@ -1000,36 +977,36 @@ msgstr ""
#: ../Doc/library/functions.rst:576
msgid ""
-"If the argument is a string, it should contain a decimal number, "
-"optionally preceded by a sign, and optionally embedded in whitespace. "
-"The optional sign may be ``'+'`` or ``'-'``; a ``'+'`` sign has no effect"
-" on the value produced. The argument may also be a string representing a"
-" NaN (not-a-number), or a positive or negative infinity. More precisely,"
-" the input must conform to the following grammar after leading and "
-"trailing whitespace characters are removed:"
+"If the argument is a string, it should contain a decimal number, optionally "
+"preceded by a sign, and optionally embedded in whitespace. The optional "
+"sign may be ``'+'`` or ``'-'``; a ``'+'`` sign has no effect on the value "
+"produced. The argument may also be a string representing a NaN (not-a-"
+"number), or a positive or negative infinity. More precisely, the input must "
+"conform to the following grammar after leading and trailing whitespace "
+"characters are removed:"
msgstr ""
#: ../Doc/library/functions.rst:591
msgid ""
"Here ``floatnumber`` is the form of a Python floating-point literal, "
"described in :ref:`floating`. Case is not significant, so, for example, "
-"\"inf\", \"Inf\", \"INFINITY\" and \"iNfINity\" are all acceptable "
-"spellings for positive infinity."
+"\"inf\", \"Inf\", \"INFINITY\" and \"iNfINity\" are all acceptable spellings "
+"for positive infinity."
msgstr ""
#: ../Doc/library/functions.rst:596
msgid ""
"Otherwise, if the argument is an integer or a floating point number, a "
-"floating point number with the same value (within Python's floating point"
-" precision) is returned. If the argument is outside the range of a "
-"Python float, an :exc:`OverflowError` will be raised."
+"floating point number with the same value (within Python's floating point "
+"precision) is returned. If the argument is outside the range of a Python "
+"float, an :exc:`OverflowError` will be raised."
msgstr ""
#: ../Doc/library/functions.rst:601
msgid ""
-"For a general Python object ``x``, ``float(x)`` delegates to "
-"``x.__float__()``. If ``__float__()`` is not defined then it falls back "
-"to :meth:`__index__`."
+"For a general Python object ``x``, ``float(x)`` delegates to ``x."
+"__float__()``. If ``__float__()`` is not defined then it falls back to :"
+"meth:`__index__`."
msgstr ""
#: ../Doc/library/functions.rst:605
@@ -1051,25 +1028,25 @@ msgstr ""
#: ../Doc/library/functions.rst:638
msgid ""
"Convert a *value* to a \"formatted\" representation, as controlled by "
-"*format_spec*. The interpretation of *format_spec* will depend on the "
-"type of the *value* argument, however there is a standard formatting "
-"syntax that is used by most built-in types: :ref:`formatspec`."
+"*format_spec*. The interpretation of *format_spec* will depend on the type "
+"of the *value* argument, however there is a standard formatting syntax that "
+"is used by most built-in types: :ref:`formatspec`."
msgstr ""
#: ../Doc/library/functions.rst:643
msgid ""
-"The default *format_spec* is an empty string which usually gives the same"
-" effect as calling :func:`str(value) <str>`."
+"The default *format_spec* is an empty string which usually gives the same "
+"effect as calling :func:`str(value) <str>`."
msgstr ""
#: ../Doc/library/functions.rst:646
msgid ""
-"A call to ``format(value, format_spec)`` is translated to "
-"``type(value).__format__(value, format_spec)`` which bypasses the "
-"instance dictionary when searching for the value's :meth:`__format__` "
-"method. A :exc:`TypeError` exception is raised if the method search "
-"reaches :mod:`object` and the *format_spec* is non-empty, or if either "
-"the *format_spec* or the return value are not strings."
+"A call to ``format(value, format_spec)`` is translated to ``type(value)."
+"__format__(value, format_spec)`` which bypasses the instance dictionary when "
+"searching for the value's :meth:`__format__` method. A :exc:`TypeError` "
+"exception is raised if the method search reaches :mod:`object` and the "
+"*format_spec* is non-empty, or if either the *format_spec* or the return "
+"value are not strings."
msgstr ""
#: ../Doc/library/functions.rst:653
@@ -1080,17 +1057,15 @@ msgstr ""
#: ../Doc/library/functions.rst:662
msgid ""
-"Return a new :class:`frozenset` object, optionally with elements taken "
-"from *iterable*. ``frozenset`` is a built-in class. See "
-":class:`frozenset` and :ref:`types-set` for documentation about this "
-"class."
+"Return a new :class:`frozenset` object, optionally with elements taken from "
+"*iterable*. ``frozenset`` is a built-in class. See :class:`frozenset` and :"
+"ref:`types-set` for documentation about this class."
msgstr ""
#: ../Doc/library/functions.rst:666
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."
+"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 ""
#: ../Doc/library/functions.rst:673
@@ -1098,25 +1073,25 @@ 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 "
"result is the value of that attribute. For example, ``getattr(x, "
-"'foobar')`` is equivalent to ``x.foobar``. If the named attribute does "
-"not exist, *default* is returned if provided, otherwise "
-":exc:`AttributeError` is raised."
+"'foobar')`` is equivalent to ``x.foobar``. If the named attribute does not "
+"exist, *default* is returned if provided, otherwise :exc:`AttributeError` is "
+"raised."
msgstr ""
#: ../Doc/library/functions.rst:682
msgid ""
-"Return a dictionary representing the current global symbol table. This is"
-" always the dictionary of the current module (inside a function or "
-"method, this is the module where it is defined, not the module from which"
-" it is called)."
+"Return a dictionary representing the current global symbol table. This is "
+"always the dictionary of the current module (inside a function or method, "
+"this is the module where it is defined, not the module from which it is "
+"called)."
msgstr ""
#: ../Doc/library/functions.rst:689
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. "
-"(This is implemented by calling ``getattr(object, name)`` and seeing "
-"whether it raises an :exc:`AttributeError` or not.)"
+"(This is implemented by calling ``getattr(object, name)`` and seeing whether "
+"it raises an :exc:`AttributeError` or not.)"
msgstr ""
#: ../Doc/library/functions.rst:697
@@ -1124,79 +1099,76 @@ 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 "
"dictionary lookup. Numeric values that compare equal have the same hash "
-"value (even if they are of different types, as is the case for 1 and "
-"1.0)."
+"value (even if they are of different types, as is the case for 1 and 1.0)."
msgstr ""
#: ../Doc/library/functions.rst:704
msgid ""
"For objects with custom :meth:`__hash__` methods, note that :func:`hash` "
-"truncates the return value based on the bit width of the host machine. "
-"See :meth:`__hash__` for details."
+"truncates the return value based on the bit width of the host machine. See :"
+"meth:`__hash__` for details."
msgstr ""
#: ../Doc/library/functions.rst:710
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 interpreter console. If the argument is a string, then the"
-" string is looked up as the name of a module, function, class, method, "
-"keyword, or documentation topic, and a help page is printed on the "
-"console. If the argument is any other kind of object, a help page on the"
-" object is generated."
+"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 "
+"interpreter console. If the argument is a string, then the string is looked "
+"up as the name of a module, function, class, method, keyword, or "
+"documentation topic, and a help page is printed on the console. If the "
+"argument is any other kind of object, a help page on the object is generated."
msgstr ""
#: ../Doc/library/functions.rst:717
msgid ""
-"Note that if a slash(/) appears in the parameter list of a function, when"
-" invoking :func:`help`, it means that the parameters prior to the slash "
-"are positional-only. For more info, see :ref:`the FAQ entry on "
-"positional-only parameters <faq-positional-only-arguments>`."
+"Note that if a slash(/) appears in the parameter list of a function, when "
+"invoking :func:`help`, it means that the parameters prior to the slash are "
+"positional-only. For more info, see :ref:`the FAQ entry on positional-only "
+"parameters <faq-positional-only-arguments>`."
msgstr ""
#: ../Doc/library/functions.rst:722
msgid ""
-"This function is added to the built-in namespace by the :mod:`site` "
-"module."
+"This function is added to the built-in namespace by the :mod:`site` module."
msgstr ""
#: ../Doc/library/functions.rst:724
msgid ""
-"Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported "
-"signatures for callables are now more comprehensive and consistent."
+"Changes to :mod:`pydoc` and :mod:`inspect` mean that the reported signatures "
+"for callables are now more comprehensive and consistent."
msgstr ""
#: ../Doc/library/functions.rst:731
msgid ""
-"Convert an integer number to a lowercase hexadecimal string prefixed with"
-" \"0x\". If *x* is not a Python :class:`int` object, it has to define an "
-":meth:`__index__` method that returns an integer. Some examples:"
+"Convert an integer number to a lowercase hexadecimal string prefixed with "
+"\"0x\". If *x* is not a Python :class:`int` object, it has to define an :"
+"meth:`__index__` method that returns an integer. Some examples:"
msgstr ""
#: ../Doc/library/functions.rst:740
msgid ""
"If you want to convert an integer number to an uppercase or lower "
-"hexadecimal string with prefix or not, you can use either of the "
-"following ways:"
+"hexadecimal string with prefix or not, you can use either of the following "
+"ways:"
msgstr ""
#: ../Doc/library/functions.rst:752
msgid ""
-"See also :func:`int` for converting a hexadecimal string to an integer "
-"using a base of 16."
+"See also :func:`int` for converting a hexadecimal string to an integer using "
+"a base of 16."
msgstr ""
#: ../Doc/library/functions.rst:757
msgid ""
-"To obtain a hexadecimal string representation for a float, use the "
-":meth:`float.hex` method."
+"To obtain a hexadecimal string representation for a float, use the :meth:"
+"`float.hex` method."
msgstr ""
#: ../Doc/library/functions.rst:763
msgid ""
"Return the \"identity\" of an object. This is an integer which is "
-"guaranteed to be unique and constant for this object during its lifetime."
-" Two objects with non-overlapping lifetimes may have the same :func:`id` "
+"guaranteed to be unique and constant for this object during its lifetime. "
+"Two objects with non-overlapping lifetimes may have the same :func:`id` "
"value."
msgstr ""
@@ -1204,30 +1176,30 @@ msgstr ""
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, "
-"converts it to a string (stripping a trailing newline), and returns that."
-" When EOF is read, :exc:`EOFError` is raised. Example::"
+"converts it to a string (stripping a trailing newline), and returns that. "
+"When EOF is read, :exc:`EOFError` is raised. Example::"
msgstr ""
#: ../Doc/library/functions.rst:783
msgid ""
-"If the :mod:`readline` module was loaded, then :func:`input` will use it "
-"to provide elaborate line editing and history features."
+"If the :mod:`readline` module was loaded, then :func:`input` will use it to "
+"provide elaborate line editing and history features."
msgstr ""
msgid ""
-"Raises an :ref:`auditing event <auditing>` ``builtins.input`` with "
-"argument ``prompt``."
+"Raises an :ref:`auditing event <auditing>` ``builtins.input`` with argument "
+"``prompt``."
msgstr ""
#: ../Doc/library/functions.rst:788
msgid ""
-"Raises an :ref:`auditing event <auditing>` ``builtins.input`` with "
-"argument ``prompt`` before reading input"
+"Raises an :ref:`auditing event <auditing>` ``builtins.input`` with argument "
+"``prompt`` before reading input"
msgstr ""
msgid ""
-"Raises an :ref:`auditing event <auditing>` ``builtins.input/result`` with"
-" argument ``result``."
+"Raises an :ref:`auditing event <auditing>` ``builtins.input/result`` with "
+"argument ``result``."
msgstr ""
#: ../Doc/library/functions.rst:793
@@ -1238,28 +1210,27 @@ msgstr ""
#: ../Doc/library/functions.rst:800
msgid ""
-"Return an integer object constructed from a number or string *x*, or "
-"return ``0`` if no arguments are given. If *x* defines :meth:`__int__`, "
-"``int(x)`` returns ``x.__int__()``. If *x* defines :meth:`__index__`, it"
-" returns ``x.__index__()``. If *x* defines :meth:`__trunc__`, it returns"
-" ``x.__trunc__()``. For floating point numbers, this truncates towards "
-"zero."
+"Return an integer object constructed from a number or string *x*, or return "
+"``0`` if no arguments are given. If *x* defines :meth:`__int__`, ``int(x)`` "
+"returns ``x.__int__()``. If *x* defines :meth:`__index__`, it returns ``x."
+"__index__()``. If *x* defines :meth:`__trunc__`, it returns ``x."
+"__trunc__()``. For floating point numbers, this truncates towards zero."
msgstr ""
#: ../Doc/library/functions.rst:807
msgid ""
-"If *x* is not a number or if *base* is given, then *x* must be a string, "
-":class:`bytes`, or :class:`bytearray` instance representing an "
-":ref:`integer literal <integers>` in radix *base*. Optionally, the "
-"literal can be preceded by ``+`` or ``-`` (with no space in between) and "
-"surrounded by whitespace. A base-n literal consists of the digits 0 to "
-"n-1, with ``a`` to ``z`` (or ``A`` to ``Z``) having values 10 to 35. The"
-" default *base* is 10. The allowed values are 0 and 2--36. Base-2, -8, "
-"and -16 literals can be optionally prefixed with ``0b``/``0B``, "
-"``0o``/``0O``, or ``0x``/``0X``, as with integer literals in code. Base "
-"0 means to interpret exactly as a code literal, so that the actual base "
-"is 2, 8, 10, or 16, and so that ``int('010', 0)`` is not legal, while "
-"``int('010')`` is, as well as ``int('010', 8)``."
+"If *x* is not a number or if *base* is given, then *x* must be a string, :"
+"class:`bytes`, or :class:`bytearray` instance representing an :ref:`integer "
+"literal <integers>` in radix *base*. Optionally, the literal can be "
+"preceded by ``+`` or ``-`` (with no space in between) and surrounded by "
+"whitespace. A base-n literal consists of the digits 0 to n-1, with ``a`` to "
+"``z`` (or ``A`` to ``Z``) having values 10 to 35. The default *base* is 10. "
+"The allowed values are 0 and 2--36. Base-2, -8, and -16 literals can be "
+"optionally prefixed with ``0b``/``0B``, ``0o``/``0O``, or ``0x``/``0X``, as "
+"with integer literals in code. Base 0 means to interpret exactly as a code "
+"literal, so that the actual base is 2, 8, 10, or 16, and so that "
+"``int('010', 0)`` is not legal, while ``int('010')`` is, as well as "
+"``int('010', 8)``."
msgstr ""
#: ../Doc/library/functions.rst:820
@@ -1268,11 +1239,10 @@ msgstr ""
#: ../Doc/library/functions.rst:822
msgid ""
-"If *base* is not an instance of :class:`int` and the *base* object has a "
-":meth:`base.__index__ <object.__index__>` method, that method is called "
-"to obtain an integer for the base. Previous versions used "
-":meth:`base.__int__ <object.__int__>` instead of :meth:`base.__index__ "
-"<object.__index__>`."
+"If *base* is not an instance of :class:`int` and the *base* object has a :"
+"meth:`base.__index__ <object.__index__>` method, that method is called to "
+"obtain an integer for the base. Previous versions used :meth:`base.__int__ "
+"<object.__int__>` instead of :meth:`base.__index__ <object.__index__>`."
msgstr ""
#: ../Doc/library/functions.rst:835
@@ -1281,39 +1251,37 @@ msgstr ""
#: ../Doc/library/functions.rst:841
msgid ""
-"Return ``True`` if the *object* argument is an instance of the "
-"*classinfo* argument, or of a (direct, indirect or :term:`virtual "
-"<abstract base class>`) subclass thereof. If *object* is not an object "
-"of the given type, the function always returns ``False``. If *classinfo* "
-"is a tuple of type objects (or recursively, other such tuples), return "
-"``True`` if *object* is an instance of any of the types. If *classinfo* "
-"is not a type or tuple of types and such tuples, a :exc:`TypeError` "
-"exception is raised."
+"Return ``True`` if the *object* argument is an instance of the *classinfo* "
+"argument, or of a (direct, indirect or :term:`virtual <abstract base "
+"class>`) subclass thereof. If *object* is not an object of the given type, "
+"the function always returns ``False``. If *classinfo* is a tuple of type "
+"objects (or recursively, other such tuples), return ``True`` if *object* is "
+"an instance of any of the types. If *classinfo* is not a type or tuple of "
+"types and such tuples, a :exc:`TypeError` exception is raised."
msgstr ""
#: ../Doc/library/functions.rst:853
msgid ""
-"Return ``True`` if *class* is a subclass (direct, indirect or "
-":term:`virtual <abstract base class>`) of *classinfo*. A class is "
-"considered a subclass of itself. *classinfo* may be a tuple of class "
-"objects, in which case every entry in *classinfo* will be checked. In any"
-" other case, a :exc:`TypeError` exception is raised."
+"Return ``True`` if *class* is a subclass (direct, indirect or :term:`virtual "
+"<abstract base class>`) of *classinfo*. A class is considered a subclass of "
+"itself. *classinfo* may be a tuple of class objects, in which case every "
+"entry in *classinfo* will be checked. In any other case, a :exc:`TypeError` "
+"exception is raised."
msgstr ""
#: ../Doc/library/functions.rst:862
msgid ""
-"Return an :term:`iterator` object. The first argument is interpreted "
-"very differently depending on the presence of the second argument. "
-"Without a second argument, *object* must be a collection object which "
-"supports the iteration protocol (the :meth:`__iter__` method), or it must"
-" support the sequence protocol (the :meth:`__getitem__` method with "
-"integer arguments starting at ``0``). If it does not support either of "
-"those protocols, :exc:`TypeError` is raised. If the second argument, "
-"*sentinel*, is given, then *object* must be a callable object. The "
-"iterator created in this case will call *object* with no arguments for "
-"each call to its :meth:`~iterator.__next__` method; if the value returned"
-" is equal to *sentinel*, :exc:`StopIteration` will be raised, otherwise "
-"the value will be returned."
+"Return an :term:`iterator` object. The first argument is interpreted very "
+"differently depending on the presence of the second argument. Without a "
+"second argument, *object* must be a collection object which supports the "
+"iteration protocol (the :meth:`__iter__` method), or it must support the "
+"sequence protocol (the :meth:`__getitem__` method with integer arguments "
+"starting at ``0``). If it does not support either of those protocols, :exc:"
+"`TypeError` is raised. If the second argument, *sentinel*, is given, then "
+"*object* must be a callable object. The iterator created in this case will "
+"call *object* with no arguments for each call to its :meth:`~iterator."
+"__next__` method; if the value returned is equal to *sentinel*, :exc:"
+"`StopIteration` will be raised, otherwise the value will be returned."
msgstr ""
#: ../Doc/library/functions.rst:875
@@ -1323,29 +1291,29 @@ msgstr ""
#: ../Doc/library/functions.rst:877
msgid ""
"One useful application of the second form of :func:`iter` is to build a "
-"block-reader. For example, reading fixed-width blocks from a binary "
-"database file until the end of file is reached::"
+"block-reader. For example, reading fixed-width blocks from a binary database "
+"file until the end of file is reached::"
msgstr ""
#: ../Doc/library/functions.rst:889
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 (such as a dictionary, set, or frozen set)."
+"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 "
+"(such as a dictionary, set, or frozen set)."
msgstr ""
#: ../Doc/library/functions.rst:898
msgid ""
-"Rather than being a function, :class:`list` is actually a mutable "
-"sequence type, as documented in :ref:`typesseq-list` and :ref:`typesseq`."
+"Rather than being a function, :class:`list` is actually a mutable sequence "
+"type, as documented in :ref:`typesseq-list` and :ref:`typesseq`."
msgstr ""
#: ../Doc/library/functions.rst:904
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. Note that at the module level,"
-" :func:`locals` and :func:`globals` are the same dictionary."
+"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. Note that at the module level, :func:"
+"`locals` and :func:`globals` are the same dictionary."
msgstr ""
#: ../Doc/library/functions.rst:910
@@ -1358,11 +1326,10 @@ msgstr ""
msgid ""
"Return an iterator that applies *function* to every item of *iterable*, "
"yielding the results. If additional *iterable* arguments are passed, "
-"*function* must take that many arguments and is applied to the items from"
-" all iterables in parallel. With multiple iterables, the iterator stops "
-"when the shortest iterable is exhausted. For cases where the function "
-"inputs are already arranged into argument tuples, see "
-":func:`itertools.starmap`\\."
+"*function* must take that many arguments and is applied to the items from "
+"all iterables in parallel. With multiple iterables, the iterator stops when "
+"the shortest iterable is exhausted. For cases where the function inputs are "
+"already arranged into argument tuples, see :func:`itertools.starmap`\\."
msgstr ""
#: ../Doc/library/functions.rst:926
@@ -1373,44 +1340,40 @@ msgstr ""
#: ../Doc/library/functions.rst:929
msgid ""
-"If one positional argument is provided, it should be an :term:`iterable`."
-" The largest item in the iterable is returned. If two or more positional"
-" arguments are provided, the largest of the positional arguments is "
-"returned."
+"If one positional argument is provided, it should be an :term:`iterable`. "
+"The largest item in the iterable is returned. If two or more positional "
+"arguments are provided, the largest of the positional arguments is returned."
msgstr ""
-#: ../Doc/library/functions.rst:934
-#: ../Doc/library/functions.rst:971
+#: ../Doc/library/functions.rst:934 ../Doc/library/functions.rst:971
msgid ""
-"There are two optional keyword-only arguments. The *key* argument "
-"specifies a one-argument ordering function like that used for "
-":meth:`list.sort`. The *default* argument specifies an object to return "
-"if the provided iterable is empty. If the iterable is empty and *default*"
-" is not provided, a :exc:`ValueError` is raised."
+"There are two optional keyword-only arguments. The *key* argument specifies "
+"a one-argument ordering function like that used for :meth:`list.sort`. The "
+"*default* argument specifies an object to return if the provided iterable is "
+"empty. If the iterable is empty and *default* is not provided, a :exc:"
+"`ValueError` is raised."
msgstr ""
#: ../Doc/library/functions.rst:940
msgid ""
"If multiple items are maximal, the function returns the first one "
-"encountered. This is consistent with other sort-stability preserving "
-"tools such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and "
-"``heapq.nlargest(1, iterable, key=keyfunc)``."
+"encountered. This is consistent with other sort-stability preserving tools "
+"such as ``sorted(iterable, key=keyfunc, reverse=True)[0]`` and ``heapq."
+"nlargest(1, iterable, key=keyfunc)``."
msgstr ""
-#: ../Doc/library/functions.rst:945
-#: ../Doc/library/functions.rst:982
+#: ../Doc/library/functions.rst:945 ../Doc/library/functions.rst:982
msgid "The *default* keyword-only argument."
msgstr ""
-#: ../Doc/library/functions.rst:948
-#: ../Doc/library/functions.rst:985
+#: ../Doc/library/functions.rst:948 ../Doc/library/functions.rst:985
msgid "The *key* can be ``None``."
msgstr ""
#: ../Doc/library/functions.rst:956
msgid ""
-"Return a \"memory view\" object created from the given argument. See "
-":ref:`typememoryview` for more information."
+"Return a \"memory view\" object created from the given argument. See :ref:"
+"`typememoryview` for more information."
msgstr ""
#: ../Doc/library/functions.rst:963
@@ -1421,32 +1384,31 @@ msgstr ""
#: ../Doc/library/functions.rst:966
msgid ""
-"If one positional argument is provided, it should be an :term:`iterable`."
-" The smallest item in the iterable is returned. If two or more "
-"positional arguments are provided, the smallest of the positional "
-"arguments is returned."
+"If one positional argument is provided, it should be an :term:`iterable`. "
+"The smallest item in the iterable is returned. If two or more positional "
+"arguments are provided, the smallest of the positional arguments is returned."
msgstr ""
#: ../Doc/library/functions.rst:977
msgid ""
"If multiple items are minimal, the function returns the first one "
-"encountered. This is consistent with other sort-stability preserving "
-"tools such as ``sorted(iterable, key=keyfunc)[0]`` and "
-"``heapq.nsmallest(1, iterable, key=keyfunc)``."
+"encountered. This is consistent with other sort-stability preserving tools "
+"such as ``sorted(iterable, key=keyfunc)[0]`` and ``heapq.nsmallest(1, "
+"iterable, key=keyfunc)``."
msgstr ""
#: ../Doc/library/functions.rst:991
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 exhausted, otherwise :exc:`StopIteration` is raised."
+"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 "
+"exhausted, otherwise :exc:`StopIteration` is raised."
msgstr ""
#: ../Doc/library/functions.rst:998
msgid ""
-"Return a new featureless object. :class:`object` is a base for all "
-"classes. It has the methods that are common to all instances of Python "
-"classes. This function does not accept any arguments."
+"Return a new featureless object. :class:`object` is a base for all classes. "
+"It has the methods that are common to all instances of Python classes. This "
+"function does not accept any arguments."
msgstr ""
#: ../Doc/library/functions.rst:1004
@@ -1465,8 +1427,8 @@ msgstr ""
#: ../Doc/library/functions.rst:1020
msgid ""
-"If you want to convert an integer number to octal string either with "
-"prefix \"0o\" or not, you can use either of the following ways."
+"If you want to convert an integer number to octal string either with prefix "
+"\"0o\" or not, you can use either of the following ways."
msgstr ""
#: ../Doc/library/functions.rst:1037
@@ -1478,24 +1440,24 @@ msgstr ""
#: ../Doc/library/functions.rst:1040
msgid ""
"*file* is a :term:`path-like object` giving the pathname (absolute or "
-"relative to the current working directory) of the file to be opened or an"
-" integer file descriptor of the file to be wrapped. (If a file "
-"descriptor is given, it is closed when the returned I/O object is closed,"
-" unless *closefd* is set to ``False``.)"
+"relative to the current working directory) of the file to be opened or an "
+"integer file descriptor of the file to be wrapped. (If a file descriptor is "
+"given, it is closed when the returned I/O object is closed, unless *closefd* "
+"is set to ``False``.)"
msgstr ""
#: ../Doc/library/functions.rst:1046
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. Other common values are ``'w'`` for writing (truncating the file if"
-" it already exists), ``'x'`` for exclusive creation and ``'a'`` for "
-"appending (which on *some* Unix systems, means that *all* writes append "
-"to the end of the file regardless of the current seek position). In text"
-" mode, if *encoding* is not specified the encoding used is platform "
-"dependent: ``locale.getpreferredencoding(False)`` is called to get the "
-"current locale encoding. (For reading and writing raw bytes use binary "
-"mode and leave *encoding* unspecified.) The available modes are:"
+"*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. "
+"Other common values are ``'w'`` for writing (truncating the file if it "
+"already exists), ``'x'`` for exclusive creation and ``'a'`` for appending "
+"(which on *some* Unix systems, means that *all* writes append to the end of "
+"the file regardless of the current seek position). In text mode, if "
+"*encoding* is not specified the encoding used is platform dependent: "
+"``locale.getpreferredencoding(False)`` is called to get the current locale "
+"encoding. (For reading and writing raw bytes use binary mode and leave "
+"*encoding* unspecified.) The available modes are:"
msgstr ""
#: ../Doc/library/functions.rst:1063
@@ -1564,54 +1526,53 @@ msgstr ""
#: ../Doc/library/functions.rst:1074
msgid ""
-"The default mode is ``'r'`` (open for reading text, synonym of ``'rt'``)."
-" Modes ``'w+'`` and ``'w+b'`` open and truncate the file. Modes ``'r+'``"
-" and ``'r+b'`` open the file with no truncation."
+"The default mode is ``'r'`` (open for reading text, synonym of ``'rt'``). "
+"Modes ``'w+'`` and ``'w+b'`` open and truncate the file. Modes ``'r+'`` and "
+"``'r+b'`` open the file with no truncation."
msgstr ""
#: ../Doc/library/functions.rst:1078
msgid ""
-"As mentioned in the :ref:`io-overview`, Python distinguishes between "
-"binary and text I/O. Files opened in binary mode (including ``'b'`` in "
-"the *mode* argument) return contents as :class:`bytes` objects without "
-"any decoding. In text mode (the default, or when ``'t'`` is included in "
-"the *mode* argument), the contents of the file are returned as "
-":class:`str`, the bytes having been first decoded using a platform-"
-"dependent encoding or using the specified *encoding* if given."
+"As mentioned in the :ref:`io-overview`, Python distinguishes between binary "
+"and text I/O. Files opened in binary mode (including ``'b'`` in the *mode* "
+"argument) return contents as :class:`bytes` objects without any decoding. "
+"In text mode (the default, or when ``'t'`` is included in the *mode* "
+"argument), the contents of the file are returned as :class:`str`, the bytes "
+"having been first decoded using a platform-dependent encoding or using the "
+"specified *encoding* if given."
msgstr ""
#: ../Doc/library/functions.rst:1086
msgid ""
-"There is an additional mode character permitted, ``'U'``, which no longer"
-" has any effect, and is considered deprecated. It previously enabled "
-":term:`universal newlines` in text mode, which became the default "
-"behaviour in Python 3.0. Refer to the documentation of the :ref:`newline "
-"<open-newline-parameter>` parameter for further details."
+"There is an additional mode character permitted, ``'U'``, which no longer "
+"has any effect, and is considered deprecated. It previously enabled :term:"
+"`universal newlines` in text mode, which became the default behaviour in "
+"Python 3.0. Refer to the documentation of the :ref:`newline <open-newline-"
+"parameter>` parameter for further details."
msgstr ""
#: ../Doc/library/functions.rst:1094
msgid ""
-"Python doesn't depend on the underlying operating system's notion of text"
-" files; all the processing is done by Python itself, and is therefore "
+"Python doesn't depend on the underlying operating system's notion of text "
+"files; all the processing is done by Python itself, and is therefore "
"platform-independent."
msgstr ""
#: ../Doc/library/functions.rst:1098
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 buffering (only usable in text mode), and an integer > 1 to "
-"indicate the size in bytes of a fixed-size chunk buffer. When no "
-"*buffering* argument is given, the default buffering policy works as "
-"follows:"
+"*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 "
+"buffering (only usable in text mode), and an integer > 1 to indicate the "
+"size in bytes of a fixed-size chunk buffer. When no *buffering* argument is "
+"given, the default buffering policy works as follows:"
msgstr ""
#: ../Doc/library/functions.rst:1104
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 size\" and falling back on :attr:`io.DEFAULT_BUFFER_SIZE`. On "
-"many systems, the buffer will typically be 4096 or 8192 bytes long."
+"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 "
+"size\" and falling back on :attr:`io.DEFAULT_BUFFER_SIZE`. On many systems, "
+"the buffer will typically be 4096 or 8192 bytes long."
msgstr ""
#: ../Doc/library/functions.rst:1109
@@ -1623,54 +1584,54 @@ msgstr ""
#: ../Doc/library/functions.rst:1113
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"
-" dependent (whatever :func:`locale.getpreferredencoding` returns), but "
-"any :term:`text encoding` supported by Python can be used. See the "
-":mod:`codecs` module for the list of supported encodings."
+"*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 "
+"dependent (whatever :func:`locale.getpreferredencoding` returns), but any :"
+"term:`text encoding` supported by Python can be used. See the :mod:`codecs` "
+"module for the list of supported encodings."
msgstr ""
#: ../Doc/library/functions.rst:1120
msgid ""
"*errors* is an optional string that specifies how encoding and decoding "
-"errors are to be handled—this cannot be used in binary mode. A variety of"
-" standard error handlers are available (listed under :ref:`error-"
-"handlers`), though any error handling name that has been registered with "
-":func:`codecs.register_error` is also valid. The standard names include:"
+"errors are to be handled—this cannot be used in binary mode. A variety of "
+"standard error handlers are available (listed under :ref:`error-handlers`), "
+"though any error handling name that has been registered with :func:`codecs."
+"register_error` is also valid. The standard names include:"
msgstr ""
#: ../Doc/library/functions.rst:1128
msgid ""
-"``'strict'`` to raise a :exc:`ValueError` exception if there is an "
-"encoding error. The default value of ``None`` has the same effect."
+"``'strict'`` to raise a :exc:`ValueError` exception if there is an encoding "
+"error. The default value of ``None`` has the same effect."
msgstr ""
#: ../Doc/library/functions.rst:1132
msgid ""
-"``'ignore'`` ignores errors. Note that ignoring encoding errors can lead"
-" to data loss."
+"``'ignore'`` ignores errors. Note that ignoring encoding errors can lead to "
+"data loss."
msgstr ""
#: ../Doc/library/functions.rst:1135
msgid ""
-"``'replace'`` causes a replacement marker (such as ``'?'``) to be "
-"inserted where there is malformed data."
+"``'replace'`` causes a replacement marker (such as ``'?'``) to be inserted "
+"where there is malformed data."
msgstr ""
#: ../Doc/library/functions.rst:1138
msgid ""
-"``'surrogateescape'`` will represent any incorrect bytes as code points "
-"in the Unicode Private Use Area ranging from U+DC80 to U+DCFF. These "
-"private code points will then be turned back into the same bytes when the"
-" ``surrogateescape`` error handler is used when writing data. This is "
-"useful for processing files in an unknown encoding."
+"``'surrogateescape'`` will represent any incorrect bytes as code points in "
+"the Unicode Private Use Area ranging from U+DC80 to U+DCFF. These private "
+"code points will then be turned back into the same bytes when the "
+"``surrogateescape`` error handler is used when writing data. This is useful "
+"for processing files in an unknown encoding."
msgstr ""
#: ../Doc/library/functions.rst:1145
msgid ""
-"``'xmlcharrefreplace'`` is only supported when writing to a file. "
-"Characters not supported by the encoding are replaced with the "
-"appropriate XML character reference ``&#nnn;``."
+"``'xmlcharrefreplace'`` is only supported when writing to a file. Characters "
+"not supported by the encoding are replaced with the appropriate XML "
+"character reference ``&#nnn;``."
msgstr ""
#: ../Doc/library/functions.rst:1149
@@ -1681,53 +1642,52 @@ msgstr ""
#: ../Doc/library/functions.rst:1152
msgid ""
-"``'namereplace'`` (also only supported when writing) replaces unsupported"
-" characters with ``\\N{...}`` escape sequences."
+"``'namereplace'`` (also only supported when writing) replaces unsupported "
+"characters with ``\\N{...}`` escape sequences."
msgstr ""
#: ../Doc/library/functions.rst:1160
msgid ""
"*newline* controls how :term:`universal newlines` mode works (it only "
-"applies to text mode). It can be ``None``, ``''``, ``'\\n'``, ``'\\r'``,"
-" and ``'\\r\\n'``. It works as follows:"
+"applies to text mode). It can be ``None``, ``''``, ``'\\n'``, ``'\\r'``, "
+"and ``'\\r\\n'``. It works as follows:"
msgstr ""
#: ../Doc/library/functions.rst:1164
msgid ""
"When reading input from the stream, if *newline* is ``None``, universal "
"newlines mode is enabled. Lines in the input can end in ``'\\n'``, "
-"``'\\r'``, or ``'\\r\\n'``, and these are translated into ``'\\n'`` "
-"before being returned to the caller. If it is ``''``, universal newlines"
-" mode is enabled, but line endings are returned to the caller "
-"untranslated. If it has any of the other legal values, input lines are "
-"only terminated by the given string, and the line ending is returned to "
-"the caller untranslated."
+"``'\\r'``, or ``'\\r\\n'``, and these are translated into ``'\\n'`` before "
+"being returned to the caller. If it is ``''``, universal newlines mode is "
+"enabled, but line endings are returned to the caller untranslated. If it "
+"has any of the other legal values, input lines are only terminated by the "
+"given string, and the line ending is returned to the caller untranslated."
msgstr ""
#: ../Doc/library/functions.rst:1172
msgid ""
-"When writing output to the stream, if *newline* is ``None``, any "
-"``'\\n'`` characters written are translated to the system default line "
-"separator, :data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no "
-"translation takes place. If *newline* is any of the other legal values, "
-"any ``'\\n'`` characters written are translated to the given string."
+"When writing output to the stream, if *newline* is ``None``, any ``'\\n'`` "
+"characters written are translated to the system default line separator, :"
+"data:`os.linesep`. If *newline* is ``''`` or ``'\\n'``, no translation "
+"takes place. If *newline* is any of the other legal values, any ``'\\n'`` "
+"characters written are translated to the given string."
msgstr ""
#: ../Doc/library/functions.rst:1178
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 closed. If a filename is given *closefd* must be ``True`` (the "
-"default) otherwise an error will be raised."
+"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 "
+"closed. If a filename is given *closefd* must be ``True`` (the default) "
+"otherwise an error will be raised."
msgstr ""
#: ../Doc/library/functions.rst:1183
msgid ""
"A custom opener can be used by passing a callable as *opener*. The "
-"underlying file descriptor for the file object is then obtained by "
-"calling *opener* with (*file*, *flags*). *opener* must return an open "
-"file descriptor (passing :mod:`os.open` as *opener* results in "
-"functionality similar to passing ``None``)."
+"underlying file descriptor for the file object is then obtained by calling "
+"*opener* with (*file*, *flags*). *opener* must return an open file "
+"descriptor (passing :mod:`os.open` as *opener* results in functionality "
+"similar to passing ``None``)."
msgstr ""
#: ../Doc/library/functions.rst:1189
@@ -1736,42 +1696,42 @@ msgstr ""
#: ../Doc/library/functions.rst:1191
msgid ""
-"The following example uses the :ref:`dir_fd <dir_fd>` parameter of the "
-":func:`os.open` function to open a file relative to a given directory::"
+"The following example uses the :ref:`dir_fd <dir_fd>` parameter of the :func:"
+"`os.open` function to open a file relative to a given directory::"
msgstr ""
#: ../Doc/library/functions.rst:1204
msgid ""
"The type of :term:`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 (``'w'``, ``'r'``, ``'wt'``, ``'rt'``, etc.), it returns a subclass "
-"of :class:`io.TextIOBase` (specifically :class:`io.TextIOWrapper`). When"
-" used to open a file in a binary mode with buffering, the returned class "
-"is a subclass of :class:`io.BufferedIOBase`. The exact class varies: in "
-"read binary mode, it returns an :class:`io.BufferedReader`; in write "
-"binary and append binary modes, it returns an :class:`io.BufferedWriter`,"
-" and in read/write mode, it returns an :class:`io.BufferedRandom`. When "
-"buffering is disabled, the raw stream, a subclass of "
-":class:`io.RawIOBase`, :class:`io.FileIO`, is returned."
+"mode (``'w'``, ``'r'``, ``'wt'``, ``'rt'``, etc.), it returns a subclass of :"
+"class:`io.TextIOBase` (specifically :class:`io.TextIOWrapper`). When used "
+"to open a file in a binary mode with buffering, the returned class is a "
+"subclass of :class:`io.BufferedIOBase`. The exact class varies: in read "
+"binary mode, it returns an :class:`io.BufferedReader`; in write binary and "
+"append binary modes, it returns an :class:`io.BufferedWriter`, and in read/"
+"write mode, it returns an :class:`io.BufferedRandom`. When buffering is "
+"disabled, the raw stream, a subclass of :class:`io.RawIOBase`, :class:`io."
+"FileIO`, is returned."
msgstr ""
#: ../Doc/library/functions.rst:1225
msgid ""
"See also the file handling modules, such as, :mod:`fileinput`, :mod:`io` "
-"(where :func:`open` is declared), :mod:`os`, :mod:`os.path`, "
-":mod:`tempfile`, and :mod:`shutil`."
+"(where :func:`open` is declared), :mod:`os`, :mod:`os.path`, :mod:"
+"`tempfile`, and :mod:`shutil`."
msgstr ""
#: ../Doc/library/functions.rst:1230
msgid ""
-"Raises an :ref:`auditing event <auditing>` ``open`` with arguments "
-"``file``, ``mode``, ``flags``."
+"Raises an :ref:`auditing event <auditing>` ``open`` with arguments ``file``, "
+"``mode``, ``flags``."
msgstr ""
#: ../Doc/library/functions.rst:1231
msgid ""
-"The ``mode`` and ``flags`` arguments may have been modified or inferred "
-"from the original call."
+"The ``mode`` and ``flags`` arguments may have been modified or inferred from "
+"the original call."
msgstr ""
#: ../Doc/library/functions.rst:1237
@@ -1802,9 +1762,9 @@ msgstr ""
#: ../Doc/library/functions.rst:1255
msgid ""
-"If the system call is interrupted and the signal handler does not raise "
-"an exception, the function now retries the system call instead of raising"
-" an :exc:`InterruptedError` exception (see :pep:`475` for the rationale)."
+"If the system call is interrupted and the signal handler does not raise an "
+"exception, the function now retries the system call instead of raising an :"
+"exc:`InterruptedError` exception (see :pep:`475` for the rationale)."
msgstr ""
#: ../Doc/library/functions.rst:1258
@@ -1817,24 +1777,24 @@ msgstr ""
#: ../Doc/library/functions.rst:1264
msgid ""
-"On Windows, opening a console buffer may return a subclass of "
-":class:`io.RawIOBase` other than :class:`io.FileIO`."
+"On Windows, opening a console buffer may return a subclass of :class:`io."
+"RawIOBase` other than :class:`io.FileIO`."
msgstr ""
#: ../Doc/library/functions.rst:1269
msgid ""
"Given a string representing one Unicode character, return an integer "
"representing the Unicode code point of that character. For example, "
-"``ord('a')`` returns the integer ``97`` and ``ord('€')`` (Euro sign) "
-"returns ``8364``. This is the inverse of :func:`chr`."
+"``ord('a')`` returns the integer ``97`` and ``ord('€')`` (Euro sign) returns "
+"``8364``. This is the inverse of :func:`chr`."
msgstr ""
#: ../Doc/library/functions.rst:1277
msgid ""
-"Return *base* to the power *exp*; if *mod* is present, return *base* to "
-"the power *exp*, modulo *mod* (computed more efficiently than ``pow(base,"
-" exp) % mod``). The two-argument form ``pow(base, exp)`` is equivalent to"
-" using the power operator: ``base**exp``."
+"Return *base* to the power *exp*; if *mod* is present, return *base* to the "
+"power *exp*, modulo *mod* (computed more efficiently than ``pow(base, exp) % "
+"mod``). The two-argument form ``pow(base, exp)`` is equivalent to using the "
+"power operator: ``base**exp``."
msgstr ""
#: ../Doc/library/functions.rst:1282
@@ -1843,17 +1803,17 @@ msgid ""
"coercion rules for binary arithmetic operators apply. For :class:`int` "
"operands, the result has the same type as the operands (after coercion) "
"unless the second argument is negative; in that case, all arguments are "
-"converted to float and a float result is delivered. For example, "
-"``10**2`` returns ``100``, but ``10**-2`` returns ``0.01``."
+"converted to float and a float result is delivered. For example, ``10**2`` "
+"returns ``100``, but ``10**-2`` returns ``0.01``."
msgstr ""
#: ../Doc/library/functions.rst:1289
msgid ""
-"For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* "
-"must also be of integer type and *mod* must be nonzero. If *mod* is "
-"present and *exp* is negative, *base* must be relatively prime to *mod*. "
-"In that case, ``pow(inv_base, -exp, mod)`` is returned, where *inv_base* "
-"is an inverse to *base* modulo *mod*."
+"For :class:`int` operands *base* and *exp*, if *mod* is present, *mod* must "
+"also be of integer type and *mod* must be nonzero. If *mod* is present and "
+"*exp* is negative, *base* must be relatively prime to *mod*. In that case, "
+"``pow(inv_base, -exp, mod)`` is returned, where *inv_base* is an inverse to "
+"*base* modulo *mod*."
msgstr ""
#: ../Doc/library/functions.rst:1295
@@ -1862,40 +1822,37 @@ msgstr ""
#: ../Doc/library/functions.rst:1302
msgid ""
-"For :class:`int` operands, the three-argument form of ``pow`` now allows "
-"the second argument to be negative, permitting computation of modular "
-"inverses."
+"For :class:`int` operands, the three-argument form of ``pow`` now allows the "
+"second argument to be negative, permitting computation of modular inverses."
msgstr ""
#: ../Doc/library/functions.rst:1307
msgid ""
-"Allow keyword arguments. Formerly, only positional arguments were "
-"supported."
+"Allow keyword arguments. Formerly, only positional arguments were supported."
msgstr ""
#: ../Doc/library/functions.rst:1314
msgid ""
-"Print *objects* to the text stream *file*, separated by *sep* and "
-"followed by *end*. *sep*, *end*, *file* and *flush*, if present, must be"
-" given as keyword arguments."
+"Print *objects* to the text stream *file*, separated by *sep* and followed "
+"by *end*. *sep*, *end*, *file* and *flush*, if present, must be given as "
+"keyword arguments."
msgstr ""
#: ../Doc/library/functions.rst:1318
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* and *end* must be strings; they can also be ``None``, which "
-"means to use the default values. If no *objects* are given, "
-":func:`print` will just write *end*."
+"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* "
+"and *end* must be strings; they can also be ``None``, which means to use the "
+"default values. If no *objects* are given, :func:`print` will just write "
+"*end*."
msgstr ""
#: ../Doc/library/functions.rst:1324
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. Since "
-"printed arguments are converted to text strings, :func:`print` cannot be "
-"used with binary mode file objects. For these, use ``file.write(...)`` "
-"instead."
+"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. Since printed "
+"arguments are converted to text strings, :func:`print` cannot be used with "
+"binary mode file objects. For these, use ``file.write(...)`` instead."
msgstr ""
#: ../Doc/library/functions.rst:1329
@@ -1914,10 +1871,9 @@ msgstr ""
#: ../Doc/library/functions.rst:1340
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 attribute value. And *doc* creates a docstring for the "
-"attribute."
+"*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 "
+"attribute value. And *doc* creates a docstring for the attribute."
msgstr ""
#: ../Doc/library/functions.rst:1344
@@ -1932,38 +1888,38 @@ msgstr ""
#: ../Doc/library/functions.rst:1364
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 possible to create read-only properties easily using "
-":func:`property` as a :term:`decorator`::"
+"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 "
+"possible to create read-only properties easily using :func:`property` as a :"
+"term:`decorator`::"
msgstr ""
#: ../Doc/library/functions.rst:1377
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 for *voltage* to \"Get the current voltage.\""
+"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 "
+"for *voltage* to \"Get the current voltage.\""
msgstr ""
#: ../Doc/library/functions.rst:1381
msgid ""
-"A property object has :attr:`~property.getter`, :attr:`~property.setter`,"
-" and :attr:`~property.deleter` methods usable as decorators that create a"
-" copy of the property with the corresponding accessor function set to the"
-" decorated function. This is best explained with an example::"
+"A property object has :attr:`~property.getter`, :attr:`~property.setter`, "
+"and :attr:`~property.deleter` methods usable as decorators that create a "
+"copy of the property with the corresponding accessor function set to the "
+"decorated function. This is best explained with an example::"
msgstr ""
#: ../Doc/library/functions.rst:1403
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 case.)"
+"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 "
+"case.)"
msgstr ""
#: ../Doc/library/functions.rst:1407
msgid ""
-"The returned property object also has the attributes ``fget``, ``fset``, "
-"and ``fdel`` corresponding to the constructor arguments."
+"The returned property object also has the attributes ``fget``, ``fset``, and "
+"``fdel`` corresponding to the constructor arguments."
msgstr ""
#: ../Doc/library/functions.rst:1410
@@ -1973,99 +1929,96 @@ msgstr ""
#: ../Doc/library/functions.rst:1419
msgid ""
"Rather than being a function, :class:`range` is actually an immutable "
-"sequence type, as documented in :ref:`typesseq-range` and "
-":ref:`typesseq`."
+"sequence type, as documented in :ref:`typesseq-range` and :ref:`typesseq`."
msgstr ""
#: ../Doc/library/functions.rst:1425
msgid ""
"Return a string containing a printable representation of an object. For "
"many types, this function makes an attempt to return a string that would "
-"yield an object with the same value when passed to :func:`eval`, "
-"otherwise the representation is a string enclosed in angle brackets that "
-"contains the name of the type of the object together with additional "
-"information often including the name and address of the object. A class "
-"can control what this function returns for its instances by defining a "
-":meth:`__repr__` method."
+"yield an object with the same value when passed to :func:`eval`, otherwise "
+"the representation is a string enclosed in angle brackets that contains the "
+"name of the type of the object together with additional information often "
+"including the name and address of the object. A class can control what this "
+"function returns for its instances by defining a :meth:`__repr__` method."
msgstr ""
#: ../Doc/library/functions.rst:1436
msgid ""
-"Return a reverse :term:`iterator`. *seq* must be an object which has a "
-":meth:`__reversed__` method or supports the sequence protocol (the "
-":meth:`__len__` method and the :meth:`__getitem__` method with integer "
-"arguments starting at ``0``)."
+"Return a reverse :term:`iterator`. *seq* must be an object which has a :"
+"meth:`__reversed__` method or supports the sequence protocol (the :meth:"
+"`__len__` method and the :meth:`__getitem__` method with integer arguments "
+"starting at ``0``)."
msgstr ""
#: ../Doc/library/functions.rst:1444
msgid ""
-"Return *number* rounded to *ndigits* precision after the decimal point. "
-"If *ndigits* is omitted or is ``None``, it returns the nearest integer to"
-" its input."
+"Return *number* rounded to *ndigits* precision after the decimal point. If "
+"*ndigits* is omitted or is ``None``, it returns the nearest integer to its "
+"input."
msgstr ""
#: ../Doc/library/functions.rst:1448
msgid ""
-"For the built-in types supporting :func:`round`, values are rounded to "
-"the closest multiple of 10 to the power minus *ndigits*; if two multiples"
-" are equally close, rounding is done toward the even choice (so, for "
-"example, both ``round(0.5)`` and ``round(-0.5)`` are ``0``, and "
-"``round(1.5)`` is ``2``). Any integer value is valid for *ndigits* "
-"(positive, zero, or negative). The return value is an integer if "
-"*ndigits* is omitted or ``None``. Otherwise the return value has the same"
-" type as *number*."
+"For the built-in types supporting :func:`round`, values are rounded to the "
+"closest multiple of 10 to the power minus *ndigits*; if two multiples are "
+"equally close, rounding is done toward the even choice (so, for example, "
+"both ``round(0.5)`` and ``round(-0.5)`` are ``0``, and ``round(1.5)`` is "
+"``2``). Any integer value is valid for *ndigits* (positive, zero, or "
+"negative). The return value is an integer if *ndigits* is omitted or "
+"``None``. Otherwise the return value has the same type as *number*."
msgstr ""
#: ../Doc/library/functions.rst:1457
msgid ""
-"For a general Python object ``number``, ``round`` delegates to "
-"``number.__round__``."
+"For a general Python object ``number``, ``round`` delegates to ``number."
+"__round__``."
msgstr ""
#: ../Doc/library/functions.rst:1462
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 not a bug: it's a result of the fact that most decimal fractions "
-"can't be represented exactly as a float. See :ref:`tut-fp-issues` for "
-"more information."
+"``round(2.675, 2)`` gives ``2.67`` instead of the expected ``2.68``. This is "
+"not a bug: it's a result of the fact that most decimal fractions can't be "
+"represented exactly as a float. See :ref:`tut-fp-issues` for more "
+"information."
msgstr ""
#: ../Doc/library/functions.rst:1473
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-set` for documentation about this class."
+"*iterable*. ``set`` is a built-in class. See :class:`set` and :ref:`types-"
+"set` for documentation about this class."
msgstr ""
#: ../Doc/library/functions.rst:1477
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."
+"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 ""
#: ../Doc/library/functions.rst:1484
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 a new attribute. The function assigns the value to the "
-"attribute, provided the object allows it. For example, ``setattr(x, "
-"'foobar', 123)`` is equivalent to ``x.foobar = 123``."
+"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 "
+"a new attribute. The function assigns the value to the attribute, provided "
+"the object allows it. For example, ``setattr(x, 'foobar', 123)`` is "
+"equivalent to ``x.foobar = 123``."
msgstr ""
#: ../Doc/library/functions.rst:1496
msgid ""
-"Return a :term:`slice` object representing the set of indices specified "
-"by ``range(start, stop, step)``. The *start* and *step* arguments "
-"default to ``None``. Slice objects have read-only data attributes "
-":attr:`~slice.start`, :attr:`~slice.stop` and :attr:`~slice.step` which "
-"merely return the argument values (or their default). They have no other"
-" explicit functionality; however they are used by Numerical Python and "
-"other third party extensions. Slice objects are also generated when "
-"extended indexing syntax is used. For example: ``a[start:stop:step]`` or"
-" ``a[start:stop, i]``. See :func:`itertools.islice` for an alternate "
-"version that returns an iterator."
+"Return a :term:`slice` object representing the set of indices specified by "
+"``range(start, stop, step)``. The *start* and *step* arguments default to "
+"``None``. Slice objects have read-only data attributes :attr:`~slice."
+"start`, :attr:`~slice.stop` and :attr:`~slice.step` which merely return the "
+"argument values (or their default). They have no other explicit "
+"functionality; however they are used by Numerical Python and other third "
+"party extensions. Slice objects are also generated when extended indexing "
+"syntax is used. For example: ``a[start:stop:step]`` or ``a[start:stop, "
+"i]``. See :func:`itertools.islice` for an alternate version that returns an "
+"iterator."
msgstr ""
#: ../Doc/library/functions.rst:1509
@@ -2073,41 +2026,40 @@ msgid "Return a new sorted list from the items in *iterable*."
msgstr ""
#: ../Doc/library/functions.rst:1511
-msgid "Has two optional arguments which must be specified as keyword arguments."
+msgid ""
+"Has two optional arguments which must be specified as keyword arguments."
msgstr ""
#: ../Doc/library/functions.rst:1513
msgid ""
"*key* specifies a function of one argument that is used to extract a "
-"comparison key from each element in *iterable* (for example, "
-"``key=str.lower``). The default value is ``None`` (compare the elements "
-"directly)."
+"comparison key from each element in *iterable* (for example, ``key=str."
+"lower``). The default value is ``None`` (compare the elements directly)."
msgstr ""
#: ../Doc/library/functions.rst:1517
msgid ""
-"*reverse* is a boolean value. If set to ``True``, then the list elements"
-" are sorted as if each comparison were reversed."
+"*reverse* is a boolean value. If set to ``True``, then the list elements "
+"are sorted as if each comparison were reversed."
msgstr ""
#: ../Doc/library/functions.rst:1520
msgid ""
-"Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function "
-"to a *key* function."
+"Use :func:`functools.cmp_to_key` to convert an old-style *cmp* function to a "
+"*key* function."
msgstr ""
#: ../Doc/library/functions.rst:1523
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 compare equal --- this is helpful for sorting in multiple passes "
-"(for example, sort by department, then by salary grade)."
+"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 "
+"compare equal --- this is helpful for sorting in multiple passes (for "
+"example, sort by department, then by salary grade)."
msgstr ""
#: ../Doc/library/functions.rst:1528
msgid ""
-"For sorting examples and a brief sorting tutorial, see "
-":ref:`sortinghowto`."
+"For sorting examples and a brief sorting tutorial, see :ref:`sortinghowto`."
msgstr ""
#: ../Doc/library/functions.rst:1532
@@ -2116,36 +2068,36 @@ msgstr ""
#: ../Doc/library/functions.rst:1534
msgid ""
-"A static method does not receive an implicit first argument. To declare a"
-" static method, use this idiom::"
+"A static method does not receive an implicit first argument. To declare a "
+"static method, use this idiom::"
msgstr ""
#: ../Doc/library/functions.rst:1541
msgid ""
-"The ``@staticmethod`` form is a function :term:`decorator` -- see "
-":ref:`function` for details."
+"The ``@staticmethod`` form is a function :term:`decorator` -- see :ref:"
+"`function` for details."
msgstr ""
#: ../Doc/library/functions.rst:1544
msgid ""
-"A static method can be called either on the class (such as ``C.f()``) or "
-"on an instance (such as ``C().f()``)."
+"A static method can be called either on the class (such as ``C.f()``) or on "
+"an instance (such as ``C().f()``)."
msgstr ""
#: ../Doc/library/functions.rst:1547
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."
+"see :func:`classmethod` for a variant that is useful for creating alternate "
+"class constructors."
msgstr ""
#: ../Doc/library/functions.rst:1551
msgid ""
"Like all decorators, it is also possible to call ``staticmethod`` as a "
-"regular function and do something with its result. This is needed in "
-"some cases where you need a reference to a function from a class body and"
-" you want to avoid the automatic transformation to instance method. For "
-"these cases, use this idiom::"
+"regular function and do something with its result. This is needed in some "
+"cases where you need a reference to a function from a class body and you "
+"want to avoid the automatic transformation to instance method. For these "
+"cases, use this idiom::"
msgstr ""
#: ../Doc/library/functions.rst:1560
@@ -2153,29 +2105,30 @@ msgid "For more information on static methods, see :ref:`types`."
msgstr ""
#: ../Doc/library/functions.rst:1571
-msgid "Return a :class:`str` version of *object*. See :func:`str` for details."
+msgid ""
+"Return a :class:`str` version of *object*. See :func:`str` for details."
msgstr ""
#: ../Doc/library/functions.rst:1573
msgid ""
-"``str`` is the built-in string :term:`class`. For general information "
-"about strings, see :ref:`textseq`."
+"``str`` is the built-in string :term:`class`. For general information about "
+"strings, see :ref:`textseq`."
msgstr ""
#: ../Doc/library/functions.rst:1579
msgid ""
-"Sums *start* and the items of an *iterable* from left to right and "
-"returns the total. The *iterable*'s items are normally numbers, and the "
-"start value is not allowed to be a string."
+"Sums *start* and the items of an *iterable* from left to right and returns "
+"the total. The *iterable*'s items are normally numbers, and the start value "
+"is not allowed to be a string."
msgstr ""
#: ../Doc/library/functions.rst:1583
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 "
-"``''.join(sequence)``. To add floating point values with extended "
-"precision, see :func:`math.fsum`\\. To concatenate a series of "
-"iterables, consider using :func:`itertools.chain`."
+"preferred, fast way to concatenate a sequence of strings is by calling ``''."
+"join(sequence)``. To add floating point values with extended precision, "
+"see :func:`math.fsum`\\. To concatenate a series of iterables, consider "
+"using :func:`itertools.chain`."
msgstr ""
#: ../Doc/library/functions.rst:1589
@@ -2185,59 +2138,58 @@ msgstr ""
#: ../Doc/library/functions.rst:1594
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 been overridden in a class."
+"class of *type*. This is useful for accessing inherited methods that have "
+"been overridden in a class."
msgstr ""
#: ../Doc/library/functions.rst:1598
msgid ""
-"The *object-or-type* determines the :term:`method resolution order` to be"
-" searched. The search starts from the class right after the *type*."
+"The *object-or-type* determines the :term:`method resolution order` to be "
+"searched. The search starts from the class right after the *type*."
msgstr ""
#: ../Doc/library/functions.rst:1602
msgid ""
-"For example, if :attr:`~class.__mro__` of *object-or-type* is ``D -> B ->"
-" C -> A -> object`` and the value of *type* is ``B``, then :func:`super` "
+"For example, if :attr:`~class.__mro__` of *object-or-type* is ``D -> B -> C -"
+"> A -> object`` and the value of *type* is ``B``, then :func:`super` "
"searches ``C -> A -> object``."
msgstr ""
#: ../Doc/library/functions.rst:1606
msgid ""
"The :attr:`~class.__mro__` attribute of the *object-or-type* lists the "
-"method resolution search order used by both :func:`getattr` and "
-":func:`super`. The attribute is dynamic and can change whenever the "
-"inheritance hierarchy is updated."
+"method resolution search order used by both :func:`getattr` and :func:"
+"`super`. The attribute is dynamic and can change whenever the inheritance "
+"hierarchy is updated."
msgstr ""
#: ../Doc/library/functions.rst:1611
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. If the second argument is a type, ``issubclass(type2, type)`` must"
-" be true (this is useful for classmethods)."
+"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. "
+"If the second argument is a type, ``issubclass(type2, type)`` must be true "
+"(this is useful for classmethods)."
msgstr ""
#: ../Doc/library/functions.rst:1616
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 naming them explicitly, thus making the code more maintainable. "
-"This use closely parallels the use of *super* in other programming "
-"languages."
+"single inheritance, *super* can be used to refer to parent classes without "
+"naming them explicitly, thus making the code more maintainable. This use "
+"closely parallels the use of *super* in other programming languages."
msgstr ""
#: ../Doc/library/functions.rst:1621
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 found in statically compiled languages or languages that only support"
-" single inheritance. This makes it possible to implement \"diamond "
-"diagrams\" where multiple base classes implement the same method. Good "
-"design dictates that this method have the same calling signature in every"
-" case (because the order of calls is determined at runtime, because that "
-"order adapts to changes in the class hierarchy, and because that order "
-"can include sibling classes that are unknown prior to runtime)."
+"dynamic execution environment. This use case is unique to Python and is not "
+"found in statically compiled languages or languages that only support single "
+"inheritance. This makes it possible to implement \"diamond diagrams\" where "
+"multiple base classes implement the same method. Good design dictates that "
+"this method have the same calling signature in every case (because the order "
+"of calls is determined at runtime, because that order adapts to changes in "
+"the class hierarchy, and because that order can include sibling classes that "
+"are unknown prior to runtime)."
msgstr ""
#: ../Doc/library/functions.rst:1631
@@ -2253,49 +2205,48 @@ msgstr ""
#: ../Doc/library/functions.rst:1642
msgid ""
-"Note that :func:`super` is implemented as part of the binding process for"
-" explicit dotted attribute lookups such as ``super().__getitem__(name)``."
-" It does so by implementing its own :meth:`__getattribute__` method for "
-"searching classes in a predictable order that supports cooperative "
-"multiple inheritance. Accordingly, :func:`super` is undefined for "
-"implicit lookups using statements or operators such as ``super()[name]``."
+"Note that :func:`super` is implemented as part of the binding process for "
+"explicit dotted attribute lookups such as ``super().__getitem__(name)``. It "
+"does so by implementing its own :meth:`__getattribute__` method for "
+"searching classes in a predictable order that supports cooperative multiple "
+"inheritance. Accordingly, :func:`super` is undefined for implicit lookups "
+"using statements or operators such as ``super()[name]``."
msgstr ""
#: ../Doc/library/functions.rst:1649
msgid ""
"Also note that, aside from the zero argument form, :func:`super` is not "
"limited to use inside methods. The two argument form specifies the "
-"arguments exactly and makes the appropriate references. The zero "
-"argument form only works inside a class definition, as the compiler fills"
-" in the necessary details to correctly retrieve the class being defined, "
-"as well as accessing the current instance for ordinary methods."
+"arguments exactly and makes the appropriate references. The zero argument "
+"form only works inside a class definition, as the compiler fills in the "
+"necessary details to correctly retrieve the class being defined, as well as "
+"accessing the current instance for ordinary methods."
msgstr ""
#: ../Doc/library/functions.rst:1656
msgid ""
-"For practical suggestions on how to design cooperative classes using "
-":func:`super`, see `guide to using super() "
-"<https://rhettinger.wordpress.com/2011/05/26/super-considered-super/>`_."
+"For practical suggestions on how to design cooperative classes using :func:"
+"`super`, see `guide to using super() <https://rhettinger.wordpress."
+"com/2011/05/26/super-considered-super/>`_."
msgstr ""
#: ../Doc/library/functions.rst:1665
msgid ""
"Rather than being a function, :class:`tuple` is actually an immutable "
-"sequence type, as documented in :ref:`typesseq-tuple` and "
-":ref:`typesseq`."
+"sequence type, as documented in :ref:`typesseq-tuple` and :ref:`typesseq`."
msgstr ""
#: ../Doc/library/functions.rst:1674
msgid ""
-"With one argument, return the type of an *object*. The return value is a"
-" type object and generally the same object as returned by "
-":attr:`object.__class__ <instance.__class__>`."
+"With one argument, return the type of an *object*. The return value is a "
+"type object and generally the same object as returned by :attr:`object."
+"__class__ <instance.__class__>`."
msgstr ""
#: ../Doc/library/functions.rst:1678
msgid ""
-"The :func:`isinstance` built-in function is recommended for testing the "
-"type of an object, because it takes subclasses into account."
+"The :func:`isinstance` built-in function is recommended for testing the type "
+"of an object, because it takes subclasses into account."
msgstr ""
#: ../Doc/library/functions.rst:1682
@@ -2303,12 +2254,11 @@ 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 "
"class name and becomes the :attr:`~definition.__name__` attribute; the "
-"*bases* tuple itemizes the base classes and becomes the "
-":attr:`~class.__bases__` attribute; and the *dict* dictionary is the "
-"namespace containing definitions for class body and is copied to a "
-"standard dictionary to become the :attr:`~object.__dict__` attribute. "
-"For example, the following two statements create identical :class:`type` "
-"objects:"
+"*bases* tuple itemizes the base classes and becomes the :attr:`~class."
+"__bases__` attribute; and the *dict* dictionary is the namespace containing "
+"definitions for class body and is copied to a standard dictionary to become "
+"the :attr:`~object.__dict__` attribute. For example, the following two "
+"statements create identical :class:`type` objects:"
msgstr ""
#: ../Doc/library/functions.rst:1696
@@ -2323,17 +2273,16 @@ msgstr ""
#: ../Doc/library/functions.rst:1704
msgid ""
-"Return the :attr:`~object.__dict__` attribute for a module, class, "
-"instance, or any other object with a :attr:`~object.__dict__` attribute."
+"Return the :attr:`~object.__dict__` attribute for a module, class, instance, "
+"or any other object with a :attr:`~object.__dict__` attribute."
msgstr ""
#: ../Doc/library/functions.rst:1707
msgid ""
-"Objects such as modules and instances have an updateable "
-":attr:`~object.__dict__` attribute; however, other objects may have write"
-" restrictions on their :attr:`~object.__dict__` attributes (for example, "
-"classes use a :class:`types.MappingProxyType` to prevent direct "
-"dictionary updates)."
+"Objects such as modules and instances have an updateable :attr:`~object."
+"__dict__` attribute; however, other objects may have write restrictions on "
+"their :attr:`~object.__dict__` attributes (for example, classes use a :class:"
+"`types.MappingProxyType` to prevent direct dictionary updates)."
msgstr ""
#: ../Doc/library/functions.rst:1712
@@ -2349,33 +2298,33 @@ msgstr ""
#: ../Doc/library/functions.rst:1721
msgid ""
-"Returns an iterator of tuples, where the *i*-th tuple contains the *i*-th"
-" element from each of the argument sequences or iterables. The iterator "
-"stops when the shortest input iterable is exhausted. With a single "
-"iterable argument, it returns an iterator of 1-tuples. With no "
-"arguments, it returns an empty iterator. Equivalent to::"
+"Returns an iterator of tuples, where the *i*-th tuple contains the *i*-th "
+"element from each of the argument sequences or iterables. The iterator "
+"stops when the shortest input iterable is exhausted. With a single iterable "
+"argument, it returns an iterator of 1-tuples. With no arguments, it returns "
+"an empty iterator. Equivalent to::"
msgstr ""
#: ../Doc/library/functions.rst:1740
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)``. This repeats the *same* iterator ``n`` "
-"times so that each output tuple has the result of ``n`` calls to the "
-"iterator. This has the effect of dividing the input into n-length chunks."
+"makes possible an idiom for clustering a data series into n-length groups "
+"using ``zip(*[iter(s)]*n)``. This repeats the *same* iterator ``n`` times "
+"so that each output tuple has the result of ``n`` calls to the iterator. "
+"This has the effect of dividing the input into n-length chunks."
msgstr ""
#: ../Doc/library/functions.rst:1746
msgid ""
-":func:`zip` 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:`itertools.zip_longest` instead."
+":func:`zip` 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:`itertools.zip_longest` instead."
msgstr ""
#: ../Doc/library/functions.rst:1750
msgid ""
-":func:`zip` in conjunction with the ``*`` operator can be used to unzip a"
-" list::"
+":func:`zip` in conjunction with the ``*`` operator can be used to unzip a "
+"list::"
msgstr ""
#: ../Doc/library/functions.rst:1771
@@ -2388,46 +2337,45 @@ msgstr ""
msgid ""
"This function is invoked by the :keyword:`import` statement. It can be "
"replaced (by importing the :mod:`builtins` module and assigning to "
-"``builtins.__import__``) in order to change semantics of the "
-":keyword:`!import` statement, but doing so is **strongly** discouraged as"
-" it is usually simpler to use import hooks (see :pep:`302`) to attain the"
-" same goals and does not cause issues with code which assumes the default"
-" import implementation is in use. Direct use of :func:`__import__` is "
-"also discouraged in favor of :func:`importlib.import_module`."
+"``builtins.__import__``) in order to change semantics of the :keyword:`!"
+"import` statement, but doing so is **strongly** discouraged as it is usually "
+"simpler to use import hooks (see :pep:`302`) to attain the same goals and "
+"does not cause issues with code which assumes the default import "
+"implementation is in use. Direct use of :func:`__import__` is also "
+"discouraged in favor of :func:`importlib.import_module`."
msgstr ""
#: ../Doc/library/functions.rst:1783
msgid ""
"The function imports the module *name*, potentially using the given "
-"*globals* and *locals* to determine how to interpret the name in a "
-"package context. The *fromlist* gives the names of objects or submodules "
-"that should be imported from the module given by *name*. The standard "
-"implementation does not use its *locals* argument at all, and uses its "
-"*globals* only to determine the package context of the :keyword:`import` "
-"statement."
+"*globals* and *locals* to determine how to interpret the name in a package "
+"context. The *fromlist* gives the names of objects or submodules that should "
+"be imported from the module given by *name*. The standard implementation "
+"does not use its *locals* argument at all, and uses its *globals* only to "
+"determine the package context of the :keyword:`import` statement."
msgstr ""
#: ../Doc/library/functions.rst:1790
msgid ""
-"*level* specifies whether to use absolute or relative imports. ``0`` (the"
-" default) means only perform absolute imports. Positive values for "
-"*level* indicate the number of parent directories to search relative to "
-"the directory of the module calling :func:`__import__` (see :pep:`328` "
-"for the details)."
+"*level* specifies whether to use absolute or relative imports. ``0`` (the "
+"default) means only perform absolute imports. Positive values for *level* "
+"indicate the number of parent directories to search relative to the "
+"directory of the module calling :func:`__import__` (see :pep:`328` for the "
+"details)."
msgstr ""
#: ../Doc/library/functions.rst:1796
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 module named by *name*. However, when a non-empty *fromlist* "
-"argument is given, the module named by *name* is returned."
+"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 "
+"module named by *name*. However, when a non-empty *fromlist* argument is "
+"given, the module named by *name* is returned."
msgstr ""
#: ../Doc/library/functions.rst:1801
msgid ""
-"For example, the statement ``import spam`` results in bytecode resembling"
-" the following code::"
+"For example, the statement ``import spam`` results in bytecode resembling "
+"the following code::"
msgstr ""
#: ../Doc/library/functions.rst:1806
@@ -2436,9 +2384,8 @@ msgstr ""
#: ../Doc/library/functions.rst:1810
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."
+"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 ""
#: ../Doc/library/functions.rst:1813
@@ -2462,8 +2409,8 @@ msgstr ""
#: ../Doc/library/functions.rst:1827
msgid ""
-"Negative values for *level* are no longer supported (which also changes "
-"the default value to 0)."
+"Negative values for *level* are no longer supported (which also changes the "
+"default value to 0)."
msgstr ""
#: ../Doc/library/functions.rst:1833
@@ -2472,185 +2419,7 @@ msgstr ""
#: ../Doc/library/functions.rst:1834
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 newline "
-"conversion mode to convert Windows or Mac-style newlines."
-msgstr ""
-
-#~ 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 "
-#~ "fails, but if it is false, calling"
-#~ " *object* will never succeed. Note "
-#~ "that classes are callable (calling a "
-#~ "class returns a new instance); instances"
-#~ " are callable if their class has "
-#~ "a :meth:`__call__` method."
-#~ msgstr ""
-
-#~ msgid ""
-#~ "The *expression* argument is parsed and"
-#~ " evaluated as a Python expression "
-#~ "(technically speaking, a condition list) "
-#~ "using the *globals* and *locals* "
-#~ "dictionaries as global and local "
-#~ "namespace. If the *globals* dictionary "
-#~ "is present and does not contain a"
-#~ " value for the key ``__builtins__``, "
-#~ "a reference to the dictionary of "
-#~ "the built-in module :mod:`builtins` is"
-#~ " inserted under that key before "
-#~ "*expression* is parsed. This means that"
-#~ " *expression* normally has full access "
-#~ "to the standard :mod:`builtins` module "
-#~ "and restricted environments are propagated."
-#~ " If the *locals* dictionary is "
-#~ "omitted it defaults to the *globals* "
-#~ "dictionary. If both dictionaries are "
-#~ "omitted, the expression is executed in"
-#~ " the environment where :func:`eval` is "
-#~ "called. The return value is the "
-#~ "result of the evaluated expression. "
-#~ "Syntax errors are reported as "
-#~ "exceptions. Example:"
-#~ msgstr ""
-
-#~ msgid ""
-#~ "In all cases, if the optional "
-#~ "parts are omitted, the code is "
-#~ "executed in the current scope. If "
-#~ "only *globals* is provided, it must "
-#~ "be a dictionary, which will be "
-#~ "used for both the global and the"
-#~ " local variables. If *globals* and "
-#~ "*locals* are given, they are used "
-#~ "for the global and local variables, "
-#~ "respectively. If provided, *locals* can "
-#~ "be any mapping object. Remember that"
-#~ " at module level, globals and locals"
-#~ " are the same dictionary. If exec "
-#~ "gets two separate objects as *globals*"
-#~ " and *locals*, the code will be "
-#~ "executed as if it were embedded in"
-#~ " a class definition."
-#~ msgstr ""
-
-#~ msgid ""
-#~ "For a general Python object ``x``, "
-#~ "``float(x)`` delegates to ``x.__float__()``."
-#~ msgstr ""
-
-#~ msgid ""
-#~ "Return an integer object constructed "
-#~ "from a number or string *x*, or"
-#~ " return ``0`` if no arguments are "
-#~ "given. If *x* defines :meth:`__int__`, "
-#~ "``int(x)`` returns ``x.__int__()``. If *x*"
-#~ " defines :meth:`__trunc__`, it returns "
-#~ "``x.__trunc__()``. For floating point numbers,"
-#~ " this truncates towards zero."
-#~ msgstr ""
-
-#~ msgid ""
-#~ "Return true if the *object* argument "
-#~ "is an instance of the *classinfo* "
-#~ "argument, or of a (direct, indirect "
-#~ "or :term:`virtual <abstract base class>`) "
-#~ "subclass thereof. If *object* is not"
-#~ " an object of the given type, "
-#~ "the function always returns false. If"
-#~ " *classinfo* is a tuple of type "
-#~ "objects (or recursively, other such "
-#~ "tuples), return true if *object* is "
-#~ "an instance of any of the types."
-#~ " If *classinfo* is not a type "
-#~ "or tuple of types and such tuples,"
-#~ " a :exc:`TypeError` exception is raised."
-#~ msgstr ""
-
-#~ msgid ""
-#~ "Return true if *class* is a "
-#~ "subclass (direct, indirect or :term:`virtual"
-#~ " <abstract base class>`) of *classinfo*."
-#~ " A class is considered a subclass"
-#~ " of itself. *classinfo* may be a "
-#~ "tuple of class objects, in which "
-#~ "case every entry in *classinfo* will "
-#~ "be checked. In any other case, a"
-#~ " :exc:`TypeError` exception is raised."
-#~ msgstr ""
-
-#~ msgid "open a disk file for updating (reading and writing)"
-#~ msgstr ""
-
-#~ msgid ""
-#~ "The default mode is ``'r'`` (open "
-#~ "for reading text, synonym of ``'rt'``)."
-#~ " For binary read-write access, the"
-#~ " mode ``'w+b'`` opens and truncates "
-#~ "the file to 0 bytes. ``'r+b'`` "
-#~ "opens the file without truncation."
-#~ msgstr ""
-
-#~ 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-argument form ``pow(x, "
-#~ "y)`` is equivalent to using the "
-#~ "power operator: ``x**y``."
-#~ msgstr ""
-
-#~ msgid ""
-#~ "The arguments must have numeric types."
-#~ " With mixed operand types, the "
-#~ "coercion rules for binary arithmetic "
-#~ "operators apply. For :class:`int` operands,"
-#~ " the result has the same type "
-#~ "as the operands (after coercion) unless"
-#~ " the second argument is negative; in"
-#~ " that case, all arguments are "
-#~ "converted to float and a float "
-#~ "result is delivered. For example, "
-#~ "``10**2`` returns ``100``, but ``10**-2`` "
-#~ "returns ``0.01``. If the second "
-#~ "argument is negative, the third argument"
-#~ " must be omitted. If *z* is "
-#~ "present, *x* and *y* must be of"
-#~ " integer types, and *y* must be "
-#~ "non-negative."
-#~ msgstr ""
-
-#~ 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 numbers, and the start value"
-#~ " is not allowed to be a string."
-#~ msgstr ""
-
-#~ 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 been overridden in a "
-#~ "class. The search order is same as"
-#~ " that used by :func:`getattr` except "
-#~ "that the *type* itself is skipped."
-#~ msgstr ""
-
-#~ msgid ""
-#~ "The :attr:`~class.__mro__` attribute of the"
-#~ " *type* lists the method resolution "
-#~ "search order used by both "
-#~ ":func:`getattr` and :func:`super`. The "
-#~ "attribute is dynamic and can change "
-#~ "whenever the inheritance hierarchy is "
-#~ "updated."
-#~ msgstr ""
-
+"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 newline conversion "
+"mode to convert Windows or Mac-style newlines."
+msgstr ""
From 087f4fe1db130fa618c97b094a007e56fae4d249 Mon Sep 17 00:00:00 2001
From: claudia <cmncri@ibmb.csic.es>
Date: Thu, 7 May 2020 21:32:38 +0200
Subject: [PATCH 10/11] changes requested to fix pospell
---
dict | 2 ++
library/functions.po | 15 ++++++++-------
2 files changed, 10 insertions(+), 7 deletions(-)
diff --git a/dict b/dict
index 65890e2d32..f950e649d0 100644
--- a/dict
+++ b/dict
@@ -4,6 +4,8 @@ Associates
Autocompletado
Awk
B
+b
+Built
C
Circus
Cookbook
diff --git a/library/functions.po b/library/functions.po
index 5006b2a381..b5e4fc11a0 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -11,15 +11,16 @@ msgstr ""
"Project-Id-Version: Python 3.8\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2020-05-07 14:37+0200\n"
-"PO-Revision-Date: 2020-05-07 10:23+0200\n"
+"PO-Revision-Date: 2020-05-07 21:30+0200\n"
"Last-Translator: \n"
"Language: es\n"
"Language-Team: python-doc-esMIME-Version: 1.0\n"
-"Plural-Forms: nplurals=2; plural=(n != 1)\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Generated-By: Babel 2.8.0\n"
+"X-Generator: Poedit 2.3\n"
#: ../Doc/library/functions.rst:5 ../Doc/library/functions.rst:11
msgid "Built-in Functions"
@@ -310,7 +311,6 @@ msgid ":func:`round`"
msgstr ""
#: ../Doc/library/functions.rst:45
-#, fuzzy
msgid ""
"Return the absolute value of a number. The argument may be an integer or a "
"floating point number. If the argument is a complex number, its magnitude "
@@ -319,7 +319,8 @@ msgid ""
msgstr ""
"Devuelve el valor absoluto de un número. El argumento puede ser un número "
"entero o de punto flotante. Si el argumento es un número complejo, devuelve "
-"su magnitud."
+"su magnitud. Si *x* define un método :meth:`__abs__`, ``abs(x)`` devuelve "
+"``x.__abs__()``."
#: ../Doc/library/functions.rst:53
msgid ""
@@ -335,7 +336,7 @@ msgid ""
"is empty, return ``False``. Equivalent to::"
msgstr ""
"Devuelve ``True`` si un elemento cualquiera del *iterable* es verdadero. Si "
-"el iteradle está vacío, devuelve ``False``. Equivalente a::"
+"el iterable está vacío, devuelve ``False``. Equivalente a::"
#: ../Doc/library/functions.rst:77
msgid ""
@@ -371,7 +372,7 @@ msgstr ""
#: ../Doc/library/functions.rst:102 ../Doc/library/functions.rst:750
#: ../Doc/library/functions.rst:1030
msgid "See also :func:`format` for more information."
-msgstr "Veáse también :func:`format` para más información."
+msgstr "Véase también :func:`format` para más información."
#: ../Doc/library/functions.rst:107
msgid ""
@@ -767,7 +768,7 @@ msgid ""
msgstr ""
"Si el objeto no provee de un método :meth:`__dir__`, la función intenta "
"obtener la información del atributo :attr:`~object.__dict__` del objeto, si "
-"está definido, y de su objeto type. La lista resultante no está "
+"está definido, y de su objeto tipo. La lista resultante no está "
"necesariamente completa, y puede ser inexacta cuando el objeto tiene una "
"función :func:`__getattr__` implementada."
From 0b10d86131845b6cfb99e187db7a3805de9f8f90 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Claudia=20Mill=C3=A1n?= <cmncri@ibmb.csic.es>
Date: Thu, 7 May 2020 21:35:35 +0200
Subject: [PATCH 11/11] Update library/functions.po
Co-authored-by: Manuel Kaufmann <humitos@gmail.com>
---
library/functions.po | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/library/functions.po b/library/functions.po
index b5e4fc11a0..8a01d71df6 100644
--- a/library/functions.po
+++ b/library/functions.po
@@ -768,7 +768,7 @@ msgid ""
msgstr ""
"Si el objeto no provee de un método :meth:`__dir__`, la función intenta "
"obtener la información del atributo :attr:`~object.__dict__` del objeto, si "
-"está definido, y de su objeto tipo. La lista resultante no está "
+"está definido, y de su tipo de objeto. La lista resultante no está "
"necesariamente completa, y puede ser inexacta cuando el objeto tiene una "
"función :func:`__getattr__` implementada."