From 792f81921209bc44cb032dd768453fd31e0a6d54 Mon Sep 17 00:00:00 2001
From: Nick Mathewson <nickm@torproject.org>
Date: Wed, 24 Jan 2007 00:43:52 +0000
Subject:  r11285@catbus:  nickm | 2007-01-23 19:43:50 -0500  More
 documentation. (Again, trying to see whether I have buildbot working).

svn:r9394
---
 src/or/circuitbuild.c | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/or/circuitbuild.c b/src/or/circuitbuild.c
index 579b202f9..73960fec4 100644
--- a/src/or/circuitbuild.c
+++ b/src/or/circuitbuild.c
@@ -1921,10 +1921,18 @@ log_entry_guards(int severity)
   tor_free(s);
 }
 
-/** DOCDOC */
+/** Called when one or more guards that we would previously have used for some
+ * purpose are no longer in use because a higher-priority guard has become
+ * useable again. */
 static void
 control_event_guard_deferred(void)
 {
+  /* XXXX We don't actually have a good way to figure out _how many_ entries
+   * are live for some purpose.  We need an entry_is_even_slightly_live()
+   * function for this to work right.  NumEntryGuards isn't reliable: if we
+   * need guards with weird properties, we can have more than that number
+   * live.
+   **/
 #if 0
   int n = 0;
   or_options_t *options = get_options();
-- 
cgit v1.2.3