Start of 3.08

This commit is contained in:
Michael Kerrisk 2008-08-12 14:39:04 +00:00
parent 0b5e24c5e7
commit ed2d26a8ad
4 changed files with 515 additions and 481 deletions

479
Changes
View File

@ -1,6 +1,6 @@
==================== Changes in man-pages-3.07 ====================
==================== Changes in man-pages-3.08 ====================
Released: 2008-08-12, Konolfingen
Released: 2008-??-??, ???????????
Contributors
@ -9,24 +9,6 @@ Contributors
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Alain Portal <aportal@univ-montp2.fr>
Andries Brouwer <Andries.Brouwer@cwi.nl>
Christoph Lameter <cl@linux-foundation.org>
Cliff Wickman <cpw@sgi.com>
Fabian Kreutz <kreutz@dbs.uni-hannover.de>
Filippo Santovito <filippo.santovito@email.it>
Gerrit Renker <gerrit@erg.abdn.ac.uk>
Heikki Orsila <shd@modeemi.cs.tut.fi>
Khalil GHORBAL <khalil.ghorbal@cea.fr>
Lee Schermerhorn <lee.schermerhorn@hp.com>
Maxin John <maxin.john@gmail.com>
Reuben Thomas <rrt@sc3d.org>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Sam Varshavchik <mrsam@courier-mta.com>
Soh Kam Yung <sohkamyung@gmail.com>
Stephane Chazelas <stephane_chazelas@yahoo.fr>
Pavel Heimlich <tropikhajma@seznam.cz>
Reuben Thomas <rrt@sc3d.org>
Apologies if I missed anyone!
@ -34,475 +16,18 @@ Apologies if I missed anyone!
New and rewritten pages
-----------------------
move_pages.2
Christoph Lameter, various edits and improvements by mtk
Documentation of the move_pages() system call.
This page was formerly part of the numactl package, but really
belongs in man-pages (since it describes a kernel interface).
clock_getcpuclockid.3
mtk
New page documenting the clock_getcpuclockid() library function,
available since glibc 2.2.
udplite.7
Gerrit Renker
Document the Linux implementation of the UDP-Lite protocol,
new in Linux 2.6.20.
Newly documented interfaces in existing pages
---------------------------------------------
proc.5
Christoph Lameter, minor edits and improvements by mtk
Documentation of the /proc/PID/numa_maps file.
This material was formerly the numa_maps.5 page in the numactl
package, but really belongs in man-pages (since it describes
a kernel interface).
Global changes
--------------
nanosleep.2
inet_ntop.3
inet_pton.3
scanf.3
initrd.4
mtk
Fix mis-ordered (.SH) sections.
connect.2
socket.2
rtnetlink.3
arp.7
ddp.7
ip.7
ipv6.7
netlink.7
packet.7
raw.7
rtnetlink.7
socket.7
tcp.7
udp.7
unix.7
x25.7
mtk
s/PF_/AF_/ for socket family constants. Reasons: the AF_ and
PF_ constants have always had the same values; there never has
been a protocol family that had more than one address family,
and POSIX.1-2001 only specifies the AF_* constants.
Typographical or grammatical errors have been corrected in several
other places.
Changes to individual pages
---------------------------
execve.2
mtk
The floating-point environment is reset to the default
during an execve().
getitimer.2
mtk
CONFORMING TO: POSIX.1-2008 marks getitimer() and setitimer()
obsolete.
get_mempolicy.2
Lee Schermerhorn
Misc cleanup of get_mempolicy(2):
+ mention that any mode flags will be saved with mode.
I don't bother to document mode flags here because we
already have a pointer to set_mempolicy(2) for more info
on memory policy. mode flags are discussed there.
+ remove some old, obsolete [IMO] NOTES and 'roff comments.
Lee Schermerhorn
Update the get_mempolicy(2) man page to add in the description of
the MPOL_F_MEMS_ALLOWED flag, added in 2.6.23.
mtk
Document additional EINVAL error that occurs is MPOL_F_MEMS_ALLOWED
is specified with either MPOL_F_ADDR or MPOL_F_NODE.
mbind.2
Lee Schermerhorn
Fix error conditions, now that the kernel silently ignores
nodes outside the task's cpuset, as long as one valid node
remains.
Now that cpuset man page exists, we can refer to it. Remove
stale comment regarding lack thereof.
Lee Schermerhorn
Add brief discussion of mode flags.
Lee Schermerhorn
Attempt to clarify discussion of MPOL_DEFAULT.
mtk
Fix URI reference for libnuma.
mprotect.2
mtk / Maxin John
Remove EFAULT from errors. Under ENOMEM error, note that
EFAULT was the error produced in some cases for kernels before
2.4.19.
msgctl.2
mtk, after a note from Filippo Santovito
In the ipc_perm structure definition, some fields were
incorrectly named: s/key/__key/ and s/seq/__seq/.
set_mempolicy.2
Lee Schermerhorn
Fix up the error return for nodemask containing nodes disallowed by
the process' current cpuset. Disallowed nodes are now silently ignored,
as long as the nodemask contains at least one node that is on-line,
allowed by the process' cpuset and has memory.
Now that we have a cpuset man page, we can refer to cpusets directly
in the man page text.
Lee Schermerhorn
Another attempt to rationalize description of MPOL_DEFAULT.
Since ~2.6.25, the system default memory policy is "local allocation".
MPOL_DEFAULT itself is a request to remove any non-default policy and
"fall back" to the surrounding context. Try to say that without delving
into implementation details.
Lee Schermerhorn
Add discussion of mempolicy mode flags to set_mempolicy(2).
This adds another reason for EINVAL.
setpgid.2
mtk
CONFORMING TO: POSIX.1-2008 marks setpgrp() obsolete.
semctl.2
mtk, after a note from Filippo Santovito
In the ipc_perm structure definition, some fields were
incorrectly named: s/key/__key/ and s/seq/__seq/.
shmctl.2
Filippo Santovito / mtk
In the ipc_perm structure definition, some fields were
incorrectly named: s/key/__key/ and s/seq/__seq/.
utime.2
mtk
CONFORMING TO: POSIX.1-2008 marks utime() obsolete.
CONFORMING TO: POSIX.1-2008 removes the POSIX.1-2001 LEGACY
marking of utimes(), so mention of this point has been
removed from the page.
vfork.2
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of vfork().
atan2.3
Fabian Kreutz
SEE ALSO Add carg(3).
bcmp.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of bcmp().
bsd_signal.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification ofcw
bsd_signal().
bzero.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of bzero().
cexp2.3
mtk
AVAILABILITY: These functions are still not in glibc
as at version 2.8.
clock_getres.3
mtk
SEE ALSO: Add clock_getcpuclockid(3).
clog2.3
mtk
AVAILABILITY: These functions are still not in glibc
as at version 2.8.
ctime.3
mtk
POSIX.1-2008 marks asctime(), asctime_r(), ctime(), and ctime_r()
as obsolete.
dprintf.3
mtk
CONFORMING TO: These functions are nowadays in POSIX.1-2008.
ecvt.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specifications of
ecvt() and fcvt().
ftime.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of ftime().
ftw.3
mtk
CONFORMING TO: POSIX.1-2008 marks ftw() as obsolete.
gcvt.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of gcvt().
getcwd.3
Reuben Thomas / mtk
Clarify description of getcwd() for buf==NULL case;
CONFORMING TO: According to POSIX.1, the behavior of getcwd()
is unspecified for the buf==NULL case.
mtk
Add an introductory paragraph giving an overview of what these
functions do.
Fix error in description of getwd(): it does not truncate the
pathname; rather, it gives an error if the pathname exceeds
PATH_MAX bytes.
Rewrote RETURN VALUE section.
Add EINVAL ENAMETOOLONG errors for getwd().
Various other clarifications and wording fixes.
CONFORMING TO: POSIX.1-2001 does not define any errors for
getwd().
CONFORMING TO: POSIX.1-2008 removes the specification of getwd().
gethostbyname.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specifications of
gethostbyname(), gethostbyaddr(), and h_errno.
gets.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of gets().
iconv.3
iconv_close.3
iconv_open.3
mtk
VERSIONS: These functions are available in glibc since version 2.1.
index.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specifications of
index() and rindex().
isalpha.3
mtk
CONFORMING TO: POSIX.1-2008 marks isalpha() as obsolete.
makecontext.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specifications of
makecontext() and swapcontext().
memchr.3
mtk
VERSIONS: memrchr() since glibc 2.2; rawmemchr() since glibc 2.1.
mempcpy.3
mtk
VERSIONS: mempcpy() since glibc 2.1.
mktemp.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of mktemp().
opendir.3
mtk
CONFORMING TO: POSIX.1-2008 specifies fdopendir().
rand.3
mtk
CONFORMING TO: POSIX.1-2008 marks rand_r() as obsolete.
siginterrupt.3
mtk
CONFORMING TO: POSIX.1-2008 marks siginterrupt() as obsolete.
sigset.3
mtk
CONFORMING TO: POSIX.1-2008 marks sighold(), sigignore(),
sigpause(), sigrelse(), and sigset() as obsolete.
strchr.3
mtk
VERSIONS: strchrnul() since glibc 2.1.1.
tempnam.3
mtk
CONFORMING TO: POSIX.1-2008 marks tempnam() as obsolete.
tmpnam.3
mtk
CONFORMING TO: POSIX.1-2008 marks tmpnam() as obsolete.
toascii.3
mtk
CONFORMING TO: POSIX.1-2008 marks toascii() as obsolete.
ualarm.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of ualarm().
ulimit.3
mtk
CONFORMING TO: POSIX.1-2008 marks ulimit() as obsolete.
usleep.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of usleep().
standards.7
mtk
Updated details for POSIX.1-2008, and noted that if
POSIX.1-2001 is listed in the CONFORMING TO section of a man
page, then the reader can assume that the interface is also
specified in POSIX.1-2008, unless otherwise noted.
time.7
mtk
SEE ALSO: Add clock_getcpuclockid(3).
udp.7
mtk
SEE ALSO: add udplite(7).
Changes to individual pages (math functions)
--------------------------------------------
Various changes here following on from the big update to the
math pages in the previous release. Test results going back
glibc 2.3.2 (so far) allowed updates to various pages to note
changes in historical behavior for error reporting by math
functions. Thanks to the following people for providing me
with test results on various distributions and glibc versions:
Alain Portal, Andries Brouwer, Fabian Kreutz, Heikki Orsila,
Khalil GHORBAL, Pavel Heimlich, Reuben Thomas, Samuel Thibault,
Soh Kam Yung, and Stephane Chazelas
cabs.3
cacos.3
cacosh.3
carg.3
casin.3
casinh.3
catan.3
catanh.3
ccos.3
ccosh.3
cexp.3
cimag.3
clog.3
clog10.3
conj.3
cpow.3
cproj.3
creal.3
csin.3
csinh.3
csqrt.3
ctan.3
ctanh.3
exp10.3
exp2.3
fdim.3
fenv.3
fma.3
fmax.3
fmin.3
log2.3
lrint.3
lround.3
nan.3
pow10.3
remquo.3
round.3
scalbln.3
sincos.3
tgamma.3
trunc.3
mtk
Added VERSIONS section noting that these functions first
appeared in glibc in version 2.1.
cosh.3
mtk
BUGS: In glibc 2.3.4 and earlier, an FE_OVERFLOW exception is not
raised when an overflow occurs.
fenv.3
mtk / Fabian Kreuz
Provide more detail in the description of rounding modes.
Add text describing FLT_ROUNDS (formerly in fma.3).
Add BUGS section pointing out the FLT_ROUNDS does not reflect
changes by fesetround().
fma.3
mtk
Remove text about FLT_ROUNDS, replacing with a cross-reference
to fenv(3).
fpclassify.3
mtk
CONFORMING TO: Note that the standards provide a weaker guarantee
for the return value of isinf().
log.3
mtk
BUGS: In glibc 2.5 and earlier, log(nan("")) produces a bogus
FE_INVALID exception.
lround.3
mtk
Add reference to fenv(3) for discussion of current rounding mode.
nextafter.3
mtk
BUGS: In glibc 2.5 and earlier these functions do not raise an
FE_UNDERFLOW exception on underflow.
pow.3
mtk
BUGS: described buggy NaN return when x is negative and y is large.
See also: http://sources.redhat.com/bugzilla/show_bug.cgi?id=3866.
BUGS: Note the bogus FE_INVALID exception that occurred in glibc
2.3.2 and earlier on overflow and underflow.
remainder.3
mtk
Add reference to fenv(3) for discussion of current rounding mode.
round.3
mtk
Add reference to fenv(3) for discussion of current rounding mode.
scalb.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of scalb().
tgamma.3
mtk
BUGS: In glibc 2.3.3, tgamma(+-0) produced a domain error
instead of a pole error.
y0.3
mtk
In glibc 2.3.2 and earlier, these functions do not raise an
FE_INVALID exception for a domain error.
math_error.7
mtk
Rewrite introductory paragraph.
Point out that a NaN is commonly returned by functions that report
a domain error.

