go: rename option to --go-test-coverage-packages

src/python/pants/backend/go/goals/test.py

@@ -255,7 +255,7 @@ def compilation_failure(exit_code: int, stdout: str | None, stderr: str | None)
             build_opts,
             coverage_config=GoCoverageConfig(
                 cover_mode=go_test_subsystem.coverage_mode,
-                import_path_include_patterns=go_test_subsystem.coverage_include_patterns,
+                import_path_include_patterns=go_test_subsystem.coverage_packages,
             ),
         )
 

src/python/pants/backend/go/subsystems/gotest.py

@@ -92,11 +92,11 @@ class GoTestSubsystem(Subsystem):
         ),
     )
 
-    coverage_include_patterns = StrListOption(
+    coverage_packages = StrListOption(
         default=[],
         help=softwrap(
             """
-            A list of import path patterns for determining which import paths will be instrumented for code
+            A list of "import path patterns" for determining which import paths will be instrumented for code
             coverage.
 
             From `go help packages`:
@@ -118,6 +118,9 @@ class GoTestSubsystem(Subsystem):
             is not a vendored package: cmd/vendor would be a command named vendor,
             and the pattern cmd/... matches it.
             See golang.org/s/go15vendor for more about vendoring.
+
+            This option is similar to the `go test -coverpkg` option, but without support currently
+            for reserved import path patterns like `std` and `all`.
             """
         ),
     )

src/python/pants/backend/go/util_rules/coverage_test.py

@@ -212,7 +212,7 @@ def run_test(tgt: Target) -> str:
         [
             "--go-test-args=-v -bench=.",
             "--test-use-coverage",
-            "--go-test-coverage-include-patterns=foo/adder",
+            "--go-test-coverage-packages=foo/adder",
         ],
         env_inherit={"PATH"},
     )