Agregando sugerencias extending/extending

cmaureir · cmaureir · commit b02fcb4d4775 · 2020-07-25T17:21:59.000+02:00
diff --git a/dict b/dict
@@ -790,6 +790,7 @@ reproducibles
 reproducible
 reStructuredText
 retrocompatible
+retrollamada
 remuestreo
 request
 reubicar
diff --git a/extending/extending.po b/extending/extending.po
@@ -226,7 +226,7 @@ msgstr ""
 "argumentos tienen el tipo correcto y sus componentes se han almacenado en "
 "las variables cuyas direcciones se pasan. Retorna falso (cero) si se pasó "
 "una lista de argumentos no válidos. En el último caso, también genera una "
-"excepción apropiada para que la función de llamada pueda devolver ``NULL`` "
+"excepción apropiada para que la función de llamada pueda retornar ``NULL`` "
 "inmediatamente (como vimos en el ejemplo)."
 
 #: ../Doc/extending/extending.rst:126
@@ -249,7 +249,7 @@ msgid ""
 msgstr ""
 "Una convención importante en todo el intérprete de Python es la siguiente: "
 "cuando una función falla, debe establecer una condición de excepción y "
-"devolver un valor de error (generalmente un puntero ``NULL``). Las "
+"retornar un valor de error (generalmente un puntero ``NULL``). Las "
 "excepciones se almacenan en una variable global estática dentro del "
 "intérprete; Si esta variable es ``NULL``, no se ha producido ninguna "
 "excepción. Una segunda variable global almacena el \"valor asociado\" de la "
@@ -326,10 +326,10 @@ msgid ""
 "programmer."
 msgstr ""
 "Cuando una función *f* que llama a otra función *g* detecta que la última "
-"falla, *f* debería devolver un valor de error (generalmente ``NULL`` o "
+"falla, *f* debería retornar un valor de error (generalmente ``NULL`` o "
 "``-1``). Debería *no* llamar a una de las funciones :c:func:`PyErr_\\*` --- "
 "una ya ha sido llamada por *g*. Se supone que la persona que llama *f* "
-"también debe devolver una indicación de error a *su* persona que llama, de "
+"también debe retornar una indicación de error a *su* persona que llama, de "
 "nuevo *sin* llamar :c:func:`PyErr_\\*`, y así sucesivamente --- la causa más "
 "detallada del error ya fue informado por la función que lo detectó por "
 "primera vez. Una vez que el error llega al bucle principal del intérprete de "
@@ -415,7 +415,7 @@ msgid ""
 "you have an argument whose value must be in a particular range or must "
 "satisfy other conditions, :c:data:`PyExc_ValueError` is appropriate."
 msgstr ""
-"La elección de qué excepción plantear es totalmente suya. Hay objetos C "
+"La elección de qué excepción lanzar es totalmente suya. Hay objetos C "
 "declarados previamente que corresponden a todas las excepciones de Python "
 "incorporadas, como :c:data:`PyExc_ZeroDivisionError`, que puede usar "
 "directamente. Por supuesto, debe elegir sabiamente las excepciones --- no "
@@ -440,7 +440,7 @@ msgid ""
 "and initialize it in your module's initialization function (:c:func:"
 "`PyInit_spam`) with an exception object::"
 msgstr ""
-"e inicializa en la función de inicialización de su módulo (:c:func:"
+"y lo inicializa en la función de inicialización de su módulo (:c:func:"
 "`PyInit_spam`) con un objeto de excepción::"
 
 #: ../Doc/extending/extending.rst:235
@@ -535,7 +535,7 @@ msgid ""
 "Our :func:`spam.system` function must return the value of :c:data:`sts` as a "
 "Python object.  This is done using the function :c:func:`PyLong_FromLong`. ::"
 msgstr ""
-"Nuestra función :func:`spam.system` debe devolver el valor de :c:data:`sts` "
+"Nuestra función :func:`spam.system` debe retornar el valor de :c:data:`sts` "
 "como un objeto Python. Esto se hace usando la función :c:func:"
 "`PyLong_FromLong`. ::"
 
@@ -544,8 +544,8 @@ msgid ""
 "In this case, it will return an integer object.  (Yes, even integers are "
 "objects on the heap in Python!)"
 msgstr ""
