docs/devel/build-system.rst

7 system has two stages; first the developer runs the "configure" script
19      ../qemu/configure
26      ../configure
33 Stage 1: configure
36 The configure script has five tasks:
54 The configure script automatically recognizes command line options for
63 Modifying ``configure``
66 ``configure`` is a shell script; it uses ``#!/bin/sh`` and therefore
71 The configure script provides a variety of functions to help writing
77    configure script with non-zero status.
96 Configure does not generally perform tests for compiler options beyond
128 An important step in ``configure`` is to create a Python virtual
135 At this stage, ``configure`` also queries the chosen Python interpreter
143 ``configure`` is not able to find it.  When this happens, the dependency
147 If a package is available for the chosen interpreter, ``configure``
149 If not, ``configure`` can also optionally install dependencies in the
152 ``--disable-download``; and anyway, it only happens when a ``configure``
173 When dependencies are downloaded, instead, ``configure`` uses a "known
211    or cross compiled under the direction of the configure script
360  - Add code to print out the feature status in the configure summary
369 Unless the option was given a non-``auto`` value (on the configure
391 For the configure script to parse the new option, the
404 because it automatically uses the value of configure's --python= option.
419 This is needed to obey the --python= option passed to the configure
424 environment and should be invoked through the scripts that ``configure``
444 running ``configure`` again when the script changes.  Apart from invoking
513 go through any pre-processing as seen with autotools, where configure
516 Built by configure:
519   When configure has determined the characteristics of the build host it
524   sees that the modification timestamp on configure is newer than that on
525   ``config-host.mak``, then configure will be re-run.
534   A small shell script that will invoke configure again with the same
536   rerun configure after changes to the source code, but it can also be