Fix scala_deps.toolchains docs and comments

Should've been part of the previous commit, but I missed them.

Author: mbland

docs/scala_toolchain.md

@@ -105,21 +105,10 @@ register_toolchains("//toolchains:my_scala_toolchain")
 
 When using your own JARs for every `setup_scala_toolchain()` argument, while
 using `scala_deps` or`scala_toolchains()` to instantiate other builtin
-toolchains, set `scala = False`:
+toolchains:
 
-```py
-# MODULE.bazel
-scala_deps.toolchains(
-    scala = False,
-    # ...other toolchain parameters...
-)
-
-# WORKSPACE
-scala_toolchains(
-    scala = False,
-    # ...other toolchain parameters...
-)
-```
+- Bzlmod: Don't instantiate `scala_deps.scala()`.
+- `WORKSPACE`: Call `scala_toolchains(scala = False, ...)`.
 
 Otherwise, `scala_deps` or `scala_toolchains()` will try to instantiate a
 default Scala toolchain and its compiler JAR repositories. The build will then
@@ -131,7 +120,7 @@ set `validate_scala_version = False` to disable the Scala version check.
 
 ```py
 # MODULE.bazel
-scala_deps.toolchains(
+scala_deps.settings(
     validate_scala_version = False,
     # ...other toolchain parameters...
 )

examples/testing/multi_frameworks_toolchain/MODULE.bazel

@@ -34,7 +34,7 @@ scala_deps.junit()
 scala_deps.scalatest()
 scala_deps.specs2()
 
-# Under normal circumstances, the above `scala_deps.toolchains()` registration
+# Under normal circumstances, the above `scala_deps` tag class instantiations
 # would be all you need. rules_scala will set up and register the toolchains
 # automatically.
 #

scala/extensions/deps.bzl

@@ -50,7 +50,8 @@ _settings_attrs = {
         doc = (
             "Check if the configured Scala version matches " +
             "the default version supported by rules_scala. " +
-            "Only takes effect if `scala_deps.toolchains(scala = True)`."
+            "Only takes effect when the builtin Scala toolchain is " +
+            "instantiated via `scala_deps.scala()`."
         ),
     ),
 }