commit f2632d898f19c6a299d92a5ebc6a35c1f9bd7099
author Googler <noreply@google.com> Tue Jul 30 11:28:50 2019 -0700
committer Copybara-Service <copybara-worker@google.com> Tue Jul 30 11:29:44 2019 -0700
tree 9a9f5acf0d296136d8a765b3388142f3d97ea0d7
parent aced9520b0f690e1944da105b6d2cfab4c6f7c91

Expose invocation_id and build_id flags in documentation

Fixes #6476

RELNOTES: None
PiperOrigin-RevId: 260758965

src/main/java/com/google/devtools/build/lib/runtime/CommonCommandOptions.java

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 f9c4029..55157e0 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
@@ -166,25 +166,25 @@
   // TODO(b/67895628) Stop reading ids from the environment after the compatibility window has
   // passed.
   @Option(
-    name = "invocation_id",
-    defaultValue = "",
-    converter = UUIDConverter.class,
-    documentationCategory = OptionDocumentationCategory.UNDOCUMENTED,
-    effectTags = {OptionEffectTag.BAZEL_MONITORING, OptionEffectTag.BAZEL_INTERNAL_CONFIGURATION},
-    metadataTags = {OptionMetadataTag.HIDDEN},
-    help = "Unique identifier for the command being run."
-  )
+      name = "invocation_id",
+      defaultValue = "",
+      converter = UUIDConverter.class,
+      documentationCategory = OptionDocumentationCategory.UNDOCUMENTED,
+      effectTags = {OptionEffectTag.BAZEL_MONITORING, OptionEffectTag.BAZEL_INTERNAL_CONFIGURATION},
+      help =
+          "Unique identifier, in UUID format, for the command being run. If explicitly specified"
+              + " uniqueness must be ensured by the caller. The UUID is printed to stderr, the BEP"
+              + " and remote execution protocol.")
   public UUID invocationId;
 
   @Option(
-    name = "build_request_id",
-    defaultValue = "",
-    converter = PrefixedUUIDConverter.class,
-    documentationCategory = OptionDocumentationCategory.UNDOCUMENTED,
-    effectTags = {OptionEffectTag.BAZEL_MONITORING, OptionEffectTag.BAZEL_INTERNAL_CONFIGURATION},
-    metadataTags = {OptionMetadataTag.HIDDEN},
-    help = "Unique identifier for the build being run."
-  )
+      name = "build_request_id",
+      defaultValue = "",
+      converter = PrefixedUUIDConverter.class,
+      documentationCategory = OptionDocumentationCategory.UNDOCUMENTED,
+      effectTags = {OptionEffectTag.BAZEL_MONITORING, OptionEffectTag.BAZEL_INTERNAL_CONFIGURATION},
+      metadataTags = {OptionMetadataTag.HIDDEN},
+      help = "Unique string identifier for the build being run.")
   public String buildRequestId;
 
   @Option(