From 11ade32fea2ab74278b67245000433aca1ab5d22 Mon Sep 17 00:00:00 2001
From: Ankith <46915066+ankith26@users.noreply.github.com>
Date: Sun, 26 Dec 2021 20:16:16 +0530
Subject: [PATCH] docs: Clarify update behaviour in display docs

---
 docs/reST/ref/display.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/docs/reST/ref/display.rst b/docs/reST/ref/display.rst
index 86b14c58a9..95a7ed65ec 100644
--- a/docs/reST/ref/display.rst
+++ b/docs/reST/ref/display.rst
@@ -242,6 +242,9 @@ required).
    instead of the entire area. If no argument is passed it updates the entire
    Surface area like ``pygame.display.flip()``.
 
+   Note that calling ``display.update(None)`` means no part of the window is
+   updated. Whereas ``display.update()`` means the whole window is updated.
+
    You can pass the function a single rectangle, or a sequence of rectangles.
    It is more efficient to pass many rectangles at once than to call update
    multiple times with single or a partial list of rectangles. If passing a