Specify reentrancy gurantees of Once::call_once

rust-lang · Aug 3, 2018 · 94de821 · 94de821
1 parent 4dae470
commit 94de821
Showing 1 changed file with 4 additions and 0 deletions.
diff --git a/src/libstd/sync/once.rs b/src/libstd/sync/once.rs
@@ -178,6 +178,10 @@ impl Once {
     /// happens-before relation between the closure and code executing after the
     /// return).
     ///
+    /// If the given closure recusively invokes `call_once` on the same `Once` 
+    /// instance the exact behavior is not specified, allowed outcomes are
+    /// a panic or a deadlock.
+    ///
     /// # Examples
     ///
     /// ```