Hi Daniel Stenberg, you wrote:

> On Thu, 3 Nov 2005, Michael Wallner wrote:
>
>> Uhm... I think that http://php.net/curl is quite elaborative, but I
>> may be biased :)
>
> Sorry, but I don't think that page is good enough for many simple users.
>
> For example, it doesn't mention many bits about how you proceed to get
> PHP/CURL installed on windows (or using a binary package). IIRC, there
> are binaries provided for windows and you can somehow activate PHP/CURL
> in that without having to learn configure options...

Activation of php-curl on windows is starting up notepad and
removing a semicolon from the following line in php.ini:

;extension=php_curl.dll

(http://php.net/manual/en/install.windows.extensions.php)

libcurl is statically linked in, but the SSL libraries are not,
thus the note to Win32 users on http://php.net/curl.

>> Though, one reason might be that you host a php-curl mailing list...
>
> Yes, but more I believe it is more importantly that I host and maintain
> the 'curl web site' and the PHP binding is tirelessly referred to as
> CURL (as opposed to a more special name such as PHP/CURL) in PHP land so
> very many PHP users immediately get trouble trying to figure this out.
>
> I need to work on making that separation clearer on the web site.

If you feel that the PHP manual lacks a proper warning on what
curl/libcurl/php-curl and its differences are, you can of course
file a bug/feature request for the documentation, and from my
experience the doc team is quite open minded, if the request
is not the deepest rant :)

<scnr>If you find a single occurence where the documentation refers
to the curl extension of PHP by the single word "CURL", please tell
me and I'll go and rant myself to the doc team :) (I won't count the
<h1>eader of the extension docs and the main link in the menu)</scnr>

>> Seriously, Daniel, I don't think that lack of docs is the issue but
>> the high popularity of PHP and libcurl and ever growing base of "new
>> users" without any clue.
>
> True, one should never under-estimate what lack of clues can do! ;-)

Yep, RTFM is still true nowadays :)
I also catch myself asking to quickly without looking at $MANUAL.

Cheers,

-- 
Michael - <mike(@)php.net> http://dev.iworks.at/ext-http/http-functions.html.gz
_______________________________________________
http://cool.haxx.se/cgi-bin/mailman/listinfo/curl-and-php