Hello!
I started this new little project of mine that I figure maybe someone else
would consider joining.
The idea is simple: for every existing option we have to curl_easy_setopt(),
there should be at least one full-size stand-alone example (in docs/examples/)
showing how it could be used.
We already have this helpful page on the site that shows exactly which options
that alredy are "covered" by one or more examples:
https://curl.se/libcurl/c/options-in-examples.html
As you can see there, we have a bit of work ahead of us. I expect this work to
take a while to finish.
The easiest way to help out, is to identify an existing example that could
also use an additional previously not used option in a sensible way.
Alternatively we create an entirely new file that shows use of the option in
question. Then submit the improvement as a normal pull request. Then continue
with another.
The complete set of stand-alone examples are listed here:
https://curl.se/libcurl/c/example.html
In the mean time I am going to work on adding links to a set of examples using
this option to the webpages on the site that document each individual option.
If we for example go to the webpage for the CURLOPT_ERRORBUFFER option, we
should be provided with a set of links to stand-alone examples using
CURLOPT_ERRORBUFFER. To help users understand how to use the option in a real
context, when the man page text and its limited example is not enough.
--
/ daniel.haxx.se
| Commercial curl support up to 24x7 is available!
| Private help, bug fixes, support, ports, new features
| https://curl.se/support.html
--
Unsubscribe: https://lists.haxx.se/mailman/listinfo/curl-library
Etiquette: https://curl.se/mail/etiquette.html
