Mise à jour en version 10.17

postgresql/acronyms.xml

@@ -701,6 +701,16 @@
     </listitem>
    </varlistentry>
 
+   <varlistentry>
+    <term><acronym>TLS</acronym></term>
+    <listitem>
+     <para>
+      <ulink url="https://en.wikipedia.org/wiki/Transport_Layer_Security">
+      Transport Layer Security</ulink>
+     </para>
+    </listitem>
+   </varlistentry>
+
    <varlistentry>
     <term><acronym>TOAST</acronym></term>
     <listitem>

postgresql/appendix-obsolete-pgreceivexlog.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<sect1 id="app-pgreceivexlog" xreflabel="pg_receivexlog">
+  <title><command>pg_receivexlog</command> renommé en <command>pg_receivewal</command></title>
+
+   <indexterm>
+     <primary>pg_receivexlog</primary>
+     <see>pg_receivewal</see>
+   </indexterm>
+
+   <para>
+    PostgreSQL 9.6 et les versions antérieures fournissaient une commande
+    nommée <command>pg_receivexlog</command>
+    <indexterm><primary>pg_receivexlog</primary></indexterm> pour récupérer
+    les fichiers des journaux de transactions (WAL). Cette commande a été
+    renommée en <command>pg_receivewal</command>, voir <xref
+    linkend="app-pgreceivewal"/> pour la documentation de
+    <command>pg_receivewal</command> et voir les <link
+    linkend="release-prior">notes de version de PostgreSQL 10</link> pour les
+    détails sur ce changement.
+   </para>
+
+</sect1>

postgresql/appendix-obsolete-pgresetxlog.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<sect1 id="app-pgresetxlog" xreflabel="pg_resetxlog">
+  <title><command>pg_resetxlog</command> renommé en <command>pg_resetwal</command></title>
+
+   <indexterm>
+     <primary>pg_resetxlog</primary>
+     <see>pg_resetwal</see>
+   </indexterm>
+
+   <para>
+    PostgreSQL 9.6 et les versions antérieures fournissaient une commande
+    nommée <command>pg_resetxlog</command>
+    <indexterm><primary>pg_resetxlog</primary></indexterm> pour réinitialiser
+    les fichiers des journaux de transactions (WAL). Cette commande a été
+    renommée en <command>pg_resetwal</command>, voir <xref
+    linkend="app-pgresetwal"/> pour la documentation de
+    <command>pg_resetwal</command> et voir les <link
+    linkend="release-prior">notes de version de PostgreSQL 10</link> pour les
+    détails sur ce changement.
+   </para>
+
+</sect1>

postgresql/appendix-obsolete-pgxlogdump.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<sect1 id="pgxlogdump" xreflabel="pg_xlogdump">
+  <title><command>pg_xlogdump</command> renommé en <command>pg_waldump</command></title>
+
+   <indexterm>
+     <primary>pg_xlogdump</primary>
+     <see>pg_waldump</see>
+   </indexterm>
+
+   <para>
+    PostgreSQL 9.6 et les versions antérieures fournissaient une commande
+    nommée <command>pg_xlogdump</command>
+    <indexterm><primary>pg_xlogdump</primary></indexterm> pour lire les
+    fichiers des journaux de transactions (WAL). Cette commande a été renommée
+    en <command>pg_waldump</command>, voir <xref linkend="pgwaldump"/>
+    pour la documentation de <command>pg_resetwal</command> et voir les <link
+    linkend="release-prior">notes de version de PostgreSQL 10</link> pour les
+    détails sur ce changement.
+   </para>
+
+</sect1>

postgresql/appendix-obsolete.xml

