add deprecation notes

Author: vchuravy

Project.toml

@@ -1,7 +1,7 @@
 name = "KernelAbstractions"
 uuid = "63c18a36-062a-441e-b654-da1e3ab1ce7c"
 authors = ["Valentin Churavy <[email protected]> and contributors"]
-version = "0.9.34"
+version = "0.10.0-dev"
 
 [deps]
 Adapt = "79e6a3ab-5dfb-504d-930d-738a2a938a0e"

src/KernelAbstractions.jl

@@ -65,6 +65,9 @@ This allows for two different configurations:
 
 !!! warn
     This is an experimental feature.
+
+!!! note
+    `cpu={true, false}` is deprecated for KernelAbstractions 1.0
 """
 macro kernel(ex...)
     if length(ex) == 1
@@ -248,6 +251,9 @@ For storage that only persists between `@synchronize` statements, an `MArray` ca
 instead.
 
 See also [`@uniform`](@ref).
+
+!!! note
+    `@private` is deprecated for KernelAbstractions 1.0
 """
 macro private(T, dims)
     if dims isa Integer
@@ -263,6 +269,9 @@ end
 
 Creates a private local of `mem` per item in the workgroup. This can be safely used
 across [`@synchronize`](@ref) statements.
+
+!!! note
+    `@private` is deprecated for KernelAbstractions 1.0
 """
 macro private(expr)
     return esc(expr)
@@ -273,6 +282,9 @@ end
 
 `expr` is evaluated outside the workitem scope. This is useful for variable declarations
 that span workitems, or are reused across `@synchronize` statements.
+
+!!! note
+    `@uniform` is deprecated for KernelAbstractions 1.0
 """
 macro uniform(value)
     return esc(value)
@@ -324,6 +336,8 @@ Access the hidden context object used by KernelAbstractions.
 !!! warn
     Only valid to be used from a kernel with `cpu=false`.
 
+!!! note
+    `@context` will be supported on all backends in KernelAbstractions 1.0
 ```
 function f(@context, a)
     I = @index(Global, Linear)
@@ -472,6 +486,9 @@ Abstract type for all GPU based KernelAbstractions backends.
 
 !!! note
     New backend implementations **must** sub-type this abstract type.
+
+!!! note
+    `GPU` will be removed in KernelAbstractions v1.0
 """
 abstract type GPU <: Backend end
 
@@ -483,6 +500,9 @@ Instantiate a CPU (multi-threaded) backend.
 ## Options:
  - `static`: Uses a static thread assignment, this can be beneficial for NUMA aware code.
    Defaults to false.
+
+!!! note
+    `CPU` will be aliased to `POCLBackend()` on KernelAbstractions v1.0 
 """
 struct CPU <: Backend
     static::Bool
@@ -493,6 +513,9 @@ end
     isgpu(::Backend)::Bool
 
 Returns true for all [`GPU`](@ref) backends.
+
+!!! note
+    `isgpu` will be removed in KernelAbstractions v1.0
 """
 isgpu(::GPU) = true
 isgpu(::CPU) = false
@@ -512,8 +535,6 @@ function get_backend end
 # Should cover SubArray, ReshapedArray, ReinterpretArray, Hermitian, AbstractTriangular, etc.:
 get_backend(A::AbstractArray) = get_backend(parent(A))
 
-get_backend(::Array) = CPU()
-
 # Define:
 #   adapt_storage(::Backend, a::Array) = adapt(BackendArray, a)
 #   adapt_storage(::Backend, a::BackendArray) = a

src/pocl/pocl.jl

@@ -66,4 +66,9 @@ include("backend.jl")
 import .POCLKernels: POCLBackend
 export POCLBackend
 
+import KernelAbstractions as KA
+KA.get_backend(::Array) = POCLBackend()
+
+Adapt.adapt_storage(::POCLBackend, a::Array) = a
+
 end