Apply suggestions

Co-Authored-By: Victor Stinner <vstinner@python.org>
vstinner · Apr 22, 2020 · Mar 30, 2020 · Mar 30, 2020 · Mar 30, 2020 · Mar 30, 2020
commit d1094d64848f54a33199699f7c5cdea1e91bee67
diff --git a/Doc/whatsnew/3.9.rst b/Doc/whatsnew/3.9.rst
@@ -827,7 +827,7 @@ Changes in the Python API
   in the object itself.
   (Contributed by Serhiy Storchaka in :issue:`40257`.)
 
-* The constant values of future flags in the :mod:`future` module
+* The constant values of future flags in the :mod:`__future__` module
   is updated in order to prevent collision with compiler flags.
   (Contributed by Batuhan Taskaya in :issue:`39562`)
 

diff --git a/Include/code.h b/Include/code.h
@@ -89,8 +89,8 @@ typedef struct {
 #define CO_ASYNC_GENERATOR      0x0200
 
 /* These are no longer used. */
-/* These values are changed in 3.9 to prevent collision with
-   compiler flags. See issue 39562 for more details. */
+/* bpo-39562: These constant values are changed in Python 3.9
+              to prevent collision with compiler flags. */
 #define CO_FUTURE_DIVISION      0x20000
 #define CO_FUTURE_ABSOLUTE_IMPORT 0x40000 /* do absolute imports by default */
 #define CO_FUTURE_WITH_STATEMENT  0x80000

diff --git a/Lib/test/test_future.py b/Lib/test/test_future.py
@@ -78,13 +78,14 @@ def test_badfuture10(self):
         self.check_syntax_error(cm.exception, "badsyntax_future10", 3)
 
     def test_ensure_flags_dont_clash(self):
-        # test that future flags and compiler flags doesn't clash
-        # obtain future flags (CO_****) from future module
+        # bpo-39562: test that future flags and compiler flags doesn't clash
+
+        # obtain future flags (CO_***) from the __future__ module
         flags = [
             getattr(__future__, future).compiler_flag
             for future in __future__.all_feature_names
         ]
-        # obtain some of the exported compiler flags (PyCF_****) from ast
+        # obtain some of the exported compiler flags (PyCF_***) from the ast module
         flags.extend(
             getattr(ast, flag) for flag in dir(ast) if flag.startswith("PyCF_")
         )