[sr-dev] git:4.0: tm: added missing documentation for t_check_status()

[Daniel-Constantin Mierla]

Module: sip-router
Branch: 4.0
Commit: 07a8f0da3d8f3d1ec4b3e4e88db485e5015a31f2
URL:    http://git.sip-router.org/cgi-bin/gitweb.cgi/sip-router/?a=commit;h=07a8f0da3d8f3d1ec4b3e4e88db485e5015a31f2

Author: Daniel-Constantin Mierla <miconda at gmail.com>
Committer: Daniel-Constantin Mierla <miconda at gmail.com>
Date:   Sat Sep 14 09:46:23 2013 +0200

tm: added missing documentation for t_check_status()

(cherry picked from commit f328b864418020b1e166b13804fe173110500d75)

Conflicts:
	modules/tm/doc/functions.xml

---

 modules/tm/doc/functions.xml |   42 +++++++++++++++++++++++++++++++++++++++++-
 1 files changed, 41 insertions(+), 1 deletions(-)

diff --git a/modules/tm/doc/functions.xml b/modules/tm/doc/functions.xml
index 9d67d8f..a5ce5a0 100644
--- a/modules/tm/doc/functions.xml
+++ b/modules/tm/doc/functions.xml
@@ -1247,7 +1247,47 @@ if (!t_next_contact_flows())
 		</example>
 	</section>
 
-	<section id="t_check_trans">
+	<section id="tm.f.t_check_status">
+		<title>
+		<function moreinfo="none">t_check_status(re)</function>
+		</title>
+		<para>
+		Returns true if the regular expresion <quote>re</quote> match the
+		reply code of the response message as follows:
+		<itemizedlist>
+		<listitem>
+			<para><emphasis>in routing block</emphasis> - the code of the
+			last sent reply.
+			</para>
+		</listitem>
+		<listitem>
+			<para><emphasis>in on_reply block</emphasis> - the code of the
+			current received reply.
+			</para>
+		</listitem>
+		<listitem>
+			<para><emphasis>in on_failure block</emphasis> - the code of the
+			selected negative final reply.
+			</para>
+		</listitem>
+		</itemizedlist>
+		</para>
+		<para>
+		This function can be used from ANY_ROUTE .
+		</para>
+		<example>
+		<title><function>t_check_status</function> usage</title>
+		<programlisting format="linespecific">
+...
+if (t_check_status("(487)|(408)")) {
+    log("487 or 408 negative reply\n");
+}
+...
+</programlisting>
+		</example>
+	</section>
+
+	<section id="tm.f.t_check_trans">
 	<title>
 		<function>t_check_trans()</function>
 	</title>