Upgrade documentation sources to CPython 3.9 branch

Follow https://python-docs-es.readthedocs.io/es/3.8/upgrade-python-version.html
to upgrade from Python 3.8 English documentation source files to Python 3.9

Author: humitos

.gitignore

@@ -14,6 +14,11 @@ Doc/upgrade-python-version.rst
 locales/
 dict.txt
 
+# Translations of our own files
+coc.po
+faq.po
+progress.po
+
 # Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]

c-api/arg.po

@@ -10,17 +10,16 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.8\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2020-05-05 12:54+0200\n"
+"POT-Creation-Date: 2021-03-19 11:16+0100\n"
 "PO-Revision-Date: 2020-06-21 13:52+0200\n"
 "Last-Translator: Cristián Maureira-Fredes <[email protected]>\n"
-"Language-Team: python-doc-es\n"
 "Language: es\n"
+"Language-Team: python-doc-es\n"
+"Plural-Forms: nplurals=2; plural=(n != 1)\n"
 "MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Type: text/plain; charset=utf-8\n"
 "Content-Transfer-Encoding: 8bit\n"
-"Plural-Forms: nplurals=2; plural=(n != 1);\n"
 "Generated-By: Babel 2.8.0\n"
-"X-Generator: Poedit 2.3\n"
 
 #: ../Doc/c-api/arg.rst:6
 msgid "Parsing arguments and building values"
@@ -335,10 +334,11 @@ msgid "``S`` (:class:`bytes`) [PyBytesObject \\*]"
 msgstr "``S`` (:class:`bytes`) [PyBytesObject \\*]"
 
 #: ../Doc/c-api/arg.rst:132
+#, fuzzy
 msgid ""
 "Requires that the Python object is a :class:`bytes` object, without "
 "attempting any conversion.  Raises :exc:`TypeError` if the object is not a "
-"bytes object.  The C variable may also be declared as :c:type:`PyObject\\*`."
+"bytes object.  The C variable may also be declared as :c:type:`PyObject*`."
 msgstr ""
 "Requiere que el objeto Python es un objeto :class:`bytes`, sin intentar "
 "ninguna conversión. Lanza :exc:`TypeError` si el objeto no es un objeto "
@@ -349,11 +349,12 @@ msgid "``Y`` (:class:`bytearray`) [PyByteArrayObject \\*]"
 msgstr "``Y`` (:class:`bytearray`) [PyByteArrayObject \\*]"
 
 #: ../Doc/c-api/arg.rst:137
+#, fuzzy
 msgid ""
 "Requires that the Python object is a :class:`bytearray` object, without "
 "attempting any conversion.  Raises :exc:`TypeError` if the object is not a :"
 "class:`bytearray` object. The C variable may also be declared as :c:type:"
-"`PyObject\\*`."
+"`PyObject*`."
 msgstr ""
 "Requiere que el objeto Python es un objeto :class:`bytearray`, sin intentar "
 "ninguna conversión. Lanza  :exc:`TypeError` si el objeto no es un objecto :"
@@ -440,10 +441,11 @@ msgid "``U`` (:class:`str`) [PyObject \\*]"
 msgstr "``U`` (:class:`str`) [PyObject \\*]"
 
 #: ../Doc/c-api/arg.rst:184
+#, fuzzy
 msgid ""
 "Requires that the Python object is a Unicode object, without attempting any "
 "conversion.  Raises :exc:`TypeError` if the object is not a Unicode object.  "
-"The C variable may also be declared as :c:type:`PyObject\\*`."
+"The C variable may also be declared as :c:type:`PyObject*`."
 msgstr ""
 "Requiere que el objeto Python es un objeto Unicode, sin intentar ninguna "
 "conversión. Lanza :exc:`TypeError` si el objeto no es un objeto Unicode. La "
@@ -478,15 +480,15 @@ msgstr ""
 "caracteres. Solo funciona para datos codificados sin bytes NUL integrados."
 
 #: ../Doc/c-api/arg.rst:198
+#, fuzzy
 msgid ""
 "This format requires two arguments.  The first is only used as input, and "
-"must be a :c:type:`const char\\*` which points to the name of an encoding as "
-"a NUL-terminated string, or ``NULL``, in which case ``'utf-8'`` encoding is "
+"must be a :c:type:`const char*` which points to the name of an encoding as a "
+"NUL-terminated string, or ``NULL``, in which case ``'utf-8'`` encoding is "
 "used. An exception is raised if the named encoding is not known to Python.  "
