From eac93f43d39495cd0cb799890457c52cf8445897 Mon Sep 17 00:00:00 2001
From: akwizgran <michael@briarproject.org>
Date: Mon, 10 Aug 2020 11:36:05 +0100
Subject: [PATCH] Add comments for wake lock handling.

---
 .../bramble/system/AndroidWakeLockManagerImpl.java            | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/bramble-android/src/main/java/org/briarproject/bramble/system/AndroidWakeLockManagerImpl.java b/bramble-android/src/main/java/org/briarproject/bramble/system/AndroidWakeLockManagerImpl.java
index 323bb9bc9..4ed400eee 100644
--- a/bramble-android/src/main/java/org/briarproject/bramble/system/AndroidWakeLockManagerImpl.java
+++ b/bramble-android/src/main/java/org/briarproject/bramble/system/AndroidWakeLockManagerImpl.java
@@ -75,10 +75,14 @@ class AndroidWakeLockManagerImpl implements AndroidWakeLockManager {
 				try {
 					r.run();
 				} finally {
+					// Release the wake lock if the task throws an exception
 					wakeLock.release();
 				}
 			});
 		} catch (Exception e) {
+			// Release the wake lock if the executor throws an exception when
+			// we submit the task (in which case the release() call above won't
+			// happen)
 			wakeLock.release();
 			throw e;
 		}