[or-cvs] r17890: {tor} Document some variables used for generating statistics on us (tor/trunk/src/or)

[kloesing@xxxxxxxx]

Author: kloesing
Date: 2009-01-04 14:59:35 -0500 (Sun, 04 Jan 2009)
New Revision: 17890

Modified:
   tor/trunk/src/or/rephist.c
Log:
Document some variables used for generating statistics on usage of V0 hidden service directory authorities.

Modified: tor/trunk/src/or/rephist.c
===================================================================
--- tor/trunk/src/or/rephist.c	2009-01-04 19:48:34 UTC (rev 17889)
+++ tor/trunk/src/or/rephist.c	2009-01-04 19:59:35 UTC (rev 17890)
@@ -1915,15 +1915,24 @@
 
 /** Usage statistics for the current observation period. */
 static hs_usage_current_observation_period_t *current_period = NULL;
-/* DOCDOC publish_total */
+
+/* Total number of descriptor publish requests in the current observation
+ * period. */
 static hs_usage_service_related_observation_t *publish_total = NULL;
-/* DOCDOC publish_novel */
+
+/* Number of descriptor publish requests for services that have not been
+ * seen before in the current observation period. */
 static hs_usage_service_related_observation_t *publish_novel = NULL;
-/* DOCDOC fetch_total */
+
+/* Total number of descriptor fetch requests in the current observation
+ * period. */
 static hs_usage_service_related_observation_t *fetch_total = NULL;
-/* DOCDOC fetch_successful */
+
+/* Number of successful descriptor fetch requests in the current
+ * observation period. */
 static hs_usage_service_related_observation_t *fetch_successful = NULL;
-/* DOCDOC descs */
+
+/* Number of descriptors stored in the current observation period. */
 static hs_usage_general_period_related_observations_t *descs = NULL;
 
 /** Creates an empty ordered list element. */