[tor-commits] [tor/master] Reword DESCRIPTION in tor.1.txt

[dgoulet at torproject.org]

commit 90ba8bae3f3cb026239d13579e54a0e7020ab846
Author: Taylor Yu <catalyst at torproject.org>
Date:   Thu Oct 24 15:15:31 2019 -0500

    Reword DESCRIPTION in tor.1.txt
    
    Reword the DESCRIPTION section of tor.1.txt.
    
    Based on a patch by Swati Thacker.  Part of ticket 32277.
---
 doc/tor.1.txt | 35 +++++++++++++++++++----------------
 1 file changed, 19 insertions(+), 16 deletions(-)

diff --git a/doc/tor.1.txt b/doc/tor.1.txt
index de01cefbf..fd09e30d6 100644
--- a/doc/tor.1.txt
+++ b/doc/tor.1.txt
@@ -18,22 +18,25 @@ SYNOPSIS
 
 DESCRIPTION
 -----------
-Tor is a connection-oriented anonymizing communication
-service. Users choose a source-routed path through a set of nodes, and
-negotiate a "virtual circuit" through the network, in which each node
-knows its predecessor and successor, but no others. Traffic flowing down
-the circuit is unwrapped by a symmetric key at each node, which reveals
-the downstream node. +
-
-Basically, Tor provides a distributed network of servers or relays ("onion routers").
-Users bounce their TCP streams -- web traffic, ftp, ssh, etc. -- around the
-network, and recipients, observers, and even the relays themselves have
-difficulty tracking the source of the stream.
-
-By default, **tor** will act as a client only.  To help the network
-by providing bandwidth as a relay, change the **ORPort** configuration
-option -- see below.  Please also consult the documentation on the Tor
-Project's website.
+
+Tor is a connection-oriented anonymizing communication service. Users
+choose a source-routed path through a set of nodes, and negotiate a
+"virtual circuit" through the network. Each node in a virtual circuit
+knows its predecessor and successor nodes, but no other nodes. Traffic
+flowing down the circuit is unwrapped by a symmetric key at each node,
+which reveals the downstream node. +
+
+Basically, Tor provides a distributed network of servers or relays
+("onion routers").  Users bounce their TCP streams, including web
+traffic, ftp, ssh, etc., around the network, so that recipients,
+observers, and even the relays themselves have difficulty tracking the
+source of the stream.
+
+[NOTE]
+By default, **tor** acts as a client only.  To help the network by
+providing bandwidth as a relay, change the **ORPort** configuration
+option as mentioned below.  Please also consult the documentation on
+the Tor Project's website.
 
 COMMAND-LINE OPTIONS
 --------------------