typeshed: remove crufty comments (#4699)

Co-authored-by: hauntsaninja <>

stdlib/2and3/_bisect.pyi

@@ -1,5 +1,3 @@
-"""Stub file for the '_bisect' module."""
-
 from typing import MutableSequence, Optional, Sequence, TypeVar
 
 _T = TypeVar("_T")

stdlib/2and3/_codecs.pyi

@@ -1,5 +1,3 @@
-"""Stub file for the '_codecs' module."""
-
 import codecs
 import sys
 from typing import Any, Callable, Dict, Optional, Text, Tuple, Union

stdlib/2and3/_heapq.pyi

@@ -1,5 +1,3 @@
-"""Stub file for the '_heapq' module."""
-
 import sys
 from typing import Any, Callable, Iterable, List, Optional, TypeVar
 

stdlib/2and3/_random.pyi

@@ -1,5 +1,3 @@
-# Stubs for _random
-
 import sys
 from typing import Tuple
 

stdlib/2and3/array.pyi

@@ -1,7 +1,3 @@
-# Stubs for array
-
-# Based on http://docs.python.org/3.6/library/array.html
-
 import sys
 from typing import Any, BinaryIO, Generic, Iterable, List, MutableSequence, Text, Tuple, TypeVar, Union, overload
 from typing_extensions import Literal

stdlib/2and3/base64.pyi

@@ -1,5 +1,3 @@
-# Stubs for base64
-
 import sys
 from typing import IO, Optional, Union
 

stdlib/2and3/binascii.pyi

@@ -1,7 +1,3 @@
-# Stubs for binascii
-
-# Based on http://docs.python.org/3.2/library/binascii.html
-
 import sys
 from typing import Text, Union
 

stdlib/2and3/bisect.pyi

@@ -1,4 +1,3 @@
-# Stubs for bisect
 from _bisect import *
 
 bisect = bisect_right

stdlib/2and3/chunk.pyi

@@ -1,6 +1,3 @@
-# Source(py2): https://hg.python.org/cpython/file/2.7/Lib/chunk.py
-# Source(py3): https://github.com/python/cpython/blob/master/Lib/chunk.py
-
 from typing import IO
 
 class Chunk:

stdlib/2and3/cmath.pyi

@@ -1,5 +1,3 @@
-"""Stub file for the 'cmath' module."""
-
 import sys
 from typing import SupportsComplex, SupportsFloat, Tuple, Union
 

stdlib/2and3/cmd.pyi

@@ -1,5 +1,3 @@
-# Stubs for cmd (Python 2/3)
-
 from typing import IO, Any, Callable, List, Optional, Tuple
 
 class Cmd:

stdlib/2and3/code.pyi

@@ -1,5 +1,3 @@
-# Stubs for code
-
 import sys
 from types import CodeType
 from typing import Any, Callable, Mapping, Optional

stdlib/2and3/codeop.pyi

@@ -1,6 +1,3 @@
-# Source(py2): https://hg.python.org/cpython/file/2.7/Lib/codeop.py
-# Source(py3): https://github.com/python/cpython/blob/master/Lib/codeop.py
-
 from types import CodeType
 from typing import Optional
 

stdlib/2and3/colorsys.pyi

@@ -1,5 +1,3 @@
-# Stubs for colorsys
-
 from typing import Tuple
 
 def rgb_to_yiq(r: float, g: float, b: float) -> Tuple[float, float, float]: ...

stdlib/2and3/copy.pyi

@@ -1,5 +1,3 @@
-# Stubs for copy
-
 from typing import Any, Dict, Optional, TypeVar
 
 _T = TypeVar("_T")

stdlib/2and3/ctypes/__init__.pyi

@@ -1,5 +1,3 @@
-# Stubs for ctypes
-
 import sys
 from array import array
 from typing import (

stdlib/2and3/ctypes/util.pyi

@@ -1,5 +1,3 @@
-# Stubs for ctypes.util
-
 import sys
 from typing import Optional
 

stdlib/2and3/difflib.pyi

@@ -1,5 +1,3 @@
-# Based on https://docs.python.org/2.7/library/difflib.html and https://docs.python.org/3.2/library/difflib.html
-
 import sys
 from typing import (
     Any,

stdlib/2and3/errno.pyi

@@ -1,5 +1,3 @@
-# Stubs for errno
-
 from typing import Mapping
 
 errorcode: Mapping[int, str]

stdlib/2and3/filecmp.pyi

@@ -1,4 +1,3 @@
-# Stubs for filecmp (Python 2/3)
 import sys
 from typing import Any, AnyStr, Callable, Dict, Generic, Iterable, List, Optional, Sequence, Text, Tuple, Union
 

stdlib/2and3/formatter.pyi

@@ -1,5 +1,3 @@
-# Source: https://hg.python.org/cpython/file/2.7/Lib/formatter.py
-# and https://github.com/python/cpython/blob/master/Lib/formatter.py
 from typing import IO, Any, Iterable, List, Optional, Tuple
 
 AS_IS: None

stdlib/2and3/fractions.pyi

@@ -1,9 +1,3 @@
-# Stubs for fractions
-# See https://docs.python.org/3/library/fractions.html
-#
-# Note: these stubs are incomplete. The more complex type
-# signatures are currently omitted. Also see numbers.pyi.
-
 import sys
 from decimal import Decimal
 from numbers import Integral, Rational, Real

stdlib/2and3/hmac.pyi

@@ -1,5 +1,3 @@
-# Stubs for hmac
-
 import sys
 from _typeshed import ReadableBuffer
 from types import ModuleType

stdlib/2and3/lib2to3/__init__.pyi

@@ -1 +0,0 @@
-# Stubs for lib2to3 (Python 3.6)

stdlib/2and3/lib2to3/pgen2/literals.pyi

@@ -1,5 +1,3 @@
-# Stubs for lib2to3.pgen2.literals (Python 3.6)
-
 from typing import Dict, Match, Text
 
 simple_escapes: Dict[Text, Text]

stdlib/2and3/lib2to3/pgen2/parse.pyi

@@ -1,5 +1,3 @@
-# Stubs for lib2to3.pgen2.parse (Python 3.6)
-
 from lib2to3.pgen2.grammar import _DFAS, Grammar
 from lib2to3.pytree import _NL, _Convert, _RawNode
 from typing import Any, List, Optional, Sequence, Set, Text, Tuple

stdlib/2and3/lib2to3/pgen2/token.pyi

@@ -1,5 +1,3 @@
-# Stubs for lib2to3.pgen2.token (Python 3.6)
-
 import sys
 from typing import Dict, Text
 

stdlib/2and3/lib2to3/pgen2/tokenize.pyi

@@ -1,6 +1,3 @@
-# Stubs for lib2to3.pgen2.tokenize (Python 3.6)
-# NOTE: Only elements from __all__ are present.
-
 from lib2to3.pgen2.token import *  # noqa
 from typing import Callable, Iterable, Iterator, List, Text, Tuple
 

stdlib/2and3/lib2to3/pygram.pyi

@@ -1,5 +1,3 @@
-# Stubs for lib2to3.pygram (Python 3.6)
-
 from lib2to3.pgen2.grammar import Grammar
 
 class Symbols:

stdlib/2and3/lib2to3/pytree.pyi

@@ -1,5 +1,3 @@
-# Stubs for lib2to3.pytree (Python 3.6)
-
 import sys
 from lib2to3.pgen2.grammar import Grammar
 from typing import Any, Callable, Dict, Iterator, List, Optional, Text, Tuple, TypeVar, Union

stdlib/2and3/locale.pyi

@@ -1,5 +1,3 @@
-# Stubs for locale
-
 import sys
 from decimal import Decimal
 from typing import Any, Callable, Dict, Iterable, List, Mapping, Optional, Sequence, Tuple, Union

stdlib/2and3/macpath.pyi

@@ -1,6 +1,3 @@
-# Stubs for os.path
-# Ron Murawski <ron@horizonchess.com>
-
 import os
 import sys
 from _typeshed import AnyPath, BytesPath, StrPath

stdlib/2and3/math.pyi

@@ -1,6 +1,3 @@
-# Stubs for math
-# See: http://docs.python.org/2/library/math.html
-
 import sys
 from typing import Iterable, SupportsFloat, SupportsInt, Tuple, overload
 

stdlib/2and3/mimetypes.pyi

@@ -1,5 +1,3 @@
-# Stubs for mimetypes
-
 import sys
 from typing import IO, Dict, List, Optional, Sequence, Text, Tuple, Union
 

stdlib/2and3/ntpath.pyi

@@ -1,4 +1,3 @@
-# NB: path.pyi and stdlib/2 and stdlib/3 must remain consistent!
 import os
 import sys
 from _typeshed import AnyPath, BytesPath, StrPath

stdlib/2and3/numbers.pyi

@@ -1,7 +1,3 @@
-# Stubs for numbers (Python 3.5)
-# See https://docs.python.org/2.7/library/numbers.html
-# and https://docs.python.org/3/library/numbers.html
-#
 # Note: these stubs are incomplete. The more complex type
 # signatures are currently omitted.
 

stdlib/2and3/operator.pyi

@@ -1,5 +1,3 @@
-# Stubs for operator
-
 import sys
 from typing import (
     Any,

stdlib/2and3/optparse.pyi

@@ -1,4 +1,3 @@
-# Generated by pytype, with only minor tweaks. Might be incomplete.
 import sys
 from typing import IO, Any, AnyStr, Callable, Dict, Iterable, List, Mapping, Optional, Sequence, Tuple, Type, Union, overload
 

stdlib/2and3/pickletools.pyi

@@ -1,4 +1,3 @@
-# Stubs for pickletools (Python 2 and 3)
 import sys
 from typing import IO, Any, Callable, Iterator, List, MutableMapping, Optional, Text, Tuple, Type, Union
 

stdlib/2and3/poplib.pyi

@@ -1,5 +1,3 @@
-# Stubs for poplib (Python 2 and 3)
-
 import socket
 import ssl
 import sys

stdlib/2and3/posixpath.pyi

@@ -1,4 +1,3 @@
-# NB: path.pyi and stdlib/2 and stdlib/3 must remain consistent!
 import os
 import sys
 from _typeshed import AnyPath, BytesPath, StrPath

stdlib/2and3/pprint.pyi

@@ -1,8 +1,3 @@
-# Stubs for pprint
-
-# Based on http://docs.python.org/2/library/pprint.html
-# Based on http://docs.python.org/3/library/pprint.html
-
 import sys
 from typing import IO, Any, Dict, Optional, Tuple
 

stdlib/2and3/pty.pyi

@@ -1,4 +1,3 @@
-# Stubs for pty (Python 2 and 3)
 import sys
 from typing import Callable, Iterable, Tuple, Union
 

stdlib/2and3/py_compile.pyi

@@ -1,4 +1,3 @@
-# Stubs for py_compile (Python 2 and 3)
 import enum
 import sys
 from typing import AnyStr, List, Optional, Text, Type, Union

stdlib/2and3/quopri.pyi

@@ -1,5 +1,3 @@
-# Stubs for quopri (Python 2 and 3)
-
 from typing import BinaryIO
 
 def encode(input: BinaryIO, output: BinaryIO, quotetabs: int, header: int = ...) -> None: ...

stdlib/2and3/readline.pyi

@@ -1,5 +1,3 @@
-# Stubs for readline
-
 import sys
 from typing import Callable, Optional, Sequence
 

stdlib/2and3/rlcompleter.pyi

@@ -1,5 +1,3 @@
-# Stubs for rlcompleter
-
 import sys
 from typing import Any, Dict, Optional, Union
 

stdlib/2and3/site.pyi

@@ -1,5 +1,3 @@
-# Stubs for site
-
 import sys
 from typing import Iterable, List, Optional
 

stdlib/2and3/smtpd.pyi

@@ -1,4 +1,3 @@
-# Stubs for smtpd (Python 2 and 3)
 import asynchat
 import asyncore
 import socket

stdlib/2and3/socket.pyi

@@ -1,19 +1,3 @@
-"""Stub for the socket module
-
-This file is organized to mirror the module's documentation, with a very small
-number of exceptions.
-
-To avoid requiring tests on all platforms, platform checks are included only
-where the documentation notes platform availability (as opposed to following
-actual availability), with one or two exceptions.
-
-Module documentation: https://docs.python.org/3/library/socket.html
-CPython module source: https://github.com/python/cpython/blob/master/Lib/socket.py
-CPython C source: https://github.com/python/cpython/blob/master/Modules/socketmodule.c
-"""
-# Authorship from original mypy stubs (not in typeshed git history):
-#   Ron Murawski <ron@horizonchess.com>
-#   adapted for Python 2.7 by Michal Pokorny
 import sys
 from typing import Any, BinaryIO, Iterable, List, Optional, Sequence, Text, TextIO, Tuple, TypeVar, Union, overload
 from typing_extensions import Literal

stdlib/2and3/sqlite3/dbapi2.pyi

@@ -1,6 +1,3 @@
-# Filip Hron <filip.hron@gmail.com>
-# based heavily on Andrey Vlasovskikh's python-skeletons https://github.com/JetBrains/python-skeletons/blob/master/sqlite3.py
-
 import os
 import sys
 from datetime import date, datetime, time

stdlib/2and3/sre_compile.pyi

@@ -1,6 +1,3 @@
-# Source: https://hg.python.org/cpython/file/2.7/Lib/sre_compile.py
-# and https://github.com/python/cpython/blob/master/Lib/sre_compile.py
-
 import sys
 from sre_constants import (
     SRE_FLAG_DEBUG as SRE_FLAG_DEBUG,

stdlib/2and3/stringprep.pyi

@@ -1,5 +1,3 @@
-# Stubs for stringprep (Python 2 and 3)
-
 from typing import Text
 
 def in_table_a1(code: Text) -> bool: ...

stdlib/2and3/struct.pyi

@@ -1,8 +1,3 @@
-# Stubs for struct
-
-# Based on http://docs.python.org/3.2/library/struct.html
-# Based on http://docs.python.org/2/library/struct.html
-
 import sys
 from array import array
 from mmap import mmap

stdlib/2and3/sunau.pyi

@@ -1,5 +1,3 @@
-# Stubs for sunau (Python 2 and 3)
-
 import sys
 from typing import IO, Any, NamedTuple, NoReturn, Optional, Text, Tuple, Union
 

stdlib/2and3/telnetlib.pyi

@@ -1,5 +1,3 @@
-# Stubs for telnetlib (Python 2 and 3)
-
 import socket
 import sys
 from typing import Any, Callable, Match, Optional, Pattern, Sequence, Tuple, Union

stdlib/2and3/time.pyi

@@ -1,6 +1,3 @@
-"""Stub file for the 'time' module."""
-# See https://docs.python.org/3/library/time.html
-
 import sys
 from typing import Any, NamedTuple, Optional, Tuple, Union
 

stdlib/2and3/timeit.pyi

@@ -1,5 +1,3 @@
-# Stubs for timeit (Python 2 and 3)
-
 import sys
 from typing import IO, Any, Callable, Dict, List, Optional, Sequence, Text, Tuple, Union
 

stdlib/2and3/tty.pyi

@@ -1,5 +1,3 @@
-# Stubs for tty (Python 3.6)
-
 from typing import IO, Union
 
 _FD = Union[int, IO[str]]

stdlib/2and3/uu.pyi

@@ -1,4 +1,3 @@
-# Stubs for uu (Python 2 and 3)
 import sys
 from typing import BinaryIO, Optional, Text, Union
 

stdlib/2and3/uuid.pyi

@@ -1,5 +1,3 @@
-# Stubs for uuid
-
 import sys
 from typing import Any, Optional, Text, Tuple
 

stdlib/2and3/wave.pyi

@@ -1,5 +1,3 @@
-# Stubs for wave (Python 2 and 3)
-
 import sys
 from typing import IO, Any, BinaryIO, NamedTuple, NoReturn, Optional, Text, Tuple, Union
 

stdlib/2and3/xdrlib.pyi

@@ -1,4 +1,3 @@
-# Structs for xdrlib (Python 2 and 3)
 from typing import Callable, List, Sequence, TypeVar
 
 _T = TypeVar("_T")

stdlib/2and3/xml/etree/ElementPath.pyi

@@ -1,5 +1,3 @@
-# Stubs for xml.etree.ElementPath (Python 3.4)
-
 from typing import Callable, Dict, Generator, List, Optional, Pattern, Tuple, TypeVar, Union
 from xml.etree.ElementTree import Element
 

stdlib/2and3/xml/etree/cElementTree.pyi

@@ -1,3 +1 @@
-# Stubs for xml.etree.cElementTree (Python 3.4)
-
 from xml.etree.ElementTree import *  # noqa: F403

stdlib/2and3/zipimport.pyi

@@ -1,5 +1,3 @@
-"""Stub file for the 'zipimport' module."""
-
 import os
 import sys
 from types import CodeType, ModuleType

stdlib/2and3/zlib.pyi

@@ -1,4 +1,3 @@
-# Stubs for zlib
 import sys
 from array import array
 from typing import Any, Union