@@ -0,0 +1,40 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<appendix id="appendix-obsolete">
+ <title>Fonctionnalités obsolètes ou renommées</title>
+
+ <para>
+   Certaines fonctionnalités sont parfois supprimées de PostgreSQL. D'autres
+   fonctionnalités, noms de paramètres, noms de foncions peuvent changer. La
+   documentation peut changer d'emplacement. Cette section dirige les
+   utilisateurs provenant de vieillesversions de la documentation ou de liens
+   externes vers le nouvel emplacement approprié pour l'information qu'ils
+   recherchent.
+ </para>
+
+ <!--
+  This section exists so that people following /current/ links to documentation
+  don't get a 404 when we move or rename things. And users who find old versions
+  of the docs in searches or old command names when checking the index can
+  follow links to the new commands.
+
+  Each subsection here should retain the same <chapter>, <appendix> and/or
+  <sect1> "id" attribute that was used for the relevant documentation before
+  it was renamed or moved. Do not prepend "obsolete-" or anything, keep it
+  exactly the same. These ids are used to determine the filenames for generated
+  HTML docs so changing them will break links.
+
+  Each entry should also insert index terms redirecting from the old to new
+  names. The recommended spelling is
+
+      <indexterm><primary>oldname</primary><see>newname</see></indexterm>
+
+  We don't bother with attempting to maintain down-version linking, e.g from
+  pg_waldump to pg_xlogdump. Users of old versions should use old docs. There
+  is no need to add index terms pointing from the new to old names.
+ -->
+
+ &obsolete-pgxlogdump;
+ &obsolete-pgresetxlog;
+ &obsolete-pgreceivexlog;
+
+</appendix>

postgresql/backup.xml

@@ -954,7 +954,8 @@ SELECT * FROM pg_stop_backup(false, true);
       sauvegarde. Le troisième champ devrait être écrit dans un fichier nommé
       <filename>tablespace_map</filename> sauf si le champ est vide. Ces
       fichiers sont vitaux pour le fonctionnement de la sauvegarde et doivent
-      être écrits sans modification.
+      être écrits octet par octet sans modification, ce qui nécessite de les
+      ouvrir en mode binaire.
      </para>
     </listitem>
     <listitem>

postgresql/config.xml

@@ -2660,7 +2660,8 @@ block : bloc vidé,  dirty bloc : bloc à vider ?
     <para>
      Ces options ne sont pas toutes disponibles sur toutes les plateformes.
      La valeur par défaut est la première méthode de la liste ci-dessus
-     supportée par la plateforme.
+     supportée par la plateforme, sauf que <literal>fdatasync</literal> est la
+     valeur par défaut sur Linux et FreeBSD.
      Les options <literal>open_</literal>* utilisent aussi
      <literal>O_DIRECT</literal> s'il est disponible.
      L'outil <filename>src/tools/fsync</filename> disponible dans le code
@@ -3245,6 +3246,19 @@ block : bloc vidé,  dirty bloc : bloc à vider ?
      petite que le nombre de slots de réplications déjà existants empêchera
      le démarrage du serveur.
     </para>
+
+    <para>
+     Du côté du souscripteur, indique le nombre d'origines de réplication
+     (voir <xref linkend="replication-origins"/>) pouvant être tracées
+     simultanément, limitant directement le nombre de souscriptions de
+     réplication logique pouvant être créées sur le serveur. Le configurer à
+     une valeur plus basse que le nombre actuel d'origines de réplication
+     tracées (telle qu'indiquée dans <link
+     linkend="view-pg-replication-origin-status">pg_replication_origin_status</link>,
+     et non pas <link
+     linkend="catalog-pg-replication-origin">pg_replication_origin</link>)
+     empêchera le démarrage du serveur.
+    </para>
    </listitem>
   </varlistentry>
 

postgresql/datetime.xml

@@ -822,9 +822,6 @@
   <indexterm zone="datetime-units-history">
    <primary>calendrier Grégorien</primary>
   </indexterm>
-  <indexterm zone="datetime-units-history">
-   <primary>date Julien</primary>
-  </indexterm>
 
   <para>
    Le standard SQL précise que à l'intérieur de la définition d'un
@@ -925,14 +922,27 @@ di lu ma me je ve sa
    civils. Le calendrier chinois est utilisé pour déterminer les festivals.
   </para>
 
+  </sect1>
+
+  <sect1 id="datetime-julian-dates">
+  <title>Dates Julien</title>
+
+  <indexterm zone="datetime-julian-dates">
+   <primary>Date Julien</primary>
+  </indexterm>
+
   <para>
-   Le système de <firstterm>dates Julien</firstterm> est un autre
-   type de calendrier, non relatif au calendrier Julien, malgré la
-   similarité du nom.
+   Le système de <firstterm>dates Julien</firstterm> est une méthode pour
+   numéroter les jours. Il n'a pas de relation avec le calendrier Julien,
+   malgré la similarité du nom.
    Le système de date Julien a été inventé par le précepteur
    français Joseph Justus Scaliger (1540-1609) et tient probablement son nom
    du père de Scaliger, le précepteur italien Julius Caesar Scaliger
