Traduction reference introduction

TRANSLATORS

@@ -170,6 +170,7 @@ Luis Sánchez (@LuisAISanchez)
 Maia
 Manu de Frutos Vila (@manudefrutosvila)
 Manuel Garrido
+Manuel Jesus Curtido Rosado (@MJ-Curtido)
 Manuel Kaufmann (@humitos)
 Manuel Quiñones (@manuq)
 Manuel Ramos (@manuelramos)

reference/introduction.po

@@ -139,7 +139,7 @@ msgstr ""
 "lenguaje de scripting para aplicaciones Java, o puede utilizarse para crear "
 "aplicaciones utilizando las bibliotecas de clases Java.  También se utiliza "
 "a menudo para crear pruebas para bibliotecas Java. Puede encontrar más "
-"información en `the Jython website <https://www.jython.org/>`_."
+"información en `la web de Jython <https://www.jython.org/>`_."
 
 #: ../Doc/reference/introduction.rst:59
 msgid "Python for .NET"
@@ -249,48 +249,66 @@ msgid ""
 "defined) followed by a colon, ``:``. The definition to the right of the "
 "colon uses the following syntax elements:"
 msgstr ""
+"Cada regla empiza con un nombre (que identifica la regla que está siendo "
+"definida) seguido de dos puntos, ``:``. La definición situada a la derecha de "
+"los dos puntos usa los siguientes elementos de sintaxis:"
 
 #: ../Doc/reference/introduction.rst:116
 msgid ""
 "``name``: A name refers to another rule. Where possible, it is a link to the "
 "rule's definition."
 msgstr ""
+"``name``: Se refiere a otra regla. Donde posiblemente sea un enlace a la "
+"definición de la regla."
 
 #: ../Doc/reference/introduction.rst:119
 msgid ""
 "``TOKEN``: An uppercase name refers to a :term:`token`. For the purposes of "
 "grammar definitions, tokens are the same as rules."
 msgstr ""
+"``TOKEN``: Un nombre en mayúsculas hace referencia a un :term:`token`. A efectos de "
+"las definiciones gramaticales, los tokens son iguales que las reglas."
 
 #: ../Doc/reference/introduction.rst:122
 msgid ""
 "``\"text\"``, ``'text'``: Text in single or double quotes must match "
 "literally (without the quotes). The type of quote is chosen according to the "
 "meaning of ``text``:"
 msgstr ""
+"``\"text\"``, ``'text'``: El texto entre comillas simples o dobles debe coincidir "
+"literalmente (sin las comillas). El tipo de comillas se eligen según el "
+"significado de ``text``:"
 
 #: ../Doc/reference/introduction.rst:126
 msgid "``'if'``: A name in single quotes denotes a :ref:`keyword <keywords>`."
 msgstr ""
+msgid "``'if'``: Un nombre entre comillas simples denota una :ref:`palabra clave <keywords>`."
 
 #: ../Doc/reference/introduction.rst:127
 msgid ""
 "``\"case\"``: A name in double quotes denotes a :ref:`soft-keyword <soft-"
 "keywords>`."
 msgstr ""
+"``\"case\"``: Un nombre entre comillas dobles denota una :ref:`soft-keyword <soft-"
+"keywords>`."
 
 #: ../Doc/reference/introduction.rst:129
 msgid ""
 "``'@'``: A non-letter symbol in single quotes denotes an :py:data:`~token."
 "OP` token, that is, a :ref:`delimiter <delimiters>` or :ref:`operator "
 "<operators>`."
 msgstr ""
+"``'@'``: Un símbolo entre comillas simples denota un :py:data:`~token."
+"OP` token, que es, un :ref:`delimitador <delimiters>` u :ref:`operador "
+"<operators>`."
 
 #: ../Doc/reference/introduction.rst:133
 msgid ""
 "``e1 e2``: Items separated only by whitespace denote a sequence. Here, "
 "``e1`` must be followed by ``e2``."
 msgstr ""
+"``e1 e2``: Elementos separados solo por un espacio en blanco denota una secuencia. Aquí, "
+"``e1`` debe ser seguido por ``e2``."
 
 #: ../Doc/reference/introduction.rst:135
 msgid ""
@@ -299,43 +317,55 @@ msgid ""
 "traditional PEG grammars, this is written as a slash, ``/``, rather than a "
 "vertical bar. See :pep:`617` for more background and details."
 msgstr ""
