[tor-commits] [tor/master] Improve documentation for connection_dirserv_flushed_some.

[nickm at torproject.org]

commit 436b975e213aaf0abe12e0fe035b7b83bcb2198a
Author: Nick Mathewson <nickm at torproject.org>
Date:   Fri Mar 17 11:31:21 2017 -0400

    Improve documentation for connection_dirserv_flushed_some.
---
 src/or/dirserv.c | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/src/or/dirserv.c b/src/or/dirserv.c
index bf01dce..33d2561 100644
--- a/src/or/dirserv.c
+++ b/src/or/dirserv.c
@@ -3740,8 +3740,14 @@ get_signed_descriptor_by_fp(const uint8_t *fp, int extrainfo)
  * below this threshold. */
 #define DIRSERV_BUFFER_MIN 16384
 
-/** Called whenever we have flushed some directory data in state
- * SERVER_WRITING. */
+/**
+ * Called whenever we have flushed some directory data in state
+ * SERVER_WRITING, or whenever we want to fill the buffer with initial
+ * directory data (so that subsequent writes will occur, and trigger this
+ * function again.)
+ *
+ * Return 0 on success, and -1 on failure.
+ */
 int
 connection_dirserv_flushed_some(dir_connection_t *conn)
 {