Revise MapAddress manpage

make the asciidoc work; make the example more generic; tighten the
prose a little; be more specific that *.example.com matches
example.com; simplify an example.

1 files changed, 13 insertions, 14 deletions

diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index eb794527c..76791269c 100644
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -655,18 +655,19 @@ The following options are useful only for clients (that is, if
     5050, 5190, 5222, 5223, 6523, 6667, 6697, 8300)
 
 **MapAddress** __address__ __newaddress__::
-    When a request for address arrives to Tor, it will rewrite it to newaddress
+    When a request for address arrives to Tor, it will transform to newaddress
     before processing it. For example, if you always want connections to
-    www.indymedia.org to exit via __torserver__ (where __torserver__ is the
-    nickname of the server), use MapAddress www.indymedia.org
-    www.indymedia.org.torserver.exit. If the value is prepended with a
-    '*.', it is treated as matching an entire domain. For example, if you
-    always want connections to  any sub-domain of indymedia.org to exit via
+    www.example.com to exit via __torserver__ (where __torserver__ is the
+    nickname of the server), use "MapAddress www.example.com
+    www.example.com.torserver.exit". If the value is prefixed with a
+    "\*.", matches an entire domain. For example, if you
+    always want connections to example.com and any if its subdomains
+    to exit via
     __torserver__ (where __torserver__ is the nickname of the server), use
-    MapAddress *.indymedia.org *.indymedia.org.torserver.exit. (Note the
-    leading '*.' in each part of the directive.) You can also redirect all
-    subdomains of a domain to a single address. For example, MapAddress
-    *.indymedia.org www.indymedia.org. +
+    "MapAddress \*.example.com \*.example.com.torserver.exit". (Note the
+    leading "*." in each part of the directive.) You can also redirect all
+    subdomains of a domain to a single address. For example, "MapAddress
+    *.example.com www.example.com". +
  +
     NOTES:
 
@@ -681,18 +682,16 @@ The following options are useful only for clients (that is, if
     if you have the following in your torrc, www.torproject.org will map to
     2.2.2.2:
 
-      MapAddress www.torproject.org 3.3.3.3
-      MapAddress 1.1.1.1 4.4.4.4
       MapAddress 1.1.1.1 2.2.2.2
       MapAddress www.torproject.org 1.1.1.1
 
     3. The following MapAddress expression is invalid (and will be
-    ignored) because you cannot map from a specific address to a wildcarded
+    ignored) because you cannot map from a specific address to a wildcard
     address:
 
       MapAddress www.torproject.org *.torproject.org.torserver.exit
 
-    4. Using a wildcard as a regular expression (e.g. *ample.com) is
+    4. Using a wildcard to match only part of a string (as in *ample.com) is
     also invalid.
 
 **NewCircuitPeriod** __NUM__::