Bug#731505: Math::Trig mention output units

[Russ Allbery]

jidanni at jidanni.org writes:

> Package: perl-doc
> Version: 5.18.1-4
> Severity: wishlist
> File: /usr/share/man/man3/Math::Trig.3perl.gz

> The author neglects to mention what units are used in the output of each
> function until late in the page if at all...

Well, more precisely, the input units for some functions (like tan or sec)
and the output units of other functions (like asin).

The documentation should say somewhere that all angles, for both input or
output from the functions, are in radians.  That is the normal
mathematical convention, but (in high school) I was originally taught trig
functions in degrees, so I agree that this could be confusing and doesn't
appear to be stated clearly anywhere.

-- 
Russ Allbery (rra at debian.org)               <http://www.eyrie.org/~eagle/>