random formatting updates to look better in HTML version

docs/libcurl/curl_multi_add_handle.3

@@ -9,11 +9,11 @@ curl_multi_add_handle - add an easy handle to a multi session
 CURLMcode curl_multi_add_handle(CURLM *multi_handle, CURL *easy_handle);
 .ad
 .SH DESCRIPTION
-Adds a standard easy handle to the multi stack. This will make this multi
+Adds a standard easy handle to the multi stack. This function call will make
-handle control the specified easy handle.
+this \fImulti_handle\fP control the specified \fIeasy_handle\fP.
 
 When an easy handle has been added to a multi stack, you can not and you must
-not use curl_easy_perform() on that handle!
+not use \fIcurl_easy_perform(3)\fP on that handle!
 .SH RETURN VALUE
 CURLMcode type, general libcurl multi interface error code.
 .SH "SEE ALSO"

docs/libcurl/curl_multi_cleanup.3

@@ -11,7 +11,7 @@ curl_multi_cleanup - close down a multi session
 .SH DESCRIPTION
 Cleans up and removes a whole multi stack. It does not free or touch any
 individual easy handles in any way - they still need to be closed
-individually, using the usual curl_easy_cleanup() way.
+individually, using the usual \fIcurl_easy_cleanup(3)\fP way.
 .SH RETURN VALUE
 CURLMcode type, general libcurl multi interface error code.
 .SH "SEE ALSO"

docs/libcurl/curl_multi_fdset.3

@@ -22,6 +22,7 @@ NOTE that once this call is made, you must not remove the sets you point to,
 as libcurl will need to be able to read them. It needs them after select()
 calls, to know if certain sockets are readable or writable.
 .SH RETURN VALUE
-CURLMcode type, general libcurl multi interface error code.
+CURLMcode type, general libcurl multi interface error code. See
+\fIlibcurl-errors.3\fP
 .SH "SEE ALSO"
 .BR curl_multi_cleanup "(3)," curl_multi_init "(3)"

docs/libcurl/curl_multi_init.3

@@ -2,7 +2,7 @@
 .\"
 .TH curl_multi_init 3 "1 March 2002" "libcurl 7.9.5" "libcurl Manual"
 .SH NAME
-curl_multi_init - Start a multi session
+curl_multi_init - create a multi handle
 .SH SYNOPSIS
 .B #include <curl/curl.h>
 .sp
@@ -12,11 +12,10 @@ curl_multi_init - Start a multi session
 This function returns a CURLM handle to be used as input to all the other
 multi-functions, sometimes refered to as a multi handle on some places in the
 documentation. This init call MUST have a corresponding call to
-\fIcurl_multi_cleanup\fP when the operation is complete.
+\fIcurl_multi_cleanup(3)\fP when the operation is complete.
 .SH RETURN VALUE
 If this function returns NULL, something went wrong and you cannot use the
 other curl functions.
 .SH "SEE ALSO"
 .BR curl_multi_cleanup "(3)," curl_global_init "(3)," curl_easy_init "(3)"
-.SH BUGS
+
-Surely there are some, you tell me!

docs/libcurl/curl_multi_perform.3

@@ -29,8 +29,9 @@ NOTE that this only returns errors etc regarding the whole multi stack. There
 might still have occurred problems on invidual transfers even when this
 function returns OK.
 .SH "TYPICAL USAGE"
-Most application will use \fIcurl_multi_fdset\fP to get the multi_handle's
+Most application will use \fIcurl_multi_fdset(3)\fP to get the multi_handle's
 file descriptors, then it'll wait for action on them using select() and as
-soon as one or more of them are ready, \fIcurl_multi_perform\fP gets called.
+soon as one or more of them are ready, \fIcurl_multi_perform(3)\fP gets
+called.
 .SH "SEE ALSO"
-.BR curl_multi_cleanup "(3)," curl_multi_init "(3)"
+.BR curl_multi_cleanup "(3)," curl_multi_init "(3)," curl_multi_fdset "(3)"

docs/libcurl/libcurl-multi.3

@@ -32,7 +32,7 @@ complicated for the application.
 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\fP. This handle is then used as input to all further
+\fIcurl_multi_init(3)\fP. This handle is then used as input to all further
 curl_multi_* functions.
 
 Each single transfer is built up with an easy handle. You must create them,