improve docs and naming around global profiles hotness

Author: davleopo

compiler/src/jdk.graal.compiler/src/jdk/graal/compiler/phases/common/util/OptimizationUtility.java renamed to compiler/src/jdk.graal.compiler/src/jdk/graal/compiler/phases/common/util/GlobalProfilesOptimizationUtility.java

@@ -28,32 +28,51 @@
 import jdk.graal.compiler.options.Option;
 import jdk.graal.compiler.options.OptionKey;
 
-public class OptimizationUtility {
+/**
+ * Utility class for managing and applying additional optimizer benefits to "super hot" code
+ * regions.
+ *
+ * This class provides methods to identify, evaluate, and process compilation units that demonstrate
+ * exceptional runtime significance based on global profiling data. Its functions enable the
+ * optimizer to selectively apply advanced strategies and enhancements to code regions determined to
+ * be of highest execution criticality, maximizing performance gains where they matter most.
+ */
+public class GlobalProfilesOptimizationUtility {
 
     public static class Options {
         @Option(help = "Minimal self time for a compilation unit to be considered hot globally.")//
         public static final OptionKey<Double> HotCodeMinSelfTime = new OptionKey<>(0.001);
 
     }
 
-    public static <X> X chooseAdaptiveBudgetFactor(StructuredGraph graph, OptionKey<X> coldOption, OptionKey<X> hotOption) {
-        return hotGlobalSelfTime(graph) ? hotOption.getValue(graph.getOptions()) : coldOption.getValue(graph.getOptions());
+    /**
+     * Selects and returns the appropriate option value for the specified compilation unit based on
+     * its optimization significance. If the provided {@link StructuredGraph} is determined to merit
+     * prioritization for optimization - such as exhibiting high runtime significance or profiling
+     * "hotness" - the {@code hotOption} value is returned. Otherwise, the {@code coldOption} value
+     * is chosen. This selection allows the optimizer to allocate additional resources beyond
+     * regular hotness to a compilation unit.
+     */
+    public static <X> X selectOptionBySignificance(StructuredGraph graph, OptionKey<X> coldOption, OptionKey<X> hotOption) {
+        return shouldPrioritizeForOptimization(graph) ? hotOption.getValue(graph.getOptions()) : coldOption.getValue(graph.getOptions());
     }
 
-    public static <X> X chooseAdaptiveBudgetFactor(StructuredGraph graph, X coldValue, OptionKey<X> hotOption) {
-        return hotGlobalSelfTime(graph) ? hotOption.getValue(graph.getOptions()) : coldValue;
+    public static <X> X selectOptionBySignificance(StructuredGraph graph, X coldValue, OptionKey<X> hotOption) {
+        return shouldPrioritizeForOptimization(graph) ? hotOption.getValue(graph.getOptions()) : coldValue;
     }
 
-    public static <X> X chooseAdaptiveBudgetFactor(StructuredGraph graph, X coldValue, X hotValue) {
-        return hotGlobalSelfTime(graph) ? hotValue : coldValue;
+    public static <X> X selectOptionBySignificance(StructuredGraph graph, X coldValue, X hotValue) {
+        return shouldPrioritizeForOptimization(graph) ? hotValue : coldValue;
     }
 
     /**
-     * Determine if the given graph should be considered "hot" for optimization purposes. We define
-     * "hot" by inspecting its self time with respect to overall execution time. This is a purely
-     * heuristical value.
+     * Determines if the specified graph merits prioritization for optimization. This method
+     * evaluates the compilation unit's significance-based on heuristics such as self time relative
+     * to overall execution - to decide whether it should receive additional optimizer benefits.
+     * This assessment is heuristic and intended to guide the allocation of extra optimization
+     * resources.
      */
-    public static boolean hotGlobalSelfTime(StructuredGraph graph) {
+    public static boolean shouldPrioritizeForOptimization(StructuredGraph graph) {
         final double globalSelfTimePercent = graph.globalProfileProvider().getGlobalSelfTimePercent();
         if (globalSelfTimePercent == StructuredGraph.GlobalProfileProvider.GLOBAL_PROFILE_PROVIDER_DISABLED) {
             // We are in a mode where there is no self time data available. In JIT all compilation