Bug 737013 - Expose sanitizer fragments on parseFragment(), migrate callers to the new interface. r=smaug.

parser/html/nsIScriptableUnescapeHTML.idl

@@ -41,7 +41,7 @@ interface nsIDOMDocumentFragment;
 interface nsIURI;
 
 /**
- * A utility class for HTML parsing in the feed processor.
+ * This interface is OBSOLETE and exists solely for legacy extensions.
  */
 [scriptable, uuid(3ab244a9-f09d-44da-9e3f-ee4d67367f2d)]
 interface nsIScriptableUnescapeHTML : nsISupports 
@@ -52,16 +52,20 @@ interface nsIScriptableUnescapeHTML : nsISupports
    *   nsIDocumentEncoder::OutputSelectionOnly |
    *   nsIDocumentEncoder::OutputAbsoluteLinks, 0).
    *
-   * You should most likely call nsIParserUtils::convertToPlainText()
-   * instead of calling this method.
+   * You should call nsIParserUtils::convertToPlainText() instead of calling 
+   * this method.
    *
    * @param src The HTML string to convert to plain text.
    */ 
   AString unescape(in AString src);
         
   /**
-   * Parses markup into a sanitized document fragment.
+   * Parses markup into a sanitized document fragment. This is equivalent to
+   * calling nsIParserUtils::parseFragment(fragment, 0, isXML, baseURI,
+   * element).
    *
+   * You should call nsIParserUtils::parseFragment() instead of calling this 
+   * method.
    * @param fragment the input markup
    * @param isXML true if |fragment| is XML and false if HTML
    * @param baseURI the base URL for this fragment