[tor-commits] [tor/master] man page: FetchUselessDescriptors stops tor going idle

[nickm at torproject.org]

commit 9b1d5e8826e93f5d45a9d1ea7b7223fcfee2e484
Author: teor <teor2345 at gmail.com>
Date:   Wed May 2 10:46:00 2018 +1000

    man page: FetchUselessDescriptors stops tor going idle
    
    Also explain how FetchUselessDescriptors and UseMicrodescriptors are
    different.
    
    Closes 25998.
---
 doc/tor.1.txt | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index dd9f9cefa..2fc5c413c 100644
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -543,10 +543,13 @@ GENERAL OPTIONS
     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
+    certificates it does not trust. Tor stops fetching descriptors if it
+    hasn't built any circuits lately: this option makes Tor keep fetching
+    descriptors, even when idle. 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)
+    all documents, **UseMicrodescriptors 0** fetches full descriptors and uses
+    them to build circuits. (Default: 0)
 
 [[HTTPProxy]] **HTTPProxy** __host__[:__port__]::
     Tor will make all its directory requests through this host:port (or host:80