Remove mentions of overlay module

buildconfig/stubs/gen_stubs.py

@@ -96,11 +96,7 @@ def get_all(mod: Any):
     pygame_all_imports[f".{k}"] = get_all(getattr(pygame, k))
 
 # misc stubs that must be added to __init__.pyi
-misc_stubs = """
-from typing import Tuple, NoReturn
-
-def Overlay(format: int, size: Tuple[int, int]) -> NoReturn: ...
-"""
+misc_stubs = """"""
 
 # write constants.pyi file
 constants_file = pathlib.Path(__file__).parent / "pygame" / "constants.pyi"

buildconfig/stubs/pygame/__init__.pyi

@@ -2,10 +2,6 @@
 # A script to auto-generate locals.pyi, constants.pyi and __init__.pyi typestubs
 # IMPORTANT NOTE: Do not edit this file by hand!
 
-from typing import Tuple, NoReturn
-
-def Overlay(format: int, size: Tuple[int, int]) -> NoReturn: ...
-
 from pygame import (
     display as display,
     draw as draw,

docs/README.md

@@ -66,11 +66,9 @@ in the future.
 
 ### Hidden modules
 
-Pygame still has documentation for the Overlay module, which
-are discontinued in SDL2 based pygame (pygame 2). It just doesn't show them,
-because `docs/reST/themes/classic/elements.html` now has a list of
-"blacklisted" modules to not put into the top bar. It also uses this for the
-experimental sdl2_video docs.
+Pygame-ce has documentation for some experimental modules like sdl2_video. It just
+doesn't show them, because `docs/reST/themes/classic/elements.html` has a list of
+"blacklisted" modules to not put into the top bar.
 
 ### Styling / Themes
 

docs/reST/ext/boilerplate.py

@@ -345,7 +345,6 @@ def lowercase_name(d):
         "freetype",
         "gfxdraw",
         "midi",
-        "Overlay",
         "PixelArray",
         "pixelcopy",
         "sndarray",

docs/reST/themes/classic/elements.html

@@ -40,7 +40,7 @@ <h5>pygame-ce documentation</h5>
 #}
 {%- set basic = ['Color', 'display', 'draw', 'event', 'font', 'image', 'key', 'locals', 'mixer', 'mouse', 'music', 'pygame', 'Rect', 'Surface', 'time'] %}
 {%- set advanced = ['BufferProxy', 'freetype', 'gfxdraw', 'midi', 'PixelArray', 'pixelcopy', 'sndarray', 'surfarray', 'cursors', 'joystick', 'mask', 'math', 'sprite', 'transform'] %}
-{%- set hidden = ['Overlay', 'sdl2_video', 'sdl2_controller'] %}
+{%- set hidden = ['sdl2_video', 'sdl2_controller'] %}
 {%-   if pyg_sections %}
 	  <p class="bottom"><b>Most useful stuff</b>:
 {%      set sep = joiner(" | \n") %}

examples/README.rst

@@ -78,9 +78,6 @@ music_drop_fade.py
    several events.  Uses fade_ms added in pygame2, as well as set_endevent,
    set_volume, drag and drop events, and the scrap module.
 
-overlay.py
-   An old way of displaying video content.
-
 pixelarray.py
    Process whole arrays of pixels at a time.
    Like numpy, but for pixels, and also built into pygame.

src_py/__init__.py

@@ -235,14 +235,6 @@ def PixelArray(surface):  # pylint: disable=unused-argument
         _attribute_undefined("pygame.PixelArray")
 
 
-try:
-    from pygame.overlay import Overlay
-except (ImportError, OSError):
-
-    def Overlay(format, size):  # pylint: disable=unused-argument
-        _attribute_undefined("pygame.Overlay")
-
-
 try:
     import pygame.time
     from pygame.time import Clock