sync with en rev

2026-03-23 22:52:12 +01:00 · 2026-03-10 15:33:06 -03:00
parent d33e727ca5
commit 21d5801f13
15 changed files with 41 additions and 96 deletions
--- a/reference/pgsql/functions/pg-affected-rows.xml
+++ b/reference/pgsql/functions/pg-affected-rows.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
 <refentry xml:id="function.pg-affected-rows" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -20,8 +20,7 @@
   <literal>DELETE</literal>.
  </para>
  <para>
-   Desde o PostgreSQL 9.0 e superior, o servidor retorna o número de
-   linhas SELECTed. PostgreSQL mais antigo retorna 0 para SELECT.
+   O servidor também retorna o número de selecioadas.
  </para>
  <note>
   <para>
--- a/reference/pgsql/functions/pg-client-encoding.xml
+++ b/reference/pgsql/functions/pg-client-encoding.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ad618eea48c773ff8768d9d27ea986f81a2a2400 Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.16 -->
 <refentry xml:id="function.pg-client-encoding" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -24,8 +24,7 @@
  </para>
  <note>
   <para>
-    Esta função requer PostgreSQL 7.0 ou
-    superior. Se a libpq for compilada sem suporte à codificação multibyte,
+    Se a libpq for compilada sem suporte à codificação multibyte,
    <function>pg_client_encoding</function> sempre retornará
    <literal>SQL_ASCII</literal>. A codificação suportada depende da versão do
    PostgreSQL. Consulte as codificações suportadas na documentação do PostgreSQL.
--- a/reference/pgsql/functions/pg-escape-identifier.xml
+++ b/reference/pgsql/functions/pg-escape-identifier.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 -->
 <refentry xml:id='function.pg-escape-identifier' xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -29,12 +29,6 @@
   bytea, <function>pg_escape_bytea</function> deve ser usado
   no lugar.
  </para>
-  <note>
-   <para>
-    Esta função possui código de escape interno e também pode ser usada com
-    PostgreSQL 8.4 ou inferior.
-    </para>
-  </note>
 </refsect1>

 <refsect1 role="parameters">
--- a/reference/pgsql/functions/pg-escape-literal.xml
+++ b/reference/pgsql/functions/pg-escape-literal.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 -->
 <refentry xml:id='function.pg-escape-literal' xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -27,12 +27,6 @@
   no lugar. Para identificadores de escape (por exemplo, tabelas, nomes de
   campos), <function>pg_escape_identifier</function> deve ser usado.
  </para>
-  <note>
-   <para>
-    Esta função possui código de escape interno e também pode ser usada com
-    PostgreSQL 8.4 ou inferior.
-    </para>
-  </note>
 </refsect1>

 <refsect1 role="parameters">
--- a/reference/pgsql/functions/pg-escape-string.xml
+++ b/reference/pgsql/functions/pg-escape-string.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 -->
 <refentry xml:id='function.pg-escape-string' xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -27,11 +27,6 @@
   no lugar. <function>pg_escape_identifier</function> deve ser usado para
   escape de identificadores (por exemplo, nomes de tabelas, nomes de campos)
  </para>
-  <note>
-   <para>
-    Esta função requer PostgreSQL 7.2 ou posterior.
-    </para>
-  </note>
 </refsect1>

 <refsect1 role="parameters">
--- a/reference/pgsql/functions/pg-execute.xml
+++ b/reference/pgsql/functions/pg-execute.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
 <refentry xml:id="function.pg-execute" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -26,8 +26,6 @@
   string de consulta. Este recurso permite que comandos que serão usados repetidamente
   sejam analisados e planejados apenas uma vez, em vez de cada vez que forem executados.
   A declaração deve ter sido preparada anteriormente na sessão atual.
-   <function>pg_execute</function> é suportado apenas em conexões PostgreSQL 7.4 ou
-   superior; falhará ao usar versões anteriores.
  </para>
  <para>
   Os parâmetros são idênticos a <function>pg_query_params</function>, exceto que o nome de uma
