changed wording slightly, and added standard boiler-plate header
authorDaniel Stenberg <daniel@haxx.se>
Mon, 26 Jun 2006 06:43:45 +0000 (06:43 +0000)
committerDaniel Stenberg <daniel@haxx.se>
Mon, 26 Jun 2006 06:43:45 +0000 (06:43 +0000)
docs/libcurl/libcurl-multi.3

index 955063a..b6d95b1 100644 (file)
@@ -1,6 +1,25 @@
-.\" You can view this file with:
-.\" nroff -man [file]
-.\" $Id$
+.\" **************************************************************************
+.\" *                                  _   _ ____  _
+.\" *  Project                     ___| | | |  _ \| |
+.\" *                             / __| | | | |_) | |
+.\" *                            | (__| |_| |  _ <| |___
+.\" *                             \___|\___/|_| \_\_____|
+.\" *
+.\" * Copyright (C) 1998 - 2006, Daniel Stenberg, <daniel@haxx.se>, et al.
+.\" *
+.\" * This software is licensed as described in the file COPYING, which
+.\" * you should have received as part of this distribution. The terms
+.\" * are also available at http://curl.haxx.se/docs/copyright.html.
+.\" *
+.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
+.\" * copies of the Software, and permit persons to whom the Software is
+.\" * furnished to do so, under the terms of the COPYING file.
+.\" *
+.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
+.\" * KIND, either express or implied.
+.\" *
+.\" * $Id$
+.\" **************************************************************************
 .\"
 .TH libcurl-multi 3 "13 Oct 2001" "libcurl 7.10.1" "libcurl multi interface"
 .SH NAME
@@ -14,8 +33,8 @@ for an overview of the libcurl easy interface.
 
 All functions in the multi interface are prefixed with curl_multi.
 .SH "OBJECTIVES"
-The multi interface introduces several new abilities that the easy interface
-refuses to offer. They are mainly:
+The multi interface offers several abilities that the easy interface doesn't.
+They are mainly:
 
 1. Enable a "pull" interface. The application that uses libcurl decides where
 and when to ask libcurl to get/send data.
@@ -23,8 +42,8 @@ and when to ask libcurl to get/send data.
 2. Enable multiple simultaneous transfers in the same thread without making it
 complicated for the application.
 
-3. Enable the application to select() on its own file descriptors and curl's
-file descriptors simultaneous easily.
+3. Enable the application to wait for action on its own file descriptors and
+curl's file descriptors simultaneous easily.
 .SH "ONE MULTI HANDLE MANY EASY HANDLES"
 To use the multi interface, you must first create a 'multi handle' with
 \fIcurl_multi_init(3)\fP. This handle is then used as input to all further