opt into or remove deprecated interfaces

[ehennum]

The deprecated interfaces include the following.

document.remove() returns a response with both a uris property and a uri property. The singular property is a legacy from when document.remove() could only remove a single document. We should remove that property in MarkLogic 9.

In MarkLogic 8, the developer has to opt in to get a transaction object and receives a transaction id string by default. MarkLogic 9 should reverse the default and opt in.

In MarkLogic 8, the developer has to opt in for a zero-based slice on the search response and supplies a 1-based slice by default. MarkLogic 9 should reverse the default and opt in.

[wooldridge]

MarkLogicClient.remove() should also be addressed per the documentation:

For backward compatibility, if a string is passed, the uri is returned as a string, but in the next major release, the uri will be return as an array with one string.

[kcoleman-marklogic]

Mike, if you find other things to remove/change besides the items called out here, please add them so that I can ensure they all make it into the release notes.

[wooldridge]

Per email discussion with @ehennum and @jmakeig, we will deprecate the transactionId string and legacy slice option in ML9 and remove those features entirely in ML10. I will add to the JSDoc regarding this in my check-in and @kcoleman-marklogic can review.