re-writes and clarifications