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..8638ef5c 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,6 +535,12 @@ 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_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: + [`loading_and_analysis`](#effect_tag_LOADING_AND_ANALYSIS), [`loses_incremental_state`](#effect_tag_LOSES_INCREMENTAL_STATE), [`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. @@ -794,6 +794,12 @@ This option affects semantics of the Starlark language or the build API accessib Tags: [`loading_and_analysis`](#effect_tag_LOADING_AND_ANALYSIS), [`incompatible_change`](#metadata_tag_INCOMPATIBLE_CHANGE) +`--[no]incompatible_stop_exporting_language_modules` default: "false" +: If enabled, certain language-specific modules (such as `cc_common`) are unavailable in user .bzl files and may only be called from their respective rules repositories. + + Tags: + [`loading_and_analysis`](#effect_tag_LOADING_AND_ANALYSIS), [`incompatible_change`](#metadata_tag_INCOMPATIBLE_CHANGE) + `--[no]incompatible_unambiguous_label_stringification` default: "true" : When true, Bazel will stringify the label @//foo:bar to @//foo:bar, instead of //foo:bar. This only affects the behavior of str(), the % operator, and so on; the behavior of repr() is unchanged. See https://github.com/bazelbuild/bazel/issues/15916 for more information. @@ -3500,6 +3506,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 +3658,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 +3753,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 +6142,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 +7917,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 +7997,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 +9525,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 +12479,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..be3a5dc2 160000 --- a/upstream +++ b/upstream @@ -1 +1 @@ -Subproject commit 095c015c96cbc97cd103a8a462d18d8a3bb8b3c1 +Subproject commit be3a5dc2346c5737fa6b9ea22d26a38431dd6958 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