]> git.ipfire.org Git - thirdparty/man-pages.git/blobdiff - man3/cosh.3
All pages: Remove the 5th argument to .TH
[thirdparty/man-pages.git] / man3 / cosh.3
index 2cf4c89335353fdb9f8574485112ae85449d7166..ee7a2bc99ceb5c27240e933da6da8052fd332597 100644 (file)
@@ -2,27 +2,7 @@
 .\" and Copyright 2008, Linux Foundation, written by Michael Kerrisk
 .\"     <mtk.manpages@gmail.com>
 .\"
-.\" %%%LICENSE_START(VERBATIM)
-.\" Permission is granted to make and distribute verbatim copies of this
-.\" manual provided the copyright notice and this permission notice are
-.\" preserved on all copies.
-.\"
-.\" Permission is granted to copy and distribute modified versions of this
-.\" manual under the conditions for verbatim copying, provided that the
-.\" entire resulting derived work is distributed under the terms of a
-.\" permission notice identical to this one.
-.\"
-.\" Since the Linux kernel and libraries are constantly changing, this
-.\" manual page may be incorrect or out-of-date.  The author(s) assume no
-.\" responsibility for errors or omissions, or for damages resulting from
-.\" the use of the information contained herein.  The author(s) may not
-.\" have taken the same level of care in the production of this manual,
-.\" which is licensed free of charge, as they might when working
-.\" professionally.
-.\"
-.\" Formatted or processed versions of this manual, if unaccompanied by
-.\" the source, must acknowledge the copyright and authors of this work.
-.\" %%%LICENSE_END
+.\" SPDX-License-Identifier: Linux-man-pages-copyleft
 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\" Modified 2002-07-27 by Walter Harms
 .\" (walter.harms@informatik.uni-oldenburg.de)
 .\"
-.TH COSH 3 2015-03-02 ""  "Linux Programmer's Manual"
+.TH COSH 3 2021-03-22 "Linux man-pages (unreleased)"
 .SH NAME
 cosh, coshf, coshl \- hyperbolic cosine function
+.SH LIBRARY
+Math library
+.RI ( libm ", " \-lm )
 .SH SYNOPSIS
 .nf
 .B #include <math.h>
-.sp
+.PP
 .BI "double cosh(double " x );
-.br
 .BI "float coshf(float " x );
-.br
 .BI "long double coshl(long double " x );
 .fi
-.sp
-Link with \fI\-lm\fP.
-.sp
-.in -4n
+.PP
+.RS -4
 Feature Test Macro Requirements for glibc (see
 .BR feature_test_macros (7)):
-.in
-.sp
-.ad l
+.RE
+.PP
 .BR coshf (),
 .BR coshl ():
-.RS 4
-_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\ >=\ 600 || _ISOC99_SOURCE ||
-_POSIX_C_SOURCE\ >=\ 200112L;
-.br
-or
-.I cc\ -std=c99
-.RE
-.ad
-.SH DESCRIPTION
-The
-.BR cosh ()
-function returns the hyperbolic cosine of
-.IR x ,
-which
-is defined mathematically as:
 .nf
-
-    cosh(x) = (exp(x) + exp(\-x)) / 2
+    _ISOC99_SOURCE || _POSIX_C_SOURCE >= 200112L
+        || /* Since glibc 2.19: */ _DEFAULT_SOURCE
+        || /* Glibc <= 2.19: */ _BSD_SOURCE || _SVID_SOURCE
 .fi
+.SH DESCRIPTION
+These functions return the hyperbolic cosine of
+.IR x ,
+which is defined mathematically as:
+.PP
+.in +4n
+.EX
+cosh(x) = (exp(x) + exp(\-x)) / 2
+.EE
+.in
 .SH RETURN VALUE
 On success, these functions return the hyperbolic cosine of
 .IR x .
-
+.PP
 If
 .I x
 is a NaN, a NaN is returned.
-
+.PP
 If
 .I x
 is +0 or \-0, 1 is returned.
-
+.PP
 If
 .I x
 is positive infinity or negative infinity,
 positive infinity is returned.
-
+.PP
 If the result overflows,
 a range error occurs,
 and the functions return
@@ -119,9 +93,11 @@ is raised.
 .SH ATTRIBUTES
 For an explanation of the terms used in this section, see
 .BR attributes (7).
+.ad l
+.nh
 .TS
 allbox;
-lbw24 lb lb
+lbx lb lb
 l l l.
 Interface      Attribute       Value
 T{
@@ -130,9 +106,12 @@ T{
 .BR coshl ()
 T}     Thread safety   MT-Safe
 .TE
-.SH CONFORMING TO
+.hy
+.ad
+.sp 1
+.SH STANDARDS
 C99, POSIX.1-2001, POSIX.1-2008.
-
+.PP
 The variant returning
 .I double
 also conforms to