Bug 821140 - Replace 'UniversalXPConnect' with 'chrome' in nsIDOMWindowUtils.idl comments. r=mccr8 DONTBUILD

dom/interfaces/base/nsIDOMWindowUtils.idl

@@ -80,8 +80,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * @param aName the name of the metadata.  This should be all lowercase.
    * @return the value of the metadata, or the empty string if it's not set
    *
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    */
   AString getDocumentMetadata(in AString aName);
 
@@ -98,8 +97,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * pixels, regardless of the size of the enclosing widget/view.
    * This will trigger reflow.
    *
-   * The caller of this method must have UniversalXPConnect
-   * privileges.
+   * The caller of this method must have chrome privileges.
    */
   void setCSSViewport(in float aWidthPx, in float aHeightPx);
 
@@ -136,8 +134,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * It's also legal to set a displayport that extends beyond the
    * area's bounds.  No pixels are rendered outside the area bounds.
    *
-   * The caller of this method must have UniversalXPConnect
-   * privileges.
+   * The caller of this method must have chrome privileges.
    *
    * Calling this will always force a recomposite, so it should be
    * avoided if at all possible. Client code should do checks before
@@ -181,8 +178,7 @@ interface nsIDOMWindowUtils : nsISupports {
    *   // elsewhere
    *   browser.setViewportScale(2.0, 2.0);
    *
-   * The caller of this method must have UniversalXPConnect
-   * privileges.
+   * The caller of this method must have chrome privileges.
    */
   void setResolution(in float aXResolution, in float aYResolution);
 
@@ -193,7 +189,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * This gives a way to track the next paint that occurs after the flag is
    * set. The flag gets cleared after the next paint.
    *
-   * Can only be accessed with UniversalXPConnect privileges.
+   * Can only be accessed with chrome privileges.
    */
   attribute boolean isFirstPaint;
 
@@ -230,8 +226,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * should be sufficient to generate the correct over and out events as well.
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * The event is dispatched via the toplevel window, so it could go to any
    * window under the toplevel window, in some cases it could never reach this
@@ -265,8 +260,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * Events are sent in coordinates offset by aX and aY from the window.
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * The event is dispatched via the toplevel window, so it could go to any
    * window under the toplevel window, in some cases it could never reach this
@@ -317,8 +311,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * Events are sent in coordinates offset by aX and aY from the window.
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * @param aX                 x offset in CSS pixels
    * @param aY                 y offset in CSS pixels
@@ -368,8 +361,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * Key events generally end up being sent to the focused node.
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * @param aType event type
    * @param aKeyCode key code
@@ -404,8 +396,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * See nsIWidget::SynthesizeNativeKeyEvent
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * When you use this for tests, use the constants defined in NativeKeyCodes.js
    */
@@ -420,8 +411,7 @@ interface nsIDOMWindowUtils : nsISupports {
    *
    * Will be called on the widget that contains aElement.
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    */
   void sendNativeMouseEvent(in long aScreenX,
                             in long aScreenY,
@@ -434,8 +424,7 @@ interface nsIDOMWindowUtils : nsISupports {
    *
    * Will be called on the widget that contains aElement.
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * NOTE: The synthesized native event may be fired asynchronously.
    *
@@ -479,8 +468,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * See nsIWidget::ActivateNativeMenuItemAt
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    */
   void activateNativeMenuItemAt(in AString indexString);
 
@@ -488,8 +476,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * See nsIWidget::ForceUpdateNativeMenuAt
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    */
   void forceUpdateNativeMenuAt(in AString indexString);
 
@@ -499,8 +486,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * that currently has focus, and focus the document.
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * @param aElement the element to focus
    *
@@ -513,8 +499,8 @@ interface nsIDOMWindowUtils : nsISupports {
   /**
    * Force a garbage collection followed by a cycle collection.
    *
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges in non-debug builds. Available to all callers in debug builds.
+   * Will throw a DOM security error if called without chrome privileges in
+   * non-debug builds. Available to all callers in debug builds.
    *
    * @param aListener listener that receives information about the CC graph
    *                  (see @mozilla.org/cycle-collector-logger;1 for a logger
@@ -532,8 +518,8 @@ interface nsIDOMWindowUtils : nsISupports {
   /**
    * Force a cycle collection without garbage collection.
    *
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges in non-debug builds. Available to all callers in debug builds.
+   * Will throw a DOM security error if called without chrome privileges in
+   * non-debug builds. Available to all callers in debug builds.
    *
    * @param aListener listener that receives information about the CC graph
    *                  (see @mozilla.org/cycle-collector-logger;1 for a logger
@@ -556,7 +542,7 @@ interface nsIDOMWindowUtils : nsISupports {
    *
    * Cannot be accessed from unprivileged context (not
    * content-accessible) Will throw a DOM security error if called
-   * without UniversalXPConnect privileges.
+   * without chrome privileges.
    *
    * @param aType event type
    * @param aX x offset in CSS pixels
@@ -615,7 +601,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * the maximum difference in a channel.  This will throw an error if
    * the dimensions of the two canvases are different.
    *
-   * This method requires UniversalXPConnect privileges.
+   * This method requires chrome privileges.
    */
   uint32_t compareCanvases(in nsIDOMHTMLCanvasElement aCanvas1,
                            in nsIDOMHTMLCanvasElement aCanvas2,
@@ -631,8 +617,8 @@ interface nsIDOMWindowUtils : nsISupports {
    * Suppresses/unsuppresses user initiated event handling in window's document
    * and subdocuments.
    *
-   * @throw NS_ERROR_DOM_SECURITY_ERR if called without UniversalXPConnect
-   *        privileges and NS_ERROR_FAILURE if window doesn't have a document.
+   * @throw NS_ERROR_DOM_SECURITY_ERR if called without chrome privileges and
+   *        NS_ERROR_FAILURE if window doesn't have a document.
    */
   void suppressEventHandling(in boolean aSuppress);
 
@@ -642,8 +628,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * Disable or enable non synthetic test mouse events on *all* windows.
    *
    * Cannot be accessed from unprivileged context (not content-accessible).
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * @param aDisable  If true, disable all non synthetic test mouse events
    *               on all windows.  Otherwise, enable them.
@@ -726,7 +711,7 @@ interface nsIDOMWindowUtils : nsISupports {
    *
    * Cannot be accessed from unprivileged context (not
    * content-accessible) Will throw a DOM security error if called
-   * without UniversalXPConnect privileges.
+   * without chrome privileges.
    *
    * @note Event handlers won't get aEvent as parameter, but a similar event.
    *       Also, aEvent should not be reused.
@@ -745,8 +730,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * Generate a content command event.
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * @param aType Type of command content event to send.  Can be one of "cut",
    *        "copy", "paste", "delete", "undo", "redo", or "pasteTransferable".
@@ -760,8 +744,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * Synthesize a composition event to the window.
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * @param aType     The event type: "compositionstart", "compositionend" or
    *                  "compositionupdate".
@@ -778,8 +761,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * Synthesize a text event to the window.
    *
    * Cannot be accessed from unprivileged context (not content-accessible)
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    * Currently, this method doesn't support 4 or more clauses composition
    * string.
@@ -1248,8 +1230,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * Returns an array of plugins on the page for opt-in activation.
    *
    * Cannot be accessed from unprivileged context (not content-accessible).
-   * Will throw a DOM security error if called without UniversalXPConnect
-   * privileges.
+   * Will throw a DOM security error if called without chrome privileges.
    *
    */
   [implicit_jscontext]
@@ -1259,7 +1240,7 @@ interface nsIDOMWindowUtils : nsISupports {
    * Set the scrollport size for the purposes of clamping scroll positions for
    * the root scroll frame of this document to be (aWidth,aHeight) in CSS pixels.
    *
-   * The caller of this method must have UniversalXPConnect privileges.
+   * The caller of this method must have chrome privileges.
    */
   void setScrollPositionClampingScrollPortSize(in float aWidth, in float aHeight);