--- IO-AIO/AIO.pm	2018/02/20 05:23:47	1.282
+++ IO-AIO/AIO.pm	2018/02/20 06:05:19	1.283
@@ -2406,7 +2406,18 @@
 
 =head1 KNOWN BUGS
 
-Known bugs will be fixed in the next release.
+Known bugs will be fixed in the next release :)
+
+=head1 KNOWN ISSUES
+
+Calls that try to "import" foreign memory areas (such as C<IO::AIO::mmap>
+or C<IO::AIO::aio_slurp>) do not work with generic lvalues, such as
+non-created hash slots or other scalars I didn't think of. It's best to
+avoid such and either use scalar variables or making sure that the scalar
+exists (e.g. by storing C<undef>) and isn't "funny" (e.g. tied).
+
+I am not sure anything can be done about this, so this is considered a
+known issue, rather than a bug.
 
 =head1 SEE ALSO