From 7e9df2efd0748edce104d203b88480bbf4b27a88 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Fri, 26 Jun 2026 16:26:20 +0000 Subject: [PATCH] chore: update documentation from upstream Bazel repo [skip ci] Synchronized pre-converted MDX files from upstream Bazel repository. --- reference/be/protocol-buffer.mdx | 8 ++- reference/command-line-reference.mdx | 58 ++++++++++++++----- reference/test-encyclopedia.mdx | 2 +- upstream | 2 +- .../7.6.1/reference/test-encyclopedia.mdx | 2 +- .../7.7.1/reference/test-encyclopedia.mdx | 2 +- .../8.0.1/reference/test-encyclopedia.mdx | 2 +- .../8.1.1/reference/test-encyclopedia.mdx | 2 +- .../8.2.1/reference/test-encyclopedia.mdx | 2 +- .../8.3.1/reference/test-encyclopedia.mdx | 2 +- .../8.4.2/reference/test-encyclopedia.mdx | 2 +- .../8.5.1/reference/test-encyclopedia.mdx | 2 +- .../8.6.0/reference/test-encyclopedia.mdx | 2 +- .../8.7.0/reference/test-encyclopedia.mdx | 2 +- .../9.0.0/reference/test-encyclopedia.mdx | 2 +- .../9.1.0/reference/test-encyclopedia.mdx | 2 +- 16 files changed, 63 insertions(+), 31 deletions(-) diff --git a/reference/be/protocol-buffer.mdx b/reference/be/protocol-buffer.mdx index 56674087..65bf8114 100644 --- a/reference/be/protocol-buffer.mdx +++ b/reference/be/protocol-buffer.mdx @@ -14,7 +14,7 @@ title: 'Protocol Buffer Rules' ## cc_proto_library -[View rule sourceopen_in_new](https://github.com/protocolbuffers/protobuf/tree/v29.0-rc2/bazel/private/oss/cc_proto_library.bzl) +[View rule sourceopen_in_new](https://github.com/protocolbuffers/protobuf/tree/v29.0-rc2/bazel/private/bazel_cc_proto_library.bzl) ``` cc_proto_library(name, deps, aspect_hints, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, package_metadata, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility) @@ -88,7 +88,7 @@ proto_library( ## java_proto_library -[View rule sourceopen_in_new](https://github.com/protocolbuffers/protobuf/tree/v29.0-rc2/bazel/private/java_proto_library.bzl) +[View rule sourceopen_in_new](https://github.com/protocolbuffers/protobuf/tree/v29.0-rc2/bazel/private/bazel_java_proto_library_rule.bzl) ``` java_proto_library(name, deps, aspect_hints, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, licenses, package_metadata, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility) @@ -171,7 +171,7 @@ Recommended code organization: ## py_proto_library -[View rule sourceopen_in_new](https://github.com/protocolbuffers/protobuf/tree/v29.0-rc2/bazel/private/oss/py_proto_library.bzl) +[View rule sourceopen_in_new](https://github.com/protocolbuffers/protobuf/tree/v29.0-rc2/bazel/py_proto_library.bzl) ``` py_proto_library(name, deps, aspect_hints, compatible_with, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, package_metadata, restricted_to, tags, target_compatible_with, testonly, toolchains, visibility) @@ -212,6 +212,8 @@ srcs = ["foo.proto"], proto_lang_toolchain(name, allowlist_different_package, aspect_hints, blacklisted_protos, command_line, compatible_with, denylisted_protos, deprecation, exec_compatible_with, exec_group_compatible_with, exec_properties, features, mnemonic, output_files, package_metadata, plugin, plugin_format_flag, progress_message, protoc_minimal_do_not_use, restricted_to, runtime, tags, target_compatible_with, testonly, toolchain_type, toolchains, visibility) ``` +If using Bazel, please load the rule from https://github.com/bazelbuild/rules_proto. + Specifies how a LANG_proto_library rule (e.g., `java_proto_library`) should invoke the proto-compiler. Some LANG_proto_library rules allow specifying which toolchain to use using command-line flags; diff --git a/reference/command-line-reference.mdx b/reference/command-line-reference.mdx index e6ffcfa2..6876dfa4 100644 --- a/reference/command-line-reference.mdx +++ b/reference/command-line-reference.mdx @@ -162,12 +162,6 @@ Options that appear before the command and are parsed by the client: Tags: [`bazel_monitoring`](#effect_tag_BAZEL_MONITORING), [`execution`](#effect_tag_EXECUTION) -`--[no]experimental_use_compact_object_headers` default: "true" -: Use compact object headers in the JVM. Enabled by default for Bazel when using the embedded JDK. This can reduce memory usage by 5-7%. - - Tags: - [`bazel_internal_configuration`](#effect_tag_BAZEL_INTERNAL_CONFIGURATION), [`host_machine_resource_optimizations`](#effect_tag_HOST_MACHINE_RESOURCE_OPTIMIZATIONS) - `--extra_classpath=` default: "" : A colon-separated list of classpath entries to be added to the classpath of the Bazel server. @@ -541,17 +535,17 @@ This option affects semantics of the Starlark language or the build API accessib Tags: [`build_file_semantics`](#effect_tag_BUILD_FILE_SEMANTICS), [`loading_and_analysis`](#effect_tag_LOADING_AND_ANALYSIS), [`experimental`](#metadata_tag_EXPERIMENTAL) -`--[no]experimental_dormant_deps` default: "false" -: If set to true, attr.label(materializer=), attr(for_dependency_resolution=), attr.dormant_label(), attr.dormant_label_list() and rule(for_dependency_resolution=) are allowed. +`--[no]experimental_disable_external_package` default: "false" +: If set to true, the auto-generated //external package will not be available anymore. Bazel will still be unable to parse the file 'external/BUILD', but globs reaching into external/ from the unnamed package will work. Tags: - [`build_file_semantics`](#effect_tag_BUILD_FILE_SEMANTICS), [`experimental`](#metadata_tag_EXPERIMENTAL) + [`loading_and_analysis`](#effect_tag_LOADING_AND_ANALYSIS), [`loses_incremental_state`](#effect_tag_LOSES_INCREMENTAL_STATE), [`experimental`](#metadata_tag_EXPERIMENTAL) -`--[no]experimental_enable_android_migration_apis` default: "false" -: If set to true, enables the APIs required to support the Android Starlark migration. +`--[no]experimental_dormant_deps` default: "false" +: If set to true, attr.label(materializer=), attr(for_dependency_resolution=), attr.dormant_label(), attr.dormant_label_list() and rule(for_dependency_resolution=) are allowed. Tags: - [`build_file_semantics`](#effect_tag_BUILD_FILE_SEMANTICS) + [`build_file_semantics`](#effect_tag_BUILD_FILE_SEMANTICS), [`experimental`](#metadata_tag_EXPERIMENTAL) `--[no]experimental_enable_first_class_macros` default: "true" : If set to true, enables the `macro()` construct for defining symbolic macros. @@ -3500,6 +3494,12 @@ Miscellaneous options, not otherwise categorized.: `--test_filter=` default: see description : Specifies a filter to forward to the test framework. Used to limit the tests run. Note that this does not affect which targets are built. +`--test_result_expiration=` default: "-1" +: This option is deprecated and has no effect. + + Tags: + [`deprecated`](#metadata_tag_DEPRECATED) + `--[no]test_runner_fail_fast` default: "false" : Forwards fail fast option to the test runner. The test runner should stop execution upon first failure. @@ -3646,7 +3646,7 @@ Options that control build execution: [`execution`](#effect_tag_EXECUTION) `--experimental_sandbox_limits=) eg. "HOST_CPUS", "HOST_CPUS*.5">` multiple uses are accumulated -: If > 0, each Linux sandbox will be limited to the given amount for the specified resource. This overrides --experimental_sandbox_memory_limit_mb. Requires cgroups v1 or v2 and permissions for the users to the cgroups dir. +: If > 0, each Linux sandbox will be limited to the given amount for the specified resource. Requires --incompatible_use_new_cgroup_implementation and overrides --experimental_sandbox_memory_limit_mb. Requires cgroups v1 or v2 and permissions for the users to the cgroups dir. Tags: [`execution`](#effect_tag_EXECUTION) @@ -3741,6 +3741,12 @@ Options that control build execution: Tags: [`execution`](#effect_tag_EXECUTION) +`--[no]incompatible_use_new_cgroup_implementation` default: "true" +: If true, use the new implementation for cgroups. The old implementation only supports the memory controller and ignores the value of --experimental_sandbox_limits. + + Tags: + [`execution`](#effect_tag_EXECUTION) + `--[no]internal_spawn_scheduler` default: "true" : Placeholder option so that we can tell in Blaze whether the spawn scheduler was enabled. @@ -6124,6 +6130,12 @@ Miscellaneous options, not otherwise categorized.: `--test_filter=` default: see description : Specifies a filter to forward to the test framework. Used to limit the tests run. Note that this does not affect which targets are built. +`--test_result_expiration=` default: "-1" +: This option is deprecated and has no effect. + + Tags: + [`deprecated`](#metadata_tag_DEPRECATED) + `--[no]test_runner_fail_fast` default: "false" : Forwards fail fast option to the test runner. The test runner should stop execution upon first failure. @@ -7893,6 +7905,12 @@ Miscellaneous options, not otherwise categorized.: `--test_filter=` default: see description : Specifies a filter to forward to the test framework. Used to limit the tests run. Note that this does not affect which targets are built. +`--test_result_expiration=` default: "-1" +: This option is deprecated and has no effect. + + Tags: + [`deprecated`](#metadata_tag_DEPRECATED) + `--[no]test_runner_fail_fast` default: "false" : Forwards fail fast option to the test runner. The test runner should stop execution upon first failure. @@ -7967,7 +7985,7 @@ Options that control the output of the command: [`bazel_monitoring`](#effect_tag_BAZEL_MONITORING) `--skykey_filter=` default: ".\*" -: Regex filter of SkyKey names to output. Only used with --skyframe=value, deps, rdeps, function_graph. +: Regex filter of SkyKey names to output. Only used with --skyframe=deps, rdeps, function_graph. Tags: [`bazel_monitoring`](#effect_tag_BAZEL_MONITORING) @@ -9495,6 +9513,12 @@ Miscellaneous options, not otherwise categorized.: `--test_filter=` default: see description : Specifies a filter to forward to the test framework. Used to limit the tests run. Note that this does not affect which targets are built. +`--test_result_expiration=` default: "-1" +: This option is deprecated and has no effect. + + Tags: + [`deprecated`](#metadata_tag_DEPRECATED) + `--[no]test_runner_fail_fast` default: "false" : Forwards fail fast option to the test runner. The test runner should stop execution upon first failure. @@ -12443,6 +12467,12 @@ Miscellaneous options, not otherwise categorized.: `--test_filter=` default: see description : Specifies a filter to forward to the test framework. Used to limit the tests run. Note that this does not affect which targets are built. +`--test_result_expiration=` default: "-1" +: This option is deprecated and has no effect. + + Tags: + [`deprecated`](#metadata_tag_DEPRECATED) + `--[no]test_runner_fail_fast` default: "false" : Forwards fail fast option to the test runner. The test runner should stop execution upon first failure. diff --git a/reference/test-encyclopedia.mdx b/reference/test-encyclopedia.mdx index 24821ada..eade94bc 100644 --- a/reference/test-encyclopedia.mdx +++ b/reference/test-encyclopedia.mdx @@ -453,7 +453,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. optional diff --git a/upstream b/upstream index 095c015c..a3cb5210 160000 --- a/upstream +++ b/upstream @@ -1 +1 @@ -Subproject commit 095c015c96cbc97cd103a8a462d18d8a3bb8b3c1 +Subproject commit a3cb52105be3d0163ac144e6c355eb5e39d082a4 diff --git a/versions/7.6.1/reference/test-encyclopedia.mdx b/versions/7.6.1/reference/test-encyclopedia.mdx index 9109dcd2..2c6847cd 100644 --- a/versions/7.6.1/reference/test-encyclopedia.mdx +++ b/versions/7.6.1/reference/test-encyclopedia.mdx @@ -446,7 +446,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - + JUnit test result schema diff --git a/versions/7.7.1/reference/test-encyclopedia.mdx b/versions/7.7.1/reference/test-encyclopedia.mdx index 2d0a13ee..24044838 100644 --- a/versions/7.7.1/reference/test-encyclopedia.mdx +++ b/versions/7.7.1/reference/test-encyclopedia.mdx @@ -442,7 +442,7 @@ The initial environment block shall be composed as follows: XML_OUTPUT_FILE - Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the JUnit test result schema. + Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the JUnit test result schema. optional diff --git a/versions/8.0.1/reference/test-encyclopedia.mdx b/versions/8.0.1/reference/test-encyclopedia.mdx index cf7844b4..70cb7f4b 100644 --- a/versions/8.0.1/reference/test-encyclopedia.mdx +++ b/versions/8.0.1/reference/test-encyclopedia.mdx @@ -446,7 +446,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. optional diff --git a/versions/8.1.1/reference/test-encyclopedia.mdx b/versions/8.1.1/reference/test-encyclopedia.mdx index dfae507f..84dffce1 100644 --- a/versions/8.1.1/reference/test-encyclopedia.mdx +++ b/versions/8.1.1/reference/test-encyclopedia.mdx @@ -446,7 +446,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. optional diff --git a/versions/8.2.1/reference/test-encyclopedia.mdx b/versions/8.2.1/reference/test-encyclopedia.mdx index 1e79e320..d137a7f2 100644 --- a/versions/8.2.1/reference/test-encyclopedia.mdx +++ b/versions/8.2.1/reference/test-encyclopedia.mdx @@ -446,7 +446,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. optional diff --git a/versions/8.3.1/reference/test-encyclopedia.mdx b/versions/8.3.1/reference/test-encyclopedia.mdx index f284b907..816d179e 100644 --- a/versions/8.3.1/reference/test-encyclopedia.mdx +++ b/versions/8.3.1/reference/test-encyclopedia.mdx @@ -446,7 +446,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. + JUnit test result schema. optional diff --git a/versions/8.4.2/reference/test-encyclopedia.mdx b/versions/8.4.2/reference/test-encyclopedia.mdx index fbcfec2c..b2b7458b 100644 --- a/versions/8.4.2/reference/test-encyclopedia.mdx +++ b/versions/8.4.2/reference/test-encyclopedia.mdx @@ -446,7 +446,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. optional diff --git a/versions/8.5.1/reference/test-encyclopedia.mdx b/versions/8.5.1/reference/test-encyclopedia.mdx index c07e60c3..e6f45daf 100644 --- a/versions/8.5.1/reference/test-encyclopedia.mdx +++ b/versions/8.5.1/reference/test-encyclopedia.mdx @@ -446,7 +446,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. optional diff --git a/versions/8.6.0/reference/test-encyclopedia.mdx b/versions/8.6.0/reference/test-encyclopedia.mdx index e8522a8f..8d8539a2 100644 --- a/versions/8.6.0/reference/test-encyclopedia.mdx +++ b/versions/8.6.0/reference/test-encyclopedia.mdx @@ -454,7 +454,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. optional diff --git a/versions/8.7.0/reference/test-encyclopedia.mdx b/versions/8.7.0/reference/test-encyclopedia.mdx index cc63c3b5..6245c6f7 100644 --- a/versions/8.7.0/reference/test-encyclopedia.mdx +++ b/versions/8.7.0/reference/test-encyclopedia.mdx @@ -453,7 +453,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. optional diff --git a/versions/9.0.0/reference/test-encyclopedia.mdx b/versions/9.0.0/reference/test-encyclopedia.mdx index 0a0cb45b..dc8baddd 100644 --- a/versions/9.0.0/reference/test-encyclopedia.mdx +++ b/versions/9.0.0/reference/test-encyclopedia.mdx @@ -446,7 +446,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. optional diff --git a/versions/9.1.0/reference/test-encyclopedia.mdx b/versions/9.1.0/reference/test-encyclopedia.mdx index 2532e1a8..c3ebe311 100644 --- a/versions/9.1.0/reference/test-encyclopedia.mdx +++ b/versions/9.1.0/reference/test-encyclopedia.mdx @@ -453,7 +453,7 @@ The initial environment block shall be composed as follows: Location to which test actions should write a test result XML output file. Otherwise, Bazel generates a default XML output file wrapping the test log as part of the test action. The XML schema is based on the - JUnit test result schema. optional