changelog.d/pr-8557-2

   1 synopsis: Add --semaphore option to ./Setup build interface
   2 packages: Cabal
   3 prs: #8557
   4
   5 description: {
   6
   7 When `./Setup build --semaphore <SEM>` is called, `ghc` will be called with the
   8 `-jsem` option. It is the responsibility of the caller of `./Setup build` to
   9 manage the semaphore according to the GHC Jobserver Protocol.
  10
  11 This low level interface is intended to be called by a high-level tool such as
  12 `cabal-install` which can create and manage the semaphore appropriately.
  13
  14 The protocol is specified by [GHC Proposal #540](https://github.com/ghc-proposals/ghc-proposals/blob/master/proposals/0540-jsem.rst).
  15
  16 }