about summary refs log tree commit diff
diff options
context:
space:
mode:
authorPjotr Prins2025-07-30 10:32:04 +0200
committerPjotr Prins2025-07-30 10:32:04 +0200
commit418fbe142f42f057ea2d08e6f23c1ff4e7b274da (patch)
tree5ce9715f6205f06bf77e2f3ca4abdf957130bec0
parent674bcf2ac8ef5e3302c1ec137a5ef60f0b8ed467 (diff)
downloadgn-guile-418fbe142f42f057ea2d08e6f23c1ff4e7b274da.tar.gz
Update on running web server
-rw-r--r--README.md12
1 files changed, 10 insertions, 2 deletions
diff --git a/README.md b/README.md
index 3d110f4..79b00bd 100644
--- a/README.md
+++ b/README.md
@@ -34,7 +34,7 @@ git remote add gn git.genenetwork.org:/home/git/public/gn-guile
 GNU Guile allows you to develop against a live running web server using emacs-geiser on port 1970. To try this fire up the web server from the `web` directory as
 
 ```sh
-guix shell -L ~/guix-bioinformatics --container --network --file=guix.scm -- guile -L . --fresh-auto-compile --listen=1970 -e main web/webserver.scm 8091
+guix shell -L ~/guix-bioinformatics -m manifest.scm --container --network --file=guix.scm -- guile -L . --fresh-auto-compile --listen=1970 -e main web/webserver.scm 8091
 ```
 
 By default the root points to the API:
@@ -48,7 +48,9 @@ curl http://127.0.0.1:8091/home/aging
 
 The `--container` option runs the code in an isolated container, and the `--network` option connects that container's networking to the host to allow you to access the running service.
 
-If you get an error `no code for module (gn packages guile)` add the appropriate guix-bioinformatics repo to the load path (`-L` switch).
+If you get an error `no code for module (gn packages guile)` add the appropriate guix-bioinformatics repo to the load path (`-L` switch). Note that, instead of hard-wiring guix-bioinformatics, the recommended way is to use a guix channel as defined in [guix-channel](./.guix-channel).
+
+We recommend checking the Guix documentation for manifests, channels and guix.scm definitions.
 
 ## Welcome to the world of interactive Lisp programming
 
@@ -56,6 +58,12 @@ Next fire up emacs with `emacs-geiser-guile` and connect to the running web serv
 
 Note that you may have to try different versions of guile+emacs to succeed.
 
+Also these days it may be a better bet to use Andrew Tropin's alternatives ares and arei that are very powerful alternatives to geiser (with a more common lisp type interactive experience):
+
+=> https://git.sr.ht/~abcdw/guile-ares-rs
+=> https://git.sr.ht/~abcdw/emacs-arei
+
+
 # Tools
 
 Some tooling and scripts that run independently are stored in `./scripts`.