Merge vers la 9.4.0

gleu · Dec 19, 2014 · 861ea0c · 861ea0c
1 parent 666f7c8
commit 861ea0c
Show file tree

Hide file tree

Showing 11 changed files with 461 additions and 455 deletions.
diff --git a/postgresql/config.xml b/postgresql/config.xml
diff --git a/postgresql/datatype.xml b/postgresql/datatype.xml
@@ -3282,9 +3282,10 @@ SELECT personne.nom, vacances.nombre_de_semaines FROM personne, vacances
     </indexterm>
 
     <para>
-     Les lignes (<type>line</type>) sont représentées à l'aide de leur équation
-     linéaire Ax + By + C = 0, où ni A ni B ne vaut zéro.  Les valeurs de type
-     <type>line</type> sont saisis et affichés de la manière suivante&nbsp;
+     Lines are represented by the linear
+     equation <replaceable>A</replaceable>x + <replaceable>B</replaceable>y + <replaceable>C</replaceable> = 0,
+     where <replaceable>A</replaceable> and <replaceable>B</replaceable> are not both zero.  Values
+     of type <type>line</type> are input and output in the following form:
 <synopsis>
 { <replaceable>A</replaceable>, <replaceable>B</replaceable>, <replaceable>C</replaceable> }
 </synopsis>
@@ -3303,7 +3304,7 @@ SELECT personne.nom, vacances.nombre_de_semaines FROM personne, vacances
      <literal>(<replaceable>x1</replaceable>,<replaceable>y1</replaceable>)</literal>
      et
      <literal>(<replaceable>x2</replaceable>,<replaceable>y2</replaceable>)</literal>
-     sont deux points (différents) sur la ligne.
+     sont deux points différents sur la ligne.
     </para>
    </sect2>
 
@@ -3319,8 +3320,9 @@ SELECT personne.nom, vacances.nombre_de_semaines FROM personne, vacances
     </indexterm>
 
     <para>
-     Les segments de droite (<type>lseg</type>) sont représentés sous la forme de
-     paires de points à l'aide d'une des syntaxes suivantes&nbsp;:
+     Line segments are represented by pairs of points that are the endpoints
+     of the segment.  Values of type <type>lseg</type> are specified using any
+     of the following syntaxes:
 
 <synopsis>[ ( <replaceable>x1</replaceable> , <replaceable>y1</replaceable> ) , ( <replaceable>x2</replaceable> , <replaceable>y2</replaceable> ) ]
 ( ( <replaceable>x1</replaceable> , <replaceable>y1</replaceable> ) , ( <replaceable>x2</replaceable> , <replaceable>y2</replaceable> ) )

diff --git a/postgresql/extend.xml b/postgresql/extend.xml
@@ -1157,10 +1157,10 @@ make -f /path/to/extension/source/tree/Makefile install
     de le faire revient à utiliser le script
     <filename>config/prep_buildtree</filename>. Une fois que cela est fait, vous
     pouvez lancer la construction en configurant la variable
-    <varname>USE_VPATH</varname> de <literal>make</literal> ainsi&nbsp;
+    <varname>VPATH</varname> de <literal>make</literal> ainsi&nbsp;
 <programlisting>
-make USE_VPATH=/path/to/extension/source/tree
-make USE_VPATH=/path/to/extension/source/tree install
+make VPATH=/path/to/extension/source/tree
+make VPATH=/path/to/extension/source/tree install
 </programlisting>
     Cette procédure peut fonctionner avec une grande variété de disposition de
     répertoires.