-"The second argument must be a :c:type:`char\\*\\*`; the value of the pointer "
-"it references will be set to a buffer with the contents of the argument "
-"text. The text will be encoded in the encoding specified by the first "
-"argument."
+"The second argument must be a :c:type:`char**`; the value of the pointer it "
+"references will be set to a buffer with the contents of the argument text. "
+"The text will be encoded in the encoding specified by the first argument."
 msgstr ""
 "Este formato requiere dos argumentos. El primero solo se usa como entrada, y "
 "debe ser :c:type:`const char\\*` que apunta al nombre de una codificación "
@@ -547,12 +549,13 @@ msgstr ""
 "entrada que contienen caracteres NUL."
 
 #: ../Doc/c-api/arg.rst:221
+#, fuzzy
 msgid ""
 "It requires three arguments.  The first is only used as input, and must be "
-"a :c:type:`const char\\*` which points to the name of an encoding as a NUL-"
+"a :c:type:`const char*` which points to the name of an encoding as a NUL-"
 "terminated string, or ``NULL``, in which case ``'utf-8'`` encoding is used. "
 "An exception is raised if the named encoding is not known to Python.  The "
-"second argument must be a :c:type:`char\\*\\*`; the value of the pointer it "
+"second argument must be a :c:type:`char**`; the value of the pointer it "
 "references will be set to a buffer with the contents of the argument text. "
 "The text will be encoded in the encoding specified by the first argument. "
 "The third argument must be a pointer to an integer; the referenced integer "
@@ -823,10 +826,11 @@ msgid "``O!`` (object) [*typeobject*, PyObject \\*]"
 msgstr "``O!`` (object) [*typeobject*, PyObject \\*]"
 
 #: ../Doc/c-api/arg.rst:323
+#, fuzzy
 msgid ""
 "Store a Python object in a C object pointer.  This is similar to ``O``, but "
 "takes two C arguments: the first is the address of a Python type object, the "
-"second is the address of the C variable (of type :c:type:`PyObject\\*`) into "
+"second is the address of the C variable (of type :c:type:`PyObject*`) into "
 "which the object pointer is stored.  If the Python object does not have the "
 "required type, :exc:`TypeError` is raised."
 msgstr ""
@@ -841,10 +845,11 @@ msgid "``O&`` (object) [*converter*, *anything*]"
 msgstr "``O&`` (object) [*converter*, *anything*]"
 
 #: ../Doc/c-api/arg.rst:332
+#, fuzzy
 msgid ""
 "Convert a Python object to a C variable through a *converter* function.  "
 "This takes two arguments: the first is a function, the second is the address "
-"of a C variable (of arbitrary type), converted to :c:type:`void \\*`.  The "
+"of a C variable (of arbitrary type), converted to :c:type:`void *`.  The "
 "*converter* function in turn is called as follows::"
 msgstr ""
 "Convierte un objeto Python en una variable C a través de una función "
@@ -854,9 +859,10 @@ msgstr ""
 "siguiente manera::"
 
 #: ../Doc/c-api/arg.rst:339
+#, fuzzy
 msgid ""
 "where *object* is the Python object to be converted and *address* is the :c:"
-"type:`void\\*` argument that was passed to the :c:func:`PyArg_Parse\\*` "
+"type:`void*` argument that was passed to the :c:func:`PyArg_Parse\\*` "
 "function. The returned *status* should be ``1`` for a successful conversion "
 "and ``0`` if the conversion has failed.  When the conversion fails, the "
 "*converter* function should raise an exception and leave the content of "
@@ -1132,6 +1138,7 @@ msgstr ""
 "descomponer otras tuplas, y puede continuar usándose para ese propósito."
 
 #: ../Doc/c-api/arg.rst:479
+#, fuzzy
 msgid ""
 "A simpler form of parameter retrieval which does not use a format string to "
 "specify the types of the arguments.  Functions which use this method to "
@@ -1140,13 +1147,12 @@ msgid ""
 "should be passed as *args*; it must actually be a tuple.  The length of the "
 "tuple must be at least *min* and no more than *max*; *min* and *max* may be "
 "equal.  Additional arguments must be passed to the function, each of which "
