8331879: Clean up non-standard use of /// comments in java.base

Reviewed-by: naoto, iris, darcy

src/java.base/share/classes/sun/invoke/util/ValueConversions.java

@@ -65,7 +65,7 @@ public class ValueConversions {
         return caches;
     }
 
-    /// Converting references to values.
+    //--- Converting references to values.
 
     // There are several levels of this unboxing conversions:
     //   no conversions:  exactly Integer.valueOf, etc.
@@ -222,7 +222,7 @@ public class ValueConversions {
 
     private static final Integer ZERO_INT = 0, ONE_INT = 1;
 
-    /// Primitive conversions
+    //--- Primitive conversions
     /**
      * Produce a Number which represents the given value {@code x}
      * according to the primitive type of the given wrapper {@code wrap}.
@@ -274,7 +274,7 @@ public class ValueConversions {
             return (int) x;
     }
 
-    /// Converting primitives to references
+    //--- Converting primitives to references
 
     static Integer boxInteger(int x) {
         return x;
@@ -336,7 +336,7 @@ public class ValueConversions {
         throw new IllegalArgumentException("cannot find box adapter for " + wrap);
     }
 
-    /// Constant functions
+    //--- Constant functions
 
     static void ignore(Object x) {
         // no value to return; this is an unbox of null
@@ -360,7 +360,7 @@ public class ValueConversions {
     }
 
 
-    /// Primitive conversions.
+    //--- Primitive conversions.
     // These are supported directly by the JVM, usually by a single instruction.
     // In the case of narrowing to a subword, there may be a pair of instructions.
     // In the case of booleans, there may be a helper routine to manage a 1-bit value.

src/java.base/share/classes/sun/invoke/util/Wrapper.java

@@ -128,7 +128,7 @@ public enum Wrapper {
         static int other(int slots)   { return slots << SLOT_SHIFT; }
     }
 
-    /// format queries:
+    //--- format queries:
 
     /** How many bits are in the wrapped value?  Returns 0 for OBJECT or VOID. */
     public int     bitWidth()      { return (format >> Format.SIZE_SHIFT) & Format.SIZE_MASK; }

src/java.base/share/classes/sun/util/BuddhistCalendar.java

@@ -35,18 +35,18 @@ import sun.util.locale.provider.CalendarDataUtility;
 
 public class BuddhistCalendar extends GregorianCalendar {
 
-//////////////////
+//----------------
 // Class Variables
-//////////////////
+//----------------
 
     @java.io.Serial
     private static final long serialVersionUID = -8527488697350388578L;
 
     private static final int BUDDHIST_YEAR_OFFSET = 543;
 
-///////////////
+//-------------
 // Constructors
-///////////////
+//-------------
 
     /**
      * Constructs a default BuddhistCalendar using the current time
@@ -84,9 +84,9 @@ public class BuddhistCalendar extends GregorianCalendar {
         super(zone, aLocale);
     }
 
-/////////////////
+//---------------
 // Public methods
-/////////////////
+//---------------
 
     /**
      * Returns {@code "buddhist"} as the calendar type of this Calendar.

src/java.base/share/classes/sun/util/calendar/CalendarSystem.java

@@ -67,7 +67,7 @@ import java.util.concurrent.ConcurrentMap;
 
 public abstract sealed class CalendarSystem permits AbstractCalendar {
 
-    /////////////////////// Calendar Factory Methods /////////////////////////
+    //--------------------- Calendar Factory Methods -------------------------
 
     private static volatile boolean initialized;
 
@@ -173,7 +173,7 @@ public abstract sealed class CalendarSystem permits AbstractCalendar {
         return (cs == null) ? cal : cs;
     }
 
-    //////////////////////////////// Calendar API //////////////////////////////////
+    //------------------------------ Calendar API ----------------------------------
 
     /**
      * Returns the name of this calendar system.