changeset 674:0a5e5a7c3539 jdk9-b64

Merge
author lana
date Thu, 07 May 2015 20:50:57 -0700
parents 3602151f60f1 6b017d166ac2
children afc1e295c4bf
files
diffstat 114 files changed, 304 insertions(+), 568 deletions(-) [+]
line wrap: on
line diff
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/corba/AnyImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/corba/AnyImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/encoding/CDROutputObject.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/encoding/CDROutputObject.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/encoding/CodeSetConversion.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/encoding/CodeSetConversion.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/io/ValueHandlerImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/io/ValueHandlerImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -171,9 +171,9 @@
      * @param out The stream to write the value to
      * @param value The value to be written to the stream
      **/
-    public void writeValue(org.omg.CORBA.portable.OutputStream _out,
+    public void writeValue(org.omg.CORBA.portable.OutputStream out,
                            java.io.Serializable value) {
-        writeValueWithVersion(_out, value, STREAM_FORMAT_VERSION_1);
+        writeValueWithVersion(out, value, STREAM_FORMAT_VERSION_1);
     }
 
     private void writeValueWithVersion(org.omg.CORBA.portable.OutputStream _out,
@@ -240,25 +240,25 @@
      * Reads a value from the stream using java semantics.
      * @param in The stream to read the value from
      * @param clazz The type of the value to be read in
-     * @param sender The sending context runtime
+     * @param rt The sending context runtime
      **/
-    public java.io.Serializable readValue(org.omg.CORBA.portable.InputStream _in,
+    public java.io.Serializable readValue(org.omg.CORBA.portable.InputStream in,
                                           int offset,
                                           java.lang.Class clazz,
                                           String repositoryID,
-                                          org.omg.SendingContext.RunTime _sender)
+                                          org.omg.SendingContext.RunTime rt)
     {
         // Must use narrow rather than a direct cast to a com.sun
         // class.  Fix for bug 4379539.
-        CodeBase sender = CodeBaseHelper.narrow(_sender);
+        CodeBase sender = CodeBaseHelper.narrow(rt);
 
-        org.omg.CORBA_2_3.portable.InputStream in =
-            (org.omg.CORBA_2_3.portable.InputStream) _in;
+        org.omg.CORBA_2_3.portable.InputStream inStream =
+            (org.omg.CORBA_2_3.portable.InputStream) in;
 
         if (!useHashtables) {
             if (inputStreamBridge == null) {
                 inputStreamBridge = createInputStream();
-                inputStreamBridge.setOrbStream(in);
+                inputStreamBridge.setOrbStream(inStream);
                 inputStreamBridge.setSender(sender); //d11638
                 // backward compatability 4365188
                 inputStreamBridge.setValueHandler(this);
@@ -269,7 +269,7 @@
             try {
 
                 inputStreamBridge.increaseRecursionDepth();
-                result = (java.io.Serializable) readValueInternal(inputStreamBridge, in, offset, clazz, repositoryID, sender);
+                result = (java.io.Serializable) readValueInternal(inputStreamBridge, inStream, offset, clazz, repositoryID, sender);
 
             } finally {
 
@@ -287,16 +287,16 @@
         if (inputStreamPairs == null)
             inputStreamPairs = new Hashtable();
 
-        jdkToOrbInputStreamBridge = (IIOPInputStream)inputStreamPairs.get(_in);
+        jdkToOrbInputStreamBridge = (IIOPInputStream)inputStreamPairs.get(in);
 
         if (jdkToOrbInputStreamBridge == null) {
 
             jdkToOrbInputStreamBridge = createInputStream();
-            jdkToOrbInputStreamBridge.setOrbStream(in);
+            jdkToOrbInputStreamBridge.setOrbStream(inStream);
             jdkToOrbInputStreamBridge.setSender(sender); //d11638
             // backward compatability 4365188
             jdkToOrbInputStreamBridge.setValueHandler(this);
-            inputStreamPairs.put(_in, jdkToOrbInputStreamBridge);
+            inputStreamPairs.put(in, jdkToOrbInputStreamBridge);
         }
 
         java.io.Serializable result = null;
@@ -304,12 +304,12 @@
         try {
 
             jdkToOrbInputStreamBridge.increaseRecursionDepth();
-            result = (java.io.Serializable) readValueInternal(jdkToOrbInputStreamBridge, in, offset, clazz, repositoryID, sender);
+            result = (java.io.Serializable) readValueInternal(jdkToOrbInputStreamBridge, inStream, offset, clazz, repositoryID, sender);
 
         } finally {
 
             if (jdkToOrbInputStreamBridge.decreaseRecursionDepth() == 0) {
-                inputStreamPairs.remove(_in);
+                inputStreamPairs.remove(in);
             }
         }
 
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericIdentifiable.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericIdentifiable.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericTaggedComponent.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericTaggedComponent.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericTaggedProfile.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/GenericTaggedProfile.java	Thu May 07 20:50:57 2015 -0700
@@ -39,9 +39,6 @@
 
 import com.sun.corba.se.impl.encoding.EncapsOutputStream ;
 
-/**
- * @author
- */
 public class GenericTaggedProfile extends GenericIdentifiable implements TaggedProfile
 {
     private ORB orb ;
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/ior/IORTemplateImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/IORTemplateImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -47,7 +47,6 @@
 
 /**
  * This class is a container of TaggedProfileTemplates.
- * @author
  */
 public class IORTemplateImpl extends IdentifiableContainerBase implements IORTemplate
 {
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectAdapterIdNumber.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectAdapterIdNumber.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectIdImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectIdImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectKeyImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectKeyImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -37,9 +37,6 @@
 
 import com.sun.corba.se.impl.encoding.EncapsOutputStream ;
 
-/**
- * @author
- */
 public class ObjectKeyImpl implements ObjectKey
 {
     private ObjectKeyTemplate oktemp;
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectKeyTemplateBase.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/ObjectKeyTemplateBase.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/ior/POAObjectKeyTemplate.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/POAObjectKeyTemplate.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/ior/StubIORImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/StubIORImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/ior/TaggedProfileFactoryFinderImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/TaggedProfileFactoryFinderImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -33,9 +33,6 @@
 
 import org.omg.CORBA_2_3.portable.InputStream ;
 
-/**
- * @author
- */
 public class TaggedProfileFactoryFinderImpl extends
     IdentifiableFactoryFinderBase
 {
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/ior/TaggedProfileTemplateFactoryFinderImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/TaggedProfileTemplateFactoryFinderImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -35,9 +35,6 @@
 
 import org.omg.CORBA.INTERNAL ;
 
-/**
- * @author
- */
 public class TaggedProfileTemplateFactoryFinderImpl extends
     IdentifiableFactoryFinderBase
 {
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/CodeSetsComponentImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/CodeSetsComponentImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressBase.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressBase.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressClosureImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressClosureImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -32,9 +32,6 @@
 
 import com.sun.corba.se.spi.orbutil.closure.Closure ;
 
-/**
- * @author
- */
 public final class IIOPAddressClosureImpl extends IIOPAddressBase
 {
     private Closure host;
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPAddressImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -36,9 +36,6 @@
 
 import com.sun.corba.se.impl.logging.IORSystemException ;
 
-/**
- * @author
- */
 public final class IIOPAddressImpl extends IIOPAddressBase
 {
     private ORB orb ;
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPProfileImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPProfileImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -76,9 +76,6 @@
 
 import com.sun.corba.se.impl.logging.IORSystemException;
 
-/**
- * @author
- */
 public class IIOPProfileImpl extends IdentifiableBase implements IIOPProfile
 {
     private ORB orb ;
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPProfileTemplateImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/IIOPProfileTemplateImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/JavaCodebaseComponentImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/ior/iiop/JavaCodebaseComponentImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -33,9 +33,6 @@
 
 import com.sun.corba.se.spi.ior.iiop.JavaCodebaseComponent ;
 
-/**
- * @author
- */
 public class JavaCodebaseComponentImpl extends TaggedComponentBase
     implements JavaCodebaseComponent
 {
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/javax/rmi/CORBA/Util.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/javax/rmi/CORBA/Util.java	Thu May 07 20:50:57 2015 -0700
@@ -593,7 +593,7 @@
      * @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 loadingContext a class whose ClassLoader may be used to
+     * @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.
      * @exception ClassNotFoundException if class cannot be loaded.
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/BindingIteratorImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/BindingIteratorImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -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.
@@ -114,7 +114,7 @@
      * scope, It will be called from NamingContext.list() operation or
      * this.next_n().
      * @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.
      */
     public boolean list( int how_many, org.omg.CosNaming.BindingListHolder blh)
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/NamingContextImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/NamingContextImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -181,7 +181,7 @@
      * exists. The NamingContext will participate in recursive resolving.
      * @param n a sequence of NameComponents which is the name under which
      * the object will be bound.
-     * @param obj the NamingContect object reference to be bound.
+     * @param nc the NamingContext object reference to be bound.
      * @exception org.omg.CosNaming.NamingContextPackage.NotFound A name with
      * multiple components was supplied, but the first component could not be
      * resolved.
@@ -278,7 +278,7 @@
      * resolving.
      * @param n a sequence of NameComponents which is the name under which
      * the object will be bound.
-     * @param obj the object reference to be bound.
+     * @param nc the object reference to be bound.
      * @exception org.omg.CosNaming.NamingContextPackage.NotFound A name with
      * multiple components was supplied, but the first component could not be
      * resolved.
@@ -853,10 +853,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
@@ -882,10 +881,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
@@ -920,14 +918,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)
@@ -961,15 +958,15 @@
     /**
      * 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.
      * @exception org.omg.CosNaming.NamingContextPackage.AlreadyBound
-     * Indicates the name is already bound.<p>
+     * Indicates the name is already bound.
      *
      */
     public org.omg.CORBA.Object resolve_str(String sn)
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/NamingUtils.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/NamingUtils.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/TransientBindingIterator.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/TransientBindingIterator.java	Thu May 07 20:50:57 2015 -0700
@@ -63,7 +63,6 @@
      * @param orb a org.omg.CORBA.ORB object.
      * @param aTable A hashtable containing InternalBindingValues which is
      * the content of the TransientNamingContext.
-     * @param java.lang.Exception a Java exception.
      * @exception Exception a Java exception thrown of the base class cannot
      * initialize.
    */
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/TransientNameService.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/cosnaming/TransientNameService.java	Thu May 07 20:50:57 2015 -0700
@@ -85,7 +85,7 @@
      * NamingContext, whose object
      * reference can be obtained by the initialNamingContext method.
      * @param orb The ORB object
-     * @param nameserviceName Stringified key used for INS Service registry
+     * @param serviceName Stringified key used for INS Service registry
      * @exception org.omg.CORBA.INITIALIZE Thrown if
      * the TransientNameService cannot initialize.
      */
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/CorbanameURL.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/CorbanameURL.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/IIOPEndpointInfo.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/IIOPEndpointInfo.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/INSURL.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/INSURL.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/INSURLHandler.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/INSURLHandler.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/Utility.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/namingutil/Utility.java	Thu May 07 20:50:57 2015 -0700
@@ -36,7 +36,7 @@
 /**
  *  Utility methods for Naming.
  *
- *  @Author Hemanth
+ *  @author Hemanth
  */
 class Utility {
     private static NamingSystemException wrapper =
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/naming/pcosnaming/NameService.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/pcosnaming/NameService.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/naming/pcosnaming/NamingContextImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/pcosnaming/NamingContextImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -116,8 +116,8 @@
      * Runs the super constructor.
      * @param orb an ORB object.
      * @param objKey as String
-     * @param TheNameService as NameService
-     * @param TheServantManagerImpl as ServantManagerImpl
+     * @param theNameService as NameService
+     * @param theServantManagerImpl as ServantManagerImpl
      * @exception java.lang.Exception a Java exception.
      */
 
@@ -223,7 +223,7 @@
    * exists. The NamingContext will participate in recursive resolving.
    * @param n a sequence of NameComponents which is the name under which
    * the object will be bound.
-   * @param obj the NamingContect object reference to be bound.
+   * @param nc the NamingContect object reference to be bound.
    * @exception org.omg.CosNaming.NamingContextPackage.NotFound A name with multiple
    * components was supplied, but the first component could not be
    * resolved.
@@ -301,7 +301,7 @@
    * unbound first. The NamingContext will participate in recursive resolving.
    * @param n a sequence of NameComponents which is the name under which
    * the object will be bound.
-   * @param obj the object reference to be bound.
+   * @param nc the object reference to be bound.
    * @exception org.omg.CosNaming.NamingContextPackage.NotFound A name with multiple
    * components was supplied, but the first component could not be
    * resolved.
@@ -907,7 +907,7 @@
     * The doResolve( ) method calls Resolve( ) recursively to resolve n level
     * Names.
     * @param n a sequence of NameComponents which is the name to be resolved.
-    * @param bt Type of binding (as object or as context).
+    * @param bth Type of binding (as object or as context).
     * @return the object reference bound under the supplied name.
     * @exception org.omg.CosNaming.NamingContextPackage.NotFound Neither a NamingContext
     * or a Corba Object reference not found under this Name
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/naming/pcosnaming/PersistentBindingIterator.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/naming/pcosnaming/PersistentBindingIterator.java	Thu May 07 20:50:57 2015 -0700
@@ -64,7 +64,6 @@
      * @param orb a org.omg.CORBA.ORB object.
      * @param aTable A hashtable containing InternalBindingValues which is
      * the content of the PersistentNamingContext.
-     * @param java.lang.Exception a Java exception.
      * @exception Exception a Java exception thrown of the base class cannot
      * initialize.
    */
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/oa/toa/TOAImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/oa/toa/TOAImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -61,7 +61,7 @@
 * Its characteristics include:
 * <UL>
 * <LI>There is only one OA instance of the TOA.  Its OAId is { "TOA" }</LI>
-* <LI>There is not adapter manager.  The TOA manager ID is fixed.<LI>
+* <LI>There is not adapter manager.  The TOA manager ID is fixed.</LI>
 * <LI>State is the same as ORB state (TBD)</LI>
 * </UL>
 * Other requirements:
@@ -118,7 +118,7 @@
     * This will update thread Current, so that subsequent calls to
     * returnServant and removeCurrent from the same thread are for the
     * same request.
-    * @param request is the request containing the rest of the request
+    * @param info is the request containing the rest of the request
     */
     public void getInvocationServant( OAInvocationInfo info )
     {
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/orb/ORBImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/orb/ORBImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/DenseIntMapImpl.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/DenseIntMapImpl.java	Thu May 07 20:50:57 2015 -0700
@@ -42,8 +42,9 @@
             throw new IllegalArgumentException( "Key must be >= 0." ) ;
     }
 
-    /** If key >= 0, return the value bound to key, or null if none.
-     * Throws IllegalArgumentException if key <0.
+    /**
+     * If {@code key >= 0}, return the value bound to key, or null if none.
+     * Throws IllegalArgumentException if {@code key < 0}.
      */
     public Object get( int key )
     {
@@ -56,8 +57,9 @@
         return result ;
     }
 
-    /** If key >= 0, bind value to the key.
-     * Throws IllegalArgumentException if key <0.
+    /**
+     * If {@code key >= 0}, bind value to the key.
+     * Throws IllegalArgumentException if {@code key < 0}.
      */
     public void set( int key, Object value )
     {
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/GetPropertyAction.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/GetPropertyAction.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/concurrent/CondVar.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/concurrent/CondVar.java	Thu May 07 20:50:57 2015 -0700
@@ -150,8 +150,7 @@
  *
  * </pre>
  * @see Mutex
- * <p>[<a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
-
+ * [<a href="http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html"> Introduction to this package. </a>]
  **/
 
 public class CondVar {
--- a/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/concurrent/Mutex.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/concurrent/Mutex.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/concurrent/Sync.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/orbutil/concurrent/Sync.java	Thu May 07 20:50:57 2015 -0700
@@ -181,11 +181,11 @@
  *     }
  *   }
  * }
- *</pre>
+ * </pre>
  * <p>
  * Here is an even fancier version, that uses lock re-ordering
  * upon conflict:
- * <pre>
+ * <pre>{@code
  * class Cell {
  *   long value;
  *   Sync lock = ...;
@@ -214,8 +214,8 @@
  *    }
  *    catch (InterruptedException ex) { return; }
  *  }
- *}
- *</pre>
+ * }
+ * }</pre>
  * <p>
  * Interruptions are in general handled as early as possible.
  * Normally, InterruptionExceptions are thrown
@@ -248,7 +248,7 @@
  * it is normally best to just use acquire(), various forms
  * of busy waits can be implemented. For a simple example
  * (but one that would probably never be preferable to using acquire()):
- * <pre>
+ * <pre>{@code
  * class X {
  *   Sync lock = ...
  *   void spinUntilAcquired() throws InterruptedException {
@@ -269,17 +269,16 @@
  *     }
  *   }
  * }
- * </pre>
+ * }</pre>
  * <p>
  * In addition pure synchronization control, Syncs
  * may be useful in any context requiring before/after methods.
  * 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>]
-**/
+ *
+ * [<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/src/java.corba/share/classes/com/sun/corba/se/impl/transport/CorbaConnectionCacheBase.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/impl/transport/CorbaConnectionCacheBase.java	Thu May 07 20:50:57 2015 -0700
@@ -130,13 +130,13 @@
      * This method must be synchronized since one WorkerThread could
      * be reclaming connections inside the synchronized backingStore
      * block and a second WorkerThread (or a SelectorThread) could have
-     * already executed the if (numberOfConnections <= .... ). As a
+     * already executed the if (numberOfConnections {@literal <=} .... ). As a
      * result the second thread would also attempt to reclaim connections.
      *
      * If connection reclamation becomes a performance issue, the connection
      * reclamation could make its own task and consequently executed in
      * a separate thread.
-     * Currently, the accept & reclaim are done in the same thread, WorkerThread
+     * Currently, the accept {@literal &} reclaim are done in the same thread, WorkerThread
      * by default. It could be changed such that the SelectorThread would do
      * it for SocketChannels and WorkerThreads for Sockets by updating the
      * ParserTable.
--- a/src/java.corba/share/classes/com/sun/corba/se/pept/transport/Acceptor.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/pept/transport/Acceptor.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/extension/ServantCachingPolicy.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/extension/ServantCachingPolicy.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/ior/package.html	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/ior/package.html	Thu May 07 20:50:57 2015 -0700
@@ -41,8 +41,8 @@
 <li>An IIOPProfile isA TaggedProfile.</li>
 <li>An IIOPProfile is composed of an IIOPProfileTemplate and an object ID.</li>
 <li>An IIOPProfileTemplate has an ObjectKeyTemplate, and contains TaggedComponents.</li>
-<li>A TaggedComponent has an ID, and can be written to an OuputStream.<li>
-<li>A TaggedComponentFactory reads a TaggedComponent from an InputStream.<li>
+<li>A TaggedComponent has an ID, and can be written to an OuputStream.</li>
+<li>A TaggedComponentFactory reads a TaggedComponent from an InputStream.</li>
 </ul>
 <p>
 In all cases, containment is represented by having the appropriate interface (IOR and
--- a/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/connection/ORBSocketFactory.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/connection/ORBSocketFactory.java	Thu May 07 20:50:57 2015 -0700
@@ -48,7 +48,7 @@
  *
  * property. <p>
  *
- * Example: <p>
+ * Example:
 
  * <pre>
  *   -Dcom.sun.CORBA.connection.ORBSocketFactoryClass=MySocketFactory
@@ -145,7 +145,7 @@
      *
      * property. <p>
      *
-     * Example usage:<p>
+     * Example usage:
      *
      * <pre>
      *    ... \
@@ -203,7 +203,7 @@
      * Once you have the port you may add information to references
      * created by the associated adapter by calling
      *
-     *    <code>IORInfo::add_ior_component</code><p> <p>
+     *    <code>IORInfo::add_ior_component</code><p>
      *
      *
      * Note: if one is using a POA and the lifespan policy of that
@@ -247,7 +247,7 @@
      *
      *    <code>ORBConstants.BAD_SERVER_ID_HANDLER_CLASS_PROPERTY</code> <p>
      *
-     * Example: <p>
+     * Example:
      *
      * <pre>
      *
@@ -271,7 +271,7 @@
      *     <code>SOCKET_FACTORY_CLASS_PROPERTY</code> and
      *     <code>LISTEN_SOCKET_PROPERTY</code>
      *
-     * as used by other clients and servers in your distributed system. <p>
+     * as used by other clients and servers in your distributed system.
      *
      */
     public ServerSocket createServerSocket(String type, int port)
@@ -324,7 +324,7 @@
      *
      * The <code>SocketInfo</code> given to <code>getEndPointInfo</code>
      * is either null or an object obtained
-     * from <code>GetEndPointInfoAgainException</code> <p>
+     * from <code>GetEndPointInfoAgainException</code>
      *
      */
     public SocketInfo getEndPointInfo(org.omg.CORBA.ORB orb,
@@ -333,7 +333,7 @@
 
 
     /**
-     * DEPRECATED.  DEPRECATED. DEPRECATED. DEPRECATED. <p
+     * DEPRECATED.  DEPRECATED. DEPRECATED. DEPRECATED. <p>
      *
      * This method is used by a client side ORB. <p>
      *
@@ -346,7 +346,7 @@
      *
      * If this method throws GetEndPointInfoAgainException then the
      * ORB calls <code>getEndPointInfo</code> again, passing it the
-     * <code>SocketInfo</code> object contained in the exception. <p>
+     * <code>SocketInfo</code> object contained in the exception.
      *
      */
     public Socket createSocket(SocketInfo socketInfo)
--- a/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/interceptor/RequestInfoExt.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/legacy/interceptor/RequestInfoExt.java	Thu May 07 20:50:57 2015 -0700
@@ -30,8 +30,7 @@
 /**
  * This interface is implemented by our implementation of
  * PortableInterceptor.ClientRequestInfo and
- * PortableInterceptor.ServerRequestInfo. <p>
- *
+ * PortableInterceptor.ServerRequestInfo.
  */
 
 public interface RequestInfoExt
--- a/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/LongMonitoredAttributeBase.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/LongMonitoredAttributeBase.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttribute.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttribute.java	Thu May 07 20:50:57 2015 -0700
@@ -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>
+ * @return monitoredAttributeInfo for this Monitored Attribute.
  */
     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>
+ * @return the current value for this MonitoredAttribute
  */
     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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeBase.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeBase.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeInfo.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeInfo.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeInfoFactory.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredAttributeInfoFactory.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredObject.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredObject.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredObjectFactory.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoredObjectFactory.java	Thu May 07 20:50:57 2015 -0700
@@ -25,14 +25,9 @@
 package com.sun.corba.se.spi.monitoring;
 
 /**
- * <p>
- *
  * @author Hemanth Puttaswamy
- * </p>
- * <p>
  *
  * MonitoredObject Factory to create Monitored Object.
- * </p>
  */
 public interface MonitoredObjectFactory {
     /**
--- a/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringFactories.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringFactories.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringManager.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringManager.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringManagerFactory.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/MonitoringManagerFactory.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StatisticMonitoredAttribute.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StatisticMonitoredAttribute.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StatisticsAccumulator.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StatisticsAccumulator.java	Thu May 07 20:50:57 2015 -0700
@@ -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 &quot;Hours&quot;, &quot;Minutes&quot;,
- * &quot;Seconds&quot;, &quot;MilliSeconds&quot;, &quot;Micro Seconds&quot;
- * 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/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StringMonitoredAttributeBase.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/monitoring/StringMonitoredAttributeBase.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/oa/ObjectAdapter.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/oa/ObjectAdapter.java	Thu May 07 20:50:57 2015 -0700
@@ -89,7 +89,7 @@
 * <li>A local invocation, where the dispatch is handled in the client subcontract.</li>
 * <li>A cached local invocation, where the servant is cached when the IOR is established
 * for the client subcontract, and the dispatch is handled in the client subcontract
-* to the cached subcontract.<li>
+* to the cached subcontract.</li>
 * </ol>
 * <p>
 * Each of these 3 cases is handled a bit differently.  On each request, assume as known
@@ -111,11 +111,11 @@
 *   <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?
+* <!-- 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,
-* returnServant, exit, and pop must be called in the correct order.
+* returnServant, exit, and pop must be called in the correct order. -->
 * <li>The local pattern:
 *   <ol>
 *   <li>oa = oaf.find( oaid )</li>
@@ -128,10 +128,10 @@
 *   <li>oa.returnServant()</li>
 *   <li>oa.exit()</li>
 *   <li>pop info</li>
-*   <ol>
+*   </ol>
 * </li>
-* This is the same as the remote case, except that setExecuteReturnServantInResponseConstructor
-* is not needed (or possible, since there is no server request).
+* <!-- This is the same as the remote case, except that setExecuteReturnServantInResponseConstructor
+* is not needed (or possible, since there is no server request). -->
 * <li>The fast local pattern: When delegate is constructed,
 *    first extract ObjectKey from IOR in delegate,
 *    then get ObjectId, ObjectAdapterId, and ObjectAdapterFactory (oaf). Then:
@@ -143,14 +143,14 @@
 *    <li>pop info
 *    </ol>
 *    The info instance (which includes the Servant) is cached in the client subcontract.
-*    <p>Then, on each invocation:</p>
+*    <p>Then, on each invocation:
 *    <ol>
 *    <li>newinfo = copy of info (clone)</li>
 *    <li>info.setOperation( operation )</li>
 *    <li>push newinfo</li>
 *    <li>oa.enter()</li>
 *    <li>dispatch to servant</li>
-*    <li>oa.returnServant()</li>  // XXX This is probably wrong: remove it.
+*    <li>oa.returnServant()</li>  <!-- XXX This is probably wrong: remove it. -->
 *    <li>oa.exit()</li>
 *    <li>pop info</li>
 *    </ol>
--- a/src/java.corba/share/classes/com/sun/corba/se/spi/orb/DataCollector.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/orb/DataCollector.java	Thu May 07 20:50:57 2015 -0700
@@ -58,7 +58,7 @@
      * mappings in the resulting properties.  Also, -ORBInitialServices
      * is handled specially in applet mode: they are converted from
      * relative to absolute URLs.
-     * @raises IllegalStateException if setPropertyNames has not
+     * @throws IllegalStateException if setPropertyNames has not
      * been called.
      */
     Properties getProperties() ;
--- a/src/java.corba/share/classes/com/sun/corba/se/spi/orbutil/fsm/Action.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/orbutil/fsm/Action.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/corba/se/spi/orbutil/fsm/Guard.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/orbutil/fsm/Guard.java	Thu May 07 20:50:57 2015 -0700
@@ -93,8 +93,8 @@
     * input is retried when the thread runs again.
     * </ul>
     *
-    * @param FSM fsm is the state machine causing this action.
-    * @param Input in is the input that caused the transition.
+    * @param fsm is the state machine causing this action.
+    * @param in is the input that caused the transition.
     */
     public Result evaluate( FSM fsm, Input in ) ;
 }
--- a/src/java.corba/share/classes/com/sun/corba/se/spi/servicecontext/ServiceContext.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/corba/se/spi/servicecontext/ServiceContext.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/org/omg/CORBA/portable/ValueHelper.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/org/omg/CORBA/portable/ValueHelper.java	Thu May 07 20:50:57 2015 -0700
@@ -32,7 +32,7 @@
  * An interface that is implemented by valuetype helper classes.
  * This interface appeared in CORBA 2.3 drafts but was removed from
  * the published CORBA 2.3 specification.
- * <P>
+ *
  * @deprecated Deprecated by CORBA 2.3.
  */
 @Deprecated
--- a/src/java.corba/share/classes/com/sun/tools/corba/se/idl/Arguments.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/Arguments.java	Thu May 07 20:50:57 2015 -0700
@@ -68,9 +68,9 @@
    * must check the arguments passed to it for validity and process the
    * arguments appropriately.  If it detects an invalid argument, it should
    * throw an InvalidArgument exception.  Arguments MUST be of the form
-   * `/<arg> [<qualifiers>]' or `-<arg> [<qualifiers>]' where <qualifiers>
-   * is optional (for example, -iC:\includes, `C:\includes' is the qualifier
-   * for the argument `i').
+   * {@code '/<arg> [<qualifiers>]'} or {@code '-<arg> [<qualifiers>]'} where {@code <qualifiers>}
+   * is optional (for example, -iC:\includes, 'C:\includes' is the qualifier
+   * for the argument 'i').
    * @param args The arguments which are unknown by the framework.
    * @param properties Environment-style properties collected from the
    * file idl.config.
@@ -289,7 +289,7 @@
   public Hashtable definedSymbols = new Hashtable ();
 
   /**
-   * <f46082.46.01> True if new module entries are created for each
+   * (f46082.46.01) True if new module entries are created for each
    * re-opened module.
    **/
   public boolean cppModule = false;
--- a/src/java.corba/share/classes/com/sun/tools/corba/se/idl/AttributeEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/AttributeEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/Compile.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/Compile.java	Thu May 07 20:50:57 2015 -0700
@@ -52,7 +52,7 @@
  * Compiler usage:
  * <br><br>
  *
- * java com.sun.tools.corba.se.idl.toJava.compile [options] <idl file>
+ * {@code java com.sun.tools.corba.se.idl.toJava.compile [options] <idl file>}
  * <br><br>
  *
  * where &lt;idl file&gt; is the name of a file containing IDL definitions,
@@ -62,17 +62,17 @@
  *
  * Options:
  * <dl>
- * <dt>-i &lt;include path&gt;
+ * <dt>{@code -i <include path>}
  * <dd>By default, the current directory is scanned for included files.
  *     This option adds another directory.  See also Note 1 below.
  *
- * <dt>-d &lt;symbol&gt;
- * <dd>This is equivalent to the following line in an IDL file: #define &lt;symbol&gt;
+ * <dt>{@code -d <symbol>}
+ * <dd>This is equivalent to the following line in an IDL file: {@code #define <symbol>}
  *
- * <dt>-emitAll
+ * <dt>{@code -emitAll}
  * <dd>Emit all types, including those found in #included files.
  *
- * <dt>-v
+ * <dt>{@code -v}
  * <dd>Verbose mode.
  * </dl>
  *
@@ -81,9 +81,9 @@
  * time.  Instead, these can be placed into a config file called idl.config.
  * This file must be in the CLASSPATH.  The format of the includes line is:
  *
- * <pre>
+ * <pre>{@code
  * includes=<path1>;<path2>;...;<pathN>
- * </pre>
+ * }</pre>
  *
  * Note that the path separator character, here shown as a semicolon, is
  * machine dependent.  For instance, on Windows 95 this character is a
@@ -481,10 +481,10 @@
    **/
   public Arguments arguments           = null;
   /**
-   * This hashtable contains <real name, alias> pairs.  It is filled in by
+   * This hashtable contains {@code <real name, alias>} pairs. It is filled in by
    * extenders in cases where they wish to override an IDL type name with
    * some other name.  For instance, when mapping to Java, there could be
-   * an overrideNames entry of <"TRUE", "true">.  NOTE:  Do NOT change this
+   * an overrideNames entry of {@code <"TRUE", "true">}.  NOTE:  Do NOT change this
    * variable to a new Hash table.  Just add elements to it.
    **/
   protected Hashtable overrideNames    = new Hashtable ();
@@ -495,8 +495,8 @@
    **/
   protected Hashtable symbolTable      = new Hashtable ();
   /**
-   * This is a vector of strings of the form "IDLfile" or <IDLfile>.  It is
-   * a list of the files included in the given IDL file.  It will be empty
+   * This is a vector of strings of the form {@code "IDLfile"} or {@code <IDLfile>}.
+   * It is a list of the files included in the given IDL file. It will be empty
    * until the parse method executes.  If errors are encountered, the state
    * of this vector is undefined.
    **/
--- a/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ConstEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ConstEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/DefaultSymtabFactory.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/DefaultSymtabFactory.java	Thu May 07 20:50:57 2015 -0700
@@ -202,7 +202,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"> and a
+      there is an entry in Compile.overrideNames: {@code <"octet", "byte">} and a
       PrimitiveEntry in the symbol table for "byte". */
   public PrimitiveEntry primitiveEntry (String name)
   {
--- a/src/java.corba/share/classes/com/sun/tools/corba/se/idl/EnumEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/EnumEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ExceptionEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ExceptionEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ForwardEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ForwardEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ForwardValueEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ForwardValueEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/IncludeEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/IncludeEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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 ()
   {
@@ -97,7 +97,7 @@
 
   //d44810
   /** Access the fully-qualified file specification of this include.
-      @returns a string containing the path of the include file. */
+      @return a string containing the path of the include file. */
   public String absFilename ()
   {
     return _absFilename;
--- a/src/java.corba/share/classes/com/sun/tools/corba/se/idl/InterfaceEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/InterfaceEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/MethodEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/MethodEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ModuleEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ModuleEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/NativeEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/NativeEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ParameterEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ParameterEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/PragmaEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/PragmaEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/PrimitiveEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/PrimitiveEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/RepositoryID.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/RepositoryID.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SequenceEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SequenceEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/StringEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/StringEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/StructEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/StructEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SymtabEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SymtabEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SymtabFactory.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/SymtabFactory.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/Token.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/Token.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/TypedefEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/TypedefEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/UnionBranch.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/UnionBranch.java	Thu May 07 20:50:57 2015 -0700
@@ -46,29 +46,21 @@
  * of what it may contain:
  * <dl>
  * <dt>
- * <pre>
- * case 1: short x;
- * </pre>
- * <dd><short x, <1>, false>
+ * {@code case 1: short x;}
+ * <dd>{@code <short x, <1>, false>}
  * <dt>
- * <pre>
- * case 0:
- * case 8:
- * case 2: long x;
- * </pre>
- * <dd><long x, <0, 8, 2>, false>
+ * {@code case 0:}<br>
+ * {@code case 8:}<br>
+ * {@code case 2: long x;}
+ * <dd>{@code <long x, <0, 8, 2>, false>}
  * <dt>
- * <pre>
- * default: long x;
- * </pre>
- * <dd><long x, <>, true>
+ * {@code default: long x;}
+ * <dd>{@code <long x, <>, true>}
  * <dt>
- * <pre>
- * case 0:
- * case 2:
- * default: char c;
- * </pre>
- * <dd><char c, <0, 2>, true>
+ * {@code case 0:}<br>
+ * {@code case 2:}<br>
+ * {@code default: char c;}
+ * <dd>{@code <char c, <0, 2>, true>}
  * </dl>
  **/
 public class UnionBranch
--- a/src/java.corba/share/classes/com/sun/tools/corba/se/idl/UnionEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/UnionEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ValueBoxEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ValueBoxEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ValueEntry.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/ValueEntry.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/constExpr/Terminal.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/constExpr/Terminal.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Arguments.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Arguments.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/AttributeGen24.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/AttributeGen24.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Compile.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Compile.java	Thu May 07 20:50:57 2015 -0700
@@ -87,37 +87,37 @@
  *
  * Options:
  * <dl>
- *   <dt>-i &lt;include path&gt;
+ *   <dt>{@code -i <include path>}
  *   <dd>By default, the current directory is scanned for included files.
  *   This option adds another directory.  See also the note below.
  *
- *   <dt>-d &lt;symbol&gt;
+ *   <dt>{@code -d <symbol>}
  *   <dd>This is equivalent to the following line in an IDL file:
- *   #define &lt;symbol&gt;
+ *   {@code #define <symbol>}
  *
- *   <dt>-f<side>
- *   <dd>Defines what bindings to emit.  <side> is one of client, server, all,
+ *   <dt>{@code -f <side>}
+ *   <dd>Defines what bindings to emit. {@code <side>} is one of client, server, all,
  *   serverTIE, allTIE.  serverTIE and allTIE cause delegate model skeletons
  *   to be emitted. If this flag is not used, -fclient is assumed.
  *   allPOA has the same effect as all, except for generation POA type skeletons.
  *
- *   <dt>-keep
+ *   <dt>{@code -keep}
  *   <dd>If a file to be generated already exists, do not overwrite it. By
  *   default it is overwritten.
  *
- *   <dt>-sep <string>
+ *   <dt>{@code -sep <string>}
  *   <dd>Only valid with -m.  Replace the file separator character with
- *     <string> in the file names listed in the .u file.
+ *     {@code <string>} in the file names listed in the .u file.
  *
- *   <dt>-emitAll
+ *   <dt>{@code -emitAll}
  *   <dd>Emit all types, including those found in #included files.
  *
- *   <dt>-v
+ *   <dt>{@code -v}
  *   <dd>Verbose mode.
  *
- *   <dt>-pkgPrefix <type> <package>
- *   <dd>Whereever <type> is encountered, make sure it resides within
- *   &lt;package&gt; in all generated files.  &lt;type&gt; is a fully
+ *   <dt>{@code -pkgPrefix <type> <package>}
+ *   <dd>Whereever {@code <type>} is encountered, make sure it resides within
+ *   {@code <package>} in all generated files.  {@code <type>} is a fully
  *   qualified, java-style name.
  * </dl>
  *
@@ -127,9 +127,9 @@
  * called idl.config.  This file must be in the CLASSPATH.  The format of
  * the includes line is:
  *
- * <pre>
+ * <pre>{@code
  * includes=<path1>;<path2>;...;<pathN>
- * </pre>
+ * }</pre>
  *
  * Note that the path separator character, here shown as a semicolon,
  * is machine dependent.  For instance, on Windows 95 this character
--- a/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Helper24.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Helper24.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/InterfaceGen.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/InterfaceGen.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/MethodGen24.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/MethodGen24.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/MethodGenClone24.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/MethodGenClone24.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Util.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/Util.java	Thu May 07 20:50:57 2015 -0700
@@ -534,7 +534,7 @@
   } // holderName
 
   /**
-   * <d61056>
+   * d61056
    **/
   public static String helperName (SymtabEntry entry, boolean qualifiedName)
   {
@@ -1412,7 +1412,7 @@
   // <d62023>
   /**
    * @return true if the current setting of corbaLevel is within delta of
-   *    the range min <= corbaLevel <= max
+   *    the range {@code min <= corbaLevel <= max}
    **/
   public static boolean corbaLevel (float min, float max)
   {
--- a/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/ValueBoxGen24.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/ValueBoxGen24.java	Thu May 07 20:50:57 2015 -0700
@@ -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)
   {
@@ -121,7 +121,7 @@
   } // helperRead
 
   /**
-   * <d62023>
+   * d62023
    **/
   public void helperWrite (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/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/ValueGen24.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/com/sun/tools/corba/se/idl/toJavaPortable/ValueGen24.java	Thu May 07 20:50:57 2015 -0700
@@ -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/src/java.corba/share/classes/org/omg/CORBA/LocalObject.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/java.corba/share/classes/org/omg/CORBA/LocalObject.java	Thu May 07 20:50:57 2015 -0700
@@ -28,7 +28,7 @@
 
 
 /**
- * <P>Used as a base class for implementation of a local IDL interface in the
+ * 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.
  * <P>Local interfaces are implemented by using CORBA::LocalObject
@@ -49,9 +49,10 @@
  *  <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<P>
+ *  Volume I - orbos/99-07-01
+ *
  * @see <a href="package-summary.html#unimpl"><code>CORBA</code> package
-     *      comments for unimplemented features</a>
+ *      comments for unimplemented features</a>
  */
 
 public class LocalObject implements org.omg.CORBA.Object
@@ -64,7 +65,7 @@
     public LocalObject() {}
 
     /**
-     * <P>Determines whether the two object references are equivalent,
+     * Determines whether the two object references are equivalent,
      * so far as the ORB can easily determine. Two object references are equivalent
      * if they are identical. Two distinct object references which in fact refer to
      * the same object are also equivalent. However, ORBs are not required
--- a/src/jdk.rmic/share/classes/sun/rmi/rmic/iiop/CompoundType.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/jdk.rmic/share/classes/sun/rmi/rmic/iiop/CompoundType.java	Thu May 07 20:50:57 2015 -0700
@@ -145,15 +145,15 @@
 
     /**
      * Return true if this type implements
-     * isIDLEntity() && isException().
+     * {@code isIDLEntity() && isException()}.
      */
     public boolean isIDLEntityException () {
         return isIDLEntity() && isException();
     }
     /**
-     * Return true if isIDLEntity() && !isValueBase()
+     * Return true if {@code isIDLEntity() && !isValueBase()
      * && !isAbstractBase() && !isCORBAObject()
-     * && !isIDLEntityException().
+     * && !isIDLEntityException()}.
      */
     public boolean isBoxed () {
         return (isIDLEntity() && !isValueBase() &&
@@ -1984,7 +1984,7 @@
         }
 
         /**
-         * Return true if this is NOT a constructor && is not
+         * Return true if this is NOT a constructor {@code &&} is not
          * an attribute.
          */
         public boolean isNormalMethod () {
--- a/src/jdk.rmic/share/classes/sun/rmi/rmic/iiop/ContextStack.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/jdk.rmic/share/classes/sun/rmi/rmic/iiop/ContextStack.java	Thu May 07 20:50:57 2015 -0700
@@ -95,7 +95,7 @@
     }
 
     /**
-     * Return true if env.nerrors > 0.
+     * Return true if {@code env.nerrors > 0}.
      */
     public boolean anyErrors () {
         return env.nerrors > 0;
--- a/src/jdk.rmic/share/classes/sun/rmi/rmic/iiop/IDLGenerator.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/jdk.rmic/share/classes/sun/rmi/rmic/iiop/IDLGenerator.java	Thu May 07 20:50:57 2015 -0700
@@ -91,8 +91,8 @@
 
     /**
      * Create and return a top-level type.
-     * @param env The compiler environment.
      * @param cdef The top-level class definition.
+     * @param stack The context stack.
      * @return An RemoteType or null if is non-conforming.
      */
     protected sun.rmi.rmic.iiop.CompoundType getTopType(ClassDefinition cdef,
@@ -169,7 +169,7 @@
      * Examine and consume command line arguments.
      * @param argv The command line arguments. Ignore null
      * and unknown arguments. Set each consumed argument to null.
-     * @param error Report any errors using the main.error() methods.
+     * @param main Report any errors using the main.error() methods.
      * @return true if no errors, false otherwise.
      */
     public boolean parseArgs(String argv[], Main main) {
@@ -195,11 +195,11 @@
                     else if ( argv[i].equalsIgnoreCase( "-init" ) ) {
                         factory = false;
                         argv[i] = null;
-                }
+                    }
                     else if ( argv[i].equalsIgnoreCase( "-factory" ) ) {
                         factory = true;
                         argv[i] = null;
-            }
+                    }
                     else if ( argv[i].equalsIgnoreCase( "-idlfile" ) ) {
                         argv[i] = null;
                         if ( ++i < argv.length && argv[i] != null && !argv[i].startsWith("-") ) {
@@ -210,7 +210,7 @@
                                 argv[i] = null;
                                 ifHash.put( idlFrom,idlTo );
                                 continue nextArg;
-        }
+                            }
                         }
                         main.error("rmic.option.requires.argument", "-idlfile");
                         result = false;
@@ -403,7 +403,7 @@
      * Write the output for the given OutputFileName into the output stream.
      * (The IDL mapping for java.lang.Class is generated from
      * javax.rmi.CORBA.ClassDesc in the tools workspace)
-     * @param OutputType ot One of the items returned by getOutputTypesFor(...)
+     * @param ot One of the items returned by getOutputTypesFor(...)
      * @param alreadyChecked A set of Types which have already been checked.
      *  Intended to be passed to Type.collectMatching(filter,alreadyChecked).
      * @param p The output stream.
@@ -927,7 +927,7 @@
      * Add reference for given type avoiding duplication.
      * Sort into specials, arrays and regular references.
      * Filter out types which are not required.
-     * @param t Given Type
+     * @param ref Given Type
      * @param refHash Hashtable for type references
      * @param spcHash Hashtable for special type references
      * @param arrHash Hashtable for array references
@@ -986,7 +986,7 @@
      * Collect and filter thrown exceptions for a given pre-filtered method.
      * Keep only 'checked' exception classes minus java.rmi.RemoteException
      * and its subclasses
-     * @param method The current method
+     * @param mth The current method
      * @param excHash Hashtable containing non-duplicate thrown exceptions
      */
     protected void getExceptions(
@@ -1077,7 +1077,7 @@
      * order.
      * Non-static, non-transient fields are mapped.
      * If the type is a custom valuetype, only public fields are mapped.
-     * @param ct The current CompoundType
+     * @param t The current CompoundType
      * @return Vector containing the data fields
      */
     protected Vector getData(
@@ -1163,7 +1163,7 @@
     /**
      * Write forward reference for boxed valuetype for single dimension of IDL
      * sequence.
-     * If the dimension is <1 and the element is a CompoundType, write a
+     * If the dimension is {@literal < 1} and the element is a CompoundType, write a
      * forward declare for the element
      * @param at ArrayType for forward declare
      * @param dim The dimension to write
@@ -1276,7 +1276,7 @@
 
     /**
      * Write #includes
-     * @param incHash Hashtable loaded with Types to include
+     * @param inhHash Hashtable loaded with Types to include
      * @param p The output stream.
      */
     protected void writeInheritedIncludes(
--- a/src/jdk.rmic/share/classes/sun/rmi/rmic/iiop/Type.java	Thu May 07 10:19:31 2015 -0700
+++ b/src/jdk.rmic/share/classes/sun/rmi/rmic/iiop/Type.java	Thu May 07 20:50:57 2015 -0700
@@ -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