docs: document limitations of fix for bug #975

Co-Authored-By: Frank Ueberschar <frank.ueberschar@bareos.com> (cherry picked from commit fb06eb9)
bareos · Jan 17, 2020 · 05ad851 · 05ad851
1 parent b5be5ef
commit 05ad851
Show file tree

Hide file tree

Showing 2 changed files with 6 additions and 1 deletion.
diff --git 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
@@ -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
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~