diff --git a/doc/flatpak-build-finish.xml b/doc/flatpak-build-finish.xml
index 2b5af572..8ad1f47e 100644
--- a/doc/flatpak-build-finish.xml
+++ b/doc/flatpak-build-finish.xml
@@ -160,6 +160,10 @@
                     the [Context] group in the metadata.
                     FEATURE must be one of: devel.
                     This option can be used multiple times.
+                 </para><para>
+                    The <code>devel</code> feature allows the application to
+                    access certain syscalls such as <code>ptrace()</code>, and
+                    <code>perf_event_open()</code>.
                 </para></listitem>
             </varlistentry>