Add more documentation to PositionIterator.