Mac content shell: HTTP auth.

content/public/browser/resource_dispatcher_host_login_delegate.h

 // Copyright (c) 2011 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_PUBLIC_BROWSER_RESOURCE_DISPATCHER_HOST_LOGIN_DELEGATE_H_
 #define CONTENT_PUBLIC_BROWSER_RESOURCE_DISPATCHER_HOST_LOGIN_DELEGATE_H_
 #pragma once
 
 #include "base/basictypes.h"
 #include "base/memory/ref_counted.h"
 #include "content/common/content_export.h"
 
 namespace content {
 
-// Interface for getting login credentials for HTTP auth requests.  When the
-// implementation has the credentials, it shoudl call the Requests's SetAuth
-// method.
+// Interface for getting login credentials for HTTP auth requests. If the
+// login delegate obtains credentials, it should call the URLRequest's SetAuth
+// method. If the user cancels, the login delegate should call the URLRequest's
+// CancelAuth instead. And in either case, it must make a call to
+// ResourceDispatcherHost::ClearLoginDelegateForRequest.
 class CONTENT_EXPORT ResourceDispatcherHostLoginDelegate
     : public base::RefCountedThreadSafe<ResourceDispatcherHostLoginDelegate> {
  public:
   virtual ~ResourceDispatcherHostLoginDelegate() {}
 
-  // Notify the delegate that the request was cancelled.
+  // Notify the login delegate that the request was cancelled.
   // This function can only be called from the IO thread.
   virtual void OnRequestCancelled() = 0;
 };
 
 }  // public content
 
 #endif  // CONTENT_PUBLIC_BROWSER_RESOURCE_DISPATCHER_HOST_LOGIN_DELEGATE_H_