From b9f2eb28d11b35d31107829961af3bec090400f8 Mon Sep 17 00:00:00 2001
From: Rob Greene <robgreene@gmail.com>
Date: Sun, 24 Jun 2018 15:45:27 -0500
Subject: [PATCH] Updating README. #16.

---
 tools/st/README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/tools/st/README.md b/tools/st/README.md
index 683d5d3..d2b7557 100644
--- a/tools/st/README.md
+++ b/tools/st/README.md
@@ -145,7 +145,32 @@ $ st --debug extract --output=new-mouse-shapes.png --border=box --skip-empty --f
 
 ## Shape generation
 
+These samples show a variety of input methods and pipes the resulting (binary) shape table back to `st` to display the results. (Otherwise it's a bit hard to demonstrate!)
+
+### Apple 'box'
+
 ```shell
+$ cat api/src/test/resources/box-longform.st
+; A vector box as given by Applesoft BASIC Programmer's Reference Manual
+
+; Notes:
+;   move[up|down|left|right] = move vector
+;   plot[up|down|left|right] = plot vector
+;   whitespace is ignored
+;   case insensitive
+
+.long label-long
+    movedown 2
+    plotleft 2
+    moveup
+    plotup 3
+    moveright
+    plotright 3
+    movedown
+    plotdown 3
+    moveleft
+    plotleft
+
 $ st generate --stdout api/src/test/resources/box-longform.st | st extract --stdin --stdout
 +-----+
 |.XXX.|
@@ -156,6 +181,29 @@ $ st generate --stdout api/src/test/resources/box-longform.st | st extract --std
 +-----+
 ```
 
+### The Mouse Maze mouse
+
+```shell
+$ cat mouse.st
+; extracted from NEW MOUSE
+
+.bitmap
+    ..........*X..  
+    ....XXXX.XX...  
+    ...XXXXXXXX...  
+    .XXXXXXXXXXX..  
+    XX.XXXXXXX.XX.  
+    X...XXXXXXXXXX  
+    XX............  
+    .XXX.XX.......  
+    ...XXX........  
+
+$ st generate --stdout mouse.st | st extract --format=source --coding=short --stdin --stdout
+.short
+  DDDRDDRRUlLdlLLLLLLURRRRRULLLLLLDUlLDLDDRDRRDRRURUuluuruRRRULlLLDLLUrRrrrurrrU
+
+```
+
 ## Generate to AppleSingle
 
 ```shell