diff --git a/java/external/src/javax/xml/transform/TransformerFactory.java b/java/external/src/javax/xml/transform/TransformerFactory.java
index e28b679..990b268 100644
--- a/java/external/src/javax/xml/transform/TransformerFactory.java
+++ b/java/external/src/javax/xml/transform/TransformerFactory.java
@@ -127,7 +127,9 @@ public abstract class TransformerFactory {
      * TransformerFactory</code> it can use the factory to configure
      * and obtain parser instances.
      *
-     * @return new TransformerFactory instance, never null.
+     * @return new TransformerFactory instance, never null (unless an {@link ErrorListener} 
+     * is registered with the TransformerFactory, in which case an exception error sends an 
+     * error message to the ErrorListener and returns null).
      *
      * @throws TransformerFactoryConfigurationError
      * if the implmentation is not available or cannot be instantiated.
@@ -156,7 +158,9 @@ public abstract class TransformerFactory {
      * @param source An object that holds a URI, input stream, etc.
      *
      * @return A Transformer object that may be used to perform a transformation
-     * in a single thread, never null.
+     * in a single thread, never null (unless an {@link ErrorListener} is registered with
+     * the TransformerFactory, in which case an exception error sends an error message to
+     * the ErrorListener and returns null).
      *
      * @exception TransformerConfigurationException May throw this during the parse
      *            when it is constructing the Templates object and fails.
@@ -171,7 +175,9 @@ public abstract class TransformerFactory {
      * @param source An object that holds a URI, input stream, etc.
      *
      * @return A Transformer object that may be used to perform a transformation
-     * in a single thread, never null.
+     * in a single thread, never null (unless an {@link ErrorListener} is registered with
+     * the TransformerFactory, in which case an exception error sends an error message to
+     * the ErrorListener and returns null).
      *
      * @exception TransformerConfigurationException May throw this during
      *            the parse when it is constructing the
@@ -191,7 +197,9 @@ public abstract class TransformerFactory {
      * @param source An object that holds a URL, input stream, etc.
      *
      * @return A Templates object capable of being used for transformation purposes,
-     * never null.
+     * never null (unless an {@link ErrorListener} is registered with
+     * the TransformerFactory, in which case an exception error sends an error message to
+     * the ErrorListener and returns null).
      *
      * @exception TransformerConfigurationException May throw this during the parse when it
      *            is constructing the Templates object and fails.