jvmfwk/README

   1 Wrappers so you can use all the Java Runtime Environments with their slightly incompatible APIs with more ease.
   2
   3 Used to use an over-engineered "plugin" mechanism although there was only one
   4 "plugin", called "sunmajor", that handles all possible JREs.
   5
   6 IMPORTANT:  The <updated> element in vmfwk/distributions/OpenOfficeorg/javavendors_*.xml files
   7 should only be updated for incompatible changes, not for compatible ones.  As stated in the commit
   8 message of <https://gerrit.libreoffice.org/#/c/69730/> "javavendors_*.xml <updated> should not have
   9 been updated...":  "Changing <updated> causes jfw_startVM and jfw_getSelectedJRE (both
  10 jvmfwk/source/framework.cxx) to fail with JFW_E_INVALID_SETTINGS, which in turn causes functionality
  11 that requires a JVM to issue a GUI error dialog stating that the user must select a new JRE in the
  12 Options dialog.  While that behavior makes sense if a JRE was selected that would no longer be
  13 supported by the modified javavendors_*.xml, it is just annoying if an already selected JRE is still
  14 supported.  And a compatible change to javavendors_*.xml implies that an already selected JRE will
  15 still be supported."