Quelques autres fichiers

gleu · Aug 1, 2022 · e072328 · e072328
1 parent 2b5dcc8
commit e072328
Show file tree

Hide file tree

Showing 8 changed files with 330 additions and 340 deletions.
diff --git a/postgresql/ref/analyze.xml b/postgresql/ref/analyze.xml
diff --git a/postgresql/ref/begin.xml b/postgresql/ref/begin.xml
@@ -31,16 +31,16 @@
 
   <para>
    <command>BEGIN</command> initie un bloc de transaction, c'est-à-dire que
-   toutes les instructions apparaissant après la commande <command>BEGIN</command> sont
-   exécutées dans une seule transaction jusqu'à ce qu'un
-   <link linkend="sql-commit"><command>COMMIT</command></link> ou <link
-   linkend="sql-rollback"><command>ROLLBACK</command></link> explicite soit exécuté.
-   Par défaut (sans <command>BEGIN</command>),
-   <productname>PostgreSQL</productname> exécute les
-   transactions en mode <quote>autocommit</quote>, c'est-à-dire que chaque
-   instruction est exécutée dans sa propre transaction et une validation
-   (commit) est traitée implicitement à la fin de l'instruction (si l'exécution
-   a réussi, sinon une annulation est exécutée).
+   toutes les instructions apparaissant après la commande
+   <command>BEGIN</command> sont exécutées dans une seule transaction jusqu'à ce
+   qu'un <link linkend="sql-commit"><command>COMMIT</command></link> ou <link
+   linkend="sql-rollback"><command>ROLLBACK</command></link> explicite soit
+   exécuté.  Par défaut (sans <command>BEGIN</command>),
+   <productname>PostgreSQL</productname> exécute les transactions en mode
+   <quote>autocommit</quote>, c'est-à-dire que chaque instruction est exécutée
+   dans sa propre transaction et une validation (commit) est traitée
+   implicitement à la fin de l'instruction (si l'exécution a réussi, sinon une
+   annulation est exécutée).
   </para>
 
   <para>
@@ -49,14 +49,15 @@
    significative du CPU et du disque. L'exécution de plusieurs instructions dans
    une transaction est aussi utile pour s'assurer d'une cohérence lors de la
    réalisation de certains modifications liées&nbsp;: les autres sessions ne
-   voient pas les états intermédiaires tant que toutes les
-   mises à jour ne sont pas réalisées.
+   voient pas les états intermédiaires tant que toutes les mises à jour ne sont
+   pas réalisées.
   </para>
 
   <para>
-   Si le niveau d'isolation, le mode lecture/écriture ou le mode différable
-   sont spécifiés, la nouvelle transaction possède ces caractéristiques, comme
-   si <link linkend="sql-set-transaction"><command>SET TRANSACTION</command></link> était exécutée.
+   Si le niveau d'isolation, le mode lecture/écriture ou le mode différable sont
+   spécifiés, la nouvelle transaction possède ces caractéristiques, comme si
+   <link linkend="sql-set-transaction"><command>SET TRANSACTION</command></link>
+   était exécutée.
   </para>
  </refsect1>
 
@@ -76,8 +77,8 @@
   </variablelist>
 
   <para>
-   <xref linkend="sql-set-transaction"/>
-   présente la signification des autres paramètres de cette instruction.
+   <xref linkend="sql-set-transaction"/> présente la signification des autres
+   paramètres de cette instruction.
   </para>
 
  </refsect1>
@@ -86,22 +87,22 @@
   <title>Notes</title>
 
   <para>
-   <link linkend="sql-start-transaction"><command>START TRANSACTION</command></link>
-   a la même fonctionnalité que <command>BEGIN</command>.
+   <link linkend="sql-start-transaction"><command>START
+   TRANSACTION</command></link> est un synonyme de <command>BEGIN</command>.
   </para>
 
   <para>
