update docs for multi-user.
re-add missing return.
reinstate logging.