File 2941-Revise-note-on-late-replies-from-gen_server.xml.patch of Package erlang
From a1a56ba4cd73540dfe5f2a5ecabf1b03c0ec215d Mon Sep 17 00:00:00 2001
From: James Paton <jpaton2@fb.com>
Date: Thu, 21 Apr 2022 13:31:19 -0700
Subject: [PATCH] Revise note on late replies from gen_server.xml
The late reply issue should not exist anymore because gen:call uses process aliases for reply routing.
I also fix one trivial typo elsewhere in the file.
---
lib/stdlib/doc/src/gen_server.xml | 8 ++++++--
1 file changed, 6 insertions(+), 2 deletions(-)
diff --git a/lib/stdlib/doc/src/gen_server.xml b/lib/stdlib/doc/src/gen_server.xml
index 6f5a650acc..38a82794f1 100644
--- a/lib/stdlib/doc/src/gen_server.xml
+++ b/lib/stdlib/doc/src/gen_server.xml
@@ -538,7 +538,7 @@ gen_server:abcast -----> Module:handle_cast/2
</p>
<note>
<p>
- If the caller uses (<c>try</c>...)<c>catch</c>
+ Before OTP 24, if the caller uses (<c>try</c>...)<c>catch</c>
to avoid process exit,
and the server happens to just be late with the reply,
it may arrive to the process message queue any time later.
@@ -549,13 +549,17 @@ gen_server:abcast -----> Module:handle_cast/2
so they do not clog the process message queue
or gets mistaken for other messages.
</p>
+ <p>
+ Starting with OTP 24, <c>gen_server:call</c> uses process aliases,
+ so late replies will not be received.
+ </p>
</note>
<p>
The return value <c><anno>Reply</anno></c>
is passed from the return value of <c>Module:handle_call/3</c>.
</p>
<p>
- This call may exit the callling process
+ This call may exit the calling process
with an exit term on the form
<c>{Reason, Location}</c> where
<c>Location = {gen_server,call,ArgList}</c>
--
2.35.3