function cerf in manpage but not in <complex.h>

function cerf in manpage but not in <complex.h>

[ozgur.gurcan-vcqoFEiXU/AczSlqHMVBIP3zm4ADWneb]

Hi,

in my system (2.6.34-gentoo-r2), "man cerf" gives me the description of a
certain complex error function. This function however is nowhere to be
found. I tried this on 5 other linux boxes with the same result.

May be the function was taken out at some point but the documentation stayed.

Here is a minimum test file which can be saved as "test.c" and complied as

gcc test.c -lm

------
#include <math.h>
#include <complex.h>
#include <stdio.h>

int main (void){
        double complex b,c;
        b=I*0.2;
        c=cerf(b);
        printf("%f + i%f\n",creal(c),cimag(c));
}
------

regards,

Ozgur,

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: function cerf in manpage but not in <complex.h>

[Sam Varshavchik]

[-- Attachment #1: Type: text/plain, Size: 277 bytes --]

ozgur.gurcan-vcqoFEiXU/AczSlqHMVBIP3zm4ADWneb@public.gmane.org writes:

> Hi,
> 
> in my system (2.6.34-gentoo-r2), "man cerf" gives me the description of a
> certain complex error function.

Your man page should also have a note that:

"Not yet in glibc, as at version 2.8."


[-- Attachment #2: Type: application/pgp-signature, Size: 198 bytes --]

Re: function cerf in manpage but not in <complex.h>

[Michael Kerrisk]

Hello Ozgur,

On Sun, Sep 12, 2010 at 12:06 AM,  <ozgur.gurcan-vcqoFEiXU/AczSlqHMVBIP3zm4ADWneb@public.gmane.org> wrote:
> Hi,
>
> in my system (2.6.34-gentoo-r2), "man cerf" gives me the description of a
> certain complex error function. This function however is nowhere to be
> found. I tried this on 5 other linux boxes with the same result.
>
> May be the function was taken out at some point but the documentation stayed.

Further down in the page is the line

==
.SH AVAILABILITY
Not yet in glibc, as at version 2.12.
==

I suppose you missed that, which is easy to do. I tweaked the page
(for man-pages-3.27) as below, to try to make it a little clearer.

Cheers,

Michael

--- a/man3/cerf.3
+++ b/man3/cerf.3
@@ -21,7 +21,7 @@ cerf, cerff, cerfl, cerfc, cerfcf, cerfcl \- complex
error function
 .sp
 Link with \fI\-lm\fP.
 .SH DESCRIPTION
-The function
+The (unimplemented) function
 .BR cerf ()
 is the complex version of the error function.
 erf(z) = 2/sqrt(pi) * integral from 0 to z of exp(\-t*t) dt.
@@ -32,7 +32,7 @@ is defined as cerfc(z) = 1\-cerf(z).
 .SH "CONFORMING TO"
 The function names are reserved for future use in C99.
 .SH AVAILABILITY
-Not yet in glibc, as at version 2.8.
+Not yet in glibc, as at version 2.12.
 .\" But reserved in NAMESPACE.
 .SH "SEE ALSO"
 .BR erf (3),
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html

Re: function cerf in manpage but not in <complex.h>

[ozgur.gurcan-vcqoFEiXU/AczSlqHMVBIP3zm4ADWneb]

Hello Micheal,

> Hello Ozgur,
>
> On Sun, Sep 12, 2010 at 12:06 AM,  <ozgur.gurcan-vcqoFEiXU/AczSlqHMVBIP3zm4ADWneb@public.gmane.org>
> wrote:
>> Hi,
>>
>> in my system (2.6.34-gentoo-r2), "man cerf" gives me the description of
>> a
>> certain complex error function. This function however is nowhere to be
>> found. I tried this on 5 other linux boxes with the same result.
>>
>> May be the function was taken out at some point but the documentation
>> stayed.
>
> Further down in the page is the line
>
> ==
> .SH AVAILABILITY
> Not yet in glibc, as at version 2.12.
> ==
>
> I suppose you missed that, which is easy to do. I tweaked the page
> (for man-pages-3.27) as below, to try to make it a little clearer.
>
> Cheers,
>
> Michael
>
> --- a/man3/cerf.3
> +++ b/man3/cerf.3
> @@ -21,7 +21,7 @@ cerf, cerff, cerfl, cerfc, cerfcf, cerfcl \- complex
> error function
>  .sp
>  Link with \fI\-lm\fP.
>  .SH DESCRIPTION
> -The function
> +The (unimplemented) function
>  .BR cerf ()
>  is the complex version of the error function.
>  erf(z) = 2/sqrt(pi) * integral from 0 to z of exp(\-t*t) dt.
> @@ -32,7 +32,7 @@ is defined as cerfc(z) = 1\-cerf(z).
>  .SH "CONFORMING TO"
>  The function names are reserved for future use in C99.
>  .SH AVAILABILITY
> -Not yet in glibc, as at version 2.8.
> +Not yet in glibc, as at version 2.12.
>  .\" But reserved in NAMESPACE.
>  .SH "SEE ALSO"
>  .BR erf (3),
>

I see. I had seen the note, but I thought it was in "libm" and not in
glibc or something like that (since it also says link with -lm). I think
your version is much clearer.

thanks,

Ozgur

--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to majordomo-u79uwXL29TY76Z2rM5mHXA@public.gmane.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html