aboutsummaryrefslogtreecommitdiffstats
path: root/lib/kernel/doc/src/global.xml
diff options
context:
space:
mode:
authorBjörn Gustavsson <[email protected]>2012-09-19 12:09:22 +0200
committerBjörn Gustavsson <[email protected]>2012-09-19 12:09:22 +0200
commitc24f87e19cc01437c3c7b84e9c3fbeceb8c3b736 (patch)
tree46763502c6545056dddceff59de1c1fbace09384 /lib/kernel/doc/src/global.xml
parentb58ce62a0cf296ca8cd8cd77b053bc70ecf28758 (diff)
parent9d1203d2ad5904529754e5e889fe37f8d229ad4c (diff)
downloadotp-c24f87e19cc01437c3c7b84e9c3fbeceb8c3b736.tar.gz
otp-c24f87e19cc01437c3c7b84e9c3fbeceb8c3b736.tar.bz2
otp-c24f87e19cc01437c3c7b84e9c3fbeceb8c3b736.zip
Merge branch 'bjorn/kernel/global-resolve-function-fix/OTP-10419'
* bjorn/kernel/global-resolve-function-fix/OTP-10419: global: Allow "tuple funs" as resolve functions
Diffstat (limited to 'lib/kernel/doc/src/global.xml')
-rw-r--r--lib/kernel/doc/src/global.xml12
1 files changed, 11 insertions, 1 deletions
diff --git a/lib/kernel/doc/src/global.xml b/lib/kernel/doc/src/global.xml
index 304a9b1d88..9c50049503 100644
--- a/lib/kernel/doc/src/global.xml
+++ b/lib/kernel/doc/src/global.xml
@@ -163,7 +163,8 @@
<fsummary>Globally register a name for a pid</fsummary>
<type name="method"/>
<type_desc name="method">{<c>Module</c>, <c>Function</c>}
- is also allowed
+ is currently also allowed for backward compatibility, but its use is
+ deprecated
</type_desc>
<desc>
<p>Globally associates the name <c><anno>Name</anno></c> with a pid, that is,
@@ -180,6 +181,15 @@
unregistered. This function is called once for each name
clash.</p>
+ <warning>
+ <p>If you plan to change code without restarting your system,
+ you must use an external fun (<c>fun Module:Function/Arity</c>)
+ as the <c><anno>Resolve</anno></c> function; if you use a
+ local fun you can never replace the code for the module that
+ the fun belongs to.
+ </p>
+ </warning>
+
<p>There are three pre-defined resolve functions:
<c>random_exit_name/3</c>, <c>random_notify_name/3</c>, and
<c>notify_all_name/3</c>. If no <c><anno>Resolve</anno></c> function is