diff --git a/doc/flatpak-build-finish.xml b/doc/flatpak-build-finish.xml
index b2b138f1e..c96ecd870 100644
--- a/doc/flatpak-build-finish.xml
+++ b/doc/flatpak-build-finish.xml
@@ -258,6 +258,13 @@
                     xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
                     an absolute path, or a homedir-relative path like ~/dir.
                     This option can be used multiple times.
+                </para><para>
+                    In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
+                    was previously granted. However, as a special case, "--nofilesystem=home"  will remove access to all
+                    previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
+                    and "--nofilesystem=host" will remove access to all previously granted locations.
+                    Note: absolute paths that happen to be inside the current users home directory are not considered for
+                    this special case.
                 </para></listitem>
             </varlistentry>
 
diff --git a/doc/flatpak-build.xml b/doc/flatpak-build.xml
index a48e2acdf..2cc0cc6d0 100644
--- a/doc/flatpak-build.xml
+++ b/doc/flatpak-build.xml
@@ -247,6 +247,13 @@
                     xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
                     an absolute path, or a homedir-relative path like ~/dir.
                     This option can be used multiple times.
+                </para><para>
+                    In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
+                    was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
+                    previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
+                    and "--nofilesystem=host" will remove access to all previously granted locations.
+                    Note: absolute paths that happen to be inside the current users home directory are not considered for
+                    this special case.
                 </para></listitem>
             </varlistentry>
 
diff --git a/doc/flatpak-override.xml b/doc/flatpak-override.xml
index e2768a429..0695b32f5 100644
--- a/doc/flatpak-override.xml
+++ b/doc/flatpak-override.xml
@@ -230,6 +230,13 @@
                     xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
                     an absolute path, or a homedir-relative path like ~/dir.
                     This option can be used multiple times.
+                </para><para>
+                    In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
+                    was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
+                    previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
+                    and "--nofilesystem=host" will remove access to all previously granted locations.
+                    Note: absolute paths that happen to be inside the current users home directory are not considered for
+                    this special case.
                 </para></listitem>
             </varlistentry>
 
diff --git a/doc/flatpak-run.xml b/doc/flatpak-run.xml
index a9c2c9471..77b41c39b 100644
--- a/doc/flatpak-run.xml
+++ b/doc/flatpak-run.xml
@@ -373,7 +373,15 @@
                     xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
                     an absolute path, or a homedir-relative path like ~/dir.
                     This option can be used multiple times.
+                </para><para>
+                    In general, "--nofilesystem=PATH" will remove access to a specific path if exactly that path
+                    was previously granted. However, as a special case, "--nofilesystem=home" will remove access to all
+                    previously granted locations inside the homedir as well, such as "home/some-dir", or "xdg-download",
+                    and "--nofilesystem=host" will remove access to all previously granted locations.
+                    Note: absolute paths that happen to be inside the current users home directory are not considered for
+                    this special case.
                 </para></listitem>
+
             </varlistentry>
 
             <varlistentry>