Reemplazando devolver por retornar

python · cmaureir · Jul 26, 2020 · Jun 26, 2020 · Jul 6, 2020 · Jul 6, 2020
commit 0bd35a1c3a2c1e90c5e70b6fb7ce8490c54319c2
diff --git a/extending/extending.po b/extending/extending.po
@@ -98,7 +98,7 @@ msgstr ""
 "Creemos un módulo de extensión llamado ``spam`` (la comida favorita de los "
 "fanáticos de Monty Python ...) y digamos que queremos crear una interfaz de "
 "Python para la función de biblioteca C :c:func:`system` [#]_ . Esta función "
-"toma una cadena de caracteres con terminación nula como argumento y devuelve "
+"toma una cadena de caracteres con terminación nula como argumento y retorna "
 "un entero. Queremos que esta función se pueda llamar desde Python de la "
 "siguiente manera:"
 
@@ -222,9 +222,9 @@ msgid ""
 "the calling function can return ``NULL`` immediately (as we saw in the "
 "example)."
 msgstr ""
-":c:func:`PyArg_ParseTuple` devuelve verdadero (distinto de cero) si todos "
+":c:func:`PyArg_ParseTuple` retorna verdadero (distinto de cero) si todos "
 "los argumentos tienen el tipo correcto y sus componentes se han almacenado "
-"en las variables cuyas direcciones se pasan. Devuelve falso (cero) si se "
+"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`` inmediatamente (como vimos en el ejemplo)."
@@ -307,7 +307,7 @@ msgid ""
 "since you should be able to tell from the return value."
 msgstr ""
 "Puede probar de forma no destructiva si se ha establecido una excepción con :"
-"c:func:`PyErr_Occurred`. Esto devuelve el objeto de excepción actual o "
+"c:func:`PyErr_Occurred`. Esto retorna el objeto de excepción actual o "
 "``NULL`` si no se ha producido ninguna excepción. Normalmente no necesita "
 "llamar a :c:func:`PyErr_Occurred` para ver si se produjo un error en una "
 "llamada a la función, ya que debería poder distinguir el valor de retorno."
@@ -376,7 +376,7 @@ msgid ""
 msgstr ""
 "Cada llamada fallida a :c:func:`malloc` debe convertirse en una excepción "
 "--- la persona que llama directamente de :c:func:`malloc` (o :c:func:"
-"`realloc`) debe llamar :c:func:`PyErr_NoMemory` y devuelve un indicador de "
+"`realloc`) debe llamar :c:func:`PyErr_NoMemory` y retorna un indicador de "
 "falla en sí mismo. Todas las funciones de creación de objetos (por ejemplo, :"
 "c:func:`PyLong_FromLong`) ya hacen esto, por lo que esta nota solo es "
 "relevante para aquellos que llaman :c:func:`malloc` directamente."
@@ -389,8 +389,8 @@ msgid ""
 "calls."
 msgstr ""
 "También tenga en cuenta que, con la importante excepción de :c:func:"
-"`PyArg_ParseTuple` y sus amigos, las funciones que devuelven un estado "
-"entero generalmente devuelven un valor positivo o cero para el éxito y "
+"`PyArg_ParseTuple` y sus amigos, las funciones que retornan un estado "
+"entero generalmente retornan un valor positivo o cero para el éxito y "
 "``-1`` para el fracaso, como las llamadas al sistema Unix."
 
 #: ../Doc/extending/extending.rst:192
@@ -401,7 +401,7 @@ msgid ""
 msgstr ""
 "Finalmente, tenga cuidado de limpiar la basura (haciendo :c:func:"
 "`Py_XDECREF` o :c:func:`Py_DECREF` requiere objetos que ya ha creado) cuando "
-"devuelve un indicador de error!"
+"retorna un indicador de error!"
 
 #: ../Doc/extending/extending.rst:196
 msgid ""
@@ -513,7 +513,7 @@ msgid ""
 "which it points (so in Standard C, the variable :c:data:`command` should "
 "properly be declared as ``const char *command``)."
 msgstr ""
