differentiated the two functions.  Updated docs, and tests
4 files changed