Deprecate delayed

Author: jpsamaroo

docs/src/api-dagger/functions.md

@@ -11,8 +11,6 @@ Pages = ["functions.md"]
 ```@docs
 @spawn
 spawn
-delayed
-@par
 ```
 
 ## Task Options Functions/Macros
@@ -38,16 +36,6 @@ scope
 constrain
 ```
 
-## Lazy Task Functions
-```@docs
-domain
-compute
-dependents
-noffspring
-order
-treereduce
-```
-
 ## Processor Functions
 ```@docs
 execute!

src/sch/eager.jl

@@ -24,7 +24,7 @@ function init_eager()
         sopts = SchedulerOptions(;allow_errors=true)
         opts = Dagger.Options((;scope=Dagger.ExactScope(Dagger.ThreadProc(1, 1)),
                                 occupancy=Dict(Dagger.ThreadProc=>0)))
-        Dagger.compute(ctx, Dagger.delayed(eager_thunk, opts)();
+        Dagger.compute(ctx, Dagger._delayed(eager_thunk, opts)();
                        options=sopts)
     catch err
         # Scheduler halting is considered normal

src/thunk.jl

@@ -171,9 +171,13 @@ Creates a [`Thunk`](@ref) object which can be executed later, which will call
 `f` with `args` and `kwargs`. `options` controls various properties of the
 resulting `Thunk`.
 """
-function delayed(f, options::Options)
+function _delayed(f, options::Options)
     (args...; kwargs...) -> Thunk(f, args_kwargs_to_pairs(args, kwargs)...; options.options...)
 end
+function delayed(f, options::Options)
+    Base.depwarn("`delayed` is deprecated. Use `Dagger.@spawn` or `Dagger.spawn` instead.", :delayed; force=true)
+    return _delayed(f, options)
+end
 delayed(f; kwargs...) = delayed(f, Options(;kwargs...))
 
 "A weak reference to a `Thunk`."