solenv/README.md

   1 # Tools and Makefile Fragments Necessary for Compilation
   2
   3 This module contains many tools and makefile configuration pieces,
   4 critical for building LibreOffice:
   5
   6 - `bin/`
   7
   8     - contains lots of tools used during the build:
   9
  10         - `concat-deps*`
  11             these aggregate, and remove duplicates from module
  12             dependencies, to accelerate build times.
  13
  14         - `make_installer.pl`
  15             this script executes the compiled instructions from
  16             the `scp2/` module to create an installer, and/or to
  17             do a local install for the smoketest.
  18
  19 - `gbuild/`
  20
  21     implementation of the LibreOffice build system
  22     See `gbuild/README` for more info.
  23
  24 - `gdb/`
  25
  26     lots of nice python helpers to make debugging -much- easier
  27     that (eg.) print UCS2 strings as UTF-8 on the console to
  28     help with debugging.
  29
  30 - `inc/`
  31
  32     old `/` increasingly obsolete dmake setup and includes, we are
  33     trying to entirely rid ourselves of this
  34
  35 - `src/`
  36
  37     useful standard `/` re-usable component map files for components
  38     which shouldn't export anything more than a few registration
  39     symbols.
  40
  41 - `flatpak-manifest.in`
  42
  43     This file is used by `flatpak/build.sh` from the LO `dev-tools`
  44     repository to generate the flatpak package. `download.lst` is
  45     a `Makefile` snippet, so there seems to be no easy way to use
  46     `download.lst` for the manifest generation (`build.sh` uses `sed`),
  47     and its information must be kept in sync manually.