document events dispatched by DisplayContainer

cc @cjolif @edchat, did I document the events correctly?