sync

1 files changed, 640 insertions, 0 deletions

diff --git a/Changes.old b/Changes.old
index 85589c641..a31b642f8 100644
--- a/Changes.old
+++ b/Changes.old
@@ -13286,3 +13286,643 @@ rpc.3
 ipv6.7
     mtk, after a report from Uli Schlacter
         Document the IPV6_V6ONLY flag.
+
+
+==================== Changes in man-pages-3.06 ====================
+
+Released: 2008-08-05, Konolfingen
+
+
+Contributors
+------------
+
+The following people contributed notes, ideas, or patches that have
+been incorporated in changes in this release:
+
+Andreas Jaeger <aj@novell.com>
+Andries Brouwer <Andries.Brouwer@cwi.nl>
+Gernot Tenchio <g.tenchio@telco-tech.de>
+Sam Varshavchik <mrsam@courier-mta.com>
+Tolga Dalman <tdalman@project-psi.org>
+
+Apologies if I missed anyone!
+
+
+New and rewritten pages
+-----------------------
+
+erfc.3
+    mtk
+        Created after removing the erfc() material from erf.3.
+        Documents the complementary error function.
+
+y0.3
+    mtk
+        Created after removing the y*() material from j0.3.
+        Documents the Bessel functions of the second kind.
+        Included ERRORS section; noted that an exception is not
+        raised on underflow, see also
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6806;
+        and errno is not set on overflow, see also
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6808;
+        Included BUGS section noting that errno is incorrectly
+        set for pole error; see also
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6807.
+
+scalbln.3
+    mtk
+        Created after removing the scalbln*() and scalbn*() material
+        from scalb.3.  Documents scalbln() and scalbn() functions.
+        Included ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803.
+
+
+New and changed links
+---------------------
+
+erfcf.3
+erfcl.3
+    mtk
+        Changed these links to point to new erfc.3 page.
+
+scalblnf.3
+scalblnl.3
+scalbn.3
+scalbnf.3
+scalbnl.3
+    mtk
+        Changed these links to point to new scalbln.3 page.
+
+y0f.3
+y0l.3
+y1.3
+y1f.3
+y1l.3
+yn.3
+ynf.3
+ynl.3
+    mtk
+        Changed these links to point to new y0.3 page.
+
+
+Global changes
+--------------
+
+Various pages
+    mtk
+        s/floating point/floating-point/ when used attributively.
+
+Typographical or grammatical errors have been corrected in several
+other places.
+
+
+Changes to individual pages
+---------------------------
+
+crypt.3
+    mtk
+        Tweak discuss text describing support for Blowfish.
+
+ctime.3
+    mtk / Gernot Tenchio
+        Added some words to make clear that the string returned by
+        ctime() and asctime() is null-terminated.
+
+math_error.7
+    Sam Varshavchik
+        Reverse order of SYNOPSIS and NAME sections.
+    mtk
+        NOTES: Summarize the state of glibc support for exceptions
+        and errno for error reporting.
+
+
+Changes to individual pages (math functions)
+--------------------------------------------
+
+Almost all of the changes in this release relate to math man pages.
+Very many changes were made to the math pages, including:
+
+* Fixed feature test macros (FTMs).  Often, the FTM requirements
+  for the "float" and "long double" versions of a math function are
+  different from the requirements for the "double version".  Each math
+  page now shows the correct FTM requirements for all three versions
+  of the function(s) it describes.  This may have required either
+  a change to the existing FTM text (if the requirements for the
+  "double" function were already described), or the addition of an FTM
+  description to a SYNOPSIS where one was not previously present
+  (typically because the "double" version of the function does not
+  require any FTMs to be defined).
+* CONFORMING TO: in many cases, POSIX.1-2001 was not mentioned.
+  Where a function is specified in POSIX.1-2001, this is now noted.
+  Also, statements about what other standards a function conforms to
+  were generally clarified.  (The wording about which functions conformed
+  to C99 was previously often done as an add on sentence; now it is made
+  part of the first sentence of the CONFORMING TO section, along with
+  POSIX.1-2001.)
+* RETURN VALUE: in many cases, pages lacked descriptions of the return
+  value when the function arguments are special values such as +0, -0,
+  NaN (not-a-number), +infinity, -infinity, etc.  This has been fixed.
+  I carried out tests on glibc 2.8 to ensure that all of these
+  functions match the RETURN VALUE descriptions (and the POSIX.1-2001
+  requirements).
+* ERRORS: many pages lacked a clear (or indeed any) description of
+  how errno is set on error and what exception is raised for each error.
+  This has been fixed.  The ERRORS sections are now generally headed up
+  as per the POSIX.1 way of doing things, describing Pole / Range /
+  Domain errors, as applicable.
+  I carried out tests on glibc 2.8 to ensure that all of these
+  functions match the ERRORS descriptions.  Deviations from POSIX.1-2001
+  requirements have been filed as glibc bug reports, and noted in the
+  man pages.  (The pages now describe the situation for ERRORS as at glibc
+  2.8; I may eventually try and extend the text with descriptions of
+  changes in older versions of glibc.)
+  NOTE: one point that has not been covered in any page is the
+  circumstances that generate inexact (FE_INEXACT) exceptions.
+  (The details for these exceptions are not specified in POSIX.1-2001,
+  and I haven't gone looking for the standards that describe the details.)
+
+acos.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        RETURN VALUE: Added details for special argument cases.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+
+acosh.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        Added RETURN VALUE section.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+
+asin.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        RETURN VALUE: Added details for special argument cases.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+
+asinh.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        DESCRIPTION: Some rewording.
+        RETURN VALUE: Added details for special argument cases.
+        Added (null) ERRORS section.
+        Updated CONFORMING TO.
+
+atan.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        DESCRIPTION: Some rewording.
+        RETURN VALUE: Added details for special argument cases.
+        Added (null) ERRORS section.
+        Updated CONFORMING TO.
+
+atan2.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        DESCRIPTION: Some rewording.
+        RETURN VALUE: Added details for special argument cases.
+        Added (null) ERRORS section.
+        Updated CONFORMING TO.
+
+atanh.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        Added RETURN VALUE section.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+        Added BUGS section noting that pole error sets errno to EDOM,
+        when it should be ERANGE instead; see also
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6759.
+
+cbrt.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        Added RETURN VALUE section.
+        Added (null) ERRORS section.
+        Updated CONFORMING TO.
+
+ceil.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        DESCRIPTION: Enhanced.
+        RETURN VALUE: Added details for special argument cases.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+        NOTES: Added some details.
+
+copysign.3
+    mtk
+        Added RETURN VALUE section.
+        Updated CONFORMING TO.
+
+cos.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Rewrote RETURN VALUE section.
+        Added ERRORS section; noted errno is not set:
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6780.
+        Updated CONFORMING TO.
+
+cosh.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Added ERRORS section.
+        Updated CONFORMING TO.
+
+erf.3
+    mtk
+        Removed the erfc() material (there is now a new erfc page).
+        Reason: the functions are logically separate; also their
+        return values differ, and it would have been confusing
+        to document them on the same page.
+        SYNOPSIS: Fixed feature test macro requirements.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not set; see
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6785.
+        Updated CONFORMING TO.
+
+exp.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not set; see
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6786.
+        Updated CONFORMING TO.
+
+exp10.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not set for underflow;
+        see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6787.
+
+exp2.3
+    mtk
+        Added RETURN VALUE and ERRORS sections.
+        Updated CONFORMING TO.
+
+expm1.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not set for overflow;
+        see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6788.
+        Updated CONFORMING TO.
+        Added BUGS section, describing bogus underflow exception for -large,
+        see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6778;
+        and describing bogus invalid exception for certain +large,
+        see http://sources.redhat.com/bugzilla/show_bug.cgi?id=6814.
+
+fabs.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Updated CONFORMING TO.
+
+fdim.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        DESCRIPTION: Some rewording.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6796.
+        Updated CONFORMING TO.
+
+fenv.3
+    mtk
+        Make style of writing exception names consistent with other
+        pages and POSIX.1-2001.
+        Updated CONFORMING TO.
+
+finite.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+
+floor.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        DESCRIPTION: Enhanced.
+        RETURN VALUE: Added details for special argument cases.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+
+fma.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        DESCRIPTION: Some rewording.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801.
+        Updated CONFORMING TO.
+
+fmax.3
+fmin.3
+    mtk
+        NAME: Make description clearer
+        SYNOPSIS: Added feature test macro requirements.
+        SYNOPSIS: Remove unneeded "Compile with" piece.
+        CONFORMING TO: Added POSIX.1-2001.
+        Added RETURN VALUE and ERRORS sections.
+
+fmod.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        RETURN VALUE: Added details for special argument cases.
+        Rewrote ERRORS section; noted that errno is not always set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
+        Updated CONFORMING TO.
+
+fpclassify.3
+    mtk
+        Minor wording changes.
+        CONFORMING TO: Added POSIX.1-2001.
+        SEE ALSO: Add signbit(3).
+
+frexp.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added details to RETURN VALUE section.
+        Added (null) ERRORS section.
+        CONFORMING TO: Added POSIX.1-2001.
+
+gamma.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        Added (null) RETURN VALUE section referring to tgamma(3).
+        Added (null) ERRORS section referring to tgamma(3).
+        CONFORMING TO: Rewrote.
+
+hypot.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        DESCRIPTION: note that calculation is done without causing
+        undue overflow or underflow.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not always set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6795.
+        Updated CONFORMING TO.
+
+ilogb.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Rewrote RETURN VALUE section.
+        Rewrote ERRORS section; noted that errno is not set, and in some
+        cases an exception is not raised; see also
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6794.
+        CONFORMING TO: Added POSIX.1-2001.
+
+isgreater.3
+    mtk
+        NAME: Make description clearer
+        Improve the description of isunordered().
+        Added RETURN VALUE and ERRORS sections.
+        Formatting fixes.
+        A few wording improvements.
+
+j0.3
+    mtk
+        Removed material for the y*() functions to a separate y0.3 page.
+        Reason: the return values and errors/exceptions differ, and it
+        would have been confusing to document them on the same page.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6805.
+
+ldexp.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE and ERRORS sections.
+        Updated CONFORMING TO.
+
+lgamma.3
+    mtk
+        Note that these functions are deprecated.
+        SYNOPSIS: Fixed feature test macro requirements.
+        Added RETURN VALUE and ERRORS sections referring to lgamma(3).
+        Added BUGS section noting that pole error sets errno to EDOM,
+        when it should be ERANGE instead; see also
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6777.
+
+log.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+
+log10.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+
+log1p.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6792.
+        Updated CONFORMING TO.
+
+log2.3
+    mtk
+        Added RETURN VALUE section.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+
+logb.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        DESCRIPTION: added a little detail; some rewordings.
+        RETURN VALUE: Added details for special argument cases.
+        Rewrote ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6793.
+        CONFORMING TO: Added POSIX.1-2001.
+
+lrint.3
+    mtk
+        DESCRIPTION: some rewording.
+        RETURN VALUE: Added details for special argument cases.
+        Added ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6798.
+        CONFORMING TO: Added POSIX.1-2001.
+
+lround.3
+    mtk
+        RETURN VALUE: Added details for special argument cases.
+        Rewrote ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6797.
+        CONFORMING TO: Added POSIX.1-2001.
+
+modf.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        RETURN VALUE: Added details for special argument cases.
+        Added (null) ERRORS section.
+        CONFORMING TO: Added POSIX.1-2001.
+
+nan.3
+    mtk
+        Small wording changes.
+        CONFORMING TO: Added POSIX.1-2001.
+
+nextafter.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        RETURN VALUE: Added details for special argument cases.
+        Added ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6799.
+        CONFORMING TO: Added POSIX.1-2001.
+
+pow.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+        Added BUGS section noting that pole error sets errno to EDOM,
+        when it should be ERANGE instead; see also
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6776.
+
+remainder.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        DESCRIPTION: added some details.
+        RETURN VALUE: Added details for special argument cases.
+        Rewrote ERRORS section; noted that errno is not always set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
+        Updated CONFORMING TO.
+        Added BUGS section noting that remainder(nan(""), 0)
+        wrongly causes a domain error; see
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6779
+
+remquo.3
+   mtk
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6801.
+        Updated CONFORMING TO.
+
+fmax.3
+fmin.3
+    mtk
+        NAME: Make description clearer
+        SYNOPSIS: Added feature test macro requirements.
+        SYNOPSIS: Remove unneeded "Compile with" piece.
+        CONFORMING TO: Added POSIX.1-2001.
+        Added RETURN VALUE and ERRORS sections.
+
+fmod.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        RETURN VALUE: Added details for special argument cases.
+        Rewrote ERRORS section; noted that errno is not always set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6783.
+        Updated CONFORMING TO.
+
+fpclassify.3
+        CONFORMING TO: Added POSIX.1-2001.
+
+rint.3
+    mtk
+        SYNOPSIS: Fixed feature test macro requirements.
+        DESCRIPTION: added some details.
+        RETURN VALUE: Added details for special argument cases.
+        ERRORS: no errors can occur (previous text was misleading).
+        CONFORMING TO: Added POSIX.1-2001.
+        NOTES: point out that lrint() may be preferred in some cases.
+
+round.3
+    mtk
+        DESCRIPTION: added some details.
+        RETURN VALUE: Added details for special argument cases.
+        ERRORS: no errors can occur (previous text was misleading).
+        CONFORMING TO: Added POSIX.1-2001.
+        NOTES: point out that lround() may be preferred in some cases.
+
+scalb.3
+    mtk
+        Removed the scalbn() and scalbln() material to a separate
+        scalbln.3 page.  Reason: scalb() is obsolete; also the
+        exception/error conditions differ somewhat, so that it
+        would have been confusing to document them on the same page.
+        SYNOPSIS: Fixed feature test macro requirements.
+        DESCRIPTION: some rewrites and added details.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted that errno is not set; see
+        also http://sources.redhat.com/bugzilla/show_bug.cgi?id=6803
+        and http://sources.redhat.com/bugzilla/show_bug.cgi?id=6804.
+        CONFORMING TO: Rewrote.
+
+signbit.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        SYNOPSIS: Remove unneeded "Compile with" piece.
+        Added RETURN VALUE section.
+        Added (null) ERRORS section.
+        CONFORMING TO: Added POSIX.1-2001.
+
+sin.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Added ERRORS section; noted errno is not set:
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6781.
+        Updated CONFORMING TO.
+
+sincos.3
+    mtk
+        DESCRIPTION: Added details for special argument cases.
+        Added (null) RETURN VALUE section.
+        Added ERRORS section.
+
+sinh.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Added ERRORS section.
+        Updated CONFORMING TO.
+
+sqrt.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Rewrote ERRORS section.
+        Updated CONFORMING TO.
+
+tan.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Added ERRORS section.
+        Added ERRORS section; noted errno is not set:
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6782.
+        Updated CONFORMING TO.
+
+tanh.3
+    mtk
+        SYNOPSIS: Added feature test macro requirements.
+        Added RETURN VALUE section.
+        Added (null) ERRORS section.
+        Updated CONFORMING TO.
+
+tgamma.3
+    mtk
+        Added RETURN VALUE section.
+        Rewrote ERRORS section; noted that errno is not set /
+        incorrectly set in some cases; see also
+        http://sources.redhat.com/bugzilla/show_bug.cgi?id=6809
+        and http://sources.redhat.com/bugzilla/show_bug.cgi?id=6810.
+        CONFORMING TO: Added POSIX.1-2001.
+        Added NOTES section to hold text explaining origin of tgamma().
+
+trunc.3
+    mtk
+        RETURN VALUE: small rewording.
+        CONFORMING TO: Added POSIX.1-2001.
+        Added NOTES section explaining that result may be too large
+        to store in an integer type.