Sylvestre Ledru
df0583fb15
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
1.2 KiB
(environment-variables)=
Environment Variables Impacting the Build System
Various environment variables have an impact on the behavior of the build system. This document attempts to document them.
- AUTOCLOBBER
-
If defines, the build system will automatically clobber as needed. The default behavior is to print a message and error out when a clobber is needed.
This variable is typically defined in a {ref}
mozconfig <mozconfig>file viamk_add_options. - REBUILD_CHECK
-
If defined, the build system will print information about why certain files were rebuilt.
This feature is disabled by default because it makes the build slower.
- MACH_NO_TERMINAL_FOOTER
-
If defined, the terminal footer displayed when building with mach in a TTY is disabled.
- MACH_NO_FUNC_CACHE
-
If defined, disables mach's persistent function result cache. This cache speeds up operations like configure by avoiding redundant expensive computations when input files haven't changed.
- MACH_NO_WRITE_TIMES
-
If defined, mach commands will not prefix output lines with the elapsed time since program start. This option is equivalent to passing
--log-no-timesto mach.