Add Javadoc

Signed-off-by: Wenhao Lin <wenhao.lin@amd.com>

src/com/xilinx/rapidwright/router/VersalClockRouting.java

@@ -237,11 +237,12 @@ public static Map<ClockRegion, Node> routeVrouteToVerticalDistributionLines(Net
     }
 
     /**
-     * Routes from a vertical distribution centroid to destination horizontal distribution lines
-     * in the clock regions provided.
+     * For each target clock region, route from the provided vertical distribution line to a
+     * horizontal distribution line that has a GLOBAL_GLK child node in this clock region.
+     * This simulates the behavior of Vivado.
      * @param clk The current clock net
      * @param crMap A map of target clock regions and their respective vertical distribution lines
-     * @return The List of nodes from the centroid to the horizontal distribution line.
+     * @return The map of target clock regions and their respective horizontal distribution lines.
      */
     public static Map<ClockRegion, Node> routeVerticalToHorizontalDistributionLines(Net clk,
                                                                                     Map<ClockRegion, Node> crMap,
@@ -377,7 +378,7 @@ public static void routeToLCBs(Net clk, Map<ClockRegion, Set<NodeWithPrevAndCost
      * @param vroute The node to start the route.
      * @param clockRegions Target clock regions.
      * @param down To indicate if it is routing to the group of top clock regions.
-     * @return A list of RouteNodes indicating the reached horizontal distribution lines.
+     * @return The map of target clock regions and their respective horizontal distribution lines.
      */
     public static Map<ClockRegion, Node> routeToHorizontalDistributionLines(Net clk,
                                                                             Node vroute,