Any: many of those methods also exists in sub form

Author: moritz

lib/Type/Cool.pod

@@ -152,11 +152,12 @@ between zero and the number.
 
     say 1e5.rand;           # 33128.495184283
 
-=head2 method sin
+=head2 routine sin
 
     method sin()
+    sub sin(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+Coerces the invocant (or in the sub firm, the argument) to L<Numeric|/type/Numeric>, interprets it as radians,
 returns its L<sine|https://en.wikipedia.org/wiki/Sine>.
 
     say sin(0);             # 0
@@ -167,139 +168,165 @@ Note that Perl 6 is no computer algebra system, so C<sin(pi)> typically does
 not produce an exact 0, but rather a very small L<floating-point
 number|/type/Num>.
 
-=head2 method asin
+=head2 routine asin
 
+    sub asin(Numeric(Cool))
     method asin()
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in the sub firm, the argument) to L<Numeric|/type/Numeric>, and returns its
 L<arc-sine|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
 radians.
 
-=head2 method cos
+    say 0.1.asin;               # 0.10016742116156
+
+=head2 routine cos
 
     method cos()
+    sub cos(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+Coerces the invocant (or in sub form, the argument) to L<Numeric|/type/Numeric>, interprets it as radians,
 returns its L<sine|https://en.wikipedia.org/wiki/Cosine>.
 
-=head2 method acos
+    say 0.cos;                  # 1
+    say pi.cos;                 # -1
+    say cos(pi/2);              # 6.12323399573677e-17
+
+=head2 routine acos
 
     method acos()
+    sub acos(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in sub form, the argument) to L<Numeric|/type/Numeric>, and returns its
 L<arc-cosine|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
 radians.
 
-=head2 method tan
+=head2 routine tan
 
-Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+    method tan()
+    sub acos(Numeric(Cool))
+
+Coerces the invocant (or in sub form, the argument) to L<Numeric|/type/Numeric>, interprets it as radians,
 returns its L<tangens|https://en.wikipedia.org/wiki/Tangent>.
 
-=head2 method atan
+=head2 routine atan
 
     method atan()
+    sub atan(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in sub form, the argument) to L<Numeric|/type/Numeric>, and returns its
 L<arc-tangens|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
 radians.
 
-=head2 method atan2
+=head2 routine atan2
 
     method atan2($y = 1e0)
+    sub atan2(Numeric() $x, Numeric() $y = 1e0)
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and together with its
-argument, returns its two-argument
+Coerces the arguments (including the invocant in the method form) to L<Numeric|/type/Numeric>,
+and returns their two-argument
 L<arc-tangens|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
 radians.
 
 =head2 method sec
 
     method sec()
+    sub sec(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+Coerces the invocant (or in sub form, its argument) 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
+=head2 routine asec
 
     method asec()
+    sub asec(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in sub form, its argument) to L<Numeric|/type/Numeric>, and returns its
 L<arc-secans|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
 radians.
 
-=head2 method cosec
+=head2 routine cosec
 
     method cosec()
+    sub cosec(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+Coerces the invocant (or in sub form, its argument) 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
+=head2 routine acosec
 
     method acosec()
+    sub acosec(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in sub form, its argument) to L<Numeric|/type/Numeric>, and returns its
 L<arc-cosecans|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
 radians.
 
-=head2 method cotan
+=head2 routine cotan
 
     method cotan()
+    sub cotangens(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, interprets it as radians,
+Coerces the invocant (or in sub form, its argument) 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
+=head2 routine acotan
 
     method acotan()
+    sub acotan(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in method form, its argument) to L<Numeric|/type/Numeric>, and returns its
 L<arc-cotangens|https://en.wikipedia.org/wiki/Inverse_trigonometric_functions> in
 radians.
 
-=head2 method sinh
+=head2 routine sinh
 
     method sinh()
+    sub sinh(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in method form, its argument) to L<Numeric|/type/Numeric>, and returns its
 L<Sine hyperbolicus|https://en.wikipedia.org/wiki/Hyperbolic_function>.
 
-=head2 method asinh
+=head2 routine asinh
 
     method asinh()
+    sub asinh(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in method form, its argument) to L<Numeric|/type/Numeric>, and returns its
 L<Inverse Sine hyperbolicus|https://en.wikipedia.org/wiki/Inverse_hyperbolic_function>.
 
-=head2 method cosh
+=head2 routine cosh
 
     method cosh()
+    sub cosh(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in method form, its argument) to L<Numeric|/type/Numeric>, and returns its
 L<Cosine hyperbolicus|https://en.wikipedia.org/wiki/Hyperbolic_function>.
 
-=head2 method acosh
+=head2 routine acosh
 
     method acosh()
+    sub acosh(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in method form, its argument) to L<Numeric|/type/Numeric>, and returns its
 L<Inverse Cosine hyperbolicus|https://en.wikipedia.org/wiki/Inverse_hyperbolic_function>.
 
-=head2 method tanh
+=head2 routine tanh
 
     method tanh()
+    sub tanh(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in method form, its argument) to L<Numeric|/type/Numeric>, and returns its
 L<Tangens hyperbolicus|https://en.wikipedia.org/wiki/Hyperbolic_function>.
 
-=head2 method atanh
+=head2 routine atanh
 
     method atanh()
+    sub atanh(Numeric(Cool))
 
-Coerces the invocant to L<Numeric|/type/Numeric>, and returns its
+Coerces the invocant (or in method form, its argument) to L<Numeric|/type/Numeric>, and returns its
 L<Inverse tangens hyperbolicus|https://en.wikipedia.org/wiki/Inverse_hyperbolic_function>.
 
 =head2 method log