From 609af664ac5e68b4641ef25d05ab992e60f72b25 Mon Sep 17 00:00:00 2001
From: Roger Dingledine <arma@torproject.org>
Date: Fri, 30 Sep 2005 00:43:40 +0000
Subject: [PATCH] resolve a docdoc

svn:r5157
---
 src/or/router.c | 12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/src/or/router.c b/src/or/router.c
index 8a741f5952..29803b2c91 100644
--- a/src/or/router.c
+++ b/src/or/router.c
@@ -432,7 +432,17 @@ decide_to_advertise_dirport(or_options_t *options, routerinfo_t *router)
   return router->dir_port;
 }
 
-/**DOCDOC*/
+/** Some time has passed, or we just got new directory information.
+ * See if we currently believe our ORPort or DirPort to be
+ * unreachable. If so, launch a new test for it.
+ *
+ * For ORPort, we simply try making a circuit that ends at ourselves.
+ * Success is noticed in onionskin_answer().
+ *
+ * For DirPort, we make a connection via Tor to our DirPort and ask
+ * for our own server descriptor.
+ * Success is noticed in connection_dir_client_reached_eof().
+ */
 void
 consider_testing_reachability(void)
 {