javadoc enhancements for zip(iterable) => zipWith(iterable) switchover