bootstrap/README.md

   1 # Bootstrapping cabal-install
   2
   3 This utility is only intended for use in building cabal-install
   4 on a new platform. If you already have a functional (if dated) cabal-install
   5 please rather run `cabal v2-install`.
   6
   7 The typical usage is porting to a new linux architecture,
   8 then the `linux-$GHCVER.json` file is available in `bootstrap/` folder:
   9
  10 On a (linux) system you are bootstrapping, run
  11
  12     ./bootstrap/bootstrap.py -d ./bootstrap/linux-$GHCVER.json -w /path/to-ghc
  13
  14 from the top directory of the source checkout.
  15
  16 To generate the `$PLATFORM-$GHCVER` files for other platforms, do:
  17
  18   1. On a system with functional cabal-install, install the same GHC version
  19      as you will use to bootstrap on the host system.
  20
  21   2. Build a dependency description file (`$PLATFORM-$GHCVER.json`, e.g. `linux-8.8.4.json`) by running:
  22
  23        ```sh
  24        cabal v2-build --with-compiler=/path/to/ghc --dry-run cabal-install:exe:cabal
  25        cp dist-newstyle/cache/plan.json bootstrap/$PLATFORM-$GHCVER.plan.json
  26        cd bootstrap
  27        cabal v2-run -v0 cabal-bootstrap-gen -- $PLATFORM-$GHCVER.plan.json | tee $PLATFORM-$GHCVER.json
  28        ```
  29
  30   3. You may need to tweak `bootstrap/$PLATFORM-$GHCVER.json` file manually,
  31      for example toggle flags.
  32
  33 There are rules in the top-level `Makefile` for generation of these files.