-   <link linkend="sql-commit"><command>COMMIT</command></link> ou
-   <link linkend="sql-rollback"><command>ROLLBACK</command></link> sont utilisés
-   pour terminer un bloc de transaction.
+   <link linkend="sql-commit"><command>COMMIT</command></link> et <link
+   linkend="sql-rollback"><command>ROLLBACK</command></link> sont utilisés pour
+   terminer un bloc de transaction.
   </para>
 
   <para>
    Lancer <command>BEGIN</command> en étant déjà dans un bloc de transaction
    provoque l'apparition d'un message d'avertissement, mais l'état de la
    transaction n'en est pas affecté. Pour intégrer des transactions à
-   l'intérieur d'un bloc de transaction, les points de sauvegarde sont
-   utilisés (voir <xref linkend="sql-savepoint"/>).
+   l'intérieur d'un bloc de transaction, les points de sauvegarde sont utilisés
+   (voir <xref linkend="sql-savepoint"/>).
   </para>
 
   <para>
@@ -127,22 +128,22 @@
 
   <para>
    <command>BEGIN</command>, qui est une extension
-   <productname>PostgreSQL</productname>, est  équivalent à la commande
-   <link linkend="sql-start-transaction"><command>START TRANSACTION</command></link>
+   <productname>PostgreSQL</productname>, est équivalent à la commande <link
+   linkend="sql-start-transaction"><command>START TRANSACTION</command></link>
    du standard SQL. La page de référence de cette commande contient des
-   informations de compatibilité supplémentaires.
+   informations supplémentaires de compatibilité.
   </para>
 
   <para>
-   L'option <literal>DEFERRABLE</literal> de
-   <replaceable class="parameter">transaction_mode</replaceable>
-   est une extension de <productname>PostgreSQL</productname>.
+   L'option <literal>DEFERRABLE</literal> de <replaceable
+   class="parameter">mode_transaction</replaceable> est une extension de
+   <productname>PostgreSQL</productname>.
   </para>
 
   <para>
-   Le mot clé <literal>BEGIN</literal> est utilisé dans un but
-   différent en SQL embarqué. La sémantique de la transaction doit être étudiée
-   avec précaution lors du portage d'applications.
+   Le mot clé <literal>BEGIN</literal> est utilisé dans un but différent en SQL
+   embarqué. La sémantique de la transaction doit être étudiée avec précaution
+   lors du portage d'applications.
   </para>
  </refsect1>
 

diff --git a/postgresql/ref/call.xml b/postgresql/ref/call.xml
@@ -1,9 +1,4 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!--
-doc/src/sgml/ref/call.sgml
-PostgreSQL documentation
--->
-
 <refentry id="sql-call">
  <indexterm zone="sql-call">
   <primary>CALL</primary>
