attempt to fix some focus problems (and fail)

also slightly improve some documentation