Apply suggestions from code review

python · cmaureir · Dec 20, 2020 · Oct 13, 2020 · Oct 19, 2020 · Oct 19, 2020
commit 705315afb15f6721d4dca5844e6a58b7325d9c4e
diff --git a/library/collections.po b/library/collections.po
@@ -230,7 +230,7 @@ msgid ""
 "*d.maps)``.  This method is used for creating subcontexts that can be "
 "updated without altering values in any of the parent mappings."
 msgstr ""
-"Devuelve un nuevo :class:`ChainMap` conteniendo un nuevo mapa seguido de "
+"Retorna un nuevo :class:`ChainMap` conteniendo un nuevo mapa seguido de "
 "todos los mapas de la instancia actual.  Si se especifica ``m``, se "
 "convierte en el nuevo mapa al principio de la lista de asignaciones; si no "
 "se especifica, se usa un dict vacío, de modo que una llamada a ``d."
@@ -251,7 +251,7 @@ msgid ""
 "cases also parallel those for the built-in :func:`super` function.  A "
 "reference to ``d.parents`` is equivalent to: ``ChainMap(*d.maps[1:])``."
 msgstr ""
-"Propiedad que devuelve un nuevo :class:`ChainMap` conteniendo todos los "
+"Propiedad que retorna un nuevo :class:`ChainMap` conteniendo todos los "
 "mapas de la instancia actual excepto el primero.  Esto es útil para omitir "
 "el primer mapa en la búsqueda.  Los casos de uso son similares a los de :"
 "keyword:`nonlocal` la palabra clave usada en :term:`alcances anidados "
@@ -404,7 +404,7 @@ msgid ""
 "count for missing items instead of raising a :exc:`KeyError`:"
 msgstr ""
 "Los objetos Counter tienen una interfaz de diccionario, excepto que "
-"devuelven un conteo de cero para los elementos faltantes en lugar de "
+"retornan un conteo de cero para los elementos faltantes en lugar de "
 "levantar una :exc:`KeyError`:"
 
 #: ../Doc/library/collections.rst:263
@@ -443,8 +443,8 @@ msgid ""
 "Elements are returned in the order first encountered. If an element's count "
 "is less than one, :meth:`elements` will ignore it."
 msgstr ""
-"Devuelve un iterador sobre los elementos que se repiten tantas veces como su "
-"conteo. Los elementos se devuelven en el orden en que se encontraron por "
+"Retorna un iterador sobre los elementos que se repiten tantas veces como su "
+"conteo. Los elementos se retornan en el orden en que se encontraron por "
 "primera vez. Si el conteo de un elemento es menor que uno, :meth:`elements` "
 "lo ignorará."
 
@@ -455,9 +455,9 @@ msgid ""
 "returns *all* elements in the counter. Elements with equal counts are "
 "ordered in the order first encountered:"
 msgstr ""
-"Devuelve una lista de los *n* elementos mas comunes y sus conteos, del mas "
+"Retorna una lista de los *n* elementos mas comunes y sus conteos, del mas "
 "común al menos común. Si se omite *n* o ``None``, :meth:`most_common` "
-"devuelve *todos* los elementos del contador. Los elementos con conteos "
+"retorna *todos* los elementos del contador. Los elementos con conteos "
 "iguales se ordenan en el orden en que se encontraron por primera vez:"
 
 #: ../Doc/library/collections.rst:302
@@ -513,7 +513,7 @@ msgstr ""
 "`Counter` para producir multiconjuntos (contadores que tienen conteos "
 "mayores que cero). La suma y la resta combinan contadores sumando o restando "
 "los conteos de los elementos correspondientes. La Intersección y unión "
-"devuelven el mínimo y el máximo de conteos correspondientes. Cada operación "
+"retornan el mínimo y el máximo de conteos correspondientes. Cada operación "
 "puede aceptar entradas con conteos con signo, pero la salida excluirá los "
 "resultados con conteos de cero o menos."
 
@@ -650,7 +650,7 @@ msgid ""
 "with data from *iterable*.  If *iterable* is not specified, the new deque is "
 "empty."
 msgstr ""
-"Devuelve un nuevo objeto deque inicializado de izquierda a derecha (usando :"
+"Retorna un nuevo objeto deque inicializado de izquierda a derecha (usando :"
 "meth:`append`) con datos de *iterable*. Si no se especifica *iterable*, el "
 "nuevo deque estará vacío."
 
@@ -747,8 +747,8 @@ msgid ""
 "before index *stop*).  Returns the first match or raises :exc:`ValueError` "
 "if not found."
 msgstr ""
-"Devuelve la posición de *x* en el deque (en o después del índice *start* y "
-"antes del índice *stop*). Devuelve la primera coincidencia o levanta :exc:"
+"Retorna la posición de *x* en el deque (en o después del índice *start* y "
+"antes del índice *stop*). Retorna la primera coincidencia o levanta :exc:"
 "`ValueError` si no se encuentra."
 
 #: ../Doc/library/collections.rst:500
