For the changes to the Java system, there are a number of steps needed for existing installs to get switched over. We have maintained this information in our wiki: https://projects.gentooexperimental.org/expj/wiki/Java_Upgrade_Guide We are currently in the process of GuideXMLifying it.
XMLified version is in svn at: https://svn.gentooexperimental.org/svn/java/migration/docs/java-upgrade.xml
I've put this up onto the Java project page: http://www.gentoo.org/proj/en/java/java-upgrade.xml
Created attachment 90158 [details] java-upgrade.xml Proper guidexml, minor typo, grammar fixes too. Look good?
nichoj committed the edited version to /proj/en/java. all fixed; thanks to the java team for some great docs. :)