add to user docs - and details to dev docs

Include that entry ended by ... always opens a new window (and if this is not desired, discuss)