RFR [15] 8236435: Fix typos in javac area

Jonathan Gibbons jonathan.gibbons at oracle.com
Fri Dec 20 17:04:01 UTC 2019


Pavel,

Thanks for looking at this. It was worth reading if only for the 
occasional amusement at some of the typos, and occasional guilt at 
recognizing some that I probably made. Here are some notes; none need a 
followup webrev.

I've reviewed all the individual changes, but since neither of us work 
routinely on all the javac source code, I would recommend also getting 
buy-in from an active javac developer that a widespread update like this 
is acceptable.

-- Jon


In 
src/jdk.compiler/share/classes/com/sun/tools/javac/comp/ArgumentAttr.java,
you missed a typo ;-)  "influences" should be "influenced"

In Pretty.java, the guideline is to avoid use of XXX and use something 
like XYZ instead.

- /** Exception to propogate IOException through visitXXX methods */
+ /** Exception to propagate IOException through visitXXX methods */

In sjavac Source.java, "lets" should be "let's"

- // Oups, the source is already added, could be ok, could be not, lets 
check.
+ // Oops, the source is already added, could be ok, could be not, lets 
check.


-- Jon


On 12/20/19 7:44 AM, Pavel Rappo wrote:
> Hello,
>
> Please review the following change for https://bugs.openjdk.java.net/browse/JDK-8236435:
>
>      http://cr.openjdk.java.net/~prappo/8236435/webrev.00/
>
> I've been reading up on the javadoc code and comments. At one point, jumping
> through the links, I reached the javax.tools.DocumentationTool and
> com.sun.tools.javac.util.ClientCodeException, which reside in java.compiler and
> jdk.compiler respectively. I found a couple of typos there and fixed them.
>
> One thing led to another and half an hour later I found myself compulsively
> checking the full javac code base for typos and spelling. Sigh.
>
> Long story short, I just went ahead and fixed as many issues as I could in one
> sitting. There was a lot.
>
> On the bright side, this patch doesn't involve any code changes (except for
> spelling in internal variables and methods' parameters), addresses aesthetic
> issues, readability, helps with searches and assists IDEs to pick up usages
> more reliably when refactoring (e.g. renaming).
>
> The initial concern with DocumentationTool turned out to be more subtle and I
> decided not to include it in this patch. It is definitely not just a typo and
> might require a CSR.
>
> Please review at your convenience. Hopefully, if there are false positives,
> you'll catch them.
>
> I suggest reviewing this change using a diff tool with a character-level
> resolution. That is, a tool capable of highlighting mismatching characters in
> lines that differ.
>
> All test/langtools tests pass. Copyright years will be fixed before the push.
>
> Thanks,
> -Pavel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://mail.openjdk.java.net/pipermail/compiler-dev/attachments/20191220/ed613ce6/attachment-0001.htm>


More information about the compiler-dev mailing list