more javadocs
add failing test 171 which will work when we fix https://bugtrack.marklogic.com/30299