-"En este caso, devolverá un objeto entero. (Sí, ¡incluso los enteros son "
-"objetos en el montón en Python!)"
+"En este caso, retornará un objeto entero. (Sí, ¡incluso los enteros son "
+"objetos en el montículo (*heap*) en Python!)"
 
 #: ../Doc/extending/extending.rst:302
 msgid ""
@@ -555,7 +555,7 @@ msgid ""
 "macro:`Py_RETURN_NONE` macro)::"
 msgstr ""
 "Si tiene una función C que no retorna ningún argumento útil (una función que "
-"retorna :c:type:`void`), la función Python correspondiente debe devolver "
+"retorna :c:type:`void`), la función Python correspondiente debe retornar "
 "``None``. Necesita este modismo para hacerlo (que se implementa mediante la "
 "macro :c:macro:`Py_RETURN_NONE`)::"
 
@@ -648,7 +648,7 @@ msgid ""
 msgstr ""
 "Tenga en cuenta que PyMODINIT_FUNC declara la función como ``PyObject *`` "
 "tipo de retorno, declara cualquier declaración de vinculación especial "
-"requerida por la plataforma, y para C ++ declara la función como ``extern \"C"
+"requerida por la plataforma, y para C++ declara la función como ``extern \"C"
 "\"``."
 
 #: ../Doc/extending/extending.rst:372
@@ -671,9 +671,9 @@ msgstr ""
 "recién creado en función de la tabla (un arreglo de estructuras :c:type:"
 "`PyMethodDef`) encontradas en la definición del módulo. :c:func:"
 "`PyModule_Create` retorna un puntero al objeto del módulo que crea. Puede "
-"abortar con un error fatal para ciertos errores, o devolver ``NULL`` si el "
+"abortar con un error fatal para ciertos errores, o retornar ``NULL`` si el "
 "módulo no se pudo inicializar satisfactoriamente. La función *init* debe "
-"devolver el objeto del módulo a su llamador, para que luego se inserte en "
+"retornar el objeto del módulo a su llamador, para que luego se inserte en "
 "``sys.modules``."
 
 #: ../Doc/extending/extending.rst:383
@@ -699,9 +699,9 @@ msgid ""
 msgstr ""
 "Eliminar entradas de ``sys.modules`` o importar módulos compilados en "
 "múltiples intérpretes dentro de un proceso (o seguir un :c:func:`fork` sin "
-"una intervención :c:func:`exec`) puede crear problemas para alguna extensión "
-"módulos Los autores del módulo de extensión deben tener precaución al "
-"inicializar estructuras de datos internas."
+"una intervención :c:func:`exec`) puede crear problemas para algunas "
+"extensiones de módulos. Los autores de módulos de extensiones deben tener "
+"precaución al inicializar estructuras de datos internas."
 
 #: ../Doc/extending/extending.rst:433
 msgid ""
@@ -758,11 +758,11 @@ msgid ""
 msgstr ""
 "Si no puede utilizar la carga dinámica, o si desea que su módulo sea una "
 "parte permanente del intérprete de Python, tendrá que cambiar la "
-"configuración de configuración y reconstruir el intérprete. Afortunadamente, "
-"esto es muy simple en Unix: simplemente coloque su archivo (:file:"
-"`spammodule.c` por ejemplo) en el directorio :file:`Modules/ ` de una "
-"distribución fuente desempaquetada, agregue una línea al archivo :file:"
-"`Modules/Setup.local` que describe su archivo:"
+"configuración (*setup*) y reconstruir el intérprete. Afortunadamente, esto "
+"es muy simple en Unix: simplemente coloque su archivo (:file:`spammodule.c` "
+"por ejemplo) en el directorio :file:`Modules/ ` de una distribución fuente "
+"desempaquetada, agregue una línea al archivo :file:`Modules/Setup.local` que "
+"describe su archivo:"
 
 #: ../Doc/extending/extending.rst:468
 msgid ""
@@ -803,12 +803,11 @@ msgstr ""
 "Hasta ahora nos hemos concentrado en hacer que las funciones de C puedan "
 "llamarse desde Python. Lo contrario también es útil: llamar a las funciones "
 "de Python desde C. Este es especialmente el caso de las bibliotecas que "
