From f464416314c8c8c925d51913fb56dd55434a6e37 Mon Sep 17 00:00:00 2001 From: Nikhil Marathe Date: Mon, 17 Dec 2012 10:56:24 -0800 Subject: [PATCH] Bug 821140 - Replace 'UniversalXPConnect' with 'chrome' in nsIDOMWindowUtils.idl comments. r=mccr8 DONTBUILD --- dom/interfaces/base/nsIDOMWindowUtils.idl | 79 +++++++++-------------- 1 file changed, 30 insertions(+), 49 deletions(-) diff --git a/dom/interfaces/base/nsIDOMWindowUtils.idl b/dom/interfaces/base/nsIDOMWindowUtils.idl index 820f42ddac5..d28e22d857c 100644 --- a/dom/interfaces/base/nsIDOMWindowUtils.idl +++ b/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);