cvs: phpdoc /es/functions readline.xml
| From: | Rafael Martinez | Date: | Wed, 29 Nov 2000 15:15:10 +0000 |
| Subject: | cvs: phpdoc /es/functions readline.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969333113@lists.php.net to get a copy of this message | ||
rafael Wed Nov 29 07:15:10 2000 EDT
Modified files:
/phpdoc/es/functions readline.xml
Log:
Traduction
Index: phpdoc/es/functions/readline.xml diff -u phpdoc/es/functions/readline.xml:1.1 phpdoc/es/functions/readline.xml:1.2 --- phpdoc/es/functions/readline.xml:1.1 Mon Aug 21 23:24:03 2000 +++ phpdoc/es/functions/readline.xml Wed Nov 29 07:15:10 2000 @@ -1,32 +1,31 @@ - <reference id="ref.readline"> +<reference id="ref.readline"> <title>GNU Readline</title> <titleabbrev>Readline</titleabbrev> <partintro> <simpara> - The <function>readline</function> functions implement an interface - to the GNU Readline library. These are functions that provide - editable command lines. An example being the way Bash allows you - to use the arrow keys to insert characters or scroll through - command history. Because of the interactive nature of this - library, it will be of little use for writing Web applications, - but may be useful when writing scripts meant to be run from a - shell. + Las funciones <function>readline</function> implementan una interfaz + con la librería GNU Readline. Un ejemplo de la manera de funcionar + podría ser la forma en que el Bash permite usar las flechas de dirección + para insertar carácteres o desplazarse a través del historial de comandos. + Debido a la naturaleza interactiva de esta libreria, tendrá un uso muy + reducido en la escritura de aplicaciones Web, aunque puede ser útil + para scripts que han de ser ejecutados desde la consola. </simpara> <simpara> - The home page of the GNU Readline project is - <ulink url="&url.readline;">&url.readline;</ulink>. It's maintained - by Chet Ramey, who's also the author of Bash. + La página principal del proyecto GNU Readline es + <ulink url="&url.readline;">&url.readline;</ulink>. Está actualizada por + Chet Ramey, quien además es el autor de Bash. </simpara> </partintro> <refentry id="function.readline"> <refnamediv> <refname>readline</refname> - <refpurpose>Reads a line</refpurpose> + <refpurpose>Lee una línea</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>string <function>readline</function></funcdef> @@ -36,25 +35,25 @@ </funcprototype> </funcsynopsis> <para> - This function returns a single string from the user. You may - specify a string with which to prompt the user. The line - returned has the ending newline removed. You must add this line - to the history yourself using + Esta función devuelve una única cadena del usuario. Puede especificar + una cadena que se mostrará al usuario. La línea devuelta tiene + el indicador final de nueva línea eliminado. Necesita añadir esta + línea al historial usando la función <function>readline_add_history</function>. </para> <example> <title><function>Readline</function></title> <programlisting role="php"> -//get 3 commands from user +//obtiene 3 comandos del usuario for ($i=0; $i < 3; $i++) { - $line = readline ("Command: "); + $line = readline ("Comando: "); readline_add_history ($line); } -//dump history +//Vuelca el historial print_r (readline_list_history()); -//dump variables +//Vuelca las variables print_r (readline_info()); </programlisting> </example> @@ -64,10 +63,10 @@ <refentry id="function.readline-add-history"> <refnamediv> <refname>readline_add_history</refname> - <refpurpose>Adds a line to the history</refpurpose> + <refpurpose>Añade una línea al historial</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>void <function>readline_add_history</function></funcdef> @@ -75,7 +74,7 @@ </funcprototype> </funcsynopsis> <para> - This function adds a line to the command line history. + Esta función añade una línea al historial de líneas de comandos. </para> </refsect1> </refentry> @@ -83,10 +82,10 @@ <refentry id="function.readline-clear-history"> <refnamediv> <refname>readline_clear_history</refname> - <refpurpose>Clears the history</refpurpose> + <refpurpose>Borra el historial</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>readline_clear_history</function></funcdef> @@ -94,7 +93,7 @@ </funcprototype> </funcsynopsis> <para> - This function clears the entire command line history. + Esta función borra por completo el historial de la línea de comandos. </para> </refsect1> </refentry> @@ -102,10 +101,10 @@ <refentry id="function.readline-completion-function"> <refnamediv> <refname>readline_completion_function</refname> - <refpurpose>Registers a completion function</refpurpose> + <refpurpose>Registra una función de completitud</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>boolean @@ -115,11 +114,11 @@ </funcprototype> </funcsynopsis> <para> - This function registers a completion function. You must supply - the name of an existing function which accepts a partial command - line and returns an array of possible matches. This is the same - kind of functionality you'd get if you hit your tab key while - using Bash. + Esta función registra una función de completitud. Debe proporcionar + el nombre de una función existente que acepte una línea de comandos + parcial y devuelva una array con posibles coincidencias. Es el mismo + tipo de funcionalidad que se obtiene al pulsar la tecla de tabulación + cuando se está usando el Bash. </para> </refsect1> </refentry> @@ -127,10 +126,10 @@ <refentry id="function.readline-info"> <refnamediv> <refname>readline_info</refname> - <refpurpose>Gets/sets various internal readline variables</refpurpose> + <refpurpose>Establece/Obtiene diversas variables internas de readline</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>readline_info</function></funcdef> @@ -143,16 +142,16 @@ </funcprototype> </funcsynopsis> <para> - If called with no parameters, this function returns an array of - values for all the setting readline uses. The elements will will - be indexed by the following values: done, end, erase_empty_line, + Si es llamada sin parámetros, esta función devuelve un array con + los valores de todas las opciones que readline usa. Los elementos + vendrán indexados por los siguientes valores: done, end, erase_empty_line, library_version, line_buffer, mark, pending_input, point, prompt, - readline_name, and terminal_name. + readline_name, y terminal_name. </para> <para> - If called with one parameter, the value of that setting is - returned. If called with two parameters, the setting will be - changed to the given value. + Si es llamada con un parámetros, devuelve el valor de esa opción. + Si es llamada con dos parámetros, el valor de la opción será + cambiado al parámetro dado. </para> </refsect1> </refentry> @@ -160,10 +159,10 @@ <refentry id="function.readline-list-history"> <refnamediv> <refname>readline_list_history</refname> - <refpurpose>Lists the history</refpurpose> + <refpurpose>Lista el historial</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>array <function>readline_list_history</function></funcdef> @@ -171,8 +170,8 @@ </funcprototype> </funcsynopsis> <para> - This function returns an array of the entire command line - history. The elements are indexed by integers starting at zero. + Esta función devuelve un array con el historial de líneas de comandos + completo. Los elementos están indexados por enteros comenzando por el cero. </para> </refsect1> </refentry> @@ -180,10 +179,10 @@ <refentry id="function.readline-read-history"> <refnamediv> <refname>readline_read_history</refname> - <refpurpose>Reads the history</refpurpose> + <refpurpose>Lee un historial</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>boolean @@ -193,7 +192,7 @@ </funcprototype> </funcsynopsis> <para> - This function reads a command history from a file. + Esta función lee un historial de comandos desde un fichero. </para> </refsect1> </refentry> @@ -202,10 +201,10 @@ <refentry id="function.readline-write-history"> <refnamediv> <refname>readline_write_history</refname> - <refpurpose>Writes the history</refpurpose> + <refpurpose>Escribe el historial</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>boolean @@ -215,7 +214,7 @@ </funcprototype> </funcsynopsis> <para> - This function writes the command history to a file. + Esta función escribe el historial de comandos en un archivo. </para> </refsect1> </refentry> @@ -238,3 +237,4 @@ sgml-local-ecat-files:nil End: --> +
Index: phpdoc/es/functions/readline.xml diff -u phpdoc/es/functions/readline.xml:1.1 phpdoc/es/functions/readline.xml:1.2 --- phpdoc/es/functions/readline.xml:1.1 Mon Aug 21 23:24:03 2000 +++ phpdoc/es/functions/readline.xml Wed Nov 29 07:15:10 2000 @@ -1,32 +1,31 @@ - <reference id="ref.readline"> +<reference id="ref.readline"> <title>GNU Readline</title> <titleabbrev>Readline</titleabbrev> <partintro> <simpara> - The <function>readline</function> functions implement an interface - to the GNU Readline library. These are functions that provide - editable command lines. An example being the way Bash allows you - to use the arrow keys to insert characters or scroll through - command history. Because of the interactive nature of this - library, it will be of little use for writing Web applications, - but may be useful when writing scripts meant to be run from a - shell. + Las funciones <function>readline</function> implementan una interfaz + con la librería GNU Readline. Un ejemplo de la manera de funcionar + podría ser la forma en que el Bash permite usar las flechas de dirección + para insertar carácteres o desplazarse a través del historial de comandos. + Debido a la naturaleza interactiva de esta libreria, tendrá un uso muy + reducido en la escritura de aplicaciones Web, aunque puede ser útil + para scripts que han de ser ejecutados desde la consola. </simpara> <simpara> - The home page of the GNU Readline project is - <ulink url="&url.readline;">&url.readline;</ulink>. It's maintained - by Chet Ramey, who's also the author of Bash. + La página principal del proyecto GNU Readline es + <ulink url="&url.readline;">&url.readline;</ulink>. Está actualizada por + Chet Ramey, quien además es el autor de Bash. </simpara> </partintro> <refentry id="function.readline"> <refnamediv> <refname>readline</refname> - <refpurpose>Reads a line</refpurpose> + <refpurpose>Lee una línea</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>string <function>readline</function></funcdef> @@ -36,25 +35,25 @@ </funcprototype> </funcsynopsis> <para> - This function returns a single string from the user. You may - specify a string with which to prompt the user. The line - returned has the ending newline removed. You must add this line - to the history yourself using + Esta función devuelve una única cadena del usuario. Puede especificar + una cadena que se mostrará al usuario. La línea devuelta tiene + el indicador final de nueva línea eliminado. Necesita añadir esta + línea al historial usando la función <function>readline_add_history</function>. </para> <example> <title><function>Readline</function></title> <programlisting role="php"> -//get 3 commands from user +//obtiene 3 comandos del usuario for ($i=0; $i < 3; $i++) { - $line = readline ("Command: "); + $line = readline ("Comando: "); readline_add_history ($line); } -//dump history +//Vuelca el historial print_r (readline_list_history()); -//dump variables +//Vuelca las variables print_r (readline_info()); </programlisting> </example> @@ -64,10 +63,10 @@ <refentry id="function.readline-add-history"> <refnamediv> <refname>readline_add_history</refname> - <refpurpose>Adds a line to the history</refpurpose> + <refpurpose>Añade una línea al historial</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>void <function>readline_add_history</function></funcdef> @@ -75,7 +74,7 @@ </funcprototype> </funcsynopsis> <para> - This function adds a line to the command line history. + Esta función añade una línea al historial de líneas de comandos. </para> </refsect1> </refentry> @@ -83,10 +82,10 @@ <refentry id="function.readline-clear-history"> <refnamediv> <refname>readline_clear_history</refname> - <refpurpose>Clears the history</refpurpose> + <refpurpose>Borra el historial</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>boolean <function>readline_clear_history</function></funcdef> @@ -94,7 +93,7 @@ </funcprototype> </funcsynopsis> <para> - This function clears the entire command line history. + Esta función borra por completo el historial de la línea de comandos. </para> </refsect1> </refentry> @@ -102,10 +101,10 @@ <refentry id="function.readline-completion-function"> <refnamediv> <refname>readline_completion_function</refname> - <refpurpose>Registers a completion function</refpurpose> + <refpurpose>Registra una función de completitud</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>boolean @@ -115,11 +114,11 @@ </funcprototype> </funcsynopsis> <para> - This function registers a completion function. You must supply - the name of an existing function which accepts a partial command - line and returns an array of possible matches. This is the same - kind of functionality you'd get if you hit your tab key while - using Bash. + Esta función registra una función de completitud. Debe proporcionar + el nombre de una función existente que acepte una línea de comandos + parcial y devuelva una array con posibles coincidencias. Es el mismo + tipo de funcionalidad que se obtiene al pulsar la tecla de tabulación + cuando se está usando el Bash. </para> </refsect1> </refentry> @@ -127,10 +126,10 @@ <refentry id="function.readline-info"> <refnamediv> <refname>readline_info</refname> - <refpurpose>Gets/sets various internal readline variables</refpurpose> + <refpurpose>Establece/Obtiene diversas variables internas de readline</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>mixed <function>readline_info</function></funcdef> @@ -143,16 +142,16 @@ </funcprototype> </funcsynopsis> <para> - If called with no parameters, this function returns an array of - values for all the setting readline uses. The elements will will - be indexed by the following values: done, end, erase_empty_line, + Si es llamada sin parámetros, esta función devuelve un array con + los valores de todas las opciones que readline usa. Los elementos + vendrán indexados por los siguientes valores: done, end, erase_empty_line, library_version, line_buffer, mark, pending_input, point, prompt, - readline_name, and terminal_name. + readline_name, y terminal_name. </para> <para> - If called with one parameter, the value of that setting is - returned. If called with two parameters, the setting will be - changed to the given value. + Si es llamada con un parámetros, devuelve el valor de esa opción. + Si es llamada con dos parámetros, el valor de la opción será + cambiado al parámetro dado. </para> </refsect1> </refentry> @@ -160,10 +159,10 @@ <refentry id="function.readline-list-history"> <refnamediv> <refname>readline_list_history</refname> - <refpurpose>Lists the history</refpurpose> + <refpurpose>Lista el historial</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>array <function>readline_list_history</function></funcdef> @@ -171,8 +170,8 @@ </funcprototype> </funcsynopsis> <para> - This function returns an array of the entire command line - history. The elements are indexed by integers starting at zero. + Esta función devuelve un array con el historial de líneas de comandos + completo. Los elementos están indexados por enteros comenzando por el cero. </para> </refsect1> </refentry> @@ -180,10 +179,10 @@ <refentry id="function.readline-read-history"> <refnamediv> <refname>readline_read_history</refname> - <refpurpose>Reads the history</refpurpose> + <refpurpose>Lee un historial</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>boolean @@ -193,7 +192,7 @@ </funcprototype> </funcsynopsis> <para> - This function reads a command history from a file. + Esta función lee un historial de comandos desde un fichero. </para> </refsect1> </refentry> @@ -202,10 +201,10 @@ <refentry id="function.readline-write-history"> <refnamediv> <refname>readline_write_history</refname> - <refpurpose>Writes the history</refpurpose> + <refpurpose>Escribe el historial</refpurpose> </refnamediv> <refsect1> - <title>Description</title> + <title>Descripción</title> <funcsynopsis> <funcprototype> <funcdef>boolean @@ -215,7 +214,7 @@ </funcprototype> </funcsynopsis> <para> - This function writes the command history to a file. + Esta función escribe el historial de comandos en un archivo. </para> </refsect1> </refentry> @@ -238,3 +237,4 @@ sgml-local-ecat-files:nil End: --> +