[tor-commits] [tor/master] Man page update and changes file for 20667

[nickm at torproject.org]

commit 24e293c3c6228c0038360471e9bbd4b4b4daed05
Author: teor <teor2345 at gmail.com>
Date:   Wed Nov 30 11:18:38 2016 +1100

    Man page update and changes file for 20667
---
 changes/bug20667 |  5 +++++
 doc/tor.1.txt    | 12 +++++++-----
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/changes/bug20667 b/changes/bug20667
new file mode 100644
index 0000000..93b293a
--- /dev/null
+++ b/changes/bug20667
@@ -0,0 +1,5 @@
+  o Minor bugfixes (directory downloads):
+    - Download all consensus flavors, descriptors, and authority certificates
+      when FetchUselessDescriptors is set, regardless of whether tor is a
+      directory cache or not.
+      Fixes bug 20667; bugfix on all recent tor versions.
diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index 670c75d..aa3859e 100644
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -504,11 +504,13 @@ GENERAL OPTIONS
     (Default: 1)
 
 [[FetchUselessDescriptors]] **FetchUselessDescriptors** **0**|**1**::
-    If set to 1, Tor will fetch every non-obsolete descriptor from the
-    authorities that it hears about. Otherwise, it will avoid fetching useless
-    descriptors, for example for routers that are not running. This option is
-    useful if you're using the contributed "exitlist" script to enumerate Tor
-    nodes that exit to certain addresses. (Default: 0)
+    If set to 1, Tor will fetch every consensus flavor, descriptor, and
+    certificate that it hears about. Otherwise, it will avoid fetching useless
+    descriptors: flavors that it is not using to build circuits, and authority
+    certificates it does not trust. This option is useful if you're using a
+    tor client with an external parser that uses a full consensus.
+    This option fetches all documents, **DirCache** fetches and serves
+    all documents. (Default: 0)
 
 [[HTTPProxy]] **HTTPProxy** __host__[:__port__]::
     Tor will make all its directory requests through this host:port (or host:80