@@ -47,7 +42,7 @@ CALL <replaceable class="parameter">nom</replaceable> ( [ <replaceable class="pa
     <term><replaceable class="parameter">nom</replaceable></term>
     <listitem>
      <para>
-      Le nom (potientiellement qualifié du schéma) de la procédure.
+      Le nom (potentiellement qualifié du schéma) de la procédure.
      </para>
     </listitem>
    </varlistentry>
@@ -63,20 +58,18 @@ CALL <replaceable class="parameter">nom</replaceable> ( [ <replaceable class="pa
       Les arguments peuvent inclure des noms de paramètres, en utilisant la
       syntaxe <literal><replaceable class="parameter">nom</replaceable> =&gt;
       <replaceable class="parameter">valeur</replaceable></literal>. Ceci
-      fonctionne de la même façon que des appels de fonctions
-      ordinaires&nbsp;; voir <xref linkend="sql-syntax-calling-funcs"/> pour
-      les détails.
+      fonctionne de la même façon que des appels de fonctions ordinaires&nbsp;;
+      voir <xref linkend="sql-syntax-calling-funcs"/> pour les détails.
      </para>
 
      <para>
       Les arguments doivent être fournis pour tous les paramètres de la
       procédure qui n'ont pas de valeurs par défaut, y compris pour les
-      paramètres <literal>OUT</literal>. Néanmoins, les arguments
-      correspondant aux paramètres <literal>OUT</literal> ne sont pas
-      évalués, donc il est habituel de simplement écrire
-      <literal>NULL</literal> pour eux.(Écrire autre chose pour un paramètre
-      <literal>OUT</literal> pourrait causer des problèmes de compatibilité
-      avec les prochaines versions de
+      paramètres <literal>OUT</literal>. Néanmoins, les arguments correspondant
+      aux paramètres <literal>OUT</literal> ne sont pas évalués, donc il est
+      habituel de simplement écrire <literal>NULL</literal> pour eux. (Écrire
+      autre chose pour un paramètre <literal>OUT</literal> pourrait causer des
+      problèmes de compatibilité avec les prochaines versions de
       <productname>PostgreSQL</productname>.)
      </para>
     </listitem>
@@ -88,8 +81,8 @@ CALL <replaceable class="parameter">nom</replaceable> ( [ <replaceable class="pa
   <title>Notes</title>
 
   <para>
-   L'utilisateur doit avoir le droit <literal>EXECUTE</literal> sur la
-   procédure pour être autorisé à l'exécuter.
+   L'utilisateur doit avoir le droit <literal>EXECUTE</literal> sur la procédure
+   pour être autorisé à l'exécuter.
   </para>
 
   <para>
@@ -98,15 +91,15 @@ CALL <replaceable class="parameter">nom</replaceable> ( [ <replaceable class="pa
   </para>
 
   <para>
-   Si <command>CALL</command> est exécuté dans un bloc de transaction, alors
-   la procédure appelée ne peut pas exécuter d'ordre de contrôle de transaction.
+   Si <command>CALL</command> est exécuté dans un bloc de transaction, alors la
+   procédure appelée ne peut pas exécuter d'ordre de contrôle de transaction.
    Les ordres de contrôle de transaction ne sont autorisés que si
    <command>CALL</command> est exécuté dans sa propre transaction.
   </para>
 
   <para>
    <application>PL/pgSQL</application> gère différemment des paramètres en
-   sortie dans les commandes  <command>CALL</command>&nbsp;; voir <xref
+   sortie dans les commandes <command>CALL</command>&nbsp;; voir <xref
    linkend="plpgsql-statements-calling-procedure"/>.
   </para>
  </refsect1>

diff --git a/postgresql/ref/checkpoint.xml b/postgresql/ref/checkpoint.xml
@@ -12,7 +12,7 @@
 
  <refnamediv>
   <refname>CHECKPOINT</refname>
-  <refpurpose>Forcer un point de vérification dans le journal des transactions</refpurpose>
+  <refpurpose>Forcer un checkpoint dans le journal des transactions</refpurpose>
  </refnamediv>
 
  <refsynopsisdiv>
@@ -24,24 +24,24 @@
   <title>Description</title>
 
   <para>
-   Un point de vérification est un point dans la séquence du journal des
-   transactions pour lequel tous les fichiers de données ont été mis à jour
-   pour refléter l'information des journaux. Tous les fichiers de données
-   sont écrits sur le disque. Il convient de se référer à <xref linkend="wal"/> pour plus
+   Un checkpoint est un point dans la séquence du journal des transactions pour
+   lequel tous les fichiers de données ont été mis à jour pour refléter
+   l'information des journaux. Tous les fichiers de données sont écrits sur le
+   disque. Il convient de se référer à <xref linkend="wal"/> pour plus
    d'informations sur ce qui se produit lors d'un checkpoint.
   </para>
 
   <para>
    La commande <command>CHECKPOINT</command> force un checkpoint immédiat, sans
-   attendre le CHECKPOINT régulier planifié par le système et contrôlé par le
-   paramètre <xref linkend="runtime-config-wal-checkpoints"/>.
+   attendre le checkpoint régulier planifié par le système et contrôlé par les
+   paramètres de <xref linkend="runtime-config-wal-checkpoints"/>.
    <command>CHECKPOINT</command> n'est généralement pas utilisé en temps normal.
   </para>
 
   <para>
-   S'il est exécuté durant une restauration, la commande
-   <command>CHECKPOINT</command> forcera un point de redémarrage (voir <xref linkend="wal-configuration"/>) plutôt que
-   l'écriture d'un nouveau point de vérification.
+   S'il est exécuté lors d'une restauration, la commande
+   <command>CHECKPOINT</command> forcera un restartpoint (voir <xref
+   linkend="wal-configuration"/>) plutôt que l'écriture d'un nouveau checkpoint.
   </para>
 
   <para>

diff --git a/postgresql/ref/close.xml b/postgresql/ref/close.xml
@@ -29,21 +29,22 @@
   <title>Description</title>
 
   <para>
-   <command>CLOSE</command> libère les ressources associées à un curseur
-   ouvert. Une fois le curseur fermé, aucune opération n'est autorisée sur
-   celui-ci. Un curseur doit être fermé lorsqu'il n'est plus nécessaire.
+   <command>CLOSE</command> libère les ressources associées à un curseur ouvert.
+   Une fois le curseur fermé, aucune opération n'est autorisée sur celui-ci. Un
+   curseur doit être fermé lorsqu'il n'est plus nécessaire.
   </para>
 
   <para>
-   Tout curseur volatil ouvert  (NDT&nbsp;: On parle en anglais de <literal>non-holdable cursor</literal>, soit
-   un curseur qui ne perdure pas au-delà de la transaction qui l'a créé) est fermé implicitement lorsqu'une
-   transaction est terminée avec <command>COMMIT</command> ou
-   <command>ROLLBACK</command>. Un curseur persistant (NDT&nbsp;: <literal>holdable cursor</literal> en anglais,
-   ou curseur qui perdure au-delà de la transaction initiale) est implicitement fermé si la
-   transaction qui l'a créé est annulée via <command>ROLLBACK</command>. Si
-   cette transaction est validée (avec succès), ce curseur reste ouvert
-   jusqu'à ce qu'une commande <command>CLOSE</command> explicite soit lancée ou
-   jusqu'à la déconnexion du client.
+   Tout curseur volatil ouvert (en anglais <literal>non-holdable
+   cursor</literal>, soit un curseur qui ne perdure pas au-delà de la
+   transaction qui l'a créé) est fermé implicitement lorsqu'une transaction est
+   terminée avec <command>COMMIT</command> ou <command>ROLLBACK</command>. Un
+   curseur persistant (en anglais <literal>holdable cursor</literal>, soit un
+   curseur qui perdure au-delà de la transaction initiale) est implicitement
+   fermé si la transaction qui l'a créé est annulée via
+   <command>ROLLBACK</command>. Si cette transaction est validée (avec succès),
+   ce curseur reste ouvert jusqu'à ce qu'une commande <command>CLOSE</command>
+   explicite soit lancée ou jusqu'à la déconnexion du client.
   </para>
  </refsect1>
 
@@ -75,10 +76,10 @@
   <title>Notes</title>
 
   <para>
-   <productname>PostgreSQL</productname> ne possède pas d'instruction
-   explicite d'ouverture (<command>OPEN</command>) de curseur&nbsp;; un curseur
-   est considéré ouvert à sa déclaration. Un curseur est déclaré à l'aide de l'instruction
-   <link linkend="sql-declare"><command>DECLARE</command></link>.
+   <productname>PostgreSQL</productname> ne possède pas d'instruction explicite
+   d'ouverture (<command>OPEN</command>) de curseur&nbsp;; un curseur est
+   considéré ouvert à sa déclaration. Un curseur est déclaré à l'aide de
+   l'instruction <link linkend="sql-declare"><command>DECLARE</command></link>.
   </para>
 
   <para>