update docs

Author: rickeylev

docs/api/rules_python/command_line_option/index.md

@@ -4,3 +4,38 @@
 :::
 
 # //command_line_option
+
+This package provides special targets that correspond to the Bazel-builtin
+`//command_line_option` psuedo-targets. These can be used with the {obj}`config_settings`
+attribute on Python rules to transition specific command line flags for a target.
+
+:::{note}
+These targets are not actual `alias()` targets, nor are they the actual builtin
+command line flags. They are regular targets that the `config_settings` transition
+logic specially recognizes and handles as if they were the builtin `//command_line_option`
+psuedo-targets.
+:::
+
+:::{seealso}
+The `config_settings` attribute documentation on:
+* {obj}`py_binary.config_settings`
+* {obj}`py_test.config_settings`
+:::
+
+## build_runfile_links
+
+:::{bzl:target} build_runfile_links
+
+Special target for the Bazel-builtin `//command_line_option:build_runfile_links` flag.
+
+See the [Bazel documentation for --build_runfile_links](https://bazel.build/reference/command-line-reference#flag--build_runfile_links).
+:::
+
+## enable_runfiles
+
+:::{bzl:target} enable_runfiles
+
+Special target for the Bazel-builtin `//command_line_option:enable_runfiles` flag.
+
+See the [Bazel documentation for --enable_runfiles](https://bazel.build/reference/command-line-reference#flag--enable_runfiles).
+:::

python/private/attributes.bzl

@@ -402,16 +402,21 @@ versions of a library] for a more concrete example.
 
 :::{important}
 Labels with package `command_line_option` are handled specially: they are treated
-as aliases for the Bazel-builtin `//command_line_option:<name>` psuedo-targets.
+as the Bazel-builtin `//command_line_option:<name>` psuedo-targets.
 
 e.g. `@foo//command_line_option:NAME` will attempt to transition
 the Bazel-builtin `//command_line_option:NAME` setting.
 
 See the {obj}`@rules_python//command_line_option` package for some predefined
-aliases, or define your own by putting them in your own `command_line_option`
+special targets, or define your own by putting them in your own `command_line_option`
 directory.
 :::
 
+:::{seealso}
+* {obj}`//command_line_option:build_runfile_links`
+* {obj}`//command_line_option:enable_runfiles`
+:::
+
 :::{note}
 These values are transitioned on, so will affect the analysis graph and the
 associated memory overhead. The more unique configurations in your overall