Doc float complex

base/complex.jl

@@ -162,12 +162,6 @@ Convert real numbers or arrays to complex. `i` defaults to zero.
 ```jldoctest
 julia> complex(7)
 7 + 0im
-
-julia> complex([1, 2, 3])
-3-element Vector{Complex{Int64}}:
- 1 + 0im
- 2 + 0im
- 3 + 0im
 ```
 """
 complex(z::Complex) = z
@@ -1125,7 +1119,23 @@ big(::Type{Complex{T}}) where {T<:Real} = Complex{big(T)}
 big(z::Complex{T}) where {T<:Real} = Complex{big(T)}(z)
 
 ## Array operations on complex numbers ##
+"""
+    complex(A::AbstractArray)
+
+Return an array containing the complex analog of each entry in array `A`.
+
+Equivalent to `complex.(A)`, except that the return value may share memory with all or
+part of `A` in accordance with the behavior of `convert(T, A)` given output type `T`.
 
+# Examples
+```jldoctest
+julia> complex([1, 2, 3])
+3-element Vector{Complex{Int64}}:
+ 1 + 0im
+ 2 + 0im
+ 3 + 0im
+```
+"""
 complex(A::AbstractArray{<:Complex}) = A
 
 function complex(A::AbstractArray{T}) where T

base/essentials.jl

@@ -412,7 +412,7 @@ julia> convert(BigFloat, x)
 ```
 
 If `T` is a collection type and `x` a collection, the result of
-`convert(T, x)` may alias all or part of `x`.
+`convert(T, x)` may share memory with all or part of `x`.
 ```jldoctest
 julia> x = Int[1, 2, 3];
 

base/float.jl

@@ -364,9 +364,6 @@ See also: [`complex`](@ref), [`oftype`](@ref), [`convert`](@ref).
 
 # Examples
 ```jldoctest
-julia> float(1:1000)
-1.0:1.0:1000.0
-
 julia> float(typemax(Int32))
 2.147483647e9
 ```
@@ -1190,7 +1187,20 @@ floattype(::Type{Int16}) = Float16
 
 
 ## Array operations on floating point numbers ##
+"""
+    float(A::AbstractArray)
+
+Return an array containing the floating-point analog of each entry in array `A`.
+
+Equivalent to `float.(A)`, except that the return value may share memory with all or
+part of `A` in accordance with the behavior of `convert(T, A)` given output type `T`.
 
+# Examples
+```jldoctest
+julia> float(1:1000)
+1.0:1.0:1000.0
+```
+"""
 float(A::AbstractArray{<:AbstractFloat}) = A
 
 function float(A::AbstractArray{T}) where T