On Mon, 16 Jun 2014, Rich Gray wrote:

> I've always felt that the callback functions deserve man pages. This would
> bring all the API info about setup, invocation timing, calling arguments,
> return values and entitlements for each function together in one place. It
> would give the user a functional spec to write their callback functions
> against.

I agree. I've also been wanting to get the *setopt options better documented
in a stand-alone fashion so that we can have a single page for each of them
(and link to them individually in a nicer way). It'll allow people to google
for them more easily and it'll encourage us to be more verbose for each
option. That would of course include the callback options and we could even
document them with a small example or two in each page.

I think I'll use this opportunty to push myself into actually starting this
work.

One man page for each easy curl_easy_setopt and curl_multi_setopt option. That
means almost 200 new man pages... Of course curl_easy_setopt.3 and
curl_multi_setopt.3 can then be significantly shortened.

Thanks.

-- 
  / daniel.haxx.se
-------------------------------------------------------------------
List admin: http://cool.haxx.se/list/listinfo/curl-library
Etiquette:  http://curl.haxx.se/mail/etiquette.html