diff --git a/INSTALL.md b/INSTALL.md index f02c54e..b5d610f 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -48,21 +48,43 @@ source, the easiest way is to install via stack: $ stack setup -Check in `stack.yaml` near the top which extra repos are required. At the time -of writing, there are 4 of them (`hit-harder`, `hit-graph`, `hit-network` and -`ssh`). Then clone them. For example: +Some of the dependency libraries need to be manually downloaded. Either because +I've written them and haven't released yet, or because they have unreleased +changes, or because I'm using a patched version of some library and the patch +hasn't found its way upstream. - $ darcs clone https://dev.seek-together.space/s/fr33domlover/r/ssh +In the `stack.yaml` file, under the `packages` field, there is a list of such +libraris. While `stack` supports fetching dependencies from Git repositories, +it doesn't support Darcs (if that changes and I haven't noticed, let me know!), +so we need to download them by ourselves. A line in the `packages` list that +looks like this needs manual download: -Those extra repos should be found at the -[Vervis project page](https://dev.seek-together.space/s/fr33domlover/p/vervis). -If something is missing there, try my -[Darcs Hub page](https://hub.darcs.net/fr33domlover). I'm sorry I'm not just -listing the URLs here. These things have been changing often, but once they -stabilize I will update the docs, and also make releases of all these extra -libraries. +` - '../some-library-name'` -Update `stack.yaml` to specify that path in the `packages` section if needed: +These details change often because of all the unreleased libraries and patches, +so until there are sane releases for everything, the instructions here aren't +always up to date. Basically it works like this: + +- Those extra repos should be found at the + [Vervis project page](https://dev.seek-together.space/s/fr33domlover/p/vervis) +- If something is missing there, try my + [Darcs Hub page](https://hub.darcs.net/fr33domlover) +- Use `darcs clone` to grab the library source code + +As of May 14, 2018, what you need to do is as follows: + + $ VERVIS='https://dev.seek-together.space/s/fr33domlover/r' + $ HUB='https://hub.darcs.net/fr33domlover' + $ darcs clone $HUB/hit-graph + $ darcs clone $HUB/hit-harder + $ darcs clone $HUB/hit-network + $ darcs clone $VERVIS/darcs-rev --to-hash 30ab5896e53321105c36a028e451b93c98e0345b + $ darcs clone $VERVIS/ssh + $ darcs clone $VERVIS/persistent-migration --to-hash 992e059a3b8cc039d555ad31622174133a0918bc + $ darcs clone $VERVIS/persistent-email-addres + $ darcs clone $VERVIS/yesod-mail-send --to-hash 2800294a41daf57cd420710bc79c8c9b06c0d3dd + +Update `stack.yaml` to specify the paths in the `packages` section if needed: $ vim stack.yml