[tor-commits] [stem/master] Notice that server descriptors are no longer available by default

[atagar at torproject.org]

commit d25f946d06a26e2ee0947eca5b1944f190e6299f
Author: Damian Johnson <atagar at torproject.org>
Date:   Sat Feb 23 12:16:32 2013 -0800

    Notice that server descriptors are no longer available by default
    
    As of Tor 0.2.3.25 relays stopped fetching server descriptors by default. This
    is an important thing to know since it makes get_server_descriptor() and
    get_server_descriptors() useless unless you set 'UseMicrodescriptors 0'.
    
    velope has been emphatically pointing out that we want to discourage stem
    developers from disabling microdescriptors so advising them against it.
---
 stem/control.py |   10 ++++++++++
 1 files changed, 10 insertions(+), 0 deletions(-)

diff --git a/stem/control.py b/stem/control.py
index 6b9a7ca..77e78c6 100644
--- a/stem/control.py
+++ b/stem/control.py
@@ -968,6 +968,11 @@ class Controller(BaseController):
     nickname. If the relay identifier could be either a fingerprint *or*
     nickname then it's queried as a fingerprint.
 
+    **As of Tor version 0.2.3.25 relays no longer get server descriptors by
+    default.** It's advised that you use microdescriptors instead, but if you
+    really need server descriptors then you can get them by setting
+    'UseMicrodescriptors 0'.
+
     :param str relay: fingerprint or nickname of the relay to be queried
     :param object default: response if the query fails
 
@@ -1002,6 +1007,11 @@ class Controller(BaseController):
     Provides an iterator for all of the server descriptors that tor presently
     knows about.
 
+    **As of Tor version 0.2.3.25 relays no longer get server descriptors by
+    default.** It's advised that you use microdescriptors instead, but if you
+    really need server descriptors then you can get them by setting
+    'UseMicrodescriptors 0'.
+
     :param list default: items to provide if the query fails
 
     :returns: iterates over