Returning the value on increment call

Returning an additional value of a successful increment call.

Also ran docco to update the doc with the small change. If that is an issue let me know and I'll submit just the code change.