On Mon, 13 Mar 2023 10:03:52 GMT, Alan Bateman <al...@openjdk.org> wrote:
>> Joe Wang has updated the pull request incrementally with one additional
>> commit since the last revision:
>>
>> clean up tests; fix copy&paste error.
>
> src/java.xml/share/classes/javax/xml/catalog/CatalogFeatures.java line 183:
>
>> 181: * <a
>> href="../../../module-summary.html#ConfigurationFile">configuration file</a>.
>> 182: * In case of multiple interfaces, the latest in a procedure shall take
>> preference.
>> 183: * For {@link Feature#FILES}, this means that the URI(s) specified
>> through the methods
>
> "multiple interfaces" and "the latest in a procedure" aren't very clear here.
> If the setup for this section documents the precedence order more clearly
> then it will make it easier to word this section.
We have two options here:
- drop the discussion about "multiple interfaces", and leave it to the
CatalogManager to make it clear;
- add some sample code
While we'll be adding a general Scope and Order, this is specific to the
Catalog API. I'll try option 1.
-------------
PR: https://git.openjdk.org/jdk/pull/12985
