From 6defe4e34afc8902f78ed21d853c1707f49bb3bc Mon Sep 17 00:00:00 2001
From: Louis-Arnaud <la.catoire@gmail.com>
Date: Mon, 7 Sep 2026 10:19:12 +0200
Subject: [PATCH] [Sync-En] memory_get_usage: clarify which memory is reported

---
 reference/info/functions/memory-get-usage.xml | 67 ++++++++++++-------
 1 file changed, 42 insertions(+), 25 deletions(-)

diff --git a/reference/info/functions/memory-get-usage.xml b/reference/info/functions/memory-get-usage.xml
index 36dd3af3a0..2021ce94b6 100644
--- a/reference/info/functions/memory-get-usage.xml
+++ b/reference/info/functions/memory-get-usage.xml
@@ -1,12 +1,14 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 9af43469f46843451955b8926fe470a9f3d45034 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: f78a9528a2fe8e78380fb28cacbe6e152fa4bb6d Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: yes -->
 
 <refentry xml:id="function.memory-get-usage" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
   <refname>memory_get_usage</refname>
-  <refpurpose>Indica la cantidad de memoria utilizada por PHP</refpurpose>
+  <refpurpose>
+   Indica la cantidad de memoria asignada al script PHP, o reservada al sistema
+   por el gestor de memoria de PHP
+  </refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -15,29 +17,43 @@
    <type>int</type><methodname>memory_get_usage</methodname>
    <methodparam choice="opt"><type>bool</type><parameter>real_usage</parameter><initializer>&false;</initializer></methodparam>
   </methodsynopsis>
-  <para>
-   Devuelve la cantidad de memoria asignada a PHP en este momento.
-  </para>
+  <simpara>
+   Devuelve la cantidad de memoria, en bytes, asignada actualmente al script
+   PHP por el gestor de memoria de PHP. El valor indicado se redondea al paso
+   de asignación del asignador, por lo que es mayor que el número exacto de
+   bytes solicitados.
+  </simpara>
  </refsect1>
 
  <refsect1 role="parameters">
   &reftitle.parameters;
-  <para>
-   <variablelist>
-    <varlistentry>
-     <term><parameter>real_usage</parameter></term>
-     <listitem>
-      <para>
-       Definir como &true; para obtener el tamaño total de la memoria asignada
-       por el sistema. Si este argumento no está definido o es &false;,
-       solo se retornará la memoria utilizada.
-      </para>
-     </listitem>
-    </varlistentry>
-   </variablelist>
-  </para>
+  <variablelist>
+   <varlistentry>
+    <term><parameter>real_usage</parameter></term>
+    <listitem>
+     <simpara>
+      Definir como &true; para obtener la cantidad total de memoria que el
+      gestor de memoria de PHP ha reservado al sistema, incluidas las páginas
+      que no están en uso en este momento. Es el valor sobre el que se aplica
+      <link linkend="ini.memory-limit">memory_limit</link>. No es la cantidad
+      de memoria que el sistema operativo ha concedido al proceso PHP, que
+      normalmente es mucho mayor.
+     </simpara>
+     <simpara>
+      Si este argumento no está definido o es &false;, solo se indica la
+      memoria asignada actualmente al script PHP.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
   <note>
-   <para>PHP solo puede rastrear la memoria asignada por <literal>emalloc()</literal></para>
+   <simpara>
+    PHP solo rastrea la memoria asignada por su propio gestor de memoria, es
+    decir a través de la función interna <literal>emalloc()</literal> y las
+    funciones relacionadas. La memoria asignada de forma persistente, o
+    directamente con <literal>malloc()</literal> por una extensión, no se
+    indica, ni siquiera cuando <parameter>real_usage</parameter> es &true;.
+   </simpara>
   </note>
  </refsect1>
 
@@ -56,18 +72,19 @@
     <programlisting role="php">
 <![CDATA[
 <?php
+
 // Esto es solo un ejemplo. Los números a continuación
-// variarán según los sistemas y las configuraciones
+// variarán según el sistema utilizado
 
-echo memory_get_usage() . "\n"; // 36640
+echo memory_get_usage(), "\n"; // 36640
 
 $a = str_repeat("Hello", 4242);
 
-echo memory_get_usage() . "\n"; // 57960
+echo memory_get_usage(), "\n"; // 57960
 
 unset($a);
 
-echo memory_get_usage() . "\n"; // 36744
+echo memory_get_usage(), "\n"; // 36744
 
 ?>
 ]]>