readme changes, corrections and usage hints