Implement page action popups.

chrome/browser/browser_list.h

 // Copyright (c) 2009 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 CHROME_BROWSER_BROWSER_LIST_H__
 #define CHROME_BROWSER_BROWSER_LIST_H__
 
 #include <vector>
 
 #include "chrome/browser/browser.h"
@@ skipping 34 matching lines @@
   static void SetLastActive(Browser* browser);
 
   // Returns the Browser object whose window was most recently active.  If the
   // most recently open Browser's window was closed, returns the first Browser
   // in the list.  If no Browsers exist, returns NULL.
   //
   // WARNING: this is NULL until a browser becomes active. If during startup
   // a browser does not become active (perhaps the user launches Chrome, then
   // clicks on another app before the first browser window appears) then this
   // returns NULL.
+  // WARNING #2: this will always be NULL in unit tests run on the bots.
   static Browser* GetLastActive();
 
   // Identical in behavior to GetLastActive(), except that the most recently
   // open browser owned by |profile| is returned. If none exist, returns NULL.
+  // WARNING: see warnings in GetLastActive().
   static Browser* GetLastActiveWithProfile(Profile *profile);
 
   // Find an existing browser window with the provided type. Searches in the
   // order of last activation. Only browsers that have been active can be
   // returned. Returns NULL if no such browser currently exists.
   static Browser* FindBrowserWithType(Profile* p, Browser::Type t);
 
   // Find an existing browser window with the provided profile. Searches in the
   // order of last activation. Only browsers that have been active can be
   // returned. Returns NULL if no such browser currently exists.
@@ skipping 122 matching lines @@
   // tab index into the current Browser of the current web view
   int web_view_index_;
 
   // Current TabContents, or NULL if we're at the end of the list. This can
   // be extracted given the browser iterator and index, but it's nice to cache
   // this since the caller may access the current host many times.
   TabContents* cur_;
 };
 
 #endif  // CHROME_BROWSER_BROWSER_LIST_H__