zentol closed pull request #7402: [hotfix][docs] Fulfill some empty description 
in Config Doc
URL: https://github.com/apache/flink/pull/7402
 
 
   

This is a PR merged from a forked repository.
As GitHub hides the original diff on merge, it is displayed below for
the sake of provenance:

As this is a foreign pull request (from a fork), the diff is supplied
below (as it won't show otherwise due to GitHub magic):

diff --git a/docs/_includes/generated/common_section.html 
b/docs/_includes/generated/common_section.html
index 65804db2283..1c6685b2f4c 100644
--- a/docs/_includes/generated/common_section.html
+++ b/docs/_includes/generated/common_section.html
@@ -20,7 +20,7 @@
         <tr>
             <td><h5>parallelism.default</h5></td>
             <td style="word-wrap: break-word;">1</td>
-            <td></td>
+            <td>Default parallelism for jobs.</td>
         </tr>
         <tr>
             <td><h5>taskmanager.numberOfTaskSlots</h5></td>
diff --git a/docs/_includes/generated/core_configuration.html 
b/docs/_includes/generated/core_configuration.html
index 4366e8b246f..540290045a8 100644
--- a/docs/_includes/generated/core_configuration.html
+++ b/docs/_includes/generated/core_configuration.html
@@ -25,12 +25,12 @@
         <tr>
             <td><h5>io.tmp.dirs</h5></td>
             <td style="word-wrap: break-word;">'LOCAL_DIRS' on Yarn. 
'_FLINK_TMP_DIR' on Mesos. System.getProperty("java.io.tmpdir") in 
standalone.</td>
-            <td></td>
+            <td>Directories for temporary files, separated by",", "|", or the 
system's java.io.File.pathSeparator.</td>
         </tr>
         <tr>
             <td><h5>parallelism.default</h5></td>
             <td style="word-wrap: break-word;">1</td>
-            <td></td>
+            <td>Default parallelism for jobs.</td>
         </tr>
     </tbody>
 </table>
diff --git a/docs/_includes/generated/history_server_configuration.html 
b/docs/_includes/generated/history_server_configuration.html
index 272606e2884..7691c0abe62 100644
--- a/docs/_includes/generated/history_server_configuration.html
+++ b/docs/_includes/generated/history_server_configuration.html
@@ -30,7 +30,7 @@
         <tr>
             <td><h5>historyserver.web.refresh-interval</h5></td>
             <td style="word-wrap: break-word;">10000</td>
-            <td></td>
+            <td>The refresh interval for the HistoryServer web-frontend in 
milliseconds.</td>
         </tr>
         <tr>
             <td><h5>historyserver.web.ssl.enabled</h5></td>
diff --git a/docs/_includes/generated/job_manager_configuration.html 
b/docs/_includes/generated/job_manager_configuration.html
index 99eec1dcec7..177c362fb8b 100644
--- a/docs/_includes/generated/job_manager_configuration.html
+++ b/docs/_includes/generated/job_manager_configuration.html
@@ -10,7 +10,7 @@
         <tr>
             <td><h5>jobmanager.archive.fs.dir</h5></td>
             <td style="word-wrap: break-word;">(none)</td>
-            <td></td>
+            <td>Dictionary for JobManager to store the archives of completed 
jobs.</td>
         </tr>
         <tr>
             <td><h5>jobmanager.execution.attempts-history-size</h5></td>
diff --git a/docs/_includes/generated/metric_configuration.html 
b/docs/_includes/generated/metric_configuration.html
index 420bb7f1da2..39a76cef165 100644
--- a/docs/_includes/generated/metric_configuration.html
+++ b/docs/_includes/generated/metric_configuration.html
@@ -50,12 +50,12 @@
         <tr>
             <td><h5>metrics.reporters</h5></td>
             <td style="word-wrap: break-word;">(none)</td>
-            <td></td>
+            <td>An optional list of reporter names. If configured, only 
reporters whose name matches any of the names in the list will be started. 
Otherwise, all reporters that could be found in the configuration will be 
started.</td>
         </tr>
         <tr>
             <td><h5>metrics.scope.delimiter</h5></td>
             <td style="word-wrap: break-word;">"."</td>
-            <td></td>
+            <td>Delimiter used to assemble the metric identifier.</td>
         </tr>
         <tr>
             <td><h5>metrics.scope.jm</h5></td>
@@ -90,12 +90,12 @@
         <tr>
             <td><h5>metrics.system-resource</h5></td>
             <td style="word-wrap: break-word;">false</td>
-            <td></td>
+            <td>Flag indicating whether Flink should report system resource 
metrics such as machine's CPU, memory or network usage.</td>
         </tr>
         <tr>
             <td><h5>metrics.system-resource-probing-interval</h5></td>
             <td style="word-wrap: break-word;">5000</td>
-            <td></td>
+            <td>Interval between probing of system resource metrics specified 
in milliseconds. Has an effect only when 'metrics.system-resource' is 
enabled.</td>
         </tr>
     </tbody>
 </table>
diff --git a/docs/_includes/generated/resource_manager_configuration.html 
b/docs/_includes/generated/resource_manager_configuration.html
index 9243fcd3cb9..3448aba8f52 100644
--- a/docs/_includes/generated/resource_manager_configuration.html
+++ b/docs/_includes/generated/resource_manager_configuration.html
@@ -20,7 +20,7 @@
         <tr>
             <td><h5>local.number-resourcemanager</h5></td>
             <td style="word-wrap: break-word;">1</td>
-            <td></td>
+            <td>The number of resource managers start.</td>
         </tr>
         <tr>
             <td><h5>resourcemanager.job.timeout</h5></td>
diff --git a/docs/_includes/generated/task_manager_configuration.html 
b/docs/_includes/generated/task_manager_configuration.html
index 63bfb043ea4..2093531211d 100644
--- a/docs/_includes/generated/task_manager_configuration.html
+++ b/docs/_includes/generated/task_manager_configuration.html
@@ -20,7 +20,7 @@
         <tr>
             <td><h5>task.cancellation.timers.timeout</h5></td>
             <td style="word-wrap: break-word;">7500</td>
-            <td></td>
+            <td>Time we wait for the timers in milliseconds to finish all 
pending timer threads when the stream task is cancelled.</td>
         </tr>
         <tr>
             <td><h5>task.checkpoint.alignment.max-size</h5></td>
diff --git a/docs/_includes/generated/web_configuration.html 
b/docs/_includes/generated/web_configuration.html
index dbc353dbd56..6fb35e9284e 100644
--- a/docs/_includes/generated/web_configuration.html
+++ b/docs/_includes/generated/web_configuration.html
@@ -10,77 +10,77 @@
         <tr>
             <td><h5>web.access-control-allow-origin</h5></td>
             <td style="word-wrap: break-word;">"*"</td>
-            <td></td>
+            <td>Access-Control-Allow-Origin header for all responses from the 
web-frontend.</td>
         </tr>
         <tr>
             <td><h5>web.address</h5></td>
             <td style="word-wrap: break-word;">(none)</td>
-            <td></td>
+            <td>Address for runtime monitor web-frontend server.</td>
         </tr>
         <tr>
             <td><h5>web.backpressure.cleanup-interval</h5></td>
             <td style="word-wrap: break-word;">600000</td>
-            <td></td>
+            <td>Time, in milliseconds, after which cached stats are cleaned up 
if not accessed.</td>
         </tr>
         <tr>
             <td><h5>web.backpressure.delay-between-samples</h5></td>
             <td style="word-wrap: break-word;">50</td>
-            <td></td>
+            <td>Delay between stack trace samples to determine back pressure 
in milliseconds.</td>
         </tr>
         <tr>
             <td><h5>web.backpressure.num-samples</h5></td>
             <td style="word-wrap: break-word;">100</td>
-            <td></td>
+            <td>Number of stack trace samples to take to determine back 
pressure.</td>
         </tr>
         <tr>
             <td><h5>web.backpressure.refresh-interval</h5></td>
             <td style="word-wrap: break-word;">60000</td>
-            <td></td>
+            <td>Time, in milliseconds, after which available stats are 
deprecated and need to be refreshed (by resampling).</td>
         </tr>
         <tr>
             <td><h5>web.checkpoints.history</h5></td>
             <td style="word-wrap: break-word;">10</td>
-            <td></td>
+            <td>Number of checkpoints to remember for recent history.</td>
         </tr>
         <tr>
             <td><h5>web.history</h5></td>
             <td style="word-wrap: break-word;">5</td>
-            <td></td>
+            <td>Number of archived jobs for the JobManager.</td>
         </tr>
         <tr>
             <td><h5>web.log.path</h5></td>
             <td style="word-wrap: break-word;">(none)</td>
-            <td></td>
+            <td>Path to the log file (may be in /log for standalone but under 
log directory when using YARN).</td>
         </tr>
         <tr>
             <td><h5>web.refresh-interval</h5></td>
             <td style="word-wrap: break-word;">3000</td>
-            <td></td>
+            <td>Refresh interval for the web-frontend in milliseconds.</td>
         </tr>
         <tr>
             <td><h5>web.ssl.enabled</h5></td>
             <td style="word-wrap: break-word;">true</td>
-            <td></td>
+            <td>Flag indicating whether to override SSL support for the 
JobManager Web UI.</td>
         </tr>
         <tr>
             <td><h5>web.submit.enable</h5></td>
             <td style="word-wrap: break-word;">true</td>
-            <td></td>
+            <td>Flag indicating whether jobs can be uploaded and run from the 
web-frontend.</td>
         </tr>
         <tr>
             <td><h5>web.timeout</h5></td>
             <td style="word-wrap: break-word;">10000</td>
-            <td></td>
+            <td>Timeout for asynchronous operations by the WebRuntimeMonitor 
in milliseconds.</td>
         </tr>
         <tr>
             <td><h5>web.tmpdir</h5></td>
             <td style="word-wrap: 
break-word;">System.getProperty("java.io.tmpdir")</td>
-            <td></td>
+            <td>Flink web directory which is used by the webmonitor.</td>
         </tr>
         <tr>
             <td><h5>web.upload.dir</h5></td>
             <td style="word-wrap: break-word;">(none)</td>
-            <td></td>
+            <td>Directory for uploading the job jars. If not specified a 
dynamic directory will be used under the directory specified by 
JOB_MANAGER_WEB_TMPDIR_KEY.</td>
         </tr>
     </tbody>
 </table>
diff --git 
a/flink-core/src/main/java/org/apache/flink/configuration/CoreOptions.java 
b/flink-core/src/main/java/org/apache/flink/configuration/CoreOptions.java
index 4c928fef686..a70c020e21c 100644
--- a/flink-core/src/main/java/org/apache/flink/configuration/CoreOptions.java
+++ b/flink-core/src/main/java/org/apache/flink/configuration/CoreOptions.java
@@ -216,7 +216,8 @@
        public static final ConfigOption<String> TMP_DIRS =
                key("io.tmp.dirs")
                        .defaultValue(System.getProperty("java.io.tmpdir"))
-                       .withDeprecatedKeys("taskmanager.tmp.dirs");
+                       .withDeprecatedKeys("taskmanager.tmp.dirs")
+                       .withDescription("Directories for temporary files, 
separated by\",\", \"|\", or the system's java.io.File.pathSeparator.");
 
        // 
------------------------------------------------------------------------
        //  program
@@ -225,7 +226,8 @@
        @Documentation.CommonOption(position = 
Documentation.CommonOption.POSITION_PARALLELISM_SLOTS)
        public static final ConfigOption<Integer> DEFAULT_PARALLELISM = 
ConfigOptions
                .key("parallelism.default")
-               .defaultValue(1);
+               .defaultValue(1)
+               .withDescription("Default parallelism for jobs.");
 
        // 
------------------------------------------------------------------------
        //  file systems
diff --git 
a/flink-core/src/main/java/org/apache/flink/configuration/HistoryServerOptions.java
 
b/flink-core/src/main/java/org/apache/flink/configuration/HistoryServerOptions.java
index 12e7f24697e..a4df23ce148 100644
--- 
a/flink-core/src/main/java/org/apache/flink/configuration/HistoryServerOptions.java
+++ 
b/flink-core/src/main/java/org/apache/flink/configuration/HistoryServerOptions.java
@@ -76,7 +76,8 @@
         */
        public static final ConfigOption<Long> 
HISTORY_SERVER_WEB_REFRESH_INTERVAL =
                key("historyserver.web.refresh-interval")
-                       .defaultValue(10000L);
+                       .defaultValue(10000L)
+                       .withDescription("The refresh interval for the 
HistoryServer web-frontend in milliseconds.");
 
        /**
         * Enables/Disables SSL support for the HistoryServer web-frontend. 
Only relevant if
diff --git 
a/flink-core/src/main/java/org/apache/flink/configuration/JobManagerOptions.java
 
b/flink-core/src/main/java/org/apache/flink/configuration/JobManagerOptions.java
index cb2dbe61631..a91b931d109 100644
--- 
a/flink-core/src/main/java/org/apache/flink/configuration/JobManagerOptions.java
+++ 
b/flink-core/src/main/java/org/apache/flink/configuration/JobManagerOptions.java
@@ -136,7 +136,8 @@
         */
        public static final ConfigOption<String> ARCHIVE_DIR =
                key("jobmanager.archive.fs.dir")
-                       .noDefaultValue();
+                       .noDefaultValue()
+                       .withDescription("Dictionary for JobManager to store 
the archives of completed jobs.");
 
        /**
         * The job store cache size in bytes which is used to keep completed
diff --git 
a/flink-core/src/main/java/org/apache/flink/configuration/MetricOptions.java 
b/flink-core/src/main/java/org/apache/flink/configuration/MetricOptions.java
index 0785b347335..2c22d926da4 100644
--- a/flink-core/src/main/java/org/apache/flink/configuration/MetricOptions.java
+++ b/flink-core/src/main/java/org/apache/flink/configuration/MetricOptions.java
@@ -47,7 +47,10 @@
         */
        public static final ConfigOption<String> REPORTERS_LIST =
                key("metrics.reporters")
-                       .noDefaultValue();
+                       .noDefaultValue()
+                       .withDescription("An optional list of reporter names. 
If configured, only reporters whose name matches" +
+                               " any of the names in the list will be started. 
Otherwise, all reporters that could be found in" +
+                               " the configuration will be started.");
 
        public static final ConfigOption<String> REPORTER_CLASS =
                key("metrics.reporter.<name>.class")
@@ -68,7 +71,8 @@
        /** The delimiter used to assemble the metric identifier. */
        public static final ConfigOption<String> SCOPE_DELIMITER =
                key("metrics.scope.delimiter")
-                       .defaultValue(".");
+                       .defaultValue(".")
+                       .withDescription("Delimiter used to assemble the metric 
identifier.");
 
        /** The scope format string that is applied to all metrics scoped to a 
JobManager. */
        public static final ConfigOption<String> SCOPE_NAMING_JM =
@@ -135,14 +139,18 @@
         */
        public static final ConfigOption<Boolean> SYSTEM_RESOURCE_METRICS =
                key("metrics.system-resource")
-                       .defaultValue(false);
+                       .defaultValue(false)
+                       .withDescription("Flag indicating whether Flink should 
report system resource metrics such as machine's CPU," +
+                               " memory or network usage.");
        /**
         * Interval between probing of system resource metrics specified in 
milliseconds. Has an effect only when
         * {@link #SYSTEM_RESOURCE_METRICS} is enabled.
         */
        public static final ConfigOption<Long> 
SYSTEM_RESOURCE_METRICS_PROBING_INTERVAL =
                key("metrics.system-resource-probing-interval")
-                       .defaultValue(5000L);
+                       .defaultValue(5000L)
+                       .withDescription("Interval between probing of system 
resource metrics specified in milliseconds. Has an effect" +
+                               " only when '" + SYSTEM_RESOURCE_METRICS.key() 
+ "' is enabled.");
 
        /**
         * The default network port range for Flink's internal metric query 
service. The {@code "0"} means that
diff --git 
a/flink-core/src/main/java/org/apache/flink/configuration/ResourceManagerOptions.java
 
b/flink-core/src/main/java/org/apache/flink/configuration/ResourceManagerOptions.java
index 5a203e3372b..ca6cc146123 100644
--- 
a/flink-core/src/main/java/org/apache/flink/configuration/ResourceManagerOptions.java
+++ 
b/flink-core/src/main/java/org/apache/flink/configuration/ResourceManagerOptions.java
@@ -35,10 +35,19 @@
                .defaultValue("5 minutes")
                .withDescription("Timeout for jobs which don't have a job 
manager as leader assigned.");
 
+       /**
+        * The number of resource managers start.
+        */
        public static final ConfigOption<Integer> LOCAL_NUMBER_RESOURCE_MANAGER 
= ConfigOptions
                .key("local.number-resourcemanager")
-               .defaultValue(1);
+               .defaultValue(1)
+               .withDescription("The number of resource managers start.");
 
+       /**
+        * Defines the network port to connect to for communication with the 
resource manager.
+        * By default, the port of the JobManager, because the same ActorSystem 
is used. Its not
+        * possible to use this configuration key to define port ranges.
+        */
        public static final ConfigOption<Integer> IPC_PORT = ConfigOptions
                .key("resourcemanager.rpc.port")
                .defaultValue(0)
diff --git 
a/flink-core/src/main/java/org/apache/flink/configuration/TaskManagerOptions.java
 
b/flink-core/src/main/java/org/apache/flink/configuration/TaskManagerOptions.java
index 6d3ac4515b2..6844ee4cd48 100644
--- 
a/flink-core/src/main/java/org/apache/flink/configuration/TaskManagerOptions.java
+++ 
b/flink-core/src/main/java/org/apache/flink/configuration/TaskManagerOptions.java
@@ -375,13 +375,15 @@
                                " leads to a fatal TaskManager error. A value 
of 0 deactivates" +
                                " the watch dog.");
        /**
-        * This configures how long we wait for the timers to finish all 
pending timer threads
-        * when the stream task is cancelled .
+        * This configures how long we wait for the timers in milliseconds to 
finish all pending timer threads
+        * when the stream task is cancelled.
         */
        public static final ConfigOption<Long> TASK_CANCELLATION_TIMEOUT_TIMERS 
= ConfigOptions
                        .key("task.cancellation.timers.timeout")
                        .defaultValue(7500L)
-                       
.withDeprecatedKeys("timerservice.exceptional.shutdown.timeout");
+                       
.withDeprecatedKeys("timerservice.exceptional.shutdown.timeout")
+                       .withDescription("Time we wait for the timers in 
milliseconds to finish all pending timer threads" +
+                               " when the stream task is cancelled.");
 
        /**
         * The maximum number of bytes that a checkpoint alignment may buffer.
diff --git 
a/flink-core/src/main/java/org/apache/flink/configuration/WebOptions.java 
b/flink-core/src/main/java/org/apache/flink/configuration/WebOptions.java
index 6d0a6ec9e93..ba341619051 100644
--- a/flink-core/src/main/java/org/apache/flink/configuration/WebOptions.java
+++ b/flink-core/src/main/java/org/apache/flink/configuration/WebOptions.java
@@ -35,7 +35,8 @@
        public static final ConfigOption<String> ADDRESS =
                key("web.address")
                        .noDefaultValue()
-                       .withDeprecatedKeys("jobmanager.web.address");
+                       .withDeprecatedKeys("jobmanager.web.address")
+                       .withDescription("Address for runtime monitor 
web-frontend server.");
 
        /**
         * The port for the runtime monitor web-frontend server.
@@ -55,15 +56,17 @@
        public static final ConfigOption<String> ACCESS_CONTROL_ALLOW_ORIGIN =
                key("web.access-control-allow-origin")
                        .defaultValue("*")
-                       
.withDeprecatedKeys("jobmanager.web.access-control-allow-origin");
+                       
.withDeprecatedKeys("jobmanager.web.access-control-allow-origin")
+                       .withDescription("Access-Control-Allow-Origin header 
for all responses from the web-frontend.");
 
        /**
-        * The config parameter defining the refresh interval for the 
web-frontend.
+        * The config parameter defining the refresh interval for the 
web-frontend in milliseconds.
         */
        public static final ConfigOption<Long> REFRESH_INTERVAL =
                key("web.refresh-interval")
                        .defaultValue(3000L)
-                       .withDeprecatedKeys("jobmanager.web.refresh-interval");
+                       .withDeprecatedKeys("jobmanager.web.refresh-interval")
+                       .withDescription("Refresh interval for the web-frontend 
in milliseconds.");
 
        /**
         * Config parameter to override SSL support for the JobManager Web UI.
@@ -71,7 +74,8 @@
        public static final ConfigOption<Boolean> SSL_ENABLED =
                key("web.ssl.enabled")
                        .defaultValue(true)
-                       .withDeprecatedKeys("jobmanager.web.ssl.enabled");
+                       .withDeprecatedKeys("jobmanager.web.ssl.enabled")
+                       .withDescription("Flag indicating whether to override 
SSL support for the JobManager Web UI.");
 
        /**
         * The config parameter defining the flink web directory to be used by 
the webmonitor.
@@ -80,7 +84,8 @@
        public static final ConfigOption<String> TMP_DIR =
                key("web.tmpdir")
                        .defaultValue(System.getProperty("java.io.tmpdir"))
-                       .withDeprecatedKeys("jobmanager.web.tmpdir");
+                       .withDeprecatedKeys("jobmanager.web.tmpdir")
+                       .withDescription("Flink web directory which is used by 
the webmonitor.");
 
        /**
         * The config parameter defining the directory for uploading the job 
jars. If not specified a dynamic directory
@@ -89,15 +94,18 @@
        public static final ConfigOption<String> UPLOAD_DIR =
                key("web.upload.dir")
                        .noDefaultValue()
-                       .withDeprecatedKeys("jobmanager.web.upload.dir");
+                       .withDeprecatedKeys("jobmanager.web.upload.dir")
+                       .withDescription("Directory for uploading the job jars. 
If not specified a dynamic directory will be used" +
+                               " under the directory specified by 
JOB_MANAGER_WEB_TMPDIR_KEY.");
 
        /**
-        * The config parameter defining the number of archived jobs for the 
jobmanager.
+        * The config parameter defining the number of archived jobs for the 
JobManager.
         */
        public static final ConfigOption<Integer> ARCHIVE_COUNT =
                key("web.history")
                        .defaultValue(5)
-                       .withDeprecatedKeys("jobmanager.web.history");
+                       .withDeprecatedKeys("jobmanager.web.history")
+                       .withDescription("Number of archived jobs for the 
JobManager.");
 
        /**
         * The log file location (may be in /log for standalone but under log 
directory when using YARN).
@@ -105,7 +113,8 @@
        public static final ConfigOption<String> LOG_PATH =
                key("web.log.path")
                        .noDefaultValue()
-                       .withDeprecatedKeys("jobmanager.web.log.path");
+                       .withDeprecatedKeys("jobmanager.web.log.path")
+                       .withDescription("Path to the log file (may be in /log 
for standalone but under log directory when using YARN).");
 
        /**
         * Config parameter indicating whether jobs can be uploaded and run 
from the web-frontend.
@@ -113,7 +122,8 @@
        public static final ConfigOption<Boolean> SUBMIT_ENABLE =
                key("web.submit.enable")
                        .defaultValue(true)
-                       .withDeprecatedKeys("jobmanager.web.submit.enable");
+                       .withDeprecatedKeys("jobmanager.web.submit.enable")
+                       .withDescription("Flag indicating whether jobs can be 
uploaded and run from the web-frontend.");
 
        /**
         * Config parameter defining the number of checkpoints to remember for 
recent history.
@@ -121,23 +131,27 @@
        public static final ConfigOption<Integer> CHECKPOINTS_HISTORY_SIZE =
                key("web.checkpoints.history")
                        .defaultValue(10)
-                       
.withDeprecatedKeys("jobmanager.web.checkpoints.history");
+                       
.withDeprecatedKeys("jobmanager.web.checkpoints.history")
+                       .withDescription("Number of checkpoints to remember for 
recent history.");
 
        /**
-        * Time after which cached stats are cleaned up if not accessed.
+        * Time, in milliseconds, after which cached stats are cleaned up if 
not accessed.
         */
        public static final ConfigOption<Integer> BACKPRESSURE_CLEANUP_INTERVAL 
=
                key("web.backpressure.cleanup-interval")
                        .defaultValue(10 * 60 * 1000)
-                       
.withDeprecatedKeys("jobmanager.web.backpressure.cleanup-interval");
+                       
.withDeprecatedKeys("jobmanager.web.backpressure.cleanup-interval")
+                       .withDescription("Time, in milliseconds, after which 
cached stats are cleaned up if not accessed.");
 
        /**
-        * Time after which available stats are deprecated and need to be 
refreshed (by resampling).
+        * Time, in milliseconds, after which available stats are deprecated 
and need to be refreshed (by resampling).
         */
        public static final ConfigOption<Integer> BACKPRESSURE_REFRESH_INTERVAL 
=
                key("web.backpressure.refresh-interval")
                        .defaultValue(60 * 1000)
-                       
.withDeprecatedKeys("jobmanager.web.backpressure.refresh-interval");
+                       
.withDeprecatedKeys("jobmanager.web.backpressure.refresh-interval")
+                       .withDescription("Time, in milliseconds, after which 
available stats are deprecated and need to be refreshed" +
+                               " (by resampling).");
 
        /**
         * Number of stack trace samples to take to determine back pressure.
@@ -145,22 +159,25 @@
        public static final ConfigOption<Integer> BACKPRESSURE_NUM_SAMPLES =
                key("web.backpressure.num-samples")
                        .defaultValue(100)
-                       
.withDeprecatedKeys("jobmanager.web.backpressure.num-samples");
+                       
.withDeprecatedKeys("jobmanager.web.backpressure.num-samples")
+                       .withDescription("Number of stack trace samples to take 
to determine back pressure.");
 
        /**
-        * Delay between stack trace samples to determine back pressure.
+        * Delay between stack trace samples to determine back pressure in 
milliseconds.
         */
        public static final ConfigOption<Integer> BACKPRESSURE_DELAY =
                key("web.backpressure.delay-between-samples")
                        .defaultValue(50)
-                       
.withDeprecatedKeys("jobmanager.web.backpressure.delay-between-samples");
+                       
.withDeprecatedKeys("jobmanager.web.backpressure.delay-between-samples")
+                       .withDescription("Delay between stack trace samples to 
determine back pressure in milliseconds.");
 
        /**
         * Timeout for asynchronous operations by the WebRuntimeMonitor in 
milliseconds.
         */
        public static final ConfigOption<Long> TIMEOUT =
                key("web.timeout")
-               .defaultValue(10L * 1000L);
+               .defaultValue(10L * 1000L)
+               .withDescription("Timeout for asynchronous operations by the 
WebRuntimeMonitor in milliseconds.");
 
        // 
------------------------------------------------------------------------
 


 

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
[email protected]


With regards,
Apache Git Services

Reply via email to