Second pass on jsonpointer package, add more stringent tests

And improve Javadoc along the way.