--- a/src/java.base/share/classes/java/lang/String.java	Wed Jan 09 08:52:47 2019 -0800
+++ b/src/java.base/share/classes/java/lang/String.java	Wed Jan 09 15:23:11 2019 -0400
@@ -2982,6 +2982,9 @@
      * This method allows the application of a function to {@code this}
      * string. The function should expect a single String argument
      * and produce an {@code R} result.
+     * <p>
+     * Any exception thrown by {@code f()} will be propagated to the
+     * caller.
      *
      * @param f    functional interface to a apply
      *