Patch #1669331: clarify shutil.copyfileobj() behavior wrt. file position.

 (backport from rev. 54202)

diff --git a/Doc/lib/libshutil.tex b/Doc/lib/libshutil.tex
index 449d7414f38b248d524c3e493cec04ef247f5567..f5c55a04b123d68a0e99c304c2b70d39c2e65475 100644 (file)
--- a/Doc/lib/libshutil.tex
+++ b/Doc/lib/libshutil.tex
@@ -34,7 +34,9 @@ file type and creator codes will not be correct.
   is the buffer size. In particular, a negative \var{length} value
   means to copy the data without looping over the source data in
   chunks; by default the data is read in chunks to avoid uncontrolled
-  memory consumption.
+  memory consumption. Note that if the current file position of the
+  \var{fsrc} object is not 0, only the contents from the current file
+  position to the end of the file will be copied.
 \end{funcdesc}
 
 \begin{funcdesc}{copymode}{src, dst}