File 3421-Refine-process-message-queue-data-configur... of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 3421-Refine-process-message-queue-data-configuration-docu.patch of Package erlang (Revision 6a6e740c0161086d7407fd293e77c355)

Currently displaying revision 6a6e740c0161086d7407fd293e77c355 , Show latest

From 2ce123f3b22a976c7b5f62ff556ce5ebdc01c800 Mon Sep 17 00:00:00 2001
From: Robert Gionea <robert@gionea.com>
Date: Tue, 2 Mar 2021 22:43:17 +0100
Subject: [PATCH] Refine process message queue data configuration documentation

---
 erts/doc/src/erl_cmd.xml |  4 +--
 erts/doc/src/erlang.xml  | 60 ++++++++++++++++++++--------------------
 2 files changed, 32 insertions(+), 32 deletions(-)

diff --git a/erts/doc/src/erl.xml b/erts/doc/src/erl.xml
index 3dbcbe1973..372aee0380 100644
--- a/erts/doc/src/erl.xml
+++ b/erts/doc/src/erl.xml
@@ -824,9 +824,9 @@
 </item>
 <tag><marker id="+hmqd"/><c>+hmqd off_heap|on_heap</c></tag>
 <item>
- Sets the default value for process flag <c>message_queue_data</c>.
+ Sets the default value of the <c>message_queue_data</c> process flag.
 Defaults to <c>on_heap</c>. If <c>+hmqd</c> is not
-	 passed, <c>on_heap</c> will be the default. For more information, see
+ passed, <c>on_heap</c> will be the default. For more information, see
 <seealso marker="erlang#process_flag_message_queue_data">
 <c>process_flag(message_queue_data, MQD)</c></seealso>.
 </item>
diff --git a/erts/doc/src/erlang.xml b/erts/doc/src/erlang.xml
index 97f6f7e83d..2d6aefab43 100644
--- a/erts/doc/src/erlang.xml
+++ b/erts/doc/src/erlang.xml
@@ -5088,37 +5088,37 @@ RealSystem = system + MissedSystem</code>
 <type name="message_queue_data"/>
 <desc>
 <marker id="process_flag_message_queue_data"/>
- This flag determines how messages in the message queue
+ Determines how messages in the message queue
 are stored, as follows:
 <taglist>
 <tag><c>off_heap</c></tag>
 <item>
 All messages in the message queue will be stored
- outside of the process heap. This implies that no
+ outside the process heap. This implies that no
 messages in the message queue will be part of a garbage
 collection of the process.
 </item>
 <tag><c>on_heap</c></tag>
 <item>
 All messages in the message queue will eventually be
- placed on heap. They can however temporarily be stored
- off heap. This is how messages always have been stored
+ placed on the process heap. They can, however, be temporarily
+ stored off the heap. This is how messages have always been stored
 up until ERTS 8.0.
 </item>
 </taglist>
- The default <c>message_queue_data</c> process flag is determined
- by command-line argument <seealso marker="erl#+hmqd">
+ The default value of the <c>message_queue_data</c> process flag is
+ determined by the command-line argument <seealso marker="erl#+hmqd">
 <c>+hmqd</c></seealso> in <c>erl(1)</c>.
- If the process potentially can get many messages,
- you are advised to set the flag to <c>off_heap</c>. This
- because a garbage collection with many messages placed on
- the heap can become extremly expensive and the process can
- consume large amounts of memory. Performance of the
- actual message passing is however generally better when not
- using flag <c>off_heap</c>.
- When changing this flag messages will be moved. This work
- has been initiated but not completed when this function
- call returns.
+ If the process may potentially accumulate a large number of messages
+ in its queue it is recommended to set the flag value to <c>off_heap</c>.
+ This is due to the fact that the garbage collection of a process that
+ has a large number of messages stored on the heap can become extremely
+ expensive and the process can consume large amounts of memory.
+ The performance of the actual message passing is, however, generally
+ better when the flag value is <c>on_heap</c>.
+ Changing the flag value causes any existing messages to be moved.
+ The move operation is initiated, but not necessarily completed,
+ by the time the function returns.
 Returns the old value of the flag.
 </desc>
 </func>
@@ -5386,6 +5386,10 @@ RealSystem = system + MissedSystem</code>
 removed without prior notice. In the current implementation
 <c><anno>BinInfo</anno></c> is a list of tuples. The tuples
 contain; <c>BinaryId</c>, <c>BinarySize</c>, <c>BinaryRefcCount</c>.
+ Depending on the value of the
+ <seealso marker="#process_flag_message_queue_data">
+ <c>message_queue_data</c></seealso> process flag the message queue
+ may be stored on the heap.
 </item>
 <tag><c>{catchlevel, <anno>CatchLevel</anno>}</c></tag>
 <item>
@@ -5542,8 +5543,8 @@ RealSystem = system + MissedSystem</code>
 </item>
 <tag><c>{message_queue_data, <anno>MQD</anno>}</c></tag>
 <item>
- Returns the current state of process flag
- <c>message_queue_data</c>. <c><anno>MQD</anno></c> is either
+ <c><anno>MQD</anno></c> is the current value of the
+ <c>message_queue_data</c> process flag, which can be either
 <c>off_heap</c> or <c>on_heap</c>. For more
 information, see the documentation of
 <seealso marker="#process_flag_message_queue_data">
@@ -6531,11 +6532,11 @@ true</pre>
 </item>
 <tag><c>{message_queue_data, <anno>MQD</anno>}</c></tag>
 <item>
- Sets the state of the <c>message_queue_data</c> process
- flag. <c><anno>MQD</anno></c> is to be either <c>off_heap</c>
- or <c>on_heap</c>. The default
+ Sets the value of the <c>message_queue_data</c> process
+ flag. <c><anno>MQD</anno></c> can be either <c>off_heap</c>
+ or <c>on_heap</c>. The default value of the
 <c>message_queue_data</c> process flag is determined by
- command-line argument <seealso marker="erl#+hmqd">
+ the command-line argument <seealso marker="erl#+hmqd">
 <c>+hmqd</c></seealso> in <c>erl(1)</c>.
 For more information, see the documentation of
 <seealso marker="#process_flag_message_queue_data">
@@ -8812,11 +8813,10 @@ Metadata = #{ pid => pid(),
 <c>message_queue_data</c></tag>
 <item>
 Returns the default value of the <c>message_queue_data</c>
- process flag, which is either <c>off_heap</c> or <c>on_heap</c>.
- This default is set by command-line argument
+ process flag, which can be either <c>off_heap</c> or <c>on_heap</c>.
+ The default value is set by the command-line argument
 <seealso marker="erl#+hmqd"><c>+hmqd</c></seealso> in
- <c>erl(1)</c>. For more information on the
- <c>message_queue_data</c> process flag, see documentation of
+ <c>erl(1)</c>. For more information, see the documentation of
 <seealso marker="#process_flag_message_queue_data">
 <c>process_flag(message_queue_data, MQD)</c></seealso>.
 </item>
-- 
2.26.2

Places

File 3421-Refine-process-message-queue-data-configuration-docu.patch of Package erlang (Revision 6a6e740c0161086d7407fd293e77c355)

Places