Add documentations related to new APIs of r313761

PR:		216850 216851 216852 216856 216857 216858
Submitted by:	sgk@troutmask.apl.washington.edu
Reported by:	sgk@troutmask.apl.washington.edu
Reviewed by:	bde emaste hselasky
Approved by:	bde emaste hselasky
Differential Revision:	https://reviews.freebsd.org/D9491
This commit is contained in:
mmokhi 2017-02-17 08:25:48 +00:00
parent a6ce30ab45
commit 51f3ae3ea6

View File

@ -24,23 +24,29 @@
.\"
.\" $FreeBSD$
.\"
.Dd Jul 14, 2015
.Dd February 15, 2017
.Dt CACOS 3
.Os
.Sh NAME
.Nm cacos ,
.Nm cacosf ,
.Nm cacosl ,
.Nm cacosh ,
.Nm cacoshf ,
.Nm cacoshl ,
.Nm casin ,
.Nm casinf
.Nm casinf ,
.Nm casinl ,
.Nm casinh ,
.Nm casinhf
.Nm catan ,
.Nm catanf
.Nm casinhf ,
.Nm casinhl ,
.Nm catan ,
.Nm catanf ,
.Nm catanl ,
.Nm catanh ,
.Nm catanhf
.Nd complex arc trigonometric and hyperbolic functions
.Nm catanhf ,
.Nm catanhl
.Nd complex inverse trigonometric and hyperbolic functions
.Sh LIBRARY
.Lb libm
.Sh SYNOPSIS
@ -49,26 +55,38 @@
.Fn cacos "double complex z"
.Ft float complex
.Fn cacosf "float complex z"
.Ft long double complex
.Fn cacosl "long double complex z"
.Ft double complex
.Fn cacosh "double complex z"
.Ft float complex
.Fn cacoshf "float complex z"
.Ft long double complex
.Fn cacoshl "long double complex z"
.Ft double complex
.Fn casin "double complex z"
.Ft float complex
.Fn casinf "float complex z"
.Ft long double complex
.Fn casinl "long double complex z"
.Ft double complex
.Fn casinh "double complex z"
.Ft float complex
.Fn casinhf "float complex z"
.Ft long double complex
.Fn casinhl "long double complex z"
.Ft double complex
.Fn catan "double complex z"
.Ft float complex
.Fn catanf "float complex z"
.Ft long double complex
.Fn catanl "long double complex z"
.Ft double complex
.Fn catanh "double complex z"
.Ft float complex
.Fn catanhf "float complex z"
.Ft long double complex
.Fn catanhl "long double complex z"
.Sh DESCRIPTION
The
.Fn cacos ,
@ -97,10 +115,22 @@ and
functions perform the same operations in
.Fa float
precision.
The
.Fn cacosl ,
.Fn casinl ,
.Fn catanl
.Fn cacoshl ,
.Fn casinhl ,
and
.Fn catanhl
functions perform the same operations in
.Fa long double
precision.
.Pp
.ds Un \[cu]
There is no universal convention for defining the principal values of
these functions. The following table gives the branch cuts, and the
these functions.
The following table gives the branch cuts, and the
corresponding ranges for the return values, adopted by the C language.
.Bl -column ".Sy Function" ".Sy (-\*(If*I, -I) \*(Un (I, \*(If*I)" ".Sy [-\*(Pi/2*I, \*(Pi/2*I]"
.It Sy Function Ta Sy Branch Cut(s) Ta Sy Range