diff --git a/postgresql/libpq.xml b/postgresql/libpq.xml
@@ -133,8 +133,11 @@ PGconn *PQconnectdbParams(const char * const *keywords,
       <para>
        Quand <literal>expand_dbname</literal> est différent de zéro, la valeur
        du mot-clé <parameter>dbname</parameter> peut être reconnue comme une
-       chaîne de connexion. Les formats possibles sont disponibles dans
-       <xref linkend="libpq-connstring"/> avec de nombreux détails.
+       chaîne de connexion. Only the first occurrence of
+       <parameter>dbname</parameter> is expanded this way, any subsequent
+       <parameter>dbname</parameter> value is processed as plain database name. More
+       details on the possible connection string formats appear in
+       <xref linkend="libpq-connstring"/>.
       </para>
 
       <para>
@@ -1502,24 +1505,6 @@ typedef struct
      </listitem>
     </varlistentry>
 
-    <varlistentry id="libpq-pqhostaddr">
-     <term>
-      <function>PQhostaddr</function>
-      <indexterm>
-       <primary>PQhostaddr</primary>
-      </indexterm>
-     </term>
-
-     <listitem>
-      <para>
-       Renvoie l'adresse IP numérique du serveur utilisé pour la connexion.
-       <synopsis>
-       char *PQhostaddr(const PGconn *conn);
-       </synopsis>
-      </para>
-     </listitem>
-    </varlistentry>
-
     <varlistentry id="libpq-pqport">
      <term><function>PQport</function><indexterm><primary>PQport</primary></indexterm></term>
      <listitem>

diff --git a/postgresql/plpgsql.xml b/postgresql/plpgsql.xml
@@ -1082,15 +1082,26 @@ END;
      toujours true pour <literal>FOUND</literal>.
     </para>
 
+    <para>
+     For <command>INSERT</command>/<command>UPDATE</command>/<command>DELETE</command> with
+     <literal>RETURNING</literal>, <application>PL/pgSQL</application> reports
+     an error for more than one returned row, even when
+     <literal>STRICT</literal> is not specified.  This is because there
+     is no option such as <literal>ORDER BY</literal> with which to determine
+     which affected row should be returned.
+    </para>
+
     <para>
      Si <literal>print_strict_params</literal> est activé pour cette fonction,
-     vous obtiendrez des informations sur les paramètres passés à la requête
-     dans la partie <literal>DETAIL</literal> du message d'erreur produit quand
-     les pré-requis de STRICT ne sont pas rencontrés. Vous pouvez changer cette
-     configuration au niveau système en configurant
+     then when an error is thrown because the requirements
+     of <literal>STRICT</literal> are not met, the <literal>DETAIL</literal> part of
+     the error message will include information about the parameters
+     passed to the query.
+     You can change the <literal>print_strict_params</literal>
+     setting for all functions by setting
      <varname>plpgsql.print_strict_params</varname>, bien que seules les
      compilations suivantes des fonctions seront affectées. Vous pouvez aussi
-     l'activer fonction par fonction en utilisant une option du compilateur&nbsp;:
+     l'activer fonction par fonction en utilisant une option du compilateur, par exemple&nbsp;:
 <programlisting>
 CREATE FUNCTION get_userid(username text) RETURNS int
 AS $$
@@ -1104,15 +1115,12 @@ BEGIN
 END
 $$ LANGUAGE plpgsql;
 </programlisting>
-    </para>
-
-    <para>
-     Pour <command>INSERT</command>/<command>UPDATE</command>/<command>DELETE</command>
-     avec <literal>RETURNING</literal>, <application>PL/pgSQL</application>
-     rapporte une erreur si plus d'une ligne est renvoyée, même quand
-     <literal>STRICT</literal> n'est pas spécifié. Ceci est dû au fait qu'il
-     n'y a pas d'option comme <literal>ORDER BY</literal> qui pourrait
-     déterminer la ligne à renvoyer.
+     On failure, this function might produce an error message such as
+<programlisting>
+ERROR:  query returned no rows
+DETAIL:  parameters: $1 = 'nosuchuser'
+CONTEXT:  PL/pgSQL function get_userid(text) line 6 at SQL statement
+</programlisting>
     </para>
 
     <note>
@@ -2766,29 +2774,36 @@ END;
   </sect2>
 
   <sect2 id="plpgsql-get-diagnostics-context">
-   <title>Obtenir les informations de contexte de la pile d'appel</title>
+   <title>Obtaining Current Execution Information</title>
+
+   <para>
+    The <command>GET <optional> CURRENT </optional> DIAGNOSTICS</command>
+    command retrieves information about current execution state (whereas
+   the <command>GET STACKED DIAGNOSTICS</command> command discussed above
+    reports information about the execution state as of a previous error).
+    This command has the form:
+   </para>
 
 <synopsis>
-GET <optional> CURRENT </optional> DIAGNOSTICS <replaceable>variable</replaceable> { = | := } <replaceable>PG_CONTEXT</replaceable> <optional> , ... </optional>;
+GET <optional> CURRENT </optional> DIAGNOSTICS <replaceable>variable</replaceable> { = | := } <replaceable>item</replaceable> <optional> , ... </optional>;
 </synopsis>
 
 
    <para>
-    Appeler <command>GET DIAGNOSTICS</command> avec l'élément de statut
-    <varname>PG_CONTEXT</varname> renverra une chaîne de texte avec les lignes
-    de texte décrivant la pile d'appel. La première ligne fait référence à la
-    fonction courante, exécutant la commande <command>GET DIAGNOSTICS</command>.
-    La deuxième ligne et les lignes suivantes font référence aux fonctions
-    appelantes dans l'ordre de la pile d'appel.
+    Currently only one information item is supported.  Status
+    item <literal>PG_CONTEXT</literal> will return a text string with line(s) of
+    text describing the call stack.  The first line refers to the
+    current function and currently executing <command>GET DIAGNOSTICS</command>
+    command.  The second and any subsequent lines refer to calling functions
+    further up the call stack.  For example:
 
 <programlisting>
-CREATE OR REPLACE FUNCTION public.outer_func() RETURNS integer AS $$
-BEGIN
+CREATE OR REPLACE FUNCTION outer_func() RETURNS integer AS $$BEGIN
   RETURN inner_func();
 END;
 $$ LANGUAGE plpgsql;
 
-CREATE OR REPLACE FUNCTION public.inner_func() RETURNS integer AS  $$
+CREATE OR REPLACE FUNCTION inner_func() RETURNS integer AS $$
 DECLARE
   stack text;
 BEGIN
@@ -2801,8 +2816,9 @@ $$ LANGUAGE plpgsql;
 SELECT outer_func();
 
 NOTICE:  --- Call Stack ---
-PL/pgSQL function inner_func() line 4 at GET DIAGNOSTICS
+PL/pgSQL function inner_func() line 5 at GET DIAGNOSTICS
 PL/pgSQL function outer_func() line 3 at RETURN
+CONTEXT:  PL/pgSQL function outer_func() line 3 at RETURN
  outer_func
  ------------
            1