Add some additional documentation to mouse click handling
Maintain selection when right-clicking on a range that ends at an image

On OSX, right-clicking on an image at the end of a range selection will
hit this particular branch. The image should remain selected if the
right-click occurs on top of it as technically it's the same behaviour
as right clicking on an existing text selection.