File 0579-stdlib-Clarify-docs-for-ets-info-_-safe_fi... of Package erlang

Overview Repositories Revisions Requests Users Attributes Meta

File 0579-stdlib-Clarify-docs-for-ets-info-_-safe_fixed.patch of Package erlang

From 881d88f6ff3e39a91a0cb5ff6bd2944b96fa6736 Mon Sep 17 00:00:00 2001
From: Sverker Eriksson <sverker@erlang.org>
Date: Fri, 8 Mar 2019 17:00:11 +0100
Subject: [PATCH 1/3] stdlib: Clarify docs for ets:info(_, safe_fixed)

It's about the *last* time the table went from unfixed to fixed,
not the first time it ever did.
---
 lib/stdlib/doc/src/ets.xml | 16 +++++++++++-----
 1 file changed, 11 insertions(+), 5 deletions(-)

diff --git a/lib/stdlib/doc/src/ets.xml b/lib/stdlib/doc/src/ets.xml
index d2ac6a75b1..2cb677785d 100644
--- a/lib/stdlib/doc/src/ets.xml
+++ b/lib/stdlib/doc/src/ets.xml
@@ -642,12 +642,11 @@ Error: fun containing local Erlang function calls
 <marker id="info_2_safe_fixed_monotonic_time"/>
 <c>Item=safe_fixed|safe_fixed_monotonic_time,
 Value={FixationTime,Info}|false</c>
- If the table has been fixed using
+ If the table is fixed using
 <seealso marker="#safe_fixtable/2">
 <c>safe_fixtable/2</c></seealso>,
 the call returns a tuple where <c>FixationTime</c> is the
- time when the table was first fixed by a process, which either
- is or is not one of the processes it is fixed by now.
+ last time when the table changed from unfixed to fixed.
 The format and value of <c>FixationTime</c> depends on
 <c>Item</c>:
 <taglist>
@@ -679,8 +678,15 @@ Error: fun containing local Erlang function calls
 table is fixed by now. <c>RefCount</c> is the value
 of the reference counter and it keeps track of how many times
 the table has been fixed by the process.
- If the table never has been fixed, the call returns
- <c>false</c>.
+	 Table fixations are not limited to <seealso marker="#safe_fixtable/2">
+	 <c>safe_fixtable/2</c></seealso>. Temporary fixations may also
+	 be done by for example <seealso marker="#traversal">traversing
+	 functions</seealso> like <c>select</c> and <c>match</c>. Such
+	 table fixations are automatically released before the
+	 corresponding functions returns, but they may be seen by a
+	 concurrent call to
+	 <c>ets:info(T,safe_fixed|safe_fixed_monotonic_time)</c>.
+ If the table is not fixed at all, the call returns <c>false</c>.
 </item>
 <item>
 <c>Item=stats, Value=tuple()</c>
-- 
2.16.4

Places

File 0579-stdlib-Clarify-docs-for-ets-info-_-safe_fixed.patch of Package erlang

Places