build/docs/glossary.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 ========
     2 Glossary
     3 ========
     5 .. glossary::
     6    :sorted:
     8    object directory
     9        A directory holding the output of the build system. The build
    10        system attempts to isolate all file modifications to this
    11        directory. By convention, object directories are commonly
    12        directories under the source directory prefixed with **obj-**.
    13        e.g. **obj-firefox**.
    15    mozconfig
    16        A shell script used to configure the build system.
    18    configure
    19        A generated shell script which detects the current system
    20        environment, applies a requested set of build configuration
    21        options, and writes out metadata to be consumed by the build
    22        system.
    24    config.status
    25        An executable file produced by **configure** that takes the
    26        generated build config and writes out files used to build the
    27        tree. Traditionally, config.status writes out a bunch of
    28        Makefiles.
    30    install manifest
    31        A file containing metadata describing file installation rules.
    32        A large part of the build system consists of copying files
    33        around to appropriate places. We write out special files
    34        describing the set of required operations so we can process the
    35        actions effeciently. These files are install manifests.
    37    clobber build
    38       A build performed with an initially empty object directory. All
    39       build actions must be performed.
    41    incremental build
    42       A build performed with the result of a previous build in an
    43       object directory. The build should not have to work as hard because
    44       it will be able to reuse the work from previous builds.
    46    mozinfo
    47       An API for accessing a common and limited subset of the build and
    48       run-time configuration. See :ref:`mozinfo`.

mercurial