#1286 Remove header comments from stubs (#1292)

- Updates documentation related to previously required comment headers.
- Removes all comment headers from stubs
- Occasionally included a header for stubs that were noted to be incomplete or contained todo's.

stdlib/2/Cookie.pyi

@@ -1,7 +1,3 @@
-# Stubs for Cookie (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any
 
 class CookieError(Exception): ...

stdlib/2/cookielib.pyi

@@ -1,7 +1,3 @@
-# Stubs for cookielib (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any
 
 class Cookie:

stdlib/2/csv.pyi

@@ -1,7 +1,3 @@
-# Stubs for csv (Python 2.7)
-#
-# NOTE: Based on a dynamically typed stub automatically generated by stubgen.
-
 from typing import Any, Dict, Iterable, List, Sequence, Type, Union
 
 # Public interface of _csv.reader's return type

stdlib/2/email/MIMEText.pyi

@@ -1,7 +1,3 @@
-# Stubs for email.MIMEText (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from email.mime.nonmultipart import MIMENonMultipart
 
 class MIMEText(MIMENonMultipart):

stdlib/2/email/_parseaddr.pyi

@@ -1,7 +1,3 @@
-# Stubs for email._parseaddr (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any
 
 def parsedate_tz(data): ...

stdlib/2/email/mime/base.pyi

@@ -1,6 +1,4 @@
-# Stubs for email.mime.base (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
+# NOTE: This stub is incomplete.
 
 # import message
 

stdlib/2/email/mime/multipart.pyi

@@ -1,7 +1,3 @@
-# Stubs for email.mime.multipart (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from email.mime.base import MIMEBase
 
 class MIMEMultipart(MIMEBase):

stdlib/2/email/mime/nonmultipart.pyi

@@ -1,7 +1,3 @@
-# Stubs for email.mime.nonmultipart (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from email.mime.base import MIMEBase
 
 class MIMENonMultipart(MIMEBase):

stdlib/2/email/mime/text.pyi

@@ -1,7 +1,3 @@
-# Stubs for email.mime.text (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from email.mime.nonmultipart import MIMENonMultipart
 
 class MIMEText(MIMENonMultipart):

stdlib/2/email/utils.pyi

@@ -1,7 +1,3 @@
-# Stubs for email.utils (Python 2)
-#
-# Derived from stub automatically generated by stubgen.
-
 from email._parseaddr import AddressList as _AddressList
 from email._parseaddr import mktime_tz as mktime_tz
 from email._parseaddr import parsedate as _parsedate

stdlib/2/genericpath.pyi

@@ -1,7 +1,3 @@
-# Stubs for genericpath (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 class _unicode: ...
 
 def exists(path): ...

stdlib/2/gzip.pyi

@@ -1,7 +1,3 @@
-# Stubs for gzip (Python 2)
-#
-# NOTE: Based on a dynamically typed stub automatically generated by stubgen.
-
 from typing import Any, IO
 import io
 

stdlib/2/htmlentitydefs.pyi

@@ -1,7 +1,3 @@
-# Stubs for htmlentitydefs (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any, Mapping
 
 name2codepoint = ...  # type: Mapping[str, int]

stdlib/2/linecache.pyi

@@ -1,7 +1,3 @@
-# Stubs for linecache (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 def getline(filename, lineno, module_globals=None): ...
 def clearcache(): ...
 def checkcache(filename=None): ...

stdlib/2/mimetools.pyi

@@ -1,7 +1,3 @@
-# Stubs for mimetools (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any
 import rfc822
 

stdlib/2/multiprocessing/__init__.pyi

@@ -1,7 +1,3 @@
-# Stubs for multiprocessing (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from multiprocessing.process import Process as Process, current_process as current_process, active_children as active_children
 from multiprocessing.util import SUBDEBUG as SUBDEBUG, SUBWARNING as SUBWARNING
 

stdlib/2/multiprocessing/process.pyi

@@ -1,7 +1,3 @@
-# Stubs for multiprocessing.process (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any
 
 def current_process(): ...

stdlib/2/multiprocessing/util.pyi

@@ -1,7 +1,3 @@
-# Stubs for multiprocessing.util (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any
 import threading
 

stdlib/2/pdb.pyi

@@ -1,4 +1,4 @@
-# Stub for pdb (incomplete, only some global functions)
+# NOTE: This stub is incomplete - only contains some global functions
 
 from typing import Any, Dict
 

stdlib/2/posixpath.pyi

@@ -1,7 +1,3 @@
-# Stubs for posixpath (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any, AnyStr, List
 from genericpath import *  # noqa: F403
 

stdlib/2/pydoc.pyi

@@ -1,7 +1,3 @@
-# Stubs for pydoc (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any, AnyStr, Callable, Container, Dict, IO, List, Mapping, MutableMapping, Optional, Tuple, Type, Union
 from mypy_extensions import NoReturn
 from repr import Repr

stdlib/2/runpy.pyi

@@ -1,7 +1,3 @@
-# Stubs for runpy (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any
 
 class _TempModule:

stdlib/2/shutil.pyi

@@ -1,7 +1,3 @@
-# Stubs for shutil (Python 2)
-#
-# NOTE: Based on a dynamically typed stub automatically generated by stubgen.
-
 from typing import List, Iterable, Callable, IO, AnyStr, Any, Optional, Tuple, Sequence
 
 class Error(EnvironmentError): ...

stdlib/2/smtplib.pyi

@@ -1,7 +1,3 @@
-# Stubs for smtplib (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any
 
 class SMTPException(Exception): ...

stdlib/2/sqlite3/__init__.pyi

@@ -1,5 +1 @@
-# Stubs for sqlite3 (Python 3.5)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from sqlite3.dbapi2 import *  # noqa: F403

stdlib/2/textwrap.pyi

@@ -1,7 +1,3 @@
-# Stubs for textwrap (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any
 
 class _unicode: ...

stdlib/2/urllib.pyi

@@ -1,6 +1,3 @@
-# Stubs for urllib (Python 2)
-# NOTE: This dynamically typed stub was originally automatically generated by stubgen.
-
 from typing import Any, Mapping, Union, Tuple, Sequence, IO
 
 def url2pathname(pathname: str) -> str: ...

stdlib/2/weakref.pyi

@@ -1,7 +1,3 @@
-# Stubs for weakref (Python 2)
-#
-# Based on stub automatically generated by stubgen.
-
 from typing import Any, MutableMapping, Generic, Iterator, List, TypeVar
 from _weakref import (getweakrefcount, getweakrefs, ref, proxy,
                       CallableProxyType, ProxyType, ReferenceType)

stdlib/2/wsgiref/validate.pyi

@@ -1,7 +1,3 @@
-# Stubs for wsgiref.validate (Python 2)
-#
-# NOTE: This dynamically typed stub was automatically generated by stubgen.
-
 from typing import Any
 
 class WSGIWarning(Warning): ...