From 173d1c70a25fb201e148fafbe2a7804882810b01 Mon Sep 17 00:00:00 2001
From: David CARLIER <devnexen@gmail.com>
Date: Mon, 5 Feb 2024 15:25:01 +0000
Subject: [PATCH] filesystem section sync with EN (#785)

---
 reference/filesystem/constants.xml      | 58 ++++++++++++++++++-------
 reference/filesystem/functions/glob.xml | 47 +++-----------------
 2 files changed, 47 insertions(+), 58 deletions(-)

diff --git a/reference/filesystem/constants.xml b/reference/filesystem/constants.xml
index cb2b81fd40..8b4e42a225 100644
--- a/reference/filesystem/constants.xml
+++ b/reference/filesystem/constants.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: aab33d644359aba597e810e2fc0c0caa0d347c9c Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 850ac483c876e767048222f9133e2498145f9f4a Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->
 
 <appendix xml:id="filesystem.constants" xmlns="http://docbook.org/ns/docbook">
@@ -84,83 +84,110 @@
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry xml:id="constant.glob-brace">
+  </variablelist>
+  <variablelist xml:id="constant.glob-constant-variablelist">
+  <varlistentry>
    <term>
     <constant>GLOB_BRACE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
-
+     Étend {a,b,c} pour correspondre à 'a', 'b' ou 'c'
+    </simpara>
+    <note>
+     <simpara>
+      <constant>GLOB_BRACE</constant> n'est pas disponible sur certains systèmes non-GNU,
+      comme Solaris ou Alpine Linux.
+     </simpara>
+    </note>
+   </listitem>
+  </varlistentry>
+  <varlistentry>
+   <term>
+    <constant>GLOB_ERR</constant>
+    (<type>int</type>)
+   </term>
+   <listitem>
+    <simpara>
+     Arrête en cas d'erreurs de lecture (comme les répertoires illisibles),
+     par défaut, les erreurs sont ignorées.
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry xml:id="constant.glob-onlydir">
+  <varlistentry>
    <term>
     <constant>GLOB_ONLYDIR</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
-
+     Retourne uniquement les entrées de répertoire qui correspondent au motif.
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry xml:id="constant.glob-mark">
+  <varlistentry>
    <term>
     <constant>GLOB_MARK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
-
+     Ajoute une barre oblique (un antislash sur Windows) à chaque répertoire retourné.
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry xml:id="constant.glob-nosort">
+  <varlistentry>
    <term>
     <constant>GLOB_NOSORT</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
-
+     Renvoie les fichiers tels qu'ils apparaissent dans le répertoire (sans tri).
+     Lorsque ce drapeau n'est pas utilisé, les noms de chemin sont triés par ordre alphabétique.
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry xml:id="constant.glob-nocheck">
+  <varlistentry>
    <term>
     <constant>GLOB_NOCHECK</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
-
+     Renvoie le motif de recherche s'il n'y a pas de fichiers correspondants.
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry xml:id="constant.glob-noescape">
+  <varlistentry>
    <term>
     <constant>GLOB_NOESCAPE</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
-
+     Les antislash ne mettent pas en échappement les métacaractères.
     </simpara>
    </listitem>
   </varlistentry>
-  <varlistentry xml:id="constant.glob-available-flags">
+  <varlistentry>
    <term>
     <constant>GLOB_AVAILABLE_FLAGS</constant>
     (<type>int</type>)
    </term>
    <listitem>
     <simpara>
-
+     Tous les drapeaux <constant>GLOB_<replaceable>*</replaceable></constant> combinés.
+     Équivalent à <literal>0</literal> | <constant>GLOB_BRACE</constant> |
+     <constant>GLOB_MARK</constant> | <constant>GLOB_NOSORT</constant> |
+     <constant>GLOB_NOCHECK</constant> | <constant>GLOB_NOESCAPE</constant> |
+     <constant>GLOB_ERR</constant> | <constant>GLOB_ONLYDIR</constant>
     </simpara>
    </listitem>
   </varlistentry>
+  </variablelist>
+ <variablelist>
   <varlistentry xml:id="constant.pathinfo-dirname">
    <term>
     <constant>PATHINFO_DIRNAME</constant>
@@ -385,7 +412,6 @@
 
  </variablelist>
 </appendix>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml
diff --git a/reference/filesystem/functions/glob.xml b/reference/filesystem/functions/glob.xml
index f4edc9d05d..ed62ece841 100644
--- a/reference/filesystem/functions/glob.xml
+++ b/reference/filesystem/functions/glob.xml
@@ -1,8 +1,8 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: f739452fff4a12d64c78a3656640ed03fcfe91d0 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 850ac483c876e767048222f9133e2498145f9f4a Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
-<refentry xml:id="function.glob" xmlns="http://docbook.org/ns/docbook">
+<refentry xml:id="function.glob" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>glob</refname>
   <refpurpose>Recherche des chemins qui vérifient un masque</refpurpose>
@@ -70,46 +70,9 @@
      <listitem>
       <para>
        Les drapeaux valides sont :
-       <itemizedlist>
-        <listitem>
-         <simpara>
-          <constant>GLOB_MARK</constant> : Ajoute un slash final (un antislash
-          sous Windows) à chaque dossier retourné
-         </simpara>
-        </listitem>
-        <listitem>
-         <simpara>
-          <constant>GLOB_NOSORT</constant> : Retourne les fichiers dans l'ordre d'apparence (pas de tri).
-          Lorsque ce drapeau n'est pas utilisé, les noms des champs sont triés alphabétiquement
-         </simpara>
-        </listitem>
-        <listitem>
-         <simpara>
-          <constant>GLOB_NOCHECK</constant> : Retourne le masque de recherche si aucun fichier n'a été trouvé
-         </simpara>
-        </listitem>
-        <listitem>
-         <simpara>
-          <constant>GLOB_NOESCAPE</constant> : Ne protège aucun métacaractère d'un antislash
-         </simpara>
-        </listitem>
-        <listitem>
-         <simpara>
-          <constant>GLOB_BRACE</constant> : Remplace {a,b,c} par 'a', 'b' ou 'c'
-         </simpara>
-        </listitem>
-        <listitem>
-         <simpara>
-          <constant>GLOB_ONLYDIR</constant> : Ne retourne que les dossiers qui vérifient le masque
-         </simpara>
-        </listitem>
-        <listitem>
-         <simpara>
-          <constant>GLOB_ERR</constant> : Stop lors d'une erreur (comme des dossiers non lisibles),
-          par défaut, les erreurs sont ignorées.
-         </simpara>
-        </listitem>
-       </itemizedlist>
+       <variablelist>
+        <xi:include set-xml-id="" xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('constant.glob-constant-variablelist')/*)"><xi:fallback/></xi:include>
+       </variablelist>
        <note>
         <simpara>
          Le drapeau <constant>GLOB_BRACE</constant> n'est pas disponible sur certains