162 lines
4.8 KiB
Plaintext
162 lines
4.8 KiB
Plaintext
\input texinfo.tex
|
|
@setfilename libm.info
|
|
@tex
|
|
% NOTE LOCAL KLUGE TO AVOID TOO MUCH WHITESPACE FROM "makedoc"
|
|
\global\long\def\example{%
|
|
\begingroup
|
|
\let\aboveenvbreak=\par
|
|
\let\afterenvbreak=\par
|
|
\parskip=0pt
|
|
\lisp}
|
|
\global\long\def\Eexample{%
|
|
\Elisp
|
|
\endgroup
|
|
\vskip -\parskip% to cancel out effect of following \par
|
|
}
|
|
% END LOCAL WHITESPACE KLUGE
|
|
@end tex
|
|
@syncodeindex fn cp
|
|
|
|
@ifinfo
|
|
@format
|
|
START-INFO-DIR-ENTRY
|
|
* libm:: An ANSI-C conforming mathematical library.
|
|
END-INFO-DIR-ENTRY
|
|
@end format
|
|
@end ifinfo
|
|
|
|
@ifinfo
|
|
This file documents an ANSI-C conforming mathematical subroutine library.
|
|
|
|
Copyright (C) 1992, 1993, 1995 Cygnus Support
|
|
|
|
@file{libm} includes software developed at SunPro, a Sun Microsystems,
|
|
Inc. business. Permission to use, copy, modify, and distribute this
|
|
software is freely granted, provided that this notice is preserved.
|
|
|
|
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.
|
|
|
|
@ignore
|
|
Permission is granted to process this file through Tex and print the
|
|
results, provided the printed document carries copying permission
|
|
notice identical to this one except for the removal of this paragraph
|
|
(this paragraph not being relevant to the printed manual).
|
|
|
|
@end ignore
|
|
Permission is granted to copy and distribute modified versions of this
|
|
manual under the conditions for verbatim copying, subject to the terms
|
|
of the GNU General Public License, which includes the provision that the
|
|
entire resulting derived work is distributed under the terms of a
|
|
permission notice identical to this one.
|
|
|
|
Permission is granted to copy and distribute translations of this manual
|
|
into another language, under the above conditions for modified versions.
|
|
@end ifinfo
|
|
@iftex
|
|
@finalout
|
|
@setchapternewpage odd
|
|
@settitle Cygnus C Math Library
|
|
@titlepage
|
|
@title The Cygnus C Math Library
|
|
@sp 1
|
|
@subtitle @code{libm} 1.4
|
|
@subtitle December 1995
|
|
@author {Steve Chamberlain}
|
|
@author {Roland Pesch}
|
|
@author {Cygnus Support}
|
|
@page
|
|
|
|
@tex
|
|
{\parskip=0pt
|
|
\hfill Cygnus Support\par
|
|
\hfill sac@@cygnus.com\par
|
|
\hfill pesch@@cygnus.com\par
|
|
}
|
|
\global\parindent=0pt % Steve likes it this way
|
|
@end tex
|
|
|
|
@vskip 0pt plus 1filll
|
|
Copyright @copyright{} 1992, 1993 Cygnus Support
|
|
|
|
@file{libm} includes software developed at SunPro, a Sun Microsystems,
|
|
Inc. business. Permission to use, copy, modify, and distribute this
|
|
software is freely granted, provided that this notice is preserved.
|
|
|
|
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, subject to the terms
|
|
of the GNU General Public License, which includes the provision that the
|
|
entire resulting derived work is distributed under the terms of a
|
|
permission notice identical to this one.
|
|
|
|
Permission is granted to copy and distribute translations of this manual
|
|
into another language, under the above conditions for modified versions.
|
|
@end titlepage
|
|
@end iftex
|
|
|
|
@ifinfo
|
|
@node Top
|
|
@top LIBM
|
|
@end ifinfo
|
|
|
|
@menu
|
|
* Math:: The mathematical functions (`math.h').
|
|
* Reentrancy:: The functions in libm are not reentrant by default.
|
|
* Index::
|
|
@end menu
|
|
|
|
@include targetdep.tex
|
|
|
|
@node Reentrancy
|
|
@chapter Reentrancy Properties of @code{libm}
|
|
|
|
@cindex reentrancy
|
|
@cindex @code{matherr} and reentrancy
|
|
When a libm function detects an exceptional case, @code{errno} may be
|
|
set, the @code{matherr} function may be called, and a error message
|
|
may be written to the standard error stream. This behavior may not
|
|
be reentrant.
|
|
|
|
@c The exact behavior depends on the currently selected error handling
|
|
@c mode (IEEE, POSIX, X/Open, or SVID).
|
|
|
|
With reentrant C libraries like the Cygnus C library, @code{errno} is
|
|
a macro which expands to the per-thread error value. This makes it thread
|
|
safe.
|
|
|
|
When the user provides his own @code{matherr} function it must be
|
|
reentrant for the math library as a whole to be reentrant.
|
|
|
|
In normal debugged programs, there are usually no math subroutine
|
|
errors---and therefore no assignments to @code{errno} and no @code{matherr}
|
|
calls; in that situation, the math functions behave reentrantly.
|
|
|
|
@node Index
|
|
@unnumbered Index
|
|
@printindex cp
|
|
|
|
@tex
|
|
% I think something like @colophon should be in texinfo. In the
|
|
% meantime:
|
|
\long\def\colophon{\hbox to0pt{}\vfill
|
|
\centerline{The body of this manual is set in}
|
|
\centerline{\fontname\tenrm,}
|
|
\centerline{with headings in {\bf\fontname\tenbf}}
|
|
\centerline{and examples in {\tt\fontname\tentt}.}
|
|
\centerline{{\it\fontname\tenit\/} and}
|
|
\centerline{{\sl\fontname\tensl\/}}
|
|
\centerline{are used for emphasis.}\vfill}
|
|
\page\colophon
|
|
% Blame: pesch@cygnus.com, 28mar91.
|
|
@end tex
|
|
|
|
@contents
|
|
@bye
|
|
|
|
|