Add autolink-preface directives at file level

Author: cmarqu

Doc/howto/functional.rst

@@ -4,6 +4,13 @@
   Functional Programming HOWTO
 ********************************
 
+.. autolink-preface::
+   :level: file
+
+   import functools
+   import itertools
+
+
 :Author: A. M. Kuchling
 :Release: 0.32
 

Doc/howto/ipaddress.rst

@@ -2,6 +2,11 @@
 
    import ipaddress
 
+.. autolink-preface::
+   :level: file
+
+   import ipaddress
+
 .. _ipaddress-howto:
 
 ***************************************

Doc/library/annotationlib.rst

@@ -12,6 +12,12 @@
    import annotationlib
    from annotationlib import *
 
+.. autolink-preface::
+   :level: file
+
+   import annotationlib
+   from annotationlib import *
+
 --------------
 
 The :mod:`!annotationlib` module provides tools for introspecting
@@ -484,4 +490,3 @@ annotations from the class and puts them in a separate attribute:
             typ.__annotate__ = wrapped_annotate
          typ.classvars = classvars  # Store the ClassVars in a separate attribute
          return typ
-

Doc/library/ast.rst

@@ -9,7 +9,12 @@
 
 .. testsetup::
 
-    import ast
+   import ast
+
+.. autolink-preface::
+   :level: file
+
+   import ast
 
 **Source code:** :source:`Lib/ast.py`
 
@@ -1221,6 +1226,7 @@ Control flow
         ...         break
         ...     else:
         ...         continue
+        ...
         ... """), indent=4))
         Module(
             body=[

Doc/library/collections.abc.rst

@@ -18,6 +18,12 @@
    import itertools
    __name__ = '<doctest>'
 
+.. autolink-preface::
+   :level: file
+
+   from collections.abc import *
+   import itertools
+
 --------------
 
 This module provides :term:`abstract base classes <abstract base class>` that

Doc/library/collections.rst

@@ -15,6 +15,12 @@
     import itertools
     __name__ = '<doctest>'
 
+.. autolink-preface::
+   :level: file
+
+   from collections import *
+   import itertools
+
 --------------
 
 This module implements specialized container datatypes providing alternatives to

Doc/library/configparser.rst

@@ -56,6 +56,11 @@ can be customized by end users easily.
    os.remove("example.ini")
    os.remove("override.ini")
 
+.. autolink-preface::
+   :level: file
+
+   import configparser
+
 
 Quick Start
 -----------

Doc/library/ctypes.rst

@@ -490,6 +490,11 @@ Return types
    libc = CDLL(find_library('c'))
    strchr = libc.strchr
 
+.. autolink-preface::
+   :level: file
+
+   from ctypes import CDLL, c_char, c_char_p
+   from ctypes.util import find_library
 
 By default functions are assumed to return the C :c:expr:`int` type.  Other
 return types can be specified by setting the :attr:`~_CFuncPtr.restype` attribute of the

Doc/library/decimal.rst

@@ -28,6 +28,14 @@
    # make sure other tests (outside this file) get a fresh context
    setcontext(Context())
 
+.. autolink-preface::
+   :level: file
+
+   import decimal
+   import math
+   from decimal import *
+
+
 --------------
 
 The :mod:`decimal` module provides support for fast correctly rounded

Doc/library/difflib.rst

@@ -15,6 +15,12 @@
    import sys
    from difflib import *
 
+.. autolink-preface::
+   :level: file
+
+   import sys
+   from difflib import *
+
 --------------
 
 This module provides classes and functions for comparing sequences. It