-   (1484-1558). Dans le système de date Julien, chaque jour est un nombre
+   (1484-1558).
+  </para>
+
+  <para>
+   Dans le système de date Julien, chaque jour est un nombre
    séquentiel, commençant à partir de JD 0, appelé quelque fois
    <emphasis>la</emphasis> date Julien. JD 0 correspond au 1er janvier
    4713 avant JC dans le calendrier Julien, ou au 24 novembre 4714 avant JC
@@ -948,7 +958,31 @@ di lu ma me je ve sa
    l'affichage des dates en notation de date Julien (et les utilise aussi pour
    quelques calculs internes de date et heure), il n'utilise pas le coup
    des dates de midi à midi. <productname>PostgreSQL</productname> traite une
-   date Julien comme allant de minuit à minuit.
+   date Julien comme allant de minuit heure locale à minuit heure locale,
+   de la même façon que pour une date normale.
+  </para>
+
+  <para>
+   Néanmoins, cette définition fournit une méthode pour obtenir la définition
+   astronomique quand vous en avez besoin&nbsp;: faites le calcul dans le
+   fuseau horaire <literal>UTC+12</literal>. Par exemple,
+<programlisting>
+=&gt; SELECT extract(julian from '2021-06-23 7:00:00-04'::timestamptz at time zone 'UTC+12');
+     date_part
+--------------------
+ 2459388.9583333335
+(1 row)
+=&gt; SELECT extract(julian from '2021-06-23 8:00:00-04'::timestamptz at time zone 'UTC+12');
+ date_part
+-----------
+   2459389
+(1 row)
+=&gt; SELECT extract(julian from date '2021-06-23');
+ date_part
+-----------
+   2459389
+(1 row)
+</programlisting>
   </para>
  </sect1>
 </appendix>

postgresql/ddl.xml

@@ -758,6 +758,11 @@ DROP TABLE produits;</programlisting>
 	table de référence est utilisée comme colonne de référence.
        </para>
 
+       <para>
+        Une contrainte de clé étrangère peut être nommée de la façon
+        habituelle.
+       </para>
+
        <para>
 	Une clé étrangère peut aussi contraindre et référencer un groupe de colonnes.
 	Comme cela a déjà été évoqué, il faut alors l'écrire sous forme d'une contrainte de table.
@@ -772,8 +777,29 @@ DROP TABLE produits;</programlisting>
 	au nombre et au type des colonnes référencées.
        </para>
 
+   <indexterm>
+    <primary>clé étrangère</primary>
+    <secondary>auto-référencé</secondary>
+   </indexterm>
+
        <para>
-	Une contrainte de clé étrangère peut être nommée de la façon habituelle.
+        Parfois, il est utile que l'<quote>autre table</quote> d'une clé
+        étrangère soit la même table&nbsp;; elle est alors appelée une clé
+        étrangère <firstterm>auto-référencée</firstterm>. Par exemple, si vous
+        voulez que les lignes d'une table représentent les nœuds d'une
+        structure en arbre, vous pouvez écrire
+<programlisting>
+CREATE TABLE tree (
+    node_id integer PRIMARY KEY,
+    parent_id integer REFERENCES tree,
+    name text,
+    ...
+);
+</programlisting>
+        Un nœud racine aura la colonne <structfield>parent_id</structfield> à
+        NULL, et les enregistrements non NULL de
+        <structfield>parent_id</structfield> seront contraints de référencer
+        des enregistrements valides de la table.
        </para>
 
        <para>
@@ -2043,7 +2069,8 @@ SELECT * FROM information WHERE groupe_id = 2 FOR UPDATE;
         performance, tout spécialement si des mises à jour de cette table sont
         fréquentes. Une autre solution envisageable, si les mises à jour de
         la table référencée ne sont pas fréquentes, est de prendre un
-        verrou exclusif sur la table référencée lors des mises à jour,
+        verrou de type <literal>ACCESS EXCLUSIVE</literal> sur la table
+        référencée lors des mises à jour,
         de telle manière qu'aucune autre transaction concurrente ne pourrait
         consulter d'anciennes valeurs. Ou une transaction pourrait attendre que
         toutes les transactions se terminent après avoir validé une mise