@@ -768,15 +768,15 @@ msgid ""
 "Remove and return an element from the right side of the deque. If no "
 "elements are present, raises an :exc:`IndexError`."
 msgstr ""
-"Remueva y devuelva un elemento del lado derecho del deque. Si no hay "
+"Elimina y retorna un elemento del lado derecho del deque. Si no hay "
 "elementos presentes, genera un :exc:`IndexError`."
 
 #: ../Doc/library/collections.rst:516
 msgid ""
 "Remove and return an element from the left side of the deque. If no elements "
 "are present, raises an :exc:`IndexError`."
 msgstr ""
-"Remueva y devuelva un elemento del lado izquierdo del deque. Si no hay "
+"Elimina y retorna un elemento del lado izquierdo del deque. Si no hay "
 "elementos presentes, genera un :exc:`IndexError`."
 
 #: ../Doc/library/collections.rst:522
@@ -790,15 +790,15 @@ msgstr ""
 #: ../Doc/library/collections.rst:528
 msgid "Reverse the elements of the deque in-place and then return ``None``."
 msgstr ""
-"Invierta los elementos del deque en su lugar (*in-place*) y luego devuelva "
+"Invierte los elementos del deque en su lugar (*in-place*) y luego retorna "
 "``None``."
 
 #: ../Doc/library/collections.rst:535
 msgid ""
 "Rotate the deque *n* steps to the right.  If *n* is negative, rotate to the "
 "left."
 msgstr ""
-"Gire el deque *n* pasos a la derecha. Si *n* es negativo, gírelo hacia la "
+"Gira el deque *n* pasos a la derecha. Si *n* es negativo, lo gira hacia la "
 "izquierda."
 
 #: ../Doc/library/collections.rst:538
@@ -926,7 +926,7 @@ msgid ""
 "writable instance variable.  The remaining functionality is the same as for "
 "the :class:`dict` class and is not documented here."
 msgstr ""
-"Devuelve un nuevo objeto similar a un diccionario. :class:`defaultdict` es "
+"Retorna un nuevo objeto similar a un diccionario. :class:`defaultdict` es "
 "una subclase de la clase incorporada :class:`dict`. Anula un método y agrega "
 "una variable de instancia de escritura. La funcionalidad restante es la "
 "misma que para la clase :class:`dict` y no está documentada aquí."
@@ -967,7 +967,7 @@ msgid ""
 msgstr ""
 "Si :attr:`default_factory` no es ``None``, se llama sin argumentos para "
 "proporcionar un valor predeterminado para la *llave* dada, este valor se "
-"inserta en el diccionario para la *llave* y se devuelve."
+"inserta en el diccionario para la *llave* y se retorna."
 
 #: ../Doc/library/collections.rst:710
 msgid ""
@@ -984,8 +984,8 @@ msgid ""
 "then returned or raised by :meth:`__getitem__`."
 msgstr ""
 "Este método es llamado por el método :meth:`__getitem__` de la clase :class:"
-"`dict` cuando no se encuentra la llave solicitada; todo lo que devuelve o "
-"genera es devuelto o generado por :meth:`__getitem__`."
+"`dict` cuando no se encuentra la llave solicitada; todo lo que retorna o "
+"genera es retornado o generado por :meth:`__getitem__`."
 
 #: ../Doc/library/collections.rst:717
 msgid ""
@@ -996,7 +996,7 @@ msgid ""
 msgstr ""
 "Tenga en cuenta que :meth:`__missing__` *no* se llama para ninguna operación "
 "aparte de :meth:`__getitem__`. Esto significa que :meth:`get`, como los "
-"diccionarios normales, devolverá ``None`` por defecto en lugar de usar :attr:"
+"diccionarios normales, retornará ``None`` por defecto en lugar de usar :attr:"
 "`default_factory`."
 
 #: ../Doc/library/collections.rst:723
@@ -1039,10 +1039,10 @@ msgid ""
 msgstr ""
 "Cuando se encuentra cada llave por primera vez, no está ya en el mapping; "
 "por lo que una entrada se crea automáticamente usando la función :attr:"
-"`~defaultdict.default_factory` que devuelve una :class:`list` vacía. La "
+"`~defaultdict.default_factory` que retorna una :class:`list` vacía. La "
 "operación :meth:`list.append` luego adjunta el valor a la nueva lista. "
 "Cuando se vuelven a encontrar llaves, la búsqueda procede normalmente "
-"(devolviendo la lista para esa llave) y la operación :meth:`list.append` "
+"(retornando la lista para esa llave) y la operación :meth:`list.append` "
 "agrega otro valor a la lista. Esta técnica es más simple y rápida que una "
 "técnica equivalente usando :meth:`dict.setdefault`:"
 
@@ -1075,7 +1075,7 @@ msgid ""
 "functions is to use a lambda function which can supply any constant value "
 "(not just zero):"
 msgstr ""
