X-Git-Url: http://git.pk910.de/?a=blobdiff_plain;f=include%2Fquerycmds.h;h=6f96c54757e4a54e45b28b9654e81a0b0db04d6b;hb=refs%2Fheads%2Fupstream-ssl;hp=3ebdaa568f570b36b230b7d2d731543cec4c69b9;hpb=56f512008e81aeae915b2b7f6bcdd54b549188d3;p=ircu2.10.12-pk.git

diff --git a/include/querycmds.h b/include/querycmds.h
index 3ebdaa5..6f96c54 100644
--- a/include/querycmds.h
+++ b/include/querycmds.h
@@ -1,7 +1,6 @@
-/*
- * querycmds.h
- *
- * $Id$
+/** @file
+ * @brief Interface and declarations for client counting functions.
+ * @version $Id$
  */
 #ifndef INCLUDED_querycmds_h
 #define INCLUDED_querycmds_h
@@ -16,22 +15,23 @@ struct Client;
  * Structs
  */
 
+/** Counts types of clients, servers, etc.\ on the network. */
 struct UserStatistics {
   /* Local connections: */
-  unsigned int unknowns;  /* IsUnknown() || IsConnecting() || IsHandshake() */
-  unsigned int local_servers;   /* IsServer() && MyConnect() */
-  unsigned int local_clients;   /* IsUser() && MyConnect() */
+  unsigned int unknowns;  /**< Clients of types: unknown, connecting, handshake */
+  unsigned int local_servers;   /**< Directly connected servers. */
+  unsigned int local_clients;   /**< Directly connected clients. */
 
   /* Global counts: */
-  unsigned int servers;         /* IsServer() || IsMe() */
-  unsigned int clients;         /* IsUser() */
+  unsigned int servers;         /**< Known servers, including #me. */
+  unsigned int clients;         /**< Registered users. */
 
   /* Global user mode changes: */
-  unsigned int inv_clients;     /* IsUser() && IsInvisible() */
-  unsigned int opers;           /* IsUser() && IsOper() */
+  unsigned int inv_clients;     /**< Registered invisible users. */
+  unsigned int opers;           /**< Registered IRC operators. */
 
   /* Misc: */
-  unsigned int channels;
+  unsigned int channels;        /**< Existing channels. */
 };
 
 extern struct UserStatistics UserStats;
@@ -41,9 +41,12 @@ extern struct UserStatistics UserStats;
  */
 
 /* Macros for remote connections: */
+/** Count \a cptr as a new remote client. */
 #define Count_newremoteclient(UserStats, cptr)  (++UserStats.clients, ++(cli_serv(cptr)->clients))
+/** Count a new remote server. */
 #define Count_newremoteserver(UserStats)  (++UserStats.servers)
 
+/** Count a remote user quit. */
 #define Count_remoteclientquits(UserStats,cptr)                \
   do { \
     --UserStats.clients; \
@@ -51,10 +54,13 @@ extern struct UserStatistics UserStats;
       --(cli_serv(cli_user(cptr)->server)->clients); \
   } while (0)
 
+/** Count a remote server quit. */
 #define Count_remoteserverquits(UserStats)      (--UserStats.servers)
 
 /* Macros for local connections: */
+/** Count a new local unknown connection. */
 #define Count_newunknown(UserStats)                     (++UserStats.unknowns)
+/** Update counters when \a cptr goes from unknown to registered. */
 #define Count_unknownbecomesclient(cptr, UserStats) \
   do { \
     --UserStats.unknowns; ++UserStats.local_clients; ++UserStats.clients; \
@@ -70,7 +76,9 @@ extern struct UserStatistics UserStats;
             max_connection_count, max_client_count); \
     } \
   } while(0)
+/** Update counters when \a cptr goes from unknown to server. */
 #define Count_unknownbecomesserver(UserStats)   do { --UserStats.unknowns; ++UserStats.local_servers; ++UserStats.servers; } while(0)
+/** Update counters when \a cptr (a local user) disconnects. */
 #define Count_clientdisconnects(cptr, UserStats) \
   do \
   { \
@@ -78,7 +86,9 @@ extern struct UserStatistics UserStats;
     if (match(feature_str(FEAT_DOMAINNAME), cli_sockhost(cptr)) == 0) \
       --current_load.local_count; \
   } while(0)
+/** Update counters when a local server disconnects. */
 #define Count_serverdisconnects(UserStats)              do { --UserStats.local_servers; --UserStats.servers; } while(0)
+/** Update counters when an unknown client disconnects. */
 #define Count_unknowndisconnects(UserStats)             (--UserStats.unknowns)
 
 /*