updated unit test and documentation for #1097