diff --git a/doc/flatpak-build.xml b/doc/flatpak-build.xml
index af16ddd9..eee5a549 100644
--- a/doc/flatpak-build.xml
+++ b/doc/flatpak-build.xml
@@ -161,12 +161,27 @@
             </varlistentry>
 
             <varlistentry>
-                <term><option>--filesystem=FS</option></term>
+                <term><option>--filesystem=FILESYSTEM[:ro]</option></term>
 
                 <listitem><para>
                     Allow the application access to a subset of the filesystem.
                     This overrides to the Context section from the application metadata.
-                    FS can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
+                    FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
+                    xdg-music, xdg-pictures, xdg-public-share, xdg-templates, xdg-videos,
+                    an absolute path, or a homedir-relative path like ~/dir.
+                    The optional :ro suffix indicates that the location will be read-only.
+                    This option can be used multiple times.
+                </para></listitem>
+            </varlistentry>
+
+            <varlistentry>
+                <term><option>--nofilesystem=FILESYSTEM</option></term>
+
+                <listitem><para>
+                    Remove access to the specified subset of the filesystem from
+                    the application. This overrides to the Context section from the
+                    application metadata.
+                    FILESYSTEM can be one of: home, host, xdg-desktop, xdg-documents, xdg-download
                     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.