RFR: JDK-8238503 Remove unused field and accessor for docLocale from ToolOptions

2020-02-04 Thread Jonathan Gibbons
Please review a cleanup to remove some dead code and improve comments for the tool options that are implemented in Start.preprocess. No intentional change in functionality. -- Jon JBS: https://bugs.openjdk.java.net/browse/JDK-8238503 Webrev: http://cr.openjdk.java.net/~jjg/8238503/webrev/index.

Re: RFR [15] 8238467: Clean up annotations on overridden/implemented methods

2020-02-04 Thread Jonathan Gibbons
Interesting ... in the old doclet, both were IllegalArgumentException. I'm OK with fixing the javadoc; but we should not change the method signatures in this changeset, which is about @Override and {@inheritDoc} --Jon On 2/4/20 1:46 PM, Pavel Rappo wrote: Further investigation suggests that

Re: RFR [15] 8238467: Clean up annotations on overridden/implemented methods

2020-02-04 Thread Pavel Rappo
Further investigation suggests that this artifact (a mistyped exception name) was introduced in changeset: 35426:374342e56a56 user:ksrini date:Sat Nov 28 18:52:17 2015 -0800 summary: 8035473: [javadoc] Revamp the existing Doclet APIs -Pavel > On 4 Feb 2020,

Re: RFR [15] 8238467: Clean up annotations on overridden/implemented methods

2020-02-04 Thread Pavel Rappo
> On 4 Feb 2020, at 19:40, Jonathan Gibbons wrote: > > Approved. Thanks for doing this. It may cause some short term conflicts, > but is otherwise worthwhile. > > You deleted comments containing @throws in a few places, but it seems like > nothing significant was added, so OK. Thanks for revie

Re: RFR [15] 8238291: Fix inconsistencies in the format of the index files

2020-02-04 Thread Jonathan Gibbons
On 2/4/20 12:16 PM, Pavel Rappo wrote: On 3 Feb 2020, at 19:58, Jonathan Gibbons wrote: Approved, but for bonus points, add a comment to SearchIndexItem.toString listing all the letters we use and what they are used for. If it's okay I'd prefer not to do that. That method is pretty self-desc

Re: RFR [15] 8238291: Fix inconsistencies in the format of the index files

2020-02-04 Thread Pavel Rappo
> On 3 Feb 2020, at 19:58, Jonathan Gibbons wrote: > > Approved, but for bonus points, add a comment to SearchIndexItem.toString > listing all the letters we use and what they are used for. If it's okay I'd prefer not to do that. That method is pretty self-describing and is not a part of public

Re: RFR: JDK-8222793 Javadoc tool ignores "-locale" param and uses default locale for all messages and texts

2020-02-04 Thread Jonathan Gibbons
Updated webrev. Only minor changes: 1. Improved comments on {Base,Html}Configuration 2. Changed locale in test to en_GB_ALLCAPS 3. Filed JDK-8238503 for ToolOption cleanup. -- Jon JBS: https://bugs.openjdk.java.net/browse/JDK-8222793 Webrev: http://cr.openjdk.java.net/~jjg/8222793/webrev.01/

Re: RFR [15] 8238467: Clean up annotations on overridden/implemented methods

2020-02-04 Thread Jonathan Gibbons
Approved.  Thanks for doing this. It may cause some short term conflicts, but is otherwise worthwhile. You deleted comments containing @throws in a few places, but it seems like nothing significant was added, so OK. -- Jon On 2/4/20 5:21 AM, Pavel Rappo wrote: Hello, Please review the change

Re: RFR: JDK-8222793 Javadoc tool ignores "-locale" param and uses default locale for all messages and texts

2020-02-04 Thread Pavel Rappo
1. Javadoc comments for constructors of the HtmlConfiguration and BaseConfiguration classes could be updated. The comment for the HtmlConfiguration ctor could be deleted, as there's not much value in it. The comment for the BaseConfiguration ctor should better be updated to reflect the change in t

Re: RFR [15] 8237909: Remove zipped index files feature

2020-02-04 Thread Pavel Rappo
> On 3 Feb 2020, at 19:06, Jonathan Gibbons wrote: > > I concur with all the preceding discussion, about removing the zipped-files > feature, and about the desirability of asynchronous loading if that is > practical. > > Separate RFE: the UI should indicate if/while the results are incomplete

RFR [15] 8238467: Clean up annotations on overridden/implemented methods

2020-02-04 Thread Pavel Rappo
Hello, Please review the change for https://bugs.openjdk.java.net/browse/JDK-8238467: http://cr.openjdk.java.net/~prappo/8238467/webrev.00/ This is a blanket cleanup. The change adds missing @java.lang.Override annotations and removes some of the {@inheritDoc} tags. The removed {@inheritDoc}