--- 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 DetailEntry
s 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();
}