diff --git a/README.md b/README.md
index 7fd652f..9fba609 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,26 @@ See Notices.txt for copyright information
 -->
 parser for the OPF PowerISA 3.1C pdf to attempt to extract all instructions' pseudo-code including subscripts/superscripts and other formatting
 
+# Using the new Rust code:
+
+Usage:
+* Download the OPF PowerISA 3.1C pdf (yes you need that exact version) from <https://openpower.foundation/specifications/isa/>
+
+* Install Rust -- you need version 1.89.0 or later.
+
+  Getting it from https://rustup.rs/ is recommended.
+
+* Compile and run:
+
+  ```bash
+  cargo run -- path/to/downloaded/OPF_PowerISA_v3.1C.pdf > out.log
+  ```
+
+* This will spit out lots of errors and then successfully create
+  the output file -- `powerisa-instructions.xml` in the current directory.
+
+# Using the old Python code:
+
 Usage:
 * Download the OPF PowerISA 3.1C pdf (yes you need that exact version) from <https://openpower.foundation/specifications/isa/>
 * Obtain CPython 3.11 (the default `python3` in [Debian Bookworm](https://www.debian.org/releases/bookworm/))