View File

@ -13927,3 +13927,512 @@ trunc.3
CONFORMING TO: Added POSIX.1-2001.
Added NOTES section explaining that result may be too large
to store in an integer type.
==================== Changes in man-pages-3.07 ====================
Released: 2008-08-12, Konolfingen
Contributors
------------
The following people contributed notes, ideas, or patches that have
been incorporated in changes in this release:
Alain Portal <aportal@univ-montp2.fr>
Andries Brouwer <Andries.Brouwer@cwi.nl>
Christoph Lameter <cl@linux-foundation.org>
Cliff Wickman <cpw@sgi.com>
Fabian Kreutz <kreutz@dbs.uni-hannover.de>
Filippo Santovito <filippo.santovito@email.it>
Gerrit Renker <gerrit@erg.abdn.ac.uk>
Heikki Orsila <shd@modeemi.cs.tut.fi>
Khalil GHORBAL <khalil.ghorbal@cea.fr>
Lee Schermerhorn <lee.schermerhorn@hp.com>
Maxin John <maxin.john@gmail.com>
Reuben Thomas <rrt@sc3d.org>
Samuel Thibault <samuel.thibault@ens-lyon.org>
Sam Varshavchik <mrsam@courier-mta.com>
Soh Kam Yung <sohkamyung@gmail.com>
Stephane Chazelas <stephane_chazelas@yahoo.fr>
Pavel Heimlich <tropikhajma@seznam.cz>
Reuben Thomas <rrt@sc3d.org>
Apologies if I missed anyone!
New and rewritten pages
-----------------------
move_pages.2
Christoph Lameter, various edits and improvements by mtk
Documentation of the move_pages() system call.
This page was formerly part of the numactl package, but really
belongs in man-pages (since it describes a kernel interface).
clock_getcpuclockid.3
mtk
New page documenting the clock_getcpuclockid() library function,
available since glibc 2.2.
udplite.7
Gerrit Renker
Document the Linux implementation of the UDP-Lite protocol,
new in Linux 2.6.20.
Newly documented interfaces in existing pages
---------------------------------------------
proc.5
Christoph Lameter, minor edits and improvements by mtk
Documentation of the /proc/PID/numa_maps file.
This material was formerly the numa_maps.5 page in the numactl
package, but really belongs in man-pages (since it describes
a kernel interface).
Global changes
--------------
nanosleep.2
inet_ntop.3
inet_pton.3
scanf.3
initrd.4
mtk
Fix mis-ordered (.SH) sections.
connect.2
socket.2
rtnetlink.3
arp.7
ddp.7
ip.7
ipv6.7
netlink.7
packet.7
raw.7
rtnetlink.7
socket.7
tcp.7
udp.7
unix.7
x25.7
mtk
s/PF_/AF_/ for socket family constants. Reasons: the AF_ and
PF_ constants have always had the same values; there never has
been a protocol family that had more than one address family,
and POSIX.1-2001 only specifies the AF_* constants.
Typographical or grammatical errors have been corrected in several
other places.
Changes to individual pages
---------------------------
execve.2
mtk
The floating-point environment is reset to the default
during an execve().
getitimer.2
mtk
CONFORMING TO: POSIX.1-2008 marks getitimer() and setitimer()
obsolete.
get_mempolicy.2
Lee Schermerhorn
Misc cleanup of get_mempolicy(2):
+ mention that any mode flags will be saved with mode.
I don't bother to document mode flags here because we
already have a pointer to set_mempolicy(2) for more info
on memory policy. mode flags are discussed there.
+ remove some old, obsolete [IMO] NOTES and 'roff comments.
Lee Schermerhorn
Update the get_mempolicy(2) man page to add in the description of
the MPOL_F_MEMS_ALLOWED flag, added in 2.6.23.
mtk
Document additional EINVAL error that occurs is MPOL_F_MEMS_ALLOWED
is specified with either MPOL_F_ADDR or MPOL_F_NODE.
mbind.2
Lee Schermerhorn
Fix error conditions, now that the kernel silently ignores
nodes outside the task's cpuset, as long as one valid node
remains.
Now that cpuset man page exists, we can refer to it. Remove
stale comment regarding lack thereof.
Lee Schermerhorn
Add brief discussion of mode flags.
Lee Schermerhorn
Attempt to clarify discussion of MPOL_DEFAULT.
mtk
Fix URI reference for libnuma.
mprotect.2
mtk / Maxin John
Remove EFAULT from errors. Under ENOMEM error, note that
EFAULT was the error produced in some cases for kernels before
2.4.19.
msgctl.2
mtk, after a note from Filippo Santovito
In the ipc_perm structure definition, some fields were
incorrectly named: s/key/__key/ and s/seq/__seq/.
set_mempolicy.2
Lee Schermerhorn
Fix up the error return for nodemask containing nodes disallowed by
the process' current cpuset. Disallowed nodes are now silently ignored,
as long as the nodemask contains at least one node that is on-line,
allowed by the process' cpuset and has memory.
Now that we have a cpuset man page, we can refer to cpusets directly
in the man page text.
Lee Schermerhorn
Another attempt to rationalize description of MPOL_DEFAULT.
Since ~2.6.25, the system default memory policy is "local allocation".
MPOL_DEFAULT itself is a request to remove any non-default policy and
"fall back" to the surrounding context. Try to say that without delving
into implementation details.
Lee Schermerhorn
Add discussion of mempolicy mode flags to set_mempolicy(2).
This adds another reason for EINVAL.
setpgid.2
mtk
CONFORMING TO: POSIX.1-2008 marks setpgrp() obsolete.
semctl.2
mtk, after a note from Filippo Santovito
In the ipc_perm structure definition, some fields were
incorrectly named: s/key/__key/ and s/seq/__seq/.
shmctl.2
Filippo Santovito / mtk
In the ipc_perm structure definition, some fields were
incorrectly named: s/key/__key/ and s/seq/__seq/.
utime.2
mtk
CONFORMING TO: POSIX.1-2008 marks utime() obsolete.
CONFORMING TO: POSIX.1-2008 removes the POSIX.1-2001 LEGACY
marking of utimes(), so mention of this point has been
removed from the page.
vfork.2
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of vfork().
atan2.3
Fabian Kreutz
SEE ALSO Add carg(3).
bcmp.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of bcmp().
bsd_signal.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification ofcw
bsd_signal().
bzero.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of bzero().
cexp2.3
mtk
AVAILABILITY: These functions are still not in glibc
as at version 2.8.
clock_getres.3
mtk
SEE ALSO: Add clock_getcpuclockid(3).
clog2.3
mtk
AVAILABILITY: These functions are still not in glibc
as at version 2.8.
ctime.3
mtk
POSIX.1-2008 marks asctime(), asctime_r(), ctime(), and ctime_r()
as obsolete.
dprintf.3
mtk
CONFORMING TO: These functions are nowadays in POSIX.1-2008.
ecvt.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specifications of
ecvt() and fcvt().
ftime.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of ftime().
ftw.3
mtk
CONFORMING TO: POSIX.1-2008 marks ftw() as obsolete.
gcvt.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of gcvt().
getcwd.3
Reuben Thomas / mtk
Clarify description of getcwd() for buf==NULL case;
CONFORMING TO: According to POSIX.1, the behavior of getcwd()
is unspecified for the buf==NULL case.
mtk
Add an introductory paragraph giving an overview of what these
functions do.
Fix error in description of getwd(): it does not truncate the
pathname; rather, it gives an error if the pathname exceeds
PATH_MAX bytes.
Rewrote RETURN VALUE section.
Add EINVAL ENAMETOOLONG errors for getwd().
Various other clarifications and wording fixes.
CONFORMING TO: POSIX.1-2001 does not define any errors for
getwd().
CONFORMING TO: POSIX.1-2008 removes the specification of getwd().
gethostbyname.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specifications of
gethostbyname(), gethostbyaddr(), and h_errno.
gets.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of gets().
iconv.3
iconv_close.3
iconv_open.3
mtk
VERSIONS: These functions are available in glibc since version 2.1.
index.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specifications of
index() and rindex().
isalpha.3
mtk
CONFORMING TO: POSIX.1-2008 marks isalpha() as obsolete.
makecontext.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specifications of
makecontext() and swapcontext().
memchr.3
mtk
VERSIONS: memrchr() since glibc 2.2; rawmemchr() since glibc 2.1.
mempcpy.3
mtk
VERSIONS: mempcpy() since glibc 2.1.
mktemp.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of mktemp().
opendir.3
mtk
CONFORMING TO: POSIX.1-2008 specifies fdopendir().
rand.3
mtk
CONFORMING TO: POSIX.1-2008 marks rand_r() as obsolete.
siginterrupt.3
mtk
CONFORMING TO: POSIX.1-2008 marks siginterrupt() as obsolete.
sigset.3
mtk
CONFORMING TO: POSIX.1-2008 marks sighold(), sigignore(),
sigpause(), sigrelse(), and sigset() as obsolete.
strchr.3
mtk
VERSIONS: strchrnul() since glibc 2.1.1.
tempnam.3
mtk
CONFORMING TO: POSIX.1-2008 marks tempnam() as obsolete.
tmpnam.3
mtk
CONFORMING TO: POSIX.1-2008 marks tmpnam() as obsolete.
toascii.3
mtk
CONFORMING TO: POSIX.1-2008 marks toascii() as obsolete.
ualarm.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of ualarm().
ulimit.3
mtk
CONFORMING TO: POSIX.1-2008 marks ulimit() as obsolete.
usleep.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of usleep().
standards.7
mtk
Updated details for POSIX.1-2008, and noted that if
POSIX.1-2001 is listed in the CONFORMING TO section of a man
page, then the reader can assume that the interface is also
specified in POSIX.1-2008, unless otherwise noted.
time.7
mtk
SEE ALSO: Add clock_getcpuclockid(3).
udp.7
mtk
SEE ALSO: add udplite(7).
Changes to individual pages (math functions)
--------------------------------------------
Various changes here following on from the big update to the
math pages in the previous release. Test results going back
glibc 2.3.2 (so far) allowed updates to various pages to note
changes in historical behavior for error reporting by math
functions. Thanks to the following people for providing me
with test results on various distributions and glibc versions:
Alain Portal, Andries Brouwer, Fabian Kreutz, Heikki Orsila,
Khalil GHORBAL, Pavel Heimlich, Reuben Thomas, Samuel Thibault,
Soh Kam Yung, and Stephane Chazelas
cabs.3
cacos.3
cacosh.3
carg.3
casin.3
casinh.3
catan.3
catanh.3
ccos.3
ccosh.3
cexp.3
cimag.3
clog.3
clog10.3
conj.3
cpow.3
cproj.3
creal.3
csin.3
csinh.3
csqrt.3
ctan.3
ctanh.3
exp10.3
exp2.3
fdim.3
fenv.3
fma.3
fmax.3
fmin.3
log2.3
lrint.3
lround.3
nan.3
pow10.3
remquo.3
round.3
scalbln.3
sincos.3
tgamma.3
trunc.3
mtk
Added VERSIONS section noting that these functions first
appeared in glibc in version 2.1.
cosh.3
mtk
BUGS: In glibc 2.3.4 and earlier, an FE_OVERFLOW exception is not
raised when an overflow occurs.
fenv.3
mtk / Fabian Kreuz
Provide more detail in the description of rounding modes.
Add text describing FLT_ROUNDS (formerly in fma.3).
Add BUGS section pointing out the FLT_ROUNDS does not reflect
changes by fesetround().
fma.3
mtk
Remove text about FLT_ROUNDS, replacing with a cross-reference
to fenv(3).
fpclassify.3
mtk
CONFORMING TO: Note that the standards provide a weaker guarantee
for the return value of isinf().
log.3
mtk
BUGS: In glibc 2.5 and earlier, log(nan("")) produces a bogus
FE_INVALID exception.
lround.3
mtk
Add reference to fenv(3) for discussion of current rounding mode.
nextafter.3
mtk
BUGS: In glibc 2.5 and earlier these functions do not raise an
FE_UNDERFLOW exception on underflow.
pow.3
mtk
BUGS: described buggy NaN return when x is negative and y is large.
See also: http://sources.redhat.com/bugzilla/show_bug.cgi?id=3866.
BUGS: Note the bogus FE_INVALID exception that occurred in glibc
2.3.2 and earlier on overflow and underflow.
remainder.3
mtk
Add reference to fenv(3) for discussion of current rounding mode.
round.3
mtk
Add reference to fenv(3) for discussion of current rounding mode.
scalb.3
mtk
CONFORMING TO: POSIX.1-2008 removes the specification of scalb().
tgamma.3
mtk
BUGS: In glibc 2.3.3, tgamma(+-0) produced a domain error
instead of a pole error.
y0.3
mtk
In glibc 2.3.2 and earlier, these functions do not raise an
FE_INVALID exception for a domain error.
math_error.7
mtk
Rewrite introductory paragraph.
Point out that a NaN is commonly returned by functions that report
a domain error.

View File

@ -1,7 +1,7 @@
RELEASE
The Linux man page maintainer proudly announces. . .
man-pages-3.07.tar.gz - man pages for Linux
man-pages-3.08.tar.gz - man pages for Linux
Differences from the previous manual pages release are listed in
the file "Changes".

View File

@ -1,13 +1,13 @@
Begin3
Title: Section 2, 3, 4, 5 and 7 man pages for Linux
Version: 3.07
Entered-date: 2008-08-12
Version: 3.08
Entered-date: 2008-??-??
Description: Linux manual pages
Keywords: man pages
Author: several
Maintained-by: Michael Kerrisk <mtk.manpages@gmail.com>
Primary-site: ftp://ftp.kernel.org/pub/linux/docs/man-pages
1431k man-pages-3.07.tar.gz
????k man-pages-3.08.tar.gz
Alternate-site: ftp://ftp.win.tue.nl/pub/linux-local/manpages
Copying-policy: several; the pages are all freely distributable as long as
nroff source is provided