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:
Mahdi Mokhtari 2017-02-17 08:25:48 +00:00
parent a287735349
commit 1fdfb24aa7
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=313864

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