8342825: Fix order of @param tags in module java.desktop

Reviewed-by: prr

Author: hns

src/java.desktop/share/classes/java/awt/BorderLayout.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1995, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1995, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -554,12 +554,12 @@ public Component getLayoutComponent(Object constraints) {
      * The {@code Container}'s component orientation is used to determine the location of components
      * added with {@code LINE_START} and {@code LINE_END}.
      *
-     * @param   constraints     the desired absolute position, one of {@code CENTER},
-     *                          {@code NORTH}, {@code SOUTH},
-     *                          {@code EAST}, {@code WEST}
      * @param   target     the {@code Container} used to obtain
      *                     the constraint location based on the target
      *                     {@code Container}'s component orientation.
+     * @param   constraints     the desired absolute position, one of {@code CENTER},
+     *                          {@code NORTH}, {@code SOUTH},
+     *                          {@code EAST}, {@code WEST}
      * @return  the component at the given location, or {@code null} if
      *          the location is empty
      * @throws   IllegalArgumentException  if the constraint object is

src/java.desktop/share/classes/java/awt/Graphics2D.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -564,9 +564,9 @@ public abstract boolean drawImage(Image img,
      * img1 = op.filter(img, null);
      * drawImage(img1, new AffineTransform(1f,0f,0f,1f,x,y), null);
      * </pre>
-     * @param op the filter to be applied to the image before rendering
      * @param img the specified {@code BufferedImage} to be rendered.
      *            This method does nothing if {@code img} is null.
+     * @param op the filter to be applied to the image before rendering
      * @param x the x coordinate of the location in user space where
      * the upper left corner of the image is rendered
      * @param y the y coordinate of the location in user space where

src/java.desktop/share/classes/java/awt/dnd/DragSource.java

@@ -499,8 +499,8 @@ protected DragSourceContext createDragSourceContext(DragGestureEvent dgl,
      *
      * @param <T> the type of {@code DragGestureRecognizer} to create
      * @param recognizerAbstractClass the requested abstract type
-     * @param actions                 the permitted source drag actions
      * @param c                       the {@code Component} target
+     * @param actions                 the permitted source drag actions
      * @param dgl        the {@code DragGestureListener} to notify
      *
      * @return the new {@code DragGestureRecognizer} or {@code null}

src/java.desktop/share/classes/java/awt/event/ActionEvent.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -206,13 +206,13 @@ public ActionEvent(Object source, int id, String command, int modifiers) {
      *                     the class description for {@link ActionEvent}
      * @param command A string that may specify a command (possibly one
      *                of several) associated with the event
+     * @param when   A long that gives the time the event occurred.
+     *               Passing negative or zero value
+     *               is not recommended
      * @param modifiers The modifier keys down during event
      *                  (shift, ctrl, alt, meta).
      *                  Passing negative parameter is not recommended.
      *                  Zero value means that no modifiers were passed
-     * @param when   A long that gives the time the event occurred.
-     *               Passing negative or zero value
-     *               is not recommended
      * @throws IllegalArgumentException if {@code source} is null
      * @see #getSource()
      * @see #getID()

src/java.desktop/share/classes/java/awt/geom/AffineTransform.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1996, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1996, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -2964,10 +2964,10 @@ public Point2D transform(Point2D ptSrc, Point2D ptDst) {
      * the original coordinates in that point are overwritten before
      * they can be converted.
      * @param ptSrc the array containing the source point objects
-     * @param ptDst the array into which the transform point objects are
-     * returned
      * @param srcOff the offset to the first point object to be
      * transformed in the source array
+     * @param ptDst the array into which the transform point objects are
+     * returned
      * @param dstOff the offset to the location of the first
      * transformed point object that is stored in the destination array
      * @param numPts the number of point objects to be transformed
@@ -3038,11 +3038,11 @@ public void transform(Point2D[] ptSrc, int srcOff,
      * offset in the order {@code [x0, y0, x1, y1, ..., xn, yn]}.
      * @param srcPts the array containing the source point coordinates.
      * Each point is stored as a pair of x, y coordinates.
+     * @param srcOff the offset to the first point to be transformed
+     * in the source array
      * @param dstPts the array into which the transformed point coordinates
      * are returned.  Each point is stored as a pair of x, y
      * coordinates.
-     * @param srcOff the offset to the first point to be transformed
-     * in the source array
      * @param dstOff the offset to the location of the first
      * transformed point that is stored in the destination array
      * @param numPts the number of points to be transformed
@@ -3153,11 +3153,11 @@ public void transform(float[] srcPts, int srcOff,
      * offset in the order {@code [x0, y0, x1, y1, ..., xn, yn]}.
      * @param srcPts the array containing the source point coordinates.
      * Each point is stored as a pair of x, y coordinates.
+     * @param srcOff the offset to the first point to be transformed
+     * in the source array
      * @param dstPts the array into which the transformed point
      * coordinates are returned.  Each point is stored as a pair of
      * x, y coordinates.
-     * @param srcOff the offset to the first point to be transformed
-     * in the source array
      * @param dstOff the offset to the location of the first
      * transformed point that is stored in the destination array
      * @param numPts the number of point objects to be transformed
@@ -3264,11 +3264,11 @@ public void transform(double[] srcPts, int srcOff,
      * offset in the order {@code [x0, y0, x1, y1, ..., xn, yn]}.
      * @param srcPts the array containing the source point coordinates.
      * Each point is stored as a pair of x, y coordinates.
+     * @param srcOff the offset to the first point to be transformed
+     * in the source array
      * @param dstPts the array into which the transformed point coordinates
      * are returned.  Each point is stored as a pair of x, y
      * coordinates.
-     * @param srcOff the offset to the first point to be transformed
-     * in the source array
      * @param dstOff the offset to the location of the first
      * transformed point that is stored in the destination array
      * @param numPts the number of points to be transformed
@@ -3360,11 +3360,11 @@ public void transform(float[] srcPts, int srcOff,
      * offset in the order {@code [x0, y0, x1, y1, ..., xn, yn]}.
      * @param srcPts the array containing the source point coordinates.
      * Each point is stored as a pair of x, y coordinates.
+     * @param srcOff the offset to the first point to be transformed
+     * in the source array
      * @param dstPts the array into which the transformed point
      * coordinates are returned.  Each point is stored as a pair of
      * x, y coordinates.
-     * @param srcOff the offset to the first point to be transformed
-     * in the source array
      * @param dstOff the offset to the location of the first
      * transformed point that is stored in the destination array
      * @param numPts the number of point objects to be transformed
@@ -3542,11 +3542,11 @@ public Point2D inverseTransform(Point2D ptSrc, Point2D ptDst)
      * offset in the order {@code [x0, y0, x1, y1, ..., xn, yn]}.
      * @param srcPts the array containing the source point coordinates.
      * Each point is stored as a pair of x, y coordinates.
+     * @param srcOff the offset to the first point to be transformed
+     * in the source array
      * @param dstPts the array into which the transformed point
      * coordinates are returned.  Each point is stored as a pair of
      * x, y coordinates.
-     * @param srcOff the offset to the first point to be transformed
-     * in the source array
      * @param dstOff the offset to the location of the first
      * transformed point that is stored in the destination array
      * @param numPts the number of point objects to be transformed
@@ -3755,11 +3755,11 @@ public Point2D deltaTransform(Point2D ptSrc, Point2D ptDst) {
      * offset in the order {@code [x0, y0, x1, y1, ..., xn, yn]}.
      * @param srcPts the array containing the source distance vectors.
      * Each vector is stored as a pair of relative x, y coordinates.
+     * @param srcOff the offset to the first vector to be transformed
+     * in the source array
      * @param dstPts the array into which the transformed distance vectors
      * are returned.  Each vector is stored as a pair of relative
      * x, y coordinates.
-     * @param srcOff the offset to the first vector to be transformed
-     * in the source array
      * @param dstOff the offset to the location of the first
      * transformed vector that is stored in the destination array
      * @param numPts the number of vector coordinate pairs to be

src/java.desktop/share/classes/javax/imageio/metadata/IIOMetadataFormatImpl.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2000, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2000, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -378,10 +378,10 @@ protected void addElement(String elementName,
      * Adds an existing element to the list of legal children for a
      * given parent node type.
      *
-     * @param parentName the name of the element that will be the
-     * new parent of the element.
      * @param elementName the name of the element to be added as a
      * child.
+     * @param parentName the name of the element that will be the
+     * new parent of the element.
      *
      * @throws IllegalArgumentException if {@code elementName}
      * is {@code null}, or is not a legal element name for this

src/java.desktop/share/classes/javax/swing/GroupLayout.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2006, 2023, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2006, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -1777,9 +1777,9 @@ public SequentialGroup addGroup(Group group) {
         /**
          * Adds a {@code Group} to this {@code Group}.
          *
-         * @param group the {@code Group} to add
          * @param useAsBaseline whether the specified {@code Group} should
          *        be used to calculate the baseline for this {@code Group}
+         * @param group the {@code Group} to add
          * @return this {@code Group}
          */
         public SequentialGroup addGroup(boolean useAsBaseline, Group group) {
@@ -2528,8 +2528,8 @@ public ParallelGroup addGroup(Alignment alignment, Group group) {
          * Adds a {@code Component} to this {@code ParallelGroup} with
          * the specified alignment.
          *
-         * @param alignment the alignment
          * @param component the {@code Component} to add
+         * @param alignment the alignment
          * @return this {@code Group}
          * @throws IllegalArgumentException if {@code alignment} is
          *         {@code null}
@@ -2544,8 +2544,8 @@ public ParallelGroup addComponent(Component component,
          * Adds a {@code Component} to this {@code ParallelGroup} with the
          * specified alignment and size.
          *
-         * @param alignment the alignment
          * @param component the {@code Component} to add
+         * @param alignment the alignment
          * @param min the minimum size
          * @param pref the preferred size
          * @param max the maximum size

src/java.desktop/share/classes/javax/swing/LayoutStyle.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2005, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -165,13 +165,13 @@ public LayoutStyle() {
      * @param component1 the <code>JComponent</code>
      *               <code>component2</code> is being placed relative to
      * @param component2 the <code>JComponent</code> being placed
+     * @param type how the two components are being placed
      * @param position the position <code>component2</code> is being placed
      *        relative to <code>component1</code>; one of
      *        <code>SwingConstants.NORTH</code>,
      *        <code>SwingConstants.SOUTH</code>,
      *        <code>SwingConstants.EAST</code> or
      *        <code>SwingConstants.WEST</code>
-     * @param type how the two components are being placed
      * @param parent the parent of <code>component2</code>; this may differ
      *        from the actual parent and it may be <code>null</code>
      * @return the amount of space to place between the two components

src/java.desktop/share/classes/javax/swing/ProgressMonitorInputStream.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -73,10 +73,10 @@ public class ProgressMonitorInputStream extends FilterInputStream
     /**
      * Constructs an object to monitor the progress of an input stream.
      *
-     * @param message Descriptive text to be placed in the dialog box
-     *                if one is popped up.
      * @param parentComponent The component triggering the operation
      *                        being monitored.
+     * @param message Descriptive text to be placed in the dialog box
+     *                if one is popped up.
      * @param in The input stream to be monitored.
      */
     public ProgressMonitorInputStream(Component parentComponent,

src/java.desktop/share/classes/javax/swing/text/PlainView.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2021, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2024, Oracle and/or its affiliates. All rights reserved.
  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
  *
  * This code is free software; you can redistribute it and/or modify it
@@ -724,12 +724,12 @@ protected void updateDamage(DocumentEvent changes, Shape a, ViewFactory f) {
     /**
      * Repaint the given line range.
      *
-     * @param host the component hosting the view (used to call repaint)
-     * @param a  the region allocated for the view to render into
      * @param line0 the starting line number to repaint.  This must
      *   be a valid line number in the model.
      * @param line1 the ending line number to repaint.  This must
      *   be a valid line number in the model.
+     * @param a  the region allocated for the view to render into
+     * @param host the component hosting the view (used to call repaint)
      * @since 1.4
      */
     protected void damageLineRange(int line0, int line1, Shape a, Component host) {