OPENJPA-972 Committing code doc update and tests contributed by Donald Woods.

git-svn-id: https://svn.apache.org/repos/asf/openjpa/trunk@755614 13f79535-47bb-0310-9956-ffa450edef68

openjpa-persistence/src/main/java/org/apache/openjpa/persistence/PersistenceProductDerivation.java

@@ -633,6 +633,8 @@ public class PersistenceProductDerivation
                 return;
 
             switch (name.charAt(0)) {
+                // cases 'name' and 'transaction-type' are handled in startPersistenceUnit()
+                // case 'property' for 'properties' is handled in startElement()
                 case 'c': // class
                     _info.addManagedClassName(currentText());
                 case 'e': // exclude-unlisted-classes