Re: RFR: 8283606: Tests may fail with zh locale on MacOS [v2]

2022-05-03 Thread Roger Riggs
On Thu, 24 Mar 2022 17:30:22 GMT, Vikey Chen wrote: >> From the test doc of openjdk >> https://openjdk.java.net/groups/build/doc/testing.html >>> If your locale is non-US, some tests are likely to fail. To work around >>> this you can set the locale to US. On Unix platforms simply setting >>>

Re: RFR: 8283606: Tests may fail with zh locale on MacOS [v4]

2022-03-28 Thread Roger Riggs
On Mon, 28 Mar 2022 17:00:39 GMT, Vikey Chen wrote: >> From the test doc of openjdk >> https://openjdk.java.net/groups/build/doc/testing.html >>> If your locale is non-US, some tests are likely to fail. To work around >>> this you can set the locale to US. On Unix platforms simply setting >>>

Re: RFR: 8283606: Tests may fail with zh locale on MacOS [v2]

2022-03-28 Thread Roger Riggs
On Thu, 24 Mar 2022 17:30:22 GMT, Vikey Chen wrote: >> From the test doc of openjdk >> https://openjdk.java.net/groups/build/doc/testing.html >>> If your locale is non-US, some tests are likely to fail. To work around >>> this you can set the locale to US. On Unix platforms simply setting >>>

Re: RFR: 8283606: Tests may fail with zh locale on MacOS

2022-03-24 Thread Roger Riggs
On Wed, 23 Mar 2022 15:34:43 GMT, Vikey Chen wrote: > I have run tier-1 test with `JTREG="VM_OPTIONS=-Duser.language=en > -Duser.country=US"`, some tests still fail because of default locale, Most of > them are langtools tests. > > On MacOS 12.1. Can you look into why these tests do not fai

Re: RFR: 8282657: Code cleanup: removing double semicolons at the end of lines

2022-03-04 Thread Roger Riggs
On Fri, 28 Jan 2022 14:39:31 GMT, Matteo Baccan wrote: > Hi > > I have reviewed the code for removing double semicolons at the end of lines > > all the best > matteo Marked as reviewed by rriggs (Reviewer). - PR: https://git.openjdk.java.net/jdk/pull/7268

Re: RFR: 8282657: Code cleanup: removing double semicolons at the end of lines

2022-03-04 Thread Roger Riggs
On Fri, 28 Jan 2022 14:39:31 GMT, Matteo Baccan wrote: > Hi > > I have reviewed the code for removing double semicolons at the end of lines > > all the best > matteo We usually request that these be be broken up by area to attract the appropriate reviewers and avoid eye-strain. The client mo

Re: RFR: JDK-8234682: The order of @param in the generated docs should match the method signature

2022-01-12 Thread Roger Riggs
On Wed, 12 Jan 2022 08:40:08 GMT, Hannes Wallnöfer wrote: > Please review a change in how documentation from `@param` tags is generated. > > The old code generates parameter documentation for each `@param` in the order > in which the tags occur in the comment, then adds documentation from > i

Re: RFR: 8273609: Fix trivial doc typos in the compiler area

2021-09-10 Thread Roger Riggs
On Fri, 10 Sep 2021 17:39:44 GMT, Pavel Rappo wrote: > 8273609: Fix trivial doc typos in the compiler area Marked as reviewed by rriggs (Reviewer). - PR: https://git.openjdk.java.net/jdk/pull/5471

Re: Draft JEP for upcoming work on snippets

2021-01-26 Thread Roger Riggs
Hi, A very useful proposal. A few comments, I expect these will be addressed as the development proceeds. * In the @snippet tag, can the "class=" indicate a module name in addition to the class name? * Does the "lang=" tag need to be a closed set; if it were open, it would give more f

Re: RFR: 8252180: [JEP 390] Deprecate wrapper class constructors for removal

