gh-109319: deprecate dis.HAVE_ARGUMENT (#109320)

diff --git a/Doc/library/dis.rst b/Doc/library/dis.rst
index d929242ede743d4b82aa86c9dcae0ad08021cefd..72e55cd81d42f6c8ba41150425d8737ac9c3c2e8 100644 (file)
--- a/Doc/library/dis.rst
+++ b/Doc/library/dis.rst
@@ -1623,6 +1623,8 @@ iterations of the loop.
       it is not true that comparison with ``HAVE_ARGUMENT`` indicates whether
       they use their arg.
 
+   .. deprecated:: 3.13
+      Use :data:`hasarg` instead.
 
 .. opcode:: CALL_INTRINSIC_1
 

diff --git a/Doc/whatsnew/3.13.rst b/Doc/whatsnew/3.13.rst
index 8c6467562aeb62249623816d124356699eb77836..c18e15e0448f05071db8577b4834864c1ba4ace9 100644 (file)
--- a/Doc/whatsnew/3.13.rst
+++ b/Doc/whatsnew/3.13.rst
@@ -301,6 +301,11 @@ Deprecated
 
   (Contributed by Erlend E. Aasland in :gh:`107948` and :gh:`108278`.)
 
+* The ``dis.HAVE_ARGUMENT`` separator is deprecated. Check membership
+  in :data:`~dis.hasarg` instead.
+  (Contributed by Irit Katriel in :gh:`109319`.)
+
+
 Pending Removal in Python 3.14
 ------------------------------
 

diff --git a/Misc/NEWS.d/next/Library/2023-09-12-13-01-55.gh-issue-109319.YaCMtW.rst b/Misc/NEWS.d/next/Library/2023-09-12-13-01-55.gh-issue-109319.YaCMtW.rst
new file mode 100644 (file)
index 0000000..d3cd86b
--- /dev/null
+++ b/Misc/NEWS.d/next/Library/2023-09-12-13-01-55.gh-issue-109319.YaCMtW.rst
@@ -0,0 +1 @@
+Deprecate the ``dis.HAVE_ARGUMENT`` field in favour of ``dis.hasarg``.