Cabal: Nix-style Local Builds documentation is confusing

Created on 21 Feb 2018  Â·  8Comments  Â·  Source: haskell/cabal

You shouldn't use Cabal and cabal-install as examples in the cabal documentation. The reader has to mentally quote stuff to understand which level the text is talking about.

nix-local-build documentation

Most helpful comment

How about stack? :grin:

All 8 comments

It took me a moment to unquote your comment, indeed :) Anu suggestions for example packages?

Sent from my iPhone

On 21 Feb 2018, at 17.03, Bruno Martinez notifications@github.com wrote:

You shouldn't use Cabal and cabal-install as examples in the cabal documentation. The reader has to mentally quote stuff to understand which level the text is talking about.

—
You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub, or mute the thread.

network and http-client

I think we need something with an executable

How about stack? :grin:

hlint? pandoc?

hfmt, haskell-docs?

What about tasty? Its cabal.project has more than one package entry.

I'd prefer a package cabal maintainers have influence. Having cabal.project is good point too. I'm maintainer of servant, but it's not good (for the same reason as tasty) as it's controversial. (i.e. servant vs scotty; tasty vs hspec - maybe I overthink, but I'd avoid "advertising"). OTOH current cabal.project uses constraints and allow-newer, so the examples could be quite real.

Opinions?

Was this page helpful?
0 / 5 - 0 ratings