-"admiten las llamadas funciones de \"devolución de llamada\". Si una interfaz "
-"C utiliza devoluciones de llamada, el Python equivalente a menudo necesita "
-"proporcionar un mecanismo de devolución de llamada al programador de Python; "
-"la implementación requerirá llamar a las funciones de devolución de llamada "
-"de Python desde una devolución de llamada en C. Otros usos también son "
-"imaginables."
+"admiten las llamadas funciones de \"retrollamada\". Si una interfaz C "
+"utiliza retrollamadas, el Python equivalente a menudo necesita proporcionar "
+"un mecanismo de retrollamada al programador de Python; la implementación "
+"requerirá llamar a las funciones de retrollamada de Python desde una "
+"retrollamada en C. Otros usos también son imaginables."
 
 #: ../Doc/extending/extending.rst:495
 msgid ""
@@ -880,7 +879,7 @@ msgid ""
 msgstr ""
 "Más tarde, cuando es hora de llamar a la función, llama a la función C :c:"
 "func:`PyObject_CallObject`. Esta función tiene dos argumentos, ambos "
-"apuntadores a objetos arbitrarios de Python: la función Python y la lista de "
+"punteros a objetos arbitrarios de Python: la función Python y la lista de "
 "argumentos. La lista de argumentos siempre debe ser un objeto de tupla, cuya "
 "longitud es el número de argumentos. Para llamar a la función Python sin "
 "argumentos, pase ``NULL`` o una tupla vacía; para llamarlo con un argumento, "
@@ -930,7 +929,7 @@ msgstr ""
 "Sin embargo, antes de hacer esto, es importante verificar que el valor de "
 "retorno no sea ``NULL``. Si es así, la función de Python terminó generando "
 "una excepción. Si el código C que llamó :c:func:`PyObject_CallObject` se "
-"llama desde Python, ahora debería devolver una indicación de error a su "
+"llama desde Python, ahora debería retornar una indicación de error a su "
 "llamador de Python, para que el intérprete pueda imprimir un seguimiento de "
 "la pila, o el código de Python que llama puede manejar la excepción. Si esto "
 "no es posible o deseable, la excepción se debe eliminar llamando a :c:func:"
@@ -947,14 +946,14 @@ msgid ""
 "simplest way to do this is to call :c:func:`Py_BuildValue`.  For example, if "
 "you want to pass an integral event code, you might use the following code::"
 msgstr ""
-"Dependiendo de la interfaz deseada para la función de devolución de llamada "
-"de Python, es posible que también deba proporcionar una lista de argumentos "
+"Dependiendo de la interfaz deseada para la función de retrollamada de "
+"Python, es posible que también deba proporcionar una lista de argumentos "
 "para :c:func:`PyObject_CallObject`. En algunos casos, el programa Python "
 "también proporciona la lista de argumentos, a través de la misma interfaz "
-"que especificó la función de devolución de llamada. Luego se puede guardar y "
-"usar de la misma manera que el objeto de función. En otros casos, puede que "
-"tenga que construir una nueva tupla para pasarla como lista de argumentos. "
-"La forma más sencilla de hacer esto es llamar a :c:func:`Py_BuildValue`. Por "
+"que especificó la función de retrollamada. Luego se puede guardar y usar de "
+"la misma manera que el objeto de función. En otros casos, puede que tenga "
+"que construir una nueva tupla para pasarla como lista de argumentos. La "
+"forma más sencilla de hacer esto es llamar a :c:func:`Py_BuildValue`. Por "
 "ejemplo, si desea pasar un código de evento integral, puede usar el "
 "siguiente código::"
 
@@ -1122,8 +1121,8 @@ msgstr ""
 "solo si su cadena de formato contiene dos o más unidades de formato. Si la "
 "cadena de formato está vacía, retorna ``None``; si contiene exactamente una "
 "unidad de formato, retorna el objeto que describa esa unidad de formato. "
-"Para forzarlo a devolver una tupla de tamaño 0 o uno, paréntesis la cadena "
-"de formato."
+"Para forzarlo a retornar una tupla de tamaño 0 o uno, agregar paréntesis a "
+"la cadena de formato."
 
 #: ../Doc/extending/extending.rst:822
 msgid ""
@@ -1144,9 +1143,9 @@ msgid ""
 "``new`` and ``delete`` are used with essentially the same meaning and we'll "
 "restrict the following discussion to the C case."
 msgstr ""
