build/docs/environment-variables.rst

Wed, 31 Dec 2014 06:09:35 +0100

author
Michael Schloh von Bennewitz <michael@schloh.com>
date
Wed, 31 Dec 2014 06:09:35 +0100
changeset 0
6474c204b198
permissions
-rw-r--r--

Cloned upstream origin tor-browser at tor-browser-31.3.0esr-4.5-1-build1
revision ID fc1c9ff7c1b2defdbc039f12214767608f46423f for hacking purpose.

     1 .. _environment_variables:
     3 ================================================
     4 Environment Variables Impacting the Build System
     5 ================================================
     7 Various environment variables have an impact on the behavior of the
     8 build system. This document attempts to document them.
    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.
    15    This variable is typically defined in a :ref:`mozconfig <mozconfig>`
    16    file via ``mk_add_options``.
    18 REBUILD_CHECK
    19    If defined, the build system will print information about why
    20    certain files were rebuilt.
    22    This feature is disabled by default because it makes the build slower.
    24 MACH_NO_TERMINAL_FOOTER
    25    If defined, the terminal footer displayed when building with mach in
    26    a TTY is disabled.
    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.
    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.
    40    A value of ``1`` activates the mode with full optimizations.
    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.
    46    A value of ``no-skip`` activates the mode without optimizations to skip
    47    some directories during traversal.
    49    Values may be combined with a comma.

mercurial