From b9e3dbfbaa4b09ea90770f5c23c2644085af3ecc Mon Sep 17 00:00:00 2001 From: Gina Peter Banyard Date: Mon, 26 Jan 2026 15:31:25 +0000 Subject: [PATCH] readline: fix XML by converting para to simpara tags via script --- reference/readline/book.xml | 20 ++++++++--------- reference/readline/configure.xml | 15 ++++++------- .../functions/readline-add-history.xml | 14 ++++++------ .../readline-callback-handler-install.xml | 22 +++++++++---------- .../readline-callback-handler-remove.xml | 14 ++++++------ .../functions/readline-callback-read-char.xml | 14 ++++++------ .../functions/readline-clear-history.xml | 13 ++++++----- .../readline-completion-function.xml | 14 ++++++------ .../readline/functions/readline-info.xml | 22 +++++++++---------- .../functions/readline-list-history.xml | 14 ++++++------ .../functions/readline-on-new-line.xml | 17 +++++++------- .../functions/readline-read-history.xml | 14 ++++++------ .../readline/functions/readline-redisplay.xml | 13 +++++------ .../functions/readline-write-history.xml | 14 ++++++------ reference/readline/functions/readline.xml | 14 ++++++------ reference/readline/ini.xml | 10 ++++----- reference/readline/setup.xml | 16 ++++++-------- 17 files changed, 127 insertions(+), 133 deletions(-) diff --git a/reference/readline/book.xml b/reference/readline/book.xml index 8628f378a..8f531af2d 100644 --- a/reference/readline/book.xml +++ b/reference/readline/book.xml @@ -1,7 +1,7 @@ - - - + + + Readline GNU Readline @@ -9,7 +9,7 @@ &reftitle.intro; - + As funções readline implementam uma interface para a biblioteca Readline GNU. Estas são funções que fornecem linhas de comando editáveis. Um exeplo é a maneira que o Bash permite @@ -18,15 +18,15 @@ biblioteca, ela será de pouco uso para escrever aplicações Web, mas pode ser util ao escrever scripts usados a partir de uma linha de comando. - - + + A partir do PHP 7.1.0 esta extensão é suportada no Windows. - + - + A extensão readline não é segura para threads! Portanto, o uso dela com qualquer SAPI verdadeiramente segura para threads (como mod_winnt do Apache) é fortemente desencorajado. - + @@ -36,7 +36,6 @@ &reference.readline.reference; - - diff --git a/reference/readline/configure.xml b/reference/readline/configure.xml index 70815921e..28bd33f4b 100644 --- a/reference/readline/configure.xml +++ b/reference/readline/configure.xml @@ -1,19 +1,19 @@ - -
+ + +
&reftitle.install; - + Para usar estas funções, as versões CGI ou CLI do PHP devem ser compiladas com suporte a readline. É necessário configurar o PHP com a opção . Se a intenção for usar a biblioteca substituta libedit, o PHP deve ser configurado com . - - + + No Windows, esta extensão está disponível por padrão a partir do PHP 7.1.0. - +
- - diff --git a/reference/readline/functions/readline-add-history.xml b/reference/readline/functions/readline-add-history.xml index 570aa28ee..e640c9fac 100644 --- a/reference/readline/functions/readline-add-history.xml +++ b/reference/readline/functions/readline-add-history.xml @@ -1,5 +1,5 @@ - + @@ -13,9 +13,9 @@ truereadline_add_history stringprompt - + Esta função adiciona uma linha ao histórico da linha de comando. - + @@ -24,9 +24,9 @@ prompt - + A linha a ser adicionada ao histórico. - + @@ -34,9 +34,9 @@ &reftitle.returnvalues; - + &return.true.always; - + + readline_callback_handler_install @@ -13,18 +13,18 @@ stringprompt callablecallback - + Configura uma interface de chamada de retorno readline, mostra o prompt e retorna imediatamente. Chamar esta função duas vezes sem remover a interface de chamada anterior irá automaticamente e convenientemente sobrescrever a interface antiga. - - + + O recurso de chamada de retorno é útil quando combinada com stream_select já que permite as it allows intercalação de E/S e de entrada de usuário, diferentemente da função readline. - + @@ -33,18 +33,18 @@ prompt - + A mensagem do prompt. - + callback - + A função definida em callback leva um parâmetro; a entrada do usuário retornada. - + @@ -52,9 +52,9 @@ &reftitle.returnvalues; - + &return.true.always; - + diff --git a/reference/readline/functions/readline-callback-handler-remove.xml b/reference/readline/functions/readline-callback-handler-remove.xml index 5f63fe424..64e2e07dd 100644 --- a/reference/readline/functions/readline-callback-handler-remove.xml +++ b/reference/readline/functions/readline-callback-handler-remove.xml @@ -1,5 +1,5 @@ - + readline_callback_handler_remove @@ -12,10 +12,10 @@ boolreadline_callback_handler_remove - + Remove um manipulador de chamada de retorno previamente instalado e restaura a configuração do terminal. - + @@ -25,18 +25,18 @@ &reftitle.returnvalues; - + Retorna &true; se o manipulador de chamada de retorno previamente instalado for removido, ou &false; se ele não puder ser encontrado. - + &reftitle.examples; - + Consulte readline_callback_handler_install para um exemplo de como usar a interface de chamada de retorno de readline. - + diff --git a/reference/readline/functions/readline-callback-read-char.xml b/reference/readline/functions/readline-callback-read-char.xml index 3f7ed7c1e..fd7795c59 100644 --- a/reference/readline/functions/readline-callback-read-char.xml +++ b/reference/readline/functions/readline-callback-read-char.xml @@ -1,5 +1,5 @@ - + readline_callback_read_char @@ -12,12 +12,12 @@ voidreadline_callback_read_char - + Lê um caractere de entrada do usuário. Quando uma linha é recebida, esta função informa a interface de chamada de retorno de readline, instalada usando readline_callback_handler_install, que uma linha está pronta para entrada. - + @@ -27,17 +27,17 @@ &reftitle.returnvalues; - + &return.void; - + &reftitle.examples; - + Consulte readline_callback_handler_install para um exemplo de como usar a interface de chamada de retorno de readline. - + diff --git a/reference/readline/functions/readline-clear-history.xml b/reference/readline/functions/readline-clear-history.xml index 432afb662..fcd195a08 100644 --- a/reference/readline/functions/readline-clear-history.xml +++ b/reference/readline/functions/readline-clear-history.xml @@ -1,6 +1,7 @@ - - + + + readline_clear_history Limpa o histórico @@ -12,9 +13,9 @@ truereadline_clear_history - + Esta função limpa todo o histórico da linha de comando. - + @@ -24,9 +25,9 @@ &reftitle.returnvalues; - + &return.true.always; - + + @@ -13,10 +13,10 @@ boolreadline_completion_function callablecallback - + Esta função registra uma função de completamento. Este é o mesmo tipo de funcionamento ao pressionar a tecla de tabulação enquanto estiver usando o Bash. - + @@ -25,10 +25,10 @@ callback - + Deve-se usar o nome de uma função existente que aceite uma linha de comando parcial e retorne um array de combinações possíveis. - + @@ -36,9 +36,9 @@ &reftitle.returnvalues; - + &return.success; - + + @@ -14,9 +14,9 @@ stringnullvar_name&null; intstringboolnullvalue&null; - + Obtém ou define várias variáveis internas da readline. - + @@ -25,17 +25,17 @@ var_name - + Um nome de variável. - + value - + Se fornecido, este será o novo valor. - + @@ -43,7 +43,7 @@ &reftitle.returnvalues; - + Se for utilizada sem parâmetros, esta função retorna um array de valores para as configurações que a readline usa. Os elementos serão indexados pelos seguintes valores: done, end, erase_empty_line, @@ -51,10 +51,10 @@ readline_name, e terminal_name. O &array; conterá apenas os elementos suportados pela biblioteca usada para construir a extensão readline. - - + + Se for utilizada com um ou dois parâmetros, o antigo valor é retornado. - + diff --git a/reference/readline/functions/readline-list-history.xml b/reference/readline/functions/readline-list-history.xml index 80a31cb52..d363650d3 100644 --- a/reference/readline/functions/readline-list-history.xml +++ b/reference/readline/functions/readline-list-history.xml @@ -1,6 +1,7 @@ - - + + + readline_list_history Lista o histórico @@ -12,9 +13,9 @@ arrayreadline_list_history - + Obtém o histório completo da linha de comando. - + @@ -24,14 +25,13 @@ &reftitle.returnvalues; - + Retorna um array do histórico completo da linha de comando. Os elementos são indexados por inteiros iniciando de zero. - + - - + + readline_on_new_line Informa à readline que o cursor se moveu para uma nova linha @@ -12,9 +12,9 @@ voidreadline_on_new_line - + Informa à readline que o cursor se moveu para uma nova linha. - + @@ -24,22 +24,21 @@ &reftitle.returnvalues; - + &return.void; - + &reftitle.notes; - + Esta função somente está disponível se suportada pela biblioteca readline subjacente. Não é suportada no Windows. - + - + @@ -13,9 +13,9 @@ boolreadline_read_history stringnullfilename&null; - + Esta função lê o histórico de comandos de um arquivo. - + @@ -24,9 +24,9 @@ filename - + Caminho para o nome do arquivo contendo o histórico de comando. - + @@ -34,9 +34,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/readline/functions/readline-redisplay.xml b/reference/readline/functions/readline-redisplay.xml index 01585ba75..5c836b09b 100644 --- a/reference/readline/functions/readline-redisplay.xml +++ b/reference/readline/functions/readline-redisplay.xml @@ -1,6 +1,6 @@ - - + + readline_redisplay Redesenha a tela @@ -12,9 +12,9 @@ voidreadline_redisplay - + Redesenha readline para atualizar a tela. - + @@ -24,12 +24,11 @@ &reftitle.returnvalues; - + &return.void; - + - + @@ -13,9 +13,9 @@ boolreadline_write_history stringnullfilename&null; - + Esta função escreve o histórico dos comandos em um arquivo. - + @@ -24,9 +24,9 @@ filename - + Caminho para salvar o arquivo. - + @@ -34,9 +34,9 @@ &reftitle.returnvalues; - + &return.success; - + diff --git a/reference/readline/functions/readline.xml b/reference/readline/functions/readline.xml index 7da5a57d7..1b672a679 100644 --- a/reference/readline/functions/readline.xml +++ b/reference/readline/functions/readline.xml @@ -1,5 +1,5 @@ - + @@ -13,10 +13,10 @@ stringfalsereadline stringnullprompt&null; - + Lê uma única linha do usuário. Esta linha precisa ser adicionada manualmente ao histórico usando readline_add_history. - + @@ -25,9 +25,9 @@ prompt - + Pode-se especificar uma string que será o prompt para o usuário. - + @@ -35,11 +35,11 @@ &reftitle.returnvalues; - + Retorna uma string do usuário. A linha retornada tem o caractere de nova linha removido do final. Se não houver mais dados para ler, então &false; é retornado. - + diff --git a/reference/readline/ini.xml b/reference/readline/ini.xml index bcbf7a36e..ebb7ae0d4 100644 --- a/reference/readline/ini.xml +++ b/reference/readline/ini.xml @@ -1,5 +1,5 @@ - +
&reftitle.runtime; &extension.runtime; @@ -40,10 +40,10 @@ string - + Ferramenta externa para mostrar a saída da linha de comando. - + @@ -52,9 +52,9 @@ string - + Prompt da linha de comando. - + diff --git a/reference/readline/setup.xml b/reference/readline/setup.xml index da38bda6d..20e2d9e58 100644 --- a/reference/readline/setup.xml +++ b/reference/readline/setup.xml @@ -1,24 +1,24 @@ - - - + + + &reftitle.setup;
&reftitle.required; - + Para usar as funções readline, é necessário instalar o libreadlinem que pode ser encontrado na página inicial do projeto Readline GNU, em &url.readline;. É mantido por Chet Ramey, que também é autor do Bash. - - + + Essas funções também podem ser usadas com a biblioteca libedit, uma substituição não-GPL para a biblioteca readline. A biblioteca libedit é licenciada por BSD e está disponível para download em &url.libedit;. - +
@@ -29,7 +29,6 @@ &reference.readline.ini;
- -