hasufell/ghcup
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Add CONTRIBUTING.md

Browse Source
This commit is contained in:
Julian Ospald 2018-10-30 11:16:53 +08:00
parent cbb19a01c0
commit 1501a2e8fa
No known key found for this signature in database
GPG Key ID: 511B62C09D50CD28
2 changed files with 25 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
CONTRIBUTING.md Normal file
View File

@ -0,0 +1,25 @@
# 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:
1. [.download-urls](https://raw.githubusercontent.com/haskell/ghcup/master/.download-urls),
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.
2. [.available-versions](https://raw.githubusercontent.com/haskell/ghcup/master/.available-versions),
which just lists available upstream versions and tags.
## TODO
- [ ] FreeBSD support ([#4](https://github.com/haskell/ghcup/issues/4))
- [x] Make fetching tarballs more robust ([#5](https://github.com/haskell/ghcup/issues/5))
- [x] More code documentation
- [x] Allow to compile from source ([#2](https://github.com/haskell/ghcup/issues/2))
- [x] Allow to install cabal-install as well ([#3](https://github.com/haskell/ghcup/issues/3))

18
README.md
View File

@ -52,24 +52,6 @@ Alternatively, you can also tell it to compile from source (note that this might
In addition this script can also install `cabal-install`.
## 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
### Download locations
Download locations are maintained in the file [.download-urls](https://raw.githubusercontent.com/haskell/ghcup/master/.download-urls)
and may slightly be behind a very recent release or not tested
on all distro combinations.
In such a case, consider providing a PR to fix it.
Similarly, available versions are maintained in
[.available-versions](https://raw.githubusercontent.com/haskell/ghcup/master/.available-versions).
## Known problems
### Limited distributions supported