From ae7a09db20081672242cbf69bb871f3ab1c5a24c Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Fri, 23 Nov 2018 16:55:33 +0100 Subject: CURLOPT_WRITEFUNCTION.3: spell out that it gets called many times --- docs/libcurl/opts/CURLOPT_WRITEFUNCTION.3 | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/docs/libcurl/opts/CURLOPT_WRITEFUNCTION.3 b/docs/libcurl/opts/CURLOPT_WRITEFUNCTION.3 index b6cdabf70..11edeb2e9 100644 --- a/docs/libcurl/opts/CURLOPT_WRITEFUNCTION.3 +++ b/docs/libcurl/opts/CURLOPT_WRITEFUNCTION.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2014, Daniel Stenberg, , et al. +.\" * Copyright (C) 1998 - 2018, Daniel Stenberg, , et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -35,8 +35,10 @@ Pass a pointer to your callback function, which should match the prototype shown above. This callback function gets called by libcurl as soon as there is data -received that needs to be saved. \fIptr\fP points to the delivered data, and -the size of that data is \fInmemb\fP; \fIsize\fP is always 1. +received that needs to be saved. For most transfers, this callback gets called +many times and each invoke delivers another chunk of data. \fIptr\fP points to +the delivered data, and the size of that data is \fInmemb\fP; \fIsize\fP is +always 1. The callback function will be passed as much data as possible in all invokes, but you must not make any assumptions. It may be one byte, it may be -- cgit v1.2.1