-"Devuelve ``NULL`` (el indicador de error para las funciones que devuelven "
+"Retorna ``NULL`` (el indicador de error para las funciones que retornan "
 "punteros de objeto) si se detecta un error en la lista de argumentos, "
 "basándose en la excepción establecida por :c:func:`PyArg_ParseTuple`. De lo "
 "contrario, el valor de cadena del argumento se ha copiado en la variable "
@@ -554,8 +554,8 @@ msgid ""
 "``None``.   You need this idiom to do so (which is implemented by the :c:"
 "macro:`Py_RETURN_NONE` macro)::"
 msgstr ""
-"Si tiene una función C que no devuelve ningún argumento útil (una función "
-"que devuelve :c:type:`void`), la función Python correspondiente debe "
+"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 ``None``. Necesita este modismo para hacerlo (que se implementa "
 "mediante la macro :c:macro:`Py_RETURN_NONE`)::"
 
@@ -666,11 +666,11 @@ msgid ""
 msgstr ""
 "Cuando el programa Python importa el módulo :mod:`spam` por primera vez, se "
 "llama :c:func:`PyInit_spam`. (Consulte a continuación los comentarios sobre "
-"la incorporación de Python). Llama a :c:func:`PyModule_Create`, que devuelve "
+"la incorporación de Python). Llama a :c:func:`PyModule_Create`, que retorna "
 "un objeto de módulo e inserta objetos de función incorporados en el módulo "
 "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` devuelve un puntero al objeto del módulo que crea. Puede "
+"`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 "
 "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 "
@@ -721,7 +721,7 @@ msgid ""
 "For details on multi-phase initialization, see :PEP:`489`."
 msgstr ""
 "A diferencia de nuestro ejemplo de ``spam``, ``xxmodule`` usa "
-"*inicialización de múltiples fases* (nuevo en Python 3.5), donde se devuelve "
+"*inicialización de múltiples fases* (nuevo en Python 3.5), donde se retorna "
 "una estructura PyModuleDef de ``PyInit_spam``, y la creación del módulo se "
 "deja al maquinaria de importación. Para obtener detalles sobre la "
 "inicialización múltiples fases, consulte :PEP:`489`."
@@ -884,7 +884,7 @@ msgstr ""
 "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, "
-"pasa una tupla singleton. :c:func:`Py_BuildValue` devuelve una tupla cuando "
+"pasa una tupla singleton. :c:func:`Py_BuildValue` retorna una tupla cuando "
 "su cadena de formato consta de cero o más códigos de formato entre "
 "paréntesis. Por ejemplo::"
 
@@ -896,7 +896,7 @@ msgid ""
 "new tuple was created to serve as the argument list, which is :c:func:"
 "`Py_DECREF`\\ -ed immediately after the :c:func:`PyObject_CallObject` call."
 msgstr ""
-":c:func:`PyObject_CallObject` devuelve un puntero de objeto Python: este es "
+":c:func:`PyObject_CallObject` retorna un puntero de objeto Python: este es "
 "el valor de retorno de la función Python. :c:func:`PyObject_CallObject` es "
 "\"recuento-referencia-neutral\" con respecto a sus argumentos. En el "
 "ejemplo, se creó una nueva tupla para servir como lista de argumentos, a la "
@@ -1059,7 +1059,7 @@ msgstr ""
 "parámetro *kwlist* es una lista de cadenas terminadas en ``NULL`` que "
 "identifican los parámetros; los nombres se corresponden con la información "
 "de tipo de *format* de izquierda a derecha. En caso de éxito, :c:func:"
-"`PyArg_ParseTupleAndKeywords` devuelve verdadero; de lo contrario, devuelve "
+"`PyArg_ParseTupleAndKeywords` retorna verdadero; de lo contrario, retorna "
 "falso y genera una excepción apropiada."
 
 #: ../Doc/extending/extending.rst:741
@@ -1101,7 +1101,7 @@ msgid ""
 msgstr ""
 "Reconoce un conjunto de unidades de formato similares a las reconocidas por :"
 "c:func:`PyArg_ParseTuple`, pero los argumentos (que son de entrada a la "
-"función, no de salida) no deben ser punteros, solo valores. Devuelve un "
+"función, no de salida) no deben ser punteros, solo valores. Retorna un "
 "nuevo objeto Python, adecuado para regresar de una función C llamada desde "
 "Python."
 
