[Sync-En] flock: document Windows deadlock behavior

reference/filesystem/functions/flock.xml

@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 75a76afb61d91f04feebc83931c5412b13682d2b Maintainer: lacatoire Status: ready -->
-<!-- Reviewed: yes -->
+<!-- EN-Revision: f3112c43e303fcd63c0df89798b45bfef9d49e15 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="function.flock" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>flock</refname>
@@ -193,13 +191,35 @@ fclose($fp);
     comme <literal>FAT</literal> et ses dérivés, et retourne forcément
     &false; sous ces environnements.
    </para>
+   <para>
+    Sur Windows, si PHP essaie d'exécuter un fichier source PHP verrouillé par
+    <constant>LOCK_EX</constant>, il va se bloquer jusqu'à ce que le fichier soit
+    déverrouillé. L'exemple suivant provoquera un interblocage :
+    <informalexample>
+     <programlisting role="php">
+<![CDATA[
+<?php
+if ($argv[1] ?? null === 'child') { die(); }
+$fp = fopen(__FILE__, "rb");
+flock($fp, LOCK_EX);
+shell_exec("php " . escapeshellarg(__FILE__) . " child");
+?>
+]]>
+     </programlisting>
+    </informalexample>
+   </para>
   </warning>
   <note>
    <para>
     Sur Windows, si la procédure de verrou ouvre un fichier une deuxième fois,
     il ne peut pas accéder au fichier à travers ce gestionnaire jusqu'à ce que
     le fichier soit déverrouillé.
    </para>
+   <simpara>
+    Sur Windows, si vous essayez d'inclure avec <literal>require</literal> un fichier
+    verrouillé par <constant>LOCK_EX</constant>, cela échouera avec l'erreur :
+    ErrorException: require(): Read of X bytes failed with errno=13 Permission denied
+   </simpara>
   </note>
  </refsect1>