Cool: start to document methods individually

Author: moritz

lib/Type/Cool.pod

@@ -34,7 +34,7 @@ what type they coerce to:
     abs             Numeric
     conj            Numeric
     sqrt            Numeric
-    sign            Numeric
+    sign            Real
     rand            Numeric
     sin             Numeric
     asin            Numeric
@@ -94,4 +94,185 @@ what type they coerce to:
 
 =end table
 
+=head1 Methods
+
+=head2 method abs
+
+    method abs()
+
+Coerces the invocant to L<Numeric|/type/Numeric> and returns the absolute
+value (that is, a non-negative number).
+
+=head2 method conj
+
+    method conj()
+
+Coerces the invocant to L<Numeric|/type/Numeric> and returns the
+L<complex|/type/Complex> conjugate (that is, the number with the sign of the
+imaginary part negated).
+
+=head2 method sqrt
+
+    method sqrt()
+
+Coerces the invocant to L<Numeric|/type/Numeric> and returns the square root,
+that is, a non-negative number that, when multiplied with itself, produces the
+original number.
+
+=head2 method sign
+
+    method sign()
+
+Coerces the invocant to L<Numeric|/type/Real> and returns its sign, that
+is, 0 if the number is 0, 1 for positive and -1 for negative values.
+
+=head2 method rand
+
+    method rand()
+
+Coerces the invocant to L<Num|/type/Num> and returns a pseudo-random value
+between zero and the number.
+
+=head2 method sin
+
+    method sin()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+returns its L<sine|https://en.wikipedia.org/wiki/Sine>.
+
+=head2 method asin
+
+    method asin()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<arc-sine|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
+radians.
+
+=head2 method cos
+
+    method cos()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+returns its L<sine|https://en.wikipedia.org/wiki/Cosine>.
+
+=head2 method acos
+
+    method acos()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<arc-cosine|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
+radians.
+
+=head2 method tan
+
+Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+returns its L<tangens|https://en.wikipedia.org/wiki/Tangent>.
+
+=head2 method atan
+
+    method atan()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<arc-tangens|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
+radians.
+
+=head2 method atan2
+
+    method atan2($y = 1e0)
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and together with its
+argument, returns its two-argument
+L<arc-tangens|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
+radians.
+
+=head2 method sec
+
+    method sec()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+returns its L<secans|https://en.wikipedia.org/wiki/Trigonometric_functions#Reciprocal_functions>,
+that is, the reciprocal of its cosine.
+
+=head2 method asec
+
+    method asec()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<arc-secans|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
+radians.
+
+=head2 method cosec
+
+    method cosec()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+returns its L<cosecans|https://en.wikipedia.org/wiki/Trigonometric_functions#Reciprocal_functions>,
+that is, the reciprocal of its sine.
+
+=head2 method acosec
+
+    method acosec()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<arc-cosecans|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
+radians.
+
+=head2 method cotan
+
+    method cotan()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+returns its L<cotangens|https://en.wikipedia.org/wiki/Trigonometric_functions#Reciprocal_functions>,
+that is, the reciprocal of its tangens.
+
+=head2 method acotan
+
+    method acotan()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<arc-cotangens|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
+radians.
+
+=head2 method sinh
+
+    method sinh()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<Sine hyperbolicus|https://en.wikipedia.org/wiki/Hyperbolic_function>.
+
+=head2 method asinh
+
+    method asinh()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<Inverse Sine hyperbolicus|https://en.wikipedia.org/wiki/Inverse_hyperbolic_function>.
+
+=head2 method cosh
+
+    method cosh()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<Cosine hyperbolicus|https://en.wikipedia.org/wiki/Hyperbolic_function>.
+
+=head2 method acosh
+
+    method acosh()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<Inverse Cosine hyperbolicus|https://en.wikipedia.org/wiki/Inverse_hyperbolic_function>.
+
+=head2 method tanh
+
+    method tanh()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<Tangens hyperbolicus|https://en.wikipedia.org/wiki/Hyperbolic_function>.
+
+=head2 method atanh
+
+    method atanh()
+
+Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+L<Inverse tangens hyperbolicus|https://en.wikipedia.org/wiki/Inverse_hyperbolic_function>.
+
 =end pod