List manual download dep libs in INSTALL.md

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