Updated the documentation to better match the way things work now that 172cd28 is merged.
Merge pull request #1593 from perlun/patch-1

Updated the documentation to better match the way things work now that 172cd28 is merged.