Make this comment reflect reality. b=241140

gfx/public/nsIRenderingContext.h

@@ -805,12 +805,12 @@ public:
   NS_IMETHOD SetRightToLeftText(PRBool aIsRTL) = 0;
 
   /**
-   *  Draw an image, scaling it to fit a specified rectangle.
+   *  Draw a portion of an image, scaling it to fit within a specified rect.
    *  @param aImage     The image to draw
-   *  @param aSrcRect   The portion (in twips) of the image to draw.
+   *  @param aSrcRect   The rect (in twips) of the image to draw.
    *                    [x,y] denotes the top left corner of the region.
-   *  @param aDestRect  The region (in twips) of the page that the image should
+   *  @param aDestRect  The device context rect (in twips) that the image
-   *                    occupy. [x,y] denotes the top left corner.
+   *                    portion should occupy. [x,y] denotes the top left corner.
    *                    [height,width] denotes the desired image size.
    */
   NS_IMETHOD DrawImage(imgIContainer *aImage, const nsRect & aSrcRect, const nsRect & aDestRect) = 0;

gfx/src/ps/nsRenderingContextPS.h

@@ -196,14 +196,14 @@ public:
                                nsTextDimensions& aLastWordDimensions,
                                PRInt32*          aFontID = nsnull);
 
-  /** ---------------------------------------------------
+  /**
-   *  Draw an image, scaling it to fit a specified rectangle.
+   *  Draw a portion of an image, scaling it to fit a specified rect.
-   *    @param aImage     The image to draw
+   *  @param aImage     The image to draw
-   *           aSrcRect   The portion of the image to draw. [x,y] denotes
+   *  @param aSrcRect   The rect (in twips) of the image to draw.
-   *                      the top left corner of the region.
+   *                    [x,y] denotes the top left corner of the region.
-   *           aDestRect  The region of the page that the image should
+   *  @param aDestRect  The device context rect (in twips) that the image
-   *                      occupy. [x,y] denotes the top left corner.
+   *                    portion should occupy. [x,y] denotes the top left corner.
-   *                      [height,width] denotes the image size.
+   *                    [height,width] denotes the desired image size.
    */
   NS_IMETHOD DrawImage(imgIContainer *aImage,
     const nsRect & aSrcRect, const nsRect & aDestRect);