--- a/src/java.base/share/classes/java/nio/X-Buffer.java.template	Tue Feb 19 12:46:22 2019 -0800
+++ b/src/java.base/share/classes/java/nio/X-Buffer.java.template	Tue Feb 19 13:05:16 2019 -0800
@@ -209,6 +209,8 @@
  * <p> This class implements the {@link CharSequence} interface so that
  * character buffers may be used wherever character sequences are accepted, for
  * example in the regular-expression package {@link java.util.regex}.
+ * The methods defined by {@code CharSequence} operate relative to the current
+ * position of the buffer when they are invoked.
  * </p>
  *
 #end[char]