diff --git a/gson/src/main/java/com/google/gson/JsonSyntaxException.java b/gson/src/main/java/com/google/gson/JsonSyntaxException.java
index ffd875c5..17c1d3d3 100644
--- a/gson/src/main/java/com/google/gson/JsonSyntaxException.java
+++ b/gson/src/main/java/com/google/gson/JsonSyntaxException.java
@@ -16,9 +16,9 @@
 package com.google.gson;
 
 /**
- * This exception is raised when Gson was unable to read an input stream
- * or write to one.
- * 
+ * This exception is raised when Gson attempts to read (or write) a malformed
+ * JSON element.
+ *
  * @author Inderjeet Singh
  * @author Joel Leitch
  */
@@ -36,7 +36,8 @@ public final class JsonSyntaxException extends JsonParseException {
 
   /**
    * Creates exception with the specified cause. Consider using
-   * {@link #JsonSyntaxException(String, Throwable)} instead if you can describe what happened.
+   * {@link #JsonSyntaxException(String, Throwable)} instead if you can
+   * describe what actually happened.
    *
    * @param cause root exception that caused this exception to be thrown.
    */