From: Matthew Finkel <matthew.finkel@gmail.com>
Date: Thu, 2 Aug 2012 20:15:23 +0000 (-0400)
Subject: Updated docs for new connections.
X-Git-Tag: tor-0.2.4.1-alpha~70
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b50eb14bbf4da25ef43efe91851b239a04383c8e;p=thirdparty%2Ftor.git

Updated docs for new connections.
---

diff --git a/src/or/connection.c b/src/or/connection.c
index 2520c54ce8..a1d5354eb5 100644
--- a/src/or/connection.c
+++ b/src/or/connection.c
@@ -239,7 +239,16 @@ dir_connection_new(int socket_family)
 }
 
 /** Allocate and return a new or_connection_t, initialized as by
- * connection_init(). */
+ * connection_init(). 
+ *
+ * Set timestamp_last_added_nonpadding to now.
+ *
+ * Assign a pseudorandom next_circ_id between 0 and 2**15.
+ *
+ * Initialize active_circuit_pqueue.
+ *
+ * Set active_circuit_pqueue_last_recalibrated to current cell_ewma tick.
+ */
 or_connection_t *
 or_connection_new(int socket_family)
 {
@@ -257,7 +266,10 @@ or_connection_new(int socket_family)
 }
 
 /** Allocate and return a new entry_connection_t, initialized as by
- * connection_init(). */
+ * connection_init().
+ *
+ * Allocate space to store the socks_request.
+ */
 entry_connection_t *
 entry_connection_new(int type, int socket_family)
 {
@@ -339,14 +351,11 @@ connection_new(int type, int socket_family)
 /** Initializes conn. (you must call connection_add() to link it into the main
  * array).
  *
+ * Set conn-\>magic to the correct value.
+ *
  * Set conn-\>type to <b>type</b>. Set conn-\>s and conn-\>conn_array_index to
  * -1 to signify they are not yet assigned.
  *
- * If conn is not a listener type, allocate buffers for it. If it's
- * an AP type, allocate space to store the socks_request.
- *
- * Assign a pseudorandom next_circ_id between 0 and 2**15.
- *
  * Initialize conn's timestamps to now.
  */
 static void