From 33700066452e3c5f341b790f015f85fb976d06be Mon Sep 17 00:00:00 2001
From: Pjotr Prins
Date: Sat, 7 Aug 2021 11:17:21 +0200
Subject: Update info on running guix container

---
 README.md | 18 +++++++++++++++---
 1 file changed, 15 insertions(+), 3 deletions(-)

(limited to 'README.md')

diff --git a/README.md b/README.md
index c1acba1..108dcdb 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,7 @@ Simply load up the environment (for development purposes):
 guix environment --load=guix.scm
 ```
 
-Also, make sure you have the *guix-bioinformatics* channel set up.
+Also, make sure you have the [guix-bioinformatics](https://git.genenetwork.org/guix-bioinformatics/guix-bioinformatics) channel set up.
 
 ```bash
 env GUIX_PACKAGE_PATH=~/guix-bioinformatics/ ~/.config/guix/current/bin/guix environment --load=guix.scm
@@ -22,9 +22,21 @@ python3
 Better run a proper container
 
 ```
-env GUIX_PACKAGE_PATH=~/guix-bioinformatics/ ~/.config/guix/current/bin/guix environment -C --network --load=guix.scm 
+env GUIX_PACKAGE_PATH=~/guix-bioinformatics/ ~/.config/guix/current/bin/guix environment -C --network --load=guix.scm
 ```
 
+If you get a Guix error, such as `ice-9/boot-9.scm:1669:16: In procedure raise-exception:
+error: python-sqlalchemy-stubs: unbound variable` it typically means an update to guix latest is required (i.e., guix pull):
+
+```
+guix pull
+source ~/.config/guix/current/etc/profile
+```
+
+and try again.
+
+See also instructions in [.guix.scm](.guix.scm).
+
 #### Running Tests
 
 (assuming you are in a guix container; otherwise use venv!)
@@ -71,7 +83,7 @@ virtualenv --python python3 venv
 
 ```bash
 # The --ignore-installed flag forces packages to
-# get installed in the venv even if they existed 
+# get installed in the venv even if they existed
 # in the global env
 pip install -r requirements.txt --ignore-installed
 ```
-- 
cgit v1.2.3