Rename to *exclude-docstrings*

Author: StanFromIreland

Lib/test/test_tools/test_i18n.py

@@ -589,7 +589,8 @@ def extract_from_snapshots():
         'messages.py': (),
         'fileloc.py': ('--docstrings',),
         'docstrings.py': ('--docstrings',),
-        ('docstrings.py', 'skipdocstrings.py', 'docstrings.pot'): ('--docstrings', f'--no-docstrings={DATA_DIR}{os.path.sep}skipdocstrings.txt'),
+        ('docstrings.py', 'skipdocstrings.py', 'docstrings.pot'): ('--docstrings',
+             f'--exclude-docstrings={DATA_DIR}{os.path.sep}skipdocstrings.txt'),
         'comments.py': ('--add-comments=i18n:',),
         'custom_keywords.py': ('--keyword=foo', '--keyword=nfoo:1,2',
                                '--keyword=pfoo:1c,2',

Misc/NEWS.d/next/Library/2025-04-26-19-26-00.gh-issue-130197.sjdhsja.rst

@@ -0,0 +1,2 @@
+Fix and test the ``--exclude-docstrings`` option in :program:`pygettext`.
+Note: the option was also renamed from ``--no-docstrings`` for clarity.

Misc/NEWS.d/next/Tools-Demos/2025-04-26-19-26-00.gh-issue-130197.sjdhsja.rst

@@ -131,7 +131,7 @@
         appear on a line by itself in the file.
 
     -X filename
-    --no-docstrings=filename
+    --exclude-docstrings=filename
         Specify a file that contains a list of files (one per line) that
         should not have their docstrings extracted.  This is only useful in
         conjunction with the -D option above.
@@ -692,7 +692,7 @@ def main():
              'help', 'keyword=', 'no-default-keywords',
              'add-location', 'no-location', 'output=', 'output-dir=',
              'style=', 'verbose', 'version', 'width=', 'exclude-file=',
-             'docstrings', 'no-docstrings=',
+             'docstrings', 'exclude-docstrings=',
              ])
     except getopt.error as msg:
         usage(1, msg)
@@ -766,7 +766,7 @@ class Options:
                 usage(1, f'--width argument must be an integer: {arg}')
         elif opt in ('-x', '--exclude-file'):
             options.excludefilename = arg
-        elif opt in ('-X', '--no-docstrings'):
+        elif opt in ('-X', '--exclude-docstrings'):
             with open(arg, 'r') as nodocstrings_file:
                 for line in nodocstrings_file:
                     filename = os.path.basename(line.strip())