First commit of David McCreedy's EBCDIC and TPF changes.

 curl_share_init.3 curl_share_setopt.3 libcurl.3 libcurl-easy.3		\

 libcurl-multi.3 libcurl-share.3 libcurl-errors.3 curl_easy_strerror.3	\

 curl_multi_strerror.3 curl_share_strerror.3 curl_global_init_mem.3	\

 libcurl-tutorial.3 curl_easy_reset.3

 libcurl-tutorial.3 curl_easy_reset.3 curl_easy_escape.3 curl_easy_unescape.3

HTMLPAGES = curl_easy_cleanup.html curl_easy_getinfo.html		\

 curl_easy_init.html curl_easy_perform.html curl_easy_setopt.html	\

 libcurl.html libcurl-multi.html libcurl-easy.html libcurl-share.html	\

 libcurl-errors.html curl_easy_strerror.html curl_multi_strerror.html	\

 curl_share_strerror.html curl_global_init_mem.html			\

 libcurl-tutorial.html curl_easy_reset.html

 libcurl-tutorial.html curl_easy_reset.html curl_easy_escape.html \

 curl_easy_unescape.html

PDFPAGES = curl_easy_cleanup.pdf curl_easy_getinfo.pdf			\

 curl_easy_init.pdf curl_easy_perform.pdf curl_easy_setopt.pdf		\

 libcurl-multi.pdf libcurl-easy.pdf libcurl-share.pdf			\

 libcurl-errors.pdf curl_easy_strerror.pdf curl_multi_strerror.pdf	\

 curl_share_strerror.pdf curl_global_init_mem.pdf libcurl-tutorial.pdf	\

 curl_easy_reset.pdf

 curl_easy_reset.pdf curl_easy_escape.pdf curl_easy_unescape.pdf

CLEANFILES = $(HTMLPAGES) $(PDFPAGES)

.\" **************************************************************************

.\" *                                  _   _ ____  _

.\" *  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 curl_easy_escape 3 "7 April 2006" "libcurl 7.15.4" "libcurl Manual"

.SH NAME

curl_easy_escape - URL encodes the given string

.SH SYNOPSIS

.B #include <curl/curl.h>

.sp

.BI "char *curl_easy_escape( CURL *" curl ", char *" url ", int "length " );"

.ad

.SH DESCRIPTION

This function converts the given input string to an URL encoded string and

returns that as a new allocated string. All input characters that are not a-z,

A-Z or 0-9 are converted to their "URL escaped" version (%NN where NN is a

two-digit hexadecimal number).

If the \fBlength\fP argument is set to 0 (zero), curl_easy_escape() uses

strlen() on the input \fBurl\fP to find out the size.

You must \fIcurl_free(3)\fP the returned string when you're done with it.

.SH AVAILABILITY

Added in 7.15.4 and replaces the old curl_escape() function.

.SH RETURN VALUE

A pointer to a zero terminated string or NULL if it failed.

.SH "SEE ALSO"

.BR curl_easy_unescape "(3), " curl_free "(3), " RFC 2396

.\" **************************************************************************

.\" *                                  _   _ ____  _

.\" *  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 curl_easy_unescape 3 "7 April 2006" "libcurl 7.15.4" "libcurl Manual"

.SH NAME

curl_easy_unescape - URL decodes the given string

.SH SYNOPSIS

.B #include <curl/curl.h>

.sp

.BI "char *curl_easy_unescape( CURL *" curl ", char *" url ", int "inlength

.BI ", int *" outlength " );"

.ad

.SH DESCRIPTION

This function converts the given URL encoded input string to a "plain string"

and returns that in an allocated memory area. All input characters that are

URL encoded (%XX where XX is a two-digit hexadecimal number) are converted to

their binary versions.

If the \fBlength\fP argument is set to 0 (zero), curl_easy_unescape() will use

strlen() on the input \fIurl\fP string to find out the size.

You must \fIcurl_free(3)\fP the returned string when you're done with it.

.SH AVAILABILITY

Added in 7.15.4 and replaces the old curl_unescape() function.

.SH RETURN VALUE

A pointer to a zero terminated string or NULL if it failed.

.SH "SEE ALSO"

.I curl_easy_escape(3), curl_free(3), RFC 2396

.BI "char *curl_escape( char *" url ", int "length " );"

.ad

.SH DESCRIPTION

Obsolete function. Use \fIcurl_easy_escape(3)\fP instead!

This function will convert the given input string to an URL encoded string and

return that as a new allocated string. All input characters that are not a-z,

A-Z or 0-9 will be converted to their "URL escaped" version (%NN where NN is a

input 'url' string to find out the size.

You must curl_free() the returned string when you're done with it.

.SH AVAILABILITY

Since 7.15.4, \fIcurl_easy_escape(3)\fP should be used. This function will

be removed in a future release.

.SH RETURN VALUE

A pointer to a zero terminated string or NULL if it failed.

.SH "SEE ALSO"

.BI "char *curl_unescape( char *" url ", int "length " );"

.ad

.SH DESCRIPTION

Obsolete function. Use \fIcurl_easy_unescape(3)\fP instead!

This function will convert the given URL encoded input string to a "plain

string" and return that as a new allocated string. All input characters that

are URL encoded (%XX where XX is a two-digit hexadecimal number) will be

input 'url' string to find out the size.

You must curl_free() the returned string when you're done with it.

.SH AVAILABILITY

Since 7.15.4, \fIcurl_easy_unescape(3)\fP should be used. This function will

be removed in a future release.

.SH RETURN VALUE

A pointer to a zero terminated string or NULL if it failed.

.SH "SEE ALSO"

.I curl_escape(3), curl_free(3), RFC 2396

.I curl_easy_escape(3), curl_easy_unescape(3), curl_free(3), RFC 2396