Split V8Proxy::retrieveActiveFrame() into two methods.

webkit/port/bindings/v8/v8_proxy.h

 // Copyright (c) 2006-2008 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef V8_PROXY_H__
 #define V8_PROXY_H__
 
 #include <v8.h>
 #include "v8_index.h"
 #include "v8_custom.h"
@@ skipping 265 matching lines @@
   static V8Proxy* retrieve(Frame* frame);
   // Returns V8Proxy object associated with a script execution context.
   static V8Proxy* retrieve(ScriptExecutionContext* context);
 
   // Returns the frame object of the window object associated
   // with the currently executing context.
   static Frame* retrieveFrame();
   // Returns the frame object of the window object associated with
   // a context.
   static Frame* retrieveFrame(v8::Handle<v8::Context> context);
-  // Returns the frame that started JS execution.
-  // NOTE: cannot declare retrieveActiveFrame as inline function,
-  // VS complains at linking time.
-  static Frame* retrieveActiveFrame();
+
+
+  // The two functions below retrieve WebFrame instances relating the currently
+  // executing JavaScript. Since JavaScript can make function calls across
+  // frames, though, we need to be more precise.
+  //
+  // For example, imagine that a JS function in frame A calls a function in
+  // frame B, which calls native code, which wants to know what the 'active'
+  // frame is.
+  //
+  // The 'entered context' is the context where execution first entered the
+  // script engine; the context that is at the bottom of the JS function stack.
+  // RetrieveFrameForEnteredContext() would return Frame A in our example.
+  //
+  // The 'current context' is the context the JS engine is currently inside of;
+  // the context that is at the top of the JS function stack.
+  // RetrieveFrameForCurrentContext() would return Frame B in our example.
+  //
+  // NOTE: These cannot be declared as inline function, because VS complains at
+  // linking time.
+  static Frame* retrieveFrameForEnteredContext();
+  static Frame* retrieveFrameForCurrentContext();
 
   // Returns V8 Context of a frame. If none exists, creates
   // a new context.  It is potentially slow and consumes memory.
   static v8::Local<v8::Context> GetContext(Frame* frame);
   static v8::Local<v8::Context> GetCurrentContext();
 
   // If the current context causes out of memory, JavaScript setting
   // is disabled and it returns true.
   static bool HandleOutOfMemory();
 
@@ skipping 299 matching lines @@
   V8Proxy::SetDOMWrapper(args.Holder(), tag, obj.get());
   obj->ref();
   V8Proxy::SetJSWrapperForDOMObject(
       obj.get(), v8::Persistent<v8::Object>::New(args.Holder()));
   return args.Holder();
 }
 
 }  // namespace WebCore
 
 #endif  // V8_PROXY_H__