+"``e1 | e2``: Se usa una barra vertical para separar alternativas. Esto denota "
+"\"elección ordenada\" de las PEG: si ``e1`` coincide, ``e2`` no se tiene en cuenta. En "
+"las gramáticas PEG tradicionales, esto se representa mediante una barra diagonal, ``/``, en vez "
+"de una barra vertical. Consulta :pep:`617` para más información y detalles."
 
 #: ../Doc/reference/introduction.rst:141
 msgid "``e*``: A star means zero or more repetitions of the preceding item."
-msgstr ""
+msgstr "``e*``: Un asterisco indica cero o más repeticiones del elemento precedente."
 
 #: ../Doc/reference/introduction.rst:142
 msgid "``e+``: Likewise, a plus means one or more repetitions."
-msgstr ""
+msgstr "``e+``: Del mismo modo, un símbolo más indica una o más repeticiones."
 
 #: ../Doc/reference/introduction.rst:143
 msgid ""
 "``[e]``: A phrase enclosed in square brackets means zero or one occurrences. "
 "In other words, the enclosed phrase is optional."
 msgstr ""
+"``[e]``: Una expresión cerrada entre corchetes significa cero o una aparición. "
+"En otras palabras, la expresión cerrada es opcional."
 
 #: ../Doc/reference/introduction.rst:145
 msgid ""
 "``e?``: A question mark has exactly the same meaning as square brackets: the "
 "preceding item is optional."
 msgstr ""
+"``e?``: Un signo de interrogación tiene el mismo significado que los corchetes: "
+"el elemento precedente es opcional."
 
 #: ../Doc/reference/introduction.rst:147
 msgid "``(e)``: Parentheses are used for grouping."
-msgstr ""
+msgstr "``(e)``: Los paréntesis se usan para agrupar."
 
 #: ../Doc/reference/introduction.rst:149
 msgid ""
 "The following notation is only used in :ref:`lexical definitions <notation-"
 "lexical-vs-syntactic>`."
 msgstr ""
+"La siguiente notación es usada solo en :ref:`definiciones léxicas <notation-"
+"lexical-vs-syntactic>`."
 
 #: ../Doc/reference/introduction.rst:152
 msgid ""
 "``\"a\"...\"z\"``: Two literal characters separated by three dots mean a "
 "choice of any single character in the given (inclusive) range of ASCII "
 "characters."
 msgstr ""
+"``\"a\"...\"z\"``: Dos caracteres literales separados por tres puntos indican "
+"la elección de cualquier carácter individual dentro del rango de caracteres ASCII."
 
 #: ../Doc/reference/introduction.rst:154
 msgid ""
@@ -344,53 +374,67 @@ msgid ""
 "\">``), or an abbreviation that is defined in nearby text (for example, "
 "``<Lu>``)."
 msgstr ""
+"``<...>``: Una frase entre corchetes angulares proporciona una descripción informal "
+"del símbolo correspondiente (por ejemplo, ``<cualquier carácter ASCII excepto \"\\"
+"\">``), o una abreviatura que se define en el siguiente texto (por ejemplo, "
+"``<Lu>``)."
 
 #: ../Doc/reference/introduction.rst:160
 msgid ""
 "Some definitions also use *lookaheads*, which indicate that an element must "
 "(or must not) match at a given position, but without consuming any input:"
 msgstr ""
+"Algunas definiciones también usan *anticipadores*, que indican que un elemento debe "
+"(o no debe) coincidir en una posición determinada, pero sin consumir ninguna entrada:"
 
 #: ../Doc/reference/introduction.rst:163
 msgid "``&e``: a positive lookahead (that is, ``e`` is required to match)"
-msgstr ""
+msgstr "``&e``: una anticipación positiva (es decir, se requiere que ``e`` coincida)"
 
 #: ../Doc/reference/introduction.rst:164
 msgid ""
 "``!e``: a negative lookahead (that is, ``e`` is required *not* to match)"
 msgstr ""
+"``!e``: una anticipación negativa (es decir, *no* se requiere que ``e`` coincida)"
 
 #: ../Doc/reference/introduction.rst:166
 msgid ""
 "The unary operators (``*``, ``+``, ``?``) bind as tightly as possible; the "
 "vertical bar (``|``) binds most loosely."
 msgstr ""
