Mercurial > hg > jdk9-shenandoah > corba
changeset 704:3ef63dbde965
8133650: replace some <tt> tags (obsolete in html5) in CORBA docs
Reviewed-by: lancea
line wrap: on
line diff
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ByteBuffer.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ByteBuffer.java Sun Sep 13 23:31:47 2015 +0300 @@ -37,9 +37,9 @@ protected byte elementData[]; /** - * The number of valid components in this <tt>ByteBuffer</tt> object. - * Components <tt>elementData[0]</tt> through - * <tt>elementData[elementCount-1]</tt> are the actual items. + * The number of valid components in this {@code ByteBuffer} object. + * Components {@code elementData[0]} through + * {@code elementData[elementCount-1]} are the actual items. * * @serial */ @@ -88,7 +88,7 @@ /** * Constructs an empty ByteBuffer so that its internal data array - * has size <tt>10</tt> and its standard capacity increment is + * has size {@code 10} and its standard capacity increment is * zero. */ public ByteBuffer() { @@ -99,7 +99,7 @@ * Trims the capacity of this ByteBuffer to be the ByteBuffer's current * size. If the capacity of this cector is larger than its current * size, then the capacity is changed to equal the size by replacing - * its internal data array, kept in the field <tt>elementData</tt>, + * its internal data array, kept in the field {@code elementData}, * with a smaller one. An application can use this operation to * minimize the storage of a ByteBuffer. */ @@ -138,7 +138,7 @@ * Returns the current capacity of this ByteBuffer. * * @return the current capacity (the length of its internal - * data arary, kept in the field <tt>elementData</tt> + * data arary, kept in the field {@code elementData} * of this ByteBuffer. */ public int capacity() { @@ -157,9 +157,9 @@ /** * Tests if this ByteBuffer has no components. * - * @return <code>true</code> if and only if this ByteBuffer has + * @return {@code true} if and only if this ByteBuffer has * no components, that is, its size is zero; - * <code>false</code> otherwise. + * {@code false} otherwise. */ public boolean isEmpty() { return elementCount == 0;
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/javax/rmi/CORBA/Util.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/com/sun/corba/se/impl/javax/rmi/CORBA/Util.java Sun Sep 13 23:31:47 2015 +0300 @@ -438,11 +438,11 @@ } /** - * Writes a java.lang.Object as a CORBA Object. If <code>obj</code> is + * Writes a java.lang.Object as a CORBA Object. If {@code obj} is * an exported RMI-IIOP server object, the tie is found - * and wired to <code>obj</code>, then written to <code>out.write_Object(org.omg.CORBA.Object)</code>. - * If <code>obj</code> is a CORBA Object, it is written to - * <code>out.write_Object(org.omg.CORBA.Object)</code>. + * and wired to {@code obj}, then written to {@code out.write_Object(org.omg.CORBA.Object)}. + * If {@code obj} is a CORBA Object, it is written to + * {@code out.write_Object(org.omg.CORBA.Object)}. * @param out the stream in which to write the object. * @param obj the object to write. */ @@ -457,10 +457,10 @@ /** * Writes a java.lang.Object as either a value or a CORBA Object. - * If <code>obj</code> is a value object or a stub object, it is written to - * <code>out.write_abstract_interface(java.lang.Object)</code>. If <code>obj</code> is an exported - * RMI-IIOP server object, the tie is found and wired to <code>obj</code>, - * then written to <code>out.write_abstract_interface(java.lang.Object)</code>. + * If {@code obj} is a value object or a stub object, it is written to + * {@code out.write_abstract_interface(java.lang.Object)}. If {@code obj} is an exported + * RMI-IIOP server object, the tie is found and wired to {@code obj}, + * then written to {@code out.write_abstract_interface(java.lang.Object)}. * @param out the stream in which to write the object. * @param obj the object to write. */ @@ -595,7 +595,7 @@ * the class might be found. May be null. * @param loader a class whose ClassLoader may be used to * load the class if all other methods fail. - * @return the <code>Class</code> object representing the loaded class. + * @return the {@code Class} object representing the loaded class. * @exception ClassNotFoundException if class cannot be loaded. */ public Class loadClass( String className, String remoteCodebase, @@ -605,20 +605,20 @@ } /** - * The <tt>isLocal</tt> method has the same semantics as the + * The {@code isLocal} method has the same semantics as the * ObjectImpl._is_local method, except that it can throw a RemoteException. * (no it doesn't but the spec says it should.) * - * The <tt>_is_local()</tt> method is provided so that stubs may determine + * The {@code _is_local()} method is provided so that stubs may determine * if a particular object is implemented by a local servant and hence local * invocation APIs may be used. * * @param stub the stub to test. * - * @return The <tt>_is_local()</tt> method returns true if + * @return The {@code _is_local()} method returns true if * the servant incarnating the object is located in the same process as - * the stub and they both share the same ORB instance. The <tt>_is_local()</tt> - * method returns false otherwise. The default behavior of <tt>_is_local()</tt> is + * the stub and they both share the same ORB instance. The {@code _is_local()} + * method returns false otherwise. The default behavior of {@code _is_local()} is * to return false. * * @throws RemoteException The Java to IDL specification does to
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/presentation/rmi/JNDIStateFactoryImpl.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/com/sun/corba/se/impl/presentation/rmi/JNDIStateFactoryImpl.java Sun Sep 13 23:31:47 2015 +0300 @@ -93,7 +93,7 @@ * @param name Ignored * @param ctx The non-null CNCtx whose ORB to use. * @param env Ignored - * @return The CORBA object for <tt>orig</tt> or null. + * @return The CORBA object for {@code orig} or null. * @exception ConfigurationException If the CORBA object cannot be obtained * due to configuration problems * @exception NamingException If some other problem prevented a CORBA
--- a/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/connection/ORBSocketFactory.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/connection/ORBSocketFactory.java Sun Sep 13 23:31:47 2015 +0300 @@ -165,7 +165,7 @@ * If number is 0 then use an emphemeral port for the listener of * the associated type. <p> * - * If number is greater then 0 use that port number. <p> + * If number is greater than 0 use that port number. <p> * * An ORB creates a listener socket for each type * specified by the user by calling
--- a/src/java.corba/share/classes/javax/rmi/CORBA/Util.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/javax/rmi/CORBA/Util.java Sun Sep 13 23:31:47 2015 +0300 @@ -108,12 +108,12 @@ } /** - * Writes a java.lang.Object as a CORBA Object. If <code>obj</code> is + * Writes a java.lang.Object as a CORBA Object. If {@code obj} is * an exported RMI-IIOP server object, the tie is found - * and wired to <code>obj</code>, then written to -<code>out.write_Object(org.omg.CORBA.Object)</code>. - * If <code>obj</code> is a CORBA Object, it is written to - * <code>out.write_Object(org.omg.CORBA.Object)</code>. + * and wired to {@code obj}, then written to + * {@code out.write_Object(org.omg.CORBA.Object)}. + * If {@code obj} is a CORBA Object, it is written to + * {@code out.write_Object(org.omg.CORBA.Object)}. * @param out the stream in which to write the object. * @param obj the object to write. */ @@ -128,12 +128,11 @@ /** * Writes a java.lang.Object as either a value or a CORBA Object. - * If <code>obj</code> is a value object or a stub object, it is written to - * <code>out.write_abstract_interface(java.lang.Object)</code>. If <code>obj</code> -is -an exported - * RMI-IIOP server object, the tie is found and wired to <code>obj</code>, - * then written to <code>out.write_abstract_interface(java.lang.Object)</code>. + * If {@code obj} is a value object or a stub object, it is written to + * {@code out.write_abstract_interface(java.lang.Object)}. + * If {@code obj} is an exported + * RMI-IIOP server object, the tie is found and wired to {@code obj}, + * then written to {@code out.write_abstract_interface(java.lang.Object)}. * @param out the stream in which to write the object. * @param obj the object to write. */ @@ -161,8 +160,8 @@ } /** - * Removes the associated tie from an internal table and calls {@link -Tie#deactivate} + * Removes the associated tie from an internal table + * and calls {@link Tie#deactivate} * to deactivate the object. * @param target the object to unexport. */ @@ -219,27 +218,27 @@ * <P>The spec for this method is the "Java to IDL language * mapping", ptc/00-01-06. * <P>In Java SE Platform, this method works as follows: - * <UL><LI>Find the first non-null <tt>ClassLoader</tt> on the + * <UL><LI>Find the first non-null {@code ClassLoader} on the * call stack and attempt to load the class using this - * <tt>ClassLoader</tt>. - * <LI>If the first step fails, and if <tt>remoteCodebase</tt> + * {@code ClassLoader}. + * <LI>If the first step fails, and if {@code remoteCodebase} * is non-null and - * <tt>useCodebaseOnly</tt> is false, then call - * <tt>java.rmi.server.RMIClassLoader.loadClass(remoteCodebase, className)</tt>. - * <LI>If <tt>remoteCodebase</tt> is null or <tt>useCodebaseOnly</tt> - * is true, then call <tt>java.rmi.server.RMIClassLoader.loadClass(className)</tt>. + * {@code useCodebaseOnly} is false, then call + * {@code java.rmi.server.RMIClassLoader.loadClass(remoteCodebase, className)}. + * <LI>If {@code remoteCodebase} is null or {@code useCodebaseOnly} + * is true, then call {@code java.rmi.server.RMIClassLoader.loadClass(className)}. * <LI>If a class was not successfully loaded by step 1, 2, or 3, - * and <tt>loader</tt> is non-null, then call <tt>loader.loadClass(className)</tt>. + * and {@code loader} is non-null, then call {@code loader.loadClass(className)}. * <LI>If a class was successfully loaded by step 1, 2, 3, or 4, then - * return the loaded class, else throw <tt>ClassNotFoundException</tt>. + * return the loaded class, else throw {@code ClassNotFoundException}. * </UL> * * @param className the name of the class. * @param remoteCodebase a space-separated list of URLs at which * the class might be found. May be null. - * @param loader a <tt>ClassLoader</tt> that may be used to + * @param loader a {@code ClassLoader} that may be used to * load the class if all other methods fail. - * @return the <code>Class</code> object representing the loaded class. + * @return the {@code Class} object representing the loaded class. * @exception ClassNotFoundException if class cannot be loaded. */ public static Class loadClass(String className, @@ -254,24 +253,24 @@ /** - * The <tt>isLocal</tt> method has the same semantics as the - * <tt>ObjectImpl._is_local</tt> - * method, except that it can throw a <tt>RemoteException</tt>. + * The {@code isLocal} method has the same semantics as the + * {@code ObjectImpl._is_local} + * method, except that it can throw a {@code RemoteException}. * - * The <tt>_is_local()</tt> method is provided so that stubs may determine if a + * The {@code _is_local()} method is provided so that stubs may determine if a * particular object is implemented by a local servant and hence local * invocation APIs may be used. * * @param stub the stub to test. * - * @return The <tt>_is_local()</tt> method returns true if + * @return The {@code _is_local()} method returns true if * the servant incarnating the object is located in the same process as - * the stub and they both share the same ORB instance. The <tt>_is_local()</tt> - * method returns false otherwise. The default behavior of <tt>_is_local()</tt> is + * the stub and they both share the same ORB instance. The {@code _is_local()} + * method returns false otherwise. The default behavior of {@code _is_local()} is * to return false. * * @throws RemoteException The Java to IDL specification does not - * specify the conditions that cause a <tt>RemoteException</tt> to be thrown. + * specify the conditions that cause a {@code RemoteException} to be thrown. */ public static boolean isLocal(Stub stub) throws RemoteException {
--- a/src/java.corba/share/classes/org/omg/CORBA/AnyHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/AnyHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -30,52 +30,52 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for <tt>Any</tt>. For more information on + * The Holder for {@code Any}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for <code>Any</code> objects + * A Holder class for {@code Any} objects * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>any</code> as an "out" + * If an IDL method signature has an IDL {@code any} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>AnyHolder</code> as the corresponding + * {@code AnyHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myAnyHolder</code> is an instance of <code>AnyHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myAnyHolder.value</code>. + * If {@code myAnyHolder} is an instance of {@code AnyHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myAnyHolder.value}. * * @since JDK1.2 */ public final class AnyHolder implements Streamable { /** - * The <code>Any</code> value held by this <code>AnyHolder</code> object. + * The {@code Any} value held by this {@code AnyHolder} object. */ public Any value; /** - * Constructs a new <code>AnyHolder</code> object with its - * <code>value</code> field initialized to <code>null</code>. + * Constructs a new {@code AnyHolder} object with its + * {@code value} field initialized to {@code null}. */ public AnyHolder() { } /** - * Constructs a new <code>AnyHolder</code> object for the given - * <code>Any</code> object. - * @param initial the <code>Any</code> object with which to initialize - * the <code>value</code> field of the new - * <code>AnyHolder</code> object + * Constructs a new {@code AnyHolder} object for the given + * {@code Any} object. + * @param initial the {@code Any} object with which to initialize + * the {@code value} field of the new + * {@code AnyHolder} object */ public AnyHolder(Any initial) { value = initial; } /** - * Reads from <code>input</code> and initalizes the value in the Holder + * Reads from {@code input} and initalizes the value in the Holder * with the unmarshalled data. * * @param input the InputStream containing CDR formatted data from the wire. @@ -85,8 +85,8 @@ } /** - * Marshals to <code>output</code> the value in - * this <code>AnyHolder</code> object. + * Marshals to {@code output} the value in + * this {@code AnyHolder} object. * * @param output the OutputStream which will contain the CDR formatted data. */ @@ -95,11 +95,11 @@ } /** - * Returns the <code>TypeCode</code> object corresponding to the value - * held in this <code>AnyHolder</code> object. + * Returns the {@code TypeCode} object corresponding to the value + * held in this {@code AnyHolder} object. * * @return the TypeCode of the value held in - * this <code>AnyHolder</code> object + * this {@code AnyHolder} object */ public TypeCode _type() { return ORB.init().get_primitive_tc(TCKind.tk_any);
--- a/src/java.corba/share/classes/org/omg/CORBA/AnySeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/AnySeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,26 +26,26 @@ /** -* The Helper for <tt>AnySeq</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/AnySeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -* <ul> -* <li> ORB core as defined by CORBA 2.3.1 -* (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) -* </li> -* -* <li> IDL/Java Language Mapping as defined in -* <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> -* </li> -* </ul> -*/ + * The Helper for {@code AnySeq}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/AnySeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + * <ul> + * <li> ORB core as defined by CORBA 2.3.1 + * (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) + * </li> + * + * <li> IDL/Java Language Mapping as defined in + * <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> + * </li> + * </ul> + */ public abstract class AnySeqHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/AnySeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/AnySeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Holder for <tt>AnySeq</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/AnySeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code AnySeq}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/AnySeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class AnySeqHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/BAD_POLICY.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/BAD_POLICY.java Sun Sep 13 23:31:47 2015 +0300 @@ -25,8 +25,8 @@ package org.omg.CORBA; /** - * A <tt>PolicyErrorCode</tt> which would be filled in - * the <tt>PolicyError</tt> exception. + * A {@code PolicyErrorCode} which would be filled in + * the {@code PolicyError} exception. * * @author rip-dev */
--- a/src/java.corba/share/classes/org/omg/CORBA/BAD_POLICY_TYPE.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/BAD_POLICY_TYPE.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,8 +26,8 @@ package org.omg.CORBA; /** - * A <tt>PolicyErrorCode</tt> which would be filled in - * the <tt>PolicyError</tt> exception. + * A {@code PolicyErrorCode} which would be filled in + * the {@code PolicyError} exception. * * @author rip-dev */
--- a/src/java.corba/share/classes/org/omg/CORBA/BAD_TYPECODE.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/BAD_TYPECODE.java Sun Sep 13 23:31:47 2015 +0300 @@ -27,7 +27,7 @@ /** * Exception thrown when the ORB has encountered a malformed type code - * (for example, a type code with an invalid <tt>TCKind</tt> value).<P> + * (for example, a type code with an invalid {@code TCKind} value).<P> * It contains a minor code, which gives more detailed information about * what caused the exception, and a completion status. It may also contain * a string describing the exception. @@ -40,7 +40,7 @@ public final class BAD_TYPECODE extends SystemException { /** - * Constructs a <code>BAD_TYPECODE</code> exception with a default + * Constructs a {@code BAD_TYPECODE} exception with a default * minor code of 0 and a completion state of COMPLETED_NO. */ public BAD_TYPECODE() { @@ -48,7 +48,7 @@ } /** - * Constructs a <code>BAD_TYPECODE</code> exception with the specified detail, + * Constructs a {@code BAD_TYPECODE} exception with the specified detail, * a minor code of 0, and a completion state of COMPLETED_NO. * * @param s the String containing a detail message @@ -58,10 +58,10 @@ } /** - * Constructs a <code>BAD_TYPECODE</code> exception with the specified + * Constructs a {@code BAD_TYPECODE} exception with the specified * minor code and completion status. * @param minor the minor code - * @param completed an instance of <code>CompletionStatus</code> indicating + * @param completed an instance of {@code CompletionStatus} indicating * the completion status */ public BAD_TYPECODE(int minor, CompletionStatus completed) { @@ -69,12 +69,12 @@ } /** - * Constructs a <code>BAD_TYPECODE</code> exception with the specified detail + * Constructs a {@code BAD_TYPECODE} exception with the specified detail * message, minor code, and completion status. * A detail message is a String that describes this particular exception. * @param s the String containing a detail message * @param minor the minor code - * @param completed an instance of <code>CompletionStatus</code> indicating + * @param completed an instance of {@code CompletionStatus} indicating * the completion status */ public BAD_TYPECODE(String s, int minor, CompletionStatus completed) {
--- a/src/java.corba/share/classes/org/omg/CORBA/BooleanHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/BooleanHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -30,56 +30,56 @@ /** - * The Holder for <tt>Boolean</tt>. For more information on + * The Holder for {@code Boolean}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for a <code>boolean</code> + * A Holder class for a {@code boolean} * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>boolean</code> as an "out" + * If an IDL method signature has an IDL {@code boolean} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>BooleanHolder</code> as the corresponding + * {@code BooleanHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myBooleanHolder</code> is an instance of <code>BooleanHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myBooleanHolder.value</code>. + * If {@code myBooleanHolder} is an instance of {@code BooleanHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myBooleanHolder.value}. * * @since JDK1.2 */ public final class BooleanHolder implements Streamable { /** - * The <code>boolean</code> value held by this <code>BooleanHolder</code> + * The {@code boolean} value held by this {@code BooleanHolder} * object. */ public boolean value; /** - * Constructs a new <code>BooleanHolder</code> object with its - * <code>value</code> field initialized to <code>false</code>. + * Constructs a new {@code BooleanHolder} object with its + * {@code value} field initialized to {@code false}. */ public BooleanHolder() { } /** - * Constructs a new <code>BooleanHolder</code> object with its - * <code>value</code> field initialized with the given <code>boolean</code>. - * @param initial the <code>boolean</code> with which to initialize - * the <code>value</code> field of the newly-created - * <code>BooleanHolder</code> object + * Constructs a new {@code BooleanHolder} object with its + * {@code value} field initialized with the given {@code boolean}. + * @param initial the {@code boolean} with which to initialize + * the {@code value} field of the newly-created + * {@code BooleanHolder} object */ public BooleanHolder(boolean initial) { value = initial; } /** - * Reads unmarshalled data from <code>input</code> and assigns it to this - * <code>BooleanHolder</code> object's <code>value</code> field. + * Reads unmarshalled data from {@code input} and assigns it to this + * {@code BooleanHolder} object's {@code value} field. * - * @param input the <code>InputStream</code> object containing + * @param input the {@code InputStream} object containing * CDR formatted data from the wire */ public void _read(InputStream input) { @@ -87,8 +87,8 @@ } /** - * Marshals the value in this <code>BooleanHolder</code> object's - * <code>value</code> field to the output stream <code>output</code>. + * Marshals the value in this {@code BooleanHolder} object's + * {@code value} field to the output stream {@code output}. * * @param output the OutputStream which will contain the CDR formatted data */ @@ -97,11 +97,11 @@ } /** - * Retrieves the <code>TypeCode</code> object that corresponds to the - * value held in this <code>BooleanHolder</code> object. + * Retrieves the {@code TypeCode} object that corresponds to the + * value held in this {@code BooleanHolder} object. * - * @return the <code>TypeCode</code> for the value held - * in this <code>BooleanHolder</code> object + * @return the {@code TypeCode} for the value held + * in this {@code BooleanHolder} object */ public TypeCode _type() { return ORB.init().get_primitive_tc(TCKind.tk_boolean);
--- a/src/java.corba/share/classes/org/omg/CORBA/BooleanSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/BooleanSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,26 +26,26 @@ /** -* The Helper for <tt>BooleanSeq</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/BooleanSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -* <ul> -* <li> ORB core as defined by CORBA 2.3.1 -* (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) -* </li> -* -* <li> IDL/Java Language Mapping as defined in -* <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> -* </li> -* </ul> -*/ + * The Helper for {@code BooleanSeq}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/BooleanSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + * <ul> + * <li> ORB core as defined by CORBA 2.3.1 + * (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) + * </li> + * + * <li> IDL/Java Language Mapping as defined in + * <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> + * </li> + * </ul> + */ public abstract class BooleanSeqHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/BooleanSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/BooleanSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Holder for <tt>BooleanSeq</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/BooleanSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code BooleanSeq}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/BooleanSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class BooleanSeqHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/ByteHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ByteHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -31,54 +31,54 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for <tt>Byte</tt>. For more information on + * The Holder for {@code Byte}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for a <code>byte</code> + * A Holder class for a {@code byte} * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>octet</code> as an "out" + * If an IDL method signature has an IDL {@code octet} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>ByteHolder</code> as the corresponding + * {@code ByteHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myByteHolder</code> is an instance of <code>ByteHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myByteHolder.value</code>. + * If {@code myByteHolder} is an instance of {@code ByteHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myByteHolder.value}. * * @since JDK1.2 */ public final class ByteHolder implements Streamable { /** - * The <code>byte</code> value held by this <code>ByteHolder</code> + * The {@code byte} value held by this {@code ByteHolder} * object. */ public byte value; /** - * Constructs a new <code>ByteHolder</code> object with its - * <code>value</code> field initialized to 0. + * Constructs a new {@code ByteHolder} object with its + * {@code value} field initialized to 0. */ public ByteHolder() { } /** - * Constructs a new <code>ByteHolder</code> object for the given - * <code>byte</code>. - * @param initial the <code>byte</code> with which to initialize - * the <code>value</code> field of the new - * <code>ByteHolder</code> object + * Constructs a new {@code ByteHolder} object for the given + * {@code byte}. + * @param initial the {@code byte} with which to initialize + * the {@code value} field of the new + * {@code ByteHolder} object */ public ByteHolder(byte initial) { value = initial; } /** - * Reads from <code>input</code> and initalizes the value in - * this <code>ByteHolder</code> object + * Reads from {@code input} and initalizes the value in + * this {@code ByteHolder} object * with the unmarshalled data. * * @param input the InputStream containing CDR formatted data from the wire. @@ -88,8 +88,8 @@ } /** - * Marshals to <code>output</code> the value in - * this <code>ByteHolder</code> object. + * Marshals to {@code output} the value in + * this {@code ByteHolder} object. * * @param output the OutputStream which will contain the CDR formatted data. */ @@ -99,10 +99,10 @@ /** * Returns the TypeCode corresponding to the value held in - * this <code>ByteHolder</code> object. + * this {@code ByteHolder} object. * - * @return the TypeCode of the value held in - * this <code>ByteHolder</code> object + * @return the TypeCode of the value held in + * this {@code ByteHolder} object */ public org.omg.CORBA.TypeCode _type() { return ORB.init().get_primitive_tc(TCKind.tk_octet);
--- a/src/java.corba/share/classes/org/omg/CORBA/CharHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/CharHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -31,54 +31,54 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for <tt>Char</tt>. For more information on + * The Holder for {@code Char}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for a <code>char</code> + * A Holder class for a {@code char} * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>char</code> as an "out" + * If an IDL method signature has an IDL {@code char} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>CharHolder</code> as the corresponding + * {@code CharHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myCharHolder</code> is an instance of <code>CharHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myCharHolder.value</code>. + * If {@code myCharHolder} is an instance of {@code CharHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myCharHolder.value}. * * @since JDK1.2 */ public final class CharHolder implements Streamable { /** - * The <code>char</code> value held by this <code>CharHolder</code> + * The {@code char} value held by this {@code CharHolder} * object. */ public char value; /** - * Constructs a new <code>CharHolder</code> object with its - * <code>value</code> field initialized to <code>0</code>. + * Constructs a new {@code CharHolder} object with its + * {@code value} field initialized to {@code 0}. */ public CharHolder() { } /** - * Constructs a new <code>CharHolder</code> object for the given - * <code>char</code>. - * @param initial the <code>char</code> with which to initialize - * the <code>value</code> field of the new - * <code>CharHolder</code> object + * Constructs a new {@code CharHolder} object for the given + * {@code char}. + * @param initial the {@code char} with which to initialize + * the {@code value} field of the new + * {@code CharHolder} object */ public CharHolder(char initial) { value = initial; } /** - * Reads from <code>input</code> and initalizes the value in - * this <code>CharHolder</code> object + * Reads from {@code input} and initalizes the value in + * this {@code CharHolder} object * with the unmarshalled data. * * @param input the InputStream containing CDR formatted data from the wire @@ -88,8 +88,8 @@ } /** - * Marshals to <code>output</code> the value in - * this <code>CharHolder</code> object. + * Marshals to {@code output} the value in + * this {@code CharHolder} object. * * @param output the OutputStream which will contain the CDR formatted data */ @@ -98,12 +98,12 @@ } /** - * Returns the <code>TypeCode</code> object corresponding + * Returns the {@code TypeCode} object corresponding * to the value held in - * this <code>CharHolder</code> object. + * this {@code CharHolder} object. * * @return the TypeCode of the value held in - * this <code>CharHolder</code> object + * this {@code CharHolder} object */ public org.omg.CORBA.TypeCode _type() { return ORB.init().get_primitive_tc(TCKind.tk_char);
--- a/src/java.corba/share/classes/org/omg/CORBA/CharSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/CharSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,26 +26,26 @@ /** -* The Helper for <tt>CharSeq</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/CharSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -* <ul> -* <li> ORB core as defined by CORBA 2.3.1 -* (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) -* </li> -* -* <li> IDL/Java Language Mapping as defined in -* <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> -* </li> -* </ul> -*/ + * The Helper for {@code CharSeq}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/CharSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + * <ul> + * <li> ORB core as defined by CORBA 2.3.1 + * (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) + * </li> + * + * <li> IDL/Java Language Mapping as defined in + * <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> + * </li> + * </ul> + */ public abstract class CharSeqHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/CharSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/CharSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Holder for <tt>CharSeq</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/CharSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code CharSeq}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/CharSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class CharSeqHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/CompletionStatusHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/CompletionStatusHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,13 +26,13 @@ /** -* The Helper for <tt>CompletionStatus</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/CompletionStatusHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* 03 June 1999 11:52:03 o'clock GMT+00:00 -*/ + * The Helper for {@code CompletionStatus}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/CompletionStatusHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * 03 June 1999 11:52:03 o'clock GMT+00:00 + */ abstract public class CompletionStatusHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/Current.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/Current.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,16 +26,16 @@ /** -* Interfaces derived from the <tt>Current</tt> interface enable ORB and CORBA +* Interfaces derived from the {@code Current} interface enable ORB and CORBA * services to provide access to information (context) associated with * the thread of execution in which they are running. This information * is accessed in a structured manner using interfaces derived from the -* <tt>Current</tt> interface defined in the CORBA module. +* {@code Current} interface defined in the CORBA module. * * <P>Each ORB or CORBA service that needs its own context derives an -* interface from the CORBA module's <tt>Current</tt>. Users of the -* service can obtain an instance of the appropriate <tt>Current</tt> -* interface by invoking <tt>ORB::resolve_initial_references</tt>.<P> +* interface from the CORBA module's {@code Current}. Users of the +* service can obtain an instance of the appropriate {@code Current} +* interface by invoking {@code ORB::resolve_initial_references}.<P> * * org/omg/CORBA/Current.java * Generated by the IDL-to-Java compiler (portable), version "3.0"
--- a/src/java.corba/share/classes/org/omg/CORBA/CurrentHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/CurrentHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Helper for <tt>Current</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/CurrentHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:21 AM PDT -*/ + * The Helper for {@code Current}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/CurrentHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:21 AM PDT + */ abstract public class CurrentHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/CurrentHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/CurrentHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -25,14 +25,14 @@ package org.omg.CORBA; /** -* The Holder for <tt>Current</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/CurrentHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:21 AM PDT -*/ + * The Holder for {@code Current}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/CurrentHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:21 AM PDT + */ public final class CurrentHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/CurrentOperations.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/CurrentOperations.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,15 +26,15 @@ /** -* The interface for <tt>Current</tt>. For more information on -* Operations interfaces, see <a href="doc-files/generatedfiles.html"> -* "Generated Files"</a>. -* -* org/omg/CORBA/CurrentOperations.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:21 AM PDT. -*/ + * The interface for {@code Current}. For more information on + * Operations interfaces, see <a href="doc-files/generatedfiles.html"> + * "Generated Files"</a>. + * + * org/omg/CORBA/CurrentOperations.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:21 AM PDT. + */ public interface CurrentOperations {
--- a/src/java.corba/share/classes/org/omg/CORBA/CustomMarshal.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/CustomMarshal.java Sun Sep 13 23:31:47 2015 +0300 @@ -34,7 +34,7 @@ * as a custom value type's implicit base class, although the custom * valuetype does not actually inherit it in IDL. The implementer * of a custom value type shall provide an implementation of the - * <tt>CustomMarshal</tt> operations. The manner in which this is done is + * {@code CustomMarshal} operations. The manner in which this is done is * specified in the IDL to Java langauge mapping. Each custom * marshaled value type shall have its own implementation. * @see DataInputStream
--- a/src/java.corba/share/classes/org/omg/CORBA/DefinitionKindHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/DefinitionKindHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Helper for <tt>DefinitionKind</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/DefinitionKindHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ir.idl -* 03 June 1999 11:33:43 o'clock GMT+00:00 -*/ + * The Helper for {@code DefinitionKind}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/DefinitionKindHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ir.idl + * 03 June 1999 11:33:43 o'clock GMT+00:00 + */ abstract public class DefinitionKindHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/DomainManager.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/DomainManager.java Sun Sep 13 23:31:47 2015 +0300 @@ -25,11 +25,12 @@ package org.omg.CORBA; -/** Provides mechanisms for establishing and navigating relationships to +/** + * Provides mechanisms for establishing and navigating relationships to * superior and subordinate domains, as well as for creating and accessing - * policies. The <tt>DomainManager</tt> has associated with it the policy - * objects for a - * particular domain. The domain manager also records the membership of + * policies. The {@code DomainManager} has associated with it the policy + * objects for a particular domain. + * The domain manager also records the membership of * the domain and provides the means to add and remove members. The domain * manager is itself a member of a domain, possibly the domain it manages. * The domain manager provides mechanisms for establishing and navigating
--- a/src/java.corba/share/classes/org/omg/CORBA/DomainManagerOperations.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/DomainManagerOperations.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,9 +26,9 @@ package org.omg.CORBA; /** - * Provides the <tt>DomainManager</tt> with the means to access policies. + * Provides the {@code DomainManager} with the means to access policies. * <P> - * The <tt>DomainManager</tt> has associated with it the policy objects for a + * The {@code DomainManager} has associated with it the policy objects for a * particular domain. The domain manager also records the membership of * the domain and provides the means to add and remove members. The domain * manager is itself a member of a domain, possibly the domain it manages. @@ -39,11 +39,12 @@ public interface DomainManagerOperations { - /** This returns the policy of the specified type for objects in + /** + * This returns the policy of the specified type for objects in * this domain. The types of policies available are domain specific. * See the CORBA specification for a list of standard ORB policies. * - *@param policy_type Type of policy to request + * @param policy_type Type of policy to request */ public org.omg.CORBA.Policy get_domain_policy(int policy_type); }
--- a/src/java.corba/share/classes/org/omg/CORBA/DoubleHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/DoubleHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -30,47 +30,47 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for <tt>Double</tt>. For more information on + * The Holder for {@code Double}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for a <code>double</code> + * A Holder class for a {@code double} * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>double</code> as an "out" + * If an IDL method signature has an IDL {@code double} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>DoubleHolder</code> as the corresponding + * {@code DoubleHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myDoubleHolder</code> is an instance of <code>DoubleHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myDoubleHolder.value</code>. + * If {@code myDoubleHolder} is an instance of {@code DoubleHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myDoubleHolder.value}. * * @since JDK1.2 */ public final class DoubleHolder implements Streamable { /** - * The <code>double</code> value held by this <code>DoubleHolder</code> + * The {@code double} value held by this {@code DoubleHolder} * object. */ public double value; /** - * Constructs a new <code>DoubleHolder</code> object with its - * <code>value</code> field initialized to 0.0. + * Constructs a new {@code DoubleHolder} object with its + * {@code value} field initialized to 0.0. */ public DoubleHolder() { } /** - * Constructs a new <code>DoubleHolder</code> object for the given - * <code>double</code>. - * @param initial the <code>double</code> with which to initialize - * the <code>value</code> field of the new - * <code>DoubleHolder</code> object + * Constructs a new {@code DoubleHolder} object for the given + * {@code double}. + * @param initial the {@code double} with which to initialize + * the {@code value} field of the new + * {@code DoubleHolder} object */ public DoubleHolder(double initial) { value = initial; @@ -80,7 +80,7 @@ * Read a double value from the input stream and store it in the * value member. * - * @param input the <code>InputStream</code> to read from. + * @param input the {@code InputStream} to read from. */ public void _read(InputStream input) { value = input.read_double(); @@ -88,18 +88,18 @@ /** * Write the double value stored in this holder to an - * <code>OutputStream</code>. + * {@code OutputStream}. * - * @param output the <code>OutputStream</code> to write into. + * @param output the {@code OutputStream} to write into. */ public void _write(OutputStream output) { output.write_double(value); } /** - * Return the <code>TypeCode</code> of this holder object. + * Return the {@code TypeCode} of this holder object. * - * @return the <code>TypeCode</code> object. + * @return the {@code TypeCode} object. */ public org.omg.CORBA.TypeCode _type() { return ORB.init().get_primitive_tc(TCKind.tk_double);
--- a/src/java.corba/share/classes/org/omg/CORBA/DoubleSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/DoubleSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,26 +26,26 @@ /** -* The Helper for <tt>DoubleSeq</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/DoubleSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:37 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -* <ul> -* <li> ORB core as defined by CORBA 2.3.1 -* (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) -* </li> -* -* <li> IDL/Java Language Mapping as defined in -* <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> -* </li> -* </ul> -*/ + * The Helper for {@code DoubleSeq}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/DoubleSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:37 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + * <ul> + * <li> ORB core as defined by CORBA 2.3.1 + * (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) + * </li> + * + * <li> IDL/Java Language Mapping as defined in + * <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> + * </li> + * </ul> + */ public abstract class DoubleSeqHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/DoubleSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/DoubleSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Holder for <tt>DoubleSeq</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/DoubleSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:37 o'clock GMT+00:00 -*/ + * The Holder for {@code DoubleSeq}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/DoubleSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:37 o'clock GMT+00:00 + */ public final class DoubleSeqHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/DynAny.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/DynAny.java Sun Sep 13 23:31:47 2015 +0300 @@ -27,367 +27,368 @@ package org.omg.CORBA; -/** Enables <tt>org.omg.CORBA.Any</tt> values to be dynamically +/** + * Enables {@code org.omg.CORBA.Any} values to be dynamically * interpreted (traversed) and - * constructed. A <tt>DynAny</tt> object is associated with a data value - * which may correspond to a copy of the value inserted into an <tt>Any</tt>. - * The <tt>DynAny</tt> APIs enable traversal of the data value associated with an - * Any at runtime and extraction of the primitive constituents of the - * data value. + * constructed. A {@code DynAny} object is associated with a data value + * which may correspond to a copy of the value inserted into an {@code Any}. + * The {@code DynAny} APIs enable traversal of the data value associated with an + * Any at runtime and extraction of the primitive constituents of the + * data value. * @deprecated Use the new <a href="../DynamicAny/DynAny.html">DynAny</a> instead */ @Deprecated public interface DynAny extends org.omg.CORBA.Object { /** - * Returns the <code>TypeCode</code> of the object inserted into - * this <code>DynAny</code>. + * Returns the {@code TypeCode} of the object inserted into + * this {@code DynAny}. * - * @return the <code>TypeCode</code> object. + * @return the {@code TypeCode} object. */ public org.omg.CORBA.TypeCode type() ; /** * Copy the contents from one Dynamic Any into another. * - * @param dyn_any the <code>DynAny</code> object whose contents - * are assigned to this <code>DynAny</code>. + * @param dyn_any the {@code DynAny} object whose contents + * are assigned to this {@code DynAny}. * @throws org.omg.CORBA.DynAnyPackage.Invalid if the source - * <code>DynAny</code> is invalid + * {@code DynAny} is invalid */ public void assign(org.omg.CORBA.DynAny dyn_any) throws org.omg.CORBA.DynAnyPackage.Invalid; /** - * Make a <code>DynAny</code> object from an <code>Any</code> + * Make a {@code DynAny} object from an {@code Any} * object. * - * @param value the <code>Any</code> object. + * @param value the {@code Any} object. * @throws org.omg.CORBA.DynAnyPackage.Invalid if the source - * <code>Any</code> object is empty or bad + * {@code Any} object is empty or bad */ public void from_any(org.omg.CORBA.Any value) throws org.omg.CORBA.DynAnyPackage.Invalid; /** - * Convert a <code>DynAny</code> object to an <code>Any</code> + * Convert a {@code DynAny} object to an {@code Any} * object. * - * @return the <code>Any</code> object. + * @return the {@code Any} object. * @throws org.omg.CORBA.DynAnyPackage.Invalid if this - * <code>DynAny</code> is empty or bad. + * {@code DynAny} is empty or bad. * created or does not contain a meaningful value */ public org.omg.CORBA.Any to_any() throws org.omg.CORBA.DynAnyPackage.Invalid; /** - * Destroys this <code>DynAny</code> object and frees any resources + * Destroys this {@code DynAny} object and frees any resources * used to represent the data value associated with it. This method - * also destroys all <code>DynAny</code> objects obtained from it. + * also destroys all {@code DynAny} objects obtained from it. * <p> - * Destruction of <code>DynAny</code> objects should be handled with + * Destruction of {@code DynAny} objects should be handled with * care, taking into account issues dealing with the representation of - * data values associated with <code>DynAny</code> objects. A programmer - * who wants to destroy a <code>DynAny</code> object but still be able + * data values associated with {@code DynAny} objects. A programmer + * who wants to destroy a {@code DynAny} object but still be able * to manipulate some component of the data value associated with it, - * should first create a <code>DynAny</code> object for the component - * and then make a copy of the created <code>DynAny</code> object. + * should first create a {@code DynAny} object for the component + * and then make a copy of the created {@code DynAny} object. */ public void destroy() ; /** - * Clones this <code>DynAny</code> object. + * Clones this {@code DynAny} object. * - * @return a copy of this <code>DynAny</code> object + * @return a copy of this {@code DynAny} object */ public org.omg.CORBA.DynAny copy() ; /** - * Inserts the given <code>boolean</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code boolean} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>boolean</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code boolean} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_boolean(boolean value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>byte</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code byte} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>byte</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code byte} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_octet(byte value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>char</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code char} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>char</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code char} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_char(char value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>short</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code short} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>short</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code short} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_short(short value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>short</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code short} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>short</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code short} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_ushort(short value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>int</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code int} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>int</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code int} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_long(int value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>int</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code int} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>int</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code int} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_ulong(int value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>float</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code float} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>float</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code float} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_float(float value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>double</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code double} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>double</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code double} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_double(double value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>String</code> object as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code String} object as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>String</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code String} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_string(String value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>org.omg.CORBA.Object</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code org.omg.CORBA.Object} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>org.omg.CORBA.Object</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code org.omg.CORBA.Object} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_reference(org.omg.CORBA.Object value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>org.omg.CORBA.TypeCode</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code org.omg.CORBA.TypeCode} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>org.omg.CORBA.TypeCode</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code org.omg.CORBA.TypeCode} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_typecode(org.omg.CORBA.TypeCode value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>long</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code long} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>long</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code long} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_longlong(long value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>long</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code long} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>long</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code long} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_ulonglong(long value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>char</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code char} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>char</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code char} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_wchar(char value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>String</code> as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code String} as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>String</code> to insert into this - * <code>DynAny</code> object + * @param value the {@code String} to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_wstring(String value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Inserts the given <code>org.omg.CORBA.Any</code> object as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code org.omg.CORBA.Any} object as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>org.omg.CORBA.Any</code> object to insert into this - * <code>DynAny</code> object + * @param value the {@code org.omg.CORBA.Any} object to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_any(org.omg.CORBA.Any value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; @@ -395,32 +396,32 @@ // orbos 98-01-18: Objects By Value -- begin /** - * Inserts the given <code>java.io.Serializable</code> object as the value for this - * <code>DynAny</code> object. + * Inserts the given {@code java.io.Serializable} object as the value for this + * {@code DynAny} object. * - * <p> If this method is called on a constructed <code>DynAny</code> + * <p> If this method is called on a constructed {@code DynAny} * object, it initializes the next component of the constructed data - * value associated with this <code>DynAny</code> object. + * value associated with this {@code DynAny} object. * - * @param value the <code>java.io.Serializable</code> object to insert into this - * <code>DynAny</code> object + * @param value the {@code java.io.Serializable} object to insert into this + * {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.InvalidValue * if the value inserted is not consistent with the type - * of the accessed component in this <code>DynAny</code> object + * of the accessed component in this {@code DynAny} object */ public void insert_val(java.io.Serializable value) throws org.omg.CORBA.DynAnyPackage.InvalidValue; /** - * Retrieves the <code>java.io.Serializable</code> object contained - * in this <code>DynAny</code> object. + * Retrieves the {@code java.io.Serializable} object contained + * in this {@code DynAny} object. * - * @return the <code>java.io.Serializable</code> object that is the - * value for this <code>DynAny</code> object + * @return the {@code java.io.Serializable} object that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>java.io.Serializable</code> object + * {@code DynAny} object is not equivalent to + * the type code for a {@code java.io.Serializable} object */ public java.io.Serializable get_val() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; @@ -428,284 +429,284 @@ // orbos 98-01-18: Objects By Value -- end /** - * Retrieves the <code>boolean</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code boolean} contained + * in this {@code DynAny} object. * - * @return the <code>boolean</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code boolean} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>boolean</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code boolean} */ public boolean get_boolean() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>byte</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code byte} contained + * in this {@code DynAny} object. * - * @return the <code>byte</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code byte} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>byte</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code byte} */ public byte get_octet() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>char</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code char} contained + * in this {@code DynAny} object. * - * @return the <code>char</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code char} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>char</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code char} */ public char get_char() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>short</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code short} contained + * in this {@code DynAny} object. * - * @return the <code>short</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code short} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>short</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code short} */ public short get_short() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>short</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code short} contained + * in this {@code DynAny} object. * - * @return the <code>short</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code short} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>short</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code short} */ public short get_ushort() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>int</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code int} contained + * in this {@code DynAny} object. * - * @return the <code>int</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code int} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>int</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code int} */ public int get_long() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>int</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code int} contained + * in this {@code DynAny} object. * - * @return the <code>int</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code int} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>int</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code int} */ public int get_ulong() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>float</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code float} contained + * in this {@code DynAny} object. * - * @return the <code>float</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code float} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>float</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code float} */ public float get_float() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>double</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code double} contained + * in this {@code DynAny} object. * - * @return the <code>double</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code double} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>double</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code double} */ public double get_double() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>String</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code String} contained + * in this {@code DynAny} object. * - * @return the <code>String</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code String} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>String</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code String} */ public String get_string() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>org.omg.CORBA.Other</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code org.omg.CORBA.Other} contained + * in this {@code DynAny} object. * - * @return the <code>org.omg.CORBA.Other</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code org.omg.CORBA.Other} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for an <code>org.omg.CORBA.Other</code> + * {@code DynAny} object is not equivalent to + * the type code for an {@code org.omg.CORBA.Other} */ public org.omg.CORBA.Object get_reference() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>org.omg.CORBA.TypeCode</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code org.omg.CORBA.TypeCode} contained + * in this {@code DynAny} object. * - * @return the <code>org.omg.CORBA.TypeCode</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code org.omg.CORBA.TypeCode} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>org.omg.CORBA.TypeCode</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code org.omg.CORBA.TypeCode} */ public org.omg.CORBA.TypeCode get_typecode() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>long</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code long} contained + * in this {@code DynAny} object. * - * @return the <code>long</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code long} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>long</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code long} */ public long get_longlong() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>long</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code long} contained + * in this {@code DynAny} object. * - * @return the <code>long</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code long} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>long</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code long} */ public long get_ulonglong() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>char</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code char} contained + * in this {@code DynAny} object. * - * @return the <code>char</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code char} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>char</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code char} */ public char get_wchar() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>String</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code String} contained + * in this {@code DynAny} object. * - * @return the <code>String</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code String} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for a <code>String</code> + * {@code DynAny} object is not equivalent to + * the type code for a {@code String} */ public String get_wstring() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Retrieves the <code>org.omg.CORBA.Any</code> contained - * in this <code>DynAny</code> object. + * Retrieves the {@code org.omg.CORBA.Any} contained + * in this {@code DynAny} object. * - * @return the <code>org.omg.CORBA.Any</code> that is the - * value for this <code>DynAny</code> object + * @return the {@code org.omg.CORBA.Any} that is the + * value for this {@code DynAny} object * @throws org.omg.CORBA.DynAnyPackage.TypeMismatch * if the type code of the accessed component in this - * <code>DynAny</code> object is not equivalent to - * the type code for an <code>org.omg.CORBA.Any</code> + * {@code DynAny} object is not equivalent to + * the type code for an {@code org.omg.CORBA.Any} */ public org.omg.CORBA.Any get_any() throws org.omg.CORBA.DynAnyPackage.TypeMismatch; /** - * Returns a <code>DynAny</code> object reference that can + * Returns a {@code DynAny} object reference that can * be used to get/set the value of the component currently accessed. - * The appropriate <code>insert</code> method - * can be called on the resulting <code>DynAny</code> object + * The appropriate {@code insert} method + * can be called on the resulting {@code DynAny} object * to initialize the component. - * The appropriate <code>get</code> method - * can be called on the resulting <code>DynAny</code> object + * The appropriate {@code get} method + * can be called on the resulting {@code DynAny} object * to extract the value of the component. * - * @return a <code>DynAny</code> object reference that can be + * @return a {@code DynAny} object reference that can be * used to retrieve or set the value of the component currently * accessed */ public org.omg.CORBA.DynAny current_component() ; /** - * Moves to the next component of this <code>DynAny</code> object. + * Moves to the next component of this {@code DynAny} object. * This method is used for iterating through the components of * a constructed type, effectively moving a pointer from one * component to the next. The pointer starts out on the first - * component when a <code>DynAny</code> object is created. + * component when a {@code DynAny} object is created. * - * @return <code>true</code> if the pointer points to a component; - * <code>false</code> if there are no more components or this - * <code>DynAny</code> is associated with a basic type rather than + * @return {@code true} if the pointer points to a component; + * {@code false} if there are no more components or this + * {@code DynAny} is associated with a basic type rather than * a constructed type */ public boolean next() ; @@ -714,12 +715,12 @@ * Moves the internal pointer to the given index. Logically, this method * sets a new offset for this pointer. * - * @param index an <code>int</code> indicating the position to which + * @param index an {@code int} indicating the position to which * the pointer should move. The first position is 0. - * @return <code>true</code> if the pointer points to a component; - * <code>false</code> if there is no component at the designated - * index. If this <code>DynAny</code> object is associated with a - * basic type, this method returns <code>false</code> for any index + * @return {@code true} if the pointer points to a component; + * {@code false} if there is no component at the designated + * index. If this {@code DynAny} object is associated with a + * basic type, this method returns {@code false} for any index * other than 0. */ public boolean seek(int index) ;
--- a/src/java.corba/share/classes/org/omg/CORBA/DynArray.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/DynArray.java Sun Sep 13 23:31:47 2015 +0300 @@ -27,8 +27,9 @@ package org.omg.CORBA; -/** Represents a <tt>DynAny</tt> object associated - * with an array. +/** + * Represents a {@code DynAny} object associated with an array. + * * @deprecated Use the new <a href="../DynamicAny/DynArray.html">DynArray</a> instead */ @Deprecated
--- a/src/java.corba/share/classes/org/omg/CORBA/DynEnum.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/DynEnum.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,8 +26,9 @@ package org.omg.CORBA; -/** Represents a <tt>DynAny</tt> object associated - * with an IDL enum. +/** + * Represents a {@code DynAny} object associated with an IDL enum. + * * @deprecated Use the new <a href="../DynamicAny/DynEnum.html">DynEnum</a> instead */ @Deprecated @@ -35,14 +36,14 @@ { /** * Return the value of the IDL enum stored in this - * <code>DynEnum</code> as a string. + * {@code DynEnum} as a string. * * @return the stringified value. */ public String value_as_string(); /** - * Set a particular enum in this <code>DynEnum</code>. + * Set a particular enum in this {@code DynEnum}. * * @param arg the string corresponding to the value. */
--- a/src/java.corba/share/classes/org/omg/CORBA/FieldNameHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/FieldNameHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,13 +26,13 @@ /** -* The Helper for <tt>FieldName</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/FieldNameHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* 03 June 1999 11:52:03 o'clock GMT+00:00 -*/ + * The Helper for {@code FieldName}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/FieldNameHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * 03 June 1999 11:52:03 o'clock GMT+00:00 + */ abstract public class FieldNameHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/FixedHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/FixedHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -31,7 +31,7 @@ /** - * The Holder for <tt>Fixed</tt>. For more information on + * The Holder for {@code Fixed}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> * FixedHolder is a container class for values of IDL type "fixed", @@ -69,7 +69,7 @@ * Read a fixed point value from the input stream and store it in * the value member. * - * @param input the <code>InputStream</code> to read from. + * @param input the {@code InputStream} to read from. */ public void _read(InputStream input) { value = input.read_fixed(); @@ -77,9 +77,9 @@ /** * Write the fixed point value stored in this holder to an - * <code>OutputStream</code>. + * {@code OutputStream}. * - * @param output the <code>OutputStream</code> to write into. + * @param output the {@code OutputStream} to write into. */ public void _write(OutputStream output) { output.write_fixed(value); @@ -87,9 +87,9 @@ /** - * Return the <code>TypeCode</code> of this holder object. + * Return the {@code TypeCode} of this holder object. * - * @return the <code>TypeCode</code> object. + * @return the {@code TypeCode} object. */ public org.omg.CORBA.TypeCode _type() { return ORB.init().get_primitive_tc(TCKind.tk_fixed);
--- a/src/java.corba/share/classes/org/omg/CORBA/FloatHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/FloatHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -31,45 +31,45 @@ /** - * The Holder for <tt>Float</tt>. For more information on + * The Holder for {@code Float}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for a <code>float</code> + * A Holder class for a {@code float} * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>float</code> as an "out" + * If an IDL method signature has an IDL {@code float} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>FloatHolder</code> as the corresponding + * {@code FloatHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myFloatHolder</code> is an instance of <code>FloatHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myFloatHolder.value</code>. + * If {@code myFloatHolder} is an instance of {@code FloatHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myFloatHolder.value}. * * @since JDK1.2 */ public final class FloatHolder implements Streamable { /** - * The <code>float</code> value held by this <code>FloatHolder</code> + * The {@code float} value held by this {@code FloatHolder} * object. */ public float value; /** - * Constructs a new <code>FloatHolder</code> object with its - * <code>value</code> field initialized to 0.0. + * Constructs a new {@code FloatHolder} object with its + * {@code value} field initialized to 0.0. */ public FloatHolder() { } /** - * Constructs a new <code>FloatHolder</code> object for the given - * <code>float</code>. - * @param initial the <code>float</code> with which to initialize - * the <code>value</code> field of the new - * <code>FloatHolder</code> object + * Constructs a new {@code FloatHolder} object for the given + * {@code float}. + * @param initial the {@code float} with which to initialize + * the {@code value} field of the new + * {@code FloatHolder} object */ public FloatHolder(float initial) { value = initial; @@ -79,7 +79,7 @@ * Read a float from an input stream and initialize the value * member with the float value. * - * @param input the <code>InputStream</code> to read from. + * @param input the {@code InputStream} to read from. */ public void _read(InputStream input) { value = input.read_float(); @@ -88,16 +88,16 @@ /** * Write the float value into an output stream. * - * @param output the <code>OutputStream</code> to write into. + * @param output the {@code OutputStream} to write into. */ public void _write(OutputStream output) { output.write_float(value); } /** - * Return the <code>TypeCode</code> of this Streamable. + * Return the {@code TypeCode} of this Streamable. * - * @return the <code>TypeCode</code> object. + * @return the {@code TypeCode} object. */ public org.omg.CORBA.TypeCode _type() { return ORB.init().get_primitive_tc(TCKind.tk_float);
--- a/src/java.corba/share/classes/org/omg/CORBA/FloatSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/FloatSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,26 +26,26 @@ /** -* The Helper for <tt>FloatSeq</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/FloatSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:37 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -* <ul> -* <li> ORB core as defined by CORBA 2.3.1 -* (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) -* </li> -* -* <li> IDL/Java Language Mapping as defined in -* <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> -* </li> -* </ul> -*/ + * The Helper for {@code FloatSeq}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/FloatSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:37 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + * <ul> + * <li> ORB core as defined by CORBA 2.3.1 + * (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) + * </li> + * + * <li> IDL/Java Language Mapping as defined in + * <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> + * </li> + * </ul> + */ public abstract class FloatSeqHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/FloatSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/FloatSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Holder for <tt>FloatSeq</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/FloatSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:37 o'clock GMT+00:00 -*/ + * The Holder for {@code FloatSeq}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/FloatSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:37 o'clock GMT+00:00 + */ public final class FloatSeqHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/IDLTypeHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/IDLTypeHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Helper for <tt>IDLType</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/IDLTypeHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ir.idl -* 03 June 1999 11:33:44 o'clock GMT+00:00 -*/ + * The Helper for {@code IDLType}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/IDLTypeHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ir.idl + * 03 June 1999 11:33:44 o'clock GMT+00:00 + */ abstract public class IDLTypeHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/IDLTypeOperations.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/IDLTypeOperations.java Sun Sep 13 23:31:47 2015 +0300 @@ -25,10 +25,10 @@ package org.omg.CORBA; /** -* The interface for <tt>IDLType</tt>. For more information on -* Operations interfaces, see <a href="doc-files/generatedfiles.html#operations"> -* "Generated Files: Operations files"</a>. -*/ + * The interface for {@code IDLType}. For more information on + * Operations interfaces, see <a href="doc-files/generatedfiles.html#operations"> + * "Generated Files: Operations files"</a>. + */ /* tempout/org/omg/CORBA/IDLTypeOperations.java @@ -51,8 +51,8 @@ { /** * The type attribute describes the type defined by an object - * derived from <code>IDLType</code>. - * @return the <code>TypeCode</code> defined by this object. + * derived from {@code IDLType}. + * @return the {@code TypeCode} defined by this object. */ org.omg.CORBA.TypeCode type (); } // interface IDLTypeOperations
--- a/src/java.corba/share/classes/org/omg/CORBA/INV_OBJREF.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/INV_OBJREF.java Sun Sep 13 23:31:47 2015 +0300 @@ -32,7 +32,7 @@ * exception is raised by ORB::string_to_object if the passed * string does not decode correctly. An ORB may choose to detect * calls via nil references (but is not obliged to do detect them). - * <tt>INV_OBJREF</tt> is used to indicate this.<P> + * {@code INV_OBJREF} is used to indicate this.<P> * It contains a minor code, which gives more detailed information about * what caused the exception, and a completion status. It may also contain * a string describing the exception. @@ -47,7 +47,7 @@ public final class INV_OBJREF extends SystemException { /** - * Constructs an <code>INV_OBJREF</code> exception with a default + * Constructs an {@code INV_OBJREF} exception with a default * minor code of 0 and a completion state of COMPLETED_NO. */ public INV_OBJREF() { @@ -55,7 +55,7 @@ } /** - * Constructs an <code>INV_OBJREF</code> exception with the specified detail + * Constructs an {@code INV_OBJREF} exception with the specified detail * message, a minor code of 0, and a completion state of COMPLETED_NO. * @param s the String containing a detail message */ @@ -64,10 +64,10 @@ } /** - * Constructs an <code>INV_OBJREF</code> exception with the specified + * Constructs an {@code INV_OBJREF} exception with the specified * minor code and completion status. * @param minor the minor code - * @param completed a <code>CompletionStatus</code> instance indicating + * @param completed a {@code CompletionStatus} instance indicating * the completion status */ public INV_OBJREF(int minor, CompletionStatus completed) { @@ -75,12 +75,12 @@ } /** - * Constructs an <code>INV_OBJREF</code> exception with the specified detail + * Constructs an {@code INV_OBJREF} exception with the specified detail * message, minor code, and completion status. * A detail message is a String that describes this particular exception. * @param s the String containing a detail message * @param minor the minor code - * @param completed a <code>CompletionStatus</code> instance indicating + * @param completed a {@code CompletionStatus} instance indicating * the completion status */ public INV_OBJREF(String s, int minor, CompletionStatus completed) {
--- a/src/java.corba/share/classes/org/omg/CORBA/INV_POLICY.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/INV_POLICY.java Sun Sep 13 23:31:47 2015 +0300 @@ -28,7 +28,7 @@ /** * Standard exception thrown * when an invocation cannot be made because of an incompatibility between - * <tt>Policy</tt> overrides that apply to the particular invocation. + * {@code Policy} overrides that apply to the particular invocation. * It contains a minor code, which gives more detailed information about * what caused the exception, and a completion status. It may also contain * a string describing the exception. @@ -39,7 +39,7 @@ public final class INV_POLICY extends SystemException { /** - * Constructs a <code>INV_POLICY</code> exception with a default minor code + * Constructs a {@code INV_POLICY} exception with a default minor code * of 0, a completion state of CompletionStatus.COMPLETED_NO, * and a null description. */ @@ -48,7 +48,7 @@ } /** - * Constructs a <code>INV_POLICY</code> exception with the + * Constructs a {@code INV_POLICY} exception with the * specified description message, * a minor code of 0, and a completion state of COMPLETED_NO. * @param s the String containing a detail message @@ -58,7 +58,7 @@ } /** - * Constructs a <code>INV_POLICY</code> exception with the specified + * Constructs a {@code INV_POLICY} exception with the specified * minor code and completion status. * @param minor the minor code * @param completed the completion status @@ -68,7 +68,7 @@ } /** - * Constructs a <code>INV_POLICY</code> exception with the + * Constructs a {@code INV_POLICY} exception with the * specified description message, minor code, and completion status. * @param s the String containing a description message * @param minor the minor code
--- a/src/java.corba/share/classes/org/omg/CORBA/IRObjectOperations.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/IRObjectOperations.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,10 +26,10 @@ /** -* The interface for <tt>IRObject</tt>. For more information on -* Operations interfaces, see <a href="doc-files/generatedfiles.html#operations"> -* "Generated Files: Operations files"</a>. -*/ + * The interface for {@code IRObject}. For more information on + * Operations interfaces, see <a href="doc-files/generatedfiles.html#operations"> + * "Generated Files: Operations files"</a>. + */ /* tempout/org/omg/CORBA/IRObjectOperations.java @@ -39,7 +39,7 @@ */ /** - * This is the Operations interface for the mapping from <tt>IRObject</tt>. + * This is the Operations interface for the mapping from {@code IRObject}. * Several interfaces are used as base interfaces for objects in * the Interface Repository (IR). These base interfaces are not instantiable. * A common set of operations is used to locate objects within the @@ -59,8 +59,8 @@ // read interface /** - * Returns the <code>DefinitionKind</code> corresponding to this Interface Repository object. - * @return the <code>DefinitionKind</code> corresponding to this Interface Repository object. + * Returns the {@code DefinitionKind} corresponding to this Interface Repository object. + * @return the {@code DefinitionKind} corresponding to this Interface Repository object. */ org.omg.CORBA.DefinitionKind def_kind (); @@ -70,13 +70,13 @@ * this method is applied to all its contents. If the object contains an IDLType * attribute for an anonymous type, that IDLType is destroyed. * If the object is currently contained in some other object, it is removed. - * If the method is invoked on a <code>Repository</code> or on a <code>PrimitiveDef</code> - * then the <code>BAD_INV_ORDER</code> exception is raised with minor value 2. + * If the method is invoked on a {@code Repository} or on a {@code PrimitiveDef} + * then the {@code BAD_INV_ORDER} exception is raised with minor value 2. * An attempt to destroy an object that would leave the repository in an - * incoherent state causes <code>BAD_INV_ORDER</code> exception to be raised + * incoherent state causes {@code BAD_INV_ORDER} exception to be raised * with the minor code 1. * @exception BAD_INV_ORDER if this method is invoked on a repository or - * <code>PrimitiveDef</code>, or if an attempt to destroy an + * {@code PrimitiveDef}, or if an attempt to destroy an * object would leave the repository in an incoherent state */ void destroy ();
--- a/src/java.corba/share/classes/org/omg/CORBA/IdentifierHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/IdentifierHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Helper for <tt>Identifier</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/IdentifierHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ir.idl -* 03 June 1999 11:33:42 o'clock GMT+00:00 -*/ + * The Helper for {@code Identifier}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/IdentifierHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ir.idl + * 03 June 1999 11:33:42 o'clock GMT+00:00 + */ abstract public class IdentifierHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/IntHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/IntHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -30,57 +30,57 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for <tt>Int</tt>. For more information on + * The Holder for {@code Int}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for an <code>int</code> + * A Holder class for an {@code int} * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>long</code> as an "out" + * If an IDL method signature has an IDL {@code long} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>IntHolder</code> as the corresponding + * {@code IntHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myIntHolder</code> is an instance of <code>IntHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myIntHolder.value</code>. + * If {@code myIntHolder} is an instance of {@code IntHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myIntHolder.value}. * * @since JDK1.2 */ public final class IntHolder implements Streamable { /** - * The <code>int</code> value held by this <code>IntHolder</code> - * object in its <code>value</code> field. + * The {@code int} value held by this {@code IntHolder} + * object in its {@code value} field. */ public int value; /** - * Constructs a new <code>IntHolder</code> object with its - * <code>value</code> field initialized to <code>0</code>. + * Constructs a new {@code IntHolder} object with its + * {@code value} field initialized to {@code 0}. */ public IntHolder() { } /** - * Constructs a new <code>IntHolder</code> object with its - * <code>value</code> field initialized to the given - * <code>int</code>. - * @param initial the <code>int</code> with which to initialize - * the <code>value</code> field of the newly-created - * <code>IntHolder</code> object + * Constructs a new {@code IntHolder} object with its + * {@code value} field initialized to the given + * {@code int}. + * @param initial the {@code int} with which to initialize + * the {@code value} field of the newly-created + * {@code IntHolder} object */ public IntHolder(int initial) { value = initial; } /** - * Reads unmarshalled data from <code>input</code> and assigns it to - * the <code>value</code> field in this <code>IntHolder</code> object. + * Reads unmarshalled data from {@code input} and assigns it to + * the {@code value} field in this {@code IntHolder} object. * - * @param input the <code>InputStream</code> object containing CDR + * @param input the {@code InputStream} object containing CDR * formatted data from the wire */ public void _read(InputStream input) { @@ -88,10 +88,10 @@ } /** - * Marshals the value in this <code>IntHolder</code> object's - * <code>value</code> field to the output stream <code>output</code>. + * Marshals the value in this {@code IntHolder} object's + * {@code value} field to the output stream {@code output}. * - * @param output the <code>OutputStream</code> object that will contain + * @param output the {@code OutputStream} object that will contain * the CDR formatted data */ public void _write(OutputStream output) { @@ -99,11 +99,11 @@ } /** - * Retrieves the <code>TypeCode</code> object that corresponds - * to the value held in this <code>IntHolder</code> object's - * <code>value</code> field. + * Retrieves the {@code TypeCode} object that corresponds + * to the value held in this {@code IntHolder} object's + * {@code value} field. * - * @return the type code for the value held in this <code>IntHolder</code> + * @return the type code for the value held in this {@code IntHolder} * object */ public org.omg.CORBA.TypeCode _type() {
--- a/src/java.corba/share/classes/org/omg/CORBA/LocalObject.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/LocalObject.java Sun Sep 13 23:31:47 2015 +0300 @@ -30,26 +30,26 @@ /** * Used as a base class for implementation of a local IDL interface in the * Java language mapping. It is a class which implements all the operations - * in the <tt>org.omg.CORBA.Object</tt> interface. + * in the {@code org.omg.CORBA.Object} interface. * <P>Local interfaces are implemented by using CORBA::LocalObject - * to provide implementations of <code>Object</code> pseudo - * operations and any other ORB-specific support mechanisms that are - * appropriate for such objects. Object implementation techniques are - * inherently language-mapping specific. Therefore, the - * <code>LocalObject</code> type is not defined in IDL, but is specified - * in each language mapping. - * <P>Methods that do not apply to local objects throw - * an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with the message, - * "This is a locally contrained object." Attempting to use a - * <TT>LocalObject</TT> to create a DII request results in NO_IMPLEMENT - * system exception. Attempting to marshal or stringify a - * <TT>LocalObject</TT> results in a MARSHAL system exception. Narrowing - * and widening references to <TT>LocalObjects</TT> must work as for regular - * object references. - * <P><code>LocalObject</code> is to be used as the base class of locally - * constrained objects, such as those in the PortableServer module. - * The specification here is based on the CORBA Components - * Volume I - orbos/99-07-01 + * to provide implementations of {@code Object} pseudo + * operations and any other ORB-specific support mechanisms that are + * appropriate for such objects. Object implementation techniques are + * inherently language-mapping specific. Therefore, the + * {@code LocalObject} type is not defined in IDL, but is specified + * in each language mapping. + * <P>Methods that do not apply to local objects throw + * an {@code org.omg.CORBA.NO_IMPLEMENT} exception with the message, + * "This is a locally contrained object." Attempting to use a + * {@code LocalObject} to create a DII request results in NO_IMPLEMENT + * system exception. Attempting to marshal or stringify a + * {@code LocalObject} results in a MARSHAL system exception. Narrowing + * and widening references to {@code LocalObjects} must work as for regular + * object references. + * <P>{@code LocalObject} is to be used as the base class of locally + * constrained objects, such as those in the PortableServer module. + * The specification here is based on the CORBA Components + * Volume I - orbos/99-07-01 * * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> @@ -60,7 +60,7 @@ private static String reason = "This is a locally constrained object."; /** - * Constructs a default <code>LocalObject</code> instance. + * Constructs a default {@code LocalObject} instance. */ public LocalObject() {} @@ -75,9 +75,9 @@ * <P>Default implementation of the org.omg.CORBA.Object method. * * @param that the object reference with which to check for equivalence - * @return <code>true</code> if this object reference is known to be + * @return {@code true} if this object reference is known to be * equivalent to the given object reference. - * Note that <code>false</code> indicates only that the two + * Note that {@code false} indicates only that the two * object references are distinct, not necessarily that * they reference distinct objects. */ @@ -86,11 +86,11 @@ } /** - * Always returns <code>false</code>. + * Always returns {@code false}. * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * - * @return <code>false</code> + * @return {@code false} */ public boolean _non_existent() { return false; @@ -100,9 +100,9 @@ * Returns a hash value that is consistent for the * lifetime of the object, using the given number as the maximum. * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * - * @param maximum an <code>int</code> identifying maximum value of + * @param maximum an {@code int} identifying maximum value of * the hashcode * @return this instance's hashcode */ @@ -111,13 +111,13 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." This method * does not apply to local objects and is therefore not implemented. * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * - * @param repository_id a <code>String</code> + * @param repository_id a {@code String} * @return NO_IMPLEMENT because this is a locally constrained object * and this method does not apply to local objects * @exception NO_IMPLEMENT because this is a locally constrained object @@ -130,12 +130,12 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * - * @return a duplicate of this <code>LocalObject</code> instance. + * @return a duplicate of this {@code LocalObject} instance. * @exception NO_IMPLEMENT * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> @@ -145,10 +145,10 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * * @exception NO_IMPLEMENT * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package @@ -159,14 +159,14 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * - * @param operation a <code>String</code> giving the name of an operation + * @param operation a {@code String} giving the name of an operation * to be performed by the request that is returned - * @return a <code>Request</code> object with the given operation + * @return a {@code Request} object with the given operation * @exception NO_IMPLEMENT * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> @@ -176,20 +176,20 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * - * @param ctx a <code>Context</code> object containing + * @param ctx a {@code Context} object containing * a list of properties - * @param operation the <code>String</code> representing the name of the + * @param operation the {@code String} representing the name of the * method to be invoked - * @param arg_list an <code>NVList</code> containing the actual arguments + * @param arg_list an {@code NVList} containing the actual arguments * to the method being invoked - * @param result a <code>NamedValue</code> object to serve as a + * @param result a {@code NamedValue} object to serve as a * container for the method's return value - * @return a new <code>Request</code> object initialized with the given + * @return a new {@code Request} object initialized with the given * arguments * @exception NO_IMPLEMENT * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package @@ -203,25 +203,25 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * - * @param ctx a <code>Context</code> object containing + * @param ctx a {@code Context} object containing * a list of properties * @param operation the name of the method to be invoked - * @param arg_list an <code>NVList</code> containing the actual arguments + * @param arg_list an {@code NVList} containing the actual arguments * to the method being invoked - * @param result a <code>NamedValue</code> object to serve as a + * @param result a {@code NamedValue} object to serve as a * container for the method's return value - * @param exceptions an <code>ExceptionList</code> object containing a + * @param exceptions an {@code ExceptionList} object containing a * list of possible exceptions the method can throw - * @param contexts a <code>ContextList</code> object containing a list of + * @param contexts a {@code ContextList} object containing a list of * context strings that need to be resolved and sent * with the - * <code>Request</code> instance - * @return the new <code>Request</code> object initialized with the given + * {@code Request} instance + * @return the new {@code Request} object initialized with the given * arguments * @exception NO_IMPLEMENT * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package @@ -237,11 +237,11 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." This method * does not apply to local objects and is therefore not implemented. * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * * @return NO_IMPLEMENT because this is a locally constrained object * and this method does not apply to local objects @@ -256,10 +256,10 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * * @exception NO_IMPLEMENT * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package @@ -278,12 +278,12 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * @return the ORB instance that created the Delegate contained in this - * <code>ObjectImpl</code> + * {@code ObjectImpl} * @exception NO_IMPLEMENT * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> @@ -293,13 +293,13 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." This method * does not apply to local objects and is therefore not implemented. * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * - * @param policy_type an <code>int</code> + * @param policy_type an {@code int} * @return NO_IMPLEMENT because this is a locally constrained object * and this method does not apply to local objects * @exception NO_IMPLEMENT because this is a locally constrained object @@ -313,11 +313,11 @@ /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." This method * does not apply to local objects and is therefore not implemented. * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * * @exception NO_IMPLEMENT * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package @@ -328,11 +328,11 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." This method * does not apply to local objects and is therefore not implemented. * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * * @param policies an array * @param set_add a flag @@ -351,13 +351,13 @@ /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method.<P> - * Returns <code>true</code> for this <code>LocalObject</code> instance. + * {@code org.omg.CORBA.Object} method.<P> + * Returns {@code true} for this {@code LocalObject} instance. * - * @return <code>true</code> always + * @return {@code true} always * @exception NO_IMPLEMENT * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> @@ -367,12 +367,12 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * - * @param operation a <code>String</code> indicating which operation + * @param operation a {@code String} indicating which operation * to preinvoke * @param expectedType the class of the type of operation mentioned above * @return NO_IMPLEMENT because this is a locally constrained object @@ -388,10 +388,10 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * * @param servant the servant object on which to post-invoke * @exception NO_IMPLEMENT @@ -408,17 +408,17 @@ */ /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * <P>Called by a stub to obtain an OutputStream for * marshaling arguments. The stub must supply the operation name, * and indicate if a response is expected (i.e is this a oneway call). * * @param operation the name of the operation being requested - * @param responseExpected <code>true</code> if a response is expected, - * <code>false</code> if it is a one-way call + * @param responseExpected {@code true} if a response is expected, + * {@code false} if it is a one-way call * @return NO_IMPLEMENT because this is a locally constrained object * and this method does not apply to local objects * @exception NO_IMPLEMENT because this is a locally constrained object @@ -432,32 +432,32 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * <P>Called to invoke an operation. The stub provides an - * <code>OutputStream</code> that was previously returned by a - * <code>_request()</code> - * call. <code>_invoke</code> returns an <code>InputStream</code> which + * {@code OutputStream} that was previously returned by a + * {@code _request()} + * call. {@code _invoke} returns an {@code InputStream} which * contains the - * marshaled reply. If an exception occurs, <code>_invoke</code> may throw an - * <code>ApplicationException</code> object which contains an - * <code>InputStream</code> from + * marshaled reply. If an exception occurs, {@code _invoke} may throw an + * {@code ApplicationException} object which contains an + * {@code InputStream} from * which the user exception state may be unmarshaled. * - * @param output the <code>OutputStream</code> to invoke + * @param output the {@code OutputStream} to invoke * @return NO_IMPLEMENT because this is a locally constrained object * and this method does not apply to local objects * @throws ApplicationException If an exception occurs, - * <code>_invoke</code> may throw an - * <code>ApplicationException</code> object which contains - * an <code>InputStream</code> from + * {@code _invoke} may throw an + * {@code ApplicationException} object which contains + * an {@code InputStream} from * which the user exception state may be unmarshaled. * @throws RemarshalException If an exception occurs, - * <code>_invoke</code> may throw an - * <code>ApplicationException</code> object which contains - * an <code>InputStream</code> from + * {@code _invoke} may throw an + * {@code ApplicationException} object which contains + * an {@code InputStream} from * which the user exception state may be unmarshaled. * @exception NO_IMPLEMENT because this is a locally constrained object * and this method does not apply to local objects @@ -471,17 +471,17 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * <P>May optionally be called by a stub to release a * reply stream back to the ORB when the unmarshaling has - * completed. The stub passes the <code>InputStream</code> returned by - * <code>_invoke()</code> or - * <code>ApplicationException.getInputStream()</code>. + * completed. The stub passes the {@code InputStream} returned by + * {@code _invoke()} or + * {@code ApplicationException.getInputStream()}. * A null - * value may also be passed to <code>_releaseReply</code>, in which case the + * value may also be passed to {@code _releaseReply}, in which case the * method is a no-op. * * @param input the reply stream back to the ORB or null @@ -494,11 +494,11 @@ } /** - * Throws an <code>org.omg.CORBA.NO_IMPLEMENT</code> exception with + * Throws an {@code org.omg.CORBA.NO_IMPLEMENT} exception with * the message "This is a locally constrained object." This method * does not apply to local objects and is therefore not implemented. * This method is the default implementation of the - * <code>org.omg.CORBA.Object</code> method. + * {@code org.omg.CORBA.Object} method. * * @return NO_IMPLEMENT because this is a locally constrained object * and this method does not apply to local objects
--- a/src/java.corba/share/classes/org/omg/CORBA/LongHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/LongHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -30,54 +30,54 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for <tt>Long</tt>. For more information on + * The Holder for {@code Long}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for a <code>long</code> + * A Holder class for a {@code long} * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>long long</code> as an "out" + * If an IDL method signature has an IDL {@code long long} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>LongHolder</code> as the corresponding + * {@code LongHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myLongHolder</code> is an instance of <code>LongHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myLongHolder.value</code>. + * If {@code myLongHolder} is an instance of {@code LongHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myLongHolder.value}. * * @since JDK1.2 */ public final class LongHolder implements Streamable { /** - * The <code>long</code> value held by this <code>LongHolder</code> + * The {@code long} value held by this {@code LongHolder} * object. */ public long value; /** - * Constructs a new <code>LongHolder</code> object with its - * <code>value</code> field initialized to <code>0</code>. + * Constructs a new {@code LongHolder} object with its + * {@code value} field initialized to {@code 0}. */ public LongHolder() { } /** - * Constructs a new <code>LongHolder</code> object with its - * <code>value</code> field initialized to the given - * <code>long</code>. - * @param initial the <code>long</code> with which to initialize - * the <code>value</code> field of the newly-created - * <code>LongHolder</code> object + * Constructs a new {@code LongHolder} object with its + * {@code value} field initialized to the given + * {@code long}. + * @param initial the {@code long} with which to initialize + * the {@code value} field of the newly-created + * {@code LongHolder} object */ public LongHolder(long initial) { value = initial; } /** - * Reads from <code>input</code> and initalizes the value in the Holder + * Reads from {@code input} and initalizes the value in the Holder * with the unmarshalled data. * * @param input the InputStream containing CDR formatted data from the wire @@ -87,7 +87,7 @@ } /** - * Marshals to <code>output</code> the value in the Holder. + * Marshals to {@code output} the value in the Holder. * * @param output the OutputStream which will contain the CDR formatted data */ @@ -96,7 +96,7 @@ } /** - * Returns the <code>TypeCode</code> object + * Returns the {@code TypeCode} object * corresponding to the value held in the Holder. * * @return the TypeCode of the value held in the holder
--- a/src/java.corba/share/classes/org/omg/CORBA/LongLongSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/LongLongSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,26 +26,26 @@ /** -* The Helper for <tt>LongLongSeq</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/LongLongSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:37 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -* <ul> -* <li> ORB core as defined by CORBA 2.3.1 -* (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) -* </li> -* -* <li> IDL/Java Language Mapping as defined in -* <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> -* </li> -* </ul> -*/ + * The Helper for {@code LongLongSeq}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/LongLongSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:37 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + * <ul> + * <li> ORB core as defined by CORBA 2.3.1 + * (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) + * </li> + * + * <li> IDL/Java Language Mapping as defined in + * <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> + * </li> + * </ul> + */ public abstract class LongLongSeqHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/LongLongSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/LongLongSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Holder for <tt>LongLongSeq</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/LongLongSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code LongLongSeq}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/LongLongSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class LongLongSeqHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/LongSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/LongSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,26 +26,26 @@ /** -* The Helper for <tt>LongSeqHelper</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/LongSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -* <ul> -* <li> ORB core as defined by CORBA 2.3.1 -* (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) -* </li> -* -* <li> IDL/Java Language Mapping as defined in -* <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> -* </li> -* </ul> -*/ + * The Helper for {@code LongSeqHelper}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/LongSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + * <ul> + * <li> ORB core as defined by CORBA 2.3.1 + * (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) + * </li> + * + * <li> IDL/Java Language Mapping as defined in + * <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> + * </li> + * </ul> + */ public abstract class LongSeqHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/LongSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/LongSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Holder for <tt>LongSeq</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/LongSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code LongSeq}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/LongSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class LongSeqHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/MARSHAL.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/MARSHAL.java Sun Sep 13 23:31:47 2015 +0300 @@ -31,7 +31,7 @@ * or server-side run time. For example, if a reply from the server * indicates that the message contains 1000 bytes, but the actual * message is shorter or longer than 1000 bytes, the ORB raises - * this exception. <tt>MARSHAL</tt> can also be caused by using + * this exception. {@code MARSHAL} can also be caused by using * the DII or DSI incorrectly, for example, if the type of the * actual parameters sent does not agree with IDL signature of an * operation.<P> @@ -47,7 +47,7 @@ public final class MARSHAL extends SystemException { /** - * Constructs a <code>MARSHAL</code> exception with a default minor code + * Constructs a {@code MARSHAL} exception with a default minor code * of 0, a completion state of CompletionStatus.COMPLETED_NO, * and a null description. */ @@ -56,7 +56,7 @@ } /** - * Constructs a <code>MARSHAL</code> exception with the specified description message, + * Constructs a {@code MARSHAL} exception with the specified description message, * a minor code of 0, and a completion state of COMPLETED_NO. * @param s the String containing a description of the exception */ @@ -65,7 +65,7 @@ } /** - * Constructs a <code>MARSHAL</code> exception with the specified + * Constructs a {@code MARSHAL} exception with the specified * minor code and completion status. * @param minor the minor code * @param completed the completion status @@ -75,7 +75,7 @@ } /** - * Constructs a <code>MARSHAL</code> exception with the specified description + * Constructs a {@code MARSHAL} exception with the specified description * message, minor code, and completion status. * @param s the String containing a description message * @param minor the minor code
--- a/src/java.corba/share/classes/org/omg/CORBA/NO_IMPLEMENT.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/NO_IMPLEMENT.java Sun Sep 13 23:31:47 2015 +0300 @@ -28,7 +28,7 @@ /** * This exception indicates that even though the operation that * was invoked exists (it has an IDL definition), no implementation - * for that operation exists. <tt>NO_IMPLEMENT</tt> can, for + * for that operation exists. {@code NO_IMPLEMENT} can, for * example, be raised by an ORB if a client asks for an object's * type definition from the interface repository, but no interface * repository is provided by the ORB.<P> @@ -44,7 +44,7 @@ public final class NO_IMPLEMENT extends SystemException { /** - * Constructs a <code>NO_IMPLEMENT</code> exception with a default minor code + * Constructs a {@code NO_IMPLEMENT} exception with a default minor code * of 0, a completion state of CompletionStatus.COMPLETED_NO, * and a null description. */ @@ -53,7 +53,7 @@ } /** - * Constructs a <code>NO_IMPLEMENT</code> exception with the specified description message, + * Constructs a {@code NO_IMPLEMENT} exception with the specified description message, * a minor code of 0, and a completion state of COMPLETED_NO. * @param s the String containing a description of the exception */ @@ -62,10 +62,10 @@ } /** - * Constructs a <code>NO_IMPLEMENT</code> exception with the specified + * Constructs a {@code NO_IMPLEMENT} exception with the specified * minor code and completion status. - * @param minor an <code>int</code> specifying the minor code - * @param completed a <code>CompletionStatus</code> instance indicating + * @param minor an {@code int} specifying the minor code + * @param completed a {@code CompletionStatus} instance indicating * the completion status */ public NO_IMPLEMENT(int minor, CompletionStatus completed) { @@ -73,11 +73,11 @@ } /** - * Constructs a <code>NO_IMPLEMENT</code> exception with the specified description + * Constructs a {@code NO_IMPLEMENT} exception with the specified description * message, minor code, and completion status. * @param s the String containing a description message - * @param minor an <code>int</code> specifying the minor code - * @param completed a <code>CompletionStatus</code> instance indicating + * @param minor an {@code int} specifying the minor code + * @param completed a {@code CompletionStatus} instance indicating * the completion status */ public NO_IMPLEMENT(String s, int minor, CompletionStatus completed) {
--- a/src/java.corba/share/classes/org/omg/CORBA/NameValuePair.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/NameValuePair.java Sun Sep 13 23:31:47 2015 +0300 @@ -28,33 +28,33 @@ /** * Associates a name with a value that is an - * attribute of an IDL struct, and is used in the <tt>DynStruct</tt> APIs. + * attribute of an IDL struct, and is used in the {@code DynStruct} APIs. */ public final class NameValuePair implements org.omg.CORBA.portable.IDLEntity { /** - * The name to be associated with a value by this <code>NameValuePair</code> object. + * The name to be associated with a value by this {@code NameValuePair} object. */ public String id; /** - * The value to be associated with a name by this <code>NameValuePair</code> object. + * The value to be associated with a name by this {@code NameValuePair} object. */ public org.omg.CORBA.Any value; /** - * Constructs an empty <code>NameValuePair</code> object. + * Constructs an empty {@code NameValuePair} object. * To associate a name with a value after using this constructor, the fields * of this object have to be accessed individually. */ public NameValuePair() { } /** - * Constructs a <code>NameValuePair</code> object that associates - * the given name with the given <code>org.omg.CORBA.Any</code> object. - * @param __id the name to be associated with the given <code>Any</code> object - * @param __value the <code>Any</code> object to be associated with the given name + * Constructs a {@code NameValuePair} object that associates + * the given name with the given {@code org.omg.CORBA.Any} object. + * @param __id the name to be associated with the given {@code Any} object + * @param __value the {@code Any} object to be associated with the given name */ public NameValuePair(String __id, org.omg.CORBA.Any __value) { id = __id;
--- a/src/java.corba/share/classes/org/omg/CORBA/NameValuePairHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/NameValuePairHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,13 +26,13 @@ /** -* The Helper for <tt>NameValuePair</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/NameValuePairHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* 03 June 1999 11:52:03 o'clock GMT+00:00 -*/ + * The Helper for {@code NameValuePair}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/NameValuePairHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * 03 June 1999 11:52:03 o'clock GMT+00:00 + */ abstract public class NameValuePairHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/ORB.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ORB.java Sun Sep 13 23:31:47 2015 +0300 @@ -40,7 +40,7 @@ /** * A class providing APIs for the CORBA Object Request Broker - * features. The <code>ORB</code> class also provides + * features. The {@code ORB} class also provides * "pluggable ORB implementation" APIs that allow another vendor's ORB * implementation to be used. * <P> @@ -49,12 +49,12 @@ * objects servicing requests (servers). * <P> * - * The <code>ORB</code> class, which + * The {@code ORB} class, which * encapsulates generic CORBA functionality, does the following: * (Note that items 5 and 6, which include most of the methods in - * the class <code>ORB</code>, are typically used with the <code>Dynamic Invocation - * Interface</code> (DII) and the <code>Dynamic Skeleton Interface</code> - * (DSI). + * the class {@code ORB}, are typically used with the + * {@code Dynamic Invocation Interface} (DII) and + * the {@code Dynamic Skeleton Interface} (DSI). * These interfaces may be used by a developer directly, but * most commonly they are used by the ORB internally and are * not seen by the general programmer.) @@ -62,29 +62,29 @@ * <li> initializes the ORB implementation by supplying values for * predefined properties and environmental parameters * <li> obtains initial object references to services such as - * the NameService using the method <code>resolve_initial_references</code> + * the NameService using the method {@code resolve_initial_references} * <li> converts object references to strings and back * <li> connects the ORB to a servant (an instance of a CORBA object * implementation) and disconnects the ORB from a servant * <li> creates objects such as * <ul> - * <li><code>TypeCode</code> - * <li><code>Any</code> - * <li><code>NamedValue</code> - * <li><code>Context</code> - * <li><code>Environment</code> - * <li>lists (such as <code>NVList</code>) containing these objects + * <li>{@code TypeCode} + * <li>{@code Any} + * <li>{@code NamedValue} + * <li>{@code Context} + * <li>{@code Environment} + * <li>lists (such as {@code NVList}) containing these objects * </ul> * <li> sends multiple messages in the DII * </OL> * * <P> - * The <code>ORB</code> class can be used to obtain references to objects + * The {@code ORB} class can be used to obtain references to objects * implemented anywhere on the network. * <P> * An application or applet gains access to the CORBA environment - * by initializing itself into an <code>ORB</code> using one of - * three <code>init</code> methods. Two of the three methods use the properties + * by initializing itself into an {@code ORB} using one of + * three {@code init} methods. Two of the three methods use the properties * (associations of a name with a value) shown in the * table below.<BR> * <TABLE BORDER=1 SUMMARY="Standard Java CORBA Properties"> @@ -93,10 +93,10 @@ * <TR><TD>org.omg.CORBA.ORBClass</TD> * <TD>class name of an ORB implementation</TD></TR> * <TR><TD>org.omg.CORBA.ORBSingletonClass</TD> - * <TD>class name of the ORB returned by <code>init()</code></TD></TR> + * <TD>class name of the ORB returned by {@code init()}</TD></TR> * </TABLE> * <P> - * These properties allow a different vendor's <code>ORB</code> + * These properties allow a different vendor's {@code ORB} * implementation to be "plugged in." * <P> * When an ORB instance is being created, the class name of the ORB @@ -122,12 +122,12 @@ * <P> * Note that Java IDL provides a default implementation for the * fully-functional ORB and for the Singleton ORB. When the method - * <code>init</code> is given no parameters, the default Singleton - * ORB is returned. When the method <code>init</code> is given parameters + * {@code init} is given no parameters, the default Singleton + * ORB is returned. When the method {@code init} is given parameters * but no ORB class is specified, the Java IDL ORB implementation * is returned. * <P> - * The following code fragment creates an <code>ORB</code> object + * The following code fragment creates an {@code ORB} object * initialized with the default ORB Singleton. * This ORB has a * restricted implementation to prevent malicious applets from doing @@ -138,9 +138,9 @@ * ORB orb = ORB.init(); * </PRE> * <P> - * The following code fragment creates an <code>ORB</code> object - * for an application. The parameter <code>args</code> - * represents the arguments supplied to the application's <code>main</code> + * The following code fragment creates an {@code ORB} object + * for an application. The parameter {@code args} + * represents the arguments supplied to the application's {@code main} * method. Since the property specifies the ORB class to be * "SomeORBImplementation", the new ORB will be initialized with * that ORB implementation. If p had been null, @@ -153,7 +153,7 @@ * ORB orb = ORB.init(args, p); * </PRE> * <P> - * The following code fragment creates an <code>ORB</code> object + * The following code fragment creates an {@code ORB} object * for the applet supplied as the first parameter. If the given * applet does not specify an ORB class, the new ORB will be * initialized with the default Java IDL implementation. @@ -271,27 +271,27 @@ } /** - * Returns the <code>ORB</code> singleton object. This method always returns the + * Returns the {@code ORB} singleton object. This method always returns the * same ORB instance, which is an instance of the class described by the - * <code>org.omg.CORBA.ORBSingletonClass</code> system property. + * {@code org.omg.CORBA.ORBSingletonClass} system property. * <P> - * This no-argument version of the method <code>init</code> is used primarily - * as a factory for <code>TypeCode</code> objects, which are used by - * <code>Helper</code> classes to implement the method <code>type</code>. - * It is also used to create <code>Any</code> objects that are used to - * describe <code>union</code> labels (as part of creating a <code> - * TypeCode</code> object for a <code>union</code>). + * This no-argument version of the method {@code init} is used primarily + * as a factory for {@code TypeCode} objects, which are used by + * {@code Helper} classes to implement the method {@code type}. + * It is also used to create {@code Any} objects that are used to + * describe {@code union} labels (as part of creating a + * {@code TypeCode} object for a {@code union}). * <P> * This method is not intended to be used by applets, and in the event * that it is called in an applet environment, the ORB it returns * is restricted so that it can be used only as a factory for - * <code>TypeCode</code> objects. Any <code>TypeCode</code> objects + * {@code TypeCode} objects. Any {@code TypeCode} objects * it produces can be safely shared among untrusted applets. * <P> * If an ORB is created using this method from an applet, * a system exception will be thrown if * methods other than those for - * creating <code>TypeCode</code> objects are invoked. + * creating {@code TypeCode} objects are invoked. * * @return the singleton ORB * @@ -350,13 +350,13 @@ } /** - * Creates a new <code>ORB</code> instance for a standalone + * Creates a new {@code ORB} instance for a standalone * application. This method may be called from applications - * only and returns a new fully functional <code>ORB</code> object + * only and returns a new fully functional {@code ORB} object * each time it is called. - * @param args command-line arguments for the application's <code>main</code> - * method; may be <code>null</code> - * @param props application-specific properties; may be <code>null</code> + * @param args command-line arguments for the application's {@code main} + * method; may be {@code null} + * @param props application-specific properties; may be {@code null} * @return the newly-created ORB instance * * @implNote @@ -394,11 +394,11 @@ /** - * Creates a new <code>ORB</code> instance for an applet. This + * Creates a new {@code ORB} instance for an applet. This * method may be called from applets only and returns a new - * fully-functional <code>ORB</code> object each time it is called. - * @param app the applet; may be <code>null</code> - * @param props applet-specific properties; may be <code>null</code> + * fully-functional {@code ORB} object each time it is called. + * @param app the applet; may be {@code null} + * @param props applet-specific properties; may be {@code null} * @return the newly-created ORB instance * * @implNote @@ -430,11 +430,11 @@ * Allows the ORB implementation to be initialized with the given * parameters and properties. This method, used in applications only, * is implemented by subclass ORB implementations and called - * by the appropriate <code>init</code> method to pass in its parameters. + * by the appropriate {@code init} method to pass in its parameters. * - * @param args command-line arguments for the application's <code>main</code> - * method; may be <code>null</code> - * @param props application-specific properties; may be <code>null</code> + * @param args command-line arguments for the application's {@code main} + * method; may be {@code null} + * @param props application-specific properties; may be {@code null} */ abstract protected void set_parameters(String[] args, Properties props); @@ -442,10 +442,10 @@ * Allows the ORB implementation to be initialized with the given * applet and parameters. This method, used in applets only, * is implemented by subclass ORB implementations and called - * by the appropriate <code>init</code> method to pass in its parameters. + * by the appropriate {@code init} method to pass in its parameters. * - * @param app the applet; may be <code>null</code> - * @param props applet-specific properties; may be <code>null</code> + * @param app the applet; may be {@code null} + * @param props applet-specific properties; may be {@code null} */ abstract protected void set_parameters(Applet app, Properties props); @@ -453,17 +453,17 @@ * Connects the given servant object (a Java object that is * an instance of the server implementation class) * to the ORB. The servant class must - * extend the <code>ImplBase</code> class corresponding to the interface that is + * extend the {@code ImplBase} class corresponding to the interface that is * supported by the server. The servant must thus be a CORBA object - * reference, and inherit from <code>org.omg.CORBA.Object</code>. + * reference, and inherit from {@code org.omg.CORBA.Object}. * Servants created by the user can start receiving remote invocations - * after the method <code>connect</code> has been called. A servant may also be + * after the method {@code connect} has been called. A servant may also be * automatically and implicitly connected to the ORB if it is passed as * an IDL parameter in an IDL method invocation on a non-local object, * that is, if the servant object has to be marshalled and sent outside of the * process address space. * <P> - * Calling the method <code>connect</code> has no effect + * Calling the method {@code connect} has no effect * when the servant object is already connected to the ORB. * <P> * Deprecated by the OMG in favor of the Portable Object Adapter APIs. @@ -477,17 +477,17 @@ /** * Destroys the ORB so that its resources can be reclaimed. * Any operation invoked on a destroyed ORB reference will throw the - * <code>OBJECT_NOT_EXIST</code> exception. - * Once an ORB has been destroyed, another call to <code>init</code> + * {@code OBJECT_NOT_EXIST} exception. + * Once an ORB has been destroyed, another call to {@code init} * with the same ORBid will return a reference to a newly constructed ORB.<p> - * If <code>destroy</code> is called on an ORB that has not been shut down, + * If {@code destroy} is called on an ORB that has not been shut down, * it will start the shut down process and block until the ORB has shut down * before it destroys the ORB.<br> - * If an application calls <code>destroy</code> in a thread that is currently servicing - * an invocation, the <code>BAD_INV_ORDER</code> system exception will be thrown + * If an application calls {@code destroy} in a thread that is currently servicing + * an invocation, the {@code BAD_INV_ORDER} system exception will be thrown * with the OMG minor code 3, since blocking would result in a deadlock.<p> * For maximum portability and to avoid resource leaks, an application should - * always call <code>shutdown</code> and <code>destroy</code> + * always call {@code shutdown} and {@code destroy} * on all ORB instances before exiting. * * @throws org.omg.CORBA.BAD_INV_ORDER if the current thread is servicing an invocation @@ -500,14 +500,14 @@ * Disconnects the given servant object from the ORB. After this method returns, * the ORB will reject incoming remote requests for the disconnected * servant and will send the exception - * <code>org.omg.CORBA.OBJECT_NOT_EXIST</code> back to the + * {@code org.omg.CORBA.OBJECT_NOT_EXIST} back to the * remote client. Thus the object appears to be destroyed from the * point of view of remote clients. Note, however, that local requests issued * using the servant directly do not * pass through the ORB; hence, they will continue to be processed by the * servant. * <P> - * Calling the method <code>disconnect</code> has no effect + * Calling the method {@code disconnect} has no effect * if the servant is not connected to the ORB. * <P> * Deprecated by the OMG in favor of the Portable Object Adapter APIs. @@ -535,7 +535,7 @@ * Returns a list of the initially available CORBA object references, * such as "NameService" and "InterfaceRepository". * - * @return an array of <code>String</code> objects that represent + * @return an array of {@code String} objects that represent * the object references for CORBA services * that are initially available with this ORB */ @@ -559,8 +559,8 @@ * strings generated by a different ORB to be converted back into an object * reference. * <P> - * The resulting <code>String</code> object may be stored or communicated - * in any way that a <code>String</code> object can be manipulated. + * The resulting {@code String} object may be stored or communicated + * in any way that a {@code String} object can be manipulated. * * @param obj the object reference to stringify * @return the string representing the object reference @@ -568,43 +568,43 @@ abstract public String object_to_string(org.omg.CORBA.Object obj); /** - * Converts a string produced by the method <code>object_to_string</code> + * Converts a string produced by the method {@code object_to_string} * back to a CORBA object reference. * * @param str the string to be converted back to an object reference. It must * be the result of converting an object reference to a string using the - * method <code>object_to_string</code>. + * method {@code object_to_string}. * @return the object reference */ abstract public org.omg.CORBA.Object string_to_object(String str); /** - * Allocates an <code>NVList</code> with (probably) enough - * space for the specified number of <code>NamedValue</code> objects. + * Allocates an {@code NVList} with (probably) enough + * space for the specified number of {@code NamedValue} objects. * Note that the specified size is only a hint to help with * storage allocation and does not imply the maximum size of the list. * - * @param count suggested number of <code>NamedValue</code> objects for + * @param count suggested number of {@code NamedValue} objects for * which to allocate space - * @return the newly-created <code>NVList</code> + * @return the newly-created {@code NVList} * * @see NVList */ abstract public NVList create_list(int count); /** - * Creates an <code>NVList</code> initialized with argument + * Creates an {@code NVList} initialized with argument * descriptions for the operation described in the given - * <code>OperationDef</code> object. This <code>OperationDef</code> object + * {@code OperationDef} object. This {@code OperationDef} object * is obtained from an Interface Repository. The arguments in the - * returned <code>NVList</code> object are in the same order as in the + * returned {@code NVList} object are in the same order as in the * original IDL operation definition, which makes it possible for the list * to be used in dynamic invocation requests. * - * @param oper the <code>OperationDef</code> object to use to create the list - * @return a newly-created <code>NVList</code> object containing + * @param oper the {@code OperationDef} object to use to create the list + * @return a newly-created {@code NVList} object containing * descriptions of the arguments to the method described in the given - * <code>OperationDef</code> object + * {@code OperationDef} object * * @see NVList */ @@ -657,63 +657,63 @@ /** - * Creates a <code>NamedValue</code> object + * Creates a {@code NamedValue} object * using the given name, value, and argument mode flags. * <P> - * A <code>NamedValue</code> object serves as (1) a parameter or return + * A {@code NamedValue} object serves as (1) a parameter or return * value or (2) a context property. * It may be used by itself or - * as an element in an <code>NVList</code> object. + * as an element in an {@code NVList} object. * - * @param s the name of the <code>NamedValue</code> object - * @param any the <code>Any</code> value to be inserted into the - * <code>NamedValue</code> object - * @param flags the argument mode flags for the <code>NamedValue</code>: one of - * <code>ARG_IN.value</code>, <code>ARG_OUT.value</code>, - * or <code>ARG_INOUT.value</code>. + * @param s the name of the {@code NamedValue} object + * @param any the {@code Any} value to be inserted into the + * {@code NamedValue} object + * @param flags the argument mode flags for the {@code NamedValue}: one of + * {@code ARG_IN.value}, {@code ARG_OUT.value}, + * or {@code ARG_INOUT.value}. * - * @return the newly-created <code>NamedValue</code> object + * @return the newly-created {@code NamedValue} object * @see NamedValue */ abstract public NamedValue create_named_value(String s, Any any, int flags); /** - * Creates an empty <code>ExceptionList</code> object. + * Creates an empty {@code ExceptionList} object. * - * @return the newly-created <code>ExceptionList</code> object + * @return the newly-created {@code ExceptionList} object */ abstract public ExceptionList create_exception_list(); /** - * Creates an empty <code>ContextList</code> object. + * Creates an empty {@code ContextList} object. * - * @return the newly-created <code>ContextList</code> object + * @return the newly-created {@code ContextList} object * @see ContextList * @see Context */ abstract public ContextList create_context_list(); /** - * Gets the default <code>Context</code> object. + * Gets the default {@code Context} object. * - * @return the default <code>Context</code> object + * @return the default {@code Context} object * @see Context */ abstract public Context get_default_context(); /** - * Creates an <code>Environment</code> object. + * Creates an {@code Environment} object. * - * @return the newly-created <code>Environment</code> object + * @return the newly-created {@code Environment} object * @see Environment */ abstract public Environment create_environment(); /** - * Creates a new <code>org.omg.CORBA.portable.OutputStream</code> into which + * Creates a new {@code org.omg.CORBA.portable.OutputStream} into which * IDL method parameters can be marshalled during method invocation. - * @return the newly-created - * <code>org.omg.CORBA.portable.OutputStream</code> object + * @return the newly-created + * {@code org.omg.CORBA.portable.OutputStream} object */ abstract public org.omg.CORBA.portable.OutputStream create_output_stream(); @@ -722,31 +722,31 @@ * any responses. Note that oneway invocations are not guaranteed to * reach the server. * - * @param req an array of request objects + * @param req an array of request objects */ abstract public void send_multiple_requests_oneway(Request[] req); /** * Sends multiple dynamic (DII) requests asynchronously. * - * @param req an array of <code>Request</code> objects + * @param req an array of {@code Request} objects */ abstract public void send_multiple_requests_deferred(Request[] req); /** * Finds out if any of the deferred (asynchronous) invocations have * a response yet. - * @return <code>true</code> if there is a response available; - * <code> false</code> otherwise + * @return {@code true} if there is a response available; + * {@code false} otherwise */ abstract public boolean poll_next_response(); /** - * Gets the next <code>Request</code> instance for which a response + * Gets the next {@code Request} instance for which a response * has been received. * - * @return the next <code>Request</code> object ready with a response - * @exception WrongTransaction if the method <code>get_next_response</code> + * @return the next {@code Request} object ready with a response + * @exception WrongTransaction if the method {@code get_next_response} * is called from a transaction scope different * from the one from which the original request was sent. See the * OMG Transaction Service specification for details. @@ -754,150 +754,150 @@ abstract public Request get_next_response() throws WrongTransaction; /** - * Retrieves the <code>TypeCode</code> object that represents + * Retrieves the {@code TypeCode} object that represents * the given primitive IDL type. * - * @param tcKind the <code>TCKind</code> instance corresponding to the + * @param tcKind the {@code TCKind} instance corresponding to the * desired primitive type - * @return the requested <code>TypeCode</code> object + * @return the requested {@code TypeCode} object */ abstract public TypeCode get_primitive_tc(TCKind tcKind); /** - * Creates a <code>TypeCode</code> object representing an IDL <code>struct</code>. - * The <code>TypeCode</code> object is initialized with the given id, + * Creates a {@code TypeCode} object representing an IDL {@code struct}. + * The {@code TypeCode} object is initialized with the given id, * name, and members. * - * @param id the repository id for the <code>struct</code> - * @param name the name of the <code>struct</code> - * @param members an array describing the members of the <code>struct</code> - * @return a newly-created <code>TypeCode</code> object describing - * an IDL <code>struct</code> + * @param id the repository id for the {@code struct} + * @param name the name of the {@code struct} + * @param members an array describing the members of the {@code struct} + * @return a newly-created {@code TypeCode} object describing + * an IDL {@code struct} */ abstract public TypeCode create_struct_tc(String id, String name, StructMember[] members); /** - * Creates a <code>TypeCode</code> object representing an IDL <code>union</code>. - * The <code>TypeCode</code> object is initialized with the given id, + * Creates a {@code TypeCode} object representing an IDL {@code union}. + * The {@code TypeCode} object is initialized with the given id, * name, discriminator type, and members. * - * @param id the repository id of the <code>union</code> - * @param name the name of the <code>union</code> - * @param discriminator_type the type of the <code>union</code> discriminator - * @param members an array describing the members of the <code>union</code> - * @return a newly-created <code>TypeCode</code> object describing - * an IDL <code>union</code> + * @param id the repository id of the {@code union} + * @param name the name of the {@code union} + * @param discriminator_type the type of the {@code union} discriminator + * @param members an array describing the members of the {@code union} + * @return a newly-created {@code TypeCode} object describing + * an IDL {@code union} */ abstract public TypeCode create_union_tc(String id, String name, TypeCode discriminator_type, UnionMember[] members); /** - * Creates a <code>TypeCode</code> object representing an IDL <code>enum</code>. - * The <code>TypeCode</code> object is initialized with the given id, + * Creates a {@code TypeCode} object representing an IDL {@code enum}. + * The {@code TypeCode} object is initialized with the given id, * name, and members. * - * @param id the repository id for the <code>enum</code> - * @param name the name for the <code>enum</code> - * @param members an array describing the members of the <code>enum</code> - * @return a newly-created <code>TypeCode</code> object describing - * an IDL <code>enum</code> + * @param id the repository id for the {@code enum} + * @param name the name for the {@code enum} + * @param members an array describing the members of the {@code enum} + * @return a newly-created {@code TypeCode} object describing + * an IDL {@code enum} */ abstract public TypeCode create_enum_tc(String id, String name, String[] members); /** - * Creates a <code>TypeCode</code> object representing an IDL <code>alias</code> - * (<code>typedef</code>). - * The <code>TypeCode</code> object is initialized with the given id, + * Creates a {@code TypeCode} object representing an IDL {@code alias} + * ({@code typedef}). + * The {@code TypeCode} object is initialized with the given id, * name, and original type. * * @param id the repository id for the alias * @param name the name for the alias * @param original_type - * the <code>TypeCode</code> object describing the original type - * for which this is an alias - * @return a newly-created <code>TypeCode</code> object describing - * an IDL <code>alias</code> + * the {@code TypeCode} object describing the original type + * for which this is an alias + * @return a newly-created {@code TypeCode} object describing + * an IDL {@code alias} */ abstract public TypeCode create_alias_tc(String id, String name, TypeCode original_type); /** - * Creates a <code>TypeCode</code> object representing an IDL <code>exception</code>. - * The <code>TypeCode</code> object is initialized with the given id, + * Creates a {@code TypeCode} object representing an IDL {@code exception}. + * The {@code TypeCode} object is initialized with the given id, * name, and members. * - * @param id the repository id for the <code>exception</code> - * @param name the name for the <code>exception</code> - * @param members an array describing the members of the <code>exception</code> - * @return a newly-created <code>TypeCode</code> object describing - * an IDL <code>exception</code> + * @param id the repository id for the {@code exception} + * @param name the name for the {@code exception} + * @param members an array describing the members of the {@code exception} + * @return a newly-created {@code TypeCode} object describing + * an IDL {@code exception} */ abstract public TypeCode create_exception_tc(String id, String name, StructMember[] members); /** - * Creates a <code>TypeCode</code> object representing an IDL <code>interface</code>. - * The <code>TypeCode</code> object is initialized with the given id + * Creates a {@code TypeCode} object representing an IDL {@code interface}. + * The {@code TypeCode} object is initialized with the given id * and name. * - * @param id the repository id for the interface - * @param name the name for the interface - * @return a newly-created <code>TypeCode</code> object describing - * an IDL <code>interface</code> + * @param id the repository id for the interface + * @param name the name for the interface + * @return a newly-created {@code TypeCode} object describing + * an IDL {@code interface} */ abstract public TypeCode create_interface_tc(String id, String name); /** - * Creates a <code>TypeCode</code> object representing a bounded IDL - * <code>string</code>. - * The <code>TypeCode</code> object is initialized with the given bound, + * Creates a {@code TypeCode} object representing a bounded IDL + * {@code string}. + * The {@code TypeCode} object is initialized with the given bound, * which represents the maximum length of the string. Zero indicates * that the string described by this type code is unbounded. * - * @param bound the bound for the <code>string</code>; cannot be negative - * @return a newly-created <code>TypeCode</code> object describing - * a bounded IDL <code>string</code> + * @param bound the bound for the {@code string}; cannot be negative + * @return a newly-created {@code TypeCode} object describing + * a bounded IDL {@code string} * @exception BAD_PARAM if bound is a negative value */ abstract public TypeCode create_string_tc(int bound); /** - * Creates a <code>TypeCode</code> object representing a bounded IDL - * <code>wstring</code> (wide string). - * The <code>TypeCode</code> object is initialized with the given bound, + * Creates a {@code TypeCode} object representing a bounded IDL + * {@code wstring} (wide string). + * The {@code TypeCode} object is initialized with the given bound, * which represents the maximum length of the wide string. Zero indicates * that the string described by this type code is unbounded. * - * @param bound the bound for the <code>wstring</code>; cannot be negative - * @return a newly-created <code>TypeCode</code> object describing - * a bounded IDL <code>wstring</code> + * @param bound the bound for the {@code wstring}; cannot be negative + * @return a newly-created {@code TypeCode} object describing + * a bounded IDL {@code wstring} * @exception BAD_PARAM if bound is a negative value */ abstract public TypeCode create_wstring_tc(int bound); /** - * Creates a <code>TypeCode</code> object representing an IDL <code>sequence</code>. - * The <code>TypeCode</code> object is initialized with the given bound and + * Creates a {@code TypeCode} object representing an IDL {@code sequence}. + * The {@code TypeCode} object is initialized with the given bound and * element type. * - * @param bound the bound for the <code>sequence</code>, 0 if unbounded - * @param element_type - * the <code>TypeCode</code> object describing the elements - * contained in the <code>sequence</code> - * @return a newly-created <code>TypeCode</code> object describing - * an IDL <code>sequence</code> + * @param bound the bound for the {@code sequence}, 0 if unbounded + * @param element_type the {@code TypeCode} object describing + * the elements contained in the {@code sequence} + * + * @return a newly-created {@code TypeCode} object describing + * an IDL {@code sequence} */ abstract public TypeCode create_sequence_tc(int bound, TypeCode element_type); /** - * Creates a <code>TypeCode</code> object representing a - * a recursive IDL <code>sequence</code>. + * Creates a {@code TypeCode} object representing a + * a recursive IDL {@code sequence}. * <P> - * For the IDL <code>struct</code> Node in following code fragment, + * For the IDL {@code struct} Node in following code fragment, * the offset parameter for creating its sequence would be 1: * <PRE> * Struct Node { @@ -907,10 +907,10 @@ * </PRE> * * @param bound the bound for the sequence, 0 if unbounded - * @param offset the index to the enclosing <code>TypeCode</code> object + * @param offset the index to the enclosing {@code TypeCode} object * that describes the elements of this sequence - * @return a newly-created <code>TypeCode</code> object describing - * a recursive sequence + * @return a newly-created {@code TypeCode} object describing + * a recursive sequence * @deprecated Use a combination of create_recursive_tc and create_sequence_tc instead * @see #create_recursive_tc(String) create_recursive_tc * @see #create_sequence_tc(int, TypeCode) create_sequence_tc @@ -919,20 +919,20 @@ abstract public TypeCode create_recursive_sequence_tc(int bound, int offset); /** - * Creates a <code>TypeCode</code> object representing an IDL <code>array</code>. - * The <code>TypeCode</code> object is initialized with the given length and + * Creates a {@code TypeCode} object representing an IDL {@code array}. + * The {@code TypeCode} object is initialized with the given length and * element type. * - * @param length the length of the <code>array</code> - * @param element_type a <code>TypeCode</code> object describing the type - * of element contained in the <code>array</code> - * @return a newly-created <code>TypeCode</code> object describing - * an IDL <code>array</code> + * @param length the length of the {@code array} + * @param element_type a {@code TypeCode} object describing the type + * of element contained in the {@code array} + * @return a newly-created {@code TypeCode} object describing + * an IDL {@code array} */ abstract public TypeCode create_array_tc(int length, TypeCode element_type); /** - * Create a <code>TypeCode</code> object for an IDL native type. + * Create a {@code TypeCode} object for an IDL native type. * * @param id the logical id for the native type. * @param name the name of the native type. @@ -945,7 +945,7 @@ } /** - * Create a <code>TypeCode</code> object for an IDL abstract interface. + * Create a {@code TypeCode} object for an IDL abstract interface. * * @param id the logical id for the abstract interface type. * @param name the name of the abstract interface type. @@ -960,7 +960,7 @@ /** - * Create a <code>TypeCode</code> object for an IDL fixed type. + * Create a {@code TypeCode} object for an IDL fixed type. * * @param digits specifies the total number of decimal digits in the number * and must be from 1 to 31 inclusive. @@ -977,7 +977,7 @@ /** - * Create a <code>TypeCode</code> object for an IDL value type. + * Create a {@code TypeCode} object for an IDL value type. * The concrete_base parameter is the TypeCode for the immediate * concrete valuetype base of the valuetype for which the TypeCode * is being created. @@ -987,7 +987,7 @@ * @param name the name of the value type. * @param type_modifier one of the value type modifier constants: * VM_NONE, VM_CUSTOM, VM_ABSTRACT or VM_TRUNCATABLE - * @param concrete_base a <code>TypeCode</code> object + * @param concrete_base a {@code TypeCode} object * describing the concrete valuetype base * @param members an array containing the members of the value type * @return the requested TypeCode @@ -1002,14 +1002,14 @@ } /** - * Create a recursive <code>TypeCode</code> object which + * Create a recursive {@code TypeCode} object which * serves as a placeholder for a concrete TypeCode during the process of creating * TypeCodes which contain recursion. The id parameter specifies the repository id of * the type for which the recursive TypeCode is serving as a placeholder. Once the * recursive TypeCode has been properly embedded in the enclosing TypeCode which * corresponds to the specified repository id, it will function as a normal TypeCode. * Invoking operations on the recursive TypeCode before it has been embedded in the - * enclosing TypeCode will result in a <code>BAD_TYPECODE</code> exception. + * enclosing TypeCode will result in a {@code BAD_TYPECODE} exception. * <P> * For example, the following IDL type declaration contains recursion: * <PRE> @@ -1046,7 +1046,7 @@ } /** - * Creates a <code>TypeCode</code> object for an IDL value box. + * Creates a {@code TypeCode} object for an IDL value box. * * @param id the logical id for the value type * @param name the name of the value type @@ -1064,11 +1064,11 @@ // orbos 98-01-18: Objects By Value -- end /** - * Creates an IDL <code>Any</code> object initialized to - * contain a <code>Typecode</code> object whose <code>kind</code> field - * is set to <code>TCKind.tc_null</code>. + * Creates an IDL {@code Any} object initialized to + * contain a {@code Typecode} object whose {@code kind} field + * is set to {@code TCKind.tc_null}. * - * @return a newly-created <code>Any</code> object + * @return a newly-created {@code Any} object */ abstract public Any create_any(); @@ -1076,15 +1076,15 @@ /** - * Retrieves a <code>Current</code> object. - * The <code>Current</code> interface is used to manage thread-specific + * Retrieves a {@code Current} object. + * The {@code Current} interface is used to manage thread-specific * information for use by services such as transactions and security. * * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> * - * @return a newly-created <code>Current</code> object - * @deprecated use <code>resolve_initial_references</code>. + * @return a newly-created {@code Current} object + * @deprecated use {@code resolve_initial_references}. */ @Deprecated public org.omg.CORBA.Current get_current() @@ -1095,7 +1095,7 @@ /** * This operation blocks the current thread until the ORB has * completed the shutdown process, initiated when some thread calls - * <code>shutdown</code>. It may be used by multiple threads which + * {@code shutdown}. It may be used by multiple threads which * get all notified when the ORB shuts down. * */ @@ -1107,29 +1107,29 @@ /** * Instructs the ORB to shut down, which causes all * object adapters to shut down, in preparation for destruction.<br> - * If the <code>wait_for_completion</code> parameter + * If the {@code wait_for_completion} parameter * is true, this operation blocks until all ORB processing (including * processing of currently executing requests, object deactivation, * and other object adapter operations) has completed. * If an application does this in a thread that is currently servicing - * an invocation, the <code>BAD_INV_ORDER</code> system exception + * an invocation, the {@code BAD_INV_ORDER} system exception * will be thrown with the OMG minor code 3, * since blocking would result in a deadlock.<br> - * If the <code>wait_for_completion</code> parameter is <code>FALSE</code>, + * If the {@code wait_for_completion} parameter is {@code FALSE}, * then shutdown may not have completed upon return.<p> * While the ORB is in the process of shutting down, the ORB operates as normal, * servicing incoming and outgoing requests until all requests have been completed. * Once an ORB has shutdown, only object reference management operations * may be invoked on the ORB or any object reference obtained from it. - * An application may also invoke the <code>destroy</code> operation on the ORB itself. - * Invoking any other operation will throw the <code>BAD_INV_ORDER</code> + * An application may also invoke the {@code destroy} operation on the ORB itself. + * Invoking any other operation will throw the {@code BAD_INV_ORDER} * system exception with the OMG minor code 4.<p> - * The <code>ORB.run</code> method will return after - * <code>shutdown</code> has been called. + * The {@code ORB.run} method will return after + * {@code shutdown} has been called. * - * @param wait_for_completion <code>true</code> if the call + * @param wait_for_completion {@code true} if the call * should block until the shutdown is complete; - * <code>false</code> if it should return immediately + * {@code false} if it should return immediately * @throws org.omg.CORBA.BAD_INV_ORDER if the current thread is servicing * an invocation */ @@ -1139,12 +1139,12 @@ } /** - * Returns <code>true</code> if the ORB needs the main thread to - * perform some work, and <code>false</code> if the ORB does not + * Returns {@code true} if the ORB needs the main thread to + * perform some work, and {@code false} if the ORB does not * need the main thread. * - * @return <code>true</code> if there is work pending, meaning that the ORB - * needs the main thread to perform some work; <code>false</code> + * @return {@code true} if there is work pending, meaning that the ORB + * needs the main thread to perform some work; {@code false} * if there is no work pending and thus the ORB does not need the * main thread * @@ -1157,7 +1157,7 @@ /** * Performs an implementation-dependent unit of work if called * by the main thread. Otherwise it does nothing. - * The methods <code>work_pending</code> and <code>perform_work</code> + * The methods {@code work_pending} and {@code perform_work} * can be used in * conjunction to implement a simple polling loop that multiplexes * the main thread among the ORB and other activities. @@ -1172,23 +1172,23 @@ * Used to obtain information about CORBA facilities and services * that are supported by this ORB. The service type for which * information is being requested is passed in as the in - * parameter <tt>service_type</tt>, the values defined by + * parameter {@code service_type}, the values defined by * constants in the CORBA module. If service information is * available for that type, that is returned in the out parameter - * <tt>service_info</tt>, and the operation returns the - * value <tt>true</tt>. If no information for the requested - * services type is available, the operation returns <tt>false</tt> + * {@code service_info}, and the operation returns the + * value {@code true}. If no information for the requested + * services type is available, the operation returns {@code false} * (i.e., the service is not supported by this ORB). * - * @param service_type a <code>short</code> indicating the + * @param service_type a {@code short} indicating the * service type for which information is being requested - * @param service_info a <code>ServiceInformationHolder</code> object - * that will hold the <code>ServiceInformation</code> object + * @param service_info a {@code ServiceInformationHolder} object + * that will hold the {@code ServiceInformation} object * produced by this method - * @return <code>true</code> if service information is available - * for the <tt>service_type</tt>; - * <tt>false</tt> if no information for the - * requested services type is available + * @return {@code true} if service information is available + * for the {@code service_type}; + * {@code false} if no information for the + * requested services type is available * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> */ @@ -1201,13 +1201,13 @@ // orbos 98-01-18: Objects By Value -- begin /** - * Creates a new <code>DynAny</code> object from the given - * <code>Any</code> object. + * Creates a new {@code DynAny} object from the given + * {@code Any} object. * - * @param value the <code>Any</code> object from which to create a new - * <code>DynAny</code> object - * @return the new <code>DynAny</code> object created from the given - * <code>Any</code> object + * @param value the {@code Any} object from which to create a new + * {@code DynAny} object + * @return the new {@code DynAny} object created from the given + * {@code Any} object * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> * @deprecated Use the new <a href="../DynamicAny/DynAnyFactory.html">DynAnyFactory</a> API instead @@ -1219,15 +1219,15 @@ } /** - * Creates a basic <code>DynAny</code> object from the given - * <code>TypeCode</code> object. + * Creates a basic {@code DynAny} object from the given + * {@code TypeCode} object. * - * @param type the <code>TypeCode</code> object from which to create a new - * <code>DynAny</code> object - * @return the new <code>DynAny</code> object created from the given - * <code>TypeCode</code> object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynAny} object + * @return the new {@code DynAny} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - * <code>TypeCode</code> object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> * @deprecated Use the new <a href="../DynamicAny/DynAnyFactory.html">DynAnyFactory</a> API instead @@ -1239,15 +1239,15 @@ } /** - * Creates a new <code>DynStruct</code> object from the given - * <code>TypeCode</code> object. + * Creates a new {@code DynStruct} object from the given + * {@code TypeCode} object. * - * @param type the <code>TypeCode</code> object from which to create a new - * <code>DynStruct</code> object - * @return the new <code>DynStruct</code> object created from the given - * <code>TypeCode</code> object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynStruct} object + * @return the new {@code DynStruct} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - * <code>TypeCode</code> object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> * @deprecated Use the new <a href="../DynamicAny/DynAnyFactory.html">DynAnyFactory</a> API instead @@ -1259,15 +1259,15 @@ } /** - * Creates a new <code>DynSequence</code> object from the given - * <code>TypeCode</code> object. + * Creates a new {@code DynSequence} object from the given + * {@code TypeCode} object. * - * @param type the <code>TypeCode</code> object from which to create a new - * <code>DynSequence</code> object - * @return the new <code>DynSequence</code> object created from the given - * <code>TypeCode</code> object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynSequence} object + * @return the new {@code DynSequence} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - * <code>TypeCode</code> object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> * @deprecated Use the new <a href="../DynamicAny/DynAnyFactory.html">DynAnyFactory</a> API instead @@ -1280,15 +1280,15 @@ /** - * Creates a new <code>DynArray</code> object from the given - * <code>TypeCode</code> object. + * Creates a new {@code DynArray} object from the given + * {@code TypeCode} object. * - * @param type the <code>TypeCode</code> object from which to create a new - * <code>DynArray</code> object - * @return the new <code>DynArray</code> object created from the given - * <code>TypeCode</code> object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynArray} object + * @return the new {@code DynArray} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - * <code>TypeCode</code> object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> * @deprecated Use the new <a href="../DynamicAny/DynAnyFactory.html">DynAnyFactory</a> API instead @@ -1300,15 +1300,15 @@ } /** - * Creates a new <code>DynUnion</code> object from the given - * <code>TypeCode</code> object. + * Creates a new {@code DynUnion} object from the given + * {@code TypeCode} object. * - * @param type the <code>TypeCode</code> object from which to create a new - * <code>DynUnion</code> object - * @return the new <code>DynUnion</code> object created from the given - * <code>TypeCode</code> object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynUnion} object + * @return the new {@code DynUnion} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - * <code>TypeCode</code> object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> * @deprecated Use the new <a href="../DynamicAny/DynAnyFactory.html">DynAnyFactory</a> API instead @@ -1320,15 +1320,15 @@ } /** - * Creates a new <code>DynEnum</code> object from the given - * <code>TypeCode</code> object. + * Creates a new {@code DynEnum} object from the given + * {@code TypeCode} object. * - * @param type the <code>TypeCode</code> object from which to create a new - * <code>DynEnum</code> object - * @return the new <code>DynEnum</code> object created from the given - * <code>TypeCode</code> object + * @param type the {@code TypeCode} object from which to create a new + * {@code DynEnum} object + * @return the new {@code DynEnum} object created from the given + * {@code TypeCode} object * @throws org.omg.CORBA.ORBPackage.InconsistentTypeCode if the given - * <code>TypeCode</code> object is not consistent with the operation. + * {@code TypeCode} object is not consistent with the operation. * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package * comments for unimplemented features</a> * @deprecated Use the new <a href="../DynamicAny/DynAnyFactory.html">DynAnyFactory</a> API instead @@ -1342,19 +1342,19 @@ /** * Can be invoked to create new instances of policy objects * of a specific type with specified initial state. If - * <tt>create_policy</tt> fails to instantiate a new Policy + * {@code create_policy} fails to instantiate a new Policy * object due to its inability to interpret the requested type - * and content of the policy, it raises the <tt>PolicyError</tt> + * and content of the policy, it raises the {@code PolicyError} * exception with the appropriate reason. - * @param type the <tt>PolicyType</tt> of the policy object to + * @param type the {@code PolicyType} of the policy object to * be created * @param val the value that will be used to set the initial - * state of the <tt>Policy</tt> object that is created - * @return Reference to a newly created <tt>Policy</tt> object - * of type specified by the <tt>type</tt> parameter and - * initialized to a state specified by the <tt>val</tt> + * state of the {@code Policy} object that is created + * @return Reference to a newly created {@code Policy} object + * of type specified by the {@code type} parameter and + * initialized to a state specified by the {@code val} * parameter - * @throws <tt>org.omg.CORBA.PolicyError</tt> when the requested + * @throws org.omg.CORBA.PolicyError when the requested * policy is not supported or a requested initial state * for the policy is not supported. */
--- a/src/java.corba/share/classes/org/omg/CORBA/ObjectHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ObjectHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -24,10 +24,10 @@ */ /** -* The Helper for <tt>Object</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -*/ + * The Helper for {@code Object}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + */ /* * Licensed Materials - Property of IBM
--- a/src/java.corba/share/classes/org/omg/CORBA/ObjectHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ObjectHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -31,55 +31,55 @@ /** - * The Holder for <tt>Object</tt>. For more information on + * The Holder for {@code Object}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> * A Holder class for a CORBA object reference (a value of type - * <code>org.omg.CORBA.Object</code>). It is usually + * {@code org.omg.CORBA.Object}). It is usually * used to store "out" and "inout" parameters in IDL methods. * If an IDL method signature has a CORBA Object reference as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>ObjectHolder</code> as the corresponding + * {@code ObjectHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myObjectHolder</code> is an instance of <code>ObjectHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myObjectHolder.value</code>. + * If {@code myObjectHolder} is an instance of {@code ObjectHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myObjectHolder.value}. * * @since JDK1.2 */ public final class ObjectHolder implements Streamable { /** - * The <code>Object</code> value held by this <code>ObjectHolder</code> + * The {@code Object} value held by this {@code ObjectHolder} * object. */ public Object value; /** - * Constructs a new <code>ObjectHolder</code> object with its - * <code>value</code> field initialized to <code>null</code>. + * Constructs a new {@code ObjectHolder} object with its + * {@code value} field initialized to {@code null}. */ public ObjectHolder() { } /** - * Constructs a new <code>ObjectHolder</code> object with its - * <code>value</code> field initialized to the given - * <code>Object</code>. - * @param initial the <code>Object</code> with which to initialize - * the <code>value</code> field of the newly-created - * <code>ObjectHolder</code> object + * Constructs a new {@code ObjectHolder} object with its + * {@code value} field initialized to the given + * {@code Object}. + * @param initial the {@code Object} with which to initialize + * the {@code value} field of the newly-created + * {@code ObjectHolder} object */ public ObjectHolder(Object initial) { value = initial; } /** - * Reads from <code>input</code> and initalizes the value in - * this <code>ObjectHolder</code> object + * Reads from {@code input} and initalizes the value in + * this {@code ObjectHolder} object * with the unmarshalled data. * * @param input the InputStream containing CDR formatted data from the wire. @@ -89,8 +89,8 @@ } /** - * Marshals to <code>output</code> the value in - * this <code>ObjectHolder</code> object. + * Marshals to {@code output} the value in + * this {@code ObjectHolder} object. * * @param output the OutputStream which will contain the CDR formatted data. */ @@ -100,10 +100,10 @@ /** * Returns the TypeCode corresponding to the value held in - * this <code>ObjectHolder</code> object + * this {@code ObjectHolder} object * * @return the TypeCode of the value held in - * this <code>ObjectHolder</code> object + * this {@code ObjectHolder} object */ public org.omg.CORBA.TypeCode _type() { return org.omg.CORBA.ORB.init().get_primitive_tc(TCKind.tk_objref);
--- a/src/java.corba/share/classes/org/omg/CORBA/OctetSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/OctetSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,26 +26,26 @@ /** -* The Helper for <tt>OctetSeq</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/OctetSeqHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -* -* The class definition has been modified to conform to the following -* OMG specifications : -* <ul> -* <li> ORB core as defined by CORBA 2.3.1 -* (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) -* </li> -* -* <li> IDL/Java Language Mapping as defined in -* <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> -* </li> -* </ul> -*/ + * The Helper for {@code OctetSeq}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/OctetSeqHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + * + * The class definition has been modified to conform to the following + * OMG specifications : + * <ul> + * <li> ORB core as defined by CORBA 2.3.1 + * (<a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07">formal/99-10-07</a>) + * </li> + * + * <li> IDL/Java Language Mapping as defined in + * <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">ptc/00-01-08</a> + * </li> + * </ul> + */ public abstract class OctetSeqHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/OctetSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/OctetSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Holder for <tt>OctetSeq</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/OctetSeqHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from streams.idl -* 13 May 1999 22:41:36 o'clock GMT+00:00 -*/ + * The Holder for {@code OctetSeq}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/OctetSeqHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from streams.idl + * 13 May 1999 22:41:36 o'clock GMT+00:00 + */ public final class OctetSeqHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/Policy.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/Policy.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,21 +26,21 @@ /** -* Interfaces derived from the <tt>Policy</tt> interface allow an -* ORB or CORBA service access to certain choices that affect -* its operation. This information is accessed in a structured -* manner using interfaces derived from the <tt>Policy</tt> -* interface defined in the CORBA module. A CORBA service does not -* have to use this method of accessing operating options, but -* may choose to do so. The Security Service in particular uses -* this technique for associating Security Policy with objects -* in the system. -* An interface generated by the IDL-to-Java compiler. -* org/omg/CORBA/Policy.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:20 AM PDT -*/ + * Interfaces derived from the {@code Policy} interface allow an + * ORB or CORBA service access to certain choices that affect + * its operation. This information is accessed in a structured + * manner using interfaces derived from the {@code Policy} + * interface defined in the CORBA module. A CORBA service does not + * have to use this method of accessing operating options, but + * may choose to do so. The Security Service in particular uses + * this technique for associating Security Policy with objects + * in the system. + * An interface generated by the IDL-to-Java compiler. + * org/omg/CORBA/Policy.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:20 AM PDT + */ public interface Policy extends PolicyOperations, org.omg.CORBA.Object, org.omg.CORBA.portable.IDLEntity {
--- a/src/java.corba/share/classes/org/omg/CORBA/PolicyHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/PolicyHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Helper for <tt>Policy</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/PolicyHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:20 AM PDT -*/ + * The Helper for {@code Policy}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/PolicyHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:20 AM PDT + */ abstract public class PolicyHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/PolicyHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/PolicyHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -25,14 +25,14 @@ package org.omg.CORBA; /** -* The Holder for <tt>Policy</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/PolicyHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:20 AM PDT -*/ + * The Holder for {@code Policy}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/PolicyHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:20 AM PDT + */ public final class PolicyHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/PolicyListHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/PolicyListHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Helper for <tt>PolicyList</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/PolicyListHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:21 AM PDT -*/ + * The Helper for {@code PolicyList}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/PolicyListHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:21 AM PDT + */ abstract public class PolicyListHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/PolicyListHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/PolicyListHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Holder for <tt>PolicyList</tt>. For more information on -* Holder files, see <a href="doc-files/generatedfiles.html#holder"> -* "Generated Files: Holder Files"</a>.<P> -* org/omg/CORBA/PolicyListHolder.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:21 AM PDT -*/ + * The Holder for {@code PolicyList}. For more information on + * Holder files, see <a href="doc-files/generatedfiles.html#holder"> + * "Generated Files: Holder Files"</a>.<P> + * org/omg/CORBA/PolicyListHolder.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:21 AM PDT + */ public final class PolicyListHolder implements org.omg.CORBA.portable.Streamable {
--- a/src/java.corba/share/classes/org/omg/CORBA/PolicyOperations.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/PolicyOperations.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,18 +26,18 @@ /** -* The interface for <tt>Policy</tt>. For more information on -* Operations interfaces, see <a href="doc-files/generatedfiles.html#operations"> -* "Generated Files: Operations files"</a>. -*<P> -* org/omg/CORBA/PolicyOperations.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:20 AM PDT -*/ + * The interface for {@code Policy}. For more information on + * Operations interfaces, see <a href="doc-files/generatedfiles.html#operations"> + * "Generated Files: Operations files"</a>. + * <P> + * org/omg/CORBA/PolicyOperations.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:20 AM PDT + */ /** - * Provides the operations for a <code>Policy</code> object. + * Provides the operations for a {@code Policy} object. */ public interface PolicyOperations { @@ -57,16 +57,16 @@ int policy_type (); /** - * Returns a copy of the <code>Policy</code> object. The copy does not retain + * Returns a copy of the {@code Policy} object. The copy does not retain * any relationships that the policy had with any domain or object. * - * @return a copy of the <code>Policy</code> object + * @return a copy of the {@code Policy} object */ org.omg.CORBA.Policy copy (); /** - * Destroys the <code>Policy</code> object. It is the responsibility of - * the <code>Policy</code> object to determine whether it can be destroyed. + * Destroys the {@code Policy} object. It is the responsibility of + * the {@code Policy} object to determine whether it can be destroyed. */ void destroy (); } // interface PolicyOperations
--- a/src/java.corba/share/classes/org/omg/CORBA/PolicyTypeHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/PolicyTypeHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,14 +26,14 @@ /** -* The Helper for <tt>PolicyType</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -* org/omg/CORBA/PolicyTypeHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl -* Saturday, July 17, 1999 12:26:20 AM PDT -*/ + * The Helper for {@code PolicyType}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * org/omg/CORBA/PolicyTypeHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ../../../../../src/share/classes/org/omg/PortableServer/corba.idl + * Saturday, July 17, 1999 12:26:20 AM PDT + */ // basic Policy definition
--- a/src/java.corba/share/classes/org/omg/CORBA/PrincipalHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/PrincipalHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -31,22 +31,22 @@ /** - * The Holder for <tt>Principal</tt>. For more information on + * The Holder for {@code Principal}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A container class for values of type <code>Principal</code> + * A container class for values of type {@code Principal} * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>Principal</code> as an "out" + * If an IDL method signature has an IDL {@code Principal} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>PrincipalHolder</code> as the corresponding + * {@code PrincipalHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myPrincipalHolder</code> is an instance of <code>PrincipalHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myPrincipalHolder.value</code>. + * If {@code myPrincipalHolder} is an instance of {@code PrincipalHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myPrincipalHolder.value}. * * @since JDK1.2 * @deprecated Deprecated by CORBA 2.2. @@ -54,25 +54,25 @@ @Deprecated public final class PrincipalHolder implements Streamable { /** - * The <code>Principal</code> value held by this <code>PrincipalHolder</code> + * The {@code Principal} value held by this {@code PrincipalHolder} * object. */ public Principal value; /** - * Constructs a new <code>PrincipalHolder</code> object with its - * <code>value</code> field initialized to <code>null</code>. + * Constructs a new {@code PrincipalHolder} object with its + * {@code value} field initialized to {@code null}. */ public PrincipalHolder() { } /** - * Constructs a new <code>PrincipalHolder</code> object with its - * <code>value</code> field initialized to the given - * <code>Principal</code> object. - * @param initial the <code>Principal</code> with which to initialize - * the <code>value</code> field of the newly-created - * <code>PrincipalHolder</code> object + * Constructs a new {@code PrincipalHolder} object with its + * {@code value} field initialized to the given + * {@code Principal} object. + * @param initial the {@code Principal} with which to initialize + * the {@code value} field of the newly-created + * {@code PrincipalHolder} object */ public PrincipalHolder(Principal initial) { value = initial;
--- a/src/java.corba/share/classes/org/omg/CORBA/RepositoryIdHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/RepositoryIdHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,15 +26,15 @@ /** -* The Helper for <tt>RepositoryId</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> - -* org/omg/CORBA/RepositoryIdHelper.java -* Generated by the IDL-to-Java compiler (portable), version "3.0" -* from ir.idl -* 03 June 1999 11:33:43 o'clock GMT+00:00 -*/ + * The Helper for {@code RepositoryId}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + * + * org/omg/CORBA/RepositoryIdHelper.java + * Generated by the IDL-to-Java compiler (portable), version "3.0" + * from ir.idl + * 03 June 1999 11:33:43 o'clock GMT+00:00 + */ abstract public class RepositoryIdHelper {
--- a/src/java.corba/share/classes/org/omg/CORBA/ServiceDetailHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ServiceDetailHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -24,10 +24,10 @@ */ /** - * The Helper for <tt>ServiceDetail</tt>. For more information on - * Helper files, see <a href="doc-files/generatedfiles.html#helper"> - * "Generated Files: Helper Files"</a>.<P> - */ + * The Helper for {@code ServiceDetail}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + */ package org.omg.CORBA;
--- a/src/java.corba/share/classes/org/omg/CORBA/ServiceInformation.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ServiceInformation.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,9 +26,10 @@ package org.omg.CORBA; -/** An IDL struct in the CORBA module that +/** + * An IDL struct in the CORBA module that * stores information about a CORBA service available in the - * ORB implementation and is obtained from the <tt>ORB.get_service_information</tt> + * ORB implementation and is obtained from the {@code ORB.get_service_information} * method. */ public final class ServiceInformation implements org.omg.CORBA.portable.IDLEntity
--- a/src/java.corba/share/classes/org/omg/CORBA/ServiceInformationHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ServiceInformationHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -24,10 +24,10 @@ */ /** - * The Helper for <tt>ServiceInformation</tt>. For more information on -* Helper files, see <a href="doc-files/generatedfiles.html#helper"> -* "Generated Files: Helper Files"</a>.<P> -*/ + * The Helper for {@code ServiceInformation}. For more information on + * Helper files, see <a href="doc-files/generatedfiles.html#helper"> + * "Generated Files: Helper Files"</a>.<P> + */ package org.omg.CORBA;
--- a/src/java.corba/share/classes/org/omg/CORBA/ServiceInformationHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ServiceInformationHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,48 +26,48 @@ package org.omg.CORBA; /** - * The Holder for <tt>ServiceInformation</tt>. For more information on + * The Holder for {@code ServiceInformation}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for a <code>ServiceInformation</code> object + * A Holder class for a {@code ServiceInformation} object * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>xxx</code> as an "out" + * If an IDL method signature has an IDL {@code xxx} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>ServiceInformationHolder</code> as the corresponding + * {@code ServiceInformationHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myServiceInformationHolder</code> is an instance of <code>ServiceInformationHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myServiceInformationHolder.value</code>. + * If {@code myServiceInformationHolder} is an instance of {@code ServiceInformationHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myServiceInformationHolder.value}. */ public final class ServiceInformationHolder implements org.omg.CORBA.portable.Streamable { /** - * The <code>ServiceInformation</code> value held by this - * <code>ServiceInformationHolder</code> object in its <code>value</code> field. + * The {@code ServiceInformation} value held by this + * {@code ServiceInformationHolder} object in its {@code value} field. */ public ServiceInformation value; /** - * Constructs a new <code>ServiceInformationHolder</code> object with its - * <code>value</code> field initialized to null. + * Constructs a new {@code ServiceInformationHolder} object with its + * {@code value} field initialized to null. */ public ServiceInformationHolder() { this(null); } /** - * Constructs a new <code>ServiceInformationHolder</code> object with its - * <code>value</code> field initialized to the given - * <code>ServiceInformation</code> object. + * Constructs a new {@code ServiceInformationHolder} object with its + * {@code value} field initialized to the given + * {@code ServiceInformation} object. * - * @param arg the <code>ServiceInformation</code> object with which to initialize - * the <code>value</code> field of the newly-created - * <code>ServiceInformationHolder</code> object + * @param arg the {@code ServiceInformation} object with which to initialize + * the {@code value} field of the newly-created + * {@code ServiceInformationHolder} object */ public ServiceInformationHolder(org.omg.CORBA.ServiceInformation arg) { value = arg; @@ -75,10 +75,10 @@ /** - * Marshals the value in this <code>ServiceInformationHolder</code> object's - * <code>value</code> field to the output stream <code>out</code>. + * Marshals the value in this {@code ServiceInformationHolder} object's + * {@code value} field to the output stream {@code out}. * - * @param out the <code>OutputStream</code> object that will contain + * @param out the {@code OutputStream} object that will contain * the CDR formatted data */ public void _write(org.omg.CORBA.portable.OutputStream out) { @@ -86,10 +86,10 @@ } /** - * Reads unmarshalled data from the input stream <code>in</code> and assigns it to - * the <code>value</code> field in this <code>ServiceInformationHolder</code> object. + * Reads unmarshalled data from the input stream {@code in} and assigns it to + * the {@code value} field in this {@code ServiceInformationHolder} object. * - * @param in the <code>InputStream</code> object containing CDR + * @param in the {@code InputStream} object containing CDR * formatted data from the wire */ public void _read(org.omg.CORBA.portable.InputStream in) { @@ -97,11 +97,11 @@ } /** - * Retrieves the <code>TypeCode</code> object that corresponds - * to the value held in this <code>ServiceInformationHolder</code> object's - * <code>value</code> field. + * Retrieves the {@code TypeCode} object that corresponds + * to the value held in this {@code ServiceInformationHolder} object's + * {@code value} field. * - * @return the type code for the value held in this <code>ServiceInformationHolder</code> + * @return the type code for the value held in this {@code ServiceInformationHolder} * object */ public org.omg.CORBA.TypeCode _type() {
--- a/src/java.corba/share/classes/org/omg/CORBA/SetOverrideTypeHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/SetOverrideTypeHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>SetOverrideType</tt>. For more information on +* The Helper for {@code SetOverrideType}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/SetOverrideTypeHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/ShortHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ShortHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -30,55 +30,55 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for <tt>Short</tt>. For more information on + * The Holder for {@code Short}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>. - * <P>A Holder class for a <code>short</code> + * <P>A Holder class for a {@code short} * that is used to store "out" and "inout" parameters in IDL operations. - * If an IDL operation signature has an IDL <code>short</code> as an "out" + * If an IDL operation signature has an IDL {@code short} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>ShortHolder</code> as the corresponding + * {@code ShortHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myShortHolder</code> is an instance of <code>ShortHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myShortHolder.value</code>. + * If {@code myShortHolder} is an instance of {@code ShortHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myShortHolder.value}. * * @since JDK1.2 */ public final class ShortHolder implements Streamable { /** - * The <code>short</code> value held by this <code>ShortHolder</code> + * The {@code short} value held by this {@code ShortHolder} * object. */ public short value; /** - * Constructs a new <code>ShortHolder</code> object with its - * <code>value</code> field initialized to <code>0</code>. + * Constructs a new {@code ShortHolder} object with its + * {@code value} field initialized to {@code 0}. */ public ShortHolder() { } /** - * Constructs a new <code>ShortHolder</code> object with its - * <code>value</code> field initialized to the given - * <code>short</code>. - * @param initial the <code>short</code> with which to initialize - * the <code>value</code> field of the newly-created - * <code>ShortHolder</code> object + * Constructs a new {@code ShortHolder} object with its + * {@code value} field initialized to the given + * {@code short}. + * @param initial the {@code short} with which to initialize + * the {@code value} field of the newly-created + * {@code ShortHolder} object */ public ShortHolder(short initial) { value = initial; } /** - * Reads from <code>input</code> and initalizes the value in - * this <code>ShortHolder</code> object + * Reads from {@code input} and initalizes the value in + * this {@code ShortHolder} object * with the unmarshalled data. * * @param input the InputStream containing CDR formatted data from the wire. @@ -88,8 +88,8 @@ } /** - * Marshals to <code>output</code> the value in - * this <code>ShortHolder</code> object. + * Marshals to {@code output} the value in + * this {@code ShortHolder} object. * * @param output the OutputStream which will contain the CDR formatted data. */ @@ -99,10 +99,10 @@ /** * Returns the TypeCode corresponding to the value held in - * this <code>ShortHolder</code> object. + * this {@code ShortHolder} object. * * @return the TypeCode of the value held in - * this <code>ShortHolder</code> object + * this {@code ShortHolder} object */ public org.omg.CORBA.TypeCode _type() { return ORB.init().get_primitive_tc(TCKind.tk_short);
--- a/src/java.corba/share/classes/org/omg/CORBA/ShortSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ShortSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>ShortSeqHelper</tt>. For more information on +* The Helper for {@code ShortSeqHelper}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/ShortSeqHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/ShortSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ShortSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Holder for <tt>ShortSeq</tt>. For more information on +* The Holder for {@code ShortSeq}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> * org/omg/CORBA/ShortSeqHolder.java
--- a/src/java.corba/share/classes/org/omg/CORBA/StringHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/StringHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -30,55 +30,55 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for <tt>String</tt>. For more information on + * The Holder for {@code String}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for a <code>String</code> + * A Holder class for a {@code String} * that is used to store "out" and "inout" parameters in IDL operations. - * If an IDL operation signature has an IDL <code>string</code> as an "out" + * If an IDL operation signature has an IDL {@code string} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>StringHolder</code> as the corresponding + * {@code StringHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myStringHolder</code> is an instance of <code>StringHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myStringHolder.value</code>. + * If {@code myStringHolder} is an instance of {@code StringHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myStringHolder.value}. * * @since JDK1.2 */ public final class StringHolder implements Streamable { /** - * The <code>String</code> value held by this <code>StringHolder</code> + * The {@code String} value held by this {@code StringHolder} * object. */ public String value; /** - * Constructs a new <code>StringHolder</code> object with its - * <code>value</code> field initialized to <code>null</code>. + * Constructs a new {@code StringHolder} object with its + * {@code value} field initialized to {@code null}. */ public StringHolder() { } /** - * Constructs a new <code>StringHolder</code> object with its - * <code>value</code> field initialized to the given - * <code>String</code>. - * @param initial the <code>String</code> with which to initialize - * the <code>value</code> field of the newly-created - * <code>StringHolder</code> object + * Constructs a new {@code StringHolder} object with its + * {@code value} field initialized to the given + * {@code String}. + * @param initial the {@code String} with which to initialize + * the {@code value} field of the newly-created + * {@code StringHolder} object */ public StringHolder(String initial) { value = initial; } /** - * Reads the unmarshalled data from <code>input</code> and assigns it to - * the <code>value</code> field of this <code>StringHolder</code> object. + * Reads the unmarshalled data from {@code input} and assigns it to + * the {@code value} field of this {@code StringHolder} object. * * @param input the InputStream containing CDR formatted data from the wire. */ @@ -87,8 +87,8 @@ } /** - * Marshals the value held by this <code>StringHolder</code> object - * to the output stream <code>output</code>. + * Marshals the value held by this {@code StringHolder} object + * to the output stream {@code output}. * * @param output the OutputStream which will contain the CDR formatted data. */ @@ -97,10 +97,10 @@ } /** - * Retrieves the <code>TypeCode</code> object that corresponds to - * the value held in this <code>StringHolder</code> object. + * Retrieves the {@code TypeCode} object that corresponds to + * the value held in this {@code StringHolder} object. * - * @return the type code of the value held in this <code>StringHolder</code> + * @return the type code of the value held in this {@code StringHolder} * object */ public org.omg.CORBA.TypeCode _type() {
--- a/src/java.corba/share/classes/org/omg/CORBA/StringValueHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/StringValueHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -32,7 +32,7 @@ package org.omg.CORBA; /** -* The Helper for <tt>StringValue</tt>. For more information on +* The Helper for {@code StringValue}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/StringValueHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/StructMemberHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/StructMemberHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>StructMember</tt>. For more information on +* The Helper for {@code StructMember}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/StructMemberHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/TypeCodeHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/TypeCodeHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -30,55 +30,55 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for <tt>TypeCode</tt>. For more information on + * The Holder for {@code TypeCode}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for a <code>TypeCode</code> object + * A Holder class for a {@code TypeCode} object * that is used to store "out" and "inout" parameters in IDL operations. - * If an IDL operation signature has an IDL <code>TypeCode</code> as an "out" + * If an IDL operation signature has an IDL {@code TypeCode} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>TypeCodeHolder</code> as the corresponding + * {@code TypeCodeHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myTypeCodeHolder</code> is an instance of <code>TypeCodeHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myTypeCodeHolder.value</code>. + * If {@code myTypeCodeHolder} is an instance of {@code TypeCodeHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myTypeCodeHolder.value}. * * @since JDK1.2 */ public final class TypeCodeHolder implements Streamable { /** - * The <code>TypeCode</code> value held by - * this <code>TypeCodeHolder</code> object. + * The {@code TypeCode} value held by + * this {@code TypeCodeHolder} object. */ public TypeCode value; /** - * Constructs a new <code>TypeCodeHolder</code> object with its - * <code>value</code> field initialized to <code>null</code>. + * Constructs a new {@code TypeCodeHolder} object with its + * {@code value} field initialized to {@code null}. */ public TypeCodeHolder() { } /** - * Constructs a new <code>TypeCodeHolder</code> object with its - * <code>value</code> field initialized to the given - * <code>TypeCode</code> object. - * @param initial the <code>TypeCode</code> object with which to initialize - * the <code>value</code> field of the newly-created - * <code>TypeCodeHolder</code> object + * Constructs a new {@code TypeCodeHolder} object with its + * {@code value} field initialized to the given + * {@code TypeCode} object. + * @param initial the {@code TypeCode} object with which to initialize + * the {@code value} field of the newly-created + * {@code TypeCodeHolder} object */ public TypeCodeHolder(TypeCode initial) { value = initial; } /** - * Reads from <code>input</code> and initalizes the value in - * this <code>TypeCodeHolder</code> object + * Reads from {@code input} and initalizes the value in + * this {@code TypeCodeHolder} object * with the unmarshalled data. * * @param input the InputStream containing CDR formatted data from the wire @@ -88,8 +88,8 @@ } /** - * Marshals to <code>output</code> the value in - * this <code>TypeCodeHolder</code> object. + * Marshals to {@code output} the value in + * this {@code TypeCodeHolder} object. * * @param output the OutputStream which will contain the CDR formatted data */ @@ -99,10 +99,10 @@ /** * Returns the TypeCode corresponding to the value held in - * this <code>TypeCodeHolder</code> object. + * this {@code TypeCodeHolder} object. * * @return the TypeCode of the value held in - * this <code>TypeCodeHolder</code> object + * this {@code TypeCodeHolder} object */ public org.omg.CORBA.TypeCode _type() { return ORB.init().get_primitive_tc(TCKind.tk_TypeCode);
--- a/src/java.corba/share/classes/org/omg/CORBA/ULongLongSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ULongLongSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>ULongLongSeq</tt>. For more information on +* The Helper for {@code ULongLongSeq}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/ULongLongSeqHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/ULongLongSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ULongLongSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Holder for <tt>ULongLongSeq</tt>. For more information on +* The Holder for {@code ULongLongSeq}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> * org/omg/CORBA/ULongLongSeqHolder.java
--- a/src/java.corba/share/classes/org/omg/CORBA/ULongSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ULongSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>ULongSeq</tt>. For more information on +* The Helper for {@code ULongSeq}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/ULongSeqHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/ULongSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ULongSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Holder for <tt>ULongSeq</tt>. For more information on +* The Holder for {@code ULongSeq}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> * org/omg/CORBA/ULongSeqHolder.java
--- a/src/java.corba/share/classes/org/omg/CORBA/UNSUPPORTED_POLICY.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/UNSUPPORTED_POLICY.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,8 +26,8 @@ package org.omg.CORBA; /** - * One of the <tt>PolicyErrorCode</tt>s which would be filled if - * the requested <tt>Policy</tt> is understood to be valid by the + * One of the {@code PolicyErrorCode}s which would be filled if + * the requested {@code Policy} is understood to be valid by the * ORB, but is not currently supported. * * @author rip-dev
--- a/src/java.corba/share/classes/org/omg/CORBA/UNSUPPORTED_POLICY_VALUE.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/UNSUPPORTED_POLICY_VALUE.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,8 +26,8 @@ package org.omg.CORBA; /** - * A <tt>PolicyErrorCode</tt> which would be filled if the value - * requested for the <tt>Policy</tt> is of a + * A {@code PolicyErrorCode} which would be filled if the value + * requested for the {@code Policy} is of a * valid type and within the valid range for that type, but this valid value * is not currently supported. *
--- a/src/java.corba/share/classes/org/omg/CORBA/UShortSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/UShortSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>UShortSeq</tt>. For more information on +* The Helper for {@code UShortSeq}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/UShortSeqHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/UShortSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/UShortSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Holder for <tt>UShortSeq</tt>. For more information on +* The Holder for {@code UShortSeq}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> * org/omg/CORBA/UShortSeqHolder.java
--- a/src/java.corba/share/classes/org/omg/CORBA/UnionMemberHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/UnionMemberHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>UnionMember</tt>. For more information on +* The Helper for {@code UnionMember}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/UnionMemberHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/UnknownUserExceptionHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/UnknownUserExceptionHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>UnknownUserException</tt>. For more information on +* The Helper for {@code UnknownUserException}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/UnknownUserExceptionHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/UnknownUserExceptionHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/UnknownUserExceptionHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -25,7 +25,7 @@ package org.omg.CORBA; /** -* The Holder for <tt>UnknownUserException</tt>. For more information on +* The Holder for {@code UnknownUserException}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> * org/omg/CORBA/UnknownUserExceptionHolder.java
--- a/src/java.corba/share/classes/org/omg/CORBA/ValueBaseHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ValueBaseHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -24,7 +24,7 @@ */ /** - * The Helper for <tt>ValueBase</tt>. For more information on + * The Helper for {@code ValueBase}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> */
--- a/src/java.corba/share/classes/org/omg/CORBA/ValueBaseHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ValueBaseHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -30,53 +30,53 @@ import org.omg.CORBA.portable.OutputStream; /** - * The Holder for <tt>ValueBase</tt>. For more information on + * The Holder for {@code ValueBase}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> - * A Holder class for a <code>java.io.Serializable</code> + * A Holder class for a {@code java.io.Serializable} * that is used to store "out" and "inout" parameters in IDL methods. - * If an IDL method signature has an IDL <code>ValueBase</code> as an "out" + * If an IDL method signature has an IDL {@code ValueBase} as an "out" * or "inout" parameter, the programmer must pass an instance of - * <code>ValueBaseHolder</code> as the corresponding + * {@code ValueBaseHolder} as the corresponding * parameter in the method invocation; for "inout" parameters, the programmer * must also fill the "in" value to be sent to the server. * Before the method invocation returns, the ORB will fill in the * value corresponding to the "out" value returned from the server. * <P> - * If <code>myValueBaseHolder</code> is an instance of <code>ValueBaseHolder</code>, - * the value stored in its <code>value</code> field can be accessed with - * <code>myValueBaseHolder.value</code>. + * If {@code myValueBaseHolder} is an instance of {@code ValueBaseHolder}, + * the value stored in its {@code value} field can be accessed with + * {@code myValueBaseHolder.value}. * */ public final class ValueBaseHolder implements Streamable { /** - * The <code>java.io.Serializable</code> value held by this - * <code>ValueBaseHolder</code> object. + * The {@code java.io.Serializable} value held by this + * {@code ValueBaseHolder} object. */ public java.io.Serializable value; /** - * Constructs a new <code>ValueBaseHolder</code> object with its - * <code>value</code> field initialized to <code>0</code>. + * Constructs a new {@code ValueBaseHolder} object with its + * {@code value} field initialized to {@code 0}. */ public ValueBaseHolder() { } /** - * Constructs a new <code>ValueBaseHolder</code> object with its - * <code>value</code> field initialized to the given - * <code>java.io.Serializable</code>. - * @param initial the <code>java.io.Serializable</code> with which to initialize - * the <code>value</code> field of the newly-created - * <code>ValueBaseHolder</code> object + * Constructs a new {@code ValueBaseHolder} object with its + * {@code value} field initialized to the given + * {@code java.io.Serializable}. + * @param initial the {@code java.io.Serializable} with which to initialize + * the {@code value} field of the newly-created + * {@code ValueBaseHolder} object */ public ValueBaseHolder(java.io.Serializable initial) { value = initial; } /** - * Reads from <code>input</code> and initalizes the value in the Holder + * Reads from {@code input} and initalizes the value in the Holder * with the unmarshalled data. * * @param input the InputStream containing CDR formatted data from the wire @@ -86,7 +86,7 @@ } /** - * Marshals to <code>output</code> the value in the Holder. + * Marshals to {@code output} the value in the Holder. * * @param output the OutputStream which will contain the CDR formatted data */ @@ -95,7 +95,7 @@ } /** - * Returns the <code>TypeCode</code> object + * Returns the {@code TypeCode} object * corresponding to the value held in the Holder. * * @return the TypeCode of the value held in the holder
--- a/src/java.corba/share/classes/org/omg/CORBA/ValueMemberHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/ValueMemberHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>ValueMember</tt>. For more information on +* The Helper for {@code ValueMember}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/ValueMemberHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/VersionSpecHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/VersionSpecHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>VersionSpec</tt>. For more information on +* The Helper for {@code VersionSpec}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/VersionSpecHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/VisibilityHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/VisibilityHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>Visibility</tt>. For more information on +* The Helper for {@code Visibility}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/VisibilityHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/WCharSeqHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/WCharSeqHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Helper for <tt>WCharSeq</tt>. For more information on +* The Helper for {@code WCharSeq}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/WCharSeqHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/WCharSeqHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/WCharSeqHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Holder for <tt>WCharSeq</tt>. For more information on +* The Holder for {@code WCharSeq}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> * org/omg/CORBA/WCharSeqHolder.java
--- a/src/java.corba/share/classes/org/omg/CORBA/WStringValueHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/WStringValueHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -24,7 +24,7 @@ */ /** -* The Helper for <tt>WStringValue</tt>. For more information on +* The Helper for {@code WStringValue}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> */
--- a/src/java.corba/share/classes/org/omg/CORBA/WrongTransactionHelper.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/WrongTransactionHelper.java Sun Sep 13 23:31:47 2015 +0300 @@ -25,7 +25,7 @@ package org.omg.CORBA; /** -* The Helper for <tt>WrongTransaction</tt>. For more information on +* The Helper for {@code WrongTransaction}. For more information on * Helper files, see <a href="doc-files/generatedfiles.html#helper"> * "Generated Files: Helper Files"</a>.<P> * org/omg/CORBA/WrongTransactionHelper.java
--- a/src/java.corba/share/classes/org/omg/CORBA/WrongTransactionHolder.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/WrongTransactionHolder.java Sun Sep 13 23:31:47 2015 +0300 @@ -25,7 +25,7 @@ package org.omg.CORBA; /** -* The Holder for <tt>WrongTransaction</tt>. For more information on +* The Holder for {@code WrongTransaction}. For more information on * Holder files, see <a href="doc-files/generatedfiles.html#holder"> * "Generated Files: Holder Files"</a>.<P> * org/omg/CORBA/WrongTransactionHolder.java
--- a/src/java.corba/share/classes/org/omg/CORBA/_IDLTypeStub.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/_IDLTypeStub.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Stub for <tt>IDLType</tt>. For more information on +* The Stub for {@code IDLType}. For more information on * Stub files, see <a href="doc-files/generatedfiles.html#stub"> * "Generated Files: Stubs"</a>.<P> * org/omg/CORBA/_IDLTypeStub.java @@ -38,9 +38,9 @@ public class _IDLTypeStub extends org.omg.CORBA.portable.ObjectImpl implements org.omg.CORBA.IDLType { /** - * Constructs a default <code>_IDLTypeStub</code> object. + * Constructs a default {@code _IDLTypeStub} object. * NOTE: If the default constructor is used, the - * object is useless until the method <code>_set_delegate</code> + * object is useless until the method {@code _set_delegate} * has been called. */ // NOTE: This constructor is not required according to the spec. Only JCK expects it now. @@ -50,8 +50,8 @@ } /** - * Constructs an <code>_IDLTypeStub</code> object initialized - * with the given <code>Delegate</code> object. + * Constructs an {@code _IDLTypeStub} object initialized + * with the given {@code Delegate} object. * * @param delegate a Delegate object */
--- a/src/java.corba/share/classes/org/omg/CORBA/_PolicyStub.java Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/_PolicyStub.java Sun Sep 13 23:31:47 2015 +0300 @@ -26,7 +26,7 @@ /** -* The Stub for <tt>Policy</tt>. For more information on +* The Stub for {@code Policy}. For more information on * Stub files, see <a href="doc-files/generatedfiles.html#stub"> * "Generated Files: Stubs"</a>.<P> * org/omg/CORBA/_PolicyStub.java @@ -47,8 +47,8 @@ super (); } - /** Constructs a <code>_PolicyStub</code> object initialized - * with the given <code>Delegate</code> object. + /** Constructs a {@code _PolicyStub} object initialized + * with the given {@code Delegate} object. * * @param delegate a Delegate Object */
--- a/src/java.corba/share/classes/org/omg/CORBA/doc-files/compliance.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/doc-files/compliance.html Sun Sep 13 23:31:47 2015 +0300 @@ -50,16 +50,16 @@ <li> CORBA 2.3.1 chapters 1-3 and 6-9</li> -<li>Revised IDL to Java language mapping, section 1.21.8.2, the <tt>orb.properties</tt> +<li>Revised IDL to Java language mapping, section 1.21.8.2, the <code>orb.properties</code> file.</li> <li> CORBA 2.3.1 chapter 4 with the following replacements from the Portable Interceptors specification: <ul> - <li>section 4.2.3.5 <TT>destroy</TT></li> - <li>section 4.5.2 <TT>CodeFactory</TT> and <TT>PICurrent</TT> are required</li> - <li>Section 4.5.3.4 as updated for <TT>register_initial_reference</TT></li> + <li>section 4.2.3.5 <code>destroy</code></li> + <li>section 4.5.2 <code>CodeFactory</code> and <code>PICurrent</code> are required</li> + <li>Section 4.5.3.4 as updated for <code>register_initial_reference</code></li> </ul> </li> @@ -68,13 +68,13 @@ specification: <ul> <li> - 5.5.2 <TT>StringSeq</TT> and <TT>WStringSeq</TT> are required. - This adds the following classes to <TT>org.omg.CORBA</TT>: + 5.5.2 <code>StringSeq</code> and <code>WStringSeq</code> are required. + This adds the following classes to <code>org.omg.CORBA</code>: <ul> - <li><TT>StringSeqHolder</TT></li> - <li><TT>StringSeqHelper</TT></li> - <li><TT>WStringSeqHolder</TT></li> - <li><TT>WStringSeqHelper</TT></li> + <li><code>StringSeqHolder</code></li> + <li><code>StringSeqHelper</code></li> + <li><code>WStringSeqHolder</code></li> + <li><code>WStringSeqHelper</code></li> </ul> </li> </ul> @@ -84,14 +84,15 @@ CORBA 2.3.1 sections 10.6.1 and 10.6.2 are supported for repository IDs.</li> <li> -CORBA 2.3.1 section 10.7 for <TT>TypeCode</TT> APIs.</li> +CORBA 2.3.1 section 10.7 for <code>TypeCode</code> APIs.</li> <li> -CORBA 2.3.1 chapter 11, Portable Object Adapter (POA), with the following updates from the Portable Interceptors specification: +CORBA 2.3.1 chapter 11, Portable Object Adapter (POA), +with the following updates from the Portable Interceptors specification: <ul> <li>Section 11.3.7 POAs must preserve all policies</li> <li>Section 11.3.8.2 again states that POAs must preserve all policies</li> - <li>Section 11.3.8.26 <tt>POA::id</tt> is required.</li> + <li>Section 11.3.8.26 <code>POA::id</code> is required.</li> </ul> </li> @@ -104,18 +105,21 @@ All of the Interoperable Naming Service is supported.</li> <li> -Portable Interceptors section 13.8 (the new <TT>Coder</TT>/<TT>Decoder</TT> interfaces) +Portable Interceptors section 13.8 (the new +<code>Coder</code>/<code>Decoder</code> interfaces) and all of chapter 21 (the interceptor specification).</li> -<li>Section 1.21.8 of the Revised IDL to Java Language Mapping Specification (ptc/00-11-03) -has been changed from the version in the IDL to Java Language Mapping Specification (ptc/00-01-08).</li> +<li>Section 1.21.8 of the Revised IDL to Java Language +Mapping Specification (ptc/00-11-03) +has been changed from the version in the +IDL to Java Language Mapping Specification (ptc/00-01-08).</li> </ul> <h2> Tools</h2> <ul> -<li>The IDL to Java compiler (<TT>idlj</TT>) complies with: +<li>The IDL to Java compiler (<code>idlj</code>) complies with: <ul> <li>CORBA 2.3.1 chapter 3 (IDL definition)</li> <li>CORBA 2.3.1 chapters 5 and 6 (semantics of Value types)</li> @@ -125,12 +129,12 @@ </ul> </li> -<li>The Java to IDL compiler (the IIOP backend for <tt>rmic</tt>) complies with: +<li>The Java to IDL compiler (the IIOP backend for <code>rmic</code>) complies with: <ul> <li>CORBA 2.3.1 chapters 5 and 6 (value types)</li> <li>The Java to IDL language mapping. Note that this implicitly references section 1.21 of the IDL to Java language mapping</li> - <li>IDL generated by the <tt>-idl</tt> flag complies with CORBA 2.3.1 chapter 3.</li> + <li>IDL generated by the <code>-idl</code> flag complies with CORBA 2.3.1 chapter 3.</li> </ul> </li> </ul>
--- a/src/java.corba/share/classes/org/omg/CORBA/doc-files/generatedfiles.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/doc-files/generatedfiles.html Sun Sep 13 23:31:47 2015 +0300 @@ -9,7 +9,8 @@ <H1>IDL-to-Java Generated Files</H1> <P>The files that are generated by the IDL-to-Java compiler, in accordance with -the <em><a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08">IDL-to-Java Language Mapping Specification</a></em>, +the <em><a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08"> +IDL-to-Java Language Mapping Specification</a></em>, which is implemented in Java<sup><font size="-2">TM</font></sup> SE 6 according the <a href="compliance.html">compliance</a> document. @@ -18,23 +19,25 @@ and identifiers with no change. Because of the nature of the Java language, a single IDL construct may be mapped to several (differently named) Java constructs. The additional names are constructed by appending a descriptive suffix. -For example, the IDL interface <tt>foo</tt> is mapped to the Java -interfaces <tt>foo</tt> and <tt>fooOperations</tt>, and additional -Java classes <tt>fooHelper</tt>, <tt>fooHolder</tt>, <tt>fooPOA</tt>, -and optionally <tt>fooPOATie</tt>. +For example, the IDL interface <code>foo</code> is mapped to the Java +interfaces <code>foo</code> and <code>fooOperations</code>, and additional +Java classes <code>fooHelper</code>, <code>fooHolder</code>, <code>fooPOA</code>, +and optionally <code>fooPOATie</code>. <P>The mapping in effect reserves the use of several names for its own purposes. These are: <UL> -<LI>The Java class <a href="#helper"><tt><type>Helper</tt></a>, where <tt><type></tt> is the name of an IDL defined type. -<LI>The Java class <a href="#holder"><tt><type>Holder</tt></a>, where <tt><type></tt> -is the name of an IDL defined type (with certain exceptions such as <tt>typedef</tt> aliases). -<LI>The Java classes <tt><basicJavaType>Holder</tt>, where <tt><basicJavaType></tt> +<LI>The Java class <a href="#helper"><code><type>Helper</code></a>, +where <code><type></code> is the name of an IDL defined type. +<LI>The Java class <a href="#holder"><code><type>Holder</code></a>, +where <code><type></code> +is the name of an IDL defined type (with certain exceptions such as <code>typedef</code> aliases). +<LI>The Java classes <code><basicJavaType>Holder</code>, where <code><basicJavaType></code> is one of the Java primitive datatypes that is used by one of the IDL basic datatypes. -<LI>The Java classes <a href="#operations"><tt><interface>Operations</tt></a>, <tt><interface>POA</tt>, -and <tt><interface>POATie</tt>, where <tt><interface></tt> is the name of an IDL interface type. -<LI>The nested scope Java package name <tt><interface>Package</tt>, where <tt><interface></tt> +<LI>The Java classes <a href="#operations"><code><interface>Operations</code></a>, <code><interface>POA</code>, +and <code><interface>POATie</code>, where <code><interface></code> is the name of an IDL interface type. +<LI>The nested scope Java package name <code><interface>Package</code>, where <code><interface></code> is the name of an IDL interface. </UL> @@ -42,50 +45,55 @@ <H2><a name="helper">Helper Files</a></H2> <P>Helper files supply several static methods needed to manipulate the type. -These include <tt>Any</tt> insert and extract operations for the type, +These include <code>Any</code> insert and extract operations for the type, getting the repository id, getting the typecode, and reading and writing the type from and to a stream. <P>The helper class for a mapped IDL interface or abstract interface also -include narrow operation(s). The static narrow method allows an <tt>org.omg.CORBA.Object</tt> +include narrow operation(s). The static narrow method allows an <code>org.omg.CORBA.Object</code> to be narrowed to the object reference of a more specific type. -The IDL exception <tt>CORBA::BAD_PARAM</tt> is thrown if the narrow fails because +The IDL exception <code>CORBA::BAD_PARAM</code> is thrown if the narrow fails because the object reference does not support the requested type. A different system exception -is raised to indicate other kinds of errors. Trying to narrow a null will always succeed with a return value of null. +is raised to indicate other kinds of errors. Trying to narrow +a null will always succeed with a return value of null. <H2><a name="holder">Holder Files</a></H2> <P>Support for out and inout parameter passing modes requires the use of additional holder classes. -These classes are available for all of the basic IDL datatypes in the <tt>org.omg.CORBA</tt> package +These classes are available for all of the basic IDL datatypes in the <code>org.omg.CORBA</code> package and are generated for all named user defined IDL types except those defined by typedefs. (Note that in this context user defined includes types that are defined in OMG specifications such as those for the Interface Repository, and other OMG services.) <P>Each holder class has a constructor from an instance, a default constructor, and has -a public instance member, <tt>value</tt> which is the typed value. The default constructor +a public instance member, <code>value</code> which is the typed value. The default constructor sets the value field to the default value for the type as defined by the Java language: false for boolean, 0 for numeric and char types, null for strings, null for object references. <P>To support portable stubs and skeletons, holder classes also implement -the <tt>org.omg.CORBA.portable.Streamable</tt> interface. +the <code>org.omg.CORBA.portable.Streamable</code> interface. <H2><a name="operations">Operations Files</a></H2> <P>A non abstract IDL interface is mapped to two public Java interfaces: a <em>signature</em> interface and an <em>operations</em> interface. -The signature interface, which extends <tt>IDLEntity</tt>, has the same -name as the IDL interface name and is used as the signature type in method declarations +The signature interface, which extends <code>IDLEntity</code>, has the same +name as the IDL interface name and is used +as the signature type in method declarations when interfaces of the specified type are used in other interfaces. -The operations interface has the same name as the IDL interface with the suffix <tt>Operations</tt> +The operations interface has the same name as the IDL interface +with the suffix <code>Operations</code> appended to the end and is used in the server-side mapping and as a mechanism for providing optimized calls for collocated client and servers. <P>The Java operations interface contains the mapped operation signatures. The Java signature interface extends the operations interface, -the (mapped) base <tt>org.omg.CORBA.Object</tt>, as well as <tt>org.omg.portable.IDLEntity</tt>. +the (mapped) base <code>org.omg.CORBA.Object</code>, +as well as <code>org.omg.portable.IDLEntity</code>. Methods can be invoked on the signature interface. Interface inheritance -expressed in IDL is reflected in both the Java signature interface and operations interface hierarchies. +expressed in IDL is reflected in both the Java signature +interface and operations interface hierarchies. <H2><a name="stub">Stubs</a></H2> @@ -96,11 +104,13 @@ for programmers to predict once they are familiar with OMG IDL and the language mapping for the particular programming language. The stubs make calls on the rest of the ORB using interfaces that are private to, and presumably optimized for, the particular ORB Core. -If more than one ORB is available, there may be different stubs corresponding to the different ORBs. -In this case, it is necessary for the ORB and language mapping to cooperate to associate +If more than one ORB is available, there may be different stubs +corresponding to the different ORBs. In this case, it is necessary for +the ORB and language mapping to cooperate to associate the correct stubs with the particular object reference. -<P>Object-oriented programming languages, such as Java, C++, and Smalltalk, do not require stub interfaces. +<P>Object-oriented programming languages, such as Java, +C++, and Smalltalk, do not require stub interfaces. <BR><BR>
--- a/src/java.corba/share/classes/org/omg/CORBA/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CORBA/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -34,27 +34,27 @@ <BODY BGCOLOR="#FFFFFF"> Provides the mapping of the OMG CORBA APIs to the Java<SUP><FONT SIZE=-2>TM</FONT></SUP> -programming language, including the class <TT>ORB</TT>, which is implemented +programming language, including the class <code>ORB</code>, which is implemented so that a programmer can use it as a fully-functional Object Request Broker (ORB). -<P>For a precise list of supported sections of official CORBA specifications with which -the Java[TM] Platform, Standard Edition 6 complies, see <A -HREF="doc-files/compliance.html"><em>Official Specifications for CORBA support in +<P>For a precise list of supported sections of official CORBA specifications with which +the Java[TM] Platform, Standard Edition 6 complies, see <A +HREF="doc-files/compliance.html"><em>Official Specifications for CORBA support in Java[TM] SE 6</em></A>. <H1>General Information</H1> -The information in this section is information relevant to someone who +The information in this section is information relevant to someone who compiles Interface Definition Language (IDL) files and uses the ORB to write clients and servers. -<P>The classes and interfaces described in this section can be put into -four groups: <tt>ORB classes</tt>, Exceptions, <tt>Helper</tt> classes, -and <tt>Holder</tt> classes. +<P>The classes and interfaces described in this section can be put into +four groups: <code>ORB classes</code>, Exceptions, <code>Helper</code> classes, +and <code>Holder</code> classes. <H2> -The <tt>ORB</tt> Class</H2> +The <code>ORB</code> Class</H2> <P>An ORB handles (or brokers) method invocations between a client and the method's implementation on a server. Because the client and server @@ -63,92 +63,91 @@ deal of work behind the scenes to accomplish this communication. <P>Most of what an ORB does is completely transparent to the user, and a major -portion of the <TT>CORBA</TT> package consists of classes used by the ORB +portion of the <code>CORBA</code> package consists of classes used by the ORB behind the scenes. The result is that most programmers will use only a small part of this package directly. In fact, most programmers will use -only a few methods from the <TT>ORB</TT> class, some exceptions, and +only a few methods from the <code>ORB</code> class, some exceptions, and occasionally, -a holder class. +a holder class. <H3> -<TT>ORB</TT> Methods</H3> +<code>ORB</code> Methods</H3> -<P>Before an application can enter the CORBA environment, it must first: +<P>Before an application can enter the CORBA environment, it must first: <UL> <LI>Be initialized into the ORB and possibly the object adapter (POA) environments. -<LI>Get references to ORB object (for use in future ORB operations) -and perhaps other objects (including the root POA or some Object Adapter objects). +<LI>Get references to ORB object (for use in future ORB operations) +and perhaps other objects (including the root POA or some Object Adapter objects). </UL> <P>The following operations are provided to initialize applications and obtain the appropriate object references: <UL> <LI>Operations providing access to the ORB, which are discussed in this section. - <LI>Operations providing access to Object Adapters, Interface Repository, - Naming Service, and other Object Services. These operations are described + <LI>Operations providing access to Object Adapters, Interface Repository, + Naming Service, and other Object Services. These operations are described in <a href="#adv"><em>Other Classes</em></a>. </UL> <P> -When an application requires a CORBA environment it needs a mechanism to -get an ORB object reference and possibly an OA object reference -(such as the root POA). This serves two purposes. First, it initializes -an application into the ORB and OA environments. Second, it returns the -ORB object reference and the OA object reference to the application -for use in future ORB and OA operations. +When an application requires a CORBA environment it needs a mechanism to +get an ORB object reference and possibly an OA object reference +(such as the root POA). This serves two purposes. First, it initializes +an application into the ORB and OA environments. Second, it returns the +ORB object reference and the OA object reference to the application +for use in future ORB and OA operations. -<P>In order to obtain an ORB object reference, applications call -the <tt>ORB.init</tt> operation. The parameters to the call can comprise an +<P>In order to obtain an ORB object reference, applications call +the <code>ORB.init</code> operation. The parameters to the call can comprise an identifier for the ORB for which the object reference is required, - and an arg_list, which is used to allow environment-specific data to be - passed into the call. + and an arg_list, which is used to allow environment-specific data to be + passed into the call. -<P>These are the <TT>ORB</TT> methods +<P>These are the <code>ORB</code> methods that provide access to the ORB: <UL> <LI> -<TT><b>init</b>()</TT> +<code><b>init</b>()</code> <LI> -<TT><b>init</b>(String [] args, Properties props)</TT> +<code><b>init</b>(String [] args, Properties props)</code> <LI> -<TT><b>init</b>(Applet app, Properties props)</TT> +<code><b>init</b>(Applet app, Properties props)</code> </UL> -<P>Using the <tt>init()</tt> method without parameters initiates +<P>Using the <code>init()</code> method without parameters initiates a singleton ORB, which can only -give typecode creation <tt>any</tt>s needed in code generated -in Helper classes by <tt>idlj</tt>. +give typecode creation <code>any</code>s needed in code generated +in Helper classes by <code>idlj</code>. -<P>Applications require a portable means by which to obtain their -initial object references. References are required for the root -POA, POA Current, Interface Repository, and various Object Services +<P>Applications require a portable means by which to obtain their +initial object references. References are required for the root +POA, POA Current, Interface Repository, and various Object Services instances. The functionality required by the application is similar - to that provided by the Naming Service. However, the OMG does not - want to mandate that the Naming Service be made available to all - applications in order that they may be portably initialized. - Consequently, the operations shown in this section provide a - simplified, local version of the Naming Service that applications - can use to obtain a small, defined set of object references which - are essential to its operation. Because only a small well-defined + to that provided by the Naming Service. However, the OMG does not + want to mandate that the Naming Service be made available to all + applications in order that they may be portably initialized. + Consequently, the operations shown in this section provide a + simplified, local version of the Naming Service that applications + can use to obtain a small, defined set of object references which + are essential to its operation. Because only a small well-defined set of objects are expected with this mechanism, the naming context can be flattened to be a single-level name space. This simplification results in only two operations being defined to achieve the functionality required. -<P>Initial references are obtained via two operations provided in -the ORB object interface, providing facilities to list and +<P>Initial references are obtained via two operations provided in +the ORB object interface, providing facilities to list and resolve initial object references. These are: <UL> <LI> -<TT><b>resolve_initial_references</b>(String name)</TT> +<code><b>resolve_initial_references</b>(String name)</code> <LI> -<TT><b>list_initial_services</b>()</TT> +<code><b>list_initial_services</b>()</code> <LI> -<TT><b>register_initial_reference</b>(String id, -org.omg.CORBA.Object obj)</TT> +<code><b>register_initial_reference</b>(String id, org.omg.CORBA.Object obj)</code> </UL> -<P>An example that uses some of these methods is <A +<P>An example that uses some of these methods is <A HREF="{@docRoot}/../technotes/guides/idl/GShome.html"> <em>Getting Started with Java IDL</em></A>. @@ -156,7 +155,7 @@ Exceptions</H2> Exceptions in Java IDL are similar to those in any code written in the Java programming language. If a method is defined to throw an exception, -then any code using that method must have a <TT>try</TT>/<TT>catch</TT> +then any code using that method must have a <code>try</code>/<code>catch</code> block and handle that exception when it is thrown. <P>The documentation on <A @@ -165,10 +164,10 @@ system exceptions and user-defined exceptions. <P>The following is a list of the system exceptions (which are unchecked -exceptions inheriting through <TT><a href="SystemException.html"> -org.omg.CORBA.SystemException</a></TT> from -<TT>java.lang.RuntimeException</TT>) that are defined in the package -<TT>org.omg.CORBA</TT>: +exceptions inheriting through <code><a href="SystemException.html"> +org.omg.CORBA.SystemException</a></code> from +<code>java.lang.RuntimeException</code>) that are defined in the package +<code>org.omg.CORBA</code>: <PRE><code> BAD_CONTEXT BAD_INV_ORDER @@ -203,7 +202,7 @@ </code></PRE> <P> The following is a list of user-defined exceptions defined in the package -<TT>org.omg.CORBA</TT>. +<code>org.omg.CORBA</code>. <PRE><code> Bounds UnknownUserException @@ -212,37 +211,37 @@ </code></PRE> <H2>Subpackages</H2> -There are some packages inside the <TT>CORBA</TT> package with +There are some packages inside the <code>CORBA</code> package with "Package" as part of their names. These packages are generally quite small because all they do is provide exceptions or classes for use by interfaces -and classes in the <TT>CORBA</TT> package. +and classes in the <code>CORBA</code> package. -<P>For example, the package <TT><a href="TypeCodePackage/package-summary.html"> -org.omg.CORBA.TypeCodePackage</a></TT> contains -two exceptions thrown by methods in the class <TT>TypeCode</TT>. These +<P>For example, the package <code><a href="TypeCodePackage/package-summary.html"> +org.omg.CORBA.TypeCodePackage</a></code> contains +two exceptions thrown by methods in the class <code>TypeCode</code>. These exceptions are: <UL> <LI> -<TT>BadKind</TT> +<code>BadKind</code> <LI> -<TT>Bounds</TT> +<code>Bounds</code> </UL> -The package <TT><a href="ORBPackage/package-summary.html"> -org.omg.CORBA.ORBPackage</a></TT> contains two exceptions: +The package <code><a href="ORBPackage/package-summary.html"> +org.omg.CORBA.ORBPackage</a></code> contains two exceptions: <UL> <LI> -<TT>InvalidName</TT> +<code>InvalidName</code> <LI> -<TT>InconsistentTypeCode</TT> +<code>InconsistentTypeCode</code> </UL> -<P>Another package that is a subpackage of <tt>CORBA</tt> is the <tt> -<a href="portable/package-summary.html">portable</a></tt> package. It -provides a set of ORB APIs that makes it +<P>Another package that is a subpackage of <code>CORBA</code> is the +<code><a href="portable/package-summary.html">portable</a></code> +package. It provides a set of ORB APIs that makes it possible for code generated by one vendor's IDL compiler to run -on another vendor's ORB. +on another vendor's ORB. @@ -251,47 +250,49 @@ Holder classes</H2> -<P>Support for out and inout parameter passing modes requires the use of -additional <em><a href="doc-files/generatedfiles.html#holder">holder -classes</a></em>. Because the Java programming language does not support out or +<P>Support for out and inout parameter passing modes requires the use of +additional <em><a href="doc-files/generatedfiles.html#holder">holder +classes</a></em>. Because the Java programming language does not support out or inout parameters, holder classes are needed as a means of passing a parameter -that can be modified. To support portable stubs and skeletons, holder classes also implement - the <tt><a href="portable/Streamable.html">org.omg.CORBA.portable.Streamable</a> - </tt> interface. +that can be modified. To support portable stubs and skeletons, +holder classes also implement the +<code><a href="portable/Streamable.html">org.omg.CORBA.portable.Streamable</a></code> +interface. <P>Holder classes are named by appending "Holder" to the name of the type. The name of the type refers to its name in the Java programming language. For - example, a holder class for the interface named <tt>Account</tt> in the Java programming - language would be named <tt>AccountHolder</tt>. + example, a holder class for the interface named <code>Account</code> + in the Java programming + language would be named <code>AccountHolder</code>. <P>Holder classes are available for all of the basic IDL - datatypes in the <tt>org.omg.CORBA</tt> package. So, for example, - there are already-defined classes for <tt>LongHolder</tt>, <tt>ShortHolder</tt>, - <tt>FloatHolder</tt>, and so on. Classes are also generated for - all named user-defined IDL types except those defined by <tt>typedefs</tt>. - (Note that in this context user defined includes types that are + datatypes in the <code>org.omg.CORBA</code> package. So, for example, + there are already-defined classes for <code>LongHolder</code>, <code>ShortHolder</code>, + <code>FloatHolder</code>, and so on. Classes are also generated for + all named user-defined IDL types except those defined by <code>typedefs</code>. + (Note that in this context user defined includes types that are defined in OMG specifications such as those for the Interface - Repository, and other OMG services.) + Repository, and other OMG services.) <P>Each holder class has: <UL> <LI>a constructor from an instance <LI>a default constructor -<LI>a public instance member, <tt>value</tt> which is the typed value. -<LI>a method for reading an input stream and assigning the contents to the -type's <tt>value</tt> field -<LI>a method for writing the value of the <tt>value</tt> field to an output stream +<LI>a public instance member, <code>value</code> which is the typed value. +<LI>a method for reading an input stream and assigning the contents to the +type's <code>value</code> field +<LI>a method for writing the value of the <code>value</code> field to an output stream <LI>a method for getting the typecode of the type </UL> -<P>The default constructor sets the value field to the default value for the -type as defined by the Java language: +<P>The default constructor sets the value field to the default value for the +type as defined by the Java language: <UL> -<LI><tt>false</tt> for boolean -<LI><tt>0</tt> for numeric and char types -<LI><tt>null</tt> for strings and object references +<LI><code>false</code> for boolean +<LI><code>0</code> for numeric and char types +<LI><code>null</code> for strings and object references </UL> @@ -301,7 +302,7 @@ were mapped to the Java programming language, the following holder class would be generated: <PRE> -public final class AccountHolder implements +public final class AccountHolder implements org.omg.CORBA.portable.Streamable { // field that holds an Account object @@ -342,53 +343,52 @@ <P>For more information on Holder classes, see Chapter 1.4, <em>Mapping for Basic Types</em> in the <a href="http://www.omg.org/cgi-bin/doc?ptc/00-01-08"> <em>OMG IDL to Java Language Mapping</em></a>. The Holder classes defined -in the package <TT>org.omg.CORBA</TT> are: -<PRE> - <TT>AnyHolder -</TT> <TT>AnySeqHolder -</TT> <TT>BooleanHolder -</TT> <TT>BooleanSeqHolder -</TT> <TT>ByteHolder -</TT> <TT>CharHolder -</TT> <TT>CharSeqHolder -</TT> <TT>CurrentHolder -</TT> <TT>DoubleHolder -</TT> <TT>DoubleSeqHolder -</TT> <TT>FixedHolder -</TT> <TT>FloatHolder -</TT> <TT>FloatSeqHolder -</TT> <TT>IntHolder -</TT> <TT>LongHolder -</TT> <TT>LongLongSeqHolder -</TT> <TT>LongSeqHolder -</TT> <TT>ObjectHolder -</TT> <TT>OctetSeqHolder -</TT> <TT>ParameterModeHolder -</TT> <TT>PolicyErrorHolder -</TT> <TT>PolicyListHolder -</TT> <TT>PrincipalHolder -</TT> <TT>ServiceInformationHolder -</TT> <TT>ShortHolder -</TT> <TT>ShortSeqHolder -</TT> <TT>StringHolder -</TT> <TT>StringSeqHolder -</TT> <TT>TypeCodeHolder -</TT> <TT>ULongLongSeqHolder -</TT> <TT>ULongSeqHolder -</TT> <TT>UnknownUserExceptionHolder -</TT> <TT>UShortSeqHolder -</TT> <TT>ValueBaseHolder -</TT> <TT>WCharSeqHolder -</TT> <TT>WrongTransactionHolder -</TT> <TT>WStringSeqHolder</TT> - -</PRE> +in the package <code>org.omg.CORBA</code> are: +<PRE><code> + AnyHolder + AnySeqHolder + BooleanHolder + BooleanSeqHolder + ByteHolder + CharHolder + CharSeqHolder + CurrentHolder + DoubleHolder + DoubleSeqHolder + FixedHolder + FloatHolder + FloatSeqHolder + IntHolder + LongHolder + LongLongSeqHolder + LongSeqHolder + ObjectHolder + OctetSeqHolder + ParameterModeHolder + PolicyErrorHolder + PolicyListHolder + PrincipalHolder + ServiceInformationHolder + ShortHolder + ShortSeqHolder + StringHolder + StringSeqHolder + TypeCodeHolder + ULongLongSeqHolder + ULongSeqHolder + UnknownUserExceptionHolder + UShortSeqHolder + ValueBaseHolder + WCharSeqHolder + WrongTransactionHolder + WStringSeqHolder +</code></PRE> <h2>Helper Classes </h2> <P>Helper files supply several static methods needed to manipulate the type. These include: <UL> - <LI><tt>Any</tt> insert and extract operations for the type + <LI><code>Any</code> insert and extract operations for the type <LI>getting the repository id <LI>getting the typecode <LI>reading and writing the type from and to a stream @@ -397,25 +397,26 @@ </UL> <P>The helper class for a mapped IDL interface or abstract interface - also include narrow operation(s). The static narrow method allows - an <tt>org.omg.CORBA.Object</tt> to be narrowed to the object reference - of a more specific type. The IDL exception <tt>CORBA.BAD_PARAM</tt> - is thrown if the narrow fails because the object reference does not - support the requested type. A different system exception is raised - to indicate other kinds of errors. Trying to narrow a <tt>null</tt> will always - succeed with a return value of <tt>null</tt>. Generally, the only helper method an application programmer uses is +also include narrow operation(s). The static narrow method allows +an <code>org.omg.CORBA.Object</code> to be narrowed to the object reference +of a more specific type. The IDL exception <code>CORBA.BAD_PARAM</code> +is thrown if the narrow fails because the object reference does not +support the requested type. A different system exception is raised +to indicate other kinds of errors. Trying to narrow a <code>null</code> will always +succeed with a return value of <code>null</code>. +Generally, the only helper method an application programmer uses is the <code>narrow</code> method. The other methods are normally used behind the scenes and are transparent to the programmer. <P>Helper classes fall into two broad categories, <a href="#value">helpers for value types</a> and -<a href="#basic">helpers for non value types</a>. Because all of the helper +<a href="#basic">helpers for non value types</a>. Because all of the helper classes in one category -provide the same methods, one generic explanation of each +provide the same methods, one generic explanation of each category of helper classes is presented here. <P> -When OMG IDL is mapped to the Java programming language, +When OMG IDL is mapped to the Java programming language, a "helper" class is generated for each user-defined type. This generated class will have the name of the user-defined type with the suffix <code>Helper</code> appended. For example, if the @@ -423,7 +424,7 @@ <code>idlj</code> compiler will automatically generate a class named <code>AccountHelper</code>. The <code>AccountHelper</code> class will contain the static methods needed for manipulating instances of the type, -in this case, <code>Account</code> objects. +in this case, <code>Account</code> objects. <a name="narrow"></a> @@ -442,14 +443,12 @@ not determines which <code>narrow</code> method its helper class will provide. The helper class for an interface that is not abstract will have a <code>narrow</code> method that takes a CORBA -object, whereas the <code>narrow</code> method for an interface that is abstract -will -take an object in the Java programming language. The helper class for a +object, whereas the <code>narrow</code> method for an interface that is abstract +will take an object in the Java programming language. The helper class for a non-abstract interface that has at least one abstract base interface will provide both versions of the <code>narrow</code> method. -<P>The <A HREF="{@docRoot}/../technotes/guides/idl/jidlExample.html"><em>Hello World</em></A> -tutorial uses a <tt>narrow</tt> method that looks -like this: +<P>The <A HREF="{@docRoot}/../technotes/guides/idl/jidlExample.html"><em>Hello World</em></A> +tutorial uses a <code>narrow</code> method that looks like this: <PRE> // create and initialize the ORB ORB orb = ORB.init(args, null); @@ -469,7 +468,7 @@ <a name="basic"></a> <h3>Example of a Basic Helper Class</h3> A basic helper class, for purposes of this explanation, is one with -the methods that are provided by every helper class, plus a <code>narrow</code> +the methods that are provided by every helper class, plus a <code>narrow</code> method if the type defined in OMG IDL maps to an interface in the Java programming language. Types that are not value types will have a basic helper class generated for them. @@ -626,57 +625,56 @@ } </pre> -<P>The Helper classes defined in the package <TT>org.omg.CORBA</TT> are: +<P>The Helper classes defined in the package <code>org.omg.CORBA</code> are: <PRE><code> - <TT>AnySeqHelper -</TT> <TT>BooleanSeqHelper -</TT> <TT>CharSeqHelper -</TT> <TT>CompletionStatusHelper -</TT> <TT>CurrentHelper -</TT> <TT>DefinitionKindHelper -</TT> <TT>DoubleSeqHelper -</TT> <TT>FieldNameHelper -</TT> <TT>FloatSeqHelper -</TT> <TT>IdentifierHelper -</TT> <TT>IDLTypeHelper -</TT> <TT>LongLongSeqHelper -</TT> <TT>LongSeqHelper -</TT> <TT>NameValuePairHelper -</TT> <TT>ObjectHelper -</TT> <TT>OctetSeqHelper -</TT> <TT>ParameterModeHelper -</TT> <TT>PolicyErrorCodeHelper -</TT> <TT>PolicyErrorHelper -</TT> <TT>PolicyHelper -</TT> <TT>PolicyListHelper -</TT> <TT>PolicyTypeHelper -</TT> <TT>RepositoryIdHelper -</TT> <TT>ServiceDetailHelper -</TT> <TT>ServiceInformationHelper -</TT> <TT>SetOverrideTypeHelper -</TT> <TT>ShortSeqHelper -</TT> <TT>StringSeqHelper -</TT> <TT>StringValueHelper -</TT> <TT>StructMemberHelper -</TT> <TT>ULongLongSeqHelper -</TT> <TT>ULongSeqHelper -</TT> <TT>UnionMemberHelper -</TT> <TT>UnknownUserExceptionHelper -</TT> <TT>UShortSeqHelper -</TT> <TT>ValueBaseHelper -</TT> <TT>ValueMemberHelper -</TT> <TT>VersionSpecHelper -</TT> <TT>VisibilityHelper -</TT> <TT>WCharSeqHelper -</TT> <TT>WrongTransactionHelper -</TT> <TT>WStringSeqHelper -</TT> <TT>WStringValueHelper</TT> - + AnySeqHelper + BooleanSeqHelper + CharSeqHelper + CompletionStatusHelper + CurrentHelper + DefinitionKindHelper + DoubleSeqHelper + FieldNameHelper + FloatSeqHelper + IdentifierHelper + IDLTypeHelper + LongLongSeqHelper + LongSeqHelper + NameValuePairHelper + ObjectHelper + OctetSeqHelper + ParameterModeHelper + PolicyErrorCodeHelper + PolicyErrorHelper + PolicyHelper + PolicyListHelper + PolicyTypeHelper + RepositoryIdHelper + ServiceDetailHelper + ServiceInformationHelper + SetOverrideTypeHelper + ShortSeqHelper + StringSeqHelper + StringValueHelper + StructMemberHelper + ULongLongSeqHelper + ULongSeqHelper + UnionMemberHelper + UnknownUserExceptionHelper + UShortSeqHelper + ValueBaseHelper + ValueMemberHelper + VersionSpecHelper + VisibilityHelper + WCharSeqHelper + WrongTransactionHelper + WStringSeqHelper + WStringValueHelper </code></PRE> <a name="adv"></a> <H1> Other Classes</H1> -The other classes and interfaces in the <TT>CORBA</TT> package, which are +The other classes and interfaces in the <code>CORBA</code> package, which are used behind the scenes, can be put into four groups. Three of the groups are used with requests in some capacity, and the fourth group, concerning the Interface Repository, is a category by itself. @@ -686,38 +684,38 @@ information used in request operations. <UL> <LI> -<TT>TCKind</TT> -- indicates the kind (datatype) for a <TT>TypeCode</TT> +<code>TCKind</code> -- indicates the kind (datatype) for a <code>TypeCode</code> object <LI> -<TT>TypeCode</TT> -- indicates a datatype and possibly other information +<code>TypeCode</code> -- indicates a datatype and possibly other information <LI> -<TT>Any</TT> -- contains a value and its typecode +<code>Any</code> -- contains a value and its typecode <LI> -<TT>NamedValue</TT> -- contains a name, an <TT>Any</TT> object, and an -argument mode flag. <TT>NamedValue</TT> objects contain information about +<code>NamedValue</code> -- contains a name, an <code>Any</code> object, and an +argument mode flag. <code>NamedValue</code> objects contain information about method arguments, method return values, or a context. <LI> -<TT>ContextList</TT> -- a list of strings that describe the contexts that +<code>ContextList</code> -- a list of strings that describe the contexts that need to be resolved and sent with an invocation <LI> -<TT>ExceptionList</TT> -- a list of <TT>TypeCode</TT>s for exceptions that +<code>ExceptionList</code> -- a list of <code>TypeCode</code>s for exceptions that may be thrown by a method <LI> -<TT>Environment</TT> -- a container for the exception thrown during a method +<code>Environment</code> -- a container for the exception thrown during a method invocation <LI> -<TT>Context</TT> -- a list of <TT>NamedValue</TT> objects used to pass +<code>Context</code> -- a list of <code>NamedValue</code> objects used to pass auxiliary information from client to server <LI> -<TT>NVList</TT> -- a list of <TT>NamedValue</TT> objects, used to pass +<code>NVList</code> -- a list of <code>NamedValue</code> objects, used to pass arguments or get results </UL> @@ -726,23 +724,23 @@ The second group of classes deals with requests: <UL> <LI> -<TT>Object</TT> -- the base class for all CORBA object references +<code>Object</code> -- the base class for all CORBA object references <LI> -<TT>Request</TT> -- the main class in the DII, which contains methods for +<code>Request</code> -- the main class in the DII, which contains methods for adding arguments to the request, for accessing information about the method being invoked (the method name, its arguments, exceptions it throws, and so on), and for making invocations on the request <LI> -<TT>DynamicImplementation</TT> -- the base class for server implementations -using the DSI. It has the method <TT>invoke</TT>, which is used by an +<code>DynamicImplementation</code> -- the base class for server implementations +using the DSI. It has the method <code>invoke</code>, which is used by an implementation -of this class to determine the state of a <TT>ServerRequest</TT> object +of this class to determine the state of a <code>ServerRequest</code> object and to set its result or exception <LI> -<TT>ServerRequest</TT> -- captures the explicit state of a request for +<code>ServerRequest</code> -- captures the explicit state of a request for the Dynamic Skeleton Interface </UL> @@ -750,82 +748,82 @@ Interfaces That Serve as Constants</H2> The third group contains interfaces that serve as constants. The IDL-to-Java mapping mandates that IDL enums are mapped to a Java class with the enumerated -values represented as public static final fields in that class (e.g. +values represented as public static final fields in that class (e.g. DefinitionKind). On the other hand IDL constants defined outside of an IDL interface are mapped to a Java interface for each constant. -<P>This is why several interfaces in the <TT>org.omg.CORBA</TT> package -consist of a single field, <TT>value</TT>, which is a <TT>short</TT>. This +<P>This is why several interfaces in the <code>org.omg.CORBA</code> package +consist of a single field, <code>value</code>, which is a <code>short</code>. This field is a constant used for such things as an error code or value modifier. -For example, the <TT>value</TT> field of the interface <TT>BAD_POLICY</TT> -is one of the possible reasons for the exception <TT>PolicyError</TT> to -be thrown. To specify this error code, you would use <TT>BAD_POLICY.value</TT>. +For example, the <code>value</code> field of the interface <code>BAD_POLICY</code> +is one of the possible reasons for the exception <code>PolicyError</code> to +be thrown. To specify this error code, you would use <code>BAD_POLICY.value</code>. -<P>The exception <TT>PolicyError</TT> uses the <TT>value</TT> field of +<P>The exception <code>PolicyError</code> uses the <code>value</code> field of the following interfaces as its possible error codes. <UL> <LI> -<TT>BAD_POLICY</TT> +<code>BAD_POLICY</code> <LI> -<TT>BAD_POLICY_TYPE</TT> +<code>BAD_POLICY_TYPE</code> <LI> -<TT>BAD_POLICY_VALUE</TT> +<code>BAD_POLICY_VALUE</code> <LI> -<TT>UNSUPPORTED_POLICY</TT> +<code>UNSUPPORTED_POLICY</code> <LI> -<TT>UNSUPPORTED_POLICY_VALUE</TT> +<code>UNSUPPORTED_POLICY_VALUE</code> </UL> -The method <TT>TypeCode.type_modifier</TT> returns the <TT>value</TT> field -of one of the following interfaces. The <TT>VM</TT> in the names of these +The method <code>TypeCode.type_modifier</code> returns the <code>value</code> field +of one of the following interfaces. The <code>VM</code> in the names of these interfaces stands for "value modifier." <UL> <LI> -<TT>VM_NONE</TT> +<code>VM_NONE</code> <LI> -<TT>VM_ABSTRACT</TT> +<code>VM_ABSTRACT</code> <LI> -<TT>VM_CUSTOM</TT> +<code>VM_CUSTOM</code> <LI> -<TT>VM_TRUNCATABLE</TT> +<code>VM_TRUNCATABLE</code> </UL> The following constants are returned by a <code>ValueMember</code> object's access method to denote the visibility of the <code>ValueMember</code> object. <UL> <LI> -<TT>PRIVATE_MEMBER</TT> +<code>PRIVATE_MEMBER</code> <LI> -<TT>PUBLIC_MEMBER</TT> +<code>PUBLIC_MEMBER</code> </UL> -These flags, used in <TT>NamedValue</TT> objects or as parameters to methods, +These flags, used in <code>NamedValue</code> objects or as parameters to methods, are defined in the following interfaces: <UL> <LI> -<TT>ARG_IN</TT> +<code>ARG_IN</code> <LI> -<TT>ARG_INOUT</TT> +<code>ARG_INOUT</code> <LI> -<TT>ARG_OUT</TT> +<code>ARG_OUT</code> <LI> -<TT>CTX_RESTRICT_SCOPE</TT> +<code>CTX_RESTRICT_SCOPE</code> </UL> <H2> Interface Repository Interfaces and Classes</H2> A fourth group contains the Interface Repository interfaces and classes, -which are generated by the <TT>idlj</TT> compiler from the OMG IDL -interface <TT>ir.idl</TT>. The purpose of the Interface Repository is to +which are generated by the <code>idlj</code> compiler from the OMG IDL +interface <code>ir.idl</code>. The purpose of the Interface Repository is to identify the interfaces stored in it so that they can be accessed by an ORB. Each module, type, interface, attribute, operation, parameter, exception, constant, and so on is described completely by the Interface Repository @@ -874,7 +872,7 @@ <H1> CORBA Features Not Implemented in Java IDL</H1> -<P>Some of the API included in <TT>org.omg</TT> subpackages is provided for +<P>Some of the API included in <code>org.omg</code> subpackages is provided for conformance with the current OMG CORBA specification but is not implemented in Sun's release of the JDK<SUP><FONT SIZE=-2>TM</FONT></SUP>. This enables other JDK licensees to provide implementations of this API in standard @@ -883,21 +881,21 @@ <P><A NAME="NO_IMPLEMENT"></A> <h2>Features That Throw NO_IMPLEMENT</h2> -<P>Some of the API included in <TT>org.omg</TT> subpackages throw -<tt>NO_IMPLEMENT</tt> exceptions for various reasons. Among these reasons +<P>Some of the API included in <code>org.omg</code> subpackages throw +<code>NO_IMPLEMENT</code> exceptions for various reasons. Among these reasons are: <UL> - <LI>In some cases, for example <tt>LocalObject</tt>, the complete - implementation according to the specification indicates that - these API should throw <tt>NO_IMPLEMENT</tt>. + <LI>In some cases, for example <code>LocalObject</code>, the complete + implementation according to the specification indicates that + these API should throw <code>NO_IMPLEMENT</code>. - <LI>In most cases, for example methods in <tt>ORB.java</tt>, - methods that throw - <tt>NO_IMPLEMENT</tt> are actually implemented in subclasses + <LI>In most cases, for example methods in <code>ORB.java</code>, + methods that throw + <code>NO_IMPLEMENT</code> are actually implemented in subclasses elsewhere in the ORB code. - <LI>In some cases, for example <tt>_get_interface_def()</tt> - and <tt>_get_interface</tt>, API are really not yet implemented. + <LI>In some cases, for example <code>_get_interface_def()</code> + and <code>_get_interface</code>, API are really not yet implemented. </UL> @@ -912,65 +910,67 @@ operation of Java IDL. <LI> -Java IDL does not support <TT>long double</TT>. +Java IDL does not support <code>long double</code>. <LI> -Policies (<TT><a href="Policy.html">org.omg.CORBA.Policy</a></TT>) and methods for getting them are not implemented. +Policies (<code><a href="Policy.html">org.omg.CORBA.Policy</a></code>) +and methods for getting them are not implemented. <LI> -Domain managers (<TT><a href="DomainManager.html">org.omg.CORBA.DomainManager</a></TT>) and methods for +Domain managers (<code><a href="DomainManager.html">org.omg.CORBA.DomainManager</a></code>) and methods for getting them are not implemented. <LI> -Service Information <TT><a href="ServiceInformation.html">org.omg.CORBA.ServiceInformation</a></TT> and ORB method <TT>public boolean get_service_information(short service_type, -ServiceInformationHolder -service_info)</TT> are not implemented. +Service Information <code><a href="ServiceInformation.html">org.omg.CORBA.ServiceInformation</a></code> +and ORB method +<code>public boolean get_service_information(short service_type, ServiceInformationHolder service_info)</code> +are not implemented. -<LI>ORB methods for supporting single-threading (<tt>perform_work</tt>, <tt>work_pending</tt>) are not implemented. +<LI>ORB methods for supporting single-threading +(<code>perform_work</code>, <code>work_pending</code>) are not implemented. <LI>IDL contexts. </UL> <HR> <H2> -Specific List of Unimplemented Features in Package <TT>org.omg.CORBA</TT></H2> +Specific List of Unimplemented Features in Package <code>org.omg.CORBA</code></H2> <H3> -Unimplemented Methods in package <TT>org.omg.CORBA</TT>:</H3> +Unimplemented Methods in package <code>org.omg.CORBA</code>:</H3> <UL> <LI> -<TT>ORB</TT> +<code>ORB</code> <UL> <LI> -<TT>public org.omg.CORBA.Policy create_policy(int type, org.omg.CORBA.Any -val)</TT> +<code>public org.omg.CORBA.Policy create_policy(int type, org.omg.CORBA.Any val)</code> <LI> -<TT>public void perform_work()</TT> +<code>public void perform_work()</code> <LI> -<TT>public boolean work_pending()</TT> +<code>public boolean work_pending()</code> <LI> -<TT>public org.omg.CORBA.Current get_current()</TT> +<code>public org.omg.CORBA.Current get_current()</code> <LI> -<TT>create_operation_list</TT> +<code>create_operation_list</code> <LI> -<TT>get_default_context</TT> +<code>get_default_context</code> <LI> -<TT>get_service_information</TT> +<code>get_service_information</code> <LI> -obsolete <TT>DynAnys</TT> (deprecated in favor of <tt>DynamicAny</tt> package) +obsolete <code>DynAnys</code> (deprecated in favor of <code>DynamicAny</code> package) </UL>
--- a/src/java.corba/share/classes/org/omg/CosNaming/NamingContextExtPackage/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CosNaming/NamingContextExtPackage/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -30,20 +30,20 @@ </head> <body bgcolor="white"> -<P>This package contains the following classes, which are used in -<tt>org.omg.CosNaming.NamingContextExt</tt>: +<P>This package contains the following classes, which are used in +<code>org.omg.CosNaming.NamingContextExt</code>: <UL> - <LI><tt>AddressHelper</tt> - <LI><tt>StringNameHelper</tt> - <LI><tt>URLStringHelper</tt> - <LI><tt>InvalidAddress</tt> + <LI><code>AddressHelper</code> + <LI><code>StringNameHelper</code> + <LI><code>URLStringHelper</code> + <LI><code>InvalidAddress</code> </UL> <H3>Package Specification</H3> -<P>For a precise list of supported sections of official specifications with which -the Java[tm] Platform, Standard Edition 6 ORB complies, see <A -HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA +<P>For a precise list of supported sections of official specifications with which +the Java[tm] Platform, Standard Edition 6 ORB complies, see <A +HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java[tm] SE 6</A>. @since 1.4
--- a/src/java.corba/share/classes/org/omg/CosNaming/NamingContextPackage/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CosNaming/NamingContextPackage/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -30,23 +30,23 @@ </head> <body bgcolor="white"> -<P>This package contains Exception classes for the <tt>org.omg.CosNaming</tt> +<P>This package contains Exception classes for the <code>org.omg.CosNaming</code> package. The list of exception classes are: <UL> - <LI><tt>AlreadyBound</tt> - <LI><tt>CannotProceed</tt> - <LI><tt>InvalidName</tt> - <LI><tt>NotEmpty</tt> - <LI><tt>NotFound</tt> - <LI><tt>NotFoundReason</tt> + <LI><code>AlreadyBound</code> + <LI><code>CannotProceed</code> + <LI><code>InvalidName</code> + <LI><code>NotEmpty</code> + <LI><code>NotFound</code> + <LI><code>NotFoundReason</code> </UL> <H3>Package Specification</H3> -<P>For a precise list of supported sections of official specifications with which -the Java[tm] Platform, Standard Edition 6 ORB complies, see <A -HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA +<P>For a precise list of supported sections of official specifications with which +the Java[tm] Platform, Standard Edition 6 ORB complies, see <A +HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java SE 6</A>. @since 1.4
--- a/src/java.corba/share/classes/org/omg/CosNaming/nameservice.idl Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CosNaming/nameservice.idl Sun Sep 13 23:31:47 2015 +0300 @@ -99,8 +99,8 @@ * The BindingIterator interface allows a client to iterate through * the bindings using the next_one or next_n operations. * - * The bindings iterator is obtained by using the <tt>list</tt> - * method on the <tt>NamingContext</tt>. + * The bindings iterator is obtained by using the <code>list</code> + * method on the <code>NamingContext</code>. * @see org.omg.CosNaming.NamingContext#list */ interface BindingIterator @@ -412,7 +412,7 @@ * contains a set of name bindings in which each name is unique and is * part of Interoperable Naming Service. * Different names can be bound to an object in the same or different - * contexts at the same time. Using <tt>NamingContextExt</tt>, you can use + * contexts at the same time. Using <code>NamingContextExt</code>, you can use * URL-based names to bind and resolve. * * See <a href="http://www.omg.org/technology/documents/formal/naming_service.htm">
--- a/src/java.corba/share/classes/org/omg/CosNaming/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/CosNaming/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -35,25 +35,25 @@ <P> - The package and all its classes and interfaces + The package and all its classes and interfaces were generated by running the tool <code>idlj</code> on the file <code>nameservice.idl</code>, which is a module written in OMG IDL. <H3>Package Specification</H3> -<P>For a precise list of supported sections of official specifications with which -the Java[tm] Platform, Standard Edition 6, ORB complies, see <A -HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA +<P>For a precise list of supported sections of official specifications with which +the Java[tm] Platform, Standard Edition 6, ORB complies, see <A +HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java[tm] SE 6</A>. <H2>Interfaces</H2> - The package <tt>org.omg.CosNaming</tt> contains two public interfaces - and several auxiliary classes. + The package <code>org.omg.CosNaming</code> contains two public interfaces + and several auxiliary classes. <P> The interfaces are: <UL> - <LI><TT>NamingContext</TT> - <LI><TT>BindingIterator</TT> + <LI><code>NamingContext</code> + <LI><code>BindingIterator</code> </UL> <P> These two interfaces provide the means to bind/unbind names and object @@ -68,7 +68,7 @@ the idlj compiler creates Java classes that can be thought of as auxiliary classes. Comments for the generated auxiliary classes - used by the interfaces <code>NamingContext</code> and + used by the interfaces <code>NamingContext</code> and <code>BindingIterator</code> are included here. <H3>Classes Used by <code>NamingContext</code> and @@ -78,7 +78,7 @@ generated for each of the classes listed here, are discussed below.) <UL> - <LI><code>public final class <B>NameComponent</B></code> -- + <LI><code>public final class <B>NameComponent</B></code> -- a building block for names. (Names are bound to object references in a naming context.) <P>A name is an array of one or more <code>NameComponent</code> objects. @@ -99,7 +99,7 @@ rather than a file extension or some other syntactic convention. Examples of the value of the <code>kind</code> field include the strings <code>"c_source"</code>, <code>"object_code"</code>, - <code>"executable"</code>, + <code>"executable"</code>, <code>"postscript"</code>, and <code>""</code>. It is not unusual for the <code>kind</code> field to be the empty string. </OL> @@ -110,7 +110,7 @@ This is similar to a path name, in which the last name is the file name, and all names before it are directory names. - <LI><code>public final class <B>Binding</B></code> -- + <LI><code>public final class <B>Binding</B></code> -- an object that associates a name with an object reference or a naming context. A <code>Binding</code> object has two fields: @@ -142,9 +142,9 @@ <code>Binding</code> or used as parameters or return values. These <code>BindingType</code> objects are: <UL> - <LI><code>public static final BindingType <B>nobject</B></code> -- + <LI><code>public static final BindingType <B>nobject</B></code> -- to indicate that the binding is with an object reference - <LI><code>public static final BindingType <B>ncontext</B></code> -- + <LI><code>public static final BindingType <B>ncontext</B></code> -- to indicate that the binding is with a naming context </UL> <P> @@ -159,7 +159,7 @@ If the method <code>from_int</code> is supplied with anything other than <code>_nobject</code> or <code>_ncontext</code>, it will throw - the exception <code>org.omg.CORBA.BAD_PARAM</code>. + the exception <code>org.omg.CORBA.BAD_PARAM</code>. <P>Usage is as follows: <PRE> BindingType btObject = from_int(_nobject); @@ -189,7 +189,7 @@ An instance of a holder class can be passed to a Java method as a parameter, and a value can be assigned to its <code>value</code> field. This allows - it to perform the function of an OUT or INOUT parameter. + it to perform the function of an OUT or INOUT parameter. <P>The following holder classes are generated for the package <code>org.omg.CosNaming</code>: <UL> @@ -202,17 +202,17 @@ <LI><code>NameHolder</code> </UL> <P> - Note that in the <code>org.omg.CORBA</code> package, + Note that in the <code>org.omg.CORBA</code> package, there is a holder class for each of the basic Java types: - <code>IntHolder</code>, <code>ShortHolder</code>, + <code>IntHolder</code>, <code>ShortHolder</code>, <code>StringHolder</code>, and so on. <P> Note also that there is a <code>NameHolder</code> class even though there is no <code>Name</code> class; similarly, there is a <code>BindingListHolder</code> class even though there is no <code>BindingList</code> class. This is true because in the OMG IDL - interface, <code>Name</code> and <code>BindingList</code> are - <code>typedef</code>s. There is no mapping from an IDL + interface, <code>Name</code> and <code>BindingList</code> are + <code>typedef</code>s. There is no mapping from an IDL <code>typedef</code> to a Java construct, but holder classes are generated if the <code>typedef</code> is for a sequence or an array. As mapped to the @@ -245,7 +245,7 @@ <H3>Helper Classes</H3> Helper classes, which are generated for all user-defined types in an OMG IDL interface, supply static methods needed to manipulate - those types. + those types. <P> There is only one method in a helper class that an application programmer uses: the @@ -282,7 +282,7 @@ Sun's implementation of the <code>CosNaming</code> package complies with the OMG <code>COSNaming</code> specification. In other words, the APIs in Sun's naming service are implemented according to the -guidelines for a naming service provided by OMG. Therefore, if a +guidelines for a naming service provided by OMG. Therefore, if a third-party vendor has implemented a naming service that is OMG compliant, it is possible to switch between Sun's implementation of <code>CosNaming</code> and the third-party vendor's implementation. @@ -292,18 +292,17 @@ <h3>Instructions for Using a Third Party's Naming Service</h3> Although we encourage using an ORB and ORB services that are both -from one vendor, it is possible to plug in a third party's +from one vendor, it is possible to plug in a third party's <code>COSNaming</code> implementation with Sun's RMI-IIOP ORB. Here are the steps to follow: <OL> <LI>Create a properties file for the Bootstrap server and give it - two entries. For example, you could call this properties file + two entries. For example, you could call this properties file <code>/tmp/services</code> and put the following in it: - <code>NameService, <Stringified IOR of the Root Naming -Context></code>. + <code>NameService, <Stringified IOR of the Root Naming Context></code>. <P> This associates <code>NameService</code> with the Root Naming - Context of the <code>CosNaming</code> implementation that you + Context of the <code>CosNaming</code> implementation that you want to use. <LI>Start the standalone Bootstrap server using the following command: <pre> @@ -318,7 +317,7 @@ specifying a port number is optional. </OL> <P> -Now when an application calls the method +Now when an application calls the method <code>org.omg.CORBA.ORB.resolve_initial_references</code>, CORBA processes will contact the Bootstrap Server to get the Root Naming Context. @@ -326,13 +325,13 @@ <h2>Package Specification</h2> <ul> - <li>Interoperable Naming Service (<a + <li>Interoperable Naming Service (<a href="http://www.omg.org/cgi-bin/doc?ptc/00-08-07">ptc/00-08-07</a>) </ul> <h2>Related Documentation</h2> -For an overview and examples of how to use the +For an overview and examples of how to use the <code>CosNaming</code> API, please see: <ul> <li><a href="../../../../technotes/guides/idl/tnameserv.html">
--- a/src/java.corba/share/classes/org/omg/Dynamic/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/Dynamic/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -31,7 +31,7 @@ </head> <body bgcolor="white"> -<P>This package contains the <tt>Dynamic</tt> module specified in the OMG Portable +<P>This package contains the <code>Dynamic</code> module specified in the OMG Portable Interceptor specification, <a href="http://www.omg.org/cgi-bin/doc?ptc/2000-08-06"> ptc/2000-08-06</a>, section 21.9. Please @@ -40,10 +40,10 @@ <H3>Package Specification</H3> - -<P>For a precise list of supported sections of official specifications with which -the Java[tm] Platform, Standard Edition 6 ORB complies, see <A -HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA + +<P>For a precise list of supported sections of official specifications with which +the Java[tm] Platform, Standard Edition 6 ORB complies, see <A +HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java[tm] SE 6</A>. @since 1.4
--- a/src/java.corba/share/classes/org/omg/DynamicAny/DynAnyFactoryPackage/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/DynamicAny/DynAnyFactoryPackage/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -33,9 +33,9 @@ <body bgcolor="white"> <P> -This package contains classes and exceptions from the <tt>DynAnyFactory</tt> +This package contains classes and exceptions from the <code>DynAnyFactory</code> interface of the -<tt>DynamicAny</tt> module +<code>DynamicAny</code> module specified in the OMG <em>The Common Object Request Broker: Architecture and Specification</em>, <a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07"> @@ -43,10 +43,10 @@ refer to that OMG specification for further details. <H3>Package Specification</H3> - -<P>For a precise list of supported sections of official specifications with which -the Java[tm] Platform, Standard Edition 6 ORB complies, see <A -HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA + +<P>For a precise list of supported sections of official specifications with which +the Java[tm] Platform, Standard Edition 6 ORB complies, see <A +HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java SE 6</A>. @since 1.4
--- a/src/java.corba/share/classes/org/omg/DynamicAny/DynAnyPackage/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/DynamicAny/DynAnyPackage/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -30,8 +30,8 @@ </head> <body bgcolor="white"> -<P>This package contains classes and exceptions from the <tt>DynAny</tt> - interface of the <tt>DynamicAny</tt> module +<P>This package contains classes and exceptions from the <code>DynAny</code> + interface of the <code>DynamicAny</code> module specified in the OMG <em>The Common Object Request Broker: Architecture and Specification</em>, <a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07"> @@ -42,9 +42,9 @@ <H3>Package Specification</H3> -<P>For a precise list of supported sections of official specifications with which -the Java[tm] Platform, Standard Edition 6 ORB complies, see <A -HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA +<P>For a precise list of supported sections of official specifications with which +the Java[tm] Platform, Standard Edition 6 ORB complies, see <A +HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java[tm] SE 6</A>. @since 1.4
--- a/src/java.corba/share/classes/org/omg/DynamicAny/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/DynamicAny/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -48,15 +48,15 @@ helpful for writing generic clients (bridges, browsers, debuggers, user interface tools). <P><code>Any</code> values can be dynamically interpreted (traversed) and constructed through -<tt>DynAny</tt> objects. A <tt>DynAny</tt> object is associated with a data -value which corresponds to a copy of the value inserted into an <tt>Any</tt>. A -<tt>DynAny</tt> object may be viewed as an ordered collection of component -<tt>DynAny</tt>s. For <tt>DynAny</tt>s representing a basic type, such as <code>long</code>, +<code>DynAny</code> objects. A <code>DynAny</code> object is associated with a data +value which corresponds to a copy of the value inserted into an <code>Any</code>. A +<code>DynAny</code> object may be viewed as an ordered collection of component +<code>DynAny</code>s. For <code>DynAny</code>s representing a basic type, such as <code>long</code>, or a type without components, such as an empty exception, the ordered collection of components is empty. -<P>Each <tt>DynAny</tt> object maintains the notion of a current position into its collection -of component <tt>DynAny</tt>s. The current position is identified by an index value that runs +<P>Each <code>DynAny</code> object maintains the notion of a current position into its collection +of component <code>DynAny</code>s. The current position is identified by an index value that runs from 0 to n-1, where <em>n</em> is the number of components. The special index value -1 indicates a current position that points nowhere. For values that cannot have a current position (such as an empty exception),
--- a/src/java.corba/share/classes/org/omg/IOP/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/IOP/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -30,14 +30,14 @@ </head> <body bgcolor="white"> -<P>This package contains the <TT>IOP</tt> module specified in the OMG document +<P>This package contains the <code>IOP</code> module specified in the OMG document <em>The Common Object Request Broker: Architecture and Specification</em>, <a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07"> formal/99-10-07</a>, section 13.6. Please refer to that OMG specification for further details. -<P>Please note that we do not provide all parts of the <tt>IOP</tt> module from +<P>Please note that we do not provide all parts of the <code>IOP</code> module from the specification. We only provide those parts that are referenced as return values or parameter types in public APIs, most notably, Portable Interceptors. @@ -47,10 +47,10 @@ <H3>Package Specification</H3> - -<P>For a precise list of supported sections of official specifications with which -the Java[tm] Platform, Standard Edition 6 ORB complies, see <A -HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA + +<P>For a precise list of supported sections of official specifications with which +the Java[tm] Platform, Standard Edition 6 ORB complies, see <A +HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java[tm] SE 6</A>. @since 1.4
--- a/src/java.corba/share/classes/org/omg/Messaging/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/Messaging/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -30,22 +30,22 @@ </head> <body bgcolor="white"> -<P>This package contains the <tt>Messaging</tt> module specified in the OMG CORBA +<P>This package contains the <code>Messaging</code> module specified in the OMG CORBA Messaging specification, <a href="http://www.omg.org/cgi-bin/doc?formal/99-10-07"> formal/99-10-07</a>. Please refer to that OMG specification for further details. -<P>Please note that we do not provide all parts of the <tt>Messaging</tt> module from +<P>Please note that we do not provide all parts of the <code>Messaging</code> module from the specification. We only provide those parts that are referenced as return values or parameter types in public APIs, most notably, Portable Interceptors. <H3>Package Specification</H3> - -<P>For a precise list of supported sections of official specifications with which -the Java[tm] Platform, Standard Edition 6 ORB complies, see <A -HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA + +<P>For a precise list of supported sections of official specifications with which +the Java[tm] Platform, Standard Edition 6 ORB complies, see <A +HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java[tm] SE 6</A>. @since 1.4
--- a/src/java.corba/share/classes/org/omg/PortableInterceptor/ORBInitInfoPackage/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/PortableInterceptor/ORBInitInfoPackage/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -30,19 +30,19 @@ </head> <body bgcolor="white"> -<P>This package contains the exceptions and typedefs from the <tt>ORBInitInfo</tt> -local interface of the <tt>PortableInterceptor</tt> module specified in the OMG +<P>This package contains the exceptions and typedefs from the <code>ORBInitInfo</code> +local interface of the <code>PortableInterceptor</code> module specified in the OMG Portable Interceptor specification, <a href="http://www.omg.org/cgi-bin/doc?ptc/2000-08-06"> ptc/2000-08-06</a>, section 21.7.2. Please refer to that OMG specification for further details. - + <H3>Package Specification</H3> - -<P>For a precise list of supported sections of official specifications with which -the Java[tm] Platform, Standard Edition 6 ORB complies, see <A -HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA + +<P>For a precise list of supported sections of official specifications with which +the Java[tm] Platform, Standard Edition 6 ORB complies, see <A +HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java SE 6</A>. @since 1.4
--- a/src/java.corba/share/classes/org/omg/PortableServer/POAPackage/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/PortableServer/POAPackage/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -45,25 +45,34 @@ -<P>Given an interface <tt>My</tt> defined in <tt>My.idl</tt>, the file <tt>MyPOA.java</tt> is generated by the <tt>idlj</tt> compiler. You must provide the implementation for <tt>My</tt> and it must inherit from <tt>MyPOA</tt>. +<P>Given an interface <code>My</code> defined in <code>My.idl</code>, the file <code>MyPOA.java</code> +is generated by the <code>idlj</code> compiler. You must provide +the implementation for <code>My</code> and it must inherit from <code>MyPOA</code>. -<P><TT>MyPOA.java</TT> is a stream-based skeleton that extends <tt>org.omg.PortableServer.Servant</tt> and implements the <tt>InvokeHandler</tt> interface and the operations interface associated with the IDL interface the skeleton implements. +<P><code>MyPOA.java</code> is a stream-based skeleton that extends +<code>org.omg.PortableServer.Servant</code> and implements the <code>InvokeHandler</code> +interface and the operations interface associated with the IDL interface the skeleton implements. -<P>The <TT>PortableServer</TT> module for the Portable Object Adapter (POA) defines the native <tt>Servant</tt> type. In the Java programming language, the <tt>Servant</tt> type is mapped to the Java <TT>org.omg.PortableServer.Servant</TT> class. It serves as the base class for all POA servant implementations and provides a number of methods that may -be invoked by the application programmer, as well as methods which are invoked by the POA itself and may be overridden by the user to control aspects of servant behavior. - +<P>The <code>PortableServer</code> module for the Portable Object Adapter (POA) +defines the native <code>Servant</code> type. In the Java programming language, +the <code>Servant</code> type is mapped to the Java <code>org.omg.PortableServer.Servant</code> class. +It serves as the base class for all POA servant implementations +and provides a number of methods that may be invoked by the application programmer, +as well as methods which are invoked by the POA itself +and may be overridden by the user to control aspects of servant behavior. -<P>All Mapping corresponds to the Chapter 11 of + +<P>All Mapping corresponds to the Chapter 11 of CORBA V2.3.1 specified by OMG document formal/99-10-07.pdf. - The exception to this is the <code>id</code> attribute, which is added in ptc/00-08-06, + The exception to this is the <code>id</code> attribute, which is added in ptc/00-08-06, section 11.3.8.26. <H3>Package Specification</H3> -<P>For a precise list of supported sections of official specifications with which -the Java[tm] Platform, Standard Edition 6, ORB complies, see <A -HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA +<P>For a precise list of supported sections of official specifications with which +the Java[tm] Platform, Standard Edition 6, ORB complies, see <A +HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java[tm] SE 6</A>. @since 1.4
--- a/src/java.corba/share/classes/org/omg/PortableServer/ServantLocatorPackage/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/PortableServer/ServantLocatorPackage/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -33,15 +33,15 @@ <body bgcolor="white"> Provides classes and interfaces for locating the servant. -<P>This package supplies a <TT>CookieHolder</TT> class for passing -the <TT>Cookie</TT> type as an <code>out</code> parameter. The <code>CookieHolder</code> class +<P>This package supplies a <code>CookieHolder</code> class for passing +the <code>Cookie</code> type as an <code>out</code> parameter. The <code>CookieHolder</code> class follows exactly the same pattern as the other holder classes for basic types. - + <H2>Package Specification</H2> - -<P>For a precise list of supported sections of official OMG specifications with which -the Java[tm] Platform, Standard Edition 6 complies, see <A -HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA + +<P>For a precise list of supported sections of official OMG specifications with which +the Java[tm] Platform, Standard Edition 6 complies, see <A +HREF="../../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java[tm] SE 6</A>. @since 1.4
--- a/src/java.corba/share/classes/org/omg/PortableServer/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/PortableServer/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -2,7 +2,7 @@ <html> <head> <!-- - + Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved. DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. @@ -34,46 +34,46 @@ Provides classes and interfaces for making the server side of your applications portable across multivendor ORBs. -<P>In Java, Portable Object Adaptor (POA)-based Dynamic Skeleton Interface (DSI) -servants inherit from the standard <TT>DynamicImplementation</TT> class, which -inherits from the <TT>Servant</TT> class. The native <TT>Servant</TT> type is -defined by the <TT>PortableServer</TT> module for the POA. In Java, the - <TT>Servant</TT> type is mapped to the Java - <TT>org.omg.PortableServer.Servant</TT> class. - It serves as the base class for all POA servant - implementations and provides a number of methods that may - be invoked by the application programmer, as well as methods - which are invoked by the POA itself and may be overridden by - the user to control aspects of servant behavior. +<P>In Java, Portable Object Adaptor (POA)-based Dynamic Skeleton Interface (DSI) +servants inherit from the standard <code>DynamicImplementation</code> class, which +inherits from the <code>Servant</code> class. The native <code>Servant</code> type is +defined by the <code>PortableServer</code> module for the POA. In Java, the + <code>Servant</code> type is mapped to the Java + <code>org.omg.PortableServer.Servant</code> class. + It serves as the base class for all POA servant + implementations and provides a number of methods that may + be invoked by the application programmer, as well as methods + which are invoked by the POA itself and may be overridden by + the user to control aspects of servant behavior. <H2>Package Specification</H2> -<P>For a precise list of supported sections of official OMG specifications with which -the Java[tm] Platform, Standard Edition 6 complies, see <A -HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA +<P>For a precise list of supported sections of official OMG specifications with which +the Java[tm] Platform, Standard Edition 6 complies, see <A +HREF="../CORBA/doc-files/compliance.html">Official Specifications for CORBA support in Java[tm] SE 6</A>. <H2>POA-related Interfaces</H2> -<P>The <TT>PortableServer</TT> module defines the following POA-related interfaces: +<P>The <code>PortableServer</code> module defines the following POA-related interfaces: <UL> - <LI><TT>POA</TT> - <LI><TT>POAManager</TT> - <LI><TT>ServantManager</TT> - <LI><TT>ServantActivator</TT> - <LI><TT>ServantLocator</TT> - <LI><TT>AdapterActivator</TT> - <LI><TT>ThreadPolicy</TT> - <LI><TT>LifespanPolicy</TT> - <LI><TT>IdUniquenessPolicy</TT> - <LI><TT>IdAssignmentPolicy</TT> - <LI><TT>ImplicitActivationPolicy</TT> - <LI><TT>ServantRetentionPolicy</TT> - <LI><TT>RequestProcessingPolicy</TT> - <LI><TT>Current</TT> + <LI><code>POA</code> + <LI><code>POAManager</code> + <LI><code>ServantManager</code> + <LI><code>ServantActivator</code> + <LI><code>ServantLocator</code> + <LI><code>AdapterActivator</code> + <LI><code>ThreadPolicy</code> + <LI><code>LifespanPolicy</code> + <LI><code>IdUniquenessPolicy</code> + <LI><code>IdAssignmentPolicy</code> + <LI><code>ImplicitActivationPolicy</code> + <LI><code>ServantRetentionPolicy</code> + <LI><code>RequestProcessingPolicy</code> + <LI><code>Current</code> </UL> -<P>In addition, the POA defines the <TT>Servant</TT> native type. +<P>In addition, the POA defines the <code>Servant</code> native type. <H3>Operations classes</H3> @@ -87,10 +87,10 @@ Classes ending in the suffix <code>PolicyValue</code> provide the values used for the <code>create_POA</code> call, which sets the policy for the POA. See -the <a href="#sampleserver">sample code</a> below for a demonstration. +the <a href="#sampleserver">sample code</a> below for a demonstration. <code>PolicyValue</code> files include the following: <UL> -<LI><code>IdAssignmentPolicyValue</code> +<LI><code>IdAssignmentPolicyValue</code> <LI><code>IdUniquenessPolicyValue</code> <LI><code>ImplicitActivationPolicyValue</code> <LI><code>LifespanPolicyValue</code> @@ -101,10 +101,10 @@ <H3>Helper Classes</H3> -<P>Helper classes, which are generated for all user-defined types in an OMG IDL +<P>Helper classes, which are generated for all user-defined types in an OMG IDL interface, supply static methods needed to manipulate those types. -There is only one method in a helper class that an application programmer uses: -the <code>narrow</code> method. Only Java interfaces mapped from IDL interfaces +There is only one method in a helper class that an application programmer uses: +the <code>narrow</code> method. Only Java interfaces mapped from IDL interfaces will have a helper class that includes a <code>narrow</code> method, so in the <code>PortableServer</code> package, only the following classes have a <code>narrow</code> method: <UL> @@ -119,7 +119,7 @@ <H3>Exceptions</H3> -<P>The <code>ForwardRequest</code> exception indicates to the ORB +<P>The <code>ForwardRequest</code> exception indicates to the ORB that it is responsible for delivering the current request and subsequent <code>ForwardRequest</code> requests to the object denoted in the <code>forward_reference</code> member of the exception. @@ -132,7 +132,7 @@ The interfaces of interest to application programmers are the following: <ul> <LI><code>AdapterActivator</code> - <P>Adapter activators are associated with POAs. + <P>Adapter activators are associated with POAs. An adapter activator supplies a POA with the ability to create child POAs on demand, as a side-effect of receiving a request that names the child POA (or one of its children), or when <code>find_POA</code> is called with an activate parameter value of <code>TRUE</code>. @@ -148,10 +148,10 @@ </ul> -<H2>Package <TT>org.omg.PortableServer.ServantLocatorPackage</TT></H2> +<H2>Package <code>org.omg.PortableServer.ServantLocatorPackage</code></H2> -<P>This package supplies a <TT>CookieHolder</TT> class for passing -the <TT>Cookie</TT> type as an <code>out</code> parameter. The <code>CookieHolder</code> class +<P>This package supplies a <code>CookieHolder</code> class for passing +the <code>Cookie</code> type as an <code>out</code> parameter. The <code>CookieHolder</code> class follows exactly the same pattern as the other holder classes for basic types. <H2>Related Documentation</H2>
--- a/src/java.corba/share/classes/org/omg/PortableServer/portable/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/PortableServer/portable/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -31,15 +31,15 @@ </head> <body bgcolor="white"> -Provides classes and interfaces for making the server side of your applications +Provides classes and interfaces for making the server side of your applications portable across multivendor ORBs. -<P>The <tt>portable</tt> package contains interfaces and classes - that are designed for and intended to be used by an ORB -implementor. It exposes the publicly defined APIs that +<P>The <code>portable</code> package contains interfaces and classes + that are designed for and intended to be used by an ORB +implementor. It exposes the publicly defined APIs that are used to connect stubs and skeletons to the ORB. - The <tt>Delegate</tt> interface provides the ORB-vendor-specific - implementation of <tt>PortableServer::Servant</TT>. + The <code>Delegate</code> interface provides the ORB-vendor-specific + implementation of <code>PortableServer::Servant</code>. This package conforms CORBA Specification V2.3.1, ptc/00-01-08. @since 1.4
--- a/src/java.corba/share/classes/org/omg/stub/java/rmi/package.html Fri Sep 11 10:26:28 2015 -0700 +++ b/src/java.corba/share/classes/org/omg/stub/java/rmi/package.html Sun Sep 13 23:31:47 2015 +0300 @@ -30,8 +30,8 @@ --> </head> <body bgcolor="white"> - Contains RMI-IIOP Stubs for the Remote types that occur in the - <tt>java.rmi</tt> package. + Contains RMI-IIOP Stubs for the Remote types that occur in the + <code>java.rmi</code> package. @since 1.3 <br>