--- a/reference/pgsql/functions/pg-lo-create.xml
+++ b/reference/pgsql/functions/pg-lo-create.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
 <refentry xml:id="function.pg-lo-create" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -22,11 +22,9 @@
   <function>pg_lo_create</function> cria um objeto grande
   e retorna o <varname>OID</varname> do objeto
   grande. Os modos de acesso do PostgreSQL
-   <constant>INV_READ</constant>, <constant>INV_WRITE</constant> e
-   <constant>INV_ARCHIVE</constant> não são suportados, o
-   objeto é criado sempre com acesso de leitura e
-   gravação. <constant>INV_ARCHIVE</constant> foi removido do próprio PostgreSQL
-   (versão 6.3 e superior).
+   <constant>INV_READ</constant> e <constant>INV_WRITE</constant>
+   não são suportados, o objeto é criado sempre com acesso
+   de leitura e gravação.
  </para>
  <para>
   Para usar a interface de objeto grande, é necessário
@@ -60,9 +58,7 @@
      <para>
       Se um <parameter>object_id</parameter> for fornecido, a função
       tentará criar um objeto grande com este id, caso contrário,
-       um id de objeto livre será atribuído pelo servidor. O parâmetro
-       depende da funcionalidade que apareceu pela primeira
-       vez no PostgreSQL 8.1.
+       um id de objeto livre será atribuído pelo servidor.
      </para>
     </listitem>
    </varlistentry>
--- a/reference/pgsql/functions/pg-parameter-status.xml
+++ b/reference/pgsql/functions/pg-parameter-status.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <refentry xml:id="function.pg-parameter-status" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>pg_parameter_status</refname>
@@ -23,30 +23,14 @@
    parâmetro, se conhecido, ou &false; se o parâmetro não for conhecido.
  </para>
  <para>
-   Os parâmetros relatados no PostgreSQL 8.0 incluem <literal>server_version</literal>,
+   Os parâmetros relatados pelo servidor incluem <literal>server_version</literal>,
   <literal>server_encoding</literal>, <literal>client_encoding</literal>,
   <literal>is_superuser</literal>, <literal>session_authorization</literal>,
   <literal>DateStyle</literal>, <literal>TimeZone</literal> e <literal>integer_datetimes</literal>.
-   (<literal>server_encoding</literal>, <literal>TimeZone</literal> e
-   <literal>integer_datetimes</literal> não foram relatados por versões anteriores a 8.0.) Observe que
+   Observe que
   <literal>server_version</literal>, <literal>server_encoding</literal> e <literal>integer_datetimes</literal>
   não podem ser alterados após a inicialização do PostgreSQL.
  </para>
-  <para>
-   Servidores PostgreSQL 7.3 ou inferiores não informam configurações de parâmetros,
-   <function>pg_parameter_status</function>
-   inclui lógica para obter valores para <literal>server_version</literal> e
-   <literal>client_encoding</literal>
-   de qualquer maneira. As aplicações são incentivadas a usar <function>pg_parameter_status</function> em vez de
-   código ad hoc para determinar esses valores.
-  </para>
-  <caution>
-   <para>
-    Em um servidor PostgreSQL anterior à versão 7.4, alterar
-    <literal>client_encoding</literal> via <literal>SET</literal> após a inicialização
-    da conexão não será refletido por <function>pg_parameter_status</function>.
-   </para>
-  </caution>
 </refsect1>

 <refsect1 role="parameters">
--- a/reference/pgsql/functions/pg-prepare.xml
+++ b/reference/pgsql/functions/pg-prepare.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 469e5fa809cef61c0707d7447a2ab72cd66f65fd Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto,leonardolara -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
 <refentry xml:id="function.pg-prepare" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -23,8 +23,6 @@
   <function>pg_execute</function> ou <function>pg_send_execute</function>.
   Este recurso permite que comandos que serão usados repetidamente
   sejam analisados e planejados apenas uma vez, em vez de cada vez que forem executados.
-   <function>pg_prepare</function> é suportado apenas em conexões PostgreSQL 7.4 ou
-   superior; falhará ao usar versões anteriores.
  </para>
  <para>
   A função cria uma instrução preparada chamada <parameter>stmtname</parameter> a partir da string <parameter>query</parameter>,
