[tor-bugs] #12205 [Tor]: Document magic numbers at entry_is_time_to_retry()

[Tor Bug Tracker & Wiki]

#12205: Document magic numbers at entry_is_time_to_retry()
-------------------------+--------------------------------
     Reporter:  asn      |      Owner:
         Type:  defect   |     Status:  new
     Priority:  trivial  |  Milestone:  Tor: 0.2.6.x-final
    Component:  Tor      |    Version:
   Resolution:           |   Keywords:  tor-guard
Actual Points:           |  Parent ID:
       Points:           |
-------------------------+--------------------------------
Changes (by asn):

 * priority:  minor => trivial


Comment:

 FWIW, this is actually documented in `path-spec.txt`:
 {{{
   If Tor fails to connect to an otherwise usable guard, it retries
   periodically: every hour for six hours, every 4 hours for 3 days, every
   18 hours for a week, and every 36 hours thereafter.  Additionally, Tor
   retries unreachable guards the first time it adds a new guard to the
 list,
   since it is possible that the old guards were only marked as unreachable
   because the network was unreachable or down.
 }}}

 Still, it might be worth mentioning this in the code.

--
Ticket URL: <https://trac.torproject.org/projects/tor/ticket/12205#comment:2>
Tor Bug Tracker & Wiki <https://trac.torproject.org/>
The Tor Project: anonymity online