From 9b4201661cf4280b08708f9852c672be126c69ef Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Thu, 14 May 2026 10:40:38 +0200
Subject: [PATCH] [Sync EN] streamWrapper::stream_lock: document LOCK_NB as
 bitmask flag

Fixes #618
---
 .../stream/streamwrapper/stream-lock.xml      | 26 +++++++++----------
 1 file changed, 12 insertions(+), 14 deletions(-)

diff --git a/reference/stream/streamwrapper/stream-lock.xml b/reference/stream/streamwrapper/stream-lock.xml
index 5879d4c9b..1069f4abd 100644
--- a/reference/stream/streamwrapper/stream-lock.xml
+++ b/reference/stream/streamwrapper/stream-lock.xml
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: fa5ef560a6ea59e32de1e383969ac728526a1335 Maintainer: seros Status: ready -->
+<!-- EN-Revision: 38231ac293eaabd5161c7276a72b9683ad02fd3c Maintainer: lacatoire Status: ready -->
 <!-- Reviewed: no -->
 
 <refentry xml:id="streamwrapper.stream-lock" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -15,13 +15,13 @@
    <modifier>public</modifier> <type>bool</type><methodname>streamWrapper::stream_lock</methodname>
    <methodparam><type>int</type><parameter>operation</parameter></methodparam>
   </methodsynopsis>
-  <para>
+  <simpara>
    Este método es llamado en respuesta a <function>flock</function>, cuando se utiliza
    <function>file_put_contents</function> (cuando el parámetro <parameter>flags</parameter>
    contiene <constant>LOCK_EX</constant>),
    <function>stream_set_blocking</function> y cuando se cierra el flujo
    (<constant>LOCK_UN</constant>).
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
@@ -49,15 +49,13 @@
           <constant>LOCK_UN</constant> para liberar un bloqueo (compartido o exclusivo).
          </simpara>
         </listitem>
-        <listitem>
-         <simpara>
-          <constant>LOCK_NB</constant>, utilice esta operación si no quiere que
-          <function>flock</function> bloquee mientras opera.
-          (no soportado en Windows)
-         </simpara>
-        </listitem>
        </itemizedlist>
       </para>
+      <simpara>
+       También es posible añadir <constant>LOCK_NB</constant> como máscara de bits
+       a una de las operaciones anteriores, si el bloqueo no debe bloquear
+       durante el intento de bloqueo (no soportado en Windows).
+      </simpara>
      </listitem>
     </varlistentry>
    </variablelist>
@@ -66,16 +64,16 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
+  <simpara>
    &return.success;
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="errors"><!-- {{{ -->
   &reftitle.errors;
-  <para>
+  <simpara>
    Emite un <constant>E_WARNING</constant> si la llamada a este método falla (es decir, no implementado).
-  </para>
+  </simpara>
  </refsect1><!-- }}} -->