changelog.d/issue-7714

   1 synoposis: use `nroff -man | less` instead of `man` as backend for `cabal man`
   2 packages: cabal-install
   3 issues: #7714
   4 prs: #7726
   5 description: {
   6
   7 The previous implementation of `cabal man` used `man` as backend to
   8 view the generated manpage file.  However, macOS' and BSD's `man` does
   9 not accept a file as input, so `cabal man` was broken on macOS and
  10 BSD.
  11
  12 The issue has been fixed by piping the generated manpage through
  13 `nroff -man` and then into `$PAGER` which defaults to `less`.  Thus,
  14 `cabal man` now works both on Linux and macOS/BSD.
  15
  16 NB: `cabal man` requires `nroff` to be installed which is the case for
  17 standard setups (but may not be case on slim setups like VMs used in
  18 CI).  Note that `nroff` is not necessarily a prerequisite of a package
  19 containing `man`.
  20
  21
  22 }