RFR: 8024704: Improve API documentation of ClassLoader and ServiceLoader with respect to enumeration of resources.

[Daniel Fuchs]

Hi,

Please find below a fix for:

8024704: Improve API documentation of ClassLoader and ServiceLoader
          with respect to enumeration of resources.
<https://bugs.openjdk.java.net/browse/JDK-8024704>

This is a clarification of the implementation of the
ServiceLoader.iterator() method, as well as non normative advice
for ClassLoader subclasses overriding getResource() or getResources()
to consider overriding the other method in order to keep them
consistent with each other.

<http://cr.openjdk.java.net/~dfuchs/webrev_8024704/webrev.00/>

best regards,

-- daniel