-"En lenguajes como C o C ++, el programador es responsable de la asignación "
+"En lenguajes como C o C++, el programador es responsable de la asignación "
 "dinámica y la desasignación de memoria en el montón. En C, esto se hace "
-"usando las funciones :c:func:`malloc` y :c:func:`free`. En C ++, los "
+"usando las funciones :c:func:`malloc` y :c:func:`free`. En C++, los "
 "operadores ``new`` y ``delete`` se usan esencialmente con el mismo "
 "significado y restringiremos la siguiente discusión al caso C."
 
@@ -1276,7 +1275,7 @@ msgstr ""
 "contienen referencias (posiblemente indirectas) a sí mismos, de modo que "
 "cada objeto en el ciclo tiene un recuento de referencias que no es cero. Las "
 "implementaciones típicas de recuento de referencias no pueden recuperar la "
-"memoria que pertenece a ningún objeto en un ciclo de referencia, o "
+"memoria que pertenece a algún objeto en un ciclo de referencia, o "
 "referenciada a partir de los objetos en el ciclo, a pesar de que no hay más "
 "referencias al ciclo en sí."
 
@@ -1426,7 +1425,7 @@ msgstr ""
 "`Py_BuildValue`, pasan la propiedad al receptor. Incluso si el objeto no es "
 "realmente nuevo, aún recibirá la propiedad de una nueva referencia a ese "
 "objeto. Por ejemplo, :c:func:`PyLong_FromLong` mantiene un caché de valores "
-"populares y puede devolver una referencia a un elemento en caché."
+"populares y puede retornar una referencia a un elemento en caché."
 
 #: ../Doc/extending/extending.rst:981
 msgid ""
@@ -1566,11 +1565,11 @@ msgid ""
 msgstr ""
 "Como está escrito en Python, el método :meth:`__del__` puede ejecutar código "
 "arbitrario de Python. ¿Podría hacer algo para invalidar la referencia a "
-"``elemento`` en :c:func:`error`? Usted apuesta! Suponiendo que la lista pasó "
-"a :c:func:`bug` es accesible para el método :meth:`__del__`, podría ejecutar "
-"una declaración en el sentido de ``del list[0]``, y suponiendo que este "
-"fuera el última referencia a ese objeto, liberaría la memoria asociada con "
-"él, invalidando así el ``elemento``."
+"``item`` en :c:func:`error`? ¡Tenlo por seguro! Suponiendo que la lista "
+"pasado a :c:func:`bug` es accesible para el método :meth:`__del__`, podría "
+"ejecutar una declaración en el sentido de ``del list[0]``, y suponiendo que "
+"este fuera el última referencia a ese objeto, liberaría la memoria asociada "
+"con él, invalidando así el ``elemento``."
 
 #: ../Doc/extending/extending.rst:1051
 msgid ""
@@ -1706,16 +1705,16 @@ msgid ""
 "`` --- they use this form already if the symbol ``__cplusplus`` is defined "
 "(all recent C++ compilers define this symbol)."
 msgstr ""
-"Es posible escribir módulos de extensión en C ++. Se aplican algunas "
+"Es posible escribir módulos de extensión en C++. Se aplican algunas "
 "restricciones. Si el compilador de C compila y vincula el programa principal "
 "(el intérprete de Python), no se pueden usar objetos globales o estáticos "
 "con constructores. Esto no es un problema si el programa principal está "
-"vinculado por el compilador de C ++. Las funciones que serán llamadas por el "
+"vinculado por el compilador de C++. Las funciones que serán llamadas por el "
 "intérprete de Python (en particular, las funciones de inicialización del "
 "módulo) deben declararse usando ``extern \"C\"``. No es necesario encerrar "
 "los archivos de encabezado de Python en ``extern \"C\" {...}`` --- ya usan "
 "este formulario si el símbolo ``__cplusplus`` está definido (todos los "
-"compiladores recientes de C ++ definen este símbolo) ."
+"compiladores recientes de C++ definen este símbolo) ."
 
 #: ../Doc/extending/extending.rst:1147
 msgid "Providing a C API for an Extension Module"
@@ -1756,19 +1755,19 @@ msgid ""
 "call might not have been loaded yet!"
 msgstr ""
 "A primera vista, esto parece fácil: simplemente escriba las funciones (sin "
