8079075: some docs cleanup for CORBA - part 1
Summary: some fix for CORBA docs
Reviewed-by: rriggs
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/corba/AnyImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/corba/AnyImpl.java Tue May 05 15:17:13 2015 +0400
@@ -222,7 +222,7 @@
/**
* returns the type of the element contained in the Any.
*
- * @result the TypeCode for the element in the Any
+ * @return the TypeCode for the element in the Any
*/
public TypeCode type() {
return typeCode;
@@ -267,7 +267,7 @@
* checks for equality between Anys.
*
* @param otherAny the Any to be compared with.
- * @result true if the Anys are equal, false otherwise.
+ * @return true if the Anys are equal, false otherwise.
*/
public boolean equal(Any otherAny)
{
@@ -508,7 +508,7 @@
/**
* returns an output stream that an Any value can be marshaled into.
*
- * @result the OutputStream to marshal value of Any into
+ * @return the OutputStream to marshal value of Any into
*/
public org.omg.CORBA.portable.OutputStream create_output_stream()
{
@@ -525,7 +525,7 @@
/**
* returns an input stream that an Any value can be marshaled out of.
*
- * @result the InputStream to marshal value of Any out of.
+ * @return the InputStream to marshal value of Any out of.
*/
public org.omg.CORBA.portable.InputStream create_input_stream()
{
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/encoding/CDROutputObject.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/encoding/CDROutputObject.java Tue May 05 15:17:13 2015 +0400
@@ -166,7 +166,7 @@
* Write the contents of the CDROutputStream to the specified
* output stream. Has the side-effect of pushing any current
* Message onto the Message list.
- * @param s The output stream to write to.
+ * @param connection The output stream to write to.
*/
public void writeTo(CorbaConnection connection)
throws java.io.IOException
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/encoding/CodeSetConversion.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/encoding/CodeSetConversion.java Tue May 05 15:17:13 2015 +0400
@@ -54,8 +54,9 @@
* use NIO ByteBuffer and NIO CharBuffer, the interaction
* and interface between this class and the CDR streams
* should be looked at more closely for optimizations to
- * avoid unnecessary copying of data between char[] &
- * CharBuffer and byte[] & ByteBuffer, especially
+ * avoid unnecessary copying of data between
+ * {@code char[] & CharBuffer} and
+ * {@code byte[] & ByteBuffer}, especially
* DirectByteBuffers.
*
*/
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericIdentifiable.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericIdentifiable.java Tue May 05 15:17:13 2015 +0400
@@ -33,7 +33,6 @@
import com.sun.corba.se.spi.ior.Identifiable ;
/**
- * @author
* This is used for unknown components and profiles. A TAG_MULTICOMPONENT_PROFILE will be represented this way.
*/
public abstract class GenericIdentifiable implements Identifiable
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericTaggedComponent.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericTaggedComponent.java Tue May 05 15:17:13 2015 +0400
@@ -34,9 +34,6 @@
import com.sun.corba.se.spi.ior.TaggedComponent ;
-/**
- * @author
- */
public class GenericTaggedComponent extends GenericIdentifiable
implements TaggedComponent
{
@@ -52,8 +49,6 @@
/**
* @return org.omg.IOP.TaggedComponent
- * @exception
- * @author
*/
public org.omg.IOP.TaggedComponent getIOPComponent( ORB orb )
{
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericTaggedProfile.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericTaggedProfile.java Tue May 05 15:17:13 2015 +0400
@@ -39,9 +39,6 @@
import com.sun.corba.se.impl.encoding.EncapsOutputStream ;
-/**
- * @author
- */
public class GenericTaggedProfile extends GenericIdentifiable implements TaggedProfile
{
private ORB orb ;
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/IORTemplateImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/IORTemplateImpl.java Tue May 05 15:17:13 2015 +0400
@@ -47,7 +47,6 @@
/**
* This class is a container of TaggedProfileTemplates.
- * @author
*/
public class IORTemplateImpl extends IdentifiableContainerBase implements IORTemplate
{
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectAdapterIdNumber.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectAdapterIdNumber.java Tue May 05 15:17:13 2015 +0400
@@ -31,7 +31,7 @@
/** ObjectAdapterIdNumber is used to represent pre-JDK 1.4 POA adapter
* IDs. The POA ID was simply represented as a single integer, which was
* mapped to the actual POA instance. Here, we just represent these
- * internally as arrays of the form { "OldRootPOA", "<number>" },
+ * internally as arrays of the form {@code { "OldRootPOA", "<number>" }},
* and provide an extra method to get the number back.
*/
public class ObjectAdapterIdNumber extends ObjectAdapterIdArray {
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectIdImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectIdImpl.java Tue May 05 15:17:13 2015 +0400
@@ -29,9 +29,6 @@
import com.sun.corba.se.spi.ior.ObjectId ;
import org.omg.CORBA_2_3.portable.OutputStream ;
-/**
- * @author
- */
public final class ObjectIdImpl implements ObjectId
{
private byte[] id;
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectKeyTemplateBase.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectKeyTemplateBase.java Tue May 05 15:17:13 2015 +0400
@@ -47,9 +47,6 @@
import com.sun.corba.se.impl.logging.IORSystemException ;
-/**
- * @author
- */
public abstract class ObjectKeyTemplateBase implements ObjectKeyTemplate
{
// Fixed constants for Java IDL object key template forms
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/POAObjectKeyTemplate.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/POAObjectKeyTemplate.java Tue May 05 15:17:13 2015 +0400
@@ -42,9 +42,6 @@
import com.sun.corba.se.impl.ior.ObjectKeyFactoryImpl ;
-/**
- * @author
- */
public final class POAObjectKeyTemplate extends NewObjectKeyTemplateBase
{
/** This constructor reads the template ONLY from the stream.
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/StubIORImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/StubIORImpl.java Tue May 05 15:17:13 2015 +0400
@@ -245,7 +245,7 @@
/**
* Returns a string representation of this stub. Returns the same string
* for all stubs that represent the same remote object.
- * "SimpleIORImpl[<typeName>,[<profileID>]data, ...]"
+ * {@code "SimpleIORImpl[<typeName>,[<profileID>]data, ...]"}
* @return a string representation of this stub.
*/
public String toString()
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/TaggedProfileFactoryFinderImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/TaggedProfileFactoryFinderImpl.java Tue May 05 15:17:13 2015 +0400
@@ -33,9 +33,6 @@
import org.omg.CORBA_2_3.portable.InputStream ;
-/**
- * @author
- */
public class TaggedProfileFactoryFinderImpl extends
IdentifiableFactoryFinderBase
{
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/CodeSetsComponentImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/CodeSetsComponentImpl.java Tue May 05 15:17:13 2015 +0400
@@ -38,9 +38,6 @@
import com.sun.corba.se.impl.encoding.MarshalOutputStream ;
import com.sun.corba.se.impl.encoding.MarshalInputStream ;
-/**
- * @author
- */
public class CodeSetsComponentImpl extends TaggedComponentBase
implements CodeSetsComponent
{
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressBase.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressBase.java Tue May 05 15:17:13 2015 +0400
@@ -32,9 +32,6 @@
import com.sun.corba.se.spi.ior.iiop.IIOPAddress ;
-/**
- * @author
- */
abstract class IIOPAddressBase implements IIOPAddress
{
// Ports are marshalled as shorts on the wire. The IDL
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressClosureImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressClosureImpl.java Tue May 05 15:17:13 2015 +0400
@@ -32,9 +32,6 @@
import com.sun.corba.se.spi.orbutil.closure.Closure ;
-/**
- * @author
- */
public final class IIOPAddressClosureImpl extends IIOPAddressBase
{
private Closure host;
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressImpl.java Tue May 05 15:17:13 2015 +0400
@@ -36,9 +36,6 @@
import com.sun.corba.se.impl.logging.IORSystemException ;
-/**
- * @author
- */
public final class IIOPAddressImpl extends IIOPAddressBase
{
private ORB orb ;
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPProfileImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPProfileImpl.java Tue May 05 15:17:13 2015 +0400
@@ -76,9 +76,6 @@
import com.sun.corba.se.impl.logging.IORSystemException;
-/**
- * @author
- */
public class IIOPProfileImpl extends IdentifiableBase implements IIOPProfile
{
private ORB orb ;
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPProfileTemplateImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPProfileTemplateImpl.java Tue May 05 15:17:13 2015 +0400
@@ -55,7 +55,6 @@
import com.sun.corba.se.spi.orb.ORB ;
/**
- * @author
* If getMinorVersion==0, this does not contain any tagged components
*/
public class IIOPProfileTemplateImpl extends TaggedProfileTemplateBase
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/JavaCodebaseComponentImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/JavaCodebaseComponentImpl.java Tue May 05 15:17:13 2015 +0400
@@ -33,9 +33,6 @@
import com.sun.corba.se.spi.ior.iiop.JavaCodebaseComponent ;
-/**
- * @author
- */
public class JavaCodebaseComponentImpl extends TaggedComponentBase
implements JavaCodebaseComponent
{
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/BindingIteratorImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/BindingIteratorImpl.java Tue May 05 15:17:13 2015 +0400
@@ -92,7 +92,7 @@
* Return the next n bindings. It also returns true or false, indicating
* whether there were more bindings.
* @param how_many The number of requested bindings in the BindingList.
- * @param bl The BindingList as an out parameter.
+ * @param blh The BindingList as an out parameter.
* @return true if there were more bindings.
* @exception org.omg.CORBA.SystemException One of a fixed set of CORBA
* system exceptions.
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/NamingUtils.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/NamingUtils.java Tue May 05 15:17:13 2015 +0400
@@ -90,7 +90,7 @@
/**
* Create a error print stream to the supplied file.
- * @param logFile the file to which error messages will go.
+ * @param errFile the file to which error messages will go.
* @exception IOException thrown if the file cannot be opened for output.
*/
public static void makeErrStream(File errFile)
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/CorbanameURL.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/CorbanameURL.java Tue May 05 15:17:13 2015 +0400
@@ -33,7 +33,7 @@
* will be stored in this object. This object is capable of storing CorbaLoc
* profiles as defined in the CorbaName grammer.
*
- * @Author Hemanth
+ * @author Hemanth
*/
public class CorbanameURL extends INSURLBase
{
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/IIOPEndpointInfo.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/IIOPEndpointInfo.java Tue May 05 15:17:13 2015 +0400
@@ -32,7 +32,7 @@
* host information used in creating the Service Object reference
* from the -ORBInitDef and -ORBDefaultInitDef definitions.
*
- * @Author Hemanth
+ * @author Hemanth
*/
public class IIOPEndpointInfo
{
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/INSURL.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/INSURL.java Tue May 05 15:17:13 2015 +0400
@@ -29,7 +29,7 @@
* INS URL is a generic interface for two different types of URL's specified
* in INS spec.
*
- * @Author Hemanth
+ * @author Hemanth
*/
public interface INSURL {
public boolean getRIRFlag( );
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/INSURLHandler.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/INSURLHandler.java Tue May 05 15:17:13 2015 +0400
@@ -30,7 +30,7 @@
/**
* This class is the entry point to parse different types of INS URL's.
*
- * @Author Hemanth
+ * @author Hemanth
*/
public class INSURLHandler {
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/Utility.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/Utility.java Tue May 05 15:17:13 2015 +0400
@@ -36,7 +36,7 @@
/**
* Utility methods for Naming.
*
- * @Author Hemanth
+ * @author Hemanth
*/
class Utility {
private static NamingSystemException wrapper =
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/pcosnaming/NameService.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/pcosnaming/NameService.java Tue May 05 15:17:13 2015 +0400
@@ -186,7 +186,7 @@
/**
* getObjectReferenceFromKey returns the Object reference from the objectkey using POA.create_reference_with_id method
* @param Object Key as String
- * @returns reference an CORBA.Object.
+ * @return a CORBA.Object reference.
*/
org.omg.CORBA.Object getObjectReferenceFromKey( String key )
{
@@ -205,7 +205,7 @@
/**
* getObjectKey gets the Object Key from the reference using POA.reference_to_id method
* @param reference an CORBA.Object.
- * @returns Object Key as String
+ * @return Object Key as String
*/
String getObjectKey( org.omg.CORBA.Object reference )
{
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/pcosnaming/NamingContextImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/naming/pcosnaming/NamingContextImpl.java Tue May 05 15:17:13 2015 +0400
@@ -1140,10 +1140,9 @@
/**
* This operation creates a stringified name from the array of Name
* components.
- * @param n Name of the object <p>
+ * @param n Name of the object
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
- * Indicates the name does not identify a binding.<p>
- *
+ * Indicates the name does not identify a binding.
*/
public String to_string(org.omg.CosNaming.NameComponent[] n)
throws org.omg.CosNaming.NamingContextPackage.InvalidName
@@ -1167,10 +1166,9 @@
/**
* This operation converts a Stringified Name into an equivalent array
* of Name Components.
- * @param sn Stringified Name of the object <p>
+ * @param sn Stringified Name of the object
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
- * Indicates the name does not identify a binding.<p>
- *
+ * Indicates the name does not identify a binding.
*/
public org.omg.CosNaming.NameComponent[] to_name(String sn)
throws org.omg.CosNaming.NamingContextPackage.InvalidName
@@ -1204,14 +1202,13 @@
* This operation creates a URL based "iiopname://" format name
* from the Stringified Name of the object.
* @param addr internet based address of the host machine where
- * Name Service is running <p>
- * @param sn Stringified Name of the object <p>
+ * Name Service is running
+ * @param sn Stringified Name of the object
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
- * Indicates the name does not identify a binding.<p>
+ * Indicates the name does not identify a binding.
* @exception org.omg.CosNaming.NamingContextPackage.InvalidAddress
* Indicates the internet based address of the host machine is
- * incorrect <p>
- *
+ * incorrect
*/
public String to_url(String addr, String sn)
@@ -1247,14 +1244,13 @@
/**
* This operation resolves the Stringified name into the object
* reference.
- * @param sn Stringified Name of the object <p>
+ * @param sn Stringified Name of the object
* @exception org.omg.CosNaming.NamingContextPackage.NotFound
- * Indicates there is no object reference for the given name. <p>
+ * Indicates there is no object reference for the given name.
* @exception org.omg.CosNaming.NamingContextPackage.CannotProceed
- * Indicates that the given compound name is incorrect <p>
+ * Indicates that the given compound name is incorrect
* @exception org.omg.CosNaming.NamingContextExtPackage.InvalidName
- * Indicates the name does not identify a binding.<p>
- *
+ * Indicates the name does not identify a binding.
*/
public org.omg.CORBA.Object resolve_str(String sn)
throws org.omg.CosNaming.NamingContextPackage.NotFound,
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/orb/ORBImpl.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/orb/ORBImpl.java Tue May 05 15:17:13 2015 +0400
@@ -585,7 +585,7 @@
* Create an NVList
*
* @param count size of list to create
- * @result NVList created
+ * @return NVList created
*
* @see NVList
*/
@@ -599,7 +599,7 @@
* Create an NVList corresponding to an OperationDef
*
* @param oper operation def to use to create list
- * @result NVList created
+ * @return NVList created
*
* @see NVList
*/
@@ -612,7 +612,7 @@
/**
* Create a NamedValue
*
- * @result NamedValue created
+ * @return NamedValue created
*/
public synchronized NamedValue create_named_value(String s, Any any, int flags)
{
@@ -623,7 +623,7 @@
/**
* Create an ExceptionList
*
- * @result ExceptionList created
+ * @return ExceptionList created
*/
public synchronized org.omg.CORBA.ExceptionList create_exception_list()
{
@@ -634,7 +634,7 @@
/**
* Create a ContextList
*
- * @result ContextList created
+ * @return ContextList created
*/
public synchronized org.omg.CORBA.ContextList create_context_list()
{
@@ -645,7 +645,7 @@
/**
* Get the default Context object
*
- * @result the default Context object
+ * @return the default Context object
*/
public synchronized org.omg.CORBA.Context get_default_context()
{
@@ -656,7 +656,7 @@
/**
* Create an Environment
*
- * @result Environment created
+ * @return Environment created
*/
public synchronized org.omg.CORBA.Environment create_environment()
{
@@ -719,7 +719,7 @@
/**
* Get the next request that has gotten a response.
*
- * @result the next request ready with a response.
+ * @return the next request ready with a response.
*/
public org.omg.CORBA.Request get_next_response()
throws org.omg.CORBA.WrongTransaction
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/GetPropertyAction.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/GetPropertyAction.java Tue May 05 15:17:13 2015 +0400
@@ -35,7 +35,7 @@
* <code>AccessController.doPrivileged</code>.
*
* <p>The following code retrieves the value of the system
- * property named <code>"prop"</code> as a privileged action: <p>
+ * property named <code>"prop"</code> as a privileged action:
*
* <pre>
* String s = (String) java.security.AccessController.doPrivileged(
@@ -67,7 +67,7 @@
* value of that property.
*
* @param theProp the name of the system property.
- * @param defaulVal the default value.
+ * @param defaultVal the default value.
*/
public GetPropertyAction(String theProp, String defaultVal) {
this.theProp = theProp;
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/concurrent/Mutex.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/concurrent/Mutex.java Tue May 05 15:17:13 2015 +0400
@@ -126,7 +126,6 @@
* // ... other similar traversal and update methods ...
* }
* </pre>
- * <p>
* @see Semaphore
* <p>[<a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
**/
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/concurrent/Sync.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/concurrent/Sync.java Tue May 05 15:17:13 2015 +0400
@@ -276,10 +276,9 @@
* For example, you can use an ObservableSync
* (perhaps as part of a LayeredSync) in order to obtain callbacks
* before and after each method invocation for a given class.
- * <p>
-
+ *
* <p>[<a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
-**/
+ **/
public interface Sync {
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/pept/transport/Acceptor.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/pept/transport/Acceptor.java Tue May 05 15:17:13 2015 +0400
@@ -59,7 +59,7 @@
/**
* Used to determine if an <code>Acceptor</code> has been initialized.
*
- * @return <code>true</code. if the <code>Acceptor</code> has been
+ * @return <code>true</code> if the <code>Acceptor</code> has been
* initialized.
*/
public boolean initialized();
@@ -74,7 +74,7 @@
/**
* Set the
- * {@link com.sun.corba.se.pept.transport.Inbound.ConnectionCache InboundConnectionCache}
+ * {@link com.sun.corba.se.pept.transport.InboundConnectionCache InboundConnectionCache}
* to be used by this <code>Acceptor</code>.
*
* PEPt uses separate caches for each type of <code>Acceptor</code>
@@ -88,7 +88,7 @@
/**
* Get the
- * {@link com.sun.corba.se.pept.transport.Inbound.ConnectionCache InboundConnectionCache}
+ * {@link com.sun.corba.se.pept.transport.InboundConnectionCache InboundConnectionCache}
* used by this <code>Acceptor</code>
*
* PEPt uses separate caches for each type of <code>Acceptor</code>
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/extension/ServantCachingPolicy.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/extension/ServantCachingPolicy.java Tue May 05 15:17:13 2015 +0400
@@ -44,7 +44,7 @@
* <ol>
* <li>POA current semantics
* <li>Proper handling of POA destroy.
-* <ol>
+* </ol>
* POA current semantics requires maintaining a ThreadLocal stack of
* invocation information that is always available for POACurrent operations.
* Maintaining this stack is expensive on the timescale of optimized co-located
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/interceptor/RequestInfoExt.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/interceptor/RequestInfoExt.java Tue May 05 15:17:13 2015 +0400
@@ -30,8 +30,7 @@
/**
* This interface is implemented by our implementation of
* PortableInterceptor.ClientRequestInfo and
- * PortableInterceptor.ServerRequestInfo. <p>
- *
+ * PortableInterceptor.ServerRequestInfo.
*/
public interface RequestInfoExt
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/LongMonitoredAttributeBase.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/LongMonitoredAttributeBase.java Tue May 05 15:17:13 2015 +0400
@@ -27,13 +27,9 @@
import java.util.*;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* A Cleaner Abstraction to provide a Monitored Attribute of type 'Long'
- * </p>
*/
public abstract class LongMonitoredAttributeBase extends MonitoredAttributeBase {
@@ -42,20 +38,14 @@
/**
- * <p>
* Constructs LongMonitoredAttribute, by creating the
* MonitoredAttributeInfo with 'Long' as the class type.
* Users are expected to extend this class and provide the implementation
* for getValue() and if needed clearState() as well.
- * </p>
- * <p>
*
- * @param name of tthe MonitoredAttribute
- * </p>
- * <p>
+ * @param name of the MonitoredAttribute
* @param description of the Attribute, Please provid a well thought out
* description, so that the admin can make sense of the attribute supplied.
- * </p>
*/
public LongMonitoredAttributeBase(String name, String description) {
super( name );
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttribute.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttribute.java Tue May 05 15:17:13 2015 +0400
@@ -28,15 +28,11 @@
import java.util.*;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* Monitored Attribute is the interface to represent a Monitorable
* Attribute. Using this interface, one can get the value of the attribute
* and set the value if it is a writeable attribute.
- * </p>
*/
public interface MonitoredAttribute {
@@ -44,34 +40,25 @@
// operations
/**
- * <p>
* Gets the Monitored Attribute Info for the attribute.
- * </p>
- * <p>
*
* @param monitoredAttributeInfo for this Monitored Attribute.
- * </p>
*/
public MonitoredAttributeInfo getAttributeInfo();
/**
- * <p>
* Sets the value for the Monitored Attribute if isWritable() is false, the
* method will throw ILLEGAL Operation exception.
*
* Also, the type of 'value' should be same as specified in the
* MonitoredAttributeInfo for a particular instance.
- * </p>
- * <p>
*
* @param value should be any one of the Basic Java Type Objects which are
* Long, Double, Float, String, Integer, Short, Character, Byte.
- * </p>
*/
public void setValue(Object value);
/**
- * <p>
* Gets the value of the Monitored Attribute. The value can be obtained
* from different parts of the module. User may choose to delegate the call
* to getValue() to other variables.
@@ -79,34 +66,21 @@
* NOTE: It is important to make sure that the type of Object returned in
* getvalue is same as the one specified in MonitoredAttributeInfo for this
* attribute.
- * </p>
- * <p>
- *
- * </p>
- * <p>
*
* @param value is the current value for this MonitoredAttribute
- * </p>
*/
public Object getValue();
/**
- * <p>
* Gets the name of the Monitored Attribute.
- * </p>
- * <p>
*
- * @param name of this Attribute
- * </p>
+ * @return name of this Attribute
*/
public String getName();
/**
- * <p>
* If this attribute needs to be cleared, the user needs to implement this
* method to reset the state to initial state. If the Monitored Attribute
* doesn't change like for example (ConnectionManager High Water Mark),
* then clearState() is a No Op.
- * </p>
- *
*/
public void clearState();
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeBase.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeBase.java Tue May 05 15:17:13 2015 +0400
@@ -27,16 +27,11 @@
import java.util.*;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* A Convenient class provided to help users extend and implement only
* getValue(), if there is no need to clear the state and the attribute is not
* writable.
- *
- * </p>
*/
public abstract class MonitoredAttributeBase implements MonitoredAttribute {
String name;
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeInfo.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeInfo.java Tue May 05 15:17:13 2015 +0400
@@ -27,14 +27,10 @@
import java.util.*;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* Monitored AttributeInfo contains the meta information of the Monitored
* Attribute.
- * </p>
*/
public interface MonitoredAttributeInfo {
@@ -42,45 +38,38 @@
// operations
/**
- * <p>
* If the Attribute is writable from ASAdmin then isWritable() will return
* true.
- * </p>
- * <p>
*
* @return a boolean with true or false
- * </p>
*/
public boolean isWritable();
/**
- * <p>
* isStatistic() is true if the attribute is presented as a Statistic.
- * </p>
- * <p>
*
* @return a boolean with true or false
- * </p>
*/
public boolean isStatistic();
/**
- * <p>
- * Class Type: We will allow only basic class types: 1)Boolean 2)Integer
- * 3)Byte 4)Long 5)Float 6)Double 7)String 8)Character
- * </p>
- * <p>
+ * Class Type: We will allow only basic class types:
+ * <ol>
+ * <li>Boolean</li>
+ * <li>Integer</li>
+ * <li>Byte</li>
+ * <li>Long</li>
+ * <li>Float</li>
+ * <li>Double</li>
+ * <li>String</li>
+ * <li>Character</li>
+ * </ol>
*
* @return a Class Type
- * </p>
*/
public Class type();
/**
- * <p>
* Get's the description for the Monitored Attribute.
- * </p>
- * <p>
*
* @return a String with description
- * </p>
*/
public String getDescription();
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeInfoFactory.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeInfoFactory.java Tue May 05 15:17:13 2015 +0400
@@ -25,17 +25,12 @@
package com.sun.corba.se.spi.monitoring;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* MonitoredAttributeInfoFactory used mostly by internal classes. If the
* User needs to define some special MonitoredAttributes like a Character
* type Monitored Attribute, they can use this factory to build the meta
* information.
- *
- * </p>
*/
public interface MonitoredAttributeInfoFactory {
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredObject.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredObject.java Tue May 05 15:17:13 2015 +0400
@@ -30,161 +30,101 @@
import java.util.Collection;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* Monitored Object provides an Hierarchichal view of the ORB Monitoring
* System. It can contain multiple children and a single parent. Each
* Monitored Object may also contain Multiple Monitored Attributes.
- * </p>
*/
public interface MonitoredObject {
///////////////////////////////////////
// operations
/**
- * <p>
* Gets the name of this MonitoredObject
- * </p><p>
*
* @return a String with name of this Monitored Object
- * </p>
*/
public String getName();
/**
- * <p>
* Gets the description of MonitoredObject
- * </p><p>
*
* @return a String with Monitored Object Description.
- * </p>
*/
public String getDescription();
/**
- * <p>
* This method will add a child Monitored Object to this Monitored Object.
- * </p>
- * <p>
- * </p>
*/
public void addChild( MonitoredObject m );
/**
- * <p>
* This method will remove child Monitored Object identified by the given name
- * </p>
- * <p>
+ *
* @param name of the ChildMonitored Object
- * </p>
*/
public void removeChild( String name );
/**
- * <p>
* Gets the child MonitoredObject associated with this MonitoredObject
* instance using name as the key. The name should be fully qualified name
* like orb.connectionmanager
- * </p>
- * <p>
*
* @return a MonitoredObject identified by the given name
- * </p>
- * <p>
* @param name of the ChildMonitored Object
- * </p>
*/
public MonitoredObject getChild(String name);
/**
- * <p>
* Gets all the Children registered under this instance of Monitored
* Object.
- * </p>
- * <p>
*
* @return Collection of immediate Children associated with this MonitoredObject.
- * </p>
*/
public Collection getChildren();
/**
- * <p>
* Sets the parent for this Monitored Object.
- * </p>
- * <p>
- * </p>
*/
public void setParent( MonitoredObject m );
/**
- * <p>
* There will be only one parent for an instance of MontoredObject, this
* call gets parent and returns null if the Monitored Object is the root.
- * </p>
- * <p>
*
* @return a MonitoredObject which is a Parent of this Monitored Object instance
- * </p>
*/
public MonitoredObject getParent();
/**
- * <p>
* Adds the attribute with the given name.
- * </p>
- * <p>
*
- * </p>
- * <p>
* @param value is the MonitoredAttribute which will be set as one of the
* attribute of this MonitoredObject.
- * </p>
*/
public void addAttribute(MonitoredAttribute value);
/**
- * <p>
* Removes the attribute with the given name.
- * </p>
- * <p>
*
- * </p>
- * <p>
* @param name is the MonitoredAttribute name
- * </p>
*/
public void removeAttribute(String name);
/**
- * <p>
* Gets the Monitored Object registered by the given name
- * </p>
*
- * <p>
* @return a MonitoredAttribute identified by the given name
- * </p>
- * <p>
* @param name of the attribute
- * </p>
*/
public MonitoredAttribute getAttribute(String name);
/**
- * <p>
* Gets all the Monitored Attributes for this Monitored Objects. It doesn't
* include the Child Monitored Object, that needs to be traversed using
* getChild() or getChildren() call.
- * </p>
- * <p>
*
* @return Collection of all the Attributes for this MonitoredObject
- * </p>
*/
public Collection getAttributes();
/**
- * <p>
* Clears the state of all the Monitored Attributes associated with the
* Monitored Object. It will also clear the state on all it's child
* Monitored Object. The call to clearState will be initiated from
* CORBAMBean.startMonitoring() call.
- * </p>
- *
*/
public void clearState();
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringFactories.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringFactories.java Tue May 05 15:17:13 2015 +0400
@@ -29,17 +29,13 @@
import com.sun.corba.se.impl.monitoring.MonitoringManagerFactoryImpl;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* This is used for getting the default factories for
* MonitoredObject, MonitoredAttributeInfo and MonitoringManager. We do not
* expect users to use the MonitoredAttributeInfo factory most of the time
* because the Info is automatically built by StringMonitoredAttributeBase
* and LongMonitoredAttributeBase.
- * </p>
*/
public class MonitoringFactories {
///////////////////////////////////////
@@ -57,20 +53,15 @@
// operations
/**
- * <p>
* Gets the MonitoredObjectFactory
- * </p>
- * <p>
*
* @return a MonitoredObjectFactory
- * </p>
*/
public static MonitoredObjectFactory getMonitoredObjectFactory( ) {
return monitoredObjectFactory;
}
/**
- * <p>
* Gets the MonitoredAttributeInfoFactory. The user is not expected to use this
* Factory, since the MonitoredAttributeInfo is internally created by
* StringMonitoredAttributeBase, LongMonitoredAttributeBase and
@@ -79,11 +70,8 @@
* build a DoubleMonitoredAttributeBase like LongMonitoredAttributeBase
* and build a MonitoredAttributeInfo required by MonitoredAttributeBase
* internally by using this Factory.
- * </p>
- * <p>
*
* @return a MonitoredAttributeInfoFactory
- * </p>
*/
public static MonitoredAttributeInfoFactory
getMonitoredAttributeInfoFactory( )
@@ -92,18 +80,14 @@
}
/**
- * <p>
* Gets the MonitoredManagerFactory. The user is not expected to use this
* Factory, since the ORB will be automatically initialized with the
* MonitoringManager.
*
* User can get hold of MonitoringManager associated with ORB by calling
* orb.getMonitoringManager( )
- * </p>
- * <p>
*
* @return a MonitoredManagerFactory
- * </p>
*/
public static MonitoringManagerFactory getMonitoringManagerFactory( ) {
return monitoringManagerFactory;
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringManager.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringManager.java Tue May 05 15:17:13 2015 +0400
@@ -30,15 +30,11 @@
import java.util.*;
/**
- * <p>
* Monitoring Manager will have a 1 to 1 association with the ORB. This
* gives access to the top level Monitored Object, using which more
* Monitored Objects and Attributes can be added and traversed.
- * </p>
- * <p>
*
* @author Hemanth Puttaswamy
- * </p>
*/
public interface MonitoringManager extends Closeable {
@@ -46,23 +42,14 @@
// operations
/**
- * <p>
* Gets the Root Monitored Object which contains a Hierarchy Of Monitored
* Objects exposing various Monitorable Attributes of Various modules.
- * </p>
- * <p>
- *
- * @param MonitoredObject ...
- * </p>
*/
public MonitoredObject getRootMonitoredObject();
/**
- * <p>
* Initialize is called whenever there is a start monitoring call to CORBA
* MBean. This will result in triaging initialize to all the
* MonitoredObjects and it's Monitored Attributes.
- * </p>
- *
*/
public void clearState();
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringManagerFactory.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringManagerFactory.java Tue May 05 15:17:13 2015 +0400
@@ -25,14 +25,10 @@
package com.sun.corba.se.spi.monitoring;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* MonitoringObjectFactory is used internally by the ORB, It is not for
* general public use.
- * </p>
*/
public interface MonitoringManagerFactory {
/**
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StatisticMonitoredAttribute.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StatisticMonitoredAttribute.java Tue May 05 15:17:13 2015 +0400
@@ -27,15 +27,11 @@
import java.util.*;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* StatisticsMonitoredAttribute is provided as a convenience to collect the
* Statistics of any entity. The getValue() call will be delegated to the
* StatisticsAccumulator set by the user.
- * </p>
*/
public class StatisticMonitoredAttribute extends MonitoredAttributeBase {
@@ -55,32 +51,19 @@
/**
- * <p>
* Constructs the StaisticMonitoredAttribute, builds the required
* MonitoredAttributeInfo with Long as the class type and is always
* readonly attribute.
- * </p>
- * <p>
*
* @param name Of this attribute
- * </p>
- * <p>
- * @return a StatisticMonitoredAttribute
- * </p>
- * <p>
* @param desc should provide a good description on the kind of statistics
* collected, a good example is "Connection Response Time Stats will Provide the
* detailed stats based on the samples provided from every request completion
* time"
- * </p>
- * <p>
* @param s is the StatisticsAcumulator that user will use to accumulate the
* samples and this Attribute Object will get the computed statistics values
* from.
- * </p>
- * <p>
* @param mutex using which clearState() and getValue() calls need to be locked.
- * </p>
*/
public StatisticMonitoredAttribute(String name, String desc,
StatisticsAccumulator s, Object mutex)
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StatisticsAccumulator.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StatisticsAccumulator.java Tue May 05 15:17:13 2015 +0400
@@ -27,11 +27,8 @@
import java.util.*;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* StatisticsAccumulator accumulates the samples provided by the user and
* computes the value of minimum, maximum, sum and sample square sum. When
* the StatisticMonitoredAttribute calls getValue(), it will compute all
@@ -42,7 +39,6 @@
* Users can easily extend this class and provide the implementation of
* toString() method to format the stats as desired. By default all the stats
* are printed in a single line.
- * </p>
*/
public class StatisticsAccumulator {
@@ -72,19 +68,12 @@
/**
- * <p>
* User will use this method to just register a sample with the
* StatisticsAccumulator. This is the only method that User will use to
* expose the statistics, internally the StatisticMonitoredAttribute will
* collect the information when requested from the ASAdmin.
- * </p>
- * <p>
- *
- * </p>
- * <p>
*
* @param value a double value to make it more precise
- * </p>
*/
public void sample(double value) {
sampleCount++;
@@ -137,19 +126,11 @@
}
/**
- * <p>
* Construct the Statistics Accumulator by providing the unit as a String.
- * The examples of units are "Hours", "Minutes",
- * "Seconds", "MilliSeconds", "Micro Seconds"
- * etc.,
- * </p>
- * <p>
+ * The examples of units are "Hours", "Minutes",
+ * "Seconds", "MilliSeconds", "Micro Seconds" etc.
*
- * @return a StatisticsAccumulator with ...
- * </p>
- * <p>
* @param unit a String representing the units for the samples collected
- * </p>
*/
public StatisticsAccumulator( String unit ) {
this.unit = unit;
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StringMonitoredAttributeBase.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StringMonitoredAttributeBase.java Tue May 05 15:17:13 2015 +0400
@@ -27,14 +27,10 @@
import java.util.*;
/**
- * <p>
+ * @author Hemanth Puttaswamy
*
- * @author Hemanth Puttaswamy
- * </p>
- * <p>
* A Convenient Abstraction to present String type Monitored Attribute. One
* of the examples of StringMonitoredAttribute is the State information.
- * </p>
*/
public abstract class StringMonitoredAttributeBase
extends MonitoredAttributeBase
@@ -45,20 +41,11 @@
/**
- * <p>
* Constructs StringMonitoredAttribute with the MonitoredAttributeInfo
* built with the class type of String.
- * </p>
- * <p>
*
* @param name of this attribute
- * </p>
- * <p>
* @param description of this attribute
- * </p>
- * <p>
- * @return a StringMonitoredAttributeBase
- * </p>
*/
public StringMonitoredAttributeBase(String name, String description) {
super( name );
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/oa/ObjectAdapter.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/oa/ObjectAdapter.java Tue May 05 15:17:13 2015 +0400
@@ -111,7 +111,7 @@
* <li>oa.returnServant()</li>
* <li>oa.exit()</li>
* <li>pop info</li>
-* <ol>
+* </ol>
* </li>
* REVISIT: Is this the required order for exit/pop? Cna they be nested instead?
* Note that getInvocationServant and returnServant may throw exceptions. In such cases,
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/orbutil/fsm/Action.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/orbutil/fsm/Action.java Tue May 05 15:17:13 2015 +0400
@@ -46,8 +46,8 @@
* in the state machine, as the state could be corrupted.
* Any exception thrown by the Action for the transition
* will be propagated to doIt.
- * @param FSM fsm is the state machine causing this action.
- * @param Input in is the input that caused the transition.
+ * @param fsm the state machine causing this action.
+ * @param in the input that caused the transition.
*/
public void doIt( FSM fsm, Input in ) ;
}
--- a/corba/src/java.corba/share/classes/com/sun/corba/se/spi/servicecontext/ServiceContext.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/corba/se/spi/servicecontext/ServiceContext.java Tue May 05 15:17:13 2015 +0400
@@ -42,9 +42,8 @@
* the service context and provides any needed methods for manipulating
* the service context. Each subclass must provide the following
* members:
-* <p>
* <ul>
-* </li>a public static final int SERVICE_CONTEXT_ID that gives the OMG
+* <li>a public static final int SERVICE_CONTEXT_ID that gives the OMG
* (or other) defined id for the service context. This is needed for the
* registration mechanism defined in ServiceContexts. OMG defined
* service context ids are taken from section 13.6.7 of ptc/98-12-04.</li>
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/AttributeEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/AttributeEntry.java Tue May 05 15:17:13 2015 +0400
@@ -80,7 +80,7 @@
} // generate
/** Access the attribute generator.
- @returns an object which implements the AttributeGen interface.
+ @return an object which implements the AttributeGen interface.
@see AttributeGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ConstEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ConstEntry.java Tue May 05 15:17:13 2015 +0400
@@ -90,7 +90,7 @@
} // generate
/** Access the constant generator.
- @returns an object which implements the ConstGen interface.
+ @return an object which implements the ConstGen interface.
@see ConstGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/EnumEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/EnumEntry.java Tue May 05 15:17:13 2015 +0400
@@ -84,7 +84,7 @@
} // generate
/** Access the enumerator generator.
- @returns an object which implements the EnumGen interface.
+ @return an object which implements the EnumGen interface.
@see EnumGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ExceptionEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ExceptionEntry.java Tue May 05 15:17:13 2015 +0400
@@ -80,7 +80,7 @@
} // generate
/** Access the exception generator.
- @returns an object which implements the ExceptionGen interface.
+ @return an object which implements the ExceptionGen interface.
@see ExceptionGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ForwardEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ForwardEntry.java Tue May 05 15:17:13 2015 +0400
@@ -83,7 +83,7 @@
} // generate
/** Access the interface generator.
- @returns an object which implements the InterfaceGen interface.
+ @return an object which implements the InterfaceGen interface.
@see InterfaceGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ForwardValueEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ForwardValueEntry.java Tue May 05 15:17:13 2015 +0400
@@ -79,7 +79,7 @@
} // generate
/** Access the interface generator.
- @returns an object which implements the ForwardValueGen interface.
+ @return an object which implements the ForwardValueGen interface.
@see ValueGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/IncludeEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/IncludeEntry.java Tue May 05 15:17:13 2015 +0400
@@ -81,7 +81,7 @@
} // generate
/** Access the Include type generator.
- @returns an object which implements the IncludeGen interface.
+ @return an object which implements the IncludeGen interface.
@see IncludeGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/InterfaceEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/InterfaceEntry.java Tue May 05 15:17:13 2015 +0400
@@ -111,7 +111,7 @@
} // generate
/** Access the interface generator.
- @returns an object which implements the InterfaceGen interface.
+ @return an object which implements the InterfaceGen interface.
@see InterfaceGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/MethodEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/MethodEntry.java Tue May 05 15:17:13 2015 +0400
@@ -89,7 +89,7 @@
} // generate
/** Access the method generator.
- @returns an object which implements the MethodGen interface.
+ @return an object which implements the MethodGen interface.
@see MethodGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ModuleEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ModuleEntry.java Tue May 05 15:17:13 2015 +0400
@@ -84,7 +84,7 @@
} // generate
/** Access the module generator.
- @returns an object which implements the ModuleGen interface.
+ @return an object which implements the ModuleGen interface.
@see ModuleGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/NativeEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/NativeEntry.java Tue May 05 15:17:13 2015 +0400
@@ -73,7 +73,7 @@
} // generate
/** Access the constant generator.
- @returns an object which implements the ConstGen interface.
+ @return an object which implements the ConstGen interface.
@see ConstGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ParameterEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ParameterEntry.java Tue May 05 15:17:13 2015 +0400
@@ -88,7 +88,7 @@
} // generate
/** Access the parameter generator.
- @returns an object which implements the ParameterGen interface.
+ @return an object which implements the ParameterGen interface.
@see ParameterGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/PragmaEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/PragmaEntry.java Tue May 05 15:17:13 2015 +0400
@@ -80,7 +80,7 @@
} // generate
/** Access the Include type generator.
- @returns an object which implements the IncludeGen interface.
+ @return an object which implements the IncludeGen interface.
@see IncludeGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/PrimitiveEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/PrimitiveEntry.java Tue May 05 15:17:13 2015 +0400
@@ -81,7 +81,7 @@
} // generate
/** Access the primitive type generator.
- @returns an object which implements the PrimitiveGen interface.
+ @return an object which implements the PrimitiveGen interface.
@see PrimitiveGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/RepositoryID.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/RepositoryID.java Tue May 05 15:17:13 2015 +0400
@@ -68,8 +68,8 @@
/**
* Determine is a supplied string meets the minimal format requirement
* for a Repository ID.
- * @return true iff supplied string has form '<format>:<string>', where
- * <format> is any non-empty string not containing ':'.
+ * @return true if supplied string has form {@code '<format>:<string>'}, where
+ * {@code <format>} is any non-empty string not containing ':'.
**/
public static boolean hasValidForm (String string)
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SequenceEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SequenceEntry.java Tue May 05 15:17:13 2015 +0400
@@ -101,7 +101,7 @@
} // generate
/** Access the sequence generator.
- @returns an object which implements the SequenceGen interface.
+ @return an object which implements the SequenceGen interface.
@see SequenceGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/StringEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/StringEntry.java Tue May 05 15:17:13 2015 +0400
@@ -91,7 +91,7 @@
} // generate
/** Access the primitive type generator.
- @returns an object which implements the PrimitiveGen interface.
+ @return an object which implements the PrimitiveGen interface.
@see PrimitiveGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/StructEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/StructEntry.java Tue May 05 15:17:13 2015 +0400
@@ -90,7 +90,7 @@
} // generate
/** Access the struct generator.
- @returns an object which implements the StructGen interface.
+ @return an object which implements the StructGen interface.
@see StructGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SymtabEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SymtabEntry.java Tue May 05 15:17:13 2015 +0400
@@ -127,7 +127,7 @@
/** Get the name of this entry's module. If there are modules within
modules, each module name is separated by '/'.
- @returns this entry's module name. */
+ @return this entry's module name. */
public String module ()
{
return _module;
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SymtabFactory.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SymtabFactory.java Tue May 05 15:17:13 2015 +0400
@@ -97,7 +97,7 @@
char, octet, short, long, etc. The reason it is not limited to
these is that, as an extender, you may wish to override these names.
For instance, when generating Java code, octet translates to byte,
- so there is an entry in Compile.overrideNames: <"octet", "byte">
+ so there is an entry in Compile.overrideNames: {@code <"octet", "byte">}
and a PrimitiveEntry in the symbol table for "byte". */
PrimitiveEntry primitiveEntry (String name);
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/Token.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/Token.java Tue May 05 15:17:13 2015 +0400
@@ -332,7 +332,7 @@
* @param boolean[] collidesWithKeyword is an array containing one value: a flag
* representing whether this string is an identifier that collides with a keyword.
* This is set by this method.
- * @returns Token The resulting Token corresponding to string.
+ * @return Token The resulting Token corresponding to string.
*/
public static Token makeKeywordToken(
String string, float corbaLevel, boolean escapedOK, boolean[] collision )
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/TypedefEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/TypedefEntry.java Tue May 05 15:17:13 2015 +0400
@@ -110,7 +110,7 @@
}
/** Access the typedef generator.
- @returns an object which implements the TypedefGen interface.
+ @return an object which implements the TypedefGen interface.
@see TypedefGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/UnionEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/UnionEntry.java Tue May 05 15:17:13 2015 +0400
@@ -93,7 +93,7 @@
} // generate
/** Access the union generator.
- @returns an object which implements the UnionGen interface.
+ @return an object which implements the UnionGen interface.
@see UnionGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ValueBoxEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ValueBoxEntry.java Tue May 05 15:17:13 2015 +0400
@@ -77,7 +77,7 @@
} // generate
/** Access the value generator.
- @returns an object which implements the ValueGen interface.
+ @return an object which implements the ValueGen interface.
@see ValueGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ValueEntry.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ValueEntry.java Tue May 05 15:17:13 2015 +0400
@@ -86,7 +86,7 @@
} // generate
/** Access the value generator.
- @returns an object which implements the ValueGen interface.
+ @return an object which implements the ValueGen interface.
@see ValueGen */
public Generator generator ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/constExpr/Terminal.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/constExpr/Terminal.java Tue May 05 15:17:13 2015 +0400
@@ -43,11 +43,11 @@
/**
* This class contains values. Objects of this class are the terminal
* nodes of an expression tree.
- * <b>
+ * <p>
* Note that there is a constructor for Double values, but not Float.
* CORBA defines that all floating point expressions are evaluated as
* double, and that the result is coerced back to float if necessary.
- * <b>
+ * <p>
* Note also that there is a constructor for long values, but not for
* int or short. CORBA defines that all integral expressions are evaluated
* as unsigned long. A CORBA long is a Java int. There is no unsigned int
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Arguments.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Arguments.java Tue May 05 15:17:13 2015 +0400
@@ -260,7 +260,7 @@
} // packageFromProps
/**
- * d57482 <klr> method added so default emitter check could be overriden.
+ * d57482 (klr) method added so default emitter check could be overriden.
**/
protected void setDefaultEmitter () {
// If the flag -fclient was not found, assume it.
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/AttributeGen24.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/AttributeGen24.java Tue May 05 15:17:13 2015 +0400
@@ -64,7 +64,7 @@
} // ctor
/**
- * <d62023-klr> Added for 2.4 RTF
+ * (d62023-klr) Added for 2.4 RTF
**/
protected void abstractMethod (Hashtable symbolTable, MethodEntry m, PrintWriter stream)
{
@@ -83,7 +83,7 @@
} // abstractMethod
/**
- * <d62023-klr> Added for 2.4 RTF
+ * (d62023-klr) Added for 2.4 RTF
**/
protected void interfaceMethod (Hashtable symbolTable, MethodEntry m, PrintWriter stream)
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Helper24.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Helper24.java Tue May 05 15:17:13 2015 +0400
@@ -70,7 +70,7 @@
/**
* Generate the heading, including package, imports, class statements,
* and open curly.
- * <d62023> - don't implement ValueHelper, make non-boxed helpers abstract
+ * d62023 - don't implement ValueHelper, make non-boxed helpers abstract
**/
protected void writeHeading ()
{
@@ -92,8 +92,10 @@
/**
* Generate the instance variables.
- * <d62023> - no helper instance except for boxed valuetypes.
- * - move truncatable_ids to mapped class.
+ * <pre>
+ * d62023 - no helper instance except for boxed valuetypes;
+ * - move truncatable_ids to mapped class.
+ * </pre>
**/
protected void writeInstVars ()
{
@@ -110,9 +112,9 @@
} // writeInstVars
/**
- * <d62023> generate members of BoxedValueHelper interface if boxed
+ * d62023 - generate members of BoxedValueHelper interface if boxed
*
- * <d62023> Hook in here to write factory methods for non-boxed ValueTypes
+ * d62023 - hook in here to write factory methods for non-boxed ValueTypes
* into Helper.
**/
protected void writeValueHelperInterface ()
@@ -143,8 +145,8 @@
} // writeHelperFactories
/**
- * <d62023> Generate constructors only for boxed valuetype helpers
- * All other helpers are abstract.
+ * d62023 - generate constructors only for boxed valuetype helpers.
+ * All other helpers are abstract.
**/
protected void writeCtors ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/InterfaceGen.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/InterfaceGen.java Tue May 05 15:17:13 2015 +0400
@@ -190,17 +190,19 @@
/**
* Generate the interface. Provides general algorithm for binding generation:
- * 1.) Initialize members unique to this generator. - init ()
- * 2.) Open print stream - openStream ()
- * 3.) Write class heading (package, prologue, class statement, open curly - writeHeading ()
- * 4.) Write class body (member data and methods) - write*Body ()
- * 5.) Write class closing (close curly) - writeClosing ()
- * 6.) Close the print stream - closeStream ()
+ * <ol>
+ * <li> Initialize members unique to this generator - init()</li>
+ * <li> Open print stream - openStream()</li>
+ * <li> Write class heading (package, prologue, class statement, open curly - writeHeading()</li>
+ * <li> Write class body (member data and methods) - write*Body()</li>
+ * <li> Write class closing (close curly) - writeClosing()</li>
+ * <li> Close the print stream - closeStream ()</li>
+ * </ol>
*
* For CORBA 2.3, interfaces are mapped to Operations and Signature
* interfaces. The Operations interface contains the method definitions.
* The Signature interface extends the Operations interface and adds
- * CORBA::Object. <klr>
+ * CORBA::Object. (klr)
**/
protected void generateInterface ()
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/MethodGen24.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/MethodGen24.java Tue May 05 15:17:13 2015 +0400
@@ -96,7 +96,7 @@
}
/**
- * <d62023> Write the methodEntry for a valuetype factory method into
+ * d62023 - write the methodEntry for a valuetype factory method into
* the Value Helper class. Contents from email from Simon,
* 4/25/99.
**/
@@ -135,7 +135,7 @@
} // helperFactoryMethod
/**
- * <d62023> - write an abstract method definition
+ * d62023 - write an abstract method definition
**/
protected void abstractMethod (Hashtable symbolTable, MethodEntry m, PrintWriter stream)
{
@@ -152,8 +152,8 @@
} // abstractMethod
/**
- * <d62023> - write a default factory method implementation for the
- * <value>DefaultFactory. m is a methodEntry for a factory
+ * d62023 - write a default factory method implementation for the
+ * {@code <value>DefaultFactory}. m is a methodEntry for a factory
* method contained in a non-abstract ValueEntry.
**/
protected void defaultFactoryMethod (Hashtable symbolTable, MethodEntry m, PrintWriter stream)
@@ -176,7 +176,7 @@
} // defaultFactoryMethod
/**
- * <d62023> - remove all valueInitializer junk
+ * d62023 - remove all valueInitializer junk
**/
protected void writeMethodSignature ()
{
@@ -242,7 +242,7 @@
} // writeMethodSignature
/**
- * <d62023> - delete method templates for valuetypes
+ * d62023 - delete method templates for valuetypes
**/
protected void interfaceMethod (Hashtable symbolTable, MethodEntry m, PrintWriter stream)
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/MethodGenClone24.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/MethodGenClone24.java Tue May 05 15:17:13 2015 +0400
@@ -74,7 +74,7 @@
} // ctor
/**
- * <d62023> - write an abstract method definition
+ * d62023 - write an abstract method definition
**/
protected void abstractMethod (Hashtable symbolTable, MethodEntry m, PrintWriter stream)
{
@@ -91,7 +91,7 @@
} // abstractMethod
/**
- * <d62023> - delete method templates for valuetypes
+ * d62023 - delete method templates for valuetypes
**/
protected void interfaceMethod (Hashtable symbolTable, MethodEntry m, PrintWriter stream)
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/ValueBoxGen24.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/ValueBoxGen24.java Tue May 05 15:17:13 2015 +0400
@@ -69,7 +69,7 @@
} // ctor
/**
- * <d62023> - Move from helper to mapped class
+ * d62023 - Move from helper to mapped class
**/
protected void writeTruncatable () // <d60929>
{
@@ -84,7 +84,7 @@
/**
- * <d62023>
+ * d62023
**/
public void helperRead (String entryName, SymtabEntry entry, PrintWriter stream)
{
@@ -144,7 +144,7 @@
} // helperWrite
/**
- * <d62023>
+ * d62023
**/
public int write (int index, String indent, String name, SymtabEntry entry, PrintWriter stream)
{
--- a/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/ValueGen24.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/ValueGen24.java Tue May 05 15:17:13 2015 +0400
@@ -73,15 +73,17 @@
} // ctor
/**
- * <d62023> - delete constructor; helper is abstract
+ * d62023 - delete constructor; helper is abstract
**/
protected void writeConstructor ()
{
} // writeConstructor
/**
- * <d62023> - delete write_value from non-boxed helpers
- * - delete _write from non-boxed helpers
+ * <pre>
+ * d62023 - delete write_value from non-boxed helpers
+ * - delete _write from non-boxed helpers
+ * </pre>
**/
public void helperWrite (SymtabEntry entry, PrintWriter stream)
{
@@ -91,7 +93,7 @@
} // helperWrite
/**
- * <d62023>
+ * d62023
**/
public void helperRead (String entryName, SymtabEntry entry, PrintWriter stream)
{
@@ -101,7 +103,7 @@
} // helperRead
/**
- * <d62023> - suppress initializers from mapped value; now generated in
+ * d62023 - suppress initializers from mapped value; now generated in
* the Helper class and Factory class
**/
protected void writeInitializers ()
@@ -110,7 +112,7 @@
} // writeInitializers
/**
- * <d62023> - Goes in mapped class, not Helper
+ * d62023 - goes in mapped class, not Helper
**/
protected void writeTruncatable () // <d60929>
{
@@ -155,7 +157,7 @@
}
/**
- * <d62023> CustomMarshal -> CustomValue for custom valuetypes
+ * d62023 - CustomMarshal {@literal ->} CustomValue for custom valuetypes
* mapped class is abstract
**/
protected void writeHeading ()
@@ -217,7 +219,7 @@
} // writeHeading
/**
- * <d62023> - private state maps to protected, not default
+ * d62023 - private state maps to protected, not default
**/
protected void writeMembers ()
{
@@ -245,8 +247,7 @@
} // writeMembers
/**
- * <d62023> Methods need to be abstract
- * writeStreamable
+ * d62023 - methods need to be abstract writeStreamable
**/
protected void writeMethods ()
{
@@ -294,7 +295,7 @@
} // writeMethods
/**
- * <d62023> Call super._read()
+ * d62023 - call super._read()
**/
public int read (int index, String indent, String name, SymtabEntry entry, PrintWriter stream)
{
@@ -335,7 +336,7 @@
} // read
/**
- * <d62023> Call super._write()
+ * d62023 - call super._write()
**/
public int write (int index, String indent, String name, SymtabEntry entry, PrintWriter stream)
{
@@ -374,7 +375,7 @@
} // write
/**
- * <62023> - generate factory interface and default factory
+ * d62023 - generate factory interface and default factory
**/
public void generate (Hashtable symbolTable, ValueEntry v, PrintWriter str)
{
--- a/corba/src/jdk.rmic/share/classes/sun/rmi/rmic/iiop/Type.java Wed Jul 05 20:31:05 2017 +0200
+++ b/corba/src/jdk.rmic/share/classes/sun/rmi/rmic/iiop/Type.java Tue May 05 15:17:13 2015 +0400
@@ -51,7 +51,7 @@
* conformance checking and name mapping as defined in the "Java to IDL
* Mapping" OMG specification. The family is composed of the following
* fixed set of types:
- * <pre>
+ * <pre>{@literal
*
* +- RemoteType <-- AbstractType
* |
@@ -67,7 +67,7 @@
* |
* +- NCClassType
*
- * </pre>
+ * }</pre>
* PrimitiveType represents a primitive or a void type.
* <p>
* CompoundType is an abstract base representing any non-special class