The Tor Browser / file comparison
comparison: build/docs/environment-variables.rst
build/docs/environment-variables.rst
- branch
- TOR_BUG_3246
- changeset 7
- 129ffea94266
equal
deleted
inserted
replaced
| -1:000000000000 | 0:f0a220e5d13a |
|---|---|
| 1 .. _environment_variables: | |
| 2 | |
| 3 ================================================ | |
| 4 Environment Variables Impacting the Build System | |
| 5 ================================================ | |
| 6 | |
| 7 Various environment variables have an impact on the behavior of the | |
| 8 build system. This document attempts to document them. | |
| 9 | |
| 10 AUTOCLOBBER | |
| 11 If defines, the build system will automatically clobber as needed. | |
| 12 The default behavior is to print a message and error out when a | |
| 13 clobber is needed. | |
| 14 | |
| 15 This variable is typically defined in a :ref:`mozconfig <mozconfig>` | |
| 16 file via ``mk_add_options``. | |
| 17 | |
| 18 REBUILD_CHECK | |
| 19 If defined, the build system will print information about why | |
| 20 certain files were rebuilt. | |
| 21 | |
| 22 This feature is disabled by default because it makes the build slower. | |
| 23 | |
| 24 MACH_NO_TERMINAL_FOOTER | |
| 25 If defined, the terminal footer displayed when building with mach in | |
| 26 a TTY is disabled. | |
| 27 | |
| 28 MACH_NO_WRITE_TIMES | |
| 29 If defined, mach commands will not prefix output lines with the | |
| 30 elapsed time since program start. This option is equivalent to | |
| 31 passing ``--log-no-times`` to mach. | |
| 32 | |
| 33 MOZ_PSEUDO_DERECURSE | |
| 34 Activate an *experimental* build mode where make directory traversal | |
| 35 is derecursified. This mode should result in faster build times at | |
| 36 the expense of busted builds from time-to-time. The end goal is for | |
| 37 this build mode to be the default. At which time, this variable will | |
| 38 likely go away. | |
| 39 | |
| 40 A value of ``1`` activates the mode with full optimizations. | |
| 41 | |
| 42 A value of ``no-parallel-export`` activates the mode without | |
| 43 optimizations to the *export* tier, which are known to be slightly | |
| 44 buggy. | |
| 45 | |
| 46 A value of ``no-skip`` activates the mode without optimizations to skip | |
| 47 some directories during traversal. | |
| 48 | |
| 49 Values may be combined with a comma. |
