Ticket #12412: 12412_testing_docs.diff

docs/topics/testing.txt

@@ -667 +667 @@
 
         (The name ``attachment`` here is not relevant; use whatever name your
         file-processing code expects.)
+        
+        Note that if you wish to use the same file handle for multiple 
+        ``post()`` calls then you will need to manually reset the file pointer 
+        between posts. It is best practice to manually close the file 
+        after it has been provided to ``post()``, as demonstrated above.
+        
+        It can also be helpful to open file handles in ``rb`` (read binary) 
+        mode for sending via ``post()``. This is particularly true for image 
+        files and other data not in plain text format.
 
-        Note that you should manually close the file after it has been provided
-        to ``post()``.
-
         The ``extra`` argument acts the same as for :meth:`Client.get`.
 
         .. versionchanged:: 1.1