Documentation fixes; more stern warnings and fair disclosures