Add Base.wrap to docs

[fatteneder]

I thought that's reasonable in the light that view was not implemented: #52049 (comment)

[Tokazama]

Is wrap supposed to be a generic function for wrapping data in other structs?

[fatteneder]

Its meant to wrap an Array around a Memory:

julia/base/array.jl

Lines 3066 to 3072 in e460d35

	"""
	wrap(Array, m::Union{Memory{T}, MemoryRef{T}}, dims)
	Create an array of size `dims` using `m` as the underlying memory. This can be thought of as a safe version
	of [`unsafe_wrap`](@ref) utilizing `Memory` or `MemoryRef` instead of raw pointers.
	"""
	function wrap end

[Tokazama]

Its meant to wrap an Array around a Memory:

julia/base/array.jl

Lines 3066 to 3072 in e460d35

	"""
	wrap(Array, m::Union{Memory{T}, MemoryRef{T}}, dims)
	Create an array of size `dims` using `m` as the underlying memory. This can be thought of as a safe version
	of [`unsafe_wrap`](@ref) utilizing `Memory` or `MemoryRef` instead of raw pointers.
	"""
	function wrap end

But is it intended to be a method that is extended for similar use cases?

[fatteneder]

I think not, because

• it was added as a safe counterpart to unsafe_wrap, which itself is only meant to wrap an Array around a Ptr,
• the arguments are specific to Array (what would the dims argument be use for with a generic struct?),
• I think there is no functionality yet that builds upon wrap, so no need to extend it.

[MasonProtter]

Oops, I forgot to add this to the docs when I wrote it. Thanks for putting it in!

[vtjnash]

The generic version is generally view, though that usually returns an immutable-axes container, while this is fairly specific to making a mutable Array wrapper around Memory. So someone else might extend this, but there is not too many envisioned cases where there is a similar set of factors. It probably only would be extended for other near-equivalent cases, like converting some struct that wrapped a Memory into a type that wraps an Array, or doing something similar with AtomicMemory