Commit 8c41f368 authored by Daniel Stenberg's avatar Daniel Stenberg
Browse files

CURLOPT_*.3: added lots of small example sections

parent 6105029b

docs/libcurl/opts/CURLOPT_COOKIE.3

+11 −2
Original line number Diff line number Diff line
@@ -5,7 +5,7 @@ 
.\" *                            | (__| |_| |  _ <| |___

.\" *                             \___|\___/|_| \_\_____|

.\" *

.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" * Copyright (C) 1998 - 2015, 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
@@ -51,7 +51,16 @@ NULL, no cookies 
.SH PROTOCOLS

HTTP

.SH EXAMPLE

TODO

.nf

CURL *curl = curl_easy_init();

if(curl) {

  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");



  curl_easy_setopt(curl, CURLOPT_COOKIE, "tool=curl; fun=yes;");



  curl_easy_perform(curl);

}

.fi

.SH AVAILABILITY

If HTTP is enabled

.SH RETURN VALUE

docs/libcurl/opts/CURLOPT_IGNORE_CONTENT_LENGTH.3

+12 −2
Original line number Diff line number Diff line
@@ -5,7 +5,7 @@ 
.\" *                            | (__| |_| |  _ <| |___

.\" *                             \___|\___/|_| \_\_____|

.\" *

.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" * Copyright (C) 1998 - 2015, 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
@@ -42,7 +42,17 @@ Only use this option if strictly necessary. 
.SH PROTOCOLS

HTTP

.SH EXAMPLE

TODO

.nf

CURL *curl = curl_easy_init();

if(curl) {

  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");



  /* we know the server is silly, ignore content-length */

  curl_easy_setopt(curl, CURLOPT_IGNORE_CONTENT_LENGTH, 1L);



  curl_easy_perform(curl);

}

.fi

.SH AVAILABILITY

Added in 7.14.1

.SH RETURN VALUE

docs/libcurl/opts/CURLOPT_INFILESIZE.3

+15 −2
Original line number Diff line number Diff line
@@ -5,7 +5,7 @@ 
.\" *                            | (__| |_| |  _ <| |___

.\" *                             \___|\___/|_| \_\_____|

.\" *

.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" * Copyright (C) 1998 - 2015, 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
@@ -49,7 +49,20 @@ Unset 
.SH PROTOCOLS

Many

.SH EXAMPLE

TODO

.nf

CURL *curl = curl_easy_init();

if(curl) {

  long uploadsize = FILE_SIZE;



  curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/destination.tar.gz");



  curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);



  curl_easy_setopt(curl, CURLOPT_INFILESIZE, uploadsize);



  curl_easy_perform(curl);

}

.fi

.SH AVAILABILITY

SMTP support added in 7.23.0

.SH RETURN VALUE

docs/libcurl/opts/CURLOPT_INFILESIZE_LARGE.3

+15 −2
Original line number Diff line number Diff line
@@ -5,7 +5,7 @@ 
.\" *                            | (__| |_| |  _ <| |___

.\" *                             \___|\___/|_| \_\_____|

.\" *

.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" * Copyright (C) 1998 - 2015, 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
@@ -50,7 +50,20 @@ Unset 
.SH PROTOCOLS

Many

.SH EXAMPLE

TODO

.nf

CURL *curl = curl_easy_init();

if(curl) {

  curl_off_t uploadsize = FILE_SIZE;



  curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/destination.tar.gz");



  curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L);



  curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, uploadsize);



  curl_easy_perform(curl);

}

.fi

.SH AVAILABILITY

SMTP support added in 7.23.0

.SH RETURN VALUE

docs/libcurl/opts/CURLOPT_READDATA.3

+14 −2
Original line number Diff line number Diff line
@@ -5,7 +5,7 @@ 
.\" *                            | (__| |_| |  _ <| |___

.\" *                             \___|\___/|_| \_\_____|

.\" *

.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, <daniel@haxx.se>, et al.

.\" * Copyright (C) 1998 - 2015, 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
@@ -42,7 +42,19 @@ By default, this is a FILE * to stdin. 
.SH PROTOCOLS

This is used for all protocols when sending data.

.SH EXAMPLE

TODO

.nf

CURL *curl = curl_easy_init();

struct MyData this;

if(curl) {

  curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");



  /* pass pointer that gets passed in to the

     CURLOPT_READFUNCTION callback */

  curl_easy_setopt(curl, CURLOPT_READDATA, &this);



  curl_easy_perform(curl);

}

.fi

.SH AVAILABILITY

This option was once known by the older name \fICURLOPT_INFILE\fP, the name

\fICURLOPT_READDATA\fP was introduced in 7.9.7.