From: Travis Cross <tc@traviscross.com>
Date: Mon, 26 May 2014 14:52:04 +0000 (+0000)
Subject: mod_fifo: Document fifo_queue_pop_nameval()
X-Git-Tag: v1.4.5~2^2~14^2~26
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b914c2374dbff745c814559f78e9cab85dd1d93d;p=thirdparty%2Ffreeswitch.git

mod_fifo: Document fifo_queue_pop_nameval()
---

diff --git a/src/mod/applications/mod_fifo/mod_fifo.c b/src/mod/applications/mod_fifo/mod_fifo.c
index 1cf1d0cf9e..ba05976f2e 100644
--- a/src/mod/applications/mod_fifo/mod_fifo.c
+++ b/src/mod/applications/mod_fifo/mod_fifo.c
@@ -245,7 +245,16 @@ static switch_status_t fifo_queue_pop(fifo_queue_t *queue, switch_event_t **pop,
 	return SWITCH_STATUS_SUCCESS;
 }
 
-
+/*! \brief Remove matching event from queue
+ *
+ * Each event in the queue will be checked to see whether it has a
+ * header equal to name whose value is equal to val.  If it does, that
+ * event will be returned unless the event is for an outbound caller.
+ * If name starts with '+' or remove == 2 then forcing is enabled and
+ * the event will be returned in any case.  If remove > 0 then the
+ * returned event will be removed from the queue and the remaining
+ * elements shifted to make them contiguous.
+ */
 static switch_status_t fifo_queue_pop_nameval(fifo_queue_t *queue, const char *name, const char *val, switch_event_t **pop, int remove)
 {
 	int i, j, force = 0;