File 1952-stdlib-Improve-documentation-for-ets-whereis-1.patch of Package erlang

From e20b1a2b201ed3f68190f6f8d6ed3f83ceaa1c53 Mon Sep 17 00:00:00 2001
From: Sverker Eriksson <sverker@erlang.org>
Date: Mon, 12 Jan 2026 14:15:20 +0100
Subject: [PATCH 2/3] stdlib: Improve documentation for ets:whereis/1

---
 lib/stdlib/src/ets.erl | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/lib/stdlib/src/ets.erl b/lib/stdlib/src/ets.erl
index d50cd43073..39c675fc33 100644
--- a/lib/stdlib/src/ets.erl
+++ b/lib/stdlib/src/ets.erl
@@ -1808,11 +1808,13 @@ update_element(_, _, _, _) ->
 -doc """
 This function returns the `t:tid/0` of the named table identified by
 `TableName`, or `undefined` if no such table exists. The `t:tid/0` can be used
-in place of the table name in all operations, which is slightly faster since the
-name does not have to be resolved on each call.
+in place of the table name in all operations, which is slightly faster since
+the name does not have to be resolved on each call.
 
-If the table is deleted, the `t:tid/0` will be invalid even if another named
-table is created with the same name.
+Another reason for using `whereis/1` is to make sure a sequence of calls are
+accessing the same table even if the table is (concurrently) deleted and
+recreated with the same name. When the table is deleted, its `t:tid/0` will be
+invalid even if another table is created with the same name.
 """.
 -doc(#{since => <<"OTP 21.0">>}).
 -spec whereis(TableName) -> tid() | undefined when
-- 
2.51.0