naming and doc

Author: wangxianghu

hudi-client/hudi-client-common/src/main/java/org/apache/hudi/config/HoodieTTLConfig.java

@@ -163,8 +163,8 @@ public HoodieTTLConfig.Builder withEventTimeSegmentStartIndex(int timeSegStartIn
       return this;
     }
 
-    public HoodieTTLConfig.Builder withEventTimeDeleteHiveDefaultPartition(boolean enable) {
-      ttlConfig.setValue(EVENT_TIME_DELETE_HIVE_DEFAULT_PARTITION, Boolean.toString(enable));
+    public HoodieTTLConfig.Builder withEventTimeDeleteHiveDefaultPartition(boolean deleteHiveDefaultPartition) {
+      ttlConfig.setValue(EVENT_TIME_DELETE_HIVE_DEFAULT_PARTITION, Boolean.toString(deleteHiveDefaultPartition));
       return this;
     }
 

hudi-client/hudi-client-common/src/main/java/org/apache/hudi/table/action/ttl/strategy/KeepByEventTimeStrategy.java

@@ -199,6 +199,17 @@ static long resolveCutoffMillis(String instantTime, long ttlInMillis) {
    * the path) if the table contains partitions that don't conform to a single event-time shape.
    * <p>
    * Package-private so unit tests can exercise it directly without spinning up a HoodieTable.
+   * <p>
+   * Note the two trailing {@code boolean} flags are easy to transpose at call sites; keep them in
+   * this order: {@code deleteHiveDefaultPartition} first, {@code hiveStylePartitioning} last.
+   *
+   * @param partitionPath              the partition path to evaluate
+   * @param formatter                  formatter built from the configured event-time format
+   * @param timeSegStartIndex          0-based index of the first segment carrying the time block
+   * @param segCount                   number of segments the time block spans
+   * @param cutoffMillis               partitions with event time strictly before this are expired
+   * @param deleteHiveDefaultPartition treat a time block containing the Hive default marker as expired
+   * @param hiveStylePartitioning      whether segments carry a {@code field=value} prefix to strip
    */
   static boolean isPartitionExpiredByEventTime(String partitionPath,
                                                DateTimeFormatter formatter,