diff --git a/docs/src/fs.rst b/docs/src/fs.rst
index 918bff94..f810319c 100644
--- a/docs/src/fs.rst
+++ b/docs/src/fs.rst
@@ -258,6 +258,10 @@ API
 
     Equivalent to :man:`utime(2)` and :man:`futime(2)` respectively.
 
+    .. note::
+      AIX: This function only works for AIX 7.1 and newer. It can still be called on older
+      versions but will return ``UV_ENOSYS``.
+
     .. versionchanged:: 1.10.0 sub-second precission is supported on Windows
 
 .. c:function:: int uv_fs_link(uv_loop_t* loop, uv_fs_t* req, const char* path, const char* new_path, uv_fs_cb cb)
diff --git a/docs/src/fs_event.rst b/docs/src/fs_event.rst
index c2d7f520..c08ade2e 100644
--- a/docs/src/fs_event.rst
+++ b/docs/src/fs_event.rst
@@ -8,6 +8,20 @@ FS Event handles allow the user to monitor a given path for changes, for example
 if the file was renamed or there was a generic change in it. This handle uses
 the best backend for the job on each platform.
 
+.. note::
+    For AIX, the non default IBM bos.ahafs package has to be installed.
+    The AIX Event Infrastructure file system (ahafs) has some limitations:
+
+        - ahafs tracks monitoring per process and is not thread safe. A separate process
+          must be spawned for each monitor for the same event.
+        - Events for file modification (writing to a file) are not received if only the
+          containing folder is watched.
+
+    See documentation_ for more details.
+
+    .. _documentation: http://www.ibm.com/developerworks/aix/library/au-aix_event_infrastructure/
+
+
 
 Data types
 ----------