2020-12-07 Thread Roger Riggs
On Sat, 5 Dec 2020 01:46:31 GMT, Dan Smith wrote: > Integration of [JEP 390](https://bugs.openjdk.java.net/browse/JDK-8249100). > > Development has been broken into 5 tasks, each with its own JBS issue: > - Deprecate wrapper class constructors for removal (rriggs) > - Revise "value-based class"

Re: RFR: JDK-8075778: Add javadoc tag to avoid duplication of return information in simple situations.

2020-12-02 Thread Roger Riggs
On Tue, 1 Dec 2020 17:09:25 GMT, Pavel Rappo wrote: >> /** >> * {@return the result} Optional additional text. >> */ >> ``` >> The java source looks a bit odd/unusual because the "first sentence" does >> not appear to end with a period. >> Though it seems like a convenience to include the '

Re: RFR: JDK-8075778: Add javadoc tag to avoid duplication of return information in simple situations.

2020-11-27 Thread Roger Riggs
On Fri, 20 Nov 2020 17:15:22 GMT, Jonathan Gibbons wrote: > This change extends the functionality of the `@return` tag so that it can > also be used as an inline tag in the first sentence of a description. > > The goal is to be able to simplify the following common pattern: > > /** >

Re: Musings on 8232447: The javadoc parser ends the first sentence of a comment too soon

2020-05-13 Thread Roger Riggs
On 5/13/20 2:41 PM, Pavel Rappo wrote: Thanks for chiming in, Roger. On 13 May 2020, at 18:30, Roger Riggs wrote: Hi, The first sentence is not just any old sentence. It has a very specific role to play in the javadoc both to introduce the class, method, feild, etc. AND to stand independent

Re: Musings on 8232447: The javadoc parser ends the first sentence of a comment too soon

2020-05-13 Thread Roger Riggs
Hi, The first sentence is not just  any old sentence. It has a very specific role to play in the javadoc both to introduce the class, method, feild, etc. AND to stand independently when used in a summary. That places a responsibility on the author to craft the sentence for those purposes. The

Re: RFR 15 8225319: Remove the RMI static stub compiler rmic

2020-04-06 Thread Roger Riggs
ot;sun.rmi.rmic.RMIGenerator", "sun.rmi.rmic.Main"}, ./test/hotspot/jtreg/runtime/cds/appcds/test-classes/JimageClassPackage.java "sun/rmi/rmic/Main", ./test/hotspot/jtreg/runtime/cds/appcds/SharedPackages.java Thanks, Amy On 4/3/20 11:43 PM, Roger Riggs wrote: Please

Re: RFR [15] 8239487: Better links generation for system properties found in HTML files

2020-03-09 Thread Roger Riggs
opefully, we'll figure out how to convey the fact that there are missing s to the user real soon. -Pavel On 6 Mar 2020, at 19:10, Roger Riggs wrote: Hi Pavel, The System Properties page looks better with the links qualified by class or package, or the html document title. Developers will

Re: RFR [15] 8239487: Better links generation for system properties found in HTML files

2020-03-06 Thread Roger Riggs
Hi Pavel, The System Properties page looks better with the links qualified by class or package, or the html document title. Developers will want to have a on their document so the properties listing is most informative. Thanks, Roger On 3/6/20 7:51 AM, Pavel Rappo wrote: Hello, Please rev

Re: RFR: JDK-8223536 jdk/javadoc/doclet/MetaTag/MetaTag.java still fails when run across midnight

2020-01-15 Thread Roger Riggs
A bold suggestion is to switch to using java.time and move on from the legacy java.Date. On 1/14/20 7:23 PM, Jonathan Gibbons wrote: Please review a fix for a problem that occurs when a test is run across midnight. Although it is difficult to confirm the root cause, and equally difficult to

Re: RFR [14] 8215038: Add a page that lists all system properties

2019-12-11 Thread Roger Riggs
Hi, For the links to the .html files, it would look better if it extracted the xx from the page to use for the "Referenced In" column.  It fit better with the package and class references. And yes, any index is better than none. Thanks, Roger On 12/11/19 12:26 PM, Pavel Rappo wrote: Hello

Re: Request for Review JDK-8004353 - Generated html is wrong for overview.html

2013-01-31 Thread Roger Riggs
Thank you. On 1/31/2013 11:34 AM, Jonathan Gibbons wrote: On 01/31/2013 07:54 AM, Roger Riggs wrote: (Retry, first try may have gotten stuck in the non-subscriber filter) Please review

Request for Review JDK-8004353 - Generated html is wrong for overview.html

2013-01-31 Thread Roger Riggs
Please review this fix: JDK-8004353: Generated html is wrong for overview.html; content has incorrect css footer class The webrev includes a description of the problem and solution plus a test. http://cr.openjdk.java.net/~rriggs/webrev-t8004353/ Thanks, Roger

Request for Review JDK-8004353 - Generated html is wrong for overview.html

2013-01-31 Thread Roger Riggs
(Retry, first try may have gotten stuck in the non-subscriber filter) Please review this fix: JDK-8004353: Generated html is wrong for overview.html; content has incorrect css footer class The webrev includes a description of the problem and solution plus a test. http://cr.openjdk.java.net/~r