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
16 lines
834 B
Markdown
16 lines
834 B
Markdown
(gn)=
|
|
|
|
# GN support in the build system
|
|
|
|
{abbr}`GN (Generated Ninja)` is a third-party build tool used by chromium and
|
|
some related projects that are vendored in mozilla-central. Rather than
|
|
requiring `GN` to build or writing our own build definitions for these projects,
|
|
we have support in the build system for translating GN configuration
|
|
files into moz.build files. In most cases these moz.build files will be like any
|
|
others in the tree (except that they shouldn't be modified by hand), however
|
|
those updating vendored code or building on platforms not supported by
|
|
Mozilla automation may need to re-generate these files. This is a per-project
|
|
process, described in dom/media/webrtc/third_party_build/gn-configs/README.md for
|
|
webrtc. As of writing, it is very specific to webrtc, and likely doesn't work as-is
|
|
for other projects.
|