[tor-commits] [tor/master] Better comments on exponential-backoff related members of download_status_t

[nickm at torproject.org]

commit 5a4ed29f01479f0f5c0141ec09cf5ff2c1e15a9b
Author: Andrea Shepard <andrea at torproject.org>
Date:   Sat Jun 18 19:05:46 2016 +0000

    Better comments on exponential-backoff related members of download_status_t
---
 src/or/or.h | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/or/or.h b/src/or/or.h
index efe5680..ea38022 100644
--- a/src/or/or.h
+++ b/src/or/or.h
@@ -2047,8 +2047,10 @@ typedef struct download_status_t {
                                         * exponential backoffs? */
   uint8_t last_backoff_position; /**< number of attempts/failures, depending
                                   * on increment_on, when we last recalculated
-                                  * the delay. */
-  int last_delay_used; /**< last delay used for random exponential backoff */
+                                  * the delay.  Only updated if backoff
+                                  * == 1. */
+  int last_delay_used; /**< last delay used for random exponential backoff;
+                        * only updated if backoff == 1 */
 } download_status_t;
 
 /** If n_download_failures is this high, the download can never happen. */