aboutsummaryrefslogtreecommitdiff
path: root/docs/libcurl
diff options
context:
space:
mode:
authorDan Fandrich <dan@coneharvesters.com>2008-09-09 05:39:59 +0000
committerDan Fandrich <dan@coneharvesters.com>2008-09-09 05:39:59 +0000
commitac1ab03cb0f7477357e5417a719b6ddc73b5dd41 (patch)
tree4ca25503791928f23e9bd6ce27c98958eded1fe9 /docs/libcurl
parent2ef72f7abb0f955d08a7f26d1a65a21be26b1af9 (diff)
Hammer home the fact that "multi interface" != "multi-threaded"
Diffstat (limited to 'docs/libcurl')
-rw-r--r--docs/libcurl/libcurl-tutorial.312
1 files changed, 9 insertions, 3 deletions
diff --git a/docs/libcurl/libcurl-tutorial.3 b/docs/libcurl/libcurl-tutorial.3
index 9e97fae9e..1a1b3980f 100644
--- a/docs/libcurl/libcurl-tutorial.3
+++ b/docs/libcurl/libcurl-tutorial.3
@@ -1117,12 +1117,18 @@ interface that transfers one file at a time and doesn't return until its
done.
The multi interface on the other hand, allows your program to transfer
-multiple files in both directions at the same time, without forcing you to
-use multiple threads.
+multiple files in both directions at the same time, without forcing you
+to use multiple threads. The name might make it seem that the multi
+interface is for multi-threaded programs, but the truth is almost the
+reverse. The multi interface can allow a single-threaded application
+to perform the same kinds of multiple, simultaneous transfers that
+multi-threaded programs can perform. It allows many of the benefits
+of multi-threaded transfers without the complexity of managing and
+synchronizing many threads.
To use this interface, you are better off if you first understand the basics
of how to use the easy interface. The multi interface is simply a way to make
-multiple transfers at the same time, by adding up multiple easy handles in to
+multiple transfers at the same time by adding up multiple easy handles in to
a "multi stack".
You create the easy handles you want and you set all the options just like you