# HG changeset patch
# User Doug Simon <doug.simon@oracle.com>
# Date 1401220841 -7200
# Node ID b35b1dc75ec005ccc31278201527269eba970b27
# Parent  d676c4beeab86565b42a94c140e64a8ac2ebe42a
added comments to explain the origin of generated sources

diff -r d676c4beeab8 -r b35b1dc75ec0 src/share/vm/graal/graalRuntime.hpp
--- a/src/share/vm/graal/graalRuntime.hpp	Tue May 27 22:00:22 2014 +0200
+++ b/src/share/vm/graal/graalRuntime.hpp	Tue May 27 22:00:41 2014 +0200
@@ -68,13 +68,16 @@
   /**
    * Searches for a Graal option denoted by a given name and sets it value.
    *
+   * The definition of this method is in graalRuntime.inline.hpp
+   * which is generated by com.oracle.graal.hotspot.sourcegen.GenGraalRuntimeInlineHpp.
+   *
    * @returns true if the option was found
    * @throws InternalError if there was a problem setting the option's value
    */
   static bool set_option(KlassHandle hotSpotOptionsClass, const char* name, int name_len, Handle name_handle, const char* value, TRAPS);
 
   /**
-   * Instantiates Service object, calls its default constructor and returns it.
+   * Instantiates a service object, calls its default constructor and returns it.
    *
    * @param name the name of a class implementing com.oracle.graal.api.runtime.Service
    */
@@ -84,6 +87,14 @@
 
   static void initialize_natives(JNIEnv *env, jclass c2vmClass);
 
+  /**
+   * Given an interface representing a Graal service (i.e. sub-interface of
+   * com.oracle.graal.api.runtime.Service), gets an array of objects, one per
+   * known implementation of the service.
+   *
+   * The definition of this method is in graalRuntime.inline.hpp
+   * which is generated by com.oracle.graal.hotspot.sourcegen.GenGraalRuntimeInlineHpp.
+   */
   static Handle get_service_impls(KlassHandle serviceKlass, TRAPS);
 
   static BufferBlob* initialize_buffer_blob();
diff -r d676c4beeab8 -r b35b1dc75ec0 src/share/vm/runtime/vmStructs.hpp
--- a/src/share/vm/runtime/vmStructs.hpp	Tue May 27 22:00:22 2014 +0200
+++ b/src/share/vm/runtime/vmStructs.hpp	Tue May 27 22:00:41 2014 +0200
@@ -127,7 +127,9 @@
 #endif
 
 #ifdef GRAAL
-  static void initHotSpotVMConfig(oop config);
+  // The definition of this method is generated by
+  // com.oracle.graal.hotspotvmconfig.HotSpotVMConfigProcessor.
+static void initHotSpotVMConfig(oop config);
 #endif
 
 private: