diff --git a/docs/src/misc.rst b/docs/src/misc.rst
index 39241df8..e75cd54a 100644
--- a/docs/src/misc.rst
+++ b/docs/src/misc.rst
@@ -541,6 +541,10 @@ API
     memory allocated to `pwd` needs to be freed with
     :c:func:`uv_os_free_passwd`.
 
+    .. note::
+        If the effective uid does not have an entry in the password file this
+        function will return ENOENT even if the file exists.
+
     .. versionadded:: 1.9.0
 
 .. c:function:: void uv_os_free_passwd(uv_passwd_t* pwd)