Add comment about our SSL UI notifications as requested by wtc.

git-svn-id: svn://svn.chromium.org/chrome/trunk/src@16016 0039d316-1c4b-4281-b951-d872f2087c98

1 files changed, 16 insertions, 0 deletions

diff --git a/chrome/common/notification_type.h b/chrome/common/notification_type.h
index 3364fc1..98f0259 100644
--- a/chrome/common/notification_type.h
+++ b/chrome/common/notification_type.h
@@ -132,6 +132,22 @@ class NotificationType {
     // are provided.
     RESOURCE_RECEIVED_REDIRECT,
 
+    // SSL ---------------------------------------------------------------------
+
+    // Updating the SSL security indicators (the lock icon and such) proceeds
+    // in two phases:
+    //
+    // 1) An SSLManager changes the SSLHostState (which hangs off the profile
+    //    object).  When this happens, the SSLManager broadcasts an
+    //    SSL_INTERNAL_STATE_CHANGED notification.
+    //
+    // 2) The SSLManager for each tab receives this notification and might or
+    //    might not update the navigation entry for its tab, depending on
+    //    whether the change in SSLHostState affects that tab.  If the
+    //    SSLManager does change the navigation entry, then the SSLManager
+    //    broadcasts an SSL_VISIBLE_STATE_CHANGED notification to the user
+    //    interface can redraw properly.
+
     // The SSL state of a page has changed in some visible way.  For example,
     // if an insecure resource is loaded on a secure page.  Note that a
     // toplevel load commit will also update the SSL state (since the