more formatting fixes

.SH DESCRIPTION

This is an overview on how to use libcurl in your C programs. There are

specific man pages for each function mentioned in here. There are also the

\fIlibcurl-easy\fP man page, the \fIlibcurl-multi\fP man page, the

\fIlibcurl-share\fP man page and the \fIlibcurl-the-guide\fP document for

\fIlibcurl-easy(3)\fP man page, the \fIlibcurl-multi(3)\fP man page, the

\fIlibcurl-share(3)\fP man page and the \fIlibcurl-the-guide\fP document for

further reading on how to do programming with libcurl.

There exist more than a dozen custom bindings that bring libcurl access to

option of using the "easy" interface, or the "multi" interface.

The easy interface is a synchronous interface with which you call

\fIcurl_easy_perform\fP and let it perform the transfer. When it is completed,

the function return and you can continue. More details are found in the

.BR "libcurl-easy (3)"

man page.

\fIcurl_easy_perform(3)\fP and let it perform the transfer. When it is

completed, the function return and you can continue. More details are found in

the \fIlibcurl-easy(3)\fP man page.

The multi interface on the other hand is an asynchronous interface, that you

call and that performs only a little piece of the tranfer on each invoke. It

You can have multiple easy handles share certain data, even if they are used

in different threads. This magic is setup using the share interface, as

described in the \fIlibcurl-share\fP man page.

described in the \fIlibcurl-share(3)\fP man page.

There is also a series of other helpful functions to use. They are:

several threads. libcurl is thread-safe and can be used in any number of

threads, but you must use separate curl handles if you want to use libcurl in

more than one thread simultaneously.

.SH "PERSISTANT CONNECTIONS"

.SH "PERSISTENT CONNECTIONS"

Persistent connections means that libcurl can re-use the same connection for

several transfers, if the conditions are right.

libcurl will *always* attempt to use persistent connections. Whenever you use

\fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP, libcurl will

libcurl will \fBalways\fP attempt to use persistent connections. Whenever you

use \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP, libcurl will

attempt to use an existing connection to do the transfer, and if none exists

it'll open a new one that will be subject for re-use on a possible following

call to \fIcurl_easy_perform(3)\fP or \fIcurl_multi_perform(3)\fP.