1 synoposis: use `nroff -man | less` instead of `man` as backend for `cabal man`
2 packages: cabal-install
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
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.
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