From 6c8ac3d8347644cdf014da1da170fbd80553c5df Mon Sep 17 00:00:00 2001
From: Victor <61290725+victor-prdh@users.noreply.github.com>
Date: Wed, 6 Jul 2022 18:17:22 +0200
Subject: [PATCH] Add fsync & fdatasync translation + review stat (#255)

Co-authored-by: prudhomme victor <vic301202@gmail.com>
---
 reference/filesystem/functions/fdatasync.xml | 96 ++++++++++++++++++++
 reference/filesystem/functions/fsync.xml     | 94 +++++++++++++++++++
 reference/filesystem/functions/stat.xml      |  4 +-
 3 files changed, 192 insertions(+), 2 deletions(-)
 create mode 100644 reference/filesystem/functions/fdatasync.xml
 create mode 100644 reference/filesystem/functions/fsync.xml

diff --git a/reference/filesystem/functions/fdatasync.xml b/reference/filesystem/functions/fdatasync.xml
new file mode 100644
index 000000000..90c4ebb83
--- /dev/null
+++ b/reference/filesystem/functions/fdatasync.xml
@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 21129de1745eb016452f0ce8a2c3e47fbb8484de Maintainer: victor-prdh Status: ready -->
+<refentry xml:id="function.fdatasync" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>fdatasync</refname>
+  <refpurpose>Synchronise les données (mais pas les métadonnées) avec le fichier</refpurpose>
+ </refnamediv>
+ 
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>fdatasync</methodname>
+   <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Cette fonction synchronise le contenu du <parameter>stream</parameter> sur le support de stockage, tout comme <function>fsync</function> le fait,
+   mais elle ne synchronise pas les métadonnées des fichiers.
+   Il est à noter que que cette fonction est différente seulement dans les systèmes POSIX.
+   Sous Windows, cette fonction est un alias de <function>fsync</function>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>stream</parameter></term>
+     <listitem>
+      &fs.validfp.all;
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>fdatasync</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$file = 'test.txt';
+$stream = fopen($file, 'w');
+fwrite($stream, 'test data');
+fwrite($stream, "\r\n");
+fwrite($stream, 'additional data');
+fdatasync($stream);
+fclose($stream);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+ 
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>fflush</function></member>
+    <member><function>fsync</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/filesystem/functions/fsync.xml b/reference/filesystem/functions/fsync.xml
new file mode 100644
index 000000000..00f4975e0
--- /dev/null
+++ b/reference/filesystem/functions/fsync.xml
@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 21129de1745eb016452f0ce8a2c3e47fbb8484de Maintainer: victor-prdh Status: ready -->
+<refentry xml:id="function.fsync" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>fsync</refname>
+  <refpurpose>Synchronise les modifications apportées au fichier (y compris les métadonnées)</refpurpose>
+ </refnamediv>
+ 
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>fsync</methodname>
+   <methodparam><type>resource</type><parameter>stream</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Cette fonction synchronise les modifications apportées au fichier, y compris ses métadonnées. Celle-ci est similaire à <function>fflush</function>,
+   mais elle demande également au système d'exploitation d'écrire sur le support de stockage.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>stream</parameter></term>
+     <listitem>
+      &fs.validfp.all;
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   &return.success;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title><function>fsync</function> example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+$file = 'test.txt';
+$stream = fopen($file, 'w');
+fwrite($stream, 'test data');
+fwrite($stream, "\r\n");
+fwrite($stream, 'additional data');
+fsync($stream);
+fclose($stream);
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+ 
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>fdatasync</function></member>
+    <member><function>fflush</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->
diff --git a/reference/filesystem/functions/stat.xml b/reference/filesystem/functions/stat.xml
index 4fa3f0693..c489cb4d8 100644
--- a/reference/filesystem/functions/stat.xml
+++ b/reference/filesystem/functions/stat.xml
@@ -148,7 +148,7 @@
   <para>
    **** - Sous Windows, depuis PHP 7.4.0, c'est l'identifiant associé avec le fichier,
    qui sera un entier 64-bit <emphasis>non signé</emphasis> qui peut déborder.
-   Previously, it was always <literal>0</literal>.
+   Auparavant, c'était toujours <literal>0</literal>.
   </para>
   <para>
    ***** Sous Windows, le bit de la permission d'écriture est définit en
@@ -245,7 +245,7 @@
        Les valeurs statiques <literal>size</literal>, <literal>atime</literal>,
        <literal>mtime</literal> et <literal>ctime</literal> des liens symboliques
        sont toujours ceux de la cible. Ce n'était précédemment pas le cas
-       This was previously not the case for <abbrev>NTS</abbrev> builds on Windows.
+       pour les builds <abbrev>NTS</abbrev> sous Windows.
       </entry>
      </row>
     </tbody>