"Fossies" - the Fresh Open Source Software Archive

Member "firefox-69.0.1/build/build-clang/README" (17 Sep 2019, 2294 Bytes) of package /linux/www/firefox-69.0.1.source.tar.xz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 build-clang.py
    2 ==============
    3 
    4 A script to build clang from source.
    5 
    6 ```
    7 usage: build-clang.py [-h] -c CONFIG [--clean]
    8 
    9 optional arguments:
   10   -h, --help            show this help message and exit
   11   -c CONFIG, --config CONFIG
   12                         Clang configuration file
   13   --clean               Clean the build directory
   14 ```
   15 
   16 Pre-requisites
   17 --------------
   18 * Working build toolchain.
   19 * Subversion
   20 * CMake
   21 * Ninja
   22 * Python 2.7
   23 
   24 Please use the latest available CMake for your platform to avoid surprises.
   25 
   26 Config file format
   27 ------------------
   28 
   29 build-clang.py accepts a JSON config format with the following fields:
   30 
   31 * llvm_revision: The LLVM SVN revision to build.
   32 * stages: Use 1, 2, or 3 to select different compiler stages.  The default is 3.
   33 * llvm_repo: SVN path to the LLVM repo.
   34 * clang_repo: SVN path to the Clang repo.
   35 * extra_repo: SVN path to the clang-tools-extra repo.
   36 * lld_repo: SVN path to the lld repo.
   37 * compiler_repo: SVN path to the compiler-rt repo.
   38 * libcxx_repo: SVN path to the libcxx repo.
   39 * libcxxabi_repo: SVN path to the libcxxabi repo.
   40 * python_path: Path to the Python 2.7 installation on the machine building clang.
   41 * gcc_dir: Path to the gcc toolchain installation, only required on Linux.
   42 * cc: Path to the bootsraping C Compiler.
   43 * cxx: Path to the bootsraping C++ Compiler.
   44 * as: Path to the assembler tool.
   45 * ar: Path to the library archiver tool.
   46 * ranlib: Path to the ranlib tool (optional).
   47 * libtool: Path to the libtool tool (optional).
   48 * ld: Path to the linker.
   49 * patches: Optional list of patches to apply.
   50 * build_type: The type of build to make.  Supported types: Release, Debug, RelWithDebInfo or MinSizeRel.
   51 * build_libcxx: Whether to build with libcxx.  The default is false.
   52 * build_clang_tidy: Whether to build clang-tidy with the Mozilla checks imported.  The default is false.
   53 * osx_cross_compile: Whether to invoke CMake for OS X cross compile builds.
   54 * assertions: Whether to enable LLVM assertions.  The default is false.
   55 
   56 Environment Variables
   57 ---------------------
   58 
   59 The following environment variables are used for cross-compile builds targeting OS X on Linux.
   60 
   61 * CROSS_CCTOOLS_PATH: Path to the cctools directory where the cross compiler toolchain is located.
   62 * CROSS_SYSROOT: Path to the OS X SDK directory for cross compile builds.