From 49a09d192c6f2380c5186ec7d81e98785d667214 Mon Sep 17 00:00:00 2001
From: Peter Harpending <peter@harpending.org>
Date: Tue, 23 Sep 2025 14:07:35 -0700
Subject: [PATCH] adding zx install instructions to readme

---
 .gitignore |  3 +++
 README.md  | 66 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 69 insertions(+)

diff --git a/.gitignore b/.gitignore
index e69de29..308f1f0 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1,3 @@
+*.swp
+*.swo
+*.beam
diff --git a/README.md b/README.md
index e69de29..07e7f2b 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,66 @@
+# gex = gajumaru exchange
+
+Currently there is only one thing, which is the Gajumaru HTTP Daemon.
+
+## How to run `gex_httpd`
+
+Last updated: September 23, 2025 (PRH).
+
+1.  **Install Erlang and zx/zomp**
+
+    Source: [*Building Erlang 26.2.5 on Ubuntu 24.04*](https://zxq9.com/archives/2905)
+
+    Adapt this to your Linux distribution.
+
+    1.a.    **Install necessary build tools**
+
+            ```bash
+            sudo apt update
+            sudo apt upgrade
+            sudo apt install \
+                gcc curl g++ dpkg-dev build-essential automake autoconf \
+                libncurses-dev libssl-dev flex xsltproc libwxgtk3.2-dev \
+                wget vim git
+            ```
+
+    1.b.    **Put [Kerl](https://github.com/kerl/kerl) somewhere in your
+            `$PATH`**. This is a tool to build Erlang releases.
+
+            ```bash
+            wget -O ~/bin/kerl https://raw.githubusercontent.com/kerl/kerl/master/kerl
+            chmod u+x ~/bin/kerl
+            ```
+
+    1.c.    **Build Erlang from source using Kerl**
+
+            ```bash
+            kerl update releases
+            ## use the most recent one that looks stable
+            ## you do need to type the number twice, that's not a typo
+            kerl build 28.1 28.1
+            kerl install 28.1 ~/.erts/28.1
+            ```
+
+    1.d.    **Put Erlang in your `$PATH`**
+
+            Update .bashrc or .zshrc or whatever with the following line:
+
+            ```bash
+            . $HOME/.erts/28.1/activate
+            ```
+
+
+    1.e.    **Install zx**
+
+            ```bash
+            wget -q https://zxq9.com/projects/zomp/get_zx && bash get_zx
+            ```
+
+    1.f.    **Test zx works**
+
+            zx installs itself to `~/bin`, so make sure that's in your
+            `$PATH`.
+
+            ```bash
+            zx run erltris
+            ```