Bug 1295094 - Part 15. (follow up) Correct comments.(DONTBUILD) r=me

MozReview-Commit-ID: Kw8rrduASI2

--HG--
extra : rebase_source : c67b6b09563f223434889124d2c9f68e8a8fe9a9
extra : amend_source : dcb23bf43c12e527550f130793d61f10e4a395c1

layout/generic/nsFrame.cpp

@@ -2229,9 +2229,11 @@ nsIFrame::BuildDisplayListForStackingContext(nsDisplayListBuilder* aBuilder,
     aBuilder->EnterSVGEffectsContents(&hoistedScrollInfoItemsStorage);
   }
 
-  // We build an opacity item if it's not going to be drawn by SVG content, or SVG effects.
-  // SVG effects won't handle the opacity if we want an active layer (for async animations),
-  // see nsSVGIntegrationsUtils::PaintFramesWithEffects.
+  // We build an opacity item if it's not going to be drawn by SVG content, or
+  // SVG effects. SVG effects won't handle the opacity if we want an active
+  // layer (for async animations), see
+  // nsSVGIntegrationsUtils::PaintMaskAndClipPath or
+  // nsSVGIntegrationsUtils::PaintFilter.
   bool useOpacity = HasVisualOpacity() && !nsSVGUtils::CanOptimizeOpacity(this) &&
                     (!usingSVGEffects || nsDisplayOpacity::NeedsActiveLayer(aBuilder, this));
   bool useBlendMode = effects->mMixBlendMode != NS_STYLE_BLEND_NORMAL;

layout/svg/nsSVGIntegrationUtils.h

@@ -151,11 +151,14 @@ public:
   };
 
   /**
-   * Paint non-SVG frame with SVG effects.
+   * Paint non-SVG frame with mask, clipPath and opacity effect.
    */
   static DrawResult
   PaintMaskAndClipPath(const PaintFramesParams& aParams);
 
+  /**
+   * Paint non-SVG frame with filter and opacity effect.
+   */
   static DrawResult
   PaintFilter(const PaintFramesParams& aParams);