ghcup/CONTRIBUTING.md

26 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

2018-10-30 03:16:53 +00:00
# Contributing
* PR or email
* this script is POSIX shell
* use [shellcheck](https://github.com/koalaman/shellcheck) and `checkbashisms.pl` from [debian devscripts](http://http.debian.net/debian/pool/main/d/devscripts/devscripts_2.18.4.tar.xz)
* whitespaces, no tabs
## Adding a new distro, updating GHC versions, ...
This script makes use of two files:
2019-05-24 08:22:40 +00:00
1. [.download-urls](https://gitlab.haskell.org/haskell/ghcup/raw/master/.download-urls),
2018-10-30 03:16:53 +00:00
which is meta information on what binary tarball to download for the given version, architecture and distribution.
If you know your distribution XY works with a tarball, add a `<distroname>=<distrover>` key to that line. `<distroname>`
will be the fallback and after that `unknown`. Lines are unique per tarball url.
2019-05-24 08:22:40 +00:00
2. [.available-versions](https://gitlab.haskell.org/haskell/ghcup/raw/master/.available-versions),
2018-10-30 03:16:53 +00:00
which just lists available upstream versions and tags.
## TODO
2019-05-24 08:22:40 +00:00
- [ ] FreeBSD support ([#4](https://gitlab.haskell.org/haskell/ghcup/issues/4))
- [x] Make fetching tarballs more robust ([#5](https://gitlab.haskell.org/haskell/ghcup/issues/5))
2018-10-30 03:16:53 +00:00
- [x] More code documentation
2019-05-24 08:22:40 +00:00
- [x] Allow to compile from source ([#2](https://gitlab.haskell.org/haskell/ghcup/issues/2))
- [x] Allow to install cabal-install as well ([#3](https://gitlab.haskell.org/haskell/ghcup/issues/3))