Add documentation about the finality of close().

beeware · Aug 16, 2023 · 1d8b12b · 1d8b12b
1 parent 6731a4f
commit 1d8b12b
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/docs/reference/api/window.rst b/docs/reference/api/window.rst
@@ -45,6 +45,10 @@ If the operating system provides a way to close the window, Toga will call the
 permitted. This can be used to implement protections against closing a window with
 unsaved changes.
 
+Once a window has been closed (either by user action, or programmatically with
+:meth:`~toga.Window.close()`), it *cannot* be reused. The behavior of any method on a
+:class:`~toga.Window` instance after it has been closed is undefined.
+
 Notes
 -----