changeset 15941:b35b1dc75ec0

added comments to explain the origin of generated sources
author Doug Simon <doug.simon@oracle.com>
date Tue, 27 May 2014 22:00:41 +0200
parents d676c4beeab8
children 5c73b162eec2
files src/share/vm/graal/graalRuntime.hpp src/share/vm/runtime/vmStructs.hpp
diffstat 2 files changed, 15 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- 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();
--- 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: