working
updated test case
update documentation.  All tests passing