Re: problems with pow( ) in gcc

[SL Baur <steve@example.com>]

Stephen J Turnbull <turnbull@example.com> writes in tlug@example.com:

> `man pow' says
 ...
>     SYNOPSIS
>            #include <math.h>

>            double exp(double x);

>            double log(double x);

>            double log10(double x);

>            double pow(double x, double y);

> It's arguable that the SYNOPSIS is the only big advantage of the man
> format over info.  :-)

In this case, the synopsis is wrong.  The only thing worse than no
documentation is incorrect documentation.


Solaris gets it right:

Mathematical Library                                      pow(3M)

NAME
     pow - power function

SYNOPSIS
     cc [ flag ... ] file ...  -lm [ library ... ]

     #include <math.h>

     double pow(double x, double y);


Info is just another Stallman NIHism.  Man pages have worked fine for
decades and too many recent software packages are ignoring it to the
detriment of everyone.  Shame on GNU and shame on KDE/Gnome HTML help.