-NOTE: machine=default uses a config that works on all supported architectures
-regardless of the capabilities of the machine where the build is happening.
+ once meson has been run to configure a build in a directory, it
+ cannot be run again on the same directory. Instead ``meson configure``
+ should be used to change the build settings within the directory, and when
+ ``ninja`` is called to do the build itself, it will trigger the necessary
+ re-scan from meson.
+
+.. note::
+ machine=generic uses a config that works on all supported architectures
+ regardless of the capabilities of the machine where the build is happening.