diff --git a/language-snippets.ent b/language-snippets.ent index 192107853..8816669f7 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,5 +1,5 @@ - + @@ -4593,6 +4593,14 @@ xmlns="http://docbook.org/ns/docbook">Esta función ha sido '> + + + Esta función solo está disponible si la biblioteca readline con la que se compiló + PHP la admite. No está disponible en Windows. + +'> + - - + GNU Readline @@ -19,7 +18,9 @@ línea de comandos. - A partir de PHP 7.1.0 esta extensión es soportada en Windows. + A partir de PHP 7.1.0 esta extensión es soportada en Windows, donde está compilada + contra libedit. No todas las funciones están presentes en esa compilación; véase + los requisitos. ¡La extensión readline no es thread-safe! Por consiguiente, el uso de esta diff --git a/reference/readline/functions/readline-callback-handler-install.xml b/reference/readline/functions/readline-callback-handler-install.xml index 1dffd164b..3f986feb7 100644 --- a/reference/readline/functions/readline-callback-handler-install.xml +++ b/reference/readline/functions/readline-callback-handler-install.xml @@ -1,7 +1,6 @@ - - + readline_callback_handler_install @@ -28,6 +27,7 @@ la interconexión IO / entrada de usuario, a diferencia de readline. + &readline.system-callback-support; diff --git a/reference/readline/functions/readline-callback-handler-remove.xml b/reference/readline/functions/readline-callback-handler-remove.xml index 577142285..2a52686e2 100644 --- a/reference/readline/functions/readline-callback-handler-remove.xml +++ b/reference/readline/functions/readline-callback-handler-remove.xml @@ -1,7 +1,6 @@ - - + readline_callback_handler_remove @@ -18,6 +17,7 @@ Elimina un manejador de devolución de llamada instalado previamente y restaura los parámetros del terminal. + &readline.system-callback-support; diff --git a/reference/readline/functions/readline-callback-read-char.xml b/reference/readline/functions/readline-callback-read-char.xml index ee340ed57..6fe07a01d 100644 --- a/reference/readline/functions/readline-callback-read-char.xml +++ b/reference/readline/functions/readline-callback-read-char.xml @@ -1,7 +1,6 @@ - - + readline_callback_read_char @@ -19,6 +18,7 @@ función informa a la interfaz de devolución de llamada readline instalada mediante readline_callback_handler_install de que una línea está lista para ser ingresada. + &readline.system-callback-support; diff --git a/reference/readline/functions/readline-list-history.xml b/reference/readline/functions/readline-list-history.xml index cb1ff239a..8552d54bc 100644 --- a/reference/readline/functions/readline-list-history.xml +++ b/reference/readline/functions/readline-list-history.xml @@ -1,7 +1,6 @@ - - + readline_list_history @@ -17,6 +16,11 @@ Lista el historial. + + Esta función solo está disponible si la biblioteca readline con la que se compiló + PHP proporciona listado de historial. Esto siempre es el caso con GNU Readline + y en Windows. + diff --git a/reference/readline/functions/readline-on-new-line.xml b/reference/readline/functions/readline-on-new-line.xml index d073a5680..54b8829f2 100644 --- a/reference/readline/functions/readline-on-new-line.xml +++ b/reference/readline/functions/readline-on-new-line.xml @@ -1,7 +1,6 @@ - - + readline_on_new_line @@ -17,6 +16,7 @@ Indica a readline que el cursor ha pasado a una nueva línea. + &readline.system-callback-support; @@ -31,13 +31,11 @@ - - &reftitle.notes; - - - Esta función solo está disponible si es soportada por la biblioteca readline subyacente. No es soportada en Windows. - - + + &reftitle.seealso; + + readline_callback_handler_install + - - + readline_redisplay @@ -17,6 +16,7 @@ Solicita a readline que vuelva a mostrar la información. + &readline.system-callback-support; @@ -30,6 +30,13 @@ &return.void; + + + &reftitle.seealso; + + readline_callback_handler_install + + - - + &reftitle.setup; @@ -20,6 +19,20 @@ y disponible para descarga en &url.libedit;. + + Ambas bibliotecas no ofrecen las mismas funcionalidades, por lo que algunas funciones + están ausentes en ciertas compilaciones. Las funciones que gestionan la interfaz de + devolución de llamada, + readline_callback_handler_install, + readline_callback_handler_remove, + readline_callback_read_char, + readline_redisplay y + readline_on_new_line, solo están presentes cuando la biblioteca + subyacente las proporciona, y están ausentes en Windows. Llamar a una función ausente + lanza una Error. + function_exists permite comprobar si una función dada está disponible, + y la constante READLINE_LIB indica qué biblioteca se está utilizando. +