spell things out more clearly in read me