postgresql/filelist.xml

@@ -178,6 +178,12 @@
 <!-- back matter -->
 <!ENTITY biblio     SYSTEM "biblio.xml">
 
+<!-- Stubs for removed entries to preserve public links -->
+<!ENTITY obsolete SYSTEM "appendix-obsolete.xml">
+<!ENTITY obsolete-pgxlogdump SYSTEM "appendix-obsolete-pgxlogdump.xml">
+<!ENTITY obsolete-pgresetxlog SYSTEM "appendix-obsolete-pgresetxlog.xml">
+<!ENTITY obsolete-pgreceivexlog SYSTEM "appendix-obsolete-pgreceivexlog.xml">
+
 <!-- french translation part -->
 <!ENTITY frenchtranslation SYSTEM "frenchtranslation.xml">
 

postgresql/func.xml

@@ -6295,8 +6295,8 @@ disponibles pour formater les valeurs de types date et heure.
   </row>
   <row>
    <entry><literal>J</literal></entry>
-   <entry>nombre de jours dans le calendrier Julien (nombre de jours depuis le 24
-    novembre -4714 à minuit)</entry>
+   <entry>Date Julien (nombre de jours depuis le 24 novembre -4714 à minuit
+    heure locale&nbsp;; voir <xref linkend="datetime-julian-dates"/>)</entry>
   </row>
   <row>
    <entry><literal>Q</literal></entry>
@@ -7998,6 +7998,25 @@ SELECT EXTRACT(ISOYEAR FROM DATE '2006-01-02');
   </listitem>
  </varlistentry>
 
+     <varlistentry>
+      <term><literal>julian</literal></term>
+      <listitem>
+       <para>
+        La <firstterm>Date Julien</firstterm> correspondant à la date
+        ou à l'horodatage (non applicable aux intervalles). Les horodatages
+        qui ne sont pas à minuit heure locale résultent en une valeur fractionnelle. Voir
+        <xref linkend="datetime-julian-dates"/> pour plus d'informations.
+       </para>
+
+<screen>
+SELECT EXTRACT(JULIAN FROM DATE '2006-01-01');
+<lineannotation>Result: </lineannotation><computeroutput>2453737</computeroutput>
+SELECT EXTRACT(JULIAN FROM TIMESTAMP '2006-01-01 12:00');
+<lineannotation>Result: </lineannotation><computeroutput>2453737.5</computeroutput>
+</screen>
+      </listitem>
+     </varlistentry>
+
  <varlistentry>
   <term><literal>microseconds</literal></term>
   <listitem>

postgresql/hstore.xml

@@ -636,15 +636,16 @@ UPDATE nom_table SET col_hstore = col_hstore || '';
    <programlisting>
 ALTER TABLE nom_table ALTER col_hstore TYPE col_hstore USING hstorecol || '';
    </programlisting>
-   La méthode <command>ALTER TABLE</command> requiert un verrou exclusif sur
+   La méthode <command>ALTER TABLE</command> requiert un verrou de type
+   <literal>ACCESS EXCLUSIVE</literal> sur
    la table mais n'a pas pour résultat une fragmentation de la table avec
    d'anciennes versions des lignes.
   </para>
 
  </sect2>
 
  <sect2>
-  <title>Transforms</title>
+  <title>Transformations</title>
 
   <para>
    Des extensions supplémentaires sont disponibles pour implémenter des

postgresql/indexam.xml

@@ -933,9 +933,10 @@ amrestrpos (IndexScanDesc scan);
    <literal>RowExclusiveLock</literal> lors de sa mise à jour (ce qui inclut le
    <command>VACUUM</command> simple). Comme ces types de
    verrous ne sont pas conflictuels, la méthode d'accès est responsable de la
-   finesse du verrouillage dont elle a besoin. Un verrou exclusif sur
-   l'intégralité de l'index entier n'est posé qu'à la création de l'index, sa destruction
-   ou lors d'un <literal>REINDEX</literal>.
+   finesse du verrouillage dont elle a besoin. Un verrou de type
+   <literal>ACCESS EXCLUSIVE</literal> sur l'intégralité de l'index entier
+   n'est posé qu'à la création de l'index, sa destruction ou lors d'un
+   <literal>REINDEX</literal>.
   </para>
 
   <para>