-"should be a pointer to a :c:type:`PyObject\\*` variable; these will be "
-"filled in with the values from *args*; they will contain borrowed "
-"references.  The variables which correspond to optional parameters not given "
-"by *args* will not be filled in; these should be initialized by the caller. "
-"This function returns true on success and false if *args* is not a tuple or "
-"contains the wrong number of elements; an exception will be set if there was "
-"a failure."
+"should be a pointer to a :c:type:`PyObject*` variable; these will be filled "
+"in with the values from *args*; they will contain borrowed references.  The "
+"variables which correspond to optional parameters not given by *args* will "
+"not be filled in; these should be initialized by the caller. This function "
+"returns true on success and false if *args* is not a tuple or contains the "
+"wrong number of elements; an exception will be set if there was a failure."
 msgstr ""
 "Una forma más simple de recuperación de parámetros que no utiliza una cadena "
 "de formato para especificar los tipos de argumentos. Las funciones que "
@@ -1491,10 +1497,11 @@ msgstr ""
 "de objetos en la lista de argumentos."
 
 #: ../Doc/c-api/arg.rst:654
+#, fuzzy
 msgid ""
 "Convert *anything* to a Python object through a *converter* function.  The "
 "function is called with *anything* (which should be compatible with :c:type:"
-"`void \\*`) as its argument and should return a \"new\" Python object, or "
+"`void*`) as its argument and should return a \"new\" Python object, or "
 "``NULL`` if an error occurred."
 msgstr ""
 "Convierte *anything* a un objeto Python a través de una función *converter*. "

c-api/bool.po

@@ -1,23 +1,25 @@
 # 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.
-# [email protected] / https://mail.python.org/mailman3/lists/docs-es.python.org/
-# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to get the list of volunteers
+# [email protected] /
+# https://mail.python.org/mailman3/lists/docs-es.python.org/
+# Check https://github.com/python/python-docs-es/blob/3.8/TRANSLATORS to get
+# the list of volunteers
 #
 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: 2021-03-19 11:16+0100\n"
 "PO-Revision-Date: 2020-05-09 03:05+0200\n"
+"Last-Translator: \n"
+"Language: es\n"
 "Language-Team: python-doc-es\n"
+"Plural-Forms: nplurals=2; plural=(n != 1)\n"
 "MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\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"
+"Generated-By: Babel 2.8.0\n"
 
 #: ../Doc/c-api/bool.rst:6
 msgid "Boolean Objects"
@@ -36,42 +38,45 @@ msgstr ""
 "Sin embargo, los siguientes macros están disponibles."
 
 #: ../Doc/c-api/bool.rst:16
-msgid "Return true if *o* is of type :c:data:`PyBool_Type`."
+#, fuzzy
+msgid ""
+"Return true if *o* is of type :c:data:`PyBool_Type`.  This function always "
+"succeeds."
 msgstr "Retorna verdad si *o* es de tipo :c:data:`PyBool_Type`."
 
-#: ../Doc/c-api/bool.rst:21
+#: ../Doc/c-api/bool.rst:22
 msgid ""
 "The Python ``False`` object.  This object has no methods.  It needs to be "
 "treated just like any other object with respect to reference counts."
 msgstr ""
 "El objeto ``False`` de Python. Este objeto no tiene métodos. Debe tratarse "
 "como cualquier otro objeto con respecto a los recuentos de referencia."
 
-#: ../Doc/c-api/bool.rst:27
+#: ../Doc/c-api/bool.rst:28
 msgid ""
 "The Python ``True`` object.  This object has no methods.  It needs to be "
 "treated just like any other object with respect to reference counts."
 msgstr ""
 "El objeto ``True`` de Python. Este objeto no tiene métodos. Debe tratarse "
 "como cualquier otro objeto con respecto a los recuentos de referencia."
 
-#: ../Doc/c-api/bool.rst:33
+#: ../Doc/c-api/bool.rst:34
 msgid ""
 "Return :const:`Py_False` from a function, properly incrementing its "
 "reference count."
 msgstr ""
 "Retorna :const:`Py_False` de una función, incrementando adecuadamente su "
 "recuento de referencia."
 
-#: ../Doc/c-api/bool.rst:39
+#: ../Doc/c-api/bool.rst:40
 msgid ""
 "Return :const:`Py_True` from a function, properly incrementing its reference "
 "count."
 msgstr ""
 "Retorna :const:`Py_True` desde una función, incrementando adecuadamente su "
 "recuento de referencia."
 
-#: ../Doc/c-api/bool.rst:45
+#: ../Doc/c-api/bool.rst:46
 msgid ""
 "Return a new reference to :const:`Py_True` or :const:`Py_False` depending on "
 "the truth value of *v*."