--- IO-AIO/README	2008/10/12 22:40:52	1.33
+++ IO-AIO/README	2009/04/21 20:06:05	1.35
@@ -277,10 +277,13 @@
 
     aio_read $fh,$offset,$length, $data,$dataoffset, $callback->($retval)
     aio_write $fh,$offset,$length, $data,$dataoffset, $callback->($retval)
-        Reads or writes $length bytes from the specified $fh and $offset
-        into the scalar given by $data and offset $dataoffset and calls the
-        callback without the actual number of bytes read (or -1 on error,
-        just like the syscall).
+        Reads or writes $length bytes from or to the specified $fh and
+        $offset into the scalar given by $data and offset $dataoffset and
+        calls the callback without the actual number of bytes read (or -1 on
+        error, just like the syscall).
+
+        "aio_read" will, like "sysread", shrink or grow the $data scalar to
+        offset plus the actual number of bytes read.
 
         If $offset is undefined, then the current file descriptor offset
         will be used (and updated), otherwise the file descriptor offset
@@ -544,6 +547,18 @@
         If this call isn't available because your OS lacks it or it couldn't
         be detected, it will be emulated by calling "fsync" instead.
 
+    aio_sync_file_range $fh, $offset, $nbytes, $flags, $callback->($status)
+        Sync the data portion of the file specified by $offset and $length
+        to disk (but NOT the metadata), by calling the Linux-specific
+        sync_file_range call. If sync_file_range is not available or it
+        returns ENOSYS, then fdatasync or fsync is being substituted.
+
+        $flags can be a combination of
+        "IO::AIO::SYNC_FILE_RANGE_WAIT_BEFORE",
+        "IO::AIO::SYNC_FILE_RANGE_WRITE" and
+        "IO::AIO::SYNC_FILE_RANGE_WAIT_AFTER": refer to the sync_file_range
+        manpage for details.
+
     aio_pathsync $path, $callback->($status)
         This request tries to open, fsync and close the given path. This is
         a composite request intended to sync directories after directory