From 0c9f4ababa93cdc04d56fc263dbfa5bbbafc7662 Mon Sep 17 00:00:00 2001
From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Sun, 13 Dec 2020 00:47:53 +0100
Subject: [PATCH] Document wxWebResponse pointers as being non-owning

wxWebResponse objects belong to wxWebRequest itself.
---
 include/wx/webrequest.h   | 2 +-
 interface/wx/webrequest.h | 3 +++
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/include/wx/webrequest.h b/include/wx/webrequest.h
index f1db691915..b1223d7ce4 100644
--- a/include/wx/webrequest.h
+++ b/include/wx/webrequest.h
@@ -291,7 +291,7 @@ public:
 
 private:
     wxWebRequest::State m_state;
-    wxWebResponse* m_response;
+    wxWebResponse* m_response; // non-owning, may be NULL
     wxString m_responseFileName;
     const void* m_data;
     size_t m_dataSize;
diff --git a/interface/wx/webrequest.h b/interface/wx/webrequest.h
index ac61675708..5a65854b08 100644
--- a/interface/wx/webrequest.h
+++ b/interface/wx/webrequest.h
@@ -177,6 +177,9 @@ public:
 
         Before sending a request or after a failed request this will return
         @c NULL.
+
+        Note that this pointer remains owned by wxWebRequest object and must
+        not be freed.
     */
     wxWebResponse* GetResponse() const;