<html><head></head><body><div class="ydpc79fa7b4yahoo-style-wrap" style="font-family:Helvetica Neue, Helvetica, Arial, sans-serif;font-size:13px;"><div></div>
<div dir="ltr" data-setdir="false"><div><div dir="ltr">Hello JLS Team,</div><div dir="ltr"><br clear="none" style="color: rgb(38, 40, 42); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;"></div></div>in the introduction block of Chapter 4 "<span>Types, Values, and Variables</span>" (page 53 of "<span>The Java Language Specification Java SE 18 Edition</span>") you can read: </div><div dir="ltr" data-setdir="false"><br></div><div dir="ltr" data-setdir="false">"</div><div dir="ltr" data-setdir="false"><span><i>The reference types (§4.3) are class types, interface types, and array types.</i></span><br></div><div dir="ltr" data-setdir="false">"</div><div dir="ltr" data-setdir="false"><br></div><div dir="ltr" data-setdir="false">so it seems that there are ONLY <b>three</b> kinds of reference types in Java, but in the paragraph "4.3 Reference Types and Values" you can read:</div><div dir="ltr" data-setdir="false"><br></div><div dir="ltr" data-setdir="false">"</div><div dir="ltr" data-setdir="false"><i>There are <b>FOUR</b> kinds of reference types: class types (§8.1), interface types (§9.1), <b>type variables (§4.4)</b>, and array types (§10.1).</i></div><div dir="ltr" data-setdir="false">"</div><div dir="ltr" data-setdir="false"><br></div><div dir="ltr" data-setdir="false">So the phrase in the <span><span style="color: rgb(0, 0, 0); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;">introduction block of Chapter 4 "</span><span style="color: rgb(0, 0, 0); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;">Types, Values, and Variables</span><span style="color: rgb(0, 0, 0); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;">" (page 53 of "</span><span style="color: rgb(0, 0, 0); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;">The Java Language Specification Java SE 18 Edition</span><span style="color: rgb(0, 0, 0); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;">") should be: </span></span></div><div dir="ltr" data-setdir="false"><br></div><div dir="ltr" data-setdir="false"><div><div dir="ltr" data-setdir="false" style="color: rgb(0, 0, 0); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;">"</div><div dir="ltr" data-setdir="false" style="color: rgb(0, 0, 0); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;"><i>The reference types (§4.3) are class types, interface types<span><i style="color: rgb(0, 0, 0); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;">, <b>type variables</b></i></span>, and array types.</i><br></div><div dir="ltr" data-setdir="false" style="color: rgb(0, 0, 0); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;">"</div></div><div><div dir="ltr" style="color: rgb(38, 40, 42); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;"><br></div><div dir="ltr" style="color: rgb(38, 40, 42); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;">Thank you,</div><div dir="ltr" style="color: rgb(38, 40, 42); font-family: Helvetica Neue, Helvetica, Arial, sans-serif;">Dmitri.</div></div><br></div><div dir="ltr" data-setdir="false"><br></div><div><br></div>
</div><div id="ydp170b5cffyahoo_quoted_3717129656" class="ydp170b5cffyahoo_quoted">
<div style="font-family:'Helvetica Neue', Helvetica, Arial, sans-serif;font-size:13px;color:#26282a;">
<div>
On Thursday, January 20, 2022, 04:27:47 PM GMT+1, Dmitri Cerkas <dmitricerkas@yahoo.com> wrote:
</div>
<div><br></div>
<div><br></div>
<div><div id="ydp170b5cffyiv9745685283"><div><div style="font-family:Helvetica Neue, Helvetica, Arial, sans-serif;font-size:13px;" class="ydp170b5cffyiv9745685283ydpf8456d29yahoo-style-wrap"><div id="ydp170b5cffyiv9745685283ydpf8456d29yiv0334632013"><div><div style="font-family:Helvetica Neue, Helvetica, Arial, sans-serif;font-size:13px;" class="ydp170b5cffyiv9745685283ydpf8456d29yiv0334632013ydp1e74487dyahoo-style-wrap"><div id="ydp170b5cffyiv9745685283ydpf8456d29yiv0334632013ydp1e74487dyiv6186602093"><div style="font-family:Helvetica Neue, Helvetica, Arial, sans-serif;font-size:13px;" class="ydp170b5cffyiv9745685283ydpf8456d29yiv0334632013ydp1e74487dyiv6186602093ydp41bcd7ccyahoo-style-wrap"><div></div>
<div dir="ltr">Hello JLS Team,</div><div dir="ltr"><br clear="none"></div><div dir="ltr">at the begining of the "3.10.2"<span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> paragraph</span></span> of Java Language Specification (starting from the version 6 and up) you can read:</div><div dir="ltr">"</div><div dir="ltr"><span><i>A floating-point literal has the following parts: a whole-number part, a decimal or hexadecimal point (represented by an ASCII period character), a fraction part, an exponent, and a type suffix</i></span></div><div dir="ltr">"</div><div dir="ltr"><br clear="none"></div><div dir="ltr">So this implies that decimal floating-point literal has the following parts:</div><div dir="ltr">1) <span><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">a whole-number part,</i></span></div><div dir="ltr"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">2) <span style="font-style:italic;"><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">a decimal point,</i></span></span></span></div><div dir="ltr"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">3)</span><i style="font-style:italic;color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> <span><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">a fraction part,</i></span></i></span></span></div><div dir="ltr"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">4) <span style="font-style:italic;"><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">an exponent,</i></span></span></span></span></span></div><div dir="ltr"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">5) <span style="font-style:italic;"><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">and a type suffix.</i></span></span></span></span></span></span></div><div dir="ltr"><br clear="none"></div><div dir="ltr">and below in the same<span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> "3.10.2"</span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> paragraph</span></span> you can read:</div><div dir="ltr">"<div><i>For decimal floating-point literals, at least one digit (in either the whole number or
the fraction part) and either a decimal point, an exponent, or a float type suffix are
required. <b>All other parts are optional.</b> The exponent, if present, is indicated by the
ASCII letter e or E followed by an optionally signed integer.</i></div>"</div><div dir="ltr"><br clear="none"></div><div dir="ltr">So parts that are <b>required</b> for decimal floating-point literals are:</div><div dir="ltr">a) <span><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">at least one digit (in either the whole number or the fraction part) </i></span></div><div dir="ltr"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><i> </i><u>(this corresponds to "</u></span><u>1) a whole-number part" and "<span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">3)</span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> a fraction part</span></span>" above)</u><i><br clear="none"></i><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">b) <span style="font-style:italic;"><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">and either a decimal point</i></span></span></div><div dir="ltr"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> <span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><u>(this corresponds to "</u></span><u style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">2) </span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">a decimal point</span></span>" above)</u><i> </i></span></span></div><div dir="ltr"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">c) <span style="font-style:italic;"><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">an exponent</i></span></span></span></div><div dir="ltr"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> (<span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><u>this corresponds to "</u></span><u style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">4) </span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">an exponent</span></span>" above)</u><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> </i></span></span></span></span></div><div dir="ltr">d) <span><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">a float type suffix</i></span></div><div dir="ltr"> <span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><u>(this corresponds to "</u></span><u style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">5) </span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">and a type suffix</span></span>" above)</u><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> </i></span></div><div dir="ltr"><br clear="none"></div><div dir="ltr">So the phrase "<i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><b>All other parts are optional.</b>"</i><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> is wrong because all parts are already listed.</span></div><div dir="ltr"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><br clear="none"></span></div><div dir="ltr"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">I thing that the phrase<span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> "</span><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><b>All other parts are optional.</b>"</i><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> should be removed and description of what is required for decimal floating-point literals becomes:</span></span></span></div><div dir="ltr"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span></span></span><div><div dir="ltr">"<div><i>For decimal floating-point literals, at least one digit (in either the whole number or the fraction part) and either a decimal point, an exponent, or a float type suffix are required. The exponent, if present, is indicated by the ASCII letter e or E followed by an optionally signed integer.</i></div>"</div><div dir="ltr"><br clear="none" style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"></div></div></div><div dir="ltr"><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span></span></span><div><div dir="ltr" style="color:rgb(38, 40, 42);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">Thank you,</div><div dir="ltr" style="color:rgb(38, 40, 42);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">Dmitri.</div></div></div><div dir="ltr"><br clear="none"></div><div><br clear="none"></div>
</div></div></div></div></div></div><div id="ydp170b5cffyiv9745685283yqt98510" class="ydp170b5cffyiv9745685283yqt2939800396"><div id="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013yqt81388" class="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013yqt0129204607"><div id="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093yqt37187" class="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093yqt6085151268"><div id="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yahoo_quoted_2873752249" class="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yahoo_quoted">
<div style="font-family:'Helvetica Neue', Helvetica, Arial, sans-serif;font-size:13px;color:#26282a;">
<div>
On Tuesday, January 11, 2022, 11:56:52 AM GMT+1, Dmitri Cerkas <dmitricerkas@yahoo.com> wrote:
</div>
<div><br clear="none"></div>
<div><br clear="none"></div>
<div><div id="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624"><div><div style="font-family:Helvetica Neue, Helvetica, Arial, sans-serif;font-size:13px;" class="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624ydpe1351efyahoo-style-wrap"><div id="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624ydpe1351efyiv0297203254"><div style="font-family:Helvetica Neue, Helvetica, Arial, sans-serif;font-size:13px;" class="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624ydpe1351efyiv0297203254ydp96adc7a2yahoo-style-wrap"><div></div>
<div dir="ltr">Hello JLS Team,</div><div dir="ltr"><br clear="none"></div><div dir="ltr">if you look at "<span>Table of Contents</span>" of the "Java Language Specification" and, in particular, at the structure of Chapter 4 "<span>Types, Values, and Variables</span>", you can see the following substructure:</div><div dir="ltr"><br clear="none"></div><div dir="ltr">"</div><div dir="ltr"><div><div><i>4.2 Primitive Types and Values 54</i></div><div><i><span style="white-space:pre-wrap;"> </span>4.2.1 Integral Types and Values 55</i></div><div><i><span style="white-space:pre-wrap;"> </span>4.2.2 Integer Operations 55</i></div><div><i><span style="white-space:pre-wrap;"> </span>4.2.3 Floating-Point Types and Values 57</i></div><div><i><span style="white-space:pre-wrap;"> </span>4.2.4 Floating-Point Operations 59</i></div><div><i><span style="white-space:pre-wrap;"> </span>4.2.5 The boolean Type and boolean Values 61</i></div></div>"</div><div dir="ltr"><br clear="none"></div><div dir="ltr">, where: </div><div dir="ltr"><br clear="none"></div><div dir="ltr"> <div><div dir="ltr">1) "<span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><i>4.2.1 Integral Types and Values</i></span>" contains info about possible values of 5 integral types,</div><div dir="ltr">2) "<span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><i>4.2.2 Integer Operations</i></span>" tells about possible operations on integral values,</div><div dir="ltr">3) "<i><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">4.2.3 </span></span><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">Floating-Point Types and Values</span></span></i>" <span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> contains info about possible values of 2 floating-point types,</span></span> <br clear="none"></div></div><div><div dir="ltr">4) "<span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><i>4.2.4 Floating-Point Operations</i></span></span>" tells about possible operations on <span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">floating-point values.</span></span></div><div dir="ltr"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><br clear="none"></span></span></div><div dir="ltr"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">If you look, however, at the content of "<span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><i>4.2.5 The boolean Type and boolean Values</i></span></span>" you can note that this paragraph speak both: </span></span></div><div dir="ltr"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">1) about <span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">possible values of boolean type and </span></span></span></span></div><div dir="ltr"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">2) <span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">about possible operations on</span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"> <span><span style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">boolean type</span></span>.</span></span></span></span></span></span></div><div dir="ltr"><br clear="none" style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"></div></div><div dir="ltr"><span>I know this might sound too picky, but logically, the paragraph "<span><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">4.2.5</i></span>" should be: "<span><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;">4.2.5 The boolean Type, boolean Values <span><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><b>and </b><i style="color:rgb(0, 0, 0);font-family:Helvetica Neue, Helvetica, Arial, sans-serif;"><b>boolean operations</b>.</i></i></span></i></span>"</span><br clear="none"></div><br clear="none"></div><div dir="ltr">Thank you,</div><div dir="ltr">Dmitri.</div><div><br clear="none"></div><div><br clear="none"><br clear="none"></div>
</div></div></div><div id="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624yqt74478" class="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624yqt1811242782"><div id="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624ydp7c8e8e97yiv0297203254yqt96279" class="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624ydp7c8e8e97yiv0297203254yqt3579387436"><div id="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624ydp7c8e8e97yiv0297203254ydpea9ea8f4yahoo_quoted_1837155507" class="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624ydp7c8e8e97yiv0297203254ydpea9ea8f4yahoo_quoted">
<div style="font-family:'Helvetica Neue', Helvetica, Arial, sans-serif;font-size:13px;color:#26282a;">
<div>
On Tuesday, December 21, 2021, 07:05:19 PM GMT+1, Alex Buckley <alex.buckley@oracle.com> wrote:
</div>
<div><br clear="none"></div>
<div><br clear="none"></div>
<div><div dir="ltr"> From your mention of pull requests, I presume you're thinking about the <br clear="none">OpenJDK source code hosted at <a shape="rect" href="https://github.com/openjdk/jdk/" rel="nofollow" target="_blank">https://github.com/openjdk/jdk/</a><br clear="none"><br clear="none">You can make pull requests against that repo to improve the Java API <br clear="none">specs -- "the javadoc" -- which might be what you mean by "Java <br clear="none">documentation". Here's a recent example of someone doing that:<br clear="none"><br clear="none"> <a shape="rect" href="https://github.com/openjdk/jdk/pull/6076" rel="nofollow" target="_blank">https://github.com/openjdk/jdk/pull/6076</a><br clear="none"><br clear="none">To learn more about contributing to OpenJDK, please see:<br clear="none"><br clear="none"> <a shape="rect" href="https://openjdk.java.net/guide/" rel="nofollow" target="_blank">https://openjdk.java.net/guide/</a><br clear="none"><br clear="none">You may wish to mail the `discuss` list at OpenJDK to ask for help <br clear="none">getting started with changes to the API specs:<br clear="none"><br clear="none"> <a shape="rect" href="https://mail.openjdk.java.net/mailman/listinfo/discuss" rel="nofollow" target="_blank">https://mail.openjdk.java.net/mailman/listinfo/discuss</a><br clear="none"><br clear="none">The Java Language Specification and the JVM Specification are not part <br clear="none">of OpenJDK. They are not hosted on Github.com and Oracle does not <br clear="none">support making pull requests against them. Please use the list mentioned <br clear="none">in the "Feedback" section to report technical errors in the JLS.<br clear="none"><br clear="none">Alex<br clear="none"><br clear="none">On 12/21/2021 7:51 AM, Dmitri Cerkas wrote:<br clear="none">> Alex, thank you very much for quick response!<br clear="none">> <br clear="none">> I see on "<a shape="rect" href="https://jcp.org/en/participation/membership " rel="nofollow" target="_blank">https://jcp.org/en/participation/membership </a><br clear="none">> <<a shape="rect" href="https://jcp.org/en/participation/membership" rel="nofollow" target="_blank">https://jcp.org/en/participation/membership</a>>" page that there is the <br clear="none">> opportunity to become a member of JCP program (the same I'm member of <br clear="none">> "Jakarta EE" Community).<br clear="none">> <br clear="none">> May be this solution is best - I found various imperfections carefully <br clear="none">> reading "The Java Language Specification" and opening direct Pull <br clear="none">> Requests as JCP member is more practical I think. In addition (as a <br clear="none">> member) I could improve Java documentation in general, as I did and do <br clear="none">> for "Jakarta EE".<br clear="none">> <br clear="none">> Thank you again!<br clear="none">> <br clear="none">> Have a nice day,<br clear="none">> Dmitri.<br clear="none">> <br clear="none">> <br clear="none">> <br clear="none">> <br clear="none">> On Monday, December 20, 2021, 06:10:24 PM GMT+1, Alex Buckley <br clear="none">> <<a shape="rect" href="mailto:alex.buckley@oracle.com" rel="nofollow" target="_blank">alex.buckley@oracle.com</a>> wrote:<br clear="none">> <br clear="none">> <br clear="none">> Dmitri,<br clear="none">> <br clear="none">> Please see JLS section 1.6 "Feedback":<br clear="none">> <br clear="none">> <a shape="rect" href="https://docs.oracle.com/javase/specs/jls/se17/html/jls-1.html#jls-1.6 " rel="nofollow" target="_blank">https://docs.oracle.com/javase/specs/jls/se17/html/jls-1.html#jls-1.6 </a><br clear="none">> <<a shape="rect" href="https://docs.oracle.com/javase/specs/jls/se17/html/jls-1.html#jls-1.6" rel="nofollow" target="_blank">https://docs.oracle.com/javase/specs/jls/se17/html/jls-1.html#jls-1.6</a>><br clear="none">> <br clear="none">> Alex<br clear="none">> <br clear="none">> On 12/20/2021 5:42 AM, Bernard Traversat wrote:<br clear="none">> > FYI,<br clear="none">> ><br clear="none">> > Cheers,<br clear="none">> ><br clear="none">> > B.<br clear="none">> ><br clear="none">> > On 12/20/21, 2:58 AM, "Dmitri Cerkas" <<a shape="rect" href="mailto:dmitricerkas@yahoo.com" rel="nofollow" target="_blank">dmitricerkas@yahoo.com</a> <br clear="none">> <mailto:<a shape="rect" href="mailto:dmitricerkas@yahoo.com" rel="nofollow" target="_blank">dmitricerkas@yahoo.com</a>><br clear="none">> > <mailto:<a shape="rect" href="mailto:dmitricerkas@yahoo.com" rel="nofollow" target="_blank">dmitricerkas@yahoo.com</a> <mailto:<a shape="rect" href="mailto:dmitricerkas@yahoo.com" rel="nofollow" target="_blank">dmitricerkas@yahoo.com</a>>>> wrote:<div id="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624ydp7c8e8e97yiv0297203254ydpea9ea8f4yqtfd82902" class="ydp170b5cffyiv9745685283ydp97302f3cyiv0334632013ydpc7967164yiv6186602093ydp83ba7740yiv1217333624ydp7c8e8e97yiv0297203254ydpea9ea8f4yqt9456362222"><br clear="none">> ><br clear="none">> > Hello Community,<br clear="none">> ><br clear="none">> > I have some small suggestions on "Java Language Specification" content<br clear="none">> > improvements. How can I communicate them to you? Do you have a<br clear="none">> > repository (GitHub, for example) where I could post an Issue or a Pull<br clear="none">> > Request?<br clear="none">> ><br clear="none">> > Thank you very much!<br clear="none">> ><br clear="none">> > Have a nice day,<br clear="none">> ><br clear="none">> > Dmitri.<br clear="none">> ><br clear="none"></div></div></div>
</div>
</div></div></div></div></div></div>
</div>
</div></div></div></div></div></div></div>
</div>
</div></body></html>