docstring

engine/items.py

@@ -797,6 +797,13 @@ class Item(object):
         #self.parentBlocks = oldItem.parentBlocks #TODO. We took that out when pasting after deleting a track and recreating failed. Why do we to copy the parentBlocks when a parentBlock is added during block.insert anyway? Wild guess: we don't.
 
     def logicalDuration(self):
+        """Used for positioning items on the tickindex and subsequently midi export and GUI spacing.
+        A chord can have logicalDuration D4 but one of it's notes can have a dot or a user duration mod.
+        It will still use the logicalDuration of D4 to figure out where the next note is.
+
+        From a midi POV: logicalDuration determines the next NoteOn. NoteOffs can be modified and
+        are not used for positioning on the timeline
+        """
         return 0
 
     def deserializeInplace(self, serializedObject):