diff --git a/doc/platform-notes.xml b/doc/platform-notes.xml
index b27f24875759..6050271dbf6f 100644
--- a/doc/platform-notes.xml
+++ b/doc/platform-notes.xml
@@ -96,8 +96,8 @@
     </programlisting>
     <para>
      The package <literal>xcbuild</literal> can be used to build projects that
-     really depend on Xcode, however projects that build some kind of graphical
-     interface won't work without using Xcode in an impure way.
+     really depend on Xcode. However, this replacement is not 100%
+     compatible with Xcode and can occasionally cause issues.
     </para>
    </listitem>
   </itemizedlist>