Proposal: #NonHierarchicalLayers

[Alan Bateman]

On 08/11/2016 15:37, Thomas Watson wrote:

> :
> Overall the API works well for scenarios that map existing module systems
> to JPMS.  I have questions about the new javadoc for the static methods on
> Layer and Configuration.  I would have expected the javadoc for the static
> vs. the single parent non-static methods to be largely identical.  But
> there seems to be more details on what causes errors on the static methods
> as well as additional API notes related to atomic behavior.  Is this an
> oversight, or are there more error conditions for the static methods?
>
> Should the non-static methods be updated to state the behavior is
> equivalent to calling the static method with this Configuration/Layer as
> the single parent?
>
The instance methods are specified to be equivalent to invoking the 
static methods with a single parent (to avoid repeating the javadoc) but 
I think we can make this a bit clearer.

-Alan