@@ -1121,8 +1121,8 @@ msgstr ""
 "argumentos de Python siempre se representan como tuplas internamente), :c:"
 "func:`Py_BuildValue` no siempre construye una tupla . Construye una tupla "
 "solo si su cadena de formato contiene dos o más unidades de formato. Si la "
-"cadena de formato está vacía, devuelve ``None``; si contiene exactamente una "
-"unidad de formato, devuelve el objeto que describa esa unidad de formato. "
+"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."
 
@@ -1166,7 +1166,7 @@ msgid ""
 "crashes."
 msgstr ""
 "Cada bloque de memoria asignado con :c:func:`malloc` eventualmente debería "
-"ser devuelto al grupo de memoria disponible exactamente por una llamada a :c:"
+"ser retorna al grupo de memoria disponible exactamente por una llamada a :c:"
 "func:`free`. Es importante llamar a :c:func:`free` en el momento adecuado. "
 "Si se olvida la dirección de un bloque pero :c:func:`free` no se solicita, "
 "la memoria que ocupa no se puede reutilizar hasta que finalice el programa. "
@@ -1421,7 +1421,7 @@ msgid ""
 "func:`PyLong_FromLong` maintains a cache of popular values and can return a "
 "reference to a cached item."
 msgstr ""
-"La mayoría de las funciones que devuelven una referencia a un objeto pasan "
+"La mayoría de las funciones que retornan una referencia a un objeto pasan "
 "de propiedad con la referencia. En particular, todas las funciones cuya "
 "función es crear un nuevo objeto, como :c:func:`PyLong_FromLong` y :c:func:"
 "`Py_BuildValue`, pasan la propiedad al receptor. Incluso si el objeto no es "
@@ -1444,16 +1444,16 @@ msgstr ""
 "Sin embargo, la imagen es menos clara aquí, ya que algunas rutinas comunes "
 "son excepciones: :c:func:`PyTuple_GetItem`, :c:func:`PyList_GetItem`, :c:"
 "func:`PyDict_GetItem`, y :c:func:`PyDict_GetItemString` todas las "
-"referencias devueltas que tomaste prestadas de la tupla, lista o diccionario."
+"referencias retornadas que tomaste prestadas de la tupla, lista o diccionario."
 
 #: ../Doc/extending/extending.rst:988
 msgid ""
 "The function :c:func:`PyImport_AddModule` also returns a borrowed reference, "
 "even though it may actually create the object it returns: this is possible "
 "because an owned reference to the object is stored in ``sys.modules``."
 msgstr ""
-"La función :c:func:`PyImport_AddModule` también devuelve una referencia "
-"prestada, aunque en realidad puede crear el objeto que devuelve: esto es "
+"La función :c:func:`PyImport_AddModule` también retorna una referencia "
+"prestada, aunque en realidad puede crear el objeto que retorna: esto es "
 "posible porque una referencia de propiedad del objeto se almacena en ``sys."
 "modules``."
 
@@ -1497,7 +1497,7 @@ msgid ""
 "must be an owned reference --- ownership is transferred from the function to "
 "its caller."
 msgstr ""
-"La referencia de objeto devuelta desde una función C que se llama desde "
+"La referencia de objeto retornada desde una función C que se llama desde "
 "Python debe ser una referencia de propiedad: la propiedad se transfiere de "
 "la función a su llamador."
 
@@ -1632,7 +1632,7 @@ msgstr ""
 "En general, las funciones que toman referencias de objetos como argumentos "
 "no esperan que les pase los punteros ``NULL``, y volcará el núcleo (o "
 "causará volcados de núcleo posteriores) si lo hace. Las funciones que "
-"devuelven referencias a objetos generalmente devuelven ``NULL`` solo para "
+"retornan referencias a objetos generalmente retornan ``NULL`` solo para "
 "indicar que ocurrió una excepción. La razón para no probar los argumentos "
 "``NULL`` es que las funciones a menudo pasan los objetos que reciben a otra "
 "función --- si cada función probara ``NULL``, habría muchas pruebas "