From: Nick Mathewson <nickm@torproject.org>
Date: Fri, 8 Feb 2013 17:12:09 +0000 (-0500)
Subject: Add doxygen for bug8158 functions
X-Git-Tag: tor-0.2.4.11-alpha~47^2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c8f5f35d6237de0ecd5ddac0a9a4c84915cbe177;p=thirdparty%2Ftor.git

Add doxygen for bug8158 functions
---

diff --git a/src/or/dirvote.c b/src/or/dirvote.c
index c10a60fa71..66dc50debe 100644
--- a/src/or/dirvote.c
+++ b/src/or/dirvote.c
@@ -3664,6 +3664,8 @@ static const struct consensus_method_range_t {
   {-1, -1}
 };
 
+/** Helper type used when generating the microdescriptor lines in a directory
+ * vote. */
 typedef struct microdesc_vote_line_t {
   int low;
   int high;
@@ -3671,6 +3673,9 @@ typedef struct microdesc_vote_line_t {
   struct microdesc_vote_line_t *next;
 } microdesc_vote_line_t;
 
+/** Generate and return a linked list of all the lines that should appear to
+ * describe a router's microdescriptor versions in a directory vote.
+ * Add the generated microdescriptors to <b>microdescriptors_out</b>. */
 vote_microdesc_hash_t *
 dirvote_format_all_microdesc_vote_lines(const routerinfo_t *ri, time_t now,
                                         smartlist_t *microdescriptors_out)