+"Los operadores unarios (``*``, ``+``, ``?``) tienen la mayor precedencia posible; la "
+"barra vertical (``|``) tiene la menor precedencia."
 
 #: ../Doc/reference/introduction.rst:169
 msgid "White space is only meaningful to separate tokens."
-msgstr ""
+msgstr "Los espacios en blanco solo tienen sentido para separar tokens."
 
 #: ../Doc/reference/introduction.rst:171
 msgid ""
 "Rules are normally contained on a single line, but rules that are too long "
 "may be wrapped:"
 msgstr ""
+"Las reglas suelen ocupar una sola línea, pero aquellas que son demasiado largas "
+"pueden ajustarse a varias líneas:"
 
 #: ../Doc/reference/introduction.rst:180
 msgid ""
 "Alternatively, rules may be formatted with the first line ending at the "
 "colon, and each alternative beginning with a vertical bar on a new line. For "
 "example:"
 msgstr ""
+"Alternativamente, las reglas pueden presentarse con la primera línea terminando en "
+"dos puntos, y que cada alternativa comience con una barra vertical en una línea "
+"nueva. Por ejemplo:"
 
 #: ../Doc/reference/introduction.rst:195
 msgid "This does *not* mean that there is an empty first alternative."
-msgstr ""
+msgstr "Esto *no* significa que exista una primera alternativa vacía."
 
 #: ../Doc/reference/introduction.rst:202
 #, fuzzy
 msgid "Lexical and Syntactic definitions"
-msgstr "lexical definitions"
+msgstr "Definiciones Léxicas y sintácticas"
 
 #: ../Doc/reference/introduction.rst:204
 msgid ""
@@ -401,6 +445,11 @@ msgid ""
 "cases the exact boundary between the two phases is a CPython implementation "
 "detail."
 msgstr ""
+"Existe diferencias entre el análisis *léxico* y *sintáctico*: el *:"
+"term:`análisis léxico <lexical analyzer>`* opera en los caracteres individuales de la fuente "
+"de entrada, mientras que *parser* (análisis sintáctico) opera en el flujo de :"
+"term:`tokens <token>` generado por el análisis léxico. NO obstante, en algunos "
+"casos el límite exacto entre ambas fases es un detalle de la implementación de CPython."
 
 #: ../Doc/reference/introduction.rst:211
 msgid ""
@@ -410,33 +459,41 @@ msgid ""
 "`token.INDENT` or :data:`~token.NEWLINE`. *Syntactic* definitions then use "
 "these tokens, rather than source characters."
 msgstr ""
+"La diferencia práctica entre ambas es que, en las definiciones *léxicas*, "
+"todos los espacios blancos son significativos. El analizador léxico :ref:`descarta "
+"<whitespace>` todos los espacios en blanco que no son convertidos a *tokens* como :data:"
+"`token.INDENT` o :data:`~token.NEWLINE`. Las definiciones *sintácticas* usan, por tanto, "
+"estos *tokens*, en lugar de los caracteres de la fuente."
 
 #: ../Doc/reference/introduction.rst:217
 msgid ""
 "This documentation uses the same BNF grammar for both styles of definitions. "
 "All uses of BNF in the next chapter (:ref:`lexical`) are lexical "
 "definitions; uses in subsequent chapters are syntactic definitions."
 msgstr ""
+"Esta documentación usa la misma gramática BNF para ambos estilos de definiciones. "
+"Todos los usos de BNF en el siguiente capítulo (:ref:`léxico<lexical>`) corresponden a definiciones "
+"léxicas; los usos en los posteriores capítulos corresponden a definiciones sintácticas."
 
 #: ../Doc/reference/introduction.rst:91
 msgid "BNF"
 msgstr "BNF"
 
 #: ../Doc/reference/introduction.rst:91
 msgid "grammar"
-msgstr "grammar"
+msgstr "gramática"
 
 #: ../Doc/reference/introduction.rst:91
 msgid "syntax"
-msgstr "syntax"
+msgstr "sintaxis"
 
 #: ../Doc/reference/introduction.rst:91
 msgid "notation"
-msgstr "notation"
+msgstr "notación"
 
 #: ../Doc/reference/introduction.rst:197
 msgid "lexical definitions"
-msgstr "lexical definitions"
+msgstr "definiciones léxicas"
 
 #~ msgid ""
 #~ "Each rule begins with a name (which is the name defined by the rule) and "