From 33db5083013bd2433fd16d646bd5dfa8477fa212 Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Tue, 5 Jul 2022 16:23:10 +0900
Subject: [PATCH] Add note regarding why the `realmRetrievalLock` return is
 done on the async thread

---
 osu.Game/Database/RealmAccess.cs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/osu.Game/Database/RealmAccess.cs b/osu.Game/Database/RealmAccess.cs
index 7dd03d5ce7..8cf57b802b 100644
--- a/osu.Game/Database/RealmAccess.cs
+++ b/osu.Game/Database/RealmAccess.cs
@@ -920,6 +920,8 @@ public IDisposable BlockAllOperations(string reason)
 
             void restoreOperation()
             {
+                // Release of lock needs to happen here rather than on the update thread, as there may be another
+                // operation already blocking the update thread waiting for the blocking operation to complete.
                 Logger.Log(@"Restoring realm operations.", LoggingTarget.Database);
                 realmRetrievalLock.Release();