From 1129e4221bb809be42e7438cf0358e4a6ce66622 Mon Sep 17 00:00:00 2001
From: Edward L Platt <ed@elplatt.com>
Date: Wed, 8 Feb 2023 19:24:37 -0500
Subject: [PATCH] Add initial notes.

---
 Readme.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100755 Readme.md

diff --git a/Readme.md b/Readme.md
new file mode 100755
index 0000000..041985b
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,60 @@
+Practical guide to running guile goblins
+
+Tested on Ubuntu 22.04 LTS
+
+install guix
+
+	sudo apt-get install guix
+    guix pull
+
+set guix profile
+
+	GUIX_PROFILE="/home/elplatt/.config/guix/current"
+	. "$GUIX_PROFILE/etc/profile"
+
+
+install geiser (https://www.nongnu.org/geiser/Installation.html)
+
+enable emacs ELPA
+
+append to ~/.emacs:
+
+    (require 'package)
+    (add-to-list 'package-archives
+	         '("nongnu" . "https://elpa.nongnu.org/nongnu/"))
+    (package-initialize)
+
+in emacs:
+
+		M-x eval-buffer
+		M-x package-refresh-contents
+		M-x package-install RET geiser-guile RET
+
+install goblins
+
+    guix install guile-goblins
+
+run guile in a guix shell with goblins
+(see https://gitlab.com/spritely/guile-goblins/-/blob/main/live-guile.sh for reference)
+
+    guix shell guile guile-goblins -- guile --listen=~/goblins.sock
+    
+The above will start a guile REPL in the terminal and create a socket that
+other processes can connect to. It may be convenient to run this in a tmux
+session if you don't want to have to keep a dedicated terminal tab open.
+    
+in emacs
+
+    M-x geiser-connect-local
+    ~/goblins.sock
+    
+This will start a REPL. Code can be entered into the REPL or evaluated in a
+scheme buffer with `C-e`.
+
+If geiser hangs, the REPL can be restarted with:
+
+    M-x geiser-reload
+    
+To clean up, close the original guile REPL with `C-d` and delete the socket file:
+
+    rm ~/goblins.sock