@lock export from Base, closes #36441

base/exports.jl

@@ -675,6 +675,8 @@ export
     istaskstarted,
     istaskfailed,
     lock,
+    @lock,
+    @lock_nofail,
     notify,
     ReentrantLock,
     schedule,

base/lock.jl

@@ -201,6 +201,14 @@ function trylock(f, l::AbstractLock)
     return false
 end
 
+"""
+    @lock l expr
+
+Macro version for `lock(f, l::AbstractLock)`. It wraps an arbitrary `expr` with a pair of
+`lock(l)` and `unlock(l)` functions. It is often more performant than function form 
+`lock(f, l)`, because it don't capture variables into a lambda.
+See [`lock`](@ref).
+"""
 macro lock(l, expr)
     quote
         temp = $(esc(l))
@@ -213,6 +221,13 @@ macro lock(l, expr)
     end
 end
 
+"""
+    @lock_nofail l expr
+
+Equivalent to `@lock l expr` for cases in which we can guarantee that the function 
+will not throw any error. In this case, avoiding try-catch can improve the performance.
+See [`@lock`](@ref).
+"""
 macro lock_nofail(l, expr)
     quote
         temp = $(esc(l))