refinements to p1 README