diff --git a/x/lib/libadwaita.xml b/x/lib/libadwaita.xml
index 8f47aee866..0974c933bd 100644
--- a/x/lib/libadwaita.xml
+++ b/x/lib/libadwaita.xml
@@ -101,6 +101,15 @@
 cd    build &&
 
 meson setup --prefix=/usr --buildtype=release .. &&
+ninja</userinput></screen>
+
+    <para>
+      If you have <xref linkend='gi-docgen'/> installed and wish to build
+      the API documentation for this package, issue:
+    </para>
+
+<screen role='nodump'><userinput>sed "s/apiversion/'&libadwaita-version;'/" -i ../doc/meson.build &amp;&amp;
+meson configure -Dgtk_doc=true                    &amp;&amp;
 ninja</userinput></screen>
 
     <para>
@@ -121,15 +130,6 @@ ninja</userinput></screen>
     <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
       href="../../xincludes/meson-buildtype-release.xml"/>
 
-    <para>
-      <option>-Dgtk_doc=true</option>: Use this option if you have
-      <xref linkend="gi-docgen"/> installed and wish to install the
-      documentation.  If this option is used, run <command>mv
-      /usr/share/doc/libadwaita-{1,&libadwaita-version;}</command> as the
-      &root; user to fix the name of the directory for the documentation
-      after this package is installed.
-    </para>
-
   </sect2>
 
   <sect2 role="content">