On Sat, 4 Aug 2007, Richard Lynch wrote:
That said, I personally never had a problem searching the haxx.se site and
finding out what CURLOPT_XYZ meant, except for the php-specific
CURLOPT_BINARYTRANSFER... :-)
The binding has a 1:1 mapping on all its option names (except
CURLOPT_BINARYTRANSFER) to libcurl's as far as I know, but libcurl offers a
lot more options than what the binding offers. There's also the not so minor
detail that the PHP binding has its own way of interpreting and acting on some
options that isn't done by libcurl. (I'm mainly thinking about
CURLOPT_HTTPPOST.)
The funtion names of the binding are also all different than the ones used by
libcurl.
I'd be hesitant to try and duplicate the libcurl docs onto the PHP site, as
the whole point of PHP being a "glue" language and maintaining as much as
possible of external lib idioms is to get documentation re-use out of the
original docs, presumably maintained better by the original authors -- and
they're pretty darn nice docs over on haxx.se, at least when I went looking
for stuff.
Thanks.
I'm all for trying to get things as good as possible, but the libcurl docs
have the minor drawbacks to PHP users that they speak of the C API so it
refers to data types and operations etc that PHP user won't care about or in
worst cases will get confused by.
So, while I wouldn't mind adapt somewhat or even do additional hacks in order
to help others to host or extract partical docs from the curl site or the curl
docs (since most of our docs are in fact the man pages converted to HTML), I
just don't know how or what I could do.
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
