Solution Filesystem

QBuild builds a single, virtual filesystem into which it maps one or more real locations.

For example, it is typical to have a solution filesystem with mounts like this:

Real path	Solution path
/home/user/build/qtopia/4.4	/
/home/user/src/qtopia/4.4/devices/mydevice/src	/src
/home/user/src/qtopia/4.4	/
/home/user/src/qtopia/4.4/qbuild/extensions	/extensions

Files in QBuild are specified using their solution path. Using a test like exists(/src/foo) searches for the file in the following real locations:

/home/user/build/qtopia/4.4/src/foo
/home/user/src/qtopia/4.4/devices/mydevice/src/foo
/home/user/src/qtopia/4.4/src/foo

The order of the mounts is important because files will be returned from the first location that they exist in. This means that "override" locations should appear before "fallback" locations. It also means that the "output" location is always listed first.

Note that QBuild can reference files that do not live within the solution filesystem. These files are handled by the SolutionFile class.