From 022f29e25d7ea076fe161b59a502a33e2122c79d Mon Sep 17 00:00:00 2001
From: Wolfgang Thaller <wolfgang.thaller@gmx.net>
Date: Wed, 2 May 2018 22:16:32 +0200
Subject: [PATCH] Some documentation for LaunchAPPL's new features

---
 .../{Client => }/LaunchAPPL.cfg.example       | 19 ++++++++++++++++++-
 README.md                                     |  2 ++
 2 files changed, 20 insertions(+), 1 deletion(-)
 rename LaunchAPPL/{Client => }/LaunchAPPL.cfg.example (76%)

diff --git a/LaunchAPPL/Client/LaunchAPPL.cfg.example b/LaunchAPPL/LaunchAPPL.cfg.example
similarity index 76%
rename from LaunchAPPL/Client/LaunchAPPL.cfg.example
rename to LaunchAPPL/LaunchAPPL.cfg.example
index 4da1ff0d01..a34401bc3b 100644
--- a/LaunchAPPL/Client/LaunchAPPL.cfg.example
+++ b/LaunchAPPL/LaunchAPPL.cfg.example
@@ -18,6 +18,23 @@
 
 # emulator = carbon
 
+# ########### A real Mac connected via a serial cable
+
+    # Prerequisited:
+    # - A Mac with a modem port, and any classic Mac system software
+    # - The LaunchAPPLServer application
+    #   (`Retro68-build/build-target/LaunchAPPL/Server/`) running on that Mac
+    # - A computer with a serial port (or USB serial adapter) running Retro68
+    # - A Mac-To-PC null modem cable
+    #   (https://allpinouts.org/pinouts/cables/serial/macintosh-to-pc-null-modem/)
+
+    # if you change the speed, make sure to choose the matching speed from the
+    # menu in the server application
+
+# emulator = serial
+# serial-port = /dev/ttyUSB0
+# serial-baud = 19200
+
 
 # ########### Mini vMac (old 68K Macs)
 
@@ -48,7 +65,7 @@
     # And finally, autoquit:
 # autoquit-image = ./autoquit-1.1.1.dsk
 
-# ########### Executor (68K only)
+# ########### Executor
 
     # No ROM files needed - an opensource reimplementation of classic Mac OS.
 
diff --git a/README.md b/README.md
index 476045c7a5..4afd4a8cfb 100644
--- a/README.md
+++ b/README.md
@@ -332,6 +332,8 @@ Currently, LaunchAPPL supports the following methods for launching Mac applicati
 * carbon - launch as a Carbon app on PowerPC Macs and via Rosetta on Intel Macs up to Snow Leopard (10.6)
 * minivmac - launch using the Mini vMac emulator
 * executor - launch using Executor
+* ssh - Invoke the `LaunchAPPL` tool remotely via ssh
+* serial - Connect to a real Mac running the `LaunchAPPLServer` application via a null modem cable
 
 If you're running on a Mac that's old enough to use the `classic` or `carbon` backends,
 they will work out of the box, just launch an application as follows