[9.0.1] Add deprecation warning to --build_python_zip (bazelbuild#28586)

Fork of bazelbuild#28527.

Fixes bazelbuild#28528.

Author: gregestren

src/main/java/com/google/devtools/build/lib/rules/python/PythonOptions.java

@@ -35,9 +35,12 @@ public class PythonOptions extends FragmentOptions {
   @Option(
       name = "build_python_zip",
       defaultValue = "auto",
-      documentationCategory = OptionDocumentationCategory.OUTPUT_PARAMETERS,
-      effectTags = {OptionEffectTag.AFFECTS_OUTPUTS},
-      help = "Build python executable zip; on on Windows, off on other platforms")
+      documentationCategory = OptionDocumentationCategory.UNDOCUMENTED,
+      effectTags = {OptionEffectTag.NO_OP},
+      deprecationWarning =
+          "The '--no' prefix is no longer supported for this flag. Please use"
+              + " --build_python_zip=false instead.",
+      help = "Deprecated. No-op.")
   public TriState buildPythonZip;
 
   @Option(