tim-connector: comments improved and NotNull annotations added