On Mon, 16 Jun 2014, Daniel Stenberg wrote: > Here's a taste of what I have in mind. Here's a separate man page for > CURLOPT_WRITEFUNCTION: > > http://curl.haxx.se/libcurl/c/CURLOPT_WRITEFUNCTION.html
I'll admit I was a bit dubious about the value of splitting these options into their own man pages, but having seen a few examples now, I can see the benefit. Since the new format encourages more verbosity, I suggest adding a RETURN VALUE section, which will be mind-numbingly repetitive for most options, but should subtly encourage people to actually check the return value. Also, a DEFAULT VALUE section may make sense as well, since these are all options and will all have a default value of some sort. At some point, a filecheck: makefile target would make sense to verify that all options have a man page. >>> Dan ------------------------------------------------------------------- List admin: http://cool.haxx.se/list/listinfo/curl-library Etiquette: http://curl.haxx.se/mail/etiquette.html
