docs: document the exec tools toolchain pieces

rickeylev · rickeylev · commit b802ebfd7300 · 2024-08-28T11:21:21.000-07:00
This makes it easier to know how to manually define
`py_exec_tools_toolchain()`.

Also doc the `inherit` value for the `pyc_collection` attribute.
diff --git a/docs/BUILD.bazel b/docs/BUILD.bazel
@@ -90,6 +90,8 @@ sphinx_stardocs(
         "//python:py_test_bzl",
         "//python/cc:py_cc_toolchain_info_bzl",
         "//python/entry_points:py_console_script_binary_bzl",
+        "//python/private:py_exec_tools_info_bzl",
+        "//python/private:py_exec_tools_toolchain_bzl",
         "//python/private/common:py_binary_rule_bazel_bzl",
         "//python/private/common:py_library_rule_bazel_bzl",
         "//python/private/common:py_runtime_rule_bzl",
diff --git a/python/private/common/py_executable.bzl b/python/private/common/py_executable.bzl
@@ -99,8 +99,9 @@ Determines whether pyc files from dependencies should be manually included.
 NOTE: This setting is only useful with {flag}`--precompile_add_to_runfiles=decided_elsewhere`.
 
 Valid values are:
+* `inherit`: Inherit the value from {flag}`--pyc_collection`.
 * `include_pyc`: Add pyc files from dependencies in the binary (from
-  `PyInfo.transitive_pyc_files`.
+  {obj}`PyInfo.transitive_pyc_files`.
 * `disabled`: Don't explicitly add pyc files from dependencies. Note that
   pyc files may still come from dependencies if a target includes them as
   part of their runfiles (such as when {obj}`--precompile_add_to_runfiles=always`
