NOT YET READY: Improve granularity of window namespaces in Blink.

content/browser/browsing_instance.h

 // Copyright (c) 2012 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 CONTENT_BROWSER_BROWSING_INSTANCE_H_
 #define CONTENT_BROWSER_BROWSING_INSTANCE_H_
 
 #include <stddef.h>
 
 #include "base/containers/hash_tables.h"
@@ skipping 36 matching lines @@
 // have references to it.  Because both classes are RefCounted, they do not
 // need to be manually deleted.
 //
 // BrowsingInstance has no public members, as it is designed to be
 // visible only from the SiteInstance class.  To get a new
 // SiteInstance that is part of the same BrowsingInstance, use
 // SiteInstance::GetRelatedSiteInstance.  Because of this,
 // BrowsingInstances and SiteInstances are tested together in
 // site_instance_unittest.cc.
 //
+// Note that a browsing instance in the browser is independently tracked in
+// the renderer inside blink::Page::RelatedPages() method (in theory the browser
+// and renderer should always stay in sync).
+//
 ///////////////////////////////////////////////////////////////////////////////
 class CONTENT_EXPORT BrowsingInstance final
     : public base::RefCounted<BrowsingInstance> {
  private:
   friend class base::RefCounted<BrowsingInstance>;
   friend class SiteInstanceImpl;
   FRIEND_TEST_ALL_PREFIXES(SiteInstanceTest, OneSiteInstancePerSite);
   FRIEND_TEST_ALL_PREFIXES(SiteInstanceTest,
                            OneSiteInstancePerSiteInBrowserContext);
 
@@ skipping 59 matching lines @@
   size_t active_contents_count_;
 
   SiteInstanceImpl* default_subframe_site_instance_ = nullptr;
 
   DISALLOW_COPY_AND_ASSIGN(BrowsingInstance);
 };
 
 }  // namespace content
 
 #endif  // CONTENT_BROWSER_BROWSING_INSTANCE_H_