fixed some out-of-date text, and clarified a few things