Improve docstring for r_object

Author: rocky

xdis/unmarshal.py

@@ -213,9 +213,16 @@ def r_ref(self, obj, save_ref):
         return obj
 
     # In marshal.c this is one big case statement
+    # FIXME: remove bytes_fo_s parameter.
+    # Now that we have git branches, isolated by Python version.
+    # This is only needed in the Python 2.4 - 2.7 code branch.
     def r_object(self, bytes_for_s: bool = False):
         """
-        In Python3 strings are bytes type
+        Main object unmarshalling read routine.  Reads from self.fp
+        the next byte which is a key in UNMARSHAL_DISPATCH_TABLE
+        defined above when the high-order bit, FLAG_REF is not set.
+        FLAG_REF indicates whether to save the resulting object in
+        our internal object cache.
         """
         byte1 = ord(self.fp.read(1))