More trig docstring cleanout

Author: kshyatt

base/docs/helpdb/Base.jl

@@ -976,13 +976,6 @@ seeding.
 """
 srand
 
-"""
-    acot(x)
-
-Compute the inverse cotangent of `x`, where the output is in radians.
-"""
-acot
-
 """
     oftype(x, y)
 
@@ -2640,13 +2633,6 @@ Get the concrete type of `x`.
 """
 typeof
 
-"""
-    acsc(x)
-
-Compute the inverse cosecant of `x`, where the output is in radians
-"""
-acsc
-
 """
     log(x)
 
@@ -3059,13 +3045,6 @@ Element-wise less-than-or-equals comparison operator.
 """
 Base.:(.<=)
 
-"""
-    asec(x)
-
-Compute the inverse secant of `x`, where the output is in radians.
-"""
-asec
-
 """
     rank(M)
 
@@ -4925,13 +4904,6 @@ recurses infinitely.
 """
 StackOverflowError
 
-"""
-    acsch(x)
-
-Compute the inverse hyperbolic cosecant of `x`.
-"""
-acsch
-
 """
     process_running(p::Process)
 
@@ -5689,13 +5661,6 @@ Read a UDP packet from the specified socket, and return the bytes received. This
 """
 recv
 
-"""
-    acoth(x)
-
-Compute the inverse hyperbolic cotangent of `x`.
-"""
-acoth
-
 """
     det(M)
 
@@ -6038,13 +6003,6 @@ the integrity and correctness of data read from `stream`.
 """
 deserialize
 
-"""
-    asech(x)
-
-Compute the inverse hyperbolic secant of `x`.
-"""
-asech
-
 """
     ismarked(s)
 

base/special/trig.jl

@@ -319,10 +319,13 @@ for (finv, f) in ((:sec, :cos), (:csc, :sin), (:cot, :tan),
     end
 end
 
-for (fa, fainv) in ((:asec, :acos), (:acsc, :asin), (:acot, :atan),
-                    (:asech, :acosh), (:acsch, :asinh), (:acoth, :atanh))
+for (fa, fainv, fn) in ((:asec, :acos, "secant"), (:acsc, :asin, "cosecant"), (:acot, :atan, "cotangent"),
+                        (:asech, :acosh, "hyperbolic secant"), (:acsch, :asinh, "hyperbolic cosecant"), (:acoth, :atanh, "hyperbolic cotangent"))
+    name = string(fa)
     @eval begin
-        ($fa){T<:Number}(y::T) = ($fainv)(one(T) / y)
+        @doc """
+            $($name)(x)
+        Compute the $($fn) of `x`, where the output is in radians. """ ($fa){T<:Number}(y::T) = ($fainv)(one(T) / y)
         ($fa){T<:Number}(y::AbstractArray{T}) = ($fainv)(one(T) ./ y)
     end
 end