From 42c75187801173e25c1423a7576fc280b4709501 Mon Sep 17 00:00:00 2001
From: lberki <lberki@google.com>
Date: Mon, 14 Mar 2022 00:41:29 -0700
Subject: [PATCH] Explain why enabled
 CommonCommandOptions.enablePlatformSpecificOptions is unused.

RELNOTES: None.
PiperOrigin-RevId: 434392114
---
 .../google/devtools/build/lib/runtime/CommonCommandOptions.java | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/main/java/com/google/devtools/build/lib/runtime/CommonCommandOptions.java b/src/main/java/com/google/devtools/build/lib/runtime/CommonCommandOptions.java
index b481b8cff59227..006ba66192ad96 100644
--- a/src/main/java/com/google/devtools/build/lib/runtime/CommonCommandOptions.java
+++ b/src/main/java/com/google/devtools/build/lib/runtime/CommonCommandOptions.java
@@ -52,6 +52,8 @@ public class CommonCommandOptions extends OptionsBase {
       help = "No-op, being removed. See https://github.com/bazelbuild/bazel/issues/13892")
   public Void allIncompatibleChanges;
 
+  // It's by design that this field is unused: this command line option takes effect by reading its
+  // value during options parsing based on its (string) name.
   @Option(
       name = "enable_platform_specific_config",
       defaultValue = "false",