diff --git a/core/PGraphics.java b/core/PGraphics.java
index 50da04bf4..1ce23f1c2 100644
--- a/core/PGraphics.java
+++ b/core/PGraphics.java
@@ -2430,8 +2430,8 @@ public class PGraphics extends PImage implements PConstants {
 
 
   /**
-   * Rotate around the z axis. rotate() and rotateZ() are the same,
-   * it's just that it make sense to have rotate() and then rotateX()
+   * Rotate around the z axis. The functions rotate() and rotateZ() are
+   * the same, it's just that it make sense to have rotate() and then rotateX()
    * and rotateY() when running in 3D; nor does it make sense to use
    * a function called rotateZ() if you're only doing things in 2D.
    * so we just decided to have them both be the same.
diff --git a/core/PImage.java b/core/PImage.java
index 5eb968e18..c9df8f7c9 100644
--- a/core/PImage.java
+++ b/core/PImage.java
@@ -799,6 +799,7 @@ public class PImage implements PConstants, Cloneable {
 
 
   /**
+   * Optimized code for building the blur kernel.
    * further optimized blur code (approx. 15% for radius=20)
    * bigger speed gains for larger radii (~30%)
    * added support for various image types (ALPHA, RGB, ARGB)