(kafka) branch 4.0 updated: KAFKA-18868 add the "default value" explanation to the docs of num.replica.alter.log.dirs.threads (#19038)

[chia7712]

This is an automated email from the ASF dual-hosted git repository.

chia7712 pushed a commit to branch 4.0
in repository https://gitbox.apache.org/repos/asf/kafka.git


The following commit(s) were added to refs/heads/4.0 by this push:
     new ae798f12be4 KAFKA-18868 add the "default value" explanation to the 
docs of num.replica.alter.log.dirs.threads (#19038)
ae798f12be4 is described below

commit ae798f12be4fb2f770b92d87b0986832e8fd4d82
Author: Logan Zhu <loganzh...@outlook.com>
AuthorDate: Sat Mar 1 22:37:35 2025 +0800

    KAFKA-18868 add the "default value" explanation to the docs of 
num.replica.alter.log.dirs.threads (#19038)
    
    Update the documentation for the `num.replica.alter.log.dirs.threads` 
configuration to clarify that its default value is determined by the number of 
log directories specified in the `log.dirs` configuration.
    
    Reviewers: Ken Huang <s7133...@gmail.com>, Chia-Ping Tsai 
<chia7...@gmail.com>
---
 server/src/main/java/org/apache/kafka/server/config/ServerConfigs.java | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git 
a/server/src/main/java/org/apache/kafka/server/config/ServerConfigs.java 
b/server/src/main/java/org/apache/kafka/server/config/ServerConfigs.java
index 25e821b489d..82cf9fd34bf 100644
--- a/server/src/main/java/org/apache/kafka/server/config/ServerConfigs.java
+++ b/server/src/main/java/org/apache/kafka/server/config/ServerConfigs.java
@@ -52,7 +52,8 @@ public class ServerConfigs {
     public static final String BACKGROUND_THREADS_DOC = "The number of threads 
to use for various background processing tasks";
 
     public static final String NUM_REPLICA_ALTER_LOG_DIRS_THREADS_CONFIG = 
"num.replica.alter.log.dirs.threads";
-    public static final String NUM_REPLICA_ALTER_LOG_DIRS_THREADS_DOC = "The 
number of threads that can move replicas between log directories, which may 
include disk I/O";
+    public static final String NUM_REPLICA_ALTER_LOG_DIRS_THREADS_DOC = "The 
number of threads that can move replicas between log directories, which may 
include disk I/O. " +
+            "The default value is equal to the number of directories specified 
in the <code>" + ServerLogConfigs.LOG_DIR_CONFIG + "</code> or <code>" + 
ServerLogConfigs.LOG_DIRS_CONFIG + "</code> configuration property.";
 
     public static final String REQUEST_TIMEOUT_MS_CONFIG = 
CommonClientConfigs.REQUEST_TIMEOUT_MS_CONFIG;
     public static final int REQUEST_TIMEOUT_MS_DEFAULT = 30000;