Mise à jour en 9.3.15

postgresql/adminpack.xml

@@ -11,31 +11,156 @@
   support que <application>pgAdmin</application> ou d'autres outils de gestion
   et d'administration peuvent utiliser pour fournir des fonctionnalités
   supplémentaires, comme la gestion à distance de journaux applicatifs.
+  L'utilisation de toutes ces fonctions est restreinte aux superutilisateurs.
  </para>
 
- <sect2>
-  <title>Fonctions codées</title>
-  <para>
-   Les fonctions ajoutées par <filename>adminpack</filename> ne peuvent
-   être exécutées que par un super-utilisateur. La liste des fonctions est la
-   suivante&nbsp;:
-
-<programlisting>
-int8 pg_catalog.pg_file_write(fname text, data text, append bool)
-bool pg_catalog.pg_file_rename(oldname text, newname text, archivename text)
-bool pg_catalog.pg_file_rename(oldname text, newname text)
-bool pg_catalog.pg_file_unlink(fname text)
-setof record pg_catalog.pg_logdir_ls()
-
-/* Renommage des fonctions internes existantes pour une compatibilité
-avec pgAdmin */
-int8 pg_catalog.pg_file_read(fname text, data text, append bool)
-bigint pg_catalog.pg_file_length(text)
-int4 pg_catalog.pg_logfile_rotate()
-</programlisting>
-
-  </para>
-
- </sect2>
+ <para>
+  Les fonctions indiquées dans <xref linkend="functions-adminpack-table"/>
+  fournissent un accès en écriture aux fichiers de la machine hébergeant le
+  serveur. (Voir aussi les fonctions dans <xref linkend="functions-admin-
+  genfile"/>, qui fournissent un accès en lecture seule.) Seuls les fichiers
+  stockés dans les répertoire de l'instance sont accessibles, même si un
+  chemin relatif ou absolu est autorisé.
+ </para>
+
+ <table id="functions-adminpack-table">
+  <title>Fonctions <filename>adminpack</filename></title>
+  <tgroup cols="3">
+   <thead>
+    <row><entry>Nom</entry> <entry>Type de retour</entry> <entry>Description</entry>
+    </row>
+   </thead>
+
+   <tbody>
+    <row>
+     <entry><function>pg_catalog.pg_file_write(filename text, data text, append boolean)</function></entry>
+     <entry><type>bigint</type></entry>
+     <entry>
+      Écrit ou ajoute dans un fichier texte
+     </entry>
+    </row>
+    <row>
+     <entry><function>pg_catalog.pg_file_rename(oldname text, newname text <optional>, archivename text</optional>)</function></entry>
+     <entry><type>boolean</type></entry>
+     <entry>
+      Renomme un fichier
+     </entry>
+    </row>
+    <row>
+     <entry><function>pg_catalog.pg_file_unlink(filename text)</function></entry>
+     <entry><type>boolean</type></entry>
+     <entry>
+      Supprime un fichier
+     </entry>
+    </row>
+    <row>
+     <entry><function>pg_catalog.pg_logdir_ls()</function></entry>
+     <entry><type>setof record</type></entry>
+     <entry>
+      Liste les journaux applicatifs dans le répertoire ciblé par
+      <varname>log_directory</varname>
+     </entry>
+    </row>
+   </tbody>
+  </tgroup>
+ </table>
+
+ <indexterm>
+  <primary>pg_file_write</primary>
+ </indexterm>
+ <para>
+  <function>pg_file_write</function> écrit les <parameter>data</parameter>
+  spécifiées dans le fichier nommé par <parameter>filename</parameter>. Si
+  <parameter>append</parameter> est false, le fichier ne doit pas déjà
+  exister. Si <parameter>append</parameter> est true, le fichier peut déjà
+  exister, et les données y seront ajoutées si c'est le cas. Renvoit le nombre
+  d'octets écrits.
+ </para>
+
+ <indexterm>
+  <primary>pg_file_rename</primary>
+ </indexterm>
+ <para>
+  <function>pg_file_rename</function> renomme un fichier. Si
+  <parameter>archivename</parameter> est omis ou NULL, il renomme simplement
+  <parameter>oldname</parameter> en <parameter>newname</parameter> (ce dernier
+  ne doit pas déjà exister). Si <parameter>archivename</parameter> est fourni,
+  il commence par renommer <parameter>newname</parameter> en
+  <parameter>archivename</parameter> (qui ne doit pas déjà exister), puis il
+  renomme <parameter>oldname</parameter> en <parameter>newname</parameter>.
+  Dans le cas d'échec lors de la deuxième étape de renommage, il essaiera de
+  renommer <parameter>archivename</parameter> en
+  <parameter>newname</parameter> avant de renvoyer l'erreur. Renvoie true en
+  cas de success, false si un des fichiers sources n'est pas présent ou
+  modifiables. Tous les autres cas renvoient des erreurs.
+ </para>
+
+ <indexterm>
+  <primary>pg_file_unlink</primary>
+ </indexterm>
+ <para>
+  <function>pg_file_unlink</function> supprime le fichier indiqué. Renvoie
+  true en cas de succès, false si le fichier indiqué n'est pas présent ou si
+  l'appel à <function>unlink()</function> échoue. Tous les autres cas
+  renvoient des erreurs.
+ </para>
+
+ <indexterm>
+  <primary>pg_logdir_ls</primary>
+ </indexterm>
+ <para>
+  <function>pg_logdir_ls</function> renvoie les horodatages de démarrage et
+  les noms de fichiers pour tous les journaux applicatifs compris dans le
+  répertoire <xref linkend="guc-log-directory"/>. Le paramètre <xref
+  linkend="guc-log-filename"/> doit avoir sa configuration par défaut
+  (<literal>postgresql-%Y-%m-%d_%H%M%S.log</literal>) pour utiliser cette
+  fonction.
+ </para>
+
+ <para>
+  Les fonctions indiquées dans <xref linkend="functions-adminpack-deprecated-
+  table"/> sont obsolètes et ne devraient plus être utilisées dans de
+  nouvelles applications. Utilisez à la place celles indiquées dans <xref
+  linkend="functions-admin-signal-table"/> et dans <xref linkend="functions-
+  admin-genfile"/>.  Ces fonctions sont fournies dans
+  <filename>adminpack</filename> uniquement pour des raisons de compatibilité
+  pour les anciennes versions de <application>pgAdmin</application>.
+ </para>
+
+ <table id="functions-adminpack-deprecated-table">
+  <title>Fonctions obsolètes de <filename>adminpack</filename></title>
+  <tgroup cols="3">
+   <thead>
+    <row><entry>Nom</entry> <entry>Type du retour</entry> <entry>Description</entry>
+    </row>
+   </thead>
+
+   <tbody>
+    <row>
+     <entry><function>pg_catalog.pg_file_read(filename text, offset bigint, nbytes bigint)</function></entry>
+     <entry><type>text</type></entry>
+     <entry>
+      Autre nom pour <function>pg_read_file()</function>
+     </entry>
+    </row>
+    <row>
+     <entry><function>pg_catalog.pg_file_length(filename text)</function></entry>
+     <entry><type>bigint</type></entry>
+     <entry>
+      Identique à la colonne <structfield>size</structfield> renvoyée par la
+      fonction <function>pg_stat_file()</function>
+     </entry>
+    </row>
+    <row>
+     <entry><function>pg_catalog.pg_logfile_rotate()</function></entry>
+     <entry><type>integer</type></entry>
+     <entry>
+      Autre nom pour <function>pg_rotate_logfile()</function>, mais notez
+      qu'elle renvoie un entier 0 ou 1 à la place d'un booléen
+     </entry>
+    </row>
+   </tbody>
+  </tgroup>
+ </table>
 
 </sect1>

postgresql/catalogs.xml

@@ -9440,6 +9440,13 @@ SELECT * FROM pg_locks pl LEFT JOIN pg_prepared_xacts ppx
    </tgroup>
   </table>
 
+  <para>
+   Bien que la plupart des abréviations de fuseau horaire représente des
+   décalages fixes d'UTC, certaines ont variées historiquement en valeur (voir
+   <xref linkend="datetime-config-files"/> pour plus d'informations). Dans de
+   tels cas, cette vue présente leur signification actuelle.
+  </para>
+
  </sect1>
 
  <sect1 id="view-pg-timezone-names">

postgresql/datetime.xml

@@ -402,21 +402,41 @@ suivant.
    </para>
 
    <para>
-    Un <replaceable>abréviation_zone</replaceable> n'est que
-    l'abréviation en cours de définition. Le <replaceable>décalage</replaceable> est le
-    décalage équivalent en secondes à partir d'UTC, une valeur positive signifiant à
-    l'est de Greenwich, une valeur négative à l'ouest.
-    Ainsi, -18000 représente cinq heures à l'ouest
-    de Greenwich, soit l'heure standard de la côte ouest nord américaine.
-    <literal>D</literal> indique que le nom du fuseau représente une heure
-    soumise à des règles de changement d'heure plutôt que l'heure standard.
-    Autrement, un <replaceable>abréviation_zone</replaceable> peut être 
-    donné et, dans ce cas, la définition du fuseau horaire est consultée, et le sens
-    de l'abréviation dans ce fuseau est utilisé. Cette alternative n'est recommandée
-    que pour les abréviations dont le sens a changé historiquement car rechercher le
-    sens est bien plus coûteux qu'utiliser la valeur fixe d'un entier.
+    Un <replaceable>abréviation_zone</replaceable> n'est que l'abréviation en
+    cours de définition. Un <replaceable>décalage</replaceable> est un entier
+    correspondant au décalage équivalent en secondes à partir d'UTC, un nombre
+    positif correspondant à l'est de Greenwich, et un nombre négatif l'ouest.
+    Par exemple, -18000 serait cinq heures à l'ouest de Greenwich, autrement
+    dit le fuseau horaire de la côté est de l'Amérique du Nord.
+    <literal>D</literal> indique que le nom du fuseau horaire représente un
+    changement d'horaire par rapport à l'heure normale.
    </para>
 
+   <para>
+    Autrement, un <replaceable>nom_fuseau_horaire</replaceable> peut être
+    donné référençant un fuseau horaire défini dans la base de données IANA
+    des fuseaux horaires. La définition de zone est consultée pour vérifier si
+    l'abréviation est ou a été utilisé dans cette zone et, si c'est le cas, la
+    signification appropriée à utiliser &mdash; autrement dit, la
+    signification en cours au moment de l'horodatage dont la valeur est en
+    cours de détermination, ou la signification précédant immédiatement, ou la
+    signification la plus ancienne si elle n'a été utilisée qu'après cet
+    horodatage. Ce comportement est essentiel pour garer les abréviations dont
+    la signification a varié dans le temps. Il est aussi permis de définir une
+    abréviation en terme de nom de fuseau horaire dans lequel cet abréviation
+    n'apparaît pas. Dans ce cas, utiliser l'abréviation est équivalent à
+    écrire le nom du fuseau horaire.
+   </para>
+
+   <tip>
+    <para>
+     Utiliser un seul entier <replaceable>décalage</replaceable> est préféré
+     lors de la définition d'une abréviation dont le décalage d'UTC n'a jamais
+     changé car ce type d'abréviation est bien moins coûteuse à traiter que
+     celles qui nécessite de consulter une définition des fuseaux horaires.
+    </para>
+   </tip>
+
    <para>
     La syntaxe <literal>@INCLUDE</literal> autorise l'inclusion d'autres fichiers
     du répertoire <filename>.../share/timezonesets/</filename>. Les inclusions

postgresql/func.xml

@@ -8083,12 +8083,12 @@ CREATE TYPE couleurs AS ENUM ('rouge', 'orange', 'jaune', 'vert', 'bleu', 'viole
        <row>
 	<entry><literal>#</literal> </entry>
 	<entry>Point ou boîte d'intersection</entry>
-	<entry><literal>'((1,-1),(-1,1))' # '((1,1),(-1,-1))'</literal></entry>
+	<entry><literal>box '((1,-1),(-1,1))' # box '((1,1),(-2,-2))'</literal></entry>
        </row>
        <row>
 	<entry><literal>#</literal> </entry>
 	<entry>Nombre de points dans le chemin ou le polygone</entry>
-	<entry><literal># '((1,0),(0,1),(-1,0))'</literal></entry>
+	<entry><literal># path '((1,0),(0,1),(-1,0))'</literal></entry>
        </row>
        <row>
 	<entry><literal>@-@</literal> </entry>
@@ -14278,6 +14278,21 @@ postgres=# SELECT * FROM unnest2(ARRAY[[1,2],[3,4]]);
 	         <parameter>privilège</parameter> sur
 	         <parameter>tablespace</parameter></entry>
         </row>
+      <row>
+       <entry><literal><function>has_type_privilege</function>(<parameter>user</parameter>,
+                                  <parameter>type</parameter>,
+                                  <parameter>privilege</parameter>)</literal>
+       </entry>
+       <entry><type>boolean</type></entry>
+       <entry>l'utilisateur a-t-il le privilège pour le type</entry>
+      </row>
+      <row>
+       <entry><literal><function>has_type_privilege</function>(<parameter>type</parameter>,
+                                  <parameter>privilege</parameter>)</literal>
+       </entry>
+       <entry><type>boolean</type></entry>
+       <entry>l'utilisateur actuel a-t-il le privilège pour le type</entry>
+      </row>
       <row>
        <entry><literal><function>pg_has_role</function>(<parameter>utilisateur</parameter>,
                                   <parameter>rôle</parameter>,
@@ -14334,6 +14349,9 @@ postgres=# SELECT * FROM unnest2(ARRAY[[1,2],[3,4]]);
    <indexterm>
     <primary>has_tablespace_privilege</primary>
    </indexterm>
+   <indexterm>
+    <primary>has_type_privilege</primary>
+   </indexterm>
    <indexterm>
     <primary>pg_has_role</primary>
    </indexterm>
@@ -14464,6 +14482,17 @@ SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute');
     Le seul privilège possible est <literal>CREATE</literal>.
    </para>
 
+   <para>
+    <function>has_type_privilege</function> vérifie si un utilisateur peut
+    accéder à un type de données d'une façon particulière. Ses possibilités en
+    terme d'argument sont analogues à
+    <function>has_table_privilege</function>. Lors de la spécification d'un
+    type par une chaîne de caractères plutôt que par un OID, l'entrée
+    autorisée est la même que pour le type de données <type>regtype</type>
+    (voir <xref linkend="datatype-oid"/>). Le type de droit d'accès autorisé
+    doit s'évaluer à <literal>USAGE</literal>.
+   </para>
+
    <para>
     <function>pg_has_role</function> vérifie si l'utilisateur possède
     un privilège particulier d'accès à un rôle. Ses arguments sont

postgresql/installation.xml

@@ -1458,7 +1458,7 @@ su - postgres
     (Rappelez-vous d'utiliser <acronym>GNU</acronym>
     <application>make</application>). La compilation prendra quelques minutes,
     selon votre matériel. La dernière ligne affichée devrait être
-<screen>All of PostgreSQL is successfully made. Ready to install.</screen>
+<screen>All of PostgreSQL successfully made. Ready to install.</screen>
    </para>
 
   <para>
@@ -1470,7 +1470,7 @@ su - postgres
 </screen>
    La dernière ligne affichée doit être&nbsp;:
 <screen>
-PostgreSQL, contrib and HTML documentation successfully made. Ready to install.
+PostgreSQL, contrib, and documentation successfully made. Ready to install.
 </screen>
    </para>
   </step>

postgresql/ref/alter_function.xml

@@ -240,8 +240,9 @@ ALTER FUNCTION <replaceable>nom</replaceable> ( [ [ <replaceable class="paramete
 	est supprimée pour que la fonction s'exécute avec la valeur par défaut
 	du paramètre. Utiliser <literal>RESET ALL</literal> supprime tous les
 	valeurs spécifiques des paramètres pour cette fonction.
-        <literal>SET FROM CURRENT</literal> sauvegarde la valeur courante comme
-	valeur du paramètre à appliquer lors de l'exécution de la fonction.
+        <literal>SET FROM CURRENT</literal> sauvegarde la valeur actuelle du
+        paramètre lors de l'exécution du <command>ALTER FUNCTION</command>
+        comme valeur à appliquer à l'entrée de la fonction.
        </para>
 
        <para>

postgresql/ref/alter_user_mapping.xml

@@ -92,9 +92,9 @@ ALTER USER MAPPING FOR { <replaceable class="parameter">nom_utilisateur</replace
 
   <para>
    Modifier le mot de passe pour la correspondance d'utilisateur <literal>bob</literal>,
-   et le serveur <literal> foo</literal>&nbsp;:
+   et le serveur <literal>foo</literal>&nbsp;:
 <programlisting>
-ALTER USER MAPPING FOR bob SERVER foo OPTIONS (user 'bob', password 'public');
+ALTER USER MAPPING FOR bob SERVER foo OPTIONS (SET password 'public');
 </programlisting>
   </para>
 

postgresql/ref/create_function.xml

@@ -432,8 +432,9 @@
        La clause <literal>SET</literal> fait que le paramètre de configuration
        indiquée est initialisée avec la valeur précisée au lancement de la
        fonction, puis restaurée à sa valeur d'origine lors de la sortie de la
-       fonction. <literal>SET FROM CURRENT</literal> utilise la valeur actuelle
-       de la session comme valeur à appliquer au lancement de la fonction.
+       fonction. <literal>SET FROM CURRENT</literal> sauvegarde la valeur
+       actuelle du paramètre lors de l'exécution du <command>ALTER
+       FUNCTION</command> comme valeur à appliquer à l'entrée de la fonction.
       </para>
 
       <para>