update the display link when we move windows
clearer properties, comments
document in the header