[eclipse-pmc] API spec change/clarification

[Darin Wright <Darin_Wright@xxxxxxxxxx>]

Debug would like approval for the API
specification change/clarification, as described in the following bug:

        https://bugs.eclipse.org/bugs/show_bug.cgi?id=182414

We are working a feature to allow Installed
JREs to be derived from .ee definition files (bug 181026). In order to
complete this feature, we need to allow VM install locations to be represented
as files as well as directories. Until now, the javadoc specified the install
location was a directory (home directory for a JRE). This is a binary compatible
API change. The javadoc would be enhanced to clarify that the java.io.File
describing an install location can be a file or directory.

RISK: Minimal:
Code that accessed the vm install location
should not need to change (it still works on java.io.Files). However, existing
code could encounter error conditions (for example, retrieving files from
a directory will not work when the file is not a directory). Code needed
to be resilliant to such conditions in the past, so this should have minimal
effect on clients.

Darin Wright