Bug 999349 - Add "DO NOT USE" annotation to nsIPlatformCharset. r=emk

content/base/src/nsDOMFile.cpp

@@ -20,7 +20,6 @@
 #include "nsIIPCSerializableInputStream.h"
 #include "nsIMemoryReporter.h"
 #include "nsIMIMEService.h"
-#include "nsIPlatformCharset.h"
 #include "nsISeekableStream.h"
 #include "nsIUnicharInputStream.h"
 #include "nsIUnicodeDecoder.h"

dom/file/ArchiveZipEvent.cpp

@@ -8,8 +8,6 @@
 #include "ArchiveZipFile.h"
 
 #include "nsContentUtils.h"
-#include "nsIPlatformCharset.h"
-#include "nsNativeCharsetUtils.h"
 #include "nsCExternalHandlerService.h"
 
 using namespace mozilla::dom;

dom/workers/RuntimeService.cpp

@@ -12,7 +12,6 @@
 #include "nsIDOMChromeWindow.h"
 #include "nsIEffectiveTLDService.h"
 #include "nsIObserverService.h"
-#include "nsIPlatformCharset.h"
 #include "nsIPrincipal.h"
 #include "nsIScriptContext.h"
 #include "nsIScriptSecurityManager.h"

intl/locale/public/nsIPlatformCharset.h

@@ -34,6 +34,13 @@ typedef enum {
      kPlatformCharsetSel_PlainTextInFile = 7
 } nsPlatformCharsetSel;
 
+/**
+ * DO NOT ADD NEW USES OF THIS INTERFACE!
+ * Removal is https://bugzilla.mozilla.org/show_bug.cgi?id=943272
+ *
+ * Instead, use UTF-16 APIs on Windows and UTF-8 APIs everywhere else.
+ * Assume plain text files are UTF-8.
+ */
 class nsIPlatformCharset : public nsISupports
 {
 public: