update properties files with wording suggestions; move summary to aft…

…er the test tag

src/java.xml/share/conf/jaxp-strict.properties.template

@@ -33,15 +33,15 @@
 #
 # This property determines whether XSLT and XPath extension functions are allowed.
 # The value type is boolean and the default value is true (allowing
-# extension functions). The following entry would override the default value and
-# disallow extension functions:
+# extension functions). The following entry overrides the default value and
+# disallows extension functions:
 #
 jdk.xml.enableExtensionFunctions=false
 #
 #
 # Overriding the default parser:
 #
-# This property allows using a third party implementation to override the default
+# This property allows a third party implementation to override the default
 # parser provided by the JDK. The value type is boolean and the default value is
 # false, disallowing overriding the default parser. The setting below reflects
 # the default property setting:
@@ -57,15 +57,15 @@ jdk.xml.overrideDefaultParser=false
 #     ignore -- indicates that the reference is skipped
 #     strict -- indicates that the resolver should throw a CatalogException
 #
-# The following setting would cause the resolve to throw a CatalogException when
-# external references are not resolved by a user-defined resolver or catalog,
-# or the JDKCatalog:
+# The following setting causes the default CatalogResolver to throw a CatalogException
+# when external references are not resolved by a user-defined resolver or catalog,
+# or the built-in Catalog:
 jdk.xml.jdkcatalog.resolve=strict
 #
 # Implementation Specific Properties - DTD
 #
-# This property instructs the parsers to: deny, ignore or allow DTD processing.
-# The following setting would cause the parser to reject DTD by throwing an exception.
+# This property instructs the parsers to deny, ignore or allow DTD processing.
+# The following setting causes the parser to reject DTDs by throwing an exception.
 # jdk.xml.dtd.support=deny
 #
 # The following setting permits the processor to continue processing DTDs. Note

src/java.xml/share/conf/jaxp.properties

@@ -31,7 +31,7 @@
 #
 # The format of an entry is key=value where the key is the fully qualified name
 # of the factory and value that of the implementation class. The following entry
-# set a DocumentBuilderFactory implementation class:
+# sets a DocumentBuilderFactory implementation class:
 #
 # javax.xml.parsers.DocumentBuilderFactory=com.sun.org.apache.xerces.internal.jaxp.DocumentBuilderFactoryImpl
 #
@@ -49,7 +49,7 @@
 #
 # For example, the RESOLVE property in CatalogFeatures has an associated system
 # property called javax.xml.catalog.resolve. An entry for the RESOLVE property in the
-# configuration file would therefore use javax.xml.catalog.resolve as the key, that
+# configuration file therefore uses javax.xml.catalog.resolve as the key, that
 # is:
 #     javax.xml.catalog.resolve=strict
 #
@@ -58,15 +58,15 @@
 #
 # This property determines whether XSLT and XPath extension functions are allowed.
 # The value type is boolean and the default value is true (allowing
-# extension functions). The following entry would override the default value and
-# disallow extension functions:
+# extension functions). The following entry overrides the default value and
+# disallows extension functions:
 #
 # jdk.xml.enableExtensionFunctions=false
 #
 #
 # Overriding the default parser:
 #
-# This property allows using a third party implementation to override the default
+# This property allows a third party implementation to override the default
 # parser provided by the JDK. The value type is boolean and the default value is
 # false, disallowing overriding the default parser. The setting below reflects
 # the default property setting:
@@ -137,15 +137,15 @@ jdk.xml.overrideDefaultParser=false
 #     ignore -- indicates that the reference is skipped
 #     strict -- indicates that the resolver should throw a CatalogException
 #
-# The following setting would allow the resolution to continue in cases where
+# The following setting allows the resolution to continue in cases where
 # external references are not resolved by a user-defined resolver or catalog if
-# any, and the JDKCatalog:
+# any, and the built-in Catalog:
 jdk.xml.jdkcatalog.resolve=continue
 #
 # Implementation Specific Properties - DTD
 #
-# This property instructs the parsers to: deny, ignore or allow DTD processing.
-# The following setting would cause the parser to reject DTD by throwing an exception.
+# This property instructs the parsers to deny, ignore or allow DTD processing.
+# The following setting causes the parser to reject DTDs by throwing an exception.
 # jdk.xml.dtd.support=deny
 #
 # The following setting permits the processor to continue processing DTDs

test/jaxp/javax/xml/jaxp/unittest/common/config/ConfigFileTest.java

@@ -34,12 +34,12 @@
 
 /**
  * @test @bug 8330542
+ * @summary verifies the default JAXP configuration file jaxp.properties and
+ * strict template jaxp-strict.properties.template.
  * @library /javax/xml/jaxp/libs /javax/xml/jaxp/unittest
  * @modules java.xml/jdk.xml.internal
  * @run driver common.config.ConfigFileTest 0 // verifies jaxp.properties
  * @run driver common.config.ConfigFileTest 1 // verifies jaxp-strict.properties.template
- * @summary verifies the default JAXP configuration file jaxp.properties and
- * strict template jaxp-strict.properties.template.
  */
 public class ConfigFileTest {
     // system property for custom configuration file