update docs to match the change to t

- Also noticed inconsistencies in tab/space in README, replaced the few tabs into space.

- Slight precision on phrases.