Improve javadoc for org.graalvm.nativeimage.impl.ClassLoading(Support)

Author: gilles-duboscq

sdk/src/org.graalvm.nativeimage/src/org/graalvm/nativeimage/impl/ClassLoading.java

@@ -60,8 +60,9 @@ public static boolean isSupported() {
     }
 
     /**
-     * Opens a scope in which class loading is not constrained by the reflection configuration. Once
-     * the returned {@link AutoCloseable} is closed, the previous state is restored.
+     * Opens a scope in which class loading is not constrained by the reflection configuration for
+     * the current thread. Once the returned {@link AutoCloseable} is closed, the previous state is
+     * restored.
      *
      * @throws IllegalStateException if class loading is not {@linkplain #isSupported() supported}.
      */
@@ -74,8 +75,8 @@ public static ArbitraryClassLoadingScope allowArbitraryClassLoading() {
 
     /**
      * Conditionally opens a scope in which class loading is not constrained by the reflection
-     * configuration. If {@code allowArbitraryClassLoading} is true, behaves like
-     * {@link #allowArbitraryClassLoading()}. Otherwise, it has no effect.
+     * configuration for the current thread. If {@code allowArbitraryClassLoading} is true, behaves
+     * like {@link #allowArbitraryClassLoading()}. Otherwise, it has no effect.
      *
      * @throws IllegalStateException if class loading is not {@linkplain #isSupported() supported}
      *             and {@code allowArbitraryClassLoading} is true.

sdk/src/org.graalvm.nativeimage/src/org/graalvm/nativeimage/impl/ClassLoadingSupport.java

@@ -47,11 +47,28 @@ static ClassLoadingSupport singleton() {
         return ImageSingletons.lookup(ClassLoadingSupport.class);
     }
 
+    /**
+     * Returns whether runtime class loading is supported.
+     */
     boolean isSupported();
 
+    /**
+     * Returns false iff the current thread is in a
+     * {@linkplain #startIgnoreReflectionConfigurationScope() scope} where reflection configuration
+     * is ignored.
+     */
     boolean followReflectionConfiguration();
 
+    /**
+     * Starts a scope in which the reflection configuration is ignored for runtime class loading.
+     * <p>
+     * That scope can be closed by calling {@link #endIgnoreReflectionConfigurationScope()}.
+     */
     void startIgnoreReflectionConfigurationScope();
 
+    /**
+     * Ends a scope started by {@link #startIgnoreReflectionConfigurationScope()} for the current
+     * thread.
+     */
     void endIgnoreReflectionConfigurationScope();
 }