From bf09b0bb3ada942a306fb289443d270880abfc22 Mon Sep 17 00:00:00 2001
From: AI-scor <354880559+AI-scor@users.noreply.github.com>
Date: Tue, 10 Nov 2026 21:37:49 +0100
Subject: [PATCH] [Docs] Document UpdateDownloader::beginDownload restart
 contract

---
 .../src/client/network/update/client/update_downloader.h       | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/cockatrice/src/client/network/update/client/update_downloader.h b/cockatrice/src/client/network/update/client/update_downloader.h
index 7704eca38..cbfcbe5e0 100644
--- a/cockatrice/src/client/network/update/client/update_downloader.h
+++ b/cockatrice/src/client/network/update/client/update_downloader.h
@@ -21,6 +21,9 @@ class UpdateDownloader : public QObject
     Q_OBJECT
 public:
     explicit UpdateDownloader(QObject *parent);
+    // Starts a transfer and supersedes any reply still in flight: a cancelled or
+    // failed download can be restarted on the same object, and late signals from
+    // the superseded reply are dropped instead of reported.
     void beginDownload(QUrl url);
 signals:
     void downloadSuccessful(QUrl filepath);