add note for non-blocking file descriptor used for json_loadfd

1 files changed, 5 insertions, 1 deletions

diff --git a/doc/apiref.rst b/doc/apiref.rst
index 3c4fa47..cdd2058 100644
--- a/doc/apiref.rst
+++ b/doc/apiref.rst
@@ -1333,7 +1333,11 @@ If no error or position information is needed, you can pass *NULL*.
    It is important to note that this function can only succeed on stream
    file descriptors (such as SOCK_STREAM). Using this function on a
    non-stream file descriptor will result in undefined behavior. For
-   non-stream file descriptors, see instead :func:`json_loadb()`.
+   non-stream file descriptors, see instead :func:`json_loadb()`.In
+   addition, please also note that this function cannot be used on
+   non-blocking file descriptors (such as non-blocking socket). Using
+   this function on non-blocking file descriptors has a high risk of
+   data loss because it does not support resuming.
 
    This function requires POSIX and fails on all non-POSIX systems.