--- a/reference/pgsql/functions/pg-query-params.xml
+++ b/reference/pgsql/functions/pg-query-params.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.2 -->
 <refentry xml:id="function.pg-query-params" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -23,8 +23,6 @@
   <function>pg_query_params</function> é como <function>pg_query</function>,
   mas oferece funcionalidade adicional: os valores dos parâmetros
   podem ser especificados separadamente da string de comando propriamente dita.
-   <function>pg_query_params</function> é compatível apenas com conexões PostgreSQL 7.4 ou
-   superior; falhará ao usar versões anteriores.
  </para>
  <para>
   Se parâmetros forem usados, eles serão referidos na string
--- a/reference/pgsql/functions/pg-result-error-field.xml
+++ b/reference/pgsql/functions/pg-result-error-field.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.58 -->
 <refentry xml:id="function.pg-result-error-field" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -16,8 +16,7 @@
  </methodsynopsis>
  <para>
   <function>pg_result_error_field</function> retorna um dos campos de mensagem de erro
-   detalhados associados à instância de <parameter>result</parameter>. Ele está disponível apenas
-   em um servidor PostgreSQL 7.4 ou superior. O campo de erro é especificado pelo
+   detalhados associados à instância de <parameter>result</parameter>. O campo de erro é especificado pelo
   <parameter>field_code</parameter>.
  </para>
  <para>
@@ -50,8 +49,8 @@
         <constant>PGSQL_DIAG_SQLSTATE</constant>, <constant>PGSQL_DIAG_MESSAGE_PRIMARY</constant>,
         <constant>PGSQL_DIAG_MESSAGE_DETAIL</constant>,
         <constant>PGSQL_DIAG_MESSAGE_HINT</constant>, <constant>PGSQL_DIAG_STATEMENT_POSITION</constant>,
-         <constant>PGSQL_DIAG_INTERNAL_POSITION</constant> (somente PostgreSQL 8.0+),
-         <constant>PGSQL_DIAG_INTERNAL_QUERY</constant> (somente PostgreSQL 8.0+),
+         <constant>PGSQL_DIAG_INTERNAL_POSITION</constant>,
+         <constant>PGSQL_DIAG_INTERNAL_QUERY</constant>,
         <constant>PGSQL_DIAG_CONTEXT</constant>, <constant>PGSQL_DIAG_SOURCE_FILE</constant>,
         <constant>PGSQL_DIAG_SOURCE_LINE</constant> ou
         <constant>PGSQL_DIAG_SOURCE_FUNCTION</constant>.
--- a/reference/pgsql/functions/pg-unescape-bytea.xml
+++ b/reference/pgsql/functions/pg-unescape-bytea.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 58645a79f1993effc0571f7b49acc9aace0e417f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <!-- splitted from ./en/functions/pgsql.xml, last change in rev 1.61 -->
 <refentry xml:id="function.pg-unescape-bytea" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
@@ -25,15 +25,6 @@
    prefixados com '\' (por exemplo, \032). Os usuários devem converter de volta para o
    formato binário manualmente.
   </para>
-   <para>
-    Esta função requer PostgreSQL 7.2 ou posterior. Com PostgreSQL
-    7.2.0 e 7.2.1, os valores bytea devem ser convertidos quando você ativa
-    o suporte multibyte. ou seja, <literal>INSERT INTO test_table (image)
-    VALUES ('$image_escaped'::bytea);</literal> PostgreSQL 7.2.2 ou
-    posterior não precisa de conversão. A exceção é quando a codificação de caracteres do cliente e
-    do backend não corresponde e pode haver erro de fluxo de
-    vários bytes. O usuário deve então converter para bytea para evitar esse erro.
-   </para>
  </note>
 </refsect1>

--- a/reference/pgsql/functions/pg-version.xml
+++ b/reference/pgsql/functions/pg-version.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: fernandowobeto Status: ready --><!-- CREDITS: fernandowobeto -->
 <refentry xml:id="function.pg-version" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>pg_version</refname>
