Minor comment

bbrockbernd · bbrockbernd · commit dc35dbdd86d9 · 2025-04-23T17:14:59.000+02:00
diff --git a/atomicfu/src/commonMain/kotlin/kotlinx/atomicfu/locks/SynchronousMutex.kt b/atomicfu/src/commonMain/kotlin/kotlinx/atomicfu/locks/SynchronousMutex.kt
@@ -13,6 +13,7 @@ import kotlin.time.Duration
  * 
  * When a thread calls [lock] while another thread is locked, it will suspend until the lock is released.
  * When multiple threads are waiting for the lock, they will acquire it in a fair order (first in first out).
+ * On JVM, a [lock] call can skip the queue if it happens in between a thread releasing and the first in queue acquiring.
  * 
  * It is reentrant, meaning the lock holding thread can call [lock] multiple times without suspending.
  * To release the lock (after multiple [lock] calls) an equal number of [unlock] calls are required.

Original file line number	Diff line number	Diff line change
`@@ -13,6 +13,7 @@ import kotlin.time.Duration`
`13`	`13`	`*`
`14`	`14`	`* When a thread calls [lock] while another thread is locked, it will suspend until the lock is released.`
`15`	`15`	`* When multiple threads are waiting for the lock, they will acquire it in a fair order (first in first out).`
	`16`	`+ * On JVM, a [lock] call can skip the queue if it happens in between a thread releasing and the first in queue acquiring.`
`16`	`17`	`*`
`17`	`18`	`* It is reentrant, meaning the lock holding thread can call [lock] multiple times without suspending.`
`18`	`19`	`* To release the lock (after multiple [lock] calls) an equal number of [unlock] calls are required.`