docs: Update - save signal doesn't work on Windows

Signed-off-by: Arkady Gilinsky <[email protected]>

Author: ark-g

coverage/cmdline.py

@@ -196,7 +196,8 @@ class Opts:
         help=(
             "Define a system signal that will trigger coverage report save operation. " +
             "It is important that target script do not intercept this signal. " +
-            "Currently supported options are: USR1, USR2."
+            "Currently supported options are: USR1, USR2. " +
+            "This feature does not work on Windows."
         ),
     )
     show_contexts = optparse.make_option(
@@ -869,6 +870,9 @@ def do_run(self, options: optparse.Values, args: list[str]) -> int:
             self.coverage.load()
 
         if options.save_signal:
+            if env.WINDOWS:
+                show_help("Signals are not supported in Windows environment.")
+                return ERR
             if options.save_signal.upper() == 'USR1':
                 signal.signal(signal.SIGUSR1, self.do_signal_save)
             elif options.save_signal.upper() == 'USR2':

doc/cmd.rst

@@ -137,7 +137,8 @@ There are many options:
                             Define a system signal that will trigger coverage
                             report save operation. It is important that target
                             script do not intercept this signal. Currently
-                            supported options are: USR1, USR2.
+                            supported options are: USR1, USR2. This feature does
+                            not work on Windows.
       --source=SRC1,SRC2,...
                             A list of directories or importable names of code to
                             measure.
@@ -148,7 +149,7 @@ There are many options:
       --rcfile=RCFILE       Specify configuration file. By default '.coveragerc',
                             'setup.cfg', 'tox.ini', and 'pyproject.toml' are
                             tried. [env: COVERAGE_RCFILE]
-.. [[[end]]] (sum: 1+s3B5JO5I)
+.. [[[end]]] (sum: X8Kbvdq2+f)
 
 If you want :ref:`branch coverage <branch>` measurement, use the ``--branch``
 flag.  Otherwise only statement coverage is measured.