WIP: Note potential problem areas of code

This change also includes the beginning of a fix to a critical bug in
ImageJ2, where closing a display throws an exception. But the fix needs
to be considered more carefully (as alluded to in the accompanying
comment) and properly unit tested to avoid regressions later.