Bump to Bazel 7.6.0, update scala = False docs

The docs are more clear that `scala_toolchains(scala = False)` applies
when using custom JARs for every `setup_scala_toolchain()` argument.
Otherwise `setup_scala_toolchain()` will fall back to the builtin JARs,
and needs `scala = True, validate_scala_version = False`.

Also removes the `scala_register_toolchains()` calls from the
`dt_patches/test_dt_patches*/WORKSPACE` files. This proves that those
calls were harmless before in those repos, but ultimately unnecessary.

`MODULE.bazel` will still register `@rules_scala_toolchains//...:all`.

Author: mbland

.bazelversion

@@ -1 +1 @@
-7.5.0
+7.6.0

README.md

@@ -804,7 +804,7 @@ same exact call will also work in `MODULE.bazel`.
 
 ### Disabling builtin Scala toolchains when defining custom Scala toolchains
 
-When [defining a 'scala_toolchain()' using custom compiler JARs](
+When [using 'setup_scala_toolchain()' with custom compiler JARs](
 docs/scala_toolchain.md#b-defining-your-own-scala_toolchain), don't use
 `scala_toolchains()` if you don't need any other builtin toolchains.
 
@@ -819,9 +819,9 @@ scala_toolchains(
 ```
 
 This avoids instantiating the default Scala toolchain and compiler JAR
-repositories and a corresponding Scala version check, which may fail when
-defining a custom toolchain. It's equivalent to two ways in which the previous
-API avoided the same default behavior:
+repositories, and disables the corresponding Scala version check, which may
+otherwise fail. This is equivalent to two ways in which the previous API avoided
+the same default behavior:
 
 - Calling `scala_repositories(load_jar_deps = False)` would instantiate only
     other `rules_scala` dependency repos (`rules_java`, `protobuf`, etc.) and

docs/scala_toolchain.md

@@ -103,8 +103,9 @@ register_toolchains("//toolchains:my_scala_toolchain")
 
 #### Step 3 (optional)
 
-If you use `scala_toolchains()` to instantiate other builtin toolchains, set
-`scala = False`:
+When using your own JARs for every `setup_scala_toolchain()` argument, while
+using `scala_toolchains()` to instantiate other builtin toolchains, set `scala =
+False`:
 
 ```py
 # WORKSPACE
@@ -115,10 +116,21 @@ scala_toolchains(
 ```
 
 Otherwise, `scala_toolchains()` will try to instantiate a default Scala
-toolchain and its compiler JAR dependency repositories. The build will then fail
-if the configured Scala version doesn't match the `scala_version` value in the
+toolchain and its compiler JAR repositories. The build will then fail if the
+configured Scala version doesn't match the `scala_version` value in the
 corresponding `third_party/repositories/scala_*.bzl` file.
 
+If you don't specify your own jars for every `setup_scala_toolchain()` argument,
+set `validate_scala_version = False` to disable the Scala version check.
+
+```py
+# WORKSPACE
+scala_toolchains(
+    validate_scala_version = False,
+    # ...other toolchain parameters...
+)
+```
+
 ## Configuration options
 
 The following attributes apply to both `scala_toolchain` and

dt_patches/compiler_sources/.bazelversion

@@ -1 +1 @@
-7.5.0
+7.6.0

dt_patches/test_dt_patches/.bazelversion

@@ -1 +1 @@
-7.5.0
+7.6.0

dt_patches/test_dt_patches/WORKSPACE

@@ -73,17 +73,11 @@ load("@compiler_sources//:extensions.bzl", "import_compiler_source_repos")
 
 import_compiler_source_repos()
 
-load(
-    "@rules_scala//scala:toolchains.bzl",
-    "scala_register_toolchains",
-    "scala_toolchains",
-)
+load("@rules_scala//scala:toolchains.bzl", "scala_toolchains")
 
 scala_toolchains(
     fetch_sources = True,
     validate_scala_version = False,
 )
 
 register_toolchains(":dt_scala_toolchain")
-
-scala_register_toolchains()

dt_patches/test_dt_patches_user_srcjar/.bazelversion

@@ -1 +1 @@
-7.5.0
+7.6.0

dt_patches/test_dt_patches_user_srcjar/WORKSPACE

@@ -149,11 +149,7 @@ srcjars_by_version = {
     },
 }
 
-load(
-    "@rules_scala//scala:toolchains.bzl",
-    "scala_register_toolchains",
-    "scala_toolchains",
-)
+load("@rules_scala//scala:toolchains.bzl", "scala_toolchains")
 
 scala_toolchains(
     fetch_sources = True,
@@ -162,5 +158,3 @@ scala_toolchains(
 )
 
 register_toolchains(":dt_scala_toolchain")
-
-scala_register_toolchains()

examples/crossbuild/.bazelversion

@@ -1 +1 @@
-7.5.0
+7.6.0

examples/overridden_artifacts/.bazelversion

@@ -1 +1 @@
-7.5.0
+7.6.0