DOC: updated comments