-"La función :func:`int` que siempre devuelve cero es solo un caso especial de "
+"La función :func:`int` que siempre retorna cero es solo un caso especial de "
 "funciones constantes. Una forma más rápida y flexible de crear funciones "
 "constantes es utilizar una función lambda que pueda proporcionar cualquier "
 "valor constante (no solo cero):"
@@ -1113,7 +1113,7 @@ msgid ""
 "helpful docstring (with typename and field_names) and a helpful :meth:"
 "`__repr__` method which lists the tuple contents in a ``name=value`` format."
 msgstr ""
-"Devuelve una nueva subclase de tupla llamada *typename*. La nueva subclase "
+"Retorna una nueva subclase de tupla llamada *typename*. La nueva subclase "
 "se utiliza para crear objetos tipo tupla que tienen campos accesibles "
 "mediante búsqueda de atributos, además de ser indexables e iterables. Las "
 "instancias de la subclase también tienen un docstring útil (con typename y "
@@ -1221,7 +1221,7 @@ msgid ""
 "tuples returned by the :mod:`csv` or :mod:`sqlite3` modules::"
 msgstr ""
 "Las tuplas con nombre son especialmente útiles para asignar nombres de campo "
-"a las tuplas de resultado devueltas por los módulos :mod:`csv` o :mod:"
+"a las tuplas de resultado retornadas por los módulos :mod:`csv` o :mod:"
 "`sqlite3`::"
 
 #: ../Doc/library/collections.rst:894
@@ -1247,12 +1247,12 @@ msgid ""
 "Return a new :class:`dict` which maps field names to their corresponding "
 "values:"
 msgstr ""
-"Devuelve un nuevo :class:`dict` que asigna los nombres de los campos a sus "
+"Retorna un nuevo :class:`dict` que asigna los nombres de los campos a sus "
 "valores correspondientes:"
 
 #: ../Doc/library/collections.rst:919
 msgid "Returns an :class:`OrderedDict` instead of a regular :class:`dict`."
-msgstr "Devuelve un :class:`OrderedDict` en lugar de un :class:`dict` regular."
+msgstr "Retorna un :class:`OrderedDict` en lugar de un :class:`dict` regular."
 
 #: ../Doc/library/collections.rst:922
 msgid ""
@@ -1261,7 +1261,7 @@ msgid ""
 "features of :class:`OrderedDict` are required, the suggested remediation is "
 "to cast the result to the desired type: ``OrderedDict(nt._asdict())``."
 msgstr ""
-"Devuelve un :class:`dict` normal en lugar de un :class:`OrderedDict`. A "
+"Retorna un :class:`dict` normal en lugar de un :class:`OrderedDict`. A "
 "partir de Python 3.7, se garantiza el orden de los diccionarios normales. Si "
 "se requieren las características adicionales de :class:`OrderedDict` , la "
 "corrección sugerida es emitir el resultado al tipo deseado: ``OrderedDict(nt."
@@ -1272,7 +1272,7 @@ msgid ""
 "Return a new instance of the named tuple replacing specified fields with new "
 "values::"
 msgstr ""
-"Devuelve una nueva instancia de la tupla nombrada reemplazando los campos "
+"Retorna una nueva instancia de la tupla nombrada reemplazando los campos "
 "especificados con nuevos valores::"
 
 #: ../Doc/library/collections.rst:943
@@ -1457,7 +1457,7 @@ msgid ""
 "Return an instance of a :class:`dict` subclass that has methods specialized "
 "for rearranging dictionary order."
 msgstr ""
-"Devuelve una instancia de una subclase :class:`dict` que tiene métodos "
+"Retorna una instancia de una subclase :class:`dict` que tiene métodos "
 "especializados para reorganizar el orden del diccionario."
 
 #: ../Doc/library/collections.rst:1081
@@ -1467,8 +1467,8 @@ msgid ""
 "out)` order if *last* is true or :abbr:`FIFO (first-in, first-out)` order if "
 "false."
 msgstr ""
-"El método :meth:`popitem` para diccionarios ordenados devuelve y elimina un "
-"par (llave, valor). Los pares se devuelven en orden :abbr:`LIFO (last-in, "
+"El método :meth:`popitem` para diccionarios ordenados retorna y elimina un "
+"par (llave, valor). Los pares se retornan en orden :abbr:`LIFO (last-in, "
 "first-out)` si el *último* es verdadero o en orden :abbr:`FIFO (first-in, "
 "first-out)` si es falso."
 
@@ -1665,7 +1665,7 @@ msgid ""
 msgstr ""
 "**Requisitos de subclases:** Se espera que las subclases de :class:"
 "`UserList` ofrezcan un constructor al que se pueda llamar sin argumentos o "
-"con un solo argumento. Las operaciones de lista que devuelven una nueva "
+"con un solo argumento. Las operaciones de lista que retornan una nueva "
 "secuencia intentan crear una instancia de la clase de implementación real. "
 "Para hacerlo, asume que se puede llamar al constructor con un solo "
 "parámetro, que es un objeto de secuencia utilizado como fuente de datos."