aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAnders Svensson <anders@erlang.org>2012-07-11 02:29:45 +0200
committerAnders Svensson <anders@erlang.org>2012-08-29 18:20:21 +0200
commit5a5b1d91c8cc913c6d049e113ceedc4746d2ba8e (patch)
treeecdeee04775f272699ccd0e948a7bdb269047933
parent6c84fcf954bfb9f14121e8e5a6f9e7611be63d93 (diff)
downloadotp-5a5b1d91c8cc913c6d049e113ceedc4746d2ba8e.tar.gz
otp-5a5b1d91c8cc913c6d049e113ceedc4746d2ba8e.tar.bz2
otp-5a5b1d91c8cc913c6d049e113ceedc4746d2ba8e.zip
Clarify documentation on application state
-rw-r--r--lib/diameter/doc/src/diameter_app.xml21
1 files changed, 15 insertions, 6 deletions
diff --git a/lib/diameter/doc/src/diameter_app.xml b/lib/diameter/doc/src/diameter_app.xml
index a9ae0ebbec..a786443fa1 100644
--- a/lib/diameter/doc/src/diameter_app.xml
+++ b/lib/diameter/doc/src/diameter_app.xml
@@ -257,12 +257,8 @@ call to <seealso marker="#peer_up">peer_up/3</seealso>.</p>
<p>
Invoked as a consequence of a call to <seealso
marker="diameter#call">diameter:call/4</seealso> to select a destination
-peer for an outgoing request, the return value indicating the selected peer.
-A new application state can also be returned but only if the Diameter
-application in question was
-configured with the option <c>call_mutates_state</c> set to
-<c>true</c>, as documented for <seealso
-marker="diameter#start_service">diameter:start_service/2</seealso>.</p>
+peer for an outgoing request, the return value indicating the selected
+peer.</p>
<p>
The candidate peers list will only include those
@@ -301,6 +297,19 @@ marker="#pick_peer">pick_peer/4</seealso> will be, since a
retransmission to an alternate peer is abandoned if an answer is
received from a previously selected peer.</p>
+<note>
+<p>
+<c>{Peer, NewState}</c> and its equivalents can only be returned if
+the Diameter application in question was
+configured with the option <c>{call_mutates_state, true}</c>,
+as documented for <seealso
+marker="diameter#start_service">diameter:start_service/2</seealso>.
+Otherwise, the <c>State</c> argument is always
+the intial value as configured on the application, not any subsequent
+value returned by a <seealso marker="#peer_up">peer_up/3</seealso>
+or <seealso marker="#peer_down">peer_down/3</seealso> callback.</p>
+</note>
+
<marker id="prepare_request"/>
</desc>