Document why membercount can not simply be replaced by ao2_container_count()

git-svn-id: https://origsvn.digium.com/svn/asterisk/branches/1.4@82236 65c4cc65-6c06-0410-ace0-fbb531ad65f3

diff --git a/apps/app_queue.c b/apps/app_queue.c
index 710f3520bf1431f8bdfb39766a85e1c77f604f64..683ee75a7f7efc0c83036763764d914ca315b5ad 100644 (file)
--- a/apps/app_queue.c
+++ b/apps/app_queue.c
@@ -397,7 +397,12 @@ struct call_queue {
        int autofill;                       /*!< Ignore the head call status and ring an available agent */
        
        struct ao2_container *members;             /*!< Head of the list of members */
-       int membercount;                                        /*!< Number of members in queue */
+       /*! 
+        * \brief Number of members _logged in_
+        * \note There will be members in the members container that are not logged
+        *       in, so this can not simply be replaced with ao2_container_count(). 
+        */
+       int membercount;
        struct queue_ent *head;             /*!< Head of the list of callers */
        AST_LIST_ENTRY(call_queue) list;    /*!< Next call queue */
 };