Adding a SetRAILMode API.

include/v8.h

 // Copyright 2012 the V8 project authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 /** \mainpage V8 API Reference Guide
  *
  * V8 is Google's open source JavaScript engine.
  *
  * This set of documents provides reference material generated from the
  * V8 header file, include/v8.h.
@@ skipping 5339 matching lines @@
 
     // Only valid for CODE_ADD_LINE_POS_INFO
     struct line_info_t line_info;
 
     // New location of instructions. Only valid for CODE_MOVED.
     void* new_code_start;
   };
 };
 
 /**
+ * Option flags passed to the SetRAILMode function.
+ */
+enum RAILMode {
+  PERFORMANCE_DEFAULT,

[rmcilroy, 2016/05/20 10:29:00]

Could you add a comment to each of these describing the expectation of when it
would be set.

[Sami, 2016/05/20 10:37:32]

+1, a short snippet per state would be useful -- especially if there are
downsides to sticking in a particular mode for too long.

[Hannes Payer (out of office), 2016/05/20 11:02:41]

Done.

+  PERFORMANCE_RESPONSE,
+  PERFORMANCE_ANIMATION,
+  PERFORMANCE_IDLE,
+  PERFORMANCE_LOAD
+};
+
+/**
  * Option flags passed to the SetJitCodeEventHandler function.
  */
 enum JitCodeEventOptions {
   kJitCodeEventDefault = 0,
   // Generate callbacks for already existent code.
   kJitCodeEventEnumExisting = 1
 };
 
 
 /**
@@ skipping 781 matching lines @@
    */
   void IsolateInForegroundNotification();
 
   /**
    * Optional notification that the isolate switched to the background.
    * V8 uses these notifications to guide heuristics.
    */
   void IsolateInBackgroundNotification();
 
   /**
+   * Optional notification to tell V8 the current performance requirements
+   * of the embedder based on RAIL.
+   * V8 uses these notifications to guide heuristics.
+   */
+  void SetRAILMode(RAILMode rail_mode);
+
+  /**
    * Allows the host application to provide the address of a function that is
    * notified each time code is added, moved or removed.
    *
    * \param options options for the JIT code event handler.
    * \param event_handler the JIT code event handler, which will be invoked
    *     each time code is added, moved or removed.
    * \note \p event_handler won't get notified of existent code.
    * \note since code removal notifications are not currently issued, the
    *     \p event_handler may get notifications of code that overlaps earlier
    *     code notifications. This happens when code areas are reused, and the
@@ skipping 2573 matching lines @@
  */
 
 
 }  // namespace v8
 
 
 #undef TYPE_CHECK
 
 
 #endif  // INCLUDE_V8_H_