--- old/src/java.xml.ws/share/classes/javax/xml/soap/SOAPConnectionFactory.java 2015-07-08 13:25:10.000000000 +0200 +++ new/src/java.xml.ws/share/classes/javax/xml/soap/SOAPConnectionFactory.java 2015-07-08 13:25:10.000000000 +0200 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2004, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2004, 2015, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -26,38 +26,38 @@ package javax.xml.soap; /** - * A factory for creating SOAPConnection objects. Implementation of this class - * is optional. If SOAPConnectionFactory.newInstance() throws an + * A factory for creating {@code SOAPConnection} objects. Implementation of this class + * is optional. If {@code SOAPConnectionFactory.newInstance()} throws an * UnsupportedOperationException then the implementation does not support the * SAAJ communication infrastructure. Otherwise {@link SOAPConnection} objects - * can be created by calling createConnection() on the newly - * created SOAPConnectionFactory object. + * can be created by calling {@code createConnection()} on the newly + * created {@code SOAPConnectionFactory} object. * * @since 1.6 */ public abstract class SOAPConnectionFactory { /** - * A constant representing the default value for a SOAPConnection + * A constant representing the default value for a {@code SOAPConnection} * object. The default is the point-to-point SOAP connection. */ static final String DEFAULT_SOAP_CONNECTION_FACTORY = "com.sun.xml.internal.messaging.saaj.client.p2p.HttpSOAPConnectionFactory"; /** - * A constant representing the SOAPConnection class. + * A constant representing the {@code SOAPConnection} class. */ static private final String SF_PROPERTY = "javax.xml.soap.SOAPConnectionFactory"; /** * Creates an instance of the default - * SOAPConnectionFactory object. + * {@code SOAPConnectionFactory} object. * * @return a new instance of a default - * SOAPConnectionFactory object + * {@code SOAPConnectionFactory} object * * @exception SOAPException if there was an error creating the - * SOAPConnectionFactory + * {@code SOAPConnectionFactory} * * @exception UnsupportedOperationException if newInstance is not * supported. @@ -76,12 +76,12 @@ } /** - * Create a new SOAPConnection. + * Create a new {@code SOAPConnection}. * - * @return the new SOAPConnection object. + * @return the new {@code SOAPConnection} object. * * @exception SOAPException if there was an exception creating the - * SOAPConnection object. + * {@code SOAPConnection} object. */ public abstract SOAPConnection createConnection() throws SOAPException;