From: Joey Hess Date: Fri, 11 Dec 2020 22:24:21 +0000 (-0400) Subject: mention annex.stalldetection and don't recommend too infrequent progress updates X-Git-Tag: archive/raspbian/10.20250416-2+rpi1~2^2^2~76^2~356 X-Git-Url: https://dgit.raspbian.org/?a=commitdiff_plain;h=3e608dfc1379bc197c6c6fb1a30369700516acf0;p=git-annex.git mention annex.stalldetection and don't recommend too infrequent progress updates --- diff --git a/doc/design/external_special_remote_protocol.mdwn b/doc/design/external_special_remote_protocol.mdwn index a8165e586d..eaf3f95943 100644 --- a/doc/design/external_special_remote_protocol.mdwn +++ b/doc/design/external_special_remote_protocol.mdwn @@ -272,7 +272,10 @@ handling a request. * `PROGRESS Int` Indicates the current progress of the transfer (in bytes). May be repeated any number of times during the transfer process, but it's wasteful to - update the progress until at least another 1% of the file has been sent. + update the progress too frequently. Bear in mind that this is used both + to display a progress meter for the user, and for annex.stalldetection. + So, sending an update on each 1% of the file may not be frequent enough, + as it could appear to be a stall when transferring a large file. This is highly recommended for STORE. (It is optional but good for RETRIEVE.) (git-annex does not send a reply to this message.) * `DIRHASH Key`