more docs and what's new entry

python · iritkatriel · Sep 30, 2022 · Aug 30, 2022 · Aug 31, 2022 · Sep 1, 2022
commit 670d8f8a188eb446ec85e304ab0ec6aa5ba556bb
@@ -2996,6 +2996,11 @@ generators, coroutines do not directly support iteration.
   above.  If the exception is not caught in the coroutine, it propagates
   back to the caller.

+   .. versionchanged:: 3.12
+
+      The second signature \(type\[, value\[, traceback\]\]\) is deprecated and
+      may be removed in a future version of Python.
+
 .. method:: coroutine.close()

   Causes the coroutine to clean itself up and exit.  If the coroutine

@@ -743,7 +743,8 @@ which are used to control the execution of a generator function.
   because there is no yield expression that could receive the value.


-.. coroutinemethod:: agen.athrow(type[, value[, traceback]])
+.. coroutinemethod:: agen.athrow(value)
+                     agen.athrow(type[, value[, traceback]])

   Returns an awaitable that raises an exception of type ``type`` at the point
   where the asynchronous generator was paused, and returns the next value
@@ -755,6 +756,11 @@ which are used to control the execution of a generator function.
   raises a different exception, then when the awaitable is run that exception
   propagates to the caller of the awaitable.

+   .. versionchanged:: 3.12
+
+      The second signature \(type\[, value\[, traceback\]\]\) is deprecated and
+      may be removed in a future version of Python.
+
 .. index:: exception: GeneratorExit



diff --git a/Doc/whatsnew/3.12.rst b/Doc/whatsnew/3.12.rst
@@ -159,6 +159,8 @@ Deprecated
  and tailor them to your needs.
  (Contributed by Erlend E. Aasland in :gh:`90016`.)

+* The exception representation \(type\[, value\[, traceback\]\]\) is now deprecated. (:gh:`89874`.)
+

 Pending Removal in Python 3.13
 ------------------------------
-Original file line number
+Diff line change
@@ -2996,6 +2996,11 @@ generators, coroutines do not directly support iteration.
        above.  If the exception is not caught in the coroutine, it propagates
        back to the caller.
+       .. versionchanged:: 3.12
+          The second signature \(type\[, value\[, traceback\]\]\) is deprecated and
             Copy link

  
      
    
  

  
      

  
  Member


      

  

  
    
      

      
            merwok
  

      

      

      


        Sep 30, 2022


      
  •

  
    
      
        
          edited
          
        
        
      
    
    
      
  
        
      Loading


  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  
    
  


    

  


        
      
  
  
  
    

    There was a problem hiding this comment.


  

 
  
    

    Choose a reason for hiding this comment

    
      The reason will be displayed to describe this comment to others. Learn more.
    

    
      
      


  


  
    
      For future PRs, not that code should generally be marked up like
      The second signature `(type[, value[, traceback]])` is deprecated and

    
  
  


    

        
      
  
  
    
  
  
  
    
    Sorry, something went wrong.
  

  
    
  
    
      

              Uh oh!

              
There was an error while loading. Please reload this page.


  
  


          
      
  
    
    
      
        
            
    All reactions
+          may be removed in a future version of Python.
     .. method:: coroutine.close()
        Causes the coroutine to clean itself up and exit.  If the coroutine
-          Expand Down