@@ -15,9 +15,8 @@
   <methodparam choice="opt"><type class="union"><type>PgSql\Connection</type><type>null</type></type><parameter>connection</parameter><initializer>&null;</initializer></methodparam>
  </methodsynopsis>
  <para>
-   <function>pg_version</function> retorna um array com a versão do cliente, protocolo
-   e servidor. As versões do protocolo e do servidor só estão disponíveis se o PHP
-   tiver sido compilado com PostgreSQL 7.4 ou posterior.
+   <function>pg_version</function> retorna um array com as versões do cliente, do protocolo
+   e do servidor.
  </para>
  <para>
   Para informações mais detalhadas do servidor, use <function>pg_parameter_status</function>.
--- a/reference/pgsql/reference.xml
+++ b/reference/pgsql/reference.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 3ba581880a9e5635109c65cef01a7ca192999ad1 Maintainer: leonardolara Status: ready --><!-- CREDITS: lucasr,felipe,leonardolara -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: leonardolara Status: ready --><!-- CREDITS: lucasr,felipe,leonardolara -->

 <reference xml:id="ref.pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <title>&Functions; PostgreSQL</title>
@@ -32,12 +32,11 @@
   </note>
   <note>
    <para>
-     PostgreSQL não tem comandos especiais para obter informação dos dados do
-     banco de dados (dicionário de dados) (eg. todas as tabelas do banco de dados
-     atual). Ao invés, há um schema padrão chamado <literal>information_schema</literal> no
-     PostgreSQL 7.4 e superior contendo views do sistema com todas as informações
-     necessárias, em um form fácil de acessá-las. Veja a <link
-     xlink:href="&url.pgsql.manual;">Documentação do PostgreSQL</link>
+     PostgreSQL não tem comandos especiais para obter informação do esquema
+     do banco de dados (ex.: todas as tabelas do banco atual). Em vez disso, há
+     um schema padrão chamado <literal>information_schema</literal> contendo
+     visualizações do sistema com todas as informações necessárias, em um formulário
+     facilmente consultável. Veja a <link xlink:href="&url.pgsql.manual;">Documentação do PostgreSQL</link>
     para maiores detalhes.
    </para>
   </note>
--- a/reference/pgsql/setup.xml
+++ b/reference/pgsql/setup.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: leonardolara Status: ready --><!-- CREDITS: lucasr,felipe,leonardolara -->
+<!-- EN-Revision: 5f1a92089fa4efe81e9777f87f9ed93f4853898b Maintainer: leonardolara Status: ready --><!-- CREDITS: lucasr,felipe,leonardolara -->

 <chapter xml:id="pgsql.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.setup;
@@ -8,12 +8,14 @@
 <section xml:id="pgsql.requirements">
  &reftitle.required;
  <para>
-   Para usar usar as funções para PostgreSQL, você precisa
-   do PostgreSQL 6.5 ou superior e PostgreSQL 7.0 ou superior para
-   habilitar todos os recursos deste módulo. PostgreSQL suporta
-   inúmeros tipos de codificação de caracteres incluindo a codificação de
-   caracteres multibyte. A versão mais atual e mais informações sobre PostgreSQL
-   estão disponíveis em <link xlink:href="&url.pgsql;">&url.pgsql;</link> e
+   Para usar usar as funções para PostgreSQL, é necessária a libpq (a biblioteca cliente C
+   do PostgreSQL).
+   A partir do PHP 8.0.0, libpq 9.1 ou posterior é requerida.
+   A partir do PHP 8.4.0, libpq 10.0 ou posterior é requerida.
+   PostgreSQL suporta vários tipos de codificação de caracteres incluindo
+   a codificação multibyte. Informação sobre a versão atual mais
+   detalhes sobre PostgreSQL estão disponíveis em
+   <link xlink:href="&url.pgsql;">&url.pgsql;</link> e na
   <link xlink:href="&url.pgsql.manual;">Documentação do PostgreSQL</link>.
  </para>
 </section>