From: Travis Cross <tc@traviscross.com>
Date: Mon, 26 May 2014 16:02:17 +0000 (+0000)
Subject: mod_fifo: Document the consumer DTMF callback
X-Git-Tag: v1.4.5~2^2~14^2~22
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=27b3ddcc9f3dc7c92ef26f754d9aa630d61e97fb;p=thirdparty%2Ffreeswitch.git

mod_fifo: Document the consumer DTMF callback
---

diff --git a/src/mod/applications/mod_fifo/mod_fifo.c b/src/mod/applications/mod_fifo/mod_fifo.c
index 8f78c85711..31bcbec9bc 100644
--- a/src/mod/applications/mod_fifo/mod_fifo.c
+++ b/src/mod/applications/mod_fifo/mod_fifo.c
@@ -457,6 +457,19 @@ static switch_bool_t match_key(const char *caller_exit_key, char key)
 	return SWITCH_FALSE;
 }
 
+/*! \brief Handler for consumer DTMF
+ *
+ * When `fifo_consumer_exit_key` is pressed by the consumer we hangup
+ * on the caller (unless we've put the caller on hold).  The default
+ * exit key is '*'.
+ *
+ * When the consumer presses '0' we put both legs on hold and play
+ * hold music as follows.  To the caller we play `fifo_music` or the
+ * default hold music for the channel.  To the consumer we play
+ * `fifo_hold_music`, or `fifo_music`, or the default hold music for
+ * the channel.  The consumer can press '0' again to pick up the
+ * caller from hold.
+ */
 static switch_status_t on_dtmf(switch_core_session_t *session, void *input, switch_input_type_t itype, void *buf, unsigned int buflen)
 {
 	switch_core_session_t *bleg = (switch_core_session_t *) buf;