Bad error message `No hackage.haskell.org repository` for legacy `remote-repo` entry in the cabal configuration about cabal-plan

[andreasabel]

After some research, looking at the source code of cabal-plan(passing the safety pig ;-)), I could fix the problem by replacing in my .cabal/config

remote-repo: hackage.haskell.org:http://hackage.haskell.org/packages/archive

with

repository hackage.haskell.org
  url: http://hackage.haskell.org/

However, according to https://cabal.readthedocs.io/en/latest/installing-packages.html#legacy-repositories this is just expanding a synonym:

  remote-repo: hackage.haskell.org:http://hackage.haskell.org/packages/archive

This is just syntactic sugar for

  repository hackage.haskell.org
    url: http://hackage.haskell.org/packages/archive

although, in (and only in) the specific case of Hackage, the URL http://hackage.haskell.org/packages/archive will be silently translated to http://hackage.haskell.org/.

[nomeata]

JFTR: I just ran into this as well

[sellout]

I just ran into this, and wanted to make the workaround/fix more explicit in case anyone else still has an ancient .cabal/config around.

Basically, the remote-repo field in Cabal config files is “legacy” (read: obsolete and not well supported). To fix it, rewrite any

remote-repo: {{repository}}:{{url}}

to

repository {{repository}}
  url: {{url}}

Since providing a better error message here would basically entail parsing remote-repo anyway, it seems like it’s no harder to just support the legacy syntax. I.e., I feel like this issue should be closed, and instead, it would be nice if Cabal itself warned on legacy syntax.