diff --git a/docs/manuals/source/Appendix/ReleaseNotes.rst b/docs/manuals/source/Appendix/ReleaseNotes.rst
index 993cdb8007f..a2aedd20dd4 100644
--- a/docs/manuals/source/Appendix/ReleaseNotes.rst
+++ b/docs/manuals/source/Appendix/ReleaseNotes.rst
@@ -80,7 +80,7 @@ Deprecated and Removed Features
 Bugs Fixed
 ^^^^^^^^^^
 * :mantis:`385`: Bareos daemon stop or restart hangs if bareos-tray-monitor is connected
-* :mantis:`975`: .bvfs\_lsdirs limit offset command parameters do not work properly
+* :mantis:`975`: .bvfs\_lsdirs limit offset command parameters do not work properly (only fixed for PostgreSQL)
 * :mantis:`990`: SD sometimes tries to load empty tape slot
 * :mantis:`1004`: Very high cpu usage on Debian stretch
 * :mantis:`1030`: Bscan does not work for migration and copy jobs
diff --git a/docs/manuals/source/DeveloperGuide/api.rst b/docs/manuals/source/DeveloperGuide/api.rst
index 80678bc8bf7..892e529a3c2 100644
--- a/docs/manuals/source/DeveloperGuide/api.rst
+++ b/docs/manuals/source/DeveloperGuide/api.rst
@@ -470,6 +470,11 @@ General notes
 -  Due to potential encoding problem, it’s advised to use ``pathid``
    instead of ``path`` in queries.
 
+.. limitation:: BVFS: bvfs_lsdirs limit/offset not working correctly on MySQL
+
+  As described in :mantis:`975` the limit/offset does not work correctly for bvfs_lsdirs on MySQL.
+  The problem has been fixed for PostgreSQL, but the SQL syntax required to formulate the query is unavailable on MySQL so there is no easy way to replicate that fix on MySQL.
+
 Get dependent jobs from a given JobId
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~