Add requested documentation.

Review URL: http://codereview.chromium.org/6927074 git-svn-id: svn://svn.chromium.org/chrome/trunk/src@84493 0039d316-1c4b-4281-b951-d872f2087c98
hylschwy · May 6, 2011 · ff24f49 · ff24f49
1 parent bdb22a4
commit ff24f49
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 0 deletions.
diff --git a/crypto/hmac.h b/crypto/hmac.h
@@ -30,6 +30,7 @@ class HMAC {
   explicit HMAC(HashAlgorithm hash_alg);
   ~HMAC();
 
+  // Returns the length of digest that this HMAC will create.
   size_t DigestLength() const;
 
   // TODO(abarth): Add a PreferredKeyLength() member function.

diff --git a/net/http/http_mac_signature.h b/net/http/http_mac_signature.h
@@ -14,6 +14,12 @@
 
 namespace net {
 
+// This class represents an HTTP MAC signature for use in the HTTP MAC
+// Authentication scheme.  The current draft specification of this
+// authentication scheme is located at the following URL:
+//
+//   http://tools.ietf.org/html/draft-hammer-oauth-v2-mac-token
+//
 class HttpMacSignature {
  public:
   HttpMacSignature();
@@ -31,6 +37,7 @@ class HttpMacSignature {
                    const std::string& host,
                    int port);
 
+  // Returns the value of the Authorization header for use in an HTTP request.
   std::string GenerateAuthorizationHeader();
 
  private: