Improve Alternate*Authority docs. Bug 6387.

diff --git a/changes/bug6387 b/changes/bug6387
new file mode 100644 (file)
index 0000000..73fc4f7
--- /dev/null
+++ b/changes/bug6387
@@ -0,0 +1,3 @@
+  o Documentation:
+    - Clarify the documentation for the Alternate*Authority options.
+      Fixes bug 6387.

diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index a4a0ed7da9fb3a384c904404dccf6f1e41831030..78c34874c538bea8811ecf153b328096e74fdb0f 100644 (file)
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -319,11 +319,14 @@ GENERAL OPTIONS
 **AlternateHSAuthority** [__nickname__] [**flags**] __address__:__port__ __fingerprint__ +
 
 **AlternateBridgeAuthority** [__nickname__] [**flags**] __address__:__port__ __ fingerprint__::
-    As DirServer, but replaces less of the default directory authorities. Using
+    These options behave as DirServer, but they replace fewer of the
+    default directory authorities. Using
     AlternateDirAuthority replaces the default Tor directory authorities, but
-    leaves the hidden service authorities and bridge authorities in place.
-    Similarly, Using AlternateHSAuthority replaces the default hidden service
-    authorities, but not the directory or bridge authorities.
+    leaves the default hidden service authorities and bridge authorities in
+    place.  Similarly, AlternateHSAuthority replaces the default hidden
+    service authorities, but not the directory or bridge authorities; and
+    AlternateBridgeAuthority replaces the default bridge authority,
+    but leaves the directory and hidden service authorities alone.
 
 **DisableAllSwap** **0**|**1**::
     If set to 1, Tor will attempt to lock all current and future memory pages,