reworded comments for _IRODS_VERSION

Author: d-w-moore

irods/message/__init__.py

@@ -185,16 +185,12 @@ def ET(xml_type=(), server_version=None):
 
 logger = logging.getLogger(__name__)
 
-# Advertised server version compatibility.  More recent servers are not guaranteed to work.
-# We avail ourselves of this macro in running tests to abort if the session has connected
-# to a server that is too new.
-
-# The symbol 'IRODS_VERSION' was for internal use in testing only, so it should be prefixed
-# with an underline.
-
+# The symbol _IRODS_VERSION is for internal use in testing only.  It indicates the current
+# server version for which PRC has maintained compatibility.  Attempting the unit tests with
+# more recent servers will fail by design.
 _IRODS_VERSION = (5, 0, 2, "d")
 
-# This is the older, now deprecated, symbol.
+# This is the older, now deprecated, version of the above symbol.
 _deprecated_names = {"IRODS_VERSION": _IRODS_VERSION}