Mise à jour en version 8.3.21

gleu · Sep 29, 2012 · 5cae448 · 5cae448
1 parent 08612dc
commit 5cae448
Show file tree

Hide file tree

Showing 10 changed files with 187 additions and 67 deletions.
diff --git a/config.xml b/config.xml
@@ -4916,12 +4916,25 @@ SET XML OPTION { DOCUMENT | CONTENT };
       </indexterm>
       <indexterm><primary>inheritance</primary></indexterm>
        <para>
-        Contrôle la sémantique de l'héritage. Désactivé
-	(<literal>off</literal>), les sous-tables ne sont pas incluses par
-	défaut dans les différentes commandes&nbsp;; généralement le mot
-	clé <literal>ONLY</literal> est nécessaire. Ceci a été ajouté pour
-	la compatibilité avec les versions antérieures à la 7.1. Voir
-        <xref linkend="ddl-inherit"/> pour plus d'informations.
+        Ce paramètre contrôle si les références de table doivent inclure les
+        tables filles. La valeur par défaut est <literal>on</literal>, signifiant
+        que les tables filles sont incluses (et de ce fait, un suffixe <literal>*</literal>
+        est supposé par défaut. Si ce paramètre est désactivé (à <literal>off</literal>),
+        les tables filles ne sont pas inclus (et de ce fait, le préfixe
+        <literal>ONLY</literal> est ajouté). Le standard SQL requiert que les
+        tables filles soient inclues, donc le paramètrages <literal>off</literal>
+        n'est pas conforme au standard. Cependant, il est fourni par compatibilité
+        avec les versions <productname>PostgreSQL</productname> antérieures à
+        la 7.1. Voir <xref linkend="ddl-inherit"> pour plus d'informations.
+       </para>
+
+       <para>
+        Désactiver <varname>sql_inheritance</varname> n'est pas conseillé car le
+        comportement induis par cette configuration porte à faire beaucoup
+        d'erreurs. Ceci n'est pas constaté lorsque ce paramètre est activé comme
+        le demande le standard SQL. Les discussions sur l'héritage dans ce manuel
+        supposent généralement que ce paramètre est configuré à
+        <literal>on</literal>.
        </para>
       </listitem>
      </varlistentry>

diff --git a/ddl.xml b/ddl.xml
@@ -1945,6 +1945,22 @@ CREATE TABLE capitales (
    <literal>ONLY</literal>.
   </para>
 
+  <para>
+   Vous pouvez aussi écrire le nom de la table avec une <literal>*</literal>
+   à la fin pour indiquer spécifiquement que les tables descendantes sont
+   inclues&nbsp;:
+
+<programlisting>SELECT name, altitude
+    FROM cities*
+    WHERE altitude &gt; 500;</programlisting>
+
+   Indiquer <literal>*</literal> n'est pas nécessaire car ce comportement est
+   le comportement par défaut (sauf si vous avez modifié la configuration du
+   paramètre <xref linkend="guc-sql-inheritance"/>). Néanmoins, écrire
+   <literal>*</literal> pourrait être utile pour insister sur le fait que des
+   tables supplémentaires seront parcourues.
+  </para>
+
   <para>
   Dans certains cas, il peut être intéressant de savoir de quelle table provient une ligne
   donnée. Une colonne système appelée <structfield>TABLEOID</structfield>
@@ -2137,17 +2153,6 @@ VALUES ('New York', NULL, NULL, 'NY');</programlisting>
     de l'héritage pour un problème donné.
   </para>
 
-  <note>
-   <title>Obsolète</title>
-   <para>
-     Dans les versions de <productname>PostgreSQL</productname> antérieures à
-     7.1, le comportement par défaut consistait à ne pas inclure les tables enfants dans les
-     requêtes. Il s'est avéré que cela était source d'erreur et violait le
-     standard SQL. Ce comportement peut être retrouvé en désactivant le
-     paramètre <xref linkend="guc-sql-inheritance"/>.
-   </para>
-  </note>
-
    </sect2>
   </sect1>
 

diff --git a/maintenance.xml b/maintenance.xml
@@ -391,8 +391,8 @@
     plus de place car il doit stocker le statut du COMMIT pour toutes les
     transactions depuis <varname>autovacuum_freeze_max_age</varname>. L'état de
     COMMIT utilise deux bits par transaction, donc si
-    <varname>autovacuum_freeze_max_age</varname> a une valeur maximum permise
-    d'un peu moins que deux billion, <filename>pg_clog</filename> peut grossir
+    <varname>autovacuum_freeze_max_age</varname> a une valeur maximum
+    de deux milliards, <filename>pg_clog</filename> peut grossir
     jusqu'à la moitié d'un Go. Si c'est rien comparé à votre taille de base
     totale, configurer <varname>autovacuum_freeze_max_age</varname> à son
     maximum permis est recommandé. Sinon, le configurer suivant ce que vous

diff --git a/queries.xml b/queries.xml
@@ -129,6 +129,17 @@ et utiliser la commande <command>SELECT</command> comme une calculatrice&nbsp;:
     nommée... toute colonne ajoutée dans une sous-table est ignorée.
    </para>
 
+   <para>
+    Au lieu d'écrire <literal>ONLY</literal> avant le nom de la table, vous pouvez
+    écrire <literal>*</literal> après le nom de la table pour indiquer
+    spécifiquement que les tables filles sont inclues. Écrire <literal>*</literal>
+    n'est pas nécessaire car il s'agit du comportement par défaut (sauf si vous
+    avez choisi de modifier la configuration de <xref
+    linkend="guc-sql-inheritance"/>). Néanmoins, écrire <literal>*</literal>
+    peut être utile pour indiquer fortement que les tables filles seront
+    parcourues.
+   </para>
+
    <sect3 id="queries-join">
     <title>Tables jointes</title>
 

diff --git a/ref/alter_table.xml b/ref/alter_table.xml
@@ -442,15 +442,11 @@ où <replaceable class="parameter">action</replaceable> peut être&nbsp;:
       <listitem>
        <para>
         Le nom (éventuellement qualifié du nom du schéma) de la table à modifier.
-        Si <literal>ONLY</literal> est indiqué, seule cette table
-        est modifiée. Dans le cas contraire, la table
-        et toutes ses tables filles (s'il y en a) sont modifiées.
-        <literal>*</literal> peut être ajouté au nom de la table pour indiquer que ses
-        tables descendantes doivent être modifiées. C'est le comportement par défaut dans la version actuelle.
-        Dans les versions antérieures à la
-        7.1, <literal>ONLY</literal> était le comportement par défaut.
-        Le comportement par défaut est modifiable par le paramètre
-        de configuration <xref linkend="guc-sql-inheritance"/>.
+        Si <literal>ONLY</literal> est indiqué avant le nom de la table, seule
+        cette table est modifiée. Dans le cas contraire, la table et toutes ses
+        tables filles (s'il y en a) sont modifiées. En option,
+        <literal>*</literal> peut être ajouté après le nom de la table pour
+        indiquer explicitement que les tables descendantes doivent être inclues.
        </para>
       </listitem>
      </varlistentry>

diff --git a/ref/delete.xml b/ref/delete.xml
@@ -17,7 +17,7 @@
  </refnamediv>
 
  <refsynopsisdiv>
-<synopsis>DELETE FROM [ ONLY ] <replaceable class="parameter">table</replaceable> [ [ AS ] <replaceable class="parameter">alias</replaceable> ]
+<synopsis>DELETE FROM [ ONLY ] <replaceable class="parameter">table</replaceable> [ * ] [ [ AS ] <replaceable class="parameter">alias</replaceable> ]
     [ USING <replaceable class="parameter">liste_using</replaceable> ]
     [ WHERE <replaceable class="parameter">condition</replaceable> | WHERE CURRENT OF <replaceable class="parameter">nom_curseur</replaceable> ]
     [ RETURNING * | <replaceable class="parameter">expression_sortie</replaceable> [ AS <replaceable class="parameter">output_name</replaceable> ] [, ...] ]
@@ -45,12 +45,6 @@
     </para>
    </tip>
 
-  <para>
-   Par défaut, <command>DELETE</command> supprime les lignes de la table
-   spécifiée et de ses tables filles. La clause <literal>ONLY</literal>
-   est utilisée pour ne supprimer que les lignes de la table mentionnée.
-  </para>
-
   <para>
    Il existe deux façons de supprimer des lignes d'une table en utilisant
    les informations d'autres tables de la base de données&nbsp;:
@@ -81,22 +75,18 @@
   <title>Paramètres</title>
 
   <variablelist>
-   <varlistentry>
-    <term><literal>ONLY</literal></term>
-    <listitem>
-     <para>
-      Si cette option est spécifiée, les lignes ne sont supprimées que dans la table
-      nommée. Dans le cas contraire, toutes les tables qui héritent de la table
-      nommée sont considérées.
-     </para>
-    </listitem>
-   </varlistentry>
-
    <varlistentry>
     <term><replaceable class="parameter">table</replaceable></term>
     <listitem>
      <para>
-      Le nom de la table (éventuellement qualifié du nom du schéma).
+       Le nom (éventuellement qualifié du nom du schéma) de la table dans
+       laquelle il faut supprimer des lignes. Si <literal>ONLY</literal> est
+       indiqué avant le nom de la table, les lignes supprimées ne concernent
+       que la table nommée. Si <literal>ONLY</literal> n'est pas indiquée,
+       les lignes supprimées font partie de la table nommée et de ses tables
+       filles. En option, <literal>*</literal> peut être ajouté après le nom
+       de la table pour indiquer explicitement que les tables descendantes
+       doivent être inclues.
      </para>
     </listitem>
    </varlistentry>

diff --git a/ref/select.xml b/ref/select.xml
@@ -182,16 +182,12 @@ avec <replaceable class="parameter">éléments_from</replaceable> qui peut être
       <term><replaceable class="parameter">nom_table</replaceable></term>
       <listitem>
        <para>
-        Le nom (éventuellement qualifié par le nom du schéma) d'une table existante
-	ou d'une vue. Si <literal>ONLY</literal> est spécifié, seule cette table est
-	parcourue. Dans le cas contraire, la table et toutes ses
-	descendantes (s'il y en a) sont parcourues. <literal>*</literal> peut
-	être ajouté au nom de la table pour indiquer que les tables descendantes
-	doivent être parcourues mais, dans la version actuelle, c'est le
-	comportement par défaut. Dans les versions précédant la 7.1,
-	<literal>ONLY</literal> était le comportement par défaut.
-	Ce dernier peut être modifié à l'aide de l'option de configuration
-	<xref linkend="guc-sql-inheritance"/>.
+        Le nom (éventuellement qualifié par le nom du schéma) d'une table ou
+        vue existante. Si <literal>ONLY</literal> est spécifié avant le nom de
+        la table, seule cette table est parcourue. Dans le cas contraire, la
+        table et toutes ses tables filles (s'il y en a) sont parcourues. En
+        option, <literal>*</literal> peut être ajouté après le nom de la table
+        pour indiquer explicitement que les tables filles sont inclues.
        </para>
       </listitem>
      </varlistentry>

diff --git a/ref/update.xml b/ref/update.xml
@@ -19,7 +19,7 @@
  </refnamediv>
 
  <refsynopsisdiv>
-<synopsis>UPDATE [ ONLY ] <replaceable class="parameter">table</replaceable> [ [ AS ] <replaceable class="parameter">alias</replaceable> ]
+<synopsis>UPDATE [ ONLY ] <replaceable class="PARAMETER">table</replaceable> [ * ] [ [ AS ] <replaceable class="parameter">alias</replaceable> ]
     SET { <replaceable class="parameter">colonne</replaceable> = { <replaceable class="parameter">expression</replaceable> | DEFAULT } |
           ( <replaceable class="parameter">colonne</replaceable> [, ...] ) = ( { <replaceable class="parameter">expression</replaceable> | DEFAULT } [, ...] ) } [, ...]
     [ FROM <replaceable class="parameter">liste_from</replaceable> ]
@@ -43,13 +43,6 @@
    valeur.
   </para>
 
-  <para>
-   Par défaut, <command>UPDATE</command> met à jour les lignes de la table
-   spécifiée et toutes ses sous-tables. 
-   Si seule la table mentionnée doit être mise à jour, la clause
-   <literal>ONLY</literal> est utilisée.
-  </para>
-
   <para>
    Il existe deux façons de modifier le contenu d'une table à partir d'informations
    contenues dans d'autres tables de la base de données&nbsp;: à l'aide de
@@ -84,7 +77,13 @@
     <term><replaceable class="parameter">table</replaceable></term>
     <listitem>
      <para>
-      Le nom de la table à mettre à jour (éventuellement qualifié du nom du schéma).
+      Le nom de la table à mettre à jour (éventuellement qualifié du nom du
+      schéma). Si <literal>ONLY</literal> est indiqué avant le nom de la table,
+      les lignes modifiées ne concernent que la table nommée. Si
+      <literal>ONLY</literal> n'est pas indiquée, les lignes modifiées font
+      partie de la table nommée et de ses tables filles. En option,
+      <literal>*</literal> peut être ajouté après le nom de la table pour
+      indiquer explicitement que les tables filles doivent être inclues.
      </para>
     </listitem>
    </varlistentry>

diff --git a/release-8.3.xml b/release-8.3.xml
@@ -4,6 +4,116 @@
      par      $Author: gleu $
      révision $Revision: 1317 $ -->
 
+ <sect1 id="release-8-3-21">
+  <title>Release 8.3.21</title>
+
+  <note>
+  <title>Release Date</title>
+  <simpara>2012-09-24</simpara>
+  </note>
+
+  <para>
+   This release contains a variety of fixes from 8.3.20.
+   For information about new features in the 8.3 major release, see
+   <xref linkend="release-8-3"/>.
+  </para>
+
+  <para>
+   The <productname>PostgreSQL</productname> community will stop releasing updates
+   for the 8.3.X release series in February 2013.
+   Users are encouraged to update to a newer release branch soon.
+  </para>
+
+  <sect2>
+   <title>Migration to Version 8.3.21</title>
+
+   <para>
+    A dump/restore is not required for those running 8.3.X.
+   </para>
+
+   <para>
+    However, if you are upgrading from a version earlier than 8.3.17,
+    see the release notes for 8.3.17.
+   </para>
+
+  </sect2>
+
+  <sect2>
+   <title>Changes</title>
+
+   <itemizedlist>
+
+    <listitem>
+     <para>
+      Improve page-splitting decisions in GiST indexes (Alexander Korotkov,
+      Robert Haas, Tom Lane)
+     </para>
+
+     <para>
+      Multi-column GiST indexes might suffer unexpected bloat due to this
+      error.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Fix cascading privilege revoke to stop if privileges are still held
+      (Tom Lane)
+     </para>
+
+     <para>
+      If we revoke a grant option from some role <replaceable>X</replaceable>, but
+      <replaceable>X</replaceable> still holds that option via a grant from someone
+      else, we should not recursively revoke the corresponding privilege
+      from role(s) <replaceable>Y</replaceable> that <replaceable>X</replaceable> had granted it
+      to.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Fix handling of <literal>SIGFPE</literal> when PL/Perl is in use (Andres Freund)
+     </para>
+
+     <para>
+      Perl resets the process's <literal>SIGFPE</literal> handler to
+      <literal>SIG_IGN</literal>, which could result in crashes later on.  Restore
+      the normal Postgres signal handler after initializing PL/Perl.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Prevent PL/Perl from crashing if a recursive PL/Perl function is
+      redefined while being executed (Tom Lane)
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Work around possible misoptimization in PL/Perl (Tom Lane)
+     </para>
+
+     <para>
+      Some Linux distributions contain an incorrect version of
+      <filename>pthread.h</filename> that results in incorrect compiled code in
+      PL/Perl, leading to crashes if a PL/Perl function calls another one
+      that throws an error.
+     </para>
+    </listitem>
+
+    <listitem>
+     <para>
+      Update time zone data files to <application>tzdata</application> release 2012f
+      for DST law changes in Fiji
+     </para>
+    </listitem>
+
+   </itemizedlist>
+
+  </sect2>
+ </sect1>
+
  <sect1 id="release-8-3-20">
   <title>Release 8.3.20</title>
 

diff --git a/version.xml b/version.xml
@@ -1,2 +1,2 @@
-<!ENTITY version "8.3.20">
+<!ENTITY version "8.3.21">
 <!ENTITY majorversion "8.3">