Deprecate @test_approx_eq_eps (part of #4615)

Author: StefanKarpinski

base/test.jl

@@ -16,7 +16,7 @@ module Test
 export @test, @test_throws, @test_broken, @test_skip, @test_warn, @test_nowarn
 export @testset
 # Legacy approximate testing functions, yet to be included
-export @test_approx_eq_eps, @inferred
+export @inferred
 export detect_ambiguities
 export GenericString
 
@@ -1004,6 +1004,8 @@ end
 #-----------------------------------------------------------------------
 # Legacy approximate testing functions, yet to be included
 
+# BEGIN TODO: deprecated in 0.6, delete in 1.0
+# vvv
 approx_full(x::AbstractArray) = x
 approx_full(x::Number) = x
 approx_full(x) = full(x)
@@ -1050,8 +1052,11 @@ Test two floating point numbers `a` and `b` for equality taking into account
 a margin of tolerance given by `tol`.
 """
 macro test_approx_eq_eps(a, b, c)
+    Base.depwarn(string("@test_approx_eq_eps is deprecated, use `@test ", a, " ≈ ", b, " atol=", c, "` instead"),
+                 Symbol("@test_approx_eq_eps"))
     :(test_approx_eq($(esc(a)), $(esc(b)), $(esc(c)), $(string(a)), $(string(b))))
 end
+export @test_approx_eq_eps
 
 """
     @test_approx_eq(a, b)
@@ -1065,6 +1070,8 @@ macro test_approx_eq(a, b)
     :(test_approx_eq($(esc(a)), $(esc(b)), $(string(a)), $(string(b))))
 end
 export @test_approx_eq
+# ^^^
+# END TODO
 
 _args_and_call(args...; kwargs...) = (args[1:end-1], kwargs, args[end](args[1:end-1]...; kwargs...))
 """