Add a "key" entry to InstallWarnings, remove InstallWarning::Format

extensions/common/install_warning.h

 // Copyright (c) 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 EXTENSIONS_COMMON_INSTALL_WARNING_H_
 #define EXTENSIONS_COMMON_INSTALL_WARNING_H_
 
 #include <ostream>
 #include <string>
 
 namespace extensions {
 
 struct InstallWarning {
-  enum Format {
-    // IMPORTANT: Do not build HTML strings from user or developer-supplied
-    // input.
-    FORMAT_TEXT,
-    FORMAT_HTML,
-  };
-  static InstallWarning Text(const std::string& message) {
-    return InstallWarning(FORMAT_TEXT, message);
+  InstallWarning(const std::string& message);
+  InstallWarning(const std::string& key,

[Yoyo Zhou, 2013/08/14 22:40:36]

This is slightly unintuitive. Usually when you allow arguments to be omitted,
you have
1
12
123
but here it's
3
13
123
Why not make message the first argument?

[Devlin, 2013/08/15 00:20:26]

Done.

+                 const std::string& message);
+  InstallWarning(const std::string& key,
+                 const std::string& specific,
+                 const std::string& message);
+  ~InstallWarning();
+
+  bool operator==(const InstallWarning& other) const {
+    return message == other.message;

[Yoyo Zhou, 2013/08/14 22:40:36]

Maybe comment why this is appropriate and we can ignore key/specific.

[Devlin, 2013/08/15 00:20:26]

Done.

   }
-  InstallWarning(Format format, const std::string& message)
-      : format(format), message(message) {
-  }
-  bool operator==(const InstallWarning& other) const {
-    return format == other.format && message == other.message;
-  }
-  Format format;
+
+  // The manifest key to which this warning pertains (e.g., 'permissions').

[Yoyo Zhou, 2013/08/14 22:40:36]

This is also optional, right?

[Devlin, 2013/08/15 00:20:26]

Done.

+  std::string key;
+  // Optional. The specific portion of the key which caused the warning. For
+  // instance, a single faulty permission in the 'permissions' key.
+  std::string specific;
+  // The warning's message.
   std::string message;
 };
 
 // Let gtest print InstallWarnings.
 void PrintTo(const InstallWarning&, ::std::ostream* os);
 
 }  // namespace
 
 #endif  // EXTENSIONS_COMMON_INSTALL_WARNING_H_