<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;" class=""><br class=""><div><blockquote type="cite" class=""><div class="">On Feb 15, 2019, at 1:06 AM, Alan Bateman <<a href="mailto:Alan.Bateman@oracle.com" class="">Alan.Bateman@oracle.com</a>> wrote:</div><br class="Apple-interchange-newline"><div class=""><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration: none; float: none; display: inline !important;" class="">On 14/02/2019 22:36, Brian Burkhalter wrote:</span><br style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration: none;" class=""><blockquote type="cite" cite="mid:23196D55-A907-4242-ADF6-222A099C145C@oracle.com" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-size-adjust: auto; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration: none;" class=""><div dir="auto" class="" style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;"><div dir="auto" class="" style="word-wrap: break-word; -webkit-nbsp-mode: space; line-break: after-white-space;"><a href="https://bugs.openjdk.java.net/browse/JDK-8065262" class="" moz-do-not-send="true">https://bugs.openjdk.java.net/browse/JDK-8065262</a><div class=""><br class=""></div><div class="">One possibility would be to update the class level specification as</div><div class=""><br class=""></div><div class="">To clear this up, perhaps a sentence could merely be added to the specification of CharBuffer in X-Buffer.java.template:<span class="Apple-converted-space"> </span><br class=""><br class=""><div class="" style="margin: 0px; font-stretch: normal; line-height: normal; background-color: rgba(255, 255, 255, 0.811765);"><span class="" style="font-variant-ligatures: no-common-ligatures;"><font class="" face="Courier">#if[char]</font></span></div><div class="" style="margin: 0px; font-stretch: normal; line-height: normal; background-color: rgba(255, 255, 255, 0.811765);"><span class="" style="font-variant-ligatures: no-common-ligatures;"><font class="" face="Courier"> *</font></span></div><font class="" face="Courier">  * <p> This class implements the {@link CharSequence} interface so that<span class="Apple-converted-space"> </span><br class="">  * character buffers may be used wherever character sequences are accepted, for<span class="Apple-converted-space"> </span><br class="">  * example in the regular-expression package {@link java.util.regex}.<span class="Apple-converted-space"> </span><br class="">+ * {@code CharSequence} methods operate relative to the current position of<span class="Apple-converted-space"> </span><br class="">+ * the buffer when they are invoked.<span class="Apple-converted-space"> </span><br class="">  * </p></font></div><div class=""><div class="" style="margin: 0px; font-stretch: normal; line-height: normal; background-color: rgba(255, 255, 255, 0.811765);"><span class="" style="font-variant-ligatures: no-common-ligatures;"><font class="" face="Courier"> *</font></span></div><div class="" style="margin: 0px; font-stretch: normal; line-height: normal; background-color: rgba(255, 255, 255, 0.811765);"><span class="" style="font-variant-ligatures: no-common-ligatures;"><font class="" face="Courier">#end[char]</font></span></div></div><br class=""></div></div></blockquote><span style="caret-color: rgb(0, 0, 0); font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; word-spacing: 0px; -webkit-text-stroke-width: 0px; background-color: rgb(255, 255, 255); text-decoration: none; float: none; display: inline !important;" class="">I agree that adding a statement class description will help (and avoid bug reports like this). Your looks okay and is consistent with the wording in the method description. A small suggestion is to start with "The methods defined by CharSequence ...".</span></div></blockquote></div><br class=""><div class="">All right, I’ll update the wording per your suggestion and file a CSR.</div><div class=""><br class=""></div><div class="">Thanks,</div><div class=""><br class=""></div><div class="">Brian</div></body></html>