added various clarifications and small bits