How to detect stream end is unclear from documentation

[jobarr-amzn]

See e.g. IonReader javadoc.

There's discussion of the meaning of next() in the interface documentation, but the fact that stream end is signaled by a null response from next() is buried in the end of the @return documentation on that method.