README updates

Author: d-w-moore

README.md

@@ -2122,28 +2122,54 @@ Atomic ACLs
 -----------
 
 A list of permissions may be added to an object atomically using
-the AccessManager's apply_atomic_operations method:
-```
+the AccessManager's `apply_atomic_operations` method:
+```py
 from irods.access import ACLOperation
 from irods.helpers import home_collection
 session = irods.helpers.make_session()
 myCollection = session.collections.create(f"{home_collection(session).path}/newCollection")
 
-session.acls.apply_atomic_operations(myCollection.path,
-   *[ACLOperation("read", "public"),
-     ACLOperation("write", "bob", "otherZone")
-    ])
+session.acls.apply_atomic_operations(
+    myCollection.path,
+    *[
+        ACLOperation("read", "public"),
+        ACLOperation("write", "bob", "otherZone")
+    ]
+)
 ```
-ACLOperation objects form a linear order with iRODSAccess objects, and
-indeed are subclassed from them as well, allowing equivalency testing:
+`ACLOperation` objects form a linear order with `iRODSAccess` objects, and
+indeed are subclassed from them as well, allowing equivalency testing.
 
 Thus, for example:
-```
+```py
 ACLOperation('read','public') in sess.acls.get(object)
 ```
 is a valid operation, so that an application that tends to cache object
 permissions client-side might use such checks in optimizing atomic ACL
-requests against the inclusion of any redundant ACLOperations.
+requests against the inclusion of any redundant ACL operations.
+
+For purposes of sorting, a `__lt__` operator is also defined that would
+allow sorting of lists of `iRODSAccess`, `ACLOperations`, or the two intermixed:
+```py
+perms_list=[
+    ACLOperation('read', 'bob'),
+    iRODSAccess('read', '/tempZone/home/alice', 'alice')
+]
+print(sorted(perms_list))
+```
+
+and, as always, a sort key may be used for custom sorting; for example,
+the following sorts the objects simply by ascending numerical value of the access:
+```py
+perms = sorted(
+    [
+        ACLOperation('read', 'bob'),
+        ACLOperation('write', 'rods'),
+        ACLOperation('read_object', 'alice')
+    ], 
+    key=lambda acl: iRODSAccess.codes[acl.access_name]
+)
+```
 
 Quotas (v2.0.0)
 ---------------