Resolve issue from feedback for 1417363004

chrome/browser/local_discovery/privet_http.h

 // Copyright 2013 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_LOCAL_DISCOVERY_PRIVET_HTTP_H_
 #define CHROME_BROWSER_LOCAL_DISCOVERY_PRIVET_HTTP_H_
 
 #include <string>
 
 #include "base/callback.h"
@@ skipping 45 matching lines @@
 
   // Creates a URL fetcher for PrivetV1.
   virtual scoped_ptr<PrivetURLFetcher> CreateURLFetcher(
       const GURL& url,
       net::URLFetcher::RequestType request_type,
       PrivetURLFetcher::Delegate* delegate) = 0;
 
   virtual void RefreshPrivetToken(
       const PrivetURLFetcher::TokenCallback& token_callback) = 0;
 
-  // After this call HTTPS will be used. Only requests to the server with
+  // After this call only HTTPS will be used. Only requests to the server with
   // matching certificate will be allowed.
+  // Privet v3 devices MUST support HTTPS. Before communicating over HTTPS,
+  // Privet v3 pairing generates a shared secret using SPAKE2 over an
+  // unauthenticated channel. This shared secret is used to then authenticate
+  // the fingerprint of a certificate, which is self-signed. The client then
+  // validates that the HTTPS peer is sending a certificate matching that
+  // fingerprint.
+  // For more information on this protocol:
+  // https://developers.google.com/cloud-devices/v1/reference/local-api/pairing_start
   virtual void SwitchToHttps(
       uint16_t port,
       const net::SHA256HashValue& certificate_fingerprint) = 0;
 
   virtual bool IsInHttpsMode() const = 0;
 };
 
 class PrivetDataReadOperation {
  public:
   enum ResponseType {
@@ skipping 135 matching lines @@
   virtual scoped_ptr<PrivetJSONOperation> CreateCapabilitiesOperation(
       const PrivetJSONOperation::ResultCallback& callback) = 0;
 
   // Creates operation to submit print job to local printer.
   virtual scoped_ptr<PrivetLocalPrintOperation> CreateLocalPrintOperation(
       PrivetLocalPrintOperation::Delegate* delegate) = 0;
 };
 
 }  // namespace local_discovery
 #endif  // CHROME_BROWSER_LOCAL_DISCOVERY_PRIVET_HTTP_H_