platformKeys: Document supported algorithms and hash functions.

chrome/common/extensions/api/platform_keys.idl

Index: chrome/common/extensions/api/platform_keys.idl
diff --git a/chrome/common/extensions/api/platform_keys.idl b/chrome/common/extensions/api/platform_keys.idl
index a7b359fa9f72107c18093a5047476329b75ad09f..dc875fc5f1a5607835d9423efe179c3d067a8fcb 100644
--- a/chrome/common/extensions/api/platform_keys.idl
+++ b/chrome/common/extensions/api/platform_keys.idl
@@ -120,13 +120,16 @@ namespace platformKeys {
     // |certificate|: The certificate of a $(ref:Match) returned by
     // $(ref:selectClientCertificates).
     // |parameters|: Determines signature/hash algorithm parameters additionally
-    //   to the parameters fixed by the key itself. The same parameters are

[pneubeck (no reviews), 2015/09/28 13:22:26]

the space at the beginning of the line led to weird spacing, so i removed it.

-    //   accepted as by WebCrypto's <code>importKey</code> function, e.g.
-    //   <code>RsaHashedImportParams</code> for a RSASSA-PKCS1-v1_5 key.
-    //   For RSASSA-PKCS1-v1_5 keys, additionally the parameters
-    //   <code>{ 'hash': { 'name': 'none' } }</code> are supported. The sign
-    //   function will then apply PKCS#1 v1.5 padding and but not hash the
-    //   given data.
+    // to the parameters fixed by the key itself. The same parameters are
+    // accepted as by WebCrypto's <a
+    // href="http://www.w3.org/TR/WebCryptoAPI/#SubtleCrypto-method-importKey">importKey</a>
+    // function, e.g. <code>RsaHashedImportParams</code> for a RSASSA-PKCS1-v1_5
+    // key. For RSASSA-PKCS1-v1_5 keys, additionally the parameters <code>{
+    // "hash": { "name": "none" } }</code> are supported. The sign function will
+    // then apply PKCS#1 v1.5 padding and but not hash the given data.
+    // <p>Currently, this function only supports the "RSASSA-PKCS1-v1_5"
+    // algorithm with one of the hashing algorithms "none", "SHA-1", "SHA-256",
+    // "SHA-384", and "SHA-512".</p>
     [nocompile] static void getKeyPair(ArrayBuffer certificate,
                                        object parameters,
                                        GetKeyPairCallback callback);