-"declararlas ``estáticas``, por supuesto), proporcione un archivo de "
-"encabezado apropiado y documente la API de C. Y, de hecho, esto funcionaría "
-"si todos los módulos de extensión siempre estuvieran vinculados "
-"estáticamente con el intérprete de Python. Sin embargo, cuando los módulos "
-"se usan como bibliotecas compartidas, los símbolos definidos en un módulo "
-"pueden no ser visibles para otro módulo. Los detalles de visibilidad "
-"dependen del sistema operativo; algunos sistemas usan un espacio de nombres "
-"global para el intérprete de Python y todos los módulos de extensión "
-"(Windows, por ejemplo), mientras que otros requieren una lista explícita de "
-"símbolos importados en el momento del enlace del módulo (AIX es un ejemplo) "
-"u ofrecen una variedad de estrategias diferentes (la mayoría Unices). E "
-"incluso si los símbolos son visibles a nivel mundial, ¡el módulo cuyas "
-"funciones uno desea llamar podría no haberse cargado todavía!"
+"declararlas ``static``, por supuesto), proporcione un archivo de encabezado "
+"apropiado y documente la API de C. Y, de hecho, esto funcionaría si todos "
+"los módulos de extensión siempre estuvieran vinculados estáticamente con el "
+"intérprete de Python. Sin embargo, cuando los módulos se usan como "
+"bibliotecas compartidas, los símbolos definidos en un módulo pueden no ser "
+"visibles para otro módulo. Los detalles de visibilidad dependen del sistema "
+"operativo; algunos sistemas usan un espacio de nombres global para el "
+"intérprete de Python y todos los módulos de extensión (Windows, por "
+"ejemplo), mientras que otros requieren una lista explícita de símbolos "
+"importados en el momento del enlace del módulo (AIX es un ejemplo) u ofrecen "
+"una variedad de estrategias diferentes (la mayoría Unices). E incluso si los "
+"símbolos son visibles a nivel mundial, ¡el módulo cuyas funciones uno desea "
+"llamar podría no haberse cargado todavía!"
 
 #: ../Doc/extending/extending.rst:1172
 msgid ""
@@ -1781,7 +1780,7 @@ msgid ""
 msgstr ""
 "Por lo tanto, la portabilidad requiere no hacer suposiciones sobre la "
 "visibilidad del símbolo. Esto significa que todos los símbolos en los "
-"módulos de extensión deben declararse ``estáticos``, excepto la función de "
+"módulos de extensión deben declararse ``static``, excepto la función de "
 "inicialización del módulo, para evitar conflictos de nombres con otros "
 "módulos de extensión (como se discutió en la sección :ref:`methodtable`). Y "
 "significa que los símbolos que *deberían* ser accesibles desde otros módulos "
@@ -1892,17 +1891,16 @@ msgstr ""
 "sección :ref:`extending-simpleexample`. La función :func:`spam.system` no "
 "llama a la función de la biblioteca C :c:func:`system` directamente, sino "
 "una función :c:func:`PySpam_System`, que por supuesto haría algo más "
-"complicado en la realidad (como agregar \"spam\" a cada comando). Esta "
-"función :c:func:`PySpam_System` también se exporta a otros módulos de "
-"extensión."
+"complicado en realidad (como agregar \"spam\" a cada comando). Esta función :"
+"c:func:`PySpam_System` también se exporta a otros módulos de extensión."
 
 #: ../Doc/extending/extending.rst:1225
 msgid ""
 "The function :c:func:`PySpam_System` is a plain C function, declared "
 "``static`` like everything else::"
 msgstr ""
 "La función :c:func:`PySpam_System` es una función C simple, declarada "
-"``estática`` como todo lo demás::"
+"``static`` como todo lo demás::"
 
 #: ../Doc/extending/extending.rst:1234
 msgid "The function :c:func:`spam_system` is modified in a trivial way::"
@@ -1933,7 +1931,7 @@ msgid ""
 "Note that ``PySpam_API`` is declared ``static``; otherwise the pointer array "
 "would disappear when :func:`PyInit_spam` terminates!"
 msgstr ""
-"Tenga en cuenta que ``PySpam_API`` se declara ``estático``; de lo contrario, "
+"Tenga en cuenta que ``PySpam_API`` se declara ``static``; de lo contrario, "
 "la matriz de punteros desaparecería cuando :func:`PyInit_spam` finalice!"
 
 #: ../Doc/extending/extending.rst:1290
