File 0455-Add-documentation-about-proxy-and-resend-return-valu.patch of Package erlang

From 6a96fec133a913a84b4005b629429c4db4e1497d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C5=82=20W=C4=85sowski?= <michal@erlang.org>
Date: Mon, 15 Sep 2025 13:51:23 +0200
Subject: [PATCH] Add documentation about proxy and resend return values

---
 lib/diameter/src/base/diameter_app.erl | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/lib/diameter/src/base/diameter_app.erl b/lib/diameter/src/base/diameter_app.erl
index eb3a091f7b..0e3ccc3ca6 100644
--- a/lib/diameter/src/base/diameter_app.erl
+++ b/lib/diameter/src/base/diameter_app.erl
@@ -177,6 +177,15 @@ The semantics of each of the possible return values are as follows.
   return value (for example, from a `c:handle_error/4` callback) causes the
   request to be answered with 3002 (DIAMETER_UNABLE_TO_DELIVER).
 
+  This return value can be used only in relay applications
+  (Application identifier = 0xFFFFFFFF).
+
+- **`{proxy, Opts}`** - Like `relay` but can only be used in applications other
+  then the relay application.
+
+- **`{resend, Opts}`** - Neutral alternative to `relay` and `proxy` that can be
+  used in any application.
+
 - **`discard`** - Discard the request. No answer message is sent to the peer.
 
 - **`{eval, Action, PostF}`** - Handle the request as if `Action` has been
-- 
2.51.0