diff --git a/docs-xml/smbdotconf/filename/hideunreadable.xml b/docs-xml/smbdotconf/filename/hideunreadable.xml
index c2c1654c1cf..992f1350c6f 100644
--- a/docs-xml/smbdotconf/filename/hideunreadable.xml
+++ b/docs-xml/smbdotconf/filename/hideunreadable.xml
@@ -5,6 +5,9 @@
This parameter prevents clients from seeing the
existance of files that cannot be read. Defaults to off.
+ Please note that enabling this can slow down listing large
+ directories significantly. Samba has to evaluate the ACLs of all
+ directory members, which can be a lot of effort.
no
diff --git a/docs-xml/smbdotconf/filename/hideunwriteablefiles.xml b/docs-xml/smbdotconf/filename/hideunwriteablefiles.xml
index 831e8c69c9e..66658607c11 100644
--- a/docs-xml/smbdotconf/filename/hideunwriteablefiles.xml
+++ b/docs-xml/smbdotconf/filename/hideunwriteablefiles.xml
@@ -7,6 +7,9 @@
This parameter prevents clients from seeing the existance of files that cannot be written to.
Defaults to off. Note that unwriteable directories are shown as usual.
+ Please note that enabling this can slow down listing large
+ directories significantly. Samba has to evaluate the ACLs of all directory
+ members, which can be a lot of effort.
no