# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1628369739 -7200
# Node ID 6b456edd075b3b90d872708006d317b2c7155291
# Parent  1bab9ddcac25d50f77e5c162bb5722c71056da44
Added more detail to some comments.

diff -r 1bab9ddcac25 -r 6b456edd075b libfsclient/lib/src/client.cc
--- a/libfsclient/lib/src/client.cc	Fri Aug 06 19:32:06 2021 +0200
+++ b/libfsclient/lib/src/client.cc	Sat Aug 07 22:55:39 2021 +0200
@@ -34,7 +34,9 @@
 
 
 
-/* Access the given position and synchronise state with the file object. */
+/* Access the given position and synchronise state with the file object. Pipe
+   objects may return busy conditions indicating that the desired access cannot
+   yet be fulfilled. */
 
 static long _access(file_t *file, offset_t position)
 {
@@ -97,7 +99,8 @@
 
 
 /* Return whether an operation on file should block for more content or more
-   space. */
+   space. A file must be configured for blocking, not be closed, and must either
+   be lacking content (if reading) or space (if writing). */
 
 static int _operation_blocking(file_t *file, int reading)
 {