--- old/src/java.xml.ws/share/classes/javax/xml/soap/Detail.java 2015-07-08 13:25:05.000000000 +0200 +++ new/src/java.xml.ws/share/classes/javax/xml/soap/Detail.java 2015-07-08 13:25:04.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 @@ -30,43 +30,43 @@ import javax.xml.namespace.QName; /** - * A container for DetailEntry objects. DetailEntry + * A container for {@code DetailEntry} objects. {@code DetailEntry} * objects give detailed error information that is application-specific and - * related to the SOAPBody object that contains it. + * related to the {@code SOAPBody} object that contains it. *

- * A Detail object, which is part of a SOAPFault - * object, can be retrieved using the method SOAPFault.getDetail. - * The Detail interface provides two methods. One creates a new - * DetailEntry object and also automatically adds it to - * the Detail object. The second method gets a list of the - * DetailEntry objects contained in a Detail + * A {@code Detail} object, which is part of a {@code SOAPFault} + * object, can be retrieved using the method {@code SOAPFault.getDetail}. + * The {@code Detail} interface provides two methods. One creates a new + * {@code DetailEntry} object and also automatically adds it to + * the {@code Detail} object. The second method gets a list of the + * {@code DetailEntry} objects contained in a {@code Detail} * object. *

- * The following code fragment, in which sf is a SOAPFault - * object, gets its Detail object (d), adds a new - * DetailEntry object to d, and then gets a list of all the - * DetailEntry objects in d. The code also creates a - * Name object to pass to the method addDetailEntry. - * The variable se, used to create the Name object, - * is a SOAPEnvelope object. - *

+ * The following code fragment, in which sf is a {@code SOAPFault}
+ * object, gets its {@code Detail} object (d), adds a new
+ * {@code DetailEntry} object to d, and then gets a list of all the
+ * {@code DetailEntry} objects in d. The code also creates a
+ * {@code Name} object to pass to the method {@code addDetailEntry}.
+ * The variable se, used to create the {@code Name} object,
+ * is a {@code SOAPEnvelope} object.
+ * {@code
  *    Detail d = sf.getDetail();
  *    Name name = se.createName("GetLastTradePrice", "WOMBAT",
  *                                "http://www.wombat.org/trader");
  *    d.addDetailEntry(name);
  *    Iterator it = d.getDetailEntries();
- * 
+ * } * * @since 1.6 */ public interface Detail extends SOAPFaultElement { /** - * Creates a new DetailEntry object with the given - * name and adds it to this Detail object. + * Creates a new {@code DetailEntry} object with the given + * name and adds it to this {@code Detail} object. * - * @param name a Name object identifying the - * new DetailEntry object + * @param name a {@code Name} object identifying the + * new {@code DetailEntry} object * * @exception SOAPException thrown when there is a problem in adding a * DetailEntry object to this Detail object. @@ -76,12 +76,12 @@ public DetailEntry addDetailEntry(Name name) throws SOAPException; /** - * Creates a new DetailEntry object with the given - * QName and adds it to this Detail object. This method + * Creates a new {@code DetailEntry} object with the given + * QName and adds it to this {@code Detail} object. This method * is the preferred over the one using Name. * - * @param qname a QName object identifying the - * new DetailEntry object + * @param qname a {@code QName} object identifying the + * new {@code DetailEntry} object * * @exception SOAPException thrown when there is a problem in adding a * DetailEntry object to this Detail object. @@ -92,10 +92,10 @@ public DetailEntry addDetailEntry(QName qname) throws SOAPException; /** - * Gets an Iterator over all of the DetailEntrys in this Detail object. + * Gets an Iterator over all of the {@code DetailEntry}s in this {@code Detail} object. * - * @return an Iterator object over the DetailEntry - * objects in this Detail object + * @return an {@code Iterator} object over the {@code DetailEntry} + * objects in this {@code Detail} object */ public Iterator getDetailEntries(); }