[tor-commits] [stem/master] Revert cell module hierarchy docs

[atagar at torproject.org]

commit 347120a44614437f8e1642dc81676760f877c8be
Author: Damian Johnson <atagar at torproject.org>
Date:   Sat Aug 25 13:45:47 2018 -0700

    Revert cell module hierarchy docs
    
    Dropping BaseRelayCell and RawRelayCell from the hierarchy (reintegrating 'em
    into the RelayCell). Due to the whitespace changes this occupies a sizable
    chunk of the merge diff.
---
 stem/client/cell.py | 39 ++++++++++++++++++---------------------
 1 file changed, 18 insertions(+), 21 deletions(-)

diff --git a/stem/client/cell.py b/stem/client/cell.py
index 3de1c731..aec868c4 100644
--- a/stem/client/cell.py
+++ b/stem/client/cell.py
@@ -12,27 +12,25 @@ Messages communicated over a Tor relay's ORPort.
 
   Cell - Base class for ORPort messages.
     |- CircuitCell - Circuit management.
-    |  |- CreateCell - Create a circuit.                                          (section 5.1)
-    |  |- CreatedCell - Acknowledge create.                                       (section 5.1)
-    |  |- BaseRelayCell - End-to-end data; abstract.                              (section 6.1)
-    |  |  +- RawRelayCell - End-to-end data. Payload not unpacked.                (section 5.5.2.1, 5.5.3)
-    |  |- RelayCell - End-to-end data.                                            (section 6.1)
-    |  |- DestroyCell - Stop using a circuit.                                     (section 5.4)
-    |  |- CreateFastCell - Create a circuit, no PK.                               (section 5.1)
-    |  |- CreatedFastCell - Circuit created, no PK.                               (section 5.1)
-    |  |- RelayEarlyCell - End-to-end data; limited.                              (section 5.6)
-    |  |- Create2Cell - Extended CREATE cell.                                     (section 5.1)
-    |  +- Created2Cell - Extended CREATED cell.                                   (section 5.1)
+    |  |- CreateCell - Create a circuit.              (section 5.1)
+    |  |- CreatedCell - Acknowledge create.           (section 5.1)
+    |  |- RelayCell - End-to-end data.                (section 6.1)
+    |  |- DestroyCell - Stop using a circuit.         (section 5.4)
+    |  |- CreateFastCell - Create a circuit, no PK.   (section 5.1)
+    |  |- CreatedFastCell - Circuit created, no PK.   (section 5.1)
+    |  |- RelayEarlyCell - End-to-end data; limited.  (section 5.6)
+    |  |- Create2Cell - Extended CREATE cell.         (section 5.1)
+    |  +- Created2Cell - Extended CREATED cell.       (section 5.1)
     |
-    |- PaddingCell - Padding negotiation.                                         (section 7.2)
-    |- VersionsCell - Negotiate proto version.                                    (section 4)
-    |- NetinfoCell - Time and address info.                                       (section 4.5)
-    |- PaddingNegotiateCell - Padding negotiation.                                (section 7.2)
-    |- VPaddingCell - Variable-length padding.                                    (section 7.2)
-    |- CertsCell - Relay certificates.                                            (section 4.2)
-    |- AuthChallengeCell - Challenge value.                                       (section 4.3)
-    |- AuthenticateCell - Client authentication.                                  (section 4.5)
-    |- AuthorizeCell - Client authorization.                                      (not yet used)
+    |- PaddingCell - Padding negotiation.             (section 7.2)
+    |- VersionsCell - Negotiate proto version.        (section 4)
+    |- NetinfoCell - Time and address info.           (section 4.5)
+    |- PaddingNegotiateCell - Padding negotiation.    (section 7.2)
+    |- VPaddingCell - Variable-length padding.        (section 7.2)
+    |- CertsCell - Relay certificates.                (section 4.2)
+    |- AuthChallengeCell - Challenge value.           (section 4.3)
+    |- AuthenticateCell - Client authentication.      (section 4.5)
+    |- AuthorizeCell - Client authorization.          (not yet used)
     |
     |- pack - encodes cell into bytes
     |- unpack - decodes series of cells
@@ -86,7 +84,6 @@ class Cell(object):
   The following cell types explicitly don't have *unused* content:
     * PaddingCell (we consider all content part of payload)
     * VersionsCell (all content is unpacked and treated as a version specification)
-    * BaseRelayCell (we don't parse cell beyond header/body)
     * VPaddingCell (we consider all content part of payload)
 
   :var bytes unused: unused filler that padded the cell to the expected size