Convert build/docs/*.rst (top-level and mozbuild/) to MyST-flavored
Markdown.
- Keep build/docs/mozbuild-symbols.rst as RST. The mozbuildsymbols
custom directive emits nodes that confuse autosectionlabel when
wrapped in a MyST eval-rst block.
- Keep build/docs/supported-configurations.rst as RST so that
docs/contributing/build/supported.md can continue to use the MyST
{include} directive on the original source.
- Refresh allowed-warnings globs to match the .md filenames for
code-quality, contributing, crash-reporting, gtest, jsloader, js,
overview, setup, and js/build.
Differential Revision: https://phabricator.services.mozilla.com/D304226
78 lines
1.0 KiB
Markdown
78 lines
1.0 KiB
Markdown
# Build System
|
|
|
|
## Important Concepts
|
|
|
|
```{toctree}
|
|
:maxdepth: 1
|
|
|
|
glossary
|
|
build-overview
|
|
supported-configurations
|
|
Mozconfig Files <mozconfigs>
|
|
mozbuild-files
|
|
mozbuild-symbols
|
|
files-metadata
|
|
Profile Guided Optimization <pgo>
|
|
slow
|
|
environment-variables
|
|
build-targets
|
|
python
|
|
test_manifests
|
|
mozinfo
|
|
preprocessor
|
|
jar-manifests
|
|
defining-binaries
|
|
defining-xpcom-components
|
|
toolchains
|
|
toolchains-update-policy
|
|
locales
|
|
unified-builds
|
|
cross-compile
|
|
rust
|
|
sparse
|
|
Support for projects building with GN <gn>
|
|
telemetry
|
|
sccache-dist
|
|
test_certificates
|
|
```
|
|
|
|
## integrated development environment (IDE)
|
|
|
|
```{toctree}
|
|
:maxdepth: 1
|
|
|
|
cppeclipse
|
|
visualstudio
|
|
```
|
|
|
|
## mozbuild
|
|
|
|
mozbuild is a Python package containing a lot of the code for the
|
|
Mozilla build system.
|
|
|
|
```{toctree}
|
|
:maxdepth: 1
|
|
|
|
mozbuild/index
|
|
```
|
|
|
|
## Snap Package
|
|
|
|
[Snap](https://snapcraft.io/docs) is a packaging format
|
|
|
|
```{toctree}
|
|
:maxdepth: 1
|
|
|
|
snap
|
|
```
|
|
|
|
## Flatpak Package
|
|
|
|
[Flatpak](https://docs.flatpak.org/en/latest/) is a packaging format
|
|
|
|
```{toctree}
|
|
:maxdepth: 1
|
|
|
|
flatpak
|
|
```
|