mirror of
https://gitlab.winehq.org/wine/wine-gecko.git
synced 2024-09-13 09:24:08 -07:00
fd5055803b
This is the beginning of Mozilla's new build system. In this patch, we have a Python sandbox tailored for execution of Python scripts which will define the build system. We also have a build reader that traverses a linked set of scripts. More details are available in the thorough README.rst files as part of this patch. * * * Bug 784841 - Part 2b: Option to not descend into child moz.build files; r=ted
40 lines
1.3 KiB
ReStructuredText
40 lines
1.3 KiB
ReStructuredText
========
|
|
mozbuild
|
|
========
|
|
|
|
mozbuild is a Python package providing functionality used by Mozilla's
|
|
build system.
|
|
|
|
Modules Overview
|
|
================
|
|
|
|
* mozbuild.compilation -- Functionality related to compiling. This
|
|
includes managing compiler warnings.
|
|
* mozbuild.frontend -- Functionality for reading build frontend files
|
|
(what defines the build system) and converting them to data structures
|
|
which are fed into build backends to produce backend configurations.
|
|
|
|
Overview
|
|
========
|
|
|
|
The build system consists of frontend files that define what to do. They
|
|
say things like "compile X" "copy Y."
|
|
|
|
The mozbuild.frontend package contains code for reading these frontend
|
|
files and converting them to static data structures. The set of produced
|
|
static data structures for the tree constitute the current build
|
|
configuration.
|
|
|
|
There exist entities called build backends. From a high level, build
|
|
backends consume the build configuration and do something with it. They
|
|
typically produce tool-specific files such as make files which can be used
|
|
to build the tree.
|
|
|
|
Builders are entities that build the tree. They typically have high
|
|
cohesion with a specific build backend.
|
|
|
|
Piecing it all together, we have frontend files that are parsed into data
|
|
structures. These data structures are fed into a build backend. The output
|
|
from build backends is used by builders to build the tree.
|
|
|