move mcall docs to correct place, and improve them

1 files changed, 8 insertions, 5 deletions

diff --git a/src/gen_server2.erl b/src/gen_server2.erl
index 99cbd3cbdb..43231c3141 100644
--- a/src/gen_server2.erl
+++ b/src/gen_server2.erl
@@ -42,11 +42,6 @@
 %% this timeout has occurred, hibernation will occur as normal. Upon
 %% awaking, a new current timeout value will be calculated.
 %%
-%% 7) an mcall/1 function has been added, to facilitate running
-%% gen_server:call/3 in parallel to multiple servers and awaiting all
-%% the results. This differs from multi_call in that it can operate
-%% on targets on any combination of nodes (or just the local node).
-%%
 %% The purpose is that the gen_server2 takes care of adjusting the
 %% current timeout value such that the process will increase the
 %% timeout value repeatedly if it is unable to sleep for the
@@ -86,6 +81,14 @@
 %% process as sys:get_status/1 would). Pass through a function which
 %% can be invoked on the state, get back the result. The state is not
 %% modified.
+%%
+%% 10) an mcall/1 function has been added, to facilitate running
+%% gen_server:call/3 in parallel to multiple servers and awaiting all
+%% the results. Unlike multi_call, which operates on same-named
+%% processes residing on a list of nodes, it operates on a list of
+%% processes that can be supplied as pid, global name, local name, or
+%% local-name-on-a-particular-node, just as call/3 does.
+%%
 
 %% All modifications are (C) 2009-2013 GoPivotal, Inc.